deepagentsdk 0.13.0 → 0.15.0

package/dist/{agent-BDM-PIu8.d.mts → agent-DHUp_-Fx.d.mts}

@@ -166,6 +166,68 @@ interface EditResult {
   /** Number of replacements made, undefined on failure */
   occurrences?: number;
 }
+/**
+ * Standardized error codes for file upload/download operations.
+ *
+ * These represent common, recoverable errors that an LLM can understand and potentially fix:
+ * - "file_not_found": The requested file doesn't exist (download)
+ * - "permission_denied": Access denied
+ * - "is_directory": Attempted to download a directory as a file
+ * - "invalid_path": Path syntax is malformed
+ *
+ * @example
+ * ```typescript
+ * type FileError = FileOperationError;
+ * // Valid values: "file_not_found" | "permission_denied" | "is_directory" | "invalid_path"
+ * ```
+ */
+type FileOperationError = "file_not_found" | "permission_denied" | "is_directory" | "invalid_path";
+/**
+ * Result of a single file download operation.
+ *
+ * The response is designed to allow partial success in batch operations.
+ * The errors are standardized using FileOperationError literals.
+ *
+ * @example Success
+ * ```typescript
+ * { path: "/app/config.json", content: new Uint8Array(...), error: null }
+ * ```
+ *
+ * @example Failure
+ * ```typescript
+ * { path: "/wrong/path.txt", content: null, error: "file_not_found" }
+ * ```
+ */
+interface FileDownloadResponse {
+  /** The file path that was requested */
+  path: string;
+  /** File contents as bytes on success, null on failure */
+  content: Uint8Array | null;
+  /** Standardized error code on failure, null on success */
+  error: FileOperationError | null;
+}
+/**
+ * Result of a single file upload operation.
+ *
+ * The response is designed to allow partial success in batch operations.
+ * The errors are standardized using FileOperationError literals.
+ *
+ * @example Success
+ * ```typescript
+ * { path: "/app/data.txt", error: null }
+ * ```
+ *
+ * @example Failure
+ * ```typescript
+ * { path: "/readonly/file.txt", error: "permission_denied" }
+ * ```
+ */
+interface FileUploadResponse {
+  /** The file path that was requested */
+  path: string;
+  /** Standardized error code on failure, null on success */
+  error: FileOperationError | null;
+}
 /**
  * Shared state for deep agent operations.
  * This is passed to tools and modified during execution.
@@ -236,6 +298,54 @@ interface SandboxBackendProtocol extends BackendProtocol {
    * Unique identifier for this sandbox instance.
    */
   readonly id: string;
+  /**
+   * Upload multiple files to the sandbox.
+   *
+   * This API is designed to allow partial success - individual uploads may fail
+   * without affecting others. Check the error field in each response.
+   *
+   * @param files - Array of [path, content] tuples to upload
+   * @returns Array of FileUploadResponse objects, one per input file
+   *
+   * @example
+   * ```typescript
+   * const responses = await sandbox.uploadFiles([
+   *   ["/app/config.json", new Uint8Array(b"...")],
+   *   ["/app/data.txt", new Uint8Array(b"content")],
+   * ]);
+   * // Check for errors
+   * responses.forEach(r => {
+   *   if (r.error) console.error(`Failed to upload ${r.path}: ${r.error}`);
+   * });
+   * ```
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Download multiple files from the sandbox.
+   *
+   * This API is designed to allow partial success - individual downloads may fail
+   * without affecting others. Check the error field in each response.
+   *
+   * @param paths - Array of file paths to download
+   * @returns Array of FileDownloadResponse objects, one per input path
+   *
+   * @example
+   * ```typescript
+   * const responses = await sandbox.downloadFiles([
+   *   "/app/config.json",
+   *   "/app/data.txt",
+   * ]);
+   * // Process successful downloads
+   * for (const r of responses) {
+   *   if (r.content) {
+   *     console.log(`Downloaded ${r.path}: ${r.content.length} bytes`);
+   *   } else if (r.error) {
+   *     console.error(`Failed to download ${r.path}: ${r.error}`);
+   *   }
+   * }
+   * ```
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
 }
 /**
  * Type guard to check if a backend is a SandboxBackendProtocol.
@@ -338,8 +448,8 @@ declare function createReadFileTool(state: DeepAgentState, backend: BackendProto
  * Create the write_file tool.
  */
 declare function createWriteFileTool(state: DeepAgentState, backend: BackendProtocol | BackendFactory, onEvent?: EventCallback): ai2.Tool<{
-  file_path: string;
   content: string;
+  file_path: string;
 }, string>;
 /**
  * Create the edit_file tool.
@@ -392,8 +502,8 @@ declare function createFilesystemTools(state: DeepAgentState, backendOrOptions?:
     limit: number;
   }, string>;
   write_file: ai2.Tool<{
-    file_path: string;
     content: string;
+    file_path: string;
   }, string>;
   edit_file: ai2.Tool<{
     file_path: string;
@@ -1496,5 +1606,5 @@ declare class DeepAgent {
  */
 declare function createDeepAgent(params: CreateDeepAgentParams): DeepAgent;
 //#endregion
