managed-deepagents 0.4.2 → 0.4.3-dev.95

package/dist/connectors/marketplace/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Marketplace MCP connectors — third-party MCP servers managed in LangSmith.
+ *
+ * Unlike {@link ../toolserver}, tools run on the vendor's MCP endpoint and are
+ * invoked through `POST /v1/mcp/proxy` with a vault subject. Factories are
+ * derived from {@link MARKETPLACE_MCP_INTEGRATIONS} so a new bridge is one
+ * catalog row (npm + PyPI).
+ */
+import type { Connector } from "../../runtime/connector.js";
+import { type ToolSelectionConnectorConfig } from "../tool-selection.js";
+import { type MarketplaceMcpIntegrationId, type MarketplaceMcpToolsFor } from "./catalog.js";
+export { MARKETPLACE_MCP_INTEGRATIONS, hasMarketplaceConnector, marketplaceIntegrationById, type MarketplaceMcpIntegration, type MarketplaceMcpIntegrationId, type MarketplaceMcpToolsFor, } from "./catalog.js";
+export { normalizeMcpUrl, resolveMarketplaceMcpServer, type FleetMcpServer, } from "./fleet-mcp.js";
+/** Configuration accepted by every `connectors.<marketplace>` factory. */
+export type MarketplaceConnectorConfig<TTool extends string = string> = ToolSelectionConnectorConfig<TTool>;
+export type MarketplaceConnectorFor<Id extends MarketplaceMcpIntegrationId> = Connector & MarketplaceConnectorConfig<MarketplaceMcpToolsFor<Id>> & {
+    kind: Id;
+};
+export type MarketplaceConnectorFactoryFor<Id extends MarketplaceMcpIntegrationId> = (config?: MarketplaceConnectorConfig<MarketplaceMcpToolsFor<Id>>) => MarketplaceConnectorFor<Id>;
+/** `connectors.<id>` factories for every marketplace catalog entry. */
+export type MarketplaceConnectors = {
+    [Id in MarketplaceMcpIntegrationId]: MarketplaceConnectorFactoryFor<Id>;
+};
+/**
+ * All marketplace connector factories keyed by integration id.
+ *
+ * Built from the catalog so a new bridge is one entry there rather than a
+ * namespace line that can be forgotten.
+ */
+export declare const marketplaceConnectors: MarketplaceConnectors;
+//# sourceMappingURL=index.d.ts.map

package/dist/connectors/marketplace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connectors/marketplace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,GAC5B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AAExB,0EAA0E;AAC1E,MAAM,MAAM,0BAA0B,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAClE,4BAA4B,CAAC,KAAK,CAAC,CAAC;AAEtC,MAAM,MAAM,uBAAuB,CAAC,EAAE,SAAS,2BAA2B,IACxE,SAAS,GACP,0BAA0B,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,GAAG;IACvD,IAAI,EAAE,EAAE,CAAC;CACV,CAAC;AAEN,MAAM,MAAM,8BAA8B,CACxC,EAAE,SAAS,2BAA2B,IACpC,CACF,MAAM,CAAC,EAAE,0BAA0B,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,KAC5D,uBAAuB,CAAC,EAAE,CAAC,CAAC;AAEjC,uEAAuE;AACvE,MAAM,MAAM,qBAAqB,GAAG;KACjC,EAAE,IAAI,2BAA2B,GAAG,8BAA8B,CAAC,EAAE,CAAC;CACxE,CAAC;AA2BF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,qBAKV,CAAC"}

package/dist/connectors/marketplace/index.js

