managed-deepagents 0.10.0-dev.17 → 0.10.0-dev.19

package/dist/runtime/browser.d.ts

@@ -0,0 +1,125 @@
+/**
+ * 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. */
+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, 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,EAQL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAE3B,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAyC5D,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;AAsCD,2FAA2F;AAC3F,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GACvC,eAAe,CAkEjB;AAyFD;;;;;;;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;AAuKD,mFAAmF;AACnF,wBAAsB,IAAI,CACxB,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,MAAM,CAAC,CAoBjB;AASD,sFAAsF;AACtF,wBAAgB,UAAU,CACxB,UAAU,EAAE,iBAAiB,GAAG,SAAS,EACzC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,YAAY,GAClB,MAAM,CASR;AAiBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,GAAG,SAAS,GACrC,wBAAwB,GAAG,SAAS,CAKtC;AAmBD,yDAAyD;AACzD,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,IAAI,CAAC,CAOlE"}