@openrouter/mcp 1.0.0 → 1.1.0

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

@@ -1 +0,0 @@
-{"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,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAuED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA6CzF"}

package/esm/cache/serialize.js

@@ -1,96 +0,0 @@
-import { resolveAuth } from '../auth/auth-resolver.js';
-import { isFiniteEpoch } from './cache-types.js';
-const _expiresInStillRelative = true;
-void _expiresInStillRelative;
-/** 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) 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. Session ids
- * are never included — see the note in the `cacheCredentials` branch.
- */
-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,
-        }),
-        ...(def.loopKey !== undefined && {
-            loopKey: def.loopKey,
-        }),
-    }));
-    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;
-        }
-        // `sessionId` is deliberately NOT persisted. A Streamable HTTP
-        // `Mcp-Session-Id` is a bearer-equivalent handle to an authenticated server
-        // session, and nothing reads it back: the replay path stopped forwarding it
-        // once we found that a transport reporting a sessionId makes SDK v2 skip
-        // negotiation entirely, silently losing server capabilities. Writing it to an
-        // external store (Redis, a database, a file) would be attack surface for no
-        // functionality. That it was gated behind `cacheCredentials` at all reflects
-        // that it was always credential-grade.
-    }
-    return snapshot;
-}
-//# sourceMappingURL=serialize.js.map

package/esm/cache/serialize.js.map

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

package/esm/close-quietly.d.ts

@@ -1,24 +0,0 @@
-/**
- * Release something closeable on a path that is already failing, swallowing
- * whatever `close()` does on the way out.
- *
- * The `try` matters as much as the `catch`: `close()` is not guaranteed to
- * return a rejected promise on failure, and a *synchronous* throw never
- * produces one — so `x.close().catch(() => {})` throws before `.catch()` is
- * ever attached. On an unwinding path that is actively harmful in two ways: it
- * replaces the real error (a useful "couldn't reach the server" becomes an
- * opaque teardown failure), and it skips whatever recovery followed the close —
- * a fallback that used to self-heal starts rejecting instead.
- *
- * Every teardown-on-failure site in this package goes through here, so the
- * guarantee holds uniformly rather than depending on each caller remembering
- * the distinction.
- *
- * Deliberately not exported from the package entrypoint: callers close through
- * `MCPToolsHandle.close()` / `MCPConnection.close()`, which report failures
- * rather than swallowing them. This is only for teardown during error unwinding.
- */
-export declare function closeQuietly(closeable: {
-    close(): Promise<void>;
-}): Promise<void>;
-//# sourceMappingURL=close-quietly.d.ts.map

package/esm/close-quietly.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"close-quietly.d.ts","sourceRoot":"","sources":["../src/close-quietly.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE;IAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvF"}

package/esm/close-quietly.js

@@ -1,30 +0,0 @@
-/**
- * Release something closeable on a path that is already failing, swallowing
- * whatever `close()` does on the way out.
- *
- * The `try` matters as much as the `catch`: `close()` is not guaranteed to
- * return a rejected promise on failure, and a *synchronous* throw never
- * produces one — so `x.close().catch(() => {})` throws before `.catch()` is
- * ever attached. On an unwinding path that is actively harmful in two ways: it
- * replaces the real error (a useful "couldn't reach the server" becomes an
- * opaque teardown failure), and it skips whatever recovery followed the close —
- * a fallback that used to self-heal starts rejecting instead.
- *
- * Every teardown-on-failure site in this package goes through here, so the
- * guarantee holds uniformly rather than depending on each caller remembering
- * the distinction.
- *
- * Deliberately not exported from the package entrypoint: callers close through
- * `MCPToolsHandle.close()` / `MCPConnection.close()`, which report failures
- * rather than swallowing them. This is only for teardown during error unwinding.
- */
-export async function closeQuietly(closeable) {
-    try {
-        await closeable.close();
-    }
-    catch {
-        // Nothing actionable: we are already unwinding a failure, and the close
-        // outcome is never the error the caller needs to see.
-    }
-}
-//# sourceMappingURL=close-quietly.js.map

package/esm/close-quietly.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"close-quietly.js","sourceRoot":"","sources":["../src/close-quietly.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAqC;IACtE,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,sDAAsD;IACxD,CAAC;AACH,CAAC"}

package/esm/elicitation.d.ts

@@ -1,11 +0,0 @@
-import type { ElicitRequest, ElicitResult } from '@modelcontextprotocol/client';
-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

