diff --git a/src/session_logger.py b/src/session_logger.py
index a8b129f2..8b9c9b22 100644
--- a/src/session_logger.py
+++ b/src/session_logger.py
@@ -6,14 +6,27 @@ previous run's files are simply closed when the process exits.
 
 File layout
 -----------
-logs/sessions/
-    comms_<ts>.log      - every comms entry (direction/kind/payload) as JSON-L
-    toolcalls_<ts>.log  - sequential record of every tool invocation
-    clicalls_<ts>.log   - sequential record of every CLI subprocess call
-scripts/generated/
-    <ts>_<seq:04d>.ps1  - each PowerShell script the AI generated, in order
+logs/sessions/<session_id>/
+    comms.log          - every comms entry (direction/kind/payload) as JSON-L
+    toolcalls.log      - sequential record of every tool invocation
+    apihooks.log       - sequential record of every API hook call
+    clicalls.log       - sequential record of every CLI subprocess call
+    scripts/           - subdir containing the AI-generated PowerShell scripts
+    outputs/           - subdir containing tool outputs saved via log_tool_output()
 
-Where <ts> = YYYYMMDD_HHMMSS of when this session was started.
+scripts/generated/
+    <ts>_<seq:04d>.ps1  - top-level copy of every PowerShell script the AI
+                          generated, in order. The session_dir/scripts/ subdir
+                          also gets a copy per session.
+
+Where <ts> = YYYYMMDD_HHMMSS of when this session was started, and
+<session_id> = <ts>[_<Label>] (the optional label is sanitized to
+alnum + dash + underscore via open_session(label=...)).
+
+Note: the FILENAMES are plain (comms.log, toolcalls.log, apihooks.log,
+clicalls.log) — the <ts>/session_id is the PARENT DIRECTORY, not a filename
+prefix. The docstring above previously said comms_<ts>.log which is
+incorrect since commit 73e1a36d restructured to per-session subdirs.
 """
 
 import atexit