@tambo-ai/react 0.12.0

package/dist/hooks/use-tambo-threads.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Get the threads for the specified project and optional context key.
+ */
+export declare function useTamboThreads({ projectId, contextKey, }?: {
+    projectId?: string;
+    contextKey?: string;
+}): import("@tanstack/query-core").QueryObserverRefetchErrorResult<import("@tambo-ai/typescript-sdk/resources/beta/threads/threads").ThreadsOffsetAndLimit | null, Error> | import("@tanstack/query-core").QueryObserverSuccessResult<import("@tambo-ai/typescript-sdk/resources/beta/threads/threads").ThreadsOffsetAndLimit | null, Error> | import("@tanstack/query-core").QueryObserverLoadingErrorResult<import("@tambo-ai/typescript-sdk/resources/beta/threads/threads").ThreadsOffsetAndLimit | null, Error> | import("@tanstack/query-core").QueryObserverPendingResult<import("@tambo-ai/typescript-sdk/resources/beta/threads/threads").ThreadsOffsetAndLimit | null, Error> | import("@tanstack/query-core").QueryObserverPlaceholderResult<import("@tambo-ai/typescript-sdk/resources/beta/threads/threads").ThreadsOffsetAndLimit | null, Error> | {
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<string, Error>>;
+    fetchStatus: import("@tanstack/query-core").FetchStatus;
+    promise: Promise<string>;
+    data: null;
+} | {
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<string, Error>>;
+    fetchStatus: import("@tanstack/query-core").FetchStatus;
+    promise: Promise<string>;
+    data: null;
+} | {
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<string, Error>>;
+    fetchStatus: import("@tanstack/query-core").FetchStatus;
+    promise: Promise<string>;
+    data: null;
+} | {
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<string, Error>>;
+    fetchStatus: import("@tanstack/query-core").FetchStatus;
+    promise: Promise<string>;
+    data: null;
+} | {
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<string, Error>>;
+    fetchStatus: import("@tanstack/query-core").FetchStatus;
+    promise: Promise<string>;
+    data: null;
+};

package/dist/hooks/use-tambo-threads.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTamboThreads = useTamboThreads;
+const tambo_client_provider_1 = require("../providers/tambo-client-provider");
+const react_query_hooks_1 = require("./react-query-hooks");
+/**
+ * Get the threads for the specified project and optional context key.
+ */
+function useTamboThreads({ projectId, contextKey, } = {}) {
+    const client = (0, tambo_client_provider_1.useTamboClient)();
+    const { data: queriedProjectId, ...projectIdState } = (0, react_query_hooks_1.useTamboQuery)({
+        queryKey: ["projectId"],
+        queryFn: async () => {
+            return (await client.beta.projects.getCurrent()).id;
+        },
+    });
+    const currentProjectId = projectId ?? queriedProjectId;
+    const threadState = (0, react_query_hooks_1.useTamboQuery)({
+        enabled: !!currentProjectId,
+        queryKey: ["threads", currentProjectId, contextKey],
+        queryFn: async () => {
+            if (!currentProjectId) {
+                return null;
+            }
+            const threadIter = await client.beta.threads.list(currentProjectId, {
+                contextKey,
+            });
+            return threadIter;
+        },
+    });
+    return currentProjectId ? threadState : { data: null, ...projectIdState };
+}
+//# sourceMappingURL=use-tambo-threads.js.map

package/dist/hooks/use-tambo-threads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-threads.js","sourceRoot":"","sources":["../../src/hooks/use-tambo-threads.ts"],"names":[],"mappings":";;AAMA,0CA+BC;AArCD,8EAAoE;AACpE,2DAAoD;AAEpD;;GAEG;AACH,SAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,UAAU,MAIR,EAAE;IACJ,MAAM,MAAM,GAAG,IAAA,sCAAc,GAAE,CAAC;IAChC,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,cAAc,EAAE,GAAG,IAAA,iCAAa,EAAC;QAClE,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,OAAO,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC;QACtD,CAAC;KACF,CAAC,CAAC;IACH,MAAM,gBAAgB,GAAG,SAAS,IAAI,gBAAgB,CAAC;IAEvD,MAAM,WAAW,GAAG,IAAA,iCAAa,EAAC;QAChC,OAAO,EAAE,CAAC,CAAC,gBAAgB;QAC3B,QAAQ,EAAE,CAAC,SAAS,EAAE,gBAAgB,EAAE,UAAU,CAAC;QACnD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE;gBAClE,UAAU;aACX,CAAC,CAAC;YACH,OAAO,UAAU,CAAC;QACpB,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAAC;AAC5E,CAAC","sourcesContent":["import { useTamboClient } from \"../providers/tambo-client-provider\";\nimport { useTamboQuery } from \"./react-query-hooks\";\n\n/**\n * Get the threads for the specified project and optional context key.\n */\nexport function useTamboThreads({\n  projectId,\n  contextKey,\n}: {\n  projectId?: string;\n  contextKey?: string;\n} = {}) {\n  const client = useTamboClient();\n  const { data: queriedProjectId, ...projectIdState } = useTamboQuery({\n    queryKey: [\"projectId\"],\n    queryFn: async () => {\n      return (await client.beta.projects.getCurrent()).id;\n    },\n  });\n  const currentProjectId = projectId ?? queriedProjectId;\n\n  const threadState = useTamboQuery({\n    enabled: !!currentProjectId,\n    queryKey: [\"threads\", currentProjectId, contextKey],\n    queryFn: async () => {\n      if (!currentProjectId) {\n        return null;\n      }\n      const threadIter = await client.beta.threads.list(currentProjectId, {\n        contextKey,\n      });\n      return threadIter;\n    },\n  });\n\n  return currentProjectId ? threadState : { data: null, ...projectIdState };\n}\n"]}

