From 27ee375892dba4a4774a2b8372cbe4e878769e92 Mon Sep 17 00:00:00 2001
From: Levi Neely <lneely@pascom.net>
Date: Wed, 29 Jul 2026 18:14:41 +0200
Subject: [PATCH] README: fix session lifecycle, remove /tmp/ollie reference

---
 README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 2153bcf..83cfae4 100644
--- a/README.md
+++ b/README.md
@@ -100,7 +100,9 @@ Skills are domain-specific knowledge modules in `OLLIE_SKILLS_PATH` (default: `~
 
 ## Session lifecycle
 
-`NewAgentCore` creates `/tmp/ollie/{sessionID}` at session start. `Core.Close()` removes it. The 9P server instantiates the execute server and elevation broker at the daemon level; sessions share them with per-session state via the tool registry.
+The 9P server (`olliesrv`) is the session manager. It instantiates the execute server, elevation broker, and tool/skill registries at daemon level. Sessions are created, queried, and controlled via the 9P filesystem — all agent interaction uses the `ollie-9p` client internally.
+
+`NewAgentCore` handles per-session state: message history, tool call routing, compaction, and hooks. `Core.Close()` tears down resources when a session is killed.
 
 ## License