codepage-bridge-mcp 0.1.0

package/dist/src/filesystem/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/filesystem/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAwB/C,SAAS,MAAM,CAAC,MAAc;IAC5B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,OAAO,cAAc;IACR,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEzD,KAAK,CAAC,QAAiB;QACrB,IAAI,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;;YAC5C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,KAAa,EAAE,UAA6B,EAAE;QACrE,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3F,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/F,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;QAC3D,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACtG,OAAO;YACL,MAAM,EAAE,cAAc;YACtB,OAAO,EAAE,MAAM,KAAK,CAAC,IAAI,GAAG,KAAK,KAAK,CAAC,MAAM,CAAC,MAAM;YACpD,MAAM;YACN,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC"}

package/dist/src/filesystem/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./atomic.js";
+export * from "./cache.js";
+export * from "./mutex.js";
+export * from "./path.js";

package/dist/src/filesystem/index.js

@@ -0,0 +1,5 @@
+export * from "./atomic.js";
+export * from "./cache.js";
+export * from "./mutex.js";
+export * from "./path.js";
+//# sourceMappingURL=index.js.map

package/dist/src/filesystem/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/filesystem/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/dist/src/filesystem/mutex.d.ts

@@ -0,0 +1,5 @@
+export declare class PathMutex {
+    private readonly tails;
+    runExclusive<T>(pathKey: string, operation: () => Promise<T>): Promise<T>;
+}
+export declare const pathMutex: PathMutex;

package/dist/src/filesystem/mutex.js

@@ -0,0 +1,23 @@
+export class PathMutex {
+    tails = new Map();
+    async runExclusive(pathKey, operation) {
+        const previous = this.tails.get(pathKey) ?? Promise.resolve();
+        let release;
+        const current = new Promise((resolve) => {
+            release = resolve;
+        });
+        const tail = previous.then(() => current);
+        this.tails.set(pathKey, tail);
+        await previous;
+        try {
+            return await operation();
+        }
+        finally {
+            release();
+            if (this.tails.get(pathKey) === tail)
+                this.tails.delete(pathKey);
+        }
+    }
+}
+export const pathMutex = new PathMutex();
+//# sourceMappingURL=mutex.js.map

package/dist/src/filesystem/mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.js","sourceRoot":"","sources":["../../../src/filesystem/mutex.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAS;IACH,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE1D,KAAK,CAAC,YAAY,CAAI,OAAe,EAAE,SAA2B;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC9D,IAAI,OAAoB,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,OAAO,GAAG,OAAO,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9B,MAAM,QAAQ,CAAC;QACf,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC"}

package/dist/src/filesystem/path.d.ts

@@ -0,0 +1,9 @@
+export interface SafePath {
+    root: string;
+    path: string;
+    target: string;
+    symbolicLink: boolean;
+}
+export declare function isPathWithin(candidate: string, root: string): boolean;
+export declare function resolveProjectPath(root: string, input: string): string;
+export declare function inspectProjectPath(root: string, input: string, allowMissing?: boolean): Promise<SafePath>;

package/dist/src/filesystem/path.js

