@openrouter/mcp 0.0.1

package/README.md

@@ -0,0 +1,127 @@
+# @openrouter/mcp
+
+Expose the tools of a remote [Model Context Protocol](https://modelcontextprotocol.io) server
+(Streamable HTTP or SSE) as tools you can pass straight into
+[`@openrouter/agent`](https://www.npmjs.com/package/@openrouter/agent)'s `callModel`.
+
+- Connect to a non-stdio MCP server, authenticate **once**, and reuse that auth for tool
+  discovery and every tool call.
+- Faithful JSON Schema → Zod conversion so the model sees real parameters.
+- Serializable, rehydratable cache so you can skip re-listing (and, opt-in, re-authenticating).
+- Progress streaming, `tools/list_changed` auto-refresh, cancellation, resources, and elicitation.
+
+> stdio servers are intentionally out of scope.
+
+## Install
+
+```bash
+pnpm add @openrouter/mcp @openrouter/agent
+```
+
+## Quick start
+
+```ts
+import { OpenRouter } from '@openrouter/agent';
+import { callModel } from '@openrouter/agent/call-model';
+import { createMCPTools } from '@openrouter/mcp';
+
+const client = new OpenRouter({ apiKey: process.env.OPENROUTER_API_KEY });
+
+const mcp = await createMCPTools({
+  url: 'https://mcp.example.com/mcp',
+  auth: { kind: 'bearer', token: process.env.MCP_TOKEN },
+});
+
+const result = callModel(client, {
+  model: 'anthropic/claude-opus-4-8',
+  input: 'What are my three most recently updated issues?',
+  tools: mcp.tools,
+});
+
+console.log(await result.getText());
+await mcp.close();
+```
+
+## Authentication
+
+Auth is supplied once and reused for discovery and every call:
+
+```ts
+// Static bearer token
+auth: { kind: 'bearer', token }
+// Arbitrary headers
+auth: { kind: 'headers', headers: { 'X-API-Key': key } }
+// Pluggable OAuth (you own token refresh/storage)
+auth: { kind: 'oauth', provider }
+```
+
+Prefer an `OAuthClientProvider` over caching static tokens — the transport refreshes through it
+automatically.
+
+## Caching & rehydration
+
+Persist a snapshot and rebuild later without a `listTools()` round-trip:
+
+```ts
+import { createMCPTools, rehydrateMCPTools } from '@openrouter/mcp';
+
+const mcp = await createMCPTools({ url, auth, cacheCredentials: true });
+const snapshot = await mcp.serialize();   // plain JSON — store anywhere
+await mcp.close();
+
+const mcp2 = await rehydrateMCPTools({ snapshot, auth });
+```
+
+Or let a store manage it (rehydrate on hit, connect + write on miss):
+
+```ts
+import { InMemoryMCPCacheStore } from '@openrouter/mcp';
+
+const store = new InMemoryMCPCacheStore(); // or your own Redis/DB-backed MCPCacheStore
+const mcp = await createMCPTools({
+  url,
+  auth,
+  cache: { store, key: `mcp:${userId}` },
+  staleness: { maxAgeMs: 60 * 60 * 1000 },
+});
+```
+
+> **Security:** `cacheCredentials` is `false` by default. When enabled, snapshots contain bearer
+> tokens/headers — treat the store as a secret store and namespace cache keys by principal in
+> multi-tenant setups.
+
+## Multiple servers
+
+```ts
+const [github, linear] = await Promise.all([
+  createMCPTools({ url: githubUrl, auth: gh, toolNamePrefix: 'github_' }),
+  createMCPTools({ url: linearUrl, auth: ln, toolNamePrefix: 'linear_' }),
+]);
+
+const result = callModel(client, {
+  model,
+  input: 'Find the Linear issue linked to GitHub PR #42.',
+  tools: [...github.tools, ...linear.tools],
+});
+```
+
+## Options
+
+| Option | Description |
+| --- | --- |
+| `url` | Remote MCP server endpoint. |
+| `transport` | `'streamableHttp'` (default, falls back to SSE) or `'sse'`. |
+| `auth` | Bearer token, headers, or an `OAuthClientProvider`. |
+| `toolNamePrefix` | Prefix every wrapped tool name. |
+| `includeTools` / `excludeTools` | Allow/deny lists by MCP tool name. |
+| `onUnconvertibleSchema` | `'looseLeaf'` (default) or `'throw'` for exotic JSON Schema. |
+| `cache` / `cacheCredentials` / `staleness` | Caching controls. |
+| `resources` | Expose synthetic `list_resources` / `read_resource` tools (default on). |
+| `emitProgress` | Stream MCP progress as generator-tool events (default on). |
+| `autoRefreshOnListChanged` | Re-list on `tools/list_changed` (default on). |
+| `onElicitation` | Handle server elicitation requests; auto-declines when omitted. |
+| `signal` | Abort signal threaded into every tool call. |
+
+## License
+
+Apache-2.0

package/esm/auth/auth-resolver.d.ts

@@ -0,0 +1,14 @@
+import type { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
+import type { MCPAuth } from './auth-types.js';
+/**
+ * The transport-level pieces derived from an {@link MCPAuth}: static headers to
+ * merge into `requestInit`, and/or an OAuth provider to hand to the transport.
+ * Both flow into the same connected client, so discovery and tool calls share
+ * one authenticated session.
+ */
+export interface ResolvedAuth {
+    headers: Record<string, string>;
+    authProvider?: OAuthClientProvider;
+}
+export declare function resolveAuth(auth: MCPAuth | undefined): ResolvedAuth;
+//# sourceMappingURL=auth-resolver.d.ts.map

package/esm/auth/auth-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-resolver.d.ts","sourceRoot":"","sources":["../../src/auth/auth-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,YAAY,CAyBnE"}

package/esm/auth/auth-resolver.js

@@ -0,0 +1,27 @@
+export function resolveAuth(auth) {
+    if (auth === undefined) {
+        return {
+            headers: {},
+        };
+    }
+    switch (auth.kind) {
+        case 'bearer':
+            return {
+                headers: {
+                    Authorization: `Bearer ${auth.token}`,
+                },
+            };
+        case 'headers':
+            return {
+                headers: {
+                    ...auth.headers,
+                },
+            };
+        case 'oauth':
+            return {
+                headers: {},
+                authProvider: auth.provider,
+            };
+    }
+}
+//# sourceMappingURL=auth-resolver.js.map

package/esm/auth/auth-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-resolver.js","sourceRoot":"","sources":["../../src/auth/auth-resolver.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,WAAW,CAAC,IAAyB;IACnD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IACD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO;gBACL,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE;iBACtC;aACF,CAAC;QACJ,KAAK,SAAS;YACZ,OAAO;gBACL,OAAO,EAAE;oBACP,GAAG,IAAI,CAAC,OAAO;iBAChB;aACF,CAAC;QACJ,KAAK,OAAO;YACV,OAAO;gBACL,OAAO,EAAE,EAAE;gBACX,YAAY,EAAE,IAAI,CAAC,QAAQ;aAC5B,CAAC;IACN,CAAC;AACH,CAAC"}

package/esm/auth/auth-types.d.ts

@@ -0,0 +1,25 @@
+import type { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
+/**
+ * Authentication for a remote MCP server. Supplied once and reused by the
+ * connected client for tool discovery and every subsequent tool call.
+ *
+ * - `bearer`: a static bearer token sent as `Authorization: Bearer <token>`.
+ * - `headers`: arbitrary static headers (e.g. API keys, custom auth schemes).
+ * - `oauth`: a user-supplied {@link OAuthClientProvider} that owns token
+ *   acquisition/refresh. Preferred over caching static tokens.
+ */
+export type MCPAuth = {
+    kind: 'bearer';
+    token: string;
+} | {
+    kind: 'headers';
+    headers: Readonly<Record<string, string>>;
+} | {
+    kind: 'oauth';
+    provider: OAuthClientProvider;
+};
+export declare function isOAuthAuth(auth: MCPAuth | undefined): auth is {
+    kind: 'oauth';
+    provider: OAuthClientProvider;
+};
+//# sourceMappingURL=auth-types.d.ts.map

package/esm/auth/auth-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-types.d.ts","sourceRoot":"","sources":["../../src/auth/auth-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAEpF;;;;;;;;GAQG;AACH,MAAM,MAAM,OAAO,GACf;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3C,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,mBAAmB,CAAC;CAC/B,CAAC;AAEN,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,IAAI;IAC9D,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,mBAAmB,CAAC;CAC/B,CAEA"}

package/esm/auth/auth-types.js

@@ -0,0 +1,4 @@
+export function isOAuthAuth(auth) {
+    return auth?.kind === 'oauth';
+}
+//# sourceMappingURL=auth-types.js.map

package/esm/auth/auth-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-types.js","sourceRoot":"","sources":["../../src/auth/auth-types.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,WAAW,CAAC,IAAyB;IAInD,OAAO,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;AAChC,CAAC"}

package/esm/build-tools.d.ts

@@ -0,0 +1,27 @@
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { Tool } from '@openrouter/agent/tool-types';
+import type { UnconvertibleSchemaMode } from './schema/json-schema-to-zod.js';
+import type { McpToolDef } from './tool-wrapper.js';
+import type { ResourcesOption } from './types.js';
+export interface BuildToolsOptions {
+    client: Client;
+    toolDefs: readonly McpToolDef[];
+    namePrefix?: string;
+    includeTools?: readonly string[];
+    excludeTools?: readonly string[];
+    schemaMode?: UnconvertibleSchemaMode;
+    emitProgress?: boolean;
+    signal?: AbortSignal;
+    resources?: ResourcesOption;
+    /** Whether the server advertised the resources capability. */
+    serverHasResources: boolean;
+}
+/** Apply allow/deny filters to discovered MCP tool definitions. */
+export declare function filterToolDefs(defs: readonly McpToolDef[], includeTools?: readonly string[], excludeTools?: readonly string[]): McpToolDef[];
+/**
+ * Build the full ordered tool list for a handle: filtered + wrapped MCP tools,
+ * plus synthetic resource tools when enabled. Throws on a name collision so two
+ * tools never silently shadow each other in `callModel`.
+ */
+export declare function buildTools(options: BuildToolsOptions): Tool[];
+//# sourceMappingURL=build-tools.d.ts.map

package/esm/build-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-tools.d.ts","sourceRoot":"","sources":["../src/build-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,8DAA8D;IAC9D,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AASD,mEAAmE;AACnE,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,EAChC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAC/B,UAAU,EAAE,CASd;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,EAAE,CAqC7D"}

package/esm/build-tools.js

@@ -0,0 +1,77 @@
+import { MCPError } from './errors.js';
+import { buildResourceTools } from './resource-tools.js';
+import { wrapMcpTool } from './tool-wrapper.js';
+function resourcesEnabled(option) {
+    if (option === undefined) {
+        return true;
+    }
+    return option === true || (typeof option === 'object' && option !== null);
+}
+/** Apply allow/deny filters to discovered MCP tool definitions. */
+export function filterToolDefs(defs, includeTools, excludeTools) {
+    const include = includeTools !== undefined ? new Set(includeTools) : undefined;
+    const exclude = new Set(excludeTools ?? []);
+    return defs.filter((def) => {
+        if (include !== undefined && !include.has(def.name)) {
+            return false;
+        }
+        return !exclude.has(def.name);
+    });
+}
+/**
+ * Build the full ordered tool list for a handle: filtered + wrapped MCP tools,
+ * plus synthetic resource tools when enabled. Throws on a name collision so two
+ * tools never silently shadow each other in `callModel`.
+ */
+export function buildTools(options) {
+    const filtered = filterToolDefs(options.toolDefs, options.includeTools, options.excludeTools);
+    const wrapOptions = {
+        client: options.client,
+        ...(options.namePrefix !== undefined && {
+            namePrefix: options.namePrefix,
+        }),
+        ...(options.schemaMode !== undefined && {
+            schemaMode: options.schemaMode,
+        }),
+        ...(options.emitProgress !== undefined && {
+            emitProgress: options.emitProgress,
+        }),
+        ...(options.signal !== undefined && {
+            signal: options.signal,
+        }),
+    };
+    const tools = filtered.map((def) => wrapMcpTool(def, wrapOptions));
+    if (options.serverHasResources && resourcesEnabled(options.resources)) {
+        tools.push(...buildResourceTools({
+            client: options.client,
+            ...(options.namePrefix !== undefined && {
+                namePrefix: options.namePrefix,
+            }),
+            ...(options.signal !== undefined && {
+                signal: options.signal,
+            }),
+        }));
+    }
+    assertNoDuplicateNames(tools);
+    return tools;
+}
+function toolName(tool) {
+    if ('function' in tool && typeof tool.function.name === 'string') {
+        return tool.function.name;
+    }
+    return undefined;
+}
+function assertNoDuplicateNames(tools) {
+    const seen = new Set();
+    for (const tool of tools) {
+        const name = toolName(tool);
+        if (name === undefined) {
+            continue;
+        }
+        if (seen.has(name)) {
+            throw new MCPError(`Duplicate tool name "${name}". Use toolNamePrefix or excludeTools to disambiguate.`);
+        }
+        seen.add(name);
+    }
+}
+//# sourceMappingURL=build-tools.js.map

package/esm/build-tools.js.map

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

package/esm/cache/cache-store.d.ts

@@ -0,0 +1,24 @@
+import type { SerializedMCPServer } from './cache-types.js';
+/**
+ * Pluggable cache for MCP server snapshots. Implement this to back the cache
+ * with Redis, a database, or the filesystem. All methods may be async.
+ *
+ * SECURITY: when `cacheCredentials` is enabled, stored snapshots contain bearer
+ * tokens/headers — treat the store as a secret store (encrypt at rest, scope
+ * access) and namespace keys by principal in multi-tenant setups.
+ */
+export interface MCPCacheStore {
+    get(key: string): Promise<SerializedMCPServer | null> | SerializedMCPServer | null;
+    set(key: string, value: SerializedMCPServer): Promise<void> | void;
+    delete?(key: string): Promise<void> | void;
+}
+/** Default in-process cache backed by a `Map`. Not shared across processes. */
+export declare class InMemoryMCPCacheStore implements MCPCacheStore {
+    private readonly entries;
+    get(key: string): SerializedMCPServer | null;
+    set(key: string, value: SerializedMCPServer): void;
+    delete(key: string): void;
+}
+/** Default cache key for a server URL. Override via `cache.key` for multi-tenant. */
+export declare function defaultCacheKey(url: string): string;
+//# sourceMappingURL=cache-store.d.ts.map

package/esm/cache/cache-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-store.d.ts","sourceRoot":"","sources":["../../src/cache/cache-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,mBAAmB,GAAG,IAAI,CAAC;IACnF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACnE,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC5C;AAED,+EAA+E;AAC/E,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAElE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAI5C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAIlD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAG1B;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/esm/cache/cache-store.js

@@ -0,0 +1,20 @@
+/** Default in-process cache backed by a `Map`. Not shared across processes. */
+export class InMemoryMCPCacheStore {
+    constructor() {
+        this.entries = new Map();
+    }
+    get(key) {
+        return this.entries.get(key) ?? null;
+    }
+    set(key, value) {
+        this.entries.set(key, value);
+    }
+    delete(key) {
+        this.entries.delete(key);
+    }
+}
+/** Default cache key for a server URL. Override via `cache.key` for multi-tenant. */
+export function defaultCacheKey(url) {
+    return `openrouter-mcp:${url}`;
+}
+//# sourceMappingURL=cache-store.js.map

package/esm/cache/cache-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-store.js","sourceRoot":"","sources":["../../src/cache/cache-store.ts"],"names":[],"mappings":"AAgBA,+EAA+E;AAC/E,MAAM,OAAO,qBAAqB;IAAlC;QACmB,YAAO,GAAG,IAAI,GAAG,EAA+B,CAAC;IAapE,CAAC;IAXC,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAA0B;QACzC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;CACF;AAED,qFAAqF;AACrF,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,kBAAkB,GAAG,EAAE,CAAC;AACjC,CAAC"}

package/esm/cache/cache-types.d.ts

@@ -0,0 +1,54 @@
+import type { MCPTransportKind } from '../transport-types.js';
+/** A discovered tool definition as stored in a cache snapshot. */
+export interface SerializedMCPToolDef {
+    name: string;
+    description?: string;
+    inputSchema: Readonly<Record<string, unknown>>;
+    outputSchema?: Readonly<Record<string, unknown>>;
+}
+/** OAuth/bearer token material, persisted only when `cacheCredentials` is on. */
+export interface SerializedTokenSet {
+    accessToken: string;
+    tokenType?: string;
+    refreshToken?: string;
+    /** Epoch ms; absence means unknown/no declared expiry. */
+    expiresAt?: number;
+    scope?: string;
+}
+/**
+ * Serializable snapshot of a connected MCP server: enough to rebuild the tool
+ * set (and, opt-in, reconnect with cached credentials) without re-listing or
+ * re-authenticating.
+ */
+export interface SerializedMCPServer {
+    version: 1;
+    url: string;
+    transport: MCPTransportKind;
+    serverInfo?: {
+        name?: string;
+        version?: string;
+    };
+    capabilities?: Readonly<Record<string, unknown>>;
+    sessionId?: string;
+    tools: SerializedMCPToolDef[];
+    auth?: {
+        headers?: Readonly<Record<string, string>>;
+        tokens?: SerializedTokenSet;
+    };
+    cachedAt: number;
+}
+/**
+ * The shared "valid `cachedAt`" rule: a finite, non-negative epoch (ms).
+ * Consumed by both the read-side snapshot validator and the write-side
+ * serializer so the two can't drift. Rejecting negatives keeps the invariant
+ * honest at the boundary rather than relying on downstream maxAge arithmetic to
+ * fail-safe on a clock-skewed or garbage value.
+ */
+export declare function isFiniteEpoch(value: unknown): value is number;
+/**
+ * Validate an untrusted value as a {@link SerializedMCPServer}. Cache stores may
+ * be backed by a DB or another org member's data, so snapshots are checked
+ * structurally before use — never trusted by shape alone.
+ */
+export declare function isSerializedMCPServer(value: unknown): value is SerializedMCPServer;
+//# sourceMappingURL=cache-types.d.ts.map

package/esm/cache/cache-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-types.d.ts","sourceRoot":"","sources":["../../src/cache/cache-types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,kEAAkE;AAClE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAED,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,EAAE,kBAAkB,CAAC;KAC7B,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE7D;AAUD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAelF"}

package/esm/cache/cache-types.js

@@ -0,0 +1,41 @@
+import { isJsonSchemaObject } from '../schema/json-schema-guards.js';
+function isTransportKind(value) {
+    return value === 'streamableHttp' || value === 'sse';
+}
+/**
+ * The shared "valid `cachedAt`" rule: a finite, non-negative epoch (ms).
+ * Consumed by both the read-side snapshot validator and the write-side
+ * serializer so the two can't drift. Rejecting negatives keeps the invariant
+ * honest at the boundary rather than relying on downstream maxAge arithmetic to
+ * fail-safe on a clock-skewed or garbage value.
+ */
+export function isFiniteEpoch(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0;
+}
+function isSerializedToolDef(value) {
+    return (isJsonSchemaObject(value) &&
+        typeof value['name'] === 'string' &&
+        isJsonSchemaObject(value['inputSchema']));
+}
+/**
+ * Validate an untrusted value as a {@link SerializedMCPServer}. Cache stores may
+ * be backed by a DB or another org member's data, so snapshots are checked
+ * structurally before use — never trusted by shape alone.
+ */
+export function isSerializedMCPServer(value) {
+    if (!isJsonSchemaObject(value)) {
+        return false;
+    }
+    if (value['version'] !== 1) {
+        return false;
+    }
+    if (typeof value['url'] !== 'string' || !isTransportKind(value['transport'])) {
+        return false;
+    }
+    if (!isFiniteEpoch(value['cachedAt'])) {
+        return false;
+    }
+    const { tools } = value;
+    return Array.isArray(tools) && tools.every(isSerializedToolDef);
+}
+//# sourceMappingURL=cache-types.js.map

package/esm/cache/cache-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-types.js","sourceRoot":"","sources":["../../src/cache/cache-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AA4CrE,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,KAAK,KAAK,gBAAgB,IAAI,KAAK,KAAK,KAAK,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,CACL,kBAAkB,CAAC,KAAK,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ;QACjC,kBAAkB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CACzC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QAC7E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACxB,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;AAClE,CAAC"}

package/esm/cache/serialize.d.ts

@@ -0,0 +1,25 @@
+import type { MCPAuth } from '../auth/auth-types.js';
+import type { McpToolDef } from '../tool-wrapper.js';
+import type { MCPTransportKind } from '../types.js';
+import type { SerializedMCPServer } from './cache-types.js';
+export interface SerializeInput {
+    url: string;
+    transport: MCPTransportKind;
+    toolDefs: readonly McpToolDef[];
+    serverInfo?: {
+        name?: string;
+        version?: string;
+    };
+    capabilities?: Readonly<Record<string, unknown>>;
+    sessionId?: string;
+    auth?: MCPAuth;
+    cacheCredentials: boolean;
+    cachedAt: number;
+}
+/**
+ * Build a serializable snapshot. Credentials (tokens/headers, session id) are
+ * included only when `cacheCredentials` is true; otherwise the snapshot holds
+ * just the structural data needed to rebuild the tool set after a fresh auth.
+ */
+export declare function serializeServer(input: SerializeInput): Promise<SerializedMCPServer>;
+//# sourceMappingURL=serialize.d.ts.map

package/esm/cache/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/cache/serialize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAsB,MAAM,kBAAkB,CAAC;AAGhF,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAgDD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqCzF"}

package/esm/cache/serialize.js

@@ -0,0 +1,85 @@
+import { resolveAuth } from '../auth/auth-resolver.js';
+import { isFiniteEpoch } from './cache-types.js';
+/** Pull a serializable token set from an OAuth provider, if it has tokens. */
+async function tokensFromProvider(provider) {
+    const tokens = await provider.tokens();
+    if (tokens === undefined) {
+        return undefined;
+    }
+    const expiresInMs = typeof tokens.expires_in === 'number' ? tokens.expires_in * 1000 : undefined;
+    return {
+        accessToken: tokens.access_token,
+        ...(typeof tokens.token_type === 'string' && {
+            tokenType: tokens.token_type,
+        }),
+        ...(typeof tokens.refresh_token === 'string' && {
+            refreshToken: tokens.refresh_token,
+        }),
+        ...(typeof tokens.scope === 'string' && {
+            scope: tokens.scope,
+        }),
+        ...(expiresInMs !== undefined && {
+            expiresAt: Date.now() + expiresInMs,
+        }),
+    };
+}
+async function buildAuthBlock(auth) {
+    if (auth === undefined) {
+        return undefined;
+    }
+    if (auth.kind === 'oauth') {
+        const tokens = await tokensFromProvider(auth.provider);
+        return tokens !== undefined
+            ? {
+                tokens,
+            }
+            : undefined;
+    }
+    const { headers } = resolveAuth(auth);
+    return Object.keys(headers).length > 0
+        ? {
+            headers,
+        }
+        : undefined;
+}
+/**
+ * Build a serializable snapshot. Credentials (tokens/headers, session id) are
+ * included only when `cacheCredentials` is true; otherwise the snapshot holds
+ * just the structural data needed to rebuild the tool set after a fresh auth.
+ */
+export async function serializeServer(input) {
+    const tools = input.toolDefs.map((def) => ({
+        name: def.name,
+        ...(def.description !== undefined && {
+            description: def.description,
+        }),
+        inputSchema: def.inputSchema,
+        ...(def.outputSchema !== undefined && {
+            outputSchema: def.outputSchema,
+        }),
+    }));
+    const snapshot = {
+        version: 1,
+        url: input.url,
+        transport: input.transport,
+        ...(input.serverInfo !== undefined && {
+            serverInfo: input.serverInfo,
+        }),
+        ...(input.capabilities !== undefined && {
+            capabilities: input.capabilities,
+        }),
+        tools,
+        cachedAt: isFiniteEpoch(input.cachedAt) ? input.cachedAt : Date.now(),
+    };
+    if (input.cacheCredentials) {
+        const auth = await buildAuthBlock(input.auth);
+        if (auth !== undefined) {
+            snapshot.auth = auth;
+        }
+        if (input.sessionId !== undefined) {
+            snapshot.sessionId = input.sessionId;
+        }
+    }
+    return snapshot;
+}
+//# sourceMappingURL=serialize.js.map

package/esm/cache/serialize.js.map

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

package/esm/create-mcp-tools.d.ts

@@ -0,0 +1,13 @@
+import type { SerializedMCPServer } from './cache/cache-types.js';
+import type { CreateMCPToolsOptions, MCPToolsHandle } from './types.js';
+/**
+ * Connect to a remote MCP server, discover its tools, and return a handle whose
+ * `.tools` can be passed straight into `callModel({ tools })`. Auth is supplied
+ * once and reused for discovery and every subsequent tool call.
+ *
+ * When `cache` is provided, a valid non-stale snapshot is rehydrated instead of
+ * re-listing; otherwise the fresh result is written back to the cache.
+ */
+export declare function createMCPTools(options: CreateMCPToolsOptions): Promise<MCPToolsHandle>;
+export type { SerializedMCPServer };
+//# sourceMappingURL=create-mcp-tools.d.ts.map

package/esm/create-mcp-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mcp-tools.d.ts","sourceRoot":"","sources":["../src/create-mcp-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAKlE,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAExE;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAY5F;AA8DD,YAAY,EAAE,mBAAmB,EAAE,CAAC"}