@tambo-ai/client 0.0.1

package/dist/types/event.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Tambo-specific Custom Event Types for Streaming API
+ *
+ * Defines custom events specific to Tambo functionality.
+ * For standard AG-UI events, import directly from `@ag-ui/core`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTamboCustomEvent = isTamboCustomEvent;
+exports.asTamboCustomEvent = asTamboCustomEvent;
+/**
+ * Known Tambo custom event names for type narrowing
+ */
+const TAMBO_CUSTOM_EVENT_NAMES = [
+    "tambo.component.start",
+    "tambo.component.props_delta",
+    "tambo.component.state_delta",
+    "tambo.component.end",
+    "tambo.run.awaiting_input",
+    "tambo.message.parent",
+];
+/**
+ * Type guard to check if an event is a Tambo custom event.
+ * Validates that the event has a name matching known Tambo custom event types.
+ * @param event - Event object to check
+ * @param event.name - Event name to match against known Tambo event types
+ * @returns True if event is a TamboCustomEvent
+ */
+function isTamboCustomEvent(event) {
+    return (typeof event.name === "string" &&
+        TAMBO_CUSTOM_EVENT_NAMES.includes(event.name));
+}
+/**
+ * Casts a CustomEvent to the specific TamboCustomEvent type based on its name.
+ * Uses exhaustive type checking to ensure all event types are handled.
+ * @param event - The CustomEvent to cast
+ * @returns The properly typed TamboCustomEvent, or undefined if not a known Tambo event
+ */
+function asTamboCustomEvent(event) {
+    switch (event.name) {
+        case "tambo.component.start":
+            return event;
+        case "tambo.component.props_delta":
+            return event;
+        case "tambo.component.state_delta":
+            return event;
+        case "tambo.component.end":
+            return event;
+        case "tambo.run.awaiting_input":
+            return event;
+        case "tambo.message.parent":
+            return event;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=event.js.map

package/dist/types/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/types/event.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA0HH,gDAOC;AAQD,gDAmBC;AArDD;;GAEG;AACH,MAAM,wBAAwB,GAAG;IAC/B,uBAAuB;IACvB,6BAA6B;IAC7B,6BAA6B;IAC7B,qBAAqB;IACrB,0BAA0B;IAC1B,sBAAsB;CACd,CAAC;AAEX;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,KAElC;IACC,OAAO,CACL,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC7B,wBAA8C,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CACrE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAChC,KAAkB;IAElB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,uBAAuB;YAC1B,OAAO,KAA4B,CAAC;QACtC,KAAK,6BAA6B;YAChC,OAAO,KAAiC,CAAC;QAC3C,KAAK,6BAA6B;YAChC,OAAO,KAAiC,CAAC;QAC3C,KAAK,qBAAqB;YACxB,OAAO,KAA0B,CAAC;QACpC,KAAK,0BAA0B;YAC7B,OAAO,KAA8B,CAAC;QACxC,KAAK,sBAAsB;YACzB,OAAO,KAA2B,CAAC;QACrC;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC","sourcesContent":["/**\n * Tambo-specific Custom Event Types for Streaming API\n *\n * Defines custom events specific to Tambo functionality.\n * For standard AG-UI events, import directly from `@ag-ui/core`.\n */\n\nimport type { CustomEvent } from \"@ag-ui/core\";\nimport type { Operation } from \"fast-json-patch\";\n\ntype TamboCustomEventEnvelope<TName extends string, TValue> = Omit<\n  CustomEvent,\n  \"name\" | \"value\"\n> & {\n  name: TName;\n  value: TValue;\n};\n\n/**\n * Component start event (custom: tambo.component.start)\n */\nexport type ComponentStartEvent = TamboCustomEventEnvelope<\n  \"tambo.component.start\",\n  {\n    messageId: string;\n    componentId: string;\n    componentName: string;\n  }\n>;\n\n/**\n * Component props delta event (custom: tambo.component.props_delta)\n * Uses JSON Patch (RFC 6902) to update component props\n */\nexport type ComponentPropsDeltaEvent = TamboCustomEventEnvelope<\n  \"tambo.component.props_delta\",\n  {\n    componentId: string;\n    operations: Operation[];\n  }\n>;\n\n/**\n * Component state delta event (custom: tambo.component.state_delta)\n * Uses JSON Patch (RFC 6902) to update component state\n */\nexport type ComponentStateDeltaEvent = TamboCustomEventEnvelope<\n  \"tambo.component.state_delta\",\n  {\n    componentId: string;\n    operations: Operation[];\n  }\n>;\n\n/**\n * Component end event (custom: tambo.component.end)\n */\nexport type ComponentEndEvent = TamboCustomEventEnvelope<\n  \"tambo.component.end\",\n  {\n    componentId: string;\n  }\n>;\n\n/**\n * Pending tool call information from awaiting_input event\n */\nexport interface PendingToolCall {\n  toolCallId: string;\n  toolName: string;\n  arguments: string;\n}\n\n/**\n * Run awaiting input event (custom: tambo.run.awaiting_input)\n * Signals that the run is paused waiting for client-side tool execution\n */\nexport type RunAwaitingInputEvent = TamboCustomEventEnvelope<\n  \"tambo.run.awaiting_input\",\n  {\n    pendingToolCalls: PendingToolCall[];\n  }\n>;\n\n/**\n * Message parent event (custom: tambo.message.parent)\n * Emitted when a message was created during the generation of another message\n * (e.g., MCP sampling or elicitation).\n */\nexport type MessageParentEvent = TamboCustomEventEnvelope<\n  \"tambo.message.parent\",\n  {\n    messageId: string;\n    parentMessageId: string;\n  }\n>;\n\n/**\n * Union type of Tambo-specific custom events\n */\nexport type TamboCustomEvent =\n  | ComponentStartEvent\n  | ComponentPropsDeltaEvent\n  | ComponentStateDeltaEvent\n  | ComponentEndEvent\n  | RunAwaitingInputEvent\n  | MessageParentEvent;\n\n/**\n * Known Tambo custom event names for type narrowing\n */\nconst TAMBO_CUSTOM_EVENT_NAMES = [\n  \"tambo.component.start\",\n  \"tambo.component.props_delta\",\n  \"tambo.component.state_delta\",\n  \"tambo.component.end\",\n  \"tambo.run.awaiting_input\",\n  \"tambo.message.parent\",\n] as const;\n\n/**\n * Type guard to check if an event is a Tambo custom event.\n * Validates that the event has a name matching known Tambo custom event types.\n * @param event - Event object to check\n * @param event.name - Event name to match against known Tambo event types\n * @returns True if event is a TamboCustomEvent\n */\nexport function isTamboCustomEvent(event: {\n  name?: string;\n}): event is TamboCustomEvent {\n  return (\n    typeof event.name === \"string\" &&\n    (TAMBO_CUSTOM_EVENT_NAMES as readonly string[]).includes(event.name)\n  );\n}\n\n/**\n * Casts a CustomEvent to the specific TamboCustomEvent type based on its name.\n * Uses exhaustive type checking to ensure all event types are handled.\n * @param event - The CustomEvent to cast\n * @returns The properly typed TamboCustomEvent, or undefined if not a known Tambo event\n */\nexport function asTamboCustomEvent(\n  event: CustomEvent,\n): TamboCustomEvent | undefined {\n  switch (event.name) {\n    case \"tambo.component.start\":\n      return event as ComponentStartEvent;\n    case \"tambo.component.props_delta\":\n      return event as ComponentPropsDeltaEvent;\n    case \"tambo.component.state_delta\":\n      return event as ComponentStateDeltaEvent;\n    case \"tambo.component.end\":\n      return event as ComponentEndEvent;\n    case \"tambo.run.awaiting_input\":\n      return event as RunAwaitingInputEvent;\n    case \"tambo.message.parent\":\n      return event as MessageParentEvent;\n    default:\n      return undefined;\n  }\n}\n"]}

