@adonis-agora/agent 0.60.1 → 0.62.0

package/dist/src/opencode/runner.d.ts

@@ -0,0 +1,40 @@
+import { type HumanReply } from '../elicitation.js';
+import type { AgentRunner, AgentRunStartOptions } from '../spi/agent-runner.js';
+import type { AgentStore } from '../spi/agent-store.js';
+import type { AgentRunInput } from '../types.js';
+import type { OpenCodeTurns } from './turns.js';
+/**
+ * Runs OpenCode turns in this process: `begin → prompt → [observe → wait for a person → reply]* →
+ * settle`, with the waits on people held in memory. Like `InlineAgentRunner`, a run parked on a
+ * person lives in this process, so deploy it single-replica — or use `openCodeDurable()`
+ * (`@adonis-agora/agent/opencode/durable`), which checkpoints every step and waits on a durable
+ * signal.
+ */
+export declare class OpenCodeAgentRunner implements AgentRunner {
+    private readonly turns;
+    private readonly store;
+    private readonly live;
+    private readonly cancelled;
+    private readonly pending;
+    constructor(turns: OpenCodeTurns, store: AgentStore);
+    runIdFor(input: AgentRunInput): string;
+    /** In-process, so exact: a run this process is not running is not running anywhere. */
+    isRunActive(runId: string): Promise<boolean>;
+    start(input: AgentRunInput, options?: AgentRunStartOptions): Promise<{
+        runId: string;
+    }>;
+    /**
+     * Deliver a person's reply. Answers addressed at an approval are refused, as the inline runner
+     * refuses them: they say nothing about whether the action should run.
+     */
+    signal(runId: string, toolCallId: string, reply: HumanReply): Promise<void>;
+    /**
+     * Stop the run: what it waits on a person for is dropped, and OpenCode is interrupted — it answers
+     * `session.execution.interrupted`, which settles the run as cancelled.
+     */
+    cancel(runId: string): Promise<void>;
+    private run;
+    /** Wait for a person's answer; a lapsed approval answers itself as expired. */
+    private park;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/src/opencode/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/opencode/runner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAA4C,MAAM,mBAAmB,CAAC;AAC9F,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,aAAa,CAAC;AAE3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQhD;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IAMnD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IANxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD,YACmB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,UAAU,EAGnC;IAED,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAErC;IAED,uFAAuF;IACjF,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjD;IAEK,KAAK,CACT,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAa5B;IAED;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAShF;IAED;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASzC;YAEa,GAAG;IA8BjB,+EAA+E;IAC/E,OAAO,CAAC,IAAI;CAoBb"}

package/dist/src/opencode/runner.js

@@ -0,0 +1,125 @@
+import { RunCancelledError } from '../agent-loop.js';
+import { HumanReplyMismatchError, isHumanDecision } from '../elicitation.js';
+import { errorText } from './log.js';
+/**
+ * Runs OpenCode turns in this process: `begin → prompt → [observe → wait for a person → reply]* →
+ * settle`, with the waits on people held in memory. Like `InlineAgentRunner`, a run parked on a
+ * person lives in this process, so deploy it single-replica — or use `openCodeDurable()`
+ * (`@adonis-agora/agent/opencode/durable`), which checkpoints every step and waits on a durable
+ * signal.
+ */
+export class OpenCodeAgentRunner {
+    turns;
+    store;
+    live = new Map();
+    cancelled = new Set();
+    pending = new Map();
+    constructor(turns, store) {
+        this.turns = turns;
+        this.store = store;
+        turns.startNext = (next, runId) => this.start(next, { runId });
+    }
+    runIdFor(input) {
+        return this.turns.settings.runId?.(input) ?? crypto.randomUUID();
+    }
+    /** In-process, so exact: a run this process is not running is not running anywhere. */
+    async isRunActive(runId) {
+        if (this.live.has(runId))
+            return true;
+        for (const key of this.pending.keys())
+            if (key.startsWith(`${runId}:`))
+                return true;
+        return false;
+    }
+    async start(input, options = {}) {
+        const runId = options.runId ?? this.runIdFor(input);
+        // Before the turn starts: a fast turn could otherwise end (and clear it) before it was set.
+        await this.store.setActiveStream(input.threadId, runId);
+        this.live.set(runId, input);
+        void this.run(runId, input).finally(() => {
+            this.live.delete(runId);
+            this.cancelled.delete(runId);
+            for (const key of [...this.pending.keys()]) {
+                if (key.startsWith(`${runId}:`))
+                    this.pending.delete(key);
+            }
+        });
+        return { runId };
+    }
+    /**
+     * Deliver a person's reply. Answers addressed at an approval are refused, as the inline runner
+     * refuses them: they say nothing about whether the action should run.
+     */
+    async signal(runId, toolCallId, reply) {
+        const key = `${runId}:${toolCallId}`;
+        const parked = this.pending.get(key);
+        if (parked === undefined)
+            return;
+        if (parked.on === 'approval' && !isHumanDecision(reply)) {
+            throw new HumanReplyMismatchError(runId, toolCallId);
+        }
+        this.pending.delete(key);
+        parked.resolve(reply);
+    }
+    /**
+     * Stop the run: what it waits on a person for is dropped, and OpenCode is interrupted — it answers
+     * `session.execution.interrupted`, which settles the run as cancelled.
+     */
+    async cancel(runId) {
+        this.cancelled.add(runId);
+        for (const [key, parked] of [...this.pending]) {
+            if (!key.startsWith(`${runId}:`))
+                continue;
+            this.pending.delete(key);
+            parked.reject(new RunCancelledError());
+        }
+        const input = this.live.get(runId);
+        if (input !== undefined)
+            await this.turns.interrupt(input).catch(() => undefined);
+    }
+    async run(runId, input) {
+        const started = Date.now();
+        try {
+            let handle = await this.turns.begin(runId, input);
+            if (this.cancelled.has(runId))
+                throw new RunCancelledError();
+            await this.turns.prompt(runId, input, handle);
+            for (;;) {
+                const milestone = await this.turns.observe(runId, input, handle);
+                if (milestone.kind === 'finished') {
+                    await this.turns.settle(runId, input, milestone.outcome, Date.now() - started);
+                    return;
+                }
+                const reply = await this.park(runId, milestone.ask.id, milestone.ask.kind === 'approval' ? 'approval' : 'answers', milestone.timeoutMs);
+                handle = await this.turns.reply(runId, input, handle, milestone.ask, reply);
+            }
+        }
+        catch (error) {
+            if (error instanceof RunCancelledError) {
+                await this.turns.interrupt(input).catch(() => undefined);
+                await this.turns.settle(runId, input, { status: 'interrupted' }, Date.now() - started);
+                return;
+            }
+            await this.turns.settleFailed(runId, input, errorText(error, 'the turn failed'));
+        }
+    }
+    /** Wait for a person's answer; a lapsed approval answers itself as expired. */
+    park(runId, toolCallId, on, timeoutMs) {
+        const key = `${runId}:${toolCallId}`;
+        const waiting = new Promise((resolve, reject) => {
+            this.pending.set(key, { on, resolve, reject });
+        });
+        if (timeoutMs === undefined)
+            return waiting;
+        let timer;
+        const lapse = new Promise((resolve) => {
+            timer = setTimeout(() => {
+                if (this.pending.delete(key))
+                    resolve({ approved: false, expired: true });
+            }, timeoutMs);
+            timer.unref?.();
+        });
+        return Promise.race([waiting, lapse]).finally(() => clearTimeout(timer));
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/src/opencode/runner.js.map

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

package/dist/src/opencode/turn.d.ts

@@ -0,0 +1,167 @@
+import { type ElicitationRequest, type HumanReply } from '../elicitation.js';
+import type { AgentStore } from '../spi/agent-store.js';
+import type { ApprovalRequirement } from '../spi/approval-policy.js';
+import type { SinkWriter } from '../spi/token-stream-sink.js';
+import type { AgentUiComponent } from '../stream-events.js';
+import type { AgentRunInput } from '../types.js';
+import type { OpenCodeClient, OpenCodeEvent, OpenCodeForm } from './client.js';
+/** How an OpenCode execution ended. */
+export type TurnOutcome = {
+    status: 'succeeded';
+} | {
+    status: 'failed';
+    error: string;
+} | {
+    status: 'interrupted';
+};
+/**
+ * Something the turn put to a person, with everything needed to hand the answer back to OpenCode
+ * later — serializable, so a durable run journals it and replies from another process.
+ */
+export type PendingAsk = {
+    kind: 'approval';
+    /** The OpenCode permission request id — also the tool-call id the decision is signalled under. */
+    id: string;
+    action: string;
+    approver: string;
+    expiresAt?: string;
+    /** The assistant message the call hangs on (absent for a request recovered after a restart). */
+    messageId?: string;
+} | {
+    kind: 'form';
+    id: string;
+    form: OpenCodeForm;
+    request: ElicitationRequest;
+    messageId?: string;
+};
+/** Where a turn stands: it needs a person, or it is over. */
+export type Milestone = {
+    kind: 'ask';
+    ask: PendingAsk;
+    timeoutMs?: number;
+} | {
+    kind: 'finished';
+    outcome: TurnOutcome;
+};
+export interface OpenCodeTurnArgs {
+    runId: string;
+    input: AgentRunInput;
+    client: OpenCodeClient;
+    sessionId: string;
+    writer: SinkWriter;
+    store: AgentStore;
+    /** What an action needs before it runs (the agent's `ApprovalPolicy`). */
+    approvalFor: (action: string) => Promise<ApprovalRequirement>;
+    /** The model label usage is recorded under. */
+    modelLabel: string;
+    /**
+     * An action OpenCode was allowed to run — by a person, a remembered approval or the policy. The
+     * engine's MCP endpoint runs an `action` tool only against one of these.
+     */
+    onGranted?: (action: string, permissionId: string) => void;
+}
+/**
+ * One turn of an OpenCode session, as the library's stream and store see it. Fed the session's
+ * events in order, it writes the protocol's frames and persists what the loop would have — the
+ * assistant messages with their tool calls and results, the calls put to a person (so the
+ * approve/answer routes find their run), usage per model step — and reports {@link Milestone}s: a
+ * person was asked something, or the execution ended.
+ *
+ * The turn does not wait for people itself. Whoever drives it (`OpenCodeTurns`, under an in-memory
+ * or a durable runner) takes the `ask` milestone, waits however it waits, and hands the answer back
+ * with {@link decide} — which is what lets a durable run wait across a restart and reply from
+ * another process, with a fresh turn object fed the journaled {@link PendingAsk}.
+ */
+export declare class OpenCodeTurn {
+    private readonly a;
+    /** Serializes the handling of events, so frames and rows land in the order OpenCode sent them. */
+    private chain;
+    private segment;
+    private readonly tools;
+    /** Results already persisted per message, so a late settlement adds to them rather than replacing. */
+    private readonly messageResults;
+    private readonly asked;
+    /** Calls of {@link HIDDEN_TOOLS}, by id. */
+    private readonly hidden;
+    private readonly milestones;
+    private waiting;
+    private readonly usage;
+    private costUsd;
+    private steps;
+    private stepOpen;
+    private sawText;
+    private separator;
+    private reasoningSince;
+    private wroteMessage;
+    private ended;
+    private stepError;
+    constructor(a: OpenCodeTurnArgs);
+    get sessionId(): string;
+    get finished(): boolean;
+    /** The turn's totals so far: tokens, cost, model steps. */
+    totals(): {
+        inputTokens: number;
+        outputTokens: number;
+        costUsd?: number;
+        steps: number;
+    };
+    /** Feed one of the session's events. */
+    handle(event: OpenCodeEvent): void;
+    /** End the turn as failed without an event (the prompt was refused, the stream is gone). */
+    fail(error: string): void;
+    /**
+     * A component a tool pushed (`ctx.emitUi`, through the engine's MCP endpoint): streamed as a `ui`
+     * frame and persisted on the message being written, in the order it arrived. Pushing the same id
+     * again replaces it.
+     */
+    pushUi(component: AgentUiComponent): Promise<void>;
+    /** The next milestone: one already reached, or the next one to come. */
+    next(): Promise<Milestone>;
+    /** Whether a milestone is waiting to be taken. */
+    hasMilestone(): boolean;
+    /**
+     * Requests OpenCode raised while nobody listened (this process started after them, or the event
+     * stream dropped): its open permissions and forms, handled as if their events had just arrived.
+     * One already recorded in the store is reported without being recorded or streamed again.
+     */
+    catchUp(): Promise<void>;
+    /**
+     * Hand a person's answer to what the turn asked, and let OpenCode go on. `tellOpenCode: false`
+     * only settles the call (stream and store): the request died with a restarted server, and the
+     * new session is told the answer in its prompt instead.
+     */
+    decide(ask: PendingAsk, reply: HumanReply, opts?: {
+        tellOpenCode?: boolean;
+    }): Promise<void>;
+    private reach;
+    private enqueue;
+    private write;
+    private event;
+    private step;
+    private endReasoning;
+    private tool;
+    private announce;
+    private makeAvailable;
+    private setInput;
+    /** Code-mode calls made inside a tool (`metadata.toolCalls`), nested under it by `parentId`. */
+    private innerCalls;
+    private onEvent;
+    private settleTool;
+    private stepEnded;
+    /**
+     * Persist what the turn produced since the last flush as one assistant message — the message a
+     * call put to a person hangs on, or the turn's last one. Returns its id.
+     */
+    private flush;
+    /** A request recorded by an earlier process (a turn resumed after a restart). */
+    private alreadyRecorded;
+    /** The persisted assistant message carrying call `id`, so its result lands on the same message. */
+    private messageOf;
+    private onPermission;
+    private decided;
+    private onForm;
+    private answered;
+    private addResult;
+    private end;
+}
+//# sourceMappingURL=turn.d.ts.map

package/dist/src/opencode/turn.d.ts.map

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