diff --git a/.lane/memory/apps/app/src/composer.tsx/01M4YQG7BVWEFZPD56A2BA0VE9-mode-ace-mode-channels-id-an.md b/.lane/memory/apps/app/src/composer.tsx/01M4YQG7BVWEFZPD56A2BA0VE9-mode-ace-mode-channels-id-an.md
index ad94eac4..5e7486db 100644
--- a/.lane/memory/apps/app/src/composer.tsx/01M4YQG7BVWEFZPD56A2BA0VE9-mode-ace-mode-channels-id-an.md
+++ b/.lane/memory/apps/app/src/composer.tsx/01M4YQG7BVWEFZPD56A2BA0VE9-mode-ace-mode-channels-id-an.md
@@ -4,9 +4,9 @@ anchor: function Composer
 created: 2026-10-15T02:50:44Z
 norm: '1'
 sig: 6e0e6c5c8afbd01a
-body_hash: f1ce2fae59a8c894
-raw_hash: 0815737299df6f4a
-vouched: 2026-10-22T15:28:03Z
+body_hash: 5d41556386df9599
+raw_hash: da6fdc606e9e685b
+vouched: 2026-10-22T15:31:22Z
 lines: 99-282
 ---
 
diff --git a/.lane/memory/apps/app/src/composer.tsx/01M4ZSEZBJJ3AMEBTR7SH36FW4-models-are-read-only-while-t.md b/.lane/memory/apps/app/src/composer.tsx/01M4ZSEZBJJ3AMEBTR7SH36FW4-models-are-read-only-while-t.md
index 5869134e..57745d3c 100644
--- a/.lane/memory/apps/app/src/composer.tsx/01M4ZSEZBJJ3AMEBTR7SH36FW4-models-are-read-only-while-t.md
+++ b/.lane/memory/apps/app/src/composer.tsx/01M4ZSEZBJJ3AMEBTR7SH36FW4-models-are-read-only-while-t.md
@@ -4,9 +4,9 @@ anchor: function Composer
 created: 2026-10-15T12:44:15Z
 norm: '1'
 sig: 6e0e6c5c8afbd01a
-body_hash: f1ce2fae59a8c894
-raw_hash: 0815737299df6f4a
-vouched: 2026-10-22T15:28:03Z
+body_hash: 5d41556386df9599
+raw_hash: da6fdc606e9e685b
+vouched: 2026-10-22T15:31:22Z
 lines: 101-290
 ---
 
diff --git a/.lane/memory/apps/app/src/composer.tsx/01M4ZYQVGB6C87WBEV12WPQ8PF-a-withdrawn-message-returns.md b/.lane/memory/apps/app/src/composer.tsx/01M4ZYQVGB6C87WBEV12WPQ8PF-a-withdrawn-message-returns.md
index 8b8e293e..96402efd 100644
--- a/.lane/memory/apps/app/src/composer.tsx/01M4ZYQVGB6C87WBEV12WPQ8PF-a-withdrawn-message-returns.md
+++ b/.lane/memory/apps/app/src/composer.tsx/01M4ZYQVGB6C87WBEV12WPQ8PF-a-withdrawn-message-returns.md
@@ -4,9 +4,9 @@ anchor: function Composer
 created: 2026-10-15T14:16:28Z
 norm: '1'
 sig: 6e0e6c5c8afbd01a
-body_hash: f1ce2fae59a8c894
-raw_hash: 0815737299df6f4a
-vouched: 2026-10-22T15:28:03Z
+body_hash: 5d41556386df9599
+raw_hash: da6fdc606e9e685b
+vouched: 2026-10-22T15:31:22Z
 lines: 104-326
 ---
 
