@adonis-agora/agent 0.61.0 → 0.63.0

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

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

@@ -0,0 +1,179 @@
+import type { AgentUiComponent } from '../stream-events.js';
+import type { Actor, AgentRunInput, StoredMessage } from '../types.js';
+import type { OpenCodeClient, OpenCodePromptFile, OpenCodeSessionCreate } from './client.js';
+import type { PendingAsk, TurnOutcome } from './turn.js';
+/**
+ * Where a turn runs and how its OpenCode session is set up — the part only the host knows. The
+ * engine owns everything between the library and OpenCode (sessions per thread, the event stream,
+ * the turn's frames, approvals and questions, cancel); the host answers these questions.
+ *
+ * Every method is called as a method of the host (`host.onSettled(…)`), so a class host can read
+ * its own services off `this`.
+ */
+export interface OpenCodeHost {
+    /**
+     * The OpenCode server this actor's turns run on — one per tenant in a sandbox, one for the whole
+     * deployment, anything. Asked once per turn, so a server that restarted is picked up.
+     */
+    server(actor: Actor): Promise<OpenCodeServer>;
+    /**
+     * How to create a session for a thread: location, model, OpenCode agent, permission rules.
+     * Asked only when the thread has no live session on this server (its first turn, or the server
+     * restarted since). `input.model` is the model the caller picked for this turn, when it picked one.
+     */
+    session(context: OpenCodeTurnContext): Promise<OpenCodeSessionCreate>;
+    /**
+     * Instructions entries refreshed on every turn (key → text), on top of the agent's own prompt
+     * (its `systemPrompt` and persona, under `agora.system`). Profile, the project a chat is about…
+     * An entry that disappears is not cleared: put an empty value to drop it.
+     */
+    instructions?(context: OpenCodeTurnContext & {
+        sessionId: string;
+    }): Promise<Record<string, string>>;
+    /**
+     * What the session is prompted with, when it is more than the user message: documents read into
+     * the text, images as files the model can see. Omit → the user message, and `files`.
+     */
+    promptFor?(context: OpenCodeTurnContext & {
+        sessionId: string;
+    }): Promise<{
+        text: string;
+        files?: OpenCodePromptFile[];
+    }>;
+    /**
+     * The user message's attachments (`input.attachments`) in the form `session.prompt` takes them.
+     * Omit → attachments are not sent to OpenCode. Not asked when `promptFor` answers.
+     */
+    files?(context: OpenCodeTurnContext): Promise<OpenCodePromptFile[]>;
+    /**
+     * Anything else to do on a NEW session before its first prompt — register MCP servers of your own
+     * (`client.mcp.add`), write files… Runs right after `session` and before `instructions`.
+     */
+    prepare?(context: OpenCodeTurnContext & {
+        sessionId: string;
+        client: OpenCodeClient;
+    }): Promise<void>;
+    /**
+     * `openCodeDurable()` only: the turn's workflow start options (tags, search attributes, a
+     * concurrency quota) — like `durable.start` in the engine's options, from a host with services.
+     */
+    startOptions?(input: AgentRunInput, runId: string): Promise<Record<string, unknown>>;
+    /** `openCodeDurable()` only: what a refused start becomes (e.g. a concurrency limit → a 429). */
+    startError?(error: unknown, input: AgentRunInput): unknown;
+    /**
+     * May this turn keep the thread's session? Asked when the session is still on its server; `false`
+     * opens a new one (told the conversation so far) — e.g. the person the session's tools act for
+     * changed. Omit → always reuse.
+     */
+    reuse?(context: OpenCodeTurnContext & {
+        session: OpenCodeSessionRef;
+    }): Promise<boolean>;
+    /**
+     * Every turn, once the session is known (`created`: opened for this turn) and before the prompt:
+     * bring it up to date — the turn's model, permission rules that changed, tools.
+     */
+    beforePrompt?(context: OpenCodeTurnContext & {
+        sessionId: string;
+        client: OpenCodeClient;
+        created: boolean;
+    }): Promise<void>;
+    /**
+     * A person was asked something (an approval or a question form): post it where else they are —
+     * a Slack thread, a Teams chat — or wake whoever waits on the run. May run again for the same ask
+     * after a restart: make it idempotent. Errors are logged, never the run's.
+     */
+    onAsk?(context: OpenCodeTurnContext & {
+        sessionId: string;
+        ask: PendingAsk;
+    }): Promise<void>;
+    /** A tool pushed a component into the run (`ctx.emitUi` over the engine's MCP endpoint). */
+    onUi?(context: OpenCodeTurnContext & {
+        component: AgentUiComponent;
+    }): Promise<void>;
+    /**
+     * The run is over and about to settle: the last word on the answer — components appended to it
+     * (a guardrail notice), and for a failed run the error the person reads instead of OpenCode's.
+     */
+    beforeSettle?(result: OpenCodeRunResult): Promise<OpenCodeAmendment | undefined>;
+    /**
+     * The run settled (the stream ended, the thread moved on): deliver the answer elsewhere, record
+     * spend and telemetry. Errors are logged, never the run's.
+     */
+    onSettled?(result: OpenCodeRunResult): Promise<void>;
+}
+/** What a run produced, as the host's settle hooks see it. */
+export interface OpenCodeRunResult {
+    runId: string;
+    input: AgentRunInput;
+    outcome: TurnOutcome;
+    /** The run's answer: its assistant messages' text, in order. */
+    text: string;
+    /** The run's assistant messages, as stored. */
+    messages: StoredMessage[];
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        costUsd: number;
+    };
+    durationMs: number;
+}
+/** See {@link OpenCodeHost.beforeSettle}. */
+export interface OpenCodeAmendment {
+    ui?: AgentUiComponent[];
+    /** For a failed run: what the person reads. */
+    error?: string;
+}
+export interface OpenCodeServer {
+    client: OpenCodeClient;
+    /** Identifies the server across turns; sessions are only reused on the server that holds them. */
+    key: string;
+    /**
+     * Changes whenever the server restarts and loses its sessions (a sandbox boot id). Omit for a
+     * server whose sessions outlive restarts.
+     */
+    bootId?: string;
+}
+export interface OpenCodeTurnContext {
+    input: AgentRunInput;
+    runId: string;
+}
+/** The session a thread talks to, and where it lives. */
+export interface OpenCodeSessionRef {
+    sessionId: string;
+    serverKey: string;
+    bootId?: string;
+    /** The session's directory (`location.directory`), when it has one. */
+    directory?: string;
+    /**
+     * The agent (and persona id) the thread's latest turn ran as — what the tools endpoint checks a
+     * call against when it lands on a process that is not following the turn.
+     */
+    agentName?: string;
+    persona?: string;
+}
+/**
+ * Which OpenCode session each thread uses. The default keeps it in memory, which is enough for one
+ * process; a deployment with several replicas (or that wants sessions to survive a restart of its
+ * own) persists it — on the thread row, or in Redis with {@link keyValueOpenCodeSessionStore}.
+ */
+export interface OpenCodeSessionStore {
+    get(threadId: string): Promise<OpenCodeSessionRef | null>;
+    set(threadId: string, ref: OpenCodeSessionRef): Promise<void>;
+}
+export declare class InMemoryOpenCodeSessionStore implements OpenCodeSessionStore {
+    private readonly refs;
+    get(threadId: string): Promise<OpenCodeSessionRef | null>;
+    set(threadId: string, ref: OpenCodeSessionRef): Promise<void>;
+}
+/** The two calls of a key-value store a session store needs — an ioredis client (`@adonisjs/redis`) fits. */
+export interface OpenCodeKeyValue {
+    get(key: string): Promise<string | null | undefined>;
+    set(key: string, value: string): Promise<unknown>;
+}
+/**
+ * Sessions kept in a shared key-value store (Redis…), so every process of a deployment finds the
+ * session a thread already has — what running more than one process needs, alongside a
+ * cross-process sink (`tokenSinks.redis()` / `tokenSinks.lucid()`). Keys are `<prefix><threadId>`.
+ */
+export declare function keyValueOpenCodeSessionStore(kv: OpenCodeKeyValue, prefix?: string): OpenCodeSessionStore;
+//# sourceMappingURL=host.d.ts.map

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

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

