@tambo-ai/react 0.42.1 → 0.43.1

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

@@ -0,0 +1,142 @@
+/**
+ * Tests for the Context Helpers API.
+ *
+ * The new API treats a context helper as a plain function that returns a value
+ * to include in context, or null/undefined to skip. The provider wraps each
+ * value with its key name as { name, context } before sending with messages.
+ *
+ * This test suite validates that:
+ *  - Helper functions can return sync/async values.
+ *  - Returning null/undefined causes the helper to be skipped.
+ *  - Errors in helpers are caught and skipped.
+ *  - The provider aggregates helpers passed in its props and returns AdditionalContext[].
+ */
+import { renderHook } from "@testing-library/react";
+import React from "react";
+import { setHelpers } from "../../context-helpers/registry";
+import { TamboContextHelpersProvider, useTamboContextHelpers, } from "../../providers/tambo-context-helpers-provider";
+import { currentPageContextHelper, currentTimeContextHelper, } from "../index";
+/**
+ * Test wrapper to provide the TamboContextHelpersProvider for hooks.
+ * @param helpers - A dictionary of context helper functions.
+ * @returns A wrapper component that provides the TamboContextHelpersProvider.
+ */
+function wrapper(helpers) {
+    // eslint-disable-next-line react/display-name
+    return ({ children }) => React.createElement(TamboContextHelpersProvider, {
+        contextHelpers: helpers,
+    }, children);
+}
+describe("Context Helpers API", () => {
+    // Ensure the global registry doesn't leak state between tests
+    beforeEach(() => {
+        setHelpers({});
+        jest.clearAllMocks();
+    });
+    test("returns empty array when no helpers provided", async () => {
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: wrapper(),
+        });
+        const contexts = await result.current.getAdditionalContext();
+        expect(Array.isArray(contexts)).toBe(true);
+        expect(contexts).toHaveLength(0);
+    });
+    test("collects sync and async helper results", async () => {
+        const syncHelper = () => ({ a: 1 });
+        const asyncHelper = async () => ({ b: 2 });
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: wrapper({
+                sync: syncHelper,
+                async: asyncHelper,
+            }),
+        });
+        const contexts = await result.current.getAdditionalContext();
+        // Validate shape and presence
+        const byName = new Map(contexts.map((c) => [c.name, c.context]));
+        expect(byName.get("sync")).toEqual({ a: 1 });
+        expect(byName.get("async")).toEqual({ b: 2 });
+    });
+    test("skips null and undefined results", async () => {
+        const nullHelper = () => null;
+        const undefinedHelper = () => undefined;
+        const validHelper = () => ({ ok: true });
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: wrapper({
+                nullHelper,
+                undefinedHelper,
+                validHelper,
+            }),
+        });
+        const contexts = await result.current.getAdditionalContext();
+        const names = contexts.map((c) => c.name);
+        expect(names).toContain("validHelper");
+        expect(names).not.toContain("nullHelper");
+        expect(names).not.toContain("undefinedHelper");
+    });
+    test("errors in helpers are caught and skipped", async () => {
+        const consoleSpy = jest.spyOn(console, "error").mockImplementation(() => {
+            // silence expected error
+        });
+        const badHelper = () => {
+            throw new Error("boom");
+        };
+        const goodHelper = () => ({ ok: 1 });
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: wrapper({ badHelper, goodHelper }),
+        });
+        const contexts = await result.current.getAdditionalContext();
+        expect(contexts).toHaveLength(1);
+        expect(contexts[0]).toEqual({
+            name: "goodHelper",
+            context: { ok: 1 },
+        });
+        consoleSpy.mockRestore();
+    });
+    test("dynamic add/remove helpers works", async () => {
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: wrapper(),
+        });
+        // Initially empty
+        expect(await result.current.getAdditionalContext()).toHaveLength(0);
+        // Add
+        result.current.addContextHelper("dyn", () => ({ x: 10 }));
+        let contexts = await result.current.getAdditionalContext();
+        expect(contexts).toHaveLength(1);
+        expect(contexts[0]).toEqual({
+            name: "dyn",
+            context: { x: 10 },
+        });
+        // Update
+        result.current.addContextHelper("dyn", () => ({ x: 20 }));
+        contexts = await result.current.getAdditionalContext();
+        expect(contexts).toHaveLength(1);
+        expect(contexts[0]).toEqual({
+            name: "dyn",
+            context: { x: 20 },
+        });
+        // Remove
+        result.current.removeContextHelper("dyn");
+        contexts = await result.current.getAdditionalContext();
+        expect(contexts).toHaveLength(0);
+    });
+    test("prebuilt helpers can be passed directly", async () => {
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: wrapper({
+                userTime: currentTimeContextHelper,
+                userPage: currentPageContextHelper,
+            }),
+        });
+        const contexts = await result.current.getAdditionalContext();
+        // Should include both entries unless environment prevents userPage (SSR)
+        const names = contexts.map((c) => c.name);
+        expect(names).toContain("userTime");
+        // userPage may be null on non-browser envs; allow either outcome:
+        // if present, ensure expected keys exist
+        if (names.includes("userPage")) {
+            const userPage = contexts.find((c) => c.name === "userPage").context;
+            expect(typeof userPage.url === "string" || userPage.url === undefined).toBe(true);
+            expect(typeof userPage.title === "string" || userPage.title === undefined).toBe(true);
+        }
+    });
+});
+//# sourceMappingURL=context-helpers-provider.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-helpers-provider.test.js","sourceRoot":"","sources":["../../../src/context-helpers/__tests__/context-helpers-provider.test.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tests for the Context Helpers API.\n *\n * The new API treats a context helper as a plain function that returns a value\n * to include in context, or null/undefined to skip. The provider wraps each\n * value with its key name as { name, context } before sending with messages.\n *\n * This test suite validates that:\n *  - Helper functions can return sync/async values.\n *  - Returning null/undefined causes the helper to be skipped.\n *  - Errors in helpers are caught and skipped.\n *  - The provider aggregates helpers passed in its props and returns AdditionalContext[].\n */\n\nimport { renderHook } from \"@testing-library/react\";\nimport React, { PropsWithChildren } from \"react\";\nimport { setHelpers } from \"../../context-helpers/registry\";\nimport {\n  TamboContextHelpersProvider,\n  useTamboContextHelpers,\n} from \"../../providers/tambo-context-helpers-provider\";\nimport {\n  type AdditionalContext,\n  type ContextHelperFn,\n  currentPageContextHelper,\n  currentTimeContextHelper,\n} from \"../index\";\n\n/**\n * Test wrapper to provide the TamboContextHelpersProvider for hooks.\n * @param helpers - A dictionary of context helper functions.\n * @returns A wrapper component that provides the TamboContextHelpersProvider.\n */\nfunction wrapper(helpers?: Record<string, ContextHelperFn>) {\n  // eslint-disable-next-line react/display-name\n  return ({ children }: PropsWithChildren) =>\n    React.createElement(\n      TamboContextHelpersProvider,\n      {\n        contextHelpers: helpers,\n      },\n      children,\n    );\n}\n\ndescribe(\"Context Helpers API\", () => {\n  // Ensure the global registry doesn't leak state between tests\n  beforeEach(() => {\n    setHelpers({});\n    jest.clearAllMocks();\n  });\n\n  test(\"returns empty array when no helpers provided\", async () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: wrapper(),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n    expect(Array.isArray(contexts)).toBe(true);\n    expect(contexts).toHaveLength(0);\n  });\n\n  test(\"collects sync and async helper results\", async () => {\n    const syncHelper: ContextHelperFn = () => ({ a: 1 });\n    const asyncHelper: ContextHelperFn = async () => ({ b: 2 });\n\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: wrapper({\n        sync: syncHelper,\n        async: asyncHelper,\n      }),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n\n    // Validate shape and presence\n    const byName = new Map(contexts.map((c) => [c.name, c.context]));\n    expect(byName.get(\"sync\")).toEqual({ a: 1 });\n    expect(byName.get(\"async\")).toEqual({ b: 2 });\n  });\n\n  test(\"skips null and undefined results\", async () => {\n    const nullHelper: ContextHelperFn = () => null;\n    const undefinedHelper: ContextHelperFn = () => undefined;\n    const validHelper: ContextHelperFn = () => ({ ok: true });\n\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: wrapper({\n        nullHelper,\n        undefinedHelper,\n        validHelper,\n      }),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n    const names = contexts.map((c) => c.name);\n\n    expect(names).toContain(\"validHelper\");\n    expect(names).not.toContain(\"nullHelper\");\n    expect(names).not.toContain(\"undefinedHelper\");\n  });\n\n  test(\"errors in helpers are caught and skipped\", async () => {\n    const consoleSpy = jest.spyOn(console, \"error\").mockImplementation(() => {\n      // silence expected error\n    });\n\n    const badHelper: ContextHelperFn = () => {\n      throw new Error(\"boom\");\n    };\n    const goodHelper: ContextHelperFn = () => ({ ok: 1 });\n\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: wrapper({ badHelper, goodHelper }),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n    expect(contexts).toHaveLength(1);\n    expect(contexts[0]).toEqual<AdditionalContext>({\n      name: \"goodHelper\",\n      context: { ok: 1 },\n    });\n\n    consoleSpy.mockRestore();\n  });\n\n  test(\"dynamic add/remove helpers works\", async () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: wrapper(),\n    });\n\n    // Initially empty\n    expect(await result.current.getAdditionalContext()).toHaveLength(0);\n\n    // Add\n    result.current.addContextHelper(\"dyn\", () => ({ x: 10 }));\n    let contexts = await result.current.getAdditionalContext();\n    expect(contexts).toHaveLength(1);\n    expect(contexts[0]).toEqual<AdditionalContext>({\n      name: \"dyn\",\n      context: { x: 10 },\n    });\n\n    // Update\n    result.current.addContextHelper(\"dyn\", () => ({ x: 20 }));\n    contexts = await result.current.getAdditionalContext();\n    expect(contexts).toHaveLength(1);\n    expect(contexts[0]).toEqual<AdditionalContext>({\n      name: \"dyn\",\n      context: { x: 20 },\n    });\n\n    // Remove\n    result.current.removeContextHelper(\"dyn\");\n    contexts = await result.current.getAdditionalContext();\n    expect(contexts).toHaveLength(0);\n  });\n\n  test(\"prebuilt helpers can be passed directly\", async () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: wrapper({\n        userTime: currentTimeContextHelper,\n        userPage: currentPageContextHelper,\n      }),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n\n    // Should include both entries unless environment prevents userPage (SSR)\n    const names = contexts.map((c) => c.name);\n    expect(names).toContain(\"userTime\");\n    // userPage may be null on non-browser envs; allow either outcome:\n    // if present, ensure expected keys exist\n    if (names.includes(\"userPage\")) {\n      const userPage = contexts.find((c) => c.name === \"userPage\")!.context as {\n        url?: string;\n        title?: string;\n      };\n      expect(\n        typeof userPage.url === \"string\" || userPage.url === undefined,\n      ).toBe(true);\n      expect(\n        typeof userPage.title === \"string\" || userPage.title === undefined,\n      ).toBe(true);\n    }\n  });\n});\n"]}

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

