@agent-compose/sdk 0.1.0

package/dist/runtimes/claude.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Claude CLI runtime — drives agents via the Claude CLI inside a sandbox.
+ *
+ * Works with any SandboxProvider (E2B, Vercel, etc.) — the provider is
+ * selected via SANDBOX_PROVIDER env var, not the runtime definition.
+ *
+ * Usage:
+ *   import { createClaudeRuntime } from "@agent-compose/sdk";
+ *   export default createClaudeRuntime({ claudeMdContent: "..." }); // optional global instructions
+ */
+import type { SandboxProvider, AgentMessage, ModelExecutionContract, RuntimeOptions } from "../index.js";
+export declare class ClaudeRunner implements ModelExecutionContract {
+    private sandbox;
+    private options;
+    private claudeMdContent;
+    private configEnv;
+    private configModel?;
+    private configMcpServers?;
+    private claudeMdWritten;
+    private homeDir;
+    private label;
+    constructor(sandbox: SandboxProvider, options?: RuntimeOptions, claudeMdContent?: string, configEnv?: Record<string, string>, configModel?: string | undefined, configMcpServers?: Record<string, {
+        command: string;
+        args?: string[];
+        env?: Record<string, string>;
+    }> | undefined);
+    private getHomeDir;
+    private deployGlobalConfig;
+    /** Stream one CLI invocation, yielding AgentMessages. Resolves when the process exits. */
+    private _runCli;
+    sendMessage(opts: {
+        prompt: string;
+        sessionId?: string;
+        signal?: AbortSignal;
+    }): AsyncGenerator<AgentMessage>;
+}
+export interface ClaudeRuntimeConfig {
+    /** Global instructions written to ~/.claude/CLAUDE.md in every sandbox. */
+    claudeMdContent?: string;
+    /**
+     * Environment variables set before each CLI invocation.
+     * Use to configure API provider routing (e.g. OpenRouter):
+     *   env: { ANTHROPIC_BASE_URL: "https://openrouter.ai/api", ANTHROPIC_AUTH_TOKEN: "$OPENROUTER_API_KEY", ANTHROPIC_API_KEY: "" }
+     */
+    env?: Record<string, string>;
+    /** Model to use (e.g. "claude-opus-4-6", "anthropic/claude-sonnet-4-6"). */
+    model?: string;
+    /** MCP servers to configure in the sandbox. Written to ~/.claude.json before the first iteration. */
+    mcpServers?: Record<string, {
+        command: string;
+        args?: string[];
+        env?: Record<string, string>;
+    }>;
+}
+/**
+ * Create a Claude CLI runtime.
+ *
+ * Encapsulates everything about how the Claude CLI runs in a sandbox:
+ * API provider routing, MCP server configuration, and global instructions.
+ */
+export declare function createClaudeRuntime(config?: ClaudeRuntimeConfig): import("../index.js").AgentRuntime<SandboxProvider>;
+declare const _default: import("../index.js").AgentRuntime<SandboxProvider>;
+export default _default;

package/dist/runtimes/openai-desktop.d.ts

@@ -0,0 +1,22 @@
+/**
+ * OpenAI Desktop Runner — ModelExecutionContract implementation using computer-use-preview.
+ *
+ * Works against DesktopSandboxProvider — no E2B SDK dependency here.
+ * The action→screenshot loop runs until the model emits text, then yields it.
+ */
+import type { DesktopSandboxProvider, AgentMessage, ModelExecutionContract, RuntimeOptions } from "../index.js";
+export interface OpenAIDesktopRunnerOptions extends RuntimeOptions {
+    openaiKey: string;
+}
+export declare class OpenAIDesktopRunner implements ModelExecutionContract {
+    private sandbox;
+    private openai;
+    private label;
+    constructor(sandbox: DesktopSandboxProvider, opts: OpenAIDesktopRunnerOptions);
+    sendMessage(opts: {
+        prompt: string;
+        sessionId?: string;
+    }): AsyncGenerator<AgentMessage>;
+}
+declare const _default: import("../index.js").AgentRuntime<DesktopSandboxProvider>;
+export default _default;