managed-deepagents 0.9.6-dev.2 → 0.9.6-dev.21

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

@@ -0,0 +1,10 @@
+import type { BrowserDefinition } from "../browser.js";
+import type { DeepAgentDefinition } from "../types.js";
+import type { ManagedAgentOptions } from "./types.js";
+/**
+ * Keep, turn off, or replace `browser.ts`'s browser for this run.
+ *
+ * Eval builds ship no browser, as they ship no nested sandbox.
+ */
+export declare function selectRunBrowser(config: DeepAgentDefinition["config"], options: Pick<ManagedAgentOptions, "browser" | "trialRootDir"> | undefined): BrowserDefinition | undefined;
+//# sourceMappingURL=browser-selection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-selection.d.ts","sourceRoot":"","sources":["../../src/runtime/browser-selection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,EACrC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,cAAc,CAAC,GAAG,SAAS,GACzE,iBAAiB,GAAG,SAAS,CAc/B"}

package/dist/runtime/browser-selection.js

@@ -0,0 +1,21 @@
+import { snapshotBrowserSelection } from "../managed-composition.js";
+/**
+ * Keep, turn off, or replace `browser.ts`'s browser for this run.
+ *
+ * Eval builds ship no browser, as they ship no nested sandbox.
+ */
+export function selectRunBrowser(config, options) {
+    if (options?.trialRootDir)
+        return undefined;
+    const declared = options?.browser;
+    if (!Object.hasOwn(config, "browser") || config.browser === undefined) {
+        return declared;
+    }
+    const selected = snapshotBrowserSelection(config.browser);
+    if (selected !== null && declared === undefined) {
+        throw new Error("The agent factory selected a browser, but the project has no browser.ts. " +
+            "Declare `export const browser = defineBrowser()` there so the deployment installs Stagehand.");
+    }
+    return selected ?? undefined;
+}
+//# sourceMappingURL=browser-selection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-selection.js","sourceRoot":"","sources":["../../src/runtime/browser-selection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAIrE;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAqC,EACrC,OAA0E;IAE1E,IAAI,OAAO,EAAE,YAAY;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,QAAQ,GAAG,OAAO,EAAE,OAAO,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACtE,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,wBAAwB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,2EAA2E;YACzE,8FAA8F,CACjG,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,IAAI,SAAS,CAAC;AAC/B,CAAC"}

