@tambo-ai/react 0.67.1 → 0.69.0

package/esm/util/generate-component.test.js

@@ -0,0 +1,302 @@
+import React from "react";
+import * as useCurrentMessage from "../hooks/use-current-message";
+import { renderComponentIntoMessage } from "./generate-component";
+// Track calls to wrapWithTamboMessageProvider
+let wrapWithTamboMessageProviderSpy;
+beforeEach(() => {
+    wrapWithTamboMessageProviderSpy = jest.spyOn(useCurrentMessage, "wrapWithTamboMessageProvider");
+});
+afterEach(() => {
+    wrapWithTamboMessageProviderSpy.mockRestore();
+});
+// Simple test component
+const TestComponent = ({ title, count, }) => (React.createElement("div", { "data-testid": "test-component" },
+    React.createElement("span", null, title),
+    count !== undefined && React.createElement("span", null, count)));
+// Create a mock Standard Schema for testing
+const createMockStandardSchema = (validate) => ({
+    "~standard": {
+        version: 1,
+        vendor: "test",
+        validate: (data) => ({ value: validate(data) }),
+    },
+});
+describe("renderComponentIntoMessage", () => {
+    const baseMessage = {
+        id: "msg-123",
+        threadId: "thread-456",
+        role: "assistant",
+        content: [{ type: "text", text: "Here is your component" }],
+        createdAt: "2024-01-01T00:00:00Z",
+        componentState: {},
+        component: {
+            componentName: "TestComponent",
+            props: { title: "Hello" },
+            componentState: {},
+            message: "",
+        },
+    };
+    const baseRegistry = {
+        TestComponent: {
+            name: "TestComponent",
+            description: "A test component",
+            component: TestComponent,
+            props: { type: "object" }, // JSON Schema
+            contextTools: [],
+        },
+    };
+    describe("component lookup", () => {
+        it("throws error when component has no componentName", () => {
+            const messageWithoutComponentName = {
+                ...baseMessage,
+                component: {
+                    componentName: "",
+                    props: {},
+                    componentState: {},
+                    message: "",
+                },
+            };
+            expect(() => renderComponentIntoMessage(messageWithoutComponentName, baseRegistry)).toThrow("Component not found");
+        });
+        it("throws error when component is null", () => {
+            const messageWithNullComponent = {
+                ...baseMessage,
+                component: null,
+            };
+            expect(() => renderComponentIntoMessage(messageWithNullComponent, baseRegistry)).toThrow();
+        });
+        it("throws error when componentName not in registry", () => {
+            const messageWithUnknownComponent = {
+                ...baseMessage,
+                component: {
+                    componentName: "UnknownComponent",
+                    props: {},
+                    componentState: {},
+                    message: "",
+                },
+            };
+            expect(() => renderComponentIntoMessage(messageWithUnknownComponent, baseRegistry)).toThrow("Tambo tried to use Component UnknownComponent, but it was not found");
+        });
+        it("successfully finds and renders registered component", () => {
+            const result = renderComponentIntoMessage(baseMessage, baseRegistry);
+            expect(result.component?.componentName).toBe("TestComponent");
+            expect(result.renderedComponent).toBeDefined();
+        });
+    });
+    describe("props handling", () => {
+        it("passes props to component from message", () => {
+            const messageWithProps = {
+                ...baseMessage,
+                component: {
+                    componentName: "TestComponent",
+                    props: { title: "Test Title", count: 42 },
+                    componentState: {},
+                    message: "",
+                },
+            };
+            const result = renderComponentIntoMessage(messageWithProps, baseRegistry);
+            expect(result.component?.props).toEqual({
+                title: "Test Title",
+                count: 42,
+            });
+        });
+        it("handles empty props object", () => {
+            const messageWithEmptyProps = {
+                ...baseMessage,
+                component: {
+                    componentName: "TestComponent",
+                    props: {},
+                    componentState: {},
+                    message: "",
+                },
+            };
+            const result = renderComponentIntoMessage(messageWithEmptyProps, baseRegistry);
+            expect(result.component?.props).toEqual({});
+        });
+        it("handles nested object props", () => {
+            const messageWithNestedProps = {
+                ...baseMessage,
+                component: {
+                    componentName: "TestComponent",
+                    props: {
+                        title: "Nested",
+                        config: { nested: { deeply: { value: 123 } } },
+                    },
+                    componentState: {},
+                    message: "",
+                },
+            };
+            const result = renderComponentIntoMessage(messageWithNestedProps, baseRegistry);
+            expect(result.component?.props).toEqual({
+                title: "Nested",
+                config: { nested: { deeply: { value: 123 } } },
+            });
+        });
+        it("handles array props", () => {
+            const messageWithArrayProps = {
+                ...baseMessage,
+                component: {
+                    componentName: "TestComponent",
+                    props: { title: "Array Test", items: [1, 2, 3] },
+                    componentState: {},
+                    message: "",
+                },
+            };
+            const result = renderComponentIntoMessage(messageWithArrayProps, baseRegistry);
+            expect(result.component?.props).toEqual({
+                title: "Array Test",
+                items: [1, 2, 3],
+            });
+        });
+    });
+    describe("Standard Schema validation", () => {
+        it("validates props through Standard Schema when present", () => {
+            const mockValidate = jest.fn((data) => ({
+                ...data,
+                validated: true,
+            }));
+            const registryWithStandardSchema = {
+                TestComponent: {
+                    name: "TestComponent",
+                    description: "A test component",
+                    component: TestComponent,
+                    props: createMockStandardSchema(mockValidate),
+                    contextTools: [],
+                },
+            };
+            const result = renderComponentIntoMessage(baseMessage, registryWithStandardSchema);
+            expect(mockValidate).toHaveBeenCalled();
+            // Standard Schema validate returns { value: T }, we extract the value
+            expect(result.component?.props).toEqual({
+                title: "Hello",
+                validated: true,
+            });
+        });
+        it("throws error when validation returns issues", () => {
+            const registryWithFailingSchema = {
+                TestComponent: {
+                    name: "TestComponent",
+                    description: "A test component",
+                    component: TestComponent,
+                    props: {
+                        "~standard": {
+                            version: 1,
+                            vendor: "test",
+                            validate: () => ({
+                                issues: [{ message: "title is required", path: ["title"] }],
+                            }),
+                        },
+                    },
+                    contextTools: [],
+                },
+            };
+            expect(() => renderComponentIntoMessage(baseMessage, registryWithFailingSchema)).toThrow("Component props validation failed: title is required");
+        });
+        it("throws error when validation returns async promise", () => {
+            const registryWithAsyncSchema = {
+                TestComponent: {
+                    name: "TestComponent",
+                    description: "A test component",
+                    component: TestComponent,
+                    props: {
+                        "~standard": {
+                            version: 1,
+                            vendor: "test",
+                            validate: async () => await Promise.resolve({ value: {} }),
+                        },
+                    },
+                    contextTools: [],
+                },
+            };
+            expect(() => renderComponentIntoMessage(baseMessage, registryWithAsyncSchema)).toThrow("Async schema validation is not supported for component props");
+        });
+        it("uses raw props when props is JSON Schema (not Standard Schema)", () => {
+            const jsonSchemaRegistry = {
+                TestComponent: {
+                    name: "TestComponent",
+                    description: "A test component",
+                    component: TestComponent,
+                    props: {
+                        type: "object",
+                        properties: {
+                            title: { type: "string" },
+                        },
+                    },
+                    contextTools: [],
+                },
+            };
+            const result = renderComponentIntoMessage(baseMessage, jsonSchemaRegistry);
+            // Should pass through without validation
+            expect(result.component?.props).toEqual({ title: "Hello" });
+        });
+    });
+    describe("message structure", () => {
+        it("preserves original message properties", () => {
+            const result = renderComponentIntoMessage(baseMessage, baseRegistry);
+            expect(result.id).toBe("msg-123");
+            expect(result.threadId).toBe("thread-456");
+            expect(result.role).toBe("assistant");
+            expect(result.content).toEqual([
+                { type: "text", text: "Here is your component" },
+            ]);
+            expect(result.createdAt).toBe("2024-01-01T00:00:00Z");
+        });
+        it("includes renderedComponent in result", () => {
+            const result = renderComponentIntoMessage(baseMessage, baseRegistry);
+            expect(result.renderedComponent).toBeDefined();
+            expect(React.isValidElement(result.renderedComponent)).toBe(true);
+        });
+        it("wraps component with TamboMessageProvider", () => {
+            renderComponentIntoMessage(baseMessage, baseRegistry);
+            expect(wrapWithTamboMessageProviderSpy).toHaveBeenCalled();
+            // Check that the message passed to the wrapper has the correct structure
+            const callArgs = wrapWithTamboMessageProviderSpy.mock.calls[0];
+            expect(callArgs[1].id).toBe("msg-123");
+        });
+    });
+    describe("edge cases", () => {
+        it("handles special characters in props", () => {
+            const messageWithSpecialChars = {
+                ...baseMessage,
+                component: {
+                    componentName: "TestComponent",
+                    props: { title: "Hello <script>alert('xss')</script>" },
+                    componentState: {},
+                    message: "",
+                },
+            };
+            const result = renderComponentIntoMessage(messageWithSpecialChars, baseRegistry);
+            expect(result.component?.props.title).toBe("Hello <script>alert('xss')</script>");
+        });
+        it("handles unicode in props", () => {
+            const messageWithUnicode = {
+                ...baseMessage,
+                component: {
+                    componentName: "TestComponent",
+                    props: { title: "Hello \u4e16\u754c" }, // "Hello 世界"
+                    componentState: {},
+                    message: "",
+                },
+            };
+            const result = renderComponentIntoMessage(messageWithUnicode, baseRegistry);
+            expect(result.component?.props.title).toBe("Hello \u4e16\u754c");
+        });
+        it("handles null values in props", () => {
+            const messageWithNullProp = {
+                ...baseMessage,
+                component: {
+                    componentName: "TestComponent",
+                    props: { title: "Test", nullValue: null },
+                    componentState: {},
+                    message: "",
+                },
+            };
+            const result = renderComponentIntoMessage(messageWithNullProp, baseRegistry);
+            expect(result.component?.props).toEqual({
+                title: "Test",
+                nullValue: null,
+            });
+        });
+    });
+});
+//# sourceMappingURL=generate-component.test.js.map

