agentfootprint 7.12.0 → 7.13.0

package/dist/types/lib/mcp/types.d.ts

@@ -1,11 +1,14 @@
 /**
- * MCP — Model Context Protocol client integration.
+ * MCP — Model Context Protocol, in both directions.
  *
  * MCP (https://modelcontextprotocol.io) is an open standard for
- * connecting LLMs to external tools and data sources. agentfootprint's
- * MCP adapter is **client-only** — it consumes MCP servers and exposes
- * their tools as agentfootprint `Tool[]` so consumers can plug them
- * straight into `agent.tool(...)`.
+ * connecting LLMs to external tools and data sources. This module
+ * bridges it both ways:
+ *
+ *   - `mcpClient(opts)`  — consume an MCP server; its tools become
+ *     agentfootprint `Tool[]` you can hand to `agent.tools(...)`.
+ *   - `mcpServe(tools, opts)` — the other direction: expose your own
+ *     `Tool[]` AS an MCP server, so any MCP client can call them.
  *
  * Pattern: Adapter (GoF) — translates MCP wire format ↔ agentfootprint
  *          `Tool` interface. The MCP SDK does the protocol work; we
@@ -14,11 +17,8 @@
  *          inline alternative for non-MCP tools).
  * Emits:   N/A directly — wrapped tools emit the standard
  *          `agentfootprint.stream.tool_start` / `tool_end` events
- *          when the agent calls them.
- *
- * Server-side support (exposing an agent or LLMCall as an MCP tool)
- * is a separate concern not yet shipped. This module covers the
- * 80% case: pulling an existing MCP server's tools INTO an agent.
+ *          when the agent calls them. `mcpServe` runs OUTSIDE any
+ *          agent run, so it emits nothing at all.
  */
 import type { Tool } from '../../core/tools.js';
 /**
@@ -32,7 +32,13 @@ export interface McpStdioTransport {
     readonly command: string;
     /** CLI args passed to the executable. */
     readonly args?: readonly string[];
-    /** Optional env vars set on the subprocess. */
+    /**
+     * Environment for the subprocess. Passed to the SDK as-is, and the SDK
+     * treats it as the WHOLE environment: set this and the child no longer
+     * inherits the safe default set (`PATH`, `HOME`, …). Omit it unless you
+     * mean to replace the environment; to merely add a variable, include the
+     * ones the child still needs.
+     */
     readonly env?: Readonly<Record<string, string>>;
     /** Working directory for the subprocess. */
     readonly cwd?: string;
@@ -107,22 +113,29 @@ export interface McpClient {
  *      a lazy peer-dep)
  *
  * The real SDK exports a richer surface; we narrow to what's needed.
