mstro-app 0.5.1 → 0.5.5

package/dist/server/engines/opencode/OpenCodeEngine.d.ts

@@ -0,0 +1,148 @@
+/**
+ * OpenCodeEngine
+ *
+ * Adapter that wraps the OpenCode SDK (@opencode-ai/sdk) behind the
+ * CodingAgentEngine interface. Owns a single OpenCode `session` per Mstro
+ * improvisation:
+ *
+ * - `startSession` creates (or resumes) an OpenCode session and opens an
+ *   SSE subscription to `/event`. A background pump consumes the stream
+ *   and translates each payload into the engine-agnostic `EngineEvent`
+ *   shape so the rest of the system does not need to know which engine
+ *   produced the events.
+ * - `sendPrompt` dispatches `session.promptAsync` and resolves as soon as
+ *   the server has accepted the prompt. Streaming output arrives via SSE.
+ * - `cancel` calls `session.abort`, which the OpenCode server eventually
+ *   reflects back as a `session.idle` event.
+ * - `dispose` stops the pump and deletes the underlying session.
+ *
+ * The concrete SSE → EngineEvent mapping is documented inline in
+ * `handleSseEvent`.
+ */
+import type { OpencodeClient } from '@opencode-ai/sdk';
+import { type BouncerDecision, type EnginePermissionReviewRequest } from '../../mcp/bouncer-integration.js';
+import type { EngineEvent, EngineId } from '../EngineEvent.js';
+import type { CodingAgentEngine, EngineUsage, PromptAttachment, StartSessionOptions } from '../types.js';
+/**
+ * Bouncer entry-point signature. Exposed as an option on OpenCodeEngine so
+ * tests can swap in a stub without patching module internals. Production
+ * code passes `reviewEnginePermission` from bouncer-integration.ts, which
+ * in turn calls {@link reviewOperation} — the single source of truth for
+ * security decisions across every engine.
+ */
+export type ReviewEnginePermissionFn = (request: EnginePermissionReviewRequest) => Promise<BouncerDecision>;
+/** Construction-time dependencies for {@link OpenCodeEngine}. */
+export interface OpenCodeEngineOptions {
+    /**
+     * Typed SDK client, already bound to a running opencode server. Usually
+     * obtained from `OpenCodeServerManager.getClient()`. Tests inject a
+     * hand-rolled mock matching the subset of methods used here.
+     */
+    client: OpencodeClient;
+    /**
+     * Directory query parameter forwarded to each request. OpenCode scopes
+     * sessions and events by directory — the value is typically the same
+     * working directory passed to `startSession`.
+     */
+    directory?: string;
+    /**
+     * Override the bouncer review function. Defaults to
+     * `reviewEnginePermission` from `cli/server/mcp/bouncer-integration.ts`
+     * — which wraps the unified {@link reviewOperation} entry point used by
+     * the Claude MCP path. Tests inject a stub to drive specific decisions.
+     */
+    reviewPermission?: ReviewEnginePermissionFn;
+}
+export declare class OpenCodeEngine implements CodingAgentEngine {
+    readonly engineId: EngineId;
+    private readonly client;
+    private readonly directory;
+    private readonly reviewPermission;
+    private sessionOptions;
+    private openCodeSessionId;
+    /** True once the caller has called `startSession` successfully. */
+    private started;
+    /** Active SSE subscription returned by `client.event.subscribe()`. */
+    private subscription;
+    /** Background task consuming `subscription.stream`. */
+    private pumpPromise;
+    /** In-flight prompt promise — enforces the one-prompt-at-a-time contract. */
+    private currentPromptPromise;
+    private disposed;
+    private iteratorDone;
+    private readonly queue;
+    private readonly pending;
+    /**
+     * Tool-call id → start timestamp. Populated on the first `running`
+     * state of a ToolPart so we can compute `durationMs` when the part
+     * transitions to `completed` or `error`.
+     */
+    private readonly toolStartTimes;
+    /**
+     * Tool-call ids we have already announced via `tool.start`. Prevents
+     * duplicate starts when OpenCode emits multiple `running` updates.
+     */
+    private readonly toolStarted;
+    private usage;
+    constructor(options: OpenCodeEngineOptions);
+    startSession(options: StartSessionOptions): Promise<void>;
+    sendPrompt(prompt: string, _attachments?: PromptAttachment[]): Promise<void>;
+    cancel(): Promise<void>;
+    getUsage(): EngineUsage;
+    dispose(): Promise<void>;
+    [Symbol.asyncIterator](): AsyncIterator<EngineEvent>;
+    private sessionIdForEvent;
+    private emit;
+    private closeIterator;
+    /**
+     * Long-running task that consumes the SSE stream. Exits when the stream
+     * ends naturally (dispose called `stream.return()`) or when an error
+     * propagates out of the generator.
+     */
+    private runEventPump;
+    /**
+     * Core mapping from OpenCode SSE events to EngineEvents.
+     *
+     * - message.part.updated (TextPart)        → message.delta
+     * - message.part.updated (ReasoningPart)   → message.thinking
+     * - message.part.updated (ToolPart running) → tool.start  (once per callID)
+     * - message.part.updated (ToolPart done)    → tool.end
+     * - message.part.updated (StepFinishPart)   → usage.update
+     * - message.updated (AssistantMessage)     → usage.update (if tokens set)
+     * - permission.updated                     → permission.request
+     * - session.idle                           → session.idle
+     * - session.error                          → engine.error
+     *
+     * Events for sessions other than the one we own are ignored so that a
+     * shared server emitting events for multiple clients does not cross
+     * streams.
+     */
+    private handleSseEvent;
+    /**
+     * Route an OpenCode `permission.updated` through the unified Bouncer
+     * and respond to the SDK so the server never hangs waiting.
+     *
+     * Contract:
+     * - Approval (allow / warn_allow) → SDK `{ response: 'once' }`.
+     * - Denial (deny)                 → SDK `{ response: 'reject' }` *and*
+     *   a user-visible `engine.error` carrying the same message the Claude
+     *   MCP path returns on a deny (see `cli/server/mcp/server.ts`), so
+     *   both engines surface denials with identical wording.
+     *
+     * Any error — bouncer failure, SDK failure — is treated as a deny for
+     * safety: we tell OpenCode `reject`, emit an engine.error, and keep the
+     * session alive (non-fatal).
+     */
+    private resolvePermission;
+    private reviewPermissionSafely;
+    private handlePartUpdated;
+    private onTextPart;
+    private onReasoningPart;
+    private onToolPart;
+    private emitToolStartOnce;
+    private emitToolEnd;
+    private onStepFinish;
+    private handleMessageUpdated;
+    private applyTokens;
+}
+//# sourceMappingURL=OpenCodeEngine.d.ts.map

