diff --git a/cmd/olliesrv/internal/fs/spec.go b/cmd/olliesrv/internal/fs/spec.go
index 512f00f..accf1b0 100644
--- a/cmd/olliesrv/internal/fs/spec.go
+++ b/cmd/olliesrv/internal/fs/spec.go
@@ -877,10 +877,14 @@ func buildAgentChildren(a *agent.Agent, s *session.Session) []virtfs.FsNodeDecl
 			}),
 			virtfs.Stream(a.ChatRead, a.ChatSignal),
 		),
-		virtfs.FileNode("statewait", 0444,
+		virtfs.FileNode("state", 0444,
+			virtfs.Doc("Current agent state (idle, calling, thinking, paused)"),
 			virtfs.Read(func() ([]byte, error) {
 				return []byte(a.State() + "\n"), nil
 			}),
+		),
+		virtfs.FileNode("statewait", 0444,
+			virtfs.Doc("Blocks until state changes; returns new value"),
 			virtfs.BlockOnce(func() ([]byte, string, error) {
 				st := a.State()
 				return []byte(st + "\n"), st, nil