@bitbaum/chatkit 0.2.1 → 0.7.0

package/README.md

@@ -15,11 +15,15 @@ interface that calls them.)
 ## Install
 
 ```sh
-pnpm add github:bitbaum/chatkit#v0.2.0
+pnpm add @bitbaum/chatkit@^0.6.0
 ```
 
-`dist/` is committed, so the install needs no build step and no `allowBuilds`
-entry. (npm publishing is set up once the package has its first release there.)
+**Install releases from npm, never a commit or a branch.** A semver range is
+what lets a fix reach every product: Renovate/Dependabot opens the bump PR in
+each app when a release ships. A pinned commit or tag silently freezes the app
+on whatever it pinned — heidi and substrata kept the broken Android paperclip
+for days after the fix merged, because one pinned `v0.2.0` and npm had only
+`0.2.1`.
 
 ## Use
 
@@ -42,6 +46,8 @@ import "@bitbaum/chatkit/styles.css";
   voice={{ transcribeUrl: "/api/transcribe" }}
   attach                             // only if your API accepts attachments
   tools={<ModelPicker />}            // app-specific controls go in slots
+  heldAttachments={refs.length}      // attachments the APP keeps (shown in `header`)
+  attachmentOnlyText="See attached"  //   so a message of only those can still send
 />
 ```
 
@@ -62,6 +68,94 @@ nothing heard, not available), never as a button that does nothing.
 `prefer: "server"` skips the browser leg (one model everywhere, language
 detected by the model). `rememberKey: null` stores nothing on the device.
 
+### Suggested replies
+
+The two to four things the person is likely to say next, as buttons under the
+latest answer — one tap sends it. The model writes them in the same turn, so
+there is no second call and no wait:
+
+```ts
+import { REPLIES_INSTRUCTION } from "@bitbaum/chatkit";
+const system = `${yourPrompt}\n\n${REPLIES_INSTRUCTION}`; // server side
+```
+
+```tsx
+<ChatThread messages={messages} onReply={send} … />
+```
+
+That is the whole integration. `ChatThread` takes the `quick_replies` block out
+of every answer (and out of a streaming one before it has finished, so nobody
+watches JSON appear), and shows the buttons under the latest answer only, never
+while a turn runs. Pass `replies` on a message to supply your own instead.
+An app with its own thread uses `extractReplies(text)` and `<ChatReplies>`, so
+the buttons look and behave the same everywhere.
+
+### The next message while a turn runs
+
+`queue` keeps Send live while `sending`, beside Stop, and the placeholder
+reads "Queue a message…": the app receives the message through `onSend` as
+usual and sends it on when the turn ends. Without it a send during a turn is
+refused, which holds the next thought until a spinner stops.
+
+### Recordings
+
+With a server leg, the paperclip also takes a recording that already exists —
+a voice memo from the phone's recorder, a taped meeting. It is dictation that
+happened earlier: the file is posted to `transcribeUrl` under its own name
+(Whisper reads the container from the extension) and the words land in the box
+like a mic take, never staged as an attachment the model would have to read.
+Files are recognised by type and, where a picker hands them over typeless as
+Android does with `.m4a`, by extension. Uploads are capped at
+`MAX_AUDIO_FILE_BYTES` (120 MB — an hour of phone memo with room to spare);
+over it, the person is told in words before any bytes move. Your server leg
+should compress and split long audio before Whisper; loki's does.
+
+### Camera, Photos, Files
+
+On a touch screen the paperclip opens a sheet with three choices — Camera,
+Photos, Files — each its own file input. One input with a mixed `accept`
+(`image/*,text/*,audio/*`) is what a phone answers with a chooser of capture
+apps (Camera, Camera, Recorder, "Photos & Videos"), where the screenshot you
+came to send is three levels down and the file browser is not offered at all.
+`ATTACH_SOURCE_INPUT` is the SSOT: Camera captures, Photos opens the system
+photo picker, Files has no `accept` and opens the real document browser.
+Because Files takes anything, `isTextFile` decides afterwards what can be read
+inline; a PDF gets a sentence, not a prompt full of bytes. With a mouse the
+paperclip opens the file dialog directly — on a desktop all three are the
+same dialog. A box that is not chatkit's composer renders `<AttachMenu
+onFiles={…} />` rather than a bare `<input type="file">`. Labels:
+`labels={{ attachMenu: { title, close, sources: { camera, photos, files } } }}`.
+
+### Picking files anywhere — `@bitbaum/chatkit/attach`
+
+An app with no chat still has uploaders (an avatar, product photos, a receipt).
+They need the same thing from a phone, so they use the same piece:
+
+```tsx
+import { AttachMenu, shrinkImage } from "@bitbaum/chatkit/attach";
+
+<AttachMenu
+  sources={["camera", "photos"]} // an image uploader offers no Files
+  trigger="Add photo"
+  onFiles={(files) => upload(files)}
+/>;
+```
+
+`sources` narrows the sheet (one source skips it). `shrinkImage(file, maxEdge,
+maxBytes)` is the in-browser downscale the composer uses. `acceptFamilies` and
+`ATTACH_SOURCE_INPUT` are the rule itself.
+
+### The check every app runs in CI
+
+```sh
+pnpm exec chatkit-check-file-inputs            # src app components
+```
+
+Fails on any file input whose literal `accept` mixes families (image + text,
+audio + text…) — the exact shape that hid screenshots on Android. One input per
+family, or `AttachMenu`. A real exception carries
+`// chatkit-allow-mixed-accept: <reason>` on the line or the line above.
+
 ### Screenshots
 
 `attach` takes limits: `attach={{ maxImageEdge: 1024 }}` shrinks a picture in
@@ -90,7 +184,8 @@ on `Composer`, `labels` on `ChatThread`.
 
 ## The standard (what this package guarantees)
 
-1. A microphone in the composer, with the server fallback above.
+1. A microphone in the composer, with the server fallback above — and the
+   same server leg for a recording picked as a file.
 2. 16px text in the input and the messages (below that iOS zooms the page).
 3. A composer that belongs to the conversation: auto-growing textarea, Enter
    sends, Shift+Enter breaks the line, IME composition respected, 44px targets,
@@ -101,8 +196,8 @@ on `Composer`, `labels` on `ChatThread`.
    jump-down button otherwise.
 7. Markdown rendered, never as HTML; `javascript:` links stay text; Copy on
    every answer.
-8. Starters in the empty state; the speaker's name on every answer once more
-   than one agent speaks.
+8. Starters in the empty state; suggested replies under the latest answer;
+   the speaker's name on every answer once more than one agent speaks.
 9. Nothing overflows at 320–390px.
 
 `pnpm run verify` proves all of it: unit and render tests, then
@@ -118,8 +213,9 @@ different chats. If your app needs something truly its own, it goes in a slot
 (`tools`, `header`, `footer`, `renderFooter`, `renderLink`) — ask for a new slot
 here rather than forking the component.
 
-Release: bump `version` in `package.json`, merge, then
-`git tag v<version> origin/main && git push origin v<version>`.
+Release: bump `version` in `package.json` and merge. The merge publishes it
+(`publish.yml` runs on main, skips a version already on npm, and tags the
+commit `v<version>`). No manual tag.
 
 ## Develop
 

package/bin/chatkit-check-file-inputs.mjs

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+// Fails when a file input asks for more than one family of files at once.
+//
+//   chatkit-check-file-inputs [dir ...]        (default: src app components)
+//
+// A phone answers <input type="file" accept="image/*,.txt,audio/*"> with a
+// chooser of capture apps — Camera, Recorder, "Photos & Videos" — and no file
+// browser, so the screenshot the person came to send is out of reach. Found on
+// Android on 2026-10-05 in loki, orangecat and evig at once: each app had
+// written its own input. The fix is one input per source (AttachMenu from
+// @bitbaum/chatkit/attach); this check keeps a new one from coming back.
+//
+// Comments are skipped. It reads literal accept values (accept="…", accept={"…"}, accept: "…",
+// accept={`…`} without interpolation). A value built at runtime is not seen,
+// so build mixed lists nowhere. A line, or the line above it, carrying
+// `chatkit-allow-mixed-accept: <reason>` is skipped — say why.
+import { readdirSync, readFileSync, statSync, existsSync } from "node:fs";
+import { join, relative } from "node:path";
+import { acceptFamilies } from "../dist/index.js";
+
+const roots = process.argv.slice(2).filter((a) => !a.startsWith("-"));
+const dirs = (roots.length ? roots : ["src", "app", "components"]).filter((d) => existsSync(d));
+const SKIP = new Set(["node_modules", ".next", "dist", "build", "out", "coverage", ".git"]);
+const EXT = /\.(tsx|jsx|ts|js|mjs)$/;
+const ACCEPT = /accept\s*[=:]\s*\{?\s*(?:"([^"]*)"|'([^']*)'|`([^`$]*)`)/g;
+
+function* walk(dir) {
+  for (const name of readdirSync(dir)) {
+    if (SKIP.has(name)) continue;
+    const path = join(dir, name);
+    const st = statSync(path);
+    if (st.isDirectory()) yield* walk(path);
+    else if (EXT.test(name) && !/\.(test|spec)\./.test(name)) yield path;
+  }
+}
+
+const problems = [];
+let scanned = 0;
+for (const dir of dirs) {
+  for (const file of walk(dir)) {
+    scanned++;
+    const lines = readFileSync(file, "utf8").split("\n");
+    let inBlockComment = false;
+    lines.forEach((line, i) => {
+      // Comments describe inputs; they are not inputs. A note recording the
+      // old bug ("used to be accept=\"image/*,text/*\"") must not fail CI.
+      const trimmed = line.trim();
+      if (inBlockComment) {
+        if (trimmed.includes("*/")) inBlockComment = false;
+        return;
+      }
+      if (/^(\/\/|\*|\{\s*\/\*)/.test(trimmed)) return;
+      if (trimmed.startsWith("/*")) {
+        if (!trimmed.includes("*/")) inBlockComment = true;
+        return;
+      }
+      // "/*" opens a comment only after space, "{" or "(" — inside an accept
+      // value it follows a letter ("image/*") and must survive.
+      const code = line.replace(/(^|[\s{(])\/\*.*?\*\//g, "$1").replace(/(^|\s)\/\/.*$/, "$1");
+      for (const m of code.matchAll(ACCEPT)) {
+        const value = m[1] ?? m[2] ?? m[3] ?? "";
+        const families = acceptFamilies(value);
+        if (families.length < 2) continue;
+        const allowed = [line, lines[i - 1] ?? ""].some((l) =>
+          l.includes("chatkit-allow-mixed-accept:"),
+        );
+        if (allowed) continue;
+        problems.push(
+          `${relative(process.cwd(), file)}:${i + 1}  accept="${value}" mixes ${families.join(" + ")}`,
+        );
+      }
+    });
+  }
+}
+
+if (problems.length) {
+  console.error(`✗ ${problems.length} file input(s) mix file families:\n`);
+  for (const p of problems) console.error(`  ${p}`);
+  console.error(
+    "\n  A phone answers a mixed accept with a chooser of capture apps and no file browser." +
+      "\n  Use AttachMenu from @bitbaum/chatkit/attach (Camera / Photos / Files), or one input per family.",
+  );
+  process.exit(1);
+}
+console.log(
+  `✓ file inputs: none mixes file families (${scanned} files in ${dirs.join(", ") || "nothing"})`,
+);

