@code-yeongyu/senpi 2026.7.25 → 2026.7.26

package/dist/core/extensions/builtin/terminal/tools/monitor.d.ts

@@ -0,0 +1,41 @@
+import { type Static, Type } from "typebox";
+import { type TerminalToolContext, type TerminalToolResult } from "./context.ts";
+import { renderMonitorCall } from "./render.ts";
+export declare const DEFAULT_MONITOR_TIMEOUT_MS = 300000;
+export declare const MAX_MONITOR_TIMEOUT_MS = 3600000;
+export declare const monitorSchema: Type.TUnion<[Type.TObject<{
+    action: Type.TOptional<Type.TLiteral<"create">>;
+    description: Type.TString;
+    command: Type.TString;
+    filter: Type.TOptional<Type.TString>;
+    timeout_ms: Type.TOptional<Type.TNumber>;
+    persistent: Type.TOptional<Type.TBoolean>;
+}>, Type.TObject<{
+    action: Type.TLiteral<"rearm">;
+    bash_id: Type.TString;
+}>]>;
+export type MonitorInput = Static<typeof monitorSchema>;
+/** Build the PTY-backed monitor tool. Monitor handles share TerminalManager's bash_N namespace. */
+export declare function createMonitorTool(ctx: TerminalToolContext): {
+    name: string;
+    label: string;
+    description: string;
+    promptSnippet: string;
+    promptGuidelines: string[];
+    parameters: Type.TUnion<[Type.TObject<{
+        action: Type.TOptional<Type.TLiteral<"create">>;
+        description: Type.TString;
+        command: Type.TString;
+        filter: Type.TOptional<Type.TString>;
+        timeout_ms: Type.TOptional<Type.TNumber>;
+        persistent: Type.TOptional<Type.TBoolean>;
+    }>, Type.TObject<{
+        action: Type.TLiteral<"rearm">;
+        bash_id: Type.TString;
+    }>]>;
+    renderCall: typeof renderMonitorCall;
+    execute(_toolCallId: string, input: MonitorInput, _signal?: AbortSignal, _onUpdate?: undefined, execCtx?: {
+        cwd?: string;
+    }): Promise<TerminalToolResult>;
+};
+//# sourceMappingURL=monitor.d.ts.map

package/dist/core/extensions/builtin/terminal/tools/monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/terminal/tools/monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG5C,OAAO,EAAe,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAc,MAAM,cAAc,CAAC;AAC1G,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,eAAO,MAAM,0BAA0B,SAAU,CAAC;AAClD,eAAO,MAAM,sBAAsB,UAAY,CAAC;AA4BhD,eAAO,MAAM,aAAa;;;;;;;;;;IAAwD,CAAC;AACnF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AA2CxD,mGAAmG;AACnG,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;yBAoB1C,MAAM,SACZ,YAAY,YACT,WAAW,cACT,SAAS,YACX;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GACxB,OAAO,CAAC,kBAAkB,CAAC;EAY/B"}

package/dist/core/extensions/builtin/terminal/tools/monitor.js

@@ -0,0 +1,97 @@
+import { Type } from "typebox";
+import { MonitorRegistry } from "../monitor-registry.js";
+import { DEFAULT_COLS, DEFAULT_ROWS, TERMINAL_MONITOR_TOOL } from "../shared.js";
+import { errorResult, textResult } from "./context.js";
+import { renderMonitorCall } from "./render.js";
+import { spawnCommandSession } from "./spawn.js";
+export const DEFAULT_MONITOR_TIMEOUT_MS = 300_000;
+export const MAX_MONITOR_TIMEOUT_MS = 3_600_000;
+const createMonitorSchema = Type.Object({
+    action: Type.Optional(Type.Literal("create")),
+    description: Type.String({
+        minLength: 1,
+        maxLength: 200,
+        description: "Short label for the watcher and its decision-relevant events.",
+    }),
+    command: Type.String({ description: "Shell command to run and watch in a PTY-backed monitor session." }),
+    filter: Type.Optional(Type.String({ description: "Only stdout lines matching this regex become monitor events." })),
+    timeout_ms: Type.Optional(Type.Number({
+        minimum: 1,
+        maximum: MAX_MONITOR_TIMEOUT_MS,
+        description: "Watcher deadline in milliseconds (default 300000; ignored by persistent monitors).",
+    })),
+    persistent: Type.Optional(Type.Boolean({ description: "Keep watching until the command exits or kill_bash stops its bash_id." })),
+});
+const rearmMonitorSchema = Type.Object({
+    action: Type.Literal("rearm"),
+    bash_id: Type.String({ description: "Paused monitor bash_id to resume after a wake-budget pause." }),
+});
+export const monitorSchema = Type.Union([createMonitorSchema, rearmMonitorSchema]);
+function resolveDimension(value, fallback) {
+    if (value === undefined || !Number.isFinite(value) || value < 1)
+        return fallback;
+    return Math.trunc(value);
+}
+function resolveTimeoutMs(value) {
+    const timeout = value ?? DEFAULT_MONITOR_TIMEOUT_MS;
+    return Math.min(Math.max(Math.trunc(timeout), 1), MAX_MONITOR_TIMEOUT_MS);
+}
+function compileFilter(filter) {
+    if (filter === undefined)
+        return undefined;
+    return new RegExp(filter);
+}
+async function createMonitor(ctx, registry, input, execCtx) {
+    let filter;
+    try {
+        filter = compileFilter(input.filter);
+    }
+    catch {
+        return errorResult(`Invalid monitor filter regex: ${input.filter}`);
+    }
+    const { id, runtime } = await spawnCommandSession(ctx, {
+        command: input.command,
+        cols: resolveDimension(undefined, ctx.defaultCols || DEFAULT_COLS),
+        rows: resolveDimension(undefined, ctx.defaultRows || DEFAULT_ROWS),
+        cwd: execCtx?.cwd,
+        ...(input.persistent ? {} : { timeoutMs: resolveTimeoutMs(input.timeout_ms) }),
+    });
+    registry.register({ id, description: input.description, runtime, filter });
+    return textResult(`Monitor started with ID: ${id}`, { details: { bash_id: id, monitor: true } });
+}
+/** Build the PTY-backed monitor tool. Monitor handles share TerminalManager's bash_N namespace. */
+export function createMonitorTool(ctx) {
+    let fallbackRegistry;
+    const getRegistry = () => {
+        const sessionRegistry = ctx.monitorRegistry;
+        if (sessionRegistry)
+            return sessionRegistry;
+        fallbackRegistry ??= new MonitorRegistry((event) => ctx.onMonitorEvent?.(event));
+        return fallbackRegistry;
+    };
+    return {
+        name: TERMINAL_MONITOR_TOOL,
+        label: "monitor",
+        description: "Watch a background shell command and emit decision-relevant stdout-line events. Returns a bash_id immediately; peek with bash_output or stop with kill_bash.",
+        promptSnippet: "Watch a long-running command; monitor emits matching stdout lines as events",
+        promptGuidelines: [
+            "Use monitor only for decision-relevant lines; filter noisy output at the source when possible.",
+        ],
+        parameters: monitorSchema,
+        renderCall: renderMonitorCall,
+        async execute(_toolCallId, input, _signal, _onUpdate, execCtx) {
+            const registry = getRegistry();
+            if (input.action === "rearm") {
+                const outcome = registry.rearm(input.bash_id);
+                if (outcome === "not_found")
+                    return errorResult(`No active monitor found with id: ${input.bash_id}`);
+                if (outcome === "not_paused")
+                    return textResult(`Monitor ${input.bash_id} is not paused; no action taken.`);
+                ctx.onMonitorRearmed?.(input.bash_id);
+                return textResult(`Monitor ${input.bash_id} re-armed.`);
+            }
+            return createMonitor(ctx, registry, input, execCtx);
+        },
+    };
+}
+//# sourceMappingURL=monitor.js.map

