@bitbaum/chatkit 0.18.1 → 0.19.0

package/README.md

@@ -174,11 +174,172 @@ reopens the chat, a picture staged above the text and removed, delete, the
 queue and Stop — and checks for sideways scroll, 44px targets and cut words
 at every step.
 
+#### What a product adds to it (0.19)
+
+The first four products to adopt ChatApp (Heidi, OrangeCat, Solon,
+Substrata) each listed what it could not do. These close those gaps; every
+one is optional, and 0.18 code keeps working unchanged.
+
+**Send from the page — the handle.** `<ChatApp ref={chat}>` gives
+`ChatAppHandle`: `send(text, attachments?, { newChat?, chips? })`,
+`fill(text, files?)`, `focus()`, `newChat()`, `openConversation(id)`.
+`send` behaves exactly like the composer's Send (queued behind a running
+answer, a chat created when none is open); `File`s are read like the
+paperclip's, and if one cannot be attached nothing is sent — the words and
+files go into the box with the reason. Never click `.ck-send` from outside.
+
+```tsx
+const chat = useRef<ChatAppHandle>(null);
+<ChatApp ref={chat} transport={transport} />;
+<button onClick={() => chat.current?.send("Check this figure", [], { newChat: true })}>Check this</button>;
+```
+
+**A message the page arrives with.** `initialMessage` is sent once, in a new
+chat, after the list has loaded (StrictMode's double mount sends it once).
+`send: false` only fills the box. Clear it from your URL or state yourself.
+
+```tsx
+<ChatApp transport={transport}
+  initialMessage={handoff ? { text: handoff.text, attachments: handoff.files } : null} />
+```
+
+**`?q=` links.** `deepLinkParam="q"` reads the parameter into a new chat's
+box and takes it off the address. A link never sends for someone: only with
+`deepLinkAutoSend` too.
+
+```tsx
+<ChatApp transport={transport} deepLinkParam="q" />
+// /chat?q=How%20do%20invoices%20expire → the box says it; the person sends.
+```
+
+**Why a turn failed, per turn.** Throw `ChatTurnError(message, { kind })`
+from the transport: that bubble shows `message` and keeps `failure.kind`
+(for a footer to link the fix). Two failures in one chat keep their own
+words. Any other error shows the `failed` label, never its raw message —
+unless `failureMessage(error)` maps it.
+
+```tsx
+import { ChatTurnError } from "@bitbaum/chatkit/react";
+if (res.status === 503) throw new ChatTurnError("The model is not set up here.", { kind: "not-configured" });
+<ChatApp transport={transport} failureMessage={(e) => (navigator.onLine ? null : "You are offline.")} />;
+```
+
+**Retry sends the pictures again.** The files of a failed turn stay with it
+until its answer lands; Retry re-sends the words and the files. Nothing to
+configure.
+
+**Stop and the half answer.** Stop keeps what had arrived (as the apps do).
+`stopKeepsPartial={false}` drops it for every turn; a transport decides per
+turn with `turn.stopKeepsPartial(keep)` — `false` while the text is unchecked.
+
+```tsx
+transport={async (turn) => {
+  turn.stopKeepsPartial(false); // the gate has not checked this text yet
+  /* … stream … */ turn.stopKeepsPartial(true); return answer; }}
+```
+
+**Starters with a language.** A starter is `string | { label, prompt?, lang? }
+| { text, label?, lang? }`; `lang` goes on the button.
+
+```tsx
+<ChatApp transport={transport}
+  starters={["Explain this word", { text: "Grüezi mitenand", lang: "gsw" }]} />
+```
+
+**The chat list's own line.** `historySlot` sits under the search box, above
+the chats; `historyEmpty` replaces "No chats yet…".
+
+```tsx
+<ChatApp transport={transport}
+  historySlot={signedOut && <a href="/login">Only in this browser · Sign in to keep it</a>}
+  historyEmpty={<p>What you ask is kept here.</p>} />
+```
+
+**Product rows in the attach sheet.** `composer.attachExtras` — `{ id,
+label, detail?, icon?, onPick }[]` — are rows under Camera · Photos · Files,
+one anatomy (icon, label, second line), in the same sheet. With `attach:
+false` the paperclip opens a sheet of only these rows. (`AttachMenu rows`
+takes the same list.)
+
+```tsx
+<ChatApp transport={transport}
+  composer={{ attachExtras: [{ id: "things", label: "Your things", onPick: openThings }],
+              heldAttachments: held.length }} />
+```
+
+**The product's things on the sent message.** `chipsFor({ text, attachments
+})` returns `MessageChip[]` (`{ label, href?, kind? }`) shown on the person's
+message the moment it is sent, and kept with it (`ChatMessageData.chips`).
+`send(…, { chips })` does the same from the handle.
+
+```tsx
+<ChatApp transport={transport}
+  chipsFor={() => held.map((r) => ({ label: r.title, href: r.url }))} />
+```
+
+**A temporary chat ended.** `onTemporaryEnd(chatId)` fires once when a
+temporary chat is left (New chat, another chat, Temporary off), the page is
+hidden, or ChatApp unmounts. `turn.chatId` is the same id, so a server row
+kept for the chat can be keyed by it and deleted here.
+
+```tsx
+<ChatApp transport={(turn) => myApi.send({ ...turn, hiddenRowKey: turn.chatId })}
+  onTemporaryEnd={(chatId) => myApi.deleteHiddenRow(chatId)} />
+```
+
+**Footers that know the latest answer, and can send.** `thread.renderFooter(m,
+{ isLatest, index, send, fill })`: put "what next" only under the latest,
+and let a chip whose label differs from its sentence send in one tap.
+
+```tsx
+thread={{ renderFooter: (m, { isLatest, send }) =>
+  isLatest && <button className="ck-reply" onClick={() => send("Make it shorter.")}>Shorter</button> }}
+```
+
+**After the last turn.** `thread.after` is drawn inside the thread, after the
+last turn (a pending action, a picker), not over the composer.
+
+`demo/app.html?lab=1` is the page these are checked on: StrictMode around
+ChatApp, the handle on `window.ckChat`. `test/browser-app.mjs` drives it at
+390px and 1440px.
+
 #### Moving a product onto ChatApp
 
 Per product, from the matrix: what goes, what stays. What stays is always
 the same two things — the transport and the words.
 
+**Workarounds 0.19 makes deletable** (each was written in an adoption PR
+because ChatApp 0.18 could not do it — bitbaum/heidi#226, bitbaum/orangecat#1447,
+bitbaum/solon#309, bitbaum/substrata#262):
+
+- **Substrata** — `lib/chat/drive-composer.ts` (types into the composer and
+  presses Send) goes: `components/portal/chat/useAutoAsk.ts` and
+  `lib/chat/handoff.ts` hand their words and pictures to `initialMessage` (or
+  `ref.send(text, files, { newChat: true })`), and `/chat?q=` becomes
+  `deepLinkParam="q"`. Retry now re-sends the pictures.
+- **OrangeCat** — in `src/components/ai-chat/ModernChatPanel/index.tsx`, the
+  bridge that sets the composer value and clicks `button.ck-send` goes (`?q=`
+  and `askCat` → the handle), and so does the ephemeral-row cleanup hung on
+  the empty state mounting and `onConversationChange` (→ `onTemporaryEnd`,
+  keyed by `turn.chatId` in `hooks/useCatTransport.ts`). "Your things" moves
+  from a second button into the sheet (`composer.attachExtras`), its staged
+  refs show on the sent bubble (`chipsFor`), `CatAnswerFooter` shows the
+  create links and upgrade nudge only under `isLatest`, and pending actions
+  move from `composer.above` to `thread.after`. `TurnFailure` reads the
+  turn's own `failure.kind` (throw `ChatTurnError`).
+- **Heidi** — in `app/[locale]/_components/chat/workspace.tsx`, the
+  latest-failure state passed as `thread.labels.failed` goes (throw
+  `ChatTurnError` from `chat-app.ts`'s transport mapping), and so does
+  `turn.update({ text: "" })` before a throw on Stop (→
+  `turn.stopKeepsPartial(false)` until the variety gate has checked the
+  text). The move and learn chips and the word pick send in one tap again
+  through `renderFooter`'s `send`; the dialect starter gets `lang`; the
+  signed-out "Sign in to keep it" line moves from `startersTitle` to
+  `historySlot`.
+- **Solon** — nothing to delete. The per-answer "Answered by <model>" fits
+  `thread.renderFooter` (it existed in 0.18; it now also gets `isLatest`).
+  ChatApp's own words still come only in English: pass `labels`.
+
 - **Loki** — goes: `ThreadRail.tsx`, the history half of
   `WorkspaceDrawers.tsx` and `WorkspaceChrome.tsx`, `ThreadTitle.tsx`,
   `hooks/use-temporary-chat.ts`, `hooks/use-new-chat.ts`,

package/dist/react/AttachMenu.d.ts

@@ -9,6 +9,19 @@ export type AttachMenuLabels = {
     sources: Record<AttachSource, string>;
 };
 export declare const DEFAULT_ATTACH_MENU_LABELS: AttachMenuLabels;
+/**
+ * One of the app's own rows in the attach sheet, under Camera · Photos ·
+ * Files: an icon, what it adds (`label`), an optional second line. Every row
+ * has this one anatomy, so a product's "Your things" reads as part of the
+ * same sheet, not a second menu. Picking a row closes the sheet first.
+ */
+export type AttachExtra = {
+    id: string;
+    label: string;
+    detail?: string;
+    icon?: ReactNode;
+    onPick: () => void;
+};
 /**
  * The paperclip, and what it opens on a phone: a sheet with Camera, Photos and
  * Files — one input each. See `ATTACH_SOURCE_INPUT` for why three inputs and
@@ -27,7 +40,7 @@ export declare const DEFAULT_ATTACH_MENU_LABELS: AttachMenuLabels;
  * they sit under Camera · Photos · Files in the same sheet, on every pointer,
  * since a mouse cannot reach them through a file dialog.
  */
-export declare function AttachMenu({ onFiles, disabled, labels, sources, trigger, extra, onOpenChange, }: {
+export declare function AttachMenu({ onFiles, disabled, labels, sources, trigger, extra, rows, onOpenChange, }: {
     onFiles: (files: FileList | null) => void;
     disabled?: boolean;
     labels?: AttachMenuLabels;
@@ -41,6 +54,10 @@ export declare function AttachMenu({ onFiles, disabled, labels, sources, trigger
      *  sheet opens on every pointer. A row that should close the sheet calls
      *  the `close` it is given. */
     extra?: (close: () => void) => ReactNode;
+    /** The app's rows as data — drawn with one anatomy (see `AttachExtra`).
+     *  With them the sheet opens on every pointer; with no `sources` it holds
+     *  only them. */
+    rows?: readonly AttachExtra[];
     onOpenChange?: (open: boolean) => void;
 }): import("react").JSX.Element;
 //# sourceMappingURL=AttachMenu.d.ts.map

package/dist/react/AttachMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AttachMenu.d.ts","sourceRoot":"","sources":["../../src/react/AttachMenu.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAI3E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAKxC,CAAC;AASF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,QAAgB,EAChB,MAAmC,EACnC,OAAiB,EACjB,OAAO,EACP,KAAK,EACL,YAAY,GACb,EAAE;IACD,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B;8EAC0E;IAC1E,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAClC;yEACqE;IACrE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;mCAE+B;IAC/B,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC;IACzC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC,+BAuEA"}
+{"version":3,"file":"AttachMenu.d.ts","sourceRoot":"","sources":["../../src/react/AttachMenu.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAI3E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAKxC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AASF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,QAAgB,EAChB,MAAmC,EACnC,OAAiB,EACjB,OAAO,EACP,KAAK,EACL,IAAI,EACJ,YAAY,GACb,EAAE;IACD,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B;8EAC0E;IAC1E,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAClC;yEACqE;IACrE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;mCAE+B;IAC/B,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC;IACzC;;qBAEiB;IACjB,IAAI,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC,+BAkGA"}

package/dist/react/AttachMenu.js

@@ -34,7 +34,7 @@ const ICONS = {
  * they sit under Camera · Photos · Files in the same sheet, on every pointer,
  * since a mouse cannot reach them through a file dialog.
  */
-export function AttachMenu({ onFiles, disabled = false, labels = DEFAULT_ATTACH_MENU_LABELS, sources = SOURCES, trigger, extra, onOpenChange, }) {
+export function AttachMenu({ onFiles, disabled = false, labels = DEFAULT_ATTACH_MENU_LABELS, sources = SOURCES, trigger, extra, rows, onOpenChange, }) {
     const inputs = useRef({});
     const [sheetOpen, setSheetOpen] = useState(false);
     const setOpen = (next) => {
@@ -46,8 +46,9 @@ export function AttachMenu({ onFiles, disabled = false, labels = DEFAULT_ATTACH_
         close();
         inputs.current[source]?.click();
     };
+    const hasRows = Boolean(extra) || (rows?.length ?? 0) > 0;
     const open = () => {
-        if (extra || (sources.length > 1 && prefersSheet()))
+        if (hasRows || (sources.length > 1 && prefersSheet()))
             setOpen(true);
         // A mouse gets the broadest picker offered: Files when it is one of the
         // sources, else the last one (Photos, for an image uploader).
@@ -59,9 +60,12 @@ export function AttachMenu({ onFiles, disabled = false, labels = DEFAULT_ATTACH_
                 }, type: "file", hidden: true, multiple: source !== "camera", "data-ck-source": source, ...ATTACH_SOURCE_INPUT[source], onChange: (e) => {
                     onFiles(e.target.files);
                     e.target.value = "";
-                } }, source))), _jsx("button", { type: "button", className: trigger ? "ck-attach-trigger" : "ck-icon-btn", onClick: open, disabled: disabled, "aria-label": labels.attach, "aria-haspopup": "dialog", title: labels.attach, children: trigger ?? _jsx(IconPaperclip, {}) }), _jsxs(Sheet, { open: sheetOpen, onClose: close, title: labels.title, closeLabel: labels.close, children: [_jsx("div", { className: "ck-attach-sources", children: sources.map((source) => {
+                } }, source))), _jsx("button", { type: "button", className: trigger ? "ck-attach-trigger" : "ck-icon-btn", onClick: open, disabled: disabled, "aria-label": labels.attach, "aria-haspopup": "dialog", title: labels.attach, children: trigger ?? _jsx(IconPaperclip, {}) }), _jsxs(Sheet, { open: sheetOpen, onClose: close, title: labels.title, closeLabel: labels.close, children: [sources.length > 0 && (_jsx("div", { className: "ck-attach-sources", children: sources.map((source) => {
                             const Icon = ICONS[source];
                             return (_jsxs("button", { type: "button", className: "ck-attach-source", "data-ck-source": source, onClick: () => pick(source), children: [_jsx(Icon, {}), _jsx("span", { children: labels.sources[source] })] }, source));
-                        }) }), extra && _jsx("div", { className: "ck-sheet-extra", children: extra(close) })] })] }));
+                        }) })), hasRows && (_jsxs("div", { className: sources.length > 0 ? "ck-sheet-extra" : "ck-sheet-extra ck-sheet-only", children: [rows?.map((row) => (_jsxs("button", { type: "button", className: "ck-attach-extra", "data-ck-extra": row.id, onClick: () => {
+                                    close();
+                                    row.onPick();
+                                }, children: [_jsx("span", { className: "ck-attach-extra-icon", "aria-hidden": true, children: row.icon ?? _jsx(IconPaperclip, {}) }), _jsxs("span", { className: "ck-attach-extra-text", children: [_jsx("span", { className: "ck-truncate", children: row.label }), row.detail && _jsx("small", { className: "ck-truncate", children: row.detail })] })] }, row.id))), extra?.(close)] }))] })] }));
 }
 //# sourceMappingURL=AttachMenu.js.map

package/dist/react/AttachMenu.js.map

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

package/dist/react/ChatApp.d.ts

@@ -1,12 +1,13 @@
 import { type ReactNode } from "react";
+import type { Attachment } from "../attachments.js";
 import type { ConversationStore, ConversationSummary } from "../conversations.js";
 import type { Speaker } from "../speech.js";
 import type { AnswerFeedback } from "../review.js";
-import { type ChatMessageData, type Starter, type ThreadLabels } from "./Thread.js";
+import { type ChatMessageData, type FooterInfo, type MessageChip, type Starter, type ThreadLabels } from "./Thread.js";
 import { type ComposerProps } from "./Composer.js";
 import type { RenderLink } from "./Markdown.js";
 import type { RichRenderers } from "./renderers.js";
-import { type ChatAppProblem, type ChatTransport } from "./use-chat-app.js";
+import { type ChatAppProblem, type ChatTransport, type SendOptions } from "./use-chat-app.js";
 export type ChatAppLabels = {
     chats: string;
     openChats: string;
@@ -42,6 +43,42 @@ export type ChatAppLabels = {
     problems: Record<ChatAppProblem, string>;
 };
 export declare const DEFAULT_CHAT_APP_LABELS: ChatAppLabels;
+/**
+ * What a page can do to the chat it holds (`<ChatApp ref={chat}>`): send for
+ * the person ("Check this", `/chat?q=`, a message handed over from a home
+ * box), put words in the box for them to finish, and move between chats.
+ */
+export type ChatAppHandle = {
+    /**
+     * Send now, exactly as if typed and sent: queued behind a running answer,
+     * a new chat created when none is open (or always, with `newChat`). Files
+     * are read like the paperclip's (limits, shrinking); if one cannot be
+     * attached, nothing is sent — the words and files go into the box with the
+     * reason, for the person to decide. Resolves whether it was sent.
+     */
+    send: (text: string, attachments?: readonly (Attachment | File)[], options?: SendOptions) => Promise<boolean>;
+    /** Put words (and files) in the box and the cursor after them; nothing is sent. */
+    fill: (text: string, files?: readonly File[]) => void;
+    focus: () => void;
+    newChat: () => void;
+    openConversation: (id: string) => void;
+};
+/** A message the page arrives with (see `initialMessage`). */
+export type InitialMessage = {
+    text: string;
+    /** Pictures and files with it: `File`s as picked, or wire attachments. */
+    attachments?: readonly (Attachment | File)[];
+    chips?: readonly MessageChip[];
+    /** Send it (the default), or only put it in the box (`false`). */
+    send?: boolean;
+};
+/** What `thread.renderFooter` gets beside the message. */
+export type ChatAppFooterInfo = FooterInfo & {
+    /** Send for the person — a chip whose label differs from what it says. */
+    send: (text: string, options?: SendOptions) => void;
+    /** Put words in the box for the person to finish. */
+    fill: (text: string) => void;
+};
 export type ChatAppProps = {
     /** Send a turn and resolve with the answer (stream through `turn.update`). */
     transport: ChatTransport;
@@ -63,11 +100,13 @@ export type ChatAppProps = {
     /** Composer options: `voice` (give it `transcribeUrl`), `attach` (on by
      *  default; `false` only when the product's API takes no files), `tools`,
      *  `labels`… Sending, Stop and the queue are ChatApp's. */
-    composer?: Partial<Omit<ComposerProps, "onSend" | "sending" | "onStop" | "queue">>;
+    composer?: Partial<Omit<ComposerProps, "onSend" | "sending" | "onStop" | "queue" | "handleRef">>;
     /** Thread options, passed to ChatThread. */
     thread?: {
         renderLink?: RenderLink;
-        renderFooter?: (m: ChatMessageData) => ReactNode;
+        renderFooter?: (m: ChatMessageData, info: ChatAppFooterInfo) => ReactNode;
+        /** After the last turn, inside the thread (a pending action, a picker). */
+        after?: ReactNode;
         renderers?: RichRenderers;
         speaker?: Speaker | null;
         share?: {
@@ -107,7 +146,42 @@ export type ChatAppProps = {
     railQuery?: string;
     labels?: Partial<ChatAppLabels>;
     className?: string;
+    /** A message to start with, in a NEW chat, once the list has loaded — the
+     *  home box handing its words and pictures to `/chat`. Used once per mount
+     *  (StrictMode's double mount included); clear it from your URL or state
+     *  yourself so a reload does not send it again. */
+    initialMessage?: InitialMessage | null;
+    /** Read this query parameter (e.g. `"q"`) into a new chat's box, then take
+     *  it off the address. The words are only put in the box: a link can never
+     *  send for someone unless `deepLinkAutoSend` is set too. */
+    deepLinkParam?: string;
+    /** Send the `deepLinkParam` words instead of filling the box. Off by default. */
+    deepLinkAutoSend?: boolean;
+    /** Stop keeps the half answer that had arrived. Default true; a transport
+     *  can decide per turn with `turn.stopKeepsPartial(keep)`. */
+    stopKeepsPartial?: boolean;
+    /** The words for a failed turn whose error is not a `ChatTurnError`
+     *  (return null for the thread's `failed` label). */
+    failureMessage?: (error: unknown) => string | null | undefined;
+    /** A temporary chat ended (left, page hidden, unmounted): delete what the
+     *  server kept for it. Gets `turn.chatId`; called once per chat. */
+    onTemporaryEnd?: (chatId: string) => void;
+    /** The product's things shown on the person's message when it is sent
+     *  from the box (the ones staged with `heldAttachments`). */
+    chipsFor?: (turn: {
+        text: string;
+        attachments: Attachment[];
+    }) => readonly MessageChip[] | null | undefined;
+    /** In the chat list, under the search box: the product's own line. */
+    historySlot?: ReactNode;
+    /** In the chat list, instead of "No chats yet…" when there are none. */
+    historyEmpty?: ReactNode;
 };
+/** The words a `?q=`-style link carries, and the address without them. Pure. */
+export declare function takeDeepLink(href: string, param: string): {
+    text: string;
+    href: string;
+} | null;
 /**
  * The whole chat app, the way the Claude, ChatGPT and Grok phone apps are
  * laid out: the conversation edge to edge, a frosted header (Chats · title ·
@@ -119,5 +193,5 @@ export type ChatAppProps = {
  * `store` that keeps chats (or nothing: the device then keeps them) — plus
  * its words. Everything a person sees and does is the same in every product.
  */
-export declare function ChatApp({ transport, store: givenStore, placeholder, name, makeTitle, starters, startersTitle, empty, composer, thread, footnote, fill, temporaryChats, onShare, conversationId, onConversationChange, rememberKey, search, headerStart, headerEnd, locale, railQuery, labels: labelOverrides, className, }: ChatAppProps): import("react").JSX.Element;
+export declare const ChatApp: import("react").ForwardRefExoticComponent<ChatAppProps & import("react").RefAttributes<ChatAppHandle>>;
 //# sourceMappingURL=ChatApp.d.ts.map

package/dist/react/ChatApp.d.ts.map

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

package/dist/react/ChatApp.js

@@ -1,14 +1,15 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useEffect, useMemo, useRef, useState } from "react";
+import { forwardRef, useEffect, useImperativeHandle, useMemo, useRef, useState, } from "react";
 import { localConversationStore } from "../stores.js";
 import { ChatScreen } from "./Screen.js";
 import { ChatStarters, ChatThread, } from "./Thread.js";
 import { Composer } from "./Composer.js";
+import { readAttachmentFile } from "./use-attachments.js";
 import { ChatHistory } from "./ChatHistory.js";
 import { useViewportHeight } from "./hooks.js";
 import { IconGhost, IconMenu, IconMore, IconNewChat, IconX } from "./icons.js";
-import { useChatApp } from "./use-chat-app.js";
+import { useChatApp, } from "./use-chat-app.js";
 export const DEFAULT_CHAT_APP_LABELS = {
     chats: "Chats",
     openChats: "Open your chats",
@@ -45,6 +46,23 @@ export const DEFAULT_CHAT_APP_LABELS = {
         open: "That chat did not open. Try again.",
     },
 };
+/** The words a `?q=`-style link carries, and the address without them. Pure. */
+export function takeDeepLink(href, param) {
+    let url;
+    try {
+        url = new URL(href);
+    }
+    catch {
+        return null;
+    }
+    const raw = url.searchParams.get(param);
+    if (raw === null)
+        return null;
+    url.searchParams.delete(param);
+    const text = raw.trim().slice(0, DEEP_LINK_MAX);
+    return { text, href: url.toString() };
+}
+const DEEP_LINK_MAX = 4000;
 function useMediaQuery(query) {
     const [match, setMatch] = useState(false);
     useEffect(() => {
@@ -70,13 +88,23 @@ let fallbackStore = null;
  * `store` that keeps chats (or nothing: the device then keeps them) — plus
  * its words. Everything a person sees and does is the same in every product.
  */
-export function ChatApp({ transport, store: givenStore, placeholder = "Ask anything", name = "", makeTitle, starters, startersTitle, empty, composer, thread, footnote, fill = "viewport", temporaryChats = true, onShare, conversationId, onConversationChange, rememberKey = "ck-chat:open", search, headerStart, headerEnd, locale, railQuery = "(min-width: 64rem)", labels: labelOverrides, className, }) {
+export const ChatApp = forwardRef(function ChatApp({ transport, store: givenStore, placeholder = "Ask anything", name = "", makeTitle, starters, startersTitle, empty, composer, thread, footnote, fill = "viewport", temporaryChats = true, onShare, conversationId, onConversationChange, rememberKey = "ck-chat:open", search, headerStart, headerEnd, locale, railQuery = "(min-width: 64rem)", labels: labelOverrides, className, initialMessage, deepLinkParam, deepLinkAutoSend = false, stopKeepsPartial, failureMessage, onTemporaryEnd, chipsFor, historySlot, historyEmpty, }, ref) {
     const labels = {
         ...DEFAULT_CHAT_APP_LABELS,
         ...labelOverrides,
         problems: { ...DEFAULT_CHAT_APP_LABELS.problems, ...labelOverrides?.problems },
     };
     const store = useMemo(() => givenStore ?? (fallbackStore ??= localConversationStore()), [givenStore]);
+    // What the page arrived with, read once: a message handed over, or a
+    // `?q=` link. Either starts a new chat, so the reload's chat is not reopened.
+    const [arrival] = useState(() => {
+        if (initialMessage)
+            return initialMessage;
+        if (!deepLinkParam || typeof window === "undefined")
+            return null;
+        const link = takeDeepLink(window.location.href, deepLinkParam);
+        return link?.text ? { text: link.text, send: deepLinkAutoSend } : null;
+    });
     const app = useChatApp({
         store,
         transport,
@@ -84,7 +112,67 @@ export function ChatApp({ transport, store: givenStore, placeholder = "Ask anyth
         conversationId,
         onConversationChange,
         rememberKey,
+        stopKeepsPartial,
+        failureMessage,
+        onTemporaryEnd,
+        restore: !arrival,
     });
+    const composerRef = useRef(null);
+    const attachLimits = typeof composer?.attach === "object" ? composer.attach : {};
+    const fillBox = (text, files) => {
+        const box = composerRef.current;
+        if (!box)
+            return;
+        box.setText(text);
+        if (files && files.length > 0)
+            box.addFiles([...files]);
+        box.focus();
+    };
+    const sendFor = async (text, given = [], options) => {
+        await app.whenReady();
+        const files = given.filter((a) => typeof File !== "undefined" && a instanceof File);
+        const wire = given.filter((a) => !(typeof File !== "undefined" && a instanceof File));
+        const read = await Promise.all(files.map((f) => readAttachmentFile(f, attachLimits, composer?.labels?.attachNotes)));
+        if (read.some((r) => r.note !== undefined)) {
+            // One file cannot go: send nothing behind the person's back. The box
+            // gets the words and the files, and says why (the composer's own note).
+            if (options?.newChat)
+                app.newChat();
+            fillBox(text, files);
+            return false;
+        }
+        const attachments = [...wire, ...read.map((r) => stripPreview(r.attachment))];
+        return app.send(text, attachments, options);
+    };
+    const handle = {
+        send: sendFor,
+        fill: fillBox,
+        focus: () => composerRef.current?.focus(),
+        newChat: app.newChat,
+        openConversation: app.open,
+    };
+    useImperativeHandle(ref, () => handle);
+    // The arrival, once — StrictMode's rehearsal mount included (`taken` is
+    // kept across it), and only after the list is in so nothing moves it.
+    const taken = useRef(false);
+    useEffect(() => {
+        if (!app.ready || !arrival || taken.current)
+            return;
+        taken.current = true;
+        if (deepLinkParam && !initialMessage && typeof window !== "undefined") {
+            const link = takeDeepLink(window.location.href, deepLinkParam);
+            if (link)
+                window.history.replaceState(window.history.state, "", link.href);
+        }
+        if (arrival.send === false) {
+            app.newChat();
+            fillBox(arrival.text, (arrival.attachments ?? []).filter((a) => typeof File !== "undefined" && a instanceof File));
+        }
+        else {
+            void sendFor(arrival.text, arrival.attachments, { newChat: true, chips: arrival.chips });
+        }
+        // `arrival` is fixed at mount; the rest is read when it fires.
+    }, [app.ready]);
     const rootRef = useRef(null);
     useViewportHeight(rootRef, fill === "viewport");
     const wide = useMediaQuery(railQuery);
@@ -122,7 +210,7 @@ export function ChatApp({ transport, store: givenStore, placeholder = "Ask anyth
         }, onNew: () => {
             setDrawerOpen(false);
             app.newChat();
-        }, onRename: (id, t) => void app.rename(id, t), onRemove: (id) => void app.remove(id), onRetry: app.reloadList, onClose: wide ? undefined : () => setDrawerOpen(false), search: search, locale: locale, labels: labels }));
+        }, onRename: (id, t) => void app.rename(id, t), onRemove: (id) => void app.remove(id), onRetry: app.reloadList, onClose: wide ? undefined : () => setDrawerOpen(false), search: search, locale: locale, labels: labels, slot: historySlot, empty: historyEmpty }));
     const [renaming, setRenaming] = useState(false);
     const [deleting, setDeleting] = useState(false);
     const menu = [];
@@ -155,8 +243,12 @@ export function ChatApp({ transport, store: givenStore, placeholder = "Ask anyth
                             setDeleting(false);
                             void app.remove(current.id);
                         }, children: labels.delete }), _jsx("button", { type: "button", onClick: () => setDeleting(false), children: labels.cancel })] })] })) : null;
-    const dock = (_jsxs(_Fragment, { children: [above, app.problem && (_jsxs("p", { className: "ck-problem", role: "status", children: [_jsx("span", { children: labels.problems[app.problem] }), _jsx("button", { type: "button", className: "ck-problem-x", onClick: app.clearProblem, "aria-label": labels.dismiss, children: _jsx(IconX, {}) })] })), app.queued.length > 0 && (_jsx("ul", { className: "ck-app-queue", "aria-label": labels.queued, children: app.queued.map((q) => (_jsxs("li", { children: [_jsxs("span", { className: "ck-app-queue-text", children: [_jsx("span", { className: "ck-truncate", children: q.text }), _jsx("small", { children: labels.queued })] }), _jsx("button", { type: "button", className: "ck-icon-btn", onClick: () => app.unqueue(q.id), "aria-label": labels.unqueue(q.text), title: labels.unqueue(q.text), children: _jsx(IconX, {}) })] }, q.id))) })), _jsx(Composer, { placeholder: placeholder, attach: true, stagedPosition: "above", ...composer, onSend: (text, attachments) => app.send(text, attachments), sending: app.busy, onStop: app.stop, queue: true })] }));
+    const dock = (_jsxs(_Fragment, { children: [above, app.problem && (_jsxs("p", { className: "ck-problem", role: "status", children: [_jsx("span", { children: labels.problems[app.problem] }), _jsx("button", { type: "button", className: "ck-problem-x", onClick: app.clearProblem, "aria-label": labels.dismiss, children: _jsx(IconX, {}) })] })), app.queued.length > 0 && (_jsx("ul", { className: "ck-app-queue", "aria-label": labels.queued, children: app.queued.map((q) => (_jsxs("li", { children: [_jsxs("span", { className: "ck-app-queue-text", children: [_jsx("span", { className: "ck-truncate", children: q.text }), _jsx("small", { children: labels.queued })] }), _jsx("button", { type: "button", className: "ck-icon-btn", onClick: () => app.unqueue(q.id), "aria-label": labels.unqueue(q.text), title: labels.unqueue(q.text), children: _jsx(IconX, {}) })] }, q.id))) })), _jsx(Composer, { placeholder: placeholder, attach: true, stagedPosition: "above", ...composer, handleRef: composerRef, onSend: (text, attachments) => {
+                    const chips = chipsFor?.({ text, attachments });
+                    return app.send(text, attachments, chips ? { chips } : undefined);
+                }, sending: app.busy, onStop: app.stop, queue: true })] }));
     const lastFailed = app.messages[app.messages.length - 1]?.failed;
+    const renderFooter = thread?.renderFooter;
     const onFeedback = thread?.onFeedback;
     const cls = ["ck-app"];
     if (fill === "viewport")
@@ -168,8 +260,22 @@ export function ChatApp({ transport, store: givenStore, placeholder = "Ask anyth
     return (_jsxs("div", { ref: rootRef, className: cls.join(" "), children: [wide ? (_jsx("aside", { className: "ck-app-rail", children: history })) : (_jsx("dialog", { ref: drawerRef, className: "ck-app-drawer", "aria-label": labels.chats, onClose: () => setDrawerOpen(false), onClick: (e) => {
                     if (e.target === e.currentTarget)
                         setDrawerOpen(false);
-                }, children: drawerOpen && _jsx("div", { className: "ck-app-drawer-panel", children: history }) })), _jsx(ChatScreen, { fill: "parent", className: "ck-app-screen", header: header, composer: dock, footnote: footnote, renderers: thread?.renderers, children: _jsx(ChatThread, { messages: app.messages, loading: app.loading, live: app.live, stopped: app.stopped, onStop: app.stop, onRetry: lastFailed || app.stopped ? app.retry : undefined, onReply: (text) => void app.send(text), renderLink: thread?.renderLink, renderFooter: thread?.renderFooter, speaker: thread?.speaker, share: thread?.share, onFeedback: onFeedback ? (f) => onFeedback({ ...f, conversationId: app.stored }) : undefined, labels: thread?.labels, empty: empty ??
-                        (starters && starters.length > 0 ? (_jsx(ChatStarters, { starters: starters, title: startersTitle, onPick: (text) => void app.send(text) })) : (_jsx("div", { className: "ck-starters", children: startersTitle && _jsx("div", { className: "ck-starters-title", children: startersTitle }) }))) }, app.activeId ?? (app.temporary ? "temporary" : "new")) })] }));
+                }, children: drawerOpen && _jsx("div", { className: "ck-app-drawer-panel", children: history }) })), _jsx(ChatScreen, { fill: "parent", className: "ck-app-screen", header: header, composer: dock, footnote: footnote, renderers: thread?.renderers, children: _jsx(ChatThread, { messages: app.messages, loading: app.loading, live: app.live, stopped: app.stopped, onStop: app.stop, onRetry: lastFailed || app.stopped ? app.retry : undefined, onReply: (text) => void app.send(text), renderLink: thread?.renderLink, renderFooter: renderFooter
+                        ? (m, info) => renderFooter(m, {
+                            ...info,
+                            send: (text, options) => void app.send(text, [], options),
+                            fill: (text) => fillBox(text),
+                        })
+                        : undefined, speaker: thread?.speaker, share: thread?.share, onFeedback: onFeedback ? (f) => onFeedback({ ...f, conversationId: app.stored }) : undefined, labels: thread?.labels, empty: empty ??
+                        (starters && starters.length > 0 ? (_jsx(ChatStarters, { starters: starters, title: startersTitle, onPick: (text) => void app.send(text) })) : (_jsx("div", { className: "ck-starters", children: startersTitle && _jsx("div", { className: "ck-starters-title", children: startersTitle }) }))), children: thread?.after }, app.activeId ?? (app.temporary ? "temporary" : "new")) })] }));
+});
+/** The wire shape only: a preview URL never leaves the page. */
+function stripPreview(a) {
+    if (!("previewUrl" in a))
+        return a;
+    const { previewUrl: _preview, ...wire } = a;
+    void _preview;
+    return wire;
 }
 /** The header's "…": a small menu under the button. Escape and a tap
  *  outside close it and give focus back to the button; arrows move. */