aws-runtime-bridge 1.9.0 → 1.9.1

package/dist/services/session-output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-output.d.ts","sourceRoot":"","sources":["../../src/services/session-output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,UAAU,uBAAuB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8BD,aAAa;AACb,eAAO,MAAM,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAa,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,uBAAuB,EACpC,KAAK,CAAC,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EACrD,WAAW,CAAC,EAAE,0BAA0B,GACvC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CA4C7C;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,qBAAqB,EAChC,WAAW,CAAC,EAAE,0BAA0B,GACvC,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,EAAE,EACpB,WAAW,CAAC,EAAE,0BAA0B,GACvC,OAAO,CAAC,IAAI,CAAC,CAef;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBzE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAa3D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCzE"}
+{"version":3,"file":"session-output.d.ts","sourceRoot":"","sources":["../../src/services/session-output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,UAAU,uBAAuB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA8BD,aAAa;AACb,eAAO,MAAM,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAa,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,uBAAuB,EACpC,KAAK,CAAC,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EACrD,WAAW,CAAC,EAAE,0BAA0B,GACvC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CA4C7C;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,qBAAqB,EAChC,WAAW,CAAC,EAAE,0BAA0B,GACvC,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,EAAE,EACpB,WAAW,CAAC,EAAE,0BAA0B,GACvC,OAAO,CAAC,IAAI,CAAC,CAef;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBzE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAa3D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCzE"}

package/package/acode/dist/built-in-file-tools.d.ts

@@ -1,3 +1,4 @@
+import { type CommandOutputSink } from "./builtins/shellCommandRunner.js";
 export type JsonValue = string | number | boolean | null | JsonValue[] | {
     [key: string]: JsonValue;
 };
@@ -10,7 +11,10 @@ export interface ACodeBuiltInTool {
     exposedName: string;
     description: string;
     inputSchema: JsonObject;
-    execute(args: JsonObject): Promise<unknown>;
+    execute(args: JsonObject, context?: ACodeBuiltInToolExecutionContext): Promise<unknown>;
+}
+export interface ACodeBuiltInToolExecutionContext {
+    readonly onOutput?: CommandOutputSink;
 }
 export declare function createBuiltInFileTools(workingDirectory: string): ACodeBuiltInTool[];
 //# sourceMappingURL=built-in-file-tools.d.ts.map

package/package/acode/dist/built-in-file-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"built-in-file-tools.d.ts","sourceRoot":"","sources":["../src/built-in-file-tools.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7C;AAyvBD,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,MAAM,GACvB,gBAAgB,EAAE,CAOpB"}
+{"version":3,"file":"built-in-file-tools.d.ts","sourceRoot":"","sources":["../src/built-in-file-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,CACL,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAsfD,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,MAAM,GACvB,gBAAgB,EAAE,CAOpB"}

package/package/acode/dist/built-in-file-tools.js

@@ -1,7 +1,7 @@
-import { spawn } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { promises as fs } from "node:fs";
 import path from "node:path";
+import { runShellCommand, } from "./builtins/shellCommandRunner.js";
 function toDisplayPath(targetPath) {
     return targetPath.replace(/\\/g, "/");
 }
@@ -178,208 +178,10 @@ async function readFileInsideWorkspace(workingDirectory, filePath) {
         content: await fs.readFile(realTargetPath, "utf-8"),
     };
 }
-const DEFAULT_COMMAND_TIMEOUT_MS = 30_000;
 const MAX_COMMAND_TIMEOUT_MS = 10 * 60_000;
+const DEFAULT_COMMAND_TIMEOUT_MS = MAX_COMMAND_TIMEOUT_MS;
 const DEFAULT_COMMAND_INACTIVITY_TIMEOUT_MS = 60_000;
 const MAX_COMMAND_INACTIVITY_TIMEOUT_MS = 10 * 60_000;
-const MAX_COMMAND_OUTPUT_BYTES = 128 * 1024;
-const COMMAND_OUTPUT_SPILLOVER_LINE_LIMIT = 100;
-function padDatePart(value) {
-    return String(value).padStart(2, "0");
-}
-function countOutputLines(output) {
-    if (!output) {
-        return 0;
-    }
-    const normalized = output.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
-    const withoutTrailingLineBreak = normalized.endsWith("\n")
-        ? normalized.slice(0, -1)
-        : normalized;
-    return withoutTrailingLineBreak
-        ? withoutTrailingLineBreak.split("\n").length
-        : 1;
-}
-function buildCommandOutputSpilloverPath(workspaceRoot, now = new Date()) {
-    const year = now.getFullYear();
-    const month = padDatePart(now.getMonth() + 1);
-    const day = padDatePart(now.getDate());
-    const hour = padDatePart(now.getHours());
-    const minute = padDatePart(now.getMinutes());
-    const timestamp = `${year}${month}${day}-${hour}${minute}${padDatePart(now.getSeconds())}-${String(now.getMilliseconds()).padStart(3, "0")}-${process.pid}-${randomUUID().slice(0, 8)}`;
-    return path.join(workspaceRoot, ".agentswork", "acode", "cmd-dist", `${year}-${month}-${day}`, hour, minute, `${timestamp}-cmd.out`);
-}
-async function writeCommandOutputSpilloverFile(workspaceRoot, content) {
-    const targetPath = buildCommandOutputSpilloverPath(workspaceRoot);
-    await fs.mkdir(path.dirname(targetPath), { recursive: true });
-    await fs.writeFile(targetPath, content, "utf-8");
-    return targetPath;
-}
-function buildCommandOutputSpilloverContent(input) {
-    return [
-        `Command: ${input.commandText}`,
-        `CWD: ${input.cwd}`,
-        `Started: ${input.startedAt.toISOString()}`,
-        `Ended: ${input.endedAt.toISOString()}`,
-        `Exit code: ${input.exitCode ?? "null"}`,
-        `Signal: ${input.signal ?? "null"}`,
-        `Timed out: ${input.timedOut}`,
-        `Timed out by inactivity: ${input.inactivityTimedOut}`,
-        "",
-        "--- stdout ---",
-        input.stdout,
-        "",
-        "--- stderr ---",
-        input.stderr,
-    ].join("\n");
-}
-function formatCommandOutputSpilloverStdout(outputFilePath, outputLineCount) {
-    return [
-        `[ACode] 命令输出超过 ${COMMAND_OUTPUT_SPILLOVER_LINE_LIMIT} 行（共 ${outputLineCount} 行），完整输出已写入: ${toDisplayPath(outputFilePath)}`,
-        "[ACode] Agent 可自行读取该文件，或在该文件中搜索需要的内容。",
-        "",
-    ].join("\n");
-}
-function truncateOutput(value) {
-    const bytes = Buffer.byteLength(value, "utf-8");
-    if (bytes <= MAX_COMMAND_OUTPUT_BYTES) {
-        return { text: value, truncated: false };
-    }
-    const buffer = Buffer.from(value, "utf-8");
-    return {
-        text: buffer.subarray(0, MAX_COMMAND_OUTPUT_BYTES).toString("utf-8") +
-            `\n...[truncated after ${MAX_COMMAND_OUTPUT_BYTES} bytes]`,
-        truncated: true,
-    };
-}
-function shellExecutable() {
-    if (process.platform === "win32") {
-        return {
-            command: process.env.ComSpec || "cmd.exe",
-            argsPrefix: ["/d", "/s", "/c"],
-        };
-    }
-    return { command: process.env.SHELL || "/bin/sh", argsPrefix: ["-lc"] };
-}
-function runShellCommand(commandText, workspaceRoot, cwd, timeoutMs, inactivityTimeoutMs) {
-    return new Promise((resolve, reject) => {
-        const shell = shellExecutable();
-        const startedAt = new Date();
-        const child = spawn(shell.command, [...shell.argsPrefix, commandText], {
-            cwd,
-            env: process.env,
-            windowsHide: true,
-        });
-        let stdout = "";
-        let stderr = "";
-        let timedOut = false;
-        let inactivityTimedOut = false;
-        let killEscalationTimer;
-        let inactivityTimer;
-        const escalateKill = () => {
-            killEscalationTimer = setTimeout(() => {
-                if (!child.killed) {
-                    child.kill("SIGKILL");
-                }
-            }, 1000);
-            killEscalationTimer.unref?.();
-        };
-        const timer = setTimeout(() => {
-            timedOut = true;
-            child.kill("SIGTERM");
-            escalateKill();
-        }, timeoutMs);
-        timer.unref?.();
-        const resetInactivityTimer = () => {
-            if (inactivityTimer) {
-                clearTimeout(inactivityTimer);
-            }
-            inactivityTimer = setTimeout(() => {
-                inactivityTimedOut = true;
-                timedOut = true;
-                child.kill("SIGTERM");
-                escalateKill();
-            }, inactivityTimeoutMs);
-            inactivityTimer.unref?.();
-        };
-        resetInactivityTimer();
-        child.stdout?.setEncoding("utf-8");
-        child.stderr?.setEncoding("utf-8");
-        child.stdout?.on("data", (chunk) => {
-            stdout += chunk;
-            resetInactivityTimer();
-        });
-        child.stderr?.on("data", (chunk) => {
-            stderr += chunk;
-            resetInactivityTimer();
-        });
-        child.on("error", (error) => {
-            clearTimeout(timer);
-            if (inactivityTimer) {
-                clearTimeout(inactivityTimer);
-            }
-            if (killEscalationTimer) {
-                clearTimeout(killEscalationTimer);
-            }
-            reject(error);
-        });
-        child.on("close", async (exitCode, signal) => {
-            clearTimeout(timer);
-            if (inactivityTimer) {
-                clearTimeout(inactivityTimer);
-            }
-            if (killEscalationTimer) {
-                clearTimeout(killEscalationTimer);
-            }
-            const endedAt = new Date();
-            const outputLineCount = countOutputLines(`${stdout}${stderr}`);
-            try {
-                if (outputLineCount > COMMAND_OUTPUT_SPILLOVER_LINE_LIMIT) {
-                    const outputFilePath = await writeCommandOutputSpilloverFile(workspaceRoot, buildCommandOutputSpilloverContent({
-                        commandText,
-                        cwd,
-                        startedAt,
-                        endedAt,
-                        exitCode,
-                        signal,
-                        timedOut,
-                        inactivityTimedOut,
-                        stdout,
-                        stderr,
-                    }));
-                    resolve({
-                        exitCode,
-                        signal,
-                        stdout: formatCommandOutputSpilloverStdout(outputFilePath, outputLineCount),
-                        stderr: "",
-                        durationMs: endedAt.getTime() - startedAt.getTime(),
-                        timedOut,
-                        inactivityTimedOut,
-                        outputSpilled: true,
-                        outputFilePath: toDisplayPath(outputFilePath),
-                        outputLineCount,
-                    });
-                    return;
-                }
-                const truncatedStdout = truncateOutput(stdout);
-                const truncatedStderr = truncateOutput(stderr);
-                resolve({
-                    exitCode,
-                    signal,
-                    stdout: truncatedStdout.text,
-                    stderr: truncatedStderr.text,
-                    durationMs: endedAt.getTime() - startedAt.getTime(),
-                    timedOut,
-                    inactivityTimedOut,
-                    outputSpilled: false,
-                    outputLineCount,
-                });
-            }
-            catch (error) {
-                reject(error);
-            }
-        });
-    });
-}
 function writeFileTool(workingDirectory) {
     return {
         kind: "builtin",
@@ -512,7 +314,7 @@ function bashTool(workingDirectory) {
                 },
                 timeout_ms: {
                     type: "number",
-                    description: "Optional timeout in milliseconds. Defaults to 30000 and is capped at 600000.",
+                    description: "Optional timeout in milliseconds. Defaults to 600000 and is capped at 600000.",
                 },
                 inactivity_timeout_ms: {
                     type: "number",
@@ -526,7 +328,7 @@ function bashTool(workingDirectory) {
             required: ["command"],
             additionalProperties: false,
         },
-        async execute(args) {
+        async execute(args, context) {
             const command = readStringArg(args, ["command"], "command").trim();
             if (!command) {
                 throw new Error("command must not be empty");
@@ -537,7 +339,14 @@ function bashTool(workingDirectory) {
             const inactivityTimeoutMs = Math.min(requestedInactivityTimeoutMs, MAX_COMMAND_INACTIVITY_TIMEOUT_MS);
             const cwdArg = readOptionalStringArg(args, ["cwd"]);
             const resolved = await resolveWorkspaceDirectory(workingDirectory, cwdArg);
-            const result = await runShellCommand(command, resolved.workspaceRoot, resolved.cwd, timeoutMs, inactivityTimeoutMs);
+            const result = await runShellCommand({
+                commandText: command,
+                workspaceRoot: resolved.workspaceRoot,
+                cwd: resolved.cwd,
+                timeoutMs,
+                inactivityTimeoutMs,
+                onOutput: context?.onOutput,
+            });
             return {
                 ok: result.exitCode === 0 && !result.timedOut,
                 tool: "Bash",
@@ -553,6 +362,8 @@ function bashTool(workingDirectory) {
                 outputSpilled: result.outputSpilled,
                 outputFilePath: result.outputFilePath,
                 outputLineCount: result.outputLineCount,
+                commandFilePath: result.commandFilePath,
+                commandLineCount: result.commandLineCount,
                 stdout: result.stdout,
                 stderr: result.stderr,
             };

package/package/acode/dist/builtins/commandArtifacts.d.ts

@@ -0,0 +1,25 @@
+export declare const COMMAND_OUTPUT_SPILLOVER_LINE_LIMIT = 300;
+export declare const LONG_COMMAND_LINE_LIMIT = 300;
+export declare const MAX_COMMAND_OUTPUT_BYTES: number;
+export declare function toDisplayPath(targetPath: string): string;
+export declare function countOutputLines(output: string): number;
+export declare function writeCommandArtifactFile(workspaceRoot: string, suffix: string, extension: string, content: string, now?: Date): Promise<string>;
+export declare function buildCommandOutputSpilloverContent(input: {
+    readonly commandText: string;
+    readonly commandFilePath?: string;
+    readonly commandLineCount: number;
+    readonly cwd: string;
+    readonly startedAt: Date;
+    readonly endedAt: Date;
+    readonly exitCode: number | null;
+    readonly signal: NodeJS.Signals | null;
+    readonly timedOut: boolean;
+    readonly inactivityTimedOut: boolean;
+    readonly stdout: string;
+    readonly stderr: string;
+}): string;
+export declare function formatCommandOutputSpilloverStdout(outputFilePath: string, outputLineCount: number): string;
+export declare function truncateOutput(value: string): {
+    readonly text: string;
+};
+//# sourceMappingURL=commandArtifacts.d.ts.map

package/package/acode/dist/builtins/commandArtifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandArtifacts.d.ts","sourceRoot":"","sources":["../../src/builtins/commandArtifacts.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mCAAmC,MAAM,CAAC;AACvD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,wBAAwB,QAAa,CAAC;AAEnD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAExD;AAMD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWvD;AA4BD,wBAAsB,wBAAwB,CAC5C,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,GAAG,OAAa,GACf,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAmBT;AAED,wBAAgB,kCAAkC,CAChD,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB,MAAM,CAMR;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAWvE"}

package/package/acode/dist/builtins/commandArtifacts.js

@@ -0,0 +1,77 @@
+import { randomUUID } from "node:crypto";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+export const COMMAND_OUTPUT_SPILLOVER_LINE_LIMIT = 300;
+export const LONG_COMMAND_LINE_LIMIT = 300;
+export const MAX_COMMAND_OUTPUT_BYTES = 128 * 1024;
+export function toDisplayPath(targetPath) {
+    return targetPath.replace(/\\/g, "/");
+}
+function padDatePart(value) {
+    return String(value).padStart(2, "0");
+}
+export function countOutputLines(output) {
+    if (!output) {
+        return 0;
+    }
+    const normalized = output.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+    const withoutTrailingLineBreak = normalized.endsWith("\n")
+        ? normalized.slice(0, -1)
+        : normalized;
+    return withoutTrailingLineBreak
+        ? withoutTrailingLineBreak.split("\n").length
+        : 1;
+}
+function buildCommandArtifactPath(workspaceRoot, now, suffix, extension) {
+    const year = now.getFullYear();
+    const month = padDatePart(now.getMonth() + 1);
+    const day = padDatePart(now.getDate());
+    const hour = padDatePart(now.getHours());
+    const minute = padDatePart(now.getMinutes());
+    const timestamp = `${year}${month}${day}-${hour}${minute}${padDatePart(now.getSeconds())}-${String(now.getMilliseconds()).padStart(3, "0")}-${process.pid}-${randomUUID().slice(0, 8)}`;
+    return path.join(workspaceRoot, ".agentswork", "acode", "cmd-dist", `${year}-${month}-${day}`, hour, minute, `${timestamp}-${suffix}.${extension}`);
+}
+export async function writeCommandArtifactFile(workspaceRoot, suffix, extension, content, now = new Date()) {
+    const targetPath = buildCommandArtifactPath(workspaceRoot, now, suffix, extension);
+    await fs.mkdir(path.dirname(targetPath), { recursive: true });
+    await fs.writeFile(targetPath, content, "utf-8");
+    return targetPath;
+}
+export function buildCommandOutputSpilloverContent(input) {
+    return [
+        `Command: ${input.commandText}`,
+        `Command file: ${input.commandFilePath ?? "null"}`,
+        `Command line count: ${input.commandLineCount}`,
+        `CWD: ${input.cwd}`,
+        `Started: ${input.startedAt.toISOString()}`,
+        `Ended: ${input.endedAt.toISOString()}`,
+        `Exit code: ${input.exitCode ?? "null"}`,
+        `Signal: ${input.signal ?? "null"}`,
+        `Timed out: ${input.timedOut}`,
+        `Timed out by inactivity: ${input.inactivityTimedOut}`,
+        "",
+        "--- stdout ---",
+        input.stdout,
+        "",
+        "--- stderr ---",
+        input.stderr,
+    ].join("\n");
+}
+export function formatCommandOutputSpilloverStdout(outputFilePath, outputLineCount) {
+    return [
+        `[ACode] 命令输出超过 ${COMMAND_OUTPUT_SPILLOVER_LINE_LIMIT} 行（共 ${outputLineCount} 行），完整输出已写入: ${toDisplayPath(outputFilePath)}`,
+        "[ACode] Agent 可自行读取该文件，或在该文件中搜索需要的内容。",
+        "",
+    ].join("\n");
+}
+export function truncateOutput(value) {
+    const bytes = Buffer.byteLength(value, "utf-8");
+    if (bytes <= MAX_COMMAND_OUTPUT_BYTES) {
+        return { text: value };
+    }
+    const buffer = Buffer.from(value, "utf-8");
+    return {
+        text: buffer.subarray(0, MAX_COMMAND_OUTPUT_BYTES).toString("utf-8") +
+            `\n...[truncated after ${MAX_COMMAND_OUTPUT_BYTES} bytes]`,
+    };
+}

package/package/acode/dist/builtins/commandOutputEvents.d.ts

@@ -0,0 +1,21 @@
+export type CommandOutputStream = "stdout" | "stderr" | "mixed";
+export interface CommandOutputEvent {
+    readonly stream: CommandOutputStream;
+    readonly text: string;
+    readonly sequence: number;
+    readonly cwd: string;
+    readonly commandLineCount: number;
+    readonly commandFilePath?: string;
+}
+export type CommandOutputSink = (event: CommandOutputEvent) => void;
+export interface OutputEventCollector {
+    readonly push: (stream: Exclude<CommandOutputStream, "mixed">, text: string) => void;
+    readonly close: () => void;
+}
+export declare function createOutputEventCollector(input: {
+    readonly cwd: string;
+    readonly commandLineCount: number;
+    readonly commandFilePath?: string;
+    readonly onOutput?: CommandOutputSink;
+}): OutputEventCollector;
+//# sourceMappingURL=commandOutputEvents.d.ts.map

package/package/acode/dist/builtins/commandOutputEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandOutputEvents.d.ts","sourceRoot":"","sources":["../../src/builtins/commandOutputEvents.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAOpE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,CACb,MAAM,EAAE,OAAO,CAAC,mBAAmB,EAAE,OAAO,CAAC,EAC7C,IAAI,EAAE,MAAM,KACT,IAAI,CAAC;IACV,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAKD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC,GAAG,oBAAoB,CAsDvB"}

package/package/acode/dist/builtins/commandOutputEvents.js

@@ -0,0 +1,56 @@
+const COMMAND_OUTPUT_EVENT_FLUSH_MS = 80;
+const MAX_COMMAND_OUTPUT_EVENT_CHARS = 16 * 1024;
+export function createOutputEventCollector(input) {
+    const onOutput = input.onOutput;
+    const pendingChunks = [];
+    let pendingCharCount = 0;
+    let sequence = 0;
+    let flushTimer;
+    const clearFlushTimer = () => {
+        if (!flushTimer)
+            return;
+        clearTimeout(flushTimer);
+        flushTimer = undefined;
+    };
+    const flush = () => {
+        if (!onOutput || pendingChunks.length === 0)
+            return;
+        clearFlushTimer();
+        sequence += 1;
+        const streams = new Set(pendingChunks.map((chunk) => chunk.stream));
+        const stream = streams.size === 1 ? pendingChunks[0]?.stream ?? "mixed" : "mixed";
+        const text = pendingChunks.map((chunk) => chunk.text).join("");
+        pendingChunks.length = 0;
+        pendingCharCount = 0;
+        onOutput({
+            stream,
+            text,
+            sequence,
+            cwd: input.cwd,
+            commandLineCount: input.commandLineCount,
+            ...(input.commandFilePath
+                ? { commandFilePath: input.commandFilePath }
+                : {}),
+        });
+    };
+    return {
+        push(stream, text) {
+            if (!onOutput || !text)
+                return;
+            pendingChunks.push({ stream, text });
+            pendingCharCount += text.length;
+            if (pendingCharCount >= MAX_COMMAND_OUTPUT_EVENT_CHARS) {
+                flush();
+                return;
+            }
+            if (!flushTimer) {
+                flushTimer = setTimeout(flush, COMMAND_OUTPUT_EVENT_FLUSH_MS);
+                flushTimer.unref?.();
+            }
+        },
+        close() {
+            flush();
+            clearFlushTimer();
+        },
+    };
+}

package/package/acode/dist/builtins/shellCommandPreparation.d.ts

@@ -0,0 +1,15 @@
+export interface ShellExecutable {
+    readonly command: string;
+    readonly argsPrefix: readonly string[];
+    readonly scriptExtension: "cmd" | "sh";
+    readonly scriptInvocation: (scriptPath: string) => string;
+}
+export interface PreparedShellCommand {
+    readonly commandText: string;
+    readonly originalCommandText: string;
+    readonly commandLineCount: number;
+    readonly commandFilePath?: string;
+}
+export declare function shellExecutable(): ShellExecutable;
+export declare function prepareShellCommand(commandText: string, workspaceRoot: string, shell: ShellExecutable): Promise<PreparedShellCommand>;
+//# sourceMappingURL=shellCommandPreparation.d.ts.map

package/package/acode/dist/builtins/shellCommandPreparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellCommandPreparation.d.ts","sourceRoot":"","sources":["../../src/builtins/shellCommandPreparation.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,KAAK,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;CAC3D;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAUD,wBAAgB,eAAe,IAAI,eAAe,CAejD;AAcD,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,oBAAoB,CAAC,CAkB/B"}

package/package/acode/dist/builtins/shellCommandPreparation.js

@@ -0,0 +1,44 @@
+import { countOutputLines, LONG_COMMAND_LINE_LIMIT, toDisplayPath, writeCommandArtifactFile, } from "./commandArtifacts.js";
+function quotePosixShellArg(value) {
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+function quoteWindowsCmdPath(value) {
+    return `"${value.replace(/"/g, '""')}"`;
+}
+export function shellExecutable() {
+    if (process.platform === "win32") {
+        return {
+            command: process.env.ComSpec || "cmd.exe",
+            argsPrefix: ["/d", "/c"],
+            scriptExtension: "cmd",
+            scriptInvocation: (scriptPath) => `call ${quoteWindowsCmdPath(scriptPath)}`,
+        };
+    }
+    return {
+        command: process.env.SHELL || "/bin/sh",
+        argsPrefix: ["-lc"],
+        scriptExtension: "sh",
+        scriptInvocation: (scriptPath) => `sh ${quotePosixShellArg(scriptPath)}`,
+    };
+}
+function buildCommandFileContent(commandText, scriptExtension) {
+    const commandWithTrailingLineBreak = commandText.endsWith("\n")
+        ? commandText
+        : `${commandText}\n`;
+    return scriptExtension === "cmd"
+        ? `@echo off\r\n${commandWithTrailingLineBreak}`
+        : commandWithTrailingLineBreak;
+}
+export async function prepareShellCommand(commandText, workspaceRoot, shell) {
+    const commandLineCount = countOutputLines(commandText);
+    if (commandLineCount <= LONG_COMMAND_LINE_LIMIT) {
+        return { commandText, originalCommandText: commandText, commandLineCount };
+    }
+    const commandFilePath = await writeCommandArtifactFile(workspaceRoot, "cmd", shell.scriptExtension, buildCommandFileContent(commandText, shell.scriptExtension));
+    return {
+        commandText: shell.scriptInvocation(commandFilePath),
+        originalCommandText: commandText,
+        commandLineCount,
+        commandFilePath: toDisplayPath(commandFilePath),
+    };
+}

package/package/acode/dist/builtins/shellCommandResult.d.ts

@@ -0,0 +1,30 @@
+import type { PreparedShellCommand } from "./shellCommandPreparation.js";
+export interface ShellCommandResult {
+    readonly exitCode: number | null;
+    readonly signal: NodeJS.Signals | null;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly durationMs: number;
+    readonly timedOut: boolean;
+    readonly inactivityTimedOut: boolean;
+    readonly outputSpilled: boolean;
+    readonly outputFilePath?: string;
+    readonly outputLineCount: number;
+    readonly commandFilePath?: string;
+    readonly commandLineCount: number;
+}
+interface ClosedShellCommandInput {
+    readonly exitCode: number | null;
+    readonly signal: NodeJS.Signals | null;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly startedAt: Date;
+    readonly timedOut: boolean;
+    readonly inactivityTimedOut: boolean;
+    readonly prepared: PreparedShellCommand;
+    readonly workspaceRoot: string;
+    readonly cwd: string;
+}
+export declare function resolveClosedShellCommand(input: ClosedShellCommandInput): Promise<ShellCommandResult>;
+export {};
+//# sourceMappingURL=shellCommandResult.d.ts.map

package/package/acode/dist/builtins/shellCommandResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellCommandResult.d.ts","sourceRoot":"","sources":["../../src/builtins/shellCommandResult.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CAClC;AAED,UAAU,uBAAuB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACrB;AA0CD,wBAAsB,yBAAyB,CAC9C,KAAK,EAAE,uBAAuB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAuD7B"}

package/package/acode/dist/builtins/shellCommandResult.js

@@ -0,0 +1,71 @@
+import { buildCommandOutputSpilloverContent, COMMAND_OUTPUT_SPILLOVER_LINE_LIMIT, countOutputLines, formatCommandOutputSpilloverStdout, toDisplayPath, truncateOutput, writeCommandArtifactFile, } from "./commandArtifacts.js";
+async function writeCommandOutputSpilloverFile(workspaceRoot, content) {
+    return writeCommandArtifactFile(workspaceRoot, "cmd", "out", content);
+}
+function buildShellCommandResult(input) {
+    return {
+        exitCode: input.exitCode,
+        signal: input.signal,
+        stdout: input.stdout,
+        stderr: input.stderr,
+        durationMs: input.endedAt.getTime() - input.startedAt.getTime(),
+        timedOut: input.timedOut,
+        inactivityTimedOut: input.inactivityTimedOut,
+        outputSpilled: input.outputSpilled,
+        outputLineCount: input.outputLineCount,
+        ...(input.outputFilePath ? { outputFilePath: input.outputFilePath } : {}),
+        ...(input.commandFilePath
+            ? { commandFilePath: input.commandFilePath }
+            : {}),
+        commandLineCount: input.commandLineCount,
+    };
+}
+export async function resolveClosedShellCommand(input) {
+    const endedAt = new Date();
+    const outputLineCount = countOutputLines(`${input.stdout}${input.stderr}`);
+    if (outputLineCount > COMMAND_OUTPUT_SPILLOVER_LINE_LIMIT) {
+        const outputFilePath = await writeCommandOutputSpilloverFile(input.workspaceRoot, buildCommandOutputSpilloverContent({
+            commandText: input.prepared.originalCommandText,
+            commandFilePath: input.prepared.commandFilePath,
+            commandLineCount: input.prepared.commandLineCount,
+            cwd: input.cwd,
+            startedAt: input.startedAt,
+            endedAt,
+            exitCode: input.exitCode,
+            signal: input.signal,
+            timedOut: input.timedOut,
+            inactivityTimedOut: input.inactivityTimedOut,
+            stdout: input.stdout,
+            stderr: input.stderr,
+        }));
+        return buildShellCommandResult({
+            exitCode: input.exitCode,
+            signal: input.signal,
+            stdout: formatCommandOutputSpilloverStdout(outputFilePath, outputLineCount),
+            stderr: "",
+            startedAt: input.startedAt,
+            endedAt,
+            timedOut: input.timedOut,
+            inactivityTimedOut: input.inactivityTimedOut,
+            outputSpilled: true,
+            outputFilePath: toDisplayPath(outputFilePath),
+            outputLineCount,
+            commandFilePath: input.prepared.commandFilePath,
+            commandLineCount: input.prepared.commandLineCount,
+        });
+    }
+    return buildShellCommandResult({
+        exitCode: input.exitCode,
+        signal: input.signal,
+        stdout: truncateOutput(input.stdout).text,
+        stderr: truncateOutput(input.stderr).text,
+        startedAt: input.startedAt,
+        endedAt,
+        timedOut: input.timedOut,
+        inactivityTimedOut: input.inactivityTimedOut,
+        outputSpilled: false,
+        outputLineCount,
+        commandFilePath: input.prepared.commandFilePath,
+        commandLineCount: input.prepared.commandLineCount,
+    });
+}