agentfootprint 7.12.0 → 7.14.0

package/dist/esm/lib/mcp/mcpClient.js

@@ -52,7 +52,7 @@ const DEFAULT_CLIENT_INFO = {
  */
 export async function mcpClient(opts) {
     const name = opts.name ?? 'mcp';
-    const sdk = opts._client ?? (await resolveClient(opts.transport, opts.clientInfo));
+    const sdk = opts._client ?? (await resolveClient(opts.transport, opts.clientInfo, opts.signal));
     // Tool cache so consumers calling `.tools()` more than once don't
     // hammer the server. `.refresh()` invalidates it.
     let cache = null;
@@ -63,7 +63,11 @@ export async function mcpClient(opts) {
         }
     };
     const buildTools = async () => {
-        const listed = await sdk.listTools();
+        // `signal` rides in the SDK's THIRD argument (RequestOptions), not in
+        // the request params — see `wrapMcpTool`.
+        const listed = opts.signal
+            ? await sdk.listTools(undefined, { signal: opts.signal })
+            : await sdk.listTools();
         return listed.tools.map((t) => wrapMcpTool(name, sdk, t, opts.signal));
     };
     return {
@@ -89,7 +93,7 @@ export async function mcpClient(opts) {
     };
 }
 // ─── SDK construction (lazy require) ───────────────────────────────
-async function resolveClient(transport, clientInfo) {
+async function resolveClient(transport, clientInfo, signal) {
     let mod;
     try {
         mod = lazyRequire('@modelcontextprotocol/sdk/client/index.js');
@@ -103,7 +107,11 @@ async function resolveClient(transport, clientInfo) {
         capabilities: {},
     });
     const transportImpl = await buildTransport(transport);
-    await client.connect(transportImpl);
+    // Same rule as callTool: options ride beside the transport, never inside it.
+    if (signal)
+        await client.connect(transportImpl, { signal });
+    else
+        await client.connect(transportImpl);
     return client;
 }
 async function buildTransport(t) {
@@ -151,11 +159,15 @@ function wrapMcpTool(serverName, sdk, mcp, signal) {
             const argsObj = args !== null && typeof args === 'object' && !Array.isArray(args)
                 ? args
                 : {};
-            const result = await sdk.callTool({
-                name: mcp.name,
-                arguments: argsObj,
-                ...(signal && { signal }),
-            });
+            // The abort signal is NOT a request param — it belongs to the SDK's
+            // third argument (`RequestOptions`). Put it in the params object and
+            // it gets serialized onto the wire as an empty `{}` and the call is
+            // uncancellable: a silent no-op that only a real transport reveals.
+            // `resultSchema` (2nd arg) is left to the SDK's own default.
+            const params = { name: mcp.name, arguments: argsObj };
+            const result = signal
+                ? await sdk.callTool(params, undefined, { signal })
+                : await sdk.callTool(params);
             // MCP returns content blocks. We concatenate text blocks into
             // a single string for the agent's tool-result event payload.
             // Non-text blocks (images, resources) are summarized with their

package/dist/esm/lib/mcp/mcpClient.js.map

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

package/dist/esm/lib/mcp/mcpServe.d.ts

@@ -0,0 +1,70 @@
+/**
+ * mcpServe — expose your agentfootprint tools AS an MCP server.
+ *
+ *   const handle = await mcpServe([lookupTool, refundTool], {
+ *     name: 'support-desk',
+ *     version: '1.0.0',
+ *   });
+ *
+ *   // …later
+ *   await handle.close();
+ *
+ * `mcpClient` pulls someone else's tools in. This pushes yours out, so
+ * the tool you already wrote, tested and governed can be called by any
+ * MCP client — a desktop host, another team's agent, an IDE — without
+ * being rewritten against a second tool interface.
+ *
+ * Pattern: Adapter (GoF), pointed the other way. `mcpClient` translates
+ *          MCP → `Tool`; this translates `Tool` → MCP. Same SDK, same
+ *          lazy-require discipline, mirrored lifecycle (`close()`).
+ *
+ * ── The one promise worth stating plainly ────────────────────────────
+ * A served tool is THE SAME OBJECT you passed in. `mcpServe` holds your
+ * `Tool` by reference and calls `tool.execute(args, ctx)` — it never
+ * copies the schema and re-implements the body, never unwraps a
+ * decorator, never reaches past a wrapper to an inner tool. So whatever
+ * governance you composed around that tool — a permission check inside
+ * `execute`, a redaction step, an audit hook — is still the thing that
+ * runs when a remote client calls it. Serving is not a second door into
+ * your tool; it is the same door with a longer corridor.
+ *
+ * Two demands the library CANNOT keep over MCP are refused at
+ * construction rather than silently dropped:
+ *   - `checkIn` (human consent before the tool runs) needs a pause
+ *     channel that a request/response protocol does not have.
+ *   - `needs` (declare-and-push credentials) needs a provider; without
+ *     one the tool would run with `ctx.credential` undefined.
+ *
+ * ── Schemas ──────────────────────────────────────────────────────────
+ * Tools already carry JSON Schema in `schema.inputSchema`, and MCP's
+ * `tools/list` wants JSON Schema, so the mapping is the identity
+ * function. That is also why this builds on the SDK's low-level
+ * `Server` rather than its `McpServer` convenience wrapper — the latter
+ * takes zod schemas, which would mean converting a JSON Schema you
+ * already have into zod (a new dependency) to convert it straight back.
+ */
+import type { Tool } from '../../core/tools.js';
+import type { McpServeHandle, McpServeOptions } from './types.js';
+/**
+ * Serve `tools` over MCP. Resolves once the transport is connected (for
+ * `http`, once the socket is listening), so holding the handle means the
+ * server is live.
+ *
+ * @throws at construction when `tools` is empty, when two tools share a
+ *   name, when a tool declares `checkIn`, or when a tool declares `needs`
+ *   without `opts.credentials` — see the module header. Also throws when
+ *   `@modelcontextprotocol/sdk` is not installed.
+ */
+export declare function mcpServe(tools: readonly Tool[], opts?: McpServeOptions): Promise<McpServeHandle>;
+/**
+ * Sentinels handed to an injected `_server` in place of the SDK's zod
+ * schemas. Exported so a test can tell the two handlers apart.
+ * @internal
+ */
+export declare const LIST_TOOLS_SENTINEL: Readonly<{
+    method: "tools/list";
+}>;
+/** @internal @see LIST_TOOLS_SENTINEL */
+export declare const CALL_TOOL_SENTINEL: Readonly<{
+    method: "tools/call";
+}>;

package/dist/esm/lib/mcp/mcpServe.js

@@ -0,0 +1,374 @@
+/**
+ * mcpServe — expose your agentfootprint tools AS an MCP server.
+ *
+ *   const handle = await mcpServe([lookupTool, refundTool], {
+ *     name: 'support-desk',
+ *     version: '1.0.0',
+ *   });
+ *
+ *   // …later
+ *   await handle.close();
+ *
+ * `mcpClient` pulls someone else's tools in. This pushes yours out, so
+ * the tool you already wrote, tested and governed can be called by any
+ * MCP client — a desktop host, another team's agent, an IDE — without
+ * being rewritten against a second tool interface.
+ *
+ * Pattern: Adapter (GoF), pointed the other way. `mcpClient` translates
+ *          MCP → `Tool`; this translates `Tool` → MCP. Same SDK, same
+ *          lazy-require discipline, mirrored lifecycle (`close()`).
+ *
+ * ── The one promise worth stating plainly ────────────────────────────
+ * A served tool is THE SAME OBJECT you passed in. `mcpServe` holds your
+ * `Tool` by reference and calls `tool.execute(args, ctx)` — it never
+ * copies the schema and re-implements the body, never unwraps a
+ * decorator, never reaches past a wrapper to an inner tool. So whatever
+ * governance you composed around that tool — a permission check inside
+ * `execute`, a redaction step, an audit hook — is still the thing that
+ * runs when a remote client calls it. Serving is not a second door into
+ * your tool; it is the same door with a longer corridor.
+ *
+ * Two demands the library CANNOT keep over MCP are refused at
+ * construction rather than silently dropped:
+ *   - `checkIn` (human consent before the tool runs) needs a pause
+ *     channel that a request/response protocol does not have.
+ *   - `needs` (declare-and-push credentials) needs a provider; without
+ *     one the tool would run with `ctx.credential` undefined.
+ *
+ * ── Schemas ──────────────────────────────────────────────────────────
+ * Tools already carry JSON Schema in `schema.inputSchema`, and MCP's
+ * `tools/list` wants JSON Schema, so the mapping is the identity
+ * function. That is also why this builds on the SDK's low-level
+ * `Server` rather than its `McpServer` convenience wrapper — the latter
+ * takes zod schemas, which would mean converting a JSON Schema you
+ * already have into zod (a new dependency) to convert it straight back.
+ */
+import { unconfiguredCredentialProvider } from '../../identity/types.js';
+import { lazyRequire } from '../lazyRequire.js';
+const DEFAULT_SERVER_NAME = 'agentfootprint';
+const DEFAULT_SERVER_VERSION = '0.0.0';
+const DEFAULT_HTTP_PATH = '/mcp';
+/**
+ * Serve `tools` over MCP. Resolves once the transport is connected (for
+ * `http`, once the socket is listening), so holding the handle means the
+ * server is live.
+ *
+ * @throws at construction when `tools` is empty, when two tools share a
+ *   name, when a tool declares `checkIn`, or when a tool declares `needs`
+ *   without `opts.credentials` — see the module header. Also throws when
+ *   `@modelcontextprotocol/sdk` is not installed.
+ */
+export async function mcpServe(tools, opts = {}) {
+    const name = opts.name ?? DEFAULT_SERVER_NAME;
+    const version = opts.version ?? DEFAULT_SERVER_VERSION;
+    const byName = validateServableTools(tools, name, opts.credentials);
+    const credentials = opts.credentials ?? unconfiguredCredentialProvider();
+    const listing = tools.map((t) => ({
+        name: t.schema.name,
+        ...(t.schema.description !== undefined && { description: t.schema.description }),
+        inputSchema: t.schema.inputSchema ?? { type: 'object', properties: {} },
+    }));
+    // Order matters: the server is resolved FIRST so that a missing SDK is
+    // reported by the message that tells you how to install it, rather than
+    // by the narrower one about a single submodule.
+    const rootServer = opts._server ?? (await resolveServer(name, version));
+    const { listSchema, callSchema } = await resolveRequestSchemas(opts._server !== undefined);
+    let callCounter = 0;
+    const handleCall = async (request, extra) => {
+        // Everything below this line is inside one try/catch on purpose. A
+        // client we do not control chose this request; a bad choice is a tool
+        // error reported back over the protocol, never an exception that
+        // escapes the SDK's dispatch loop and takes the server down with it.
+        try {
+            const toolName = request?.params?.name;
+            const tool = typeof toolName === 'string' ? byName.get(toolName) : undefined;
+            if (!tool) {
+                return toolError(`Unknown tool '${String(toolName)}'. Served tools: ${listing
+                    .map((t) => t.name)
+                    .join(', ')}.`);
+            }
+            const ctx = await buildExecutionContext(tool, `mcp-${name}-${++callCounter}`, {
+                credentials,
+                hasCredentials: opts.credentials !== undefined,
+                ...(extra?.signal && { signal: extra.signal }),
+            });
+            if ('blocked' in ctx)
+                return toolError(ctx.blocked);
+            // Args are forwarded EXACTLY as the client sent them. Validating
+            // them here would mean a second, weaker copy of the tool's own
+            // contract — and a tool that already rejects bad input is the one
+            // place that rejection belongs.
+            const result = await tool.execute(request?.params?.arguments, ctx.context);
+            return { content: [{ type: 'text', text: stringifyResult(result) }] };
+        }
+        catch (error) {
+            return toolError(error instanceof Error ? error.message : String(error));
+        }
+    };
+    /**
+     * Put our two handlers on one SDK server. Factored out of the body
+     * because the streamable-HTTP path cannot reuse a single server: the
+     * SDK's stateless transport refuses a second request ("Stateless
+     * transport cannot be reused across requests"), so that path builds a
+     * fresh server + transport per request and needs to install the same
+     * two handlers on each one. `listing` and `byName` are captured, so
+     * every server instance serves the same tools — the same objects.
+     */
+    const install = (server) => {
+        server.setRequestHandler(listSchema, () => ({ tools: listing }));
+        server.setRequestHandler(callSchema, handleCall);
+        return server;
+    };
+    const sdk = install(rootServer);
+    const connection = await connectTransport(sdk, opts.transport ?? { transport: 'stdio' }, opts, async () => install(await resolveServer(name, version)));
+    let closed = false;
+    return {
+        name,
+        toolNames: listing.map((t) => t.name),
+        async close() {
+            if (closed)
+                return;
+            closed = true;
+            await connection.close();
+            await sdk.close();
+        },
+    };
+}
+// ─── Construction-time refusals ────────────────────────────────────
+/**
+ * Build the dispatch map and refuse, by name, every tool this transport
+ * cannot honour. All of these are author mistakes, and all of them are
+ * invisible at run time if we let them through — a duplicate name means
+ * one tool silently shadows another; a dropped `checkIn` means a
+ * consent gate that quietly stopped gating.
+ */
+function validateServableTools(tools, serverName, credentials) {
+    if (tools.length === 0) {
+        throw new Error(`mcpServe('${serverName}'): no tools to serve. Pass at least one Tool — a server ` +
+            `advertising an empty tool list is indistinguishable from a broken one.`);
+    }
+    const byName = new Map();
+    for (const tool of tools) {
+        const name = tool.schema.name;
+        if (byName.has(name)) {
+            throw new Error(`mcpServe('${serverName}'): duplicate tool name '${name}'. MCP clients dispatch by ` +
+                `name, so one of the two could never be reached.`);
+        }
+        if (tool.checkIn !== undefined) {
+            throw new Error(`mcpServe('${serverName}'): tool '${name}' declares checkIn, which asks a human to ` +
+                `approve the call before it runs. MCP is request/response — there is no pause to ` +
+                `carry that ask — so serving it would drop the consent gate silently. Serve a ` +
+                `variant without checkIn, or keep this tool inside an agent that can pause.`);
+        }
+        if (tool.needs !== undefined && credentials === undefined) {
+            throw new Error(`mcpServe('${serverName}'): tool '${name}' declares needs.credential ` +
+                `'${tool.needs.credential}' but no credential provider was passed. Pass ` +
+                `mcpServe(tools, { credentials }) so the credential is resolved before execute, ` +
+                `the same way the Agent resolves it.`);
+        }
+        byName.set(name, tool);
+    }
+    return byName;
+}
+// ─── Per-call execution context ────────────────────────────────────
+/**
+ * Assemble the `ToolExecutionContext` for one served call, resolving a
+ * declared credential first. Returns `{ blocked }` instead of throwing
+ * when the credential is unavailable, so the client is told WHY in a
+ * tool-error result rather than seeing a generic failure.
+ */
+async function buildExecutionContext(tool, toolCallId, wiring) {
+    const { credentials, hasCredentials, signal } = wiring;
+    let credential;
+    const need = tool.needs;
+    if (need) {
+        const resolved = await credentials.getCredential({
+            service: need.credential,
+            ...(need.scopes && { scopes: need.scopes }),
+            ...(need.mode && { mode: need.mode }),
+        });
+        // Fail-closed, mirroring the Agent's tool-call stage: a tool that
+        // asked for a credential never runs without one.
+        if (resolved.status !== 'issued') {
+            return {
+                blocked: `authorization required for '${need.credential}': ${resolved.authorizationUrl}`,
+            };
+        }
+        credential = resolved.credential;
+    }
+    return {
+        context: {
+            toolCallId,
+            // There is no ReAct loop out here — a served call is a single
+            // request, so the iteration a tool might branch on is zero.
+            iteration: 0,
+            credentials,
+            hasCredentials,
+            ...(signal && { signal }),
+            ...(credential && { credential }),
+        },
+    };
+}
+// ─── Result mapping ────────────────────────────────────────────────
+/** MCP carries text blocks; a Tool returns anything JSON-serializable. */
+function stringifyResult(result) {
+    if (typeof result === 'string')
+        return result;
+    if (result === undefined)
+        return '';
+    try {
+        return JSON.stringify(result) ?? String(result);
+    }
+    catch {
+        // Circular or otherwise unserializable — say so rather than throwing
+        // from the happy path.
+        return String(result);
+    }
+}
+/** A tool-level error: reported IN the result, per the MCP spec, not thrown. */
+function toolError(message) {
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
+// ─── SDK construction (lazy require) ───────────────────────────────
+async function resolveServer(name, version) {
+    let mod;
+    try {
+        mod = lazyRequire('@modelcontextprotocol/sdk/server/index.js');
+    }
+    catch {
+        throw new Error('mcpServe requires @modelcontextprotocol/sdk.\n' +
+            '  Install:  npm install @modelcontextprotocol/sdk\n' +
+            '  Or pass `_server` for test injection.');
+    }
+    return new mod.Server({ name, version }, { capabilities: { tools: {} } });
+}
+/**
+ * The request schemas the SDK dispatches on. With an injected `_server`
+ * there is no SDK to read them from, so tests get stable sentinel
+ * objects — the injected server decides what to do with them.
+ */
+async function resolveRequestSchemas(injected) {
+    if (injected) {
+        return { listSchema: LIST_TOOLS_SENTINEL, callSchema: CALL_TOOL_SENTINEL };
+    }
+    let types;
+    try {
+        types = lazyRequire('@modelcontextprotocol/sdk/types.js');
+    }
+    catch {
+        throw new Error('mcpServe requires @modelcontextprotocol/sdk/types.js — check that ' +
+            '@modelcontextprotocol/sdk is installed at the latest version.');
+    }
+    return { listSchema: types.ListToolsRequestSchema, callSchema: types.CallToolRequestSchema };
+}
+/**
+ * Sentinels handed to an injected `_server` in place of the SDK's zod
+ * schemas. Exported so a test can tell the two handlers apart.
+ * @internal
+ */
+export const LIST_TOOLS_SENTINEL = Object.freeze({ method: 'tools/list' });
+/** @internal @see LIST_TOOLS_SENTINEL */
+export const CALL_TOOL_SENTINEL = Object.freeze({ method: 'tools/call' });
+/**
+ * For stdio and for an injected test server there is nothing extra to
+ * unwind: the SDK's own `server.close()` closes the transport it is
+ * connected to. Only the HTTP path owns a socket of its own.
+ */
+const NOTHING_TO_UNWIND = { close: () => Promise.resolve() };
+async function connectTransport(sdk, transport, opts, newServer) {
+    // An injected server is a test double: there is no real transport to
+    // build, and building one would spawn a listener or seize stdio.
+    if (opts._server) {
+        await sdk.connect(undefined);
+        return NOTHING_TO_UNWIND;
+    }
+    if (transport.transport === 'stdio') {
+        let stdioMod;
+        try {
+            stdioMod = lazyRequire('@modelcontextprotocol/sdk/server/stdio.js');
+        }
+        catch {
+            throw new Error('mcpServe(stdio) requires @modelcontextprotocol/sdk/server/stdio.js — ' +
+                'check that @modelcontextprotocol/sdk is installed at the latest version.');
+        }
+        await sdk.connect(new stdioMod.StdioServerTransport());
+        return NOTHING_TO_UNWIND;
+    }
+    // HTTP deliberately does not use `sdk`: it mints a server per request
+    // (see connectHttp). The root server stays unconnected, which makes the
+    // handle's `sdk.close()` a harmless no-op on this path.
+    return connectHttp(transport, newServer);
+}
+/**
+ * Streamable HTTP. The SDK's transport handles the protocol but does not
+ * own a socket — it expects to be driven from a request handler — so the
+ * listener is ours, built on node:http (built in; no new dependency).
+ *
+ * Stateless (`sessionIdGenerator: undefined`): no session table to keep,
+ * nothing to expire, and several replicas can serve the same tools.
+ *
+ * Statelessness is not just a config flag here — it decides the shape of
+ * this function. The SDK's stateless transport is single-use by design
+ * (reusing one would let two clients collide on JSON-RPC message ids), so
+ * it throws on its second request. Each request therefore gets its own
+ * transport, and — because one SDK server can only be attached to one
+ * transport — its own server. Both are thrown away when the response
+ * closes. The tools they serve are the same objects either way.
+ */
+async function connectHttp(transport, newServer) {
+    let httpMod;
+    try {
+        httpMod = lazyRequire('@modelcontextprotocol/sdk/server/streamableHttp.js');
+    }
+    catch {
+        throw new Error('mcpServe(http) requires @modelcontextprotocol/sdk/server/streamableHttp.js — ' +
+            'check that @modelcontextprotocol/sdk is installed at the latest version.');
+    }
+    const { createServer } = await import('node:http');
+    const serveOne = async (req, res) => {
+        const server = await newServer();
+        const mcpTransport = new httpMod.StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+        });
+        // The pair lives exactly as long as the response does.
+        res.on('close', () => {
+            void mcpTransport.close();
+            void server.close();
+        });
+        await server.connect(mcpTransport);
+        await mcpTransport.handleRequest(req, res);
+    };
+    const path = transport.path ?? DEFAULT_HTTP_PATH;
+    const listener = createServer((req, res) => {
+        // Route on the path only; the transport itself decides which HTTP
+        // methods it accepts on the MCP endpoint.
+        const url = req.url ?? '';
+        if (url.split('?')[0] !== path) {
+            res.statusCode = 404;
+            res.end();
+            return;
+        }
+        // One failed request must not take the listener down. The client is
+        // told (500 is a protocol-level error it surfaces); the next request
+        // is served normally.
+        void serveOne(req, res).catch(() => {
+            if (!res.headersSent) {
+                res.statusCode = 500;
+                res.end();
+            }
+        });
+    });
+    await new Promise((resolve, reject) => {
+        listener.once('error', reject);
+        if (transport.host !== undefined)
+            listener.listen(transport.port, transport.host, resolve);
+        else
+            listener.listen(transport.port, resolve);
+    });
+    return {
+        close: () => new Promise((resolve, reject) => {
+            listener.close((err) => (err ? reject(err) : resolve()));
+        }),
+    };
+}
+//# sourceMappingURL=mcpServe.js.map

package/dist/esm/lib/mcp/mcpServe.js.map

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