package/esm/util/generate-component.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-component.test.js","sourceRoot":"","sources":["../../src/util/generate-component.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport React from \"react\";\nimport { ComponentRegistry } from \"../model/component-metadata\";\nimport * as useCurrentMessage from \"../hooks/use-current-message\";\nimport { renderComponentIntoMessage } from \"./generate-component\";\n\n// Track calls to wrapWithTamboMessageProvider\nlet wrapWithTamboMessageProviderSpy: jest.SpyInstance;\n\nbeforeEach(() => {\n  wrapWithTamboMessageProviderSpy = jest.spyOn(\n    useCurrentMessage,\n    \"wrapWithTamboMessageProvider\",\n  );\n});\n\nafterEach(() => {\n  wrapWithTamboMessageProviderSpy.mockRestore();\n});\n\n// Simple test component\nconst TestComponent: React.FC<{ title: string; count?: number }> = ({\n  title,\n  count,\n}) => (\n  <div data-testid=\"test-component\">\n    <span>{title}</span>\n    {count !== undefined && <span>{count}</span>}\n  </div>\n);\n\n// Create a mock Standard Schema for testing\nconst createMockStandardSchema = (validate: (data: unknown) => unknown) => ({\n  \"~standard\": {\n    version: 1,\n    vendor: \"test\",\n    validate: (data: unknown) => ({ value: validate(data) }),\n  },\n});\n\ndescribe(\"renderComponentIntoMessage\", () => {\n  const baseMessage = {\n    id: \"msg-123\",\n    threadId: \"thread-456\",\n    role: \"assistant\",\n    content: [{ type: \"text\", text: \"Here is your component\" }],\n    createdAt: \"2024-01-01T00:00:00Z\",\n    componentState: {},\n    component: {\n      componentName: \"TestComponent\",\n      props: { title: \"Hello\" },\n      componentState: {},\n      message: \"\",\n    },\n  } as unknown as TamboAI.Beta.Threads.ThreadMessage;\n\n  const baseRegistry: ComponentRegistry = {\n    TestComponent: {\n      name: \"TestComponent\",\n      description: \"A test component\",\n      component: TestComponent,\n      props: { type: \"object\" }, // JSON Schema\n      contextTools: [],\n    },\n  };\n\n  describe(\"component lookup\", () => {\n    it(\"throws error when component has no componentName\", () => {\n      const messageWithoutComponentName = {\n        ...baseMessage,\n        component: {\n          componentName: \"\",\n          props: {},\n          componentState: {},\n          message: \"\",\n        },\n      };\n\n      expect(() =>\n        renderComponentIntoMessage(messageWithoutComponentName, baseRegistry),\n      ).toThrow(\"Component not found\");\n    });\n\n    it(\"throws error when component is null\", () => {\n      const messageWithNullComponent = {\n        ...baseMessage,\n        component: null as any,\n      };\n\n      expect(() =>\n        renderComponentIntoMessage(messageWithNullComponent, baseRegistry),\n      ).toThrow();\n    });\n\n    it(\"throws error when componentName not in registry\", () => {\n      const messageWithUnknownComponent = {\n        ...baseMessage,\n        component: {\n          componentName: \"UnknownComponent\",\n          props: {},\n          componentState: {},\n          message: \"\",\n        },\n      };\n\n      expect(() =>\n        renderComponentIntoMessage(messageWithUnknownComponent, baseRegistry),\n      ).toThrow(\n        \"Tambo tried to use Component UnknownComponent, but it was not found\",\n      );\n    });\n\n    it(\"successfully finds and renders registered component\", () => {\n      const result = renderComponentIntoMessage(baseMessage, baseRegistry);\n\n      expect(result.component?.componentName).toBe(\"TestComponent\");\n      expect(result.renderedComponent).toBeDefined();\n    });\n  });\n\n  describe(\"props handling\", () => {\n    it(\"passes props to component from message\", () => {\n      const messageWithProps = {\n        ...baseMessage,\n        component: {\n          componentName: \"TestComponent\",\n          props: { title: \"Test Title\", count: 42 },\n          componentState: {},\n          message: \"\",\n        },\n      };\n\n      const result = renderComponentIntoMessage(messageWithProps, baseRegistry);\n\n      expect(result.component?.props).toEqual({\n        title: \"Test Title\",\n        count: 42,\n      });\n    });\n\n    it(\"handles empty props object\", () => {\n      const messageWithEmptyProps = {\n        ...baseMessage,\n        component: {\n          componentName: \"TestComponent\",\n          props: {},\n          componentState: {},\n          message: \"\",\n        },\n      };\n\n      const result = renderComponentIntoMessage(\n        messageWithEmptyProps,\n        baseRegistry,\n      );\n\n      expect(result.component?.props).toEqual({});\n    });\n\n    it(\"handles nested object props\", () => {\n      const messageWithNestedProps = {\n        ...baseMessage,\n        component: {\n          componentName: \"TestComponent\",\n          props: {\n            title: \"Nested\",\n            config: { nested: { deeply: { value: 123 } } },\n          },\n          componentState: {},\n          message: \"\",\n        },\n      };\n\n      const result = renderComponentIntoMessage(\n        messageWithNestedProps,\n        baseRegistry,\n      );\n\n      expect(result.component?.props).toEqual({\n        title: \"Nested\",\n        config: { nested: { deeply: { value: 123 } } },\n      });\n    });\n\n    it(\"handles array props\", () => {\n      const messageWithArrayProps = {\n        ...baseMessage,\n        component: {\n          componentName: \"TestComponent\",\n          props: { title: \"Array Test\", items: [1, 2, 3] },\n          componentState: {},\n          message: \"\",\n        },\n      };\n\n      const result = renderComponentIntoMessage(\n        messageWithArrayProps,\n        baseRegistry,\n      );\n\n      expect(result.component?.props).toEqual({\n        title: \"Array Test\",\n        items: [1, 2, 3],\n      });\n    });\n  });\n\n  describe(\"Standard Schema validation\", () => {\n    it(\"validates props through Standard Schema when present\", () => {\n      const mockValidate = jest.fn((data) => ({\n        ...data,\n        validated: true,\n      }));\n\n      const registryWithStandardSchema: ComponentRegistry = {\n        TestComponent: {\n          name: \"TestComponent\",\n          description: \"A test component\",\n          component: TestComponent,\n          props: createMockStandardSchema(mockValidate),\n          contextTools: [],\n        },\n      };\n\n      const result = renderComponentIntoMessage(\n        baseMessage,\n        registryWithStandardSchema,\n      );\n\n      expect(mockValidate).toHaveBeenCalled();\n      // Standard Schema validate returns { value: T }, we extract the value\n      expect(result.component?.props).toEqual({\n        title: \"Hello\",\n        validated: true,\n      });\n    });\n\n    it(\"throws error when validation returns issues\", () => {\n      const registryWithFailingSchema: ComponentRegistry = {\n        TestComponent: {\n          name: \"TestComponent\",\n          description: \"A test component\",\n          component: TestComponent,\n          props: {\n            \"~standard\": {\n              version: 1,\n              vendor: \"test\",\n              validate: () => ({\n                issues: [{ message: \"title is required\", path: [\"title\"] }],\n              }),\n            },\n          },\n          contextTools: [],\n        },\n      };\n\n      expect(() =>\n        renderComponentIntoMessage(baseMessage, registryWithFailingSchema),\n      ).toThrow(\"Component props validation failed: title is required\");\n    });\n\n    it(\"throws error when validation returns async promise\", () => {\n      const registryWithAsyncSchema: ComponentRegistry = {\n        TestComponent: {\n          name: \"TestComponent\",\n          description: \"A test component\",\n          component: TestComponent,\n          props: {\n            \"~standard\": {\n              version: 1,\n              vendor: \"test\",\n              validate: async () => await Promise.resolve({ value: {} }),\n            },\n          },\n          contextTools: [],\n        },\n      };\n\n      expect(() =>\n        renderComponentIntoMessage(baseMessage, registryWithAsyncSchema),\n      ).toThrow(\"Async schema validation is not supported for component props\");\n    });\n\n    it(\"uses raw props when props is JSON Schema (not Standard Schema)\", () => {\n      const jsonSchemaRegistry: ComponentRegistry = {\n        TestComponent: {\n          name: \"TestComponent\",\n          description: \"A test component\",\n          component: TestComponent,\n          props: {\n            type: \"object\",\n            properties: {\n              title: { type: \"string\" },\n            },\n          },\n          contextTools: [],\n        },\n      };\n\n      const result = renderComponentIntoMessage(\n        baseMessage,\n        jsonSchemaRegistry,\n      );\n\n      // Should pass through without validation\n      expect(result.component?.props).toEqual({ title: \"Hello\" });\n    });\n  });\n\n  describe(\"message structure\", () => {\n    it(\"preserves original message properties\", () => {\n      const result = renderComponentIntoMessage(baseMessage, baseRegistry);\n\n      expect(result.id).toBe(\"msg-123\");\n      expect(result.threadId).toBe(\"thread-456\");\n      expect(result.role).toBe(\"assistant\");\n      expect(result.content).toEqual([\n        { type: \"text\", text: \"Here is your component\" },\n      ]);\n      expect(result.createdAt).toBe(\"2024-01-01T00:00:00Z\");\n    });\n\n    it(\"includes renderedComponent in result\", () => {\n      const result = renderComponentIntoMessage(baseMessage, baseRegistry);\n\n      expect(result.renderedComponent).toBeDefined();\n      expect(React.isValidElement(result.renderedComponent)).toBe(true);\n    });\n\n    it(\"wraps component with TamboMessageProvider\", () => {\n      renderComponentIntoMessage(baseMessage, baseRegistry);\n\n      expect(wrapWithTamboMessageProviderSpy).toHaveBeenCalled();\n      // Check that the message passed to the wrapper has the correct structure\n      const callArgs = wrapWithTamboMessageProviderSpy.mock.calls[0];\n      expect(callArgs[1].id).toBe(\"msg-123\");\n    });\n  });\n\n  describe(\"edge cases\", () => {\n    it(\"handles special characters in props\", () => {\n      const messageWithSpecialChars = {\n        ...baseMessage,\n        component: {\n          componentName: \"TestComponent\",\n          props: { title: \"Hello <script>alert('xss')</script>\" },\n          componentState: {},\n          message: \"\",\n        },\n      };\n\n      const result = renderComponentIntoMessage(\n        messageWithSpecialChars,\n        baseRegistry,\n      );\n\n      expect(result.component?.props.title).toBe(\n        \"Hello <script>alert('xss')</script>\",\n      );\n    });\n\n    it(\"handles unicode in props\", () => {\n      const messageWithUnicode = {\n        ...baseMessage,\n        component: {\n          componentName: \"TestComponent\",\n          props: { title: \"Hello \\u4e16\\u754c\" }, // \"Hello 世界\"\n          componentState: {},\n          message: \"\",\n        },\n      };\n\n      const result = renderComponentIntoMessage(\n        messageWithUnicode,\n        baseRegistry,\n      );\n\n      expect(result.component?.props.title).toBe(\"Hello \\u4e16\\u754c\");\n    });\n\n    it(\"handles null values in props\", () => {\n      const messageWithNullProp = {\n        ...baseMessage,\n        component: {\n          componentName: \"TestComponent\",\n          props: { title: \"Test\", nullValue: null },\n          componentState: {},\n          message: \"\",\n        },\n      };\n\n      const result = renderComponentIntoMessage(\n        messageWithNullProp,\n        baseRegistry,\n      );\n\n      expect(result.component?.props).toEqual({\n        title: \"Test\",\n        nullValue: null,\n      });\n    });\n  });\n});\n"]}