package/dist/core/extensions/builtin/terminal/tools/monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/terminal/tools/monitor.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Static, Type } from \"typebox\";\nimport { MonitorRegistry } from \"../monitor-registry.ts\";\nimport { DEFAULT_COLS, DEFAULT_ROWS, TERMINAL_MONITOR_TOOL } from \"../shared.ts\";\nimport { errorResult, type TerminalToolContext, type TerminalToolResult, textResult } from \"./context.ts\";\nimport { renderMonitorCall } from \"./render.ts\";\nimport { spawnCommandSession } from \"./spawn.ts\";\n\nexport const DEFAULT_MONITOR_TIMEOUT_MS = 300_000;\nexport const MAX_MONITOR_TIMEOUT_MS = 3_600_000;\n\nconst createMonitorSchema = Type.Object({\n\taction: Type.Optional(Type.Literal(\"create\")),\n\tdescription: Type.String({\n\t\tminLength: 1,\n\t\tmaxLength: 200,\n\t\tdescription: \"Short label for the watcher and its decision-relevant events.\",\n\t}),\n\tcommand: Type.String({ description: \"Shell command to run and watch in a PTY-backed monitor session.\" }),\n\tfilter: Type.Optional(Type.String({ description: \"Only stdout lines matching this regex become monitor events.\" })),\n\ttimeout_ms: Type.Optional(\n\t\tType.Number({\n\t\t\tminimum: 1,\n\t\t\tmaximum: MAX_MONITOR_TIMEOUT_MS,\n\t\t\tdescription: \"Watcher deadline in milliseconds (default 300000; ignored by persistent monitors).\",\n\t\t}),\n\t),\n\tpersistent: Type.Optional(\n\t\tType.Boolean({ description: \"Keep watching until the command exits or kill_bash stops its bash_id.\" }),\n\t),\n});\n\nconst rearmMonitorSchema = Type.Object({\n\taction: Type.Literal(\"rearm\"),\n\tbash_id: Type.String({ description: \"Paused monitor bash_id to resume after a wake-budget pause.\" }),\n});\n\nexport const monitorSchema = Type.Union([createMonitorSchema, rearmMonitorSchema]);\nexport type MonitorInput = Static<typeof monitorSchema>;\n\ntype MonitorCreateInput = Static<typeof createMonitorSchema>;\n\nfunction resolveDimension(value: number | undefined, fallback: number): number {\n\tif (value === undefined || !Number.isFinite(value) || value < 1) return fallback;\n\treturn Math.trunc(value);\n}\n\nfunction resolveTimeoutMs(value: number | undefined): number {\n\tconst timeout = value ?? DEFAULT_MONITOR_TIMEOUT_MS;\n\treturn Math.min(Math.max(Math.trunc(timeout), 1), MAX_MONITOR_TIMEOUT_MS);\n}\n\nfunction compileFilter(filter: string | undefined): RegExp | undefined {\n\tif (filter === undefined) return undefined;\n\treturn new RegExp(filter);\n}\n\nasync function createMonitor(\n\tctx: TerminalToolContext,\n\tregistry: MonitorRegistry,\n\tinput: MonitorCreateInput,\n\texecCtx: { cwd?: string } | undefined,\n): Promise<TerminalToolResult> {\n\tlet filter: RegExp | undefined;\n\ttry {\n\t\tfilter = compileFilter(input.filter);\n\t} catch {\n\t\treturn errorResult(`Invalid monitor filter regex: ${input.filter}`);\n\t}\n\n\tconst { id, runtime } = await spawnCommandSession(ctx, {\n\t\tcommand: input.command,\n\t\tcols: resolveDimension(undefined, ctx.defaultCols || DEFAULT_COLS),\n\t\trows: resolveDimension(undefined, ctx.defaultRows || DEFAULT_ROWS),\n\t\tcwd: execCtx?.cwd,\n\t\t...(input.persistent ? {} : { timeoutMs: resolveTimeoutMs(input.timeout_ms) }),\n\t});\n\tregistry.register({ id, description: input.description, runtime, filter });\n\treturn textResult(`Monitor started with ID: ${id}`, { details: { bash_id: id, monitor: true } });\n}\n\n/** Build the PTY-backed monitor tool. Monitor handles share TerminalManager's bash_N namespace. */\nexport function createMonitorTool(ctx: TerminalToolContext) {\n\tlet fallbackRegistry: MonitorRegistry | undefined;\n\tconst getRegistry = (): MonitorRegistry => {\n\t\tconst sessionRegistry = ctx.monitorRegistry;\n\t\tif (sessionRegistry) return sessionRegistry;\n\t\tfallbackRegistry ??= new MonitorRegistry((event) => ctx.onMonitorEvent?.(event));\n\t\treturn fallbackRegistry;\n\t};\n\treturn {\n\t\tname: TERMINAL_MONITOR_TOOL,\n\t\tlabel: \"monitor\",\n\t\tdescription:\n\t\t\t\"Watch a background shell command and emit decision-relevant stdout-line events. Returns a bash_id immediately; peek with bash_output or stop with kill_bash.\",\n\t\tpromptSnippet: \"Watch a long-running command; monitor emits matching stdout lines as events\",\n\t\tpromptGuidelines: [\n\t\t\t\"Use monitor only for decision-relevant lines; filter noisy output at the source when possible.\",\n\t\t],\n\t\tparameters: monitorSchema,\n\t\trenderCall: renderMonitorCall,\n\t\tasync execute(\n\t\t\t_toolCallId: string,\n\t\t\tinput: MonitorInput,\n\t\t\t_signal?: AbortSignal,\n\t\t\t_onUpdate?: undefined,\n\t\t\texecCtx?: { cwd?: string },\n\t\t): Promise<TerminalToolResult> {\n\t\t\tconst registry = getRegistry();\n\t\t\tif (input.action === \"rearm\") {\n\t\t\t\tconst outcome = registry.rearm(input.bash_id);\n\t\t\t\tif (outcome === \"not_found\") return errorResult(`No active monitor found with id: ${input.bash_id}`);\n\t\t\t\tif (outcome === \"not_paused\") return textResult(`Monitor ${input.bash_id} is not paused; no action taken.`);\n\t\t\t\tctx.onMonitorRearmed?.(input.bash_id);\n\t\t\t\treturn textResult(`Monitor ${input.bash_id} re-armed.`);\n\t\t\t}\n\t\t\treturn createMonitor(ctx, registry, input, execCtx);\n\t\t},\n\t};\n}\n"]}