@@ -1,41 +1,36 @@
-import { getUserPageContext, getUserTimeContext } from "../index";
-describe("Context Helpers", () => {
-    describe("getUserTimeContext", () => {
-        it("should return user time context with all required fields", () => {
-            const context = 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();
+import { currentPageContextHelper, currentTimeContextHelper } from "../index";
+/**
+ * Tests for prebuilt context helper functions.
+ *
+ * These helpers now return raw values (or null) instead of { name, context }.
+ * The provider is responsible for wrapping values as { name, context }.
+ */
+describe("Context Helpers (prebuilt functions)", () => {
+    describe("currentTimeContextHelper", () => {
+        it("should return user time context with required fields", () => {
+            const context = currentTimeContextHelper();
+            // Should not be null (error case)
+            expect(context).not.toBeNull();
+            // Shape: { timestamp: string }
+            expect(context).toHaveProperty("timestamp");
+            expect(typeof context.timestamp).toBe("string");
+            // Verify timestamp string parses
+            expect(() => new Date(context.timestamp)).not.toThrow();
         });
     });
-    describe("getUserPageContext", () => {
-        it("should return page context with default values in test environment", () => {
-            const context = 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");
+    describe("currentPageContextHelper", () => {
+        it("should return page context in browser, or null otherwise", () => {
+            const context = currentPageContextHelper();
+            if (context === null) {
+                // Non-browser environments should return null to skip
+                expect(context).toBeNull();
+                return;
+            }
+            // Shape: { url: string, title: string }
+            expect(context).toHaveProperty("url");
+            expect(context).toHaveProperty("title");
+            expect(typeof context.url).toBe("string");
+            expect(typeof context.title).toBe("string");
         });
     });
 });

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

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

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

@@ -0,0 +1,7 @@
+import { ContextHelperFn } from "./types";
+/**
+ * Prebuilt context helper that provides information about the user's current page.
+ * @returns a value to include it, or null/undefined to skip.
+ */
+export declare const currentPageContextHelper: ContextHelperFn;
+//# sourceMappingURL=current-page-context-helper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"current-page-context-helper.d.ts","sourceRoot":"","sources":["../../src/context-helpers/current-page-context-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAatC,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * Prebuilt context helper that provides information about the user's current page.
+ * @returns a value to include it, or null/undefined to skip.
+ */
+export const currentPageContextHelper = () => {
+    try {
+        if (typeof window === "undefined") {
+            return null;
+        }
+        return {
+            url: window.location.href,
+            title: document.title,
+        };
+    }
+    catch (e) {
+        console.error("prebuiltUserPage failed:", e);
+        return null;
+    }
+};
+//# sourceMappingURL=current-page-context-helper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"current-page-context-helper.js","sourceRoot":"","sources":["../../src/context-helpers/current-page-context-helper.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAoB,GAAG,EAAE;IAC5D,IAAI,CAAC;QACH,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;YACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,CAAC,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC","sourcesContent":["import { ContextHelperFn } from \"./types\";\n\n/**\n * Prebuilt context helper that provides information about the user's current page.\n * @returns a value to include it, or null/undefined to skip.\n */\nexport const currentPageContextHelper: ContextHelperFn = () => {\n  try {\n    if (typeof window === \"undefined\") {\n      return null;\n    }\n    return {\n      url: window.location.href,\n      title: document.title,\n    };\n  } catch (e) {\n    console.error(\"prebuiltUserPage failed:\", e);\n    return null;\n  }\n};\n"]}

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

@@ -0,0 +1,7 @@
+import { ContextHelperFn } from "./types";
+/**
+ * Prebuilt context helper that provides information about the user's current time.
+ * @returns a value to include it, or null/undefined to skip.
+ */
+export declare const currentTimeContextHelper: ContextHelperFn;
+//# sourceMappingURL=current-time-context-helper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"current-time-context-helper.d.ts","sourceRoot":"","sources":["../../src/context-helpers/current-time-context-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAUtC,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Prebuilt context helper that provides information about the user's current time.
+ * @returns a value to include it, or null/undefined to skip.
+ */
+export const currentTimeContextHelper = () => {
+    try {
+        const now = new Date();
+        return {
+            timestamp: now.toString(),
+        };
+    }
+    catch (e) {
+        console.error("prebuiltUserTime failed:", e);
+        return null;
+    }
+};
+//# sourceMappingURL=current-time-context-helper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"current-time-context-helper.js","sourceRoot":"","sources":["../../src/context-helpers/current-time-context-helper.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAoB,GAAG,EAAE;IAC5D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO;YACL,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE;SAC1B,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,CAAC,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC","sourcesContent":["import { ContextHelperFn } from \"./types\";\n\n/**\n * Prebuilt context helper that provides information about the user's current time.\n * @returns a value to include it, or null/undefined to skip.\n */\nexport const currentTimeContextHelper: ContextHelperFn = () => {\n  try {\n    const now = new Date();\n    return {\n      timestamp: now.toString(),\n    };\n  } catch (e) {\n    console.error(\"prebuiltUserTime failed:\", e);\n    return null;\n  }\n};\n"]}

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

@@ -1,9 +1,4 @@
-import { AdditionalContextHelper } from "./types";
+export * from "./current-page-context-helper";
+export * from "./current-time-context-helper";
 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/esm/context-helpers/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context-helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,SAAS,CAAC"}

package/esm/context-helpers/index.js

@@ -1,21 +1,4 @@
-import { getUserPageContext } from "./user-page";
-import { getUserTimeContext } from "./user-time";
+export * from "./current-page-context-helper";
+export * from "./current-time-context-helper";
 export * from "./types";
-export * from "./user-page";
-export * from "./user-time";
-/**
- * Pre-built context helpers that can be enabled/disabled
- */
-export const DEFAULT_CONTEXT_HELPERS = [
-    {
-        name: "userTime",
-        enabled: false, // Default to disabled
-        run: getUserTimeContext,
-    },
-    {
-        name: "userPage",
-        enabled: false, // Default to disabled
-        run: getUserPageContext,
-    },
-];
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context-helpers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAE5B;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA8B;IAChE;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,KAAK,EAAE,sBAAsB;QACtC,GAAG,EAAE,kBAAkB;KACxB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,KAAK,EAAE,sBAAsB;QACtC,GAAG,EAAE,kBAAkB;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"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context-helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,SAAS,CAAC","sourcesContent":["export * from \"./current-page-context-helper\";\nexport * from \"./current-time-context-helper\";\nexport * from \"./types\";\n"]}

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

@@ -0,0 +1,35 @@
+/**
+ * Global context helpers registry.
+ * Consumers can add/remove helpers and resolve additional context anywhere.
+ */
+export type HelperFn = () => any | null | undefined | Promise<any | null | undefined>;
+/**
+ * Get the current helpers map (by reference).
+ * @returns The current helpers map.
+ */
+export declare function getHelpers(): Record<string, HelperFn>;
+/**
+ * Replace the entire helpers map (used for hydration/reset in tests).
+ * @param next - The new helpers map.
+ */
+export declare function setHelpers(next: Record<string, HelperFn>): void;
+/**
+ * Add or replace a helper.
+ * @param name - The name of the helper.
+ * @param fn - The helper function.
+ */
+export declare function addHelper(name: string, fn: HelperFn): void;
+/**
+ * Remove a helper by name.
+ * @param name - The name of the helper.
+ */
+export declare function removeHelper(name: string): void;
+/**
+ * Resolve all helpers to AdditionalContext entries, skipping null/undefined and errors.
+ * @returns The resolved additional context.
+ */
+export declare function resolveAdditionalContext(): Promise<{
+    name: string;
+    context: any;
+}[]>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/context-helpers/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,MACnB,GAAG,GACH,IAAI,GACJ,SAAS,GACT,OAAO,CAAC,GAAG,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAIpC;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAErD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,QAExD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,QAEnD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,QAExC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CACvD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,EAAE,CACjC,CAkBA"}

package/esm/context-helpers/registry.js

@@ -0,0 +1,57 @@
+/**
+ * Global context helpers registry.
+ * Consumers can add/remove helpers and resolve additional context anywhere.
+ */
+let helpers = {};
+/**
+ * Get the current helpers map (by reference).
+ * @returns The current helpers map.
+ */
+export function getHelpers() {
+    return helpers;
+}
+/**
+ * Replace the entire helpers map (used for hydration/reset in tests).
+ * @param next - The new helpers map.
+ */
+export function setHelpers(next) {
+    helpers = next;
+}
+/**
+ * Add or replace a helper.
+ * @param name - The name of the helper.
+ * @param fn - The helper function.
+ */
+export function addHelper(name, fn) {
+    helpers[name] = fn;
+}
+/**
+ * Remove a helper by name.
+ * @param name - The name of the helper.
+ */
+export function removeHelper(name) {
+    delete helpers[name];
+}
+/**
+ * Resolve all helpers to AdditionalContext entries, skipping null/undefined and errors.
+ * @returns The resolved additional context.
+ */
+export async function resolveAdditionalContext() {
+    const entries = Object.entries(helpers);
+    if (entries.length === 0)
+        return [];
+    const results = await Promise.all(entries.map(async ([name, fn]) => {
+        try {
+            const value = await fn();
+            if (value == null)
+                return null;
+            return { name, context: value };
+        }
+        catch (error) {
+            console.error(`Error running context helper ${name}:`, error);
+            return null;
+        }
+    }));
+    return results.filter(Boolean);
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/context-helpers/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,IAAI,OAAO,GAA6B,EAAE,CAAC;AAE3C;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAA8B;IACvD,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,EAAY;IAClD,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAG5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QAC/B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,EAAE,EAAE,CAAC;YACzB,IAAI,KAAK,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC;YAC/B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAqC,CAAC;AACrE,CAAC","sourcesContent":["/**\n * Global context helpers registry.\n * Consumers can add/remove helpers and resolve additional context anywhere.\n */\n\nexport type HelperFn = () =>\n  | any\n  | null\n  | undefined\n  | Promise<any | null | undefined>;\n\nlet helpers: Record<string, HelperFn> = {};\n\n/**\n * Get the current helpers map (by reference).\n * @returns The current helpers map.\n */\nexport function getHelpers(): Record<string, HelperFn> {\n  return helpers;\n}\n\n/**\n * Replace the entire helpers map (used for hydration/reset in tests).\n * @param next - The new helpers map.\n */\nexport function setHelpers(next: Record<string, HelperFn>) {\n  helpers = next;\n}\n\n/**\n * Add or replace a helper.\n * @param name - The name of the helper.\n * @param fn - The helper function.\n */\nexport function addHelper(name: string, fn: HelperFn) {\n  helpers[name] = fn;\n}\n\n/**\n * Remove a helper by name.\n * @param name - The name of the helper.\n */\nexport function removeHelper(name: string) {\n  delete helpers[name];\n}\n\n/**\n * Resolve all helpers to AdditionalContext entries, skipping null/undefined and errors.\n * @returns The resolved additional context.\n */\nexport async function resolveAdditionalContext(): Promise<\n  { name: string; context: any }[]\n> {\n  const entries = Object.entries(helpers);\n  if (entries.length === 0) return [];\n\n  const results = await Promise.all(\n    entries.map(async ([name, fn]) => {\n      try {\n        const value = await fn();\n        if (value == null) return null;\n        return { name, context: value };\n      } catch (error) {\n        console.error(`Error running context helper ${name}:`, error);\n        return null;\n      }\n    }),\n  );\n\n  return results.filter(Boolean) as { name: string; context: any }[];\n}\n"]}

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

@@ -8,23 +8,13 @@ export interface AdditionalContext {
     context: any;
 }
 /**
- * Interface for a context helper that can generate additional context
+ * A context helper is a function that returns data to include in the context,
+ * or null/undefined to skip including anything.
  */
-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>;
-}
+export type ContextHelperFn = () => any | null | undefined | Promise<any | null | undefined>;
 /**
- * Configuration for context helpers
+ * A collection of context helpers keyed by their context name.
+ * The key becomes the AdditionalContext.name sent to the model.
  */
-export interface ContextHelpersConfig {
-    /** Enable/disable user time context helper */
-    userTime?: boolean;
-    /** Enable/disable user page context helper */
-    userPage?: boolean;
-}
+export type ContextHelpers = Record<string, ContextHelperFn>;
 //# sourceMappingURL=types.d.ts.map

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

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

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

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

package/esm/index.d.ts

@@ -15,6 +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";
+export { currentPageContextHelper, currentTimeContextHelper, } from "./context-helpers";
+export type { AdditionalContext, ContextHelperFn, ContextHelpers, } from "./context-helpers";
 //# sourceMappingURL=index.d.ts.map

package/esm/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,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"}
+{"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,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,mBAAmB,CAAC"}

package/esm/index.js

@@ -12,5 +12,5 @@ export { GenerationStage, } from "./model/generate-component-response";
 export { withTamboInteractable as withInteractable, } from "./providers/hoc/with-tambo-interactable";
 export { useTamboInteractable } from "./providers/tambo-interactable-provider";
 // Context helpers exports
-export { DEFAULT_CONTEXT_HELPERS, getUserPageContext, getUserTimeContext, } from "./context-helpers";
+export { currentPageContextHelper, currentTimeContextHelper, } from "./context-helpers";
 //# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","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,GAGrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,gCAAgC;AAChC,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,GAMf,MAAM,aAAa,CAAC;AAcrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQ/D,OAAO,EACL,eAAe,GAEhB,MAAM,qCAAqC,CAAC;AAO7C,OAAO,EACL,qBAAqB,IAAI,gBAAgB,GAG1C,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E,0BAA0B;AAC1B,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC","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"]}
+{"version":3,"file":"index.js","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,GAGrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,gCAAgC;AAChC,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,GAMf,MAAM,aAAa,CAAC;AAcrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQ/D,OAAO,EACL,eAAe,GAEhB,MAAM,qCAAqC,CAAC;AAO7C,OAAO,EACL,qBAAqB,IAAI,gBAAgB,GAG1C,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E,0BAA0B;AAC1B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC","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  currentPageContextHelper,\n  currentTimeContextHelper,\n} from \"./context-helpers\";\nexport type {\n  AdditionalContext,\n  ContextHelperFn,\n  ContextHelpers,\n} from \"./context-helpers\";\n"]}