managed-deepagents 0.6.2-dev.8 → 0.7.0

package/dist/connectors/mcp/index.js

@@ -1,8 +1,8 @@
 /**
- * The managed `connectors/` declaration primitive.
+ * The managed MCP declaration primitive.
  *
  * A Managed Deep Agent declares the remote MCP servers whose tools it wants in
- * `connectors/mcp.ts` with `connectors.mcp(...)`. MDA discovers that
+ * `tools/mcp.ts` with `defineMcp(...)`. MDA discovers that
  * declaration, creates the `@langchain/mcp-adapters` client, loads the tools,
  * and adds them to the Deep Agent at runtime — the author never imports the MCP
  * client or calls `getTools()`.
@@ -17,78 +17,287 @@
  *
  * @example
  * ```ts
- * // connectors/mcp.ts
- * import { connectors } from "managed-deepagents";
+ * // tools/mcp.ts
+ * import { defineMcp, connections } from "managed-deepagents";
  *
- * export const connector = connectors.mcp({
- *   mcpServers: {
+ * export const mcp = defineMcp({
+ *   servers: {
  *     docs: {
  *       transport: "http",
  *       url: "https://docs.example.com/mcp",
  *     },
+ *     notion: {
+ *       transport: "http",
+ *       url: "https://mcp.notion.com/mcp",
+ *       connection: connections.get("notion", { type: "user" }),
+ *     },
  *   },
  * });
  * ```
  */
-import { z } from "zod";
-import { checkToolSelectionOverlap, toolSelectionConnectorFields, } from "../tool-selection.js";
+import { MultiServerMCPClient } from "@langchain/mcp-adapters";
 import { defineExtension } from "../../extension.js";
-/** Stdio servers are out of scope; the message points at the alternatives. */
-const STDIO_REJECTION = "uses a stdio transport, which is not supported. Managed Deep Agents " +
-    "support remote MCP servers over HTTP/SSE only; expose the server over HTTP " +
-    "or write a normal authored tool instead.";
-const remoteMcpServer = z
-    .looseObject({
-    // Present only to reject it: a `command` is how a stdio server is spelled.
-    command: z.never({ error: STDIO_REJECTION }).optional(),
-    transport: z.enum(["http", "sse"], {
-        error: (issue) => issue.input === "stdio"
-            ? STDIO_REJECTION
-            : 'must declare a remote transport ("http" or "sse")',
-    }),
-    url: z
-        .string("must be a non-empty URL")
-        .refine((url) => url.trim().length > 0, "must be a non-empty URL"),
-    headers: z.record(z.string(), z.string()).optional(),
-    ...toolSelectionConnectorFields,
-})
-    .check((ctx) => {
-    checkToolSelectionOverlap(ctx, ctx.value);
-});
+import { connections, isConnectionReference, } from "../../connections.js";
+import { mcpServersConfig } from "./schema.js";
+import { selectTools } from "../tool-selection.js";
 /**
- * The MCP connector's arguments.
+ * MCP tools loaded per declared connector, cached for the process lifetime.
  *
- * Shape, types, and tool-name lists are the schema's job; the rules that need
- * more than one field — a stdio server, a tool selected and deselected at once
- * — are checks with hand-written messages. Server configs stay loose because
- * `@langchain/mcp-adapters` accepts more per-transport options than MDA models.
+ * The compiled entry's graph factory runs `compileManagedAgent` on every
+ * invocation, but each connector's MCP connection and tool surface are stable
+ * for the life of the deployment — so the client is created and its tools
+ * loaded once per declaration, and every subsequent run reuses them. Storing
+ * the in-flight promise also dedupes concurrent first runs for the same
+ * connector. Multiple `defineMcp(...)` modules each get their own entry.
+ *
+ * An agent-owned connection is read into this cache once, so rotating that
+ * secret takes a redeploy. Servers with a user-owned connection are omitted
+ * entirely; the credential gate loads those per caller.
  */