-export { createLsTool as $, TextEvent as A, CheckpointSaverOptions as At, DynamicApprovalConfig as B, FileWrittenEvent as C, FileInfo as Ct, StepStartEvent as D, isSandboxBackend as Dt, StepFinishEvent as E, WriteResult as Et, WebSearchStartEvent as F, createExecuteToolFromBackend as G, SubAgent as H, AgentMemoryOptions as I, write_todos as J, execute as K, CreateDeepAgentParams as L, ToolCallEvent as M, ResumeDecision as Mt, ToolResultEvent as N, ResumeOptions as Nt, SubagentFinishEvent as O, BaseCheckpointSaver as Ot, WebSearchFinishEvent as P, createGrepTool as Q, SummarizationConfig as R, FileWriteStartEvent as S, FileData as St, HttpRequestStartEvent as T, SandboxBackendProtocol as Tt, CreateExecuteToolOptions as U, InterruptOnConfig as V, createExecuteTool as W, createFilesystemTools as X, createEditFileTool as Y, createGlobTool as Z, ExecuteFinishEvent as _, BackendFactory as _t, eventHasStructuredOutput as a, ls as at, FetchUrlStartEvent as b, EditResult as bt, hasStructuredOutput as c, CreateWebToolsOptions as ct, CheckpointLoadedEvent as d, createWebSearchTool as dt, createReadFileTool as et, CheckpointSavedEvent as f, createWebTools as ft, EventCallback as g, web_search as gt, ErrorEvent as h, http_request as ht, StructuredAgentResult as i, grep as it, TodosChangedEvent as j, InterruptData as jt, SubagentStartEvent as k, Checkpoint as kt, ApprovalRequestedEvent as l, createFetchUrlTool as lt, DoneEvent as m, htmlToMarkdown as mt, createDeepAgent as n, edit_file as nt, getEventOutput as o, read_file as ot, DeepAgentEvent as p, fetch_url as pt, createTodosTool as q, ModelMessage$1 as r, glob as rt, getStructuredOutput as s, write_file as st, DeepAgent as t, createWriteFileTool as tt, ApprovalResponseEvent as u, createHttpRequestTool as ut, ExecuteStartEvent as v, BackendProtocol as vt, HttpRequestFinishEvent as w, GrepMatch as wt, FileEditedEvent as x, ExecuteResponse as xt, FetchUrlFinishEvent as y, DeepAgentState as yt, TodoItem as z };
-//# sourceMappingURL=agent-BDM-PIu8.d.mts.map
+export { createLsTool as $, TextEvent as A, isSandboxBackend as At, DynamicApprovalConfig as B, FileWrittenEvent as C, FileDownloadResponse as Ct, StepStartEvent as D, GrepMatch as Dt, StepFinishEvent as E, FileUploadResponse as Et, WebSearchStartEvent as F, ResumeDecision as Ft, createExecuteToolFromBackend as G, SubAgent as H, AgentMemoryOptions as I, ResumeOptions as It, write_todos as J, execute as K, CreateDeepAgentParams as L, ToolCallEvent as M, Checkpoint as Mt, ToolResultEvent as N, CheckpointSaverOptions as Nt, SubagentFinishEvent as O, SandboxBackendProtocol as Ot, WebSearchFinishEvent as P, InterruptData as Pt, createGrepTool as Q, SummarizationConfig as R, FileWriteStartEvent as S, FileData as St, HttpRequestStartEvent as T, FileOperationError as Tt, CreateExecuteToolOptions as U, InterruptOnConfig as V, createExecuteTool as W, createFilesystemTools as X, createEditFileTool as Y, createGlobTool as Z, ExecuteFinishEvent as _, BackendFactory as _t, eventHasStructuredOutput as a, ls as at, FetchUrlStartEvent as b, EditResult as bt, hasStructuredOutput as c, CreateWebToolsOptions as ct, CheckpointLoadedEvent as d, createWebSearchTool as dt, createReadFileTool as et, CheckpointSavedEvent as f, createWebTools as ft, EventCallback as g, web_search as gt, ErrorEvent as h, http_request as ht, StructuredAgentResult as i, grep as it, TodosChangedEvent as j, BaseCheckpointSaver as jt, SubagentStartEvent as k, WriteResult as kt, ApprovalRequestedEvent as l, createFetchUrlTool as lt, DoneEvent as m, htmlToMarkdown as mt, createDeepAgent as n, edit_file as nt, getEventOutput as o, read_file as ot, DeepAgentEvent as p, fetch_url as pt, createTodosTool as q, ModelMessage$1 as r, glob as rt, getStructuredOutput as s, write_file as st, DeepAgent as t, createWriteFileTool as tt, ApprovalResponseEvent as u, createHttpRequestTool as ut, ExecuteStartEvent as v, BackendProtocol as vt, HttpRequestFinishEvent as w, FileInfo as wt, FileEditedEvent as x, ExecuteResponse as xt, FetchUrlFinishEvent as y, DeepAgentState as yt, TodoItem as z };
+//# sourceMappingURL=agent-DHUp_-Fx.d.mts.map