package/dist/core/extensions/builtin/terminal/tools/render.d.ts

@@ -1,8 +1,10 @@
 import { Text } from "@earendil-works/pi-tui";
 import type { AgentToolResult, ToolDefinition } from "../../../types.ts";
 import type { BashOutputInput, bashOutputSchema } from "./bash-output.ts";
+import type { MonitorInput, monitorSchema } from "./monitor.ts";
 type BashOutputDetails = Record<string, unknown> | undefined;
 type BashOutputToolDefinition = ToolDefinition<typeof bashOutputSchema, BashOutputDetails>;
+type MonitorToolDefinition = ToolDefinition<typeof monitorSchema, BashOutputDetails>;
 type RenderResultOptions = Parameters<NonNullable<BashOutputToolDefinition["renderResult"]>>[1];
 declare class BashOutputResultComponent {
     #private;
@@ -11,6 +13,7 @@ declare class BashOutputResultComponent {
     invalidate(): void;
 }
 export declare function renderBashOutputCall(args: BashOutputInput, theme: Parameters<NonNullable<BashOutputToolDefinition["renderCall"]>>[1]): Text;
+export declare function renderMonitorCall(args: MonitorInput, theme: Parameters<NonNullable<MonitorToolDefinition["renderCall"]>>[1]): Text;
 export declare function renderBashOutputResult(result: AgentToolResult<BashOutputDetails>, options: RenderResultOptions, _theme: Parameters<NonNullable<BashOutputToolDefinition["renderResult"]>>[2], context: Parameters<NonNullable<BashOutputToolDefinition["renderResult"]>>[3]): BashOutputResultComponent;
 export {};
 //# sourceMappingURL=render.d.ts.map

package/dist/core/extensions/builtin/terminal/tools/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/terminal/tools/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE1E,KAAK,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;AAC7D,KAAK,wBAAwB,GAAG,cAAc,CAAC,OAAO,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;AAC3F,KAAK,mBAAmB,GAAG,UAAU,CAAC,WAAW,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAIhG,cAAM,yBAAyB;;IAK9B,SAAS,CAAC,MAAM,EAAE,eAAe,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAKxF;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAK9B;IAED,UAAU,IAAI,IAAI,CAAG;CACrB;AAED,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,wBAAwB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACvE,IAAI,CAGN;AAED,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,eAAe,CAAC,iBAAiB,CAAC,EAC1C,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAC5E,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC3E,yBAAyB,CAK3B"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/terminal/tools/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEhE,KAAK,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;AAC7D,KAAK,wBAAwB,GAAG,cAAc,CAAC,OAAO,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;AAC3F,KAAK,qBAAqB,GAAG,cAAc,CAAC,OAAO,aAAa,EAAE,iBAAiB,CAAC,CAAC;AACrF,KAAK,mBAAmB,GAAG,UAAU,CAAC,WAAW,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAIhG,cAAM,yBAAyB;;IAK9B,SAAS,CAAC,MAAM,EAAE,eAAe,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAKxF;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAK9B;IAED,UAAU,IAAI,IAAI,CAAG;CACrB;AAED,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,wBAAwB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACvE,IAAI,CAEN;AAED,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACpE,IAAI,CAGN;AAED,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,eAAe,CAAC,iBAAiB,CAAC,EAC1C,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAC5E,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC3E,yBAAyB,CAK3B"}

package/dist/core/extensions/builtin/terminal/tools/render.js

