mstro-app 0.5.0 → 0.5.5

package/dist/server/engines/EngineEvent.d.ts

@@ -0,0 +1,126 @@
+/**
+ * EngineEvent — the engine-agnostic event stream produced by every
+ * CodingAgentEngine (see ./types.ts).
+ *
+ * Contract:
+ * - Every event has a `kind` discriminator, a `sessionId` (the engine's own
+ *   session identifier — Claude Code session id, OpenCode session id, etc.),
+ *   and a `timestamp` in Unix ms.
+ * - Payloads must carry enough information to populate OutputLine in the web
+ *   client without the consumer knowing which engine produced them. Do not
+ *   leak engine-specific fields (e.g. Claude tool_use_ids, OpenCode part ids)
+ *   through typed event fields — keep them in `raw` when needed for debugging.
+ * - Ordering is guaranteed within a single session: for a given tool call,
+ *   `tool.start` precedes `tool.end`; `usage.update` values are monotonic.
+ * - `session.idle` marks the end of a turn (assistant finished responding),
+ *   not the end of the session. Multiple idle events per session are normal.
+ * - `engine.error` with `fatal: true` is terminal — the async iterator must
+ *   complete after emitting it.
+ */
+/** Identifier for which concrete engine produced an event. */
+export type EngineId = 'claude-code' | 'opencode';
+/** Fields shared by every engine event. */
+interface EngineEventBase {
+    /** Engine-reported session id (e.g. Claude Code session id, OpenCode session id). */
+    sessionId: string;
+    /** Unix epoch milliseconds when the engine observed this event. */
+    timestamp: number;
+    /** Optional raw payload from the engine for debugging/audit. Must not be used for business logic. */
+    raw?: unknown;
+}
+/** Streaming assistant text (user-visible output). */
+export interface MessageDeltaEvent extends EngineEventBase {
+    kind: 'message.delta';
+    /** Incremental chunk of assistant-visible text. Consumers concatenate. */
+    text: string;
+}
+/** Streaming assistant thinking/reasoning text (collapsed by default in UI). */
+export interface MessageThinkingEvent extends EngineEventBase {
+    kind: 'message.thinking';
+    /** Incremental chunk of thinking text. */
+    text: string;
+}
+/** A tool invocation has started. */
+export interface ToolStartEvent extends EngineEventBase {
+    kind: 'tool.start';
+    /** Engine-agnostic tool call id (unique within the session). */
+    toolCallId: string;
+    /** Name of the tool (e.g. "Read", "Bash"). */
+    toolName: string;
+    /**
+     * Arguments passed to the tool. May be partial at start — some engines
+     * stream arguments. Consumers should treat this as best-effort until
+     * `tool.end` arrives with the authoritative input.
+     */
+    input: Record<string, unknown>;
+}
+/** A tool invocation has completed (successfully or with an error). */
+export interface ToolEndEvent extends EngineEventBase {
+    kind: 'tool.end';
+    toolCallId: string;
+    toolName: string;
+    /** Authoritative tool input as executed. */
+    input: Record<string, unknown>;
+    /** Serialized tool result (stdout, file contents, JSON, etc.). */
+    result: string;
+    /** True if the tool returned an error. */
+    isError: boolean;
+    /** Wall-clock duration in ms between tool.start and tool.end. */
+    durationMs: number;
+}
+/**
+ * The engine is asking whether a tool call should proceed. Consumed by
+ * the Bouncer in Epic 4 which must resolve the request via the engine's
+ * matching permission-response channel.
+ */
+export interface PermissionRequestEvent extends EngineEventBase {
+    kind: 'permission.request';
+    /** Opaque id the engine will expect echoed back in a decision. */
+    requestId: string;
+    toolName: string;
+    /** Tool arguments to be classified. */
+    input: Record<string, unknown>;
+    /** Engine-provided reason string, if any. */
+    reason?: string;
+}
+/**
+ * Session returned to idle — the assistant finished its current turn.
+ * Not the end of the session; a new prompt may still be sent.
+ */
+export interface SessionIdleEvent extends EngineEventBase {
+    kind: 'session.idle';
+    /** Engine's stop reason if known (e.g. 'end_turn', 'max_tokens'). */
+    stopReason?: string;
+}
+/**
+ * Running token counts. Values are cumulative across the session
+ * (not per-turn) and must be monotonically non-decreasing.
+ */
+export interface UsageUpdateEvent extends EngineEventBase {
+    kind: 'usage.update';
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens?: number;
+    cacheReadTokens?: number;
+}
+/**
+ * An engine-level error occurred. With `fatal: true`, the session is
+ * unrecoverable and the async iterator completes after this event.
+ */
+export interface EngineErrorEvent extends EngineEventBase {
+    kind: 'engine.error';
+    /** Short error code for UI mapping (see ClaudeErrorCode in web/src/types/output.ts). */
+    code: string;
+    /** Human-readable message. */
+    message: string;
+    /** True if the session is unrecoverable and should be torn down. */
+    fatal: boolean;
+}
+/** Discriminated union of every event a CodingAgentEngine may emit. */
+export type EngineEvent = MessageDeltaEvent | MessageThinkingEvent | ToolStartEvent | ToolEndEvent | PermissionRequestEvent | SessionIdleEvent | UsageUpdateEvent | EngineErrorEvent;
+/** Narrow helper — returns true for events that carry user-visible text. */
+export declare function isMessageEvent(event: EngineEvent): event is MessageDeltaEvent | MessageThinkingEvent;
+/** Narrow helper — returns true for the tool lifecycle events. */
+export declare function isToolEvent(event: EngineEvent): event is ToolStartEvent | ToolEndEvent;
+export {};
+//# sourceMappingURL=EngineEvent.d.ts.map

