background-agents 0.1.1 → 0.1.2

package/dist/types/provider.d.ts

@@ -1,10 +1,14 @@
-import type { Event } from "./events.js";
 /**
- * Provider-related types and interfaces
+ * Sandbox and Provider Types
+ */
+/**
+ * Supported agent names.
+ * Used by ensureProvider() to install the correct CLI.
+ */
+export type ProviderName = "claude" | "codex" | "eliza" | "goose" | "opencode" | "gemini" | "pi";
+/**
+ * Options for starting a background command that writes to a log file.
  */
-/** Supported provider names */
-export type ProviderName = "claude" | "codex" | "opencode" | "gemini";
-/** Options for starting a background command that writes to a log file and signals when done. */
 export interface ExecuteBackgroundOptions {
     /** Full command line to run (stdout/stderr should be appended to outputFile). */
     command: string;
@@ -12,113 +16,52 @@ export interface ExecuteBackgroundOptions {
     outputFile: string;
     /** Unique run id (used for logging; PID is returned from executeBackground). */
     runId: string;
+    /** Timeout in minutes */
     timeout?: number;
 }
 /**
- * Sandbox interface required by the SDK. Implement this yourself or use
- * adaptDaytonaSandbox() to wrap a Daytona Sandbox from @daytonaio/sdk.
+ * Sandbox interface required by the SDK.
+ *
+ * Implement this yourself or use adaptDaytonaSandbox() to wrap
+ * a Daytona Sandbox from @daytonaio/sdk.
  */
 export interface CodeAgentSandbox {
+    /** Install the provider CLI if not already installed */
     ensureProvider(name: ProviderName): Promise<void>;
+    /** Set environment variables for subsequent commands */
     setEnvVars(vars: Record<string, string>): void;
-    executeCommandStream(command: string, timeout?: number): AsyncGenerator<string, void, unknown>;
-    /** Optional: run a one-off command (used e.g. for Codex login). */
+    /** Set session-level env vars (persistent across runs) */
+    setSessionEnvVars?(vars: Record<string, string>): void;
+    /** Set run-level env vars (cleared after each run) */
+    setRunEnvVars?(vars: Record<string, string>): void;
+    /** Clear run-level env vars */
+    clearRunEnvVars?(): void;
+    /** Run a one-off command and return the result */
     executeCommand?(command: string, timeout?: number): Promise<{
         exitCode: number;
         output: string;
     }>;
     /**
-     * Optional: start a command in the background and return its pid immediately.
-     * The sandbox must run the command with stdout/stderr >> outputFile and return
-     * the pid (e.g. via nohup + SSH so the channel closes right away). Implement
-     * this to avoid blocking on the command when using executeCommand.
+     * Start a command in the background and return its PID immediately.
+     * The sandbox must run the command with stdout/stderr >> outputFile.
      */
     executeBackground?(options: ExecuteBackgroundOptions): Promise<{
         pid: number;
     }>;
-    /**
-     * Optional: kill a process by pid. Must use the same execution context that
-     * started it (e.g. SSH); process API kill won't see pids started over SSH.
-     */
-    killBackgroundProcess?(pid: number): Promise<void>;
-}
-/** Command configuration for spawning a provider process */
-export interface ProviderCommand {
-    cmd: string;
-    args: string[];
-    env?: Record<string, string>;
+    /** Kill a background process by PID */
+    killBackgroundProcess?(pid: number, processName?: string): Promise<void>;
+    /** Optimized poll: reads meta, output, and done status in fewer commands */
+    pollBackgroundState?(sessionDir: string): Promise<{
+        meta: string | null;
+        output: string;
+        done: boolean;
+    } | null>;
 }
-/** Options when adapting a Daytona sandbox for use with the SDK */
+/**
+ * Options when adapting a Daytona sandbox for use with the SDK.
+ */
 export interface AdaptSandboxOptions {
-    /** Environment variables for CLI execution (e.g. ANTHROPIC_API_KEY) */
+    /** Environment variables for CLI execution */
     env?: Record<string, string>;
 }
-/** Options for running a provider */
-export interface RunOptions {
-    /** The prompt to send to the provider */
-    prompt?: string;
-    /**
-     * Optional system prompt / high-level instructions.
-     * When set via createSession, providers that support system prompts will use
-     * their native mechanism; others will have this string prepended to the first
-     * user prompt in the session.
-     */
-    systemPrompt?: string;
-    /** Optional session ID to resume */
-    sessionId?: string;
-    /** Whether to persist session ID to file (only for local mode) */
-    persistSession?: boolean;
-    /** Custom session file path (only for local mode) */
-    sessionFile?: string;
-    /** Working directory for the provider process */
-    cwd?: string;
-    /** Environment variables to pass to the provider */
-    env?: Record<string, string>;
-    /** Skip installing the CLI in the sandbox (default: false) */
-    skipInstall?: boolean;
-    /** Timeout in seconds for sandbox execution (default: 120) */
-    timeout?: number;
-    /** Model to use (provider-specific, e.g., "openai/gpt-4o") */
-    model?: string;
-}
-/** Default run options merged into every run (used by createSession) */
-export type RunDefaults = Partial<Omit<RunOptions, "prompt">>;
-/** Options for creating a provider */
-export interface ProviderOptions {
-    /**
-     * Sandbox for secure execution. Pass a Sandbox from @daytonaio/sdk directly
-     * (the SDK adapts it internally). Optional env here is used for CLI execution.
-     */
-    sandbox?: CodeAgentSandbox | import("@daytonaio/sdk").Sandbox;
-    /** Environment variables for CLI execution (e.g. when sandbox is a Daytona Sandbox) */
-    env?: Record<string, string>;
-    /** Skip installing the provider CLI when the provider is created (default: false) */
-    skipInstall?: boolean;
-    /**
-     * Allow running commands directly on local machine without sandbox.
-     * ⚠️ DANGEROUS: Only use this if you trust the code being executed.
-     */
-    dangerouslyAllowLocalExecution?: boolean;
-    /** Defaults merged into every run() call (model, timeout, sessionId, env). Set by createSession. */
-    runDefaults?: RunDefaults;
-}
-/** Event handler callback */
-export type EventHandler = (event: Event) => void | Promise<void>;
-/** Provider interface that all providers must implement */
-export interface IProvider {
-    /** Provider name */
-    readonly name: ProviderName;
-    /** Current session ID */
-    sessionId: string | null;
-    /** Convenience accessor for current session id */
-    getSessionId(): string | null;
-    /** Get the command to spawn the provider */
-    getCommand(options?: RunOptions): ProviderCommand;
-    /** Parse a line of output into one or more events */
-    parse(line: string): Event | Event[] | null;
-    /** Resolves when CLI install and setup (env, Codex login) have completed. Await before first run if you want "ready" UX. */
-    readonly ready: Promise<void>;
-    /** Run the provider and emit events. Pass a prompt string or full RunOptions. */
-    run(promptOrOptions?: string | RunOptions): AsyncGenerator<Event, void, unknown>;
-}
 //# sourceMappingURL=provider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/types/provider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/types/provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,IAAI,CAAA;AAEhG;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAA;IAClB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAA;IACb,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjD,wDAAwD;IACxD,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IAE9C,0DAA0D;IAC1D,iBAAiB,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IAEtD,sDAAsD;IACtD,aAAa,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IAElD,+BAA+B;IAC/B,eAAe,CAAC,IAAI,IAAI,CAAA;IAExB,kDAAkD;IAClD,cAAc,CAAC,CACb,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAEhD;;;OAGG;IACH,iBAAiB,CAAC,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAE/E,uCAAuC;IACvC,qBAAqB,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAExE,4EAA4E;IAC5E,mBAAmB,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAChD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QACnB,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,OAAO,CAAA;KACd,GAAG,IAAI,CAAC,CAAA;CACV;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7B"}

package/dist/types/provider.js

@@ -1,2 +1,5 @@
+/**
+ * Sandbox and Provider Types
+ */
 export {};
 //# sourceMappingURL=provider.js.map

package/dist/types/provider.js.map

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

package/dist/utils/index.d.ts

@@ -1,4 +1,3 @@
-export * from "./json.js";
-export * from "./session.js";
-export * from "./install.js";
+export * from "./json";
+export * from "./install";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA"}

package/dist/utils/index.js

@@ -1,4 +1,3 @@
-export * from "./json.js";
-export * from "./session.js";
-export * from "./install.js";
+export * from "./json";
+export * from "./install";
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA"}

package/dist/utils/install.d.ts

@@ -1,17 +1,27 @@
-import type { ProviderName } from "../types/index.js";
+import type { ProviderName } from "../types/index";
 /**
  * Check if a CLI command is available in PATH
  */
 export declare function isCliInstalled(name: ProviderName): boolean;
 /**
- * Get the npm package name for a provider
+ * Get the npm package name for a provider.
+ * Returns empty string for providers that don't use npm.
  */
 export declare function getPackageName(name: ProviderName): string;
+/**
+ * Get the shell installer command for a provider.
+ * Returns undefined for providers that use npm.
+ */
+export declare function getShellInstaller(name: ProviderName): string | undefined;
 /**
  * Install a provider CLI globally via npm
  * @returns true if installation succeeded
  */
 export declare function installProvider(name: ProviderName): boolean;
+/**
+ * Check if a provider is built-in and doesn't need installation.
+ */
+export declare function isBuiltInProvider(name: ProviderName): boolean;
 /**
  * Ensure a provider CLI is installed, installing it if necessary
  * @param name - Provider name

package/dist/utils/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/utils/install.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAYrD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAU1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAY3D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,WAAW,GAAE,OAAe,GAC3B,OAAO,CA0BT;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CASrE"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/utils/install.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AA6BlD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAU1D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAExE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAY3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAG7D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,WAAW,GAAE,OAAe,GAC3B,OAAO,CA+BT;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAUrE"}

package/dist/utils/install.js

@@ -1,12 +1,28 @@
 import { execSync, spawnSync } from "node:child_process";
 /**
- * CLI package information for each provider
+ * CLI package information for each provider.
+ * Note: goose uses a shell script installer, not npm.
  */
 const PROVIDER_PACKAGES = {
     claude: "@anthropic-ai/claude-code",
     codex: "@openai/codex",
+    eliza: "", // eliza is built-in, no installation needed
+    goose: "", // goose uses shell script installer, not npm
     opencode: "opencode",
     gemini: "@google/gemini-cli",
+    pi: "@mariozechner/pi-coding-agent",
+};
+/**
+ * Shell script installers for providers that don't use npm.
+ * These commands download and install the CLI binary directly.
+ */
+const PROVIDER_SHELL_INSTALLERS = {
+    // Goose: Download the binary directly without the interactive installer script
+    // 1. Create temp and bin directories
+    // 2. Download the tarball for x86_64 Linux
+    // 3. Extract to temp dir and move binary to ~/.local/bin
+    // Use --no-same-owner and --no-same-permissions to avoid permission issues
+    goose: `mkdir -p ~/.local/bin ~/.goose_tmp && curl -fsSL "https://github.com/block/goose/releases/download/stable/goose-x86_64-unknown-linux-gnu.tar.bz2" | tar -xjf - --no-same-owner --no-same-permissions -C ~/.goose_tmp && mv ~/.goose_tmp/goose ~/.local/bin/goose && chmod +x ~/.local/bin/goose && rm -rf ~/.goose_tmp`,
 };
 /**
  * Check if a CLI command is available in PATH
@@ -24,11 +40,19 @@ export function isCliInstalled(name) {
     }
 }
 /**
- * Get the npm package name for a provider
+ * Get the npm package name for a provider.
+ * Returns empty string for providers that don't use npm.
  */
 export function getPackageName(name) {
     return PROVIDER_PACKAGES[name];
 }
+/**
+ * Get the shell installer command for a provider.
+ * Returns undefined for providers that use npm.
+ */
+export function getShellInstaller(name) {
+    return PROVIDER_SHELL_INSTALLERS[name];
+}
 /**
  * Install a provider CLI globally via npm
  * @returns true if installation succeeded
@@ -46,6 +70,13 @@ export function installProvider(name) {
         return false;
     }
 }
+/**
+ * Check if a provider is built-in and doesn't need installation.
+ */
+export function isBuiltInProvider(name) {
+    // ELIZA is built-in: runs via node within the agents package
+    return name === "eliza";
+}
 /**
  * Ensure a provider CLI is installed, installing it if necessary
  * @param name - Provider name
@@ -54,6 +85,10 @@ export function installProvider(name) {
  * @throws Error if CLI is not installed and autoInstall is false
  */
 export function ensureCliInstalled(name, autoInstall = false) {
+    // Built-in providers don't need installation
+    if (isBuiltInProvider(name)) {
+        return true;
+    }
     if (isCliInstalled(name)) {
         return true;
     }
@@ -76,10 +111,11 @@ export function ensureCliInstalled(name, autoInstall = false) {
  * Check installation status of all providers
  */
 export function getInstallationStatus() {
-    const providers = ["claude", "codex", "opencode", "gemini"];
+    const providers = ["claude", "codex", "eliza", "goose", "opencode", "gemini", "pi"];
     const status = {};
     for (const provider of providers) {
-        status[provider] = isCliInstalled(provider);
+        // Built-in providers are always "installed"
+        status[provider] = isBuiltInProvider(provider) || isCliInstalled(provider);
     }
     return status;
 }

package/dist/utils/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/utils/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAGxD;;GAEG;AACH,MAAM,iBAAiB,GAAiC;IACtD,MAAM,EAAE,2BAA2B;IACnC,KAAK,EAAE,eAAe;IACtB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,oBAAoB;CAC7B,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAkB;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE;YACxC,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAA;QACF,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAA;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAkB;IAC/C,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAA;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAkB;IAChD,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAE3C,IAAI,CAAC;QACH,QAAQ,CAAC,kBAAkB,WAAW,EAAE,EAAE;YACxC,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAkB,EAClB,cAAuB,KAAK;IAE5B,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAC3C,MAAM,IAAI,KAAK,CACb,QAAQ,IAAI,sBAAsB;YAChC,mCAAmC,WAAW,EAAE,CACnD,CAAA;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,SAAS,CAAC,CAAA;IACxC,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;IAErC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAC3C,MAAM,IAAI,KAAK,CACb,sBAAsB,IAAI,SAAS;YACjC,gCAAgC,WAAW,EAAE,CAChD,CAAA;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,MAAM,CAAC,CAAA;IACjD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,SAAS,GAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAA;IAC3E,MAAM,MAAM,GAA4B,EAAE,CAAA;IAE1C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;IAC7C,CAAC;IAED,OAAO,MAAuC,CAAA;AAChD,CAAC"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/utils/install.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,18 +1,22 @@
 {
   "name": "background-agents",
-  "version": "0.1.1",
-  "description": "A TypeScript SDK for interacting with various AI coding agents (Claude, Codex, OpenCode, Gemini)",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "version": "0.1.2",
+  "description": "A TypeScript SDK for interacting with various AI coding agents (Claude, Codex, OpenCode, Gemini, Pi)",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
   "type": "module",
   "scripts": {
-    "build": "tsc",
+    "build": "npm run build:eliza && tsc",
+    "build:eliza": "npm run build:eliza-bundle && npm run build:eliza-embed",
+    "build:eliza-bundle": "esbuild src/agents/eliza/cli.ts --bundle --platform=node --format=esm --outfile=dist/agents/eliza/cli.bundle.js",
+    "build:eliza-embed": "npx tsx scripts/embed-eliza-bundle.ts",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "lint": "eslint src --ext .ts",
     "clean": "rm -rf dist",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "generate:jsonl-refs": "npx tsx scripts/generate-jsonl-references.ts"
   },
   "keywords": [
     "ai",
@@ -21,16 +25,26 @@
     "codex",
     "opencode",
     "gemini",
+    "pi",
     "sdk"
   ],
   "author": "",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jamesmurdza/upstream-agents.git",
+    "directory": "packages/agents"
+  },
+  "homepage": "https://github.com/jamesmurdza/upstream-agents/tree/main/packages/agents",
+  "bugs": {
+    "url": "https://github.com/jamesmurdza/upstream-agents/issues"
+  },
   "publishConfig": {
     "access": "public"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
-    "@types/ssh2": "^1.15.5",
+    "esbuild": "^0.20.0",
     "typescript": "^5.3.0",
     "vitest": "^1.0.0"
   },
@@ -43,15 +57,12 @@
     "next.config.codeagentsdk.cjs"
   ],
   "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
+    ".": "./src/index.ts",
+    "./*": "./src/*",
     "./next.config": "./next.config.codeagentsdk.cjs"
   },
   "dependencies": {
     "@daytonaio/sdk": "^0.150.0",
-    "dotenv": "^17.3.1",
-    "ssh2": "^1.17.0"
+    "dotenv": "^17.3.1"
   }
 }