@@ -0,0 +1,39 @@
+/**
+ * Marketplace MCP connectors — third-party MCP servers managed in LangSmith.
+ *
+ * Unlike {@link ../toolserver}, tools run on the vendor's MCP endpoint and are
+ * invoked through `POST /v1/mcp/proxy` with a vault subject. Factories are
+ * derived from {@link MARKETPLACE_MCP_INTEGRATIONS} so a new bridge is one
+ * catalog row (npm + PyPI).
+ */
+import { defineExtension } from "../../extension.js";
+import { toolSelectionConnectorSchema, } from "../tool-selection.js";
+import { MARKETPLACE_MCP_INTEGRATIONS, } from "./catalog.js";
+export { MARKETPLACE_MCP_INTEGRATIONS, hasMarketplaceConnector, marketplaceIntegrationById, } from "./catalog.js";
+export { normalizeMcpUrl, resolveMarketplaceMcpServer, } from "./fleet-mcp.js";
+function marketplaceTools(integration, label) {
+    return async (_ctx, self) => {
+        const { loadMarketplaceTools } = await import("./load.js");
+        return loadMarketplaceTools(integration, label, self);
+    };
+}
+function marketplaceConnectorFactory(integration) {
+    const label = `connectors.${integration.id}`;
+    return defineExtension("connector", {
+        kind: integration.id,
+        label,
+        args: toolSelectionConnectorSchema(),
+        tools: marketplaceTools(integration, label),
+    });
+}
+/**
+ * All marketplace connector factories keyed by integration id.
+ *
+ * Built from the catalog so a new bridge is one entry there rather than a
+ * namespace line that can be forgotten.
+ */
+export const marketplaceConnectors = Object.fromEntries(MARKETPLACE_MCP_INTEGRATIONS.map((entry) => [
+    entry.id,
+    marketplaceConnectorFactory(entry),
+]));
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/connectors/marketplace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EACL,4BAA4B,GAE7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,4BAA4B,GAI7B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,GAI3B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,2BAA2B,GAE5B,MAAM,gBAAgB,CAAC;AAuBxB,SAAS,gBAAgB,CACvB,WAAsC,EACtC,KAAa;IAEb,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAC1B,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3D,OAAO,oBAAoB,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAClC,WAAsC;IAEtC,MAAM,KAAK,GAAG,cAAc,WAAW,CAAC,EAAE,EAAE,CAAC;IAC7C,OAAO,eAAe,CAAC,WAAW,EAAE;QAClC,IAAI,EAAE,WAAW,CAAC,EAAE;QACpB,KAAK;QACL,IAAI,EAAE,4BAA4B,EAG/B;QACH,KAAK,EAAE,gBAAgB,CAAC,WAAW,EAAE,KAAK,CAAC;KAC5C,CAAuD,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA0B,MAAM,CAAC,WAAW,CAC5E,4BAA4B,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;IAC1C,KAAK,CAAC,EAAE;IACR,2BAA2B,CAAC,KAAK,CAAC;CACnC,CAAC,CACsB,CAAC"}

package/dist/connectors/marketplace/load.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Load marketplace MCP tools through LangSmith's `POST /api/v1/mcp/proxy`.
+ *
+ * Unlike toolserver (bare Streamable HTTP to `/v1/toolserver/servers/{slug}/mcp`),
+ * marketplace invoke uses an HTTP-over-JSON envelope. Credentials never leave
+ * the vault — the proxy mints a bearer for `agent_id` / `ls_user_id`.
+ */
+import { type ToolSelectionConnectorConfig } from "../tool-selection.js";
+import type { MarketplaceMcpIntegration } from "./catalog.js";
+export type MarketplaceConnectorConfig = ToolSelectionConnectorConfig;
+/** Load (and cache) tools for one marketplace connector declaration. */
+export declare function loadMarketplaceTools(integration: MarketplaceMcpIntegration, label: string, connector: MarketplaceConnectorConfig & object): Promise<unknown[]>;
+export declare function clearMarketplaceToolsCacheForTests(connector: object): void;
+//# sourceMappingURL=load.d.ts.map

package/dist/connectors/marketplace/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../src/connectors/marketplace/load.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAS9D,MAAM,MAAM,0BAA0B,GAAG,4BAA4B,CAAC;AAEtE,wEAAwE;AACxE,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,yBAAyB,EACtC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,0BAA0B,GAAG,MAAM,GAC7C,OAAO,CAAC,OAAO,EAAE,CAAC,CAuBpB;AAED,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE1E"}

