background-agents 0.1.1 → 1.0.0

package/dist/factory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAEhH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAAC,IAA2B,EAAE,OAAwB;IAClF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,CAAA;QACpC,KAAK,OAAO;YACV,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAA;QACnC,KAAK,UAAU;YACb,OAAO,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAA;QACtC,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,CAAA;QACpC;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,wDAAwD,CAAC,CAAA;IACtG,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAA;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,gBAAgB,EAAE,CAAC,QAAQ,CAAC,IAAoB,CAAC,CAAA;AAC1D,CAAC"}

package/dist/index.d.ts

@@ -1,30 +0,0 @@
-/**
- * Coding Agents SDK
- *
- * A TypeScript SDK for interacting with various AI coding agents.
- * Create a sandbox with @daytonaio/sdk and pass it to createSession.
- *
- * @example
- * ```typescript
- * import { Daytona } from "@daytonaio/sdk"
- * import { createSession } from "background-agents"
- *
- * const daytona = new Daytona({ apiKey: process.env.DAYTONA_API_KEY })
- * const sandbox = await daytona.create({ envVars: { ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY } })
- * const session = await createSession("claude", { sandbox })
- *
- * for await (const event of session.run("Hello")) {
- *   if (event.type === "token") process.stdout.write(event.text)
- * }
- *
- * await sandbox.delete()
- * ```
- */
-export type { Event, SessionEvent, TokenEvent, ToolStartEvent, ToolDeltaEvent, ToolEndEvent, EndEvent, EventType, ToolName, WriteToolInput, ReadToolInput, EditToolInput, GlobToolInput, GrepToolInput, ShellToolInput, ToolInputMap, ProviderName, ProviderCommand, RunOptions, RunDefaults, ProviderOptions, EventHandler, IProvider, CodeAgentSandbox, ExecuteBackgroundOptions, AdaptSandboxOptions, } from "./types/index.js";
-export { adaptDaytonaSandbox } from "./sandbox/index.js";
-export { Provider, ClaudeProvider, CodexProvider, OpenCodeProvider, GeminiProvider, } from "./providers/index.js";
-export { createProvider, getProviderNames, isValidProvider, } from "./factory.js";
-export { createSession, type SessionOptions, createBackgroundSession, getBackgroundSession, type BackgroundSessionOptions, type BackgroundSession, } from "./session.js";
-export { safeJsonParse, loadSession, storeSession, clearSession, getDefaultSessionPath, isCliInstalled, installProvider, ensureCliInstalled, getPackageName, getInstallationStatus, } from "./utils/index.js";
-export { isDebugEnabled, debugLog } from "./debug.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,YAAY,EACV,KAAK,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,EACV,WAAW,EACX,eAAe,EACf,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAGxD,OAAO,EACL,QAAQ,EACR,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,cAAc,GACf,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,aAAa,EACb,KAAK,cAAc,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -1,35 +0,0 @@
-/**
- * Coding Agents SDK
- *
- * A TypeScript SDK for interacting with various AI coding agents.
- * Create a sandbox with @daytonaio/sdk and pass it to createSession.
- *
- * @example
- * ```typescript
- * import { Daytona } from "@daytonaio/sdk"
- * import { createSession } from "background-agents"
- *
- * const daytona = new Daytona({ apiKey: process.env.DAYTONA_API_KEY })
- * const sandbox = await daytona.create({ envVars: { ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY } })
- * const session = await createSession("claude", { sandbox })
- *
- * for await (const event of session.run("Hello")) {
- *   if (event.type === "token") process.stdout.write(event.text)
- * }
- *
- * await sandbox.delete()
- * ```
- */
-// Sandbox adapter (wrap a Daytona sandbox from @daytonaio/sdk; uses SSH for background start when createSshAccess exists)
-export { adaptDaytonaSandbox } from "./sandbox/index.js";
-// Providers
-export { Provider, ClaudeProvider, CodexProvider, OpenCodeProvider, GeminiProvider, } from "./providers/index.js";
-// Factory
-export { createProvider, getProviderNames, isValidProvider, } from "./factory.js";
-// Session (provider with run defaults; recommended entry points)
-export { createSession, createBackgroundSession, getBackgroundSession, } from "./session.js";
-// Utilities
-export { safeJsonParse, loadSession, storeSession, clearSession, getDefaultSessionPath, isCliInstalled, installProvider, ensureCliInstalled, getPackageName, getInstallationStatus, } from "./utils/index.js";
-// Debug (enable with CODING_AGENTS_DEBUG=1)
-export { isDebugEnabled, debugLog } from "./debug.js";
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAgCH,0HAA0H;AAC1H,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAExD,YAAY;AACZ,OAAO,EACL,QAAQ,EACR,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,cAAc,GACf,MAAM,sBAAsB,CAAA;AAE7B,UAAU;AACV,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAA;AAErB,iEAAiE;AACjE,OAAO,EACL,aAAa,EAEb,uBAAuB,EACvB,oBAAoB,GAGrB,MAAM,cAAc,CAAA;AAErB,YAAY;AACZ,OAAO,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,kBAAkB,CAAA;AAEzB,4CAA4C;AAC5C,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA"}

