genaicode 2.3.0 → 2.4.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## Unreleased
+
+### Added
+
+- `genaicode/agents` subpath (experimental): run installed coding-agent CLIs behind one
+  `CodingAgent` interface. Drivers `claude()`, `codex()`, `muse()`; agent-neutral
+  `AgentEvent` stream and `AgentResult`; abort, timeout and process-group kill;
+  `detectAgents` / `findExecutable`; `cliAgent()` for custom drivers. See
+  [docs/agents.md](docs/agents.md).
+- Live agent sessions over JSON-RPC: `codexLive()` (`codex app-server`) and `museLive()`
+  (`muse serve`) with `AgentRun.steer()` and `AgentTask.onApproval`; `liveAgent()` and
+  `RpcPeer` for custom live drivers; `approval-resolved` event.
+- `AgentTask.mcpServers` (HTTP and stdio) for `claude`, `codex` and `codexLive`; header
+  secrets stay out of argv. Drivers can set up and clean up per task via `prepare`.
+- `scrubEnv`, `withoutProviderCredentials` and `PROVIDER_CREDENTIAL_VARS` for child
+  environments; `runWithVerify` verify-and-repair loop.
+- Drivers `gemini()`, `cursor()` and `opencode()`; `hostedAgent()` adapts a
+  `HostedAgentProvider` (start / poll / send / cancel) to `CodingAgent`.
+- Driver `copilot()` for GitHub Copilot CLI (`--output-format json`), with MCP servers via
+  `--additional-mcp-config` and `allowTools` / `denyTools` permission patterns.
+
+### Notes
+
+- The core `genaicode` entry is unchanged and still spawns nothing.
+
 ## 2.2.0 — 2026-07-26
 
 ### Added

package/README.md

@@ -12,7 +12,10 @@ GenAIcode is a small TypeScript toolkit for using LLMs in backend code.
 
 It sits between raw provider SDKs and full agent frameworks: one prompt representation,
 thin provider adapters, a convenient request API, and lightweight conversation chains.