package/dist/runtime/browser.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Browser use: Stagehand's TypeScript facade tools on a LangSmith browser.
+ *
+ * A browser per key (`thread:<id>`, or `user:<id>` under user scope). A
+ * thread's own browser has one window, `mda`; a user's has a window per
+ * thread, so their threads share logins but not tabs. Each browser has one
+ * Stagehand client in this process (the extension serves one at a time),
+ * released between runs and after a minute idle so the browser can idle out.
+ *
+ * `browser_handoff` hands the window to the user and returns at once. A run of
+ * the watcher graph, which `mda` builds beside the agent, waits on its own
+ * thread for the user to hand it back, then enqueues a run on the agent's
+ * thread with a notification, as an async subagent tells the agent that
+ * started it that it finished.
+ *
+ * The middleware half of Python's `browser.py`; `browser-langsmith.ts` holds
+ * the LangSmith half. Only projects that declare `browser.ts` import this
+ * module or install Stagehand.
+ */
+import { type LangGraphRunnableConfig } from "@langchain/langgraph";
+import { Client } from "@langchain/langgraph-sdk";
+import { type BackendProtocolV2, type SandboxBackendProtocolV2 } from "deepagents";
+import { type AgentMiddleware } from "langchain";
+import type { BrowserDefinition, BrowserScope } from "../browser.js";
+import { type BrowserHandoffStatus, type PendingBrowserHandoff } from "./browser-langsmith.js";
+import type { ManagedServerInfo } from "./managed-tools.js";
+/** The graph `mda` builds beside the agent, whose run waits out a handoff. */
+export declare const HANDOFF_WATCHER_GRAPH = "mda-browser-handoff";
+/** What tools and hooks read from their runtime; MDA adds `serverInfo` and `backend`. */
+interface BrowserRuntime {
+    configurable?: Record<string, unknown>;
+    serverInfo?: ManagedServerInfo;
+    backend?: BackendProtocolV2;
+    state?: unknown;
+    context?: unknown;
+    toolCallId?: string;
+}
+/**
+ * Give the agent Stagehand's tools, named `browser_run`, `browser_snapshot` and
+ * so on, plus `browser_record` for a video.
+ */
+export declare function createBrowserMiddleware(options: Omit<BrowserDefinition, "kind">): AgentMiddleware;
+/**
+ * Start a run of the watcher graph on a thread of its own, as deepagents starts
+ * an async subagent's task: the thread's metadata names this agent, which the
+ * Agent Server copies into the run, and the run gets this run's context.
+ *
+ * The wait is a run rather than a promise in this process, so the wake-up comes
+ * from a live run, the only caller a deployed graph's Agent Server takes.
+ */
+export declare function startWatcher(client: Client, runtime: BrowserRuntime, handoff: PendingBrowserHandoff): Promise<void>;
+declare const WatcherState: import("@langchain/langgraph").AnnotationRoot<{
+    handoff: import("@langchain/langgraph").LastValue<{
+        browser: string;
+        window_id: string;
+        until: number;
+    }>;
+}>;
+/**
+ * Once the handoff ends, notify the agent that started it, unless it has moved
+ * on: a newer handoff replaced this one, or the agent waits on a person, where
+ * a new run would drop what it waits for. Its browser tools work again either way.
+ */
+export declare function watch(state: typeof WatcherState.State, config: LangGraphRunnableConfig): Promise<Partial<typeof WatcherState.State>>;
+/** The watcher graph: one run per handoff, from `browser_handoff` until it ends. */
+export declare const handoffWatcher: import("@langchain/langgraph").CompiledStateGraph<{
+    handoff: {
+        browser: string;
+        window_id: string;
+        until: number;
+    };
+}, {
+    handoff?: {
+        browser: string;
+        window_id: string;
+        until: number;
+    } | undefined;
+}, "__start__" | "watch", {
+    handoff: import("@langchain/langgraph").LastValue<{
+        browser: string;
+        window_id: string;
+        until: number;
+    }>;
+}, {
+    handoff: import("@langchain/langgraph").LastValue<{
+        browser: string;
+        window_id: string;
+        until: number;
+    }>;
+}, import("@langchain/langgraph").StateDefinition, {
+    watch: Partial<import("@langchain/langgraph").StateType<{
+        handoff: import("@langchain/langgraph").LastValue<{
+            browser: string;
+            window_id: string;
+            until: number;
+        }>;
+    }>>;
+}, unknown, unknown, []>;
+/**
+ * A notification in deepagents' task notification's shape: a user-role message
+ * framed as a system notification. Its `mda_notification` tells clients how the
+ * handoff ended, so they can tell it from the user's message.
+ */
+export declare function wakeMessage(status: BrowserHandoffStatus): {
+    role: string;
+    content: string;
+    additional_kwargs: {
+        mda_notification: {
+            type: string;
+            status: BrowserHandoffStatus;
+        };
+    };
+};
+/** Write `data` to absolute `path` in the agent's sandbox, creating its folder. */
+export declare function save(backend: BackendProtocolV2 | undefined, path: string, data: Uint8Array): Promise<string>;
+/** Under user scope, a person's browser; service principals stand for many people. */
+export declare function browserKey(serverInfo: ManagedServerInfo | undefined, thread: string, scope: BrowserScope): string;
+/**
+ * The run's sandbox once MDA has opened it; the browser never opens one.
+ *
+ * Tools see it through a lazy handle made fresh for each run, so the handle
+ * asks the process whether the box is open.
+ */
+export declare function threadSandbox(backend: BackendProtocolV2 | undefined): SandboxBackendProtocolV2 | undefined;
+/** Close every session and stop its timer, and forget recordings, for tests. */
+export declare function clearBrowserSessionsForTests(): Promise<void>;
+export {};
+//# sourceMappingURL=browser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/runtime/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAYH,OAAO,EAML,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAEL,KAAK,iBAAiB,EAEtB,KAAK,wBAAwB,EAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAUrE,OAAO,EAcL,KAAK,oBAAoB,EAEzB,KAAK,qBAAqB,EAE3B,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAmE5D,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AAS3D,yFAAyF;AACzF,UAAU,cAAc;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAoDD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GACvC,eAAe,CAoEjB;AA6FD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,QAAA,MAAM,YAAY;;;;;;EAEhB,CAAC;AAEH;;;;GAIG;AACH,wBAAsB,KAAK,CACzB,KAAK,EAAE,OAAO,YAAY,CAAC,KAAK,EAChC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,OAAO,CAAC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CA0B7C;AAED,oFAAoF;AACpF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAIf,CAAC;AA2Db;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,oBAAoB;;;;;;;;;EAQvD;AAqVD,mFAAmF;AACnF,wBAAsB,IAAI,CACxB,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAOD,sFAAsF;AACtF,wBAAgB,UAAU,CACxB,UAAU,EAAE,iBAAiB,GAAG,SAAS,EACzC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,YAAY,GAClB,MAAM,CASR;AAkBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,GAAG,SAAS,GACrC,wBAAwB,GAAG,SAAS,CAKtC;AAmBD,gFAAgF;AAChF,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,IAAI,CAAC,CAQlE"}