@tambo-ai/react 0.70.0 → 0.72.0

package/dist/v1/types/event.test.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@ag-ui/core");
+const event_1 = require("./event");
+describe("isTamboCustomEvent", () => {
+    it("returns true for tambo.component.start event", () => {
+        const event = {
+            type: core_1.EventType.CUSTOM,
+            name: "tambo.component.start",
+            value: { messageId: "msg1", componentId: "comp1", componentName: "Test" },
+        };
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+    });
+    it("returns true for tambo.component.props_delta event", () => {
+        const event = {
+            type: core_1.EventType.CUSTOM,
+            name: "tambo.component.props_delta",
+            value: { componentId: "comp1", operations: [] },
+        };
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+    });
+    it("returns true for tambo.component.state_delta event", () => {
+        const event = {
+            type: core_1.EventType.CUSTOM,
+            name: "tambo.component.state_delta",
+            value: { componentId: "comp1", operations: [] },
+        };
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+    });
+    it("returns true for tambo.component.end event", () => {
+        const event = {
+            type: core_1.EventType.CUSTOM,
+            name: "tambo.component.end",
+            value: { componentId: "comp1" },
+        };
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+    });
+    it("returns true for tambo.run.awaiting_input event", () => {
+        const event = {
+            type: core_1.EventType.CUSTOM,
+            name: "tambo.run.awaiting_input",
+            value: { pendingToolCallIds: ["tool1"] },
+        };
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+    });
+    it("returns false for unknown custom event name", () => {
+        const event = {
+            type: core_1.EventType.CUSTOM,
+            name: "unknown.event",
+            value: {},
+        };
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(false);
+    });
+    it("returns false when name is undefined", () => {
+        const event = {};
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(false);
+    });
+    it("returns false when name is not a string", () => {
+        const event = {
+            type: core_1.EventType.CUSTOM,
+            name: 123,
+            value: {},
+        };
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(false);
+    });
+    it("returns false for empty object", () => {
+        expect((0, event_1.isTamboCustomEvent)({})).toBe(false);
+    });
+});
+//# sourceMappingURL=event.test.js.map

package/dist/v1/types/event.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.test.js","sourceRoot":"","sources":["../../../src/v1/types/event.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventType } from \"@ag-ui/core\";\nimport { isTamboCustomEvent } from \"./event\";\n\ndescribe(\"isTamboCustomEvent\", () => {\n  it(\"returns true for tambo.component.start event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.start\",\n      value: { messageId: \"msg1\", componentId: \"comp1\", componentName: \"Test\" },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.component.props_delta event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.props_delta\",\n      value: { componentId: \"comp1\", operations: [] },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.component.state_delta event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.state_delta\",\n      value: { componentId: \"comp1\", operations: [] },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.component.end event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.end\",\n      value: { componentId: \"comp1\" },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.run.awaiting_input event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.run.awaiting_input\",\n      value: { pendingToolCallIds: [\"tool1\"] },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns false for unknown custom event name\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"unknown.event\",\n      value: {},\n    };\n    expect(isTamboCustomEvent(event)).toBe(false);\n  });\n\n  it(\"returns false when name is undefined\", () => {\n    const event: { name?: string } = {};\n    expect(isTamboCustomEvent(event)).toBe(false);\n  });\n\n  it(\"returns false when name is not a string\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: 123,\n      value: {},\n    };\n    expect(isTamboCustomEvent(event as unknown as { name?: string })).toBe(\n      false,\n    );\n  });\n\n  it(\"returns false for empty object\", () => {\n    expect(isTamboCustomEvent({})).toBe(false);\n  });\n});\n"]}

package/dist/v1/types/message.d.ts

@@ -1,26 +1,47 @@
 /**
  * Message and Content Types for v1 API
  *
- * Re-exports message and content types from @tambo-ai/typescript-sdk.
+ * Re-exports message and content types from `@tambo-ai/typescript-sdk`.
  * Messages use Anthropic-style content blocks pattern where a message
  * contains an array of content blocks (text, tool calls, tool results, components).
  */
-import type { TextContent as SDKTextContent, ToolUseContent as SDKToolUseContent, ToolResultContent as SDKToolResultContent, ComponentContent as SDKComponentContent, ResourceContent as SDKResourceContent } from "@tambo-ai/typescript-sdk/resources/threads/threads";
-export type TextContent = SDKTextContent;
-export type ToolUseContent = SDKToolUseContent;
-export type ToolResultContent = SDKToolResultContent;
-export type ComponentContent = SDKComponentContent;
-export type ResourceContent = SDKResourceContent;
+import type { ReactElement } from "react";
+export type { TextContent, ToolUseContent, ToolResultContent, ComponentContent, ResourceContent, } from "@tambo-ai/typescript-sdk/resources/threads/threads";
 export type { InputMessage } from "@tambo-ai/typescript-sdk/resources/threads/runs";
 export type { MessageListResponse, MessageGetResponse, } from "@tambo-ai/typescript-sdk/resources/threads/messages";
