@personai/agent-ui-chat-react 0.0.0-stage → 1.0.0-preview.2

package/dist/src/ChatA2UI.d.ts

@@ -0,0 +1,7 @@
+import { ChatA2uiActionHandler, ChatA2uiSession, ChatMessage } from '@personai/agent-ui-chat-core';
+export declare function ChatA2UI({ message, onAction, runtime, disabled }: {
+    message: ChatMessage;
+    onAction?: ChatA2uiActionHandler;
+    runtime?: ChatA2uiSession;
+    disabled?: boolean;
+}): import("react").JSX.Element;

package/dist/src/ChatGoalIndicator.d.ts

@@ -0,0 +1,20 @@
+/** Display data and actions are supplied by the host; no goal backend is assumed. */
+export interface ChatGoalIndicatorProps {
+    objective: string;
+    status: string;
+    label: string;
+    progress?: string;
+    busy?: boolean;
+    onPause?: () => void;
+    resumeDisabled?: boolean;
+    onResume?: () => void;
+    onRestart?: () => void;
+    onDelete?: () => void;
+    labels: {
+        pause: string;
+        resume: string;
+        restart: string;
+        delete: string;
+    };
+}
+export declare function ChatGoalIndicator({ objective, status, label, progress, busy, resumeDisabled, onPause, onResume, onRestart, onDelete, labels }: ChatGoalIndicatorProps): import("react").JSX.Element;

package/dist/src/ChatHistoryRail.d.ts

@@ -0,0 +1,9 @@
+import { TranscriptPresentation, ChatMessage } from '@personai/agent-ui-chat-core';
+import { RefObject } from 'react';
+interface ChatHistoryRailProps {
+    messages: ChatMessage[];
+    transcriptRef: RefObject<HTMLElement | null>;
+    presentation: TranscriptPresentation;
+}
+export declare function ChatHistoryRail({ messages, transcriptRef, presentation, }: ChatHistoryRailProps): import("react").JSX.Element | null;
+export {};

package/dist/src/ChatPanel.d.ts

