@mastra/server 1.22.0-alpha.1 → 1.22.0-alpha.3

package/dist/server/browser-stream/types.d.ts

@@ -0,0 +1,110 @@
+import type { MastraBrowser } from '@mastra/core/browser';
+/**
+ * Status message sent to connected viewers.
+ * Indicates the current state of the browser stream.
+ */
+export interface StatusMessage {
+    status: 'connected' | 'browser_starting' | 'streaming' | 'browser_closed';
+}
+/**
+ * Error message sent to connected viewers when something goes wrong.
+ */
+export interface ErrorMessage {
+    error: 'browser_crashed' | 'screencast_failed' | 'auth_failed';
+    message: string;
+}
+/**
+ * Configuration for the browser stream WebSocket setup.
+ */
+export interface BrowserStreamConfig {
+    /**
+     * Function to retrieve the BrowserToolset for a given agent ID.
+     * Returns undefined if no browser is available for this agent.
+     */
+    getToolset: (agentId: string) => MastraBrowser | undefined;
+}
+/**
+ * Mouse input message from client to server.
+ * Client sends these when user interacts with the live view frame.
+ */
+export interface MouseInputMessage {
+    type: 'mouse';
+    /** CDP mouse event type */
+    eventType: 'mousePressed' | 'mouseReleased' | 'mouseMoved' | 'mouseWheel';
+    /** X coordinate in browser viewport pixels */
+    x: number;
+    /** Y coordinate in browser viewport pixels */
+    y: number;
+    /** Mouse button */
+    button?: 'left' | 'right' | 'middle' | 'none';
+    /** Click count (1 for single, 2 for double) */
+    clickCount?: number;
+    /** Horizontal scroll delta (for mouseWheel) */
+    deltaX?: number;
+    /** Vertical scroll delta (for mouseWheel) */
+    deltaY?: number;
+    /** CDP modifier bitmask (1=Alt, 2=Ctrl, 4=Meta, 8=Shift) */
+    modifiers?: number;
+}
+/**
+ * Keyboard input message from client to server.
+ * Client sends these when user types in the live view.
+ */
+export interface KeyboardInputMessage {
+    type: 'keyboard';
+    /** CDP keyboard event type */
+    eventType: 'keyDown' | 'keyUp' | 'char';
+    /** Key value (e.g., 'a', 'Enter', 'ArrowLeft') */
+    key?: string;
+    /** Physical key code (e.g., 'KeyA', 'Enter') */
+    code?: string;
+    /** Text to insert (for printable characters in 'char' events) */
+    text?: string;
+    /** CDP modifier bitmask (1=Alt, 2=Ctrl, 4=Meta, 8=Shift) */
+    modifiers?: number;
+}
+/**
+ * Union type for all client-to-server input messages.
+ * Discriminated by the `type` field.
+ */
+export type ClientInputMessage = MouseInputMessage | KeyboardInputMessage;
+/**
+ * Viewport metadata message sent from server to client.
+ * Sent on stream start and when viewport dimensions change.
+ * Client uses this to map click coordinates from scaled frame to browser viewport.
+ */
+export interface ViewportMessage {
+    viewport: {
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Framework-agnostic WebSocket interface for browser streaming.
+ * Server adapters implement this to wrap their framework's WebSocket.
+ */
+export interface BrowserStreamWebSocket {
+    /** Send a string message to the client */
+    send(data: string): void;
+}
+/**
+ * Result from setting up browser streaming.
+ */
+export interface BrowserStreamResult {
+    /** The viewer registry managing connections */
+    registry: ViewerRegistryLike;
+    /**
+     * Function to inject WebSocket support into the server.
+     * Called after server.listen() for frameworks that require it (e.g., @hono/node-ws).
+     */
+    injectWebSocket?: (server: unknown) => void;
+}
+/**
+ * Minimal interface for ViewerRegistry that adapters interact with.
+ */
+export interface ViewerRegistryLike {
+    addViewer(viewerKey: string, ws: BrowserStreamWebSocket, getToolset: BrowserStreamConfig['getToolset'], agentId?: string, threadId?: string): Promise<void>;
+    removeViewer(viewerKey: string, ws: BrowserStreamWebSocket): Promise<void>;
+    closeBrowserSession(viewerKey: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/browser-stream/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server/browser-stream/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,GAAG,kBAAkB,GAAG,WAAW,GAAG,gBAAgB,CAAC;CAC3E;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,aAAa,CAAC;IAC/D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;CAC5D;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,2BAA2B;IAC3B,SAAS,EAAE,cAAc,GAAG,eAAe,GAAG,YAAY,GAAG,YAAY,CAAC;IAC1E,8CAA8C;IAC9C,CAAC,EAAE,MAAM,CAAC;IACV,8CAA8C;IAC9C,CAAC,EAAE,MAAM,CAAC;IACV,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,8BAA8B;IAC9B,SAAS,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IACxC,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAE1E;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,QAAQ,EAAE,kBAAkB,CAAC;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,sBAAsB,EAC1B,UAAU,EAAE,mBAAmB,CAAC,YAAY,CAAC,EAC7C,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD"}

package/dist/server/browser-stream/viewer-registry.d.ts

@@ -0,0 +1,132 @@
+import type { StatusMessage, BrowserStreamConfig, BrowserStreamWebSocket, ViewerRegistryLike } from './types.js';
+/**
+ * ViewerRegistry manages WebSocket connections per agent and controls screencast lifecycle.
+ *
+ * Key responsibilities:
+ * - Track connected viewers per agentId
+ * - Start screencast when browser becomes active (not on viewer connect)
+ * - Stop screencast when last viewer disconnects
+ * - Broadcast frames to all viewers for an agent
+ *
+ * The browser is NOT launched when viewers connect - it only starts streaming
+ * when the browser is already running from agent tool usage.
+ *
+ * @example
+ * ```typescript
+ * const registry = new ViewerRegistry();
+ *
+ * // When a viewer connects
+ * registry.addViewer('agent-123', ws, getToolset);
+ *
+ * // When a viewer disconnects
+ * registry.removeViewer('agent-123', ws);
+ * ```
+ */
+export declare class ViewerRegistry implements ViewerRegistryLike {
+    /** Map of agentId to set of connected WebSocket contexts */
+    private viewers;
+    /** Map of agentId to active screencast stream */
+    private screencasts;
+    /** Set of viewerKeys currently starting a screencast (to prevent race conditions) */
+    private startingScreencasts;
+    /** Map of agentId to cleanup function for onBrowserReady callback */
+    private browserReadyCleanups;
+    /** Map of agentId to cleanup function for onBrowserClosed callback */
+    private browserClosedCleanups;
+    /** Map of agentId to last known URL (for dedup) */
+    private lastUrls;
+    /** Map of agentId to last known viewport dimensions (for change detection) */
+    private lastViewports;
+    /** Map of viewerKey to last broadcast status (for replay to new viewers) */
+    private lastStatuses;
+    /**
+     * Add a viewer for an agent. Starts screencast if this is the first viewer.
+     *
+     * @param viewerKey - The viewer key (agentId or agentId:threadId for thread-scoped)
+     * @param ws - The WebSocket context for this viewer
+     * @param getToolset - Function to retrieve the BrowserToolset for this agent
+     * @param agentId - The actual agent ID for toolset lookup (optional, defaults to viewerKey)
+     * @param threadId - The thread ID for thread-scoped screencasts (optional)
+     */
+    addViewer(viewerKey: string, ws: BrowserStreamWebSocket, getToolset: BrowserStreamConfig['getToolset'], agentId?: string, threadId?: string): Promise<void>;
+    /**
+     * Send current state (URL, viewport) to a newly connected viewer.
+     */
+    private sendCurrentState;
+    /**
+     * Remove a viewer. Stops screencast if this was the last viewer.
+     *
+     * @param viewerKey - The viewer key (agentId or agentId:threadId for thread-scoped)
+     * @param ws - The WebSocket context to remove
+     */
+    removeViewer(viewerKey: string, ws: BrowserStreamWebSocket): Promise<void>;
+    /**
+     * Broadcast a binary frame to all viewers.
+     *
+     * @param viewerKey - The viewer key (agentId or agentId:threadId for thread-scoped)
+     * @param data - The binary frame data (base64 encoded)
+     */
+    broadcastFrame(viewerKey: string, data: string): void;
+    /**
+     * Broadcast a status message to all viewers.
+     *
+     * @param viewerKey - The viewer key (agentId or agentId:threadId for thread-scoped)
+     * @param status - The status message to send
+     */
+    broadcastStatus(viewerKey: string, status: StatusMessage): void;
+    /**
+     * Broadcast a URL update to all viewers (only if changed).
+     */
+    private broadcastUrlIfChanged;
+    /**
+     * Broadcast viewport metadata to all viewers.
+     * Only sends if dimensions have changed from last broadcast.
+     * Called on stream start and on each frame to detect dimension changes.
+     */
+    private broadcastViewportIfChanged;
+    /**
+     * Start screencast for a viewer. Only starts if browser is already running.
+     * If browser not running, registers a callback to start when browser becomes ready.
+     *
+     * @param viewerKey - The viewer key (for registry keying)
+     * @param getToolset - Function to retrieve the BrowserToolset
+     * @param agentId - The actual agent ID for toolset lookup
+     * @param threadId - The thread ID for thread-scoped page selection (optional)
+     */
+    private startScreencast;
+    /**
+     * Internal method to actually start the screencast stream.
+     *
+     * @param viewerKey - The viewer key (for registry keying and logging)
+     * @param toolset - The browser toolset
+     * @param threadId - The thread ID for thread-scoped page selection (optional)
+     */
+    private doStartScreencast;
+    /**
+     * Stop screencast for an agent. Called when last viewer disconnects.
+     */
+    private stopScreencast;
+    /**
+     * Get the number of viewers for an agent.
+     *
+     * @param agentId - The agent ID
+     * @returns The number of connected viewers
+     */
+    getViewerCount(agentId: string): number;
+    /**
+     * Check if an agent has an active screencast.
+     *
+     * @param agentId - The agent ID
+     * @returns True if screencast is active
+     */
+    hasActiveScreencast(agentId: string): boolean;
+    /**
+     * Close the browser session for an agent.
+     * Stops screencast and broadcasts browser_closed status.
+     * Call this before calling toolset.close() to ensure UI is notified.
+     *
+     * @param viewerKey - The viewer key (agentId or agentId:threadId for thread-scoped)
+     */
+    closeBrowserSession(viewerKey: string): Promise<void>;
+}
+//# sourceMappingURL=viewer-registry.d.ts.map

package/dist/server/browser-stream/viewer-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-registry.d.ts","sourceRoot":"","sources":["../../../src/server/browser-stream/viewer-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EAEnB,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAWpB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,cAAe,YAAW,kBAAkB;IACvD,4DAA4D;IAC5D,OAAO,CAAC,OAAO,CAAkD;IAEjE,iDAAiD;IACjD,OAAO,CAAC,WAAW,CAA2C;IAE9D,qFAAqF;IACrF,OAAO,CAAC,mBAAmB,CAAqB;IAEhD,qEAAqE;IACrE,OAAO,CAAC,oBAAoB,CAAiC;IAE7D,sEAAsE;IACtE,OAAO,CAAC,qBAAqB,CAAiC;IAE9D,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAA6B;IAE7C,8EAA8E;IAC9E,OAAO,CAAC,aAAa,CAAwD;IAE7E,4EAA4E;IAC5E,OAAO,CAAC,YAAY,CAA6B;IAEjD;;;;;;;;OAQG;IACG,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,sBAAsB,EAC1B,UAAU,EAAE,mBAAmB,CAAC,YAAY,CAAC,EAC7C,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IAqBhB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;;;;OAKG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BhF;;;;;OAKG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAgBrD;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI;IAqB/D;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAsBlC;;;;;;;;OAQG;YACW,eAAe;IAgE7B;;;;;;OAMG;YACW,iBAAiB;IAgF/B;;OAEG;YACW,cAAc;IAe5B;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIvC;;;;;OAKG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI7C;;;;;;OAMG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA6B5D"}

package/dist/server/handlers/a2a.cjs

@@ -1,40 +1,40 @@
 'use strict';
 
-var chunkNAQDQGBB_cjs = require('../../chunk-NAQDQGBB.cjs');
+var chunkQG3XGBW4_cjs = require('../../chunk-QG3XGBW4.cjs');
 
 
 
 Object.defineProperty(exports, "AGENT_EXECUTION_ROUTE", {
   enumerable: true,
-  get: function () { return chunkNAQDQGBB_cjs.AGENT_EXECUTION_ROUTE; }
+  get: function () { return chunkQG3XGBW4_cjs.AGENT_EXECUTION_ROUTE; }
 });
 Object.defineProperty(exports, "GET_AGENT_CARD_ROUTE", {
   enumerable: true,
-  get: function () { return chunkNAQDQGBB_cjs.GET_AGENT_CARD_ROUTE; }
+  get: function () { return chunkQG3XGBW4_cjs.GET_AGENT_CARD_ROUTE; }
 });
 Object.defineProperty(exports, "getAgentCardByIdHandler", {
   enumerable: true,
-  get: function () { return chunkNAQDQGBB_cjs.getAgentCardByIdHandler; }
+  get: function () { return chunkQG3XGBW4_cjs.getAgentCardByIdHandler; }
 });
 Object.defineProperty(exports, "getAgentExecutionHandler", {
   enumerable: true,
-  get: function () { return chunkNAQDQGBB_cjs.getAgentExecutionHandler; }
+  get: function () { return chunkQG3XGBW4_cjs.getAgentExecutionHandler; }
 });
 Object.defineProperty(exports, "handleMessageSend", {
   enumerable: true,
-  get: function () { return chunkNAQDQGBB_cjs.handleMessageSend; }
+  get: function () { return chunkQG3XGBW4_cjs.handleMessageSend; }
 });
 Object.defineProperty(exports, "handleMessageStream", {
   enumerable: true,
-  get: function () { return chunkNAQDQGBB_cjs.handleMessageStream; }
+  get: function () { return chunkQG3XGBW4_cjs.handleMessageStream; }
 });
 Object.defineProperty(exports, "handleTaskCancel", {
   enumerable: true,
-  get: function () { return chunkNAQDQGBB_cjs.handleTaskCancel; }
+  get: function () { return chunkQG3XGBW4_cjs.handleTaskCancel; }
 });
 Object.defineProperty(exports, "handleTaskGet", {
   enumerable: true,
-  get: function () { return chunkNAQDQGBB_cjs.handleTaskGet; }
+  get: function () { return chunkQG3XGBW4_cjs.handleTaskGet; }
 });
 //# sourceMappingURL=a2a.cjs.map
 //# sourceMappingURL=a2a.cjs.map

package/dist/server/handlers/a2a.js

@@ -1,3 +1,3 @@
-export { AGENT_EXECUTION_ROUTE, GET_AGENT_CARD_ROUTE, getAgentCardByIdHandler, getAgentExecutionHandler, handleMessageSend, handleMessageStream, handleTaskCancel, handleTaskGet } from '../../chunk-ZPVDK5G4.js';
+export { AGENT_EXECUTION_ROUTE, GET_AGENT_CARD_ROUTE, getAgentCardByIdHandler, getAgentExecutionHandler, handleMessageSend, handleMessageStream, handleTaskCancel, handleTaskGet } from '../../chunk-3JK4VWZ5.js';
 //# sourceMappingURL=a2a.js.map
 //# sourceMappingURL=a2a.js.map

package/dist/server/handlers/agent-builder.cjs

@@ -1,68 +1,68 @@
 'use strict';
 
-var chunk63O6VEOH_cjs = require('../../chunk-63O6VEOH.cjs');
+var chunkJLAFCQZI_cjs = require('../../chunk-JLAFCQZI.cjs');
 
 
 
 Object.defineProperty(exports, "CANCEL_AGENT_BUILDER_ACTION_RUN_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.CANCEL_AGENT_BUILDER_ACTION_RUN_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.CANCEL_AGENT_BUILDER_ACTION_RUN_ROUTE; }
 });
 Object.defineProperty(exports, "CREATE_AGENT_BUILDER_ACTION_RUN_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.CREATE_AGENT_BUILDER_ACTION_RUN_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.CREATE_AGENT_BUILDER_ACTION_RUN_ROUTE; }
 });
 Object.defineProperty(exports, "GET_AGENT_BUILDER_ACTION_BY_ID_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.GET_AGENT_BUILDER_ACTION_BY_ID_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.GET_AGENT_BUILDER_ACTION_BY_ID_ROUTE; }
 });
 Object.defineProperty(exports, "GET_AGENT_BUILDER_ACTION_RUN_BY_ID_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.GET_AGENT_BUILDER_ACTION_RUN_BY_ID_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.GET_AGENT_BUILDER_ACTION_RUN_BY_ID_ROUTE; }
 });
 Object.defineProperty(exports, "LIST_AGENT_BUILDER_ACTIONS_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.LIST_AGENT_BUILDER_ACTIONS_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.LIST_AGENT_BUILDER_ACTIONS_ROUTE; }
 });
 Object.defineProperty(exports, "LIST_AGENT_BUILDER_ACTION_RUNS_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.LIST_AGENT_BUILDER_ACTION_RUNS_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.LIST_AGENT_BUILDER_ACTION_RUNS_ROUTE; }
 });
 Object.defineProperty(exports, "OBSERVE_STREAM_AGENT_BUILDER_ACTION_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.OBSERVE_STREAM_AGENT_BUILDER_ACTION_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.OBSERVE_STREAM_AGENT_BUILDER_ACTION_ROUTE; }
 });
 Object.defineProperty(exports, "OBSERVE_STREAM_LEGACY_AGENT_BUILDER_ACTION_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.OBSERVE_STREAM_LEGACY_AGENT_BUILDER_ACTION_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.OBSERVE_STREAM_LEGACY_AGENT_BUILDER_ACTION_ROUTE; }
 });
 Object.defineProperty(exports, "RESUME_AGENT_BUILDER_ACTION_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.RESUME_AGENT_BUILDER_ACTION_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.RESUME_AGENT_BUILDER_ACTION_ROUTE; }
 });
 Object.defineProperty(exports, "RESUME_ASYNC_AGENT_BUILDER_ACTION_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.RESUME_ASYNC_AGENT_BUILDER_ACTION_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.RESUME_ASYNC_AGENT_BUILDER_ACTION_ROUTE; }
 });
 Object.defineProperty(exports, "RESUME_STREAM_AGENT_BUILDER_ACTION_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.RESUME_STREAM_AGENT_BUILDER_ACTION_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.RESUME_STREAM_AGENT_BUILDER_ACTION_ROUTE; }
 });
 Object.defineProperty(exports, "START_AGENT_BUILDER_ACTION_RUN_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.START_AGENT_BUILDER_ACTION_RUN_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.START_AGENT_BUILDER_ACTION_RUN_ROUTE; }
 });
 Object.defineProperty(exports, "START_ASYNC_AGENT_BUILDER_ACTION_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.START_ASYNC_AGENT_BUILDER_ACTION_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.START_ASYNC_AGENT_BUILDER_ACTION_ROUTE; }
 });
 Object.defineProperty(exports, "STREAM_AGENT_BUILDER_ACTION_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.STREAM_AGENT_BUILDER_ACTION_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.STREAM_AGENT_BUILDER_ACTION_ROUTE; }
 });
 Object.defineProperty(exports, "STREAM_LEGACY_AGENT_BUILDER_ACTION_ROUTE", {
   enumerable: true,
-  get: function () { return chunk63O6VEOH_cjs.STREAM_LEGACY_AGENT_BUILDER_ACTION_ROUTE; }
+  get: function () { return chunkJLAFCQZI_cjs.STREAM_LEGACY_AGENT_BUILDER_ACTION_ROUTE; }
 });
 //# sourceMappingURL=agent-builder.cjs.map
 //# sourceMappingURL=agent-builder.cjs.map

