managed-deepagents 0.9.6-dev.3 → 0.9.6-dev.31

package/dist/runtime/backend.js

@@ -9,7 +9,7 @@ import { createHash } from "node:crypto";
 import { posix as posixPath } from "node:path";
 import { resolveSandboxProxyConfig } from "../sandbox-proxy.js";
 import { resolveRuntimeConfigurable } from "./identity-runtime.js";
-import { managedSandboxHostName, recoverManagedSandbox, isSandboxNotFoundError, resolveManagedSandbox, sandboxScopeKey, updateManagedSandboxProxyConfig, } from "./sandbox-manager.js";
+import { managedSandboxHostName, recoverManagedSandbox, withLeadSandbox, isSandboxNotFoundError, openedManagedSandbox, resolveManagedSandbox, sandboxScopeKey, updateManagedSandboxProxyConfig, } from "./sandbox-manager.js";
 /**
  * Refusal returned instead of globbing the sandbox root.
  *
@@ -37,6 +37,10 @@ function isFilesystemRoot(path) {
     }
     return posixPath.normalize(raw) === "/";
 }
+/** The run's sandbox scope: its lead's, for an async subagent sharing it. */
+function scopeKey(deps, config) {
+    return withLeadSandbox(deps.leadThread, () => sandboxScopeKey(config, deps.sandboxSelection));
+}
 /**
  * Process-scoped resolve cache shared by all {@link LazyManagedSandboxBackend}
  * instances created from the same factory (unbound + per-run siblings).
@@ -45,12 +49,17 @@ class SandboxResolveCache {
     pendingByScope = new Map();
     resolvedByScope = new Map();
     sandboxProxyConfigHashes = new WeakMap();
-    idFor(config, selectionFingerprint) {
-        return (this.resolvedByScope.get(sandboxScopeKey(config, selectionFingerprint))
-            ?.id ?? "");
+    idFor(deps, config) {
+        return this.resolvedFor(deps, config)?.id ?? "";
+    }
+    resolvedFor(deps, config) {
+        return this.resolvedByScope.get(scopeKey(deps, config));
     }
     resolve(deps, config) {
-        const key = sandboxScopeKey(config, deps.sandboxSelectionFingerprint);
+        return withLeadSandbox(deps.leadThread, () => this.resolveInScope(deps, config));
+    }
+    resolveInScope(deps, config) {
+        const key = sandboxScopeKey(config, deps.sandboxSelection);
         const existing = this.pendingByScope.get(key);
         if (existing) {
             return existing;
@@ -58,7 +67,7 @@ class SandboxResolveCache {
         const pending = resolveManagedSandbox(deps.sandbox, config, {
             connectors: deps.connectors === undefined ? undefined : [...deps.connectors],
             identity: deps.identity,
-            selectionFingerprint: deps.sandboxSelectionFingerprint,
+            selection: deps.sandboxSelection,
         }).then((backend) => {
             const managed = backend;
             this.resolvedByScope.set(key, managed);
@@ -79,12 +88,13 @@ class SandboxResolveCache {
             return await operation(backend);
         }
         catch (error) {
-            if (isSandboxNotFoundError(error)) {
-                const key = sandboxScopeKey(config, deps.sandboxSelectionFingerprint);
+            // Only the lead recovers its sandbox.
+            if (isSandboxNotFoundError(error) && !deps.leadThread) {
+                const key = sandboxScopeKey(config, deps.sandboxSelection);
                 await recoverManagedSandbox(deps.sandbox, config, backend, {
                     connectors: deps.connectors === undefined ? undefined : [...deps.connectors],
                     identity: deps.identity,
-                    selectionFingerprint: deps.sandboxSelectionFingerprint,
+                    selection: deps.sandboxSelection,
                 })
                     .then((recovered) => {
                     if (this.resolvedByScope.get(key) === backend) {
@@ -137,16 +147,31 @@ export class LazyManagedSandboxBackend {
         // must not crash CompositeBackend construction.
         try {
             const config = this.runConfig();
-            const resolved = this.cache.idFor(config, this.deps.sandboxSelectionFingerprint);
+            const resolved = this.cache.idFor(this.deps, config);
             if (resolved) {
                 return resolved;
             }
-            return `pending:${sandboxScopeKey(config, this.deps.sandboxSelectionFingerprint)}`;
+            return `pending:${scopeKey(this.deps, config)}`;
         }
         catch {
             return "pending:sandbox";
         }
     }
+    /**
+     * This thread's sandbox if this process opened it, through any handle.
+     * Never opens one, and is `undefined` when the run has no thread id.
+     */
+    opened() {
+        try {
+            const config = this.runConfig();
+            const selection = this.deps.sandboxSelection;
+            return (this.cache.resolvedFor(this.deps, config) ??
+                withLeadSandbox(this.deps.leadThread, () => openedManagedSandbox(config, selection)));
+        }
+        catch {
+            return undefined;
+        }
+    }
     async ls(path = "/") {
         return this.withBackend((backend) => backend.ls(path));
     }

