@openrouter/mcp 0.0.1

package/esm/mcp-connection.js

@@ -0,0 +1,147 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+// SSEClientTransport is deprecated upstream but intentionally supported here for
+// legacy MCP servers that haven't migrated to Streamable HTTP.
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { ElicitRequestSchema, ToolListChangedNotificationSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { resolveAuth } from './auth/auth-resolver.js';
+import { makeElicitationRequestHandler } from './elicitation.js';
+import { MCPConnectionError } from './errors.js';
+const DEFAULT_CLIENT_INFO = {
+    name: '@openrouter/mcp',
+    version: '0.1.0',
+};
+function buildStreamableHttp(options) {
+    const { headers, authProvider } = resolveAuth(options.auth);
+    return new StreamableHTTPClientTransport(options.url, {
+        requestInit: {
+            headers,
+        },
+        ...(authProvider !== undefined && {
+            authProvider,
+        }),
+        ...(options.fetch !== undefined && {
+            fetch: options.fetch,
+        }),
+        ...(options.sessionId !== undefined && {
+            sessionId: options.sessionId,
+        }),
+    });
+}
+function buildSse(options) {
+    const { headers, authProvider } = resolveAuth(options.auth);
+    return new SSEClientTransport(options.url, {
+        requestInit: {
+            headers,
+        },
+        ...(authProvider !== undefined && {
+            authProvider,
+        }),
+        ...(options.fetch !== undefined && {
+            fetch: options.fetch,
+        }),
+    });
+}
+/**
+ * Runtime narrowing to `Transport`. The SDK's transport classes implement the
+ * interface, but their `.d.ts` types `sessionId` as `string | undefined` rather
+ * than `sessionId?: string`, which `exactOptionalPropertyTypes` rejects at the
+ * `connect()` call site. We confirm the structural contract at runtime instead
+ * of asserting past the variance with `as`.
+ */
+function isTransport(value) {
+    return (typeof value.start === 'function' &&
+        typeof value.send === 'function' &&
+        typeof value.close === 'function');
+}
+function makeClient(options, listChanged) {
+    const client = new Client(options.clientInfo ?? DEFAULT_CLIENT_INFO, {
+        capabilities: {
+            elicitation: {},
+        },
+    });
+    client.setRequestHandler(ElicitRequestSchema, makeElicitationRequestHandler(options.onElicitation));
+    client.setNotificationHandler(ToolListChangedNotificationSchema, () => {
+        listChanged.handler?.();
+    });
+    return client;
+}
+async function connectWith(client, transport) {
+    if (!isTransport(transport)) {
+        throw new MCPConnectionError('MCP transport does not implement the Transport contract');
+    }
+    await client.connect(transport);
+}
+/**
+ * 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 async function connect(options) {
+    const preferred = options.transport ?? 'streamableHttp';
+    const listChanged = {
+        handler: undefined,
+    };
+    if (preferred === 'sse') {
+        const client = makeClient(options, listChanged);
+        await connectWith(client, buildSse(options));
+        return wrap({
+            client,
+            transport: 'sse',
+            listChanged,
+        });
+    }
+    // Streamable HTTP, with SSE fallback when the transport wasn't pinned.
+    const client = makeClient(options, listChanged);
+    try {
+        const http = buildStreamableHttp(options);
+        await connectWith(client, http);
+        return wrap({
+            client,
+            transport: 'streamableHttp',
+            listChanged,
+            ...(http.sessionId !== undefined && {
+                sessionId: http.sessionId,
+            }),
+        });
+    }
+    catch (httpErr) {
+        if (options.transport === 'streamableHttp') {
+            throw new MCPConnectionError('Failed to connect over Streamable HTTP', {
+                cause: httpErr,
+            });
+        }
+        // Fall back to SSE on a fresh client (the failed one may be half-initialized).
+        const sseClient = makeClient(options, listChanged);
+        try {
+            await connectWith(sseClient, buildSse(options));
+            return wrap({
+                client: sseClient,
+                transport: 'sse',
+                listChanged,
+            });
+        }
+        catch (sseErr) {
+            throw new MCPConnectionError('Failed to connect over Streamable HTTP and SSE', {
+                cause: sseErr,
+            });
+        }
+    }
+}
+function wrap(args) {
+    const { client, transport, listChanged, sessionId } = args;
+    return {
+        client,
+        transport,
+        ...(sessionId !== undefined && {
+            sessionId,
+        }),
+        setToolListChangedHandler: (handler) => {
+            listChanged.handler = handler;
+        },
+        close: () => client.close(),
+    };
+}
+//# sourceMappingURL=mcp-connection.js.map

package/esm/mcp-connection.js.map

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

package/esm/rehydrate.d.ts

@@ -0,0 +1,41 @@
+import type { MCPAuth } from './auth/auth-types.js';
+import type { MCPCacheStore } from './cache/cache-store.js';
+import type { SerializedMCPServer } from './cache/cache-types.js';
+import type { UnconvertibleSchemaMode } from './schema/json-schema-to-zod.js';
+import type { ElicitationHandler, MCPToolsHandle, ResourcesOption } from './types.js';
+export interface RehydrateMCPToolsOptions {
+    snapshot: SerializedMCPServer;
+    /** Required when the snapshot carries no cached credentials. */
+    auth?: MCPAuth;
+    fetch?: typeof fetch;
+    onUnconvertibleSchema?: UnconvertibleSchemaMode;
+    onElicitation?: ElicitationHandler;
+    signal?: AbortSignal;
+    /** Cache to refresh on reconnect/fallback. */
+    cache?: {
+        store: MCPCacheStore;
+        key?: string;
+    };
+    /** On expiry / missing creds / connection failure, do a full reconnect. Default true. */
+    reconnectOnExpiry?: boolean;
+    toolNamePrefix?: string;
+    includeTools?: readonly string[];
+    excludeTools?: readonly string[];
+    resources?: ResourcesOption;
+    emitProgress?: boolean;
+    autoRefreshOnListChanged?: boolean;
+    cacheCredentials?: boolean;
+    clientInfo?: {
+        name: string;
+        version: string;
+    };
+}
+/**
+ * Rebuild an {@link MCPToolsHandle} from a cached snapshot. On the happy path we
+ * reconnect the transport and rebuild tools directly from the snapshot —
+ * skipping `listTools()`. If cached tokens are expired, credentials are missing,
+ * or the connection fails, we transparently fall back to a full
+ * {@link createMCPTools} (unless `reconnectOnExpiry` is false).
+ */
+export declare function rehydrateMCPTools(options: RehydrateMCPToolsOptions): Promise<MCPToolsHandle>;
+//# sourceMappingURL=rehydrate.d.ts.map

