@electric-agent/studio 1.7.0 → 1.12.1

package/dist/active-sessions.d.ts

@@ -15,6 +15,8 @@ export declare class ActiveSessions {
     delete(id: string): boolean;
     /** Check if a session exists in the active store. */
     has(id: string): boolean;
+    /** Return the number of active sessions. */
+    size(): number;
     /**
      * Look up the EA session ID for a Claude Code transcript path.
      * Returns undefined if no mapping exists or the session has been deleted.

package/dist/active-sessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"active-sessions.d.ts","sourceRoot":"","sources":["../src/active-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;;;;;GAMG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,mBAAmB,CAA4B;IAEvD,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAI/B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIxC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAStD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,qDAAqD;IACrD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAMxB;;;OAGG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAM3D;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;CAG9D"}
+{"version":3,"file":"active-sessions.d.ts","sourceRoot":"","sources":["../src/active-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;;;;;GAMG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,mBAAmB,CAA4B;IAEvD,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAI/B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIxC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAStD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,qDAAqD;IACrD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,4CAA4C;IAC5C,IAAI,IAAI,MAAM;IAMd;;;OAGG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAM3D;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;CAG9D"}

package/dist/active-sessions.js

@@ -29,6 +29,10 @@ export class ActiveSessions {
     has(id) {
         return this.sessions.has(id);
     }
+    /** Return the number of active sessions. */
+    size() {
+        return this.sessions.size;
+    }
     // --- Transcript → Session Mapping (for Claude Code hook integration) ---
     /**
      * Look up the EA session ID for a Claude Code transcript path.

package/dist/active-sessions.js.map

@@ -1 +1 @@
-{"version":3,"file":"active-sessions.js","sourceRoot":"","sources":["../src/active-sessions.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IAClB,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAA;IACzC,mBAAmB,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEvD,GAAG,CAAC,OAAoB;QACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACvC,CAAC;IAED,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,MAA4B;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACrC,IAAI,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE;gBAC9B,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC,CAAA;QACH,CAAC;IACF,CAAC;IAED,MAAM,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAChC,CAAC;IAED,qDAAqD;IACrD,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC;IAED,0EAA0E;IAE1E;;;OAGG;IACH,eAAe,CAAC,cAAsB;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QAC9D,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAA;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAA;IAC5D,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,cAAsB,EAAE,SAAiB;QACtD,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC,CAAA;IACxD,CAAC;CACD"}
+{"version":3,"file":"active-sessions.js","sourceRoot":"","sources":["../src/active-sessions.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IAClB,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAA;IACzC,mBAAmB,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEvD,GAAG,CAAC,OAAoB;QACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACvC,CAAC;IAED,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,MAA4B;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACrC,IAAI,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE;gBAC9B,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC,CAAA;QACH,CAAC;IACF,CAAC;IAED,MAAM,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAChC,CAAC;IAED,qDAAqD;IACrD,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC;IAED,4CAA4C;IAC5C,IAAI;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAA;IAC1B,CAAC;IAED,0EAA0E;IAE1E;;;OAGG;IACH,eAAe,CAAC,cAAsB;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QAC9D,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAA;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAA;IAC5D,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,cAAsB,EAAE,SAAiB;QACtD,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC,CAAA;IACxD,CAAC;CACD"}

package/dist/api-schemas.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Zod schemas for API request body validation.
+ *
+ * Each schema corresponds to a POST endpoint in server.ts.
+ * Using `.passthrough()` where backwards-compat matters (unknown fields ignored).
+ */
+import { z } from "zod";
+export declare const createSessionSchema: z.ZodObject<{
+    description: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    baseDir: z.ZodOptional<z.ZodString>;
+    freeform: z.ZodOptional<z.ZodBoolean>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    oauthToken: z.ZodOptional<z.ZodString>;
+    ghToken: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    name?: string | undefined;
+    baseDir?: string | undefined;
+    freeform?: boolean | undefined;
+    apiKey?: string | undefined;
+    oauthToken?: string | undefined;
+    ghToken?: string | undefined;
+}, {
+    description: string;
+    name?: string | undefined;
+    baseDir?: string | undefined;
+    freeform?: boolean | undefined;
+    apiKey?: string | undefined;
+    oauthToken?: string | undefined;
+    ghToken?: string | undefined;
+}>;
+export declare const iterateSessionSchema: z.ZodObject<{
+    request: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    request: string;
+}, {
+    request: string;
+}>;
+export declare const createSandboxSchema: z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodString>;
+    projectName: z.ZodOptional<z.ZodString>;
+    infra: z.ZodOptional<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        mode: z.ZodLiteral<"none">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "none";
+    }, {
+        mode: "none";
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"local">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "local";
+    }, {
+        mode: "local";
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"cloud">;
+        databaseUrl: z.ZodString;
+        electricUrl: z.ZodString;
+        sourceId: z.ZodString;
+        secret: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        mode: "cloud";
+        databaseUrl: string;
+        electricUrl: string;
+        sourceId: string;
+        secret: string;
+    }, {
+        mode: "cloud";
+        databaseUrl: string;
+        electricUrl: string;
+        sourceId: string;
+        secret: string;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"claim">;
+        databaseUrl: z.ZodString;
+        electricUrl: z.ZodString;
+        sourceId: z.ZodString;
+        secret: z.ZodString;
+        claimId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        claimId: string;
+        mode: "claim";
+        databaseUrl: string;
+        electricUrl: string;
+        sourceId: string;
+        secret: string;
+    }, {
+        claimId: string;
+        mode: "claim";
+        databaseUrl: string;
+        electricUrl: string;
+        sourceId: string;
+        secret: string;
+    }>]>>;
+}, "strip", z.ZodTypeAny, {
+    projectName?: string | undefined;
+    sessionId?: string | undefined;
+    infra?: {
+        mode: "none";
+    } | {
+        mode: "local";
+    } | {
+        mode: "cloud";
+        databaseUrl: string;
+        electricUrl: string;
+        sourceId: string;
+        secret: string;
+    } | {
+        claimId: string;
+        mode: "claim";
+        databaseUrl: string;
+        electricUrl: string;
+        sourceId: string;
+        secret: string;
+    } | undefined;
+}, {
+    projectName?: string | undefined;
+    sessionId?: string | undefined;
+    infra?: {
+        mode: "none";
+    } | {
+        mode: "local";
+    } | {
+        mode: "cloud";
+        databaseUrl: string;
+        electricUrl: string;
+        sourceId: string;
+        secret: string;
+    } | {
+        claimId: string;
+        mode: "claim";
+        databaseUrl: string;
+        electricUrl: string;
+        sourceId: string;
+        secret: string;
+    } | undefined;
+}>;
+export declare const createRoomSchema: z.ZodObject<{
+    name: z.ZodString;
+    maxRounds: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    maxRounds?: number | undefined;
+}, {
+    name: string;
+    maxRounds?: number | undefined;
+}>;
+export declare const addAgentSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    gated: z.ZodOptional<z.ZodBoolean>;
+    initialPrompt: z.ZodOptional<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    oauthToken: z.ZodOptional<z.ZodString>;
+    ghToken: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
+    apiKey?: string | undefined;
+    oauthToken?: string | undefined;
+    ghToken?: string | undefined;
+    role?: string | undefined;
+    gated?: boolean | undefined;
+    initialPrompt?: string | undefined;
+}, {
+    name?: string | undefined;
+    apiKey?: string | undefined;
+    oauthToken?: string | undefined;
+    ghToken?: string | undefined;
+    role?: string | undefined;
+    gated?: boolean | undefined;
+    initialPrompt?: string | undefined;
+}>;
+export declare const addSessionToRoomSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    name: z.ZodString;
+    initialPrompt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    sessionId: string;
+    initialPrompt?: string | undefined;
+}, {
+    name: string;
+    sessionId: string;
+    initialPrompt?: string | undefined;
+}>;
+export declare const iterateRoomSessionSchema: z.ZodObject<{
+    request: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    request: string;
+}, {
+    request: string;
+}>;
+export declare const sendRoomMessageSchema: z.ZodObject<{
+    from: z.ZodString;
+    body: z.ZodString;
+    to: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    from: string;
+    body: string;
+    to?: string | undefined;
+}, {
+    from: string;
+    body: string;
+    to?: string | undefined;
+}>;
+export declare const resumeSessionSchema: z.ZodObject<{
+    repoUrl: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    oauthToken: z.ZodOptional<z.ZodString>;
+    ghToken: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    repoUrl: string;
+    apiKey?: string | undefined;
+    oauthToken?: string | undefined;
+    ghToken?: string | undefined;
+    branch?: string | undefined;
+}, {
+    repoUrl: string;
+    apiKey?: string | undefined;
+    oauthToken?: string | undefined;
+    ghToken?: string | undefined;
+    branch?: string | undefined;
+}>;
+//# sourceMappingURL=api-schemas.d.ts.map

