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
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
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 the sessions root. The standalone CLI now
defaults to .agent-loop/sessions/:
session.json carries the claim metadata that makes parallel agents safe:
claimed_by, claimed_at, and base_commit.
validation-evidence.jsonl records actual executions against the durable
Contract revision that required them. A record cannot claim passed with a
non-zero exit code. Contract revisions and their approval are owned by
voku/agent-loop; durable Learning close-out is owned by voku/agent-learning.
Keeping those artifacts out of the Session is what makes pruning working memory
safe.
Requirements
| Requirement | Version |
|---|---|
| PHP | 8.3 or newer |
Install
Quick start
Sessions default to <cwd>/.agent-loop/sessions; use --root PATH to point
somewhere else. The full command surface is in docs/cli.md.
Hosts should embed the typed API rather than shelling out:
See docs/php-api.md for the full host integration contract.
Documentation
| Document | Covers |
|---|---|
| docs/cli.md | CLI reference and the relationship to the governed agent-loop lifecycle |
| docs/php-api.md | Typed host integration, Session allocation rules, handoff, validation evidence |
| UPGRADING.md | Breaking changes between releases |
| AGENTS.md | Repository role, dependency direction, invariants |
Shipped assets
This package ships a maintainer skill for agents working on the package itself:
Resolve shipped assets through PackageResources instead of hard-coding paths:
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— deterministic recall and project-specific prompt construction from the approved Contract.voku/agent-loop— the unifiedagent-loopbinary that exposes and governs the cross-package lifecycle (agent-loop session …,agent-loop workflow …).
Development
License
MIT — see LICENSE.