diff --git a/.lane/memory/apps/app/src/panels/terminal.tsx/01M4YSG7VPSWA76RMR94GF5184-the-terminal-s-cmd-k-clear-m.md b/.lane/memory/apps/app/src/panels/terminal.tsx/01M4YSG7VPSWA76RMR94GF5184-the-terminal-s-cmd-k-clear-m.md
index fc8fd344..dc249326 100644
--- a/.lane/memory/apps/app/src/panels/terminal.tsx/01M4YSG7VPSWA76RMR94GF5184-the-terminal-s-cmd-k-clear-m.md
+++ b/.lane/memory/apps/app/src/panels/terminal.tsx/01M4YSG7VPSWA76RMR94GF5184-the-terminal-s-cmd-k-clear-m.md
@@ -4,9 +4,9 @@ anchor: function Terminal
 created: 2026-10-15T03:25:42Z
 norm: '1'
 sig: 9ad6b07a24fa0261
-body_hash: 911da63f1fbfb712
-raw_hash: 90f1050382e16903
-vouched: 2026-10-22T15:24:30Z
+body_hash: 89146e5bb0652ae2
+raw_hash: 14dc8c2e9a8e17aa
+vouched: 2026-10-22T15:30:11Z
 lines: 124-294
 ---
 
diff --git a/.lane/memory/packages/ui/src/components/composer/chat-composer.tsx/01M53E0S8M7RPD1RK65J9NG78E-dictation-writes-only-betwee.md b/.lane/memory/packages/ui/src/components/composer/chat-composer.tsx/01M53E0S8M7RPD1RK65J9NG78E-dictation-writes-only-betwee.md
index 8b298260..a73fca06 100644
--- a/.lane/memory/packages/ui/src/components/composer/chat-composer.tsx/01M53E0S8M7RPD1RK65J9NG78E-dictation-writes-only-betwee.md
+++ b/.lane/memory/packages/ui/src/components/composer/chat-composer.tsx/01M53E0S8M7RPD1RK65J9NG78E-dictation-writes-only-betwee.md
@@ -4,9 +4,9 @@ anchor: function useComposer
 created: 2026-10-16T22:41:13Z
 norm: '1'
 sig: 381929b0cbaf2245
-body_hash: 17515b9210059870
-raw_hash: 30786624d9379566
-vouched: 2026-10-22T15:02:44Z
+body_hash: f4f3cc3dac113b90
+raw_hash: 1066200fbc3f634c
+vouched: 2026-10-22T15:29:58Z
 lines: 597-1226
 ---
 
diff --git a/.lane/memory/packages/ui/src/hooks/use-dictation.ts/01M53CZ2RRXDYDPZWZ8AKNMFH0-deactivating-aborts-and-deta.md b/.lane/memory/packages/ui/src/hooks/use-dictation.ts/01M53CZ2RRXDYDPZWZ8AKNMFH0-deactivating-aborts-and-deta.md
index ffa07226..05e055d8 100644
--- a/.lane/memory/packages/ui/src/hooks/use-dictation.ts/01M53CZ2RRXDYDPZWZ8AKNMFH0-deactivating-aborts-and-deta.md
+++ b/.lane/memory/packages/ui/src/hooks/use-dictation.ts/01M53CZ2RRXDYDPZWZ8AKNMFH0-deactivating-aborts-and-deta.md
@@ -3,9 +3,10 @@ id: 01M53CZ2RRXDYDPZWZ8AKNMFH0
 anchor: function useDictation
 created: 2026-10-16T22:22:49Z
 norm: '1'
-sig: de94e6fe0d9626d6
-body_hash: 78e3734a05619b3c
-raw_hash: 85cbb253122dfd32
+sig: 85f78e4a517cc347
+body_hash: 95229acf42918e4c
+raw_hash: 809dc7b3b022a7fc
+vouched: 2026-10-22T15:29:59Z
 lines: 28-51
 ---
 
diff --git a/apps/app/src/app.tsx b/apps/app/src/app.tsx
index 54260b4b..330bba53 100644
--- a/apps/app/src/app.tsx
+++ b/apps/app/src/app.tsx
@@ -34,7 +34,7 @@ import {
 	projectId,
 } from "@ace/host/protocol";
 