package/dist/attachments.d.ts

@@ -61,6 +61,43 @@ export declare function fitWithin(width: number, height: number, maxEdge: number
 /** Bytes a base64 data URL decodes to — close enough to compare to a limit. */
 export declare function dataUrlBytes(dataUrl: string): number;
 export declare function isImageMime(mime: string): boolean;
+/**
+ * Whether a file is text the model can read inline. The Files picker accepts
+ * anything — that is what keeps it the phone's real document browser instead
+ * of a camera chooser — so the decision about what can actually be sent moves
+ * here, after the pick, where a PDF gets a sentence instead of being read as
+ * binary noise and pasted into a prompt.
+ */
+export declare function isTextFile(name: string, mime: string): boolean;
+/**
+ * Where an attachment comes from. Three sources, three inputs, because a phone
+ * answers ONE input with a mixed `accept` ("image/*,text/*,audio/*") by
+ * opening a chooser of capture apps — Camera, Camera, Recorder, "Photos &
+ * Videos" — in which the screenshot you came to send is three levels down,
+ * and the file browser is not offered at all. Measured on Android/Brave,
+ * 2026-10-05; it is what made attaching to Loki "impossible".
+ *
+ * - camera: `capture` opens the camera straight away.
+ * - photos: `image/*` alone opens the system photo picker (Screenshots is its
+ *   first album), not a chooser.
+ * - files: no `accept` at all opens the real document browser — Downloads,
+ *   Drive, any folder. The type check happens after, in `isTextFile`.
+ */
+export type AttachSource = "camera" | "photos" | "files";
+export declare const ATTACH_SOURCE_INPUT: Record<AttachSource, {
+    accept?: string;
+    capture?: "environment";
+}>;
+/** What kind of picker a file `accept` asks a phone for. */
+export type AcceptFamily = "image" | "audio" | "video" | "document";
+/**
+ * The families an `accept` value spans. More than one is the bug
+ * `ATTACH_SOURCE_INPUT` exists to prevent: a phone answers a mixed accept with
+ * a chooser of capture apps instead of the picker the person needed. Pure, so
+ * the fleet's file-input check (`chatkit-check-file-inputs`) and the tests
+ * share one definition.
+ */
+export declare function acceptFamilies(accept: string): AcceptFamily[];
 /** `data:image/png;base64,AAAA` → `AAAA`: FileReader hands back a data URL,
  *  the wire carries raw base64. */
 export declare function stripDataUrlBase64(dataUrl: string): string;

package/dist/attachments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../src/attachments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7E,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AACF,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,eAAe,CAAC;AAE1D,uDAAuD;AACvD,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;;;OAQG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,gBAKvC,CAAC;AAEF;yBACyB;AACzB,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACvD,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,KAAK,MAAM,CAAC;IACjE,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAMtC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CASpD;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;mCACmC;AACnC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;6DAC6D;AAC7D,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAInD;AAED,wDAAwD;AACxD,wBAAgB,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,UAAU,EAAE,CAM/D"}
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../src/attachments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7E,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AACF,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,eAAe,CAAC;AAE1D,uDAAuD;AACvD,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;;;OAQG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,gBAKvC,CAAC;AAEF;yBACyB;AACzB,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACvD,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,KAAK,MAAM,CAAC;IACjE,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAMtC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CASpD;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAQD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAI9D;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEzD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CACtC,YAAY,EACZ;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,CAAA;CAAE,CAK7C,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAyBpE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAgB7D;AAED;mCACmC;AACnC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;6DAC6D;AAC7D,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAInD;AAED,wDAAwD;AACxD,wBAAgB,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,UAAU,EAAE,CAM/D"}

package/dist/attachments.js

@@ -11,7 +11,7 @@ export const DEFAULT_ATTACHMENT_LIMITS = {
     maxImageEdge: 0,
 };
 export const DEFAULT_ATTACHMENT_NOTES = {
-    wrongType: (name) => `${name}: use PNG, JPEG, GIF or WebP.`,
+    wrongType: (name) => `${name}: attach an image (PNG, JPEG, GIF, WebP) or a text file.`,
     imageTooLarge: (name, maxMb) => `${name} is too large (max ${maxMb} MB).`,
     textTooLarge: (name, k) => `${name} is too large (max ${k}k characters).`,
     unreadable: (name) => `Could not read ${name}.`,
@@ -40,6 +40,80 @@ const IMAGE_MIME = /^image\/(jpeg|jpg|png|gif|webp)$/i;
 export function isImageMime(mime) {
     return IMAGE_MIME.test(mime);
 }
+/** Extensions a picker may hand over with no type, or as
+ *  application/octet-stream, that are still plain text a model can read. */
+const TEXT_EXTENSIONS = /\.(txt|md|markdown|json|jsonl|csv|tsv|log|ya?ml|toml|ini|xml|html?|css|scss|js|jsx|mjs|cjs|ts|tsx|py|rb|go|rs|java|kt|swift|c|h|cpp|hpp|cs|php|sh|bash|zsh|sql|env|diff|patch|srt|vtt)$/i;
+const TEXT_MIME = /^(text\/|application\/(json|xml|x-yaml|yaml|javascript|x-sh|sql))/i;
+/**
+ * Whether a file is text the model can read inline. The Files picker accepts
+ * anything — that is what keeps it the phone's real document browser instead
+ * of a camera chooser — so the decision about what can actually be sent moves
+ * here, after the pick, where a PDF gets a sentence instead of being read as
+ * binary noise and pasted into a prompt.
+ */
+export function isTextFile(name, mime) {
+    if (TEXT_MIME.test(mime))
+        return true;
+    if (mime && mime !== "application/octet-stream")
+        return false;
+    return TEXT_EXTENSIONS.test(name);
+}
+export const ATTACH_SOURCE_INPUT = {
+    camera: { accept: "image/*", capture: "environment" },
+    photos: { accept: "image/*" },
+    files: {},
+};
+const FAMILY_BY_EXTENSION = {};
+for (const ext of [
+    "png",
+    "jpg",
+    "jpeg",
+    "gif",
+    "webp",
+    "heic",
+    "heif",
+    "avif",
+    "bmp",
+    "svg",
+    "tif",
+    "tiff",
+])
+    FAMILY_BY_EXTENSION[ext] = "image";
+for (const ext of ["mp3", "m4a", "wav", "ogg", "oga", "opus", "aac", "flac", "amr", "wma"])
+    FAMILY_BY_EXTENSION[ext] = "audio";
+for (const ext of ["mp4", "mov", "m4v", "mkv", "avi", "wmv"])
+    FAMILY_BY_EXTENSION[ext] = "video";
+// Containers that hold either sound or picture (.webm, .3gp) say nothing about
+// the picker on their own, so they are not counted for either family.
+const AMBIGUOUS_EXTENSIONS = new Set(["webm", "3gp", "3g2", "mpeg", "mpg"]);
+/**
+ * The families an `accept` value spans. More than one is the bug
+ * `ATTACH_SOURCE_INPUT` exists to prevent: a phone answers a mixed accept with
+ * a chooser of capture apps instead of the picker the person needed. Pure, so
+ * the fleet's file-input check (`chatkit-check-file-inputs`) and the tests
+ * share one definition.
+ */
+export function acceptFamilies(accept) {
+    const found = new Set();
+    for (const raw of accept.split(",")) {
+        const token = raw.trim().toLowerCase();
+        if (!token)
+            continue;
+        if (token.startsWith(".")) {
+            const ext = token.slice(1);
+            if (AMBIGUOUS_EXTENSIONS.has(ext))
+                continue;
+            found.add(FAMILY_BY_EXTENSION[ext] ?? "document");
+            continue;
+        }
+        const major = token.split("/")[0];
+        if (major === "image" || major === "audio" || major === "video")
+            found.add(major);
+        else
+            found.add("document");
+    }
+    return [...found];
+}
 /** `data:image/png;base64,AAAA` → `AAAA`: FileReader hands back a data URL,
  *  the wire carries raw base64. */
 export function stripDataUrlBase64(dataUrl) {

package/dist/attachments.js.map

@@ -1 +1 @@
-{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../src/attachments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiCH,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,QAAQ,EAAE,CAAC;IACX,YAAY,EAAE,OAAO;IACrB,aAAa,EAAE,SAAS;IACxB,YAAY,EAAE,CAAC;CAChB,CAAC;AAYF,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,+BAA+B;IAC3D,aAAa,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,sBAAsB,KAAK,OAAO;IACzE,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,sBAAsB,CAAC,gBAAgB;IACzE,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,IAAI,GAAG;IAC/C,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,GAAG,SAAS;CACxC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,KAAa,EACb,MAAc,EACd,OAAe;IAEf,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAChF,MAAM,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;IAChC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;QAC7C,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;QAC/C,MAAM,EAAE,IAAI;KACb,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,GAAG,mCAAmC,CAAC;AAEvD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;mCACmC;AACnC,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACjD,CAAC;AAED;6DAC6D;AAC7D,MAAM,UAAU,aAAa,CAAC,CAAa;IACzC,OAAO,CAAC,CAAC,IAAI,KAAK,OAAO;QACvB,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE;QAC1C,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,MAAM,CAAC,MAA0B;IAC/C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACtB,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5C,KAAK,QAAQ,CAAC;QACd,OAAO,IAAkB,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../src/attachments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiCH,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,QAAQ,EAAE,CAAC;IACX,YAAY,EAAE,OAAO;IACrB,aAAa,EAAE,SAAS;IACxB,YAAY,EAAE,CAAC;CAChB,CAAC;AAYF,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,0DAA0D;IACtF,aAAa,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,sBAAsB,KAAK,OAAO;IACzE,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,sBAAsB,CAAC,gBAAgB;IACzE,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,IAAI,GAAG;IAC/C,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,GAAG,SAAS;CACxC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,KAAa,EACb,MAAc,EACd,OAAe;IAEf,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAChF,MAAM,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;IAChC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;QAC7C,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;QAC/C,MAAM,EAAE,IAAI;KACb,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,GAAG,mCAAmC,CAAC;AAEvD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;4EAC4E;AAC5E,MAAM,eAAe,GACnB,0LAA0L,CAAC;AAC7L,MAAM,SAAS,GAAG,oEAAoE,CAAC;AAEvF;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,IAAY;IACnD,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,IAAI,IAAI,IAAI,KAAK,0BAA0B;QAAE,OAAO,KAAK,CAAC;IAC9D,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAkBD,MAAM,CAAC,MAAM,mBAAmB,GAG5B;IACF,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE;IACrD,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;IAC7B,KAAK,EAAE,EAAE;CACV,CAAC;AAKF,MAAM,mBAAmB,GAAiC,EAAE,CAAC;AAC7D,KAAK,MAAM,GAAG,IAAI;IAChB,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;CACP;IACC,mBAAmB,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;AACrC,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;IACxF,mBAAmB,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;AACrC,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IAAE,mBAAmB,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;AACjG,+EAA+E;AAC/E,sEAAsE;AACtE,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5C,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,CAAC;YAClD,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO;YAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;;YAC7E,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC;AAED;mCACmC;AACnC,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACjD,CAAC;AAED;6DAC6D;AAC7D,MAAM,UAAU,aAAa,CAAC,CAAa;IACzC,OAAO,CAAC,CAAC,IAAI,KAAK,OAAO;QACvB,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE;QAC1C,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,MAAM,CAAC,MAA0B;IAC/C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACtB,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5C,KAAK,QAAQ,CAAC;QACd,OAAO,IAAkB,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/composer.d.ts

@@ -15,13 +15,16 @@ export type ComposerMode = {
 /** `false` keeps the draft (the send failed or was refused); anything else
  *  clears it. A failed send must be retryable from the same box, not retyped. */
 export type ComposerSendResult = void | boolean;
-export declare function composerCanSend({ text, attachmentCount, attachmentOnlyText, sending, disabled, blocked, }: {
+export declare function composerCanSend({ text, attachmentCount, attachmentOnlyText, sending, disabled, blocked, queue, }: {
     text: string;
     attachmentCount: number;
     attachmentOnlyText?: string;
     sending: boolean;
     disabled: boolean;
     blocked: boolean;
+    /** The app takes a message while a turn runs and sends it after. With it,
+     *  `sending` no longer refuses the send — it queues it. */
+    queue?: boolean;
 }): boolean;
 /** The words actually sent: the draft, or the app's stand-in for an
  *  attachments-only send. */

package/dist/composer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../src/composer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mEAAmE;AACnE,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE;iFACiF;AACjF,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAC;AAEhD,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,eAAe,EACf,kBAAkB,EAClB,OAAO,EACP,QAAQ,EACR,OAAO,GACR,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAMV;AAED;6BAC6B;AAC7B,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,MAAM,CAIR;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAEpE;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGrD"}
+{"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../src/composer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mEAAmE;AACnE,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE;iFACiF;AACjF,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAC;AAEhD,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,eAAe,EACf,kBAAkB,EAClB,OAAO,EACP,QAAQ,EACR,OAAO,EACP,KAAa,GACd,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB;+DAC2D;IAC3D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAOV;AAED;6BAC6B;AAC7B,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,MAAM,CAIR;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAEpE;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/dist/composer.js

@@ -6,8 +6,10 @@
  * From loki `src/components/composer/composer-logic.ts`, where these were
  * written after four composers in one app gave four different answers.
  */
-export function composerCanSend({ text, attachmentCount, attachmentOnlyText, sending, disabled, blocked, }) {
-    if (sending || disabled || blocked)
+export function composerCanSend({ text, attachmentCount, attachmentOnlyText, sending, disabled, blocked, queue = false, }) {
+    if (disabled || blocked)
+        return false;
+    if (sending && !queue)
         return false;
     if (text.trim().length > 0)
         return true;

package/dist/composer.js.map

@@ -1 +1 @@
-{"version":3,"file":"composer.js","sourceRoot":"","sources":["../src/composer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,UAAU,eAAe,CAAC,EAC9B,IAAI,EACJ,eAAe,EACf,kBAAkB,EAClB,OAAO,EACP,QAAQ,EACR,OAAO,GAQR;IACC,IAAI,OAAO,IAAI,QAAQ,IAAI,OAAO;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,0EAA0E;IAC1E,4CAA4C;IAC5C,OAAO,eAAe,GAAG,CAAC,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAC5D,CAAC;AAED;6BAC6B;AAC7B,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,eAAuB,EACvB,kBAA2B;IAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,OAAO,eAAe,GAAG,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAA0B;IACzD,OAAO,MAAM,KAAK,KAAK,CAAC;AAC1B,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,IAAY;IAC1D,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACpE,CAAC"}
+{"version":3,"file":"composer.js","sourceRoot":"","sources":["../src/composer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,UAAU,eAAe,CAAC,EAC9B,IAAI,EACJ,eAAe,EACf,kBAAkB,EAClB,OAAO,EACP,QAAQ,EACR,OAAO,EACP,KAAK,GAAG,KAAK,GAWd;IACC,IAAI,QAAQ,IAAI,OAAO;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,OAAO,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,0EAA0E;IAC1E,4CAA4C;IAC5C,OAAO,eAAe,GAAG,CAAC,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAC5D,CAAC;AAED;6BAC6B;AAC7B,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,eAAuB,EACvB,kBAA2B;IAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,OAAO,eAAe,GAAG,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAA0B;IACzD,OAAO,MAAM,KAAK,KAAK,CAAC;AAC1B,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,IAAY;IAC1D,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACpE,CAAC"}

package/dist/dictation.d.ts

@@ -16,8 +16,10 @@
  * Kept pure so "never forever" and "which failures the fallback rescues" are
  * tested properties rather than behaviour buried in a timeout.
  */
-/** Why a dictation produced no text, in terms the person can act on. */
-export type DictationProblem = "mic" | "silence" | "unavailable";
+/** Why a dictation produced no text, in terms the person can act on.
+ *  `fileTooLarge` is the fourth word, for a recording handed over as a file
+ *  (see `isAudioFile`) that the server leg would refuse. */
+export type DictationProblem = "mic" | "silence" | "unavailable" | "fileTooLarge";
 /** Which path to try first. `browser` is free and instant; `server` is one
  *  model everywhere (and detects the language by itself). Either falls back to
  *  the other when it cannot work. */
@@ -36,6 +38,14 @@ export declare function problemFor(error: string | undefined): DictationProblem
 /** getUserMedia / MediaRecorder failures → the same three words, so the UI
  *  never grows a second vocabulary for the same situations. */
 export declare function problemForRecording(error: unknown): DictationProblem;
+/**
+ * The words on screen while a take is live: everything the recogniser has
+ * settled on, then what it is still guessing at — one line, read as it is
+ * spoken. A preview only: when the server leg transcribes, ITS words are
+ * what lands in the box; these are what the person watches meanwhile, so a
+ * take is never a timer and a wave with nothing to show for twenty seconds.
+ */
+export declare function liveWords(finals: readonly string[], interim: string): string;
 /** A working recogniser fires `start` well inside this once the mic is allowed. */
 export declare const START_TIMEOUT_MS = 4000;
 /**
@@ -55,6 +65,56 @@ export declare function deadRecogniserStillTrusted(rememberedAt: number | null,
 export declare const MAX_RECORDING_MS = 120000;
 /** Candidate containers for MediaRecorder, best first. */
 export declare const RECORDING_MIME_CANDIDATES: readonly ["audio/webm;codecs=opus", "audio/webm", "audio/mp4", "audio/ogg"];
+/**
+ * A recording that already exists — a voice memo from the phone's recorder, a
+ * meeting someone taped — is dictation that happened earlier. It goes to the
+ * same server leg as the mic and its words land in the box the same way.
+ *
+ * The cap is on the upload, not the recording: the server compresses and
+ * splits long audio before Whisper, but a phone on mobile data still has to
+ * send the bytes. A one-hour memo from a phone recorder is about 60 MB; this
+ * takes that with room to spare, and refuses the ten-hour one in words rather
+ * than after a ten-minute upload that fails.
+ */
+export declare const MAX_AUDIO_FILE_BYTES: number;
+/**
+ * Does this file hold a recording? By MIME where the browser gives one, by
+ * extension where it does not: Android's picker hands over `.m4a` from the
+ * stock recorder with an empty type often enough that mime alone would call
+ * it a text file and inline the bytes into a prompt.
+ */
+export declare function isAudioFile(file: {
+    type?: string;
+    name?: string;
+}): boolean;
+/** The name a recording travels under. Whisper services read the container
+ *  from the extension, so a mic take keeps the type's extension and a file
+ *  keeps its own name. */
+export declare function audioFileName(audio: {
+    type?: string;
+    name?: string;
+}): string;
+/**
+ * A server leg that refused, with the server's own words when it gave any.
+ *
+ * A failed transcription used to reach the person as one sentence whatever
+ * went wrong — and in OrangeCat as "check your connection", while the server
+ * had answered plainly that it was busy (2026-10-07). `reason` is what the
+ * server said, for the UI to show beside the generic line; a custom
+ * `transcribe` may throw one too.
+ */
+export declare class TranscriptionError extends Error {
+    readonly reason: string | null;
+    readonly status: number | null;
+    constructor(reason: string | null, status?: number | null);
+}
+/** The server's sentence from a failed transcription, if it sent one. Reads
+ *  the shapes servers actually answer with: `{ error }`, `{ message }`,
+ *  `{ error: { message } }`. Capped, because it is shown in a status line. */
+export declare function reasonFromBody(body: unknown): string | null;
+/** What a thrown transcription error says, for any thrower: ours, or an
+ *  app's `transcribe` that sets `reason` on whatever it throws. */
+export declare function reasonOf(error: unknown): string | null;
 /** The default words for each problem. Override per app (and per language). */
 export declare const DEFAULT_DICTATION_MESSAGES: Record<DictationProblem, string>;
 //# sourceMappingURL=dictation.d.ts.map

package/dist/dictation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dictation.d.ts","sourceRoot":"","sources":["../src/dictation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,SAAS,GAAG,aAAa,CAAC;AAEjE;;qCAEqC;AACrC,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAE3E;AAED;gFACgF;AAChF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAa7E;AAED;+DAC+D;AAC/D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAKpE;AAED,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,OAAO,GACzB,OAAO,CAET;AAED;;uCAEuC;AACvC,eAAO,MAAM,sBAAsB,QAA2B,CAAC;AAE/D,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,SAAa,GAAG,OAAO,CAKjG;AAED,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,SAAU,CAAC;AAExC,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB,6EAK5B,CAAC;AAEX,+EAA+E;AAC/E,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAIvE,CAAC"}
+{"version":3,"file":"dictation.d.ts","sourceRoot":"","sources":["../src/dictation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;4DAE4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,SAAS,GAAG,aAAa,GAAG,cAAc,CAAC;AAElF;;qCAEqC;AACrC,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAE3E;AAED;gFACgF;AAChF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAa7E;AAED;+DAC+D;AAC/D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAKpE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,OAAO,GACzB,OAAO,CAET;AAED;;uCAEuC;AACvC,eAAO,MAAM,sBAAsB,QAA2B,CAAC;AAE/D,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,SAAa,GAAG,OAAO,CAKjG;AAED,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,SAAU,CAAC;AAExC,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB,6EAK5B,CAAC;AAEX;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,QAAoB,CAAC;AAItD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAK3E;AAED;;0BAE0B;AAC1B,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAc7E;AAED;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;gBACnB,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW;CAMhE;AAED;;8EAE8E;AAC9E,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAe3D;AAED;mEACmE;AACnE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGtD;AAED,+EAA+E;AAC/E,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAKvE,CAAC"}