@adonis-agora/agent 0.60.1 → 0.62.0

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

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

package/dist/src/opencode/durable/workflow.d.ts

@@ -0,0 +1,40 @@
+import { BaseWorkflow, type WorkflowCtx, type WorkflowEngine } from '@adonis-agora/durable';
+import type { AgentRunInput } from '../../types.js';
+import type { OpenCodeTurns } from '../turns.js';
+export declare const OPENCODE_RUN_WORKFLOW = "agora.agent.opencode.run";
+/** The token a person's answer to `toolCallId` is signalled under — the library's own convention. */
+export declare function decisionToken(runId: string, toolCallId: string): string;
+/**
+ * A suspend / continue-as-new the runtime throws THROUGH the body — control flow, not a failure.
+ * Recognised by name, so a second copy of `@adonis-agora/durable` (another class identity) still is.
+ */
+export declare function isControlFlowSignal(error: unknown): boolean;
+/**
+ * An OpenCode turn as a durable workflow:
+ *
+ *   begin → prompt → observe:0 → [ wait for a person (signal `tool:<run>:<call>`) → reply:n → observe:n+1 ]* → finish
+ *
+ * Every step is checkpointed. A turn parked on a person is a suspended run with a signal waiter: an
+ * app restart loses nothing, and the decision resumes it on whichever process takes it — replaying
+ * the steps from their checkpoints and replying to OpenCode from there (`OpenCodeTurns` rebuilds the
+ * live turn, and re-prompts a fresh session when OpenCode itself restarted meanwhile). A process
+ * that dies while OpenCode works re-runs that `observe` step, which catches up on what OpenCode
+ * asked while nobody listened.
+ *
+ * Built by the engine's factory with the turn steps (see `registerOpenCodeWorkflow`), not by the
+ * container.
+ */
+export declare class OpenCodeRunWorkflow extends BaseWorkflow {
+    private readonly turns;
+    private readonly engine?;
+    static workflow: {
+        name: string;
+        version: string;
+    };
+    constructor(turns: OpenCodeTurns, engine?: WorkflowEngine | undefined);
+    run(ctx: WorkflowCtx, input: AgentRunInput): Promise<{
+        outcome: string;
+    }>;
+    private cancelled;
+}
+//# sourceMappingURL=workflow.d.ts.map

package/dist/src/opencode/durable/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../../src/opencode/durable/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,gBAAgB,CAAC;AAG9D,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAC;AAEhE,eAAO,MAAM,qBAAqB,6BAA6B,CAAC;AAEhE,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG3D;AAOD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IAIjD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAJ1B,OAAgB,QAAQ;;;MAAiD;IAEzE,YACmB,KAAK,EAAE,aAAa,EACpB,MAAM,CAAC,EAAE,cAAc,YAAA,EAGzC;IAEK,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAmD9E;YAEa,SAAS;CAQxB"}

package/dist/src/opencode/durable/workflow.js

