genaicode 2.1.0 → 2.4.0

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

@@ -0,0 +1,112 @@
+import { liveAgent, uuidv7 } from '../live-agent.js';
+import { RpcError } from '../rpc.js';
+import { isObject, stringField } from './json.js';
+const TOOL_KINDS = new Set(['commandExecution', 'toolCall', 'mcpToolCall', 'fileChange']);
+/**
+ * Muse over its JSON-RPC server (`muse serve`). Supports `steer()`.
+ * Approval requests are reported as events and declined: the answer format is not
+ * part of this driver yet, so `capabilities.approvals` is false.
+ */
+export function museLive(options = {}) {
+    return liveAgent({
+        name: 'muse',
+        command: options.command ?? 'muse',
+        capabilities: { effort: ['minimal', 'low', 'medium', 'high', 'xhigh', 'max'], approvals: false },
+        args: (task) => [
+            'serve',
+            ...((options.trustWorkspace ?? true) ? ['--trust-workspace'] : []),
+            ...(task.extraArgs ?? []),
+        ],
+        drive: (session) => driveMuse(session, options),
+    });
+}
+async function driveMuse(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;
+    });
+    session.onNotification((method, params) => {
+        if (ids.session === undefined || stringField(params, 'sessionId') !== ids.session)
+            return;
+        if (method === 'turn/completed') {
+            if (ids.turn && stringField(params, 'turnId') && stringField(params, 'turnId') !== ids.turn)
+                return;
+            const terminal = stringField(params, 'terminal');
+            const error = stringField(isObject(params) ? params.error : undefined, 'message');
+            if (error)
+                session.emit({ type: 'error', message: error });
+            finish(terminal === 'completed' ? { ok: true } : { ok: false, error: error ?? `Muse turn ${terminal ?? 'ended'}.` });
+            return;
+        }
+        for (const event of museNotification(method, params))
+            session.emit(event);
+    });
+    session.onRequest((method, params) => {
+        if (method === 'approval/request') {
+            session.emit({
+                type: 'approval-request',
+                request: {
+                    id: stringField(params, 'id') ?? stringField(params, 'approvalId') ?? 'approval',
+                    kind: 'other',
+                    detail: params,
+                },
+            });
+        }
+        throw new RpcError('This client cannot grant this request.', -32601);
+    });
+    await rpc.request('initialize', { clientInfo: { name: 'genaicode', version: '2' }, capabilities: { userInputDialogs: false } }, timeout);
+    rpc.notify('initialized');
+    const created = await rpc.request('session/start', {
+        commandId: uuidv7(),
+        workspaceRoot: task.cwd,
+        ...(task.model ? { modelId: task.model } : {}),
+        approvalMode: 'onRequest',
+    }, timeout);
+    const sessionId = stringField(isObject(created) ? created.session : undefined, 'sessionId');
+    ids.session = sessionId;
+    if (!sessionId)
+        throw new Error('Muse did not return a session id.');
+    session.emit({ type: 'session', sessionId });
+    const input = (text) => [{ type: 'text', text }];
+    const started = await rpc.request('turn/start', {
+        sessionId,
+        input: input(task.prompt),
+        commandId: uuidv7(),
+        ...(task.effort ? { reasoningEffort: task.effort } : {}),
+    }, timeout);
+    const turnId = stringField(started, 'turnId');
+    ids.turn = turnId;
+    if (!turnId)
+        throw new Error('Muse did not return a turn id.');
+    session.setSteer(async (text) => {
+        const ack = await rpc.request('turn/steer', { sessionId, expectedTurnId: turnId, input: input(text), commandId: uuidv7() }, timeout);
+        if (stringField(ack, 'turnId') !== turnId)
+            throw new Error('Muse did not confirm the input; it may not have arrived.');
+    });
+    return finished;
+}
+/** Map one `muse serve` notification to agent events. */
+export function museNotification(method, params) {
+    const item = isObject(params) && isObject(params.item) ? params.item : undefined;
+    if (!item)
+        return [];
+    const kind = stringField(item, 'type') ?? stringField(item, 'kind');
+    const id = stringField(item, 'id');
+    if (method === 'item/completed' && kind === 'agentMessage') {
+        const text = stringField(item, 'text');
+        return text ? [{ type: 'message', text }] : [];
+    }
+    if (kind && TOOL_KINDS.has(kind)) {
+        const name = stringField(item, 'toolName') ?? kind;
+        if (method === 'item/started')
+            return [{ type: 'tool-start', ...(id ? { id } : {}), name }];
+        if (method === 'item/completed')
+            return [{ type: 'tool-end', ...(id ? { id } : {}), name, isError: item.status === 'failed' }];
+    }
+    return [];
+}
+//# sourceMappingURL=muse-live.js.map

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

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

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