package/dist/hooks/use-thread-input.d.ts

@@ -0,0 +1,48 @@
+import { UseMutationResult } from "@tanstack/react-query";
+/**
+ * Error messages for various input-related error scenarios
+ * These messages are used to provide user-friendly error feedback
+ * @readonly
+ */
+export declare const INPUT_ERROR_MESSAGES: {
+    /** Error when attempting to submit empty input */
+    readonly EMPTY: "Message cannot be empty";
+    /** Error when network connection fails */
+    readonly NETWORK: "Network error. Please check your connection";
+    /** Error when server fails to process the request */
+    readonly SERVER: "Server error. Please try again";
+    /** Error when input format is invalid */
+    readonly VALIDATION: "Invalid message format";
+};
+/**
+ * Interface for the thread input hook return value
+ * Provides all necessary functions and state for managing thread input
+ */
+interface UseThreadInputInternal {
+    /** Current value of the input field */
+    value: string;
+    /**
+     * Function to update the input value
+     * @param value - New value for the input field
+     */
+    setValue: (value: string) => void;
+    /**
+     * Function to submit the current input value
+     * Validates input, handles errors, and cleans up state after submission
+     * @throws {ThreadInputError} If submission fails
+     * @returns Promise that resolves when submission is complete
+     */
+    submit: (options?: {
+        contextKey?: string;
+    }) => Promise<void>;
+}
+export type UseThreadInput = UseThreadInputInternal & UseMutationResult<void, Error, {
+    contextKey?: string;
+}>;
+/**
+ * Hook for managing thread message input state and submission
+ *
+ * @returns Interface for managing thread input state and submission
+ */
+export declare function useTamboThreadInput(contextKey?: string): UseThreadInput;
+export {};

package/dist/hooks/use-thread-input.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INPUT_ERROR_MESSAGES = void 0;
+exports.useTamboThreadInput = useTamboThreadInput;
+const react_1 = require("react");
+const thread_input_error_1 = require("../model/thread-input-error");
+const validate_input_1 = require("../model/validate-input");
+const tambo_thread_provider_1 = require("../providers/tambo-thread-provider");
+const react_query_hooks_1 = require("./react-query-hooks");
+/**
+ * Error messages for various input-related error scenarios
+ * These messages are used to provide user-friendly error feedback
+ * @readonly
+ */
+exports.INPUT_ERROR_MESSAGES = {
+    /** Error when attempting to submit empty input */
+    EMPTY: "Message cannot be empty",
+    /** Error when network connection fails */
+    NETWORK: "Network error. Please check your connection",
+    /** Error when server fails to process the request */
+    SERVER: "Server error. Please try again",
+    /** Error when input format is invalid */
+    VALIDATION: "Invalid message format",
+};
+/**
+ * Hook for managing thread message input state and submission
+ *
+ * @returns Interface for managing thread input state and submission
+ */
+function useTamboThreadInput(contextKey) {
+    const { thread, inputValue, setInputValue, sendThreadMessage } = (0, tambo_thread_provider_1.useTamboThread)();
+    const submit = (0, react_1.useCallback)(async ({ contextKey: submitContextKey } = {}) => {
+        const validation = (0, validate_input_1.validateInput)(inputValue);
+        if (!validation.isValid) {
+            throw new thread_input_error_1.ThreadInputError(`Cannot submit message: ${validation.error ?? exports.INPUT_ERROR_MESSAGES.VALIDATION}`, { cause: validation.error });
+        }
+        await sendThreadMessage(validation.sanitizedInput, {
+            threadId: thread.id,
+            contextKey: submitContextKey ?? contextKey ?? undefined,
+        });
+        setInputValue("");
+    }, [inputValue, sendThreadMessage, thread.id, contextKey, setInputValue]);
+    const { mutateAsync: submitAsync, mutate: _unusedSubmit, ...mutationState } = (0, react_query_hooks_1.useTamboMutation)({
+        mutationFn: submit,
+    });
+    return {
+        ...mutationState,
+        value: inputValue,
+        setValue: setInputValue,
+        submit: submitAsync,
+    };
+}
+//# sourceMappingURL=use-thread-input.js.map