package/esm/rehydrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehydrate.d.ts","sourceRoot":"","sources":["../src/rehydrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAKlE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,OAAO,KAAK,EAEV,kBAAkB,EAClB,cAAc,EACd,eAAe,EAChB,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,gEAAgE;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,qBAAqB,CAAC,EAAE,uBAAuB,CAAC;IAChD,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8CAA8C;IAC9C,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,aAAa,CAAC;QACrB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAG5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AA2GD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,cAAc,CAAC,CA+DzB"}

package/esm/rehydrate.js

@@ -0,0 +1,173 @@
+import { defaultCacheKey } from './cache/cache-store.js';
+import { isSerializedMCPServer } from './cache/cache-types.js';
+import { MCPCacheError } from './errors.js';
+import { freshConnect, makeHandle } from './handle.js';
+import { connect } from './mcp-connection.js';
+/** Clock skew (ms) treated as "already expired" when checking cached tokens. */
+const EXPIRY_SKEW_MS = 30000;
+function snapshotToToolDefs(snapshot) {
+    return snapshot.tools.map((t) => ({
+        name: t.name,
+        ...(t.description !== undefined && {
+            description: t.description,
+        }),
+        inputSchema: {
+            ...t.inputSchema,
+        },
+        ...(t.outputSchema !== undefined && {
+            outputSchema: {
+                ...t.outputSchema,
+            },
+        }),
+    }));
+}
+/** Cached tokens are unusable if they have a known expiry within the skew window. */
+function tokensExpired(snapshot) {
+    const expiresAt = snapshot.auth?.tokens?.expiresAt;
+    if (expiresAt === undefined) {
+        return false;
+    }
+    return expiresAt - Date.now() <= EXPIRY_SKEW_MS;
+}
+/**
+ * Reconstruct an {@link MCPAuth} from credentials persisted in a snapshot (only
+ * present when it was serialized with `cacheCredentials: true`). Prefer static
+ * headers when present; otherwise fall back to the OAuth/bearer access token.
+ * Returns undefined when the snapshot carries no usable credentials.
+ */
+function authFromSnapshot(snapshot) {
+    const auth = snapshot.auth;
+    if (auth === undefined) {
+        return undefined;
+    }
+    if (auth.headers !== undefined && Object.keys(auth.headers).length > 0) {
+        return {
+            kind: 'headers',
+            headers: auth.headers,
+        };
+    }
+    if (auth.tokens?.accessToken !== undefined) {
+        return {
+            kind: 'bearer',
+            token: auth.tokens.accessToken,
+        };
+    }
+    return undefined;
+}
+function toCreateOptions(options, snapshot, effectiveAuth) {
+    return {
+        url: snapshot.url,
+        transport: snapshot.transport,
+        ...(effectiveAuth !== undefined && {
+            auth: effectiveAuth,
+        }),
+        ...(options.fetch !== undefined && {
+            fetch: options.fetch,
+        }),
+        ...(options.onUnconvertibleSchema !== undefined && {
+            onUnconvertibleSchema: options.onUnconvertibleSchema,
+        }),
+        ...(options.onElicitation !== undefined && {
+            onElicitation: options.onElicitation,
+        }),
+        ...(options.signal !== undefined && {
+            signal: options.signal,
+        }),
+        ...(options.clientInfo !== undefined && {
+            clientInfo: options.clientInfo,
+        }),
+        ...(options.toolNamePrefix !== undefined && {
+            toolNamePrefix: options.toolNamePrefix,
+        }),
+        ...(options.includeTools !== undefined && {
+            includeTools: options.includeTools,
+        }),
+        ...(options.excludeTools !== undefined && {
+            excludeTools: options.excludeTools,
+        }),
+        ...(options.resources !== undefined && {
+            resources: options.resources,
+        }),
+        ...(options.emitProgress !== undefined && {
+            emitProgress: options.emitProgress,
+        }),
+        ...(options.autoRefreshOnListChanged !== undefined && {
+            autoRefreshOnListChanged: options.autoRefreshOnListChanged,
+        }),
+        ...(options.cacheCredentials !== undefined && {
+            cacheCredentials: options.cacheCredentials,
+        }),
+        ...(options.cache !== undefined && {
+            cache: options.cache,
+        }),
+    };
+}
+/**
+ * Rebuild an {@link MCPToolsHandle} from a cached snapshot. On the happy path we
+ * reconnect the transport and rebuild tools directly from the snapshot —
+ * skipping `listTools()`. If cached tokens are expired, credentials are missing,
+ * or the connection fails, we transparently fall back to a full
+ * {@link createMCPTools} (unless `reconnectOnExpiry` is false).
+ */
+export async function rehydrateMCPTools(options) {
+    const { snapshot } = options;
+    if (!isSerializedMCPServer(snapshot)) {
+        throw new MCPCacheError('Invalid MCP snapshot: failed structural validation');
+    }
+    const reconnectOnExpiry = options.reconnectOnExpiry ?? true;
+    const url = new URL(snapshot.url);
+    const cacheKey = options.cache?.key ?? defaultCacheKey(url.href);
+    // Fall back to credentials cached in the snapshot when the caller didn't pass
+    // any — otherwise a credential-bearing snapshot would reconnect unauthenticated.
+    const effectiveAuth = options.auth ?? authFromSnapshot(snapshot);
+    const hasCredentials = effectiveAuth !== undefined;
+    // Route the fallback through `freshConnect`, NOT `createMCPTools`: the latter
+    // would re-read this same snapshot and re-enter rehydrate, recursing without
+    // bound on any no-credential / expired-token snapshot. `freshConnect` still
+    // writes the refreshed result back to the cache via `makeHandle`.
+    const createOptions = toCreateOptions(options, snapshot, effectiveAuth);
+    if ((tokensExpired(snapshot) || !hasCredentials) && reconnectOnExpiry) {
+        return freshConnect(createOptions, url, cacheKey);
+    }
+    try {
+        const connection = await connect({
+            url,
+            transport: snapshot.transport,
+            ...(effectiveAuth !== undefined && {
+                auth: effectiveAuth,
+            }),
+            ...(options.fetch !== undefined && {
+                fetch: options.fetch,
+            }),
+            ...(options.clientInfo !== undefined && {
+                clientInfo: options.clientInfo,
+            }),
+            ...(snapshot.sessionId !== undefined && {
+                sessionId: snapshot.sessionId,
+            }),
+            ...(options.onElicitation !== undefined && {
+                onElicitation: options.onElicitation,
+            }),
+        });
+        // Rebuild tools from the snapshot — no listTools() round-trip.
+        return makeHandle({
+            connection,
+            options: createOptions,
+            context: {
+                url,
+                transport: connection.transport,
+                cacheKey,
+            },
+            initialToolDefs: snapshotToToolDefs(snapshot),
+        });
+    }
+    catch (err) {
+        if (reconnectOnExpiry) {
+            return freshConnect(createOptions, url, cacheKey);
+        }
+        throw new MCPCacheError('Failed to rehydrate MCP connection from snapshot', {
+            cause: err,
+        });
+    }
+}
+//# sourceMappingURL=rehydrate.js.map

