@tambo-ai/react 0.70.0 → 0.72.0

package/esm/v1/hooks/use-tambo-v1.test.js

@@ -0,0 +1,145 @@
+import { renderHook, act } from "@testing-library/react";
+import React from "react";
+import { useTamboClient } from "../../providers/tambo-client-provider";
+import { TamboRegistryContext, } from "../../providers/tambo-registry-provider";
+import { TamboV1StreamProvider } from "../providers/tambo-v1-stream-context";
+import { useTamboV1 } from "./use-tambo-v1";
+jest.mock("../../providers/tambo-client-provider", () => ({
+    useTamboClient: jest.fn(),
+}));
+describe("useTamboV1", () => {
+    const mockTamboClient = {
+        apiKey: "",
+        threads: {},
+    };
+    const mockRegistry = {
+        componentList: {},
+        toolRegistry: {},
+        componentToolAssociations: {},
+        mcpServerInfos: [],
+        resources: [],
+        resourceSource: null,
+        registerComponent: jest.fn(),
+        registerTool: jest.fn(),
+        registerTools: jest.fn(),
+        addToolAssociation: jest.fn(),
+        registerMcpServer: jest.fn(),
+        registerMcpServers: jest.fn(),
+        registerResource: jest.fn(),
+        registerResources: jest.fn(),
+        registerResourceSource: jest.fn(),
+    };
+    function TestWrapper({ children }) {
+        return (React.createElement(TamboRegistryContext.Provider, { value: mockRegistry },
+            React.createElement(TamboV1StreamProvider, null, children)));
+    }
+    function TestWrapperWithThreadId({ children, }) {
+        return (React.createElement(TamboRegistryContext.Provider, { value: mockRegistry },
+            React.createElement(TamboV1StreamProvider, { threadId: "thread_123" }, children)));
+    }
+    beforeEach(() => {
+        jest.mocked(useTamboClient).mockReturnValue(mockTamboClient);
+        jest.clearAllMocks();
+    });
+    it("returns client from useTamboClient", () => {
+        const { result } = renderHook(() => useTamboV1(), {
+            wrapper: TestWrapper,
+        });
+        expect(result.current.client).toBe(mockTamboClient);
+    });
+    it("returns registry functions", () => {
+        const { result } = renderHook(() => useTamboV1(), {
+            wrapper: TestWrapper,
+        });
+        expect(result.current.registerComponent).toBe(mockRegistry.registerComponent);
+        expect(result.current.registerTool).toBe(mockRegistry.registerTool);
+        expect(result.current.registerTools).toBe(mockRegistry.registerTools);
+        expect(result.current.componentList).toBe(mockRegistry.componentList);
+        expect(result.current.toolRegistry).toBe(mockRegistry.toolRegistry);
+    });
+    it("returns undefined thread when no threadId provided", () => {
+        const { result } = renderHook(() => useTamboV1(), {
+            wrapper: TestWrapper,
+        });
+        expect(result.current.thread).toBeUndefined();
+        expect(result.current.messages).toEqual([]);
+    });
+    it("returns thread state when threadId provided", () => {
+        const { result } = renderHook(() => useTamboV1("thread_123"), {
+            wrapper: TestWrapperWithThreadId,
+        });
+        expect(result.current.thread).toBeDefined();
+        expect(result.current.thread?.thread.id).toBe("thread_123");
+        expect(result.current.messages).toEqual([]);
+    });
+    it("returns default streaming state when thread not loaded", () => {
+        const { result } = renderHook(() => useTamboV1(), {
+            wrapper: TestWrapper,
+        });
+        expect(result.current.streamingState).toEqual({ status: "idle" });
+        expect(result.current.isIdle).toBe(true);
+        expect(result.current.isStreaming).toBe(false);
+        expect(result.current.isWaiting).toBe(false);
+    });
+    it("returns thread streaming state when thread loaded", () => {
+        const { result } = renderHook(() => useTamboV1("thread_123"), {
+            wrapper: TestWrapperWithThreadId,
+        });
+        expect(result.current.streamingState.status).toBe("idle");
+        expect(result.current.isIdle).toBe(true);
+        expect(result.current.isStreaming).toBe(false);
+        expect(result.current.isWaiting).toBe(false);
+    });
+    it("provides dispatch function for advanced usage", () => {
+        const { result } = renderHook(() => useTamboV1(), {
+            wrapper: TestWrapper,
+        });
+        expect(typeof result.current.dispatch).toBe("function");
+    });
+    it("provides thread management functions", () => {
+        const { result } = renderHook(() => useTamboV1(), {
+            wrapper: TestWrapper,
+        });
+        expect(typeof result.current.initThread).toBe("function");
+        expect(typeof result.current.switchThread).toBe("function");
+        expect(typeof result.current.startNewThread).toBe("function");
+    });
+    it("initializes and switches threads", () => {
+        const { result } = renderHook(() => useTamboV1(), {
+            wrapper: TestWrapper,
+        });
+        // Initially no current thread
+        expect(result.current.currentThreadId).toBeNull();
+        expect(result.current.thread).toBeUndefined();
+        // Initialize a new thread
+        act(() => {
+            result.current.initThread("new_thread_1");
+        });
+        // Switch to the new thread
+        act(() => {
+            result.current.switchThread("new_thread_1");
+        });
+        expect(result.current.currentThreadId).toBe("new_thread_1");
+    });
+    it("starts new thread with generated ID", () => {
+        const { result } = renderHook(() => useTamboV1(), {
+            wrapper: TestWrapper,
+        });
+        let newThreadId;
+        act(() => {
+            newThreadId = result.current.startNewThread();
+        });
+        expect(newThreadId).toMatch(/^temp_/);
+        expect(result.current.currentThreadId).toBe(newThreadId);
+        expect(result.current.thread).toBeDefined();
+    });
+    it("uses current thread when no threadId argument provided", () => {
+        const { result } = renderHook(() => useTamboV1(), {
+            wrapper: TestWrapperWithThreadId,
+        });
+        // Should use current thread from context (thread_123)
+        expect(result.current.currentThreadId).toBe("thread_123");
+        expect(result.current.thread?.thread.id).toBe("thread_123");
+    });
+});
+//# sourceMappingURL=use-tambo-v1.test.js.map

