@moxxy/plugin-provider-acp 0.0.0-stage → 0.46.0

package/dist/opencode-helpers.d.ts

@@ -0,0 +1,49 @@
+import type { AgentBackgroundWork, AgentStepEvent } from '@moxxy/sdk';
+import type { OpenCodeEvent } from './opencode-api.js';
+/** What one OpenCode event meant for the conversation. */
+export interface HelperNews {
+    /** What subagents did: their tools, what they said, how they ended. */
+    readonly steps: AgentStepEvent[];
+    /** The background work list changed. */
+    readonly workChanged: boolean;
+    /** OpenCode prompted the conversation's session itself with a background subagent's result: it starts a turn of its own. */
+    readonly finished?: {
+        readonly workId: string;
+        readonly label: string;
+        readonly failed: boolean;
+    };
+    /** The conversation's session started or stopped working. */
+    readonly status?: 'busy' | 'idle';
+    /** OpenCode waits for the person's account limit (its free tier, its Go plan) to reset before it tries again. */
+    readonly limitReached?: true;
+}
+/**
+ * The subagents OpenCode runs in one conversation's session, read from its
+ * HTTP API's events: ACP reports a `task` call and its answer, not what the
+ * subagent does, nor the end of one working in the background (OpenCode 1.19,
+ * `task` with `background: true`). Each subagent works in a session of its
+ * own, named by the conversation's `task` tool part.
+ */
+export declare class OpenCodeHelpers {
+    private readonly parent;
+    /** By the subagent's session id. */
+    private readonly helpers;
+    private readonly early;
+    constructor(parent: () => string);
+    take(event: OpenCodeEvent): HelperNews;
+    /** What runs in the background now. */
+    running(): AgentBackgroundWork[];
+    /** Whether the subagent of the `task` call `callId` works in the background. */
+    inBackground(callId: string): boolean;
+    /** The session of the background subagent `workId` that still works, marked as being stopped by the person. */
+    stop(workId: string): string | undefined;
+    /** Stopping it failed: its end is reported as it comes. */
+    unstop(workId: string): void;
+    /** The OpenCode running them is gone, and they with it. */
+    clear(): void;
+    private fromParent;
+    /** The conversation's `task` call names its subagent's session once it runs. */
+    private named;
+    private fromHelper;
+}
+//# sourceMappingURL=opencode-helpers.d.ts.map

package/dist/opencode-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-helpers.d.ts","sourceRoot":"","sources":["../src/opencode-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC;IACjC,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,4HAA4H;IAC5H,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAClG,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,iHAAiH;IACjH,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC;CAC9B;AA2BD;;;;;;GAMG;AACH,qBAAa,eAAe;IAKd,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;gBAE/B,MAAM,EAAE,MAAM,MAAM;IAEjD,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU;IAkBtC,uCAAuC;IACvC,OAAO,IAAI,mBAAmB,EAAE;IAIhC,gFAAgF;IAChF,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKrC,+GAA+G;IAC/G,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IASxC,2DAA2D;IAC3D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5B,2DAA2D;IAC3D,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,UAAU;IAiBlB,gFAAgF;IAChF,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,UAAU;CAuCnB"}

package/dist/opencode-helpers.js

