@electric-agent/studio 1.0.0 → 1.1.0

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

@@ -0,0 +1,231 @@
+/**
+ * SessionBridge implementation that runs Claude Code CLI inside a Sprites
+ * sandbox via the Sprites SDK session API, 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.
+ */
+import * as readline from "node:readline";
+import { DurableStream } from "@durable-streams/client";
+import { ts } from "@electric-agent/protocol";
+import { createStreamJsonParser } from "./stream-json-parser.js";
+const SPRITES_SESSION_ID = "claude-code-session";
+const DEFAULT_ALLOWED_TOOLS = [
+    "Read",
+    "Write",
+    "Edit",
+    "Bash",
+    "Glob",
+    "Grep",
+    "WebSearch",
+    "TodoWrite",
+    "AskUserQuestion",
+];
+export class ClaudeCodeSpritesBridge {
+    sessionId;
+    streamUrl;
+    streamHeaders;
+    sprite;
+    config;
+    writer;
+    parser = createStreamJsonParser();
+    agentEventCallbacks = [];
+    completeCallbacks = [];
+    closed = false;
+    cmd = null;
+    constructor(sessionId, connection, sprite, config) {
+        this.sessionId = sessionId;
+        this.streamUrl = connection.url;
+        this.streamHeaders = connection.headers;
+        this.sprite = sprite;
+        this.config = config;
+        this.writer = new DurableStream({
+            url: connection.url,
+            headers: connection.headers,
+            contentType: "application/json",
+        });
+    }
+    async emit(event) {
+        if (this.closed)
+            return;
+        const msg = { source: "server", ...event };
+        await this.writer.append(JSON.stringify(msg));
+    }
+    async sendCommand(cmd) {
+        if (this.closed || !this.cmd)
+            return;
+        if (cmd.command === "iterate" && typeof cmd.request === "string") {
+            this.writeUserMessage(cmd.request);
+            return;
+        }
+        console.log(`[claude-code-sprites] Ignoring unsupported command: ${cmd.command}`);
+    }
+    async sendGateResponse(gate, value) {
+        if (this.closed || !this.cmd)
+            return;
+        if (gate === "ask_user_question" || gate.startsWith("ask_user_question:")) {
+            const answer = value.answer || "";
+            this.writeUserMessage(answer);
+            return;
+        }
+        if (gate === "clarification") {
+            const answers = value.answers;
+            if (answers?.length) {
+                this.writeUserMessage(answers.join("\n"));
+            }
+            return;
+        }
+        if (gate === "approval") {
+            const decision = value.decision || "approve";
+            this.writeUserMessage(decision);
+            return;
+        }
+        if (gate === "continue") {
+            const proceed = value.proceed;
+            this.writeUserMessage(proceed ? "continue" : "stop");
+            return;
+        }
+        this.writeUserMessage(JSON.stringify(value));
+    }
+    onAgentEvent(cb) {
+        this.agentEventCallbacks.push(cb);
+    }
+    onComplete(cb) {
+        this.completeCallbacks.push(cb);
+    }
+    async start() {
+        if (this.closed)
+            return;
+        const allowedTools = this.config.allowedTools ?? DEFAULT_ALLOWED_TOOLS;
+        const model = this.config.model ?? "claude-sonnet-4-6";
+        // Build the claude CLI command
+        const claudeArgs = [
+            "-p",
+            this.config.prompt,
+            "--output-format",
+            "stream-json",
+            "--verbose",
+            "--model",
+            model,
+            "--dangerously-skip-permissions",
+            "--allowedTools",
+            allowedTools.join(","),
+            ...(this.config.extraFlags ?? []),
+        ];
+        // Escape for bash — use bash -c with properly escaped args
+        const escapedArgs = claudeArgs.map((a) => `'${a.replace(/'/g, "'\\''")}'`).join(" ");
+        const fullCmd = `source /etc/profile.d/npm-global.sh 2>/dev/null; source /etc/profile.d/electric-agent.sh 2>/dev/null; cd '${this.config.cwd}' && claude ${escapedArgs}`;
+        this.cmd = this.sprite.createSession("bash", ["-c", fullCmd], {
+            detachable: true,
+            sessionId: SPRITES_SESSION_ID,
+        });
+        console.log(`[claude-code-sprites] Started: session=${this.sessionId}`);
+        // Read stdout line by line (stream-json NDJSON)
+        const rl = readline.createInterface({
+            input: this.cmd.stdout,
+            terminal: false,
+        });
+        rl.on("line", (line) => {
+            if (this.closed)
+                return;
+            this.handleLine(line);
+        });
+        // Log stderr
+        const stderrRl = readline.createInterface({
+            input: this.cmd.stderr,
+            terminal: false,
+        });
+        stderrRl.on("line", (line) => {
+            if (!this.closed) {
+                console.error(`[claude-code-sprites:stderr] ${line}`);
+            }
+        });
+        // Handle process exit
+        this.cmd.on("exit", (code) => {
+            console.log(`[claude-code-sprites] Process exited: code=${code} session=${this.sessionId}`);
+            if (!this.closed) {
+                const endEvent = {
+                    type: "session_end",
+                    success: code === 0,
+                    ts: ts(),
+                };
+                this.dispatchEvent(endEvent);
+            }
+        });
+    }
+    close() {
+        this.closed = true;
+        if (this.cmd) {
+            try {
+                this.cmd.kill();
+            }
+            catch {
+                // Process may already be dead
+            }
+            this.cmd = null;
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    handleLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return;
+        const events = this.parser.parse(trimmed);
+        for (const event of events) {
+            this.dispatchEvent(event);
+        }
+    }
+    dispatchEvent(event) {
+        const msg = { source: "agent", ...event };
+        this.writer.append(JSON.stringify(msg)).catch(() => { });
+        // Detect dev:start in Bash tool_use → emit app_ready 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 appReady = { type: "app_ready", ts: ts() };
+                const appReadyMsg = { source: "agent", ...appReady };
+                this.writer.append(JSON.stringify(appReadyMsg)).catch(() => { });
+                for (const cb of this.agentEventCallbacks) {
+                    try {
+                        cb(appReady);
+                    }
+                    catch {
+                        // Swallow
+                    }
+                }
+            }
+        }
+        for (const cb of this.agentEventCallbacks) {
+            try {
+                cb(event);
+            }
+            catch {
+                // Swallow callback errors
+            }
+        }
+        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
+                }
+            }
+        }
+    }
+    writeUserMessage(content) {
+        if (!this.cmd)
+            return;
+        const msg = JSON.stringify({
+            type: "user",
+            message: { role: "user", content },
+        });
+        this.cmd.stdin.write(`${msg}\n`);
+    }
+}
+//# sourceMappingURL=claude-code-sprites.js.map

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

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