package/esm/v1/hooks/use-tambo-v1.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1.test.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { renderHook, act } from \"@testing-library/react\";\nimport React from \"react\";\nimport { useTamboClient } from \"../../providers/tambo-client-provider\";\nimport {\n  TamboRegistryContext,\n  type TamboRegistryContext as TamboRegistryContextType,\n} from \"../../providers/tambo-registry-provider\";\nimport { TamboV1StreamProvider } from \"../providers/tambo-v1-stream-context\";\nimport { useTamboV1 } from \"./use-tambo-v1\";\n\njest.mock(\"../../providers/tambo-client-provider\", () => ({\n  useTamboClient: jest.fn(),\n}));\n\ndescribe(\"useTamboV1\", () => {\n  const mockTamboClient = {\n    apiKey: \"\",\n    threads: {},\n  } as unknown as TamboAI;\n\n  const mockRegistry: TamboRegistryContextType = {\n    componentList: {},\n    toolRegistry: {},\n    componentToolAssociations: {},\n    mcpServerInfos: [],\n    resources: [],\n    resourceSource: null,\n    registerComponent: jest.fn(),\n    registerTool: jest.fn(),\n    registerTools: jest.fn(),\n    addToolAssociation: jest.fn(),\n    registerMcpServer: jest.fn(),\n    registerMcpServers: jest.fn(),\n    registerResource: jest.fn(),\n    registerResources: jest.fn(),\n    registerResourceSource: jest.fn(),\n  };\n\n  function TestWrapper({ children }: { children: React.ReactNode }) {\n    return (\n      <TamboRegistryContext.Provider value={mockRegistry}>\n        <TamboV1StreamProvider>{children}</TamboV1StreamProvider>\n      </TamboRegistryContext.Provider>\n    );\n  }\n\n  function TestWrapperWithThreadId({\n    children,\n  }: {\n    children: React.ReactNode;\n  }) {\n    return (\n      <TamboRegistryContext.Provider value={mockRegistry}>\n        <TamboV1StreamProvider threadId=\"thread_123\">\n          {children}\n        </TamboV1StreamProvider>\n      </TamboRegistryContext.Provider>\n    );\n  }\n\n  beforeEach(() => {\n    jest.mocked(useTamboClient).mockReturnValue(mockTamboClient);\n    jest.clearAllMocks();\n  });\n\n  it(\"returns client from useTamboClient\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    expect(result.current.client).toBe(mockTamboClient);\n  });\n\n  it(\"returns registry functions\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    expect(result.current.registerComponent).toBe(\n      mockRegistry.registerComponent,\n    );\n    expect(result.current.registerTool).toBe(mockRegistry.registerTool);\n    expect(result.current.registerTools).toBe(mockRegistry.registerTools);\n    expect(result.current.componentList).toBe(mockRegistry.componentList);\n    expect(result.current.toolRegistry).toBe(mockRegistry.toolRegistry);\n  });\n\n  it(\"returns undefined thread when no threadId provided\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    expect(result.current.thread).toBeUndefined();\n    expect(result.current.messages).toEqual([]);\n  });\n\n  it(\"returns thread state when threadId provided\", () => {\n    const { result } = renderHook(() => useTamboV1(\"thread_123\"), {\n      wrapper: TestWrapperWithThreadId,\n    });\n\n    expect(result.current.thread).toBeDefined();\n    expect(result.current.thread?.thread.id).toBe(\"thread_123\");\n    expect(result.current.messages).toEqual([]);\n  });\n\n  it(\"returns default streaming state when thread not loaded\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    expect(result.current.streamingState).toEqual({ status: \"idle\" });\n    expect(result.current.isIdle).toBe(true);\n    expect(result.current.isStreaming).toBe(false);\n    expect(result.current.isWaiting).toBe(false);\n  });\n\n  it(\"returns thread streaming state when thread loaded\", () => {\n    const { result } = renderHook(() => useTamboV1(\"thread_123\"), {\n      wrapper: TestWrapperWithThreadId,\n    });\n\n    expect(result.current.streamingState.status).toBe(\"idle\");\n    expect(result.current.isIdle).toBe(true);\n    expect(result.current.isStreaming).toBe(false);\n    expect(result.current.isWaiting).toBe(false);\n  });\n\n  it(\"provides dispatch function for advanced usage\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    expect(typeof result.current.dispatch).toBe(\"function\");\n  });\n\n  it(\"provides thread management functions\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    expect(typeof result.current.initThread).toBe(\"function\");\n    expect(typeof result.current.switchThread).toBe(\"function\");\n    expect(typeof result.current.startNewThread).toBe(\"function\");\n  });\n\n  it(\"initializes and switches threads\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    // Initially no current thread\n    expect(result.current.currentThreadId).toBeNull();\n    expect(result.current.thread).toBeUndefined();\n\n    // Initialize a new thread\n    act(() => {\n      result.current.initThread(\"new_thread_1\");\n    });\n\n    // Switch to the new thread\n    act(() => {\n      result.current.switchThread(\"new_thread_1\");\n    });\n\n    expect(result.current.currentThreadId).toBe(\"new_thread_1\");\n  });\n\n  it(\"starts new thread with generated ID\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    let newThreadId: string;\n    act(() => {\n      newThreadId = result.current.startNewThread();\n    });\n\n    expect(newThreadId!).toMatch(/^temp_/);\n    expect(result.current.currentThreadId).toBe(newThreadId!);\n    expect(result.current.thread).toBeDefined();\n  });\n\n  it(\"uses current thread when no threadId argument provided\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapperWithThreadId,\n    });\n\n    // Should use current thread from context (thread_123)\n    expect(result.current.currentThreadId).toBe(\"thread_123\");\n    expect(result.current.thread?.thread.id).toBe(\"thread_123\");\n  });\n});\n"]}