+ *
+ * Argument POSITION matters here and is easy to get wrong: the SDK keeps
+ * per-request options (`signal`, `timeout`) in a SEPARATE trailing
+ * argument, never inside the JSON-RPC params. A `signal` smuggled into
+ * the params object is serialized onto the wire as `{}` and silently
+ * fails to cancel anything, so these signatures mirror the SDK's own
+ * shape rather than a flattened convenience version of it.
  */
 export interface McpSdkClient {
-    connect(transport: unknown): Promise<void>;
-    listTools(): Promise<{
+    connect(transport: unknown, options?: McpRequestOptions): Promise<void>;
+    listTools(params?: undefined, options?: McpRequestOptions): Promise<{
         readonly tools: ReadonlyArray<{
             readonly name: string;
             readonly description?: string;
             readonly inputSchema: Readonly<Record<string, unknown>>;
         }>;
     }>;
-    callTool(args: {
+    callTool(params: {
         readonly name: string;
         readonly arguments?: Readonly<Record<string, unknown>>;
-        /** Forwarded from `McpClientOptions.signal` so consumers can cancel hung tool calls. */
-        readonly signal?: AbortSignal;
-    }): Promise<{
+    }, 
+    /** The SDK's result schema. We always want its default, so we pass `undefined`. */
+    resultSchema?: undefined, options?: McpRequestOptions): Promise<{
         readonly content: ReadonlyArray<{
             readonly type: string;
             readonly text?: string;
@@ -131,4 +144,104 @@ export interface McpSdkClient {
     }>;
     close(): Promise<void>;
 }
+/**
+ * The SDK's trailing per-request options argument, narrowed to the one
+ * field we forward from {@link McpClientOptions.signal}.
+ */
+export interface McpRequestOptions {
+    readonly signal?: AbortSignal;
+}
+/**
+ * `stdio` transport — the server speaks MCP over its own stdin/stdout.
+ * This is how a desktop MCP host launches a server: it spawns your
+ * process and talks down the pipe. The default.
+ *
+ * One consequence worth stating out loud: stdout belongs to the
+ * protocol. Anything else your process prints there corrupts the
+ * stream, so log to stderr.
+ */
+export interface McpStdioServeTransport {
+    readonly transport: 'stdio';
+}
+/**
+ * `http` transport — the server listens on a port and speaks MCP over
+ * Streamable HTTP. Stateless (no session ids): every request is
+ * self-contained, which is what makes it safe to run several replicas
+ * behind a load balancer.
+ */
+export interface McpHttpServeTransport {
+    readonly transport: 'http';
+    /** TCP port to listen on. */
+    readonly port: number;
+    /** Interface to bind. Defaults to Node's own default (all interfaces). */
+    readonly host?: string;
+    /** URL path the MCP endpoint answers on. Default `'/mcp'`. */
+    readonly path?: string;
+}
+export type McpServeTransport = McpStdioServeTransport | McpHttpServeTransport;
+export interface McpServeOptions {
+    /**
+     * Server name reported to clients on connect. Surfaces in the
+     * client's server list. Default `'agentfootprint'`.
+     */
+    readonly name?: string;
+    /** Server version reported to clients. Default `'0.0.0'`. */
+    readonly version?: string;
+    /** Transport configuration. Default `{ transport: 'stdio' }`. */
+    readonly transport?: McpServeTransport;
+    /**
+     * Credential provider for served tools that declare `needs`. The
+     * credential is resolved BEFORE `execute` and injected as
+     * `ctx.credential`, exactly as the Agent's tool-call stage does it.
+     *
+     * Serving a `needs`-declaring tool without this is refused at
+     * construction: the tool would run with `ctx.credential` undefined
+     * and fail somewhere further in, or worse, not fail at all.
+     */
+    readonly credentials?: import('../../identity/types.js').CredentialProvider;
+    /**
+     * @internal Pre-built SDK server for tests. Skips SDK import +
+     * transport construction. Mirrors `McpClientOptions._client`.
+     */
+    readonly _server?: McpSdkServer;
+}
+/**
+ * What `mcpServe(...)` returns. The server is already listening by the
+ * time you hold this; `close()` is the only thing left to do.
+ */
+export interface McpServeHandle {
+    /** Server name from options (or the default). */
+    readonly name: string;
+    /** Names of the tools being served, in the order clients will list them. */
+    readonly toolNames: readonly string[];
+    /**
+     * Stop serving: closes the transport (and, for `http`, the listening
+     * socket) and then the MCP server. Idempotent — calling it twice is
+     * not an error, so a shutdown hook and an explicit close can coexist.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Minimal structural type for the parts of the MCP SDK's low-level
+ * `Server` we touch. Defined locally for the same two reasons as
+ * {@link McpSdkClient}: test injection via `McpServeOptions._server`,
+ * and no hard import on the lazy peer-dep.
+ */
+export interface McpSdkServer {
+    setRequestHandler(schema: unknown, handler: (request: McpCallToolRequest, extra: {
+        readonly signal?: AbortSignal;
+    }) => unknown): void;
+    connect(transport: unknown): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * The shape `tools/call` requests arrive in. `tools/list` requests carry
+ * no params we read, so one request type covers both handlers.
+ */
+export interface McpCallToolRequest {
+    readonly params?: {
+        readonly name?: string;
+        readonly arguments?: unknown;
+    };
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types/lib/mcp/types.d.ts.map

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

package/dist/types/tool-providers/index.d.ts

@@ -13,6 +13,12 @@
  *    - `mcpClient(opts)` — connect to an MCP server (real)
  *    - `mockMcpClient({ tools })` — in-memory MCP source for dev / tests
  *
+ * 3. Tool sink — the other direction
+ *    - `mcpServe(tools, opts)` — expose your own `Tool[]` AS an MCP
+ *      server, so any MCP client can call them. The served tool is the
+ *      SAME object you pass in, so whatever governance you composed
+ *      around it still runs.
+ *
  * Compose freely. The dispatch layer is decorator-shaped (mirroring
  * `withRetry` / `withFallback` over LLMProvider). Tool sources produce
  * `Tool[]` that flow into a `staticTools(arr)` provider, which can
@@ -37,6 +43,6 @@ export { staticTools } from './staticTools.js';
 export { gatedTools } from './gatedTools.js';
 export { skillScopedTools } from './skillScopedTools.js';
 export type { ToolProvider, ToolDispatchContext, ToolGatePredicate } from './types.js';
-export { mcpClient, mockMcpClient } from '../lib/mcp/index.js';
-export type { McpClient, McpClientOptions, McpSdkClient, McpTransport, McpStdioTransport, McpHttpTransport, MockMcpClientOptions, MockMcpTool, } from '../lib/mcp/index.js';
+export { mcpClient, mcpServe, mockMcpClient } from '../lib/mcp/index.js';
+export type { McpClient, McpClientOptions, McpSdkClient, McpTransport, McpStdioTransport, McpHttpTransport, MockMcpClientOptions, MockMcpTool, McpServeOptions, McpServeHandle, McpServeTransport, McpStdioServeTransport, McpHttpServeTransport, McpSdkServer, } from '../lib/mcp/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/tool-providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tool-providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKvF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,GACZ,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tool-providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKvF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzE,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,GACb,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint",
-  "version": "7.12.0",
+  "version": "7.13.0",
   "description": "The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.",
   "license": "MIT",
   "author": "Sanjay Krishna Anbalagan",
@@ -461,6 +461,7 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.1",
+    "@modelcontextprotocol/sdk": "^1.30.0",
     "@types/node": "^25.5.2",
     "@typescript-eslint/eslint-plugin": "^5.61.0",
     "@typescript-eslint/parser": "^5.61.0",