@agent-native/core 0.96.0 → 0.98.0

package/dist/server/agent-chat/action-filters-a2a.js

@@ -0,0 +1,127 @@
+import { getHeader } from "h3";
+import { appendA2AArtifactLinks, } from "../../a2a/artifact-response.js";
+import { collectFinalResponseTextFromAgentEvents } from "../../a2a/response-text.js";
+import { filterInitialEngineTools, } from "../../agent/production-agent.js";
+import { runAgentLoopDirectWithSoftTimeout } from "../../agent/run-loop-with-resume.js";
+import { withConfiguredAppBasePath } from "../app-base-path.js";
+// ---------------------------------------------------------------------------
+// Action-visibility filters (read-only / agent-exposed / public-agent-safe)
+// and the A2A (agent-to-agent) final-response assembly + delegated-run
+// helpers that share those filters.
+// ---------------------------------------------------------------------------
+export function filterReadOnlyActions(actions) {
+    return Object.fromEntries(Object.entries(actions).filter(([, entry]) => entry.readOnly === true));
+}
+/** Drop actions that opted out of agent exposure via `agentTool: false`. They
+ *  remain callable from the frontend / HTTP (mounted separately from this
+ *  agent tool surface — see `httpActions`) but never appear in any agent tool
+ *  list (in-app assistant, MCP, A2A, job/trigger runners) or actions prompt.
+ *  Default-allow: only an explicit `false` is excluded. */
+export function filterAgentTools(actions) {
+    return Object.fromEntries(Object.entries(actions).filter(([, entry]) => entry.agentTool !== false));
+}
+export function filterPublicAgentActions(actions) {
+    return Object.fromEntries(Object.entries(actions).filter(([, entry]) => {
+        const config = entry.publicAgent;
+        return (config?.expose === true &&
+            config.readOnly === true &&
+            config.requiresAuth !== true &&
+            config.isConsequential !== true);
+    }));
+}
+export function buildPublicAgentA2ASkills(actions) {
+    return Object.entries(filterPublicAgentActions(actions)).map(([name, entry]) => ({
+        id: name,
+        name,
+        description: entry.tool.description,
+        publicAgent: entry.publicAgent,
+    }));
+}
+export function resolveArtifactBaseUrl(event) {
+    const fromEnv = process.env.APP_URL ||
+        process.env.URL ||
+        process.env.DEPLOY_URL ||
+        process.env.BETTER_AUTH_URL;
+    if (fromEnv)
+        return withConfiguredAppBasePath(String(fromEnv));
+    try {
+        const proto = getHeader(event, "x-forwarded-proto") || "https";
+        const host = getHeader(event, "host");
+        if (host)
+            return withConfiguredAppBasePath(`${proto}://${host}`);
+    }
+    catch { }
+    return undefined;
+}
+export function assembleA2AFinalResponse(events, toolResults, options = {}) {
+    const terminalError = getA2ATerminalErrorEvent(events);
+    const responseText = collectFinalResponseTextFromAgentEvents(events, {
+        fallbackToPreToolText: !terminalError,
+    });
+    const finalText = appendA2AArtifactLinks(responseText, [...toolResults], {
+        baseUrl: options.baseUrl ?? resolveArtifactBaseUrl(options.event),
+        includeReferencedArtifacts: true,
+    });
+    if (terminalError && !finalText.trim()) {
+        throw new Error(formatA2ATerminalError(terminalError));
+    }
+    return { responseText, finalText };
+}
+function getA2ATerminalErrorEvent(events) {
+    for (let i = events.length - 1; i >= 0; i--) {
+        const event = events[i];
+        if (event.type === "clear")
+            continue;
+        if (event.type === "done")
+            return null;
+        if (event.type === "error")
+            return event;
+        if (event.type === "auto_continue") {
+            return {
+                type: "error",
+                error: `Agent stopped before finishing (${event.reason}).`,
+                errorCode: event.reason,
+                recoverable: true,
+            };
+        }
+    }
+    return null;
+}
+function formatA2ATerminalError(event) {
+    const parts = [
+        event.error || "Agent failed before producing a final response.",
+        event.errorCode ? `code: ${event.errorCode}` : "",
+        event.details ? `details: ${event.details}` : "",
+    ].filter(Boolean);
+    return parts.join("\n");
+}
+/**
+ * Run an A2A-delegated agent turn with the same final-response guard used by
+ * the app's interactive chat surface.
+ *
+ * Keeping this in one helper prevents delegated calls from silently bypassing
+ * template guarantees such as Analytics' requirement to query real data
+ * before presenting metrics or exhaustive provider conclusions.
+ */
+export function runA2AAgentLoop(runOptions, pluginOptions, timeoutOptions, runner = runAgentLoopDirectWithSoftTimeout) {
+    return runner({
+        ...runOptions,
+        finalResponseGuard: pluginOptions.finalResponseGuard,
+    }, pluginOptions.runSoftTimeoutMs, timeoutOptions);
+}
+/**
+ * Keep delegated A2A turns on the same compact initial tool surface as
+ * interactive chat. `tool-search` remains in the initial set, while the
+ * complete registry is supplied separately so the run loop can load a matched
+ * schema after a tool-search result.
+ */
+export function createA2AEngineToolSurface(availableTools, initialToolNames) {
+    return {
+        tools: filterInitialEngineTools(availableTools, initialToolNames),
+        availableTools,
+    };
+}
+export function resolveInitialToolNames(templateActions, configured) {
+    return configured ?? Object.keys(templateActions);
+}
+//# sourceMappingURL=action-filters-a2a.js.map

