@electric-agent/studio 1.0.0

package/dist/sandbox/sprites-bootstrap.js.map

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

package/dist/sandbox/sprites.d.ts

@@ -0,0 +1,55 @@
+import { type Sprite } from "@fly/sprites";
+import type { CreateSandboxOpts, GitStatus, SandboxHandle, SandboxProvider } from "./types.js";
+export declare class SpritesSandboxProvider implements SandboxProvider {
+    readonly runtime: "sprites";
+    private client;
+    private token;
+    private baseURL;
+    private handles;
+    private sprites;
+    constructor(opts?: {
+        token?: string;
+        region?: string;
+        ramMB?: number;
+        cpus?: number;
+    });
+    private getSprite;
+    /**
+     * Fetch the public URL for a sprite from the REST API.
+     * The URL includes an org slug suffix that we can't derive locally.
+     */
+    private getSpriteUrl;
+    /**
+     * Set network policy to allow all outbound connections.
+     * The JS SDK doesn't expose this yet, so we call the REST API directly.
+     */
+    private setNetworkPolicyAllowAll;
+    create(sessionId: string, opts?: CreateSandboxOpts): Promise<SandboxHandle>;
+    destroy(handle: SandboxHandle): Promise<void>;
+    restartAgent(handle: SandboxHandle): Promise<SandboxHandle>;
+    /**
+     * Launch the headless agent process in the sprite without blocking.
+     * Uses spawn() (event-based API) instead of execFile() which waits for exit.
+     */
+    startAgent(handle: SandboxHandle): Promise<void>;
+    /** Get the underlying Sprite SDK object for bridge communication */
+    getSpriteObject(sessionId: string): Sprite | undefined;
+    get(sessionId: string): SandboxHandle | undefined;
+    list(): SandboxHandle[];
+    isAlive(handle: SandboxHandle): boolean;
+    exec(handle: SandboxHandle, command: string): Promise<string>;
+    listFiles(handle: SandboxHandle, dir: string): Promise<string[]>;
+    readFile(handle: SandboxHandle, filePath: string): Promise<string | null>;
+    startApp(handle: SandboxHandle): Promise<boolean>;
+    stopApp(handle: SandboxHandle): Promise<boolean>;
+    isAppRunning(handle: SandboxHandle): Promise<boolean>;
+    gitStatus(handle: SandboxHandle, projectDir: string): Promise<GitStatus>;
+    getPreviewUrl(handle: SandboxHandle, _port: number): Promise<string | null>;
+    createFromRepo(sessionId: string, repoUrl: string, opts?: {
+        branch?: string;
+        apiKey?: string;
+        oauthToken?: string;
+        ghToken?: string;
+    }): Promise<SandboxHandle>;
+}
+//# sourceMappingURL=sprites.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sprites.d.ts","sourceRoot":"","sources":["../../src/sandbox/sprites.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,cAAc,CAAA;AAEzD,OAAO,KAAK,EACX,iBAAiB,EACjB,SAAS,EAET,aAAa,EACb,eAAe,EACf,MAAM,YAAY,CAAA;AAUnB,qBAAa,sBAAuB,YAAW,eAAe;IAC7D,QAAQ,CAAC,OAAO,EAAG,SAAS,CAAS;IAErC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,OAAO,CAA4B;gBAE/B,IAAI,CAAC,EAAE;QAClB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;KACb;IAMD,OAAO,CAAC,SAAS;IAMjB;;;OAGG;YACW,YAAY;IAa1B;;;OAGG;YACW,wBAAwB;IAiBhC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IA6F3E,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7C,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAejE;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtD,oEAAoE;IACpE,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAItD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIjD,IAAI,IAAI,aAAa,EAAE;IAIvB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAIjC,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW7D,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAoBhE,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAYzE,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IASjD,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAShD,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAYrD,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA6DxE,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI3E,cAAc,CACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAChF,OAAO,CAAC,aAAa,CAAC;CA2BzB"}

package/dist/sandbox/sprites.js

