@alquimia-ai/ui 2.0.0 → 2.2.2

package/dist/components/genui/index.d.mts

@@ -0,0 +1,79 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import { A2uiComponent, SurfaceAction, A2uiSurface, UIAction } from '@alquimia-ai/tools/genui';
+
+/** Props every A2UI component receives from the renderer. */
+interface A2uiNodeProps {
+    node: A2uiComponent;
+    value?: unknown;
+    onChange?: (value: unknown) => void;
+    onAction?: (action: SurfaceAction) => void;
+    children?: React.ReactNode;
+}
+/** The default catalog registry: catalog component name -> React component. */
+declare const coreUiRegistry: Record<string, React.ComponentType<A2uiNodeProps>>;
+
+interface A2uiRendererProps {
+    surface: A2uiSurface;
+    registry: Record<string, React.ComponentType<A2uiNodeProps>>;
+    onAgentAction: (action: UIAction) => void;
+    onLocalAction?: (action: UIAction) => void;
+}
+declare function A2uiRenderer({ surface, registry, onAgentAction, onLocalAction }: A2uiRendererProps): react_jsx_runtime.JSX.Element | null;
+
+type ChatMessage = {
+    id?: string;
+    role?: string;
+    content?: string;
+};
+/** The subset of the `useAlquimia` return that AssistantChat consumes. */
+interface GenuiChatController {
+    messages: ChatMessage[];
+    input: string;
+    handleInputChange: (event: React.ChangeEvent<HTMLTextAreaElement>) => void;
+    handleSubmit: (event: React.FormEvent<HTMLFormElement>, traceParentId?: string, sessionId?: string) => Promise<void> | void;
+    handleLoadingCancel?: () => void;
+    isLoading?: boolean;
+    isMessageStreaming?: boolean;
+    streamingMessageId?: string | null;
+    genui?: {
+        surfaces: Array<{
+            controlId: string;
+            surface: A2uiSurface;
+            afterCount: number;
+            submitted?: boolean;
+            dismissedWith?: string;
+        }>;
+        onAgentAction: (controlId: string) => (action: UIAction) => void;
+        awaitingUser: boolean;
+        dismiss?: (userMessage?: string) => void;
+    };
+}
+interface AssistantChatProps {
+    /** The value returned by `useAlquimia({ genui: {...} })`. */
+    alquimia: GenuiChatController;
+    /** Catalog component name -> React component. Defaults to the built-in catalog; pass your own to swap component libraries. */
+    registry?: Record<string, React.ComponentType<A2uiNodeProps>>;
+    /** Conversation id passed to `handleSubmit`. Optional if the SDK already has one. */
+    conversationId?: string | null;
+    placeholder?: string;
+    suggestions?: string[];
+    className?: string;
+    /** Override the typing indicator shown while the agent is working. Defaults to animated dots. */
+    thinkIndicator?: React.ReactNode;
+}
+/**
+ * Batteries-included GenUI chat. A thin composition of the SDK's existing organisms
+ * (`AssistantMessageArea` + `AssistantInput`) — it does NOT reimplement message
+ * rendering, so it inherits markdown, error rendering, timestamps, and streaming for
+ * free. Its only job is to (a) turn `genui.surfaces` into an `interleave` callback the
+ * message area renders in place, and (b) gate the typing indicator while a surface
+ * awaits the user. All orchestration lives in `useAlquimia({ genui })`.
+ *
+ * To use a different component library, swap `registry` (and pass your own catalog to
+ * the hook). To customize the shell, compose the organisms directly instead of using
+ * this wrapper.
+ */
+declare function AssistantChat({ alquimia, registry, conversationId, placeholder, suggestions, className, thinkIndicator, }: AssistantChatProps): react_jsx_runtime.JSX.Element;
+
+export { type A2uiNodeProps, A2uiRenderer, type A2uiRendererProps, AssistantChat, type AssistantChatProps, type GenuiChatController, coreUiRegistry };

