@tambo-ai/react 0.67.0 → 0.68.0

package/dist/util/resource-content-resolver.test.js

@@ -0,0 +1,254 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_constants_1 = require("../mcp/mcp-constants");
+const mcp_client_1 = require("../mcp/mcp-client");
+const resource_content_resolver_1 = require("./resource-content-resolver");
+describe("extractResourceUris", () => {
+    it("should extract a single resource URI", () => {
+        const text = "Check @registry:file:///path/to/doc.txt";
+        const result = (0, resource_content_resolver_1.extractResourceUris)(text);
+        expect(result).toEqual(["registry:file:///path/to/doc.txt"]);
+    });
+    it("should extract multiple resource URIs", () => {
+        const text = "Check @registry:file:///doc1.txt and @server-a:file:///doc2.txt";
+        const result = (0, resource_content_resolver_1.extractResourceUris)(text);
+        expect(result).toEqual([
+            "registry:file:///doc1.txt",
+            "server-a:file:///doc2.txt",
+        ]);
+    });
+    it("should extract resource URIs with internal server prefix", () => {
+        const text = "Check @tambo-abc123:tambo:test://resource/1";
+        const result = (0, resource_content_resolver_1.extractResourceUris)(text);
+        expect(result).toEqual(["tambo-abc123:tambo:test://resource/1"]);
+    });
+    it("should extract resource URIs with hyphens in server key", () => {
+        const text = "@my-mcp-server:file:///path/file.txt";
+        const result = (0, resource_content_resolver_1.extractResourceUris)(text);
+        expect(result).toEqual(["my-mcp-server:file:///path/file.txt"]);
+    });
+    it("should return empty array for text without resource references", () => {
+        const text = "Just some regular text without @mentions";
+        const result = (0, resource_content_resolver_1.extractResourceUris)(text);
+        expect(result).toEqual([]);
+    });
+    it("should not extract malformed references without colon", () => {
+        const text = "@server-without-colon is not a resource";
+        const result = (0, resource_content_resolver_1.extractResourceUris)(text);
+        expect(result).toEqual([]);
+    });
+    it("should handle URIs with multiple colons", () => {
+        const text = "@server:http://example.com:8080/path";
+        const result = (0, resource_content_resolver_1.extractResourceUris)(text);
+        expect(result).toEqual(["server:http://example.com:8080/path"]);
+    });
+});
+describe("resolveResourceContents", () => {
+    const createMockConnectedServer = (serverKey, readResource, serverType = mcp_constants_1.ServerType.BROWSER_SIDE) => ({
+        key: `mcp-${serverKey}`,
+        serverKey,
+        url: `https://${serverKey}.example.com`,
+        name: `MCP Server ${serverKey}`,
+        transport: mcp_client_1.MCPTransport.HTTP,
+        serverType,
+        client: {
+            client: {
+                readResource,
+                listResources: jest.fn().mockResolvedValue({ resources: [] }),
+                listTools: jest.fn().mockResolvedValue({ tools: [] }),
+                listPrompts: jest.fn().mockResolvedValue({ prompts: [] }),
+                getPrompt: jest.fn().mockResolvedValue(null),
+                callTool: jest.fn().mockResolvedValue(null),
+            },
+            close: jest.fn().mockResolvedValue(undefined),
+        },
+    });
+    const createMockInternalServer = (serverKey) => ({
+        key: serverKey,
+        serverKey,
+        url: "https://api.tambo.ai/mcp",
+        name: "__tambo_internal_mcp_server__",
+        transport: mcp_client_1.MCPTransport.HTTP,
+        serverType: mcp_constants_1.ServerType.TAMBO_INTERNAL,
+        connectionError: undefined, // No client for internal servers
+    });
+    const createMockResourceSource = (getResource) => ({
+        listResources: jest.fn().mockResolvedValue([]),
+        getResource,
+    });
+    it("should resolve registry resources via resourceSource", async () => {
+        const mockGetResource = jest.fn().mockResolvedValue({
+            contents: [
+                {
+                    uri: "file:///local/doc.txt",
+                    mimeType: "text/plain",
+                    text: "Registry document content",
+                },
+            ],
+        });
+        const resourceSource = createMockResourceSource(mockGetResource);
+        const result = await (0, resource_content_resolver_1.resolveResourceContents)(["registry:file:///local/doc.txt"], [], // Registry resources don't need a server - they're handled directly
+        resourceSource);
+        expect(mockGetResource).toHaveBeenCalledWith("file:///local/doc.txt");
+        expect(result.size).toBe(1);
+        expect(result.get("registry:file:///local/doc.txt")).toEqual({
+            contents: [
+                {
+                    uri: "file:///local/doc.txt",
+                    mimeType: "text/plain",
+                    text: "Registry document content",
+                },
+            ],
+        });
+    });
+    it("should resolve client-side MCP resources via mcpServer", async () => {
+        const mockReadResource = jest.fn().mockResolvedValue({
+            contents: [
+                {
+                    uri: "file:///mcp/file.txt",
+                    mimeType: "text/plain",
+                    text: "MCP server content",
+                },
+            ],
+        });
+        const mcpServer = createMockConnectedServer("linear", mockReadResource);
+        const result = await (0, resource_content_resolver_1.resolveResourceContents)(["linear:file:///mcp/file.txt"], [mcpServer], undefined);
+        expect(mockReadResource).toHaveBeenCalledWith({
+            uri: "file:///mcp/file.txt",
+        });
+        expect(result.size).toBe(1);
+        expect(result.get("linear:file:///mcp/file.txt")).toEqual({
+            contents: [
+                {
+                    uri: "file:///mcp/file.txt",
+                    mimeType: "text/plain",
+                    text: "MCP server content",
+                },
+            ],
+        });
+    });
+    it("should skip internal server resources (serverType: TAMBO_INTERNAL)", async () => {
+        const mockGetResource = jest.fn();
+        const resourceSource = createMockResourceSource(mockGetResource);
+        const internalServer = createMockInternalServer("tambo-abc123");
+        const result = await (0, resource_content_resolver_1.resolveResourceContents)(["tambo-abc123:tambo:test://resource/1"], [internalServer], resourceSource);
+        // Should not call getResource for internal server resources
+        expect(mockGetResource).not.toHaveBeenCalled();
+        // Should return empty map since internal resources are skipped
+        expect(result.size).toBe(0);
+    });
+    it("should resolve multiple resources in parallel", async () => {
+        const mockGetResource = jest.fn().mockResolvedValue({
+            contents: [{ uri: "file:///doc.txt", text: "registry content" }],
+        });
+        const mockReadResource = jest.fn().mockResolvedValue({
+            contents: [{ uri: "file:///mcp.txt", text: "mcp content" }],
+        });
+        const resourceSource = createMockResourceSource(mockGetResource);
+        const mcpServer = createMockConnectedServer("mcp-server", mockReadResource);
+        const result = await (0, resource_content_resolver_1.resolveResourceContents)(["registry:file:///doc.txt", "mcp-server:file:///mcp.txt"], [mcpServer], // Only MCP server needed - registry handled directly
+        resourceSource);
+        expect(result.size).toBe(2);
+        expect(result.has("registry:file:///doc.txt")).toBe(true);
+        expect(result.has("mcp-server:file:///mcp.txt")).toBe(true);
+    });
+    it("should handle mixed internal and client-side resources", async () => {
+        const mockGetResource = jest.fn().mockResolvedValue({
+            contents: [{ uri: "file:///doc.txt", text: "registry content" }],
+        });
+        const resourceSource = createMockResourceSource(mockGetResource);
+        const internalServer = createMockInternalServer("tambo-abc123");
+        const result = await (0, resource_content_resolver_1.resolveResourceContents)([
+            "registry:file:///doc.txt", // client-side registry
+            "tambo-abc123:tambo:test://resource/1", // internal - should skip
+        ], [internalServer], // Only internal server needed - registry handled directly
+        resourceSource);
+        // Only the registry resource should be resolved
+        expect(mockGetResource).toHaveBeenCalledTimes(1);
+        expect(result.size).toBe(1);
+        expect(result.has("registry:file:///doc.txt")).toBe(true);
+        expect(result.has("tambo-abc123:tambo:test://resource/1")).toBe(false);
+    });
+    it("should gracefully handle registry resource fetch failure", async () => {
+        const consoleSpy = jest.spyOn(console, "warn").mockImplementation();
+        const mockGetResource = jest
+            .fn()
+            .mockRejectedValue(new Error("Resource not found"));
+        const resourceSource = createMockResourceSource(mockGetResource);
+        const result = await (0, resource_content_resolver_1.resolveResourceContents)(["registry:file:///missing.txt"], [], // Registry resources don't need a server
+        resourceSource);
+        expect(consoleSpy).toHaveBeenCalledWith("Failed to fetch resource content for registry:file:///missing.txt:", expect.any(Error));
+        expect(result.size).toBe(0);
+        consoleSpy.mockRestore();
+    });
+    it("should gracefully handle MCP resource fetch failure", async () => {
+        const consoleSpy = jest.spyOn(console, "warn").mockImplementation();
+        const mockReadResource = jest
+            .fn()
+            .mockRejectedValue(new Error("MCP server error"));
+        const mcpServer = createMockConnectedServer("linear", mockReadResource);
+        const result = await (0, resource_content_resolver_1.resolveResourceContents)(["linear:file:///missing.txt"], [mcpServer], undefined);
+        expect(consoleSpy).toHaveBeenCalledWith("Failed to fetch resource content for linear:file:///missing.txt:", expect.any(Error));
+        expect(result.size).toBe(0);
+        consoleSpy.mockRestore();
+    });
+    it("should warn when no resourceSource available for registry resource", async () => {
+        const consoleSpy = jest.spyOn(console, "warn").mockImplementation();
+        const result = await (0, resource_content_resolver_1.resolveResourceContents)(["registry:file:///doc.txt"], [], // Registry resources don't need a server
+        undefined);
+        expect(consoleSpy).toHaveBeenCalledWith("No resource source available to resolve registry resource: registry:file:///doc.txt");
+        expect(result.size).toBe(0);
+        consoleSpy.mockRestore();
+    });
+    it("should warn when no server found for resource", async () => {
+        const consoleSpy = jest.spyOn(console, "warn").mockImplementation();
+        const result = await (0, resource_content_resolver_1.resolveResourceContents)(["unknown-server:file:///doc.txt"], [], // no servers
+        undefined);
+        expect(consoleSpy).toHaveBeenCalledWith("No server found for resource: unknown-server:file:///doc.txt");
+        expect(result.size).toBe(0);
+        consoleSpy.mockRestore();
+    });
+    it("should handle resource content with blob data", async () => {
+        const mockGetResource = jest.fn().mockResolvedValue({
+            contents: [
+                {
+                    uri: "file:///image.png",
+                    mimeType: "image/png",
+                    blob: "base64encodeddata",
+                },
+            ],
+        });
+        const resourceSource = createMockResourceSource(mockGetResource);
+        const result = await (0, resource_content_resolver_1.resolveResourceContents)(["registry:file:///image.png"], [], // Registry resources don't need a server
+        resourceSource);
+        expect(result.get("registry:file:///image.png")).toEqual({
+            contents: [
+                {
+                    uri: "file:///image.png",
+                    mimeType: "image/png",
+                    blob: "base64encodeddata",
+                },
+            ],
+        });
+    });
+    it("should handle URIs with no colon (invalid format)", async () => {
+        const result = await (0, resource_content_resolver_1.resolveResourceContents)(["invalid-uri-no-colon"], [], undefined);
+        expect(result.size).toBe(0);
+    });
+    it("should handle null content from getResource", async () => {
+        const mockGetResource = jest.fn().mockResolvedValue(null);
+        const resourceSource = createMockResourceSource(mockGetResource);
+        const result = await (0, resource_content_resolver_1.resolveResourceContents)(["registry:file:///doc.txt"], [], // Registry resources don't need a server
+        resourceSource);
+        expect(mockGetResource).toHaveBeenCalled();
+        expect(result.size).toBe(0);
+    });
+    it("should handle null content from readResource", async () => {
+        const mockReadResource = jest.fn().mockResolvedValue(null);
+        const mcpServer = createMockConnectedServer("linear", mockReadResource);
+        const result = await (0, resource_content_resolver_1.resolveResourceContents)(["linear:file:///doc.txt"], [mcpServer], undefined);
+        expect(mockReadResource).toHaveBeenCalled();
+        expect(result.size).toBe(0);
+    });
+});
+//# sourceMappingURL=resource-content-resolver.test.js.map

