samagotchi 0.116.0 → 0.118.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e86ef8d1890939908a44f84be426b6132992e9483af840e9438ad2d59829da9
-  data.tar.gz: adce5380c4f88f152c7aab62c26176d38b6ee6f1e268abe24b7d4b8850c1bb4e
+  metadata.gz: 06322a414267628aff61367b71dc4a6ecb76d4789673d594aff987a8da678d94
+  data.tar.gz: 12cc40d770cfd7072ccb1a64543033da5619f19d472ae69e7db880ae9a7f867f
 SHA512:
-  metadata.gz: c794e9f67ee56a67ec85fa0ec801919d3d0917b62b477491b12ca6475d0678402833b1191d973f791edfb7345c0cbee16509ecb8dcf3be1a5345ead097dfeb0a
-  data.tar.gz: 7d3da8e7edf45917785b14bf521eaee4559a829c631570a0336a4fcce00953b62a46a7e8f28ae4ffcb8130bae6b42b944e0783b8dbde35f918489a4504937ee8
+  metadata.gz: 0db2e221e335c74dcb3770ec17d92a2ded1b4e92589e958e33f95008e0ab5a9e13d72aed2ebb3bc2875fa6800e5cba6e19898b68515fda951a1709b5fc864a09
+  data.tar.gz: 7d8e40e0f7966a75d0914229a6e7a94b626ed9a045451ab65c154eef2eea3a5e8ba81eb20fc90cff703986e063fbfbef55225919a4be47e92b3b6b28ae611bbf

data/CHANGELOG.md