@@ -19,8 +19,11 @@ class BashOutputResultComponent {
     invalidate() { }
 }
 export function renderBashOutputCall(args, theme) {
-    const waitFor = args.wait_for ? ` wait_for:/${args.wait_for}/` : "";
-    return new Text(theme.fg("toolTitle", theme.bold(`bash_output ${args.bash_id}${waitFor}`)), 0, 0);
+    return new Text(theme.fg("toolTitle", theme.bold(`bash_output ${args.bash_id}`)), 0, 0);
+}
+export function renderMonitorCall(args, theme) {
+    const label = args.action === "rearm" ? `monitor rearm ${args.bash_id}` : `monitor ${args.description}`;
+    return new Text(theme.fg("toolTitle", theme.bold(label)), 0, 0);
 }
 export function renderBashOutputResult(result, options, _theme, context) {
     const component = context.lastComponent ?? new BashOutputResultComponent();

package/dist/core/extensions/builtin/terminal/tools/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/terminal/tools/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gEAAgE,CAAC;AAQvG,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B,MAAM,yBAAyB;IAC9B,KAAK,GAAG,EAAE,CAAC;IACX,UAAU,GAAG,KAAK,CAAC;IACnB,SAAS,GAAG,KAAK,CAAC;IAElB,SAAS,CAAC,MAA0C,EAAE,OAA4B;QACjF,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QACxE,IAAI,CAAC,KAAK,GAAG,KAAK,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,KAAa;QACnB,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,qBAAqB,CAAC,IAAI,CAAC,KAAK,EAAE,oBAAoB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3G,IAAI,CAAC,OAAO,EAAE,CACd,CAAC;IACH,CAAC;IAED,UAAU,KAAU,CAAC;CACrB;AAED,MAAM,UAAU,oBAAoB,CACnC,IAAqB,EACrB,KAAyE;IAEzE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,UAAU,sBAAsB,CACrC,MAA0C,EAC1C,OAA4B,EAC5B,MAA4E,EAC5E,OAA6E;IAE7E,MAAM,SAAS,GACb,OAAO,CAAC,aAAuD,IAAI,IAAI,yBAAyB,EAAE,CAAC;IACrG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,SAAS,CAAC;AAClB,CAAC","sourcesContent":["import { Text } from \"@earendil-works/pi-tui\";\nimport { truncateToVisualLines } from \"../../../../../modes/interactive/components/visual-truncate.ts\";\nimport type { AgentToolResult, ToolDefinition } from \"../../../types.ts\";\nimport type { BashOutputInput, bashOutputSchema } from \"./bash-output.ts\";\n\ntype BashOutputDetails = Record<string, unknown> | undefined;\ntype BashOutputToolDefinition = ToolDefinition<typeof bashOutputSchema, BashOutputDetails>;\ntype RenderResultOptions = Parameters<NonNullable<BashOutputToolDefinition[\"renderResult\"]>>[1];\n\nconst OUTPUT_PREVIEW_LINES = 8;\n\nclass BashOutputResultComponent {\n\t#text = \"\";\n\t#isPartial = false;\n\t#expanded = false;\n\n\tsetResult(result: AgentToolResult<BashOutputDetails>, options: RenderResultOptions): void {\n\t\tconst block = result.content.find((content) => content.type === \"text\");\n\t\tthis.#text = block?.type === \"text\" ? block.text : \"\";\n\t\tthis.#isPartial = options.isPartial;\n\t\tthis.#expanded = options.expanded;\n\t}\n\n\trender(width: number): string[] {\n\t\tif (!this.#isPartial || this.#expanded) return this.#text.split(\"\\n\");\n\t\treturn truncateToVisualLines(this.#text, OUTPUT_PREVIEW_LINES, Math.max(1, width)).visualLines.map((line) =>\n\t\t\tline.trimEnd(),\n\t\t);\n\t}\n\n\tinvalidate(): void {}\n}\n\nexport function renderBashOutputCall(\n\targs: BashOutputInput,\n\ttheme: Parameters<NonNullable<BashOutputToolDefinition[\"renderCall\"]>>[1],\n): Text {\n\tconst waitFor = args.wait_for ? ` wait_for:/${args.wait_for}/` : \"\";\n\treturn new Text(theme.fg(\"toolTitle\", theme.bold(`bash_output ${args.bash_id}${waitFor}`)), 0, 0);\n}\n\nexport function renderBashOutputResult(\n\tresult: AgentToolResult<BashOutputDetails>,\n\toptions: RenderResultOptions,\n\t_theme: Parameters<NonNullable<BashOutputToolDefinition[\"renderResult\"]>>[2],\n\tcontext: Parameters<NonNullable<BashOutputToolDefinition[\"renderResult\"]>>[3],\n): BashOutputResultComponent {\n\tconst component =\n\t\t(context.lastComponent as BashOutputResultComponent | undefined) ?? new BashOutputResultComponent();\n\tcomponent.setResult(result, options);\n\treturn component;\n}\n"]}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/terminal/tools/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gEAAgE,CAAC;AAUvG,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B,MAAM,yBAAyB;IAC9B,KAAK,GAAG,EAAE,CAAC;IACX,UAAU,GAAG,KAAK,CAAC;IACnB,SAAS,GAAG,KAAK,CAAC;IAElB,SAAS,CAAC,MAA0C,EAAE,OAA4B;QACjF,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QACxE,IAAI,CAAC,KAAK,GAAG,KAAK,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,KAAa;QACnB,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,qBAAqB,CAAC,IAAI,CAAC,KAAK,EAAE,oBAAoB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3G,IAAI,CAAC,OAAO,EAAE,CACd,CAAC;IACH,CAAC;IAED,UAAU,KAAU,CAAC;CACrB;AAED,MAAM,UAAU,oBAAoB,CACnC,IAAqB,EACrB,KAAyE;IAEzE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAChC,IAAkB,EAClB,KAAsE;IAEtE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,WAAW,EAAE,CAAC;IACxG,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACrC,MAA0C,EAC1C,OAA4B,EAC5B,MAA4E,EAC5E,OAA6E;IAE7E,MAAM,SAAS,GACb,OAAO,CAAC,aAAuD,IAAI,IAAI,yBAAyB,EAAE,CAAC;IACrG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,SAAS,CAAC;AAClB,CAAC","sourcesContent":["import { Text } from \"@earendil-works/pi-tui\";\nimport { truncateToVisualLines } from \"../../../../../modes/interactive/components/visual-truncate.ts\";\nimport type { AgentToolResult, ToolDefinition } from \"../../../types.ts\";\nimport type { BashOutputInput, bashOutputSchema } from \"./bash-output.ts\";\nimport type { MonitorInput, monitorSchema } from \"./monitor.ts\";\n\ntype BashOutputDetails = Record<string, unknown> | undefined;\ntype BashOutputToolDefinition = ToolDefinition<typeof bashOutputSchema, BashOutputDetails>;\ntype MonitorToolDefinition = ToolDefinition<typeof monitorSchema, BashOutputDetails>;\ntype RenderResultOptions = Parameters<NonNullable<BashOutputToolDefinition[\"renderResult\"]>>[1];\n\nconst OUTPUT_PREVIEW_LINES = 8;\n\nclass BashOutputResultComponent {\n\t#text = \"\";\n\t#isPartial = false;\n\t#expanded = false;\n\n\tsetResult(result: AgentToolResult<BashOutputDetails>, options: RenderResultOptions): void {\n\t\tconst block = result.content.find((content) => content.type === \"text\");\n\t\tthis.#text = block?.type === \"text\" ? block.text : \"\";\n\t\tthis.#isPartial = options.isPartial;\n\t\tthis.#expanded = options.expanded;\n\t}\n\n\trender(width: number): string[] {\n\t\tif (!this.#isPartial || this.#expanded) return this.#text.split(\"\\n\");\n\t\treturn truncateToVisualLines(this.#text, OUTPUT_PREVIEW_LINES, Math.max(1, width)).visualLines.map((line) =>\n\t\t\tline.trimEnd(),\n\t\t);\n\t}\n\n\tinvalidate(): void {}\n}\n\nexport function renderBashOutputCall(\n\targs: BashOutputInput,\n\ttheme: Parameters<NonNullable<BashOutputToolDefinition[\"renderCall\"]>>[1],\n): Text {\n\treturn new Text(theme.fg(\"toolTitle\", theme.bold(`bash_output ${args.bash_id}`)), 0, 0);\n}\n\nexport function renderMonitorCall(\n\targs: MonitorInput,\n\ttheme: Parameters<NonNullable<MonitorToolDefinition[\"renderCall\"]>>[1],\n): Text {\n\tconst label = args.action === \"rearm\" ? `monitor rearm ${args.bash_id}` : `monitor ${args.description}`;\n\treturn new Text(theme.fg(\"toolTitle\", theme.bold(label)), 0, 0);\n}\n\nexport function renderBashOutputResult(\n\tresult: AgentToolResult<BashOutputDetails>,\n\toptions: RenderResultOptions,\n\t_theme: Parameters<NonNullable<BashOutputToolDefinition[\"renderResult\"]>>[2],\n\tcontext: Parameters<NonNullable<BashOutputToolDefinition[\"renderResult\"]>>[3],\n): BashOutputResultComponent {\n\tconst component =\n\t\t(context.lastComponent as BashOutputResultComponent | undefined) ?? new BashOutputResultComponent();\n\tcomponent.setResult(result, options);\n\treturn component;\n}\n"]}

package/dist/core/extensions/builtin/todotools/fuzzy-match.d.ts

