@tambo-ai/react 0.67.0 → 0.68.0

package/dist/schema/json-schema.test.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const json_schema_1 = require("./json-schema");
+describe("looksLikeJSONSchema", () => {
+    it("should return true for a valid object schema", () => {
+        const schema = {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+            },
+        };
+        expect((0, json_schema_1.looksLikeJSONSchema)(schema)).toBe(true);
+    });
+    it("should return true for a schema with only properties", () => {
+        const schema = {
+            properties: {
+                name: { type: "string" },
+            },
+        };
+        expect((0, json_schema_1.looksLikeJSONSchema)(schema)).toBe(true);
+    });
+    it("should return true for a schema with items (array)", () => {
+        const schema = {
+            type: "array",
+            items: { type: "string" },
+        };
+        expect((0, json_schema_1.looksLikeJSONSchema)(schema)).toBe(true);
+    });
+    it("should return true for a schema with enum", () => {
+        const schema = {
+            enum: ["a", "b", "c"],
+        };
+        expect((0, json_schema_1.looksLikeJSONSchema)(schema)).toBe(true);
+    });
+    it("should return true for a schema with const", () => {
+        const schema = {
+            const: "fixed-value",
+        };
+        expect((0, json_schema_1.looksLikeJSONSchema)(schema)).toBe(true);
+    });
+    it("should return true for a schema with $ref", () => {
+        const schema = {
+            $ref: "#/definitions/Person",
+        };
+        expect((0, json_schema_1.looksLikeJSONSchema)(schema)).toBe(true);
+    });
+    it("should return false for null", () => {
+        expect((0, json_schema_1.looksLikeJSONSchema)(null)).toBe(false);
+    });
+    it("should return false for non-object", () => {
+        expect((0, json_schema_1.looksLikeJSONSchema)("string")).toBe(false);
+        expect((0, json_schema_1.looksLikeJSONSchema)(123)).toBe(false);
+        expect((0, json_schema_1.looksLikeJSONSchema)(undefined)).toBe(false);
+    });
+    it("should return false for empty object", () => {
+        expect((0, json_schema_1.looksLikeJSONSchema)({})).toBe(false);
+    });
+    it("should return false for object without schema keys", () => {
+        const notSchema = {
+            foo: "bar",
+            baz: 123,
+        };
+        expect((0, json_schema_1.looksLikeJSONSchema)(notSchema)).toBe(false);
+    });
+});
+describe("isJsonSchemaTuple", () => {
+    it("should return true for draft-07 tuple (items as array)", () => {
+        const schema = {
+            type: "array",
+            items: [{ type: "string" }, { type: "number" }],
+        };
+        expect((0, json_schema_1.isJsonSchemaTuple)(schema)).toBe(true);
+    });
+    it("should return true for draft 2020-12 tuple (prefixItems)", () => {
+        const schema = {
+            type: "array",
+            prefixItems: [{ type: "string" }, { type: "number" }],
+        };
+        expect((0, json_schema_1.isJsonSchemaTuple)(schema)).toBe(true);
+    });
+    it("should return false for regular array schema (items as object)", () => {
+        const schema = {
+            type: "array",
+            items: { type: "string" },
+        };
+        expect((0, json_schema_1.isJsonSchemaTuple)(schema)).toBe(false);
+    });
+    it("should return false for non-array schema", () => {
+        const schema = {
+            type: "object",
+            properties: {},
+        };
+        expect((0, json_schema_1.isJsonSchemaTuple)(schema)).toBe(false);
+    });
+    it("should return false for array without items or prefixItems", () => {
+        const schema = {
+            type: "array",
+        };
+        expect((0, json_schema_1.isJsonSchemaTuple)(schema)).toBe(false);
+    });
+});
+describe("getJsonSchemaTupleItems", () => {
+    it("should return items for draft-07 tuple", () => {
+        const items = [{ type: "string" }, { type: "number" }];
+        const schema = {
+            type: "array",
+            items: items,
+        };
+        expect((0, json_schema_1.getJsonSchemaTupleItems)(schema)).toEqual(items);
+    });
+    it("should return prefixItems for draft 2020-12 tuple", () => {
+        const prefixItems = [{ type: "string" }, { type: "number" }];
+        const schema = {
+            type: "array",
+            prefixItems: prefixItems,
+        };
+        expect((0, json_schema_1.getJsonSchemaTupleItems)(schema)).toEqual(prefixItems);
+    });
+    it("should return undefined for non-array schema", () => {
+        const schema = {
+            type: "object",
+        };
+        expect((0, json_schema_1.getJsonSchemaTupleItems)(schema)).toBeUndefined();
+    });
+    it("should return undefined for array without tuple items", () => {
+        const schema = {
+            type: "array",
+            items: { type: "string" },
+        };
+        expect((0, json_schema_1.getJsonSchemaTupleItems)(schema)).toBeUndefined();
+    });
+    it("should prefer prefixItems over items when both present", () => {
+        const prefixItems = [{ type: "boolean" }];
+        const items = [{ type: "string" }];
+        const schema = {
+            type: "array",
+            prefixItems: prefixItems,
+            items: items,
+        };
+        expect((0, json_schema_1.getJsonSchemaTupleItems)(schema)).toEqual(prefixItems);
+    });
+});
+describe("makeJsonSchemaPartial", () => {
+    it("should remove required array from schema", () => {
+        const schema = {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+                age: { type: "number" },
+            },
+            required: ["name", "age"],
+        };
+        const partial = (0, json_schema_1.makeJsonSchemaPartial)(schema);
+        expect(partial.required).toBeUndefined();
+        expect(partial.type).toBe("object");
+        expect(partial.properties).toEqual(schema.properties);
+    });
+    it("should preserve all other properties", () => {
+        const schema = {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "The name" },
+            },
+            required: ["name"],
+            additionalProperties: false,
+            description: "A person schema",
+            title: "Person",
+        };
+        const partial = (0, json_schema_1.makeJsonSchemaPartial)(schema);
+        expect(partial.required).toBeUndefined();
+        expect(partial.type).toBe("object");
+        expect(partial.properties).toEqual(schema.properties);
+        expect(partial.additionalProperties).toBe(false);
+        expect(partial.description).toBe("A person schema");
+        expect(partial.title).toBe("Person");
+    });
+    it("should handle schema without required array", () => {
+        const schema = {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+            },
+        };
+        const partial = (0, json_schema_1.makeJsonSchemaPartial)(schema);
+        expect(partial.required).toBeUndefined();
+        expect(partial.type).toBe("object");
+        expect(partial.properties).toEqual(schema.properties);
+    });
+    it("should not mutate the original schema", () => {
+        const schema = {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+            },
+            required: ["name"],
+        };
+        const partial = (0, json_schema_1.makeJsonSchemaPartial)(schema);
+        // Original should be unchanged
+        expect(schema.required).toEqual(["name"]);
+        // Partial should not have required
+        expect(partial.required).toBeUndefined();
+    });
+});
+//# sourceMappingURL=json-schema.test.js.map