package/dist/server/agent-chat/action-filters-a2a.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-filters-a2a.js","sourceRoot":"","sources":["../../../src/server/agent-chat/action-filters-a2a.ts"],"names":[],"mappings":"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","sourcesContent":["import { getHeader } from \"h3\";\n\nimport {\n  appendA2AArtifactLinks,\n  type A2AArtifactResponseOptions,\n  type A2AToolResultSummary,\n} from \"../../a2a/artifact-response.js\";\nimport { collectFinalResponseTextFromAgentEvents } from \"../../a2a/response-text.js\";\nimport type { EngineTool } from \"../../agent/engine/types.js\";\nimport {\n  filterInitialEngineTools,\n  type ActionEntry,\n} from \"../../agent/production-agent.js\";\nimport { runAgentLoopDirectWithSoftTimeout } from \"../../agent/run-loop-with-resume.js\";\nimport type { AgentChatEvent } from \"../../agent/types.js\";\nimport { withConfiguredAppBasePath } from \"../app-base-path.js\";\nimport type { AgentChatPluginOptions } from \"./plugin-options.js\";\n\n// ---------------------------------------------------------------------------\n// Action-visibility filters (read-only / agent-exposed / public-agent-safe)\n// and the A2A (agent-to-agent) final-response assembly + delegated-run\n// helpers that share those filters.\n// ---------------------------------------------------------------------------\n\nexport function filterReadOnlyActions(\n  actions: Record<string, ActionEntry>,\n): Record<string, ActionEntry> {\n  return Object.fromEntries(\n    Object.entries(actions).filter(([, entry]) => entry.readOnly === true),\n  );\n}\n\n/** Drop actions that opted out of agent exposure via `agentTool: false`. They\n *  remain callable from the frontend / HTTP (mounted separately from this\n *  agent tool surface — see `httpActions`) but never appear in any agent tool\n *  list (in-app assistant, MCP, A2A, job/trigger runners) or actions prompt.\n *  Default-allow: only an explicit `false` is excluded. */\nexport function filterAgentTools(\n  actions: Record<string, ActionEntry>,\n): Record<string, ActionEntry> {\n  return Object.fromEntries(\n    Object.entries(actions).filter(([, entry]) => entry.agentTool !== false),\n  );\n}\n\nexport function filterPublicAgentActions(\n  actions: Record<string, ActionEntry>,\n): Record<string, ActionEntry> {\n  return Object.fromEntries(\n    Object.entries(actions).filter(([, entry]) => {\n      const config = entry.publicAgent;\n      return (\n        config?.expose === true &&\n        config.readOnly === true &&\n        config.requiresAuth !== true &&\n        config.isConsequential !== true\n      );\n    }),\n  );\n}\n\nexport function buildPublicAgentA2ASkills(\n  actions: Record<string, ActionEntry>,\n): Array<{\n  id: string;\n  name: string;\n  description: string;\n  publicAgent: ActionEntry[\"publicAgent\"];\n}> {\n  return Object.entries(filterPublicAgentActions(actions)).map(\n    ([name, entry]) => ({\n      id: name,\n      name,\n      description: entry.tool.description,\n      publicAgent: entry.publicAgent,\n    }),\n  );\n}\n\nexport function resolveArtifactBaseUrl(\n  event: any | undefined,\n): string | undefined {\n  const fromEnv =\n    process.env.APP_URL ||\n    process.env.URL ||\n    process.env.DEPLOY_URL ||\n    process.env.BETTER_AUTH_URL;\n  if (fromEnv) return withConfiguredAppBasePath(String(fromEnv));\n\n  try {\n    const proto = getHeader(event, \"x-forwarded-proto\") || \"https\";\n    const host = getHeader(event, \"host\");\n    if (host) return withConfiguredAppBasePath(`${proto}://${host}`);\n  } catch {}\n\n  return undefined;\n}\n\nexport function assembleA2AFinalResponse(\n  events: readonly AgentChatEvent[],\n  toolResults: readonly A2AToolResultSummary[],\n  options: A2AArtifactResponseOptions & { event?: any } = {},\n): { responseText: string; finalText: string } {\n  const terminalError = getA2ATerminalErrorEvent(events);\n  const responseText = collectFinalResponseTextFromAgentEvents(events, {\n    fallbackToPreToolText: !terminalError,\n  });\n  const finalText = appendA2AArtifactLinks(responseText, [...toolResults], {\n    baseUrl: options.baseUrl ?? resolveArtifactBaseUrl(options.event),\n    includeReferencedArtifacts: true,\n  });\n  if (terminalError && !finalText.trim()) {\n    throw new Error(formatA2ATerminalError(terminalError));\n  }\n  return { responseText, finalText };\n}\n\nfunction getA2ATerminalErrorEvent(\n  events: readonly AgentChatEvent[],\n): Extract<AgentChatEvent, { type: \"error\" }> | null {\n  for (let i = events.length - 1; i >= 0; i--) {\n    const event = events[i];\n    if (event.type === \"clear\") continue;\n    if (event.type === \"done\") return null;\n    if (event.type === \"error\") return event;\n    if (event.type === \"auto_continue\") {\n      return {\n        type: \"error\",\n        error: `Agent stopped before finishing (${event.reason}).`,\n        errorCode: event.reason,\n        recoverable: true,\n      };\n    }\n  }\n  return null;\n}\n\nfunction formatA2ATerminalError(\n  event: Extract<AgentChatEvent, { type: \"error\" }>,\n): string {\n  const parts = [\n    event.error || \"Agent failed before producing a final response.\",\n    event.errorCode ? `code: ${event.errorCode}` : \"\",\n    event.details ? `details: ${event.details}` : \"\",\n  ].filter(Boolean);\n  return parts.join(\"\\n\");\n}\n\ntype A2AAgentLoopRunner = typeof runAgentLoopDirectWithSoftTimeout;\n\n/**\n * Run an A2A-delegated agent turn with the same final-response guard used by\n * the app's interactive chat surface.\n *\n * Keeping this in one helper prevents delegated calls from silently bypassing\n * template guarantees such as Analytics' requirement to query real data\n * before presenting metrics or exhaustive provider conclusions.\n */\nexport function runA2AAgentLoop(\n  runOptions: Parameters<A2AAgentLoopRunner>[0],\n  pluginOptions: Pick<\n    AgentChatPluginOptions,\n    \"finalResponseGuard\" | \"runSoftTimeoutMs\"\n  >,\n  timeoutOptions: Parameters<A2AAgentLoopRunner>[2],\n  runner: A2AAgentLoopRunner = runAgentLoopDirectWithSoftTimeout,\n) {\n  return runner(\n    {\n      ...runOptions,\n      finalResponseGuard: pluginOptions.finalResponseGuard,\n    },\n    pluginOptions.runSoftTimeoutMs,\n    timeoutOptions,\n  );\n}\n\n/**\n * Keep delegated A2A turns on the same compact initial tool surface as\n * interactive chat. `tool-search` remains in the initial set, while the\n * complete registry is supplied separately so the run loop can load a matched\n * schema after a tool-search result.\n */\nexport function createA2AEngineToolSurface(\n  availableTools: EngineTool[],\n  initialToolNames?: string[],\n): { tools: EngineTool[]; availableTools: EngineTool[] } {\n  return {\n    tools: filterInitialEngineTools(availableTools, initialToolNames),\n    availableTools,\n  };\n}\n\nexport function resolveInitialToolNames(\n  templateActions: Record<string, ActionEntry>,\n  configured?: string[],\n): string[] {\n  return configured ?? Object.keys(templateActions);\n}\n"]}

