Repository navigation
Release v0.3.0
Released 2026-11-16. A minor release. The runtime's licence and open-source preparation, the bus consumer and conversation memory bounded, and the image's bases pinned by digest, since v0.2.0. The bounded bus and memory change behaviour a caller can see and add settings, which is why this is a minor release and not a patch. Image: docker.io/oramasearch/agent-runtime:v0.3.0.
This release is the tree of dev after #39 (f7e38b7), with these notes and the version.
What changed
Every pull request merged into dev since v0.2.0 (git log --first-parent v0.2.0..origin/dev):
| PR | What it does |
|---|---|
| #30 | Merges main back into dev after the v0.2.0 release; nothing new |
| #31 | Records the v0.2.0 image digest in the v0.2.0 notes; documentation only |
| #34 | Adds a security policy, SECURITY.md: how to report a vulnerability privately, and what we commit to |
| #35 | Pins the Dockerfile's base images (python:3.12-slim, ghcr.io/astral-sh/uv:0.11.7) by digest as well as by tag |
| #33 | Bounds the bus consumer and the conversation memory, and keys a bus turn's history by the account, workspace and task chain Lake names |
| #37 | Prepares the tree for a public export: internal links, names and wording removed from the README, the docs and the release notes |
| #39 | The MIT licence: LICENSE, COPYRIGHT, an SPDX header in every source file, THIRD_PARTY_LICENSES, CONTRIBUTING.md, CLA.md, CODE_OF_CONDUCT.md, and the SBOM (sbom.spdx.json, sbom.cdx.json, tools/sbom.py) |
The licence — #39
agent-runtime is released under the MIT licence, copyright OramaSearch, Inc. (LICENSE, COPYRIGHT). Every source file carries SPDX-License-Identifier: MIT, added and checked by tools/spdx-headers.py. THIRD_PARTY_LICENSES lists the licence of every dependency. Contributions are made under CLA.md (contributors assign copyright to OramaSearch, Inc.), following CONTRIBUTING.md and CODE_OF_CONDUCT.md. tools/sbom.py writes the software bill of materials in SPDX 2.3 and CycloneDX, regenerated for this release.
A security policy — #34
SECURITY.md says how to report a vulnerability privately and what we commit to in reply.
The bus consumer and the conversation memory are bounded — #33
- The bus consumer claims a task only when a worker is free to run it. Nothing is received while every worker is busy, so claimed tasks (and their credentials) no longer pile up in memory, and a task left unclaimed stays on the bus for another replica.
AGENT_BUS_WORKERS(default 4) run at once; one customer holds at mostAGENT_BUS_TENANT_WORKERS(default one fewer), so one tenant's burst cannot take every worker. At most 256 dispatch rows wait. - Every bus turn carries Lake's claim (
task_id,customer_id,workspace_id) asclaim. - Conversation memory is bounded. At most
AGENT_CONVERSATIONSconversations (default 256), each at mostAGENT_CONVERSATION_TURNSturns (20) andAGENT_CONVERSATION_BYTES(1 MiB), all of them at mostAGENT_CONVERSATIONS_BYTES(64 MiB); one idle forAGENT_CONVERSATION_IDLE_SECONDS(3600) is dropped. - A bus turn continues only the conversation its
prior_turnleft in the same account and workspace, never one named by a caller'sconversation_id. A directPOST /v1/turnkeeps its ownconversation_idkey in a separate namespace, so it cannot reach a bus turn's history. A turn that raises is rolled back.
The image's bases are pinned by digest — #35
Each FROM and COPY --from names the multi-platform index digest its tag pointed to, so a later build of the same source gets the same base. A new base is a reviewed change of the digest.
Prepared for a public export — #37
Links to issues and pull requests, internal names and wording are removed from the README, the docs and the earlier release notes. The agent files (CLAUDE.md) ship with the repository.
Behaviour changes to know before it rolls
- A bus turn's history is keyed by Lake's claim, not by the
conversation_idin its body. A bus caller that relied on naming a conversation to continue it continues only the chain itsprior_turnnames. - Conversations are forgotten past the limits above, oldest or idle first.
- The bus consumer runs at most
AGENT_BUS_WORKERSturns at once and leaves the rest on the bus.
Settings it needs
No setting is required. Seven optional settings are new, each with the default above: AGENT_BUS_WORKERS, AGENT_BUS_TENANT_WORKERS, AGENT_CONVERSATIONS, AGENT_CONVERSATION_TURNS, AGENT_CONVERSATION_BYTES, AGENT_CONVERSATIONS_BYTES and AGENT_CONVERSATION_IDLE_SECONDS. git diff v0.2.0..v0.3.0 -- src adds no other environment read.
Not included
- Claiming tasks by reference and naming the task on every call (#36, for lake#871): deferred for review, not in this release.
- Unchanged from v0.1.0 otherwise.
Known issues
Security-relevant first.
- Service turns write every tenant's trace to the shared pod's disk (#38): a service turn's trace (the message, the answer and every tool observation) is written under
TRACE_DIRand never removed. - The image bundles GPL and LGPL code (#40): it is built on
python:3.12-slim(Debian: glibc, bash, coreutils, dpkg, readline), so the image is not published. It moves toscratchwith static binaries before it is. - Dataset-confined launch credentials are not yet confined at Lake (lake#1055): the runtime refuses what it cannot prove, but the launch token itself still carries the person's reach.
- The bus client is not yet the workspace-aware cutover client (#6): no
workspace_idon every call, no lease renewal, no idle backoff. - One test fails (#41):
tests/test_lake_bus.py::test_a_task_is_claimed_run_and_answered_on_the_busstill expects a bus turn's body without theclaimthat #33 adds. The behaviour is the intended one; the test was not updated with it.
Where it has run
The v0.3.0 tree had not run on a development environment when it was released. Lakes take the operator's default runtime image; moving it to :v0.3.0 is a separate operator change.
The image
Built from the tag v0.3.0 (555e403) with BuildKit (linux/amd64, the repository's Dockerfile), then tagged :v0.3.0 on that digest without rebuilding:
docker.io/oramasearch/agent-runtime:555e403@sha256:6917619aeb7cc03a93df29c0bbff38ef6e93d5314c3cd162a0123e7bb1390b52, also tagged :v0.3.0 (same digest). The image is not published (#40).
Pinning it on a Lake is a separate change to the operator's defaults or the Lake's resource.
Verification
| Proof | Result |
|---|---|
Test suite (uv run --frozen --group dev pytest -q -ra, macOS arm64, Python 3.12) |
149 tests: 148 passed, 1 failed (#41, fails alone too), 0 skipped. tests/test_dataset_work_area.py 45, tests/test_skills.py 31, tests/test_runtime.py 25, tests/test_service_auth.py 13, tests/test_conversations.py 9 (new), tests/test_turn_destinations.py 9, tests/test_bus_backpressure.py 6 (new), tests/test_lake_bus.py 4 (1 failed), tests/test_mcp.py 4, tests/test_release.py 3 |
Skills contract (tests/test_skills.py, in the suite) |
Passed: every capability in the vendored Lake OpenAPI is accounted for; skills.json matches skills.py |
| Version | pyproject.toml and uv.lock 0.3.0; importlib.metadata.version("agent-runtime") and GET /healthz report it (tests/test_release.py) |
SPDX headers (python3 tools/spdx-headers.py --check) |
Passed |
SBOM (python3 tools/sbom.py --check) |
Passed, regenerated for v0.3.0 |
| Live agent runs (a model through Lake's gateway) | Not run for this release (needs a live model) |
| Dev environment | Not run (above) |
| Linux image build (BuildKit, from the tag) | Built from v0.3.0: oramasearch/agent-runtime:555e403, also :v0.3.0, sha256:6917619aeb7cc03a93df29c0bbff38ef6e93d5314c3cd162a0123e7bb1390b52 |