@george43g/mcp-kit 2.0.0 → 3.1.0

package/README.md

@@ -4,8 +4,167 @@ MCP server building blocks: a tool registry, a dispatcher with timeout / perf /
 abort / error-wrapping baked in, stdio + Streamable HTTP transports, `sanitize()`
 for untrusted content, and UUID-gated prompt-injection helpers.
 
-Not yet on npm. It is vendored into generated repos today; see `DEFERRED.md` #25
-in the template repo for the publish sequence.
+Peers: `zod` ^4 and `@george43g/robustness`. Upgrading from 2.x? See
+[Migrating from 2.x](#migrating-from-2x-to-300) — the wire schemas changed dialect.
+
+## Schemas: one Zod definition, JSON Schema 2020-12 on the wire
+
+Each tool declares a Zod `input` and `output`. `makeRegistry()` derives both
+wire schemas from them with `toMcpSchema()`; there is no hand-written JSON
+Schema path, so the schema a client sees cannot drift from the validator the
+dispatcher runs.
+
+```ts
+import { toMcpSchema } from "@george43g/mcp-kit";
+
+toMcpSchema(NoopInputSchema, "input", "noop");
+// → { type: "object", properties: { … }, required: [ … ] }   (no "$schema")
+```
+
+- **Dialect 2020-12, `$schema` stripped.** 2020-12 is MCP's default dialect,
+  and a schema with no label gives no client a dialect to refuse. mcp-kit 2.x
+  emitted draft-07 via `zod-to-json-schema`, and Claude Code 2.1.292 throws on
+  `"$schema": "http://json-schema.org/draft-07/schema#"` — every 2.x tool broke.
+- **`io` is real.** `inputSchema` describes what a caller may send (a
+  `.default()` field is optional); `outputSchema` describes what parsing yields
+  (that field is required, and objects carry `additionalProperties: false`).
+- **Unrepresentable types throw at `makeRegistry()`**, naming the tool:
+  `z.date()`, `z.bigint()`, an output-side `.transform()`. Use an ISO string, a
+  number, or move the transform out of the schema.
+- **The top level must be a `z.object`.** MCP requires `type: "object"`.
+- **Recursive schemas keep `$defs` / `$ref`** (or a root `$ref: "#"`): a cycle
+  cannot be inlined. That is valid 2020-12, and the conformance helper below
+  compiles it.
+
+## Per-request tool filter (scope gating)
+
+```ts
+const registry = makeRegistry(tools, {
+  filter: (tool, ctx) =>
+    !tool.name.startsWith("gmail_send") || (ctx.authInfo?.scopes.includes("gmail.send") ?? false),
+});
+
+server.setRequestHandler(ListToolsRequestSchema, async (_req, extra) => ({
+  tools: registry.toMcpTools(includeDevOnly, extra),
+}));
+server.setRequestHandler(CallToolRequestSchema, async (req, extra) =>
+  dispatch(req.params.name, req.params.arguments ?? {}, extra.signal, extra),
+);
+```
+
+- The filter lives on the **registry**, so the listing and the dispatcher apply
+  the same predicate. A refused call answers **exactly like an unknown tool**.
+  Hiding a tool from `tools/list` while it still answers by name is the hole
+  `devOnly` fell into once.
+- `ctx` is `{ authInfo?, sessionId?, requestInfo? }` — a subset of the SDK's
+  `RequestHandlerExtra`, so pass `extra` straight through. In-process calls (a
+  CLI, a test) pass nothing and the filter sees `{}`; decide what no `authInfo`
+  means for your tools.
+- Synchronous, evaluated per request. **A throwing filter counts as `false`**.
+
+### Refusing with a reason: `{ deny }` (3.1.0)
+
+`false` makes a tool look like it does not exist, which is right when its
+existence is the secret and a dead end when the caller could fix the problem.
+Return `{ deny: "reason" }` instead and the tool is hidden from `tools/list`
+the same way, but a `tools/call` to it gets the reason:
+
+```ts
+const registry = makeRegistry(tools, {
+  filter: (tool, ctx) =>
+    hasScopes(ctx, tool.scopes) ||
+    { deny: "not available. You may need to re-authenticate with additional scopes" },
+});
+
+await dispatch("gmail_send", { to: "…" });
+// → { isError: true, content: [{ type: "text", text:
+//     'Tool "gmail_send" failed: not available. You may need to re-authenticate with additional scopes' }] }
+```
+
+- The reason is wrapped like every other dispatcher error
+  (`Tool "<name>" failed: <deny>`). Write it as a sentence an agent can act on.
+- `false` keeps the unknown-tool wording, a throw still counts as `false`, and
+  so does `{ deny: "" }`: an empty reason tells the caller nothing.
+- A gated `devOnly` tool answers as unknown even if the filter would deny it
+  with a reason; the filter is not consulted for it.
+- `registry.allows()` still returns a boolean (`false` for `{ deny }`).
+  `registry.evaluate(def, ctx)` returns `{ allowed: true }` or
+  `{ allowed: false, deny? }`. It is optional on the `ToolRegistry` type, so a
+  hand-written 3.0 registry still compiles; the dispatcher falls back to
+  `allows()` for one, and its refusals then use the unknown-tool wording.
+
+## Strict arguments: `strictArgs` (3.1.0, off by default)
+
+Zod strips an argument the schema does not declare. So when an agent misspells
+an OPTIONAL argument, the call succeeds and the handler runs on the default as
+if the argument had never been sent. Nothing tells the agent it was ignored.
+`strictArgs` refuses the call instead, before parsing and before the handler:
+
+```ts
+const registry = makeRegistry(tools, { strictArgs: true }); // every tool
+const chat: ToolDefinition = { /* … */ strictArgs: false }; // a tool opts back out
+
+await dispatch("chat_history", { chatIdentifer: "x", cursor: "c" });
+// Tool "chat_history" failed: unknown argument chatIdentifer; did you mean chatIdentifier?
+// unknown argument cursor
+// Hint: Valid arguments: chatIdentifier, limit.
+```
+
+- **Set it on the registry, override it per tool.** `ToolDefinition.strictArgs`
+  wins over `makeRegistry`'s `strictArgs` in either direction.
+- **"Unknown" means "not in the advertised `inputSchema`'s top-level
+  `properties`."** So it behaves the same for a refined or transformed
+  `z.object` and for an intersection, which Zod merges into one object.
+- **The advertised `inputSchema` does not change.** No `additionalProperties:
+  false` is added; clients see the same open schema whether this is on or off.
+- **Valid input parses exactly as before.** The check only compares argument
+  names; parsing still runs the tool's own schema, so defaults and transforms
+  are untouched.
+- **Top level only.** A nested `z.object` still strips unknown keys. To reject
+  them, declare that field `z.strictObject(…)`; Zod then reports it as
+  `Invalid arguments: … Unrecognized key: "frm"`, without a suggestion.
+- **An input that declares itself open is not checked**: `z.looseObject`,
+  `.catchall()` or `z.record` at the top level has no unknown keys.
+- A suggestion is offered when a declared name is within 2 edits (insertion,
+  deletion, substitution or swapping two adjacent letters), and those edits
+  are at most half its length. At most 20 unknown keys are named per error.
+  Echoed keys have control characters and newlines replaced.
+- `registry.unknownArgs(def, args)` returns `[{ key, suggestion? }]`, and is
+  optional on the type for the same reason as `evaluate`. Without it, the
+  dispatcher still honours a tool's own `strictArgs: true`.
+- The error text is rendered output and is not covered by semver.
+
+## Testing: `@george43g/mcp-kit/testing`
+
+```ts
+import { assertMcpConformance, validateStructured } from "@george43g/mcp-kit/testing";
+
+it("every tool is accepted by a 2020-12 client", () => {
+  assertMcpConformance(makeAppRegistry(), {
+    samples: { noop: { input: [{ input: "x" }], output: [{ echo: "x", engine: "ts", durationMicros: 1 }] } },
+  });
+});
+
+it("noop's structuredContent matches its outputSchema", async () => {
+  const result = await callMcpTool("noop", { input: "x" });
+  expect(validateStructured(noopTool, result).errors).toEqual([]);
+});
+```
+
+- `assertMcpConformance(registry | definitions | Tool[])` compiles every input
+  and output schema under **Ajv2020 in strict mode** with no draft-07
+  meta-schema loaded — so a draft-07 label fails here exactly as it failed in
+  Claude Code. It collects every problem and throws one `McpConformanceError`.
+  A registry is checked in full: devOnly and filtered tools too.
+- `validateStructured(tool, result)` is the SDK client's own `tools/call` check:
+  structured content required unless `isError`, and validated against
+  `outputSchema` when present. It returns `{ valid, errors }`.
+- `ajv` / `ajv-formats` are dependencies of this package, imported only by this
+  entry. `@modelcontextprotocol/sdk` already depends on both, so they add nothing
+  to an install, and a server that never imports `/testing` never loads them.
+- `allowUnionTypes` is on: `type: ["string", "number"]` is valid 2020-12 (Zod
+  emits it for `z.union([z.string(), z.number()])`); Ajv's strict mode flags it
+  only as style.
 
 ## The dispatcher is the point
 
@@ -128,6 +287,60 @@ The marker matters more than it looks: a **silently** shortened document is
 indistinguishable from a document that really ended there, and a model reading it
 will answer confidently from the fragment it received.
 
+## Migrating from 2.x to 3.0.0
+
+**Why:** 2.x emitted draft-07 JSON Schema, and Claude Code 2.1.292+ (a
+2020-12-only client) throws on it, so every tool from every 2.x server failed in
+new sessions. 3.0.0 moves to Zod 4's native converter and 2020-12.
+
+Breaking changes, each with its migration:
+
+1. **`zod` is a peer, `^4`** (was a dependency, `^3.23`). Install `zod@^4` in
+   your app and drop `zod-to-json-schema`. Zod 4's `zod` root keeps `z.object`,
+   `.describe()`, `.default()`, `z.enum`, `z.infer`; see Zod's own v4 migration
+   guide for `.errors` → `.issues`, `z.string().email()` → `z.email()` (the old
+   form still works), and error-map changes.
+2. **Wire schemas are JSON Schema 2020-12 with no `$schema`** (were draft-07,
+   labelled). Clients that pinned draft-07 behaviour see 2020-12 keywords:
+   `prefixItems` for tuples, `$defs` for recursion. Nothing to do unless you
+   post-process `inputSchema` — and if you stripped `$schema` yourself as a
+   hot-fix, delete that code.
+3. **Input objects are open; output objects stay closed.** `inputSchema` is
+   the input side of the schema (`io: "input"`) and no longer carries
+   `additionalProperties: false`, so a client may send extra keys — the
+   dispatcher's Zod parse strips them, as before. `.default()` fields stay
+   optional on input (unchanged) and required on output. `outputSchema` keeps
+   `additionalProperties: false`, as in 2.x.
+4. **`makeRegistry()` throws at construction for an unrepresentable schema**,
+   naming the tool: `z.date()`, `z.bigint()`, `z.map()`, `z.set()`,
+   `z.symbol()`, `z.undefined()`, an output-side `.transform()`. 2.x emitted a
+   best-effort schema silently — `z.date()` became `{type: "string", format:
+   "date-time"}`, `z.map()` an array of pairs. **The common case is a `z.date()`
+   output field:** return `date.toISOString()` and declare
+   `z.string().datetime()` (or `z.iso.datetime()`).
+5. **`makeRegistry()` throws when a tool's input or output is not a
+   `z.object`** (MCP requires `type: "object"`). Wrap the value:
+   `z.object({ result: … })`.
+6. **`ToolRegistry` has a new required member, `allows(def, ctx?)`**, and
+   `toMcpTools()` takes an optional second argument. Only a hand-written
+   `ToolRegistry` implementation breaks; build it with `makeRegistry()`.
+7. **"Invalid arguments" text changes wording**: the per-field lines come from
+   Zod 4's messages (`Invalid input: expected string, received number`, was
+   `Expected string, received number`). Rendered output is not covered by
+   semver; listed because a test that snapshots the text will notice.
+8. **The SDK dependency floor is unchanged (`^1.29.0`)** — 1.29 already accepts
+   `zod ^3.25 || ^4`. Listed so nobody hunts for it.
+
+Additive, no action needed: `toMcpSchema()`, the registry `filter` option and
+the `ctx` argument to `dispatch`, and the `@george43g/mcp-kit/testing` entry.
+
+Add one test so this never regresses silently:
+
+```ts
+import { assertMcpConformance } from "@george43g/mcp-kit/testing";
+it("tools conform", () => void assertMcpConformance(makeAppRegistry()));
+```
+
 ## Upgrading to 1.0.0
 
 **One breaking change, and it affects you only if you register `devOnly` tools.**

