@openvole/paw-session

Session and conversation management.

Part of OpenVole — the microkernel AI agent framework.

Install

npm install @openvole/paw-session

Config

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

Environment Variables

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

Tools

| 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 |

Behavior

• 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.

License

MIT