package/esm/v1/index.d.ts

@@ -1,35 +1,84 @@
 /**
- * @tambo-ai/react/v1 - React SDK for Tambo v1 API
+ * `@tambo-ai/react/v1` - React SDK for Tambo v1 API
  *
  * Provides React hooks and providers for building AI-powered applications
  * using the v1 streaming API with AG-UI protocol.
  *
- * Types are not re-exported. Import directly from specific type files:
- * - Custom events: import from '@tambo-ai/react/v1/types/event'
- * - Thread state: import from '@tambo-ai/react/v1/types/thread'
- * - Messages: import from '@tambo-ai/react/v1/types/message'
- * - Components: import from '@tambo-ai/react/v1/types/component'
- * - Tools: import from '@tambo-ai/react/v1/types/tool'
+ * ## Quick Start
  *
- * SDK types: import directly from @tambo-ai/typescript-sdk
- * AG-UI events: import directly from @ag-ui/core
- * @example
- * ```typescript
- * import { TamboV1Provider, useTamboV1 } from '@tambo-ai/react/v1';
+ * ```tsx
+ * import {
+ *   TamboV1Provider,
+ *   useTamboV1,
+ *   useTamboV1ThreadInput,
+ * } from '@tambo-ai/react/v1';
  *
  * function App() {
  *   return (
- *     <TamboV1Provider apiKey="your-api-key">
+ *     <TamboV1Provider
+ *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}
+ *       components={[WeatherCard]}
+ *       tools={[searchTool]}
+ *     >
  *       <ChatInterface />
  *     </TamboV1Provider>
  *   );
  * }
  *
  * function ChatInterface() {
- *   const { thread, sendMessage, isStreaming } = useTamboV1();
- *   // ... implementation
+ *   const [threadId, setThreadId] = useState<string>();
+ *   const { messages, isStreaming } = useTamboV1(threadId);
+ *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput(threadId);
+ *
+ *   const handleSubmit = async (e: React.FormEvent) => {
+ *     e.preventDefault();
+ *     const result = await submit();
+ *     if (!threadId) setThreadId(result.threadId);
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       {messages.map(msg => <Message key={msg.id} message={msg} />)}
+ *       {isStreaming && <LoadingIndicator />}
+ *       <input value={value} onChange={(e) => setValue(e.target.value)} />
+ *       <button disabled={isPending}>Send</button>
+ *     </form>
+ *   );
  * }
  * ```
+ *
+ * ## Type Imports
+ *
+ * Types are imported directly from specific files:
+ * - Thread state: `import type { TamboV1Thread } from '@tambo-ai/react/v1/types/thread'`
+ * - Messages: `import type { TamboV1Message } from '@tambo-ai/react/v1/types/message'`
+ * - Custom events: `import type { ComponentStartEvent } from '@tambo-ai/react/v1/types/event'`
+ *
+ * SDK types: `import type { ... } from '@tambo-ai/typescript-sdk'`
+ * AG-UI events: `import { EventType, type BaseEvent } from '@ag-ui/core'`
  */