package/dist/types/message.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Message and Content Types
+ *
+ * Re-exports message and content types from `@tambo-ai/typescript-sdk`.
+ * Messages use Anthropic-style content blocks pattern where a message
+ * contains an array of content blocks (text, tool calls, tool results, components).
+ */
+export type { TextContent, ToolResultContent, ResourceContent, } from "@tambo-ai/typescript-sdk/resources/threads/threads";
+export type { InputMessage } from "@tambo-ai/typescript-sdk/resources/threads/runs";
+import type { RunCreateParams } from "@tambo-ai/typescript-sdk/resources/threads/runs";
+/**
+ * Message type for initial messages that seed a new thread.
+ * Supports system and assistant roles in addition to user,
+ * and restricts content to text and resource blocks (no tool results).
+ */
+export type InitialInputMessage = RunCreateParams.Thread.InitialMessage;
+export type { MessageListResponse, MessageGetResponse, } from "@tambo-ai/typescript-sdk/resources/threads/messages";
+import type { TextContent, ToolUseContent, ToolResultContent, ComponentContent, ResourceContent } from "@tambo-ai/typescript-sdk/resources/threads/threads";
+/**
+ * Streaming state for component content blocks.
+ * Tracks the lifecycle of component prop/state streaming.
+ */
+export type ComponentStreamingState = "started" | "streaming" | "done";
+/**
+ * Extended ComponentContent with streaming state.
+ * Used by the SDK to track component rendering lifecycle.
+ */
+export interface TamboComponentContent extends ComponentContent {
+    /**
+     * Current streaming state of this component's props.
+     * - 'started': Component block created, awaiting props
+     * - 'streaming': Props are being streamed
+     * - 'done': Props streaming complete
+     *
+     * Optional for historical messages loaded from API (defaults to "done").
+     */
+    streamingState?: ComponentStreamingState;
+}
+/**
+ * Special display properties that can be included in tool input.
+ * These are used to customize tool status messages shown in the UI.
+ */
+export interface TamboToolDisplayProps {
+    /** Message shown while the tool is executing */
+    _tambo_statusMessage?: string;
+    /** Message shown after the tool completes */
+    _tambo_completionStatusMessage?: string;
+}
+/**
+ * Extended ToolUseContent with computed state properties.
+ * Used by the SDK to provide pre-computed tool state to consumers.
+ *
+ * Note: The computed properties are populated by `useTambo()` hook.
+ * When accessed via lower-level APIs, they may be undefined.
+ */
+export interface TamboToolUseContent extends Omit<ToolUseContent, "input"> {
+    /**
+     * Tool input parameters with internal `_tambo_*` properties removed.
+     * Consumers see only the actual tool parameters.
+     */
+    input: Record<string, unknown>;
+    /**
+     * Whether this tool call has completed (has a matching tool_result).
+     * Computed by `useTambo()` based on presence of matching tool_result.
+     */
+    hasCompleted?: boolean;
+    /**
+     * The status message to display, resolved based on tool execution state.
+     * Automatically updates as tool progresses through execution lifecycle.
+     * Computed by `useTambo()`.
+     */
+    statusMessage?: string;
+    /**
+     * Extracted Tambo display properties from the tool input.
+     * Consumers can use these for custom rendering if needed.
+     * Computed by `useTambo()`.
+     */
+    tamboDisplayProps?: TamboToolDisplayProps;
+}
+/**
+ * Message role (from SDK)
+ * Includes 'system' to accommodate messages loaded from API.
+ */
+export type MessageRole = "user" | "assistant" | "system";
+/**
+ * Union type of all content block types.
+ * Uses TamboComponentContent and TamboToolUseContent which include computed state.
+ */
+export type Content = TextContent | TamboToolUseContent | ToolResultContent | TamboComponentContent | ResourceContent;
+/**
+ * Message in a thread (simplified from SDK's MessageGetResponse)
+ */
+export interface TamboThreadMessage {
+    /** Unique message identifier */
+    id: string;
+    /** Message role (user or assistant) */
+    role: MessageRole;
+    /** Content blocks in the message */
+    content: Content[];
+    /** When the message was created (optional for historical messages loaded from API) */
+    createdAt?: string;
+    /** Message metadata */
+    metadata?: Record<string, unknown>;
+    /**
+     * The id of the parent message, if this message was created during
+     * generation of another message (e.g., MCP sampling or elicitation).
+     */
+    parentMessageId?: string;
+    /**
+     * Reasoning content from the model (transient - only during streaming).
+     * Each element is a reasoning "chunk" - models may emit multiple reasoning blocks.
+     * This data is not persisted to the database and will not be present in
+     * messages loaded from the API.
+     */
+    reasoning?: string[];
+    /**
+     * Duration of the reasoning phase in milliseconds (for display purposes).
+     * Populated when reasoning completes.
+     */
+    reasoningDurationMS?: number;
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/types/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,GAChB,MAAM,oDAAoD,CAAC;AAG5D,YAAY,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAEvF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC,MAAM,CAAC,cAAc,CAAC;AAExE,YAAY,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qDAAqD,CAAC;AAG7D,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,oDAAoD,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,uBAAuB,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,6CAA6C;IAC7C,8BAA8B,CAAC,EAAE,MAAM,CAAC;CACzC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC;IACxE;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,OAAO,GACf,WAAW,GACX,mBAAmB,GACnB,iBAAiB,GACjB,qBAAqB,GACrB,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IAEX,uCAAuC;IACvC,IAAI,EAAE,WAAW,CAAC;IAElB,oCAAoC;IACpC,OAAO,EAAE,OAAO,EAAE,CAAC;IAEnB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/types/message.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Message and Content Types
+ *
+ * Re-exports message and content types from `@tambo-ai/typescript-sdk`.
+ * Messages use Anthropic-style content blocks pattern where a message
+ * contains an array of content blocks (text, tool calls, tool results, components).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=message.js.map

package/dist/types/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG","sourcesContent":["/**\n * Message and Content Types\n *\n * Re-exports message and content types from `@tambo-ai/typescript-sdk`.\n * Messages use Anthropic-style content blocks pattern where a message\n * contains an array of content blocks (text, tool calls, tool results, components).\n */\n\n// Re-export content block types from TypeScript SDK\n// Note: ToolUseContent and ComponentContent are NOT re-exported - use TamboToolUseContent\n// and TamboComponentContent instead, which include computed state properties.\nexport type {\n  TextContent,\n  ToolResultContent,\n  ResourceContent,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\n// Re-export message types from TypeScript SDK\nexport type { InputMessage } from \"@tambo-ai/typescript-sdk/resources/threads/runs\";\nimport type { RunCreateParams } from \"@tambo-ai/typescript-sdk/resources/threads/runs\";\n\n/**\n * Message type for initial messages that seed a new thread.\n * Supports system and assistant roles in addition to user,\n * and restricts content to text and resource blocks (no tool results).\n */\nexport type InitialInputMessage = RunCreateParams.Thread.InitialMessage;\n\nexport type {\n  MessageListResponse,\n  MessageGetResponse,\n} from \"@tambo-ai/typescript-sdk/resources/threads/messages\";\n\n// Import for Content union type\nimport type {\n  TextContent,\n  ToolUseContent,\n  ToolResultContent,\n  ComponentContent,\n  ResourceContent,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\n/**\n * Streaming state for component content blocks.\n * Tracks the lifecycle of component prop/state streaming.\n */\nexport type ComponentStreamingState = \"started\" | \"streaming\" | \"done\";\n\n/**\n * Extended ComponentContent with streaming state.\n * Used by the SDK to track component rendering lifecycle.\n */\nexport interface TamboComponentContent extends ComponentContent {\n  /**\n   * Current streaming state of this component's props.\n   * - 'started': Component block created, awaiting props\n   * - 'streaming': Props are being streamed\n   * - 'done': Props streaming complete\n   *\n   * Optional for historical messages loaded from API (defaults to \"done\").\n   */\n  streamingState?: ComponentStreamingState;\n}\n\n/**\n * Special display properties that can be included in tool input.\n * These are used to customize tool status messages shown in the UI.\n */\nexport interface TamboToolDisplayProps {\n  /** Message shown while the tool is executing */\n  _tambo_statusMessage?: string;\n  /** Message shown after the tool completes */\n  _tambo_completionStatusMessage?: string;\n}\n\n/**\n * Extended ToolUseContent with computed state properties.\n * Used by the SDK to provide pre-computed tool state to consumers.\n *\n * Note: The computed properties are populated by `useTambo()` hook.\n * When accessed via lower-level APIs, they may be undefined.\n */\nexport interface TamboToolUseContent extends Omit<ToolUseContent, \"input\"> {\n  /**\n   * Tool input parameters with internal `_tambo_*` properties removed.\n   * Consumers see only the actual tool parameters.\n   */\n  input: Record<string, unknown>;\n\n  /**\n   * Whether this tool call has completed (has a matching tool_result).\n   * Computed by `useTambo()` based on presence of matching tool_result.\n   */\n  hasCompleted?: boolean;\n\n  /**\n   * The status message to display, resolved based on tool execution state.\n   * Automatically updates as tool progresses through execution lifecycle.\n   * Computed by `useTambo()`.\n   */\n  statusMessage?: string;\n\n  /**\n   * Extracted Tambo display properties from the tool input.\n   * Consumers can use these for custom rendering if needed.\n   * Computed by `useTambo()`.\n   */\n  tamboDisplayProps?: TamboToolDisplayProps;\n}\n\n/**\n * Message role (from SDK)\n * Includes 'system' to accommodate messages loaded from API.\n */\nexport type MessageRole = \"user\" | \"assistant\" | \"system\";\n\n/**\n * Union type of all content block types.\n * Uses TamboComponentContent and TamboToolUseContent which include computed state.\n */\nexport type Content =\n  | TextContent\n  | TamboToolUseContent\n  | ToolResultContent\n  | TamboComponentContent\n  | ResourceContent;\n\n/**\n * Message in a thread (simplified from SDK's MessageGetResponse)\n */\nexport interface TamboThreadMessage {\n  /** Unique message identifier */\n  id: string;\n\n  /** Message role (user or assistant) */\n  role: MessageRole;\n\n  /** Content blocks in the message */\n  content: Content[];\n\n  /** When the message was created (optional for historical messages loaded from API) */\n  createdAt?: string;\n\n  /** Message metadata */\n  metadata?: Record<string, unknown>;\n\n  /**\n   * The id of the parent message, if this message was created during\n   * generation of another message (e.g., MCP sampling or elicitation).\n   */\n  parentMessageId?: string;\n\n  /**\n   * Reasoning content from the model (transient - only during streaming).\n   * Each element is a reasoning \"chunk\" - models may emit multiple reasoning blocks.\n   * This data is not persisted to the database and will not be present in\n   * messages loaded from the API.\n   */\n  reasoning?: string[];\n\n  /**\n   * Duration of the reasoning phase in milliseconds (for display purposes).\n   * Populated when reasoning completes.\n   */\n  reasoningDurationMS?: number;\n}\n"]}

package/dist/types/thread.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Thread Types
+ *
+ * Re-exports thread types from `@tambo-ai/typescript-sdk` and defines
+ * React-specific extensions for streaming state management.
+ */
+import type { TamboThreadMessage } from "./message";
+export type { ThreadCreateResponse, ThreadRetrieveResponse, ThreadListResponse, } from "@tambo-ai/typescript-sdk/resources/threads/threads";
+/**
+ * Run status indicates the current state of the thread's run lifecycle.
+ * Matches the API's RunStatus — no "complete" or "error" variants.
+ * Error information is tracked separately in StreamingState.error.
+ */
+export type RunStatus = "idle" | "waiting" | "streaming";
+/**
+ * Thread represents a conversation with the AI
+ * Extended from SDK's ThreadRetrieveResponse with additional fields for React state
+ */
+export interface TamboThread {
+    /** Unique thread identifier */
+    id: string;
+    /** Thread name */
+    name?: string;
+    /** Messages in the thread */
+    messages: TamboThreadMessage[];
+    /** Current run status */
+    status: RunStatus;
+    /** Thread metadata */
+    metadata?: Record<string, unknown>;
+    /** When the thread was created */
+    createdAt: string;
+    /** When the thread was last updated */
+    updatedAt: string;
+    /** Whether the last run was cancelled (resets to false when a new run starts) */
+    lastRunCancelled: boolean;
+}
+/**
+ * Streaming state tracks the progress of an active run
+ * This is React-specific and not part of the SDK
+ */
+export interface StreamingState {
+    /** Current streaming status */
+    status: RunStatus;
+    /** Active run ID (if streaming) */
+    runId?: string;
+    /** Active message ID being streamed */
+    messageId?: string;
+    /** When the current run started */
+    startTime?: number;
+    /** When reasoning started (for duration calculation) */
+    reasoningStartTime?: number;
+    /** Error information if status is 'error' */
+    error?: {
+        message: string;
+        code?: string;
+    };
+}
+//# sourceMappingURL=thread.d.ts.map

package/dist/types/thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/types/thread.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGpD,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oDAAoD,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,6BAA6B;IAC7B,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAE/B,yBAAyB;IACzB,MAAM,EAAE,SAAS,CAAC;IAElB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAElB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAElB,iFAAiF;IACjF,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,MAAM,EAAE,SAAS,CAAC;IAElB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,6CAA6C;IAC7C,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}