package/dist/hooks/use-thread-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-thread-input.js","sourceRoot":"","sources":["../../src/hooks/use-thread-input.ts"],"names":[],"mappings":";;;AAmDA,kDAoCC;AAtFD,iCAAoC;AACpC,oEAA+D;AAC/D,4DAAwD;AACxD,8EAAoE;AACpE,2DAAuD;AAEvD;;;;GAIG;AACU,QAAA,oBAAoB,GAAG;IAClC,kDAAkD;IAClD,KAAK,EAAE,yBAAyB;IAChC,0CAA0C;IAC1C,OAAO,EAAE,6CAA6C;IACtD,qDAAqD;IACrD,MAAM,EAAE,gCAAgC;IACxC,yCAAyC;IACzC,UAAU,EAAE,wBAAwB;CAC5B,CAAC;AAyBX;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,UAAmB;IACrD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,GAC5D,IAAA,sCAAc,GAAE,CAAC;IAEnB,MAAM,MAAM,GAAG,IAAA,mBAAW,EACxB,KAAK,EAAE,EAAE,UAAU,EAAE,gBAAgB,KAA8B,EAAE,EAAE,EAAE;QACvE,MAAM,UAAU,GAAG,IAAA,8BAAa,EAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,qCAAgB,CACxB,0BAA0B,UAAU,CAAC,KAAK,IAAI,4BAAoB,CAAC,UAAU,EAAE,EAC/E,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAC5B,CAAC;QACJ,CAAC;QAED,MAAM,iBAAiB,CAAC,UAAU,CAAC,cAAc,EAAE;YACjD,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,UAAU,EAAE,gBAAgB,IAAI,UAAU,IAAI,SAAS;SACxD,CAAC,CAAC;QACH,aAAa,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC,EACD,CAAC,UAAU,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,aAAa,CAAC,CACtE,CAAC;IACF,MAAM,EACJ,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,aAAa,EACrB,GAAG,aAAa,EACjB,GAAG,IAAA,oCAAgB,EAAC;QACnB,UAAU,EAAE,MAAM;KACnB,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,aAAa;QAChB,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,aAAa;QACvB,MAAM,EAAE,WAAW;KACF,CAAC;AACtB,CAAC","sourcesContent":["import { UseMutationResult } from \"@tanstack/react-query\";\nimport { useCallback } from \"react\";\nimport { ThreadInputError } from \"../model/thread-input-error\";\nimport { validateInput } from \"../model/validate-input\";\nimport { useTamboThread } from \"../providers/tambo-thread-provider\";\nimport { useTamboMutation } from \"./react-query-hooks\";\n\n/**\n * Error messages for various input-related error scenarios\n * These messages are used to provide user-friendly error feedback\n * @readonly\n */\nexport const INPUT_ERROR_MESSAGES = {\n  /** Error when attempting to submit empty input */\n  EMPTY: \"Message cannot be empty\",\n  /** Error when network connection fails */\n  NETWORK: \"Network error. Please check your connection\",\n  /** Error when server fails to process the request */\n  SERVER: \"Server error. Please try again\",\n  /** Error when input format is invalid */\n  VALIDATION: \"Invalid message format\",\n} as const;\n\n/**\n * Interface for the thread input hook return value\n * Provides all necessary functions and state for managing thread input\n */\ninterface UseThreadInputInternal {\n  /** Current value of the input field */\n  value: string;\n  /**\n   * Function to update the input value\n   * @param value - New value for the input field\n   */\n  setValue: (value: string) => void;\n  /**\n   * Function to submit the current input value\n   * Validates input, handles errors, and cleans up state after submission\n   * @throws {ThreadInputError} If submission fails\n   * @returns Promise that resolves when submission is complete\n   */\n  submit: (options?: { contextKey?: string }) => Promise<void>;\n}\nexport type UseThreadInput = UseThreadInputInternal &\n  UseMutationResult<void, Error, { contextKey?: string }>;\n\n/**\n * Hook for managing thread message input state and submission\n *\n * @returns Interface for managing thread input state and submission\n */\nexport function useTamboThreadInput(contextKey?: string): UseThreadInput {\n  const { thread, inputValue, setInputValue, sendThreadMessage } =\n    useTamboThread();\n\n  const submit = useCallback(\n    async ({ contextKey: submitContextKey }: { contextKey?: string } = {}) => {\n      const validation = validateInput(inputValue);\n      if (!validation.isValid) {\n        throw new ThreadInputError(\n          `Cannot submit message: ${validation.error ?? INPUT_ERROR_MESSAGES.VALIDATION}`,\n          { cause: validation.error },\n        );\n      }\n\n      await sendThreadMessage(validation.sanitizedInput, {\n        threadId: thread.id,\n        contextKey: submitContextKey ?? contextKey ?? undefined,\n      });\n      setInputValue(\"\");\n    },\n    [inputValue, sendThreadMessage, thread.id, contextKey, setInputValue],\n  );\n  const {\n    mutateAsync: submitAsync,\n    mutate: _unusedSubmit,\n    ...mutationState\n  } = useTamboMutation({\n    mutationFn: submit,\n  });\n\n  return {\n    ...mutationState,\n    value: inputValue,\n    setValue: setInputValue,\n    submit: submitAsync,\n  } as UseThreadInput;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/** 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. */
+export { useTamboComponentState } from "./hooks/use-component-state";
+export { TamboMessageProvider, useTamboCurrentMessage, useTamboMessageContext, } from "./hooks/use-current-message";
+export * from "./hooks/use-suggestions";
+export { useTamboThreadInput } from "./hooks/use-thread-input";
+export * 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 { useTamboThreads } from "./hooks/use-tambo-threads";
+export { ComponentContextToolMetadata, ComponentRegistry, ParameterSpec, RegisteredComponent, TamboTool, } from "./model/component-metadata";
+export { GenerationStage, TamboThreadMessage, } from "./model/generate-component-response";
+export { TamboThread } from "./model/tambo-thread";