+import type { TextContent, ToolUseContent, ToolResultContent, ComponentContent, ResourceContent } from "@tambo-ai/typescript-sdk/resources/threads/threads";
+/**
+ * Streaming state for component content blocks.
+ * Tracks the lifecycle of component prop/state streaming.
+ */
+export type ComponentStreamingState = "started" | "streaming" | "done";
+/**
+ * Extended ComponentContent with streaming state and rendered element.
+ * Used by the v1 SDK to track component rendering lifecycle.
+ */
+export interface V1ComponentContent extends ComponentContent {
+    /**
+     * Current streaming state of this component's props.
+     * - 'started': Component block created, awaiting props
+     * - 'streaming': Props are being streamed
+     * - 'done': Props streaming complete
+     */
+    streamingState: ComponentStreamingState;
+    /**
+     * The rendered React element for this component.
+     * undefined if not yet rendered, null if the component couldn't be found in the registry.
+     */
+    renderedComponent?: ReactElement | null;
+}
 /**
  * Message role (from SDK)
  */
 export type MessageRole = "user" | "assistant";
 /**
- * Union type of all content block types
+ * Union type of all content block types.
+ * Uses V1ComponentContent which includes streaming state and rendered component.
  */
-export type Content = SDKTextContent | SDKToolUseContent | SDKToolResultContent | SDKComponentContent | SDKResourceContent;
+export type Content = TextContent | ToolUseContent | ToolResultContent | V1ComponentContent | ResourceContent;
 /**
  * Message in a thread (simplified from SDK's MessageGetResponse)
  */

package/dist/v1/types/message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/v1/types/message.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,WAAW,IAAI,cAAc,EAC7B,cAAc,IAAI,iBAAiB,EACnC,iBAAiB,IAAI,oBAAoB,EACzC,gBAAgB,IAAI,mBAAmB,EACvC,eAAe,IAAI,kBAAkB,EACtC,MAAM,oDAAoD,CAAC;AAE5D,MAAM,MAAM,WAAW,GAAG,cAAc,CAAC;AACzC,MAAM,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAC/C,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AACrD,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAGjD,YAAY,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAEpF,YAAY,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qDAAqD,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,OAAO,GACf,cAAc,GACd,iBAAiB,GACjB,oBAAoB,GACpB,mBAAmB,GACnB,kBAAkB,CAAC;AAEvB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IAEX,uCAAuC;IACvC,IAAI,EAAE,WAAW,CAAC;IAElB,oCAAoC;IACpC,OAAO,EAAE,OAAO,EAAE,CAAC;IAEnB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAElB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/v1/types/message.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,YAAY,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,oDAAoD,CAAC;AAG5D,YAAY,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAEpF,YAAY,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qDAAqD,CAAC;AAG7D,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,oDAAoD,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D;;;;;OAKG;IACH,cAAc,EAAE,uBAAuB,CAAC;IAExC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,OAAO,GACf,WAAW,GACX,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IAEX,uCAAuC;IACvC,IAAI,EAAE,WAAW,CAAC;IAElB,oCAAoC;IACpC,OAAO,EAAE,OAAO,EAAE,CAAC;IAEnB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAElB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/v1/types/message.js

@@ -2,7 +2,7 @@
 /**
  * Message and Content Types for v1 API
  *
- * Re-exports message and content types from @tambo-ai/typescript-sdk.
+ * Re-exports message and content types from `@tambo-ai/typescript-sdk`.
  * Messages use Anthropic-style content blocks pattern where a message
  * contains an array of content blocks (text, tool calls, tool results, components).
  */

package/dist/v1/types/message.js.map

