@novorb/mcp-core 2.1.1 → 3.0.0

package/dist/result-limits.js

@@ -0,0 +1,248 @@
+/**
+ * @novorb/mcp-core - Tool result limits
+ *
+ * `registerTools` enforces two caps on every tool result, by default:
+ *
+ * - items: a list-shaped result (`structuredContent` of the `PagedResult` shape `{ items, nextCursor?,
+ *   total? }`) carries at most `maxItems` items (MCP_MAX_RESULT_ITEMS, default 100; a smaller `limit`
+ *   argument wins). The rest is reached through an opaque `nextCursor`.
+ * - bytes: the serialized result is at most `maxBytes` (MCP_MAX_RESULT_BYTES, default 256 KiB). A
+ *   list-shaped result is first paged smaller; anything still too large becomes an actionable isError
+ *   result (never a truncated, invalid or schema-breaking body).
+ *
+ * Cursors are stateless. mcp-core's cursor records the tool, a fingerprint of the other arguments, the
+ * offset inside the handler's page, and the handler's own cursor for that page; on the next call the
+ * handler is re-run with its own cursor (as `args.cursor` and `ctx.cursor`) and mcp-core serves the next
+ * slice, or wraps the handler's own `nextCursor` once its page is exhausted. A cursor for another tool or
+ * other arguments, or a malformed one, is refused (`Invalid cursor: ...`), so an edited cursor can only
+ * ever address the caller's own result set. The handler must be a deterministic read for a given cursor
+ * (list tools are).
+ */
+import { createHash } from 'node:crypto';
+import { decodeCursor, encodeCursor, InvalidCursorError } from './pagination.js';
+import { getLogger } from './utils/logger.js';
+function isPagedShape(value) {
+    return (typeof value === 'object' && value !== null && !Array.isArray(value) && Array.isArray(value.items));
+}
+function stable(value) {
+    if (Array.isArray(value))
+        return value.map(stable);
+    if (typeof value === 'object' && value !== null) {
+        const out = {};
+        for (const key of Object.keys(value).sort())
+            out[key] = stable(value[key]);
+        return out;
+    }
+    return value;
+}
+/** A short fingerprint of the arguments other than `cursor` / `limit` (binds a cursor to its query). */
+export function argsFingerprint(args) {
+    const rest = typeof args === 'object' && args !== null ? { ...args } : {};
+    delete rest.cursor;
+    delete rest.limit;
+    return createHash('sha256')
+        .update(JSON.stringify(stable(rest)) ?? '')
+        .digest('hex')
+        .slice(0, 16);
+}
+function isToolCursorData(tool, fingerprint) {
+    return (data) => {
+        const r = typeof data === 'object' && data !== null && !Array.isArray(data) ? data : undefined;
+        if (!r || typeof r.t !== 'string')
+            return false;
+        if (r.t !== tool)
+            throw new InvalidCursorError('issued for another tool');
+        if (r.h !== fingerprint)
+            throw new InvalidCursorError('issued for other arguments');
+        return (typeof r.o === 'number' && Number.isInteger(r.o) && r.o >= 0 && (r.c === undefined || typeof r.c === 'string'));
+    };
+}
+/**
+ * Decode `cursor` as an mcp-core tool cursor. Returns undefined when it is not one (a handler's own
+ * cursor; only allowed when `strict` is false). Throws `InvalidCursorError` for a mismatch.
+ */
+export function decodeToolCursor(tool, args, cursor, strict) {
+    try {
+        const data = decodeCursor(cursor, { validate: isToolCursorData(tool, argsFingerprint(args)) });
+        return data.c !== undefined ? { o: data.o, c: data.c } : { o: data.o };
+    }
+    catch (e) {
+        if (e instanceof InvalidCursorError && /another tool|other arguments/.test(e.message))
+            throw e;
+        if (strict)
+            throw e instanceof InvalidCursorError ? e : new InvalidCursorError('unrecognised format');
+        return undefined;
+    }
+}
+function encodeToolCursor(tool, args, position) {
+    const data = { t: tool, h: argsFingerprint(args), o: position.o };
+    if (position.c !== undefined)
+        data.c = position.c;
+    return encodeCursor(data);
+}
+/** The arguments handed to the handler: `cursor` = its own cursor (or none), `limit` capped. */
+export function handlerArgs(args, decoded, maxItems) {
+    if (typeof args !== 'object' || args === null || Array.isArray(args))
+        return args;
+    const out = { ...args };
+    if (decoded) {
+        if (decoded.c !== undefined)
+            out.cursor = decoded.c;
+        else
+            delete out.cursor;
+    }
+    if (typeof out.limit === 'number')
+        out.limit = Math.max(1, Math.min(Math.floor(out.limit), maxItems));
+    return out;
+}
+function byteSize(value) {
+    return Buffer.byteLength(JSON.stringify(value) ?? '', 'utf8');
+}
+function pretty(value) {
+    return JSON.stringify(value, null, 2);
+}
+function refusal(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+/** The bytes of `result` with any text block that only repeats `payload` left out (it is counted once). */
+function envelopeBytes(result, payload) {
+    const compact = JSON.stringify(payload);
+    const copies = new Set([compact, pretty(payload)]);
+    const content = result.content.filter((block) => !(block.type === 'text' && copies.has(block.text)));
+    return byteSize(content.length === result.content.length ? result : { ...result, content });
+}
+/** The caps for an envelope result: items of the payload member, bytes with the payload counted once. */
+function enforceEnvelopeLimits(ctx, envelope, result) {
+    const sc = (result.isError === true ? undefined : result.structuredContent);
+    if (!sc || !(envelope.key in sc))
+        return enforceResultLimits({ ...ctx, envelope: undefined }, result);
+    const payload = sc[envelope.key];
+    const hint = envelope.hint ? `; ${envelope.hint}` : '';
+    const items = Array.isArray(payload) ? payload : isPagedShape(payload) ? payload.items : undefined;
+    if (items && items.length > ctx.maxItems) {
+        getLogger().warn(`Tool result over the item limit: ${ctx.tool}`, 'Tools', {
+            tool: ctx.tool,
+            items: items.length,
+            maxItems: ctx.maxItems,
+        });
+        return refusal(`${ctx.tool}: the result has ${items.length} items, over the ${ctx.maxItems} item limit per response${hint}`);
+    }
+    const bytes = envelopeBytes(result, payload);
+    if (bytes <= ctx.maxBytes)
+        return result;
+    getLogger().warn(`Tool result over the byte limit: ${ctx.tool}`, 'Tools', {
+        tool: ctx.tool,
+        bytes,
+        maxBytes: ctx.maxBytes,
+        isError: false,
+    });
+    const replacement = ctx.onOversize?.({
+        tool: ctx.tool,
+        bytes,
+        maxBytes: ctx.maxBytes,
+        result,
+        ...(ctx.authInfo ? { authInfo: ctx.authInfo } : {}),
+    });
+    if (replacement && byteSize(replacement) <= ctx.maxBytes)
+        return replacement;
+    return refusal(`${ctx.tool}: the result is ${bytes} bytes, over the ${ctx.maxBytes} byte limit per response${hint}`);
+}
+function oversizeError(tool, bytes, maxBytes, paged) {
+    const hint = paged
+        ? 'even one item is too large; request fewer fields or a narrower item'
+        : 'narrow the request (filters, fewer fields, a smaller range) or use a paginated variant with cursor/limit';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `${tool}: the result is ${bytes} bytes, over the ${maxBytes} byte limit per response; ${hint}`,
+            },
+        ],
+        isError: true,
+    };
+}
+function pageOf(ctx, result, sc, limit) {
+    const offset = ctx.decoded?.o ?? 0;
+    const end = offset + limit;
+    const page = { ...sc, items: sc.items.slice(offset, end) };
+    delete page.nextCursor;
+    const inner = ctx.decoded?.c;
+    let next;
+    if (end < sc.items.length)
+        next = inner !== undefined ? { o: end, c: inner } : { o: end };
+    else if (typeof sc.nextCursor === 'string' && sc.nextCursor !== '')
+        next = { o: 0, c: sc.nextCursor };
+    if (next)
+        page.nextCursor = encodeToolCursor(ctx.tool, ctx.args, next);
+    const first = result.content[0];
+    const textWasDump = result.content.length === 1 && first?.type === 'text' && first.text === pretty(sc);
+    const cut = page.items.length < sc.items.length;
+    const content = cut || textWasDump ? [{ type: 'text', text: pretty(page) }] : result.content;
+    return { ...result, content, structuredContent: page };
+}
+/** Apply the item and byte caps to one handler result. */
+export function enforceResultLimits(ctx, result) {
+    if (ctx.envelope)
+        return enforceEnvelopeLimits(ctx, ctx.envelope, result);
+    const log = getLogger();
+    const sc = result.isError === true ? undefined : result.structuredContent;
+    let out = result;
+    if (isPagedShape(sc)) {
+        const requested = typeof ctx.args?.limit === 'number';
+        const limit = Math.max(1, Math.min(requested ? Number(ctx.args.limit) : ctx.maxItems, ctx.maxItems));
+        const needsPaging = (ctx.decoded?.o ?? 0) > 0 || sc.items.length > limit || typeof sc.nextCursor === 'string';
+        if (needsPaging) {
+            out = pageOf(ctx, result, sc, limit);
+            const served = out.structuredContent.items.length;
+            if (served < sc.items.length) {
+                log.info(`Tool result paged: ${ctx.tool}`, 'Tools', { tool: ctx.tool, items: sc.items.length, served, limit });
+            }
+        }
+        let bytes = byteSize(out);
+        let size = out.structuredContent.items.length;
+        while (bytes > ctx.maxBytes && size > 1) {
+            size = Math.max(1, Math.floor(size / 2));
+            out = pageOf(ctx, result, sc, size);
+            bytes = byteSize(out);
+        }
+        if (size < limit && bytes <= ctx.maxBytes) {
+            log.warn(`Tool result paged to fit the byte limit: ${ctx.tool}`, 'Tools', {
+                tool: ctx.tool,
+                items: sc.items.length,
+                served: size,
+                bytes,
+                maxBytes: ctx.maxBytes,
+            });
+        }
+    }
+    const bytes = byteSize(out);
+    if (bytes <= ctx.maxBytes)
+        return out;
+    log.warn(`Tool result over the byte limit: ${ctx.tool}`, 'Tools', {
+        tool: ctx.tool,
+        bytes,
+        maxBytes: ctx.maxBytes,
+        isError: out.isError === true,
+    });
+    const replacement = ctx.onOversize?.({
+        tool: ctx.tool,
+        bytes,
+        maxBytes: ctx.maxBytes,
+        result: out,
+        ...(ctx.authInfo ? { authInfo: ctx.authInfo } : {}),
+    });
+    if (replacement && byteSize(replacement) <= ctx.maxBytes)
+        return replacement;
+    return oversizeError(ctx.tool, bytes, ctx.maxBytes, isPagedShape(sc));
+}
+/** Whether an input schema declares `cursor` and `limit` properties (required for `paginated` tools). */
+export function declaresPageArgs(schema) {
+    try {
+        const json = schema['~standard'].jsonSchema.input({ target: 'draft-2020-12' });
+        return json.properties?.cursor !== undefined && json.properties?.limit !== undefined;
+    }
+    catch {
+        return true;
+    }
+}
+//# sourceMappingURL=result-limits.js.map

