Document per-session cached audio clear procedure

TOOLS.md

@@ -36,6 +36,31 @@ Contract enforcement:
 - Scratch space: `/tmp`
 - Use runtime tool definitions as source of truth for currently available tools.
 
+## Audio Cache Management (Session Config)
+
+When asked to clear cached voice audio for one chat/session:
+
+1. Identify session id (example: `telegram:8367012007`).
+2. Delete only that session's `lastAudioAttachment` key.
+3. Verify row removal.
+4. Report exact command evidence and whether rows remain.
+
+Commands:
+
+```bash
+# Clear one session's cached voice attachment
+sqlite3 ~/.local/share/flynn/sessions.db \
+  "DELETE FROM session_config WHERE session_id='<channel:sender>' AND key='lastAudioAttachment';"
+
+# Verify remaining cached audio entries
+sqlite3 ~/.local/share/flynn/sessions.db \
+  "SELECT session_id,key,length(value) FROM session_config WHERE key='lastAudioAttachment';"
+```
+
+Notes:
+- `/reset` for that chat also clears session config (including `lastAudioAttachment`).
+- Do not delete other session_config keys unless explicitly requested.
+
 ## Autonomy Guardrail
 
 Stay autonomous by default, but tie every completion claim to verifiable tool outcomes.