package/dist/server/agent-chat/browser-team-tools.d.ts

@@ -0,0 +1,21 @@
+import type { AgentEngine } from "../../agent/engine/types.js";
+import type { ActionEntry } from "../../agent/production-agent.js";
+export declare function createBuilderBrowserTool(deps: {
+    getOrigin: () => string;
+    getOwner?: () => string | null | undefined;
+    extensionTools?: boolean;
+}): Record<string, ActionEntry>;
+/**
+ * Creates the unified `agent-teams` tool that consolidates all sub-agent
+ * orchestration behind a single tool with an `action` parameter.
+ */
+export declare function createTeamTools(deps: {
+    getOwner: () => string;
+    getSystemPrompt: () => string;
+    getActions: () => Record<string, ActionEntry>;
+    getEngine: () => AgentEngine;
+    getModel: () => string;
+    getParentThreadId: () => string;
+    getSend: () => ((event: import("../../agent/types.js").AgentChatEvent) => void) | null;
+}): Record<string, ActionEntry>;
+//# sourceMappingURL=browser-team-tools.d.ts.map

package/dist/server/agent-chat/browser-team-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-team-tools.d.ts","sourceRoot":"","sources":["../../../src/server/agent-chat/browser-team-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAmBnE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CA4Q9B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC9C,SAAS,EAAE,MAAM,WAAW,CAAC;IAC7B,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,OAAO,EAAE,MACL,CAAC,CAAC,KAAK,EAAE,OAAO,sBAAsB,EAAE,cAAc,KAAK,IAAI,CAAC,GAChE,IAAI,CAAC;CACV,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAyM9B"}