@@ -1 +1 @@
-{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/v1/types/message.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG","sourcesContent":["/**\n * Message and Content Types for v1 API\n *\n * Re-exports message and content types from @tambo-ai/typescript-sdk.\n * Messages use Anthropic-style content blocks pattern where a message\n * contains an array of content blocks (text, tool calls, tool results, components).\n */\n\n// Import and re-export content block types from TypeScript SDK\nimport type {\n  TextContent as SDKTextContent,\n  ToolUseContent as SDKToolUseContent,\n  ToolResultContent as SDKToolResultContent,\n  ComponentContent as SDKComponentContent,\n  ResourceContent as SDKResourceContent,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\nexport type TextContent = SDKTextContent;\nexport type ToolUseContent = SDKToolUseContent;\nexport type ToolResultContent = SDKToolResultContent;\nexport type ComponentContent = SDKComponentContent;\nexport type ResourceContent = SDKResourceContent;\n\n// Re-export message types from TypeScript SDK\nexport type { InputMessage } from \"@tambo-ai/typescript-sdk/resources/threads/runs\";\n\nexport type {\n  MessageListResponse,\n  MessageGetResponse,\n} from \"@tambo-ai/typescript-sdk/resources/threads/messages\";\n\n/**\n * Message role (from SDK)\n */\nexport type MessageRole = \"user\" | \"assistant\";\n\n/**\n * Union type of all content block types\n */\nexport type Content =\n  | SDKTextContent\n  | SDKToolUseContent\n  | SDKToolResultContent\n  | SDKComponentContent\n  | SDKResourceContent;\n\n/**\n * Message in a thread (simplified from SDK's MessageGetResponse)\n */\nexport interface TamboV1Message {\n  /** Unique message identifier */\n  id: string;\n\n  /** Message role (user or assistant) */\n  role: MessageRole;\n\n  /** Content blocks in the message */\n  content: Content[];\n\n  /** When the message was created */\n  createdAt: string;\n\n  /** Message metadata */\n  metadata?: Record<string, unknown>;\n}\n"]}
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/v1/types/message.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG","sourcesContent":["/**\n * Message and Content Types for v1 API\n *\n * Re-exports message and content types from `@tambo-ai/typescript-sdk`.\n * Messages use Anthropic-style content blocks pattern where a message\n * contains an array of content blocks (text, tool calls, tool results, components).\n */\n\nimport type { ReactElement } from \"react\";\n\n// Re-export content block types from TypeScript SDK\nexport type {\n  TextContent,\n  ToolUseContent,\n  ToolResultContent,\n  ComponentContent,\n  ResourceContent,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\n// Re-export message types from TypeScript SDK\nexport type { InputMessage } from \"@tambo-ai/typescript-sdk/resources/threads/runs\";\n\nexport type {\n  MessageListResponse,\n  MessageGetResponse,\n} from \"@tambo-ai/typescript-sdk/resources/threads/messages\";\n\n// Import for Content union type\nimport type {\n  TextContent,\n  ToolUseContent,\n  ToolResultContent,\n  ComponentContent,\n  ResourceContent,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\n/**\n * Streaming state for component content blocks.\n * Tracks the lifecycle of component prop/state streaming.\n */\nexport type ComponentStreamingState = \"started\" | \"streaming\" | \"done\";\n\n/**\n * Extended ComponentContent with streaming state and rendered element.\n * Used by the v1 SDK to track component rendering lifecycle.\n */\nexport interface V1ComponentContent extends ComponentContent {\n  /**\n   * Current streaming state of this component's props.\n   * - 'started': Component block created, awaiting props\n   * - 'streaming': Props are being streamed\n   * - 'done': Props streaming complete\n   */\n  streamingState: ComponentStreamingState;\n\n  /**\n   * The rendered React element for this component.\n   * undefined if not yet rendered, null if the component couldn't be found in the registry.\n   */\n  renderedComponent?: ReactElement | null;\n}\n\n/**\n * Message role (from SDK)\n */\nexport type MessageRole = \"user\" | \"assistant\";\n\n/**\n * Union type of all content block types.\n * Uses V1ComponentContent which includes streaming state and rendered component.\n */\nexport type Content =\n  | TextContent\n  | ToolUseContent\n  | ToolResultContent\n  | V1ComponentContent\n  | ResourceContent;\n\n/**\n * Message in a thread (simplified from SDK's MessageGetResponse)\n */\nexport interface TamboV1Message {\n  /** Unique message identifier */\n  id: string;\n\n  /** Message role (user or assistant) */\n  role: MessageRole;\n\n  /** Content blocks in the message */\n  content: Content[];\n\n  /** When the message was created */\n  createdAt: string;\n\n  /** Message metadata */\n  metadata?: Record<string, unknown>;\n}\n"]}

package/dist/v1/types/thread.d.ts

@@ -1,7 +1,7 @@
 /**
  * Thread Types for v1 API
  *
- * Re-exports thread types from @tambo-ai/typescript-sdk and defines
+ * Re-exports thread types from `@tambo-ai/typescript-sdk` and defines
  * React-specific extensions for streaming state management.
  */
 import type { TamboV1Message } from "./message";