-export {};
+export { TamboV1Provider, useContextKey, type TamboV1ProviderProps, } from "./providers/tambo-v1-provider";
+export { TamboV1StreamProvider, useStreamState, useStreamDispatch, useThreadManagement, type ThreadManagement, } from "./providers/tambo-v1-stream-context";
+export { TamboRegistryProvider } from "../providers/tambo-registry-provider";
+export { TamboContextHelpersProvider, useTamboContextHelpers, } from "../providers/tambo-context-helpers-provider";
+export { useTamboV1, type UseTamboV1Return } from "./hooks/use-tambo-v1";
+export { useTamboV1ThreadInput, type UseTamboV1ThreadInputReturn, type SubmitOptions, } from "./hooks/use-tambo-v1-thread-input";
+export { useTamboV1Thread } from "./hooks/use-tambo-v1-thread";
+export { useTamboV1ThreadList } from "./hooks/use-tambo-v1-thread-list";
+export { useTamboV1ComponentState, type UseTamboV1ComponentStateReturn, } from "./hooks/use-tambo-v1-component-state";
+export { useTamboClient } from "../providers/tambo-client-provider";
+export { useTamboRegistry } from "../providers/tambo-registry-provider";
+export { useV1ComponentContent, useV1ComponentContentOptional, renderComponentContent, renderMessageContent, renderMessageComponents, isComponentContent, type V1ComponentContentContext, type RenderComponentOptions, } from "./utils/component-renderer";
+export { applyJsonPatch } from "./utils/json-patch";
+export { toAvailableComponent, toAvailableComponents, toAvailableTool, toAvailableTools, } from "./utils/registry-conversion";
+export { executeClientTool, executeAllPendingTools, type PendingToolCall, } from "./utils/tool-executor";
+export { ToolCallTracker } from "./utils/tool-call-tracker";
+export { handleEventStream } from "./utils/stream-handler";
+export { defineTool } from "../util/registry";
+export { currentPageContextHelper, currentTimeContextHelper, } from "../context-helpers";
+export type { AdditionalContext, ContextHelperFn, ContextHelpers, } from "../context-helpers";
+export type { ComponentContextToolMetadata, ComponentRegistry, ParameterSpec, RegisteredComponent, TamboTool, ToolAnnotations, } from "../model/component-metadata";
+export { MCPTransport } from "../model/mcp-server-info";
+export type { McpServerInfo, NormalizedMcpServerInfo, } from "../model/mcp-server-info";
+export type { ListResourceItem, ReadResourceResult, ResourceSource, } from "../model/resource-info";
 //# sourceMappingURL=index.d.ts.map

package/esm/v1/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAMH,OAAO,EACL,eAAe,EACf,aAAa,EACb,KAAK,oBAAoB,GAC1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,6CAA6C,CAAC;AAMrD,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EACL,qBAAqB,EACrB,KAAK,2BAA2B,EAChC,KAAK,aAAa,GACnB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,EACL,wBAAwB,EACxB,KAAK,8BAA8B,GACpC,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAMxE,OAAO,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,GAC5B,MAAM,4BAA4B,CAAC;AAMpC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,4BAA4B,EAC5B,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,eAAe,GAChB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EACV,aAAa,EACb,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,wBAAwB,CAAC"}

package/esm/v1/index.js

@@ -1,46 +1,102 @@
 /**
- * @tambo-ai/react/v1 - React SDK for Tambo v1 API
+ * `@tambo-ai/react/v1` - React SDK for Tambo v1 API
  *
  * Provides React hooks and providers for building AI-powered applications
  * using the v1 streaming API with AG-UI protocol.
  *
- * Types are not re-exported. Import directly from specific type files:
- * - Custom events: import from '@tambo-ai/react/v1/types/event'
- * - Thread state: import from '@tambo-ai/react/v1/types/thread'
- * - Messages: import from '@tambo-ai/react/v1/types/message'
- * - Components: import from '@tambo-ai/react/v1/types/component'
- * - Tools: import from '@tambo-ai/react/v1/types/tool'
+ * ## Quick Start
  *
- * SDK types: import directly from @tambo-ai/typescript-sdk
- * AG-UI events: import directly from @ag-ui/core
- * @example
- * ```typescript
- * import { TamboV1Provider, useTamboV1 } from '@tambo-ai/react/v1';
+ * ```tsx
+ * import {
+ *   TamboV1Provider,
+ *   useTamboV1,
+ *   useTamboV1ThreadInput,
+ * } from '@tambo-ai/react/v1';
  *
  * function App() {
  *   return (
- *     <TamboV1Provider apiKey="your-api-key">
+ *     <TamboV1Provider
+ *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}
+ *       components={[WeatherCard]}
+ *       tools={[searchTool]}
+ *     >
  *       <ChatInterface />
  *     </TamboV1Provider>
  *   );
  * }
  *
  * function ChatInterface() {
- *   const { thread, sendMessage, isStreaming } = useTamboV1();
- *   // ... implementation
+ *   const [threadId, setThreadId] = useState<string>();
+ *   const { messages, isStreaming } = useTamboV1(threadId);
+ *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput(threadId);
+ *
+ *   const handleSubmit = async (e: React.FormEvent) => {
+ *     e.preventDefault();
+ *     const result = await submit();
+ *     if (!threadId) setThreadId(result.threadId);
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       {messages.map(msg => <Message key={msg.id} message={msg} />)}
+ *       {isStreaming && <LoadingIndicator />}
+ *       <input value={value} onChange={(e) => setValue(e.target.value)} />
+ *       <button disabled={isPending}>Send</button>
+ *     </form>
+ *   );
  * }
  * ```
+ *
+ * ## Type Imports
+ *
+ * Types are imported directly from specific files:
+ * - Thread state: `import type { TamboV1Thread } from '@tambo-ai/react/v1/types/thread'`
+ * - Messages: `import type { TamboV1Message } from '@tambo-ai/react/v1/types/message'`
+ * - Custom events: `import type { ComponentStartEvent } from '@tambo-ai/react/v1/types/event'`
+ *
+ * SDK types: `import type { ... } from '@tambo-ai/typescript-sdk'`
+ * AG-UI events: `import { EventType, type BaseEvent } from '@ag-ui/core'`
  */