package/dist/{agent-DToEVxs-.d.cts → agent-tfRthBvX.d.cts}

@@ -166,6 +166,68 @@ interface EditResult {
   /** Number of replacements made, undefined on failure */
   occurrences?: number;
 }
+/**
+ * Standardized error codes for file upload/download operations.
+ *
+ * These represent common, recoverable errors that an LLM can understand and potentially fix:
+ * - "file_not_found": The requested file doesn't exist (download)
+ * - "permission_denied": Access denied
+ * - "is_directory": Attempted to download a directory as a file
+ * - "invalid_path": Path syntax is malformed
+ *
+ * @example
+ * ```typescript
+ * type FileError = FileOperationError;
+ * // Valid values: "file_not_found" | "permission_denied" | "is_directory" | "invalid_path"
+ * ```
+ */
+type FileOperationError = "file_not_found" | "permission_denied" | "is_directory" | "invalid_path";
+/**
+ * Result of a single file download operation.
+ *
+ * The response is designed to allow partial success in batch operations.
+ * The errors are standardized using FileOperationError literals.
+ *
+ * @example Success
+ * ```typescript
+ * { path: "/app/config.json", content: new Uint8Array(...), error: null }
+ * ```
+ *
+ * @example Failure
+ * ```typescript
+ * { path: "/wrong/path.txt", content: null, error: "file_not_found" }
+ * ```
+ */
+interface FileDownloadResponse {
+  /** The file path that was requested */
+  path: string;
+  /** File contents as bytes on success, null on failure */
+  content: Uint8Array | null;
+  /** Standardized error code on failure, null on success */
+  error: FileOperationError | null;
+}
+/**
+ * Result of a single file upload operation.
+ *
+ * The response is designed to allow partial success in batch operations.
+ * The errors are standardized using FileOperationError literals.
+ *
+ * @example Success
+ * ```typescript
+ * { path: "/app/data.txt", error: null }
+ * ```
+ *
+ * @example Failure
+ * ```typescript
+ * { path: "/readonly/file.txt", error: "permission_denied" }
+ * ```
+ */
+interface FileUploadResponse {
+  /** The file path that was requested */
+  path: string;
+  /** Standardized error code on failure, null on success */
+  error: FileOperationError | null;
+}
 /**
  * Shared state for deep agent operations.
  * This is passed to tools and modified during execution.
@@ -236,6 +298,54 @@ interface SandboxBackendProtocol extends BackendProtocol {
    * Unique identifier for this sandbox instance.
    */
   readonly id: string;