@@ -1 +0,0 @@
-{"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../src/elicitation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEhF,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

@@ -1,51 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,82 +0,0 @@
-/**
- * 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 the tool list was read successfully but writing the snapshot back
- * to the caller's `MCPCacheStore` failed.
- *
- * Distinct from the read failing, because the consequences differ completely: the
- * connection is live and its tools are current, so the only thing lost is a cache
- * entry. Callers who treat a store outage as fatal can catch this; callers who
- * would rather keep working with a warm handle can ignore it.
- *
- * Subclasses {@link MCPCacheError}, so existing catch sites keep working.
- */
-export declare class MCPCacheWriteError extends MCPCacheError {
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-/**
- * Raised when a snapshot is older than `staleness.maxAgeMs` and the re-list that
- * would have refreshed it failed — so the only tools available are ones the
- * caller declared too old to use.
- *
- * Subclasses {@link MCPCacheError}, so existing `catch (e instanceof
- * MCPCacheError)` sites keep working. Catch this specifically to fall back to
- * stale-but-usable tools instead of failing.
- */
-export declare class MCPStaleSnapshotError extends MCPCacheError {
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-/**
- * Raised when connecting to the MCP server fails across all attempted transports.
- */
-export declare class MCPConnectionError extends MCPError {
-    /**
-     * Every failure behind this one, in attempt order.
-     *
-     * `cause` holds only the last attempt, which loses information: an
-     * `UnauthorizedError` from the Streamable HTTP attempt matters even when the
-     * SSE fallback then failed for an unrelated reason (a URL that simply isn't an
-     * SSE endpoint answering 404). Named `errors` to match `AggregateError`, so it
-     * reads the way callers expect rather than as a bespoke field.
-     *
-     * Always populated: a single-attempt failure contributes its one underlying
-     * error, so `errors[errors.length - 1]` and `cause` agree and a caller can
-     * iterate `errors` alone without special-casing the single-attempt shape —
-     * which matters most on the auth short-circuit, where exactly one attempt was
-     * made and its rejection is the thing worth finding.
-     */
-    readonly errors: readonly unknown[];
-    constructor(message: string, options?: {
-        cause?: unknown;
-        errors?: readonly unknown[];
-    });
-}
-//# sourceMappingURL=errors.d.ts.map

package/esm/errors.d.ts.map

@@ -1 +0,0 @@
-{"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;;;;;;;;;;GAUG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;gBAEjD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAKJ;AAED;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;gBAEpD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAKJ;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;gBAGlC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;KAC7B;CAcJ"}

package/esm/errors.js

@@ -1,80 +0,0 @@
-/**
- * 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 the tool list was read successfully but writing the snapshot back
- * to the caller's `MCPCacheStore` failed.
- *
- * Distinct from the read failing, because the consequences differ completely: the
- * connection is live and its tools are current, so the only thing lost is a cache
- * entry. Callers who treat a store outage as fatal can catch this; callers who
- * would rather keep working with a warm handle can ignore it.
- *
- * Subclasses {@link MCPCacheError}, so existing catch sites keep working.
- */
-export class MCPCacheWriteError extends MCPCacheError {
-    constructor(message, options) {
-        super(message, options);
-        this.name = 'MCPCacheWriteError';
-    }
-}
-/**
- * Raised when a snapshot is older than `staleness.maxAgeMs` and the re-list that
- * would have refreshed it failed — so the only tools available are ones the
- * caller declared too old to use.
- *
- * Subclasses {@link MCPCacheError}, so existing `catch (e instanceof
- * MCPCacheError)` sites keep working. Catch this specifically to fall back to
- * stale-but-usable tools instead of failing.
- */
-export class MCPStaleSnapshotError extends MCPCacheError {
-    constructor(message, options) {
-        super(message, options);
-        this.name = 'MCPStaleSnapshotError';
-    }
-}
-/**
- * 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';
-        // Default a single-attempt failure to its own cause, so `errors` is a
-        // uniform "every attempt" list rather than empty-unless-multi.
-        this.errors =
-            options?.errors ??
-                (options?.cause !== undefined
-                    ? [
-                        options.cause,
-                    ]
-                    : []);
-    }
-}
-//# sourceMappingURL=errors.js.map

package/esm/errors.js.map

@@ -1 +0,0 @@
-{"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;;;;;;;;;;GAUG;AACH,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YACE,OAAe,EACf,OAEC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,YACE,OAAe,EACf,OAEC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAkB9C,YACE,OAAe,EACf,OAGC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,sEAAsE;QACtE,+DAA+D;QAC/D,IAAI,CAAC,MAAM;YACT,OAAO,EAAE,MAAM;gBACf,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS;oBAC3B,CAAC,CAAC;wBACE,OAAO,CAAC,KAAK;qBACd;oBACH,CAAC,CAAC,EAAE,CAAC,CAAC;IACZ,CAAC;CACF"}

package/esm/handle.d.ts

@@ -1,66 +0,0 @@
-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.
- *
- * 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 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[];
-    /**
-     * `cachedAt` to carry forward when `initialToolDefs` came from a snapshot
-     * rather than a live `listTools()`. Omit on a cold connect so the write
-     * stamps now.
-     *
-     * Without this a replay would restamp `cachedAt` on the write-back below,
-     * resetting the staleness clock on a tool set that was never re-listed —
-     * so `staleness.maxAgeMs` could never fire on a repeatedly-rehydrated
-     * snapshot. Age tracks when the tools were last actually discovered, not
-     * when they were last replayed. `refresh()` clears it, because that path
-     * does re-list.
-     */
-    replayedCachedAt?: number;
-}
-/**
- * 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

@@ -1 +0,0 @@
-{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../src/handle.ts"],"names":[],"mappings":"AAQA,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;AAiCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,aAAa,EACzB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,UAAU,EAAE,CAAC,CA0CvB;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;IAC9B;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,qBAAqB,EAC9B,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CA+CzB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CA4H9E"}