@mcpmesh/sdk 0.9.12 → 1.0.0-beta.1

package/dist/__tests__/llm-agent-media.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Unit tests for media option in LLM agent calls.
+ *
+ * Tests resolveMediaInputs() and the integration of media items
+ * into multipart user messages for LLM completions.
+ */
+export {};
+//# sourceMappingURL=llm-agent-media.test.d.ts.map

package/dist/__tests__/llm-agent-media.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-agent-media.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/llm-agent-media.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/llm-agent-media.test.js

@@ -0,0 +1,167 @@
+/**
+ * Unit tests for media option in LLM agent calls.
+ *
+ * Tests resolveMediaInputs() and the integration of media items
+ * into multipart user messages for LLM completions.
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+// Mock @mcpmesh/core before importing
+vi.mock("@mcpmesh/core", () => ({
+    resolveConfig: vi.fn((_key, _value) => ""),
+    resolveConfigInt: vi.fn((_key, _value) => null),
+    getDefault: vi.fn((_key) => null),
+}));
+// Mock the media store
+const mockFetch = vi.fn();
+vi.mock("../media/media-store.js", () => ({
+    getMediaStore: vi.fn(() => ({
+        fetch: mockFetch,
+        upload: vi.fn(),
+        exists: vi.fn(),
+    })),
+    resolveMediaConfig: vi.fn(() => ({
+        storage: "local",
+        storagePath: "/tmp/media",
+        storagePrefix: "",
+    })),
+    guessMimeType: vi.fn(() => "application/octet-stream"),
+}));
+import { resolveMediaInputs } from "../media/index.js";
+describe("resolveMediaInputs", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("resolves a URI string via MediaStore.fetch()", async () => {
+        const imageData = Buffer.from("fake-png-data");
+        mockFetch.mockResolvedValue({ data: imageData, mimeType: "image/png" });
+        const parts = await resolveMediaInputs(["file:///tmp/photo.png"]);
+        expect(parts).toHaveLength(1);
+        expect(parts[0]).toEqual({
+            type: "image_url",
+            image_url: {
+                url: `data:image/png;base64,${imageData.toString("base64")}`,
+                detail: "high",
+            },
+        });
+        expect(mockFetch).toHaveBeenCalledWith("file:///tmp/photo.png");
+    });
+    it("resolves an inline Buffer media object", async () => {
+        const imageData = Buffer.from("inline-jpeg-data");
+        const parts = await resolveMediaInputs([
+            { data: imageData, mimeType: "image/jpeg" },
+        ]);
+        expect(parts).toHaveLength(1);
+        expect(parts[0]).toEqual({
+            type: "image_url",
+            image_url: {
+                url: `data:image/jpeg;base64,${imageData.toString("base64")}`,
+                detail: "high",
+            },
+        });
+        // Should NOT call MediaStore.fetch for inline buffers
+        expect(mockFetch).not.toHaveBeenCalled();
+    });
+    it("resolves multiple media items (mixed URI and Buffer)", async () => {
+        const uriImageData = Buffer.from("uri-image-data");
+        const bufferImageData = Buffer.from("buffer-image-data");
+        mockFetch.mockResolvedValue({ data: uriImageData, mimeType: "image/png" });
+        const parts = await resolveMediaInputs([
+            "file:///tmp/chart.png",
+            { data: bufferImageData, mimeType: "image/webp" },
+        ]);
+        expect(parts).toHaveLength(2);
+        // First: URI-resolved image
+        expect(parts[0]).toEqual({
+            type: "image_url",
+            image_url: {
+                url: `data:image/png;base64,${uriImageData.toString("base64")}`,
+                detail: "high",
+            },
+        });
+        // Second: inline buffer image
+        expect(parts[1]).toEqual({
+            type: "image_url",
+            image_url: {
+                url: `data:image/webp;base64,${bufferImageData.toString("base64")}`,
+                detail: "high",
+            },
+        });
+    });
+    it("returns empty array for empty media list", async () => {
+        const parts = await resolveMediaInputs([]);
+        expect(parts).toHaveLength(0);
+        expect(mockFetch).not.toHaveBeenCalled();
+    });
+    it("resolves S3 URIs via MediaStore.fetch()", async () => {
+        const imageData = Buffer.from("s3-image");
+        mockFetch.mockResolvedValue({ data: imageData, mimeType: "image/gif" });
+        const parts = await resolveMediaInputs(["s3://bucket/images/logo.gif"]);
+        expect(parts).toHaveLength(1);
+        expect(parts[0].type).toBe("image_url");
+        expect(mockFetch).toHaveBeenCalledWith("s3://bucket/images/logo.gif");
+    });
+});
+describe("LlmCallOptions.media integration", () => {
+    // These tests verify the message structure that would be built
+    // by MeshLlmAgent.run() when media is provided.
+    it("builds multipart content for string message with media", () => {
+        // Simulate what run() does: text + image parts
+        const prompt = "Describe this image";
+        const mediaParts = [
+            {
+                type: "image_url",
+                image_url: {
+                    url: "data:image/png;base64,abc123",
+                    detail: "high",
+                },
+            },
+        ];
+        const message = {
+            role: "user",
+            content: [
+                { type: "text", text: prompt },
+                ...mediaParts,
+            ],
+        };
+        expect(message.content).toHaveLength(2);
+        expect(message.content[0]).toEqual({ type: "text", text: "Describe this image" });
+        expect(message.content[1]).toEqual({
+            type: "image_url",
+            image_url: { url: "data:image/png;base64,abc123", detail: "high" },
+        });
+    });
+    it("preserves plain string message when no media provided", () => {
+        const prompt = "Hello world";
+        const mediaParts = [];
+        // When media is empty, run() uses plain string content
+        const message = mediaParts.length > 0
+            ? { role: "user", content: [{ type: "text", text: prompt }, ...mediaParts] }
+            : { role: "user", content: prompt };
+        expect(message.content).toBe("Hello world");
+    });
+    it("builds multipart with multiple images", () => {
+        const prompt = "Compare these two images";
+        const mediaParts = [
+            {
+                type: "image_url",
+                image_url: { url: "data:image/png;base64,img1", detail: "high" },
+            },
+            {
+                type: "image_url",
+                image_url: { url: "data:image/jpeg;base64,img2", detail: "high" },
+            },
+        ];
+        const message = {
+            role: "user",
+            content: [
+                { type: "text", text: prompt },
+                ...mediaParts,
+            ],
+        };
+        expect(message.content).toHaveLength(3);
+        expect(message.content[0].type).toBe("text");
+        expect(message.content[1].type).toBe("image_url");
+        expect(message.content[2].type).toBe("image_url");
+    });
+});
+//# sourceMappingURL=llm-agent-media.test.js.map

package/dist/__tests__/llm-agent-media.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-agent-media.test.js","sourceRoot":"","sources":["../../src/__tests__/llm-agent-media.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE9D,sCAAsC;AACtC,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9B,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,IAAY,EAAE,MAAqB,EAAE,EAAE,CAAC,EAAE,CAAC;IACjE,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,IAAY,EAAE,MAAqB,EAAE,EAAE,CAAC,IAAI,CAAC;IACtE,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC;CAC1C,CAAC,CAAC,CAAC;AAEJ,uBAAuB;AACvB,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAC1B,EAAE,CAAC,IAAI,CAAC,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC;IACxC,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1B,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE;QACf,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE;KAChB,CAAC,CAAC;IACH,kBAAkB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/B,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,YAAY;QACzB,aAAa,EAAE,EAAE;KAClB,CAAC,CAAC;IACH,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,0BAA0B,CAAC;CACvD,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/C,SAAS,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QAExE,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC;QAElE,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACvB,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE;gBACT,GAAG,EAAE,yBAAyB,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;gBAC5D,MAAM,EAAE,MAAM;aACf;SACF,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,uBAAuB,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAElD,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC;YACrC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE;SAC5C,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACvB,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE;gBACT,GAAG,EAAE,0BAA0B,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;gBAC7D,MAAM,EAAE,MAAM;aACf;SACF,CAAC,CAAC;QACH,sDAAsD;QACtD,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACnD,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAEzD,SAAS,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QAE3E,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC;YACrC,uBAAuB;YACvB,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE;SAClD,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAE9B,4BAA4B;QAC5B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACvB,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE;gBACT,GAAG,EAAE,yBAAyB,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;gBAC/D,MAAM,EAAE,MAAM;aACf;SACF,CAAC,CAAC;QAEH,8BAA8B;QAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACvB,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE;gBACT,GAAG,EAAE,0BAA0B,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;gBACnE,MAAM,EAAE,MAAM;aACf;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,SAAS,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QAExE,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC;QAExE,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxC,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,6BAA6B,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,+DAA+D;IAC/D,gDAAgD;IAEhD,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,+CAA+C;QAC/C,MAAM,MAAM,GAAG,qBAAqB,CAAC;QACrC,MAAM,UAAU,GAAG;YACjB;gBACE,IAAI,EAAE,WAAoB;gBAC1B,SAAS,EAAE;oBACT,GAAG,EAAE,8BAA8B;oBACnC,MAAM,EAAE,MAAe;iBACxB;aACF;SACF,CAAC;QAEF,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,MAAe;YACrB,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE;gBACvC,GAAG,UAAU;aACd;SACF,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAClF,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACjC,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,EAAE,GAAG,EAAE,8BAA8B,EAAE,MAAM,EAAE,MAAM,EAAE;SACnE,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,MAAM,GAAG,aAAa,CAAC;QAC7B,MAAM,UAAU,GAAc,EAAE,CAAC;QAEjC,uDAAuD;QACvD,MAAM,OAAO,GACX,UAAU,CAAC,MAAM,GAAG,CAAC;YACnB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,UAAU,CAAC,EAAE;YAC9F,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAEjD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,0BAA0B,CAAC;QAC1C,MAAM,UAAU,GAAG;YACjB;gBACE,IAAI,EAAE,WAAoB;gBAC1B,SAAS,EAAE,EAAE,GAAG,EAAE,4BAA4B,EAAE,MAAM,EAAE,MAAe,EAAE;aAC1E;YACD;gBACE,IAAI,EAAE,WAAoB;gBAC1B,SAAS,EAAE,EAAE,GAAG,EAAE,6BAA6B,EAAE,MAAM,EAAE,MAAe,EAAE;aAC3E;SACF,CAAC;QAEF,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,MAAe;YACrB,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE;gBACvC,GAAG,UAAU;aACd;SACF,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/media-helpers.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for media/index.ts helper functions.
+ *
+ * Tests mediaResult() and uploadMedia() convenience functions.
+ */
+export {};
+//# sourceMappingURL=media-helpers.test.d.ts.map