package/dist/util/resource-content-resolver.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-content-resolver.test.js","sourceRoot":"","sources":["../../src/util/resource-content-resolver.test.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReadResourceResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { ServerType } from \"../mcp/mcp-constants\";\nimport type { McpServer } from \"../mcp/tambo-mcp-provider\";\nimport type { ResourceSource } from \"../model/resource-info\";\nimport { MCPTransport } from \"../mcp/mcp-client\";\n\nimport {\n  resolveResourceContents,\n  extractResourceUris,\n} from \"./resource-content-resolver\";\n\ndescribe(\"extractResourceUris\", () => {\n  it(\"should extract a single resource URI\", () => {\n    const text = \"Check @registry:file:///path/to/doc.txt\";\n    const result = extractResourceUris(text);\n    expect(result).toEqual([\"registry:file:///path/to/doc.txt\"]);\n  });\n\n  it(\"should extract multiple resource URIs\", () => {\n    const text =\n      \"Check @registry:file:///doc1.txt and @server-a:file:///doc2.txt\";\n    const result = extractResourceUris(text);\n    expect(result).toEqual([\n      \"registry:file:///doc1.txt\",\n      \"server-a:file:///doc2.txt\",\n    ]);\n  });\n\n  it(\"should extract resource URIs with internal server prefix\", () => {\n    const text = \"Check @tambo-abc123:tambo:test://resource/1\";\n    const result = extractResourceUris(text);\n    expect(result).toEqual([\"tambo-abc123:tambo:test://resource/1\"]);\n  });\n\n  it(\"should extract resource URIs with hyphens in server key\", () => {\n    const text = \"@my-mcp-server:file:///path/file.txt\";\n    const result = extractResourceUris(text);\n    expect(result).toEqual([\"my-mcp-server:file:///path/file.txt\"]);\n  });\n\n  it(\"should return empty array for text without resource references\", () => {\n    const text = \"Just some regular text without @mentions\";\n    const result = extractResourceUris(text);\n    expect(result).toEqual([]);\n  });\n\n  it(\"should not extract malformed references without colon\", () => {\n    const text = \"@server-without-colon is not a resource\";\n    const result = extractResourceUris(text);\n    expect(result).toEqual([]);\n  });\n\n  it(\"should handle URIs with multiple colons\", () => {\n    const text = \"@server:http://example.com:8080/path\";\n    const result = extractResourceUris(text);\n    expect(result).toEqual([\"server:http://example.com:8080/path\"]);\n  });\n});\n\ndescribe(\"resolveResourceContents\", () => {\n  const createMockConnectedServer = (\n    serverKey: string,\n    readResource: jest.Mock,\n    serverType: ServerType = ServerType.BROWSER_SIDE,\n  ): McpServer =>\n    ({\n      key: `mcp-${serverKey}`,\n      serverKey,\n      url: `https://${serverKey}.example.com`,\n      name: `MCP Server ${serverKey}`,\n      transport: MCPTransport.HTTP,\n      serverType,\n      client: {\n        client: {\n          readResource,\n          listResources: jest.fn().mockResolvedValue({ resources: [] }),\n          listTools: jest.fn().mockResolvedValue({ tools: [] }),\n          listPrompts: jest.fn().mockResolvedValue({ prompts: [] }),\n          getPrompt: jest.fn().mockResolvedValue(null),\n          callTool: jest.fn().mockResolvedValue(null),\n        },\n        close: jest.fn().mockResolvedValue(undefined),\n      } as unknown as McpServer[\"client\"],\n    }) as McpServer;\n\n  const createMockInternalServer = (serverKey: string): McpServer =>\n    ({\n      key: serverKey,\n      serverKey,\n      url: \"https://api.tambo.ai/mcp\",\n      name: \"__tambo_internal_mcp_server__\",\n      transport: MCPTransport.HTTP,\n      serverType: ServerType.TAMBO_INTERNAL,\n      connectionError: undefined, // No client for internal servers\n    }) as unknown as McpServer;\n\n  const createMockResourceSource = (\n    getResource: jest.Mock,\n  ): ResourceSource => ({\n    listResources: jest.fn().mockResolvedValue([]),\n    getResource,\n  });\n\n  it(\"should resolve registry resources via resourceSource\", async () => {\n    const mockGetResource = jest.fn().mockResolvedValue({\n      contents: [\n        {\n          uri: \"file:///local/doc.txt\",\n          mimeType: \"text/plain\",\n          text: \"Registry document content\",\n        },\n      ],\n    } satisfies ReadResourceResult);\n\n    const resourceSource = createMockResourceSource(mockGetResource);\n\n    const result = await resolveResourceContents(\n      [\"registry:file:///local/doc.txt\"],\n      [], // Registry resources don't need a server - they're handled directly\n      resourceSource,\n    );\n\n    expect(mockGetResource).toHaveBeenCalledWith(\"file:///local/doc.txt\");\n    expect(result.size).toBe(1);\n    expect(result.get(\"registry:file:///local/doc.txt\")).toEqual({\n      contents: [\n        {\n          uri: \"file:///local/doc.txt\",\n          mimeType: \"text/plain\",\n          text: \"Registry document content\",\n        },\n      ],\n    });\n  });\n\n  it(\"should resolve client-side MCP resources via mcpServer\", async () => {\n    const mockReadResource = jest.fn().mockResolvedValue({\n      contents: [\n        {\n          uri: \"file:///mcp/file.txt\",\n          mimeType: \"text/plain\",\n          text: \"MCP server content\",\n        },\n      ],\n    } satisfies ReadResourceResult);\n\n    const mcpServer = createMockConnectedServer(\"linear\", mockReadResource);\n\n    const result = await resolveResourceContents(\n      [\"linear:file:///mcp/file.txt\"],\n      [mcpServer],\n      undefined,\n    );\n\n    expect(mockReadResource).toHaveBeenCalledWith({\n      uri: \"file:///mcp/file.txt\",\n    });\n    expect(result.size).toBe(1);\n    expect(result.get(\"linear:file:///mcp/file.txt\")).toEqual({\n      contents: [\n        {\n          uri: \"file:///mcp/file.txt\",\n          mimeType: \"text/plain\",\n          text: \"MCP server content\",\n        },\n      ],\n    });\n  });\n\n  it(\"should skip internal server resources (serverType: TAMBO_INTERNAL)\", async () => {\n    const mockGetResource = jest.fn();\n    const resourceSource = createMockResourceSource(mockGetResource);\n    const internalServer = createMockInternalServer(\"tambo-abc123\");\n\n    const result = await resolveResourceContents(\n      [\"tambo-abc123:tambo:test://resource/1\"],\n      [internalServer],\n      resourceSource,\n    );\n\n    // Should not call getResource for internal server resources\n    expect(mockGetResource).not.toHaveBeenCalled();\n    // Should return empty map since internal resources are skipped\n    expect(result.size).toBe(0);\n  });\n\n  it(\"should resolve multiple resources in parallel\", async () => {\n    const mockGetResource = jest.fn().mockResolvedValue({\n      contents: [{ uri: \"file:///doc.txt\", text: \"registry content\" }],\n    });\n    const mockReadResource = jest.fn().mockResolvedValue({\n      contents: [{ uri: \"file:///mcp.txt\", text: \"mcp content\" }],\n    });\n\n    const resourceSource = createMockResourceSource(mockGetResource);\n    const mcpServer = createMockConnectedServer(\"mcp-server\", mockReadResource);\n\n    const result = await resolveResourceContents(\n      [\"registry:file:///doc.txt\", \"mcp-server:file:///mcp.txt\"],\n      [mcpServer], // Only MCP server needed - registry handled directly\n      resourceSource,\n    );\n\n    expect(result.size).toBe(2);\n    expect(result.has(\"registry:file:///doc.txt\")).toBe(true);\n    expect(result.has(\"mcp-server:file:///mcp.txt\")).toBe(true);\n  });\n\n  it(\"should handle mixed internal and client-side resources\", async () => {\n    const mockGetResource = jest.fn().mockResolvedValue({\n      contents: [{ uri: \"file:///doc.txt\", text: \"registry content\" }],\n    });\n    const resourceSource = createMockResourceSource(mockGetResource);\n    const internalServer = createMockInternalServer(\"tambo-abc123\");\n\n    const result = await resolveResourceContents(\n      [\n        \"registry:file:///doc.txt\", // client-side registry\n        \"tambo-abc123:tambo:test://resource/1\", // internal - should skip\n      ],\n      [internalServer], // Only internal server needed - registry handled directly\n      resourceSource,\n    );\n\n    // Only the registry resource should be resolved\n    expect(mockGetResource).toHaveBeenCalledTimes(1);\n    expect(result.size).toBe(1);\n    expect(result.has(\"registry:file:///doc.txt\")).toBe(true);\n    expect(result.has(\"tambo-abc123:tambo:test://resource/1\")).toBe(false);\n  });\n\n  it(\"should gracefully handle registry resource fetch failure\", async () => {\n    const consoleSpy = jest.spyOn(console, \"warn\").mockImplementation();\n    const mockGetResource = jest\n      .fn()\n      .mockRejectedValue(new Error(\"Resource not found\"));\n    const resourceSource = createMockResourceSource(mockGetResource);\n\n    const result = await resolveResourceContents(\n      [\"registry:file:///missing.txt\"],\n      [], // Registry resources don't need a server\n      resourceSource,\n    );\n\n    expect(consoleSpy).toHaveBeenCalledWith(\n      \"Failed to fetch resource content for registry:file:///missing.txt:\",\n      expect.any(Error),\n    );\n    expect(result.size).toBe(0);\n\n    consoleSpy.mockRestore();\n  });\n\n  it(\"should gracefully handle MCP resource fetch failure\", async () => {\n    const consoleSpy = jest.spyOn(console, \"warn\").mockImplementation();\n    const mockReadResource = jest\n      .fn()\n      .mockRejectedValue(new Error(\"MCP server error\"));\n    const mcpServer = createMockConnectedServer(\"linear\", mockReadResource);\n\n    const result = await resolveResourceContents(\n      [\"linear:file:///missing.txt\"],\n      [mcpServer],\n      undefined,\n    );\n\n    expect(consoleSpy).toHaveBeenCalledWith(\n      \"Failed to fetch resource content for linear:file:///missing.txt:\",\n      expect.any(Error),\n    );\n    expect(result.size).toBe(0);\n\n    consoleSpy.mockRestore();\n  });\n\n  it(\"should warn when no resourceSource available for registry resource\", async () => {\n    const consoleSpy = jest.spyOn(console, \"warn\").mockImplementation();\n\n    const result = await resolveResourceContents(\n      [\"registry:file:///doc.txt\"],\n      [], // Registry resources don't need a server\n      undefined, // no resourceSource\n    );\n\n    expect(consoleSpy).toHaveBeenCalledWith(\n      \"No resource source available to resolve registry resource: registry:file:///doc.txt\",\n    );\n    expect(result.size).toBe(0);\n\n    consoleSpy.mockRestore();\n  });\n\n  it(\"should warn when no server found for resource\", async () => {\n    const consoleSpy = jest.spyOn(console, \"warn\").mockImplementation();\n\n    const result = await resolveResourceContents(\n      [\"unknown-server:file:///doc.txt\"],\n      [], // no servers\n      undefined,\n    );\n\n    expect(consoleSpy).toHaveBeenCalledWith(\n      \"No server found for resource: unknown-server:file:///doc.txt\",\n    );\n    expect(result.size).toBe(0);\n\n    consoleSpy.mockRestore();\n  });\n\n  it(\"should handle resource content with blob data\", async () => {\n    const mockGetResource = jest.fn().mockResolvedValue({\n      contents: [\n        {\n          uri: \"file:///image.png\",\n          mimeType: \"image/png\",\n          blob: \"base64encodeddata\",\n        },\n      ],\n    } satisfies ReadResourceResult);\n\n    const resourceSource = createMockResourceSource(mockGetResource);\n\n    const result = await resolveResourceContents(\n      [\"registry:file:///image.png\"],\n      [], // Registry resources don't need a server\n      resourceSource,\n    );\n\n    expect(result.get(\"registry:file:///image.png\")).toEqual({\n      contents: [\n        {\n          uri: \"file:///image.png\",\n          mimeType: \"image/png\",\n          blob: \"base64encodeddata\",\n        },\n      ],\n    });\n  });\n\n  it(\"should handle URIs with no colon (invalid format)\", async () => {\n    const result = await resolveResourceContents(\n      [\"invalid-uri-no-colon\"],\n      [],\n      undefined,\n    );\n\n    expect(result.size).toBe(0);\n  });\n\n  it(\"should handle null content from getResource\", async () => {\n    const mockGetResource = jest.fn().mockResolvedValue(null);\n    const resourceSource = createMockResourceSource(mockGetResource);\n\n    const result = await resolveResourceContents(\n      [\"registry:file:///doc.txt\"],\n      [], // Registry resources don't need a server\n      resourceSource,\n    );\n\n    expect(mockGetResource).toHaveBeenCalled();\n    expect(result.size).toBe(0);\n  });\n\n  it(\"should handle null content from readResource\", async () => {\n    const mockReadResource = jest.fn().mockResolvedValue(null);\n    const mcpServer = createMockConnectedServer(\"linear\", mockReadResource);\n\n    const result = await resolveResourceContents(\n      [\"linear:file:///doc.txt\"],\n      [mcpServer],\n      undefined,\n    );\n\n    expect(mockReadResource).toHaveBeenCalled();\n    expect(result.size).toBe(0);\n  });\n});\n"]}