package/dist/server/agent-chat/browser-team-tools.js

@@ -0,0 +1,417 @@
+import { areBuiltinMcpCapabilitiesSupported, buildMergedConfig, setBuiltinMcpCapabilityEnabled, } from "../../mcp-client/index.js";
+import { getBuilderBrowserConnectUrlForOwner, resolveBuilderBranchProjectId, } from "../builder-browser.js";
+import { getRequestUserEmail } from "../request-context.js";
+import { getGlobalMcpManager } from "./mcp-glue.js";
+// ---------------------------------------------------------------------------
+// Builder.io browser-connect / built-in MCP toggle tools, and the unified
+// `agent-teams` sub-agent orchestration tool.
+// ---------------------------------------------------------------------------
+export function createBuilderBrowserTool(deps) {
+    const extensionRequestGuidance = deps.extensionTools === false
+        ? "Do NOT call this for requests to create or edit user-authored extensions/widgets/dashboards/calculators/mini-apps; extension tools are disabled for this app, and Builder is only for source-code changes to the host app. "
+        : "Do NOT call this for a self-contained extension/widget/dashboard/calculator/mini-app or an extension that fits an existing named slot; those use create-extension/update-extension instead. If the requested result requires changing the host UI or placing UI where no named slot exists, it IS a source-code change: call this through the normal flow even when the user describes it as an extension. Never stop at saying an extension cannot do it. ";
+    const setBuiltinForCurrentUser = async (id, enabled) => {
+        const email = getRequestUserEmail();
+        if (!email) {
+            return {
+                ok: false,
+                error: "not-signed-in",
+                message: "You must be signed in to change built-in MCP tools.",
+            };
+        }
+        const enabledIds = await setBuiltinMcpCapabilityEnabled("user", email, id, enabled);
+        const manager = getGlobalMcpManager();
+        if (manager) {
+            await manager.reconfigure(await buildMergedConfig());
+        }
+        return { ok: true, enabledIds: enabledIds ?? [] };
+    };
+    const entries = {
+        "connect-builder": {
+            tool: {
+                description: `Render a Builder.io card inline in the chat. Call this as the first step (no code exploration or planning needed) when the user asks to modify the APP'S OWN SOURCE CODE: add a feature, change the UI chrome, edit a React component, add a route, add an integration, fix a bug in the app itself, or anything else that requires source-file edits while in hosted/production mode. ${extensionRequestGuidance}Do NOT call this for content the app is meant to produce — creating a video, generating a design, drafting an email, building a slide deck, making a dashboard, etc. — those run through the app's own domain actions, not Builder. Do NOT mention 'click Send to Builder' in your response unless this card is already in the conversation. The tool result includes \`builderEnabled\`; treat \`true\` as "Builder Cloud Agents can take the code-change handoff" and \`false\` as "this still needs a code change, but no Builder Cloud Agent can run here." If Builder is connected and Builder Cloud Agents are available, the card shows a 'Send to Builder' button that hands the work off to Builder's cloud agent and returns a branch URL. If \`builderEnabled\` is false, the card still renders but shows the code-change fallback: "This requires a code change. Edit locally or use Builder.io to edit this code in the cloud and continue customizing the app any way you like." Never tell the user to enable Builder Cloud Agents in Builder org settings or beta settings, and do not claim the Builder card has everything, is pre-loaded for handoff, or can run the cloud agent when \`builderEnabled\` is false. When you call this for a code-change request, pass the user's request verbatim as the \`prompt\` arg so the card can forward it to Builder unchanged when cloud agents are available.`,
+                parameters: {
+                    type: "object",
+                    properties: {
+                        prompt: {
+                            type: "string",
+                            description: "The user's feature / change request, verbatim. Forwarded to Builder's cloud agent when the user clicks Send. Omit only for generic 'connect Builder' requests that aren't tied to a specific code change.",
+                        },
+                    },
+                },
+            },
+            run: async (args) => {
+                const { getBuilderCredentialAuthFailure, resolveBuilderCredentials } = await import("../credential-provider.js");
+                const creds = await resolveBuilderCredentials();
+                const authFailure = await getBuilderCredentialAuthFailure(creds);
+                const configured = !!(creds.privateKey &&
+                    creds.publicKey &&
+                    !authFailure);
+                const branchProjectId = await resolveBuilderBranchProjectId();
+                const prompt = typeof args?.prompt === "string" ? args.prompt : "";
+                const origin = deps.getOrigin();
+                const ownerEmail = deps.getOwner?.() ?? getRequestUserEmail();
+                return JSON.stringify({
+                    kind: "connect-builder-card",
+                    configured,
+                    builderEnabled: !!branchProjectId,
+                    connectUrl: getBuilderBrowserConnectUrlForOwner(origin, ownerEmail),
+                    orgName: creds.orgName || null,
+                    prompt,
+                });
+            },
+        },
+        "set-browser-control": {
+            tool: {
+                description: "Enable or disable built-in browser-control MCP tools for the current user. Call this when the user asks to test, screenshot, inspect, or interact with a web page and browser tools are not available; confirm once before enabling. Prefer the chrome-devtools backend for live logged-in Chrome, and use playwright when an isolated browser is better.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        enabled: {
+                            type: "boolean",
+                            description: "Whether browser-control tools should be enabled.",
+                        },
+                        backend: {
+                            type: "string",
+                            enum: ["chrome-devtools", "playwright"],
+                            description: "Browser backend to enable. Defaults to chrome-devtools.",
+                        },
+                    },
+                    required: ["enabled"],
+                },
+            },
+            run: async (args) => {
+                const parsed = args && typeof args === "object"
+                    ? args
+                    : {};
+                const enabled = parsed.enabled !== false;
+                const requestedBackend = typeof parsed.backend === "string" ? parsed.backend : undefined;
+                const backend = requestedBackend === "playwright" ? "playwright" : "chrome-devtools";
+                const targetId = backend === "playwright"
+                    ? "browser-playwright"
+                    : "browser-chrome-devtools";
+                if (!enabled) {
+                    const chrome = await setBuiltinForCurrentUser("browser-chrome-devtools", false);
+                    if (!chrome.ok)
+                        return JSON.stringify(chrome);
+                    const playwright = await setBuiltinForCurrentUser("browser-playwright", false);
+                    return JSON.stringify({
+                        ...playwright,
+                        enabled: false,
+                        message: "Browser-control MCP tools are disabled.",
+                    });
+                }
+                const result = await setBuiltinForCurrentUser(targetId, true);
+                return JSON.stringify({
+                    ...result,
+                    enabled: true,
+                    backend,
+                    message: backend === "chrome-devtools"
+                        ? "Chrome DevTools MCP is enabled. Browser tools will be available on the next action when Chrome remote debugging is available."
+                        : "Playwright MCP is enabled. Browser tools will be available on the next action in an isolated Playwright browser.",
+                });
+            },
+        },
+        "set-computer-use": {
+            tool: {
+                description: "Enable or disable built-in Computer Use MCP tools for the current user. Call only after the user explicitly asks to let the agent control local desktop apps. macOS may require Screen Recording and Accessibility permissions.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        enabled: {
+                            type: "boolean",
+                            description: "Whether Computer Use tools should be enabled.",
+                        },
+                    },
+                    required: ["enabled"],
+                },
+            },
+            run: async (args) => {
+                const parsed = args && typeof args === "object"
+                    ? args
+                    : {};
+                const enabled = parsed.enabled !== false;
+                if (enabled && process.platform !== "darwin") {
+                    return JSON.stringify({
+                        ok: false,
+                        error: "unsupported-platform",
+                        message: "Computer Use is currently available only on macOS.",
+                    });
+                }
+                const result = await setBuiltinForCurrentUser("computer-use", enabled);
+                return JSON.stringify({
+                    ...result,
+                    enabled,
+                    message: enabled
+                        ? "Computer Use MCP is enabled. If macOS prompts, grant Screen Recording and Accessibility permission in System Settings > Privacy & Security."
+                        : "Computer Use MCP is disabled.",
+                });
+            },
+        },
+        "activate-browser": {
+            tool: {
+                description: "Activate browser automation tools. Call this when you need to interact with a real browser — e.g. to extract design tokens from a rendered page, take screenshots, read computed styles from JS-heavy sites, or test a live URL. After activation, chrome-devtools MCP tools (navigate, click, evaluate_script, take_screenshot, etc.) become available on your next action. Requires Builder.io connection.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        sessionId: {
+                            type: "string",
+                            description: "Optional session identifier for the browser connection. Auto-generated if omitted.",
+                        },
+                    },
+                },
+            },
+            run: async (args) => {
+                const { resolveBuilderCredentials } = await import("../credential-provider.js");
+                const creds = await resolveBuilderCredentials();
+                if (!creds.privateKey || !creds.publicKey) {
+                    return JSON.stringify({
+                        error: "builder-not-connected",
+                        message: "Builder.io is not connected. Call `connect-builder` first to enable browser automation.",
+                    });
+                }
+                const { requestBuilderBrowserConnection } = await import("../builder-browser.js");
+                const sessionId = (typeof args?.sessionId === "string" && args.sessionId) ||
+                    `an-browser-${Date.now()}`;
+                let connection;
+                try {
+                    connection = await requestBuilderBrowserConnection({ sessionId });
+                }
+                catch (err) {
+                    return JSON.stringify({
+                        error: "browser-connection-failed",
+                        message: `Failed to get browser connection: ${err?.message ?? err}`,
+                    });
+                }
+                const wsUrl = connection.wsUrl;
+                if (!wsUrl) {
+                    return JSON.stringify({
+                        error: "no-ws-url",
+                        message: "Browser connection did not return a WebSocket URL.",
+                    });
+                }
+                const manager = getGlobalMcpManager();
+                if (!manager) {
+                    return JSON.stringify({
+                        error: "no-mcp-manager",
+                        message: "MCP manager is not available.",
+                    });
+                }
+                // Add chrome-devtools-mcp server pointing at the provisioned browser
+                const currentConfig = manager.getConfig();
+                const servers = { ...(currentConfig?.servers ?? {}) };
+                servers["chrome-devtools"] = {
+                    command: "npx",
+                    args: [
+                        "-y",
+                        "chrome-devtools-mcp@0.26.0",
+                        "--wsEndpoint",
+                        wsUrl,
+                        "--categoryEmulation=false",
+                    ],
+                    type: "stdio",
+                };
+                await manager.reconfigure({
+                    servers,
+                    source: currentConfig?.source ?? "runtime",
+                });
+                return JSON.stringify({
+                    success: true,
+                    message: "Browser activated. Chrome DevTools MCP tools (mcp__chrome-devtools__*) are now available. Use them on your next action to navigate pages, read DOM, take screenshots, evaluate JavaScript, etc.",
+                    wsUrl,
+                    sessionId,
+                });
+            },
+        },
+    };
+    if (!areBuiltinMcpCapabilitiesSupported()) {
+        delete entries["set-browser-control"];
+        delete entries["set-computer-use"];
+    }
+    return entries;
+}
+/**
+ * Creates the unified `agent-teams` tool that consolidates all sub-agent
+ * orchestration behind a single tool with an `action` parameter.
+ */
+export function createTeamTools(deps) {
+    return {
+        "agent-teams": {
+            tool: {
+                description: "Manage background sub-agent tasks. Use action 'spawn' to start a new sub-agent, 'status' to check progress, 'read-result' to get a finished task's output, 'send' to message a running sub-agent, or 'list' to see all tasks. A successful spawn only means the task started and is running; do not report it as finished until status/read-result shows a terminal status.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        action: {
+                            type: "string",
+                            enum: ["spawn", "status", "read-result", "send", "list"],
+                            description: "The operation to perform",
+                        },
+                        task: {
+                            type: "string",
+                            description: "(spawn) Clear description of what the sub-agent should accomplish",
+                        },
+                        instructions: {
+                            type: "string",
+                            description: "(spawn) Optional additional instructions or context for the sub-agent",
+                        },
+                        name: {
+                            type: "string",
+                            description: "(spawn) Short name for the sub-agent tab (e.g. 'Research', 'Draft email'). If omitted, derived from the task.",
+                        },
+                        agent: {
+                            type: "string",
+                            description: "(spawn) Optional custom agent profile from agents/*.md to use for this task.",
+                        },
+                        taskId: {
+                            type: "string",
+                            description: "(status, read-result, send) The task ID returned by a previous spawn",
+                        },
+                        message: {
+                            type: "string",
+                            description: "(send) Message to send to the sub-agent",
+                        },
+                    },
+                    required: ["action"],
+                },
+            },
+            run: async (args) => {
+                const action = args.action;
+                // ── spawn ──────────────────────────────────────────────
+                if (action === "spawn") {
+                    if (!args.task)
+                        throw new Error("'task' is required for spawn");
+                    // Capture the send function NOW (at spawn time) so that
+                    // concurrent runs don't clobber each other's send reference.
+                    const capturedSend = deps.getSend();
+                    const { spawnTask } = await import("../agent-teams.js");
+                    // Filter out the team tool so sub-agents can't spawn sub-agents
+                    const subAgentActions = Object.fromEntries(Object.entries(deps.getActions()).filter(([name]) => name !== "agent-teams"));
+                    let instructions = args.instructions;
+                    let selectedModel = deps.getModel();
+                    let selectedName = args.name || "";
+                    if (args.agent) {
+                        const { findAccessibleCustomAgent } = await import("../../resources/agents.js");
+                        const profile = await findAccessibleCustomAgent(deps.getOwner(), args.agent);
+                        if (!profile) {
+                            throw new Error(`Custom agent not found: ${args.agent}`);
+                        }
+                        const profileInstructions = `## Custom Agent Profile: ${profile.name}\n\n` +
+                            (profile.description ? `${profile.description}\n\n` : "") +
+                            profile.instructions;
+                        instructions = instructions
+                            ? `${profileInstructions}\n\n## Extra Task Context\n\n${instructions}`
+                            : profileInstructions;
+                        selectedModel = profile.model ?? selectedModel;
+                        selectedName = selectedName || profile.name;
+                    }
+                    const task = await spawnTask({
+                        description: args.task,
+                        instructions,
+                        ownerEmail: deps.getOwner(),
+                        systemPrompt: deps.getSystemPrompt(),
+                        actions: subAgentActions,
+                        engine: deps.getEngine(),
+                        model: selectedModel,
+                        name: selectedName || undefined,
+                        parentThreadId: deps.getParentThreadId(),
+                        parentSend: (event) => {
+                            if (capturedSend)
+                                capturedSend(event);
+                        },
+                    });
+                    return JSON.stringify({
+                        taskId: task.taskId,
+                        threadId: task.threadId,
+                        runId: task.runId,
+                        status: task.status,
+                        parentThreadId: task.parentThreadId,
+                        state: "launched_pending_completion",
+                        message: "Sub-agent launched and is still running. Use status or read-result later; do not describe this task as completed from the spawn response alone.",
+                        description: task.description,
+                        name: task.name ?? selectedName,
+                    });
+                }
+                // ── status ─────────────────────────────────────────────
+                if (action === "status") {
+                    if (!args.taskId)
+                        throw new Error("'taskId' is required for status");
+                    const { getTask } = await import("../agent-teams.js");
+                    const task = await getTask(args.taskId);
+                    if (!task)
+                        return JSON.stringify({ error: "Task not found" });
+                    return JSON.stringify({
+                        taskId: task.taskId,
+                        threadId: task.threadId,
+                        parentThreadId: task.parentThreadId,
+                        status: task.status,
+                        description: task.description,
+                        name: task.name,
+                        preview: task.preview,
+                        currentStep: task.currentStep,
+                        summary: task.summary,
+                    });
+                }
+                // ── read-result ────────────────────────────────────────
+                if (action === "read-result") {
+                    if (!args.taskId)
+                        throw new Error("'taskId' is required for read-result");
+                    const { getTask } = await import("../agent-teams.js");
+                    const task = await getTask(args.taskId);
+                    if (!task)
+                        return JSON.stringify({ error: "Task not found" });
+                    if (task.status === "running") {
+                        return JSON.stringify({
+                            status: "running",
+                            taskId: task.taskId,
+                            threadId: task.threadId,
+                            parentThreadId: task.parentThreadId,
+                            name: task.name,
+                            preview: task.preview,
+                            message: "Task is still running. Do not report it as complete; use status/read-result later.",
+                        });
+                    }
+                    return JSON.stringify({
+                        taskId: task.taskId,
+                        threadId: task.threadId,
+                        parentThreadId: task.parentThreadId,
+                        name: task.name,
+                        status: task.status,
+                        summary: task.summary,
+                        preview: task.preview,
+                    });
+                }
+                // ── send ───────────────────────────────────────────────
+                if (action === "send") {
+                    if (!args.taskId)
+                        throw new Error("'taskId' is required for send");
+                    if (!args.message)
+                        throw new Error("'message' is required for send");
+                    const { sendToTask } = await import("../agent-teams.js");
+                    const result = await sendToTask(args.taskId, args.message);
+                    return JSON.stringify(result);
+                }
+                // ── list ───────────────────────────────────────────────
+                if (action === "list") {
+                    const { listTasks } = await import("../agent-teams.js");
+                    const tasks = await listTasks();
+                    if (tasks.length === 0) {
+                        return "No sub-agent tasks.";
+                    }
+                    return JSON.stringify(tasks.map((t) => ({
+                        taskId: t.taskId,
+                        threadId: t.threadId,
+                        parentThreadId: t.parentThreadId,
+                        name: t.name,
+                        description: t.description,
+                        status: t.status,
+                        currentStep: t.currentStep,
+                        hasResult: t.summary.length > 0,
+                    })), null, 2);
+                }
+                throw new Error(`Unknown action '${action}'. Use one of: spawn, status, read-result, send, list`);
+            },
+        },
+    };
+}
+//# sourceMappingURL=browser-team-tools.js.map