@@ -19,8 +19,6 @@ export interface TamboV1Thread {
     id: string;
     /** Thread title/name */
     title?: string;
-    /** Project ID this thread belongs to */
-    projectId: string;
     /** Messages in the thread */
     messages: TamboV1Message[];
     /** Current run status */

package/dist/v1/types/thread.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../../src/v1/types/thread.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oDAAoD,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAElB,6BAA6B;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAE3B,yBAAyB;IACzB,MAAM,EAAE,SAAS,CAAC;IAElB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAElB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,MAAM,EAAE,SAAS,CAAC;IAElB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../../src/v1/types/thread.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oDAAoD,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAE3B,yBAAyB;IACzB,MAAM,EAAE,SAAS,CAAC;IAElB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAElB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,MAAM,EAAE,SAAS,CAAC;IAElB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}

package/dist/v1/types/thread.js

@@ -2,7 +2,7 @@
 /**
  * Thread Types for v1 API
  *
- * Re-exports thread types from @tambo-ai/typescript-sdk and defines
+ * Re-exports thread types from `@tambo-ai/typescript-sdk` and defines
  * React-specific extensions for streaming state management.
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/v1/types/thread.js.map

@@ -1 +1 @@
-{"version":3,"file":"thread.js","sourceRoot":"","sources":["../../../src/v1/types/thread.ts"],"names":[],"mappings":";AAAA;;;;;GAKG","sourcesContent":["/**\n * Thread Types for v1 API\n *\n * Re-exports thread types from @tambo-ai/typescript-sdk and defines\n * React-specific extensions for streaming state management.\n */\n\nimport type { TamboV1Message } from \"./message\";\n\n// Re-export thread types from TypeScript SDK\nexport type {\n  ThreadCreateResponse,\n  ThreadRetrieveResponse,\n  ThreadListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\n/**\n * Run status indicates the current state of the thread\n */\nexport type RunStatus = \"idle\" | \"waiting\" | \"streaming\" | \"complete\" | \"error\";\n\n/**\n * Thread represents a conversation with the AI\n * Extended from SDK's ThreadRetrieveResponse with additional fields for React state\n */\nexport interface TamboV1Thread {\n  /** Unique thread identifier */\n  id: string;\n\n  /** Thread title/name */\n  title?: string;\n\n  /** Project ID this thread belongs to */\n  projectId: string;\n\n  /** Messages in the thread */\n  messages: TamboV1Message[];\n\n  /** Current run status */\n  status: RunStatus;\n\n  /** Thread metadata */\n  metadata?: Record<string, unknown>;\n\n  /** When the thread was created */\n  createdAt: string;\n\n  /** When the thread was last updated */\n  updatedAt: string;\n}\n\n/**\n * Streaming state tracks the progress of an active run\n * This is React-specific and not part of the SDK\n */\nexport interface StreamingState {\n  /** Current streaming status */\n  status: RunStatus;\n\n  /** Active run ID (if streaming) */\n  runId?: string;\n\n  /** Active message ID being streamed */\n  messageId?: string;\n\n  /** When the current run started */\n  startTime?: number;\n\n  /** Error information if status is 'error' */\n  error?: {\n    message: string;\n    code?: string;\n  };\n}\n"]}
+{"version":3,"file":"thread.js","sourceRoot":"","sources":["../../../src/v1/types/thread.ts"],"names":[],"mappings":";AAAA;;;;;GAKG","sourcesContent":["/**\n * Thread Types for v1 API\n *\n * Re-exports thread types from `@tambo-ai/typescript-sdk` and defines\n * React-specific extensions for streaming state management.\n */\n\nimport type { TamboV1Message } from \"./message\";\n\n// Re-export thread types from TypeScript SDK\nexport type {\n  ThreadCreateResponse,\n  ThreadRetrieveResponse,\n  ThreadListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\n/**\n * Run status indicates the current state of the thread\n */\nexport type RunStatus = \"idle\" | \"waiting\" | \"streaming\" | \"complete\" | \"error\";\n\n/**\n * Thread represents a conversation with the AI\n * Extended from SDK's ThreadRetrieveResponse with additional fields for React state\n */\nexport interface TamboV1Thread {\n  /** Unique thread identifier */\n  id: string;\n\n  /** Thread title/name */\n  title?: string;\n\n  /** Messages in the thread */\n  messages: TamboV1Message[];\n\n  /** Current run status */\n  status: RunStatus;\n\n  /** Thread metadata */\n  metadata?: Record<string, unknown>;\n\n  /** When the thread was created */\n  createdAt: string;\n\n  /** When the thread was last updated */\n  updatedAt: string;\n}\n\n/**\n * Streaming state tracks the progress of an active run\n * This is React-specific and not part of the SDK\n */\nexport interface StreamingState {\n  /** Current streaming status */\n  status: RunStatus;\n\n  /** Active run ID (if streaming) */\n  runId?: string;\n\n  /** Active message ID being streamed */\n  messageId?: string;\n\n  /** When the current run started */\n  startTime?: number;\n\n  /** Error information if status is 'error' */\n  error?: {\n    message: string;\n    code?: string;\n  };\n}\n"]}

