@electric-agent/studio 1.5.0 → 1.12.0

package/dist/bridge/claude-code-base.js

@@ -0,0 +1,263 @@
+/**
+ * Abstract base class for Claude Code bridges (Docker and Sprites).
+ *
+ * Encapsulates the shared logic for:
+ * - Durable Stream writing (emit, dispatchEvent)
+ * - Message queueing (sendCommand with queue-if-busy)
+ * - Event dispatching (callbacks, app_status detection)
+ * - Process lifecycle (exit handling, queue draining, session_end)
+ * - Gate responses
+ *
+ * Subclasses implement the platform-specific process management:
+ * - spawnProcess() — start a new Claude Code process
+ * - killProcess() — terminate the running process
+ * - isProcessAlive() — check if a process is currently running
+ * - writeToStdin(content) — write a user message to stdin
+ * - installHooksImpl() — install AskUserQuestion hooks
+ */
+import { DurableStream } from "@durable-streams/client";
+import { ts } from "@electric-agent/protocol";
+import { formatGateMessage } from "./gate-response.js";
+import { createStreamJsonParser } from "./stream-json-parser.js";
+export const DEFAULT_ALLOWED_TOOLS = [
+    "Read",
+    "Write",
+    "Edit",
+    "Bash",
+    "Glob",
+    "Grep",
+    "WebSearch",
+    "TodoWrite",
+    "AskUserQuestion",
+    "Skill",
+];
+/** Tools allowed in production mode — no WebSearch to prevent abuse */
+export const PRODUCTION_ALLOWED_TOOLS = DEFAULT_ALLOWED_TOOLS.filter((t) => t !== "WebSearch");
+export class ClaudeCodeBaseBridge {
+    sessionId;
+    writer;
+    parser = createStreamJsonParser();
+    closed = false;
+    running = false;
+    hooksInstalled = false;
+    /** Claude Code session ID captured from stream-json system.init — used for --resume */
+    claudeSessionId = null;
+    /** Whether the parser already emitted a session_end (from a "result" message) */
+    resultReceived = false;
+    /** Whether the process was intentionally interrupted (suppress exit handler session_end) */
+    interrupted = false;
+    /** Queued messages to deliver after the current process finishes */
+    pendingMessages = [];
+    agentEventCallbacks = [];
+    completeCallbacks = [];
+    constructor(sessionId, connection) {
+        this.sessionId = sessionId;
+        this.writer = new DurableStream({
+            url: connection.url,
+            headers: connection.headers,
+            contentType: "application/json",
+        });
+    }
+    // -------------------------------------------------------------------
+    // SessionBridge interface
+    // -------------------------------------------------------------------
+    async emit(event) {
+        if (this.closed)
+            return;
+        const msg = { source: "server", ...event };
+        await this.writer.append(JSON.stringify(msg));
+    }
+    /**
+     * Send a follow-up user message to Claude Code by respawning with --resume.
+     *
+     * If Claude Code is currently running, the message is queued and delivered
+     * after the current process finishes. This prevents killing the agent
+     * mid-work and losing in-flight file writes or tool calls.
+     */
+    async sendCommand(cmd) {
+        if (this.closed)
+            return;
+        if (cmd.command === "iterate" && typeof cmd.request === "string") {
+            if (this.running && this.hasProcess()) {
+                console.log(`[${this.logPrefix}] Queuing message (agent busy): session=${this.sessionId} queue=${this.pendingMessages.length + 1}`);
+                this.pendingMessages.push(cmd.request);
+                return;
+            }
+            await this.spawnProcess(cmd.request, this.claudeSessionId ?? undefined);
+            return;
+        }
+        console.log(`[${this.logPrefix}] Ignoring unsupported command: ${cmd.command}`);
+    }
+    async sendGateResponse(gate, value) {
+        if (this.closed || !this.hasProcess())
+            return;
+        const message = formatGateMessage(gate, value);
+        if (message != null) {
+            this.writeUserMessage(message);
+        }
+    }
+    onAgentEvent(cb) {
+        this.agentEventCallbacks.push(cb);
+    }
+    onComplete(cb) {
+        this.completeCallbacks.push(cb);
+    }
+    isRunning() {
+        return this.running;
+    }
+    interrupt() {
+        this.interrupted = true;
+        this.killProcess();
+        this.running = false;
+    }
+    close() {
+        this.closed = true;
+        this.killProcess();
+    }
+    // -------------------------------------------------------------------
+    // Shared helpers — used by subclasses
+    // -------------------------------------------------------------------
+    /**
+     * Reset parser state before spawning a new process.
+     * Call this at the start of spawnProcess implementations.
+     */
+    resetParserState() {
+        this.parser = createStreamJsonParser();
+        this.resultReceived = false;
+        this.interrupted = false;
+        this.running = true;
+    }
+    /**
+     * Install hooks if not already installed.
+     * Call this at the start of spawnProcess implementations.
+     */
+    async ensureHooksInstalled() {
+        if (!this.hooksInstalled) {
+            try {
+                await this.installHooksImpl();
+                this.hooksInstalled = true;
+            }
+            catch (err) {
+                console.error(`[${this.logPrefix}] Hook install error:`, err);
+            }
+        }
+    }
+    /**
+     * Handle a line of NDJSON output from Claude Code.
+     * Call this from stdout readline handlers.
+     */
+    handleLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return;
+        const events = this.parser.parse(trimmed);
+        for (const event of events) {
+            this.dispatchEvent(event);
+        }
+    }
+    /**
+     * Handle process exit. Call this from process exit handlers.
+     * Defers processing to let pending readline events flush first.
+     */
+    handleProcessExit(code) {
+        console.log(`[${this.logPrefix}] Process exited: code=${code} session=${this.sessionId}`);
+        setTimeout(() => {
+            if (this.parser.state.sessionId) {
+                this.claudeSessionId = this.parser.state.sessionId;
+            }
+            this.running = false;
+            // Drain pending messages — if messages were queued while the agent
+            // was busy, combine them and respawn with --resume so the agent
+            // continues from where it left off instead of losing context.
+            if (!this.closed && this.pendingMessages.length > 0) {
+                const combined = this.pendingMessages.join("\n\n---\n\n");
+                this.pendingMessages = [];
+                console.log(`[${this.logPrefix}] Draining queued messages: session=${this.sessionId}`);
+                this.spawnProcess(combined, this.claudeSessionId ?? undefined);
+                return;
+            }
+            // Only emit session_end from exit handler if the parser didn't already
+            // emit one (via a "result" message) and the process wasn't intentionally
+            // interrupted. This prevents double session_end.
+            if (!this.closed && !this.resultReceived && !this.interrupted) {
+                const endEvent = {
+                    type: "session_end",
+                    success: code === 0,
+                    ts: ts(),
+                };
+                this.dispatchEvent(endEvent);
+            }
+        }, 100);
+    }
+    /**
+     * Dispatch an engine event to the durable stream and all callbacks.
+     */
+    dispatchEvent(event) {
+        // Inject agent name into assistant_message events for display
+        const agentName = this.getAgentName();
+        if (agentName && event.type === "assistant_message") {
+            ;
+            event.agent = agentName;
+        }
+        // Write to Durable Stream for UI
+        const msg = { source: "agent", ...event };
+        this.writer.append(JSON.stringify(msg)).catch(() => { });
+        // Track session_end from result messages to prevent duplicates
+        if (event.type === "session_end") {
+            this.resultReceived = true;
+        }
+        // Detect dev:start in Bash tool_use → emit app_status for the UI preview
+        if (event.type === "pre_tool_use" && event.tool_name === "Bash") {
+            const cmd = event.tool_input?.command;
+            if (typeof cmd === "string" && /\bdev:start\b/.test(cmd)) {
+                const appStatus = {
+                    type: "app_status",
+                    status: "running",
+                    ts: ts(),
+                };
+                const appStatusMsg = { source: "agent", ...appStatus };
+                this.writer.append(JSON.stringify(appStatusMsg)).catch(() => { });
+                for (const cb of this.agentEventCallbacks) {
+                    try {
+                        cb(appStatus);
+                    }
+                    catch {
+                        // Swallow
+                    }
+                }
+            }
+        }
+        // Dispatch to callbacks
+        for (const cb of this.agentEventCallbacks) {
+            try {
+                cb(event);
+            }
+            catch {
+                // Swallow callback errors
+            }
+        }
+        // Detect session_end
+        if (event.type === "session_end" && "success" in event) {
+            const success = event.success;
+            for (const cb of this.completeCallbacks) {
+                try {
+                    cb(success);
+                }
+                catch {
+                    // Swallow callback errors
+                }
+            }
+        }
+    }
+    /**
+     * Write a user message to Claude Code's stdin in stream-json format.
+     */
+    writeUserMessage(content) {
+        const msg = JSON.stringify({
+            type: "user",
+            message: { role: "user", content },
+        });
+        this.writeToStdin(`${msg}\n`);
+    }
+}
+//# sourceMappingURL=claude-code-base.js.map