package/dist/server/handlers/agent-builder.js

@@ -1,3 +1,3 @@
-export { CANCEL_AGENT_BUILDER_ACTION_RUN_ROUTE, CREATE_AGENT_BUILDER_ACTION_RUN_ROUTE, GET_AGENT_BUILDER_ACTION_BY_ID_ROUTE, GET_AGENT_BUILDER_ACTION_RUN_BY_ID_ROUTE, LIST_AGENT_BUILDER_ACTIONS_ROUTE, LIST_AGENT_BUILDER_ACTION_RUNS_ROUTE, OBSERVE_STREAM_AGENT_BUILDER_ACTION_ROUTE, OBSERVE_STREAM_LEGACY_AGENT_BUILDER_ACTION_ROUTE, RESUME_AGENT_BUILDER_ACTION_ROUTE, RESUME_ASYNC_AGENT_BUILDER_ACTION_ROUTE, RESUME_STREAM_AGENT_BUILDER_ACTION_ROUTE, START_AGENT_BUILDER_ACTION_RUN_ROUTE, START_ASYNC_AGENT_BUILDER_ACTION_ROUTE, STREAM_AGENT_BUILDER_ACTION_ROUTE, STREAM_LEGACY_AGENT_BUILDER_ACTION_ROUTE } from '../../chunk-ZMBEDBRB.js';
+export { CANCEL_AGENT_BUILDER_ACTION_RUN_ROUTE, CREATE_AGENT_BUILDER_ACTION_RUN_ROUTE, GET_AGENT_BUILDER_ACTION_BY_ID_ROUTE, GET_AGENT_BUILDER_ACTION_RUN_BY_ID_ROUTE, LIST_AGENT_BUILDER_ACTIONS_ROUTE, LIST_AGENT_BUILDER_ACTION_RUNS_ROUTE, OBSERVE_STREAM_AGENT_BUILDER_ACTION_ROUTE, OBSERVE_STREAM_LEGACY_AGENT_BUILDER_ACTION_ROUTE, RESUME_AGENT_BUILDER_ACTION_ROUTE, RESUME_ASYNC_AGENT_BUILDER_ACTION_ROUTE, RESUME_STREAM_AGENT_BUILDER_ACTION_ROUTE, START_AGENT_BUILDER_ACTION_RUN_ROUTE, START_ASYNC_AGENT_BUILDER_ACTION_ROUTE, STREAM_AGENT_BUILDER_ACTION_ROUTE, STREAM_LEGACY_AGENT_BUILDER_ACTION_ROUTE } from '../../chunk-CN7BQNC5.js';
 //# sourceMappingURL=agent-builder.js.map
 //# sourceMappingURL=agent-builder.js.map

