background-agents 0.1.2 → 1.0.0

package/dist/index.js

@@ -1,62 +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: '...' } })
- *
- * const session = await createSession("claude", {
- *   sandbox,
- *   systemPrompt: 'You are a helpful assistant.',
- * })
- *
- * // Start a turn
- * await session.start("Hello!")
- *
- * // Poll for events
- * while (true) {
- *   const result = await session.getEvents()
- *   for (const event of result.events) {
- *     if (event.type === "token") process.stdout.write(event.text)
- *   }
- *   if (!result.running) break
- *   await new Promise(r => setTimeout(r, 500))
- * }
- *
- * await sandbox.delete()
- * ```
- */
-// ─────────────────────────────────────────────────────────────────────────────
-// Session API (Main Entry Point)
-// ─────────────────────────────────────────────────────────────────────────────
-export { createSession, getSession, getAgentNames, } from "./session";
-// ─────────────────────────────────────────────────────────────────────────────
-// Agent Registry
-// ─────────────────────────────────────────────────────────────────────────────
-export { registry, getAgent } from "./core/registry";
-// ─────────────────────────────────────────────────────────────────────────────
-// Tool Utilities
-// ─────────────────────────────────────────────────────────────────────────────
-export { normalizeToolName, createToolStartEvent, getToolDisplayName, CANONICAL_DISPLAY_NAMES, } from "./core/tools";
-// ─────────────────────────────────────────────────────────────────────────────
-// Agent Definitions (for direct import)
-// ─────────────────────────────────────────────────────────────────────────────
-export { claudeAgent, codexAgent, geminiAgent, opencodeAgent, } from "./agents/index";
-// ─────────────────────────────────────────────────────────────────────────────
-// Sandbox Adapter
-// ─────────────────────────────────────────────────────────────────────────────
-export { adaptDaytonaSandbox, adaptSandbox } from "./sandbox/index";
-// ─────────────────────────────────────────────────────────────────────────────
-// Utilities
-// ─────────────────────────────────────────────────────────────────────────────
-export { safeJsonParse, isCliInstalled, installProvider, ensureCliInstalled, getPackageName, getInstallationStatus, } from "./utils/index";
-// Debug (enable with CODING_AGENTS_DEBUG=1)
-export { isDebugEnabled, debugLog } from "./debug";
-//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AA6DH,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,UAAU,EACV,aAAa,GAGd,MAAM,WAAW,CAAA;AAElB,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAEpD,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,cAAc,CAAA;AAErB,gFAAgF;AAChF,wCAAwC;AACxC,gFAAgF;AAEhF,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,gBAAgB,CAAA;AAEvB,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnE,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,eAAe,CAAA;AAEtB,4CAA4C;AAC5C,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA"}

package/dist/providers/base.d.ts

@@ -1,187 +0,0 @@
-import type { Event, IProvider, ProviderCommand, ProviderName, RunOptions, ProviderOptions, BackgroundRunPhase } 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;
-    /** Resolves when initial setup (install + env) has completed. */
-    private _readyPromise;
-    /** Defaults merged into every run (model, timeout, sessionId, env). Set by createSession. */
-    private _runDefaults;
-    /** Tracks whether session-level env has been applied */
-    private _sessionEnvApplied;
-    /** 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 session-level env. Run in microtask so subclass name is set. */
-    private _doSetup;
-    /** Per-run: clear previous run-level env, set new run-level env, and handle Codex login. */
-    private _applyRunEnv;
-    /**
-     * Run in a secure Daytona sandbox
-     */
-    private runSandbox;
-    /** 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>;
-    /**
-     * Best-effort no-op write guard for polling paths. Skips writing meta when no
-     * relevant fields changed to reduce sandbox file writes on every poll.
-     */
-    protected writeSandboxMetaIfChanged(sessionDir: string, next: {
-        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;
-    }, prev?: {
-        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): 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 robust multi-step kill: SIGTERM -> SIGKILL -> pkill fallback.
-     * Writes the done file after kill so isRunning() becomes false.
-     */
-    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>;
-    private isSandboxBackgroundOutputRunning;
-    /**
-     * Get new events for the current turn; reads and updates cursor in sandbox meta.
-     * Uses optimized polling when available (2 round trips instead of 4).
-     */
-    getEventsSandboxBackgroundFromMeta(sessionDir: string): Promise<{
-        sessionId: string | null;
-        events: Event[];
-        cursor: string;
-        running: boolean;
-        runPhase: BackgroundRunPhase;
-    }>;
-    /** Process poll result and update meta. Shared by all polling paths. */
-    private _handlePollResult;
-    /**
-     * 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.
-     * If prefetchedContent is provided, uses that instead of fetching from sandbox.
-     */
-    pollSandboxBackground(outputFile: string, cursor?: string | null, rawCursor?: string | null, prefetchedContent?: string | null): Promise<{
-        status: "running" | "completed";
-        sessionId: string | null;
-        events: Event[];
-        cursor: string;
-        rawCursor: string;
-        rawOutput?: 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":"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"}