-export {};
-// Providers (TODO: implement in Phase 7)
-// export { TamboV1Provider } from './providers/tambo-v1-provider';
-// export { TamboRegistryProvider } from '../providers/tambo-registry-provider'; // Reused from beta
-// Hooks (TODO: implement in Phase 7)
-// export { useTamboV1 } from './hooks/use-tambo-v1';
-// export { useTamboV1Thread } from './hooks/use-tambo-v1-thread';
-// export { useTamboV1Messages } from './hooks/use-tambo-v1-messages';
-// export { useTamboV1SendMessage } from './hooks/use-tambo-v1-send-message';
-// export { useTamboV1ComponentState } from './hooks/use-tambo-v1-component-state';
-// Utilities (TODO: implement in Phase 2-3)
-// export { applyJsonPatch } from './utils/json-patch';
+// =============================================================================
+// Providers
+// =============================================================================
+export { TamboV1Provider, useContextKey, } from "./providers/tambo-v1-provider";
+export { TamboV1StreamProvider, useStreamState, useStreamDispatch, useThreadManagement, } from "./providers/tambo-v1-stream-context";
+// Re-export registry provider from beta SDK (works with v1)
+export { TamboRegistryProvider } from "../providers/tambo-registry-provider";
+// Re-export context helpers from beta SDK (works with v1)
+export { TamboContextHelpersProvider, useTamboContextHelpers, } from "../providers/tambo-context-helpers-provider";
+// =============================================================================
+// Hooks
+// =============================================================================
+export { useTamboV1 } from "./hooks/use-tambo-v1";
+export { useTamboV1ThreadInput, } from "./hooks/use-tambo-v1-thread-input";
+export { useTamboV1Thread } from "./hooks/use-tambo-v1-thread";
+export { useTamboV1ThreadList } from "./hooks/use-tambo-v1-thread-list";
+export { useTamboV1ComponentState, } from "./hooks/use-tambo-v1-component-state";
+// Re-export client hook from beta SDK (works with v1)
+export { useTamboClient } from "../providers/tambo-client-provider";
+// Re-export registry hook from beta SDK (works with v1)
+export { useTamboRegistry } from "../providers/tambo-registry-provider";
+// =============================================================================
+// Component Rendering
+// =============================================================================
+export { useV1ComponentContent, useV1ComponentContentOptional, renderComponentContent, renderMessageContent, renderMessageComponents, isComponentContent, } from "./utils/component-renderer";
+// =============================================================================
+// Utilities
+// =============================================================================
+export { applyJsonPatch } from "./utils/json-patch";
+export { toAvailableComponent, toAvailableComponents, toAvailableTool, toAvailableTools, } from "./utils/registry-conversion";
+export { executeClientTool, executeAllPendingTools, } from "./utils/tool-executor";
+export { ToolCallTracker } from "./utils/tool-call-tracker";
+export { handleEventStream } from "./utils/stream-handler";
+// =============================================================================
+// Re-exports from Beta SDK (compatible with v1)
+// =============================================================================
+// Tool definition helper
+export { defineTool } from "../util/registry";
+// Built-in context helpers
+export { currentPageContextHelper, currentTimeContextHelper, } from "../context-helpers";
+// MCP server types
+export { MCPTransport } from "../model/mcp-server-info";
 //# sourceMappingURL=index.js.map

