Auto-threading, history pagination, streaming toggle + tool/reasoning display settings

- Auto-threading (Telegram topic-mode workflow): message.send {auto_thread}
  mints a fresh AI-named thread (instant derived title, LLM upgrade via
  channel.renamed); channel.created {auto:true}; the app jumps into the new
  thread and relocates the optimistic pending bubble.
- history frame: paged full message history for initial channel open /
  scroll-up pagination (reconstructed from the outbox log).
- Streaming on/off: gateway side (display.platforms.android.streaming) plus a
  per-device app toggle (Settings → Streaming); reasoning/model/tokens carried
  on message frames.
- Context menu: long-press (touch) / right-click (desktop) thread affordances
  via a KMP rightClick expect/actual.
- Settings → Reasoning: auto-collapse long reasoning blocks (default on).
- Tool detail: the gateway now always supplies full tool data — it forces
  verbose tool progress (full args → tool.start.args) and captures each
  completed call via the post_tool_call hook (output/duration/ok → tool.end).
  The app reveals the full call + output on expand (Truncated) and
  auto-expands cards in Everything mode.

docs/04-wire-protocol.md

@@ -116,6 +116,10 @@ subscribe; the server pushes to every open WS).
 {"type":"channel.created","payload":{"chat_id":"android:chan_7","name":"Cron Reports",
    "kind":"channel","parent_chat_id":null}}
 ```
+`channel.created` may carry `"auto":true` for a thread the gateway minted
+itself for an incoming message (auto-threading): the name is an instant
+derived title, and a follow-up `channel.renamed` upgrades it to the model's
+title.
 
 ### `history`
 Response to a `history` request. Returns a page of messages for a chat/thread.
@@ -225,9 +229,16 @@ First frame; auth + caps.
 Send text (or a `/slash-command`).
 ```json
 {"type":"message.send","id":10,"chat_id":"android:default","thread_id":null,
- "payload":{"text":"/model qwen3-27b","reply_to":"m_9001","media_refs":["mu_1"]}}
+ "payload":{"text":"/model qwen3-27b","reply_to":"m_9001","media_refs":["mu_1"],
+            "auto_thread":false}}
 ```
 `media_refs` reference completed `media.upload`s to attach.
+`auto_thread` (optional, default false) asks the gateway to mint a fresh
+thread for the message (auto-threading, `06-channels-cron-search.md` §6.3):
+honored only in a channel's flat lane (`thread_id` null) with non-empty text
+that is not a slash command. The gateway then broadcasts
+`channel.created {auto:true}` and the echo / agent turn carry the new
+`thread_id`.
 
 ### `media.upload.start` / (binary) / `media.upload.end`
 See `07-media.md`.

docs/05-streaming.md

@@ -27,8 +27,15 @@ replace the bubble text (cheap: it's a full snapshot). On `message.stop`,
 finalize (attach reasoning/model/tokens footer, stop the cursor). Auto-scroll
 while the user is at the bottom.
 
-**Streaming on/off.** Controlled by hermes `display.platforms.android.streaming`
-(default follows global). When off, the app just gets one final `message` frame.
+**Streaming on/off.** Two levels:
+- **Gateway side:** hermes `display.platforms.android.streaming` (default
+  follows global). When off, the app just gets one final `message` frame.
+- **App side (per device):** Settings → "Streaming" toggle (default on). When
+  off, the app ignores `message.start`/`message.update` frames and
+  materializes each reply as a single final message on `message.stop`
+  (`ChatStore.onMessageStop` already handles a stop without a live bubble).
+  The gateway keeps streaming — frames are broadcast to all devices, so this
+  is a display preference like tool verbosity, not a wire flag.
 
 ## 5.2 Reasoning (shown *before* the message)
 

docs/06-channels-cron-search.md

@@ -45,6 +45,34 @@ gateway identity concepts**.
 - The gateway's `create_handoff_thread` is used where hermes wants to open a
   named thread (e.g. continuable cron).
 
+### 6.3.1 Auto-threading (Telegram topic-mode workflow)
+
+With **Threads ON**, a message sent in a channel's flat lane (no active
+thread) gets its **own fresh thread**, the way Telegram topic mode mints a
+topic per new conversation — and the **AI names it** instead of the user:
+
+1. The app sends `message.send {…, auto_thread:true}` (only from a flat lane,
+   with non-empty text, never for slash commands).
+2. The gateway mints a thread (`channel.create`-equivalent, `kind:thread`)
+   under the channel, **named instantly** from the user's opening message via
+   hermes' session-title derivation (`agent/title_generator.derive_title` —
+   a deterministic slice of the user's own words, no model call), and
+   broadcasts `channel.created {auto:true}`.
+3. The user echo, the agent turn, and all streaming frames carry the new
+   `thread_id` — the whole conversation lives in the thread.
+4. In the background, the gateway upgrades the name with the model's title
+   (`agent/title_generator.generate_title`, the `title_generation` auxiliary
+   task) and broadcasts `channel.renamed`. This is hermes' two-stage session
+   titling (derived < llm < user) applied to the thread name; failures leave
+   the derived name in place.
+
+App side: on `channel.created {auto:true}` under the flat lane it is viewing,
+the app **jumps into the new thread** and relocates the optimistic pending
+bubble from the flat lane into it (the echo arrives in the thread lane).
+Follow-ups sent inside the thread stay there; the next flat-lane message
+starts another thread. Media-only sends and slash commands stay in the flat
+lane (nothing to title / session-scoped, not conversation starters).
+
 ## 6.4 User-created channels (for cron delegation)
 
 - **Requirement:** the user creates new channels so **cron job outputs can be
@@ -55,6 +83,9 @@ gateway identity concepts**.
 - **`channel.rename` / `channel.set_default` / `channel.delete`** manage the
   directory (rename broadcasts `channel.renamed`; delete is soft — marks
   archived, keeps history for search).
+- **App affordance for threads:** long-press (touch) / right-click (desktop) a
+  topic chip → "Rename" (`channel.rename`) or "Delete" (`channel.delete`).
+  Deleting the open thread falls the app back to the channel's flat lane.
 - **Cron targeting** (the key payoff): because the plugin registers
   `parse_target_ref_fn` and `cron_deliver_env_var`, cron jobs and the
   `send_message` tool can target any channel/thread:

docs/10-android-app.md

@@ -93,18 +93,35 @@ app/shared/src/
   clarifies) render as **native pickers** from `picker.*` frames (a dialog /
   sheet with the options; answer via `picker.select`).
 
+### Streaming (app-controlled)
+- **Settings → "Streaming"** toggle (default on). When off, the app ignores
+  `message.start`/`message.update` frames and shows each reply as a single
+  final message on `message.stop` (the typing indicator covers the wait).
+  Per-device display preference — the gateway keeps streaming for other
+  devices (see `05-streaming.md` §5.1).
+
 ### Tool output (app-controlled verbosity)
 - `ToolCard` renders `tool.start/progress/end` frames.
+- The gateway always supplies the **full** tool data: it forces
+  `display.platforms.android.tool_progress: verbose` (so the progress line
+  carries the full args JSON → `tool.start.args`) and captures each completed
+  call via the `post_tool_call` hook (→ `tool.end` `output_preview` /
+  `duration` / `ok`). The app decides how much to show.
 - **Settings → "Tool detail": Everything / Truncated / Nothing.**
-  - Everything: name + full args (collapsible) + output preview.
-  - Truncated (default): `emoji name: "short preview"` one-liner, expandable.
-  - Nothing: suppress tool frames.
+  - Everything: cards start expanded — name + full args + output.
+  - Truncated (default): compact one-liner; tap a card to reveal the full
+    args + output (what was actually called).
+  - Nothing: suppress tool cards.
 - Spinner while running; ✓/✗ + duration on `tool.end`.
 
 ### Reasoning before message
 - `ReasoningBlock` (collapsible, "💭 Reasoning" header, monospace body, **copy**
   button) rendered **above** the message body from the `reasoning` field.
   Matches the reference screenshot.
+- **Settings → "Reasoning"** toggle (default on): auto-collapse — long
+  reasoning blocks start collapsed, short ones expanded. Off: all reasoning
+  blocks start expanded. Per-device display preference; the per-block
+  tap-to-toggle always works.
 
 ### Intermediate messages
 - `commentary` frames → dimmed/smaller bubble, distinct from final answers.
@@ -122,8 +139,20 @@ app/shared/src/
   highlight bar) — matches the reference left sidebar.
 - **Thread toggle** in the default chat header: "Threads on/off". On → topic
   switcher above the message list (each topic = a `thread_id`).
+- **Auto-threading** (Threads on, Telegram topic-mode workflow,
+  `06-channels-cron-search.md` §6.3.1): a message sent in a channel's flat
+  lane goes out as `message.send {auto_thread:true}`; the gateway mints a
+  fresh thread (instant derived name, AI-named a moment later via
+  `channel.renamed`) and the app jumps into it, relocating the optimistic
+  bubble from the flat lane.
 - **New channel** (FAB / channel-list menu) → `channel.create` → appears in list;
   menu offers "Set as cron target".
+- **Topic context menu** — long-press a topic chip (touch) or right-click it
+  (desktop mouse) → "Rename" / "Delete". Rename → `channel.rename` (prefilled
+  dialog); Delete → confirm → `channel.delete` (soft-delete; the thread leaves
+  the switcher and, if it was the open lane, the app falls back to the channel's
+  flat lane). The right-click handler is a skiko `expect`/`actual`
+  (`iris/ui/ContextMenu.kt`); on touch it is a no-op (long-press covers it).
 
 ### Search
 - Search bar (chat header or top) with a **scope toggle**: "Search everywhere" /

docs/13-testing.md

@@ -32,6 +32,11 @@ without the app (critical for verifying frame shapes early).
   - **Push backend selection:** fcm vs ntfy chosen by config; `configured()`
     reflects missing creds.
   - **Channel directory:** create/rename/set_default; cron target resolution.
+  - **Auto-threading:** `message.send {auto_thread:true}` in a flat lane mints a
+    thread (derived name, `channel.created {auto:true}`) and the echo/event
+    carry the new `thread_id`; no-op with an existing `thread_id`, for slash
+    commands, or for media-only sends; the LLM upgrade renames the thread
+    (`channel.renamed`).
 - **No `~/.hermes` writes in tests** — use the `_isolate_hermes_home` fixture
   pattern (temp `HERMES_HOME`). Profile tests also mock `Path.home()`.
 
@@ -113,6 +118,10 @@ adb logcat -d > /tmp/logcat.txt
     trigger a message → FCM notification appears → tap → syncs + deep-links.
 12. **Reconnect/sync:** kill the WS (stop gateway briefly) → restart → app
     reconnects → `sync` catches up (no lost/dup messages).
+13. **Auto-threading:** Threads on → send a message in the Default channel's
+    flat lane → a new topic appears (derived name), the app jumps into it, the
+    reply streams there, and the topic is renamed to the AI's title a moment
+    later. Slash commands / media-only sends stay in the flat lane.
 
 ## 13.5 Debugging tips
 

docs/protocol/frames.schema.json

@@ -49,7 +49,7 @@
       "typing": { "payload": { "on": { "type": "boolean" } } },
       "notification": { "payload": { "kind": { "type": "string", "enum": ["channel_renamed", "channel_created", "channel_deleted", "cron", "approval", "clarify", "generic"] }, "title": { "type": "string" }, "body": { "type": "string" }, "ts": { "type": "integer" } } },
       "channel.list": { "description": "Full channel directory (response to a channel.list request).", "payload": { "channels": { "type": "array", "items": { "$ref": "#/definitions/channel" } } } },
-      "channel.created": { "payload": { "$ref": "#/definitions/channel" } },
+      "channel.created": { "description": "May carry auto:true for a thread the gateway minted itself for an incoming message (auto-threading); the name is a derived title, upgraded by a follow-up channel.renamed.", "payload": { "$ref": "#/definitions/channel" } },
       "channel.renamed": { "description": "Also the response to channel.set_default (carries the full entry incl. is_default).", "payload": { "$ref": "#/definitions/channel" } },
       "channel.deleted": { "payload": { "chat_id": { "type": "string" } } },
       "search.results": { "payload": { "query": { "type": "string" }, "scope": { "type": "string", "enum": ["all", "chat"] }, "hits": { "type": "array", "items": { "type": "object", "properties": { "message_id": {"type":"string"}, "chat_id": {"type":"string"}, "thread_id": {"type":["string","null"]}, "role": {"type":"string"}, "snippet": {"type":"string"}, "ts": {"type":"integer"} } } } } },
@@ -59,12 +59,13 @@
       "error": { "payload": { "code": { "type": "string", "enum": ["auth", "not_found", "rate_limited", "media_too_large", "unsupported", "internal"] }, "message": { "type": "string" } } },
       "pong": { "payload": { "ts": { "type": "integer" } } },
       "sync.done": { "payload": { "cursor": { "type": "integer" } } },
+      "history": { "description": "Paged full message history for a chat/thread (response to a history request). Reconstructed from the outbox log; used to populate the view on first open / after a process death, since sync only replays the outbox delta.", "payload": { "messages": { "type": "array", "items": { "type": "object", "properties": { "message_id": {"type":"string"}, "role": {"type":"string","enum":["user","assistant"]}, "text": {"type":"string"}, "reasoning": {"type":"string"}, "model": {"type":"string"}, "tokens": {"type":"integer"}, "ts": {"type":"integer"}, "media": {"type":"array","items":{"$ref":"#/definitions/media_ref"}} } } }, "has_more": { "type": "boolean", "description": "True when older pages exist." }, "oldest_message_id": { "type": "string", "description": "before_message_id for the next (older) page." } } } },
       "media.pull.end": { "payload": { "ok": { "type": "boolean" } } },
       "media.upload.ack": { "description": "Response to media.upload.end; ref is cached and usable in message.send media_refs.", "payload": { "ok": { "type": "boolean" }, "media_ref": { "type": "string" } } }
     },
     "app_to_server": {
       "hello": { "description": "First frame; auth + caps.", "payload": { "token": { "type": "string" }, "device_id": { "type": "string" }, "device_name": { "type": "string" }, "caps": { "type": "object", "properties": { "min_protocol": {"type":"integer"}, "media": {"type":"boolean"}, "push": {"type":"string"} } }, "fcm_token": { "type": "string" }, "ntfy_topic": { "type": "string" } } },
-      "message.send": { "payload": { "text": { "type": "string" }, "reply_to": { "type": "string" }, "media_refs": { "type": "array", "items": { "type": "string" } } } },
+      "message.send": { "payload": { "text": { "type": "string" }, "reply_to": { "type": "string" }, "media_refs": { "type": "array", "items": { "type": "string" } }, "auto_thread": { "type": "boolean", "description": "Optional, default false. Ask the gateway to mint a fresh thread for this message (auto-threading). Honored only in a channel's flat lane (thread_id null) with non-empty non-slash text; the gateway broadcasts channel.created {auto:true} and the echo/turn carry the new thread_id." } } },
       "media.upload.start": { "payload": { "media_ref": { "type": "string" }, "kind": { "$ref": "#/definitions/kind" }, "mime": { "type": "string" }, "size": { "type": "integer" }, "filename": { "type": "string" } } },
       "media.upload.end": { "payload": { "media_ref": { "type": "string" }, "sha256": { "type": "string" } } },
       "media.pull": { "payload": { "media_id": { "type": "string" } } },
@@ -75,13 +76,14 @@
       "channel.list": { "description": "Request the full channel directory; answered by the server_to_app channel.list frame.", "payload": {} },
       "search": { "payload": { "query": { "type": "string" }, "scope": { "type": "string", "enum": ["all", "chat"] }, "chat_id": { "type": "string" }, "thread_id": { "type": "string" }, "limit": { "type": "integer", "description": "Optional; server default 20." } } },
       "sync": { "description": "Reconnect catch-up; replays undelivered outbox frames only (not full history).", "payload": { "cursor": { "type": "integer" } } },
+      "history": { "description": "Load a page of full message history for a chat/thread (initial open, scroll-up pagination).", "payload": { "before_message_id": { "type": "string", "description": "Return messages older than this (omit for newest page)." }, "limit": { "type": "integer", "description": "Max messages (default 50, max 200)." } } },
       "fcm.register": { "payload": { "fcm_token": { "type": "string" }, "ntfy_topic": { "type": "string" } } },
       "ping": { "payload": { "ts": { "type": "integer" } } }
     }
   },
   "definitions": {
     "kind": { "type": "string", "enum": ["image", "audio", "video", "document", "voice"] },
-    "channel": { "type": "object", "properties": { "chat_id": {"type":"string"}, "name": {"type":"string"}, "kind": {"type":"string","enum":["default","channel","thread"]}, "parent_chat_id": {"type":["string","null"]}, "is_default": {"type":"boolean"}, "archived": {"type":"boolean"} } },
+    "channel": { "type": "object", "properties": { "chat_id": {"type":"string"}, "name": {"type":"string"}, "kind": {"type":"string","enum":["default","channel","thread"]}, "parent_chat_id": {"type":["string","null"]}, "is_default": {"type":"boolean"}, "archived": {"type":"boolean"}, "auto": {"type":"boolean","description":"Optional; true on channel.created for a gateway-minted auto-thread."} } },
     "media_ref": { "type": "object", "properties": { "media_id": {"type":"string"}, "kind": { "$ref": "#/definitions/kind" }, "mime": {"type":"string"}, "size": {"type":"integer"}, "filename": {"type":"string"}, "message_id": {"type":"string","description":"Optional; set on media.offer to associate the offer with the assistant message it belongs to."} } }
   },
   "x-planned-frames": [
@@ -91,8 +93,6 @@
     { "name": "picker.approval", "direction": "server_to_app", "note": "Approval picker prompt. Planned, not implemented (approvals arrive as notification)." },
     { "name": "picker.confirm", "direction": "server_to_app", "note": "Confirmation picker prompt. Planned, not implemented." },
     { "name": "picker.select", "direction": "app_to_server", "note": "Picker answer. Planned, not implemented." },
-    { "name": "history", "direction": "server_to_app", "note": "Paged history response. Planned, not implemented (catch-up is sync/outbox replay)." },
-    { "name": "history", "direction": "app_to_server", "note": "Paged history request. Planned, not implemented (catch-up is sync/outbox replay)." },
     { "name": "commands.catalog", "direction": "server_to_app", "note": "Slash-command catalog. Planned, not implemented." },
     { "name": "commands.catalog", "direction": "app_to_server", "note": "Slash-command catalog request. Planned, not implemented." },
     { "name": "commands.complete", "direction": "server_to_app", "note": "Slash-command autocomplete. Planned, not implemented." },