package/dist/result-limits.js.map

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

package/dist/retry.d.ts

@@ -1,51 +1,107 @@
 /**
- * @novorb/mcp-core — Retry utilities
+ * @novorb/mcp-core - Retry utilities
  *
- * Exponential backoff with jitter for retrying failed HTTP requests.
+ * One retry policy for the whole package, shared by `retryWithBackoff` and the HTTP client:
+ * - retryable statuses: 408, 425, 429, 500, 502, 503, 504 (never 501, never any other 4xx)
+ * - retryable network errors: ECONNRESET, ETIMEDOUT, EAI_AGAIN, and ECONNREFUSED on connect only
+ * - `Retry-After` (seconds or HTTP date) is honoured, capped by `maxRetryAfterMs`
+ * - otherwise exponential backoff with full jitter, capped by `maxDelayMs`
+ * - bounded attempts (a loop, never recursion) and abort-signal aware
+ *
+ * Idempotency (which methods may be replayed) is decided by the caller; the HTTP client only retries
+ * GET/HEAD/OPTIONS/PUT/DELETE unless the request carries an idempotency key or opts in explicitly.
  */
 export interface RetryOptions {
-    /** Maximum number of retries (default: 3) */
+    /** Maximum number of retries after the first attempt (default: 3). */
     maxRetries?: number;
-    /** Initial delay in milliseconds (default: 1000) */
+    /** Base delay of the first retry in milliseconds (default: 1000). */
     initialDelayMs?: number;
-    /** Maximum delay in milliseconds (default: 10000) */
+    /** Cap of one backoff delay in milliseconds (default: 10000). */
     maxDelayMs?: number;
-    /** Backoff multiplier (default: 2) */
+    /** Backoff multiplier (default: 2). */
     backoffMultiplier?: number;
-    /** Jitter factor 0-1 (default: 0.1 = 10%) */
-    jitterFactor?: number;
+    /** Cap applied to a server-sent Retry-After in milliseconds (default: 30000). */
+    maxRetryAfterMs?: number;
+    /** Stop retrying (and reject with the abort reason) once this signal aborts. */
+    signal?: AbortSignal;
+    /** Override the retry decision (default: `isRetryableError`). */
+    shouldRetry?: (error: unknown, context: RetryContext) => boolean;
+    /** Called before each wait with the delay about to be slept. */
+    onRetry?: (info: RetryInfo) => void;
+    /** Random source in [0, 1) for the jitter (default: Math.random). */
+    random?: () => number;
 }
 export interface RetryContext {
-    /** Current attempt number (0-based) */
+    /** Current attempt number (0-based). */
     attempt: number;
-    /** Maximum retries configured */
+    /** Maximum retries configured. */
     maxRetries: number;
-    /** Last error encountered */
+    /** Last error encountered. */
     lastError?: Error;
 }