package/esm/v1/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;AAEH,yCAAyC;AACzC,mEAAmE;AACnE,oGAAoG;AAEpG,qCAAqC;AACrC,qDAAqD;AACrD,kEAAkE;AAClE,sEAAsE;AACtE,6EAA6E;AAC7E,mFAAmF;AAEnF,2CAA2C;AAC3C,uDAAuD","sourcesContent":["/**\n * @tambo-ai/react/v1 - React SDK for Tambo v1 API\n *\n * Provides React hooks and providers for building AI-powered applications\n * using the v1 streaming API with AG-UI protocol.\n *\n * Types are not re-exported. Import directly from specific type files:\n * - Custom events: import from '@tambo-ai/react/v1/types/event'\n * - Thread state: import from '@tambo-ai/react/v1/types/thread'\n * - Messages: import from '@tambo-ai/react/v1/types/message'\n * - Components: import from '@tambo-ai/react/v1/types/component'\n * - Tools: import from '@tambo-ai/react/v1/types/tool'\n *\n * SDK types: import directly from @tambo-ai/typescript-sdk\n * AG-UI events: import directly from @ag-ui/core\n * @example\n * ```typescript\n * import { TamboV1Provider, useTamboV1 } from '@tambo-ai/react/v1';\n *\n * function App() {\n *   return (\n *     <TamboV1Provider apiKey=\"your-api-key\">\n *       <ChatInterface />\n *     </TamboV1Provider>\n *   );\n * }\n *\n * function ChatInterface() {\n *   const { thread, sendMessage, isStreaming } = useTamboV1();\n *   // ... implementation\n * }\n * ```\n */\n\n// Providers (TODO: implement in Phase 7)\n// export { TamboV1Provider } from './providers/tambo-v1-provider';\n// export { TamboRegistryProvider } from '../providers/tambo-registry-provider'; // Reused from beta\n\n// Hooks (TODO: implement in Phase 7)\n// export { useTamboV1 } from './hooks/use-tambo-v1';\n// export { useTamboV1Thread } from './hooks/use-tambo-v1-thread';\n// export { useTamboV1Messages } from './hooks/use-tambo-v1-messages';\n// export { useTamboV1SendMessage } from './hooks/use-tambo-v1-send-message';\n// export { useTamboV1ComponentState } from './hooks/use-tambo-v1-component-state';\n\n// Utilities (TODO: implement in Phase 2-3)\n// export { applyJsonPatch } from './utils/json-patch';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAEH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,OAAO,EACL,eAAe,EACf,aAAa,GAEd,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GAEpB,MAAM,qCAAqC,CAAC;AAE7C,4DAA4D;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,0DAA0D;AAC1D,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,6CAA6C,CAAC;AAErD,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,OAAO,EAAE,UAAU,EAAyB,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EACL,qBAAqB,GAGtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,EACL,wBAAwB,GAEzB,MAAM,sCAAsC,CAAC;AAE9C,sDAAsD;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,wDAAwD;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAExE,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,OAAO,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,GAGnB,MAAM,4BAA4B,CAAC;AAEpC,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,iBAAiB,EACjB,sBAAsB,GAEvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,gFAAgF;AAChF,gDAAgD;AAChD,gFAAgF;AAEhF,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,2BAA2B;AAC3B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAmB5B,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["/**\n * `@tambo-ai/react/v1` - React SDK for Tambo v1 API\n *\n * Provides React hooks and providers for building AI-powered applications\n * using the v1 streaming API with AG-UI protocol.\n *\n * ## Quick Start\n *\n * ```tsx\n * import {\n *   TamboV1Provider,\n *   useTamboV1,\n *   useTamboV1ThreadInput,\n * } from '@tambo-ai/react/v1';\n *\n * function App() {\n *   return (\n *     <TamboV1Provider\n *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}\n *       components={[WeatherCard]}\n *       tools={[searchTool]}\n *     >\n *       <ChatInterface />\n *     </TamboV1Provider>\n *   );\n * }\n *\n * function ChatInterface() {\n *   const [threadId, setThreadId] = useState<string>();\n *   const { messages, isStreaming } = useTamboV1(threadId);\n *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput(threadId);\n *\n *   const handleSubmit = async (e: React.FormEvent) => {\n *     e.preventDefault();\n *     const result = await submit();\n *     if (!threadId) setThreadId(result.threadId);\n *   };\n *\n *   return (\n *     <form onSubmit={handleSubmit}>\n *       {messages.map(msg => <Message key={msg.id} message={msg} />)}\n *       {isStreaming && <LoadingIndicator />}\n *       <input value={value} onChange={(e) => setValue(e.target.value)} />\n *       <button disabled={isPending}>Send</button>\n *     </form>\n *   );\n * }\n * ```\n *\n * ## Type Imports\n *\n * Types are imported directly from specific files:\n * - Thread state: `import type { TamboV1Thread } from '@tambo-ai/react/v1/types/thread'`\n * - Messages: `import type { TamboV1Message } from '@tambo-ai/react/v1/types/message'`\n * - Custom events: `import type { ComponentStartEvent } from '@tambo-ai/react/v1/types/event'`\n *\n * SDK types: `import type { ... } from '@tambo-ai/typescript-sdk'`\n * AG-UI events: `import { EventType, type BaseEvent } from '@ag-ui/core'`\n */\n\n// =============================================================================\n// Providers\n// =============================================================================\n\nexport {\n  TamboV1Provider,\n  useContextKey,\n  type TamboV1ProviderProps,\n} from \"./providers/tambo-v1-provider\";\n\nexport {\n  TamboV1StreamProvider,\n  useStreamState,\n  useStreamDispatch,\n  useThreadManagement,\n  type ThreadManagement,\n} from \"./providers/tambo-v1-stream-context\";\n\n// Re-export registry provider from beta SDK (works with v1)\nexport { TamboRegistryProvider } from \"../providers/tambo-registry-provider\";\n\n// Re-export context helpers from beta SDK (works with v1)\nexport {\n  TamboContextHelpersProvider,\n  useTamboContextHelpers,\n} from \"../providers/tambo-context-helpers-provider\";\n\n// =============================================================================\n// Hooks\n// =============================================================================\n\nexport { useTamboV1, type UseTamboV1Return } from \"./hooks/use-tambo-v1\";\n\nexport {\n  useTamboV1ThreadInput,\n  type UseTamboV1ThreadInputReturn,\n  type SubmitOptions,\n} from \"./hooks/use-tambo-v1-thread-input\";\n\nexport { useTamboV1Thread } from \"./hooks/use-tambo-v1-thread\";\n\nexport { useTamboV1ThreadList } from \"./hooks/use-tambo-v1-thread-list\";\n\nexport {\n  useTamboV1ComponentState,\n  type UseTamboV1ComponentStateReturn,\n} from \"./hooks/use-tambo-v1-component-state\";\n\n// Re-export client hook from beta SDK (works with v1)\nexport { useTamboClient } from \"../providers/tambo-client-provider\";\n\n// Re-export registry hook from beta SDK (works with v1)\nexport { useTamboRegistry } from \"../providers/tambo-registry-provider\";\n\n// =============================================================================\n// Component Rendering\n// =============================================================================\n\nexport {\n  useV1ComponentContent,\n  useV1ComponentContentOptional,\n  renderComponentContent,\n  renderMessageContent,\n  renderMessageComponents,\n  isComponentContent,\n  type V1ComponentContentContext,\n  type RenderComponentOptions,\n} from \"./utils/component-renderer\";\n\n// =============================================================================\n// Utilities\n// =============================================================================\n\nexport { applyJsonPatch } from \"./utils/json-patch\";\n\nexport {\n  toAvailableComponent,\n  toAvailableComponents,\n  toAvailableTool,\n  toAvailableTools,\n} from \"./utils/registry-conversion\";\n\nexport {\n  executeClientTool,\n  executeAllPendingTools,\n  type PendingToolCall,\n} from \"./utils/tool-executor\";\n\nexport { ToolCallTracker } from \"./utils/tool-call-tracker\";\n\nexport { handleEventStream } from \"./utils/stream-handler\";\n\n// =============================================================================\n// Re-exports from Beta SDK (compatible with v1)\n// =============================================================================\n\n// Tool definition helper\nexport { defineTool } from \"../util/registry\";\n\n// Built-in context helpers\nexport {\n  currentPageContextHelper,\n  currentTimeContextHelper,\n} from \"../context-helpers\";\n\n// Context helper types\nexport type {\n  AdditionalContext,\n  ContextHelperFn,\n  ContextHelpers,\n} from \"../context-helpers\";\n\n// Component and tool types\nexport type {\n  ComponentContextToolMetadata,\n  ComponentRegistry,\n  ParameterSpec,\n  RegisteredComponent,\n  TamboTool,\n  ToolAnnotations,\n} from \"../model/component-metadata\";\n\n// MCP server types\nexport { MCPTransport } from \"../model/mcp-server-info\";\nexport type {\n  McpServerInfo,\n  NormalizedMcpServerInfo,\n} from \"../model/mcp-server-info\";\n\n// Resource types\nexport type {\n  ListResourceItem,\n  ReadResourceResult,\n  ResourceSource,\n} from \"../model/resource-info\";\n"]}

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