@@ -0,0 +1,106 @@
+import { BaseWorkflow } from '@adonis-agora/durable';
+import { errorText } from '../log.js';
+export const OPENCODE_RUN_WORKFLOW = 'agora.agent.opencode.run';
+/** The token a person's answer to `toolCallId` is signalled under — the library's own convention. */
+export function decisionToken(runId, toolCallId) {
+    return `tool:${runId}:${toolCallId}`;
+}
+/**
+ * A suspend / continue-as-new the runtime throws THROUGH the body — control flow, not a failure.
+ * Recognised by name, so a second copy of `@adonis-agora/durable` (another class identity) still is.
+ */
+export function isControlFlowSignal(error) {
+    const name = error?.name;
+    return name === 'WorkflowSuspended' || name === 'ContinueAsNew';
+}
+/** The runtime's `SignalTimeoutError`, recognised by name for the same reason. */
+function isSignalTimeout(error) {
+    return error instanceof Error && error.name === 'SignalTimeoutError';
+}
+/**
+ * An OpenCode turn as a durable workflow:
+ *
+ *   begin → prompt → observe:0 → [ wait for a person (signal `tool:<run>:<call>`) → reply:n → observe:n+1 ]* → finish
+ *
+ * Every step is checkpointed. A turn parked on a person is a suspended run with a signal waiter: an
+ * app restart loses nothing, and the decision resumes it on whichever process takes it — replaying
+ * the steps from their checkpoints and replying to OpenCode from there (`OpenCodeTurns` rebuilds the
+ * live turn, and re-prompts a fresh session when OpenCode itself restarted meanwhile). A process
+ * that dies while OpenCode works re-runs that `observe` step, which catches up on what OpenCode
+ * asked while nobody listened.
+ *
+ * Built by the engine's factory with the turn steps (see `registerOpenCodeWorkflow`), not by the
+ * container.
+ */
+export class OpenCodeRunWorkflow extends BaseWorkflow {
+    turns;
+    engine;
+    static workflow = { name: OPENCODE_RUN_WORKFLOW, version: '1' };
+    constructor(turns, engine) {
+        super();
+        this.turns = turns;
+        this.engine = engine;
+    }
+    async run(ctx, input) {
+        const turns = this.turns;
+        // `@adonis-agora/durable` >= 0.43.3 never runs one run twice at once in a process, so a step
+        // that talks to OpenCode (a `reply`, an `observe`) runs once per execution of the run.
+        const step = (name, body) => ctx.localStep(name, body);
+        try {
+            const begun = await step('begin', async () => ({
+                handle: await turns.begin(ctx.runId, input, true),
+                startedAt: Date.now(),
+            }));
+            let handle = begun.handle;
+            await step('prompt', async () => {
+                await turns.prompt(ctx.runId, input, handle);
+                return true;
+            });
+            for (let n = 0;; n += 1) {
+                const milestone = await step(`observe:${n}`, () => turns.observe(ctx.runId, input, handle));
+                if (milestone.kind === 'finished') {
+                    await step('finish', async () => {
+                        // A cancel settles the run itself (it may be parked where no step runs again).
+                        if (await this.cancelled(ctx.runId))
+                            turns.drop(ctx.runId);
+                        else {
+                            await turns.settle(ctx.runId, input, milestone.outcome, Date.now() - begun.startedAt);
+                        }
+                        return true;
+                    });
+                    return { outcome: milestone.outcome.status };
+                }
+                let reply;
+                try {
+                    reply = await ctx.waitForSignal(decisionToken(ctx.runId, milestone.ask.id), milestone.timeoutMs !== undefined ? { timeoutMs: milestone.timeoutMs } : undefined);
+                }
+                catch (error) {
+                    if (!isSignalTimeout(error))
+                        throw error;
+                    reply = { approved: false, expired: true };
+                }
+                const ask = milestone.ask;
+                handle = await step(`reply:${n}`, () => turns.reply(ctx.runId, input, handle, ask, reply));
+            }
+        }
+        catch (error) {
+            if (isControlFlowSignal(error))
+                throw error;
+            await step('fail', async () => {
+                await turns.settleFailed(ctx.runId, input, errorText(error, 'the turn failed'));
+                return true;
+            });
+            return { outcome: 'failed' };
+        }
+    }
+    async cancelled(runId) {
+        try {
+            const status = (await this.engine?.getRun(runId))?.status;
+            return status === 'cancelling' || status === 'cancelled';
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=workflow.js.map

package/dist/src/opencode/durable/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../../src/opencode/durable/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,uBAAuB,CAAC;AAG5F,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAItC,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAEhE,qGAAqG;AACrG,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,UAAkB;IAC7D,OAAO,QAAQ,KAAK,IAAI,UAAU,EAAE,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,MAAM,IAAI,GAAI,KAAmC,EAAE,IAAI,CAAC;IACxD,OAAO,IAAI,KAAK,mBAAmB,IAAI,IAAI,KAAK,eAAe,CAAC;AAClE,CAAC;AAED,kFAAkF;AAClF,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC;AACvE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IAIhC,KAAK;IACL,MAAM;IAJzB,MAAM,CAAU,QAAQ,GAAG,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAEzE,YACmB,KAAoB,EACpB,MAAuB;QAExC,KAAK,EAAE,CAAC;qBAHS,KAAK;sBACL,MAAM;IAGzB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAgB,EAAE,KAAoB;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,6FAA6F;QAC7F,uFAAuF;QACvF,MAAM,IAAI,GAAG,CAAI,IAAY,EAAE,IAAsB,EAAc,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChG,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;gBAC7C,MAAM,EAAE,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC;gBACjD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC,CAAC;YACJ,IAAI,MAAM,GAAkB,KAAK,CAAC,MAAM,CAAC;YACzC,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;gBAC9B,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;gBAC7C,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;YACH,KAAK,IAAI,CAAC,GAAG,CAAC,GAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,SAAS,GAAc,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,CAC3D,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CACxC,CAAC;gBACF,IAAI,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBAClC,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;wBAC9B,+EAA+E;wBAC/E,IAAI,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;4BAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;6BACtD,CAAC;4BACJ,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;wBACxF,CAAC;wBACD,OAAO,IAAI,CAAC;oBACd,CAAC,CAAC,CAAC;oBACH,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC/C,CAAC;gBACD,IAAI,KAAiB,CAAC;gBACtB,IAAI,CAAC;oBACH,KAAK,GAAG,MAAM,GAAG,CAAC,aAAa,CAC7B,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAC1C,SAAS,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CACnF,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;wBAAE,MAAM,KAAK,CAAC;oBACzC,KAAK,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAqB,CAAC;gBAChE,CAAC;gBACD,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC;gBAC1B,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,mBAAmB,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YAC5C,MAAM,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;gBAC5B,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC;gBAChF,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,KAAa;QACnC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAA4B,CAAC;YAChF,OAAO,MAAM,KAAK,YAAY,IAAI,MAAM,KAAK,WAAW,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,48 @@
+import type { AgentEngine, AgentEngineContext } from '../engine.js';
+import type { AgentRunner } from '../spi/agent-runner.js';
+import type { ProtocolAdapter } from '../spi/protocol-adapter.js';
+import { type OpenCodeHost, type OpenCodeSessionStore } from './host.js';
+import { OpenCodeMcpEndpoint } from './mcp.js';
+import { type OpenCodeEngineSettings, OpenCodeTurns } from './turns.js';
+/** A class the container builds (`@inject()` its services into the constructor). */
+export type OpenCodeClass<T> = abstract new (...args: any[]) => T;
+export interface OpenCodeEngineOptions extends OpenCodeEngineSettings {
+    /**
+     * The host: an {@link OpenCodeHost} instance, or a class the app's container builds (so it can
+     * `@inject()` the services that know where the server is and how to set sessions up).
+     */
+    host: OpenCodeHost | OpenCodeClass<OpenCodeHost>;
+    /** Where each thread's session is kept. Same forms as `host`. Omit → in memory. */
+    sessions?: OpenCodeSessionStore | OpenCodeClass<OpenCodeSessionStore>;
+}
+/**
+ * The OpenCode engine — `engine: openCode({ host })` in `config/agent.ts`. The routes, threads,
+ * stream protocol, approvals, questions and queue stay the library's; OpenCode runs the model, the
+ * tools, skills and the context, on the server and sessions the host provides.
+ */
+export declare class OpenCodeEngine implements AgentEngine {
+    #private;
+    readonly options: OpenCodeEngineOptions;
+    readonly name: string;
+    readonly durable: boolean;
+    constructor(options: OpenCodeEngineOptions);
+    /**
+     * The engine's turn steps, once the provider built the runner: `pushToSession` (trusted pushes
+     * into a session's run) and `liveRuns()` for the host's own use.
+     */
+    get turns(): OpenCodeTurns;
+    /** The tools endpoint, when `tools` is set and the engine has started. */
+    get endpoint(): OpenCodeMcpEndpoint | undefined;
+    createRunner(context: AgentEngineContext): Promise<AgentRunner>;
+    adapters(): readonly ProtocolAdapter[];
+    shutdown(): void;
+    /** The host, the session store, the tools endpoint and the turn steps every OpenCode runner needs. */
+    protected buildTurns(context: AgentEngineContext): Promise<OpenCodeTurns>;
+}
+/**
+ * Run the agent's turns on OpenCode 2 — `engine: openCode({ host })` in `config/agent.ts`. In
+ * memory: a turn parked on a person lives in this process (single replica); see
+ * `openCodeDurable()` (`@adonis-agora/agent/opencode/durable`) for turns that survive restarts.
+ */
+export declare function openCode(options: OpenCodeEngineOptions): OpenCodeEngine;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/opencode/engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC1B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,mBAAmB,EAAuB,MAAM,UAAU,CAAC;AAEpE,OAAO,EAAE,KAAK,sBAAsB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExE,oFAAoF;AAEpF,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAElE,MAAM,WAAW,qBAAsB,SAAQ,sBAAsB;IACnE;;;OAGG;IACH,IAAI,EAAE,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IACjD,mFAAmF;IACnF,QAAQ,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAC;CACvE;AAkBD;;;;GAIG;AACH,qBAAa,cAAe,YAAW,WAAW;;IAMpC,QAAQ,CAAC,OAAO,EAAE,qBAAqB;IALnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAc;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAS;IAIlC,YAAqB,OAAO,EAAE,qBAAqB,EAAI;IAEvD;;;OAGG;IACH,IAAI,KAAK,IAAI,aAAa,CAKzB;IAED,0EAA0E;IAC1E,IAAI,QAAQ,IAAI,mBAAmB,GAAG,SAAS,CAE9C;IAEK,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAGpE;IAED,QAAQ,IAAI,SAAS,eAAe,EAAE,CAErC;IAED,QAAQ,IAAI,IAAI,CAEf;IAED,sGAAsG;IACtG,UAAgB,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAqC9E;CACF;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAEvE"}

package/dist/src/opencode/engine.js

@@ -0,0 +1,98 @@
+import { createHash } from 'node:crypto';
+import { InMemoryOpenCodeSessionStore, } from './host.js';
+import { openCodeLog } from './log.js';
+import { OpenCodeMcpEndpoint, OpenCodeToolsTokens } from './mcp.js';
+import { OpenCodeAgentRunner } from './runner.js';
+import { OpenCodeTurns } from './turns.js';
+const DEFAULT_TOOLS_TTL_MS = 7 * 24 * 60 * 60_000;
+async function resolve(value, context, what) {
+    if (typeof value !== 'function')
+        return value;
+    if (context.make === undefined) {
+        throw new Error(`[@adonis-agora/agent/opencode] the ${what} is a class, and there is no container to build it with: pass an instance.`);
+    }
+    return context.make(value);
+}
+/**
+ * The OpenCode engine — `engine: openCode({ host })` in `config/agent.ts`. The routes, threads,
+ * stream protocol, approvals, questions and queue stay the library's; OpenCode runs the model, the
+ * tools, skills and the context, on the server and sessions the host provides.
+ */
+export class OpenCodeEngine {
+    options;
+    name = 'opencode';
+    durable = false;
+    #turns;
+    #endpoint;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * The engine's turn steps, once the provider built the runner: `pushToSession` (trusted pushes
+     * into a session's run) and `liveRuns()` for the host's own use.
+     */
+    get turns() {
+        if (this.#turns === undefined) {
+            throw new Error('[@adonis-agora/agent/opencode] the engine has not been started yet.');
+        }
+        return this.#turns;
+    }
+    /** The tools endpoint, when `tools` is set and the engine has started. */
+    get endpoint() {
+        return this.#endpoint;
+    }
+    async createRunner(context) {
+        const turns = await this.buildTurns(context);
+        return new OpenCodeAgentRunner(turns, context.store);
+    }
+    adapters() {
+        return this.#endpoint !== undefined ? [this.#endpoint.adapter()] : [];
+    }
+    shutdown() {
+        this.#turns?.close();
+    }
+    /** The host, the session store, the tools endpoint and the turn steps every OpenCode runner needs. */
+    async buildTurns(context) {
+        const { host: hostOption, sessions: sessionsOption, ...settings } = this.options;
+        const host = await resolve(hostOption, context, 'host');
+        const sessions = sessionsOption === undefined
+            ? new InMemoryOpenCodeSessionStore()
+            : await resolve(sessionsOption, context, 'session store');
+        let tokens;
+        if (settings.tools !== undefined) {
+            const secret = settings.tools.secret ??
+                (context.appKey !== undefined
+                    ? createHash('sha256').update(`opencode-tools:${context.appKey}`).digest('hex')
+                    : undefined);
+            if (secret === undefined) {
+                openCodeLog.warn('`tools` has no `secret` and the app has no APP_KEY: the endpoint signs its tokens with a per-process secret, so it only works with one process.');
+            }
+            tokens = new OpenCodeToolsTokens(secret, settings.tools.ttlMs ?? DEFAULT_TOOLS_TTL_MS);
+        }
+        const turns = new OpenCodeTurns({
+            host,
+            sessions,
+            settings,
+            factory: context.factory,
+            store: context.store,
+            sink: context.sink,
+            registry: context.registry,
+            queue: context.queue,
+            ...(tokens !== undefined
+                ? { mintToolsToken: (actor, serverKey) => tokens.mint(actor, serverKey) }
+                : {}),
+        });
+        this.#turns = turns;
+        this.#endpoint = tokens !== undefined ? new OpenCodeMcpEndpoint(turns, tokens) : undefined;
+        return turns;
+    }
+}
+/**
+ * Run the agent's turns on OpenCode 2 — `engine: openCode({ host })` in `config/agent.ts`. In
+ * memory: a turn parked on a person lives in this process (single replica); see
+ * `openCodeDurable()` (`@adonis-agora/agent/opencode/durable`) for turns that survive restarts.
+ */
+export function openCode(options) {
+    return new OpenCodeEngine(options);
+}
+//# sourceMappingURL=engine.js.map

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

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

package/dist/src/opencode/event-hub.d.ts

@@ -0,0 +1,23 @@
+import type { OpenCodeClient, OpenCodeEvent } from './client.js';
+type Listener = (event: OpenCodeEvent) => void;
+/** The session an event belongs to. Form events carry it inside the form. */
+export declare function sessionOf(event: OpenCodeEvent): string | undefined;
+/**
+ * One event subscription per OpenCode server, fanned out to the turns listening on its sessions. A
+ * server's stream closes when its last listener leaves; a stream that drops reconnects with backoff.
+ */
+export declare class OpenCodeEventHub {
+    private readonly streams;
+    /** Listen to one session's events on a server. Resolves once the server's stream is open. */
+    listen(serverKey: string, client: OpenCodeClient, sessionId: string, listener: Listener): Promise<() => void>;
+    close(): void;
+    /**
+     * The server's stream, opened on `client`. A different client for a known key (the host replaced
+     * the connection, e.g. a new sandbox under the same key) moves every listener to a stream on the
+     * new one: the old connection may be dead, and its sessions would never hear back.
+     */
+    private streamFor;
+    private pump;
+}
+export {};
+//# sourceMappingURL=event-hub.d.ts.map

package/dist/src/opencode/event-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-hub.d.ts","sourceRoot":"","sources":["../../../src/opencode/event-hub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjE,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAU/C,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAGlE;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD,6FAA6F;IACvF,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,MAAM,IAAI,CAAC,CAoBrB;IAED,KAAK,IAAI,IAAI,CAGZ;IAED;;;;OAIG;IACH,OAAO,CAAC,SAAS;YAoBH,IAAI;CAgCnB"}

package/dist/src/opencode/event-hub.js

@@ -0,0 +1,99 @@
+import { openCodeLog } from './log.js';
+/** The session an event belongs to. Form events carry it inside the form. */
+export function sessionOf(event) {
+    const id = event.data?.sessionID ?? event.data?.form?.sessionID;
+    return typeof id === 'string' ? id : undefined;
+}
+/**
+ * One event subscription per OpenCode server, fanned out to the turns listening on its sessions. A
+ * server's stream closes when its last listener leaves; a stream that drops reconnects with backoff.
+ */
+export class OpenCodeEventHub {
+    streams = new Map();
+    /** Listen to one session's events on a server. Resolves once the server's stream is open. */
+    async listen(serverKey, client, sessionId, listener) {
+        const stream = this.streamFor(serverKey, client);
+        let set = stream.listeners.get(sessionId);
+        if (set === undefined) {
+            set = new Set();
+            stream.listeners.set(sessionId, set);
+        }
+        set.add(listener);
+        await stream.ready;
+        return () => {
+            // The server's stream now — it may have moved to a new client since this listener joined.
+            const live = this.streams.get(serverKey) ?? stream;
+            const current = live.listeners.get(sessionId);
+            current?.delete(listener);
+            if (current?.size === 0)
+                live.listeners.delete(sessionId);
+            if (live.listeners.size === 0 && this.streams.get(serverKey) === live) {
+                live.controller.abort();
+                this.streams.delete(serverKey);
+            }
+        };
+    }
+    close() {
+        for (const stream of this.streams.values())
+            stream.controller.abort();
+        this.streams.clear();
+    }
+    /**
+     * The server's stream, opened on `client`. A different client for a known key (the host replaced
+     * the connection, e.g. a new sandbox under the same key) moves every listener to a stream on the
+     * new one: the old connection may be dead, and its sessions would never hear back.
+     */
+    streamFor(serverKey, client) {
+        const existing = this.streams.get(serverKey);
+        if (existing !== undefined && existing.client === client)
+            return existing;
+        existing?.controller.abort();
+        const controller = new AbortController();
+        let opened;
+        const ready = new Promise((resolve) => {
+            opened = resolve;
+        });
+        const stream = {
+            client,
+            controller,
+            listeners: existing?.listeners ?? new Map(),
+            ready,
+        };
+        this.streams.set(serverKey, stream);
+        void this.pump(serverKey, stream, client, opened);
+        return stream;
+    }
+    async pump(serverKey, stream, client, opened) {
+        let backoff = 500;
+        while (!stream.controller.signal.aborted) {
+            try {
+                const events = client.event.subscribe({ signal: stream.controller.signal });
+                opened();
+                for await (const event of events) {
+                    backoff = 500;
+                    const sessionId = sessionOf(event);
+                    if (sessionId === undefined)
+                        continue;
+                    for (const listener of stream.listeners.get(sessionId) ?? []) {
+                        try {
+                            listener(event);
+                        }
+                        catch (error) {
+                            openCodeLog.error(`an event listener failed: ${error.message}`);
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                if (stream.controller.signal.aborted)
+                    return;
+                openCodeLog.warn(`the event stream of ${serverKey} dropped: ${error.message}`);
+            }
+            if (stream.controller.signal.aborted)
+                return;
+            await new Promise((resolve) => setTimeout(resolve, backoff).unref?.());
+            backoff = Math.min(backoff * 2, 10_000);
+        }
+    }
+}
+//# sourceMappingURL=event-hub.js.map

package/dist/src/opencode/event-hub.js.map

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

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

@@ -0,0 +1,19 @@
+import type { ElicitationQuestion, ElicitationRequest } from '../elicitation.js';
+import type { OpenCodeForm, OpenCodeFormField, OpenCodeFormValue } from './client.js';
+/** An OpenCode form field as a stream-protocol question (`elicitation`, *Asking the user*). */
+export declare function toQuestion(field: OpenCodeFormField): ElicitationQuestion;
+/** The fields of a form, skipping anything that is not one. */
+export declare function formFields(form: Pick<OpenCodeForm, 'fields'>): OpenCodeFormField[];
+/** The elicitation an OpenCode form streams as, under `id` (the tool-call id it is answered through). */
+export declare function toElicitation(id: string, form: OpenCodeForm): ElicitationRequest;
+/** An answer a form field cannot take. */
+export declare class FormAnswerError extends Error {
+    constructor(message: string);
+}
+/**
+ * The protocol's answers (question id → canonical strings) as OpenCode's form reply: numbers as
+ * numbers, booleans as booleans, multiple choice as a list. Questions left out take their defaults;
+ * a value a question can't take throws {@link FormAnswerError}.
+ */
+export declare function toFormAnswer(form: OpenCodeForm, answers?: Record<string, string[]>): Record<string, OpenCodeFormValue>;
+//# sourceMappingURL=forms.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forms.d.ts","sourceRoot":"","sources":["../../../src/opencode/forms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEjF,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEtF,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,mBAAmB,CA4BxE;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,iBAAiB,EAAE,CAKlF;AAED,yGAAyG;AACzG,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,kBAAkB,CAUhF;AAED,0CAA0C;AAC1C,qBAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM,GACrC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAkBnC"}

package/dist/src/opencode/forms.js

@@ -0,0 +1,82 @@
+import { validateElicitationAnswer } from '../elicitation-input.js';
+/** An OpenCode form field as a stream-protocol question (`elicitation`, *Asking the user*). */
+export function toQuestion(field) {
+    const required = field.required === true ? { required: true } : {};
+    const base = {
+        id: field.key,
+        prompt: field.title || field.key,
+        ...(field.description && field.description !== field.title
+            ? { description: field.description }
+            : {}),
+    };
+    if (field.options !== undefined && field.options.length > 0) {
+        return {
+            ...base,
+            options: field.options.map((option) => ({
+                value: String(option.value),
+                label: String(option.label ?? option.value),
+            })),
+            input: { type: 'select', ...required },
+            ...(field.type === 'array' ? { multiple: true } : {}),
+            ...(field.custom === true ? { allowFreeText: true } : {}),
+        };
+    }
+    const type = field.type === 'number' || field.type === 'integer'
+        ? 'number'
+        : field.type === 'boolean'
+            ? 'boolean'
+            : 'text';
+    return { ...base, input: { type, ...required } };
+}
+/** The fields of a form, skipping anything that is not one. */
+export function formFields(form) {
+    return (form.fields ?? []).filter((field) => typeof field === 'object' && field !== null && typeof field.key === 'string');
+}
+/** The elicitation an OpenCode form streams as, under `id` (the tool-call id it is answered through). */
+export function toElicitation(id, form) {
+    const questions = formFields(form).map(toQuestion);
+    const first = questions[0];
+    // OpenCode titles a one-question form after the question (or just "Questions"): not a preamble.
+    const title = form.title;
+    const preamble = title && title !== 'Questions' && title !== first?.prompt && title !== first?.description
+        ? title
+        : undefined;
+    return { id, source: 'ask', ...(preamble ? { preamble } : {}), questions };
+}
+/** An answer a form field cannot take. */
+export class FormAnswerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FormAnswerError';
+    }
+}
+/**
+ * The protocol's answers (question id → canonical strings) as OpenCode's form reply: numbers as
+ * numbers, booleans as booleans, multiple choice as a list. Questions left out take their defaults;
+ * a value a question can't take throws {@link FormAnswerError}.
+ */
+export function toFormAnswer(form, answers = {}) {
+    const out = {};
+    for (const field of formFields(form)) {
+        const question = toQuestion(field);
+        const values = answers[field.key] ?? question.defaults ?? [];
+        const problem = validateElicitationAnswer(question, values);
+        if (problem !== null) {
+            throw new FormAnswerError(`answers["${field.key}"] ${problem}`);
+        }
+        const present = values.filter((value) => value !== '');
+        const [value] = present;
+        if (value === undefined)
+            continue;
+        if (question.multiple === true)
+            out[field.key] = present;
+        else if (question.input?.type === 'number')
+            out[field.key] = Number(value);
+        else if (question.input?.type === 'boolean')
+            out[field.key] = value === 'true';
+        else
+            out[field.key] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=forms.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forms.js","sourceRoot":"","sources":["../../../src/opencode/forms.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAGpE,+FAA+F;AAC/F,MAAM,UAAU,UAAU,CAAC,KAAwB;IACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,IAAI,GAAG;QACX,EAAE,EAAE,KAAK,CAAC,GAAG;QACb,MAAM,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG;QAChC,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,KAAK;YACxD,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE;YACpC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,OAAO;YACL,GAAG,IAAI;YACP,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBACtC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;aAC5C,CAAC,CAAC;YACH,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE;YACtC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1D,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GACR,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QACjD,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;YACxB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,MAAM,CAAC;IACf,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,EAAE,CAAC;AACnD,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,IAAkC;IAC3D,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAC/B,CAAC,KAAK,EAA8B,EAAE,CACpC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAC/E,CAAC;AACJ,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,IAAkB;IAC1D,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,gGAAgG;IAChG,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,MAAM,QAAQ,GACZ,KAAK,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,KAAK,EAAE,MAAM,IAAI,KAAK,KAAK,KAAK,EAAE,WAAW;QACvF,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC;AAC7E,CAAC;AAED,0CAA0C;AAC1C,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAkB,EAClB,OAAO,GAA6B,EAAE;IAEtC,MAAM,GAAG,GAAsC,EAAE,CAAC;IAClD,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC7D,MAAM,OAAO,GAAG,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC5D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,eAAe,CAAC,YAAY,KAAK,CAAC,GAAG,MAAM,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;QACxB,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,QAAQ,CAAC,QAAQ,KAAK,IAAI;YAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;aACpD,IAAI,QAAQ,CAAC,KAAK,EAAE,IAAI,KAAK,QAAQ;YAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;aACtE,IAAI,QAAQ,CAAC,KAAK,EAAE,IAAI,KAAK,SAAS;YAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,MAAM,CAAC;;YAC1E,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}