@code-yeongyu/senpi 2026.9.24-2 → 2026.9.24-3

package/dist/core/extensions/builtin/todotools/first-turn.js

@@ -0,0 +1,83 @@
+import { getAnthropicCompat } from "@earendil-works/pi-ai/utils/prompt-cache-ttl";
+export const FIRST_TURN_CUSTOM_TYPE = "senpi.todo-first-turn";
+export const FIRST_TURN_REMINDER = `<system-reminder>
+This is the first request of the session. Before continuing, call the todo tool with op "init" and a phased list covering the whole request end to end: investigation, implementation, verification (diagnostics, tests, build, manual check), and the final report. Give every task a unique 5-10 word label; phase names are short noun phrases. Then continue the request in this same turn - the init is not a turn by itself.
+</system-reminder>`;
+/** One-shot, non-interactive runs; the same set `terminal/notify.ts` never wakes. */
+const NON_INTERACTIVE_MODES = new Set(["print", "json"]);
+const TRAILING_CLOSERS = /[\s"'`\u2018\u2019\u201C\u201D)\]}]+$/u;
+/**
+ * Arms the first-turn plan opener only for a session's first real request that asks for work:
+ * never in a preview, never once any user message is on the branch (`before_agent_start` fires
+ * before the prompt is persisted), never over an existing list, never for a question or an
+ * exclamation, and never in print/json runs.
+ */
+export function shouldArmFirstTurn(input) {
+    if (input.preview || input.setting === "off" || !input.todoActive)
+        return false;
+    if (NON_INTERACTIVE_MODES.has(input.mode))
+        return false;
+    const request = input.prompt.trim().replace(TRAILING_CLOSERS, "");
+    if (request === "" || /[?!\uFF1F\uFF01]$/u.test(request))
+        return false;
+    if (input.branchEntries.some((entry) => entry.type === "message" && entry.message.role === "user"))
+        return false;
+    return input.phases.every((phase) => phase.tasks.length === 0);
+}
+/**
+ * Whether the request wire can name one tool in `tool_choice`. Anthropic reads the RESOLVED
+ * compat (catalog models carry no `compat`, and the resolver applies the Fable / Mythos /
+ * Opus 5.5 forced-choice default), never `model.compat` directly.
+ */
+export function supportsNamedToolChoice(model) {
+    switch (model?.api) {
+        case "anthropic-messages": {
+            const compat = getAnthropicCompat(model);
+            return compat.supportsToolChoice !== false && compat.supportsForcedToolChoice !== false;
+        }
+        case "openai-responses":
+        case "openai-completions":
+            return true;
+        default:
+            return false;
+    }
+}
+/** Wire shape of a `tool_choice` that forces `toolName`, or `undefined` for an unsupported api. */
+export function namedToolChoicePayload(api, toolName) {
+    switch (api) {
+        case "anthropic-messages":
+            return { type: "tool", name: toolName };
+        case "openai-responses":
+            return { type: "function", name: toolName };
+        case "openai-completions":
+            return { type: "function", function: { name: toolName } };
+        default:
+            return undefined;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function declaresTool(tools, toolName) {
+    return (Array.isArray(tools) &&
+        tools.some((tool) => isRecord(tool) && (tool.name === toolName || (isRecord(tool.function) && tool.function.name === toolName))));
+}
+/**
+ * The payload with a forced `todo` tool_choice, or `undefined` to leave it untouched: the
+ * request must declare `todo`, carry no tool_choice of its own, and (Anthropic) not run
+ * extended thinking, which rejects any forced tool use.
+ */
+export function withForcedTodoChoice(payload, model) {
+    if (!supportsNamedToolChoice(model))
+        return undefined;
+    const toolChoice = namedToolChoicePayload(model?.api, "todo");
+    if (!toolChoice || !isRecord(payload) || payload.tool_choice !== undefined)
+        return undefined;
+    if (!declaresTool(payload.tools, "todo"))
+        return undefined;
+    const thinking = isRecord(payload.thinking) ? payload.thinking.type : undefined;
+    if (model?.api === "anthropic-messages" && (thinking === "enabled" || thinking === "adaptive"))
+        return undefined;
+    return { ...payload, tool_choice: toolChoice };
+}
+//# sourceMappingURL=first-turn.js.map

package/dist/core/extensions/builtin/todotools/first-turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-turn.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/first-turn.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { getAnthropicCompat } from \"@earendil-works/pi-ai/utils/prompt-cache-ttl\";\nimport type { SessionEntry } from \"../../../session-manager.ts\";\nimport type { TodoFirstTurnPlan } from \"../../../settings-shapes.ts\";\nimport type { ExtensionMode } from \"../../types.ts\";\nimport type { TodoPhase } from \"./todo-types.ts\";\n\nexport const FIRST_TURN_CUSTOM_TYPE = \"senpi.todo-first-turn\";\n\nexport const FIRST_TURN_REMINDER = `<system-reminder>\nThis is the first request of the session. Before continuing, call the todo tool with op \"init\" and a phased list covering the whole request end to end: investigation, implementation, verification (diagnostics, tests, build, manual check), and the final report. Give every task a unique 5-10 word label; phase names are short noun phrases. Then continue the request in this same turn - the init is not a turn by itself.\n</system-reminder>`;\n\n/** One-shot, non-interactive runs; the same set `terminal/notify.ts` never wakes. */\nconst NON_INTERACTIVE_MODES: ReadonlySet<ExtensionMode> = new Set([\"print\", \"json\"]);\n\nconst TRAILING_CLOSERS = /[\\s\"'`\\u2018\\u2019\\u201C\\u201D)\\]}]+$/u;\n\nexport type FirstTurnGateInput = {\n\tpreview: boolean | undefined;\n\tprompt: string;\n\tbranchEntries: readonly SessionEntry[];\n\tphases: readonly TodoPhase[];\n\ttodoActive: boolean;\n\tsetting: TodoFirstTurnPlan;\n\tmode: ExtensionMode;\n};\n\n/**\n * Arms the first-turn plan opener only for a session's first real request that asks for work:\n * never in a preview, never once any user message is on the branch (`before_agent_start` fires\n * before the prompt is persisted), never over an existing list, never for a question or an\n * exclamation, and never in print/json runs.\n */\nexport function shouldArmFirstTurn(input: FirstTurnGateInput): boolean {\n\tif (input.preview || input.setting === \"off\" || !input.todoActive) return false;\n\tif (NON_INTERACTIVE_MODES.has(input.mode)) return false;\n\tconst request = input.prompt.trim().replace(TRAILING_CLOSERS, \"\");\n\tif (request === \"\" || /[?!\\uFF1F\\uFF01]$/u.test(request)) return false;\n\tif (input.branchEntries.some((entry) => entry.type === \"message\" && entry.message.role === \"user\")) return false;\n\treturn input.phases.every((phase) => phase.tasks.length === 0);\n}\n\n/**\n * Whether the request wire can name one tool in `tool_choice`. Anthropic reads the RESOLVED\n * compat (catalog models carry no `compat`, and the resolver applies the Fable / Mythos /\n * Opus 5.5 forced-choice default), never `model.compat` directly.\n */\nexport function supportsNamedToolChoice(model: Model<Api> | undefined): boolean {\n\tswitch (model?.api) {\n\t\tcase \"anthropic-messages\": {\n\t\t\tconst compat = getAnthropicCompat(model as Model<\"anthropic-messages\">);\n\t\t\treturn compat.supportsToolChoice !== false && compat.supportsForcedToolChoice !== false;\n\t\t}\n\t\tcase \"openai-responses\":\n\t\tcase \"openai-completions\":\n\t\t\treturn true;\n\t\tdefault:\n\t\t\treturn false;\n\t}\n}\n\n/** Wire shape of a `tool_choice` that forces `toolName`, or `undefined` for an unsupported api. */\nexport function namedToolChoicePayload(api: Api | undefined, toolName: string): Record<string, unknown> | undefined {\n\tswitch (api) {\n\t\tcase \"anthropic-messages\":\n\t\t\treturn { type: \"tool\", name: toolName };\n\t\tcase \"openai-responses\":\n\t\t\treturn { type: \"function\", name: toolName };\n\t\tcase \"openai-completions\":\n\t\t\treturn { type: \"function\", function: { name: toolName } };\n\t\tdefault:\n\t\t\treturn undefined;\n\t}\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nfunction declaresTool(tools: unknown, toolName: string): boolean {\n\treturn (\n\t\tArray.isArray(tools) &&\n\t\ttools.some(\n\t\t\t(tool) =>\n\t\t\t\tisRecord(tool) && (tool.name === toolName || (isRecord(tool.function) && tool.function.name === toolName)),\n\t\t)\n\t);\n}\n\n/**\n * The payload with a forced `todo` tool_choice, or `undefined` to leave it untouched: the\n * request must declare `todo`, carry no tool_choice of its own, and (Anthropic) not run\n * extended thinking, which rejects any forced tool use.\n */\nexport function withForcedTodoChoice(payload: unknown, model: Model<Api> | undefined): unknown {\n\tif (!supportsNamedToolChoice(model)) return undefined;\n\tconst toolChoice = namedToolChoicePayload(model?.api, \"todo\");\n\tif (!toolChoice || !isRecord(payload) || payload.tool_choice !== undefined) return undefined;\n\tif (!declaresTool(payload.tools, \"todo\")) return undefined;\n\tconst thinking = isRecord(payload.thinking) ? payload.thinking.type : undefined;\n\tif (model?.api === \"anthropic-messages\" && (thinking === \"enabled\" || thinking === \"adaptive\")) return undefined;\n\treturn { ...payload, tool_choice: toolChoice };\n}\n"]}

package/dist/core/extensions/builtin/todotools/index.d.ts

@@ -3,6 +3,6 @@ export default function todotoolsExtension(pi: ExtensionAPI): void;
 export { findPhaseFuzzy, findTaskFuzzy, registerTodoCommand, tokenizeTodoArgs } from "./commands.ts";
 export { markdownToPhases, phasesToMarkdown, resolveTodoMarkdownPath } from "./markdown.ts";
 export { TASK_MANAGEMENT_SECTION } from "./prompt.ts";
-export { appendItems, applyEntry, applyOpsToPhases, applyParams, clonePhases, cloneTask, DEFAULT_INIT_PHASE, findPhaseByName, findTaskByContent, formatSummary, getCompletionTransitions, getLatestPhasesFromBranchEntries, getLatestTodosFromBranchEntries, getTaskTargets, getTodoMarker, getTodoResultLines, getTodoWidgetLines, initPhases, isIncompleteTodo, isTerminalTodoStatus, isTodoItem, isTodoItemArray, isTodoPhase, isTodoPhaseArray, nextActionableTask, normalizeInProgressTask, removeTasks, resolvePhaseOrError, resolveTaskOrError, sanitizeTodoText, TODO_STATE_ENTRY_TYPE, type TodoCompletionTransition, type TodoItem, type TodoOpEntry, type TodoOperation, type TodoPhase, type TodoStateEntry, type TodoStatus, type TodoToolDetails, } from "./state.ts";
+export { appendItems, applyEntry, applyOpsToPhases, applyParams, clonePhases, cloneTask, DEFAULT_INIT_PHASE, describeAskNowNext, findPhaseByName, findTaskByContent, formatSummary, getCompletionTransitions, getLatestPhasesFromBranchEntries, getLatestTodoStateFromBranchEntries, getLatestTodosFromBranchEntries, getTaskTargets, getTodoMarker, getTodoResultLines, getTodoWidgetLines, initPhases, isIncompleteTodo, isTerminalTodoStatus, isTodoItem, isTodoItemArray, isTodoPhase, isTodoPhaseArray, nextActionableTask, normalizeInProgressTask, removeTasks, resolvePhaseOrError, resolveTaskOrError, sanitizeTodoText, TODO_STATE_ENTRY_TYPE, type TodoAsk, type TodoCompletionTransition, type TodoItem, type TodoOpEntry, type TodoOperation, type TodoPhase, type TodoState, type TodoStateEntry, type TodoStatus, type TodoToolDetails, } from "./state.ts";
 export { phaseRomanNumeral } from "./tools/todo.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/extensions/builtin/todotools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAmBrE,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAyDjE;AAED,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrG,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EACN,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,gCAAgC,EAChC,+BAA+B,EAC/B,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,eAAe,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAwBrE,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA+GjE;AAED,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrG,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EACN,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,gCAAgC,EAChC,mCAAmC,EACnC,+BAA+B,EAC/B,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,OAAO,EACZ,KAAK,wBAAwB,EAC7B,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,eAAe,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core/extensions/builtin/todotools/index.js

@@ -1,36 +1,58 @@
+import { createSessionLogger } from "../../../session-log.js";
+import { SettingsManager } from "../../../settings-manager.js";
 import { registerTodoCommand } from "./commands.js";
+import { FIRST_TURN_CUSTOM_TYPE, FIRST_TURN_REMINDER, shouldArmFirstTurn, withForcedTodoChoice } from "./first-turn.js";
 import { phasesFromCursorTodos } from "./native-todo-mirror.js";
 import { TASK_MANAGEMENT_SECTION } from "./prompt.js";
-import { clonePhases, getLatestPhasesFromBranchEntries, } from "./state.js";
+import { clonePhases, getLatestTodoStateFromBranchEntries, } from "./state.js";
 import { TODO_STATE_ENTRY_TYPE } from "./todo-types.js";
 import { getTodoWidgetModel } from "./todo-widget.js";
 import { TodoWidgetComponent } from "./todo-widget-component.js";
 import { registerTodoTool } from "./tools/todo.js";
-function getLatestPhases(ctx) {
-    return getLatestPhasesFromBranchEntries(ctx.sessionManager.getBranch());
+function readFirstTurnPlan(ctx) {
+    return SettingsManager.create(ctx.cwd, ctx.agentDir, {
+        projectTrusted: ctx.isProjectTrusted(),
+    }).getTodoFirstTurnPlan();
 }
 export default function todotoolsExtension(pi) {
-    let currentPhases = [];
-    const getCurrentPhases = () => clonePhases(currentPhases);
+    let currentState = { phases: [], ask: undefined };
+    // Armed by the first-turn opener; cleared once that run's first assistant message lands.
+    let pendingForce;
+    let logger;
+    const clearPendingForce = () => {
+        pendingForce = undefined;
+    };
+    const getCurrentPhases = () => clonePhases(currentState.phases);
     const setCurrentPhases = (phases) => {
-        currentPhases = clonePhases(phases);
+        currentState = { ...currentState, phases: clonePhases(phases) };
+    };
+    const getCurrentAsk = () => currentState.ask;
+    const setCurrentAsk = (ask) => {
+        currentState = { ...currentState, ask };
     };
     const syncWidget = (ctx, completedTasks = []) => {
-        const model = getTodoWidgetModel(currentPhases);
+        const model = getTodoWidgetModel(currentState.phases);
         ctx.ui.setWidget("todo-sidebar", model ? (tui, theme) => new TodoWidgetComponent(tui, theme, model, completedTasks) : undefined);
     };
     const syncFromSession = (ctx) => {
-        currentPhases = getLatestPhases(ctx);
+        currentState = getLatestTodoStateFromBranchEntries(ctx.sessionManager.getBranch());
         syncWidget(ctx);
     };
     pi.on("session_start", async (_event, ctx) => {
+        clearPendingForce();
         syncFromSession(ctx);
     });
     pi.on("session_tree", async (_event, ctx) => {
+        clearPendingForce();
         syncFromSession(ctx);
     });
+    pi.on("agent_end", clearPendingForce);
+    pi.on("session_abort", clearPendingForce);
+    pi.on("session_shutdown", clearPendingForce);
     pi.on("message_end", async (event, ctx) => {
         const message = event.message;
+        if (message?.role === "assistant")
+            clearPendingForce();
         if (message?.role !== "assistant" || !Array.isArray(message.content)) {
             return;
         }
@@ -43,21 +65,54 @@ export default function todotoolsExtension(pi) {
                 continue;
             }
             setCurrentPhases(phases);
-            pi.appendEntry(TODO_STATE_ENTRY_TYPE, { schema: "v2", phases });
+            const ask = getCurrentAsk();
+            pi.appendEntry(TODO_STATE_ENTRY_TYPE, { schema: "v2", phases, ...(ask ? { ask } : {}) });
             syncWidget(ctx);
         }
     });
-    pi.on("before_agent_start", async (event) => {
+    pi.on("before_agent_start", async (event, ctx) => {
+        const systemPrompt = `${event.systemPrompt}\n${TASK_MANAGEMENT_SECTION}`;
+        if (event.preview)
+            return { systemPrompt };
+        const branchEntries = ctx.sessionManager.getBranch();
+        const setting = readFirstTurnPlan(ctx);
+        const armed = shouldArmFirstTurn({
+            preview: event.preview,
+            prompt: event.prompt,
+            branchEntries,
+            phases: getLatestTodoStateFromBranchEntries(branchEntries).phases,
+            todoActive: pi.getActiveTools().includes("todo"),
+            setting,
+            mode: ctx.mode,
+        });
+        if (!armed)
+            return { systemPrompt };
+        pendingForce = { forceNamed: setting === "force", logged: false };
         return {
-            systemPrompt: `${event.systemPrompt}\n${TASK_MANAGEMENT_SECTION}`,
+            systemPrompt,
+            message: { customType: FIRST_TURN_CUSTOM_TYPE, content: FIRST_TURN_REMINDER, display: false },
         };
+    }, { previewSafe: true });
+    pi.on("before_provider_request", async (event, ctx) => {
+        if (!pendingForce)
+            return undefined;
+        const forced = pendingForce.forceNamed
+            ? withForcedTodoChoice(event.payload, event.model ?? ctx.model)
+            : undefined;
+        if (!pendingForce.logged) {
+            pendingForce.logged = true;
+            logger ??= createSessionLogger(ctx.agentDir);
+            logger.info("todo_first_turn", { mode: forced === undefined ? "reminder-only" : "forced" });
+        }
+        return forced;
     });
-    registerTodoTool(pi, { getCurrentPhases, setCurrentPhases, syncWidget });
-    registerTodoCommand(pi, { getCurrentPhases, setCurrentPhases, syncWidget });
+    const accessors = { getCurrentPhases, setCurrentPhases, getCurrentAsk, setCurrentAsk, syncWidget };
+    registerTodoTool(pi, accessors);
+    registerTodoCommand(pi, accessors);
 }
 export { findPhaseFuzzy, findTaskFuzzy, registerTodoCommand, tokenizeTodoArgs } from "./commands.js";
 export { markdownToPhases, phasesToMarkdown, resolveTodoMarkdownPath } from "./markdown.js";
 export { TASK_MANAGEMENT_SECTION } from "./prompt.js";
-export { appendItems, applyEntry, applyOpsToPhases, applyParams, clonePhases, cloneTask, DEFAULT_INIT_PHASE, findPhaseByName, findTaskByContent, formatSummary, getCompletionTransitions, getLatestPhasesFromBranchEntries, getLatestTodosFromBranchEntries, getTaskTargets, getTodoMarker, getTodoResultLines, getTodoWidgetLines, initPhases, isIncompleteTodo, isTerminalTodoStatus, isTodoItem, isTodoItemArray, isTodoPhase, isTodoPhaseArray, nextActionableTask, normalizeInProgressTask, removeTasks, resolvePhaseOrError, resolveTaskOrError, sanitizeTodoText, TODO_STATE_ENTRY_TYPE, } from "./state.js";
+export { appendItems, applyEntry, applyOpsToPhases, applyParams, clonePhases, cloneTask, DEFAULT_INIT_PHASE, describeAskNowNext, findPhaseByName, findTaskByContent, formatSummary, getCompletionTransitions, getLatestPhasesFromBranchEntries, getLatestTodoStateFromBranchEntries, getLatestTodosFromBranchEntries, getTaskTargets, getTodoMarker, getTodoResultLines, getTodoWidgetLines, initPhases, isIncompleteTodo, isTerminalTodoStatus, isTodoItem, isTodoItemArray, isTodoPhase, isTodoPhaseArray, nextActionableTask, normalizeInProgressTask, removeTasks, resolvePhaseOrError, resolveTaskOrError, sanitizeTodoText, TODO_STATE_ENTRY_TYPE, } from "./state.js";
 export { phaseRomanNumeral } from "./tools/todo.js";
 //# sourceMappingURL=index.js.map

package/dist/core/extensions/builtin/todotools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExtensionAPI, ExtensionContext } from \"../../types.ts\";\nimport { registerTodoCommand } from \"./commands.ts\";\nimport { phasesFromCursorTodos } from \"./native-todo-mirror.ts\";\nimport { TASK_MANAGEMENT_SECTION } from \"./prompt.ts\";\nimport {\n\tclonePhases,\n\tgetLatestPhasesFromBranchEntries,\n\ttype TodoCompletionTransition,\n\ttype TodoPhase,\n} from \"./state.ts\";\nimport { TODO_STATE_ENTRY_TYPE } from \"./todo-types.ts\";\nimport { getTodoWidgetModel } from \"./todo-widget.ts\";\nimport { TodoWidgetComponent } from \"./todo-widget-component.ts\";\nimport { registerTodoTool } from \"./tools/todo.ts\";\n\nfunction getLatestPhases(ctx: ExtensionContext): TodoPhase[] {\n\treturn getLatestPhasesFromBranchEntries(ctx.sessionManager.getBranch());\n}\n\nexport default function todotoolsExtension(pi: ExtensionAPI): void {\n\tlet currentPhases: TodoPhase[] = [];\n\n\tconst getCurrentPhases = (): TodoPhase[] => clonePhases(currentPhases);\n\n\tconst setCurrentPhases = (phases: TodoPhase[]): void => {\n\t\tcurrentPhases = clonePhases(phases);\n\t};\n\n\tconst syncWidget = (ctx: ExtensionContext, completedTasks: readonly TodoCompletionTransition[] = []): void => {\n\t\tconst model = getTodoWidgetModel(currentPhases);\n\t\tctx.ui.setWidget(\n\t\t\t\"todo-sidebar\",\n\t\t\tmodel ? (tui, theme) => new TodoWidgetComponent(tui, theme, model, completedTasks) : undefined,\n\t\t);\n\t};\n\n\tconst syncFromSession = (ctx: ExtensionContext): void => {\n\t\tcurrentPhases = getLatestPhases(ctx);\n\t\tsyncWidget(ctx);\n\t};\n\n\tpi.on(\"session_start\", async (_event, ctx) => {\n\t\tsyncFromSession(ctx);\n\t});\n\n\tpi.on(\"session_tree\", async (_event, ctx) => {\n\t\tsyncFromSession(ctx);\n\t});\n\n\tpi.on(\"message_end\", async (event, ctx) => {\n\t\tconst message = event.message;\n\t\tif (message?.role !== \"assistant\" || !Array.isArray(message.content)) {\n\t\t\treturn;\n\t\t}\n\t\tfor (const block of message.content) {\n\t\t\tif (block.type !== \"toolCall\" || block.name !== \"todo\" || block.arguments?.op) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst phases = phasesFromCursorTodos(block.arguments?.todos);\n\t\t\tif (phases === undefined) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tsetCurrentPhases(phases);\n\t\t\tpi.appendEntry(TODO_STATE_ENTRY_TYPE, { schema: \"v2\", phases });\n\t\t\tsyncWidget(ctx);\n\t\t}\n\t});\n\n\tpi.on(\"before_agent_start\", async (event) => {\n\t\treturn {\n\t\t\tsystemPrompt: `${event.systemPrompt}\\n${TASK_MANAGEMENT_SECTION}`,\n\t\t};\n\t});\n\n\tregisterTodoTool(pi, { getCurrentPhases, setCurrentPhases, syncWidget });\n\tregisterTodoCommand(pi, { getCurrentPhases, setCurrentPhases, syncWidget });\n}\n\nexport { findPhaseFuzzy, findTaskFuzzy, registerTodoCommand, tokenizeTodoArgs } from \"./commands.ts\";\nexport { markdownToPhases, phasesToMarkdown, resolveTodoMarkdownPath } from \"./markdown.ts\";\nexport { TASK_MANAGEMENT_SECTION } from \"./prompt.ts\";\nexport {\n\tappendItems,\n\tapplyEntry,\n\tapplyOpsToPhases,\n\tapplyParams,\n\tclonePhases,\n\tcloneTask,\n\tDEFAULT_INIT_PHASE,\n\tfindPhaseByName,\n\tfindTaskByContent,\n\tformatSummary,\n\tgetCompletionTransitions,\n\tgetLatestPhasesFromBranchEntries,\n\tgetLatestTodosFromBranchEntries,\n\tgetTaskTargets,\n\tgetTodoMarker,\n\tgetTodoResultLines,\n\tgetTodoWidgetLines,\n\tinitPhases,\n\tisIncompleteTodo,\n\tisTerminalTodoStatus,\n\tisTodoItem,\n\tisTodoItemArray,\n\tisTodoPhase,\n\tisTodoPhaseArray,\n\tnextActionableTask,\n\tnormalizeInProgressTask,\n\tremoveTasks,\n\tresolvePhaseOrError,\n\tresolveTaskOrError,\n\tsanitizeTodoText,\n\tTODO_STATE_ENTRY_TYPE,\n\ttype TodoCompletionTransition,\n\ttype TodoItem,\n\ttype TodoOpEntry,\n\ttype TodoOperation,\n\ttype TodoPhase,\n\ttype TodoStateEntry,\n\ttype TodoStatus,\n\ttype TodoToolDetails,\n} from \"./state.ts\";\nexport { phaseRomanNumeral } from \"./tools/todo.ts\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { createSessionLogger, type SessionLogger } from \"../../../session-log.ts\";\nimport { SettingsManager } from \"../../../settings-manager.ts\";\nimport type { ExtensionAPI, ExtensionContext } from \"../../types.ts\";\nimport { registerTodoCommand } from \"./commands.ts\";\nimport { FIRST_TURN_CUSTOM_TYPE, FIRST_TURN_REMINDER, shouldArmFirstTurn, withForcedTodoChoice } from \"./first-turn.ts\";\nimport { phasesFromCursorTodos } from \"./native-todo-mirror.ts\";\nimport { TASK_MANAGEMENT_SECTION } from \"./prompt.ts\";\nimport {\n\tclonePhases,\n\tgetLatestTodoStateFromBranchEntries,\n\ttype TodoAsk,\n\ttype TodoCompletionTransition,\n\ttype TodoPhase,\n\ttype TodoState,\n} from \"./state.ts\";\nimport { TODO_STATE_ENTRY_TYPE } from \"./todo-types.ts\";\nimport { getTodoWidgetModel } from \"./todo-widget.ts\";\nimport { TodoWidgetComponent } from \"./todo-widget-component.ts\";\nimport { registerTodoTool } from \"./tools/todo.ts\";\n\nfunction readFirstTurnPlan(ctx: ExtensionContext) {\n\treturn SettingsManager.create(ctx.cwd, ctx.agentDir, {\n\t\tprojectTrusted: ctx.isProjectTrusted(),\n\t}).getTodoFirstTurnPlan();\n}\n\nexport default function todotoolsExtension(pi: ExtensionAPI): void {\n\tlet currentState: TodoState = { phases: [], ask: undefined };\n\t// Armed by the first-turn opener; cleared once that run's first assistant message lands.\n\tlet pendingForce: { forceNamed: boolean; logged: boolean } | undefined;\n\tlet logger: SessionLogger | undefined;\n\tconst clearPendingForce = (): void => {\n\t\tpendingForce = undefined;\n\t};\n\n\tconst getCurrentPhases = (): TodoPhase[] => clonePhases(currentState.phases);\n\n\tconst setCurrentPhases = (phases: TodoPhase[]): void => {\n\t\tcurrentState = { ...currentState, phases: clonePhases(phases) };\n\t};\n\n\tconst getCurrentAsk = (): TodoAsk | undefined => currentState.ask;\n\n\tconst setCurrentAsk = (ask: TodoAsk | undefined): void => {\n\t\tcurrentState = { ...currentState, ask };\n\t};\n\n\tconst syncWidget = (ctx: ExtensionContext, completedTasks: readonly TodoCompletionTransition[] = []): void => {\n\t\tconst model = getTodoWidgetModel(currentState.phases);\n\t\tctx.ui.setWidget(\n\t\t\t\"todo-sidebar\",\n\t\t\tmodel ? (tui, theme) => new TodoWidgetComponent(tui, theme, model, completedTasks) : undefined,\n\t\t);\n\t};\n\n\tconst syncFromSession = (ctx: ExtensionContext): void => {\n\t\tcurrentState = getLatestTodoStateFromBranchEntries(ctx.sessionManager.getBranch());\n\t\tsyncWidget(ctx);\n\t};\n\n\tpi.on(\"session_start\", async (_event, ctx) => {\n\t\tclearPendingForce();\n\t\tsyncFromSession(ctx);\n\t});\n\n\tpi.on(\"session_tree\", async (_event, ctx) => {\n\t\tclearPendingForce();\n\t\tsyncFromSession(ctx);\n\t});\n\n\tpi.on(\"agent_end\", clearPendingForce);\n\tpi.on(\"session_abort\", clearPendingForce);\n\tpi.on(\"session_shutdown\", clearPendingForce);\n\n\tpi.on(\"message_end\", async (event, ctx) => {\n\t\tconst message = event.message;\n\t\tif (message?.role === \"assistant\") clearPendingForce();\n\t\tif (message?.role !== \"assistant\" || !Array.isArray(message.content)) {\n\t\t\treturn;\n\t\t}\n\t\tfor (const block of message.content) {\n\t\t\tif (block.type !== \"toolCall\" || block.name !== \"todo\" || block.arguments?.op) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst phases = phasesFromCursorTodos(block.arguments?.todos);\n\t\t\tif (phases === undefined) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tsetCurrentPhases(phases);\n\t\t\tconst ask = getCurrentAsk();\n\t\t\tpi.appendEntry(TODO_STATE_ENTRY_TYPE, { schema: \"v2\", phases, ...(ask ? { ask } : {}) });\n\t\t\tsyncWidget(ctx);\n\t\t}\n\t});\n\n\tpi.on(\n\t\t\"before_agent_start\",\n\t\tasync (event, ctx) => {\n\t\t\tconst systemPrompt = `${event.systemPrompt}\\n${TASK_MANAGEMENT_SECTION}`;\n\t\t\tif (event.preview) return { systemPrompt };\n\t\t\tconst branchEntries = ctx.sessionManager.getBranch();\n\t\t\tconst setting = readFirstTurnPlan(ctx);\n\t\t\tconst armed = shouldArmFirstTurn({\n\t\t\t\tpreview: event.preview,\n\t\t\t\tprompt: event.prompt,\n\t\t\t\tbranchEntries,\n\t\t\t\tphases: getLatestTodoStateFromBranchEntries(branchEntries).phases,\n\t\t\t\ttodoActive: pi.getActiveTools().includes(\"todo\"),\n\t\t\t\tsetting,\n\t\t\t\tmode: ctx.mode,\n\t\t\t});\n\t\t\tif (!armed) return { systemPrompt };\n\t\t\tpendingForce = { forceNamed: setting === \"force\", logged: false };\n\t\t\treturn {\n\t\t\t\tsystemPrompt,\n\t\t\t\tmessage: { customType: FIRST_TURN_CUSTOM_TYPE, content: FIRST_TURN_REMINDER, display: false },\n\t\t\t};\n\t\t},\n\t\t{ previewSafe: true },\n\t);\n\n\tpi.on(\"before_provider_request\", async (event, ctx) => {\n\t\tif (!pendingForce) return undefined;\n\t\tconst forced = pendingForce.forceNamed\n\t\t\t? withForcedTodoChoice(event.payload, event.model ?? ctx.model)\n\t\t\t: undefined;\n\t\tif (!pendingForce.logged) {\n\t\t\tpendingForce.logged = true;\n\t\t\tlogger ??= createSessionLogger(ctx.agentDir);\n\t\t\tlogger.info(\"todo_first_turn\", { mode: forced === undefined ? \"reminder-only\" : \"forced\" });\n\t\t}\n\t\treturn forced;\n\t});\n\n\tconst accessors = { getCurrentPhases, setCurrentPhases, getCurrentAsk, setCurrentAsk, syncWidget };\n\tregisterTodoTool(pi, accessors);\n\tregisterTodoCommand(pi, accessors);\n}\n\nexport { findPhaseFuzzy, findTaskFuzzy, registerTodoCommand, tokenizeTodoArgs } from \"./commands.ts\";\nexport { markdownToPhases, phasesToMarkdown, resolveTodoMarkdownPath } from \"./markdown.ts\";\nexport { TASK_MANAGEMENT_SECTION } from \"./prompt.ts\";\nexport {\n\tappendItems,\n\tapplyEntry,\n\tapplyOpsToPhases,\n\tapplyParams,\n\tclonePhases,\n\tcloneTask,\n\tDEFAULT_INIT_PHASE,\n\tdescribeAskNowNext,\n\tfindPhaseByName,\n\tfindTaskByContent,\n\tformatSummary,\n\tgetCompletionTransitions,\n\tgetLatestPhasesFromBranchEntries,\n\tgetLatestTodoStateFromBranchEntries,\n\tgetLatestTodosFromBranchEntries,\n\tgetTaskTargets,\n\tgetTodoMarker,\n\tgetTodoResultLines,\n\tgetTodoWidgetLines,\n\tinitPhases,\n\tisIncompleteTodo,\n\tisTerminalTodoStatus,\n\tisTodoItem,\n\tisTodoItemArray,\n\tisTodoPhase,\n\tisTodoPhaseArray,\n\tnextActionableTask,\n\tnormalizeInProgressTask,\n\tremoveTasks,\n\tresolvePhaseOrError,\n\tresolveTaskOrError,\n\tsanitizeTodoText,\n\tTODO_STATE_ENTRY_TYPE,\n\ttype TodoAsk,\n\ttype TodoCompletionTransition,\n\ttype TodoItem,\n\ttype TodoOpEntry,\n\ttype TodoOperation,\n\ttype TodoPhase,\n\ttype TodoState,\n\ttype TodoStateEntry,\n\ttype TodoStatus,\n\ttype TodoToolDetails,\n} from \"./state.ts\";\nexport { phaseRomanNumeral } from \"./tools/todo.ts\";\n"]}

