Repository navigation
Released 2026-11-16. A minor release. Since v0.2.0: bus back-pressure (a task is claimed only when a worker is free, with a per-customer limit), the licence, the security policy, base images pinned by digest and the public-tree cleanup. Image: docker.io/oramasearch/agent-project:v0.3.0, not published (see Known issues).
This release is the tree of dev with these notes and the version.
What it includes
Every pull request merged into dev since the v0.2.0 tag:
| PR | What it does |
|---|---|
| #45 | The public-tree cleanup (see below) |
| #46 | MIT LICENSE and COPYRIGHT (OramaSearch, Inc.), an SPDX-License-Identifier: MIT line in every source file (tools/spdx-headers.py), THIRD_PARTY_LICENSES, CONTRIBUTING.md, CLA.md, CODE_OF_CONDUCT.md, and the SBOM (sbom.spdx.json, sbom.cdx.json, tools/sbom.py) |
| #41 | Security: the bus consumer claims a task only when a worker is free, and one customer cannot take every worker |
| #43 | The Dockerfile names its base images by digest as well as by tag (python:3.12-slim, ghcr.io/astral-sh/uv:0.11.7), so a later build of the same source gets the same base |
| #42 | SECURITY.md: how to report a vulnerability |
| #39 | Records the v0.2.0 image digest in the v0.2.0 notes (documentation only) |
| #38 | The v0.2.0 release promotion (dev → main), merged back into dev |
A bus task is claimed only when a worker is free — #41
- Every received task used to be claimed and queued, so one tenant's burst held claimed tasks (with their credentials) in memory and starved the others (#33).
lake_bus.worknow claims only when a worker slot is free and receives nothing while all are busy.AGENT_BUS_WORKERS(default 4) sets the slots andAGENT_BUS_TENANT_WORKERS(default one fewer) caps one customer; at most 256 dispatch rows wait.receivepasses the long poll'swait_ms.- Both settings are optional; their defaults apply when unset, so no operator change has to roll first.
The public-tree cleanup — #45
Nothing internal is left in the files that will be published: .public-exclude was added and then removed again once the agent files were rewritten to ship publicly; issue links became plain text, the image section shows a docker buildx build with the two named contexts, the release notes name no environment, and the package author is Orama Search Inc..
The licence — #46
Everything in this repository that Orama wrote is under the MIT licence. Contributors sign CLA.md once. THIRD_PARTY_LICENSES lists every runtime dependency with its licence text; none is incompatible with MIT distribution.
Before it rolls: the settings it needs
Nothing required. AGENT_BUS_WORKERS and AGENT_BUS_TENANT_WORKERS (#41) are optional, with defaults. The other variables are unchanged from v0.2.0.
What it does not include
Deferred, not in this release:
- #44: claiming bus tasks by reference and naming the task on every call; it needs the matching Lake change.
Otherwise unchanged from v0.2.0.
Known issues
Security-relevant first. All open at this tag.
- #47 (release blocker for publishing): the image is built on
python:3.12-slim, which bundles GPL and LGPL userland, so the image is not published. It is built and kept in the project's non-public Docker Hub repository until it moves to a scratch base with static binaries. - #34: turn traces keep workspace content on the pod's disk (
TRACE_DIR), outside the workspace Zetta. - #17: the task's workspace is not passed explicitly on data-plane calls and delegated turns. Lake scopes the task credential to the task's workspace.
- #28: the analysis fallback does not read
get_dataset's typed columns. - #27: designing does not detect class imbalance or report imbalanced runs by PR-AUC and lift.
- The catalogue build context is produced outside this repository; a public user needs a published catalogue to build the image.
Where it has run
The v0.3.0 tree had not run on a development environment when it was released. Lakes run the operator's default image of this agent; the changes since v0.2.0 are proven by the test suite only. Moving a Lake to :v0.3.0 is a separate operator change.
The image
Built from the tag v0.3.0 (2dcb97e) with BuildKit (linux/amd64, the repository's Dockerfile, with the catalog context catalog-cf20d264 (the same as v0.2.0) and the corpus context from agent-project-corpus v0.3.0's corpus/), then tagged :v0.3.0 on that digest without rebuilding:
docker.io/oramasearch/agent-project:2dcb97e@sha256:c85d9a5906bb57f948bcc15bf1be7fd0c6be21976bafed408dbc755a54f5a3aa, also tagged :v0.3.0 (same digest).
It is pushed only to the project's non-public Docker Hub repository, which answers 404 anonymously. Pinning it on a Lake is a separate change.
Verification
| Proof | Result |
|---|---|
Test suite (uv run --frozen pytest -q -ra, macOS arm64, Python 3.12, release branch) |
97 passed, 0 failed, 0 skipped; 97 tests. Includes tests/test_release.py (the declared version has these notes, indexed) |
SPDX headers (python3 tools/spdx-headers.py --check) |
Every source file carries the header |
SBOM (python3 tools/sbom.py --version v0.3.0, then --check) |
Regenerated on the release commit; --check passes |
| Batch generation, and a live turn through Lake's model gateway | Not run (needs a live model and a Lake) |
| Linux image build (BuildKit, linux/amd64, from the tag) | Built from v0.3.0: oramasearch/agent-project:2dcb97e, also :v0.3.0, sha256:c85d9a5906bb57f948bcc15bf1be7fd0c6be21976bafed408dbc755a54f5a3aa |