@electric-agent/studio 1.1.1 → 1.3.0

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

@@ -14,10 +14,17 @@ export function generateClaudeMd(opts) {
     sections.push("");
     sections.push(PROJECT_CONTEXT);
     sections.push("");
+    const sandbox = sandboxEnvironment(opts.runtime);
+    if (sandbox) {
+        sections.push(sandbox);
+        sections.push("");
+    }
     if (!opts.isIteration) {
         sections.push("## Current Task");
         sections.push(opts.description);
         sections.push("");
+        sections.push(SKILL_AUTO_TRIGGER);
+        sections.push("");
     }
     sections.push(SCAFFOLD_STRUCTURE);
     sections.push("");
@@ -44,6 +51,11 @@ export function generateElectricAgentClaudeMd(opts) {
     sections.push("");
     sections.push(PROJECT_CONTEXT);
     sections.push("");
+    const sandbox = sandboxEnvironment(opts.runtime);
+    if (sandbox) {
+        sections.push(sandbox);
+        sections.push("");
+    }
     if (!opts.isIteration) {
         sections.push("## Current Task");
         sections.push(opts.description);
@@ -98,6 +110,7 @@ const GUARDRAILS = `## Guardrails (MUST FOLLOW)
 
 ### Protected Files — DO NOT MODIFY
 - docker-compose.yml
+- vite.config.ts (pre-configured with port, host, allowedHosts, and proxy — modifying it WILL break the preview)
 - tsconfig.json
 - biome.json
 - pnpm-lock.yaml
@@ -111,9 +124,6 @@ const GUARDRAILS = `## Guardrails (MUST FOLLOW)
 - Use "@radix-ui/themes" for Radix components (NOT @radix-ui/react-*)
 - Use "react-router" for routing (NOT react-router-dom)
 
-### Vite Config Rules
-- When modifying vite.config.ts, ALWAYS preserve \`server: { allowedHosts: true }\` — without it, Vite rejects connections from the proxy URL
-
 ### Dependency Rules
 - NEVER remove existing dependencies from package.json
 - Only add new dependencies
@@ -126,6 +136,35 @@ const GUARDRAILS = `## Guardrails (MUST FOLLOW)
 - timestamp({ withTimezone: true }) for all dates
 - snake_case for SQL table/column names
 - Foreign keys with onDelete: "cascade" where appropriate`;
+function sandboxEnvironment(runtime) {
+    if (runtime === "sprites" || runtime === "daytona") {
+        return `## Sandbox Environment (IMPORTANT — READ FIRST)
+You are running inside a cloud micro-VM (Fly.io Sprite). This is NOT a local machine.
+
+### Networking & Port Exposure
+- The Sprite HTTP proxy routes all external traffic to **port 8080** inside the VM
+- Your app MUST listen on port 8080 to be accessible via the preview URL — this is pre-configured via the \`VITE_PORT\` environment variable
+- The app MUST bind to \`0.0.0.0\` (not localhost) — pre-configured via \`host: true\` in vite.config.ts
+- The preview URL follows the pattern: \`https://<sprite-name>.sprites.app\`
+- There is NO way to expose other ports — only port 8080 is proxied
+
+### What's Available
+- Node.js (via nvm at \`/.sprite/languages/node/nvm/\`)
+- pnpm, git, gh CLI
+- Outbound internet access (npm install, API calls, etc.)
+- \`DATABASE_URL\` — remote Postgres (Neon), no local database
+
+### What's NOT Available
+- Docker, docker-compose, or any container runtime
+- Local Postgres or any local database
+- Ports other than 8080 for external HTTP access
+
+### PATH
+- npm global binaries are NOT in PATH by default
+- If you need a globally installed tool, source the profile first: \`source /etc/profile.d/npm-global.sh\``;
+    }
+    return "";
+}
 function devServerInstructions(runtime) {
     if (runtime === "sprites" || runtime === "daytona") {
         return `## Dev Server & Migrations
@@ -134,7 +173,7 @@ function devServerInstructions(runtime) {
 - \`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 app listens on port 8080 (set via VITE_PORT) — this is the only port the Sprite proxy exposes.
 The database and Electric sync service are remote (cloud-hosted) — there is no local Postgres or Docker.
 
 ### Migrations (CRITICAL)
@@ -144,13 +183,6 @@ 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)
-- **CRITICAL**: vite.config.ts MUST have \`server: { allowedHosts: true }\` — without it, Vite rejects connections from the proxy URL and the preview will not work
-
 ### Workflow
 After finishing ALL code generation: run migrations, then \`pnpm dev:start\` so the user can preview the app.`;
     }
@@ -180,6 +212,22 @@ This is needed because useLiveQuery uses useSyncExternalStore without getServerS
 // ---------------------------------------------------------------------------
 // Claude Code–only sections
 // ---------------------------------------------------------------------------
+const SKILL_AUTO_TRIGGER = `## App Generation Pipeline (CRITICAL)
+When building a new app, you MUST use the /create-app skill. This skill is available at .claude/skills/create-app/SKILL.md and provides the structured phased pipeline for generating Electric SQL apps.
+
+Invoke it with: /create-app <description>
+
+The skill enforces the correct phase order:
+1. Clarification (if description is vague)
+2. Plan generation (PLAN.md with data model + tasks)
+3. Data model validation (schema + zod-schemas + tests — STOP if tests fail)
+4. Collections & API routes
+5. UI components
+6. Build & lint
+7. Final tests
+8. Architecture reference (ARCHITECTURE.md)
+
+Do NOT skip phases or code ad-hoc. Always follow the skill's structured pipeline.`;
 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.
 
@@ -296,6 +344,11 @@ You have git and gh CLI available via Bash. Use them when needed:
 - \`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`;
+// ---------------------------------------------------------------------------
+// Create-app skill content — exported so the server can write it to sandboxes
+// where the npm-installed electric-agent may not include it yet.
+// ---------------------------------------------------------------------------
+export { createAppSkillContent } from "./create-app-skill.js";
 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.

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

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

package/dist/bridge/codex-docker.d.ts

@@ -0,0 +1,65 @@
+/**
+ * SessionBridge implementation that runs Codex CLI inside a Docker
+ * container via `docker exec -i`, communicating via exec --json NDJSON.
+ *
+ * The bridge translates Codex's exec --json output into EngineEvents
+ * and writes them to the Durable Stream for the UI.
+ *
+ * Codex runs in one-shot mode (`codex exec --json`) and exits after completing.
+ * On iterate (follow-up message), the bridge respawns Codex with the new prompt.
+ */
+import type { EngineEvent } from "@electric-agent/protocol";
+import type { StreamConnectionInfo } from "../streams.js";
+import type { SessionBridge } from "./types.js";
+export interface CodexDockerConfig {
+    /** Initial prompt (the user's app description or task) */
+    prompt: string;
+    /** Working directory inside the container */
+    cwd: string;
+    /** Model to use (default: o4-mini) */
+    model?: string;
+    /** Additional CLI flags */
+    extraFlags?: string[];
+}
+export declare class CodexDockerBridge implements SessionBridge {
+    readonly sessionId: string;
+    readonly streamUrl: string;
+    readonly streamHeaders: Record<string, string>;
+    private containerId;
+    private config;
+    private writer;
+    private parser;
+    private agentEventCallbacks;
+    private completeCallbacks;
+    private closed;
+    private proc;
+    /** Codex thread ID captured from thread.started — used for resume */
+    private codexThreadId;
+    /** Whether a Codex process is currently running */
+    private running;
+    /** Whether the parser already emitted a session_end */
+    private resultReceived;
+    constructor(sessionId: string, connection: StreamConnectionInfo, containerId: string, config: CodexDockerConfig);
+    emit(event: EngineEvent): Promise<void>;
+    /**
+     * Send a follow-up user message to Codex by respawning with a new prompt.
+     */
+    sendCommand(cmd: Record<string, unknown>): Promise<void>;
+    /**
+     * Send a gate response. Codex exec mode doesn't support stdin interaction,
+     * so gate responses are limited.
+     */
+    sendGateResponse(_gate: string, _value: Record<string, unknown>): Promise<void>;
+    onAgentEvent(cb: (event: EngineEvent) => void): void;
+    onComplete(cb: (success: boolean) => void): void;
+    start(): Promise<void>;
+    close(): void;
+    /**
+     * Spawn a new Codex process. Called for both the initial prompt
+     * and follow-up iterate messages.
+     */
+    private spawnCodex;
+    private handleLine;
+    private dispatchEvent;
+}
+//# sourceMappingURL=codex-docker.d.ts.map

package/dist/bridge/codex-docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-docker.d.ts","sourceRoot":"","sources":["../../src/bridge/codex-docker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAA;AAE9D,MAAM,WAAW,iBAAiB;IACjC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,qBAAa,iBAAkB,YAAW,aAAa;IACtD,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,CAAmB;IACjC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,mBAAmB,CAA0C;IACrE,OAAO,CAAC,iBAAiB,CAAwC;IACjE,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,IAAI,CAA4B;IAExC,qEAAqE;IACrE,OAAO,CAAC,aAAa,CAAsB;IAC3C,mDAAmD;IACnD,OAAO,CAAC,OAAO,CAAQ;IACvB,uDAAuD;IACvD,OAAO,CAAC,cAAc,CAAQ;gBAG7B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,oBAAoB,EAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB;IAepB,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9D;;;OAGG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrF,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,KAAK,IAAI,IAAI;IAiBb;;;OAGG;IACH,OAAO,CAAC,UAAU;IAgGlB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,aAAa;CAgDrB"}

package/dist/bridge/codex-docker.js

@@ -0,0 +1,242 @@
+/**
+ * SessionBridge implementation that runs Codex CLI inside a Docker
+ * container via `docker exec -i`, communicating via exec --json NDJSON.
+ *
+ * The bridge translates Codex's exec --json output into EngineEvents
+ * and writes them to the Durable Stream for the UI.
+ *
+ * Codex runs in one-shot mode (`codex exec --json`) and exits after completing.
+ * On iterate (follow-up message), the bridge respawns Codex with the new prompt.
+ */
+import { spawn } from "node:child_process";
+import * as readline from "node:readline";
+import { DurableStream } from "@durable-streams/client";
+import { ts } from "@electric-agent/protocol";
+import { createCodexJsonParser } from "./codex-json-parser.js";
+export class CodexDockerBridge {
+    sessionId;
+    streamUrl;
+    streamHeaders;
+    containerId;
+    config;
+    writer;
+    parser = createCodexJsonParser();
+    agentEventCallbacks = [];
+    completeCallbacks = [];
+    closed = false;
+    proc = null;
+    /** Codex thread ID captured from thread.started — used for resume */
+    codexThreadId = null;
+    /** Whether a Codex process is currently running */
+    running = false;
+    /** Whether the parser already emitted a session_end */
+    resultReceived = false;
+    constructor(sessionId, connection, containerId, config) {
+        this.sessionId = sessionId;
+        this.streamUrl = connection.url;
+        this.streamHeaders = connection.headers;
+        this.containerId = containerId;
+        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));
+    }
+    /**
+     * Send a follow-up user message to Codex by respawning with a new prompt.
+     */
+    async sendCommand(cmd) {
+        if (this.closed)
+            return;
+        if (cmd.command === "iterate" && typeof cmd.request === "string") {
+            this.spawnCodex(cmd.request);
+            return;
+        }
+        console.log(`[codex-docker] Ignoring unsupported command: ${cmd.command}`);
+    }
+    /**
+     * Send a gate response. Codex exec mode doesn't support stdin interaction,
+     * so gate responses are limited.
+     */
+    async sendGateResponse(_gate, _value) {
+        // Codex exec --json doesn't support stdin user messages mid-run
+    }
+    onAgentEvent(cb) {
+        this.agentEventCallbacks.push(cb);
+    }
+    onComplete(cb) {
+        this.completeCallbacks.push(cb);
+    }
+    async start() {
+        if (this.closed)
+            return;
+        this.spawnCodex(this.config.prompt);
+    }
+    close() {
+        this.closed = true;
+        if (this.proc) {
+            try {
+                this.proc.stdin?.end();
+                this.proc.kill("SIGTERM");
+            }
+            catch {
+                // Process may already be dead
+            }
+            this.proc = null;
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    /**
+     * Spawn a new Codex process. Called for both the initial prompt
+     * and follow-up iterate messages.
+     */
+    spawnCodex(prompt) {
+        // Kill any existing process
+        if (this.proc) {
+            try {
+                this.proc.stdin?.end();
+                this.proc.kill("SIGTERM");
+            }
+            catch {
+                // Already dead
+            }
+            this.proc = null;
+        }
+        // Reset parser state for the new process
+        this.parser = createCodexJsonParser();
+        this.resultReceived = false;
+        this.running = true;
+        const model = this.config.model ?? "o4-mini";
+        // Build the codex CLI command
+        const codexArgs = [
+            "exec",
+            "--json",
+            "--full-auto",
+            "--model",
+            model,
+            ...(this.config.extraFlags ?? []),
+            "-q",
+            prompt,
+        ];
+        // Escape for bash
+        const escapedArgs = codexArgs.map((a) => `'${a.replace(/'/g, "'\\''")}'`).join(" ");
+        const cmd = `cd '${this.config.cwd}' && codex ${escapedArgs}`;
+        this.proc = spawn("docker", ["exec", this.containerId, "bash", "-c", cmd], {
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        console.log(`[codex-docker] Started: session=${this.sessionId} container=${this.containerId} pid=${this.proc.pid}`);
+        console.log(`[codex-docker] cmd: ${cmd}`);
+        const currentProc = this.proc;
+        // Read stdout line by line (exec --json NDJSON)
+        if (currentProc.stdout) {
+            const rl = readline.createInterface({
+                input: currentProc.stdout,
+                terminal: false,
+            });
+            rl.on("line", (line) => {
+                if (this.closed)
+                    return;
+                console.log(`[codex-docker:stdout] ${line.slice(0, 120)}...`);
+                this.handleLine(line);
+            });
+        }
+        // Log stderr
+        if (currentProc.stderr) {
+            const stderrRl = readline.createInterface({
+                input: currentProc.stderr,
+                terminal: false,
+            });
+            stderrRl.on("line", (line) => {
+                if (!this.closed) {
+                    console.error(`[codex-docker:stderr] ${line}`);
+                }
+            });
+        }
+        // Handle process exit — defer to let pending readline events flush first
+        currentProc.on("exit", (code) => {
+            console.log(`[codex-docker] Process exited: code=${code} session=${this.sessionId}`);
+            setTimeout(() => {
+                // Capture thread ID from parser state before marking not running
+                if (this.parser.state.threadId) {
+                    this.codexThreadId = this.parser.state.threadId;
+                }
+                this.running = false;
+                // Emit session_end if the parser didn't already
+                if (!this.closed && !this.resultReceived) {
+                    const endEvent = {
+                        type: "session_end",
+                        success: code === 0,
+                        ts: ts(),
+                    };
+                    this.dispatchEvent(endEvent);
+                }
+            }, 100);
+        });
+    }
+    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) {
+        // Write to Durable Stream for UI
+        const msg = { source: "agent", ...event };
+        this.writer.append(JSON.stringify(msg)).catch(() => { });
+        // Track session_end to prevent duplicates
+        if (event.type === "session_end") {
+            this.resultReceived = true;
+        }
+        // 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
+                    }
+                }
+            }
+        }
+        // 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
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=codex-docker.js.map

package/dist/bridge/codex-docker.js.map

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

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

@@ -0,0 +1,31 @@
+/**
+ * Translates Codex CLI `codex exec --json` NDJSON messages
+ * into EngineEvent arrays compatible with the existing bridge/UI pipeline.
+ *
+ * Codex exec --json emits lines like:
+ *   {"type":"thread.started","thread_id":"..."}
+ *   {"type":"item.started","item":{"type":"command_execution","id":"...","command":"..."}}
+ *   {"type":"item.completed","item":{"type":"agent_message","id":"...","content":"..."}}
+ *   {"type":"turn.completed","usage":{"input_tokens":100,"output_tokens":50}}
+ *   {"type":"turn.failed","error":"..."}
+ *
+ * This parser converts each line into zero or more EngineEvent objects.
+ */
+import type { EngineEvent } from "@electric-agent/protocol";
+export interface CodexJsonParserState {
+    /** Map item ID → tool name for correlating started/completed events */
+    toolNames: Map<string, string>;
+    /** Accumulated cost from turn.completed messages */
+    totalCost: number;
+    /** Codex thread ID from thread.started */
+    threadId: string | null;
+}
+/**
+ * Create a new stateful parser. The returned `parse` function converts
+ * a single raw JSON line from Codex into zero or more EngineEvents.
+ */
+export declare function createCodexJsonParser(): {
+    state: CodexJsonParserState;
+    parse(line: string): EngineEvent[];
+};
+//# sourceMappingURL=codex-json-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-json-parser.d.ts","sourceRoot":"","sources":["../../src/bridge/codex-json-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AA+F3D,MAAM,WAAW,oBAAoB;IACpC,uEAAuE;IACvE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB;;gBASvB,MAAM,GAAG,WAAW,EAAE;EAInC"}