Download the PHP package voku/agent-session without Composer
On this page you can find all versions of the php package voku/agent-session. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download voku/agent-session
More information about voku/agent-session
Files in voku/agent-session
Package agent-session
Short Description Working-memory layer for coding agents: per-task session plans, decisions, assumptions, checkpoints, claim metadata, and retention.
License MIT
Homepage https://github.com/voku/agent-session
Informations about the package agent-session
Agent Session (voku/agent-session)
The working-memory layer of the governed agentic-coding loop.
A task is durable intent. A session is the temporary, mutable context an agent needs to finish that task: the plan, the assumptions it had to make, the decisions it took, the validation it ran, and resumable checkpoints. Working memory is meant to be volatile — it helps complete the current task and then it gets pruned. It is not project memory, and it must not quietly become durable architecture.
This package keeps that layer explicit, claimable, and bounded.
What it manages
Each session is one directory under a sessions root (default session_plan/):
session.json carries the claim metadata that makes parallel agents safe:
claimed_by, claimed_at, and base_commit.
work-brief.json is intentionally separate from mutable plan notes. It records
the task goal, approved scope, non-goals, validation commands, a schema version,
and a revision/status (candidate, approved, or superseded). Changing the
brief creates a new candidate revision, archives the prior revision, and
invalidates its approval. Existing sessions without a work brief remain valid.
validation-evidence.jsonl records actual executions against the brief revision
that required them. Re-planning does not delete old evidence; the next workflow
can therefore show it as stale instead of accidentally treating it as proof for
the new scope. learning-decision.json makes forgetting explicit: a completed
session records whether it produced findings, no durable learning, or a follow-up.
Requirements
| Requirement | Version |
|---|---|
| PHP | 8.3 or newer |
Install
CLI
Use --root PATH to point at a sessions directory other than <cwd>/session_plan.
Where it fits
This is one layer of the loop. It pairs with:
voku/agent-kanban— the durable tasks the sessions serve.voku/agent-learning— findings/proposals distilled from a finished session.voku/agent-recall-compiler— the briefing compiled before a session.voku/agent-loop— the unifiedagent-loopbinary that exposes all of them (agent-loop session …).
Development
License
MIT — see LICENSE.