deepagentsdk 0.13.0 → 0.15.0

package/dist/index.d.cts

@@ -1,6 +1,8 @@
-import { $ as createLsTool, A as TextEvent, At as CheckpointSaverOptions, B as DynamicApprovalConfig, C as FileWrittenEvent, Ct as FileInfo, D as StepStartEvent, Dt as isSandboxBackend, E as StepFinishEvent, Et as WriteResult, F as WebSearchStartEvent, G as createExecuteToolFromBackend, H as SubAgent, I as AgentMemoryOptions, J as write_todos, K as execute, L as CreateDeepAgentParams, M as ToolCallEvent, Mt as ResumeDecision, N as ToolResultEvent, Nt as ResumeOptions, O as SubagentFinishEvent, Ot as BaseCheckpointSaver, P as WebSearchFinishEvent, Q as createGrepTool, R as SummarizationConfig, S as FileWriteStartEvent, St as FileData, T as HttpRequestStartEvent, Tt as SandboxBackendProtocol, U as CreateExecuteToolOptions, V as InterruptOnConfig, W as createExecuteTool, X as createFilesystemTools, Y as createEditFileTool, Z as createGlobTool, _ as ExecuteFinishEvent, _t as BackendFactory, a as eventHasStructuredOutput, at as ls, b as FetchUrlStartEvent, bt as EditResult, c as hasStructuredOutput, ct as CreateWebToolsOptions, d as CheckpointLoadedEvent, dt as createWebSearchTool, et as createReadFileTool, f as CheckpointSavedEvent, ft as createWebTools, g as EventCallback, gt as web_search, h as ErrorEvent, ht as http_request, i as StructuredAgentResult, it as grep, j as TodosChangedEvent, jt as InterruptData, k as SubagentStartEvent, kt as Checkpoint, l as ApprovalRequestedEvent, lt as createFetchUrlTool, m as DoneEvent, mt as htmlToMarkdown, n as createDeepAgent, nt as edit_file, o as getEventOutput, ot as read_file, p as DeepAgentEvent, pt as fetch_url, q as createTodosTool, r as ModelMessage$1, rt as glob, s as getStructuredOutput, st as write_file, t as DeepAgent, tt as createWriteFileTool, u as ApprovalResponseEvent, ut as createHttpRequestTool, v as ExecuteStartEvent, vt as BackendProtocol, w as HttpRequestFinishEvent, wt as GrepMatch, x as FileEditedEvent, xt as ExecuteResponse, y as FetchUrlFinishEvent, yt as DeepAgentState, z as TodoItem } from "./agent-DToEVxs-.cjs";
+import { $ as createLsTool, A as TextEvent, At as isSandboxBackend, B as DynamicApprovalConfig, C as FileWrittenEvent, Ct as FileDownloadResponse, D as StepStartEvent, Dt as GrepMatch, E as StepFinishEvent, Et as FileUploadResponse, F as WebSearchStartEvent, Ft as ResumeDecision, G as createExecuteToolFromBackend, H as SubAgent, I as AgentMemoryOptions, It as ResumeOptions, J as write_todos, K as execute, L as CreateDeepAgentParams, M as ToolCallEvent, Mt as Checkpoint, N as ToolResultEvent, Nt as CheckpointSaverOptions, O as SubagentFinishEvent, Ot as SandboxBackendProtocol, P as WebSearchFinishEvent, Pt as InterruptData, Q as createGrepTool, R as SummarizationConfig, S as FileWriteStartEvent, St as FileData, T as HttpRequestStartEvent, Tt as FileOperationError, U as CreateExecuteToolOptions, V as InterruptOnConfig, W as createExecuteTool, X as createFilesystemTools, Y as createEditFileTool, Z as createGlobTool, _ as ExecuteFinishEvent, _t as BackendFactory, a as eventHasStructuredOutput, at as ls, b as FetchUrlStartEvent, bt as EditResult, c as hasStructuredOutput, ct as CreateWebToolsOptions, d as CheckpointLoadedEvent, dt as createWebSearchTool, et as createReadFileTool, f as CheckpointSavedEvent, ft as createWebTools, g as EventCallback, gt as web_search, h as ErrorEvent, ht as http_request, i as StructuredAgentResult, it as grep, j as TodosChangedEvent, jt as BaseCheckpointSaver, k as SubagentStartEvent, kt as WriteResult, l as ApprovalRequestedEvent, lt as createFetchUrlTool, m as DoneEvent, mt as htmlToMarkdown, n as createDeepAgent, nt as edit_file, o as getEventOutput, ot as read_file, p as DeepAgentEvent, pt as fetch_url, q as createTodosTool, r as ModelMessage$1, rt as glob, s as getStructuredOutput, st as write_file, t as DeepAgent, tt as createWriteFileTool, u as ApprovalResponseEvent, ut as createHttpRequestTool, v as ExecuteStartEvent, vt as BackendProtocol, w as HttpRequestFinishEvent, wt as FileInfo, x as FileEditedEvent, xt as ExecuteResponse, y as FetchUrlFinishEvent, yt as DeepAgentState, z as TodoItem } from "./agent-tfRthBvX.cjs";
 import * as ai18 from "ai";
 import { LanguageModel, LanguageModelMiddleware, LanguageModelMiddleware as LanguageModelMiddleware$1, ModelMessage, ToolLoopAgent, ToolSet, hasToolCall, stepCountIs, wrapLanguageModel } from "ai";
+import { Sandbox } from "e2b";
+import { ModalClient, Sandbox as Sandbox$1 } from "modal";
 
 //#region src/backends/state.d.ts
 
