@cyanheads/mcp-ts-core 0.11.0 → 0.11.2

package/dist/storage/providers/inMemory/inMemoryProvider.js

@@ -1,5 +1,5 @@
 import { decodeCursor, encodeCursor } from '../../../storage/core/storageValidation.js';
-import { JsonRpcErrorCode, McpError } from '../../../types-global/errors.js';
+import { configurationError, JsonRpcErrorCode, McpError } from '../../../types-global/errors.js';
 import { logger } from '../../../utils/internal/logger.js';
 const DEFAULT_LIST_LIMIT = 1000;
 const DEFAULT_MAX_ENTRIES = 10_000;
@@ -8,19 +8,23 @@ export class InMemoryProvider {
     maxEntries;
     entryCount = 0;
     constructor(options) {
-        this.maxEntries = options?.maxEntries ?? DEFAULT_MAX_ENTRIES;
+        const maxEntries = options?.maxEntries ?? DEFAULT_MAX_ENTRIES;
+        if (!Number.isSafeInteger(maxEntries) || maxEntries < 0) {
+            throw configurationError('InMemoryProvider maxEntries must be a non-negative safe integer.');
+        }
+        this.maxEntries = maxEntries;
     }
     /** Returns the total number of entries across all tenants. */
     get size() {
         return this.entryCount;
     }
-    getTenantStore(tenantId) {
-        let tenantStore = this.store.get(tenantId);
-        if (!tenantStore) {
-            tenantStore = new Map();
-            this.store.set(tenantId, tenantStore);
-        }
-        return tenantStore;
+    getOrCreateTenantStore(tenantId) {
+        const existing = this.store.get(tenantId);
+        if (existing)
+            return existing;
+        const created = new Map();
+        this.store.set(tenantId, created);
+        return created;
     }
     /** Sweeps all tenant stores and removes expired entries, returning the count reclaimed. */
     sweepExpired() {
@@ -44,21 +48,24 @@ export class InMemoryProvider {
      * Ensures capacity for a new entry. If at limit, runs a TTL sweep first.
      * If still at capacity after sweep, throws.
      */
-    ensureCapacity() {
-        if (this.entryCount < this.maxEntries)
+    ensureCapacity(additionalEntries = 1) {
+        if (this.entryCount + additionalEntries <= this.maxEntries)
             return;
         const reclaimed = this.sweepExpired();
         if (reclaimed > 0) {
             logger.debug(`[InMemoryProvider] TTL sweep reclaimed ${reclaimed} expired entries`);
         }
-        if (this.entryCount >= this.maxEntries) {
+        if (this.entryCount + additionalEntries > this.maxEntries) {
             throw new McpError(JsonRpcErrorCode.InternalError, `In-memory storage capacity exceeded (max: ${this.maxEntries}). ` +
                 'Consider increasing maxEntries, adding TTLs to entries, or switching to a persistent provider.');
         }
     }
     get(tenantId, key, context) {
         logger.debug(`[InMemoryProvider] Getting key: ${key} for tenant: ${tenantId}`, context);
-        const tenantStore = this.getTenantStore(tenantId);
+        const tenantStore = this.store.get(tenantId);
+        if (!tenantStore) {
+            return Promise.resolve(null);
+        }
         const entry = tenantStore.get(key);
         if (!entry) {
             return Promise.resolve(null);
@@ -66,6 +73,8 @@ export class InMemoryProvider {
         if (entry.expiresAt && Date.now() > entry.expiresAt) {
             tenantStore.delete(key);
             this.entryCount--;
+            if (tenantStore.size === 0)
+                this.store.delete(tenantId);
             logger.debug(`[InMemoryProvider] Key expired and removed: ${key} for tenant: ${tenantId}`, context);
             return Promise.resolve(null);
         }
@@ -73,11 +82,12 @@ export class InMemoryProvider {
     }
     set(tenantId, key, value, context, options) {
         logger.debug(`[InMemoryProvider] Setting key: ${key} for tenant: ${tenantId}`, context);
-        const tenantStore = this.getTenantStore(tenantId);
-        const isNew = !tenantStore.has(key);
+        let tenantStore = this.store.get(tenantId);
+        const isNew = !tenantStore?.has(key);
         if (isNew) {
             this.ensureCapacity();
         }
+        tenantStore ??= this.getOrCreateTenantStore(tenantId);
         // Fix: Check for undefined instead of truthy to handle ttl=0 correctly
         const expiresAt = options?.ttl !== undefined ? Date.now() + options.ttl * 1000 : undefined;
         tenantStore.set(key, {
@@ -91,10 +101,14 @@ export class InMemoryProvider {
     }
     delete(tenantId, key, context) {
         logger.debug(`[InMemoryProvider] Deleting key: ${key} for tenant: ${tenantId}`, context);
-        const tenantStore = this.getTenantStore(tenantId);
+        const tenantStore = this.store.get(tenantId);
+        if (!tenantStore)
+            return Promise.resolve(false);
         const deleted = tenantStore.delete(key);
         if (deleted) {
             this.entryCount--;
+            if (tenantStore.size === 0)
+                this.store.delete(tenantId);
         }
         return Promise.resolve(deleted);
     }
@@ -103,7 +117,14 @@ export class InMemoryProvider {
             ...context,
             options,
         });
-        const tenantStore = this.getTenantStore(tenantId);
+        // Authenticate tenant-bound cursors before an empty-namespace fast path.
+        // Otherwise a cursor issued to another tenant is silently accepted whenever
+        // the requested tenant has no entries.
+        const lastKey = options?.cursor ? decodeCursor(options.cursor, tenantId, context) : undefined;
+        const tenantStore = this.store.get(tenantId);
+        if (!tenantStore) {
+            return Promise.resolve({ keys: [], nextCursor: undefined });
+        }
         const now = Date.now();
         const allKeys = [];
         // Collect all matching non-expired keys
@@ -118,14 +139,14 @@ export class InMemoryProvider {
                 }
             }
         }
+        if (tenantStore.size === 0)
+            this.store.delete(tenantId);
         // Sort for consistent pagination
         allKeys.sort();
         // Apply pagination with opaque cursors
         const limit = options?.limit ?? DEFAULT_LIST_LIMIT;
         let startIndex = 0;
-        if (options?.cursor) {
-            // Decode and validate cursor
-            const lastKey = decodeCursor(options.cursor, tenantId, context);
+        if (lastKey) {
             const cursorIndex = allKeys.indexOf(lastKey);
             if (cursorIndex !== -1) {
                 startIndex = cursorIndex + 1;
@@ -163,14 +184,33 @@ export class InMemoryProvider {
         logger.debug(`[InMemoryProvider] Retrieved ${results.size}/${keys.length} keys for tenant: ${tenantId}`, context);
         return results;
     }
+    // biome-ignore lint/suspicious/useAwait: async is required by IStorageProvider; the in-memory batch write is synchronous.
     async setMany(tenantId, entries, context, options) {
         if (entries.size === 0) {
             return;
         }
         logger.debug(`[InMemoryProvider] Setting ${entries.size} keys for tenant: ${tenantId}`, context);
-        // Parallel set for better performance
-        const promises = Array.from(entries.entries()).map(([key, value]) => this.set(tenantId, key, value, context, options));
-        await Promise.all(promises);
+        // Expired entries must be removed before computing the batch delta. If an
+        // expired key is present in this batch, counting it as an overwrite and
+        // sweeping it later can undercount additions and exceed maxEntries.
+        this.sweepExpired();
+        let tenantStore = this.store.get(tenantId);
+        let newEntryCount = 0;
+        for (const key of entries.keys()) {
+            if (!tenantStore?.has(key))
+                newEntryCount++;
+        }
+        // Preflight the complete batch so capacity failures cannot partially commit.
+        this.ensureCapacity(newEntryCount);
+        tenantStore ??= this.getOrCreateTenantStore(tenantId);
+        const expiresAt = options?.ttl !== undefined ? Date.now() + options.ttl * 1000 : undefined;
+        for (const [key, value] of entries) {
+            tenantStore.set(key, {
+                value,
+                ...(expiresAt !== undefined && { expiresAt }),
+            });
+        }
+        this.entryCount += newEntryCount;
         logger.debug(`[InMemoryProvider] Successfully set ${entries.size} keys for tenant: ${tenantId}`, context);
     }
     async deleteMany(tenantId, keys, context) {
@@ -187,9 +227,11 @@ export class InMemoryProvider {
     }
     clear(tenantId, context) {
         logger.debug(`[InMemoryProvider] Clearing all keys for tenant: ${tenantId}`, context);
-        const tenantStore = this.getTenantStore(tenantId);
+        const tenantStore = this.store.get(tenantId);
+        if (!tenantStore)
+            return Promise.resolve(0);
         const count = tenantStore.size;
-        tenantStore.clear();
+        this.store.delete(tenantId);
         this.entryCount -= count;
         logger.info(`[InMemoryProvider] Cleared ${count} keys for tenant: ${tenantId}`, context);
         return Promise.resolve(count);

package/dist/storage/providers/inMemory/inMemoryProvider.js.map

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

package/dist/testing/fuzz.d.ts

@@ -33,6 +33,10 @@ export interface FuzzOptions {
  * Converts a Zod schema to a fast-check `Arbitrary` that produces valid values.
  * Supports the JSON-Schema-serializable subset used by MCP tool/resource schemas.
  *
+ * Finite nesting is expanded in full, however deep. A self-referential schema —
+ * Zod 4's getter pattern, where reading `.shape` re-enters the same node —
+ * terminates at the point of recursion with an absence the schema accepts.
+ *
  * Requires `fast-check` to be loaded first — call from within a `fuzzTool()`/
  * `fuzzResource()`/`fuzzPrompt()` run, or call `loadFc()` before standalone use.
  */
@@ -68,7 +72,7 @@ export interface FuzzReport {
  * Designed to be called inside a `describe()` / `it()` block.
  *
  * Checks:
- * 1. Valid inputs -> handler runs without crash, output matches schema
+ * 1. Valid inputs -> handler returns schema-valid output or a well-formed MCP error
  * 2. Adversarial inputs -> Zod rejects or handler errors gracefully
  * 3. No prototype pollution on Object.prototype
  * 4. No stack trace / path leaks in error messages

package/dist/testing/fuzz.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fuzz.d.ts","sourceRoot":"","sources":["../../src/testing/fuzz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAalD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAC1F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAChG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAQxE,wMAAwM;AACxM,wBAAsB,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAGjD;AAiBD,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,GAAG,CAAC,EAAE,kBAAkB,CAAC;IACzB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAwBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAErE;AA2HD,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAwDvC,CAAC;AAEX,6EAA6E;AAC7E,wBAAgB,oBAAoB,IAAI,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CA6B5D;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,GAC7B,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAUvC;AA2DD,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,gFAAgF;IAChF,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACnD,4DAA4D;IAC5D,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,sDAAsD;IACtD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,iBAAiB,EACtB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAkGrB;AAMD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,qBAAqB,EAC1B,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CA+ErB;AAMD;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,mBAAmB,EACxB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAsErB"}
+{"version":3,"file":"fuzz.d.ts","sourceRoot":"","sources":["../../src/testing/fuzz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAalD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAC1F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAChG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAEpF,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAQxE,wMAAwM;AACxM,wBAAsB,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAGjD;AAiBD,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,GAAG,CAAC,EAAE,kBAAkB,CAAC;IACzB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAmCD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAErE;AA6LD,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAwDvC,CAAC;AAEX,6EAA6E;AAC7E,wBAAgB,oBAAoB,IAAI,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CA6B5D;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,GAC7B,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAUvC;AAiHD,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,gFAAgF;IAChF,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACnD,4DAA4D;IAC5D,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,sDAAsD;IACtD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,iBAAiB,EACtB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CA8FrB;AAMD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,qBAAqB,EAC1B,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CA2ErB;AAMD;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,mBAAmB,EACxB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAsErB"}

package/dist/testing/fuzz.js

@@ -9,6 +9,7 @@
  * @module src/testing/fuzz
  */
 import { ZodArray, ZodBoolean, ZodDefault, ZodEnum, ZodLiteral, ZodNullable, ZodNumber, ZodOptional, ZodString, ZodUnion, } from 'zod';
+import { McpError } from '../types-global/errors.js';
 import { createMockContext } from './index.js';
 // ---------------------------------------------------------------------------
 // Lazy-loaded peer dependency
@@ -46,32 +47,69 @@ function zodTypeName(schema) {
 // ---------------------------------------------------------------------------
 // Zod → fast-check arbitrary generation
 // ---------------------------------------------------------------------------
+/** Elements generated for an array with no declared upper bound. */
+const DEFAULT_ARRAY_MAX = 5;
+/**
+ * Nesting levels expanded before a node is treated as non-terminating. Cycle
+ * detection catches self-referential schemas by identity; this is the backstop
+ * for a schema whose getters mint a fresh node on every access, where there is
+ * no repeated identity to detect.
+ */
+const MAX_SCHEMA_DEPTH = 32;
 /**
  * Converts a Zod schema to a fast-check `Arbitrary` that produces valid values.
  * Supports the JSON-Schema-serializable subset used by MCP tool/resource schemas.
  *
+ * Finite nesting is expanded in full, however deep. A self-referential schema —
+ * Zod 4's getter pattern, where reading `.shape` re-enters the same node —
+ * terminates at the point of recursion with an absence the schema accepts.
+ *
  * Requires `fast-check` to be loaded first — call from within a `fuzzTool()`/
  * `fuzzResource()`/`fuzzPrompt()` run, or call `loadFc()` before standalone use.
  */
 export function zodToArbitrary(schema) {
-    return zodNodeToArbitrary(schema, 0);
+    return zodNodeToArbitrary(schema, new Set(), 0) ?? getFc().constant(null);
+}
+/**
+ * Expands one schema node, tracking the nodes on the current path so recursion
+ * is distinguished from finite nesting.
+ *
+ * Returns `undefined` when the node cannot yield a finite value — it re-enters
+ * itself, or nesting passed `MAX_SCHEMA_DEPTH`. Callers turn that into a
+ * schema-valid absence where one exists (`[]`, omitted optional, `null`), and
+ * propagate it otherwise, so a generated sample never carries an invalid value
+ * at an arbitrary position.
+ */
+function zodNodeToArbitrary(schema, path, depth) {
+    if (depth > MAX_SCHEMA_DEPTH)
+        return;
+    if (typeof schema !== 'object' || schema === null)
+        return expandNode(schema, path, depth);
+    if (path.has(schema))
+        return;
+    path.add(schema);
+    try {
+        return expandNode(schema, path, depth);
+    }
+    finally {
+        path.delete(schema);
+    }
 }
-function zodNodeToArbitrary(schema, depth) {
+function expandNode(schema, path, depth) {
     const f = getFc();
-    if (depth > 6)
-        return f.constant(null);
-    // Unwrap wrappers — cast through any to avoid Zod 4 $ZodType vs ZodType mismatch
+    // Unwrap wrappers — cast through any to avoid Zod 4 $ZodType vs ZodType mismatch.
+    // A wrapper whose inner node cannot terminate collapses to the absence it permits.
     if (schema instanceof ZodOptional) {
-        return f.option(zodNodeToArbitrary(schema.unwrap(), depth), { nil: undefined });
+        const inner = zodNodeToArbitrary(schema.unwrap(), path, depth);
+        return inner ? f.option(inner, { nil: undefined }) : f.constant(undefined);
     }
     if (schema instanceof ZodNullable) {
-        return f.option(zodNodeToArbitrary(schema.unwrap(), depth), { nil: null });
+        const inner = zodNodeToArbitrary(schema.unwrap(), path, depth);
+        return inner ? f.option(inner, { nil: null }) : f.constant(null);
     }
     if (schema instanceof ZodDefault) {
-        return f.option(zodNodeToArbitrary(schema.removeDefault(), depth), {
-            nil: undefined,
-            freq: 5,
-        });
+        const inner = zodNodeToArbitrary(schema.removeDefault(), path, depth);
+        return inner ? f.option(inner, { nil: undefined, freq: 5 }) : f.constant(undefined);
     }
     // Primitives
     if (schema instanceof ZodString || zodTypeName(schema) === 'string') {
@@ -93,17 +131,20 @@ function zodNodeToArbitrary(schema, depth) {
     }
     // Array
     if (schema instanceof ZodArray) {
-        const s = schema;
-        const minLen = typeof s.minLength === 'number' ? s.minLength : 0;
-        return f.array(zodNodeToArbitrary(s.element, depth + 1), {
-            minLength: minLen,
-            maxLength: Math.max(minLen, 5),
-        });
+        const { minLength, maxLength } = arrayLengthBounds(schema);
+        const element = zodNodeToArbitrary(schema.element, path, depth + 1);
+        // A recursive element type terminates here — an empty array is the finite value.
+        if (!element)
+            return f.constant([]);
+        return f.array(element, { minLength, maxLength });
     }
     // Union
     if (schema instanceof ZodUnion) {
         const options = schema._def.options;
-        return f.oneof(...options.map((o) => zodNodeToArbitrary(o, depth + 1)));
+        const arbs = options
+            .map((o) => zodNodeToArbitrary(o, path, depth + 1))
+            .filter((arb) => arb !== undefined);
+        return arbs.length > 0 ? f.oneof(...arbs) : undefined;
     }
     // Object — check by _def.type since instanceof ZodObject may have type issues
     if (zodTypeName(schema) === 'object') {
@@ -115,13 +156,46 @@ function zodNodeToArbitrary(schema, depth) {
             return f.constant({});
         const arbs = {};
         for (const [key, fieldSchema] of entries) {
-            arbs[key] = zodNodeToArbitrary(fieldSchema, depth + 1);
+            const field = zodNodeToArbitrary(fieldSchema, path, depth + 1);
+            // An optional or nullable field already collapsed to its permitted absence,
+            // so reaching here means a required field cannot terminate.
+            if (!field)
+                return;
+            arbs[key] = field;
         }
         return f.record(arbs);
     }
     // Fallback: generate JSON-safe primitives
     return f.oneof(f.string(), f.integer(), f.boolean(), f.constant(null));
 }
+/**
+ * Resolves an array's declared length bounds.
+ *
+ * Unlike ZodString, Zod 4's ZodArray exposes no `.minLength`/`.maxLength`
+ * accessors — `.min()`, `.max()`, `.length()`, and `.nonempty()` all land in
+ * `_def.checks`. Reading the absent accessor silently drops every one of them.
+ */
+function arrayLengthBounds(schema) {
+    const checks = (schema?._def?.checks ?? []);
+    let min = 0;
+    let max;
+    for (const check of checks) {
+        const def = check?._zod?.def;
+        if (def?.check === 'min_length' && typeof def.minimum === 'number') {
+            min = Math.max(min, def.minimum);
+        }
+        else if (def?.check === 'max_length' && typeof def.maximum === 'number') {
+            max = max === undefined ? def.maximum : Math.min(max, def.maximum);
+        }
+        else if (def?.check === 'length_equals' && typeof def.length === 'number') {
+            min = Math.max(min, def.length);
+            max = max === undefined ? def.length : Math.min(max, def.length);
+        }
+    }
+    // An unsatisfiable schema (min above max) still has to yield an arbitrary
+    // rather than throw out of the generator; the sample is rejected at parse.
+    return { minLength: min, maxLength: Math.max(min, max ?? DEFAULT_ARRAY_MAX) };
+}
 /**
  * Zod 4 exposes `.minLength`, `.maxLength`, `.format` as direct accessors on ZodString.
  */
@@ -275,6 +349,50 @@ function checkErrorLeaks(errorText) {
         /[A-Za-z]:\\/.test(errorText);
     return { leakedStack, leakedInternals };
 }
+/** Serialize the fields an MCP client can observe, excluding the local Error stack itself. */
+function publicErrorText(error) {
+    if (!(error instanceof McpError)) {
+        return error instanceof Error ? error.message : String(error);
+    }
+    const seen = new WeakSet();
+    try {
+        return JSON.stringify({ code: error.code, message: error.message, data: error.data }, (_key, value) => {
+            if (typeof value === 'bigint')
+                return value.toString();
+            if (typeof value === 'object' && value !== null) {
+                if (seen.has(value))
+                    return '[Circular]';
+                seen.add(value);
+            }
+            return value;
+        });
+    }
+    catch {
+        return error.message;
+    }
+}
+/** Records a leak entry when an error's client-visible text exposes a stack or internal path. */
+function recordLeak(report, input, error) {
+    const errorText = publicErrorText(error);
+    const { leakedStack, leakedInternals } = checkErrorLeaks(errorText);
+    if (leakedStack || leakedInternals) {
+        report.leaks.push({ input, errorText });
+    }
+}
+function recordHandlerError(report, input, error) {
+    if (!(error instanceof McpError)) {
+        report.crashes.push({ input, error });
+        return;
+    }
+    recordLeak(report, input, error);
+}
+function createToolFuzzContext(def, options, overrides = {}) {
+    return createMockContext({
+        ...options.ctx,
+        ...(def.errors !== undefined && { errors: def.errors }),
+        ...overrides,
+    });
+}
 // ---------------------------------------------------------------------------
 // Prototype pollution detection
 // ---------------------------------------------------------------------------
@@ -301,7 +419,7 @@ function createProtoPollutionGuard() {
  * Designed to be called inside a `describe()` / `it()` block.
  *
  * Checks:
- * 1. Valid inputs -> handler runs without crash, output matches schema
+ * 1. Valid inputs -> handler returns schema-valid output or a well-formed MCP error
  * 2. Adversarial inputs -> Zod rejects or handler errors gracefully
  * 3. No prototype pollution on Object.prototype
  * 4. No stack trace / path leaks in error messages
@@ -346,20 +464,20 @@ export async function fuzzTool(def, options = {}) {
         const parsed = def.input.safeParse(raw);
         if (!parsed.success)
             return;
-        const ctx = createMockContext(options.ctx);
+        const ctx = createToolFuzzContext(def, options);
         try {
             const result = await withTimeout(def.handler(parsed.data, ctx), timeout);
             def.output.parse(result);
         }
         catch (err) {
-            report.crashes.push({ input: parsed.data, error: err });
+            recordHandlerError(report, parsed.data, err);
         }
     }), fcParams);
     // Phase 2: Adversarial inputs (should be caught by Zod or handler, never crash)
     const advArb = adversarialObjectArbitrary(def.input);
     await f.assert(f.asyncProperty(advArb, async (input) => {
         report.totalRuns++;
-        const ctx = createMockContext(options.ctx);
+        const ctx = createToolFuzzContext(def, options);
         try {
             const validated = def.input.safeParse(input);
             if (!validated.success)
@@ -368,11 +486,7 @@ export async function fuzzTool(def, options = {}) {
             def.output.parse(result);
         }
         catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            const leakCheck = checkErrorLeaks(msg);
-            if (leakCheck.leakedStack || leakCheck.leakedInternals) {
-                report.leaks.push({ input, errorText: msg });
-            }
+            recordLeak(report, input, err);
         }
     }), { ...fcParams, numRuns: numAdversarial });
     // Phase 3: Raw adversarial (completely wrong types at the top level)
@@ -392,7 +506,7 @@ export async function fuzzTool(def, options = {}) {
             const validated = def.input.safeParse(input);
             if (!validated.success)
                 continue;
-            const ctx = createMockContext(options.ctx);
+            const ctx = createToolFuzzContext(def, options);
             await withTimeout(def.handler(validated.data, ctx), timeout);
         }
         catch {
@@ -404,7 +518,7 @@ export async function fuzzTool(def, options = {}) {
     try {
         const controller = new AbortController();
         controller.abort();
-        const ctx = createMockContext({ ...options.ctx, signal: controller.signal });
+        const ctx = createToolFuzzContext(def, options, { signal: controller.signal });
         const rawSample = generateOne(validArb);
         const parsedSample = def.input.parse(rawSample);
         await withTimeout(def.handler(parsedSample, ctx), timeout);
@@ -460,7 +574,7 @@ export async function fuzzResource(def, options = {}) {
                 await withTimeout(def.handler(parsed.data, ctx), timeout);
             }
             catch (err) {
-                report.crashes.push({ input: parsed.data, error: err });
+                recordHandlerError(report, parsed.data, err);
             }
         }), fcParams);
         // Phase 2: Adversarial params
@@ -478,11 +592,7 @@ export async function fuzzResource(def, options = {}) {
                 await withTimeout(def.handler(validated.data, ctx), timeout);
             }
             catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                const leakCheck = checkErrorLeaks(msg);
-                if (leakCheck.leakedStack || leakCheck.leakedInternals) {
-                    report.leaks.push({ input: params, errorText: msg });
-                }
+                recordLeak(report, params, err);
             }
         }), { ...fcParams, numRuns: numAdversarial });
     }
@@ -496,7 +606,7 @@ export async function fuzzResource(def, options = {}) {
             await withTimeout(def.handler({}, ctx), timeout);
         }
         catch (err) {
-            report.crashes.push({ input: {}, error: err });
+            recordHandlerError(report, {}, err);
         }
     }
     protoGuard.check(report);