@tambo-ai/react 0.67.1 → 0.69.0

package/dist/util/resource-validators.test.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const resource_validators_1 = require("./resource-validators");
+describe("validateResourceSource", () => {
+    it("should throw when has listResources but not getResource", () => {
+        const listResources = async () => [];
+        const getResource = undefined;
+        expect(() => {
+            (0, resource_validators_1.validateResourceSource)(listResources, getResource);
+        }).toThrow("Both listResources and getResource must be provided together, or neither should be provided. " +
+            "Got: listResources=defined, getResource=undefined");
+    });
+    it("should throw when has getResource but not listResources", () => {
+        const listResources = undefined;
+        const getResource = async () => ({
+            contents: [
+                {
+                    uri: "https://resource",
+                    mimeType: "text/plain",
+                    text: "test",
+                },
+            ],
+        });
+        expect(() => {
+            (0, resource_validators_1.validateResourceSource)(listResources, getResource);
+        }).toThrow("Both listResources and getResource must be provided together, or neither should be provided. " +
+            "Got: listResources=undefined, getResource=defined");
+    });
+    it("should not throw when both listResources and getResource are provided", () => {
+        const listResources = async () => [];
+        const getResource = async () => ({
+            contents: [
+                {
+                    uri: "https://resource",
+                    mimeType: "text/plain",
+                    text: "test",
+                },
+            ],
+        });
+        expect(() => {
+            (0, resource_validators_1.validateResourceSource)(listResources, getResource);
+        }).not.toThrow();
+    });
+    it("should not throw when neither listResources nor getResource are provided", () => {
+        const listResources = undefined;
+        const getResource = undefined;
+        expect(() => {
+            (0, resource_validators_1.validateResourceSource)(listResources, getResource);
+        }).not.toThrow();
+    });
+});
+describe("validateResource", () => {
+    it("should throw when resource is missing uri field", () => {
+        const resource = {
+            name: "Test Resource",
+        };
+        expect(() => {
+            (0, resource_validators_1.validateResource)(resource);
+        }).toThrow("Resource must have a 'uri' field");
+    });
+    it("should throw when resource is missing name field", () => {
+        const resource = {
+            uri: "https://resource",
+        };
+        expect(() => {
+            (0, resource_validators_1.validateResource)(resource);
+        }).toThrow("Resource with URI 'https://resource' must have a 'name' field");
+    });
+    it("should not throw when resource has both uri and name fields", () => {
+        const resource = {
+            uri: "https://resource",
+            name: "Test Resource",
+        };
+        expect(() => {
+            (0, resource_validators_1.validateResource)(resource);
+        }).not.toThrow();
+    });
+    it("should not throw when resource has uri, name, and optional fields", () => {
+        const resource = {
+            uri: "https://resource",
+            name: "Test Resource",
+            description: "A test resource",
+            mimeType: "text/plain",
+        };
+        expect(() => {
+            (0, resource_validators_1.validateResource)(resource);
+        }).not.toThrow();
+    });
+});
+//# sourceMappingURL=resource-validators.test.js.map

package/dist/util/resource-validators.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-validators.test.js","sourceRoot":"","sources":["../../src/util/resource-validators.test.ts"],"names":[],"mappings":";;AACA,+DAG+B;AAE/B,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,aAAa,GAAG,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,SAAS,CAAC;QAE9B,MAAM,CAAC,GAAG,EAAE;YACV,IAAA,4CAAsB,EAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC,OAAO,CACR,+FAA+F;YAC7F,mDAAmD,CACtD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,aAAa,GAAG,SAAS,CAAC;QAChC,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC;YAC/B,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,kBAAkB;oBACvB,QAAQ,EAAE,YAAY;oBACtB,IAAI,EAAE,MAAM;iBACb;aACF;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,EAAE;YACV,IAAA,4CAAsB,EAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC,OAAO,CACR,+FAA+F;YAC7F,mDAAmD,CACtD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,aAAa,GAAG,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC;YAC/B,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,kBAAkB;oBACvB,QAAQ,EAAE,YAAY;oBACtB,IAAI,EAAE,MAAM;iBACb;aACF;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,EAAE;YACV,IAAA,4CAAsB,EAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,aAAa,GAAG,SAAS,CAAC;QAChC,MAAM,WAAW,GAAG,SAAS,CAAC;QAE9B,MAAM,CAAC,GAAG,EAAE;YACV,IAAA,4CAAsB,EAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE,eAAe;SACF,CAAC;QAEtB,MAAM,CAAC,GAAG,EAAE;YACV,IAAA,sCAAgB,EAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,QAAQ,GAAG;YACf,GAAG,EAAE,kBAAkB;SACJ,CAAC;QAEtB,MAAM,CAAC,GAAG,EAAE;YACV,IAAA,sCAAgB,EAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC,OAAO,CAAC,+DAA+D,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,QAAQ,GAAqB;YACjC,GAAG,EAAE,kBAAkB;YACvB,IAAI,EAAE,eAAe;SACtB,CAAC;QAEF,MAAM,CAAC,GAAG,EAAE;YACV,IAAA,sCAAgB,EAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,QAAQ,GAAqB;YACjC,GAAG,EAAE,kBAAkB;YACvB,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,iBAAiB;YAC9B,QAAQ,EAAE,YAAY;SACvB,CAAC;QAEF,MAAM,CAAC,GAAG,EAAE;YACV,IAAA,sCAAgB,EAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import type { ListResourceItem } from \"../model/resource-info\";\nimport {\n  validateResource,\n  validateResourceSource,\n} from \"./resource-validators\";\n\ndescribe(\"validateResourceSource\", () => {\n  it(\"should throw when has listResources but not getResource\", () => {\n    const listResources = async () => [];\n    const getResource = undefined;\n\n    expect(() => {\n      validateResourceSource(listResources, getResource);\n    }).toThrow(\n      \"Both listResources and getResource must be provided together, or neither should be provided. \" +\n        \"Got: listResources=defined, getResource=undefined\",\n    );\n  });\n\n  it(\"should throw when has getResource but not listResources\", () => {\n    const listResources = undefined;\n    const getResource = async () => ({\n      contents: [\n        {\n          uri: \"https://resource\",\n          mimeType: \"text/plain\",\n          text: \"test\",\n        },\n      ],\n    });\n\n    expect(() => {\n      validateResourceSource(listResources, getResource);\n    }).toThrow(\n      \"Both listResources and getResource must be provided together, or neither should be provided. \" +\n        \"Got: listResources=undefined, getResource=defined\",\n    );\n  });\n\n  it(\"should not throw when both listResources and getResource are provided\", () => {\n    const listResources = async () => [];\n    const getResource = async () => ({\n      contents: [\n        {\n          uri: \"https://resource\",\n          mimeType: \"text/plain\",\n          text: \"test\",\n        },\n      ],\n    });\n\n    expect(() => {\n      validateResourceSource(listResources, getResource);\n    }).not.toThrow();\n  });\n\n  it(\"should not throw when neither listResources nor getResource are provided\", () => {\n    const listResources = undefined;\n    const getResource = undefined;\n\n    expect(() => {\n      validateResourceSource(listResources, getResource);\n    }).not.toThrow();\n  });\n});\n\ndescribe(\"validateResource\", () => {\n  it(\"should throw when resource is missing uri field\", () => {\n    const resource = {\n      name: \"Test Resource\",\n    } as ListResourceItem;\n\n    expect(() => {\n      validateResource(resource);\n    }).toThrow(\"Resource must have a 'uri' field\");\n  });\n\n  it(\"should throw when resource is missing name field\", () => {\n    const resource = {\n      uri: \"https://resource\",\n    } as ListResourceItem;\n\n    expect(() => {\n      validateResource(resource);\n    }).toThrow(\"Resource with URI 'https://resource' must have a 'name' field\");\n  });\n\n  it(\"should not throw when resource has both uri and name fields\", () => {\n    const resource: ListResourceItem = {\n      uri: \"https://resource\",\n      name: \"Test Resource\",\n    };\n\n    expect(() => {\n      validateResource(resource);\n    }).not.toThrow();\n  });\n\n  it(\"should not throw when resource has uri, name, and optional fields\", () => {\n    const resource: ListResourceItem = {\n      uri: \"https://resource\",\n      name: \"Test Resource\",\n      description: \"A test resource\",\n      mimeType: \"text/plain\",\n    };\n\n    expect(() => {\n      validateResource(resource);\n    }).not.toThrow();\n  });\n});\n"]}