@@ -0,0 +1,323 @@
+import { SpritesClient } from "@fly/sprites";
+import { ensureBootstrapped } from "./sprites-bootstrap.js";
+// ---------------------------------------------------------------------------
+// SpritesSandboxProvider — cloud sandboxes via Fly.io Sprites
+// ---------------------------------------------------------------------------
+const DEFAULT_REGION = "ord";
+const DEFAULT_RAM_MB = 2048;
+const DEFAULT_CPUS = 2;
+export class SpritesSandboxProvider {
+    runtime = "sprites";
+    client;
+    token;
+    baseURL;
+    handles = new Map();
+    sprites = new Map();
+    constructor(opts) {
+        this.token = opts?.token ?? process.env.FLY_API_TOKEN ?? "";
+        this.baseURL = "https://api.sprites.dev";
+        this.client = new SpritesClient(this.token);
+    }
+    getSprite(handle) {
+        const sprite = this.sprites.get(handle.sessionId);
+        if (!sprite)
+            throw new Error(`No Sprites sandbox for session ${handle.sessionId}`);
+        return sprite;
+    }
+    /**
+     * Fetch the public URL for a sprite from the REST API.
+     * The URL includes an org slug suffix that we can't derive locally.
+     */
+    async getSpriteUrl(spriteName) {
+        const url = `${this.baseURL}/v1/sprites/${encodeURIComponent(spriteName)}`;
+        const resp = await fetch(url, {
+            headers: { Authorization: `Bearer ${this.token}` },
+        });
+        if (!resp.ok) {
+            console.warn(`[sprites] Failed to get sprite info (${resp.status}): ${await resp.text()}`);
+            return null;
+        }
+        const data = (await resp.json());
+        return data.url ?? null;
+    }
+    /**
+     * Set network policy to allow all outbound connections.
+     * The JS SDK doesn't expose this yet, so we call the REST API directly.
+     */
+    async setNetworkPolicyAllowAll(spriteName) {
+        const url = `${this.baseURL}/v1/sprites/${encodeURIComponent(spriteName)}/policy/network`;
+        const resp = await fetch(url, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                rules: [{ domain: "*", action: "allow" }],
+            }),
+        });
+        if (!resp.ok) {
+            console.warn(`[sprites] Failed to set network policy (${resp.status}): ${await resp.text()}`);
+        }
+    }
+    async create(sessionId, opts) {
+        const infra = opts?.infra ?? { mode: "local" };
+        const projectName = opts?.projectName || sessionId.slice(0, 8);
+        const spriteName = `ea-${sessionId.slice(0, 12)}`;
+        console.log(`[sprites] Creating sprite: session=${sessionId} project=${projectName} name=${spriteName} infra=${infra.mode}`);
+        // Create sprite with resource config
+        const sprite = await this.client.createSprite(spriteName, {
+            ramMB: DEFAULT_RAM_MB,
+            cpus: DEFAULT_CPUS,
+            region: DEFAULT_REGION,
+        });
+        // Enable outbound internet access
+        await this.setNetworkPolicyAllowAll(spriteName);
+        // Bootstrap (or restore from checkpoint).
+        // When AGENT_PACKAGE_URL is set (e.g. PR preview), install from that URL
+        // instead of the published electric-agent package.
+        const packageUrl = process.env.AGENT_PACKAGE_URL || undefined;
+        await ensureBootstrapped(sprite, packageUrl ? { packageUrl } : undefined);
+        // Set environment variables by writing an env file and sourcing it
+        const envVars = {
+            SANDBOX_MODE: "1",
+            VITE_PORT: "8080",
+        };
+        const isCloud = infra.mode === "cloud" || infra.mode === "claim";
+        if (isCloud) {
+            envVars.DATABASE_URL = infra.databaseUrl;
+            envVars.ELECTRIC_URL = infra.electricUrl;
+            envVars.ELECTRIC_SOURCE_ID = infra.sourceId;
+            envVars.ELECTRIC_SECRET = infra.secret;
+        }
+        if (opts?.apiKey) {
+            envVars.ANTHROPIC_API_KEY = opts.apiKey;
+        }
+        else if (opts?.oauthToken) {
+            envVars.CLAUDE_CODE_OAUTH_TOKEN = opts.oauthToken;
+        }
+        if (opts?.ghToken) {
+            envVars.GH_TOKEN = opts.ghToken;
+        }
+        // Pass stream env vars for hosted Durable Streams communication
+        if (opts?.streamEnv) {
+            for (const [key, value] of Object.entries(opts.streamEnv)) {
+                envVars[key] = value;
+            }
+        }
+        // Write env vars to a profile file so all commands inherit them.
+        // NOTE: sprite.exec() splits the command string by whitespace, so shell
+        // features (pipes, redirects, heredocs) don't work. Use execFile with
+        // explicit args to run through bash -c instead.
+        const envLines = Object.entries(envVars)
+            .map(([k, v]) => `export ${k}=${JSON.stringify(v)}`)
+            .join("\n");
+        const b64 = Buffer.from(envLines).toString("base64");
+        await sprite.execFile("bash", [
+            "-c",
+            `echo ${b64} | base64 -d > /etc/profile.d/electric-agent.sh`,
+        ]);
+        const projectDir = `/home/agent/workspace/${projectName}`;
+        await sprite.exec(`mkdir -p ${projectDir}`);
+        // Fetch the public URL from the API — it includes the org slug suffix.
+        // Sprites route this URL to port 8080 by default; VITE_PORT is set to 8080 above.
+        const previewUrl = await this.getSpriteUrl(spriteName);
+        const handle = {
+            sessionId,
+            runtime: "sprites",
+            port: 8080,
+            projectDir,
+            previewUrl: previewUrl ?? undefined,
+        };
+        this.handles.set(sessionId, handle);
+        this.sprites.set(sessionId, sprite);
+        // Agent is NOT started here — the bridge starts it
+        console.log("[sprites] Sprite ready (agent will be started by bridge)");
+        return handle;
+    }
+    async destroy(handle) {
+        const sprite = this.sprites.get(handle.sessionId);
+        this.handles.delete(handle.sessionId);
+        this.sprites.delete(handle.sessionId);
+        if (sprite) {
+            try {
+                await sprite.delete();
+            }
+            catch {
+                // Sprite may already be deleted
+            }
+        }
+    }
+    async restartAgent(handle) {
+        const sprite = this.getSprite(handle);
+        // Kill any running agent process — the bridge will restart it
+        try {
+            await sprite.execFile("bash", ["-c", "pkill -f 'electric-agent headless' || true"]);
+        }
+        catch {
+            // Process may not be running
+        }
+        const newHandle = { ...handle };
+        this.handles.set(handle.sessionId, newHandle);
+        return newHandle;
+    }
+    /**
+     * Launch the headless agent process in the sprite without blocking.
+     * Uses spawn() (event-based API) instead of execFile() which waits for exit.
+     */
+    async startAgent(handle) {
+        const sprite = this.getSprite(handle);
+        const cmd = sprite.spawn("bash", [
+            "-c",
+            "source /etc/profile.d/npm-global.sh 2>/dev/null; source /etc/profile.d/electric-agent.sh && electric-agent headless > /tmp/agent-stdout.log 2> /tmp/agent-stderr.log",
+        ]);
+        await cmd.start();
+        // Don't await cmd.wait() — we want the agent to run in the background
+    }
+    /** Get the underlying Sprite SDK object for bridge communication */
+    getSpriteObject(sessionId) {
+        return this.sprites.get(sessionId);
+    }
+    get(sessionId) {
+        return this.handles.get(sessionId);
+    }
+    list() {
+        return [...this.handles.values()];
+    }
+    isAlive(handle) {
+        return this.sprites.has(handle.sessionId);
+    }
+    async exec(handle, command) {
+        const sprite = this.getSprite(handle);
+        const result = await sprite.execFile("bash", [
+            "-c",
+            `source /etc/profile.d/npm-global.sh 2>/dev/null; source /etc/profile.d/electric-agent.sh && ${command}`,
+        ]);
+        return (typeof result.stdout === "string" ? result.stdout : result.stdout.toString("utf-8")).trim();
+    }
+    async listFiles(handle, dir) {
+        const sprite = this.sprites.get(handle.sessionId);
+        if (!sprite)
+            return [];
+        try {
+            const result = await sprite.execFile("bash", [
+                "-c",
+                `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'`,
+            ]);
+            const stdout = typeof result.stdout === "string" ? result.stdout : result.stdout.toString("utf-8");
+            return stdout
+                .split("\n")
+                .map((l) => l.trim())
+                .filter(Boolean);
+        }
+        catch {
+            return [];
+        }
+    }
+    async readFile(handle, filePath) {
+        const sprite = this.sprites.get(handle.sessionId);
+        if (!sprite)
+            return null;
+        try {
+            const result = await sprite.exec(`cat ${filePath}`);
+            return typeof result.stdout === "string" ? result.stdout : result.stdout.toString("utf-8");
+        }
+        catch {
+            return null;
+        }
+    }
+    async startApp(handle) {
+        try {
+            await this.exec(handle, "cd /home/agent/workspace/*/ && pnpm dev:start");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async stopApp(handle) {
+        try {
+            await this.exec(handle, "cd /home/agent/workspace/*/ && pnpm dev:stop");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async isAppRunning(handle) {
+        try {
+            const result = await this.exec(handle, "kill -0 $(cat /tmp/dev-server.pid 2>/dev/null) 2>/dev/null && echo RUNNING || echo STOPPED");
+            return result.includes("RUNNING");
+        }
+        catch {
+            return false;
+        }
+    }
+    async gitStatus(handle, projectDir) {
+        const sprite = this.sprites.get(handle.sessionId);
+        if (!sprite) {
+            return {
+                initialized: false,
+                branch: null,
+                hasUncommitted: false,
+                lastCommitHash: null,
+                lastCommitMessage: null,
+            };
+        }
+        try {
+            const initResult = await this.exec(handle, `cd ${projectDir} && test -d .git && echo "GIT_INIT=yes" || echo "GIT_INIT=no"`);
+            if (!initResult.includes("GIT_INIT=yes")) {
+                return {
+                    initialized: false,
+                    branch: null,
+                    hasUncommitted: false,
+                    lastCommitHash: null,
+                    lastCommitMessage: null,
+                };
+            }
+            const branch = (await this.exec(handle, `cd ${projectDir} && git rev-parse --abbrev-ref HEAD 2>/dev/null || echo ""`)).trim();
+            const hash = (await this.exec(handle, `cd ${projectDir} && git rev-parse HEAD 2>/dev/null || echo ""`)).trim();
+            const message = (await this.exec(handle, `cd ${projectDir} && git log -1 --format=%s 2>/dev/null || echo ""`)).trim();
+            const statusOutput = (await this.exec(handle, `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 getPreviewUrl(handle, _port) {
+        return handle.previewUrl ?? 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 targetDir = `/home/agent/workspace/${repoName}`;
+        await this.exec(handle, `gh repo clone "${repoUrl}" "${targetDir}" 2>/dev/null || git clone "${repoUrl}" "${targetDir}"`);
+        if (opts?.branch) {
+            await this.exec(handle, `cd ${targetDir} && git checkout ${opts.branch}`);
+        }
+        handle.projectDir = targetDir;
+        return handle;
+    }
+}
+//# sourceMappingURL=sprites.js.map

package/dist/sandbox/sprites.js.map

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

package/dist/sandbox/types.d.ts

@@ -0,0 +1,73 @@
+export type SandboxRuntime = "docker" | "daytona" | "sprites";
+export interface SandboxHandle {
+    sessionId: string;
+    runtime: SandboxRuntime;
+    port: number;
+    projectDir: string;
+    /** Preview URL for cloud runtimes (Daytona) */
+    previewUrl?: string;
+}
+export interface GitStatus {
+    initialized: boolean;
+    branch: string | null;
+    hasUncommitted: boolean;
+    lastCommitHash: string | null;
+    lastCommitMessage: string | null;
+}
+export type InfraConfig = {
+    mode: "local";
+} | {
+    mode: "cloud";
+    databaseUrl: string;
+    electricUrl: string;
+    sourceId: string;
+    secret: string;
+} | {
+    mode: "claim";
+    databaseUrl: string;
+    electricUrl: string;
+    sourceId: string;
+    secret: string;
+    claimId: string;
+};
+export interface CreateSandboxOpts {
+    apiKey?: string;
+    oauthToken?: string;
+    ghToken?: string;
+    projectName?: string;
+    infra?: InfraConfig;
+    /** Stream env vars to inject into the sandbox for --stream mode */
+    streamEnv?: Record<string, string>;
+    /**
+     * If true, the sandbox should NOT auto-start the headless agent.
+     * The bridge will start it via stdin/stdout (session API or docker exec).
+     */
+    deferAgentStart?: boolean;
+}
+export interface SandboxProvider {
+    /** The runtime type this provider manages */
+    readonly runtime: SandboxRuntime;
+    create(sessionId: string, opts?: CreateSandboxOpts): Promise<SandboxHandle>;
+    destroy(handle: SandboxHandle): Promise<void>;
+    restartAgent(handle: SandboxHandle): Promise<SandboxHandle>;
+    get(sessionId: string): SandboxHandle | undefined;
+    list(): SandboxHandle[];
+    /** Check if the sandbox is still alive and responsive */
+    isAlive(handle: SandboxHandle): boolean;
+    listFiles(handle: SandboxHandle, dir: string): Promise<string[]>;
+    readFile(handle: SandboxHandle, filePath: string): Promise<string | null>;
+    startApp(handle: SandboxHandle): Promise<boolean>;
+    stopApp(handle: SandboxHandle): Promise<boolean>;
+    isAppRunning(handle: SandboxHandle): Promise<boolean>;
+    exec(handle: SandboxHandle, command: string): Promise<string>;
+    gitStatus(handle: SandboxHandle, projectDir: string): Promise<GitStatus>;
+    /** Get a preview URL for a port (cloud runtimes only) */
+    getPreviewUrl?(handle: SandboxHandle, port: number): Promise<string | null>;
+    createFromRepo(sessionId: string, repoUrl: string, opts?: {
+        branch?: string;
+        apiKey?: string;
+        oauthToken?: string;
+        ghToken?: string;
+    }): Promise<SandboxHandle>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/sandbox/types.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Sandbox handle — returned by create/restartAgent
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sandbox/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sandbox/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mDAAmD;AACnD,8EAA8E"}

package/dist/server.d.ts

@@ -0,0 +1,26 @@
+import { Hono } from "hono";
+import type { SandboxProvider } from "./sandbox/index.js";
+import { type StreamConfig } from "./streams.js";
+type BridgeMode = "stream" | "stdio";
+interface ServerConfig {
+    port: number;
+    dataDir: string;
+    sandbox: SandboxProvider;
+    /** Hosted stream config — required */
+    streamConfig: StreamConfig;
+    /** Bridge mode: "stream" (hosted DS, default) or "stdio" (stdin/stdout via SDK/Docker) */
+    bridgeMode: BridgeMode;
+    /** Optional: infer a short project name from a description (calls an LLM). Falls back to slugified description. */
+    inferProjectName?: (description: string) => Promise<string>;
+}
+export declare function createApp(config: ServerConfig): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export declare function startWebServer(opts: {
+    port?: number;
+    dataDir?: string;
+    sandbox: SandboxProvider;
+    streamConfig: StreamConfig;
+    bridgeMode?: BridgeMode;
+    inferProjectName?: (description: string) => Promise<string>;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAa3B,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAWtE,OAAO,EAGN,KAAK,YAAY,EAEjB,MAAM,cAAc,CAAA;AAErB,KAAK,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEpC,UAAU,YAAY;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,eAAe,CAAA;IACxB,sCAAsC;IACtC,YAAY,EAAE,YAAY,CAAA;IAC1B,0FAA0F;IAC1F,UAAU,EAAE,UAAU,CAAA;IACtB,mHAAmH;IACnH,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC3D;AAuOD,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,8EA6pC7C;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,eAAe,CAAA;IACxB,YAAY,EAAE,YAAY,CAAA;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC3D,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BhB"}