package/dist/types/thread.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Thread Types
+ *
+ * Re-exports thread types from `@tambo-ai/typescript-sdk` and defines
+ * React-specific extensions for streaming state management.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=thread.js.map

package/dist/types/thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.js","sourceRoot":"","sources":["../../src/types/thread.ts"],"names":[],"mappings":";AAAA;;;;;GAKG","sourcesContent":["/**\n * Thread Types\n *\n * Re-exports thread types from `@tambo-ai/typescript-sdk` and defines\n * React-specific extensions for streaming state management.\n */\n\nimport type { TamboThreadMessage } from \"./message\";\n\n// Re-export thread types from TypeScript SDK\nexport type {\n  ThreadCreateResponse,\n  ThreadRetrieveResponse,\n  ThreadListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\n/**\n * Run status indicates the current state of the thread's run lifecycle.\n * Matches the API's RunStatus — no \"complete\" or \"error\" variants.\n * Error information is tracked separately in StreamingState.error.\n */\nexport type RunStatus = \"idle\" | \"waiting\" | \"streaming\";\n\n/**\n * Thread represents a conversation with the AI\n * Extended from SDK's ThreadRetrieveResponse with additional fields for React state\n */\nexport interface TamboThread {\n  /** Unique thread identifier */\n  id: string;\n\n  /** Thread name */\n  name?: string;\n\n  /** Messages in the thread */\n  messages: TamboThreadMessage[];\n\n  /** Current run status */\n  status: RunStatus;\n\n  /** Thread metadata */\n  metadata?: Record<string, unknown>;\n\n  /** When the thread was created */\n  createdAt: string;\n\n  /** When the thread was last updated */\n  updatedAt: string;\n\n  /** Whether the last run was cancelled (resets to false when a new run starts) */\n  lastRunCancelled: boolean;\n}\n\n/**\n * Streaming state tracks the progress of an active run\n * This is React-specific and not part of the SDK\n */\nexport interface StreamingState {\n  /** Current streaming status */\n  status: RunStatus;\n\n  /** Active run ID (if streaming) */\n  runId?: string;\n\n  /** Active message ID being streamed */\n  messageId?: string;\n\n  /** When the current run started */\n  startTime?: number;\n\n  /** When reasoning started (for duration calculation) */\n  reasoningStartTime?: number;\n\n  /** Error information if status is 'error' */\n  error?: {\n    message: string;\n    code?: string;\n  };\n}\n"]}