package/dist/api-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-schemas.d.ts","sourceRoot":"","sources":["../src/api-schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAUvB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EAQ9B,CAAA;AAGF,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAA;AA2BF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI9B,CAAA;AAGF,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAA;AAGF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;EAQzB,CAAA;AAGF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAA;AAGF,eAAO,MAAM,wBAAwB;;;;;;EAEnC,CAAA;AAGF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAIhC,CAAA;AAGF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAM9B,CAAA"}

package/dist/api-schemas.js

@@ -0,0 +1,95 @@
+/**
+ * Zod schemas for API request body validation.
+ *
+ * Each schema corresponds to a POST endpoint in server.ts.
+ * Using `.passthrough()` where backwards-compat matters (unknown fields ignored).
+ */
+import { z } from "zod";
+/** Max length for free-text fields to prevent abuse */
+const MAX_TEXT = 10_000;
+const MAX_SHORT = 500;
+const MAX_KEY = 1_000;
+const optionalKey = z.string().max(MAX_KEY).optional();
+// POST /api/sessions
+export const createSessionSchema = z.object({
+    description: z.string().min(1).max(MAX_TEXT),
+    name: z.string().max(MAX_SHORT).optional(),
+    baseDir: z.string().max(MAX_SHORT).optional(),
+    freeform: z.boolean().optional(),
+    apiKey: optionalKey,
+    oauthToken: optionalKey,
+    ghToken: optionalKey,
+});
+// POST /api/sessions/:id/iterate
+export const iterateSessionSchema = z.object({
+    request: z.string().min(1).max(MAX_TEXT),
+});
+// POST /api/sandboxes
+const infraNoneSchema = z.object({ mode: z.literal("none") });
+const infraLocalSchema = z.object({ mode: z.literal("local") });
+const infraCloudSchema = z.object({
+    mode: z.literal("cloud"),
+    databaseUrl: z.string().max(MAX_KEY),
+    electricUrl: z.string().max(MAX_KEY),
+    sourceId: z.string().max(MAX_SHORT),
+    secret: z.string().max(MAX_KEY),
+});
+const infraClaimSchema = z.object({
+    mode: z.literal("claim"),
+    databaseUrl: z.string().max(MAX_KEY),
+    electricUrl: z.string().max(MAX_KEY),
+    sourceId: z.string().max(MAX_SHORT),
+    secret: z.string().max(MAX_KEY),
+    claimId: z.string().max(MAX_SHORT),
+});
+const infraConfigSchema = z.discriminatedUnion("mode", [
+    infraNoneSchema,
+    infraLocalSchema,
+    infraCloudSchema,
+    infraClaimSchema,
+]);
+export const createSandboxSchema = z.object({
+    sessionId: z.string().uuid().optional(),
+    projectName: z.string().max(MAX_SHORT).optional(),
+    infra: infraConfigSchema.optional(),
+});
+// POST /api/rooms
+export const createRoomSchema = z.object({
+    name: z.string().min(1).max(MAX_SHORT),
+    maxRounds: z.number().int().positive().optional(),
+});
+// POST /api/rooms/:id/agents
+export const addAgentSchema = z.object({
+    name: z.string().max(MAX_SHORT).optional(),
+    role: z.string().max(MAX_SHORT).optional(),
+    gated: z.boolean().optional(),
+    initialPrompt: z.string().max(MAX_TEXT).optional(),
+    apiKey: optionalKey,
+    oauthToken: optionalKey,
+    ghToken: optionalKey,
+});
+// POST /api/rooms/:id/sessions
+export const addSessionToRoomSchema = z.object({
+    sessionId: z.string().uuid(),
+    name: z.string().min(1).max(MAX_SHORT),
+    initialPrompt: z.string().max(MAX_TEXT).optional(),
+});
+// POST /api/rooms/:id/sessions/:sessionId/iterate
+export const iterateRoomSessionSchema = z.object({
+    request: z.string().min(1).max(MAX_TEXT),
+});
+// POST /api/rooms/:id/messages
+export const sendRoomMessageSchema = z.object({
+    from: z.string().min(1).max(MAX_SHORT),
+    body: z.string().min(1).max(MAX_TEXT),
+    to: z.string().max(MAX_SHORT).optional(),
+});
+// POST /api/sessions/resume
+export const resumeSessionSchema = z.object({
+    repoUrl: z.string().min(1).max(MAX_KEY),
+    branch: z.string().max(MAX_SHORT).optional(),
+    apiKey: optionalKey,
+    oauthToken: optionalKey,
+    ghToken: optionalKey,
+});
+//# sourceMappingURL=api-schemas.js.map

