agents can transcribe an audio file: the transcribe_audio tool, through the harness and the speech-to-text service

docs/4-implementation/turn-loop/mcp.md

@@ -95,7 +95,7 @@ hive_name?, swarm_name?, matrix_accounts? }`. `matrix_accounts` is a
   `name` to query self.
 
 **Always-on, no permission needed**: `set_status(text)`, `compact()`,
-`mark_todos_done(ids)`.
+`mark_todos_done(ids)`, `transcribe_audio(path)`.
 
 - `set_status` — set a free-text status string visible on the
   dashboard. Single line, ≤ 200 chars. Persisted to
@@ -112,6 +112,15 @@ hive_name?, swarm_name?, matrix_accounts? }`. `matrix_accounts` is a
   notes-checkpoint turn still fires first. Dispatched through the
   in-agent socket (`hive-agent-sock::Request::Compact`), not the
   broker — see `hive-agent/src/todo_server.rs`.
+- `transcribe_audio(path)` — the text spoken in an audio file (a matrix
+  voice memo that `download_file` saved, or any Ogg, WAV, FLAC, MP3, AMR,
+  MP4/M4A or WebM file up to 6 MiB). Dials the in-agent socket
+  (`hive-agent-sock::Request::Transcribe`) with a 16-minute deadline; the
+  harness reads the file and sends it over the swarm queue on this agent's
+  request subject to the speech-to-text service
+  ([`stt.md`](../swarm/stt.md)), which keeps each transcript for a day by the
+  audio's hash. An error names why: no service running, a file that isn't
+  audio, too large, or the service busy.
 - `mark_todos_done(ids)` — bulk-clear specific loose-ends-v2 todo rows
   by id in one call, instead of `cancel_loose_end`ing each one.
   List-based: pass the ids `get_loose_ends` actually showed you reviewed;