@@ -0,0 +1,19 @@
+import { type TodoItem, type TodoPhase } from "./state.ts";
+type TaskHit = {
+    task: TodoItem;
+    phase: TodoPhase;
+};
+export type FuzzyTaskResolution = {
+    hit?: TaskHit;
+    corrected: boolean;
+    suggestion?: string;
+};
+export type FuzzyPhaseResolution = {
+    hit?: TodoPhase;
+    corrected: boolean;
+    suggestion?: string;
+};
+export declare function fuzzyResolveTask(phases: readonly TodoPhase[], query: string): FuzzyTaskResolution;
+export declare function fuzzyResolvePhase(phases: readonly TodoPhase[], name: string): FuzzyPhaseResolution;
+export {};
+//# sourceMappingURL=fuzzy-match.d.ts.map

package/dist/core/extensions/builtin/todotools/fuzzy-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy-match.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/fuzzy-match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE7E,KAAK,OAAO,GAAG;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAClC,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAmDF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAWjG;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAUlG"}

package/dist/core/extensions/builtin/todotools/fuzzy-match.js

@@ -0,0 +1,70 @@
+import { sanitizeTodoText } from "./state.js";
+function normalized(text) {
+    return sanitizeTodoText(text).toLowerCase();
+}
+function diceCoefficient(left, right) {
+    if (left === right)
+        return 1;
+    if (left.length < 2 || right.length < 2)
+        return 0;
+    const pairs = new Map();
+    for (let index = 0; index < left.length - 1; index += 1) {
+        const pair = left.slice(index, index + 2);
+        pairs.set(pair, (pairs.get(pair) ?? 0) + 1);
+    }
+    let overlap = 0;
+    for (let index = 0; index < right.length - 1; index += 1) {
+        const pair = right.slice(index, index + 2);
+        const count = pairs.get(pair) ?? 0;
+        if (count > 0) {
+            overlap += 1;
+            pairs.set(pair, count - 1);
+        }
+    }
+    return (2 * overlap) / (left.length + right.length - 2);
+}
+function suggestionFor(candidates, query, contentOf) {
+    const normalizedQuery = normalized(query);
+    if (!normalizedQuery)
+        return undefined;
+    let suggestion;
+    let bestScore = 0;
+    for (const candidate of candidates) {
+        const content = contentOf(candidate);
+        const normalizedContent = normalized(content);
+        if (!normalizedContent)
+            continue;
+        const score = normalizedContent.includes(normalizedQuery) || normalizedQuery.includes(normalizedContent)
+            ? 1
+            : diceCoefficient(normalizedContent, normalizedQuery);
+        if (score >= 0.5 && score > bestScore) {
+            bestScore = score;
+            suggestion = content;
+        }
+    }
+    return suggestion;
+}
+export function fuzzyResolveTask(phases, query) {
+    const candidates = phases.flatMap((phase) => phase.tasks.map((task) => ({ task, phase })));
+    const exactMatches = candidates.filter(({ task }) => task.content === query);
+    if (exactMatches.length === 1)
+        return { hit: exactMatches[0], corrected: false };
+    const normalizedQuery = normalized(query);
+    const normalizedMatches = candidates.filter(({ task }) => normalized(task.content) === normalizedQuery);
+    if (normalizedMatches.length === 1)
+        return { hit: normalizedMatches[0], corrected: true };
+    const suggestion = suggestionFor(candidates, query, ({ task }) => task.content);
+    return suggestion ? { corrected: false, suggestion } : { corrected: false };
+}
+export function fuzzyResolvePhase(phases, name) {
+    const exactMatches = phases.filter((phase) => phase.name === name);
+    if (exactMatches.length === 1)
+        return { hit: exactMatches[0], corrected: false };
+    const normalizedName = normalized(name);
+    const normalizedMatches = phases.filter((phase) => normalized(phase.name) === normalizedName);
+    if (normalizedMatches.length === 1)
+        return { hit: normalizedMatches[0], corrected: true };
+    const suggestion = suggestionFor(phases, name, (phase) => phase.name);
+    return suggestion ? { corrected: false, suggestion } : { corrected: false };
+}
+//# sourceMappingURL=fuzzy-match.js.map

package/dist/core/extensions/builtin/todotools/fuzzy-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy-match.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/fuzzy-match.ts"],"names":[],"mappings":"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","sourcesContent":["import { sanitizeTodoText, type TodoItem, type TodoPhase } from \"./state.ts\";\n\ntype TaskHit = {\n\ttask: TodoItem;\n\tphase: TodoPhase;\n};\n\nexport type FuzzyTaskResolution = {\n\thit?: TaskHit;\n\tcorrected: boolean;\n\tsuggestion?: string;\n};\n\nexport type FuzzyPhaseResolution = {\n\thit?: TodoPhase;\n\tcorrected: boolean;\n\tsuggestion?: string;\n};\n\nfunction normalized(text: string): string {\n\treturn sanitizeTodoText(text).toLowerCase();\n}\n\nfunction diceCoefficient(left: string, right: string): number {\n\tif (left === right) return 1;\n\tif (left.length < 2 || right.length < 2) return 0;\n\tconst pairs = new Map<string, number>();\n\tfor (let index = 0; index < left.length - 1; index += 1) {\n\t\tconst pair = left.slice(index, index + 2);\n\t\tpairs.set(pair, (pairs.get(pair) ?? 0) + 1);\n\t}\n\tlet overlap = 0;\n\tfor (let index = 0; index < right.length - 1; index += 1) {\n\t\tconst pair = right.slice(index, index + 2);\n\t\tconst count = pairs.get(pair) ?? 0;\n\t\tif (count > 0) {\n\t\t\toverlap += 1;\n\t\t\tpairs.set(pair, count - 1);\n\t\t}\n\t}\n\treturn (2 * overlap) / (left.length + right.length - 2);\n}\n\nfunction suggestionFor<T>(\n\tcandidates: readonly T[],\n\tquery: string,\n\tcontentOf: (candidate: T) => string,\n): string | undefined {\n\tconst normalizedQuery = normalized(query);\n\tif (!normalizedQuery) return undefined;\n\tlet suggestion: string | undefined;\n\tlet bestScore = 0;\n\tfor (const candidate of candidates) {\n\t\tconst content = contentOf(candidate);\n\t\tconst normalizedContent = normalized(content);\n\t\tif (!normalizedContent) continue;\n\t\tconst score =\n\t\t\tnormalizedContent.includes(normalizedQuery) || normalizedQuery.includes(normalizedContent)\n\t\t\t\t? 1\n\t\t\t\t: diceCoefficient(normalizedContent, normalizedQuery);\n\t\tif (score >= 0.5 && score > bestScore) {\n\t\t\tbestScore = score;\n\t\t\tsuggestion = content;\n\t\t}\n\t}\n\treturn suggestion;\n}\n\nexport function fuzzyResolveTask(phases: readonly TodoPhase[], query: string): FuzzyTaskResolution {\n\tconst candidates = phases.flatMap((phase) => phase.tasks.map((task) => ({ task, phase })));\n\tconst exactMatches = candidates.filter(({ task }) => task.content === query);\n\tif (exactMatches.length === 1) return { hit: exactMatches[0], corrected: false };\n\n\tconst normalizedQuery = normalized(query);\n\tconst normalizedMatches = candidates.filter(({ task }) => normalized(task.content) === normalizedQuery);\n\tif (normalizedMatches.length === 1) return { hit: normalizedMatches[0], corrected: true };\n\n\tconst suggestion = suggestionFor(candidates, query, ({ task }) => task.content);\n\treturn suggestion ? { corrected: false, suggestion } : { corrected: false };\n}\n\nexport function fuzzyResolvePhase(phases: readonly TodoPhase[], name: string): FuzzyPhaseResolution {\n\tconst exactMatches = phases.filter((phase) => phase.name === name);\n\tif (exactMatches.length === 1) return { hit: exactMatches[0], corrected: false };\n\n\tconst normalizedName = normalized(name);\n\tconst normalizedMatches = phases.filter((phase) => normalized(phase.name) === normalizedName);\n\tif (normalizedMatches.length === 1) return { hit: normalizedMatches[0], corrected: true };\n\n\tconst suggestion = suggestionFor(phases, name, (phase) => phase.name);\n\treturn suggestion ? { corrected: false, suggestion } : { corrected: false };\n}\n"]}

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

