background-agents 0.1.2 → 1.0.0

package/dist/background/types.d.ts

@@ -1,55 +0,0 @@
-/**
- * Background Session Types
- */
-import type { Event } from "../types/events";
-/**
- * Run phase for background sessions
- */
-export type BackgroundRunPhase = "idle" | "starting" | "running" | "stopped";
-/**
- * Handle returned when starting a turn
- */
-export interface TurnHandle {
-    executionId: string;
-    pid: number;
-    outputFile: string;
-}
-/**
- * Result of polling for events
- */
-export interface PollResult {
-    sessionId: string | null;
-    events: Event[];
-    cursor: string;
-    running: boolean;
-    runPhase: BackgroundRunPhase;
-}
-/**
- * Session metadata stored in sandbox
- */
-export interface SessionMeta {
-    currentTurn: number;
-    cursor: number;
-    rawCursor?: number;
-    pid?: number;
-    runId?: string;
-    outputFile?: string;
-    sawEnd?: boolean;
-    startedAt?: string;
-    provider?: string;
-    sessionId?: string | null;
-}
-/**
- * Options for starting a turn
- */
-export interface StartOptions {
-    prompt: string;
-    model?: string;
-    sessionId?: string;
-    timeout?: number;
-    systemPrompt?: string;
-    env?: Record<string, string>;
-    /** Working directory for the agent process */
-    cwd?: string;
-}
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/background/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAE5C;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAA;AAE5E;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,kBAAkB,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAA;CACb"}

package/dist/background/types.js

@@ -1,5 +0,0 @@
-/**
- * Background Session Types
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/background/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/background/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/core/agent.d.ts

@@ -1,95 +0,0 @@
-/**
- * Core Agent Definition Interface
- *
- * This is the minimal interface for implementing a new agent.
- * No inheritance required - just implement this interface.
- */
-import type { Event } from "../types/events";
-import type { CodeAgentSandbox } from "../types/provider";
-/**
- * Command specification returned by buildCommand()
- */
-export interface CommandSpec {
-    /** The CLI command to run */
-    cmd: string;
-    /** Arguments to pass to the command */
-    args: string[];
-    /** Environment variables for this command */
-    env?: Record<string, string>;
-    /** If true, wrap in bash for stderr handling */
-    wrapInBash?: boolean;
-    /** Working directory for the command */
-    cwd?: string;
-}
-/**
- * Context passed to parse() for stateful parsing
- */
-export interface ParseContext {
-    /** Mutable state for stateful parsing (e.g., Gemini tool buffer) */
-    state: Record<string, unknown>;
-    /** Current session ID if known */
-    sessionId: string | null;
-}
-/**
- * Run options passed to buildCommand()
- */
-export interface RunOptions {
-    prompt?: string;
-    model?: string;
-    sessionId?: string;
-    timeout?: number;
-    systemPrompt?: string;
-    env?: Record<string, string>;
-    /** Working directory for the agent process */
-    cwd?: string;
-}
-/**
- * Agent capabilities - optional features an agent supports
- */
-export interface AgentCapabilities {
-    /** Agent supports native system prompt (vs synthetic prefix) */
-    supportsSystemPrompt?: boolean;
-    /** Agent supports session resumption */
-    supportsResume?: boolean;
-    /** Agent requires special setup (e.g., login) */
-    setup?: (sandbox: CodeAgentSandbox, env: Record<string, string>) => Promise<void>;
-}
-/**
- * The core agent definition interface.
- *
- * Implement this interface to add a new agent. No inheritance required.
- *
- * @example
- * ```typescript
- * export const myAgent: AgentDefinition = {
- *   name: 'my-agent',
- *   toolMappings: { my_tool: 'shell' },
- *   buildCommand(options) {
- *     return { cmd: 'my-agent', args: ['--json', options.prompt ?? ''] }
- *   },
- *   parse(line, context) {
- *     const json = JSON.parse(line)
- *     if (json.type === 'text') return { type: 'token', text: json.content }
- *     return null
- *   },
- * }
- * ```
- */
-export interface AgentDefinition {
-    /** Unique agent identifier */
-    readonly name: string;
-    /** Tool name mappings (provider-specific -> canonical) */
-    readonly toolMappings: Record<string, string>;
-    /** Optional agent capabilities */
-    readonly capabilities?: AgentCapabilities;
-    /**
-     * Build the CLI command to run the agent
-     */
-    buildCommand(options: RunOptions): CommandSpec;
-    /**
-     * Parse a line of output into event(s)
-     * @returns Event, array of events, or null if line should be ignored
-     */
-    parse(line: string, context: ParseContext): Event | Event[] | null;
-}
-//# sourceMappingURL=agent.d.ts.map

