@tambo-ai/react 0.57.0 → 0.58.0

package/esm/util/content-parts.js

@@ -0,0 +1,35 @@
+/**
+ * Narrow a value to a ChatCompletionContentPart by checking for an object with string `type`.
+ * We purposefully keep this guard permissive to support future part types.
+ * @returns true if the value looks like a content part
+ */
+export function isContentPart(val) {
+    return (!!val &&
+        typeof val === "object" &&
+        "type" in val &&
+        typeof val.type === "string");
+}
+/**
+ * Type guard for arrays of content parts.
+ * @returns true if the value is an array of content parts
+ */
+export function isContentPartArray(val) {
+    return Array.isArray(val) && val.every((item) => isContentPart(item));
+}
+/**
+ * Safely convert an unknown value to a string suitable for a `{ type: "text" }` content part.
+ * Guarantees a string and avoids throwing on circular structures.
+ * @returns The string representation of the value
+ */
+export function toText(val) {
+    if (typeof val === "string")
+        return val;
+    try {
+        const json = JSON.stringify(val);
+        return json ?? String(val);
+    }
+    catch {
+        return String(val);
+    }
+}
+//# sourceMappingURL=content-parts.js.map

package/esm/util/content-parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-parts.js","sourceRoot":"","sources":["../../src/util/content-parts.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAY;IAEZ,OAAO,CACL,CAAC,CAAC,GAAG;QACL,OAAO,GAAG,KAAK,QAAQ;QACvB,MAAM,IAAK,GAAW;QACtB,OAAQ,GAAW,CAAC,IAAI,KAAK,QAAQ,CACtC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAY;IAEZ,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,GAAY;IACjC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC","sourcesContent":["import type TamboAI from \"@tambo-ai/typescript-sdk\";\n\n/**\n * Narrow a value to a ChatCompletionContentPart by checking for an object with string `type`.\n * We purposefully keep this guard permissive to support future part types.\n * @returns true if the value looks like a content part\n */\nexport function isContentPart(\n  val: unknown,\n): val is TamboAI.Beta.Threads.ChatCompletionContentPart {\n  return (\n    !!val &&\n    typeof val === \"object\" &&\n    \"type\" in (val as any) &&\n    typeof (val as any).type === \"string\"\n  );\n}\n\n/**\n * Type guard for arrays of content parts.\n * @returns true if the value is an array of content parts\n */\nexport function isContentPartArray(\n  val: unknown,\n): val is TamboAI.Beta.Threads.ChatCompletionContentPart[] {\n  return Array.isArray(val) && val.every((item) => isContentPart(item));\n}\n\n/**\n * Safely convert an unknown value to a string suitable for a `{ type: \"text\" }` content part.\n * Guarantees a string and avoids throwing on circular structures.\n * @returns The string representation of the value\n */\nexport function toText(val: unknown): string {\n  if (typeof val === \"string\") return val;\n  try {\n    const json = JSON.stringify(val);\n    return json ?? String(val);\n  } catch {\n    return String(val);\n  }\n}\n"]}

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

@@ -1,13 +1,14 @@
 import TamboAI from "@tambo-ai/typescript-sdk";
-import { TamboToolRegistry } from "../model/component-metadata";
+import { TamboTool, TamboToolRegistry } 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 toolRegistry - The tool registry
- * @returns The result of the tool call
+ * @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<{
-    result: string;
+    result: unknown;
     error?: string;
+    tamboTool?: TamboTool;
 }>;
 //# sourceMappingURL=tool-caller.d.ts.map

package/esm/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,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AAGrC;;;;;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,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CA+BA,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,EAClB,MAAM,6BAA6B,CAAC;AAGrC;;;;;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,CAAC;CACvB,CAmCA,CAAC"}

package/esm/util/tool-caller.js

@@ -3,14 +3,14 @@ import { mapTamboToolToContextTool } from "./registry";
  * Process a message from the thread, invoking the appropriate tool and returning the result.
  * @param message - The message to handle
  * @param toolRegistry - The tool registry