@@ -0,0 +1,12 @@
+import { type AgentOutputParser } from '../cli-agent.js';
+import type { AgentTask, CodingAgent } from '../types.js';
+export interface MuseAgentOptions {
+    /** Executable name or path. Default `muse`. */
+    command?: string;
+    /** Pass `--trust-workspace` so the run does not stop to ask. Default true. */
+    trustWorkspace?: boolean;
+}
+/** Muse in exec mode (`muse exec --json`). */
+export declare function muse(options?: MuseAgentOptions): CodingAgent;
+export declare function museArgs(task: AgentTask, options?: MuseAgentOptions): string[];
+export declare function createMuseParser(): AgentOutputParser;

package/dist/agents/drivers/muse.js

@@ -0,0 +1,87 @@
+import { cliAgent } from '../cli-agent.js';
+import { isObject, stringField } from './json.js';
+/** Muse in exec mode (`muse exec --json`). */
+export function muse(options = {}) {
+    return cliAgent({
+        name: 'muse',
+        command: options.command ?? 'muse',
+        capabilities: { effort: ['minimal', 'low', 'medium', 'high', 'xhigh', 'max'], maxTurns: true },
+        args: (task) => museArgs(task, options),
+        createParser: createMuseParser,
+    });
+}
+export function museArgs(task, options = {}) {
+    const args = ['exec', '--json'];
+    if (options.trustWorkspace ?? true)
+        args.push('--trust-workspace');
+    if (task.model)
+        args.push('--model', task.model);
+    if (task.effort)
+        args.push('--reasoning-effort', task.effort);
+    if (task.maxTurns !== undefined)
+        args.push('--max-model-steps', String(task.maxTurns));
+    if (task.extraArgs)
+        args.push(...task.extraArgs);
+    return [...args, task.prompt];
+}
+const TERMINAL = 'run.terminal.';
+export function createMuseParser() {
+    let outcome;
+    let sessionSent = false;
+    let streamed = '';
+    return {
+        outcome: () => outcome,
+        event(value) {
+            if (!isObject(value))
+                return [];
+            const events = [];
+            const stream = isObject(value.stream) ? value.stream : undefined;
+            const sessionId = stringField(stream, 'id');
+            if (!sessionSent && stream?.kind === 'session' && sessionId) {
+                sessionSent = true;
+                events.push({ type: 'session', sessionId });
+            }
+            const type = stringField(value, 'payload_type');
+            const payload = isObject(value.payload) ? value.payload : undefined;
+            const text = stringField(payload, 'text');
+            if (!type)
+                return events;
+            if (type === 'run.output.delta' && text) {
+                streamed += text;
+                events.push({ type: 'text-delta', text });
+            }
+            else if (type === 'task.lifecycle.side_effect_intent') {
+                const operation = stringField(payload?.event, 'operation');
+                if (operation && !operation.startsWith('model.'))
+                    events.push({ type: 'tool-start', name: operation });
+            }
+            else if (type === 'approval_wait.effect.started' ||
+                (type === 'runtime.session' &&
+                    payload?.kind === 'approval' &&
+                    stringField(payload.event, 'kind') === 'requested')) {
+                // Headless exec cannot answer; museLive() can.
+                events.push({ type: 'approval-request', request: { id: approvalId(payload), kind: 'other', detail: payload } });
+            }
+            else if (type.startsWith(TERMINAL)) {
+                const verdict = type.slice(TERMINAL.length);
+                if (verdict === 'completed') {
+                    outcome = { ok: true };
+                    const final = (text ?? streamed).trim();
+                    if (final)
+                        events.push({ type: 'message', text: final });
+                }
+                else {
+                    const reason = stringField(payload, 'reason') ?? text;
+                    const message = `Muse run ${verdict}${reason ? `: ${reason}` : ''}`;
+                    outcome = { ok: false, error: message };
+                    events.push({ type: 'error', message });
+                }
+            }
+            return events;
+        },
+    };
+}
+function approvalId(payload) {
+    return stringField(payload, 'id') ?? stringField(payload, 'approvalId') ?? 'approval';
+}
+//# sourceMappingURL=muse.js.map

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

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

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