package/dist/core/agent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/core/agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,uCAAuC;IACvC,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,gDAAgD;IAChD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,kCAAkC;IAClC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,iDAAiD;IACjD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAClF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE7C,kCAAkC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAA;IAEzC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,WAAW,CAAA;IAE9C;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI,CAAA;CACnE"}

package/dist/core/agent.js

@@ -1,8 +0,0 @@
-/**
- * Core Agent Definition Interface
- *
- * This is the minimal interface for implementing a new agent.
- * No inheritance required - just implement this interface.
- */
-export {};
-//# sourceMappingURL=agent.js.map

package/dist/core/agent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/core/agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Core module exports
- */
-export type { AgentDefinition, AgentCapabilities, CommandSpec, ParseContext, RunOptions, } from "./agent";
-export { registry, getAgent, getAgentNames } from "./registry";
-export { normalizeToolName, createToolStartEvent, getToolDisplayName, CANONICAL_DISPLAY_NAMES, type CanonicalToolName, } from "./tools";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,UAAU,GACX,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE9D,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,iBAAiB,GACvB,MAAM,SAAS,CAAA"}

package/dist/core/index.js

@@ -1,6 +0,0 @@
-/**
- * Core module exports
- */
-export { registry, getAgent, getAgentNames } from "./registry";
-export { normalizeToolName, createToolStartEvent, getToolDisplayName, CANONICAL_DISPLAY_NAMES, } from "./tools";
-//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE9D,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,GAExB,MAAM,SAAS,CAAA"}

package/dist/core/registry.d.ts

@@ -1,48 +0,0 @@
-/**
- * Agent Registry
- *
- * A pluggable registry for agent definitions.
- * Replaces the hardcoded switch-based factory.
- */
-import type { AgentDefinition } from "./agent";
-/**
- * Registry for agent definitions.
- * Use the singleton `registry` instance.
- */
-declare class AgentRegistry {
-    private agents;
-    /**
-     * Register an agent definition.
-     * @throws Error if agent with same name already registered
-     */
-    register(agent: AgentDefinition): void;
-    /**
-     * Get an agent definition by name.
-     */
-    get(name: string): AgentDefinition | undefined;
-    /**
-     * Get all registered agent names.
-     */
-    getNames(): string[];
-    /**
-     * Check if an agent is registered.
-     */
-    has(name: string): boolean;
-    /**
-     * Clear all registered agents (for testing).
-     */
-    clear(): void;
-}
-/** Singleton registry instance */
-export declare const registry: AgentRegistry;
-/**
- * Get an agent definition by name.
- * @throws Error if agent not found
- */
-export declare function getAgent(name: string): AgentDefinition;
-/**
- * Get all registered agent names.
- */
-export declare function getAgentNames(): string[];
-export {};
-//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C;;;GAGG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAAqC;IAEnD;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAOtC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI9C;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED,kCAAkC;AAClC,eAAO,MAAM,QAAQ,eAAsB,CAAA;AAE3C;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAStD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC"}

package/dist/core/registry.js

@@ -1,68 +0,0 @@
-/**
- * Agent Registry
- *
- * A pluggable registry for agent definitions.
- * Replaces the hardcoded switch-based factory.
- */
-/**
- * Registry for agent definitions.
- * Use the singleton `registry` instance.
- */
-class AgentRegistry {
-    agents = new Map();
-    /**
-     * Register an agent definition.
-     * @throws Error if agent with same name already registered
-     */
-    register(agent) {
-        if (this.agents.has(agent.name)) {
-            throw new Error(`Agent "${agent.name}" is already registered`);
-        }
-        this.agents.set(agent.name, agent);
-    }
-    /**
-     * Get an agent definition by name.
-     */
-    get(name) {
-        return this.agents.get(name);
-    }
-    /**
-     * Get all registered agent names.
-     */
-    getNames() {
-        return Array.from(this.agents.keys());
-    }
-    /**
-     * Check if an agent is registered.
-     */
-    has(name) {
-        return this.agents.has(name);
-    }
-    /**
-     * Clear all registered agents (for testing).
-     */
-    clear() {
-        this.agents.clear();
-    }
-}
-/** Singleton registry instance */
-export const registry = new AgentRegistry();
-/**
- * Get an agent definition by name.
- * @throws Error if agent not found
- */
-export function getAgent(name) {
-    const agent = registry.get(name);
-    if (!agent) {
-        const available = registry.getNames();
-        throw new Error(`Unknown agent: "${name}". Available: ${available.length ? available.join(", ") : "(none registered)"}`);
-    }
-    return agent;
-}
-/**
- * Get all registered agent names.
- */
-export function getAgentNames() {
-    return registry.getNames();
-}
-//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,MAAM,aAAa;IACT,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAA;IAEnD;;;OAGG;IACH,QAAQ,CAAC,KAAsB;QAC7B,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,yBAAyB,CAAC,CAAA;QAChE,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACpC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IACvC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;CACF;AAED,kCAAkC;AAClC,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAA;AAE3C;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAA;QACrC,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,iBAAiB,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB,EAAE,CACxG,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAA;AAC5B,CAAC"}