package/dist/providers/base.d.ts

@@ -1,160 +0,0 @@
-import type { Event, IProvider, ProviderCommand, ProviderName, RunOptions, ProviderOptions } from "../types/index.js";
-import type { CodeAgentSandbox } from "../types/index.js";
-/**
- * Abstract base class for AI coding agent providers
- */
-export declare abstract class Provider implements IProvider {
-    abstract readonly name: ProviderName;
-    sessionId: string | null;
-    getSessionId(): string | null;
-    /** Sandbox for secure execution */
-    protected sandboxManager: CodeAgentSandbox | null;
-    /** Whether local execution is allowed */
-    protected allowLocalExecution: boolean;
-    /** Resolves when initial setup (install + env) has completed. */
-    private _readyPromise;
-    /** Env passed at creation; used for setup and when run() omits env */
-    private _creationEnv;
-    /** Defaults merged into every run (model, timeout, sessionId, env). Set by createSession. */
-    private _runDefaults;
-    /** Tracks whether we've already applied a synthetic system prompt for this session. */
-    private _systemPromptApplied;
-    get ready(): Promise<void>;
-    constructor(options?: ProviderOptions);
-    /**
-     * Get the command configuration for this provider
-     */
-    abstract getCommand(options?: RunOptions): ProviderCommand;
-    /**
-     * Parse a line of output into an event
-     */
-    abstract parse(line: string): Event | Event[] | null;
-    /**
-     * Apply a synthetic system prompt for providers without native support by
-     * prepending it to the first user prompt in the session. Claude uses its
-     * native CLI flag instead, so we leave the prompt unchanged there.
-     */
-    private _applySystemPrompt;
-    /**
-     * Run the provider and yield events. Pass a prompt string or full RunOptions.
-     * When created via createSession, runDefaults are merged in (e.g. model, timeout).
-     */
-    run(promptOrOptions?: string | RunOptions): AsyncGenerator<Event, void, unknown>;
-    private _codexLoginIfNeeded;
-    /** One-time setup: install CLI and set env. Run in microtask so subclass name is set. */
-    private _doSetup;
-    /** Per-run: set env and Codex login. */
-    private _applyRunEnv;
-    /**
-     * Run in a secure Daytona sandbox
-     */
-    private runSandbox;
-    /**
-     * Run directly on local machine (dangerous - use with caution)
-     */
-    private runLocal;
-    /** Meta stored in sandbox for background session (one log per turn, cursor in meta). */
-    protected readSandboxMeta(sessionDir: string): Promise<{
-        currentTurn: number;
-        cursor: number;
-        rawCursor?: number;
-        pid?: number;
-        runId?: string;
-        outputFile?: string;
-        sawEnd?: boolean;
-        startedAt?: string;
-        provider?: import("../types/index.js").ProviderName;
-        sessionId?: string | null;
-    } | null>;
-    /** Write initial session meta at creation so getBackgroundSession can reattach before first start(). */
-    writeInitialSessionMeta(sessionDir: string): Promise<void>;
-    protected writeSandboxMeta(sessionDir: string, meta: {
-        currentTurn: number;
-        cursor: number;
-        rawCursor?: number;
-        pid?: number;
-        runId?: string;
-        outputFile?: string;
-        sawEnd?: boolean;
-        startedAt?: string;
-        provider?: import("../types/index.js").ProviderName;
-        sessionId?: string | null;
-    }): Promise<void>;
-    /**
-     * Start a new turn in a session directory: one log file per turn, meta in sandbox.
-     * Uses currentTurn for this run; currentTurn is incremented when the turn ends (in getEvents).
-     * Writes meta with runId/outputFile before starting so reattaching clients see "running" immediately.
-     */
-    startSandboxBackgroundTurn(sessionDir: string, options: RunOptions): Promise<{
-        executionId: string;
-        pid: number;
-        outputFile: string;
-    }>;
-    /**
-     * Get the current turn's process id from sandbox meta, or null if no run in progress.
-     */
-    getSandboxBackgroundPid(sessionDir: string): Promise<number | null>;
-    /**
-     * Cancel the current turn's process in the sandbox (kill pid from meta).
-     * Uses killBackgroundProcess when available (same channel as start, e.g. SSH); else executeCommand.
-     * Writes the done file after kill so isRunning() becomes false (the wrapper never gets to write it).
-     */
-    cancelSandboxBackground(sessionDir: string): Promise<void>;
-    /**
-     * Check if the current turn's process is still running in the sandbox.
-     * True only while a turn is in progress; false until the next turn starts.
-     * Uses the done file (outputFile.done): the wrapper writes it when the command exits.
-     * We don't use kill -0 / ps here because the process is started over SSH; the process API
-     * runs in a different context and can't see that pid. Kill would only work over the same SSH.
-     */
-    isSandboxBackgroundProcessRunning(sessionDir: string): Promise<boolean>;
-    /**
-     * Get new events for the current turn; reads and updates cursor in sandbox meta.
-     * Use isSandboxBackgroundProcessRunning() to check if the agent is still running.
-     */
-    getEventsSandboxBackgroundFromMeta(sessionDir: string): Promise<{
-        sessionId: string | null;
-        events: Event[];
-        cursor: string;
-    }>;
-    /**
-     * Start a background run inside the sandbox.
-     * The CLI is run with stdout redirected to an append-only JSONL log file.
-     * Later you can call pollSandboxBackground(outputFile, cursor) to consume new events.
-     * If options.runId is provided (e.g. from startSandboxBackgroundTurn), it is used so meta can be written before this returns.
-     */
-    startSandboxBackground(options: RunOptions & {
-        outputFile: string;
-        runId?: string;
-    }): Promise<{
-        executionId: string;
-        pid: number;
-        runId: string;
-        outputFile: string;
-        cursor: string;
-    }>;
-    /**
-     * Poll a background sandbox run by reading the JSONL log file.
-     * Cursor is an opaque string representing the last processed line index.
-     */
-    pollSandboxBackground(outputFile: string, cursor?: string | null, rawCursor?: string | null): Promise<{
-        status: "running" | "completed";
-        sessionId: string | null;
-        events: Event[];
-        cursor: string;
-        rawCursor: string;
-    }>;
-    /**
-     * Run the provider with a callback for each event
-     */
-    runWithCallback(callback: (event: Event) => void | Promise<void>, promptOrOptions?: string | RunOptions): Promise<void>;
-    /**
-     * Collect all events from a run into an array
-     */
-    collectEvents(promptOrOptions?: string | RunOptions): Promise<Event[]>;
-    /**
-     * Collect the full text response from a run
-     */
-    collectText(promptOrOptions?: string | RunOptions): Promise<string>;
-}
-//# sourceMappingURL=base.d.ts.map

