@webority/mobile-chat 0.122.0 → 0.125.0

package/lib/typescript/commonjs/components/ChatMessage.d.ts

@@ -1,6 +1,6 @@
+import type { ChatAttachment, ChatRating, SupportActionTicket } from "@webority/markdown-core/chat";
+import { type ChatLabels } from "@webority/markdown-core/chat";
 import type React from "react";
-import { type ChatLabels } from "../labels";
-import type { ChatRating, SupportActionTicket } from "../types";
 import type { ChatTurn } from "../useChat";
 /** The props a thread passes to each of its turns. */
 export interface ChatReplyProps<T = string> {
@@ -10,6 +10,12 @@ export interface ChatReplyProps<T = string> {
     resolveLink?: (href: string) => T | null | undefined;
     /** Opens what `resolveLink` returned. */
     onLinkPress?: (target: T) => void;
+    /** Tells a citation marker in a reply from an ordinary link; see `ChatMarkdown`. */
+    isCitation?: (inner: string) => boolean;
+    /** Opens the citation a reply marker names; see `ChatMarkdown`. */
+    onOpenCitation?: (citation: string) => void;
+    /** Sends a suggested follow-up question; shows the suggestions under the last answer. */
+    onAskSuggestion?: (text: string) => void;
     /** Shows support action cards; see `ActionCard`. */
     confirmAction?: (token: string) => Promise<SupportActionTicket>;
     onViewTicket?: (ticket: SupportActionTicket) => void;
@@ -20,19 +26,30 @@ export interface ChatReplyProps<T = string> {
     renderReply?: (turn: ChatTurn, state: {
         streaming: boolean;
     }) => React.ReactNode;
+    /** Sends a failed or stopped question again; shows Try again under it. */
+    onRetry?: (turnId: string) => void;
+    /** Asks for a new answer to this turn; shows New answer under the answer when `canRegenerate` is set. */
+    onRegenerate?: (turnId: string) => void;
+    /** Puts this question back in the box to edit; shows Edit under the question. */
+    onEdit?: (turnId: string) => void;
+    /** Opens an attached file from its chip under the question. */
+    onOpenAttachment?: (attachment: ChatAttachment) => void;
     labels?: Partial<ChatLabels>;
 }
 export interface ChatMessageProps<T = string> extends ChatReplyProps<T> {
     turn: ChatTurn;
+    /** Set on the one turn a New answer is offered for, normally the last answered turn. */
+    canRegenerate?: boolean;
     testID?: string;
 }
 /**
  * One turn on mobile-ui's chat parts: the person's question in a `MessageBubble` on the trailing
- * side, the typing dots while the answer has not started, then the answer in a bubble on the
- * leading side. The answer is announced once, when it finishes arriving. Support actions show
- * under the answer, and the rating once the reply is stored.
+ * side, with its files, a stopped note and Try again or Edit under it; the typing dots and the
+ * tool step while the answer has not started, then the answer in a bubble on the leading side.
+ * The answer is announced once, when it finishes arriving. Support actions show under the answer,
+ * and the rating once the reply is stored.
  */
-declare function ChatMessageView<T = string>({ turn, onRate, resolveLink, onLinkPress, confirmAction, onViewTicket, renderReply, labels: labelOverrides, testID, }: ChatMessageProps<T>): React.ReactElement;
+declare function ChatMessageView<T = string>({ turn, canRegenerate, onRetry, onRegenerate, onEdit, onOpenAttachment, onRate, resolveLink, onLinkPress, isCitation, onOpenCitation, onAskSuggestion, confirmAction, onViewTicket, renderReply, labels: labelOverrides, testID, }: ChatMessageProps<T>): React.ReactElement;
 export declare const ChatMessage: typeof ChatMessageView;
 export {};
 //# sourceMappingURL=ChatMessage.d.ts.map

package/lib/typescript/commonjs/components/ChatScreen.d.ts

@@ -1,9 +1,14 @@
+import { type ChatAttachment, type ChatUploadFile } from "@webority/markdown-core/chat";
 import type React from "react";
 import type { UseChatResult } from "../useChat";
 import type { ChatReplyProps } from "./ChatMessage";
-export interface ChatScreenProps<T = string> extends Omit<ChatReplyProps<T>, "onRate"> {
+export interface ChatScreenProps<T = string> extends Omit<ChatReplyProps<T>, "onRate" | "onAskSuggestion"> {
     /** The `useChat` result. */
     chat: UseChatResult;
+    /** Opens the file picker. The attach button shows only with this and the chat's attachment settings. */
+    pickAttachments?: () => Promise<ChatUploadFile[]>;
+    /** Opens an attachment shown in a message. */
+    onOpenAttachment?: (attachment: ChatAttachment) => void;
     /** Header title. Defaults to the `panelTitle` label. */
     title?: string;
     /** Extra header controls before New chat, e.g. an "All chats" button. */
@@ -31,5 +36,5 @@ export interface ChatScreenProps<T = string> extends Omit<ChatReplyProps<T>, "on
  * box rides the keyboard and the newest turn stays above it. Place it in a stack screen and keep
  * the `useChat` call above the navigator, so the conversation survives leaving the screen.
  */
-export declare function ChatScreen<T = string>({ chat, title, headerActions, empty, disclaimer, maxLength, allowanceThreshold, rating, keyboardOffset, testID, ...reply }: ChatScreenProps<T>): React.ReactElement;
+export declare function ChatScreen<T = string>({ chat, pickAttachments, onOpenAttachment, title, headerActions, empty, disclaimer, maxLength, allowanceThreshold, rating, keyboardOffset, testID, ...reply }: ChatScreenProps<T>): React.ReactElement;
 //# sourceMappingURL=ChatScreen.d.ts.map

package/lib/typescript/commonjs/components/ChatThread.d.ts

@@ -1,3 +1,4 @@
+import { type ChatAttachment } from "@webority/markdown-core/chat";
 import type React from "react";
 import { type StyleProp, type ViewStyle } from "react-native";
 import type { ChatTurn } from "../useChat";
@@ -10,6 +11,13 @@ export interface ChatThreadProps<T = string> extends ChatReplyProps<T> {
     keyboardAware?: boolean;
     /** The composer's `keyboardOffset`. Default: the bottom safe-area inset. */
     keyboardOffset?: number;
+    /** Asks a failed or stopped turn's question again. */
+    onRetry?: (turnId: string) => void;
+    /** Asks for a new answer; offered on the last answered turn only. */
+    onRegenerate?: (turnId: string) => void;
+    /** Puts a question back in the box to be edited. */
+    onEdit?: (turnId: string) => void;
+    onOpenAttachment?: (attachment: ChatAttachment) => void;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }
@@ -18,5 +26,5 @@ export interface ChatThreadProps<T = string> extends ChatReplyProps<T> {
  * streaming answer growing in place, a jump to the latest once scrolled up,
  * and the newest turn kept above the keyboard.
  */
-export declare function ChatThread<T = string>({ turns, empty, keyboardAware, keyboardOffset, style, testID, ...reply }: ChatThreadProps<T>): React.ReactElement;
+export declare function ChatThread<T = string>({ turns, empty, keyboardAware, keyboardOffset, onRetry, onRegenerate, onEdit, onOpenAttachment, onAskSuggestion, style, testID, ...reply }: ChatThreadProps<T>): React.ReactElement;
 //# sourceMappingURL=ChatThread.d.ts.map

package/lib/typescript/commonjs/components/ComposerAttachments.d.ts

@@ -0,0 +1,12 @@
+import { type ChatLabels, type ComposerAttachment } from "@webority/markdown-core/chat";
+import type React from "react";
+export interface ComposerAttachmentsProps {
+    attachments: ComposerAttachment[];
+    /** Omit to show the files without remove buttons. */
+    onRemove?: (key: string) => void;
+    labels?: Partial<ChatLabels>;
+    testID?: string;
+}
+/** The files on the question being written: a chip per file, a progress bar while it uploads. */
+export declare const ComposerAttachments: React.FC<ComposerAttachmentsProps>;
+//# sourceMappingURL=ComposerAttachments.d.ts.map

package/lib/typescript/commonjs/components/ReplyRating.d.ts

@@ -1,6 +1,6 @@
+import type { ChatRating } from "@webority/markdown-core/chat";
+import { type ChatLabels } from "@webority/markdown-core/chat";
 import type React from "react";
-import { type ChatLabels } from "../labels";
-import type { ChatRating } from "../types";
 export interface ReplyRatingProps {
     /** The rating already saved. */
     rating?: ChatRating | null;

package/lib/typescript/commonjs/index.d.ts

@@ -1,5 +1,5 @@
-export type { ChatClient, ChatHttpClient, ChatHttpRequestConfig } from "./client";
-export { ChatApiError, createChatClient } from "./client";
+export type { ChatAbortSignal, ChatAttachment, ChatAttachmentLimits, ChatBlob, ChatClient, ChatEditing, ChatHttpClient, ChatHttpRequestConfig, ChatLabels, ChatRating, ChatRatingInput, ChatSession, ChatSessionOptions, ChatSessionState, ChatSettings, ChatStreamEventName, ChatStreamOptions, ChatTurnInput, ChatTurnResult, ChatUploadFile, ComposerAttachment, ComposerAttachmentStatus, Conversation, ConversationList, ConversationListOptions, ConversationListState, ConversationMessage, ConversationSummary, FrameScheduler, PagedDataObject, SseEvent, SseParser, SupportAction, SupportActionTicket, } from "@webority/markdown-core/chat";
+export { ChatApiError, createChatClient, createChatSession, createConversationList, createSseParser, DEFAULT_CHAT_LABELS, } from "@webority/markdown-core/chat";
 export type { ActionCardProps } from "./components/ActionCard";
 export { ActionCard } from "./components/ActionCard";
 export type { ChatComposerProps } from "./components/ChatComposer";
@@ -18,11 +18,6 @@ export type { ChatThreadProps } from "./components/ChatThread";
 export { ChatThread } from "./components/ChatThread";
 export type { ReplyRatingProps } from "./components/ReplyRating";
 export { ReplyRating } from "./components/ReplyRating";
-export type { ChatLabels } from "./labels";
-export { DEFAULT_CHAT_LABELS } from "./labels";
-export type { SseEvent, SseParser } from "./sse";
-export { createSseParser } from "./sse";
-export type { ChatRating, ChatRatingInput, ChatStreamEventName, ChatStreamOptions, ChatTurnInput, ChatTurnResult, Conversation, ConversationMessage, ConversationSummary, SupportAction, SupportActionTicket, } from "./types";
 export type { ChatTurn, ChatTurnError, UseChatOptions, UseChatResult } from "./useChat";
 export { useChat } from "./useChat";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/useChat.d.ts

@@ -1,63 +1,19 @@
-import type { ChatClient } from "./client";
-import type { ChatRating, SupportAction } from "./types";
-export interface ChatTurnError {
-    code: string;
-    /** Written for the person. */
-    message: string;
-    resetsAtUtc: string | null;
-}
-/** One question and its answer. */
-export interface ChatTurn {
-    /** Local key; for a reopened conversation, the stored message's id. */
-    id: string;
-    question: string;
-    /** What is shown: the streamed text, then the reply of record. */
-    answer: string;
-    streaming: boolean;
-    error: ChatTurnError | null;
-    actions: SupportAction[];
-    /** The stored reply's id; rating needs it. */
-    messageId: string | null;
-    rating: ChatRating | null;
-    ratingNote: string | null;
-}
+import type { ChatClient, ChatSession, ChatSessionState } from "@webority/markdown-core/chat";
+export type { ChatTurn, ChatTurnError } from "@webority/markdown-core/chat";
 export interface UseChatOptions {
     /** From `createChatClient`. */
     client: ChatClient;
     /** Sent with each question; read at the moment of sending. */
     pageContext?: unknown;
 }
-export interface UseChatResult {
-    /** Oldest first. */
-    turns: ChatTurn[];
-    /** The conversation being continued, or null. */
-    conversationId: string | null;
-    /** From the last answer or `refreshAllowance()`; null with no daily limit. */
-    messagesLeftToday: number | null;
-    /** An answer is arriving. */
-    streaming: boolean;
-    /** `openConversation` is loading. */
-    loading: boolean;
-    /** `openConversation` failed. */
-    loadError: ChatTurnError | null;
-    /** Asks a question. Ignored while an answer is still arriving. */
-    submit: (message: string) => Promise<void>;
-    /** Replaces the thread with a stored conversation. */
-    openConversation: (id: string) => Promise<void>;
-    /** Clears the thread; the next question starts a conversation. */
-    newConversation: () => void;
-    /** Saves a rating, shown at once; a failed save puts the old one back and rejects. */
-    rate: (turnId: string, rating: ChatRating, note?: string) => Promise<void>;
-    /** Reads the questions left today. */
-    refreshAllowance: () => Promise<void>;
-    /** Clears everything, for sign-out or an account switch. */
-    reset: () => void;
-}
+type ChatActions = Pick<ChatSession, "submit" | "stop" | "retry" | "regenerate" | "startEdit" | "cancelEdit" | "attach" | "removeAttachment" | "openConversation" | "newConversation" | "rate" | "refreshAllowance" | "reset">;
+export type UseChatResult = ChatSessionState & ChatActions & {
+    client: ChatClient;
+};
 /**
- * The chat's state and actions, with no store of its own: it lives in the component that calls
- * it. Call `reset()` when the signed-in person or account changes so nothing of one person's chat
- * shows to the next. An answer still streaming is cancelled on `reset`, `newConversation`,
- * `openConversation` and unmount.
+ * The chat's state and actions. The session lives in the component that calls it: one per client,
+ * disposed when the client changes or the component unmounts. Call `reset()` when the signed-in
+ * person or account changes so nothing of one person's chat shows to the next.
  */
 export declare const useChat: ({ client, pageContext }: UseChatOptions) => UseChatResult;
 //# sourceMappingURL=useChat.d.ts.map

package/lib/typescript/module/components/ActionCard.d.ts

@@ -1,6 +1,6 @@
+import type { SupportAction, SupportActionTicket } from "@webority/markdown-core/chat";
+import { type ChatLabels } from "@webority/markdown-core/chat";
 import type React from "react";
-import { type ChatLabels } from "../labels.js";
-import type { SupportAction, SupportActionTicket } from "../types.js";
 export interface ActionCardProps {
     action: SupportAction;
     /**

package/lib/typescript/module/components/ChatComposer.d.ts

@@ -1,10 +1,12 @@
+import { type ChatEditing, type ChatLabels, type ComposerAttachment } from "@webority/markdown-core/chat";
 import type React from "react";
-import { type ChatLabels } from "../labels.js";
 export interface ChatComposerProps {
     /** Called with the trimmed question; the box clears once it is handed over. */
     onSubmit: (message: string) => unknown;
     /** An answer is arriving: the question can be typed but not sent. */
     busy?: boolean;
+    /** While busy, the send button becomes a stop button that calls this. */
+    onStop?: () => void;
     /** No question can be asked, e.g. none left today. */
     disabled?: boolean;
     /** The server's message limit. Default 4000. */
@@ -19,6 +21,15 @@ export interface ChatComposerProps {
     keyboardOffset?: number;
     /** Pads for the bottom safe area. Default true. */
     safeArea?: boolean;
+    /** The files on the question being written. */
+    attachments?: ComposerAttachment[];
+    /** Opens the app's file picker. The attach button shows only when this is given. */
+    onAttach?: () => void;
+    /** Removes one file by its key. */
+    onRemoveAttachment?: (key: string) => void;
+    /** The question being edited; its banner's Cancel calls `onCancelEdit`. */
+    editing?: ChatEditing | null;
+    onCancelEdit?: () => void;
     labels?: Partial<ChatLabels>;
     testID?: string;
 }

package/lib/typescript/module/components/ChatConversationList.d.ts

@@ -1,8 +1,7 @@
+import type { ConversationSummary } from "@webority/markdown-core/chat";
+import { type ChatClient, type ChatLabels } from "@webority/markdown-core/chat";
 import type React from "react";
 import { type StyleProp, type ViewStyle } from "react-native";
-import type { ChatClient } from "../client.js";
-import { type ChatLabels } from "../labels.js";
-import type { ConversationSummary } from "../types.js";
 export interface ChatConversationListProps {
     client: ChatClient;
     /** E.g. go to the chat and call `chat.openConversation(conversation.publicId)`. */
@@ -17,7 +16,7 @@ export interface ChatConversationListProps {
 }
 /**
  * The person's past chats, newest first. It pages with Show more, refreshes on pull, opens one
- * through `onOpen`, and deletes one after a confirm.
+ * through `onOpen`, renames and deletes one after a confirm.
  */
 export declare const ChatConversationList: React.FC<ChatConversationListProps>;
 //# sourceMappingURL=ChatConversationList.d.ts.map

package/lib/typescript/module/components/ChatLauncher.d.ts

@@ -1,5 +1,5 @@
+import { type ChatLabels } from "@webority/markdown-core/chat";
 import type React from "react";
-import { type ChatLabels } from "../labels.js";
 export interface ChatLauncherProps {
     onPress: () => void;
     /** `end` (the default) or `start`: the bottom corner it sits in. */

package/lib/typescript/module/components/ChatMarkdown.d.ts

@@ -10,8 +10,15 @@ export interface ChatMarkdownProps<T = string> {
     resolveLink?: (href: string) => T | null | undefined;
     /** Opens what `resolveLink` returned. Without it, links show as plain text. */
     onLinkPress?: (target: T) => void;
+    /**
+     * Tells a citation marker (the bracketed inner text, e.g. `1` for `[1]`) from an ordinary link.
+     * A citation draws as a pressable marker and never as a link.
+     */
+    isCitation?: (inner: string) => boolean;
+    /** Opens the citation a reply marker names. Without it, citation markers show as plain text. */
+    onOpenCitation?: (citation: string) => void;
     testID?: string;
 }
 /** A reply never opens a web address, and its headings draw as bold lines, not large type. */
-export declare function ChatMarkdown<T = string>({ text, resolveLink, onLinkPress, testID }: ChatMarkdownProps<T>): React.ReactElement;
+export declare function ChatMarkdown<T = string>({ text, resolveLink, onLinkPress, isCitation, onOpenCitation, testID, }: ChatMarkdownProps<T>): React.ReactElement;
 //# sourceMappingURL=ChatMarkdown.d.ts.map

package/lib/typescript/module/components/ChatMessage.d.ts

@@ -1,6 +1,6 @@
+import type { ChatAttachment, ChatRating, SupportActionTicket } from "@webority/markdown-core/chat";
+import { type ChatLabels } from "@webority/markdown-core/chat";
 import type React from "react";
-import { type ChatLabels } from "../labels.js";
-import type { ChatRating, SupportActionTicket } from "../types.js";
 import type { ChatTurn } from "../useChat.js";
 /** The props a thread passes to each of its turns. */
 export interface ChatReplyProps<T = string> {
@@ -10,6 +10,12 @@ export interface ChatReplyProps<T = string> {
     resolveLink?: (href: string) => T | null | undefined;
     /** Opens what `resolveLink` returned. */
     onLinkPress?: (target: T) => void;
+    /** Tells a citation marker in a reply from an ordinary link; see `ChatMarkdown`. */
+    isCitation?: (inner: string) => boolean;
+    /** Opens the citation a reply marker names; see `ChatMarkdown`. */
+    onOpenCitation?: (citation: string) => void;
+    /** Sends a suggested follow-up question; shows the suggestions under the last answer. */
+    onAskSuggestion?: (text: string) => void;
     /** Shows support action cards; see `ActionCard`. */
     confirmAction?: (token: string) => Promise<SupportActionTicket>;
     onViewTicket?: (ticket: SupportActionTicket) => void;
@@ -20,19 +26,30 @@ export interface ChatReplyProps<T = string> {
     renderReply?: (turn: ChatTurn, state: {
         streaming: boolean;
     }) => React.ReactNode;
+    /** Sends a failed or stopped question again; shows Try again under it. */
+    onRetry?: (turnId: string) => void;
+    /** Asks for a new answer to this turn; shows New answer under the answer when `canRegenerate` is set. */
+    onRegenerate?: (turnId: string) => void;
+    /** Puts this question back in the box to edit; shows Edit under the question. */
+    onEdit?: (turnId: string) => void;
+    /** Opens an attached file from its chip under the question. */
+    onOpenAttachment?: (attachment: ChatAttachment) => void;
     labels?: Partial<ChatLabels>;
 }
 export interface ChatMessageProps<T = string> extends ChatReplyProps<T> {
     turn: ChatTurn;
+    /** Set on the one turn a New answer is offered for, normally the last answered turn. */
+    canRegenerate?: boolean;
     testID?: string;
 }
 /**
  * One turn on mobile-ui's chat parts: the person's question in a `MessageBubble` on the trailing
- * side, the typing dots while the answer has not started, then the answer in a bubble on the
- * leading side. The answer is announced once, when it finishes arriving. Support actions show
- * under the answer, and the rating once the reply is stored.
+ * side, with its files, a stopped note and Try again or Edit under it; the typing dots and the
+ * tool step while the answer has not started, then the answer in a bubble on the leading side.
+ * The answer is announced once, when it finishes arriving. Support actions show under the answer,
+ * and the rating once the reply is stored.
  */
-declare function ChatMessageView<T = string>({ turn, onRate, resolveLink, onLinkPress, confirmAction, onViewTicket, renderReply, labels: labelOverrides, testID, }: ChatMessageProps<T>): React.ReactElement;
+declare function ChatMessageView<T = string>({ turn, canRegenerate, onRetry, onRegenerate, onEdit, onOpenAttachment, onRate, resolveLink, onLinkPress, isCitation, onOpenCitation, onAskSuggestion, confirmAction, onViewTicket, renderReply, labels: labelOverrides, testID, }: ChatMessageProps<T>): React.ReactElement;
 export declare const ChatMessage: typeof ChatMessageView;
 export {};
 //# sourceMappingURL=ChatMessage.d.ts.map

package/lib/typescript/module/components/ChatScreen.d.ts

@@ -1,9 +1,14 @@
+import { type ChatAttachment, type ChatUploadFile } from "@webority/markdown-core/chat";
 import type React from "react";
 import type { UseChatResult } from "../useChat.js";
 import type { ChatReplyProps } from "./ChatMessage.js";
-export interface ChatScreenProps<T = string> extends Omit<ChatReplyProps<T>, "onRate"> {
+export interface ChatScreenProps<T = string> extends Omit<ChatReplyProps<T>, "onRate" | "onAskSuggestion"> {
     /** The `useChat` result. */
     chat: UseChatResult;
+    /** Opens the file picker. The attach button shows only with this and the chat's attachment settings. */
+    pickAttachments?: () => Promise<ChatUploadFile[]>;
+    /** Opens an attachment shown in a message. */
+    onOpenAttachment?: (attachment: ChatAttachment) => void;
     /** Header title. Defaults to the `panelTitle` label. */
     title?: string;
     /** Extra header controls before New chat, e.g. an "All chats" button. */
@@ -31,5 +36,5 @@ export interface ChatScreenProps<T = string> extends Omit<ChatReplyProps<T>, "on
  * box rides the keyboard and the newest turn stays above it. Place it in a stack screen and keep
  * the `useChat` call above the navigator, so the conversation survives leaving the screen.
  */
-export declare function ChatScreen<T = string>({ chat, title, headerActions, empty, disclaimer, maxLength, allowanceThreshold, rating, keyboardOffset, testID, ...reply }: ChatScreenProps<T>): React.ReactElement;
+export declare function ChatScreen<T = string>({ chat, pickAttachments, onOpenAttachment, title, headerActions, empty, disclaimer, maxLength, allowanceThreshold, rating, keyboardOffset, testID, ...reply }: ChatScreenProps<T>): React.ReactElement;
 //# sourceMappingURL=ChatScreen.d.ts.map

package/lib/typescript/module/components/ChatThread.d.ts

@@ -1,3 +1,4 @@
+import { type ChatAttachment } from "@webority/markdown-core/chat";
 import type React from "react";
 import { type StyleProp, type ViewStyle } from "react-native";
 import type { ChatTurn } from "../useChat.js";
@@ -10,6 +11,13 @@ export interface ChatThreadProps<T = string> extends ChatReplyProps<T> {
     keyboardAware?: boolean;
     /** The composer's `keyboardOffset`. Default: the bottom safe-area inset. */
     keyboardOffset?: number;
+    /** Asks a failed or stopped turn's question again. */
+    onRetry?: (turnId: string) => void;
+    /** Asks for a new answer; offered on the last answered turn only. */
+    onRegenerate?: (turnId: string) => void;
+    /** Puts a question back in the box to be edited. */
+    onEdit?: (turnId: string) => void;
+    onOpenAttachment?: (attachment: ChatAttachment) => void;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }
@@ -18,5 +26,5 @@ export interface ChatThreadProps<T = string> extends ChatReplyProps<T> {
  * streaming answer growing in place, a jump to the latest once scrolled up,
  * and the newest turn kept above the keyboard.
  */
-export declare function ChatThread<T = string>({ turns, empty, keyboardAware, keyboardOffset, style, testID, ...reply }: ChatThreadProps<T>): React.ReactElement;
+export declare function ChatThread<T = string>({ turns, empty, keyboardAware, keyboardOffset, onRetry, onRegenerate, onEdit, onOpenAttachment, onAskSuggestion, style, testID, ...reply }: ChatThreadProps<T>): React.ReactElement;
 //# sourceMappingURL=ChatThread.d.ts.map

package/lib/typescript/module/components/ComposerAttachments.d.ts

@@ -0,0 +1,12 @@
+import { type ChatLabels, type ComposerAttachment } from "@webority/markdown-core/chat";
+import type React from "react";
+export interface ComposerAttachmentsProps {
+    attachments: ComposerAttachment[];
+    /** Omit to show the files without remove buttons. */
+    onRemove?: (key: string) => void;
+    labels?: Partial<ChatLabels>;
+    testID?: string;
+}
+/** The files on the question being written: a chip per file, a progress bar while it uploads. */
+export declare const ComposerAttachments: React.FC<ComposerAttachmentsProps>;
+//# sourceMappingURL=ComposerAttachments.d.ts.map

package/lib/typescript/module/components/ReplyRating.d.ts

@@ -1,6 +1,6 @@
+import type { ChatRating } from "@webority/markdown-core/chat";
+import { type ChatLabels } from "@webority/markdown-core/chat";
 import type React from "react";
-import { type ChatLabels } from "../labels.js";
-import type { ChatRating } from "../types.js";
 export interface ReplyRatingProps {
     /** The rating already saved. */
     rating?: ChatRating | null;

package/lib/typescript/module/index.d.ts

@@ -1,5 +1,5 @@
-export type { ChatClient, ChatHttpClient, ChatHttpRequestConfig } from "./client.js";
-export { ChatApiError, createChatClient } from "./client.js";
+export type { ChatAbortSignal, ChatAttachment, ChatAttachmentLimits, ChatBlob, ChatClient, ChatEditing, ChatHttpClient, ChatHttpRequestConfig, ChatLabels, ChatRating, ChatRatingInput, ChatSession, ChatSessionOptions, ChatSessionState, ChatSettings, ChatStreamEventName, ChatStreamOptions, ChatTurnInput, ChatTurnResult, ChatUploadFile, ComposerAttachment, ComposerAttachmentStatus, Conversation, ConversationList, ConversationListOptions, ConversationListState, ConversationMessage, ConversationSummary, FrameScheduler, PagedDataObject, SseEvent, SseParser, SupportAction, SupportActionTicket, } from "@webority/markdown-core/chat";
+export { ChatApiError, createChatClient, createChatSession, createConversationList, createSseParser, DEFAULT_CHAT_LABELS, } from "@webority/markdown-core/chat";
 export type { ActionCardProps } from "./components/ActionCard.js";
 export { ActionCard } from "./components/ActionCard.js";
 export type { ChatComposerProps } from "./components/ChatComposer.js";
@@ -18,11 +18,6 @@ export type { ChatThreadProps } from "./components/ChatThread.js";
 export { ChatThread } from "./components/ChatThread.js";
 export type { ReplyRatingProps } from "./components/ReplyRating.js";
 export { ReplyRating } from "./components/ReplyRating.js";
-export type { ChatLabels } from "./labels.js";
-export { DEFAULT_CHAT_LABELS } from "./labels.js";
-export type { SseEvent, SseParser } from "./sse.js";
-export { createSseParser } from "./sse.js";
-export type { ChatRating, ChatRatingInput, ChatStreamEventName, ChatStreamOptions, ChatTurnInput, ChatTurnResult, Conversation, ConversationMessage, ConversationSummary, SupportAction, SupportActionTicket, } from "./types.js";
 export type { ChatTurn, ChatTurnError, UseChatOptions, UseChatResult } from "./useChat.js";
 export { useChat } from "./useChat.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/useChat.d.ts

@@ -1,63 +1,19 @@
-import type { ChatClient } from "./client.js";
-import type { ChatRating, SupportAction } from "./types.js";
-export interface ChatTurnError {
-    code: string;
-    /** Written for the person. */
-    message: string;
-    resetsAtUtc: string | null;
-}
-/** One question and its answer. */
-export interface ChatTurn {
-    /** Local key; for a reopened conversation, the stored message's id. */
-    id: string;
-    question: string;
-    /** What is shown: the streamed text, then the reply of record. */
-    answer: string;
-    streaming: boolean;
-    error: ChatTurnError | null;
-    actions: SupportAction[];
-    /** The stored reply's id; rating needs it. */
-    messageId: string | null;
-    rating: ChatRating | null;
-    ratingNote: string | null;
-}
+import type { ChatClient, ChatSession, ChatSessionState } from "@webority/markdown-core/chat";
+export type { ChatTurn, ChatTurnError } from "@webority/markdown-core/chat";
 export interface UseChatOptions {
     /** From `createChatClient`. */
     client: ChatClient;
     /** Sent with each question; read at the moment of sending. */
     pageContext?: unknown;
 }
-export interface UseChatResult {
-    /** Oldest first. */
-    turns: ChatTurn[];
-    /** The conversation being continued, or null. */
-    conversationId: string | null;
-    /** From the last answer or `refreshAllowance()`; null with no daily limit. */
-    messagesLeftToday: number | null;
-    /** An answer is arriving. */
-    streaming: boolean;
-    /** `openConversation` is loading. */
-    loading: boolean;
-    /** `openConversation` failed. */
-    loadError: ChatTurnError | null;
-    /** Asks a question. Ignored while an answer is still arriving. */
-    submit: (message: string) => Promise<void>;
-    /** Replaces the thread with a stored conversation. */
-    openConversation: (id: string) => Promise<void>;
-    /** Clears the thread; the next question starts a conversation. */
-    newConversation: () => void;
-    /** Saves a rating, shown at once; a failed save puts the old one back and rejects. */
-    rate: (turnId: string, rating: ChatRating, note?: string) => Promise<void>;
-    /** Reads the questions left today. */
-    refreshAllowance: () => Promise<void>;
-    /** Clears everything, for sign-out or an account switch. */
-    reset: () => void;
-}
+type ChatActions = Pick<ChatSession, "submit" | "stop" | "retry" | "regenerate" | "startEdit" | "cancelEdit" | "attach" | "removeAttachment" | "openConversation" | "newConversation" | "rate" | "refreshAllowance" | "reset">;
+export type UseChatResult = ChatSessionState & ChatActions & {
+    client: ChatClient;
+};
 /**
- * The chat's state and actions, with no store of its own: it lives in the component that calls
- * it. Call `reset()` when the signed-in person or account changes so nothing of one person's chat
- * shows to the next. An answer still streaming is cancelled on `reset`, `newConversation`,
- * `openConversation` and unmount.
+ * The chat's state and actions. The session lives in the component that calls it: one per client,
+ * disposed when the client changes or the component unmounts. Call `reset()` when the signed-in
+ * person or account changes so nothing of one person's chat shows to the next.
  */
 export declare const useChat: ({ client, pageContext }: UseChatOptions) => UseChatResult;
 //# sourceMappingURL=useChat.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webority/mobile-chat",
-  "version": "0.122.0",
+  "version": "0.125.0",
   "description": "AI assistant chat for Webority React Native apps: a streaming chat client, a store-agnostic chat hook, and the chat screen, thread, composer, past chats, reply rating and support action cards, built on @webority/mobile-ui.",
   "keywords": [
     "react-native",
@@ -42,11 +42,12 @@
     "!**/*.map"
   ],
   "dependencies": {
-    "@webority/markdown-core": "0.122.0"
+    "@webority/markdown-core": "0.125.0"
   },
   "peerDependencies": {
-    "@webority/mobile-core": "0.122.0",
-    "@webority/mobile-ui": "0.122.0",
+    "@webority/mobile-core": "0.125.0",
+    "@webority/mobile-ui": "0.125.0",
+    "expo-clipboard": ">=57.0.0",
     "react": "^19.1.0",
     "react-native": ">=0.81.0",
     "react-native-keyboard-controller": ">=1.21.9",
@@ -87,9 +88,9 @@
     "@react-native/metro-config": "0.86.3",
     "@testing-library/react-native": "12.9.0",
     "@types/react": "19.2.18",
-    "@webority/mobile-core": "0.122.0",
+    "@webority/mobile-core": "0.125.0",
     "@webority/mobile-dev": "0.0.0",
-    "@webority/mobile-ui": "0.122.0",
+    "@webority/mobile-ui": "0.125.0",
     "jest": "29.7.0",
     "react": "19.2.8",
     "react-native": "0.86.3",

package/lib/commonjs/client.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.createChatClient=exports.ChatApiError=void 0;var _sse=require("./sse.js");const FALLBACK_MESSAGE="Something went wrong. Please try again.";class ChatApiError extends Error{constructor(e,t,r,s=null){super(t),this.name="ChatApiError",this.code=e,this.status=r,this.resetsAtUtc=s}}exports.ChatApiError=ChatApiError;const parseBody=e=>{if("string"==typeof e)try{return JSON.parse(e)}catch{return null}return e??null},isCancel=(e,t)=>Boolean(t?.aborted)||"ERR_CANCELED"===e?.code||"CanceledError"===e?.name||"AbortError"===e?.name,toChatApiError=(e,t)=>{if(e instanceof ChatApiError)return e;const r=e;if(isCancel(r,t))return new ChatApiError("aborted","The request was cancelled.");const s=r?.response;if(!s)return new ChatApiError("network",FALLBACK_MESSAGE);const n=parseBody(s.data),a="string"==typeof n?.code&&n.code?n.code:"unknown",o="string"==typeof n?.message&&n.message?n.message:FALLBACK_MESSAGE,i="string"==typeof n?.resetsAtUtc?n.resetsAtUtc:null,c="number"==typeof s.status?s.status:void 0;return new ChatApiError(a,o,c,i)},call=async e=>{try{return(await e()).data}catch(e){throw toChatApiError(e)}},receivedText=e=>{const t=e?.event,r=t?.target;if(r&&"string"==typeof r.responseText&&("number"!=typeof r.status||!(r.status<200||r.status>=300)))return r.responseText},createChatClient=(e,{base:t})=>{if("string"!=typeof t||""===t.trim())throw new TypeError('createChatClient needs a base path, e.g. { base: "/api/assistant" }.');const r=t.replace(/\/+$/,""),conversationUrl=e=>`${r}/conversations/${encodeURIComponent(e)}`;return{sendMessage:async({message:t,conversationId:s,pageContext:n},{signal:a,onEvent:o}={})=>{let i=null,c=null;const l=(0,_sse.createSseParser)(({name:e,data:t})=>{i||c||("done"===e?i=t:"error"===e?c=t??{}:"delta"!==e&&"reset"!==e&&"actions"!==e||o?.(e,t))});let p=0;const read=e=>{"string"!=typeof e||e.length<=p||(l.push(e.slice(p)),p=e.length)},u={message:t};let h;s&&(u.conversationId=s),null!=n&&(u.pageContext=n);try{h=await e.post(`${r}/chat`,u,{responseType:"text",headers:{Accept:"text/event-stream"},signal:a,onDownloadProgress:e=>read(receivedText(e))})}catch(e){throw toChatApiError(e,a)}read(h.data),l.end();const C=c;if(C)throw new ChatApiError(C.code||"unknown",C.message||FALLBACK_MESSAGE);const g=i;if(!g)throw new ChatApiError("invalid-response",FALLBACK_MESSAGE,h.status);return g},getAllowance:()=>call(()=>e.get(`${r}/allowance`)),listConversations:({skip:t,take:s}={})=>{const n=[];return null!=t&&n.push(`skip=${t}`),null!=s&&n.push(`take=${s}`),call(()=>e.get(`${r}/conversations${n.length?`?${n.join("&")}`:""}`))},getConversation:t=>call(()=>e.get(conversationUrl(t))),deleteConversation:async t=>{await call(()=>e.delete(conversationUrl(t)))},rateMessage:async(t,r,{rating:s,note:n})=>{const a="string"==typeof n?n.trim():"";await call(()=>e.put(`${conversationUrl(t)}/messages/${encodeURIComponent(r)}/rating`,{rating:s,note:a||null}))}}};exports.createChatClient=createChatClient;

package/lib/commonjs/labels.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.mergeLabels=exports.DEFAULT_CHAT_LABELS=void 0;const DEFAULT_CHAT_LABELS=exports.DEFAULT_CHAT_LABELS=Object.freeze({launcher:"Ask the assistant",panelTitle:"Assistant",newChat:"New chat",close:"Close",thread:"Conversation",you:"You",assistant:"Assistant",thinking:"Thinking",emptyTitle:"How can I help?",emptyText:"Ask a question about what you see on this page.",composer:"Your question",placeholder:"Ask a question",send:"Send",composerHint:"Press Enter to send, Shift and Enter for a new line.",allowance:e=>0===e?"You have no questions left today.":1===e?"You have 1 question left today.":`You have ${e} questions left today.`,disclaimer:"Answers are written by AI and can be wrong. Check anything important.",loadingConversation:"Loading the conversation",rateUp:"Helpful",rateDown:"Not helpful",rated:"Thanks for the feedback.",ratingNote:"What was wrong with this answer?",ratingNoteHint:"Optional.",ratingNoteSend:"Send",ratingNoteSkip:"Skip",ratingFailed:"Your rating did not save. Please try again.",actionRaiseTicket:"New support ticket",actionReply:e=>`Reply on ${e}`,actionReopen:e=>`Reopen ${e}`,actionNote:"Nothing is sent until you confirm.",actionConfirm:"Confirm",actionDismiss:"Not now",actionDismissed:"Not sent.",actionExpired:"This request expired and was not sent. Ask again if you still need it.",actionFailed:"We could not send this. Please try again.",actionDoneRaiseTicket:e=>`Ticket ${e} raised.`,actionDoneReply:e=>`Your reply was added to ${e}.`,actionDoneReopen:e=>`${e} is open again.`,viewTicket:"View ticket",conversations:"Past chats",conversationsEmptyTitle:"No past chats",conversationsEmptyText:"Your conversations with the assistant show here.",untitled:"Untitled chat",deleteConversation:"Delete chat",deleteConfirmTitle:"Delete this chat?",deleteConfirmMessage:"The conversation is removed for good.",deleteConfirm:"Delete",deleteFailed:"We could not delete this chat. Please try again.",cancel:"Cancel",loadMore:"Show more",loadFailed:"We could not load your chats. Please try again.",retry:"Try again"}),mergeLabels=e=>e?{...DEFAULT_CHAT_LABELS,...e}:DEFAULT_CHAT_LABELS;exports.mergeLabels=mergeLabels;

package/lib/commonjs/sse.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.createSseParser=void 0;const createSseParser=e=>{let t="";const dispatch=t=>{let r="message";const s=[];for(const e of t.split("\n")){if(""===e||e.startsWith(":"))continue;const t=e.indexOf(":"),n=-1===t?e:e.slice(0,t);let a=-1===t?"":e.slice(t+1);a.startsWith(" ")&&(a=a.slice(1)),"event"===n?r=a:"data"===n&&s.push(a)}if(0===s.length)return;let n;try{n=JSON.parse(s.join("\n"))}catch{return void e({name:"error",data:{code:"invalid-response",message:null}})}e({name:r,data:n})};return{push(e){if(!e)return;t=(t+e).replace(/\r\n/g,"\n").replace(/\r(?!$)/g,"\n");const r=t.split("\n\n");t=r.pop()??"";for(const e of r)dispatch(e)},end(){const e=t.replace(/\r$/,"");t="",e.trim()&&dispatch(e)}}};exports.createSseParser=createSseParser;

package/lib/commonjs/types.js

@@ -1 +0,0 @@
-"use strict";

package/lib/module/client.js

@@ -1 +0,0 @@
-"use strict";import{createSseParser}from"./sse.js";const FALLBACK_MESSAGE="Something went wrong. Please try again.";export class ChatApiError extends Error{constructor(e,t,r,s=null){super(t),this.name="ChatApiError",this.code=e,this.status=r,this.resetsAtUtc=s}}const parseBody=e=>{if("string"==typeof e)try{return JSON.parse(e)}catch{return null}return e??null},isCancel=(e,t)=>Boolean(t?.aborted)||"ERR_CANCELED"===e?.code||"CanceledError"===e?.name||"AbortError"===e?.name,toChatApiError=(e,t)=>{if(e instanceof ChatApiError)return e;const r=e;if(isCancel(r,t))return new ChatApiError("aborted","The request was cancelled.");const s=r?.response;if(!s)return new ChatApiError("network",FALLBACK_MESSAGE);const n=parseBody(s.data),a="string"==typeof n?.code&&n.code?n.code:"unknown",o="string"==typeof n?.message&&n.message?n.message:FALLBACK_MESSAGE,i="string"==typeof n?.resetsAtUtc?n.resetsAtUtc:null,c="number"==typeof s.status?s.status:void 0;return new ChatApiError(a,o,c,i)},call=async e=>{try{return(await e()).data}catch(e){throw toChatApiError(e)}},receivedText=e=>{const t=e?.event,r=t?.target;if(r&&"string"==typeof r.responseText&&("number"!=typeof r.status||!(r.status<200||r.status>=300)))return r.responseText};export const createChatClient=(e,{base:t})=>{if("string"!=typeof t||""===t.trim())throw new TypeError('createChatClient needs a base path, e.g. { base: "/api/assistant" }.');const r=t.replace(/\/+$/,""),conversationUrl=e=>`${r}/conversations/${encodeURIComponent(e)}`;return{sendMessage:async({message:t,conversationId:s,pageContext:n},{signal:a,onEvent:o}={})=>{let i=null,c=null;const l=createSseParser(({name:e,data:t})=>{i||c||("done"===e?i=t:"error"===e?c=t??{}:"delta"!==e&&"reset"!==e&&"actions"!==e||o?.(e,t))});let p=0;const read=e=>{"string"!=typeof e||e.length<=p||(l.push(e.slice(p)),p=e.length)},u={message:t};let g;s&&(u.conversationId=s),null!=n&&(u.pageContext=n);try{g=await e.post(`${r}/chat`,u,{responseType:"text",headers:{Accept:"text/event-stream"},signal:a,onDownloadProgress:e=>read(receivedText(e))})}catch(e){throw toChatApiError(e,a)}read(g.data),l.end();const h=c;if(h)throw new ChatApiError(h.code||"unknown",h.message||FALLBACK_MESSAGE);const d=i;if(!d)throw new ChatApiError("invalid-response",FALLBACK_MESSAGE,g.status);return d},getAllowance:()=>call(()=>e.get(`${r}/allowance`)),listConversations:({skip:t,take:s}={})=>{const n=[];return null!=t&&n.push(`skip=${t}`),null!=s&&n.push(`take=${s}`),call(()=>e.get(`${r}/conversations${n.length?`?${n.join("&")}`:""}`))},getConversation:t=>call(()=>e.get(conversationUrl(t))),deleteConversation:async t=>{await call(()=>e.delete(conversationUrl(t)))},rateMessage:async(t,r,{rating:s,note:n})=>{const a="string"==typeof n?n.trim():"";await call(()=>e.put(`${conversationUrl(t)}/messages/${encodeURIComponent(r)}/rating`,{rating:s,note:a||null}))}}};