genaicode 2.3.0 → 2.4.0

package/dist/agents/drivers/codex-live.js

@@ -0,0 +1,182 @@
+import { liveAgent } from '../live-agent.js';
+import { withCodexMcp } from './codex.js';
+import { isObject, numberField, stringField } from './json.js';
+/**
+ * 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 function codexLive(options = {}) {
+    return liveAgent({
+        name: 'codex',
+        command: options.command ?? 'codex',
+        capabilities: { effort: ['minimal', 'low', 'medium', 'high', 'xhigh'], usage: true, approvals: true, mcp: true },
+        args: (task) => [...(task.extraArgs ?? []), 'app-server'],
+        prepare: (task) => withCodexMcp(task, [...(task.extraArgs ?? []), 'app-server']),
+        drive: (session) => driveCodex(session, options),
+    });
+}
+async function driveCodex(session, options) {
+    const { task, rpc } = session;
+    const timeout = options.requestTimeoutMs ?? 60_000;
+    // Filled in as the server replies; notifications before then are not ours.
+    const ids = {};
+    let finish = () => { };
+    const finished = new Promise((resolve) => {
+        finish = resolve;
+    });
+    const ours = (params) => ids.thread !== undefined && stringField(params, 'threadId') === ids.thread;
+    session.onNotification((method, params) => {
+        if (!ours(params))
+            return;
+        if (method === 'turn/completed') {
+            const turn = isObject(params) && isObject(params.turn) ? params.turn : undefined;
+            if (ids.turn && stringField(turn, 'id') && stringField(turn, 'id') !== ids.turn)
+                return;
+            const status = stringField(turn, 'status');
+            const error = stringField(turn?.error, 'message');
+            if (error)
+                session.emit({ type: 'error', message: error });
+            finish(status === 'completed' ? { ok: true } : { ok: false, error: error ?? `Codex turn ${status ?? 'ended'}.` });
+            return;
+        }
+        for (const event of codexNotification(method, params))
+            session.emit(event);
+    });
+    let approvals = 0;
+    session.onRequest(async (method, params) => {
+        const legacy = method === 'execCommandApproval' || method === 'applyPatchApproval';
+        const kind = method.includes('commandExecution') || method === 'execCommandApproval' ? 'command' : 'file-change';
+        if (!legacy && !method.endsWith('/requestApproval'))
+            throw new Error(`${method} is not supported.`);
+        const request = {
+            // One item can raise several approvals (e.g. per shell subcommand); `approvalId` tells them apart.
+            id: stringField(params, 'approvalId') ??
+                stringField(params, 'itemId') ??
+                stringField(params, 'callId') ??
+                `approval-${++approvals}`,
+            kind,
+            ...summaryOf(params),
+            detail: params,
+        };
+        const decision = await session.approve(request);
+        if (legacy)
+            return { decision: decision === 'approve' ? 'approved' : 'denied' };
+        return { decision: decision === 'approve' ? 'accept' : 'decline' };
+    });
+    await rpc.request('initialize', { clientInfo: { name: 'genaicode', version: '2' } }, timeout);
+    rpc.notify('initialized');
+    const thread = await rpc.request('thread/start', {
+        cwd: task.cwd,
+        ...(task.model ? { model: task.model } : {}),
+        sandbox: options.sandbox ?? 'workspace-write',
+        approvalPolicy: task.onApproval ? 'on-request' : 'never',
+    }, timeout);
+    const threadId = stringField(isObject(thread) ? thread.thread : undefined, 'id');
+    ids.thread = threadId;
+    if (!threadId)
+        throw new Error('Codex did not return a thread id.');
+    session.emit({ type: 'session', sessionId: threadId });
+    const input = (text) => [{ type: 'text', text }];
+    const started = await rpc.request('turn/start', { threadId, input: input(task.prompt), ...(task.effort ? { effort: task.effort } : {}) }, timeout);
+    const turnId = stringField(isObject(started) ? started.turn : undefined, 'id');
+    ids.turn = turnId;
+    if (!turnId)
+        throw new Error('Codex did not return a turn id.');
+    session.setSteer(async (text) => {
+        await rpc.request('turn/steer', { threadId, expectedTurnId: turnId, input: input(text) }, timeout);
+    });
+    return finished;
+}
+/** Map one app-server notification to agent events. */
+export function codexNotification(method, params) {
+    if (!isObject(params))
+        return [];
+    const item = isObject(params.item) ? params.item : undefined;
+    const type = stringField(item, 'type');
+    const id = stringField(item, 'id');
+    const withId = id ? { id } : {};
+    switch (method) {
+        case 'item/agentMessage/delta': {
+            const delta = stringField(params, 'delta');
+            return delta ? [{ type: 'text-delta', text: delta }] : [];
+        }
+        case 'item/started':
+            if (type === 'commandExecution')
+                return [{ type: 'tool-start', ...withId, name: 'shell', input: { command: item.command } }];
+            if (type === 'mcpToolCall')
+                return [{ type: 'tool-start', ...withId, name: mcpName(item), input: item.arguments }];
+            return [];
+        case 'item/completed':
+            if (type === 'agentMessage') {
+                const text = stringField(item, 'text');
+                return text ? [{ type: 'message', text }] : [];
+            }
+            if (type === 'commandExecution') {
+                const exitCode = numberField(item, 'exitCode');
+                const output = stringField(item, 'aggregatedOutput');
+                return [
+                    {
+                        type: 'tool-end',
+                        ...withId,
+                        name: 'shell',
+                        isError: item.status === 'failed' || (exitCode !== undefined && exitCode !== 0),
+                        ...(output !== undefined ? { output } : {}),
+                    },
+                ];
+            }
+            if (type === 'mcpToolCall')
+                return [
+                    {
+                        type: 'tool-end',
+                        ...withId,
+                        name: mcpName(item),
+                        isError: item.status === 'failed' || (item.error !== undefined && item.error !== null),
+                    },
+                ];
+            if (type === 'fileChange') {
+                const paths = Array.isArray(item.changes)
+                    ? item.changes.map((change) => stringField(change, 'path')).filter((path) => !!path)
+                    : [];
+                return paths.length ? [{ type: 'file-change', paths }] : [];
+            }
+            return [];
+        case 'thread/tokenUsage/updated': {
+            const usage = isObject(params.tokenUsage) ? params.tokenUsage : undefined;
+            const total = isObject(usage?.total) ? usage.total : usage;
+            const inputTokens = numberField(total, 'inputTokens');
+            const outputTokens = numberField(total, 'outputTokens');
+            const cachedInputTokens = numberField(total, 'cachedInputTokens');
+            if (inputTokens === undefined && outputTokens === undefined)
+                return [];
+            return [
+                {
+                    type: 'usage',
+                    usage: {
+                        ...(inputTokens !== undefined ? { inputTokens } : {}),
+                        ...(outputTokens !== undefined ? { outputTokens } : {}),
+                        ...(cachedInputTokens !== undefined ? { cachedInputTokens } : {}),
+                        ...(inputTokens !== undefined && outputTokens !== undefined
+                            ? { totalTokens: inputTokens + outputTokens }
+                            : {}),
+                    },
+                },
+            ];
+        }
+        case 'error': {
+            const message = stringField(params.error, 'message') ?? stringField(params, 'message');
+            return message ? [{ type: 'error', message }] : [];
+        }
+        default:
+            return [];
+    }
+}
+function summaryOf(params) {
+    const command = isObject(params) ? params.command : undefined;
+    const text = Array.isArray(command) ? command.join(' ') : typeof command === 'string' ? command : undefined;
+    const summary = text ?? stringField(params, 'reason');
+    return summary ? { summary } : {};
+}
+function mcpName(item) {
+    return [stringField(item, 'server'), stringField(item, 'tool')].filter(Boolean).join('/') || 'mcp';
+}
+//# sourceMappingURL=codex-live.js.map

