managed-deepagents 0.6.2-dev.5 → 0.6.2-dev.51

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":""}

package/dist/connectors/tool-selection.d.ts

@@ -2,7 +2,7 @@
  * Tool-name selection, shared by the connectors that load their tools from a
  * remote MCP server.
  *
- * `connectors.mcp` selects by raw tool name across arbitrary servers. A name in
+ * `defineMCP` selects by raw tool name across arbitrary servers. A name in
  * `includeTools`/`excludeTools` that no loaded tool answers to is an error
  * naming what *was* available, so a typo fails the deployment instead of
  * silently dropping a tool the agent was meant to have.
@@ -20,27 +20,18 @@ export interface ToolSelection<TTool extends string = string> {
     /** Tool names to hide. Applied after {@link ToolSelection.includeTools}. */
     excludeTools?: TTool[];
 }
-/**
- * Shared authoring options for connectors that load remote tools.
- */
-export interface ToolSelectionConnectorConfig<TTool extends string = string> extends ToolSelection<TTool> {
-    /** Timeout for each tool call (milliseconds on the TypeScript runtime). */
-    defaultToolTimeout?: number;
-}
 /** Tool names: non-empty, no duplicates within one list. */
-export declare const toolSelectionConnectorFields: {
-    includeTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    excludeTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    defaultToolTimeout: z.ZodOptional<z.ZodNumber>;
-};
-/** Shared include/exclude overlap check for connector arg schemas. */
-export declare function checkToolSelectionOverlap(ctx: {
+export declare const optionalToolNameListSchema: z.ZodOptional<z.ZodArray<z.ZodString>>;
+export declare function appendToolSelectionOverlapIssue(ctx: {
+    value: unknown;
     issues: {
-        push(issue: unknown): void;
+        push: (issue: {
+            code: "custom";
+            input: unknown;
+            message: string;
+        }) => void;
     };
-    value: unknown;
-}, value: ToolSelection): void;
-export declare function toolSelectionConnectorSchema<TArgs, TInput>(extra?: z.ZodRawShape): z.ZodType<TArgs, TInput>;
+}): void;
 /** Read the name a selection matches a loaded tool by. */
 export type ToolNameReader = (tool: unknown) => string | undefined;
 /** Read a loaded tool's own `name`. The default for connectors that don't rename. */

