@mcpmesh/sdk 0.9.11 → 1.0.0-beta.1

package/dist/media/index.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Media module — public API for multimodal content storage and helpers.
+ */
+export { type MediaStore, LocalMediaStore, S3MediaStore, getMediaStore, guessMimeType, _resetMediaStore, } from "./media-store.js";
+export { formatForOpenai, resolveResourceLinks, resolveResourceLinksForToolMessage, resolveMediaAsUserMessage, hasResourceLink, TOOL_IMAGE_UNSUPPORTED_VENDORS, type ResolvedContent, } from "./resolver.js";
+import { type ResolvedContent } from "./resolver.js";
+import type { ResourceLink } from "fastmcp";
+/**
+ * Upload binary data to the configured media store.
+ *
+ * @returns URI pointing to the stored blob (e.g. `file://...` or `s3://...`).
+ */
+export declare function uploadMedia(data: Buffer, filename: string, mimeType: string): Promise<string>;
+/**
+ * Build an MCP `resource_link` content item.
+ *
+ * This is the standard way for tools to return references to binary media
+ * (images, audio, PDFs, etc.) rather than embedding them inline.
+ *
+ * Returns a proper MCP ResourceLink that FastMCP sends as a `resource_link`
+ * content type in the MCP protocol response (not serialized as JSON text).
+ */
+export declare function mediaResult(uri: string, name: string, mimeType: string, description?: string, size?: number): ResourceLink;
+/**
+ * Convenience class: upload bytes and return a ResourceLink in one step.
+ *
+ * Usage:
+ *   const link = await new MediaResult(pngBytes, "chart.png", "image/png").toResourceLink();
+ *   // or use the standalone function:
+ *   const link = await createMediaResult(pngBytes, "chart.png", "image/png");
+ */
+export declare class MediaResult {
+    readonly data: Buffer;
+    readonly filename: string;
+    readonly mimeType: string;
+    readonly name?: string | undefined;
+    readonly description?: string | undefined;
+    constructor(data: Buffer, filename: string, mimeType: string, name?: string | undefined, description?: string | undefined);
+    toResourceLink(): Promise<ResourceLink>;
+}
+/**
+ * Upload bytes and return a ResourceLink in one step.
+ */
+export declare function createMediaResult(data: Buffer, filename: string, mimeType: string, name?: string, description?: string): Promise<ResourceLink>;
+/**
+ * Result of saving an upload to MediaStore.
+ */
+export interface MediaUploadResult {
+    uri: string;
+    name: string;
+    mimeType: string;
+    size: number;
+}
+/**
+ * Save a file upload (e.g., from multer) to MediaStore and return the URI.
+ *
+ * Accepts objects with buffer/originalname/mimetype properties (multer format)
+ * or any object with data/name/mimeType properties.
+ */
+export declare function saveUpload(file: {
+    buffer: Buffer;
+    originalname: string;
+    mimetype: string;
+} | {
+    data: Buffer;
+    name: string;
+    mimeType: string;
+}, options?: {
+    filename?: string;
+    mimeType?: string;
+}): Promise<string>;
+/**
+ * Save a file upload and return full metadata.
+ */
+export declare function saveUploadResult(file: {
+    buffer: Buffer;
+    originalname: string;
+    mimetype: string;
+} | {
+    data: Buffer;
+    name: string;
+    mimeType: string;
+}, options?: {
+    filename?: string;
+    mimeType?: string;
+}): Promise<MediaUploadResult>;
+/**
+ * Resolve an array of media inputs to OpenAI-compatible image_url content parts.
+ *
+ * Each item is either:
+ * - A URI string (resolved via MediaStore.fetch())
+ * - An inline `{ data: Buffer; mimeType: string }` object
+ *
+ * Returns an array of ResolvedContent parts in OpenAI image_url format,
+ * which Vercel AI SDK converts to each vendor's native format.
+ *
+ * @param media - Array of URI strings or inline media objects
+ * @returns Array of OpenAI-compatible image_url content parts
+ */
+export declare function resolveMediaInputs(media: Array<string | {
+    data: Buffer;
+    mimeType: string;
+}>): Promise<ResolvedContent[]>;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/media/index.js

