@tambo-ai/react 0.69.1 → 0.71.0

package/dist/v1/types/event.test.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@ag-ui/core");
+const event_1 = require("./event");
+describe("isTamboCustomEvent", () => {
+    it("returns true for tambo.component.start event", () => {
+        const event = {
+            type: core_1.EventType.CUSTOM,
+            name: "tambo.component.start",
+            value: { messageId: "msg1", componentId: "comp1", componentName: "Test" },
+        };
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+    });
+    it("returns true for tambo.component.props_delta event", () => {
+        const event = {
+            type: core_1.EventType.CUSTOM,
+            name: "tambo.component.props_delta",
+            value: { componentId: "comp1", operations: [] },
+        };
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+    });
+    it("returns true for tambo.component.state_delta event", () => {
+        const event = {
+            type: core_1.EventType.CUSTOM,
+            name: "tambo.component.state_delta",
+            value: { componentId: "comp1", operations: [] },
+        };
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+    });
+    it("returns true for tambo.component.end event", () => {
+        const event = {
+            type: core_1.EventType.CUSTOM,
+            name: "tambo.component.end",
+            value: { componentId: "comp1" },
+        };
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+    });
+    it("returns true for tambo.run.awaiting_input event", () => {
+        const event = {
+            type: core_1.EventType.CUSTOM,
+            name: "tambo.run.awaiting_input",
+            value: { pendingToolCallIds: ["tool1"] },
+        };
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+    });
+    it("returns false for unknown custom event name", () => {
+        const event = {
+            type: core_1.EventType.CUSTOM,
+            name: "unknown.event",
+            value: {},
+        };
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(false);
+    });
+    it("returns false when name is undefined", () => {
+        const event = {};
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(false);
+    });
+    it("returns false when name is not a string", () => {
+        const event = {
+            type: core_1.EventType.CUSTOM,
+            name: 123,
+            value: {},
+        };
+        expect((0, event_1.isTamboCustomEvent)(event)).toBe(false);
+    });
+    it("returns false for empty object", () => {
+        expect((0, event_1.isTamboCustomEvent)({})).toBe(false);
+    });
+});
+//# sourceMappingURL=event.test.js.map

package/dist/v1/types/event.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.test.js","sourceRoot":"","sources":["../../../src/v1/types/event.test.ts"],"names":[],"mappings":";;AAAA,sCAAwC;AACxC,mCAA6C;AAE7C,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,KAAK,GAAG;YACZ,IAAI,EAAE,gBAAS,CAAC,MAAM;YACtB,IAAI,EAAE,uBAAuB;YAC7B,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE;SAC1E,CAAC;QACF,MAAM,CAAC,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,KAAK,GAAG;YACZ,IAAI,EAAE,gBAAS,CAAC,MAAM;YACtB,IAAI,EAAE,6BAA6B;YACnC,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE;SAChD,CAAC;QACF,MAAM,CAAC,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,KAAK,GAAG;YACZ,IAAI,EAAE,gBAAS,CAAC,MAAM;YACtB,IAAI,EAAE,6BAA6B;YACnC,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE;SAChD,CAAC;QACF,MAAM,CAAC,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,KAAK,GAAG;YACZ,IAAI,EAAE,gBAAS,CAAC,MAAM;YACtB,IAAI,EAAE,qBAAqB;YAC3B,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE;SAChC,CAAC;QACF,MAAM,CAAC,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,KAAK,GAAG;YACZ,IAAI,EAAE,gBAAS,CAAC,MAAM;YACtB,IAAI,EAAE,0BAA0B;YAChC,KAAK,EAAE,EAAE,kBAAkB,EAAE,CAAC,OAAO,CAAC,EAAE;SACzC,CAAC;QACF,MAAM,CAAC,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,KAAK,GAAG;YACZ,IAAI,EAAE,gBAAS,CAAC,MAAM;YACtB,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,EAAE;SACV,CAAC;QACF,MAAM,CAAC,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,KAAK,GAAsB,EAAE,CAAC;QACpC,MAAM,CAAC,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,KAAK,GAAG;YACZ,IAAI,EAAE,gBAAS,CAAC,MAAM;YACtB,IAAI,EAAE,GAAG;YACT,KAAK,EAAE,EAAE;SACV,CAAC;QACF,MAAM,CAAC,IAAA,0BAAkB,EAAC,KAAqC,CAAC,CAAC,CAAC,IAAI,CACpE,KAAK,CACN,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,IAAA,0BAAkB,EAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { EventType } from \"@ag-ui/core\";\nimport { isTamboCustomEvent } from \"./event\";\n\ndescribe(\"isTamboCustomEvent\", () => {\n  it(\"returns true for tambo.component.start event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.start\",\n      value: { messageId: \"msg1\", componentId: \"comp1\", componentName: \"Test\" },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.component.props_delta event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.props_delta\",\n      value: { componentId: \"comp1\", operations: [] },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.component.state_delta event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.state_delta\",\n      value: { componentId: \"comp1\", operations: [] },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.component.end event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.end\",\n      value: { componentId: \"comp1\" },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.run.awaiting_input event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.run.awaiting_input\",\n      value: { pendingToolCallIds: [\"tool1\"] },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns false for unknown custom event name\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"unknown.event\",\n      value: {},\n    };\n    expect(isTamboCustomEvent(event)).toBe(false);\n  });\n\n  it(\"returns false when name is undefined\", () => {\n    const event: { name?: string } = {};\n    expect(isTamboCustomEvent(event)).toBe(false);\n  });\n\n  it(\"returns false when name is not a string\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: 123,\n      value: {},\n    };\n    expect(isTamboCustomEvent(event as unknown as { name?: string })).toBe(\n      false,\n    );\n  });\n\n  it(\"returns false for empty object\", () => {\n    expect(isTamboCustomEvent({})).toBe(false);\n  });\n});\n"]}

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