package/dist/connectors/tool-selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-selection.d.ts","sourceRoot":"","sources":["../../src/connectors/tool-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IAC1D,6DAA6D;IAC7D,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC;IACvB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B,CAC3C,KAAK,SAAS,MAAM,GAAG,MAAM,CAC7B,SAAQ,aAAa,CAAC,KAAK,CAAC;IAC5B,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAOD,4DAA4D;AAC5D,eAAO,MAAM,4BAA4B;IACvC,YAAY;IAgBZ,YAAY;IAgBZ,kBAAkB;CAInB,CAAC;AAEF,sEAAsE;AACtE,wBAAgB,yBAAyB,CACvC,GAAG,EAAE;IAAE,MAAM,EAAE;QAAE,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,EAC/D,KAAK,EAAE,aAAa,GACnB,IAAI,CAgBN;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,EACxD,KAAK,GAAE,CAAC,CAAC,WAAgB,GACxB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAO1B;AAED,0DAA0D;AAC1D,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;AAEnE,qFAAqF;AACrF,eAAO,MAAM,QAAQ,EAAE,cAGtB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,QAAQ,GAAE,cAAyB,GAClC,OAAO,EAAE,CAwBX"}
+{"version":3,"file":"tool-selection.d.ts","sourceRoot":"","sources":["../../src/connectors/tool-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IAC1D,6DAA6D;IAC7D,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC;IACvB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC;CACxB;AAED,4DAA4D;AAC5D,eAAO,MAAM,0BAA0B,wCAsB1B,CAAC;AAmBd,wBAAgB,+BAA+B,CAAC,GAAG,EAAE;IACnD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,KAAK,EAAE;YAAE,IAAI,EAAE,QAAQ,CAAC;YAAC,KAAK,EAAE,OAAO,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;KAC5E,CAAC;CACH,GAAG,IAAI,CAWP;AAED,0DAA0D;AAC1D,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;AAEnE,qFAAqF;AACrF,eAAO,MAAM,QAAQ,EAAE,cAGtB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,QAAQ,GAAE,cAAyB,GAClC,OAAO,EAAE,CAwBX"}

package/dist/connectors/tool-selection.js

@@ -2,79 +2,53 @@
  * Tool-name selection, shared by the connectors that load their tools from a
  * remote MCP server.
  *
- * `connectors.mcp` selects by raw tool name across arbitrary servers. A name in
+ * `defineMCP` selects by raw tool name across arbitrary servers. A name in
  * `includeTools`/`excludeTools` that no loaded tool answers to is an error
  * naming what *was* available, so a typo fails the deployment instead of
  * silently dropping a tool the agent was meant to have.
  */
 import { z } from "zod";
-function nonEmpty(field) {
-    const message = `${field} must be a non-empty string`;
-    return z.string(message).refine((value) => value.trim().length > 0, message);
-}
 /** Tool names: non-empty, no duplicates within one list. */
-export const toolSelectionConnectorFields = {
-    includeTools: z
-        .array(nonEmpty("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(),
-    excludeTools: z
-        .array(nonEmpty("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);
+export const optionalToolNameListSchema = z
+    .array(z
+    .string("tool name must be a non-empty string")
+    .refine((name) => name.trim().length > 0, "tool name must be a non-empty string"))
+    .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}"`,
+            });
         }
-    })
-        .optional(),
-    defaultToolTimeout: z
-        .number("defaultToolTimeout must be a positive number")
-        .positive("defaultToolTimeout must be a positive number")
-        .optional(),
-};
-/** Shared include/exclude overlap check for connector arg schemas. */
-export function checkToolSelectionOverlap(ctx, value) {
-    const { includeTools, excludeTools } = value;
+        seen.add(name);
+    }
+})
+    .optional();
+function toolSelectionOverlapMessage(selection) {
+    const { includeTools, excludeTools } = selection;
     const overlap = (includeTools ?? []).filter((name) => (excludeTools ?? []).includes(name));
-    if (overlap.length > 0) {
+    if (overlap.length === 0) {
+        return undefined;
+    }
+    return `selects tool(s) in both \`includeTools\` and \`excludeTools\`: ${[
+        ...new Set(overlap),
+    ]
+        .sort()
+        .join(", ")}`;
+}
+export function appendToolSelectionOverlapIssue(ctx) {
+    const message = toolSelectionOverlapMessage(ctx.value);
+    if (message) {
         ctx.issues.push({
             code: "custom",
             input: ctx.value,
-            message: `selects tool(s) in both \`includeTools\` and \`excludeTools\`: ${[
-                ...new Set(overlap),
-            ]
-                .sort()
-                .join(", ")}`,
+            message,
         });
     }
 }
-export function toolSelectionConnectorSchema(extra = {}) {
-    return z
-        .strictObject({ ...toolSelectionConnectorFields, ...extra })
-        .check((ctx) => {
-        checkToolSelectionOverlap(ctx, ctx.value);
-    })
-        .prefault({});
-}
 /** Read a loaded tool's own `name`. The default for connectors that don't rename. */
 export const toolName = (tool) => {
     const name = tool.name;

package/dist/connectors/tool-selection.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-selection.js","sourceRoot":"","sources":["../../src/connectors/tool-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,SAAS,QAAQ,CAAC,KAAa;IAC7B,MAAM,OAAO,GAAG,GAAG,KAAK,6BAA6B,CAAC;IACtD,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;AAC/E,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,YAAY,EAAE,CAAC;SACZ,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;SAC5B,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,OAAO,EAAE,iCAAiC,IAAI,GAAG;iBAClD,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC;SACD,QAAQ,EAAE;IACb,YAAY,EAAE,CAAC;SACZ,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;SAC5B,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,OAAO,EAAE,iCAAiC,IAAI,GAAG;iBAClD,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC;SACD,QAAQ,EAAE;IACb,kBAAkB,EAAE,CAAC;SAClB,MAAM,CAAC,8CAA8C,CAAC;SACtD,QAAQ,CAAC,8CAA8C,CAAC;SACxD,QAAQ,EAAE;CACd,CAAC;AAEF,sEAAsE;AACtE,MAAM,UAAU,yBAAyB,CACvC,GAA+D,EAC/D,KAAoB;IAEpB,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IAC7C,MAAM,OAAO,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACnD,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CACpC,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,OAAO,EAAE,kEAAkE;gBACzE,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC;aACpB;iBACE,IAAI,EAAE;iBACN,IAAI,CAAC,IAAI,CAAC,EAAE;SAChB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,KAAK,GAAkB,EAAE;IAEzB,OAAO,CAAC;SACL,YAAY,CAAC,EAAE,GAAG,4BAA4B,EAAE,GAAG,KAAK,EAAE,CAAC;SAC3D,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACb,yBAAyB,CAAC,GAAG,EAAE,GAAG,CAAC,KAAsB,CAAC,CAAC;IAC7D,CAAC,CAAC;SACD,QAAQ,CAAC,EAAE,CAAU,CAAC;AAC3B,CAAC;AAKD,qFAAqF;AACrF,MAAM,CAAC,MAAM,QAAQ,GAAmB,CAAC,IAAI,EAAE,EAAE;IAC/C,MAAM,IAAI,GAAI,IAA2B,CAAC,IAAI,CAAC;IAC/C,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,SAAwB,EACxB,KAAyB,EACzB,QAAQ,GAAmB,QAAQ;IAEnC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC;IACjD,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,KAAK;SACF,GAAG,CAAC,QAAQ,CAAC;SACb,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAC9D,CAAC;IACF,wBAAwB,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IAEzE,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,QAAQ,KAAK,SAAS,CAAC;QAChC,CAAC;QACD,OAAO,CACL,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CACvE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,wBAAwB,CAC/B,OAAe,EACf,SAAsB,EACtB,YAAuB,EACvB,YAAuB;IAEvB,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,cAAc,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;IACpE,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,8BAA8B,KAAK,IAAI;QAC/C,oBAAoB,cAAc,GAAG,CACxC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"tool-selection.js","sourceRoot":"","sources":["../../src/connectors/tool-selection.ts"],"names":[],"mappings":"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"}

package/dist/credential-gate.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Pre-run gate for declarations that need a user-owned connection.
+ *
+ * Before the first model turn the gate reads the caller's OAuth grants and
+ * opaque secrets from Agent Auth. Missing grants raise one LangGraph interrupt;
+ * OAuth slugs include connect URLs, opaque slugs request password-style input.
+ * The tools a grant unlocks are loaded on first use and cached per caller.
+ */
+import { createMiddleware } from "langchain";
+import { type ConnectionReference } from "./connections.js";
+export declare const CREDENTIAL_GATE_MIDDLEWARE_NAME = "mda-credential-gate";
+export interface PendingCredential {
+    slug: string;
+    kind: "oauth2" | "secret";
+    connect_url?: string;
+    auth_id?: string;
+}
+/** Interrupt payload when the caller has not granted one or more connections. */
+export interface CredentialAuthorizationRequiredInterrupt {
+    type: "credential_authorization_required";
+    message: string;
+    credentials: PendingCredential[];
+}
+/** Tools a declaration contributes for one caller, plus their transport. */
+export interface LoadedCredentialTools {
+    tools: unknown[];
+    close: () => Promise<void>;
+}
+/** A declaration whose tools are unlocked by user-owned connections. */
+export interface CredentialConsumer {
+    /** The declaration itself, used to key the per-caller tool cache. */
+    declaration: object;
+    /** User-owned connection references the declaration needs. */
+    credentials: readonly ConnectionReference[];
+    load: (accessTokens: ReadonlyMap<string, string>) => Promise<LoadedCredentialTools>;
+}
+export declare function createCredentialGateMiddleware(consumers: readonly CredentialConsumer[]): ReturnType<typeof createMiddleware> | undefined;
+/** Drop every cached caller entry and close its transports. Test-only. */
+export declare function clearCredentialToolCacheForTests(): Promise<void>;
+//# sourceMappingURL=credential-gate.d.ts.map

package/dist/credential-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-gate.d.ts","sourceRoot":"","sources":["../src/credential-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAS7C,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAY1B,eAAO,MAAM,+BAA+B,wBAAwB,CAAC;AAUrE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,iFAAiF;AACjF,MAAM,WAAW,wCAAwC;IACvD,IAAI,EAAE,mCAAmC,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAED,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC5C,IAAI,EAAE,CACJ,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KACtC,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACrC;AA6CD,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,SAAS,kBAAkB,EAAE,GACvC,UAAU,CAAC,OAAO,gBAAgB,CAAC,GAAG,SAAS,CAuCjD;AAgND,0EAA0E;AAC1E,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,IAAI,CAAC,CAStE"}