2.2.1 • Published 5d ago

@openvole/paw-session

Licence

MIT

Version

2.2.1

Deps

Size

43 kB

Vulns

Weekly

314

Session and conversation management.

Part of OpenVole — the microkernel AI agent framework.

npm install @openvole/paw-session

{
  "name": "@openvole/paw-session",
  "allow": {
    "env": ["VOLE_SESSION_DIR", "VOLE_SESSION_TTL"]
  }
}

Variable	Description
`VOLE_SESSION_DIR`	Directory for storing session data
`VOLE_SESSION_TTL`	Session time-to-live before expiry

Tool	Description
`session_history`	Read conversation history for a session
`session_clear`	Clear a session's transcript and metadata
`session_list`	List all active sessions with their last activity time
`session_append`	Append a single message to a session transcript (outside the Brain loop, e.g. peer-to-peer chat); optional `maxMessages` trims to the last N

Brain replies are recorded to the session that owns the task, so transcripts stay correct even when tasks interleave.
TTL expiry marks a session inactive but no longer wipes its transcript — conversation history persists.

Keywords