package/dist/providers/base.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,KAAK,EACL,SAAS,EACT,eAAe,EACf,YAAY,EACZ,UAAU,EACV,eAAe,EAEhB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAGzD;;GAEG;AACH,8BAAsB,QAAS,YAAW,SAAS;IACjD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAEpC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAO;IAE/B,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,mCAAmC;IACnC,SAAS,CAAC,cAAc,EAAE,gBAAgB,GAAG,IAAI,CAAO;IAExD,yCAAyC;IACzC,SAAS,CAAC,mBAAmB,EAAE,OAAO,CAAQ;IAE9C,iEAAiE;IACjE,OAAO,CAAC,aAAa,CAA6B;IAElD,sEAAsE;IACtE,OAAO,CAAC,YAAY,CAAoC;IAExD,6FAA6F;IAC7F,OAAO,CAAC,YAAY,CAAkB;IAEtC,uFAAuF;IACvF,OAAO,CAAC,oBAAoB,CAAQ;IAEpC,IAAI,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzB;gBAEW,OAAO,GAAE,eAAoB;IA2BzC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,eAAe;IAE1D;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI;IAEpD;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;;OAGG;IACI,GAAG,CAAC,eAAe,GAAE,MAAM,GAAG,UAAe,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC;YAmB7E,mBAAmB;IAcjC,yFAAyF;YAC3E,QAAQ;IAQtB,wCAAwC;YAC1B,YAAY;IAO1B;;OAEG;YACY,UAAU;IAuDzB;;OAEG;YACY,QAAQ;IA4EvB,wFAAwF;cACxE,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAC3D,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,QAAQ,CAAC,EAAE,OAAO,mBAAmB,EAAE,YAAY,CAAA;QACnD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAC1B,GAAG,IAAI,CAAC;IAuCT,wGAAwG;IAClG,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAUhD,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,QAAQ,CAAC,EAAE,OAAO,mBAAmB,EAAE,YAAY,CAAA;QACnD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAC1B,GACA,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;OAIG;IACG,0BAA0B,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IA4CpE;;OAEG;IACG,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMzE;;;;OAIG;IACG,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBhE;;;;;;OAMG;IACG,iCAAiC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe7E;;;OAGG;IACG,kCAAkC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QACpE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;QACxB,MAAM,EAAE,KAAK,EAAE,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;KACf,CAAC;IAiFF;;;;;OAKG;IACG,sBAAsB,CAC1B,OAAO,EAAE,UAAU,GAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3D,OAAO,CAAC;QACT,WAAW,EAAE,MAAM,CAAA;QACnB,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,MAAM,CAAA;QAClB,MAAM,EAAE,MAAM,CAAA;KACf,CAAC;IA0DF;;;OAGG;IACG,qBAAqB,CACzB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CAAC;QACT,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;QAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;QACxB,MAAM,EAAE,KAAK,EAAE,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,EAAE,MAAM,CAAA;KAClB,CAAC;IAsGF;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAChD,eAAe,GAAE,MAAM,GAAG,UAAe,GACxC,OAAO,CAAC,IAAI,CAAC;IAMhB;;OAEG;IACG,aAAa,CAAC,eAAe,GAAE,MAAM,GAAG,UAAe,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAQhF;;OAEG;IACG,WAAW,CAAC,eAAe,GAAE,MAAM,GAAG,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC;CAS9E"}