Repository navigation
Release v0.3.0
Released 2026-11-16. A minor release. The agent's licence and open-source preparation, the bus consumer and conversation memory bounded, and the image's bases pinned by digest, since v0.2.7. 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-application:v0.3.0.
This release is the tree of dev after #75 (c9cc363), with these notes and the version.
What changed
Every pull request merged into dev since v0.2.7 (git log --first-parent v0.2.7..origin/dev):
| PR | What it does |
|---|---|
| #72 | Adds a security policy, SECURITY.md: how to report a vulnerability privately, and what we commit to |
| #73 | 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 |
| #70 | The bus consumer claims a task only when a worker is free, and one customer can no longer take every worker |
| #76 | 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) |
| #71 | Bounds the conversation memory, and keys a bus turn's conversation by the account and workspace Lake names |
| #75 | Prepares the tree for a public export: internal links, names and wording removed from the README, the docs and the release notes |
The licence — #76
agent-application 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 — #72
SECURITY.md says how to report a vulnerability privately and what we commit to in reply.
The bus consumer claims only what it can run — #70
A task is claimed 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 wait 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 most AGENT_BUS_TENANT_WORKERS (default one fewer), so one tenant's burst cannot take every worker.
The conversation memory is bounded, and keyed by Lake's claim — #71
- 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. - Every bus turn carries Lake's claim (task, account, workspace). A bus turn's conversation is keyed by the account and workspace of the claim plus its
conversation_id, so a conversation id named in another tenant's turn reaches nothing. A directPOST /v1/turnkeeps its own key in a separate namespace. Seeding from thehistoryLake sends works as before. A turn that raises is rolled back.
The image's bases are pinned by digest — #73
Each FROM and COPY --from names the multi-platform index digest its tag pointed to. See known issue 3: a merge left an unpinned build stage beside the pinned one.
Prepared for a public export — #75
Links to issues and pull requests, internal names and wording are removed from the README, the docs and the earlier release notes.
Behaviour changes to know before it rolls
- A bus turn's conversation is scoped to the account and workspace of Lake's claim. The same
conversation_idin another account or workspace is another conversation. - 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.7..v0.3.0 -- src adds no other environment read.
Not included
- Claiming tasks by reference and naming the task on every call (#74, for lake#871): deferred for review, not in this release.
Known issues
Security-relevant first.
- Library agents hold live task credentials for every tenant they serve: one shared process claims tasks for every person, each with a credential that acts as that person. A design issue on Lake's side.
- The image bundles GPL and LGPL code (#77): 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. - The Dockerfile has two stages named
build(#78): a merge kept the pre-pin stage, which uses the bases by tag only and is the one that builds the venv, beside the pinned one. The digest pins of #73 do not yet hold for the build stage. - Confirmation gates do not establish a separate human confirmer (lake#989, low).
ensure_repositorydoes not match and create repositories in the turn's workspace (#18): a repository with the same name in another workspace makes the deploy fail with a conflict.- No explicit workspace IDs on data-plane calls (#3), and no idle backoff on the bus.
- Generated Apps may still select whole tables (#51) where they should aggregate in SQL and page row-level reads.
- No evals for repair and change turns (#41).
Where it has run
The v0.3.0 tree had not run on a development environment when it was released. Moving a Lake to :v0.3.0 is a separate change to the operator's defaults or the Lake's resource.
The image
Built from the tag v0.3.0 (c8d1645) with BuildKit (linux/amd64, the repository's Dockerfile), then tagged :v0.3.0 on that digest without rebuilding:
docker.io/oramasearch/agent-application:c8d1645@sha256:91fb836f22e6c0a9185984d4dd4b20e4e0ea16073e3847410a7cdcbf3061369c, also tagged :v0.3.0 (same digest).
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) |
102 passed, 0 failed, 0 skipped: tests/test_agent.py 23, tests/test_service_auth.py 13, tests/test_repair.py 10, tests/test_turn_destinations.py 10, tests/test_conversations.py 9 (new), tests/test_generated_apps.py 9, tests/test_service.py 8, tests/test_bus_backpressure.py 6 (new), tests/test_evals.py 4, tests/test_repository_file_bytes.py 4, tests/test_release.py 3, tests/test_lake_bus.py 2, tests/test_repository_paths.py 1 |
| Version | pyproject.toml and uv.lock 0.3.0; importlib.metadata.version("agent-application") reports it (tests/test_release.py), and GET /healthz returns that value |
SPDX headers (python3 tools/spdx-headers.py --check) |
Passed |
SBOM (python3 tools/sbom.py --version v0.3.0 --check) |
Passed, regenerated for v0.3.0 |
| Live evals (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-application:c8d1645, also :v0.3.0, sha256:91fb836f22e6c0a9185984d4dd4b20e4e0ea16073e3847410a7cdcbf3061369c |