package/dist/api-schemas.js.map

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

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

@@ -0,0 +1,121 @@
+/**
+ * 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 type { EngineEvent } from "@electric-agent/protocol";
+import type { StreamConnectionInfo } from "../streams.js";
+import { createStreamJsonParser } from "./stream-json-parser.js";
+type StreamJsonParser = ReturnType<typeof createStreamJsonParser>;
+import type { SessionBridge } from "./types.js";
+export interface ClaudeCodeBaseConfig {
+    /** Initial prompt (the user's app description or task) */
+    prompt: string;
+    /** Working directory inside the container/sprite */
+    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[];
+    /** HMAC token for authenticating hook-event requests back to the studio */
+    hookToken?: string;
+    /** Agent name — injected into assistant_message events for display */
+    agentName?: string;
+}
+export declare const DEFAULT_ALLOWED_TOOLS: string[];
+/** Tools allowed in production mode — no WebSearch to prevent abuse */
+export declare const PRODUCTION_ALLOWED_TOOLS: string[];
+export declare abstract class ClaudeCodeBaseBridge implements SessionBridge {
+    readonly sessionId: string;
+    protected writer: DurableStream;
+    protected parser: StreamJsonParser;
+    protected closed: boolean;
+    protected running: boolean;
+    protected hooksInstalled: boolean;
+    /** Claude Code session ID captured from stream-json system.init — used for --resume */
+    protected claudeSessionId: string | null;
+    /** Whether the parser already emitted a session_end (from a "result" message) */
+    protected resultReceived: boolean;
+    /** Whether the process was intentionally interrupted (suppress exit handler session_end) */
+    protected interrupted: boolean;
+    /** Queued messages to deliver after the current process finishes */
+    protected pendingMessages: string[];
+    private agentEventCallbacks;
+    private completeCallbacks;
+    /** Logging prefix for console output (e.g., "claude-code-docker") */
+    protected abstract readonly logPrefix: string;
+    constructor(sessionId: string, connection: StreamConnectionInfo);
+    /** Spawn a new Claude Code process with the given prompt and optional resume session. */
+    protected abstract spawnProcess(prompt: string, resumeSessionId?: string): void | Promise<void>;
+    /** Kill the currently running process. */
+    protected abstract killProcess(): void;
+    /** Check if a process handle exists (not necessarily alive). */
+    protected abstract hasProcess(): boolean;
+    /** Write a raw string to the process's stdin. */
+    protected abstract writeToStdin(content: string): void;
+    /** Install AskUserQuestion hooks in the sandbox. */
+    protected abstract installHooksImpl(): void | Promise<void>;
+    /** Get the agent name for event injection. */
+    protected abstract getAgentName(): string | undefined;
+    emit(event: EngineEvent): Promise<void>;
+    /**
+     * 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.
+     */
+    sendCommand(cmd: Record<string, unknown>): Promise<void>;
+    sendGateResponse(gate: string, value: Record<string, unknown>): Promise<void>;
+    onAgentEvent(cb: (event: EngineEvent) => void): void;
+    onComplete(cb: (success: boolean) => void): void;
+    abstract start(): Promise<void>;
+    isRunning(): boolean;
+    interrupt(): void;
+    close(): void;
+    /**
+     * Reset parser state before spawning a new process.
+     * Call this at the start of spawnProcess implementations.
+     */
+    protected resetParserState(): void;
+    /**
+     * Install hooks if not already installed.
+     * Call this at the start of spawnProcess implementations.
+     */
+    protected ensureHooksInstalled(): Promise<void>;
+    /**
+     * Handle a line of NDJSON output from Claude Code.
+     * Call this from stdout readline handlers.
+     */
+    protected handleLine(line: string): void;
+    /**
+     * Handle process exit. Call this from process exit handlers.
+     * Defers processing to let pending readline events flush first.
+     */
+    protected handleProcessExit(code: number | null): void;
+    /**
+     * Dispatch an engine event to the durable stream and all callbacks.
+     */
+    protected dispatchEvent(event: EngineEvent): void;
+    /**
+     * Write a user message to Claude Code's stdin in stream-json format.
+     */
+    private writeUserMessage;
+}
+export {};
+//# sourceMappingURL=claude-code-base.d.ts.map

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

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