deepagents 1.10.0 → 1.10.1

package/dist/index.d.cts

@@ -13,7 +13,7 @@ import * as _$_langchain_core_tools0 from "@langchain/core/tools";
 import { ClientTool, ServerTool, StructuredTool as StructuredTool$1 } from "@langchain/core/tools";
 import { InteropZodObject } from "@langchain/core/utils/types";
 import { BaseLanguageModel, LanguageModelLike } from "@langchain/core/language_models/base";
-import { CreateSandboxOptions, Sandbox } from "langsmith/experimental/sandbox";
+import { CaptureSnapshotOptions, CaptureSnapshotOptions as LangSmithCaptureSnapshotOptions, CreateSandboxOptions, Sandbox, Snapshot, Snapshot as LangSmithSnapshot, StartSandboxOptions, StartSandboxOptions as LangSmithStartSandboxOptions } from "langsmith/experimental/sandbox";
 import { Runnable } from "@langchain/core/runnables";
 import { BaseChatModel } from "@langchain/core/language_models/chat_models";
 //#region src/backends/v1/protocol.d.ts
@@ -1703,10 +1703,17 @@ interface LangSmithSandboxOptions {
   defaultTimeout?: number;
 }
 /** Options for the `LangSmithSandbox.create()` static factory. */
-interface LangSmithSandboxCreateOptions extends Omit<CreateSandboxOptions, "name" | "timeout" | "waitForReady"> {
+interface LangSmithSandboxCreateOptions extends Omit<CreateSandboxOptions, "name" | "timeout" | "waitForReady" | "snapshotName"> {
+  /**
+   * Snapshot ID to boot from.
+   * Mutually exclusive with `templateName`.
+   */
+  snapshotId?: string;
   /**
    * Name of the LangSmith sandbox template to use.
-   * @default "deepagents"
+   * Mutually exclusive with `snapshotId`.
+   * @deprecated Use `snapshotId` instead. Template-based creation will be
+   * removed in a future release.
    */
   templateName?: string;
   /**
@@ -1765,6 +1772,33 @@ declare class LangSmithSandbox extends BaseSandbox {
    * cannot be used again.
    */
   close(): Promise<void>;
+  /**
+   * Start a stopped sandbox and wait until it is ready.
+   *
+   * After calling this, `isRunning` will be `true` and the sandbox
+   * can be used for command execution and file operations again.
+   *
+   * @param options - Start options (timeout, signal).
+   */
+  start(options?: StartSandboxOptions): Promise<void>;
+  /**
+   * Stop the sandbox without deleting it.
+   *
+   * Sandbox files are preserved and the sandbox can be restarted later
+   * with `start()`. After calling this, `isRunning` will be `false`.
+   */
+  stop(): Promise<void>;
+  /**
+   * Capture a snapshot from this running sandbox.
+   *
+   * Snapshots can be used to create new sandboxes via
+   * `LangSmithSandbox.create({ snapshotId })`.
+   *
+   * @param name - Name for the snapshot.
+   * @param options - Capture options (checkpoint, timeout).
+   * @returns The created Snapshot in "ready" status.
+   */
+  captureSnapshot(name: string, options?: CaptureSnapshotOptions): Promise<Snapshot>;
   /**
    * Create and return a new LangSmithSandbox in one step.
    *
@@ -1773,7 +1807,10 @@ declare class LangSmithSandbox extends BaseSandbox {
    *
    * @example
    * ```typescript
-   * const sandbox = await LangSmithSandbox.create({ templateName: "deepagents" });
+   * const sandbox = await LangSmithSandbox.create({
+   *   snapshotId: "abc-123",
+   * });
+   *
    * try {
    *   const agent = createDeepAgent({ model, backend: sandbox });
    *   await agent.invoke({ messages: [...] });
@@ -1782,7 +1819,7 @@ declare class LangSmithSandbox extends BaseSandbox {
    * }
    * ```
    */
-  static create(options?: LangSmithSandboxCreateOptions): Promise<LangSmithSandbox>;
+  static create(options: LangSmithSandboxCreateOptions): Promise<LangSmithSandbox>;
 }
 //#endregion
 //#region src/backends/utils.d.ts
@@ -3525,5 +3562,5 @@ declare function parseSkillMetadata(skillMdPath: string, source: "user" | "proje
  */
 declare function listSkills(options: ListSkillsOptions): SkillMetadata[];
 //#endregion
-export { type AgentMemoryMiddlewareOptions, type AnyBackendProtocol, type AnySubAgent, type AsyncSubAgent, type AsyncSubAgentMiddlewareOptions, type AsyncTask, type AsyncTaskStatus, type BackendFactory, type BackendProtocol, type BackendProtocolV1, type BackendProtocolV2, type BackendRuntime, BaseSandbox, type CompiledSubAgent, type CompletionCallbackOptions, CompositeBackend, ConfigurationError, type ConfigurationErrorCode, type CreateDeepAgentParams, DEFAULT_GENERAL_PURPOSE_DESCRIPTION, DEFAULT_SUBAGENT_PROMPT, type DeepAgent, type DeepAgentRunStream, type DeepAgentTypeConfig, type DefaultDeepAgentTypeConfig, type EditResult, type ExecuteResponse, type ExtractSubAgentMiddleware, type FileData, type FileDownloadResponse, type FileInfo, type FileOperationError, type FileUploadResponse, FilesystemBackend, type FilesystemMiddlewareOptions, type FilesystemOperation, type FilesystemPermission, type FlattenSubAgentMiddleware, GENERAL_PURPOSE_SUBAGENT, type GlobResult, type GrepMatch, type GrepResult, type InferDeepAgentSubagents, type InferDeepAgentType, type InferStructuredResponse, type InferSubAgentMiddlewareStates, type InferSubagentByName, type InferSubagentReactAgentType, LangSmithSandbox, type LangSmithSandboxOptions, type ListSkillsOptions, type SkillMetadata as LoaderSkillMetadata, LocalShellBackend, type LocalShellBackendOptions, type LsResult, MAX_SKILL_DESCRIPTION_LENGTH, MAX_SKILL_FILE_SIZE, MAX_SKILL_NAME_LENGTH, type MaybePromise, type MemoryMiddlewareOptions, type MergedDeepAgentState, type PermissionMode, type ReadRawResult, type ReadResult, type ResolveDeepAgentTypeConfig, type SandboxBackendProtocol, type SandboxBackendProtocolV1, type SandboxBackendProtocolV2, type SandboxDeleteOptions, SandboxError, type SandboxErrorCode, type SandboxGetOrCreateOptions, type SandboxInfo, type SandboxListOptions, type SandboxListResponse, type Settings, type SettingsOptions, type SkillMetadata$1 as SkillMetadata, type SkillsMiddlewareOptions, type StateAndStore, StateBackend, StoreBackend, type StoreBackendContext, type StoreBackendNamespaceFactory, type StoreBackendOptions, type SubAgent, type SubAgentMiddlewareOptions, type SubagentRunStream, type SupportedResponseFormat, TASK_SYSTEM_PROMPT, type WriteResult, adaptBackendProtocol, adaptSandboxProtocol, computeSummarizationDefaults, createAgentMemoryMiddleware, createAsyncSubAgentMiddleware, createCompletionCallbackMiddleware, createDeepAgent, createFilesystemMiddleware, createMemoryMiddleware, createPatchToolCallsMiddleware, createSettings, createSkillsMiddleware, createSubAgentMiddleware, createSubagentTransformer, createSummarizationMiddleware, filesValue, findProjectRoot, isAsyncSubAgent, isSandboxBackend, isSandboxProtocol, listSkills, parseSkillMetadata, resolveBackend };
+export { type AgentMemoryMiddlewareOptions, type AnyBackendProtocol, type AnySubAgent, type AsyncSubAgent, type AsyncSubAgentMiddlewareOptions, type AsyncTask, type AsyncTaskStatus, type BackendFactory, type BackendProtocol, type BackendProtocolV1, type BackendProtocolV2, type BackendRuntime, BaseSandbox, type CompiledSubAgent, type CompletionCallbackOptions, CompositeBackend, ConfigurationError, type ConfigurationErrorCode, type CreateDeepAgentParams, DEFAULT_GENERAL_PURPOSE_DESCRIPTION, DEFAULT_SUBAGENT_PROMPT, type DeepAgent, type DeepAgentRunStream, type DeepAgentTypeConfig, type DefaultDeepAgentTypeConfig, type EditResult, type ExecuteResponse, type ExtractSubAgentMiddleware, type FileData, type FileDownloadResponse, type FileInfo, type FileOperationError, type FileUploadResponse, FilesystemBackend, type FilesystemMiddlewareOptions, type FilesystemOperation, type FilesystemPermission, type FlattenSubAgentMiddleware, GENERAL_PURPOSE_SUBAGENT, type GlobResult, type GrepMatch, type GrepResult, type InferDeepAgentSubagents, type InferDeepAgentType, type InferStructuredResponse, type InferSubAgentMiddlewareStates, type InferSubagentByName, type InferSubagentReactAgentType, type LangSmithCaptureSnapshotOptions, LangSmithSandbox, type LangSmithSandboxCreateOptions, type LangSmithSandboxOptions, type LangSmithSnapshot, type LangSmithStartSandboxOptions, type ListSkillsOptions, type SkillMetadata as LoaderSkillMetadata, LocalShellBackend, type LocalShellBackendOptions, type LsResult, MAX_SKILL_DESCRIPTION_LENGTH, MAX_SKILL_FILE_SIZE, MAX_SKILL_NAME_LENGTH, type MaybePromise, type MemoryMiddlewareOptions, type MergedDeepAgentState, type PermissionMode, type ReadRawResult, type ReadResult, type ResolveDeepAgentTypeConfig, type SandboxBackendProtocol, type SandboxBackendProtocolV1, type SandboxBackendProtocolV2, type SandboxDeleteOptions, SandboxError, type SandboxErrorCode, type SandboxGetOrCreateOptions, type SandboxInfo, type SandboxListOptions, type SandboxListResponse, type Settings, type SettingsOptions, type SkillMetadata$1 as SkillMetadata, type SkillsMiddlewareOptions, type StateAndStore, StateBackend, StoreBackend, type StoreBackendContext, type StoreBackendNamespaceFactory, type StoreBackendOptions, type SubAgent, type SubAgentMiddlewareOptions, type SubagentRunStream, type SupportedResponseFormat, TASK_SYSTEM_PROMPT, type WriteResult, adaptBackendProtocol, adaptSandboxProtocol, computeSummarizationDefaults, createAgentMemoryMiddleware, createAsyncSubAgentMiddleware, createCompletionCallbackMiddleware, createDeepAgent, createFilesystemMiddleware, createMemoryMiddleware, createPatchToolCallsMiddleware, createSettings, createSkillsMiddleware, createSubAgentMiddleware, createSubagentTransformer, createSummarizationMiddleware, filesValue, findProjectRoot, isAsyncSubAgent, isSandboxBackend, isSandboxProtocol, listSkills, parseSkillMetadata, resolveBackend };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -7,7 +7,7 @@ import * as _messages from "@langchain/core/messages";
 import * as z$2 from "zod";
 import { z as z$1 } from "zod";
 import { Client } from "@langchain/langgraph-sdk";
-import { CreateSandboxOptions, Sandbox } from "langsmith/experimental/sandbox";
+import { CaptureSnapshotOptions, CaptureSnapshotOptions as LangSmithCaptureSnapshotOptions, CreateSandboxOptions, Sandbox, Snapshot, Snapshot as LangSmithSnapshot, StartSandboxOptions, StartSandboxOptions as LangSmithStartSandboxOptions } from "langsmith/experimental/sandbox";
 import * as _$zod_v30 from "zod/v3";
 import { BaseCheckpointSaver, BaseStore } from "@langchain/langgraph-checkpoint";
 import * as _$zod_v4_core0 from "zod/v4/core";
@@ -1705,10 +1705,17 @@ interface LangSmithSandboxOptions {
   defaultTimeout?: number;
 }
 /** Options for the `LangSmithSandbox.create()` static factory. */
-interface LangSmithSandboxCreateOptions extends Omit<CreateSandboxOptions, "name" | "timeout" | "waitForReady"> {
+interface LangSmithSandboxCreateOptions extends Omit<CreateSandboxOptions, "name" | "timeout" | "waitForReady" | "snapshotName"> {
+  /**
+   * Snapshot ID to boot from.
+   * Mutually exclusive with `templateName`.
+   */
+  snapshotId?: string;
   /**
    * Name of the LangSmith sandbox template to use.
-   * @default "deepagents"
+   * Mutually exclusive with `snapshotId`.
+   * @deprecated Use `snapshotId` instead. Template-based creation will be
+   * removed in a future release.
    */
   templateName?: string;
   /**
@@ -1767,6 +1774,33 @@ declare class LangSmithSandbox extends BaseSandbox {
    * cannot be used again.
    */
   close(): Promise<void>;
+  /**
+   * Start a stopped sandbox and wait until it is ready.
+   *
+   * After calling this, `isRunning` will be `true` and the sandbox
+   * can be used for command execution and file operations again.
+   *
+   * @param options - Start options (timeout, signal).
+   */
+  start(options?: StartSandboxOptions): Promise<void>;
+  /**
+   * Stop the sandbox without deleting it.
+   *
+   * Sandbox files are preserved and the sandbox can be restarted later
+   * with `start()`. After calling this, `isRunning` will be `false`.
+   */
+  stop(): Promise<void>;
+  /**
+   * Capture a snapshot from this running sandbox.
+   *
+   * Snapshots can be used to create new sandboxes via
+   * `LangSmithSandbox.create({ snapshotId })`.
+   *
+   * @param name - Name for the snapshot.
+   * @param options - Capture options (checkpoint, timeout).
+   * @returns The created Snapshot in "ready" status.
+   */
+  captureSnapshot(name: string, options?: CaptureSnapshotOptions): Promise<Snapshot>;
   /**
    * Create and return a new LangSmithSandbox in one step.
    *
@@ -1775,7 +1809,10 @@ declare class LangSmithSandbox extends BaseSandbox {
    *
    * @example
    * ```typescript
-   * const sandbox = await LangSmithSandbox.create({ templateName: "deepagents" });
+   * const sandbox = await LangSmithSandbox.create({
+   *   snapshotId: "abc-123",
+   * });
+   *
    * try {
    *   const agent = createDeepAgent({ model, backend: sandbox });
    *   await agent.invoke({ messages: [...] });
@@ -1784,7 +1821,7 @@ declare class LangSmithSandbox extends BaseSandbox {
    * }
    * ```
    */
-  static create(options?: LangSmithSandboxCreateOptions): Promise<LangSmithSandbox>;
+  static create(options: LangSmithSandboxCreateOptions): Promise<LangSmithSandbox>;
 }
 //#endregion
 //#region src/backends/utils.d.ts
@@ -3527,5 +3564,5 @@ declare function parseSkillMetadata(skillMdPath: string, source: "user" | "proje
  */
 declare function listSkills(options: ListSkillsOptions): SkillMetadata[];
 //#endregion
-export { type AgentMemoryMiddlewareOptions, type AnyBackendProtocol, type AnySubAgent, type AsyncSubAgent, type AsyncSubAgentMiddlewareOptions, type AsyncTask, type AsyncTaskStatus, type BackendFactory, type BackendProtocol, type BackendProtocolV1, type BackendProtocolV2, type BackendRuntime, BaseSandbox, type CompiledSubAgent, type CompletionCallbackOptions, CompositeBackend, ConfigurationError, type ConfigurationErrorCode, type CreateDeepAgentParams, DEFAULT_GENERAL_PURPOSE_DESCRIPTION, DEFAULT_SUBAGENT_PROMPT, type DeepAgent, type DeepAgentRunStream, type DeepAgentTypeConfig, type DefaultDeepAgentTypeConfig, type EditResult, type ExecuteResponse, type ExtractSubAgentMiddleware, type FileData, type FileDownloadResponse, type FileInfo, type FileOperationError, type FileUploadResponse, FilesystemBackend, type FilesystemMiddlewareOptions, type FilesystemOperation, type FilesystemPermission, type FlattenSubAgentMiddleware, GENERAL_PURPOSE_SUBAGENT, type GlobResult, type GrepMatch, type GrepResult, type InferDeepAgentSubagents, type InferDeepAgentType, type InferStructuredResponse, type InferSubAgentMiddlewareStates, type InferSubagentByName, type InferSubagentReactAgentType, LangSmithSandbox, type LangSmithSandboxOptions, type ListSkillsOptions, type SkillMetadata as LoaderSkillMetadata, LocalShellBackend, type LocalShellBackendOptions, type LsResult, MAX_SKILL_DESCRIPTION_LENGTH, MAX_SKILL_FILE_SIZE, MAX_SKILL_NAME_LENGTH, type MaybePromise, type MemoryMiddlewareOptions, type MergedDeepAgentState, type PermissionMode, type ReadRawResult, type ReadResult, type ResolveDeepAgentTypeConfig, type SandboxBackendProtocol, type SandboxBackendProtocolV1, type SandboxBackendProtocolV2, type SandboxDeleteOptions, SandboxError, type SandboxErrorCode, type SandboxGetOrCreateOptions, type SandboxInfo, type SandboxListOptions, type SandboxListResponse, type Settings, type SettingsOptions, type SkillMetadata$1 as SkillMetadata, type SkillsMiddlewareOptions, type StateAndStore, StateBackend, StoreBackend, type StoreBackendContext, type StoreBackendNamespaceFactory, type StoreBackendOptions, type SubAgent, type SubAgentMiddlewareOptions, type SubagentRunStream, type SupportedResponseFormat, TASK_SYSTEM_PROMPT, type WriteResult, adaptBackendProtocol, adaptSandboxProtocol, computeSummarizationDefaults, createAgentMemoryMiddleware, createAsyncSubAgentMiddleware, createCompletionCallbackMiddleware, createDeepAgent, createFilesystemMiddleware, createMemoryMiddleware, createPatchToolCallsMiddleware, createSettings, createSkillsMiddleware, createSubAgentMiddleware, createSubagentTransformer, createSummarizationMiddleware, filesValue, findProjectRoot, isAsyncSubAgent, isSandboxBackend, isSandboxProtocol, listSkills, parseSkillMetadata, resolveBackend };
+export { type AgentMemoryMiddlewareOptions, type AnyBackendProtocol, type AnySubAgent, type AsyncSubAgent, type AsyncSubAgentMiddlewareOptions, type AsyncTask, type AsyncTaskStatus, type BackendFactory, type BackendProtocol, type BackendProtocolV1, type BackendProtocolV2, type BackendRuntime, BaseSandbox, type CompiledSubAgent, type CompletionCallbackOptions, CompositeBackend, ConfigurationError, type ConfigurationErrorCode, type CreateDeepAgentParams, DEFAULT_GENERAL_PURPOSE_DESCRIPTION, DEFAULT_SUBAGENT_PROMPT, type DeepAgent, type DeepAgentRunStream, type DeepAgentTypeConfig, type DefaultDeepAgentTypeConfig, type EditResult, type ExecuteResponse, type ExtractSubAgentMiddleware, type FileData, type FileDownloadResponse, type FileInfo, type FileOperationError, type FileUploadResponse, FilesystemBackend, type FilesystemMiddlewareOptions, type FilesystemOperation, type FilesystemPermission, type FlattenSubAgentMiddleware, GENERAL_PURPOSE_SUBAGENT, type GlobResult, type GrepMatch, type GrepResult, type InferDeepAgentSubagents, type InferDeepAgentType, type InferStructuredResponse, type InferSubAgentMiddlewareStates, type InferSubagentByName, type InferSubagentReactAgentType, type LangSmithCaptureSnapshotOptions, LangSmithSandbox, type LangSmithSandboxCreateOptions, type LangSmithSandboxOptions, type LangSmithSnapshot, type LangSmithStartSandboxOptions, type ListSkillsOptions, type SkillMetadata as LoaderSkillMetadata, LocalShellBackend, type LocalShellBackendOptions, type LsResult, MAX_SKILL_DESCRIPTION_LENGTH, MAX_SKILL_FILE_SIZE, MAX_SKILL_NAME_LENGTH, type MaybePromise, type MemoryMiddlewareOptions, type MergedDeepAgentState, type PermissionMode, type ReadRawResult, type ReadResult, type ResolveDeepAgentTypeConfig, type SandboxBackendProtocol, type SandboxBackendProtocolV1, type SandboxBackendProtocolV2, type SandboxDeleteOptions, SandboxError, type SandboxErrorCode, type SandboxGetOrCreateOptions, type SandboxInfo, type SandboxListOptions, type SandboxListResponse, type Settings, type SettingsOptions, type SkillMetadata$1 as SkillMetadata, type SkillsMiddlewareOptions, type StateAndStore, StateBackend, StoreBackend, type StoreBackendContext, type StoreBackendNamespaceFactory, type StoreBackendOptions, type SubAgent, type SubAgentMiddlewareOptions, type SubagentRunStream, type SupportedResponseFormat, TASK_SYSTEM_PROMPT, type WriteResult, adaptBackendProtocol, adaptSandboxProtocol, computeSummarizationDefaults, createAgentMemoryMiddleware, createAsyncSubAgentMiddleware, createCompletionCallbackMiddleware, createDeepAgent, createFilesystemMiddleware, createMemoryMiddleware, createPatchToolCallsMiddleware, createSettings, createSkillsMiddleware, createSubAgentMiddleware, createSubagentTransformer, createSummarizationMiddleware, filesValue, findProjectRoot, isAsyncSubAgent, isSandboxBackend, isSandboxProtocol, listSkills, parseSkillMetadata, resolveBackend };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -6425,7 +6425,7 @@ var BaseSandbox = class {
 * ```typescript
 * import { LangSmithSandbox, createDeepAgent } from "deepagents";
 *
-* const sandbox = await LangSmithSandbox.create({ templateName: "deepagents-cli" });
+* const sandbox = await LangSmithSandbox.create({ snapshotId: "your-snapshot-id" });
 *
 * const agent = createDeepAgent({ model, backend: sandbox });
 *
@@ -6549,6 +6549,41 @@ var LangSmithSandbox = class LangSmithSandbox extends BaseSandbox {
 		this.#isRunning = false;
 	}
 	/**
+	* Start a stopped sandbox and wait until it is ready.
+	*
+	* After calling this, `isRunning` will be `true` and the sandbox
+	* can be used for command execution and file operations again.
+	*
+	* @param options - Start options (timeout, signal).
+	*/
+	async start(options = {}) {
+		await this.#sandbox.start(options);
+		this.#isRunning = true;
+	}
+	/**
+	* Stop the sandbox without deleting it.
+	*
+	* Sandbox files are preserved and the sandbox can be restarted later
+	* with `start()`. After calling this, `isRunning` will be `false`.
+	*/
+	async stop() {
+		await this.#sandbox.stop();
+		this.#isRunning = false;
+	}
+	/**
+	* Capture a snapshot from this running sandbox.
+	*
+	* Snapshots can be used to create new sandboxes via
+	* `LangSmithSandbox.create({ snapshotId })`.
+	*
+	* @param name - Name for the snapshot.
+	* @param options - Capture options (checkpoint, timeout).
+	* @returns The created Snapshot in "ready" status.
+	*/
+	async captureSnapshot(name, options = {}) {
+		return this.#sandbox.captureSnapshot(name, options);
+	}
+	/**
 	* Create and return a new LangSmithSandbox in one step.
 	*
 	* This is the recommended way to create a sandbox — no need to import
@@ -6556,7 +6591,10 @@ var LangSmithSandbox = class LangSmithSandbox extends BaseSandbox {
 	*
 	* @example
 	* ```typescript
-	* const sandbox = await LangSmithSandbox.create({ templateName: "deepagents" });
+	* const sandbox = await LangSmithSandbox.create({
+	*   snapshotId: "abc-123",
+	* });
+	*
 	* try {
 	*   const agent = createDeepAgent({ model, backend: sandbox });
 	*   await agent.invoke({ messages: [...] });
@@ -6565,10 +6603,14 @@ var LangSmithSandbox = class LangSmithSandbox extends BaseSandbox {
 	* }
 	* ```
 	*/
-	static async create(options = {}) {
-		const { templateName = "deepagents", apiKey = process.env.LANGSMITH_API_KEY, defaultTimeout, ...createSandboxOptions } = options;
+	static async create(options) {
+		const { templateName, apiKey = process.env.LANGSMITH_API_KEY, defaultTimeout, snapshotId, ...createSandboxOptions } = options;
+		if (snapshotId && templateName) throw new Error("snapshotId and templateName are mutually exclusive. Pass only one creation source.");
+		if (!snapshotId && !templateName) throw new Error("Either snapshotId or templateName is required. snapshotId is recommended — template-based creation is deprecated.");
+		const sandboxOptions = { ...createSandboxOptions };
+		if (templateName) sandboxOptions.snapshotName = templateName;
 		return new LangSmithSandbox({
-			sandbox: await new SandboxClient({ apiKey }).createSandbox(templateName, createSandboxOptions),
+			sandbox: await new SandboxClient({ apiKey }).createSandbox(snapshotId, sandboxOptions),
 			defaultTimeout
 		});
 	}