@markusylisiurunen/tau 0.3.45 → 0.3.47

package/README.md

@@ -143,7 +143,7 @@ For stdio attach, use `--session <id>` before `--`:
 tau attach --session 0195d6e4-4cf9-7f44-a2d8-f8f7f49ee9d3 -- ssh vps 'cd /path/to/repo && tau rpc'
 ```
 
-Session attach renders the authoritative session snapshot, streams recoverable `session.delta` updates and independently revisioned, non-persisted `session.pendingUserMessages` replacements, submits normal user input through `session.submit`, `session.queue`, and `session.steer`, supports steering/interruption, runs `!`/`!!` Bash commands in the session execution environment, records `/listen` from the local microphone, speaks `/speak` locally, reloads session content with `/reload`, switches session personas with `/persona:<id>` or `Ctrl+P`, inserts session prompt templates with `/prompt:<id>`, manages persistent autonomous goals with `/goal`, compacts the session with `/compact-all` or `/compact-keep-last`, creates a new session with `/new`, and exits with `/exit` or `Ctrl+C` twice.
+Session attach renders the authoritative session snapshot, streams recoverable `session.delta` updates plus independently revisioned, non-persisted pending-message replacements and per-agent subagent-activity updates, submits normal user input through `session.submit`, `session.queue`, and `session.steer`, supports steering/interruption, runs `!`/`!!` Bash commands in the session execution environment, records `/listen` from the local microphone, speaks `/speak` locally, reloads session content with `/reload`, switches session personas with `/persona:<id>` or `Ctrl+P`, inserts session prompt templates with `/prompt:<id>`, manages persistent autonomous goals with `/goal`, compacts the session with `/compact-all` or `/compact-keep-last`, creates a new session with `/new`, and exits with `/exit` or `Ctrl+C` twice.
 
 The host owns the active transcript as one ordered timeline of messages, tool calls, notices, and maintenance operations. Durable items retain their exact position across reattach; ephemeral transcript notices use the same ordering while attached but are not recovered. Successful compaction starts a new numeric timeline epoch containing the summary and future activity, while rewind removes every item after its selected boundary.
 
@@ -669,24 +669,74 @@ A project or nested directory can select a different exact set without defining
 
 The most specific `.tau/config.json` selection wins. Unknown names are skipped, and `enabledClientTools: []` disables every configured command client tool for that workspace.
 
-For every call, Tau validates the arguments against the configured schema, starts the command directly without a shell, and writes one versioned JSON request to stdin:
+For every call, Tau validates the arguments against the configured schema, starts the command directly without a shell, and speaks a version 2 newline-delimited JSON protocol over stdin and stdout. The initial stdin frame contains the invocation:
 
 ```json
 {
-  "version": 1,
+  "version": 2,
+  "type": "invoke",
   "sessionId": "session-id",
   "callId": "call-id",
   "arguments": { "message": "Build finished" }
 }
 ```
 
-A successful command must exit with code zero and write exactly one JSON result to stdout:
+Commands may send `exec` frames to run commands in the session execution environment. Tau returns the ordinary `session.exec` result in a matching `exec.result` stdin frame. The command finishes with one stdout result frame:
 
 ```json