package/dist/core/extensions/builtin/todotools/prompt.d.ts

@@ -1,3 +1,3 @@
-export declare const TODO_TOOL_DESCRIPTION = "**Tasks referenced by verbatim content string, NEVER an auto-generated ID \u2014 no \"task-1\"/\"task-N\" exists. Pass the content text in the task field.**\n\nOn each completion the earliest still-open task (in phase order) auto-promotes to in_progress.\nCompleting tasks out of phase order can move this pointer **back** to an earlier phase \u2014 expected; completed tasks are never reverted.\n\n## Operations\n\n| op | Required fields | Effect |\n|---|---|---|\n| init | list: [{phase, items: string[]}] | Initialize full list (replaces existing) |\n| init | items: string[] | Flattened single-phase init |\n| start | task | Mark in progress |\n| done | task or phase | Mark completed |\n| drop | task or phase | Mark abandoned |\n| rm | task or phase (optional) | Remove task or phase; omit both to clear |\n| append | phase?, items: string[] | Append tasks to phase; lazily creates phase |\n| view | \u2014 | Read-only: echo list |\n\nExample: {\"op\":\"init\",\"list\":[{\"phase\":\"Setup\",\"items\":[\"Survey code\",\"Write tests\"]}]}\n\n## Anatomy\n- **Task content**: 5\u201310 words; what, not how. Unique identifier.\n- **Phase name**: short noun phrase (e.g. Foundation, Auth, Verification). Unique identifier. NEVER prefix 1., A), Phase 1:.\n\n## Rules\n- Mark tasks done immediately after finishing, then re-check the list against the newest user message. Complete phases in order.\n- NEVER make a todo call your turn's only tool call \u2014 batch it with the real work: init with the first reads/edits, each done/start with the next action. Solo todo turns waste a round trip.\n- Blocked? append a task to the active phase, or drop.\n- Keep task/phase strings stable once introduced. done/start/drop take the task's EXACT text \u2014 copy it verbatim from the latest todo result; when it is lost, view echoes the list.\n\n## When to create a list\n- Task requires 3+ distinct steps\n- User explicitly requests one\n- User provides a set of tasks\n- New instructions arrive mid-task \u2014 reconcile before acting: keep what they don't conflict with, amend what they contradict, append what they add; replace only on explicit redirect\n\n<critical>\nUser hands you a multi-step plan \u2014 phased todo, numbered/bulleted checklist, or \"N bugs/items/tasks\":\n- You MUST init the list with EVERY item as its own task before working.\n- Enumerate all; NEVER summarize into fewer tasks, sample \"the important ones\", drop items, or track the rest from memory.\n</critical>";
-export declare const TASK_MANAGEMENT_SECTION = "\n<Task_Management>\n## Todo Management\n\nUse the todo tool for multi-step work; its description carries the operations, anatomy, and rules. Mark each item done the moment it finishes and reconcile the list against the newest user message before ending a turn.\n\n## Evidence\n- File edit: inspect the changed files and diagnostics.\n- Build command: require exit code 0.\n- Test run: require passing output, or state the pre-existing failure.\n</Task_Management>\n";
+export declare const TODO_TOOL_DESCRIPTION = "**Tasks referenced by verbatim content string, NEVER an auto-generated ID \u2014 no \"task-1\"/\"task-N\" exists. Pass the content text in the task field.**\n\nOn each completion the earliest still-open task (in phase order) auto-promotes to in_progress.\nCompleting tasks out of phase order can move this pointer **back** to an earlier phase \u2014 expected; completed tasks are never reverted.\n\n## Operations\n\n| op | Required fields | Effect |\n|---|---|---|\n| init | list: [{phase, items: string[]}] | Initialize full list (replaces existing) |\n| init | items: string[] | Flattened single-phase init |\n| start | task | Mark in progress |\n| done | task or phase | Mark completed |\n| drop | task or phase | Mark abandoned |\n| rm | task or phase (optional) | Remove task or phase; omit both to clear |\n| append | phase?, items: string[] | Append tasks to phase; lazily creates phase |\n| view | \u2014 | Read-only: echo list |\n\nExample: {\"op\":\"init\",\"list\":[{\"phase\":\"Setup\",\"items\":[\"Survey code\",\"Write tests\"]}]}\n\n## Anatomy\n- **Task content**: 5\u201310 words; what, not how. Unique identifier.\n- **Phase name**: short noun phrase (e.g. Foundation, Auth, Verification). Unique identifier. NEVER prefix 1., A), Phase 1:.\n\n## Rules\n- Mark tasks done immediately after finishing, then re-check the list against the newest user message. Complete phases in order.\n- NEVER end a turn with a todo call as its only tool call - batch it with the real work: init with the first reads/edits, each done/start with the next action.\n- Blocked? append a task to the active phase, or drop.\n- Keep task/phase strings stable once introduced. done/start/drop take the task's EXACT text \u2014 copy it verbatim from the latest todo result; when it is lost, view echoes the list.\n\n## When to create a list\n- User explicitly requests one\n- User provides a set of tasks\n- New instructions arrive mid-task \u2014 reconcile before acting: keep what they don't conflict with, amend what they contradict, append what they add; replace only on explicit redirect\n\n<critical>\nUser hands you a multi-step plan \u2014 phased todo, numbered/bulleted checklist, or \"N bugs/items/tasks\":\n- You MUST init the list with EVERY item as its own task before working.\n- Enumerate all; NEVER summarize into fewer tasks, sample \"the important ones\", drop items, or track the rest from memory.\n</critical>";
+export declare const TASK_MANAGEMENT_SECTION = "\n<Task_Management>\n## Todo Management\n\nA request with three or more distinct steps gets a phased todo before the first edit - investigation, implementation, verification, final report - in the todo tool; its description carries the operations, anatomy, and rules. Mark each item done the moment it finishes and reconcile the list against the newest user message before ending a turn.\n\n## Evidence\n- File edit: inspect the changed files and diagnostics.\n- Build command: require exit code 0.\n- Test run: require passing output, or state the pre-existing failure.\n</Task_Management>\n";
 //# sourceMappingURL=prompt.d.ts.map

