@openrouter/mcp 0.0.1

package/esm/create-mcp-tools.js

@@ -0,0 +1,75 @@
+import { defaultCacheKey } from './cache/cache-store.js';
+import { isSerializedMCPServer } from './cache/cache-types.js';
+import { freshConnect, normalizeUrl } from './handle.js';
+import { rehydrateMCPTools } from './rehydrate.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 async function createMCPTools(options) {
+    const url = normalizeUrl(options.url);
+    const cacheKey = options.cache?.key ?? defaultCacheKey(url.href);
+    if (options.cache !== undefined) {
+        const hit = await tryCacheHit(options, options.cache.store, cacheKey);
+        if (hit !== undefined) {
+            return hit;
+        }
+    }
+    return freshConnect(options, url, cacheKey);
+}
+// Option keys forwarded verbatim from a cache-hit `createMCPTools` call into
+// `rehydrateMCPTools`, so a warm handle applies the same auth, filters, prefix,
+// and credential-caching behavior as a cold one.
+const FORWARDED_REHYDRATE_KEYS = [
+    'auth',
+    'fetch',
+    'clientInfo',
+    'onUnconvertibleSchema',
+    'onElicitation',
+    'signal',
+    'toolNamePrefix',
+    'includeTools',
+    'excludeTools',
+    'resources',
+    'emitProgress',
+    'autoRefreshOnListChanged',
+    'cacheCredentials',
+];
+/** Copy the defined forwarded options from `createMCPTools` into a rehydrate base. */
+function forwardedRehydrateOptions(options) {
+    const out = {};
+    for (const key of FORWARDED_REHYDRATE_KEYS) {
+        const value = options[key];
+        if (value !== undefined) {
+            Object.assign(out, {
+                [key]: value,
+            });
+        }
+    }
+    return out;
+}
+async function tryCacheHit(options, store, cacheKey) {
+    const snapshot = await store.get(cacheKey);
+    if (snapshot === null || snapshot === undefined || !isSerializedMCPServer(snapshot)) {
+        return undefined;
+    }
+    const maxAge = options.staleness?.maxAgeMs;
+    if (maxAge !== undefined && Date.now() - snapshot.cachedAt > maxAge) {
+        return undefined;
+    }
+    // Defer to rehydrate, which reconnects and falls back to a fresh connect on
+    // expiry.
+    return rehydrateMCPTools({
+        snapshot,
+        ...forwardedRehydrateOptions(options),
+        cache: {
+            store,
+            key: cacheKey,
+        },
+    });
+}
+//# sourceMappingURL=create-mcp-tools.js.map

package/esm/create-mcp-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mcp-tools.js","sourceRoot":"","sources":["../src/create-mcp-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA8B;IACjE,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEjE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtE,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,6EAA6E;AAC7E,gFAAgF;AAChF,iDAAiD;AACjD,MAAM,wBAAwB,GAAG;IAC/B,MAAM;IACN,OAAO;IACP,YAAY;IACZ,uBAAuB;IACvB,eAAe;IACf,QAAQ;IACR,gBAAgB;IAChB,cAAc;IACd,cAAc;IACd,WAAW;IACX,cAAc;IACd,0BAA0B;IAC1B,kBAAkB;CAC0E,CAAC;AAE/F,sFAAsF;AACtF,SAAS,yBAAyB,CAChC,OAA8B;IAE9B,MAAM,GAAG,GAAsC,EAAE,CAAC;IAClD,KAAK,MAAM,GAAG,IAAI,wBAAwB,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;gBACjB,CAAC,GAAG,CAAC,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,OAA8B,EAC9B,KAAoB,EACpB,QAAgB;IAEhB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC3C,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,QAAQ,GAAG,MAAM,EAAE,CAAC;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,4EAA4E;IAC5E,UAAU;IACV,OAAO,iBAAiB,CAAC;QACvB,QAAQ;QACR,GAAG,yBAAyB,CAAC,OAAO,CAAC;QACrC,KAAK,EAAE;YACL,KAAK;YACL,GAAG,EAAE,QAAQ;SACd;KACF,CAAC,CAAC;AACL,CAAC"}

package/esm/elicitation.d.ts

@@ -0,0 +1,11 @@
+import type { ElicitRequest, ElicitResult } from '@modelcontextprotocol/sdk/types.js';
+import type { ElicitationHandler } from './types.js';
+/**
+ * Build the `elicitation/create` request handler registered on the MCP client.
+ * Delegates to the caller's {@link ElicitationHandler}; when none is supplied,
+ * auto-declines so a tool call awaiting input fails gracefully instead of
+ * hanging. The MCP spec forbids eliciting sensitive/PII data — that contract is
+ * the server's responsibility; callers should treat requested fields as such.
+ */
+export declare function makeElicitationRequestHandler(handler: ElicitationHandler | undefined): (request: ElicitRequest) => Promise<ElicitResult>;
+//# sourceMappingURL=elicitation.d.ts.map