package/dist/agents/drivers/codex-live.js.map

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

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

@@ -0,0 +1,27 @@
+import { type AgentOutputParser } from '../cli-agent.js';
+import { type PreparedRun } from '../prepare.js';
+import type { AgentTask, CodingAgent, McpServer } from '../types.js';
+export type CodexSandbox = 'read-only' | 'workspace-write' | 'danger-full-access';
+export interface CodexAgentOptions {
+    /** Executable name or path. Default `codex`. */
+    command?: string;
+    /** Default `workspace-write`: edits inside `cwd`, no network. */
+    sandbox?: CodexSandbox;
+    /** Allow running outside a git repository. Default true. */
+    skipGitRepoCheck?: boolean;
+}
+/** OpenAI Codex CLI in exec mode (`codex exec --json`). */
+export declare function codex(options?: CodexAgentOptions): CodingAgent;
+export declare function codexArgs(task: AgentTask, options?: CodexAgentOptions): string[];
+/** Prefix `args` with the task's MCP servers as `-c mcp_servers.*` config overrides. */
+export declare function withCodexMcp(task: AgentTask, args: string[]): PreparedRun;
+/**
+ * Config overrides for Codex MCP servers. Secrets never go on the command line: HTTP
+ * header values travel in environment variables (`env_http_headers`), and a stdio
+ * server's `env` is set on Codex's environment and forwarded by name (`env_vars`).
+ */
+export declare function codexMcpOverrides(servers: readonly McpServer[]): {
+    args: string[];
+    env: Record<string, string>;
+};
+export declare function createCodexParser(): AgentOutputParser;