package/dist/index.js

@@ -0,0 +1,34 @@
+"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.GenerationStage = exports.useTamboThreads = exports.useTamboThreadInput = exports.useTamboMessageContext = exports.useTamboCurrentMessage = exports.TamboMessageProvider = exports.useTamboComponentState = void 0;
+/** 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. */
+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");
+Object.defineProperty(exports, "TamboMessageProvider", { enumerable: true, get: function () { return use_current_message_1.TamboMessageProvider; } });
+Object.defineProperty(exports, "useTamboCurrentMessage", { enumerable: true, get: function () { return use_current_message_1.useTamboCurrentMessage; } });
+Object.defineProperty(exports, "useTamboMessageContext", { enumerable: true, get: function () { return use_current_message_1.useTamboMessageContext; } });
+__exportStar(require("./hooks/use-suggestions"), exports);
+var use_thread_input_1 = require("./hooks/use-thread-input");
+Object.defineProperty(exports, "useTamboThreadInput", { enumerable: true, get: function () { return use_thread_input_1.useTamboThreadInput; } });
+// Re-export provider components
+__exportStar(require("./providers"), exports);
+var use_tambo_threads_1 = require("./hooks/use-tambo-threads");
+Object.defineProperty(exports, "useTamboThreads", { enumerable: true, get: function () { return use_tambo_threads_1.useTamboThreads; } });
+var generate_component_response_1 = require("./model/generate-component-response");
+Object.defineProperty(exports, "GenerationStage", { enumerable: true, get: function () { return generate_component_response_1.GenerationStage; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,wKAAwK;AACxK,mEAAqE;AAA5D,6HAAA,sBAAsB,OAAA;AAC/B,mEAIqC;AAHnC,2HAAA,oBAAoB,OAAA;AACpB,6HAAA,sBAAsB,OAAA;AACtB,6HAAA,sBAAsB,OAAA;AAExB,0DAAwC;AACxC,6DAA+D;AAAtD,uHAAA,mBAAmB,OAAA;AAE5B,gCAAgC;AAChC,8CAA4B;AAc5B,+DAA4D;AAAnD,oHAAA,eAAe,OAAA;AAQxB,mFAG6C;AAF3C,8HAAA,eAAe,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. */\nexport { useTamboComponentState } from \"./hooks/use-component-state\";\nexport {\n  TamboMessageProvider,\n  useTamboCurrentMessage,\n  useTamboMessageContext,\n} from \"./hooks/use-current-message\";\nexport * from \"./hooks/use-suggestions\";\nexport { useTamboThreadInput } from \"./hooks/use-thread-input\";\n\n// Re-export provider components\nexport * 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 { useTamboThreads } from \"./hooks/use-tambo-threads\";\nexport {\n  ComponentContextToolMetadata,\n  ComponentRegistry,\n  ParameterSpec,\n  RegisteredComponent,\n  TamboTool,\n} from \"./model/component-metadata\";\nexport {\n  GenerationStage,\n  TamboThreadMessage,\n} from \"./model/generate-component-response\";\nexport { TamboThread } from \"./model/tambo-thread\";\n"]}

package/dist/model/component-metadata.d.ts

@@ -0,0 +1,32 @@
+import TamboAI from "@tambo-ai/typescript-sdk";
+import { ComponentType } from "react";
+import z from "zod";
+import type zodToJsonSchema from "zod-to-json-schema";
+/** Extension of the ToolParameters interface from Tambo AI to include JSONSchema definition */
+export type ParameterSpec = TamboAI.ToolParameters & {
+    schema?: ReturnType<typeof zodToJsonSchema>;
+};
+/**
+ * Extends the base ContextTool interface from Tambo AI to include schema information
+ * for parameter validation using zod-to-json-schema.
+ */
+export interface ComponentContextToolMetadata extends TamboAI.ComponentContextToolMetadata {
+    parameters: ParameterSpec[];
+}
+export interface ComponentContextTool {
+    getComponentContext: (...args: any[]) => Promise<any>;
+    definition: ComponentContextToolMetadata;
+}
+export interface RegisteredComponent extends TamboAI.AvailableComponent {
+    component: ComponentType<any>;
+    loadingComponent?: ComponentType<any>;
+}
+export type ComponentRegistry = Record<string, RegisteredComponent>;
+export type TamboToolRegistry = Record<string, TamboTool>;
+export interface TamboTool<Args extends z.ZodTuple<any, any> = z.ZodTuple<any, any>, Returns extends z.ZodTypeAny = z.ZodTypeAny> {
+    name: string;
+    description: string;
+    tool: (...args: z.infer<Args>) => z.infer<Returns>;
+    toolSchema: z.ZodFunction<Args, Returns>;
+}
+export type TamboToolAssociations = Record<string, string[]>;

package/dist/model/component-metadata.js

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

package/dist/model/component-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-metadata.js","sourceRoot":"","sources":["../../src/model/component-metadata.ts"],"names":[],"mappings":"","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { ComponentType } from \"react\";\nimport z from \"zod\";\nimport type zodToJsonSchema from \"zod-to-json-schema\";\n/** Extension of the ToolParameters interface from Tambo AI to include JSONSchema definition */\nexport type ParameterSpec = TamboAI.ToolParameters & {\n  schema?: ReturnType<typeof zodToJsonSchema>;\n};\n\n/**\n * Extends the base ContextTool interface from Tambo AI to include schema information\n * for parameter validation using zod-to-json-schema.\n */\nexport interface ComponentContextToolMetadata\n  extends TamboAI.ComponentContextToolMetadata {\n  parameters: ParameterSpec[];\n}\n\nexport interface ComponentContextTool {\n  getComponentContext: (...args: any[]) => Promise<any>;\n  definition: ComponentContextToolMetadata;\n}\n\nexport interface RegisteredComponent extends TamboAI.AvailableComponent {\n  component: ComponentType<any>;\n  loadingComponent?: ComponentType<any>;\n}\n\nexport type ComponentRegistry = Record<string, RegisteredComponent>;\n\nexport type TamboToolRegistry = Record<string, TamboTool>;\n\nexport interface TamboTool<\n  Args extends z.ZodTuple<any, any> = z.ZodTuple<any, any>,\n  Returns extends z.ZodTypeAny = z.ZodTypeAny,\n> {\n  name: string;\n  description: string;\n  tool: (...args: z.infer<Args>) => z.infer<Returns>;\n  toolSchema: z.ZodFunction<Args, Returns>;\n}\n\nexport type TamboToolAssociations = Record<string, string[]>;\n"]}