package/dist/schema/json-schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.test.js","sourceRoot":"","sources":["../../src/schema/json-schema.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { JSONSchema7 } from \"json-schema\";\nimport {\n  getJsonSchemaTupleItems,\n  isJsonSchemaTuple,\n  JSONSchema7Extended,\n  looksLikeJSONSchema,\n  makeJsonSchemaPartial,\n} from \"./json-schema\";\n\ndescribe(\"looksLikeJSONSchema\", () => {\n  it(\"should return true for a valid object schema\", () => {\n    const schema = {\n      type: \"object\",\n      properties: {\n        name: { type: \"string\" },\n      },\n    };\n    expect(looksLikeJSONSchema(schema)).toBe(true);\n  });\n\n  it(\"should return true for a schema with only properties\", () => {\n    const schema = {\n      properties: {\n        name: { type: \"string\" },\n      },\n    };\n    expect(looksLikeJSONSchema(schema)).toBe(true);\n  });\n\n  it(\"should return true for a schema with items (array)\", () => {\n    const schema = {\n      type: \"array\",\n      items: { type: \"string\" },\n    };\n    expect(looksLikeJSONSchema(schema)).toBe(true);\n  });\n\n  it(\"should return true for a schema with enum\", () => {\n    const schema = {\n      enum: [\"a\", \"b\", \"c\"],\n    };\n    expect(looksLikeJSONSchema(schema)).toBe(true);\n  });\n\n  it(\"should return true for a schema with const\", () => {\n    const schema = {\n      const: \"fixed-value\",\n    };\n    expect(looksLikeJSONSchema(schema)).toBe(true);\n  });\n\n  it(\"should return true for a schema with $ref\", () => {\n    const schema = {\n      $ref: \"#/definitions/Person\",\n    };\n    expect(looksLikeJSONSchema(schema)).toBe(true);\n  });\n\n  it(\"should return false for null\", () => {\n    expect(looksLikeJSONSchema(null)).toBe(false);\n  });\n\n  it(\"should return false for non-object\", () => {\n    expect(looksLikeJSONSchema(\"string\")).toBe(false);\n    expect(looksLikeJSONSchema(123)).toBe(false);\n    expect(looksLikeJSONSchema(undefined)).toBe(false);\n  });\n\n  it(\"should return false for empty object\", () => {\n    expect(looksLikeJSONSchema({})).toBe(false);\n  });\n\n  it(\"should return false for object without schema keys\", () => {\n    const notSchema = {\n      foo: \"bar\",\n      baz: 123,\n    };\n    expect(looksLikeJSONSchema(notSchema)).toBe(false);\n  });\n});\n\ndescribe(\"isJsonSchemaTuple\", () => {\n  it(\"should return true for draft-07 tuple (items as array)\", () => {\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n      items: [{ type: \"string\" }, { type: \"number\" }],\n    };\n    expect(isJsonSchemaTuple(schema)).toBe(true);\n  });\n\n  it(\"should return true for draft 2020-12 tuple (prefixItems)\", () => {\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n      prefixItems: [{ type: \"string\" }, { type: \"number\" }],\n    };\n    expect(isJsonSchemaTuple(schema)).toBe(true);\n  });\n\n  it(\"should return false for regular array schema (items as object)\", () => {\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n      items: { type: \"string\" },\n    };\n    expect(isJsonSchemaTuple(schema)).toBe(false);\n  });\n\n  it(\"should return false for non-array schema\", () => {\n    const schema: JSONSchema7Extended = {\n      type: \"object\",\n      properties: {},\n    };\n    expect(isJsonSchemaTuple(schema)).toBe(false);\n  });\n\n  it(\"should return false for array without items or prefixItems\", () => {\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n    };\n    expect(isJsonSchemaTuple(schema)).toBe(false);\n  });\n});\n\ndescribe(\"getJsonSchemaTupleItems\", () => {\n  it(\"should return items for draft-07 tuple\", () => {\n    const items = [{ type: \"string\" }, { type: \"number\" }];\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n      items: items as JSONSchema7[],\n    };\n    expect(getJsonSchemaTupleItems(schema)).toEqual(items);\n  });\n\n  it(\"should return prefixItems for draft 2020-12 tuple\", () => {\n    const prefixItems = [{ type: \"string\" }, { type: \"number\" }];\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n      prefixItems: prefixItems as JSONSchema7[],\n    };\n    expect(getJsonSchemaTupleItems(schema)).toEqual(prefixItems);\n  });\n\n  it(\"should return undefined for non-array schema\", () => {\n    const schema: JSONSchema7Extended = {\n      type: \"object\",\n    };\n    expect(getJsonSchemaTupleItems(schema)).toBeUndefined();\n  });\n\n  it(\"should return undefined for array without tuple items\", () => {\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n      items: { type: \"string\" },\n    };\n    expect(getJsonSchemaTupleItems(schema)).toBeUndefined();\n  });\n\n  it(\"should prefer prefixItems over items when both present\", () => {\n    const prefixItems = [{ type: \"boolean\" }];\n    const items = [{ type: \"string\" }];\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n      prefixItems: prefixItems as JSONSchema7[],\n      items: items as JSONSchema7[],\n    };\n    expect(getJsonSchemaTupleItems(schema)).toEqual(prefixItems);\n  });\n});\n\ndescribe(\"makeJsonSchemaPartial\", () => {\n  it(\"should remove required array from schema\", () => {\n    const schema: JSONSchema7 = {\n      type: \"object\",\n      properties: {\n        name: { type: \"string\" },\n        age: { type: \"number\" },\n      },\n      required: [\"name\", \"age\"],\n    };\n\n    const partial = makeJsonSchemaPartial(schema);\n\n    expect(partial.required).toBeUndefined();\n    expect(partial.type).toBe(\"object\");\n    expect(partial.properties).toEqual(schema.properties);\n  });\n\n  it(\"should preserve all other properties\", () => {\n    const schema: JSONSchema7 = {\n      type: \"object\",\n      properties: {\n        name: { type: \"string\", description: \"The name\" },\n      },\n      required: [\"name\"],\n      additionalProperties: false,\n      description: \"A person schema\",\n      title: \"Person\",\n    };\n\n    const partial = makeJsonSchemaPartial(schema);\n\n    expect(partial.required).toBeUndefined();\n    expect(partial.type).toBe(\"object\");\n    expect(partial.properties).toEqual(schema.properties);\n    expect(partial.additionalProperties).toBe(false);\n    expect(partial.description).toBe(\"A person schema\");\n    expect(partial.title).toBe(\"Person\");\n  });\n\n  it(\"should handle schema without required array\", () => {\n    const schema: JSONSchema7 = {\n      type: \"object\",\n      properties: {\n        name: { type: \"string\" },\n      },\n    };\n\n    const partial = makeJsonSchemaPartial(schema);\n\n    expect(partial.required).toBeUndefined();\n    expect(partial.type).toBe(\"object\");\n    expect(partial.properties).toEqual(schema.properties);\n  });\n\n  it(\"should not mutate the original schema\", () => {\n    const schema: JSONSchema7 = {\n      type: \"object\",\n      properties: {\n        name: { type: \"string\" },\n      },\n      required: [\"name\"],\n    };\n\n    const partial = makeJsonSchemaPartial(schema);\n\n    // Original should be unchanged\n    expect(schema.required).toEqual([\"name\"]);\n    // Partial should not have required\n    expect(partial.required).toBeUndefined();\n  });\n});\n"]}