package/dist/server/engines/EngineEvent.d.ts.map

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

package/dist/server/engines/EngineEvent.js

@@ -0,0 +1,11 @@
+// Copyright (c) 2025-present Mstro, Inc. All rights reserved.
+// Licensed under the MIT License. See LICENSE file for details.
+/** Narrow helper — returns true for events that carry user-visible text. */
+export function isMessageEvent(event) {
+    return event.kind === 'message.delta' || event.kind === 'message.thinking';
+}
+/** Narrow helper — returns true for the tool lifecycle events. */
+export function isToolEvent(event) {
+    return event.kind === 'tool.start' || event.kind === 'tool.end';
+}
+//# sourceMappingURL=EngineEvent.js.map

package/dist/server/engines/EngineEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EngineEvent.js","sourceRoot":"","sources":["../../../server/engines/EngineEvent.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,gEAAgE;AA8IhE,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAC5B,KAAkB;IAElB,OAAO,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,CAAC;AAC7E,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,WAAW,CACzB,KAAkB;IAElB,OAAO,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;AAClE,CAAC"}

package/dist/server/engines/claude/ClaudeCodeEngine.d.ts

@@ -0,0 +1,47 @@
+import type { EngineEvent, EngineId } from '../EngineEvent.js';
+import type { CodingAgentEngine, EngineUsage, PromptAttachment, StartSessionOptions } from '../types.js';
+/**
+ * Implementation of CodingAgentEngine backed by the Claude Code headless
+ * runner. The engine holds a single logical conversation — subsequent
+ * prompts automatically continue the Claude session via --resume.
+ */
+export declare class ClaudeCodeEngine implements CodingAgentEngine {
+    readonly engineId: EngineId;
+    private sessionOptions;
+    private claudeSessionId;
+    /**
+     * Live child processes spawned by the current prompt. Keyed by pid; values
+     * are the raw ChildProcess handles. executeClaudeCommand registers the
+     * spawned process here and removes it on 'close'. cancel() iterates this
+     * map and SIGTERMs each process group — matching the pre-engine behavior
+     * from HeadlessRunner.cleanup().
+     */
+    private readonly runningProcesses;
+    private currentRunPromise;
+    private disposed;
+    private iteratorDone;
+    private readonly queue;
+    private readonly pending;
+    private usage;
+    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;
+    /**
+     * SIGTERM every tracked child process group; schedule a SIGKILL fallback
+     * for any that haven't exited in 5s. Mirrors HeadlessRunner.cleanup().
+     */
+    private killAllRunningProcesses;
+    private emit;
+    private closeIterator;
+    private onRunCompleted;
+    private onRunFailed;
+    private handleToolUseEvent;
+    private onToolStart;
+    private onToolComplete;
+    private onToolResult;
+}
+//# sourceMappingURL=ClaudeCodeEngine.d.ts.map

package/dist/server/engines/claude/ClaudeCodeEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeCodeEngine.d.ts","sourceRoot":"","sources":["../../../../server/engines/claude/ClaudeCodeEngine.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAIrB;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAiB;IAE5C,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,eAAe,CAAqB;IAC5C;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAwC;IACzE,OAAO,CAAC,iBAAiB,CAAyC;IAElE,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAE1C,OAAO,CAAC,KAAK,CAIX;IAEI,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBzD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4F3E,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ7B,QAAQ,IAAI,WAAW;IAIjB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,WAAW,CAAC;IAsBpD,OAAO,CAAC,iBAAiB;IAIzB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,YAAY;CAwBrB"}