package/dist/src/opencode/host.js

@@ -0,0 +1,34 @@
+export class InMemoryOpenCodeSessionStore {
+    refs = new Map();
+    async get(threadId) {
+        return this.refs.get(threadId) ?? null;
+    }
+    async set(threadId, ref) {
+        this.refs.set(threadId, ref);
+    }
+}
+/**
+ * Sessions kept in a shared key-value store (Redis…), so every process of a deployment finds the
+ * session a thread already has — what running more than one process needs, alongside a
+ * cross-process sink (`tokenSinks.redis()` / `tokenSinks.lucid()`). Keys are `<prefix><threadId>`.
+ */
+export function keyValueOpenCodeSessionStore(kv, prefix = 'agora:opencode:session:') {
+    return {
+        async get(threadId) {
+            const raw = await kv.get(`${prefix}${threadId}`);
+            if (raw === null || raw === undefined)
+                return null;
+            try {
+                const ref = JSON.parse(raw);
+                return typeof ref.sessionId === 'string' && typeof ref.serverKey === 'string' ? ref : null;
+            }
+            catch {
+                return null;
+            }
+        },
+        async set(threadId, ref) {
+            await kv.set(`${prefix}${threadId}`, JSON.stringify(ref));
+        },
+    };
+}
+//# sourceMappingURL=host.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../../src/opencode/host.ts"],"names":[],"mappings":"AAsKA,MAAM,OAAO,4BAA4B;IACtB,IAAI,GAAG,IAAI,GAAG,EAA8B,CAAC;IAE9D,KAAK,CAAC,GAAG,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,GAAuB;QACjD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;CACF;AAQD;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,EAAoB,EACpB,MAAM,GAAG,yBAAyB;IAElC,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,QAAQ;YAChB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,QAAQ,EAAE,CAAC,CAAC;YACjD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YACnD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAC;gBAClD,OAAO,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7F,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG;YACrB,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,QAAQ,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * `@adonis-agora/agent/opencode` — an engine that runs the agent's turns on OpenCode 2 sessions,
+ * behind the library's routes, stream protocol, approvals, questions and queue. Kept in its own
+ * entry point: the OpenCode client is structural, so nothing here depends on `@opencode/client`.
+ */
+export type { OpenCodeClient, OpenCodeEvent, OpenCodeForm, OpenCodeFormField, OpenCodeFormValue, OpenCodeJson, OpenCodeModelRef, OpenCodePermissionRequest, OpenCodePermissionRule, OpenCodePromptFile, OpenCodeSessionCreate, } from './client.js';
+export { type OpenCodeClass, OpenCodeEngine, type OpenCodeEngineOptions, openCode, } from './engine.js';
+export { OpenCodeEventHub, sessionOf } from './event-hub.js';
+export { FormAnswerError, toElicitation, toFormAnswer, toQuestion } from './forms.js';
+export { InMemoryOpenCodeSessionStore, keyValueOpenCodeSessionStore, type OpenCodeAmendment, type OpenCodeHost, type OpenCodeKeyValue, type OpenCodeRunResult, type OpenCodeServer, type OpenCodeSessionRef, type OpenCodeSessionStore, type OpenCodeTurnContext, } from './host.js';
+export { OpenCodeMcpEndpoint, type OpenCodeToolsClaims, OpenCodeToolsTokens } from './mcp.js';
+export { OpenCodeAgentRunner } from './runner.js';
+export { type Milestone, OpenCodeTurn, type PendingAsk, type TurnOutcome } from './turn.js';
+export { type OpenCodeCallContext, type OpenCodeEngineSettings, type OpenCodeToolCall, type OpenCodeToolsOptions, OpenCodeTurns, SESSION_META_KEY, type SessionHandle, } from './turns.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,YAAY,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,aAAa,EAClB,cAAc,EACd,KAAK,qBAAqB,EAC1B,QAAQ,GACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,KAAK,SAAS,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5F,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,aAAa,EACb,gBAAgB,EAChB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC"}

