@gntik-ai/chat 0.5.0 → 0.9.0

package/dist/index.d.ts

@@ -1,6 +1,84 @@
 
-import { ComponentDoc } from "@gntik-ai/ui";
 import { ComponentType, ReactNode, Ref } from "react";
+import { ComponentDoc } from "@gntik-ai/ui";
+//#region src/AgentSurface/catalog.d.ts
+/** Trusted host code: render explicit properties; never spread the agent's input. */
+interface AgentCatalogRenderProps {
+  props: Readonly<Record<string, unknown>>;
+  children?: ReactNode;
+  onValueChange: (value: unknown) => void;
+  onAction: () => void;
+}
+interface AgentCatalogEntry {
+  component: ComponentType<AgentCatalogRenderProps>;
+  /** Return a fresh object of known properties, or null when invalid. */
+  validate: (props: Readonly<Record<string, unknown>>) => Record<string, unknown> | null;
+}
+type AgentCatalog = Readonly<Record<string, AgentCatalogEntry>>;
+export declare function defineAgentCatalog(entries: AgentCatalog): AgentCatalog;
+/** Small text/form catalog. Password, payment and file controls are deliberately absent. */
+export declare const defaultAgentCatalog: Readonly<Record<string, AgentCatalogEntry>>;
+//#endregion
+//#region src/AgentSurface/protocol.d.ts
+/** Supported command envelope. No v0.8 adaptation is performed. */
+export declare const A2UI_VERSION: "v0.9";
+interface AgentComponent {
+  id: string;
+  component: string;
+  children?: string[];
+  /** Catalog properties are flat, alongside id/component/children. */
+  [property: string]: unknown;
+}
+interface AgentAction {
+  name: string;
+  surfaceId: string;
+  context: Record<string, unknown>;
+}
+interface AgentSurfaceError {
+  code: 'version' | 'message' | 'component' | 'props' | 'graph' | 'binding';
+  surfaceId: string;
+  componentId?: string;
+  type?: string;
+}
+type Envelope<T> = {
+  version: typeof A2UI_VERSION;
+} & T;
+type A2uiMessage = Envelope<{
+  createSurface: {
+    surfaceId: string;
+    catalogId?: string;
+  };
+}> | Envelope<{
+  updateComponents: {
+    surfaceId: string;
+    components: AgentComponent[];
+  };
+}> | Envelope<{
+  updateDataModel: {
+    surfaceId: string;
+    path?: string;
+    value: unknown;
+  };
+}> | Envelope<{
+  deleteSurface: {
+    surfaceId: string;
+  };
+}>;
+//#endregion
+//#region src/AgentSurface/AgentSurface.d.ts
+interface AgentSurfaceProps {
+  /** Immutable command log: append messages to update the rendered surfaces. */
+  messages: A2uiMessage[];
+  /** Trusted allow-list, created by the host rather than the agent. */
+  catalog: AgentCatalog;
+  onAction?: (action: AgentAction) => void;
+  onError?: (error: AgentSurfaceError) => void;
+}
+export declare function AgentSurface({ messages, catalog, onError, onAction }: AgentSurfaceProps): import("react").JSX.Element;
+//#endregion
+//#region src/AgentSurface/AgentSurface.doc.d.ts
+declare const doc: ComponentDoc;
+//#endregion
 //#region src/Attachment/AttachmentChip.d.ts
 /** A file attached to a message or waiting in the composer. */
 interface ChatAttachment {
@@ -107,7 +185,7 @@ export declare const attachmentStyles: {
 };
 //#endregion
 //#region src/Attachment/Attachment.doc.d.ts
-declare const doc: ComponentDoc;
+declare const doc$1: ComponentDoc;
 //#endregion
 //#region src/ChatComposer/ChatComposer.d.ts
 /** A file in the composer: name and size, plus optional type, preview, progress and error. */
@@ -187,7 +265,7 @@ export declare const chatComposerStyles: {
 };
 //#endregion
 //#region src/ChatComposer/ChatComposer.doc.d.ts
-declare const doc$1: ComponentDoc;
+declare const doc$2: ComponentDoc;
 //#endregion
 //#region src/ChatDemo/ChatDemo.d.ts
 interface ChatDemoProps {
@@ -205,7 +283,7 @@ interface ChatDemoProps {
 export declare function ChatDemo({ withPanel, tickMs, className }: ChatDemoProps): import("react").JSX.Element;
 //#endregion
 //#region src/ChatDemo/ChatDemo.doc.d.ts
-declare const doc$2: ComponentDoc;
+declare const doc$3: ComponentDoc;
 //#endregion
 //#region src/ChatLayout/ChatLayout.d.ts
 interface ChatLayoutProps {
@@ -259,7 +337,7 @@ export declare const chatLayoutStyles: {
 };
 //#endregion
 //#region src/ChatLayout/ChatLayout.doc.d.ts
-declare const doc$3: ComponentDoc;
+declare const doc$4: ComponentDoc;
 //#endregion
 //#region src/ChatMessage/ChatMessage.d.ts
 /**
@@ -379,7 +457,7 @@ export declare const chatMessageStyles: {
 };
 //#endregion
 //#region src/ChatMessage/ChatMessage.doc.d.ts
-declare const doc$4: ComponentDoc;
+declare const doc$5: ComponentDoc;
 //#endregion
 //#region src/Citation/Citation.d.ts
 interface CitationSource {
@@ -437,7 +515,7 @@ export declare const citationStyles: {
 };
 //#endregion
 //#region src/Citation/Citation.doc.d.ts
-declare const doc$5: ComponentDoc;
+declare const doc$6: ComponentDoc;
 //#endregion
 //#region src/Markdown/Markdown.d.ts
 interface MarkdownProps {
@@ -512,7 +590,7 @@ export declare const markdownStyles: {
 };
 //#endregion
 //#region src/Markdown/Markdown.doc.d.ts
-declare const doc$6: ComponentDoc;
+declare const doc$7: ComponentDoc;
 //#endregion
 //#region src/MessageFeedback/MessageFeedback.d.ts
 type FeedbackRating = 'up' | 'down';
@@ -571,7 +649,7 @@ export declare const messageFeedbackStyles: {
 };
 //#endregion
 //#region src/MessageFeedback/MessageFeedback.doc.d.ts
-declare const doc$7: ComponentDoc;
+declare const doc$8: ComponentDoc;
 //#endregion
 //#region src/ModelPicker/ModelPicker.d.ts
 type ModelCapability = 'vision' | 'tools' | 'reasoning' | 'files' | 'web' | 'audio';
@@ -640,7 +718,7 @@ export declare const modelPickerStyles: {
 export declare const DEMO_MODELS: ChatModel[];
 //#endregion
 //#region src/ModelPicker/ModelPicker.doc.d.ts
-declare const doc$8: ComponentDoc;
+declare const doc$9: ComponentDoc;
 //#endregion
 //#region src/SuggestionChips/SuggestionChips.d.ts
 type IconComponent = ComponentType<{
@@ -689,7 +767,7 @@ export declare const suggestionChipsStyles: {
 };
 //#endregion
 //#region src/SuggestionChips/SuggestionChips.doc.d.ts
-declare const doc$9: ComponentDoc;
+declare const doc$10: ComponentDoc;
 //#endregion
 //#region src/ToolCallCard/ToolCallCard.d.ts
 type ToolCallStatus = 'running' | 'succeeded' | 'failed';
@@ -752,7 +830,7 @@ export declare const toolCallCardStyles: {
 };
 //#endregion
 //#region src/ToolCallCard/ToolCallCard.doc.d.ts
-declare const doc$10: ComponentDoc;
+declare const doc$11: ComponentDoc;
 //#endregion
 //#region src/TypingIndicator/TypingIndicator.d.ts
 interface TypingIndicatorProps {
@@ -800,7 +878,7 @@ export declare const typingIndicatorStyles: {
 export declare const streamingCaret = "ms-0.5 inline-block h-[1.05em] w-[2px] translate-y-[2px] bg-primary animate-pulse motion-reduce:animate-none";
 //#endregion
 //#region src/TypingIndicator/TypingIndicator.doc.d.ts
-declare const doc$11: ComponentDoc;
+declare const doc$12: ComponentDoc;
 //#endregion
 //#region src/useChatScroll/useChatScroll.d.ts
 interface UseChatScrollOptions {
@@ -825,5 +903,5 @@ interface UseChatScrollResult {
  */
 export declare function useChatScroll({ threshold }?: UseChatScrollOptions): UseChatScrollResult;
 //#endregion
-export { type AttachmentChipProps, type AttachmentListProps, type AttachmentRejection, type AttachmentRejectionReason, type AttachmentStatus, type ChatAnnouncerProps, type ChatAttachment, type ChatComposerProps, type ChatDemoProps, type ChatFeedback, type ChatLayoutProps, type ChatMessageProps, type ChatModel, type ChatRole, type CitationListProps, type CitationProps, type CitationSource, type CodeBlockProps, type ComposerAttachment, type FeedbackRating, type FeedbackReason, type FeedbackValue, type JsonViewProps, type MarkdownProps, type MessageFeedbackProps, type ModelCapability, type ModelPickerProps, type Suggestion, type SuggestionChipsProps, type ToolCallCardProps, type ToolCallStatus, type TypingIndicatorProps, type UseChatScrollOptions, type UseChatScrollResult, type ValidateFilesOptions, doc as attachmentListDoc, doc$1 as chatComposerDoc, doc$2 as chatDemoDoc, doc$3 as chatLayoutDoc, doc$4 as chatMessageDoc, doc$5 as citationDoc, doc$6 as markdownDoc, doc$7 as messageFeedbackDoc, doc$8 as modelPickerDoc, doc$9 as suggestionChipsDoc, doc$10 as toolCallCardDoc, doc$11 as typingIndicatorDoc };
+export { type A2uiMessage, type AgentAction, type AgentCatalog, type AgentCatalogEntry, type AgentCatalogRenderProps, type AgentComponent, type AgentSurfaceError, type AgentSurfaceProps, type AttachmentChipProps, type AttachmentListProps, type AttachmentRejection, type AttachmentRejectionReason, type AttachmentStatus, type ChatAnnouncerProps, type ChatAttachment, type ChatComposerProps, type ChatDemoProps, type ChatFeedback, type ChatLayoutProps, type ChatMessageProps, type ChatModel, type ChatRole, type CitationListProps, type CitationProps, type CitationSource, type CodeBlockProps, type ComposerAttachment, type FeedbackRating, type FeedbackReason, type FeedbackValue, type JsonViewProps, type MarkdownProps, type MessageFeedbackProps, type ModelCapability, type ModelPickerProps, type Suggestion, type SuggestionChipsProps, type ToolCallCardProps, type ToolCallStatus, type TypingIndicatorProps, type UseChatScrollOptions, type UseChatScrollResult, type ValidateFilesOptions, doc as agentSurfaceDoc, doc$1 as attachmentListDoc, doc$2 as chatComposerDoc, doc$3 as chatDemoDoc, doc$4 as chatLayoutDoc, doc$5 as chatMessageDoc, doc$6 as citationDoc, doc$7 as markdownDoc, doc$8 as messageFeedbackDoc, doc$9 as modelPickerDoc, doc$10 as suggestionChipsDoc, doc$11 as toolCallCardDoc, doc$12 as typingIndicatorDoc };
 //# sourceMappingURL=index.d.ts.map