package/dist/v1/utils/component-renderer.d.ts

@@ -0,0 +1,89 @@
+import type { ComponentRegistry } from "../../model/component-metadata";
+import type { Content, TamboV1Message, V1ComponentContent } from "../types/message";
+/**
+ * Context for component content blocks.
+ * Provides access to the component ID and thread ID for component state hooks.
+ */
+export interface V1ComponentContentContext {
+    /** Component instance ID */
+    componentId: string;
+    /** Thread ID the component belongs to */
+    threadId: string;
+    /** Message ID the component belongs to */
+    messageId: string;
+    /** Component name */
+    componentName: string;
+}
+/**
+ * Hook to access the current component content context.
+ * Must be used within a rendered component.
+ * @returns Component content context
+ * @throws {Error} If used outside a rendered component
+ */
+export declare function useV1ComponentContent(): V1ComponentContentContext;
+/**
+ * Hook to optionally access the current component content context.
+ * Returns null if not within a rendered component.
+ * @returns Component content context or null
+ */
+export declare function useV1ComponentContentOptional(): V1ComponentContentContext | null;
+/**
+ * Options for rendering a component content block.
+ */
+export interface RenderComponentOptions {
+    /** Thread ID for the component context */
+    threadId: string;
+    /** Message ID the component belongs to */
+    messageId: string;
+    /** Component registry to look up components */
+    componentList: ComponentRegistry;
+}
+/**
+ * Check if a content block is a component.
+ * @param content - Content block to check
+ * @returns True if content is a V1ComponentContent
+ */
+export declare function isComponentContent(content: Content): content is V1ComponentContent;
+/**
+ * Render a component content block into a React element.
+ *
+ * Looks up the component in the registry, creates a React element with props,
+ * and wraps it with the component content context provider.
+ * @param content - Component content block to render
+ * @param options - Rendering options including registry and context info
+ * @returns V1ComponentContent with the renderedComponent attached
+ * @example
+ * ```tsx
+ * const rendered = renderComponentContent(componentContent, {
+ *   threadId: 'thread_123',
+ *   messageId: 'msg_456',
+ *   componentList: registry.componentList,
+ * });
+ *
+ * // Use in JSX:
+ * {rendered.renderedComponent}
+ * ```
+ */
+export declare function renderComponentContent(content: V1ComponentContent, options: RenderComponentOptions): V1ComponentContent;
+/**
+ * Render all component content blocks in a message.
+ *
+ * Renders component content blocks and attaches renderedComponent.
+ * Non-component content blocks are passed through unchanged.
+ * @param content - Array of content blocks
+ * @param options - Rendering options including registry and context info
+ * @returns Array of content with rendered components
+ */
+export declare function renderMessageContent(content: Content[], options: RenderComponentOptions): Content[];
+/**
+ * Render all components in a message.
+ *
+ * Creates a new message object with all component content blocks rendered.
+ * @param message - Message to render components for
+ * @param options - Rendering options (threadId is extracted from message if not provided)
+ * @returns Message with rendered component content
+ */
+export declare function renderMessageComponents(message: TamboV1Message, options: Omit<RenderComponentOptions, "messageId"> & {
+    threadId: string;
+}): TamboV1Message;
+//# sourceMappingURL=component-renderer.d.ts.map

package/dist/v1/utils/component-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-renderer.d.ts","sourceRoot":"","sources":["../../../src/v1/utils/component-renderer.tsx"],"names":[],"mappings":"AAuDA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AA+BD;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,yBAAyB,CAQjE;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,yBAAyB,GAAG,IAAI,CAEhF;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,aAAa,EAAE,iBAAiB,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,GACf,OAAO,IAAI,kBAAkB,CAE/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,sBAAsB,GAC9B,kBAAkB,CAwDpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAAE,EAClB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,EAAE,CAQX;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,WAAW,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxE,cAAc,CAUhB"}

package/dist/v1/utils/component-renderer.js