package/dist/dispatch.d.ts

@@ -17,7 +17,7 @@
  * The exported `buildDispatcher` returns a function whose shape matches the
  * SDK's `CallToolRequest` handler.
  */
-import type { ContentBlock, ToolRegistry } from "./tool-registry.js";
+import { type ContentBlock, type ToolFilterContext, type ToolRegistry } from "./tool-registry.js";
 export interface ToolResult {
     content: ContentBlock[];
     structuredContent?: unknown;
@@ -73,6 +73,14 @@ export interface BuildDispatcherOptions {
      */
     devOnlyEnabled?: () => boolean;
 }
-export type Dispatch = (name: string, args: unknown, signal?: AbortSignal) => Promise<ToolResult>;
+/**
+ * Call a tool by name.
+ *
+ * `ctx` is what the registry's `filter` (see `makeRegistry`) is evaluated
+ * against. From an MCP `tools/call` handler, pass the handler's `extra`:
+ * `dispatch(name, args, extra.signal, extra)`. An in-process caller omits it,
+ * and the filter sees `{}`.
+ */
+export type Dispatch = (name: string, args: unknown, signal?: AbortSignal, ctx?: ToolFilterContext) => Promise<ToolResult>;
 export declare function buildDispatcher(opts: BuildDispatcherOptions): Dispatch;
 //# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAeH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAgCrE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,YAAY,CAAC;IACvB,gFAAgF;IAChF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACnD,sEAAsE;IACtE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;CAChC;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAUlG,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,QAAQ,CA6GtE"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAeH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAEtB,KAAK,YAAY,EAGlB,MAAM,oBAAoB,CAAC;AAiC5B,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,YAAY,CAAC;IACvB,gFAAgF;IAChF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACnD,sEAAsE;IACtE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,CACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,WAAW,EACpB,GAAG,CAAC,EAAE,iBAAiB,KACpB,OAAO,CAAC,UAAU,CAAC,CAAC;AA8CzB,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,QAAQ,CA2JtE"}

package/dist/dispatch.js

@@ -21,6 +21,8 @@ import { homedir } from "node:os";
 import { envNum, error as logError, warn as logWarn, noteActivity, perf, ToolTimeoutError, withTimeout, } from "@george43g/robustness";
 import { wrapToolError } from "./prompt-injection.js";
 import { sanitize } from "./sanitize.js";
+import { toMcpSchema, } from "./tool-registry.js";
+import { declaredArgs, findUnknownArgs } from "./unknown-args.js";
 /**
  * Replace the absolute home-directory prefix with `~` in anything headed for a
  * log sink.
@@ -55,7 +57,40 @@ function defaultTimeoutMs() {
     return envNum("MCP_TOOL_TIMEOUT_DEFAULT_MS", 30_000);
 }
 function formatZodError(err) {
-    return err.errors.map((e) => `  - ${e.path.join(".") || "(root)"}: ${e.message}`).join("\n");
+    return err.issues
+        .map((e) => `  - ${e.path.map(String).join(".") || "(root)"}: ${e.message}`)
+        .join("\n");
+}
+/** At most this many unknown keys are named in one error; the rest are counted. */
+const MAX_UNKNOWN_REPORTED = 20;
+function formatUnknownArgs(unknown) {
+    const lines = unknown.slice(0, MAX_UNKNOWN_REPORTED).map(({ key, suggestion }) => {
+        // The key is caller-supplied and echoed back: neutralise control characters,
+        // including the newlines sanitize() keeps, so a key cannot forge a line.
+        const shown = (sanitize(key, 128) ?? "").replace(/[\t\n\r]/g, "\uFFFD");
+        return suggestion === undefined
+            ? `unknown argument ${shown}`
+            : `unknown argument ${shown}; did you mean ${suggestion}?`;
+    });
+    const rest = unknown.length - MAX_UNKNOWN_REPORTED;
+    if (rest > 0)
+        lines.push(`and ${rest} more unknown argument(s)`);
+    return lines.join("\n");
+}
+// Declared top-level argument names per definition, derived from the wire
+// input schema on first need. Weak so a definition can still be collected.
+const declaredCache = new WeakMap();
+function declaredFor(def) {
+    if (!declaredCache.has(def)) {
+        declaredCache.set(def, declaredArgs(toMcpSchema(def.input, "input", def.name)));
+    }
+    return declaredCache.get(def) ?? null;
+}
+function unknownArgsHint(def) {
+    const declared = declaredFor(def) ?? [];
+    return declared.length === 0
+        ? "This tool takes no arguments."
+        : `Valid arguments: ${declared.join(", ")}.`;
 }
 export function buildDispatcher(opts) {
     // Make the ambiguous state unrepresentable, at construction, before a single
@@ -72,7 +107,22 @@ export function buildDispatcher(opts) {
         }
     }
     const fallback = defaultTimeoutMs();
-    return async (name, args, signal) => {
+    const { registry } = opts;
+    // A registry built by `makeRegistry()` has both methods; a hand-written one
+    // from 3.0 may not, and still gets the boolean gate and per-tool strictArgs.
+    const evaluate = (def, ctx) => registry.evaluate
+        ? registry.evaluate(def, ctx)
+        : registry.allows(def, ctx)
+            ? { allowed: true }
+            : { allowed: false };
+    const unknownArgs = (def, args) => {
+        if (registry.unknownArgs)
+            return registry.unknownArgs(def, args);
+        if (def.strictArgs !== true)
+            return [];
+        return findUnknownArgs(declaredFor(def), args);
+    };
+    return async (name, args, signal, ctx = {}) => {
         noteActivity();
         opts.onCall?.(name);
         const def = opts.registry.get(name);
@@ -84,7 +134,21 @@ export function buildDispatcher(opts) {
         // construction, which the readonly type discourages but does not prevent.
         // If that ever happens the tool is gated, not exposed.
         const devGated = def?.devOnly === true && !(opts.devOnlyEnabled?.() ?? false);
-        if (!def || devGated) {
+        // The registry's per-request filter gates the CALL path with the same
+        // predicate that gates the listing. Hiding a tool from tools/list while it
+        // still answers by name is the hole `devOnly` already fell into once.
+        // Evaluated only for a tool that exists and is not dev-gated, so a deny
+        // reason can never reveal a dev-only tool.
+        const decision = def !== undefined && !devGated ? evaluate(def, ctx) : { allowed: false };
+        // `{ deny }`: the filter chose to tell the caller why, so it can recover.
+        if (!decision.allowed && decision.deny !== undefined) {
+            opts.onError?.(name, new Error("tool_denied"));
+            return {
+                content: [{ type: "text", text: wrapToolError(name, decision.deny) }],
+                isError: true,
+            };
+        }
+        if (!def || !decision.allowed) {
             opts.onError?.(name, new Error("unknown_tool"));
             return {
                 content: [
@@ -96,6 +160,21 @@ export function buildDispatcher(opts) {
                 isError: true,
             };
         }
+        // strictArgs: refuse an undeclared argument name before parsing, because
+        // parsing would strip it silently and run the handler without it.
+        const unknown = unknownArgs(def, args ?? {});
+        if (unknown.length > 0) {
+            opts.onError?.(name, new Error("unknown_arguments"));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: wrapToolError(name, formatUnknownArgs(unknown), unknownArgsHint(def)),
+                    },
+                ],
+                isError: true,
+            };
+        }
         const parsed = def.input.safeParse(args ?? {});
         if (!parsed.success) {
             opts.onError?.(name, parsed.error);

package/dist/dispatch.js.map

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

package/dist/index.d.ts

@@ -4,8 +4,8 @@ export { type WrapInstructionsResult, wrapInstructions, wrapToolError, wrapUntru
 export type { BuildResourcesHandlerOptions, ResourceContent, ResourceHandlers, ResourceListEntry, ResourcesProvider, ResourceTemplate, } from "./resources.js";
 export { buildResourcesHandler } from "./resources.js";
 export { CONTENT_BUDGET, sanitize, sanitizeContent } from "./sanitize.js";
-export type { AnyToolDefinition, ContentBlock, ToolDefinition, ToolRegistry, } from "./tool-registry.js";
-export { makeRegistry } from "./tool-registry.js";
+export type { AnyToolDefinition, AnyZodSchema, ContentBlock, MakeRegistryOptions, McpJsonSchema, McpSchemaIo, ToolDefinition, ToolDeny, ToolFilter, ToolFilterContext, ToolFilterDecision, ToolFilterResult, ToolRegistry, UnknownArgument, } from "./tool-registry.js";
+export { makeRegistry, toMcpSchema } from "./tool-registry.js";
 export type { HttpServerHandle, HttpServerOptions } from "./transports/http.js";
 export { startHttpServer } from "./transports/http.js";
 export type { StartStdioOptions } from "./transports/stdio.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,QAAQ,EACR,kBAAkB,EAClB,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACL,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,4BAA4B,EAC5B,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1E,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,QAAQ,EACR,kBAAkB,EAClB,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACL,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,4BAA4B,EAC5B,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1E,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,cAAc,EACd,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -2,7 +2,7 @@ export { buildDispatcher } from "./dispatch.js";
 export { wrapInstructions, wrapToolError, wrapUntrusted, } from "./prompt-injection.js";
 export { buildResourcesHandler } from "./resources.js";
 export { CONTENT_BUDGET, sanitize, sanitizeContent } from "./sanitize.js";
-export { makeRegistry } from "./tool-registry.js";
+export { makeRegistry, toMcpSchema } from "./tool-registry.js";
 export { startHttpServer } from "./transports/http.js";
 export { startStdio } from "./transports/stdio.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAEL,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,uBAAuB,CAAC;AAS/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAO1E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAEL,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,uBAAuB,CAAC;AAS/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAiB1E,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,89 @@
+/**
+ * `@george43g/mcp-kit/testing` — MCP wire-conformance checks for a consumer's
+ * test suite.
+ *
+ * Two questions, each one a client has actually failed on:
+ *
+ *  1. Does every tool's `inputSchema` / `outputSchema` compile in a client that
+ *     only speaks JSON Schema 2020-12? (`assertMcpConformance`) Claude Code
+ *     2.1.292 refused every mcp-kit 2.x tool because the schemas were labelled
+ *     draft-07.
+ *  2. Does a tool's `structuredContent` satisfy its own `outputSchema`?
+ *     (`validateStructured`) The SDK client runs exactly this check on every
+ *     `tools/call` and turns a mismatch into an error.
+ *
+ * A separate entry so Ajv is never loaded by a running server: nothing under
+ * the main entry imports this file. `ajv` and `ajv-formats` are regular
+ * dependencies of the package rather than optional peers because
+ * `@modelcontextprotocol/sdk` already depends on both (^8.17.1 / ^3.0.1) — they
+ * are in every consumer's install already, so declaring them adds no package,
+ * and a consumer's vitest needs no extra devDependency to use this entry.
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { type AnyToolDefinition, type ToolRegistry } from "./tool-registry.js";
+/** Anything `assertMcpConformance` can check: a registry, its definitions, or a wire `tools/list`. */
+export type ConformanceSource = ToolRegistry | readonly AnyToolDefinition[] | readonly Tool[];
+/** Known-good values for one tool. Each must validate against the tool's wire schema. */
+export interface ConformanceSamples {
+    input?: readonly unknown[];
+    output?: readonly unknown[];
+}
+export interface ConformanceOptions {
+    /**
+     * Known-good values per tool name. Input samples are validated against
+     * `inputSchema`, output samples against `outputSchema` — under Ajv, i.e. as
+     * a client sees them. Catches a schema that compiles but rejects real data.
+     * A sample for a tool name that is not in the source is itself a failure, so
+     * a renamed tool cannot silently stop being checked.
+     */
+    samples?: Readonly<Record<string, ConformanceSamples>>;
+}
+export interface ConformanceReport {
+    /** Names of the tools checked, in source order. */
+    tools: string[];
+}
+export interface StructuredValidation {
+    valid: boolean;
+    /** One line per problem; empty when `valid`. */
+    errors: string[];
+}
+/** Thrown by `assertMcpConformance`; `problems` holds one line per failure. */
+export declare class McpConformanceError extends Error {
+    readonly problems: readonly string[];
+    constructor(problems: readonly string[]);
+}
+/**
+ * Throw `McpConformanceError` unless every tool's schemas would be accepted by a
+ * JSON Schema 2020-12 client, and every sample validates.
+ *
+ * Collects every problem before throwing, so one run shows them all.
+ *
+ * A `ToolRegistry` is checked in full — devOnly tools included and its
+ * `filter` ignored — because a hidden tool still ships a schema somebody's
+ * client will compile.
+ *
+ * Pass the result of a real `tools/list` (`Tool[]`) to check the wire output
+ * itself; pass definitions or a registry to check what `toMcpSchema` would emit.
+ */
+export declare function assertMcpConformance(source: ConformanceSource, opts?: ConformanceOptions): ConformanceReport;
+/**
+ * Check a `tools/call` result the way the SDK client does before handing it to
+ * the model:
+ *
+ * - a tool with an `outputSchema` must return `structuredContent` unless the
+ *   result is an error;
+ * - `structuredContent`, when present, must validate against `outputSchema`
+ *   (under Ajv2020, strict).
+ *
+ * A tool with no `outputSchema` has nothing to check and is always valid.
+ * Accepts the wire `Tool` (from `tools/list`) or a `ToolDefinition`.
+ *
+ * Returns rather than throws, so a test reads
+ * `expect(validateStructured(tool, result).errors).toEqual([])` and the diff
+ * shows the reason.
+ */
+export declare function validateStructured(tool: Tool | AnyToolDefinition, result: {
+    structuredContent?: unknown;
+    isError?: boolean | undefined;
+} | Record<string, unknown>): StructuredValidation;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG/D,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAU5B,sGAAsG;AACtG,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,SAAS,iBAAiB,EAAE,GAAG,SAAS,IAAI,EAAE,CAAC;AAE9F,yFAAyF;AACzF,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,gDAAgD;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,+EAA+E;AAC/E,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;gBACzB,QAAQ,EAAE,SAAS,MAAM,EAAE;CAOxC;AAuFD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,iBAAiB,EACzB,IAAI,GAAE,kBAAuB,GAC5B,iBAAiB,CA4DnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,GAAG,iBAAiB,EAG9B,MAAM,EAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/F,oBAAoB,CAmCtB"}