Document per-session cached audio clear procedure

docs/plans/state.json

@@ -6040,6 +6040,18 @@
         "docs/runbooks/VOICE_TRANSCRIPTION_DEBUG.md"
       ],
       "test_status": "pnpm test:run src/backends/native/agent.test.ts src/daemon/routing.test.ts src/tools/builtin/audio-transcribe.test.ts src/tools/executor.test.ts; pnpm typecheck; pnpm build"
+    },
+    "audit-followup-audio-cache-clear-procedure": {
+      "status": "completed",
+      "date": "2026-02-23",
+      "updated": "2026-02-23",
+      "summary": "Documented deterministic per-session cached audio cleanup procedure so Flynn can clear one session cached lastAudioAttachment safely on request.",
+      "files_modified": [
+        "TOOLS.md",
+        "README.md",
+        "docs/runbooks/VOICE_TRANSCRIPTION_DEBUG.md"
+      ],
+      "test_status": "docs-only update; no runtime code changes"
     }
   },
   "overall_progress": {

docs/runbooks/VOICE_TRANSCRIPTION_DEBUG.md

@@ -83,6 +83,24 @@ sqlite3 ~/.local/share/flynn/sessions.db \
   "SELECT session_id,key,length(value) FROM session_config WHERE key='lastAudioAttachment';"
 ```
 
+### Clear Cached Audio for One Session
+
+Delete only one chat/session cache entry (example session id: `telegram:8367012007`):
+
+```bash
+sqlite3 ~/.local/share/flynn/sessions.db \
+  "DELETE FROM session_config WHERE session_id='telegram:8367012007' AND key='lastAudioAttachment';"
+```
+
+Verify:
+
+```bash
+sqlite3 ~/.local/share/flynn/sessions.db \
+  "SELECT session_id,key,length(value) FROM session_config WHERE key='lastAudioAttachment';"
+```
+
+If `/reset` is run in that chat, it also clears the session's `lastAudioAttachment` row.
+
 ## Data Lifecycle
 
 - `session.clear()` (e.g. `/reset`) removes messages, tool executions, and session config for that session.