Persistent context
What the project retains
- Long-lived and growing
- Holds current, superseded and historical records
- May contain sources that disagree
- Not bounded by a single model call
AI agents do not only have a memory problem. They have a context-selection problem.
ACLA keeps persistent project context and compiles a Mission Working Set for each model call: the minimum relevant, current, authoritative and provenance-aware context that mission needs.
pip install "acla-agentic-context-runtime[mcp]==4.0.0"Agents are increasingly given long-lived memory: project history, decisions, conversations and captured activity. Retaining that material is useful. Passing all of it, or a similarity-ranked slice of it, to the model is not the same as giving the model what it needs.
What the project retains
What the model receives for this mission
ACLA keeps these two deliberately separate. Retaining more is cheap. Putting it in front of the model has a cost in tokens, attention and correctness.
Project knowledge, decisions and captured workspace activity, including superseded and conflicting records.
Deterministic selection using:
Receives the working set, not the whole memory.
Adjacent, separate concerns
MCRcapability, provider and tool selection
EAFauthorization and outcome assurance
Context sources can be registered with a temporal state and an authority class, so these decisions rest on declared properties rather than on similarity alone.
ACLA runs as a set of local services with a CLI, a REST interface, a local UI and an MCP server.
Register a project against a workspace. Persistent context is kept per project and can be listed, added to or archived.
acla project add · acla contextModel providers are configured separately from projects. The release was qualified with a local model (qwen3:8b).
acla provider addA mission is a question run against a project: the compiler builds the working set, then the model is called with it.
acla mission runLocal services start, report independent component status, restart and stop. Stopping preserves durable state.
acla start · status · stopA local event bus for client activity, supervised by the runtime lifecycle.
acla activity-busWorkspace capture observes a registered project read-only.
acla captureACLA tools are served to MCP-compatible clients over stdio with the [mcp] extra installed.
acla mcp serveMission runs are recorded so they can be inspected and replayed deterministically.
acla view-run · replay-runSelects and compiles mission context from persistent project context.
Capability selection is a separate architectural concern.
Authorization and outcome assurance are a separate architectural concern.
Knowing is not the same as being able, and being able is not the same as being allowed. Collapsing these into one component makes each harder to reason about and harder to prove. Capella is a governed enterprise engineering environment where these ideas can be applied together.
Scope: Windows with a local model (qwen3:8b). The Activity Bus was live and workspace capture was live in read-only mode. Published artefacts were read back byte for byte from the GitHub release and from PyPI, and the PyPI files were checked for hash and non-yanked status.
Linux and macOS lifecycle behaviour is not qualified for 4.0.0: one Linux lifecycle test did not pass because the model identity check remained pending. This is release evidence for a local runtime. It is not SAP, production, enterprise or provider certification, and it is not a claim of general performance improvement.
acla_agentic_context_runtime-4.0.0-py3-none-any.whl177,953 bytesSHA-256 7765c6ac2c4868ac8d0b781a966ce4a6cc968323e0da22cfc07f2fed5522c378acla_agentic_context_runtime-4.0.0.tar.gz193,042 bytesSHA-256 cf1fb0495ec5a1ab020876da63402bd3411a44f200c39c808c3ec4a4adb420a2Requires Python 3.11+. The [mcp] extra adds the MCP server.
pip install "acla-agentic-context-runtime[mcp]==4.0.0"The example uses a local Ollama provider; install Ollama and pull qwen3:8b first. Replace /path/to/workspace with your project folder.
acla init
acla project add MYPROJECT --workspace /path/to/workspace
acla provider add local --type ollama --model qwen3:8b
acla start
acla status
acla mission run "What is the current blocker?" --project MYPROJECT
acla stopThis is the same path used to qualify the release: register a project, run a real mission against a local model, then inspect and replay the recorded run. A recorded walkthrough is not yet published.
Known issue in 4.0.0: acla status prints a stale release-status line that describes the build as an unreleased candidate. The published 4.0.0 artefacts are the ones listed under Evidence.
ACLA grew out of research into agentic context lifecycle architecture: contracts, compiler logic, evaluation and metrics for how context should move through an agent's work. Related published work treats context, token and tool use as engineering controls.
The runtime is an engineering implementation of those ideas. It does not re-run, revise or extend previously published research results; those stand as published.
These are areas of active engineering interest. They carry no dates and are not commitments.
PyPI is the public distribution channel for ACLA today.