agentfootprint 12.0.1 → 12.1.0

package/dist/esm/mcp/mcpClient.js

@@ -45,6 +45,9 @@
 import { isDevMode } from 'footprintjs';
 import { callMetaOf, readToolExtras } from './toolExtras.js';
 import { isToolError, readToolResult, resultModeOf } from './toolResult.js';
+import { listEveryPage, McpToolListIncompleteError } from './toolList.js';
+import { listingsOf } from './listingGenerations.js';
+import { callCheckKit, checkOutput, checksFor, McpOutputUncheckedError, outputUnchecked, refuseRequiredTask, validatorOption, } from './callChecks.js';
 import { createVendingFetch } from './gatewayTransport.js';
 import { ledgeredFetch, retryingFetch, seriesWithoutThrottle, } from './throttleRetry.js';
 import { RequestLedger } from './requestLedger.js';
@@ -94,7 +97,10 @@ export async function mcpClient(opts) {
     // checked once, here, before anything connects (`replay.ts`).
     const replay = replayDeclarationOf(opts.replay, `mcpClient[${name}]`);
     const strict = replay.policy === 'app-authorized';
-    const { connection, ledger } = await openConnection(opts, replay, name);
+    // The validator a tool's own output checks use (`callChecks.ts`), refused by
+    // name now when it is not one.
+    const validator = validatorOption(opts.jsonSchemaValidator, `mcpClient[${name}]`);
+    const { connection, ledger, kit } = await openConnection(opts, replay, name, validator);
     const unlisted = new Set();
     // Tool cache so consumers calling `.tools()` more than once don't
     // hammer the server. `.refresh()` invalidates it.
@@ -106,13 +112,24 @@ export async function mcpClient(opts) {
         }
     };
     const buildTools = async () => {
-        // `signal` rides in the SDK's THIRD argument (RequestOptions), not in
-        // the request params — see `wrapMcpTool`.
-        const listed = opts.signal
-            ? await connection.listTools(undefined, { signal: opts.signal })
-            : await connection.listTools();
-        noteUnlisted(replay, listed.tools, name, unlisted);
-        return listed.tools.map((t) => wrapMcpTool(name, connection, t, opts.signal, resultMode, ledger, strict));
+        // Every page of the server's list (`toolList.ts`). `signal` rides each
+        // page in the SDK's trailing options argument, never in the params — see
+        // `wrapMcpTool`.
+        // Each page request is counted in this connection's listings, whatever it
+        // settles to (`listingGenerations.ts`).
+        const listing = await listEveryPage(connection, opts.signal, kit.listings);
+        // A list that did not end cannot say which entries name nothing.
+        if (listing.incomplete === undefined)
+            noteUnlisted(replay, listing.tools, name, unlisted);
+        // Every tool carries the checks of the list it came from (`callChecks.ts`):
+        // the SDK's `Client` holds them only while a one-page list's answer is its
+        // latest, and only then are they left to it.
+        const tools = listing.tools.map((t) => wrapMcpTool(name, connection, t, opts.signal, resultMode, ledger, strict, checksFor(t, kit, listing.generation)));
+        // Never a list cut short: what was listed travels on the refusal instead.
+        if (listing.incomplete !== undefined) {
+            throw new McpToolListIncompleteError(listing.incomplete, name, listing.pages, tools);
+        }
+        return tools;
     };
     return {
         name,
@@ -151,31 +168,79 @@ export async function mcpClient(opts) {
  * A call with neither `connection` nor `sdk` reaches `resolveClient` with two
  * `undefined` arguments and takes the identical path it always took.
  */
-async function openConnection(opts, replay, name) {
-    if (opts.connection !== undefined)
-        return { connection: opts.connection };
-    if (opts._client !== undefined)
-        return { connection: opts._client };
+async function openConnection(opts, replay, name, validator) {
+    // A client built elsewhere: the library loads nothing, so only the caller's
+    // validator can check a tool's output itself, and errors take the SDK's shape.
+    // Its list requests are counted per client: every mcpClient over it shares one
+    // count, as they share the SDK's one set of checks (`listingGenerations.ts`).
+    if (opts.connection !== undefined) {
+        const kit = callCheckKit(name, listingsOf(opts.connection), validator);
+        return { connection: opts.connection, kit };
+    }
+    if (opts._client !== undefined) {
+        return {
+            connection: opts._client,
+            kit: callCheckKit(name, listingsOf(opts._client), validator),
+        };
+    }
     // `refuseConflictingOptions` has already refused the case where this is
     // absent, so the assertion documents that guarantee rather than assuming it.
     const transport = opts.transport;
-    return resolveClient(transport, opts.clientInfo, opts.signal, opts.retryOnThrottle, opts.sdk, replay, name);
+    return resolveClient(transport, opts.clientInfo, opts.signal, opts.retryOnThrottle, opts.sdk, replay, name, validator);
 }
 // ─── SDK construction (lazy require, unless the caller supplied it) ─
-async function resolveClient(transport, clientInfo, signal, retryOnThrottle, sdk, replay, name = 'mcp') {
+async function resolveClient(transport, clientInfo, signal, retryOnThrottle, sdk, replay, name = 'mcp', validator) {
     if (sdk !== undefined)
         assertSdk(sdk, transport.transport);
     const mod = sdk ?? loadClientModule();
-    const client = new mod.Client(clientInfo ?? DEFAULT_CLIENT_INFO, {
-        capabilities: {},
-    });
+    // A caller's validator is the client's too, so one validator checks every
+    // page; without one, the options are exactly what they always were.
+    const options = validator === undefined
+        ? { capabilities: {} }
+        : { capabilities: {}, jsonSchemaValidator: validator };
+    const client = new mod.Client(clientInfo ?? DEFAULT_CLIENT_INFO, options);
     const built = await buildTransport(transport, retryOnThrottle, sdk, replay, name);
+    // With the SDK loaded here, so is what a tool's own checks run with: its
+    // default validator and its own error class. With `sdk`, the loader is never
+    // touched (`callChecks.ts`).
+    const kit = sdk === undefined
+        ? callCheckKit(name, listingsOf(client), validator, loadCheckModules(validator))
+        : callCheckKit(name, listingsOf(client), validator);
     // Same rule as callTool: options ride beside the transport, never inside it.
     if (signal)
         await client.connect(built.transport, { signal });
     else
         await client.connect(built.transport);
-    return { connection: client, ...(built.ledger !== undefined && { ledger: built.ledger }) };
+    return {
+        connection: client,
+        kit,
+        ...(built.ledger !== undefined && { ledger: built.ledger }),
+    };
+}
+/**
+ * What the SDK's `Client` checks a tool's call with, loaded with the SDK on the
+ * Node loader path (the bundling law: when the client is built, never at a
+ * later tool call): its own `McpError`, and — unless the caller gave a
+ * validator — its default validator, `AjvJsonSchemaValidator`. Both modules are
+ * the ones `client/index.js` already loaded. An SDK without one of them (older
+ * than its public validator subpath) leaves that slot empty: errors then take
+ * the SDK's shape, and an output no validator here can check is never returned.
+ */
+function loadCheckModules(validator) {
+    const McpError = loadOptional(() => lazyRequire('@modelcontextprotocol/sdk/types.js'))?.McpError;
+    const Validator = validator === undefined
+        ? loadOptional(() => lazyRequire('@modelcontextprotocol/sdk/validation/ajv'))?.AjvJsonSchemaValidator
+        : undefined;
+    return { McpError, Validator };
+}
+/** A module this SDK may not have: `undefined` when it cannot be loaded. */
+function loadOptional(load) {
+    try {
+        return load();
+    }
+    catch {
+        return undefined;
+    }
 }
 /**
  * An injected `sdk` is checked before anything is built, so a wrong import (a
@@ -354,7 +419,7 @@ function noteUnlisted(replay, listed, server, noted) {
     }
 }
 // ─── Tool wrapping ─────────────────────────────────────────────────
-function wrapMcpTool(serverName, connection, mcp, signal, resultMode, ledger, strict = false) {
+function wrapMcpTool(serverName, connection, mcp, signal, resultMode, ledger, strict = false, checks) {
     const tool = {
         schema: {
             name: mcp.name,
@@ -416,12 +481,32 @@ function wrapMcpTool(serverName, connection, mcp, signal, resultMode, ledger, st
             if (unavailable !== undefined) {
                 throw new McpReplayUnavailableError(unavailable, serverName, mcp.name);
             }
+            // Whose checks this call runs under, decided before anything is sent
+            // (`callChecks.ts`): the SDK's `Client` holds them while this tool's
+            // one-page list is still its latest answer and no list request is out;
+            // otherwise the tool's own checks run. An output they cannot check is
+            // refused here, unsent.
+            const own = checks !== undefined && !checks.heldBySdk();
+            if (own && outputUnchecked(checks)) {
+                throw new McpOutputUncheckedError(serverName, mcp.name, false);
+            }
             const call = openCall(params, ctx, signal, ledger, serverName);
             let verdict = 'failed';
             try {
-                const result = call.signal
-                    ? await connection.callTool(call.params, undefined, { signal: call.signal })
-                    : await connection.callTool(call.params);
+                const send = () => call.signal
+                    ? connection.callTool(call.params, undefined, { signal: call.signal })
+                    : connection.callTool(call.params);
+                // The tool's own checks run where the SDK's `callTool` runs them, so a
+                // call fails as it would with the SDK holding them: the task refusal
+                // before sending, the output checks once the answer is in.
+                if (own)
+                    refuseRequiredTask(checks);
+                const result = await send();
+                // A list request that went out while the call was out may have replaced
+                // the SDK's checks before it read the answer, so the tool's own checks
+                // read it too.
+                if (checks !== undefined && (own || !checks.heldBySdk()))
+                    checkOutput(checks, result);
                 verdict = isToolError(result) ? 'tool-error' : 'completed';
                 return readToolResult(result, mcp.name, serverName, resultMode);
             }

package/dist/esm/mcp/mcpClient.js.map

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

package/dist/esm/mcp/toolList.d.ts

@@ -0,0 +1,90 @@
+/**
+ * toolList — every page of a server's `tools/list` answer, or a typed refusal
+ * that says the list is incomplete.
+ *
+ * Pattern: one bounded loop + one typed refusal.
+ * Role:    MCP pages a tool list: a page carries `nextCursor` while the server
+ *          has more, and the next page is asked for with `{ cursor }`. Reading
+ *          only the first page cut a paginating server's catalogue short in
+ *          silence — the agent saw part of it and nothing said so. This reads
+ *          until the server sends no cursor, within a bound, and when it cannot
+ *          finish the list it says why:
+ *
+ *   - `'page-limit'` — the list did not end within {@link MAX_TOOL_LIST_PAGES}
+ *     pages;
+ *   - `'cursor-repeated'` — a page named a cursor this listing already sent, so
+ *     following it would loop.
+ *
+ * The first page is asked exactly as before pagination was followed: no params
+ * (and, with no signal, no arguments at all). The client's signal rides every
+ * page in the SDK's trailing options, and it is checked immediately before each
+ * page is asked for and again when each answer arrives (`lib/abort.ts`): once
+ * it has fired, nothing more is asked for and no page is accepted, the last one
+ * included. An abort is the caller's word, so it wins over an incomplete list.
+ * What it cannot do is settle a page a connection that ignores the signal is
+ * still holding: that promise settles when the connection says.
+ *
+ * Every page request is counted from the moment it is sent until it settles
+ * (`listingGenerations.ts`): the MCP SDK's `Client` replaces its per-tool call
+ * checks with each answer, so a tool's checks depend on which answer is the
+ * latest (`callChecks.ts`).
+ */
+import type { Tool } from '../tools/tools.js';
+import type { ListingGenerations } from './listingGenerations.js';
+import type { McpConnection, McpListedTool } from './types.js';
+/**
+ * The most `tools/list` requests one listing sends. A bound on REQUESTS, not on
+ * the catalogue's size: a page may hold any number of tools. A server that
+ * keeps paging past it is reported as incomplete rather than read without end.
+ */
+export declare const MAX_TOOL_LIST_PAGES = 100;
+/** Why a server's tool list could not be read to its end. */
+export type McpToolListIncompleteReason = 'page-limit' | 'cursor-repeated';
+/** What a listing read: every tool its pages held, how many pages, and whether it ended. */
+export interface ToolListing {
+    readonly tools: readonly McpListedTool[];
+    readonly pages: number;
+    /**
+     * For a list read in ONE answer, the generation that answer settled at: the
+     * MCP SDK's `Client` holds its tools' checks while it stays the latest
+     * (`listingGenerations.ts`). Absent for a paged list: no one answer holds all
+     * of its tools.
+     */
+    readonly generation?: number;
+    /** Absent when the server's list ended: the last page carried no cursor. */
+    readonly incomplete?: McpToolListIncompleteReason;
+}
+/**
+ * Read the server's tool list, page by page, until a page carries no cursor —
+ * or until it cannot be finished, which the result says (`incomplete`).
+ *
+ * @param listings the connection's count of list requests, which every page
+ *   request joins (`listingGenerations.ts`)
+ * @throws the abort, when `signal` has fired before a page is asked for or by
+ *   the time its answer arrives; and whatever the connection rejects a page
+ *   with, as it always did
+ */
+export declare function listEveryPage(connection: McpConnection, signal: AbortSignal | undefined, listings: ListingGenerations): Promise<ToolListing>;
+/**
+ * A server's tool list that could not be read to its end. `tools()` and
+ * `refresh()` reject with it rather than return a list cut short: an agent
+ * handed part of a catalogue cannot know what it was not offered.
+ *
+ * `tools` holds what WAS listed — wrapped and callable, exactly as `tools()`
+ * would have returned them — for a caller that decides to use an incomplete
+ * list knowingly. Names the server, the reason and the count, never a cursor.
+ */
+export declare class McpToolListIncompleteError extends Error {
+    readonly reason: McpToolListIncompleteReason;
+    readonly server: string;
+    /** The pages read before the listing stopped. */
+    readonly pages: number;
+    /** The tools those pages listed, in page order. */
+    readonly tools: readonly Tool[];
+    readonly code: "ERR_MCP_TOOL_LIST_INCOMPLETE";
+    constructor(reason: McpToolListIncompleteReason, server: string, 
+    /** The pages read before the listing stopped. */
+    pages: number, 
+    /** The tools those pages listed, in page order. */
+    tools: readonly Tool[]);
+}

package/dist/esm/mcp/toolList.js

@@ -0,0 +1,123 @@
+/**
+ * toolList — every page of a server's `tools/list` answer, or a typed refusal
+ * that says the list is incomplete.
+ *
+ * Pattern: one bounded loop + one typed refusal.
+ * Role:    MCP pages a tool list: a page carries `nextCursor` while the server
+ *          has more, and the next page is asked for with `{ cursor }`. Reading
+ *          only the first page cut a paginating server's catalogue short in
+ *          silence — the agent saw part of it and nothing said so. This reads
+ *          until the server sends no cursor, within a bound, and when it cannot
+ *          finish the list it says why:
+ *
+ *   - `'page-limit'` — the list did not end within {@link MAX_TOOL_LIST_PAGES}
+ *     pages;
+ *   - `'cursor-repeated'` — a page named a cursor this listing already sent, so
+ *     following it would loop.
+ *
+ * The first page is asked exactly as before pagination was followed: no params
+ * (and, with no signal, no arguments at all). The client's signal rides every
+ * page in the SDK's trailing options, and it is checked immediately before each
+ * page is asked for and again when each answer arrives (`lib/abort.ts`): once
+ * it has fired, nothing more is asked for and no page is accepted, the last one
+ * included. An abort is the caller's word, so it wins over an incomplete list.
+ * What it cannot do is settle a page a connection that ignores the signal is
+ * still holding: that promise settles when the connection says.
+ *
+ * Every page request is counted from the moment it is sent until it settles
+ * (`listingGenerations.ts`): the MCP SDK's `Client` replaces its per-tool call
+ * checks with each answer, so a tool's checks depend on which answer is the
+ * latest (`callChecks.ts`).
+ */
+import { throwIfAborted } from '../lib/abort.js';
+/**
+ * The most `tools/list` requests one listing sends. A bound on REQUESTS, not on
+ * the catalogue's size: a page may hold any number of tools. A server that
+ * keeps paging past it is reported as incomplete rather than read without end.
+ */
+export const MAX_TOOL_LIST_PAGES = 100;
+/**
+ * Read the server's tool list, page by page, until a page carries no cursor —
+ * or until it cannot be finished, which the result says (`incomplete`).
+ *
+ * @param listings the connection's count of list requests, which every page
+ *   request joins (`listingGenerations.ts`)
+ * @throws the abort, when `signal` has fired before a page is asked for or by
+ *   the time its answer arrives; and whatever the connection rejects a page
+ *   with, as it always did
+ */
+export async function listEveryPage(connection, signal, listings) {
+    const tools = [];
+    const sent = new Set();
+    let cursor;
+    for (let pages = 1;; pages++) {
+        // Immediately before EVERY request, the first included: an aborted listing
+        // asks for nothing more (`lib/abort.ts`).
+        throwIfAborted(signal);
+        const { answer: page, generation } = await listings.ask(() => askPage(connection, cursor, signal));
+        // And after EVERY answer, before it is accepted: a page that lands after
+        // the abort — the last page too — is never part of a listing, so nothing
+        // incomplete is returned and nothing complete is cached.
+        throwIfAborted(signal);
+        // One push per tool: spreading a very large page into `push` can overflow the stack.
+        for (const tool of page.tools)
+            tools.push(tool);
+        const next = page.nextCursor;
+        if (next === undefined || next === null) {
+            return pages === 1 ? { tools, pages, generation } : { tools, pages };
+        }
+        if (sent.has(next))
+            return { tools, pages, incomplete: 'cursor-repeated' };
+        if (pages >= MAX_TOOL_LIST_PAGES)
+            return { tools, pages, incomplete: 'page-limit' };
+        sent.add(next);
+        cursor = next;
+    }
+}
+/**
+ * One page. The first carries no params — with no signal, no arguments at all —
+ * which is the request a one-page server always got; a later page carries
+ * `{ cursor }`. The signal rides the trailing options, never the params.
+ */
+function askPage(connection, cursor, signal) {
+    const params = cursor === undefined ? undefined : { cursor };
+    if (signal !== undefined)
+        return connection.listTools(params, { signal });
+    return params === undefined ? connection.listTools() : connection.listTools(params);
+}
+/** The fixed sentence each reason reads as. Never a cursor: that is the server's data. */
+const BECAUSE = {
+    'page-limit': (pages) => `the list did not end within ${pages} pages`,
+    'cursor-repeated': (pages) => `page ${pages} named a cursor this listing had already sent, so following it would loop`,
+};
+/**
+ * A server's tool list that could not be read to its end. `tools()` and
+ * `refresh()` reject with it rather than return a list cut short: an agent
+ * handed part of a catalogue cannot know what it was not offered.
+ *
+ * `tools` holds what WAS listed — wrapped and callable, exactly as `tools()`
+ * would have returned them — for a caller that decides to use an incomplete
+ * list knowingly. Names the server, the reason and the count, never a cursor.
+ */
+export class McpToolListIncompleteError extends Error {
+    reason;
+    server;
+    pages;
+    tools;
+    code = 'ERR_MCP_TOOL_LIST_INCOMPLETE';
+    constructor(reason, server, 
+    /** The pages read before the listing stopped. */
+    pages, 
+    /** The tools those pages listed, in page order. */
+    tools) {
+        super(`mcpClient[${server}]: the server's tool list is incomplete — ${BECAUSE[reason](pages)}. ` +
+            `No tools were returned; the ${tools.length} listed before it stopped are on this ` +
+            "error's `tools`, for a caller that chooses to use an incomplete list.");
+        this.reason = reason;
+        this.server = server;
+        this.pages = pages;
+        this.tools = tools;
+        this.name = 'McpToolListIncompleteError';
+    }
+}
+//# sourceMappingURL=toolList.js.map

package/dist/esm/mcp/toolList.js.map

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

package/dist/esm/mcp/types.d.ts

@@ -307,6 +307,25 @@ export interface McpClientOptions {
      * @see McpSdk for the two static imports that produce it.
      */
     readonly sdk?: McpSdk;
+    /**
+     * The JSON Schema validator a tool's `outputSchema` is checked with — the MCP
+     * SDK's own validator interface (`new AjvJsonSchemaValidator()` from
+     * `@modelcontextprotocol/sdk/validation/ajv`, `new CfWorkerJsonSchemaValidator()`,
+     * or your own).
+     *
+     * Why it exists: the SDK's `Client` checks a tool's output only for the tools
+     * of its most recent `tools/list` answer, so every tool the library hands out
+     * carries its own checks, and runs them whenever the SDK no longer holds its
+     * list: a paged list, a list a later answer replaced, a call made while a list
+     * is read — of the lists `tools()` and `refresh()` read (see
+     * `McpClient.tools()`; the client the library builds here never lists by
+     * itself). The client the library builds is handed this same validator, so
+     * one validator checks every call. Omit it and the library uses the SDK's
+     * default, loaded with the SDK itself; with `sdk`, where the library never
+     * touches its Node loader, such a call to a tool that declares an
+     * `outputSchema` is refused (`McpOutputUncheckedError`) unless you pass one.
+     */
+    readonly jsonSchemaValidator?: McpJsonSchemaValidator;
     /** @see McpConnectionOptions — never set on this arm. */
     readonly connection?: undefined;
     /**
@@ -346,10 +365,35 @@ export interface McpConnectionOptions {
     /**
      * A connection you already opened. The library never calls `connect()` on it;
      * `close()` on the returned client closes it exactly once.
+     *
+     * Leave its tool discovery to `mcpClient`: the per-tool checks hold only for
+     * the lists `tools()` and `refresh()` read (see `McpClient.tools()`). Do not
+     * let the SDK client refresh itself (`listChanged.tools` with `autoRefresh`,
+     * which is on by default once `listChanged.tools` is given): set
+     * `autoRefresh: false` and call `refresh()` from `onChanged`, or give
+     * `mcpClient` a connection of its own.
      */
     readonly connection: McpConnection;
     /** Abort the list / call paths. Rides the SDK's request options. */
     readonly signal?: AbortSignal;
+    /**
+     * The JSON Schema validator your client checks tool output with — pass the
+     * SAME one you gave its constructor (`jsonSchemaValidator`), or the SDK's
+     * default, `new AjvJsonSchemaValidator()`.
+     *
+     * The SDK's `Client` checks a tool's output only for the tools of its most
+     * recent `tools/list` answer, so the library checks a tool itself, with this,
+     * whenever the SDK no longer holds its list: a paged list, a list a later
+     * answer replaced, a call made while a list is read. Without it, such a call
+     * to a tool that declares an `outputSchema` is refused
+     * (`McpOutputUncheckedError`); a one-page catalogue that is still the latest
+     * answer never needs it. It covers only the lists `tools()` and `refresh()`
+     * read: when the SDK client's cache is replaced some other way (its own
+     * automatic refresh, a `listTools` call of yours), the library still leaves
+     * the call to the SDK, and this validator is never asked (see
+     * `McpClient.tools()`).
+     */
+    readonly jsonSchemaValidator?: McpJsonSchemaValidator;
     /** @see McpClientOptions — never set on this arm. */
     readonly transport?: undefined;
     /** @see McpClientOptions — never set on this arm. */
@@ -376,12 +420,52 @@ export interface McpClient {
      * after `mcpClient(...)` is the snapshot used to register on the
      * agent; subsequent calls re-fetch (cheap, in-memory cached by the
      * SDK between fetches).
+     *
+     * Every page of the server's `tools/list` answer is read: the client
+     * follows `nextCursor` until a page carries none, sending at most 100
+     * `tools/list` requests (a bound on requests, not on the catalogue's size).
+     * A list that does not end within them, or that names a cursor it already
+     * sent (a loop), is never returned cut short: the call rejects with
+     * `McpToolListIncompleteError`, whose `reason` says which and whose `tools`
+     * holds what was listed. `signal` rides every page and is checked before
+     * each page is asked for and when each answer arrives: once it has fired,
+     * nothing more is asked for and no page is accepted.
+     *
+     * Every tool keeps its checks, whatever `tools()` and `refresh()` list later —
+     * those of any `mcpClient` over the same client included. That holds only
+     * while all tool discovery on the client runs through them; see below. The
+     * SDK's `Client` checks a tool's call (a required task refused before
+     * sending; `structuredContent` required by an `outputSchema`, and matched
+     * against it) only for the tools of its most recent `tools/list` answer, so
+     * every tool returned here carries those checks itself. They are left to the
+     * SDK only for a tool of a one-page list whose answer is still the latest,
+     * with no list request out. Every other call runs the tool's own and fails
+     * with the same error: a paged list's tools, a tool held across a later
+     * `refresh()` (failed or not), a call made while a list is read. Where no JSON
+     * Schema validator is reachable (`jsonSchemaValidator` on the `sdk` and
+     * `connection` arms), such a call to a tool that declares an `outputSchema` is
+     * refused with `McpOutputUncheckedError`: before it is sent, or, when a list
+     * was read while it was out, once its answer is in, unread.
+     *
+     * What it does not cover: a listing the library does not send. Your own
+     * `listTools` calls, the SDK client's automatic discovery (`listChanged.tools`
+     * with `autoRefresh`, on by default once `listChanged.tools` is given), or any
+     * other replacement of the SDK client's cache leave a tool handed out here
+     * believing the SDK still holds its checks — so neither its output checks nor
+     * its required-task refusal run, even with `jsonSchemaValidator`. The client
+     * the library builds (the `transport` and `sdk` arms) never lists by itself;
+     * on a client you pass as `connection`, set `autoRefresh: false` and call
+     * `refresh()` from `onChanged`, or give `mcpClient` a connection of its own.
      */
     tools(): Promise<readonly Tool[]>;
     /**
      * Force a refresh from the server. Use when you suspect the server
      * has dynamically added/removed tools mid-session (e.g., after the
-     * server processes a config update).
+     * server processes a config update). Reads every page, as `tools()` does.
+     * When it fails it rejects, and `tools()` keeps serving the catalogue it
+     * had: those tools keep their own checks (see `tools()`). Route the server's
+     * list-changed notice here, rather than letting the SDK client refresh
+     * itself: a listing the library does not send is not covered.
      */
     refresh(): Promise<readonly Tool[]>;
     /** Close the underlying transport. After `close()` the client is unusable. */
@@ -412,8 +496,17 @@ export interface McpClient {
  * convenience version of it.
  */
 export interface McpConnection {
-    listTools(params?: undefined, options?: McpRequestOptions): Promise<{
+    /**
+     * One page of the server's tool list. The first page is asked with no params;
+     * each later page with the `nextCursor` the page before it returned, as
+     * `{ cursor }`. A connection that never pages returns no `nextCursor`.
+     */
+    listTools(params?: {
+        readonly cursor?: string;
+    }, options?: McpRequestOptions): Promise<{
         readonly tools: ReadonlyArray<McpListedTool>;
+        /** Present while the server has more tools: what to ask for the next page with. */
+        readonly nextCursor?: string;
     }>;
     callTool(params: {
         readonly name: string;
@@ -510,6 +603,29 @@ export interface McpListedTool {
     readonly inputSchema: Readonly<Record<string, unknown>>;
     /** MCP's extensibility bag. Absent from most servers' tools. */
     readonly _meta?: Readonly<Record<string, unknown>>;
+    /**
+     * What the tool's `structuredContent` must match. Read for the one reason the
+     * SDK's `Client` reads it: a tool that declares one must answer with
+     * matching `structuredContent` (see `McpClient.tools()` for a paged list).
+     */
+    readonly outputSchema?: Readonly<Record<string, unknown>>;
+    /** How the tool may run: `taskSupport: 'required'` means only as a task, never a plain `tools/call`. */
+    readonly execution?: {
+        readonly taskSupport?: string;
+    };
+}
+/**
+ * A JSON Schema validator, as the MCP SDK's `Client` takes one
+ * (`jsonSchemaValidator`): `getValidator(schema)` compiles a schema once and
+ * returns a function that checks one value against it. Typed STRUCTURALLY so
+ * this declaration never references the optional peer; the SDK's own
+ * `AjvJsonSchemaValidator` and `CfWorkerJsonSchemaValidator` satisfy it.
+ */
+export interface McpJsonSchemaValidator {
+    getValidator(schema: object): (input: unknown) => {
+        readonly valid: boolean;
+        readonly errorMessage?: string;
+    };
 }
 /**
  * What `tools/call` can answer with — **a union, because the protocol is one.**