+export interface RetryInfo {
+    /** The attempt that failed (0-based). */
+    attempt: number;
+    /** Delay before the next attempt in milliseconds. */
+    delayMs: number;
+    /** True when the delay came from a Retry-After header. */
+    fromRetryAfter: boolean;
+    /** The error that triggered the retry. */
+    error: unknown;
+}
+/** HTTP statuses that are retried. 501 Not Implemented is permanent and deliberately absent. */
+export declare const RETRYABLE_STATUS_CODES: ReadonlySet<number>;
+/** Network error codes that are retried. ECONNREFUSED additionally requires the connect syscall. */
+export declare const RETRYABLE_NETWORK_CODES: ReadonlySet<string>;
+/** Methods that are safe to replay without an idempotency key. */
+export declare const IDEMPOTENT_METHODS: ReadonlySet<string>;
+/** True for a status in `RETRYABLE_STATUS_CODES`. */
+export declare function isRetryableStatus(status: number): boolean;
+/** True for GET/HEAD/OPTIONS/PUT/DELETE (case-insensitive). A missing method counts as GET. */
+export declare function isIdempotentMethod(method: string | undefined): boolean;
+/** Reads an HTTP status from an axios-style error (`response.status`) or a normalized one (`status`). */
+export declare function errorStatus(error: unknown): number | undefined;
 /**
- * Calculate retry delay with exponential backoff and jitter.
+ * Determine if an error is retryable under the shared policy. A response status decides when one is
+ * present; otherwise the network error code (own or `cause`) decides.
+ */
+export declare function isRetryableError(error: unknown): boolean;
+/**
+ * Exponential backoff with full jitter: a uniform value in [0, min(maxDelayMs, initial * mult^attempt)].
  */
 export declare function calculateRetryDelay(attempt: number, options?: RetryOptions): number;
 /**
- * Sleep for specified milliseconds.
+ * Parse a Retry-After header value (delta seconds or an HTTP date) to milliseconds. Returns undefined
+ * for a missing or unparseable value; a date in the past gives 0.
  */