@@ -5,9 +5,49 @@ format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 versions follow [Semantic Versioning](https://semver.org/); before 1.0, config
 and commands may change between minor versions. How releases are made:
 [docs/releasing.md](docs/releasing.md).
-
 ## [Unreleased]
 
+## [0.118.0] - 2026-10-26
+
+### Changed
+
+- chi's icon (the browser tab and the Home Screen app) is flat: a system-blue χ on a graphite tile, no gradient. On a
+  phone, remove the Home Screen app and add it again to see it: iOS keeps the old icon.
+- chi web's blues match the icon: links, the active card and the Send button use Apple's system blue in both themes,
+  and the page background keeps only its faint blue glow (the purple one is gone).
+
+### Fixed
+
+- chi web's session bar stops squeezing its meta row into a narrow column in a small window: the bar's own actions
+  (continue, archive, stop session, delete) take a line of their own when they cannot sit beside the row, the folder
+  takes at most a third of it and a chip at most 30% (cut with "…", the full text in the tooltip), so a session with a
+  long model name and a long folder reads two lines at 760 px instead of five. Phones (≤ 600 px) scroll the row as
+  before.
+
+Update with `chi update` (the system bundle 0.118.0), then restart `chi web`.
+
+## [0.117.0] - 2026-10-26
+
+### Added
+
+- `/exit` in an attached terminal **asks what to do with what still runs** when only things you can stop keep the
+  worker up (reminders, a watched background task, a delegate with a live worker): keep running in the background,
+  stop them and exit, or go back. Anything else that holds the worker (a running turn, queued prompts, another UI)
+  still refuses as before, and a delegate never holds the idle exit. See [cli.md](docs/cli.md#attached-terminal).
+- The web's `stop session` asks the same first: a sheet (a bottom sheet on a phone) counts what still runs and offers
+  **Stop all**, **Stop session only** (the stop as it was: background tasks and delegates keep running) or
+  **Cancel**; with nothing to stop it is one tap as before. See [Sessions](docs/sessions.md).
+
+### Fixed
+
+- An unquoted `on`/`off` in `config.yml` now means that word for a setting that takes it
+  (`guardrails.system_one.mode: on`, `session.task_wakes: off`) instead of silently falling back to the default
+  (YAML 1.1 reads them as booleans). See [Configuration](docs/configuration.md).
+- chi web's composer grip keeps the message box inside the window it is shown in: a height saved in a bigger window
+  is held to half of a smaller one (a rotated phone, a resized window) and comes back whole when the room is back.
+
+Update with `chi update` (the system bundle 0.117.0), then restart `chi web`.
+
 ## [0.116.0] - 2026-10-25
 
 ### Added
@@ -4405,7 +4445,9 @@ and long-lived sessions.
 - A macOS desktop helper (`chi desktop install`): a "Send to chi" Service and a
   hotkey panel that send selected text or the clipboard to your sessions.
 
-[Unreleased]: https://github.com/dm1try/samagotchi/compare/v0.116.0...HEAD
+[Unreleased]: https://github.com/dm1try/samagotchi/compare/v0.118.0...HEAD
+[0.118.0]: https://github.com/dm1try/samagotchi/compare/v0.117.0...v0.118.0
+[0.117.0]: https://github.com/dm1try/samagotchi/compare/v0.116.0...v0.117.0
 [0.116.0]: https://github.com/dm1try/samagotchi/compare/v0.115.0...v0.116.0
 [0.115.0]: https://github.com/dm1try/samagotchi/compare/v0.114.0...v0.115.0
 [0.114.0]: https://github.com/dm1try/samagotchi/compare/v0.113.0...v0.114.0

data/docs/cli.md

@@ -434,7 +434,34 @@ In an attached terminal:
   doesn't wait out the idle timeout. It stays up while something still needs
   it, and the detach line says what: a turn is running (Ctrl-C cancels it
   first), prompts are queued, a continue offer is pending, another UI is
-  attached, or reminders are set. A web tab you just closed can count as
+  attached, or reminders are set. When every hold is something you can stop —
+  reminders, a background task it watches for a [finish wake](internals/background-tasks.md#finish-wake),
+  a delegate with a live worker — it asks instead of refusing, even when that
+  is all there is:
+
+  ```
+  This session still has:
+    • 2 reminders: api_health (every 20m), git push (every 5m)
+    • 1 background task: rails s (2m)
+    • 1 delegate: c1c1c1c1 "Fix the composer" (running a turn)
+    1. Keep running in the background (detach)
+    2. Stop them and exit
+    3. Back to the session
+  ```
+
+  1 is today's detach. 2 cancels the reminders, stops the tasks the same way
+  `task_stop` does and stops the delegates the same way `chi sessions stop ID`
+  does, then exits as `/exit` does; the line names what it stopped (a child a
+  terminal owns, or a task that can't be stopped, is left running and logged).
+  Each entry says what it is: a reminder its schedule (`every 20m`, `every 1h`,
+  with `, due now` when its next turn has already come), a task how long it has
+  run, a child its title and what it is doing. 3 keeps the prompt open, and the
+  next `/exit` asks again; Ctrl-D, `/detach` and a line the ask doesn't
+  understand are not answers to it (Ctrl-D detaches, a stray line is re-asked).
+  A delegate counts only for this ask: it never holds the idle exit, so 1 leaves
+  it running and the worker idles out as usual. `/exit --delete` and `/archive`
+  don't ask — with nothing else holding the worker, a running child does not
+  stop them, as before. A web tab you just closed can count as
   attached for about 30 s. When the worker exits, `chi --resume ID` or
   `chi --attach ID` starts a new one with the conversation. Before it exits
   (here and on the idle exit) the worker writes the session's recap if

data/docs/configuration.md

@@ -97,6 +97,12 @@ Behavior:
 - Top level is a YAML mapping of sections (`default:`, `server:`, `recap:`, …)
   and the maps described below. Keys are lower `snake_case`, one level per
   dot: `server.read_timeout` is `server: {read_timeout: 600}`.
+- Each key takes its own type: a number, a boolean (`true`/`false`, and
+  `yes`/`on`/`1`, `no`/`off`/`0`), text, or one of the words the setting
+  allows (`auto`, `audit`, `on`, …). YAML 1.1 reads an unquoted `on`, `off`,
+  `yes` or `no` as a boolean, so for a setting whose values are `on` and
+  `off` an unquoted `off` is the same as `"off"` (`guardrails.system_one.mode: off`,
+  `session.task_wakes: off`).
 - A key chi doesn't read warns at start, with the closest known key:
   `config: unknown key 'default.modle' (did you mean 'default.model'?)`.
   Names you choose under the maps below (host names, model ids) don't warn.

data/docs/internals/background-tasks.md

@@ -56,7 +56,7 @@ A task the model leaves running (it ends its turn: "I'll check when it's finishe
 - **The wake turn**: the first finished task runs a continue turn from client `task:<id>` (`last_turn.origin: "task"`, labelled `task <id8> finished` in the TUI and the web; the web's bell rings at its end however short), whose first message is the note (`turn_start`, `turn_id`, written before the turn's checkpoint so a restore keeps it). It counts toward `session.max_wakes` with the other wakes (`WorkerWakes#task_open?`: no continue offer, not paused, past the 2 s start grace). Several tasks finishing together: one wake turn, the others plain notes before it.
 - **A plain note instead** (the same text without the last two lines, no turn start), written at once, with `queue`, the budget spent (the UIs hear `N finished background tasks noted; the model reads them with your next message` once per human input, the flag shared with the other wakes), wakes paused, a continue offer waiting, input queued, an exit asked for, or a **note-only** task: one started or waited on in a turn the user stopped (reasons `user`, `manual`, `ctrl_c`), since a wake telling the model to carry on would undo that Stop. A prompt's turn takes the finished ones as plain notes first.
 - **Failure**: a wake turn that fails and kept nothing, or is stopped and restored, turns its note back into the plain one (`WorkerInbound#unmark_wake`, as for a context wake) and pauses wakes until the user writes.
-- **Idle exit**: with `wake`, a watched task holds the worker's idle exit (`WorkerIdleExit`'s `:background_tasks`) until its wake is taken: while it runs, and once it finished until the next idle pass takes it (`TaskWatch#holding`, in memory, no `ps`), so one that ends between the pass's look and the exit's check still wakes the session. A still-running one holds `/exit` too (`TaskWatch#running`, read once per request by `WorkerIdleExit#request_hold`; the 409 lists the tasks, `{id, command}`, with a `hint` on stopping them, and the attached terminal names them and says to use the web's stop-task button or ask for `task_stop`), as reminders do. A note-only task holds neither (no wake would come for it), nor does one whose note, or the look for it (the conversation's task ids unreadable), failed 3 times (`TaskWatch::MAX_FAILURES`: it is still tried at each look, but can't keep the worker up for good). With `queue` nothing holds: nothing would wake for the end, so keeping the worker up isn't worth it. As the worker leaves (any exit but a stop, a signal or an `/exit --delete`), the tasks that finished since the last look are written as plain notes; a task that ends after the worker left gets no note (the model sees its end at its next look, as before). A forgotten dev server keeps the worker up until it is stopped; a crash of that server wakes the session.
+- **Idle exit**: with `wake`, a watched task holds the worker's idle exit (`WorkerIdleExit`'s `:background_tasks`) until its wake is taken: while it runs, and once it finished until the next idle pass takes it (`TaskWatch#holding`, in memory, no `ps`), so one that ends between the pass's look and the exit's check still wakes the session. A still-running one holds `/exit` too (`TaskWatch#running`, read once per request by `WorkerIdleExit#request_hold`; the 409 lists the tasks, `{id, command, age_seconds}`, with a `hint` on stopping them, and the attached terminal names them and says to use the web's stop-task button or ask for `task_stop`), as reminders do. When the only holds are ones the user can stop, the 409 carries `holds` too and the terminal asks whether to stop them all (`HoldStop`, which stops these tasks the same way `task_stop` does). A note-only task holds neither (no wake would come for it), nor does one whose note, or the look for it (the conversation's task ids unreadable), failed 3 times (`TaskWatch::MAX_FAILURES`: it is still tried at each look, but can't keep the worker up for good). With `queue` nothing holds: nothing would wake for the end, so keeping the worker up isn't worth it. As the worker leaves (any exit but a stop, a signal or an `/exit --delete`), the tasks that finished since the last look are written as plain notes; a task that ends after the worker left gets no note (the model sees its end at its next look, as before). A forgotten dev server keeps the worker up until it is stopped; a crash of that server wakes the session.
 - **The tool descriptions**: a worker's `execute` and `task_create` say "if you end your turn before it finishes, chi tells you when it does" (left out under `off` and in the REPL), fixed when the worker builds its Engine.
 
 Work that needs a model, not a shell command, goes to a child chi session instead: `delegate` / `delegate_result` have the same shape (start, then wait) and return only the child's final reply; see [Sessions: Delegating](../sessions.md#delegating).

data/docs/sessions.md

@@ -19,7 +19,7 @@ Sessions are plain files — no DB. Each session is `~/.local/state/samagotchi/s
 
 A session is deleted if **expired by age OR overflow by count** (unless `keep_status` or the live-owner guard: a session a worker or `chi` still has open is never pruned). A session's `status` is its turn state (`idle`/`running`), not whether a worker is alive. Orphan dirs without a `*.json` are never deleted, except skeleton-only ones (see *Empty sessions*). Deletion removes both `*.json` and sidecar dir atomically. Set both `DAYS=0` and `MAX=0` to retain forever.
 
-**Worker idle exit:** a background worker (plain `chi`, Web UI sessions) exits after `SAMAGOTCHI_SESSION_IDLE_EXIT_MINUTES` (`session.idle_exit_minutes`, default `30`, `0`=never) with no turn running or queued, no client on its stream (an open web tab or attached terminal keeps it), no reminder registered, no background task it watches for a [finish wake](internals/background-tasks.md#finish-wake) still running or waiting for its wake turn (with `session.task_wakes: wake`; not one whose turn you stopped) and no continue offer (the step-limit question) waiting for an answer. It removes `bridge.json` and frees `owner.lock`; the next prompt or `--attach` wakes a new worker (`WorkerIdleExit`, `SessionManager.run_session_loop`). As its Bridge stops, the worker marks the lock leaving (`OwnerLock#mark_leaving`: `leaving_at`, and `leave_wait`, its `recap.timeout`), since it keeps the lock while it writes the recap on leave: an `--attach` or `--resume` meanwhile (here, or a remote one through chi web's wake) prints `(waiting for the session to finish its recap…)` (`LaunchMode::RECAP_WAIT`) and waits for the release, up to that budget plus `OwnerLock::LEAVE_MARGIN` (5 s), before starting the new worker (`OwnerLock.await_release`). A lock held by a worker that isn't leaving (a live one, a stuck one) is left as before. A client can also ask the worker to exit right away (Bridge `POST /session/:id/exit`; `/exit` in an attached terminal does, `/detach` doesn't): the same rules apply without the timeout (even with `0`), and the asker's own stream doesn't count. The reply names what keeps it up (for background tasks, which ones and how to stop them). The session's status stays as it was, not `stopped`. With `"restart": true` (a worker whose sidecar lists the `restart` feature) the worker hands the session to a new worker on the newest chi installed: it leaves, then starts its successor once its lock is free, keeping even an empty session and writing no recap. Clients' streams don't hold a restart (a web tab and an attached terminal reconnect to the new worker); what would be lost does: a turn running or queued, a continue offer, a question or approval waiting, reminders, a `/btw` (or another anytime command) still running, a delegate's approval relay open or settled in the last 10 minutes, and background tasks this conversation started that still run (`WorkerIdleExit#hold_for_restart`; 409 `held` with `reason`). What lives only in the worker's memory goes: the event history a late client replays, the kept `/btw` answers, a plugin's in-memory state.
+**Worker idle exit:** a background worker (plain `chi`, Web UI sessions) exits after `SAMAGOTCHI_SESSION_IDLE_EXIT_MINUTES` (`session.idle_exit_minutes`, default `30`, `0`=never) with no turn running or queued, no client on its stream (an open web tab or attached terminal keeps it), no reminder registered, no background task it watches for a [finish wake](internals/background-tasks.md#finish-wake) still running or waiting for its wake turn (with `session.task_wakes: wake`; not one whose turn you stopped) and no continue offer (the step-limit question) waiting for an answer. It removes `bridge.json` and frees `owner.lock`; the next prompt or `--attach` wakes a new worker (`WorkerIdleExit`, `SessionManager.run_session_loop`). As its Bridge stops, the worker marks the lock leaving (`OwnerLock#mark_leaving`: `leaving_at`, and `leave_wait`, its `recap.timeout`), since it keeps the lock while it writes the recap on leave: an `--attach` or `--resume` meanwhile (here, or a remote one through chi web's wake) prints `(waiting for the session to finish its recap…)` (`LaunchMode::RECAP_WAIT`) and waits for the release, up to that budget plus `OwnerLock::LEAVE_MARGIN` (5 s), before starting the new worker (`OwnerLock.await_release`). A lock held by a worker that isn't leaving (a live one, a stuck one) is left as before. A client can also ask the worker to exit right away (Bridge `POST /session/:id/exit`; `/exit` in an attached terminal does, `/detach` doesn't): the same rules apply without the timeout (even with `0`), and the asker's own stream doesn't count. The reply names what keeps it up (for background tasks, which ones and how to stop them). When every hold is one the user can stop — reminders, a watched task still running, a delegate with a live worker — the 409 also carries `holds: [{kind:, items: [{id:, label:, detail:}]}]` (a reminder's detail is its schedule, `every 20m`/`every 1h`, `, due now` when it is already due), and an attached terminal asks what to do with them; its "stop them and exit" posts `{"stop": "all"}`, which clears the reminders, stops those tasks (`TaskRuntime.stop_task`, as `task_stop`) and stops those children (`SessionManager.stop_session`) before leaving, re-checking first that nothing the user can't stop appeared meanwhile (`HoldStop`). A delegate counts only for that ask: it never holds the idle exit, and an exit that deletes or archives the session does not ask about it. The session's status stays as it was, not `stopped`. With `"restart": true` (a worker whose sidecar lists the `restart` feature) the worker hands the session to a new worker on the newest chi installed: it leaves, then starts its successor once its lock is free, keeping even an empty session and writing no recap. Clients' streams don't hold a restart (a web tab and an attached terminal reconnect to the new worker); what would be lost does: a turn running or queued, a continue offer, a question or approval waiting, reminders, a `/btw` (or another anytime command) still running, a delegate's approval relay open or settled in the last 10 minutes, and background tasks this conversation started that still run (`WorkerIdleExit#hold_for_restart`; 409 `held` with `reason`). What lives only in the worker's memory goes: the event history a late client replays, the kept `/btw` answers, a plugin's in-memory state.
 
 **Empty sessions:** a session nothing happened in is deleted when it is left, so `chi` → `/exit` leaves no trace. Empty means: no messages, no turn tried (a failed turn leaves a `last_prompt` and keeps it), no memory used, no pending question, nothing in `input/`, `notes/` or `images/`, nothing in its dir beyond the worker's skeleton, mode `assist`, and the default model. A session on another model (`/model`, `--model`) counts as prepared and stays (`SessionManager.discardable?`). The worker checks as it idle-exits or leaves on a client's request and deletes it once its lock is free, checking again first. The attached `/exit` then says `Detached; the session is empty: it will be discarded if nothing arrives before its worker stops.` (a note or prompt landing first keeps it). The REPL (`--no-shared`) does the same at `/exit` or Ctrl-D. The retention sweep catches those killed first: empty sessions over an hour old with no live owner, whatever `DAYS`/`MAX`, and skeleton-only dirs with no `*.json`. `session.keep_empty: true` (env `SAMAGOTCHI_SESSION_KEEP_EMPTY`) turns all of it off.
 
@@ -33,7 +33,7 @@ A session is deleted if **expired by age OR overflow by count** (unless `keep_st
 
 **A worker killed mid-turn:** while a turn runs, its worker keeps it on disk (`TurnCheckpoint`): the session file has the turn so far (the prompt from the turn's start, then the finished tool steps and lines merged into it) and `interrupted_turn: {id, started_at, at, iteration, enqueued_id}` (`enqueued_id`: the input the turn runs, so any process can tell which turn is running; a continue turn carries its offer turn's), written as the turn starts, at the loop's first iteration boundary and then at most every 10 s (`updated_at` moves with it). The turn's end saves the real messages without the mark. A worker that died without ending its turn (SIGKILL, a crash of the process) leaves the mark, and loses what came after its last written boundary: at most the last 10 s of steps, plus the step in flight. Each checkpoint write also saves the turn's metrics so far to `analytics.json` (tokens, speeds, timings, its finished tool calls), as the record a killed turn leaves: canceled, `cancellation_reason: worker_stopped`; the turn's own end writes over it. The next worker to start for the session (a `chi send`, `--resume`, `--attach`, the web), or a `--no-shared` REPL resuming it, settles the turn before anything else (`TurnCheckpoint.settle`, log `interrupted_turn_settled`): a note `the previous turn was cancelled (worker-stopped) after Ns` goes at the tail, the status goes idle and the mark goes; `last_turn` stays the previous turn's (a new one saved before the turn a `chi send --wait` woke the worker for would end that wait at once); the dead turn's end is recorded under its `enqueued_id` instead, in `<id>/input/settled/<enqueued_id>` (a `last_turn` record: canceled, `cancel_reason: worker_stopped`), which only a wait for that very turn reads (`chi send --queue --wait`, a `chi send --wait -m` to an idle session or `--new`, `chi send --wait ID --turn`, a continue's wait): it ends `canceled` with `cancel_reason: worker_stopped`, detail "its worker exited mid-turn", instead of timing out. A wait with no turn id that saw the turn running ends the same way when the settle comes (`chi send --wait ID` with no message on a turn with no id, such as a session's first prompt or a reminder turn; a message merged into the turn as a steer), unless an input still waits or was claimed since: an unmerged message runs as its own turn next, and that turn's end is the answer. A reply the turn wrote before its worker died is still its answer. The session shows the turn's prompt and steps with that note; the dead turn is not run again, and the model reads on its next turn that it was cut.
 
-**Stopping a worker:** `chi sessions stop ID` marks the session stopped (an empty `<id>/stopped` file, not a session.json field, which a worker saving at that moment would write over; a resume removes it), sends its worker TERM and waits (up to 10 s) until the worker has let go of `owner.lock`. A running turn is canceled over the Bridge first, with reason `session_stopped` (the turn's line ends "(session stopped)", its note says `cancelled (session-stopped)`, and a command it was running says "stopped as the session was stopped"; a bare signal to the worker makes it "stopped by a signal to chi"; an older worker takes the reason as `manual`); the TERM stops whatever still runs as a Stop with reason `signal` and saves it (a spawned worker traps TERM, HUP and INT: `WorkerSignals`; a turn not ended within 3 s, 0.5 s after a stop or a second signal, is cut and the session saved as it was), and a stopped worker still saves its kept turn, since the marker, not the saved status, says stopped. Any TERM, HUP or INT does the same to a worker outside a stop: it leaves (log `worker stop reason=signal`) and the next send wakes a new one, so a `chi --resume ID` right after spawns a fresh worker. That is also how to restart a worker still running an older chi, which the attached terminal reports when a command or a question dismiss gets a 404, and the web when an answer, a dismiss, a command or a cancel does (`501 not_supported`; `BridgeClient.stale_worker_message`). A command this chi has that the older worker doesn't (`/llm-context`, the web's `llm ctx` chip, against a 0.39.0 worker) says the same, not `not a session command` (`SessionCommands.builtin_name`); a typo keeps its `400 unknown_command`. The web's `POST /api/sessions/:id/stop` waits the same way, for 2 s (the page's Stop shows the stop at once), or for the body's `wait` up to the same 10 s (`SessionManager::STOP_WAIT`): `chi --remote NAME sessions stop` sends it, so it waits as long as here. A command sent during a turn that waits for its end (`/model X`, `!cmd`; see *Typing during a turn* in [cli.md](cli.md)) and hasn't run when the worker leaves (a stop, a crash) is answered `command_ran {status: "dropped"}`, so no UI keeps showing it waiting.
+**Stopping a worker:** `chi sessions stop ID` marks the session stopped (an empty `<id>/stopped` file, not a session.json field, which a worker saving at that moment would write over; a resume removes it), sends its worker TERM and waits (up to 10 s) until the worker has let go of `owner.lock`. A running turn is canceled over the Bridge first, with reason `session_stopped` (the turn's line ends "(session stopped)", its note says `cancelled (session-stopped)`, and a command it was running says "stopped as the session was stopped"; a bare signal to the worker makes it "stopped by a signal to chi"; an older worker takes the reason as `manual`); the TERM stops whatever still runs as a Stop with reason `signal` and saves it (a spawned worker traps TERM, HUP and INT: `WorkerSignals`; a turn not ended within 3 s, 0.5 s after a stop or a second signal, is cut and the session saved as it was), and a stopped worker still saves its kept turn, since the marker, not the saved status, says stopped. Any TERM, HUP or INT does the same to a worker outside a stop: it leaves (log `worker stop reason=signal`) and the next send wakes a new one, so a `chi --resume ID` right after spawns a fresh worker. That is also how to restart a worker still running an older chi, which the attached terminal reports when a command or a question dismiss gets a 404, and the web when an answer, a dismiss, a command or a cancel does (`501 not_supported`; `BridgeClient.stale_worker_message`). A command this chi has that the older worker doesn't (`/llm-context`, the web's `llm ctx` chip, against a 0.39.0 worker) says the same, not `not a session command` (`SessionCommands.builtin_name`); a typo keeps its `400 unknown_command`. The web's `POST /api/sessions/:id/stop` waits the same way, for 2 s (the page's Stop shows the stop at once), or for the body's `wait` up to the same 10 s (`SessionManager::STOP_WAIT`): `chi --remote NAME sessions stop` sends it, so it waits as long as here. Before that stop, the page's `stop session` button asks what the worker still has that the user can stop: `GET /api/sessions/:id/holds` (owner-only) answers the worker's `holds` — the same list the exit ask's 409 carries — always an array, empty when there is no live worker, one from before the route, or one that did not answer. With something, a sheet (a bottom sheet on a phone, a popover at the button otherwise — `stop_sheet.js`) lists them, at most three of a kind named and `+N more`, and offers **Stop all** (`POST /api/sessions/:id/holds/stop` → `HoldStop#stop_all`, then the stop), **Stop session only** (the stop exactly as it was) or **Cancel**. Nothing to ask about is the plain confirm, one tap as before. Both buttons stay because a stop only TERMs the worker: its reminders die with it, while a background task and a delegate are their own processes and keep running. A command sent during a turn that waits for its end (`/model X`, `!cmd`; see *Typing during a turn* in [cli.md](cli.md)) and hasn't run when the worker leaves (a stop, a crash) is answered `command_ran {status: "dropped"}`, so no UI keeps showing it waiting.
 
 **Deleting a session:** `chi sessions delete ID...`, `/exit --delete` in a terminal and the Web UI's delete all go through `SessionManager.delete_session`: it resolves a unique prefix, removes `<id>.json` and the whole `<id>/` dir, and returns what it removed. A session a plain REPL has open (`owner.lock` kind `tui`) is always refused. One a worker runs is refused unless the caller asks to stop it: then it stops the worker as `chi sessions stop` does and deletes once `owner.lock` is free (`--force` on the CLI, 10 s; the web page always, 2 s; `/exit --delete` after the worker agreed to exit, 10 s). A worker that outlives the wait leaves the session in place. The web's route is `DELETE /api/sessions/:id?force=true` (the page sends `force`; without it a live worker's session is 409 `worker_running`, as the CLI without `--force`; 200 `{status: "deleted", session_id, stopped}`; 409 `owned_by_tui` or `still_stopping`; 404).
 
@@ -94,7 +94,7 @@ chi sessions clean --dry-run --days 7            # test sessions older than 7 da
 - Web notifications: when a session needs you while the tab is hidden or behind another window (a question or a guardrail approval, a plugin card with buttons during a turn such as check-in's, a failed turn, a turn done after 10 s or more; a delegated session only for its questions, a canceled turn never), the page title counts it, `(N) Chi`, until you come back to the tab. The bell at the right of the top bar also turns on OS notifications ("needs an answer", "needs approval", "needs you", "turn failed", "done in 42 s", under the session's first message; a click opens the session): its first click asks the browser for the permission, and the choice is kept per browser. Any session of the page's scope counts, not only the open one. What was already so when the page loaded never counts, and several chi tabs show one notification per event. A chi tab in front tells the others (a `BroadcastChannel`), so while you look at one, the ones behind neither notify nor count what it shows; coming back to a tab clears those events in the other tabs' titles too. The hub's `session` frames carry what this needs: `pending_question` (`{id, kind}`, kind `question` or `approval`), `pending_card` (`{id, bundle}`: the running turn's card with actions, from `pending_card.json` that the worker keeps in the session's folder while one is open; a card without actions, such as loop-guard's, never counts) and `last_turn` (`{outcome, ended_at, seconds, origin}`, saved in the session's JSON as the engine ends each turn).
 - The web frontend is a zero-build ES-module stack in `lib/samagotchi/web/public/`: `data.js` (retrieval, typed SSE `openStream` for a session and `openEvents` for the session list), `sessions_list.js` (the list as a pure reducer over `GET /api/events`: a snapshot replaces it, an upsert keeps a known card in place, a removal drops it; `families()` groups delegates under their parent), `families_view.js` (a parent's family chip, its rows and the strip's popover; the chip and rows as lit-html templates), `keep_focus.js` (lit reuses a list's nodes by position: a redraw keeps the focus on the same item by its `data-id` / `data-name`), `chains.js` (session chains: the links from `continues`, the cards folded into the latest link's, its `#N` chip and rows as lit-html templates, the info bar's ← → links, a refused continue, and the fresh-link rule), `notify.js` (which of those events needs the user, for the notifications), `app.js` (presentation/state; a session with no live stream gets one when its `session` event says `bridge_up`, after one re-read: `event_seq` starts over in each worker, so a dropped stream is never resumed with its old cursor), `bubbles.js` (the history's bubbles between the turns' rows: output chunks, end lines, every client's prompt bubbles by `enqueued_id` with their queued/steered badges, the idle recap, guardrail warnings, hooks' notices, plugins' steers, command and note bubbles; lit-html templates, put in the history with the sticky follow by `createBubbles`), `cards_place.js` (where plugin cards and a snapshot's notices go in the history: a card added or updated in place by its id, a running turn's into its step, a snapshot's each above the first turn after it, a finished turn's notice in its step's rows and its question resolved where it was asked; a card's action buttons), `format.js` (pure formatters such as `previewOf`), `plain_line.js` (markdown out of the plain one-line places: the stage headline, a closed step's title, an answered question card's kept-reply line), `prompt_history.js` (the composer's ↑/↓ over the shared prompt history), `commands.js` (session commands: which composer lines are commands, the page's own replies, a `command_ran`'s bubble, the page's command bubbles kept across a re-read), `composer.js` (where a composer line goes, `routeComposerLine`: /cut and /queue, the start page's own replies, a session command or `!cmd`, a typo hint, else a turn; and a session command sent from the composer or a chip), `delivery_line.js` (the composer's row above the text field in a session, always there so the composer keeps its height: the key hint while idle, and the delivery line while a turn runs: where a message typed now goes in, from the step's phase, clock and size, whether "cut in now" can land, and the queue link for a worker with the `delivery` feature, as a pure `deliveryLine`, its lit-html template and `createDeliveryControl`, which ticks it and keeps a choice armed from a link; see docs/cli.md, "Typing during a turn"), `restore.js` (a failed turn's prompt handed back into this tab's composer, before or after its `/turn` ack), `lists_view.js` (the session lists: the strip and its pill, all sessions with its search, count and select mode, their cards, the family and chain popovers; the cards, tile and pill as lit-html templates, drawn as new nodes each time, and the lists' orders as pure functions), `stream_handlers.js` (the open session's stream event handlers, by event type, over the page's views and hooks; a snapshot replays through them too), `stage_view.js` (the stage view: the running turn pinned above the composer, then handed off into the history; its pure rules and texts in `stage_model.js`, its live slots (headline, now row, trail, ticks) in `stage_slots.js`, its cap and held height in `stage_frame.js`, the in-use watch that times the hand-off in `stage_watch.js`), `info_bar.js` (the session bar's info line as a lit-html template over a plain model: id, status, model, chain links, chips, ctx, speed, clock, worker badge), `info_bar_model.js` (that model and the bar's buttons' states, built from the page's session state, its list and its in-flight continues and restarts as pure functions; `app.js`'s `updateInfoBar` applies them every second while a turn runs), `session_state.js` (what the page knows about the open session: its empty state, and `sessionStateFrom`, the fields a `GET /sessions/:id` payload sets), `refs.js` (refs: a kind and a target on the element, a plugin's ref data (label, http(s) URL actions) bound in a WeakMap by `bindRef`, the targets per kind, show in turn, one delegated set of click, key and hover listeners), `ref_menu.js` (a ref's `▾` and its menu), `ref_scan.js` (the `path:line` refs in an answer's or a step's text that name a file the session's rows touched), `answer_refs.js` (the refs a plugin attached to an answer, its `display_refs`: bound to the answer's bubble, paired with its links and text, bound with `bindRef`), `markdown_place.js` (where rendered markdown and its refs go: a text as markdown HTML, its `path:line` refs, a final answer's rendering), `images.js` (image chips in the composer: paste, drop and the image button, the upload before a turn, the thumbnails and the lightbox), `composer_grip.js` (the composer's grip and fold: the drag, tap and keys, the fold per visit), `strip_grip.js` (the latest-sessions strip's grip, the composer grip's twin: hides and shows the strip), `storage.js` (the page's per-browser choices in localStorage, guarded: a choice that can't be read or written is not remembered), `unqueue.js` (the × on a message queued for after the turn: takes it back, its text into an empty composer or a toast), `toasts.js` (the page's toast stack: a timer each, sticky ones until acted on, the same text reusing its item), `toast_place.js` (where the toast sits: above the composer card, the stage and an open model panel), `dock_reserve.js` (what floats over the history: the history's bottom reserve (`--dock-h`) at the composer card's and the showing stage's height, a reader at the end kept there, and the toast's place measured for `toast_place.js`), `notice_links.js` (a hook notice line's http(s) URLs as links), `start_page.js` (the start page's model picker and its LLM context and thinking chips, a choice for the next new session only; a fresh chain link's picker and its `/model`), `session_actions.js` (Continue, Archive and its Undo, Delete and Stop, and the start page when the open session is gone), `send_turn.js` (the composer's send: a new session first on the start page, the route, the echo, the image upload, the `/turn` ack, a fast failure's restore and each error's place). Unit-tested via `npm test` (`spec/web/public/*.test.js`).
 - Selecting a session in the web UI is read-only: `GET /api/sessions/:id` never spawns a worker (it reads a live worker's snapshot when one runs, else the session file). A prompt (`POST /turn`) or a command (`POST /command`) wakes the worker, and `/stream` briefly waits for a freshly-spawned bridge before answering. A caught-up SSE reconnect holds the stream open; `reset` markers are only sent for reconnects behind the ring window, or with a cursor from another worker (event ids are `<event_seq>-<epoch>`, one epoch per worker).
-- The web session page's message box folds away for room to read. Drag the grip on its top edge (the pill that shows on hover; always on a phone) down, past the box by 32 px: the pill turns accent while releasing would hide it, and on release the box folds and the info bar stays as the page's bottom edge. The grip stays as a handle on the info bar's top edge, drawn always: pull it up (8 px opens it, and the box follows the pointer in the same gesture), click or tap it (opens it and focuses the box), or just type on the page (the key lands in the box) to bring it back; Enter or Space on the focused grip folds or opens too. A draft (text or images, which folding never clears) colours the handle with the accent, a session waiting on you with the attention colour; its tooltip says so. Stop turn moves into the info bar while it is folded. The fold is remembered per browser (`chi_composer_collapsed`), an archived session opens folded for the visit, and opening it there, like the page opening it itself (a restored line, a quote, continue →'s opener), is for that visit only. The fold keeps the height the grip set (`chi_composer_floor`): the box opens again at the height it had, and only a double-click on the grip forgets it. A click on the expanded grip hides the box as well: it folds 250 ms after the press, so a second click inside that window is read as a double-click and resets the height instead (a drag, Enter or Space act at once, and a drag after a click takes the wait back). The start page's grip only resizes.
+- The web session page's message box folds away for room to read. Drag the grip on its top edge (the pill that shows on hover; always on a phone) down, past the box by 32 px: the pill turns accent while releasing would hide it, and on release the box folds and the info bar stays as the page's bottom edge. The grip stays as a handle on the info bar's top edge, drawn always: pull it up (8 px opens it, and the box follows the pointer in the same gesture), click or tap it (opens it and focuses the box), or just type on the page (the key lands in the box) to bring it back; Enter or Space on the focused grip folds or opens too. A draft (text or images, which folding never clears) colours the handle with the accent, a session waiting on you with the attention colour; its tooltip says so. Stop turn moves into the info bar while it is folded. The fold is remembered per browser (`chi_composer_collapsed`), an archived session opens folded for the visit, and opening it there, like the page opening it itself (a restored line, a quote, continue →'s opener), is for that visit only. The fold keeps the height the grip set (`chi_composer_floor`): the box opens again at the height it had, and only a double-click on the grip forgets it. That height never takes more than half of the window the box is drawn in: a floor saved in a bigger window is held to that half in a smaller one (a rotated phone, a resized window, another device on the same origin), and the saved floor itself stays, so the height comes back when the room does. A click on the expanded grip hides the box as well: it folds 250 ms after the press, so a second click inside that window is read as a double-click and resets the height instead (a drag, Enter or Space act at once, and a drag after a click takes the wait back). The start page's grip only resizes.
 
 **Test-session hygiene:**
 

data/lib/samagotchi/bridge.rb

@@ -87,21 +87,36 @@ module Samagotchi
     #   one, POST /command answers 501
     # @param on_exit_request [#call, nil] a client asks the worker to exit
     #   now: takes the client_id and delete: (the exit is to delete the
-    #   session, /exit --delete), returns nil when the worker will leave or
-    #   what keeps it up (a WorkerIdleExit::Hold: #reason, #tasks, #hint);
-    #   called with the event log held. Without one, POST /exit answers 501
+    #   session, /exit --delete) or stop: ("all": stop everything the user
+    #   can stop first), returns nil when the worker will leave or
+    #   what keeps it up (a WorkerIdleExit::Hold: #reason, #tasks, #hint,
+    #   #holds); called with the event log held. Without one, POST /exit
+    #   answers 501
     # @param exit_discards [#call, nil] after an exit the worker agreed to:
     #   whether it will delete the session as empty (the 200 says
     #   +discard+); without one the reply leaves the field out
+    # @param exit_stopped [#call, nil] after a stop-all exit: what it stopped
+    #   (a HoldStop::Stopped) for the 200's +stopped+; nil leaves it out
+    # @param on_holds [#call, nil] what the user could stop in this worker
+    #   right now (WorkerIdleExit#stoppable_holds) for GET /holds; without
+    #   one that route answers 501
+    # @param on_holds_stop [#call, nil] stop every one of them (HoldStop#stop_all)
+    #   without the worker exiting, for POST /holds/stop; returns the
+    #   HoldStop::Stopped the 200's +stopped+ carries; without one that route
+    #   answers 501
     def initialize(engine:, state_dir:, session_id:, bind: DEFAULT_BIND,
                    port: 0, ring_capacity: DEFAULT_RING_CAPACITY,
                    heartbeat_interval: DEFAULT_HEARTBEAT_INTERVAL, input_format: nil, on_input: nil,
-                   on_command: nil, on_exit_request: nil, exit_discards: nil)
+                   on_command: nil, on_exit_request: nil, exit_discards: nil, exit_stopped: nil,
+                   on_holds: nil, on_holds_stop: nil)
       @engine = engine
       @on_input = on_input
       @on_command = on_command
       @on_exit_request = on_exit_request
       @exit_discards = exit_discards
+      @exit_stopped = exit_stopped
+      @on_holds = on_holds
+      @on_holds_stop = on_holds_stop
       @input_format = input_format
       @state_dir = state_dir
       @session_id = session_id
@@ -590,6 +605,8 @@ module Samagotchi
       %w[POST turn/dequeue] => :handle_dequeue_turn,
       %w[POST command] => :handle_command,
       %w[POST exit] => :handle_exit_request,
+      %w[GET holds] => :handle_holds,
+      %w[POST holds/stop] => :handle_holds_stop,
       %w[POST recap] => :handle_recap,
       %w[POST relay] => :handle_relay,
       %w[POST relay/status] => :handle_relay_status,
@@ -883,14 +900,21 @@ module Samagotchi
 
     # A client asks the worker to exit now (`/exit` in the attached TUI), or
     # with "restart": true to hand the session to a new worker on the newest
-    # chi installed (the "restart" feature). The worker decides with the
-    # event log held, so no POST /turn lands between its check and its
-    # answer; it leaves from its loop after this reply.
-    # 200 {status: "exiting", discard?: the session is empty and goes} ({status: "restarting"} for a restart), or 409
-    # {status: "held", reason:} naming what keeps it up (with tasks: [{id:,
-    # command:}] and a hint: how to stop them, for background_tasks). A past +deadline+
-    # (see #handle_post_turn), checked with the event log held: 408
-    # deadline_passed, the worker not asked (its client said it didn't stop).
+    # chi installed (the "restart" feature). "stop": "all" first stops every
+    # hold the user can stop; "ask": false leaves the delegate children out of
+    # the list (a UI that can't ask about them, as /archive). The worker
+    # decides with the event log held, so no POST /turn lands between its
+    # check and its answer; it leaves from its loop after this reply.
+    # 200 {status: "exiting", discard?: the session is empty and goes,
+    # stopped?: what a "stop": "all" exit stopped} ({status: "restarting"} for
+    # a restart), or 409 {status: "held", reason:} naming what keeps it up
+    # (with tasks: [{id:, command:, age_seconds:}] and a hint: how to stop
+    # them, for background_tasks). When every hold is one the user can stop,
+    # the 409 also carries holds: [{kind:, items: [{id:, label:, detail:}]}
+    # — reminders, running tasks, delegate children — for the terminal's ask.
+    # A past +deadline+ (see #handle_post_turn), checked with the event log
+    # held: 408 deadline_passed, the worker not asked (its client said it
+    # didn't stop).
     # Returns [headers, status, body].
     def handle_exit_request(session_id, body)
       return [{}, 501, { error: "exit_unavailable" }] unless @on_exit_request
@@ -901,7 +925,13 @@ module Samagotchi
       client_id = fetched(parsed, "client_id")
       delete = fetched(parsed, "delete") == true
       restart = fetched(parsed, "restart") == true
+      stop_all = fetched(parsed, "stop") == "all"
+      # A client that can ask about what still runs (an attached terminal's
+      # plain /exit) gets the delegates in the hold list; one that can't
+      # (/archive, and every worker's own last look) does not.
       options = restart ? { delete: delete, restart: true } : { delete: delete }
+      options[:stop] = true if stop_all && !restart
+      options[:ask] = false if fetched(parsed, "ask") == false
       deadline = fetched(parsed, "deadline")
       return BAD_DEADLINE unless deadline_valid?(deadline)
 
@@ -918,13 +948,57 @@ module Samagotchi
 
         body = { status: "exiting", session_id: @session_id }
         body[:discard] = @exit_discards.call == true if @exit_discards
+        stopped = @exit_stopped&.call
+        body[:stopped] = stopped.to_h if stopped
         return [{}, 200, body]
       end
 
       # A hold may name what it waits for (tasks: the background tasks a
-      # finish wake watches).
+      # finish wake watches). When every hold is one the user can stop, +holds+
+      # lists them for the terminal's ask: [{kind:, items: [{id:, label:,
+      # detail:}]} (docs/cli.md, /exit).
       [{}, 409, { status: "held", reason: hold.reason.to_s, tasks: hold.tasks, hint: hold.hint,
-                  session_id: @session_id }.compact]
+                  holds: holds_json(hold.holds), session_id: @session_id }.compact]
+    end
+
+    # The exit ask's stoppable holds as JSON; nil when there are none, so an
+    # older client sees today's plain 409.
+    def holds_json(holds)
+      return nil if holds.nil? || holds.empty?
+
+      holds.map { |hold| { kind: hold.kind.to_s, items: hold.items.map { |item| item.to_h } } }
+    end
+
+    # GET /session/:id/holds: what the user could stop in this worker right
+    # now — the same holds the exit ask's 409 carries (reminders, the watched
+    # background tasks still running, the delegate children with a live
+    # worker), whatever else keeps the worker up: chi web's Stop asks about
+    # these before it TERMs the worker, and a Stop cancels a running turn
+    # anyway, so a turn is not a reason to hide them.
+    # 200 {session_id, holds: [{kind:, items: [...]}]} (no +holds+ when there
+    # are none); 501 holds_unavailable when this worker has no such step.
+    # Returns [headers, status, body].
+    def handle_holds(_session_id, _body = nil)
+      return [{}, 501, { error: "holds_unavailable" }] unless @on_holds
+
+      [{}, 200, { session_id: @session_id, holds: holds_json(@on_holds.call) }.compact]
+    end
+
+    # POST /session/:id/holds/stop: stop everything the user can stop (HoldStop#stop_all)
+    # without the worker leaving — the reminders cleared, the watched tasks
+    # killed as task_stop does, the delegate children stopped as
+    # `chi sessions stop` does. What the user can't stop (a turn running,
+    # another UI attached) is untouched. The web's Stop's "Stop all" runs
+    # this, then stops the worker.
+    # 200 {status: "stopped", session_id, stopped: {reminders:, tasks:,
+    # delegates:}}; 501 holds_unavailable when this worker has no such step.
+    # Returns [headers, status, body].
+    def handle_holds_stop(_session_id, _body = nil)
+      return [{}, 501, { error: "holds_unavailable" }] unless @on_holds_stop
+
+      Log.info(:bridge, "holds_stop")
+      stopped = @on_holds_stop.call
+      [{}, 200, { status: "stopped", session_id: @session_id, stopped: stopped.to_h }]
     end
 
     # Queue a turn for this session through its file IPC (the worker polls

data/lib/samagotchi/bridge_client.rb

@@ -206,10 +206,12 @@ module Samagotchi
     # error "not_found" = a worker older than the route, 408 = too late.
     # @param client_id [String] the asking UI, whose own streams don't hold
     # @return [Response]
-    def request_exit(client_id:, delete: false, restart: false)
+    def request_exit(client_id:, delete: false, restart: false, stop: false, ask: true)
       body = { client_id: client_id }
       body[:delete] = true if delete
       body[:restart] = true if restart
+      body[:stop] = "all" if stop
+      body[:ask] = false unless ask
       body[:deadline] = deadline
       post("exit", body, read_body: true)
     end
@@ -236,6 +238,16 @@ module Samagotchi
       post("tasks/stop", { task_id: task_id }, read_body: true)
     end
 
+    # POST /session/:id/holds/stop: stop everything this worker's user can
+    # stop (its reminders, the background tasks a finish wake watches that
+    # still run, its delegate children) without the worker exiting
+    # (Bridge#handle_holds_stop). 200 {status: "stopped", stopped:
+    # {reminders:, tasks:, delegates:}}; 501 for a worker without the route.
+    # @return [Response]
+    def stop_holds
+      post("holds/stop", {}, read_body: true)
+    end
+
     # How long the approval relay's calls wait for a reply: a parent's Stop
     # isn't held for READ_TIMEOUT by a child that doesn't answer.
     RELAY_TIMEOUT = 5

data/lib/samagotchi/bundles/system/manifest.yml

@@ -1,6 +1,6 @@
 ---
 name: samagotchi-system
-version: 0.116.0
+version: 0.118.0
 scope: system
 description: Default system memories — identity, self map, config modification protocol, memory guide and the delegated-session rules
 files:

data/lib/samagotchi/config.rb

@@ -370,6 +370,8 @@ module Samagotchi
     # What a :bool value reads as (Config.coerce!), YAML 1.1's words and 1/0.
     BOOL_WORDS = { "1" => true, "true" => true, "yes" => true, "on" => true,
                    "0" => false, "false" => false, "no" => false, "off" => false }.freeze
+    # The word an :enum takes for a boolean (an unquoted on/off is one in YAML 1.1).
+    BOOL_ENUM_WORDS = { true => "on", false => "off" }.freeze
 
     # Fast lookup maps
     BY_KEY = ENTRIES.each_with_object({}) { |e, h| h[e.key] = e }.freeze
@@ -397,8 +399,10 @@ module Samagotchi
       # +raw+ as +entry+'s type, strictly: a value of another shape raises.
       # :string as given (a YAML list joined with |), :integer, :float,
       # :bool (true/yes/on/1, false/no/off/0/""), :enum in its canonical
-      # case; nil for nil, and for a blank value of any other type than
-      # :string and :bool. #coerce is its lenient twin (config.yml, env).
+      # case (an unquoted on/off, which YAML 1.1 reads as a boolean, is the
+      # word when the entry has it); nil for nil, and for a blank value of any
+      # other type than :string and :bool. #coerce is its lenient twin
+      # (config.yml, env).
       # @raise [SessionConfig::Error] "KEY takes WHAT, not RAW"
       def coerce!(entry, raw)
         return nil if raw.nil?
@@ -414,7 +418,7 @@ module Samagotchi
                 when :integer then Integer(str, exception: false)
                 when :float then Float(str, exception: false)
                 when :bool then BOOL_WORDS[str.downcase]
-                when :enum then entry.enum_values.find { |v| v.downcase == str.downcase }
+                when :enum then enum_word(entry, raw, str)
                 else str
                 end
         raise SessionConfig::Error, "#{entry.key} takes #{takes(entry)}, not #{raw.to_s.inspect}" if value.nil?
@@ -422,6 +426,18 @@ module Samagotchi
         value
       end
 
+      # A value of +entry+'s enum, as written. YAML 1.1 reads an unquoted
+      # on/off/yes/no as a boolean, so `mode: on` reaches the enum branch as
+      # true: it is the entry's "on"/"off" when the entry has that word, and
+      # still invalid when it doesn't.
+      def enum_word(entry, raw, str)
+        found = entry.enum_values.find { |v| v.downcase == str.downcase }
+        return found if found
+
+        word = BOOL_ENUM_WORDS[raw]
+        word && entry.enum_values.include?(word) ? word : nil
+      end
+
       # What +entry+'s type takes, as a refusal names it.
       def takes(entry)
         case entry.type

data/lib/samagotchi/hold_stop.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require_relative "log"
+require_relative "session_manager"
+require_relative "tools/task_runtime"
+
+module Samagotchi
+  # Stops what a session's user can stop themselves when they ask its worker
+  # to exit: the reminders its Engine holds, the background tasks it watches
+  # for a finish wake that still run, and its delegate children with a live
+  # worker (docs/sessions.md, "Worker idle exit"). Called by the exit ask's
+  # "stop them and exit" (Worker#exit_request with stop: true), and the same
+  # step the web's Stop will use.
+  #
+  # What the user can't stop from here (a turn running, prompts queued, a
+  # continue offer, another UI attached) is never touched: WorkerIdleExit
+  # refuses the exit for those before this is called.
+  class HoldStop
+    # What was stopped, by kind: reminder names, task commands, children's
+    # short ids. The 200's +stopped+ is this as JSON.
+    Stopped = Data.define(:reminders, :tasks, :delegates) do
+      def initialize(reminders: [], tasks: [], delegates: []) = super
+
+      def any? = reminders.any? || tasks.any? || delegates.any?
+    end
+
+    # @param engine [Engine] #reminder_store
+    # @param task_watch [TaskWatch, nil] this session's finish-wake watch
+    #   (nil with session.task_wakes: off)
+    # @param delegates [#call] the children to stop (ChildrenStatus::Child)
+    # @param state_dir [String] where the child sessions live
+    def initialize(engine:, task_watch:, delegates:, state_dir:)
+      @engine = engine
+      @task_watch = task_watch
+      @delegates = delegates
+      @state_dir = state_dir
+    end
+
+    # Stop every hold the user can stop, read again as it is done (one may
+    # have ended in the meantime). A stop that fails is logged and left out
+    # of the report.
+    # @return [Stopped]
+    def stop_all
+      Stopped.new(reminders: stop_reminders, tasks: stop_tasks, delegates: stop_delegates)
+    end
+
+    private
+
+    # Reminders live only in this process, so clearing the store ends them;
+    # the names go to the report before it is emptied.
+    def stop_reminders
+      store = @engine.reminder_store
+      return [] unless store
+
+      names = store.reminders.values.map { |reminder| reminder[:name] }
+      store.clear_all
+      names
+    end
+
+    # The watched tasks still running, stopped the way task_stop and the
+    # web's stop-task button do (TaskRuntime.stop_task, by: "user").
+    def stop_tasks
+      return [] unless @task_watch
+
+      @task_watch.running.filter_map do |task|
+        record, error = Tools::TaskRuntime.stop_task(task.id, by: "user")
+        if record.nil?
+          Log.warn(:worker, "exit_stop_task_failed", task_id: task.id, error: error.to_s)
+          next nil
+        end
+
+        task.command
+      end
+    end
+
+    # The delegate children, stopped as `chi sessions stop` stops a session
+    # (SessionManager.stop_session: its turn canceled, its worker TERMed).
+    # One owned by another terminal is left running and said so in the log.
+    def stop_delegates
+      @delegates.call.filter_map do |child|
+        SessionManager.stop_session(child.id, state_dir: @state_dir)
+        child.short_id
+      rescue StandardError => e
+        Log.warn(:worker, "exit_stop_delegate_failed", child: child.short_id, error: e.class.name, msg: e.message)
+        nil
+      end
+    end
+  end
+end

data/lib/samagotchi/prompt_warmup.rb

@@ -29,6 +29,10 @@ module Samagotchi
   #   restores the state. When /slots can't say, the warm-up runs.
   class PromptWarmup
     MODES = %w[auto off].freeze
+    # The words cache.warmup takes, in the shape YAML hands them: an unquoted
+    # on/off arrives as true/false.
+    AUTO_WORDS = %w[auto on true 1].freeze
+    OFF_WORDS = %w[off false no 0].freeze
     # Seconds #take_pin waits for the busy-slot check (Client#slot_status
     # gives up within 3 s).
     DECIDE_TIMEOUT = 3
@@ -36,12 +40,13 @@ module Samagotchi
     STOP_JOIN_SECONDS = 1
 
     # Whether cache.warmup allows a warm-up (auto, the default; off, false,
-    # no or 0 turn it off; anything else warns once and is auto).
+    # no or 0 turn it off; on/true/1 (YAML's unquoted on) are auto; anything
+    # else warns once and is auto).
     def self.enabled?
       value = Config.get("cache.warmup").to_s.strip.downcase
-      return false if %w[off false no 0].include?(value)
+      return false if OFF_WORDS.include?(value)
 
-      unless value.empty? || value == "auto" || @warned
+      unless value.empty? || AUTO_WORDS.include?(value) || @warned
         @warned = true
         Log.warn(:config, "invalid_value", echo: "Warning: invalid value for cache.warmup: #{value.inspect} (allowed: auto, off) — using auto",
                                            key: "cache.warmup")

data/lib/samagotchi/session_access/web_bridge_client.rb

@@ -139,12 +139,17 @@ module Samagotchi
       end
 
       # POST …/exit: the worker asked to exit (chi web passes client_id on
-      # only when it is an attached TUI's).
-      # @return [BridgeClient::Response] 200 {status: exiting, discard}, 409
-      #   held {reason, tasks}, 408 late, 404 an older worker's
-      def request_exit(client_id:, delete: false)
+      # only when it is an attached TUI's), stop: true first stopping what
+      # the user can stop, ask: false leaving the delegate children out of
+      # the list (a UI that can't ask about them).
+      # @return [BridgeClient::Response] 200 {status: exiting, discard,
+      #   stopped}, 409 held {reason, tasks, holds}, 408 late, 404 an older
+      #   worker's
+      def request_exit(client_id:, delete: false, stop: false, ask: true)
         body = { client_id: client_id }
         body[:delete] = true if delete
+        body[:stop] = "all" if stop
+        body[:ask] = false unless ask
         post(:exit, "exit", body)
       end