+  /**
+   * Upload multiple files to the sandbox.
+   *
+   * This API is designed to allow partial success - individual uploads may fail
+   * without affecting others. Check the error field in each response.
+   *
+   * @param files - Array of [path, content] tuples to upload
+   * @returns Array of FileUploadResponse objects, one per input file
+   *
+   * @example
+   * ```typescript
+   * const responses = await sandbox.uploadFiles([
+   *   ["/app/config.json", new Uint8Array(b"...")],
+   *   ["/app/data.txt", new Uint8Array(b"content")],
+   * ]);
+   * // Check for errors
+   * responses.forEach(r => {
+   *   if (r.error) console.error(`Failed to upload ${r.path}: ${r.error}`);
+   * });
+   * ```
+   */
+  uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+  /**
+   * Download multiple files from the sandbox.
+   *
+   * This API is designed to allow partial success - individual downloads may fail
+   * without affecting others. Check the error field in each response.
+   *
+   * @param paths - Array of file paths to download
+   * @returns Array of FileDownloadResponse objects, one per input path
+   *
+   * @example
+   * ```typescript
+   * const responses = await sandbox.downloadFiles([
+   *   "/app/config.json",
+   *   "/app/data.txt",
+   * ]);
+   * // Process successful downloads
+   * for (const r of responses) {
+   *   if (r.content) {
+   *     console.log(`Downloaded ${r.path}: ${r.content.length} bytes`);
+   *   } else if (r.error) {
+   *     console.error(`Failed to download ${r.path}: ${r.error}`);
+   *   }
+   * }
+   * ```
+   */
+  downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
 }
 /**
  * Type guard to check if a backend is a SandboxBackendProtocol.
@@ -338,8 +448,8 @@ declare function createReadFileTool(state: DeepAgentState, backend: BackendProto
  * Create the write_file tool.
  */
 declare function createWriteFileTool(state: DeepAgentState, backend: BackendProtocol | BackendFactory, onEvent?: EventCallback): ai2.Tool<{
-  file_path: string;
   content: string;
+  file_path: string;
 }, string>;
 /**
  * Create the edit_file tool.
@@ -392,8 +502,8 @@ declare function createFilesystemTools(state: DeepAgentState, backendOrOptions?:
     limit: number;
   }, string>;
   write_file: ai2.Tool<{
-    file_path: string;
     content: string;
+    file_path: string;
   }, string>;
   edit_file: ai2.Tool<{
     file_path: string;
@@ -1496,5 +1606,5 @@ declare class DeepAgent {
  */
 declare function createDeepAgent(params: CreateDeepAgentParams): DeepAgent;
 //#endregion
