background-agents 0.1.1

package/dist/providers/opencode.js

@@ -0,0 +1,100 @@
+import { createToolStartEvent } from "../types/events.js";
+import { safeJsonParse } from "../utils/json.js";
+import { Provider } from "./base.js";
+/**
+ * OpenCode provider
+ *
+ * Interacts with the OpenCode CLI tool which outputs JSON lines
+ */
+export class OpenCodeProvider extends Provider {
+    name = "opencode";
+    constructor(options) {
+        super(options);
+    }
+    getCommand(options) {
+        // OpenCode sometimes writes JSON events to stderr; run under bash and redirect 2>&1
+        // to ensure the sandbox PTY captures the JSONL stream.
+        const quote = (s) => `'${s.replace(/'/g, "'\\''")}'`;
+        const model = options?.model;
+        const session = this.sessionId || options?.sessionId;
+        const prompt = options?.prompt;
+        const parts = [
+            "opencode",
+            "run",
+            "--format",
+            "json",
+            "--variant",
+            "medium",
+        ];
+        if (model) {
+            parts.push("-m", quote(model));
+        }
+        if (session) {
+            parts.push("-s", quote(session));
+        }
+        if (prompt) {
+            parts.push(quote(prompt));
+        }
+        const command = `${parts.join(" ")} 2>&1`;
+        return {
+            cmd: "bash",
+            args: ["-lc", command],
+            env: {
+                // Allow all tool actions without interactive approval in headless runs
+                OPENCODE_PERMISSION: '{"*":"allow"}',
+                ...options?.env,
+            },
+        };
+    }
+    parse(line) {
+        const json = safeJsonParse(line);
+        if (!json) {
+            return null;
+        }
+        // Step start - session initialization
+        if (json.type === "step_start") {
+            // OpenCode can emit multiple step_start lines for the same session; only emit once.
+            if (this.sessionId === json.sessionID)
+                return null;
+            this.sessionId = json.sessionID;
+            return { type: "session", id: json.sessionID };
+        }
+        // Text content - the actual response
+        if (json.type === "text") {
+            if (json.part?.type === "text" && json.part.text) {
+                return { type: "token", text: json.part.text };
+            }
+            return null;
+        }
+        // Tool call start
+        if (json.type === "tool_call") {
+            const toolName = (json.part?.tool || "unknown").toLowerCase();
+            const normalized = toolName === "bash" ? "shell" : toolName;
+            return createToolStartEvent(normalized, json.part?.args);
+        }
+        // Tool use (stream-json: emitted when tool completes; emit as tool_start so it appears in stream)
+        if (json.type === "tool_use") {
+            const toolName = (json.part?.tool || "unknown").toLowerCase();
+            const normalized = toolName === "bash" ? "shell" : toolName;
+            const raw = json.part;
+            return createToolStartEvent(normalized, raw?.state?.input);
+        }
+        // Tool result - tool completed
+        if (json.type === "tool_result") {
+            return { type: "tool_end" };
+        }
+        // Step finish - emit end only when run actually stops (reason "stop"); ignore intermediate steps (e.g. reason "tool-calls").
+        if (json.type === "step_finish") {
+            if (json.part?.reason === "stop")
+                return { type: "end" };
+            return null;
+        }
+        // Error event - emit as end with error
+        if (json.type === "error") {
+            const errorMsg = json.error?.data?.message || json.error?.name || "Unknown error";
+            return { type: "end", error: errorMsg };
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=opencode.js.map

package/dist/providers/opencode.js.map

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

package/dist/sandbox/daytona-ssh.d.ts

@@ -0,0 +1,9 @@
+import type { Sandbox } from "@daytonaio/sdk";
+import type { CodeAgentSandbox, AdaptSandboxOptions } from "../types/index.js";
+/**
+ * Wrap a Daytona Sandbox to use SSH for executeCommand and executeBackground.
+ * Long-running commands (e.g. starting CLI agents) return immediately via executeBackground.
+ * Requires sandbox.createSshAccess() (Daytona SDK support for SSH).
+ */
+export declare function adaptDaytonaSandboxWithSsh(sandbox: Sandbox, options?: AdaptSandboxOptions): CodeAgentSandbox;
+//# sourceMappingURL=daytona-ssh.d.ts.map

package/dist/sandbox/daytona-ssh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daytona-ssh.d.ts","sourceRoot":"","sources":["../../src/sandbox/daytona-ssh.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAA4B,MAAM,mBAAmB,CAAA;AA2CxG;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,mBAAwB,GAChC,gBAAgB,CAuElB"}

package/dist/sandbox/daytona-ssh.js

@@ -0,0 +1,113 @@
+/**
+ * Daytona sandbox adapter that uses SSH for executeCommand and executeBackground.
+ * Use this for background CLI agent runs so start() returns quickly (non-blocking).
+ * Streaming (executeCommandStream) and ensureProvider still use the process API.
+ */
+import { Client } from "ssh2";
+import { adaptDaytonaSandbox } from "./daytona.js";
+const SSH_HOST = "ssh.app.daytona.io";
+const SSH_PORT = 22;
+const SSH_TOKEN_EXPIRY_MINUTES = 60;
+function hasSshAccess(s) {
+    return typeof s.createSshAccess === "function";
+}
+function execOverSsh(conn, command, timeoutMs = 60_000) {
+    return new Promise((resolve, reject) => {
+        const timer = timeoutMs > 0 ? setTimeout(() => {
+            reject(new Error(`SSH exec timeout after ${timeoutMs}ms`));
+        }, timeoutMs) : undefined;
+        conn.exec(command, (err, stream) => {
+            if (err) {
+                clearTimeout(timer);
+                reject(err);
+                return;
+            }
+            let stdout = "";
+            let stderr = "";
+            stream.on("data", (data) => { stdout += data.toString(); });
+            stream.stderr.on("data", (data) => { stderr += data.toString(); });
+            stream.on("close", (code) => {
+                clearTimeout(timer);
+                resolve({
+                    exitCode: code ?? 1,
+                    output: stdout + (stderr ? "\nSTDERR:\n" + stderr : ""),
+                });
+            });
+        });
+    });
+}
+/**
+ * Wrap a Daytona Sandbox to use SSH for executeCommand and executeBackground.
+ * Long-running commands (e.g. starting CLI agents) return immediately via executeBackground.
+ * Requires sandbox.createSshAccess() (Daytona SDK support for SSH).
+ */
+export function adaptDaytonaSandboxWithSsh(sandbox, options = {}) {
+    const base = adaptDaytonaSandbox(sandbox, options);
+    const envVars = { ...options.env };
+    let conn = null;
+    let connectPromise = null;
+    async function ensureSsh() {
+        if (conn)
+            return conn;
+        if (connectPromise)
+            return connectPromise;
+        if (!hasSshAccess(sandbox)) {
+            throw new Error("Sandbox does not support createSshAccess(); use adaptDaytonaSandbox() instead.");
+        }
+        connectPromise = new Promise((resolve, reject) => {
+            sandbox.createSshAccess(SSH_TOKEN_EXPIRY_MINUTES).then((access) => {
+                const c = new Client();
+                c.on("ready", () => {
+                    conn = c;
+                    resolve(c);
+                });
+                c.on("error", reject);
+                c.connect({
+                    host: SSH_HOST,
+                    port: SSH_PORT,
+                    username: access.token,
+                });
+            }).catch(reject);
+        });
+        return connectPromise;
+    }
+    function envPrefix() {
+        return Object.entries(envVars)
+            .map(([k, v]) => `${k}='${String(v).replace(/'/g, "'\\''")}'`)
+            .join(" ");
+    }
+    async function executeCommand(command, timeout = 60) {
+        const c = await ensureSsh();
+        const prefix = envPrefix();
+        const fullCommand = prefix ? `${prefix} ${command}` : command;
+        return execOverSsh(c, fullCommand, timeout * 1000);
+    }
+    async function executeBackground(opts) {
+        const c = await ensureSsh();
+        const pidFile = `${opts.outputFile}.${opts.runId}.pid`;
+        const doneFile = `${pidFile}.done`;
+        const prefix = envPrefix();
+        const cmd = prefix ? `${prefix} ${opts.command}` : opts.command;
+        const wrapper = `( ( ${cmd} >> ${opts.outputFile} 2>&1 ; echo 1 > ${doneFile} ) & echo $! > ${pidFile} ; cat ${pidFile} )`;
+        const result = await execOverSsh(c, wrapper, 15_000);
+        const raw = (result.output ?? "").trim().split(/\s+/).pop() ?? "";
+        const pid = Number(raw);
+        if (!Number.isInteger(pid) || pid < 1) {
+            throw new Error(`executeBackground: could not parse pid from output: ${result.output?.slice(0, 200)}`);
+        }
+        return { pid };
+    }
+    return {
+        setEnvVars(vars) {
+            Object.assign(envVars, vars);
+            base.setEnvVars(vars);
+        },
+        executeCommand,
+        executeBackground,
+        ensureProvider: base.ensureProvider.bind(base),
+        async *executeCommandStream(command, timeout) {
+            yield* base.executeCommandStream(command, timeout);
+        },
+    };
+}
+//# sourceMappingURL=daytona-ssh.js.map

package/dist/sandbox/daytona-ssh.js.map

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

package/dist/sandbox/daytona.d.ts

@@ -0,0 +1,4 @@
+import type { Sandbox } from "@daytonaio/sdk";
+import type { CodeAgentSandbox, AdaptSandboxOptions } from "../types/index.js";
+export declare function adaptDaytonaSandbox(sandbox: Sandbox, options?: AdaptSandboxOptions): CodeAgentSandbox;
+//# sourceMappingURL=daytona.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"daytona.d.ts","sourceRoot":"","sources":["../../src/sandbox/daytona.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAA0C,MAAM,mBAAmB,CAAA;AAgDtH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,mBAAwB,GAChC,gBAAgB,CA0NlB"}

package/dist/sandbox/daytona.js

@@ -0,0 +1,238 @@
+import { getPackageName } from "../utils/install.js";
+const SSH_HOST = "ssh.app.daytona.io";
+const SSH_PORT = 22;
+const SSH_TOKEN_EXPIRY_MINUTES = 60;
+function hasSshAccess(s) {
+    return typeof s.createSshAccess === "function";
+}
+function execOverSsh(conn, command, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const timer = timeoutMs > 0 ? setTimeout(() => reject(new Error(`SSH exec timeout after ${timeoutMs}ms`)), timeoutMs) : undefined;
+        conn.exec(command, (err, stream) => {
+            if (err) {
+                clearTimeout(timer);
+                reject(err);
+                return;
+            }
+            let stdout = "";
+            let stderr = "";
+            stream.on("data", (data) => { stdout += data.toString(); });
+            stream.stderr.on("data", (data) => { stderr += data.toString(); });
+            stream.on("close", (code) => {
+                clearTimeout(timer);
+                resolve({ exitCode: code ?? 1, output: stdout + (stderr ? "\nSTDERR:\n" + stderr : "") });
+            });
+        });
+    });
+}
+function stripAnsi(text) {
+    // eslint-disable-next-line no-control-regex
+    return text.replace(/\x1b\[[0-9;]*[A-Za-z]|\x1b\][^\x07]*\x07|\x1b[()][AB012]|\x1b\[[\?]?[0-9;]*[hlm]|\r/g, "");
+}
+function isJsonLine(line) {
+    const trimmed = line.trim();
+    return trimmed.startsWith("{") && trimmed.endsWith("}");
+}
+export function adaptDaytonaSandbox(sandbox, options = {}) {
+    const envVars = { ...options.env };
+    async function isProviderInstalled(name) {
+        try {
+            const result = await sandbox.process.executeCommand(`which ${name}`);
+            return result.exitCode === 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    async function installProvider(name) {
+        const packageName = getPackageName(name);
+        try {
+            const result = await sandbox.process.executeCommand(`npm install -g ${packageName}`, undefined, undefined, 120);
+            return result.exitCode === 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    async function executeCommand(command, timeout = 60) {
+        const envPrefix = Object.entries(envVars)
+            .map(([k, v]) => `${k}='${v.replace(/'/g, "'\\''")}'`)
+            .join(" ");
+        const fullCommand = envPrefix ? `${envPrefix} ${command}` : command;
+        const result = await sandbox.process.executeCommand(fullCommand, undefined, undefined, timeout);
+        return { exitCode: result.exitCode ?? 0, output: result.result ?? "" };
+    }
+    let sshConnectPromise = null;
+    async function executeBackground(opts) {
+        const t0 = Date.now();
+        if (!hasSshAccess(sandbox))
+            throw new Error("Sandbox has no createSshAccess(); cannot run background command over SSH.");
+        let t = Date.now();
+        if (!sshConnectPromise) {
+            sshConnectPromise = (async () => {
+                const { Client: SshClient } = await import("ssh2");
+                return new Promise((resolve, reject) => {
+                    sandbox.createSshAccess(SSH_TOKEN_EXPIRY_MINUTES).then((access) => {
+                        const c = new SshClient();
+                        c.on("ready", () => resolve(c));
+                        c.on("error", reject);
+                        c.connect({ host: SSH_HOST, port: SSH_PORT, username: access.token });
+                    }).catch(reject);
+                });
+            })();
+        }
+        const conn = await sshConnectPromise;
+        console.log(`[timing] SSH connect (or reuse) took ${Date.now() - t}ms`);
+        if (process.env.CODING_AGENTS_SSH_TIMING_TESTS === "1") {
+            const testCases = [
+                { name: "echo only", command: "echo 123" },
+                { name: "sleep 1 then echo", command: "sleep 1 && echo 123" },
+                { name: "sleep 3 then echo", command: "sleep 3 && echo 123" },
+                { name: "background sleep 5, echo $! and cat pid", command: "( sleep 5 & echo $! > /tmp/p.pid ; cat /tmp/p.pid )" },
+                { name: "wrapper shape ( ( sleep 10 ... ) & echo $! ; cat pid )", command: "( ( sleep 10 >> /tmp/out 2>&1 ; echo 1 > /tmp/out.done ) & echo $! > /tmp/w.pid ; cat /tmp/w.pid )" },
+            ];
+            console.log("[timing] --- SSH wrapper timing tests ---");
+            for (const { name, command } of testCases) {
+                const tTest = Date.now();
+                const res = await execOverSsh(conn, command, 15_000);
+                console.log(`[timing]   ${(Date.now() - tTest) / 1000}s  ${name}  exit=${res.exitCode} out=${(res.output ?? "").trim().slice(0, 40)}`);
+            }
+            console.log("[timing] --- end timing tests ---");
+        }
+        const envPrefix = Object.entries(envVars)
+            .map(([k, v]) => `${k}='${String(v).replace(/'/g, "'\\''")}'`)
+            .join(" ");
+        const cmd = envPrefix ? `${envPrefix} ${opts.command}` : opts.command;
+        // nohup detaches from SSH session so channel closes and we get PID immediately (like Daytona example)
+        // Write outputFile.done when command exits so isRunning can use it (process API may not see SSH-started pid)
+        const safeCmd = cmd.replace(/'/g, "'\\''");
+        const safeOutput = opts.outputFile.replace(/'/g, "'\\''");
+        const doneFile = opts.outputFile + ".done";
+        const safeDone = doneFile.replace(/'/g, "'\\''");
+        const wrapper = `nohup sh -c '${safeCmd} >> ${safeOutput} 2>&1; echo 1 > ${safeDone}' > /dev/null 2>&1 & echo $!`;
+        t = Date.now();
+        const result = await execOverSsh(conn, wrapper, 15_000);
+        console.log(`[timing] execOverSsh(wrapper) took ${Date.now() - t}ms (executeBackground total ${Date.now() - t0}ms)`);
+        const raw = (result.output ?? "").trim().split(/\s+/).pop() ?? "";
+        const pid = Number(raw);
+        if (!Number.isInteger(pid) || pid < 1)
+            throw new Error(`executeBackground: could not parse pid: ${result.output?.slice(0, 200)}`);
+        return { pid };
+    }
+    async function killBackgroundProcess(pid) {
+        if (!hasSshAccess(sandbox))
+            throw new Error("Sandbox has no createSshAccess(); cannot kill over SSH.");
+        if (!sshConnectPromise)
+            return;
+        const conn = await sshConnectPromise;
+        await execOverSsh(conn, `kill ${pid} 2>/dev/null || kill -9 ${pid} 2>/dev/null || true`, 10_000);
+    }
+    const result = {
+        setEnvVars(vars) {
+            Object.assign(envVars, vars);
+        },
+        executeCommand,
+        killBackgroundProcess,
+        async ensureProvider(name) {
+            const installed = await isProviderInstalled(name);
+            if (!installed) {
+                console.log(`Installing ${name} CLI in sandbox...`);
+                const success = await installProvider(name);
+                if (!success) {
+                    throw new Error(`Failed to install ${name} CLI in sandbox`);
+                }
+                console.log(`Installed ${name} CLI`);
+            }
+        },
+        async *executeCommandStream(command, _timeout = 120) {
+            const envExports = Object.entries(envVars)
+                .map(([k, v]) => `export ${k}='${v.replace(/'/g, "'\\''")}'`)
+                .join("; ");
+            const timedCommand = _timeout > 0 ? `timeout ${_timeout}s ${command}` : command;
+            const fullCommand = envExports ? `${envExports}; ${timedCommand}` : timedCommand;
+            let buffer = "";
+            const lineQueue = [];
+            let resolveNext = null;
+            let ptyDone = false;
+            let ptyHandle = null;
+            const ptyId = `pty-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+            ptyHandle = await sandbox.process.createPty({
+                id: ptyId,
+                onData: (data) => {
+                    const text = new TextDecoder().decode(data);
+                    buffer += text;
+                    const lines = buffer.split("\n");
+                    buffer = lines.pop() ?? "";
+                    for (const line of lines) {
+                        const cleaned = stripAnsi(line).trim();
+                        if (cleaned && isJsonLine(cleaned)) {
+                            if (resolveNext) {
+                                resolveNext({ value: cleaned, done: false });
+                                resolveNext = null;
+                            }
+                            else {
+                                lineQueue.push(cleaned);
+                            }
+                        }
+                    }
+                },
+            });
+            try {
+                await ptyHandle.waitForConnection();
+                await ptyHandle.sendInput(`${fullCommand}\n`);
+                await ptyHandle.sendInput("exit\n");
+                const waitPromise = ptyHandle.wait().then(() => {
+                    ptyDone = true;
+                    const cleaned = stripAnsi(buffer).trim();
+                    if (cleaned && isJsonLine(cleaned)) {
+                        if (resolveNext) {
+                            resolveNext({ value: cleaned, done: false });
+                            resolveNext = null;
+                        }
+                        else {
+                            lineQueue.push(cleaned);
+                        }
+                    }
+                    if (resolveNext) {
+                        resolveNext({ value: undefined, done: true });
+                        resolveNext = null;
+                    }
+                });
+                while (true) {
+                    if (lineQueue.length > 0) {
+                        yield lineQueue.shift();
+                    }
+                    else if (ptyDone) {
+                        break;
+                    }
+                    else {
+                        const result = await new Promise((resolve) => {
+                            resolveNext = resolve;
+                            if (lineQueue.length > 0) {
+                                resolve({ value: lineQueue.shift(), done: false });
+                                resolveNext = null;
+                            }
+                            else if (ptyDone) {
+                                resolve({ value: undefined, done: true });
+                                resolveNext = null;
+                            }
+                        });
+                        if (result.done)
+                            break;
+                        yield result.value;
+                    }
+                }
+                await waitPromise;
+            }
+            finally {
+                if (ptyHandle) {
+                    await ptyHandle.disconnect();
+                }
+            }
+        },
+    };
+    // Background commands always use SSH so start() returns quickly.
+    result.executeBackground = executeBackground;
+    return result;
+}
+//# sourceMappingURL=daytona.js.map

package/dist/sandbox/daytona.js.map

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

package/dist/sandbox/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Sandbox module: public API and adapter dispatch.
+ * Implementations live in sandbox/daytona.ts and daytona-ssh.ts.
+ */
+import type { CodeAgentSandbox, AdaptSandboxOptions } from "../types/index.js";
+export type { CodeAgentSandbox, AdaptSandboxOptions } from "../types/index.js";
+export { adaptDaytonaSandbox } from "./daytona.js";
+/**
+ * Adapt a sandbox for use with createProvider/createSession.
+ * If the value is a Daytona Sandbox (from @daytonaio/sdk), it is wrapped via the Daytona adapter.
+ * Otherwise it must already implement CodeAgentSandbox and is returned as-is.
+ */
+export declare function adaptSandbox(sandbox: CodeAgentSandbox | import("@daytonaio/sdk").Sandbox, options?: AdaptSandboxOptions): CodeAgentSandbox;
+//# 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;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE9E,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,gBAAgB,GAAG,OAAO,gBAAgB,EAAE,OAAO,EAC5D,OAAO,GAAE,mBAAwB,GAChC,gBAAgB,CAMlB"}

package/dist/sandbox/index.js

@@ -0,0 +1,15 @@
+import { adaptDaytonaSandbox } from "./daytona.js";
+export { adaptDaytonaSandbox } from "./daytona.js";
+/**
+ * Adapt a sandbox for use with createProvider/createSession.
+ * If the value is a Daytona Sandbox (from @daytonaio/sdk), it is wrapped via the Daytona adapter.
+ * Otherwise it must already implement CodeAgentSandbox and is returned as-is.
+ */
+export function adaptSandbox(sandbox, options = {}) {
+    const s = sandbox;
+    if ("process" in s && typeof s.delete === "function") {
+        return adaptDaytonaSandbox(sandbox, options);
+    }
+    return sandbox;
+}
+//# 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":"AAKA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,OAA4D,EAC5D,UAA+B,EAAE;IAEjC,MAAM,CAAC,GAAG,OAAqE,CAAA;IAC/E,IAAI,SAAS,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACrD,OAAO,mBAAmB,CAAC,OAA2C,EAAE,OAAO,CAAC,CAAA;IAClF,CAAC;IACD,OAAO,OAA2B,CAAA;AACpC,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,64 @@
+import type { ProviderName, ProviderOptions, RunOptions, Event } from "./types/index.js";
+import type { Provider } from "./providers/base.js";
+/** Options for createSession (provider options + run defaults like model, timeout). */
+export interface SessionOptions extends ProviderOptions {
+    model?: string;
+    sessionId?: string;
+    timeout?: number;
+    /** Optional system prompt applied once per session. */
+    systemPrompt?: string;
+    skipInstall?: boolean;
+    env?: Record<string, string>;
+}
+/** Options for createBackgroundSession (session options; paths derived from session id). */
+export interface BackgroundSessionOptions extends SessionOptions {
+    /** When provided, reattach to an existing background session (e.g. after restart). */
+    backgroundSessionId?: string;
+}
+/** Background session handle: start turns and get events; state lives in sandbox under session id. */
+export interface BackgroundSession {
+    /** Unique session id; paths and cursor in sandbox are derived from this. */
+    readonly id: string;
+    /** Underlying provider instance (advanced use only). */
+    readonly provider: Provider;
+    /**
+     * Start a new turn with the given prompt. One log file per turn in the sandbox.
+     */
+    start(prompt: string, options?: Omit<RunOptions, "prompt">): Promise<{
+        executionId: string;
+        pid: number;
+        outputFile: string;
+    }>;
+    /**
+     * Get new events for the current turn. Cursor is read/updated in sandbox meta; no arguments.
+     * Use isRunning() to check if the agent is still running (or crashed).
+     */
+    getEvents(): Promise<{
+        sessionId: string | null;
+        events: Event[];
+        cursor: string;
+    }>;
+    /** True if the current turn's process is still running in the sandbox (e.g. detect crash). */
+    isRunning(): Promise<boolean>;
+    /** Current turn's process id from sandbox meta, or null if no run in progress. */
+    getPid(): Promise<number | null>;
+    /** Cancel the current turn's process in the sandbox (no-op if not running). */
+    cancel(): Promise<void>;
+}
+/**
+ * Create a session: a provider with run defaults (model, timeout, env) set at creation.
+ * Returns the provider; call session.run(prompt) with just the prompt string.
+ */
+export declare function createSession(name: ProviderName, options: SessionOptions): Promise<Provider>;
+/**
+ * Create a background session: a provider configured for sandboxed background
+ * execution with one log file per turn and meta/cursor in the sandbox.
+ * Use start() to begin a turn and getEvents() to consume events (no cursor argument).
+ */
+export declare function createBackgroundSession(name: ProviderName, options: BackgroundSessionOptions): Promise<BackgroundSession>;
+/** Reattach to an existing background session by id (e.g. after restart). Provider is read from sandbox meta (written at session creation). Cached per id so repeated polls don't recreate the provider. */
+export declare function getBackgroundSession(options: BackgroundSessionOptions & {
+    backgroundSessionId: string;
+    sandbox: NonNullable<BackgroundSessionOptions["sandbox"]>;
+}): Promise<BackgroundSession>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAe,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAGrG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AA+BnD,uFAAuF;AACvF,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7B;AAED,4FAA4F;AAC5F,MAAM,WAAW,wBAAyB,SAAQ,cAAc;IAC9D,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,sGAAsG;AACtG,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAE3B;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC;QACnE,WAAW,EAAE,MAAM,CAAA;QACnB,GAAG,EAAE,MAAM,CAAA;QACX,UAAU,EAAE,MAAM,CAAA;KACnB,CAAC,CAAA;IAEF;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC;QACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;QACxB,MAAM,EAAE,KAAK,EAAE,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;KACf,CAAC,CAAA;IAEF,8FAA8F;IAC9F,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAE7B,kFAAkF;IAClF,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAEhC,+EAA+E;IAC/E,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQlG;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAK5B;AAED,4MAA4M;AAC5M,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,wBAAwB,GAAG;IAClC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,OAAO,EAAE,WAAW,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC,CAAA;CAC1D,GACA,OAAO,CAAC,iBAAiB,CAAC,CA2B5B"}