@astralyn/pi 1.4.10 → 1.5.0

package/dist/core/tools/shell-execution.js

@@ -1,214 +1,196 @@
+/**
+ * Runs the native shell tool body (`bash.ts`) as one session task. The native body owns the
+ * process, progress, output formatting and structured result; this adapter only supplies the
+ * task's output log, its background limits and acceptance, and translates the native outcome
+ * into a task completion.
+ */
 import { unlink } from "node:fs/promises";
 import { boundText } from "../tasks/output.js";
+import { resolveTimeoutMs } from "./bash.js";
 import { OutputAccumulator } from "./output-accumulator.js";
-import { BASH_UPDATE_THROTTLE_MS } from "./renderers/bash.js";
-import { formatSize } from "./truncate.js";
 export const MAX_BACKGROUND_OUTPUT_BYTES = 20 * 1024 * 1024;
-/** Interpret the documented BashOperations error markers once, before formatting output. */
-function shellFailure(error) {
-    if (error instanceof Error && error.message === "aborted")
-        return { status: "cancelled", error: "Command aborted" };
-    if (error instanceof Error && error.message.startsWith("timeout:"))
-        return { status: "timeout", error: `Command timed out after ${error.message.split(":")[1]} seconds` };
-    return { status: "failed", error: boundText(error instanceof Error ? error.message : String(error), 4096) };
-}
-function formatOutput(output, snapshot, taskLog, emptyText) {
-    const truncation = snapshot.truncation;
-    let text = snapshot.content || emptyText;
-    let details = taskLog ? { fullOutputPath: snapshot.fullOutputPath } : undefined;
-    if (truncation.truncated) {
-        details = { truncation, fullOutputPath: snapshot.fullOutputPath };
-        const startLine = truncation.totalLines - truncation.outputLines + 1;
-        const endLine = truncation.totalLines;
-        if (truncation.lastLinePartial) {
-            const lastLineSize = formatSize(output.getLastLineBytes());
-            text += `\n\n[Showing last ${formatSize(truncation.outputBytes)} of line ${endLine} (line is ${lastLineSize}). Full output: ${snapshot.fullOutputPath}]`;
-        }
-        else if (truncation.truncatedBy === "lines") {
-            text += `\n\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines}. Full output: ${snapshot.fullOutputPath}]`;
-        }
-        else {
-            text += `\n\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines} (${formatSize(truncation.maxBytes)} limit). Full output: ${snapshot.fullOutputPath}]`;
-        }
+/** Background snapshots stay within the task result budget, so the bounded result keeps the newest output. */
+const BACKGROUND_SNAPSHOT_BYTES = 40 * 1024;
+const OUTPUT_LIMIT_ERROR = "Background command exceeded the 20 MiB output limit";
+/**
+ * A session task's output: persisted from the first byte to the log attached to the task, and
+ * bounded once the task is background work. A write failure or the background cap cancels the
+ * task instead of throwing through the process's data observer.
+ */
+class TaskOutput extends OutputAccumulator {
+    constructor(control, options) {
+        super({ ...options, persistFromStart: true });
+        this.control = control;
     }
-    return { text, details };
-}
-/** One process and one output owner across foreground/background handoff. */
-export async function runShellCommand(options) {
-    const { operations, context, control, taskLog, timeout } = options;
-    const signal = control.signal;
-    const output = new OutputAccumulator({ tempFilePrefix: options.tempFilePrefix, persistFromStart: taskLog });
-    const startedAt = performance.now();
-    let outputError;
-    let acceptingOutput = true;
-    let unsubscribe;
-    let updateTimer;
-    let updateDirty = false;
-    let lastUpdateAt = 0;
-    const failOutput = (error) => {
-        if (outputError)
+    append(data) {
+        if (this.error)
             return;
-        outputError = error instanceof Error ? error : new Error(String(error));
         try {
-            control.cancel();
-        }
-        catch {
-            // Late data must not throw through a process observer.
-        }
-    };
-    const checkOutputLimit = () => {
-        if (control.mode === "background" && output.getTotalBytes() > MAX_BACKGROUND_OUTPUT_BYTES) {
-            failOutput(new Error("Background command exceeded the 20 MiB output limit"));
-        }
-    };
-    const snapshot = () => output.snapshot({
-        persistIfTruncated: true,
-        maxBytes: control.mode === "background" ? 40 * 1024 : undefined,
-    });
-    const publish = (snapshot) => {
-        const result = {
-            content: snapshot ? [{ type: "text", text: snapshot.content }] : [],
-            details: snapshot
-                ? {
-                    truncation: snapshot.truncation.truncated ? snapshot.truncation : undefined,
-                    fullOutputPath: snapshot.fullOutputPath,
-                }
-                : undefined,
-        };
-        control.publish({ result });
-    };
-    const emitOutputUpdate = () => {
-        if (!updateDirty)
-            return;
-        updateDirty = false;
-        lastUpdateAt = Date.now();
-        publish(snapshot());
-    };
-    const clearUpdateTimer = () => {
-        if (updateTimer)
-            clearTimeout(updateTimer);
-        updateTimer = undefined;
-    };
-    const scheduleOutputUpdate = () => {
-        updateDirty = true;
-        const delay = BASH_UPDATE_THROTTLE_MS - (Date.now() - lastUpdateAt);
-        if (delay <= 0) {
-            clearUpdateTimer();
-            emitOutputUpdate();
+            const room = MAX_BACKGROUND_OUTPUT_BYTES - this.getTotalBytes();
+            if (this.control.mode === "background" && data.length > room) {
+                super.append(data.subarray(0, Math.max(0, room)));
+                this.fail(new Error(OUTPUT_LIMIT_ERROR));
+            }
+            else
+                super.append(data);
         }
-        else {
-            updateTimer ??= setTimeout(() => {
-                updateTimer = undefined;
-                emitOutputUpdate();
-            }, delay);
+        catch (error) {
+            this.fail(error);
         }
-    };
-    const handleData = (data) => {
-        if (!acceptingOutput || outputError)
+    }
+    snapshot(options = {}) {
+        return super.snapshot(this.control.mode === "background" ? { ...options, maxBytes: BACKGROUND_SNAPSHOT_BYTES } : options);
+    }
+    /** A detach must check output written while in the foreground, preserving it. */
+    checkLimit() {
+        if (this.control.mode === "background" && this.getTotalBytes() > MAX_BACKGROUND_OUTPUT_BYTES)
+            this.fail(new Error(OUTPUT_LIMIT_ERROR));
+    }
+    fail(error) {
+        if (this.error)
             return;
+        this.error = error instanceof Error ? error : new Error(String(error));
         try {
-            if (control.mode === "background" && output.getTotalBytes() + data.length > MAX_BACKGROUND_OUTPUT_BYTES) {
-                const remaining = Math.max(0, MAX_BACKGROUND_OUTPUT_BYTES - output.getTotalBytes());
-                output.append(data.subarray(0, remaining));
-                failOutput(new Error("Background command exceeded the 20 MiB output limit"));
-            }
-            else
-                output.append(data);
-            scheduleOutputUpdate();
+            this.control.cancel();
         }
-        catch (error) {
-            failOutput(error);
+        catch {
+            // Late data must not throw through a process observer.
         }
+    }
+}
+/** Interpret the documented BashOperations error markers and exit codes as the native body states them. */
+function processFailure(outcome) {
+    const { error, exitCode } = outcome;
+    if (error instanceof Error && error.message === "aborted")
+        return { status: "cancelled", error: "Command aborted" };
+    if (error instanceof Error && error.message.startsWith("timeout:"))
+        return { status: "timeout", error: `Command timed out after ${error.message.split(":")[1]} seconds` };
+    if (error !== undefined)
+        return { status: "failed", error: errorMessage(error) };
+    if (exitCode === null)
+        return { status: "failed", error: "Command terminated without an exit code" };
+    if (exitCode !== undefined && exitCode !== 0)
+        return { status: "failed", error: `Command exited with code ${exitCode}` };
+    return undefined;
+}
+function errorMessage(error) {
+    return boundText(error instanceof Error ? error.message : String(error), 4096);
+}
+/** The native body appends its failure status to the output; a task keeps them apart. */
+function withoutStatus(text, status) {
+    if (text === status)
+        return "";
+    const suffix = `\n\n${status}`;
+    return text.endsWith(suffix) ? text.slice(0, -suffix.length) : text;
+}
+function resultText(result) {
+    return result.content
+        .filter((part) => part.type === "text")
+        .map((part) => part.text)
+        .join("\n");
+}
+/**
+ * One process and one output owner across foreground/background handoff. The task result holds
+ * the command's output only; its failure is the completion's `error`.
+ */
+export async function runShellTask(options) {
+    const { control } = options;
+    if (control.signal.aborted)
+        throw new Error("Command aborted");
+    resolveTimeoutMs(options.timeout);
+    const output = new TaskOutput(control, { tempFilePrefix: options.tempFilePrefix });
+    const path = output.snapshot().fullOutputPath;
+    const cleanup = async () => {
+        await output.closeTempFile();
+        await unlink(path).catch((error) => {
+            if (error.code !== "ENOENT")
+                throw error;
+        });
     };
     try {
-        if (taskLog) {
-            const path = output.snapshot().fullOutputPath;
-            const cleanup = async () => {
-                await output.closeTempFile();
-                await unlink(path).catch((error) => {
-                    if (error.code !== "ENOENT")
-                        throw error;
-                });
-            };
+        control.attachOutput(path, cleanup);
+    }
+    catch (error) {
+        await cleanup();
+        throw error;
+    }
+    const unsubscribe = control.onModeChange(() => output.checkLimit());
+    const spawned = {};
+    const operations = {
+        exec: (command, cwd, execOptions) => {
+            let running;
             try {
-                control.attachOutput(path, cleanup);
+                running = options.operations.exec(command, cwd, execOptions);
             }
             catch (error) {
-                await cleanup();
+                spawned.error = error;
                 throw error;
             }
-        }
-        // Detach must check a silent foreground log too, preserving bytes already written.
-        unsubscribe = control.onModeChange(checkOutputLimit);
-        publish();
-        let failure;
-        let exitCode;
+            // The process exists, so a handoff can no longer start it twice.
+            control.accept();
+            return running.then((result) => {
+                spawned.exitCode = result.exitCode;
+                return result;
+            }, (error) => {
+                spawned.error = error;
+                throw error;
+            });
+        },
+    };
+    let result;
+    let thrown;
+    try {
         try {
-            if (signal?.aborted)
-                throw new Error("aborted");
-            const execution = operations.exec(context.command, context.cwd, {
-                onData: handleData,
-                signal,
-                timeout,
-                env: context.env,
+            result = await options.execute({
+                createOutput: () => output,
+                operations,
+                onUpdate: (update) => control.publish({ result: update }),
             });
-            control.accept();
-            ({ exitCode } = await execution);
-            if (exitCode === null) {
-                failure = { status: "failed", error: "Command terminated without an exit code" };
-            }
-            else if (exitCode !== 0) {
-                failure = { status: "failed", error: `Command exited with code ${exitCode}` };
-            }
         }
         catch (error) {
-            failure = shellFailure(error);
+            thrown = error;
         }
-        acceptingOutput = false;
-        output.finish();
-        clearUpdateTimer();
-        if (taskLog)
-            publish(snapshot());
-        else
-            emitOutputUpdate();
-        const final = snapshot();
-        await output.closeTempFile();
-        // Final progress/cleanup can re-enter handoff. Classify policy cancellation
-        // after those callbacks, independently of the process's abort marker.
-        if (outputError)
-            failure = { status: "failed", error: boundText(outputError.message, 4096) };
-        const { text, details } = formatOutput(output, final, taskLog, failure ? "" : "(no output)");
-        const fullOutput = typeof exitCode === "number" && !outputError ? await output.readFullOutput(1024 * 1024) : undefined;
-        return {
-            status: failure?.status,
-            error: failure?.error,
-            ...(exitCode !== undefined ? { facts: [["Exit", exitCode === null ? "signal" : String(exitCode)]] } : {}),
-            result: {
-                ...(fullOutput && typeof exitCode === "number"
-                    ? {
-                        structuredContent: {
-                            output: fullOutput.content,
-                            truncated: fullOutput.truncated,
-                            ...(fullOutput.truncated && final.fullOutputPath
-                                ? { full_output_path: final.fullOutputPath }
-                                : {}),
-                            exit_code: exitCode,
-                            wall_time_seconds: Math.round((performance.now() - startedAt) / 100) / 10,
-                        },
-                        ...(failure ? { isError: true } : {}),
-                    }
-                    : {}),
-                // The command's output only: its failure is the completion's `error`, composed where a result is shown.
-                content: [{ type: "text", text }],
-                details,
-            },
-        };
     }
     finally {
-        acceptingOutput = false;
-        unsubscribe?.();
-        clearUpdateTimer();
+        unsubscribe();
         await output.closeTempFile();
     }
+    return shellCompletion(output, path, spawned, result, thrown);
+}
+function shellCompletion(output, path, spawned, result, thrown) {
+    const started = "exitCode" in spawned || "error" in spawned;
+    const failure = processFailure(spawned) ?? (thrown === undefined ? undefined : { status: "failed", error: errorMessage(thrown) });
+    // The native result or error carries the formatted output; a raw operations error carries none.
+    const formatted = result !== undefined
+        ? resultText(result)
+        : thrown instanceof Error && thrown !== spawned.error && started
+            ? thrown.message
+            : started
+                ? output.snapshot().content
+                : "";
+    const text = failure ? withoutStatus(formatted, failure.error) : formatted;
+    const truncation = output.snapshot().truncation;
+    const details = {
+        ...(result?.details ?? (truncation.truncated ? { truncation } : {})),
+        fullOutputPath: path,
+    };
+    // A cancellation the output policy caused is that policy's failure, not the process's abort.
+    const policy = output.error ? { status: "failed", error: errorMessage(output.error) } : undefined;
+    const settled = policy ?? failure;
+    const keepStructured = result?.structuredContent !== undefined && !policy;
+    return {
+        status: settled?.status,
+        error: settled?.error,
+        ...(spawned.exitCode !== undefined
+            ? { facts: [["Exit", spawned.exitCode === null ? "signal" : String(spawned.exitCode)]] }
+            : {}),
+        result: {
+            ...(keepStructured
+                ? { structuredContent: result.structuredContent, ...(settled ? { isError: true } : {}) }
+                : {}),
+            content: [{ type: "text", text }],
+            details,
+        },
+    };
 }
 //# sourceMappingURL=shell-execution.js.map

package/dist/core/tools/shell-execution.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell-execution.js","sourceRoot":"","sources":["../../../src/core/tools/shell-execution.ts"],"names":[],"mappings":"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","sourcesContent":["import { unlink } from \"node:fs/promises\";\nimport type { AgentToolResult } from \"@earendil-works/pi-agent-core\";\nimport { boundText } from \"../tasks/output.ts\";\nimport type { TaskCompletion, TaskControl } from \"../tasks/types.ts\";\nimport type { BashOperations, BashSpawnContext } from \"./bash.ts\";\nimport { OutputAccumulator, type OutputSnapshot } from \"./output-accumulator.ts\";\nimport { BASH_UPDATE_THROTTLE_MS } from \"./renderers/bash.ts\";\nimport type { BashToolDetails } from \"./shell-tool.ts\";\nimport { formatSize } from \"./truncate.ts\";\n\nexport const MAX_BACKGROUND_OUTPUT_BYTES = 20 * 1024 * 1024;\n\ninterface ShellExecutionOptions {\n\toperations: BashOperations;\n\tcontext: BashSpawnContext;\n\ttempFilePrefix: string;\n\ttimeout?: number;\n\t/** The task this command runs as; its signal cancels the process. */\n\tcontrol: TaskControl<BashToolDetails | undefined>;\n\t/**\n\t * The command belongs to a session task, which may leave the foreground: its output log is\n\t * created and attached to the task from the first byte, and a final snapshot is always\n\t * published. Otherwise the log is created only if output is truncated.\n\t */\n\ttaskLog: boolean;\n}\n\ninterface ShellFailure {\n\tstatus: \"failed\" | \"cancelled\" | \"timeout\";\n\terror: string;\n}\n\n/** Interpret the documented BashOperations error markers once, before formatting output. */\nfunction shellFailure(error: unknown): ShellFailure {\n\tif (error instanceof Error && error.message === \"aborted\") return { status: \"cancelled\", error: \"Command aborted\" };\n\tif (error instanceof Error && error.message.startsWith(\"timeout:\"))\n\t\treturn { status: \"timeout\", error: `Command timed out after ${error.message.split(\":\")[1]} seconds` };\n\treturn { status: \"failed\", error: boundText(error instanceof Error ? error.message : String(error), 4096) };\n}\n\nfunction formatOutput(\n\toutput: OutputAccumulator,\n\tsnapshot: OutputSnapshot,\n\ttaskLog: boolean,\n\temptyText: string,\n): { text: string; details: BashToolDetails | undefined } {\n\tconst truncation = snapshot.truncation;\n\tlet text = snapshot.content || emptyText;\n\tlet details: BashToolDetails | undefined = taskLog ? { fullOutputPath: snapshot.fullOutputPath } : undefined;\n\tif (truncation.truncated) {\n\t\tdetails = { truncation, fullOutputPath: snapshot.fullOutputPath };\n\t\tconst startLine = truncation.totalLines - truncation.outputLines + 1;\n\t\tconst endLine = truncation.totalLines;\n\t\tif (truncation.lastLinePartial) {\n\t\t\tconst lastLineSize = formatSize(output.getLastLineBytes());\n\t\t\ttext += `\\n\\n[Showing last ${formatSize(truncation.outputBytes)} of line ${endLine} (line is ${lastLineSize}). Full output: ${snapshot.fullOutputPath}]`;\n\t\t} else if (truncation.truncatedBy === \"lines\") {\n\t\t\ttext += `\\n\\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines}. Full output: ${snapshot.fullOutputPath}]`;\n\t\t} else {\n\t\t\ttext += `\\n\\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines} (${formatSize(truncation.maxBytes)} limit). Full output: ${snapshot.fullOutputPath}]`;\n\t\t}\n\t}\n\treturn { text, details };\n}\n\n/** One process and one output owner across foreground/background handoff. */\nexport async function runShellCommand(\n\toptions: ShellExecutionOptions,\n): Promise<TaskCompletion<BashToolDetails | undefined>> {\n\tconst { operations, context, control, taskLog, timeout } = options;\n\tconst signal = control.signal;\n\tconst output = new OutputAccumulator({ tempFilePrefix: options.tempFilePrefix, persistFromStart: taskLog });\n\tconst startedAt = performance.now();\n\tlet outputError: Error | undefined;\n\tlet acceptingOutput = true;\n\tlet unsubscribe: (() => void) | undefined;\n\tlet updateTimer: NodeJS.Timeout | undefined;\n\tlet updateDirty = false;\n\tlet lastUpdateAt = 0;\n\n\tconst failOutput = (error: unknown) => {\n\t\tif (outputError) return;\n\t\toutputError = error instanceof Error ? error : new Error(String(error));\n\t\ttry {\n\t\t\tcontrol.cancel();\n\t\t} catch {\n\t\t\t// Late data must not throw through a process observer.\n\t\t}\n\t};\n\tconst checkOutputLimit = () => {\n\t\tif (control.mode === \"background\" && output.getTotalBytes() > MAX_BACKGROUND_OUTPUT_BYTES) {\n\t\t\tfailOutput(new Error(\"Background command exceeded the 20 MiB output limit\"));\n\t\t}\n\t};\n\tconst snapshot = () =>\n\t\toutput.snapshot({\n\t\t\tpersistIfTruncated: true,\n\t\t\tmaxBytes: control.mode === \"background\" ? 40 * 1024 : undefined,\n\t\t});\n\tconst publish = (snapshot?: OutputSnapshot) => {\n\t\tconst result: AgentToolResult<BashToolDetails | undefined> = {\n\t\t\tcontent: snapshot ? [{ type: \"text\", text: snapshot.content }] : [],\n\t\t\tdetails: snapshot\n\t\t\t\t? {\n\t\t\t\t\t\ttruncation: snapshot.truncation.truncated ? snapshot.truncation : undefined,\n\t\t\t\t\t\tfullOutputPath: snapshot.fullOutputPath,\n\t\t\t\t\t}\n\t\t\t\t: undefined,\n\t\t};\n\t\tcontrol.publish({ result });\n\t};\n\tconst emitOutputUpdate = () => {\n\t\tif (!updateDirty) return;\n\t\tupdateDirty = false;\n\t\tlastUpdateAt = Date.now();\n\t\tpublish(snapshot());\n\t};\n\tconst clearUpdateTimer = () => {\n\t\tif (updateTimer) clearTimeout(updateTimer);\n\t\tupdateTimer = undefined;\n\t};\n\tconst scheduleOutputUpdate = () => {\n\t\tupdateDirty = true;\n\t\tconst delay = BASH_UPDATE_THROTTLE_MS - (Date.now() - lastUpdateAt);\n\t\tif (delay <= 0) {\n\t\t\tclearUpdateTimer();\n\t\t\temitOutputUpdate();\n\t\t} else {\n\t\t\tupdateTimer ??= setTimeout(() => {\n\t\t\t\tupdateTimer = undefined;\n\t\t\t\temitOutputUpdate();\n\t\t\t}, delay);\n\t\t}\n\t};\n\tconst handleData = (data: Buffer) => {\n\t\tif (!acceptingOutput || outputError) return;\n\t\ttry {\n\t\t\tif (control.mode === \"background\" && output.getTotalBytes() + data.length > MAX_BACKGROUND_OUTPUT_BYTES) {\n\t\t\t\tconst remaining = Math.max(0, MAX_BACKGROUND_OUTPUT_BYTES - output.getTotalBytes());\n\t\t\t\toutput.append(data.subarray(0, remaining));\n\t\t\t\tfailOutput(new Error(\"Background command exceeded the 20 MiB output limit\"));\n\t\t\t} else output.append(data);\n\t\t\tscheduleOutputUpdate();\n\t\t} catch (error) {\n\t\t\tfailOutput(error);\n\t\t}\n\t};\n\n\ttry {\n\t\tif (taskLog) {\n\t\t\tconst path = output.snapshot().fullOutputPath!;\n\t\t\tconst cleanup = async () => {\n\t\t\t\tawait output.closeTempFile();\n\t\t\t\tawait unlink(path).catch((error: NodeJS.ErrnoException) => {\n\t\t\t\t\tif (error.code !== \"ENOENT\") throw error;\n\t\t\t\t});\n\t\t\t};\n\t\t\ttry {\n\t\t\t\tcontrol.attachOutput(path, cleanup);\n\t\t\t} catch (error) {\n\t\t\t\tawait cleanup();\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\t\t// Detach must check a silent foreground log too, preserving bytes already written.\n\t\tunsubscribe = control.onModeChange(checkOutputLimit);\n\t\tpublish();\n\t\tlet failure: ShellFailure | undefined;\n\t\tlet exitCode: number | null | undefined;\n\t\ttry {\n\t\t\tif (signal?.aborted) throw new Error(\"aborted\");\n\t\t\tconst execution = operations.exec(context.command, context.cwd, {\n\t\t\t\tonData: handleData,\n\t\t\t\tsignal,\n\t\t\t\ttimeout,\n\t\t\t\tenv: context.env,\n\t\t\t});\n\t\t\tcontrol.accept();\n\t\t\t({ exitCode } = await execution);\n\t\t\tif (exitCode === null) {\n\t\t\t\tfailure = { status: \"failed\", error: \"Command terminated without an exit code\" };\n\t\t\t} else if (exitCode !== 0) {\n\t\t\t\tfailure = { status: \"failed\", error: `Command exited with code ${exitCode}` };\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tfailure = shellFailure(error);\n\t\t}\n\t\tacceptingOutput = false;\n\t\toutput.finish();\n\t\tclearUpdateTimer();\n\t\tif (taskLog) publish(snapshot());\n\t\telse emitOutputUpdate();\n\t\tconst final = snapshot();\n\t\tawait output.closeTempFile();\n\t\t// Final progress/cleanup can re-enter handoff. Classify policy cancellation\n\t\t// after those callbacks, independently of the process's abort marker.\n\t\tif (outputError) failure = { status: \"failed\", error: boundText(outputError.message, 4096) };\n\t\tconst { text, details } = formatOutput(output, final, taskLog, failure ? \"\" : \"(no output)\");\n\t\tconst fullOutput =\n\t\t\ttypeof exitCode === \"number\" && !outputError ? await output.readFullOutput(1024 * 1024) : undefined;\n\t\treturn {\n\t\t\tstatus: failure?.status,\n\t\t\terror: failure?.error,\n\t\t\t...(exitCode !== undefined ? { facts: [[\"Exit\", exitCode === null ? \"signal\" : String(exitCode)]] } : {}),\n\t\t\tresult: {\n\t\t\t\t...(fullOutput && typeof exitCode === \"number\"\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tstructuredContent: {\n\t\t\t\t\t\t\t\toutput: fullOutput.content,\n\t\t\t\t\t\t\t\ttruncated: fullOutput.truncated,\n\t\t\t\t\t\t\t\t...(fullOutput.truncated && final.fullOutputPath\n\t\t\t\t\t\t\t\t\t? { full_output_path: final.fullOutputPath }\n\t\t\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\t\t\texit_code: exitCode,\n\t\t\t\t\t\t\t\twall_time_seconds: Math.round((performance.now() - startedAt) / 100) / 10,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t...(failure ? { isError: true } : {}),\n\t\t\t\t\t\t}\n\t\t\t\t\t: {}),\n\t\t\t\t// The command's output only: its failure is the completion's `error`, composed where a result is shown.\n\t\t\t\tcontent: [{ type: \"text\", text }],\n\t\t\t\tdetails,\n\t\t\t},\n\t\t};\n\t} finally {\n\t\tacceptingOutput = false;\n\t\tunsubscribe?.();\n\t\tclearUpdateTimer();\n\t\tawait output.closeTempFile();\n\t}\n}\n"]}
+{"version":3,"file":"shell-execution.js","sourceRoot":"","sources":["../../../src/core/tools/shell-execution.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Runs the native shell tool body (`bash.ts`) as one session task. The native body owns the\n * process, progress, output formatting and structured result; this adapter only supplies the\n * task's output log, its background limits and acceptance, and translates the native outcome\n * into a task completion.\n */\nimport { unlink } from \"node:fs/promises\";\nimport type { AgentToolResult } from \"@earendil-works/pi-agent-core\";\nimport { boundText } from \"../tasks/output.ts\";\nimport type { TaskCompletion, TaskControl, TaskTerminalStatus } from \"../tasks/types.ts\";\nimport { type BashOperations, resolveTimeoutMs } from \"./bash.ts\";\nimport { OutputAccumulator, type OutputAccumulatorOptions, type OutputSnapshot } from \"./output-accumulator.ts\";\nimport type { BashToolDetails } from \"./shell-tool.ts\";\n\nexport const MAX_BACKGROUND_OUTPUT_BYTES = 20 * 1024 * 1024;\n/** Background snapshots stay within the task result budget, so the bounded result keeps the newest output. */\nconst BACKGROUND_SNAPSHOT_BYTES = 40 * 1024;\nconst OUTPUT_LIMIT_ERROR = \"Background command exceeded the 20 MiB output limit\";\n\ntype ShellDetails = BashToolDetails | undefined;\ntype ShellControl = TaskControl<ShellDetails>;\n\n/**\n * A session task's output: persisted from the first byte to the log attached to the task, and\n * bounded once the task is background work. A write failure or the background cap cancels the\n * task instead of throwing through the process's data observer.\n */\nclass TaskOutput extends OutputAccumulator {\n\terror?: Error;\n\tprivate readonly control: ShellControl;\n\n\tconstructor(control: ShellControl, options: OutputAccumulatorOptions) {\n\t\tsuper({ ...options, persistFromStart: true });\n\t\tthis.control = control;\n\t}\n\n\toverride append(data: Buffer): void {\n\t\tif (this.error) return;\n\t\ttry {\n\t\t\tconst room = MAX_BACKGROUND_OUTPUT_BYTES - this.getTotalBytes();\n\t\t\tif (this.control.mode === \"background\" && data.length > room) {\n\t\t\t\tsuper.append(data.subarray(0, Math.max(0, room)));\n\t\t\t\tthis.fail(new Error(OUTPUT_LIMIT_ERROR));\n\t\t\t} else super.append(data);\n\t\t} catch (error) {\n\t\t\tthis.fail(error);\n\t\t}\n\t}\n\n\toverride snapshot(options: Parameters<OutputAccumulator[\"snapshot\"]>[0] = {}): OutputSnapshot {\n\t\treturn super.snapshot(\n\t\t\tthis.control.mode === \"background\" ? { ...options, maxBytes: BACKGROUND_SNAPSHOT_BYTES } : options,\n\t\t);\n\t}\n\n\t/** A detach must check output written while in the foreground, preserving it. */\n\tcheckLimit(): void {\n\t\tif (this.control.mode === \"background\" && this.getTotalBytes() > MAX_BACKGROUND_OUTPUT_BYTES)\n\t\t\tthis.fail(new Error(OUTPUT_LIMIT_ERROR));\n\t}\n\n\tprivate fail(error: unknown): void {\n\t\tif (this.error) return;\n\t\tthis.error = error instanceof Error ? error : new Error(String(error));\n\t\ttry {\n\t\t\tthis.control.cancel();\n\t\t} catch {\n\t\t\t// Late data must not throw through a process observer.\n\t\t}\n\t}\n}\n\ninterface ShellFailure {\n\tstatus: Extract<TaskTerminalStatus, \"failed\" | \"cancelled\" | \"timeout\">;\n\terror: string;\n}\n\n/** What the process itself reported, recorded before the native body formats it. */\ninterface ProcessOutcome {\n\texitCode?: number | null;\n\terror?: unknown;\n}\n\n/** Interpret the documented BashOperations error markers and exit codes as the native body states them. */\nfunction processFailure(outcome: ProcessOutcome): ShellFailure | undefined {\n\tconst { error, exitCode } = outcome;\n\tif (error instanceof Error && error.message === \"aborted\") return { status: \"cancelled\", error: \"Command aborted\" };\n\tif (error instanceof Error && error.message.startsWith(\"timeout:\"))\n\t\treturn { status: \"timeout\", error: `Command timed out after ${error.message.split(\":\")[1]} seconds` };\n\tif (error !== undefined) return { status: \"failed\", error: errorMessage(error) };\n\tif (exitCode === null) return { status: \"failed\", error: \"Command terminated without an exit code\" };\n\tif (exitCode !== undefined && exitCode !== 0)\n\t\treturn { status: \"failed\", error: `Command exited with code ${exitCode}` };\n\treturn undefined;\n}\n\nfunction errorMessage(error: unknown): string {\n\treturn boundText(error instanceof Error ? error.message : String(error), 4096);\n}\n\n/** The native body appends its failure status to the output; a task keeps them apart. */\nfunction withoutStatus(text: string, status: string): string {\n\tif (text === status) return \"\";\n\tconst suffix = `\\n\\n${status}`;\n\treturn text.endsWith(suffix) ? text.slice(0, -suffix.length) : text;\n}\n\nfunction resultText(result: AgentToolResult<ShellDetails>): string {\n\treturn result.content\n\t\t.filter((part) => part.type === \"text\")\n\t\t.map((part) => part.text)\n\t\t.join(\"\\n\");\n}\n\n/** The parts the native body runs with when it executes as a task. */\nexport interface ShellTaskParts {\n\tcreateOutput: () => OutputAccumulator;\n\toperations: BashOperations;\n\tonUpdate: (result: AgentToolResult<ShellDetails>) => void;\n}\n\nexport interface ShellTaskOptions {\n\tcontrol: ShellControl;\n\toperations: BashOperations;\n\ttempFilePrefix: string;\n\ttimeout?: number;\n\t/** Runs the native tool body once with the task's parts. */\n\texecute: (parts: ShellTaskParts) => Promise<AgentToolResult<ShellDetails>>;\n}\n\n/**\n * One process and one output owner across foreground/background handoff. The task result holds\n * the command's output only; its failure is the completion's `error`.\n */\nexport async function runShellTask(options: ShellTaskOptions): Promise<TaskCompletion<ShellDetails>> {\n\tconst { control } = options;\n\tif (control.signal.aborted) throw new Error(\"Command aborted\");\n\tresolveTimeoutMs(options.timeout);\n\tconst output = new TaskOutput(control, { tempFilePrefix: options.tempFilePrefix });\n\tconst path = output.snapshot().fullOutputPath!;\n\tconst cleanup = async () => {\n\t\tawait output.closeTempFile();\n\t\tawait unlink(path).catch((error: NodeJS.ErrnoException) => {\n\t\t\tif (error.code !== \"ENOENT\") throw error;\n\t\t});\n\t};\n\ttry {\n\t\tcontrol.attachOutput(path, cleanup);\n\t} catch (error) {\n\t\tawait cleanup();\n\t\tthrow error;\n\t}\n\tconst unsubscribe = control.onModeChange(() => output.checkLimit());\n\tconst spawned: ProcessOutcome = {};\n\tconst operations: BashOperations = {\n\t\texec: (command, cwd, execOptions) => {\n\t\t\tlet running: ReturnType<BashOperations[\"exec\"]>;\n\t\t\ttry {\n\t\t\t\trunning = options.operations.exec(command, cwd, execOptions);\n\t\t\t} catch (error) {\n\t\t\t\tspawned.error = error;\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\t// The process exists, so a handoff can no longer start it twice.\n\t\t\tcontrol.accept();\n\t\t\treturn running.then(\n\t\t\t\t(result) => {\n\t\t\t\t\tspawned.exitCode = result.exitCode;\n\t\t\t\t\treturn result;\n\t\t\t\t},\n\t\t\t\t(error: unknown) => {\n\t\t\t\t\tspawned.error = error;\n\t\t\t\t\tthrow error;\n\t\t\t\t},\n\t\t\t);\n\t\t},\n\t};\n\tlet result: AgentToolResult<ShellDetails> | undefined;\n\tlet thrown: unknown;\n\ttry {\n\t\ttry {\n\t\t\tresult = await options.execute({\n\t\t\t\tcreateOutput: () => output,\n\t\t\t\toperations,\n\t\t\t\tonUpdate: (update) => control.publish({ result: update }),\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tthrown = error;\n\t\t}\n\t} finally {\n\t\tunsubscribe();\n\t\tawait output.closeTempFile();\n\t}\n\treturn shellCompletion(output, path, spawned, result, thrown);\n}\n\nfunction shellCompletion(\n\toutput: TaskOutput,\n\tpath: string,\n\tspawned: ProcessOutcome,\n\tresult: AgentToolResult<ShellDetails> | undefined,\n\tthrown: unknown,\n): TaskCompletion<ShellDetails> {\n\tconst started = \"exitCode\" in spawned || \"error\" in spawned;\n\tconst failure =\n\t\tprocessFailure(spawned) ?? (thrown === undefined ? undefined : { status: \"failed\", error: errorMessage(thrown) });\n\t// The native result or error carries the formatted output; a raw operations error carries none.\n\tconst formatted =\n\t\tresult !== undefined\n\t\t\t? resultText(result)\n\t\t\t: thrown instanceof Error && thrown !== spawned.error && started\n\t\t\t\t? thrown.message\n\t\t\t\t: started\n\t\t\t\t\t? output.snapshot().content\n\t\t\t\t\t: \"\";\n\tconst text = failure ? withoutStatus(formatted, failure.error) : formatted;\n\tconst truncation = output.snapshot().truncation;\n\tconst details: BashToolDetails = {\n\t\t...(result?.details ?? (truncation.truncated ? { truncation } : {})),\n\t\tfullOutputPath: path,\n\t};\n\t// A cancellation the output policy caused is that policy's failure, not the process's abort.\n\tconst policy = output.error ? { status: \"failed\" as const, error: errorMessage(output.error) } : undefined;\n\tconst settled = policy ?? failure;\n\tconst keepStructured = result?.structuredContent !== undefined && !policy;\n\treturn {\n\t\tstatus: settled?.status,\n\t\terror: settled?.error,\n\t\t...(spawned.exitCode !== undefined\n\t\t\t? { facts: [[\"Exit\", spawned.exitCode === null ? \"signal\" : String(spawned.exitCode)]] }\n\t\t\t: {}),\n\t\tresult: {\n\t\t\t...(keepStructured\n\t\t\t\t? { structuredContent: result!.structuredContent, ...(settled ? { isError: true } : {}) }\n\t\t\t\t: {}),\n\t\t\tcontent: [{ type: \"text\", text }],\n\t\t\tdetails,\n\t\t},\n\t};\n}\n"]}

package/dist/core/tools/shell-tool.d.ts

@@ -1,37 +1,32 @@
+/**
+ * The managed shell tools: the native shell definition (`bash.ts`) plus a `background` parameter,
+ * adapted to the session's Tasks. The native body stays the one owner of execution, progress,
+ * output formatting and results; outside a session it runs unchanged.
+ */
 import { type Static, Type } from "typebox";
 import type { ToolDefinition } from "../extensions/types.ts";
-import { type BashOperations, type BashToolOptions, type ShellToolConfig } from "./bash.ts";
-import { type TruncationResult } from "./truncate.ts";
+import { type BashOperations, type BashRenderState, type BashToolOptions, type BashToolDetails as NativeBashToolDetails, type ShellToolConfig } from "./bash.ts";
 declare const bashSchema: Type.TObject<{
+    background: Type.TOptional<Type.TBoolean>;
     command: Type.TString;
     timeout: Type.TOptional<Type.TNumber>;
-    background: Type.TOptional<Type.TBoolean>;
 }>;
 export declare const bashToolSystemPromptContribution: {
     readonly snippet: "Execute bash commands, foreground or background";
     readonly guidelines: readonly ["You can inspect PI_* environment variables for current model and session details."];
 };
 export type BashToolInput = Static<typeof bashSchema>;
-export interface BashToolDetails {
-    truncation?: TruncationResult;
-    fullOutputPath?: string;
+export interface BashToolDetails extends NativeBashToolDetails {
     /** Settled handoff snapshot, not a command completion or exit code. */
     background?: {
         kind: "background";
         taskId: string;
     };
 }
-export type BashRenderState = {
-    dispose?: () => void;
-};
 export declare function createShellToolDefinition(cwd: string, config: ShellToolConfig, options: BashToolOptions & {
     operations: BashOperations;
 }): ToolDefinition<typeof bashSchema, BashToolDetails | undefined, BashRenderState>;
 export declare function createBashToolDefinition(cwd: string, options?: BashToolOptions): ReturnType<typeof createShellToolDefinition>;
-export declare function createBashTool(cwd: string, options?: BashToolOptions): import("@earendil-works/pi-agent-core").AgentTool<Type.TObject<{
-    command: Type.TString;
-    timeout: Type.TOptional<Type.TNumber>;
-    background: Type.TOptional<Type.TBoolean>;
-}>, BashToolDetails | undefined>;
+export declare function createBashTool(cwd: string, options?: BashToolOptions): import("@earendil-works/pi-agent-core").AgentTool<any, BashToolDetails | undefined>;
 export {};
 //# sourceMappingURL=shell-tool.d.ts.map

package/dist/core/tools/shell-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell-tool.d.ts","sourceRoot":"","sources":["../../../src/core/tools/shell-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG/E,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,eAAe,EAGpB,KAAK,eAAe,EACpB,MAAM,WAAW,CAAC;AAKnB,OAAO,EAAwC,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE5F,QAAA,MAAM,UAAU;;;;EASd,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;CAGnC,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAetD,MAAM,WAAW,eAAe;IAC/B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAED,MAAM,MAAM,eAAe,GAAG;IAC7B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAyBF,wBAAgB,yBAAyB,CACxC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,eAAe,GAAG;IAAE,UAAU,EAAE,cAAc,CAAA;CAAE,GACvD,cAAc,CAAC,OAAO,UAAU,EAAE,eAAe,GAAG,SAAS,EAAE,eAAe,CAAC,CA4FjF;AAYD,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,eAAe,GACvB,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAK9C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe;;;;iCAQpE"}
+{"version":3,"file":"shell-tool.d.ts","sourceRoot":"","sources":["../../../src/core/tools/shell-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAO7D,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EAEpB,KAAK,eAAe,IAAI,qBAAqB,EAG7C,KAAK,eAAe,EACpB,MAAM,WAAW,CAAC;AAKnB,QAAA,MAAM,UAAU;;;;EAQd,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;CAGnC,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAOtD,MAAM,WAAW,eAAgB,SAAQ,qBAAqB;IAC7D,uEAAuE;IACvE,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AA2BD,wBAAgB,yBAAyB,CACxC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,eAAe,GAAG;IAAE,UAAU,EAAE,cAAc,CAAA;CAAE,GACvD,cAAc,CAAC,OAAO,UAAU,EAAE,eAAe,GAAG,SAAS,EAAE,eAAe,CAAC,CAiEjF;AAYD,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,eAAe,GACvB,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAK9C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,uFAQpE"}