package/dist/server/engines/opencode/OpenCodeEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenCodeEngine.d.ts","sourceRoot":"","sources":["../../../../server/engines/opencode/OpenCodeEngine.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAGV,cAAc,EAQf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAGnC,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,aAAa,CAAA;AAEpB;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,EAAE,6BAA6B,KACnC,OAAO,CAAC,eAAe,CAAC,CAAA;AAc7B,iEAAiE;AACjE,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,MAAM,EAAE,cAAc,CAAA;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,wBAAwB,CAAA;CAC5C;AAqBD,qBAAa,cAAe,YAAW,iBAAiB;IACtD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAa;IAExC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;IAE3D,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,mEAAmE;IACnE,OAAO,CAAC,OAAO,CAAQ;IAEvB,sEAAsE;IACtE,OAAO,CAAC,YAAY,CAAiC;IACrD,uDAAuD;IACvD,OAAO,CAAC,WAAW,CAA6B;IAEhD,6EAA6E;IAC7E,OAAO,CAAC,oBAAoB,CAA6B;IAEzD,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IAEzC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiC;IAChE;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IAErD,OAAO,CAAC,KAAK,CAIZ;gBAEW,OAAO,EAAE,qBAAqB;IASpC,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCzD,UAAU,CACd,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,gBAAgB,EAAE,GAChC,OAAO,CAAC,IAAI,CAAC;IAmCV,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB7B,QAAQ,IAAI,WAAW;IAIjB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC9B,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,WAAW,CAAC;IAyBpD,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,aAAa;IASrB;;;;OAIG;YACW,YAAY;IAsB1B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,cAAc;IAmEtB;;;;;;;;;;;;;;OAcG;YACW,iBAAiB;YA4CjB,sBAAsB;IAyBpC,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,WAAW;CA0CpB"}