-import { chosen, deployed, remember } from "./address";
+import { chosen, deployed, gateway, remember } from "./address";
 import { type Attention, glow, useAttention } from "./attention";
 import { Channel, ChannelDetails, type ChannelDraft } from "./channel";
 import { useCompute } from "./compute";
@@ -107,12 +107,38 @@ function ChannelsSidebar(props: SessionSidebarProps) {
 	);
 }
 
+/**
+ * Whether the deployed app's host answers HTTP at all. A browser hides why a WebSocket failed, but
+ * an opaque no-cors response still proves the host is reachable, so its gateway refused this app.
+ */
+function useAnswers(): boolean | undefined {
+	const [answers, setAnswers] = useState<boolean>();
+	useEffect(() => {
+		if (!deployed || !gateway) return;
+		const url = new URL(gateway.replace(/^ws/, "http"));
+		url.pathname = "/";
+		fetch(url, { mode: "no-cors", cache: "no-store" }).then(
+			() => setAnswers(true),
+			() => setAnswers(false),
+		);
+	}, []);
+	return answers;
+}
+
 function Disconnected() {
+	const answers = useAnswers();
 	if (desktop) return <>Disconnected from Ace Helper. Open Settings → This Mac to start it.</>;
 	if (!deployed) return <>Disconnected from your host. Reconnecting…</>;
 	return (
 		<>
-			Can't reach {chosen}. Check that Tailscale is on.{" "}
+			{answers
+				? (
+					<>
+						{chosen} refused this web app. On that host, run{" "}
+						<code>ace web {location.origin}</code>, then reload.
+					</>
+				)
+				: <>Can't reach {chosen}. Check that Tailscale is on.</>}{" "}
 			<button
 				type="button"
 				className="underline underline-offset-2"
diff --git a/apps/app/src/composer.tsx b/apps/app/src/composer.tsx
index 7751f8b7..faa9085f 100644
--- a/apps/app/src/composer.tsx
+++ b/apps/app/src/composer.tsx
@@ -11,7 +11,13 @@ import {
 	useLocalStorage,
 	useMedia,
 } from "@ace/ui";
-import type { Effort, ModelOption, ModelRef, QueuedMessage } from "@ace/channel/protocol";
+import {
+	type Effort,
+	MAX_IMAGES,
+	type ModelOption,
+	type ModelRef,
+	type QueuedMessage,
+} from "@ace/channel/protocol";
 import type { Listing } from "@ace/host/protocol";
 
 import { host } from "./host";
@@ -221,6 +227,18 @@ export function Composer(
 	// Formatting tools crowd a phone's composer; they stay one tap away.
 	const phone = useMedia("(width < 40rem)");
 
+	function attach(next: Attachment[]) {
+		let images = 0;
+		const kept = next.filter((item) => !item.type.startsWith("image/") || ++images <= MAX_IMAGES);
+		if (kept.length < next.length) {
+			const left = next.length - kept.length;
+			toast(`A message can carry ${MAX_IMAGES} images`, {
+				description: left === 1 ? "One image wasn't attached." : `${left} images weren't attached.`,
+			});
+		}
+		setAttached(kept);
+	}
+
 	async function send(text: string, mode: string, attached: Attachment[]) {
 		if (sending.current) return;
 		// A blocked teammate's typed "@ace" is just text.
@@ -331,7 +349,7 @@ export function Composer(
 				effort={effort}
 				onEffortChange={(value) => changePick({ model: picked, effort: value as Effort })}
 				attachments={attached}
-				onAttachmentsChange={setAttached}
+				onAttachmentsChange={attach}
 				busy={busy}
 				submitBusy={pending}
 				submitLabel={waiting}
diff --git a/apps/app/src/layout/rename.tsx b/apps/app/src/layout/rename.tsx
index f03cf3bc..5dec8ed7 100644
--- a/apps/app/src/layout/rename.tsx
+++ b/apps/app/src/layout/rename.tsx
@@ -86,6 +86,8 @@ export function Rename(
 						required={required}
 						disabled={busy}
 						aria-invalid={!!error}
+						// The browser blocks a malformed submit before save() could clear a refusal.
+						onChange={() => setError("")}
 						autoCorrect="off"
 						autoCapitalize="off"
 						spellCheck={false}
diff --git a/apps/app/src/panels/terminal.tsx b/apps/app/src/panels/terminal.tsx
index 03a98d6a..cd645187 100644
--- a/apps/app/src/panels/terminal.tsx
+++ b/apps/app/src/panels/terminal.tsx
@@ -138,7 +138,9 @@ export function Terminal({ channel, chat, active, terminal, onTerminal }: Props)
 	const persist = useEffectEvent(onTerminal);
 	if (active && !opened) setOpened(true);
 
-	useLayoutEffect(() => {
+	// Not a layout effect: ThemeProvider toggles the dark class in its own layout effect, which runs
+	// after this child's, so the tokens tone() reads would still be the old theme's.
+	useEffect(() => {
 		schemeRef.current = scheme;
 		if (shell.current) shell.current.options.theme = tone(scheme);
 	}, [scheme]);
diff --git a/apps/app/src/settings.tsx b/apps/app/src/settings.tsx
index 958657da..8c0ae17d 100644
--- a/apps/app/src/settings.tsx
+++ b/apps/app/src/settings.tsx
@@ -198,7 +198,8 @@ function Provider({ provider, disabled }: { provider: ProviderSettings; disabled
 					Check
 				</Button>
 			)}
-			{!editing && (
+			{/* A saved key would go unused while the environment overrides it. */}
+			{!editing && !provider.override && (
 				<Button
 					variant="outline"
 					aria-label={`${provider.stored ? "Replace" : "Add"} ${provider.name} key`}
diff --git a/packages/channel/src/protocol.ts b/packages/channel/src/protocol.ts
index ed6bbf11..5ad6aaad 100644
--- a/packages/channel/src/protocol.ts
+++ b/packages/channel/src/protocol.ts
@@ -184,9 +184,12 @@ export type GithubFile = {
 	error?: string;
 };
 
-/** An image as base64. Clients downscale before sending; see `MAX_IMAGES` in room.ts. */
+/** An image as base64. Clients downscale before sending; see `checkAttachments` in room.ts. */
 export type Image = { mimeType: string; data: string };
 
+/** Images per message; composers refuse more before the channel would. */
+export const MAX_IMAGES = 4;
+
 /** A text file attached to a message; models read its contents beside the message's text. */
 export type TextFile = { name: string; text: string };
 
diff --git a/packages/channel/src/room.ts b/packages/channel/src/room.ts
index 975667b2..8c249653 100644
--- a/packages/channel/src/room.ts
+++ b/packages/channel/src/room.ts
@@ -15,7 +15,7 @@ import {
 } from "@earendil-works/pi-durable";
 
 import { MetadataDoc } from "./metadata";
-import type { Image, TextFile } from "./protocol";
+import { type Image, MAX_IMAGES, type TextFile } from "./protocol";
 
 /** A human message that did not invoke an agent. */
 export const MessageEntry = defineEntry<{ author: string; text: string }>("ace.message");
@@ -65,7 +65,6 @@ function wrap(file: TextFile) {
  * Attachments live in the transcript so every model sees them. A hosted channel stores an entry in
  * one SQLite row, which Durable Objects cap at 2 MB, so a message's attachments must fit under that.
  */
-export const MAX_IMAGES = 4;
 const MAX_FILES = 10;
 const MAX_BYTES = 1_500_000;
 const TYPES = new Set(["image/png", "image/jpeg", "image/webp", "image/gif"]);
diff --git a/packages/ui/src/components/composer/chat-composer.tsx b/packages/ui/src/components/composer/chat-composer.tsx
index cf9bc792..b799fbc4 100644
--- a/packages/ui/src/components/composer/chat-composer.tsx
+++ b/packages/ui/src/components/composer/chat-composer.tsx
@@ -689,7 +689,10 @@ function useComposer({
 		let words = before + text + after;
 		v.dispatch(v.state.tr.insertText(words, from, from + size));
 		dictated.current.size = words.length;
-	}, () => setRecording(false));
+	}, (reason) => {
+		setRecording(false);
+		if (reason) toast("Voice input stopped", { description: reason });
+	});
 
 	let view = useRef<EditorView | null>(null);
 	let file = useRef<HTMLInputElement | null>(null);
@@ -1662,6 +1665,7 @@ function ComposerOptions({ state }: { state: ComposerState }) {
 								<TooltipTrigger
 									render={
 										<Toolbar.Button
+											aria-label="Formatting tools"
 											aria-pressed={toolbar}
 											onClick={() => setToolbar(t => !t)}
 											render={
diff --git a/packages/ui/src/components/composer/composer-toolbar.tsx b/packages/ui/src/components/composer/composer-toolbar.tsx
index cb736f65..d77b16b3 100644
--- a/packages/ui/src/components/composer/composer-toolbar.tsx
+++ b/packages/ui/src/components/composer/composer-toolbar.tsx
@@ -48,26 +48,39 @@ type Item = {
 	label: string;
 	action: Action;
 	icon: ComponentType<{ className?: string }>;
+	/** The editor's binding (rich-text.tsx), as Mod plus these keys. */
+	keys?: string;
 };
 
+const MAC = typeof navigator !== "undefined" && /Mac|iPhone|iPad/.test(navigator.userAgent);
+
+/** `Shift-s` reads ⇧⌘S on a Mac and Ctrl+Shift+S elsewhere. */
+function shortcut(keys: string) {
+	const parts = keys.split("-");
+	const key = parts.pop()!.toUpperCase();
+	if (!MAC) return ["Ctrl", ...parts, key].join("+");
+	const glyphs: Record<string, string> = { Shift: "⇧", Alt: "⌥" };
+	return `${parts.map((part) => glyphs[part]).join("")}⌘${key}`;
+}
+
 const GROUPS: Item[][] = [
 	[
-		{ label: "Bold", action: "bold", icon: BoldIcon },
-		{ label: "Italic", action: "italic", icon: ItalicIcon },
-		{ label: "Underline", action: "underline", icon: UnderlineIcon },
-		{ label: "Strikethrough", action: "strike", icon: StrikeIcon },
+		{ label: "Bold", action: "bold", icon: BoldIcon, keys: "b" },
+		{ label: "Italic", action: "italic", icon: ItalicIcon, keys: "i" },
+		{ label: "Underline", action: "underline", icon: UnderlineIcon, keys: "u" },
+		{ label: "Strikethrough", action: "strike", icon: StrikeIcon, keys: "Shift-s" },
 	],
 	[
 		{ label: "Link", action: "link", icon: LinkIcon },
 	],
 	[
-		{ label: "Ordered list", action: "ordered", icon: OrderedIcon },
-		{ label: "Bullet list", action: "bullet", icon: BulletIcon },
-		{ label: "Blockquote", action: "quote", icon: BlockquoteIcon },
+		{ label: "Ordered list", action: "ordered", icon: OrderedIcon, keys: "Alt-7" },
+		{ label: "Bullet list", action: "bullet", icon: BulletIcon, keys: "Alt-8" },
+		{ label: "Blockquote", action: "quote", icon: BlockquoteIcon, keys: "Shift-." },
 	],
 	[
-		{ label: "Inline code", action: "code", icon: CodeIcon },
-		{ label: "Code block", action: "pre", icon: CodeBlockIcon },
+		{ label: "Inline code", action: "code", icon: CodeIcon, keys: "e" },
+		{ label: "Code block", action: "pre", icon: CodeBlockIcon, keys: "Alt-`" },
 	],
 	[
 		{ label: "Attach", action: "attach", icon: AttachIcon },
@@ -76,7 +89,7 @@ const GROUPS: Item[][] = [
 ];
 
 function ToolbarButton(
-	{ label, action, icon: Icon, active, disabled, onAction }: Item & {
+	{ label, action, icon: Icon, keys, active, disabled, onAction }: Item & {
 		active?: boolean;
 		disabled?: boolean;
 		onAction?: (event: ActionEvent) => void;
@@ -87,6 +100,8 @@ function ToolbarButton(
 			<TooltipTrigger
 				render={
 					<Toolbar.Button
+						aria-label={label}
+						aria-keyshortcuts={keys && `${MAC ? "Meta" : "Control"}+${keys.replaceAll("-", "+")}`}
 						render={
 							<Button
 								variant="ghost"
@@ -110,7 +125,10 @@ function ToolbarButton(
 			>
 				<Icon />
 			</TooltipTrigger>
-			<TooltipContent>{label}</TooltipContent>
+			<TooltipContent>
+				{label}
+				{keys && <kbd data-slot="kbd" className="font-sans opacity-60">{shortcut(keys)}</kbd>}
+			</TooltipContent>
 		</Tooltip>
 	);
 }
diff --git a/packages/ui/src/components/session-item/session-item-actions.tsx b/packages/ui/src/components/session-item/session-item-actions.tsx
index 8d04f83f..326fbbc3 100644
--- a/packages/ui/src/components/session-item/session-item-actions.tsx
+++ b/packages/ui/src/components/session-item/session-item-actions.tsx
@@ -86,7 +86,12 @@ function MoveSection(
 				)}
 				{destinations.state === "ready" && destinations.targets.length === 0 && (
 					<ContextMenu.Item className={MENU_ITEM} disabled>
-						No available destinations
+						<span className="flex min-w-0 flex-1 flex-col">
+							<span className="truncate">Move to… no available destinations</span>
+							<span className="text-muted-foreground">
+								Cloud compute and a GitHub repository let a channel move
+							</span>
+						</span>
 					</ContextMenu.Item>
 				)}
 				{destinations.state === "ready" && destinations.targets.map((target) => {
diff --git a/packages/ui/src/components/session-sidebar/session-options.tsx b/packages/ui/src/components/session-sidebar/session-options.tsx
index 35c757fd..99e4b0fc 100644
--- a/packages/ui/src/components/session-sidebar/session-options.tsx
+++ b/packages/ui/src/components/session-sidebar/session-options.tsx
@@ -8,17 +8,23 @@ import {
 import { Tooltip, TooltipContent, TooltipTrigger } from "../../ui/tooltip";
 import { IconDots } from "../../icons";
 
-/** Additional ways to start a repository session, and sharing or removing the project. */
+/**
+ * Additional ways to start a repository session, archiving inactive channels, and sharing or
+ * removing the project: the section's context menu, plus the starts.
+ */
 export function SessionOptions(
-	{ className, onContinuePr, onStartIssue, onShareProject, onRemoveProject }: {
+	{ className, onContinuePr, onStartIssue, onArchiveInactive, onShareProject, onRemoveProject }: {
 		className?: string;
 		onContinuePr?: () => void;
 		onStartIssue?: () => void;
+		onArchiveInactive?: () => void;
 		onShareProject?: () => void;
 		onRemoveProject?: () => void;
 	},
 ) {
-	if (!onContinuePr && !onStartIssue && !onShareProject && !onRemoveProject) return null;
+	if (
+		!onContinuePr && !onStartIssue && !onArchiveInactive && !onShareProject && !onRemoveProject
+	) return null;
 	return (
 		<DropdownMenu>
 			<Tooltip>
@@ -47,6 +53,9 @@ export function SessionOptions(
 				{onStartIssue && (
 					<DropdownMenuItem onClick={onStartIssue}>Start from an issue…</DropdownMenuItem>
 				)}
+				{onArchiveInactive && (
+					<DropdownMenuItem onClick={onArchiveInactive}>Archive inactive</DropdownMenuItem>
+				)}
 				{onShareProject && (
 					<DropdownMenuItem onClick={onShareProject}>Share project…</DropdownMenuItem>
 				)}
diff --git a/packages/ui/src/components/session-sidebar/session-sidebar.tsx b/packages/ui/src/components/session-sidebar/session-sidebar.tsx
index 7f6a5f89..5fa27cf0 100644
--- a/packages/ui/src/components/session-sidebar/session-sidebar.tsx
+++ b/packages/ui/src/components/session-sidebar/session-sidebar.tsx
@@ -672,6 +672,7 @@ function Group({
 										className={actionButtonClassName}
 										onContinuePr={onContinuePr}
 										onStartIssue={onStartIssue}
+										onArchiveInactive={archiveInactive}
 										onShareProject={shareProject}
 										onRemoveProject={group.onRemove}
 									/>
diff --git a/packages/ui/src/hooks/use-dictation.ts b/packages/ui/src/hooks/use-dictation.ts
index f7b0790e..f9184d7d 100644
--- a/packages/ui/src/hooks/use-dictation.ts
+++ b/packages/ui/src/hooks/use-dictation.ts
@@ -6,6 +6,7 @@ type Recognition = {
 	lang: string;
 	onresult: ((event: { results: ArrayLike<ArrayLike<{ transcript: string }>> }) => void) | null;
 	onend: (() => void) | null;
+	onerror: ((event: { error: string }) => void) | null;
 	start(): void;
 	abort(): void;
 };
@@ -19,13 +20,26 @@ const Speech = typeof window === "undefined"
 /** Whether this runtime can transcribe speech. */
 const canDictate = Boolean(Speech);
 
+/** Why recognition stopped, for the errors a person can act on; silence ends without one. */
+const REASONS: Record<string, string> = {
+	"not-allowed": "Microphone access is off for Ace. Allow it in your browser or system settings.",
+	"service-not-allowed": "Speech recognition is turned off on this device.",
+	"audio-capture": "No microphone was found.",
+	network: "Speech recognition needs a network connection.",
+	"language-not-supported": "Speech recognition doesn't support this language.",
+};
+
 /**
  * Transcribe the microphone while `active`. `onText` receives the whole session's transcript,
  * interim words included, each time it changes; `onEnd` runs when recognition stops on its own
- * (silence, error, or a denied permission). Deactivating aborts, so the last interim words stand
+ * (silence, error, or a denied permission), with a reason when a person can act on it. Deactivating aborts, so the last interim words stand
  * and no late result lands after the caller has moved on.
  */
-function useDictation(active: boolean, onText: (text: string) => void, onEnd: () => void) {
+function useDictation(
+	active: boolean,
+	onText: (text: string) => void,
+	onEnd: (reason?: string) => void,
+) {
 	let handlers = useRef({ onText, onEnd });
 	handlers.current = { onText, onEnd };
 
@@ -40,11 +54,14 @@ function useDictation(active: boolean, onText: (text: string) => void, onEnd: ()
 			for (let i = 0; i < results.length; i++) text += results[i]![0]!.transcript;
 			handlers.current.onText(text);
 		};
-		recognition.onend = () => handlers.current.onEnd();
+		let reason: string | undefined;
+		recognition.onerror = ({ error }) => reason = REASONS[error];
+		recognition.onend = () => handlers.current.onEnd(reason);
 		recognition.start();
 		return () => {
 			recognition.onresult = null;
 			recognition.onend = null;
+			recognition.onerror = null;
 			recognition.abort();
 		};
 	}, [active]);