package/esm/elicitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../src/elicitation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEtF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA4BrD;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,kBAAkB,GAAG,SAAS,GACtC,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CA2BnD"}

package/esm/elicitation.js

@@ -0,0 +1,51 @@
+import { isJsonSchemaObject } from './schema/json-schema-guards.js';
+/** A form-mode elicitation request carries a `requestedSchema`. */
+function hasRequestedSchema(params) {
+    return 'requestedSchema' in params;
+}
+/** Narrow handler-returned content to the primitive record the spec allows. */
+function toElicitContent(content) {
+    const out = {};
+    for (const [key, value] of Object.entries(content)) {
+        if (typeof value === 'string' ||
+            typeof value === 'number' ||
+            typeof value === 'boolean' ||
+            (Array.isArray(value) && value.every((v) => typeof v === 'string'))) {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+/**
+ * Build the `elicitation/create` request handler registered on the MCP client.
+ * Delegates to the caller's {@link ElicitationHandler}; when none is supplied,
+ * auto-declines so a tool call awaiting input fails gracefully instead of
+ * hanging. The MCP spec forbids eliciting sensitive/PII data — that contract is
+ * the server's responsibility; callers should treat requested fields as such.
+ */
+export function makeElicitationRequestHandler(handler) {
+    return async (request) => {
+        if (handler === undefined) {
+            return {
+                action: 'decline',
+            };
+        }
+        const { params } = request;
+        const requestedSchema = hasRequestedSchema(params) ? params.requestedSchema : undefined;
+        const schema = isJsonSchemaObject(requestedSchema) ? requestedSchema : {};
+        const response = await handler({
+            message: params.message,
+            requestedSchema: schema,
+        });
+        if (response.action === 'accept') {
+            return {
+                action: 'accept',
+                content: toElicitContent(response.content),
+            };
+        }
+        return {
+            action: response.action,
+        };
+    };
+}
+//# sourceMappingURL=elicitation.js.map

package/esm/elicitation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.js","sourceRoot":"","sources":["../src/elicitation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAMpE,mEAAmE;AACnE,SAAS,kBAAkB,CAAC,MAA+B;IAGzD,OAAO,iBAAiB,IAAI,MAAM,CAAC;AACrC,CAAC;AAED,+EAA+E;AAC/E,SAAS,eAAe,CAAC,OAAgC;IACvD,MAAM,GAAG,GAAuC,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAO,KAAK,KAAK,SAAS;YAC1B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,EAChF,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAAuC;IAEvC,OAAO,KAAK,EAAE,OAAsB,EAAyB,EAAE;QAC7D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO;gBACL,MAAM,EAAE,SAAS;aAClB,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAC3B,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;QACxF,MAAM,MAAM,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;QAE1E,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,eAAe,EAAE,MAAM;SACxB,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC;aAC3C,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM;SACxB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/esm/errors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Base error for all @openrouter/mcp failures.
+ */
+export declare class MCPError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Raised when an MCP tool call returns `isError: true` or when the result
+ * cannot be mapped to a usable model output.
+ */
+export declare class MCPToolCallError extends MCPError {
+    readonly toolName: string;
+    constructor(toolName: string, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Raised when a cached snapshot cannot be validated or rehydrated.
+ */
+export declare class MCPCacheError extends MCPError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Raised when connecting to the MCP server fails across all attempted transports.
+ */
+export declare class MCPConnectionError extends MCPError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/esm/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;gBAE/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAKJ;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAGxB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAMJ;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;gBAEvC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAKJ;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;gBAE5C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAKJ"}

package/esm/errors.js

@@ -0,0 +1,39 @@
+/**
+ * Base error for all @openrouter/mcp failures.
+ */
+export class MCPError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'MCPError';
+    }
+}
+/**
+ * Raised when an MCP tool call returns `isError: true` or when the result
+ * cannot be mapped to a usable model output.
+ */
+export class MCPToolCallError extends MCPError {
+    constructor(toolName, message, options) {
+        super(message, options);
+        this.name = 'MCPToolCallError';
+        this.toolName = toolName;
+    }
+}
+/**
+ * Raised when a cached snapshot cannot be validated or rehydrated.
+ */
+export class MCPCacheError extends MCPError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'MCPCacheError';
+    }
+}
+/**
+ * Raised when connecting to the MCP server fails across all attempted transports.
+ */
+export class MCPConnectionError extends MCPError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'MCPConnectionError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YACE,OAAe,EACf,OAEC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IAG5C,YACE,QAAgB,EAChB,OAAe,EACf,OAEC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC,YACE,OAAe,EACf,OAEC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YACE,OAAe,EACf,OAEC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/esm/handle.d.ts

@@ -0,0 +1,41 @@
+import type { MCPConnection } from './mcp-connection.js';
+import type { McpToolDef } from './tool-wrapper.js';
+import type { MCPTransportKind } from './transport-types.js';
+import type { CreateMCPToolsOptions, MCPToolsHandle } from './types.js';
+export declare function normalizeUrl(url: string | URL): URL;
+/**
+ * Read the discovered tools off the live connection into our internal shape.
+ *
+ * `tools/list` is paginated: each response may carry a `nextCursor` that must be
+ * passed back as `{ cursor }` to fetch the next page. We accumulate every page so
+ * servers that paginate their tool list aren't silently truncated.
+ */
+export declare function listToolDefs(connection: MCPConnection, signal: AbortSignal | undefined): Promise<McpToolDef[]>;
+interface HandleContext {
+    url: URL;
+    transport: MCPTransportKind;
+    cacheKey: string;
+}
+export interface MakeHandleArgs {
+    connection: MCPConnection;
+    options: CreateMCPToolsOptions;
+    context: HandleContext;
+    initialToolDefs: McpToolDef[];
+}
+/**
+ * Connect, discover tools via `listTools()`, and build a handle WITHOUT
+ * consulting the cache for a hit. The cache (when present on `options`) is still
+ * written through `makeHandle`, so refreshes persist. This is the cold cache-miss
+ * path, and is also called directly by `rehydrateMCPTools`'s fallback: routing
+ * the fallback here instead of back through `createMCPTools` is what prevents the
+ * cache-fallback loop — re-reading the same snapshot would re-enter rehydrate and
+ * recurse without bound.
+ */
+export declare function freshConnect(options: CreateMCPToolsOptions, url: URL, cacheKey: string): Promise<MCPToolsHandle>;
+/**
+ * Construct an {@link MCPToolsHandle} around a live connection, wiring refresh,
+ * serialize, list_changed listeners, and cache writes.
+ */
+export declare function makeHandle(args: MakeHandleArgs): Promise<MCPToolsHandle>;
+export {};
+//# sourceMappingURL=handle.d.ts.map

package/esm/handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../src/handle.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAExE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,CAEnD;AAcD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,aAAa,EACzB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,UAAU,EAAE,CAAC,CAsCvB;AAOD,UAAU,aAAa;IACrB,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,aAAa,CAAC;IAC1B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,EAAE,UAAU,EAAE,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,qBAAqB,EAC9B,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAsCzB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAmE9E"}

package/esm/handle.js

@@ -0,0 +1,221 @@
+import { buildTools } from './build-tools.js';
+import { serializeServer } from './cache/serialize.js';
+import { connect } from './mcp-connection.js';
+export function normalizeUrl(url) {
+    return url instanceof URL ? url : new URL(url);
+}
+// Hard cap on pagination pages. A well-behaved server terminates the cursor
+// chain by omitting `nextCursor`; this bounds a misbehaving one that never does.
+const MAX_LIST_PAGES = 1000;
+/**
+ * Normalize a paginated `nextCursor` field: treat anything that is not a
+ * non-empty string as "no more pages" so a malformed cursor terminates the loop.
+ */
+function nextCursorOrUndefined(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+/**
+ * Read the discovered tools off the live connection into our internal shape.
+ *
+ * `tools/list` is paginated: each response may carry a `nextCursor` that must be
+ * passed back as `{ cursor }` to fetch the next page. We accumulate every page so
+ * servers that paginate their tool list aren't silently truncated.
+ */
+export async function listToolDefs(connection, signal) {
+    const requestOptions = signal !== undefined
+        ? {
+            signal,
+        }
+        : undefined;
+    const collected = [];
+    let cursor;
+    for (let page = 0; page < MAX_LIST_PAGES; page += 1) {
+        const params = cursor !== undefined
+            ? {
+                cursor,
+            }
+            : undefined;
+        const { tools, nextCursor } = await connection.client.listTools(params, requestOptions);
+        for (const t of tools) {
+            collected.push({
+                name: t.name,
+                ...(t.description !== undefined && {
+                    description: t.description,
+                }),
+                inputSchema: t.inputSchema,
+                ...(t.outputSchema !== undefined && {
+                    outputSchema: t.outputSchema,
+                }),
+            });
+        }
+        const next = nextCursorOrUndefined(nextCursor);
+        // Stop at the end of the chain, or if the server echoes the same cursor
+        // (which would otherwise spin forever).
+        if (next === undefined || next === cursor) {
+            break;
+        }
+        cursor = next;
+    }
+    return collected;
+}
+function serverHasResources(connection) {
+    const caps = connection.client.getServerCapabilities();
+    return caps?.resources !== undefined;
+}
+/**
+ * Connect, discover tools via `listTools()`, and build a handle WITHOUT
+ * consulting the cache for a hit. The cache (when present on `options`) is still
+ * written through `makeHandle`, so refreshes persist. This is the cold cache-miss
+ * path, and is also called directly by `rehydrateMCPTools`'s fallback: routing
+ * the fallback here instead of back through `createMCPTools` is what prevents the
+ * cache-fallback loop — re-reading the same snapshot would re-enter rehydrate and
+ * recurse without bound.
+ */
+export async function freshConnect(options, url, cacheKey) {
+    const connection = await connect({
+        url,
+        ...(options.transport !== undefined && {
+            transport: options.transport,
+        }),
+        ...(options.auth !== undefined && {
+            auth: options.auth,
+        }),
+        ...(options.fetch !== undefined && {
+            fetch: options.fetch,
+        }),
+        ...(options.clientInfo !== undefined && {
+            clientInfo: options.clientInfo,
+        }),
+        ...(options.onElicitation !== undefined && {
+            onElicitation: options.onElicitation,
+        }),
+    });
+    // Tear the connection down if discovery or the initial cache write throws —
+    // otherwise the open transport (HTTP keep-alive / SSE stream) leaks.
+    try {
+        const initialToolDefs = await listToolDefs(connection, options.signal);
+        return await makeHandle({
+            connection,
+            options,
+            context: {
+                url,
+                transport: connection.transport,
+                cacheKey,
+            },
+            initialToolDefs,
+        });
+    }
+    catch (err) {
+        await connection.close().catch(() => { });
+        throw err;
+    }
+}
+/**
+ * Construct an {@link MCPToolsHandle} around a live connection, wiring refresh,
+ * serialize, list_changed listeners, and cache writes.
+ */
+export async function makeHandle(args) {
+    const { connection, options, context, initialToolDefs } = args;
+    const listeners = new Set();
+    let toolDefs = initialToolDefs;
+    const serverInfo = connection.client.getServerVersion();
+    const rebuild = () => buildTools(buildToolsArgs(connection, toolDefs, options));
+    let tools = rebuild();
+    const snapshot = () => serializeServer(serializeArgs({
+        connection,
+        context,
+        toolDefs,
+        serverInfo,
+        options,
+    }));
+    const writeCache = async () => {
+        const store = options.cache?.store;
+        if (store === undefined) {
+            return;
+        }
+        await store.set(context.cacheKey, await snapshot());
+    };
+    const refresh = async () => {
+        toolDefs = await listToolDefs(connection, options.signal);
+        tools = rebuild();
+        await writeCache();
+        return tools;
+    };
+    if (options.autoRefreshOnListChanged ?? true) {
+        connection.setToolListChangedHandler(() => {
+            // Fire-and-forget, but never let a failed refresh escape as an unhandled
+            // rejection. On failure listeners keep the last good tool set.
+            void refresh()
+                .then((next) => {
+                for (const listener of listeners) {
+                    listener(next);
+                }
+            })
+                .catch(() => { });
+        });
+    }
+    await writeCache();
+    return {
+        get tools() {
+            return tools;
+        },
+        ...(serverInfo !== undefined && {
+            serverInfo,
+        }),
+        serialize: snapshot,
+        refresh,
+        onToolsChanged: (listener) => {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        close: () => connection.close(),
+    };
+}
+/** Assemble the {@link buildTools} arguments, threading only the defined options. */
+function buildToolsArgs(connection, toolDefs, options) {
+    return {
+        client: connection.client,
+        toolDefs,
+        emitProgress: options.emitProgress ?? true,
+        serverHasResources: serverHasResources(connection),
+        ...(options.toolNamePrefix !== undefined && {
+            namePrefix: options.toolNamePrefix,
+        }),
+        ...(options.includeTools !== undefined && {
+            includeTools: options.includeTools,
+        }),
+        ...(options.excludeTools !== undefined && {
+            excludeTools: options.excludeTools,
+        }),
+        ...(options.onUnconvertibleSchema !== undefined && {
+            schemaMode: options.onUnconvertibleSchema,
+        }),
+        ...(options.signal !== undefined && {
+            signal: options.signal,
+        }),
+        ...(options.resources !== undefined && {
+            resources: options.resources,
+        }),
+    };
+}
+/** Assemble the {@link serializeServer} input, threading only the defined fields. */
+function serializeArgs(args) {
+    const { connection, context, toolDefs, serverInfo, options } = args;
+    return {
+        url: context.url.href,
+        transport: connection.transport,
+        toolDefs,
+        cacheCredentials: options.cacheCredentials ?? false,
+        cachedAt: Date.now(),
+        ...(serverInfo !== undefined && {
+            serverInfo,
+        }),
+        ...(connection.sessionId !== undefined && {
+            sessionId: connection.sessionId,
+        }),
+        ...(options.auth !== undefined && {
+            auth: options.auth,
+        }),
+    };
+}
+//# sourceMappingURL=handle.js.map

package/esm/handle.js.map

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

package/esm/index.d.ts

@@ -0,0 +1,13 @@
+export type { MCPAuth } from './auth/auth-types.js';
+export type { MCPCacheStore } from './cache/cache-store.js';
+export { defaultCacheKey, InMemoryMCPCacheStore } from './cache/cache-store.js';
+export type { SerializedMCPServer, SerializedMCPToolDef, SerializedTokenSet, } from './cache/cache-types.js';
+export { isSerializedMCPServer } from './cache/cache-types.js';
+export { createMCPTools } from './create-mcp-tools.js';
+export { MCPCacheError, MCPConnectionError, MCPError, MCPToolCallError, } from './errors.js';
+export type { RehydrateMCPToolsOptions } from './rehydrate.js';
+export { rehydrateMCPTools } from './rehydrate.js';
+export type { UnconvertibleSchemaMode } from './schema/json-schema-to-zod.js';
+export { convertMcpInputSchema } from './schema/json-schema-to-zod.js';
+export type { CreateMCPToolsOptions, ElicitationHandler, ElicitationResponse, MCPToolsHandle, MCPTransportKind, ResourcesOption, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAChF,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACR,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/esm/index.js

@@ -0,0 +1,11 @@
+// Main factory + rehydration
+// Cache
+export { defaultCacheKey, InMemoryMCPCacheStore } from './cache/cache-store.js';
+export { isSerializedMCPServer } from './cache/cache-types.js';
+export { createMCPTools } from './create-mcp-tools.js';
+// Errors
+export { MCPCacheError, MCPConnectionError, MCPError, MCPToolCallError, } from './errors.js';
+export { rehydrateMCPTools } from './rehydrate.js';
+// Schema conversion (exported for testing/reuse)
+export { convertMcpInputSchema } from './schema/json-schema-to-zod.js';
+//# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAK7B,QAAQ;AACR,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAMhF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,SAAS;AACT,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACR,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,iDAAiD;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC"}

package/esm/mcp-connection.d.ts

@@ -0,0 +1,35 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { MCPAuth } from './auth/auth-types.js';
+import type { ElicitationHandler, MCPTransportKind } from './types.js';
+export interface ConnectOptions {
+    url: URL;
+    transport?: MCPTransportKind;
+    auth?: MCPAuth;
+    fetch?: typeof fetch;
+    clientInfo?: {
+        name: string;
+        version: string;
+    };
+    sessionId?: string;
+    onElicitation?: ElicitationHandler;
+}
+export interface MCPConnection {
+    client: Client;
+    transport: MCPTransportKind;
+    sessionId?: string;
+    /**
+     * Register a callback for `tools/list_changed`. Settable after connect so the
+     * handle can wire it to its own `refresh()`. Replaces any prior handler.
+     */
+    setToolListChangedHandler(handler: () => void): void;
+    close(): Promise<void>;
+}
+/**
+ * Connect a `Client` to the MCP server. Defaults to Streamable HTTP and falls
+ * back to SSE on connection failure (legacy servers), unless a transport is
+ * pinned explicitly. Auth, the elicitation handler, and the list_changed
+ * subscription are wired into the single connected client so they apply to
+ * discovery and every tool call.
+ */
+export declare function connect(options: ConnectOptions): Promise<MCPConnection>;
+//# sourceMappingURL=mcp-connection.d.ts.map

package/esm/mcp-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-connection.d.ts","sourceRoot":"","sources":["../src/mcp-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAWnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAOvE,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,gBAAgB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,yBAAyB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACrD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAmFD;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAkD7E"}