@@ -0,0 +1,53 @@
+import { lstat, readlink, realpath } from "node:fs/promises";
+import path from "node:path";
+function containsNul(value) {
+    return value.includes("\0");
+}
+function isUnc(value) {
+    return /^[/\\]{2}/.test(value) || /^\\\\[?.]\\/.test(value);
+}
+export function isPathWithin(candidate, root) {
+    const relative = path.relative(root, candidate);
+    return relative === "" || (relative !== ".." && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative));
+}
+export function resolveProjectPath(root, input) {
+    if (containsNul(root) || containsNul(input))
+        throw new Error("Paths must not contain NUL bytes");
+    if (isUnc(root) || isUnc(input))
+        throw new Error("UNC and device paths are not allowed");
+    const absoluteRoot = path.resolve(root);
+    if (path.isAbsolute(input))
+        return path.resolve(input);
+    const candidate = path.resolve(absoluteRoot, input);
+    if (!isPathWithin(candidate, absoluteRoot))
+        throw new Error(`Path is outside project root: ${input}`);
+    return candidate;
+}
+export async function inspectProjectPath(root, input, allowMissing = false) {
+    const absoluteRoot = await realpath(path.resolve(root));
+    const candidate = resolveProjectPath(absoluteRoot, input);
+    try {
+        const info = await lstat(candidate);
+        if (info.isSymbolicLink()) {
+            const link = await readlink(candidate);
+            const target = await realpath(path.resolve(path.dirname(candidate), link));
+            if (!isPathWithin(target, absoluteRoot))
+                throw new Error(`Symbolic link escapes project root: ${input}`);
+            return { root: absoluteRoot, path: candidate, target, symbolicLink: true };
+        }
+        const target = await realpath(candidate);
+        if (!isPathWithin(target, absoluteRoot))
+            throw new Error(`Path escapes project root: ${input}`);
+        return { root: absoluteRoot, path: candidate, target, symbolicLink: false };
+    }
+    catch (error) {
+        const code = error.code;
+        if (!allowMissing || code !== "ENOENT")
+            throw error;
+        const parent = await realpath(path.dirname(candidate));
+        if (!isPathWithin(parent, absoluteRoot))
+            throw new Error(`Parent escapes project root: ${input}`);
+        return { root: absoluteRoot, path: candidate, target: candidate, symbolicLink: false };
+    }
+}
+//# sourceMappingURL=path.js.map

package/dist/src/filesystem/path.js.map

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

package/dist/src/media/errors.d.ts

@@ -0,0 +1,14 @@
+export type MediaErrorCode = "UNSUPPORTED_IMAGE" | "IMAGE_PROCESSING_FAILED" | "INVALID_PDF" | "INVALID_PAGES" | "PDF_PAGES_REQUIRED" | "FILE_TOO_LARGE" | "PDF_TOOL_FAILED" | "INVALID_NOTEBOOK" | "INVALID_CELL_REFERENCE" | "CELL_NOT_FOUND";
+export interface StructuredMediaError {
+    name: "MediaError";
+    code: MediaErrorCode;
+    message: string;
+    details?: Readonly<Record<string, unknown>>;
+}
+export declare class MediaError extends Error {
+    readonly code: MediaErrorCode;
+    readonly details?: Readonly<Record<string, unknown>>;
+    constructor(code: MediaErrorCode, message: string, details?: Readonly<Record<string, unknown>>, options?: ErrorOptions);
+    toJSON(): StructuredMediaError;
+}
+export declare function toStructuredMediaError(error: unknown): StructuredMediaError;

package/dist/src/media/errors.js

