@oar-sh/oar 0.9.20 → 0.9.22

package/CHANGELOG.md

@@ -3,6 +3,331 @@
 All notable changes to OAR are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions follow semver.
 
+## [0.9.22] — 2026-11-05
+
+Highlights: questions that don't block move into the chat header. A **📓**
+icon with a count opens them, urgent ones first, and the turn that asked
+keeps one line, "📓 Question for you", in place of the card. Settings →
+General reads as five headed sections, with three new choices: whether
+thoughts start open while an agent works, how many tool lines a working
+agent shows, counted per agent so a busy sub-agent no longer pushes out the
+main agent's lines, and a stream view that shows a turn's thoughts and tool
+calls in the order they happened. While a turn runs, the page's poll leaves
+out what it already holds, and an idle relay and its workers wake far less
+often. Claude sessions now ask you in a **Safety check** card, which only
+you can answer, before removals and other asks Claude Code marks as
+person-only.
+
+### Changed
+
+- **📓 Questions in the chat header.** A conversation's questions that don't
+  block sit behind a 📓 icon with a count, first among the header icons (in
+  ︙ when the header runs out of room). It opens a list under it with the
+  full cards, urgent ones first with their details open, and what was
+  answered in the last day below; answering keeps the list open. On a phone
+  the list spans the width over a dimmed page, with half-width buttons. While
+  an urgent question waits, 📓 and the Inbox show the urgent count in red.
+  The Inbox's link to a session opens it with 📓 at that question. Each ask
+  now remembers the turn that asked it (migration 0037).
+- **A question leaves one line in the turn that asked it.** The cards of
+  questions that don't block no longer sit at the end of the conversation;
+  the reply of the turn that asked shows a one-line "📓 Question for you"
+  instead (live while it runs, "Answered: …" once answered), and a tap opens
+  📓 at that question. A question asked for another session, carried over by
+  a compaction or from before this version stands as one line at the end
+  while it waits.
+- **Settings → General in headed sections.** The tab reads as five groups,
+  Appearance, Reading, Turns and tasks, This relay and Updates, instead of
+  one long column. Each relay-wide row now says it is a setting of this
+  relay; the per-browser rows keep "Saved in this browser."
+- **Thoughts open or closed by your choice.** Settings → General →
+  Appearance has "Expand thoughts while an agent works" (on by default), with
+  a 💭 Thoughts mirror in the 🧠 modal. It decides whether thoughts start open
+  in the live turn, in live sub-agent bubbles and in the sub-agent viewer,
+  finished thoughts there included. An open live thought keeps a one-line
+  header to fold it by; a thought you fold or open by hand stays that way
+  while more text streams in. A finished reply's 💭 fold stays closed as
+  before.
+- **The main agent's tool lines stay while sub-agents work.** The live
+  bubble's tool list is capped per agent now, the main agent and each
+  sub-agent apart, so a busy sub-agent no longer pushes the main agent's
+  lines out. Settings → General → Appearance has "Tool lines shown while an
+  agent works": 50 by default, 10 to 500 or no limit. The relay sends the
+  running turn's newest lines per agent as the page's setting asks (50 when
+  it does not say, 500 at most), and for a finished turn the main agent's
+  newest 200 and each sub-agent's newest 50 (it sent the first 48 of the
+  whole turn). A sub-agent bubble that holds as many lines as the setting
+  shows "50+ steps".
+- **Stream view: a turn in the order it happened.** Settings → General →
+  Appearance has "Stream view" (off by default), with a 🧵 mirror in the 🧠
+  modal. When it is on, an agent turn's thoughts and tool calls show as one
+  list in the order they happened, live and in the finished message, with
+  the reply last. For Copilot, Cursor and Grok, tools and thoughts stream in
+  arrival order and the reply comes after them. The relay now numbers a
+  turn's thoughts and tool lines in one sequence (migration 0038); turns
+  recorded before that keep the grouped layout. A finished turn whose main
+  agent ran more than 200 tool lines says how many earlier ones it left out.
+- **The live poll leaves out what the page already has.** While a turn
+  runs, the page asks for its conversation about once a second. It now
+  names the finished replies whose tool lines and thoughts it already holds,
+  and the relay leaves those out unless they changed since (a busy window:
+  about 6 KB per poll instead of over 200 KB). Opening a conversation,
+  paging back and every other load still get everything.
+- **An idle relay and its workers wake far less often.** The relay no
+  longer polls its queue twice a second: a write that makes a message
+  deliverable wakes delivery at once, through triggers on the queue table.
+  A retry or a usage-limit hold gets a timer for the moment it ends, and a
+  10 s poll stays as a backstop. A gate lifting (relay resumed, restart
+  cancelled, tunnel connected, a kill's grace over, a worker replacement
+  done) wakes delivery too. The CLI status, the share-viewer prune and the
+  worker prime run only while there is something for them to do. Each
+  worker has one keepalive instead of two 10 s timers, and it beats every
+  30 s while idle, on a relay that supports it. A silent worker now counts
+  as gone after 90 s instead of 30 s. Workers and relays of older versions
+  keep working with the new ones.
+- **Claude sessions ask you before removals and other asks Claude Code
+  marks as person-only, instead of allowing them.** Such an ask, for
+  example an `rm -rf` of the working folder, used to be approved by the
+  relay like every other ask. Now a **Safety check** card, in the session
+  and in the Inbox, shows Claude Code's reason
+  and then the whole command, each line behind `│`, with hidden or
+  reordering characters shown as `\u{…}`. It offers **Allow once** and
+  **Deny**, takes no typed reply, and only you can answer it: no agent,
+  of this relay or another, sees it among a session's questions or may
+  answer it. It allows only that one call and adds no rule. A denial, no
+  answer within the question timeout, a stopped turn or a relay that
+  cannot show the card all leave the command unrun, and a command too long
+  to show is refused without a card. Other asks are still allowed as
+  before.
+
+### Upgrade notes
+
+- **Two small migrations.** 0037 adds the asking turn to each ask and 0038
+  the sequence number to a turn's thoughts and tool lines, with an index;
+  neither rewrites the rows already there. As before, the relay copies its
+  database to the backups folder before the first start of a new version.
+- **Every session worker is replaced once after the update,** as in
+  0.9.21: once its session is idle and its CLI has ended, usually some 10
+  minutes after its last turn. A Claude session shows the **Safety check**
+  card once its worker runs 0.9.22. Nothing needs to be done.
+- **Mixed versions work together.** A 0.9.21 worker on a 0.9.22 relay keeps
+  its 10 s beat, and a 0.9.22 worker on a 0.9.21 relay beats every 10 s.
+  Paired relays of both versions keep working with each other.
+- **No new dependency.** Going back to 0.9.21 needs no database step: it
+  leaves the new columns and the index alone.
+
+## [0.9.21] — 2026-11-01
+
+Highlights: the chat screen is more compact. The mode, model, effort,
+context window and billing of a chat move behind **⚙** in a slim label row
+above the message box, such as `🔒 Opus 5.5 · high · Auto`. The header menu
+is now **︙**, and the header's icon buttons stay there while there is room
+and move into it when there is not. Spacing is about halved across the app,
+with controls and hit areas at 28 px. Back and forward walk through the
+conversations you opened, with `?conv=<id>` in the address bar, and back
+closes what is open on top first. A pinch, Ctrl/⌘+wheel or Text scaling
+zooms the whole app, not only the text. A phone held sideways keeps the
+phone's layout. A session group folds while one of its chats is open, the
+filter row folds or unfolds all groups at once, and a group's name takes
+its sessions' colour. The origin, watched and scheduled pills of a sidebar
+row become one **ⓘ**. After a deploy, the relay replaces each session worker
+still on the old code once its session is idle, so a restart no longer
+leaves old worker code running.
+
+### Added
+
+- **Chat settings behind ⚙ in the composer.** A slim label row above the
+  message box holds **⚙**, a label that says what the next message runs
+  with (model · effort · mode, such as `🔒 Opus 5.5 · high · Auto`, with the
+  context window added when it is not the model's default), the billing pill
+  of a Claude chat, the file browser, **📎** and, on a desktop, **🙂**. **⚙**,
+  or a tap on the label, opens the settings: **Mode**, **Model** with the
+  lock note under it, **Effort**, **Context window**, **Billing** and
+  **🧠 Context usage**. A tap on one part of the label opens them at that
+  field, and the **Subscription** or **API key** pill at **Billing**. On a
+  desktop they open as a popover above the row, on a phone as a sheet from
+  the bottom; **✕**, Escape, a tap outside or back closes them. An image
+  chat shows **Quality** and **Image size** in place of Effort and Context
+  window; a Claude Cloud chat has only **Model**. The label reads **Auto**
+  for the autopilot mode (the settings keep the full name) and **Plan 🔒**
+  on a plan-only session.
+- **Back and forward through conversations.** Each conversation you open is
+  one step in the browser's history, with `?conv=<id>` in the address bar,
+  so back and forward walk through them, and a reload or a copied address
+  opens that conversation. The tab's title is the conversation's title.
+  Back first closes what is open on top: the session list on a phone, the
+  Inbox or Status view, the composer's settings, the **︙** menu, a row's
+  menu, dialogs, the git, tmux and annotate views, the watch and schedule
+  panels, the emoji picker and the Change CWD folder list. On a phone, back
+  from the first conversation you opened shows the session list, then the
+  installed app's *Press back again to close the app* as before.
+  - A link to a conversation the relay does not know (deleted, or a wrong
+    id) clears the view with a notice and keeps the last conversation; back
+    and forward step over it from then on, and nothing opens by itself until
+    you pick a conversation. A link to an archived conversation shows its
+    title.
+  - No address is written before the first conversation shows, so a link
+    survives an early tap. A jump from the Inbox to a question replaces the
+    history entry instead of adding one.
+  - A notification tap still opens `?push_conv=<id>`; the address then
+    reads `?conv=<id>`.
+- **Zoom scales the whole app.** A pinch, Ctrl+wheel (⌘+wheel on a Mac) or
+  **⚙️ Settings → General → Text scaling** now zooms text, buttons,
+  spacing, the sidebar, menus and dialogs alike, so the layout keeps its
+  proportions; at 100 % nothing changes. Popovers and sheets are placed
+  anew on a change. The new-chat dialog's selects and inputs follow the
+  zoom too (they stayed at the browser's fixed 13.33 px).
+- **A phone held sideways keeps the phone's layout.** The header is one
+  line. While the keyboard is up, the composer's label row folds into a
+  floating **⚙** that opens the settings and keeps the keyboard up, and the
+  background-task line into a floating **🤖**; both come back when the
+  keyboard goes down. Picking a conversation closes the session list and
+  does not bring up the keyboard (a long press does not pick). The **︙**
+  menu gains entries for the watch list, the schedules and the origin.
+- **Fold a group with its chat open, and fold all.** A group folds even
+  while one of its sessions is open; that session stays under the folded
+  head until you open another one, and opening a member of a folded group
+  leaves it folded. A drop on that kept row is a drop on the folded head.
+  While the list has groups, the filter row has a fold-all button: **➖**
+  folds every group, **➕** unfolds them all once all are folded. It counts
+  as your own choice for each group and is disabled while the list is
+  filtered. The Archived view keeps its folds apart from the live list.
+- **A group's name takes its sessions' colour:** red while one waits for
+  you, bright green while one works, dark green while one is idle with its
+  session ready, else the plain title colour. Archived heads stay muted.
+- **ⓘ on sidebar rows.** The origin, watched and scheduled pills of a row
+  fold into one **ⓘ** in its second line. Its menu lists each with its
+  action: *Started by an agent in "…"* (or *on relay "…"*), which opens
+  that conversation or the session on the other relay, *Watched by …* with
+  the watchers' names, and *Scheduled · next …* (or *N schedules · next
+  …*). A member under the head row of the session that started it leaves
+  the origin out.
+- **Session workers are recycled after a deploy.** Every worker states the
+  build id (version and commit) it started on; a worker on another build than
+  the relay, or one too old to say, is stopped and relaunched by the relay
+  once it is idle, the way **Change CWD → 🚀 Set new CWD and (re)launch**
+  does, so a restart no longer leaves old worker code running. An archived conversation's worker is
+  stopped for good. `/api/status` and the About modal show which build each
+  worker runs.
+  - Idle means no running turn, open question card, compaction, background
+    task or message on its way in, and the worker's CLI has ended. A CLI
+    ends by itself about 10 minutes after the last delivery or turn, so a
+    session is usually replaced some 10 minutes after its last turn. A
+    worker too old to say whether its CLI runs is replaced after 10 minutes
+    without a delivery or turn end. At most two are replaced at a time, one
+    start every 3 seconds, and each session once per relay build.
+  - Nothing is lost: the new worker resumes the native session, and a
+    message sent meanwhile waits and goes to the new worker. A Cursor
+    session is the exception for background shells and tasks, which its SDK
+    does not report: only the 10-minute quiet window protects them.
+  - **About OAR** shows *Workers: 14, all on this build* or *Workers: 14,
+    3 on an older build*. `/api/status` gives the relay's `buildId` and,
+    per worker, `buildId`, `startedAt` and `stale`, and the recycle's
+    `staleCount`, replacements and the sessions it waits on with the reason.
+    relay_tool's session items carry `worker { kind, buildId, stale }`.
+    The relay log has `[worker-recycle]` lines for each replacement and,
+    at most once a minute per session, what it waits for.
+  - A Claude Cloud worker opens its event stream from the stored cursor at
+    start, so turns the cloud session starts by itself are followed after a
+    replacement too. New worker route `GET /api/claude-cloud-session`.
+  - The troubleshooting guide has a section, *Workers after a deploy*.
+
+### Changed
+
+- **The header menu is ︙, and the icon buttons move into it when the
+  header is narrow.** **📍** pins and **🙈** hidden messages (while there
+  are any), **🔍** search, **🧠** context usage, **📊** Check Usage,
+  **☀️/🌙** Day/Night and **⛶** fullscreen stay in the header while there is
+  room and move into **︙** under their full names otherwise, the last ones
+  first. The menu stays inside the window, is capped in height and scrolls.
+  Fullscreen is disabled where the browser has none. Relay refusals, log
+  lines and help texts that named the `⋯` menu now name **︙**.
+- **The open-question banner sits between the title and the header
+  buttons,** so **︙** always stays at the right edge. Where room is short
+  (a phone held sideways, a narrow desktop window) it shrinks to a **❓ N**
+  chip; on a wider header it takes at most 40 % of the row and ends in "…".
+  A long title ends in "…" too. When even the chip, **☰** and **︙** do not
+  fit next to the title, as at 150 % zoom with the sidebar open, the banner
+  takes a row of its own; on a phone held upright it always does.
+- **About half the spacing, and 28 px controls.** Paddings, margins and
+  gaps in menus, the sidebar, dialogs, Settings, cards, bubbles and panels
+  are about halved, and controls that were 30 to 46 px high are 28 px, also
+  dialog buttons and tabs. Every hit area is at least 28 px at 100 %: the
+  row's **ⓘ**, fold, archive and delete, the live reply's **Stop** and
+  **💭 📃 🛠️** follow buttons, the Previews tab's **Open**, **Copy link**
+  and **Close**, the phone's header chips and the
+  question banner, the sidebar head buttons, Settings fields, selects,
+  checkboxes, radios and sliders, the repo browser's toolbar, the group
+  picker, the dialogs' **×** and **↻**, the Relays **Add**, the Sharing
+  row buttons, **Unsubscribe** and **Cancel**. Small labels and links get
+  an invisible 28 px hit area: the repo browser's Focus and crumbs, tree
+  rows, Sharing row titles, DeepSeek **Advanced**, the plan-only label, the
+  waiting pill, the agent-exchange and activity folds and the header chips.
+- **On a phone the lines under the title are one row** that scrolls
+  sideways, with short labels (`↗ title`, `👁 3`, `⏰ 04:15`, the folder's
+  last name), and the open-question banner gets a row of its own.
+- **Dialogs on a phone keep their title** with a compact **×**; the header
+  buttons no longer stretch across the width. Select Models puts its three
+  buttons under the title.
+- **A group's head.** One chevron **›** that turns down while the group is
+  open replaces ▾/▸; focus returns to it only after a keyboard toggle, with
+  a focus ring in the accent colour. A head line without a head row reads
+  "<last active> · N sessions", and its pill shows only what waits, runs or
+  failed. A long head drops its message count whole, then its date, instead
+  of cutting them. A mouse click on **ⓘ** hands focus back without a ring.
+- **Sidebar rows.** The title and the "1 open" pill share one line and only
+  the title is cut short; the title and meta line keep clear of the archive
+  and delete buttons. Archive and delete show on keyboard focus too. The
+  filter row's archive button reads **🗄️**, and the buttons close up to the
+  right when **×** or **➕** is hidden. The sidebar head follows the zoom and
+  wraps instead of cutting off **Inbox** or **Install**.
+- **The Claude usage warning above the composer is one line,** such as
+  `⚠ Claude 94 % weekly · resets Tue 04:00`; a tap shows the full sentence.
+- **A sub-agent's Stop is red and asks first** (**⏹ Stop agent**).
+- **On a phone a background task's title has its own full-width line.**
+- **Images in messages have no card around them.**
+- **Editing a chat's title on a desktop takes the whole header row** while
+  you type; the title lines, the banner and the header buttons come back
+  when you are done.
+- **Settings takes the focus when it opens, and Escape closes it.** The
+  Settings and Plan usage tab strips fade at an edge while more tabs lie
+  beyond it, and keep the selected tab in view. The Features help wraps
+  long identifiers.
+- **Pack guard ceilings.** The npm tarball may hold 610 entries and 9.5 MiB
+  unpacked (590 and 9 MiB before); 0.9.20 had used 99.3 % of the bytes.
+
+### Fixed
+
+- **The archive button on a sidebar row is visible on touch screens.** It
+  was invisible there but could still be tapped.
+- **A ︙ entry tapped on a phone no longer closes what it opened.** The tap's
+  follow-up click landed on the menu's backdrop or the new dialog and closed
+  it again: About, Kill session, Check Usage, Context, Restart relay and
+  Search, and the watch and schedule panels; Git changes did not open a
+  diff.
+- **Contrast in the light theme.** Primary buttons read at 5.19:1, red
+  buttons at 4.67:1, the sidebar's "1 open" pill at 6.47:1, Settings help
+  links at 6.85:1, the offline banner at 5.6:1 and the **☰** status tones
+  at 4.9:1 or more. A hovered accent button gets a darker fill (6.36:1)
+  instead of turning paler.
+- **Status and the Inbox, closed with nothing to go back to,** show their
+  empty state instead of a blank pane.
+- **The OpenAI, Grok and Cursor fields in Settings look like the others,**
+  and **Use a different token** and **Empty queue** are real buttons.
+- **The ⚙ popover fits its width under zoom,** the full origin title shows,
+  and focus is kept when the list or header is drawn anew.
+
+### Upgrade notes
+
+- **Every session worker is replaced once after the update.** Workers from
+  0.9.20 state no build id, so 30 seconds after the relay first hears of
+  one it counts as on an older build and is replaced once its session is
+  idle and its CLI has ended, usually some 10 minutes after its last turn.
+  About shows *M on an older build* until then. Nothing needs to be done.
+  Each replacement costs one cold start on the session's next message.
+- **No migration and no new dependency.** Going back to 0.9.20 needs no
+  database step.
+
 ## [0.9.20] — 2026-10-29
 
 Highlights: every plan card gets an "Approve plan" button that approves the

package/README.md

@@ -45,29 +45,29 @@ flowchart LR
 <table>
 <tr>
 <td width="42%" rowspan="4" valign="top">
-<a href="https://oar.sh/assets/shots/cfmail-mobile.png?v=0.9.20"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-mobile.light.png?v=0.9.20"><img src="https://oar.sh/assets/shots/cfmail-mobile.png?v=0.9.20" alt="OAR on a phone: a finished agent turn in a conversation, with the composer below"></picture></a>
+<a href="https://oar.sh/assets/shots/cfmail-mobile.png?v=0.9.22"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-mobile.light.png?v=0.9.22"><img src="https://oar.sh/assets/shots/cfmail-mobile.png?v=0.9.22" alt="OAR on a phone: a finished agent turn in a conversation, with the composer below"></picture></a>
 <br><sub>On a phone: the same conversations, installable as an app.</sub>
 </td>
 <td width="58%" valign="top">
-<a href="https://oar.sh/assets/shots/cfmail-agents.png?v=0.9.20"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-agents.light.png?v=0.9.20"><img src="https://oar.sh/assets/shots/cfmail-agents.png?v=0.9.20" alt="Background subagents running in parallel in the task panel, each with live token counts, elapsed time, and its own Stop button"></picture></a>
+<a href="https://oar.sh/assets/shots/cfmail-agents.png?v=0.9.22"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-agents.light.png?v=0.9.22"><img src="https://oar.sh/assets/shots/cfmail-agents.png?v=0.9.22" alt="Background subagents running in parallel in the task panel, each with live token counts, elapsed time, and its own Stop button"></picture></a>
 <br><sub>Agents working in parallel, each with live token counts and its own Stop.</sub>
 </td>
 </tr>
 <tr>
 <td valign="top">
-<a href="https://oar.sh/assets/shots/cfmail-question.png?v=0.9.20"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-question.light.png?v=0.9.20"><img src="https://oar.sh/assets/shots/cfmail-question.png?v=0.9.20" alt="A question card in the middle of a turn: the agent offers several choices and a free-text reply"></picture></a>
+<a href="https://oar.sh/assets/shots/cfmail-question.png?v=0.9.22"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-question.light.png?v=0.9.22"><img src="https://oar.sh/assets/shots/cfmail-question.png?v=0.9.22" alt="A question card in the middle of a turn: the agent offers several choices and a free-text reply"></picture></a>
 <br><sub>When the agent needs a decision, it asks, and waits for your answer.</sub>
 </td>
 </tr>
 <tr>
 <td valign="top">
-<a href="https://oar.sh/assets/shots/pingcf-thoughts.png?v=0.9.20"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/pingcf-thoughts.light.png?v=0.9.20"><img src="https://oar.sh/assets/shots/pingcf-thoughts.png?v=0.9.20" alt="An expanded Thoughts block showing the agent's reasoning above its reply"></picture></a>
+<a href="https://oar.sh/assets/shots/pingcf-thoughts.png?v=0.9.22"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/pingcf-thoughts.light.png?v=0.9.22"><img src="https://oar.sh/assets/shots/pingcf-thoughts.png?v=0.9.22" alt="An expanded Thoughts block showing the agent's reasoning above its reply"></picture></a>
 <br><sub>Read the reasoning, not just the answer.</sub>
 </td>
 </tr>
 <tr>
 <td valign="top">
-<a href="https://oar.sh/assets/shots/pagewright-watching.png?v=0.9.20"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/pagewright-watching.light.png?v=0.9.20"><img src="https://oar.sh/assets/shots/pagewright-watching.png?v=0.9.20" alt="A session watching two other sessions: a finished reply arrives as a compact relay-event row, the watching 2 sessions list is open with Unsubscribe, and a request to also watch a session on a paired relay waits on an Allow / Deny card"></picture></a>
+<a href="https://oar.sh/assets/shots/pagewright-watching.png?v=0.9.22"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/pagewright-watching.light.png?v=0.9.22"><img src="https://oar.sh/assets/shots/pagewright-watching.png?v=0.9.22" alt="A session watching two other sessions: a finished reply arrives as a compact relay-event row, the watching 2 sessions list is open with Unsubscribe, and a request to also watch a session on a paired relay waits on an Allow / Deny card"></picture></a>
 <br><sub>Agents that watch agents: woken by events, approving nothing.</sub>
 </td>
 </tr>
@@ -118,11 +118,11 @@ API keys are entered in **⚙️ Settings** and stay on the relay host. The Clau
 <table>
 <tr>
 <td width="62%" valign="top">
-<a href="https://oar.sh/assets/shots/cfmail-steering.png?v=0.9.20"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-steering.light.png?v=0.9.20"><img src="https://oar.sh/assets/shots/cfmail-steering.png?v=0.9.20" alt="A running Claude turn with a message steered into it mid-turn, the reply streaming with its tool calls, and the Steer button in the composer"></picture></a>
+<a href="https://oar.sh/assets/shots/cfmail-steering.png?v=0.9.22"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/cfmail-steering.light.png?v=0.9.22"><img src="https://oar.sh/assets/shots/cfmail-steering.png?v=0.9.22" alt="A running Claude turn with a message steered into it mid-turn, the reply streaming with its tool calls, and the Steer button in the composer"></picture></a>
 <br><sub>Send a message while the agent works, and it steers the running turn.</sub>
 </td>
 <td width="38%" valign="top">
-<a href="https://oar.sh/assets/shots/usage-copilot-compact.png?v=0.9.20"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/usage-copilot-compact.light.png?v=0.9.20"><img src="https://oar.sh/assets/shots/usage-copilot-compact.png?v=0.9.20" alt="The GitHub Copilot card in Check Usage: premium requests and plan quota with reset dates, and the cost of the last turn"></picture></a>
+<a href="https://oar.sh/assets/shots/usage-copilot-compact.png?v=0.9.22"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/usage-copilot-compact.light.png?v=0.9.22"><img src="https://oar.sh/assets/shots/usage-copilot-compact.png?v=0.9.22" alt="The GitHub Copilot card in Check Usage: premium requests and plan quota with reset dates, and the cost of the last turn"></picture></a>
 <br><sub>What each plan has left, in one place.</sub>
 </td>
 </tr>
@@ -132,14 +132,14 @@ API keys are entered in **⚙️ Settings** and stay on the relay host. The Clau
 - **Steer or queue**: a message sent during a turn goes into it (Claude, Copilot) or waits behind it ([While a turn runs](docs/web-ui.md#while-a-turn-runs)).
 - **Answer questions**: the agent asks on a card with one-click choices, checkmarks or free text, and waits for you ([Question cards](docs/web-ui.md#question-cards)).
 - **Background work**: a task panel lists the commands and sub-agents that outlive a reply, each with its own **Stop** and its full record; a command's console shows its output live, says when it has gone quiet and counts a test run's passes and failures; the panel and its consoles come back after a relay restart, and a queued restart shows what it waits for and asks after a maximum wait ([Background tasks](docs/web-ui.md#background-tasks), [After a relay restart](docs/web-ui.md#after-a-relay-restart)).
-- **Choose how the agent works**: `ask`, `plan`, `agent` or `autopilot`, plus model and reasoning effort, per message ([Relay modes](docs/web-ui.md#relay-modes)).
+- **Choose how the agent works**: `ask`, `plan`, `agent` or `autopilot`, plus model and reasoning effort, per message, from the composer's **⚙** ([The composer](docs/web-ui.md#the-composer), [Relay modes](docs/web-ui.md#relay-modes)).
 - **Files and git**: browse the workspace, preview files, review git changes in a diff viewer, and publish a dev server as a preview link ([Files, git, and previews](docs/web-ui.md#files-git-and-previews), [preview servers](docs/preview-servers.md)).
 - **Usage and context**: plan limits and credits of every provider, the estimated spend of DeepSeek and Claude API keys, and what fills the model's context window ([Usage and context](docs/web-ui.md#usage-and-context)).
 - **Your conversations everywhere**: the history lives on the relay, drafts follow you from device to device, and conversations can be searched, archived, grouped and pinned ([The conversation list](docs/web-ui.md#the-conversation-list), [drafts](docs/web-ui.md#drafts-across-devices), [session groups](docs/web-ui.md#session-groups), [pins](docs/web-ui.md#pinned-messages)).
 - **Share** a conversation as a read-only link, hide single messages and the host's paths from it, and see when it was opened ([Sharing](docs/web-ui.md#sharing)).
-- **On your phone**: install OAR as an app and get push notifications ([Notifications and the app](docs/web-ui.md#notifications-and-the-app)).
+- **On your phone**: install OAR as an app and get push notifications; back walks through the conversations you opened, a pinch zooms the whole app, and held sideways it keeps a phone's layout ([Notifications and the app](docs/web-ui.md#notifications-and-the-app), [back and forward](docs/web-ui.md#back-and-forward), [zoom](docs/web-ui.md#zoom), [a phone held sideways](docs/web-ui.md#a-phone-held-sideways)).
 
-The full tour is in [Using the web UI](docs/web-ui.md); every setting and config key is in [Settings and configuration](docs/configuration.md). What changed in each release is in the [changelog](CHANGELOG.md), with [0.9.20](CHANGELOG.md#0920--2026-10-29) as the latest.
+The full tour is in [Using the web UI](docs/web-ui.md); every setting and config key is in [Settings and configuration](docs/configuration.md). What changed in each release is in the [changelog](CHANGELOG.md), with [0.9.22](CHANGELOG.md#0922--2026-11-05) as the latest.
 
 ## Remote access
 
@@ -190,7 +190,7 @@ flowchart LR
 
 You stay in charge: per paired relay you decide whether agents may only read, also prompt, or do everything, and in the `ask` and `plan` modes every write asks you first. A subscription only notifies; it approves nothing.
 
-<p><a href="https://oar.sh/assets/shots/pagewright-cross-relay.png?v=0.9.20"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/pagewright-cross-relay.light.png?v=0.9.20"><img src="https://oar.sh/assets/shots/pagewright-cross-relay.png?v=0.9.20" alt="A session watching two sessions on a paired relay: a reply arrives as a relay-event row, and after a short outage the events the other relay kept arrive as one replayed row" width="720"></picture></a></p>
+<p><a href="https://oar.sh/assets/shots/pagewright-cross-relay.png?v=0.9.22"><picture><source media="(prefers-color-scheme: light)" srcset="https://oar.sh/assets/shots/pagewright-cross-relay.light.png?v=0.9.22"><img src="https://oar.sh/assets/shots/pagewright-cross-relay.png?v=0.9.22" alt="A session watching two sessions on a paired relay: a reply arrives as a relay-event row, and after a short outage the events the other relay kept arrive as one replayed row" width="720"></picture></a></p>
 
 How pairing, permissions and limits work is in [Agents working together](docs/agents-together.md).
 
@@ -211,7 +211,7 @@ How keys, cookies, served files, paired relays and Claude Cloud's use of the Cla
 | A runtime is missing from **New Chat** | Turn it on in **⚙️ Settings → Providers**; all of them except Copilot are off until you do |
 | A reply says a CLI is missing or signed out | Press the button on the failed reply (**Install Grok CLI**, **Sign in to Grok**, **Claude settings**) |
 | Banner says *CLI is offline* | Normal on an idle relay: send a message, and the banner clears once the conversation's worker connects |
-| A conversation seems wedged | **☠️ Kill session** in the `⋯` menu, then retry or send a new message |
+| A conversation seems wedged | **☠️ Kill session** in the **︙** menu, then retry or send a new message |
 | `npm install -g @oar-sh/oar` fails with `EACCES` | Do not use `sudo`; run the installer, which installs into your home directory |
 
 `oar doctor` prints the version, paths, port and provider CLIs in use. More symptoms are in [Troubleshooting](docs/troubleshooting.md).
@@ -225,7 +225,7 @@ How keys, cookies, served files, paired relays and Claude Cloud's use of the Cla
 | ----- | ------------- |
 | [Installing and running OAR](docs/install.md) | Prerequisites, every install method, starting the relay, the `oar` command, files, updating |
 | [Providers](docs/providers.md) | Each runtime in detail, installing provider CLIs from the relay, models |
-| [Using the web UI](docs/web-ui.md) | Conversations, running turns, question cards, background tasks, files, usage, sharing, the menu |
+| [Using the web UI](docs/web-ui.md) | Conversations, the composer, running turns, question cards, background tasks, files, usage, sharing, zoom and navigation, the menu |
 | [Settings and configuration](docs/configuration.md) | Settings, `config.json`, environment variables, stuck-turn detection |
 | [Remote access](docs/remote-access.md) | SSH and Cloudflare tunnels, a reverse proxy on another host, the session-worker path guard |
 | [Agents working together](docs/agents-together.md) | Paired relays, agent sessions, watching sessions |

package/bin/oar.js

@@ -1005,7 +1005,7 @@ async function restartRelay(ctx, paths, { old, viaService, answered = true, now
     if (!restartService(ctx)) return { ok: false, reason: 'service' };
   } else if (!(await requestShutdown(ctx, old, true, { immediate: now }))) {
     if (!viaService) {
-      logger.error('[oar] The relay did not accept the restart request. Restart it from the web UI (⋯ → Restart web relay).');
+      logger.error('[oar] The relay did not accept the restart request. Restart it from the web UI (︙ → Restart web relay).');
       return { ok: false, reason: 'restart-refused' };
     }
     if (!restartService(ctx)) return { ok: false, reason: 'service' };
@@ -1428,7 +1428,7 @@ function reportPortTaken(ctx, paths, port) {
   // cannot be asked to restart: only its lock tells that it is there.
   const pid = readRelayLock(paths.lockPath)?.pid;
   if (Number.isInteger(pid) && ctx.isProcessAliveImpl(pid)) {
-    ctx.logger.error(`[oar] A relay of this install seems to run (process ${pid}). If its token is an earlier one, restart it from its web UI (⋯ → Restart web relay), or end that process and run: oar start`);
+    ctx.logger.error(`[oar] A relay of this install seems to run (process ${pid}). If its token is an earlier one, restart it from its web UI (︙ → Restart web relay), or end that process and run: oar start`);
   }
   return { code: 1, reason: 'port-taken' };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oar-sh/oar",
-  "version": "0.9.20",
+  "version": "0.9.22",
   "type": "module",
   "description": "OAR — Open Agent Relay: drive your local coding agents from any browser",
   "license": "MIT",