@novorb/mcp-core 2.1.1 → 3.0.0

package/dist/retry.js

@@ -1,94 +1,207 @@
 /**
- * @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.
  */
 const DEFAULT_OPTIONS = {
     maxRetries: 3,
     initialDelayMs: 1000,
     maxDelayMs: 10000,
     backoffMultiplier: 2,
-    jitterFactor: 0.1,
+    maxRetryAfterMs: 30000,
 };
+/** HTTP statuses that are retried. 501 Not Implemented is permanent and deliberately absent. */
+export const RETRYABLE_STATUS_CODES = new Set([408, 425, 429, 500, 502, 503, 504]);
+/** Network error codes that are retried. ECONNREFUSED additionally requires the connect syscall. */
+export const RETRYABLE_NETWORK_CODES = new Set([
+    'ECONNRESET',
+    'ETIMEDOUT',
+    'EAI_AGAIN',
+    'ECONNREFUSED',
+]);
+/** Methods that are safe to replay without an idempotency key. */
+export const IDEMPOTENT_METHODS = new Set(['GET', 'HEAD', 'OPTIONS', 'PUT', 'DELETE']);
+/** True for a status in `RETRYABLE_STATUS_CODES`. */
+export function isRetryableStatus(status) {
+    return RETRYABLE_STATUS_CODES.has(status);
+}
+/** True for GET/HEAD/OPTIONS/PUT/DELETE (case-insensitive). A missing method counts as GET. */
+export function isIdempotentMethod(method) {
+    return IDEMPOTENT_METHODS.has((method ?? 'GET').toUpperCase());
+}
+function asRecord(value) {
+    return value !== null && typeof value === 'object' ? value : undefined;
+}
+/** Reads an HTTP status from an axios-style error (`response.status`) or a normalized one (`status`). */
+export function errorStatus(error) {
+    const err = asRecord(error);
+    if (!err)
+        return undefined;
+    const status = asRecord(err.response)?.status ?? err.status;
+    return typeof status === 'number' ? status : undefined;
+}
+function networkCode(err) {
+    const cause = asRecord(err.cause);
+    const code = typeof err.code === 'string' ? err.code : typeof cause?.code === 'string' ? cause.code : undefined;
+    const syscall = typeof err.syscall === 'string' ? err.syscall : typeof cause?.syscall === 'string' ? cause.syscall : undefined;
+    return { code, syscall };
+}
 /**
- * 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 function isRetryableError(error) {
+    const err = asRecord(error);
+    if (!err)
+        return false;
+    const status = errorStatus(error);
+    if (status !== undefined)
+        return isRetryableStatus(status);
+    const { code, syscall } = networkCode(err);
+    if (code === undefined || !RETRYABLE_NETWORK_CODES.has(code))
+        return false;
+    if (code === 'ECONNREFUSED')
+        return syscall === 'connect';
+    return true;
+}
+/**
+ * Exponential backoff with full jitter: a uniform value in [0, min(maxDelayMs, initial * mult^attempt)].
  */
 export function calculateRetryDelay(attempt, options = {}) {
-    const opts = { ...DEFAULT_OPTIONS, ...options };
-    const exponentialDelay = opts.initialDelayMs * Math.pow(opts.backoffMultiplier, attempt);
-    const cappedDelay = Math.min(exponentialDelay, opts.maxDelayMs);
-    const jitterRange = cappedDelay * opts.jitterFactor;
-    const jitter = (Math.random() * 2 - 1) * jitterRange;
-    return Math.max(0, cappedDelay + jitter);
+    const initial = options.initialDelayMs ?? DEFAULT_OPTIONS.initialDelayMs;
+    const multiplier = options.backoffMultiplier ?? DEFAULT_OPTIONS.backoffMultiplier;
+    const maxDelay = options.maxDelayMs ?? DEFAULT_OPTIONS.maxDelayMs;
+    const random = options.random ?? Math.random;
+    const ceiling = Math.min(maxDelay, initial * multiplier ** Math.max(0, attempt));
+    return Math.max(0, Math.floor(random() * ceiling));
+}
+/**
+ * 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 function parseRetryAfter(retryAfter, now = Date.now()) {
+    if (!retryAfter)
+        return undefined;
+    const trimmed = retryAfter.trim();
+    if (/^\d+$/.test(trimmed))
+        return Number(trimmed) * 1000;
+    // An HTTP date always names a day/month; this keeps `-5` or `1.5` from parsing as a year.
+    const date = /[a-z]/i.test(trimmed) ? Date.parse(trimmed) : Number.NaN;
+    if (!Number.isNaN(date))
+        return Math.max(0, date - now);
+    return undefined;
+}
+function headerFrom(headers, name) {
+    const record = asRecord(headers);
+    if (!record)
+        return undefined;
+    const getter = record.get;
+    if (typeof getter === 'function') {
+        const value = getter.call(headers, name);
+        if (typeof value === 'string')
+            return value;
+    }
+    for (const [key, value] of Object.entries(record)) {
+        if (key.toLowerCase() === name && typeof value === 'string')
+            return value;
+    }
+    return undefined;
 }
 /**
- * Sleep for specified milliseconds.
+ * 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 function sleep(ms) {
-    return new Promise(resolve => setTimeout(resolve, ms));
+export function retryAfterFromError(error, now = Date.now()) {
+    const err = asRecord(error);
+    if (!err)
+        return undefined;
+    if (typeof err.retryAfterMs === 'number')
+        return err.retryAfterMs;
+    return parseRetryAfter(headerFrom(asRecord(err.response)?.headers, 'retry-after'), now);
 }
-/** HTTP status codes that should be retried */
-const RETRYABLE_STATUS_CODES = [408, 429, 502, 503, 504];
-/** Network error codes that should be retried */
-const RETRYABLE_NETWORK_CODES = ['ECONNRESET', 'ETIMEDOUT', 'ENOTFOUND', 'ECONNREFUSED'];
 /**
- * Determine if an error is retryable.
+ * The delay before the next attempt: the error's Retry-After capped by `maxRetryAfterMs`, else the
+ * full-jitter backoff for `attempt`.
  */