package/dist/bridge/claude-md-generator.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Generates CLAUDE.md files for project workspaces.
+ *
+ * Two variants:
+ * - `generateClaudeMd()` — for Claude Code mode (streamlined, no redundant instructions)
+ * - `generateElectricAgentClaudeMd()` — for electric-agent mode (full instructions for the SDK agent)
+ */
+export interface ClaudeMdOptions {
+    /** The user's app description */
+    description: string;
+    /** Project name (kebab-case) */
+    projectName: string;
+    /** Absolute path to the project inside the sandbox */
+    projectDir: string;
+    /** Whether this is an iteration (vs initial generation) */
+    isIteration?: boolean;
+    /** Iteration request text (if isIteration) */
+    iterationRequest?: string;
+    /** Sandbox runtime — affects environment-specific instructions */
+    runtime?: "docker" | "sprites" | "daytona";
+}
+export declare function generateClaudeMd(opts: ClaudeMdOptions): string;
+export declare function generateElectricAgentClaudeMd(opts: ClaudeMdOptions): string;
+//# sourceMappingURL=claude-md-generator.d.ts.map

package/dist/bridge/claude-md-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md-generator.d.ts","sourceRoot":"","sources":["../../src/bridge/claude-md-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC/B,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAA;IAClB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,kEAAkE;IAClE,OAAO,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;CAC1C;AAMD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CA8B9D;AAMD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAoC3E"}

package/dist/bridge/claude-md-generator.js

