@bastani/atomic 0.9.40 → 0.9.41-alpha.2

package/dist/core/tools/kill.js.map

@@ -1 +1 @@
-{"version":3,"file":"kill.js","sourceRoot":"","sources":["../../../src/core/tools/kill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAC;AAGtE,OAAO,EAAE,eAAe,EAA+B,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;IAC9B,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0EAA0E,EAAE,CAAC;CAC5G,CAAC,CAAC;AAOH,MAAM,UAAU,wBAAwB,CAAC,OAAyB;IACjE,OAAO;QACN,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,WAAW,EACV,+PAA+P;QAChQ,UAAU,EAAE,UAAU;QACtB,GAAG,gCAAgC,EAAE;QACrC,aAAa,EAAE,gDAAgD;QAC/D,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;YACtC,MAAM,OAAO,GAAG,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YACtE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;YACtC,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAClD,IAAI,CAAC,OAAO,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACpF,IAAI,CAAC;gBACJ,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;gBACrF,IAAI,MAAM,EAAE,IAAI,KAAK,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;gBAClF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACzD,IAAI,CAAC,MAAM,CAAC,EAAE;oBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACjF,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;gBAC7B,OAAO;oBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC1D,OAAO,EAAE,OAAO;oBAChB,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC/D,CAAC;YACH,CAAC;oBAAS,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACzB,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAyB;IACvD,OAAO,kBAAkB,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9D,CAAC","sourcesContent":["import { Type } from \"typebox\";\nimport { experimentalToolSamplingProperty } from \"../experimental.ts\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\nimport type { CancelReceipt } from \"../tasks/contracts.js\";\nimport { lookupOwnedTask, type SupervisedCommandOwner } from \"./bash-pty-native.js\";\nimport { wrapToolDefinition } from \"./tool-definition-wrapper.ts\";\n\nconst killSchema = Type.Object({\n\tid: Type.String({ description: \"Task ID returned by a background or auto-yielded bash or powershell call\" }),\n});\n\nexport interface KillToolOptions {\n\t/** Resolve the live trusted owner at execution time, including after session switches. */\n\ttaskOwner?: () => SupervisedCommandOwner | undefined;\n}\n\nexport function createKillToolDefinition(options?: KillToolOptions): ToolDefinition<typeof killSchema, CancelReceipt> {\n\treturn {\n\t\tname: \"kill\",\n\t\tlabel: \"Kill\",\n\t\tdescription:\n\t\t\t\"Stop an owned background bash or PowerShell task by its task ID, not a PID. Does not stop subagents or other owners' tasks. Returns the cancellation decision and current execution/cleanup state; a cancellation request alone does not confirm termination.\",\n\t\tparameters: killSchema,\n\t\t...experimentalToolSamplingProperty(),\n\t\tpromptSnippet: \"Stop an owned background shell task by task ID\",\n\t\texecute: async (_toolCallId, { id }) => {\n\t\t\tconst binding = options?.taskOwner?.();\n\t\t\tif (!binding) throw new Error(\"kill requires a supported task owner\");\n\t\t\tconst { supervisor, owner } = binding;\n\t\t\tconst task = lookupOwnedTask(binding, id);\n\t\t\tconst watched = supervisor.watchOwnerTasks(owner);\n\t\t\tif (!watched.ok) throw new Error(`${watched.error.code}: ${watched.error.message}`);\n\t\t\ttry {\n\t\t\t\tconst record = watched.value.snapshot.tasks.find((entry) => entry.ref.taskId === id);\n\t\t\t\tif (record?.kind !== \"command\") throw new Error(\"kill only supports shell tasks\");\n\t\t\t\tconst result = await supervisor.cancelTask(task, \"user\");\n\t\t\t\tif (!result.ok) throw new Error(`${result.error.code}: ${result.error.message}`);\n\t\t\t\tconst receipt = result.value;\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: JSON.stringify(receipt) }],\n\t\t\t\t\tdetails: receipt,\n\t\t\t\t\t...(receipt.cleanup.kind === \"failed\" ? { isError: true } : {}),\n\t\t\t\t};\n\t\t\t} finally {\n\t\t\t\twatched.value.dispose();\n\t\t\t}\n\t\t},\n\t};\n}\n\nexport function createKillTool(options?: KillToolOptions) {\n\treturn wrapToolDefinition(createKillToolDefinition(options));\n}\n"]}
+{"version":3,"file":"kill.js","sourceRoot":"","sources":["../../../src/core/tools/kill.ts"],"names":[],"mappings":"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","sourcesContent":["import { Container, Text } from \"@earendil-works/pi-tui\";\nimport { Type } from \"typebox\";\nimport { experimentalToolSamplingProperty } from \"../experimental.ts\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\nimport type { CancelReceipt } from \"../tasks/contracts.js\";\nimport { lookupOwnedTask, type SupervisedCommandOwner } from \"./bash-pty-native.js\";\nimport { formatKillCall, rebuildKillResult } from \"./shell-task-render.ts\";\nimport { cancelReceiptSentence, TaskToolError } from \"./shell-task-status.ts\";\nimport { wrapToolDefinition } from \"./tool-definition-wrapper.ts\";\n\nconst killSchema = Type.Object({\n\tid: Type.String({ description: \"Task ID returned by a background or auto-yielded bash or powershell call\" }),\n});\n\nexport interface KillToolOptions {\n\t/** Resolve the live trusted owner at execution time, including after session switches. */\n\ttaskOwner?: () => SupervisedCommandOwner | undefined;\n}\n\nexport function createKillToolDefinition(options?: KillToolOptions): ToolDefinition<typeof killSchema, CancelReceipt> {\n\treturn {\n\t\tname: \"kill\",\n\t\tlabel: \"Kill\",\n\t\tdescription:\n\t\t\t\"Stop an owned background bash or PowerShell task by its task ID, not a PID. Does not stop subagents or other owners' tasks. Returns the cancellation decision and current execution/cleanup state; a cancellation request alone does not confirm termination.\",\n\t\tparameters: killSchema,\n\t\t...experimentalToolSamplingProperty(),\n\t\tpromptSnippet: \"Stop an owned background shell task by task ID\",\n\t\texecute: async (_toolCallId, { id }) => {\n\t\t\tconst binding = options?.taskOwner?.();\n\t\t\tif (!binding) throw new Error(\"kill requires a supported task owner\");\n\t\t\tconst { supervisor, owner } = binding;\n\t\t\tconst task = lookupOwnedTask(binding, id);\n\t\t\tconst watched = supervisor.watchOwnerTasks(owner);\n\t\t\tif (!watched.ok) throw new TaskToolError(watched.error, id);\n\t\t\ttry {\n\t\t\t\tconst record = watched.value.snapshot.tasks.find((entry) => entry.ref.taskId === id);\n\t\t\t\tif (record?.kind !== \"command\") throw new Error(\"kill only supports shell tasks\");\n\t\t\t\tconst result = await supervisor.cancelTask(task, \"user\");\n\t\t\t\tif (!result.ok) throw new TaskToolError(result.error, id);\n\t\t\t\tconst receipt = result.value;\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: cancelReceiptSentence(receipt) }],\n\t\t\t\t\tdetails: receipt,\n\t\t\t\t\t...(receipt.cleanup.kind === \"failed\" ? { isError: true } : {}),\n\t\t\t\t};\n\t\t\t} finally {\n\t\t\t\twatched.value.dispose();\n\t\t\t}\n\t\t},\n\t\trenderCall(args, _theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\ttext.setText(formatKillCall(args));\n\t\t\treturn text;\n\t\t},\n\t\trenderResult(result, _options, _theme, context) {\n\t\t\tconst component = (context.lastComponent as Container | undefined) ?? new Container();\n\t\t\trebuildKillResult(component, result, { isError: context.isError, taskId: context.args.id });\n\t\t\tcomponent.invalidate();\n\t\t\treturn component;\n\t\t},\n\t};\n}\n\nexport function createKillTool(options?: KillToolOptions) {\n\treturn wrapToolDefinition(createKillToolDefinition(options));\n}\n"]}

package/dist/core/tools/shell-task-render.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Transcript presentation for shell task results: a `wait` observation and a `kill` receipt each become one status
+ * line, with the task's output (when it has any) below it. Raw observation envelopes and internal ids never appear.
+ *
+ * Roles follow DESIGN.md: success, error, warning and dim carry the state, `·` separates facts, and only the glyphs
+ * `✓ ✗ ● ○` are used. The status reads the same without color; with `NO_COLOR` set it drops foreground color and
+ * keeps the weight.
+ */
+import { type Container } from "@earendil-works/pi-tui";
+import type { ToolRenderResultOptions } from "../extensions/types.ts";
+import type { CancelReceipt, WaitOutcome } from "../tasks/contracts.js";
+import { type TruncationResult } from "./truncate.ts";
+/** Output lines shown before a shell result collapses behind the expand hint. */
+export declare const SHELL_OUTPUT_PREVIEW_LINES = 5;
+type ResultContent = Array<{
+    type: string;
+    text?: string;
+    data?: string;
+    mimeType?: string;
+}>;
+/** The output block of a shell result: everything when expanded, otherwise the last few lines and an expand hint. */
+export declare function addShellOutputPreview(component: Container, output: string, expanded: boolean): void;
+export declare function formatTruncationNotice(truncation: TruncationResult): string;
+export interface ShellWaitResultView {
+    content: ResultContent;
+    details?: {
+        observation?: WaitOutcome;
+        truncation?: TruncationResult;
+        fullOutputPath?: string;
+    };
+}
+/**
+ * Rebuild the row of a `wait` result: status line, output, a dim note when the output was cut short, then the timer.
+ * An error that is not a task failure, or a result without an observation, is left to the generic shell renderer;
+ * the return value says whether this renderer handled the result.
+ */
+export declare function rebuildShellWaitResult(component: Container, result: ShellWaitResultView, options: Pick<ToolRenderResultOptions, "expanded">, view: {
+    showImages: boolean;
+    isError: boolean;
+    taskId: string | undefined;
+    timerText: string | undefined;
+}): boolean;
+export declare function formatKillCall(args: {
+    id?: unknown;
+} | undefined): string;
+/** Rebuild the row of a `kill` result from its receipt, or from the failure text when the call was rejected. */
+export declare function rebuildKillResult(component: Container, result: {
+    content: ResultContent;
+    details?: CancelReceipt;
+}, view: {
+    isError: boolean;
+    taskId: string | undefined;
+}): void;
+export {};
+//# sourceMappingURL=shell-task-render.d.ts.map

package/dist/core/tools/shell-task-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-task-render.d.ts","sourceRoot":"","sources":["../../../src/core/tools/shell-task-render.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,SAAS,EAAgB,MAAM,wBAAwB,CAAC;AAItE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAWxE,OAAO,EAAiC,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAErF,iFAAiF;AACjF,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,KAAK,aAAa,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAiB9F,qHAAqH;AACrH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAmBnG;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAI3E;AAMD,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,CAAC,EAAE;QACT,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,UAAU,CAAC,EAAE,gBAAgB,CAAC;QAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,UAAU,CAAC,EAClD,IAAI,EAAE;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACxG,OAAO,CA4BT;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,EAAE,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAAG,MAAM,CAIzE;AAED,gHAAgH;AAChH,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,CAAA;CAAE,EAC3D,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACpD,IAAI,CAoBN"}

package/dist/core/tools/shell-task-render.js

@@ -0,0 +1,123 @@
+/**
+ * Transcript presentation for shell task results: a `wait` observation and a `kill` receipt each become one status
+ * line, with the task's output (when it has any) below it. Raw observation envelopes and internal ids never appear.
+ *
+ * Roles follow DESIGN.md: success, error, warning and dim carry the state, `·` separates facts, and only the glyphs
+ * `✓ ✗ ● ○` are used. The status reads the same without color; with `NO_COLOR` set it drops foreground color and
+ * keeps the weight.
+ */
+import { Spacer, Text } from "@earendil-works/pi-tui";
+import { parenthesizedKeyHint } from "../../modes/interactive/components/keybinding-hints.js";
+import { VisualLinePreview } from "../../modes/interactive/components/visual-truncate.js";
+import { theme } from "../../modes/interactive/theme/theme.js";
+import { getTextOutput, invalidArgText, str } from "./render-utils.js";
+import { cancelReceiptStatus, cleanupFailureSummary, EMPTY_OUTPUT_TEXT, presentTaskError, waitResultTail, waitStatus, } from "./shell-task-status.js";
+import { DEFAULT_MAX_BYTES, formatSize } from "./truncate.js";
+/** Output lines shown before a shell result collapses behind the expand hint. */
+export const SHELL_OUTPUT_PREVIEW_LINES = 5;
+const noColor = () => process.env.NO_COLOR !== undefined;
+function statusLine(status) {
+    const head = `${status.glyph} ${status.label}`;
+    if (noColor())
+        return theme.bold(head) + (status.detail ? ` · ${status.detail}` : "");
+    const detail = status.detail ? theme.fg("dim", " · ") + theme.fg("muted", status.detail) : "";
+    return theme.fg(status.tone, head) + detail;
+}
+function addErrorLines(component, headline, hint) {
+    const heading = `✗ ${headline}`;
+    component.addChild(new Text(noColor() ? theme.bold(heading) : theme.fg("error", heading), 0, 0));
+    if (hint)
+        component.addChild(new Text(noColor() ? hint : theme.fg("dim", hint), 0, 0));
+}
+/** The output block of a shell result: everything when expanded, otherwise the last few lines and an expand hint. */
+export function addShellOutputPreview(component, output, expanded) {
+    const styledOutput = output
+        .split("\n")
+        .map((line) => theme.fg("toolOutput", line))
+        .join("\n");
+    if (expanded) {
+        component.addChild(new Text(`\n${styledOutput}`, 0, 0));
+        return;
+    }
+    component.addChild(new Spacer(1));
+    component.addChild(new VisualLinePreview({
+        text: styledOutput,
+        maxVisualLines: SHELL_OUTPUT_PREVIEW_LINES,
+        keep: "end",
+        formatHint: (hidden) => theme.fg("muted", "... ") + parenthesizedKeyHint("app.tools.expand", "Expand", `${hidden} earlier lines`),
+    }));
+}
+export function formatTruncationNotice(truncation) {
+    return truncation.truncatedBy === "lines"
+        ? `Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines`
+        : `Truncated: ${truncation.outputLines} lines shown (${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit)`;
+}
+function addTimer(component, timerText) {
+    if (timerText)
+        component.addChild(new Text(`\n${theme.fg("muted", timerText)}`, 0, 0));
+}
+/**
+ * Rebuild the row of a `wait` result: status line, output, a dim note when the output was cut short, then the timer.
+ * An error that is not a task failure, or a result without an observation, is left to the generic shell renderer;
+ * the return value says whether this renderer handled the result.
+ */
+export function rebuildShellWaitResult(component, result, options, view) {
+    const text = getTextOutput(result, view.showImages).trim();
+    if (view.isError) {
+        const error = presentTaskError(text, view.taskId);
+        if (!error)
+            return false;
+        component.clear();
+        addErrorLines(component, error.headline, error.hint);
+        addTimer(component, view.timerText);
+        return true;
+    }
+    const observation = result.details?.observation;
+    if (!observation)
+        return false;
+    const truncation = result.details?.truncation;
+    const fullOutputPath = result.details?.fullOutputPath;
+    const tail = waitResultTail({ observation, truncated: truncation?.truncated === true, fullOutputPath });
+    const output = (text.endsWith(tail) ? text.slice(0, -tail.length) : text).trim();
+    const hasOutput = output !== "" && output !== EMPTY_OUTPUT_TEXT;
+    component.clear();
+    component.addChild(new Text(statusLine(waitStatus(observation, hasOutput)), 0, 0));
+    if (hasOutput)
+        addShellOutputPreview(component, output, options.expanded);
+    else
+        component.addChild(new Text(theme.fg("dim", EMPTY_OUTPUT_TEXT), 0, 0));
+    const notes = [
+        truncation?.truncated ? formatTruncationNotice(truncation) : undefined,
+        fullOutputPath ? `Full output: ${fullOutputPath}` : undefined,
+    ].filter((note) => note !== undefined);
+    if (notes.length > 0)
+        component.addChild(new Text(theme.fg("dim", notes.join(" · ")), 0, 0));
+    addTimer(component, view.timerText);
+    return true;
+}
+export function formatKillCall(args) {
+    const id = str(args?.id);
+    const target = id === null ? invalidArgText(theme) : id || theme.fg("toolOutput", "...");
+    return theme.fg("toolTitle", theme.bold(`kill ${target}`));
+}
+/** Rebuild the row of a `kill` result from its receipt, or from the failure text when the call was rejected. */
+export function rebuildKillResult(component, result, view) {
+    component.clear();
+    const text = getTextOutput(result, false).trim();
+    const error = view.isError ? presentTaskError(text, view.taskId) : undefined;
+    if (error) {
+        addErrorLines(component, error.headline, error.hint);
+        return;
+    }
+    const receipt = result.details;
+    // A rejected call carries empty details, so only a real receipt has an execution to describe.
+    if (!receipt?.execution) {
+        component.addChild(new Text(theme.fg("toolOutput", text), 0, 0));
+        return;
+    }
+    component.addChild(new Text(statusLine(cancelReceiptStatus(receipt)), 0, 0));
+    const failure = cleanupFailureSummary(receipt.cleanup);
+    if (failure)
+        component.addChild(new Text(statusLine({ glyph: "✗", tone: "error", label: "cleanup failed", detail: failure }), 0, 0));
+}
+//# sourceMappingURL=shell-task-render.js.map

package/dist/core/tools/shell-task-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-task-render.js","sourceRoot":"","sources":["../../../src/core/tools/shell-task-render.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Transcript presentation for shell task results: a `wait` observation and a `kill` receipt each become one status\n * line, with the task's output (when it has any) below it. Raw observation envelopes and internal ids never appear.\n *\n * Roles follow DESIGN.md: success, error, warning and dim carry the state, `·` separates facts, and only the glyphs\n * `✓ ✗ ● ○` are used. The status reads the same without color; with `NO_COLOR` set it drops foreground color and\n * keeps the weight.\n */\nimport { type Container, Spacer, Text } from \"@earendil-works/pi-tui\";\nimport { parenthesizedKeyHint } from \"../../modes/interactive/components/keybinding-hints.js\";\nimport { VisualLinePreview } from \"../../modes/interactive/components/visual-truncate.ts\";\nimport { theme } from \"../../modes/interactive/theme/theme.js\";\nimport type { ToolRenderResultOptions } from \"../extensions/types.ts\";\nimport type { CancelReceipt, WaitOutcome } from \"../tasks/contracts.js\";\nimport { getTextOutput, invalidArgText, str } from \"./render-utils.ts\";\nimport {\n\tcancelReceiptStatus,\n\tcleanupFailureSummary,\n\tEMPTY_OUTPUT_TEXT,\n\tpresentTaskError,\n\ttype TaskStatus,\n\twaitResultTail,\n\twaitStatus,\n} from \"./shell-task-status.ts\";\nimport { DEFAULT_MAX_BYTES, formatSize, type TruncationResult } from \"./truncate.ts\";\n\n/** Output lines shown before a shell result collapses behind the expand hint. */\nexport const SHELL_OUTPUT_PREVIEW_LINES = 5;\n\ntype ResultContent = Array<{ type: string; text?: string; data?: string; mimeType?: string }>;\n\nconst noColor = (): boolean => process.env.NO_COLOR !== undefined;\n\nfunction statusLine(status: TaskStatus): string {\n\tconst head = `${status.glyph} ${status.label}`;\n\tif (noColor()) return theme.bold(head) + (status.detail ? ` · ${status.detail}` : \"\");\n\tconst detail = status.detail ? theme.fg(\"dim\", \" · \") + theme.fg(\"muted\", status.detail) : \"\";\n\treturn theme.fg(status.tone, head) + detail;\n}\n\nfunction addErrorLines(component: Container, headline: string, hint: string | undefined): void {\n\tconst heading = `✗ ${headline}`;\n\tcomponent.addChild(new Text(noColor() ? theme.bold(heading) : theme.fg(\"error\", heading), 0, 0));\n\tif (hint) component.addChild(new Text(noColor() ? hint : theme.fg(\"dim\", hint), 0, 0));\n}\n\n/** The output block of a shell result: everything when expanded, otherwise the last few lines and an expand hint. */\nexport function addShellOutputPreview(component: Container, output: string, expanded: boolean): void {\n\tconst styledOutput = output\n\t\t.split(\"\\n\")\n\t\t.map((line) => theme.fg(\"toolOutput\", line))\n\t\t.join(\"\\n\");\n\tif (expanded) {\n\t\tcomponent.addChild(new Text(`\\n${styledOutput}`, 0, 0));\n\t\treturn;\n\t}\n\tcomponent.addChild(new Spacer(1));\n\tcomponent.addChild(\n\t\tnew VisualLinePreview({\n\t\t\ttext: styledOutput,\n\t\t\tmaxVisualLines: SHELL_OUTPUT_PREVIEW_LINES,\n\t\t\tkeep: \"end\",\n\t\t\tformatHint: (hidden) =>\n\t\t\t\ttheme.fg(\"muted\", \"... \") + parenthesizedKeyHint(\"app.tools.expand\", \"Expand\", `${hidden} earlier lines`),\n\t\t}),\n\t);\n}\n\nexport function formatTruncationNotice(truncation: TruncationResult): string {\n\treturn truncation.truncatedBy === \"lines\"\n\t\t? `Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines`\n\t\t: `Truncated: ${truncation.outputLines} lines shown (${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit)`;\n}\n\nfunction addTimer(component: Container, timerText: string | undefined): void {\n\tif (timerText) component.addChild(new Text(`\\n${theme.fg(\"muted\", timerText)}`, 0, 0));\n}\n\nexport interface ShellWaitResultView {\n\tcontent: ResultContent;\n\tdetails?: {\n\t\tobservation?: WaitOutcome;\n\t\ttruncation?: TruncationResult;\n\t\tfullOutputPath?: string;\n\t};\n}\n\n/**\n * Rebuild the row of a `wait` result: status line, output, a dim note when the output was cut short, then the timer.\n * An error that is not a task failure, or a result without an observation, is left to the generic shell renderer;\n * the return value says whether this renderer handled the result.\n */\nexport function rebuildShellWaitResult(\n\tcomponent: Container,\n\tresult: ShellWaitResultView,\n\toptions: Pick<ToolRenderResultOptions, \"expanded\">,\n\tview: { showImages: boolean; isError: boolean; taskId: string | undefined; timerText: string | undefined },\n): boolean {\n\tconst text = getTextOutput(result, view.showImages).trim();\n\tif (view.isError) {\n\t\tconst error = presentTaskError(text, view.taskId);\n\t\tif (!error) return false;\n\t\tcomponent.clear();\n\t\taddErrorLines(component, error.headline, error.hint);\n\t\taddTimer(component, view.timerText);\n\t\treturn true;\n\t}\n\tconst observation = result.details?.observation;\n\tif (!observation) return false;\n\tconst truncation = result.details?.truncation;\n\tconst fullOutputPath = result.details?.fullOutputPath;\n\tconst tail = waitResultTail({ observation, truncated: truncation?.truncated === true, fullOutputPath });\n\tconst output = (text.endsWith(tail) ? text.slice(0, -tail.length) : text).trim();\n\tconst hasOutput = output !== \"\" && output !== EMPTY_OUTPUT_TEXT;\n\tcomponent.clear();\n\tcomponent.addChild(new Text(statusLine(waitStatus(observation, hasOutput)), 0, 0));\n\tif (hasOutput) addShellOutputPreview(component, output, options.expanded);\n\telse component.addChild(new Text(theme.fg(\"dim\", EMPTY_OUTPUT_TEXT), 0, 0));\n\tconst notes = [\n\t\ttruncation?.truncated ? formatTruncationNotice(truncation) : undefined,\n\t\tfullOutputPath ? `Full output: ${fullOutputPath}` : undefined,\n\t].filter((note) => note !== undefined);\n\tif (notes.length > 0) component.addChild(new Text(theme.fg(\"dim\", notes.join(\" · \")), 0, 0));\n\taddTimer(component, view.timerText);\n\treturn true;\n}\n\nexport function formatKillCall(args: { id?: unknown } | undefined): string {\n\tconst id = str(args?.id);\n\tconst target = id === null ? invalidArgText(theme) : id || theme.fg(\"toolOutput\", \"...\");\n\treturn theme.fg(\"toolTitle\", theme.bold(`kill ${target}`));\n}\n\n/** Rebuild the row of a `kill` result from its receipt, or from the failure text when the call was rejected. */\nexport function rebuildKillResult(\n\tcomponent: Container,\n\tresult: { content: ResultContent; details?: CancelReceipt },\n\tview: { isError: boolean; taskId: string | undefined },\n): void {\n\tcomponent.clear();\n\tconst text = getTextOutput(result, false).trim();\n\tconst error = view.isError ? presentTaskError(text, view.taskId) : undefined;\n\tif (error) {\n\t\taddErrorLines(component, error.headline, error.hint);\n\t\treturn;\n\t}\n\tconst receipt = result.details;\n\t// A rejected call carries empty details, so only a real receipt has an execution to describe.\n\tif (!receipt?.execution) {\n\t\tcomponent.addChild(new Text(theme.fg(\"toolOutput\", text), 0, 0));\n\t\treturn;\n\t}\n\tcomponent.addChild(new Text(statusLine(cancelReceiptStatus(receipt)), 0, 0));\n\tconst failure = cleanupFailureSummary(receipt.cleanup);\n\tif (failure)\n\t\tcomponent.addChild(\n\t\t\tnew Text(statusLine({ glyph: \"✗\", tone: \"error\", label: \"cleanup failed\", detail: failure }), 0, 0),\n\t\t);\n}\n"]}

package/dist/core/tools/shell-task-status.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Plain-language wording for shell task observations (`wait`) and cancellations (`kill`).
+ *
+ * One source of truth for two audiences: the model reads compact sentences in the tool result text, and the
+ * transcript renders the same facts as a single status line. Structured data stays in the result `details`.
+ */
+import type { CancelError, CancelReceipt, Cleanup, Failure, OutputError, TaskResult, WaitError, WaitOutcome, WatchError } from "../tasks/contracts.js";
+export type TaskStatusTone = "success" | "error" | "warning" | "dim";
+/** One line of task state: `✓ completed · exit 0`. The glyph and label alone carry the meaning without color. */
+export interface TaskStatus {
+    glyph: "✓" | "✗" | "●" | "○";
+    tone: TaskStatusTone;
+    label: string;
+    detail?: string;
+}
+export declare const EMPTY_OUTPUT_TEXT = "(no output)";
+export declare function taskResultStatus(result: TaskResult): TaskStatus;
+/** Status line for a `wait` result. `hasOutput` says whether any output is shown below it. */
+export declare function waitStatus(observation: WaitOutcome, hasOutput: boolean): TaskStatus;
+export interface WaitResultTail {
+    observation: WaitOutcome;
+    truncated: boolean;
+    fullOutputPath?: string;
+}
+/**
+ * Everything the model reads after a wait's output: the truncation marker, one sentence with the task's state and
+ * exit code, and the path of the full output when it was truncated. The renderer strips the same tail.
+ */
+export declare function waitResultTail({ observation, truncated, fullOutputPath }: WaitResultTail): string;
+/** Model-facing text of a `kill` result. The receipt itself stays in the result details. */
+export declare function cancelReceiptSentence(receipt: CancelReceipt): string;
+/** Status line for a `kill` result, describing the task rather than the request. */
+export declare function cancelReceiptStatus(receipt: CancelReceipt): TaskStatus;
+/** The first resource that could not be cleaned up, for a status line; undefined when cleanup did not fail. */
+export declare function cleanupFailureSummary(cleanup: Cleanup): string | undefined;
+export type TaskToolFailureCode = WaitError["code"] | CancelError["code"] | OutputError["code"] | WatchError["code"];
+/**
+ * A task failure on the `wait`/`kill` path. The message is `<Code>: <plain-language headline naming the task>`;
+ * callers that branch on the failure read `code` instead of parsing it.
+ */
+export declare class TaskToolError extends Error {
+    readonly code: TaskToolFailureCode;
+    readonly taskId: string;
+    constructor(failure: Failure<TaskToolFailureCode>, taskId: string);
+}
+export interface TaskErrorPresentation {
+    headline: string;
+    hint?: string;
+}
+/** How the transcript presents the text of a thrown {@link TaskToolError}; undefined for any other error text. */
+export declare function presentTaskError(text: string, taskId: string | undefined): TaskErrorPresentation | undefined;
+//# sourceMappingURL=shell-task-status.d.ts.map

package/dist/core/tools/shell-task-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-task-status.d.ts","sourceRoot":"","sources":["../../../src/core/tools/shell-task-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAEX,WAAW,EACX,aAAa,EACb,OAAO,EACP,OAAO,EACP,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC;AAErE,iHAAiH;AACjH,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAiC/C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAiB/D;AAmBD,8FAA8F;AAC9F,wBAAgB,UAAU,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,GAAG,UAAU,CAMnF;AAQD,MAAM,WAAW,cAAc;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,cAAc,GAAG,MAAM,CAEjG;AAUD,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAepE;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,UAAU,CAYtE;AAED,+GAA+G;AAC/G,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAM1E;AAED,MAAM,MAAM,mBAAmB,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;AAyCrH;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,MAAM,EAOhE;CACD;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,kHAAkH;AAClH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,qBAAqB,GAAG,SAAS,CAS5G"}

package/dist/core/tools/shell-task-status.js

@@ -0,0 +1,184 @@
+export const EMPTY_OUTPUT_TEXT = "(no output)";
+const CANCEL_CAUSE_TEXT = {
+    user: "stop requested",
+    "owner-close": "session closed",
+    "execution-timeout": "timed out",
+    "output-limit": "output limit reached",
+    "parent-handoff": "handed off",
+    pause: "paused · awaiting resume",
+    quit: "quit · paused · awaiting resume",
+    shutdown: "Atomic shut down",
+};
+function firstLine(text) {
+    return text.trim().split(/\r?\n/, 1)[0]?.trim() ?? "";
+}
+function withoutTrailingPeriods(text) {
+    let end = text.length;
+    while (end > 0 && (text[end - 1] === "." || /\s/.test(text[end - 1] ?? "")))
+        end--;
+    return text.slice(0, end);
+}
+/** The message of a failure, unless it only repeats the failure code. */
+function informativeMessage(code, message) {
+    const line = firstLine(message);
+    return line && line !== code ? line : undefined;
+}
+function withDetail(status, detail) {
+    return detail === undefined ? status : { ...status, detail };
+}
+export function taskResultStatus(result) {
+    switch (result.kind) {
+        case "completed":
+            if (result.exitCode === 0)
+                return { glyph: "✓", tone: "success", label: "completed", detail: "exit 0" };
+            if (result.exitCode === undefined)
+                return { glyph: "✗", tone: "error", label: "ended without an exit code" };
+            return { glyph: "✗", tone: "error", label: `exited ${result.exitCode}` };
+        case "failed":
+            return withDetail({ glyph: "✗", tone: "error", label: "failed" }, informativeMessage(result.code, result.message));
+        case "cancelled":
+            return withDetail({ glyph: "○", tone: "dim", label: "cancelled" }, result.cause === "user" ? undefined : CANCEL_CAUSE_TEXT[result.cause]);
+    }
+}
+/** What happened to a task, as a verb phrase that follows its subject: `exited with code 1`. */
+function taskResultPhrase(result) {
+    switch (result.kind) {
+        case "completed":
+            if (result.exitCode === 0)
+                return "completed with exit code 0";
+            if (result.exitCode === undefined)
+                return "ended without an exit code";
+            return `exited with code ${result.exitCode}`;
+        case "failed": {
+            const message = informativeMessage(result.code, result.message);
+            const reason = message === undefined ? undefined : withoutTrailingPeriods(message);
+            return `failed (${result.code})${reason ? `: ${reason}` : ""}${result.exitCode === undefined ? "" : ` (exit code ${result.exitCode})`}`;
+        }
+        case "cancelled":
+            return `was cancelled (${CANCEL_CAUSE_TEXT[result.cause]})`;
+    }
+}
+/** Status line for a `wait` result. `hasOutput` says whether any output is shown below it. */
+export function waitStatus(observation, hasOutput) {
+    if (observation.kind === "settled")
+        return taskResultStatus(observation.result);
+    return withDetail({ glyph: "●", tone: "warning", label: "still running" }, hasOutput ? "showing output so far" : undefined);
+}
+function waitSentence(observation) {
+    if (observation.kind === "yielded")
+        return `Task ${observation.taskId} is still running (yielded: ${observation.reason}).`;
+    return `Task ${observation.taskId} ${taskResultPhrase(observation.result)}.`;
+}
+/**
+ * Everything the model reads after a wait's output: the truncation marker, one sentence with the task's state and
+ * exit code, and the path of the full output when it was truncated. The renderer strips the same tail.
+ */
+export function waitResultTail({ observation, truncated, fullOutputPath }) {
+    return `${truncated ? "\n[Output truncated.]" : ""}\n\n${waitSentence(observation)}${fullOutputPath ? `\nFull output: ${fullOutputPath}` : ""}`;
+}
+function cleanupSentence(cleanup) {
+    if (cleanup.kind !== "failed")
+        return `Cleanup: ${cleanup.kind}.`;
+    const resources = cleanup.resources.map((entry) => `${entry.resource} (${entry.code}): ${withoutTrailingPeriods(firstLine(entry.message))}`);
+    return `Cleanup failed: ${resources.join("; ")}.`;
+}
+/** Model-facing text of a `kill` result. The receipt itself stays in the result details. */
+export function cancelReceiptSentence(receipt) {
+    const { taskId, execution } = receipt;
+    let lead;
+    if (execution.kind === "settled") {
+        const phrase = taskResultPhrase(execution.result);
+        lead =
+            receipt.decision === "already-settled"
+                ? `Task ${taskId} had already finished; nothing to stop. It ${phrase}.`
+                : `Task ${taskId} ${phrase}.`;
+    }
+    else if (execution.kind === "cancelling") {
+        lead = `Cancellation requested for task ${taskId}; it has not stopped yet.`;
+    }
+    else {
+        lead = `Cancellation requested for task ${taskId}; it is still ${execution.kind}.`;
+    }
+    return `${lead} ${cleanupSentence(receipt.cleanup)}`;
+}
+/** Status line for a `kill` result, describing the task rather than the request. */
+export function cancelReceiptStatus(receipt) {
+    const { execution } = receipt;
+    if (execution.kind === "settled") {
+        const status = taskResultStatus(execution.result);
+        return receipt.decision === "already-settled" ? { ...status, label: `already ${status.label}` } : status;
+    }
+    return {
+        glyph: "●",
+        tone: "warning",
+        label: execution.kind === "cancelling" ? "stopping" : "still running",
+        detail: "cancellation requested",
+    };
+}
+/** The first resource that could not be cleaned up, for a status line; undefined when cleanup did not fail. */
+export function cleanupFailureSummary(cleanup) {
+    if (cleanup.kind !== "failed")
+        return undefined;
+    const [first, ...rest] = cleanup.resources;
+    if (!first)
+        return undefined;
+    const message = informativeMessage(first.code, first.message);
+    return `${first.resource}${message ? `: ${message}` : ""}${rest.length ? ` (+${rest.length} more)` : ""}`;
+}
+const TASKS_HINT = "Run /tasks to check on it.";
+const TASK_ERROR_COPY = {
+    UnknownTask: {
+        headline: (taskId) => `No background task "${taskId}" in this session`,
+        hint: "It may have finished and been cleaned up, or belong to another session. Run /tasks to see current tasks.",
+    },
+    ScopeMismatch: {
+        headline: (taskId) => `Task "${taskId}" belongs to another session`,
+        hint: "Run /tasks to see the tasks in this session.",
+    },
+    OwnerClosed: {
+        headline: () => "This session's background tasks are closed",
+        hint: "Run the command again to start a new task.",
+    },
+    EnvironmentClosing: { headline: () => "Atomic is shutting down" },
+    ObserverCancelled: { headline: (taskId) => `Stopped waiting for task "${taskId}"`, hint: TASKS_HINT },
+    OutputUnavailable: {
+        headline: (taskId) => `Output for task "${taskId}" is no longer available`,
+        hint: "Run /tasks to check on the task.",
+    },
+    CleanupFailed: {
+        headline: (taskId, detail) => `Could not stop task "${taskId}"${detail ? `: ${detail}` : ""}`,
+        hint: "Run /tasks to check whether it is still running.",
+    },
+    StaleGeneration: { headline: () => "The task list changed while it was being read", hint: "Try again." },
+};
+function isTaskToolFailureCode(code) {
+    return Object.hasOwn(TASK_ERROR_COPY, code);
+}
+/**
+ * A task failure on the `wait`/`kill` path. The message is `<Code>: <plain-language headline naming the task>`;
+ * callers that branch on the failure read `code` instead of parsing it.
+ */
+export class TaskToolError extends Error {
+    code;
+    taskId;
+    constructor(failure, taskId) {
+        super(`${failure.code}: ${TASK_ERROR_COPY[failure.code].headline(taskId, informativeMessage(failure.code, failure.message))}`);
+        this.name = "TaskToolError";
+        this.code = failure.code;
+        this.taskId = taskId;
+    }
+}
+/** How the transcript presents the text of a thrown {@link TaskToolError}; undefined for any other error text. */
+export function presentTaskError(text, taskId) {
+    const match = /^(\w+): ([^\n]*)$/.exec(text.trim());
+    if (!match)
+        return undefined;
+    const [, code, rest] = match;
+    if (code === undefined || rest === undefined || !isTaskToolFailureCode(code))
+        return undefined;
+    const copy = TASK_ERROR_COPY[code];
+    // Sessions saved before the message was plain language hold only the code, repeated as the message.
+    const headline = rest === code && taskId ? copy.headline(taskId, undefined) : rest;
+    return copy.hint ? { headline, hint: copy.hint } : { headline };
+}
+//# sourceMappingURL=shell-task-status.js.map

package/dist/core/tools/shell-task-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-task-status.js","sourceRoot":"","sources":["../../../src/core/tools/shell-task-status.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Plain-language wording for shell task observations (`wait`) and cancellations (`kill`).\n *\n * One source of truth for two audiences: the model reads compact sentences in the tool result text, and the\n * transcript renders the same facts as a single status line. Structured data stays in the result `details`.\n */\nimport type {\n\tCancelCause,\n\tCancelError,\n\tCancelReceipt,\n\tCleanup,\n\tFailure,\n\tOutputError,\n\tTaskResult,\n\tWaitError,\n\tWaitOutcome,\n\tWatchError,\n} from \"../tasks/contracts.js\";\n\nexport type TaskStatusTone = \"success\" | \"error\" | \"warning\" | \"dim\";\n\n/** One line of task state: `✓ completed · exit 0`. The glyph and label alone carry the meaning without color. */\nexport interface TaskStatus {\n\tglyph: \"✓\" | \"✗\" | \"●\" | \"○\";\n\ttone: TaskStatusTone;\n\tlabel: string;\n\tdetail?: string;\n}\n\nexport const EMPTY_OUTPUT_TEXT = \"(no output)\";\n\nconst CANCEL_CAUSE_TEXT: Record<CancelCause, string> = {\n\tuser: \"stop requested\",\n\t\"owner-close\": \"session closed\",\n\t\"execution-timeout\": \"timed out\",\n\t\"output-limit\": \"output limit reached\",\n\t\"parent-handoff\": \"handed off\",\n\tpause: \"paused · awaiting resume\",\n\tquit: \"quit · paused · awaiting resume\",\n\tshutdown: \"Atomic shut down\",\n};\n\nfunction firstLine(text: string): string {\n\treturn text.trim().split(/\\r?\\n/, 1)[0]?.trim() ?? \"\";\n}\n\nfunction withoutTrailingPeriods(text: string): string {\n\tlet end = text.length;\n\twhile (end > 0 && (text[end - 1] === \".\" || /\\s/.test(text[end - 1] ?? \"\"))) end--;\n\treturn text.slice(0, end);\n}\n\n/** The message of a failure, unless it only repeats the failure code. */\nfunction informativeMessage(code: string, message: string): string | undefined {\n\tconst line = firstLine(message);\n\treturn line && line !== code ? line : undefined;\n}\n\nfunction withDetail(status: Omit<TaskStatus, \"detail\">, detail: string | undefined): TaskStatus {\n\treturn detail === undefined ? status : { ...status, detail };\n}\n\nexport function taskResultStatus(result: TaskResult): TaskStatus {\n\tswitch (result.kind) {\n\t\tcase \"completed\":\n\t\t\tif (result.exitCode === 0) return { glyph: \"✓\", tone: \"success\", label: \"completed\", detail: \"exit 0\" };\n\t\t\tif (result.exitCode === undefined) return { glyph: \"✗\", tone: \"error\", label: \"ended without an exit code\" };\n\t\t\treturn { glyph: \"✗\", tone: \"error\", label: `exited ${result.exitCode}` };\n\t\tcase \"failed\":\n\t\t\treturn withDetail(\n\t\t\t\t{ glyph: \"✗\", tone: \"error\", label: \"failed\" },\n\t\t\t\tinformativeMessage(result.code, result.message),\n\t\t\t);\n\t\tcase \"cancelled\":\n\t\t\treturn withDetail(\n\t\t\t\t{ glyph: \"○\", tone: \"dim\", label: \"cancelled\" },\n\t\t\t\tresult.cause === \"user\" ? undefined : CANCEL_CAUSE_TEXT[result.cause],\n\t\t\t);\n\t}\n}\n\n/** What happened to a task, as a verb phrase that follows its subject: `exited with code 1`. */\nfunction taskResultPhrase(result: TaskResult): string {\n\tswitch (result.kind) {\n\t\tcase \"completed\":\n\t\t\tif (result.exitCode === 0) return \"completed with exit code 0\";\n\t\t\tif (result.exitCode === undefined) return \"ended without an exit code\";\n\t\t\treturn `exited with code ${result.exitCode}`;\n\t\tcase \"failed\": {\n\t\t\tconst message = informativeMessage(result.code, result.message);\n\t\t\tconst reason = message === undefined ? undefined : withoutTrailingPeriods(message);\n\t\t\treturn `failed (${result.code})${reason ? `: ${reason}` : \"\"}${result.exitCode === undefined ? \"\" : ` (exit code ${result.exitCode})`}`;\n\t\t}\n\t\tcase \"cancelled\":\n\t\t\treturn `was cancelled (${CANCEL_CAUSE_TEXT[result.cause]})`;\n\t}\n}\n\n/** Status line for a `wait` result. `hasOutput` says whether any output is shown below it. */\nexport function waitStatus(observation: WaitOutcome, hasOutput: boolean): TaskStatus {\n\tif (observation.kind === \"settled\") return taskResultStatus(observation.result);\n\treturn withDetail(\n\t\t{ glyph: \"●\", tone: \"warning\", label: \"still running\" },\n\t\thasOutput ? \"showing output so far\" : undefined,\n\t);\n}\n\nfunction waitSentence(observation: WaitOutcome): string {\n\tif (observation.kind === \"yielded\")\n\t\treturn `Task ${observation.taskId} is still running (yielded: ${observation.reason}).`;\n\treturn `Task ${observation.taskId} ${taskResultPhrase(observation.result)}.`;\n}\n\nexport interface WaitResultTail {\n\tobservation: WaitOutcome;\n\ttruncated: boolean;\n\tfullOutputPath?: string;\n}\n\n/**\n * Everything the model reads after a wait's output: the truncation marker, one sentence with the task's state and\n * exit code, and the path of the full output when it was truncated. The renderer strips the same tail.\n */\nexport function waitResultTail({ observation, truncated, fullOutputPath }: WaitResultTail): string {\n\treturn `${truncated ? \"\\n[Output truncated.]\" : \"\"}\\n\\n${waitSentence(observation)}${fullOutputPath ? `\\nFull output: ${fullOutputPath}` : \"\"}`;\n}\n\nfunction cleanupSentence(cleanup: Cleanup): string {\n\tif (cleanup.kind !== \"failed\") return `Cleanup: ${cleanup.kind}.`;\n\tconst resources = cleanup.resources.map(\n\t\t(entry) => `${entry.resource} (${entry.code}): ${withoutTrailingPeriods(firstLine(entry.message))}`,\n\t);\n\treturn `Cleanup failed: ${resources.join(\"; \")}.`;\n}\n\n/** Model-facing text of a `kill` result. The receipt itself stays in the result details. */\nexport function cancelReceiptSentence(receipt: CancelReceipt): string {\n\tconst { taskId, execution } = receipt;\n\tlet lead: string;\n\tif (execution.kind === \"settled\") {\n\t\tconst phrase = taskResultPhrase(execution.result);\n\t\tlead =\n\t\t\treceipt.decision === \"already-settled\"\n\t\t\t\t? `Task ${taskId} had already finished; nothing to stop. It ${phrase}.`\n\t\t\t\t: `Task ${taskId} ${phrase}.`;\n\t} else if (execution.kind === \"cancelling\") {\n\t\tlead = `Cancellation requested for task ${taskId}; it has not stopped yet.`;\n\t} else {\n\t\tlead = `Cancellation requested for task ${taskId}; it is still ${execution.kind}.`;\n\t}\n\treturn `${lead} ${cleanupSentence(receipt.cleanup)}`;\n}\n\n/** Status line for a `kill` result, describing the task rather than the request. */\nexport function cancelReceiptStatus(receipt: CancelReceipt): TaskStatus {\n\tconst { execution } = receipt;\n\tif (execution.kind === \"settled\") {\n\t\tconst status = taskResultStatus(execution.result);\n\t\treturn receipt.decision === \"already-settled\" ? { ...status, label: `already ${status.label}` } : status;\n\t}\n\treturn {\n\t\tglyph: \"●\",\n\t\ttone: \"warning\",\n\t\tlabel: execution.kind === \"cancelling\" ? \"stopping\" : \"still running\",\n\t\tdetail: \"cancellation requested\",\n\t};\n}\n\n/** The first resource that could not be cleaned up, for a status line; undefined when cleanup did not fail. */\nexport function cleanupFailureSummary(cleanup: Cleanup): string | undefined {\n\tif (cleanup.kind !== \"failed\") return undefined;\n\tconst [first, ...rest] = cleanup.resources;\n\tif (!first) return undefined;\n\tconst message = informativeMessage(first.code, first.message);\n\treturn `${first.resource}${message ? `: ${message}` : \"\"}${rest.length ? ` (+${rest.length} more)` : \"\"}`;\n}\n\nexport type TaskToolFailureCode = WaitError[\"code\"] | CancelError[\"code\"] | OutputError[\"code\"] | WatchError[\"code\"];\n\ninterface TaskErrorCopy {\n\t/** Names the id and what went wrong; `detail` is the supervisor's message when it says more than the code. */\n\theadline: (taskId: string, detail: string | undefined) => string;\n\t/** The next step. Shown in the transcript only, not sent to the model. */\n\thint?: string;\n}\n\nconst TASKS_HINT = \"Run /tasks to check on it.\";\n\nconst TASK_ERROR_COPY: Record<TaskToolFailureCode, TaskErrorCopy> = {\n\tUnknownTask: {\n\t\theadline: (taskId) => `No background task \"${taskId}\" in this session`,\n\t\thint: \"It may have finished and been cleaned up, or belong to another session. Run /tasks to see current tasks.\",\n\t},\n\tScopeMismatch: {\n\t\theadline: (taskId) => `Task \"${taskId}\" belongs to another session`,\n\t\thint: \"Run /tasks to see the tasks in this session.\",\n\t},\n\tOwnerClosed: {\n\t\theadline: () => \"This session's background tasks are closed\",\n\t\thint: \"Run the command again to start a new task.\",\n\t},\n\tEnvironmentClosing: { headline: () => \"Atomic is shutting down\" },\n\tObserverCancelled: { headline: (taskId) => `Stopped waiting for task \"${taskId}\"`, hint: TASKS_HINT },\n\tOutputUnavailable: {\n\t\theadline: (taskId) => `Output for task \"${taskId}\" is no longer available`,\n\t\thint: \"Run /tasks to check on the task.\",\n\t},\n\tCleanupFailed: {\n\t\theadline: (taskId, detail) => `Could not stop task \"${taskId}\"${detail ? `: ${detail}` : \"\"}`,\n\t\thint: \"Run /tasks to check whether it is still running.\",\n\t},\n\tStaleGeneration: { headline: () => \"The task list changed while it was being read\", hint: \"Try again.\" },\n};\n\nfunction isTaskToolFailureCode(code: string): code is TaskToolFailureCode {\n\treturn Object.hasOwn(TASK_ERROR_COPY, code);\n}\n\n/**\n * A task failure on the `wait`/`kill` path. The message is `<Code>: <plain-language headline naming the task>`;\n * callers that branch on the failure read `code` instead of parsing it.\n */\nexport class TaskToolError extends Error {\n\treadonly code: TaskToolFailureCode;\n\treadonly taskId: string;\n\n\tconstructor(failure: Failure<TaskToolFailureCode>, taskId: string) {\n\t\tsuper(\n\t\t\t`${failure.code}: ${TASK_ERROR_COPY[failure.code].headline(taskId, informativeMessage(failure.code, failure.message))}`,\n\t\t);\n\t\tthis.name = \"TaskToolError\";\n\t\tthis.code = failure.code;\n\t\tthis.taskId = taskId;\n\t}\n}\n\nexport interface TaskErrorPresentation {\n\theadline: string;\n\thint?: string;\n}\n\n/** How the transcript presents the text of a thrown {@link TaskToolError}; undefined for any other error text. */\nexport function presentTaskError(text: string, taskId: string | undefined): TaskErrorPresentation | undefined {\n\tconst match = /^(\\w+): ([^\\n]*)$/.exec(text.trim());\n\tif (!match) return undefined;\n\tconst [, code, rest] = match;\n\tif (code === undefined || rest === undefined || !isTaskToolFailureCode(code)) return undefined;\n\tconst copy = TASK_ERROR_COPY[code];\n\t// Sessions saved before the message was plain language hold only the code, repeated as the message.\n\tconst headline = rest === code && taskId ? copy.headline(taskId, undefined) : rest;\n\treturn copy.hint ? { headline, hint: copy.hint } : { headline };\n}\n"]}