-export function isRetryableError(error) {
-    if (error && typeof error === 'object') {
-        const err = error;
-        // Network errors
-        if (typeof err.code === 'string' && RETRYABLE_NETWORK_CODES.includes(err.code)) {
-            return true;
-        }
-        // HTTP status codes
-        const response = err.response;
-        const status = response?.status;
-        if (typeof status === 'number') {
-            return RETRYABLE_STATUS_CODES.includes(status);
-        }
+export function retryDelayFor(error, attempt, options = {}) {
+    const retryAfter = retryAfterFromError(error);
+    if (retryAfter !== undefined) {
+        const cap = options.maxRetryAfterMs ?? DEFAULT_OPTIONS.maxRetryAfterMs;
+        return { delayMs: Math.min(retryAfter, cap), fromRetryAfter: true };
     }
-    return false;
+    return { delayMs: calculateRetryDelay(attempt, options), fromRetryAfter: false };
+}
+function abortReason(signal) {
+    const reason = signal.reason;
+    if (reason instanceof Error)
+        return reason;
+    const err = new Error('The operation was aborted');
+    err.name = 'AbortError';
+    return err;
+}
+/** Throws the signal's abort reason when it has aborted. */
+export function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw abortReason(signal);
 }
 /**
- * Retry a function with exponential backoff.
+ * Sleep for `ms` milliseconds. With a signal, rejects with its abort reason as soon as it aborts.
+ */
+export function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(abortReason(signal));
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(abortReason(signal));
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/**
+ * 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 async function retryWithBackoff(fn, options = {}) {
-    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const maxRetries = Math.max(0, options.maxRetries ?? DEFAULT_OPTIONS.maxRetries);
+    const shouldRetry = options.shouldRetry ?? ((error) => isRetryableError(error));
     let lastError;
-    for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
-        const context = { attempt, maxRetries: opts.maxRetries, lastError };
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        throwIfAborted(options.signal);
+        const context = { attempt, maxRetries, lastError };
         try {
             return await fn(context);
         }
         catch (error) {
-            lastError = error;
-            if (attempt === opts.maxRetries || !isRetryableError(error)) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt === maxRetries || options.signal?.aborted || !shouldRetry(error, context)) {
                 throw error;
             }
-            const delay = calculateRetryDelay(attempt, options);
-            await sleep(delay);
+            const { delayMs, fromRetryAfter } = retryDelayFor(error, attempt, options);
+            options.onRetry?.({ attempt, delayMs, fromRetryAfter, error });
+            await sleep(delayMs, options.signal);
         }
     }
-    throw lastError || new Error('Retry exhausted');
-}
-/**
- * Parse Retry-After header value to milliseconds.
- */
-export function parseRetryAfter(retryAfter) {
-    if (!retryAfter)
-        return undefined;
-    const seconds = parseInt(retryAfter, 10);
-    if (!isNaN(seconds))
-        return seconds * 1000;
-    const date = new Date(retryAfter);
-    if (!isNaN(date.getTime()))
-        return Math.max(0, date.getTime() - Date.now());
-    return undefined;
+    /* istanbul ignore next -- unreachable: the last attempt always returns or throws inside the loop */
+    throw lastError ?? new Error('Retry exhausted');
 }
 //# sourceMappingURL=retry.js.map

package/dist/retry.js.map

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

package/dist/sdk/client-stdio.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @novorb/mcp-core SDK re-export of `@modelcontextprotocol/client/stdio` (every runtime export and type).
+ * Consumers import the SDK only through mcp-core; see README "The SDK through mcp-core".
+ */
+export * from '@modelcontextprotocol/client/stdio';
+//# sourceMappingURL=client-stdio.d.ts.map

package/dist/sdk/client-stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-stdio.d.ts","sourceRoot":"","sources":["../../src/sdk/client-stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,oCAAoC,CAAC"}

package/dist/sdk/client-stdio.js

@@ -0,0 +1,6 @@
+/**
+ * @novorb/mcp-core SDK re-export of `@modelcontextprotocol/client/stdio` (every runtime export and type).
+ * Consumers import the SDK only through mcp-core; see README "The SDK through mcp-core".
+ */
+export * from '@modelcontextprotocol/client/stdio';
+//# sourceMappingURL=client-stdio.js.map

package/dist/sdk/client-stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-stdio.js","sourceRoot":"","sources":["../../src/sdk/client-stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,oCAAoC,CAAC"}

package/dist/sdk/client.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @novorb/mcp-core SDK re-export of `@modelcontextprotocol/client` (every runtime export and type).
+ * Consumers import the SDK only through mcp-core; see README "The SDK through mcp-core".
+ */
+export * from '@modelcontextprotocol/client';
+//# sourceMappingURL=client.d.ts.map

package/dist/sdk/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/sdk/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,8BAA8B,CAAC"}

package/dist/sdk/client.js

@@ -0,0 +1,6 @@
+/**
+ * @novorb/mcp-core SDK re-export of `@modelcontextprotocol/client` (every runtime export and type).
+ * Consumers import the SDK only through mcp-core; see README "The SDK through mcp-core".
+ */
+export * from '@modelcontextprotocol/client';
+//# sourceMappingURL=client.js.map

package/dist/sdk/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/sdk/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,8BAA8B,CAAC"}

package/dist/sdk/express.d.ts

@@ -0,0 +1,3 @@
+export type { AuthMetadataOptions, BearerAuthMiddlewareOptions, CreateMcpExpressAppOptions, OAuthTokenVerifier, } from '@modelcontextprotocol/express';
+export declare const createMcpExpressApp: typeof import("@modelcontextprotocol/express").createMcpExpressApp, getOAuthProtectedResourceMetadataUrl: typeof import("@modelcontextprotocol/server").getOAuthProtectedResourceMetadataUrl, hostHeaderValidation: typeof import("@modelcontextprotocol/express").hostHeaderValidation, localhostHostValidation: typeof import("@modelcontextprotocol/express").localhostHostValidation, localhostOriginValidation: typeof import("@modelcontextprotocol/express").localhostOriginValidation, mcpAuthMetadataRouter: typeof import("@modelcontextprotocol/express").mcpAuthMetadataRouter, originValidation: typeof import("@modelcontextprotocol/express").originValidation, requireBearerAuth: typeof import("@modelcontextprotocol/express").requireBearerAuth;
+//# sourceMappingURL=express.d.ts.map

package/dist/sdk/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/sdk/express.ts"],"names":[],"mappings":"AAWA,YAAY,EACV,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AACvC,eAAO,MACL,mBAAmB,sEACnB,oCAAoC,sFACpC,oBAAoB,uEACpB,uBAAuB,0EACvB,yBAAyB,4EACzB,qBAAqB,wEACrB,gBAAgB,mEAChB,iBAAiB,kEACR,CAAC"}

package/dist/sdk/express.js

@@ -0,0 +1,11 @@
+/**
+ * @novorb/mcp-core SDK re-export of `@modelcontextprotocol/express` (every runtime export and type).
+ * Consumers import the SDK only through mcp-core; see README "The SDK through mcp-core".
+ *
+ * `@modelcontextprotocol/express` and `express` are optional peers: this subpath loads them lazily and
+ * fails at import with `ExpressAdapterUnavailableError` when either is not installed.
+ */
+import { loadExpressPeers } from '../express-peers.js';
+const { adapter } = await loadExpressPeers();
+export const { createMcpExpressApp, getOAuthProtectedResourceMetadataUrl, hostHeaderValidation, localhostHostValidation, localhostOriginValidation, mcpAuthMetadataRouter, originValidation, requireBearerAuth, } = adapter;
+//# sourceMappingURL=express.js.map

package/dist/sdk/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../src/sdk/express.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,gBAAgB,EAAE,CAAC;AAQ7C,MAAM,CAAC,MAAM,EACX,mBAAmB,EACnB,oCAAoC,EACpC,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,GAClB,GAAG,OAAO,CAAC"}

package/dist/sdk/node.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @novorb/mcp-core SDK re-export of `@modelcontextprotocol/node` (every runtime export and type).
+ * Consumers import the SDK only through mcp-core; see README "The SDK through mcp-core".
+ */
+export * from '@modelcontextprotocol/node';
+//# sourceMappingURL=node.d.ts.map

package/dist/sdk/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/sdk/node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,4BAA4B,CAAC"}

package/dist/sdk/node.js

@@ -0,0 +1,6 @@
+/**
+ * @novorb/mcp-core SDK re-export of `@modelcontextprotocol/node` (every runtime export and type).
+ * Consumers import the SDK only through mcp-core; see README "The SDK through mcp-core".
+ */
+export * from '@modelcontextprotocol/node';
+//# sourceMappingURL=node.js.map

package/dist/sdk/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/sdk/node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,4BAA4B,CAAC"}

package/dist/sdk/server-stdio.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @novorb/mcp-core SDK re-export of `@modelcontextprotocol/server/stdio` (every runtime export and type).
+ * Consumers import the SDK only through mcp-core; see README "The SDK through mcp-core".
+ */
+export * from '@modelcontextprotocol/server/stdio';
+//# sourceMappingURL=server-stdio.d.ts.map

package/dist/sdk/server-stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-stdio.d.ts","sourceRoot":"","sources":["../../src/sdk/server-stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,oCAAoC,CAAC"}

package/dist/sdk/server-stdio.js

@@ -0,0 +1,6 @@
+/**
+ * @novorb/mcp-core SDK re-export of `@modelcontextprotocol/server/stdio` (every runtime export and type).
+ * Consumers import the SDK only through mcp-core; see README "The SDK through mcp-core".
+ */
+export * from '@modelcontextprotocol/server/stdio';
+//# sourceMappingURL=server-stdio.js.map

package/dist/sdk/server-stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-stdio.js","sourceRoot":"","sources":["../../src/sdk/server-stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,oCAAoC,CAAC"}

package/dist/sdk/server.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @novorb/mcp-core SDK re-export of `@modelcontextprotocol/server` (every runtime export and type).
+ * Consumers import the SDK only through mcp-core; see README "The SDK through mcp-core".
+ */
+export * from '@modelcontextprotocol/server';
+//# sourceMappingURL=server.d.ts.map

package/dist/sdk/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/sdk/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,8BAA8B,CAAC"}

package/dist/sdk/server.js

@@ -0,0 +1,6 @@
+/**
+ * @novorb/mcp-core SDK re-export of `@modelcontextprotocol/server` (every runtime export and type).
+ * Consumers import the SDK only through mcp-core; see README "The SDK through mcp-core".
+ */
+export * from '@modelcontextprotocol/server';
+//# sourceMappingURL=server.js.map

package/dist/sdk/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/sdk/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,8BAA8B,CAAC"}

package/dist/server.d.ts

@@ -1,46 +1,38 @@
 /**
- * @novorb/mcp-core — Server
+ * @novorb/mcp-core - Server
  *
- * Re-exports and base patterns for building MCP servers with the high-level McpServer API.
- * Import from here instead of the SDK directly — one centralised import point for all
- * server-building primitives.
+ * Re-exports and base patterns for building MCP servers on `@modelcontextprotocol/server` (SDK v2).
+ * Import from here instead of the SDK directly: one centralised import point for every
+ * server-building primitive, high-level (`McpServer`) and low-level (`Server`) alike.
  *
  * Usage:
  *   import { createMcpServer, TOOL_ANNOTATIONS, completable } from '@novorb/mcp-core/server';
- *   import type { McpToolAnnotations, McpCallToolResult } from '@novorb/mcp-core/server';
+ *   import * as z from 'zod/v4';
  *
- *   const server = createMcpServer('my-mcp', '1.0.0');
+ *   export function buildServer(): McpServer {
+ *     const server = createMcpServer('my-mcp', '1.0.0');
+ *     server.registerTool('lookup', {
+ *       description: 'Look up data by key',
+ *       inputSchema: z.object({ key: z.string() }),
+ *       annotations: TOOL_ANNOTATIONS.readOnly,
+ *     }, async ({ key }) => ({ content: [{ type: 'text', text: await lookup(key) }] }));
+ *     server.registerPrompt('find', {
+ *       argsSchema: z.object({ key: completable(z.string(), (v) => ['foo', 'bar'].filter((k) => k.startsWith(v))) }),
+ *     }, ({ key }) => ({ messages: [{ role: 'user', content: { type: 'text', text: `Find ${key}` } }] }));
+ *     return server;
+ *   }
  *
- *   server.registerTool('lookup', {
- *     description: 'Look up data by key',
- *     inputSchema: { key: z.string() },
- *     outputSchema: { value: z.string(), found: z.boolean() },
- *     annotations: TOOL_ANNOTATIONS.readOnly,
- *   }, async ({ key }) => {
- *     const value = await lookup(key);
- *     return {
- *       content: [{ type: 'text', text: value ?? 'not found' }],
- *       structuredContent: { value: value ?? '', found: value !== null },
- *     };
- *   });
- *
- *   server.registerPrompt('find-and-summarise', {
- *     title: 'Find and summarise',
- *     description: 'Look up a key and summarise the value',
- *     argsSchema: { key: completable(z.string(), val => ['foo', 'bar'].filter(k => k.startsWith(val))) },
- *   }, ({ key }) => ({
- *     messages: [{ role: 'user', content: { type: 'text', text: `Look up "${key}" and summarise the result.` } }],
- *   }));
+ * An optional completable argument is written `completable(z.string(), cb).optional()`; the inverse
+ * nesting `completable(z.string().optional(), cb)` silently yields no completions in SDK v2.
  */
-export { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export { completable } from '@modelcontextprotocol/sdk/server/completable.js';
-export type { ToolAnnotations as McpToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
-export type { CallToolResult as McpCallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { type Implementation, McpServer, type McpServerOptions, type RequestStateCodec } from '@modelcontextprotocol/server';
+export type { AuthInfo, CallToolResult as McpCallToolResult, EmbeddedResource, GetPromptResult, Implementation, InputRequests, InputRequiredResult, InputResponses, McpServerOptions, OAuthTokenVerifier, ReadResourceResult, RegisteredPrompt, RegisteredResource, RegisteredResourceTemplate, RegisteredTool, RequestStateCodec, Resource, ResourceLink, ScopeChallengeHandler, ServerContext, ToolAnnotations as McpToolAnnotations, } from '@modelcontextprotocol/server';
+export { acceptedContent, completable, createRequestStateCodec, fromJsonSchema, inputRequired, inputResponse, McpServer, OAuthError, OAuthErrorCode, ProtocolError, ProtocolErrorCode, ResourceNotFoundError, ResourceTemplate, requireScopes, Server, UrlElicitationRequiredError, } from '@modelcontextprotocol/server';
 /**
  * Standard tool annotation presets.
  *
  * Pass one of these (or a spread of multiple) to `annotations` in `registerTool`.
- * These are HINTS — clients may or may not act on them.
+ * These are HINTS; clients may or may not act on them.
  *
  * @example
  *   annotations: TOOL_ANNOTATIONS.readOnly
@@ -68,13 +60,73 @@ export declare const TOOL_ANNOTATIONS: {
         destructiveHint: true;
         idempotentHint: false;
     };
+    /** `readOnly` + `openWorldHint` (lookups against an external API). */
+    readonly readOnlyOpenWorld: {
+        readOnlyHint: true;
+        idempotentHint: true;
+        openWorldHint: true;
+    };
+    /** `idempotentWrite` + `openWorldHint`. */
+    readonly idempotentWriteOpenWorld: {
+        readOnlyHint: false;
+        idempotentHint: true;
+        openWorldHint: true;
+    };
+    /** `mutableWrite` + `openWorldHint`. */
+    readonly mutableWriteOpenWorld: {
+        readOnlyHint: false;
+        idempotentHint: false;
+        openWorldHint: true;
+    };
+    /** `destructive` + `openWorldHint`. */
+    readonly destructiveOpenWorld: {
+        readOnlyHint: false;
+        destructiveHint: true;
+        idempotentHint: false;
+        openWorldHint: true;
+    };
 };
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/** mcp-core's default cache hints: tool lists are static per process, private while they may vary by caller. */
+export declare const DEFAULT_CACHE_HINTS: NonNullable<McpServerOptions['cacheHints']>;
+/** `McpServerOptions` (the SDK's, passed through) plus mcp-core's own switches. */
+export interface CreateMcpServerOptions extends McpServerOptions {
+    /**
+     * Page size for `tools/list` (and `prompts/list`, `resources/list`, `resources/templates/list`).
+     * Default `MCP_LIST_PAGE_SIZE`, else 100; 0 disables list pagination.
+     */
+    listPageSize?: number;
+    /**
+     * Advertise the `logging` capability and forward logger entries to the client as MCP logging
+     * notifications (deprecated by 2026-07-28, functional for at least twelve months). Default
+     * `LOG_PROTOCOL`, else false.
+     */
+    protocolLogging?: boolean;
+    /**
+     * The requestState codec for multi-step flows (`requestStateCodecFromEnv()`, or the SDK's HMAC
+     * `createRequestStateCodec`): installed as `requestState.verify`, and used by `ToolContext.continueWith`
+     * to mint and by `ToolContext.requestState()` to read the verified payload.
+     */
+    requestStateCodec?: RequestStateCodec;
+}
+/** The requestState codec `createMcpServer` installed on `server`, if any. */
+export declare function requestStateCodecOf(server: McpServer): RequestStateCodec | undefined;
 /**
- * Create a pre-configured McpServer instance.
+ * Create a pre-configured McpServer instance (call it inside the factory handed to `startMcpServer`:
+ * in SDK v2 one instance serves one connection).
+ *
+ * Accepts the full `Implementation` (`name`, `version`, `title`, `description`, `websiteUrl`, `icons`)
+ * or the `(name, version)` shorthand, and the SDK's `McpServerOptions` (`instructions`, `capabilities`,
+ * `cacheHints`, `maxToolInputElements`, `inputRequired`, `requestState`, ...), with mcp-core defaults:
+ *
+ * - `cacheHints`: `tools/list` private for 5 minutes (`DEFAULT_CACHE_HINTS`), merged under yours;
+ * - `maxToolInputElements`: `MCP_MAX_TOOL_INPUT_ELEMENTS`, else 10000;
+ * - list pagination on (`listPageSize`);
+ * - protocol logging off unless `protocolLogging` / `LOG_PROTOCOL`.
  *
- * Thin wrapper kept so individual servers import only from @novorb/mcp-core and
- * don't carry a direct @modelcontextprotocol/sdk import.
+ * List capabilities (`tools`, `prompts`, `resources`) passed in `capabilities` are registered after the
+ * list pagination hook is in place; the SDK then installs the list handler on the first registration
+ * (a capability declared with nothing registered is answered by no list handler).
  */
-export declare function createMcpServer(name: string, version: string): McpServer;
+export declare function createMcpServer(info: Implementation, options?: CreateMcpServerOptions): McpServer;
+export declare function createMcpServer(name: string, version: string, options?: CreateMcpServerOptions): McpServer;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAMH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAC9E,YAAY,EAAE,eAAe,IAAI,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAChG,YAAY,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAQ9F;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB;IAC3B,4EAA4E;;;;;IAE5E,iEAAiE;;;;;IAEjE,kEAAkE;;;;;IAElE,sDAAsD;;;;;;CAE9C,CAAC;AAMX,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAExE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EACL,KAAK,cAAc,EACnB,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAGvB,MAAM,8BAA8B,CAAC;AAOtC,YAAY,EACV,QAAQ,EACR,cAAc,IAAI,iBAAiB,EACnC,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,EAC1B,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,qBAAqB,EACrB,aAAa,EACb,eAAe,IAAI,kBAAkB,GACtC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,eAAe,EACf,WAAW,EACX,uBAAuB,EACvB,cAAc,EACd,aAAa,EACb,aAAa,EACb,SAAS,EACT,UAAU,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,MAAM,EACN,2BAA2B,GAC5B,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB;IAC3B,4EAA4E;;;;;IAE5E,iEAAiE;;;;;IAEjE,kEAAkE;;;;;IAElE,sDAAsD;;;;;;IAItD,sEAAsE;;;;;;IAEtE,2CAA2C;;;;;;IAM3C,wCAAwC;;;;;;IAExC,uCAAuC;;;;;;;CAO/B,CAAC;AAEX,gHAAgH;AAChH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAE3E,CAAC;AAEF,mFAAmF;AACnF,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAID,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAEpF;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;AACnG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC"}