@@ -0,0 +1,216 @@
+"use strict";
+"use client";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useV1ComponentContent = useV1ComponentContent;
+exports.useV1ComponentContentOptional = useV1ComponentContentOptional;
+exports.isComponentContent = isComponentContent;
+exports.renderComponentContent = renderComponentContent;
+exports.renderMessageContent = renderMessageContent;
+exports.renderMessageComponents = renderMessageComponents;
+/**
+ * Component Renderer Utility for v1 API
+ *
+ * Provides utilities for rendering React components from component content blocks.
+ * Components are looked up in the registry and wrapped with context providers.
+ */
+const react_1 = __importStar(require("react"));
+/**
+ * Props that should be filtered out when rendering components.
+ * These could be used for event handler injection or other security concerns.
+ */
+const DANGEROUS_PROP_PATTERNS = [
+    /^on[A-Z]/, // Event handlers (onClick, onError, etc.)
+    /^dangerouslySetInnerHTML$/,
+];
+const DANGEROUS_PROP_NAMES = new Set(["ref", "key", "children"]);
+/**
+ * Sanitize props by removing potentially dangerous properties.
+ * Filters out event handlers, refs, and other props that could be abused.
+ * @param props - Raw props from the component content
+ * @returns Sanitized props safe for spreading to components
+ */
+function sanitizeProps(props) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(props)) {
+        // Skip dangerous prop names
+        if (DANGEROUS_PROP_NAMES.has(key)) {
+            continue;
+        }
+        // Skip props matching dangerous patterns
+        if (DANGEROUS_PROP_PATTERNS.some((pattern) => pattern.test(key))) {
+            continue;
+        }
+        sanitized[key] = value;
+    }
+    return sanitized;
+}
+const ComponentContentContext = (0, react_1.createContext)(null);
+/**
+ * Provider for component content context.
+ * Wraps rendered components to provide access to component metadata.
+ * @returns Provider component with memoized context value
+ */
+function V1ComponentContentProvider({ children, componentId, threadId, messageId, componentName, }) {
+    // Memoize context value to prevent unnecessary re-renders of consumers
+    const value = (0, react_1.useMemo)(() => ({ componentId, threadId, messageId, componentName }), [componentId, threadId, messageId, componentName]);
+    return (react_1.default.createElement(ComponentContentContext.Provider, { value: value }, children));
+}
+/**
+ * Hook to access the current component content context.
+ * Must be used within a rendered component.
+ * @returns Component content context
+ * @throws {Error} If used outside a rendered component
+ */
+function useV1ComponentContent() {
+    const context = (0, react_1.useContext)(ComponentContentContext);
+    if (!context) {
+        throw new Error("useV1ComponentContent must be used within a rendered component");
+    }
+    return context;
+}
+/**
+ * Hook to optionally access the current component content context.
+ * Returns null if not within a rendered component.
+ * @returns Component content context or null
+ */
+function useV1ComponentContentOptional() {
+    return (0, react_1.useContext)(ComponentContentContext);
+}
+/**
+ * Check if a content block is a component.
+ * @param content - Content block to check
+ * @returns True if content is a V1ComponentContent
+ */
+function isComponentContent(content) {
+    return content.type === "component";
+}
+/**
+ * Render a component content block into a React element.
+ *
+ * Looks up the component in the registry, creates a React element with props,
+ * and wraps it with the component content context provider.
+ * @param content - Component content block to render
+ * @param options - Rendering options including registry and context info
+ * @returns V1ComponentContent with the renderedComponent attached
+ * @example
+ * ```tsx
+ * const rendered = renderComponentContent(componentContent, {
+ *   threadId: 'thread_123',
+ *   messageId: 'msg_456',
+ *   componentList: registry.componentList,
+ * });
+ *
+ * // Use in JSX:
+ * {rendered.renderedComponent}
+ * ```
+ */
+function renderComponentContent(content, options) {
+    const { threadId, messageId, componentList } = options;
+    // Look up component in registry
+    const registeredComponent = componentList[content.name];
+    if (!registeredComponent) {
+        console.warn(`Component "${content.name}" not found in registry`);
+        return {
+            ...content,
+            renderedComponent: null,
+        };
+    }
+    const Component = registeredComponent.component;
+    const LoadingComponent = registeredComponent.loadingComponent;
+    // Determine if we should show loading state
+    const isStreaming = content.streamingState !== "done";
+    // Sanitize props to prevent injection of event handlers or other dangerous props
+    const props = sanitizeProps(content.props);
+    // Create the component element
+    let element;
+    if (isStreaming && LoadingComponent) {
+        // Show loading component during streaming (with props for partial data display)
+        element = (0, react_1.createElement)(LoadingComponent, props);
+    }
+    else {
+        // Show main component - props stream in as they're filled out
+        element = (0, react_1.createElement)(Component, {
+            ...props,
+            // Pass state as initialState prop only if not already provided
+            ...(props.initialState === undefined
+                ? { initialState: content.state }
+                : {}),
+        });
+    }
+    // Wrap with component content context
+    const wrappedElement = (react_1.default.createElement(V1ComponentContentProvider, { componentId: content.id, threadId: threadId, messageId: messageId, componentName: content.name }, element));
+    return {
+        ...content,
+        renderedComponent: wrappedElement,
+    };
+}
+/**
+ * Render all component content blocks in a message.
+ *
+ * Renders component content blocks and attaches renderedComponent.
+ * Non-component content blocks are passed through unchanged.
+ * @param content - Array of content blocks
+ * @param options - Rendering options including registry and context info
+ * @returns Array of content with rendered components
+ */
+function renderMessageContent(content, options) {
+    return content.map((block) => {
+        if (isComponentContent(block)) {
+            return renderComponentContent(block, options);
+        }
+        // Pass through non-component content unchanged
+        return block;
+    });
+}
+/**
+ * Render all components in a message.
+ *
+ * Creates a new message object with all component content blocks rendered.
+ * @param message - Message to render components for
+ * @param options - Rendering options (threadId is extracted from message if not provided)
+ * @returns Message with rendered component content
+ */
+function renderMessageComponents(message, options) {
+    const renderedContent = renderMessageContent(message.content, {
+        ...options,
+        messageId: message.id,
+    });
+    return {
+        ...message,
+        content: renderedContent,
+    };
+}
+//# sourceMappingURL=component-renderer.js.map