package/dist/server/engines/claude/ClaudeCodeEngine.js

@@ -0,0 +1,338 @@
+// Copyright (c) 2025-present Mstro, Inc. All rights reserved.
+// Licensed under the MIT License. See LICENSE file for details.
+import { executeClaudeCommand } from '../../cli/headless/claude-invoker.js';
+import { killProcessGroup } from '../../cli/headless/runner.js';
+/**
+ * Implementation of CodingAgentEngine backed by the Claude Code headless
+ * runner. The engine holds a single logical conversation — subsequent
+ * prompts automatically continue the Claude session via --resume.
+ */
+export class ClaudeCodeEngine {
+    engineId = 'claude-code';
+    sessionOptions = null;
+    claudeSessionId;
+    /**
+     * Live child processes spawned by the current prompt. Keyed by pid; values
+     * are the raw ChildProcess handles. executeClaudeCommand registers the
+     * spawned process here and removes it on 'close'. cancel() iterates this
+     * map and SIGTERMs each process group — matching the pre-engine behavior
+     * from HeadlessRunner.cleanup().
+     */
+    runningProcesses = new Map();
+    currentRunPromise = null;
+    disposed = false;
+    iteratorDone = false;
+    queue = [];
+    pending = [];
+    usage = {
+        inputTokens: 0,
+        outputTokens: 0,
+        lastUpdatedAt: Date.now(),
+    };
+    async startSession(options) {
+        if (this.sessionOptions) {
+            throw new Error('ClaudeCodeEngine: startSession called more than once');
+        }
+        if (this.disposed) {
+            throw new Error('ClaudeCodeEngine: cannot start a disposed engine');
+        }
+        this.sessionOptions = options;
+        this.claudeSessionId = options.resumeSessionId;
+        this.usage = {
+            inputTokens: 0,
+            outputTokens: 0,
+            lastUpdatedAt: Date.now(),
+        };
+    }
+    async sendPrompt(prompt, attachments) {
+        if (!this.sessionOptions) {
+            throw new Error('ClaudeCodeEngine: sendPrompt called before startSession');
+        }
+        if (this.disposed) {
+            throw new Error('ClaudeCodeEngine: sendPrompt called after dispose');
+        }
+        if (this.currentRunPromise) {
+            throw new Error('ClaudeCodeEngine: another prompt is already in flight');
+        }
+        const opts = this.sessionOptions;
+        const imageAttachments = convertImageAttachments(attachments);
+        const toolStartTimes = new Map();
+        const toolNames = new Map();
+        const toolInputs = new Map();
+        const config = {
+            workingDir: opts.workingDir,
+            tokenBudgetThreshold: 170_000,
+            maxSessions: 50,
+            maxRetries: 3,
+            claudeCommand: process.env.CLAUDE_COMMAND || 'claude',
+            verbose: false,
+            noColor: false,
+            improvisationMode: false,
+            movementNumber: 0,
+            directPrompt: prompt,
+            promptContext: { accumulatedKnowledge: '', filesModified: [] },
+            stallWarningMs: 300_000,
+            stallKillMs: 1_800_000,
+            stallAssessEnabled: true,
+            stallMaxExtensions: 3,
+            stallHardCapMs: 3_600_000,
+            enableToolWatchdog: true,
+            maxAutoRetries: 2,
+            model: opts.model,
+            effortLevel: opts.effortLevel,
+            continueSession: !!this.claudeSessionId,
+            claudeSessionId: this.claudeSessionId,
+            imageAttachments,
+            disallowedTools: opts.disallowedTools,
+            deployMode: opts.deployMode,
+            extraEnv: opts.extraEnv,
+            outputCallback: (text) => {
+                this.emit({
+                    kind: 'message.delta',
+                    sessionId: this.sessionIdForEvent(),
+                    timestamp: Date.now(),
+                    text,
+                });
+            },
+            thinkingCallback: (text) => {
+                this.emit({
+                    kind: 'message.thinking',
+                    sessionId: this.sessionIdForEvent(),
+                    timestamp: Date.now(),
+                    text,
+                });
+            },
+            toolUseCallback: (event) => {
+                this.handleToolUseEvent(event, toolStartTimes, toolNames, toolInputs);
+            },
+            tokenUsageCallback: (usage) => {
+                this.usage = {
+                    inputTokens: usage.inputTokens,
+                    outputTokens: usage.outputTokens,
+                    lastUpdatedAt: Date.now(),
+                };
+                this.emit({
+                    kind: 'usage.update',
+                    sessionId: this.sessionIdForEvent(),
+                    timestamp: Date.now(),
+                    inputTokens: usage.inputTokens,
+                    outputTokens: usage.outputTokens,
+                });
+            },
+        };
+        const runPromise = executeClaudeCommand(prompt, 'engine', 1, {
+            config,
+            runningProcesses: this.runningProcesses,
+        });
+        this.currentRunPromise = runPromise;
+        runPromise.then((result) => this.onRunCompleted(result), (err) => this.onRunFailed(err));
+    }
+    async cancel() {
+        if (this.runningProcesses.size === 0 && !this.currentRunPromise)
+            return;
+        this.killAllRunningProcesses();
+        if (this.currentRunPromise) {
+            await this.currentRunPromise.catch(() => { });
+        }
+    }
+    getUsage() {
+        return { ...this.usage };
+    }
+    async dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.killAllRunningProcesses();
+        if (this.currentRunPromise) {
+            await this.currentRunPromise.catch(() => { });
+        }
+        this.closeIterator();
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                if (this.queue.length > 0) {
+                    return Promise.resolve({ value: this.queue.shift(), done: false });
+                }
+                if (this.iteratorDone) {
+                    return Promise.resolve({ value: undefined, done: true });
+                }
+                return new Promise((resolve) => {
+                    this.pending.push(resolve);
+                });
+            },
+            return: () => {
+                this.closeIterator();
+                return Promise.resolve({ value: undefined, done: true });
+            },
+        };
+    }
+    // ---------- private ----------
+    sessionIdForEvent() {
+        return this.claudeSessionId ?? 'pending';
+    }
+    /**
+     * SIGTERM every tracked child process group; schedule a SIGKILL fallback
+     * for any that haven't exited in 5s. Mirrors HeadlessRunner.cleanup().
+     */
+    killAllRunningProcesses() {
+        if (this.runningProcesses.size === 0)
+            return;
+        const pids = new Set();
+        for (const pid of this.runningProcesses.keys()) {
+            pids.add(pid);
+            killProcessGroup(pid, 'SIGTERM');
+        }
+        setTimeout(() => {
+            for (const [pid, proc] of this.runningProcesses) {
+                if (pids.has(pid) && !proc.killed) {
+                    killProcessGroup(pid, 'SIGKILL');
+                }
+            }
+        }, 5000).unref?.();
+    }
+    emit(event) {
+        if (this.iteratorDone)
+            return;
+        const resolver = this.pending.shift();
+        if (resolver) {
+            resolver({ value: event, done: false });
+        }
+        else {
+            this.queue.push(event);
+        }
+        if (event.kind === 'engine.error' && event.fatal) {
+            this.closeIterator();
+        }
+    }
+    closeIterator() {
+        if (this.iteratorDone)
+            return;
+        this.iteratorDone = true;
+        const waiting = this.pending.splice(0);
+        for (const resolve of waiting) {
+            resolve({ value: undefined, done: true });
+        }
+    }
+    onRunCompleted(result) {
+        this.currentRunPromise = null;
+        if (result.claudeSessionId) {
+            this.claudeSessionId = result.claudeSessionId;
+        }
+        // Fall back to the definitive end-of-run usage — the streaming callback
+        // may have missed the final numbers if the result event arrived after
+        // the last message_delta.
+        if (result.apiTokenUsage) {
+            const u = result.apiTokenUsage;
+            if (u.inputTokens > this.usage.inputTokens || u.outputTokens > this.usage.outputTokens) {
+                this.usage = {
+                    inputTokens: Math.max(u.inputTokens, this.usage.inputTokens),
+                    outputTokens: Math.max(u.outputTokens, this.usage.outputTokens),
+                    lastUpdatedAt: Date.now(),
+                };
+            }
+        }
+        this.emit({
+            kind: 'session.idle',
+            sessionId: this.sessionIdForEvent(),
+            timestamp: Date.now(),
+            stopReason: result.stopReason,
+        });
+        if (result.exitCode !== 0 && !result.assistantResponse && !result.toolUseHistory?.length) {
+            const message = result.error || `Claude exited with code ${result.exitCode}`;
+            this.emit({
+                kind: 'engine.error',
+                sessionId: this.sessionIdForEvent(),
+                timestamp: Date.now(),
+                code: 'CLAUDE_RUN_ERROR',
+                message,
+                fatal: false,
+            });
+        }
+    }
+    onRunFailed(err) {
+        this.currentRunPromise = null;
+        const message = err instanceof Error ? err.message : String(err);
+        this.emit({
+            kind: 'engine.error',
+            sessionId: this.sessionIdForEvent(),
+            timestamp: Date.now(),
+            code: 'CLAUDE_SPAWN_ERROR',
+            message,
+            fatal: true,
+        });
+    }
+    handleToolUseEvent(event, starts, names, inputs) {
+        if (!event.toolId)
+            return;
+        if (event.type === 'tool_start') {
+            this.onToolStart(event, starts, names);
+        }
+        else if (event.type === 'tool_complete') {
+            this.onToolComplete(event, names, inputs);
+        }
+        else if (event.type === 'tool_result') {
+            this.onToolResult(event, starts, names, inputs);
+        }
+    }
+    onToolStart(event, starts, names) {
+        const ts = Date.now();
+        const toolId = event.toolId;
+        starts.set(toolId, ts);
+        if (event.toolName)
+            names.set(toolId, event.toolName);
+        this.emit({
+            kind: 'tool.start',
+            sessionId: this.sessionIdForEvent(),
+            timestamp: ts,
+            toolCallId: toolId,
+            toolName: event.toolName ?? '',
+            input: {},
+        });
+    }
+    onToolComplete(event, names, inputs) {
+        const toolId = event.toolId;
+        if (event.completeInput)
+            inputs.set(toolId, event.completeInput);
+        if (event.toolName)
+            names.set(toolId, event.toolName);
+        // tool.end is emitted on tool_result so the result payload is included.
+    }
+    onToolResult(event, starts, names, inputs) {
+        const ts = Date.now();
+        const toolId = event.toolId;
+        const start = starts.get(toolId) ?? ts;
+        this.emit({
+            kind: 'tool.end',
+            sessionId: this.sessionIdForEvent(),
+            timestamp: ts,
+            toolCallId: toolId,
+            toolName: names.get(toolId) ?? '',
+            input: inputs.get(toolId) ?? {},
+            result: event.result ?? '',
+            isError: event.isError ?? false,
+            durationMs: ts - start,
+        });
+        starts.delete(toolId);
+        names.delete(toolId);
+        inputs.delete(toolId);
+    }
+}
+function convertImageAttachments(attachments) {
+    if (!attachments || attachments.length === 0)
+        return undefined;
+    const images = [];
+    for (const a of attachments) {
+        if (!a.isImage || !a.base64Content)
+            continue;
+        images.push({
+            fileName: a.fileName,
+            filePath: a.filePath ?? a.fileName,
+            content: a.base64Content,
+            isImage: true,
+            mimeType: a.mimeType,
+        });
+    }
+    return images.length > 0 ? images : undefined;
+}
+//# sourceMappingURL=ClaudeCodeEngine.js.map