package/dist/components/genui/index.d.ts

@@ -0,0 +1,79 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import { A2uiComponent, SurfaceAction, A2uiSurface, UIAction } from '@alquimia-ai/tools/genui';
+
+/** Props every A2UI component receives from the renderer. */
+interface A2uiNodeProps {
+    node: A2uiComponent;
+    value?: unknown;
+    onChange?: (value: unknown) => void;
+    onAction?: (action: SurfaceAction) => void;
+    children?: React.ReactNode;
+}
+/** The default catalog registry: catalog component name -> React component. */
+declare const coreUiRegistry: Record<string, React.ComponentType<A2uiNodeProps>>;
+
+interface A2uiRendererProps {
+    surface: A2uiSurface;
+    registry: Record<string, React.ComponentType<A2uiNodeProps>>;
+    onAgentAction: (action: UIAction) => void;
+    onLocalAction?: (action: UIAction) => void;
+}
+declare function A2uiRenderer({ surface, registry, onAgentAction, onLocalAction }: A2uiRendererProps): react_jsx_runtime.JSX.Element | null;
+
+type ChatMessage = {
+    id?: string;
+    role?: string;
+    content?: string;
+};
+/** The subset of the `useAlquimia` return that AssistantChat consumes. */
+interface GenuiChatController {
+    messages: ChatMessage[];
+    input: string;
+    handleInputChange: (event: React.ChangeEvent<HTMLTextAreaElement>) => void;
+    handleSubmit: (event: React.FormEvent<HTMLFormElement>, traceParentId?: string, sessionId?: string) => Promise<void> | void;
+    handleLoadingCancel?: () => void;
+    isLoading?: boolean;
+    isMessageStreaming?: boolean;
+    streamingMessageId?: string | null;
+    genui?: {
+        surfaces: Array<{
+            controlId: string;
+            surface: A2uiSurface;
+            afterCount: number;
+            submitted?: boolean;
+            dismissedWith?: string;
+        }>;
+        onAgentAction: (controlId: string) => (action: UIAction) => void;
+        awaitingUser: boolean;
+        dismiss?: (userMessage?: string) => void;
+    };
+}
+interface AssistantChatProps {
+    /** The value returned by `useAlquimia({ genui: {...} })`. */
+    alquimia: GenuiChatController;
+    /** Catalog component name -> React component. Defaults to the built-in catalog; pass your own to swap component libraries. */
+    registry?: Record<string, React.ComponentType<A2uiNodeProps>>;
+    /** Conversation id passed to `handleSubmit`. Optional if the SDK already has one. */
+    conversationId?: string | null;
+    placeholder?: string;
+    suggestions?: string[];
+    className?: string;
+    /** Override the typing indicator shown while the agent is working. Defaults to animated dots. */
+    thinkIndicator?: React.ReactNode;
+}
+/**
+ * Batteries-included GenUI chat. A thin composition of the SDK's existing organisms
+ * (`AssistantMessageArea` + `AssistantInput`) — it does NOT reimplement message
+ * rendering, so it inherits markdown, error rendering, timestamps, and streaming for
+ * free. Its only job is to (a) turn `genui.surfaces` into an `interleave` callback the
+ * message area renders in place, and (b) gate the typing indicator while a surface
+ * awaits the user. All orchestration lives in `useAlquimia({ genui })`.
+ *
+ * To use a different component library, swap `registry` (and pass your own catalog to
+ * the hook). To customize the shell, compose the organisms directly instead of using
+ * this wrapper.
+ */
+declare function AssistantChat({ alquimia, registry, conversationId, placeholder, suggestions, className, thinkIndicator, }: AssistantChatProps): react_jsx_runtime.JSX.Element;
+
+export { type A2uiNodeProps, A2uiRenderer, type A2uiRendererProps, AssistantChat, type AssistantChatProps, type GenuiChatController, coreUiRegistry };