package/esm/util/is-promise.d.ts

@@ -0,0 +1,9 @@
+/**
+ *
+ */
+/**
+ * Checks whether a value is a Promise/thenable.
+ * @returns True if the value has a callable `then()` function.
+ */
+export declare function isPromise(value: unknown): value is Promise<unknown>;
+//# sourceMappingURL=is-promise.d.ts.map

package/esm/util/is-promise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-promise.d.ts","sourceRoot":"","sources":["../../src/util/is-promise.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAUnE"}

package/esm/util/is-promise.js

@@ -0,0 +1,17 @@
+/**
+ *
+ */
+/**
+ * Checks whether a value is a Promise/thenable.
+ * @returns True if the value has a callable `then()` function.
+ */
+export function isPromise(value) {
+    if (value === null) {
+        return false;
+    }
+    if (typeof value !== "object" && typeof value !== "function") {
+        return false;
+    }
+    return typeof value.then === "function";
+}
+//# sourceMappingURL=is-promise.js.map

package/esm/util/is-promise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-promise.js","sourceRoot":"","sources":["../../src/util/is-promise.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAC7D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,OAAQ,KAAqC,CAAC,IAAI,KAAK,UAAU,CAAC;AAC3E,CAAC","sourcesContent":["/**\n *\n */\n/**\n * Checks whether a value is a Promise/thenable.\n * @returns True if the value has a callable `then()` function.\n */\nexport function isPromise(value: unknown): value is Promise<unknown> {\n  if (value === null) {\n    return false;\n  }\n\n  if (typeof value !== \"object\" && typeof value !== \"function\") {\n    return false;\n  }\n\n  return typeof (value as { readonly then?: unknown }).then === \"function\";\n}\n"]}