-const mcpServersConfig = z.object({
-    mcpServers: z
-        .record(z.string(), remoteMcpServer, {
-        error: "must be an object mapping server names to remote MCP server configs",
-    })
-        .refine((servers) => Object.keys(servers).length > 0, "requires at least one entry"),
-    prefixToolNameWithServerName: z.boolean().optional(),
-    throwOnLoadError: z.boolean().optional(),
-    useStandardContentBlocks: z.boolean().optional(),
-    onConnectionError: z.literal("throw").optional(),
-});
+const cachedTools = new Map();
+/**
+ * Load (and cache) the MCP tools for one connector declaration.
+ *
+ * A failed load is never cached, so a transient connection error on the first
+ * run can be retried on the next, but a misconfigured deployment surfaces the
+ * error rather than silently starting with no tools.
+ */
+export function loadManagedMcpTools(connectors) {
+    const cached = cachedTools.get(connectors);
+    if (cached) {
+        return cached;
+    }
+    const loading = createClientAndLoadTools(connectors).catch((error) => {
+        cachedTools.delete(connectors);
+        throw error;
+    });
+    cachedTools.set(connectors, loading);
+    return loading;
+}
+/** Clear the process-level MCP tool cache. Test-only. */
+export function clearManagedMcpToolsCacheForTests(connectors) {
+    if (connectors) {
+        cachedTools.delete(connectors);
+        return;
+    }
+    cachedTools.clear();
+}
+/**
+ * The credential gate's view of the declared MCP connectors.
+ *
+ * One consumer per declaration that names a user-owned connection; a
+ * declaration that needs no grant never reaches the gate.
+ */
+export function mcpCredentialConsumers(connectors) {
+    const out = [];
+    for (const connector of connectors ?? []) {
+        if (!connector ||
+            typeof connector !== "object" ||
+            connector.kind !== "mcp_servers") {
+            continue;
+        }
+        const definition = connector;
+        const userConnections = userConnectionReferences(definition);
+        if (userConnections.length === 0) {
+            continue;
+        }
+        out.push({
+            declaration: definition,
+            credentials: userConnections,
+            load: (accessTokens) => loadUserConnectionMcpTools(definition, accessTokens),
+        });
+    }
+    return out;
+}
+/** The declared references themselves: the gate checks their owner. */
+function userConnectionReferences(connectors) {
+    const bySlug = new Map();
+    for (const server of Object.values(connectors.servers)) {
+        if (usesUserConnection(server)) {
+            const connection = server.connection;
+            bySlug.set(connection.slug, connection);
+        }
+    }
+    return [...bySlug.values()];
+}
+function agentConnectionReferences(connectors) {
+    const bySlug = new Map();
+    for (const server of Object.values(connectors.servers)) {
+        const connection = server.connection;
+        if (isConnectionReference(connection) &&
+            connection.owner.type === "agent") {
+            bySlug.set(connection.slug, connection);
+        }
+    }
+    return [...bySlug.values()];
+}
+function mcpRequirements(name, connectors) {
+    const userSlugs = userConnectionReferences(connectors)
+        .map((connection) => connection.slug)
+        .sort();
+    const agentSlugs = agentConnectionReferences(connectors)
+        .map((connection) => connection.slug)
+        .sort();
+    return {
+        name,
+        provider: "mcp",
+        autoReply: false,
+        requiredPermissions: [],
+        requiredEnv: [],
+        userConnections: userSlugs,
+        agentConnections: agentSlugs,
+        providerConfig: {},
+    };
+}
+async function createClientAndLoadTools(connectors) {
+    const { eager, userConnection } = partitionMcpServers(connectors.servers);
+    if (userConnection.length > 0) {
+        warnDeferredUserConnectionServers(userConnection);
+    }
+    if (Object.keys(eager).length === 0) {
+        return [];
+    }
+    const { tools } = await loadToolsFromServers(connectors, await withAgentConnections(eager));
+    return tools;
+}
 /**
- * Declare the MCP servers whose tools should be loaded and added to the managed
- * Deep Agent at runtime.
+ * Load tools for user-connection servers, once the gate has confirmed the
+ * caller's grants.
  *
- * The tools hook runs at agent-graph construction time (inside the managed
- * runtime), so the MCP client loader is imported lazily — authoring-only
- * installs never pull in `@langchain/mcp-adapters`.
+ * Not process-cached here: the Authorization header is per caller, so the gate
+ * owns both the cache and closing the returned transport.
  */