package/dist/agents/drivers/codex.js

@@ -0,0 +1,176 @@
+import { cliAgent } from '../cli-agent.js';
+import { isHttpServer } from '../prepare.js';
+import { isObject, numberField, positionalPrompt, stringField } from './json.js';
+/** OpenAI Codex CLI in exec mode (`codex exec --json`). */
+export function codex(options = {}) {
+    return cliAgent({
+        name: 'codex',
+        command: options.command ?? 'codex',
+        capabilities: { effort: ['minimal', 'low', 'medium', 'high', 'xhigh'], usage: true, mcp: true },
+        args: (task) => codexArgs(task, options),
+        prepare: (task) => withCodexMcp(task, codexArgs(task, options)),
+        createParser: createCodexParser,
+    });
+}
+export function codexArgs(task, options = {}) {
+    const args = ['exec', '--json', '--sandbox', options.sandbox ?? 'workspace-write'];
+    if (options.skipGitRepoCheck ?? true)
+        args.push('--skip-git-repo-check');
+    if (task.model)
+        args.push('--model', task.model);
+    if (task.effort)
+        args.push('-c', `model_reasoning_effort=${JSON.stringify(task.effort)}`);
+    if (task.extraArgs)
+        args.push(...task.extraArgs);
+    return [...args, ...positionalPrompt(task.prompt)];
+}
+/** Prefix `args` with the task's MCP servers as `-c mcp_servers.*` config overrides. */
+export function withCodexMcp(task, args) {
+    if (!task.mcpServers?.length)
+        return { args };
+    const mcp = codexMcpOverrides(task.mcpServers);
+    return { args: [...mcp.args, ...args], env: mcp.env };
+}
+/**
+ * Config overrides for Codex MCP servers. Secrets never go on the command line: HTTP
+ * header values travel in environment variables (`env_http_headers`), and a stdio
+ * server's `env` is set on Codex's environment and forwarded by name (`env_vars`).
+ */
+export function codexMcpOverrides(servers) {
+    const args = [];
+    const env = {};
+    const set = (key, value) => args.push('-c', `${key}=${value}`);
+    servers.forEach((server, index) => {
+        const key = `mcp_servers.${server.name}`;
+        if (isHttpServer(server)) {
+            set(`${key}.url`, JSON.stringify(server.url));
+            const headers = Object.entries(server.headers ?? {});
+            if (headers.length) {
+                const table = headers.map(([header, value], headerIndex) => {
+                    const variable = `GENAICODE_MCP_${index}_HEADER_${headerIndex}`;
+                    env[variable] = value;
+                    return `${JSON.stringify(header)} = ${JSON.stringify(variable)}`;
+                });
+                set(`${key}.env_http_headers`, `{ ${table.join(', ')} }`);
+            }
+        }
+        else {
+            set(`${key}.command`, JSON.stringify(server.command));
+            set(`${key}.args`, JSON.stringify(server.args ?? []));
+            // Values go into Codex's own environment and are forwarded by name (`env_vars`), so no
+            // server secret ever reaches argv.
+            const entries = Object.entries(server.env ?? {});
+            for (const [name, value] of entries) {
+                if (name in env && env[name] !== value) {
+                    throw new Error(`MCP servers need different values for ${name}; Codex can forward only one.`);
+                }
+                env[name] = value;
+            }
+            if (entries.length)
+                set(`${key}.env_vars`, JSON.stringify(entries.map(([name]) => name)));
+        }
+    });
+    return { args, env };
+}
+export function createCodexParser() {
+    let outcome;
+    return {
+        outcome: () => outcome,
+        event(value) {
+            if (!isObject(value))
+                return [];
+            const events = [];
+            const type = stringField(value, 'type');
+            const item = isObject(value.item) ? value.item : undefined;
+            const itemType = stringField(item, 'type');
+            const id = stringField(item, 'id');
+            const withId = id ? { id } : {};
+            if (type === 'thread.started') {
+                const sessionId = stringField(value, 'thread_id');
+                if (sessionId)
+                    events.push({ type: 'session', sessionId });
+            }
+            else if (type === 'item.started' && item) {
+                if (itemType === 'command_execution') {
+                    events.push({ type: 'tool-start', ...withId, name: 'shell', input: { command: item.command } });
+                }
+                else if (itemType === 'mcp_tool_call') {
+                    events.push({ type: 'tool-start', ...withId, name: mcpName(item), input: item.arguments });
+                }
+            }
+            else if (type === 'item.completed' && item) {
+                if (itemType === 'agent_message') {
+                    const text = stringField(item, 'text');
+                    if (text)
+                        events.push({ type: 'message', text });
+                }
+                else if (itemType === 'command_execution') {
+                    const output = stringField(item, 'aggregated_output');
+                    const exitCode = numberField(item, 'exit_code');
+                    events.push({
+                        type: 'tool-end',
+                        ...withId,
+                        name: 'shell',
+                        isError: item.status === 'failed' || (exitCode !== undefined && exitCode !== 0),
+                        ...(output !== undefined ? { output } : {}),
+                    });
+                }
+                else if (itemType === 'mcp_tool_call') {
+                    events.push({
+                        type: 'tool-end',
+                        ...withId,
+                        name: mcpName(item),
+                        isError: item.status === 'failed' || item.error !== undefined,
+                    });
+                }
+                else if (itemType === 'file_change') {
+                    const paths = Array.isArray(item.changes)
+                        ? item.changes.map((change) => stringField(change, 'path')).filter((path) => !!path)
+                        : [];
+                    if (paths.length)
+                        events.push({ type: 'file-change', paths });
+                }
+                else if (itemType === 'error') {
+                    const message = stringField(item, 'message');
+                    if (message)
+                        events.push({ type: 'error', message });
+                }
+            }
+            else if (type === 'turn.completed') {
+                outcome = { 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, 'cached_input_tokens');
+                    events.push({
+                        type: 'usage',
+                        usage: {
+                            ...(inputTokens !== undefined ? { inputTokens } : {}),
+                            ...(outputTokens !== undefined ? { outputTokens } : {}),
+                            ...(cachedInputTokens !== undefined ? { cachedInputTokens } : {}),
+                            ...(inputTokens !== undefined && outputTokens !== undefined
+                                ? { totalTokens: inputTokens + outputTokens }
+                                : {}),
+                        },
+                    });
+                }
+            }
+            else if (type === 'turn.failed') {
+                const message = stringField(value.error, 'message') ?? 'Codex turn failed.';
+                outcome = { ok: false, error: message };
+                events.push({ type: 'error', message });
+            }
+            else if (type === 'error') {
+                const message = stringField(value, 'message');
+                if (message)
+                    events.push({ type: 'error', message });
+            }
+            return events;
+        },
+    };
+}
+function mcpName(item) {
+    return [stringField(item, 'server'), stringField(item, 'tool')].filter(Boolean).join('/') || 'mcp';
+}
+//# sourceMappingURL=codex.js.map

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

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

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

