@openrouter/mcp 1.0.0 → 1.1.1

package/esm/handle.js

@@ -1,323 +0,0 @@
-import { buildTools } from './build-tools.js';
-import { serializeServer } from './cache/serialize.js';
-import { closeQuietly } from './close-quietly.js';
-import { MCPCacheWriteError } from './errors.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;
-}
-/**
- * Parse a server-advertised doom-loop identity from a tool definition's
- * `_meta['openrouter/loopKey']`: a field-name array (the declarative subset
- * of arguments identifying a call) or `false` (tool exempt). Data-only by
- * design — functions can't cross the wire; any other shape is ignored.
- */
-function advertisedLoopKey(meta) {
-    const advertised = meta?.['openrouter/loopKey'];
-    if (advertised === false) {
-        return false;
-    }
-    if (Array.isArray(advertised) && advertised.every((f) => typeof f === 'string')) {
-        return advertised;
-    }
-    return 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.
- *
- * Always `cacheMode: 'refresh'`. SDK v2 keeps a per-client response cache
- * honouring the server's `ttlMs` on `tools/list` (up to 24h), so the default
- * `'use'` would serve a still-fresh cached list without a round trip. That is
- * fine for an opportunistic read but wrong for every caller here: `refresh()`
- * documents a forced re-read, `freshConnect` is establishing the tool set for the
- * first time, and the stale-replay path exists precisely because the age of the
- * cached list is no longer acceptable. `'refresh'` fetches and re-stores, so the
- * cache stays warm for the SDK's own readers.
- *
- * `'refresh'` rather than `'bypass'` deliberately — bypass would skip the write
- * too, leaving a stale entry behind for anything that later reads with `'use'`.
- */
-export async function listToolDefs(connection, signal) {
-    const requestOptions = {
-        cacheMode: 'refresh',
-        ...(signal !== undefined && {
-            signal,
-        }),
-    };
-    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) {
-            const loopKey = advertisedLoopKey(t._meta);
-            collected.push({
-                name: t.name,
-                ...(t.description !== undefined && {
-                    description: t.description,
-                }),
-                inputSchema: t.inputSchema,
-                ...(t.outputSchema !== undefined && {
-                    outputSchema: t.outputSchema,
-                }),
-                ...(loopKey !== undefined && {
-                    loopKey,
-                }),
-            });
-        }
-        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,
-        }),
-        ...(options.protocolNegotiation !== undefined && {
-            protocolNegotiation: options.protocolNegotiation,
-        }),
-        ...(options.probeTimeoutMs !== undefined && {
-            probeTimeoutMs: options.probeTimeoutMs,
-        }),
-        ...(options.signal !== undefined && {
-            signal: options.signal,
-        }),
-    });
-    // 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 closeQuietly(connection);
-        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;
-    // Cleared by refresh(): once we have re-listed, age is measured from now.
-    let replayedCachedAt = args.replayedCachedAt;
-    const serverInfo = connection.client.getServerVersion();
-    const rebuild = () => buildTools(buildToolsArgs(connection, toolDefs, options));
-    let tools = rebuild();
-    const snapshot = () => serializeServer(serializeArgs({
-        connection,
-        context,
-        toolDefs,
-        serverInfo,
-        options,
-        ...(replayedCachedAt !== undefined && {
-            cachedAt: replayedCachedAt,
-        }),
-    }));
-    const writeCache = async () => {
-        const store = options.cache?.store;
-        if (store === undefined) {
-            return;
-        }
-        // Built OUTSIDE the try: `snapshot()` can reject from the caller's own
-        // OAuth provider (`provider.tokens()`), and relabelling that as a cache
-        // write failure would send it down every "store outages are harmless"
-        // path — swallowed by the list_changed handler, ignored by
-        // `refreshStaleReplay`, and dismissed by callers following the documented
-        // `MCPCacheWriteError` pattern. Only the store op earns the tag.
-        const payload = await snapshot();
-        try {
-            await store.set(context.cacheKey, payload);
-        }
-        catch (writeErr) {
-            // Tagged so callers can tell a store outage from a failed read. The two
-            // look identical coming out of `refresh()` but mean opposite things: a
-            // failed read leaves the tool set unknown, while a failed write leaves a
-            // live connection with current tools and only a stale cache entry.
-            throw new MCPCacheWriteError('Failed to write the MCP snapshot to the cache store', {
-                cause: writeErr,
-            });
-        }
-    };
-    // INVARIANT internal callers rely on: `refresh()` swaps `tools` to a fresh
-    // array (rebuild() always allocates) exactly when the re-list succeeded, and
-    // it does so BEFORE attempting to persist. A caller that captured the old
-    // reference can therefore tell "the re-list failed" (reference unchanged)
-    // from "only something after the re-list failed" (reference changed) without
-    // inspecting the error — which no error-class check can do reliably, since
-    // persistence can fail outside the store op too (the caller's own OAuth
-    // provider rejecting inside `snapshot()`).
-    const refresh = async () => {
-        toolDefs = await listToolDefs(connection, options.signal);
-        // Re-listed, so the snapshot is genuinely current from here on.
-        replayedCachedAt = undefined;
-        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. Whether to announce is keyed on ADOPTION (the reference
-            // swap above), not on error class: once `refresh()` has swapped `tools`,
-            // skipping the announcement would leave subscribers permanently out of
-            // sync with `handle.tools`, no matter what broke afterwards — a store
-            // outage and an OAuth provider failing during serialize gate it equally
-            // little. On a failed re-list the reference is untouched and subscribers
-            // correctly keep the last good set.
-            const before = tools;
-            void refresh()
-                .catch(() => undefined)
-                .then(() => {
-                if (tools === before) {
-                    return;
-                }
-                for (const listener of listeners) {
-                    listener(tools);
-                }
-            })
-                .catch(() => { });
-        });
-    }
-    // Skipped entirely on a replay: with `replayedCachedAt` carried forward the
-    // snapshot we would write is the one just read — same tool defs, same
-    // `cachedAt` — so the write is an external store round-trip per rehydrate
-    // buying nothing. (It also cannot *refresh* anything: preserving the age is
-    // the point.) A cold connect writes; `refresh()` clears `replayedCachedAt`
-    // and writes. Skipping here additionally narrows DEV-766's surface — one
-    // fewer path that can rewrite a credentialed entry under different options.
-    //
-    // Best-effort when it does run: the handle is fully usable without its cache
-    // entry, so a store outage should not stop a connection that already
-    // succeeded. `refresh()` reports write failures as `MCPCacheWriteError` for
-    // callers that do care.
-    if (args.replayedCachedAt === undefined) {
-        await writeCache().catch(() => { });
-    }
-    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.loopKeys !== undefined && {
-            loopKeys: options.loopKeys,
-        }),
-        ...(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: args.cachedAt ?? Date.now(),
-        ...(serverInfo !== undefined && {
-            serverInfo,
-        }),
-        ...(options.auth !== undefined && {
-            auth: options.auth,
-        }),
-    };
-}
-//# sourceMappingURL=handle.js.map