@@ -0,0 +1,135 @@
+/**
+ * Media module — public API for multimodal content storage and helpers.
+ */
+export { LocalMediaStore, S3MediaStore, getMediaStore, guessMimeType, _resetMediaStore, } from "./media-store.js";
+export { formatForOpenai, resolveResourceLinks, resolveResourceLinksForToolMessage, resolveMediaAsUserMessage, hasResourceLink, TOOL_IMAGE_UNSUPPORTED_VENDORS, } from "./resolver.js";
+import { getMediaStore } from "./media-store.js";
+import { formatForOpenai } from "./resolver.js";
+/**
+ * Upload binary data to the configured media store.
+ *
+ * @returns URI pointing to the stored blob (e.g. `file://...` or `s3://...`).
+ */
+export async function uploadMedia(data, filename, mimeType) {
+    const store = getMediaStore();
+    return store.upload(data, filename, mimeType);
+}
+/**
+ * Build an MCP `resource_link` content item.
+ *
+ * This is the standard way for tools to return references to binary media
+ * (images, audio, PDFs, etc.) rather than embedding them inline.
+ *
+ * Returns a proper MCP ResourceLink that FastMCP sends as a `resource_link`
+ * content type in the MCP protocol response (not serialized as JSON text).
+ */
+export function mediaResult(uri, name, mimeType, description, size) {
+    const result = { type: "resource_link", uri, name, mimeType };
+    if (description !== undefined)
+        result.description = description;
+    if (size !== undefined)
+        result._meta = { size };
+    return result;
+}
+// ---------------------------------------------------------------------------
+// MediaResult class — upload + ResourceLink in one step
+// ---------------------------------------------------------------------------
+/**
+ * Convenience class: upload bytes and return a ResourceLink in one step.
+ *
+ * Usage:
+ *   const link = await new MediaResult(pngBytes, "chart.png", "image/png").toResourceLink();
+ *   // or use the standalone function:
+ *   const link = await createMediaResult(pngBytes, "chart.png", "image/png");
+ */
+export class MediaResult {
+    data;
+    filename;
+    mimeType;
+    name;
+    description;
+    constructor(data, filename, mimeType, name, description) {
+        this.data = data;
+        this.filename = filename;
+        this.mimeType = mimeType;
+        this.name = name;
+        this.description = description;
+    }
+    async toResourceLink() {
+        const uri = await uploadMedia(this.data, this.filename, this.mimeType);
+        return mediaResult(uri, this.name ?? this.filename, this.mimeType, this.description, this.data.length);
+    }
+}
+/**
+ * Upload bytes and return a ResourceLink in one step.
+ */
+export async function createMediaResult(data, filename, mimeType, name, description) {
+    return new MediaResult(data, filename, mimeType, name, description).toResourceLink();
+}
+/**
+ * Save a file upload (e.g., from multer) to MediaStore and return the URI.
+ *
+ * Accepts objects with buffer/originalname/mimetype properties (multer format)
+ * or any object with data/name/mimeType properties.
+ */
+export async function saveUpload(file, options) {
+    const data = 'buffer' in file ? file.buffer : file.data;
+    const filename = options?.filename ?? ('originalname' in file ? file.originalname : file.name);
+    const mime = options?.mimeType ?? ('mimetype' in file ? file.mimetype : file.mimeType);
+    const store = getMediaStore();
+    return store.upload(data, filename, mime);
+}
+/**
+ * Save a file upload and return full metadata.
+ */
+export async function saveUploadResult(file, options) {
+    const data = 'buffer' in file ? file.buffer : file.data;
+    const filename = options?.filename ?? ('originalname' in file ? file.originalname : file.name);
+    const mime = options?.mimeType ?? ('mimetype' in file ? file.mimetype : file.mimeType);
+    const store = getMediaStore();
+    const uri = await store.upload(data, filename, mime);
+    return { uri, name: filename, mimeType: mime, size: data.length };
+}
+// ---------------------------------------------------------------------------
+// resolveMediaInputs — resolve media URIs/buffers to OpenAI-compatible parts
+// ---------------------------------------------------------------------------
+/**
+ * Resolve an array of media inputs to OpenAI-compatible image_url content parts.
+ *
+ * Each item is either:
+ * - A URI string (resolved via MediaStore.fetch())
+ * - An inline `{ data: Buffer; mimeType: string }` object
+ *
+ * Returns an array of ResolvedContent parts in OpenAI image_url format,
+ * which Vercel AI SDK converts to each vendor's native format.
+ *
+ * @param media - Array of URI strings or inline media objects
+ * @returns Array of OpenAI-compatible image_url content parts
+ */
+export async function resolveMediaInputs(media) {
+    const store = getMediaStore();
+    const parts = [];
+    for (const item of media) {
+        try {
+            let data;
+            let mimeType;
+            if (typeof item === "string") {
+                const result = await store.fetch(item);
+                data = result.data;
+                mimeType = result.mimeType;
+            }
+            else {
+                data = item.data;
+                mimeType = item.mimeType;
+            }
+            const b64 = data.toString("base64");
+            parts.push(formatForOpenai(b64, mimeType));
+        }
+        catch (err) {
+            const label = typeof item === "string" ? item : "(inline media)";
+            console.error(`[media] Failed to resolve ${label}, skipping:`, err);
+        }
+    }
+    return parts;
+}
+//# sourceMappingURL=index.js.map