package/dist/core/extensions/builtin/todotools/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/prompt.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,qBAAqB,67EAwCtB,CAAC;AAEb,eAAO,MAAM,uBAAuB,udAWnC,CAAC"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/prompt.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,qBAAqB,u3EAuCtB,CAAC;AAEb,eAAO,MAAM,uBAAuB,qlBAWnC,CAAC"}

package/dist/core/extensions/builtin/todotools/prompt.js

@@ -28,12 +28,11 @@ Example: {"op":"init","list":[{"phase":"Setup","items":["Survey code","Write tes
 
 ## Rules
 - Mark tasks done immediately after finishing, then re-check the list against the newest user message. Complete phases in order.
-- NEVER make a todo call your turn's only tool call — batch it with the real work: init with the first reads/edits, each done/start with the next action. Solo todo turns waste a round trip.
+- NEVER end a turn with a todo call as its only tool call - batch it with the real work: init with the first reads/edits, each done/start with the next action.
 - Blocked? append a task to the active phase, or drop.
 - Keep task/phase strings stable once introduced. done/start/drop take the task's EXACT text — copy it verbatim from the latest todo result; when it is lost, view echoes the list.
 
 ## When to create a list
-- Task requires 3+ distinct steps
 - User explicitly requests one
 - User provides a set of tasks
 - New instructions arrive mid-task — reconcile before acting: keep what they don't conflict with, amend what they contradict, append what they add; replace only on explicit redirect
@@ -47,7 +46,7 @@ export const TASK_MANAGEMENT_SECTION = `
 <Task_Management>
 ## Todo Management
 
-Use the todo tool for multi-step work; its description carries the operations, anatomy, and rules. Mark each item done the moment it finishes and reconcile the list against the newest user message before ending a turn.
+A request with three or more distinct steps gets a phased todo before the first edit - investigation, implementation, verification, final report - in the todo tool; its description carries the operations, anatomy, and rules. Mark each item done the moment it finishes and reconcile the list against the newest user message before ending a turn.
 
 ## Evidence
 - File edit: inspect the changed files and diagnostics.

package/dist/core/extensions/builtin/todotools/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/prompt.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAAmC;AACnC,oCAAoC;AACpC,sCAAsC;AAEtC,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAwCzB,CAAC;AAEb,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;CAWtC,CAAC","sourcesContent":["// Adapted from oh-my-pi's todo prompt (MIT License).\n// Copyright (c) 2025 Mario Zechner\n// Copyright (c) 2025-2026 Can Bölük\n// https://github.com/can1357/oh-my-pi\n\nexport const TODO_TOOL_DESCRIPTION = `**Tasks referenced by verbatim content string, NEVER an auto-generated ID — no \"task-1\"/\"task-N\" exists. Pass the content text in the task field.**\n\nOn each completion the earliest still-open task (in phase order) auto-promotes to in_progress.\nCompleting tasks out of phase order can move this pointer **back** to an earlier phase — expected; completed tasks are never reverted.\n\n## Operations\n\n| op | Required fields | Effect |\n|---|---|---|\n| init | list: [{phase, items: string[]}] | Initialize full list (replaces existing) |\n| init | items: string[] | Flattened single-phase init |\n| start | task | Mark in progress |\n| done | task or phase | Mark completed |\n| drop | task or phase | Mark abandoned |\n| rm | task or phase (optional) | Remove task or phase; omit both to clear |\n| append | phase?, items: string[] | Append tasks to phase; lazily creates phase |\n| view | — | Read-only: echo list |\n\nExample: {\"op\":\"init\",\"list\":[{\"phase\":\"Setup\",\"items\":[\"Survey code\",\"Write tests\"]}]}\n\n## Anatomy\n- **Task content**: 5–10 words; what, not how. Unique identifier.\n- **Phase name**: short noun phrase (e.g. Foundation, Auth, Verification). Unique identifier. NEVER prefix 1., A), Phase 1:.\n\n## Rules\n- Mark tasks done immediately after finishing, then re-check the list against the newest user message. Complete phases in order.\n- NEVER make a todo call your turn's only tool call — batch it with the real work: init with the first reads/edits, each done/start with the next action. Solo todo turns waste a round trip.\n- Blocked? append a task to the active phase, or drop.\n- Keep task/phase strings stable once introduced. done/start/drop take the task's EXACT text — copy it verbatim from the latest todo result; when it is lost, view echoes the list.\n\n## When to create a list\n- Task requires 3+ distinct steps\n- User explicitly requests one\n- User provides a set of tasks\n- New instructions arrive mid-task — reconcile before acting: keep what they don't conflict with, amend what they contradict, append what they add; replace only on explicit redirect\n\n<critical>\nUser hands you a multi-step plan — phased todo, numbered/bulleted checklist, or \"N bugs/items/tasks\":\n- You MUST init the list with EVERY item as its own task before working.\n- Enumerate all; NEVER summarize into fewer tasks, sample \"the important ones\", drop items, or track the rest from memory.\n</critical>`;\n\nexport const TASK_MANAGEMENT_SECTION = `\n<Task_Management>\n## Todo Management\n\nUse the todo tool for multi-step work; its description carries the operations, anatomy, and rules. Mark each item done the moment it finishes and reconcile the list against the newest user message before ending a turn.\n\n## Evidence\n- File edit: inspect the changed files and diagnostics.\n- Build command: require exit code 0.\n- Test run: require passing output, or state the pre-existing failure.\n</Task_Management>\n`;\n"]}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/prompt.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAAmC;AACnC,oCAAoC;AACpC,sCAAsC;AAEtC,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAuCzB,CAAC;AAEb,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;CAWtC,CAAC","sourcesContent":["// Adapted from oh-my-pi's todo prompt (MIT License).\n// Copyright (c) 2025 Mario Zechner\n// Copyright (c) 2025-2026 Can Bölük\n// https://github.com/can1357/oh-my-pi\n\nexport const TODO_TOOL_DESCRIPTION = `**Tasks referenced by verbatim content string, NEVER an auto-generated ID — no \"task-1\"/\"task-N\" exists. Pass the content text in the task field.**\n\nOn each completion the earliest still-open task (in phase order) auto-promotes to in_progress.\nCompleting tasks out of phase order can move this pointer **back** to an earlier phase — expected; completed tasks are never reverted.\n\n## Operations\n\n| op | Required fields | Effect |\n|---|---|---|\n| init | list: [{phase, items: string[]}] | Initialize full list (replaces existing) |\n| init | items: string[] | Flattened single-phase init |\n| start | task | Mark in progress |\n| done | task or phase | Mark completed |\n| drop | task or phase | Mark abandoned |\n| rm | task or phase (optional) | Remove task or phase; omit both to clear |\n| append | phase?, items: string[] | Append tasks to phase; lazily creates phase |\n| view | — | Read-only: echo list |\n\nExample: {\"op\":\"init\",\"list\":[{\"phase\":\"Setup\",\"items\":[\"Survey code\",\"Write tests\"]}]}\n\n## Anatomy\n- **Task content**: 5–10 words; what, not how. Unique identifier.\n- **Phase name**: short noun phrase (e.g. Foundation, Auth, Verification). Unique identifier. NEVER prefix 1., A), Phase 1:.\n\n## Rules\n- Mark tasks done immediately after finishing, then re-check the list against the newest user message. Complete phases in order.\n- NEVER end a turn with a todo call as its only tool call - batch it with the real work: init with the first reads/edits, each done/start with the next action.\n- Blocked? append a task to the active phase, or drop.\n- Keep task/phase strings stable once introduced. done/start/drop take the task's EXACT text — copy it verbatim from the latest todo result; when it is lost, view echoes the list.\n\n## When to create a list\n- User explicitly requests one\n- User provides a set of tasks\n- New instructions arrive mid-task — reconcile before acting: keep what they don't conflict with, amend what they contradict, append what they add; replace only on explicit redirect\n\n<critical>\nUser hands you a multi-step plan — phased todo, numbered/bulleted checklist, or \"N bugs/items/tasks\":\n- You MUST init the list with EVERY item as its own task before working.\n- Enumerate all; NEVER summarize into fewer tasks, sample \"the important ones\", drop items, or track the rest from memory.\n</critical>`;\n\nexport const TASK_MANAGEMENT_SECTION = `\n<Task_Management>\n## Todo Management\n\nA request with three or more distinct steps gets a phased todo before the first edit - investigation, implementation, verification, final report - in the todo tool; its description carries the operations, anatomy, and rules. Mark each item done the moment it finishes and reconcile the list against the newest user message before ending a turn.\n\n## Evidence\n- File edit: inspect the changed files and diagnostics.\n- Build command: require exit code 0.\n- Test run: require passing output, or state the pre-existing failure.\n</Task_Management>\n`;\n"]}

package/dist/core/extensions/builtin/todotools/state.d.ts

@@ -1,8 +1,9 @@
-export { formatSummary, getTodoMarker, getTodoResultLines, isIncompleteTodo, isTerminalTodoStatus, sanitizeTodoText, } from "./todo-format.ts";
+export { ASK_TEXT_LIMIT, captureListAsk, truncateAskText } from "./todo-ask.ts";
+export { type AskNowNext, describeAskNowNext, formatAskNowNextHeader, formatHandoffCue, formatSummary, getTodoMarker, getTodoResultLines, HANDOFF_CUES, type HandoffMoment, handoffMomentOf, isIncompleteTodo, isTerminalTodoStatus, sanitizeTodoText, } from "./todo-format.ts";
 export { appendItems, applyEntry, applyOpsToPhases, applyParams, initPhases, removeTasks, } from "./todo-operations.ts";
 export { findPhaseByName, findTaskByContent, getCompletionTransitions, nextActionableTask, normalizeInProgressTask, } from "./todo-query.ts";
 export { getTaskTargets, resolvePhaseOrError, resolveTaskOrError } from "./todo-resolution.ts";
-export { clonePhases, cloneTask, getLatestPhasesFromBranchEntries, getLatestTodosFromBranchEntries, isTodoItem, isTodoItemArray, isTodoPhase, isTodoPhaseArray, } from "./todo-storage.ts";
-export { DEFAULT_INIT_PHASE, TODO_STATE_ENTRY_TYPE, type TodoCompletionTransition, type TodoItem, type TodoOpEntry, type TodoOperation, type TodoPhase, type TodoStateEntry, type TodoStatus, type TodoToolDetails, } from "./todo-types.ts";
+export { clonePhases, cloneTask, getLatestPhasesFromBranchEntries, getLatestTodoStateFromBranchEntries, getLatestTodosFromBranchEntries, isTodoAsk, isTodoItem, isTodoItemArray, isTodoPhase, isTodoPhaseArray, } from "./todo-storage.ts";
+export { DEFAULT_INIT_PHASE, TODO_RESTORE_REQUEST_TYPE, TODO_STATE_ENTRY_TYPE, type TodoAsk, type TodoCompletionTransition, type TodoItem, type TodoOpEntry, type TodoOperation, type TodoPhase, type TodoState, type TodoStateEntry, type TodoStatus, type TodoToolDetails, } from "./todo-types.ts";
 export { getTodoWidgetLines, getTodoWidgetModel, type TodoWidgetModel, type TodoWidgetRow, } from "./todo-widget.ts";
 //# sourceMappingURL=state.d.ts.map

package/dist/core/extensions/builtin/todotools/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/state.ts"],"names":[],"mappings":"AAKA,OAAO,EACN,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,WAAW,GACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EACN,WAAW,EACX,SAAS,EACT,gCAAgC,EAChC,+BAA+B,EAC/B,UAAU,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,eAAe,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,aAAa,GAClB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/state.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EACN,KAAK,UAAU,EACf,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,KAAK,aAAa,EAClB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,WAAW,GACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EACN,WAAW,EACX,SAAS,EACT,gCAAgC,EAChC,mCAAmC,EACnC,+BAA+B,EAC/B,SAAS,EACT,UAAU,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,KAAK,OAAO,EACZ,KAAK,wBAAwB,EAC7B,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,eAAe,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,aAAa,GAClB,MAAM,kBAAkB,CAAC"}

package/dist/core/extensions/builtin/todotools/state.js

@@ -2,11 +2,12 @@
 // Copyright (c) 2025 Mario Zechner
 // Copyright (c) 2025-2026 Can Bölük
 // https://github.com/can1357/oh-my-pi
-export { formatSummary, getTodoMarker, getTodoResultLines, isIncompleteTodo, isTerminalTodoStatus, sanitizeTodoText, } from "./todo-format.js";
+export { ASK_TEXT_LIMIT, captureListAsk, truncateAskText } from "./todo-ask.js";
+export { describeAskNowNext, formatAskNowNextHeader, formatHandoffCue, formatSummary, getTodoMarker, getTodoResultLines, HANDOFF_CUES, handoffMomentOf, isIncompleteTodo, isTerminalTodoStatus, sanitizeTodoText, } from "./todo-format.js";
 export { appendItems, applyEntry, applyOpsToPhases, applyParams, initPhases, removeTasks, } from "./todo-operations.js";
 export { findPhaseByName, findTaskByContent, getCompletionTransitions, nextActionableTask, normalizeInProgressTask, } from "./todo-query.js";
 export { getTaskTargets, resolvePhaseOrError, resolveTaskOrError } from "./todo-resolution.js";
-export { clonePhases, cloneTask, getLatestPhasesFromBranchEntries, getLatestTodosFromBranchEntries, isTodoItem, isTodoItemArray, isTodoPhase, isTodoPhaseArray, } from "./todo-storage.js";
-export { DEFAULT_INIT_PHASE, TODO_STATE_ENTRY_TYPE, } from "./todo-types.js";
+export { clonePhases, cloneTask, getLatestPhasesFromBranchEntries, getLatestTodoStateFromBranchEntries, getLatestTodosFromBranchEntries, isTodoAsk, isTodoItem, isTodoItemArray, isTodoPhase, isTodoPhaseArray, } from "./todo-storage.js";
+export { DEFAULT_INIT_PHASE, TODO_RESTORE_REQUEST_TYPE, TODO_STATE_ENTRY_TYPE, } from "./todo-types.js";
 export { getTodoWidgetLines, getTodoWidgetModel, } from "./todo-widget.js";
 //# sourceMappingURL=state.js.map

package/dist/core/extensions/builtin/todotools/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/state.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,mCAAmC;AACnC,oCAAoC;AACpC,sCAAsC;AAEtC,OAAO,EACN,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,WAAW,GACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EACN,WAAW,EACX,SAAS,EACT,gCAAgC,EAChC,+BAA+B,EAC/B,UAAU,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,kBAAkB,EAClB,qBAAqB,GASrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,kBAAkB,EAClB,kBAAkB,GAGlB,MAAM,kBAAkB,CAAC","sourcesContent":["// Ported and adapted from oh-my-pi's todo tool (MIT License).\n// Copyright (c) 2025 Mario Zechner\n// Copyright (c) 2025-2026 Can Bölük\n// https://github.com/can1357/oh-my-pi\n\nexport {\n\tformatSummary,\n\tgetTodoMarker,\n\tgetTodoResultLines,\n\tisIncompleteTodo,\n\tisTerminalTodoStatus,\n\tsanitizeTodoText,\n} from \"./todo-format.ts\";\nexport {\n\tappendItems,\n\tapplyEntry,\n\tapplyOpsToPhases,\n\tapplyParams,\n\tinitPhases,\n\tremoveTasks,\n} from \"./todo-operations.ts\";\nexport {\n\tfindPhaseByName,\n\tfindTaskByContent,\n\tgetCompletionTransitions,\n\tnextActionableTask,\n\tnormalizeInProgressTask,\n} from \"./todo-query.ts\";\nexport { getTaskTargets, resolvePhaseOrError, resolveTaskOrError } from \"./todo-resolution.ts\";\nexport {\n\tclonePhases,\n\tcloneTask,\n\tgetLatestPhasesFromBranchEntries,\n\tgetLatestTodosFromBranchEntries,\n\tisTodoItem,\n\tisTodoItemArray,\n\tisTodoPhase,\n\tisTodoPhaseArray,\n} from \"./todo-storage.ts\";\nexport {\n\tDEFAULT_INIT_PHASE,\n\tTODO_STATE_ENTRY_TYPE,\n\ttype TodoCompletionTransition,\n\ttype TodoItem,\n\ttype TodoOpEntry,\n\ttype TodoOperation,\n\ttype TodoPhase,\n\ttype TodoStateEntry,\n\ttype TodoStatus,\n\ttype TodoToolDetails,\n} from \"./todo-types.ts\";\nexport {\n\tgetTodoWidgetLines,\n\tgetTodoWidgetModel,\n\ttype TodoWidgetModel,\n\ttype TodoWidgetRow,\n} from \"./todo-widget.ts\";\n"]}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/state.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,mCAAmC;AACnC,oCAAoC;AACpC,sCAAsC;AAEtC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAEN,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,YAAY,EAEZ,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,WAAW,GACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EACN,WAAW,EACX,SAAS,EACT,gCAAgC,EAChC,mCAAmC,EACnC,+BAA+B,EAC/B,SAAS,EACT,UAAU,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,GAWrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,kBAAkB,EAClB,kBAAkB,GAGlB,MAAM,kBAAkB,CAAC","sourcesContent":["// Ported and adapted from oh-my-pi's todo tool (MIT License).\n// Copyright (c) 2025 Mario Zechner\n// Copyright (c) 2025-2026 Can Bölük\n// https://github.com/can1357/oh-my-pi\n\nexport { ASK_TEXT_LIMIT, captureListAsk, truncateAskText } from \"./todo-ask.ts\";\nexport {\n\ttype AskNowNext,\n\tdescribeAskNowNext,\n\tformatAskNowNextHeader,\n\tformatHandoffCue,\n\tformatSummary,\n\tgetTodoMarker,\n\tgetTodoResultLines,\n\tHANDOFF_CUES,\n\ttype HandoffMoment,\n\thandoffMomentOf,\n\tisIncompleteTodo,\n\tisTerminalTodoStatus,\n\tsanitizeTodoText,\n} from \"./todo-format.ts\";\nexport {\n\tappendItems,\n\tapplyEntry,\n\tapplyOpsToPhases,\n\tapplyParams,\n\tinitPhases,\n\tremoveTasks,\n} from \"./todo-operations.ts\";\nexport {\n\tfindPhaseByName,\n\tfindTaskByContent,\n\tgetCompletionTransitions,\n\tnextActionableTask,\n\tnormalizeInProgressTask,\n} from \"./todo-query.ts\";\nexport { getTaskTargets, resolvePhaseOrError, resolveTaskOrError } from \"./todo-resolution.ts\";\nexport {\n\tclonePhases,\n\tcloneTask,\n\tgetLatestPhasesFromBranchEntries,\n\tgetLatestTodoStateFromBranchEntries,\n\tgetLatestTodosFromBranchEntries,\n\tisTodoAsk,\n\tisTodoItem,\n\tisTodoItemArray,\n\tisTodoPhase,\n\tisTodoPhaseArray,\n} from \"./todo-storage.ts\";\nexport {\n\tDEFAULT_INIT_PHASE,\n\tTODO_RESTORE_REQUEST_TYPE,\n\tTODO_STATE_ENTRY_TYPE,\n\ttype TodoAsk,\n\ttype TodoCompletionTransition,\n\ttype TodoItem,\n\ttype TodoOpEntry,\n\ttype TodoOperation,\n\ttype TodoPhase,\n\ttype TodoState,\n\ttype TodoStateEntry,\n\ttype TodoStatus,\n\ttype TodoToolDetails,\n} from \"./todo-types.ts\";\nexport {\n\tgetTodoWidgetLines,\n\tgetTodoWidgetModel,\n\ttype TodoWidgetModel,\n\ttype TodoWidgetRow,\n} from \"./todo-widget.ts\";\n"]}

package/dist/core/extensions/builtin/todotools/todo-ask.d.ts

@@ -0,0 +1,13 @@
+import type { SessionEntry } from "../../../session-manager.ts";
+import { type TodoAsk } from "./todo-types.ts";
+export declare const ASK_TEXT_LIMIT = 200;
+export declare function truncateAskText(text: string): string;
+/**
+ * The ask a newly created list anchors to. The first list of a branch anchors to the
+ * session's first user request; a later list-creating call is an explicit redirect and
+ * anchors to the newest user request. Ask-user answer frames are replies, not requests.
+ * A compaction restore request newer than both the last list and the last user request
+ * re-emits the ask its snapshot carried; the model never supplies an ask itself.
+ */
+export declare function captureListAsk(entries: readonly SessionEntry[], capturedAt: number): TodoAsk | undefined;
+//# sourceMappingURL=todo-ask.d.ts.map

package/dist/core/extensions/builtin/todotools/todo-ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-ask.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/todo-ask.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAIhE,OAAO,EAAoD,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEjG,eAAO,MAAM,cAAc,MAAM,CAAC;AAalC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CA0BxG"}

package/dist/core/extensions/builtin/todotools/todo-ask.js

@@ -0,0 +1,61 @@
+import { parseAskUserAnswerFrame } from "../ask-user/format.js";
+import { sanitizeTodoText } from "./todo-format.js";
+import { isTodoAsk } from "./todo-storage.js";
+import { TODO_RESTORE_REQUEST_TYPE, TODO_STATE_ENTRY_TYPE } from "./todo-types.js";
+export const ASK_TEXT_LIMIT = 200;
+function firstTextBlock(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return undefined;
+    for (const block of content) {
+        if (typeof block === "object" && block !== null && block.type === "text" && typeof block.text === "string") {
+            return block.text;
+        }
+    }
+    return undefined;
+}
+export function truncateAskText(text) {
+    const codePoints = Array.from(text);
+    if (codePoints.length <= ASK_TEXT_LIMIT)
+        return text;
+    return `${codePoints.slice(0, ASK_TEXT_LIMIT).join("")}… (+${codePoints.length - ASK_TEXT_LIMIT} chars)`;
+}
+/**
+ * The ask a newly created list anchors to. The first list of a branch anchors to the
+ * session's first user request; a later list-creating call is an explicit redirect and
+ * anchors to the newest user request. Ask-user answer frames are replies, not requests.
+ * A compaction restore request newer than both the last list and the last user request
+ * re-emits the ask its snapshot carried; the model never supplies an ask itself.
+ */
+export function captureListAsk(entries, capturedAt) {
+    let lastStateIndex = -1;
+    let restore;
+    const requests = [];
+    entries.forEach((entry, index) => {
+        if (entry.type === "custom" && entry.customType === TODO_STATE_ENTRY_TYPE) {
+            lastStateIndex = index;
+            return;
+        }
+        if (entry.type === "custom_message" && entry.customType === TODO_RESTORE_REQUEST_TYPE) {
+            const ask = entry.details?.ask;
+            if (isTodoAsk(ask))
+                restore = { index, ask };
+            return;
+        }
+        if (entry.type !== "message" || entry.message.role !== "user")
+            return;
+        const raw = firstTextBlock(entry.message.content);
+        if (raw === undefined || parseAskUserAnswerFrame(raw))
+            return;
+        const text = sanitizeTodoText(raw);
+        if (text)
+            requests.push({ index, entryId: entry.id, text });
+    });
+    const latest = requests.at(-1);
+    if (restore && restore.index > lastStateIndex && restore.index > (latest?.index ?? -1))
+        return { ...restore.ask };
+    const chosen = lastStateIndex === -1 ? requests[0] : latest;
+    return chosen ? { entryId: chosen.entryId, text: truncateAskText(chosen.text), capturedAt } : undefined;
+}
+//# sourceMappingURL=todo-ask.js.map

package/dist/core/extensions/builtin/todotools/todo-ask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-ask.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/todo-ask.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SessionEntry } from \"../../../session-manager.ts\";\nimport { parseAskUserAnswerFrame } from \"../ask-user/format.ts\";\nimport { sanitizeTodoText } from \"./todo-format.ts\";\nimport { isTodoAsk } from \"./todo-storage.ts\";\nimport { TODO_RESTORE_REQUEST_TYPE, TODO_STATE_ENTRY_TYPE, type TodoAsk } from \"./todo-types.ts\";\n\nexport const ASK_TEXT_LIMIT = 200;\n\nfunction firstTextBlock(content: unknown): string | undefined {\n\tif (typeof content === \"string\") return content;\n\tif (!Array.isArray(content)) return undefined;\n\tfor (const block of content) {\n\t\tif (typeof block === \"object\" && block !== null && block.type === \"text\" && typeof block.text === \"string\") {\n\t\t\treturn block.text;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nexport function truncateAskText(text: string): string {\n\tconst codePoints = Array.from(text);\n\tif (codePoints.length <= ASK_TEXT_LIMIT) return text;\n\treturn `${codePoints.slice(0, ASK_TEXT_LIMIT).join(\"\")}… (+${codePoints.length - ASK_TEXT_LIMIT} chars)`;\n}\n\n/**\n * The ask a newly created list anchors to. The first list of a branch anchors to the\n * session's first user request; a later list-creating call is an explicit redirect and\n * anchors to the newest user request. Ask-user answer frames are replies, not requests.\n * A compaction restore request newer than both the last list and the last user request\n * re-emits the ask its snapshot carried; the model never supplies an ask itself.\n */\nexport function captureListAsk(entries: readonly SessionEntry[], capturedAt: number): TodoAsk | undefined {\n\tlet lastStateIndex = -1;\n\tlet restore: { index: number; ask: TodoAsk } | undefined;\n\tconst requests: Array<{ index: number; entryId: string; text: string }> = [];\n\n\tentries.forEach((entry, index) => {\n\t\tif (entry.type === \"custom\" && entry.customType === TODO_STATE_ENTRY_TYPE) {\n\t\t\tlastStateIndex = index;\n\t\t\treturn;\n\t\t}\n\t\tif (entry.type === \"custom_message\" && entry.customType === TODO_RESTORE_REQUEST_TYPE) {\n\t\t\tconst ask = (entry.details as { ask?: unknown } | undefined)?.ask;\n\t\t\tif (isTodoAsk(ask)) restore = { index, ask };\n\t\t\treturn;\n\t\t}\n\t\tif (entry.type !== \"message\" || entry.message.role !== \"user\") return;\n\t\tconst raw = firstTextBlock(entry.message.content);\n\t\tif (raw === undefined || parseAskUserAnswerFrame(raw)) return;\n\t\tconst text = sanitizeTodoText(raw);\n\t\tif (text) requests.push({ index, entryId: entry.id, text });\n\t});\n\n\tconst latest = requests.at(-1);\n\tif (restore && restore.index > lastStateIndex && restore.index > (latest?.index ?? -1)) return { ...restore.ask };\n\tconst chosen = lastStateIndex === -1 ? requests[0] : latest;\n\treturn chosen ? { entryId: chosen.entryId, text: truncateAskText(chosen.text), capturedAt } : undefined;\n}\n"]}