-export { createLsTool as $, TextEvent as A, CheckpointSaverOptions as At, DynamicApprovalConfig as B, FileWrittenEvent as C, FileInfo as Ct, StepStartEvent as D, isSandboxBackend as Dt, StepFinishEvent as E, WriteResult as Et, WebSearchStartEvent as F, createExecuteToolFromBackend as G, SubAgent as H, AgentMemoryOptions as I, write_todos as J, execute as K, CreateDeepAgentParams as L, ToolCallEvent as M, ResumeDecision as Mt, ToolResultEvent as N, ResumeOptions as Nt, SubagentFinishEvent as O, BaseCheckpointSaver as Ot, WebSearchFinishEvent as P, createGrepTool as Q, SummarizationConfig as R, FileWriteStartEvent as S, FileData as St, HttpRequestStartEvent as T, SandboxBackendProtocol as Tt, CreateExecuteToolOptions as U, InterruptOnConfig as V, createExecuteTool as W, createFilesystemTools as X, createEditFileTool as Y, createGlobTool as Z, ExecuteFinishEvent as _, BackendFactory as _t, eventHasStructuredOutput as a, ls as at, FetchUrlStartEvent as b, EditResult as bt, hasStructuredOutput as c, CreateWebToolsOptions as ct, CheckpointLoadedEvent as d, createWebSearchTool as dt, createReadFileTool as et, CheckpointSavedEvent as f, createWebTools as ft, EventCallback as g, web_search as gt, ErrorEvent as h, http_request as ht, StructuredAgentResult as i, grep as it, TodosChangedEvent as j, InterruptData as jt, SubagentStartEvent as k, Checkpoint as kt, ApprovalRequestedEvent as l, createFetchUrlTool as lt, DoneEvent as m, htmlToMarkdown as mt, createDeepAgent as n, edit_file as nt, getEventOutput as o, read_file as ot, DeepAgentEvent as p, fetch_url as pt, createTodosTool as q, ModelMessage$1 as r, glob as rt, getStructuredOutput as s, write_file as st, DeepAgent as t, createWriteFileTool as tt, ApprovalResponseEvent as u, createHttpRequestTool as ut, ExecuteStartEvent as v, BackendProtocol as vt, HttpRequestFinishEvent as w, GrepMatch as wt, FileEditedEvent as x, ExecuteResponse as xt, FetchUrlFinishEvent as y, DeepAgentState as yt, TodoItem as z };
-//# sourceMappingURL=agent-DToEVxs-.d.cts.map
+export { createLsTool as $, TextEvent as A, isSandboxBackend as At, DynamicApprovalConfig as B, FileWrittenEvent as C, FileDownloadResponse as Ct, StepStartEvent as D, GrepMatch as Dt, StepFinishEvent as E, FileUploadResponse as Et, WebSearchStartEvent as F, ResumeDecision as Ft, createExecuteToolFromBackend as G, SubAgent as H, AgentMemoryOptions as I, ResumeOptions as It, write_todos as J, execute as K, CreateDeepAgentParams as L, ToolCallEvent as M, Checkpoint as Mt, ToolResultEvent as N, CheckpointSaverOptions as Nt, SubagentFinishEvent as O, SandboxBackendProtocol as Ot, WebSearchFinishEvent as P, InterruptData as Pt, createGrepTool as Q, SummarizationConfig as R, FileWriteStartEvent as S, FileData as St, HttpRequestStartEvent as T, FileOperationError as Tt, CreateExecuteToolOptions as U, InterruptOnConfig as V, createExecuteTool as W, createFilesystemTools as X, createEditFileTool as Y, createGlobTool as Z, ExecuteFinishEvent as _, BackendFactory as _t, eventHasStructuredOutput as a, ls as at, FetchUrlStartEvent as b, EditResult as bt, hasStructuredOutput as c, CreateWebToolsOptions as ct, CheckpointLoadedEvent as d, createWebSearchTool as dt, createReadFileTool as et, CheckpointSavedEvent as f, createWebTools as ft, EventCallback as g, web_search as gt, ErrorEvent as h, http_request as ht, StructuredAgentResult as i, grep as it, TodosChangedEvent as j, BaseCheckpointSaver as jt, SubagentStartEvent as k, WriteResult as kt, ApprovalRequestedEvent as l, createFetchUrlTool as lt, DoneEvent as m, htmlToMarkdown as mt, createDeepAgent as n, edit_file as nt, getEventOutput as o, read_file as ot, DeepAgentEvent as p, fetch_url as pt, createTodosTool as q, ModelMessage$1 as r, glob as rt, getStructuredOutput as s, write_file as st, DeepAgent as t, createWriteFileTool as tt, ApprovalResponseEvent as u, createHttpRequestTool as ut, ExecuteStartEvent as v, BackendProtocol as vt, HttpRequestFinishEvent as w, FileInfo as wt, FileEditedEvent as x, ExecuteResponse as xt, FetchUrlFinishEvent as y, DeepAgentState as yt, TodoItem as z };
+//# sourceMappingURL=agent-tfRthBvX.d.cts.map

