From 4589a61853f39de889bb12108edbd01e7eea58ad Mon Sep 17 00:00:00 2001
From: lexis <lexis@hyperhive>
Date: Tue, 26 May 2026 16:02:22 +0200
Subject: [PATCH] docs: add fire_schedule_now tool and
 /api/schedules/{id}/fire-now endpoint (follow-up to #472)

---
 docs/turn-loop.md | 5 +++++
 docs/web-ui.md    | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/docs/turn-loop.md b/docs/turn-loop.md
index d5d12d41..52b32eb9 100644
--- a/docs/turn-loop.md
+++ b/docs/turn-loop.md
@@ -347,6 +347,11 @@ meta's.
   to cancel just those recipients (auto-cancels when every target
   is removed). Authorization: manager can cancel schedules it owns
   or any owned by a sub-agent in its topology subtree.
+- `fire_schedule_now(id)` — fire a scheduled prompt out of band.
+  Runs the per-target fan-out once immediately. Recurring schedules
+  keep their cadence (the manual fire is additive); one-shot
+  schedules are consumed by the fire and cancelled afterwards. Same
+  authorization rules as `cancel_schedule`.
 - `list_schedules()` — snapshot every schedule (active +
   cancelled-but-not-reaped): id, owner, body, per-target
   `last_fired_at` + `last_result`, `next_fire_at_unix`,
diff --git a/docs/web-ui.md b/docs/web-ui.md
index dd681aca..3eda41eb 100644
--- a/docs/web-ui.md
+++ b/docs/web-ui.md
@@ -500,6 +500,11 @@ not ours.
   is sent as `null`). Targets stay immutable — cancel + new
   schedule is the retarget workaround. Refuses cancelled rows;
   returns the updated `WireSchedule` on success.
+- `POST /api/schedules/{id}/fire-now` — operator-initiated manual
+  fire (#467). Runs the per-target fan-out once immediately.
+  Recurring schedules keep their cadence (manual fire is additive);
+  one-shot schedules are consumed (cancelled afterwards). Manager
+  surface: `fire_schedule_now(id)` MCP tool.
 - `POST /api/schedules/{id}/cancel` — cancel a schedule. Body
   `{ targets?: ["name", …] }` cancels just those recipients;
   absent or empty body cancels the whole schedule.