package/dist/core/tools.d.ts

@@ -1,31 +0,0 @@
-/**
- * Centralized Tool Normalization
- *
- * Single source of truth for tool name normalization.
- * Each agent provides its own mappings, but normalization logic is shared.
- */
-import type { ToolStartEvent } from "../types/events";
-/**
- * Canonical tool names used across all agents.
- * Consumers only see these names.
- */
-export type CanonicalToolName = "read" | "write" | "edit" | "glob" | "grep" | "shell" | "web_search";
-/**
- * Reverse mapping: canonical -> display name (for UI)
- */
-export declare const CANONICAL_DISPLAY_NAMES: Record<CanonicalToolName, string>;
-/**
- * Normalize a provider-specific tool name to canonical form.
- * Uses agent's mappings first, then falls back to lowercase.
- */
-export declare function normalizeToolName(providerName: string, agentMappings: Record<string, string>): string;
-/**
- * Get display name for a canonical tool name.
- */
-export declare function getToolDisplayName(canonicalName: string): string;
-/**
- * Create a normalized ToolStartEvent.
- * This is the single point for creating tool_start events.
- */
-export declare function createToolStartEvent(name: string, rawInput: unknown, agentMappings?: Record<string, string>): ToolStartEvent;
-//# sourceMappingURL=tools.d.ts.map

package/dist/core/tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/core/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,GACN,MAAM,GACN,OAAO,GACP,YAAY,CAAA;AAEhB;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAQrE,CAAA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAIhE;AAmDD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EACjB,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACzC,cAAc,CAShB"}

package/dist/core/tools.js

@@ -1,82 +0,0 @@
-/**
- * Centralized Tool Normalization
- *
- * Single source of truth for tool name normalization.
- * Each agent provides its own mappings, but normalization logic is shared.
- */
-/**
- * Reverse mapping: canonical -> display name (for UI)
- */
-export const CANONICAL_DISPLAY_NAMES = {
-    read: "Read",
-    write: "Write",
-    edit: "Edit",
-    glob: "Glob",
-    grep: "Grep",
-    shell: "Bash",
-    web_search: "Web Search",
-};
-/**
- * Normalize a provider-specific tool name to canonical form.
- * Uses agent's mappings first, then falls back to lowercase.
- */
-export function normalizeToolName(providerName, agentMappings) {
-    return agentMappings[providerName] ?? providerName.toLowerCase();
-}
-/**
- * Get display name for a canonical tool name.
- */
-export function getToolDisplayName(canonicalName) {
-    return (CANONICAL_DISPLAY_NAMES[canonicalName] ?? canonicalName);
-}
-/**
- * Normalize tool input to a consistent format.
- * Extracts file_path from various field names.
- */
-function normalizeToolInput(toolName, rawInput) {
-    if (!rawInput || typeof rawInput !== "object") {
-        return {};
-    }
-    const input = rawInput;
-    const result = { ...input };
-    // Normalize file path field names
-    if (toolName === "read" ||
-        toolName === "write" ||
-        toolName === "edit" ||
-        toolName === "glob" ||
-        toolName === "grep") {
-        const filePath = input.file_path ?? input.filePath ?? input.path ?? input.target;
-        if (filePath !== undefined) {
-            result.file_path = filePath;
-        }
-    }
-    // Normalize command field for shell
-    if (toolName === "shell") {
-        const command = input.command ?? input.cmd ?? input.script;
-        if (command !== undefined) {
-            result.command = command;
-        }
-    }
-    // Normalize pattern field for grep/glob
-    if (toolName === "grep" || toolName === "glob") {
-        const pattern = input.pattern ?? input.query ?? input.search;
-        if (pattern !== undefined) {
-            result.pattern = pattern;
-        }
-    }
-    return result;
-}
-/**
- * Create a normalized ToolStartEvent.
- * This is the single point for creating tool_start events.
- */
-export function createToolStartEvent(name, rawInput, agentMappings = {}) {
-    const normalizedName = normalizeToolName(name, agentMappings);
-    const normalizedInput = normalizeToolInput(normalizedName, rawInput);
-    return {
-        type: "tool_start",
-        name: normalizedName,
-        input: normalizedInput,
-    };
-}
-//# sourceMappingURL=tools.js.map

