@cyanheads/mcp-ts-core 0.11.2 → 0.11.3

package/dist/utils/parsing/inputBudget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inputBudget.d.ts","sourceRoot":"","sources":["../../../src/utils/parsing/inputBudget.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,2DAA2D;AAC3D,eAAO,MAAM,6BAA6B,QAAc,CAAC;AAEzD,wDAAwD;AACxD,eAAO,MAAM,+BAA+B,QAAmB,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAgBD,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAyBpD;AAcD,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,MAAM,CAG/F;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,OAAO,CAAC,EAAE,wBAAwB,GACjC,MAAM,CAGR;AAED,gGAAgG;AAChG,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,CAAC,UAAU,GAAG,WAAW,CAAC,EAAE,EAC7C,OAAO,CAAC,EAAE,wBAAwB,GACjC,MAAM,CAIR"}
+{"version":3,"file":"inputBudget.d.ts","sourceRoot":"","sources":["../../../src/utils/parsing/inputBudget.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,eAAO,MAAM,6BAA6B,QAAc,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,+BAA+B,QAAmB,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAeD,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAyBpD;AAcD,8FAA8F;AAC9F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,MAAM,CAE/F;AAED,0FAA0F;AAC1F,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,OAAO,CAAC,EAAE,wBAAwB,GACjC,MAAM,CAER;AAED,gGAAgG;AAChG,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,CAAC,UAAU,GAAG,WAAW,CAAC,EAAE,EAC7C,OAAO,CAAC,EAAE,wBAAwB,GACjC,MAAM,CAGR"}

package/dist/utils/parsing/inputBudget.js

@@ -1,22 +1,28 @@
 /**
- * @fileoverview Input byte budgets shared by the parsing utilities. Bounds the
- * work a single parse can schedule, so a hostile document cannot amplify a
- * modest request into unbounded CPU or memory in the parser dependency.
+ * @fileoverview Opt-in input byte budgets shared by the parsing utilities. A
+ * parser is unbounded unless its caller supplies `maxBytes`: the input is
+ * already resident in memory by the time a parser sees it, so a budget is a
+ * caller's work-shaping knob rather than a trust boundary.
  * @module src/utils/parsing/inputBudget
  */
 import { validationError } from '../../types-global/errors.js';
-/** Default UTF-8 input budget for text parsers (1 MiB). */
+/**
+ * Suggested UTF-8 input budget for text parsers (1 MiB). Not applied unless a
+ * caller passes it as `maxBytes`.
+ */
 export const DEFAULT_TEXT_PARSER_MAX_BYTES = 1024 * 1024;
-/** Default input budget for binary parsers (25 MiB). */
+/**
+ * Suggested input budget for binary parsers (25 MiB). Not applied unless a
+ * caller passes it as `maxBytes`.
+ */
 export const DEFAULT_BINARY_PARSER_MAX_BYTES = 25 * 1024 * 1024;
-function resolveLimit(options, defaultLimit) {
+function resolveLimit(options) {
     const requested = options?.maxBytes;
     if (requested === undefined)
-        return defaultLimit;
+        return;
     if (!Number.isSafeInteger(requested) || requested < 1) {
         throw validationError('Parser input byte limit must be a positive safe integer.', {
             reason: 'parser_input_limit_invalid',
-            limitBytes: defaultLimit,
         });
     }
     return requested;
@@ -48,7 +54,7 @@ export function utf8ByteLength(input) {
     return bytes;
 }
 function assertWithinLimit(sizeBytes, limitBytes) {
-    if (sizeBytes > limitBytes) {
+    if (limitBytes !== undefined && sizeBytes > limitBytes) {
         throw validationError('Parser input exceeds the maximum allowed byte size.', {
             reason: 'parser_input_too_large',
             sizeBytes,
@@ -57,20 +63,17 @@ function assertWithinLimit(sizeBytes, limitBytes) {
     }
     return sizeBytes;
 }
-/** Assert a text input fits its budget. Returns the input's UTF-8 byte length. */
+/** Assert a text input fits any budget the caller declared. Returns its UTF-8 byte length. */
 export function assertTextInputBudget(input, options) {
-    const limitBytes = resolveLimit(options, DEFAULT_TEXT_PARSER_MAX_BYTES);
-    return assertWithinLimit(utf8ByteLength(input), limitBytes);
+    return assertWithinLimit(utf8ByteLength(input), resolveLimit(options));
 }
-/** Assert a binary input fits its budget. Returns the input's byte length. */
+/** Assert a binary input fits any budget the caller declared. Returns its byte length. */
 export function assertBinaryInputBudget(input, options) {
-    const limitBytes = resolveLimit(options, DEFAULT_BINARY_PARSER_MAX_BYTES);
-    return assertWithinLimit(input.byteLength, limitBytes);
+    return assertWithinLimit(input.byteLength, resolveLimit(options));
 }
 /** Assert a set of binary inputs fits one shared budget. Returns their combined byte length. */
 export function assertBinaryInputsBudget(inputs, options) {
-    const limitBytes = resolveLimit(options, DEFAULT_BINARY_PARSER_MAX_BYTES);
     const sizeBytes = inputs.reduce((total, input) => total + input.byteLength, 0);
-    return assertWithinLimit(sizeBytes, limitBytes);
+    return assertWithinLimit(sizeBytes, resolveLimit(options));
 }
 //# sourceMappingURL=inputBudget.js.map

package/dist/utils/parsing/inputBudget.js.map

@@ -1 +1 @@
-{"version":3,"file":"inputBudget.js","sourceRoot":"","sources":["../../../src/utils/parsing/inputBudget.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"inputBudget.js","sourceRoot":"","sources":["../../../src/utils/parsing/inputBudget.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,GAAG,IAAI,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAYhE,SAAS,YAAY,CAAC,OAA6C;IACjE,MAAM,SAAS,GAAG,OAAO,EAAE,QAAQ,CAAC;IACpC,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO;IAEpC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,eAAe,CAAC,0DAA0D,EAAE;YAChF,MAAM,EAAE,4BAA4B;SACrC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACrB,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,IACL,QAAQ,IAAI,MAAM;YAClB,QAAQ,IAAI,MAAM;YAClB,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM;YACxB,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,MAAM;YACrC,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,MAAM,EACrC,CAAC;YACD,KAAK,IAAI,CAAC,CAAC;YACX,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,CAAC;YACN,qEAAqE;YACrE,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB,EAAE,UAA8B;IAC1E,IAAI,UAAU,KAAK,SAAS,IAAI,SAAS,GAAG,UAAU,EAAE,CAAC;QACvD,MAAM,eAAe,CAAC,qDAAqD,EAAE;YAC3E,MAAM,EAAE,wBAAwB;YAChC,SAAS;YACT,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,OAAkC;IACrF,OAAO,iBAAiB,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,uBAAuB,CACrC,KAA+B,EAC/B,OAAkC;IAElC,OAAO,iBAAiB,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,wBAAwB,CACtC,MAA6C,EAC7C,OAAkC;IAElC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC/E,OAAO,iBAAiB,CAAC,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/utils/parsing/jsonParser.d.ts

@@ -1,4 +1,4 @@
-import { type RequestContext } from '../../utils/internal/requestContext.js';
+import { type RequestContext, type RequestContextLike } from '../../utils/internal/requestContext.js';
 import { type ParserInputBudgetOptions } from './inputBudget.js';
 /**
  * Bit flags specifying which partial JSON types are permissible during parsing.
@@ -68,8 +68,9 @@ export declare class JsonParser {
      *   and/or be a partial (incomplete) JSON value.
      * @param allowPartial - Bitwise OR combination of `Allow` flags controlling which
      *   partial JSON types are accepted. Defaults to `Allow.ALL`.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
-     * @param budget - Optional UTF-8 byte budget for the input. Defaults to 1 MiB.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
+     * @param budget - Optional UTF-8 byte budget for the input. Unbounded when omitted.
      * @returns The parsed JavaScript value cast to `T`.
      * @throws {McpError} With `ValidationError` if the string is empty after stripping the
      *   `<think>` block and trimming, or if `partial-json` fails to parse the content.
@@ -88,7 +89,7 @@ export declare class JsonParser {
      * console.log(result); // { items: [1, 2] }
      * ```
      */
-    parse<T = unknown>(jsonString: string, allowPartial?: number, context?: RequestContext, budget?: ParserInputBudgetOptions): Promise<T>;
+    parse<T = unknown>(jsonString: string, allowPartial?: number, context?: RequestContextLike | RequestContext, budget?: ParserInputBudgetOptions): Promise<T>;
 }
 /**
  * Singleton instance of `JsonParser`.

package/dist/utils/parsing/jsonParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonParser.d.ts","sourceRoot":"","sources":["../../../src/utils/parsing/jsonParser.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,cAAc,EAAyB,MAAM,oCAAoC,CAAC;AAChG,OAAO,EAAyB,KAAK,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAQxF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,KAAK;IAChB,6BAA6B;aAC7B,GAAG,EAAE,CAAG;IACR,6BAA6B;aAC7B,GAAG,EAAE,CAAG;IACR,4BAA4B;aAC5B,GAAG,EAAE,CAAG;IACR,6BAA6B;aAC7B,GAAG,EAAE,CAAG;IACR,iCAAiC;aACjC,IAAI,EAAE,EAAI;IACV,8BAA8B;aAC9B,IAAI,EAAE,EAAI;IACV,wBAAwB;aACxB,GAAG,EAAE,EAAI;IACT,+BAA+B;aAC/B,QAAQ,EAAE,GAAI;IACd,+BAA+B;aAC/B,SAAS,EAAE,GAAK;IAChB,0EAA0E;aAC1E,GAAG;IACH,sEAAsE;aACtE,OAAO;IACP,8EAA8E;aAC9E,IAAI;IACJ,8CAA8C;aAC9C,UAAU;IACV,+BAA+B;aAC/B,GAAG;CACK,CAAC;AAEX;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EACrB,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,MAAkB,EAChC,OAAO,CAAC,EAAE,cAAc,EACxB,MAAM,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,CAAC,CAAC,CAyDZ;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,UAAU,YAAmB,CAAC"}
+{"version":3,"file":"jsonParser.d.ts","sourceRoot":"","sources":["../../../src/utils/parsing/jsonParser.ts"],"names":[],"mappings":"AASA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EAExB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAyB,KAAK,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAQxF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,KAAK;IAChB,6BAA6B;aAC7B,GAAG,EAAE,CAAG;IACR,6BAA6B;aAC7B,GAAG,EAAE,CAAG;IACR,4BAA4B;aAC5B,GAAG,EAAE,CAAG;IACR,6BAA6B;aAC7B,GAAG,EAAE,CAAG;IACR,iCAAiC;aACjC,IAAI,EAAE,EAAI;IACV,8BAA8B;aAC9B,IAAI,EAAE,EAAI;IACV,wBAAwB;aACxB,GAAG,EAAE,EAAI;IACT,+BAA+B;aAC/B,QAAQ,EAAE,GAAI;IACd,+BAA+B;aAC/B,SAAS,EAAE,GAAK;IAChB,0EAA0E;aAC1E,GAAG;IACH,sEAAsE;aACtE,OAAO;IACP,8EAA8E;aAC9E,IAAI;IACJ,8CAA8C;aAC9C,UAAU;IACV,+BAA+B;aAC/B,GAAG;CACK,CAAC;AAEX;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EACrB,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,MAAkB,EAChC,OAAO,CAAC,EAAE,kBAAkB,GAAG,cAAc,EAC7C,MAAM,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,CAAC,CAAC,CAyDZ;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/utils/parsing/jsonParser.js

@@ -7,7 +7,7 @@
 import { validationError } from '../../types-global/errors.js';
 import { lazyImport } from '../../utils/internal/lazyImport.js';
 import { logger } from '../../utils/internal/logger.js';
-import { requestContextService } from '../../utils/internal/requestContext.js';
+import { requestContextService, } from '../../utils/internal/requestContext.js';
 import { assertTextInputBudget } from './inputBudget.js';
 import { thinkBlockRegex } from './thinkBlock.js';
 const getPartialJson = lazyImport(() => import('partial-json'), 'Install "partial-json" to use partial JSON parsing: bun add partial-json');
@@ -79,8 +79,9 @@ export class JsonParser {
      *   and/or be a partial (incomplete) JSON value.
      * @param allowPartial - Bitwise OR combination of `Allow` flags controlling which
      *   partial JSON types are accepted. Defaults to `Allow.ALL`.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
-     * @param budget - Optional UTF-8 byte budget for the input. Defaults to 1 MiB.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
+     * @param budget - Optional UTF-8 byte budget for the input. Unbounded when omitted.
      * @returns The parsed JavaScript value cast to `T`.
      * @throws {McpError} With `ValidationError` if the string is empty after stripping the
      *   `<think>` block and trimming, or if `partial-json` fails to parse the content.
@@ -140,7 +141,7 @@ export class JsonParser {
                 errorDetails: error.message,
                 contentAttempted: stringToParse.substring(0, 200),
             });
-            throw validationError('Failed to parse JSON content.', { reason: 'json_parse_failed' }, { cause: error });
+            throw validationError(`Failed to parse JSON content: ${error.message}`, { reason: 'json_parse_failed' }, { cause: error });
         }
     }
 }

package/dist/utils/parsing/jsonParser.js.map

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

package/dist/utils/parsing/pdfParser.d.ts

@@ -5,7 +5,7 @@
  * @module src/utils/parsing/pdfParser
  */
 import type { PDFDocument, PDFFont, PDFImage, PDFPage, RGB } from 'pdf-lib';
-import { type RequestContext } from '../../utils/internal/requestContext.js';
+import { type RequestContext, type RequestContextLike } from '../../utils/internal/requestContext.js';
 import { type ParserInputBudgetOptions } from './inputBudget.js';
 /**
  * Options for adding a new page to a PDF document.
@@ -74,7 +74,7 @@ export interface EmbedImageOptions {
      * Image data as Uint8Array or ArrayBuffer.
      */
     imageBytes: Uint8Array | ArrayBuffer;
-    /** Input budget in bytes. Defaults to 25 MiB; raise it for known-large images. */
+    /** Input budget in bytes. Unbounded when omitted. */
     maxBytes?: number;
 }
 /**
@@ -211,8 +211,13 @@ export interface FillFormOptions {
  * Options for extracting text from a PDF document.
  */
 export interface ExtractTextOptions {
-    /** Input budget in bytes. Defaults to 25 MiB; raise it for known-large documents. */
+    /** Input budget in bytes. Unbounded when omitted. */
     maxBytes?: number;
+    /**
+     * Ceiling in pixels on a single decoded image, forwarded to pdf.js as
+     * `maxImageSize`. Unbounded when omitted, matching pdf.js's own default.
+     */
+    maxImageSize?: number;
     /**
      * Whether to merge all pages into a single string.
      * If true, returns text as a single string.
@@ -250,7 +255,8 @@ export declare class PdfParser {
      *
      * Async due to lazy loading of the `pdf-lib` peer dependency (`bun add pdf-lib`).
      *
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
      * @returns A new empty `PDFDocument` instance.
      * @throws {McpError} With `ConfigurationError` if `pdf-lib` is not installed.
      * @throws {McpError} With `InternalError` if document creation fails.
@@ -260,15 +266,16 @@ export declare class PdfParser {
      * const page = pdfParser.addPage(doc);
      * ```
      */
-    createDocument(context?: RequestContext): Promise<PDFDocument>;
+    createDocument(context?: RequestContextLike | RequestContext): Promise<PDFDocument>;
     /**
      * Loads an existing PDF document from raw bytes.
      *
      * Async due to lazy loading of the `pdf-lib` peer dependency (`bun add pdf-lib`).
      *
      * @param pdfBytes - The PDF file contents as `Uint8Array` or `ArrayBuffer`.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
-     * @param budget - Optional byte budget for the input. Defaults to 25 MiB.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
+     * @param budget - Optional byte budget for the input. Unbounded when omitted.
      * @returns The loaded `PDFDocument` instance.
      * @throws {McpError} With `ConfigurationError` if `pdf-lib` is not installed.
      * @throws {McpError} With `ValidationError` if the bytes are not a valid PDF.
@@ -279,7 +286,7 @@ export declare class PdfParser {
      * const doc = await pdfParser.loadDocument(pdfBytes);
      * ```
      */
-    loadDocument(pdfBytes: Uint8Array | ArrayBuffer, context?: RequestContext, budget?: ParserInputBudgetOptions): Promise<PDFDocument>;
+    loadDocument(pdfBytes: Uint8Array | ArrayBuffer, context?: RequestContextLike | RequestContext, budget?: ParserInputBudgetOptions): Promise<PDFDocument>;
     /**
      * Adds a new blank page to a PDF document.
      *
@@ -303,7 +310,8 @@ export declare class PdfParser {
      *
      * @param doc - The `PDFDocument` to embed the font into.
      * @param fontName - A `StandardFonts` key. Defaults to `'Helvetica'`.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
      * @returns The embedded `PDFFont` ready to pass to `drawText`.
      * @throws {McpError} With `ConfigurationError` if `pdf-lib` is not installed.
      * @throws {McpError} With `InternalError` if the font name is invalid or embedding fails.
@@ -312,7 +320,7 @@ export declare class PdfParser {
      * const font = await pdfParser.embedFont(doc, 'TimesRoman');
      * ```
      */
-    embedFont(doc: PDFDocument, fontName?: string, context?: RequestContext): Promise<PDFFont>;
+    embedFont(doc: PDFDocument, fontName?: string, context?: RequestContextLike | RequestContext): Promise<PDFFont>;
     /**
      * Embeds a PNG or JPEG image into a PDF document for later rendering.
      *
@@ -321,7 +329,8 @@ export declare class PdfParser {
      *
      * @param doc - The `PDFDocument` to embed the image into.
      * @param options - Image bytes and format (`'png'` or `'jpg'`).
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
      * @returns The embedded `PDFImage`, usable as the `image` option in `drawImage`.
      * @throws {McpError} With `ConfigurationError` if `pdf-lib` is not installed.
      * @throws {McpError} With `InternalError` if the image data is invalid or embedding fails.
@@ -333,7 +342,7 @@ export declare class PdfParser {
      * pdfParser.drawImage(page, { image, x: 50, y: 700, width: 100, height: 50 });
      * ```
      */
-    embedImage(doc: PDFDocument, options: EmbedImageOptions, context?: RequestContext): Promise<PDFImage>;
+    embedImage(doc: PDFDocument, options: EmbedImageOptions, context?: RequestContextLike | RequestContext): Promise<PDFImage>;
     /**
      * Draws text on a PDF page with optional font, size, color, rotation, and word-wrap.
      *
@@ -391,8 +400,9 @@ export declare class PdfParser {
      * `pdf-lib` (`bun add pdf-lib`).
      *
      * @param pdfBytesArray - Source PDF files as `Uint8Array` or `ArrayBuffer` elements.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
-     * @param budget - Optional aggregate byte budget across all inputs. Defaults to 25 MiB.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
+     * @param budget - Optional aggregate byte budget across all inputs. Unbounded when omitted.
      * @returns A new `PDFDocument` containing all pages from the input documents.
      * @throws {McpError} With `ConfigurationError` if `pdf-lib` is not installed.
      * @throws {McpError} With `InternalError` if any source PDF is invalid or merging fails.
@@ -405,7 +415,7 @@ export declare class PdfParser {
      * const bytes = await pdfParser.saveDocument(merged);
      * ```
      */
-    mergePdfs(pdfBytesArray: (Uint8Array | ArrayBuffer)[], context?: RequestContext, budget?: ParserInputBudgetOptions): Promise<PDFDocument>;
+    mergePdfs(pdfBytesArray: (Uint8Array | ArrayBuffer)[], context?: RequestContextLike | RequestContext, budget?: ParserInputBudgetOptions): Promise<PDFDocument>;
     /**
      * Splits a PDF document into multiple new documents based on page ranges.
      *
@@ -415,8 +425,9 @@ export declare class PdfParser {
      *
      * @param pdfBytes - The source PDF as `Uint8Array` or `ArrayBuffer`.
      * @param ranges - Page ranges to extract; each produces one output document.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
-     * @param budget - Optional byte budget for the input. Defaults to 25 MiB.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
+     * @param budget - Optional byte budget for the input. Unbounded when omitted.
      * @returns An array of new `PDFDocument` instances, one per range, in order.
      * @throws {McpError} With `ConfigurationError` if `pdf-lib` is not installed.
      * @throws {McpError} With `InternalError` if the source PDF is invalid or a page index is out of bounds.
@@ -430,7 +441,7 @@ export declare class PdfParser {
      * ]);
      * ```
      */
-    splitPdf(pdfBytes: Uint8Array | ArrayBuffer, ranges: PageRange[], context?: RequestContext, budget?: ParserInputBudgetOptions): Promise<PDFDocument[]>;
+    splitPdf(pdfBytes: Uint8Array | ArrayBuffer, ranges: PageRange[], context?: RequestContextLike | RequestContext, budget?: ParserInputBudgetOptions): Promise<PDFDocument[]>;
     /**
      * Fills form fields in a PDF document.
      *
@@ -441,7 +452,8 @@ export declare class PdfParser {
      *
      * @param doc - The `PDFDocument` containing the AcroForm.
      * @param options - Map of field names to values, plus optional `flatten` flag.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
      * @throws {McpError} With `InternalError` if the overall form operation fails.
      * @example
      * ```typescript
@@ -455,7 +467,7 @@ export declare class PdfParser {
      * });
      * ```
      */
-    fillForm(doc: PDFDocument, options: FillFormOptions, context?: RequestContext): void;
+    fillForm(doc: PDFDocument, options: FillFormOptions, context?: RequestContextLike | RequestContext): void;
     /**
      * Extracts metadata from a PDF document.
      *
@@ -504,7 +516,8 @@ export declare class PdfParser {
      * @param input - Raw PDF bytes (`Uint8Array` | `ArrayBuffer`) or a loaded `PDFDocument`.
      * @param options - Optional extraction options. Set `mergePages: true` to get a
      *   single concatenated string instead of one string per page.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
      * @returns An `ExtractTextResult` with `totalPages` and `text` — a `string[]` (one
      *   per page) by default, or a single `string` when `mergePages` is `true`.
      * @throws {McpError} With `ConfigurationError` if `unpdf` is not installed (or
@@ -521,7 +534,7 @@ export declare class PdfParser {
      * const perPage = await pdfParser.extractText(doc);
      * ```
      */
-    extractText(input: PDFDocument | Uint8Array | ArrayBuffer, options?: ExtractTextOptions, context?: RequestContext): Promise<ExtractTextResult>;
+    extractText(input: PDFDocument | Uint8Array | ArrayBuffer, options?: ExtractTextOptions, context?: RequestContextLike | RequestContext): Promise<ExtractTextResult>;
     /**
      * Serializes a PDF document to a `Uint8Array` for writing to disk or transmission.
      *
@@ -529,7 +542,8 @@ export declare class PdfParser {
      * compatible). Does not reload peer dependencies if already cached.
      *
      * @param doc - The `PDFDocument` to serialize.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
      * @returns The complete PDF file as a `Uint8Array`.
      * @throws {McpError} With `InternalError` if serialization fails.
      * @example
@@ -539,7 +553,7 @@ export declare class PdfParser {
      * await writeFile('output.pdf', pdfBytes);
      * ```
      */
-    saveDocument(doc: PDFDocument, context?: RequestContext): Promise<Uint8Array>;
+    saveDocument(doc: PDFDocument, context?: RequestContextLike | RequestContext): Promise<Uint8Array>;
 }
 /**
  * Singleton instance of `PdfParser`.

package/dist/utils/parsing/pdfParser.d.ts.map

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

package/dist/utils/parsing/pdfParser.js

@@ -1,24 +1,26 @@
 import { JsonRpcErrorCode, McpError } from '../../types-global/errors.js';
 import { lazyImport } from '../../utils/internal/lazyImport.js';
 import { logger } from '../../utils/internal/logger.js';
-import { requestContextService } from '../../utils/internal/requestContext.js';
+import { requestContextService, } from '../../utils/internal/requestContext.js';
 import { assertBinaryInputBudget, assertBinaryInputsBudget, } from './inputBudget.js';
 const getPdfLib = lazyImport(() => import('pdf-lib'), 'Install "pdf-lib" to use PDF operations: bun add pdf-lib');
 const getUnpdf = lazyImport(() => import('unpdf'), 'Install "unpdf" to use PDF text extraction: bun add unpdf');
 /**
- * Build the client-facing PDF failure envelope without copying parser/library
- * diagnostics into `McpError.data` or `message`. The original failure remains
- * available to the internal error pipeline through `cause`.
+ * Build the client-facing PDF failure envelope: a fixed summary plus the
+ * library's own diagnostic, which is what tells a caller how to repair the
+ * input. `data` carries only the stable `reason` discriminator — never a
+ * content sample or a stack, both of which stay on `cause` for the internal
+ * error pipeline.
  *
  * An `McpError` thrown from inside the operation is already classified and
  * client-safe — most often the `ConfigurationError` a lazy import raises for a
  * missing peer dependency — so it passes through with its code and remediation
  * intact rather than being relabelled as a PDF failure.
  */
-function pdfFailure(code, message, reason, cause) {
+function pdfFailure(code, summary, reason, cause) {
     if (cause instanceof McpError)
         return cause;
-    return new McpError(code, message, { reason }, { cause });
+    return new McpError(code, `${summary}: ${cause.message}`, { reason }, { cause });
 }
 /**
  * Utility class for creating, modifying, and parsing PDF documents.
@@ -34,7 +36,8 @@ export class PdfParser {
      *
      * Async due to lazy loading of the `pdf-lib` peer dependency (`bun add pdf-lib`).
      *
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
      * @returns A new empty `PDFDocument` instance.
      * @throws {McpError} With `ConfigurationError` if `pdf-lib` is not installed.
      * @throws {McpError} With `InternalError` if document creation fails.
@@ -61,7 +64,7 @@ export class PdfParser {
                 ...logContext,
                 errorDetails: error.message,
             });
-            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to create PDF document.', 'pdf_create_failed', error);
+            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to create PDF document', 'pdf_create_failed', error);
         }
     }
     /**
@@ -70,8 +73,9 @@ export class PdfParser {
      * Async due to lazy loading of the `pdf-lib` peer dependency (`bun add pdf-lib`).
      *
      * @param pdfBytes - The PDF file contents as `Uint8Array` or `ArrayBuffer`.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
-     * @param budget - Optional byte budget for the input. Defaults to 25 MiB.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
+     * @param budget - Optional byte budget for the input. Unbounded when omitted.
      * @returns The loaded `PDFDocument` instance.
      * @throws {McpError} With `ConfigurationError` if `pdf-lib` is not installed.
      * @throws {McpError} With `ValidationError` if the bytes are not a valid PDF.
@@ -103,7 +107,7 @@ export class PdfParser {
                 ...logContext,
                 errorDetails: error.message,
             });
-            throw pdfFailure(JsonRpcErrorCode.ValidationError, 'Failed to load PDF document.', 'pdf_load_failed', error);
+            throw pdfFailure(JsonRpcErrorCode.ValidationError, 'Failed to load PDF document', 'pdf_load_failed', error);
         }
     }
     /**
@@ -133,7 +137,8 @@ export class PdfParser {
      *
      * @param doc - The `PDFDocument` to embed the font into.
      * @param fontName - A `StandardFonts` key. Defaults to `'Helvetica'`.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
      * @returns The embedded `PDFFont` ready to pass to `drawText`.
      * @throws {McpError} With `ConfigurationError` if `pdf-lib` is not installed.
      * @throws {McpError} With `InternalError` if the font name is invalid or embedding fails.
@@ -163,7 +168,7 @@ export class PdfParser {
                 fontName,
                 errorDetails: error.message,
             });
-            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to embed PDF font.', 'pdf_font_embed_failed', error);
+            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to embed PDF font', 'pdf_font_embed_failed', error);
         }
     }
     /**
@@ -174,7 +179,8 @@ export class PdfParser {
      *
      * @param doc - The `PDFDocument` to embed the image into.
      * @param options - Image bytes and format (`'png'` or `'jpg'`).
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
      * @returns The embedded `PDFImage`, usable as the `image` option in `drawImage`.
      * @throws {McpError} With `ConfigurationError` if `pdf-lib` is not installed.
      * @throws {McpError} With `InternalError` if the image data is invalid or embedding fails.
@@ -209,7 +215,7 @@ export class PdfParser {
                 format: options.format,
                 errorDetails: error.message,
             });
-            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to embed PDF image.', 'pdf_image_embed_failed', error);
+            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to embed PDF image', 'pdf_image_embed_failed', error);
         }
     }
     /**
@@ -331,8 +337,9 @@ export class PdfParser {
      * `pdf-lib` (`bun add pdf-lib`).
      *
      * @param pdfBytesArray - Source PDF files as `Uint8Array` or `ArrayBuffer` elements.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
-     * @param budget - Optional aggregate byte budget across all inputs. Defaults to 25 MiB.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
+     * @param budget - Optional aggregate byte budget across all inputs. Unbounded when omitted.
      * @returns A new `PDFDocument` containing all pages from the input documents.
      * @throws {McpError} With `ConfigurationError` if `pdf-lib` is not installed.
      * @throws {McpError} With `InternalError` if any source PDF is invalid or merging fails.
@@ -377,7 +384,7 @@ export class PdfParser {
                 ...logContext,
                 errorDetails: error.message,
             });
-            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to merge PDF documents.', 'pdf_merge_failed', error);
+            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to merge PDF documents', 'pdf_merge_failed', error);
         }
     }
     /**
@@ -389,8 +396,9 @@ export class PdfParser {
      *
      * @param pdfBytes - The source PDF as `Uint8Array` or `ArrayBuffer`.
      * @param ranges - Page ranges to extract; each produces one output document.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
-     * @param budget - Optional byte budget for the input. Defaults to 25 MiB.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
+     * @param budget - Optional byte budget for the input. Unbounded when omitted.
      * @returns An array of new `PDFDocument` instances, one per range, in order.
      * @throws {McpError} With `ConfigurationError` if `pdf-lib` is not installed.
      * @throws {McpError} With `InternalError` if the source PDF is invalid or a page index is out of bounds.
@@ -441,7 +449,7 @@ export class PdfParser {
                 ...logContext,
                 errorDetails: error.message,
             });
-            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to split PDF document.', 'pdf_split_failed', error);
+            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to split PDF document', 'pdf_split_failed', error);
         }
     }
     /**
@@ -454,7 +462,8 @@ export class PdfParser {
      *
      * @param doc - The `PDFDocument` containing the AcroForm.
      * @param options - Map of field names to values, plus optional `flatten` flag.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
      * @throws {McpError} With `InternalError` if the overall form operation fails.
      * @example
      * ```typescript
@@ -524,7 +533,7 @@ export class PdfParser {
                 ...logContext,
                 errorDetails: error.message,
             });
-            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to fill PDF form.', 'pdf_form_fill_failed', error);
+            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to fill PDF form', 'pdf_form_fill_failed', error);
         }
     }
     /**
@@ -617,7 +626,8 @@ export class PdfParser {
      * @param input - Raw PDF bytes (`Uint8Array` | `ArrayBuffer`) or a loaded `PDFDocument`.
      * @param options - Optional extraction options. Set `mergePages: true` to get a
      *   single concatenated string instead of one string per page.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
      * @returns An `ExtractTextResult` with `totalPages` and `text` — a `string[]` (one
      *   per page) by default, or a single `string` when `mergePages` is `true`.
      * @throws {McpError} With `ConfigurationError` if `unpdf` is not installed (or
@@ -657,7 +667,7 @@ export class PdfParser {
                     ...logContext,
                     errorDetails: error.message,
                 });
-                throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to extract text from PDF.', 'pdf_text_extract_failed', error);
+                throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to extract text from PDF', 'pdf_text_extract_failed', error);
             }
             assertBinaryInputBudget(rawBytes, options);
             pdfBytes = rawBytes;
@@ -669,9 +679,9 @@ export class PdfParser {
                 inputKind: isBytes ? 'bytes' : 'document',
             });
             const { getDocumentProxy, extractText: unpdfExtractText } = await getUnpdf();
-            // Cap decoded images at 4096×4096 pixels (pdf.js defaults to unbounded), so a
-            // crafted page cannot force a huge raster allocation during extraction.
-            const pdfProxy = await getDocumentProxy(pdfBytes, { maxImageSize: 4096 * 4096 });
+            const pdfProxy = options?.maxImageSize === undefined
+                ? await getDocumentProxy(pdfBytes)
+                : await getDocumentProxy(pdfBytes, { maxImageSize: options.maxImageSize });
             const result = mergePages
                 ? await unpdfExtractText(pdfProxy, { mergePages: true })
                 : await unpdfExtractText(pdfProxy, { mergePages: false });
@@ -693,7 +703,7 @@ export class PdfParser {
                 ...logContext,
                 errorDetails: error.message,
             });
-            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to extract text from PDF.', 'pdf_text_extract_failed', error);
+            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to extract text from PDF', 'pdf_text_extract_failed', error);
         }
     }
     /**
@@ -703,7 +713,8 @@ export class PdfParser {
      * compatible). Does not reload peer dependencies if already cached.
      *
      * @param doc - The `PDFDocument` to serialize.
-     * @param context - Optional `RequestContext` for correlated logging and error metadata.
+     * @param context - Optional context for correlated logging and error metadata. The
+     *   handler `Context` is accepted directly.
      * @returns The complete PDF file as a `Uint8Array`.
      * @throws {McpError} With `InternalError` if serialization fails.
      * @example
@@ -733,7 +744,7 @@ export class PdfParser {
                 ...logContext,
                 errorDetails: error.message,
             });
-            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to save PDF document.', 'pdf_save_failed', error);
+            throw pdfFailure(JsonRpcErrorCode.InternalError, 'Failed to save PDF document', 'pdf_save_failed', error);
         }
     }
 }