deepagents 1.10.0 → 1.10.1

package/dist/index.cjs

@@ -6464,7 +6464,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 });
 *
@@ -6588,6 +6588,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
@@ -6595,7 +6630,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: [...] });
@@ -6604,10 +6642,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 langsmith_experimental_sandbox.SandboxClient({ apiKey }).createSandbox(templateName, createSandboxOptions),
+			sandbox: await new langsmith_experimental_sandbox.SandboxClient({ apiKey }).createSandbox(snapshotId, sandboxOptions),
 			defaultTimeout
 		});
 	}