managed-deepagents 0.10.0-dev.9 → 0.10.0

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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"}