package/esm/rehydrate.js.map

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

package/esm/resource-tools.d.ts

@@ -0,0 +1,17 @@
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { McpBranded } from '@openrouter/agent/tool-types';
+export interface ResourceToolsOptions {
+    client: Client;
+    namePrefix?: string;
+    signal?: AbortSignal;
+}
+/**
+ * Build synthetic tools that let the model browse and read MCP resources
+ * through the normal tool loop:
+ * - `list_resources`: concrete resources plus resource templates.
+ * - `read_resource`: fetch a resource's contents by URI.
+ *
+ * Only call this when the server advertises the `resources` capability.
+ */
+export declare function buildResourceTools(options: ResourceToolsOptions): McpBranded[];
+//# sourceMappingURL=resource-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource-tools.d.ts","sourceRoot":"","sources":["../src/resource-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAExE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAG/D,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA0ED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,EAAE,CAiG9E"}

package/esm/resource-tools.js

@@ -0,0 +1,133 @@
+import { markMcp, tool } from '@openrouter/agent/tool';
+import * as z from 'zod';
+// 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;
+}
+/**
+ * Walk a paginated MCP list endpoint, following `nextCursor` (passed back as
+ * `{ cursor }`) until exhausted, and return the flattened items. Stops when the
+ * server omits `nextCursor`, repeats the same cursor, or the page cap is hit.
+ */
+async function collectPages(fetchPage, requestOptions) {
+    const collected = [];
+    let cursor;
+    for (let page = 0; page < MAX_LIST_PAGES; page += 1) {
+        const params = cursor !== undefined
+            ? {
+                cursor,
+            }
+            : undefined;
+        const { items, nextCursor } = await fetchPage(params, requestOptions);
+        collected.push(...items);
+        const next = nextCursorOrUndefined(nextCursor);
+        if (next === undefined || next === cursor) {
+            break;
+        }
+        cursor = next;
+    }
+    return collected;
+}
+/**
+ * Build synthetic tools that let the model browse and read MCP resources
+ * through the normal tool loop:
+ * - `list_resources`: concrete resources plus resource templates.
+ * - `read_resource`: fetch a resource's contents by URI.
+ *
+ * Only call this when the server advertises the `resources` capability.
+ */
+export function buildResourceTools(options) {
+    const prefix = options.namePrefix ?? '';
+    const requestOptions = options.signal !== undefined
+        ? {
+            signal: options.signal,
+        }
+        : undefined;
+    const listResources = tool({
+        name: `${prefix}list_resources`,
+        description: 'List the resources and resource templates exposed by the MCP server.',
+        inputSchema: z.object({}),
+        execute: async () => {
+            const [resources, resourceTemplates] = await Promise.all([
+                collectPages(async (params, opts) => {
+                    const page = await options.client.listResources(params, opts);
+                    return {
+                        items: page.resources,
+                        nextCursor: page.nextCursor,
+                    };
+                }, requestOptions),
+                // Templates are optional: a server may not support them. The whole
+                // paginated fetch degrades gracefully to an empty list on any error.
+                collectPages(async (params, opts) => {
+                    const page = await options.client.listResourceTemplates(params, opts);
+                    return {
+                        items: page.resourceTemplates,
+                        nextCursor: page.nextCursor,
+                    };
+                }, requestOptions).catch(() => []),
+            ]);
+            return {
+                resources: resources.map((r) => ({
+                    uri: r.uri,
+                    name: r.name,
+                    ...(r.description !== undefined && {
+                        description: r.description,
+                    }),
+                    ...(r.mimeType !== undefined && {
+                        mimeType: r.mimeType,
+                    }),
+                })),
+                resourceTemplates: resourceTemplates.map((t) => ({
+                    uriTemplate: t.uriTemplate,
+                    name: t.name,
+                    ...(t.description !== undefined && {
+                        description: t.description,
+                    }),
+                })),
+            };
+        },
+    });
+    const readResource = tool({
+        name: `${prefix}read_resource`,
+        description: 'Read the contents of an MCP resource by its URI.',
+        inputSchema: z.object({
+            uri: z.string().describe('Resource URI to read'),
+        }),
+        execute: async (args) => {
+            const result = await options.client.readResource({
+                uri: args.uri,
+            }, requestOptions);
+            return {
+                contents: result.contents.map((c) => {
+                    if ('text' in c) {
+                        return {
+                            uri: c.uri,
+                            text: c.text,
+                            ...(c.mimeType !== undefined && {
+                                mimeType: c.mimeType,
+                            }),
+                        };
+                    }
+                    return {
+                        uri: c.uri,
+                        blob: c.blob,
+                        ...(c.mimeType !== undefined && {
+                            mimeType: c.mimeType,
+                        }),
+                    };
+                }),
+            };
+        },
+    });
+    return [
+        markMcp(listResources),
+        markMcp(readResource),
+    ];
+}
+//# sourceMappingURL=resource-tools.js.map

