@mcpmesh/sdk 0.9.12 → 1.0.0-beta.2

package/dist/media/media-store.js

@@ -0,0 +1,217 @@
+/**
+ * MediaStore abstraction for multimodal content storage.
+ *
+ * Provides pluggable storage backends (local filesystem, S3) for
+ * binary media referenced by resource_link content items.
+ */
+import { resolveMediaConfig } from "../config.js";
+/** Simple extension-to-MIME mapping for common types. */
+const MIME_MAP = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".svg": "image/svg+xml",
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    ".mp4": "video/mp4",
+    ".webm": "video/webm",
+    ".pdf": "application/pdf",
+    ".json": "application/json",
+    ".txt": "text/plain",
+    ".html": "text/html",
+    ".css": "text/css",
+    ".csv": "text/csv",
+    ".md": "text/markdown",
+};
+/** Guess MIME type from a filename extension. Falls back to application/octet-stream. */
+export function guessMimeType(filename) {
+    const ext = filename.slice(filename.lastIndexOf(".")).toLowerCase();
+    return MIME_MAP[ext] ?? "application/octet-stream";
+}
+/**
+ * Local filesystem media store.
+ *
+ * Stores files under a configurable base path and returns `file://` URIs.
+ */
+export class LocalMediaStore {
+    basePath;
+    prefix;
+    constructor(basePath, prefix) {
+        const cfg = resolveMediaConfig();
+        this.basePath = basePath ?? cfg.storagePath;
+        this.prefix = prefix ?? cfg.storagePrefix;
+    }
+    async validatePath(filePath) {
+        const { resolve } = await import("node:path");
+        const resolved = resolve(filePath);
+        if (!resolved.startsWith(resolve(this.basePath))) {
+            throw new Error(`Invalid filename (path traversal): ${filePath}`);
+        }
+    }
+    async upload(data, filename, _mimeType) {
+        const { mkdir, writeFile } = await import("node:fs/promises");
+        const { join } = await import("node:path");
+        const dir = join(this.basePath, this.prefix);
+        await mkdir(dir, { recursive: true });
+        const filePath = join(dir, filename);
+        await this.validatePath(filePath);
+        await writeFile(filePath, data);
+        return `file://${filePath}`;
+    }
+    async fetch(uri) {
+        const { readFile } = await import("node:fs/promises");
+        const filePath = uri.startsWith("file://") ? uri.slice(7) : uri;
+        await this.validatePath(filePath);
+        const data = await readFile(filePath);
+        const mimeType = guessMimeType(filePath);
+        return { data: Buffer.from(data), mimeType };
+    }
+    async exists(uri) {
+        const { access } = await import("node:fs/promises");
+        const filePath = uri.startsWith("file://") ? uri.slice(7) : uri;
+        try {
+            await this.validatePath(filePath);
+            await access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * S3-compatible media store.
+ *
+ * Uses lazy imports for @aws-sdk/client-s3 so it is only required
+ * when storage is configured as "s3".
+ */
+export class S3MediaStore {
+    bucket;
+    endpoint;
+    prefix;
+    // Lazily initialised S3 client
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _client = null;
+    constructor(bucket, endpoint, prefix) {
+        const cfg = resolveMediaConfig();
+        this.bucket = bucket ?? cfg.storageBucket ?? "mcp-mesh-media";
+        this.endpoint = endpoint ?? cfg.storageEndpoint;
+        this.prefix = prefix ?? cfg.storagePrefix;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async getClient() {
+        if (this._client)
+            return this._client;
+        // Lazy import - @aws-sdk/client-s3 is NOT a required dependency.
+        // Uses variable to prevent TypeScript from resolving the module at compile time.
+        const s3ModuleName = "@aws-sdk/client-s3";
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const s3Module = await import(/* webpackIgnore: true */ s3ModuleName);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const opts = {};
+        if (this.endpoint) {
+            opts.endpoint = this.endpoint;
+            opts.forcePathStyle = true;
+        }
+        this._client = new s3Module.S3Client(opts);
+        return this._client;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async loadS3Module() {
+        const name = "@aws-sdk/client-s3";
+        return import(/* webpackIgnore: true */ name);
+    }
+    async upload(data, filename, mimeType) {
+        const s3Module = await this.loadS3Module();
+        const client = await this.getClient();
+        const key = `${this.prefix}${filename}`;
+        await client.send(new s3Module.PutObjectCommand({
+            Bucket: this.bucket,
+            Key: key,
+            Body: data,
+            ContentType: mimeType,
+        }));
+        return `s3://${this.bucket}/${key}`;
+    }
+    async fetch(uri) {
+        const s3Module = await this.loadS3Module();
+        const client = await this.getClient();
+        const { bucket, key } = this.parseUri(uri);
+        const response = await client.send(new s3Module.GetObjectCommand({ Bucket: bucket, Key: key }));
+        const body = await response.Body?.transformToByteArray();
+        if (!body)
+            throw new Error(`Empty body for ${uri}`);
+        return {
+            data: Buffer.from(body),
+            mimeType: response.ContentType ?? guessMimeType(key),
+        };
+    }
+    async exists(uri) {
+        const s3Module = await this.loadS3Module();
+        const client = await this.getClient();
+        const { bucket, key } = this.parseUri(uri);
+        try {
+            await client.send(new s3Module.HeadObjectCommand({ Bucket: bucket, Key: key }));
+            return true;
+        }
+        catch (err) {
+            // Only treat "not found" as false; re-throw real errors
+            if (err instanceof Error &&
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                (err.name === "NotFound" || err.$metadata?.httpStatusCode === 404)) {
+                return false;
+            }
+            throw err;
+        }
+    }
+    parseUri(uri) {
+        if (uri.startsWith("s3://")) {
+            const withoutScheme = uri.slice(5);
+            const slashIdx = withoutScheme.indexOf("/");
+            if (slashIdx === -1) {
+                return { bucket: withoutScheme, key: "" };
+            }
+            return {
+                bucket: withoutScheme.slice(0, slashIdx),
+                key: withoutScheme.slice(slashIdx + 1),
+            };
+        }
+        // Assume key-only, use configured bucket
+        return { bucket: this.bucket, key: uri };
+    }
+}
+// ---------------------------------------------------------------------------
+// Singleton factory
+// ---------------------------------------------------------------------------
+let _instance = null;
+/**
+ * Get (or create) the singleton MediaStore based on configuration.
+ *
+ * Reads `media_storage` config key (env: `MCP_MESH_MEDIA_STORAGE`).
+ * - `"local"` (default) -> LocalMediaStore
+ * - `"s3"` -> S3MediaStore
+ */
+export function getMediaStore() {
+    if (_instance)
+        return _instance;
+    const cfg = resolveMediaConfig();
+    switch (cfg.storage) {
+        case "s3":
+            _instance = new S3MediaStore();
+            break;
+        default:
+            _instance = new LocalMediaStore();
+            break;
+    }
+    return _instance;
+}
+/**
+ * Reset the singleton (mainly for testing).
+ * @internal
+ */
+export function _resetMediaStore() {
+    _instance = null;
+}
+//# sourceMappingURL=media-store.js.map

package/dist/media/media-store.js.map

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

package/dist/media/resolver.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Resolve resource_link URIs to provider-native multimodal content.
+ *
+ * When an LLM provider calls a tool that returns a resource_link (e.g., an image URI),
+ * the LLM currently sees just a JSON string. This module resolves the URI to base64
+ * media in provider-native format so the LLM can actually "see" the image.
+ *
+ * Based on Python's resolver:
+ * src/runtime/python/_mcp_mesh/media/resolver.py
+ */
+export interface ResolvedContent {
+    type: string;
+    [key: string]: unknown;
+}
+export declare function formatForOpenai(b64: string, mimeType: string): ResolvedContent;
+/**
+ * Scan tool result for resource_link items and resolve to provider-native format.
+ *
+ * Returns a list of content parts for the LLM message.
+ * - For image resource_links: fetches bytes, base64 encodes, formats per vendor
+ * - For non-image or non-resource_link: wraps in text content
+ *
+ * @param toolResult - The raw tool result (could be object, string, etc.)
+ * @param vendor - One of "anthropic", "openai", "gemini", "google"
+ * @returns List of content dicts suitable for provider-specific message content arrays
+ */
+export declare function resolveResourceLinks(toolResult: unknown, vendor: string): Promise<ResolvedContent[]>;
+/** Vendors that do NOT support images in tool/function result messages. */
+export declare const TOOL_IMAGE_UNSUPPORTED_VENDORS: Set<string>;
+/**
+ * Resolve resource_links for inclusion in a tool result message.
+ *
+ * For vendors that support images in tool messages (Anthropic/Claude),
+ * returns the full multimodal content (text + image parts).
+ *
+ * For vendors that do NOT support images in tool messages (OpenAI, Gemini),
+ * returns text-only content with descriptive placeholders. The actual image
+ * should be injected via a separate user message using
+ * `resolveMediaAsUserMessage()`.
+ *
+ * @param toolResult - Raw tool result
+ * @param vendor - e.g. "anthropic", "openai", "gemini"
+ * @returns Content parts suitable for a tool result message
+ */
+export declare function resolveResourceLinksForToolMessage(toolResult: unknown, vendor: string): Promise<ResolvedContent[]>;
+/**
+ * Return a user message containing resolved images from a tool result.
+ *
+ * For vendors that do NOT support images in tool messages (OpenAI, Gemini),
+ * resolves resource_link items and packages the image parts into a
+ * `role: "user"` message that can be appended after the tool result message.
+ *
+ * For vendors that support images in tool messages (Anthropic), returns null.
+ *
+ * @param toolResult - Raw tool result
+ * @param vendor - e.g. "anthropic", "openai", "gemini"
+ * @returns A user message object with image content, or null
+ */
+export declare function resolveMediaAsUserMessage(toolResult: unknown, vendor: string): Promise<Record<string, unknown> | null>;
+/**
+ * Quick check whether a tool result contains any resource_link items.
+ *
+ * This is a lightweight synchronous check used to decide whether the
+ * more expensive async resolution is needed.
+ */
+export declare function hasResourceLink(toolResult: unknown): boolean;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/media/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/media/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsBH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAaD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAQ9E;AAwID;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,EAAE,CAAC,CA+D5B;AAED,2EAA2E;AAC3E,eAAO,MAAM,8BAA8B,aAA0C,CAAC;AAEtF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kCAAkC,CACtD,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,EAAE,CAAC,CAY5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAoBzC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAoB5D"}

package/dist/media/resolver.js

@@ -0,0 +1,311 @@
+/**
+ * Resolve resource_link URIs to provider-native multimodal content.
+ *
+ * When an LLM provider calls a tool that returns a resource_link (e.g., an image URI),
+ * the LLM currently sees just a JSON string. This module resolves the URI to base64
+ * media in provider-native format so the LLM can actually "see" the image.
+ *
+ * Based on Python's resolver:
+ * src/runtime/python/_mcp_mesh/media/resolver.py
+ */
+import { createDebug } from "../debug.js";
+import { getMediaStore } from "./media-store.js";
+const debug = createDebug("media-resolver");
+const IMAGE_MIME_TYPES = new Set(["image/png", "image/jpeg", "image/gif", "image/webp"]);
+const PDF_MIME_TYPES = new Set(["application/pdf"]);
+const TEXT_MIME_TYPES = new Set([
+    "text/plain",
+    "text/csv",
+    "text/markdown",
+    "text/html",
+    "text/xml",
+    "application/json",
+    "application/xml",
+    "application/csv",
+]);
+function formatForClaude(b64, mimeType) {
+    return {
+        type: "image",
+        source: {
+            type: "base64",
+            media_type: mimeType,
+            data: b64,
+        },
+    };
+}
+export function formatForOpenai(b64, mimeType) {
+    return {
+        type: "image_url",
+        image_url: {
+            url: `data:${mimeType};base64,${b64}`,
+            detail: "high",
+        },
+    };
+}
+function formatForGemini(b64, mimeType) {
+    // Vercel AI SDK handles Gemini images via OpenAI-compatible format
+    return formatForOpenai(b64, mimeType);
+}
+const VENDOR_FORMATTERS = {
+    anthropic: formatForClaude,
+    openai: formatForOpenai,
+    gemini: formatForGemini,
+    google: formatForGemini,
+};
+function formatPdfForClaude(b64) {
+    return {
+        type: "document",
+        source: {
+            type: "base64",
+            media_type: "application/pdf",
+            data: b64,
+        },
+    };
+}
+function formatPdfForOpenai(_b64, filename) {
+    return {
+        type: "text",
+        text: `[Attached PDF document: ${filename}. OpenAI does not support PDF analysis. Please use Claude for PDF processing.]`,
+    };
+}
+function formatPdfForGemini(_b64, filename) {
+    return {
+        type: "text",
+        text: `[Attached PDF document: ${filename}. Gemini PDF support via LiteLLM may vary.]`,
+    };
+}
+function formatTextContent(data, mimeType, filename) {
+    let text;
+    try {
+        text = data.toString("utf-8");
+    }
+    catch {
+        text = data.toString("latin1");
+    }
+    const maxChars = 50_000;
+    if (text.length > maxChars) {
+        text = text.slice(0, maxChars) + `\n\n[... truncated, ${text.length} total characters]`;
+    }
+    return {
+        type: "text",
+        text: `--- Content of ${filename} (${mimeType}) ---\n${text}\n--- End of ${filename} ---`,
+    };
+}
+/**
+ * Resolve a single resource_link dict to a provider-native content part.
+ *
+ * @param resourceLink - Dict with type "resource_link" and either flat or nested resource fields
+ * @param vendor - One of "anthropic", "openai", "gemini", "google"
+ * @returns Provider-native content dict (image block or text fallback)
+ */
+async function resolveSingleResourceLink(resourceLink, vendor) {
+    // Support both flat format and nested resource sub-object
+    const resource = (resourceLink.resource ?? {});
+    const uri = (resource.uri ?? resourceLink.uri ?? "");
+    const mimeType = (resource.mimeType ?? resourceLink.mimeType ?? "");
+    const name = (resource.name ?? resourceLink.name ?? uri);
+    // --- Images: existing behaviour ---
+    if (IMAGE_MIME_TYPES.has(mimeType)) {
+        try {
+            const store = getMediaStore();
+            const { data, mimeType: fetchedMime } = await store.fetch(uri);
+            const b64 = data.toString("base64");
+            const formatter = VENDOR_FORMATTERS[vendor] ?? formatForOpenai;
+            const result = formatter(b64, mimeType || fetchedMime);
+            debug(`Resolved resource_link ${name} to ${vendor} image block (${data.length} bytes)`);
+            return result;
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            debug(`Failed to fetch resource_link ${uri}: ${errMsg}`);
+            return {
+                type: "text",
+                text: `[resource_link: ${name} (${mimeType || "unknown"}) at ${uri} (fetch failed)]`,
+            };
+        }
+    }
+    // --- PDFs: provider-specific ---
+    if (PDF_MIME_TYPES.has(mimeType)) {
+        try {
+            const store = getMediaStore();
+            const { data } = await store.fetch(uri);
+            const b64 = data.toString("base64");
+            if (vendor === "anthropic" || vendor === "claude") {
+                return formatPdfForClaude(b64);
+            }
+            else if (vendor === "gemini" || vendor === "google") {
+                return formatPdfForGemini(b64, name);
+            }
+            else {
+                return formatPdfForOpenai(b64, name);
+            }
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            debug(`Failed to fetch PDF ${uri}: ${errMsg}`);
+            return { type: "text", text: `[PDF document: ${name} at ${uri}]` };
+        }
+    }
+    // --- Text files: read content and include as text (all providers) ---
+    if (TEXT_MIME_TYPES.has(mimeType) || mimeType.startsWith("text/")) {
+        try {
+            const store = getMediaStore();
+            const { data } = await store.fetch(uri);
+            return formatTextContent(data, mimeType, name);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            debug(`Failed to fetch text file ${uri}: ${errMsg}`);
+            return { type: "text", text: `[Text document: ${name} at ${uri}]` };
+        }
+    }
+    // --- Unknown / unsupported MIME type ---
+    return {
+        type: "text",
+        text: `[resource_link: ${name} (${mimeType || "unknown"}) at ${uri}]`,
+    };
+}
+/**
+ * Scan tool result for resource_link items and resolve to provider-native format.
+ *
+ * Returns a list of content parts for the LLM message.
+ * - For image resource_links: fetches bytes, base64 encodes, formats per vendor
+ * - For non-image or non-resource_link: wraps in text content
+ *
+ * @param toolResult - The raw tool result (could be object, string, etc.)
+ * @param vendor - One of "anthropic", "openai", "gemini", "google"
+ * @returns List of content dicts suitable for provider-specific message content arrays
+ */
+export async function resolveResourceLinks(toolResult, vendor) {
+    // resource_link dict
+    if (toolResult &&
+        typeof toolResult === "object" &&
+        toolResult.type === "resource_link") {
+        const part = await resolveSingleResourceLink(toolResult, vendor);
+        return [part];
+    }
+    // multi_content dict (from extractContent in proxy.ts)
+    if (toolResult &&
+        typeof toolResult === "object" &&
+        toolResult.type === "multi_content") {
+        const obj = toolResult;
+        const items = (obj.items ?? obj.content ?? []);
+        const parts = [];
+        for (const item of items) {
+            if (item &&
+                typeof item === "object" &&
+                item.type === "resource_link") {
+                parts.push(await resolveSingleResourceLink(item, vendor));
+            }
+            else if (typeof item === "string") {
+                parts.push({ type: "text", text: item });
+            }
+            else if (item && typeof item === "object") {
+                // Non-resource_link objects (e.g., text items) — preserve or serialize
+                const itemObj = item;
+                if (itemObj.type === "text" && typeof itemObj.text === "string") {
+                    parts.push({ type: "text", text: itemObj.text });
+                }
+                else {
+                    parts.push({ type: "text", text: JSON.stringify(item) });
+                }
+            }
+            else {
+                parts.push({ type: "text", text: String(item) });
+            }
+        }
+        return parts;
+    }
+    // Plain string
+    if (typeof toolResult === "string") {
+        return [{ type: "text", text: toolResult }];
+    }
+    // Anything else (dict without resource_link type, number, etc.)
+    try {
+        const text = JSON.stringify(toolResult);
+        return [{ type: "text", text }];
+    }
+    catch {
+        return [{ type: "text", text: String(toolResult) }];
+    }
+}
+/** Vendors that do NOT support images in tool/function result messages. */
+export const TOOL_IMAGE_UNSUPPORTED_VENDORS = new Set(["openai", "gemini", "google"]);
+/**
+ * Resolve resource_links for inclusion in a tool result message.
+ *
+ * For vendors that support images in tool messages (Anthropic/Claude),
+ * returns the full multimodal content (text + image parts).
+ *
+ * For vendors that do NOT support images in tool messages (OpenAI, Gemini),
+ * returns text-only content with descriptive placeholders. The actual image
+ * should be injected via a separate user message using
+ * `resolveMediaAsUserMessage()`.
+ *
+ * @param toolResult - Raw tool result
+ * @param vendor - e.g. "anthropic", "openai", "gemini"
+ * @returns Content parts suitable for a tool result message
+ */
+export async function resolveResourceLinksForToolMessage(toolResult, vendor) {
+    if (!TOOL_IMAGE_UNSUPPORTED_VENDORS.has(vendor)) {
+        return resolveResourceLinks(toolResult, vendor);
+    }
+    const parts = await resolveResourceLinks(toolResult, vendor);
+    return parts.map((part) => {
+        if (part.type === "image" || part.type === "image_url") {
+            return { type: "text", text: "[Image content — see next message]" };
+        }
+        return part;
+    });
+}
+/**
+ * Return a user message containing resolved images from a tool result.
+ *
+ * For vendors that do NOT support images in tool messages (OpenAI, Gemini),
+ * resolves resource_link items and packages the image parts into a
+ * `role: "user"` message that can be appended after the tool result message.
+ *
+ * For vendors that support images in tool messages (Anthropic), returns null.
+ *
+ * @param toolResult - Raw tool result
+ * @param vendor - e.g. "anthropic", "openai", "gemini"
+ * @returns A user message object with image content, or null
+ */
+export async function resolveMediaAsUserMessage(toolResult, vendor) {
+    if (!TOOL_IMAGE_UNSUPPORTED_VENDORS.has(vendor)) {
+        return null;
+    }
+    const parts = await resolveResourceLinks(toolResult, vendor);
+    const imageParts = parts.filter((p) => p.type === "image" || p.type === "image_url");
+    if (imageParts.length === 0) {
+        return null;
+    }
+    return {
+        role: "user",
+        content: [
+            { type: "text", text: "The tool returned this image:" },
+            ...imageParts,
+        ],
+    };
+}
+/**
+ * Quick check whether a tool result contains any resource_link items.
+ *
+ * This is a lightweight synchronous check used to decide whether the
+ * more expensive async resolution is needed.
+ */
+export function hasResourceLink(toolResult) {
+    if (!toolResult || typeof toolResult !== "object") {
+        return false;
+    }
+    const obj = toolResult;
+    if (obj.type === "resource_link") {
+        return true;
+    }
+    if (obj.type === "multi_content") {
+        const items = (obj.items ?? obj.content ?? []);
+        return items.some((i) => i && typeof i === "object" && i.type === "resource_link");
+    }
+    return false;
+}
+//# sourceMappingURL=resolver.js.map

package/dist/media/resolver.js.map

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

package/dist/media-param.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Schema post-processing for media-typed tool parameters.
+ *
+ * Detects the "[media:TYPE]" convention in property descriptions
+ * (set by mediaParam() in types.ts) and enriches the JSON Schema
+ * with x-media-type annotations for LLM tool discovery.
+ */
+/**
+ * Post-process a JSON Schema to enrich properties that use the
+ * [media:TYPE] description convention with x-media-type annotations.
+ *
+ * Modifies the schema in place.
+ *
+ * @param schema - JSON Schema object (from zodToJsonSchema)
+ */
+export declare function enrichSchemaWithMediaTypes(schema: Record<string, unknown>): void;
+//# sourceMappingURL=media-param.d.ts.map

package/dist/media-param.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-param.d.ts","sourceRoot":"","sources":["../src/media-param.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAgBhF"}