package/dist/connectors/marketplace/load.js

@@ -0,0 +1,206 @@
+/**
+ * Load marketplace MCP tools through LangSmith's `POST /api/v1/mcp/proxy`.
+ *
+ * Unlike toolserver (bare Streamable HTTP to `/v1/toolserver/servers/{slug}/mcp`),
+ * marketplace invoke uses an HTTP-over-JSON envelope. Credentials never leave
+ * the vault — the proxy mints a bearer for `agent_id` / `ls_user_id`.
+ */
+import { DynamicStructuredTool } from "@langchain/core/tools";
+import { z } from "zod";
+import { agentIdFromActor, isActorSubjectIntegrationEnabled, } from "../../identity/actor-subject.js";
+import { rewriteFleetToolError } from "../../identity/fleet-connect-hint.js";
+import { resolveFleetApiUrl, resolveFleetHeaders, } from "../../identity/fleet.js";
+import { marketplaceAsFleetHint } from "../../identity/marketplace/index.js";
+import { managedRuntimeOverrides } from "../../runtime/managed-tools.js";
+import { fetchWithTimeout, PROVIDER_HTTP_TIMEOUT_MS, } from "../../runtime/http.js";
+import { selectTools, } from "../tool-selection.js";
+import { parseMcpProxyResponseBody, resolveMarketplaceMcpServer, resolveSmithBackendV1Url, } from "./fleet-mcp.js";
+const schemaCache = new WeakMap();
+/** Load (and cache) tools for one marketplace connector declaration. */
+export function loadMarketplaceTools(integration, label, connector) {
+    if (connector.includeTools?.length === 0) {
+        return Promise.resolve([]);
+    }
+    const cached = schemaCache.get(connector);
+    if (cached) {
+        return cached;
+    }
+    const loading = connectAndLoadTools(integration, label, connector)
+        .then((tools) => {
+        // Empty pre-connect fallbacks must not stick forever — a later load may
+        // discover tools once the workspace/actor connection exists.
+        if (tools.length === 0) {
+            schemaCache.delete(connector);
+        }
+        return tools;
+    })
+        .catch((error) => {
+        schemaCache.delete(connector);
+        throw error;
+    });
+    schemaCache.set(connector, loading);
+    return loading;
+}
+export function clearMarketplaceToolsCacheForTests(connector) {
+    schemaCache.delete(connector);
+}
+async function connectAndLoadTools(integration, label, config) {
+    // Actor-subject agent_id is resolved per invoke inside buildProxyTool —
+    // no outer wrap / re-list is needed (unlike toolserver MCP, where the
+    // session URL binds agent_id at connect time).
+    const listAgentId = trimmed(process.env.MDA_TOOLSERVER_AGENT_ID);
+    return loadToolsForAgentId(integration, label, config, listAgentId);
+}
+async function loadToolsForAgentId(integration, label, config, agentId) {
+    const server = await resolveMarketplaceMcpServer({
+        mcpUrl: integration.mcpUrl,
+    });
+    const providerId = server.oauth_provider_id.trim();
+    const listed = await listProxyTools({
+        integration,
+        oauthProviderId: providerId,
+        agentId,
+        label,
+    });
+    const tools = listed.map((entry) => buildProxyTool(entry, integration, providerId, config, agentId, label));
+    return selectTools(label, config, tools);
+}
+async function listProxyTools(options) {
+    const env = process.env;
+    const base = resolveFleetApiUrl(env);
+    const headers = resolveFleetHeaders(options.label, env);
+    const params = new URLSearchParams({
+        url: options.integration.mcpUrl,
+        oauth_provider_id: options.oauthProviderId,
+    });
+    if (options.agentId) {
+        params.set("agent_id", options.agentId);
+    }
+    const toolsUrl = new URL(resolveSmithBackendV1Url(base, "mcp/tools"));
+    toolsUrl.search = params.toString();
+    const response = await fetchWithTimeout(toolsUrl.toString(), { method: "GET", headers }, PROVIDER_HTTP_TIMEOUT_MS, fetch);
+    if (response.status === 428 || response.status === 401) {
+        // No subject / connection yet — expose catalog names so the agent can still
+        // be authored; invoke will fail with a connect hint once identity is present.
+        return options.integration.tools.map((name) => ({
+            name,
+            description: `${name} (connect required)`,
+            inputSchema: {
+                type: "object",
+                properties: {},
+                additionalProperties: true,
+            },
+        }));
+    }
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new Error(`${options.label}: list marketplace tools failed (${response.status}): ${text || response.statusText}`);
+    }
+    const json = (await response.json());
+    return (json.tools ?? []).filter((tool) => typeof tool?.name === "string" && tool.name.length > 0);
+}
+function buildProxyTool(entry, integration, providerId, config, fixedAgentId, label) {
+    const schema = jsonSchemaToZod(entry.inputSchema);
+    return new DynamicStructuredTool({
+        name: entry.name,
+        description: entry.description ?? entry.name,
+        schema,
+        func: async (input, _runManager, runtime) => {
+            const runtimeConfig = runtime;
+            const agentId = resolveInvokeAgentId(runtimeConfig, integration.id) ?? fixedAgentId;
+            try {
+                return await callProxyTool({
+                    url: integration.mcpUrl,
+                    oauthProviderId: providerId,
+                    agentId,
+                    toolName: entry.name,
+                    args: input,
+                    label,
+                    timeoutMs: config.defaultToolTimeout,
+                });
+            }
+            catch (error) {
+                throw rewriteFleetToolError(error, marketplaceAsFleetHint(integration, providerId));
+            }
+        },
+    });
+}
+function resolveInvokeAgentId(runtime, integrationId) {
+    if (isActorSubjectIntegrationEnabled(integrationId)) {
+        const identity = managedRuntimeOverrides(runtime).identity;
+        const userId = identity?.user?.id;
+        if (userId) {
+            return agentIdFromActor(userId);
+        }
+    }
+    return trimmed(process.env.MDA_TOOLSERVER_AGENT_ID);
+}
+async function callProxyTool(options) {
+    if (!options.agentId) {
+        throw new Error(`${options.label}: marketplace tool "${options.toolName}" needs an agent subject ` +
+            `(Connect-with-${options.label.replace(/^connectors\./, "")} or MDA_TOOLSERVER_AGENT_ID)`);
+    }
+    const env = process.env;
+    const base = resolveFleetApiUrl(env);
+    const headers = resolveFleetHeaders(options.label, env);
+    // Envelope timeout is seconds (smith-backend). Keep the local fetch budget
+    // at least as long, plus a small transport allowance — otherwise
+    // `defaultToolTimeout` above PROVIDER_HTTP_TIMEOUT_MS is silently truncated.
+    const timeoutMs = Math.min(Math.max(options.timeoutMs ?? 120_000, 1_000), 120_000);
+    const timeoutSeconds = timeoutMs / 1000;
+    const httpTimeoutMs = timeoutMs + 5_000;
+    // Forwarded to the vendor MCP by smith-backend's proxy. Notion (and other
+    // Streamable HTTP servers) reject requests that omit text/event-stream.
+    const mcpHeaders = {
+        "Content-Type": "application/json",
+        Accept: "application/json, text/event-stream",
+        "MCP-Protocol-Version": "2025-11-25",
+    };
+    const body = {
+        url: options.url,
+        method: "POST",
+        oauth_provider_id: options.oauthProviderId,
+        agent_id: options.agentId,
+        timeout: timeoutSeconds,
+        headers: mcpHeaders,
+        body: {
+            jsonrpc: "2.0",
+            id: 1,
+            method: "tools/call",
+            params: {
+                name: options.toolName,
+                arguments: options.args && typeof options.args === "object" ? options.args : {},
+            },
+        },
+    };
+    const response = await fetchWithTimeout(resolveSmithBackendV1Url(base, "mcp/proxy"), {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+    }, httpTimeoutMs, fetch);
+    const text = await response.text().catch(() => "");
+    if (!response.ok) {
+        throw new Error(`${options.label}: marketplace tool "${options.toolName}" failed (${response.status}): ${text || response.statusText}`);
+    }
+    return parseMcpProxyResponseBody(text);
+}
+/** Best-effort JSON Schema → Zod object (additionalProperties open). */
+function jsonSchemaToZod(inputSchema) {
+    if (!inputSchema || typeof inputSchema !== "object") {
+        return z.record(z.string(), z.unknown());
+    }
+    const properties = inputSchema.properties;
+    if (!properties || typeof properties !== "object") {
+        return z.record(z.string(), z.unknown());
+    }
+    const shape = {};
+    for (const key of Object.keys(properties)) {
+        shape[key] = z.unknown().optional();
+    }
+    return z.looseObject(shape);
+}
+function trimmed(value) {
+    const v = value?.trim();
+    return v ? v : undefined;
+}
+//# sourceMappingURL=load.js.map

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

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

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