package/esm/resource-tools.js.map

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

package/esm/result-mapper.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The subset of an MCP `CallToolResult` we read. The SDK types it more richly,
+ * but we narrow defensively from `unknown`-ish content rather than trusting the
+ * wire shape.
+ */
+export interface RawCallToolResult {
+    content?: unknown;
+    structuredContent?: unknown;
+    isError?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Map an MCP tool result into a value `callModel` can hand back to the model.
+ * Prefers `structuredContent` (already JSON), otherwise the collapsed text
+ * content. Throws {@link MCPToolCallError} when the server flags `isError`, so
+ * the agent loop reports the failure instead of treating error text as success.
+ */
+export declare function mapCallToolResult(toolName: string, result: RawCallToolResult): unknown;
+//# sourceMappingURL=result-mapper.d.ts.map

package/esm/result-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-mapper.d.ts","sourceRoot":"","sources":["../src/result-mapper.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AA2BD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAStF"}

package/esm/result-mapper.js

@@ -0,0 +1,40 @@
+import { MCPToolCallError } from './errors.js';
+import { isJsonSchemaObject } from './schema/json-schema-guards.js';
+function isTextBlock(block) {
+    return isJsonSchemaObject(block) && block['type'] === 'text' && typeof block['text'] === 'string';
+}
+/** Collapse the content array into a single string for the model. */
+function contentToText(content) {
+    if (!Array.isArray(content)) {
+        return '';
+    }
+    const parts = [];
+    for (const block of content) {
+        if (isTextBlock(block)) {
+            parts.push(block.text);
+        }
+        else if (isJsonSchemaObject(block) && typeof block['type'] === 'string') {
+            // Non-text blocks (image/audio/resource) aren't passed through as media
+            // in v1 — surface a typed placeholder so the model knows it exists.
+            parts.push(`[${block['type']} content]`);
+        }
+    }
+    return parts.join('\n');
+}
+/**
+ * Map an MCP tool result into a value `callModel` can hand back to the model.
+ * Prefers `structuredContent` (already JSON), otherwise the collapsed text
+ * content. Throws {@link MCPToolCallError} when the server flags `isError`, so
+ * the agent loop reports the failure instead of treating error text as success.
+ */
+export function mapCallToolResult(toolName, result) {
+    if (result.isError === true) {
+        const message = contentToText(result.content) || 'MCP tool returned an error';
+        throw new MCPToolCallError(toolName, message);
+    }
+    if (result.structuredContent !== undefined) {
+        return result.structuredContent;
+    }
+    return contentToText(result.content);
+}
+//# sourceMappingURL=result-mapper.js.map

package/esm/result-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-mapper.js","sourceRoot":"","sources":["../src/result-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAcpE,SAAS,WAAW,CAAC,KAAc;IAIjC,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC;AACpG,CAAC;AAED,qEAAqE;AACrE,SAAS,aAAa,CAAC,OAAgB;IACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;aAAM,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1E,wEAAwE;YACxE,oEAAoE;YACpE,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,MAAyB;IAC3E,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,4BAA4B,CAAC;QAC9E,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAC3C,OAAO,MAAM,CAAC,iBAAiB,CAAC;IAClC,CAAC;IACD,OAAO,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/esm/schema/json-schema-guards.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Typeguards over the raw JSON-Schema-shaped values that arrive from an MCP
+ * server. MCP tool input/output schemas are untrusted `unknown` data, so we
+ * narrow them with runtime checks rather than `as` casts.
+ */
+/** A non-null, non-array object — the shape every JSON Schema node takes. */
+export declare function isJsonSchemaObject(value: unknown): value is Record<string, unknown>;
+/** A JSON Schema whose top-level `type` is `"object"`. */
+export declare function isObjectJsonSchema(value: unknown): value is Record<string, unknown> & {
+    type: 'object';
+};
+/** The `properties` map of an object schema, when present and well-formed. */
+export declare function getSchemaProperties(schema: Record<string, unknown>): Record<string, unknown> | undefined;
+//# sourceMappingURL=json-schema-guards.d.ts.map

package/esm/schema/json-schema-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-guards.d.ts","sourceRoot":"","sources":["../../src/schema/json-schema-guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEnF;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACrF,IAAI,EAAE,QAAQ,CAAC;CAChB,CAEA;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGrC"}

package/esm/schema/json-schema-guards.js

@@ -0,0 +1,19 @@
+/**
+ * Typeguards over the raw JSON-Schema-shaped values that arrive from an MCP
+ * server. MCP tool input/output schemas are untrusted `unknown` data, so we
+ * narrow them with runtime checks rather than `as` casts.
+ */
+/** A non-null, non-array object — the shape every JSON Schema node takes. */
+export function isJsonSchemaObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** A JSON Schema whose top-level `type` is `"object"`. */
+export function isObjectJsonSchema(value) {
+    return isJsonSchemaObject(value) && value['type'] === 'object';
+}
+/** The `properties` map of an object schema, when present and well-formed. */
+export function getSchemaProperties(schema) {
+    const { properties } = schema;
+    return isJsonSchemaObject(properties) ? properties : undefined;
+}
+//# sourceMappingURL=json-schema-guards.js.map