LivXue · Sep 17, 2026 · Sep 17, 2026 · Sep 17, 2026 · Sep 17, 2026 · Sep 17, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -92,6 +92,35 @@ All notable changes to Raven are documented here.
 
 ### Fixed
 
+- Raven serving ACP sends a run of thought tokens as one
+  `agent_thought_chunk` instead of one frame per token: consecutive thought
+  chunks of a session are held for 200ms or 512 characters and go out
+  together, ahead of anything that has to follow them (a chunk of the
+  answer, a tool call, the turn's end). One design run wrote 58,675 thought
+  frames averaging under six characters; each frame is a blocking write on
+  the client's pipe, and a client that stopped reading held the server on
+  that write. The same stream replays to 4,333 frames. The first thought
+  token of a turn therefore reaches an ACP client up to 200ms later than
+  before; the answer's own chunks are not held.
+
+- A failed turn names what failed. The failure event carried only
+  `str(exc)`, which is empty for the bare `TimeoutError` a stalled model
+  stream raises, so an ACP client was told `turn_failed (code -32099)` and
+  nothing else and the parent of a sub-agent read that as a crash of the
+  tool call it saw last. The event now carries the exception's class and
+  message (`ValueError: boom`, `TimeoutError`), and the per-chunk idle
+  stall raises `StreamIdleTimeoutError`, a `TimeoutError` whose message
+  says how long the stream was silent and which bound decided it.
+
+- An on-call campaign bills only its own runs. Campaigns of one task usually
+  keep their rounds in one `remote_dir`, and the spend measure walked that
+  directory's `jobs/`, so a later campaign was charged for every earlier one's
+  runs the moment it started: a second-round campaign with a 130-minute budget
+  read 125.6 spent on its first look, 34.6 of it its own, and stopped with 142
+  real minutes unspent. The backend now counts the jobs in the campaign's own
+  ledger (plus what it submitted itself), and `ops_declare` refuses a
+  `remote_dir` a live sibling campaign is still writing rounds into.
+
 - The web file viewer opens a sub-agent's report again. `/file` anchored the
   state-directory fence on the session's working directory whenever the page
   named a session, so the fence exempted `~/.raven/tmp/<channel>` and refused

diff --git a/README.md b/README.md
@@ -18,7 +18,7 @@
 # What is Raven
 
 <p align="center">
-  <a href="https://github.com/user-attachments/assets/4ae8ac91-2f0c-4c81-aa7c-c15526bd77af"><img src="https://github.com/user-attachments/assets/4ae8ac91-2f0c-4c81-aa7c-c15526bd77af" alt="Raven one surface, all agents workflow" width="100%"></a>
+  <a href="https://github.com/user-attachments/assets/f400d693-d8cf-46eb-b846-6948f66f6fed"><img src="https://github.com/user-attachments/assets/f400d693-d8cf-46eb-b846-6948f66f6fed" alt="Raven one surface, all agents workflow" width="100%"></a>
 </p>
 
 <p align="center"><em>One Surface, All Agents: Raven generates DAGs and orchestrates multiple specialized agents for complex tasks.</em></p>
@@ -80,7 +80,7 @@ Raven's modular architecture is designed for harness self-evolution and subagent
 <p align="center"><em>Raven-Design tops on PresentBench for slide generation</em></p>
 
 <p align="center">
-  <a href="https://github.com/user-attachments/assets/061b5818-595b-4392-b9b6-53a1effb8347"><img src="https://github.com/user-attachments/assets/061b5818-595b-4392-b9b6-53a1effb8347" alt="Visual Design: Raven-Design, Claude Code, and Hermes on ArtifactsBench Dashboard, ArtifactsBench SVG, and GDPVal" width="95%"></a>
+  <a href="https://github.com/user-attachments/assets/103c49f8-f31d-4735-8bfd-84cae9baee46"><img src="https://github.com/user-attachments/assets/103c49f8-f31d-4735-8bfd-84cae9baee46" alt="Visual Design: Raven-Design, Claude Code, and Hermes on ArtifactsBench Dashboard, ArtifactsBench SVG, and GDPVal" width="95%"></a>
 </p>
 
 <p align="center"><em>Raven-Design's performance on visual design benchmarks</em></p>
@@ -104,49 +104,81 @@ Raven's modular architecture is designed for harness self-evolution and subagent
 ## ❯❯ Showcase
 
 Real runs, each captured from Raven's task graph. The graph shows the
-orchestration Raven chose for the task; below it is what the run produced.
+orchestration Raven generates for the task; below it is what the run produced.
 
 <table>
 <tr>
-<td width="50%" valign="top">
-<p align="center"><b>Song-dynasty domestic aesthetics</b></p>
-<a href="https://github.com/user-attachments/assets/8fa50c96-3d2d-4107-8a8c-7d041d1ac8b4"><img src="https://github.com/user-attachments/assets/8fa50c96-3d2d-4107-8a8c-7d041d1ac8b4" alt="Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node" width="100%"></a>
-<a href="https://github.com/user-attachments/assets/379328ea-e3ee-430f-865d-68ed90dae69f"><img src="https://github.com/user-attachments/assets/379328ea-e3ee-430f-865d-68ed90dae69f" alt="Cover, slides and closing slide of the Song-dynasty aesthetics deck" width="100%"></a>
-</td>
-<td width="50%" valign="top">
-<p align="center"><b>How ancient Greece was whitewashed</b></p>
-<a href="https://github.com/user-attachments/assets/c8e9ac77-0377-487e-9d07-fb4fe51a0257"><img src="https://github.com/user-attachments/assets/c8e9ac77-0377-487e-9d07-fb4fe51a0257" alt="Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node" width="100%"></a>
-<a href="https://github.com/user-attachments/assets/3c5a2a9a-d6d7-40ad-b3dc-70e9f5c095df"><img src="https://github.com/user-attachments/assets/3c5a2a9a-d6d7-40ad-b3dc-70e9f5c095df" alt="Cover, slides and closing slide of the Greek polychromy deck" width="100%"></a>
-</td>
+<td valign="top"><p align="center"><b>An FPS game, picked, built and judged</b></p></td>
 </tr>
 <tr>
-<td width="50%" valign="top">
-<p align="center"><b>How pop music is manufactured</b></p>
-<a href="https://github.com/user-attachments/assets/032fdf6e-8b65-49a0-92ba-2ea3066a7451"><img src="https://github.com/user-attachments/assets/032fdf6e-8b65-49a0-92ba-2ea3066a7451" alt="Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node" width="100%"></a>
-<a href="https://github.com/user-attachments/assets/9ab75945-81ba-4437-aec0-9ef6a633ed55"><img src="https://github.com/user-attachments/assets/9ab75945-81ba-4437-aec0-9ef6a633ed55" alt="Cover, slides and closing slide of the pop music deck" width="100%"></a>
-</td>
-<td width="50%" valign="top">
-<p align="center"><b>A century of abstract art</b></p>
-<a href="https://github.com/user-attachments/assets/4b606bae-667e-4f2f-ae7d-2880b47ddbf6"><img src="https://github.com/user-attachments/assets/4b606bae-667e-4f2f-ae7d-2880b47ddbf6" alt="Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node" width="100%"></a>
-<a href="https://github.com/user-attachments/assets/b3dfce6c-366d-4e31-9a57-7c98df054618"><img src="https://github.com/user-attachments/assets/b3dfce6c-366d-4e31-9a57-7c98df054618" alt="Cover, slides and closing slide of the abstract art deck" width="100%"></a>
+<td valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/951e35bd-ff9c-4456-b539-32dd192827e1"><img src="https://github.com/user-attachments/assets/951e35bd-ff9c-4456-b539-32dd192827e1" alt="Task graph: three Raven-Code nodes running in sequence across 42 game rounds" width="100%"></a></p></td>
+</tr>
+<tr>
+<td valign="top">
+
+https://github.com/user-attachments/assets/44724e3e-6564-467a-b422-473aa8f474bd
+
 </td>
 </tr>
 </table>
 
-Runs that end in something other than a deck.
+<table>
+<tr>
+<td width="50%" valign="top"><p align="center"><b>Song-dynasty domestic aesthetics</b></p></td>
+<td width="50%" valign="top"><p align="center"><b>How ancient Greece was whitewashed</b></p></td>
+</tr>
+<tr>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/8fa50c96-3d2d-4107-8a8c-7d041d1ac8b4"><img src="https://github.com/user-attachments/assets/8fa50c96-3d2d-4107-8a8c-7d041d1ac8b4" alt="Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node" width="100%"></a></p></td>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/c8e9ac77-0377-487e-9d07-fb4fe51a0257"><img src="https://github.com/user-attachments/assets/c8e9ac77-0377-487e-9d07-fb4fe51a0257" alt="Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node" width="100%"></a></p></td>
+</tr>
+<tr>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/379328ea-e3ee-430f-865d-68ed90dae69f"><img src="https://github.com/user-attachments/assets/379328ea-e3ee-430f-865d-68ed90dae69f" alt="Cover, slides and closing slide of the Song-dynasty aesthetics deck" width="100%"></a></p></td>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/3c5a2a9a-d6d7-40ad-b3dc-70e9f5c095df"><img src="https://github.com/user-attachments/assets/3c5a2a9a-d6d7-40ad-b3dc-70e9f5c095df" alt="Cover, slides and closing slide of the Greek polychromy deck" width="100%"></a></p></td>
+</tr>
+</table>
 
 <table>
 <tr>
-<td width="50%" valign="top">
-<p align="center"><b>Six orchestration frameworks, compared</b></p>
-<a href="https://github.com/user-attachments/assets/92ff2c83-3b0f-49eb-9995-c1ad4c298452"><img src="https://github.com/user-attachments/assets/92ff2c83-3b0f-49eb-9995-c1ad4c298452" alt="Task graph: two Raven-Research nodes running in parallel into one Raven-Design node" width="100%"></a>
-<a href="https://github.com/user-attachments/assets/75beba36-a112-46f2-949d-015856dae588"><img src="https://github.com/user-attachments/assets/75beba36-a112-46f2-949d-015856dae588" alt="Comparison board: six orchestration frameworks against four dimensions, colour-coded for explicit-graph versus code-or-model orchestration" width="100%"></a>
-</td>
-<td width="50%" valign="top">
-<p align="center"><b>A parameter sweep, written, run and plotted</b></p>
-<a href="https://github.com/user-attachments/assets/e842677a-8b71-4f1b-ae02-0162a440a1e8"><img src="https://github.com/user-attachments/assets/e842677a-8b71-4f1b-ae02-0162a440a1e8" alt="Task graph: Raven-Code into Raven-Oncall into Raven-Design, run in sequence" width="100%"></a>
-<a href="https://github.com/user-attachments/assets/2b03cc53-e707-4728-8d68-327fcf7d112a"><img src="https://github.com/user-attachments/assets/2b03cc53-e707-4728-8d68-327fcf7d112a" alt="Retrieval sweep: recall@k is set by top_k alone, and latency stays flat across the grid" width="100%"></a>
-</td>
+<td width="50%" valign="top"><p align="center"><b>How pop music is manufactured</b></p></td>
+<td width="50%" valign="top"><p align="center"><b>A century of abstract art</b></p></td>
+</tr>
+<tr>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/032fdf6e-8b65-49a0-92ba-2ea3066a7451"><img src="https://github.com/user-attachments/assets/032fdf6e-8b65-49a0-92ba-2ea3066a7451" alt="Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node" width="100%"></a></p></td>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/4b606bae-667e-4f2f-ae7d-2880b47ddbf6"><img src="https://github.com/user-attachments/assets/4b606bae-667e-4f2f-ae7d-2880b47ddbf6" alt="Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node" width="98%"></a></p></td>
+</tr>
+<tr>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/9ab75945-81ba-4437-aec0-9ef6a633ed55"><img src="https://github.com/user-attachments/assets/9ab75945-81ba-4437-aec0-9ef6a633ed55" alt="Cover, slides and closing slide of the pop music deck" width="100%"></a></p></td>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/b3dfce6c-366d-4e31-9a57-7c98df054618"><img src="https://github.com/user-attachments/assets/b3dfce6c-366d-4e31-9a57-7c98df054618" alt="Cover, slides and closing slide of the abstract art deck" width="100%"></a></p></td>
+</tr>
+</table>
+
+<table>
+<tr>
+<td width="50%" valign="top"><p align="center"><b>Six orchestration frameworks, compared</b></p></td>
+<td width="50%" valign="top"><p align="center"><b>A parameter sweep, written, run and plotted</b></p></td>
+</tr>
+<tr>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/92ff2c83-3b0f-49eb-9995-c1ad4c298452"><img src="https://github.com/user-attachments/assets/92ff2c83-3b0f-49eb-9995-c1ad4c298452" alt="Task graph: two Raven-Research nodes running in parallel into one Raven-Design node" width="100%"></a></p></td>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/e842677a-8b71-4f1b-ae02-0162a440a1e8"><img src="https://github.com/user-attachments/assets/e842677a-8b71-4f1b-ae02-0162a440a1e8" alt="Task graph: Raven-Code into Raven-Oncall into Raven-Design, run in sequence" width="100%"></a></p></td>
+</tr>
+<tr>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/5120c2c0-9aeb-4224-ac85-df9dc188b5cc"><img src="https://github.com/user-attachments/assets/5120c2c0-9aeb-4224-ac85-df9dc188b5cc" alt="Comparison board: six orchestration frameworks against four dimensions, each tagged explicit graph or canvas, declared task flow, or dynamic at runtime" width="100%"></a></p></td>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/10679855-e2c5-4422-81c3-17cd784123ce"><img src="https://github.com/user-attachments/assets/10679855-e2c5-4422-81c3-17cd784123ce" alt="Retrieval sweep dashboard: recall@k is set by top_k alone and latency stays broadly flat, with a sixteen-cell grid of measured recall and latency and the best cell ringed at top_k 10, chunk_size 1024" width="99%"></a></p></td>
+</tr>
+</table>
+
+<table>
+<tr>
+<td width="50%" valign="top"><p align="center"><b>A light-pollution poster campaign</b></p></td>
+<td width="50%" valign="top"><p align="center"><b>An interactive explainer and its solver</b></p></td>
+</tr>
+<tr>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/d3e4c873-cf95-4011-8471-0fda72778cfd"><img src="https://github.com/user-attachments/assets/d3e4c873-cf95-4011-8471-0fda72778cfd" alt="Task graph: three Raven-Research nodes in parallel into a Raven-Code node; that node and a Raven-Design plate node running alongside them both feed the final Raven-Design node" width="83%"></a></p></td>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/9754976b-11ff-4738-b53d-0621ec6ae7da"><img src="https://github.com/user-attachments/assets/9754976b-11ff-4738-b53d-0621ec6ae7da" alt="Task graph: two Raven-Code nodes in parallel into a Raven-Oncall cross-check; that node and a Raven-Design plate node running alongside them both feed the final Raven-Design node" width="100%"></a></p></td>
+</tr>
+<tr>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/7767ac05-6785-4e6a-9e27-c1b123753766"><img src="https://github.com/user-attachments/assets/7767ac05-6785-4e6a-9e27-c1b123753766" alt="Key visual plus the derived series: street poster, data panel, social square and wide banner" width="100%"></a></p></td>
+<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/25c57220-c5fc-4f72-94fb-ea4b7e83f429"><img src="https://github.com/user-attachments/assets/25c57220-c5fc-4f72-94fb-ea4b7e83f429" alt="GPS trilateration explainer: the live page, and the fix at two, three and four satellites" width="97%"></a></p></td>
 </tr>
 </table>
 
@@ -236,11 +268,17 @@ raven web
 
 The command opens the WebUI in your browser and keeps Raven running in the background. Use `raven web --stop` to stop the background service.
 
-> **Screenshot placeholder 1:** Conversations and workspace.
+<p align="center">
+  <a href="https://github.com/user-attachments/assets/9ecddecc-c73f-4249-97bd-58a68ef2c7c1"><img src="https://github.com/user-attachments/assets/9ecddecc-c73f-4249-97bd-58a68ef2c7c1" alt="Raven WebUI new task page" width="90%"></a>
+</p>
+
+<p align="center"><em>New task: one composer, with skills, playbooks, knowledge and memory a click away.</em></p>
 
-> **Screenshot placeholder 2:** Agent collaboration and task graph.
+<p align="center">
+  <a href="https://github.com/user-attachments/assets/68c6f1c7-a709-4742-9e32-1c2cbe98b500"><img src="https://github.com/user-attachments/assets/68c6f1c7-a709-4742-9e32-1c2cbe98b500" alt="Raven WebUI subagents page" width="90%"></a>
+</p>
 
-> **Screenshot placeholder 3:** Memory and skill management.
+<p align="center"><em>Subagents: every connected agent in one roster, built-in and third-party alike.</em></p>
 
 ## ❯❯ EverMind Ecosystem