package/dist/model/generate-component-response.d.ts

@@ -0,0 +1,17 @@
+import TamboAI from "@tambo-ai/typescript-sdk";
+import { ReactElement } from "react";
+/** An extension of the TamboAI.Beta.Threads.ThreadMessage type that includes a
+ * renderedComponent */
+export interface TamboThreadMessage extends TamboAI.Beta.Threads.ThreadMessage {
+    renderedComponent?: ReactElement | null;
+}
+export declare enum GenerationStage {
+    IDLE = "IDLE",
+    CHOOSING_COMPONENT = "CHOOSING_COMPONENT",
+    FETCHING_CONTEXT = "FETCHING_CONTEXT",
+    HYDRATING_COMPONENT = "HYDRATING_COMPONENT",
+    STREAMING_RESPONSE = "STREAMING_RESPONSE",
+    COMPLETE = "COMPLETE",
+    ERROR = "ERROR"
+}
+export declare function isIdleStage(generationStage: GenerationStage): boolean;

package/dist/model/generate-component-response.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerationStage = void 0;
+exports.isIdleStage = isIdleStage;
+var GenerationStage;
+(function (GenerationStage) {
+    GenerationStage["IDLE"] = "IDLE";
+    GenerationStage["CHOOSING_COMPONENT"] = "CHOOSING_COMPONENT";
+    GenerationStage["FETCHING_CONTEXT"] = "FETCHING_CONTEXT";
+    GenerationStage["HYDRATING_COMPONENT"] = "HYDRATING_COMPONENT";
+    GenerationStage["STREAMING_RESPONSE"] = "STREAMING_RESPONSE";
+    GenerationStage["COMPLETE"] = "COMPLETE";
+    GenerationStage["ERROR"] = "ERROR";
+})(GenerationStage || (exports.GenerationStage = GenerationStage = {}));
+function isIdleStage(generationStage) {
+    return [
+        GenerationStage.IDLE,
+        GenerationStage.COMPLETE,
+        GenerationStage.ERROR,
+    ].includes(generationStage);
+}
+//# sourceMappingURL=generate-component-response.js.map