package/dist/util/tool-caller.d.ts

@@ -2,11 +2,11 @@ import TamboAI from "@tambo-ai/typescript-sdk";
 import { TamboTool, TamboToolRegistry, TamboToolWithToolSchema } from "../model/component-metadata";
 /**
  * Process a message from the thread, invoking the appropriate tool and returning the result.
- * @param message - The message to handle
+ * @param toolCallRequest - The message to handle
  * @param toolRegistry - The tool registry
  * @returns The result of the tool call along with the tool definition
  */
-export declare const handleToolCall: (message: TamboAI.Beta.Threads.ThreadMessage, toolRegistry: TamboToolRegistry, onCallUnregisteredTool?: (toolName: string, args: TamboAI.ToolCallParameter[]) => Promise<string>) => Promise<{
+export declare const handleToolCall: (toolCallRequest: TamboAI.ToolCallRequest, toolRegistry: TamboToolRegistry, onCallUnregisteredTool?: (toolName: string, args: TamboAI.ToolCallParameter[]) => Promise<string>) => Promise<{
     result: unknown;
     error?: string;
     tamboTool?: TamboTool | TamboToolWithToolSchema;

package/dist/util/tool-caller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-caller.d.ts","sourceRoot":"","sources":["../../src/util/tool-caller.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAEL,SAAS,EACT,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AAIrC;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,SAAS,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAC3C,cAAc,iBAAiB,EAC/B,yBAAyB,CACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,CAAC,iBAAiB,EAAE,KAC9B,OAAO,CAAC,MAAM,CAAC,KACnB,OAAO,CAAC;IACT,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,GAAG,uBAAuB,CAAC;CACjD,CAmCA,CAAC"}
+{"version":3,"file":"tool-caller.d.ts","sourceRoot":"","sources":["../../src/util/tool-caller.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAEL,SAAS,EACT,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AAIrC;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,iBAAiB,OAAO,CAAC,eAAe,EACxC,cAAc,iBAAiB,EAC/B,yBAAyB,CACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,CAAC,iBAAiB,EAAE,KAC9B,OAAO,CAAC,MAAM,CAAC,KACnB,OAAO,CAAC;IACT,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,GAAG,uBAAuB,CAAC;CACjD,CAiCA,CAAC"}

package/dist/util/tool-caller.js

@@ -5,34 +5,34 @@ const schema_1 = require("../schema");
 const registry_1 = require("./registry");
 /**
  * Process a message from the thread, invoking the appropriate tool and returning the result.
- * @param message - The message to handle
+ * @param toolCallRequest - The message to handle
  * @param toolRegistry - The tool registry
  * @returns The result of the tool call along with the tool definition
  */
-const handleToolCall = async (message, toolRegistry, onCallUnregisteredTool) => {
-    if (!message?.toolCallRequest?.toolName) {
+const handleToolCall = async (toolCallRequest, toolRegistry, onCallUnregisteredTool) => {
+    if (!toolCallRequest?.toolName) {
         throw new Error("Tool name is required");
     }
     try {
-        const { tool, tamboTool } = findTool(message.toolCallRequest.toolName, toolRegistry);
+        const { tool, tamboTool } = findTool(toolCallRequest.toolName, toolRegistry);
         if (!tool) {
             if (onCallUnregisteredTool) {
-                const result = await onCallUnregisteredTool(message.toolCallRequest.toolName, message.toolCallRequest.parameters);
+                const result = await onCallUnregisteredTool(toolCallRequest.toolName, toolCallRequest.parameters);
                 return {
                     result,
                 };
             }
-            throw new Error(`Tool ${message.toolCallRequest.toolName} not found in registry`);
+            throw new Error(`Tool ${toolCallRequest.toolName} not found in registry`);
         }
         return {
-            result: await runToolChoice(message.toolCallRequest, tool, tamboTool),
+            result: await runToolChoice(toolCallRequest, tool, tamboTool),
             tamboTool,
         };
     }
     catch (error) {
         console.error("Error in calling tool: ", error);
         return {
-            result: `When attempting to call tool ${message.toolCallRequest.toolName} the following error occurred: ${error}. Explain to the user that the tool call failed and try again if needed.`,
+            result: `When attempting to call tool ${toolCallRequest.toolName} the following error occurred: ${error}. Explain to the user that the tool call failed and try again if needed.`,
             error: error instanceof Error ? error.message : "Unknown error",
         };
     }

package/dist/util/tool-caller.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-caller.js","sourceRoot":"","sources":["../../src/util/tool-caller.ts"],"names":[],"mappings":";;;AAOA,sCAA2C;AAC3C,yCAAuD;AAEvD;;;;;GAKG;AACI,MAAM,cAAc,GAAG,KAAK,EACjC,OAA2C,EAC3C,YAA+B,EAC/B,sBAGoB,EAKnB,EAAE;IACH,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,QAAQ,CAClC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAChC,YAAY,CACb,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,sBAAsB,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAChC,OAAO,CAAC,eAAe,CAAC,UAAU,CACnC,CAAC;gBACF,OAAO;oBACL,MAAM;iBACP,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,KAAK,CACb,QAAQ,OAAO,CAAC,eAAe,CAAC,QAAQ,wBAAwB,CACjE,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,MAAM,aAAa,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;YACrE,SAAS;SACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO;YACL,MAAM,EAAE,gCAAgC,OAAO,CAAC,eAAe,CAAC,QAAQ,kCAAkC,KAAK,0EAA0E;YACzL,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AA9CW,QAAA,cAAc,kBA8CzB;AAEF,MAAM,QAAQ,GAAG,CACf,QAAgB,EAChB,YAA+B,EAMG,EAAE;IACpC,MAAM,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE5C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,WAAW,GAAG,IAAA,oCAAyB,EAAC,YAAY,CAAC,CAAC;IAC5D,OAAO;QACL,IAAI,EAAE;YACJ,mBAAmB,EAAE,YAAY,CAAC,IAAI;YACtC,UAAU,EAAE,WAAW;SACxB;QACD,SAAS,EAAE,YAAY;KACxB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,KAAK,EACzB,eAAwC,EACxC,IAA0B,EAC1B,SAA8C,EAC5B,EAAE;IACpB,MAAM,UAAU,GAAG,eAAe,CAAC,UAAU,IAAI,EAAE,CAAC;IAEpD,2DAA2D;IAC3D,IAAI,IAAA,uBAAc,EAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,yDAAyD;QACzD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CACpC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CACvE,CAAC;QACF,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;IAED,iEAAiE;IACjE,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACxE,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,GAAG,eAAe,CAAC,CAAC;AAC5D,CAAC,CAAC","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport {\n  ComponentContextTool,\n  TamboTool,\n  TamboToolRegistry,\n  TamboToolWithToolSchema,\n} from \"../model/component-metadata\";\nimport { hasInputSchema } from \"../schema\";\nimport { mapTamboToolToContextTool } from \"./registry\";\n\n/**\n * Process a message from the thread, invoking the appropriate tool and returning the result.\n * @param message - The message to handle\n * @param toolRegistry - The tool registry\n * @returns The result of the tool call along with the tool definition\n */\nexport const handleToolCall = async (\n  message: TamboAI.Beta.Threads.ThreadMessage,\n  toolRegistry: TamboToolRegistry,\n  onCallUnregisteredTool?: (\n    toolName: string,\n    args: TamboAI.ToolCallParameter[],\n  ) => Promise<string>,\n): Promise<{\n  result: unknown;\n  error?: string;\n  tamboTool?: TamboTool | TamboToolWithToolSchema;\n}> => {\n  if (!message?.toolCallRequest?.toolName) {\n    throw new Error(\"Tool name is required\");\n  }\n\n  try {\n    const { tool, tamboTool } = findTool(\n      message.toolCallRequest.toolName,\n      toolRegistry,\n    );\n    if (!tool) {\n      if (onCallUnregisteredTool) {\n        const result = await onCallUnregisteredTool(\n          message.toolCallRequest.toolName,\n          message.toolCallRequest.parameters,\n        );\n        return {\n          result,\n        };\n      }\n      throw new Error(\n        `Tool ${message.toolCallRequest.toolName} not found in registry`,\n      );\n    }\n    return {\n      result: await runToolChoice(message.toolCallRequest, tool, tamboTool),\n      tamboTool,\n    };\n  } catch (error) {\n    console.error(\"Error in calling tool: \", error);\n    return {\n      result: `When attempting to call tool ${message.toolCallRequest.toolName} the following error occurred: ${error}. Explain to the user that the tool call failed and try again if needed.`,\n      error: error instanceof Error ? error.message : \"Unknown error\",\n    };\n  }\n};\n\nconst findTool = (\n  toolName: string,\n  toolRegistry: TamboToolRegistry,\n):\n  | {\n      tool: ComponentContextTool;\n      tamboTool: TamboTool | TamboToolWithToolSchema;\n    }\n  | { tool: null; tamboTool: null } => {\n  const registryTool = toolRegistry[toolName];\n\n  if (!registryTool) {\n    return { tool: null, tamboTool: null };\n  }\n\n  const contextTool = mapTamboToolToContextTool(registryTool);\n  return {\n    tool: {\n      getComponentContext: registryTool.tool,\n      definition: contextTool,\n    },\n    tamboTool: registryTool,\n  };\n};\n\nconst runToolChoice = async (\n  toolCallRequest: TamboAI.ToolCallRequest,\n  tool: ComponentContextTool,\n  tamboTool: TamboTool | TamboToolWithToolSchema,\n): Promise<unknown> => {\n  const parameters = toolCallRequest.parameters ?? [];\n\n  // New interface (inputSchema): pass single object argument\n  if (hasInputSchema(tamboTool)) {\n    // Reconstruct the object from parameter name-value pairs\n    const inputObject = Object.fromEntries(\n      parameters.map((param) => [param.parameterName, param.parameterValue]),\n    );\n    return await tool.getComponentContext(inputObject);\n  }\n\n  // Deprecated interface (toolSchema): spread positional arguments\n  const parameterValues = parameters.map((param) => param.parameterValue);\n  return await tool.getComponentContext(...parameterValues);\n};\n"]}
+{"version":3,"file":"tool-caller.js","sourceRoot":"","sources":["../../src/util/tool-caller.ts"],"names":[],"mappings":";;;AAOA,sCAA2C;AAC3C,yCAAuD;AAEvD;;;;;GAKG;AACI,MAAM,cAAc,GAAG,KAAK,EACjC,eAAwC,EACxC,YAA+B,EAC/B,sBAGoB,EAKnB,EAAE;IACH,IAAI,CAAC,eAAe,EAAE,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,QAAQ,CAClC,eAAe,CAAC,QAAQ,EACxB,YAAY,CACb,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,sBAAsB,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,eAAe,CAAC,QAAQ,EACxB,eAAe,CAAC,UAAU,CAC3B,CAAC;gBACF,OAAO;oBACL,MAAM;iBACP,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,QAAQ,eAAe,CAAC,QAAQ,wBAAwB,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO;YACL,MAAM,EAAE,MAAM,aAAa,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;YAC7D,SAAS;SACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO;YACL,MAAM,EAAE,gCAAgC,eAAe,CAAC,QAAQ,kCAAkC,KAAK,0EAA0E;YACjL,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AA5CW,QAAA,cAAc,kBA4CzB;AAEF,MAAM,QAAQ,GAAG,CACf,QAAgB,EAChB,YAA+B,EAMG,EAAE;IACpC,MAAM,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE5C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,WAAW,GAAG,IAAA,oCAAyB,EAAC,YAAY,CAAC,CAAC;IAC5D,OAAO;QACL,IAAI,EAAE;YACJ,mBAAmB,EAAE,YAAY,CAAC,IAAI;YACtC,UAAU,EAAE,WAAW;SACxB;QACD,SAAS,EAAE,YAAY;KACxB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,KAAK,EACzB,eAAwC,EACxC,IAA0B,EAC1B,SAA8C,EAC5B,EAAE;IACpB,MAAM,UAAU,GAAG,eAAe,CAAC,UAAU,IAAI,EAAE,CAAC;IAEpD,2DAA2D;IAC3D,IAAI,IAAA,uBAAc,EAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,yDAAyD;QACzD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CACpC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CACvE,CAAC;QACF,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;IAED,iEAAiE;IACjE,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACxE,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,GAAG,eAAe,CAAC,CAAC;AAC5D,CAAC,CAAC","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport {\n  ComponentContextTool,\n  TamboTool,\n  TamboToolRegistry,\n  TamboToolWithToolSchema,\n} from \"../model/component-metadata\";\nimport { hasInputSchema } from \"../schema\";\nimport { mapTamboToolToContextTool } from \"./registry\";\n\n/**\n * Process a message from the thread, invoking the appropriate tool and returning the result.\n * @param toolCallRequest - The message to handle\n * @param toolRegistry - The tool registry\n * @returns The result of the tool call along with the tool definition\n */\nexport const handleToolCall = async (\n  toolCallRequest: TamboAI.ToolCallRequest,\n  toolRegistry: TamboToolRegistry,\n  onCallUnregisteredTool?: (\n    toolName: string,\n    args: TamboAI.ToolCallParameter[],\n  ) => Promise<string>,\n): Promise<{\n  result: unknown;\n  error?: string;\n  tamboTool?: TamboTool | TamboToolWithToolSchema;\n}> => {\n  if (!toolCallRequest?.toolName) {\n    throw new Error(\"Tool name is required\");\n  }\n\n  try {\n    const { tool, tamboTool } = findTool(\n      toolCallRequest.toolName,\n      toolRegistry,\n    );\n    if (!tool) {\n      if (onCallUnregisteredTool) {\n        const result = await onCallUnregisteredTool(\n          toolCallRequest.toolName,\n          toolCallRequest.parameters,\n        );\n        return {\n          result,\n        };\n      }\n      throw new Error(`Tool ${toolCallRequest.toolName} not found in registry`);\n    }\n    return {\n      result: await runToolChoice(toolCallRequest, tool, tamboTool),\n      tamboTool,\n    };\n  } catch (error) {\n    console.error(\"Error in calling tool: \", error);\n    return {\n      result: `When attempting to call tool ${toolCallRequest.toolName} the following error occurred: ${error}. Explain to the user that the tool call failed and try again if needed.`,\n      error: error instanceof Error ? error.message : \"Unknown error\",\n    };\n  }\n};\n\nconst findTool = (\n  toolName: string,\n  toolRegistry: TamboToolRegistry,\n):\n  | {\n      tool: ComponentContextTool;\n      tamboTool: TamboTool | TamboToolWithToolSchema;\n    }\n  | { tool: null; tamboTool: null } => {\n  const registryTool = toolRegistry[toolName];\n\n  if (!registryTool) {\n    return { tool: null, tamboTool: null };\n  }\n\n  const contextTool = mapTamboToolToContextTool(registryTool);\n  return {\n    tool: {\n      getComponentContext: registryTool.tool,\n      definition: contextTool,\n    },\n    tamboTool: registryTool,\n  };\n};\n\nconst runToolChoice = async (\n  toolCallRequest: TamboAI.ToolCallRequest,\n  tool: ComponentContextTool,\n  tamboTool: TamboTool | TamboToolWithToolSchema,\n): Promise<unknown> => {\n  const parameters = toolCallRequest.parameters ?? [];\n\n  // New interface (inputSchema): pass single object argument\n  if (hasInputSchema(tamboTool)) {\n    // Reconstruct the object from parameter name-value pairs\n    const inputObject = Object.fromEntries(\n      parameters.map((param) => [param.parameterName, param.parameterValue]),\n    );\n    return await tool.getComponentContext(inputObject);\n  }\n\n  // Deprecated interface (toolSchema): spread positional arguments\n  const parameterValues = parameters.map((param) => param.parameterValue);\n  return await tool.getComponentContext(...parameterValues);\n};\n"]}

package/dist/util/validate-component-name.test.d.ts

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

package/dist/util/validate-component-name.test.d.ts.map

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

package/dist/util/validate-component-name.test.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const validate_component_name_1 = require("./validate-component-name");
+describe("assertValidName", () => {
+    // Valid names
+    it("should not throw an error for a valid name with letters only", () => {
+        expect(() => (0, validate_component_name_1.assertValidName)("MyComponent", "component")).not.toThrow();
+    });
+    it("should not throw an error for letters, numbers, underscore", () => {
+        expect(() => (0, validate_component_name_1.assertValidName)("component_123", "component")).not.toThrow();
+    });
+    it("should not throw an error for letters, numbers, hyphen", () => {
+        expect(() => (0, validate_component_name_1.assertValidName)("tool-456", "tool")).not.toThrow();
+    });
+    it("should not throw an error for mix of letters, numbers, underscores, hyphens", () => {
+        expect(() => (0, validate_component_name_1.assertValidName)("A1_b-2C", "component")).not.toThrow();
+    });
+    it("should not throw an error with single underscore, and hyphen", () => {
+        expect(() => (0, validate_component_name_1.assertValidName)("_", "tool")).not.toThrow();
+        expect(() => (0, validate_component_name_1.assertValidName)("-", "tool")).not.toThrow();
+    });
+    // Invalid names
+    it("should throw an error for name with space", () => {
+        expect(() => (0, validate_component_name_1.assertValidName)("My Component", "component")).toThrow(`component "My Component" must only contain letters, numbers, underscores, and hyphens.`);
+    });
+    it("should throw an error for name with special characters", () => {
+        expect(() => (0, validate_component_name_1.assertValidName)("tool@123", "tool")).toThrow(`tool "tool@123" must only contain letters, numbers, underscores, and hyphens.`);
+        expect(() => (0, validate_component_name_1.assertValidName)("component!$", "component")).toThrow(`component "component!$" must only contain letters, numbers, underscores, and hyphens.`);
+    });
+    // Edge Cases
+    it("should throw an error for name with empty string", () => {
+        expect(() => (0, validate_component_name_1.assertValidName)("", "component")).toThrow(`component "" must only contain letters, numbers, underscores, and hyphens.`);
+    });
+});
+//# sourceMappingURL=validate-component-name.test.js.map

package/dist/util/validate-component-name.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-component-name.test.js","sourceRoot":"","sources":["../../src/util/validate-component-name.test.ts"],"names":[],"mappings":";;AAAA,uEAA4D;AAC5D,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,cAAc;IACd,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,yCAAe,EAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC1E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,yCAAe,EAAC,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC5E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,yCAAe,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,yCAAe,EAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACtE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,yCAAe,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACzD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,yCAAe,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC3D,CAAC,CAAC,CAAC;IACH,gBAAgB;IAChB,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,yCAAe,EAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAChE,wFAAwF,CACzF,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,yCAAe,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CACvD,+EAA+E,CAChF,CAAC;QACF,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,yCAAe,EAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAC/D,uFAAuF,CACxF,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,aAAa;IACb,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,yCAAe,EAAC,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CACpD,4EAA4E,CAC7E,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { assertValidName } from \"./validate-component-name\";\ndescribe(\"assertValidName\", () => {\n  // Valid names\n  it(\"should not throw an error for a valid name with letters only\", () => {\n    expect(() => assertValidName(\"MyComponent\", \"component\")).not.toThrow();\n  });\n  it(\"should not throw an error for letters, numbers, underscore\", () => {\n    expect(() => assertValidName(\"component_123\", \"component\")).not.toThrow();\n  });\n  it(\"should not throw an error for letters, numbers, hyphen\", () => {\n    expect(() => assertValidName(\"tool-456\", \"tool\")).not.toThrow();\n  });\n  it(\"should not throw an error for mix of letters, numbers, underscores, hyphens\", () => {\n    expect(() => assertValidName(\"A1_b-2C\", \"component\")).not.toThrow();\n  });\n  it(\"should not throw an error with single underscore, and hyphen\", () => {\n    expect(() => assertValidName(\"_\", \"tool\")).not.toThrow();\n    expect(() => assertValidName(\"-\", \"tool\")).not.toThrow();\n  });\n  // Invalid names\n  it(\"should throw an error for name with space\", () => {\n    expect(() => assertValidName(\"My Component\", \"component\")).toThrow(\n      `component \"My Component\" must only contain letters, numbers, underscores, and hyphens.`,\n    );\n  });\n  it(\"should throw an error for name with special characters\", () => {\n    expect(() => assertValidName(\"tool@123\", \"tool\")).toThrow(\n      `tool \"tool@123\" must only contain letters, numbers, underscores, and hyphens.`,\n    );\n    expect(() => assertValidName(\"component!$\", \"component\")).toThrow(\n      `component \"component!$\" must only contain letters, numbers, underscores, and hyphens.`,\n    );\n  });\n  // Edge Cases\n  it(\"should throw an error for name with empty string\", () => {\n    expect(() => assertValidName(\"\", \"component\")).toThrow(\n      `component \"\" must only contain letters, numbers, underscores, and hyphens.`,\n    );\n  });\n});\n"]}

package/esm/context-helpers/context-helpers.test.js

@@ -11,11 +11,17 @@ describe("Context Helpers (prebuilt functions)", () => {
             const context = currentTimeContextHelper();
             // Should not be null (error case)
             expect(context).not.toBeNull();
+            // Type guard: ensure context is an object
+            expect(typeof context).toBe("object");
+            if (typeof context !== "object" || context === null) {
+                throw new Error("Expected context to be a non-null object");
+            }
             // Shape: { timestamp: string }
             expect(context).toHaveProperty("timestamp");
-            expect(typeof context.timestamp).toBe("string");
+            const contextObj = context;
+            expect(typeof contextObj.timestamp).toBe("string");
             // Verify timestamp string parses
-            expect(() => new Date(context.timestamp)).not.toThrow();
+            expect(() => new Date(contextObj.timestamp)).not.toThrow();
         });
     });
     describe("currentPageContextHelper", () => {
@@ -26,11 +32,17 @@ describe("Context Helpers (prebuilt functions)", () => {
                 expect(context).toBeNull();
                 return;
             }
+            // Type guard: ensure context is an object
+            expect(typeof context).toBe("object");
+            if (typeof context !== "object") {
+                throw new Error("Expected context to be an object");
+            }
             // Shape: { url: string, title: string }
             expect(context).toHaveProperty("url");
             expect(context).toHaveProperty("title");
-            expect(typeof context.url).toBe("string");
-            expect(typeof context.title).toBe("string");
+            const contextObj = context;
+            expect(typeof contextObj.url).toBe("string");
+            expect(typeof contextObj.title).toBe("string");
         });
     });
 });

