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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moxxy (moxxy.ai)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/acp-session.d.ts

@@ -0,0 +1,201 @@
+import type { Readable, Writable } from 'node:stream';
+import { type AgentStepEvent, type AgentStepRequest, type Skill, type ToolDef } from '@moxxy/sdk';
+import { type LiveSession } from '@moxxy/agent-connection-kit';
+import type { AcpAgentSpec } from './agents.js';
+import { type OpenCodeApi } from './opencode-api.js';
+import { type ReadAgentMcpServers, type ReadAgentRules } from './rules.js';
+/** A running ACP agent (`opencode acp`): its stdout, stdin and stderr. */
+export interface AcpConnection {
+    readonly readable: Readable;
+    readonly writable: Writable;
+    readonly stderr?: Readable;
+    /** OpenCode's HTTP API, where it reports its subagents; without it Moxxy sees no background work. */
+    readonly api?: OpenCodeApi;
+    close(): void;
+}
+export type StartAcpAgent = (opts: {
+    readonly cwd: string;
+    readonly env?: Readonly<Record<string, string>>;
+}) => Promise<AcpConnection>;
+export interface AcpSessionSettings {
+    readonly agent: AcpAgentSpec;
+    readonly start: StartAcpAgent;
+    readonly cwd: string;
+    /** The conversation's agent session from an earlier process, to load. */
+    readonly resume?: string;
+    /** How the person's agent runs; without it Moxxy leaves the agent's own rules and the conversation's auto-approve alone. */
+    readonly readRules?: ReadAgentRules;
+    /** The agent's own MCP servers: Moxxy's server of the same name is left to the agent's. */
+    readonly readMcpServers?: ReadAgentMcpServers;
+    /** Every Moxxy tool of the conversation: the agent reads the list as the session opens, and again on a notice. */
+    readonly tools?: ReadonlyArray<ToolDef>;
+    /** The conversation's Moxxy skills: the agent reads those meant for it through one more Moxxy tool. */
+    readonly skills?: ReadonlyArray<Skill>;
+    /** The agent started a turn by itself while no Moxxy turn runs (a background subagent finished); `name` says why, `workId` which work. */
+    readonly onAgentTurn?: (name: string, workId?: string) => void;
+    /** What the agent's background work did, for the conversation to record at once: its list, a subagent's steps and end. */
+    readonly onActivity?: (events: ReadonlyArray<AgentStepEvent>) => void;
+}
+export declare const CLIENT_CAPABILITIES: {
+    readonly fs: {
+        readonly readTextFile: false;
+        readonly writeTextFile: false;
+    };
+    readonly terminal: false;
+};
+/** Moxxy tools the agent lacks, lent over MCP for this turn. */
+export declare function toolsLentTo(agent: AcpAgentSpec, tools: ReadonlyArray<ToolDef>): ToolDef[];
+/**
+ * One running ACP agent with one session for one Moxxy conversation. Every
+ * message the person sends is the next prompt of the same session, so the
+ * agent keeps its context between turns. The agent's notifications, its
+ * permission asks and Moxxy tool calls over MCP are queued together and
+ * handled in order, so the log shows a call before the decision about it.
+ */
+export declare class AcpAgentSession implements LiveSession {
+    readonly settings: AcpSessionSettings;
+    private readonly mcp;
+    private readonly inbox;
+    private client;
+    private connection;
+    /** A replacement agent is loading the session: what it replays is history. */
+    private loading;
+    private alive;
+    private closed;
+    private inTurn;
+    private sessionId;
+    private options;
+    /** The agent mode the person's setup starts in, restored after plan mode. */
+    private ownMode;
+    /** Why the person declined, for the next message when the turn ended first. */
+    private pendingNotes;
+    /** The Moxxy tools the agent is shown: every one of the conversation, the same in every mode. */
+    private listed;
+    /** The Moxxy skills the agent is offered. */
+    private offered;
+    /** Names of the agent's own commands and skills, as it last announced them. */
+    private ownCommands;
+    private commandsHeard;
+    private commandsAwaited;
+    private readonly commandWakers;
+    /** The session is new while the conversation may already have run: its first prompt carries the conversation so far. */
+    private newSession;
+    private stderr;
+    /** No turn has shown the conversation yet how the agent runs. */
+    private fresh;
+    /** The agent's own rules, once read; `null` when it cannot say. */
+    private ownRules;
+    private ownMcpServers;
+    /** This agent was started to ask before what its own rules allow. */
+    private asking;
+    /** Whether Moxxy answers the agent's asks for the person in this turn. */
+    private autoApprove;
+    /** Auto-approve is on because Moxxy turned it on, not because the person chose it. */
+    private adopted;
+    /** The agent can list its sessions, which tells a gone session from a failed load. */
+    private canList;
+    /** A replacement agent could not load the session: the next turn starts the agent again. */
+    private broken;
+    /** OpenCode's events, read while its HTTP API is up. */
+    private watch;
+    /** The subagents OpenCode runs, read from its events. */
+    private readonly helpers;
+    /** Subagents whose start the conversation has seen; the steps of others wait for it. */
+    private readonly shownHelpers;
+    private readonly heldSteps;
+    /** The background work last reported, to report it again only when it changes. */
+    private shownWork;
+    /** OpenCode started a turn by itself and the conversation was asked for one to show it. */
+    private agentTurnPending;
+    /** A turn reads the one OpenCode started by itself. */
+    private readingOwnTurn;
+    /** OpenCode's session works now, as its events last said. */
+    private agentBusy;
+    private settleTimer;
+    /** This turn showed the account limit reached. */
+    private limitShown;
+    static start(settings: AcpSessionSettings): Promise<AcpAgentSession>;
+    private constructor();
+    /** The client for a running agent, its notifications and asks queued for the turn. */
+    private listen;
+    get isAlive(): boolean;
+    /**
+     * The agent lists its commands just after its session opens, maybe after the
+     * turn began: the first turn waits for that list, an agent that never sends
+     * one only briefly.
+     */
+    private hearCommands;
+    /** A Moxxy skill named like one of the agent's own commands or skills is left to the agent's. */
+    private skillsFor;
+    /** Whether this agent was started where the turn runs (a running session cannot move). */
+    fits(settings: Pick<AcpSessionSettings, 'cwd'>): boolean;
+    turn(req: AgentStepRequest): AsyncGenerator<AgentStepEvent>;
+    /** Stop one subagent OpenCode runs in the background (`AgentBackgroundWork.id`); `false` when it runs no such work. */
+    stopWork(workId: string): Promise<boolean>;
+    close(): Promise<void>;
+    /** The agent's own MCP servers that are on, read once. */
+    private mcpServers;
+    /** The rules of the agent the person runs, read once. */
+    private rules;
+    /**
+     * With auto-approve off the agent asks before what its own rules allow:
+     * it is started again with those rules turned into asks (for this process
+     * only, nothing written to its config) and loads the same session. Once
+     * started so it stays, and Moxxy answers its asks while auto-approve is on.
+     */
+    private askFromNowOn;
+    private open;
+    /**
+     * Whether a session the agent failed to load no longer exists. OpenCode 1.18
+     * answers a missing session as it answers a failure ("OpenCode service
+     * failure"), so its session list decides; an agent that can say neither
+     * keeps the session as existing, and nothing replaces it.
+     */
+    private sessionGone;
+    /** How full OpenCode's context is (`used`) and the window it runs the turn's model with (`size`), from its `usage_update`. */
+    private contextOf;
+    /** Model, effort and mode for this turn, changed on the session only where they differ. */
+    private configure;
+    private option;
+    private set;
+    /** One prompt, read until the agent answers it. False when the turn is over without it (stopped, failed). */
+    private prompt;
+    /** What the agent asked of Moxxy, answered with the turn's host. */
+    private answer;
+    /**
+     * A turn OpenCode started by itself: a background subagent finished and
+     * OpenCode prompted its session with the result. It is read until OpenCode's
+     * session is idle again; its asks and Moxxy tool calls are answered as in any turn.
+     */
+    private ownTurn;
+    /** One ACP update of the conversation's session as agent events. */
+    private shown;
+    /** The events, each subagent's start followed by the steps it took before the conversation saw it start. */
+    private withHeldSteps;
+    /** Start reading the events of the OpenCode in use, when it serves its HTTP API. */
+    private watchEvents;
+    /** Stop reading OpenCode's events: its subagents end with it. */
+    private unwatch;
+    private onEvent;
+    /**
+     * A subagent's step: in the turn that waits for it, or recorded at once for
+     * one working in the background. A step of a subagent whose start the
+     * conversation has not seen waits for it.
+     */
+    private deliver;
+    /** Whether an ACP update outside any turn shows the agent at work in the conversation's session. */
+    private startsOwnTurn;
+    private askForTurn;
+    /** The turn OpenCode started by itself is over once its session is idle and ACP has been quiet a moment. */
+    private settleSoon;
+    private clearSettle;
+    /** What OpenCode runs in the background now; reported when it changes. */
+    private reportWork;
+    private report;
+    private failureMessage;
+    private ended;
+    private endedMessage;
+    /** Answer whatever is still queued once no turn can: the agent must never wait on Moxxy forever. */
+    private dismissQueued;
+}
+//# sourceMappingURL=acp-session.d.ts.map

package/dist/acp-session.d.ts.map

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