package/dist/server/engines/claude/ClaudeCodeEngine.js.map

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

package/dist/server/engines/factory.d.ts

@@ -0,0 +1,21 @@
+import type { CodingAgentEngine, EngineId } from './types.js';
+/**
+ * Reset the cached OpenCode manager. Primarily for tests — never called
+ * by production code. Does not shut down the previous manager; callers
+ * that need a clean state should `shutdown()` first.
+ */
+export declare function __resetSharedOpenCodeServerManagerForTests(): void;
+/**
+ * Construct a new engine instance for the given engine id. The returned
+ * engine is uninitialized — the caller must call `startSession` before
+ * any other method.
+ *
+ * Feature-flag gate: when `engineSwap` is disabled, this returns
+ * `ClaudeCodeEngine` for every id. That guarantees the pre-OpenCode
+ * behavior — in particular, `LazyOpenCodeEngine` is never constructed, so
+ * the shared `OpenCodeServerManager` is never touched and no `opencode
+ * serve` subprocess is spawned. The flag is checked on every call (rather
+ * than cached) so runtime toggles take effect on the next session start.
+ */
+export declare function createEngine(engineId: EngineId): CodingAgentEngine;
+//# sourceMappingURL=factory.d.ts.map

package/dist/server/engines/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../server/engines/factory.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,iBAAiB,EAEjB,QAAQ,EAIT,MAAM,YAAY,CAAC;AAmBpB;;;;GAIG;AACH,wBAAgB,0CAA0C,IAAI,IAAI,CAEjE;AA8FD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,iBAAiB,CAclE"}