package/esm/context-helpers/context-helpers.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-helpers.test.js","sourceRoot":"","sources":["../../src/context-helpers/context-helpers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAE7E;;;;;GAKG;AACH,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IACpD,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACxC,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D,MAAM,OAAO,GAAG,wBAAwB,EAAE,CAAC;YAE3C,kCAAkC;YAClC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAE/B,+BAA+B;YAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;YAC5C,MAAM,CAAC,OAAO,OAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEjD,iCAAiC;YACjC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,OAAQ,CAAC,SAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACxC,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;YAClE,MAAM,OAAO,GAAG,wBAAwB,EAAE,CAAC;YAE3C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,sDAAsD;gBACtD,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC3B,OAAO;YACT,CAAC;YAED,wCAAwC;YACxC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACtC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAExC,MAAM,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { currentPageContextHelper, currentTimeContextHelper } from \"./index\";\n\n/**\n * Tests for prebuilt context helper functions.\n *\n * These helpers now return raw values (or null) instead of { name, context }.\n * The provider is responsible for wrapping values as { name, context }.\n */\ndescribe(\"Context Helpers (prebuilt functions)\", () => {\n  describe(\"currentTimeContextHelper\", () => {\n    it(\"should return user time context with required fields\", () => {\n      const context = currentTimeContextHelper();\n\n      // Should not be null (error case)\n      expect(context).not.toBeNull();\n\n      // Shape: { timestamp: string }\n      expect(context).toHaveProperty(\"timestamp\");\n      expect(typeof context!.timestamp).toBe(\"string\");\n\n      // Verify timestamp string parses\n      expect(() => new Date(context!.timestamp as string)).not.toThrow();\n    });\n  });\n\n  describe(\"currentPageContextHelper\", () => {\n    it(\"should return page context in browser, or null otherwise\", () => {\n      const context = currentPageContextHelper();\n\n      if (context === null) {\n        // Non-browser environments should return null to skip\n        expect(context).toBeNull();\n        return;\n      }\n\n      // Shape: { url: string, title: string }\n      expect(context).toHaveProperty(\"url\");\n      expect(context).toHaveProperty(\"title\");\n\n      expect(typeof context.url).toBe(\"string\");\n      expect(typeof context.title).toBe(\"string\");\n    });\n  });\n});\n"]}
+{"version":3,"file":"context-helpers.test.js","sourceRoot":"","sources":["../../src/context-helpers/context-helpers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAE7E;;;;;GAKG;AACH,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IACpD,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACxC,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D,MAAM,OAAO,GAAG,wBAAwB,EAAE,CAAC;YAE3C,kCAAkC;YAClC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAE/B,0CAA0C;YAC1C,MAAM,CAAC,OAAO,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACpD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAC9D,CAAC;YAED,+BAA+B;YAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;YAC5C,MAAM,UAAU,GAAG,OAAkC,CAAC;YACtD,MAAM,CAAC,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEnD,iCAAiC;YACjC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACxC,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;YAClE,MAAM,OAAO,GAAG,wBAAwB,EAAE,CAAC;YAE3C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,sDAAsD;gBACtD,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC3B,OAAO;YACT,CAAC;YAED,0CAA0C;YAC1C,MAAM,CAAC,OAAO,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YACtD,CAAC;YAED,wCAAwC;YACxC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACtC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAExC,MAAM,UAAU,GAAG,OAAkC,CAAC;YACtD,MAAM,CAAC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { currentPageContextHelper, currentTimeContextHelper } from \"./index\";\n\n/**\n * Tests for prebuilt context helper functions.\n *\n * These helpers now return raw values (or null) instead of { name, context }.\n * The provider is responsible for wrapping values as { name, context }.\n */\ndescribe(\"Context Helpers (prebuilt functions)\", () => {\n  describe(\"currentTimeContextHelper\", () => {\n    it(\"should return user time context with required fields\", () => {\n      const context = currentTimeContextHelper();\n\n      // Should not be null (error case)\n      expect(context).not.toBeNull();\n\n      // Type guard: ensure context is an object\n      expect(typeof context).toBe(\"object\");\n      if (typeof context !== \"object\" || context === null) {\n        throw new Error(\"Expected context to be a non-null object\");\n      }\n\n      // Shape: { timestamp: string }\n      expect(context).toHaveProperty(\"timestamp\");\n      const contextObj = context as Record<string, unknown>;\n      expect(typeof contextObj.timestamp).toBe(\"string\");\n\n      // Verify timestamp string parses\n      expect(() => new Date(contextObj.timestamp as string)).not.toThrow();\n    });\n  });\n\n  describe(\"currentPageContextHelper\", () => {\n    it(\"should return page context in browser, or null otherwise\", () => {\n      const context = currentPageContextHelper();\n\n      if (context === null) {\n        // Non-browser environments should return null to skip\n        expect(context).toBeNull();\n        return;\n      }\n\n      // Type guard: ensure context is an object\n      expect(typeof context).toBe(\"object\");\n      if (typeof context !== \"object\") {\n        throw new Error(\"Expected context to be an object\");\n      }\n\n      // Shape: { url: string, title: string }\n      expect(context).toHaveProperty(\"url\");\n      expect(context).toHaveProperty(\"title\");\n\n      const contextObj = context as Record<string, unknown>;\n      expect(typeof contextObj.url).toBe(\"string\");\n      expect(typeof contextObj.title).toBe(\"string\");\n    });\n  });\n});\n"]}

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

