@bitbaum/chatkit 0.18.1 → 0.20.0

package/dist/react/use-attachments.js

@@ -39,72 +39,18 @@ export function useAttachments(limits = {}, notes = {}) {
             return prev;
         return [...prev, item];
     }), [maxFiles]);
-    const stageImage = useCallback((file) => {
-        const name = file.name || "screenshot.png";
-        if (!isImageMime(file.type)) {
-            setNote(say.current.wrongType(name));
-            return;
-        }
-        const tooLarge = () => setNote(say.current.imageTooLarge(name, Math.round(maxImageBytes / 1_000_000)));
-        if (maxImageEdge > 0) {
-            // Shrink first, then judge the size: a 4 MB screenshot is fine once it
-            // is the 300 KB it needed to be.
-            shrink(file, maxImageEdge, maxImageBytes)
-                .then((dataUrl) => {
-                if (!dataUrl) {
-                    tooLarge();
-                    return;
-                }
-                const previewUrl = URL.createObjectURL(file);
-                previews.current.add(previewUrl);
-                add({
-                    kind: "image",
-                    name: name.replace(/\.(png|gif|webp|jpe?g)$/i, "") + ".jpg",
-                    mimeType: "image/jpeg",
-                    dataBase64: stripDataUrlBase64(dataUrl),
-                    previewUrl,
-                });
-            })
-                .catch(() => setNote(say.current.unreadable(name)));
-            return;
-        }
-        if (file.size > maxImageBytes) {
-            tooLarge();
-            return;
-        }
-        const reader = new FileReader();
-        reader.onload = () => {
-            const previewUrl = URL.createObjectURL(file);
-            previews.current.add(previewUrl);
-            add({
-                kind: "image",
-                name,
-                mimeType: file.type,
-                dataBase64: stripDataUrlBase64(String(reader.result ?? "")),
-                previewUrl,
-            });
-        };
-        reader.onerror = () => setNote(say.current.unreadable(name));
-        reader.readAsDataURL(file);
-    }, [add, maxImageBytes, maxImageEdge]);
-    const stageText = useCallback((file) => {
-        if (!isTextFile(file.name, file.type)) {
-            setNote(say.current.wrongType(file.name));
-            return;
-        }
-        if (file.size > maxTextChars) {
-            setNote(say.current.textTooLarge(file.name, Math.round(maxTextChars / 1000)));
-            return;
-        }
-        const reader = new FileReader();
-        reader.onload = () => add({
-            kind: "text",
-            name: file.name,
-            content: String(reader.result ?? "").slice(0, maxTextChars),
+    const stage = useCallback((file) => {
+        const limits = { maxFiles, maxImageBytes, maxImageEdge, maxTextChars };
+        void readAttachmentFile(file, limits, say.current, { preview: true }).then((read) => {
+            if (read.note !== undefined) {
+                setNote(read.note);
+                return;
+            }
+            if (read.attachment.previewUrl)
+                previews.current.add(read.attachment.previewUrl);
+            add(read.attachment);
         });
-        reader.onerror = () => setNote(say.current.unreadable(file.name));
-        reader.readAsText(file);
-    }, [add, maxTextChars]);
+    }, [add, maxFiles, maxImageBytes, maxImageEdge, maxTextChars]);
     const addFiles = useCallback((files) => {
         if (!files)
             return;
@@ -115,12 +61,9 @@ export function useAttachments(limits = {}, notes = {}) {
             return;
         }
         for (const file of Array.from(files).slice(0, room)) {
-            if (isImageMime(file.type))
-                stageImage(file);
-            else
-                stageText(file);
+            stage(file);
         }
-    }, [maxFiles, stageImage, stageText]);
+    }, [maxFiles, stage]);
     const addFromPaste = useCallback((e) => {
         const items = e.clipboardData?.items;
         if (!items)
@@ -132,10 +75,10 @@ export function useAttachments(limits = {}, notes = {}) {
         for (const item of images) {
             const file = item.getAsFile();
             if (file)
-                stageImage(file);
+                stage(file);
         }
         return true;
-    }, [stageImage]);
+    }, [stage]);
     const revoke = (a) => {
         if (!a.previewUrl)
             return;
@@ -171,4 +114,78 @@ export function useAttachments(limits = {}, notes = {}) {
         limits: lim,
     };
 }
