@markusylisiurunen/tau 0.3.93 → 0.3.95

package/dist/core/code_mode/agents.js

@@ -0,0 +1,434 @@
+import { resolve } from "node:path";
+import { z } from "zod";
+import { AgentRequestError } from "../subagents/errors.js";
+import { parseSubagentLaunchModel } from "../subagents/launch_model.js";
+import { resolveSubagentEffectiveSettings } from "../subagents/registry.js";
+const id = z.string().min(1).max(256);
+const idOptions = z.strictObject({ id });
+const message = z
+    .string()
+    .trim()
+    .min(1)
+    .max(256 * 1024);
+const spawnOptions = z.strictObject({
+    title: z
+        .string()
+        .trim()
+        .min(1)
+        .max(512)
+        .regex(/^[^\r\n]+$/),
+    prompt: message,
+    model: z.string().min(1).optional(),
+    workingDirectory: z
+        .string()
+        .min(1)
+        .regex(/^[^\r\n]+$/)
+        .optional(),
+});
+const traceOptions = z.strictObject({
+    id,
+    kinds: z
+        .array(z.enum(["input", "assistant", "tool_call", "tool_result", "notice", "status"]))
+        .max(6)
+        .optional(),
+    toolName: z.string().min(1).max(256).optional(),
+    limit: z.number().int().min(1).max(50).optional(),
+    cursor: z.string().max(4096).optional(),
+});
+export const agentsCapabilityMetadata = {
+    name: "agents",
+    description: "Start delegated workers, send them queued or steering input, interrupt and wait for them, and read selected parts of their conversations. Follow the delegation policy in your instructions. Workers keep running when a program ends or is cancelled.",
+    documentation: `# tau.agents
+
+Start general-purpose workers, send them more input, and read what they did. Start workers only when the user or active instructions explicitly ask for delegation.
+
+A worker has one conversation that grows with every input you send. Workers belong to the current session. They keep running when the program that started them ends or is cancelled, and they are lost when the session ends or Tau restarts. Results you need later must reach your conversation or a file before then.
+
+Reading data into the program does not add it to your conversation. Only what you print does, so select and print the parts you need.
+
+## Interface
+
+\`\`\`ts
+type AgentsApi = {
+  spawn(options: SpawnOptions): Promise<AgentState>;
+  list(): Promise<ListResult>;
+  read(options: { id: string }): Promise<AgentState>;
+  sendInput(options: SendInputOptions): Promise<AgentState>;
+  interrupt(options: InterruptOptions): Promise<AgentState>;
+  waitUntilIdle(options: { id: string }): Promise<AgentState>;
+  trace(options: TraceOptions): Promise<TracePage>;
+  readContent(options: ReadContentOptions): Promise<ContentPage>;
+  readText(options: ReadTextOptions): Promise<ReadTextResult>;
+};
+\`\`\`
+
+## Worker state
+
+\`\`\`ts
+type AgentState = {
+  id: string;
+  title: string;
+  model: string; // provider/model:effort
+  workingDirectory: string;
+  pending: { queue: number; steer: number };
+  usage: {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    contextTokens: number;
+    contextWindow: number;
+    cost: number;
+  };
+} & (
+  | { status: "working" | "stopping" }
+  | { status: "idle"; reason: "completed" | "interrupted" }
+  | { status: "idle"; reason: "failed"; error: { code: string; message: string } }
+);
+\`\`\`
+
+A worker is idle when it has no active turn and no pending input. \`reason\` tells how its latest turn ended. \`completed\` means the turn ended normally. It does not mean the task succeeded, so read the worker's answer before relying on it. A failed or interrupted turn may leave only a partial answer, or none.
+
+\`pending\` counts input awaiting delivery by Tau. Delivery to a runtime does not confirm that the worker has read it. Token counts and \`cost\` are totals for the whole conversation. \`contextTokens\` estimates the current context size.
+
+## \`tau.agents.spawn(options)\`
+
+\`\`\`ts
+type SpawnOptions = {
+  title: string;
+  prompt: string;
+  model?: string;
+  workingDirectory?: string;
+};
+\`\`\`
+
+- \`title\`: required single line, 1–512 characters.
+- \`prompt\`: required first message, at most 262,144 characters. The worker cannot see your conversation, so include everything it needs.
+- \`model\`: omit it to use your own model and settings. Set it only when the user or active instructions ask for a specific model; it must exactly match an allowed override from your instructions.
+- \`workingDirectory\`: absolute, or relative to your working directory. Defaults to your working directory.
+
+Returns as soon as the worker starts. At most 8 workers can be working at once.
+
+## \`tau.agents.list()\`
+
+\`\`\`ts
+type ListResult = {
+  agents: AgentState[];
+  capacity: { running: number; limit: number };
+};
+\`\`\`
+
+Lists every worker in this session, including idle ones.
+
+## \`tau.agents.read(options)\`
+
+Returns one worker's current state.
+
+## \`tau.agents.sendInput(options)\`
+
+\`\`\`ts
+type SendInputOptions = {
+  id: string;
+  message: string;
+  mode: "queue" | "steer";
+};
+\`\`\`
+
+\`mode\` is required:
+
+- \`queue\`: the worker finishes its current work first, then handles the message as a separate turn. Queued messages run in the order you send them.
+- \`steer\`: the worker takes the message into account as soon as possible during its current turn. Use it to correct or narrow work in progress. Steering does not stop a running tool; use \`interrupt\` for that.
+
+Either mode starts a new turn right away when the worker is idle. A steering message that arrives too late for the current turn is handled in a later turn. The worker keeps its conversation, model, tools, and working directory.
+
+The call returns when the input is accepted, before the worker reads it. It fails while the worker is stopping, when 64 inputs are already pending, or when the worker is idle and 8 workers are already working.
+
+## \`tau.agents.interrupt(options)\`
+
+\`\`\`ts
+type InterruptOptions = { id: string; wait?: boolean };
+\`\`\`
+
+Stops the current turn and discards all pending input, so the worker does not continue with queued work. With the default \`wait: true\`, the call returns after the turn has ended. With \`wait: false\`, it returns right away, and the status may still be \`stopping\`. If the program's deadline passes first, the worker still stops, but the call does not confirm it. Interrupting an idle worker only returns its state.
+
+Background Bash and code jobs that the worker started keep running. The worker stays available for more input.
+
+## \`tau.agents.waitUntilIdle(options)\`
+
+Waits until the worker has no active turn and no pending input, then returns its state. This includes queued messages. It returns immediately for an idle worker. A failed or interrupted worker returns idle state; the call does not throw for it. The wait does not include background jobs the worker started.
+
+Cancelling the wait, for example when the program stops, leaves the worker running. Wait for several workers with \`Promise.all\`. The call returns state only; read the answer with \`trace\` and \`readText\`. Outside a program, use the \`wait_for_agents\` tool, which also returns each idle worker's latest answer.
+
+An idle state is an observation at one moment. Another caller can send the worker new input afterwards.
+
+## \`tau.agents.trace(options)\`
+
+Reads a page of the worker's conversation.
+
+\`\`\`ts
+type TraceOptions = {
+  id: string;
+  kinds?: TraceKind[];
+  toolName?: string;
+  limit?: number;
+  cursor?: string;
+};
+
+type TracePage = {
+  entries: TraceEntry[];
+  nextCursor: string | null;
+  historyEvicted: boolean;
+};
+
+type TraceEntry = { seq: number; timestamp: number } & (
+  | { kind: "input"; mode: "initial" | "queue" | "steer"; content: Content }
+  | { kind: "assistant"; content: Content }
+  | { kind: "tool_call"; callId: string; toolName: string; arguments: Content }
+  | {
+      kind: "tool_result";
+      callId: string;
+      toolName: string;
+      outcome: "succeeded" | "failed" | "blocked" | "cancelled";
+      content: Content;
+    }
+  | { kind: "notice"; code: string; content: Content }
+  | {
+      kind: "status";
+      status: "working" | "stopping" | "idle";
+      reason?: "completed" | "failed" | "interrupted";
+    }
+);
+
+type TraceKind = TraceEntry["kind"];
+
+type Content =
+  | { kind: "inline"; blocks: ContentBlock[] }
+  | { kind: "reference"; ref: string; bytes: number };
+
+type ContentBlock =
+  | { type: "text"; text: string }
+  | { type: "json"; value: unknown }
+  | { type: "image"; mimeType: string; data: string } // base64
+  | { type: "unavailable"; reason: string };
+\`\`\`
+
+- \`kinds\`: only entries of these kinds. Omit for all kinds.
+- \`toolName\`: only tool calls and results of this tool. Tool names are the worker's own, such as \`bash\` for a Tau worker or \`Bash\` for a Claude Code worker.
+- \`limit\`: integer 1–50, default 20.
+- \`cursor\`: \`nextCursor\` from an earlier page. Keep \`kinds\` and \`toolName\` unchanged.
+
+The first page holds the newest matching entries, in chronological order. \`nextCursor\` leads to older entries. A cursor keeps its starting point, so new activity does not shift the pages. Call without a cursor to see the latest entries again. \`seq\` increases with every entry and identifies it for \`readText\`.
+
+The trace contains:
+
+- \`input\`: each message you sent, recorded when it was accepted.
+- \`assistant\`: the worker's message text. Reasoning is not included.
+- \`tool_call\`: the tool and its arguments as one JSON block.
+- \`tool_result\`: the result exactly as the worker received it. Output that the tool itself shortened stays shortened.
+- \`notice\`: events with a machine-readable \`code\`. \`input.discarded\` means an interrupt dropped pending input. \`compaction.compacted\`, \`compaction.skipped\`, \`compaction.aborted\`, and \`compaction.failed\` report context compaction. A failed turn adds a notice whose \`code\` matches the state's \`error.code\`.
+- \`status\`: the worker started working, began stopping, or became idle.
+
+System prompts are not included.
+
+Content is inline when it is at most 4,096 bytes as JSON and has no images. Otherwise the entry holds a \`reference\`; read it with \`readText\` or \`readContent\`. A single content value larger than 6 MiB is replaced by an \`unavailable\` block.
+
+Each worker keeps its newest 4,096 entries, up to 64 MiB in total. Older entries and their references are then removed, and \`historyEvicted\` is \`true\`.
+
+## \`tau.agents.readText(options)\`
+
+\`\`\`ts
+type ReadTextOptions = { id: string; seq: number; maxChars?: number };
+type ReadTextResult = { text: string; complete: boolean };
+\`\`\`
+
+Returns the text of one \`assistant\` or \`tool_result\` entry, whether it is inline or a reference. \`maxChars\` is 1–100,000 UTF-16 code units, default 30,000. \`complete\` is \`false\` when the text was cut at \`maxChars\` or the content contains an \`unavailable\` block. It does not detect output that the tool itself shortened. Content with JSON or images fails; use \`readContent\` for it.
+
+## \`tau.agents.readContent(options)\`
+
+\`\`\`ts
+type ReadContentOptions = { id: string; ref: string; cursor?: string };
+type ContentPage = { blocks: ContentBlock[]; nextCursor: string | null };
+\`\`\`
+
+Reads referenced content one block per page. Long text arrives in chunks of at most 16,384 UTF-16 code units; join the chunks to get the exact text. JSON and image blocks arrive whole. Pass \`nextCursor\` to read the next page, until it is \`null\`.
+
+An image reaches your conversation only if you pass it to \`printImage\`.
+
+## Errors
+
+A failed call throws an error with a \`code\` and a \`message\`:
+
+| \`code\` | Meaning |
+| --- | --- |
+| \`invalid_arguments\` | The options do not match the interface. |
+| \`unknown_agent\` | No worker in this session has the ID. |
+| \`invalid_cursor\` | The cursor is malformed, belongs to another query or reference, or comes from another worker. |
+| \`expired_content\` | The entry or reference was removed by retention, or never existed. |
+| \`content_type\` | \`readText\` was used on an entry of another kind, or on content with JSON or images. |
+| \`operation_failed\` | The request was refused, for example at the capacity or pending-input limit. |
+| \`cancelled\` | The program was cancelled during the call. |
+
+A worker's failure is part of its state and trace, not an error from these calls. No call is retried automatically.
+
+## Examples
+
+Start a worker, wait for it, and print its answer:
+
+\`\`\`js
+const worker = await tau.agents.spawn({
+  title: "review authentication",
+  prompt: "Review the authentication changes in src/auth. Do not edit files. Report findings.",
+});
+const state = await tau.agents.waitUntilIdle({ id: worker.id });
+if (state.status !== "idle" || state.reason !== "completed")
+  throw new Error(\`worker did not complete: \${JSON.stringify(state)}\`);
+const page = await tau.agents.trace({ id: worker.id, kinds: ["assistant"], limit: 1 });
+const answer = page.entries[0];
+if (!answer) throw new Error("worker gave no answer");
+const report = await tau.agents.readText({ id: worker.id, seq: answer.seq });
+printText(report.text);
+if (!report.complete) printText("(answer incomplete)");
+\`\`\`
+
+Redirect work in progress, then queue a separate task. Here and below, \`id\` is the ID of an earlier worker:
+
+\`\`\`js
+await tau.agents.sendInput({ id, mode: "steer", message: "Focus on expired sessions only." });
+await tau.agents.sendInput({ id, mode: "queue", message: "Then review the logout flow." });
+\`\`\`
+
+Print the beginning of each recent failed Bash result:
+
+\`\`\`js
+const page = await tau.agents.trace({ id, kinds: ["tool_result"], toolName: "bash", limit: 10 });
+for (const entry of page.entries) {
+  if (entry.outcome === "succeeded") continue;
+  const { text, complete } = await tau.agents.readText({ id, seq: entry.seq, maxChars: 2000 });
+  printText(\`#\${entry.seq}\${complete ? "" : " (shortened)"}: \${text}\`);
+}
+\`\`\`
+`,
+};
+export function createAgentsCapability(options, originHistoryEntryId) {
+    const supervisor = options.supervisor;
+    const api = {
+        spawn: async (args, context) => {
+            const [input] = z.tuple([spawnOptions]).parse(args);
+            context.signal.throwIfAborted();
+            let launchModel;
+            if (input.model) {
+                const parsed = parseSubagentLaunchModel(input.model, {
+                    resolveModel: options.modelResolver,
+                });
+                if (!parsed.launchModel ||
+                    !options.persona.subagentLaunchModels.includes(parsed.launchModel.normalized))
+                    throw new Error(parsed.error ?? "Subagent launch model is not allowed");
+                launchModel = parsed.launchModel;
+            }
+            const settings = resolveSubagentEffectiveSettings({
+                persona: options.persona,
+                launchModel,
+            });
+            const cwd = resolve(options.cwd, input.workingDirectory ?? ".");
+            let runtimeConfig;
+            if (settings.kind === "claude-code")
+                runtimeConfig = { ...settings, workingDirectory: cwd };
+            else {
+                const systemPrompt = cwd === resolve(options.cwd)
+                    ? options.subagentSystemPrompt
+                    : await options.resolveSubagentPrompt?.({ cwd, persona: options.persona });
+                if (!systemPrompt)
+                    throw new Error("Subagent working-directory instructions are unavailable");
+                runtimeConfig = { ...settings, workingDirectory: cwd, systemPrompt };
+            }
+            context.signal.throwIfAborted();
+            return supervisor.spawn({
+                ...options,
+                runtimeConfig,
+                prompt: input.prompt,
+                title: input.title,
+                originHistoryEntryId,
+                personaId: options.persona.id,
+            });
+        },
+        list: (args) => {
+            z.tuple([]).parse(args);
+            return {
+                agents: supervisor.list(),
+                capacity: supervisor.getCapacity(),
+            };
+        },
+        read: (args) => {
+            const [input] = z.tuple([idOptions]).parse(args);
+            return supervisor.read(input.id);
+        },
+        sendInput: (args, context) => {
+            const [input] = z
+                .tuple([z.strictObject({ id, message, mode: z.enum(["queue", "steer"]) })])
+                .parse(args);
+            context.signal.throwIfAborted();
+            return supervisor.sendInput({
+                id: input.id,
+                prompt: input.message,
+                mode: input.mode,
+            });
+        },
+        interrupt: async (args, context) => {
+            const [input] = z.tuple([z.strictObject({ id, wait: z.boolean().optional() })]).parse(args);
+            context.signal.throwIfAborted();
+            return await supervisor.interrupt(input.id, context.signal, input.wait ?? true);
+        },
+        waitUntilIdle: async (args, context) => {
+            const [input] = z.tuple([idOptions]).parse(args);
+            const [state] = await supervisor.waitForAgents([input.id], context.signal);
+            return state;
+        },
+        trace: (args) => {
+            const [input] = z.tuple([traceOptions]).parse(args);
+            return supervisor.getTrace(input.id).trace(input);
+        },
+        readContent: (args) => {
+            const [input] = z
+                .tuple([
+                z.strictObject({
+                    id,
+                    ref: z.string().min(1).max(256),
+                    cursor: z.string().max(4096).optional(),
+                }),
+            ])
+                .parse(args);
+            return supervisor.getTrace(input.id).readContent(input);
+        },
+        readText: (args) => {
+            const [input] = z
+                .tuple([
+                z.strictObject({
+                    id,
+                    seq: z.number().int().positive(),
+                    maxChars: z.number().int().min(1).max(100000).optional(),
+                }),
+            ])
+                .parse(args);
+            return supervisor.getTrace(input.id).readText(input.seq, input.maxChars);
+        },
+    };
+    for (const [name, handler] of Object.entries(api)) {
+        api[name] = async (args, context) => {
+            try {
+                context.signal.throwIfAborted();
+                return await handler(args, context);
+            }
+            catch (error) {
+                if (error instanceof AgentRequestError)
+                    throw error;
+                throw new AgentRequestError(context.signal.aborted
+                    ? "cancelled"
+                    : error instanceof z.ZodError
+                        ? "invalid_arguments"
+                        : "operation_failed", error instanceof Error ? error.message : String(error));
+            }
+        };
+    }
+    return { ...agentsCapabilityMetadata, api };
+}
+//# sourceMappingURL=agents.js.map