-{ "content": "Notification shown." }
+{ "version": 2, "type": "result", "content": "Notification shown." }
 ```
 
-The `content` string becomes the model-visible tool result. A nonzero exit fails the tool using stderr, falling back to stdout when stderr is empty. Tau runs the command from the TUI's current working directory with the TUI process environment unchanged, limits total output to 1 MiB, and terminates the command's process group on cancellation, terminal transport failure, timeout, or excess output. Process-group termination escalates to `SIGKILL` after two seconds even if the command leader exits first. `executionTimeoutMs` defaults to 60 seconds.
+Use `runTauClientToolCommand()` from `@markusylisiurunen/tau/sdk` or `@markusylisiurunen/tau/code-mode` to handle this framing and receive the same `{ sessionId, callId, signal, executionEnvironment }` context as an in-process SDK client tool. The command itself still runs on the TUI machine; only `context.executionEnvironment.exec()` runs through `session.exec` in the session execution environment.
+
+The result `content` becomes model-visible. A nonzero exit fails the tool using stderr, falling back to stdout when stderr is empty. Tau runs the command from the TUI's current working directory with the TUI process environment unchanged, limits each command-to-TUI protocol frame and total stdout and stderr to 1 MiB, allows at most eight execution requests to remain active while their responses are delivered with stdin backpressure, and terminates the command's process group on cancellation, terminal transport failure, timeout, or excess output. Closing protocol stdin aborts the command helper and its pending execution requests. Process-group termination escalates to `SIGKILL` after two seconds even if the command leader exits first. `executionTimeoutMs` defaults to 60 seconds.
+
+```ts
+#!/usr/bin/env node
+import { runTauClientToolCommand } from "@markusylisiurunen/tau/sdk";
+
+await runTauClientToolCommand(async (args, context) => {
+  const status = await context.executionEnvironment.exec("git status --short");
+  return { content: status.output || "working tree clean" };
+});
+```
+
+Tau's `@markusylisiurunen/tau/code-mode` export implements this command framing plus the same isolated one-shot JavaScript runtime used by Tau's built-in code-mode tools. A code-mode command remains an ordinary configured client tool with the exact `{ code: string }` schema and a complete author-controlled description:
+
+```json
+{
+  "name": "linear",
+  "defaultEnabled": true,
+  "description": "Search Linear issues. When this tool is useful, your first call must be a documentation-only program that does nothing except print docs with console.log(docs). Read the returned documentation before writing a later tool call that uses linear. Do not guess API signatures.",
+  "parameters": {
+    "type": "object",
+    "properties": { "code": { "type": "string" } },
+    "required": ["code"],
+    "additionalProperties": false
+  },
+  "command": ".config/tau/tools/linear"
+}
+```
+
+The executable owns authenticated clients and explicitly exposes trusted handlers. Handler arguments and results cross a JSON boundary; generated code receives only the declared namespace plus `docs`, `console`, `Date`, and `Math`:
+
+```ts
+#!/usr/bin/env node
+import { runTauCodeModeCommand } from "@markusylisiurunen/tau/code-mode";
+
+await runTauCodeModeCommand({
+  name: "linear",
+  documentation:
+    "# Linear API\n\nUse `linear.issues.get(id)` to read an issue.",
+  api: {
+    issues: {
+      get: async ([id], { signal }) => linearClient.issue(id, { signal }),
+    },
+  },
+});
+```
+
+Trusted code-mode API handlers receive the command's execution-environment facade in their context and may intentionally expose narrower workspace operations through the declared API. Generated code does not receive an undeclared shell namespace. Tau prepends canonical runtime guidance to the executable's API documentation. The installed runtime therefore documents its actual capabilities, 60-second default timeout, 8,192-token output projection, 128-call total limit, and eight-call concurrency limit without duplicating those details in `config.json`. The optional `buildTauCodeModeToolDescription()` helper produces the recommended progressive-disclosure description, but descriptions are otherwise passed through unchanged.
 
 Configured names must be unique and cannot replace built-in TUI or host tools. Only one observing client may advertise a given name for a session. `--no-client-tools` disables command client tools together with `diff_review` and `prefill_input`.
 

package/dist/code_mode/command.d.ts

@@ -0,0 +1,2 @@
+import { type TauCodeModeDefinition } from "./runtime.js";
+export declare function runTauCodeModeCommand(definition: TauCodeModeDefinition): Promise<void>;

package/dist/code_mode/command.js

@@ -0,0 +1,31 @@
+import { runTauClientToolCommand } from "../sdk/client_tool_command.js";
+import { executeTauCodeMode, validateTauCodeModeDefinition, } from "./runtime.js";
+export async function runTauCodeModeCommand(definition) {
+    validateTauCodeModeDefinition(definition);
+    await runTauClientToolCommand(async (args, context) => {
+        const code = parseCodeArguments(args);
+        return await executeTauCodeMode({
+            ...definition,
+            code,
+            signal: context.signal,
+            invocation: {
+                sessionId: context.sessionId,
+                callId: context.callId,
+            },
+            executionEnvironment: context.executionEnvironment,
+        });
+    });
+}
+function parseCodeArguments(value) {
+    if (typeof value !== "object" || value === null) {
+        throw new Error("code-mode command arguments must be an object");
+    }
+    const args = value;
+    if (typeof args.code !== "string" ||
+        !args.code.trim() ||
+        Object.keys(args).some((key) => key !== "code")) {
+        throw new Error("code-mode command arguments must contain exactly one non-empty 'code' string");
+    }
+    return args.code;
+}
+//# sourceMappingURL=command.js.map

package/dist/code_mode/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/code_mode/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EACL,kBAAkB,EAElB,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AAEtB,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,UAAiC;IAC3E,6BAA6B,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,uBAAuB,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QACpD,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACtC,OAAO,MAAM,kBAAkB,CAAC;YAC9B,GAAG,UAAU;YACb,IAAI;YACJ,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE;gBACV,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB;YACD,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;SACnD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,IACE,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAC7B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACjB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,CAAC,EAC/C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC"}

package/dist/code_mode/index.d.ts

@@ -0,0 +1,4 @@
+export { runTauClientToolCommand, TAU_CLIENT_TOOL_COMMAND_PROTOCOL_VERSION, type TauClientToolCommandHandler, } from "../sdk/client_tool_command.js";
+export { runTauCodeModeCommand } from "./command.js";
+export type { BuildTauCodeModeToolDescriptionOptions, ExecuteTauCodeModeOptions, TauCodeModeApi, TauCodeModeDefinition, TauCodeModeExecutionStatus, TauCodeModeHandler, TauCodeModeHandlerContext, TauCodeModeInvocation, TauCodeModeJsonValue, TauCodeModePersistOutput, TauCodeModeResult, } from "./runtime.js";
+export { buildTauCodeModeToolDescription, executeTauCodeMode, TAU_CODE_MODE_DEFAULT_TIMEOUT_MS, TAU_CODE_MODE_MAX_OUTPUT_TOKENS, } from "./runtime.js";

package/dist/code_mode/index.js

@@ -0,0 +1,4 @@
+export { runTauClientToolCommand, TAU_CLIENT_TOOL_COMMAND_PROTOCOL_VERSION, } from "../sdk/client_tool_command.js";
+export { runTauCodeModeCommand } from "./command.js";
+export { buildTauCodeModeToolDescription, executeTauCodeMode, TAU_CODE_MODE_DEFAULT_TIMEOUT_MS, TAU_CODE_MODE_MAX_OUTPUT_TOKENS, } from "./runtime.js";
+//# sourceMappingURL=index.js.map

package/dist/code_mode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/code_mode/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,wCAAwC,GAEzC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAcrD,OAAO,EACL,+BAA+B,EAC/B,kBAAkB,EAClB,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,cAAc,CAAC"}

package/dist/code_mode/runtime.d.ts

@@ -0,0 +1,82 @@
+import type { TauSdkClientToolExecutionEnvironment } from "../sdk/types.js";
+export declare const TAU_CODE_MODE_DEFAULT_TIMEOUT_MS = 60000;
+export declare const TAU_CODE_MODE_MAX_OUTPUT_TOKENS = 8192;
+export type TauCodeModeJsonValue = null | boolean | number | string | TauCodeModeJsonValue[] | {
+    [key: string]: TauCodeModeJsonValue;
+};
+export type TauCodeModeInvocation = {
+    sessionId: string;
+    callId: string;
+};
+export type TauCodeModeHandlerContext = {
+    signal: AbortSignal;
+    invocation: TauCodeModeInvocation | null;
+    executionEnvironment: TauSdkClientToolExecutionEnvironment | null;
+};
+export type TauCodeModeHandler = (args: unknown[], context: TauCodeModeHandlerContext) => unknown | Promise<unknown>;
+export type TauCodeModeApi = {
+    [key: string]: TauCodeModeApi | TauCodeModeHandler;
+};
+export type TauCodeModeExecutionStatus = "succeeded" | "failed" | "timed-out" | "cancelled";
+type TauCodeModeProjection = {
+    content: string;
+    truncated: boolean;
+    truncatedBy: "lines" | "bytes" | null;
+    totalLines: number;
+    totalBytes: number;
+    outputLines: number;
+    outputBytes: number;
+    maxLines: number;
+    maxTokens: number;
+};
+type TauCodeModeExecutionCapture = {
+    output: string;
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    truncated: boolean;
+    timedOut: boolean;
+    aborted: boolean;
+    closeSignal: string | null;
+};
+export type TauCodeModePersistOutput = (output: {
+    content: string;
+    captureTruncated: boolean;
+    contextTruncated: boolean;
+    status: TauCodeModeExecutionStatus;
+}, context: TauCodeModeHandlerContext) => Promise<{
+    path: string;
+} | undefined>;
+export type TauCodeModeDefinition = {
+    name: string;
+    documentation: string;
+    api: TauCodeModeApi;
+    timeoutMs?: number;
+    persistOutput?: TauCodeModePersistOutput;
+};
+export type ExecuteTauCodeModeOptions = TauCodeModeDefinition & {
+    code: string;
+    signal?: AbortSignal;
+    invocation?: TauCodeModeInvocation | null;
+    executionEnvironment?: TauSdkClientToolExecutionEnvironment | null;
+};
+export type TauCodeModeResult = {
+    content: string;
+};
+export type BuildTauCodeModeToolDescriptionOptions = {
+    name: string;
+    description: string;
+};
+export type TauCodeModeRuntimeResult = {
+    result: TauCodeModeResult;
+    status: TauCodeModeExecutionStatus;
+    execution: TauCodeModeExecutionCapture;
+    durationMs: number;
+    projection: TauCodeModeProjection;
+    persistedPath?: string;
+};
+export declare function buildTauCodeModeToolDescription({ name, description, }: BuildTauCodeModeToolDescriptionOptions): string;
+export declare function validateTauCodeModeDefinition(definition: TauCodeModeDefinition): void;
+export declare function executeTauCodeMode(options: ExecuteTauCodeModeOptions): Promise<TauCodeModeResult>;
+export declare function runTauCodeMode(options: ExecuteTauCodeModeOptions): Promise<TauCodeModeRuntimeResult>;
+export {};

package/dist/code_mode/runtime.js

@@ -0,0 +1,298 @@
+import stripAnsi from "strip-ansi";
+import { CODE_MODE_MAX_BRIDGE_PAYLOAD_BYTES, CODE_MODE_MAX_BRIDGE_REQUESTS, CODE_MODE_MAX_CONCURRENT_BRIDGE_REQUESTS, executeCodeModeWorker, } from "../core/tools/code_mode_worker.js";
+import { bytesToTokens } from "../core/utils/token.js";
+import { formatBytes, truncateForTokens } from "../core/utils/truncate.js";
+export const TAU_CODE_MODE_DEFAULT_TIMEOUT_MS = 60_000;
+export const TAU_CODE_MODE_MAX_OUTPUT_TOKENS = 8_192;
+const sandboxRunnerUrl = new URL("../core/static/code_mode/sandbox_runner.mjs", import.meta.url);
+const javascriptIdentifierPattern = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+const reservedNames = new Set([...Object.getOwnPropertyNames(globalThis), "docs"]);
+const unsafeApiKeys = new Set(["__proto__", "constructor", "prototype"]);
+export function buildTauCodeModeToolDescription({ name, description, }) {
+    validateName(name);
+    const trimmedDescription = description.trim();
+    if (!trimmedDescription)
+        throw new Error("code-mode tool description must not be empty");
+    return [
+        trimmedDescription,
+        "When this tool is useful, your first call must be a documentation-only program that does nothing except print docs with console.log(docs).",
+        `Read the returned documentation before writing a later tool call that uses ${name}.`,
+        "Do not guess API signatures.",
+    ].join(" ");
+}
+export function validateTauCodeModeDefinition(definition) {
+    validateName(definition.name);
+    if (!definition.documentation.trim()) {
+        throw new Error("code-mode documentation must not be empty");
+    }
+    validateTimeout(definition.timeoutMs);
+    registerMethods(definition.api);
+}
+export async function executeTauCodeMode(options) {
+    const runtime = await runTauCodeMode(options);
+    if (runtime.status === "succeeded")
+        return runtime.result;
+    throw new Error(runtime.result.content);
+}
+export async function runTauCodeMode(options) {
+    validateName(options.name);
+    if (typeof options.code !== "string" || !options.code.trim()) {
+        throw new Error("code-mode source must be a non-empty string");
+    }
+    if (!options.documentation.trim()) {
+        throw new Error("code-mode documentation must not be empty");
+    }
+    validateTimeout(options.timeoutMs);
+    const methods = registerMethods(options.api);
+    const timeoutMs = options.timeoutMs ?? TAU_CODE_MODE_DEFAULT_TIMEOUT_MS;
+    const invocation = options.invocation ?? null;
+    const executionEnvironment = options.executionEnvironment ?? null;
+    const signal = options.signal ?? new AbortController().signal;
+    const docs = buildRuntimeDocumentation(options.name, options.documentation, timeoutMs);
+    const startedAt = Date.now();
+    let execution;
+    try {
+        execution = await executeCodeModeWorker({
+            sandboxRunnerUrl,
+            workerData: {
+                code: options.code,
+                docs,
+                name: options.name,
+                methods: methods.map(({ id, path }) => ({ id, path })),
+            },
+            signal,
+            timeoutMs,
+            handleRequest: async (request, requestSignal) => {
+                const method = methods[request.methodId];
+                if (!method)
+                    throw new Error(`unsupported ${options.name} API method`);
+                const args = parseBridgeArguments(request.argsJson, options.name, method.path);
+                const value = await method.handler(args, {
+                    signal: requestSignal,
+                    invocation,
+                    executionEnvironment,
+                });
+                return serializeBridgeResult(value, options.name, method.path);
+            },
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.stack || error.message : String(error);
+        const output = `${message}\n`;
+        execution = {
+            output,
+            stdout: "",
+            stderr: output,
+            exitCode: 1,
+            truncated: false,
+            timedOut: false,
+            aborted: false,
+            closeSignal: null,
+        };
+    }
+    const durationMs = Math.max(0, Date.now() - startedAt);
+    const status = getExecutionStatus(execution);
+    const output = appendTerminationNote(stripAnsi(execution.output), execution, timeoutMs);
+    const projection = truncateForTokens(output, {
+        maxTokens: TAU_CODE_MODE_MAX_OUTPUT_TOKENS,
+        strategy: "middle",
+    });
+    let persistedPath;
+    if (options.persistOutput) {
+        try {
+            const persisted = await options.persistOutput({
+                content: output,
+                captureTruncated: execution.truncated,
+                contextTruncated: projection.truncated,
+                status,
+            }, { signal, invocation, executionEnvironment });
+            if (persisted?.path.trim())
+                persistedPath = persisted.path;
+        }
+        catch { }
+    }
+    const result = {
+        content: formatResultContent({ execution, projection, persistedPath, status }),
+    };
+    return {
+        result,
+        status,
+        execution,
+        durationMs,
+        projection,
+        ...(persistedPath ? { persistedPath } : {}),
+    };
+}
+function validateName(name) {
+    let isIdentifier = javascriptIdentifierPattern.test(name);
+    if (isIdentifier) {
+        try {
+            Function(`"use strict"; let ${name};`);
+        }
+        catch {
+            isIdentifier = false;
+        }
+    }
+    if (!isIdentifier || reservedNames.has(name)) {
+        throw new Error(`code-mode name '${name}' must be a non-reserved JavaScript identifier`);
+    }
+}
+function validateTimeout(timeoutMs) {
+    if (timeoutMs !== undefined && (!Number.isInteger(timeoutMs) || timeoutMs <= 0)) {
+        throw new Error("code-mode timeoutMs must be a positive integer");
+    }
+}
+function registerMethods(api) {
+    const methods = [];
+    const visit = (value, path) => {
+        if (!isPlainObject(value)) {
+            throw new Error(`code-mode API '${formatPath(path)}' must be a plain object with function leaves`);
+        }
+        const entries = Object.entries(value);
+        if (entries.length === 0) {
+            throw new Error(`code-mode API '${formatPath(path)}' must not be empty`);
+        }
+        for (const [key, child] of entries) {
+            const childPath = [...path, key];
+            if (!key || unsafeApiKeys.has(key)) {
+                throw new Error(`code-mode API key '${formatPath(childPath)}' is not allowed`);
+            }
+            if (typeof child === "function") {
+                methods.push({ id: methods.length, path: childPath, handler: child });
+            }
+            else {
+                visit(child, childPath);
+            }
+        }
+    };
+    visit(api, []);
+    return methods;
+}
+function isPlainObject(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function formatPath(path) {
+    return path.length > 0 ? path.join(".") : "<root>";
+}
+function parseBridgeArguments(argsJson, name, path) {
+    const method = `${name}.${formatPath(path)}`;
+    if (Buffer.byteLength(argsJson, "utf8") > CODE_MODE_MAX_BRIDGE_PAYLOAD_BYTES) {
+        throw new Error(`${method} arguments exceeded the ${formatBytes(CODE_MODE_MAX_BRIDGE_PAYLOAD_BYTES)} bridge payload limit`);
+    }
+    let args;
+    try {
+        args = JSON.parse(argsJson);
+    }
+    catch {
+        throw new Error(`invalid ${method} arguments`);
+    }
+    if (!Array.isArray(args)) {
+        throw new Error(`invalid ${method} arguments`);
+    }
+    return args;
+}
+function serializeBridgeResult(value, name, path) {
+    let json;
+    try {
+        json = JSON.stringify(value, (_key, nested) => {
+            if (nested === undefined ||
+                typeof nested === "function" ||
+                typeof nested === "symbol" ||
+                typeof nested === "bigint" ||
+                (typeof nested === "number" && !Number.isFinite(nested))) {
+                throw new TypeError("Code-mode API results must be JSON-serializable values");
+            }
+            return nested;
+        });
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`${name}.${formatPath(path)} returned a non-JSON value: ${detail}`);
+    }
+    if (json === undefined) {
+        throw new Error(`${name}.${formatPath(path)} returned a non-JSON value`);
+    }
+    if (Buffer.byteLength(json, "utf8") > CODE_MODE_MAX_BRIDGE_PAYLOAD_BYTES) {
+        throw new Error(`${name}.${formatPath(path)} result exceeded the ${formatBytes(CODE_MODE_MAX_BRIDGE_PAYLOAD_BYTES)} bridge payload limit`);
+    }
+    return json;
+}
+function buildRuntimeDocumentation(name, documentation, timeoutMs) {
+    return [
+        "# Code-mode runtime",
+        "",
+        "## Available globals",
+        "",
+        `- \`${name}\`: the explicitly exposed API documented below.`,
+        "- `docs`: this document.",
+        "- `console`: program output through `debug`, `error`, `info`, `log`, and `warn`.",
+        "- `Date`: standard date handling with live current-time access.",
+        "- `Math`: standard math operations, including `Math.random()`.",
+        "",
+        "Top-level `await` is supported. The program return value is ignored; only console output is returned.",
+        "Generated code has no direct filesystem, process, environment, network, credential, import, timer, or `fetch` access.",
+        "",
+        "## API boundary",
+        "",
+        `Arguments passed to \`${name}\` methods and their results cross a JSON serialization boundary with a ${formatBytes(CODE_MODE_MAX_BRIDGE_PAYLOAD_BYTES)} limit per request or response.`,
+        `A program may make at most ${CODE_MODE_MAX_BRIDGE_REQUESTS} API calls, with at most ${CODE_MODE_MAX_CONCURRENT_BRIDGE_REQUESTS} unresolved calls concurrently. Exceeding any bridge limit fails the program.`,
+        `The program must finish within ${formatDuration(timeoutMs)}.`,
+        "",
+        "## Output",
+        "",
+        `Output is middle-truncated above roughly ${TAU_CODE_MODE_MAX_OUTPUT_TOKENS.toLocaleString("en-US")} tokens. Print only information needed for the task.`,
+        "",
+        documentation.trim(),
+    ].join("\n");
+}
+function formatDuration(timeoutMs) {
+    if (timeoutMs % 1_000 === 0) {
+        const seconds = timeoutMs / 1_000;
+        return `${seconds} second${seconds === 1 ? "" : "s"}`;
+    }
+    return `${timeoutMs}ms`;
+}
+function getExecutionStatus(execution) {
+    if (execution.aborted)
+        return "cancelled";
+    if (execution.timedOut)
+        return "timed-out";
+    return execution.exitCode === 0 ? "succeeded" : "failed";
+}
+function appendTerminationNote(output, execution, timeoutMs) {
+    let note;
+    if (execution.timedOut) {
+        note = `(tau) timed out after ${timeoutMs}ms`;
+    }
+    else if (execution.aborted) {
+        note = "(tau) aborted";
+    }
+    else if (execution.closeSignal) {
+        note = `(tau) terminated by signal ${execution.closeSignal}`;
+    }
+    if (!note)
+        return output;
+    return `${output}${output && !output.endsWith("\n") ? "\n" : ""}${note}\n`;
+}
+function formatResultContent(args) {
+    const { execution, projection, persistedPath, status } = args;
+    const output = projection.content.trimEnd();
+    if (!output && status === "succeeded") {
+        return persistedPath
+            ? `Program produced no output\n\n[Output saved to ${persistedPath}.]`
+            : "Program produced no output";
+    }
+    const truncationNote = projection.truncated || execution.truncated
+        ? `\n\n[Output truncated for context: ${projection.outputLines} lines / ${formatBytes(projection.outputBytes)} shown of ${projection.totalLines} lines / ${formatBytes(projection.totalBytes)} (full output estimate: ~${bytesToTokens(projection.totalBytes)} tokens).${persistedPath ? ` Output before context truncation saved to ${persistedPath}.` : ""}]`
+        : persistedPath
+            ? `\n\n[Output saved to ${persistedPath}.]`
+            : "";
+    const exitNote = status === "failed" && execution.exitCode !== null && execution.exitCode !== 0
+        ? `\n(exit ${execution.exitCode})`
+        : "";
+    return `${output || "(no output)"}${truncationNote}${exitNote}`;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/code_mode/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/code_mode/runtime.ts"],"names":[],"mappings":"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"}

package/dist/core/agent/agent_runtime.js

@@ -156,7 +156,7 @@ export class AgentRuntime {
                     : undefined;
         }
         else {
-            this.agentId = randomUUID();
+            this.agentId = options.agentId ?? randomUUID();
             this.revision = 0;
             this.historyEntries = [];
             this.modelContextKey = modelContextKey;