@beanx/cathygo-web-core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,363 @@
+import * as react from 'react';
+import { Dispatch, RefObject } from 'react';
+import { AgentActivity, LearningTurnEvent, ConversationSummary, GatewayModelStatus } from '@beanx/cathygo-protocol';
+
+type AgentIdentityStatus = {
+    agent_id?: string | null;
+    agent_short_id?: string | null;
+    display_name?: string | null;
+};
+declare function agentDisplayName(status?: AgentIdentityStatus): string;
+declare function agentShortId(status?: AgentIdentityStatus): string | undefined;
+
+type ComposerAttachmentPolicy = {
+    acceptMimeTypes?: readonly string[];
+    maxFileSizeBytes?: number;
+    maxFiles?: number;
+};
+type ComposerFileLike = Pick<File, 'name' | 'size' | 'type'>;
+type ComposerFileRejectionReason = 'count' | 'size' | 'type';
+type ComposerFileRejection = {
+    fileName: string;
+    message: string;
+    reason: ComposerFileRejectionReason;
+};
+type ComposerFileValidationResult<TFile extends ComposerFileLike = File> = {
+    accepted: TFile[];
+    error?: string;
+    rejected: ComposerFileRejection[];
+};
+declare const DEFAULT_COMPOSER_ATTACHMENT_POLICY: {
+    readonly acceptMimeTypes: readonly ["image/png", "image/jpeg", "image/webp"];
+    readonly maxFileSizeBytes: number;
+    readonly maxFiles: 4;
+};
+declare function normalizeComposerAttachmentPolicy(policy?: ComposerAttachmentPolicy): Required<ComposerAttachmentPolicy>;
+declare function composerAcceptAttribute(policy?: ComposerAttachmentPolicy): string;
+declare function validateComposerFiles<TFile extends ComposerFileLike>(files: TFile[], existingCount?: number, policy?: ComposerAttachmentPolicy): ComposerFileValidationResult<TFile>;
+declare function formatBytes(bytes: number): string;
+
+type PendingComposerAttachment = {
+    id: string;
+    name: string;
+    previewUrl: string;
+};
+type MessageComposerHandle = {
+    openFilePicker: () => void;
+};
+type MessageComposerProps = {
+    value: string;
+    attachments?: PendingComposerAttachment[];
+    error?: string;
+    attachmentPolicy?: ComposerAttachmentPolicy;
+    disabled?: boolean;
+    layout?: 'default' | 'hero';
+    placeholder?: string;
+    showDisclaimer?: boolean;
+    onChange: (value: string) => void;
+    onFilesSelected?: (files: File[]) => void;
+    onRemoveAttachment?: (id: string) => void;
+    onSubmit: () => void;
+};
+declare const MessageComposer: react.ForwardRefExoticComponent<MessageComposerProps & react.RefAttributes<MessageComposerHandle>>;
+
+type ChatRole = 'user' | 'assistant' | 'system';
+type ChatAttachment = {
+    id: string;
+    kind: 'image';
+    uri: string;
+    original_name?: string | null;
+    mime_type?: string | null;
+    size_bytes?: number | null;
+    sha256?: string | null;
+    width?: number | null;
+    height?: number | null;
+    created_at?: string | null;
+};
+type ChatMessagePart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    attachment_id: string;
+    attachment: ChatAttachment;
+};
+type ChatMessage$1 = {
+    id: string;
+    role: ChatRole;
+    content: string;
+    parts?: ChatMessagePart[];
+    turnId?: string;
+    status?: 'streaming' | 'done' | 'error';
+};
+type ChatState = {
+    sessionId?: string;
+    activeTurnId?: string;
+    messages: ChatMessage$1[];
+    activitiesByTurnId: Record<string, AgentActivity[]>;
+    progressByTurnId: Record<string, AgentRunProgress>;
+    status: string;
+    contextMessageCount?: number;
+    error?: string;
+    errorCode?: string;
+    eventCount: number;
+};
+type AgentRunProgressPhase = 'queued' | 'model' | 'reasoning' | 'tool' | 'generating';
+type AgentRunProgress = {
+    turnId: string;
+    phase: AgentRunProgressPhase;
+    status: 'running' | 'completed' | 'failed' | 'cancelled';
+    summary: string;
+    detail?: string;
+    thinking?: AgentRunThinking;
+    startedAt: string;
+    updatedAt?: string;
+};
+type AgentRunThinking = {
+    expanded: boolean;
+    lines: string[];
+    hiddenCount: number;
+    hiddenStartedAt?: string;
+    updatedAt: string;
+};
+type ChatAction = {
+    type: 'session.created';
+    sessionId: string;
+} | {
+    type: 'session.loaded';
+    sessionId: string;
+    messages: ChatMessage$1[];
+    activities?: AgentActivity[];
+} | {
+    type: 'user.sent';
+    id: string;
+    content: string;
+    parts?: ChatMessagePart[];
+} | {
+    type: 'turn.accepted';
+    sessionId: string;
+    turnId: string;
+} | {
+    type: 'send.failed';
+    id: string;
+    error: string;
+    code?: string;
+} | {
+    type: 'event.received';
+    event: LearningTurnEvent;
+} | {
+    type: 'reset';
+};
+
+type ChatHomeModeId = 'photo_question' | 'paper_analysis' | 'knowledge_learning';
+type ChatHomeMode = {
+    id: ChatHomeModeId;
+    label: string;
+    placeholder: string;
+    emphasizeAttachment?: boolean;
+};
+declare const CHAT_HOME_MODES: ChatHomeMode[];
+declare const DEFAULT_CHAT_HOME_MODE_ID: ChatHomeModeId;
+declare function findChatHomeMode(id: ChatHomeModeId): ChatHomeMode;
+
+type CathyGOChatScreen = 'home' | 'chat' | 'history';
+type CathyGOChatAppProps = {
+    screen: CathyGOChatScreen;
+    chat: ChatState;
+    chats?: ConversationSummary[];
+    draft: string;
+    attachments?: PendingComposerAttachment[];
+    attachmentPolicy?: ComposerAttachmentPolicy;
+    composerError?: string;
+    busy?: boolean;
+    connectionStatus: string;
+    gatewayLinked?: boolean;
+    model?: GatewayModelStatus;
+    agentStatus?: AgentIdentityStatus;
+    homeAvatarSrc?: string;
+    onDraftChange: (value: string) => void;
+    onFilesSelected?: (files: File[]) => void;
+    onRemoveAttachment?: (id: string) => void;
+    onSendMessage: () => void;
+    onSendHomeMessage: (modeId: ChatHomeModeId) => void;
+    onAbort: () => void;
+    onSuggest?: (text: string) => void;
+    onOpenChat: (sessionId: string) => void;
+    onNewChat: () => void;
+};
+declare function CathyGOChatApp({ screen, chat, chats, draft, attachments, attachmentPolicy, composerError, busy, connectionStatus, gatewayLinked, model, agentStatus, homeAvatarSrc, onDraftChange, onFilesSelected, onRemoveAttachment, onSendMessage, onSendHomeMessage, onAbort, onSuggest, onOpenChat, onNewChat, }: CathyGOChatAppProps): react.JSX.Element;
+
+type UseCathyGOChatResult = {
+    chat: ChatState;
+    dispatchChat: Dispatch<ChatAction>;
+    resetChat: () => void;
+    createSession: (sessionId: string) => void;
+    loadSession: (sessionId: string, messages: ChatMessage$1[], activities?: ChatState['activitiesByTurnId'][string]) => void;
+    applyTurnEvent: (event: LearningTurnEvent) => void;
+};
+declare function useCathyGOChat(initialState?: ChatState): UseCathyGOChatResult;
+
+declare const initialChatState: ChatState;
+declare function reduceChat(state: ChatState, action: ChatAction): ChatState;
+
+/** Strip LaTeX delimiters for compact sidebar / list previews. */
+declare function stripMathForPreview(text: string, maxLen?: number): string;
+
+declare function fixCommonLatexMistakes(source: string): string;
+declare function normalizeMathDelimiters(source: string): string;
+/** Full preprocess pipeline used by all Web chat/agent message renderers. */
+declare function prepareMathMarkdown(source: string): string;
+
+type AgentActivityTimelineProps = {
+    activities: AgentActivity[];
+    progress?: AgentRunProgress;
+};
+declare function AgentActivityTimeline({ activities, progress }: AgentActivityTimelineProps): react.JSX.Element | null;
+
+type ChatAgentIdentityProps = {
+    agentStatus?: AgentIdentityStatus;
+};
+declare function ChatAgentIdentity({ agentStatus }: ChatAgentIdentityProps): react.JSX.Element;
+
+type ChatMessageProps = {
+    message: ChatMessage$1;
+};
+declare function ChatMessage({ message }: ChatMessageProps): react.JSX.Element;
+
+type ChatRuntimeId = 'lite' | 'local';
+type ChatRuntimeSelectorProps = {
+    agentStatus?: AgentIdentityStatus;
+    value?: ChatRuntimeId;
+    onChange?: (id: ChatRuntimeId) => void;
+};
+type RuntimeOption = {
+    id: ChatRuntimeId;
+    label: string;
+    icon: 'cloud' | 'local';
+};
+declare function buildRuntimeOptions(agentStatus?: AgentIdentityStatus): RuntimeOption[];
+declare function ChatRuntimeSelector({ agentStatus, value, onChange, }: ChatRuntimeSelectorProps): react.JSX.Element;
+
+type ChatTopBarProps = {
+    agentStatus?: AgentIdentityStatus;
+    connectionStatus: string;
+    gatewayLinked?: boolean;
+    model?: GatewayModelStatus;
+    debugUI?: boolean;
+    canAbort?: boolean;
+    onAbort?: () => void;
+};
+declare function ChatTopBar({ agentStatus, connectionStatus, gatewayLinked, model, debugUI, canAbort, onAbort, }: ChatTopBarProps): react.JSX.Element;
+
+type ChatTranscriptProps = {
+    messages: ChatMessage$1[];
+    activitiesByTurnId?: Record<string, AgentActivity[]>;
+    progressByTurnId?: Record<string, AgentRunProgress>;
+    activeTurnId?: string;
+    onSuggest?: (text: string) => void;
+};
+declare function ChatTranscript({ messages, activitiesByTurnId, progressByTurnId, activeTurnId, onSuggest, }: ChatTranscriptProps): react.JSX.Element;
+
+type MathMarkdownProps = {
+    content: string;
+};
+declare const MathMarkdown: react.NamedExoticComponent<MathMarkdownProps>;
+
+type RunStatusProps = {
+    status: string;
+    sessionId?: string;
+    activeTurnId?: string;
+    contextMessageCount?: number;
+    error?: string;
+    errorCode?: string;
+};
+declare function RunStatus({ status, sessionId, activeTurnId, contextMessageCount, error, errorCode, }: RunStatusProps): react.JSX.Element;
+
+type ScrollToBottomButtonProps = {
+    containerRef: RefObject<HTMLElement | null>;
+    endRef: RefObject<HTMLElement | null>;
+    watchKey: unknown;
+};
+declare function ScrollToBottomButton({ containerRef, endRef, watchKey, }: ScrollToBottomButtonProps): react.JSX.Element | null;
+
+type IconProps = {
+    className?: string;
+};
+declare function IconNewChat({ className }: IconProps): react.JSX.Element;
+declare function IconPencil({ className }: IconProps): react.JSX.Element;
+declare function IconCalendar({ className }: IconProps): react.JSX.Element;
+declare function IconMessage({ className }: IconProps): react.JSX.Element;
+declare function IconDocument({ className }: IconProps): react.JSX.Element;
+declare function IconSearch({ className }: IconProps): react.JSX.Element;
+declare function IconSettings({ className }: IconProps): react.JSX.Element;
+declare function IconImageUpload({ className }: IconProps): react.JSX.Element;
+declare function IconChevronRight({ className }: IconProps): react.JSX.Element;
+declare function IconMore({ className }: IconProps): react.JSX.Element;
+declare function IconExternalLink({ className }: IconProps): react.JSX.Element;
+declare function IconHome({ className }: IconProps): react.JSX.Element;
+declare function IconGithub({ className }: IconProps): react.JSX.Element;
+declare function IconBack({ className }: IconProps): react.JSX.Element;
+declare function IconClose({ className }: IconProps): react.JSX.Element;
+declare function IconPlug({ className }: IconProps): react.JSX.Element;
+declare function IconBrain({ className }: IconProps): react.JSX.Element;
+declare function IconDevice({ className }: IconProps): react.JSX.Element;
+declare function IconDevices({ className }: IconProps): react.JSX.Element;
+declare function IconSmartphone({ className }: IconProps): react.JSX.Element;
+declare function IconShield({ className }: IconProps): react.JSX.Element;
+declare function IconCode({ className }: IconProps): react.JSX.Element;
+declare function IconInfo({ className }: IconProps): react.JSX.Element;
+declare function IconCloud({ className }: IconProps): react.JSX.Element;
+declare function IconLocalComputer({ className }: IconProps): react.JSX.Element;
+declare function IconChevronDown({ className }: IconProps): react.JSX.Element;
+declare function IconGatewayOnline({ className }: IconProps): react.JSX.Element;
+declare function IconGatewayConnecting({ className }: IconProps): react.JSX.Element;
+declare function IconGatewayOffline({ className }: IconProps): react.JSX.Element;
+declare function IconSend({ className }: IconProps): react.JSX.Element;
+
+interface ChatHomeViewProps {
+    draft: string;
+    attachments?: PendingComposerAttachment[];
+    attachmentPolicy?: ComposerAttachmentPolicy;
+    error?: string;
+    busy?: boolean;
+    connectionStatus: string;
+    gatewayLinked?: boolean;
+    model?: GatewayModelStatus;
+    agentStatus?: AgentIdentityStatus;
+    avatarSrc?: string;
+    onDraftChange: (value: string) => void;
+    onFilesSelected?: (files: File[]) => void;
+    onRemoveAttachment?: (id: string) => void;
+    onSend: (modeId: ChatHomeModeId) => void;
+}
+declare function ChatHomeView({ draft, attachments, attachmentPolicy, error, busy, connectionStatus, gatewayLinked, model, agentStatus, avatarSrc, onDraftChange, onFilesSelected, onRemoveAttachment, onSend, }: ChatHomeViewProps): react.JSX.Element;
+
+interface ChatListViewProps {
+    chats: ConversationSummary[];
+    onOpen: (sessionId: string) => void;
+    onNewChat: () => void;
+}
+declare function ChatListView({ chats, onOpen, onNewChat }: ChatListViewProps): react.JSX.Element;
+
+interface ChatViewProps {
+    chat: ChatState;
+    draft: string;
+    attachments?: PendingComposerAttachment[];
+    attachmentPolicy?: ComposerAttachmentPolicy;
+    composerError?: string;
+    connectionStatus: string;
+    gatewayLinked?: boolean;
+    model?: GatewayModelStatus;
+    agentStatus?: AgentIdentityStatus;
+    onDraftChange: (value: string) => void;
+    onFilesSelected?: (files: File[]) => void;
+    onRemoveAttachment?: (id: string) => void;
+    onSend: () => void;
+    onAbort: () => void;
+    onSuggest?: (text: string) => void;
+}
+declare function ChatView({ chat, draft, attachments, attachmentPolicy, composerError, connectionStatus, gatewayLinked, model, agentStatus, onDraftChange, onFilesSelected, onRemoveAttachment, onSend, onAbort, onSuggest, }: ChatViewProps): react.JSX.Element;
+
+declare function modelStatusText(model: GatewayModelStatus): string;
+
+export { AgentActivityTimeline, type AgentIdentityStatus, type AgentRunProgress, type AgentRunProgressPhase, type AgentRunThinking, CHAT_HOME_MODES, CathyGOChatApp, type CathyGOChatAppProps, type CathyGOChatScreen, type ChatAction, ChatAgentIdentity, type ChatAttachment, type ChatHomeMode, type ChatHomeModeId, ChatHomeView, ChatListView, type ChatMessage$1 as ChatMessage, type ChatMessagePart, ChatMessage as ChatMessageView, type ChatRole, type ChatRuntimeId, ChatRuntimeSelector, type ChatRuntimeSelectorProps, type ChatState, ChatTopBar, ChatTranscript, ChatView, type ComposerAttachmentPolicy, type ComposerFileLike, type ComposerFileRejection, type ComposerFileRejectionReason, type ComposerFileValidationResult, DEFAULT_CHAT_HOME_MODE_ID, DEFAULT_COMPOSER_ATTACHMENT_POLICY, IconBack, IconBrain, IconCalendar, IconChevronDown, IconChevronRight, IconClose, IconCloud, IconCode, IconDevice, IconDevices, IconDocument, IconExternalLink, IconGatewayConnecting, IconGatewayOffline, IconGatewayOnline, IconGithub, IconHome, IconImageUpload, IconInfo, IconLocalComputer, IconMessage, IconMore, IconNewChat, IconPencil, IconPlug, IconSearch, IconSend, IconSettings, IconShield, IconSmartphone, MathMarkdown, MessageComposer, type MessageComposerHandle, type PendingComposerAttachment, RunStatus, type RuntimeOption, ScrollToBottomButton, type UseCathyGOChatResult, agentDisplayName, agentShortId, buildRuntimeOptions, composerAcceptAttribute, findChatHomeMode, fixCommonLatexMistakes, formatBytes, initialChatState, modelStatusText, normalizeComposerAttachmentPolicy, normalizeMathDelimiters, prepareMathMarkdown, reduceChat, stripMathForPreview, useCathyGOChat, validateComposerFiles };