package/dist/core/tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/core/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAsC;IACxE,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,UAAU,EAAE,YAAY;CACzB,CAAA;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAAoB,EACpB,aAAqC;IAErC,OAAO,aAAa,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,WAAW,EAAE,CAAA;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,aAAqB;IACtD,OAAO,CACL,uBAAuB,CAAC,aAAkC,CAAC,IAAI,aAAa,CAC7E,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CACzB,QAAgB,EAChB,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,KAAK,GAAG,QAAmC,CAAA;IACjD,MAAM,MAAM,GAA4B,EAAE,GAAG,KAAK,EAAE,CAAA;IAEpD,kCAAkC;IAClC,IACE,QAAQ,KAAK,MAAM;QACnB,QAAQ,KAAK,OAAO;QACpB,QAAQ,KAAK,MAAM;QACnB,QAAQ,KAAK,MAAM;QACnB,QAAQ,KAAK,MAAM,EACnB,CAAC;QACD,MAAM,QAAQ,GACZ,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAA;QACjE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,SAAS,GAAG,QAAQ,CAAA;QAC7B,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,CAAA;QAC1D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;QAC1B,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAA;QAC5D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,QAAiB,EACjB,gBAAwC,EAAE;IAE1C,MAAM,cAAc,GAAG,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;IAC7D,MAAM,eAAe,GAAG,kBAAkB,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAA;IAEpE,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,eAAe;KACvB,CAAA;AACH,CAAC"}

package/dist/debug.d.ts

@@ -1,7 +0,0 @@
-/**
- * Debug logging for the SDK. Enable with env CODING_AGENTS_DEBUG=1 (or non-empty).
- * Logs agent lifecycle (start/stop), background runs, and any lines that fail to parse.
- */
-export declare function isDebugEnabled(): boolean;
-export declare function debugLog(message: string, sessionId?: string | null, ...args: unknown[]): void;
-//# sourceMappingURL=debug.d.ts.map

package/dist/debug.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAID,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAK7F"}

package/dist/debug.js

@@ -1,19 +0,0 @@
-/**
- * Debug logging for the SDK. Enable with env CODING_AGENTS_DEBUG=1 (or non-empty).
- * Logs agent lifecycle (start/stop), background runs, and any lines that fail to parse.
- */
-const DEBUG_ENABLED = typeof process !== "undefined" &&
-    process.env &&
-    String(process.env.CODING_AGENTS_DEBUG ?? "").trim() !== "";
-export function isDebugEnabled() {
-    return DEBUG_ENABLED;
-}
-const PREFIX = "[agents]";
-export function debugLog(message, sessionId, ...args) {
-    if (!DEBUG_ENABLED)
-        return;
-    const sessionTag = sessionId != null && sessionId !== "" ? ` sessionId=${sessionId}` : "";
-    const line = args.length ? `${message} ${args.map(a => (typeof a === "object" ? JSON.stringify(a) : String(a))).join(" ")}` : message;
-    process.stderr.write(`${PREFIX}${sessionTag} ${line}\n`);
-}
-//# sourceMappingURL=debug.js.map

package/dist/debug.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"debug.js","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,aAAa,GACjB,OAAO,OAAO,KAAK,WAAW;IAC9B,OAAO,CAAC,GAAG;IACX,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;AAE7D,MAAM,UAAU,cAAc;IAC5B,OAAO,aAAa,CAAA;AACtB,CAAC;AAED,MAAM,MAAM,GAAG,UAAU,CAAA;AAEzB,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,SAAyB,EAAE,GAAG,IAAe;IACrF,IAAI,CAAC,aAAa;QAAE,OAAM;IAC1B,MAAM,UAAU,GAAG,SAAS,IAAI,IAAI,IAAI,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,cAAc,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACzF,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;IACrI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,UAAU,IAAI,IAAI,IAAI,CAAC,CAAA;AAC1D,CAAC"}

package/dist/factory.d.ts