@@ -0,0 +1,17 @@
+import { type AgentOutputParser } from '../cli-agent.js';
+import type { AgentTask, CodingAgent } from '../types.js';
+export interface OpencodeAgentOptions {
+    /** Executable name or path. Default `opencode`. */
+    command?: string;
+    /** opencode agent to use (`--agent`). */
+    agent?: string;
+    /** Pass `--auto`: approve every permission that is not explicitly denied. Default false. */
+    autoApprove?: boolean;
+}
+/**
+ * opencode in run mode (`opencode run --format json`). `task.model` is `provider/model`;
+ * `task.effort` maps to `--variant`.
+ */
+export declare function opencode(options?: OpencodeAgentOptions): CodingAgent;
+export declare function opencodeArgs(task: AgentTask, options?: OpencodeAgentOptions): string[];
+export declare function createOpencodeParser(): AgentOutputParser;

package/dist/agents/drivers/opencode.js

@@ -0,0 +1,103 @@
+import { cliAgent } from '../cli-agent.js';
+import { isObject, numberField, stringField } from './json.js';
+const EDIT_TOOLS = new Set(['edit', 'write', 'patch', 'multiedit']);
+/**
+ * opencode in run mode (`opencode run --format json`). `task.model` is `provider/model`;
+ * `task.effort` maps to `--variant`.
+ */
+export function opencode(options = {}) {
+    return cliAgent({
+        name: 'opencode',
+        command: options.command ?? 'opencode',
+        capabilities: { effort: ['minimal', 'low', 'medium', 'high', 'max'], usage: true },
+        args: (task) => opencodeArgs(task, options),
+        createParser: createOpencodeParser,
+    });
+}
+export function opencodeArgs(task, options = {}) {
+    const args = ['run', '--format', 'json'];
+    if (options.agent)
+        args.push('--agent', options.agent);
+    if (options.autoApprove)
+        args.push('--auto');
+    if (task.model)
+        args.push('--model', task.model);
+    if (task.effort)
+        args.push('--variant', task.effort);
+    if (task.extraArgs)
+        args.push(...task.extraArgs);
+    return [...args, '--', task.prompt];
+}
+export function createOpencodeParser() {
+    let outcome;
+    let sessionSent = false;
+    const totals = { inputTokens: 0, outputTokens: 0, cachedInputTokens: 0 };
+    let costUsd = 0;
+    let steps = 0;
+    return {
+        outcome: () => outcome ?? (steps > 0 ? { ok: true } : undefined),
+        event(value) {
+            if (!isObject(value))
+                return [];
+            const events = [];
+            const sessionId = stringField(value, 'sessionID');
+            if (sessionId && !sessionSent) {
+                sessionSent = true;
+                events.push({ type: 'session', sessionId });
+            }
+            const part = isObject(value.part) ? value.part : undefined;
+            switch (value.type) {
+                case 'text': {
+                    const text = stringField(part, 'text')?.trim();
+                    if (text)
+                        events.push({ type: 'message', text });
+                    break;
+                }
+                case 'tool_use': {
+                    const name = stringField(part, 'tool') ?? 'tool';
+                    const id = stringField(part, 'callID') ?? stringField(part, 'id');
+                    const state = isObject(part?.state) ? part.state : undefined;
+                    const failed = state?.status === 'error';
+                    const output = stringField(state, 'output') ?? stringField(state, 'error');
+                    events.push({
+                        type: 'tool-end',
+                        ...(id ? { id } : {}),
+                        name,
+                        isError: failed,
+                        ...(output !== undefined ? { output } : {}),
+                    });
+                    const path = stringField(state?.input, 'filePath');
+                    if (!failed && EDIT_TOOLS.has(name) && path)
+                        events.push({ type: 'file-change', paths: [path] });
+                    break;
+                }
+                case 'step_finish': {
+                    steps += 1;
+                    const tokens = isObject(part?.tokens) ? part.tokens : undefined;
+                    totals.inputTokens += numberField(tokens, 'input') ?? 0;
+                    totals.outputTokens += numberField(tokens, 'output') ?? 0;
+                    totals.cachedInputTokens += numberField(tokens?.cache, 'read') ?? 0;
+                    costUsd += numberField(part, 'cost') ?? 0;
+                    // Running totals across steps, so the last usage event covers the whole run.
+                    if (tokens) {
+                        events.push({
+                            type: 'usage',
+                            usage: { ...totals, totalTokens: totals.inputTokens + totals.outputTokens },
+                            costUsd,
+                        });
+                    }
+                    break;
+                }
+                case 'error': {
+                    const error = isObject(value.error) ? value.error : undefined;
+                    const message = stringField(error?.data, 'message') ?? stringField(error, 'name') ?? 'opencode error';
+                    outcome = { ok: false, error: message };
+                    events.push({ type: 'error', message });
+                    break;
+                }
+            }
+            return events;
+        },
+    };
+}
+//# sourceMappingURL=opencode.js.map

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

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

