@tambo-ai/react 0.41.0 → 0.42.0

package/README.md

@@ -1,24 +1,20 @@
-# Tambo React SDK
+# Tambo AI React SDK
 
 Tambo allows AI models to dynamically render React components in response to user messages, enabling AI assistants to display interactive widgets, charts, forms, and other UI elements instead of just text. Tambo is a great way to add generative UI to your AI assistant, copilot, or agent.
 
 This package provides react hooks to talk to the Tambo API and render custom components inline, but does not provide any UI components on its own. For pre-built UI components that use this package, see [tambo-ui](https://ui.tambo.co).
 
-## Build with MCP and Generative UI
+## Build apps with Generative UI and MCP
 
-[![Watch the video](https://img.youtube.com/vi/6zDDPfr7Aoo/0.jpg)](https://youtu.be/6zDDPfr7Aoo)
+![template gif](../assets/template.gif)
 
-[Source code](https://github.com/tambo-ai/mcp-template)
-
-### Creating a new project
-
-You can create a new project using our MCP template:
+Get started using our [AI chat template](https://github.com/tambo-ai/tambo-template):
 
 ```bash
-npx tambo create-app -t mcp tambo-mcp-app
+npx tambo create-app my-tambo-app
 ```
 
-This will create a new nextjs project with Tambo pre-configured, and then step you through the process of setting up a Tambo project, including signing up for an API key, and adding it to `.env.local`.
+This will create a new NextJS project with Tambo pre-configured, and then step you through the process of setting up a Tambo project, including signing up for an API key, and adding it to `.env.local`.
 
 ### Adding components to an existing project
 
@@ -188,11 +184,10 @@ function ChatInterface() {
 
 ### Templates
 
-| App                                                                    | Description                            |
-| ---------------------------------------------------------------------- | -------------------------------------- |
-| [MCP](https://github.com/tambo-ai/mcp-template) (new!)                 | Get started with MCP + Generative UX   |
-| [Regular Tools](https://github.com/tambo-ai/tambo-template)            | Get started with Generative UX         |
-| [Conversational Form](https://github.com/tambo-ai/conversational-form) | Collect information with generative UX |
+| App                                                                      | Description                                    |
+| ------------------------------------------------------------------------ | ---------------------------------------------- |
+| [AI Chat with Generative UI](https://github.com/tambo-ai/tambo-template) | Get started with Generative UX, tools, and MCP |
+| [Conversational Form](https://github.com/tambo-ai/conversational-form)   | Collect information with generative UX         |
 
 Check out our UI library [tambo-ui](https://ui.tambo.co) for components that leverage tambo.
 

package/dist/context-helpers/__tests__/context-helpers.test.d.ts

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

package/dist/context-helpers/__tests__/context-helpers.test.d.ts.map

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

package/dist/context-helpers/__tests__/context-helpers.test.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("../index");
+describe("Context Helpers", () => {
+    describe("getUserTimeContext", () => {
+        it("should return user time context with all required fields", () => {
+            const context = (0, index_1.getUserTimeContext)();
+            expect(context.name).toBe("userTime");
+            expect(context.context).toHaveProperty("localTime");
+            expect(context.context).toHaveProperty("timezone");
+            expect(context.context).toHaveProperty("timestamp");
+            expect(context.context).toHaveProperty("offsetMinutes");
+            // Verify data types
+            expect(typeof context.context.localTime).toBe("string");
+            expect(typeof context.context.timezone).toBe("string");
+            expect(typeof context.context.timestamp).toBe("string");
+            expect(typeof context.context.offsetMinutes).toBe("number");
+            // Verify timestamp is valid ISO string
+            expect(() => new Date(context.context.timestamp)).not.toThrow();
+        });
+    });
+    describe("getUserPageContext", () => {
+        it("should return page context with default values in test environment", () => {
+            const context = (0, index_1.getUserPageContext)();
+            expect(context.name).toBe("userPage");
+            expect(context.context).toHaveProperty("url");
+            expect(context.context).toHaveProperty("pathname");
+            expect(context.context).toHaveProperty("hostname");
+            expect(context.context).toHaveProperty("search");
+            expect(context.context).toHaveProperty("hash");
+            expect(context.context).toHaveProperty("title");
+            expect(context.context).toHaveProperty("referrer");
+            // Verify data types
+            expect(typeof context.context.url).toBe("string");
+            expect(typeof context.context.pathname).toBe("string");
+            expect(typeof context.context.hostname).toBe("string");
+            expect(typeof context.context.search).toBe("string");
+            expect(typeof context.context.hash).toBe("string");
+            expect(typeof context.context.title).toBe("string");
+            expect(typeof context.context.referrer).toBe("string");
+        });
+    });
+});
+//# sourceMappingURL=context-helpers.test.js.map

package/dist/context-helpers/__tests__/context-helpers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-helpers.test.js","sourceRoot":"","sources":["../../../src/context-helpers/__tests__/context-helpers.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { getUserPageContext, getUserTimeContext } from \"../index\";\n\ndescribe(\"Context Helpers\", () => {\n  describe(\"getUserTimeContext\", () => {\n    it(\"should return user time context with all required fields\", () => {\n      const context = getUserTimeContext();\n\n      expect(context.name).toBe(\"userTime\");\n      expect(context.context).toHaveProperty(\"localTime\");\n      expect(context.context).toHaveProperty(\"timezone\");\n      expect(context.context).toHaveProperty(\"timestamp\");\n      expect(context.context).toHaveProperty(\"offsetMinutes\");\n\n      // Verify data types\n      expect(typeof context.context.localTime).toBe(\"string\");\n      expect(typeof context.context.timezone).toBe(\"string\");\n      expect(typeof context.context.timestamp).toBe(\"string\");\n      expect(typeof context.context.offsetMinutes).toBe(\"number\");\n\n      // Verify timestamp is valid ISO string\n      expect(() => new Date(context.context.timestamp)).not.toThrow();\n    });\n  });\n\n  describe(\"getUserPageContext\", () => {\n    it(\"should return page context with default values in test environment\", () => {\n      const context = getUserPageContext();\n\n      expect(context.name).toBe(\"userPage\");\n      expect(context.context).toHaveProperty(\"url\");\n      expect(context.context).toHaveProperty(\"pathname\");\n      expect(context.context).toHaveProperty(\"hostname\");\n      expect(context.context).toHaveProperty(\"search\");\n      expect(context.context).toHaveProperty(\"hash\");\n      expect(context.context).toHaveProperty(\"title\");\n      expect(context.context).toHaveProperty(\"referrer\");\n\n      // Verify data types\n      expect(typeof context.context.url).toBe(\"string\");\n      expect(typeof context.context.pathname).toBe(\"string\");\n      expect(typeof context.context.hostname).toBe(\"string\");\n      expect(typeof context.context.search).toBe(\"string\");\n      expect(typeof context.context.hash).toBe(\"string\");\n      expect(typeof context.context.title).toBe(\"string\");\n      expect(typeof context.context.referrer).toBe(\"string\");\n    });\n  });\n});\n"]}

package/dist/context-helpers/index.d.ts

@@ -0,0 +1,9 @@
+import { AdditionalContextHelper } from "./types";
+export * from "./types";
+export * from "./user-page";
+export * from "./user-time";
+/**
+ * Pre-built context helpers that can be enabled/disabled
+ */
+export declare const DEFAULT_CONTEXT_HELPERS: AdditionalContextHelper[];
+//# sourceMappingURL=index.d.ts.map

package/dist/context-helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context-helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAIlD,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAE5B;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,uBAAuB,EAW5D,CAAC"}

package/dist/context-helpers/index.js

@@ -0,0 +1,38 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONTEXT_HELPERS = void 0;
+const user_page_1 = require("./user-page");
+const user_time_1 = require("./user-time");
+__exportStar(require("./types"), exports);
+__exportStar(require("./user-page"), exports);
+__exportStar(require("./user-time"), exports);
+/**
+ * Pre-built context helpers that can be enabled/disabled
+ */
+exports.DEFAULT_CONTEXT_HELPERS = [
+    {
+        name: "userTime",
+        enabled: false, // Default to disabled
+        run: user_time_1.getUserTimeContext,
+    },
+    {
+        name: "userPage",
+        enabled: false, // Default to disabled
+        run: user_page_1.getUserPageContext,
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/context-helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context-helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AACA,2CAAiD;AACjD,2CAAiD;AAEjD,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B;AAE5B;;GAEG;AACU,QAAA,uBAAuB,GAA8B;IAChE;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,KAAK,EAAE,sBAAsB;QACtC,GAAG,EAAE,8BAAkB;KACxB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,KAAK,EAAE,sBAAsB;QACtC,GAAG,EAAE,8BAAkB;KACxB;CACF,CAAC","sourcesContent":["import { AdditionalContextHelper } from \"./types\";\nimport { getUserPageContext } from \"./user-page\";\nimport { getUserTimeContext } from \"./user-time\";\n\nexport * from \"./types\";\nexport * from \"./user-page\";\nexport * from \"./user-time\";\n\n/**\n * Pre-built context helpers that can be enabled/disabled\n */\nexport const DEFAULT_CONTEXT_HELPERS: AdditionalContextHelper[] = [\n  {\n    name: \"userTime\",\n    enabled: false, // Default to disabled\n    run: getUserTimeContext,\n  },\n  {\n    name: \"userPage\",\n    enabled: false, // Default to disabled\n    run: getUserPageContext,\n  },\n];\n"]}

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

@@ -0,0 +1,30 @@
+/**
+ * Interface for additional context that can be added to messages
+ */
+export interface AdditionalContext {
+    /** The name of the context type */
+    name: string;
+    /** The context data */
+    context: any;
+}
+/**
+ * Interface for a context helper that can generate additional context
+ */
+export interface AdditionalContextHelper {
+    /** The name of the context helper */
+    name: string;
+    /** Whether this helper is enabled */
+    enabled: boolean;
+    /** Function that generates the additional context */
+    run: () => AdditionalContext | Promise<AdditionalContext>;
+}
+/**
+ * Configuration for context helpers
+ */
+export interface ContextHelpersConfig {
+    /** Enable/disable user time context helper */
+    userTime?: boolean;
+    /** Enable/disable user page context helper */
+    userPage?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,GAAG,EAAE,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/context-helpers/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +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 * Interface for a context helper that can generate additional context\n */\nexport interface AdditionalContextHelper {\n  /** The name of the context helper */\n  name: string;\n  /** Whether this helper is enabled */\n  enabled: boolean;\n  /** Function that generates the additional context */\n  run: () => AdditionalContext | Promise<AdditionalContext>;\n}\n\n/**\n * Configuration for context helpers\n */\nexport interface ContextHelpersConfig {\n  /** Enable/disable user time context helper */\n  userTime?: boolean;\n  /** Enable/disable user page context helper */\n  userPage?: boolean;\n}\n"]}

package/dist/context-helpers/user-page.d.ts

@@ -0,0 +1,7 @@
+import { AdditionalContext } from "./types";
+/**
+ * Context helper that provides information about the user's current page
+ * @returns Additional context with current page information
+ */
+export declare function getUserPageContext(): AdditionalContext;
+//# sourceMappingURL=user-page.d.ts.map

package/dist/context-helpers/user-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-page.d.ts","sourceRoot":"","sources":["../../src/context-helpers/user-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,CAuBtD"}

package/dist/context-helpers/user-page.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserPageContext = getUserPageContext;
+/**
+ * Context helper that provides information about the user's current page
+ * @returns Additional context with current page information
+ */
+function getUserPageContext() {
+    // Only run in browser environment
+    if (typeof window === "undefined") {
+        return {
+            name: "userPage",
+            context: {
+                error: "Not in browser environment",
+            },
+        };
+    }
+    return {
+        name: "userPage",
+        context: {
+            url: window.location.href,
+            pathname: window.location.pathname,
+            hostname: window.location.hostname,
+            search: window.location.search,
+            hash: window.location.hash,
+            title: document.title,
+            referrer: document.referrer,
+        },
+    };
+}
+//# sourceMappingURL=user-page.js.map

package/dist/context-helpers/user-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-page.js","sourceRoot":"","sources":["../../src/context-helpers/user-page.ts"],"names":[],"mappings":";;AAMA,gDAuBC;AA3BD;;;GAGG;AACH,SAAgB,kBAAkB;IAChC,kCAAkC;IAClC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE;gBACP,KAAK,EAAE,4BAA4B;aACpC;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE;YACP,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;YAClC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;YAClC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YAC9B,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;YAC1B,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { AdditionalContext } from \"./types\";\n\n/**\n * Context helper that provides information about the user's current page\n * @returns Additional context with current page information\n */\nexport function getUserPageContext(): AdditionalContext {\n  // Only run in browser environment\n  if (typeof window === \"undefined\") {\n    return {\n      name: \"userPage\",\n      context: {\n        error: \"Not in browser environment\",\n      },\n    };\n  }\n\n  return {\n    name: \"userPage\",\n    context: {\n      url: window.location.href,\n      pathname: window.location.pathname,\n      hostname: window.location.hostname,\n      search: window.location.search,\n      hash: window.location.hash,\n      title: document.title,\n      referrer: document.referrer,\n    },\n  };\n}\n"]}

package/dist/context-helpers/user-time.d.ts

@@ -0,0 +1,7 @@
+import { AdditionalContext } from "./types";
+/**
+ * Context helper that provides the user's current time and timezone
+ * @returns Additional context with user's time information
+ */
+export declare function getUserTimeContext(): AdditionalContext;
+//# sourceMappingURL=user-time.d.ts.map

package/dist/context-helpers/user-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-time.d.ts","sourceRoot":"","sources":["../../src/context-helpers/user-time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,CAYtD"}

package/dist/context-helpers/user-time.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserTimeContext = getUserTimeContext;
+/**
+ * Context helper that provides the user's current time and timezone
+ * @returns Additional context with user's time information
+ */
+function getUserTimeContext() {
+    const now = new Date();
+    return {
+        name: "userTime",
+        context: {
+            localTime: now.toLocaleString(),
+            timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+            timestamp: now.toISOString(),
+            offsetMinutes: now.getTimezoneOffset(),
+        },
+    };
+}
+//# sourceMappingURL=user-time.js.map

package/dist/context-helpers/user-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-time.js","sourceRoot":"","sources":["../../src/context-helpers/user-time.ts"],"names":[],"mappings":";;AAMA,gDAYC;AAhBD;;;GAGG;AACH,SAAgB,kBAAkB;IAChC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE;YACP,SAAS,EAAE,GAAG,CAAC,cAAc,EAAE;YAC/B,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ;YAC1D,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;YAC5B,aAAa,EAAE,GAAG,CAAC,iBAAiB,EAAE;SACvC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { AdditionalContext } from \"./types\";\n\n/**\n * Context helper that provides the user's current time and timezone\n * @returns Additional context with user's time information\n */\nexport function getUserTimeContext(): AdditionalContext {\n  const now = new Date();\n\n  return {\n    name: \"userTime\",\n    context: {\n      localTime: now.toLocaleString(),\n      timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,\n      timestamp: now.toISOString(),\n      offsetMinutes: now.getTimezoneOffset(),\n    },\n  };\n}\n"]}

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { useTamboStreamingProps } from "./hooks/use-streaming-props";
 export * from "./hooks/use-suggestions";
 export { useTamboStreamStatus, type PropStatus, type StreamStatus, } from "./hooks/use-tambo-stream-status";
 export { useTamboThreadInput } from "./hooks/use-thread-input";
-export { TamboClientProvider, TamboComponentProvider, TamboPropStreamProvider, TamboProvider, TamboStubProvider, TamboThreadProvider, useTambo, useTamboClient, useTamboStream, useTamboThread, type TamboComponent, type TamboRegistryContext, type TamboStubProviderProps, } from "./providers";
+export { TamboClientProvider, TamboComponentProvider, TamboContextHelpersProvider, TamboPropStreamProvider, TamboProvider, TamboStubProvider, TamboThreadProvider, useTambo, useTamboClient, useTamboContextHelpers, useTamboStream, useTamboThread, type TamboComponent, type TamboContextHelpersContextProps, type TamboContextHelpersProviderProps, type TamboRegistryContext, type TamboStubProviderProps, } from "./providers";
 export type { APIError, RateLimitError, TamboAIError, } from "@tambo-ai/typescript-sdk";
 export type { Suggestion, SuggestionGenerateParams, SuggestionGenerateResponse, SuggestionListResponse, } from "@tambo-ai/typescript-sdk/resources/beta/threads/suggestions";
 export { useTamboThreadList } from "./hooks/use-tambo-threads";
@@ -15,4 +15,6 @@ export { type TamboThread } from "./model/tambo-thread";
 export type { TamboInteractableComponent as InteractableComponent, TamboInteractableContext, } from "./model/tambo-interactable";
 export { withTamboInteractable as withInteractable, type InteractableConfig, type WithTamboInteractableProps, } from "./providers/hoc/with-tambo-interactable";
 export { useTamboInteractable } from "./providers/tambo-interactable-provider";
+export { DEFAULT_CONTEXT_HELPERS, getUserPageContext, getUserTimeContext, } from "./context-helpers";
+export type { AdditionalContext, AdditionalContextHelper, ContextHelpersConfig, } from "./context-helpers";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wKAAwK;AAExK,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,QAAQ,EACR,cAAc,EACd,cAAc,EACd,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,cAAc,EACd,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,UAAU,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,SAAS,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EACf,KAAK,kBAAkB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,YAAY,EACV,0BAA0B,IAAI,qBAAqB,EACnD,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wKAAwK;AAExK,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,EACrC,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,cAAc,EACd,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,UAAU,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,SAAS,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EACf,KAAK,kBAAkB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,YAAY,EACV,0BAA0B,IAAI,qBAAqB,EACnD,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAG/E,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -15,7 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useTamboInteractable = exports.withInteractable = exports.GenerationStage = exports.useTamboThreadList = exports.useTamboThread = exports.useTamboStream = exports.useTamboClient = exports.useTambo = exports.TamboThreadProvider = exports.TamboStubProvider = exports.TamboProvider = exports.TamboPropStreamProvider = exports.TamboComponentProvider = exports.TamboClientProvider = exports.useTamboThreadInput = exports.useTamboStreamStatus = exports.useTamboStreamingProps = exports.useTamboMessageContext = exports.useTamboCurrentMessage = exports.TamboMessageProvider = exports.useTamboComponentState = void 0;
+exports.getUserTimeContext = exports.getUserPageContext = exports.DEFAULT_CONTEXT_HELPERS = exports.useTamboInteractable = exports.withInteractable = exports.GenerationStage = exports.useTamboThreadList = exports.useTamboThread = exports.useTamboStream = exports.useTamboContextHelpers = exports.useTamboClient = exports.useTambo = exports.TamboThreadProvider = exports.TamboStubProvider = exports.TamboProvider = exports.TamboPropStreamProvider = exports.TamboContextHelpersProvider = exports.TamboComponentProvider = exports.TamboClientProvider = exports.useTamboThreadInput = exports.useTamboStreamStatus = exports.useTamboStreamingProps = exports.useTamboMessageContext = exports.useTamboCurrentMessage = exports.TamboMessageProvider = exports.useTamboComponentState = void 0;
 var use_component_state_1 = require("./hooks/use-component-state");
 Object.defineProperty(exports, "useTamboComponentState", { enumerable: true, get: function () { return use_component_state_1.useTamboComponentState; } });
 var use_current_message_1 = require("./hooks/use-current-message");
@@ -33,12 +33,14 @@ Object.defineProperty(exports, "useTamboThreadInput", { enumerable: true, get: f
 var providers_1 = require("./providers");
 Object.defineProperty(exports, "TamboClientProvider", { enumerable: true, get: function () { return providers_1.TamboClientProvider; } });
 Object.defineProperty(exports, "TamboComponentProvider", { enumerable: true, get: function () { return providers_1.TamboComponentProvider; } });
+Object.defineProperty(exports, "TamboContextHelpersProvider", { enumerable: true, get: function () { return providers_1.TamboContextHelpersProvider; } });
 Object.defineProperty(exports, "TamboPropStreamProvider", { enumerable: true, get: function () { return providers_1.TamboPropStreamProvider; } });
 Object.defineProperty(exports, "TamboProvider", { enumerable: true, get: function () { return providers_1.TamboProvider; } });
 Object.defineProperty(exports, "TamboStubProvider", { enumerable: true, get: function () { return providers_1.TamboStubProvider; } });
 Object.defineProperty(exports, "TamboThreadProvider", { enumerable: true, get: function () { return providers_1.TamboThreadProvider; } });
 Object.defineProperty(exports, "useTambo", { enumerable: true, get: function () { return providers_1.useTambo; } });
 Object.defineProperty(exports, "useTamboClient", { enumerable: true, get: function () { return providers_1.useTamboClient; } });
+Object.defineProperty(exports, "useTamboContextHelpers", { enumerable: true, get: function () { return providers_1.useTamboContextHelpers; } });
 Object.defineProperty(exports, "useTamboStream", { enumerable: true, get: function () { return providers_1.useTamboStream; } });
 Object.defineProperty(exports, "useTamboThread", { enumerable: true, get: function () { return providers_1.useTamboThread; } });
 var use_tambo_threads_1 = require("./hooks/use-tambo-threads");
@@ -49,4 +51,9 @@ var with_tambo_interactable_1 = require("./providers/hoc/with-tambo-interactable
 Object.defineProperty(exports, "withInteractable", { enumerable: true, get: function () { return with_tambo_interactable_1.withTamboInteractable; } });
 var tambo_interactable_provider_1 = require("./providers/tambo-interactable-provider");
 Object.defineProperty(exports, "useTamboInteractable", { enumerable: true, get: function () { return tambo_interactable_provider_1.useTamboInteractable; } });
+// Context helpers exports
+var context_helpers_1 = require("./context-helpers");
+Object.defineProperty(exports, "DEFAULT_CONTEXT_HELPERS", { enumerable: true, get: function () { return context_helpers_1.DEFAULT_CONTEXT_HELPERS; } });
+Object.defineProperty(exports, "getUserPageContext", { enumerable: true, get: function () { return context_helpers_1.getUserPageContext; } });
+Object.defineProperty(exports, "getUserTimeContext", { enumerable: true, get: function () { return context_helpers_1.getUserTimeContext; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,wKAAwK;;;;;;;;;;;;;;;;;AAExK,mEAAqE;AAA5D,6HAAA,sBAAsB,OAAA;AAC/B,mEAIqC;AAHnC,2HAAA,oBAAoB,OAAA;AACpB,6HAAA,sBAAsB,OAAA;AACtB,6HAAA,sBAAsB,OAAA;AAExB,mEAAqE;AAA5D,6HAAA,sBAAsB,OAAA;AAC/B,0DAAwC;AACxC,2EAIyC;AAHvC,+HAAA,oBAAoB,OAAA;AAItB,6DAA+D;AAAtD,uHAAA,mBAAmB,OAAA;AAE5B,gCAAgC;AAChC,yCAcqB;AAbnB,gHAAA,mBAAmB,OAAA;AACnB,mHAAA,sBAAsB,OAAA;AACtB,oHAAA,uBAAuB,OAAA;AACvB,0GAAA,aAAa,OAAA;AACb,8GAAA,iBAAiB,OAAA;AACjB,gHAAA,mBAAmB,OAAA;AACnB,qGAAA,QAAQ,OAAA;AACR,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AAkBhB,+DAA+D;AAAtD,uHAAA,kBAAkB,OAAA;AAQ3B,mFAG6C;AAF3C,8HAAA,eAAe,OAAA;AASjB,mFAIiD;AAH/C,2HAAA,qBAAqB,OAAoB;AAI3C,uFAA+E;AAAtE,mIAAA,oBAAoB,OAAA","sourcesContent":["/** Exports for the library. Only publically available exports are re-exported here. Anything not exported here is not supported and may change or break at any time. */\n\nexport { useTamboComponentState } from \"./hooks/use-component-state\";\nexport {\n  TamboMessageProvider,\n  useTamboCurrentMessage,\n  useTamboMessageContext,\n} from \"./hooks/use-current-message\";\nexport { useTamboStreamingProps } from \"./hooks/use-streaming-props\";\nexport * from \"./hooks/use-suggestions\";\nexport {\n  useTamboStreamStatus,\n  type PropStatus,\n  type StreamStatus,\n} from \"./hooks/use-tambo-stream-status\";\nexport { useTamboThreadInput } from \"./hooks/use-thread-input\";\n\n// Re-export provider components\nexport {\n  TamboClientProvider,\n  TamboComponentProvider,\n  TamboPropStreamProvider,\n  TamboProvider,\n  TamboStubProvider,\n  TamboThreadProvider,\n  useTambo,\n  useTamboClient,\n  useTamboStream,\n  useTamboThread,\n  type TamboComponent,\n  type TamboRegistryContext,\n  type TamboStubProviderProps,\n} from \"./providers\";\n\n// Re-export types from Tambo Node SDK\nexport type {\n  APIError,\n  RateLimitError,\n  TamboAIError,\n} from \"@tambo-ai/typescript-sdk\";\nexport type {\n  Suggestion,\n  SuggestionGenerateParams,\n  SuggestionGenerateResponse,\n  SuggestionListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/beta/threads/suggestions\";\nexport { useTamboThreadList } from \"./hooks/use-tambo-threads\";\nexport {\n  type ComponentContextToolMetadata,\n  type ComponentRegistry,\n  type ParameterSpec,\n  type RegisteredComponent,\n  type TamboTool,\n} from \"./model/component-metadata\";\nexport {\n  GenerationStage,\n  type TamboThreadMessage,\n} from \"./model/generate-component-response\";\nexport { type TamboThread } from \"./model/tambo-thread\";\n\nexport type {\n  TamboInteractableComponent as InteractableComponent,\n  TamboInteractableContext,\n} from \"./model/tambo-interactable\";\nexport {\n  withTamboInteractable as withInteractable,\n  type InteractableConfig,\n  type WithTamboInteractableProps,\n} from \"./providers/hoc/with-tambo-interactable\";\nexport { useTamboInteractable } from \"./providers/tambo-interactable-provider\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,wKAAwK;;;;;;;;;;;;;;;;;AAExK,mEAAqE;AAA5D,6HAAA,sBAAsB,OAAA;AAC/B,mEAIqC;AAHnC,2HAAA,oBAAoB,OAAA;AACpB,6HAAA,sBAAsB,OAAA;AACtB,6HAAA,sBAAsB,OAAA;AAExB,mEAAqE;AAA5D,6HAAA,sBAAsB,OAAA;AAC/B,0DAAwC;AACxC,2EAIyC;AAHvC,+HAAA,oBAAoB,OAAA;AAItB,6DAA+D;AAAtD,uHAAA,mBAAmB,OAAA;AAE5B,gCAAgC;AAChC,yCAkBqB;AAjBnB,gHAAA,mBAAmB,OAAA;AACnB,mHAAA,sBAAsB,OAAA;AACtB,wHAAA,2BAA2B,OAAA;AAC3B,oHAAA,uBAAuB,OAAA;AACvB,0GAAA,aAAa,OAAA;AACb,8GAAA,iBAAiB,OAAA;AACjB,gHAAA,mBAAmB,OAAA;AACnB,qGAAA,QAAQ,OAAA;AACR,2GAAA,cAAc,OAAA;AACd,mHAAA,sBAAsB,OAAA;AACtB,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AAoBhB,+DAA+D;AAAtD,uHAAA,kBAAkB,OAAA;AAQ3B,mFAG6C;AAF3C,8HAAA,eAAe,OAAA;AASjB,mFAIiD;AAH/C,2HAAA,qBAAqB,OAAoB;AAI3C,uFAA+E;AAAtE,mIAAA,oBAAoB,OAAA;AAE7B,0BAA0B;AAC1B,qDAI2B;AAHzB,0HAAA,uBAAuB,OAAA;AACvB,qHAAA,kBAAkB,OAAA;AAClB,qHAAA,kBAAkB,OAAA","sourcesContent":["/** Exports for the library. Only publically available exports are re-exported here. Anything not exported here is not supported and may change or break at any time. */\n\nexport { useTamboComponentState } from \"./hooks/use-component-state\";\nexport {\n  TamboMessageProvider,\n  useTamboCurrentMessage,\n  useTamboMessageContext,\n} from \"./hooks/use-current-message\";\nexport { useTamboStreamingProps } from \"./hooks/use-streaming-props\";\nexport * from \"./hooks/use-suggestions\";\nexport {\n  useTamboStreamStatus,\n  type PropStatus,\n  type StreamStatus,\n} from \"./hooks/use-tambo-stream-status\";\nexport { useTamboThreadInput } from \"./hooks/use-thread-input\";\n\n// Re-export provider components\nexport {\n  TamboClientProvider,\n  TamboComponentProvider,\n  TamboContextHelpersProvider,\n  TamboPropStreamProvider,\n  TamboProvider,\n  TamboStubProvider,\n  TamboThreadProvider,\n  useTambo,\n  useTamboClient,\n  useTamboContextHelpers,\n  useTamboStream,\n  useTamboThread,\n  type TamboComponent,\n  type TamboContextHelpersContextProps,\n  type TamboContextHelpersProviderProps,\n  type TamboRegistryContext,\n  type TamboStubProviderProps,\n} from \"./providers\";\n\n// Re-export types from Tambo Node SDK\nexport type {\n  APIError,\n  RateLimitError,\n  TamboAIError,\n} from \"@tambo-ai/typescript-sdk\";\nexport type {\n  Suggestion,\n  SuggestionGenerateParams,\n  SuggestionGenerateResponse,\n  SuggestionListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/beta/threads/suggestions\";\nexport { useTamboThreadList } from \"./hooks/use-tambo-threads\";\nexport {\n  type ComponentContextToolMetadata,\n  type ComponentRegistry,\n  type ParameterSpec,\n  type RegisteredComponent,\n  type TamboTool,\n} from \"./model/component-metadata\";\nexport {\n  GenerationStage,\n  type TamboThreadMessage,\n} from \"./model/generate-component-response\";\nexport { type TamboThread } from \"./model/tambo-thread\";\n\nexport type {\n  TamboInteractableComponent as InteractableComponent,\n  TamboInteractableContext,\n} from \"./model/tambo-interactable\";\nexport {\n  withTamboInteractable as withInteractable,\n  type InteractableConfig,\n  type WithTamboInteractableProps,\n} from \"./providers/hoc/with-tambo-interactable\";\nexport { useTamboInteractable } from \"./providers/tambo-interactable-provider\";\n\n// Context helpers exports\nexport {\n  DEFAULT_CONTEXT_HELPERS,\n  getUserPageContext,\n  getUserTimeContext,\n} from \"./context-helpers\";\nexport type {\n  AdditionalContext,\n  AdditionalContextHelper,\n  ContextHelpersConfig,\n} from \"./context-helpers\";\n"]}

package/dist/providers/__tests__/tambo-context-helpers-provider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tambo-context-helpers-provider.test.d.ts.map

package/dist/providers/__tests__/tambo-context-helpers-provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-context-helpers-provider.test.d.ts","sourceRoot":"","sources":["../../../src/providers/__tests__/tambo-context-helpers-provider.test.tsx"],"names":[],"mappings":""}

package/dist/providers/__tests__/tambo-context-helpers-provider.test.js

@@ -0,0 +1,194 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("@testing-library/react");
+const react_2 = __importDefault(require("react"));
+const contextHelpers = __importStar(require("../../context-helpers"));
+const context_helpers_1 = require("../../context-helpers");
+const tambo_context_helpers_provider_1 = require("../tambo-context-helpers-provider");
+describe("TamboContextHelpersProvider", () => {
+    // Create a wrapper component that provides the context for testing hooks
+    const wrapper = ({ children }) => (react_2.default.createElement(tambo_context_helpers_provider_1.TamboContextHelpersProvider, null, children));
+    describe("useTamboContextHelpers", () => {
+        /**
+         * Test: Hook throws error when used outside of provider
+         * This ensures developers get a clear error message if they forget to wrap
+         * their components with the TamboContextHelpersProvider
+         */
+        it("should throw error when used outside provider", () => {
+            // Mock console.error to prevent error output in test logs
+            const consoleSpy = jest
+                .spyOn(console, "error")
+                .mockImplementation(() => { });
+            // Verify that using the hook without a provider throws the expected error
+            expect(() => {
+                (0, react_1.renderHook)(() => (0, tambo_context_helpers_provider_1.useTamboContextHelpers)());
+            }).toThrow("useTamboContextHelpers must be used within a TamboContextHelpersProvider");
+            // Restore console.error to its original implementation
+            consoleSpy.mockRestore();
+        });
+        /**
+         * Test: Hook provides the expected API functions
+         * Verifies that all required functions are available when the hook is used
+         * within the provider context
+         */
+        it("should provide context helpers functions", () => {
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_context_helpers_provider_1.useTamboContextHelpers)(), {
+                wrapper,
+            });
+            // Verify all expected functions are present in the hook's return value
+            expect(result.current).toHaveProperty("getAdditionalContext");
+            expect(result.current).toHaveProperty("getContextHelpers");
+            expect(result.current).toHaveProperty("setContextHelperEnabled");
+        });
+        /**
+         * Test: Default configuration is applied correctly
+         * Ensures that the default context helpers are loaded with their
+         * expected enabled/disabled states
+         */
+        it("should return default context helpers configuration", () => {
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_context_helpers_provider_1.useTamboContextHelpers)(), {
+                wrapper,
+            });
+            const helpers = result.current.getContextHelpers();
+            // Verify we have the expected number of default helpers
+            expect(helpers).toHaveLength(context_helpers_1.DEFAULT_CONTEXT_HELPERS.length);
+            // Check specific helpers have their expected default states
+            const userTimeHelper = helpers.find((h) => h.name === "userTime");
+            const userPageHelper = helpers.find((h) => h.name === "userPage");
+            // userTime should be disabled by default
+            expect(userTimeHelper?.enabled).toBe(false);
+            // userPage should be disabled by default
+            expect(userPageHelper?.enabled).toBe(false);
+        });
+        /**
+         * Test: Context helper enabled state can be toggled
+         * Verifies that the setContextHelperEnabled function correctly updates
+         * the enabled state of individual helpers
+         */
+        it("should allow toggling context helper enabled state", () => {
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_context_helpers_provider_1.useTamboContextHelpers)(), {
+                wrapper,
+            });
+            // Enable the userPage helper using the provided function
+            (0, react_1.act)(() => {
+                result.current.setContextHelperEnabled("userPage", true);
+            });
+            // Verify the helper's state was updated
+            const helpers = result.current.getContextHelpers();
+            const userPageHelper = helpers.find((h) => h.name === "userPage");
+            expect(userPageHelper?.enabled).toBe(true);
+        });
+        /**
+         * Test: Only enabled helpers contribute to additional context
+         * Verifies that getAdditionalContext only runs and returns data from
+         * helpers that are currently enabled
+         */
+        it("should get additional context from enabled helpers", async () => {
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_context_helpers_provider_1.useTamboContextHelpers)(), {
+                wrapper,
+            });
+            const contexts = await result.current.getAdditionalContext();
+            // By default, no context helpers are enabled, so we should get no contexts
+            expect(contexts).toHaveLength(0);
+        });
+        /**
+         * Test: Provider respects configuration prop
+         * Verifies that initial configuration can be customized through the
+         * contextHelpers prop on the provider
+         */
+        it("should respect contextHelpers configuration prop", () => {
+            // Create a custom wrapper with specific configuration
+            const customWrapper = ({ children }) => (react_2.default.createElement(tambo_context_helpers_provider_1.TamboContextHelpersProvider, { contextHelpers: {
+                    userTime: false, // Disable userTime
+                    userPage: true, // Enable userPage
+                } }, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_context_helpers_provider_1.useTamboContextHelpers)(), {
+                wrapper: customWrapper,
+            });
+            // Verify the custom configuration is applied
+            const helpers = result.current.getContextHelpers();
+            const userTimeHelper = helpers.find((h) => h.name === "userTime");
+            const userPageHelper = helpers.find((h) => h.name === "userPage");
+            expect(userTimeHelper?.enabled).toBe(false);
+            expect(userPageHelper?.enabled).toBe(true);
+        });
+        /**
+         * Test: Errors in context helpers are handled gracefully
+         * Verifies that if a context helper throws an error, it doesn't crash
+         * the entire system and other helpers continue to work
+         */
+        it("should handle errors in context helper functions gracefully", async () => {
+            // Mock console.error to capture error logs
+            const consoleErrorSpy = jest
+                .spyOn(console, "error")
+                .mockImplementation(() => { });
+            // Create a helper that will throw an error when run
+            const errorHelper = {
+                name: "errorHelper",
+                enabled: true,
+                run: () => {
+                    throw new Error("Test error");
+                },
+            };
+            // Temporarily add the error helper to the default helpers
+            // Store original helpers to restore later
+            const originalHelpers = context_helpers_1.DEFAULT_CONTEXT_HELPERS;
+            Object.defineProperty(contextHelpers, "DEFAULT_CONTEXT_HELPERS", {
+                value: [...originalHelpers, errorHelper],
+                writable: true,
+            });
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_context_helpers_provider_1.useTamboContextHelpers)(), {
+                wrapper,
+            });
+            // Call getAdditionalContext, which should handle the error gracefully
+            const contexts = await result.current.getAdditionalContext();
+            // Should have no contexts because the error helper should be skipped
+            expect(contexts.length).toBe(0);
+            // Verify that the error was logged appropriately
+            expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining("Error running context helper errorHelper"), expect.any(Error));
+            // Restore the original helpers and console.error
+            Object.defineProperty(contextHelpers, "DEFAULT_CONTEXT_HELPERS", {
+                value: originalHelpers,
+                writable: true,
+            });
+            consoleErrorSpy.mockRestore();
+        });
+    });
+});
+//# sourceMappingURL=tambo-context-helpers-provider.test.js.map