package/esm/context-helpers/current-interactables-context-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"current-interactables-context-helper.d.ts","sourceRoot":"","sources":["../../src/context-helpers/current-interactables-context-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAI/C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,GAC3C,YAAY,GAAG,EAAE,KAChB,eAqBF,CAAC"}
+{"version":3,"file":"current-interactables-context-helper.d.ts","sourceRoot":"","sources":["../../src/context-helpers/current-interactables-context-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAI/C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,GAC3C,YAAY,GAAG,EAAE,KAChB,eAwBF,CAAC"}

package/esm/context-helpers/current-interactables-context-helper.js

@@ -33,7 +33,7 @@ export const createInteractablesContextHelper = (components) => {
             return null; // No interactable components on the page
         }
         return {
-            description: "These are the interactable components currently visible on the page that you can read and modify. Each component has an id, componentName, current props, current state,and optional schema. You can use tools to update these components on behalf of the user. Don't tell the user the ID of the components, only the name, unless they ask for it.",
+            description: "These are the interactable components currently visible on the page that you can read and modify. Each component has an id, componentName, current props, current state, and optional schemas. You can use tools to update these components' props and state on behalf of the user. Don't tell the user the ID of the components, only the name, unless they ask for it.",
             components: components.map((component) => ({
                 id: component.id,
                 componentName: component.name,
@@ -43,6 +43,9 @@ export const createInteractablesContextHelper = (components) => {
                     ? "Available - use component-specific update tools"
                     : "Not specified",
                 state: component.state,
+                stateSchema: component.stateSchema
+                    ? "Available - use component-specific update tools"
+                    : "Not specified",
             })),
         };
     };

package/esm/context-helpers/current-interactables-context-helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"current-interactables-context-helper.js","sourceRoot":"","sources":["../../src/context-helpers/current-interactables-context-helper.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAoB,GAAG,EAAE;IACrE,mFAAmF;IACnF,wEAAwE;IACxE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,UAAiB,EACA,EAAE;IACnB,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAC,CAAC,yCAAyC;QACxD,CAAC;QAED,OAAO;YACL,WAAW,EACT,uVAAuV;YACzV,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBACzC,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,aAAa,EAAE,SAAS,CAAC,IAAI;gBAC7B,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,KAAK,EAAE,SAAS,CAAC,KAAK;gBACtB,WAAW,EAAE,SAAS,CAAC,WAAW;oBAChC,CAAC,CAAC,iDAAiD;oBACnD,CAAC,CAAC,eAAe;gBACnB,KAAK,EAAE,SAAS,CAAC,KAAK;aACvB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import { ContextHelperFn } from \"./types\";\n\n/**\n * Prebuilt context helper that provides information about all interactable components currently on the page.\n * This gives the AI awareness of what components it can interact with and their current state.\n * @returns an object with description and components, or null to skip including this context.\n * To disable this helper, override it with a function that returns null:\n * @example\n * ```tsx\n * // To disable the default interactables context\n * const { addContextHelper } = useTamboContextHelpers();\n * addContextHelper(\"interactables\", () => null);\n *\n * // To customize the context\n * addContextHelper(\"interactables\", () => ({\n *   description: \"Custom description\",\n *   components: getCustomComponentsSubset()\n * }));\n * ```\n */\nexport const currentInteractablesContextHelper: ContextHelperFn = () => {\n  // This will be provided by the interactable provider when it registers this helper\n  // Since we're provider-only now, this function gets replaced at runtime\n  return null;\n};\n\n/**\n * Creates an interactables context helper with access to the current components.\n * This is used internally by TamboInteractableProvider.\n * @param components Array of interactable components\n * @returns Context helper function\n */\nexport const createInteractablesContextHelper = (\n  components: any[],\n): ContextHelperFn => {\n  return () => {\n    if (!Array.isArray(components) || components.length === 0) {\n      return null; // No interactable components on the page\n    }\n\n    return {\n      description:\n        \"These are the interactable components currently visible on the page that you can read and modify. Each component has an id, componentName, current props, current state,and optional schema. You can use tools to update these components on behalf of the user. Don't tell the user the ID of the components, only the name, unless they ask for it.\",\n      components: components.map((component) => ({\n        id: component.id,\n        componentName: component.name,\n        description: component.description,\n        props: component.props,\n        propsSchema: component.propsSchema\n          ? \"Available - use component-specific update tools\"\n          : \"Not specified\",\n        state: component.state,\n      })),\n    };\n  };\n};\n"]}
+{"version":3,"file":"current-interactables-context-helper.js","sourceRoot":"","sources":["../../src/context-helpers/current-interactables-context-helper.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAoB,GAAG,EAAE;IACrE,mFAAmF;IACnF,wEAAwE;IACxE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,UAAiB,EACA,EAAE;IACnB,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAC,CAAC,yCAAyC;QACxD,CAAC;QAED,OAAO;YACL,WAAW,EACT,0WAA0W;YAC5W,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBACzC,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,aAAa,EAAE,SAAS,CAAC,IAAI;gBAC7B,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,KAAK,EAAE,SAAS,CAAC,KAAK;gBACtB,WAAW,EAAE,SAAS,CAAC,WAAW;oBAChC,CAAC,CAAC,iDAAiD;oBACnD,CAAC,CAAC,eAAe;gBACnB,KAAK,EAAE,SAAS,CAAC,KAAK;gBACtB,WAAW,EAAE,SAAS,CAAC,WAAW;oBAChC,CAAC,CAAC,iDAAiD;oBACnD,CAAC,CAAC,eAAe;aACpB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import { ContextHelperFn } from \"./types\";\n\n/**\n * Prebuilt context helper that provides information about all interactable components currently on the page.\n * This gives the AI awareness of what components it can interact with and their current state.\n * @returns an object with description and components, or null to skip including this context.\n * To disable this helper, override it with a function that returns null:\n * @example\n * ```tsx\n * // To disable the default interactables context\n * const { addContextHelper } = useTamboContextHelpers();\n * addContextHelper(\"interactables\", () => null);\n *\n * // To customize the context\n * addContextHelper(\"interactables\", () => ({\n *   description: \"Custom description\",\n *   components: getCustomComponentsSubset()\n * }));\n * ```\n */\nexport const currentInteractablesContextHelper: ContextHelperFn = () => {\n  // This will be provided by the interactable provider when it registers this helper\n  // Since we're provider-only now, this function gets replaced at runtime\n  return null;\n};\n\n/**\n * Creates an interactables context helper with access to the current components.\n * This is used internally by TamboInteractableProvider.\n * @param components Array of interactable components\n * @returns Context helper function\n */\nexport const createInteractablesContextHelper = (\n  components: any[],\n): ContextHelperFn => {\n  return () => {\n    if (!Array.isArray(components) || components.length === 0) {\n      return null; // No interactable components on the page\n    }\n\n    return {\n      description:\n        \"These are the interactable components currently visible on the page that you can read and modify. Each component has an id, componentName, current props, current state, and optional schemas. You can use tools to update these components' props and state on behalf of the user. Don't tell the user the ID of the components, only the name, unless they ask for it.\",\n      components: components.map((component) => ({\n        id: component.id,\n        componentName: component.name,\n        description: component.description,\n        props: component.props,\n        propsSchema: component.propsSchema\n          ? \"Available - use component-specific update tools\"\n          : \"Not specified\",\n        state: component.state,\n        stateSchema: component.stateSchema\n          ? \"Available - use component-specific update tools\"\n          : \"Not specified\",\n      })),\n    };\n  };\n};\n"]}