+/**
+ * One file read the way the composer stages it: an image shrunk to
+ * `maxImageEdge` and judged by its size after that, a text file read up to
+ * `maxTextChars`, anything else refused — with the reason as a sentence from
+ * `notes`, never a throw. `preview: true` adds an object URL the caller must
+ * revoke. `useAttachments` and `ChatApp`'s `send` both read files through it.
+ */
+export async function readAttachmentFile(file, limits = {}, notes = {}, { preview = false } = {}) {
+    const { maxImageBytes, maxTextChars, maxImageEdge } = { ...DEFAULT_ATTACHMENT_LIMITS, ...limits };
+    const say = { ...DEFAULT_ATTACHMENT_NOTES, ...notes };
+    const previewOf = () => (preview ? URL.createObjectURL(file) : undefined);
+    if (isImageMime(file.type)) {
+        const name = file.name || "screenshot.png";
+        const tooLarge = { note: say.imageTooLarge(name, Math.round(maxImageBytes / 1_000_000)) };
+        try {
+            if (maxImageEdge > 0) {
+                // Shrink first, then judge the size: a 4 MB screenshot is fine once it
+                // is the 300 KB it needed to be.
+                const dataUrl = await shrink(file, maxImageEdge, maxImageBytes);
+                if (!dataUrl)
+                    return tooLarge;
+                return {
+                    attachment: {
+                        kind: "image",
+                        name: name.replace(/\.(png|gif|webp|jpe?g)$/i, "") + ".jpg",
+                        mimeType: "image/jpeg",
+                        dataBase64: stripDataUrlBase64(dataUrl),
+                        previewUrl: previewOf(),
+                    },
+                };
+            }
+            if (file.size > maxImageBytes)
+                return tooLarge;
+            const dataUrl = await readAs(file, "dataUrl");
+            return {
+                attachment: {
+                    kind: "image",
+                    name,
+                    mimeType: file.type,
+                    dataBase64: stripDataUrlBase64(dataUrl),
+                    previewUrl: previewOf(),
+                },
+            };
+        }
+        catch {
+            return { note: say.unreadable(name) };
+        }
+    }
+    if (!isTextFile(file.name, file.type))
+        return { note: say.wrongType(file.name) };
+    if (file.size > maxTextChars) {
+        return { note: say.textTooLarge(file.name, Math.round(maxTextChars / 1000)) };
+    }
+    try {
+        const content = await readAs(file, "text");
+        return {
+            attachment: { kind: "text", name: file.name, content: content.slice(0, maxTextChars) },
+        };
+    }
+    catch {
+        return { note: say.unreadable(file.name) };
+    }
+}
+function readAs(file, as) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(String(reader.result ?? ""));
+        reader.onerror = () => reject(reader.error);
+        if (as === "text")
+            reader.readAsText(file);
+        else
+            reader.readAsDataURL(file);
+    });
+}
 //# sourceMappingURL=use-attachments.js.map

package/dist/react/use-attachments.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-attachments.js","sourceRoot":"","sources":["../../src/react/use-attachments.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-attachments.js","sourceRoot":"","sources":["../../src/react/use-attachments.ts"],"names":[],"mappings":"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"}

package/dist/react/use-chat-app.d.ts

@@ -1,10 +1,14 @@
 import type { Attachment } from "../attachments.js";
 import { type ConversationStore, type ConversationSummary } from "../conversations.js";