package/esm/util/is-promise.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=is-promise.test.d.ts.map

package/esm/util/is-promise.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-promise.test.d.ts","sourceRoot":"","sources":["../../src/util/is-promise.test.ts"],"names":[],"mappings":""}

package/esm/util/is-promise.test.js

@@ -0,0 +1,46 @@
+import { isPromise } from "../util/is-promise";
+describe("isPromise", () => {
+    it("should return true for real Promise instances", () => {
+        expect(isPromise(Promise.resolve(1))).toBe(true);
+        expect(isPromise(new Promise(() => { }))).toBe(true);
+    });
+    it("should return true for custom thenables", () => {
+        const thenable = {
+            then: () => { },
+        };
+        expect(isPromise(thenable)).toBe(true);
+    });
+    it("should return true for function with a then method", () => {
+        const fn = () => { };
+        fn.then = () => { };
+        expect(isPromise(fn)).toBe(true);
+    });
+    it("should return false for null", () => {
+        expect(isPromise(null)).toBe(false);
+    });
+    it("should return false for primitive values", () => {
+        expect(isPromise(0)).toBe(false);
+        expect(isPromise("text")).toBe(false);
+        expect(isPromise(true)).toBe(false);
+        expect(isPromise(undefined)).toBe(false);
+        expect(isPromise(Symbol("sym"))).toBe(false);
+        expect(isPromise(10n)).toBe(false);
+    });
+    it("should return false for object without then method", () => {
+        expect(isPromise({})).toBe(false);
+        expect(isPromise({ status: "active" })).toBe(false);
+    });
+    it("should return false when then exists but is not a function", () => {
+        expect(isPromise({ then: 123 })).toBe(false);
+        expect(isPromise({ then: "not-a-function" })).toBe(false);
+    });
+    it("should handle Promise-like object created via Promise.resolve", () => {
+        const value = Promise.resolve("ok");
+        expect(isPromise(value)).toBe(true);
+    });
+    it("should not throw for unexpected input types", () => {
+        expect(() => isPromise(Object.create(null))).not.toThrow();
+        expect(isPromise(Object.create(null))).toBe(false);
+    });
+});
+//# sourceMappingURL=is-promise.test.js.map