package/dist/core/extensions/builtin/todotools/todo-format.d.ts

@@ -1,5 +1,33 @@
-import type { TodoItem, TodoPhase } from "./todo-types.ts";
-export declare function formatSummary(phases: readonly TodoPhase[], errors: readonly string[], readOnly?: boolean): string;
+import type { TodoAsk, TodoItem, TodoPhase } from "./todo-types.ts";
+export type AskNowNext = {
+    ask: string;
+    now: string;
+    next: string;
+};
+/**
+ * The three handoff anchors of a todo state: the captured user request, the task in
+ * progress, and the first pending task after it in phase order (it may sit in an earlier
+ * phase after an out-of-order start). Task labels are verbatim.
+ */
+export declare function describeAskNowNext(state: {
+    phases: readonly TodoPhase[];
+    ask?: TodoAsk;
+}): AskNowNext;
+/** The todo transitions at which the user is owed a handoff block (the prompts' `## Handoff` moments). */
+export type HandoffMoment = "list-created" | "phase-closed" | "all-closed";
+/**
+ * Which handoff moment a successful mutation produced, if any: the list was just created, the
+ * last open task of a phase closed, or the last open task of the whole list closed. The result
+ * carries the cue right before the model writes its next text, where a system-prompt rule alone
+ * proved unreliable on weaker models (senpi#2121 real-surface QA).
+ */
+export declare function handoffMomentOf(before: readonly TodoPhase[], after: readonly TodoPhase[], createsList: boolean): HandoffMoment | undefined;
+export declare const HANDOFF_CUES: Readonly<Record<HandoffMoment, string>>;
+/** The cue line appended to a todo result, or nothing when no handoff moment was reached. */
+export declare function formatHandoffCue(moment: HandoffMoment | undefined): string;
+/** `Ask:` / `Now:` / `Next:` lines plus a blank separator line. */
+export declare function formatAskNowNextHeader(phases: readonly TodoPhase[], ask: TodoAsk | undefined): string;
+export declare function formatSummary(phases: readonly TodoPhase[], errors: readonly string[], readOnly?: boolean, ask?: TodoAsk): string;
 export declare function sanitizeTodoText(text: string): string;
 export declare function isTerminalTodoStatus(status: string): boolean;
 export declare function isIncompleteTodo(todo: TodoItem): boolean;

package/dist/core/extensions/builtin/todotools/todo-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"todo-format.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/todo-format.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE3D,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,UAAQ,GAAG,MAAM,CAuD/G;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAExD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,EAAE,CASzE"}
+{"version":3,"file":"todo-format.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/todo-format.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEpE,MAAM,MAAM,UAAU,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,UAAU,CAYrG;AAED,0GAA0G;AAC1G,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY,CAAC;AAE3E;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,WAAW,EAAE,OAAO,GAClB,aAAa,GAAG,SAAS,CAa3B;AAED,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAOhE,CAAC;AAEF,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAE1E;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAGrG;AAED,wBAAgB,aAAa,CAC5B,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,QAAQ,UAAQ,EAChB,GAAG,CAAC,EAAE,OAAO,GACX,MAAM,CAER;AA2DD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAExD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,EAAE,CASzE"}