package/src/index.ts

@@ -0,0 +1,156 @@
+/**
+ * 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()
+ * ```
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Event Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+export type {
+  Event,
+  SessionEvent,
+  TokenEvent,
+  ToolStartEvent,
+  ToolDeltaEvent,
+  ToolEndEvent,
+  EndEvent,
+  AgentCrashedEvent,
+  EventType,
+  ToolName,
+  WriteToolInput,
+  ReadToolInput,
+  EditToolInput,
+  GlobToolInput,
+  GrepToolInput,
+  ShellToolInput,
+  ToolInputMap,
+} from "./types/events"
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Core Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+export type {
+  AgentDefinition,
+  AgentCapabilities,
+  CommandSpec,
+  ParseContext,
+  RunOptions,
+} from "./core/agent"
+
+export type { CanonicalToolName } from "./core/tools"
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Background Session Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+export type {
+  BackgroundSession,
+  BackgroundRunPhase,
+  PollResult,
+  TurnHandle,
+} from "./background/index"
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Sandbox Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+export type {
+  CodeAgentSandbox,
+  ExecuteBackgroundOptions,
+  AdaptSandboxOptions,
+} from "./types/provider"
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Session API (Main Entry Point)
+// ─────────────────────────────────────────────────────────────────────────────
+
+export {
+  createSession,
+  getSession,
+  getAgentNames,
+  type SessionOptions,
+  type CreateSessionOptions,
+} 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"

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

@@ -1,9 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}