@@ -22,7 +22,7 @@ export declare const currentInteractablesContextHelper: ContextHelperFn;
  * Creates an interactables context helper with access to the current components.
  * This is used internally by TamboInteractableProvider.
  * @param components Array of interactable components
- * @returns Context helper function
+ * @returns A context helper function that returns component metadata or null if no components exist
  */
-export declare const createInteractablesContextHelper: (components: any[]) => ContextHelperFn;
+export declare const createInteractablesContextHelper: (components: unknown[]) => ContextHelperFn;
 //# sourceMappingURL=current-interactables-context-helper.d.ts.map

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,OAAO,EAAE,KACpB,eAyCF,CAAC"}

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

@@ -25,7 +25,7 @@ export const currentInteractablesContextHelper = () => {
  * Creates an interactables context helper with access to the current components.
  * This is used internally by TamboInteractableProvider.
  * @param components Array of interactable components
- * @returns Context helper function
+ * @returns A context helper function that returns component metadata or null if no components exist
  */
 export const createInteractablesContextHelper = (components) => {
     return () => {
@@ -33,17 +33,36 @@ 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.",
-            components: components.map((component) => ({
-                id: component.id,
-                componentName: component.name,
-                description: component.description,
-                props: component.props,
-                propsSchema: component.propsSchema
-                    ? "Available - use component-specific update tools"
-                    : "Not specified",
-                state: component.state,
-            })),
+            components: components.map((component) => {
+                // Type guard: ensure component is an object with the expected properties
+                if (typeof component !== "object" || component === null) {
+                    return {
+                        id: "unknown",
+                        componentName: "unknown",
+                        description: "invalid component",
+                        props: undefined,
+                        propsSchema: "Not specified",
+                        state: undefined,
+                        isSelectedForInteraction: false,
+                        stateSchema: "Not specified",
+                    };
+                }
+                const comp = component;
+                return {
+                    id: String(comp.id ?? "unknown"),
+                    componentName: String(comp.name ?? "unknown"),
+                    description: String(comp.description ?? ""),
+                    props: comp.props,
+                    propsSchema: comp.propsSchema
+                        ? "Available - use component-specific update tools"
+                        : "Not specified",
+                    state: comp.state,
+                    isSelectedForInteraction: comp.isSelectedForInteraction ?? false,
+                    stateSchema: comp.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,UAAqB,EACJ,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,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;gBACvC,yEAAyE;gBACzE,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;oBACxD,OAAO;wBACL,EAAE,EAAE,SAAS;wBACb,aAAa,EAAE,SAAS;wBACxB,WAAW,EAAE,mBAAmB;wBAChC,KAAK,EAAE,SAAS;wBAChB,WAAW,EAAE,eAAe;wBAC5B,KAAK,EAAE,SAAS;wBAChB,wBAAwB,EAAE,KAAK;wBAC/B,WAAW,EAAE,eAAe;qBAC7B,CAAC;gBACJ,CAAC;gBAED,MAAM,IAAI,GAAG,SAAoC,CAAC;gBAClD,OAAO;oBACL,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,SAAS,CAAC;oBAChC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC;oBAC7C,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;oBAC3C,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,WAAW,EAAE,IAAI,CAAC,WAAW;wBAC3B,CAAC,CAAC,iDAAiD;wBACnD,CAAC,CAAC,eAAe;oBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,wBAAwB,EACrB,IAAI,CAAC,wBAAgD,IAAI,KAAK;oBACjE,WAAW,EAAE,IAAI,CAAC,WAAW;wBAC3B,CAAC,CAAC,iDAAiD;wBACnD,CAAC,CAAC,eAAe;iBACpB,CAAC;YACJ,CAAC,CAAC;SACH,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 A context helper function that returns component metadata or null if no components exist\n */\nexport const createInteractablesContextHelper = (\n  components: unknown[],\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      components: components.map((component) => {\n        // Type guard: ensure component is an object with the expected properties\n        if (typeof component !== \"object\" || component === null) {\n          return {\n            id: \"unknown\",\n            componentName: \"unknown\",\n            description: \"invalid component\",\n            props: undefined,\n            propsSchema: \"Not specified\",\n            state: undefined,\n            isSelectedForInteraction: false,\n            stateSchema: \"Not specified\",\n          };\n        }\n\n        const comp = component as Record<string, unknown>;\n        return {\n          id: String(comp.id ?? \"unknown\"),\n          componentName: String(comp.name ?? \"unknown\"),\n          description: String(comp.description ?? \"\"),\n          props: comp.props,\n          propsSchema: comp.propsSchema\n            ? \"Available - use component-specific update tools\"\n            : \"Not specified\",\n          state: comp.state,\n          isSelectedForInteraction:\n            (comp.isSelectedForInteraction as boolean | undefined) ?? false,\n          stateSchema: comp.stateSchema\n            ? \"Available - use component-specific update tools\"\n            : \"Not specified\",\n        };\n      }),\n    };\n  };\n};\n"]}

package/esm/context-helpers/registry.d.ts

@@ -2,13 +2,13 @@
  * Global context helpers registry.
  * Consumers can add/remove helpers and resolve additional context anywhere.
  */
-export type HelperFn = () => any | null | undefined | Promise<any | null | undefined>;
+export type HelperFn = () => unknown | null | undefined | Promise<unknown | null | undefined>;
 /**
  * Resolve all helpers to AdditionalContext entries, skipping null/undefined and errors.
  * @returns The resolved additional context.
  */
 export declare function resolveAdditionalContext(helpers: Record<string, HelperFn>): Promise<{
     name: string;
-    context: any;
+    context: unknown;
 }[]>;
 //# sourceMappingURL=registry.d.ts.map

package/esm/context-helpers/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/context-helpers/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,MACnB,GAAG,GACH,IAAI,GACJ,SAAS,GACT,OAAO,CAAC,GAAG,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEpC;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAChC,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,EAAE,CAAC,CAkB3C"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/context-helpers/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,MACnB,OAAO,GACP,IAAI,GACJ,SAAS,GACT,OAAO,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAExC;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAChC,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAAE,CAAC,CAkB/C"}

package/esm/context-helpers/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/context-helpers/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAiC;IAEjC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QAC/B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,EAAE,EAAE,CAAC;YACzB,IAAI,KAAK,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC;YAC/B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAqC,CAAC;AACrE,CAAC","sourcesContent":["/**\n * Global context helpers registry.\n * Consumers can add/remove helpers and resolve additional context anywhere.\n */\n\nexport type HelperFn = () =>\n  | any\n  | null\n  | undefined\n  | Promise<any | null | undefined>;\n\n/**\n * Resolve all helpers to AdditionalContext entries, skipping null/undefined and errors.\n * @returns The resolved additional context.\n */\nexport async function resolveAdditionalContext(\n  helpers: Record<string, HelperFn>,\n): Promise<{ name: string; context: any }[]> {\n  const entries = Object.entries(helpers);\n  if (entries.length === 0) return [];\n\n  const results = await Promise.all(\n    entries.map(async ([name, fn]) => {\n      try {\n        const value = await fn();\n        if (value == null) return null;\n        return { name, context: value };\n      } catch (error) {\n        console.error(`Error running context helper ${name}:`, error);\n        return null;\n      }\n    }),\n  );\n\n  return results.filter(Boolean) as { name: string; context: any }[];\n}\n"]}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/context-helpers/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAiC;IAEjC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QAC/B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,EAAE,EAAE,CAAC;YACzB,IAAI,KAAK,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC;YAC/B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAyC,CAAC;AACzE,CAAC","sourcesContent":["/**\n * Global context helpers registry.\n * Consumers can add/remove helpers and resolve additional context anywhere.\n */\n\nexport type HelperFn = () =>\n  | unknown\n  | null\n  | undefined\n  | Promise<unknown | null | undefined>;\n\n/**\n * Resolve all helpers to AdditionalContext entries, skipping null/undefined and errors.\n * @returns The resolved additional context.\n */\nexport async function resolveAdditionalContext(\n  helpers: Record<string, HelperFn>,\n): Promise<{ name: string; context: unknown }[]> {\n  const entries = Object.entries(helpers);\n  if (entries.length === 0) return [];\n\n  const results = await Promise.all(\n    entries.map(async ([name, fn]) => {\n      try {\n        const value = await fn();\n        if (value == null) return null;\n        return { name, context: value };\n      } catch (error) {\n        console.error(`Error running context helper ${name}:`, error);\n        return null;\n      }\n    }),\n  );\n\n  return results.filter(Boolean) as { name: string; context: unknown }[];\n}\n"]}

package/esm/context-helpers/types.d.ts

@@ -5,13 +5,13 @@ export interface AdditionalContext {
     /** The name of the context type */
     name: string;
     /** The context data */
-    context: any;
+    context: unknown;
 }
 /**
  * A context helper is a function that returns data to include in the context,
  * or null/undefined to skip including anything.
  */
-export type ContextHelperFn = () => any | null | undefined | Promise<any | null | undefined>;
+export type ContextHelperFn = () => unknown | null | undefined | Promise<unknown | null | undefined>;
 /**
  * A collection of context helpers keyed by their context name.
  * The key becomes the AdditionalContext.name sent to the model.

package/esm/context-helpers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context-helpers/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,OAAO,EAAE,GAAG,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAC1B,GAAG,GACH,IAAI,GACJ,SAAS,GACT,OAAO,CAAC,GAAG,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEpC;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context-helpers/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAC1B,OAAO,GACP,IAAI,GACJ,SAAS,GACT,OAAO,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC"}

package/esm/context-helpers/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/context-helpers/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Interface for additional context that can be added to messages\n */\nexport interface AdditionalContext {\n  /** The name of the context type */\n  name: string;\n  /** The context data */\n  context: any;\n}\n\n/**\n * A context helper is a function that returns data to include in the context,\n * or null/undefined to skip including anything.\n */\nexport type ContextHelperFn = () =>\n  | any\n  | null\n  | undefined\n  | Promise<any | null | undefined>;\n\n/**\n * A collection of context helpers keyed by their context name.\n * The key becomes the AdditionalContext.name sent to the model.\n */\nexport type ContextHelpers = Record<string, ContextHelperFn>;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/context-helpers/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Interface for additional context that can be added to messages\n */\nexport interface AdditionalContext {\n  /** The name of the context type */\n  name: string;\n  /** The context data */\n  context: unknown;\n}\n\n/**\n * A context helper is a function that returns data to include in the context,\n * or null/undefined to skip including anything.\n */\nexport type ContextHelperFn = () =>\n  | unknown\n  | null\n  | undefined\n  | Promise<unknown | null | undefined>;\n\n/**\n * A collection of context helpers keyed by their context name.\n * The key becomes the AdditionalContext.name sent to the model.\n */\nexport type ContextHelpers = Record<string, ContextHelperFn>;\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"}