package/dist/server/handlers/agent-versions.cjs

@@ -1,36 +1,36 @@
 'use strict';
 
-var chunkJH576GTI_cjs = require('../../chunk-JH576GTI.cjs');
+var chunkKU4DBPKJ_cjs = require('../../chunk-KU4DBPKJ.cjs');
 
 
 
 Object.defineProperty(exports, "ACTIVATE_AGENT_VERSION_ROUTE", {
   enumerable: true,
-  get: function () { return chunkJH576GTI_cjs.ACTIVATE_AGENT_VERSION_ROUTE; }
+  get: function () { return chunkKU4DBPKJ_cjs.ACTIVATE_AGENT_VERSION_ROUTE; }
 });
 Object.defineProperty(exports, "COMPARE_AGENT_VERSIONS_ROUTE", {
   enumerable: true,
-  get: function () { return chunkJH576GTI_cjs.COMPARE_AGENT_VERSIONS_ROUTE; }
+  get: function () { return chunkKU4DBPKJ_cjs.COMPARE_AGENT_VERSIONS_ROUTE; }
 });
 Object.defineProperty(exports, "CREATE_AGENT_VERSION_ROUTE", {
   enumerable: true,
-  get: function () { return chunkJH576GTI_cjs.CREATE_AGENT_VERSION_ROUTE; }
+  get: function () { return chunkKU4DBPKJ_cjs.CREATE_AGENT_VERSION_ROUTE; }
 });
 Object.defineProperty(exports, "DELETE_AGENT_VERSION_ROUTE", {
   enumerable: true,
-  get: function () { return chunkJH576GTI_cjs.DELETE_AGENT_VERSION_ROUTE; }
+  get: function () { return chunkKU4DBPKJ_cjs.DELETE_AGENT_VERSION_ROUTE; }
 });
 Object.defineProperty(exports, "GET_AGENT_VERSION_ROUTE", {
   enumerable: true,
-  get: function () { return chunkJH576GTI_cjs.GET_AGENT_VERSION_ROUTE; }
+  get: function () { return chunkKU4DBPKJ_cjs.GET_AGENT_VERSION_ROUTE; }
 });
 Object.defineProperty(exports, "LIST_AGENT_VERSIONS_ROUTE", {
   enumerable: true,
-  get: function () { return chunkJH576GTI_cjs.LIST_AGENT_VERSIONS_ROUTE; }
+  get: function () { return chunkKU4DBPKJ_cjs.LIST_AGENT_VERSIONS_ROUTE; }
 });
 Object.defineProperty(exports, "RESTORE_AGENT_VERSION_ROUTE", {
   enumerable: true,
-  get: function () { return chunkJH576GTI_cjs.RESTORE_AGENT_VERSION_ROUTE; }
+  get: function () { return chunkKU4DBPKJ_cjs.RESTORE_AGENT_VERSION_ROUTE; }
 });
 //# sourceMappingURL=agent-versions.cjs.map
 //# sourceMappingURL=agent-versions.cjs.map