@@ -0,0 +1,175 @@
+import { shownCall } from './translate.js';
+/** Events of a subagent session OpenCode reported before the `task` call naming it; kept until it does. */
+const MAX_EARLY_EVENTS = 64;
+const TASK_TOOL = 'task';
+const ABORTED = 'MessageAbortedError';
+const TASK_RESULT = /^<task id="([^"]+)" state="([a-z]+)">/;
+/** Why OpenCode 1.19 retries when an account limit, not the provider, holds it up. */
+const LIMIT_REASONS = new Set(['free_tier_limit', 'account_rate_limit']);
+const quiet = { steps: [], workChanged: false };
+/**
+ * The subagents OpenCode runs in one conversation's session, read from its
+ * HTTP API's events: ACP reports a `task` call and its answer, not what the
+ * subagent does, nor the end of one working in the background (OpenCode 1.19,
+ * `task` with `background: true`). Each subagent works in a session of its
+ * own, named by the conversation's `task` tool part.
+ */
+export class OpenCodeHelpers {
+    parent;
+    /** By the subagent's session id. */
+    helpers = new Map();
+    early = new Map();
+    constructor(parent) {
+        this.parent = parent;
+    }
+    take(event) {
+        const session = sessionOf(event);
+        if (!session)
+            return quiet;
+        if (session === this.parent())
+            return this.fromParent(event);
+        if (event.type === 'session.created') {
+            const info = record(event.properties.info);
+            if (info.parentID === this.parent() && !this.helpers.has(session))
+                this.early.set(session, []);
+            return quiet;
+        }
+        const helper = this.helpers.get(session);
+        if (!helper) {
+            const kept = this.early.get(session);
+            if (kept && kept.length < MAX_EARLY_EVENTS)
+                kept.push(event);
+            return quiet;
+        }
+        return this.fromHelper(helper, event);
+    }
+    /** What runs in the background now. */
+    running() {
+        return [...this.helpers.values()].flatMap((helper) => (helper.background && !helper.done ? [{ id: helper.callId, kind: 'agent', label: helper.label }] : []));
+    }
+    /** Whether the subagent of the `task` call `callId` works in the background. */
+    inBackground(callId) {
+        for (const helper of this.helpers.values())
+            if (helper.callId === callId)
+                return helper.background;
+        return false;
+    }
+    /** The session of the background subagent `workId` that still works, marked as being stopped by the person. */
+    stop(workId) {
+        for (const [session, helper] of this.helpers) {
+            if (helper.callId !== workId || !helper.background || helper.done)
+                continue;
+            helper.stopping = true;
+            return session;
+        }
+        return undefined;
+    }
+    /** Stopping it failed: its end is reported as it comes. */
+    unstop(workId) {
+        for (const helper of this.helpers.values())
+            if (helper.callId === workId)
+                helper.stopping = false;
+    }
+    /** The OpenCode running them is gone, and they with it. */
+    clear() {
+        this.helpers.clear();
+        this.early.clear();
+    }
+    fromParent(event) {
+        if (event.type === 'session.status') {
+            const status = record(event.properties.status);
+            if (status.type === 'retry')
+                return { ...quiet, status: 'busy', ...(LIMIT_REASONS.has(String(record(status.action).reason)) ? { limitReached: true } : {}) };
+            return status.type === 'idle' || status.type === 'busy' ? { ...quiet, status: status.type } : quiet;
+        }
+        if (event.type !== 'message.part.updated')
+            return quiet;
+        const part = record(event.properties.part);
+        if (part.type === 'tool' && part.tool === TASK_TOOL && typeof part.callID === 'string')
+            return this.named(part.callID, record(part.state));
+        if (part.type === 'text' && part.synthetic === true && typeof part.text === 'string') {
+            const result = TASK_RESULT.exec(part.text);
+            const helper = result?.[1] ? this.helpers.get(result[1]) : undefined;
+            if (helper?.background)
+                return { ...quiet, finished: { workId: helper.callId, label: helper.label, failed: result?.[2] !== 'completed' } };
+        }
+        return quiet;
+    }
+    /** The conversation's `task` call names its subagent's session once it runs. */
+    named(callId, state) {
+        const metadata = record(state.metadata);
+        const session = typeof metadata.sessionId === 'string' ? metadata.sessionId : undefined;
+        if (!session || this.helpers.has(session))
+            return quiet;
+        const input = record(state.input);
+        const label = text(input.description) ?? text(state.title) ?? 'subagent';
+        const background = metadata.background === true || input.background === true;
+        const helper = { callId, label, background, said: '', error: undefined, stopping: false, done: false, shownTools: new Set(), shownTexts: new Set() };
+        this.helpers.set(session, helper);
+        const early = this.early.get(session) ?? [];
+        this.early.delete(session);
+        const steps = early.flatMap((event) => this.fromHelper(helper, event).steps);
+        return { ...quiet, steps, workChanged: background };
+    }
+    fromHelper(helper, event) {
+        if (helper.done)
+            return quiet;
+        if (event.type === 'session.error') {
+            const error = record(event.properties.error);
+            if (error.name === ABORTED)
+                helper.stopping = true;
+            else
+                helper.error = text(record(error.data).message) ?? text(error.name) ?? 'the subagent failed';
+            return quiet;
+        }
+        if (event.type === 'session.status') {
+            // A subagent the turn waits for ends with its `task` call, which ACP reports.
+            if (record(event.properties.status).type !== 'idle' || !helper.background)
+                return quiet;
+            helper.done = true;
+            const end = helper.stopping
+                ? { type: 'subagent_completed', id: helper.callId, text: helper.said, stopped: true }
+                : { type: 'subagent_completed', id: helper.callId, text: helper.said, ...(helper.error ? { error: helper.error } : {}) };
+            return { ...quiet, steps: [end], workChanged: true };
+        }
+        if (event.type !== 'message.part.updated')
+            return quiet;
+        const part = record(event.properties.part);
+        const partId = text(part.id);
+        if (!partId)
+            return quiet;
+        if (part.type === 'tool' && typeof part.tool === 'string') {
+            const state = record(part.state);
+            const input = record(state.input);
+            if (helper.shownTools.has(partId) || state.status === 'pending' || Object.keys(input).length === 0)
+                return quiet;
+            helper.shownTools.add(partId);
+            const shown = shownCall(part.tool, undefined, input);
+            return { ...quiet, steps: [{ type: 'subagent_tool_call', id: helper.callId, name: shown.name, input: shown.input }] };
+        }
+        // What the subagent said, once a part of it is finished; its task, the first message of its session, has no time.
+        if (part.type === 'text' && part.synthetic !== true && record(part.time).end !== undefined) {
+            const said = text(part.text)?.trim();
+            if (!said || helper.shownTexts.has(partId))
+                return quiet;
+            helper.shownTexts.add(partId);
+            helper.said = said;
+            return { ...quiet, steps: [{ type: 'subagent_message', id: helper.callId, text: said }] };
+        }
+        return quiet;
+    }
+}
+function sessionOf(event) {
+    const { sessionID } = event.properties;
+    if (typeof sessionID === 'string')
+        return sessionID;
+    const fromPart = record(event.properties.part).sessionID;
+    return typeof fromPart === 'string' ? fromPart : undefined;
+}
+function record(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : {};
+}
+function text(value) {
+    return typeof value === 'string' && value ? value : undefined;
+}
+//# sourceMappingURL=opencode-helpers.js.map