package/dist/runtime/backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/runtime/backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/runtime/backend.ts"],"names":[],"mappings":"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"}

package/dist/runtime/browser-facade.d.ts

@@ -0,0 +1,10 @@
+export { CodeModeRunInputSchema, FACADE_AGENT_INSTRUCTIONS, FACADE_TOOLS, StagehandFacadeExecutionError, StagehandFacadeInputError, StagehandFacadeTools, } from "stagehand-middleware";
+export type { RefAction } from "stagehand-middleware";
+/**
+ * Redact credentials from an error message before the model sees it. Python
+ * imports this from `stagehand_middleware.facade.tools`; the npm package does
+ * not export it, so this copies browserbase/stagehand's
+ * `packages/integrations/core/src/harness/redact.ts` (MIT).
+ */
+export declare function sanitizeErrorMessage(message: string): string;
+//# sourceMappingURL=browser-facade.d.ts.map

package/dist/runtime/browser-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-facade.d.ts","sourceRoot":"","sources":["../../src/runtime/browser-facade.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,YAAY,EACZ,6BAA6B,EAC7B,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoB5D"}

package/dist/runtime/browser-facade.js

@@ -0,0 +1,23 @@
+// Stagehand's TypeScript facade, from npm's `stagehand-middleware`: the same
+// tools, schemas and instructions Python takes from PyPI's `stagehand-middleware`.
+export { CodeModeRunInputSchema, FACADE_AGENT_INSTRUCTIONS, FACADE_TOOLS, StagehandFacadeExecutionError, StagehandFacadeInputError, StagehandFacadeTools, } from "stagehand-middleware";
+/**
+ * Redact credentials from an error message before the model sees it. Python
+ * imports this from `stagehand_middleware.facade.tools`; the npm package does
+ * not export it, so this copies browserbase/stagehand's
+ * `packages/integrations/core/src/harness/redact.ts` (MIT).
+ */
+export function sanitizeErrorMessage(message) {
+    return (message
+        // Credential-bearing URL query parameters.
+        .replace(/([?&](?:signingKey|apiKey|api_key|token|key)=)[^&\s"']+/gi, "$1[redacted]")
+        // OpenAI-style secret keys.
+        .replace(/\b(sk-[A-Za-z0-9_-]{6})[A-Za-z0-9_-]+/g, "$1[redacted]")
+        // Browserbase live and test keys.
+        .replace(/\b(bb_(?:live|test)_[A-Za-z0-9]{4})[A-Za-z0-9_-]+/g, "$1[redacted]")
+        // Google API keys.
+        .replace(/\bAIza[0-9A-Za-z_-]{30,}/g, "AIza[redacted]")
+        // Bearer authorization values.
+        .replace(/\b(Bearer\s+)[A-Za-z0-9._~+/=-]{8,}/gi, "$1[redacted]"));
+}
+//# sourceMappingURL=browser-facade.js.map

package/dist/runtime/browser-facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-facade.js","sourceRoot":"","sources":["../../src/runtime/browser-facade.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,mFAAmF;AAEnF,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,YAAY,EACZ,6BAA6B,EAC7B,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO,CACL,OAAO;QACL,2CAA2C;SAC1C,OAAO,CACN,2DAA2D,EAC3D,cAAc,CACf;QACD,4BAA4B;SAC3B,OAAO,CAAC,wCAAwC,EAAE,cAAc,CAAC;QAClE,kCAAkC;SACjC,OAAO,CACN,oDAAoD,EACpD,cAAc,CACf;QACD,mBAAmB;SAClB,OAAO,CAAC,2BAA2B,EAAE,gBAAgB,CAAC;QACvD,+BAA+B;SAC9B,OAAO,CAAC,uCAAuC,EAAE,cAAc,CAAC,CACpE,CAAC;AACJ,CAAC"}

package/dist/runtime/browser-langsmith.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Browser use, the LangSmith side: create a key's browser, put Stagehand's
+ * extension on it, connect Stagehand to one of its windows, and run the
+ * recorder beside Chrome.
+ *
+ * The LangSmith half of Python's `browser.py`, kept apart from the middleware
+ * (`browser.ts`) so its tests can stand in for it, as Python's do for `_open`
+ * and `_share_localhost`.
+ */
+import { Stagehand, type BrowserContext, type Page } from "@browserbasehq/stagehand";
+import type { SandboxBackendProtocolV2 } from "deepagents";
+import { SandboxClient, type Sandbox } from "langsmith/sandbox";
+import { z } from "zod";
+import { StagehandFacadeTools } from "./browser-facade.js";
+/** The client and the browser's extension must match; `mda` pins this in deployments. */
+export declare const STAGEHAND_VERSION = "4.3.0";
+export declare const HANDOFF_LINK_TTL_S = 900;
+export interface Session {
+    readonly window: string;
+    readonly browser: string;
+    readonly stagehand: Stagehand;
+    readonly tools: StagehandFacadeTools;
+    readonly artifacts: string;
+    readonly transport: {
+        close(): void;
+    } | undefined;
+    closing: boolean;
+    shared: SandboxBackendProtocolV2 | undefined;
+    readonly localUrl: string;
+}
+declare const StopReply: z.ZodObject<{
+    seconds: z.ZodNumber;
+    early: z.ZodString;
+    summary: z.ZodString;
+}, z.core.$strip>;
+/** A take the recorder saved, as it comes back from the browser's sandbox. */
+export interface Finished extends z.infer<typeof StopReply> {
+    video: Uint8Array;
+    timeline: Uint8Array;
+    first: Uint8Array;
+    last: Uint8Array;
+}
+/** The recorder's own failure, in the browser's sandbox: the client is fine. */
+export declare class RecorderError extends Error {
+}
+type Box = Pick<Sandbox, "run" | "read" | "write">;
+export type BrowsersApi = ReturnType<typeof browsersApi>;
+/**
+ * How a handoff ended: `handed_back` when the user hands the window back;
+ * `ended` when the handoff's link ran out, or its browser or window is gone.
+ */
+export type BrowserHandoffStatus = "handed_back" | "ended";
+/** A handoff that waits on the user, in the thread's state. */
+export declare const PendingBrowserHandoffSchema: z.ZodObject<{
+    browser: z.ZodString;
+    window_id: z.ZodString;
+    until: z.ZodNumber;
+}, z.core.$strip>;
+export type PendingBrowserHandoff = z.infer<typeof PendingBrowserHandoffSchema>;
+export declare function closeSession(session: Session): Promise<void>;
+/**
+ * `key`'s browser, under the deployment's prefix like its sandboxes.
+ *
+ * A later `generation` replaces a browser that is being deleted or broke.
+ */
+export declare function browserName(key: string, generation?: number): string;
+/**
+ * `key`'s browser, created or started as needed, and its sandbox.
+ *
+ * A browser that is being deleted, or broke, can't be used or recreated under
+ * its name, so `key` moves on to its next generation.
+ */
+export declare function usableBrowser(api: BrowsersApi, boxes: Pick<SandboxClient, "getSandbox" | "startSandbox">, key: string, idleTtlSeconds: number): Promise<{
+    name: string;
+    box: Sandbox;
+}>;
+/** LangSmith's sandboxes API, and its headers: the key, and the workspace if set. */
+export declare function browsersApi(): {
+    url: string;
+    headers: {
+        "X-Api-Key": string;
+        "X-Tenant-Id"?: string | undefined;
+    };
+};
+/** LangSmith's API. */
+export declare function endpoint(): string;
+/**
+ * Attach Stagehand to a window of `key`'s browser, creating either as needed.
+ *
+ * The client reaches Chrome through the API's CDP proxy; the extension, inside
+ * the browser sandbox, dials the window's local port. A window the user still
+ * holds from an ended handoff is taken back.
+ */
+export declare function openSession(key: string, windowName: string, idleTtlSeconds: number, onCloseRequested: () => Promise<void>): Promise<Session>;
+/**
+ * Give the user `key`'s window, creating either as needed.
+ *
+ * Returns the browser's name, the window's id, and a short-lived link the user
+ * drives it with.
+ */
+export declare function handOver(key: string, windowName: string, idleTtlSeconds: number): Promise<{
+    browser: string;
+    windowId: string;
+    url: string;
+}>;
+/** How the handoff ended, or `undefined` while the user still has the window. */
+export declare function handoffStatus(pending: PendingBrowserHandoff): Promise<BrowserHandoffStatus | undefined>;
+/**
+ * Origins whose pages may frame a handoff's window: the LangSmith UI, plus any
+ * in `MDA_BROWSER_EMBED_ORIGINS` (comma-separated), such as a UI preview build.
+ */
+export declare function embedOrigins(api: BrowsersApi): Promise<string[]>;
+/**
+ * Let browser `name` open `sandbox`'s servers at `http://localhost:<port>`.
+ *
+ * One window attached with `share_localhost` serves the whole browser. A
+ * sandbox MDA replaced under the same name keeps the window's `sandbox` but not
+ * its id, so the window is checked by the id its `localhost_alias` names.
+ */
+export declare function shareLocalhost(name: string, sandbox: string): Promise<void>;
+/** The browser's host for a sandbox's localhost: `sb-` and its id in base32. */
+export declare function localhostAlias(sandboxId: string): string;
+export declare function connect(window: string, browser: string, cdpUrl: string, localUrl: string, headers: Record<string, string>, onCloseRequested: () => Promise<void>): Promise<Session>;
+/** The window's newest tab, as it was: the client's CDP lists only its window's. */
+export declare function newestTab(context: BrowserContext): Promise<Page>;
+/** Browser `name`'s sandbox, where the recorder runs. */
+export declare function browserBox(name: string): Promise<Sandbox>;
+/**
+ * Start recording `tab` of the window at `localUrl`, beside Chrome in `box`.
+ *
+ * Returns the take's folder there. The recorder follows newer tabs itself, and
+ * records until it is stopped or reaches its limit, whatever happens to this
+ * process's client.
+ */
+export declare function startTake(box: Box, localUrl: string, tab: string): Promise<string>;
+/** Stop the take in `folder`, wait while the recorder encodes it, and download it. */
+export declare function stopTake(box: Box, folder: string): Promise<Finished>;
+/** `text` quoted for a POSIX shell, as Python's `shlex.quote` does. */
+export declare function shellQuote(text: string): string;
+/** Unpack the client's own extension into the browser, unless it is there already. */
+export declare function installExtension(box: Sandbox): Promise<void>;
+export {};
+//# sourceMappingURL=browser-langsmith.d.ts.map

package/dist/runtime/browser-langsmith.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-langsmith.d.ts","sourceRoot":"","sources":["../../src/runtime/browser-langsmith.ts"],"names":[],"mappings":"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"}