package/dist/server/handlers/agent-versions.js

@@ -1,3 +1,3 @@
-export { ACTIVATE_AGENT_VERSION_ROUTE, COMPARE_AGENT_VERSIONS_ROUTE, CREATE_AGENT_VERSION_ROUTE, DELETE_AGENT_VERSION_ROUTE, GET_AGENT_VERSION_ROUTE, LIST_AGENT_VERSIONS_ROUTE, RESTORE_AGENT_VERSION_ROUTE } from '../../chunk-HI5EDX3F.js';
+export { ACTIVATE_AGENT_VERSION_ROUTE, COMPARE_AGENT_VERSIONS_ROUTE, CREATE_AGENT_VERSION_ROUTE, DELETE_AGENT_VERSION_ROUTE, GET_AGENT_VERSION_ROUTE, LIST_AGENT_VERSIONS_ROUTE, RESTORE_AGENT_VERSION_ROUTE } from '../../chunk-IGUQV25I.js';
 //# sourceMappingURL=agent-versions.js.map
 //# sourceMappingURL=agent-versions.js.map

package/dist/server/handlers/agents.cjs

@@ -1,140 +1,144 @@
 'use strict';
 
-var chunkOCU2OAMS_cjs = require('../../chunk-OCU2OAMS.cjs');
+var chunk3DRF53JI_cjs = require('../../chunk-3DRF53JI.cjs');
 
 
 
 Object.defineProperty(exports, "APPROVE_NETWORK_TOOL_CALL_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.APPROVE_NETWORK_TOOL_CALL_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.APPROVE_NETWORK_TOOL_CALL_ROUTE; }
 });
 Object.defineProperty(exports, "APPROVE_TOOL_CALL_GENERATE_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.APPROVE_TOOL_CALL_GENERATE_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.APPROVE_TOOL_CALL_GENERATE_ROUTE; }
 });
 Object.defineProperty(exports, "APPROVE_TOOL_CALL_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.APPROVE_TOOL_CALL_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.APPROVE_TOOL_CALL_ROUTE; }
 });
 Object.defineProperty(exports, "CLONE_AGENT_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.CLONE_AGENT_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.CLONE_AGENT_ROUTE; }
 });
 Object.defineProperty(exports, "DECLINE_NETWORK_TOOL_CALL_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.DECLINE_NETWORK_TOOL_CALL_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.DECLINE_NETWORK_TOOL_CALL_ROUTE; }
 });
 Object.defineProperty(exports, "DECLINE_TOOL_CALL_GENERATE_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.DECLINE_TOOL_CALL_GENERATE_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.DECLINE_TOOL_CALL_GENERATE_ROUTE; }
 });
 Object.defineProperty(exports, "DECLINE_TOOL_CALL_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.DECLINE_TOOL_CALL_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.DECLINE_TOOL_CALL_ROUTE; }
 });
 Object.defineProperty(exports, "ENHANCE_INSTRUCTIONS_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.ENHANCE_INSTRUCTIONS_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.ENHANCE_INSTRUCTIONS_ROUTE; }
 });
 Object.defineProperty(exports, "GENERATE_AGENT_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.GENERATE_AGENT_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.GENERATE_AGENT_ROUTE; }
 });
 Object.defineProperty(exports, "GENERATE_AGENT_VNEXT_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.GENERATE_AGENT_VNEXT_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.GENERATE_AGENT_VNEXT_ROUTE; }
 });
 Object.defineProperty(exports, "GENERATE_LEGACY_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.GENERATE_LEGACY_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.GENERATE_LEGACY_ROUTE; }
 });
 Object.defineProperty(exports, "GET_AGENT_BY_ID_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.GET_AGENT_BY_ID_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.GET_AGENT_BY_ID_ROUTE; }
 });
 Object.defineProperty(exports, "GET_AGENT_SKILL_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.GET_AGENT_SKILL_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.GET_AGENT_SKILL_ROUTE; }
 });
 Object.defineProperty(exports, "GET_PROVIDERS_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.GET_PROVIDERS_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.GET_PROVIDERS_ROUTE; }
 });
 Object.defineProperty(exports, "LIST_AGENTS_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.LIST_AGENTS_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.LIST_AGENTS_ROUTE; }
 });
 Object.defineProperty(exports, "REORDER_AGENT_MODEL_LIST_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.REORDER_AGENT_MODEL_LIST_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.REORDER_AGENT_MODEL_LIST_ROUTE; }
 });
 Object.defineProperty(exports, "RESET_AGENT_MODEL_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.RESET_AGENT_MODEL_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.RESET_AGENT_MODEL_ROUTE; }
 });
 Object.defineProperty(exports, "STREAM_GENERATE_LEGACY_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.STREAM_GENERATE_LEGACY_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.STREAM_GENERATE_LEGACY_ROUTE; }
 });
 Object.defineProperty(exports, "STREAM_GENERATE_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.STREAM_GENERATE_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.STREAM_GENERATE_ROUTE; }
 });
 Object.defineProperty(exports, "STREAM_GENERATE_VNEXT_DEPRECATED_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.STREAM_GENERATE_VNEXT_DEPRECATED_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.STREAM_GENERATE_VNEXT_DEPRECATED_ROUTE; }
 });
 Object.defineProperty(exports, "STREAM_NETWORK_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.STREAM_NETWORK_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.STREAM_NETWORK_ROUTE; }
 });
 Object.defineProperty(exports, "STREAM_UI_MESSAGE_DEPRECATED_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.STREAM_UI_MESSAGE_DEPRECATED_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.STREAM_UI_MESSAGE_DEPRECATED_ROUTE; }
 });
 Object.defineProperty(exports, "STREAM_UI_MESSAGE_VNEXT_DEPRECATED_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.STREAM_UI_MESSAGE_VNEXT_DEPRECATED_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.STREAM_UI_MESSAGE_VNEXT_DEPRECATED_ROUTE; }
 });
 Object.defineProperty(exports, "STREAM_VNEXT_DEPRECATED_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.STREAM_VNEXT_DEPRECATED_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.STREAM_VNEXT_DEPRECATED_ROUTE; }
 });
 Object.defineProperty(exports, "UPDATE_AGENT_MODEL_IN_MODEL_LIST_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.UPDATE_AGENT_MODEL_IN_MODEL_LIST_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.UPDATE_AGENT_MODEL_IN_MODEL_LIST_ROUTE; }
 });
 Object.defineProperty(exports, "UPDATE_AGENT_MODEL_ROUTE", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.UPDATE_AGENT_MODEL_ROUTE; }