package/esm/hoc/with-tambo-interactable.d.ts

@@ -1,14 +1,47 @@
 import React from "react";
 import { SupportedSchema } from "../schema";
-export interface InteractableConfig {
+export interface InteractableConfig<Props = Record<string, unknown>, State = Record<string, unknown>> {
+    /**
+     * The name of the component, used for identification in Tambo.
+     */
     componentName: string;
+    /**
+     * A brief description of the component's purpose and functionality. LLM will
+     * use this to understand how to interact with it.
+     */
     description: string;
-    propsSchema?: SupportedSchema;
+    /**
+     * Optional schema for component props. If provided, prop updates will be
+     * validated against this schema.
+     */
+    propsSchema?: SupportedSchema<Props>;
+    /**
+     * Optional schema for component state. If provided, state updates will be
+     * validated against this schema.
+     */
+    stateSchema?: SupportedSchema<State>;
 }
+/**
+ * Props injected by withTamboInteractable HOC. These can be passed to the wrapped
+ * component to customize interactable behavior.
+ */
 export interface WithTamboInteractableProps {
+    /**
+     * Optional ID to use for this interactable component instance.
+     * If not provided, a unique ID will be generated automatically.
+     */
     interactableId?: string;
+    /**
+     * Callback fired when the component has been registered as interactable.
+     * @param id - The assigned interactable component ID
+     */
     onInteractableReady?: (id: string) => void;
-    onPropsUpdate?: (newProps: Record<string, any>) => void;
+    /**
+     * Callback fired when the component's serializable props are updated by Tambo
+     * through a tool call. Note: Only serializable props are tracked.
+     * @param newProps - The updated serializable props
+     */
+    onPropsUpdate?: (newProps: Record<string, unknown>) => void;
 }
 /**
  * Higher-Order Component that makes any component interactable by tambo.
@@ -17,6 +50,16 @@ export interface WithTamboInteractableProps {
  * @returns A new component that is automatically registered as interactable
  * @example
  * ```tsx
+ * const MyNote: React.FC<{ title: string; content: string }> = ({ title, content }) => {
+ *   const [isPinned, setIsPinned] = useTamboComponentState("isPinned", false);
+ *   return (
+ *     <div style={{ border: isPinned ? "2px solid gold" : "1px solid gray", order: isPinned ? -1 : 0 }}>
+ *       <h2>{title}</h2>
+ *       <p>{content}</p>
+ *     </div>
+ *   );
+ * };
+ *
  * const MyInteractableNote = withTamboInteractable(MyNote, {
  *   componentName: "MyNote",
  *   description: "A note component",
@@ -24,11 +67,14 @@ export interface WithTamboInteractableProps {
  *     title: z.string(),
  *     content: z.string(),
  *   }),
+ *  stateSchema: z.object({
+ *    isPinned: z.boolean(),
+ *  }),
  * });
  *
  * // Usage
  * <MyInteractableNote title="My Note" content="This is my note" />
  * ```
  */
-export declare function withTamboInteractable<P extends object>(WrappedComponent: React.ComponentType<P>, config: InteractableConfig): React.FC<P & WithTamboInteractableProps>;
+export declare function withTamboInteractable<ComponentProps extends object>(WrappedComponent: React.ComponentType<ComponentProps>, config: InteractableConfig): React.FC<ComponentProps & WithTamboInteractableProps>;
 //# sourceMappingURL=with-tambo-interactable.d.ts.map

package/esm/hoc/with-tambo-interactable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with-tambo-interactable.d.ts","sourceRoot":"","sources":["../../src/hoc/with-tambo-interactable.tsx"],"names":[],"mappings":"AACA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAIxE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;CACzD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EACpD,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EACxC,MAAM,EAAE,kBAAkB,4CAgH3B"}
+{"version":3,"file":"with-tambo-interactable.d.ts","sourceRoot":"","sources":["../../src/hoc/with-tambo-interactable.tsx"],"names":[],"mappings":"AACA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAIxE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,kBAAkB,CACjC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE/B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IACrC;;;OAGG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,SAAS,MAAM,EACjE,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,EACrD,MAAM,EAAE,kBAAkB,yDAsH3B"}

package/esm/hoc/with-tambo-interactable.js

@@ -9,6 +9,16 @@ import { useTamboInteractable } from "../providers/tambo-interactable-provider";
  * @returns A new component that is automatically registered as interactable
  * @example
  * ```tsx
+ * const MyNote: React.FC<{ title: string; content: string }> = ({ title, content }) => {
+ *   const [isPinned, setIsPinned] = useTamboComponentState("isPinned", false);
+ *   return (
+ *     <div style={{ border: isPinned ? "2px solid gold" : "1px solid gray", order: isPinned ? -1 : 0 }}>
+ *       <h2>{title}</h2>
+ *       <p>{content}</p>
+ *     </div>
+ *   );
+ * };
+ *
  * const MyInteractableNote = withTamboInteractable(MyNote, {
  *   componentName: "MyNote",
  *   description: "A note component",
@@ -16,6 +26,9 @@ import { useTamboInteractable } from "../providers/tambo-interactable-provider";
  *     title: z.string(),
  *     content: z.string(),
  *   }),
+ *  stateSchema: z.object({
+ *    isPinned: z.boolean(),
+ *  }),
  * });
  *
  * // Usage
@@ -28,9 +41,10 @@ export function withTamboInteractable(WrappedComponent, config) {
         const { addInteractableComponent, updateInteractableComponentProps, getInteractableComponent, } = useTamboInteractable();
         const [interactableId, setInteractableId] = useState(null);
         const isInitialized = useRef(false);
-        const lastParentProps = useRef({});
-        // Extract interactable-specific props
-        const { onInteractableReady, onPropsUpdate, ...componentProps } = props;
+        const lastSerializedProps = useRef({});
+        // Extract interactable-specific props from component props
+        const { interactableId: _providedId, // Reserved for future use
+        onInteractableReady, onPropsUpdate, ...componentProps } = props;
         // Get the current interactable component to track prop updates
         const currentInteractable = interactableId
             ? getInteractableComponent(interactableId)
@@ -47,6 +61,7 @@ export function withTamboInteractable(WrappedComponent, config) {
                     component: WrappedComponent,
                     props: componentProps,
                     propsSchema: config.propsSchema,
+                    stateSchema: config.stateSchema,
                 });
                 setInteractableId(id);
                 onInteractableReady?.(id);
@@ -61,12 +76,12 @@ export function withTamboInteractable(WrappedComponent, config) {
         useEffect(() => {
             if (interactableId && isInitialized.current) {
                 // Only update if the props are different from what we last sent
-                const lastPropsString = JSON.stringify(lastParentProps.current);
+                const lastPropsString = JSON.stringify(lastSerializedProps.current);
                 const currentPropsString = JSON.stringify(componentProps);
                 if (lastPropsString !== currentPropsString) {
                     updateInteractableComponentProps(interactableId, componentProps);
                     onPropsUpdate?.(componentProps);
-                    lastParentProps.current = componentProps;
+                    lastSerializedProps.current = componentProps;
                 }
             }
         }, [

package/esm/hoc/with-tambo-interactable.js.map

@@ -1 +1 @@
-{"version":3,"file":"with-tambo-interactable.js","sourceRoot":"","sources":["../../src/hoc/with-tambo-interactable.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\nimport React, { useCallback, useEffect, useRef, useState } from \"react\";\nimport { TamboMessageProvider } from \"../hooks/use-current-message\";\nimport { TamboThreadMessage } from \"../model/generate-component-response\";\nimport { useTamboInteractable } from \"../providers/tambo-interactable-provider\";\nimport { SupportedSchema } from \"../schema\";\n\nexport interface InteractableConfig {\n  componentName: string;\n  description: string;\n  propsSchema?: SupportedSchema;\n}\n\nexport interface WithTamboInteractableProps {\n  interactableId?: string;\n  onInteractableReady?: (id: string) => void;\n  onPropsUpdate?: (newProps: Record<string, any>) => void;\n}\n\n/**\n * Higher-Order Component that makes any component interactable by tambo.\n * @param WrappedComponent - The component to make interactable\n * @param config - Configuration for the interactable component\n * @returns A new component that is automatically registered as interactable\n * @example\n * ```tsx\n * const MyInteractableNote = withTamboInteractable(MyNote, {\n *   componentName: \"MyNote\",\n *   description: \"A note component\",\n *   propsSchema: z.object({\n *     title: z.string(),\n *     content: z.string(),\n *   }),\n * });\n *\n * // Usage\n * <MyInteractableNote title=\"My Note\" content=\"This is my note\" />\n * ```\n */\nexport function withTamboInteractable<P extends object>(\n  WrappedComponent: React.ComponentType<P>,\n  config: InteractableConfig,\n) {\n  const displayName =\n    WrappedComponent.displayName ?? WrappedComponent.name ?? \"Component\";\n\n  const TamboInteractableWrapper: React.FC<P & WithTamboInteractableProps> = (\n    props,\n  ) => {\n    const {\n      addInteractableComponent,\n      updateInteractableComponentProps,\n      getInteractableComponent,\n    } = useTamboInteractable();\n\n    const [interactableId, setInteractableId] = useState<string | null>(null);\n    const isInitialized = useRef(false);\n    const lastParentProps = useRef<Record<string, any>>({});\n\n    // Extract interactable-specific props\n    const { onInteractableReady, onPropsUpdate, ...componentProps } = props;\n\n    // Get the current interactable component to track prop updates\n    const currentInteractable = interactableId\n      ? getInteractableComponent(interactableId)\n      : null;\n\n    // Use the props from the interactable component if available, otherwise use the passed props\n    // We need to be careful not to create a loop, so we only use stored props if they're different from passed props\n    const effectiveProps = currentInteractable?.props ?? componentProps;\n\n    // Memoize the registration function\n    const registerComponent = useCallback(() => {\n      if (!isInitialized.current) {\n        const id = addInteractableComponent({\n          name: config.componentName,\n          description: config.description,\n          component: WrappedComponent,\n          props: componentProps,\n          propsSchema: config.propsSchema,\n        });\n\n        setInteractableId(id);\n        onInteractableReady?.(id);\n        isInitialized.current = true;\n      }\n    }, [addInteractableComponent, componentProps, onInteractableReady]);\n\n    // Register the component as interactable on mount (only once)\n    useEffect(() => {\n      registerComponent();\n    }, [registerComponent]);\n\n    // Update the interactable component when props change from parent\n    useEffect(() => {\n      if (interactableId && isInitialized.current) {\n        // Only update if the props are different from what we last sent\n        const lastPropsString = JSON.stringify(lastParentProps.current);\n        const currentPropsString = JSON.stringify(componentProps);\n\n        if (lastPropsString !== currentPropsString) {\n          updateInteractableComponentProps(interactableId, componentProps);\n          onPropsUpdate?.(componentProps);\n          lastParentProps.current = componentProps;\n        }\n      }\n    }, [\n      interactableId,\n      componentProps,\n      updateInteractableComponentProps,\n      onPropsUpdate,\n    ]);\n\n    // If the interactable ID is not yet set, render the component without provider\n    if (!interactableId) {\n      return <WrappedComponent {...(effectiveProps as P)} />;\n    }\n\n    // Create a minimal message with interactable metadata\n    // This allows useTamboCurrentComponent to work with standalone interactable components\n    const minimalMessage: TamboThreadMessage = {\n      id: interactableId,\n      role: \"assistant\" as const,\n      content: [],\n      threadId: \"\",\n      createdAt: new Date().toISOString(),\n      component: {\n        componentName: config.componentName,\n        componentState: {},\n        message: \"\",\n        props: effectiveProps,\n      },\n      componentState: {},\n    };\n\n    // Wrap with TamboMessageProvider including interactable metadata\n    return (\n      <TamboMessageProvider\n        message={minimalMessage}\n        interactableMetadata={{\n          id: interactableId,\n          componentName: config.componentName,\n          description: config.description,\n        }}\n      >\n        <WrappedComponent {...(effectiveProps as P)} />\n      </TamboMessageProvider>\n    );\n  };\n\n  TamboInteractableWrapper.displayName = `withTamboInteractable(${displayName})`;\n\n  return TamboInteractableWrapper;\n}\n"]}
+{"version":3,"file":"with-tambo-interactable.js","sourceRoot":"","sources":["../../src/hoc/with-tambo-interactable.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\nimport React, { useCallback, useEffect, useRef, useState } from \"react\";\nimport { TamboMessageProvider } from \"../hooks/use-current-message\";\nimport { TamboThreadMessage } from \"../model/generate-component-response\";\nimport { useTamboInteractable } from \"../providers/tambo-interactable-provider\";\nimport { SupportedSchema } from \"../schema\";\n\nexport interface InteractableConfig<\n  Props = Record<string, unknown>,\n  State = Record<string, unknown>,\n> {\n  /**\n   * The name of the component, used for identification in Tambo.\n   */\n  componentName: string;\n  /**\n   * A brief description of the component's purpose and functionality. LLM will\n   * use this to understand how to interact with it.\n   */\n  description: string;\n  /**\n   * Optional schema for component props. If provided, prop updates will be\n   * validated against this schema.\n   */\n  propsSchema?: SupportedSchema<Props>;\n  /**\n   * Optional schema for component state. If provided, state updates will be\n   * validated against this schema.\n   */\n  stateSchema?: SupportedSchema<State>;\n}\n\n/**\n * Props injected by withTamboInteractable HOC. These can be passed to the wrapped\n * component to customize interactable behavior.\n */\nexport interface WithTamboInteractableProps {\n  /**\n   * Optional ID to use for this interactable component instance.\n   * If not provided, a unique ID will be generated automatically.\n   */\n  interactableId?: string;\n  /**\n   * Callback fired when the component has been registered as interactable.\n   * @param id - The assigned interactable component ID\n   */\n  onInteractableReady?: (id: string) => void;\n  /**\n   * Callback fired when the component's serializable props are updated by Tambo\n   * through a tool call. Note: Only serializable props are tracked.\n   * @param newProps - The updated serializable props\n   */\n  onPropsUpdate?: (newProps: Record<string, unknown>) => void;\n}\n\n/**\n * Higher-Order Component that makes any component interactable by tambo.\n * @param WrappedComponent - The component to make interactable\n * @param config - Configuration for the interactable component\n * @returns A new component that is automatically registered as interactable\n * @example\n * ```tsx\n * const MyNote: React.FC<{ title: string; content: string }> = ({ title, content }) => {\n *   const [isPinned, setIsPinned] = useTamboComponentState(\"isPinned\", false);\n *   return (\n *     <div style={{ border: isPinned ? \"2px solid gold\" : \"1px solid gray\", order: isPinned ? -1 : 0 }}>\n *       <h2>{title}</h2>\n *       <p>{content}</p>\n *     </div>\n *   );\n * };\n *\n * const MyInteractableNote = withTamboInteractable(MyNote, {\n *   componentName: \"MyNote\",\n *   description: \"A note component\",\n *   propsSchema: z.object({\n *     title: z.string(),\n *     content: z.string(),\n *   }),\n *  stateSchema: z.object({\n *    isPinned: z.boolean(),\n *  }),\n * });\n *\n * // Usage\n * <MyInteractableNote title=\"My Note\" content=\"This is my note\" />\n * ```\n */\nexport function withTamboInteractable<ComponentProps extends object>(\n  WrappedComponent: React.ComponentType<ComponentProps>,\n  config: InteractableConfig,\n) {\n  const displayName =\n    WrappedComponent.displayName ?? WrappedComponent.name ?? \"Component\";\n\n  const TamboInteractableWrapper: React.FC<\n    ComponentProps & WithTamboInteractableProps\n  > = (props) => {\n    const {\n      addInteractableComponent,\n      updateInteractableComponentProps,\n      getInteractableComponent,\n    } = useTamboInteractable();\n\n    const [interactableId, setInteractableId] = useState<string | null>(null);\n    const isInitialized = useRef(false);\n    const lastSerializedProps = useRef<Record<string, unknown>>({});\n\n    // Extract interactable-specific props from component props\n    const {\n      interactableId: _providedId, // Reserved for future use\n      onInteractableReady,\n      onPropsUpdate,\n      ...componentProps\n    } = props;\n\n    // Get the current interactable component to track prop updates\n    const currentInteractable = interactableId\n      ? getInteractableComponent(interactableId)\n      : null;\n\n    // Use the props from the interactable component if available, otherwise use the passed props\n    // We need to be careful not to create a loop, so we only use stored props if they're different from passed props\n    const effectiveProps = currentInteractable?.props ?? componentProps;\n\n    // Memoize the registration function\n    const registerComponent = useCallback(() => {\n      if (!isInitialized.current) {\n        const id = addInteractableComponent({\n          name: config.componentName,\n          description: config.description,\n          component: WrappedComponent,\n          props: componentProps,\n          propsSchema: config.propsSchema,\n          stateSchema: config.stateSchema,\n        });\n\n        setInteractableId(id);\n        onInteractableReady?.(id);\n        isInitialized.current = true;\n      }\n    }, [addInteractableComponent, componentProps, onInteractableReady]);\n\n    // Register the component as interactable on mount (only once)\n    useEffect(() => {\n      registerComponent();\n    }, [registerComponent]);\n\n    // Update the interactable component when props change from parent\n    useEffect(() => {\n      if (interactableId && isInitialized.current) {\n        // Only update if the props are different from what we last sent\n        const lastPropsString = JSON.stringify(lastSerializedProps.current);\n        const currentPropsString = JSON.stringify(componentProps);\n\n        if (lastPropsString !== currentPropsString) {\n          updateInteractableComponentProps(interactableId, componentProps);\n          onPropsUpdate?.(componentProps);\n          lastSerializedProps.current = componentProps;\n        }\n      }\n    }, [\n      interactableId,\n      componentProps,\n      updateInteractableComponentProps,\n      onPropsUpdate,\n    ]);\n\n    // If the interactable ID is not yet set, render the component without provider\n    if (!interactableId) {\n      return <WrappedComponent {...(effectiveProps as ComponentProps)} />;\n    }\n\n    // Create a minimal message with interactable metadata\n    // This allows useTamboCurrentComponent to work with standalone interactable components\n    const minimalMessage: TamboThreadMessage = {\n      id: interactableId,\n      role: \"assistant\" as const,\n      content: [],\n      threadId: \"\",\n      createdAt: new Date().toISOString(),\n      component: {\n        componentName: config.componentName,\n        componentState: {},\n        message: \"\",\n        props: effectiveProps,\n      },\n      componentState: {},\n    };\n\n    // Wrap with TamboMessageProvider including interactable metadata\n    return (\n      <TamboMessageProvider\n        message={minimalMessage}\n        interactableMetadata={{\n          id: interactableId,\n          componentName: config.componentName,\n          description: config.description,\n        }}\n      >\n        <WrappedComponent {...(effectiveProps as ComponentProps)} />\n      </TamboMessageProvider>\n    );\n  };\n\n  TamboInteractableWrapper.displayName = `withTamboInteractable(${displayName})`;\n\n  return TamboInteractableWrapper;\n}\n"]}

package/esm/hooks/use-component-state.d.ts

@@ -11,11 +11,11 @@ type StateUpdateResult<T> = [currentState: T, setState: (newState: T) => void];
  * @param initialValue - Optional initial value for the state, used if no componentState value exists in the Tambo message containing this hook usage.
  * @param setFromProp - Optional value used to set the state value, only while no componentState value exists in the Tambo message containing this hook usage. Use this to allow streaming updates from a prop to the state value.
  * @param debounceTime - Optional debounce time in milliseconds (default: 500ms) to limit API calls.
- * @returns A tuple containing:
- *   - The current state value
- *   - A setter function to update the state (updates UI immediately, debounces server sync)
+ * @returns A tuple of [currentState, setState] similar to React's useState
  * @example
+ * ```tsx
  * const [count, setCount] = useTamboComponentState("counter", 0);
+ * ```
  *
  * Use `setFromProp` to seed state from streamed props. During streaming,
  * state updates as new prop values arrive. Once streaming completes,
@@ -23,11 +23,6 @@ type StateUpdateResult<T> = [currentState: T, setState: (newState: T) => void];
  *
  * Pair with `useTamboStreamStatus` to disable inputs while streaming.
  * @see {@link https://docs.tambo.co/concepts/streaming/streaming-best-practices}
- * @param keyName - Unique key within the message's componentState
- * @param initialValue - Default value if no componentState exists
- * @param setFromProp - Seeds state from props (updates during streaming, then user edits take over)
- * @param debounceTime - Server sync debounce in ms (default: 500)
- * @returns A tuple of [currentState, setState] similar to React's useState
  */
 export declare function useTamboComponentState<S = undefined>(keyName: string, initialValue?: S, setFromProp?: S, debounceTime?: number): StateUpdateResult<S | undefined>;
 export declare function useTamboComponentState<S>(keyName: string, initialValue: S, setFromProp?: S, debounceTime?: number): StateUpdateResult<S>;

package/esm/hooks/use-component-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-component-state.d.ts","sourceRoot":"","sources":["../../src/hooks/use-component-state.tsx"],"names":[],"mappings":"AAOA,KAAK,iBAAiB,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,SAAS,EAClD,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,CAAC,EAChB,WAAW,CAAC,EAAE,CAAC,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,iBAAiB,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;AACpC,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,CAAC,EACf,WAAW,CAAC,EAAE,CAAC,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,iBAAiB,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"use-component-state.d.ts","sourceRoot":"","sources":["../../src/hooks/use-component-state.tsx"],"names":[],"mappings":"AAQA,KAAK,iBAAiB,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,SAAS,EAClD,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,CAAC,EAChB,WAAW,CAAC,EAAE,CAAC,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,iBAAiB,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;AACpC,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,CAAC,EACf,WAAW,CAAC,EAAE,CAAC,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,iBAAiB,CAAC,CAAC,CAAC,CAAC"}

package/esm/hooks/use-component-state.js

@@ -1,4 +1,5 @@
 "use client";
+import { deepEqual } from "fast-equals";
 import { useCallback, useContext, useEffect, useState } from "react";
 import { useDebouncedCallback } from "use-debounce";
 import { useTamboClient, useTamboThread } from "..";
@@ -98,6 +99,13 @@ export function useTamboComponentState(keyName, initialValue, setFromProp, debou
         setInteractableState,
         componentId,
     ]);
+    // Sync from interactable provider to local state when state changes externally (e.g., from Tambo tool call)
+    useEffect(() => {
+        if (!componentId)
+            return;
+        // only update if different
+        setLocalState((prev) => deepEqual(prev, interactableState) ? prev : interactableState);
+    }, [componentId, interactableState]);
     // For editable fields that are set from a prop to allow streaming updates, don't overwrite a fetched state value set from the thread message with prop value on initial load.
     useEffect(() => {
         if (setFromProp !== undefined && !initializedFromThreadMessage) {