@@ -574,6 +576,26 @@ declare abstract class BaseSandbox implements SandboxBackendProtocol {
    * Must be implemented by subclasses.
    */
   abstract readonly id: string;
+  /**
+   * Upload multiple files to the sandbox.
+   *
+   * Default implementation uses base64 encoding via shell commands.
+   * Subclasses can override if they have a native file upload API.
+   *
+   * This API is designed to allow partial success - individual uploads may fail
+   * without affecting others. Check the error field in each response.
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Download multiple files from the sandbox.
+   *
+   * Default implementation uses base64 encoding via shell commands.
+   * Subclasses can override if they have a native file download API.
+   *
+   * This API is designed to allow partial success - individual downloads may fail
+   * without affecting others. Check the error field in each response.
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
   /**
    * List files and directories in a path.
    */
@@ -709,6 +731,281 @@ declare class LocalSandbox extends BaseSandbox {
   execute(command: string): Promise<ExecuteResponse>;
 }
 //#endregion
+//#region src/backends/e2b.d.ts
+/**
+ * Options for creating an E2B backend.
+ */
+interface E2BBackendOptions {
+  /**
+   * E2B API key. If not provided, reads from E2B_API_KEY environment variable.
+   */
+  apiKey?: string;
+  /**
+   * Sandbox template to use. Defaults to "base".
+   */
+  template?: string;
+  /**
+   * Timeout for command execution in milliseconds.
+   * Defaults to 30 minutes.
+   */
+  timeout?: number;
+}
+/**
+ * E2B sandbox backend implementation.
+ *
+ * Use createE2BBackend() factory function to create instances.
+ */
+declare class E2BBackend extends BaseSandbox {
+  readonly id: string;
+  private readonly _sandbox;
+  private readonly _timeout;
+  constructor(sandbox: Sandbox, timeout: number);
+  /**
+   * Execute a shell command in the E2B sandbox.
+   */
+  execute(command: string): Promise<ExecuteResponse>;
+  /**
+   * Upload files to the E2B sandbox using the native filesystem API.
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Write a file using the native filesystem API.
+   * Override to avoid shell command limits for large files.
+   */
+  write(filePath: string, content: string): Promise<WriteResult>;
+  /**
+   * Download files from the E2B sandbox using the native filesystem API.
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
+  /**
+   * Kill the E2B sandbox.
+   *
+   * E2B automatically cleans up after 5 minutes of inactivity, but we can
+   * manually kill it to clean up immediately.
+   */
+  dispose(): Promise<void>;
+}
+/**
+ * Create an E2B sandbox backend.
+ *
+ * This is an async factory function because E2B requires async operations
+ * to create sandboxes.
+ *
+ * @example
+ * ```typescript
+ * const backend = await createE2BBackend({
+ *   template: "base",
+ *   timeout: 10 * 60 * 1000,
+ * });
+ * ```
+ */
+declare function createE2BBackend(options?: E2BBackendOptions): Promise<E2BBackend>;
+//#endregion
+//#region src/backends/modal.d.ts
+/**
+ * Options for creating a Modal backend.
+ */
+interface ModalBackendOptions {
+  /**
+   * Modal app name. Defaults to "deepagentsdk-sandbox".
+   * App will be created if it doesn't exist.
+   */
+  appName?: string;
+  /**
+   * Container image to use for sandbox.
+   * Defaults to "python:3.13-slim".
+   */
+  image?: string;
+  /**
+   * Timeout for command execution in milliseconds.
+   * Defaults to 30 minutes.
+   */
+  timeout?: number;
+}
+/**
+ * Modal sandbox backend implementation.
+ *
+ * Use createModalBackend() factory function to create instances.
+ */
+declare class ModalBackend extends BaseSandbox {
+  readonly id: string;
+  private readonly _client;
+  private readonly _sandbox;
+  private readonly _timeout;
+  constructor(client: ModalClient, sandbox: Sandbox$1, timeout: number);
+  /**
+   * Execute a shell command in the Modal sandbox.
+   */
+  execute(command: string): Promise<ExecuteResponse>;
+  /**
+   * Upload files to the Modal sandbox.
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Download files from the Modal sandbox.
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
+  /**
+   * Terminate the Modal sandbox.
+   *
+   * Modal has no auto-cleanup, so dispose() must be called to clean up resources.
+   */
+  dispose(): Promise<void>;
+}
+/**
+ * Create a Modal sandbox backend.
+ *
+ * This is an async factory function because Modal requires async operations
+ * to create apps and sandboxes.
+ *
+ * @example
+ * ```typescript
+ * const backend = await createModalBackend({
+ *   appName: "my-agent-sandbox",
+ *   image: "node:22-alpine",
+ * });
+ * ```
+ */
+declare function createModalBackend(options?: ModalBackendOptions): Promise<ModalBackend>;
+//#endregion
+//#region src/backends/runloop.d.ts
+interface RunloopBackendOptions {
+  /**
+   * Runloop API key. If not provided, reads from RUNLOOP_API_KEY environment variable.
+   */
+  apiKey?: string;
+  /**
+   * Existing devbox ID to reconnect to.
+   * If provided, connects to existing devbox instead of creating new one.
+   */
+  devboxId?: string;
+  /**
+   * Timeout for command execution in milliseconds.
+   * Defaults to 30 minutes.
+   */
+  timeout?: number;
+}
+/**
+ * Runloop devbox backend implementation.
+ *
+ * @example Creating a new devbox
+ * ```typescript
+ * const backend = new RunloopBackend({
+ *   timeout: 15 * 60 * 1000, // 15 minutes
+ * });
+ * ```
+ *
+ * @example Reconnecting to existing devbox
+ * ```typescript
+ * const backend = new RunloopBackend({
+ *   devboxId: "db-abc123",
+ * });
+ * ```
+ */
+declare class RunloopBackend extends BaseSandbox {
+  readonly id: string;
+  private readonly _sdk;
+  private readonly _devbox;
+  private readonly _timeout;
+  private readonly _owned;
+  constructor(options?: RunloopBackendOptions);
+  private _initializeDevbox;
+  private _getDevbox;
+  /**
+   * Execute a shell command in the Runloop devbox.
+   */
+  execute(command: string): Promise<ExecuteResponse>;
+  /**
+   * Upload files to the Runloop devbox.
+   *
+   * Uses base64 encoding to transfer file content via shell commands.
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Download files from the Runloop devbox.
+   *
+   * Uses base64 encoding to transfer file content via shell commands.
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
+  /**
+   * Shutdown the Runloop devbox.
+   *
+   * Runloop has no auto-cleanup, so dispose() must be called to clean up resources.
+   * Only shuts down devbox if we created it (owned: true).
+   */
+  dispose(): Promise<void>;
+}
+//#endregion
+//#region src/backends/daytona.d.ts
+interface DaytonaBackendOptions {
+  /**
+   * Daytona API key. If not provided, reads from DAYTONA_API_KEY environment variable.
+   */
+  apiKey?: string;
+  /**
+   * Language/runtime for the sandbox.
+   * Defaults to "typescript".
+   * Options: "typescript", "python", "go", etc.
+   */
+  language?: string;
+  /**
+   * Existing sandbox ID to reconnect to.
+   * If provided, connects to existing sandbox instead of creating new one.
+   */
+  sandboxId?: string;
+  /**
+   * Timeout for command execution in milliseconds.
+   * Defaults to 30 minutes.
+   */
+  timeout?: number;
+}
+/**
+ * Daytona sandbox backend implementation.
+ *
+ * @example Creating a new sandbox
+ * ```typescript
+ * const backend = new DaytonaBackend({
+ *   language: "typescript",
+ * });
+ * ```
+ *
+ * @example Reconnecting to existing sandbox
+ * ```typescript
+ * const backend = new DaytonaBackend({
+ *   sandboxId: "ds-abc123",
+ * });
+ * ```
+ */
+declare class DaytonaBackend extends BaseSandbox {
+  readonly id: string;
+  private readonly _daytona;
+  private readonly _sandbox;
+  private readonly _timeout;
+  private readonly _owned;
+  constructor(options?: DaytonaBackendOptions);
+  private _initializeSandbox;
+  private _getSandbox;
+  /**
+   * Execute a shell command in the Daytona sandbox.
+   */
+  execute(command: string): Promise<ExecuteResponse>;
+  /**
+   * Upload files to the Daytona sandbox.
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Download files from the Daytona sandbox.
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
+  /**
+   * Delete the Daytona sandbox.
+   *
+   * Daytona has no auto-cleanup, so dispose() must be called to clean up resources.
+   * Only deletes sandbox if we created it (owned: true).
+   */
+  dispose(): Promise<void>;
+}
+//#endregion
 //#region src/tools/subagent.d.ts
 /**
  * Options for creating the subagent tool.
@@ -1229,5 +1526,5 @@ declare function createAgentMemoryMiddleware(options: AgentMemoryOptions$1): Lan
  */
 declare function findGitRoot(startPath?: string): Promise<string | null>;
 //#endregion
-export { type AgentMemoryOptions, type ApprovalRequestedEvent, type ApprovalResponseEvent, BASE_PROMPT, type BackendFactory, type BackendProtocol, BaseCheckpointSaver, BaseSandbox, Checkpoint, type CheckpointLoadedEvent, type CheckpointSavedEvent, CheckpointSaverOptions, CompositeBackend, type CreateDeepAgentParams, type CreateExecuteToolOptions, type CreateSubagentToolOptions, type CreateWebToolsOptions, DEFAULT_EVICTION_TOKEN_LIMIT, DEFAULT_GENERAL_PURPOSE_DESCRIPTION, DEFAULT_KEEP_MESSAGES, DEFAULT_SUBAGENT_PROMPT, DEFAULT_SUMMARIZATION_THRESHOLD, DeepAgent, type DeepAgentEvent, type DeepAgentState, type DoneEvent, type DynamicApprovalConfig, EXECUTE_SYSTEM_PROMPT, type EditResult, type ErrorEvent, type EventCallback, type EvictOptions, type EvictResult, type ExecuteFinishEvent, type ExecuteResponse, type ExecuteStartEvent, FILESYSTEM_SYSTEM_PROMPT, type FetchUrlFinishEvent, type FetchUrlStartEvent, type FileData, type FileEditedEvent, type FileInfo, FileSaver, FileSaverOptions, type FileWriteStartEvent, type FileWrittenEvent, FilesystemBackend, type GrepMatch, type HttpRequestFinishEvent, type HttpRequestStartEvent, InMemoryStore, InterruptData, type InterruptOnConfig, type KeyValueStore, KeyValueStoreSaver, KeyValueStoreSaverOptions, type LanguageModelMiddleware, LocalSandbox, type LocalSandboxOptions, MemorySaver, PersistentBackend, type PersistentBackendOptions, ResumeDecision, ResumeOptions, type SandboxBackendProtocol, type SkillLoadOptions, type SkillMetadata, StateBackend, type StepFinishEvent, type StepStartEvent, type StructuredAgentResult, type SubAgent, type SubagentFinishEvent, type SubagentStartEvent, type SummarizationConfig, type SummarizationOptions, type SummarizationResult, TASK_SYSTEM_PROMPT, TODO_SYSTEM_PROMPT, type TextEvent, type TodoItem, type TodosChangedEvent, type ToolCallEvent, ToolLoopAgent, type ToolResultEvent, type WebSearchFinishEvent, type WebSearchStartEvent, type WriteResult, createAgentMemoryMiddleware, createDeepAgent, createEditFileTool, createExecuteTool, createExecuteToolFromBackend, createFetchUrlTool, createFilesystemTools, createGlobTool, createGrepTool, createHttpRequestTool, createLsTool, createReadFileTool, createSubagentTool, createTodosTool, createToolResultWrapper, createWebSearchTool, createWebTools, createWriteFileTool, edit_file, estimateMessagesTokens, estimateTokens, eventHasStructuredOutput, evictToolResult, execute, fetch_url, findGitRoot, getEventOutput, getStructuredOutput, getTaskToolDescription, glob, grep, hasDanglingToolCalls, hasStructuredOutput, hasToolCall, htmlToMarkdown, http_request, isSandboxBackend, listSkills, ls, needsSummarization, parseSkillMetadata, patchToolCalls, read_file, shouldEvict, stepCountIs, summarizeIfNeeded, web_search, wrapLanguageModel, write_file, write_todos };
+export { type AgentMemoryOptions, type ApprovalRequestedEvent, type ApprovalResponseEvent, BASE_PROMPT, type BackendFactory, type BackendProtocol, BaseCheckpointSaver, BaseSandbox, Checkpoint, type CheckpointLoadedEvent, type CheckpointSavedEvent, CheckpointSaverOptions, CompositeBackend, type CreateDeepAgentParams, type CreateExecuteToolOptions, type CreateSubagentToolOptions, type CreateWebToolsOptions, DEFAULT_EVICTION_TOKEN_LIMIT, DEFAULT_GENERAL_PURPOSE_DESCRIPTION, DEFAULT_KEEP_MESSAGES, DEFAULT_SUBAGENT_PROMPT, DEFAULT_SUMMARIZATION_THRESHOLD, DaytonaBackend, type DaytonaBackendOptions, DeepAgent, type DeepAgentEvent, type DeepAgentState, type DoneEvent, type DynamicApprovalConfig, E2BBackend, type E2BBackendOptions, EXECUTE_SYSTEM_PROMPT, type EditResult, type ErrorEvent, type EventCallback, type EvictOptions, type EvictResult, type ExecuteFinishEvent, type ExecuteResponse, type ExecuteStartEvent, FILESYSTEM_SYSTEM_PROMPT, type FetchUrlFinishEvent, type FetchUrlStartEvent, type FileData, type FileDownloadResponse, type FileEditedEvent, type FileInfo, type FileOperationError, FileSaver, FileSaverOptions, type FileUploadResponse, type FileWriteStartEvent, type FileWrittenEvent, FilesystemBackend, type GrepMatch, type HttpRequestFinishEvent, type HttpRequestStartEvent, InMemoryStore, InterruptData, type InterruptOnConfig, type KeyValueStore, KeyValueStoreSaver, KeyValueStoreSaverOptions, type LanguageModelMiddleware, LocalSandbox, type LocalSandboxOptions, MemorySaver, ModalBackend, type ModalBackendOptions, PersistentBackend, type PersistentBackendOptions, ResumeDecision, ResumeOptions, RunloopBackend, type RunloopBackendOptions, type SandboxBackendProtocol, type SkillLoadOptions, type SkillMetadata, StateBackend, type StepFinishEvent, type StepStartEvent, type StructuredAgentResult, type SubAgent, type SubagentFinishEvent, type SubagentStartEvent, type SummarizationConfig, type SummarizationOptions, type SummarizationResult, TASK_SYSTEM_PROMPT, TODO_SYSTEM_PROMPT, type TextEvent, type TodoItem, type TodosChangedEvent, type ToolCallEvent, ToolLoopAgent, type ToolResultEvent, type WebSearchFinishEvent, type WebSearchStartEvent, type WriteResult, createAgentMemoryMiddleware, createDeepAgent, createE2BBackend, createEditFileTool, createExecuteTool, createExecuteToolFromBackend, createFetchUrlTool, createFilesystemTools, createGlobTool, createGrepTool, createHttpRequestTool, createLsTool, createModalBackend, createReadFileTool, createSubagentTool, createTodosTool, createToolResultWrapper, createWebSearchTool, createWebTools, createWriteFileTool, edit_file, estimateMessagesTokens, estimateTokens, eventHasStructuredOutput, evictToolResult, execute, fetch_url, findGitRoot, getEventOutput, getStructuredOutput, getTaskToolDescription, glob, grep, hasDanglingToolCalls, hasStructuredOutput, hasToolCall, htmlToMarkdown, http_request, isSandboxBackend, listSkills, ls, needsSummarization, parseSkillMetadata, patchToolCalls, read_file, shouldEvict, stepCountIs, summarizeIfNeeded, web_search, wrapLanguageModel, write_file, write_todos };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -1,6 +1,8 @@
-import { $ as createLsTool, A as TextEvent, At as CheckpointSaverOptions, B as DynamicApprovalConfig, C as FileWrittenEvent, Ct as FileInfo, D as StepStartEvent, Dt as isSandboxBackend, E as StepFinishEvent, Et as WriteResult, F as WebSearchStartEvent, G as createExecuteToolFromBackend, H as SubAgent, I as AgentMemoryOptions, J as write_todos, K as execute, L as CreateDeepAgentParams, M as ToolCallEvent, Mt as ResumeDecision, N as ToolResultEvent, Nt as ResumeOptions, O as SubagentFinishEvent, Ot as BaseCheckpointSaver, P as WebSearchFinishEvent, Q as createGrepTool, R as SummarizationConfig, S as FileWriteStartEvent, St as FileData, T as HttpRequestStartEvent, Tt as SandboxBackendProtocol, U as CreateExecuteToolOptions, V as InterruptOnConfig, W as createExecuteTool, X as createFilesystemTools, Y as createEditFileTool, Z as createGlobTool, _ as ExecuteFinishEvent, _t as BackendFactory, a as eventHasStructuredOutput, at as ls, b as FetchUrlStartEvent, bt as EditResult, c as hasStructuredOutput, ct as CreateWebToolsOptions, d as CheckpointLoadedEvent, dt as createWebSearchTool, et as createReadFileTool, f as CheckpointSavedEvent, ft as createWebTools, g as EventCallback, gt as web_search, h as ErrorEvent, ht as http_request, i as StructuredAgentResult, it as grep, j as TodosChangedEvent, jt as InterruptData, k as SubagentStartEvent, kt as Checkpoint, l as ApprovalRequestedEvent, lt as createFetchUrlTool, m as DoneEvent, mt as htmlToMarkdown, n as createDeepAgent, nt as edit_file, o as getEventOutput, ot as read_file, p as DeepAgentEvent, pt as fetch_url, q as createTodosTool, r as ModelMessage$1, rt as glob, s as getStructuredOutput, st as write_file, t as DeepAgent, tt as createWriteFileTool, u as ApprovalResponseEvent, ut as createHttpRequestTool, v as ExecuteStartEvent, vt as BackendProtocol, w as HttpRequestFinishEvent, wt as GrepMatch, x as FileEditedEvent, xt as ExecuteResponse, y as FetchUrlFinishEvent, yt as DeepAgentState, z as TodoItem } from "./agent-BDM-PIu8.mjs";
-import * as ai5 from "ai";
+import { $ as createLsTool, A as TextEvent, At as isSandboxBackend, B as DynamicApprovalConfig, C as FileWrittenEvent, Ct as FileDownloadResponse, D as StepStartEvent, Dt as GrepMatch, E as StepFinishEvent, Et as FileUploadResponse, F as WebSearchStartEvent, Ft as ResumeDecision, G as createExecuteToolFromBackend, H as SubAgent, I as AgentMemoryOptions, It as ResumeOptions, J as write_todos, K as execute, L as CreateDeepAgentParams, M as ToolCallEvent, Mt as Checkpoint, N as ToolResultEvent, Nt as CheckpointSaverOptions, O as SubagentFinishEvent, Ot as SandboxBackendProtocol, P as WebSearchFinishEvent, Pt as InterruptData, Q as createGrepTool, R as SummarizationConfig, S as FileWriteStartEvent, St as FileData, T as HttpRequestStartEvent, Tt as FileOperationError, U as CreateExecuteToolOptions, V as InterruptOnConfig, W as createExecuteTool, X as createFilesystemTools, Y as createEditFileTool, Z as createGlobTool, _ as ExecuteFinishEvent, _t as BackendFactory, a as eventHasStructuredOutput, at as ls, b as FetchUrlStartEvent, bt as EditResult, c as hasStructuredOutput, ct as CreateWebToolsOptions, d as CheckpointLoadedEvent, dt as createWebSearchTool, et as createReadFileTool, f as CheckpointSavedEvent, ft as createWebTools, g as EventCallback, gt as web_search, h as ErrorEvent, ht as http_request, i as StructuredAgentResult, it as grep, j as TodosChangedEvent, jt as BaseCheckpointSaver, k as SubagentStartEvent, kt as WriteResult, l as ApprovalRequestedEvent, lt as createFetchUrlTool, m as DoneEvent, mt as htmlToMarkdown, n as createDeepAgent, nt as edit_file, o as getEventOutput, ot as read_file, p as DeepAgentEvent, pt as fetch_url, q as createTodosTool, r as ModelMessage$1, rt as glob, s as getStructuredOutput, st as write_file, t as DeepAgent, tt as createWriteFileTool, u as ApprovalResponseEvent, ut as createHttpRequestTool, v as ExecuteStartEvent, vt as BackendProtocol, w as HttpRequestFinishEvent, wt as FileInfo, x as FileEditedEvent, xt as ExecuteResponse, y as FetchUrlFinishEvent, yt as DeepAgentState, z as TodoItem } from "./agent-DHUp_-Fx.mjs";
+import * as ai18 from "ai";
 import { LanguageModel, LanguageModelMiddleware, LanguageModelMiddleware as LanguageModelMiddleware$1, ModelMessage, ToolLoopAgent, ToolSet, hasToolCall, stepCountIs, wrapLanguageModel } from "ai";
+import { ModalClient, Sandbox } from "modal";
+import { Sandbox as Sandbox$1 } from "e2b";
 
 //#region src/backends/state.d.ts
 
@@ -574,6 +576,26 @@ declare abstract class BaseSandbox implements SandboxBackendProtocol {
    * Must be implemented by subclasses.
    */
   abstract readonly id: string;
+  /**
+   * Upload multiple files to the sandbox.
+   *
+   * Default implementation uses base64 encoding via shell commands.
+   * Subclasses can override if they have a native file upload API.
+   *
+   * This API is designed to allow partial success - individual uploads may fail
+   * without affecting others. Check the error field in each response.
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Download multiple files from the sandbox.
+   *
+   * Default implementation uses base64 encoding via shell commands.
+   * Subclasses can override if they have a native file download API.
+   *
+   * This API is designed to allow partial success - individual downloads may fail
+   * without affecting others. Check the error field in each response.
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
   /**
    * List files and directories in a path.
    */
@@ -709,6 +731,281 @@ declare class LocalSandbox extends BaseSandbox {
   execute(command: string): Promise<ExecuteResponse>;
 }
 //#endregion
+//#region src/backends/e2b.d.ts
+/**
+ * Options for creating an E2B backend.
+ */
+interface E2BBackendOptions {
+  /**
+   * E2B API key. If not provided, reads from E2B_API_KEY environment variable.
+   */
+  apiKey?: string;
+  /**
+   * Sandbox template to use. Defaults to "base".
+   */
+  template?: string;
+  /**
+   * Timeout for command execution in milliseconds.
+   * Defaults to 30 minutes.
+   */
+  timeout?: number;
+}
+/**
+ * E2B sandbox backend implementation.
+ *
+ * Use createE2BBackend() factory function to create instances.
+ */
+declare class E2BBackend extends BaseSandbox {
+  readonly id: string;
+  private readonly _sandbox;
+  private readonly _timeout;
+  constructor(sandbox: Sandbox$1, timeout: number);
+  /**
+   * Execute a shell command in the E2B sandbox.
+   */
+  execute(command: string): Promise<ExecuteResponse>;
+  /**
+   * Upload files to the E2B sandbox using the native filesystem API.
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Write a file using the native filesystem API.
+   * Override to avoid shell command limits for large files.
+   */
+  write(filePath: string, content: string): Promise<WriteResult>;
+  /**
+   * Download files from the E2B sandbox using the native filesystem API.
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
+  /**
+   * Kill the E2B sandbox.
+   *
+   * E2B automatically cleans up after 5 minutes of inactivity, but we can
+   * manually kill it to clean up immediately.
+   */
+  dispose(): Promise<void>;
+}
+/**
+ * Create an E2B sandbox backend.
+ *
+ * This is an async factory function because E2B requires async operations
+ * to create sandboxes.
+ *
+ * @example
+ * ```typescript
+ * const backend = await createE2BBackend({
+ *   template: "base",
+ *   timeout: 10 * 60 * 1000,
+ * });
+ * ```
+ */
+declare function createE2BBackend(options?: E2BBackendOptions): Promise<E2BBackend>;
+//#endregion
+//#region src/backends/modal.d.ts
+/**
+ * Options for creating a Modal backend.
+ */
+interface ModalBackendOptions {
+  /**
+   * Modal app name. Defaults to "deepagentsdk-sandbox".
+   * App will be created if it doesn't exist.
+   */
+  appName?: string;
+  /**
+   * Container image to use for sandbox.
+   * Defaults to "python:3.13-slim".
+   */
+  image?: string;
+  /**
+   * Timeout for command execution in milliseconds.
+   * Defaults to 30 minutes.
+   */
+  timeout?: number;
+}
+/**
+ * Modal sandbox backend implementation.
+ *
+ * Use createModalBackend() factory function to create instances.
+ */
+declare class ModalBackend extends BaseSandbox {
+  readonly id: string;
+  private readonly _client;
+  private readonly _sandbox;
+  private readonly _timeout;
+  constructor(client: ModalClient, sandbox: Sandbox, timeout: number);
+  /**
+   * Execute a shell command in the Modal sandbox.
+   */
+  execute(command: string): Promise<ExecuteResponse>;
+  /**
+   * Upload files to the Modal sandbox.
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Download files from the Modal sandbox.
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
+  /**
+   * Terminate the Modal sandbox.
+   *
+   * Modal has no auto-cleanup, so dispose() must be called to clean up resources.
+   */
+  dispose(): Promise<void>;
+}
+/**
+ * Create a Modal sandbox backend.
+ *
+ * This is an async factory function because Modal requires async operations
+ * to create apps and sandboxes.
+ *
+ * @example
+ * ```typescript
+ * const backend = await createModalBackend({
+ *   appName: "my-agent-sandbox",
+ *   image: "node:22-alpine",
+ * });
+ * ```
+ */
+declare function createModalBackend(options?: ModalBackendOptions): Promise<ModalBackend>;
+//#endregion
+//#region src/backends/runloop.d.ts
+interface RunloopBackendOptions {
+  /**
+   * Runloop API key. If not provided, reads from RUNLOOP_API_KEY environment variable.
+   */
+  apiKey?: string;
+  /**
+   * Existing devbox ID to reconnect to.
+   * If provided, connects to existing devbox instead of creating new one.
+   */
+  devboxId?: string;
+  /**
+   * Timeout for command execution in milliseconds.
+   * Defaults to 30 minutes.
+   */
+  timeout?: number;
+}
+/**
+ * Runloop devbox backend implementation.
+ *
+ * @example Creating a new devbox
+ * ```typescript
+ * const backend = new RunloopBackend({
+ *   timeout: 15 * 60 * 1000, // 15 minutes
+ * });
+ * ```
+ *
+ * @example Reconnecting to existing devbox
+ * ```typescript
+ * const backend = new RunloopBackend({
+ *   devboxId: "db-abc123",
+ * });
+ * ```
+ */
+declare class RunloopBackend extends BaseSandbox {
+  readonly id: string;
+  private readonly _sdk;
+  private readonly _devbox;
+  private readonly _timeout;
+  private readonly _owned;
+  constructor(options?: RunloopBackendOptions);
+  private _initializeDevbox;
+  private _getDevbox;
+  /**
+   * Execute a shell command in the Runloop devbox.
+   */
+  execute(command: string): Promise<ExecuteResponse>;
+  /**
+   * Upload files to the Runloop devbox.
+   *
+   * Uses base64 encoding to transfer file content via shell commands.
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Download files from the Runloop devbox.
+   *
+   * Uses base64 encoding to transfer file content via shell commands.
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
+  /**
+   * Shutdown the Runloop devbox.
+   *
+   * Runloop has no auto-cleanup, so dispose() must be called to clean up resources.
+   * Only shuts down devbox if we created it (owned: true).
+   */
+  dispose(): Promise<void>;
+}
+//#endregion
+//#region src/backends/daytona.d.ts
+interface DaytonaBackendOptions {
+  /**
+   * Daytona API key. If not provided, reads from DAYTONA_API_KEY environment variable.
+   */
+  apiKey?: string;
+  /**
+   * Language/runtime for the sandbox.
+   * Defaults to "typescript".
+   * Options: "typescript", "python", "go", etc.
+   */
+  language?: string;
+  /**
+   * Existing sandbox ID to reconnect to.
+   * If provided, connects to existing sandbox instead of creating new one.
+   */
+  sandboxId?: string;
+  /**
+   * Timeout for command execution in milliseconds.
+   * Defaults to 30 minutes.
+   */
+  timeout?: number;
+}
+/**
+ * Daytona sandbox backend implementation.
+ *
+ * @example Creating a new sandbox
+ * ```typescript
+ * const backend = new DaytonaBackend({
+ *   language: "typescript",
+ * });
+ * ```
+ *
+ * @example Reconnecting to existing sandbox
+ * ```typescript
+ * const backend = new DaytonaBackend({
+ *   sandboxId: "ds-abc123",
+ * });
+ * ```
+ */
+declare class DaytonaBackend extends BaseSandbox {
+  readonly id: string;
+  private readonly _daytona;
+  private readonly _sandbox;
+  private readonly _timeout;
+  private readonly _owned;
+  constructor(options?: DaytonaBackendOptions);
+  private _initializeSandbox;
+  private _getSandbox;
+  /**
+   * Execute a shell command in the Daytona sandbox.
+   */
+  execute(command: string): Promise<ExecuteResponse>;
+  /**
+   * Upload files to the Daytona sandbox.
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Download files from the Daytona sandbox.
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
+  /**
+   * Delete the Daytona sandbox.
+   *
+   * Daytona has no auto-cleanup, so dispose() must be called to clean up resources.
+   * Only deletes sandbox if we created it (owned: true).
+   */
+  dispose(): Promise<void>;
+}
+//#endregion
 //#region src/tools/subagent.d.ts
 /**
  * Options for creating the subagent tool.
@@ -737,7 +1034,7 @@ interface CreateSubagentToolOptions {
 /**
  * Create the task tool for spawning subagents using ToolLoopAgent.
  */
-declare function createSubagentTool(state: DeepAgentState, options: CreateSubagentToolOptions): ai5.Tool<{
+declare function createSubagentTool(state: DeepAgentState, options: CreateSubagentToolOptions): ai18.Tool<{
   description: string;
   subagent_type: string;
 }, string>;
@@ -1229,5 +1526,5 @@ declare function createAgentMemoryMiddleware(options: AgentMemoryOptions$1): Lan
  */
 declare function findGitRoot(startPath?: string): Promise<string | null>;
 //#endregion
-export { type AgentMemoryOptions, type ApprovalRequestedEvent, type ApprovalResponseEvent, BASE_PROMPT, type BackendFactory, type BackendProtocol, BaseCheckpointSaver, BaseSandbox, Checkpoint, type CheckpointLoadedEvent, type CheckpointSavedEvent, CheckpointSaverOptions, CompositeBackend, type CreateDeepAgentParams, type CreateExecuteToolOptions, type CreateSubagentToolOptions, type CreateWebToolsOptions, DEFAULT_EVICTION_TOKEN_LIMIT, DEFAULT_GENERAL_PURPOSE_DESCRIPTION, DEFAULT_KEEP_MESSAGES, DEFAULT_SUBAGENT_PROMPT, DEFAULT_SUMMARIZATION_THRESHOLD, DeepAgent, type DeepAgentEvent, type DeepAgentState, type DoneEvent, type DynamicApprovalConfig, EXECUTE_SYSTEM_PROMPT, type EditResult, type ErrorEvent, type EventCallback, type EvictOptions, type EvictResult, type ExecuteFinishEvent, type ExecuteResponse, type ExecuteStartEvent, FILESYSTEM_SYSTEM_PROMPT, type FetchUrlFinishEvent, type FetchUrlStartEvent, type FileData, type FileEditedEvent, type FileInfo, FileSaver, FileSaverOptions, type FileWriteStartEvent, type FileWrittenEvent, FilesystemBackend, type GrepMatch, type HttpRequestFinishEvent, type HttpRequestStartEvent, InMemoryStore, InterruptData, type InterruptOnConfig, type KeyValueStore, KeyValueStoreSaver, KeyValueStoreSaverOptions, type LanguageModelMiddleware, LocalSandbox, type LocalSandboxOptions, MemorySaver, PersistentBackend, type PersistentBackendOptions, ResumeDecision, ResumeOptions, type SandboxBackendProtocol, type SkillLoadOptions, type SkillMetadata, StateBackend, type StepFinishEvent, type StepStartEvent, type StructuredAgentResult, type SubAgent, type SubagentFinishEvent, type SubagentStartEvent, type SummarizationConfig, type SummarizationOptions, type SummarizationResult, TASK_SYSTEM_PROMPT, TODO_SYSTEM_PROMPT, type TextEvent, type TodoItem, type TodosChangedEvent, type ToolCallEvent, ToolLoopAgent, type ToolResultEvent, type WebSearchFinishEvent, type WebSearchStartEvent, type WriteResult, createAgentMemoryMiddleware, createDeepAgent, createEditFileTool, createExecuteTool, createExecuteToolFromBackend, createFetchUrlTool, createFilesystemTools, createGlobTool, createGrepTool, createHttpRequestTool, createLsTool, createReadFileTool, createSubagentTool, createTodosTool, createToolResultWrapper, createWebSearchTool, createWebTools, createWriteFileTool, edit_file, estimateMessagesTokens, estimateTokens, eventHasStructuredOutput, evictToolResult, execute, fetch_url, findGitRoot, getEventOutput, getStructuredOutput, getTaskToolDescription, glob, grep, hasDanglingToolCalls, hasStructuredOutput, hasToolCall, htmlToMarkdown, http_request, isSandboxBackend, listSkills, ls, needsSummarization, parseSkillMetadata, patchToolCalls, read_file, shouldEvict, stepCountIs, summarizeIfNeeded, web_search, wrapLanguageModel, write_file, write_todos };
+export { type AgentMemoryOptions, type ApprovalRequestedEvent, type ApprovalResponseEvent, BASE_PROMPT, type BackendFactory, type BackendProtocol, BaseCheckpointSaver, BaseSandbox, Checkpoint, type CheckpointLoadedEvent, type CheckpointSavedEvent, CheckpointSaverOptions, CompositeBackend, type CreateDeepAgentParams, type CreateExecuteToolOptions, type CreateSubagentToolOptions, type CreateWebToolsOptions, DEFAULT_EVICTION_TOKEN_LIMIT, DEFAULT_GENERAL_PURPOSE_DESCRIPTION, DEFAULT_KEEP_MESSAGES, DEFAULT_SUBAGENT_PROMPT, DEFAULT_SUMMARIZATION_THRESHOLD, DaytonaBackend, type DaytonaBackendOptions, DeepAgent, type DeepAgentEvent, type DeepAgentState, type DoneEvent, type DynamicApprovalConfig, E2BBackend, type E2BBackendOptions, EXECUTE_SYSTEM_PROMPT, type EditResult, type ErrorEvent, type EventCallback, type EvictOptions, type EvictResult, type ExecuteFinishEvent, type ExecuteResponse, type ExecuteStartEvent, FILESYSTEM_SYSTEM_PROMPT, type FetchUrlFinishEvent, type FetchUrlStartEvent, type FileData, type FileDownloadResponse, type FileEditedEvent, type FileInfo, type FileOperationError, FileSaver, FileSaverOptions, type FileUploadResponse, type FileWriteStartEvent, type FileWrittenEvent, FilesystemBackend, type GrepMatch, type HttpRequestFinishEvent, type HttpRequestStartEvent, InMemoryStore, InterruptData, type InterruptOnConfig, type KeyValueStore, KeyValueStoreSaver, KeyValueStoreSaverOptions, type LanguageModelMiddleware, LocalSandbox, type LocalSandboxOptions, MemorySaver, ModalBackend, type ModalBackendOptions, PersistentBackend, type PersistentBackendOptions, ResumeDecision, ResumeOptions, RunloopBackend, type RunloopBackendOptions, type SandboxBackendProtocol, type SkillLoadOptions, type SkillMetadata, StateBackend, type StepFinishEvent, type StepStartEvent, type StructuredAgentResult, type SubAgent, type SubagentFinishEvent, type SubagentStartEvent, type SummarizationConfig, type SummarizationOptions, type SummarizationResult, TASK_SYSTEM_PROMPT, TODO_SYSTEM_PROMPT, type TextEvent, type TodoItem, type TodosChangedEvent, type ToolCallEvent, ToolLoopAgent, type ToolResultEvent, type WebSearchFinishEvent, type WebSearchStartEvent, type WriteResult, createAgentMemoryMiddleware, createDeepAgent, createE2BBackend, createEditFileTool, createExecuteTool, createExecuteToolFromBackend, createFetchUrlTool, createFilesystemTools, createGlobTool, createGrepTool, createHttpRequestTool, createLsTool, createModalBackend, createReadFileTool, createSubagentTool, createTodosTool, createToolResultWrapper, createWebSearchTool, createWebTools, createWriteFileTool, edit_file, estimateMessagesTokens, estimateTokens, eventHasStructuredOutput, evictToolResult, execute, fetch_url, findGitRoot, getEventOutput, getStructuredOutput, getTaskToolDescription, glob, grep, hasDanglingToolCalls, hasStructuredOutput, hasToolCall, htmlToMarkdown, http_request, isSandboxBackend, listSkills, ls, needsSummarization, parseSkillMetadata, patchToolCalls, read_file, shouldEvict, stepCountIs, summarizeIfNeeded, web_search, wrapLanguageModel, write_file, write_todos };
 //# sourceMappingURL=index.d.mts.map