@tambo-ai/react 0.12.0

package/esm/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/esm/hooks/use-tambo-threads.js

@@ -0,0 +1,30 @@
+import { useTamboClient } from "../providers/tambo-client-provider";
+import { useTamboQuery } from "./react-query-hooks";
+/**
+ * Get the threads for the specified project and optional context key.
+ */
+export function useTamboThreads({ projectId, contextKey, } = {}) {
+    const client = useTamboClient();
+    const { data: queriedProjectId, ...projectIdState } = useTamboQuery({
+        queryKey: ["projectId"],
+        queryFn: async () => {
+            return (await client.beta.projects.getCurrent()).id;
+        },
+    });
+    const currentProjectId = projectId ?? queriedProjectId;
+    const threadState = 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/esm/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":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,SAAS,EACT,UAAU,MAIR,EAAE;IACJ,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,cAAc,EAAE,GAAG,aAAa,CAAC;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,aAAa,CAAC;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/esm/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/esm/hooks/use-thread-input.js

@@ -0,0 +1,49 @@
+import { useCallback } from "react";
+import { ThreadInputError } from "../model/thread-input-error";
+import { validateInput } from "../model/validate-input";
+import { useTamboThread } from "../providers/tambo-thread-provider";
+import { useTamboMutation } from "./react-query-hooks";
+/**
+ * Error messages for various input-related error scenarios
+ * These messages are used to provide user-friendly error feedback
+ * @readonly
+ */
+export const 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
+ */
+export function useTamboThreadInput(contextKey) {
+    const { thread, inputValue, setInputValue, sendThreadMessage } = useTamboThread();
+    const submit = useCallback(async ({ contextKey: submitContextKey } = {}) => {
+        const validation = validateInput(inputValue);
+        if (!validation.isValid) {
+            throw new ThreadInputError(`Cannot submit message: ${validation.error ?? 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 } = useTamboMutation({
+        mutationFn: submit,
+    });
+    return {
+        ...mutationState,
+        value: inputValue,
+        setValue: setInputValue,
+        submit: submitAsync,
+    };
+}
+//# sourceMappingURL=use-thread-input.js.map

package/esm/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":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,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,MAAM,UAAU,mBAAmB,CAAC,UAAmB;IACrD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,GAC5D,cAAc,EAAE,CAAC;IAEnB,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,EAAE,UAAU,EAAE,gBAAgB,KAA8B,EAAE,EAAE,EAAE;QACvE,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,gBAAgB,CACxB,0BAA0B,UAAU,CAAC,KAAK,IAAI,oBAAoB,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,gBAAgB,CAAC;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/esm/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/esm/index.js

@@ -0,0 +1,10 @@
+/** 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";
+// Re-export provider components
+export * from "./providers";
+export { useTamboThreads } from "./hooks/use-tambo-threads";
+export { GenerationStage, } from "./model/generate-component-response";
+//# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wKAAwK;AACxK,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,gCAAgC;AAChC,cAAc,aAAa,CAAC;AAc5B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAQ5D,OAAO,EACL,eAAe,GAEhB,MAAM,qCAAqC,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. */\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/esm/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/esm/model/component-metadata.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=component-metadata.js.map

package/esm/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/esm/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/esm/model/generate-component-response.js

@@ -0,0 +1,18 @@
+export 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 || (GenerationStage = {}));
+export function isIdleStage(generationStage) {
+    return [
+        GenerationStage.IDLE,
+        GenerationStage.COMPLETE,
+        GenerationStage.ERROR,
+    ].includes(generationStage);
+}
+//# sourceMappingURL=generate-component-response.js.map

package/esm/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":"AASA,MAAM,CAAN,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,KAAf,eAAe,QAQ1B;AACD,MAAM,UAAU,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/esm/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/esm/model/tambo-thread.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tambo-thread.js.map

package/esm/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/esm/model/thread-input-error.d.ts

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

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

@@ -0,0 +1,4 @@
+import { TamboAIError } from "@tambo-ai/typescript-sdk";
+export class ThreadInputError extends TamboAIError {
+}
+//# sourceMappingURL=thread-input-error.js.map

package/esm/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,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,OAAO,gBAAiB,SAAQ,YAAY;CAAG","sourcesContent":["import { TamboAIError } from \"@tambo-ai/typescript-sdk\";\n\nexport class ThreadInputError extends TamboAIError {}\n"]}

package/esm/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/esm/model/validate-input.js

@@ -0,0 +1,24 @@
+// TODO(future): Consider adding more validation rules if needed
+export 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/esm/model/validate-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-input.js","sourceRoot":"","sources":["../../src/model/validate-input.ts"],"names":[],"mappings":"AAMA,gEAAgE;AAChE,MAAM,UAAU,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/esm/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/esm/providers/index.js

@@ -0,0 +1,6 @@
+export { TamboClientProvider, useTamboClient } from "./tambo-client-provider";
+export { TamboComponentProvider, useTamboComponent, } from "./tambo-component-provider";
+export { TamboContext, TamboProvider, useTambo } from "./tambo-provider";
+export { TamboRegistryProvider, useTamboRegistry, } from "./tambo-registry-provider";
+export { TamboThreadContext, TamboThreadProvider, useTamboThread, } from "./tambo-thread-provider";
+//# sourceMappingURL=index.js.map

package/esm/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAGL,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,yBAAyB,CAAC","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/esm/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/esm/providers/tambo-client-provider.js

@@ -0,0 +1,24 @@
+import TamboAI from "@tambo-ai/typescript-sdk";
+import { QueryClient } from "@tanstack/react-query";
+import React, { createContext, useState } from "react";
+const TamboClientContext = createContext(undefined);
+export const TamboClientProvider = ({ children, tamboUrl, apiKey }) => {
+    const [client] = useState(() => new TamboAI({ baseURL: tamboUrl, apiKey }));
+    const [queryClient] = useState(() => new QueryClient());
+    return (React.createElement(TamboClientContext.Provider, { value: { client, queryClient } }, children));
+};
+export const useTamboClient = () => {
+    const context = React.useContext(TamboClientContext);
+    if (context === undefined) {
+        throw new Error("useTamboClient must be used within a TamboClientProvider");
+    }
+    return context.client;
+};
+export const useTamboQueryClient = () => {
+    const context = React.useContext(TamboClientContext);
+    if (context === undefined) {
+        throw new Error("useTamboQueryClient must be used within a TamboClientProvider");
+    }
+    return context.queryClient;
+};
+//# sourceMappingURL=tambo-client-provider.js.map

package/esm/providers/tambo-client-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-client-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-client-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,EAAE,aAAa,EAAqB,QAAQ,EAAE,MAAM,OAAO,CAAC;AAY1E,MAAM,kBAAkB,GAAG,aAAa,CACtC,SAAS,CACV,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAE5B,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;IACrC,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5E,MAAM,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;IACxD,OAAO,CACL,oBAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,IACxD,QAAQ,CACmB,CAC/B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,EAAE;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,WAAW,CAAC;AAC7B,CAAC,CAAC","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { QueryClient } from \"@tanstack/react-query\";\nimport React, { createContext, PropsWithChildren, useState } from \"react\";\n\nexport interface TamboClientProviderProps {\n  tamboUrl: string;\n  apiKey: string;\n}\nexport interface TamboClientContextProps {\n  client: TamboAI;\n  /** The tambo-specific query client */\n  queryClient: QueryClient;\n}\n\nconst TamboClientContext = createContext<TamboClientContextProps | undefined>(\n  undefined,\n);\n\nexport const TamboClientProvider: React.FC<\n  PropsWithChildren<TamboClientProviderProps>\n> = ({ children, tamboUrl, apiKey }) => {\n  const [client] = useState(() => new TamboAI({ baseURL: tamboUrl, apiKey }));\n  const [queryClient] = useState(() => new QueryClient());\n  return (\n    <TamboClientContext.Provider value={{ client, queryClient }}>\n      {children}\n    </TamboClientContext.Provider>\n  );\n};\n\nexport const useTamboClient = () => {\n  const context = React.useContext(TamboClientContext);\n  if (context === undefined) {\n    throw new Error(\"useTamboClient must be used within a TamboClientProvider\");\n  }\n  return context.client;\n};\n\nexport const useTamboQueryClient = () => {\n  const context = React.useContext(TamboClientContext);\n  if (context === undefined) {\n    throw new Error(\n      \"useTamboQueryClient must be used within a TamboClientProvider\",\n    );\n  }\n  return context.queryClient;\n};\n"]}

package/esm/providers/tambo-component-provider.d.ts

@@ -0,0 +1,18 @@
+import TamboAI from "@tambo-ai/typescript-sdk";
+import React, { PropsWithChildren } from "react";
+import { TamboTool } from "../model/component-metadata";
+import { GenerationStage, TamboThreadMessage } from "../model/generate-component-response";
+import { RegisterComponentOptions } from "./tambo-registry-provider";
+export interface TamboComponentContextProps {
+    registerComponent: (options: RegisterComponentOptions) => void;
+    generateComponent: (params: TamboAI.Beta.Components.ComponentGenerateParams & {
+        stream?: boolean;
+    }, options?: TamboAI.RequestOptions) => Promise<TamboThreadMessage>;
+    generationStage: GenerationStage;
+    isIdle: boolean;
+    registerTool: (tool: TamboTool) => void;
+    registerTools: (tools: TamboTool[]) => void;
+    addToolAssociation: (componentName: string, tool: TamboTool) => void;
+}
+export declare const TamboComponentProvider: React.FC<PropsWithChildren>;
+export declare const useTamboComponent: () => TamboComponentContextProps;