@@ -0,0 +1,133 @@
+/**
+ * TamboV1Provider - Main Provider for v1 API
+ *
+ * Composes the necessary providers for the v1 SDK:
+ * - TamboClientProvider: API client and authentication
+ * - TamboRegistryProvider: Component and tool registration
+ * - TamboContextHelpersProvider: Context helper functions
+ * - TamboV1StreamProvider: Streaming state management
+ *
+ * This provider should wrap your entire application or the portion
+ * that needs access to Tambo v1 functionality.
+ */
+import React, { type PropsWithChildren } from "react";
+import { QueryClient } from "@tanstack/react-query";
+import { type TamboClientProviderProps } from "../../providers/tambo-client-provider";
+import { type TamboRegistryProviderProps } from "../../providers/tambo-registry-provider";
+import type { ContextHelpers } from "../../context-helpers";
+import type { McpServerInfo } from "../../model/mcp-server-info";
+import type { ListResourceItem, ResourceSource } from "../../model/resource-info";
+/**
+ * Hook to access the contextKey from TamboV1Provider.
+ * @returns The contextKey if provided, undefined otherwise
+ */
+export declare function useContextKey(): string | undefined;
+/**
+ * Props for TamboV1Provider
+ */
+export interface TamboV1ProviderProps extends Pick<TamboClientProviderProps, "apiKey" | "tamboUrl" | "environment" | "userToken"> {
+    /**
+     * Components to register with the registry.
+     * These will be available for the AI to use in responses.
+     */
+    components?: TamboRegistryProviderProps["components"];
+    /**
+     * Tools to register with the registry.
+     * These will be executed client-side when requested by the AI.
+     */
+    tools?: TamboRegistryProviderProps["tools"];
+    /**
+     * MCP servers to register with the registry.
+     * These provide additional tools and resources from MCP-compatible servers.
+     */
+    mcpServers?: (McpServerInfo | string)[];
+    /**
+     * Callback function called when an unregistered tool is called.
+     * If not provided, an error will be thrown for unknown tools.
+     */
+    onCallUnregisteredTool?: TamboRegistryProviderProps["onCallUnregisteredTool"];
+    /**
+     * Static resources to register with the registry.
+     * These will be available for the AI to access.
+     */
+    resources?: ListResourceItem[];
+    /**
+     * Dynamic resource search function.
+     * Must be paired with getResource.
+     * Called when searching for resources dynamically.
+     */
+    listResources?: ResourceSource["listResources"];
+    /**
+     * Dynamic resource fetch function.
+     * Must be paired with listResources.
+     * Called when fetching a specific resource by URI.
+     */
+    getResource?: ResourceSource["getResource"];
+    /**
+     * Configuration for context helpers.
+     * A dictionary of functions that provide additional context to the AI.
+     * Each key becomes the context name, and the function returns the value.
+     */
+    contextHelpers?: ContextHelpers;
+    /**
+     * Optional context key for thread scoping/isolation.
+     * Threads created with the same contextKey are grouped together.
+     * Useful for multi-tenant applications or separating conversation contexts.
+     */
+    contextKey?: string;
+    /**
+     * Optional custom QueryClient instance.
+     * If not provided, a default client will be created.
+     */
+    queryClient?: QueryClient;
+    /**
+     * Children components
+     */
+    children: React.ReactNode;
+}
+/**
+ * Main provider for the Tambo v1 SDK.
+ *
+ * Composes TamboClientProvider, TamboRegistryProvider, and TamboV1StreamProvider
+ * to provide a complete context for building AI-powered applications.
+ *
+ * Threads are managed dynamically through useTamboV1() hook functions:
+ * - startNewThread() - Begin a new conversation
+ * - switchThread(threadId) - Switch to an existing thread
+ * - initThread(threadId) - Initialize a thread for receiving events
+ * @param props - Provider configuration
+ * @param props.apiKey - Tambo API key for authentication
+ * @param props.tamboUrl - Optional custom Tambo API URL
+ * @param props.environment - Optional environment configuration
+ * @param props.userToken - Optional OAuth token for user authentication
+ * @param props.components - Components to register with the AI
+ * @param props.tools - Tools to register for client-side execution
+ * @param props.mcpServers - MCP servers to register for additional tools/resources
+ * @param props.onCallUnregisteredTool - Callback for handling unknown tool calls
+ * @param props.resources - Static resources to register with the AI
+ * @param props.listResources - Dynamic resource search function (must be paired with getResource)
+ * @param props.getResource - Dynamic resource fetch function (must be paired with listResources)
+ * @param props.contextHelpers - Configuration for context helper functions
+ * @param props.contextKey - Optional context key for thread scoping/isolation
+ * @param props.queryClient - Optional custom React Query client
+ * @param props.children - Child components
+ * @returns Provider component tree
+ * @example
+ * ```tsx
+ * import { TamboV1Provider } from '@tambo-ai/react/v1';
+ *
+ * function App() {
+ *   return (
+ *     <TamboV1Provider
+ *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}
+ *       components={[WeatherCard, StockChart]}
+ *       tools={[searchTool, calculatorTool]}
+ *     >
+ *       <ChatInterface />
+ *     </TamboV1Provider>
+ *   );
+ * }
+ * ```
+ */
+export declare function TamboV1Provider({ apiKey, tamboUrl, environment, userToken, components, tools, mcpServers, onCallUnregisteredTool, resources, listResources, getResource, contextHelpers, contextKey, queryClient, children, }: PropsWithChildren<TamboV1ProviderProps>): React.JSX.Element;
+//# sourceMappingURL=tambo-v1-provider.d.ts.map

package/esm/v1/providers/tambo-v1-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-v1-provider.d.ts","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-provider.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,EAGZ,KAAK,iBAAiB,EAEvB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACf,MAAM,2BAA2B,CAAC;AAQnC;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAElD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAChD,wBAAwB,EACxB,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,CACpD;IACC;;;OAGG;IACH,UAAU,CAAC,EAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC;IAEtD;;;OAGG;IACH,KAAK,CAAC,EAAE,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAE5C;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC;IAExC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,0BAA0B,CAAC,wBAAwB,CAAC,CAAC;IAE9E;;;OAGG;IACH,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAE/B;;;;OAIG;IACH,aAAa,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;IAEhD;;;;OAIG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IAE5C;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,QAAQ,EACR,WAAW,EACX,SAAS,EACT,UAAU,EACV,KAAK,EACL,UAAU,EACV,sBAAsB,EACtB,SAAS,EACT,aAAa,EACb,WAAW,EACX,cAAc,EACd,UAAU,EACV,WAAW,EACX,QAAQ,GACT,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,qBA2CzC"}