@@ -0,0 +1,8 @@
+import type { TodoOpEntry, TodoPhase } from "./state.ts";
+export type TodoNormalization = {
+    entry?: TodoOpEntry;
+    corrections: string[];
+    error?: string;
+};
+export declare function normalizeTodoParams(raw: Record<string, unknown>, currentPhases: readonly TodoPhase[]): TodoNormalization;
+//# sourceMappingURL=normalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAiB,SAAS,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,MAAM,iBAAiB,GAAG;IAC/B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AA6EF,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,aAAa,EAAE,SAAS,SAAS,EAAE,GACjC,iBAAiB,CAsGnB"}

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

@@ -0,0 +1,174 @@
+const CONFLICTING_SHAPES = 'conflicting shapes. Use {"op":"init","list":[...]} to replace the list or {"op":"append","phase":"<active phase>","items":[...]} to add tasks.';
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function isOperation(value) {
+    switch (value) {
+        case "init":
+        case "start":
+        case "done":
+        case "rm":
+        case "drop":
+        case "append":
+        case "view":
+            return true;
+        default:
+            return false;
+    }
+}
+function strings(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const parsed = [];
+    for (const item of value) {
+        if (typeof item !== "string")
+            return undefined;
+        parsed.push(item);
+    }
+    return parsed;
+}
+function list(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const parsed = [];
+    for (const item of value) {
+        if (!isRecord(item) || typeof item.phase !== "string")
+            return undefined;
+        const items = strings(item.items);
+        if (!items)
+            return undefined;
+        parsed.push({ phase: item.phase, items });
+    }
+    return parsed;
+}
+function nonBlank(value) {
+    return typeof value === "string" && value.trim() !== "" ? value : undefined;
+}
+function isBlank(value) {
+    return typeof value === "string" && value.trim() === "";
+}
+function error(message) {
+    return { corrections: [], error: message };
+}
+function aliasCorrection(alias, inferred) {
+    const form = alias === "init" ? '{"op":"init","items":[...]}' : '{"op":"append","phase":"<active phase>","items":[...]}';
+    if (inferred) {
+        return `[auto-corrected] "op" was missing; interpreted as "${alias}" because "${alias}" was provided as an items alias. Always pass op explicitly: ${form}`;
+    }
+    return `[auto-corrected] "${alias}" was used as an items alias and folded into "items". Use: ${form}`;
+}
+function inferredCorrection(op, reason, form) {
+    return `[auto-corrected] "op" was missing; interpreted as "${op}" because ${reason}. Always pass op explicitly: ${form}`;
+}
+function hasTasks(phases) {
+    return phases.some((phase) => phase.tasks.length > 0);
+}
+export function normalizeTodoParams(raw, currentPhases) {
+    const rawOp = raw.op;
+    if (rawOp === "view")
+        return { entry: { op: "view" }, corrections: [] };
+    if (rawOp !== undefined && !isOperation(rawOp))
+        return error('Invalid "op".');
+    const op = isOperation(rawOp) ? rawOp : undefined;
+    const task = nonBlank(raw.task);
+    const phase = nonBlank(raw.phase);
+    if (op === "start" || op === "done" || op === "drop" || op === "rm") {
+        if (isBlank(raw.task) && !phase) {
+            return error('Blank "task" — pass the exact task text, or omit the field entirely for a bulk operation.');
+        }
+        if (isBlank(raw.phase) && !task) {
+            return error('Blank "phase" — pass the exact phase text, or omit the field entirely for a bulk operation.');
+        }
+    }
+    const rawItems = strings(raw.items);
+    const aliases = [];
+    for (const name of ["init", "append"]) {
+        const items = strings(raw[name]);
+        if (items && items.length > 0)
+            aliases.push({ name, items });
+    }
+    if (aliases.length > 1)
+        return error(CONFLICTING_SHAPES);
+    if (aliases.length === 1 && rawItems && rawItems.length > 0)
+        return error(CONFLICTING_SHAPES);
+    const alias = aliases[0];
+    let effectiveItems = rawItems && rawItems.length > 0 ? rawItems : undefined;
+    let candidate;
+    const corrections = [];
+    if (alias) {
+        if (op && op !== alias.name)
+            return error(CONFLICTING_SHAPES);
+        effectiveItems = alias.items;
+        candidate = op ? undefined : alias.name;
+        corrections.push(aliasCorrection(alias.name, !op));
+    }
+    const effectiveList = list(raw.list);
+    const hasList = Boolean(effectiveList && effectiveList.length > 0);
+    const hasItems = Boolean(effectiveItems && effectiveItems.length > 0);
+    if (hasList && hasItems)
+        return error(CONFLICTING_SHAPES);
+    let effectiveOp = op;
+    if (!effectiveOp) {
+        if (candidate) {
+            effectiveOp = candidate;
+        }
+        else if (hasList) {
+            effectiveOp = "init";
+            corrections.push(inferredCorrection("init", '"list" was provided', '{"op":"init","list":[...]}'));
+        }
+        else if (hasItems && phase) {
+            effectiveOp = "append";
+            corrections.push(inferredCorrection("append", '"items" and "phase" were provided', '{"op":"append","phase":"<active phase>","items":[...]}'));
+        }
+        else if (hasItems && !hasTasks(currentPhases)) {
+            effectiveOp = "init";
+            corrections.push(inferredCorrection("init", '"items" was provided to an empty todo list', '{"op":"init","items":[...]}'));
+        }
+        else if (hasItems) {
+            return error('Missing "op": use {"op":"init","list":[...]} to replace the list, or {"op":"append","phase":"<active phase>","items":[...]} to add tasks.');
+        }
+        else {
+            return error('Missing "op". Example: {"op":"init","list":[{"phase":"Setup","items":["..."]}]}');
+        }
+    }
+    switch (effectiveOp) {
+        case "init": {
+            if (task || (effectiveList && effectiveList.length === 0 && hasItems))
+                return error(CONFLICTING_SHAPES);
+            const entry = { op: "init" };
+            if (effectiveList)
+                entry.list = effectiveList;
+            if (effectiveItems)
+                entry.items = effectiveItems;
+            if (phase)
+                entry.phase = phase;
+            return { entry, corrections };
+        }
+        case "start":
+            if (phase || hasList || hasItems)
+                return error(CONFLICTING_SHAPES);
+            return { entry: task ? { op: "start", task } : { op: "start" }, corrections };
+        case "done":
+        case "drop":
+        case "rm": {
+            if (hasList || hasItems)
+                return error(CONFLICTING_SHAPES);
+            const entry = { op: effectiveOp };
+            if (task)
+                entry.task = task;
+            if (phase)
+                entry.phase = phase;
+            return { entry, corrections };
+        }
+        case "append":
+            if (task || hasList)
+                return error(CONFLICTING_SHAPES);
+            return {
+                entry: { op: "append", ...(phase ? { phase } : {}), ...(effectiveItems ? { items: effectiveItems } : {}) },
+                corrections,
+            };
+        case "view":
+            return { entry: { op: "view" }, corrections: [] };
+    }
+}
+//# sourceMappingURL=normalize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/normalize.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TodoOpEntry, TodoOperation, TodoPhase } from \"./state.ts\";\n\nexport type TodoNormalization = {\n\tentry?: TodoOpEntry;\n\tcorrections: string[];\n\terror?: string;\n};\n\ntype Alias = \"init\" | \"append\";\n\nconst CONFLICTING_SHAPES =\n\t'conflicting shapes. Use {\"op\":\"init\",\"list\":[...]} to replace the list or {\"op\":\"append\",\"phase\":\"<active phase>\",\"items\":[...]} to add tasks.';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nfunction isOperation(value: unknown): value is TodoOperation {\n\tswitch (value) {\n\t\tcase \"init\":\n\t\tcase \"start\":\n\t\tcase \"done\":\n\t\tcase \"rm\":\n\t\tcase \"drop\":\n\t\tcase \"append\":\n\t\tcase \"view\":\n\t\t\treturn true;\n\t\tdefault:\n\t\t\treturn false;\n\t}\n}\n\nfunction strings(value: unknown): string[] | undefined {\n\tif (!Array.isArray(value)) return undefined;\n\tconst parsed: string[] = [];\n\tfor (const item of value) {\n\t\tif (typeof item !== \"string\") return undefined;\n\t\tparsed.push(item);\n\t}\n\treturn parsed;\n}\n\nfunction list(value: unknown): TodoOpEntry[\"list\"] | undefined {\n\tif (!Array.isArray(value)) return undefined;\n\tconst parsed: NonNullable<TodoOpEntry[\"list\"]> = [];\n\tfor (const item of value) {\n\t\tif (!isRecord(item) || typeof item.phase !== \"string\") return undefined;\n\t\tconst items = strings(item.items);\n\t\tif (!items) return undefined;\n\t\tparsed.push({ phase: item.phase, items });\n\t}\n\treturn parsed;\n}\n\nfunction nonBlank(value: unknown): string | undefined {\n\treturn typeof value === \"string\" && value.trim() !== \"\" ? value : undefined;\n}\n\nfunction isBlank(value: unknown): boolean {\n\treturn typeof value === \"string\" && value.trim() === \"\";\n}\n\nfunction error(message: string): TodoNormalization {\n\treturn { corrections: [], error: message };\n}\n\nfunction aliasCorrection(alias: Alias, inferred: boolean): string {\n\tconst form =\n\t\talias === \"init\" ? '{\"op\":\"init\",\"items\":[...]}' : '{\"op\":\"append\",\"phase\":\"<active phase>\",\"items\":[...]}';\n\tif (inferred) {\n\t\treturn `[auto-corrected] \"op\" was missing; interpreted as \"${alias}\" because \"${alias}\" was provided as an items alias. Always pass op explicitly: ${form}`;\n\t}\n\treturn `[auto-corrected] \"${alias}\" was used as an items alias and folded into \"items\". Use: ${form}`;\n}\n\nfunction inferredCorrection(op: \"init\" | \"append\", reason: string, form: string): string {\n\treturn `[auto-corrected] \"op\" was missing; interpreted as \"${op}\" because ${reason}. Always pass op explicitly: ${form}`;\n}\n\nfunction hasTasks(phases: readonly TodoPhase[]): boolean {\n\treturn phases.some((phase) => phase.tasks.length > 0);\n}\n\nexport function normalizeTodoParams(\n\traw: Record<string, unknown>,\n\tcurrentPhases: readonly TodoPhase[],\n): TodoNormalization {\n\tconst rawOp = raw.op;\n\tif (rawOp === \"view\") return { entry: { op: \"view\" }, corrections: [] };\n\tif (rawOp !== undefined && !isOperation(rawOp)) return error('Invalid \"op\".');\n\n\tconst op = isOperation(rawOp) ? rawOp : undefined;\n\tconst task = nonBlank(raw.task);\n\tconst phase = nonBlank(raw.phase);\n\tif (op === \"start\" || op === \"done\" || op === \"drop\" || op === \"rm\") {\n\t\tif (isBlank(raw.task) && !phase) {\n\t\t\treturn error('Blank \"task\" — pass the exact task text, or omit the field entirely for a bulk operation.');\n\t\t}\n\t\tif (isBlank(raw.phase) && !task) {\n\t\t\treturn error('Blank \"phase\" — pass the exact phase text, or omit the field entirely for a bulk operation.');\n\t\t}\n\t}\n\n\tconst rawItems = strings(raw.items);\n\tconst aliases: Array<{ name: Alias; items: string[] }> = [];\n\tfor (const name of [\"init\", \"append\"] as const) {\n\t\tconst items = strings(raw[name]);\n\t\tif (items && items.length > 0) aliases.push({ name, items });\n\t}\n\tif (aliases.length > 1) return error(CONFLICTING_SHAPES);\n\tif (aliases.length === 1 && rawItems && rawItems.length > 0) return error(CONFLICTING_SHAPES);\n\n\tconst alias = aliases[0];\n\tlet effectiveItems = rawItems && rawItems.length > 0 ? rawItems : undefined;\n\tlet candidate: Alias | undefined;\n\tconst corrections: string[] = [];\n\tif (alias) {\n\t\tif (op && op !== alias.name) return error(CONFLICTING_SHAPES);\n\t\teffectiveItems = alias.items;\n\t\tcandidate = op ? undefined : alias.name;\n\t\tcorrections.push(aliasCorrection(alias.name, !op));\n\t}\n\n\tconst effectiveList = list(raw.list);\n\tconst hasList = Boolean(effectiveList && effectiveList.length > 0);\n\tconst hasItems = Boolean(effectiveItems && effectiveItems.length > 0);\n\tif (hasList && hasItems) return error(CONFLICTING_SHAPES);\n\n\tlet effectiveOp = op;\n\tif (!effectiveOp) {\n\t\tif (candidate) {\n\t\t\teffectiveOp = candidate;\n\t\t} else if (hasList) {\n\t\t\teffectiveOp = \"init\";\n\t\t\tcorrections.push(inferredCorrection(\"init\", '\"list\" was provided', '{\"op\":\"init\",\"list\":[...]}'));\n\t\t} else if (hasItems && phase) {\n\t\t\teffectiveOp = \"append\";\n\t\t\tcorrections.push(\n\t\t\t\tinferredCorrection(\n\t\t\t\t\t\"append\",\n\t\t\t\t\t'\"items\" and \"phase\" were provided',\n\t\t\t\t\t'{\"op\":\"append\",\"phase\":\"<active phase>\",\"items\":[...]}',\n\t\t\t\t),\n\t\t\t);\n\t\t} else if (hasItems && !hasTasks(currentPhases)) {\n\t\t\teffectiveOp = \"init\";\n\t\t\tcorrections.push(\n\t\t\t\tinferredCorrection(\"init\", '\"items\" was provided to an empty todo list', '{\"op\":\"init\",\"items\":[...]}'),\n\t\t\t);\n\t\t} else if (hasItems) {\n\t\t\treturn error(\n\t\t\t\t'Missing \"op\": use {\"op\":\"init\",\"list\":[...]} to replace the list, or {\"op\":\"append\",\"phase\":\"<active phase>\",\"items\":[...]} to add tasks.',\n\t\t\t);\n\t\t} else {\n\t\t\treturn error('Missing \"op\". Example: {\"op\":\"init\",\"list\":[{\"phase\":\"Setup\",\"items\":[\"...\"]}]}');\n\t\t}\n\t}\n\n\tswitch (effectiveOp) {\n\t\tcase \"init\": {\n\t\t\tif (task || (effectiveList && effectiveList.length === 0 && hasItems)) return error(CONFLICTING_SHAPES);\n\t\t\tconst entry: TodoOpEntry = { op: \"init\" };\n\t\t\tif (effectiveList) entry.list = effectiveList;\n\t\t\tif (effectiveItems) entry.items = effectiveItems;\n\t\t\tif (phase) entry.phase = phase;\n\t\t\treturn { entry, corrections };\n\t\t}\n\t\tcase \"start\":\n\t\t\tif (phase || hasList || hasItems) return error(CONFLICTING_SHAPES);\n\t\t\treturn { entry: task ? { op: \"start\", task } : { op: \"start\" }, corrections };\n\t\tcase \"done\":\n\t\tcase \"drop\":\n\t\tcase \"rm\": {\n\t\t\tif (hasList || hasItems) return error(CONFLICTING_SHAPES);\n\t\t\tconst entry: TodoOpEntry = { op: effectiveOp };\n\t\t\tif (task) entry.task = task;\n\t\t\tif (phase) entry.phase = phase;\n\t\t\treturn { entry, corrections };\n\t\t}\n\t\tcase \"append\":\n\t\t\tif (task || hasList) return error(CONFLICTING_SHAPES);\n\t\t\treturn {\n\t\t\t\tentry: { op: \"append\", ...(phase ? { phase } : {}), ...(effectiveItems ? { items: effectiveItems } : {}) },\n\t\t\t\tcorrections,\n\t\t\t};\n\t\tcase \"view\":\n\t\t\treturn { entry: { op: \"view\" }, corrections: [] };\n\t}\n}\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\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. 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.\n- Lost the exact task text? view echoes the list \u2014 NEVER guess from memory.\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 capture before proceeding\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 (CRITICAL)\n\nUse the todo tool for multi-step work. It is one operation at a time: initialize a phased list, then start, complete, abandon, append, remove, or view tasks by their exact content. The earliest open task auto-promotes after each completion.\n\n**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\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. 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.\n- Lost the exact task text? view echoes the list \u2014 NEVER guess from memory.\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 capture before proceeding\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>\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. 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.\n- Lost the exact task text? view echoes the list \u2014 NEVER guess from memory. done/start/drop take the task's EXACT text \u2014 copy it verbatim from the latest todo result, never re-type from memory.\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 capture before proceeding\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 (CRITICAL)\n\nUse the todo tool for multi-step work. It is one operation at a time: initialize a phased list, then start, complete, abandon, append, remove, or view tasks by their exact content. The earliest open task auto-promotes after each completion.\n\n**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. 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.\n- Lost the exact task text? view echoes the list \u2014 NEVER guess from memory. done/start/drop take the task's EXACT text \u2014 copy it verbatim from the latest todo result, never re-type from memory.\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 capture before proceeding\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>\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,6mEAuCtB,CAAC;AAEb,eAAO,MAAM,uBAAuB,omFAanC,CAAC"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/todotools/prompt.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,qBAAqB,o1EAyCtB,CAAC;AAEb,eAAO,MAAM,uBAAuB,20FAanC,CAAC"}

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