-It does not inspect repositories, execute shell commands, edit files, or run an agent UI.
+The core does not inspect repositories, execute shell commands, edit files, or run an agent UI.
+The opt-in [`genaicode/agents`](#coding-agents) subpath drives the coding-agent CLIs you
+already have (Claude Code, Codex, GitHub Copilot CLI, Cursor, Gemini CLI, opencode, Muse)
+behind one task and event API, so you can orchestrate them from backend code.
 
 **Like jQuery**, the common case starts with one small function and becomes more specific
 through chaining—configure a request, follow up across multiple prompts, and keep history
@@ -81,6 +84,53 @@ const short = await releaseNote.maxOutputTokens(200).text();
 const long = await releaseNote.maxOutputTokens(800).text();
 ```
 
+## Coding agents
+
+`genaicode/agents` turns the coding-agent CLIs installed on a machine into one API. Give
+any of them a task (a prompt and a working directory) and get back the same event stream
+and result, whichever agent does the work. It is how you script, compare, or chain coding
+agents from a job, a bot, or a CI step without writing a parser per vendor.
+
+```ts
+import { claude, codex, copilot, cursor, detectAgents } from 'genaicode/agents';
+
+const [found] = detectAgents([claude(), codex(), copilot(), cursor()]).filter(({ path }) => path);
+if (!found) throw new Error('No coding agent installed.');
+
+const run = found.agent.run({ prompt: 'Add a unit test for parseDate', cwd: '/path/to/repo', timeoutMs: 20 * 60_000 });
+for await (const event of run) {
+  if (event.type === 'tool-start') console.log('⚙', event.name);
+  if (event.type === 'file-change') console.log('edited', event.paths.join(', '));
+}
+const result = await run.result; // { status, ok, text, sessionId, usage, error, ... }
+```
+
+| Agent            | Driver                        | Extras                                     |
+| ---------------- | ----------------------------- | ------------------------------------------ |
+| Claude Code      | `claude()`                    | MCP servers, max turns, effort, cost       |
+| Codex            | `codex()`, `codexLive()`      | MCP servers; live: `steer()`, approvals    |
+| GitHub Copilot   | `copilot()`                   | MCP servers, allow/deny tool patterns      |
+| Cursor           | `cursor()`                    | streamed text deltas                       |
+| Gemini CLI       | `gemini()`                    | approval mode                              |
+| opencode         | `opencode()`                  | `provider/model` ids, variants             |
+| Muse             | `muse()`, `museLive()`        | max turns; live: `steer()`                 |
+| Your own CLI/API | `cliAgent()`, `hostedAgent()` | plug in any JSON-lines CLI or hosted agent |
+
+On top of the drivers:
+
+- **Steer a running task** with `run.steer(text)`, and answer permission prompts with
+  `onApproval` (live drivers).
+- **Attach MCP servers per task** with `mcpServers`. Header secrets stay out of argv.
+- **Verify and repair**: `runWithVerify` runs your check (tests, lint) after the agent and
+  sends failures back for another attempt.
+- **Keep credentials apart**: `withoutProviderCredentials()` strips your app's LLM API keys
+  from the agent's environment, so it bills its own login.
+
+Importing `genaicode` never spawns anything; only `genaicode/agents` does. The agent uses
+its own credentials, billing, and permission settings. GenAIcode does not sandbox it,
+choose a model, or retry it. See [docs/agents.md](docs/agents.md) for events, options per
+driver, and writing your own driver.
+
 ## Chaining prompts
 
 A chain remembers successful user and assistant turns. Each new prompt sees the complete
@@ -180,8 +230,10 @@ const verdict = await ai(promptText)
 - `thinking`: `false` to disable, or `{ budgetTokens?, level? }` (`minimal` |
   `low` | `medium` | `high`). Prefer one of budget or level — some providers reject both.
   On Google/Gemini, `false` and `budgetTokens: 0` map to `thinkingLevel: MINIMAL`
+  (or `LOW` for models like Gemini 3.7 and Gemini 3 Pro where `MINIMAL` is unsupported)
   because Gemini 3 rejects `thinkingBudget: 0`. JSON `responseFormat` without an
-  explicit `thinking` setting also defaults Google to `MINIMAL`.
+  explicit `thinking` setting or provider `generationConfig.thinkingConfig` default also
+  defaults Google thinking to `MINIMAL` (or `LOW` on Gemini 3.7 / Pro).
 
 Providers map what they support and ignore the rest. `ProviderCapabilities.jsonResponse`
 and `ProviderCapabilities.thinking` advertise support. Vendor-specific escapes such as
@@ -268,13 +320,7 @@ Hook-style plugins remain the extension point. Built-in helpers cover common bac
 needs without restoring a global registry:
 
 ```ts
-import {
-  cachePlugin,
-  fallbackPlugin,
-  genaicode,
-  rateLimitPlugin,
-  timingPlugin,
-} from 'genaicode';
+import { cachePlugin, fallbackPlugin, genaicode, rateLimitPlugin, timingPlugin } from 'genaicode';
 import { anthropic, openai } from 'genaicode/providers';
 
 const ai = genaicode(openai({ model: 'your-model-name' }), {
@@ -442,14 +488,16 @@ Framework-shaped examples live under `examples/` (`http-handler`, `queue-worker`
 
 ## Design boundaries
 
-- Backend library, not a coding agent.
+- Backend library, not a coding agent. `genaicode/agents` drives external agent CLIs; it
+  adds no agent loop, prompts, or repository tools of its own.
 - Provider-neutral core with no global configuration.
 - Explicit models and credentials; environment variables are only provider defaults.
 - Immutable request builders.
 - Conversation history is explicit; loops remain ordinary application code.
 - No hidden tool execution or hidden retries.
 - Third-party providers and middleware use stable TypeScript contracts.
-- Provider SDKs stay behind the `genaicode/providers` subpath.
+- Provider SDKs stay behind the `genaicode/providers` subpath; process spawning stays
+  behind `genaicode/agents`.
 
 ## Migration from 1.x
 

package/dist/agents/cli-agent.d.ts

@@ -0,0 +1,28 @@
+import { type PreparedRun } from './prepare.js';
+import { type AgentOutcome } from './runtime.js';
+import type { AgentCapabilities, AgentEvent, AgentTask, CodingAgent } from './types.js';
+export type { AgentOutcome } from './runtime.js';
+/** Per-run decoder for one vendor's JSON event stream. */
+export interface AgentOutputParser {
+    /** Map one parsed stdout JSON value to zero or more events. */
+    event(value: unknown): AgentEvent[];
+    /** The terminal verdict the agent itself reported, if it reported one. */
+    outcome?(): AgentOutcome | undefined;
+}
+export interface CliAgentDefinition {
+    name: string;
+    command: string;
+    capabilities?: AgentCapabilities;
+    /** Full argument list for a task, prompt included. */
+    args(task: AgentTask): string[];
+    /** Replaces `args` when a task needs setup: extra env, temp files to clean up. */
+    prepare?(task: AgentTask): PreparedRun;
+    createParser(): AgentOutputParser;
+    /** Adjust the child environment (the caller's `task.env` or `process.env`). */
+    env?(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+}
+/**
+ * Build a `CodingAgent` from a headless CLI: spawn, decode its JSON lines, and
+ * fold them into an `AgentResult`. Drivers such as `claude()` are thin definitions.
+ */
+export declare function cliAgent(definition: CliAgentDefinition): CodingAgent;

package/dist/agents/cli-agent.js

@@ -0,0 +1,57 @@
+import { planSpawn } from './prepare.js';
+import { startProcess } from './process.js';
+import { invalidCwd, RunRecorder } from './runtime.js';
+/**
+ * Build a `CodingAgent` from a headless CLI: spawn, decode its JSON lines, and
+ * fold them into an `AgentResult`. Drivers such as `claude()` are thin definitions.
+ */
+export function cliAgent(definition) {
+    return {
+        name: definition.name,
+        command: definition.command,
+        capabilities: definition.capabilities ?? {},
+        run: (task) => runCliAgent(definition, task),
+    };
+}
+function runCliAgent(definition, task) {
+    const recorder = new RunRecorder(definition.name, definition.command);
+    const iterate = () => recorder.events.iterate();
+    const plan = planSpawn(definition, task, invalidCwd(task.cwd));
+    if (!plan.ok) {
+        const result = recorder.finish({ exitCode: null, signal: null, reason: 'spawn-error', error: new Error(plan.error) }, undefined);
+        return { result: Promise.resolve(result), abort() { }, [Symbol.asyncIterator]: iterate };
+    }
+    const parser = definition.createParser();
+    const handle = startProcess({
+        command: definition.command,
+        args: plan.args,
+        cwd: task.cwd,
+        env: plan.env,
+        timeoutMs: task.timeoutMs,
+        signal: task.signal,
+        onLine(line) {
+            let value;
+            try {
+                value = JSON.parse(line);
+            }
+            catch {
+                recorder.emit({ type: 'raw', line });
+                return;
+            }
+            for (const event of parser.event(value))
+                recorder.emit(event);
+        },
+        onStderr: (text) => recorder.emit({ type: 'stderr', text }),
+    });
+    // A consumer that falls behind pauses the agent instead of buffering its output without bound.
+    recorder.events.onPressure = (paused) => (paused ? handle.pause() : handle.resume());
+    return {
+        result: handle.exit.then((exit) => {
+            plan.cleanup();
+            return recorder.finish(exit, parser.outcome?.());
+        }),
+        abort: handle.kill,
+        [Symbol.asyncIterator]: iterate,
+    };
+}
+//# sourceMappingURL=cli-agent.js.map

package/dist/agents/cli-agent.js.map

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

package/dist/agents/discovery.d.ts

@@ -0,0 +1,10 @@
+import type { CodingAgent } from './types.js';
+/** Resolve an executable the way a shell would: absolute path, or the first match on PATH. */
+export declare function findExecutable(command: string, env?: NodeJS.ProcessEnv): string | null;
+export interface AgentAvailability {
+    agent: CodingAgent;
+    /** Resolved executable, or null when the agent's command is not installed. */
+    path: string | null;
+}
+/** Report which agents have their CLI installed. Presence only; login and flags are the agent's concern. */
+export declare function detectAgents(agents: readonly CodingAgent[], env?: NodeJS.ProcessEnv): AgentAvailability[];

package/dist/agents/discovery.js

@@ -0,0 +1,31 @@
+import { accessSync, constants, statSync } from 'node:fs';
+import { delimiter, isAbsolute, join } from 'node:path';
+/** Resolve an executable the way a shell would: absolute path, or the first match on PATH. */
+export function findExecutable(command, env = process.env) {
+    const windows = process.platform === 'win32';
+    const extensions = windows ? ['', ...(env.PATHEXT ?? '.EXE;.CMD;.BAT;.COM').split(';')] : [''];
+    const candidates = isAbsolute(command)
+        ? extensions.map((extension) => command + extension)
+        : (env.PATH ?? env.Path ?? '')
+            .split(delimiter)
+            .filter(Boolean)
+            .flatMap((dir) => extensions.map((extension) => join(dir, command + extension)));
+    for (const candidate of candidates) {
+        try {
+            if (!statSync(candidate).isFile())
+                continue;
+            if (!windows)
+                accessSync(candidate, constants.X_OK);
+            return candidate;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+/** Report which agents have their CLI installed. Presence only; login and flags are the agent's concern. */
+export function detectAgents(agents, env = process.env) {
+    return agents.map((agent) => ({ agent, path: findExecutable(agent.command, env) }));
+}
+//# sourceMappingURL=discovery.js.map

package/dist/agents/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/agents/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGxD,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,MAAyB,OAAO,CAAC,GAAG;IAClF,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,qBAAqB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/F,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC;QACpC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,GAAG,SAAS,CAAC;QACpD,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;aACzB,KAAK,CAAC,SAAS,CAAC;aAChB,MAAM,CAAC,OAAO,CAAC;aACf,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IACvF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE;gBAAE,SAAS;YAC5C,IAAI,CAAC,OAAO;gBAAE,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YACpD,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAQD,4GAA4G;AAC5G,MAAM,UAAU,YAAY,CAC1B,MAA8B,EAC9B,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/dist/agents/drivers/claude.d.ts

@@ -0,0 +1,25 @@
+import { type AgentOutputParser } from '../cli-agent.js';
+import type { AgentTask, CodingAgent, McpServer } from '../types.js';
+export type ClaudePermissionMode = 'acceptEdits' | 'auto' | 'bypassPermissions' | 'dontAsk' | 'manual' | 'plan' | (string & Record<never, never>);
+export interface ClaudeAgentOptions {
+    /** Executable name or path. Default `claude`. */
+    command?: string;
+    /** Default `acceptEdits`: file edits run unattended, other tools follow Claude Code settings. */
+    permissionMode?: ClaudePermissionMode;
+    /** Passed as `--allowedTools`. */
+    allowedTools?: readonly string[];
+    /** Passed as `--disallowedTools`. */
+    disallowedTools?: readonly string[];
+    /** With `task.mcpServers`: ignore MCP servers from the user's own Claude Code config. Default false. */
+    strictMcpConfig?: boolean;
+    /** With `task.mcpServers`: pre-allow every tool of those servers. Default true (headless runs cannot ask). */
+    allowMcpTools?: boolean;
+}
+/** Claude Code in print mode (`claude -p --output-format stream-json`). */
+export declare function claude(options?: ClaudeAgentOptions): CodingAgent;
+/** The `--mcp-config` document for a set of servers. */
+export declare function claudeMcpConfig(servers: readonly McpServer[]): {
+    mcpServers: Record<string, unknown>;
+};
+export declare function claudeArgs(task: AgentTask, options?: ClaudeAgentOptions, mcpConfigPath?: string): string[];
+export declare function createClaudeParser(): AgentOutputParser;

package/dist/agents/drivers/claude.js

@@ -0,0 +1,184 @@
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { cliAgent } from '../cli-agent.js';
+import { isHttpServer } from '../prepare.js';
+import { isObject, numberField, positionalPrompt, stringField } from './json.js';
+const EDIT_TOOLS = new Set(['Edit', 'Write', 'MultiEdit', 'NotebookEdit']);
+/** Claude Code in print mode (`claude -p --output-format stream-json`). */
+export function claude(options = {}) {
+    return cliAgent({
+        name: 'claude',
+        command: options.command ?? 'claude',
+        capabilities: { effort: ['low', 'medium', 'high', 'xhigh', 'max'], maxTurns: true, usage: true, mcp: true },
+        args: (task) => claudeArgs(task, options),
+        prepare: (task) => prepareClaude(task, options),
+        createParser: createClaudeParser,
+    });
+}
+/** Write the task's MCP servers to a private temp file, so header secrets stay out of argv. */
+function prepareClaude(task, options) {
+    if (!task.mcpServers?.length)
+        return { args: claudeArgs(task, options) };
+    const dir = mkdtempSync(join(tmpdir(), 'genaicode-claude-mcp-'));
+    const file = join(dir, 'mcp.json');
+    writeFileSync(file, JSON.stringify(claudeMcpConfig(task.mcpServers)), { mode: 0o600 });
+    return {
+        args: claudeArgs(task, options, file),
+        cleanup: () => rmSync(dir, { recursive: true, force: true }),
+    };
+}
+/** The `--mcp-config` document for a set of servers. */
+export function claudeMcpConfig(servers) {
+    const mcpServers = {};
+    for (const server of servers) {
+        mcpServers[server.name] = isHttpServer(server)
+            ? { type: 'http', url: server.url, ...(server.headers ? { headers: server.headers } : {}) }
+            : {
+                command: server.command,
+                args: [...(server.args ?? [])],
+                ...(server.env ? { env: server.env } : {}),
+            };
+    }
+    return { mcpServers };
+}
+export function claudeArgs(task, options = {}, mcpConfigPath) {
+    const args = ['-p', '--verbose'];
+    // Multi-value flags come first: a single-value flag must follow them before the prompt.
+    if (mcpConfigPath)
+        args.push('--mcp-config', mcpConfigPath);
+    if (mcpConfigPath && options.strictMcpConfig)
+        args.push('--strict-mcp-config');
+    const allowed = [
+        ...(options.allowedTools ?? []),
+        ...(mcpConfigPath && (options.allowMcpTools ?? true) ? (task.mcpServers ?? []).map((s) => `mcp__${s.name}`) : []),
+    ];
+    if (allowed.length)
+        args.push('--allowedTools', allowed.join(','));
+    if (options.disallowedTools?.length)
+        args.push('--disallowedTools', options.disallowedTools.join(','));
+    args.push('--output-format', 'stream-json', '--permission-mode', options.permissionMode ?? 'acceptEdits');
+    if (task.model)
+        args.push('--model', task.model);
+    if (task.effort)
+        args.push('--effort', task.effort);
+    if (task.maxTurns !== undefined)
+        args.push('--max-turns', String(task.maxTurns));
+    if (task.extraArgs)
+        args.push(...task.extraArgs);
+    return [...args, ...positionalPrompt(task.prompt)];
+}
+export function createClaudeParser() {
+    const toolNames = new Map();
+    let outcome;
+    let sessionSent = false;
+    let lastMessage;
+    return {
+        outcome: () => outcome,
+        event(value) {
+            if (!isObject(value))
+                return [];
+            const events = [];
+            const sessionId = stringField(value, 'session_id');
+            if (sessionId && !sessionSent) {
+                sessionSent = true;
+                events.push({ type: 'session', sessionId, ...modelOf(value) });
+            }
+            switch (value.type) {
+                case 'assistant':
+                    for (const block of contentBlocks(value.message)) {
+                        if (block.type === 'text' && typeof block.text === 'string' && block.text.trim()) {
+                            lastMessage = block.text;
+                            events.push({ type: 'message', text: block.text });
+                        }
+                        else if (block.type === 'tool_use' && typeof block.name === 'string') {
+                            const id = typeof block.id === 'string' ? block.id : undefined;
+                            if (id)
+                                toolNames.set(id, block.name);
+                            events.push({ type: 'tool-start', ...(id ? { id } : {}), name: block.name, input: block.input });
+                            const path = stringField(block.input, 'file_path') ?? stringField(block.input, 'notebook_path');
+                            if (EDIT_TOOLS.has(block.name) && path)
+                                events.push({ type: 'file-change', paths: [path] });
+                        }
+                    }
+                    break;
+                case 'user':
+                    for (const block of contentBlocks(value.message)) {
+                        if (block.type !== 'tool_result')
+                            continue;
+                        const id = typeof block.tool_use_id === 'string' ? block.tool_use_id : undefined;
+                        const name = id ? toolNames.get(id) : undefined;
+                        const output = toolOutput(block.content);
+                        events.push({
+                            type: 'tool-end',
+                            ...(id ? { id } : {}),
+                            ...(name ? { name } : {}),
+                            isError: block.is_error === true,
+                            ...(output !== undefined ? { output } : {}),
+                        });
+                    }
+                    break;
+                case 'stream_event': {
+                    const delta = isObject(value.event) ? value.event.delta : undefined;
+                    const text = stringField(delta, 'text');
+                    if (stringField(delta, 'type') === 'text_delta' && text)
+                        events.push({ type: 'text-delta', text });
+                    break;
+                }
+                case 'result': {
+                    const failed = value.is_error === true || (value.subtype !== undefined && value.subtype !== 'success');
+                    const text = stringField(value, 'result');
+                    outcome = failed
+                        ? { ok: false, error: text || `Claude stopped: ${String(value.subtype ?? 'error')}.` }
+                        : { ok: true };
+                    const usage = value.usage;
+                    if (isObject(usage)) {
+                        const inputTokens = numberField(usage, 'input_tokens');
+                        const outputTokens = numberField(usage, 'output_tokens');
+                        const cachedInputTokens = numberField(usage, 'cache_read_input_tokens');
+                        const costUsd = numberField(value, 'total_cost_usd');
+                        events.push({
+                            type: 'usage',
+                            usage: {
+                                ...(inputTokens !== undefined ? { inputTokens } : {}),
+                                ...(outputTokens !== undefined ? { outputTokens } : {}),
+                                ...(cachedInputTokens !== undefined ? { cachedInputTokens } : {}),
+                                ...(inputTokens !== undefined && outputTokens !== undefined
+                                    ? { totalTokens: inputTokens + outputTokens }
+                                    : {}),
+                            },
+                            ...(costUsd !== undefined ? { costUsd } : {}),
+                        });
+                    }
+                    // The result repeats the last assistant message; only surface it when it differs.
+                    if (!failed && text && text !== lastMessage)
+                        events.push({ type: 'message', text });
+                    if (failed)
+                        events.push({ type: 'error', message: outcome.error });
+                    break;
+                }
+            }
+            return events;
+        },
+    };
+}
+function contentBlocks(message) {
+    const content = isObject(message) ? message.content : undefined;
+    return Array.isArray(content) ? content.filter(isObject) : [];
+}
+function modelOf(value) {
+    const model = stringField(value, 'model');
+    return model ? { model } : {};
+}
+function toolOutput(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return undefined;
+    const text = content
+        .map((part) => stringField(part, 'text'))
+        .filter((part) => part !== undefined)
+        .join('\n');
+    return text || undefined;
+}
+//# sourceMappingURL=claude.js.map

package/dist/agents/drivers/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../src/agents/drivers/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAA6C,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAoB,MAAM,eAAe,CAAC;AAE/D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AA0BjF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;AAE3E,2EAA2E;AAC3E,MAAM,UAAU,MAAM,CAAC,UAA8B,EAAE;IACrD,OAAO,QAAQ,CAAC;QACd,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,QAAQ;QACpC,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE;QAC3G,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC;QACzC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC;QAC/C,YAAY,EAAE,kBAAkB;KACjC,CAAC,CAAC;AACL,CAAC;AAED,+FAA+F;AAC/F,SAAS,aAAa,CAAC,IAAe,EAAE,OAA2B;IACjE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;IACzE,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACnC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvF,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,eAAe,CAAC,OAA6B;IAC3D,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC;YAC5C,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;YAC3F,CAAC,CAAC;gBACE,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;gBAC9B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3C,CAAC;IACR,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAe,EAAE,UAA8B,EAAE,EAAE,aAAsB;IAClG,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACjC,wFAAwF;IACxF,IAAI,aAAa;QAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IAC5D,IAAI,aAAa,IAAI,OAAO,CAAC,eAAe;QAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG;QACd,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;QAC/B,GAAG,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAClH,CAAC;IACF,IAAI,OAAO,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,eAAe,EAAE,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACvG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,aAAa,EAAE,mBAAmB,EAAE,OAAO,CAAC,cAAc,IAAI,aAAa,CAAC,CAAC;IAC1G,IAAI,IAAI,CAAC,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjF,IAAI,IAAI,CAAC,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,IAAI,OAAiC,CAAC;IACtC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,WAA+B,CAAC;IAEpC,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO;QACtB,KAAK,CAAC,KAAK;YACT,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAChC,MAAM,MAAM,GAAiB,EAAE,CAAC;YAChC,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;YACnD,IAAI,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC9B,WAAW,GAAG,IAAI,CAAC;gBACnB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjE,CAAC;YAED,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACnB,KAAK,WAAW;oBACd,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;wBACjD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;4BACjF,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC;4BACzB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;wBACrD,CAAC;6BAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;4BACvE,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;4BAC/D,IAAI,EAAE;gCAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;4BACtC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;4BACjG,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;4BAChG,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI;gCAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBAC9F,CAAC;oBACH,CAAC;oBACD,MAAM;gBACR,KAAK,MAAM;oBACT,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;wBACjD,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;4BAAE,SAAS;wBAC3C,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;wBACjF,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;wBAChD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;wBACzC,MAAM,CAAC,IAAI,CAAC;4BACV,IAAI,EAAE,UAAU;4BAChB,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;4BACrB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;4BACzB,OAAO,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI;4BAChC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;yBAC5C,CAAC,CAAC;oBACL,CAAC;oBACD,MAAM;gBACR,KAAK,cAAc,CAAC,CAAC,CAAC;oBACpB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;oBACpE,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;oBACxC,IAAI,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,YAAY,IAAI,IAAI;wBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;oBACnG,MAAM;gBACR,CAAC;gBACD,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;oBACvG,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;oBAC1C,OAAO,GAAG,MAAM;wBACd,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,IAAI,mBAAmB,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE;wBACtF,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;oBACjB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;oBAC1B,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;wBACpB,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;wBACvD,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;wBACzD,MAAM,iBAAiB,GAAG,WAAW,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;wBACxE,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;wBACrD,MAAM,CAAC,IAAI,CAAC;4BACV,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE;gCACL,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gCACrD,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gCACvD,GAAG,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gCACjE,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS;oCACzD,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,GAAG,YAAY,EAAE;oCAC7C,CAAC,CAAC,EAAE,CAAC;6BACR;4BACD,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;yBAC9C,CAAC,CAAC;oBACL,CAAC;oBACD,kFAAkF;oBAClF,IAAI,CAAC,MAAM,IAAI,IAAI,IAAI,IAAI,KAAK,WAAW;wBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBACpF,IAAI,MAAM;wBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,KAAM,EAAE,CAAC,CAAC;oBACpE,MAAM;gBACR,CAAC;YACH,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAID,SAAS,aAAa,CAAC,OAAgB;IACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,OAAO,CAAC,KAA8B;IAC7C,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,UAAU,CAAC,OAAgB;IAClC,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,IAAI,GAAG,OAAO;SACjB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;SACxC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC;SACpD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,IAAI,IAAI,SAAS,CAAC;AAC3B,CAAC"}

package/dist/agents/drivers/codex-live.d.ts

@@ -0,0 +1,17 @@
+import type { AgentEvent, CodingAgent } from '../types.js';
+import { type CodexSandbox } from './codex.js';
+export interface CodexLiveOptions {
+    /** Executable name or path. Default `codex`. */
+    command?: string;
+    /** Default `workspace-write`. */
+    sandbox?: CodexSandbox;
+    /** How long to wait for the server to acknowledge each request. Default 60 s. */
+    requestTimeoutMs?: number;
+}
+/**
+ * Codex over its app server (`codex app-server`, JSON-RPC on stdio).
+ * Supports `steer()` and routes command and file-change approvals to `task.onApproval`.
+ */
+export declare function codexLive(options?: CodexLiveOptions): CodingAgent;
+/** Map one app-server notification to agent events. */
+export declare function codexNotification(method: string, params: unknown): AgentEvent[];