-export declare function sleep(ms: number): Promise<void>;
+export declare function parseRetryAfter(retryAfter: string | undefined, now?: number): number | undefined;
 /**
- * Determine if an error is retryable.
+ * The Retry-After delay carried by an error, in milliseconds: a normalized error's `retryAfterMs`, or
+ * the `retry-after` header of an axios-style `response`.
  */
-export declare function isRetryableError(error: unknown): boolean;
+export declare function retryAfterFromError(error: unknown, now?: number): number | undefined;
 /**
- * Retry a function with exponential backoff.
+ * The delay before the next attempt: the error's Retry-After capped by `maxRetryAfterMs`, else the
+ * full-jitter backoff for `attempt`.
+ */
+export declare function retryDelayFor(error: unknown, attempt: number, options?: RetryOptions): {
+    delayMs: number;
+    fromRetryAfter: boolean;
+};
+/** Throws the signal's abort reason when it has aborted. */
+export declare function throwIfAborted(signal: AbortSignal | undefined): void;
+/**
+ * Sleep for `ms` milliseconds. With a signal, rejects with its abort reason as soon as it aborts.
+ */
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+/**
+ * Retry a function under the shared policy.
  *
  * @param fn - Async function to retry (receives RetryContext)
  * @param options - Retry options
- * @returns Result of successful function call
- * @throws Last error if all retries exhausted or error is not retryable
+ * @returns Result of the first successful call
+ * @throws The last error when retries are exhausted or the error is not retryable; the abort reason
+ *   when the signal aborts
  */
 export declare function retryWithBackoff<T>(fn: (context: RetryContext) => Promise<T>, options?: RetryOptions): Promise<T>;
-/**
- * Parse Retry-After header value to milliseconds.
- */
-export declare function parseRetryAfter(retryAfter: string | undefined): number | undefined;
 //# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAUD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAQD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAiBxD;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,EACzC,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUlF"}
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"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"}