@adonis-agora/agent 0.61.0 → 0.62.0

package/dist/src/opencode/mcp.js

@@ -0,0 +1,258 @@
+import { createHash, createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { toJsonSchemaCompat } from '@modelcontextprotocol/sdk/server/zod-json-schema-compat.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { REMEMBER_TOOL_DESCRIPTION, REMEMBER_TOOL_NAME, rememberInputSchema, writeMemory, } from '../memory.js';
+import { defaultScopeResolver } from '../skills.js';
+import { ToolNotFoundError } from '../tool-registry.js';
+import { errorText } from './log.js';
+/** Kinds the LOOP serves; a registry entry of one of them cannot be honoured over MCP. */
+const LOOP_SERVED_KINDS = new Set(['agent', 'ask', 'skill', 'memory']);
+const b64url = (data) => Buffer.from(data).toString('base64url');
+/**
+ * Signs and checks the bearer tokens the engine registers its tools endpoint with (`mcp.add`). A
+ * token names an actor and an OpenCode server, and expires; it is HMAC-SHA256 over its claims with
+ * a key derived from the configured secret (or the app's `APP_KEY`).
+ *
+ * A token on its own runs nothing: the endpoint also needs the call to come from a session that is
+ * running a turn of that actor right now (see `OpenCodeTurns.callContext`), and an `action` tool
+ * needs an approval the turn granted (see `OpenCodeTurns.spendApproval`).
+ */
+export class OpenCodeToolsTokens {
+    ttlMs;
+    key;
+    constructor(secret, ttlMs) {
+        this.ttlMs = ttlMs;
+        this.key = createHash('sha256')
+            .update('agora:opencode:tools\0')
+            .update(secret ?? randomBytes(32).toString('hex'))
+            .digest();
+    }
+    mint(actor, server, now = Date.now()) {
+        const claims = { v: 1, actor, server, exp: now + this.ttlMs };
+        const body = b64url(JSON.stringify(claims));
+        return `${body}.${this.sign(body)}`;
+    }
+    verify(token, now = Date.now()) {
+        const [body, signature, extra] = token.split('.');
+        if (body === undefined || signature === undefined || extra !== undefined)
+            return null;
+        const expected = Buffer.from(this.sign(body));
+        const given = Buffer.from(signature);
+        if (expected.length !== given.length || !timingSafeEqual(expected, given))
+            return null;
+        try {
+            const claims = JSON.parse(Buffer.from(body, 'base64url').toString('utf8'));
+            if (claims?.v !== 1 ||
+                typeof claims.server !== 'string' ||
+                typeof claims.exp !== 'number' ||
+                typeof claims.actor?.id !== 'string' ||
+                claims.exp <= now) {
+                return null;
+            }
+            return claims;
+        }
+        catch {
+            return null;
+        }
+    }
+    sign(body) {
+        return createHmac('sha256', this.key).update(body).digest('base64url');
+    }
+}
+/** True for a Zod schema (its Standard Schema props say `vendor: 'zod'`). */
+function isZodSchema(schema) {
+    return schema['~standard'].vendor === 'zod';
+}
+/** A tool's input schema as the JSON Schema MCP clients read — as the `config/mcp.ts` surface does. */
+function toJsonSchema(schema) {
+    if (isZodSchema(schema))
+        return toJsonSchemaCompat(schema);
+    const converter = schema['~standard'].jsonSchema;
+    if (typeof converter?.input === 'function') {
+        return converter.input();
+    }
+    return { type: 'object', properties: {}, additionalProperties: true };
+}
+const asText = (output) => (typeof output === 'string' ? output : JSON.stringify(output));
+class RefusedError extends Error {
+}
+/**
+ * The MCP endpoint OpenCode sessions reach the app's tools through — `POST <agent path>/opencode/mcp`,
+ * mounted by the engine when `tools` is set. Stateless Streamable HTTP (one server per request), so
+ * it answers from any process.
+ *
+ * - `tools/list`: the registry's tools the token's actor may reach (roles, `enabled`, `canUse`), the
+ *   kinds only the loop serves left out; with `_meta` naming a running turn, its agent's allow-list
+ *   too. Plus `remember`, when the agent's memory provider writes.
+ * - `tools/call`: only for a call `_meta` ties to a turn of the token's actor running on that
+ *   session; the turn's allow-list and the registry's own checks apply, an `action` runs only against
+ *   an approval the turn granted, and the tool's `ctx` is the turn's (thread, run, `emitUi` into its
+ *   stream and message).
+ */
+export class OpenCodeMcpEndpoint {
+    turns;
+    tokens;
+    constructor(turns, tokens) {
+        this.turns = turns;
+        this.tokens = tokens;
+    }
+    /** Mounts the endpoint next to the agent's routes. */
+    adapter() {
+        return {
+            name: 'opencode-mcp',
+            mount: (host) => {
+                host.post('opencode/mcp', (ctx) => this.handle(ctx));
+                // Stateless: no server-sent stream to resume, no session to close.
+                host.get('opencode/mcp', (ctx) => ctx.response.status(405).header('allow', 'POST').json({ error: 'method not allowed' }));
+            },
+        };
+    }
+    /** The claims of a request's bearer token, or `null`. */
+    authenticate(authorization) {
+        const token = /^Bearer\s+/i.test(authorization ?? '')
+            ? authorization?.replace(/^Bearer\s+/i, '').trim()
+            : undefined;
+        return token ? this.tokens.verify(token) : null;
+    }
+    async handle(ctx) {
+        const claims = this.authenticate(ctx.request.header('authorization'));
+        if (claims === null) {
+            ctx.response.header('WWW-Authenticate', 'Bearer error="invalid_token"');
+            ctx.response.status(401).json({ error: 'unauthorized' });
+            return;
+        }
+        const req = ctx.request.request;
+        const res = ctx.response.response;
+        const server = this.server(claims);
+        // No `sessionIdGenerator`: stateless, so any process answers any request.
+        const transport = new StreamableHTTPServerTransport({ enableJsonResponse: true });
+        res.on('close', () => {
+            void transport.close();
+            void server.close();
+        });
+        try {
+            await server.connect(transport);
+            await transport.handleRequest(req, res, ctx.request.body());
+        }
+        catch (error) {
+            if (!res.headersSent) {
+                res.statusCode = 500;
+                res.setHeader('content-type', 'application/json');
+                res.end(JSON.stringify({
+                    jsonrpc: '2.0',
+                    error: { code: -32603, message: errorText(error, 'Internal error') },
+                    id: null,
+                }));
+            }
+        }
+        await new Promise((resolve) => {
+            if (res.writableFinished)
+                return resolve();
+            res.on('finish', () => resolve());
+            res.on('close', () => resolve());
+        });
+    }
+    /** One MCP server for one request, answering as the token's actor. */
+    server(claims) {
+        const server = new Server({ name: 'agora-opencode', version: '1.0.0' }, { capabilities: { tools: {} } });
+        const { actor } = claims;
+        const call = (meta, requestId) => this.turns.callContext({
+            actor,
+            serverKey: claims.server,
+            requestId: String(requestId ?? ''),
+            meta: meta,
+        });
+        server.setRequestHandler(ListToolsRequestSchema, async (request, extra) => {
+            const turn = await call(request.params?._meta, extra.requestId);
+            const input = turn?.input ?? {};
+            const deps = this.turns.depsFor(input);
+            const allowed = turn !== undefined ? this.turns.allowedTools(turn.input) : undefined;
+            const definitions = (await this.turns.registry.definitionsFor(actor, deps.rolesPolicy, allowed)).filter((definition) => !LOOP_SERVED_KINDS.has(definition.kind));
+            const tools = definitions.map((definition) => ({
+                name: definition.name,
+                description: definition.description,
+                inputSchema: toJsonSchema(definition.inputSchema),
+            }));
+            if (this.turns.memoryWritable(input)) {
+                tools.push({
+                    name: REMEMBER_TOOL_NAME,
+                    description: REMEMBER_TOOL_DESCRIPTION,
+                    inputSchema: toJsonSchema(rememberInputSchema),
+                });
+            }
+            return { tools };
+        });
+        server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
+            const { name, arguments: args } = request.params;
+            try {
+                const turn = await call(request.params._meta, extra.requestId);
+                if (turn === undefined) {
+                    throw new RefusedError('This endpoint serves OpenCode turns: no turn of yours is running on this session.');
+                }
+                const output = name === REMEMBER_TOOL_NAME && this.turns.memoryWritable(turn.input)
+                    ? await this.remember(turn, args)
+                    : await this.invoke(turn, actor, name, args, String(extra.requestId ?? ''));
+                return { content: [{ type: 'text', text: asText(output) }] };
+            }
+            catch (error) {
+                return {
+                    content: [{ type: 'text', text: errorText(error, 'the tool failed') }],
+                    isError: true,
+                };
+            }
+        });
+        return server;
+    }
+    async invoke(turn, actor, name, args, requestId) {
+        const spec = this.turns.registry.spec(name);
+        if (spec === undefined || LOOP_SERVED_KINDS.has(spec.kind))
+            throw new ToolNotFoundError(name);
+        const allowed = this.turns.allowedTools(turn.input);
+        if (allowed !== undefined && !allowed.includes(name))
+            throw new ToolNotFoundError(name);
+        if (spec.kind === 'action' &&
+            !(await this.turns.spendApproval(turn.runId, turn.ctx.threadId, name))) {
+            throw new RefusedError(`"${name}" is an action and nobody approved this call; ask for the permission first.`);
+        }
+        const deps = this.turns.depsFor(turn.input);
+        const ctx = {
+            actor,
+            threadId: turn.ctx.threadId,
+            runId: turn.runId,
+            requestId: `mcp:${turn.runId}:${requestId}`,
+            emitUi: turn.ctx.emitUi,
+            ...(turn.ctx.agentName !== undefined ? { agentName: turn.ctx.agentName } : {}),
+            ...(turn.input.pageContext !== undefined ? { pageContext: turn.input.pageContext } : {}),
+        };
+        return this.turns.registry.invoke(name, args ?? {}, ctx, deps.rolesPolicy, allowed !== undefined ? { allowedTools: allowed } : {});
+    }
+    /** `remember`: one fact, at the actor's own scope only — as the loop serves it. */
+    async remember(turn, args) {
+        const memory = this.turns.depsFor(turn.input).memory;
+        if (memory === undefined)
+            throw new ToolNotFoundError(REMEMBER_TOOL_NAME);
+        const parsed = await rememberInputSchema['~standard'].validate(args ?? {});
+        if (parsed.issues !== undefined) {
+            throw new RefusedError(`remember: ${parsed.issues.map((issue) => issue.message).join('; ')}`);
+        }
+        const ctx = {
+            actor: turn.input.actor,
+            threadId: turn.ctx.threadId,
+            ...(turn.ctx.agentName !== undefined ? { agentName: turn.ctx.agentName } : {}),
+        };
+        const scopes = await (memory.scopes ?? defaultScopeResolver).resolve(ctx);
+        const outcome = await writeMemory({
+            config: memory,
+            digest: { scopes, entries: [], omitted: 0, pinnedOmitted: 0 },
+            call: parsed.value,
+            ctx,
+            runId: turn.runId,
+        });
+        if (!outcome.ok)
+            return `Not recorded: ${outcome.error}`;
+        return `Recorded "${outcome.record.key}".`;
+    }
+}
+//# sourceMappingURL=mcp.js.map

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

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

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