@@ -0,0 +1,35 @@
+/**
+ * Message and Content Types for v1 API
+ *
+ * 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, ToolUseContent, ToolResultContent, ComponentContent, ResourceContent, } from "@tambo-ai/typescript-sdk/resources/threads/threads";
+export type { InputMessage } from "@tambo-ai/typescript-sdk/resources/threads/runs";
+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";
+/**
+ * Message role (from SDK)
+ */
+export type MessageRole = "user" | "assistant";
+/**
+ * Union type of all content block types
+ */
+export type Content = TextContent | ToolUseContent | ToolResultContent | ComponentContent | ResourceContent;
+/**
+ * Message in a thread (simplified from SDK's MessageGetResponse)
+ */
+export interface TamboV1Message {
+    /** Unique message identifier */
+    id: string;
+    /** Message role (user or assistant) */
+    role: MessageRole;
+    /** Content blocks in the message */
+    content: Content[];
+    /** When the message was created */
+    createdAt: string;
+    /** Message metadata */
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=message.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/v1/types/message.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,oDAAoD,CAAC;AAG5D,YAAY,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAEpF,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;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,OAAO,GACf,WAAW,GACX,cAAc,GACd,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IAEX,uCAAuC;IACvC,IAAI,EAAE,WAAW,CAAC;IAElB,oCAAoC;IACpC,OAAO,EAAE,OAAO,EAAE,CAAC;IAEnB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAElB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/v1/types/message.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Message and Content Types for v1 API
+ *
+ * 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/v1/types/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/v1/types/message.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG","sourcesContent":["/**\n * Message and Content Types for v1 API\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\nexport type {\n  TextContent,\n  ToolUseContent,\n  ToolResultContent,\n  ComponentContent,\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\";\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 * Message role (from SDK)\n */\nexport type MessageRole = \"user\" | \"assistant\";\n\n/**\n * Union type of all content block types\n */\nexport type Content =\n  | TextContent\n  | ToolUseContent\n  | ToolResultContent\n  | ComponentContent\n  | ResourceContent;\n\n/**\n * Message in a thread (simplified from SDK's MessageGetResponse)\n */\nexport interface TamboV1Message {\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 */\n  createdAt: string;\n\n  /** Message metadata */\n  metadata?: Record<string, unknown>;\n}\n"]}

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

