@tambo-ai/react 1.0.3 → 1.2.0

package/README.md

@@ -105,7 +105,7 @@ function ChatInterface() {
 | [`useTamboThread()`](https://docs.tambo.co/concepts/conversation-storage)                          | Fetch a single thread by ID (React Query)                   |
 | [`useTamboThreadList()`](https://docs.tambo.co/concepts/conversation-storage)                      | Fetch thread list with filtering and pagination             |
 | [`useTamboStreamStatus()`](https://docs.tambo.co/reference/react-sdk/hooks#usetambostreamstatus)   | Monitor prop-level streaming status for progressive loading |
-| [`useTamboSuggestions()`](https://docs.tambo.co/concepts/suggestions)                              | Generate contextual suggestions                             |
+| [`useTamboSuggestions()`](https://docs.tambo.co/guides/build-interfaces/build-chat-interface)      | Generate contextual suggestions                             |
 | [`useTamboComponentState()`](https://docs.tambo.co/concepts/generative-interfaces/component-state) | Bidirectional component state synced with the backend       |
 | [`useTamboVoice()`](https://docs.tambo.co/reference/react-sdk/hooks#usetambovoice)                 | Voice input and transcription                               |
 

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

@@ -1,4 +1,17 @@
-import { ContextHelperFn } from "./types";
+import type { ContextHelperFn } from "./types";
+interface InteractableComponentMetadata {
+    id: string;
+    componentName: string;
+    description: string;
+    props: unknown;
+    propsSchema: string;
+    state: unknown;
+    isSelectedForInteraction: boolean;
+    stateSchema: string;
+}
+export interface InteractablesContext {
+    components: InteractableComponentMetadata[];
+}
 /**
  * Prebuilt context helper that provides information about all interactable components currently on the page.
  * This gives the AI awareness of what components it can interact with and their current state.
@@ -24,5 +37,6 @@ export declare const currentInteractablesContextHelper: ContextHelperFn;
  * @param components Array of interactable components
  * @returns A context helper function that returns component metadata or null if no components exist
  */
-export declare const createInteractablesContextHelper: (components: unknown[]) => ContextHelperFn;
+export declare const createInteractablesContextHelper: (components: unknown[]) => (() => InteractablesContext | null);
+export {};
 //# sourceMappingURL=current-interactables-context-helper.d.ts.map

package/dist/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,OAAO,EAAE,KACpB,eAyCF,CAAC"}
+{"version":3,"file":"current-interactables-context-helper.d.ts","sourceRoot":"","sources":["../../src/context-helpers/current-interactables-context-helper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,UAAU,6BAA6B;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,wBAAwB,EAAE,OAAO,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,6BAA6B,EAAE,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,iCAAiC,EAAE,eAI/C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,GAC3C,YAAY,OAAO,EAAE,KACpB,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAyCpC,CAAC"}

package/dist/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;AACI,MAAM,iCAAiC,GAAoB,GAAG,EAAE;IACrE,mFAAmF;IACnF,wEAAwE;IACxE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAJW,QAAA,iCAAiC,qCAI5C;AAEF;;;;;GAKG;AACI,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;AA3CW,QAAA,gCAAgC,oCA2C3C","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"]}
+{"version":3,"file":"current-interactables-context-helper.js","sourceRoot":"","sources":["../../src/context-helpers/current-interactables-context-helper.ts"],"names":[],"mappings":";;;AAiBA;;;;;;;;;;;;;;;;;GAiBG;AACI,MAAM,iCAAiC,GAAoB,GAAG,EAAE;IACrE,mFAAmF;IACnF,wEAAwE;IACxE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAJW,QAAA,iCAAiC,qCAI5C;AAEF;;;;;GAKG;AACI,MAAM,gCAAgC,GAAG,CAC9C,UAAqB,EACgB,EAAE;IACvC,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;AA3CW,QAAA,gCAAgC,oCA2C3C","sourcesContent":["import type { ContextHelperFn } from \"./types\";\n\ninterface InteractableComponentMetadata {\n  id: string;\n  componentName: string;\n  description: string;\n  props: unknown;\n  propsSchema: string;\n  state: unknown;\n  isSelectedForInteraction: boolean;\n  stateSchema: string;\n}\n\nexport interface InteractablesContext {\n  components: InteractableComponentMetadata[];\n}\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): (() => InteractablesContext | null) => {\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/dist/context-helpers/current-interactables-context-helper.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=current-interactables-context-helper.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"current-interactables-context-helper.test.d.ts","sourceRoot":"","sources":["../../src/context-helpers/current-interactables-context-helper.test.ts"],"names":[],"mappings":""}

package/dist/context-helpers/current-interactables-context-helper.test.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const current_interactables_context_helper_1 = require("./current-interactables-context-helper");
+describe("currentInteractablesContextHelper", () => {
+    it("returns null by default (placeholder before provider replaces it)", () => {
+        expect((0, current_interactables_context_helper_1.currentInteractablesContextHelper)()).toBeNull();
+    });
+});
+describe("createInteractablesContextHelper", () => {
+    it("returns null when components array is empty", () => {
+        const helper = (0, current_interactables_context_helper_1.createInteractablesContextHelper)([]);
+        expect(helper()).toBeNull();
+    });
+    it("maps valid component objects to metadata", () => {
+        const components = [
+            {
+                id: "comp-1",
+                name: "WeatherCard",
+                description: "Shows weather",
+                props: { city: "NYC" },
+                propsSchema: { type: "object" },
+                state: { temp: 72 },
+                isSelectedForInteraction: true,
+                stateSchema: { type: "object" },
+            },
+        ];
+        const helper = (0, current_interactables_context_helper_1.createInteractablesContextHelper)(components);
+        const result = helper();
+        expect(result).toEqual({
+            components: [
+                {
+                    id: "comp-1",
+                    componentName: "WeatherCard",
+                    description: "Shows weather",
+                    props: { city: "NYC" },
+                    propsSchema: "Available - use component-specific update tools",
+                    state: { temp: 72 },
+                    isSelectedForInteraction: true,
+                    stateSchema: "Available - use component-specific update tools",
+                },
+            ],
+        });
+    });
+    it("handles invalid (non-object) components gracefully", () => {
+        const components = [null, "not-an-object", 42];
+        const helper = (0, current_interactables_context_helper_1.createInteractablesContextHelper)(components);
+        const result = helper();
+        expect(result?.components).toHaveLength(3);
+        for (const comp of result?.components ?? []) {
+            expect(comp.id).toBe("unknown");
+            expect(comp.componentName).toBe("unknown");
+        }
+    });
+    it("uses defaults for missing properties", () => {
+        const components = [{}];
+        const helper = (0, current_interactables_context_helper_1.createInteractablesContextHelper)(components);
+        const result = helper();
+        expect(result?.components[0]).toEqual({
+            id: "unknown",
+            componentName: "unknown",
+            description: "",
+            props: undefined,
+            propsSchema: "Not specified",
+            state: undefined,
+            isSelectedForInteraction: false,
+            stateSchema: "Not specified",
+        });
+    });
+});
+//# sourceMappingURL=current-interactables-context-helper.test.js.map

package/dist/context-helpers/current-interactables-context-helper.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-interactables-context-helper.test.js","sourceRoot":"","sources":["../../src/context-helpers/current-interactables-context-helper.test.ts"],"names":[],"mappings":";;AAAA,iGAGgD;AAEhD,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IACjD,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,CAAC,IAAA,wEAAiC,GAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,IAAA,uEAAgC,EAAC,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,UAAU,GAAG;YACjB;gBACE,EAAE,EAAE,QAAQ;gBACZ,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,eAAe;gBAC5B,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;gBACtB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC/B,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;gBACnB,wBAAwB,EAAE,IAAI;gBAC9B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAChC;SACF,CAAC;QAEF,MAAM,MAAM,GAAG,IAAA,uEAAgC,EAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;QACxB,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,UAAU,EAAE;gBACV;oBACE,EAAE,EAAE,QAAQ;oBACZ,aAAa,EAAE,aAAa;oBAC5B,WAAW,EAAE,eAAe;oBAC5B,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;oBACtB,WAAW,EAAE,iDAAiD;oBAC9D,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;oBACnB,wBAAwB,EAAE,IAAI;oBAC9B,WAAW,EAAE,iDAAiD;iBAC/D;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC;QAE/C,MAAM,MAAM,GAAG,IAAA,uEAAgC,EAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;QACxB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,UAAU,IAAI,EAAE,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,UAAU,GAAG,CAAC,EAAE,CAAC,CAAC;QAExB,MAAM,MAAM,GAAG,IAAA,uEAAgC,EAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;QACxB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACpC,EAAE,EAAE,SAAS;YACb,aAAa,EAAE,SAAS;YACxB,WAAW,EAAE,EAAE;YACf,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,eAAe;YAC5B,KAAK,EAAE,SAAS;YAChB,wBAAwB,EAAE,KAAK;YAC/B,WAAW,EAAE,eAAe;SAC7B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import {\n  currentInteractablesContextHelper,\n  createInteractablesContextHelper,\n} from \"./current-interactables-context-helper\";\n\ndescribe(\"currentInteractablesContextHelper\", () => {\n  it(\"returns null by default (placeholder before provider replaces it)\", () => {\n    expect(currentInteractablesContextHelper()).toBeNull();\n  });\n});\n\ndescribe(\"createInteractablesContextHelper\", () => {\n  it(\"returns null when components array is empty\", () => {\n    const helper = createInteractablesContextHelper([]);\n    expect(helper()).toBeNull();\n  });\n\n  it(\"maps valid component objects to metadata\", () => {\n    const components = [\n      {\n        id: \"comp-1\",\n        name: \"WeatherCard\",\n        description: \"Shows weather\",\n        props: { city: \"NYC\" },\n        propsSchema: { type: \"object\" },\n        state: { temp: 72 },\n        isSelectedForInteraction: true,\n        stateSchema: { type: \"object\" },\n      },\n    ];\n\n    const helper = createInteractablesContextHelper(components);\n    const result = helper();\n    expect(result).toEqual({\n      components: [\n        {\n          id: \"comp-1\",\n          componentName: \"WeatherCard\",\n          description: \"Shows weather\",\n          props: { city: \"NYC\" },\n          propsSchema: \"Available - use component-specific update tools\",\n          state: { temp: 72 },\n          isSelectedForInteraction: true,\n          stateSchema: \"Available - use component-specific update tools\",\n        },\n      ],\n    });\n  });\n\n  it(\"handles invalid (non-object) components gracefully\", () => {\n    const components = [null, \"not-an-object\", 42];\n\n    const helper = createInteractablesContextHelper(components);\n    const result = helper();\n    expect(result?.components).toHaveLength(3);\n    for (const comp of result?.components ?? []) {\n      expect(comp.id).toBe(\"unknown\");\n      expect(comp.componentName).toBe(\"unknown\");\n    }\n  });\n\n  it(\"uses defaults for missing properties\", () => {\n    const components = [{}];\n\n    const helper = createInteractablesContextHelper(components);\n    const result = helper();\n    expect(result?.components[0]).toEqual({\n      id: \"unknown\",\n      componentName: \"unknown\",\n      description: \"\",\n      props: undefined,\n      propsSchema: \"Not specified\",\n      state: undefined,\n      isSelectedForInteraction: false,\n      stateSchema: \"Not specified\",\n    });\n  });\n});\n"]}

package/dist/mcp/elicitation.d.ts

@@ -1,40 +1,6 @@
-import type { ElicitRequestFormParams, PrimitiveSchemaDefinition } from "@modelcontextprotocol/sdk/spec.types.js";
-import { MCPElicitationHandler } from "./mcp-client";
-/**
- * Schema type for elicitation request fields
- */
-export type ElicitationRequestedSchema = ElicitRequestFormParams["requestedSchema"];
-/**
- * Elicitation request from MCP server
- */
-export interface TamboElicitationRequest {
-    message: string;
-    requestedSchema: ElicitationRequestedSchema;
-    /** AbortSignal that fires when the server cancels the request (e.g., timeout) */
-    signal?: AbortSignal;
-}
-/**
- * Re-export PrimitiveSchemaDefinition for consumers that need to work with schema fields
- */
-export type { PrimitiveSchemaDefinition };
-/**
- * Elicitation response to be sent back
- */
-export interface TamboElicitationResponse {
-    action: "accept" | "decline" | "cancel";
-    content?: Record<string, unknown>;
-    [x: string]: unknown;
-}
-/**
- * Elicitation context state - read-only interface for consumers.
- * State management is handled internally by useElicitation hook.
- */
-export interface ElicitationContextState {
-    /** Current elicitation request, or null if none active */
-    elicitation: TamboElicitationRequest | null;
-    /** Function to call when user responds to elicitation (clears state automatically) */
-    resolveElicitation: ((response: TamboElicitationResponse) => void) | null;
-}
+import type { MCPElicitationHandler, TamboElicitationRequest, TamboElicitationResponse } from "@tambo-ai/client";
+export type { ElicitationRequestedSchema, TamboElicitationRequest, TamboElicitationResponse, ElicitationContextState, PrimitiveSchemaDefinition, } from "@tambo-ai/client";
+export { toElicitationRequestedSchema, hasRequestedSchema, } from "@tambo-ai/client";
 /**
  * Internal hook that manages elicitation state and creates a default handler.
  * This bundles all the state management and handler creation for elicitation.

package/dist/mcp/elicitation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../../src/mcp/elicitation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,yCAAyC,CAAC;AAQjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,0BAA0B,GACpC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,0BAA0B,CAAC;IAC5C,iFAAiF;IACjF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,YAAY,EAAE,yBAAyB,EAAE,CAAC;AAO1C;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,WAAW,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC5C,sFAAsF;IACtF,kBAAkB,EAAE,CAAC,CAAC,QAAQ,EAAE,wBAAwB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3E;AA8BD;;;;;;GAMG;AACH,wBAAgB,cAAc;;;oCAId,wBAAwB,KAAK,IAAI;+FAAjC,wBAAwB,KAAK,IAAI;;EAsEhD"}
+{"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../../src/mcp/elicitation.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,kBAAkB,CAAC;AAO1B,YAAY,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B;;;;;;GAMG;AACH,wBAAgB,cAAc;;;oCAId,wBAAwB,KAAK,IAAI;+FAAjC,wBAAwB,KAAK,IAAI;;EAoEhD"}

package/dist/mcp/elicitation.js

@@ -1,29 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasRequestedSchema = exports.toElicitationRequestedSchema = void 0;
 exports.useElicitation = useElicitation;
 const react_1 = require("react");
-/**
- * Narrow the runtime ElicitRequest requestedSchema into the public
- * ElicitationRequestedSchema type.
- *
- * The MCP SDK guarantees that the runtime
- * `ElicitRequest["params"]["requestedSchema"]` shape stays aligned with the
- * spec-defined `ElicitRequestFormParams["requestedSchema"]`. This helper
- * centralizes the cast based on that contract so that if a future SDK version
- * ever diverges, we have a single place to tighten the implementation (for
- * example with structural validation or normalization).
- * @returns requestedSchema as ElicitationRequestedSchema
- */
-function toElicitationRequestedSchema(value) {
-    return value;
-}
-/**
- * Type guard for the elicitation form params shape.
- * @returns true when params include requestedSchema
- */
-function hasRequestedSchema(params) {
-    return "requestedSchema" in params;
-}
+const client_1 = require("@tambo-ai/client");
+var client_2 = require("@tambo-ai/client");
+Object.defineProperty(exports, "toElicitationRequestedSchema", { enumerable: true, get: function () { return client_2.toElicitationRequestedSchema; } });
+Object.defineProperty(exports, "hasRequestedSchema", { enumerable: true, get: function () { return client_2.hasRequestedSchema; } });
 /**
  * Internal hook that manages elicitation state and creates a default handler.
  * This bundles all the state management and handler creation for elicitation.
@@ -36,7 +19,7 @@ function useElicitation() {
     const [resolveElicitation, setResolveElicitation] = (0, react_1.useState)(null);
     const defaultElicitationHandler = (0, react_1.useCallback)(async (request, extra) => {
         return await new Promise((resolve, reject) => {
-            if (!hasRequestedSchema(request.params)) {
+            if (!(0, client_1.hasRequestedSchema)(request.params)) {
                 const mode = "mode" in request.params ? String(request.params.mode) : "unknown";
                 reject(new Error(`Unsupported MCP elicitation params: expected requestedSchema (form mode), got mode=${mode}`));
                 return;
@@ -47,7 +30,7 @@ function useElicitation() {
             // for cross-version compatibility
             setElicitation({
                 message: request.params.message,
-                requestedSchema: toElicitationRequestedSchema(request.params.requestedSchema),
+                requestedSchema: (0, client_1.toElicitationRequestedSchema)(request.params.requestedSchema),
                 signal: extra.signal,
             });
             // If the signal is already aborted, reject immediately

package/dist/mcp/elicitation.js.map

@@ -1 +1 @@
-{"version":3,"file":"elicitation.js","sourceRoot":"","sources":["../../src/mcp/elicitation.ts"],"names":[],"mappings":";;AA+FA,wCA0EC;AA9JD,iCAA8C;AAiD9C;;;;;;;;;;;GAWG;AACH,SAAS,4BAA4B,CACnC,KAAgE;IAEhE,OAAO,KAAmC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CACzB,MAA+B;IAE/B,OAAO,iBAAiB,IAAI,MAAM,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc;IAC5B,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GACjC,IAAA,gBAAQ,EAAiC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,GAAG,IAAA,gBAAQ,EAE1D,IAAI,CAAC,CAAC;IAER,MAAM,yBAAyB,GAA0B,IAAA,mBAAW,EAClE,KAAK,EACH,OAAsB,EACtB,KAA6D,EACtC,EAAE;QACzB,OAAO,MAAM,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzD,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,GACR,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAErE,MAAM,CACJ,IAAI,KAAK,CACP,sFAAsF,IAAI,EAAE,CAC7F,CACF,CAAC;gBACF,OAAO;YACT,CAAC;YAED,6CAA6C;YAC7C,yEAAyE;YACzE,yEAAyE;YACzE,kCAAkC;YAClC,cAAc,CAAC;gBACb,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO;gBAC/B,eAAe,EAAE,4BAA4B,CAC3C,OAAO,CAAC,MAAM,CAAC,eAAe,CAC/B;gBACD,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;YAEH,uDAAuD;YACvD,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACzB,cAAc,CAAC,IAAI,CAAC,CAAC;gBACrB,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;gBACrC,OAAO;YACT,CAAC;YAED,sCAAsC;YACtC,MAAM,WAAW,GAAG,GAAG,EAAE;gBACvB,cAAc,CAAC,IAAI,CAAC,CAAC;gBACrB,qBAAqB,CAAC,IAAI,CAAC,CAAC;gBAC5B,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACvC,CAAC,CAAC;YAEF,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAEpE,sEAAsE;YACtE,qBAAqB,CAAC,GAAG,EAAE,CAAC,CAAC,QAAsB,EAAE,EAAE;gBACrD,uDAAuD;gBACvD,KAAK,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;gBACvD,0CAA0C;gBAC1C,cAAc,CAAC,IAAI,CAAC,CAAC;gBACrB,qBAAqB,CAAC,IAAI,CAAC,CAAC;gBAC5B,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,EACD,EAAE,CACH,CAAC;IAEF,OAAO;QACL,WAAW;QACX,cAAc;QACd,kBAAkB;QAClB,qBAAqB;QACrB,yBAAyB;KAC1B,CAAC;AACJ,CAAC","sourcesContent":["import type { RequestHandlerExtra } from \"@modelcontextprotocol/sdk/shared/protocol.js\";\nimport type {\n  ElicitRequestFormParams,\n  PrimitiveSchemaDefinition,\n} from \"@modelcontextprotocol/sdk/spec.types.js\";\nimport type {\n  ClientNotification,\n  ClientRequest,\n  ElicitRequest,\n  ElicitResult,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { useCallback, useState } from \"react\";\nimport { MCPElicitationHandler } from \"./mcp-client\";\n\n/**\n * Schema type for elicitation request fields\n */\nexport type ElicitationRequestedSchema =\n  ElicitRequestFormParams[\"requestedSchema\"];\n\n/**\n * Elicitation request from MCP server\n */\nexport interface TamboElicitationRequest {\n  message: string;\n  requestedSchema: ElicitationRequestedSchema;\n  /** AbortSignal that fires when the server cancels the request (e.g., timeout) */\n  signal?: AbortSignal;\n}\n\n/**\n * Re-export PrimitiveSchemaDefinition for consumers that need to work with schema fields\n */\nexport type { PrimitiveSchemaDefinition };\n\ntype ElicitRequestParamsWithRequestedSchema = Extract<\n  ElicitRequest[\"params\"],\n  { requestedSchema: unknown }\n>;\n\n/**\n * Elicitation response to be sent back\n */\nexport interface TamboElicitationResponse {\n  action: \"accept\" | \"decline\" | \"cancel\";\n  content?: Record<string, unknown>;\n  [x: string]: unknown;\n}\n\n/**\n * Elicitation context state - read-only interface for consumers.\n * State management is handled internally by useElicitation hook.\n */\nexport interface ElicitationContextState {\n  /** Current elicitation request, or null if none active */\n  elicitation: TamboElicitationRequest | null;\n  /** Function to call when user responds to elicitation (clears state automatically) */\n  resolveElicitation: ((response: TamboElicitationResponse) => void) | null;\n}\n\n/**\n * Narrow the runtime ElicitRequest requestedSchema into the public\n * ElicitationRequestedSchema type.\n *\n * The MCP SDK guarantees that the runtime\n * `ElicitRequest[\"params\"][\"requestedSchema\"]` shape stays aligned with the\n * spec-defined `ElicitRequestFormParams[\"requestedSchema\"]`. This helper\n * centralizes the cast based on that contract so that if a future SDK version\n * ever diverges, we have a single place to tighten the implementation (for\n * example with structural validation or normalization).\n * @returns requestedSchema as ElicitationRequestedSchema\n */\nfunction toElicitationRequestedSchema(\n  value: ElicitRequestParamsWithRequestedSchema[\"requestedSchema\"],\n): ElicitationRequestedSchema {\n  return value as ElicitationRequestedSchema;\n}\n\n/**\n * Type guard for the elicitation form params shape.\n * @returns true when params include requestedSchema\n */\nfunction hasRequestedSchema(\n  params: ElicitRequest[\"params\"],\n): params is ElicitRequestParamsWithRequestedSchema {\n  return \"requestedSchema\" in params;\n}\n\n/**\n * Internal hook that manages elicitation state and creates a default handler.\n * This bundles all the state management and handler creation for elicitation.\n *\n * Do not export this hook from this package. It is only intended to be used internally by the TamboMcpProvider.\n * @returns Elicitation state and default handler\n */\nexport function useElicitation() {\n  const [elicitation, setElicitation] =\n    useState<TamboElicitationRequest | null>(null);\n  const [resolveElicitation, setResolveElicitation] = useState<\n    ((response: TamboElicitationResponse) => void) | null\n  >(null);\n\n  const defaultElicitationHandler: MCPElicitationHandler = useCallback(\n    async (\n      request: ElicitRequest,\n      extra: RequestHandlerExtra<ClientRequest, ClientNotification>,\n    ): Promise<ElicitResult> => {\n      return await new Promise<ElicitResult>((resolve, reject) => {\n        if (!hasRequestedSchema(request.params)) {\n          const mode =\n            \"mode\" in request.params ? String(request.params.mode) : \"unknown\";\n\n          reject(\n            new Error(\n              `Unsupported MCP elicitation params: expected requestedSchema (form mode), got mode=${mode}`,\n            ),\n          );\n          return;\n        }\n\n        // Set the elicitation request to show the UI\n        // Cast is needed because ElicitRequest uses Zod-inferred types (from the\n        // user's installed zod version), while we use pure TypeScript spec types\n        // for cross-version compatibility\n        setElicitation({\n          message: request.params.message,\n          requestedSchema: toElicitationRequestedSchema(\n            request.params.requestedSchema,\n          ),\n          signal: extra.signal,\n        });\n\n        // If the signal is already aborted, reject immediately\n        if (extra.signal.aborted) {\n          setElicitation(null);\n          reject(new Error(\"Request aborted\"));\n          return;\n        }\n\n        // Listen for abort signal to clean up\n        const handleAbort = () => {\n          setElicitation(null);\n          setResolveElicitation(null);\n          reject(new Error(\"Request aborted\"));\n        };\n\n        extra.signal.addEventListener(\"abort\", handleAbort, { once: true });\n\n        // Store the resolve function so we can call it when the user responds\n        setResolveElicitation(() => (response: ElicitResult) => {\n          // Remove abort listener since we're resolving normally\n          extra.signal.removeEventListener(\"abort\", handleAbort);\n          // Clear state now that user has responded\n          setElicitation(null);\n          setResolveElicitation(null);\n          resolve(response);\n        });\n      });\n    },\n    [],\n  );\n\n  return {\n    elicitation,\n    setElicitation,\n    resolveElicitation,\n    setResolveElicitation,\n    defaultElicitationHandler,\n  };\n}\n"]}
+{"version":3,"file":"elicitation.js","sourceRoot":"","sources":["../../src/mcp/elicitation.ts"],"names":[],"mappings":";;;AAuCA,wCAwEC;AAvGD,iCAA8C;AAM9C,6CAG0B;AAU1B,2CAG0B;AAFxB,sHAAA,4BAA4B,OAAA;AAC5B,4GAAA,kBAAkB,OAAA;AAGpB;;;;;;GAMG;AACH,SAAgB,cAAc;IAC5B,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GACjC,IAAA,gBAAQ,EAAiC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,GAAG,IAAA,gBAAQ,EAE1D,IAAI,CAAC,CAAC;IAER,MAAM,yBAAyB,GAA0B,IAAA,mBAAW,EAClE,KAAK,EACH,OAAsB,EACtB,KAA6D,EACtC,EAAE;QACzB,OAAO,MAAM,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzD,IAAI,CAAC,IAAA,2BAAS,EAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,GACR,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAErE,MAAM,CACJ,IAAI,KAAK,CACP,sFAAsF,IAAI,EAAE,CAC7F,CACF,CAAC;gBACF,OAAO;YACT,CAAC;YAED,6CAA6C;YAC7C,yEAAyE;YACzE,yEAAyE;YACzE,kCAAkC;YAClC,cAAc,CAAC;gBACb,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO;gBAC/B,eAAe,EAAE,IAAA,qCAAQ,EAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;gBACzD,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;YAEH,uDAAuD;YACvD,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACzB,cAAc,CAAC,IAAI,CAAC,CAAC;gBACrB,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;gBACrC,OAAO;YACT,CAAC;YAED,sCAAsC;YACtC,MAAM,WAAW,GAAG,GAAG,EAAE;gBACvB,cAAc,CAAC,IAAI,CAAC,CAAC;gBACrB,qBAAqB,CAAC,IAAI,CAAC,CAAC;gBAC5B,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACvC,CAAC,CAAC;YAEF,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAEpE,sEAAsE;YACtE,qBAAqB,CAAC,GAAG,EAAE,CAAC,CAAC,QAAsB,EAAE,EAAE;gBACrD,uDAAuD;gBACvD,KAAK,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;gBACvD,0CAA0C;gBAC1C,cAAc,CAAC,IAAI,CAAC,CAAC;gBACrB,qBAAqB,CAAC,IAAI,CAAC,CAAC;gBAC5B,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,EACD,EAAE,CACH,CAAC;IAEF,OAAO;QACL,WAAW;QACX,cAAc;QACd,kBAAkB;QAClB,qBAAqB;QACrB,yBAAyB;KAC1B,CAAC;AACJ,CAAC","sourcesContent":["// React-specific hook (not in client package)\nimport type { RequestHandlerExtra } from \"@modelcontextprotocol/sdk/shared/protocol.js\";\nimport type {\n  ClientNotification,\n  ClientRequest,\n  ElicitRequest,\n  ElicitResult,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { useCallback, useState } from \"react\";\nimport type {\n  MCPElicitationHandler,\n  TamboElicitationRequest,\n  TamboElicitationResponse,\n} from \"@tambo-ai/client\";\nimport {\n  toElicitationRequestedSchema as toSchema,\n  hasRequestedSchema as hasSchema,\n} from \"@tambo-ai/client\";\n\n// Re-export types and functions from @tambo-ai/client for barrel consumers\nexport type {\n  ElicitationRequestedSchema,\n  TamboElicitationRequest,\n  TamboElicitationResponse,\n  ElicitationContextState,\n  PrimitiveSchemaDefinition,\n} from \"@tambo-ai/client\";\nexport {\n  toElicitationRequestedSchema,\n  hasRequestedSchema,\n} from \"@tambo-ai/client\";\n\n/**\n * Internal hook that manages elicitation state and creates a default handler.\n * This bundles all the state management and handler creation for elicitation.\n *\n * Do not export this hook from this package. It is only intended to be used internally by the TamboMcpProvider.\n * @returns Elicitation state and default handler\n */\nexport function useElicitation() {\n  const [elicitation, setElicitation] =\n    useState<TamboElicitationRequest | null>(null);\n  const [resolveElicitation, setResolveElicitation] = useState<\n    ((response: TamboElicitationResponse) => void) | null\n  >(null);\n\n  const defaultElicitationHandler: MCPElicitationHandler = useCallback(\n    async (\n      request: ElicitRequest,\n      extra: RequestHandlerExtra<ClientRequest, ClientNotification>,\n    ): Promise<ElicitResult> => {\n      return await new Promise<ElicitResult>((resolve, reject) => {\n        if (!hasSchema(request.params)) {\n          const mode =\n            \"mode\" in request.params ? String(request.params.mode) : \"unknown\";\n\n          reject(\n            new Error(\n              `Unsupported MCP elicitation params: expected requestedSchema (form mode), got mode=${mode}`,\n            ),\n          );\n          return;\n        }\n\n        // Set the elicitation request to show the UI\n        // Cast is needed because ElicitRequest uses Zod-inferred types (from the\n        // user's installed zod version), while we use pure TypeScript spec types\n        // for cross-version compatibility\n        setElicitation({\n          message: request.params.message,\n          requestedSchema: toSchema(request.params.requestedSchema),\n          signal: extra.signal,\n        });\n\n        // If the signal is already aborted, reject immediately\n        if (extra.signal.aborted) {\n          setElicitation(null);\n          reject(new Error(\"Request aborted\"));\n          return;\n        }\n\n        // Listen for abort signal to clean up\n        const handleAbort = () => {\n          setElicitation(null);\n          setResolveElicitation(null);\n          reject(new Error(\"Request aborted\"));\n        };\n\n        extra.signal.addEventListener(\"abort\", handleAbort, { once: true });\n\n        // Store the resolve function so we can call it when the user responds\n        setResolveElicitation(() => (response: ElicitResult) => {\n          // Remove abort listener since we're resolving normally\n          extra.signal.removeEventListener(\"abort\", handleAbort);\n          // Clear state now that user has responded\n          setElicitation(null);\n          setResolveElicitation(null);\n          resolve(response);\n        });\n      });\n    },\n    [],\n  );\n\n  return {\n    elicitation,\n    setElicitation,\n    resolveElicitation,\n    setResolveElicitation,\n    defaultElicitationHandler,\n  };\n}\n"]}

package/dist/mcp/index.d.ts

@@ -6,11 +6,11 @@
  * you'll need to install `zod` and `zod-to-json-schema` as optional peer dependencies.
  * See the React SDK README for the recommended version ranges.
  */
-export { MCPTransport } from "./mcp-client";
-export type { MCPElicitationHandler, MCPHandlers, MCPSamplingHandler, } from "./mcp-client";
-export type { ElicitationRequestedSchema, PrimitiveSchemaDefinition, TamboElicitationRequest, TamboElicitationResponse, } from "./elicitation";
+export { MCPTransport } from "@tambo-ai/client";
+export type { MCPElicitationHandler, MCPHandlers, MCPSamplingHandler, } from "@tambo-ai/client";
+export type { ElicitationRequestedSchema, PrimitiveSchemaDefinition, TamboElicitationRequest, TamboElicitationResponse, } from "@tambo-ai/client";
 export { useTamboMcpPrompt, useTamboMcpPromptList, useTamboMcpResource, useTamboMcpResourceList, isMcpResourceEntry, } from "./mcp-hooks";
 export type { ListPromptEntry, ListPromptItem, ListResourceEntry, ListResourceItem, } from "./mcp-hooks";
 export { TamboMcpProvider, useTamboMcpElicitation, useTamboMcpServers, useTamboElicitationContext, type ConnectedMcpServer, type FailedMcpServer, type McpServer, type ProviderMCPHandlers, } from "./tambo-mcp-provider";
-export type { McpServerInfo, NormalizedMcpServerInfo, } from "../model/mcp-server-info";
+export type { McpServerInfo, NormalizedMcpServerInfo } from "@tambo-ai/client";
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EACV,qBAAqB,EACrB,WAAW,EACX,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,aAAa,EACb,uBAAuB,GACxB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EACV,qBAAqB,EACrB,WAAW,EACX,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/mcp/index.js

@@ -9,8 +9,8 @@ exports.useTamboElicitationContext = exports.useTamboMcpServers = exports.useTam
  * you'll need to install `zod` and `zod-to-json-schema` as optional peer dependencies.
  * See the React SDK README for the recommended version ranges.
  */
-var mcp_client_1 = require("./mcp-client");
-Object.defineProperty(exports, "MCPTransport", { enumerable: true, get: function () { return mcp_client_1.MCPTransport; } });
+var client_1 = require("@tambo-ai/client");
+Object.defineProperty(exports, "MCPTransport", { enumerable: true, get: function () { return client_1.MCPTransport; } });
 var mcp_hooks_1 = require("./mcp-hooks");
 Object.defineProperty(exports, "useTamboMcpPrompt", { enumerable: true, get: function () { return mcp_hooks_1.useTamboMcpPrompt; } });
 Object.defineProperty(exports, "useTamboMcpPromptList", { enumerable: true, get: function () { return mcp_hooks_1.useTamboMcpPromptList; } });

package/dist/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,2CAA4C;AAAnC,0GAAA,YAAY,OAAA;AAYrB,yCAMqB;AALnB,8GAAA,iBAAiB,OAAA;AACjB,kHAAA,qBAAqB,OAAA;AACrB,gHAAA,mBAAmB,OAAA;AACnB,oHAAA,uBAAuB,OAAA;AACvB,+GAAA,kBAAkB,OAAA;AAQpB,2DAS8B;AAR5B,sHAAA,gBAAgB,OAAA;AAChB,4HAAA,sBAAsB,OAAA;AACtB,wHAAA,kBAAkB,OAAA;AAClB,gIAAA,0BAA0B,OAAA","sourcesContent":["/**\n * Entry point for MCP (Model Context Protocol) support in the React SDK.\n *\n * Note: The `@modelcontextprotocol/sdk` is included automatically with `@tambo-ai/react`.\n * If you use features that require schema validation (like component props schemas),\n * you'll need to install `zod` and `zod-to-json-schema` as optional peer dependencies.\n * See the React SDK README for the recommended version ranges.\n */\nexport { MCPTransport } from \"./mcp-client\";\nexport type {\n  MCPElicitationHandler,\n  MCPHandlers,\n  MCPSamplingHandler,\n} from \"./mcp-client\";\nexport type {\n  ElicitationRequestedSchema,\n  PrimitiveSchemaDefinition,\n  TamboElicitationRequest,\n  TamboElicitationResponse,\n} from \"./elicitation\";\nexport {\n  useTamboMcpPrompt,\n  useTamboMcpPromptList,\n  useTamboMcpResource,\n  useTamboMcpResourceList,\n  isMcpResourceEntry,\n} from \"./mcp-hooks\";\nexport type {\n  ListPromptEntry,\n  ListPromptItem,\n  ListResourceEntry,\n  ListResourceItem,\n} from \"./mcp-hooks\";\nexport {\n  TamboMcpProvider,\n  useTamboMcpElicitation,\n  useTamboMcpServers,\n  useTamboElicitationContext,\n  type ConnectedMcpServer,\n  type FailedMcpServer,\n  type McpServer,\n  type ProviderMCPHandlers,\n} from \"./tambo-mcp-provider\";\n\n// Public MCP server metadata types\nexport type {\n  McpServerInfo,\n  NormalizedMcpServerInfo,\n} from \"../model/mcp-server-info\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,2CAAgD;AAAvC,sGAAA,YAAY,OAAA;AAYrB,yCAMqB;AALnB,8GAAA,iBAAiB,OAAA;AACjB,kHAAA,qBAAqB,OAAA;AACrB,gHAAA,mBAAmB,OAAA;AACnB,oHAAA,uBAAuB,OAAA;AACvB,+GAAA,kBAAkB,OAAA;AAQpB,2DAS8B;AAR5B,sHAAA,gBAAgB,OAAA;AAChB,4HAAA,sBAAsB,OAAA;AACtB,wHAAA,kBAAkB,OAAA;AAClB,gIAAA,0BAA0B,OAAA","sourcesContent":["/**\n * Entry point for MCP (Model Context Protocol) support in the React SDK.\n *\n * Note: The `@modelcontextprotocol/sdk` is included automatically with `@tambo-ai/react`.\n * If you use features that require schema validation (like component props schemas),\n * you'll need to install `zod` and `zod-to-json-schema` as optional peer dependencies.\n * See the React SDK README for the recommended version ranges.\n */\nexport { MCPTransport } from \"@tambo-ai/client\";\nexport type {\n  MCPElicitationHandler,\n  MCPHandlers,\n  MCPSamplingHandler,\n} from \"@tambo-ai/client\";\nexport type {\n  ElicitationRequestedSchema,\n  PrimitiveSchemaDefinition,\n  TamboElicitationRequest,\n  TamboElicitationResponse,\n} from \"@tambo-ai/client\";\nexport {\n  useTamboMcpPrompt,\n  useTamboMcpPromptList,\n  useTamboMcpResource,\n  useTamboMcpResourceList,\n  isMcpResourceEntry,\n} from \"./mcp-hooks\";\nexport type {\n  ListPromptEntry,\n  ListPromptItem,\n  ListResourceEntry,\n  ListResourceItem,\n} from \"./mcp-hooks\";\nexport {\n  TamboMcpProvider,\n  useTamboMcpElicitation,\n  useTamboMcpServers,\n  useTamboElicitationContext,\n  type ConnectedMcpServer,\n  type FailedMcpServer,\n  type McpServer,\n  type ProviderMCPHandlers,\n} from \"./tambo-mcp-provider\";\n\n// Public MCP server metadata types\nexport type { McpServerInfo, NormalizedMcpServerInfo } from \"@tambo-ai/client\";\n"]}

package/dist/mcp/mcp-client.test.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const mcp_client_1 = require("./mcp-client");
+const client_1 = require("@tambo-ai/client");
 // Mock the MCP SDK modules
 jest.mock("@modelcontextprotocol/sdk/client/index.js", () => ({
     Client: jest.fn().mockImplementation(() => ({
@@ -57,34 +57,34 @@ describe("MCPClient", () => {
         it("should create and connect an MCPClient with HTTP transport by default", async () => {
             const endpoint = "https://api.example.com/mcp";
             const headers = { Authorization: "Bearer token" };
-            const client = await mcp_client_1.MCPClient.create(endpoint, mcp_client_1.MCPTransport.HTTP, headers, undefined, undefined);
+            const client = await client_1.MCPClient.create(endpoint, client_1.MCPTransport.HTTP, headers, undefined, undefined);
             expect(MockedStreamableHTTPClientTransport).toHaveBeenCalledWith(new URL(endpoint), { sessionId: undefined, requestInit: { headers } });
             expect(MockedClient).toHaveBeenCalledWith({
                 name: "tambo-mcp-client",
                 version: "1.0.0",
             }, { capabilities: {} });
             expect(mockClientInstance.connect).toHaveBeenCalledWith(mockTransportInstance);
-            expect(client).toBeInstanceOf(mcp_client_1.MCPClient);
+            expect(client).toBeInstanceOf(client_1.MCPClient);
         });
         it("should create and connect an MCPClient with SSE transport", async () => {
             const endpoint = "https://api.example.com/mcp";
-            const client = await mcp_client_1.MCPClient.create(endpoint, mcp_client_1.MCPTransport.SSE, undefined, undefined, undefined);
+            const client = await client_1.MCPClient.create(endpoint, client_1.MCPTransport.SSE, undefined, undefined, undefined);
             expect(MockedSSEClientTransport).toHaveBeenCalledWith(new URL(endpoint), {
                 requestInit: { headers: {} },
             });
             expect(mockClientInstance.connect).toHaveBeenCalledWith({});
-            expect(client).toBeInstanceOf(mcp_client_1.MCPClient);
+            expect(client).toBeInstanceOf(client_1.MCPClient);
         });
         it("should create client with default headers when none provided", async () => {
             const endpoint = "https://api.example.com/mcp";
-            await mcp_client_1.MCPClient.create(endpoint, mcp_client_1.MCPTransport.HTTP, undefined, undefined, undefined);
+            await client_1.MCPClient.create(endpoint, client_1.MCPTransport.HTTP, undefined, undefined, undefined);
             expect(MockedStreamableHTTPClientTransport).toHaveBeenCalledWith(new URL(endpoint), { sessionId: undefined, requestInit: { headers: {} } });
         });
     });
     describe("listTools", () => {
         it("should list all tools with pagination", async () => {
             const endpoint = "https://api.example.com/mcp";
-            const client = await mcp_client_1.MCPClient.create(endpoint, mcp_client_1.MCPTransport.HTTP, undefined, undefined, undefined);
+            const client = await client_1.MCPClient.create(endpoint, client_1.MCPTransport.HTTP, undefined, undefined, undefined);
             const mockTools = [
                 {
                     name: "tool1",
@@ -139,7 +139,7 @@ describe("MCPClient", () => {
         });
         it("should handle single page of tools", async () => {
             const endpoint = "https://api.example.com/mcp";
-            const client = await mcp_client_1.MCPClient.create(endpoint, mcp_client_1.MCPTransport.HTTP, undefined, undefined, undefined);
+            const client = await client_1.MCPClient.create(endpoint, client_1.MCPTransport.HTTP, undefined, undefined, undefined);
             const mockTools = [
                 {
                     name: "tool1",
@@ -170,7 +170,7 @@ describe("MCPClient", () => {
         });
         it("should throw error for invalid input schema", async () => {
             const endpoint = "https://api.example.com/mcp";
-            const client = await mcp_client_1.MCPClient.create(endpoint, mcp_client_1.MCPTransport.HTTP, undefined, undefined, undefined);
+            const client = await client_1.MCPClient.create(endpoint, client_1.MCPTransport.HTTP, undefined, undefined, undefined);
             const mockTools = [
                 {
                     name: "invalid-tool",
@@ -189,7 +189,7 @@ describe("MCPClient", () => {
     describe("callTool", () => {
         it("should call a tool with arguments", async () => {
             const endpoint = "https://api.example.com/mcp";
-            const client = await mcp_client_1.MCPClient.create(endpoint, mcp_client_1.MCPTransport.HTTP, undefined, undefined, undefined);
+            const client = await client_1.MCPClient.create(endpoint, client_1.MCPTransport.HTTP, undefined, undefined, undefined);
             const mockResult = { success: true, data: "test result" };
             mockClientInstance.callTool.mockResolvedValue(mockResult);
             const result = await client.callTool("testTool", {
@@ -204,7 +204,7 @@ describe("MCPClient", () => {
         });
         it("should handle tool call errors", async () => {
             const endpoint = "https://api.example.com/mcp";
-            const client = await mcp_client_1.MCPClient.create(endpoint, mcp_client_1.MCPTransport.HTTP, undefined, undefined, undefined);
+            const client = await client_1.MCPClient.create(endpoint, client_1.MCPTransport.HTTP, undefined, undefined, undefined);
             const error = new Error("Tool call failed");
             mockClientInstance.callTool.mockRejectedValue(error);
             await expect(client.callTool("testTool", {})).rejects.toThrow("Tool call failed");
@@ -214,13 +214,13 @@ describe("MCPClient", () => {
         it("should initialize HTTP transport with session ID", async () => {
             const endpoint = "https://api.example.com/mcp";
             const headers = { Authorization: "Bearer token" };
-            await mcp_client_1.MCPClient.create(endpoint, mcp_client_1.MCPTransport.HTTP, headers, undefined, undefined);
+            await client_1.MCPClient.create(endpoint, client_1.MCPTransport.HTTP, headers, undefined, undefined);
             expect(MockedStreamableHTTPClientTransport).toHaveBeenCalledWith(new URL(endpoint), { sessionId: undefined, requestInit: { headers } });
         });
         it("should initialize SSE transport without session ID", async () => {
             const endpoint = "https://api.example.com/mcp";
             const headers = { Authorization: "Bearer token" };
-            await mcp_client_1.MCPClient.create(endpoint, mcp_client_1.MCPTransport.SSE, headers, undefined, undefined);
+            await client_1.MCPClient.create(endpoint, client_1.MCPTransport.SSE, headers, undefined, undefined);
             expect(MockedSSEClientTransport).toHaveBeenCalledWith(new URL(endpoint), {
                 requestInit: { headers },
             });
@@ -229,7 +229,7 @@ describe("MCPClient", () => {
     describe("client initialization", () => {
         it("should initialize client with correct name and version", async () => {
             const endpoint = "https://api.example.com/mcp";
-            await mcp_client_1.MCPClient.create(endpoint, mcp_client_1.MCPTransport.HTTP, undefined, undefined, undefined);
+            await client_1.MCPClient.create(endpoint, client_1.MCPTransport.HTTP, undefined, undefined, undefined);
             expect(MockedClient).toHaveBeenCalledWith({
                 name: "tambo-mcp-client",
                 version: "1.0.0",
@@ -241,7 +241,7 @@ describe("MCPClient", () => {
             const endpoint = "https://api.example.com/mcp";
             const elicitation = jest.fn(async () => ({}));
             const sampling = jest.fn(async () => ({}));
-            await mcp_client_1.MCPClient.create(endpoint, mcp_client_1.MCPTransport.HTTP, undefined, undefined, undefined, { elicitation, sampling });
+            await client_1.MCPClient.create(endpoint, client_1.MCPTransport.HTTP, undefined, undefined, undefined, { elicitation, sampling });
             expect(MockedClient).toHaveBeenLastCalledWith({
                 name: "tambo-mcp-client",
                 version: "1.0.0",
@@ -257,7 +257,7 @@ describe("MCPClient", () => {
         });
         it("removes elicitation handler when set to undefined", async () => {
             const endpoint = "https://api.example.com/mcp";
-            const client = await mcp_client_1.MCPClient.create(endpoint, mcp_client_1.MCPTransport.HTTP, undefined, undefined, undefined, {
+            const client = await client_1.MCPClient.create(endpoint, client_1.MCPTransport.HTTP, undefined, undefined, undefined, {
                 elicitation: async () => ({}),
             });
             const removeSpy = mockClientInstance.removeRequestHandler;
@@ -268,7 +268,7 @@ describe("MCPClient", () => {
         });
         it("removes sampling handler when set to undefined", async () => {
             const endpoint = "https://api.example.com/mcp";
-            const client = await mcp_client_1.MCPClient.create(endpoint, mcp_client_1.MCPTransport.HTTP, undefined, undefined, undefined, {
+            const client = await client_1.MCPClient.create(endpoint, client_1.MCPTransport.HTTP, undefined, undefined, undefined, {
                 sampling: async () => ({}),
             });
             const removeSpy = mockClientInstance.removeRequestHandler;