package/dist/{chunk-C5azi7Hr.cjs → chunk-DUZBydyJ.cjs}

@@ -6,6 +6,7 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __exportAll = (all, symbols) => {
 	let target = {};
 	for (var name in all) {
@@ -41,6 +42,12 @@ var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["modu
 
 //#endregion
 
+Object.defineProperty(exports, '__commonJSMin', {
+  enumerable: true,
+  get: function () {
+    return __commonJSMin;
+  }
+});
 Object.defineProperty(exports, '__esmMin', {
   enumerable: true,
   get: function () {

package/dist/cli/index.cjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
-const require_chunk = require('../chunk-C5azi7Hr.cjs');
-const require_file_saver = require('../file-saver-BYPKakT4.cjs');
+const require_chunk = require('../chunk-DUZBydyJ.cjs');
+const require_file_saver = require('../file-saver-ZDVH1zHI.cjs');
 let react = require("react");
 react = require_chunk.__toESM(react);
 let ink = require("ink");

package/dist/cli/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env bun
-import { St as init_limits, _t as DEFAULT_EVICTION_TOKEN_LIMIT, bt as DEFAULT_SUMMARIZATION_THRESHOLD, gt as CONTEXT_WINDOW, l as estimateMessagesTokens, n as parseModelString, o as createDeepAgent, r as LocalSandbox, t as FileSaver, vt as DEFAULT_KEEP_MESSAGES } from "../file-saver-Hj5so3dV.mjs";
+import { St as init_limits, _t as DEFAULT_EVICTION_TOKEN_LIMIT, bt as DEFAULT_SUMMARIZATION_THRESHOLD, gt as CONTEXT_WINDOW, l as estimateMessagesTokens, n as parseModelString, o as createDeepAgent, r as LocalSandbox, t as FileSaver, vt as DEFAULT_KEEP_MESSAGES } from "../file-saver-CQWTIr8z.mjs";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Box, Text, render, useApp, useInput } from "ink";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";

package/dist/{file-saver-Hj5so3dV.mjs → file-saver-CQWTIr8z.mjs}

@@ -1,3 +1,4 @@
+import { createRequire } from "node:module";
 import { Output, ToolLoopAgent, generateText, stepCountIs, streamText, tool, wrapLanguageModel } from "ai";
 import { z } from "zod";
 import micromatch from "micromatch";
@@ -18,6 +19,7 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __exportAll = (all, symbols) => {
 	let target = {};
 	for (var name in all) {
@@ -46,6 +48,7 @@ var __copyProps = (to, from, except, desc) => {
 	return to;
 };
 var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 //#endregion
 //#region src/constants/limits.ts
@@ -233,7 +236,7 @@ var init_events = __esmMin((() => {}));
 * Type guard to check if a backend is a SandboxBackendProtocol.
 */
 function isSandboxBackend(backend) {
-	return typeof backend.execute === "function" && typeof backend.id === "string";
+	return typeof backend.execute === "function" && typeof backend.uploadFiles === "function" && typeof backend.downloadFiles === "function" && typeof backend.id === "string";
 }
 
 //#endregion
@@ -2321,7 +2324,7 @@ var DeepAgent = class {
 	* Supports both legacy skillsDir and new agentId modes.
 	*/
 	async loadSkills(options) {
-		const { listSkills } = await import("./load-BDxe6Cet.mjs");
+		const { listSkills } = await import("./load-DRzSpESX.mjs");
 		this.skillsMetadata = (await listSkills(options.agentId ? { agentId: options.agentId } : { projectSkillsDir: options.skillsDir })).map((s) => ({
 			name: s.name,
 			description: s.description,
@@ -2920,6 +2923,18 @@ function createDeepAgent(params) {
 init_errors();
 init_limits();
 /**
+* Map error messages to FileOperationError literals.
+*
+* This provides structured error handling that LLMs can understand and potentially fix.
+*/
+function mapErrorToOperationError(errorMessage, path) {
+	const lowerError = errorMessage.toLowerCase();
+	if (lowerError.includes("no such file") || lowerError.includes("not found") || lowerError.includes("cannot find")) return "file_not_found";
+	if (lowerError.includes("permission denied") || lowerError.includes("access denied") || lowerError.includes("read-only")) return "permission_denied";
+	if (lowerError.includes("is a directory") || lowerError.includes("directory not empty")) return "is_directory";
+	return "invalid_path";
+}
+/**
 * Encode string to base64 for safe shell transmission.
 */
 function toBase64(str) {
@@ -2958,6 +2973,74 @@ function buildNodeScript(script, args) {
 * ```
 */
 var BaseSandbox = class {
+	/**
+	* 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.
+	*/
+	async uploadFiles(files) {
+		const responses = [];
+		for (const [path, content] of files) try {
+			const base64Content = Buffer.from(content).toString("base64");
+			const escapedPath = path.replace(/'/g, "'\\''");
+			const result = await this.execute(`echo '${base64Content}' | base64 -d > '${escapedPath}'`);
+			if (result.exitCode !== 0) responses.push({
+				path,
+				error: mapErrorToOperationError(result.output, path)
+			});
+			else responses.push({
+				path,
+				error: null
+			});
+		} catch (error) {
+			responses.push({
+				path,
+				error: "permission_denied"
+			});
+		}
+		return responses;
+	}
+	/**
+	* 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.
+	*/
+	async downloadFiles(paths) {
+		const responses = [];
+		for (const path of paths) try {
+			const escapedPath = path.replace(/'/g, "'\\''");
+			const result = await this.execute(`base64 '${escapedPath}'`);
+			if (result.exitCode !== 0) responses.push({
+				path,
+				content: null,
+				error: mapErrorToOperationError(result.output, path)
+			});
+			else {
+				const base64Content = result.output.trim();
+				const content = Buffer.from(base64Content, "base64");
+				responses.push({
+					path,
+					content,
+					error: null
+				});
+			}
+		} catch (error) {
+			responses.push({
+				path,
+				content: null,
+				error: "permission_denied"
+			});
+		}
+		return responses;
+	}
 	/**
 	* List files and directories in a path.
 	*/
@@ -3564,5 +3647,5 @@ var FileSaver = class {
 };
 
 //#endregion
-export { grepMatchesFromFiles as $, createGrepTool as A, DEFAULT_EVICTION_TOKEN_LIMIT as B, htmlToMarkdown as C, createEditFileTool as D, web_search as E, glob as F, shouldEvict as G, estimateTokens as H, grep as I, createFileData as J, StateBackend as K, ls as L, createReadFileTool as M, createWriteFileTool as N, createFilesystemTools as O, edit_file as P, globSearchFiles as Q, read_file as R, fetch_url as S, init_limits as St, init_web as T, evictToolResult as U, createToolResultWrapper as V, init_eviction as W, formatContentWithLineNumbers as X, fileDataToString as Y, formatReadResponse as Z, execute as _, DEFAULT_EVICTION_TOKEN_LIMIT$1 as _t, DeepAgent as a, createTodosTool as at, createWebSearchTool as b, DEFAULT_SUMMARIZATION_THRESHOLD$1 as bt, DEFAULT_SUMMARIZATION_THRESHOLD as c, DEFAULT_GENERAL_PURPOSE_DESCRIPTION as ct, summarizeIfNeeded as d, FILESYSTEM_SYSTEM_PROMPT as dt, performStringReplacement as et, hasDanglingToolCalls as f, TASK_SYSTEM_PROMPT as ft, createExecuteToolFromBackend as g, CONTEXT_WINDOW as gt, createExecuteTool as h, isSandboxBackend as ht, BaseSandbox as i, init_errors as it, createLsTool as j, createGlobTool as k, estimateMessagesTokens as l, DEFAULT_SUBAGENT_PROMPT as lt, createSubagentTool as m, getTaskToolDescription as mt, parseModelString as n, FILE_ALREADY_EXISTS as nt, createDeepAgent as o, write_todos as ot, patchToolCalls as p, TODO_SYSTEM_PROMPT as pt, checkEmptyContent as q, LocalSandbox as r, FILE_NOT_FOUND as rt, DEFAULT_KEEP_MESSAGES as s, BASE_PROMPT as st, FileSaver as t, updateFileData as tt, needsSummarization as u, EXECUTE_SYSTEM_PROMPT as ut, createFetchUrlTool as v, DEFAULT_KEEP_MESSAGES$1 as vt, http_request as w, createWebTools as x, MAX_FILE_SIZE_MB as xt, createHttpRequestTool as y, DEFAULT_READ_LIMIT as yt, write_file as z };
-//# sourceMappingURL=file-saver-Hj5so3dV.mjs.map
+export { grepMatchesFromFiles as $, createGrepTool as A, DEFAULT_EVICTION_TOKEN_LIMIT as B, htmlToMarkdown as C, __commonJSMin as Ct, createEditFileTool as D, __toCommonJS as Dt, web_search as E, __require as Et, glob as F, shouldEvict as G, estimateTokens as H, grep as I, createFileData as J, StateBackend as K, ls as L, createReadFileTool as M, createWriteFileTool as N, createFilesystemTools as O, edit_file as P, globSearchFiles as Q, read_file as R, fetch_url as S, init_limits as St, init_web as T, __exportAll as Tt, evictToolResult as U, createToolResultWrapper as V, init_eviction as W, formatContentWithLineNumbers as X, fileDataToString as Y, formatReadResponse as Z, execute as _, DEFAULT_EVICTION_TOKEN_LIMIT$1 as _t, DeepAgent as a, createTodosTool as at, createWebSearchTool as b, DEFAULT_SUMMARIZATION_THRESHOLD$1 as bt, DEFAULT_SUMMARIZATION_THRESHOLD as c, DEFAULT_GENERAL_PURPOSE_DESCRIPTION as ct, summarizeIfNeeded as d, FILESYSTEM_SYSTEM_PROMPT as dt, performStringReplacement as et, hasDanglingToolCalls as f, TASK_SYSTEM_PROMPT as ft, createExecuteToolFromBackend as g, CONTEXT_WINDOW as gt, createExecuteTool as h, isSandboxBackend as ht, BaseSandbox as i, init_errors as it, createLsTool as j, createGlobTool as k, estimateMessagesTokens as l, DEFAULT_SUBAGENT_PROMPT as lt, createSubagentTool as m, getTaskToolDescription as mt, parseModelString as n, FILE_ALREADY_EXISTS as nt, createDeepAgent as o, write_todos as ot, patchToolCalls as p, TODO_SYSTEM_PROMPT as pt, checkEmptyContent as q, LocalSandbox as r, FILE_NOT_FOUND as rt, DEFAULT_KEEP_MESSAGES as s, BASE_PROMPT as st, FileSaver as t, updateFileData as tt, needsSummarization as u, EXECUTE_SYSTEM_PROMPT as ut, createFetchUrlTool as v, DEFAULT_KEEP_MESSAGES$1 as vt, http_request as w, __esmMin as wt, createWebTools as x, MAX_FILE_SIZE_MB as xt, createHttpRequestTool as y, DEFAULT_READ_LIMIT as yt, write_file as z };
+//# sourceMappingURL=file-saver-CQWTIr8z.mjs.map