@tambo-ai/react 1.0.3 → 1.2.0

package/esm/v1/utils/event-accumulator.d.ts

@@ -1,165 +0,0 @@
-/**
- * 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.js";
-import type { StreamingState, TamboThread } from "../types/thread.js";
-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: Map<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/esm/v1/utils/event-accumulator.d.ts.map

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