@@ -17,9 +17,11 @@ Completing tasks out of phase order can move this pointer **back** to an earlier
 | done | task or phase | Mark completed |
 | drop | task or phase | Mark abandoned |
 | rm | task or phase (optional) | Remove task or phase; omit both to clear |
-| append | phase, items: string[] | Append tasks to phase; lazily creates phase |
+| append | phase?, items: string[] | Append tasks to phase; lazily creates phase |
 | view | — | Read-only: echo list |
 
+Example: {"op":"init","list":[{"phase":"Setup","items":["Survey code","Write tests"]}]}
+
 ## Anatomy
 - **Task content**: 5–10 words; what, not how. Unique identifier.
 - **Phase name**: short noun phrase (e.g. Foundation, Auth, Verification). Unique identifier. NEVER prefix 1., A), Phase 1:.
@@ -29,7 +31,7 @@ Completing tasks out of phase order can move this pointer **back** to an earlier
 - 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.
 - Blocked? append a task to the active phase, or drop.
 - Keep task/phase strings stable once introduced.
-- Lost the exact task text? view echoes the list — NEVER guess from memory.
+- Lost the exact task text? view echoes the list — NEVER guess from memory. done/start/drop take the task's EXACT text — copy it verbatim from the latest todo result, never re-type from memory.
 
 ## When to create a list
 - Task requires 3+ distinct steps