package/dist/model/generate-component-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-component-response.js","sourceRoot":"","sources":["../../src/model/generate-component-response.ts"],"names":[],"mappings":";;;AAkBA,kCAMC;AAfD,IAAY,eAQX;AARD,WAAY,eAAe;IACzB,gCAAa,CAAA;IACb,4DAAyC,CAAA;IACzC,wDAAqC,CAAA;IACrC,8DAA2C,CAAA;IAC3C,4DAAyC,CAAA;IACzC,wCAAqB,CAAA;IACrB,kCAAe,CAAA;AACjB,CAAC,EARW,eAAe,+BAAf,eAAe,QAQ1B;AACD,SAAgB,WAAW,CAAC,eAAgC;IAC1D,OAAO;QACL,eAAe,CAAC,IAAI;QACpB,eAAe,CAAC,QAAQ;QACxB,eAAe,CAAC,KAAK;KACtB,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { ReactElement } from \"react\";\n\n/** An extension of the TamboAI.Beta.Threads.ThreadMessage type that includes a\n * renderedComponent */\nexport interface TamboThreadMessage extends TamboAI.Beta.Threads.ThreadMessage {\n  renderedComponent?: ReactElement | null;\n}\n\nexport enum GenerationStage {\n  IDLE = \"IDLE\",\n  CHOOSING_COMPONENT = \"CHOOSING_COMPONENT\",\n  FETCHING_CONTEXT = \"FETCHING_CONTEXT\",\n  HYDRATING_COMPONENT = \"HYDRATING_COMPONENT\",\n  STREAMING_RESPONSE = \"STREAMING_RESPONSE\",\n  COMPLETE = \"COMPLETE\",\n  ERROR = \"ERROR\",\n}\nexport function isIdleStage(generationStage: GenerationStage) {\n  return [\n    GenerationStage.IDLE,\n    GenerationStage.COMPLETE,\n    GenerationStage.ERROR,\n  ].includes(generationStage);\n}\n"]}

package/dist/model/tambo-thread.d.ts

@@ -0,0 +1,7 @@
+import TamboAI from "@tambo-ai/typescript-sdk";
+import { TamboThreadMessage } from "./generate-component-response";
+/** An extension of the TamboAI.Beta.Thread type that includes
+ * messages with renderedComponent */
+export interface TamboThread extends TamboAI.Beta.Thread {
+    messages: TamboThreadMessage[];
+}

package/dist/model/tambo-thread.js

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

package/dist/model/tambo-thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-thread.js","sourceRoot":"","sources":["../../src/model/tambo-thread.ts"],"names":[],"mappings":"","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { TamboThreadMessage } from \"./generate-component-response\";\n\n/** An extension of the TamboAI.Beta.Thread type that includes\n * messages with renderedComponent */\nexport interface TamboThread extends TamboAI.Beta.Thread {\n  messages: TamboThreadMessage[];\n}\n"]}

package/dist/model/thread-input-error.d.ts

@@ -0,0 +1,3 @@
+import { TamboAIError } from "@tambo-ai/typescript-sdk";
+export declare class ThreadInputError extends TamboAIError {
+}

package/dist/model/thread-input-error.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThreadInputError = void 0;
+const typescript_sdk_1 = require("@tambo-ai/typescript-sdk");
+class ThreadInputError extends typescript_sdk_1.TamboAIError {
+}
+exports.ThreadInputError = ThreadInputError;
+//# sourceMappingURL=thread-input-error.js.map

package/dist/model/thread-input-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-input-error.js","sourceRoot":"","sources":["../../src/model/thread-input-error.ts"],"names":[],"mappings":";;;AAAA,6DAAwD;AAExD,MAAa,gBAAiB,SAAQ,6BAAY;CAAG;AAArD,4CAAqD","sourcesContent":["import { TamboAIError } from \"@tambo-ai/typescript-sdk\";\n\nexport class ThreadInputError extends TamboAIError {}\n"]}