package/dist/v1/utils/component-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-renderer.js","sourceRoot":"","sources":["../../../src/v1/utils/component-renderer.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * Component Renderer Utility for v1 API\n *\n * Provides utilities for rendering React components from component content blocks.\n * Components are looked up in the registry and wrapped with context providers.\n */\n\nimport React, {\n  createContext,\n  createElement,\n  useContext,\n  useMemo,\n  type ReactElement,\n} from \"react\";\n\n/**\n * Props that should be filtered out when rendering components.\n * These could be used for event handler injection or other security concerns.\n */\nconst DANGEROUS_PROP_PATTERNS = [\n  /^on[A-Z]/, // Event handlers (onClick, onError, etc.)\n  /^dangerouslySetInnerHTML$/,\n];\n\nconst DANGEROUS_PROP_NAMES = new Set([\"ref\", \"key\", \"children\"]);\n\n/**\n * Sanitize props by removing potentially dangerous properties.\n * Filters out event handlers, refs, and other props that could be abused.\n * @param props - Raw props from the component content\n * @returns Sanitized props safe for spreading to components\n */\nfunction sanitizeProps(\n  props: Record<string, unknown>,\n): Record<string, unknown> {\n  const sanitized: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(props)) {\n    // Skip dangerous prop names\n    if (DANGEROUS_PROP_NAMES.has(key)) {\n      continue;\n    }\n\n    // Skip props matching dangerous patterns\n    if (DANGEROUS_PROP_PATTERNS.some((pattern) => pattern.test(key))) {\n      continue;\n    }\n\n    sanitized[key] = value;\n  }\n\n  return sanitized;\n}\nimport type { ComponentRegistry } from \"../../model/component-metadata\";\nimport type {\n  Content,\n  TamboV1Message,\n  V1ComponentContent,\n} from \"../types/message\";\n\n/**\n * Context for component content blocks.\n * Provides access to the component ID and thread ID for component state hooks.\n */\nexport interface V1ComponentContentContext {\n  /** Component instance ID */\n  componentId: string;\n  /** Thread ID the component belongs to */\n  threadId: string;\n  /** Message ID the component belongs to */\n  messageId: string;\n  /** Component name */\n  componentName: string;\n}\n\nconst ComponentContentContext = createContext<V1ComponentContentContext | null>(\n  null,\n);\n\n/**\n * Provider for component content context.\n * Wraps rendered components to provide access to component metadata.\n * @returns Provider component with memoized context value\n */\nfunction V1ComponentContentProvider({\n  children,\n  componentId,\n  threadId,\n  messageId,\n  componentName,\n}: V1ComponentContentContext & { children: React.ReactNode }) {\n  // Memoize context value to prevent unnecessary re-renders of consumers\n  const value = useMemo(\n    () => ({ componentId, threadId, messageId, componentName }),\n    [componentId, threadId, messageId, componentName],\n  );\n\n  return (\n    <ComponentContentContext.Provider value={value}>\n      {children}\n    </ComponentContentContext.Provider>\n  );\n}\n\n/**\n * Hook to access the current component content context.\n * Must be used within a rendered component.\n * @returns Component content context\n * @throws {Error} If used outside a rendered component\n */\nexport function useV1ComponentContent(): V1ComponentContentContext {\n  const context = useContext(ComponentContentContext);\n  if (!context) {\n    throw new Error(\n      \"useV1ComponentContent must be used within a rendered component\",\n    );\n  }\n  return context;\n}\n\n/**\n * Hook to optionally access the current component content context.\n * Returns null if not within a rendered component.\n * @returns Component content context or null\n */\nexport function useV1ComponentContentOptional(): V1ComponentContentContext | null {\n  return useContext(ComponentContentContext);\n}\n\n/**\n * Options for rendering a component content block.\n */\nexport interface RenderComponentOptions {\n  /** Thread ID for the component context */\n  threadId: string;\n  /** Message ID the component belongs to */\n  messageId: string;\n  /** Component registry to look up components */\n  componentList: ComponentRegistry;\n}\n\n/**\n * Check if a content block is a component.\n * @param content - Content block to check\n * @returns True if content is a V1ComponentContent\n */\nexport function isComponentContent(\n  content: Content,\n): content is V1ComponentContent {\n  return content.type === \"component\";\n}\n\n/**\n * Render a component content block into a React element.\n *\n * Looks up the component in the registry, creates a React element with props,\n * and wraps it with the component content context provider.\n * @param content - Component content block to render\n * @param options - Rendering options including registry and context info\n * @returns V1ComponentContent with the renderedComponent attached\n * @example\n * ```tsx\n * const rendered = renderComponentContent(componentContent, {\n *   threadId: 'thread_123',\n *   messageId: 'msg_456',\n *   componentList: registry.componentList,\n * });\n *\n * // Use in JSX:\n * {rendered.renderedComponent}\n * ```\n */\nexport function renderComponentContent(\n  content: V1ComponentContent,\n  options: RenderComponentOptions,\n): V1ComponentContent {\n  const { threadId, messageId, componentList } = options;\n\n  // Look up component in registry\n  const registeredComponent = componentList[content.name];\n\n  if (!registeredComponent) {\n    console.warn(`Component \"${content.name}\" not found in registry`);\n    return {\n      ...content,\n      renderedComponent: null,\n    };\n  }\n\n  const Component = registeredComponent.component;\n  const LoadingComponent = registeredComponent.loadingComponent;\n\n  // Determine if we should show loading state\n  const isStreaming = content.streamingState !== \"done\";\n\n  // Sanitize props to prevent injection of event handlers or other dangerous props\n  const props = sanitizeProps(content.props as Record<string, unknown>);\n\n  // Create the component element\n  let element: ReactElement;\n\n  if (isStreaming && LoadingComponent) {\n    // Show loading component during streaming (with props for partial data display)\n    element = createElement(LoadingComponent, props);\n  } else {\n    // Show main component - props stream in as they're filled out\n    element = createElement(Component, {\n      ...props,\n      // Pass state as initialState prop only if not already provided\n      ...(props.initialState === undefined\n        ? { initialState: content.state }\n        : {}),\n    });\n  }\n\n  // Wrap with component content context\n  const wrappedElement = (\n    <V1ComponentContentProvider\n      componentId={content.id}\n      threadId={threadId}\n      messageId={messageId}\n      componentName={content.name}\n    >\n      {element}\n    </V1ComponentContentProvider>\n  );\n\n  return {\n    ...content,\n    renderedComponent: wrappedElement,\n  };\n}\n\n/**\n * Render all component content blocks in a message.\n *\n * Renders component content blocks and attaches renderedComponent.\n * Non-component content blocks are passed through unchanged.\n * @param content - Array of content blocks\n * @param options - Rendering options including registry and context info\n * @returns Array of content with rendered components\n */\nexport function renderMessageContent(\n  content: Content[],\n  options: RenderComponentOptions,\n): Content[] {\n  return content.map((block) => {\n    if (isComponentContent(block)) {\n      return renderComponentContent(block, options);\n    }\n    // Pass through non-component content unchanged\n    return block;\n  });\n}\n\n/**\n * Render all components in a message.\n *\n * Creates a new message object with all component content blocks rendered.\n * @param message - Message to render components for\n * @param options - Rendering options (threadId is extracted from message if not provided)\n * @returns Message with rendered component content\n */\nexport function renderMessageComponents(\n  message: TamboV1Message,\n  options: Omit<RenderComponentOptions, \"messageId\"> & { threadId: string },\n): TamboV1Message {\n  const renderedContent = renderMessageContent(message.content, {\n    ...options,\n    messageId: message.id,\n  });\n\n  return {\n    ...message,\n    content: renderedContent,\n  };\n}\n"]}

package/dist/v1/utils/component-renderer.test.d.ts

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

package/dist/v1/utils/component-renderer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-renderer.test.d.ts","sourceRoot":"","sources":["../../../src/v1/utils/component-renderer.test.tsx"],"names":[],"mappings":""}