package/dist/opencode-helpers.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,143 @@
+/**
+ * The part of the Agent Client Protocol (ACP, protocol version 1) Moxxy
+ * speaks, written by hand from recorded `opencode acp` 1.18.35 sessions.
+ * Agents send more than this; anything not listed here is left alone.
+ */
+export declare const ACP_PROTOCOL_VERSION = 1;
+export interface AcpSelectOption {
+    readonly value: string;
+    readonly name?: string;
+}
+/** A session setting the agent offers (`model`, `mode`, `effort`), changed with `session/set_config_option`. */
+export interface AcpConfigOption {
+    readonly id: string;
+    readonly name?: string;
+    /** `model`, `mode`, `thought_level`, … */
+    readonly category?: string;
+    readonly type: string;
+    readonly currentValue: string;
+    readonly options?: ReadonlyArray<AcpSelectOption>;
+}
+/** What `initialize` answers, as far as Moxxy reads it. */
+export interface AcpInitializeResponse {
+    readonly agentCapabilities?: {
+        readonly sessionCapabilities?: {
+            readonly list?: object;
+        };
+    };
+}
+/** One page of `session/list`. */
+export interface AcpSessionList {
+    readonly sessions: ReadonlyArray<{
+        readonly sessionId: string;
+        readonly cwd?: string;
+    }>;
+    readonly nextCursor?: string;
+}
+export interface AcpSessionResponse {
+    readonly sessionId?: string;
+    readonly configOptions?: ReadonlyArray<AcpConfigOption>;
+}
+export type AcpStopReason = 'end_turn' | 'max_tokens' | 'max_turn_requests' | 'refusal' | 'cancelled';
+export interface AcpUsage {
+    /** Prompt tokens not served from the cache. */
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    readonly thoughtTokens?: number;
+    readonly cachedReadTokens?: number;
+    readonly cachedWriteTokens?: number;
+    readonly totalTokens?: number;
+}
+export interface AcpPromptResponse {
+    readonly stopReason: AcpStopReason;
+    readonly usage?: AcpUsage;
+}
+export type AcpContentBlock = {
+    readonly type: 'text';
+    readonly text: string;
+} | {
+    readonly type: 'image';
+    readonly mimeType: string;
+    readonly data: string;
+} | {
+    readonly type: 'resource';
+    readonly resource: {
+        readonly uri: string;
+        readonly mimeType?: string;
+        readonly text?: string;
+        readonly blob?: string;
+    };
+};
+export type AcpToolKind = 'read' | 'edit' | 'delete' | 'move' | 'search' | 'execute' | 'think' | 'fetch' | 'switch_mode' | 'other';
+export type AcpToolStatus = 'pending' | 'in_progress' | 'completed' | 'failed';
+export type AcpToolCallContent = {
+    readonly type: 'content';
+    readonly content: {
+        readonly type: string;
+        readonly text?: string;
+    };
+} | {
+    readonly type: 'diff';
+    readonly path: string;
+    readonly oldText?: string | null;
+    readonly newText: string;
+} | {
+    readonly type: 'terminal';
+    readonly terminalId: string;
+};
+/** A `tool_call` or `tool_call_update`: each update carries only what changed. */
+export interface AcpToolCall {
+    readonly toolCallId: string;
+    readonly title?: string;
+    readonly kind?: AcpToolKind;
+    readonly status?: AcpToolStatus;
+    readonly rawInput?: unknown;
+    readonly rawOutput?: unknown;
+    readonly content?: ReadonlyArray<AcpToolCallContent>;
+    readonly locations?: ReadonlyArray<{
+        readonly path: string;
+    }>;
+}
+export type AcpSessionUpdate = {
+    readonly sessionUpdate: 'agent_message_chunk';
+    readonly messageId?: string;
+    readonly content: {
+        readonly type: string;
+        readonly text?: string;
+    };
+} | {
+    readonly sessionUpdate: 'agent_thought_chunk';
+    readonly messageId?: string;
+    readonly content: {
+        readonly type: string;
+        readonly text?: string;
+    };
+} | ({
+    readonly sessionUpdate: 'tool_call';
+} & AcpToolCall) | ({
+    readonly sessionUpdate: 'tool_call_update';
+} & AcpToolCall) | {
+    readonly sessionUpdate: string;
+    readonly [key: string]: unknown;
+};
+export type AcpPermissionOptionKind = 'allow_once' | 'allow_always' | 'reject_once' | 'reject_always';
+export interface AcpPermissionRequest {
+    readonly sessionId: string;
+    readonly toolCall: AcpToolCall;
+    readonly options: ReadonlyArray<{
+        readonly optionId: string;
+        readonly kind: AcpPermissionOptionKind;
+        readonly name?: string;
+    }>;
+}
+export type AcpPermissionOutcome = {
+    readonly outcome: {
+        readonly outcome: 'selected';
+        readonly optionId: string;
+    };
+} | {
+    readonly outcome: {
+        readonly outcome: 'cancelled';
+    };
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1,7 @@
+/**
+ * The part of the Agent Client Protocol (ACP, protocol version 1) Moxxy
+ * speaks, written by hand from recorded `opencode acp` 1.18.35 sessions.
+ * Agents send more than this; anything not listed here is left alone.
+ */
+export const ACP_PROTOCOL_VERSION = 1;
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC"}

package/dist/rules.d.ts

@@ -0,0 +1,47 @@
+/**
+ * OpenCode's permission rules, as `opencode debug agent <name>` reports them:
+ * an ordered list in which the last rule matching a permission and input wins.
+ */
+export interface OpenCodeRule {
+    readonly permission: string;
+    readonly pattern: string;
+    readonly action: 'allow' | 'ask' | 'deny';
+}
+type Action = OpenCodeRule['action'];
+/** Reads the rules of one of the person's OpenCode agents; `undefined` when OpenCode cannot say. */
+export type ReadAgentRules = (opts: {
+    readonly cwd: string;
+    readonly agent: string;
+}) => Promise<ReadonlyArray<OpenCodeRule> | undefined>;
+/** Reads the names of the person's own MCP servers that are on; `undefined` when the agent cannot say. */
+export type ReadAgentMcpServers = (opts: {
+    readonly cwd: string;
+}) => Promise<ReadonlyArray<string> | undefined>;
+/** Whether OpenCode edits files and runs commands without asking anyone. */
+export declare function runsWithoutAsking(rules: ReadonlyArray<OpenCodeRule>): boolean;
+/**
+ * Whether the person's own OpenCode runs without asking in `cwd`, from its
+ * default `build` agent's rules; `undefined` when OpenCode cannot be asked.
+ */
+export declare function openCodeOwnAutoApprove(cwd: string, readRules: ReadAgentRules): Promise<boolean | undefined>;
+/**
+ * The permission config that makes OpenCode ask before what it would do on its
+ * own. Each permission's rules are repeated in their order with every allow
+ * turned into an ask, so what the person denied stays denied. Given as the
+ * agent's own permissions, they come after every other rule and win.
+ */
+export declare function askingRules(rules: ReadonlyArray<OpenCodeRule>): Record<string, Action | Record<string, Action>>;
+/**
+ * `OPENCODE_CONFIG_CONTENT` for an OpenCode that asks: the agent's permissions,
+ * nothing written to disk. Inline config the person already passes is kept;
+ * its rules are already among those read, so this agent's permissions replace them.
+ */
+export declare function askingConfig(agent: string, rules: ReadonlyArray<OpenCodeRule>, inline?: string): string;
+/**
+ * Whether an ask is OpenCode's `external_directory`, which it puts to the
+ * person even on its defaults: about a file it names the parent folder
+ * (`parentDir`), about a command the folders (`directories`).
+ */
+export declare function asksOutsideProject(rawInput: unknown): boolean;
+export {};
+//# sourceMappingURL=rules.d.ts.map

package/dist/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;CAC3C;AAED,KAAK,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;AAErC,oGAAoG;AACpG,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,CAAC;AAE1I,0GAA0G;AAC1G,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC;AAOjH,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,OAAO,CAE7E;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAGjH;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAe/G;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAUvG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAI7D"}

package/dist/rules.js

@@ -0,0 +1,84 @@
+/** Permissions whose rules take an input pattern (a command, a path). */
+const PATTERNED = ['edit', 'bash'];
+/** Permissions with one action for every input. */
+const UNPATTERNED = ['webfetch', 'websearch'];
+/** Whether OpenCode edits files and runs commands without asking anyone. */
+export function runsWithoutAsking(rules) {
+    return PATTERNED.every((permission) => anyInput(rules, permission) === 'allow');
+}
+/**
+ * Whether the person's own OpenCode runs without asking in `cwd`, from its
+ * default `build` agent's rules; `undefined` when OpenCode cannot be asked.
+ */
+export async function openCodeOwnAutoApprove(cwd, readRules) {
+    const rules = await readRules({ cwd, agent: 'build' }).catch(() => undefined);
+    return rules ? runsWithoutAsking(rules) : undefined;
+}
+/**
+ * The permission config that makes OpenCode ask before what it would do on its
+ * own. Each permission's rules are repeated in their order with every allow
+ * turned into an ask, so what the person denied stays denied. Given as the
+ * agent's own permissions, they come after every other rule and win.
+ */
+export function askingRules(rules) {
+    const config = {};
+    for (const permission of PATTERNED) {
+        const patterns = new Map();
+        for (const rule of rules) {
+            if (rule.permission !== permission && !(rule.pattern === '*' && matches(rule.permission, permission)))
+                continue;
+            // An earlier rule for the same pattern never wins over this one.
+            patterns.delete(rule.pattern);
+            patterns.set(rule.pattern, asked(rule.action));
+        }
+        if (!patterns.has('*'))
+            patterns.set('*', 'ask');
+        config[permission] = Object.fromEntries(patterns);
+    }
+    for (const permission of UNPATTERNED)
+        config[permission] = asked(anyInput(rules, permission) ?? 'allow');
+    return config;
+}
+/**
+ * `OPENCODE_CONFIG_CONTENT` for an OpenCode that asks: the agent's permissions,
+ * nothing written to disk. Inline config the person already passes is kept;
+ * its rules are already among those read, so this agent's permissions replace them.
+ */
+export function askingConfig(agent, rules, inline) {
+    let config = {};
+    try {
+        const parsed = inline ? JSON.parse(inline) : {};
+        if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed))
+            config = parsed;
+    }
+    catch {
+        // OpenCode skips inline config it cannot read; so does Moxxy.
+    }
+    const agents = config.agent ?? {};
+    return JSON.stringify({ ...config, agent: { ...agents, [agent]: { ...agents[agent], permission: askingRules(rules) } } });
+}
+/**
+ * Whether an ask is OpenCode's `external_directory`, which it puts to the
+ * person even on its defaults: about a file it names the parent folder
+ * (`parentDir`), about a command the folders (`directories`).
+ */
+export function asksOutsideProject(rawInput) {
+    if (typeof rawInput !== 'object' || rawInput === null)
+        return false;
+    const input = rawInput;
+    return typeof input.parentDir === 'string' || Array.isArray(input.directories);
+}
+/** The action for an input no narrower rule names. */
+function anyInput(rules, permission) {
+    return rules.findLast((rule) => rule.pattern === '*' && matches(rule.permission, permission))?.action;
+}
+function asked(action) {
+    return action === 'allow' ? 'ask' : action;
+}
+function matches(pattern, name) {
+    if (!pattern.includes('*'))
+        return pattern === name;
+    const source = pattern.split('*').map((part) => part.replace(/[.+?^${}()|[\]\\]/g, '\\$&')).join('.*');
+    return new RegExp(`^${source}$`).test(name);
+}
+//# sourceMappingURL=rules.js.map