package/esm/handle.js.map

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

package/esm/mcp-connection.d.ts

@@ -1,142 +0,0 @@
-import { Client } from '@modelcontextprotocol/client';
-import type { MCPAuth } from './auth/auth-types.js';
-import type { MCPProtocolNegotiation, MCPTransportKind } from './transport-types.js';
-import type { ElicitationHandler } from './types.js';
-export interface ConnectOptions {
-    url: URL;
-    transport?: MCPTransportKind;
-    auth?: MCPAuth;
-    fetch?: typeof fetch;
-    clientInfo?: {
-        name: string;
-        version: string;
-    };
-    /**
-     * Streamable HTTP session id to resume.
-     *
-     * @deprecated Ignored by 2026-07-28 servers — protocol-level sessions are
-     * removed (SEP-2567). Still honoured on 2025-era connections.
-     */
-    sessionId?: string;
-    onElicitation?: ElicitationHandler;
-    protocolNegotiation?: MCPProtocolNegotiation;
-    /**
-     * Aborts the connect — every transport attempt, the negotiation probe, and
-     * the implicit legacy retry. Without this a caller with its own deadline has
-     * no way to bound the ladder, whose worst case is minutes (see
-     * {@link DEFAULT_PROBE_TIMEOUT_MS}).
-     */
-    signal?: AbortSignal;
-    /**
-     * Ceiling on the `server/discover` probe, in ms. Defaults to
-     * `DEFAULT_PROBE_TIMEOUT_MS` (30000).
-     *
-     * Raise it for a server that is slow to answer its first request; the SDK's own
-     * default is the full request timeout, which makes a hanging gateway far slower
-     * to fail than it needs to be.
-     */
-    probeTimeoutMs?: number;
-}
-export interface MCPConnection {
-    client: Client;
-    transport: MCPTransportKind;
-    /**
-     * Session id reported by the transport, when there is one.
-     *
-     * @deprecated `undefined` on 2026-07-28 connections (SEP-2567) and on SSE,
-     * which never had a protocol-level session.
-     */
-    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>;
-}
-/**
- * Build the configured `Client` — negotiation mode, elicitation handler, and the
- * `tools/list_changed` subscription — without connecting it.
- *
- * Exported for tests only, and deliberately not re-exported from the package
- * entrypoint. It is the seam that lets a test drive the real handler wiring over
- * `InMemoryTransport`: the notification method name is compile-checked (it is a
- * `NotificationMethod` literal union, so a typo fails `tsc`), but the *dispatch*
- * — that an inbound notification actually reaches `setToolListChangedHandler`'s
- * callback — is only observable end to end. Without this seam, default-on
- * `autoRefreshOnListChanged` could be silently dead with every test green.
- *
- * @internal
- */
-export declare function makeClientForTest(options: ConnectOptions, onListChanged: () => void): Client;
-/**
- * Did any attempt behind this failure end in the server rejecting our
- * credentials?
- *
- * Searches the whole tree rather than the `cause` spine, because a single
- * `connect()` can fail more than once: `connectWithNegotiation` wraps transport
- * errors in `MCPConnectionError`, and on the two-transport path it records both
- * attempts in `errors`. Checking only `cause` would miss an `UnauthorizedError`
- * from the Streamable HTTP attempt whenever the SSE fallback then failed for an
- * unrelated reason — a URL that isn't an SSE endpoint answering 404 never
- * reaches the auth path — and the retry would re-drive the OAuth flow anyway.
- *
- * Depth-capped: a cyclic `cause` would otherwise hang, and real chains here are
- * two or three links.
- *
- * Exported for `rehydrateMCPTools`, whose fallback-to-`freshConnect` is a third
- * reconnect layer with the same duplicated-OAuth hazard; deliberately not
- * re-exported from the package entrypoint.
- */
-export declare function isAuthFailure(err: unknown, auth: MCPAuth | undefined, depth?: number): boolean;
-/**
- * Connect a `Client` to the MCP server, degrading to the 2025-era handshake if
- * protocol negotiation gets in the way.
- *
- * We default `protocolNegotiation` to `'auto'` where the SDK defaults to
- * `'legacy'`, so every connection's first request is a `server/discover` probe.
- * On its own that would be a connectivity regression: a proxy, WAF, or strict
- * gateway that hangs or 5xx's on an unknown method takes a server from working
- * to failing, and the SSE fallback re-probes and fails identically — so the
- * two-transport fallback, which looks like defense in depth, collapses to a
- * single point of failure against exactly the infrastructure it should rescue.
- *
- * So when the caller left `protocolNegotiation` unset, a failed connect is
- * retried once with `'legacy'`. That makes `'auto'` strictly additive: modern
- * servers get the new revision, everything else lands exactly where it did
- * before this package started probing. The cost is one extra attempt on a path
- * that is already failing, which is where latency matters least.
- *
- * The retry fires on **any** failure rather than only on ones that look like
- * probe timeouts. Inspecting the cause would avoid a wasted attempt against a
- * genuinely dead server, but it would couple this to SDK error codes — and a
- * reshaped error would silently disable the degradation, which is the failure
- * mode this package keeps getting bitten by.
- *
- * Two bounds keep the retry from making a bad situation worse:
- *
- * 1. **It is skipped on an auth failure.** `UnauthorizedError` means the
- *    transport reached the server and the credentials were rejected — nothing a
- *    different protocol revision changes. Retrying would re-drive the OAuth
- *    provider's authorization flow: a second `redirectToAuthorization`, a second
- *    saved PKCE verifier overwriting the first. Replaying a failure that had
- *    side effects is worse than not retrying.
- * 2. **It re-walks the same transport ladder the first pass did.** An earlier
- *    revision pinned Streamable HTTP to cap the attempt count, which broke the
- *    case this whole mechanism exists for: a legacy server reachable *only* over
- *    SSE, behind infrastructure that chokes on the probe, would fail under
- *    `'auto'` and then never be offered SSE again. Correctness wins over the
- *    attempt count here — a server that used to connect must still connect.
- *
- * So the worst case for a genuinely unreachable server is four `connect()`
- * calls, two per negotiation mode. That is the honest cost of guaranteeing no
- * working setup regresses, and it is paid only on a path that was already going
- * to fail. The bound that matters is that it is a fixed multiple rather than a
- * retry loop.
- *
- * An **explicit** `protocolNegotiation` is honoured exactly, including
- * `'auto'`: asking for a mode means asking for its failures too, and silently
- * ignoring a caller's `{ pin }` would defeat the point of pinning.
- */
-export declare function connect(options: ConnectOptions): Promise<MCPConnection>;
-//# sourceMappingURL=mcp-connection.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-connection.d.ts","sourceRoot":"","sources":["../src/mcp-connection.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,MAAM,EAIP,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAKpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA0CrD,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;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,mBAAmB,CAAC,EAAE,sBAAsB,CAAC;IAC7C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,gBAAgB,CAAC;IAC5B;;;;;OAKG;IACH,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;AAoDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,IAAI,GAAG,MAAM,CAI5F;AA4ND;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,SAAI,GAAG,OAAO,CAuCzF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA0C7E"}