genaicode 2.3.0 → 2.4.0

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":"AAAA,OAAO,EAAE,QAAQ,EAA6C,MAAM,iBAAiB,CAAC;AAEtF,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAW/D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;AAEpE;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,UAAgC,EAAE;IACzD,OAAO,QAAQ,CAAC;QACd,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,UAAU;QACtC,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE;QAClF,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC;QAC3C,YAAY,EAAE,oBAAoB;KACnC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAe,EAAE,UAAgC,EAAE;IAC9E,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,OAAO,CAAC,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,OAAO,CAAC,WAAW;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,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,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,IAAI,CAAC,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,IAAI,OAAiC,CAAC;IACtC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,MAAM,MAAM,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;IACzE,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAChE,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,WAAW,CAAC,CAAC;YAClD,IAAI,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC9B,WAAW,GAAG,IAAI,CAAC;gBACnB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;YAC9C,CAAC;YACD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3D,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACnB,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;oBAC/C,IAAI,IAAI;wBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBACjD,MAAM;gBACR,CAAC;gBACD,KAAK,UAAU,CAAC,CAAC,CAAC;oBAChB,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC;oBACjD,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBAClE,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC7D,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;oBACzC,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;oBAC3E,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,UAAU;wBAChB,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACrB,IAAI;wBACJ,OAAO,EAAE,MAAM;wBACf,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC5C,CAAC,CAAC;oBACH,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;oBACnD,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI;wBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACjG,MAAM;gBACR,CAAC;gBACD,KAAK,aAAa,CAAC,CAAC,CAAC;oBACnB,KAAK,IAAI,CAAC,CAAC;oBACX,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;oBAChE,MAAM,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;oBACxD,MAAM,CAAC,YAAY,IAAI,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;oBAC1D,MAAM,CAAC,iBAAiB,IAAI,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;oBACpE,OAAO,IAAI,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC1C,6EAA6E;oBAC7E,IAAI,MAAM,EAAE,CAAC;wBACX,MAAM,CAAC,IAAI,CAAC;4BACV,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,YAAY,EAAE;4BAC3E,OAAO;yBACR,CAAC,CAAC;oBACL,CAAC;oBACD,MAAM;gBACR,CAAC;gBACD,KAAK,OAAO,CAAC,CAAC,CAAC;oBACb,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC9D,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,gBAAgB,CAAC;oBACtG,OAAO,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;oBACxC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;oBACxC,MAAM;gBACR,CAAC;YACH,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

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":"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"}

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;

package/dist/agents/hosted.js

@@ -0,0 +1,129 @@
+import { RunRecorder } from './runtime.js';
+const TERMINAL = new Set(['completed', 'failed', 'cancelled']);
+/** Adapt a `HostedAgentProvider` to `CodingAgent`, so hosted and local agents share one API. */
+export function hostedAgent(provider, options = {}) {
+    return {
+        name: provider.name,
+        command: provider.name,
+        capabilities: { ...provider.capabilities, steer: !!provider.send },
+        run: (task) => runHosted(provider, task, options.pollIntervalMs ?? 5_000),
+    };
+}
+function runHosted(provider, task, pollIntervalMs) {
+    const recorder = new RunRecorder(provider.name, provider.name);
+    const controller = new AbortController();
+    let stopReason;
+    let taskId;
+    const stop = (reason) => {
+        if (stopReason || controller.signal.aborted)
+            return;
+        stopReason = reason;
+        controller.abort();
+    };
+    const onAbort = () => stop('aborted');
+    task.signal?.addEventListener('abort', onAbort, { once: true });
+    if (task.signal?.aborted)
+        onAbort();
+    const timer = task.timeoutMs !== undefined ? setTimeout(() => stop('timeout'), task.timeoutMs) : undefined;
+    const exit = (reason, error) => ({
+        exitCode: null,
+        signal: null,
+        reason,
+        ...(error ? { error } : {}),
+    });
+    const work = async () => {
+        // Local-only fields (process env, callbacks, timers) never reach the provider.
+        const request = { ...task };
+        delete request.env;
+        delete request.signal;
+        delete request.onApproval;
+        delete request.timeoutMs;
+        try {
+            taskId = (await provider.start(request, controller.signal)).id;
+        }
+        catch (error) {
+            if (stopReason)
+                return { exit: exit(stopReason) };
+            return { exit: exit('spawn-error', error instanceof Error ? error : new Error(String(error))) };
+        }
+        recorder.emit({ type: 'session', sessionId: taskId });
+        let cursor;
+        while (!stopReason) {
+            let poll;
+            try {
+                poll = await provider.poll(taskId, cursor, controller.signal);
+            }
+            catch (error) {
+                if (stopReason)
+                    break;
+                // Do not leave a task running (and billing) that nobody watches any more.
+                await provider.cancel(taskId).catch(() => undefined);
+                const message = error instanceof Error ? error.message : String(error);
+                return { exit: exit('closed'), outcome: { ok: false, error: `Polling ${provider.name} failed: ${message}` } };
+            }
+            // Aborted while the poll was in flight: cancel, whatever state it reported.
+            if (stopReason)
+                break;
+            for (const event of poll.events ?? [])
+                recorder.emit(event);
+            cursor = poll.cursor ?? cursor;
+            if (TERMINAL.has(poll.state)) {
+                if (poll.state === 'cancelled')
+                    return { exit: exit('aborted') };
+                return {
+                    exit: exit('closed'),
+                    outcome: poll.state === 'completed'
+                        ? { ok: true }
+                        : { ok: false, error: poll.error ?? `${provider.name} task failed.` },
+                };
+            }
+            // A consumer that falls behind holds the next poll instead of buffering without bound.
+            await untilAborted(recorder.events.room(), controller.signal);
+            await delay(pollIntervalMs, controller.signal);
+        }
+        await provider.cancel(taskId).catch(() => undefined);
+        return { exit: exit(stopReason ?? 'aborted') };
+    };
+    const result = work().then(({ exit: ended, outcome }) => {
+        clearTimeout(timer);
+        task.signal?.removeEventListener('abort', onAbort);
+        return recorder.finish(ended, outcome);
+    });
+    return {
+        result,
+        abort: () => stop('aborted'),
+        ...(provider.send
+            ? {
+                steer: (text) => taskId && !stopReason
+                    ? provider.send(taskId, text)
+                    : Promise.reject(new Error(`${provider.name} is not accepting input.`)),
+            }
+            : {}),
+        [Symbol.asyncIterator]: () => recorder.events.iterate(),
+    };
+}
+function delay(ms, signal) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(done, ms);
+        signal.addEventListener('abort', done, { once: true });
+        function done() {
+            clearTimeout(timer);
+            signal.removeEventListener('abort', done);
+            resolve();
+        }
+    });
+}
+/** Resolve when `wait` does or `signal` aborts, whichever comes first. */
+function untilAborted(wait, signal) {
+    if (signal.aborted)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        const done = () => {
+            signal.removeEventListener('abort', done);
+            resolve();
+        };
+        signal.addEventListener('abort', done, { once: true });
+        void wait.then(done);
+    });
+}
+//# sourceMappingURL=hosted.js.map

package/dist/agents/hosted.js.map

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