package/dist/rules.js.map

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

package/dist/translate.d.ts

@@ -0,0 +1,50 @@
+import type { AgentStepEvent, ContentBlock, TokenUsage } from '@moxxy/sdk';
+import type { AcpContentBlock, AcpSessionUpdate, AcpToolCall, AcpToolKind, AcpUsage } from './protocol.js';
+/** A tool the agent runs itself, as Moxxy names it (`Bash`, `Read`, … so Moxxy's rules and formatting apply). */
+export interface AcpShownCall {
+    readonly name: string;
+    readonly input: unknown;
+}
+/**
+ * One agent prompt's `session/update` notifications as Moxxy agent events.
+ * ACP announces a tool before its input is known (a `pending` `tool_call`
+ * with no or partial `rawInput`, OpenCode's command with its folder only, then
+ * an `in_progress` update with the input), so a call is shown once it starts. Calls to Moxxy's own tools (`moxxy_*` for OpenCode) are left
+ * out: Moxxy records those when it runs them.
+ */
+export declare class AcpTurnTranslator {
+    private readonly moxxyToolPrefix;
+    private readonly cwd;
+    private readonly calls;
+    private text;
+    private thought;
+    /** Plans the agent reported this prompt; each is shown as a call of its own. */
+    private plans;
+    private readonly planPrefix;
+    /** `cwd`: the project folder, which the paths of file diffs are shown relative to. */
+    constructor(moxxyToolPrefix: string, cwd?: string);
+    update(update: AcpSessionUpdate): AgentStepEvent[];
+    /** The prompt ended: what the agent said last is its final message. */
+    finish(): AgentStepEvent[];
+    /** The call a permission ask is about, shown first if it is not yet. */
+    callFor(toolCall: AcpToolCall): {
+        readonly call: AcpShownCall;
+        readonly events: AgentStepEvent[];
+    };
+    /** Close the calls still open (the prompt ended without their result). */
+    openCalls(): string[];
+    private toolCall;
+    /** An ACP agent's plan (`entries` of `{ content, status }`), whole each time, shown as a call of its own. */
+    private plan;
+    private show;
+    private isMoxxyTool;
+    private flushText;
+    private flushThought;
+}
+/** The agent's tool under the name Moxxy knows it by, with Moxxy's input keys. */
+export declare function shownCall(tool: string, kind: AcpToolKind | undefined, input: Record<string, unknown>): AcpShownCall;
+export declare function toTokenUsage(usage: AcpUsage): TokenUsage;
+/** The person's message as ACP content: text, images, and documents as embedded resources. */
+export declare function toAcpPrompt(prompt: ReadonlyArray<ContentBlock>): AcpContentBlock[];
+export declare function promptText(prompt: ReadonlyArray<ContentBlock>): string;
+//# sourceMappingURL=translate.d.ts.map

package/dist/translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../src/translate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAmB,UAAU,EAAa,MAAM,YAAY,CAAC;AAEvG,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE3G,iHAAiH;AACjH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAWD;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAU1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAVtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,OAAO,CAAM;IACrB,gFAAgF;IAChF,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IAEvD,sFAAsF;gBAEnE,eAAe,EAAE,MAAM,EACvB,GAAG,SAAK;IAG3B,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,EAAE;IA2BlD,uEAAuE;IACvE,MAAM,IAAI,cAAc,EAAE;IAI1B,wEAAwE;IACxE,OAAO,CAAC,QAAQ,EAAE,WAAW,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,CAAA;KAAE;IAWlG,0EAA0E;IAC1E,SAAS,IAAI,MAAM,EAAE;IAIrB,OAAO,CAAC,QAAQ;IAsDhB,6GAA6G;IAC7G,OAAO,CAAC,IAAI;IAeZ,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,YAAY;CAKrB;AAsBD,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAuCnH;AAiDD,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,CAOxD;AAED,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,eAAe,EAAE,CAUlF;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,MAAM,CAEtE"}