package/dist/bridge/claude-code-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-base.js","sourceRoot":"","sources":["../../src/bridge/claude-code-base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAEvD,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAA;AAE7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAuBhE,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,WAAW;IACX,WAAW;IACX,iBAAiB;IACjB,OAAO;CACP,CAAA;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,WAAW,CAAC,CAAA;AAE9F,MAAM,OAAgB,oBAAoB;IAChC,SAAS,CAAQ;IAEhB,MAAM,CAAe;IACrB,MAAM,GAAqB,sBAAsB,EAAE,CAAA;IACnD,MAAM,GAAG,KAAK,CAAA;IACd,OAAO,GAAG,KAAK,CAAA;IACf,cAAc,GAAG,KAAK,CAAA;IAEhC,uFAAuF;IAC7E,eAAe,GAAkB,IAAI,CAAA;IAC/C,iFAAiF;IACvE,cAAc,GAAG,KAAK,CAAA;IAChC,4FAA4F;IAClF,WAAW,GAAG,KAAK,CAAA;IAC7B,oEAAoE;IAC1D,eAAe,GAAa,EAAE,CAAA;IAEhC,mBAAmB,GAAwC,EAAE,CAAA;IAC7D,iBAAiB,GAAsC,EAAE,CAAA;IAKjE,YAAY,SAAiB,EAAE,UAAgC;QAC9D,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAE1B,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC;YAC/B,GAAG,EAAE,UAAU,CAAC,GAAG;YACnB,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,WAAW,EAAE,kBAAkB;SAC/B,CAAC,CAAA;IACH,CAAC;IAwBD,sEAAsE;IACtE,0BAA0B;IAC1B,sEAAsE;IAEtE,KAAK,CAAC,IAAI,CAAC,KAAkB;QAC5B,IAAI,IAAI,CAAC,MAAM;YAAE,OAAM;QACvB,MAAM,GAAG,GAAkB,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAA;QACzD,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;IAC9C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,GAA4B;QAC7C,IAAI,IAAI,CAAC,MAAM;YAAE,OAAM;QAEvB,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAClE,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;gBACvC,OAAO,CAAC,GAAG,CACV,IAAI,IAAI,CAAC,SAAS,2CAA2C,IAAI,CAAC,SAAS,UAAU,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CACtH,CAAA;gBACD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;gBACtC,OAAM;YACP,CAAC;YACD,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,IAAI,SAAS,CAAC,CAAA;YACvE,OAAM;QACP,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,mCAAmC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;IAChF,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,IAAY,EAAE,KAA8B;QAClE,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;YAAE,OAAM;QAC7C,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAC9C,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;QAC/B,CAAC;IACF,CAAC;IAED,YAAY,CAAC,EAAgC;QAC5C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAClC,CAAC;IAED,UAAU,CAAC,EAA8B;QACxC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAChC,CAAC;IAID,SAAS;QACR,OAAO,IAAI,CAAC,OAAO,CAAA;IACpB,CAAC;IAED,SAAS;QACR,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QACvB,IAAI,CAAC,WAAW,EAAE,CAAA;QAClB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;IACrB,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,WAAW,EAAE,CAAA;IACnB,CAAC;IAED,sEAAsE;IACtE,sCAAsC;IACtC,sEAAsE;IAEtE;;;OAGG;IACO,gBAAgB;QACzB,IAAI,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAA;QACtC,IAAI,CAAC,cAAc,GAAG,KAAK,CAAA;QAC3B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAA;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;IACpB,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,oBAAoB;QACnC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACJ,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAA;gBAC7B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;YAC3B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,uBAAuB,EAAE,GAAG,CAAC,CAAA;YAC9D,CAAC;QACF,CAAC;IACF,CAAC;IAED;;;OAGG;IACO,UAAU,CAAC,IAAY;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC3B,IAAI,CAAC,OAAO;YAAE,OAAM;QAEpB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QAC1B,CAAC;IACF,CAAC;IAED;;;OAGG;IACO,iBAAiB,CAAC,IAAmB;QAC9C,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,0BAA0B,IAAI,YAAY,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;QACzF,UAAU,CAAC,GAAG,EAAE;YACf,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAA;YACnD,CAAC;YACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;YAEpB,mEAAmE;YACnE,gEAAgE;YAChE,8DAA8D;YAC9D,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;gBACzD,IAAI,CAAC,eAAe,GAAG,EAAE,CAAA;gBACzB,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,uCAAuC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;gBACtF,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,IAAI,SAAS,CAAC,CAAA;gBAC9D,OAAM;YACP,CAAC;YAED,uEAAuE;YACvE,yEAAyE;YACzE,iDAAiD;YACjD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC/D,MAAM,QAAQ,GAAgB;oBAC7B,IAAI,EAAE,aAAa;oBACnB,OAAO,EAAE,IAAI,KAAK,CAAC;oBACnB,EAAE,EAAE,EAAE,EAAE;iBACR,CAAA;gBACD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;YAC7B,CAAC;QACF,CAAC,EAAE,GAAG,CAAC,CAAA;IACR,CAAC;IAED;;OAEG;IACO,aAAa,CAAC,KAAkB;QACzC,8DAA8D;QAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;QACrC,IAAI,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACrD,CAAC;YAAC,KAA0C,CAAC,KAAK,GAAG,SAAS,CAAA;QAC/D,CAAC;QAED,iCAAiC;QACjC,MAAM,GAAG,GAAkB,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,CAAA;QACxD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAEvD,+DAA+D;QAC/D,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAClC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAC3B,CAAC;QAED,yEAAyE;QACzE,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YACjE,MAAM,GAAG,GAAI,KAAK,CAAC,UAAsC,EAAE,OAAO,CAAA;YAClE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1D,MAAM,SAAS,GAAgB;oBAC9B,IAAI,EAAE,YAAY;oBAClB,MAAM,EAAE,SAAS;oBACjB,EAAE,EAAE,EAAE,EAAE;iBACR,CAAA;gBACD,MAAM,YAAY,GAAkB,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,CAAA;gBACrE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;gBAChE,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;oBAC3C,IAAI,CAAC;wBACJ,EAAE,CAAC,SAAS,CAAC,CAAA;oBACd,CAAC;oBAAC,MAAM,CAAC;wBACR,UAAU;oBACX,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QAED,wBAAwB;QACxB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACJ,EAAE,CAAC,KAAK,CAAC,CAAA;YACV,CAAC;YAAC,MAAM,CAAC;gBACR,0BAA0B;YAC3B,CAAC;QACF,CAAC;QAED,qBAAqB;QACrB,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;YACxD,MAAM,OAAO,GAAI,KAA4C,CAAC,OAAO,CAAA;YACrE,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACzC,IAAI,CAAC;oBACJ,EAAE,CAAC,OAAO,CAAC,CAAA;gBACZ,CAAC;gBAAC,MAAM,CAAC;oBACR,0BAA0B;gBAC3B,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,OAAe;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;SAClC,CAAC,CAAA;QACF,IAAI,CAAC,YAAY,CAAC,GAAG,GAAG,IAAI,CAAC,CAAA;IAC9B,CAAC;CACD"}

