@electric-agent/studio 1.0.0

package/dist/sandbox/docker.js

@@ -0,0 +1,465 @@
+import { execFileSync, execSync } from "node:child_process";
+import fs from "node:fs";
+import net from "node:net";
+import os from "node:os";
+import path from "node:path";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const SANDBOX_IMAGE = "electric-agent-sandbox";
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            if (addr && typeof addr === "object") {
+                const port = addr.port;
+                server.close(() => resolve(port));
+            }
+            else {
+                server.close(() => reject(new Error("Could not determine free port")));
+            }
+        });
+        server.on("error", reject);
+    });
+}
+function resolveAuthEnv(opts) {
+    if (opts?.apiKey)
+        return ["ANTHROPIC_API_KEY", opts.apiKey];
+    if (opts?.oauthToken)
+        return ["CLAUDE_CODE_OAUTH_TOKEN", opts.oauthToken];
+    return null;
+}
+function generateComposeFile(port, auth, infra = { mode: "local" }, streamEnv = {}, deferAgentStart = false, ghToken) {
+    const isCloud = infra.mode === "cloud";
+    const agentEnv = [
+        `DATABASE_URL=${isCloud ? infra.databaseUrl : "postgresql://postgres:password@postgres:5432/electric"}`,
+        `ELECTRIC_URL=${isCloud ? infra.electricUrl : "http://electric:3000"}`,
+        "VITE_PORT=5173",
+        "SANDBOX_MODE=1",
+    ];
+    if (isCloud) {
+        agentEnv.push(`ELECTRIC_SOURCE_ID=${infra.sourceId}`);
+        agentEnv.push(`ELECTRIC_SECRET=${infra.secret}`);
+    }
+    if (auth) {
+        agentEnv.push(`${auth[0]}=${auth[1]}`);
+    }
+    if (ghToken) {
+        agentEnv.push(`GH_TOKEN=${ghToken}`);
+    }
+    // Add stream env vars for hosted Durable Streams communication
+    for (const [key, value] of Object.entries(streamEnv)) {
+        agentEnv.push(`${key}=${value}`);
+    }
+    const agentEnvYaml = agentEnv.map((e) => `      - ${e}`).join("\n");
+    // When deferAgentStart is true, keep the container alive without starting the agent.
+    // The bridge will start the agent via `docker exec -i`.
+    const agentCommand = deferAgentStart
+        ? '["tail", "-f", "/dev/null"]'
+        : '["electric-agent", "headless"]';
+    if (isCloud) {
+        return `services:
+  agent:
+    image: ${SANDBOX_IMAGE}
+    ports:
+      - "${port}:5173"
+    environment:
+${agentEnvYaml}
+    volumes:
+      - workspace:/home/agent/workspace
+    stdin_open: true
+    command: ${agentCommand}
+
+volumes:
+  workspace:
+`;
+    }
+    return `services:
+  postgres:
+    image: postgres:17
+    environment:
+      POSTGRES_DB: electric
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: password
+    command: postgres -c wal_level=logical -c max_replication_slots=10 -c max_wal_senders=10
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 2s
+      timeout: 5s
+      retries: 10
+
+  electric:
+    image: electricsql/electric:latest
+    environment:
+      DATABASE_URL: postgresql://postgres:password@postgres:5432/electric
+      ELECTRIC_INSECURE: "true"
+    depends_on:
+      postgres:
+        condition: service_healthy
+
+  agent:
+    image: ${SANDBOX_IMAGE}
+    ports:
+      - "${port}:5173"
+    environment:
+${agentEnvYaml}
+    volumes:
+      - workspace:/home/agent/workspace
+    depends_on:
+      electric:
+        condition: service_started
+    stdin_open: true
+    command: ${agentCommand}
+
+volumes:
+  workspace:
+`;
+}
+async function waitForElectric(project, composePath) {
+    const start = Date.now();
+    while (Date.now() - start < 60_000) {
+        try {
+            execSync(`docker compose -p ${project} -f ${composePath} exec -T electric curl -sf http://localhost:3000/v1/health`, { stdio: "ignore", timeout: 3000 });
+            return;
+        }
+        catch {
+            // Not ready yet
+        }
+        await new Promise((r) => setTimeout(r, 1000));
+    }
+    throw new Error("Electric did not become healthy in time");
+}
+function getAgentContainerId(state) {
+    try {
+        const composePath = path.join(state.composeDir, "docker-compose.yml");
+        const id = execFileSync("docker", ["compose", "-p", state.composeProject, "-f", composePath, "ps", "-q", "agent"], { encoding: "utf-8", timeout: 5000, stdio: ["ignore", "pipe", "ignore"] }).trim();
+        return id || null;
+    }
+    catch {
+        return null;
+    }
+}
+function execInContainer(state, command, opts) {
+    const containerId = getAgentContainerId(state);
+    if (!containerId)
+        throw new Error("No running container");
+    return execFileSync("docker", ["exec", containerId, "sh", "-c", command], {
+        encoding: "utf-8",
+        timeout: opts?.timeout ?? 30_000,
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+}
+// ---------------------------------------------------------------------------
+// DockerSandboxProvider
+// ---------------------------------------------------------------------------
+export class DockerSandboxProvider {
+    runtime = "docker";
+    activeContainers = new Map();
+    internalState = new Map();
+    getState(handle) {
+        const state = this.internalState.get(handle.sessionId);
+        if (!state)
+            throw new Error(`No internal state for session ${handle.sessionId}`);
+        return state;
+    }
+    async create(sessionId, opts) {
+        const port = await findFreePort();
+        const slug = (opts?.projectName || sessionId.slice(0, 8))
+            .replace(/[^a-z0-9-]/gi, "-")
+            .toLowerCase();
+        const project = `ea-${slug}`;
+        const infra = opts?.infra ?? { mode: "local" };
+        console.log(`[docker] Creating sandbox: session=${sessionId} project=${project} port=${port} infra=${infra.mode}`);
+        const composeDir = fs.mkdtempSync(path.join(os.tmpdir(), `${project}-`));
+        const composePath = path.join(composeDir, "docker-compose.yml");
+        const auth = resolveAuthEnv(opts);
+        fs.writeFileSync(composePath, generateComposeFile(port, auth, infra, opts?.streamEnv ?? {}, opts?.deferAgentStart, opts?.ghToken), "utf-8");
+        console.log(`[docker] Compose file written: ${composePath}`);
+        if (infra.mode === "local") {
+            console.log(`[docker] Starting postgres + electric...`);
+            execSync(`docker compose -p ${project} -f ${composePath} up -d postgres electric`, {
+                stdio: "pipe",
+                timeout: 120_000,
+            });
+            await waitForElectric(project, composePath);
+            console.log(`[docker] Electric is ready`);
+        }
+        // Start the agent service in detached mode — it communicates via the durable stream
+        console.log(`[docker] Starting agent container...`);
+        execSync(`docker compose -p ${project} -f ${composePath} up -d agent`, {
+            stdio: "pipe",
+            timeout: 60_000,
+        });
+        console.log(`[docker] Agent container started`);
+        const handle = {
+            sessionId,
+            runtime: "docker",
+            port,
+            projectDir: `/home/agent/workspace/${opts?.projectName || sessionId.slice(0, 8)}`,
+        };
+        const state = {
+            composeDir,
+            composeProject: project,
+        };
+        this.activeContainers.set(sessionId, handle);
+        this.internalState.set(sessionId, state);
+        return handle;
+    }
+    async destroy(handle) {
+        const state = this.internalState.get(handle.sessionId);
+        this.activeContainers.delete(handle.sessionId);
+        this.internalState.delete(handle.sessionId);
+        if (!state)
+            return;
+        const composePath = path.join(state.composeDir, "docker-compose.yml");
+        try {
+            execSync(`docker compose -p ${state.composeProject} -f ${composePath} down -v --remove-orphans`, { stdio: "ignore", timeout: 30_000 });
+        }
+        catch {
+            // Best effort
+        }
+        setTimeout(() => {
+            fs.rm(state.composeDir, { recursive: true, force: true }, () => { });
+        }, 5000);
+    }
+    async restartAgent(handle) {
+        const state = this.internalState.get(handle.sessionId);
+        if (!state) {
+            throw new Error("No active container for session");
+        }
+        const composePath = path.join(state.composeDir, "docker-compose.yml");
+        // Stop and restart the agent service
+        try {
+            execSync(`docker compose -p ${state.composeProject} -f ${composePath} stop agent`, {
+                stdio: "ignore",
+                timeout: 15_000,
+            });
+        }
+        catch {
+            // May already be stopped
+        }
+        execSync(`docker compose -p ${state.composeProject} -f ${composePath} up -d agent`, {
+            stdio: "pipe",
+            timeout: 60_000,
+        });
+        const newHandle = {
+            sessionId: handle.sessionId,
+            runtime: "docker",
+            port: handle.port,
+            projectDir: handle.projectDir,
+        };
+        this.activeContainers.set(handle.sessionId, newHandle);
+        return newHandle;
+    }
+    /** Get the Docker container ID for a session's agent service */
+    getContainerId(sessionId) {
+        const state = this.internalState.get(sessionId);
+        if (!state)
+            return null;
+        return getAgentContainerId(state);
+    }
+    get(sessionId) {
+        return this.activeContainers.get(sessionId);
+    }
+    list() {
+        return [...this.activeContainers.values()];
+    }
+    isAlive(handle) {
+        const state = this.internalState.get(handle.sessionId);
+        if (!state)
+            return false;
+        const containerId = getAgentContainerId(state);
+        return containerId !== null;
+    }
+    async exec(handle, command) {
+        const state = this.getState(handle);
+        return execInContainer(state, command).trim();
+    }
+    async listFiles(handle, dir) {
+        const state = this.internalState.get(handle.sessionId);
+        if (!state)
+            return [];
+        const containerId = getAgentContainerId(state);
+        if (!containerId)
+            return [];
+        try {
+            const output = execFileSync("docker", [
+                "exec",
+                containerId,
+                "find",
+                dir,
+                "-type",
+                "f",
+                "-not",
+                "-path",
+                "*/node_modules/*",
+                "-not",
+                "-path",
+                "*/.git/*",
+                "-not",
+                "-path",
+                "*/dist/*",
+                "-not",
+                "-path",
+                "*/.next/*",
+                "-not",
+                "-path",
+                "*/.cache/*",
+                "-not",
+                "-path",
+                "*/.electric/*",
+                "-not",
+                "-name",
+                "pnpm-lock.yaml",
+                "-not",
+                "-name",
+                "package-lock.json",
+            ], { encoding: "utf-8", timeout: 10_000, stdio: ["ignore", "pipe", "ignore"] });
+            return output
+                .split("\n")
+                .map((l) => l.trim())
+                .filter(Boolean);
+        }
+        catch {
+            return [];
+        }
+    }
+    async readFile(handle, filePath) {
+        const state = this.internalState.get(handle.sessionId);
+        if (!state)
+            return null;
+        const containerId = getAgentContainerId(state);
+        if (!containerId)
+            return null;
+        try {
+            return execFileSync("docker", ["exec", containerId, "cat", filePath], {
+                encoding: "utf-8",
+                timeout: 5_000,
+                stdio: ["ignore", "pipe", "ignore"],
+            });
+        }
+        catch {
+            return null;
+        }
+    }
+    async startApp(handle) {
+        const state = this.internalState.get(handle.sessionId);
+        if (!state)
+            return false;
+        const containerId = getAgentContainerId(state);
+        if (!containerId)
+            return false;
+        try {
+            execFileSync("docker", ["exec", containerId, "sh", "-c", "cd /home/agent/workspace/*/ && pnpm dev:start"], { timeout: 10_000, stdio: "ignore" });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async stopApp(handle) {
+        const state = this.internalState.get(handle.sessionId);
+        if (!state)
+            return false;
+        const containerId = getAgentContainerId(state);
+        if (!containerId)
+            return false;
+        try {
+            execFileSync("docker", ["exec", containerId, "sh", "-c", "cd /home/agent/workspace/*/ && pnpm dev:stop"], { timeout: 5000, stdio: "ignore" });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async isAppRunning(handle) {
+        const state = this.internalState.get(handle.sessionId);
+        if (!state)
+            return false;
+        const containerId = getAgentContainerId(state);
+        if (!containerId)
+            return false;
+        try {
+            execFileSync("docker", [
+                "exec",
+                containerId,
+                "sh",
+                "-c",
+                "kill -0 $(cat /tmp/dev-server.pid 2>/dev/null) 2>/dev/null",
+            ], { timeout: 5000, stdio: "ignore" });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async gitStatus(handle, projectDir) {
+        const state = this.internalState.get(handle.sessionId);
+        if (!state) {
+            return {
+                initialized: false,
+                branch: null,
+                hasUncommitted: false,
+                lastCommitHash: null,
+                lastCommitMessage: null,
+            };
+        }
+        try {
+            const output = execInContainer(state, `cd ${projectDir} && test -d .git && echo "GIT_INIT=yes" || echo "GIT_INIT=no"`);
+            if (!output.includes("GIT_INIT=yes")) {
+                return {
+                    initialized: false,
+                    branch: null,
+                    hasUncommitted: false,
+                    lastCommitHash: null,
+                    lastCommitMessage: null,
+                };
+            }
+            const branch = execInContainer(state, `cd ${projectDir} && git rev-parse --abbrev-ref HEAD 2>/dev/null || echo ""`).trim();
+            const hash = execInContainer(state, `cd ${projectDir} && git rev-parse HEAD 2>/dev/null || echo ""`).trim();
+            const message = execInContainer(state, `cd ${projectDir} && git log -1 --format=%s 2>/dev/null || echo ""`).trim();
+            const statusOutput = execInContainer(state, `cd ${projectDir} && git status --porcelain 2>/dev/null || echo ""`).trim();
+            return {
+                initialized: true,
+                branch: branch || null,
+                hasUncommitted: statusOutput.length > 0,
+                lastCommitHash: hash || null,
+                lastCommitMessage: message || null,
+            };
+        }
+        catch {
+            return {
+                initialized: false,
+                branch: null,
+                hasUncommitted: false,
+                lastCommitHash: null,
+                lastCommitMessage: null,
+            };
+        }
+    }
+    async createFromRepo(sessionId, repoUrl, opts) {
+        const repoName = repoUrl
+            .split("/")
+            .pop()
+            ?.replace(/\.git$/, "") || "resumed-project";
+        const handle = await this.create(sessionId, {
+            apiKey: opts?.apiKey,
+            oauthToken: opts?.oauthToken,
+            ghToken: opts?.ghToken,
+            projectName: repoName,
+        });
+        const state = this.getState(handle);
+        const targetDir = `/home/agent/workspace/${repoName}`;
+        execInContainer(state, `gh repo clone "${repoUrl}" "${targetDir}" 2>/dev/null || git clone "${repoUrl}" "${targetDir}"`, { timeout: 60_000 });
+        if (opts?.branch) {
+            execInContainer(state, `cd ${targetDir} && git checkout ${opts.branch}`);
+        }
+        handle.projectDir = targetDir;
+        return handle;
+    }
+}
+//# sourceMappingURL=docker.js.map

package/dist/sandbox/docker.js.map

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

package/dist/sandbox/index.d.ts

@@ -0,0 +1,5 @@
+export { DaytonaSandboxProvider } from "./daytona.js";
+export { DockerSandboxProvider } from "./docker.js";
+export { SpritesSandboxProvider } from "./sprites.js";
+export type { CreateSandboxOpts, GitStatus, InfraConfig, SandboxHandle, SandboxProvider, SandboxRuntime, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AACrD,YAAY,EACX,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,GACd,MAAM,YAAY,CAAA"}

package/dist/sandbox/index.js

@@ -0,0 +1,4 @@
+export { DaytonaSandboxProvider } from "./daytona.js";
+export { DockerSandboxProvider } from "./docker.js";
+export { SpritesSandboxProvider } from "./sprites.js";
+//# sourceMappingURL=index.js.map

package/dist/sandbox/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA"}

package/dist/sandbox/sprites-bootstrap.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Bootstrap logic for Sprites sandboxes.
+ *
+ * Sprites run Ubuntu 24.04 with Node.js pre-installed but no project tooling.
+ * This module installs the required tools (pnpm, electric-agent) and creates
+ * a checkpoint so subsequent sprites can restore instantly.
+ */
+import type { Sprite } from "@fly/sprites";
+export interface BootstrapOptions {
+    /** Custom package URL (e.g. pkg-pr-new preview) to install instead of the published electric-agent */
+    packageUrl?: string;
+}
+/**
+ * Bootstrap a sprite by installing required global tools.
+ * This runs inside a freshly-created sprite that has Node.js but nothing else.
+ */
+export declare function bootstrapSprite(sprite: Sprite, opts?: BootstrapOptions): Promise<void>;
+/**
+ * Ensure the sprite is bootstrapped. If a matching checkpoint exists,
+ * restore from it. Otherwise, run the full bootstrap and create a checkpoint.
+ *
+ * When a custom packageUrl is provided (e.g. PR preview), the checkpoint
+ * comment includes a hash of the URL so different versions don't collide.
+ */
+export declare function ensureBootstrapped(sprite: Sprite, opts?: BootstrapOptions): Promise<void>;
+//# sourceMappingURL=sprites-bootstrap.d.ts.map

package/dist/sandbox/sprites-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprites-bootstrap.d.ts","sourceRoot":"","sources":["../../src/sandbox/sprites-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAO1C,MAAM,WAAW,gBAAgB;IAChC,sGAAsG;IACtG,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoD5F;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC/F"}

package/dist/sandbox/sprites-bootstrap.js

@@ -0,0 +1,127 @@
+/**
+ * Bootstrap logic for Sprites sandboxes.
+ *
+ * Sprites run Ubuntu 24.04 with Node.js pre-installed but no project tooling.
+ * This module installs the required tools (pnpm, electric-agent) and creates
+ * a checkpoint so subsequent sprites can restore instantly.
+ */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const { version } = require("../../package.json");
+const CHECKPOINT_COMMENT = `bootstrapped:${version}`;
+/**
+ * Bootstrap a sprite by installing required global tools.
+ * This runs inside a freshly-created sprite that has Node.js but nothing else.
+ */
+export async function bootstrapSprite(sprite, opts) {
+    const packageSpec = opts?.packageUrl ?? "electric-agent";
+    console.log(`[sprites-bootstrap] Installing pnpm...`);
+    await sprite.exec("npm install -g pnpm", { maxBuffer: 50 * 1024 * 1024 });
+    console.log(`[sprites-bootstrap] Installing electric-agent from: ${packageSpec}`);
+    await sprite.execFile("bash", [
+        "-c",
+        `source /etc/profile.d/npm-global.sh 2>/dev/null; npm install -g ${packageSpec}`,
+    ]);
+    // Create the workspace directory structure matching other runtimes
+    await sprite.exec("mkdir -p /home/agent/workspace");
+    // Write a profile script that adds npm global bin and nvm paths to PATH.
+    // Sprites use nvm-managed Node.js — the bin dir isn't in the default PATH
+    // when running commands via sprite.execFile("bash", ["-c", ...]).
+    await sprite.execFile("bash", [
+        "-c",
+        [
+            // Source nvm if present (sets up node/npm/npx in PATH)
+            'export NVM_DIR="/.sprite/languages/node/nvm"',
+            '[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"',
+            // Get the npm global bin path and write it to a profile script
+            'NPM_BIN="$(npm config get prefix)/bin"',
+            'echo "export PATH=\\"$NPM_BIN:\\$PATH\\"" > /etc/profile.d/npm-global.sh',
+            // Also add nvm init to the profile so node/npm are always available
+            'echo "export NVM_DIR=\\"/.sprite/languages/node/nvm\\"" >> /etc/profile.d/npm-global.sh',
+            'echo "[ -s \\"\\$NVM_DIR/nvm.sh\\" ] && . \\"\\$NVM_DIR/nvm.sh\\"" >> /etc/profile.d/npm-global.sh',
+        ].join(" && "),
+    ]);
+    // Configure git (needed for the git agent)
+    // Use execFile to avoid sprite.exec() splitting quoted args by whitespace
+    await sprite.execFile("git", ["config", "--global", "user.name", "electric-agent"]);
+    await sprite.execFile("git", ["config", "--global", "user.email", "agent@electric-sql.com"]);
+    await sprite.execFile("git", ["config", "--global", "init.defaultBranch", "main"]);
+    // Configure gh as the git credential helper so `git push` authenticates
+    // via GH_TOKEN. Without this, HTTPS pushes fail in the sandbox because
+    // there's no interactive terminal for git to prompt for credentials.
+    // Note: gh auth setup-git only writes the credential.helper config —
+    // it doesn't need GH_TOKEN at this point. The token is read at push time.
+    await sprite.execFile("git", [
+        "config",
+        "--global",
+        "credential.helper",
+        "!gh auth git-credential",
+    ]);
+    console.log(`[sprites-bootstrap] Bootstrap complete (electric-agent@${version})`);
+}
+/**
+ * Ensure the sprite is bootstrapped. If a matching checkpoint exists,
+ * restore from it. Otherwise, run the full bootstrap and create a checkpoint.
+ *
+ * When a custom packageUrl is provided (e.g. PR preview), the checkpoint
+ * comment includes a hash of the URL so different versions don't collide.
+ */
+export async function ensureBootstrapped(sprite, opts) {
+    const comment = opts?.packageUrl
+        ? `${CHECKPOINT_COMMENT}:${shortHash(opts.packageUrl)}`
+        : CHECKPOINT_COMMENT;
+    // Check for existing checkpoint
+    try {
+        const checkpoints = await sprite.listCheckpoints();
+        const bootstrapped = checkpoints.find((cp) => cp.comment === comment);
+        if (bootstrapped) {
+            console.log(`[sprites-bootstrap] Restoring from checkpoint "${bootstrapped.id}" (electric-agent@${version})`);
+            const response = await sprite.restoreCheckpoint(bootstrapped.id);
+            // Consume the NDJSON response stream to completion
+            await consumeStream(response);
+            console.log(`[sprites-bootstrap] Restored from checkpoint`);
+            return;
+        }
+    }
+    catch {
+        // No checkpoints yet — proceed with bootstrap
+    }
+    // Run full bootstrap
+    await bootstrapSprite(sprite, opts);
+    // Create checkpoint for future reuse
+    console.log(`[sprites-bootstrap] Creating checkpoint...`);
+    try {
+        const response = await sprite.createCheckpoint(comment);
+        await consumeStream(response);
+        console.log(`[sprites-bootstrap] Checkpoint created`);
+    }
+    catch (err) {
+        // Non-fatal — next creation will just bootstrap again
+        console.warn(`[sprites-bootstrap] Failed to create checkpoint:`, err);
+    }
+}
+/** Consume a streaming Response body to completion */
+async function consumeStream(response) {
+    if (!response.body)
+        return;
+    const reader = response.body.getReader();
+    try {
+        while (true) {
+            const { done } = await reader.read();
+            if (done)
+                break;
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+/** Simple string hash for checkpoint disambiguation */
+function shortHash(input) {
+    let hash = 0;
+    for (let i = 0; i < input.length; i++) {
+        hash = ((hash << 5) - hash + input.charCodeAt(i)) | 0;
+    }
+    return (hash >>> 0).toString(36);
+}
+//# sourceMappingURL=sprites-bootstrap.js.map