@@ -1,13 +1,11 @@
 /**
  * The managed `connectors/` declaration primitive.
  *
- * For the first connector iteration, a connector means exactly one thing: MCP
- * servers. A Managed Deep Agent declares the remote MCP servers whose tools it
- * wants in `connectors/mcp.ts` by exporting a named `mcp` from
- * {@link defineMcpServers}. 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()`.
+ * A Managed Deep Agent declares the remote MCP servers whose tools it wants in
+ * `connectors/mcp.ts` with `connectors.mcp(...)`. 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()`.
  *
  * Only remote MCP servers over HTTP/SSE are supported. Stdio MCP servers are
  * intentionally out of scope: they introduce process management, packaging, and
@@ -20,12 +18,9 @@
  * @example
  * ```ts
  * // connectors/mcp.ts
- * import { defineMcpServers } from "managed-deepagents";
+ * import { connectors } from "managed-deepagents";
  *
- * export const mcp = defineMcpServers({
- *   useStandardContentBlocks: true,
- *   prefixToolNameWithServerName: true,
- *   throwOnLoadError: true,
+ * export const connector = connectors.mcp({
  *   mcpServers: {
  *     docs: {
  *       transport: "http",
@@ -35,7 +30,7 @@
  * });
  * ```
  */
-import { type Connector } from "../../runtime/connector.js";
+import type { Connector } from "../../runtime/connector.js";
 /** Per-server MCP tool selection. Names are raw, unprefixed MCP tool names. */
 export interface McpToolSelectionConfig {
     /**
@@ -81,7 +76,7 @@ export interface SseMcpServerConfig extends RemoteMcpServerBaseConfig {
 }
 /** A remote MCP server connection. Stdio servers are intentionally excluded. */
 export type RemoteMcpServerConfig = HttpMcpServerConfig | SseMcpServerConfig;
-/** Configuration accepted by {@link defineMcpServers}. */
+/** Configuration accepted by `connectors.mcp`. */
 export interface McpServersConfig {
     /**
      * MCP servers to connect to. Each key is the logical server name MDA uses
@@ -124,11 +119,9 @@ export interface McpServersDefinition extends McpServersConfig, Connector {
  * Declare the MCP servers whose tools should be loaded and added to the managed
  * Deep Agent at runtime.
  *
- * Validates the config eagerly so misconfiguration surfaces at module load
- * (build/dev startup) rather than mid-run: at least one server must be
- * declared, and every server must use a remote transport (`"http"` or
- * `"sse"`). Stdio servers and invalid tool selectors are rejected with a clear
- * error.
+ * 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`.
  */
-export declare function defineMcpServers(config: McpServersConfig): McpServersDefinition;
+export declare const mcpConnector: (config: McpServersConfig) => McpServersDefinition;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connectors/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE7E,+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,4DAA4D;AAC5D,MAAM,WAAW,yBAA0B,SAAQ,sBAAsB;IACvE,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAoB,SAAQ,yBAAyB;IACpE,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAmB,SAAQ,yBAAyB;IACnE,oDAAoD;IACpD,SAAS,EAAE,KAAK,CAAC;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,gFAAgF;AAChF,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAE7E,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAClD;;;;OAIG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB,EAAE,SAAS;IACvE,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,gBAAgB,GACvB,oBAAoB,CA2CtB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connectors/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,+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,4DAA4D;AAC5D,MAAM,WAAW,yBAA0B,SAAQ,sBAAsB;IACvE,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAoB,SAAQ,yBAAyB;IACpE,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAmB,SAAQ,yBAAyB;IACnE,oDAAoD;IACpD,SAAS,EAAE,KAAK,CAAC;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,gFAAgF;AAChF,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAE7E,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAClD;;;;OAIG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB,EAAE,SAAS;IACvE,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAyFD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,oBASrD,CAAC"}

package/dist/connectors/mcp/index.js

@@ -1,13 +1,11 @@
 /**
  * The managed `connectors/` declaration primitive.
  *
- * For the first connector iteration, a connector means exactly one thing: MCP
- * servers. A Managed Deep Agent declares the remote MCP servers whose tools it
- * wants in `connectors/mcp.ts` by exporting a named `mcp` from
- * {@link defineMcpServers}. 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()`.
+ * A Managed Deep Agent declares the remote MCP servers whose tools it wants in
+ * `connectors/mcp.ts` with `connectors.mcp(...)`. 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()`.
  *
  * Only remote MCP servers over HTTP/SSE are supported. Stdio MCP servers are
  * intentionally out of scope: they introduce process management, packaging, and
@@ -20,12 +18,9 @@
  * @example
  * ```ts
  * // connectors/mcp.ts
- * import { defineMcpServers } from "managed-deepagents";
+ * import { connectors } from "managed-deepagents";
  *
- * export const mcp = defineMcpServers({
- *   useStandardContentBlocks: true,
- *   prefixToolNameWithServerName: true,
- *   throwOnLoadError: true,
+ * export const connector = connectors.mcp({
  *   mcpServers: {
  *     docs: {
  *       transport: "http",
@@ -35,109 +30,94 @@
  * });
  * ```
  */
-import { CONNECTOR_BRAND } from "../../runtime/connector.js";
+import { z } from "zod";
+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.";
+/** Raw MCP tool names, before the managed `{server}__` prefix is applied. */
+const toolNames = z
+    .array(z
+    .string("must be a non-empty tool name")
+    .refine((name) => name.trim().length > 0, "must be a non-empty tool name"))
+    .check((ctx) => {
+    const seen = new Set();
+    for (const name of ctx.value) {
+        if (seen.has(name)) {
+            ctx.issues.push({
+                code: "custom",
+                input: ctx.value,
+                message: `contains duplicate tool name "${name}"`,
+            });
+        }
+        seen.add(name);
+    }
+})
+    .optional();
+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(),
+    defaultToolTimeout: z.number().optional(),
+    includeTools: toolNames,
+    excludeTools: toolNames,
+})
+    .check((ctx) => {
+    const { includeTools, excludeTools } = ctx.value;
+    const overlap = (includeTools ?? []).filter((name) => (excludeTools ?? []).includes(name));
+    if (overlap.length > 0) {
+        ctx.issues.push({
+            code: "custom",
+            input: ctx.value,
+            message: "selects tool(s) in both `includeTools` and `excludeTools`: " +
+                `${[...overlap].sort().join(", ")}`,
+        });
+    }
+});
 /**
- * Declare the MCP servers whose tools should be loaded and added to the managed
- * Deep Agent at runtime.
+ * The MCP connector's arguments.
  *
- * Validates the config eagerly so misconfiguration surfaces at module load
- * (build/dev startup) rather than mid-run: at least one server must be
- * declared, and every server must use a remote transport (`"http"` or
- * `"sse"`). Stdio servers and invalid tool selectors are rejected with a clear
- * error.
+ * 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.
  */