@@ -0,0 +1,100 @@
+import { ChatGoalIndicatorProps } from './ChatGoalIndicator';
+import { ChatAnnotationLabels, ChatAnnotation, ChatA2uiActionHandler as ActionHandler, ChatA2uiSession, ChatHistoryLabels, ChatInputSuggestion, ChatInputSuggestionLabels, ChatAguiStreamEvent, ChatAttachmentLabels, ChatDebugOptions, ChatMessage, ChatMessageAttachment, ChatQueuedSubmission, ChatRunningSubmitMode, ChatSession, ChatUserInputAnswer, ChatUserInputLabels, ChatUserInputRequest, ChatWorkRailLabels, ChatSubmitMode } from '@personai/agent-ui-chat-core';
+import { ComposerReactProps } from '@personai/agent-ui-composer-react';
+import { Ref, ReactNode } from 'react';
+export interface ChatMarkdownLinkProps {
+    children?: ReactNode;
+    href?: string;
+}
+export type ChatMarkdownLinkRenderer = (props: ChatMarkdownLinkProps) => ReactNode;
+export interface ChatPanelProps extends Pick<ComposerReactProps, "renderAttachmentControl" | "pendingAttachments" | "showAttachmentControl" | "attachmentUploadPending" | "onAttachFile" | "onRemoveAttachment" | "attachLabel" | "uploadingLabel" | "removeAttachmentLabel" | "editQueuedLabel" | "removeQueuedLabel" | "reorderQueuedLabel" | "steerQueuedLabel"> {
+    pendingAnnotations?: ChatAnnotation[];
+    onPendingAnnotationsChange?: (annotations: ChatAnnotation[]) => void;
+    annotationLabels?: ChatAnnotationLabels;
+    /** Show the composer before a persisted session exists. */
+    allowDraftSession?: boolean;
+    attachmentDownloader?: (attachment: ChatMessageAttachment) => Promise<Blob>;
+    attachmentLabels?: ChatAttachmentLabels;
+    autoFocusComposer?: boolean;
+    createSessionLabel?: string;
+    currentUserDisplayName?: string;
+    hideMessageIdentity?: boolean;
+    composerRef?: Ref<HTMLTextAreaElement>;
+    debugOptions?: ChatDebugOptions;
+    disabledInput?: boolean;
+    draft: string;
+    composerHeader?: ReactNode;
+    /** Host controls displayed above, outside the input surface. */
+    composerTop?: ReactNode;
+    emptyDescription?: string;
+    emptyTitle?: string;
+    footerAddon?: ReactNode;
+    goal?: ChatGoalIndicatorProps | null;
+    formatAnnotationCount?: (count: number) => string;
+    headerContent?: ReactNode;
+    inputPlaceholder?: string;
+    inputSuggestions?: ChatInputSuggestion[];
+    skillSuggestionTriggers?: Array<"$" | "/">;
+    inputSuggestionLabels?: ChatInputSuggestionLabels;
+    queuedInputPlaceholder?: string;
+    steeringInputPlaceholder?: string;
+    liveAguiAnchorMessageCodes?: Record<string, string>;
+    liveAguiEvents?: ChatAguiStreamEvent[];
+    liveAguiPendingAnchorMessageCode?: string;
+    liveAguiPending?: boolean;
+    /** Host language for tool card titles ('zh-CN' | 'en-US' | anything). */
+    locale?: string;
+    messages: ChatMessage[];
+    historyLoading?: boolean;
+    historyLoadingOlder?: boolean;
+    historyLabels?: ChatHistoryLabels;
+    onLoadOlderHistory?: () => void;
+    onCreateSession?: () => void;
+    onNewSession?: () => void;
+    onDraftChange: (value: string) => void;
+    onPasteAttachment?: (file: File) => void | Promise<void>;
+    a2uiSession?: ChatA2uiSession;
+    a2uiDisabled?: boolean;
+    onA2UIAction?: ActionHandler;
+    onEditMessage?: (content: string, message?: ChatMessage) => void;
+    onDeleteTurn?: (message: ChatMessage) => void;
+    deleteTurnLabel?: string;
+    onEditQueuedMessage?: (id: string, content: string) => void;
+    onRemoveQueuedMessage?: (id: string) => void;
+    onSteerQueuedMessage?: (id: string) => void;
+    onReorderQueuedMessage?: (sourceId: string, targetId: string) => void;
+    onSend: (mode?: ChatSubmitMode) => void;
+    onStop?: () => void;
+    protocolEvents?: ChatAguiStreamEvent[];
+    queueDisabled?: boolean;
+    queuedLabel?: string;
+    queuedMessages?: ChatQueuedSubmission[];
+    runningSubmitModes?: ChatRunningSubmitMode[];
+    runningEnterSubmitMode?: ChatRunningSubmitMode;
+    sendDisabled?: boolean;
+    sendLabel?: string;
+    sending?: boolean;
+    streamingAssistantMessageCode?: string | null;
+    session?: ChatSession | null;
+    showAgui?: boolean;
+    showReasoningCards?: boolean;
+    showHeader?: boolean;
+    /** Read-only transcripts reuse the same work rail without an input composer. */
+    showComposer?: boolean;
+    showHistoryRail?: boolean;
+    showStop?: boolean;
+    sidebarContent?: ReactNode;
+    steerDisabled?: boolean;
+    queuedSteerDisabled?: boolean;
+    stopLabel?: string;
+    title?: string;
+    userInputLabels?: ChatUserInputLabels;
+    workRailLabels?: ChatWorkRailLabels;
+    userInputRequests?: ChatUserInputRequest[];
+    userInputRequest?: ChatUserInputRequest | null;
+    userInputAnswerPending?: boolean;
+    userInputAnswerFailed?: boolean;
+    onAnswerUserInput?: (answers: ChatUserInputAnswer[]) => void;
+    renderMarkdownLink?: ChatMarkdownLinkRenderer;
+}
+export declare function ChatPanel({ renderAttachmentControl, pendingAttachments, showAttachmentControl, attachmentUploadPending, onAttachFile, onRemoveAttachment, attachLabel, uploadingLabel, removeAttachmentLabel, editQueuedLabel, removeQueuedLabel, reorderQueuedLabel, steerQueuedLabel, pendingAnnotations: controlledPendingAnnotations, onPendingAnnotationsChange, annotationLabels, allowDraftSession, attachmentDownloader, attachmentLabels, autoFocusComposer, createSessionLabel, currentUserDisplayName, hideMessageIdentity, composerRef, debugOptions, disabledInput, draft, composerHeader, composerTop, emptyDescription, emptyTitle, footerAddon, goal, formatAnnotationCount, headerContent, inputPlaceholder, inputSuggestions, skillSuggestionTriggers, inputSuggestionLabels, queuedInputPlaceholder, steeringInputPlaceholder, liveAguiAnchorMessageCodes, liveAguiEvents, liveAguiPendingAnchorMessageCode, liveAguiPending, locale, messages, historyLoading, historyLoadingOlder, historyLabels, onLoadOlderHistory, onCreateSession, onNewSession, onDraftChange, onPasteAttachment, a2uiSession, a2uiDisabled, onA2UIAction, onEditMessage, onDeleteTurn, deleteTurnLabel, onEditQueuedMessage, onRemoveQueuedMessage, onSteerQueuedMessage, onReorderQueuedMessage, onSend, onStop, protocolEvents, queueDisabled, queuedLabel, queuedMessages, runningSubmitModes, runningEnterSubmitMode, sendDisabled, sendLabel, sending, streamingAssistantMessageCode: activeStreamingAssistantMessageCode, session, showAgui, showReasoningCards, showHeader, showComposer, showHistoryRail, showStop, sidebarContent, steerDisabled, queuedSteerDisabled, stopLabel, title, userInputLabels, workRailLabels, userInputRequests, userInputRequest, userInputAnswerPending, userInputAnswerFailed, onAnswerUserInput, renderMarkdownLink, }: ChatPanelProps): import("react").JSX.Element;

