managed-deepagents 0.6.2-dev.4 → 0.6.2-dev.41
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -3
- package/dist/agent-auth.d.ts +141 -0
- package/dist/agent-auth.d.ts.map +1 -0
- package/dist/agent-auth.js +426 -0
- package/dist/agent-auth.js.map +1 -0
- package/dist/channels/manifest.d.ts +4 -0
- package/dist/channels/manifest.d.ts.map +1 -1
- package/dist/channels/schedule-delivery.d.ts +2 -0
- package/dist/channels/schedule-delivery.d.ts.map +1 -1
- package/dist/channels/schedule-delivery.js +40 -4
- package/dist/channels/schedule-delivery.js.map +1 -1
- package/dist/channels/trigger/client.d.ts +1 -0
- package/dist/channels/trigger/client.d.ts.map +1 -1
- package/dist/channels/trigger/client.js +19 -8
- package/dist/channels/trigger/client.js.map +1 -1
- package/dist/channels/trigger/http.d.ts +8 -0
- package/dist/channels/trigger/http.d.ts.map +1 -1
- package/dist/channels/trigger/http.js +42 -1
- package/dist/channels/trigger/http.js.map +1 -1
- package/dist/channels/trigger/identity-context.d.ts +47 -0
- package/dist/channels/trigger/identity-context.d.ts.map +1 -0
- package/dist/channels/trigger/identity-context.js +171 -0
- package/dist/channels/trigger/identity-context.js.map +1 -0
- package/dist/channels/trigger/types.d.ts +5 -1
- package/dist/channels/trigger/types.d.ts.map +1 -1
- package/dist/channels/trigger/types.js +5 -0
- package/dist/channels/trigger/types.js.map +1 -1
- package/dist/connections.d.ts +74 -0
- package/dist/connections.d.ts.map +1 -0
- package/dist/connections.js +277 -0
- package/dist/connections.js.map +1 -0
- package/dist/connectors/mcp/index.d.ts +29 -89
- package/dist/connectors/mcp/index.d.ts.map +1 -1
- package/dist/connectors/mcp/index.js +258 -50
- package/dist/connectors/mcp/index.js.map +1 -1
- package/dist/connectors/mcp/schema.d.ts +12 -0
- package/dist/connectors/mcp/schema.d.ts.map +1 -0
- package/dist/connectors/mcp/schema.js +57 -0
- package/dist/connectors/mcp/schema.js.map +1 -0
- package/dist/connectors/mcp/types.d.ts +62 -0
- package/dist/connectors/mcp/types.d.ts.map +1 -0
- package/dist/connectors/mcp/types.js +2 -0
- package/dist/connectors/mcp/types.js.map +1 -0
- package/dist/connectors/tool-selection.d.ts +9 -18
- package/dist/connectors/tool-selection.d.ts.map +1 -1
- package/dist/connectors/tool-selection.js +32 -58
- package/dist/connectors/tool-selection.js.map +1 -1
- package/dist/credential-gate.d.ts +40 -0
- package/dist/credential-gate.d.ts.map +1 -0
- package/dist/credential-gate.js +227 -0
- package/dist/credential-gate.js.map +1 -0
- package/dist/identity/index.d.ts +1 -1
- package/dist/identity/index.d.ts.map +1 -1
- package/dist/identity/index.js.map +1 -1
- package/dist/identity/types.d.ts +79 -5
- package/dist/identity/types.d.ts.map +1 -1
- package/dist/index.d.ts +11 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/ingress/index.d.ts +10 -2
- package/dist/ingress/index.d.ts.map +1 -1
- package/dist/ingress/index.js +17 -9
- package/dist/ingress/index.js.map +1 -1
- package/dist/runtime/auth.d.ts +49 -5
- package/dist/runtime/auth.d.ts.map +1 -1
- package/dist/runtime/auth.js +100 -5
- package/dist/runtime/auth.js.map +1 -1
- package/dist/runtime/http.d.ts +1 -1
- package/dist/runtime/http.d.ts.map +1 -1
- package/dist/runtime/http.js.map +1 -1
- package/dist/runtime/identity-runtime.d.ts +65 -5
- package/dist/runtime/identity-runtime.d.ts.map +1 -1
- package/dist/runtime/identity-runtime.js +148 -0
- package/dist/runtime/identity-runtime.js.map +1 -1
- package/dist/runtime/index.d.ts.map +1 -1
- package/dist/runtime/index.js +12 -7
- package/dist/runtime/index.js.map +1 -1
- package/dist/runtime/managed-middleware.d.ts +2 -2
- package/dist/runtime/managed-middleware.js +6 -6
- package/dist/runtime/managed-tools.d.ts +19 -15
- package/dist/runtime/managed-tools.d.ts.map +1 -1
- package/dist/runtime/managed-tools.js +14 -13
- package/dist/runtime/managed-tools.js.map +1 -1
- package/dist/runtime/types.d.ts +2 -2
- package/package.json +8 -8
- package/dist/connectors/mcp/load.d.ts +0 -12
- package/dist/connectors/mcp/load.d.ts.map +0 -1
- package/dist/connectors/mcp/load.js +0 -122
- package/dist/connectors/mcp/load.js.map +0 -1
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
* @example
|
|
19
19
|
* ```ts
|
|
20
20
|
* // connectors/mcp.ts
|
|
21
|
-
* import { connectors } from "managed-deepagents";
|
|
21
|
+
* import { connectors, connections } from "managed-deepagents";
|
|
22
22
|
*
|
|
23
23
|
* export const connector = connectors.mcp({
|
|
24
24
|
* mcpServers: {
|
|
@@ -26,69 +26,277 @@
|
|
|
26
26
|
* transport: "http",
|
|
27
27
|
* url: "https://docs.example.com/mcp",
|
|
28
28
|
* },
|
|
29
|
+
* notion: {
|
|
30
|
+
* transport: "http",
|
|
31
|
+
* url: "https://mcp.notion.com/mcp",
|
|
32
|
+
* connection: connections.get("notion", { type: "user" }),
|
|
33
|
+
* },
|
|
29
34
|
* },
|
|
30
35
|
* });
|
|
31
36
|
* ```
|
|
32
37
|
*/
|
|
33
|
-
import {
|
|
34
|
-
import { checkToolSelectionOverlap, toolSelectionConnectorFields, } from "../tool-selection.js";
|
|
38
|
+
import { MultiServerMCPClient } from "@langchain/mcp-adapters";
|
|
35
39
|
import { defineExtension } from "../../extension.js";
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
"or write a normal authored tool instead.";
|
|
40
|
-
const remoteMcpServer = z
|
|
41
|
-
.looseObject({
|
|
42
|
-
// Present only to reject it: a `command` is how a stdio server is spelled.
|
|
43
|
-
command: z.never({ error: STDIO_REJECTION }).optional(),
|
|
44
|
-
transport: z.enum(["http", "sse"], {
|
|
45
|
-
error: (issue) => issue.input === "stdio"
|
|
46
|
-
? STDIO_REJECTION
|
|
47
|
-
: 'must declare a remote transport ("http" or "sse")',
|
|
48
|
-
}),
|
|
49
|
-
url: z
|
|
50
|
-
.string("must be a non-empty URL")
|
|
51
|
-
.refine((url) => url.trim().length > 0, "must be a non-empty URL"),
|
|
52
|
-
headers: z.record(z.string(), z.string()).optional(),
|
|
53
|
-
...toolSelectionConnectorFields,
|
|
54
|
-
})
|
|
55
|
-
.check((ctx) => {
|
|
56
|
-
checkToolSelectionOverlap(ctx, ctx.value);
|
|
57
|
-
});
|
|
40
|
+
import { connections, isConnectionReference, } from "../../connections.js";
|
|
41
|
+
import { mcpServersConfig } from "./schema.js";
|
|
42
|
+
import { selectTools } from "../tool-selection.js";
|
|
58
43
|
/**
|
|
59
|
-
*
|
|
44
|
+
* MCP tools loaded per declared connector, cached for the process lifetime.
|
|
60
45
|
*
|
|
61
|
-
*
|
|
62
|
-
*
|
|
63
|
-
*
|
|
64
|
-
*
|
|
46
|
+
* The compiled entry's graph factory runs `compileManagedAgent` on every
|
|
47
|
+
* invocation, but each connector's MCP connection and tool surface are stable
|
|
48
|
+
* for the life of the deployment — so the client is created and its tools
|
|
49
|
+
* loaded once per declaration, and every subsequent run reuses them. Storing
|
|
50
|
+
* the in-flight promise also dedupes concurrent first runs for the same
|
|
51
|
+
* connector. Multiple `connectors.mcp(...)` modules each get their own entry.
|
|
52
|
+
*
|
|
53
|
+
* An agent-owned connection is read into this cache once, so rotating that
|
|
54
|
+
* secret takes a redeploy. Servers with a user-owned connection are omitted
|
|
55
|
+
* entirely; the credential gate loads those per caller.
|
|
65
56
|
*/
|
|
66
|
-
const
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
57
|
+
const cachedTools = new Map();
|
|
58
|
+
/**
|
|
59
|
+
* Load (and cache) the MCP tools for one connector declaration.
|
|
60
|
+
*
|
|
61
|
+
* A failed load is never cached, so a transient connection error on the first
|
|
62
|
+
* run can be retried on the next, but a misconfigured deployment surfaces the
|
|
63
|
+
* error rather than silently starting with no tools.
|
|
64
|
+
*/
|
|
65
|
+
export function loadManagedMcpTools(connectors) {
|
|
66
|
+
const cached = cachedTools.get(connectors);
|
|
67
|
+
if (cached) {
|
|
68
|
+
return cached;
|
|
69
|
+
}
|
|
70
|
+
const loading = createClientAndLoadTools(connectors).catch((error) => {
|
|
71
|
+
cachedTools.delete(connectors);
|
|
72
|
+
throw error;
|
|
73
|
+
});
|
|
74
|
+
cachedTools.set(connectors, loading);
|
|
75
|
+
return loading;
|
|
76
|
+
}
|
|
77
|
+
/** Clear the process-level MCP tool cache. Test-only. */
|
|
78
|
+
export function clearManagedMcpToolsCacheForTests(connectors) {
|
|
79
|
+
if (connectors) {
|
|
80
|
+
cachedTools.delete(connectors);
|
|
81
|
+
return;
|
|
82
|
+
}
|
|
83
|
+
cachedTools.clear();
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* The credential gate's view of the declared MCP connectors.
|
|
87
|
+
*
|
|
88
|
+
* One consumer per declaration that names a user-owned connection; a
|
|
89
|
+
* declaration that needs no grant never reaches the gate.
|
|
90
|
+
*/
|
|
91
|
+
export function mcpCredentialConsumers(connectors) {
|
|
92
|
+
const out = [];
|
|
93
|
+
for (const connector of connectors ?? []) {
|
|
94
|
+
if (!connector ||
|
|
95
|
+
typeof connector !== "object" ||
|
|
96
|
+
connector.kind !== "mcp_servers") {
|
|
97
|
+
continue;
|
|
98
|
+
}
|
|
99
|
+
const definition = connector;
|
|
100
|
+
const userConnections = userConnectionReferences(definition);
|
|
101
|
+
if (userConnections.length === 0) {
|
|
102
|
+
continue;
|
|
103
|
+
}
|
|
104
|
+
out.push({
|
|
105
|
+
declaration: definition,
|
|
106
|
+
credentials: userConnections,
|
|
107
|
+
load: (accessTokens) => loadUserConnectionMcpTools(definition, accessTokens),
|
|
108
|
+
});
|
|
109
|
+
}
|
|
110
|
+
return out;
|
|
111
|
+
}
|
|
112
|
+
/** The declared references themselves: the gate checks their owner. */
|
|
113
|
+
function userConnectionReferences(connectors) {
|
|
114
|
+
const bySlug = new Map();
|
|
115
|
+
for (const server of Object.values(connectors.mcpServers)) {
|
|
116
|
+
if (usesUserConnection(server)) {
|
|
117
|
+
const connection = server.connection;
|
|
118
|
+
bySlug.set(connection.slug, connection);
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
return [...bySlug.values()];
|
|
122
|
+
}
|
|
123
|
+
function agentConnectionReferences(connectors) {
|
|
124
|
+
const bySlug = new Map();
|
|
125
|
+
for (const server of Object.values(connectors.mcpServers)) {
|
|
126
|
+
const connection = server.connection;
|
|
127
|
+
if (isConnectionReference(connection) &&
|
|
128
|
+
connection.owner.type === "agent") {
|
|
129
|
+
bySlug.set(connection.slug, connection);
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
return [...bySlug.values()];
|
|
133
|
+
}
|
|
134
|
+
function mcpRequirements(name, connectors) {
|
|
135
|
+
const userSlugs = userConnectionReferences(connectors)
|
|
136
|
+
.map((connection) => connection.slug)
|
|
137
|
+
.sort();
|
|
138
|
+
const agentSlugs = agentConnectionReferences(connectors)
|
|
139
|
+
.map((connection) => connection.slug)
|
|
140
|
+
.sort();
|
|
141
|
+
return {
|
|
142
|
+
name,
|
|
143
|
+
provider: "mcp",
|
|
144
|
+
autoReply: false,
|
|
145
|
+
requiredPermissions: [],
|
|
146
|
+
requiredEnv: [],
|
|
147
|
+
userConnections: userSlugs,
|
|
148
|
+
agentConnections: agentSlugs,
|
|
149
|
+
providerConfig: {},
|
|
150
|
+
};
|
|
151
|
+
}
|
|
152
|
+
async function createClientAndLoadTools(connectors) {
|
|
153
|
+
const { eager, userConnection } = partitionMcpServers(connectors.mcpServers);
|
|
154
|
+
if (userConnection.length > 0) {
|
|
155
|
+
warnDeferredUserConnectionServers(userConnection);
|
|
156
|
+
}
|
|
157
|
+
if (Object.keys(eager).length === 0) {
|
|
158
|
+
return [];
|
|
159
|
+
}
|
|
160
|
+
const { tools } = await loadToolsFromServers(connectors, await withAgentConnections(eager));
|
|
161
|
+
return tools;
|
|
162
|
+
}
|
|
77
163
|
/**
|
|
78
|
-
*
|
|
79
|
-
*
|
|
164
|
+
* Load tools for user-connection servers, once the gate has confirmed the
|
|
165
|
+
* caller's grants.
|
|
80
166
|
*
|
|
81
|
-
*
|
|
82
|
-
*
|
|
83
|
-
* installs never pull in `@langchain/mcp-adapters`.
|
|
167
|
+
* Not process-cached here: the Authorization header is per caller, so the gate
|
|
168
|
+
* owns both the cache and closing the returned transport.
|
|
84
169
|
*/
|
|
170
|
+
export async function loadUserConnectionMcpTools(connectors, accessTokens) {
|
|
171
|
+
const { userConnection } = partitionMcpServers(connectors.mcpServers);
|
|
172
|
+
const connectable = {};
|
|
173
|
+
for (const name of userConnection) {
|
|
174
|
+
const server = connectors.mcpServers[name];
|
|
175
|
+
const connection = server?.connection;
|
|
176
|
+
if (!server || !isConnectionReference(connection)) {
|
|
177
|
+
continue;
|
|
178
|
+
}
|
|
179
|
+
const accessToken = accessTokens.get(connection.slug);
|
|
180
|
+
if (!accessToken) {
|
|
181
|
+
throw new Error(`MCP user connection "${connection.slug}" has no access token`);
|
|
182
|
+
}
|
|
183
|
+
connectable[name] = withBearer(server, accessToken);
|
|
184
|
+
}
|
|
185
|
+
if (Object.keys(connectable).length === 0) {
|
|
186
|
+
return { tools: [], close: async () => { } };
|
|
187
|
+
}
|
|
188
|
+
const { tools, client } = await loadToolsFromServers(connectors, connectable);
|
|
189
|
+
return { tools, close: () => client.close() };
|
|
190
|
+
}
|
|
191
|
+
/** Resolve each agent-owned connection into a static bearer header. */
|
|
192
|
+
async function withAgentConnections(servers) {
|
|
193
|
+
const out = {};
|
|
194
|
+
for (const [name, server] of Object.entries(servers)) {
|
|
195
|
+
const connection = server.connection;
|
|
196
|
+
out[name] = isConnectionReference(connection)
|
|
197
|
+
? withBearer(server, await connections.resolveDeploymentSecret(connection.slug))
|
|
198
|
+
: server;
|
|
199
|
+
}
|
|
200
|
+
return out;
|
|
201
|
+
}
|
|
202
|
+
function withBearer(server, token) {
|
|
203
|
+
const headers = Object.fromEntries(Object.entries(server.headers ?? {}).filter(([name]) => name.toLowerCase() !== "authorization"));
|
|
204
|
+
return {
|
|
205
|
+
...server,
|
|
206
|
+
headers: { ...headers, Authorization: `Bearer ${token}` },
|
|
207
|
+
};
|
|
208
|
+
}
|
|
209
|
+
function usesUserConnection(server) {
|
|
210
|
+
return (isConnectionReference(server.connection) &&
|
|
211
|
+
server.connection.owner.type === "user");
|
|
212
|
+
}
|
|
213
|
+
function partitionMcpServers(servers) {
|
|
214
|
+
const eager = {};
|
|
215
|
+
const userConnection = [];
|
|
216
|
+
for (const [name, server] of Object.entries(servers)) {
|
|
217
|
+
if (usesUserConnection(server)) {
|
|
218
|
+
userConnection.push(name);
|
|
219
|
+
}
|
|
220
|
+
else {
|
|
221
|
+
eager[name] = server;
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
return { eager, userConnection };
|
|
225
|
+
}
|
|
226
|
+
function warnDeferredUserConnectionServers(serverNames) {
|
|
227
|
+
console.warn(`[managed-deepagents] MCP server(s) ${serverNames.join(", ")} declare ` +
|
|
228
|
+
`a user connection; tools load after the pre-run credential gate ` +
|
|
229
|
+
`confirms grants for the caller.`);
|
|
230
|
+
}
|
|
231
|
+
function stripManagedToolSelection(servers) {
|
|
232
|
+
return Object.fromEntries(Object.entries(servers).map(([name, server]) => {
|
|
233
|
+
const { includeTools: _includeTools, excludeTools: _excludeTools, connection: _connection, ...clientConfig } = server;
|
|
234
|
+
return [name, clientConfig];
|
|
235
|
+
}));
|
|
236
|
+
}
|
|
237
|
+
async function loadToolsFromServers(connectors, connectable) {
|
|
238
|
+
const prefixToolNameWithServerName = connectors.prefixToolNameWithServerName ?? true;
|
|
239
|
+
const client = new MultiServerMCPClient({
|
|
240
|
+
mcpServers: stripManagedToolSelection(connectable),
|
|
241
|
+
prefixToolNameWithServerName,
|
|
242
|
+
throwOnLoadError: connectors.throwOnLoadError ?? true,
|
|
243
|
+
useStandardContentBlocks: connectors.useStandardContentBlocks ?? true,
|
|
244
|
+
onConnectionError: connectors.onConnectionError ?? "throw",
|
|
245
|
+
});
|
|
246
|
+
try {
|
|
247
|
+
const tools = await loadToolsByServer(client, connectable, prefixToolNameWithServerName);
|
|
248
|
+
if (!prefixToolNameWithServerName) {
|
|
249
|
+
assertNoToolNameCollisions(tools);
|
|
250
|
+
}
|
|
251
|
+
return { tools, client };
|
|
252
|
+
}
|
|
253
|
+
catch (error) {
|
|
254
|
+
await client.close().catch(() => undefined);
|
|
255
|
+
throw error;
|
|
256
|
+
}
|
|
257
|
+
}
|
|
258
|
+
async function loadToolsByServer(client, servers, prefixToolNameWithServerName) {
|
|
259
|
+
const tools = [];
|
|
260
|
+
for (const [serverName, server] of Object.entries(servers)) {
|
|
261
|
+
const serverTools = await client.getTools(serverName);
|
|
262
|
+
tools.push(...filterToolsForServer(serverName, server, serverTools, prefixToolNameWithServerName));
|
|
263
|
+
}
|
|
264
|
+
return tools;
|
|
265
|
+
}
|
|
266
|
+
function filterToolsForServer(serverName, selection, tools, prefixToolNameWithServerName) {
|
|
267
|
+
return selectTools(`MCP server "${serverName}"`, selection, tools, (tool) => {
|
|
268
|
+
const name = tool.name;
|
|
269
|
+
if (typeof name !== "string") {
|
|
270
|
+
return undefined;
|
|
271
|
+
}
|
|
272
|
+
const prefix = `${serverName}__`;
|
|
273
|
+
return prefixToolNameWithServerName && name.startsWith(prefix)
|
|
274
|
+
? name.slice(prefix.length)
|
|
275
|
+
: name;
|
|
276
|
+
});
|
|
277
|
+
}
|
|
278
|
+
function assertNoToolNameCollisions(tools) {
|
|
279
|
+
const seen = new Set();
|
|
280
|
+
const collisions = new Set();
|
|
281
|
+
for (const tool of tools) {
|
|
282
|
+
const name = tool.name;
|
|
283
|
+
if (typeof name !== "string")
|
|
284
|
+
continue;
|
|
285
|
+
if (seen.has(name))
|
|
286
|
+
collisions.add(name);
|
|
287
|
+
seen.add(name);
|
|
288
|
+
}
|
|
289
|
+
if (collisions.size > 0) {
|
|
290
|
+
throw new Error(`MCP tool name collision: ${[...collisions].sort().join(", ")}. ` +
|
|
291
|
+
"Set `prefixToolNameWithServerName: true` (the default) so each tool is " +
|
|
292
|
+
"namespaced by its server, or rename the conflicting tools.");
|
|
293
|
+
}
|
|
294
|
+
}
|
|
85
295
|
export const mcpConnector = defineExtension("connector", {
|
|
86
296
|
kind: "mcp_servers",
|
|
87
297
|
label: "connectors.mcp",
|
|
88
298
|
args: mcpServersConfig,
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
return loadManagedMcpTools(self);
|
|
92
|
-
},
|
|
299
|
+
tools: (_ctx, self) => loadManagedMcpTools(self),
|
|
300
|
+
requirements: (name, self) => mcpRequirements(name, self),
|
|
93
301
|
});
|
|
94
302
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/connectors/mcp/index.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/connectors/mcp/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { McpServersConfig } from "./types.js";
|
|
3
|
+
/**
|
|
4
|
+
* The MCP connector's arguments.
|
|
5
|
+
*
|
|
6
|
+
* Shape, types, and tool-name lists are the schema's job; the rules that need
|
|
7
|
+
* more than one field — a stdio server, a tool selected and deselected at once
|
|
8
|
+
* — are checks with hand-written messages. Server configs stay loose because
|
|
9
|
+
* `@langchain/mcp-adapters` accepts more per-transport options than MDA models.
|
|
10
|
+
*/
|
|
11
|
+
export declare const mcpServersConfig: z.ZodType<McpServersConfig, McpServersConfig>;
|
|
12
|
+
//# sourceMappingURL=schema.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiDnD;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,gBAAgB,CAevE,CAAC"}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { appendToolSelectionOverlapIssue, optionalToolNameListSchema, } from "../tool-selection.js";
|
|
3
|
+
import { isConnectionReference, } from "../../connections.js";
|
|
4
|
+
/** Stdio servers are out of scope; the message points at the alternatives. */
|
|
5
|
+
const STDIO_REJECTION = "uses a stdio transport, which is not supported. Managed Deep Agents " +
|
|
6
|
+
"support remote MCP servers over HTTP/SSE only; expose the server over HTTP " +
|
|
7
|
+
"or write a normal authored tool instead.";
|
|
8
|
+
const CREDENTIAL_FIELD_REJECTION = 'the "credential" field was removed; use connection: connections.get(slug, owner) instead';
|
|
9
|
+
/** Raw MCP tool names, before the managed `{server}__` prefix is applied. */
|
|
10
|
+
const remoteMcpServer = z
|
|
11
|
+
.looseObject({
|
|
12
|
+
/**
|
|
13
|
+
* Present only to reject it: a `command` is how a stdio server is defined,
|
|
14
|
+
* which we don't support.
|
|
15
|
+
*/
|
|
16
|
+
command: z.never({ error: STDIO_REJECTION }).optional(),
|
|
17
|
+
transport: z.enum(["http", "sse"], {
|
|
18
|
+
error: (issue) => issue.input === "stdio"
|
|
19
|
+
? STDIO_REJECTION
|
|
20
|
+
: 'must declare a remote transport ("http" or "sse")',
|
|
21
|
+
}),
|
|
22
|
+
url: z
|
|
23
|
+
.string("must be a non-empty URL")
|
|
24
|
+
.refine((url) => url.trim().length > 0, "must be a non-empty URL"),
|
|
25
|
+
headers: z.record(z.string(), z.string()).optional(),
|
|
26
|
+
defaultToolTimeout: z
|
|
27
|
+
.number("defaultToolTimeout must be a positive number")
|
|
28
|
+
.positive("defaultToolTimeout must be a positive number")
|
|
29
|
+
.optional(),
|
|
30
|
+
includeTools: optionalToolNameListSchema,
|
|
31
|
+
excludeTools: optionalToolNameListSchema,
|
|
32
|
+
credential: z.never({ error: CREDENTIAL_FIELD_REJECTION }).optional(),
|
|
33
|
+
connection: z
|
|
34
|
+
.custom(isConnectionReference, "must be a connections.get(slug, owner) reference")
|
|
35
|
+
.optional(),
|
|
36
|
+
})
|
|
37
|
+
.check(appendToolSelectionOverlapIssue);
|
|
38
|
+
/**
|
|
39
|
+
* The MCP connector's arguments.
|
|
40
|
+
*
|
|
41
|
+
* Shape, types, and tool-name lists are the schema's job; the rules that need
|
|
42
|
+
* more than one field — a stdio server, a tool selected and deselected at once
|
|
43
|
+
* — are checks with hand-written messages. Server configs stay loose because
|
|
44
|
+
* `@langchain/mcp-adapters` accepts more per-transport options than MDA models.
|
|
45
|
+
*/
|
|
46
|
+
export const mcpServersConfig = z.object({
|
|
47
|
+
mcpServers: z
|
|
48
|
+
.record(z.string(), remoteMcpServer, {
|
|
49
|
+
error: "must be an object mapping server names to remote MCP server configs",
|
|
50
|
+
})
|
|
51
|
+
.refine((servers) => Object.keys(servers).length > 0, "requires at least one entry"),
|
|
52
|
+
prefixToolNameWithServerName: z.boolean().optional(),
|
|
53
|
+
throwOnLoadError: z.boolean().optional(),
|
|
54
|
+
useStandardContentBlocks: z.boolean().optional(),
|
|
55
|
+
onConnectionError: z.literal("throw").optional(),
|
|
56
|
+
});
|
|
57
|
+
//# sourceMappingURL=schema.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/connectors/mcp/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,qBAAqB,GAEtB,MAAM,sBAAsB,CAAC;AAE9B,8EAA8E;AAC9E,MAAM,eAAe,GACnB,sEAAsE;IACtE,6EAA6E;IAC7E,0CAA0C,CAAC;AAE7C,MAAM,0BAA0B,GAC9B,0FAA0F,CAAC;AAE7F,6EAA6E;AAC7E,MAAM,eAAe,GAAG,CAAC;KACtB,WAAW,CAAC;IACX;;;OAGG;IACH,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,kBAAkB,EAAE,CAAC;SAClB,MAAM,CAAC,8CAA8C,CAAC;SACtD,QAAQ,CAAC,8CAA8C,CAAC;SACxD,QAAQ,EAAE;IACb,YAAY,EAAE,0BAA0B;IACxC,YAAY,EAAE,0BAA0B;IACxC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrE,UAAU,EAAE,CAAC;SACV,MAAM,CACL,qBAAqB,EACrB,kDAAkD,CACnD;SACA,QAAQ,EAAE;CACd,CAAC;KACD,KAAK,CAAC,+BAA+B,CAAC,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,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"}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import type { ClientConfig, StreamableHTTPConnection } from "@langchain/mcp-adapters";
|
|
2
|
+
import type { Connector } from "../../runtime/connector.js";
|
|
3
|
+
import type { ConnectionReference } from "../../connections.js";
|
|
4
|
+
/** Per-server MCP tool selection. Names are raw, unprefixed MCP tool names. */
|
|
5
|
+
export interface McpToolSelectionConfig {
|
|
6
|
+
/**
|
|
7
|
+
* Raw MCP tool names to expose from this server. Names are matched before any
|
|
8
|
+
* managed `{server}__` prefix is applied.
|
|
9
|
+
*/
|
|
10
|
+
includeTools?: string[];
|
|
11
|
+
/**
|
|
12
|
+
* Raw MCP tool names to hide from this server. Names are matched before any
|
|
13
|
+
* managed `{server}__` prefix is applied.
|
|
14
|
+
*/
|
|
15
|
+
excludeTools?: string[];
|
|
16
|
+
}
|
|
17
|
+
/** A connection reference resolved through Agent Auth at run time. */
|
|
18
|
+
export type McpServerConnection = ConnectionReference;
|
|
19
|
+
/** Adapter connection fields MDA forwards, excluding stdio/auth the runtime owns. */
|
|
20
|
+
type AdapterRemoteConnection = Omit<StreamableHTTPConnection, "transport" | "type" | "authProvider">;
|
|
21
|
+
/** Shared remote server options plus MDA-only tool selection and connection mode. */
|
|
22
|
+
export type RemoteMcpServerBaseConfig = AdapterRemoteConnection & McpToolSelectionConfig & {
|
|
23
|
+
/**
|
|
24
|
+
* Bearer connection for this server, declared with `connections.get(...)`.
|
|
25
|
+
* An agent owner is a workspace-shared secret read once at load; a user
|
|
26
|
+
* owner is the caller's grant, loaded per caller after the gate.
|
|
27
|
+
*/
|
|
28
|
+
connection?: McpServerConnection;
|
|
29
|
+
};
|
|
30
|
+
/** Streamable HTTP MCP server connection. */
|
|
31
|
+
export type HttpMcpServerConfig = RemoteMcpServerBaseConfig & {
|
|
32
|
+
/** Remote transport. `"http"` selects Streamable HTTP. */
|
|
33
|
+
transport: "http";
|
|
34
|
+
};
|
|
35
|
+
/** Legacy SSE MCP server connection. */
|
|
36
|
+
export type SseMcpServerConfig = RemoteMcpServerBaseConfig & {
|
|
37
|
+
/** Remote transport. `"sse"` selects legacy SSE. */
|
|
38
|
+
transport: "sse";
|
|
39
|
+
};
|
|
40
|
+
/** A remote MCP server connection. Stdio servers are intentionally excluded. */
|
|
41
|
+
export type RemoteMcpServerConfig = HttpMcpServerConfig | SseMcpServerConfig;
|
|
42
|
+
/** {@link MultiServerMCPClient} options MDA exposes on `connectors.mcp`. */
|
|
43
|
+
type McpClientOptions = Pick<ClientConfig, "prefixToolNameWithServerName" | "throwOnLoadError" | "useStandardContentBlocks" | "onConnectionError">;
|
|
44
|
+
/** Configuration accepted by `connectors.mcp`. */
|
|
45
|
+
export interface McpServersConfig extends McpClientOptions {
|
|
46
|
+
/**
|
|
47
|
+
* MCP servers to connect to. Each key is the logical server name MDA uses
|
|
48
|
+
* for validation, tracing metadata, and tool-name prefixing.
|
|
49
|
+
*/
|
|
50
|
+
mcpServers: Record<string, RemoteMcpServerConfig>;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* The connector exported from a `connectors/` module for MCP. It is a branded
|
|
54
|
+
* managed {@link Connector} whose `tools` hook loads the declared MCP tools at
|
|
55
|
+
* runtime, plus the raw config the loader reads.
|
|
56
|
+
*/
|
|
57
|
+
export interface McpServersDefinition extends McpServersConfig, Connector {
|
|
58
|
+
/** Internal discriminator used by the MDA loader. */
|
|
59
|
+
readonly kind: "mcp_servers";
|
|
60
|
+
}
|
|
61
|
+
export {};
|
|
62
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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,4EAA4E;AAC5E,KAAK,gBAAgB,GAAG,IAAI,CAC1B,YAAY,EACV,8BAA8B,GAC9B,kBAAkB,GAClB,0BAA0B,GAC1B,mBAAmB,CACtB,CAAC;AAEF,kDAAkD;AAClD,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACnD;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB,EAAE,SAAS;IACvE,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/connectors/mcp/types.ts"],"names":[],"mappings":""}
|
|
@@ -20,27 +20,18 @@ export interface ToolSelection<TTool extends string = string> {
|
|
|
20
20
|
/** Tool names to hide. Applied after {@link ToolSelection.includeTools}. */
|
|
21
21
|
excludeTools?: TTool[];
|
|
22
22
|
}
|
|
23
|
-
/**
|
|
24
|
-
* Shared authoring options for connectors that load remote tools.
|
|
25
|
-
*/
|
|
26
|
-
export interface ToolSelectionConnectorConfig<TTool extends string = string> extends ToolSelection<TTool> {
|
|
27
|
-
/** Timeout for each tool call (milliseconds on the TypeScript runtime). */
|
|
28
|
-
defaultToolTimeout?: number;
|
|
29
|
-
}
|
|
30
23
|
/** Tool names: non-empty, no duplicates within one list. */
|
|
31
|
-
export declare const
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
defaultToolTimeout: z.ZodOptional<z.ZodNumber>;
|
|
35
|
-
};
|
|
36
|
-
/** Shared include/exclude overlap check for connector arg schemas. */
|
|
37
|
-
export declare function checkToolSelectionOverlap(ctx: {
|
|
24
|
+
export declare const optionalToolNameListSchema: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
25
|
+
export declare function appendToolSelectionOverlapIssue(ctx: {
|
|
26
|
+
value: unknown;
|
|
38
27
|
issues: {
|
|
39
|
-
push(issue:
|
|
28
|
+
push: (issue: {
|
|
29
|
+
code: "custom";
|
|
30
|
+
input: unknown;
|
|
31
|
+
message: string;
|
|
32
|
+
}) => void;
|
|
40
33
|
};
|
|
41
|
-
|
|
42
|
-
}, value: ToolSelection): void;
|
|
43
|
-
export declare function toolSelectionConnectorSchema<TArgs, TInput>(extra?: z.ZodRawShape): z.ZodType<TArgs, TInput>;
|
|
34
|
+
}): void;
|
|
44
35
|
/** Read the name a selection matches a loaded tool by. */
|
|
45
36
|
export type ToolNameReader = (tool: unknown) => string | undefined;
|
|
46
37
|
/** Read a loaded tool's own `name`. The default for connectors that don't rename. */
|
|
@@ -1 +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
|
|
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,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"}
|