@@ -0,0 +1,27 @@
+import { type AgentOutputParser } from '../cli-agent.js';
+import type { AgentTask, CodingAgent, McpServer } from '../types.js';
+export interface CopilotAgentOptions {
+    /** Executable name or path. Default `copilot`. */
+    command?: string;
+    /**
+     * Pass `--allow-all-tools`. Default true: without it a headless run cannot approve a tool.
+     * `denyTools` still wins over it.
+     */
+    allowAllTools?: boolean;
+    /** Permission patterns passed as `--allow-tool`, e.g. `shell(git:*)` or `write`. */
+    allowTools?: readonly string[];
+    /** Permission patterns passed as `--deny-tool`, e.g. `shell` or `shell(rm)`. */
+    denyTools?: readonly string[];
+    /** Keep the `ask_user` tool. Default false (`--no-ask-user`): a headless run has nobody to ask. */
+    askUser?: boolean;
+    /** With `task.mcpServers` and `allowAllTools: false`: pre-allow every tool of those servers. Default true. */
+    allowMcpTools?: boolean;
+}
+/** GitHub Copilot CLI in prompt mode (`copilot --prompt=… --output-format json`). */
+export declare function copilot(options?: CopilotAgentOptions): CodingAgent;
+/** The `--additional-mcp-config` document for a set of servers. */
+export declare function copilotMcpConfig(servers: readonly McpServer[]): {
+    mcpServers: Record<string, unknown>;
+};
+export declare function copilotArgs(task: AgentTask, options?: CopilotAgentOptions, mcpConfigPath?: string): string[];
+export declare function createCopilotParser(): AgentOutputParser;