package/dist/src/opencode/index.js

@@ -0,0 +1,9 @@
+export { OpenCodeEngine, openCode, } from './engine.js';
+export { OpenCodeEventHub, sessionOf } from './event-hub.js';
+export { FormAnswerError, toElicitation, toFormAnswer, toQuestion } from './forms.js';
+export { InMemoryOpenCodeSessionStore, keyValueOpenCodeSessionStore, } from './host.js';
+export { OpenCodeMcpEndpoint, OpenCodeToolsTokens } from './mcp.js';
+export { OpenCodeAgentRunner } from './runner.js';
+export { OpenCodeTurn } from './turn.js';
+export { OpenCodeTurns, SESSION_META_KEY, } from './turns.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/opencode/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAEL,cAAc,EAEd,QAAQ,GACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,GAS7B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,mBAAmB,EAA4B,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAkB,YAAY,EAAqC,MAAM,WAAW,CAAC;AAC5F,OAAO,EAKL,aAAa,EACb,gBAAgB,GAEjB,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,9 @@
+/** The engine's console voice — the same `[package] message` lines the rest of the library writes. */
+export declare const openCodeLog: {
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+};
+/** The message of whatever was thrown, or `fallback`. */
+export declare function errorText(error: unknown, fallback: string): string;
+//# sourceMappingURL=log.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/opencode/log.ts"],"names":[],"mappings":"AAEA,sGAAsG;AACtG,eAAO,MAAM,WAAW;IACtB,IAAI,YAAY,MAAM,KAAG,IAAI;IAC7B,IAAI,YAAY,MAAM,KAAG,IAAI;IAC7B,KAAK,YAAY,MAAM,KAAG,IAAI;CAC/B,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIlE"}