+  get: function () { return chunk3DRF53JI_cjs.UPDATE_AGENT_MODEL_ROUTE; }
 });
 Object.defineProperty(exports, "extractVersionOptions", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.extractVersionOptions; }
+  get: function () { return chunk3DRF53JI_cjs.extractVersionOptions; }
 });
 Object.defineProperty(exports, "getAgentFromSystem", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.getAgentFromSystem; }
+  get: function () { return chunk3DRF53JI_cjs.getAgentFromSystem; }
+});
+Object.defineProperty(exports, "getBrowserToolsFromAgent", {
+  enumerable: true,
+  get: function () { return chunk3DRF53JI_cjs.getBrowserToolsFromAgent; }
 });
 Object.defineProperty(exports, "getSerializedAgentTools", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.getSerializedAgentTools; }
+  get: function () { return chunk3DRF53JI_cjs.getSerializedAgentTools; }
 });
 Object.defineProperty(exports, "getSerializedProcessors", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.getSerializedProcessors; }
+  get: function () { return chunk3DRF53JI_cjs.getSerializedProcessors; }
 });
 Object.defineProperty(exports, "getSerializedSkillsFromAgent", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.getSerializedSkillsFromAgent; }
+  get: function () { return chunk3DRF53JI_cjs.getSerializedSkillsFromAgent; }
 });
 Object.defineProperty(exports, "getWorkspaceToolsFromAgent", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.getWorkspaceToolsFromAgent; }