package/dist/model/validate-input.d.ts

@@ -0,0 +1,6 @@
+export interface ValidationResult {
+    isValid: boolean;
+    error?: Error;
+    sanitizedInput: string;
+}
+export declare function validateInput(input: string): ValidationResult;

package/dist/model/validate-input.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateInput = validateInput;
+// TODO(future): Consider adding more validation rules if needed
+function validateInput(input) {
+    const trimmed = input.trim();
+    if (trimmed.length === 0) {
+        return {
+            isValid: false,
+            error: new Error("Message cannot be empty"),
+            sanitizedInput: trimmed,
+        };
+    }
+    // TODO(perf): Make this configurable if needed
+    if (trimmed.length > 10000) {
+        return {
+            isValid: false,
+            error: new Error("Message is too long (max 10000 characters)"),
+            sanitizedInput: trimmed,
+        };
+    }
+    return {
+        isValid: true,
+        sanitizedInput: trimmed,
+    };
+}
+//# sourceMappingURL=validate-input.js.map

package/dist/model/validate-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-input.js","sourceRoot":"","sources":["../../src/model/validate-input.ts"],"names":[],"mappings":";;AAOA,sCAwBC;AAzBD,gEAAgE;AAChE,SAAgB,aAAa,CAAC,KAAa;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,IAAI,KAAK,CAAC,yBAAyB,CAAC;YAC3C,cAAc,EAAE,OAAO;SACxB,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,IAAI,KAAK,CAAC,4CAA4C,CAAC;YAC9D,cAAc,EAAE,OAAO;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,OAAO;KACxB,CAAC;AACJ,CAAC","sourcesContent":["export interface ValidationResult {\n  isValid: boolean;\n  error?: Error;\n  sanitizedInput: string;\n}\n\n// TODO(future): Consider adding more validation rules if needed\nexport function validateInput(input: string): ValidationResult {\n  const trimmed = input.trim();\n\n  if (trimmed.length === 0) {\n    return {\n      isValid: false,\n      error: new Error(\"Message cannot be empty\"),\n      sanitizedInput: trimmed,\n    };\n  }\n\n  // TODO(perf): Make this configurable if needed\n  if (trimmed.length > 10000) {\n    return {\n      isValid: false,\n      error: new Error(\"Message is too long (max 10000 characters)\"),\n      sanitizedInput: trimmed,\n    };\n  }\n\n  return {\n    isValid: true,\n    sanitizedInput: trimmed,\n  };\n}\n"]}

package/dist/providers/index.d.ts

@@ -0,0 +1,5 @@
+export { TamboClientProvider, useTamboClient } from "./tambo-client-provider";
+export { TamboComponentProvider, useTamboComponent, } from "./tambo-component-provider";
+export { TamboContext, TamboProvider, useTambo } from "./tambo-provider";
+export { RegisterComponentOptions, TamboRegistryContext, TamboRegistryProvider, useTamboRegistry, } from "./tambo-registry-provider";
+export { TamboThreadContext, TamboThreadProvider, useTamboThread, } from "./tambo-thread-provider";