package/dist/media/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,kCAAkC,EAClC,yBAAyB,EACzB,eAAe,EACf,8BAA8B,GAE/B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAwB,MAAM,eAAe,CAAC;AAGtE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,QAAgB,EAChB,QAAgB;IAEhB,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,IAAY,EACZ,QAAgB,EAChB,WAAoB,EACpB,IAAa;IAEb,MAAM,MAAM,GAAiB,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5E,IAAI,WAAW,KAAK,SAAS;QAAE,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC;IAChE,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC;IAEhD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,wDAAwD;AACxD,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,OAAO,WAAW;IAEJ;IACA;IACA;IACA;IACA;IALlB,YACkB,IAAY,EACZ,QAAgB,EAChB,QAAgB,EAChB,IAAa,EACb,WAAoB;QAJpB,SAAI,GAAJ,IAAI,CAAQ;QACZ,aAAQ,GAAR,QAAQ,CAAQ;QAChB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,SAAI,GAAJ,IAAI,CAAS;QACb,gBAAW,GAAX,WAAW,CAAS;IACnC,CAAC;IAEJ,KAAK,CAAC,cAAc;QAClB,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvE,OAAO,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzG,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,QAAgB,EAChB,QAAgB,EAChB,IAAa,EACb,WAAoB;IAEpB,OAAO,IAAI,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,cAAc,EAAE,CAAC;AACvF,CAAC;AAgBD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IACsD,EACtD,OAAkD;IAElD,MAAM,IAAI,GAAG,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IACxD,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/F,MAAM,IAAI,GAAG,OAAO,EAAE,QAAQ,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEvF,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IACsD,EACtD,OAAkD;IAElD,MAAM,IAAI,GAAG,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IACxD,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/F,MAAM,IAAI,GAAG,OAAO,EAAE,QAAQ,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEvF,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACrD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AACpE,CAAC;AAED,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAyD;IAEzD,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAsB,EAAE,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,IAAI,IAAY,CAAC;YACjB,IAAI,QAAgB,CAAC;YAErB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACvC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;gBACnB,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;gBACjB,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC3B,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC;YACjE,OAAO,CAAC,KAAK,CAAC,6BAA6B,KAAK,aAAa,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/media/media-store.d.ts

@@ -0,0 +1,75 @@
+/**
+ * MediaStore abstraction for multimodal content storage.
+ *
+ * Provides pluggable storage backends (local filesystem, S3) for
+ * binary media referenced by resource_link content items.
+ */
+/**
+ * Storage backend for media blobs.
+ */
+export interface MediaStore {
+    /** Upload data and return a URI for later retrieval. */
+    upload(data: Buffer, filename: string, mimeType: string): Promise<string>;
+    /** Fetch previously stored data by URI. */
+    fetch(uri: string): Promise<{
+        data: Buffer;
+        mimeType: string;
+    }>;
+    /** Check whether a URI exists in the store. */
+    exists(uri: string): Promise<boolean>;
+}
+/** Guess MIME type from a filename extension. Falls back to application/octet-stream. */
+export declare function guessMimeType(filename: string): string;
+/**
+ * Local filesystem media store.
+ *
+ * Stores files under a configurable base path and returns `file://` URIs.
+ */
+export declare class LocalMediaStore implements MediaStore {
+    private readonly basePath;
+    private readonly prefix;
+    constructor(basePath?: string, prefix?: string);
+    private validatePath;
+    upload(data: Buffer, filename: string, _mimeType: string): Promise<string>;
+    fetch(uri: string): Promise<{
+        data: Buffer;
+        mimeType: string;
+    }>;
+    exists(uri: string): Promise<boolean>;
+}
+/**
+ * S3-compatible media store.
+ *
+ * Uses lazy imports for @aws-sdk/client-s3 so it is only required
+ * when storage is configured as "s3".
+ */
+export declare class S3MediaStore implements MediaStore {
+    private readonly bucket;
+    private readonly endpoint;
+    private readonly prefix;
+    private _client;
+    constructor(bucket?: string, endpoint?: string, prefix?: string);
+    private getClient;
+    private loadS3Module;
+    upload(data: Buffer, filename: string, mimeType: string): Promise<string>;
+    fetch(uri: string): Promise<{
+        data: Buffer;
+        mimeType: string;
+    }>;
+    exists(uri: string): Promise<boolean>;
+    private parseUri;
+}
+/**
+ * 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 declare function getMediaStore(): MediaStore;
+/**
+ * Reset the singleton (mainly for testing).
+ * @internal
+ */
+export declare function _resetMediaStore(): void;
+//# sourceMappingURL=media-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media-store.d.ts","sourceRoot":"","sources":["../../src/media/media-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1E,2CAA2C;IAC3C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEhE,+CAA+C;IAC/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvC;AAuBD,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,UAAU;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;YAMhC,YAAY;IAQpB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc1E,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAW/D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAY5C;AAED;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,UAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAIhC,OAAO,CAAC,OAAO,CAAa;gBAEhB,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;YAQjD,SAAS;YAmBT,YAAY;IAKpB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBzE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAkB/D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqB3C,OAAO,CAAC,QAAQ;CAejB;AAQD;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAe1C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

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"}