@@ -0,0 +1,299 @@
+/**
+ * Generates CLAUDE.md files for project workspaces.
+ *
+ * Two variants:
+ * - `generateClaudeMd()` — for Claude Code mode (streamlined, no redundant instructions)
+ * - `generateElectricAgentClaudeMd()` — for electric-agent mode (full instructions for the SDK agent)
+ */
+// ---------------------------------------------------------------------------
+// Claude Code variant
+// ---------------------------------------------------------------------------
+export function generateClaudeMd(opts) {
+    const sections = [];
+    sections.push(`# ${opts.projectName}`);
+    sections.push("");
+    sections.push(PROJECT_CONTEXT);
+    sections.push("");
+    if (!opts.isIteration) {
+        sections.push("## Current Task");
+        sections.push(opts.description);
+        sections.push("");
+    }
+    sections.push(SCAFFOLD_STRUCTURE);
+    sections.push("");
+    sections.push(DRIZZLE_WORKFLOW);
+    sections.push("");
+    sections.push(GUARDRAILS);
+    sections.push("");
+    sections.push(PLAYBOOK_INSTRUCTIONS);
+    sections.push("");
+    sections.push(INFRASTRUCTURE);
+    sections.push("");
+    sections.push(devServerInstructions(opts.runtime));
+    sections.push("");
+    sections.push(SSR_RULES);
+    sections.push("");
+    return sections.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Electric Agent variant
+// ---------------------------------------------------------------------------
+export function generateElectricAgentClaudeMd(opts) {
+    const sections = [];
+    sections.push(`# ${opts.projectName}`);
+    sections.push("");
+    sections.push(PROJECT_CONTEXT);
+    sections.push("");
+    if (!opts.isIteration) {
+        sections.push("## Current Task");
+        sections.push(opts.description);
+        sections.push("");
+    }
+    sections.push(SCAFFOLD_STRUCTURE);
+    sections.push("");
+    sections.push(DRIZZLE_WORKFLOW);
+    sections.push("");
+    sections.push(GUARDRAILS);
+    sections.push("");
+    sections.push(PLAYBOOK_INSTRUCTIONS_AGENT);
+    sections.push("");
+    sections.push(BUILD_INSTRUCTIONS);
+    sections.push("");
+    sections.push(devServerInstructions(opts.runtime));
+    sections.push("");
+    sections.push(ARCHITECTURE_REFERENCE);
+    sections.push("");
+    sections.push(GIT_INSTRUCTIONS);
+    sections.push("");
+    sections.push(SSR_RULES);
+    sections.push("");
+    sections.push(ERROR_HANDLING);
+    sections.push("");
+    return sections.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Shared sections (used by both variants)
+// ---------------------------------------------------------------------------
+const PROJECT_CONTEXT = "## Project Context\nThis is a reactive, real-time application built with Electric SQL + TanStack DB + Drizzle ORM + TanStack Start.";
+const SCAFFOLD_STRUCTURE = `## Scaffold Structure (DO NOT EXPLORE)
+The project is scaffolded from a known template. DO NOT read or explore scaffold files before coding. You already know the structure:
+- src/db/schema.ts — placeholder Drizzle schema (you will overwrite)
+- src/db/zod-schemas.ts — placeholder Zod derivation (you will overwrite)
+- src/db/index.ts — Drizzle client setup (do not modify)
+- src/db/utils.ts — parseDates + generateTxId helpers (do not modify)
+- src/lib/electric-proxy.ts — Electric shape proxy helper (do not modify)
+- src/components/ClientOnly.tsx — SSR wrapper (do not modify, just import when needed)
+- src/routes/__root.tsx — root layout with SSR (do not add ssr:false here)
+- tests/helpers/schema-test-utils.ts — generateValidRow/generateRowWithout (do not modify)
+
+DO NOT use Bash/ls/find to explore the project. DO NOT read files you aren't about to modify. Start writing code.`;
+const DRIZZLE_WORKFLOW = `## Drizzle Workflow (CRITICAL)
+Always follow this order:
+1. Edit src/db/schema.ts (Drizzle pgTable definitions)
+2. Edit src/db/zod-schemas.ts (derive Zod schemas via createSelectSchema/createInsertSchema from drizzle-zod — NEVER hand-write Zod schemas — ALWAYS import z from "zod/v4" and override ALL timestamp columns with z.union([z.date(), z.string()]).default(() => new Date()) — the .default() is required so collection.insert() works without timestamps)
+3. Create collection files in src/db/collections/ (import from ../zod-schemas)
+4. Create API routes (proxy + mutation)
+5. Create UI components`;
+const GUARDRAILS = `## Guardrails (MUST FOLLOW)
+
+### Protected Files — DO NOT MODIFY
+- docker-compose.yml
+- tsconfig.json
+- biome.json
+- pnpm-lock.yaml
+- postgres.conf
+- vitest.config.ts
+- Caddyfile
+
+### Import Rules
+- Use "zod/v4" (NOT "zod") for all Zod imports
+- Use "lucide-react" for icons (NOT @radix-ui/react-icons)
+- Use "@radix-ui/themes" for Radix components (NOT @radix-ui/react-*)
+- Use "react-router" for routing (NOT react-router-dom)
+
+### Dependency Rules
+- NEVER remove existing dependencies from package.json
+- Only add new dependencies
+
+### Schema Rules
+- ALL timestamp columns MUST use: z.union([z.date(), z.string()]).default(() => new Date())
+- NEVER use z.coerce.date() — it breaks TanStack DB
+- ALL tables MUST have REPLICA IDENTITY FULL (auto-applied by migration hook)
+- UUID primary keys with defaultRandom()
+- timestamp({ withTimezone: true }) for all dates
+- snake_case for SQL table/column names
+- Foreign keys with onDelete: "cascade" where appropriate`;
+function devServerInstructions(runtime) {
+    if (runtime === "sprites" || runtime === "daytona") {
+        return `## Dev Server & Migrations
+### Dev Server
+- \`pnpm dev:start\` — start the Vite dev server in the background
+- \`pnpm dev:stop\` — stop the dev server
+- \`pnpm dev:restart\` — stop then start
+
+The app is exposed on the VITE_PORT environment variable (default: 5173).
+The database and Electric sync service are remote (cloud-hosted) — there is no local Postgres or Docker.
+
+### Migrations (CRITICAL)
+After modifying src/db/schema.ts, ALWAYS run migrations:
+\`\`\`bash
+pnpm drizzle-kit generate   # generate SQL from schema changes
+pnpm drizzle-kit migrate    # apply migration to the database
+\`\`\`
+
+### Sprites Environment Gotchas
+- npm global binaries are NOT in PATH by default. If you need to run a globally installed tool, source the profile first: \`source /etc/profile.d/npm-global.sh\`
+- Node.js is managed via nvm at \`/.sprite/languages/node/nvm/\`
+- The sandbox is a cloud micro-VM — there is no Docker, no docker-compose, no local Postgres
+- The database connection string is in DATABASE_URL (remote Neon Postgres)
+
+### Workflow
+After finishing ALL code generation: run migrations, then \`pnpm dev:start\` so the user can preview the app.`;
+    }
+    return `## Dev Server & Migrations
+### Dev Server
+- \`pnpm dev:start\` — start Vite + Postgres + Electric in the background
+- \`pnpm dev:stop\` — stop all background services
+- \`pnpm dev:restart\` — stop then start
+
+The app is exposed on the VITE_PORT environment variable (default: 5173).
+
+### Migrations (CRITICAL)
+After modifying src/db/schema.ts, ALWAYS run migrations:
+\`\`\`bash
+pnpm dev:start              # start Postgres (needed for migrate)
+pnpm drizzle-kit generate   # generate SQL from schema changes
+pnpm drizzle-kit migrate    # apply migration to the database
+\`\`\`
+
+### Workflow
+After finishing ALL code generation: run migrations, then \`pnpm dev:start\` so the user can preview the app.`;
+}
+const SSR_RULES = `## SSR Configuration (CRITICAL)
+NEVER add ssr: false to __root.tsx — it renders the HTML shell and must always SSR.
+Instead, add ssr: false to each LEAF route that uses useLiveQuery or collections.
+This is needed because useLiveQuery uses useSyncExternalStore without getServerSnapshot.`;
+// ---------------------------------------------------------------------------
+// Claude Code–only sections
+// ---------------------------------------------------------------------------
+const PLAYBOOK_INSTRUCTIONS = `## Playbooks (Domain Knowledge — MUST READ)
+Playbook SKILL.md files contain critical API usage patterns. Read them BEFORE writing code for each phase.
+
+### Available Skills
+Read with the Read tool at these exact paths:
+
+**Electric SQL** (\`node_modules/@electric-sql/playbook/skills/\`):
+- \`electric/SKILL.md\` — core Electric concepts and shape API
+- \`electric-tanstack-integration/SKILL.md\` — how Electric + TanStack DB work together (READ FIRST)
+- \`electric-quickstart/SKILL.md\` — quickstart patterns
+- \`electric-security-check/SKILL.md\` — security best practices
+- \`tanstack-start-quickstart/SKILL.md\` — TanStack Start framework patterns
+- \`deploying-electric/SKILL.md\` — deployment configuration
+- \`electric-go-live/SKILL.md\` — production checklist
+
+**TanStack DB** (\`node_modules/@tanstack/db-playbook/skills/\`):
+- \`tanstack-db/SKILL.md\` — collections, useLiveQuery, mutations (CRITICAL — read before writing any UI)
+
+**Durable Streams** (\`node_modules/@durable-streams/playbook/skills/\`):
+- \`durable-streams/SKILL.md\` — event streaming patterns
+- \`durable-state/SKILL.md\` — state management
+- \`durable-streams-dev-setup/SKILL.md\` — development setup
+
+### Reading Order
+1. \`electric-tanstack-integration/SKILL.md\` — integration rules and guardrails
+2. \`tanstack-db/SKILL.md\` — collections, queries, mutations API
+3. \`electric/SKILL.md\` — shape API for proxy routes
+4. Other skills as needed for your current phase
+
+### Important
+- ONLY read playbooks relevant to your current phase
+- Do NOT use include_references — the SKILL.md content is sufficient`;
+const INFRASTRUCTURE = `## Infrastructure (Pre-configured — DO NOT MODIFY)
+The database (Postgres) and Electric sync service are already provisioned and configured via environment variables:
+- \`DATABASE_URL\` — Postgres connection string
+- \`ELECTRIC_URL\` — Electric sync service URL
+- \`ELECTRIC_SOURCE_ID\` / \`ELECTRIC_SECRET\` — Electric Cloud auth (if using cloud mode)
+
+These are read by:
+- \`src/db/index.ts\` — Drizzle client (DO NOT MODIFY)
+- \`drizzle.config.ts\` — Drizzle Kit migrations (DO NOT MODIFY)
+- \`src/lib/electric-proxy.ts\` — Electric shape proxy for API routes (DO NOT MODIFY)
+
+You do NOT need to set up database connections or configure Electric. Just define your schema, run migrations, and write your app.`;
+// ---------------------------------------------------------------------------
+// Electric Agent–only sections
+// ---------------------------------------------------------------------------
+const PLAYBOOK_INSTRUCTIONS_AGENT = `## Playbooks (Domain Knowledge)
+Playbook skill files are available in node_modules. Read them before implementing each phase:
+
+### How to Read Playbooks
+Use the Read tool to read playbook SKILL.md files:
+- \`node_modules/@electric-sql/playbook/skills/<name>/SKILL.md\`
+- \`node_modules/@tanstack/db-playbook/skills/<name>/SKILL.md\`
+- \`node_modules/@durable-streams/playbook/skills/<name>/SKILL.md\`
+
+### Required Reading Order
+1. Read the electric-app-guardrails playbook FIRST (critical integration rules)
+2. Read "schemas" before writing Drizzle schemas
+3. Read "collections" before creating collection files
+4. Read "mutations" before creating mutation routes
+5. Read "live-queries" before creating UI with useLiveQuery
+
+### Important
+- ONLY read playbooks relevant to your current phase
+- Do NOT use include_references — the SKILL.md content is sufficient`;
+const BUILD_INSTRUCTIONS = `## Build & Test
+Run these commands to verify your work:
+- \`pnpm run build\` — TypeScript compilation
+- \`pnpm run check\` — Biome lint + format check
+- \`pnpm test\` — Run tests (if tests/ directory exists)
+
+Build only twice during initial generation: once after finishing all code, once after tests.
+During iterations, build after completing changes.`;
+const ARCHITECTURE_REFERENCE = `## Architecture Reference
+
+### Writing ARCHITECTURE.md (Initial Generation)
+After ALL tasks are complete and the build passes, write ARCHITECTURE.md in the project root as your FINAL action. This is a concise navigation index — not documentation. Keep it under 1500 tokens.
+
+Format:
+\`\`\`
+# [App Name] — Architecture Reference
+_Last updated: [ISO date]_
+
+## App Description
+[1-2 sentences]
+
+## Data Model
+### [EntityName] (\`table_name\`)
+- **Columns**: id (uuid PK), title (text), created_at (timestamptz)
+- **Relations**: [none | field → table.id cascade]
+- **Collection**: src/db/collections/[entity].ts
+
+## API Routes
+| Method | Path | File | Purpose |
+
+## UI Routes & Components
+| Route | File | Description |
+
+### Key Components
+- src/components/X.tsx — [one line: what it renders]
+
+## Styling
+- CSS files: [file: purpose]
+\`\`\`
+
+### Using ARCHITECTURE.md (Iteration Mode)
+On iterations, read ARCHITECTURE.md to understand the app structure. Use it to locate files — do NOT scan the filesystem.`;
+const GIT_INSTRUCTIONS = `## Git & GitHub CLI
+You have git and gh CLI available via Bash. Use them when needed:
+- \`git status\` / \`git diff --stat\` — check current state
+- \`git add -A && git commit -m "type(scope): description"\` — commit changes
+- \`git push -u origin main\` — push to remote
+- \`gh repo create "org/name" --private --source . --remote origin --push\` — create repo
+- \`gh pr create --title "..." --body "..."\` — create PR
+Commit types: feat, fix, refactor, style, chore, docs, test`;
+const ERROR_HANDLING = `## Error Handling
+Before fixing any error, check _agent/errors.md for previous attempts at the same fix.
+If you see the same error has failed before, try a different approach.
+After fixing an error, log the outcome.`;
+//# sourceMappingURL=claude-md-generator.js.map

package/dist/bridge/claude-md-generator.js.map

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

package/dist/bridge/index.d.ts

@@ -1,6 +1,9 @@
+export { ClaudeCodeDockerBridge, type ClaudeCodeDockerConfig } from "./claude-code-docker.js";
+export { ClaudeCodeSpritesBridge, type ClaudeCodeSpritesConfig } from "./claude-code-sprites.js";
 export { DaytonaSessionBridge } from "./daytona.js";
 export { DockerStdioBridge } from "./docker-stdio.js";
 export { HostedStreamBridge } from "./hosted.js";
 export { SpritesStdioBridge } from "./sprites.js";
+export { createStreamJsonParser } from "./stream-json-parser.js";
 export type { AgentEvent, ServerCommand, ServerGateResponse, SessionBridge, StreamMessage, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/bridge/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,YAAY,EACX,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,aAAa,GACb,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAC7F,OAAO,EAAE,uBAAuB,EAAE,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAChE,YAAY,EACX,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,aAAa,GACb,MAAM,YAAY,CAAA"}

package/dist/bridge/index.js

@@ -1,5 +1,8 @@
+export { ClaudeCodeDockerBridge } from "./claude-code-docker.js";
+export { ClaudeCodeSpritesBridge } from "./claude-code-sprites.js";
 export { DaytonaSessionBridge } from "./daytona.js";
 export { DockerStdioBridge } from "./docker-stdio.js";
 export { HostedStreamBridge } from "./hosted.js";
 export { SpritesStdioBridge } from "./sprites.js";
+export { createStreamJsonParser } from "./stream-json-parser.js";
 //# sourceMappingURL=index.js.map

package/dist/bridge/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAA+B,MAAM,yBAAyB,CAAA;AAC7F,OAAO,EAAE,uBAAuB,EAAgC,MAAM,0BAA0B,CAAA;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/bridge/stream-json-parser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Translates Claude Code `--output-format stream-json` NDJSON messages
+ * into EngineEvent arrays compatible with the existing bridge/UI pipeline.
+ *
+ * Claude Code emits lines like:
+ *   {"type":"system","subtype":"init","session_id":"...","tools":[...]}
+ *   {"type":"assistant","message":{"content":[{"type":"text","text":"..."}]}}
+ *   {"type":"user","message":{"content":[{"type":"tool_result","tool_use_id":"...","content":"..."}]}}
+ *   {"type":"result","subtype":"success","cost_usd":0.12,"num_turns":5}
+ *
+ * This parser converts each line into zero or more EngineEvent objects.
+ */
+import type { EngineEvent } from "@electric-agent/protocol";
+export interface StreamJsonParserState {
+    /** Map tool_use_id → tool_name for correlating post_tool_use events */
+    toolNames: Map<string, string>;
+    /** Accumulated cost from result messages */
+    totalCost: number;
+    /** Claude Code session ID from init */
+    sessionId: string | null;
+}
+/**
+ * Create a new stateful parser. The returned `parse` function converts
+ * a single raw JSON line from Claude Code into zero or more EngineEvents.
+ */
+export declare function createStreamJsonParser(): {
+    state: StreamJsonParserState;
+    parse(line: string): EngineEvent[];
+};
+//# sourceMappingURL=stream-json-parser.d.ts.map

package/dist/bridge/stream-json-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-json-parser.d.ts","sourceRoot":"","sources":["../../src/bridge/stream-json-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AA+D3D,MAAM,WAAW,qBAAqB;IACrC,uEAAuE;IACvE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB;;gBASxB,MAAM,GAAG,WAAW,EAAE;EAInC"}