@@ -0,0 +1,29 @@
+export class MediaError extends Error {
+    code;
+    details;
+    constructor(code, message, details, options) {
+        super(message, options);
+        this.name = "MediaError";
+        this.code = code;
+        if (details !== undefined)
+            this.details = details;
+    }
+    toJSON() {
+        return {
+            name: "MediaError",
+            code: this.code,
+            message: this.message,
+            ...(this.details === undefined ? {} : { details: this.details }),
+        };
+    }
+}
+export function toStructuredMediaError(error) {
+    if (error instanceof MediaError)
+        return error.toJSON();
+    return {
+        name: "MediaError",
+        code: "IMAGE_PROCESSING_FAILED",
+        message: error instanceof Error ? error.message : String(error),
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/media/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/media/errors.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IACrB,OAAO,CAAqC;IAErD,YAAY,IAAoB,EAAE,OAAe,EAAE,OAA2C,EAAE,OAAsB;QACpH,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACpD,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;SACjE,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IACvD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KAChE,CAAC;AACJ,CAAC"}

package/dist/src/media/image.d.ts

@@ -0,0 +1,11 @@
+import type { BinaryFileReader, McpImageBlock } from "./types.js";
+export type SupportedImageMime = McpImageBlock["mimeType"];
+export interface ImageTransformOptions {
+    maxWidth?: number;
+    maxHeight?: number;
+    quality?: number;
+}
+export declare function detectImageMime(bytes: Uint8Array): SupportedImageMime | undefined;
+export declare function imageBytesToBlock(bytes: Uint8Array, mimeType?: SupportedImageMime): McpImageBlock;
+export declare function transformImage(bytes: Uint8Array, options?: ImageTransformOptions): Promise<McpImageBlock>;
+export declare function readImage(path: string, options?: ImageTransformOptions, files?: BinaryFileReader): Promise<McpImageBlock>;

package/dist/src/media/image.js

@@ -0,0 +1,81 @@
+import { readFile } from "node:fs/promises";
+import sharp from "sharp";
+import { MediaError } from "./errors.js";
+const defaultFileReader = { readFile };
+function hasBytes(bytes, offset, expected) {
+    return expected.every((value, index) => bytes[offset + index] === value);
+}
+function hasAscii(bytes, offset, expected) {
+    return [...expected].every((character, index) => bytes[offset + index] === character.charCodeAt(0));
+}
+export function detectImageMime(bytes) {
+    if (hasBytes(bytes, 0, [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]))
+        return "image/png";
+    if (hasBytes(bytes, 0, [0xff, 0xd8, 0xff]))
+        return "image/jpeg";
+    if (hasAscii(bytes, 0, "GIF87a") || hasAscii(bytes, 0, "GIF89a"))
+        return "image/gif";
+    if (hasAscii(bytes, 0, "RIFF") && hasAscii(bytes, 8, "WEBP"))
+        return "image/webp";
+    return undefined;
+}
+function validateOptions(options) {
+    for (const [name, value] of [["maxWidth", options.maxWidth], ["maxHeight", options.maxHeight]]) {
+        if (value !== undefined && (!Number.isInteger(value) || value <= 0)) {
+            throw new MediaError("IMAGE_PROCESSING_FAILED", `${name} must be a positive integer`, { [name]: value });
+        }
+    }
+    if (options.quality !== undefined && (!Number.isInteger(options.quality) || options.quality < 1 || options.quality > 100)) {
+        throw new MediaError("IMAGE_PROCESSING_FAILED", "quality must be an integer from 1 to 100", { quality: options.quality });
+    }
+}
+export function imageBytesToBlock(bytes, mimeType) {
+    const detectedMime = detectImageMime(bytes);
+    if (detectedMime === undefined || (mimeType !== undefined && detectedMime !== mimeType)) {
+        throw new MediaError("UNSUPPORTED_IMAGE", "Image content is not a supported PNG, JPEG, GIF, or WebP file");
+    }
+    return { type: "image", data: Buffer.from(bytes).toString("base64"), mimeType: detectedMime };
+}
+export async function transformImage(bytes, options = {}) {
+    validateOptions(options);
+    const mimeType = detectImageMime(bytes);
+    if (mimeType === undefined) {
+        throw new MediaError("UNSUPPORTED_IMAGE", "Image content is not a supported PNG, JPEG, GIF, or WebP file");
+    }
+    try {
+        let pipeline = sharp(bytes, { animated: mimeType === "image/gif" });
+        if (options.maxWidth !== undefined || options.maxHeight !== undefined) {
+            pipeline = pipeline.resize({
+                width: options.maxWidth,
+                height: options.maxHeight,
+                fit: "inside",
+                withoutEnlargement: true,
+            });
+        }
+        const quality = options.quality ?? 80;
+        switch (mimeType) {
+            case "image/jpeg":
+                pipeline = pipeline.jpeg({ quality, mozjpeg: true });
+                break;
+            case "image/png":
+                pipeline = pipeline.png({ compressionLevel: 9, quality });
+                break;
+            case "image/gif":
+                pipeline = pipeline.gif({ effort: 7 });
+                break;
+            case "image/webp":
+                pipeline = pipeline.webp({ quality, effort: 5 });
+                break;
+        }
+        return imageBytesToBlock(await pipeline.toBuffer(), mimeType);
+    }
+    catch (error) {
+        if (error instanceof MediaError)
+            throw error;
+        throw new MediaError("IMAGE_PROCESSING_FAILED", "Unable to process image", { mimeType }, { cause: error });
+    }
+}
+export async function readImage(path, options = {}, files = defaultFileReader) {
+    return transformImage(await files.readFile(path), options);
+}
+//# sourceMappingURL=image.js.map

package/dist/src/media/image.js.map

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

package/dist/src/media/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./errors.js";
+export * from "./image.js";
+export * from "./notebook.js";
+export * from "./pdf.js";
+export * from "./types.js";

package/dist/src/media/index.js

@@ -0,0 +1,6 @@
+export * from "./errors.js";
+export * from "./image.js";
+export * from "./notebook.js";
+export * from "./pdf.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/src/media/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/media/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/src/media/notebook.d.ts

@@ -0,0 +1,47 @@
+import type { DecodeBytes, McpContentBlock } from "./types.js";
+export type NotebookCellType = "code" | "markdown" | "raw";
+export interface NotebookOutput {
+    output_type?: string;
+    name?: string;
+    text?: string | string[];
+    data?: Record<string, unknown>;
+    ename?: string;
+    evalue?: string;
+    traceback?: string[];
+    [key: string]: unknown;
+}
+export interface NotebookCell {
+    id?: string;
+    cell_type: NotebookCellType;
+    source: string | string[];
+    metadata?: Record<string, unknown>;
+    outputs?: NotebookOutput[];
+    execution_count?: number | null;
+    [key: string]: unknown;
+}
+export interface NotebookDocument {
+    cells: NotebookCell[];
+    metadata?: Record<string, unknown>;
+    nbformat?: number;
+    nbformat_minor?: number;
+    [key: string]: unknown;
+}
+export interface ParsedNotebookCell {
+    id: string;
+    cellType: NotebookCellType;
+    content: McpContentBlock[];
+}
+export interface ReadNotebookOptions {
+    cell?: string;
+    outputLimit?: number;
+}
+export interface NotebookReadDependencies {
+    readFile(path: string): Promise<Uint8Array>;
+    decode: DecodeBytes;
+}
+export declare function parseNotebook(text: string): NotebookDocument;
+export declare function parseCellReference(reference: string): number;
+export declare function mapNotebookCell(cell: NotebookCell, index: number, outputLimit?: number): ParsedNotebookCell;
+export declare function mapNotebook(notebook: NotebookDocument, options?: ReadNotebookOptions): ParsedNotebookCell[];
+export declare function readNotebook(path: string, options: ReadNotebookOptions, dependencies: NotebookReadDependencies): Promise<ParsedNotebookCell[]>;
+export declare function createNotebookReader(decode: DecodeBytes): (path: string, options?: ReadNotebookOptions) => Promise<ParsedNotebookCell[]>;

package/dist/src/media/notebook.js

@@ -0,0 +1,122 @@
+import { readFile } from "node:fs/promises";
+import { imageBytesToBlock } from "./image.js";
+import { MediaError } from "./errors.js";
+function joinText(value) {
+    if (typeof value === "string")
+        return value;
+    if (Array.isArray(value) && value.every((part) => typeof part === "string"))
+        return value.join("");
+    return undefined;
+}
+function textBlock(text) { return { type: "text", text }; }
+function imageBlock(value, mimeType) {
+    const data = joinText(value)?.replace(/\s/g, "");
+    if (data === undefined)
+        return undefined;
+    if (!/^[A-Za-z0-9+/]*={0,2}$/.test(data) || data.length % 4 !== 0) {
+        throw new MediaError("INVALID_NOTEBOOK", `Notebook contains invalid ${mimeType} base64 data`);
+    }
+    let bytes;
+    try {
+        bytes = Buffer.from(data, "base64");
+    }
+    catch (error) {
+        throw new MediaError("INVALID_NOTEBOOK", `Notebook contains invalid ${mimeType} base64 data`, undefined, { cause: error });
+    }
+    if (bytes.length === 0 || bytes.toString("base64").replace(/=+$/, "") !== data.replace(/=+$/, "")) {
+        throw new MediaError("INVALID_NOTEBOOK", `Notebook contains invalid ${mimeType} base64 data`);
+    }
+    try {
+        return imageBytesToBlock(bytes, mimeType);
+    }
+    catch (error) {
+        throw new MediaError("INVALID_NOTEBOOK", `Notebook ${mimeType} data does not match its MIME type`, undefined, { cause: error });
+    }
+}
+function limitedOutput(text, cellId, limit) {
+    if (text.length <= limit)
+        return textBlock(text);
+    return textBlock(`Output omitted (${text.length} characters). Read ${cellId} directly to inspect this large output.`);
+}
+function mapOutput(output, cellId, limit) {
+    const blocks = [];
+    const directText = joinText(output.text);
+    if (directText !== undefined)
+        blocks.push(limitedOutput(directText, cellId, limit));
+    const plainText = joinText(output.data?.["text/plain"]);
+    if (plainText !== undefined)
+        blocks.push(limitedOutput(plainText, cellId, limit));
+    const png = imageBlock(output.data?.["image/png"], "image/png");
+    if (png !== undefined)
+        blocks.push(png);
+    const jpeg = imageBlock(output.data?.["image/jpeg"] ?? output.data?.["image/jpg"], "image/jpeg");
+    if (jpeg !== undefined)
+        blocks.push(jpeg);
+    if (output.output_type === "error") {
+        const errorText = output.traceback?.join("\n") ?? [output.ename, output.evalue].filter(Boolean).join(": ");
+        if (errorText.length > 0)
+            blocks.push(limitedOutput(errorText, cellId, limit));
+    }
+    return blocks;
+}
+function isNotebookCell(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const cell = value;
+    return (cell.cell_type === "code" || cell.cell_type === "markdown" || cell.cell_type === "raw")
+        && (typeof cell.source === "string" || (Array.isArray(cell.source) && cell.source.every((part) => typeof part === "string")));
+}
+export function parseNotebook(text) {
+    try {
+        const value = JSON.parse(text);
+        if (typeof value !== "object" || value === null || !Array.isArray(value.cells)
+            || !value.cells.every(isNotebookCell)) {
+            throw new Error("cells must be an array of valid notebook cells");
+        }
+        return value;
+    }
+    catch (error) {
+        throw new MediaError("INVALID_NOTEBOOK", "Unable to parse notebook JSON", undefined, { cause: error });
+    }
+}
+export function parseCellReference(reference) {
+    const match = /^cell-(0|[1-9]\d*)$/i.exec(reference.trim());
+    if (match?.[1] === undefined) {
+        throw new MediaError("INVALID_CELL_REFERENCE", "Cell references must use zero-based cell-N", { cell: reference });
+    }
+    return Number(match[1]);
+}
+export function mapNotebookCell(cell, index, outputLimit = 10_000) {
+    const id = `cell-${index}`;
+    const source = joinText(cell.source) ?? "";
+    const content = source.length === 0 ? [] : [textBlock(source)];
+    for (const output of cell.outputs ?? [])
+        content.push(...mapOutput(output, id, outputLimit));
+    return { id, cellType: cell.cell_type, content };
+}
+export function mapNotebook(notebook, options = {}) {
+    const outputLimit = options.outputLimit ?? 10_000;
+    if (!Number.isInteger(outputLimit) || outputLimit < 1) {
+        throw new MediaError("INVALID_NOTEBOOK", "outputLimit must be a positive integer", { outputLimit });
+    }
+    if (options.cell === undefined) {
+        return notebook.cells.map((cell, index) => mapNotebookCell(cell, index, outputLimit));
+    }
+    const index = parseCellReference(options.cell);
+    const cell = notebook.cells[index];
+    if (cell === undefined) {
+        throw new MediaError("CELL_NOT_FOUND", `Notebook does not contain ${options.cell}`, {
+            cell: options.cell, cellCount: notebook.cells.length,
+        });
+    }
+    const selectedCellLimit = options.outputLimit ?? Number.MAX_SAFE_INTEGER;
+    return [mapNotebookCell(cell, index, selectedCellLimit)];
+}
+export async function readNotebook(path, options, dependencies) {
+    const bytes = await dependencies.readFile(path);
+    return mapNotebook(parseNotebook(dependencies.decode(bytes)), options);
+}
+export function createNotebookReader(decode) {
+    return (path, options = {}) => readNotebook(path, options, { readFile, decode });
+}
+//# sourceMappingURL=notebook.js.map

package/dist/src/media/notebook.js.map

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

package/dist/src/media/pdf.d.ts

@@ -0,0 +1,25 @@
+import type { McpImageBlock } from "./types.js";
+export declare const MAX_PDF_PAGES = 20;
+export declare const MAX_WHOLE_PDF_BYTES: number;
+export declare const MAX_EXTRACT_PDF_BYTES: number;
+export interface CommandResult {
+    stdout: Uint8Array;
+    stderr: Uint8Array;
+}
+export interface PdfDependencies {
+    stat(path: string): Promise<{
+        size: number;
+    }>;
+    readFile(path: string): Promise<Uint8Array>;
+    makeTempDirectory(prefix: string): Promise<string>;
+    removeDirectory(path: string): Promise<void>;
+    runCommand(command: string, args: readonly string[]): Promise<CommandResult>;
+}
+export interface ReadPdfOptions {
+    pages?: string;
+    quality?: number;
+}
+export declare function parsePdfPageCount(output: Uint8Array | string): number;
+export declare function parsePdfPages(expression: string, pageCount: number, maximum?: number): number[];
+export declare function getPdfPageCount(path: string, dependencies?: PdfDependencies): Promise<number>;
+export declare function readPdf(path: string, options?: ReadPdfOptions, dependencies?: PdfDependencies): Promise<McpImageBlock[]>;

package/dist/src/media/pdf.js

@@ -0,0 +1,104 @@
+import { execFile } from "node:child_process";
+import { mkdtemp, readFile, rm, stat } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import { MediaError } from "./errors.js";
+import { imageBytesToBlock } from "./image.js";
+const execFileAsync = promisify(execFile);
+export const MAX_PDF_PAGES = 20;
+export const MAX_WHOLE_PDF_BYTES = 20 * 1024 * 1024;
+export const MAX_EXTRACT_PDF_BYTES = 100 * 1024 * 1024;
+const defaultDependencies = {
+    stat,
+    readFile,
+    makeTempDirectory: (prefix) => mkdtemp(join(tmpdir(), prefix)),
+    removeDirectory: (path) => rm(path, { recursive: true, force: true }),
+    async runCommand(command, args) {
+        const result = await execFileAsync(command, [...args], { encoding: "buffer", maxBuffer: 10 * 1024 * 1024 });
+        return { stdout: result.stdout, stderr: result.stderr };
+    },
+};
+function ascii(bytes) {
+    let result = "";
+    for (const byte of bytes)
+        result += byte <= 0x7f ? String.fromCharCode(byte) : "?";
+    return result;
+}
+export function parsePdfPageCount(output) {
+    const text = typeof output === "string" ? output : ascii(output);
+    const match = /^Pages:\s*(\d+)\s*$/im.exec(text);
+    const count = match?.[1] === undefined ? Number.NaN : Number(match[1]);
+    if (!Number.isSafeInteger(count) || count < 1) {
+        throw new MediaError("INVALID_PDF", "pdfinfo did not report a valid page count");
+    }
+    return count;
+}
+export function parsePdfPages(expression, pageCount, maximum = MAX_PDF_PAGES) {
+    const value = expression.trim();
+    const match = /^(\d+)(?:-(\d*))?$/.exec(value);
+    if (match?.[1] === undefined) {
+        throw new MediaError("INVALID_PAGES", "pages must use N, N-M, or N- syntax", { pages: expression });
+    }
+    const first = Number(match[1]);
+    const hasRange = value.includes("-");
+    const last = hasRange ? (match[2] === "" ? pageCount : Number(match[2])) : first;
+    if (!Number.isSafeInteger(first) || !Number.isSafeInteger(last) || first < 1 || last < first || last > pageCount) {
+        throw new MediaError("INVALID_PAGES", `pages must be within 1-${pageCount}`, { pages: expression, pageCount });
+    }
+    const count = last - first + 1;
+    if (count > maximum) {
+        throw new MediaError("INVALID_PAGES", `At most ${maximum} pages may be extracted`, { pages: expression, count, maximum });
+    }
+    return Array.from({ length: count }, (_, index) => first + index);
+}
+async function runPdfTool(dependencies, command, args) {
+    try {
+        return await dependencies.runCommand(command, args);
+    }
+    catch (error) {
+        throw new MediaError("PDF_TOOL_FAILED", `${command} failed`, { command, args: [...args] }, { cause: error });
+    }
+}
+export async function getPdfPageCount(path, dependencies = defaultDependencies) {
+    return parsePdfPageCount((await runPdfTool(dependencies, "pdfinfo", [path])).stdout);
+}
+export async function readPdf(path, options = {}, dependencies = defaultDependencies) {
+    const file = await dependencies.stat(path);
+    const limit = options.pages === undefined ? MAX_WHOLE_PDF_BYTES : MAX_EXTRACT_PDF_BYTES;
+    if (file.size > limit) {
+        throw new MediaError("FILE_TOO_LARGE", `PDF exceeds the ${limit / 1024 / 1024} MB limit`, {
+            size: file.size, limit, mode: options.pages === undefined ? "whole" : "extract",
+        });
+    }
+    const pageCount = await getPdfPageCount(path, dependencies);
+    if (options.pages === undefined && pageCount > 10) {
+        throw new MediaError("PDF_PAGES_REQUIRED", "PDFs over 10 pages require the pages option", { pageCount });
+    }
+    const pages = options.pages === undefined
+        ? Array.from({ length: pageCount }, (_, index) => index + 1)
+        : parsePdfPages(options.pages, pageCount);
+    const quality = options.quality ?? 85;
+    if (!Number.isInteger(quality) || quality < 1 || quality > 100) {
+        throw new MediaError("INVALID_PAGES", "quality must be an integer from 1 to 100", { quality });
+    }
+    let temporaryDirectory;
+    try {
+        temporaryDirectory = await dependencies.makeTempDirectory("mcp-pdf-");
+        const blocks = [];
+        for (const page of pages) {
+            const prefix = join(temporaryDirectory, `page-${String(page).padStart(5, "0")}`);
+            await runPdfTool(dependencies, "pdftoppm", [
+                "-f", String(page), "-l", String(page), "-singlefile", "-jpeg",
+                "-jpegopt", `quality=${quality}`, path, prefix,
+            ]);
+            blocks.push(imageBytesToBlock(await dependencies.readFile(`${prefix}.jpg`), "image/jpeg"));
+        }
+        return blocks;
+    }
+    finally {
+        if (temporaryDirectory !== undefined)
+            await dependencies.removeDirectory(temporaryDirectory);
+    }
+}
+//# sourceMappingURL=pdf.js.map

package/dist/src/media/pdf.js.map

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