package/dist/src/ChatRuntimeWindow.d.ts

@@ -0,0 +1,71 @@
+import { ComposerReactProps } from '@personai/agent-ui-composer-react';
+import { ChatGoalIndicatorProps } from './ChatGoalIndicator';
+import { ChatAnnotation, ChatA2uiActionHandler as ActionHandler, MessageSender, ChatFloatingState, ChatAdapter, AssistantReplyEffect, ChatAttachmentLabels, ChatMessageAttachment, ChatClientConfig, ChatDebugOptions, ChatMessage, ChatRuntimeRunState, ChatSession, SendChatMessageInput } from '@personai/agent-ui-chat-core';
+import { Ref, ReactNode } from 'react';
+import { ChatMarkdownLinkRenderer } from './ChatPanel';
+interface ToastLikeCallback {
+    (message: string, title?: string): void;
+}
+export interface ChatRuntimeSubmitter {
+    /** Submit host-generated content through the same admission and queue as the composer. */
+    submit(input: Pick<SendChatMessageInput, "content" | "attachments">): Promise<boolean>;
+}
+export interface ChatRuntimeWindowProps {
+    /** Forward A2UI actions to the host transport. */
+    onA2UIAction?: ActionHandler;
+    /** Open a local composer and create its session on the first submission. */
+    allowDraftSession?: boolean;
+    agentReplyEffect?: AssistantReplyEffect;
+    agentReplySpeed?: number;
+    adapter?: ChatAdapter;
+    /** Load host-staged attachments before a session exists; also used for history. */
+    attachmentDownloader?: (attachment: ChatMessageAttachment) => Promise<Blob>;
+    attachmentLabels?: ChatAttachmentLabels;
+    autoFocusComposer?: boolean;
+    config: ChatClientConfig;
+    composerRef?: Ref<HTMLTextAreaElement>;
+    submitterRef?: Ref<ChatRuntimeSubmitter>;
+    composerHeader?: ReactNode;
+    /** Host controls displayed above, outside the input surface. */
+    composerTop?: ReactNode;
+    createSessionLabel?: string;
+    currentUserDisplayName?: string;
+    currentSender?: MessageSender;
+    draft?: string;
+    debugOptions?: ChatDebugOptions;
+    emptyDescription?: string;
+    emptyTitle?: string;
+    /** Use external feedback when the host reports admission errors through onError. */
+    errorDisplay?: "inline" | "external";
+    floatingTitle?: string;
+    floatingSubtitle?: string;
+    formatAnnotationCount?: (count: number) => string;
+    footerAddon?: ReactNode;
+    goal?: ChatGoalIndicatorProps | null;
+    headerContent?: ReactNode;
+    initialSession?: ChatSession | null;
+    onCreateSession?: () => void;
+    onDraftChange?: (draft: string) => void;
+    onError?: ToastLikeCallback;
+    confirmDeleteTurn?: (message: ChatMessage) => boolean | Promise<boolean>;
+    onInfo?: ToastLikeCallback;
+    onPendingAttachmentsChange?: (attachments: ChatMessageAttachment[]) => void;
+    /** Hosts can stage pasted files locally until the first submission. */
+    onPasteAttachment?: (file: File) => void | Promise<void>;
+    onRunStateChange?: (state: ChatRuntimeRunState) => void;
+    onSessionChange?: (session: ChatSession | null) => void;
+    pendingAnnotations?: ChatAnnotation[];
+    onPendingAnnotationsChange?: (annotations: ChatAnnotation[]) => void;
+    pendingAttachments?: ChatMessageAttachment[];
+    createSendInput?: (session: ChatSession, content: string, attachments: ChatMessageAttachment[]) => SendChatMessageInput | null;
+    renderAttachmentControl?: ComposerReactProps["renderAttachmentControl"];
+    showAttachmentControl?: boolean;
+    showHeader?: boolean;
+    showHistoryRail?: boolean;
+    sidebarContent?: ReactNode;
+    windowState?: ChatFloatingState;
+    onWindowStateChange?: (state: ChatFloatingState) => void;
+    renderMarkdownLink?: ChatMarkdownLinkRenderer;
+}
+export declare function ChatRuntimeWindow({ allowDraftSession, agentReplyEffect, agentReplySpeed, adapter, attachmentDownloader: hostAttachmentDownloader, attachmentLabels, autoFocusComposer, composerHeader, composerTop, config, composerRef, submitterRef, createSessionLabel, currentUserDisplayName, currentSender, draft: controlledDraft, debugOptions, emptyDescription, emptyTitle, errorDisplay, floatingSubtitle, floatingTitle, formatAnnotationCount, footerAddon, goal, headerContent, initialSession, onCreateSession, onDraftChange, onError, confirmDeleteTurn, onInfo, onPendingAttachmentsChange, onPasteAttachment, onRunStateChange, onSessionChange, pendingAnnotations: controlledPendingAnnotations, onPendingAnnotationsChange, pendingAttachments: controlledPendingAttachments, createSendInput: createSendInputOverride, renderAttachmentControl, showAttachmentControl, showHeader, showHistoryRail, sidebarContent, windowState, onWindowStateChange, onA2UIAction, renderMarkdownLink, }: ChatRuntimeWindowProps): import("react").JSX.Element;
+export {};