@@ -1,28 +0,0 @@
-import type { ProviderName, ProviderOptions } from "./types/index.js";
-import { Provider } from "./providers/index.js";
-/**
- * Create a provider instance by name
- *
- * @param name - The provider name ("claude", "codex", "opencode", "gemini")
- * @param options - Provider options (sandbox is required for secure execution)
- * @returns A provider instance
- * @throws Error if the provider name is unknown
- *
- * @example
- * ```typescript
- * import { Daytona } from "@daytonaio/sdk"
- * const daytona = new Daytona({ apiKey: process.env.DAYTONA_API_KEY })
- * const sandbox = await daytona.create({ envVars: { ... } })
- * const provider = createProvider("claude", { sandbox })
- * ```
- */
-export declare function createProvider(name: ProviderName | string, options: ProviderOptions): Provider;
-/**
- * Get all available provider names
- */
-export declare function getProviderNames(): ProviderName[];
-/**
- * Check if a provider name is valid
- */
-export declare function isValidProvider(name: string): name is ProviderName;
-//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,QAAQ,EAAmE,MAAM,sBAAsB,CAAA;AAEhH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,QAAQ,CAa9F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,EAAE,CAEjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,YAAY,CAElE"}

package/dist/factory.js

@@ -1,44 +0,0 @@
-import { ClaudeProvider, CodexProvider, OpenCodeProvider, GeminiProvider } from "./providers/index.js";
-/**
- * Create a provider instance by name
- *
- * @param name - The provider name ("claude", "codex", "opencode", "gemini")
- * @param options - Provider options (sandbox is required for secure execution)
- * @returns A provider instance
- * @throws Error if the provider name is unknown
- *
- * @example
- * ```typescript
- * import { Daytona } from "@daytonaio/sdk"
- * const daytona = new Daytona({ apiKey: process.env.DAYTONA_API_KEY })
- * const sandbox = await daytona.create({ envVars: { ... } })
- * const provider = createProvider("claude", { sandbox })
- * ```
- */
-export function createProvider(name, options) {
-    switch (name) {
-        case "claude":
-            return new ClaudeProvider(options);
-        case "codex":
-            return new CodexProvider(options);
-        case "opencode":
-            return new OpenCodeProvider(options);
-        case "gemini":
-            return new GeminiProvider(options);
-        default:
-            throw new Error(`Unknown provider: ${name}. Valid providers are: claude, codex, opencode, gemini`);
-    }
-}
-/**
- * Get all available provider names
- */
-export function getProviderNames() {
-    return ["claude", "codex", "opencode", "gemini"];
-}
-/**
- * Check if a provider name is valid
- */
-export function isValidProvider(name) {
-    return getProviderNames().includes(name);
-}
-//# sourceMappingURL=factory.js.map

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;;;;;;;;;;;;;;;GAeG;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,48 +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()
- * ```
- */
-export type { Event, SessionEvent, TokenEvent, ToolStartEvent, ToolDeltaEvent, ToolEndEvent, EndEvent, AgentCrashedEvent, EventType, ToolName, WriteToolInput, ReadToolInput, EditToolInput, GlobToolInput, GrepToolInput, ShellToolInput, ToolInputMap, } from "./types/events";
-export type { AgentDefinition, AgentCapabilities, CommandSpec, ParseContext, RunOptions, } from "./core/agent";
-export type { CanonicalToolName } from "./core/tools";
-export type { BackgroundSession, BackgroundRunPhase, PollResult, TurnHandle, } from "./background/index";
-export type { CodeAgentSandbox, ExecuteBackgroundOptions, AdaptSandboxOptions, } from "./types/provider";
-export { createSession, getSession, getAgentNames, type SessionOptions, type CreateSessionOptions, } from "./session";
-export { registry, getAgent } from "./core/registry";
-export { normalizeToolName, createToolStartEvent, getToolDisplayName, CANONICAL_DISPLAY_NAMES, } from "./core/tools";
-export { claudeAgent, codexAgent, geminiAgent, opencodeAgent, } from "./agents/index";
-export { adaptDaytonaSandbox, adaptSandbox } from "./sandbox/index";
-export { safeJsonParse, isCliInstalled, installProvider, ensureCliInstalled, getPackageName, getInstallationStatus, } from "./utils/index";
-export { isDebugEnabled, debugLog } from "./debug";
-//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,YAAY,EACV,KAAK,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,gBAAgB,CAAA;AAMvB,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,UAAU,GACX,MAAM,cAAc,CAAA;AAErB,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAMrD,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,UAAU,GACX,MAAM,oBAAoB,CAAA;AAM3B,YAAY,EACV,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA;AAMzB,OAAO,EACL,aAAa,EACb,UAAU,EACV,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,WAAW,CAAA;AAMlB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAMpD,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,cAAc,CAAA;AAMrB,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,gBAAgB,CAAA;AAMvB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAMnE,OAAO,EACL,aAAa,EACb,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA"}