package/esm/util/is-promise.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-promise.test.js","sourceRoot":"","sources":["../../src/util/is-promise.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { isPromise } from \"../util/is-promise\";\n\ndescribe(\"isPromise\", () => {\n  it(\"should return true for real Promise instances\", () => {\n    expect(isPromise(Promise.resolve(1))).toBe(true);\n    expect(isPromise(new Promise(() => {}))).toBe(true);\n  });\n\n  it(\"should return true for custom thenables\", () => {\n    const thenable = {\n      then: () => {},\n    };\n\n    expect(isPromise(thenable)).toBe(true);\n  });\n\n  it(\"should return true for function with a then method\", () => {\n    const fn = () => {};\n    fn.then = () => {};\n\n    expect(isPromise(fn)).toBe(true);\n  });\n\n  it(\"should return false for null\", () => {\n    expect(isPromise(null)).toBe(false);\n  });\n\n  it(\"should return false for primitive values\", () => {\n    expect(isPromise(0)).toBe(false);\n    expect(isPromise(\"text\")).toBe(false);\n    expect(isPromise(true)).toBe(false);\n    expect(isPromise(undefined)).toBe(false);\n    expect(isPromise(Symbol(\"sym\"))).toBe(false);\n    expect(isPromise(10n)).toBe(false);\n  });\n\n  it(\"should return false for object without then method\", () => {\n    expect(isPromise({})).toBe(false);\n    expect(isPromise({ status: \"active\" })).toBe(false);\n  });\n\n  it(\"should return false when then exists but is not a function\", () => {\n    expect(isPromise({ then: 123 })).toBe(false);\n    expect(isPromise({ then: \"not-a-function\" })).toBe(false);\n  });\n\n  it(\"should handle Promise-like object created via Promise.resolve\", () => {\n    const value = Promise.resolve(\"ok\");\n    expect(isPromise(value)).toBe(true);\n  });\n\n  it(\"should not throw for unexpected input types\", () => {\n    expect(() => isPromise(Object.create(null))).not.toThrow();\n    expect(isPromise(Object.create(null))).toBe(false);\n  });\n});\n"]}

package/esm/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/esm/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/esm/util/message-builder.js

@@ -22,9 +22,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));
@@ -48,6 +49,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;
@@ -74,16 +90,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
  */
-export function buildMessageContent(text, images, resourceNames = {}) {
+export 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/esm/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"]}