package/dist/providers/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTamboThread = exports.TamboThreadProvider = exports.TamboThreadContext = exports.useTamboRegistry = exports.TamboRegistryProvider = exports.useTambo = exports.TamboProvider = exports.TamboContext = exports.useTamboComponent = exports.TamboComponentProvider = exports.useTamboClient = exports.TamboClientProvider = void 0;
+var tambo_client_provider_1 = require("./tambo-client-provider");
+Object.defineProperty(exports, "TamboClientProvider", { enumerable: true, get: function () { return tambo_client_provider_1.TamboClientProvider; } });
+Object.defineProperty(exports, "useTamboClient", { enumerable: true, get: function () { return tambo_client_provider_1.useTamboClient; } });
+var tambo_component_provider_1 = require("./tambo-component-provider");
+Object.defineProperty(exports, "TamboComponentProvider", { enumerable: true, get: function () { return tambo_component_provider_1.TamboComponentProvider; } });
+Object.defineProperty(exports, "useTamboComponent", { enumerable: true, get: function () { return tambo_component_provider_1.useTamboComponent; } });
+var tambo_provider_1 = require("./tambo-provider");
+Object.defineProperty(exports, "TamboContext", { enumerable: true, get: function () { return tambo_provider_1.TamboContext; } });
+Object.defineProperty(exports, "TamboProvider", { enumerable: true, get: function () { return tambo_provider_1.TamboProvider; } });
+Object.defineProperty(exports, "useTambo", { enumerable: true, get: function () { return tambo_provider_1.useTambo; } });
+var tambo_registry_provider_1 = require("./tambo-registry-provider");
+Object.defineProperty(exports, "TamboRegistryProvider", { enumerable: true, get: function () { return tambo_registry_provider_1.TamboRegistryProvider; } });
+Object.defineProperty(exports, "useTamboRegistry", { enumerable: true, get: function () { return tambo_registry_provider_1.useTamboRegistry; } });
+var tambo_thread_provider_1 = require("./tambo-thread-provider");
+Object.defineProperty(exports, "TamboThreadContext", { enumerable: true, get: function () { return tambo_thread_provider_1.TamboThreadContext; } });
+Object.defineProperty(exports, "TamboThreadProvider", { enumerable: true, get: function () { return tambo_thread_provider_1.TamboThreadProvider; } });
+Object.defineProperty(exports, "useTamboThread", { enumerable: true, get: function () { return tambo_thread_provider_1.useTamboThread; } });
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":";;;AAAA,iEAA8E;AAArE,4HAAA,mBAAmB,OAAA;AAAE,uHAAA,cAAc,OAAA;AAC5C,uEAGoC;AAFlC,kIAAA,sBAAsB,OAAA;AACtB,6HAAA,iBAAiB,OAAA;AAEnB,mDAAyE;AAAhE,8GAAA,YAAY,OAAA;AAAE,+GAAA,aAAa,OAAA;AAAE,0GAAA,QAAQ,OAAA;AAC9C,qEAKmC;AAFjC,gIAAA,qBAAqB,OAAA;AACrB,2HAAA,gBAAgB,OAAA;AAElB,iEAIiC;AAH/B,2HAAA,kBAAkB,OAAA;AAClB,4HAAA,mBAAmB,OAAA;AACnB,uHAAA,cAAc,OAAA","sourcesContent":["export { TamboClientProvider, useTamboClient } from \"./tambo-client-provider\";\nexport {\n  TamboComponentProvider,\n  useTamboComponent,\n} from \"./tambo-component-provider\";\nexport { TamboContext, TamboProvider, useTambo } from \"./tambo-provider\";\nexport {\n  RegisterComponentOptions,\n  TamboRegistryContext,\n  TamboRegistryProvider,\n  useTamboRegistry,\n} from \"./tambo-registry-provider\";\nexport {\n  TamboThreadContext,\n  TamboThreadProvider,\n  useTamboThread,\n} from \"./tambo-thread-provider\";\n"]}

package/dist/providers/tambo-client-provider.d.ts

@@ -0,0 +1,15 @@
+import TamboAI from "@tambo-ai/typescript-sdk";
+import { QueryClient } from "@tanstack/react-query";
+import React, { PropsWithChildren } from "react";
+export interface TamboClientProviderProps {
+    tamboUrl: string;
+    apiKey: string;
+}
+export interface TamboClientContextProps {
+    client: TamboAI;
+    /** The tambo-specific query client */
+    queryClient: QueryClient;
+}
+export declare const TamboClientProvider: React.FC<PropsWithChildren<TamboClientProviderProps>>;
+export declare const useTamboClient: () => TamboAI;
+export declare const useTamboQueryClient: () => QueryClient;

package/dist/providers/tambo-client-provider.js

@@ -0,0 +1,66 @@
+"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 });
+exports.useTamboQueryClient = exports.useTamboClient = exports.TamboClientProvider = void 0;
+const typescript_sdk_1 = __importDefault(require("@tambo-ai/typescript-sdk"));
+const react_query_1 = require("@tanstack/react-query");
+const react_1 = __importStar(require("react"));
+const TamboClientContext = (0, react_1.createContext)(undefined);
+const TamboClientProvider = ({ children, tamboUrl, apiKey }) => {
+    const [client] = (0, react_1.useState)(() => new typescript_sdk_1.default({ baseURL: tamboUrl, apiKey }));
+    const [queryClient] = (0, react_1.useState)(() => new react_query_1.QueryClient());
+    return (react_1.default.createElement(TamboClientContext.Provider, { value: { client, queryClient } }, children));
+};
+exports.TamboClientProvider = TamboClientProvider;
+const useTamboClient = () => {
+    const context = react_1.default.useContext(TamboClientContext);
+    if (context === undefined) {
+        throw new Error("useTamboClient must be used within a TamboClientProvider");
+    }
+    return context.client;
+};
+exports.useTamboClient = useTamboClient;
+const useTamboQueryClient = () => {
+    const context = react_1.default.useContext(TamboClientContext);
+    if (context === undefined) {
+        throw new Error("useTamboQueryClient must be used within a TamboClientProvider");
+    }
+    return context.queryClient;
+};
+exports.useTamboQueryClient = useTamboQueryClient;
+//# sourceMappingURL=tambo-client-provider.js.map