package/dist/src/ChatUserInputCard.d.ts

@@ -0,0 +1,7 @@
+import { ChatUserInputAnswer, ChatUserInputLabels, ChatUserInputRequest } from '@personai/agent-ui-chat-core';
+export declare function ChatUserInputCard({ disabled, labels, onSubmit, request }: {
+    disabled?: boolean;
+    labels?: ChatUserInputLabels;
+    onSubmit: (answers: ChatUserInputAnswer[]) => void;
+    request: ChatUserInputRequest;
+}): import("react").JSX.Element;

package/dist/src/ChatUserInputGroup.d.ts

@@ -0,0 +1,11 @@
+import { ChatUserInputAnswer, ChatUserInputLabels, ChatUserInputRequest } from '@personai/agent-ui-chat-core';
+type Props = {
+    request: ChatUserInputRequest;
+    requests: ChatUserInputRequest[];
+    labels?: ChatUserInputLabels;
+    disabled?: boolean;
+    submitFailed?: boolean;
+    onSubmit: (answers: ChatUserInputAnswer[]) => void;
+};
+export declare function ChatUserInputGroup(props: Props): import("react").JSX.Element;
+export {};

package/dist/src/ChatWindow.d.ts

@@ -0,0 +1,13 @@
+import { ChatFloatingState } from '@personai/agent-ui-chat-core';
+import { ChatPanelProps } from './ChatPanel';
+interface ChatWindowProps extends Omit<ChatPanelProps, "headerContent" | "showHeader"> {
+    state?: ChatFloatingState;
+    showNewSession?: boolean;
+    storageKey?: string;
+    title?: string;
+    titleSubtitle?: string;
+    resizeHint?: string;
+    onStateChange?: (state: ChatFloatingState) => void;
+}
+export declare function ChatWindow({ onStateChange, showNewSession, state, storageKey, title, titleSubtitle, resizeHint, ...panelProps }: ChatWindowProps): import("react").JSX.Element;
+export {};