package/dist/setupTests.js

@@ -2,11 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 require("@testing-library/jest-dom");
 const util_1 = require("util");
+const web_1 = require("stream/web");
 // Mock Date.now() to return a fixed timestamp for consistent testing
 const mockDate = new Date(2025, 0, 5, 12, 32, 58, 936);
 global.Date.now = jest.fn(() => mockDate.getTime());
 // Add TextEncoder/TextDecoder polyfills for Node.js test environment
 Object.assign(global, { TextEncoder: util_1.TextEncoder, TextDecoder: util_1.TextDecoder });
+// Add Web Streams API polyfills for jsdom environment (used by @modelcontextprotocol/sdk)
+Object.assign(global, { TransformStream: web_1.TransformStream, ReadableStream: web_1.ReadableStream, WritableStream: web_1.WritableStream });
 // Mock react-media-recorder for tests (browser APIs not available in Node.js)
 jest.mock("react-media-recorder", () => ({
     useReactMediaRecorder: () => ({

package/dist/setupTests.js.map

@@ -1 +1 @@
-{"version":3,"file":"setupTests.js","sourceRoot":"","sources":["../src/setupTests.ts"],"names":[],"mappings":";;AAAA,qCAAmC;AACnC,+BAAgD;AAEhD,qEAAqE;AACrE,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;AACvD,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;AAEpD,qEAAqE;AACrE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,WAAW,EAAX,kBAAW,EAAE,WAAW,EAAX,kBAAW,EAAE,CAAC,CAAC;AAEpD,8EAA8E;AAC9E,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC;IACvC,qBAAqB,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5B,MAAM,EAAE,MAAM;QACd,cAAc,EAAE,IAAI,CAAC,EAAE,EAAE;QACzB,aAAa,EAAE,IAAI,CAAC,EAAE,EAAE;QACxB,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,IAAI;KACZ,CAAC;CACH,CAAC,CAAC,CAAC","sourcesContent":["import \"@testing-library/jest-dom\";\nimport { TextDecoder, TextEncoder } from \"util\";\n\n// Mock Date.now() to return a fixed timestamp for consistent testing\nconst mockDate = new Date(2025, 0, 5, 12, 32, 58, 936);\nglobal.Date.now = jest.fn(() => mockDate.getTime());\n\n// Add TextEncoder/TextDecoder polyfills for Node.js test environment\nObject.assign(global, { TextEncoder, TextDecoder });\n\n// Mock react-media-recorder for tests (browser APIs not available in Node.js)\njest.mock(\"react-media-recorder\", () => ({\n  useReactMediaRecorder: () => ({\n    status: \"idle\",\n    startRecording: jest.fn(),\n    stopRecording: jest.fn(),\n    mediaBlobUrl: null,\n    error: null,\n  }),\n}));\n"]}
+{"version":3,"file":"setupTests.js","sourceRoot":"","sources":["../src/setupTests.ts"],"names":[],"mappings":";;AAAA,qCAAmC;AACnC,+BAAgD;AAChD,oCAA6E;AAE7E,qEAAqE;AACrE,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;AACvD,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;AAEpD,qEAAqE;AACrE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,WAAW,EAAX,kBAAW,EAAE,WAAW,EAAX,kBAAW,EAAE,CAAC,CAAC;AAEpD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,eAAe,EAAf,qBAAe,EAAE,cAAc,EAAd,oBAAc,EAAE,cAAc,EAAd,oBAAc,EAAE,CAAC,CAAC;AAE3E,8EAA8E;AAC9E,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC;IACvC,qBAAqB,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5B,MAAM,EAAE,MAAM;QACd,cAAc,EAAE,IAAI,CAAC,EAAE,EAAE;QACzB,aAAa,EAAE,IAAI,CAAC,EAAE,EAAE;QACxB,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,IAAI;KACZ,CAAC;CACH,CAAC,CAAC,CAAC","sourcesContent":["import \"@testing-library/jest-dom\";\nimport { TextDecoder, TextEncoder } from \"util\";\nimport { TransformStream, ReadableStream, WritableStream } from \"stream/web\";\n\n// Mock Date.now() to return a fixed timestamp for consistent testing\nconst mockDate = new Date(2025, 0, 5, 12, 32, 58, 936);\nglobal.Date.now = jest.fn(() => mockDate.getTime());\n\n// Add TextEncoder/TextDecoder polyfills for Node.js test environment\nObject.assign(global, { TextEncoder, TextDecoder });\n\n// Add Web Streams API polyfills for jsdom environment (used by @modelcontextprotocol/sdk)\nObject.assign(global, { TransformStream, ReadableStream, WritableStream });\n\n// Mock react-media-recorder for tests (browser APIs not available in Node.js)\njest.mock(\"react-media-recorder\", () => ({\n  useReactMediaRecorder: () => ({\n    status: \"idle\",\n    startRecording: jest.fn(),\n    stopRecording: jest.fn(),\n    mediaBlobUrl: null,\n    error: null,\n  }),\n}));\n"]}

package/dist/util/message-builder.d.ts

@@ -1,3 +1,4 @@
+import type { ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
 import type TamboAI from "@tambo-ai/typescript-sdk";
 import { StagedImage } from "../hooks/use-message-images";
 /**
@@ -5,7 +6,8 @@ import { StagedImage } from "../hooks/use-message-images";
  * @param text - The text content, may include \@serverKey:uri resource references
  * @param images - Array of staged images
  * @param resourceNames - Map of resource IDs (serverKey:uri) to their display names
+ * @param resourceContent - Optional map of prefixed URIs to resolved content (for client-side resources)
  * @returns Array of message content parts
  */
-export declare function buildMessageContent(text: string, images: StagedImage[], resourceNames?: Record<string, string>): TamboAI.Beta.Threads.ChatCompletionContentPart[];
+export declare function buildMessageContent(text: string, images: StagedImage[], resourceNames?: Record<string, string>, resourceContent?: Map<string, ReadResourceResult>): TamboAI.Beta.Threads.ChatCompletionContentPart[];
 //# sourceMappingURL=message-builder.d.ts.map

package/dist/util/message-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-builder.d.ts","sourceRoot":"","sources":["../../src/util/message-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAsF1D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EAAE,EACrB,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACzC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,CA4BlD"}
+{"version":3,"file":"message-builder.d.ts","sourceRoot":"","sources":["../../src/util/message-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAwG1D;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EAAE,EACrB,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAC1C,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAChD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,CA4BlD"}

package/dist/util/message-builder.js

@@ -25,9 +25,10 @@ const RESOURCE_REFERENCE_PATTERN = /@([a-zA-Z0-9-]+):(\S+)/g;
  * - The backend routes resources based on the thread's MCP server configuration, not client-side keys
  * @param text - Text potentially containing resource references
  * @param resourceNames - Map of full resource IDs (serverKey:uri) to their display names
+ * @param resourceContent - Optional map of prefixed URIs to resolved content (for client-side resources)
  * @returns Array of content parts in order (text and resource parts interleaved)
  */
-function parseResourceReferences(text, resourceNames) {
+function parseResourceReferences(text, resourceNames, resourceContent) {
     const parts = [];
     // Use matchAll to avoid global regex state issues
     const matches = Array.from(text.matchAll(RESOURCE_REFERENCE_PATTERN));
@@ -51,6 +52,21 @@ function parseResourceReferences(text, resourceNames) {
         if (name) {
             resource.name = name;
         }
+        // Include resolved content for client-side resources (MCP and registry)
+        // Server-side resources won't be in the map - backend resolves them by URI
+        const resolvedContent = resourceContent?.get(fullId);
+        if (resolvedContent?.contents?.[0]) {
+            const content = resolvedContent.contents[0];
+            if ("text" in content && content.text) {
+                resource.text = content.text;
+            }
+            else if ("blob" in content && content.blob) {
+                resource.blob = content.blob;
+            }
+            if ("mimeType" in content && content.mimeType) {
+                resource.mimeType = content.mimeType;
+            }
+        }
         parts.push({ type: "resource", resource });
         if (match.index !== undefined) {
             lastIndex = match.index + fullMatch.length;
@@ -77,16 +93,17 @@ function parseResourceReferences(text, resourceNames) {
  * @param text - The text content, may include \@serverKey:uri resource references
  * @param images - Array of staged images
  * @param resourceNames - Map of resource IDs (serverKey:uri) to their display names
+ * @param resourceContent - Optional map of prefixed URIs to resolved content (for client-side resources)
  * @returns Array of message content parts
  */
-function buildMessageContent(text, images, resourceNames = {}) {
+function buildMessageContent(text, images, resourceNames = {}, resourceContent) {
     const content = [];
     const hasNonWhitespaceText = text.trim().length > 0;
     if (hasNonWhitespaceText) {
         // Parse resource references from the original text so that all
         // user-visible whitespace (including leading/trailing spaces and
         // internal spacing) is preserved in the resulting content parts.
-        const parts = parseResourceReferences(text, resourceNames);
+        const parts = parseResourceReferences(text, resourceNames, resourceContent);
         content.push(...parts);
     }
     // Add images at the end

package/dist/util/message-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-builder.js","sourceRoot":"","sources":["../../src/util/message-builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { StagedImage } from \"../hooks/use-message-images\";\n\n/**\n * Regular expression to match MCP resource references in the format: \\@serverKey:uri\n *\n * Examples:\n * - \\@tambo-1hfs429:tambo:test://static/resource/1\n * - \\@linear:file://path/to/file\n *\n * Pattern breakdown:\n * - \\@              - Literal \\@ symbol\n * - ([a-zA-Z0-9-]+) - Server key (alphanumeric + hyphens, client-side routing key)\n * - :               - Literal colon separator\n * - (\\S+)           - URI (non-whitespace characters, actual resource URI)\n */\nconst RESOURCE_REFERENCE_PATTERN = /@([a-zA-Z0-9-]+):(\\S+)/g;\n\n/**\n * Parses text with resource references and returns interleaved content parts.\n * Resource references have the format: \\@serverKey:uri\n *\n * The serverKey prefix is stripped before sending to the backend because:\n * - It's a client-side routing key (e.g., \"tambo-1hfs429\") used by React SDK to route to the correct MCP connection\n * - The backend only needs the actual resource URI (e.g., \"tambo:test://static/resource/1\")\n * - The backend routes resources based on the thread's MCP server configuration, not client-side keys\n * @param text - Text potentially containing resource references\n * @param resourceNames - Map of full resource IDs (serverKey:uri) to their display names\n * @returns Array of content parts in order (text and resource parts interleaved)\n */\nfunction parseResourceReferences(\n  text: string,\n  resourceNames: Record<string, string>,\n): TamboAI.Beta.Threads.ChatCompletionContentPart[] {\n  const parts: TamboAI.Beta.Threads.ChatCompletionContentPart[] = [];\n\n  // Use matchAll to avoid global regex state issues\n  const matches = Array.from(text.matchAll(RESOURCE_REFERENCE_PATTERN));\n  let lastIndex = 0;\n\n  // Find all resource references and interleave with text\n  for (const match of matches) {\n    const [fullMatch, serverKey, uri] = match;\n    const fullId = `${serverKey}:${uri}`;\n\n    // Add text before this resource reference (preserve whitespace)\n    if (match.index !== undefined && match.index > lastIndex) {\n      const textBefore = text.slice(lastIndex, match.index);\n      if (textBefore.length > 0) {\n        parts.push({\n          type: \"text\",\n          text: textBefore,\n        });\n      }\n    }\n\n    const resource: TamboAI.Resource = { uri };\n    const name = resourceNames[fullId];\n    if (name) {\n      resource.name = name;\n    }\n    parts.push({ type: \"resource\", resource });\n\n    if (match.index !== undefined) {\n      lastIndex = match.index + fullMatch.length;\n    }\n  }\n\n  // Add remaining text after the last resource reference (preserve whitespace)\n  if (lastIndex < text.length) {\n    const textAfter = text.slice(lastIndex);\n    if (textAfter.length > 0) {\n      parts.push({\n        type: \"text\",\n        text: textAfter,\n      });\n    }\n  }\n\n  // If no resource references were found, return the whole text as a single text part\n  if (parts.length === 0 && text.trim()) {\n    parts.push({ type: \"text\", text });\n  }\n\n  return parts;\n}\n\n/**\n * Builds message content with text, MCP resource references, and images\n * @param text - The text content, may include \\@serverKey:uri resource references\n * @param images - Array of staged images\n * @param resourceNames - Map of resource IDs (serverKey:uri) to their display names\n * @returns Array of message content parts\n */\nexport function buildMessageContent(\n  text: string,\n  images: StagedImage[],\n  resourceNames: Record<string, string> = {},\n): TamboAI.Beta.Threads.ChatCompletionContentPart[] {\n  const content: TamboAI.Beta.Threads.ChatCompletionContentPart[] = [];\n\n  const hasNonWhitespaceText = text.trim().length > 0;\n\n  if (hasNonWhitespaceText) {\n    // Parse resource references from the original text so that all\n    // user-visible whitespace (including leading/trailing spaces and\n    // internal spacing) is preserved in the resulting content parts.\n    const parts = parseResourceReferences(text, resourceNames);\n    content.push(...parts);\n  }\n\n  // Add images at the end\n  for (const image of images) {\n    content.push({\n      type: \"image_url\",\n      image_url: {\n        url: image.dataUrl,\n      },\n    });\n  }\n\n  if (content.length === 0) {\n    throw new Error(\"Message must contain text or images\");\n  }\n\n  return content;\n}\n"]}
+{"version":3,"file":"message-builder.js","sourceRoot":"","sources":["../../src/util/message-builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReadResourceResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { StagedImage } from \"../hooks/use-message-images\";\n\n/**\n * Regular expression to match MCP resource references in the format: \\@serverKey:uri\n *\n * Examples:\n * - \\@tambo-1hfs429:tambo:test://static/resource/1\n * - \\@linear:file://path/to/file\n *\n * Pattern breakdown:\n * - \\@              - Literal \\@ symbol\n * - ([a-zA-Z0-9-]+) - Server key (alphanumeric + hyphens, client-side routing key)\n * - :               - Literal colon separator\n * - (\\S+)           - URI (non-whitespace characters, actual resource URI)\n */\nconst RESOURCE_REFERENCE_PATTERN = /@([a-zA-Z0-9-]+):(\\S+)/g;\n\n/**\n * Parses text with resource references and returns interleaved content parts.\n * Resource references have the format: \\@serverKey:uri\n *\n * The serverKey prefix is stripped before sending to the backend because:\n * - It's a client-side routing key (e.g., \"tambo-1hfs429\") used by React SDK to route to the correct MCP connection\n * - The backend only needs the actual resource URI (e.g., \"tambo:test://static/resource/1\")\n * - The backend routes resources based on the thread's MCP server configuration, not client-side keys\n * @param text - Text potentially containing resource references\n * @param resourceNames - Map of full resource IDs (serverKey:uri) to their display names\n * @param resourceContent - Optional map of prefixed URIs to resolved content (for client-side resources)\n * @returns Array of content parts in order (text and resource parts interleaved)\n */\nfunction parseResourceReferences(\n  text: string,\n  resourceNames: Record<string, string>,\n  resourceContent?: Map<string, ReadResourceResult>,\n): TamboAI.Beta.Threads.ChatCompletionContentPart[] {\n  const parts: TamboAI.Beta.Threads.ChatCompletionContentPart[] = [];\n\n  // Use matchAll to avoid global regex state issues\n  const matches = Array.from(text.matchAll(RESOURCE_REFERENCE_PATTERN));\n  let lastIndex = 0;\n\n  // Find all resource references and interleave with text\n  for (const match of matches) {\n    const [fullMatch, serverKey, uri] = match;\n    const fullId = `${serverKey}:${uri}`;\n\n    // Add text before this resource reference (preserve whitespace)\n    if (match.index !== undefined && match.index > lastIndex) {\n      const textBefore = text.slice(lastIndex, match.index);\n      if (textBefore.length > 0) {\n        parts.push({\n          type: \"text\",\n          text: textBefore,\n        });\n      }\n    }\n\n    const resource: TamboAI.Resource = { uri };\n    const name = resourceNames[fullId];\n    if (name) {\n      resource.name = name;\n    }\n\n    // Include resolved content for client-side resources (MCP and registry)\n    // Server-side resources won't be in the map - backend resolves them by URI\n    const resolvedContent = resourceContent?.get(fullId);\n    if (resolvedContent?.contents?.[0]) {\n      const content = resolvedContent.contents[0];\n      if (\"text\" in content && content.text) {\n        resource.text = content.text;\n      } else if (\"blob\" in content && content.blob) {\n        resource.blob = content.blob;\n      }\n      if (\"mimeType\" in content && content.mimeType) {\n        resource.mimeType = content.mimeType;\n      }\n    }\n\n    parts.push({ type: \"resource\", resource });\n\n    if (match.index !== undefined) {\n      lastIndex = match.index + fullMatch.length;\n    }\n  }\n\n  // Add remaining text after the last resource reference (preserve whitespace)\n  if (lastIndex < text.length) {\n    const textAfter = text.slice(lastIndex);\n    if (textAfter.length > 0) {\n      parts.push({\n        type: \"text\",\n        text: textAfter,\n      });\n    }\n  }\n\n  // If no resource references were found, return the whole text as a single text part\n  if (parts.length === 0 && text.trim()) {\n    parts.push({ type: \"text\", text });\n  }\n\n  return parts;\n}\n\n/**\n * Builds message content with text, MCP resource references, and images\n * @param text - The text content, may include \\@serverKey:uri resource references\n * @param images - Array of staged images\n * @param resourceNames - Map of resource IDs (serverKey:uri) to their display names\n * @param resourceContent - Optional map of prefixed URIs to resolved content (for client-side resources)\n * @returns Array of message content parts\n */\nexport function buildMessageContent(\n  text: string,\n  images: StagedImage[],\n  resourceNames: Record<string, string> = {},\n  resourceContent?: Map<string, ReadResourceResult>,\n): TamboAI.Beta.Threads.ChatCompletionContentPart[] {\n  const content: TamboAI.Beta.Threads.ChatCompletionContentPart[] = [];\n\n  const hasNonWhitespaceText = text.trim().length > 0;\n\n  if (hasNonWhitespaceText) {\n    // Parse resource references from the original text so that all\n    // user-visible whitespace (including leading/trailing spaces and\n    // internal spacing) is preserved in the resulting content parts.\n    const parts = parseResourceReferences(text, resourceNames, resourceContent);\n    content.push(...parts);\n  }\n\n  // Add images at the end\n  for (const image of images) {\n    content.push({\n      type: \"image_url\",\n      image_url: {\n        url: image.dataUrl,\n      },\n    });\n  }\n\n  if (content.length === 0) {\n    throw new Error(\"Message must contain text or images\");\n  }\n\n  return content;\n}\n"]}

package/dist/util/message-builder.test.js

@@ -674,5 +674,274 @@ describe("buildMessageContent", () => {
             expect(result[0].type).toBe("resource");
         });
     });
+    describe("resource content resolution", () => {
+        it("should include text content from resolved resource", () => {
+            const resourceContent = new Map([
+                [
+                    "registry:file:///doc.txt",
+                    {
+                        contents: [
+                            {
+                                uri: "file:///doc.txt",
+                                mimeType: "text/plain",
+                                text: "This is the document content",
+                            },
+                        ],
+                    },
+                ],
+            ]);
+            const result = (0, message_builder_1.buildMessageContent)("Check @registry:file:///doc.txt", [], {}, resourceContent);
+            expect(result).toEqual([
+                {
+                    type: "text",
+                    text: "Check ",
+                },
+                {
+                    type: "resource",
+                    resource: {
+                        uri: "file:///doc.txt",
+                        text: "This is the document content",
+                        mimeType: "text/plain",
+                    },
+                },
+            ]);
+        });
+        it("should include blob content from resolved resource", () => {
+            const resourceContent = new Map([
+                [
+                    "registry:file:///image.png",
+                    {
+                        contents: [
+                            {
+                                uri: "file:///image.png",
+                                mimeType: "image/png",
+                                blob: "base64encodeddata",
+                            },
+                        ],
+                    },
+                ],
+            ]);
+            const result = (0, message_builder_1.buildMessageContent)("Check @registry:file:///image.png", [], {}, resourceContent);
+            expect(result).toEqual([
+                {
+                    type: "text",
+                    text: "Check ",
+                },
+                {
+                    type: "resource",
+                    resource: {
+                        uri: "file:///image.png",
+                        blob: "base64encodeddata",
+                        mimeType: "image/png",
+                    },
+                },
+            ]);
+        });
+        it("should include name and resolved content together", () => {
+            const resourceNames = {
+                "registry:file:///doc.txt": "Important Document",
+            };
+            const resourceContent = new Map([
+                [
+                    "registry:file:///doc.txt",
+                    {
+                        contents: [
+                            {
+                                uri: "file:///doc.txt",
+                                mimeType: "text/plain",
+                                text: "Document content here",
+                            },
+                        ],
+                    },
+                ],
+            ]);
+            const result = (0, message_builder_1.buildMessageContent)("@registry:file:///doc.txt", [], resourceNames, resourceContent);
+            expect(result).toEqual([
+                {
+                    type: "resource",
+                    resource: {
+                        uri: "file:///doc.txt",
+                        name: "Important Document",
+                        text: "Document content here",
+                        mimeType: "text/plain",
+                    },
+                },
+            ]);
+        });
+        it("should handle multiple resources with mixed resolved content", () => {
+            const resourceContent = new Map([
+                [
+                    "registry:file:///doc1.txt",
+                    {
+                        contents: [
+                            {
+                                uri: "file:///doc1.txt",
+                                text: "First doc content",
+                            },
+                        ],
+                    },
+                ],
+                // doc2 is NOT in resourceContent - simulates internal server resource
+            ]);
+            const result = (0, message_builder_1.buildMessageContent)("@registry:file:///doc1.txt and @tambo-abc:tambo://doc2", [], {}, resourceContent);
+            expect(result).toEqual([
+                {
+                    type: "resource",
+                    resource: {
+                        uri: "file:///doc1.txt",
+                        text: "First doc content",
+                    },
+                },
+                {
+                    type: "text",
+                    text: " and ",
+                },
+                {
+                    type: "resource",
+                    resource: {
+                        uri: "tambo://doc2",
+                        // No text/blob - internal server resource
+                    },
+                },
+            ]);
+        });
+        it("should handle resolved content without mimeType", () => {
+            const resourceContent = new Map([
+                [
+                    "server:file:///doc.txt",
+                    {
+                        contents: [
+                            {
+                                uri: "file:///doc.txt",
+                                text: "Content without mimeType",
+                            },
+                        ],
+                    },
+                ],
+            ]);
+            const result = (0, message_builder_1.buildMessageContent)("@server:file:///doc.txt", [], {}, resourceContent);
+            expect(result).toEqual([
+                {
+                    type: "resource",
+                    resource: {
+                        uri: "file:///doc.txt",
+                        text: "Content without mimeType",
+                    },
+                },
+            ]);
+        });
+        it("should handle empty resourceContent map gracefully", () => {
+            const result = (0, message_builder_1.buildMessageContent)("@registry:file:///doc.txt", [], {}, new Map());
+            expect(result).toEqual([
+                {
+                    type: "resource",
+                    resource: {
+                        uri: "file:///doc.txt",
+                    },
+                },
+            ]);
+        });
+        it("should handle undefined resourceContent gracefully", () => {
+            const result = (0, message_builder_1.buildMessageContent)("@registry:file:///doc.txt", [], {}, undefined);
+            expect(result).toEqual([
+                {
+                    type: "resource",
+                    resource: {
+                        uri: "file:///doc.txt",
+                    },
+                },
+            ]);
+        });
+        it("should handle resolved content with empty contents array", () => {
+            const resourceContent = new Map([
+                [
+                    "registry:file:///doc.txt",
+                    {
+                        contents: [],
+                    },
+                ],
+            ]);
+            const result = (0, message_builder_1.buildMessageContent)("@registry:file:///doc.txt", [], {}, resourceContent);
+            expect(result).toEqual([
+                {
+                    type: "resource",
+                    resource: {
+                        uri: "file:///doc.txt",
+                    },
+                },
+            ]);
+        });
+        it("should include resolved content with MCP server resources", () => {
+            const resourceContent = new Map([
+                [
+                    "linear:linear://issue/123",
+                    {
+                        contents: [
+                            {
+                                uri: "linear://issue/123",
+                                mimeType: "application/json",
+                                text: '{"title": "Bug fix", "status": "open"}',
+                            },
+                        ],
+                    },
+                ],
+            ]);
+            const result = (0, message_builder_1.buildMessageContent)("Check issue @linear:linear://issue/123", [], {}, resourceContent);
+            expect(result).toEqual([
+                {
+                    type: "text",
+                    text: "Check issue ",
+                },
+                {
+                    type: "resource",
+                    resource: {
+                        uri: "linear://issue/123",
+                        text: '{"title": "Bug fix", "status": "open"}',
+                        mimeType: "application/json",
+                    },
+                },
+            ]);
+        });
+        it("should combine resolved content with images", () => {
+            const resourceContent = new Map([
+                [
+                    "registry:file:///doc.txt",
+                    {
+                        contents: [
+                            {
+                                uri: "file:///doc.txt",
+                                text: "Document content",
+                            },
+                        ],
+                    },
+                ],
+            ]);
+            const images = [
+                createMockStagedImage({
+                    dataUrl: "data:image/png;base64,imagedata",
+                }),
+            ];
+            const result = (0, message_builder_1.buildMessageContent)("Check @registry:file:///doc.txt", images, {}, resourceContent);
+            expect(result).toEqual([
+                {
+                    type: "text",
+                    text: "Check ",
+                },
+                {
+                    type: "resource",
+                    resource: {
+                        uri: "file:///doc.txt",
+                        text: "Document content",
+                    },
+                },
+                {
+                    type: "image_url",
+                    image_url: {
+                        url: "data:image/png;base64,imagedata",
+                    },
+                },
+            ]);
+        });
+    });
 });
 //# sourceMappingURL=message-builder.test.js.map