package/dist/src/opencode/log.js

@@ -0,0 +1,15 @@
+const PREFIX = '[@adonis-agora/agent/opencode]';
+/** The engine's console voice — the same `[package] message` lines the rest of the library writes. */
+export const openCodeLog = {
+    info: (message) => console.info(`${PREFIX} ${message}`),
+    warn: (message) => console.warn(`${PREFIX} ${message}`),
+    error: (message) => console.error(`${PREFIX} ${message}`),
+};
+/** The message of whatever was thrown, or `fallback`. */
+export function errorText(error, fallback) {
+    if (typeof error === 'string' && error.length > 0)
+        return error;
+    const message = error?.message;
+    return typeof message === 'string' && message.length > 0 ? message : fallback;
+}
+//# sourceMappingURL=log.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../../src/opencode/log.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,gCAAgC,CAAC;AAEhD,sGAAsG;AACtG,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,CAAC,OAAe,EAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;IACrE,IAAI,EAAE,CAAC,OAAe,EAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;IACrE,KAAK,EAAE,CAAC,OAAe,EAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;CACxE,CAAC;AAEF,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,QAAgB;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,MAAM,OAAO,GAAI,KAA2C,EAAE,OAAO,CAAC;IACtE,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;AAChF,CAAC"}

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

@@ -0,0 +1,60 @@
+import type { HttpContext } from '@adonisjs/core/http';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { ProtocolAdapter } from '../spi/protocol-adapter.js';
+import type { Actor } from '../types.js';
+import type { OpenCodeTurns } from './turns.js';
+/** What a tools token says: whose turns it may serve, on which OpenCode server, until when. */
+export interface OpenCodeToolsClaims {
+    v: 1;
+    actor: Actor;
+    /** The OpenCode server key (`OpenCodeServer.key`) the token was registered on. */
+    server: string;
+    /** Epoch ms after which the token is refused. */
+    exp: number;
+}
+/**
+ * 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 declare class OpenCodeToolsTokens {
+    private readonly ttlMs;
+    private readonly key;
+    constructor(secret: string | undefined, ttlMs: number);
+    mint(actor: Actor, server: string, now?: number): string;
+    verify(token: string, now?: number): OpenCodeToolsClaims | null;
+    private sign;
+}
+/**
+ * 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 declare class OpenCodeMcpEndpoint {
+    private readonly turns;
+    private readonly tokens;
+    constructor(turns: OpenCodeTurns, tokens: OpenCodeToolsTokens);
+    /** Mounts the endpoint next to the agent's routes. */
+    adapter(): ProtocolAdapter;
+    /** The claims of a request's bearer token, or `null`. */
+    authenticate(authorization: string | undefined): OpenCodeToolsClaims | null;
+    handle(ctx: HttpContext): Promise<void>;
+    /** One MCP server for one request, answering as the token's actor. */
+    server(claims: OpenCodeToolsClaims): Server;
+    private invoke;
+    /** `remember`: one fact, at the actor's own scope only — as the loop serves it. */
+    private remember;
+}
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/opencode/mcp.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAcnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGlE,OAAO,KAAK,EAAE,KAAK,EAAiB,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAuB,aAAa,EAAE,MAAM,YAAY,CAAC;AAErE,+FAA+F;AAC/F,MAAM,WAAW,mBAAmB;IAClC,CAAC,EAAE,CAAC,CAAC;IACL,KAAK,EAAE,KAAK,CAAC;IACb,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;CACb;AAOD;;;;;;;;GAQG;AACH,qBAAa,mBAAmB;IAK5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAE7B,YACE,MAAM,EAAE,MAAM,GAAG,SAAS,EACT,KAAK,EAAE,MAAM,EAM/B;IAED,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,MAAM,CAI3D;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,mBAAmB,GAAG,IAAI,CAuBlE;IAED,OAAO,CAAC,IAAI;CAGb;AAqBD;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFzB,YACmB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,mBAAmB,EAC1C;IAEJ,sDAAsD;IACtD,OAAO,IAAI,eAAe,CAWzB;IAED,yDAAyD;IACzD,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,mBAAmB,GAAG,IAAI,CAK1E;IAEK,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC5C;IAED,sEAAsE;IACtE,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CA2D1C;YAEa,MAAM;IAsCpB,mFAAmF;YACrE,QAAQ;CAuBvB"}