+  get: function () { return chunk3DRF53JI_cjs.getWorkspaceToolsFromAgent; }
 });
 Object.defineProperty(exports, "isProviderConnected", {
   enumerable: true,
-  get: function () { return chunkOCU2OAMS_cjs.isProviderConnected; }
+  get: function () { return chunk3DRF53JI_cjs.isProviderConnected; }
 });
 //# sourceMappingURL=agents.cjs.map
 //# sourceMappingURL=agents.cjs.map

package/dist/server/handlers/agents.d.ts

@@ -61,6 +61,8 @@ export interface SerializedAgent {
     workflows: Record<string, SerializedWorkflow>;
     skills: SerializedSkill[];
     workspaceTools: string[];
+    /** Browser tool names available to this agent (if browser is configured) */
+    browserTools: string[];
     /** ID of the agent's workspace (if configured) */
     workspaceId?: string;
     inputProcessors: SerializedProcessor[];
@@ -104,6 +106,11 @@ export declare function getSerializedSkillsFromAgent(agent: Agent, requestContex
  * export `createWorkspaceTools`.
  */
 export declare function getWorkspaceToolsFromAgent(agent: Agent, requestContext?: RequestContext): Promise<string[]>;
+/**
+ * Get the list of browser tool names for an agent.
+ * Returns the tool names from the agent's browser provider if configured.
+ */
+export declare function getBrowserToolsFromAgent(agent: Agent, onError?: (error: unknown) => void): string[];
 interface SerializedAgentDefinition {
     id: string;
     name: string;