package/dist/types/tool-choice.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tool choice type matching the API format.
+ * Controls how the model selects tools during generation.
+ */
+export type ToolChoice = "auto" | "required" | "none" | {
+    name: string;
+};
+//# sourceMappingURL=tool-choice.d.ts.map

package/dist/types/tool-choice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-choice.d.ts","sourceRoot":"","sources":["../../src/types/tool-choice.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,UAAU,GACV,MAAM,GACN;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types/tool-choice.js

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

package/dist/types/tool-choice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-choice.js","sourceRoot":"","sources":["../../src/types/tool-choice.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Tool choice type matching the API format.\n * Controls how the model selects tools during generation.\n */\nexport type ToolChoice =\n  | \"auto\" // Model decides (default)\n  | \"required\" // Must use at least one tool\n  | \"none\" // Cannot use tools\n  | { name: string }; // Must use specific tool\n"]}

package/dist/utils/event-accumulator.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Event Accumulation Logic for Streaming API
+ *
+ * Implements a reducer that transforms AG-UI event streams into React state.
+ * Used with useReducer to accumulate events into thread state.
+ */
+import type { AGUIEvent } from "@ag-ui/core";
+import type { InitialInputMessage, TamboThreadMessage } from "../types/message";
+import type { StreamingState, TamboThread } from "../types/thread";
+import type { JSONSchema7 } from "json-schema";
+/**
+ * Error thrown when an unreachable case is reached in a switch statement.
+ * This indicates a programming error where not all cases were handled.
+ */
+export declare class UnreachableCaseError extends Error {
+    constructor(value: never);
+}
+/**
+ * Per-thread state managed by the stream reducer.
+ * Tracks thread data, streaming status, and accumulating data.
+ */
+export interface ThreadState {
+    thread: TamboThread;
+    streaming: StreamingState;
+    /**
+     * Accumulating tool call arguments as JSON strings (for streaming).
+     * Maps tool call ID to accumulated JSON string.
+     */
+    accumulatingToolArgs: Record<string, string>;
+    /**
+     * ID of the last completed run. Persists across the session so it's
+     * available as `previousRunId` when sending follow-up messages, even
+     * after the streaming state has been cleared (e.g., after page reload
+     * and thread re-fetch).
+     */
+    lastCompletedRunId?: string;
+}
+/**
+ * State managed by the stream reducer.
+ * Maintains a map of all threads being tracked.
+ */
+export interface StreamState {
+    /**
+     * Map of thread ID to thread state
+     */
+    threadMap: Record<string, ThreadState>;
+    /**
+     * Current active thread ID (for UI context)
+     */
+    currentThreadId: string;
+}
+/**
+ * Event action - dispatches an AG-UI event to update thread state.
+ */
+export interface EventAction {
+    type: "EVENT";
+    event: AGUIEvent;
+    threadId: string;
+    /** Pre-parsed partial JSON args for TOOL_CALL_ARGS events. Avoids double-parsing. */
+    parsedToolArgs?: Record<string, unknown>;
+    /** Original tool schemas for unstrictifying tool call args at TOOL_CALL_END. */
+    toolSchemas?: Map<string, JSONSchema7>;
+}
+/**
+ * Initialize thread action - creates a new thread in the threadMap.
+ */
+export interface InitThreadAction {
+    type: "INIT_THREAD";
+    threadId: string;
+    initialThread?: Partial<TamboThread>;
+}
+/**
+ * Set current thread action - changes the active thread.
+ */
+export interface SetCurrentThreadAction {
+    type: "SET_CURRENT_THREAD";
+    threadId: string;
+}
+/**
+ * Start new thread action - atomically creates and switches to a new thread.
+ * This prevents race conditions when multiple calls happen concurrently.
+ */
+export interface StartNewThreadAction {
+    type: "START_NEW_THREAD";
+    threadId: string;
+    initialThread?: Partial<TamboThread>;
+}
+/**
+ * Load thread messages action - loads messages from API into stream state.
+ * Used when switching to an existing thread to populate its messages.
+ */
+export interface LoadThreadMessagesAction {
+    type: "LOAD_THREAD_MESSAGES";
+    threadId: string;
+    messages: TamboThreadMessage[];
+    /**
+     * If true, skip loading if the thread is currently streaming.
+     * This prevents overwriting in-flight streaming messages.
+     */
+    skipIfStreaming?: boolean;
+}
+/**
+ * Set last completed run ID action - stores metadata from the API
+ * so it can be used as `previousRunId` for follow-up messages.
+ */
+export interface SetLastCompletedRunIdAction {
+    type: "SET_LAST_COMPLETED_RUN_ID";
+    threadId: string;
+    lastCompletedRunId: string;
+}
+/**
+ * Update thread name action - sets the name on a thread.
+ * Used after auto-generating a thread name via the API.
+ */
+export interface UpdateThreadNameAction {
+    type: "UPDATE_THREAD_NAME";
+    threadId: string;
+    name: string;
+}
+/**
+ * Action type for the stream reducer.
+ */
+export type StreamAction = EventAction | InitThreadAction | SetCurrentThreadAction | StartNewThreadAction | LoadThreadMessagesAction | SetLastCompletedRunIdAction | UpdateThreadNameAction;
+/**
+ * Create initial thread state for a new thread.
+ * @param threadId - Unique thread identifier
+ * @returns Initial thread state
+ */
+export declare function createInitialThreadState(threadId: string): ThreadState;
+/**
+ * Placeholder thread ID used for new threads before they get a real ID from the server.
+ * This allows optimistic UI updates (showing user messages immediately) before the
+ * server responds with the actual thread ID.
+ */
+export declare const PLACEHOLDER_THREAD_ID = "placeholder";
+/**
+ * Check if a thread ID is a placeholder (not a real API thread ID).
+ * @param threadId - Thread ID to check
+ * @returns True if this is a placeholder thread ID
+ */
+export declare function isPlaceholderThreadId(threadId: string | null | undefined): boolean;
+/**
+ * Create initial stream state with placeholder thread.
+ * @returns Initial stream state
+ */
+export declare function createInitialState(): StreamState;
+/**
+ * Create initial stream state with placeholder thread seeded with initial messages.
+ * The messages are converted from InputMessage format to TamboThreadMessage format
+ * for immediate UI display before any API call.
+ * @param initialMessages - Messages to seed the placeholder thread with
+ * @returns Initial stream state with messages in the placeholder thread
+ */
+export declare function createInitialStateWithMessages(initialMessages: InitialInputMessage[]): StreamState;
+/**
+ * Stream reducer that accumulates events into thread state.
+ *
+ * This reducer handles all AG-UI events and Tambo custom events,
+ * transforming them into immutable state updates per thread.
+ * @param state - Current stream state
+ * @param action - Action to process
+ * @returns Updated stream state
+ */
+export declare function streamReducer(state: StreamState, action: StreamAction): StreamState;
+//# sourceMappingURL=event-accumulator.d.ts.map

package/dist/utils/event-accumulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-accumulator.d.ts","sourceRoot":"","sources":["../../src/utils/event-accumulator.ts"],"names":[],"mappings":"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"}