@sema-agent/core/dist/tools/todo.d.ts

Stateless, task-oriented AI agent core

import type { ToolSpec } from "../core/types.js";
/**
 * design/102 (K-8 CC full-body) — TodoWrite parity (CONTEXT leg). A private, in-task plan the model rewrites to
 * track multi-step work. State lives in this factory's closure — FRESH per task (each `assembleCodeTools` call
 * makes its own), one list per calling session (`ctx.sessionId`; upstream keys it by agent, so an Agent child sharing
 * the instance never replaces the leader's plan); nothing durable, no deps, no egress. `effect:"idempotent"` because
 * re-sending the whole list is repeat-safe. Distinct from `present_plan` (that SUSPENDS for human review); this is
 * the model's own scratch, a RAW {@link ToolSpec} pushed via `spec.tools` — NOT mounted default-on (INERT elsewhere).
 */
export declare function createTodoWriteTool(): ToolSpec;