package/dist/agents/drivers/copilot.js

@@ -0,0 +1,199 @@
+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, stringField } from './json.js';
+const EDIT_TOOLS = new Set(['edit', 'create', 'str_replace_editor']);
+/** GitHub Copilot CLI in prompt mode (`copilot --prompt=… --output-format json`). */
+export function copilot(options = {}) {
+    return cliAgent({
+        name: 'copilot',
+        command: options.command ?? 'copilot',
+        capabilities: {
+            effort: ['none', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'],
+            usage: true,
+            mcp: true,
+        },
+        args: (task) => copilotArgs(task, options),
+        prepare: (task) => prepareCopilot(task, options),
+        createParser: createCopilotParser,
+    });
+}
+/** Write the task's MCP servers to a private temp file, so header secrets stay out of argv. */
+function prepareCopilot(task, options) {
+    if (!task.mcpServers?.length)
+        return { args: copilotArgs(task, options) };
+    const dir = mkdtempSync(join(tmpdir(), 'genaicode-copilot-mcp-'));
+    const file = join(dir, 'mcp.json');
+    writeFileSync(file, JSON.stringify(copilotMcpConfig(task.mcpServers)), { mode: 0o600 });
+    return {
+        args: copilotArgs(task, options, file),
+        cleanup: () => rmSync(dir, { recursive: true, force: true }),
+    };
+}
+/** The `--additional-mcp-config` document for a set of servers. */
+export function copilotMcpConfig(servers) {
+    const mcpServers = {};
+    for (const server of servers) {
+        mcpServers[server.name] = isHttpServer(server)
+            ? { type: 'http', url: server.url, tools: ['*'], ...(server.headers ? { headers: server.headers } : {}) }
+            : {
+                type: 'local',
+                command: server.command,
+                args: [...(server.args ?? [])],
+                tools: ['*'],
+                ...(server.env ? { env: server.env } : {}),
+            };
+    }
+    return { mcpServers };
+}
+export function copilotArgs(task, options = {}, mcpConfigPath) {
+    const args = ['--output-format', 'json'];
+    if (options.allowAllTools ?? true)
+        args.push('--allow-all-tools');
+    // `--allow-tool` and `--deny-tool` take several values; the `=` form keeps each one to a single value.
+    const allowed = [
+        ...(options.allowTools ?? []),
+        ...(mcpConfigPath && !(options.allowAllTools ?? true) && (options.allowMcpTools ?? true)
+            ? (task.mcpServers ?? []).map((server) => server.name)
+            : []),
+    ];
+    for (const tool of allowed)
+        args.push(`--allow-tool=${tool}`);
+    for (const tool of options.denyTools ?? [])
+        args.push(`--deny-tool=${tool}`);
+    if (!options.askUser)
+        args.push('--no-ask-user');
+    if (mcpConfigPath)
+        args.push('--additional-mcp-config', `@${mcpConfigPath}`);
+    if (task.model)
+        args.push('--model', task.model);
+    if (task.effort)
+        args.push('--reasoning-effort', task.effort);
+    if (task.extraArgs)
+        args.push(...task.extraArgs);
+    // `--prompt=<text>` keeps a prompt that starts with a dash from reading as a flag.
+    return [...args, `--prompt=${task.prompt}`];
+}
+export function createCopilotParser() {
+    const toolCalls = new Map();
+    const changed = new Set();
+    const usage = { outputTokens: 0, reported: false };
+    let outcome;
+    let sessionSent = false;
+    let lastError;
+    const session = (sessionId, model) => {
+        if (!sessionId || sessionSent)
+            return [];
+        sessionSent = true;
+        return [{ type: 'session', sessionId, ...(model ? { model } : {}) }];
+    };
+    return {
+        outcome: () => outcome,
+        event(value) {
+            if (!isObject(value))
+                return [];
+            const data = isObject(value.data) ? value.data : {};
+            // Sub-agent traffic carries an envelope `agentId` (older CLIs: `data.parentToolCallId`);
+            // the parent's own events cover it.
+            const nested = stringField(value, 'agentId') !== undefined || stringField(data, 'parentToolCallId') !== undefined;
+            const events = [];
+            switch (value.type) {
+                case 'session.start':
+                case 'session.resume':
+                    events.push(...session(stringField(data, 'sessionId'), stringField(data, 'selectedModel')));
+                    break;
+                case 'assistant.message_delta': {
+                    const text = stringField(data, 'deltaContent');
+                    if (!nested && text)
+                        events.push({ type: 'text-delta', text });
+                    break;
+                }
+                case 'assistant.message': {
+                    const text = stringField(data, 'content');
+                    if (!nested && text?.trim())
+                        events.push({ type: 'message', text });
+                    // JSON output drops `assistant.usage`; each message still carries its output tokens.
+                    const outputTokens = numberField(data, 'outputTokens');
+                    if (outputTokens !== undefined) {
+                        usage.reported = true;
+                        usage.outputTokens += outputTokens;
+                    }
+                    break;
+                }
+                case 'tool.execution_start': {
+                    const id = stringField(data, 'toolCallId');
+                    const server = stringField(data, 'mcpServerName');
+                    const tool = stringField(data, 'mcpToolName');
+                    const name = server && tool ? `${server}/${tool}` : (stringField(data, 'toolName') ?? 'tool');
+                    const path = EDIT_TOOLS.has(name) ? stringField(data.arguments, 'path') : undefined;
+                    if (id)
+                        toolCalls.set(id, { name, ...(path ? { path } : {}) });
+                    if (!nested)
+                        events.push({ type: 'tool-start', ...(id ? { id } : {}), name, input: data.arguments });
+                    break;
+                }
+                case 'tool.execution_complete': {
+                    const id = stringField(data, 'toolCallId');
+                    const call = id ? toolCalls.get(id) : undefined;
+                    const exitCode = numberField(data.shellExecution, 'exitCode');
+                    const isError = data.success !== true || (exitCode !== undefined && exitCode !== 0);
+                    const output = stringField(data.result, 'content') ?? stringField(data.error, 'message');
+                    if (!nested) {
+                        events.push({
+                            type: 'tool-end',
+                            ...(id ? { id } : {}),
+                            ...(call ? { name: call.name } : {}),
+                            isError,
+                            ...(output !== undefined ? { output } : {}),
+                        });
+                    }
+                    if (!isError && call?.path && !changed.has(call.path)) {
+                        changed.add(call.path);
+                        events.push({ type: 'file-change', paths: [call.path] });
+                    }
+                    break;
+                }
+                case 'session.error': {
+                    const message = stringField(data, 'message');
+                    if (message) {
+                        lastError = message;
+                        events.push({ type: 'error', message });
+                    }
+                    break;
+                }
+                case 'result': {
+                    events.push(...session(stringField(value, 'sessionId')));
+                    // Shell commands and patches can modify files no edit tool reported.
+                    const modified = isObject(value.usage) && isObject(value.usage.codeChanges) ? value.usage.codeChanges : {};
+                    const paths = Array.isArray(modified.filesModified)
+                        ? modified.filesModified.filter((path) => typeof path === 'string' && !changed.has(path))
+                        : [];
+                    if (paths.length) {
+                        paths.forEach((path) => changed.add(path));
+                        events.push({ type: 'file-change', paths });
+                    }
+                    if (usage.reported)
+                        events.push({ type: 'usage', usage: { outputTokens: usage.outputTokens } });
+                    const exitCode = numberField(value, 'exitCode');
+                    const blocker = stringField(value, 'blocker');
+                    if (exitCode === 0 && value.outcome !== 'blocked') {
+                        outcome = { ok: true };
+                    }
+                    else {
+                        const error = (value.outcome === 'blocked' ? `Copilot is blocked${blocker ? `: ${blocker}` : '.'}` : undefined) ??
+                            lastError ??
+                            `Copilot exited with code ${exitCode ?? 'unknown'}.`;
+                        outcome = { ok: false, error };
+                        if (error !== lastError)
+                            events.push({ type: 'error', message: error });
+                    }
+                    break;
+                }
+            }
+            return events;
+        },
+    };
+}
+//# sourceMappingURL=copilot.js.map