package/dist/__tests__/media-helpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-helpers.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/media-helpers.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/__tests__/media-helpers.test.js

@@ -0,0 +1,60 @@
+/**
+ * Unit tests for media/index.ts helper functions.
+ *
+ * Tests mediaResult() and uploadMedia() convenience functions.
+ */
+import { describe, it, expect, vi } from "vitest";
+// Mock @mcpmesh/core before importing
+vi.mock("@mcpmesh/core", () => ({
+    resolveConfig: vi.fn((_key, _value) => ""),
+    resolveConfigInt: vi.fn((_key, _value) => null),
+    getDefault: vi.fn((_key) => null),
+}));
+import { mediaResult } from "../media/index.js";
+describe("mediaResult", () => {
+    it("should build a proper MCP ResourceLink content item", () => {
+        const result = mediaResult("file:///tmp/image.png", "image.png", "image/png");
+        expect(result).toEqual({
+            type: "resource_link",
+            uri: "file:///tmp/image.png",
+            name: "image.png",
+            mimeType: "image/png",
+        });
+    });
+    it("should include description when provided", () => {
+        const result = mediaResult("s3://bucket/photo.jpg", "photo.jpg", "image/jpeg", "A vacation photo");
+        expect(result).toEqual({
+            type: "resource_link",
+            uri: "s3://bucket/photo.jpg",
+            name: "photo.jpg",
+            mimeType: "image/jpeg",
+            description: "A vacation photo",
+        });
+    });
+    it("should include size in _meta when provided", () => {
+        const result = mediaResult("file:///data.csv", "data.csv", "text/csv", undefined, 1024);
+        expect(result).toEqual({
+            type: "resource_link",
+            uri: "file:///data.csv",
+            name: "data.csv",
+            mimeType: "text/csv",
+            _meta: { size: 1024 },
+        });
+    });
+    it("should include both description and size when provided", () => {
+        const result = mediaResult("file:///report.pdf", "report.pdf", "application/pdf", "Quarterly report", 204800);
+        expect(result).toEqual({
+            type: "resource_link",
+            uri: "file:///report.pdf",
+            name: "report.pdf",
+            mimeType: "application/pdf",
+            description: "Quarterly report",
+            _meta: { size: 204800 },
+        });
+    });
+    it("should handle size of 0 correctly", () => {
+        const result = mediaResult("file:///empty.txt", "empty.txt", "text/plain", undefined, 0);
+        expect(result._meta).toEqual({ size: 0 });
+    });
+});
+//# sourceMappingURL=media-helpers.test.js.map