-export const mcpConnector = defineExtension("connector", {
+export async function loadUserConnectionMcpTools(connectors, accessTokens) {
+    const { userConnection } = partitionMcpServers(connectors.servers);
+    const connectable = {};
+    for (const name of userConnection) {
+        const server = connectors.servers[name];
+        const connection = server?.connection;
+        if (!server || !isConnectionReference(connection)) {
+            continue;
+        }
+        const accessToken = accessTokens.get(connection.slug);
+        if (!accessToken) {
+            throw new Error(`MCP user connection "${connection.slug}" has no access token`);
+        }
+        connectable[name] = withBearer(server, accessToken);
+    }
+    if (Object.keys(connectable).length === 0) {
+        return { tools: [], close: async () => { } };
+    }
+    const { tools, client } = await loadToolsFromServers(connectors, connectable);
+    return { tools, close: () => client.close() };
+}
+/** Resolve each agent-owned connection into a static bearer header. */
+async function withAgentConnections(servers) {
+    const out = {};
+    for (const [name, server] of Object.entries(servers)) {
+        const connection = server.connection;
+        out[name] = isConnectionReference(connection)
+            ? withBearer(server, await connections.resolveDeploymentSecret(connection.slug))
+            : server;
+    }
+    return out;
+}
+function withBearer(server, token) {
+    const headers = Object.fromEntries(Object.entries(server.headers ?? {}).filter(([name]) => name.toLowerCase() !== "authorization"));
+    return {
+        ...server,
+        headers: { ...headers, Authorization: `Bearer ${token}` },
+    };
+}
+function usesUserConnection(server) {
+    return (isConnectionReference(server.connection) &&
+        server.connection.owner.type === "user");
+}
+function partitionMcpServers(servers) {
+    const eager = {};
+    const userConnection = [];
+    for (const [name, server] of Object.entries(servers)) {
+        if (usesUserConnection(server)) {
+            userConnection.push(name);
+        }
+        else {
+            eager[name] = server;
+        }
+    }
+    return { eager, userConnection };
+}
+function warnDeferredUserConnectionServers(serverNames) {
+    console.warn(`[managed-deepagents] MCP server(s) ${serverNames.join(", ")} declare ` +
+        `a user connection; tools load after the pre-run credential gate ` +
+        `confirms grants for the caller.`);
+}
+function stripManagedToolSelection(servers) {
+    return Object.fromEntries(Object.entries(servers).map(([name, server]) => {
+        const { includeTools: _includeTools, excludeTools: _excludeTools, connection: _connection, ...clientConfig } = server;
+        return [name, clientConfig];
+    }));
+}
+async function loadToolsFromServers(connectors, connectable) {
+    const prefixToolNameWithServerName = connectors.prefixToolNameWithServerName ?? true;
+    const client = new MultiServerMCPClient({
+        mcpServers: stripManagedToolSelection(connectable),
+        prefixToolNameWithServerName,
+        throwOnLoadError: connectors.throwOnLoadError ?? true,
+        useStandardContentBlocks: connectors.useStandardContentBlocks ?? true,
+        onConnectionError: connectors.onConnectionError ?? "throw",
+    });
+    try {
+        const tools = await loadToolsByServer(client, connectable, prefixToolNameWithServerName);
+        if (!prefixToolNameWithServerName) {
+            assertNoToolNameCollisions(tools);
+        }
+        return { tools, client };
+    }
+    catch (error) {
+        await client.close().catch(() => undefined);
+        throw error;
+    }
+}
+async function loadToolsByServer(client, servers, prefixToolNameWithServerName) {
+    const tools = [];
+    for (const [serverName, server] of Object.entries(servers)) {
+        const serverTools = await client.getTools(serverName);
+        tools.push(...filterToolsForServer(serverName, server, serverTools, prefixToolNameWithServerName));
+    }
+    return tools;
+}
+function filterToolsForServer(serverName, selection, tools, prefixToolNameWithServerName) {
+    return selectTools(`MCP server "${serverName}"`, selection, tools, (tool) => {
+        const name = tool.name;
+        if (typeof name !== "string") {
+            return undefined;
+        }
+        const prefix = `${serverName}__`;
+        return prefixToolNameWithServerName && name.startsWith(prefix)
+            ? name.slice(prefix.length)
+            : name;
+    });
+}
+function assertNoToolNameCollisions(tools) {
+    const seen = new Set();
+    const collisions = new Set();
+    for (const tool of tools) {
+        const name = tool.name;
+        if (typeof name !== "string")
+            continue;
+        if (seen.has(name))
+            collisions.add(name);
+        seen.add(name);
+    }
+    if (collisions.size > 0) {
+        throw new Error(`MCP tool name collision: ${[...collisions].sort().join(", ")}. ` +
+            "Set `prefixToolNameWithServerName: true` (the default) so each tool is " +
+            "namespaced by its server, or rename the conflicting tools.");
+    }
+}
+/** Declare remote MCP servers whose tools load at agent-graph construction. */
+export const defineMcp = defineExtension("connector", {
     kind: "mcp_servers",
-    label: "connectors.mcp",
+    label: "defineMcp",
     args: mcpServersConfig,
-    async tools(_ctx, self) {
-        const { loadManagedMcpTools } = await import("./load.js");
-        return loadManagedMcpTools(self);
-    },
+    tools: (_ctx, self) => loadManagedMcpTools(self),
+    requirements: (name, self) => mcpRequirements(name, self),
 });
 //# sourceMappingURL=index.js.map

package/dist/connectors/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/connectors/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA8FrD,8EAA8E;AAC9E,MAAM,eAAe,GACnB,sEAAsE;IACtE,6EAA6E;IAC7E,0CAA0C,CAAC;AAE7C,MAAM,eAAe,GAAG,CAAC;KACtB,WAAW,CAAC;IACX,2EAA2E;IAC3E,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvD,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;QACjC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,KAAK,CAAC,KAAK,KAAK,OAAO;YACrB,CAAC,CAAC,eAAe;YACjB,CAAC,CAAC,mDAAmD;KAC1D,CAAC;IACF,GAAG,EAAE,CAAC;SACH,MAAM,CAAC,yBAAyB,CAAC;SACjC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,yBAAyB,CAAC;IACpE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,GAAG,4BAA4B;CAChC,CAAC;KACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACb,yBAAyB,CAAC,GAAG,EAAE,GAAG,CAAC,KAAsB,CAAC,CAAC;AAC7D,CAAC,CAAC,CAAC;AAEL;;;;;;;GAOG;AACH,MAAM,gBAAgB,GACpB,CAAC,CAAC,MAAM,CAAC;IACP,UAAU,EAAE,CAAC;SACV,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,EAAE;QACnC,KAAK,EACH,qEAAqE;KACxE,CAAC;SACD,MAAM,CACL,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAC5C,6BAA6B,CAC9B;IACH,4BAA4B,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpD,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACxC,wBAAwB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChD,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAEL;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GACvB,eAAe,CAAC,WAAW,EAAE;IAC3B,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,gBAAgB;IACvB,IAAI,EAAE,gBAAgB;IACtB,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI;QACpB,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QAC1D,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/connectors/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,WAAW,EACX,qBAAqB,GAEtB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAUnD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,EAA4C,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAgC;IAEhC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,OAAO,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACnE,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC/B,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACH,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,iCAAiC,CAC/C,UAAiC;IAEjC,IAAI,UAAU,EAAE,CAAC;QACf,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC/B,OAAO;IACT,CAAC;IACD,WAAW,CAAC,KAAK,EAAE,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAA0C;IAE1C,MAAM,GAAG,GAAyB,EAAE,CAAC;IACrC,KAAK,MAAM,SAAS,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;QACzC,IACE,CAAC,SAAS;YACV,OAAO,SAAS,KAAK,QAAQ;YAC5B,SAA+B,CAAC,IAAI,KAAK,aAAa,EACvD,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,UAAU,GAAG,SAAiC,CAAC;QACrD,MAAM,eAAe,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC;QAC7D,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC;YACP,WAAW,EAAE,UAAU;YACvB,WAAW,EAAE,eAAe;YAC5B,IAAI,EAAE,CAAC,YAAY,EAAE,EAAE,CACrB,0BAA0B,CAAC,UAAU,EAAE,YAAY,CAAC;SACvD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,uEAAuE;AACvE,SAAS,wBAAwB,CAC/B,UAAgC;IAEhC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;IACtD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAiC,CAAC;YAC5D,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,yBAAyB,CAChC,UAAgC;IAEhC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;IACtD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACrC,IACE,qBAAqB,CAAC,UAAU,CAAC;YACjC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,EACjC,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,eAAe,CACtB,IAAY,EACZ,UAAgC;IAEhC,MAAM,SAAS,GAAG,wBAAwB,CAAC,UAAU,CAAC;SACnD,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;SACpC,IAAI,EAAE,CAAC;IACV,MAAM,UAAU,GAAG,yBAAyB,CAAC,UAAU,CAAC;SACrD,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;SACpC,IAAI,EAAE,CAAC;IACV,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,KAAK;QAChB,mBAAmB,EAAE,EAAE;QACvB,WAAW,EAAE,EAAE;QACf,eAAe,EAAE,SAAS;QAC1B,gBAAgB,EAAE,UAAU;QAC5B,cAAc,EAAE,EAAE;KACnB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,UAAgC;IAEhC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,mBAAmB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAE1E,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,iCAAiC,CAAC,cAAc,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,oBAAoB,CAC1C,UAAU,EACV,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAClC,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,UAAgC,EAChC,YAAyC;IAEzC,MAAM,EAAE,cAAc,EAAE,GAAG,mBAAmB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAEnE,MAAM,WAAW,GAAoC,EAAE,CAAC;IACxD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,MAAM,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,EAAE,CAAC;YAClD,SAAS;QACX,CAAC;QACD,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,wBAAwB,UAAU,CAAC,IAAI,uBAAuB,CAC/D,CAAC;QACJ,CAAC;QACD,WAAW,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,oBAAoB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAC9E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;AAChD,CAAC;AAED,uEAAuE;AACvE,KAAK,UAAU,oBAAoB,CACjC,OAAwC;IAExC,MAAM,GAAG,GAAoC,EAAE,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACrC,GAAG,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,UAAU,CAAC;YAC3C,CAAC,CAAC,UAAU,CACR,MAAM,EACN,MAAM,WAAW,CAAC,uBAAuB,CAAC,UAAU,CAAC,IAAI,CAAC,CAC3D;YACH,CAAC,CAAC,MAAM,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CACjB,MAA6B,EAC7B,KAAa;IAEb,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAChC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CACzC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,eAAe,CACnD,CACF,CAAC;IACF,OAAO;QACL,GAAG,MAAM;QACT,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE;KAC1D,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,MAA6B;IACvD,OAAO,CACL,qBAAqB,CAAC,MAAM,CAAC,UAAU,CAAC;QACxC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CACxC,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAwC;IAInE,MAAM,KAAK,GAAoC,EAAE,CAAC;IAClD,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,iCAAiC,CAAC,WAAqB;IAC9D,OAAO,CAAC,IAAI,CACV,sCAAsC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW;QACrE,kEAAkE;QAClE,iCAAiC,CACpC,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAChC,OAAwC;IAExC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE;QAC7C,MAAM,EACJ,YAAY,EAAE,aAAa,EAC3B,YAAY,EAAE,aAAa,EAC3B,UAAU,EAAE,WAAW,EACvB,GAAG,YAAY,EAChB,GAAG,MAAM,CAAC;QACX,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC9B,CAAC,CAAC,CACgC,CAAC;AACvC,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,UAAgC,EAChC,WAA4C;IAE5C,MAAM,4BAA4B,GAChC,UAAU,CAAC,4BAA4B,IAAI,IAAI,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,oBAAoB,CAAC;QACtC,UAAU,EAAE,yBAAyB,CAAC,WAAW,CAAC;QAClD,4BAA4B;QAC5B,gBAAgB,EAAE,UAAU,CAAC,gBAAgB,IAAI,IAAI;QACrD,wBAAwB,EAAE,UAAU,CAAC,wBAAwB,IAAI,IAAI;QACrE,iBAAiB,EAAE,UAAU,CAAC,iBAAiB,IAAI,OAAO;KAC3D,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,iBAAiB,CACnC,MAAM,EACN,WAAW,EACX,4BAA4B,CAC7B,CAAC;QACF,IAAI,CAAC,4BAA4B,EAAE,CAAC;YAClC,0BAA0B,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,MAA4B,EAC5B,OAAwC,EACxC,4BAAqC;IAErC,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CACR,GAAG,oBAAoB,CACrB,UAAU,EACV,MAAM,EACN,WAAW,EACX,4BAA4B,CAC7B,CACF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAC3B,UAAkB,EAClB,SAAiC,EACjC,KAAgB,EAChB,4BAAqC;IAErC,OAAO,WAAW,CAAC,eAAe,UAAU,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;QAC1E,MAAM,IAAI,GAAI,IAA2B,CAAC,IAAI,CAAC;QAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,UAAU,IAAI,CAAC;QACjC,OAAO,4BAA4B,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAC5D,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YAC3B,CAAC,CAAC,IAAI,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAgB;IAClD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAI,IAA2B,CAAC,IAAI,CAAC;QAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAS;QACvC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,4BAA4B,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC/D,yEAAyE;YACzE,4DAA4D,CAC/D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,SAAS,GACpB,eAAe,CAAC,WAAW,EAAE;IAC3B,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,WAAW;IAClB,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC;IAChD,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC;CAC1D,CAAC,CAAC"}

package/dist/connectors/mcp/schema.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import type { McpServersArgs } from "./types.js";
+/** @internal */
+export declare const MCP_SERVERS_KEY_DEPRECATION = "mcpServers is deprecated; use servers instead. It will be removed in 0.8.0.";
+/**
+ * The MCP connector's arguments.
+ *
+ * Shape, types, and tool-name lists are the schema's job; the rules that need
+ * more than one field — a stdio server, a tool selected and deselected at once
+ * — are checks with hand-written messages. Server configs stay loose because
+ * `@langchain/mcp-adapters` accepts more per-transport options than MDA models.
+ *
+ * `mcpServers` is accepted as a deprecated alias of `servers` and is rewritten
+ * to `servers` so the stored definition has one key.
+ */
+export declare const mcpServersConfig: z.ZodType<McpServersArgs>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/connectors/mcp/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/connectors/mcp/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAejD,gBAAgB;AAChB,eAAO,MAAM,2BAA2B,gFACuC,CAAC;AAgEhF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAoDnD,CAAC"}

package/dist/connectors/mcp/schema.js

@@ -0,0 +1,122 @@
+import { z } from "zod";
+import { appendToolSelectionOverlapIssue, optionalToolNameListSchema, } from "../tool-selection.js";
+import { isConnectionReference, } from "../../connections.js";
+/** Stdio servers are out of scope; the message points at the alternatives. */
+const STDIO_REJECTION = "uses a stdio transport, which is not supported. Managed Deep Agents " +
+    "support remote MCP servers over HTTP/SSE only; expose the server over HTTP " +
+    "or write a normal authored tool instead.";
+const CREDENTIAL_FIELD_REJECTION = 'the "credential" field was removed; use connection: connections.get(slug, owner) instead';
+/** @internal */
+export const MCP_SERVERS_KEY_DEPRECATION = "mcpServers is deprecated; use servers instead. It will be removed in 0.8.0.";
+const SERVERS_MAP_ERROR = "must be an object mapping server names to remote MCP server configs";
+const SERVERS_KEY_CONFLICT = 'use either "servers" or "mcpServers", not both';
+function emitMcpServersKeyDeprecation() {
+    if (typeof process !== "undefined" &&
+        typeof process.emitWarning === "function") {
+        process.emitWarning(MCP_SERVERS_KEY_DEPRECATION, {
+            type: "DeprecationWarning",
+            code: "MDA_MCP_SERVERS",
+        });
+        return;
+    }
+    console.warn(MCP_SERVERS_KEY_DEPRECATION);
+}
+/** Raw MCP tool names, before the managed `{server}__` prefix is applied. */
+const remoteMcpServer = z
+    .looseObject({
+    /**
+     * Present only to reject it: a `command` is how a stdio server is defined,
+     * which we don't support.
+     */
+    command: z.never({ error: STDIO_REJECTION }).optional(),
+    transport: z.enum(["http", "sse"], {
+        error: (issue) => issue.input === "stdio"
+            ? STDIO_REJECTION
+            : 'must declare a remote transport ("http" or "sse")',
+    }),
+    url: z
+        .string("must be a non-empty URL")
+        .refine((url) => url.trim().length > 0, "must be a non-empty URL"),
+    headers: z.record(z.string(), z.string()).optional(),
+    defaultToolTimeout: z
+        .number("defaultToolTimeout must be a positive number")
+        .positive("defaultToolTimeout must be a positive number")
+        .optional(),
+    includeTools: optionalToolNameListSchema,
+    excludeTools: optionalToolNameListSchema,
+    credential: z.never({ error: CREDENTIAL_FIELD_REJECTION }).optional(),
+    connection: z
+        .custom(isConnectionReference, "must be a connections.get(slug, owner) reference")
+        .optional(),
+})
+    .check(appendToolSelectionOverlapIssue);
+const serverMap = z
+    .record(z.string(), remoteMcpServer, {
+    error: SERVERS_MAP_ERROR,
+})
+    .refine((servers) => Object.keys(servers).length > 0, "requires at least one entry");
+/**
+ * The MCP connector's arguments.
+ *
+ * Shape, types, and tool-name lists are the schema's job; the rules that need
+ * more than one field — a stdio server, a tool selected and deselected at once
+ * — are checks with hand-written messages. Server configs stay loose because
+ * `@langchain/mcp-adapters` accepts more per-transport options than MDA models.
+ *
+ * `mcpServers` is accepted as a deprecated alias of `servers` and is rewritten
+ * to `servers` so the stored definition has one key.
+ */
+export const mcpServersConfig = z
+    .object({
+    servers: serverMap.optional(),
+    mcpServers: serverMap.optional(),
+    prefixToolNameWithServerName: z.boolean().optional(),
+    throwOnLoadError: z.boolean().optional(),
+    useStandardContentBlocks: z.boolean().optional(),
+    onConnectionError: z.literal("throw").optional(),
+})
+    .check((ctx) => {
+    const { servers, mcpServers } = ctx.value;
+    if (servers !== undefined && mcpServers !== undefined) {
+        ctx.issues.push({
+            code: "custom",
+            input: ctx.value,
+            message: SERVERS_KEY_CONFLICT,
+            path: ["mcpServers"],
+        });
+        return;
+    }
+    if (servers === undefined && mcpServers === undefined) {
+        ctx.issues.push({
+            code: "custom",
+            input: ctx.value,
+            message: SERVERS_MAP_ERROR,
+            path: ["servers"],
+        });
+    }
+})
+    .transform((value) => {
+    const servers = value.servers ?? value.mcpServers;
+    if (servers === undefined) {
+        // The `.check` above reports this; keep the transform total.
+        return { servers: {} };
+    }
+    if (value.mcpServers !== undefined && value.servers === undefined) {
+        emitMcpServersKeyDeprecation();
+    }
+    const args = { servers };
+    if (value.prefixToolNameWithServerName !== undefined) {
+        args.prefixToolNameWithServerName = value.prefixToolNameWithServerName;
+    }
+    if (value.throwOnLoadError !== undefined) {
+        args.throwOnLoadError = value.throwOnLoadError;
+    }
+    if (value.useStandardContentBlocks !== undefined) {
+        args.useStandardContentBlocks = value.useStandardContentBlocks;
+    }
+    if (value.onConnectionError !== undefined) {
+        args.onConnectionError = value.onConnectionError;
+    }
+    return args;
+});
+//# sourceMappingURL=schema.js.map

package/dist/connectors/mcp/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/connectors/mcp/schema.ts"],"names":[],"mappings":"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"}

package/dist/connectors/mcp/types.d.ts

@@ -0,0 +1,81 @@
+import type { ClientConfig, StreamableHTTPConnection } from "@langchain/mcp-adapters";
+import type { Connector } from "../../runtime/connector.js";
+import type { ConnectionReference } from "../../connections.js";
+/** Per-server MCP tool selection. Names are raw, unprefixed MCP tool names. */
+export interface McpToolSelectionConfig {
+    /**
+     * Raw MCP tool names to expose from this server. Names are matched before any
+     * managed `{server}__` prefix is applied.
+     */
+    includeTools?: string[];
+    /**
+     * Raw MCP tool names to hide from this server. Names are matched before any
+     * managed `{server}__` prefix is applied.
+     */
+    excludeTools?: string[];
+}
+/** A connection reference resolved through Agent Auth at run time. */
+export type McpServerConnection = ConnectionReference;
+/** Adapter connection fields MDA forwards, excluding stdio/auth the runtime owns. */
+type AdapterRemoteConnection = Omit<StreamableHTTPConnection, "transport" | "type" | "authProvider">;
+/** Shared remote server options plus MDA-only tool selection and connection mode. */
+export type RemoteMcpServerBaseConfig = AdapterRemoteConnection & McpToolSelectionConfig & {
+    /**
+     * Bearer connection for this server, declared with `connections.get(...)`.
+     * An agent owner is a workspace-shared secret read once at load; a user
+     * owner is the caller's grant, loaded per caller after the gate.
+     */
+    connection?: McpServerConnection;
+};
+/** Streamable HTTP MCP server connection. */
+export type HttpMcpServerConfig = RemoteMcpServerBaseConfig & {
+    /** Remote transport. `"http"` selects Streamable HTTP. */
+    transport: "http";
+};
+/** Legacy SSE MCP server connection. */
+export type SseMcpServerConfig = RemoteMcpServerBaseConfig & {
+    /** Remote transport. `"sse"` selects legacy SSE. */
+    transport: "sse";
+};
+/** A remote MCP server connection. Stdio servers are intentionally excluded. */
+export type RemoteMcpServerConfig = HttpMcpServerConfig | SseMcpServerConfig;
+/** {@link MultiServerMCPClient} options MDA exposes on `defineMcp`. */
+type McpClientOptions = Pick<ClientConfig, "prefixToolNameWithServerName" | "throwOnLoadError" | "useStandardContentBlocks" | "onConnectionError">;
+/** Named remote MCP servers. Each key is the logical server name. */
+export type McpServerMap = Record<string, RemoteMcpServerConfig>;
+/**
+ * Configuration accepted by `defineMcp`.
+ *
+ * Prefer `servers`. `mcpServers` is a deprecated alias and will be removed in
+ * 0.8.0.
+ */
+export type McpServersConfig = McpClientOptions & ({
+    /**
+     * MCP servers to connect to. Each key is the logical server name MDA
+     * uses for validation, tracing metadata, and tool-name prefixing.
+     */
+    servers: McpServerMap;
+    mcpServers?: never;
+} | {
+    /**
+     * @deprecated Use {@link McpServersConfig} `servers` instead.
+     * `mcpServers` will be removed in 0.8.0.
+     */
+    mcpServers: McpServerMap;
+    servers?: never;
+});
+/** Parsed `defineMcp` arguments stored on the connector. Always `servers`. */
+export interface McpServersArgs extends McpClientOptions {
+    servers: McpServerMap;
+}
+/**
+ * The connector exported from a `connectors/` module for MCP. It is a branded
+ * managed {@link Connector} whose `tools` hook loads the declared MCP tools at
+ * runtime, plus the raw config the loader reads.
+ */
+export interface McpServersDefinition extends McpServersArgs, Connector {
+    /** Internal discriminator used by the MDA loader. */
+    readonly kind: "mcp_servers";
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/connectors/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/connectors/mcp/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,+EAA+E;AAC/E,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEtD,qFAAqF;AACrF,KAAK,uBAAuB,GAAG,IAAI,CACjC,wBAAwB,EACxB,WAAW,GAAG,MAAM,GAAG,cAAc,CACtC,CAAC;AAEF,qFAAqF;AACrF,MAAM,MAAM,yBAAyB,GAAG,uBAAuB,GAC7D,sBAAsB,GAAG;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC,CAAC;AAEJ,6CAA6C;AAC7C,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,GAAG;IAC5D,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wCAAwC;AACxC,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,GAAG;IAC3D,oDAAoD;IACpD,SAAS,EAAE,KAAK,CAAC;CAClB,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAE7E,uEAAuE;AACvE,KAAK,gBAAgB,GAAG,IAAI,CAC1B,YAAY,EACV,8BAA8B,GAC9B,kBAAkB,GAClB,0BAA0B,GAC1B,mBAAmB,CACtB,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAC7C,CACI;IACE;;;OAGG;IACH,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB,GACD;IACE;;;OAGG;IACH,UAAU,EAAE,YAAY,CAAC;IACzB,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB,CACJ,CAAC;AAEJ,8EAA8E;AAC9E,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,OAAO,EAAE,YAAY,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc,EAAE,SAAS;IACrE,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B"}

package/dist/connectors/mcp/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/connectors/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/connectors/mcp/types.ts"],"names":[],"mappings":""}