package/dist/agents/env.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Model-provider credentials an agent CLI would otherwise pick up from the parent
+ * process. Remove them when the agent should use its own login and billing instead
+ * of your application's keys.
+ */
+export declare const PROVIDER_CREDENTIAL_VARS: readonly string[];
+export interface ScrubEnvOptions {
+    /** Variable names to drop: exact names or patterns. */
+    names?: readonly (string | RegExp)[];
+    /** Drop any variable whose value matches one of these (a token prefix, for example). */
+    values?: readonly RegExp[];
+}
+/** A copy of `env` without the matching variables. `undefined` entries are dropped too. */
+export declare function scrubEnv(env: NodeJS.ProcessEnv, options: ScrubEnvOptions): NodeJS.ProcessEnv;
+/** `env` without `PROVIDER_CREDENTIAL_VARS`: the agent falls back to its own login. */
+export declare function withoutProviderCredentials(env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;

package/dist/agents/env.js

@@ -0,0 +1,46 @@
+/**
+ * Model-provider credentials an agent CLI would otherwise pick up from the parent
+ * process. Remove them when the agent should use its own login and billing instead
+ * of your application's keys.
+ */
+export const PROVIDER_CREDENTIAL_VARS = [
+    'ANTHROPIC_API_KEY',
+    'ANTHROPIC_AUTH_TOKEN',
+    'ANTHROPIC_BASE_URL',
+    'CLAUDE_CODE_USE_BEDROCK',
+    'CLAUDE_CODE_USE_VERTEX',
+    'OPENAI_API_KEY',
+    'OPENAI_BASE_URL',
+    'OPENAI_ORG_ID',
+    'CODEX_API_KEY',
+    'GEMINI_API_KEY',
+    'GOOGLE_API_KEY',
+    'GOOGLE_APPLICATION_CREDENTIALS',
+    'GOOGLE_GENAI_USE_VERTEXAI',
+];
+/** A copy of `env` without the matching variables. `undefined` entries are dropped too. */
+export function scrubEnv(env, options) {
+    const names = options.names ?? [];
+    const values = options.values ?? [];
+    const result = {};
+    for (const [name, value] of Object.entries(env)) {
+        if (value === undefined)
+            continue;
+        if (names.some((match) => (typeof match === 'string' ? match === name : matches(match, name))))
+            continue;
+        if (values.some((match) => matches(match, value)))
+            continue;
+        result[name] = value;
+    }
+    return result;
+}
+/** `test()` from the start every time: `/g` and `/y` patterns keep `lastIndex` between calls. */
+function matches(pattern, text) {
+    pattern.lastIndex = 0;
+    return pattern.test(text);
+}
+/** `env` without `PROVIDER_CREDENTIAL_VARS`: the agent falls back to its own login. */
+export function withoutProviderCredentials(env = process.env) {
+    return scrubEnv(env, { names: PROVIDER_CREDENTIAL_VARS });
+}
+//# sourceMappingURL=env.js.map

package/dist/agents/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/agents/env.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACzD,mBAAmB;IACnB,sBAAsB;IACtB,oBAAoB;IACpB,yBAAyB;IACzB,wBAAwB;IACxB,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,gCAAgC;IAChC,2BAA2B;CAC5B,CAAC;AASF,2FAA2F;AAC3F,MAAM,UAAU,QAAQ,CAAC,GAAsB,EAAE,OAAwB;IACvE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;YAAE,SAAS;QACzG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAAE,SAAS;QAC5D,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iGAAiG;AACjG,SAAS,OAAO,CAAC,OAAe,EAAE,IAAY;IAC5C,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;IACtB,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,0BAA0B,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7E,OAAO,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/agents/event-queue.d.ts

@@ -0,0 +1,44 @@
+export interface EventQueueLimits {
+    /** Events kept for a run nobody iterates yet. The oldest are dropped past this. */
+    unreadItems: number;
+    /** Approximate bytes kept for a run nobody iterates yet. The oldest events are dropped past this. */
+    unreadBytes: number;
+    /** While iterated: above this many buffered bytes, ask the producer to pause. */
+    highWaterBytes: number;
+    /** While iterated: at or below this many buffered bytes, let a paused producer resume. */
+    lowWaterBytes: number;
+}
+/**
+ * Single-consumer queue bridging callbacks to `for await`, bounded by approximate size.
+ *
+ * Before anyone iterates, it keeps only the newest events within `unreadItems` and
+ * `unreadBytes`, since a run awaited only through `result` needs none of them. While
+ * iterated, it drops nothing: past `highWaterBytes` it calls `onPressure(true)` so the
+ * producer stops reading, and `onPressure(false)` once the consumer catches up.
+ * A consumer that stops iterating early releases the pressure and the rest is discarded.
+ */
+export declare class EventQueue<T> {
+    private readonly sizeOf;
+    /** Called with true when the producer should pause and false when it may resume. */
+    onPressure: ((paused: boolean) => void) | undefined;
+    private readonly items;
+    private readonly limits;
+    private bytes;
+    private closed;
+    private claimed;
+    private abandoned;
+    private pressured;
+    private wake;
+    private roomWaiters;
+    constructor(sizeOf?: (item: T) => number, limits?: Partial<EventQueueLimits>);
+    /** Approximate bytes currently buffered. */
+    get bufferedBytes(): number;
+    push(item: T): void;
+    close(): void;
+    /** Resolve once the producer may go on: the queue is below its high-water mark, or nobody reads it. */
+    room(): Promise<void>;
+    iterate(): AsyncGenerator<T>;
+    private setPressure;
+}
+/** A cheap size estimate for a JSON-like value: string lengths plus a few bytes per other value. */
+export declare function approximateSize(value: unknown, depth?: number): number;

package/dist/agents/event-queue.js

@@ -0,0 +1,123 @@
+const DEFAULT_LIMITS = {
+    unreadItems: 1_000,
+    unreadBytes: 8 * 1024 * 1024,
+    highWaterBytes: 8 * 1024 * 1024,
+    lowWaterBytes: 1024 * 1024,
+};
+/**
+ * Single-consumer queue bridging callbacks to `for await`, bounded by approximate size.
+ *
+ * Before anyone iterates, it keeps only the newest events within `unreadItems` and
+ * `unreadBytes`, since a run awaited only through `result` needs none of them. While
+ * iterated, it drops nothing: past `highWaterBytes` it calls `onPressure(true)` so the
+ * producer stops reading, and `onPressure(false)` once the consumer catches up.
+ * A consumer that stops iterating early releases the pressure and the rest is discarded.
+ */
+export class EventQueue {
+    sizeOf;
+    /** Called with true when the producer should pause and false when it may resume. */
+    onPressure;
+    items = [];
+    limits;
+    bytes = 0;
+    closed = false;
+    claimed = false;
+    abandoned = false;
+    pressured = false;
+    wake;
+    roomWaiters = [];
+    constructor(sizeOf = () => 0, limits = {}) {
+        this.sizeOf = sizeOf;
+        this.limits = { ...DEFAULT_LIMITS, ...limits };
+    }
+    /** Approximate bytes currently buffered. */
+    get bufferedBytes() {
+        return this.bytes;
+    }
+    push(item) {
+        if (this.closed || this.abandoned)
+            return;
+        const size = this.sizeOf(item);
+        this.items.push({ item, size });
+        this.bytes += size;
+        if (!this.claimed) {
+            // The newest event always stays, so `done` survives however large the ones before it were.
+            while (this.items.length > 1 &&
+                (this.items.length > this.limits.unreadItems || this.bytes > this.limits.unreadBytes)) {
+                this.bytes -= this.items.shift().size;
+            }
+        }
+        else if (!this.pressured && this.bytes > this.limits.highWaterBytes) {
+            this.setPressure(true);
+        }
+        this.wake?.();
+    }
+    close() {
+        this.closed = true;
+        this.wake?.();
+    }
+    /** Resolve once the producer may go on: the queue is below its high-water mark, or nobody reads it. */
+    room() {
+        if (!this.pressured)
+            return Promise.resolve();
+        return new Promise((resolve) => this.roomWaiters.push(resolve));
+    }
+    async *iterate() {
+        if (this.claimed)
+            throw new Error('An AgentRun can be iterated only once.');
+        this.claimed = true;
+        try {
+            for (;;) {
+                const next = this.items.shift();
+                if (next !== undefined) {
+                    this.bytes -= next.size;
+                    if (this.pressured && this.bytes <= this.limits.lowWaterBytes)
+                        this.setPressure(false);
+                    yield next.item;
+                    continue;
+                }
+                if (this.closed)
+                    return;
+                await new Promise((resolve) => {
+                    this.wake = resolve;
+                });
+                this.wake = undefined;
+            }
+        }
+        finally {
+            // Done, or the consumer broke out early: nothing reads further events, so do not hold the producer.
+            this.abandoned = true;
+            this.items.length = 0;
+            this.bytes = 0;
+            if (this.pressured)
+                this.setPressure(false);
+        }
+    }
+    setPressure(paused) {
+        this.pressured = paused;
+        this.onPressure?.(paused);
+        if (!paused) {
+            const waiters = this.roomWaiters;
+            this.roomWaiters = [];
+            waiters.forEach((resolve) => resolve());
+        }
+    }
+}
+/** A cheap size estimate for a JSON-like value: string lengths plus a few bytes per other value. */
+export function approximateSize(value, depth = 0) {
+    if (typeof value === 'string')
+        return value.length;
+    if (value === null || typeof value !== 'object' || depth > 8)
+        return 8;
+    let size = 8;
+    if (Array.isArray(value)) {
+        for (const item of value)
+            size += approximateSize(item, depth + 1);
+    }
+    else {
+        for (const [key, item] of Object.entries(value))
+            size += key.length + approximateSize(item, depth + 1);
+    }
+    return size;
+}
+//# sourceMappingURL=event-queue.js.map

package/dist/agents/event-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-queue.js","sourceRoot":"","sources":["../../src/agents/event-queue.ts"],"names":[],"mappings":"AAWA,MAAM,cAAc,GAAqB;IACvC,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAC5B,cAAc,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAC/B,aAAa,EAAE,IAAI,GAAG,IAAI;CAC3B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,OAAO,UAAU;IAcF;IAbnB,oFAAoF;IACpF,UAAU,CAA0C;IACnC,KAAK,GAAgC,EAAE,CAAC;IACxC,MAAM,CAAmB;IAClC,KAAK,GAAG,CAAC,CAAC;IACV,MAAM,GAAG,KAAK,CAAC;IACf,OAAO,GAAG,KAAK,CAAC;IAChB,SAAS,GAAG,KAAK,CAAC;IAClB,SAAS,GAAG,KAAK,CAAC;IAClB,IAAI,CAA2B;IAC/B,WAAW,GAAmB,EAAE,CAAC;IAEzC,YACmB,SAA8B,GAAG,EAAE,CAAC,CAAC,EACtD,SAAoC,EAAE;QADrB,WAAM,GAAN,MAAM,CAA+B;QAGtD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,CAAC;IAED,4CAA4C;IAC5C,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,CAAC,IAAO;QACV,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,2FAA2F;YAC3F,OACE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;gBACrB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EACrF,CAAC;gBACD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC,IAAI,CAAC;YACzC,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YACtE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;IAChB,CAAC;IAED,uGAAuG;IACvG,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC9C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,CAAC,OAAO;QACZ,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5E,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,SAAS,CAAC;gBACR,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACvB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC;oBACxB,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa;wBAAE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;oBACvF,MAAM,IAAI,CAAC,IAAI,CAAC;oBAChB,SAAS;gBACX,CAAC;gBACD,IAAI,IAAI,CAAC,MAAM;oBAAE,OAAO;gBACxB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oBAClC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;gBACtB,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;YACxB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,oGAAoG;YACpG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;YACf,IAAI,IAAI,CAAC,SAAS;gBAAE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,MAAe;QACjC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;QACxB,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC;YACjC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;YACtB,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;CACF;AAED,oGAAoG;AACpG,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,KAAK,GAAG,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IACnD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACvE,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,IAAI,eAAe,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,IAAI,IAAI,GAAG,CAAC,MAAM,GAAG,eAAe,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/agents/hosted.d.ts

@@ -0,0 +1,33 @@
+import type { AgentCapabilities, AgentEvent, AgentTask, CodingAgent } from './types.js';
+export type HostedTaskState = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+/** What a hosted provider receives. `cwd` is the provider's workspace reference (a repo, a branch...). */
+export type HostedTaskRequest = Omit<AgentTask, 'env' | 'signal' | 'onApproval' | 'timeoutMs'>;
+export interface HostedPoll {
+    state: HostedTaskState;
+    /** Events since the previous poll. */
+    events?: AgentEvent[];
+    /** Opaque position handed back on the next poll. */
+    cursor?: string;
+    error?: string;
+}
+/**
+ * A remote coding-agent service: tasks run on the vendor's machines and are polled.
+ * Implement this for a hosted product and pass it to `hostedAgent()`.
+ */
+export interface HostedAgentProvider {
+    readonly name: string;
+    readonly capabilities?: AgentCapabilities;
+    start(task: HostedTaskRequest, signal: AbortSignal): Promise<{
+        id: string;
+    }>;
+    poll(id: string, cursor: string | undefined, signal: AbortSignal): Promise<HostedPoll>;
+    /** Add input to a running task (backs `AgentRun.steer`). */
+    send?(id: string, text: string): Promise<void>;
+    cancel(id: string): Promise<void>;
+}
+export interface HostedAgentOptions {
+    /** Delay between polls. Default 5 s. */
+    pollIntervalMs?: number;
+}
+/** Adapt a `HostedAgentProvider` to `CodingAgent`, so hosted and local agents share one API. */
+export declare function hostedAgent(provider: HostedAgentProvider, options?: HostedAgentOptions): CodingAgent;