package/dist/core/code_mode/agents.js.map

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

package/dist/core/code_mode/bash.js

@@ -1,10 +1,9 @@
 import { resolve } from "node:path";
 import { z } from "zod";
 import { SESSION_PROTOCOL_MAX_EXEC_STDIN_BYTES } from "../../protocol/session_protocol.js";
+import { JOB_WAIT_DEFAULT_MS, JOB_WAIT_MAX_MS } from "../tools/background_jobs.js";
 import { BASH_DEFAULT_TIMEOUT_MS } from "../tools/bash.js";
-import { BASH_JOB_WAIT_DEFAULT_MS, BASH_JOB_WAIT_MAX_MS, } from "../tools/bash_jobs.js";
 import { MAX_COMMAND_CAPTURE_BYTES, } from "../tools/execution_backend.js";
-const BASH_RUN_MAX_TIMEOUT_MS = 5 * 60 * 1000;
 const commandOptions = {
     command: z
         .string()
@@ -22,13 +21,13 @@ const runOptions = z.strictObject({
         .string()
         .refine((value) => Buffer.byteLength(value, "utf8") <= SESSION_PROTOCOL_MAX_EXEC_STDIN_BYTES, "stdin exceeds its UTF-8 byte limit")
         .optional(),
-    timeout: z.number().int().positive().max(BASH_RUN_MAX_TIMEOUT_MS).optional(),
+    timeout: z.number().positive().optional(),
 });
 const startOptions = z.strictObject(commandOptions);
 const idOptions = z.strictObject({ id: z.string().min(1) });
 const waitOptions = z.strictObject({
     ids: z.array(z.string().min(1)).min(1).max(64),
-    timeout: z.number().int().positive().max(BASH_JOB_WAIT_MAX_MS).optional(),
+    timeout: z.number().int().positive().max(JOB_WAIT_MAX_MS).optional(),
 });
 export function createBashCapability(backend, cwd, jobs) {
     return {
@@ -75,7 +74,7 @@ type RunOptions = {
 - \`command\`: required, nonblank Bash source.
 - \`stdin\`: optional UTF-8 text, at most ${SESSION_PROTOCOL_MAX_EXEC_STDIN_BYTES / 1024 / 1024} MiB. Written once, then closed so the command receives EOF. Omit for no stdin; an empty string supplies an empty stream. No interactive input or TTY is available. Pass data through stdin rather than interpolating it into command source.
 - \`workingDirectory\`: optional, nonempty path without line breaks.
-- \`timeout\`: optional positive integer in milliseconds, default ${BASH_DEFAULT_TIMEOUT_MS}, maximum ${BASH_RUN_MAX_TIMEOUT_MS}. The enclosing program's time limit still applies.
+- \`timeout\`: optional positive number of milliseconds, default ${BASH_DEFAULT_TIMEOUT_MS}, with no upper limit. The enclosing program's deadline still cancels the command.
 
 ### Result
 
@@ -134,9 +133,7 @@ type StartOptions = {
 type StartResult = { id: string };
 \`\`\`
 
-The returned ID identifies the job, not application readiness. Inspect output or perform a task-specific readiness check before depending on a launched service.
-
-Jobs survive program completion, turn interruption, and client disconnect while Tau remains running. Already launched jobs are not stopped when a program is interrupted. Jobs are not recovered after restart.
+Started jobs also appear in your Bash job tools. Jobs survive program completion, turn interruption, and client disconnect while Tau remains running. Already launched jobs are not stopped when a program is interrupted. Jobs are not recovered after restart.
 
 ## Job types
 
@@ -154,21 +151,21 @@ type JobMetadata = {
       aborted: boolean;
       closeSignal: string | null;
     }
-  | { status: "failed"; error: string }
+  | { status: "failed" }
 );
 
-type Job = JobMetadata & { output: string };
+type Job = JobMetadata & { output: string; error?: string };
 \`\`\`
 
-An exited command has \`exitCode\`, \`aborted\`, and \`closeSignal\`. An execution error instead has \`error\`. A \`failed\` status can represent either a nonzero command exit or an execution error; inspect the corresponding fields. A \`stopped\` status indicates the job was aborted.
+An exited command has \`exitCode\`, \`aborted\`, and \`closeSignal\`. An execution error has none of these fields. \`read\`, \`wait\`, and \`stop\` report its message in \`error\`, and \`list\` omits it. A \`failed\` status can represent either a nonzero command exit or an execution error; inspect the corresponding fields. A \`stopped\` status indicates the job was aborted.
 
-\`command\` and \`workingDirectory\` are bounded display strings and may be truncated. Each job retains the last 64 KiB of combined output. \`truncated\` indicates that capture is incomplete.
+\`command\` and \`workingDirectory\` are bounded display strings and may be truncated. Each job retains the last ${MAX_COMMAND_CAPTURE_BYTES / 1024 / 1024} MiB of combined output. \`truncated\` indicates that capture is incomplete.
 
 Up to 64 job records are retained. Starting another job may evict an older completed record; if all records are running, launch fails. Unknown IDs throw and do not prove a command never ran. Check current process and output state before restarting it.
 
 ## \`tau.bash.list()\`
 
-List retained jobs without their output.
+List retained jobs without their output or error messages.
 
 \`\`\`ts
 type ListResult = JobMetadata[];
@@ -178,7 +175,7 @@ Takes no arguments. Use \`read\` for a selected job's output.
 
 ## \`tau.bash.read(options)\`
 
-Read one job's current state and bounded output tail without waiting for completion.
+Read one job's current state and retained output without waiting for completion.
 
 \`\`\`ts
 type ReadOptions = { id: string };
@@ -201,7 +198,7 @@ type WaitOptions = {
 \`\`\`
 
 - \`ids\`: required, 1 to 64 nonempty job IDs.
-- \`timeout\`: optional positive integer in milliseconds, default ${BASH_JOB_WAIT_DEFAULT_MS}, maximum ${BASH_JOB_WAIT_MAX_MS}.
+- \`timeout\`: optional positive integer in milliseconds, default ${JOB_WAIT_DEFAULT_MS}, maximum ${JOB_WAIT_MAX_MS}.
 
 ### Result
 
@@ -223,7 +220,7 @@ type StopOptions = { id: string };
 type StopResult = Job;
 \`\`\`
 
-\`id\` is required. Returns the completed job record with its output tail. Stopping an already completed job returns its existing record. Execution errors throw.
+\`id\` is required. Returns the completed job record with its retained output. Stopping an already completed job returns its existing record. Execution errors throw.
 
 ## Limits and failures
 
@@ -255,7 +252,7 @@ Invalid arguments, unknown job IDs, and launch failures throw. Errors after a ba
             },
             wait: async (args, context) => {
                 const [options] = z.tuple([waitOptions]).parse(args);
-                const timedOut = await jobs.waitJobs(options.ids, options.timeout ?? BASH_JOB_WAIT_DEFAULT_MS, context.signal);
+                const timedOut = await jobs.waitJobs(options.ids, options.timeout ?? JOB_WAIT_DEFAULT_MS, context.signal);
                 return { jobs: jobs.read(options.ids), timedOut };
             },
             stop: async (args) => {

package/dist/core/code_mode/bash.js.map

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

package/dist/core/code_mode/history.js

@@ -23,6 +23,7 @@ const searchInputSchema = z
 const readInputSchema = z
     .object({
     sessionId: z.string().trim().min(1).max(256),
+    source: z.literal("local").optional(),
     limit: z.number().int().min(1).max(100).default(50),
     cursor: z.string().min(1).max(2_048).optional(),
 })

package/dist/core/code_mode/history.js.map

@@ -1 +1 @@
-{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/core/code_mode/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,WAAW,GAAG;IAClB,4GAA4G;IAC5G,qLAAqL;CACtL,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC;IACpC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC;IACrB,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;CAC9D,CAAC,CAAC;AACH,MAAM,sBAAsB,GAAG,CAAC;KAC7B,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,qBAAqB,CAAC;KACxD,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AAChE,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IACrD,UAAU,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC;KACD,MAAM,EAAE,CAAC;AACZ,MAAM,eAAe,GAAG,CAAC;KACtB,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,aAAa,GAAG,YAAY,CAChC,IAAI,GAAG,CAAC,8CAA8C,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EACxE,MAAM,CACP,CAAC;AAEF,KAAK,UAAU,oBAAoB,CACjC,MAAyB,EACzB,IAAe,EACf,OAAqB,EACrB,MAAmB;IAEnB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,eAAe,MAAM,6BAA6B,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,uCAAuC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,qCAAqC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAqB;IAC3D,OAAO;QACL,IAAI,EAAE,SAAS;QACf,WAAW;QACX,aAAa;QACb,GAAG,EAAE;YACH,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,oBAAoB,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;YACxF,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;SACrF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/core/code_mode/history.ts"],"names":[],"mappings":"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"}