package/dist/core/tools/structured-output.d.ts

@@ -18,6 +18,11 @@ export interface StructuredOutputToolOptions<TSchemaDef extends TSchema> {
     capture?: StructuredOutputCapture<Static<TSchemaDef>>;
     output?: StructuredOutputFileCapture;
     name?: string;
+    /**
+     * Wall-clock limit in milliseconds for each call's whole decision, covering every repair attempt, transport retry
+     * and model fallback. Defaults to the session's `httpIdleTimeoutMs` setting. The calling model cannot change it.
+     */
+    timeoutMs?: number;
 }
 export declare const StructuredOutputParameters: Type.TObject<{
     instructions: Type.TString;

package/dist/core/tools/structured-output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structured-output.d.ts","sourceRoot":"","sources":["../../../src/core/tools/structured-output.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEzE,eAAO,MAAM,2BAA2B,sBAAsB,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,EAAE,CAAC;AACjE,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE/D,MAAM,WAAW,uBAAuB,CAAC,MAAM,GAAG,OAAO;IACxD,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC3C,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B,CAAC,UAAU,SAAS,OAAO;IACtE,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,uBAAuB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IACtD,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,0BAA0B;;;;;EAyBtC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AA6B/E,wBAAgB,6BAA6B,CAAC,MAAM,GAAG,OAAO,KAAK,uBAAuB,CAAC,MAAM,CAAC,CAEjG;AAED,wBAAgB,0BAA0B,CAAC,UAAU,SAAS,OAAO,EACpE,OAAO,EAAE,2BAA2B,CAAC,UAAU,CAAC,GAC9C,cAAc,CAAC,OAAO,0BAA0B,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CA8CvE"}
+{"version":3,"file":"structured-output.d.ts","sourceRoot":"","sources":["../../../src/core/tools/structured-output.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGzE,eAAO,MAAM,2BAA2B,sBAAsB,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,EAAE,CAAC;AACjE,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE/D,MAAM,WAAW,uBAAuB,CAAC,MAAM,GAAG,OAAO;IACxD,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC3C,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B,CAAC,UAAU,SAAS,OAAO;IACtE,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,uBAAuB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IACtD,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,0BAA0B;;;;;EAyBtC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AA6B/E,wBAAgB,6BAA6B,CAAC,MAAM,GAAG,OAAO,KAAK,uBAAuB,CAAC,MAAM,CAAC,CAEjG;AAED,wBAAgB,0BAA0B,CAAC,UAAU,SAAS,OAAO,EACpE,OAAO,EAAE,2BAA2B,CAAC,UAAU,CAAC,GAC9C,cAAc,CAAC,OAAO,0BAA0B,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAgDvE"}

package/dist/core/tools/structured-output.js

@@ -2,6 +2,7 @@ import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import { Type } from "typebox";
 import { defineTool } from "../extensions/types.js";
+import { resolveDecisionDeadlineMs, validateTimeoutOverride } from "../structured-output/deadline.js";
 export const STRUCTURED_OUTPUT_TOOL_NAME = "structured_output";
 export const StructuredOutputParameters = Type.Object({
     instructions: Type.String({ minLength: 1, description: "Complete judgment instructions for the result." }),
@@ -44,6 +45,7 @@ export function createStructuredOutputCapture() {
 }
 export function createStructuredOutputTool(options) {
     const name = options.name ?? STRUCTURED_OUTPUT_TOOL_NAME;
+    validateTimeoutOverride(options.timeoutMs);
     return defineTool({
         name,
         label: "Structured Output",
@@ -67,6 +69,7 @@ export function createStructuredOutputTool(options) {
                 ...(params.fallbackModels !== undefined ? { fallbackModels: params.fallbackModels } : {}),
                 currentModel: ctx.model,
                 modelRegistry: ctx.modelRegistry,
+                timeoutMs: resolveDecisionDeadlineMs(options.timeoutMs, ctx.getHttpIdleTimeoutMs?.()),
                 ...(signal ? { signal } : {}),
             });
             const value = result.value;

package/dist/core/tools/structured-output.js.map

@@ -1 +1 @@
-{"version":3,"file":"structured-output.js","sourceRoot":"","sources":["../../../src/core/tools/structured-output.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport type { AgentToolResult } from \"@earendil-works/pi-agent-core\";\nimport { type Static, type TSchema, Type } from \"typebox\";\nimport { defineTool, type ToolDefinition } from \"../extensions/types.ts\";\n\nexport const STRUCTURED_OUTPUT_TOOL_NAME = \"structured_output\";\n\nexport type JsonPrimitive = string | number | boolean | null;\nexport type JsonValue = JsonPrimitive | JsonObject | JsonValue[];\nexport type JsonObject = { readonly [key: string]: JsonValue };\n\nexport interface StructuredOutputCapture<TValue = unknown> {\n\tvalue: TValue | undefined;\n\tcalled: boolean;\n}\n\nexport interface StructuredOutputFileCapture {\n\toutputPath: string;\n}\n\nexport interface StructuredOutputToolOptions<TSchemaDef extends TSchema> {\n\tschema: TSchemaDef;\n\tcapture?: StructuredOutputCapture<Static<TSchemaDef>>;\n\toutput?: StructuredOutputFileCapture;\n\tname?: string;\n}\n\nexport const StructuredOutputParameters = Type.Object(\n\t{\n\t\tinstructions: Type.String({ minLength: 1, description: \"Complete judgment instructions for the result.\" }),\n\t\tstate: Type.Object(\n\t\t\t{},\n\t\t\t{\n\t\t\t\tadditionalProperties: true,\n\t\t\t\tminProperties: 1,\n\t\t\t\tdescription:\n\t\t\t\t\t\"Named finite JSON values holding the task, relevant context, constraints and reference text. Never include secrets.\",\n\t\t\t},\n\t\t),\n\t\tmodel: Type.Optional(\n\t\t\tType.String({\n\t\t\t\tdescription:\n\t\t\t\t\t\"Exact provider/model ID of a chat or classifier model, such as typesafe/jev-latest. Omit to use the current chat model.\",\n\t\t\t}),\n\t\t),\n\t\tfallbackModels: Type.Optional(\n\t\t\tType.Array(Type.String(), {\n\t\t\t\tdescription: \"Ordered exact fallback model IDs. The current chat model is always tried last.\",\n\t\t\t}),\n\t\t),\n\t},\n\t{ additionalProperties: false },\n);\nexport type StructuredOutputParams = Static<typeof StructuredOutputParameters>;\n\nfunction stringifyParams<TSchemaDef extends TSchema>(params: Static<TSchemaDef>): string {\n\ttry {\n\t\treturn JSON.stringify(params, null, 2);\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Structured output must be JSON-serializable: ${error instanceof Error ? error.message : String(error)}`,\n\t\t);\n\t}\n}\n\nasync function writePrivateJsonFile(filePath: string, serializedJson: string): Promise<void> {\n\tawait fs.mkdir(path.dirname(filePath), { recursive: true });\n\tawait fs.writeFile(filePath, serializedJson, { mode: 0o600 });\n\t// Re-apply the private mode after writing so pre-existing looser files are tightened too.\n\tawait fs.chmod(filePath, 0o600);\n}\n\nasync function writeCapturedOutput(output: StructuredOutputFileCapture, serializedParams: string): Promise<void> {\n\ttry {\n\t\tawait writePrivateJsonFile(output.outputPath, serializedParams);\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Failed to write structured output capture: ${error instanceof Error ? error.message : String(error)}`,\n\t\t);\n\t}\n}\n\nexport function createStructuredOutputCapture<TValue = unknown>(): StructuredOutputCapture<TValue> {\n\treturn { value: undefined, called: false };\n}\n\nexport function createStructuredOutputTool<TSchemaDef extends TSchema>(\n\toptions: StructuredOutputToolOptions<TSchemaDef>,\n): ToolDefinition<typeof StructuredOutputParameters, Static<TSchemaDef>> {\n\tconst name = options.name ?? STRUCTURED_OUTPUT_TOOL_NAME;\n\n\treturn defineTool({\n\t\tname,\n\t\tlabel: \"Structured Output\",\n\t\tdescription:\n\t\t\t\"Infer the final machine-readable result from instructions and named state using the selected model, then any fallbacks, then the current chat model.\",\n\t\tpromptSnippet: \"Return final machine-readable output\",\n\t\tpromptGuidelines: [\n\t\t\t`${name} is the final machine-readable result channel; call ${name} exactly once when done.`,\n\t\t\t\"Pass complete instructions and named state; omit model to use the current chat model.\",\n\t\t\t`Do not write a prose final answer after calling ${name}.`,\n\t\t],\n\t\tparameters: StructuredOutputParameters,\n\t\tmaxResultSizeChars: Infinity,\n\t\tstructuredOutput: true,\n\t\tasync execute(_toolCallId, params, signal, _onUpdate, ctx): Promise<AgentToolResult<Static<TSchemaDef>>> {\n\t\t\tconst { generateStructuredOutput } = await import(\"../structured-output/index.js\");\n\t\t\tconst result = await generateStructuredOutput({\n\t\t\t\tschema: options.schema,\n\t\t\t\tinstructions: params.instructions,\n\t\t\t\tstate: params.state as JsonObject,\n\t\t\t\t...(params.model !== undefined ? { model: params.model } : {}),\n\t\t\t\t...(params.fallbackModels !== undefined ? { fallbackModels: params.fallbackModels } : {}),\n\t\t\t\tcurrentModel: ctx.model,\n\t\t\t\tmodelRegistry: ctx.modelRegistry,\n\t\t\t\t...(signal ? { signal } : {}),\n\t\t\t});\n\t\t\tconst value = result.value;\n\t\t\tconst serializedValue = stringifyParams(value);\n\t\t\tif (options.output) {\n\t\t\t\tawait writeCapturedOutput(options.output, serializedValue);\n\t\t\t}\n\t\t\tif (options.capture) {\n\t\t\t\toptions.capture.value = value;\n\t\t\t\toptions.capture.called = true;\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: serializedValue }],\n\t\t\t\tdetails: value,\n\t\t\t\tterminate: true,\n\t\t\t};\n\t\t},\n\t});\n}\n"]}
+{"version":3,"file":"structured-output.js","sourceRoot":"","sources":["../../../src/core/tools/structured-output.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport type { AgentToolResult } from \"@earendil-works/pi-agent-core\";\nimport { type Static, type TSchema, Type } from \"typebox\";\nimport { defineTool, type ToolDefinition } from \"../extensions/types.ts\";\nimport { resolveDecisionDeadlineMs, validateTimeoutOverride } from \"../structured-output/deadline.js\";\n\nexport const STRUCTURED_OUTPUT_TOOL_NAME = \"structured_output\";\n\nexport type JsonPrimitive = string | number | boolean | null;\nexport type JsonValue = JsonPrimitive | JsonObject | JsonValue[];\nexport type JsonObject = { readonly [key: string]: JsonValue };\n\nexport interface StructuredOutputCapture<TValue = unknown> {\n\tvalue: TValue | undefined;\n\tcalled: boolean;\n}\n\nexport interface StructuredOutputFileCapture {\n\toutputPath: string;\n}\n\nexport interface StructuredOutputToolOptions<TSchemaDef extends TSchema> {\n\tschema: TSchemaDef;\n\tcapture?: StructuredOutputCapture<Static<TSchemaDef>>;\n\toutput?: StructuredOutputFileCapture;\n\tname?: string;\n\t/**\n\t * Wall-clock limit in milliseconds for each call's whole decision, covering every repair attempt, transport retry\n\t * and model fallback. Defaults to the session's `httpIdleTimeoutMs` setting. The calling model cannot change it.\n\t */\n\ttimeoutMs?: number;\n}\n\nexport const StructuredOutputParameters = Type.Object(\n\t{\n\t\tinstructions: Type.String({ minLength: 1, description: \"Complete judgment instructions for the result.\" }),\n\t\tstate: Type.Object(\n\t\t\t{},\n\t\t\t{\n\t\t\t\tadditionalProperties: true,\n\t\t\t\tminProperties: 1,\n\t\t\t\tdescription:\n\t\t\t\t\t\"Named finite JSON values holding the task, relevant context, constraints and reference text. Never include secrets.\",\n\t\t\t},\n\t\t),\n\t\tmodel: Type.Optional(\n\t\t\tType.String({\n\t\t\t\tdescription:\n\t\t\t\t\t\"Exact provider/model ID of a chat or classifier model, such as typesafe/jev-latest. Omit to use the current chat model.\",\n\t\t\t}),\n\t\t),\n\t\tfallbackModels: Type.Optional(\n\t\t\tType.Array(Type.String(), {\n\t\t\t\tdescription: \"Ordered exact fallback model IDs. The current chat model is always tried last.\",\n\t\t\t}),\n\t\t),\n\t},\n\t{ additionalProperties: false },\n);\nexport type StructuredOutputParams = Static<typeof StructuredOutputParameters>;\n\nfunction stringifyParams<TSchemaDef extends TSchema>(params: Static<TSchemaDef>): string {\n\ttry {\n\t\treturn JSON.stringify(params, null, 2);\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Structured output must be JSON-serializable: ${error instanceof Error ? error.message : String(error)}`,\n\t\t);\n\t}\n}\n\nasync function writePrivateJsonFile(filePath: string, serializedJson: string): Promise<void> {\n\tawait fs.mkdir(path.dirname(filePath), { recursive: true });\n\tawait fs.writeFile(filePath, serializedJson, { mode: 0o600 });\n\t// Re-apply the private mode after writing so pre-existing looser files are tightened too.\n\tawait fs.chmod(filePath, 0o600);\n}\n\nasync function writeCapturedOutput(output: StructuredOutputFileCapture, serializedParams: string): Promise<void> {\n\ttry {\n\t\tawait writePrivateJsonFile(output.outputPath, serializedParams);\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Failed to write structured output capture: ${error instanceof Error ? error.message : String(error)}`,\n\t\t);\n\t}\n}\n\nexport function createStructuredOutputCapture<TValue = unknown>(): StructuredOutputCapture<TValue> {\n\treturn { value: undefined, called: false };\n}\n\nexport function createStructuredOutputTool<TSchemaDef extends TSchema>(\n\toptions: StructuredOutputToolOptions<TSchemaDef>,\n): ToolDefinition<typeof StructuredOutputParameters, Static<TSchemaDef>> {\n\tconst name = options.name ?? STRUCTURED_OUTPUT_TOOL_NAME;\n\tvalidateTimeoutOverride(options.timeoutMs);\n\n\treturn defineTool({\n\t\tname,\n\t\tlabel: \"Structured Output\",\n\t\tdescription:\n\t\t\t\"Infer the final machine-readable result from instructions and named state using the selected model, then any fallbacks, then the current chat model.\",\n\t\tpromptSnippet: \"Return final machine-readable output\",\n\t\tpromptGuidelines: [\n\t\t\t`${name} is the final machine-readable result channel; call ${name} exactly once when done.`,\n\t\t\t\"Pass complete instructions and named state; omit model to use the current chat model.\",\n\t\t\t`Do not write a prose final answer after calling ${name}.`,\n\t\t],\n\t\tparameters: StructuredOutputParameters,\n\t\tmaxResultSizeChars: Infinity,\n\t\tstructuredOutput: true,\n\t\tasync execute(_toolCallId, params, signal, _onUpdate, ctx): Promise<AgentToolResult<Static<TSchemaDef>>> {\n\t\t\tconst { generateStructuredOutput } = await import(\"../structured-output/index.js\");\n\t\t\tconst result = await generateStructuredOutput({\n\t\t\t\tschema: options.schema,\n\t\t\t\tinstructions: params.instructions,\n\t\t\t\tstate: params.state as JsonObject,\n\t\t\t\t...(params.model !== undefined ? { model: params.model } : {}),\n\t\t\t\t...(params.fallbackModels !== undefined ? { fallbackModels: params.fallbackModels } : {}),\n\t\t\t\tcurrentModel: ctx.model,\n\t\t\t\tmodelRegistry: ctx.modelRegistry,\n\t\t\t\ttimeoutMs: resolveDecisionDeadlineMs(options.timeoutMs, ctx.getHttpIdleTimeoutMs?.()),\n\t\t\t\t...(signal ? { signal } : {}),\n\t\t\t});\n\t\t\tconst value = result.value;\n\t\t\tconst serializedValue = stringifyParams(value);\n\t\t\tif (options.output) {\n\t\t\t\tawait writeCapturedOutput(options.output, serializedValue);\n\t\t\t}\n\t\t\tif (options.capture) {\n\t\t\t\toptions.capture.value = value;\n\t\t\t\toptions.capture.called = true;\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: serializedValue }],\n\t\t\t\tdetails: value,\n\t\t\t\tterminate: true,\n\t\t\t};\n\t\t},\n\t});\n}\n"]}