@langchain/daytona 0.2.0 → 0.2.2

package/README.md

@@ -208,7 +208,7 @@ await sdk.fs.createFolder("src", "755");
 await sdk.fs.uploadFile(Buffer.from("content"), "src/index.ts");
 ```
 
-See the [@daytonaio/sdk documentation](https://www.npmjs.com/package/@daytonaio/sdk) for all available SDK methods.
+See the [@daytona/sdk documentation](https://www.npmjs.com/package/@daytona/sdk) for all available SDK methods.
 
 ## Factory Functions
 

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-let _daytonaio_sdk = require("@daytonaio/sdk");
+let _daytona_sdk = require("@daytona/sdk");
 let deepagents = require("deepagents");
 //#region src/auth.ts
 /** Default Daytona API URL */
@@ -119,6 +119,8 @@ const DAYTONA_SANDBOX_ERROR_SYMBOL = Symbol.for("daytona.sandbox.error");
 * ```
 */
 var DaytonaSandboxError = class DaytonaSandboxError extends deepagents.SandboxError {
+	code;
+	cause;
 	/** Symbol for identifying sandbox error instances */
 	[DAYTONA_SANDBOX_ERROR_SYMBOL] = true;
 	/** Error name for instanceof checks and logging */
@@ -157,6 +159,9 @@ var DaytonaSandboxError = class DaytonaSandboxError extends deepagents.SandboxEr
 *
 * @packageDocumentation
 */
+function shellQuote(value) {
+	return `'${value.replace(/'/g, "'\\''")}'`;
+}
 /**
 * Daytona Sandbox backend for deepagents.
 *
@@ -309,7 +314,7 @@ var DaytonaSandbox = class DaytonaSandbox extends deepagents.BaseSandbox {
 			throw new DaytonaSandboxError("Failed to authenticate with Daytona. Check your API key configuration.", "AUTHENTICATION_FAILED", error instanceof Error ? error : void 0);
 		}
 		try {
-			this.#daytona = new _daytonaio_sdk.Daytona({
+			this.#daytona = new _daytona_sdk.Daytona({
 				apiKey: credentials.apiKey,
 				apiUrl: credentials.apiUrl,
 				target: credentials.target
@@ -406,7 +411,7 @@ var DaytonaSandbox = class DaytonaSandbox extends deepagents.BaseSandbox {
 		const results = [];
 		for (const [path, content] of files) try {
 			const parentDir = path.substring(0, path.lastIndexOf("/"));
-			if (parentDir) await sandbox.fs.createFolder(parentDir, "755");
+			if (parentDir) await this.#ensureParentDirectory(parentDir);
 			const buffer = Buffer.from(content);
 			await sandbox.fs.uploadFile(buffer, path);
 			results.push({
@@ -421,6 +426,9 @@ var DaytonaSandbox = class DaytonaSandbox extends deepagents.BaseSandbox {
 		}
 		return results;
 	}
+	async #ensureParentDirectory(parentDir) {
+		if ((await this.execute(`mkdir -p ${shellQuote(parentDir)}`)).exitCode !== 0) throw new Error(`Failed to create parent directory: ${parentDir}`);
+	}
 	/**
 	* Download files from the sandbox.
 	*
@@ -628,13 +636,14 @@ var DaytonaSandbox = class DaytonaSandbox extends deepagents.BaseSandbox {
 		} catch (error) {
 			throw new DaytonaSandboxError("Failed to authenticate with Daytona. Check your API key configuration.", "AUTHENTICATION_FAILED", error instanceof Error ? error : void 0);
 		}
-		const daytona = new _daytonaio_sdk.Daytona({
+		const daytona = new _daytona_sdk.Daytona({
 			apiKey: credentials.apiKey,
 			apiUrl: credentials.apiUrl,
 			target: credentials.target
 		});
-		const { items } = await daytona.list(labels);
-		return (await Promise.all(items.map((sandbox) => daytona.delete(sandbox).then(() => true).catch(() => false)))).filter(Boolean).length;
+		const sandboxes = [];
+		for await (const sandbox of daytona.list({ labels })) sandboxes.push(sandbox);
+		return (await Promise.all(sandboxes.map((sandbox) => daytona.delete(sandbox).then(() => true).catch(() => false)))).filter(Boolean).length;
 	}
 	/**
 	* Connect to an existing sandbox by ID.
@@ -661,7 +670,7 @@ var DaytonaSandbox = class DaytonaSandbox extends deepagents.BaseSandbox {
 			throw new DaytonaSandboxError("Failed to authenticate with Daytona. Check your API key configuration.", "AUTHENTICATION_FAILED", error instanceof Error ? error : void 0);
 		}
 		try {
-			const daytona = new _daytonaio_sdk.Daytona({
+			const daytona = new _daytona_sdk.Daytona({
 				apiKey: credentials.apiKey,
 				apiUrl: credentials.apiUrl,
 				target: credentials.target

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["SandboxError","BaseSandbox","#id","#sandbox","#daytona","#options","#timeout","Daytona","#uploadInitialFiles","#mapError","#setFromExisting"],"sources":["../src/auth.ts","../src/types.ts","../src/sandbox.ts"],"sourcesContent":["/**\n * Authentication utilities for Daytona Sandbox.\n *\n * This module provides authentication credential resolution for the Daytona SDK.\n *\n * @packageDocumentation\n */\n\nimport type { DaytonaSandboxOptions } from \"./types.js\";\n\n/**\n * Authentication credentials for Daytona API.\n */\nexport interface DaytonaCredentials {\n  /** Daytona API key */\n  apiKey: string;\n\n  /** Daytona API URL */\n  apiUrl: string;\n\n  /** Target region */\n  target?: string;\n}\n\n/** Default Daytona API URL */\nconst DEFAULT_API_URL = \"https://app.daytona.io/api\";\n\n/**\n * Get the API key for Daytona API.\n *\n * Authentication is resolved in the following priority order:\n *\n * 1. **Explicit API key**: If `options.apiKey` is provided, it is used directly.\n * 2. **DAYTONA_API_KEY**: Environment variable for Daytona API key.\n *\n * If no API key is found, an error is thrown with setup instructions.\n *\n * ## Environment Variable Setup\n *\n * ```bash\n * # Get your API key from https://app.daytona.io\n * export DAYTONA_API_KEY=your_api_key_here\n * ```\n *\n * @param options - Optional authentication configuration from DaytonaSandboxOptions\n * @returns The API key string\n * @throws {Error} If no API key is available\n *\n * @example\n * ```typescript\n * // With explicit API key\n * const apiKey = getAuthApiKey({ apiKey: \"my-api-key\" });\n *\n * // Using environment variables (auto-detected)\n * const apiKey = getAuthApiKey();\n *\n * // From DaytonaSandboxOptions\n * const options: DaytonaSandboxOptions = {\n *   auth: { apiKey: \"my-api-key\" }\n * };\n * const apiKey = getAuthApiKey(options.auth);\n * ```\n */\nexport function getAuthApiKey(options?: DaytonaSandboxOptions[\"auth\"]): string {\n  // Priority 1: Explicit API key in options\n  if (options?.apiKey) {\n    return options.apiKey;\n  }\n\n  // Priority 2: DAYTONA_API_KEY environment variable\n  const apiKey = process.env.DAYTONA_API_KEY;\n  if (apiKey) {\n    return apiKey;\n  }\n\n  // No API key found - throw descriptive error\n  throw new Error(\n    \"Daytona authentication required. Provide an API key using one of these methods:\\n\\n\" +\n      \"1. Set DAYTONA_API_KEY environment variable:\\n\" +\n      \"   Get your API key from https://app.daytona.io\\n\" +\n      \"   Run: export DAYTONA_API_KEY=your_api_key_here\\n\\n\" +\n      \"2. Pass API key directly in options:\\n\" +\n      \"   new DaytonaSandbox({ auth: { apiKey: '...' } })\",\n  );\n}\n\n/**\n * Get the API URL for Daytona API.\n *\n * URL is resolved in the following priority order:\n *\n * 1. **Explicit API URL**: If `options.apiUrl` is provided, it is used directly.\n * 2. **DAYTONA_API_URL**: Environment variable for Daytona API URL.\n * 3. **Default**: Uses the default Daytona API URL.\n *\n * @param options - Optional authentication configuration from DaytonaSandboxOptions\n * @returns The API URL string\n */\nexport function getAuthApiUrl(options?: DaytonaSandboxOptions[\"auth\"]): string {\n  // Priority 1: Explicit API URL in options\n  if (options?.apiUrl) {\n    return options.apiUrl;\n  }\n\n  // Priority 2: DAYTONA_API_URL environment variable\n  const apiUrl = process.env.DAYTONA_API_URL;\n  if (apiUrl) {\n    return apiUrl;\n  }\n\n  // Priority 3: Default URL\n  return DEFAULT_API_URL;\n}\n\n/**\n * Get authentication credentials for Daytona API.\n *\n * This function returns the credentials needed for the Daytona SDK.\n *\n * @param options - Optional authentication configuration from DaytonaSandboxOptions\n * @param target - Optional target region\n * @returns Complete authentication credentials\n * @throws {Error} If no API key is available\n */\nexport function getAuthCredentials(\n  options?: DaytonaSandboxOptions[\"auth\"],\n  target?: string,\n): DaytonaCredentials {\n  return {\n    apiKey: getAuthApiKey(options),\n    apiUrl: getAuthApiUrl(options),\n    target: target ?? process.env.DAYTONA_TARGET,\n  };\n}\n","/**\n * Type definitions for the Daytona Sandbox backend.\n *\n * This module contains all type definitions for the @langchain/daytona package,\n * including options and error types.\n */\n\nimport { type SandboxErrorCode, SandboxError } from \"deepagents\";\n\n/**\n * Supported target regions for Daytona sandboxes.\n *\n * - `us`: United States\n * - `eu`: Europe\n */\nexport type DaytonaSandboxTarget = \"us\" | \"eu\";\n\n/**\n * Configuration options for creating a Daytona Sandbox.\n *\n * @example\n * ```typescript\n * const options: DaytonaSandboxOptions = {\n *   language: \"typescript\",\n *   timeout: 300, // 5 minutes\n *   target: \"us\",\n * };\n * ```\n */\nexport interface DaytonaSandboxOptions {\n  /**\n   * Primary language for code execution in the sandbox.\n   *\n   * Determines the runtime environment and code execution tooling.\n   *\n   * @default \"typescript\"\n   */\n  language?: \"typescript\" | \"python\" | \"javascript\";\n\n  /**\n   * Custom environment variables to set in the sandbox.\n   *\n   * These variables will be available to all commands and code executed\n   * in the sandbox.\n   *\n   * @example\n   * ```typescript\n   * envVars: {\n   *   NODE_ENV: \"development\",\n   *   API_KEY: \"secret\"\n   * }\n   * ```\n   */\n  envVars?: Record<string, string>;\n\n  /**\n   * Resource allocation for the sandbox.\n   *\n   * When specifying resources, you must also specify an `image`.\n   * Resources cannot be customized when using the default snapshot-based sandbox.\n   *\n   * @example\n   * ```typescript\n   * resources: { cpu: 2, memory: 4, disk: 20 }\n   * ```\n   */\n  resources?: {\n    /** Number of CPUs to allocate */\n    cpu?: number;\n    /** Amount of memory in GiB */\n    memory?: number;\n    /** Amount of disk space in GiB */\n    disk?: number;\n  };\n\n  /**\n   * Custom Docker image to use for the sandbox.\n   *\n   * When specified, creates a sandbox from this image instead of the default snapshot.\n   * This is required when you want to customize resources.\n   *\n   * @example \"node:20\" or \"python:3.12\"\n   */\n  image?: string;\n\n  /**\n   * Snapshot name to use for the sandbox.\n   *\n   * When specified, creates a sandbox from this snapshot.\n   * Cannot be used together with `image`.\n   */\n  snapshot?: string;\n\n  /**\n   * Target region where the sandbox will be created.\n   *\n   * @default \"us\"\n   */\n  target?: DaytonaSandboxTarget;\n\n  /**\n   * Auto-stop interval in minutes.\n   *\n   * The sandbox will automatically stop after being idle for this duration.\n   * Set to 0 to disable auto-stop.\n   *\n   * @default 15\n   */\n  autoStopInterval?: number;\n\n  /**\n   * Auto-archive interval in minutes.\n   *\n   * The sandbox will automatically archive after being stopped for this duration.\n   */\n  autoArchiveInterval?: number;\n\n  /**\n   * Auto-delete interval in minutes.\n   *\n   * The sandbox will automatically delete after being stopped for this duration.\n   */\n  autoDeleteInterval?: number;\n\n  /**\n   * Default timeout for command execution in seconds.\n   *\n   * @default 300 (5 minutes)\n   */\n  timeout?: number;\n\n  /**\n   * Custom labels to attach to the sandbox.\n   *\n   * Labels can be used for organizing and filtering sandboxes.\n   */\n  labels?: Record<string, string>;\n\n  /**\n   * Initial files to create in the sandbox after initialization.\n   *\n   * A map of file paths to their contents. Files will be created\n   * in the sandbox filesystem before any commands are executed.\n   * Parent directories are created automatically.\n   *\n   * @example\n   * ```typescript\n   * const options: DaytonaSandboxOptions = {\n   *   language: \"typescript\",\n   *   initialFiles: {\n   *     \"/app/index.js\": \"console.log('Hello')\",\n   *     \"/app/package.json\": '{\"name\": \"test\"}',\n   *   },\n   * };\n   * ```\n   */\n  initialFiles?: Record<string, string>;\n\n  /**\n   * Authentication configuration for Daytona API.\n   *\n   * ### Environment Variable Setup\n   *\n   * ```bash\n   * # Get your API key from https://app.daytona.io\n   * export DAYTONA_API_KEY=your_api_key_here\n   * ```\n   *\n   * Or pass the API key directly in this auth configuration.\n   */\n  auth?: {\n    /**\n     * Daytona API key.\n     * If not provided, reads from `DAYTONA_API_KEY` environment variable.\n     */\n    apiKey?: string;\n\n    /**\n     * Daytona API URL.\n     * If not provided, reads from `DAYTONA_API_URL` environment variable\n     * or uses the default Daytona API URL.\n     *\n     * @default \"https://app.daytona.io/api\"\n     */\n    apiUrl?: string;\n  };\n}\n\n/**\n * Error codes for Daytona Sandbox operations.\n *\n * Used to identify specific error conditions and handle them appropriately.\n */\nexport type DaytonaSandboxErrorCode =\n  | SandboxErrorCode\n  /** Authentication failed - check API key configuration */\n  | \"AUTHENTICATION_FAILED\"\n  /** Failed to create sandbox - check options and quotas */\n  | \"SANDBOX_CREATION_FAILED\"\n  /** Sandbox not found - may have been deleted or expired */\n  | \"SANDBOX_NOT_FOUND\"\n  /** Sandbox is not in started state */\n  | \"SANDBOX_NOT_STARTED\"\n  /** Resource limits exceeded (CPU, memory, storage) */\n  | \"RESOURCE_LIMIT_EXCEEDED\";\n\nconst DAYTONA_SANDBOX_ERROR_SYMBOL = Symbol.for(\"daytona.sandbox.error\");\n\n/**\n * Custom error class for Daytona Sandbox operations.\n *\n * Provides structured error information including:\n * - Human-readable message\n * - Error code for programmatic handling\n * - Original cause for debugging\n *\n * @example\n * ```typescript\n * try {\n *   await sandbox.execute(\"some command\");\n * } catch (error) {\n *   if (error instanceof DaytonaSandboxError) {\n *     switch (error.code) {\n *       case \"NOT_INITIALIZED\":\n *         await sandbox.initialize();\n *         break;\n *       case \"COMMAND_TIMEOUT\":\n *         console.error(\"Command took too long\");\n *         break;\n *       default:\n *         throw error;\n *     }\n *   }\n * }\n * ```\n */\nexport class DaytonaSandboxError extends SandboxError {\n  /** Symbol for identifying sandbox error instances */\n  [DAYTONA_SANDBOX_ERROR_SYMBOL] = true as const;\n\n  /** Error name for instanceof checks and logging */\n  override readonly name = \"DaytonaSandboxError\";\n\n  /**\n   * Creates a new DaytonaSandboxError.\n   *\n   * @param message - Human-readable error description\n   * @param code - Structured error code for programmatic handling\n   * @param cause - Original error that caused this error (for debugging)\n   */\n  constructor(\n    message: string,\n    public readonly code: DaytonaSandboxErrorCode,\n    public override readonly cause?: Error,\n  ) {\n    super(message, code as SandboxErrorCode, cause);\n    // Maintain proper prototype chain for instanceof checks\n    Object.setPrototypeOf(this, DaytonaSandboxError.prototype);\n  }\n\n  /**\n   * Checks if the error is an instance of DaytonaSandboxError.\n   *\n   * @param error - The error to check\n   * @returns True if the error is an instance of DaytonaSandboxError, false otherwise\n   */\n  static isInstance(error: unknown): error is DaytonaSandboxError {\n    return (\n      typeof error === \"object\" &&\n      error !== null &&\n      (error as Record<symbol, unknown>)[DAYTONA_SANDBOX_ERROR_SYMBOL] === true\n    );\n  }\n}\n","/* eslint-disable no-instanceof/no-instanceof */\n/**\n * Daytona Sandbox implementation of the SandboxBackendProtocol.\n *\n * This module provides a Daytona Sandbox backend for deepagents, enabling agents\n * to execute commands, read/write files, and manage isolated sandbox environments\n * using Daytona's infrastructure.\n *\n * @packageDocumentation\n */\n\nimport { Daytona, type Sandbox } from \"@daytonaio/sdk\";\nimport {\n  BaseSandbox,\n  type ExecuteResponse,\n  type FileDownloadResponse,\n  type FileOperationError,\n  type FileUploadResponse,\n  type BackendFactory,\n} from \"deepagents\";\n\nimport { getAuthCredentials } from \"./auth.js\";\nimport { DaytonaSandboxError, type DaytonaSandboxOptions } from \"./types.js\";\n\n/**\n * Daytona Sandbox backend for deepagents.\n *\n * Extends `BaseSandbox` to provide command execution, file operations, and\n * sandbox lifecycle management using Daytona's SDK.\n *\n * ## Basic Usage\n *\n * ```typescript\n * import { DaytonaSandbox } from \"@langchain/daytona\";\n *\n * // Create and initialize a sandbox\n * const sandbox = await DaytonaSandbox.create({\n *   language: \"typescript\",\n *   timeout: 300,\n * });\n *\n * try {\n *   // Execute commands\n *   const result = await sandbox.execute(\"node --version\");\n *   console.log(result.output);\n * } finally {\n *   // Always cleanup\n *   await sandbox.close();\n * }\n * ```\n *\n * ## Using with DeepAgent\n *\n * ```typescript\n * import { createDeepAgent } from \"deepagents\";\n * import { DaytonaSandbox } from \"@langchain/daytona\";\n *\n * const sandbox = await DaytonaSandbox.create();\n *\n * const agent = createDeepAgent({\n *   model: new ChatAnthropic({ model: \"claude-sonnet-4-20250514\" }),\n *   systemPrompt: \"You are a coding assistant with sandbox access.\",\n *   backend: sandbox,\n * });\n * ```\n */\nexport class DaytonaSandbox extends BaseSandbox {\n  /** Private reference to the Daytona client */\n  #daytona: Daytona | null = null;\n\n  /** Private reference to the underlying Daytona Sandbox instance */\n  #sandbox: Sandbox | null = null;\n\n  /** Configuration options for this sandbox */\n  #options: DaytonaSandboxOptions;\n\n  /** Unique identifier for this sandbox instance */\n  #id: string;\n\n  /** Default timeout for command execution in seconds */\n  #timeout: number;\n\n  /**\n   * Get the unique identifier for this sandbox.\n   *\n   * Before initialization, returns a temporary ID.\n   * After initialization, returns the actual Daytona sandbox ID.\n   */\n  get id(): string {\n    return this.#id;\n  }\n\n  /**\n   * Get the underlying Daytona Sandbox instance.\n   *\n   * @throws {DaytonaSandboxError} If the sandbox is not initialized\n   *\n   * @example\n   * ```typescript\n   * const sandbox = await DaytonaSandbox.create();\n   * const daytonaSdk = sandbox.sandbox; // Access the raw SDK\n   * ```\n   */\n  get instance(): Sandbox {\n    if (!this.#sandbox) {\n      throw new DaytonaSandboxError(\n        \"Sandbox not initialized. Call initialize() or use DaytonaSandbox.create()\",\n        \"NOT_INITIALIZED\",\n      );\n    }\n    return this.#sandbox;\n  }\n\n  /**\n   * Get the underlying Daytona client instance.\n   *\n   * @throws {DaytonaSandboxError} If the client is not initialized\n   *\n   * @example\n   * ```typescript\n   * const sandbox = await DaytonaSandbox.create();\n   * const daytonaClient = sandbox.client; // Access the raw Daytona client\n   * ```\n   */\n  get client(): Daytona {\n    if (!this.#daytona) {\n      throw new DaytonaSandboxError(\n        \"Daytona client not initialized. Call initialize() or use DaytonaSandbox.create()\",\n        \"NOT_INITIALIZED\",\n      );\n    }\n    return this.#daytona;\n  }\n\n  /**\n   * Check if the sandbox is initialized and running.\n   */\n  get isRunning(): boolean {\n    return this.#sandbox !== null;\n  }\n\n  /**\n   * Create a new DaytonaSandbox instance.\n   *\n   * Note: This only creates the instance. Call `initialize()` to actually\n   * create the Daytona Sandbox, or use the static `DaytonaSandbox.create()` method.\n   *\n   * @param options - Configuration options for the sandbox\n   *\n   * @example\n   * ```typescript\n   * // Two-step initialization\n   * const sandbox = new DaytonaSandbox({ language: \"typescript\" });\n   * await sandbox.initialize();\n   *\n   * // Or use the factory method\n   * const sandbox = await DaytonaSandbox.create({ language: \"typescript\" });\n   * ```\n   */\n  constructor(options: DaytonaSandboxOptions = {}) {\n    super();\n\n    // Set defaults\n    this.#options = {\n      language: \"typescript\",\n      timeout: 300,\n      ...options,\n    };\n\n    this.#timeout = this.#options.timeout ?? 300;\n\n    // Generate temporary ID until initialized\n    this.#id = `daytona-sandbox-${Date.now()}`;\n  }\n\n  /**\n   * Initialize the sandbox by creating a new Daytona Sandbox instance.\n   *\n   * This method authenticates with Daytona and provisions a new sandbox.\n   * After initialization, the `id` property will reflect the actual sandbox ID.\n   *\n   * @throws {DaytonaSandboxError} If already initialized (`ALREADY_INITIALIZED`)\n   * @throws {DaytonaSandboxError} If authentication fails (`AUTHENTICATION_FAILED`)\n   * @throws {DaytonaSandboxError} If sandbox creation fails (`SANDBOX_CREATION_FAILED`)\n   *\n   * @example\n   * ```typescript\n   * const sandbox = new DaytonaSandbox();\n   * await sandbox.initialize();\n   * console.log(`Sandbox ID: ${sandbox.id}`);\n   * ```\n   */\n  async initialize(): Promise<void> {\n    // Prevent double initialization\n    if (this.#sandbox) {\n      throw new DaytonaSandboxError(\n        \"Sandbox is already initialized. Each DaytonaSandbox instance can only be initialized once.\",\n        \"ALREADY_INITIALIZED\",\n      );\n    }\n\n    // Get authentication credentials\n    let credentials: { apiKey: string; apiUrl: string; target?: string };\n    try {\n      credentials = getAuthCredentials(\n        this.#options.auth,\n        this.#options.target,\n      );\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        \"Failed to authenticate with Daytona. Check your API key configuration.\",\n        \"AUTHENTICATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n\n    try {\n      // Create Daytona client\n      this.#daytona = new Daytona({\n        apiKey: credentials.apiKey,\n        apiUrl: credentials.apiUrl,\n        target: credentials.target,\n      });\n\n      // Determine if we're creating from image or snapshot\n      if (this.#options.image) {\n        // Create from image (allows custom resources)\n        const createOptions: {\n          image: string;\n          language?: string;\n          envVars?: Record<string, string>;\n          autoStopInterval?: number;\n          autoArchiveInterval?: number;\n          autoDeleteInterval?: number;\n          labels?: Record<string, string>;\n          resources?: { cpu?: number; memory?: number; disk?: number };\n        } = {\n          image: this.#options.image,\n          language: this.#options.language ?? \"typescript\",\n        };\n\n        if (this.#options.envVars) {\n          createOptions.envVars = this.#options.envVars;\n        }\n\n        if (this.#options.autoStopInterval !== undefined) {\n          createOptions.autoStopInterval = this.#options.autoStopInterval;\n        }\n\n        if (this.#options.autoArchiveInterval !== undefined) {\n          createOptions.autoArchiveInterval = this.#options.autoArchiveInterval;\n        }\n\n        if (this.#options.autoDeleteInterval !== undefined) {\n          createOptions.autoDeleteInterval = this.#options.autoDeleteInterval;\n        }\n\n        if (this.#options.labels) {\n          createOptions.labels = this.#options.labels;\n        }\n\n        if (this.#options.resources) {\n          createOptions.resources = this.#options.resources;\n        }\n\n        // Create the sandbox from image\n        this.#sandbox = await this.#daytona.create(createOptions);\n      } else {\n        // Create from snapshot (default, simpler approach)\n        const createOptions: {\n          language?: string;\n          snapshot?: string;\n          envVars?: Record<string, string>;\n          autoStopInterval?: number;\n          autoArchiveInterval?: number;\n          autoDeleteInterval?: number;\n          labels?: Record<string, string>;\n        } = {\n          language: this.#options.language ?? \"typescript\",\n        };\n\n        if (this.#options.snapshot) {\n          createOptions.snapshot = this.#options.snapshot;\n        }\n\n        if (this.#options.envVars) {\n          createOptions.envVars = this.#options.envVars;\n        }\n\n        if (this.#options.autoStopInterval !== undefined) {\n          createOptions.autoStopInterval = this.#options.autoStopInterval;\n        }\n\n        if (this.#options.autoArchiveInterval !== undefined) {\n          createOptions.autoArchiveInterval = this.#options.autoArchiveInterval;\n        }\n\n        if (this.#options.autoDeleteInterval !== undefined) {\n          createOptions.autoDeleteInterval = this.#options.autoDeleteInterval;\n        }\n\n        if (this.#options.labels) {\n          createOptions.labels = this.#options.labels;\n        }\n\n        // Create the sandbox from snapshot\n        this.#sandbox = await this.#daytona.create(createOptions);\n      }\n\n      // Update ID to the actual sandbox ID\n      this.#id = this.#sandbox.id;\n\n      // Upload initial files if provided\n      if (this.#options.initialFiles) {\n        await this.#uploadInitialFiles(this.#options.initialFiles);\n      }\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        `Failed to create Daytona Sandbox: ${error instanceof Error ? error.message : String(error)}`,\n        \"SANDBOX_CREATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Upload initial files to the sandbox.\n   *\n   * @param files - A map of file paths to their string contents\n   */\n  async #uploadInitialFiles(files: Record<string, string>): Promise<void> {\n    const encoder = new TextEncoder();\n    const fileEntries: Array<[string, Uint8Array]> = Object.entries(files).map(\n      ([path, content]) => [path, encoder.encode(content)],\n    );\n\n    const results = await this.uploadFiles(fileEntries);\n\n    // Check for any errors during upload\n    const errors = results.filter((r) => r.error !== null);\n    if (errors.length > 0) {\n      const errorPaths = errors.map((e) => `${e.path}: ${e.error}`).join(\", \");\n      throw new DaytonaSandboxError(\n        `Failed to upload initial files: ${errorPaths}`,\n        \"FILE_OPERATION_FAILED\",\n      );\n    }\n  }\n\n  /**\n   * Execute a command in the sandbox.\n   *\n   * Commands are run using the sandbox's shell.\n   *\n   * @param command - The shell command to execute\n   * @returns Execution result with output, exit code, and truncation flag\n   * @throws {DaytonaSandboxError} If the sandbox is not initialized\n   *\n   * @example\n   * ```typescript\n   * const result = await sandbox.execute(\"echo 'Hello World'\");\n   * console.log(result.output); // \"Hello World\\n\"\n   * console.log(result.exitCode); // 0\n   * ```\n   */\n  async execute(command: string): Promise<ExecuteResponse> {\n    const sandbox = this.instance; // Throws if not initialized\n\n    try {\n      const response = await sandbox.process.executeCommand(\n        command,\n        undefined,\n        undefined,\n        this.#timeout,\n      );\n\n      return {\n        output: response.result ?? \"\",\n        exitCode: response.exitCode ?? 0,\n        truncated: false,\n      };\n    } catch (error) {\n      // Check for timeout\n      if (error instanceof Error && error.message.includes(\"timeout\")) {\n        throw new DaytonaSandboxError(\n          `Command timed out: ${command}`,\n          \"COMMAND_TIMEOUT\",\n          error,\n        );\n      }\n\n      throw new DaytonaSandboxError(\n        `Command execution failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"COMMAND_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Upload files to the sandbox.\n   *\n   * Files are written to the sandbox filesystem. Parent directories are\n   * created automatically if they don't exist.\n   *\n   * @param files - Array of [path, content] tuples to upload\n   * @returns Upload result for each file, with success or error status\n   *\n   * @example\n   * ```typescript\n   * const encoder = new TextEncoder();\n   * const results = await sandbox.uploadFiles([\n   *   [\"src/index.js\", encoder.encode(\"console.log('Hello')\")],\n   *   [\"package.json\", encoder.encode('{\"name\": \"test\"}')],\n   * ]);\n   * ```\n   */\n  async uploadFiles(\n    files: Array<[string, Uint8Array]>,\n  ): Promise<FileUploadResponse[]> {\n    const sandbox = this.instance; // Throws if not initialized\n    const results: FileUploadResponse[] = [];\n\n    for (const [path, content] of files) {\n      try {\n        // Ensure parent directory exists\n        const parentDir = path.substring(0, path.lastIndexOf(\"/\"));\n        if (parentDir) {\n          await sandbox.fs.createFolder(parentDir, \"755\");\n        }\n\n        // Upload the file content\n        const buffer = Buffer.from(content);\n        await sandbox.fs.uploadFile(buffer, path);\n        results.push({ path, error: null });\n      } catch (error) {\n        results.push({ path, error: this.#mapError(error) });\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Download files from the sandbox.\n   *\n   * Each file is read individually, allowing partial success when some\n   * files exist and others don't.\n   *\n   * @param paths - Array of file paths to download\n   * @returns Download result for each file, with content or error\n   *\n   * @example\n   * ```typescript\n   * const results = await sandbox.downloadFiles([\"src/index.js\", \"missing.txt\"]);\n   * for (const result of results) {\n   *   if (result.content) {\n   *     console.log(new TextDecoder().decode(result.content));\n   *   } else {\n   *     console.error(`Error: ${result.error}`);\n   *   }\n   * }\n   * ```\n   */\n  async downloadFiles(paths: string[]): Promise<FileDownloadResponse[]> {\n    const sandbox = this.instance; // Throws if not initialized\n    const results: FileDownloadResponse[] = [];\n\n    for (const path of paths) {\n      try {\n        const buffer = await sandbox.fs.downloadFile(path);\n        results.push({\n          path,\n          content: new Uint8Array(buffer),\n          error: null,\n        });\n      } catch (error) {\n        results.push({\n          path,\n          content: null,\n          error: this.#mapError(error),\n        });\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Close the sandbox and release all resources.\n   *\n   * After closing, the sandbox cannot be used again. The sandbox is deleted\n   * from Daytona's infrastructure.\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   await sandbox.execute(\"npm run build\");\n   * } finally {\n   *   await sandbox.close();\n   * }\n   * ```\n   */\n  async close(): Promise<void> {\n    if (this.#sandbox) {\n      try {\n        await this.#sandbox.delete();\n      } finally {\n        this.#sandbox = null;\n        this.#daytona = null;\n      }\n    }\n  }\n\n  /**\n   * Stop the sandbox without deleting it.\n   *\n   * The sandbox can be restarted later using `start()`.\n   *\n   * @example\n   * ```typescript\n   * await sandbox.stop();\n   * // Later...\n   * await sandbox.start();\n   * ```\n   */\n  async stop(): Promise<void> {\n    if (this.#sandbox) {\n      await this.#sandbox.stop();\n    }\n  }\n\n  /**\n   * Start a stopped sandbox.\n   *\n   * @param timeout - Maximum time to wait in seconds (default: 60)\n   *\n   * @example\n   * ```typescript\n   * await sandbox.start();\n   * console.log(\"Sandbox is now running\");\n   * ```\n   */\n  async start(timeout: number = 60): Promise<void> {\n    if (this.#sandbox) {\n      await this.#sandbox.start(timeout);\n    }\n  }\n\n  /**\n   * Forcefully terminate and delete the sandbox.\n   *\n   * Use this when you need to immediately stop the sandbox.\n   *\n   * @example\n   * ```typescript\n   * await sandbox.kill();\n   * ```\n   */\n  async kill(): Promise<void> {\n    await this.close();\n  }\n\n  /**\n   * Get the working directory path inside the sandbox.\n   *\n   * @returns The absolute path to the sandbox working directory\n   *\n   * @example\n   * ```typescript\n   * const workDir = await sandbox.getWorkDir();\n   * console.log(`Working directory: ${workDir}`);\n   * ```\n   */\n  async getWorkDir(): Promise<string> {\n    const sandbox = this.instance;\n    const workDir = await sandbox.getWorkDir();\n    return workDir ?? \"/home/daytona\";\n  }\n\n  /**\n   * Get the user's home directory path inside the sandbox.\n   *\n   * @returns The absolute path to the user's home directory\n   *\n   * @example\n   * ```typescript\n   * const homeDir = await sandbox.getUserHomeDir();\n   * console.log(`Home directory: ${homeDir}`);\n   * ```\n   */\n  async getUserHomeDir(): Promise<string> {\n    const sandbox = this.instance;\n    const homeDir = await sandbox.getUserHomeDir();\n    return homeDir ?? \"/home/daytona\";\n  }\n\n  /**\n   * Set the sandbox from an existing Daytona Sandbox instance.\n   * Used internally by the static `connect()` method.\n   */\n  #setFromExisting(\n    daytona: Daytona,\n    existingSandbox: Sandbox,\n    sandboxId: string,\n  ): void {\n    this.#daytona = daytona;\n    this.#sandbox = existingSandbox;\n    this.#id = sandboxId;\n  }\n\n  /**\n   * Map Daytona SDK errors to standardized FileOperationError codes.\n   *\n   * @param error - The error from the Daytona SDK\n   * @returns A standardized error code\n   */\n  #mapError(error: unknown): FileOperationError {\n    if (error instanceof Error) {\n      const msg = error.message.toLowerCase();\n\n      if (msg.includes(\"not found\") || msg.includes(\"enoent\")) {\n        return \"file_not_found\";\n      }\n      if (msg.includes(\"permission\") || msg.includes(\"eacces\")) {\n        return \"permission_denied\";\n      }\n      if (msg.includes(\"directory\") || msg.includes(\"eisdir\")) {\n        return \"is_directory\";\n      }\n    }\n\n    return \"invalid_path\";\n  }\n\n  /**\n   * Create and initialize a new DaytonaSandbox in one step.\n   *\n   * This is the recommended way to create a sandbox. It combines\n   * construction and initialization into a single async operation.\n   *\n   * @param options - Configuration options for the sandbox\n   * @returns An initialized and ready-to-use sandbox\n   *\n   * @example\n   * ```typescript\n   * const sandbox = await DaytonaSandbox.create({\n   *   language: \"typescript\",\n   *   cpu: 2,\n   *   memory: 4,\n   * });\n   * ```\n   */\n  static async create(\n    options?: DaytonaSandboxOptions,\n  ): Promise<DaytonaSandbox> {\n    const sandbox = new DaytonaSandbox(options);\n    await sandbox.initialize();\n    return sandbox;\n  }\n\n  /**\n   * Delete all sandboxes matching the given labels.\n   *\n   * This is useful for cleaning up stale sandboxes from previous test runs\n   * or CI pipelines that may not have shut down cleanly.\n   *\n   * @param labels - Label key-value pairs to filter sandboxes\n   * @param options - Optional auth configuration\n   * @returns The number of sandboxes that were deleted\n   *\n   * @example\n   * ```typescript\n   * // Clean up all integration-test sandboxes\n   * const deleted = await DaytonaSandbox.deleteAll({\n   *   purpose: \"integration-test\",\n   *   package: \"@langchain/daytona\",\n   * });\n   * console.log(`Deleted ${deleted} stale sandboxes`);\n   * ```\n   */\n  static async deleteAll(\n    labels: Record<string, string>,\n    options?: Pick<DaytonaSandboxOptions, \"auth\" | \"target\">,\n  ): Promise<number> {\n    let credentials: { apiKey: string; apiUrl: string; target?: string };\n    try {\n      credentials = getAuthCredentials(options?.auth, options?.target);\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        \"Failed to authenticate with Daytona. Check your API key configuration.\",\n        \"AUTHENTICATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n\n    const daytona = new Daytona({\n      apiKey: credentials.apiKey,\n      apiUrl: credentials.apiUrl,\n      target: credentials.target,\n    });\n\n    const { items } = await daytona.list(labels);\n\n    const results = await Promise.all(\n      items.map((sandbox) =>\n        daytona\n          .delete(sandbox)\n          .then(() => true)\n          .catch(() => false),\n      ),\n    );\n\n    return results.filter(Boolean).length;\n  }\n\n  /**\n   * Connect to an existing sandbox by ID.\n   *\n   * This allows you to resume working with a sandbox that was created\n   * earlier or that is still running.\n   *\n   * @param sandboxId - The ID of the sandbox to connect to\n   * @param options - Optional auth configuration (for API key)\n   * @returns A connected sandbox instance\n   *\n   * @example\n   * ```typescript\n   * // Resume a sandbox from a stored ID\n   * const sandbox = await DaytonaSandbox.connect(\"sandbox-abc123\");\n   * const result = await sandbox.execute(\"ls -la\");\n   * ```\n   */\n  static async fromId(\n    id: string,\n    options?: Pick<DaytonaSandboxOptions, \"auth\" | \"target\" | \"timeout\">,\n  ): Promise<DaytonaSandbox> {\n    // Get authentication credentials\n    let credentials: { apiKey: string; apiUrl: string; target?: string };\n    try {\n      credentials = getAuthCredentials(options?.auth, options?.target);\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        \"Failed to authenticate with Daytona. Check your API key configuration.\",\n        \"AUTHENTICATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n\n    try {\n      const daytona = new Daytona({\n        apiKey: credentials.apiKey,\n        apiUrl: credentials.apiUrl,\n        target: credentials.target,\n      });\n\n      const existingSandbox = await daytona.get(id);\n\n      const daytonaSandbox = new DaytonaSandbox(options);\n      // Set the existing sandbox directly (bypass initialize)\n      daytonaSandbox.#setFromExisting(daytona, existingSandbox, id);\n\n      return daytonaSandbox;\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        `Sandbox not found: ${id}`,\n        \"SANDBOX_NOT_FOUND\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Get a running sandbox by name from a deployed app.\n   *\n   * @param name - The name of the sandbox\n   * @param options - Optional auth configuration\n   * @returns A connected sandbox instance\n   */\n  static async fromName(\n    name: string,\n    options?: Pick<DaytonaSandboxOptions, \"auth\">,\n  ): Promise<DaytonaSandbox> {\n    return DaytonaSandbox.fromId(name, options);\n  }\n}\n\n/**\n * Async factory function type for creating Daytona Sandbox instances.\n *\n * This is similar to BackendFactory but supports async creation,\n * which is required for Daytona Sandbox since initialization is async.\n */\nexport type AsyncDaytonaSandboxFactory = () => Promise<DaytonaSandbox>;\n\n/**\n * Create an async factory function that creates a new Daytona Sandbox per invocation.\n *\n * Each call to the factory will create and initialize a new sandbox.\n * This is useful when you want fresh, isolated environments for each\n * agent invocation.\n *\n * **Important**: This returns an async factory. For use with middleware that\n * requires synchronous BackendFactory, use `createDaytonaSandboxFactoryFromSandbox()`\n * with a pre-created sandbox instead.\n *\n * @param options - Optional configuration for sandbox creation\n * @returns An async factory function that creates new sandboxes\n *\n * @example\n * ```typescript\n * import { DaytonaSandbox, createDaytonaSandboxFactory } from \"@langchain/daytona\";\n *\n * // Create a factory for new sandboxes\n * const factory = createDaytonaSandboxFactory({ language: \"typescript\" });\n *\n * // Each call creates a new sandbox\n * const sandbox1 = await factory();\n * const sandbox2 = await factory();\n *\n * try {\n *   // Use sandboxes...\n * } finally {\n *   await sandbox1.close();\n *   await sandbox2.close();\n * }\n * ```\n */\nexport function createDaytonaSandboxFactory(\n  options?: DaytonaSandboxOptions,\n): AsyncDaytonaSandboxFactory {\n  return async () => {\n    return await DaytonaSandbox.create(options);\n  };\n}\n\n/**\n * Create a backend factory that reuses an existing Daytona Sandbox.\n *\n * This allows multiple agent invocations to share the same sandbox,\n * avoiding the startup overhead of creating new sandboxes.\n *\n * Important: You are responsible for managing the sandbox lifecycle\n * (calling `close()` when done).\n *\n * @param sandbox - An existing DaytonaSandbox instance (must be initialized)\n * @returns A BackendFactory that returns the provided sandbox\n *\n * @example\n * ```typescript\n * import { createDeepAgent, createFilesystemMiddleware } from \"deepagents\";\n * import { DaytonaSandbox, createDaytonaSandboxFactoryFromSandbox } from \"@langchain/daytona\";\n *\n * // Create and initialize a sandbox\n * const sandbox = await DaytonaSandbox.create({ language: \"typescript\" });\n *\n * try {\n *   const agent = createDeepAgent({\n *     model: new ChatAnthropic({ model: \"claude-sonnet-4-20250514\" }),\n *     systemPrompt: \"You are a coding assistant.\",\n *     middlewares: [\n *       createFilesystemMiddleware({\n *         backend: createDaytonaSandboxFactoryFromSandbox(sandbox),\n *       }),\n *     ],\n *   });\n *\n *   await agent.invoke({ messages: [...] });\n * } finally {\n *   await sandbox.close();\n * }\n * ```\n */\nexport function createDaytonaSandboxFactoryFromSandbox(\n  sandbox: DaytonaSandbox,\n): BackendFactory {\n  return () => sandbox;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["SandboxError","BaseSandbox","#id","#sandbox","#daytona","#options","#timeout","Daytona","#uploadInitialFiles","#ensureParentDirectory","#mapError","#setFromExisting"],"sources":["../src/auth.ts","../src/types.ts","../src/sandbox.ts"],"sourcesContent":["/**\n * Authentication utilities for Daytona Sandbox.\n *\n * This module provides authentication credential resolution for the Daytona SDK.\n *\n * @packageDocumentation\n */\n\nimport type { DaytonaSandboxOptions } from \"./types.js\";\n\n/**\n * Authentication credentials for Daytona API.\n */\nexport interface DaytonaCredentials {\n  /** Daytona API key */\n  apiKey: string;\n\n  /** Daytona API URL */\n  apiUrl: string;\n\n  /** Target region */\n  target?: string;\n}\n\n/** Default Daytona API URL */\nconst DEFAULT_API_URL = \"https://app.daytona.io/api\";\n\n/**\n * Get the API key for Daytona API.\n *\n * Authentication is resolved in the following priority order:\n *\n * 1. **Explicit API key**: If `options.apiKey` is provided, it is used directly.\n * 2. **DAYTONA_API_KEY**: Environment variable for Daytona API key.\n *\n * If no API key is found, an error is thrown with setup instructions.\n *\n * ## Environment Variable Setup\n *\n * ```bash\n * # Get your API key from https://app.daytona.io\n * export DAYTONA_API_KEY=your_api_key_here\n * ```\n *\n * @param options - Optional authentication configuration from DaytonaSandboxOptions\n * @returns The API key string\n * @throws {Error} If no API key is available\n *\n * @example\n * ```typescript\n * // With explicit API key\n * const apiKey = getAuthApiKey({ apiKey: \"my-api-key\" });\n *\n * // Using environment variables (auto-detected)\n * const apiKey = getAuthApiKey();\n *\n * // From DaytonaSandboxOptions\n * const options: DaytonaSandboxOptions = {\n *   auth: { apiKey: \"my-api-key\" }\n * };\n * const apiKey = getAuthApiKey(options.auth);\n * ```\n */\nexport function getAuthApiKey(options?: DaytonaSandboxOptions[\"auth\"]): string {\n  // Priority 1: Explicit API key in options\n  if (options?.apiKey) {\n    return options.apiKey;\n  }\n\n  // Priority 2: DAYTONA_API_KEY environment variable\n  const apiKey = process.env.DAYTONA_API_KEY;\n  if (apiKey) {\n    return apiKey;\n  }\n\n  // No API key found - throw descriptive error\n  throw new Error(\n    \"Daytona authentication required. Provide an API key using one of these methods:\\n\\n\" +\n      \"1. Set DAYTONA_API_KEY environment variable:\\n\" +\n      \"   Get your API key from https://app.daytona.io\\n\" +\n      \"   Run: export DAYTONA_API_KEY=your_api_key_here\\n\\n\" +\n      \"2. Pass API key directly in options:\\n\" +\n      \"   new DaytonaSandbox({ auth: { apiKey: '...' } })\",\n  );\n}\n\n/**\n * Get the API URL for Daytona API.\n *\n * URL is resolved in the following priority order:\n *\n * 1. **Explicit API URL**: If `options.apiUrl` is provided, it is used directly.\n * 2. **DAYTONA_API_URL**: Environment variable for Daytona API URL.\n * 3. **Default**: Uses the default Daytona API URL.\n *\n * @param options - Optional authentication configuration from DaytonaSandboxOptions\n * @returns The API URL string\n */\nexport function getAuthApiUrl(options?: DaytonaSandboxOptions[\"auth\"]): string {\n  // Priority 1: Explicit API URL in options\n  if (options?.apiUrl) {\n    return options.apiUrl;\n  }\n\n  // Priority 2: DAYTONA_API_URL environment variable\n  const apiUrl = process.env.DAYTONA_API_URL;\n  if (apiUrl) {\n    return apiUrl;\n  }\n\n  // Priority 3: Default URL\n  return DEFAULT_API_URL;\n}\n\n/**\n * Get authentication credentials for Daytona API.\n *\n * This function returns the credentials needed for the Daytona SDK.\n *\n * @param options - Optional authentication configuration from DaytonaSandboxOptions\n * @param target - Optional target region\n * @returns Complete authentication credentials\n * @throws {Error} If no API key is available\n */\nexport function getAuthCredentials(\n  options?: DaytonaSandboxOptions[\"auth\"],\n  target?: string,\n): DaytonaCredentials {\n  return {\n    apiKey: getAuthApiKey(options),\n    apiUrl: getAuthApiUrl(options),\n    target: target ?? process.env.DAYTONA_TARGET,\n  };\n}\n","/**\n * Type definitions for the Daytona Sandbox backend.\n *\n * This module contains all type definitions for the @langchain/daytona package,\n * including options and error types.\n */\n\nimport { type SandboxErrorCode, SandboxError } from \"deepagents\";\n\n/**\n * Supported target regions for Daytona sandboxes.\n *\n * - `us`: United States\n * - `eu`: Europe\n */\nexport type DaytonaSandboxTarget = \"us\" | \"eu\";\n\n/**\n * Configuration options for creating a Daytona Sandbox.\n *\n * @example\n * ```typescript\n * const options: DaytonaSandboxOptions = {\n *   language: \"typescript\",\n *   timeout: 300, // 5 minutes\n *   target: \"us\",\n * };\n * ```\n */\nexport interface DaytonaSandboxOptions {\n  /**\n   * Primary language for code execution in the sandbox.\n   *\n   * Determines the runtime environment and code execution tooling.\n   *\n   * @default \"typescript\"\n   */\n  language?: \"typescript\" | \"python\" | \"javascript\";\n\n  /**\n   * Custom environment variables to set in the sandbox.\n   *\n   * These variables will be available to all commands and code executed\n   * in the sandbox.\n   *\n   * @example\n   * ```typescript\n   * envVars: {\n   *   NODE_ENV: \"development\",\n   *   API_KEY: \"secret\"\n   * }\n   * ```\n   */\n  envVars?: Record<string, string>;\n\n  /**\n   * Resource allocation for the sandbox.\n   *\n   * When specifying resources, you must also specify an `image`.\n   * Resources cannot be customized when using the default snapshot-based sandbox.\n   *\n   * @example\n   * ```typescript\n   * resources: { cpu: 2, memory: 4, disk: 20 }\n   * ```\n   */\n  resources?: {\n    /** Number of CPUs to allocate */\n    cpu?: number;\n    /** Amount of memory in GiB */\n    memory?: number;\n    /** Amount of disk space in GiB */\n    disk?: number;\n  };\n\n  /**\n   * Custom Docker image to use for the sandbox.\n   *\n   * When specified, creates a sandbox from this image instead of the default snapshot.\n   * This is required when you want to customize resources.\n   *\n   * @example \"node:20\" or \"python:3.12\"\n   */\n  image?: string;\n\n  /**\n   * Snapshot name to use for the sandbox.\n   *\n   * When specified, creates a sandbox from this snapshot.\n   * Cannot be used together with `image`.\n   */\n  snapshot?: string;\n\n  /**\n   * Target region where the sandbox will be created.\n   *\n   * @default \"us\"\n   */\n  target?: DaytonaSandboxTarget;\n\n  /**\n   * Auto-stop interval in minutes.\n   *\n   * The sandbox will automatically stop after being idle for this duration.\n   * Set to 0 to disable auto-stop.\n   *\n   * @default 15\n   */\n  autoStopInterval?: number;\n\n  /**\n   * Auto-archive interval in minutes.\n   *\n   * The sandbox will automatically archive after being stopped for this duration.\n   */\n  autoArchiveInterval?: number;\n\n  /**\n   * Auto-delete interval in minutes.\n   *\n   * The sandbox will automatically delete after being stopped for this duration.\n   */\n  autoDeleteInterval?: number;\n\n  /**\n   * Default timeout for command execution in seconds.\n   *\n   * @default 300 (5 minutes)\n   */\n  timeout?: number;\n\n  /**\n   * Custom labels to attach to the sandbox.\n   *\n   * Labels can be used for organizing and filtering sandboxes.\n   */\n  labels?: Record<string, string>;\n\n  /**\n   * Initial files to create in the sandbox after initialization.\n   *\n   * A map of file paths to their contents. Files will be created\n   * in the sandbox filesystem before any commands are executed.\n   * Parent directories are created automatically.\n   *\n   * @example\n   * ```typescript\n   * const options: DaytonaSandboxOptions = {\n   *   language: \"typescript\",\n   *   initialFiles: {\n   *     \"/app/index.js\": \"console.log('Hello')\",\n   *     \"/app/package.json\": '{\"name\": \"test\"}',\n   *   },\n   * };\n   * ```\n   */\n  initialFiles?: Record<string, string>;\n\n  /**\n   * Authentication configuration for Daytona API.\n   *\n   * ### Environment Variable Setup\n   *\n   * ```bash\n   * # Get your API key from https://app.daytona.io\n   * export DAYTONA_API_KEY=your_api_key_here\n   * ```\n   *\n   * Or pass the API key directly in this auth configuration.\n   */\n  auth?: {\n    /**\n     * Daytona API key.\n     * If not provided, reads from `DAYTONA_API_KEY` environment variable.\n     */\n    apiKey?: string;\n\n    /**\n     * Daytona API URL.\n     * If not provided, reads from `DAYTONA_API_URL` environment variable\n     * or uses the default Daytona API URL.\n     *\n     * @default \"https://app.daytona.io/api\"\n     */\n    apiUrl?: string;\n  };\n}\n\n/**\n * Error codes for Daytona Sandbox operations.\n *\n * Used to identify specific error conditions and handle them appropriately.\n */\nexport type DaytonaSandboxErrorCode =\n  | SandboxErrorCode\n  /** Authentication failed - check API key configuration */\n  | \"AUTHENTICATION_FAILED\"\n  /** Failed to create sandbox - check options and quotas */\n  | \"SANDBOX_CREATION_FAILED\"\n  /** Sandbox not found - may have been deleted or expired */\n  | \"SANDBOX_NOT_FOUND\"\n  /** Sandbox is not in started state */\n  | \"SANDBOX_NOT_STARTED\"\n  /** Resource limits exceeded (CPU, memory, storage) */\n  | \"RESOURCE_LIMIT_EXCEEDED\";\n\nconst DAYTONA_SANDBOX_ERROR_SYMBOL = Symbol.for(\"daytona.sandbox.error\");\n\n/**\n * Custom error class for Daytona Sandbox operations.\n *\n * Provides structured error information including:\n * - Human-readable message\n * - Error code for programmatic handling\n * - Original cause for debugging\n *\n * @example\n * ```typescript\n * try {\n *   await sandbox.execute(\"some command\");\n * } catch (error) {\n *   if (error instanceof DaytonaSandboxError) {\n *     switch (error.code) {\n *       case \"NOT_INITIALIZED\":\n *         await sandbox.initialize();\n *         break;\n *       case \"COMMAND_TIMEOUT\":\n *         console.error(\"Command took too long\");\n *         break;\n *       default:\n *         throw error;\n *     }\n *   }\n * }\n * ```\n */\nexport class DaytonaSandboxError extends SandboxError {\n  /** Symbol for identifying sandbox error instances */\n  [DAYTONA_SANDBOX_ERROR_SYMBOL] = true as const;\n\n  /** Error name for instanceof checks and logging */\n  override readonly name = \"DaytonaSandboxError\";\n\n  /**\n   * Creates a new DaytonaSandboxError.\n   *\n   * @param message - Human-readable error description\n   * @param code - Structured error code for programmatic handling\n   * @param cause - Original error that caused this error (for debugging)\n   */\n  constructor(\n    message: string,\n    public readonly code: DaytonaSandboxErrorCode,\n    public override readonly cause?: Error,\n  ) {\n    super(message, code as SandboxErrorCode, cause);\n    // Maintain proper prototype chain for instanceof checks\n    Object.setPrototypeOf(this, DaytonaSandboxError.prototype);\n  }\n\n  /**\n   * Checks if the error is an instance of DaytonaSandboxError.\n   *\n   * @param error - The error to check\n   * @returns True if the error is an instance of DaytonaSandboxError, false otherwise\n   */\n  static isInstance(error: unknown): error is DaytonaSandboxError {\n    return (\n      typeof error === \"object\" &&\n      error !== null &&\n      (error as Record<symbol, unknown>)[DAYTONA_SANDBOX_ERROR_SYMBOL] === true\n    );\n  }\n}\n","/* oxlint-disable no-instanceof/no-instanceof */\n/**\n * Daytona Sandbox implementation of the SandboxBackendProtocol.\n *\n * This module provides a Daytona Sandbox backend for deepagents, enabling agents\n * to execute commands, read/write files, and manage isolated sandbox environments\n * using Daytona's infrastructure.\n *\n * @packageDocumentation\n */\n\nimport { Daytona, type Sandbox } from \"@daytona/sdk\";\nimport {\n  BaseSandbox,\n  type ExecuteResponse,\n  type FileDownloadResponse,\n  type FileOperationError,\n  type FileUploadResponse,\n  type BackendFactory,\n} from \"deepagents\";\n\nimport { getAuthCredentials } from \"./auth.js\";\nimport { DaytonaSandboxError, type DaytonaSandboxOptions } from \"./types.js\";\n\nfunction shellQuote(value: string): string {\n  return `'${value.replace(/'/g, \"'\\\\''\")}'`;\n}\n\n/**\n * Daytona Sandbox backend for deepagents.\n *\n * Extends `BaseSandbox` to provide command execution, file operations, and\n * sandbox lifecycle management using Daytona's SDK.\n *\n * ## Basic Usage\n *\n * ```typescript\n * import { DaytonaSandbox } from \"@langchain/daytona\";\n *\n * // Create and initialize a sandbox\n * const sandbox = await DaytonaSandbox.create({\n *   language: \"typescript\",\n *   timeout: 300,\n * });\n *\n * try {\n *   // Execute commands\n *   const result = await sandbox.execute(\"node --version\");\n *   console.log(result.output);\n * } finally {\n *   // Always cleanup\n *   await sandbox.close();\n * }\n * ```\n *\n * ## Using with DeepAgent\n *\n * ```typescript\n * import { createDeepAgent } from \"deepagents\";\n * import { DaytonaSandbox } from \"@langchain/daytona\";\n *\n * const sandbox = await DaytonaSandbox.create();\n *\n * const agent = createDeepAgent({\n *   model: new ChatAnthropic({ model: \"claude-sonnet-4-20250514\" }),\n *   systemPrompt: \"You are a coding assistant with sandbox access.\",\n *   backend: sandbox,\n * });\n * ```\n */\nexport class DaytonaSandbox extends BaseSandbox {\n  /** Private reference to the Daytona client */\n  #daytona: Daytona | null = null;\n\n  /** Private reference to the underlying Daytona Sandbox instance */\n  #sandbox: Sandbox | null = null;\n\n  /** Configuration options for this sandbox */\n  #options: DaytonaSandboxOptions;\n\n  /** Unique identifier for this sandbox instance */\n  #id: string;\n\n  /** Default timeout for command execution in seconds */\n  #timeout: number;\n\n  /**\n   * Get the unique identifier for this sandbox.\n   *\n   * Before initialization, returns a temporary ID.\n   * After initialization, returns the actual Daytona sandbox ID.\n   */\n  get id(): string {\n    return this.#id;\n  }\n\n  /**\n   * Get the underlying Daytona Sandbox instance.\n   *\n   * @throws {DaytonaSandboxError} If the sandbox is not initialized\n   *\n   * @example\n   * ```typescript\n   * const sandbox = await DaytonaSandbox.create();\n   * const daytonaSdk = sandbox.sandbox; // Access the raw SDK\n   * ```\n   */\n  get instance(): Sandbox {\n    if (!this.#sandbox) {\n      throw new DaytonaSandboxError(\n        \"Sandbox not initialized. Call initialize() or use DaytonaSandbox.create()\",\n        \"NOT_INITIALIZED\",\n      );\n    }\n    return this.#sandbox;\n  }\n\n  /**\n   * Get the underlying Daytona client instance.\n   *\n   * @throws {DaytonaSandboxError} If the client is not initialized\n   *\n   * @example\n   * ```typescript\n   * const sandbox = await DaytonaSandbox.create();\n   * const daytonaClient = sandbox.client; // Access the raw Daytona client\n   * ```\n   */\n  get client(): Daytona {\n    if (!this.#daytona) {\n      throw new DaytonaSandboxError(\n        \"Daytona client not initialized. Call initialize() or use DaytonaSandbox.create()\",\n        \"NOT_INITIALIZED\",\n      );\n    }\n    return this.#daytona;\n  }\n\n  /**\n   * Check if the sandbox is initialized and running.\n   */\n  get isRunning(): boolean {\n    return this.#sandbox !== null;\n  }\n\n  /**\n   * Create a new DaytonaSandbox instance.\n   *\n   * Note: This only creates the instance. Call `initialize()` to actually\n   * create the Daytona Sandbox, or use the static `DaytonaSandbox.create()` method.\n   *\n   * @param options - Configuration options for the sandbox\n   *\n   * @example\n   * ```typescript\n   * // Two-step initialization\n   * const sandbox = new DaytonaSandbox({ language: \"typescript\" });\n   * await sandbox.initialize();\n   *\n   * // Or use the factory method\n   * const sandbox = await DaytonaSandbox.create({ language: \"typescript\" });\n   * ```\n   */\n  constructor(options: DaytonaSandboxOptions = {}) {\n    super();\n\n    // Set defaults\n    this.#options = {\n      language: \"typescript\",\n      timeout: 300,\n      ...options,\n    };\n\n    this.#timeout = this.#options.timeout ?? 300;\n\n    // Generate temporary ID until initialized\n    this.#id = `daytona-sandbox-${Date.now()}`;\n  }\n\n  /**\n   * Initialize the sandbox by creating a new Daytona Sandbox instance.\n   *\n   * This method authenticates with Daytona and provisions a new sandbox.\n   * After initialization, the `id` property will reflect the actual sandbox ID.\n   *\n   * @throws {DaytonaSandboxError} If already initialized (`ALREADY_INITIALIZED`)\n   * @throws {DaytonaSandboxError} If authentication fails (`AUTHENTICATION_FAILED`)\n   * @throws {DaytonaSandboxError} If sandbox creation fails (`SANDBOX_CREATION_FAILED`)\n   *\n   * @example\n   * ```typescript\n   * const sandbox = new DaytonaSandbox();\n   * await sandbox.initialize();\n   * console.log(`Sandbox ID: ${sandbox.id}`);\n   * ```\n   */\n  async initialize(): Promise<void> {\n    // Prevent double initialization\n    if (this.#sandbox) {\n      throw new DaytonaSandboxError(\n        \"Sandbox is already initialized. Each DaytonaSandbox instance can only be initialized once.\",\n        \"ALREADY_INITIALIZED\",\n      );\n    }\n\n    // Get authentication credentials\n    let credentials: { apiKey: string; apiUrl: string; target?: string };\n    try {\n      credentials = getAuthCredentials(\n        this.#options.auth,\n        this.#options.target,\n      );\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        \"Failed to authenticate with Daytona. Check your API key configuration.\",\n        \"AUTHENTICATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n\n    try {\n      // Create Daytona client\n      this.#daytona = new Daytona({\n        apiKey: credentials.apiKey,\n        apiUrl: credentials.apiUrl,\n        target: credentials.target,\n      });\n\n      // Determine if we're creating from image or snapshot\n      if (this.#options.image) {\n        // Create from image (allows custom resources)\n        const createOptions: {\n          image: string;\n          language?: string;\n          envVars?: Record<string, string>;\n          autoStopInterval?: number;\n          autoArchiveInterval?: number;\n          autoDeleteInterval?: number;\n          labels?: Record<string, string>;\n          resources?: { cpu?: number; memory?: number; disk?: number };\n        } = {\n          image: this.#options.image,\n          language: this.#options.language ?? \"typescript\",\n        };\n\n        if (this.#options.envVars) {\n          createOptions.envVars = this.#options.envVars;\n        }\n\n        if (this.#options.autoStopInterval !== undefined) {\n          createOptions.autoStopInterval = this.#options.autoStopInterval;\n        }\n\n        if (this.#options.autoArchiveInterval !== undefined) {\n          createOptions.autoArchiveInterval = this.#options.autoArchiveInterval;\n        }\n\n        if (this.#options.autoDeleteInterval !== undefined) {\n          createOptions.autoDeleteInterval = this.#options.autoDeleteInterval;\n        }\n\n        if (this.#options.labels) {\n          createOptions.labels = this.#options.labels;\n        }\n\n        if (this.#options.resources) {\n          createOptions.resources = this.#options.resources;\n        }\n\n        // Create the sandbox from image\n        this.#sandbox = await this.#daytona.create(createOptions);\n      } else {\n        // Create from snapshot (default, simpler approach)\n        const createOptions: {\n          language?: string;\n          snapshot?: string;\n          envVars?: Record<string, string>;\n          autoStopInterval?: number;\n          autoArchiveInterval?: number;\n          autoDeleteInterval?: number;\n          labels?: Record<string, string>;\n        } = {\n          language: this.#options.language ?? \"typescript\",\n        };\n\n        if (this.#options.snapshot) {\n          createOptions.snapshot = this.#options.snapshot;\n        }\n\n        if (this.#options.envVars) {\n          createOptions.envVars = this.#options.envVars;\n        }\n\n        if (this.#options.autoStopInterval !== undefined) {\n          createOptions.autoStopInterval = this.#options.autoStopInterval;\n        }\n\n        if (this.#options.autoArchiveInterval !== undefined) {\n          createOptions.autoArchiveInterval = this.#options.autoArchiveInterval;\n        }\n\n        if (this.#options.autoDeleteInterval !== undefined) {\n          createOptions.autoDeleteInterval = this.#options.autoDeleteInterval;\n        }\n\n        if (this.#options.labels) {\n          createOptions.labels = this.#options.labels;\n        }\n\n        // Create the sandbox from snapshot\n        this.#sandbox = await this.#daytona.create(createOptions);\n      }\n\n      // Update ID to the actual sandbox ID\n      this.#id = this.#sandbox.id;\n\n      // Upload initial files if provided\n      if (this.#options.initialFiles) {\n        await this.#uploadInitialFiles(this.#options.initialFiles);\n      }\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        `Failed to create Daytona Sandbox: ${error instanceof Error ? error.message : String(error)}`,\n        \"SANDBOX_CREATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Upload initial files to the sandbox.\n   *\n   * @param files - A map of file paths to their string contents\n   */\n  async #uploadInitialFiles(files: Record<string, string>): Promise<void> {\n    const encoder = new TextEncoder();\n    const fileEntries: Array<[string, Uint8Array]> = Object.entries(files).map(\n      ([path, content]) => [path, encoder.encode(content)],\n    );\n\n    const results = await this.uploadFiles(fileEntries);\n\n    // Check for any errors during upload\n    const errors = results.filter((r) => r.error !== null);\n    if (errors.length > 0) {\n      const errorPaths = errors.map((e) => `${e.path}: ${e.error}`).join(\", \");\n      throw new DaytonaSandboxError(\n        `Failed to upload initial files: ${errorPaths}`,\n        \"FILE_OPERATION_FAILED\",\n      );\n    }\n  }\n\n  /**\n   * Execute a command in the sandbox.\n   *\n   * Commands are run using the sandbox's shell.\n   *\n   * @param command - The shell command to execute\n   * @returns Execution result with output, exit code, and truncation flag\n   * @throws {DaytonaSandboxError} If the sandbox is not initialized\n   *\n   * @example\n   * ```typescript\n   * const result = await sandbox.execute(\"echo 'Hello World'\");\n   * console.log(result.output); // \"Hello World\\n\"\n   * console.log(result.exitCode); // 0\n   * ```\n   */\n  async execute(command: string): Promise<ExecuteResponse> {\n    const sandbox = this.instance; // Throws if not initialized\n\n    try {\n      const response = await sandbox.process.executeCommand(\n        command,\n        undefined,\n        undefined,\n        this.#timeout,\n      );\n\n      return {\n        output: response.result ?? \"\",\n        exitCode: response.exitCode ?? 0,\n        truncated: false,\n      };\n    } catch (error) {\n      // Check for timeout\n      if (error instanceof Error && error.message.includes(\"timeout\")) {\n        throw new DaytonaSandboxError(\n          `Command timed out: ${command}`,\n          \"COMMAND_TIMEOUT\",\n          error,\n        );\n      }\n\n      throw new DaytonaSandboxError(\n        `Command execution failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"COMMAND_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Upload files to the sandbox.\n   *\n   * Files are written to the sandbox filesystem. Parent directories are\n   * created automatically if they don't exist.\n   *\n   * @param files - Array of [path, content] tuples to upload\n   * @returns Upload result for each file, with success or error status\n   *\n   * @example\n   * ```typescript\n   * const encoder = new TextEncoder();\n   * const results = await sandbox.uploadFiles([\n   *   [\"src/index.js\", encoder.encode(\"console.log('Hello')\")],\n   *   [\"package.json\", encoder.encode('{\"name\": \"test\"}')],\n   * ]);\n   * ```\n   */\n  async uploadFiles(\n    files: Array<[string, Uint8Array]>,\n  ): Promise<FileUploadResponse[]> {\n    const sandbox = this.instance; // Throws if not initialized\n    const results: FileUploadResponse[] = [];\n\n    for (const [path, content] of files) {\n      try {\n        // Ensure parent directory exists\n        const parentDir = path.substring(0, path.lastIndexOf(\"/\"));\n        if (parentDir) {\n          await this.#ensureParentDirectory(parentDir);\n        }\n\n        // Upload the file content\n        const buffer = Buffer.from(content);\n        await sandbox.fs.uploadFile(buffer, path);\n        results.push({ path, error: null });\n      } catch (error) {\n        results.push({ path, error: this.#mapError(error) });\n      }\n    }\n\n    return results;\n  }\n\n  async #ensureParentDirectory(parentDir: string): Promise<void> {\n    const result = await this.execute(`mkdir -p ${shellQuote(parentDir)}`);\n    if (result.exitCode !== 0) {\n      throw new Error(`Failed to create parent directory: ${parentDir}`);\n    }\n  }\n\n  /**\n   * Download files from the sandbox.\n   *\n   * Each file is read individually, allowing partial success when some\n   * files exist and others don't.\n   *\n   * @param paths - Array of file paths to download\n   * @returns Download result for each file, with content or error\n   *\n   * @example\n   * ```typescript\n   * const results = await sandbox.downloadFiles([\"src/index.js\", \"missing.txt\"]);\n   * for (const result of results) {\n   *   if (result.content) {\n   *     console.log(new TextDecoder().decode(result.content));\n   *   } else {\n   *     console.error(`Error: ${result.error}`);\n   *   }\n   * }\n   * ```\n   */\n  async downloadFiles(paths: string[]): Promise<FileDownloadResponse[]> {\n    const sandbox = this.instance; // Throws if not initialized\n    const results: FileDownloadResponse[] = [];\n\n    for (const path of paths) {\n      try {\n        const buffer = await sandbox.fs.downloadFile(path);\n        results.push({\n          path,\n          content: new Uint8Array(buffer),\n          error: null,\n        });\n      } catch (error) {\n        results.push({\n          path,\n          content: null,\n          error: this.#mapError(error),\n        });\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Close the sandbox and release all resources.\n   *\n   * After closing, the sandbox cannot be used again. The sandbox is deleted\n   * from Daytona's infrastructure.\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   await sandbox.execute(\"npm run build\");\n   * } finally {\n   *   await sandbox.close();\n   * }\n   * ```\n   */\n  async close(): Promise<void> {\n    if (this.#sandbox) {\n      try {\n        await this.#sandbox.delete();\n      } finally {\n        this.#sandbox = null;\n        this.#daytona = null;\n      }\n    }\n  }\n\n  /**\n   * Stop the sandbox without deleting it.\n   *\n   * The sandbox can be restarted later using `start()`.\n   *\n   * @example\n   * ```typescript\n   * await sandbox.stop();\n   * // Later...\n   * await sandbox.start();\n   * ```\n   */\n  async stop(): Promise<void> {\n    if (this.#sandbox) {\n      await this.#sandbox.stop();\n    }\n  }\n\n  /**\n   * Start a stopped sandbox.\n   *\n   * @param timeout - Maximum time to wait in seconds (default: 60)\n   *\n   * @example\n   * ```typescript\n   * await sandbox.start();\n   * console.log(\"Sandbox is now running\");\n   * ```\n   */\n  async start(timeout: number = 60): Promise<void> {\n    if (this.#sandbox) {\n      await this.#sandbox.start(timeout);\n    }\n  }\n\n  /**\n   * Forcefully terminate and delete the sandbox.\n   *\n   * Use this when you need to immediately stop the sandbox.\n   *\n   * @example\n   * ```typescript\n   * await sandbox.kill();\n   * ```\n   */\n  async kill(): Promise<void> {\n    await this.close();\n  }\n\n  /**\n   * Get the working directory path inside the sandbox.\n   *\n   * @returns The absolute path to the sandbox working directory\n   *\n   * @example\n   * ```typescript\n   * const workDir = await sandbox.getWorkDir();\n   * console.log(`Working directory: ${workDir}`);\n   * ```\n   */\n  async getWorkDir(): Promise<string> {\n    const sandbox = this.instance;\n    const workDir = await sandbox.getWorkDir();\n    return workDir ?? \"/home/daytona\";\n  }\n\n  /**\n   * Get the user's home directory path inside the sandbox.\n   *\n   * @returns The absolute path to the user's home directory\n   *\n   * @example\n   * ```typescript\n   * const homeDir = await sandbox.getUserHomeDir();\n   * console.log(`Home directory: ${homeDir}`);\n   * ```\n   */\n  async getUserHomeDir(): Promise<string> {\n    const sandbox = this.instance;\n    const homeDir = await sandbox.getUserHomeDir();\n    return homeDir ?? \"/home/daytona\";\n  }\n\n  /**\n   * Set the sandbox from an existing Daytona Sandbox instance.\n   * Used internally by the static `connect()` method.\n   */\n  #setFromExisting(\n    daytona: Daytona,\n    existingSandbox: Sandbox,\n    sandboxId: string,\n  ): void {\n    this.#daytona = daytona;\n    this.#sandbox = existingSandbox;\n    this.#id = sandboxId;\n  }\n\n  /**\n   * Map Daytona SDK errors to standardized FileOperationError codes.\n   *\n   * @param error - The error from the Daytona SDK\n   * @returns A standardized error code\n   */\n  #mapError(error: unknown): FileOperationError {\n    if (error instanceof Error) {\n      const msg = error.message.toLowerCase();\n\n      if (msg.includes(\"not found\") || msg.includes(\"enoent\")) {\n        return \"file_not_found\";\n      }\n      if (msg.includes(\"permission\") || msg.includes(\"eacces\")) {\n        return \"permission_denied\";\n      }\n      if (msg.includes(\"directory\") || msg.includes(\"eisdir\")) {\n        return \"is_directory\";\n      }\n    }\n\n    return \"invalid_path\";\n  }\n\n  /**\n   * Create and initialize a new DaytonaSandbox in one step.\n   *\n   * This is the recommended way to create a sandbox. It combines\n   * construction and initialization into a single async operation.\n   *\n   * @param options - Configuration options for the sandbox\n   * @returns An initialized and ready-to-use sandbox\n   *\n   * @example\n   * ```typescript\n   * const sandbox = await DaytonaSandbox.create({\n   *   language: \"typescript\",\n   *   cpu: 2,\n   *   memory: 4,\n   * });\n   * ```\n   */\n  static async create(\n    options?: DaytonaSandboxOptions,\n  ): Promise<DaytonaSandbox> {\n    const sandbox = new DaytonaSandbox(options);\n    await sandbox.initialize();\n    return sandbox;\n  }\n\n  /**\n   * Delete all sandboxes matching the given labels.\n   *\n   * This is useful for cleaning up stale sandboxes from previous test runs\n   * or CI pipelines that may not have shut down cleanly.\n   *\n   * @param labels - Label key-value pairs to filter sandboxes\n   * @param options - Optional auth configuration\n   * @returns The number of sandboxes that were deleted\n   *\n   * @example\n   * ```typescript\n   * // Clean up all integration-test sandboxes\n   * const deleted = await DaytonaSandbox.deleteAll({\n   *   purpose: \"integration-test\",\n   *   package: \"@langchain/daytona\",\n   * });\n   * console.log(`Deleted ${deleted} stale sandboxes`);\n   * ```\n   */\n  static async deleteAll(\n    labels: Record<string, string>,\n    options?: Pick<DaytonaSandboxOptions, \"auth\" | \"target\">,\n  ): Promise<number> {\n    let credentials: { apiKey: string; apiUrl: string; target?: string };\n    try {\n      credentials = getAuthCredentials(options?.auth, options?.target);\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        \"Failed to authenticate with Daytona. Check your API key configuration.\",\n        \"AUTHENTICATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n\n    const daytona = new Daytona({\n      apiKey: credentials.apiKey,\n      apiUrl: credentials.apiUrl,\n      target: credentials.target,\n    });\n\n    const sandboxes: Sandbox[] = [];\n    for await (const sandbox of daytona.list({ labels })) {\n      sandboxes.push(sandbox);\n    }\n\n    const results = await Promise.all(\n      sandboxes.map((sandbox) =>\n        daytona\n          .delete(sandbox)\n          .then(() => true)\n          .catch(() => false),\n      ),\n    );\n\n    return results.filter(Boolean).length;\n  }\n\n  /**\n   * Connect to an existing sandbox by ID.\n   *\n   * This allows you to resume working with a sandbox that was created\n   * earlier or that is still running.\n   *\n   * @param sandboxId - The ID of the sandbox to connect to\n   * @param options - Optional auth configuration (for API key)\n   * @returns A connected sandbox instance\n   *\n   * @example\n   * ```typescript\n   * // Resume a sandbox from a stored ID\n   * const sandbox = await DaytonaSandbox.connect(\"sandbox-abc123\");\n   * const result = await sandbox.execute(\"ls -la\");\n   * ```\n   */\n  static async fromId(\n    id: string,\n    options?: Pick<DaytonaSandboxOptions, \"auth\" | \"target\" | \"timeout\">,\n  ): Promise<DaytonaSandbox> {\n    // Get authentication credentials\n    let credentials: { apiKey: string; apiUrl: string; target?: string };\n    try {\n      credentials = getAuthCredentials(options?.auth, options?.target);\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        \"Failed to authenticate with Daytona. Check your API key configuration.\",\n        \"AUTHENTICATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n\n    try {\n      const daytona = new Daytona({\n        apiKey: credentials.apiKey,\n        apiUrl: credentials.apiUrl,\n        target: credentials.target,\n      });\n\n      const existingSandbox = await daytona.get(id);\n\n      const daytonaSandbox = new DaytonaSandbox(options);\n      // Set the existing sandbox directly (bypass initialize)\n      daytonaSandbox.#setFromExisting(daytona, existingSandbox, id);\n\n      return daytonaSandbox;\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        `Sandbox not found: ${id}`,\n        \"SANDBOX_NOT_FOUND\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Get a running sandbox by name from a deployed app.\n   *\n   * @param name - The name of the sandbox\n   * @param options - Optional auth configuration\n   * @returns A connected sandbox instance\n   */\n  static async fromName(\n    name: string,\n    options?: Pick<DaytonaSandboxOptions, \"auth\">,\n  ): Promise<DaytonaSandbox> {\n    return DaytonaSandbox.fromId(name, options);\n  }\n}\n\n/**\n * Async factory function type for creating Daytona Sandbox instances.\n *\n * This is similar to BackendFactory but supports async creation,\n * which is required for Daytona Sandbox since initialization is async.\n */\nexport type AsyncDaytonaSandboxFactory = () => Promise<DaytonaSandbox>;\n\n/**\n * Create an async factory function that creates a new Daytona Sandbox per invocation.\n *\n * Each call to the factory will create and initialize a new sandbox.\n * This is useful when you want fresh, isolated environments for each\n * agent invocation.\n *\n * **Important**: This returns an async factory. For use with middleware that\n * requires synchronous BackendFactory, use `createDaytonaSandboxFactoryFromSandbox()`\n * with a pre-created sandbox instead.\n *\n * @param options - Optional configuration for sandbox creation\n * @returns An async factory function that creates new sandboxes\n *\n * @example\n * ```typescript\n * import { DaytonaSandbox, createDaytonaSandboxFactory } from \"@langchain/daytona\";\n *\n * // Create a factory for new sandboxes\n * const factory = createDaytonaSandboxFactory({ language: \"typescript\" });\n *\n * // Each call creates a new sandbox\n * const sandbox1 = await factory();\n * const sandbox2 = await factory();\n *\n * try {\n *   // Use sandboxes...\n * } finally {\n *   await sandbox1.close();\n *   await sandbox2.close();\n * }\n * ```\n */\nexport function createDaytonaSandboxFactory(\n  options?: DaytonaSandboxOptions,\n): AsyncDaytonaSandboxFactory {\n  return async () => {\n    return await DaytonaSandbox.create(options);\n  };\n}\n\n/**\n * Create a backend factory that reuses an existing Daytona Sandbox.\n *\n * This allows multiple agent invocations to share the same sandbox,\n * avoiding the startup overhead of creating new sandboxes.\n *\n * Important: You are responsible for managing the sandbox lifecycle\n * (calling `close()` when done).\n *\n * @param sandbox - An existing DaytonaSandbox instance (must be initialized)\n * @returns A BackendFactory that returns the provided sandbox\n *\n * @example\n * ```typescript\n * import { createDeepAgent, createFilesystemMiddleware } from \"deepagents\";\n * import { DaytonaSandbox, createDaytonaSandboxFactoryFromSandbox } from \"@langchain/daytona\";\n *\n * // Create and initialize a sandbox\n * const sandbox = await DaytonaSandbox.create({ language: \"typescript\" });\n *\n * try {\n *   const agent = createDeepAgent({\n *     model: new ChatAnthropic({ model: \"claude-sonnet-4-20250514\" }),\n *     systemPrompt: \"You are a coding assistant.\",\n *     middlewares: [\n *       createFilesystemMiddleware({\n *         backend: createDaytonaSandboxFactoryFromSandbox(sandbox),\n *       }),\n *     ],\n *   });\n *\n *   await agent.invoke({ messages: [...] });\n * } finally {\n *   await sandbox.close();\n * }\n * ```\n */\nexport function createDaytonaSandboxFactoryFromSandbox(\n  sandbox: DaytonaSandbox,\n): BackendFactory {\n  return () => sandbox;\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,6 +1,5 @@
-import { Daytona, Sandbox } from "@daytonaio/sdk";
+import { Daytona, Sandbox } from "@daytona/sdk";
 import { BackendFactory, BaseSandbox, ExecuteResponse, FileDownloadResponse, FileUploadResponse, SandboxError, SandboxErrorCode } from "deepagents";
-
 //#region src/types.d.ts
 /**
  * Supported target regions for Daytona sandboxes.
@@ -57,8 +56,11 @@ interface DaytonaSandboxOptions {
    * ```
    */
   resources?: {
-    /** Number of CPUs to allocate */cpu?: number; /** Amount of memory in GiB */
-    memory?: number; /** Amount of disk space in GiB */
+    /** Number of CPUs to allocate */
+    cpu?: number;
+    /** Amount of memory in GiB */
+    memory?: number;
+    /** Amount of disk space in GiB */
     disk?: number;
   };
   /**
@@ -168,7 +170,17 @@ interface DaytonaSandboxOptions {
  *
  * Used to identify specific error conditions and handle them appropriately.
  */
-type DaytonaSandboxErrorCode = SandboxErrorCode /** Authentication failed - check API key configuration */ | "AUTHENTICATION_FAILED" /** Failed to create sandbox - check options and quotas */ | "SANDBOX_CREATION_FAILED" /** Sandbox not found - may have been deleted or expired */ | "SANDBOX_NOT_FOUND" /** Sandbox is not in started state */ | "SANDBOX_NOT_STARTED" /** Resource limits exceeded (CPU, memory, storage) */ | "RESOURCE_LIMIT_EXCEEDED";
+type DaytonaSandboxErrorCode = SandboxErrorCode |
+/** Authentication failed - check API key configuration */
+"AUTHENTICATION_FAILED" |
+/** Failed to create sandbox - check options and quotas */
+"SANDBOX_CREATION_FAILED" |
+/** Sandbox not found - may have been deleted or expired */
+"SANDBOX_NOT_FOUND" |
+/** Sandbox is not in started state */
+"SANDBOX_NOT_STARTED" |
+/** Resource limits exceeded (CPU, memory, storage) */
+"RESOURCE_LIMIT_EXCEEDED";
 declare const DAYTONA_SANDBOX_ERROR_SYMBOL: unique symbol;
 /**
  * Custom error class for Daytona Sandbox operations.

package/dist/index.d.ts

@@ -1,6 +1,5 @@
-import { Daytona, Sandbox } from "@daytonaio/sdk";
+import { Daytona, Sandbox } from "@daytona/sdk";
 import { BackendFactory, BaseSandbox, ExecuteResponse, FileDownloadResponse, FileUploadResponse, SandboxError, SandboxErrorCode } from "deepagents";
-
 //#region src/types.d.ts
 /**
  * Supported target regions for Daytona sandboxes.
@@ -57,8 +56,11 @@ interface DaytonaSandboxOptions {
    * ```
    */
   resources?: {
-    /** Number of CPUs to allocate */cpu?: number; /** Amount of memory in GiB */
-    memory?: number; /** Amount of disk space in GiB */
+    /** Number of CPUs to allocate */
+    cpu?: number;
+    /** Amount of memory in GiB */
+    memory?: number;
+    /** Amount of disk space in GiB */
     disk?: number;
   };
   /**
@@ -168,7 +170,17 @@ interface DaytonaSandboxOptions {
  *
  * Used to identify specific error conditions and handle them appropriately.
  */
-type DaytonaSandboxErrorCode = SandboxErrorCode /** Authentication failed - check API key configuration */ | "AUTHENTICATION_FAILED" /** Failed to create sandbox - check options and quotas */ | "SANDBOX_CREATION_FAILED" /** Sandbox not found - may have been deleted or expired */ | "SANDBOX_NOT_FOUND" /** Sandbox is not in started state */ | "SANDBOX_NOT_STARTED" /** Resource limits exceeded (CPU, memory, storage) */ | "RESOURCE_LIMIT_EXCEEDED";
+type DaytonaSandboxErrorCode = SandboxErrorCode |
+/** Authentication failed - check API key configuration */
+"AUTHENTICATION_FAILED" |
+/** Failed to create sandbox - check options and quotas */
+"SANDBOX_CREATION_FAILED" |
+/** Sandbox not found - may have been deleted or expired */
+"SANDBOX_NOT_FOUND" |
+/** Sandbox is not in started state */
+"SANDBOX_NOT_STARTED" |
+/** Resource limits exceeded (CPU, memory, storage) */
+"RESOURCE_LIMIT_EXCEEDED";
 declare const DAYTONA_SANDBOX_ERROR_SYMBOL: unique symbol;
 /**
  * Custom error class for Daytona Sandbox operations.

package/dist/index.js

@@ -1,4 +1,4 @@
-import { Daytona } from "@daytonaio/sdk";
+import { Daytona } from "@daytona/sdk";
 import { BaseSandbox, SandboxError } from "deepagents";
 //#region src/auth.ts
 /** Default Daytona API URL */
@@ -118,6 +118,8 @@ const DAYTONA_SANDBOX_ERROR_SYMBOL = Symbol.for("daytona.sandbox.error");
 * ```
 */
 var DaytonaSandboxError = class DaytonaSandboxError extends SandboxError {
+	code;
+	cause;
 	/** Symbol for identifying sandbox error instances */
 	[DAYTONA_SANDBOX_ERROR_SYMBOL] = true;
 	/** Error name for instanceof checks and logging */
@@ -156,6 +158,9 @@ var DaytonaSandboxError = class DaytonaSandboxError extends SandboxError {
 *
 * @packageDocumentation
 */
+function shellQuote(value) {
+	return `'${value.replace(/'/g, "'\\''")}'`;
+}
 /**
 * Daytona Sandbox backend for deepagents.
 *
@@ -405,7 +410,7 @@ var DaytonaSandbox = class DaytonaSandbox extends BaseSandbox {
 		const results = [];
 		for (const [path, content] of files) try {
 			const parentDir = path.substring(0, path.lastIndexOf("/"));
-			if (parentDir) await sandbox.fs.createFolder(parentDir, "755");
+			if (parentDir) await this.#ensureParentDirectory(parentDir);
 			const buffer = Buffer.from(content);
 			await sandbox.fs.uploadFile(buffer, path);
 			results.push({
@@ -420,6 +425,9 @@ var DaytonaSandbox = class DaytonaSandbox extends BaseSandbox {
 		}
 		return results;
 	}
+	async #ensureParentDirectory(parentDir) {
+		if ((await this.execute(`mkdir -p ${shellQuote(parentDir)}`)).exitCode !== 0) throw new Error(`Failed to create parent directory: ${parentDir}`);
+	}
 	/**
 	* Download files from the sandbox.
 	*
@@ -632,8 +640,9 @@ var DaytonaSandbox = class DaytonaSandbox extends BaseSandbox {
 			apiUrl: credentials.apiUrl,
 			target: credentials.target
 		});
-		const { items } = await daytona.list(labels);
-		return (await Promise.all(items.map((sandbox) => daytona.delete(sandbox).then(() => true).catch(() => false)))).filter(Boolean).length;
+		const sandboxes = [];
+		for await (const sandbox of daytona.list({ labels })) sandboxes.push(sandbox);
+		return (await Promise.all(sandboxes.map((sandbox) => daytona.delete(sandbox).then(() => true).catch(() => false)))).filter(Boolean).length;
 	}
 	/**
 	* Connect to an existing sandbox by ID.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["#id","#sandbox","#daytona","#options","#timeout","#uploadInitialFiles","#mapError","#setFromExisting"],"sources":["../src/auth.ts","../src/types.ts","../src/sandbox.ts"],"sourcesContent":["/**\n * Authentication utilities for Daytona Sandbox.\n *\n * This module provides authentication credential resolution for the Daytona SDK.\n *\n * @packageDocumentation\n */\n\nimport type { DaytonaSandboxOptions } from \"./types.js\";\n\n/**\n * Authentication credentials for Daytona API.\n */\nexport interface DaytonaCredentials {\n  /** Daytona API key */\n  apiKey: string;\n\n  /** Daytona API URL */\n  apiUrl: string;\n\n  /** Target region */\n  target?: string;\n}\n\n/** Default Daytona API URL */\nconst DEFAULT_API_URL = \"https://app.daytona.io/api\";\n\n/**\n * Get the API key for Daytona API.\n *\n * Authentication is resolved in the following priority order:\n *\n * 1. **Explicit API key**: If `options.apiKey` is provided, it is used directly.\n * 2. **DAYTONA_API_KEY**: Environment variable for Daytona API key.\n *\n * If no API key is found, an error is thrown with setup instructions.\n *\n * ## Environment Variable Setup\n *\n * ```bash\n * # Get your API key from https://app.daytona.io\n * export DAYTONA_API_KEY=your_api_key_here\n * ```\n *\n * @param options - Optional authentication configuration from DaytonaSandboxOptions\n * @returns The API key string\n * @throws {Error} If no API key is available\n *\n * @example\n * ```typescript\n * // With explicit API key\n * const apiKey = getAuthApiKey({ apiKey: \"my-api-key\" });\n *\n * // Using environment variables (auto-detected)\n * const apiKey = getAuthApiKey();\n *\n * // From DaytonaSandboxOptions\n * const options: DaytonaSandboxOptions = {\n *   auth: { apiKey: \"my-api-key\" }\n * };\n * const apiKey = getAuthApiKey(options.auth);\n * ```\n */\nexport function getAuthApiKey(options?: DaytonaSandboxOptions[\"auth\"]): string {\n  // Priority 1: Explicit API key in options\n  if (options?.apiKey) {\n    return options.apiKey;\n  }\n\n  // Priority 2: DAYTONA_API_KEY environment variable\n  const apiKey = process.env.DAYTONA_API_KEY;\n  if (apiKey) {\n    return apiKey;\n  }\n\n  // No API key found - throw descriptive error\n  throw new Error(\n    \"Daytona authentication required. Provide an API key using one of these methods:\\n\\n\" +\n      \"1. Set DAYTONA_API_KEY environment variable:\\n\" +\n      \"   Get your API key from https://app.daytona.io\\n\" +\n      \"   Run: export DAYTONA_API_KEY=your_api_key_here\\n\\n\" +\n      \"2. Pass API key directly in options:\\n\" +\n      \"   new DaytonaSandbox({ auth: { apiKey: '...' } })\",\n  );\n}\n\n/**\n * Get the API URL for Daytona API.\n *\n * URL is resolved in the following priority order:\n *\n * 1. **Explicit API URL**: If `options.apiUrl` is provided, it is used directly.\n * 2. **DAYTONA_API_URL**: Environment variable for Daytona API URL.\n * 3. **Default**: Uses the default Daytona API URL.\n *\n * @param options - Optional authentication configuration from DaytonaSandboxOptions\n * @returns The API URL string\n */\nexport function getAuthApiUrl(options?: DaytonaSandboxOptions[\"auth\"]): string {\n  // Priority 1: Explicit API URL in options\n  if (options?.apiUrl) {\n    return options.apiUrl;\n  }\n\n  // Priority 2: DAYTONA_API_URL environment variable\n  const apiUrl = process.env.DAYTONA_API_URL;\n  if (apiUrl) {\n    return apiUrl;\n  }\n\n  // Priority 3: Default URL\n  return DEFAULT_API_URL;\n}\n\n/**\n * Get authentication credentials for Daytona API.\n *\n * This function returns the credentials needed for the Daytona SDK.\n *\n * @param options - Optional authentication configuration from DaytonaSandboxOptions\n * @param target - Optional target region\n * @returns Complete authentication credentials\n * @throws {Error} If no API key is available\n */\nexport function getAuthCredentials(\n  options?: DaytonaSandboxOptions[\"auth\"],\n  target?: string,\n): DaytonaCredentials {\n  return {\n    apiKey: getAuthApiKey(options),\n    apiUrl: getAuthApiUrl(options),\n    target: target ?? process.env.DAYTONA_TARGET,\n  };\n}\n","/**\n * Type definitions for the Daytona Sandbox backend.\n *\n * This module contains all type definitions for the @langchain/daytona package,\n * including options and error types.\n */\n\nimport { type SandboxErrorCode, SandboxError } from \"deepagents\";\n\n/**\n * Supported target regions for Daytona sandboxes.\n *\n * - `us`: United States\n * - `eu`: Europe\n */\nexport type DaytonaSandboxTarget = \"us\" | \"eu\";\n\n/**\n * Configuration options for creating a Daytona Sandbox.\n *\n * @example\n * ```typescript\n * const options: DaytonaSandboxOptions = {\n *   language: \"typescript\",\n *   timeout: 300, // 5 minutes\n *   target: \"us\",\n * };\n * ```\n */\nexport interface DaytonaSandboxOptions {\n  /**\n   * Primary language for code execution in the sandbox.\n   *\n   * Determines the runtime environment and code execution tooling.\n   *\n   * @default \"typescript\"\n   */\n  language?: \"typescript\" | \"python\" | \"javascript\";\n\n  /**\n   * Custom environment variables to set in the sandbox.\n   *\n   * These variables will be available to all commands and code executed\n   * in the sandbox.\n   *\n   * @example\n   * ```typescript\n   * envVars: {\n   *   NODE_ENV: \"development\",\n   *   API_KEY: \"secret\"\n   * }\n   * ```\n   */\n  envVars?: Record<string, string>;\n\n  /**\n   * Resource allocation for the sandbox.\n   *\n   * When specifying resources, you must also specify an `image`.\n   * Resources cannot be customized when using the default snapshot-based sandbox.\n   *\n   * @example\n   * ```typescript\n   * resources: { cpu: 2, memory: 4, disk: 20 }\n   * ```\n   */\n  resources?: {\n    /** Number of CPUs to allocate */\n    cpu?: number;\n    /** Amount of memory in GiB */\n    memory?: number;\n    /** Amount of disk space in GiB */\n    disk?: number;\n  };\n\n  /**\n   * Custom Docker image to use for the sandbox.\n   *\n   * When specified, creates a sandbox from this image instead of the default snapshot.\n   * This is required when you want to customize resources.\n   *\n   * @example \"node:20\" or \"python:3.12\"\n   */\n  image?: string;\n\n  /**\n   * Snapshot name to use for the sandbox.\n   *\n   * When specified, creates a sandbox from this snapshot.\n   * Cannot be used together with `image`.\n   */\n  snapshot?: string;\n\n  /**\n   * Target region where the sandbox will be created.\n   *\n   * @default \"us\"\n   */\n  target?: DaytonaSandboxTarget;\n\n  /**\n   * Auto-stop interval in minutes.\n   *\n   * The sandbox will automatically stop after being idle for this duration.\n   * Set to 0 to disable auto-stop.\n   *\n   * @default 15\n   */\n  autoStopInterval?: number;\n\n  /**\n   * Auto-archive interval in minutes.\n   *\n   * The sandbox will automatically archive after being stopped for this duration.\n   */\n  autoArchiveInterval?: number;\n\n  /**\n   * Auto-delete interval in minutes.\n   *\n   * The sandbox will automatically delete after being stopped for this duration.\n   */\n  autoDeleteInterval?: number;\n\n  /**\n   * Default timeout for command execution in seconds.\n   *\n   * @default 300 (5 minutes)\n   */\n  timeout?: number;\n\n  /**\n   * Custom labels to attach to the sandbox.\n   *\n   * Labels can be used for organizing and filtering sandboxes.\n   */\n  labels?: Record<string, string>;\n\n  /**\n   * Initial files to create in the sandbox after initialization.\n   *\n   * A map of file paths to their contents. Files will be created\n   * in the sandbox filesystem before any commands are executed.\n   * Parent directories are created automatically.\n   *\n   * @example\n   * ```typescript\n   * const options: DaytonaSandboxOptions = {\n   *   language: \"typescript\",\n   *   initialFiles: {\n   *     \"/app/index.js\": \"console.log('Hello')\",\n   *     \"/app/package.json\": '{\"name\": \"test\"}',\n   *   },\n   * };\n   * ```\n   */\n  initialFiles?: Record<string, string>;\n\n  /**\n   * Authentication configuration for Daytona API.\n   *\n   * ### Environment Variable Setup\n   *\n   * ```bash\n   * # Get your API key from https://app.daytona.io\n   * export DAYTONA_API_KEY=your_api_key_here\n   * ```\n   *\n   * Or pass the API key directly in this auth configuration.\n   */\n  auth?: {\n    /**\n     * Daytona API key.\n     * If not provided, reads from `DAYTONA_API_KEY` environment variable.\n     */\n    apiKey?: string;\n\n    /**\n     * Daytona API URL.\n     * If not provided, reads from `DAYTONA_API_URL` environment variable\n     * or uses the default Daytona API URL.\n     *\n     * @default \"https://app.daytona.io/api\"\n     */\n    apiUrl?: string;\n  };\n}\n\n/**\n * Error codes for Daytona Sandbox operations.\n *\n * Used to identify specific error conditions and handle them appropriately.\n */\nexport type DaytonaSandboxErrorCode =\n  | SandboxErrorCode\n  /** Authentication failed - check API key configuration */\n  | \"AUTHENTICATION_FAILED\"\n  /** Failed to create sandbox - check options and quotas */\n  | \"SANDBOX_CREATION_FAILED\"\n  /** Sandbox not found - may have been deleted or expired */\n  | \"SANDBOX_NOT_FOUND\"\n  /** Sandbox is not in started state */\n  | \"SANDBOX_NOT_STARTED\"\n  /** Resource limits exceeded (CPU, memory, storage) */\n  | \"RESOURCE_LIMIT_EXCEEDED\";\n\nconst DAYTONA_SANDBOX_ERROR_SYMBOL = Symbol.for(\"daytona.sandbox.error\");\n\n/**\n * Custom error class for Daytona Sandbox operations.\n *\n * Provides structured error information including:\n * - Human-readable message\n * - Error code for programmatic handling\n * - Original cause for debugging\n *\n * @example\n * ```typescript\n * try {\n *   await sandbox.execute(\"some command\");\n * } catch (error) {\n *   if (error instanceof DaytonaSandboxError) {\n *     switch (error.code) {\n *       case \"NOT_INITIALIZED\":\n *         await sandbox.initialize();\n *         break;\n *       case \"COMMAND_TIMEOUT\":\n *         console.error(\"Command took too long\");\n *         break;\n *       default:\n *         throw error;\n *     }\n *   }\n * }\n * ```\n */\nexport class DaytonaSandboxError extends SandboxError {\n  /** Symbol for identifying sandbox error instances */\n  [DAYTONA_SANDBOX_ERROR_SYMBOL] = true as const;\n\n  /** Error name for instanceof checks and logging */\n  override readonly name = \"DaytonaSandboxError\";\n\n  /**\n   * Creates a new DaytonaSandboxError.\n   *\n   * @param message - Human-readable error description\n   * @param code - Structured error code for programmatic handling\n   * @param cause - Original error that caused this error (for debugging)\n   */\n  constructor(\n    message: string,\n    public readonly code: DaytonaSandboxErrorCode,\n    public override readonly cause?: Error,\n  ) {\n    super(message, code as SandboxErrorCode, cause);\n    // Maintain proper prototype chain for instanceof checks\n    Object.setPrototypeOf(this, DaytonaSandboxError.prototype);\n  }\n\n  /**\n   * Checks if the error is an instance of DaytonaSandboxError.\n   *\n   * @param error - The error to check\n   * @returns True if the error is an instance of DaytonaSandboxError, false otherwise\n   */\n  static isInstance(error: unknown): error is DaytonaSandboxError {\n    return (\n      typeof error === \"object\" &&\n      error !== null &&\n      (error as Record<symbol, unknown>)[DAYTONA_SANDBOX_ERROR_SYMBOL] === true\n    );\n  }\n}\n","/* eslint-disable no-instanceof/no-instanceof */\n/**\n * Daytona Sandbox implementation of the SandboxBackendProtocol.\n *\n * This module provides a Daytona Sandbox backend for deepagents, enabling agents\n * to execute commands, read/write files, and manage isolated sandbox environments\n * using Daytona's infrastructure.\n *\n * @packageDocumentation\n */\n\nimport { Daytona, type Sandbox } from \"@daytonaio/sdk\";\nimport {\n  BaseSandbox,\n  type ExecuteResponse,\n  type FileDownloadResponse,\n  type FileOperationError,\n  type FileUploadResponse,\n  type BackendFactory,\n} from \"deepagents\";\n\nimport { getAuthCredentials } from \"./auth.js\";\nimport { DaytonaSandboxError, type DaytonaSandboxOptions } from \"./types.js\";\n\n/**\n * Daytona Sandbox backend for deepagents.\n *\n * Extends `BaseSandbox` to provide command execution, file operations, and\n * sandbox lifecycle management using Daytona's SDK.\n *\n * ## Basic Usage\n *\n * ```typescript\n * import { DaytonaSandbox } from \"@langchain/daytona\";\n *\n * // Create and initialize a sandbox\n * const sandbox = await DaytonaSandbox.create({\n *   language: \"typescript\",\n *   timeout: 300,\n * });\n *\n * try {\n *   // Execute commands\n *   const result = await sandbox.execute(\"node --version\");\n *   console.log(result.output);\n * } finally {\n *   // Always cleanup\n *   await sandbox.close();\n * }\n * ```\n *\n * ## Using with DeepAgent\n *\n * ```typescript\n * import { createDeepAgent } from \"deepagents\";\n * import { DaytonaSandbox } from \"@langchain/daytona\";\n *\n * const sandbox = await DaytonaSandbox.create();\n *\n * const agent = createDeepAgent({\n *   model: new ChatAnthropic({ model: \"claude-sonnet-4-20250514\" }),\n *   systemPrompt: \"You are a coding assistant with sandbox access.\",\n *   backend: sandbox,\n * });\n * ```\n */\nexport class DaytonaSandbox extends BaseSandbox {\n  /** Private reference to the Daytona client */\n  #daytona: Daytona | null = null;\n\n  /** Private reference to the underlying Daytona Sandbox instance */\n  #sandbox: Sandbox | null = null;\n\n  /** Configuration options for this sandbox */\n  #options: DaytonaSandboxOptions;\n\n  /** Unique identifier for this sandbox instance */\n  #id: string;\n\n  /** Default timeout for command execution in seconds */\n  #timeout: number;\n\n  /**\n   * Get the unique identifier for this sandbox.\n   *\n   * Before initialization, returns a temporary ID.\n   * After initialization, returns the actual Daytona sandbox ID.\n   */\n  get id(): string {\n    return this.#id;\n  }\n\n  /**\n   * Get the underlying Daytona Sandbox instance.\n   *\n   * @throws {DaytonaSandboxError} If the sandbox is not initialized\n   *\n   * @example\n   * ```typescript\n   * const sandbox = await DaytonaSandbox.create();\n   * const daytonaSdk = sandbox.sandbox; // Access the raw SDK\n   * ```\n   */\n  get instance(): Sandbox {\n    if (!this.#sandbox) {\n      throw new DaytonaSandboxError(\n        \"Sandbox not initialized. Call initialize() or use DaytonaSandbox.create()\",\n        \"NOT_INITIALIZED\",\n      );\n    }\n    return this.#sandbox;\n  }\n\n  /**\n   * Get the underlying Daytona client instance.\n   *\n   * @throws {DaytonaSandboxError} If the client is not initialized\n   *\n   * @example\n   * ```typescript\n   * const sandbox = await DaytonaSandbox.create();\n   * const daytonaClient = sandbox.client; // Access the raw Daytona client\n   * ```\n   */\n  get client(): Daytona {\n    if (!this.#daytona) {\n      throw new DaytonaSandboxError(\n        \"Daytona client not initialized. Call initialize() or use DaytonaSandbox.create()\",\n        \"NOT_INITIALIZED\",\n      );\n    }\n    return this.#daytona;\n  }\n\n  /**\n   * Check if the sandbox is initialized and running.\n   */\n  get isRunning(): boolean {\n    return this.#sandbox !== null;\n  }\n\n  /**\n   * Create a new DaytonaSandbox instance.\n   *\n   * Note: This only creates the instance. Call `initialize()` to actually\n   * create the Daytona Sandbox, or use the static `DaytonaSandbox.create()` method.\n   *\n   * @param options - Configuration options for the sandbox\n   *\n   * @example\n   * ```typescript\n   * // Two-step initialization\n   * const sandbox = new DaytonaSandbox({ language: \"typescript\" });\n   * await sandbox.initialize();\n   *\n   * // Or use the factory method\n   * const sandbox = await DaytonaSandbox.create({ language: \"typescript\" });\n   * ```\n   */\n  constructor(options: DaytonaSandboxOptions = {}) {\n    super();\n\n    // Set defaults\n    this.#options = {\n      language: \"typescript\",\n      timeout: 300,\n      ...options,\n    };\n\n    this.#timeout = this.#options.timeout ?? 300;\n\n    // Generate temporary ID until initialized\n    this.#id = `daytona-sandbox-${Date.now()}`;\n  }\n\n  /**\n   * Initialize the sandbox by creating a new Daytona Sandbox instance.\n   *\n   * This method authenticates with Daytona and provisions a new sandbox.\n   * After initialization, the `id` property will reflect the actual sandbox ID.\n   *\n   * @throws {DaytonaSandboxError} If already initialized (`ALREADY_INITIALIZED`)\n   * @throws {DaytonaSandboxError} If authentication fails (`AUTHENTICATION_FAILED`)\n   * @throws {DaytonaSandboxError} If sandbox creation fails (`SANDBOX_CREATION_FAILED`)\n   *\n   * @example\n   * ```typescript\n   * const sandbox = new DaytonaSandbox();\n   * await sandbox.initialize();\n   * console.log(`Sandbox ID: ${sandbox.id}`);\n   * ```\n   */\n  async initialize(): Promise<void> {\n    // Prevent double initialization\n    if (this.#sandbox) {\n      throw new DaytonaSandboxError(\n        \"Sandbox is already initialized. Each DaytonaSandbox instance can only be initialized once.\",\n        \"ALREADY_INITIALIZED\",\n      );\n    }\n\n    // Get authentication credentials\n    let credentials: { apiKey: string; apiUrl: string; target?: string };\n    try {\n      credentials = getAuthCredentials(\n        this.#options.auth,\n        this.#options.target,\n      );\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        \"Failed to authenticate with Daytona. Check your API key configuration.\",\n        \"AUTHENTICATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n\n    try {\n      // Create Daytona client\n      this.#daytona = new Daytona({\n        apiKey: credentials.apiKey,\n        apiUrl: credentials.apiUrl,\n        target: credentials.target,\n      });\n\n      // Determine if we're creating from image or snapshot\n      if (this.#options.image) {\n        // Create from image (allows custom resources)\n        const createOptions: {\n          image: string;\n          language?: string;\n          envVars?: Record<string, string>;\n          autoStopInterval?: number;\n          autoArchiveInterval?: number;\n          autoDeleteInterval?: number;\n          labels?: Record<string, string>;\n          resources?: { cpu?: number; memory?: number; disk?: number };\n        } = {\n          image: this.#options.image,\n          language: this.#options.language ?? \"typescript\",\n        };\n\n        if (this.#options.envVars) {\n          createOptions.envVars = this.#options.envVars;\n        }\n\n        if (this.#options.autoStopInterval !== undefined) {\n          createOptions.autoStopInterval = this.#options.autoStopInterval;\n        }\n\n        if (this.#options.autoArchiveInterval !== undefined) {\n          createOptions.autoArchiveInterval = this.#options.autoArchiveInterval;\n        }\n\n        if (this.#options.autoDeleteInterval !== undefined) {\n          createOptions.autoDeleteInterval = this.#options.autoDeleteInterval;\n        }\n\n        if (this.#options.labels) {\n          createOptions.labels = this.#options.labels;\n        }\n\n        if (this.#options.resources) {\n          createOptions.resources = this.#options.resources;\n        }\n\n        // Create the sandbox from image\n        this.#sandbox = await this.#daytona.create(createOptions);\n      } else {\n        // Create from snapshot (default, simpler approach)\n        const createOptions: {\n          language?: string;\n          snapshot?: string;\n          envVars?: Record<string, string>;\n          autoStopInterval?: number;\n          autoArchiveInterval?: number;\n          autoDeleteInterval?: number;\n          labels?: Record<string, string>;\n        } = {\n          language: this.#options.language ?? \"typescript\",\n        };\n\n        if (this.#options.snapshot) {\n          createOptions.snapshot = this.#options.snapshot;\n        }\n\n        if (this.#options.envVars) {\n          createOptions.envVars = this.#options.envVars;\n        }\n\n        if (this.#options.autoStopInterval !== undefined) {\n          createOptions.autoStopInterval = this.#options.autoStopInterval;\n        }\n\n        if (this.#options.autoArchiveInterval !== undefined) {\n          createOptions.autoArchiveInterval = this.#options.autoArchiveInterval;\n        }\n\n        if (this.#options.autoDeleteInterval !== undefined) {\n          createOptions.autoDeleteInterval = this.#options.autoDeleteInterval;\n        }\n\n        if (this.#options.labels) {\n          createOptions.labels = this.#options.labels;\n        }\n\n        // Create the sandbox from snapshot\n        this.#sandbox = await this.#daytona.create(createOptions);\n      }\n\n      // Update ID to the actual sandbox ID\n      this.#id = this.#sandbox.id;\n\n      // Upload initial files if provided\n      if (this.#options.initialFiles) {\n        await this.#uploadInitialFiles(this.#options.initialFiles);\n      }\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        `Failed to create Daytona Sandbox: ${error instanceof Error ? error.message : String(error)}`,\n        \"SANDBOX_CREATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Upload initial files to the sandbox.\n   *\n   * @param files - A map of file paths to their string contents\n   */\n  async #uploadInitialFiles(files: Record<string, string>): Promise<void> {\n    const encoder = new TextEncoder();\n    const fileEntries: Array<[string, Uint8Array]> = Object.entries(files).map(\n      ([path, content]) => [path, encoder.encode(content)],\n    );\n\n    const results = await this.uploadFiles(fileEntries);\n\n    // Check for any errors during upload\n    const errors = results.filter((r) => r.error !== null);\n    if (errors.length > 0) {\n      const errorPaths = errors.map((e) => `${e.path}: ${e.error}`).join(\", \");\n      throw new DaytonaSandboxError(\n        `Failed to upload initial files: ${errorPaths}`,\n        \"FILE_OPERATION_FAILED\",\n      );\n    }\n  }\n\n  /**\n   * Execute a command in the sandbox.\n   *\n   * Commands are run using the sandbox's shell.\n   *\n   * @param command - The shell command to execute\n   * @returns Execution result with output, exit code, and truncation flag\n   * @throws {DaytonaSandboxError} If the sandbox is not initialized\n   *\n   * @example\n   * ```typescript\n   * const result = await sandbox.execute(\"echo 'Hello World'\");\n   * console.log(result.output); // \"Hello World\\n\"\n   * console.log(result.exitCode); // 0\n   * ```\n   */\n  async execute(command: string): Promise<ExecuteResponse> {\n    const sandbox = this.instance; // Throws if not initialized\n\n    try {\n      const response = await sandbox.process.executeCommand(\n        command,\n        undefined,\n        undefined,\n        this.#timeout,\n      );\n\n      return {\n        output: response.result ?? \"\",\n        exitCode: response.exitCode ?? 0,\n        truncated: false,\n      };\n    } catch (error) {\n      // Check for timeout\n      if (error instanceof Error && error.message.includes(\"timeout\")) {\n        throw new DaytonaSandboxError(\n          `Command timed out: ${command}`,\n          \"COMMAND_TIMEOUT\",\n          error,\n        );\n      }\n\n      throw new DaytonaSandboxError(\n        `Command execution failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"COMMAND_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Upload files to the sandbox.\n   *\n   * Files are written to the sandbox filesystem. Parent directories are\n   * created automatically if they don't exist.\n   *\n   * @param files - Array of [path, content] tuples to upload\n   * @returns Upload result for each file, with success or error status\n   *\n   * @example\n   * ```typescript\n   * const encoder = new TextEncoder();\n   * const results = await sandbox.uploadFiles([\n   *   [\"src/index.js\", encoder.encode(\"console.log('Hello')\")],\n   *   [\"package.json\", encoder.encode('{\"name\": \"test\"}')],\n   * ]);\n   * ```\n   */\n  async uploadFiles(\n    files: Array<[string, Uint8Array]>,\n  ): Promise<FileUploadResponse[]> {\n    const sandbox = this.instance; // Throws if not initialized\n    const results: FileUploadResponse[] = [];\n\n    for (const [path, content] of files) {\n      try {\n        // Ensure parent directory exists\n        const parentDir = path.substring(0, path.lastIndexOf(\"/\"));\n        if (parentDir) {\n          await sandbox.fs.createFolder(parentDir, \"755\");\n        }\n\n        // Upload the file content\n        const buffer = Buffer.from(content);\n        await sandbox.fs.uploadFile(buffer, path);\n        results.push({ path, error: null });\n      } catch (error) {\n        results.push({ path, error: this.#mapError(error) });\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Download files from the sandbox.\n   *\n   * Each file is read individually, allowing partial success when some\n   * files exist and others don't.\n   *\n   * @param paths - Array of file paths to download\n   * @returns Download result for each file, with content or error\n   *\n   * @example\n   * ```typescript\n   * const results = await sandbox.downloadFiles([\"src/index.js\", \"missing.txt\"]);\n   * for (const result of results) {\n   *   if (result.content) {\n   *     console.log(new TextDecoder().decode(result.content));\n   *   } else {\n   *     console.error(`Error: ${result.error}`);\n   *   }\n   * }\n   * ```\n   */\n  async downloadFiles(paths: string[]): Promise<FileDownloadResponse[]> {\n    const sandbox = this.instance; // Throws if not initialized\n    const results: FileDownloadResponse[] = [];\n\n    for (const path of paths) {\n      try {\n        const buffer = await sandbox.fs.downloadFile(path);\n        results.push({\n          path,\n          content: new Uint8Array(buffer),\n          error: null,\n        });\n      } catch (error) {\n        results.push({\n          path,\n          content: null,\n          error: this.#mapError(error),\n        });\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Close the sandbox and release all resources.\n   *\n   * After closing, the sandbox cannot be used again. The sandbox is deleted\n   * from Daytona's infrastructure.\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   await sandbox.execute(\"npm run build\");\n   * } finally {\n   *   await sandbox.close();\n   * }\n   * ```\n   */\n  async close(): Promise<void> {\n    if (this.#sandbox) {\n      try {\n        await this.#sandbox.delete();\n      } finally {\n        this.#sandbox = null;\n        this.#daytona = null;\n      }\n    }\n  }\n\n  /**\n   * Stop the sandbox without deleting it.\n   *\n   * The sandbox can be restarted later using `start()`.\n   *\n   * @example\n   * ```typescript\n   * await sandbox.stop();\n   * // Later...\n   * await sandbox.start();\n   * ```\n   */\n  async stop(): Promise<void> {\n    if (this.#sandbox) {\n      await this.#sandbox.stop();\n    }\n  }\n\n  /**\n   * Start a stopped sandbox.\n   *\n   * @param timeout - Maximum time to wait in seconds (default: 60)\n   *\n   * @example\n   * ```typescript\n   * await sandbox.start();\n   * console.log(\"Sandbox is now running\");\n   * ```\n   */\n  async start(timeout: number = 60): Promise<void> {\n    if (this.#sandbox) {\n      await this.#sandbox.start(timeout);\n    }\n  }\n\n  /**\n   * Forcefully terminate and delete the sandbox.\n   *\n   * Use this when you need to immediately stop the sandbox.\n   *\n   * @example\n   * ```typescript\n   * await sandbox.kill();\n   * ```\n   */\n  async kill(): Promise<void> {\n    await this.close();\n  }\n\n  /**\n   * Get the working directory path inside the sandbox.\n   *\n   * @returns The absolute path to the sandbox working directory\n   *\n   * @example\n   * ```typescript\n   * const workDir = await sandbox.getWorkDir();\n   * console.log(`Working directory: ${workDir}`);\n   * ```\n   */\n  async getWorkDir(): Promise<string> {\n    const sandbox = this.instance;\n    const workDir = await sandbox.getWorkDir();\n    return workDir ?? \"/home/daytona\";\n  }\n\n  /**\n   * Get the user's home directory path inside the sandbox.\n   *\n   * @returns The absolute path to the user's home directory\n   *\n   * @example\n   * ```typescript\n   * const homeDir = await sandbox.getUserHomeDir();\n   * console.log(`Home directory: ${homeDir}`);\n   * ```\n   */\n  async getUserHomeDir(): Promise<string> {\n    const sandbox = this.instance;\n    const homeDir = await sandbox.getUserHomeDir();\n    return homeDir ?? \"/home/daytona\";\n  }\n\n  /**\n   * Set the sandbox from an existing Daytona Sandbox instance.\n   * Used internally by the static `connect()` method.\n   */\n  #setFromExisting(\n    daytona: Daytona,\n    existingSandbox: Sandbox,\n    sandboxId: string,\n  ): void {\n    this.#daytona = daytona;\n    this.#sandbox = existingSandbox;\n    this.#id = sandboxId;\n  }\n\n  /**\n   * Map Daytona SDK errors to standardized FileOperationError codes.\n   *\n   * @param error - The error from the Daytona SDK\n   * @returns A standardized error code\n   */\n  #mapError(error: unknown): FileOperationError {\n    if (error instanceof Error) {\n      const msg = error.message.toLowerCase();\n\n      if (msg.includes(\"not found\") || msg.includes(\"enoent\")) {\n        return \"file_not_found\";\n      }\n      if (msg.includes(\"permission\") || msg.includes(\"eacces\")) {\n        return \"permission_denied\";\n      }\n      if (msg.includes(\"directory\") || msg.includes(\"eisdir\")) {\n        return \"is_directory\";\n      }\n    }\n\n    return \"invalid_path\";\n  }\n\n  /**\n   * Create and initialize a new DaytonaSandbox in one step.\n   *\n   * This is the recommended way to create a sandbox. It combines\n   * construction and initialization into a single async operation.\n   *\n   * @param options - Configuration options for the sandbox\n   * @returns An initialized and ready-to-use sandbox\n   *\n   * @example\n   * ```typescript\n   * const sandbox = await DaytonaSandbox.create({\n   *   language: \"typescript\",\n   *   cpu: 2,\n   *   memory: 4,\n   * });\n   * ```\n   */\n  static async create(\n    options?: DaytonaSandboxOptions,\n  ): Promise<DaytonaSandbox> {\n    const sandbox = new DaytonaSandbox(options);\n    await sandbox.initialize();\n    return sandbox;\n  }\n\n  /**\n   * Delete all sandboxes matching the given labels.\n   *\n   * This is useful for cleaning up stale sandboxes from previous test runs\n   * or CI pipelines that may not have shut down cleanly.\n   *\n   * @param labels - Label key-value pairs to filter sandboxes\n   * @param options - Optional auth configuration\n   * @returns The number of sandboxes that were deleted\n   *\n   * @example\n   * ```typescript\n   * // Clean up all integration-test sandboxes\n   * const deleted = await DaytonaSandbox.deleteAll({\n   *   purpose: \"integration-test\",\n   *   package: \"@langchain/daytona\",\n   * });\n   * console.log(`Deleted ${deleted} stale sandboxes`);\n   * ```\n   */\n  static async deleteAll(\n    labels: Record<string, string>,\n    options?: Pick<DaytonaSandboxOptions, \"auth\" | \"target\">,\n  ): Promise<number> {\n    let credentials: { apiKey: string; apiUrl: string; target?: string };\n    try {\n      credentials = getAuthCredentials(options?.auth, options?.target);\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        \"Failed to authenticate with Daytona. Check your API key configuration.\",\n        \"AUTHENTICATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n\n    const daytona = new Daytona({\n      apiKey: credentials.apiKey,\n      apiUrl: credentials.apiUrl,\n      target: credentials.target,\n    });\n\n    const { items } = await daytona.list(labels);\n\n    const results = await Promise.all(\n      items.map((sandbox) =>\n        daytona\n          .delete(sandbox)\n          .then(() => true)\n          .catch(() => false),\n      ),\n    );\n\n    return results.filter(Boolean).length;\n  }\n\n  /**\n   * Connect to an existing sandbox by ID.\n   *\n   * This allows you to resume working with a sandbox that was created\n   * earlier or that is still running.\n   *\n   * @param sandboxId - The ID of the sandbox to connect to\n   * @param options - Optional auth configuration (for API key)\n   * @returns A connected sandbox instance\n   *\n   * @example\n   * ```typescript\n   * // Resume a sandbox from a stored ID\n   * const sandbox = await DaytonaSandbox.connect(\"sandbox-abc123\");\n   * const result = await sandbox.execute(\"ls -la\");\n   * ```\n   */\n  static async fromId(\n    id: string,\n    options?: Pick<DaytonaSandboxOptions, \"auth\" | \"target\" | \"timeout\">,\n  ): Promise<DaytonaSandbox> {\n    // Get authentication credentials\n    let credentials: { apiKey: string; apiUrl: string; target?: string };\n    try {\n      credentials = getAuthCredentials(options?.auth, options?.target);\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        \"Failed to authenticate with Daytona. Check your API key configuration.\",\n        \"AUTHENTICATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n\n    try {\n      const daytona = new Daytona({\n        apiKey: credentials.apiKey,\n        apiUrl: credentials.apiUrl,\n        target: credentials.target,\n      });\n\n      const existingSandbox = await daytona.get(id);\n\n      const daytonaSandbox = new DaytonaSandbox(options);\n      // Set the existing sandbox directly (bypass initialize)\n      daytonaSandbox.#setFromExisting(daytona, existingSandbox, id);\n\n      return daytonaSandbox;\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        `Sandbox not found: ${id}`,\n        \"SANDBOX_NOT_FOUND\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Get a running sandbox by name from a deployed app.\n   *\n   * @param name - The name of the sandbox\n   * @param options - Optional auth configuration\n   * @returns A connected sandbox instance\n   */\n  static async fromName(\n    name: string,\n    options?: Pick<DaytonaSandboxOptions, \"auth\">,\n  ): Promise<DaytonaSandbox> {\n    return DaytonaSandbox.fromId(name, options);\n  }\n}\n\n/**\n * Async factory function type for creating Daytona Sandbox instances.\n *\n * This is similar to BackendFactory but supports async creation,\n * which is required for Daytona Sandbox since initialization is async.\n */\nexport type AsyncDaytonaSandboxFactory = () => Promise<DaytonaSandbox>;\n\n/**\n * Create an async factory function that creates a new Daytona Sandbox per invocation.\n *\n * Each call to the factory will create and initialize a new sandbox.\n * This is useful when you want fresh, isolated environments for each\n * agent invocation.\n *\n * **Important**: This returns an async factory. For use with middleware that\n * requires synchronous BackendFactory, use `createDaytonaSandboxFactoryFromSandbox()`\n * with a pre-created sandbox instead.\n *\n * @param options - Optional configuration for sandbox creation\n * @returns An async factory function that creates new sandboxes\n *\n * @example\n * ```typescript\n * import { DaytonaSandbox, createDaytonaSandboxFactory } from \"@langchain/daytona\";\n *\n * // Create a factory for new sandboxes\n * const factory = createDaytonaSandboxFactory({ language: \"typescript\" });\n *\n * // Each call creates a new sandbox\n * const sandbox1 = await factory();\n * const sandbox2 = await factory();\n *\n * try {\n *   // Use sandboxes...\n * } finally {\n *   await sandbox1.close();\n *   await sandbox2.close();\n * }\n * ```\n */\nexport function createDaytonaSandboxFactory(\n  options?: DaytonaSandboxOptions,\n): AsyncDaytonaSandboxFactory {\n  return async () => {\n    return await DaytonaSandbox.create(options);\n  };\n}\n\n/**\n * Create a backend factory that reuses an existing Daytona Sandbox.\n *\n * This allows multiple agent invocations to share the same sandbox,\n * avoiding the startup overhead of creating new sandboxes.\n *\n * Important: You are responsible for managing the sandbox lifecycle\n * (calling `close()` when done).\n *\n * @param sandbox - An existing DaytonaSandbox instance (must be initialized)\n * @returns A BackendFactory that returns the provided sandbox\n *\n * @example\n * ```typescript\n * import { createDeepAgent, createFilesystemMiddleware } from \"deepagents\";\n * import { DaytonaSandbox, createDaytonaSandboxFactoryFromSandbox } from \"@langchain/daytona\";\n *\n * // Create and initialize a sandbox\n * const sandbox = await DaytonaSandbox.create({ language: \"typescript\" });\n *\n * try {\n *   const agent = createDeepAgent({\n *     model: new ChatAnthropic({ model: \"claude-sonnet-4-20250514\" }),\n *     systemPrompt: \"You are a coding assistant.\",\n *     middlewares: [\n *       createFilesystemMiddleware({\n *         backend: createDaytonaSandboxFactoryFromSandbox(sandbox),\n *       }),\n *     ],\n *   });\n *\n *   await agent.invoke({ messages: [...] });\n * } finally {\n *   await sandbox.close();\n * }\n * ```\n */\nexport function createDaytonaSandboxFactoryFromSandbox(\n  sandbox: DaytonaSandbox,\n): BackendFactory {\n  return () => sandbox;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["#id","#sandbox","#daytona","#options","#timeout","#uploadInitialFiles","#ensureParentDirectory","#mapError","#setFromExisting"],"sources":["../src/auth.ts","../src/types.ts","../src/sandbox.ts"],"sourcesContent":["/**\n * Authentication utilities for Daytona Sandbox.\n *\n * This module provides authentication credential resolution for the Daytona SDK.\n *\n * @packageDocumentation\n */\n\nimport type { DaytonaSandboxOptions } from \"./types.js\";\n\n/**\n * Authentication credentials for Daytona API.\n */\nexport interface DaytonaCredentials {\n  /** Daytona API key */\n  apiKey: string;\n\n  /** Daytona API URL */\n  apiUrl: string;\n\n  /** Target region */\n  target?: string;\n}\n\n/** Default Daytona API URL */\nconst DEFAULT_API_URL = \"https://app.daytona.io/api\";\n\n/**\n * Get the API key for Daytona API.\n *\n * Authentication is resolved in the following priority order:\n *\n * 1. **Explicit API key**: If `options.apiKey` is provided, it is used directly.\n * 2. **DAYTONA_API_KEY**: Environment variable for Daytona API key.\n *\n * If no API key is found, an error is thrown with setup instructions.\n *\n * ## Environment Variable Setup\n *\n * ```bash\n * # Get your API key from https://app.daytona.io\n * export DAYTONA_API_KEY=your_api_key_here\n * ```\n *\n * @param options - Optional authentication configuration from DaytonaSandboxOptions\n * @returns The API key string\n * @throws {Error} If no API key is available\n *\n * @example\n * ```typescript\n * // With explicit API key\n * const apiKey = getAuthApiKey({ apiKey: \"my-api-key\" });\n *\n * // Using environment variables (auto-detected)\n * const apiKey = getAuthApiKey();\n *\n * // From DaytonaSandboxOptions\n * const options: DaytonaSandboxOptions = {\n *   auth: { apiKey: \"my-api-key\" }\n * };\n * const apiKey = getAuthApiKey(options.auth);\n * ```\n */\nexport function getAuthApiKey(options?: DaytonaSandboxOptions[\"auth\"]): string {\n  // Priority 1: Explicit API key in options\n  if (options?.apiKey) {\n    return options.apiKey;\n  }\n\n  // Priority 2: DAYTONA_API_KEY environment variable\n  const apiKey = process.env.DAYTONA_API_KEY;\n  if (apiKey) {\n    return apiKey;\n  }\n\n  // No API key found - throw descriptive error\n  throw new Error(\n    \"Daytona authentication required. Provide an API key using one of these methods:\\n\\n\" +\n      \"1. Set DAYTONA_API_KEY environment variable:\\n\" +\n      \"   Get your API key from https://app.daytona.io\\n\" +\n      \"   Run: export DAYTONA_API_KEY=your_api_key_here\\n\\n\" +\n      \"2. Pass API key directly in options:\\n\" +\n      \"   new DaytonaSandbox({ auth: { apiKey: '...' } })\",\n  );\n}\n\n/**\n * Get the API URL for Daytona API.\n *\n * URL is resolved in the following priority order:\n *\n * 1. **Explicit API URL**: If `options.apiUrl` is provided, it is used directly.\n * 2. **DAYTONA_API_URL**: Environment variable for Daytona API URL.\n * 3. **Default**: Uses the default Daytona API URL.\n *\n * @param options - Optional authentication configuration from DaytonaSandboxOptions\n * @returns The API URL string\n */\nexport function getAuthApiUrl(options?: DaytonaSandboxOptions[\"auth\"]): string {\n  // Priority 1: Explicit API URL in options\n  if (options?.apiUrl) {\n    return options.apiUrl;\n  }\n\n  // Priority 2: DAYTONA_API_URL environment variable\n  const apiUrl = process.env.DAYTONA_API_URL;\n  if (apiUrl) {\n    return apiUrl;\n  }\n\n  // Priority 3: Default URL\n  return DEFAULT_API_URL;\n}\n\n/**\n * Get authentication credentials for Daytona API.\n *\n * This function returns the credentials needed for the Daytona SDK.\n *\n * @param options - Optional authentication configuration from DaytonaSandboxOptions\n * @param target - Optional target region\n * @returns Complete authentication credentials\n * @throws {Error} If no API key is available\n */\nexport function getAuthCredentials(\n  options?: DaytonaSandboxOptions[\"auth\"],\n  target?: string,\n): DaytonaCredentials {\n  return {\n    apiKey: getAuthApiKey(options),\n    apiUrl: getAuthApiUrl(options),\n    target: target ?? process.env.DAYTONA_TARGET,\n  };\n}\n","/**\n * Type definitions for the Daytona Sandbox backend.\n *\n * This module contains all type definitions for the @langchain/daytona package,\n * including options and error types.\n */\n\nimport { type SandboxErrorCode, SandboxError } from \"deepagents\";\n\n/**\n * Supported target regions for Daytona sandboxes.\n *\n * - `us`: United States\n * - `eu`: Europe\n */\nexport type DaytonaSandboxTarget = \"us\" | \"eu\";\n\n/**\n * Configuration options for creating a Daytona Sandbox.\n *\n * @example\n * ```typescript\n * const options: DaytonaSandboxOptions = {\n *   language: \"typescript\",\n *   timeout: 300, // 5 minutes\n *   target: \"us\",\n * };\n * ```\n */\nexport interface DaytonaSandboxOptions {\n  /**\n   * Primary language for code execution in the sandbox.\n   *\n   * Determines the runtime environment and code execution tooling.\n   *\n   * @default \"typescript\"\n   */\n  language?: \"typescript\" | \"python\" | \"javascript\";\n\n  /**\n   * Custom environment variables to set in the sandbox.\n   *\n   * These variables will be available to all commands and code executed\n   * in the sandbox.\n   *\n   * @example\n   * ```typescript\n   * envVars: {\n   *   NODE_ENV: \"development\",\n   *   API_KEY: \"secret\"\n   * }\n   * ```\n   */\n  envVars?: Record<string, string>;\n\n  /**\n   * Resource allocation for the sandbox.\n   *\n   * When specifying resources, you must also specify an `image`.\n   * Resources cannot be customized when using the default snapshot-based sandbox.\n   *\n   * @example\n   * ```typescript\n   * resources: { cpu: 2, memory: 4, disk: 20 }\n   * ```\n   */\n  resources?: {\n    /** Number of CPUs to allocate */\n    cpu?: number;\n    /** Amount of memory in GiB */\n    memory?: number;\n    /** Amount of disk space in GiB */\n    disk?: number;\n  };\n\n  /**\n   * Custom Docker image to use for the sandbox.\n   *\n   * When specified, creates a sandbox from this image instead of the default snapshot.\n   * This is required when you want to customize resources.\n   *\n   * @example \"node:20\" or \"python:3.12\"\n   */\n  image?: string;\n\n  /**\n   * Snapshot name to use for the sandbox.\n   *\n   * When specified, creates a sandbox from this snapshot.\n   * Cannot be used together with `image`.\n   */\n  snapshot?: string;\n\n  /**\n   * Target region where the sandbox will be created.\n   *\n   * @default \"us\"\n   */\n  target?: DaytonaSandboxTarget;\n\n  /**\n   * Auto-stop interval in minutes.\n   *\n   * The sandbox will automatically stop after being idle for this duration.\n   * Set to 0 to disable auto-stop.\n   *\n   * @default 15\n   */\n  autoStopInterval?: number;\n\n  /**\n   * Auto-archive interval in minutes.\n   *\n   * The sandbox will automatically archive after being stopped for this duration.\n   */\n  autoArchiveInterval?: number;\n\n  /**\n   * Auto-delete interval in minutes.\n   *\n   * The sandbox will automatically delete after being stopped for this duration.\n   */\n  autoDeleteInterval?: number;\n\n  /**\n   * Default timeout for command execution in seconds.\n   *\n   * @default 300 (5 minutes)\n   */\n  timeout?: number;\n\n  /**\n   * Custom labels to attach to the sandbox.\n   *\n   * Labels can be used for organizing and filtering sandboxes.\n   */\n  labels?: Record<string, string>;\n\n  /**\n   * Initial files to create in the sandbox after initialization.\n   *\n   * A map of file paths to their contents. Files will be created\n   * in the sandbox filesystem before any commands are executed.\n   * Parent directories are created automatically.\n   *\n   * @example\n   * ```typescript\n   * const options: DaytonaSandboxOptions = {\n   *   language: \"typescript\",\n   *   initialFiles: {\n   *     \"/app/index.js\": \"console.log('Hello')\",\n   *     \"/app/package.json\": '{\"name\": \"test\"}',\n   *   },\n   * };\n   * ```\n   */\n  initialFiles?: Record<string, string>;\n\n  /**\n   * Authentication configuration for Daytona API.\n   *\n   * ### Environment Variable Setup\n   *\n   * ```bash\n   * # Get your API key from https://app.daytona.io\n   * export DAYTONA_API_KEY=your_api_key_here\n   * ```\n   *\n   * Or pass the API key directly in this auth configuration.\n   */\n  auth?: {\n    /**\n     * Daytona API key.\n     * If not provided, reads from `DAYTONA_API_KEY` environment variable.\n     */\n    apiKey?: string;\n\n    /**\n     * Daytona API URL.\n     * If not provided, reads from `DAYTONA_API_URL` environment variable\n     * or uses the default Daytona API URL.\n     *\n     * @default \"https://app.daytona.io/api\"\n     */\n    apiUrl?: string;\n  };\n}\n\n/**\n * Error codes for Daytona Sandbox operations.\n *\n * Used to identify specific error conditions and handle them appropriately.\n */\nexport type DaytonaSandboxErrorCode =\n  | SandboxErrorCode\n  /** Authentication failed - check API key configuration */\n  | \"AUTHENTICATION_FAILED\"\n  /** Failed to create sandbox - check options and quotas */\n  | \"SANDBOX_CREATION_FAILED\"\n  /** Sandbox not found - may have been deleted or expired */\n  | \"SANDBOX_NOT_FOUND\"\n  /** Sandbox is not in started state */\n  | \"SANDBOX_NOT_STARTED\"\n  /** Resource limits exceeded (CPU, memory, storage) */\n  | \"RESOURCE_LIMIT_EXCEEDED\";\n\nconst DAYTONA_SANDBOX_ERROR_SYMBOL = Symbol.for(\"daytona.sandbox.error\");\n\n/**\n * Custom error class for Daytona Sandbox operations.\n *\n * Provides structured error information including:\n * - Human-readable message\n * - Error code for programmatic handling\n * - Original cause for debugging\n *\n * @example\n * ```typescript\n * try {\n *   await sandbox.execute(\"some command\");\n * } catch (error) {\n *   if (error instanceof DaytonaSandboxError) {\n *     switch (error.code) {\n *       case \"NOT_INITIALIZED\":\n *         await sandbox.initialize();\n *         break;\n *       case \"COMMAND_TIMEOUT\":\n *         console.error(\"Command took too long\");\n *         break;\n *       default:\n *         throw error;\n *     }\n *   }\n * }\n * ```\n */\nexport class DaytonaSandboxError extends SandboxError {\n  /** Symbol for identifying sandbox error instances */\n  [DAYTONA_SANDBOX_ERROR_SYMBOL] = true as const;\n\n  /** Error name for instanceof checks and logging */\n  override readonly name = \"DaytonaSandboxError\";\n\n  /**\n   * Creates a new DaytonaSandboxError.\n   *\n   * @param message - Human-readable error description\n   * @param code - Structured error code for programmatic handling\n   * @param cause - Original error that caused this error (for debugging)\n   */\n  constructor(\n    message: string,\n    public readonly code: DaytonaSandboxErrorCode,\n    public override readonly cause?: Error,\n  ) {\n    super(message, code as SandboxErrorCode, cause);\n    // Maintain proper prototype chain for instanceof checks\n    Object.setPrototypeOf(this, DaytonaSandboxError.prototype);\n  }\n\n  /**\n   * Checks if the error is an instance of DaytonaSandboxError.\n   *\n   * @param error - The error to check\n   * @returns True if the error is an instance of DaytonaSandboxError, false otherwise\n   */\n  static isInstance(error: unknown): error is DaytonaSandboxError {\n    return (\n      typeof error === \"object\" &&\n      error !== null &&\n      (error as Record<symbol, unknown>)[DAYTONA_SANDBOX_ERROR_SYMBOL] === true\n    );\n  }\n}\n","/* oxlint-disable no-instanceof/no-instanceof */\n/**\n * Daytona Sandbox implementation of the SandboxBackendProtocol.\n *\n * This module provides a Daytona Sandbox backend for deepagents, enabling agents\n * to execute commands, read/write files, and manage isolated sandbox environments\n * using Daytona's infrastructure.\n *\n * @packageDocumentation\n */\n\nimport { Daytona, type Sandbox } from \"@daytona/sdk\";\nimport {\n  BaseSandbox,\n  type ExecuteResponse,\n  type FileDownloadResponse,\n  type FileOperationError,\n  type FileUploadResponse,\n  type BackendFactory,\n} from \"deepagents\";\n\nimport { getAuthCredentials } from \"./auth.js\";\nimport { DaytonaSandboxError, type DaytonaSandboxOptions } from \"./types.js\";\n\nfunction shellQuote(value: string): string {\n  return `'${value.replace(/'/g, \"'\\\\''\")}'`;\n}\n\n/**\n * Daytona Sandbox backend for deepagents.\n *\n * Extends `BaseSandbox` to provide command execution, file operations, and\n * sandbox lifecycle management using Daytona's SDK.\n *\n * ## Basic Usage\n *\n * ```typescript\n * import { DaytonaSandbox } from \"@langchain/daytona\";\n *\n * // Create and initialize a sandbox\n * const sandbox = await DaytonaSandbox.create({\n *   language: \"typescript\",\n *   timeout: 300,\n * });\n *\n * try {\n *   // Execute commands\n *   const result = await sandbox.execute(\"node --version\");\n *   console.log(result.output);\n * } finally {\n *   // Always cleanup\n *   await sandbox.close();\n * }\n * ```\n *\n * ## Using with DeepAgent\n *\n * ```typescript\n * import { createDeepAgent } from \"deepagents\";\n * import { DaytonaSandbox } from \"@langchain/daytona\";\n *\n * const sandbox = await DaytonaSandbox.create();\n *\n * const agent = createDeepAgent({\n *   model: new ChatAnthropic({ model: \"claude-sonnet-4-20250514\" }),\n *   systemPrompt: \"You are a coding assistant with sandbox access.\",\n *   backend: sandbox,\n * });\n * ```\n */\nexport class DaytonaSandbox extends BaseSandbox {\n  /** Private reference to the Daytona client */\n  #daytona: Daytona | null = null;\n\n  /** Private reference to the underlying Daytona Sandbox instance */\n  #sandbox: Sandbox | null = null;\n\n  /** Configuration options for this sandbox */\n  #options: DaytonaSandboxOptions;\n\n  /** Unique identifier for this sandbox instance */\n  #id: string;\n\n  /** Default timeout for command execution in seconds */\n  #timeout: number;\n\n  /**\n   * Get the unique identifier for this sandbox.\n   *\n   * Before initialization, returns a temporary ID.\n   * After initialization, returns the actual Daytona sandbox ID.\n   */\n  get id(): string {\n    return this.#id;\n  }\n\n  /**\n   * Get the underlying Daytona Sandbox instance.\n   *\n   * @throws {DaytonaSandboxError} If the sandbox is not initialized\n   *\n   * @example\n   * ```typescript\n   * const sandbox = await DaytonaSandbox.create();\n   * const daytonaSdk = sandbox.sandbox; // Access the raw SDK\n   * ```\n   */\n  get instance(): Sandbox {\n    if (!this.#sandbox) {\n      throw new DaytonaSandboxError(\n        \"Sandbox not initialized. Call initialize() or use DaytonaSandbox.create()\",\n        \"NOT_INITIALIZED\",\n      );\n    }\n    return this.#sandbox;\n  }\n\n  /**\n   * Get the underlying Daytona client instance.\n   *\n   * @throws {DaytonaSandboxError} If the client is not initialized\n   *\n   * @example\n   * ```typescript\n   * const sandbox = await DaytonaSandbox.create();\n   * const daytonaClient = sandbox.client; // Access the raw Daytona client\n   * ```\n   */\n  get client(): Daytona {\n    if (!this.#daytona) {\n      throw new DaytonaSandboxError(\n        \"Daytona client not initialized. Call initialize() or use DaytonaSandbox.create()\",\n        \"NOT_INITIALIZED\",\n      );\n    }\n    return this.#daytona;\n  }\n\n  /**\n   * Check if the sandbox is initialized and running.\n   */\n  get isRunning(): boolean {\n    return this.#sandbox !== null;\n  }\n\n  /**\n   * Create a new DaytonaSandbox instance.\n   *\n   * Note: This only creates the instance. Call `initialize()` to actually\n   * create the Daytona Sandbox, or use the static `DaytonaSandbox.create()` method.\n   *\n   * @param options - Configuration options for the sandbox\n   *\n   * @example\n   * ```typescript\n   * // Two-step initialization\n   * const sandbox = new DaytonaSandbox({ language: \"typescript\" });\n   * await sandbox.initialize();\n   *\n   * // Or use the factory method\n   * const sandbox = await DaytonaSandbox.create({ language: \"typescript\" });\n   * ```\n   */\n  constructor(options: DaytonaSandboxOptions = {}) {\n    super();\n\n    // Set defaults\n    this.#options = {\n      language: \"typescript\",\n      timeout: 300,\n      ...options,\n    };\n\n    this.#timeout = this.#options.timeout ?? 300;\n\n    // Generate temporary ID until initialized\n    this.#id = `daytona-sandbox-${Date.now()}`;\n  }\n\n  /**\n   * Initialize the sandbox by creating a new Daytona Sandbox instance.\n   *\n   * This method authenticates with Daytona and provisions a new sandbox.\n   * After initialization, the `id` property will reflect the actual sandbox ID.\n   *\n   * @throws {DaytonaSandboxError} If already initialized (`ALREADY_INITIALIZED`)\n   * @throws {DaytonaSandboxError} If authentication fails (`AUTHENTICATION_FAILED`)\n   * @throws {DaytonaSandboxError} If sandbox creation fails (`SANDBOX_CREATION_FAILED`)\n   *\n   * @example\n   * ```typescript\n   * const sandbox = new DaytonaSandbox();\n   * await sandbox.initialize();\n   * console.log(`Sandbox ID: ${sandbox.id}`);\n   * ```\n   */\n  async initialize(): Promise<void> {\n    // Prevent double initialization\n    if (this.#sandbox) {\n      throw new DaytonaSandboxError(\n        \"Sandbox is already initialized. Each DaytonaSandbox instance can only be initialized once.\",\n        \"ALREADY_INITIALIZED\",\n      );\n    }\n\n    // Get authentication credentials\n    let credentials: { apiKey: string; apiUrl: string; target?: string };\n    try {\n      credentials = getAuthCredentials(\n        this.#options.auth,\n        this.#options.target,\n      );\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        \"Failed to authenticate with Daytona. Check your API key configuration.\",\n        \"AUTHENTICATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n\n    try {\n      // Create Daytona client\n      this.#daytona = new Daytona({\n        apiKey: credentials.apiKey,\n        apiUrl: credentials.apiUrl,\n        target: credentials.target,\n      });\n\n      // Determine if we're creating from image or snapshot\n      if (this.#options.image) {\n        // Create from image (allows custom resources)\n        const createOptions: {\n          image: string;\n          language?: string;\n          envVars?: Record<string, string>;\n          autoStopInterval?: number;\n          autoArchiveInterval?: number;\n          autoDeleteInterval?: number;\n          labels?: Record<string, string>;\n          resources?: { cpu?: number; memory?: number; disk?: number };\n        } = {\n          image: this.#options.image,\n          language: this.#options.language ?? \"typescript\",\n        };\n\n        if (this.#options.envVars) {\n          createOptions.envVars = this.#options.envVars;\n        }\n\n        if (this.#options.autoStopInterval !== undefined) {\n          createOptions.autoStopInterval = this.#options.autoStopInterval;\n        }\n\n        if (this.#options.autoArchiveInterval !== undefined) {\n          createOptions.autoArchiveInterval = this.#options.autoArchiveInterval;\n        }\n\n        if (this.#options.autoDeleteInterval !== undefined) {\n          createOptions.autoDeleteInterval = this.#options.autoDeleteInterval;\n        }\n\n        if (this.#options.labels) {\n          createOptions.labels = this.#options.labels;\n        }\n\n        if (this.#options.resources) {\n          createOptions.resources = this.#options.resources;\n        }\n\n        // Create the sandbox from image\n        this.#sandbox = await this.#daytona.create(createOptions);\n      } else {\n        // Create from snapshot (default, simpler approach)\n        const createOptions: {\n          language?: string;\n          snapshot?: string;\n          envVars?: Record<string, string>;\n          autoStopInterval?: number;\n          autoArchiveInterval?: number;\n          autoDeleteInterval?: number;\n          labels?: Record<string, string>;\n        } = {\n          language: this.#options.language ?? \"typescript\",\n        };\n\n        if (this.#options.snapshot) {\n          createOptions.snapshot = this.#options.snapshot;\n        }\n\n        if (this.#options.envVars) {\n          createOptions.envVars = this.#options.envVars;\n        }\n\n        if (this.#options.autoStopInterval !== undefined) {\n          createOptions.autoStopInterval = this.#options.autoStopInterval;\n        }\n\n        if (this.#options.autoArchiveInterval !== undefined) {\n          createOptions.autoArchiveInterval = this.#options.autoArchiveInterval;\n        }\n\n        if (this.#options.autoDeleteInterval !== undefined) {\n          createOptions.autoDeleteInterval = this.#options.autoDeleteInterval;\n        }\n\n        if (this.#options.labels) {\n          createOptions.labels = this.#options.labels;\n        }\n\n        // Create the sandbox from snapshot\n        this.#sandbox = await this.#daytona.create(createOptions);\n      }\n\n      // Update ID to the actual sandbox ID\n      this.#id = this.#sandbox.id;\n\n      // Upload initial files if provided\n      if (this.#options.initialFiles) {\n        await this.#uploadInitialFiles(this.#options.initialFiles);\n      }\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        `Failed to create Daytona Sandbox: ${error instanceof Error ? error.message : String(error)}`,\n        \"SANDBOX_CREATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Upload initial files to the sandbox.\n   *\n   * @param files - A map of file paths to their string contents\n   */\n  async #uploadInitialFiles(files: Record<string, string>): Promise<void> {\n    const encoder = new TextEncoder();\n    const fileEntries: Array<[string, Uint8Array]> = Object.entries(files).map(\n      ([path, content]) => [path, encoder.encode(content)],\n    );\n\n    const results = await this.uploadFiles(fileEntries);\n\n    // Check for any errors during upload\n    const errors = results.filter((r) => r.error !== null);\n    if (errors.length > 0) {\n      const errorPaths = errors.map((e) => `${e.path}: ${e.error}`).join(\", \");\n      throw new DaytonaSandboxError(\n        `Failed to upload initial files: ${errorPaths}`,\n        \"FILE_OPERATION_FAILED\",\n      );\n    }\n  }\n\n  /**\n   * Execute a command in the sandbox.\n   *\n   * Commands are run using the sandbox's shell.\n   *\n   * @param command - The shell command to execute\n   * @returns Execution result with output, exit code, and truncation flag\n   * @throws {DaytonaSandboxError} If the sandbox is not initialized\n   *\n   * @example\n   * ```typescript\n   * const result = await sandbox.execute(\"echo 'Hello World'\");\n   * console.log(result.output); // \"Hello World\\n\"\n   * console.log(result.exitCode); // 0\n   * ```\n   */\n  async execute(command: string): Promise<ExecuteResponse> {\n    const sandbox = this.instance; // Throws if not initialized\n\n    try {\n      const response = await sandbox.process.executeCommand(\n        command,\n        undefined,\n        undefined,\n        this.#timeout,\n      );\n\n      return {\n        output: response.result ?? \"\",\n        exitCode: response.exitCode ?? 0,\n        truncated: false,\n      };\n    } catch (error) {\n      // Check for timeout\n      if (error instanceof Error && error.message.includes(\"timeout\")) {\n        throw new DaytonaSandboxError(\n          `Command timed out: ${command}`,\n          \"COMMAND_TIMEOUT\",\n          error,\n        );\n      }\n\n      throw new DaytonaSandboxError(\n        `Command execution failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"COMMAND_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Upload files to the sandbox.\n   *\n   * Files are written to the sandbox filesystem. Parent directories are\n   * created automatically if they don't exist.\n   *\n   * @param files - Array of [path, content] tuples to upload\n   * @returns Upload result for each file, with success or error status\n   *\n   * @example\n   * ```typescript\n   * const encoder = new TextEncoder();\n   * const results = await sandbox.uploadFiles([\n   *   [\"src/index.js\", encoder.encode(\"console.log('Hello')\")],\n   *   [\"package.json\", encoder.encode('{\"name\": \"test\"}')],\n   * ]);\n   * ```\n   */\n  async uploadFiles(\n    files: Array<[string, Uint8Array]>,\n  ): Promise<FileUploadResponse[]> {\n    const sandbox = this.instance; // Throws if not initialized\n    const results: FileUploadResponse[] = [];\n\n    for (const [path, content] of files) {\n      try {\n        // Ensure parent directory exists\n        const parentDir = path.substring(0, path.lastIndexOf(\"/\"));\n        if (parentDir) {\n          await this.#ensureParentDirectory(parentDir);\n        }\n\n        // Upload the file content\n        const buffer = Buffer.from(content);\n        await sandbox.fs.uploadFile(buffer, path);\n        results.push({ path, error: null });\n      } catch (error) {\n        results.push({ path, error: this.#mapError(error) });\n      }\n    }\n\n    return results;\n  }\n\n  async #ensureParentDirectory(parentDir: string): Promise<void> {\n    const result = await this.execute(`mkdir -p ${shellQuote(parentDir)}`);\n    if (result.exitCode !== 0) {\n      throw new Error(`Failed to create parent directory: ${parentDir}`);\n    }\n  }\n\n  /**\n   * Download files from the sandbox.\n   *\n   * Each file is read individually, allowing partial success when some\n   * files exist and others don't.\n   *\n   * @param paths - Array of file paths to download\n   * @returns Download result for each file, with content or error\n   *\n   * @example\n   * ```typescript\n   * const results = await sandbox.downloadFiles([\"src/index.js\", \"missing.txt\"]);\n   * for (const result of results) {\n   *   if (result.content) {\n   *     console.log(new TextDecoder().decode(result.content));\n   *   } else {\n   *     console.error(`Error: ${result.error}`);\n   *   }\n   * }\n   * ```\n   */\n  async downloadFiles(paths: string[]): Promise<FileDownloadResponse[]> {\n    const sandbox = this.instance; // Throws if not initialized\n    const results: FileDownloadResponse[] = [];\n\n    for (const path of paths) {\n      try {\n        const buffer = await sandbox.fs.downloadFile(path);\n        results.push({\n          path,\n          content: new Uint8Array(buffer),\n          error: null,\n        });\n      } catch (error) {\n        results.push({\n          path,\n          content: null,\n          error: this.#mapError(error),\n        });\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Close the sandbox and release all resources.\n   *\n   * After closing, the sandbox cannot be used again. The sandbox is deleted\n   * from Daytona's infrastructure.\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   await sandbox.execute(\"npm run build\");\n   * } finally {\n   *   await sandbox.close();\n   * }\n   * ```\n   */\n  async close(): Promise<void> {\n    if (this.#sandbox) {\n      try {\n        await this.#sandbox.delete();\n      } finally {\n        this.#sandbox = null;\n        this.#daytona = null;\n      }\n    }\n  }\n\n  /**\n   * Stop the sandbox without deleting it.\n   *\n   * The sandbox can be restarted later using `start()`.\n   *\n   * @example\n   * ```typescript\n   * await sandbox.stop();\n   * // Later...\n   * await sandbox.start();\n   * ```\n   */\n  async stop(): Promise<void> {\n    if (this.#sandbox) {\n      await this.#sandbox.stop();\n    }\n  }\n\n  /**\n   * Start a stopped sandbox.\n   *\n   * @param timeout - Maximum time to wait in seconds (default: 60)\n   *\n   * @example\n   * ```typescript\n   * await sandbox.start();\n   * console.log(\"Sandbox is now running\");\n   * ```\n   */\n  async start(timeout: number = 60): Promise<void> {\n    if (this.#sandbox) {\n      await this.#sandbox.start(timeout);\n    }\n  }\n\n  /**\n   * Forcefully terminate and delete the sandbox.\n   *\n   * Use this when you need to immediately stop the sandbox.\n   *\n   * @example\n   * ```typescript\n   * await sandbox.kill();\n   * ```\n   */\n  async kill(): Promise<void> {\n    await this.close();\n  }\n\n  /**\n   * Get the working directory path inside the sandbox.\n   *\n   * @returns The absolute path to the sandbox working directory\n   *\n   * @example\n   * ```typescript\n   * const workDir = await sandbox.getWorkDir();\n   * console.log(`Working directory: ${workDir}`);\n   * ```\n   */\n  async getWorkDir(): Promise<string> {\n    const sandbox = this.instance;\n    const workDir = await sandbox.getWorkDir();\n    return workDir ?? \"/home/daytona\";\n  }\n\n  /**\n   * Get the user's home directory path inside the sandbox.\n   *\n   * @returns The absolute path to the user's home directory\n   *\n   * @example\n   * ```typescript\n   * const homeDir = await sandbox.getUserHomeDir();\n   * console.log(`Home directory: ${homeDir}`);\n   * ```\n   */\n  async getUserHomeDir(): Promise<string> {\n    const sandbox = this.instance;\n    const homeDir = await sandbox.getUserHomeDir();\n    return homeDir ?? \"/home/daytona\";\n  }\n\n  /**\n   * Set the sandbox from an existing Daytona Sandbox instance.\n   * Used internally by the static `connect()` method.\n   */\n  #setFromExisting(\n    daytona: Daytona,\n    existingSandbox: Sandbox,\n    sandboxId: string,\n  ): void {\n    this.#daytona = daytona;\n    this.#sandbox = existingSandbox;\n    this.#id = sandboxId;\n  }\n\n  /**\n   * Map Daytona SDK errors to standardized FileOperationError codes.\n   *\n   * @param error - The error from the Daytona SDK\n   * @returns A standardized error code\n   */\n  #mapError(error: unknown): FileOperationError {\n    if (error instanceof Error) {\n      const msg = error.message.toLowerCase();\n\n      if (msg.includes(\"not found\") || msg.includes(\"enoent\")) {\n        return \"file_not_found\";\n      }\n      if (msg.includes(\"permission\") || msg.includes(\"eacces\")) {\n        return \"permission_denied\";\n      }\n      if (msg.includes(\"directory\") || msg.includes(\"eisdir\")) {\n        return \"is_directory\";\n      }\n    }\n\n    return \"invalid_path\";\n  }\n\n  /**\n   * Create and initialize a new DaytonaSandbox in one step.\n   *\n   * This is the recommended way to create a sandbox. It combines\n   * construction and initialization into a single async operation.\n   *\n   * @param options - Configuration options for the sandbox\n   * @returns An initialized and ready-to-use sandbox\n   *\n   * @example\n   * ```typescript\n   * const sandbox = await DaytonaSandbox.create({\n   *   language: \"typescript\",\n   *   cpu: 2,\n   *   memory: 4,\n   * });\n   * ```\n   */\n  static async create(\n    options?: DaytonaSandboxOptions,\n  ): Promise<DaytonaSandbox> {\n    const sandbox = new DaytonaSandbox(options);\n    await sandbox.initialize();\n    return sandbox;\n  }\n\n  /**\n   * Delete all sandboxes matching the given labels.\n   *\n   * This is useful for cleaning up stale sandboxes from previous test runs\n   * or CI pipelines that may not have shut down cleanly.\n   *\n   * @param labels - Label key-value pairs to filter sandboxes\n   * @param options - Optional auth configuration\n   * @returns The number of sandboxes that were deleted\n   *\n   * @example\n   * ```typescript\n   * // Clean up all integration-test sandboxes\n   * const deleted = await DaytonaSandbox.deleteAll({\n   *   purpose: \"integration-test\",\n   *   package: \"@langchain/daytona\",\n   * });\n   * console.log(`Deleted ${deleted} stale sandboxes`);\n   * ```\n   */\n  static async deleteAll(\n    labels: Record<string, string>,\n    options?: Pick<DaytonaSandboxOptions, \"auth\" | \"target\">,\n  ): Promise<number> {\n    let credentials: { apiKey: string; apiUrl: string; target?: string };\n    try {\n      credentials = getAuthCredentials(options?.auth, options?.target);\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        \"Failed to authenticate with Daytona. Check your API key configuration.\",\n        \"AUTHENTICATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n\n    const daytona = new Daytona({\n      apiKey: credentials.apiKey,\n      apiUrl: credentials.apiUrl,\n      target: credentials.target,\n    });\n\n    const sandboxes: Sandbox[] = [];\n    for await (const sandbox of daytona.list({ labels })) {\n      sandboxes.push(sandbox);\n    }\n\n    const results = await Promise.all(\n      sandboxes.map((sandbox) =>\n        daytona\n          .delete(sandbox)\n          .then(() => true)\n          .catch(() => false),\n      ),\n    );\n\n    return results.filter(Boolean).length;\n  }\n\n  /**\n   * Connect to an existing sandbox by ID.\n   *\n   * This allows you to resume working with a sandbox that was created\n   * earlier or that is still running.\n   *\n   * @param sandboxId - The ID of the sandbox to connect to\n   * @param options - Optional auth configuration (for API key)\n   * @returns A connected sandbox instance\n   *\n   * @example\n   * ```typescript\n   * // Resume a sandbox from a stored ID\n   * const sandbox = await DaytonaSandbox.connect(\"sandbox-abc123\");\n   * const result = await sandbox.execute(\"ls -la\");\n   * ```\n   */\n  static async fromId(\n    id: string,\n    options?: Pick<DaytonaSandboxOptions, \"auth\" | \"target\" | \"timeout\">,\n  ): Promise<DaytonaSandbox> {\n    // Get authentication credentials\n    let credentials: { apiKey: string; apiUrl: string; target?: string };\n    try {\n      credentials = getAuthCredentials(options?.auth, options?.target);\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        \"Failed to authenticate with Daytona. Check your API key configuration.\",\n        \"AUTHENTICATION_FAILED\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n\n    try {\n      const daytona = new Daytona({\n        apiKey: credentials.apiKey,\n        apiUrl: credentials.apiUrl,\n        target: credentials.target,\n      });\n\n      const existingSandbox = await daytona.get(id);\n\n      const daytonaSandbox = new DaytonaSandbox(options);\n      // Set the existing sandbox directly (bypass initialize)\n      daytonaSandbox.#setFromExisting(daytona, existingSandbox, id);\n\n      return daytonaSandbox;\n    } catch (error) {\n      throw new DaytonaSandboxError(\n        `Sandbox not found: ${id}`,\n        \"SANDBOX_NOT_FOUND\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Get a running sandbox by name from a deployed app.\n   *\n   * @param name - The name of the sandbox\n   * @param options - Optional auth configuration\n   * @returns A connected sandbox instance\n   */\n  static async fromName(\n    name: string,\n    options?: Pick<DaytonaSandboxOptions, \"auth\">,\n  ): Promise<DaytonaSandbox> {\n    return DaytonaSandbox.fromId(name, options);\n  }\n}\n\n/**\n * Async factory function type for creating Daytona Sandbox instances.\n *\n * This is similar to BackendFactory but supports async creation,\n * which is required for Daytona Sandbox since initialization is async.\n */\nexport type AsyncDaytonaSandboxFactory = () => Promise<DaytonaSandbox>;\n\n/**\n * Create an async factory function that creates a new Daytona Sandbox per invocation.\n *\n * Each call to the factory will create and initialize a new sandbox.\n * This is useful when you want fresh, isolated environments for each\n * agent invocation.\n *\n * **Important**: This returns an async factory. For use with middleware that\n * requires synchronous BackendFactory, use `createDaytonaSandboxFactoryFromSandbox()`\n * with a pre-created sandbox instead.\n *\n * @param options - Optional configuration for sandbox creation\n * @returns An async factory function that creates new sandboxes\n *\n * @example\n * ```typescript\n * import { DaytonaSandbox, createDaytonaSandboxFactory } from \"@langchain/daytona\";\n *\n * // Create a factory for new sandboxes\n * const factory = createDaytonaSandboxFactory({ language: \"typescript\" });\n *\n * // Each call creates a new sandbox\n * const sandbox1 = await factory();\n * const sandbox2 = await factory();\n *\n * try {\n *   // Use sandboxes...\n * } finally {\n *   await sandbox1.close();\n *   await sandbox2.close();\n * }\n * ```\n */\nexport function createDaytonaSandboxFactory(\n  options?: DaytonaSandboxOptions,\n): AsyncDaytonaSandboxFactory {\n  return async () => {\n    return await DaytonaSandbox.create(options);\n  };\n}\n\n/**\n * Create a backend factory that reuses an existing Daytona Sandbox.\n *\n * This allows multiple agent invocations to share the same sandbox,\n * avoiding the startup overhead of creating new sandboxes.\n *\n * Important: You are responsible for managing the sandbox lifecycle\n * (calling `close()` when done).\n *\n * @param sandbox - An existing DaytonaSandbox instance (must be initialized)\n * @returns A BackendFactory that returns the provided sandbox\n *\n * @example\n * ```typescript\n * import { createDeepAgent, createFilesystemMiddleware } from \"deepagents\";\n * import { DaytonaSandbox, createDaytonaSandboxFactoryFromSandbox } from \"@langchain/daytona\";\n *\n * // Create and initialize a sandbox\n * const sandbox = await DaytonaSandbox.create({ language: \"typescript\" });\n *\n * try {\n *   const agent = createDeepAgent({\n *     model: new ChatAnthropic({ model: \"claude-sonnet-4-20250514\" }),\n *     systemPrompt: \"You are a coding assistant.\",\n *     middlewares: [\n *       createFilesystemMiddleware({\n *         backend: createDaytonaSandboxFactoryFromSandbox(sandbox),\n *       }),\n *     ],\n *   });\n *\n *   await agent.invoke({ messages: [...] });\n * } finally {\n *   await sandbox.close();\n * }\n * ```\n */\nexport function createDaytonaSandboxFactoryFromSandbox(\n  sandbox: DaytonaSandbox,\n): BackendFactory {\n  return () => sandbox;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/daytona",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Daytona Sandbox backend for deepagents",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -27,22 +27,22 @@
   },
   "homepage": "https://github.com/langchain-ai/deepagentsjs#readme",
   "dependencies": {
-    "@daytonaio/sdk": "^0.155.0"
+    "@daytona/sdk": "^0.200.1"
   },
   "peerDependencies": {
-    "deepagents": ">=1.6.0"
+    "deepagents": ">=1.12.0-rc.0"
   },
   "devDependencies": {
     "@tsconfig/recommended": "^1.0.13",
-    "@types/node": "^25.1.0",
+    "@types/node": "^26.1.0",
     "@vitest/coverage-v8": "^4.0.18",
     "dotenv": "^17.2.3",
-    "tsdown": "^0.21.4",
+    "tsdown": "^0.22.1",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
+    "typescript": "^7.0.2",
     "vitest": "^4.0.18",
-    "deepagents": "1.8.7",
-    "@langchain/sandbox-standard-tests": "0.1.0"
+    "deepagents": "1.12.2",
+    "@langchain/sandbox-standard-tests": "2.0.0"
   },
   "exports": {
     ".": {