package/dist/src/InteractionReceipt.d.ts

@@ -0,0 +1,7 @@
+import { ChatMessage } from '@personai/agent-ui-chat-core';
+/** A display-only receipt. The original interaction and timeline stay unchanged. */
+export declare function InteractionReceipt({ message, actorName, hideMessageIdentity }: {
+    message: ChatMessage;
+    actorName: string;
+    hideMessageIdentity?: boolean;
+}): import("react").JSX.Element;

package/dist/src/MermaidBlock.d.ts

@@ -0,0 +1,6 @@
+import { Components } from 'react-markdown';
+export declare const MarkdownSourceContext: import('react').Context<{
+    content: string;
+    streaming: boolean;
+}>;
+export declare const MermaidPre: Components["pre"];

package/dist/src/ToolResultView.d.ts

@@ -0,0 +1,5 @@
+export declare function ToolResultView({ value, locale, showRaw }: {
+    value: string;
+    locale?: string;
+    showRaw?: boolean;
+}): import("react").JSX.Element;

package/dist/src/chatAttachments.d.ts

@@ -0,0 +1,4 @@
+import { ChatMessageAttachment } from '@personai/agent-ui-chat-core';
+export declare function matchesSupportedImageContentType(contentType: string | undefined): contentType is "image/png" | "image/jpeg" | "image/webp" | "image/gif";
+export declare function isImageAttachment(attachment: ChatMessageAttachment): boolean;
+export declare function useAttachmentImageSource(attachment: ChatMessageAttachment, downloadAttachment?: (attachment: ChatMessageAttachment) => Promise<Blob>): string | null;

package/dist/src/chatHistory.d.ts

@@ -0,0 +1,11 @@
+import { ChatMessage, TranscriptPresentation } from '@personai/agent-ui-chat-core';
+export interface ChatHistoryTurn {
+    assistantPreview: string;
+    hasAssistantReply: boolean;
+    hasWorkActivity: boolean;
+    id: string;
+    messageCodes: string[];
+    userMessageCode: string;
+    userPreview: string;
+}
+export declare function buildChatHistoryTurns(messages: ChatMessage[], presentation: TranscriptPresentation): ChatHistoryTurn[];

package/dist/src/index.d.ts

@@ -0,0 +1,8 @@
+export * from './ChatPanel';
+export * from './ChatGoalIndicator';
+export * from './ChatRuntimeWindow';
+export * from './ChatWindow';
+export { ChatA2UI } from './ChatA2UI';
+export { MotionProvider, AgentMotion, useMotion } from '@personai/agent-ui-motion-react';
+export type { MotionConfig, MotionEffects, MotionPreset, ResolvedMotion } from '@personai/agent-ui-motion-react';
+export { useComposerDisabled } from '@personai/agent-ui-composer-react';