-export function defineMcpServers(config) {
-    const provided = config;
-    const servers = provided.mcpServers;
-    if (servers === null ||
-        typeof servers !== "object" ||
-        Array.isArray(servers)) {
-        throw new Error("defineMcpServers(...) requires an `mcpServers` object mapping server " +
-            "names to remote MCP server configs.");
-    }
-    const entries = Object.entries(servers);
-    if (entries.length === 0) {
-        throw new Error("defineMcpServers(...) requires at least one entry in `mcpServers`.");
-    }
-    for (const [name, server] of entries) {
-        validateRemoteServer(name, server);
-    }
-    const definition = { kind: "mcp_servers", ...config };
-    // Brand it as a connector without exposing the symbol as an enumerable field.
-    Object.defineProperty(definition, CONNECTOR_BRAND, {
-        value: true,
-        enumerable: false,
-    });
-    // 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`.
-    Object.defineProperty(definition, "tools", {
-        value: async () => {
-            const { loadManagedMcpTools } = await import("./load.js");
-            return loadManagedMcpTools(definition);
-        },
-        enumerable: false,
-    });
-    return definition;
-}
-/** Allowed remote transports. Stdio is intentionally unsupported in v0. */
-const REMOTE_TRANSPORTS = new Set(["http", "sse"]);
+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(),
+});
 /**
- * Validate a single MCP server config, rejecting stdio servers and anything
- * that is not a remote HTTP/SSE connection with a `url`.
+ * Declare the MCP servers whose tools should be loaded and added to the managed
+ * Deep Agent at runtime.
+ *
+ * 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`.
  */