package/dist/__tests__/media-helpers.test.js.map

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

package/dist/__tests__/media-param.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for mediaParam() helper and enrichSchemaWithMediaTypes().
+ *
+ * Tests the [media:TYPE] description convention and JSON Schema enrichment.
+ */
+export {};
+//# sourceMappingURL=media-param.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media-param.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/media-param.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/__tests__/media-param.test.js

@@ -0,0 +1,104 @@
+/**
+ * Unit tests for mediaParam() helper and enrichSchemaWithMediaTypes().
+ *
+ * Tests the [media:TYPE] description convention and JSON Schema enrichment.
+ */
+import { describe, it, expect, vi } from "vitest";
+// Mock @mcpmesh/core before importing
+vi.mock("@mcpmesh/core", () => ({
+    resolveConfig: vi.fn((_key, _value) => ""),
+    resolveConfigInt: vi.fn((_key, _value) => null),
+    getDefault: vi.fn((_key) => null),
+}));
+import { mediaParam } from "../types.js";
+import { enrichSchemaWithMediaTypes } from "../media-param.js";
+describe("mediaParam", () => {
+    it("creates optional string schema", () => {
+        const schema = mediaParam("image/*");
+        expect(schema.isOptional()).toBe(true);
+    });
+    it("includes media type in description", () => {
+        const schema = mediaParam("image/*");
+        expect(schema.description).toContain("[media:image/*]");
+    });
+    it("defaults to */* when no media type specified", () => {
+        const schema = mediaParam();
+        expect(schema.description).toContain("[media:*/*]");
+    });
+    it("accepts specific MIME types", () => {
+        const schema = mediaParam("audio/wav");
+        expect(schema.description).toContain("[media:audio/wav]");
+    });
+});
+describe("enrichSchemaWithMediaTypes", () => {
+    it("adds x-media-type from description convention", () => {
+        const schema = {
+            properties: {
+                image: {
+                    type: "string",
+                    description: "[media:image/*] Media URI for this parameter",
+                },
+            },
+        };
+        enrichSchemaWithMediaTypes(schema);
+        const props = schema.properties;
+        expect(props.image["x-media-type"]).toBe("image/*");
+        expect(props.image.description).toContain("accepts media URI");
+        expect(props.image.description).not.toContain("[media:");
+    });
+    it("leaves non-media params unchanged", () => {
+        const schema = {
+            properties: {
+                question: { type: "string", description: "A question" },
+            },
+        };
+        enrichSchemaWithMediaTypes(schema);
+        const props = schema.properties;
+        expect(props.question["x-media-type"]).toBeUndefined();
+        expect(props.question.description).toBe("A question");
+    });
+    it("handles schema with no properties", () => {
+        const schema = { type: "object" };
+        // Should not throw
+        enrichSchemaWithMediaTypes(schema);
+        expect(schema.type).toBe("object");
+    });
+    it("handles mixed media and non-media params", () => {
+        const schema = {
+            properties: {
+                question: { type: "string", description: "User question" },
+                image: {
+                    type: "string",
+                    description: "[media:image/*] Media URI for this parameter",
+                },
+                audio: {
+                    type: "string",
+                    description: "[media:audio/wav] Media URI for this parameter",
+                },
+            },
+        };
+        enrichSchemaWithMediaTypes(schema);
+        const props = schema.properties;
+        expect(props.question["x-media-type"]).toBeUndefined();
+        expect(props.question.description).toBe("User question");
+        expect(props.image["x-media-type"]).toBe("image/*");
+        expect(props.image.description).toContain("accepts media URI: image/*");
+        expect(props.audio["x-media-type"]).toBe("audio/wav");
+        expect(props.audio.description).toContain("accepts media URI: audio/wav");
+    });
+    it("cleans [media:...] prefix from description", () => {
+        const schema = {
+            properties: {
+                photo: {
+                    type: "string",
+                    description: "[media:image/png] Upload a photo",
+                },
+            },
+        };
+        enrichSchemaWithMediaTypes(schema);
+        const props = schema.properties;
+        expect(props.photo.description).toBe("Upload a photo (accepts media URI: image/png)");
+        expect(props.photo["x-media-type"]).toBe("image/png");
+    });
+});
+//# sourceMappingURL=media-param.test.js.map

package/dist/__tests__/media-param.test.js.map

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

package/dist/__tests__/media-resolver.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Unit tests for media/resolver.ts
+ *
+ * Tests resolveResourceLinks() and hasResourceLink() for converting
+ * resource_link items to provider-native multimodal content.
+ */
+export {};
+//# sourceMappingURL=media-resolver.test.d.ts.map

package/dist/__tests__/media-resolver.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-resolver.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/media-resolver.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}