- * @returns The result of the tool call
+ * @returns The result of the tool call along with the tool definition
  */
 export const handleToolCall = async (message, toolRegistry, onCallUnregisteredTool) => {
     if (!message?.toolCallRequest?.toolName) {
         throw new Error("Tool name is required");
     }
     try {
-        const tool = findTool(message.toolCallRequest.toolName, toolRegistry);
+        const { tool, tamboTool } = findTool(message.toolCallRequest.toolName, toolRegistry);
         if (!tool) {
             if (onCallUnregisteredTool) {
                 const result = await onCallUnregisteredTool(message.toolCallRequest.toolName, message.toolCallRequest.parameters);
@@ -22,6 +22,7 @@ export const handleToolCall = async (message, toolRegistry, onCallUnregisteredTo
         }
         return {
             result: await runToolChoice(message.toolCallRequest, tool),
+            tamboTool,
         };
     }
     catch (error) {
@@ -35,12 +36,15 @@ export const handleToolCall = async (message, toolRegistry, onCallUnregisteredTo
 const findTool = (toolName, toolRegistry) => {
     const registryTool = toolRegistry[toolName];
     if (!registryTool) {
-        return null;
+        return { tool: null, tamboTool: null };
     }
     const contextTool = mapTamboToolToContextTool(registryTool);
     return {
-        getComponentContext: registryTool.tool,
-        definition: contextTool,
+        tool: {
+            getComponentContext: registryTool.tool,
+            definition: contextTool,
+        },
+        tamboTool: registryTool,
     };
 };
 const runToolChoice = async (toolCallRequest, tool) => {

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

@@ -1 +1 @@
-{"version":3,"file":"tool-caller.js","sourceRoot":"","sources":["../../src/util/tool-caller.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,OAA2C,EAC3C,YAA+B,EAC/B,sBAGoB,EAInB,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,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACtE,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,CAAC;SAC3D,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;AAEF,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAE,YAA+B,EAAE,EAAE;IACrE,MAAM,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE5C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAC;IAC5D,OAAO;QACL,mBAAmB,EAAE,YAAY,CAAC,IAAI;QACtC,UAAU,EAAE,WAAW;KACxB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,KAAK,EACzB,eAAwC,EACxC,IAA0B,EACZ,EAAE;IAChB,mEAAmE;IACnE,MAAM,eAAe,GACnB,eAAe,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAEzE,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  TamboToolRegistry,\n} from \"../model/component-metadata\";\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\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: string;\n  error?: string;\n}> => {\n  if (!message?.toolCallRequest?.toolName) {\n    throw new Error(\"Tool name is required\");\n  }\n\n  try {\n    const tool = findTool(message.toolCallRequest.toolName, toolRegistry);\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),\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 = (toolName: string, toolRegistry: TamboToolRegistry) => {\n  const registryTool = toolRegistry[toolName];\n\n  if (!registryTool) {\n    return null;\n  }\n\n  const contextTool = mapTamboToolToContextTool(registryTool);\n  return {\n    getComponentContext: registryTool.tool,\n    definition: contextTool,\n  };\n};\n\nconst runToolChoice = async (\n  toolCallRequest: TamboAI.ToolCallRequest,\n  tool: ComponentContextTool,\n): Promise<any> => {\n  // Assumes parameters are in the order they are defined in the tool\n  const parameterValues =\n    toolCallRequest.parameters?.map((param) => param.parameterValue) ?? [];\n\n  return await tool.getComponentContext(...parameterValues);\n};\n"]}
+{"version":3,"file":"tool-caller.js","sourceRoot":"","sources":["../../src/util/tool-caller.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,CAAC,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,CAAC;YAC1D,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;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,yBAAyB,CAAC,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,EACZ,EAAE;IAChB,mEAAmE;IACnE,MAAM,eAAe,GACnB,eAAe,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAEzE,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} from \"../model/component-metadata\";\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;\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),\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;\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): Promise<any> => {\n  // Assumes parameters are in the order they are defined in the tool\n  const parameterValues =\n    toolCallRequest.parameters?.map((param) => param.parameterValue) ?? [];\n\n  return await tool.getComponentContext(...parameterValues);\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tambo-ai/react",
-  "version": "0.57.0",
+  "version": "0.58.0",
   "description": "React client package for Tambo AI",
   "repository": {
     "type": "git",
@@ -64,9 +64,9 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.19.1",
-    "@tambo-ai/typescript-sdk": "^0.73.0",
-    "@tanstack/react-query": "^5.90.2",
+    "@modelcontextprotocol/sdk": "^1.20.1",
+    "@tambo-ai/typescript-sdk": "^0.75.0",
+    "@tanstack/react-query": "^5.90.5",
     "fast-equals": "^5.3.2",
     "partial-json": "^0.1.7",
     "react-fast-compare": "^3.2.2",
@@ -94,12 +94,12 @@
     "eslint-plugin-react-hooks": "^6.1.1",
     "jest": "^30.2.0",
     "jest-environment-jsdom": "^30.2.0",
-    "lint-staged": "^16.2.3",
+    "lint-staged": "^16.2.4",
     "prettier": "^3.6.2",
     "prettier-2": "npm:prettier@^2",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
-    "ts-jest": "^29.4.4",
+    "ts-jest": "^29.4.5",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.46.0"
   }