-function validateRemoteServer(name, server) {
-    if (server === null || typeof server !== "object") {
-        throw new Error(`MCP server "${name}" must be a configuration object.`);
-    }
-    const config = server;
-    // A stdio server is identified by transport or by a `command` field. Reject
-    // it with guidance toward the supported remote transports.
-    if (config.transport === "stdio" || "command" in config) {
-        throw new Error(`MCP server "${name}" 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 transport = config.transport;
-    if (typeof transport !== "string" || !REMOTE_TRANSPORTS.has(transport)) {
-        throw new Error(`MCP server "${name}" must declare a remote transport ` +
-            `("http" or "sse"); got ${JSON.stringify(transport)}.`);
-    }
-    if (typeof config.url !== "string" || config.url.trim().length === 0) {
-        throw new Error(`MCP server "${name}" must declare a non-empty \`url\`.`);
-    }
-    validateToolSelection(name, config);
-}
-function validateToolSelection(name, config) {
-    const includeTools = validateToolNameList(name, "includeTools", config.includeTools);
-    const excludeTools = validateToolNameList(name, "excludeTools", config.excludeTools);
-    if (!includeTools || !excludeTools) {
-        return;
-    }
-    const included = new Set(includeTools);
-    const conflicts = excludeTools.filter((toolName) => included.has(toolName));
-    if (conflicts.length > 0) {
-        throw new Error(`MCP server "${name}" selects tool(s) in both \`includeTools\` and ` +
-            `\`excludeTools\`: ${conflicts.sort().join(", ")}.`);
-    }
-}
-function validateToolNameList(serverName, field, value) {
-    if (value === undefined) {
-        return undefined;
-    }
-    if (!Array.isArray(value)) {
-        throw new Error(`MCP server "${serverName}" \`${field}\` must be an array of strings.`);
-    }
-    const seen = new Set();
-    for (const [index, item] of value.entries()) {
-        if (typeof item !== "string" || item.trim().length === 0) {
-            throw new Error(`MCP server "${serverName}" \`${field}\` entry ${index} must be a non-empty string.`);
-        }
-        if (seen.has(item)) {
-            throw new Error(`MCP server "${serverName}" \`${field}\` contains duplicate tool name "${item}".`);
-        }
-        seen.add(item);
-    }
-    return value;
-}
+export const mcpConnector = defineExtension("connector", {
+    kind: "mcp_servers",
+    label: "connectors.mcp",
+    args: mcpServersConfig,
+    async tools(_ctx, self) {
+        const { loadManagedMcpTools } = await import("./load.js");
+        return loadManagedMcpTools(self);
+    },
+});
 //# sourceMappingURL=index.js.map