package/dist/bridge/claude-code-docker.d.ts

@@ -1,88 +1,28 @@
 /**
  * SessionBridge implementation that runs Claude Code CLI inside a Docker
- * container via `docker exec -i`, communicating via stream-json NDJSON.
+ * container via `docker exec`, communicating via stream-json NDJSON.
  *
- * The bridge translates Claude Code's stream-json output into EngineEvents
- * and writes them to the Durable Stream for the UI. User messages and
- * gate responses are sent to Claude Code's stdin.
- *
- * Claude Code runs in one-shot mode (`-p`) and exits after completing.
- * On iterate (follow-up message), the bridge respawns Claude Code with
- * `--resume <sessionId>` so it picks up the previous conversation context.
+ * Extends ClaudeCodeBaseBridge with Docker-specific process management
+ * (spawn via `docker exec`, ChildProcess lifecycle, Docker hook installation).
  */
-import type { EngineEvent } from "@electric-agent/protocol";
 import type { StreamConnectionInfo } from "../streams.js";
-import type { SessionBridge } from "./types.js";
-export interface ClaudeCodeDockerConfig {
-    /** Initial prompt (the user's app description or task) */
-    prompt: string;
-    /** Working directory inside the container */
-    cwd: string;
-    /** Model to use (default: claude-sonnet-4-6) */
-    model?: string;
-    /** Allowed tools (default: all standard tools) */
-    allowedTools?: string[];
-    /** Additional CLI flags */
-    extraFlags?: string[];
+import { ClaudeCodeBaseBridge, type ClaudeCodeBaseConfig } from "./claude-code-base.js";
+export interface ClaudeCodeDockerConfig extends ClaudeCodeBaseConfig {
     /** Studio server port — used to set up AskUserQuestion hooks inside the container */
     studioPort?: number;
 }
-export declare class ClaudeCodeDockerBridge implements SessionBridge {
-    readonly sessionId: string;
-    readonly streamUrl: string;
-    readonly streamHeaders: Record<string, string>;
+export declare class ClaudeCodeDockerBridge extends ClaudeCodeBaseBridge {
+    protected readonly logPrefix = "claude-code-docker";
     private containerId;
     private config;
-    private writer;
-    private parser;
-    private agentEventCallbacks;
-    private completeCallbacks;
-    private closed;
     private proc;
-    /** Claude Code session ID captured from stream-json system.init — used for --resume */
-    private claudeSessionId;
-    /** Whether a Claude Code process is currently running */
-    private running;
-    /** Whether the parser already emitted a session_end (from a "result" message) */
-    private resultReceived;
-    /** Whether the process was intentionally interrupted (suppress exit handler session_end) */
-    private interrupted;
-    /** Whether hooks have been installed in the container */
-    private hooksInstalled;
     constructor(sessionId: string, connection: StreamConnectionInfo, containerId: string, config: ClaudeCodeDockerConfig);
-    emit(event: EngineEvent): Promise<void>;
-    /**
-     * Send a follow-up user message to Claude Code by respawning with --resume.
-     * Used for iteration requests (the user types a new message in the UI).
-     */
-    sendCommand(cmd: Record<string, unknown>): Promise<void>;
-    /**
-     * Send a gate response back to Claude Code as a user message.
-     * For ask_user_question gates, the user's answer becomes a follow-up message.
-     */
-    sendGateResponse(gate: string, value: Record<string, unknown>): Promise<void>;
-    onAgentEvent(cb: (event: EngineEvent) => void): void;
-    onComplete(cb: (success: boolean) => void): void;
     start(): Promise<void>;
-    interrupt(): void;
-    close(): void;
-    /**
-     * Install Claude Code hooks inside the container so that AskUserQuestion
-     * blocks until the user answers in the studio UI.
-     * The hook script forwards the PreToolUse event to the studio server via HTTP,
-     * which blocks the response until the gate is resolved.
-     */
-    private installHooks;
-    /**
-     * Spawn a new Claude Code process. Called for both the initial prompt
-     * and follow-up iterate messages (with --resume).
-     */
-    private spawnClaude;
-    private handleLine;
-    private dispatchEvent;
-    /**
-     * Write a user message to Claude Code's stdin in stream-json format.
-     */
-    private writeUserMessage;
+    protected spawnProcess(prompt: string, resumeSessionId?: string): void;
+    protected killProcess(): void;
+    protected hasProcess(): boolean;
+    protected writeToStdin(content: string): void;
+    protected getAgentName(): string | undefined;
+    protected installHooksImpl(): void;
 }
 //# sourceMappingURL=claude-code-docker.d.ts.map

package/dist/bridge/claude-code-docker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-code-docker.d.ts","sourceRoot":"","sources":["../../src/bridge/claude-code-docker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAGzD,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAA;AAE9D,MAAM,WAAW,sBAAsB;IACtC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAeD,qBAAa,sBAAuB,YAAW,aAAa;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,mBAAmB,CAA0C;IACrE,OAAO,CAAC,iBAAiB,CAAwC;IACjE,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,IAAI,CAA4B;IAExC,uFAAuF;IACvF,OAAO,CAAC,eAAe,CAAsB;IAC7C,yDAAyD;IACzD,OAAO,CAAC,OAAO,CAAQ;IACvB,iFAAiF;IACjF,OAAO,CAAC,cAAc,CAAQ;IAC9B,4FAA4F;IAC5F,OAAO,CAAC,WAAW,CAAQ;IAC3B,yDAAyD;IACzD,OAAO,CAAC,cAAc,CAAQ;gBAG7B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,EAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,sBAAsB;IAezB,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C;;;OAGG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D;;;OAGG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASnF,YAAY,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAIpD,UAAU,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAI1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,SAAS,IAAI,IAAI;IAcjB,KAAK,IAAI,IAAI;IAiBb;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAgEpB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAyHnB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,aAAa;IAqDrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAQxB"}
+{"version":3,"file":"claude-code-docker.d.ts","sourceRoot":"","sources":["../../src/bridge/claude-code-docker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,EACN,oBAAoB,EACpB,KAAK,oBAAoB,EAEzB,MAAM,uBAAuB,CAAA;AAE9B,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IACnE,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,sBAAuB,SAAQ,oBAAoB;IAC/D,SAAS,CAAC,QAAQ,CAAC,SAAS,wBAAuB;IAEnD,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,IAAI,CAA4B;gBAGvC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,EAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,sBAAsB;IAOzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI;IA4EtE,SAAS,CAAC,WAAW,IAAI,IAAI;IAY7B,SAAS,CAAC,UAAU,IAAI,OAAO;IAI/B,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM7C,SAAS,CAAC,YAAY,IAAI,MAAM,GAAG,SAAS;IAQ5C,SAAS,CAAC,gBAAgB,IAAI,IAAI;CA6DlC"}