@@ -0,0 +1,52 @@
+/**
+ * Thread Types for v1 API
+ *
+ * Re-exports thread types from `@tambo-ai/typescript-sdk` and defines
+ * React-specific extensions for streaming state management.
+ */
+import type { TamboV1Message } from "./message";
+export type { ThreadCreateResponse, ThreadRetrieveResponse, ThreadListResponse, } from "@tambo-ai/typescript-sdk/resources/threads/threads";
+/**
+ * Run status indicates the current state of the thread
+ */
+export type RunStatus = "idle" | "waiting" | "streaming" | "complete" | "error";
+/**
+ * Thread represents a conversation with the AI
+ * Extended from SDK's ThreadRetrieveResponse with additional fields for React state
+ */
+export interface TamboV1Thread {
+    /** Unique thread identifier */
+    id: string;
+    /** Thread title/name */
+    title?: string;
+    /** Messages in the thread */
+    messages: TamboV1Message[];
+    /** 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;
+}
+/**
+ * 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;
+    /** Error information if status is 'error' */
+    error?: {
+        message: string;
+        code?: string;
+    };
+}
+//# sourceMappingURL=thread.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../../src/v1/types/thread.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oDAAoD,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAE3B,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;CACnB;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,6CAA6C;IAC7C,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}

package/dist/v1/types/thread.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Thread Types for v1 API
+ *
+ * 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/v1/types/thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.js","sourceRoot":"","sources":["../../../src/v1/types/thread.ts"],"names":[],"mappings":";AAAA;;;;;GAKG","sourcesContent":["/**\n * Thread Types for v1 API\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 { TamboV1Message } 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\n */\nexport type RunStatus = \"idle\" | \"waiting\" | \"streaming\" | \"complete\" | \"error\";\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 TamboV1Thread {\n  /** Unique thread identifier */\n  id: string;\n\n  /** Thread title/name */\n  title?: string;\n\n  /** Messages in the thread */\n  messages: TamboV1Message[];\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\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  /** Error information if status is 'error' */\n  error?: {\n    message: string;\n    code?: string;\n  };\n}\n"]}

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

@@ -0,0 +1,100 @@
+/**
+ * Event Accumulation Logic for v1 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 { StreamingState, TamboV1Thread } from "../types/thread";
+/**
+ * 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: TamboV1Thread;
+    streaming: StreamingState;
+    /**
+     * Accumulating tool call arguments as JSON strings (for streaming).
+     * Maps tool call ID to accumulated JSON string.
+     */
+    accumulatingToolArgs: Map<string, 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 | null;
+}
+/**
+ * Event action - dispatches an AG-UI event to update thread state.
+ */
+export interface EventAction {
+    type: "EVENT";
+    event: AGUIEvent;
+    threadId: string;
+}
+/**
+ * Initialize thread action - creates a new thread in the threadMap.
+ */
+export interface InitThreadAction {
+    type: "INIT_THREAD";
+    threadId: string;
+    initialThread?: Partial<TamboV1Thread>;
+}
+/**
+ * Set current thread action - changes the active thread.
+ */
+export interface SetCurrentThreadAction {
+    type: "SET_CURRENT_THREAD";
+    threadId: string | null;
+}
+/**
+ * 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<TamboV1Thread>;
+}
+/**
+ * Action type for the stream reducer.
+ */
+export type StreamAction = EventAction | InitThreadAction | SetCurrentThreadAction | StartNewThreadAction;
+/**
+ * Create initial thread state for a new thread.
+ * @param threadId - Unique thread identifier
+ * @returns Initial thread state
+ */
+export declare function createInitialThreadState(threadId: string): ThreadState;
+/**
+ * Create initial stream state with empty threadMap.
+ * @returns Initial stream state
+ */
+export declare function createInitialState(): 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/v1/utils/event-accumulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-accumulator.d.ts","sourceRoot":"","sources":["../../../src/v1/utils/event-accumulator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EAYV,MAAM,aAAa,CAAC;AAWrB,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrE;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,KAAK,EAAE,KAAK;CAIzB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,cAAc,CAAC;IAC1B;;;OAGG;IACH,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAEvC;;OAEG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,gBAAgB,GAChB,sBAAsB,GACtB,oBAAoB,CAAC;AASzB;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAatE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAKhD;AAuGD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,GACnB,WAAW,CAwLb"}