-import type { ChatMessageData, LiveTurn } from "./Thread.js";
+import type { ChatFailure, ChatMessageData, LiveTurn, MessageChip } from "./Thread.js";
 /** One turn, as ChatApp hands it to the product. */
 export type ChatTurn = {
     /** The stored conversation, or null in a temporary chat (nothing is kept). */
     conversationId: string | null;
+    /** This chat's id on the page: the stored id, or — in a temporary chat — a
+     *  page-only id, the one `onTemporaryEnd` names when the chat ends. A
+     *  product that keeps a hidden server row for a temporary chat keys it here. */
+    chatId: string;
     temporary: boolean;
     /** What the person wrote (or the composer's attachment-only words). */
     text: string;
@@ -16,6 +20,38 @@ export type ChatTurn = {
     /** What has arrived so far — the WHOLE text each time, a status line before
      *  the first word, the steps taken. Call it as often as you like. */
     update: (live: LiveTurn) => void;
+    /** Whether Stop keeps what has arrived for THIS turn, overriding ChatApp's
+     *  `stopKeepsPartial` — `false` while the text so far is unchecked (Heidi's
+     *  variety gate), `true` once it is. Call it any time before the turn ends. */
+    stopKeepsPartial: (keep: boolean) => void;
+};
+/**
+ * Throw this from a transport to say why a turn failed in the reader's
+ * words: the failed bubble shows `message`, and `kind` (the product's own
+ * code, e.g. "quota" or "no-vision") travels with that message as
+ * `failure.kind` for a footer to link the fix. Any other error shows the
+ * thread's `failed` label — a raw `TypeError: Failed to fetch` is never
+ * shown to a reader — unless ChatApp's `failureMessage` maps it.
+ */
+export declare class ChatTurnError extends Error {
+    readonly kind?: string;
+    constructor(message: string, options?: {
+        kind?: string;
+        cause?: unknown;
+    });
+}
+/**
+ * What a failed turn keeps: a `ChatTurnError`'s words and kind, a plain
+ * `{ message, kind }` object as thrown, or what `map` makes of anything
+ * else. Never an ordinary Error's message — that is for the console.
+ */
+export declare function chatTurnFailure(error: unknown, map?: (error: unknown) => string | null | undefined): ChatFailure;
+/** How a page sends for the person (`ChatAppHandle.send`). */
+export type SendOptions = {
+    /** Start a new chat for it instead of adding to the open one. */
+    newChat?: boolean;
+    /** The product's own things shown on the person's message (see `MessageChip`). */
+    chips?: readonly MessageChip[];
 };
 /** The answer: its words, or the whole message (replies, citations, thinking…). */
 export type ChatTurnResult = string | (Omit<ChatMessageData, "id" | "role"> & {
@@ -32,6 +68,7 @@ type Queued = {
     conversation: string;
     text: string;
     attachments: Attachment[];
+    chips?: readonly MessageChip[];
 };
 export declare const isTemporaryId: (id: string | null | undefined) => boolean;
 export type UseChatAppOptions = {
@@ -44,15 +81,28 @@ export type UseChatAppOptions = {
     conversationId?: string | null;
     onConversationChange?: (id: string | null) => void;
     rememberKey: string | null;
+    /** Stop keeps the half answer that had arrived. Default true. */
+    stopKeepsPartial?: boolean;
+    /** The words for a failed turn whose error is not a `ChatTurnError`. */
+    failureMessage?: (error: unknown) => string | null | undefined;
+    /** A temporary chat ended: left for a new or another chat, the page hidden
+     *  or ChatApp unmounted. Called once per chat, with `turn.chatId`. */
+    onTemporaryEnd?: (chatId: string) => void;
+    /** Reopen the chat from before the reload. False when the page arrives
+     *  with a message to send (it starts a new chat). Default true. */
+    restore?: boolean;
 };
 /**
  * Everything ChatApp does that is not drawing: the list, the open chat, new
  * and temporary chats, turns (one per conversation, each running on when the
  * person opens another chat), the queue, titles and the reopen-on-reload.
  */
-export declare function useChatApp({ store, transport, makeTitle, conversationId, onConversationChange, rememberKey, }: UseChatAppOptions): {
+export declare function useChatApp({ store, transport, makeTitle, conversationId, onConversationChange, rememberKey, stopKeepsPartial, failureMessage, onTemporaryEnd, restore, }: UseChatAppOptions): {
     list: ConversationSummary[];
     listState: "error" | "loading" | "ready";
+    /** The list has loaded (or failed) and the reopened chat is chosen. */
+    ready: boolean;
+    whenReady: () => Promise<void>;
     reloadList: () => void;
     activeId: string | null;
     stored: string | null;
@@ -67,7 +117,7 @@ export declare function useChatApp({ store, transport, makeTitle, conversationId
     unqueue: (qid: string) => void;
     problem: ChatAppProblem | null;
     clearProblem: () => void;
-    send: (text: string, attachments?: Attachment[]) => Promise<boolean>;
+    send: (text: string, attachments?: Attachment[], options?: SendOptions) => Promise<boolean>;
     stop: () => void;
     retry: () => void;
     open: (id: string) => void;

package/dist/react/use-chat-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-chat-app.d.ts","sourceRoot":"","sources":["../../src/react/use-chat-app.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EAEzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE7D,oDAAoD;AACpD,MAAM,MAAM,QAAQ,GAAG;IACrB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,mEAAmE;IACnE,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,+EAA+E;IAC/E,MAAM,EAAE,WAAW,CAAC;IACpB;yEACqE;IACrE,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEnG;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAExE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD,KAAK,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAG5F,eAAO,MAAM,aAAa,GAAI,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,YAAsC,CAAC;AA6BlG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,aAAa,CAAC;IACzB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChG,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,oBAAoB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,SAAS,EACT,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,WAAW,GACZ,EAAE,iBAAiB;;;;;;;;;;;;;;mBAiUD,MAAM;;;iBAvGG,MAAM,gBAAe,UAAU,EAAE,KAAQ,OAAO,CAAC,OAAO,CAAC;;;eAnKjE,MAAM;;;iBAgOE,MAAM,SAAS,MAAM;iBASrB,MAAM;EA6CjC;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC"}
+{"version":3,"file":"use-chat-app.d.ts","sourceRoot":"","sources":["../../src/react/use-chat-app.ts"],"names":[],"mappings":"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"}

package/dist/react/use-chat-app.js

@@ -1,6 +1,45 @@
 "use client";
 import { useEffect, useRef, useState } from "react";
 import { deriveTitle, newId, pickRestored, } from "../conversations.js";
+/**
+ * Throw this from a transport to say why a turn failed in the reader's
+ * words: the failed bubble shows `message`, and `kind` (the product's own
+ * code, e.g. "quota" or "no-vision") travels with that message as
+ * `failure.kind` for a footer to link the fix. Any other error shows the
+ * thread's `failed` label — a raw `TypeError: Failed to fetch` is never
+ * shown to a reader — unless ChatApp's `failureMessage` maps it.
+ */
+export class ChatTurnError extends Error {
+    kind;
+    constructor(message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = "ChatTurnError";
+        this.kind = options.kind;
+    }
+}
+/**
+ * What a failed turn keeps: a `ChatTurnError`'s words and kind, a plain
+ * `{ message, kind }` object as thrown, or what `map` makes of anything
+ * else. Never an ordinary Error's message — that is for the console.
+ */
+export function chatTurnFailure(error, map) {
+    if (error instanceof ChatTurnError) {
+        return { message: error.message, ...(error.kind ? { kind: error.kind } : {}) };
+    }
+    const mapped = map?.(error);
+    if (mapped)
+        return { message: mapped };
+    if (error && typeof error === "object" && !(error instanceof Error)) {
+        const { message, kind } = error;
+        const out = {};
+        if (typeof message === "string" && message.trim())
+            out.message = message;
+        if (typeof kind === "string" && kind)
+            out.kind = kind;
+        return out;
+    }
+    return {};
+}
 const TEMP = "tmp";
 export const isTemporaryId = (id) => !!id && id.startsWith(`${TEMP}-`);
 function messageAttachments(list) {
@@ -38,7 +77,7 @@ function writeRemembered(key, id) {
  * and temporary chats, turns (one per conversation, each running on when the
  * person opens another chat), the queue, titles and the reopen-on-reload.
  */
-export function useChatApp({ store, transport, makeTitle, conversationId, onConversationChange, rememberKey, }) {
+export function useChatApp({ store, transport, makeTitle, conversationId, onConversationChange, rememberKey, stopKeepsPartial = true, failureMessage, onTemporaryEnd, restore = true, }) {
     const [list, setList] = useState([]);
     const [listState, setListState] = useState("loading");
     const [activeId, setActiveId] = useState(null);
@@ -50,6 +89,7 @@ export function useChatApp({ store, transport, makeTitle, conversationId, onConv
     const [queue, setQueue] = useState([]);
     const [problem, setProblem] = useState(null);
     const [reload, setReload] = useState(0);
+    const [ready, setReady] = useState(false);
     // Async work reads the CURRENT state through these, never a stale closure.
     const threadsRef = useRef(threads);
     const queueRef = useRef(queue);
@@ -59,10 +99,32 @@ export function useChatApp({ store, transport, makeTitle, conversationId, onConv
     const restored = useRef(false);
     const transportRef = useRef(transport);
     const titleRef = useRef(makeTitle);
+    const optionsRef = useRef({ stopKeepsPartial, failureMessage, onTemporaryEnd });
     useEffect(() => {
         transportRef.current = transport;
         titleRef.current = makeTitle;
+        optionsRef.current = { stopKeepsPartial, failureMessage, onTemporaryEnd };
     });
+    // The files of each person's message, by its id, kept until its answer
+    // lands: Retry after a failure sends the pictures again, not only the words.
+    const turnFiles = useRef(new Map());
+    const ended = useRef(new Set());
+    const readyWaiters = useRef([]);
+    const markReady = () => {
+        restored.current = true;
+        setReady(true);
+        for (const go of readyWaiters.current.splice(0))
+            go();
+    };
+    /** Resolves once the list has loaded and the reopened chat is chosen, so a
+     *  message sent from outside never lands before the restore moves away. */
+    const whenReady = () => restored.current ? Promise.resolve() : new Promise((go) => readyWaiters.current.push(go));
+    const endTemporary = (id) => {
+        if (!isTemporaryId(id) || ended.current.has(id))
+            return;
+        ended.current.add(id);
+        optionsRef.current.onTemporaryEnd?.(id);
+    };
     const setThreadsNow = (fn) => {
         threadsRef.current = fn(threadsRef.current);
         setThreads(threadsRef.current);
@@ -83,13 +145,28 @@ export function useChatApp({ store, transport, makeTitle, conversationId, onConv
         if (!isTemporaryId(id))
             return;
         controllers.current.get(id)?.abort();
+        for (const m of threadsRef.current[id] ?? [])
+            turnFiles.current.delete(m.id);
         setThreadsNow((t) => {
             const next = { ...t };
             delete next[id];
             return next;
         });
         setQueueNow((q) => q.filter((item) => item.conversation !== id));
+        endTemporary(id);
     };
+    // A temporary chat also ends when the page goes away or ChatApp unmounts.
+    // (StrictMode's rehearsal unmount finds no temporary chat: one only exists
+    // after a first message.)
+    useEffect(() => {
+        const hide = () => endTemporary(activeRef.current);
+        globalThis.addEventListener?.("pagehide", hide);
+        return () => {
+            globalThis.removeEventListener?.("pagehide", hide);
+            hide();
+        };
+        // Reads everything through refs.
+    }, []);
     const open = (id) => {
         if (id === activeRef.current)
             return;
@@ -126,17 +203,21 @@ export function useChatApp({ store, transport, makeTitle, conversationId, onConv
             setList(rows);
             setListState("ready");
             if (!restored.current) {
-                restored.current = true;
-                const id = pickRestored(rows, conversationId, readRemembered(rememberKey));
-                if (id)
+                const id = restore
+                    ? pickRestored(rows, conversationId, readRemembered(rememberKey))
+                    : null;
+                // An outside send may already have opened a chat: never move off it.
+                if (id && activeRef.current === null)
                     open(id);
+                markReady();
             }
         })
             .catch(() => {
             if (!alive)
                 return;
-            restored.current = true;
             setListState("error");
+            if (!restored.current)
+                markReady();
         });
         return () => {
             alive = false;
@@ -181,9 +262,12 @@ export function useChatApp({ store, transport, makeTitle, conversationId, onConv
         setLive((l) => ({ ...l, [id]: {} }));
         let soFar = {};
         let ok = false;
+        let keepPartial = null;
+        const asked = [...(threadsRef.current[id] ?? [])].reverse().find((m) => m.role === "user");
         try {
             const result = await transportRef.current({
                 conversationId: temp ? null : id,
+                chatId: id,
                 temporary: temp,
                 text,
                 attachments,
@@ -194,6 +278,9 @@ export function useChatApp({ store, transport, makeTitle, conversationId, onConv
                     if (!controller.signal.aborted)
                         setLive((l) => (id in l ? { ...l, [id]: soFar } : l));
                 },
+                stopKeepsPartial: (keep) => {
+                    keepPartial = keep;
+                },
             });
             if (controller.signal.aborted)
                 throw new DOMException("stopped", "AbortError");
@@ -202,6 +289,8 @@ export function useChatApp({ store, transport, makeTitle, conversationId, onConv
             push(id, message);
             save(id, message);
             ok = true;
+            if (asked)
+                turnFiles.current.delete(asked.id);
             if (!temp && history.length === 0 && titleRef.current) {
                 void Promise.resolve(titleRef.current({ text, answer: answer.content }))
                     .then((title) => (title?.trim() ? rename(id, title.trim()) : undefined))
@@ -210,10 +299,14 @@ export function useChatApp({ store, transport, makeTitle, conversationId, onConv
                 });
             }
         }
-        catch {
+        catch (error) {
             if (controller.signal.aborted) {
-                // Stopped: what had arrived is kept, as the apps keep a half answer.
-                if (soFar.text?.trim()) {
+                // Stopped: what had arrived is kept, as the apps keep a half answer —
+                // unless the product says this turn's text is not fit to keep.
+                const keep = keepPartial ?? optionsRef.current.stopKeepsPartial;
+                if (keep && soFar.text?.trim()) {
+                    if (asked)
+                        turnFiles.current.delete(asked.id);
                     const message = {
                         id: newId("m"),
                         role: "assistant",
@@ -226,7 +319,14 @@ export function useChatApp({ store, transport, makeTitle, conversationId, onConv
                     setStopped((s) => ({ ...s, [id]: true }));
             }
             else {
-                push(id, { id: newId("m"), role: "assistant", content: "", failed: true });
+                const failure = chatTurnFailure(error, optionsRef.current.failureMessage);
+                push(id, {
+                    id: newId("m"),
+                    role: "assistant",
+                    content: failure.message ?? "",
+                    failed: true,
+                    ...(failure.message || failure.kind ? { failure } : {}),
+                });
             }
         }
         finally {
@@ -243,27 +343,33 @@ export function useChatApp({ store, transport, makeTitle, conversationId, onConv
             const next = queueRef.current.find((q) => q.conversation === id);
             if (next) {
                 setQueueNow((q) => q.filter((item) => item.id !== next.id));
-                void sendIn(id, next.text, next.attachments);
+                void sendIn(id, next.text, next.attachments, next.chips);
             }
         }
     };
-    const sendIn = async (id, text, attachments) => {
+    const sendIn = async (id, text, attachments, chips) => {
         const history = (threadsRef.current[id] ?? []).filter((m) => !m.failed);
         const message = {
             id: newId("m"),
             role: "user",
             content: text,
             ...(attachments.length ? { attachments: messageAttachments(attachments) } : {}),
+            ...(chips && chips.length ? { chips } : {}),
         };
+        if (attachments.length)
+            turnFiles.current.set(message.id, attachments);
         push(id, message);
         save(id, message);
         await runTurn(id, text, attachments, history);
     };
     /** Composer's onSend. Resolves false to keep the draft (nothing was sent). */
-    const send = async (text, attachments = []) => {
+    const send = async (text, attachments = [], options = {}) => {
+        const { chips } = options;
+        if (options.newChat)
+            newChat();
         let id = activeRef.current;
         if (id && controllers.current.has(id)) {
-            setQueueNow((q) => [...q, { id: newId("q"), conversation: id, text, attachments }]);
+            setQueueNow((q) => [...q, { id: newId("q"), conversation: id, text, attachments, chips }]);
             return true;
         }
         if (!id) {
@@ -284,7 +390,7 @@ export function useChatApp({ store, transport, makeTitle, conversationId, onConv
             setThreadsNow((t) => ({ ...t, [id]: [] }));
             select(id, temporaryRef.current);
         }
-        void sendIn(id, text, attachments);
+        void sendIn(id, text, attachments, chips);
         return true;
     };
     const stop = () => {
@@ -304,7 +410,7 @@ export function useChatApp({ store, transport, makeTitle, conversationId, onConv
             return;
         setThreadsNow((t) => ({ ...t, [id]: kept }));
         const history = kept.slice(0, kept.indexOf(lastUser));
-        void runTurn(id, lastUser.content, [], history);
+        void runTurn(id, lastUser.content, turnFiles.current.get(lastUser.id) ?? [], history);
     };
     const newChat = () => {
         leaveTemporary();
@@ -332,6 +438,8 @@ export function useChatApp({ store, transport, makeTitle, conversationId, onConv
     };
     const remove = async (id) => {
         controllers.current.get(id)?.abort();
+        for (const m of threadsRef.current[id] ?? [])
+            turnFiles.current.delete(m.id);
         setList((l) => l.filter((c) => c.id !== id));
         setThreadsNow((t) => {
             const next = { ...t };
@@ -353,6 +461,9 @@ export function useChatApp({ store, transport, makeTitle, conversationId, onConv
     return {
         list,
         listState,
+        /** The list has loaded (or failed) and the reopened chat is chosen. */
+        ready,
+        whenReady,
         reloadList: () => setReload((n) => n + 1),
         activeId,
         stored,