managed-deepagents 0.6.2-dev.4 → 0.6.2-dev.41

package/dist/connectors/mcp/load.js

@@ -1,122 +0,0 @@
-import { MultiServerMCPClient } from "@langchain/mcp-adapters";
-import { selectTools } from "../tool-selection.js";
-/**
- * MCP tools loaded per declared connector, cached for the process lifetime.
- *
- * 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 `connectors.mcp(...)` modules each get their own entry.
- */
-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. @internal Test-only. */
-export function clearManagedMcpToolsCacheForTests(connectors) {
-    if (connectors) {
-        cachedTools.delete(connectors);
-        return;
-    }
-    cachedTools.clear();
-}
-/**
- * Create the `@langchain/mcp-adapters` client from the declaration and load its
- * tools, applying the managed defaults the spec recommends.
- *
- * `@langchain/mcp-adapters` is a direct dependency of `managed-deepagents`, so
- * the client is imported statically at the top of the module.
- */
-async function createClientAndLoadTools(connectors) {
-    const prefixToolNameWithServerName = connectors.prefixToolNameWithServerName ?? true;
-    const client = new MultiServerMCPClient({
-        mcpServers: stripManagedToolSelection(connectors.mcpServers),
-        prefixToolNameWithServerName,
-        throwOnLoadError: connectors.throwOnLoadError ?? true,
-        useStandardContentBlocks: connectors.useStandardContentBlocks ?? true,
-        onConnectionError: connectors.onConnectionError ?? "throw",
-    });
-    const tools = await loadToolsByServer(client, connectors.mcpServers, prefixToolNameWithServerName);
-    // When prefixing is disabled, names can collide with authored tools or across
-    // servers. The spec only allows opting out if MDA validates no collisions.
-    if (!prefixToolNameWithServerName) {
-        assertNoToolNameCollisions(tools);
-    }
-    return tools;
-}
-function stripManagedToolSelection(servers) {
-    return Object.fromEntries(Object.entries(servers).map(([name, server]) => {
-        const { includeTools: _includeTools, excludeTools: _excludeTools, ...clientConfig } = server;
-        // `defaultToolTimeout` is a first-class `@langchain/mcp-adapters` option
-        // and stays on the server config. The Python adapter has no equivalent
-        // connection kwarg, so the PyPI loader strips it and wraps tools itself.
-        return [name, clientConfig];
-    }));
-}
-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;
-}
-/**
- * Apply a server's selection, matching against raw MCP tool names.
- *
- * The adapter has already applied the `{server}__` prefix by the time tools get
- * here, so the prefix is stripped back off for matching — an author selects the
- * name the server publishes, not the one MDA renamed it to.
- */
-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;
-    });
-}
-/**
- * Reject duplicate tool names among the loaded MCP tools. Only reached when the
- * author opted out of server-name prefixing.
- */
-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.");
-    }
-}
-//# sourceMappingURL=load.js.map

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

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