Repository navigation
Release v0.3.0
Released 2026-11-16. A minor release. The agent's licence and open-source preparation, the bus consumer bounded so a task is claimed only when a worker is free, and the image's bases pinned by digest, since v0.2.0. The bounded bus changes behaviour a caller can see and adds settings, which is why this is a minor release and not a patch. Image: docker.io/oramasearch/agent-autosuggest:v0.3.0.
This release is the tree of dev after #35 (24121d0), with these notes and the version (#38).
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 |
|---|---|
| #28 | Merges main back into dev after the v0.2.0 release; nothing new |
| #29 | Records the v0.2.0 image digest in the v0.2.0 notes; documentation only |
| #32 | Adds a security policy, SECURITY.md: how to report a vulnerability privately, and what we commit to |
| #33 | 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 |
| #31 | Claims a bus task only when a worker is free to run it, and limits one customer's share of the workers |
| #36 | 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) |
| #35 | Prepares the tree for a public export: internal links, names and wording removed from the README, the docs and the release notes |
The licence — #36
agent-autosuggest 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 runtime 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 — #32
SECURITY.md says how to report a vulnerability privately and what we commit to in reply.
A bus task is claimed only when a worker is free — #31
- Nothing is received while every worker is busy, so claimed tasks (and their credentials) no longer pile up in memory, and a task this replica cannot run stays unclaimed 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), and a freed worker goes to the waiting customer holding the fewest, so one tenant's burst cannot take every worker.- At most 256 dispatch rows wait, never a claimed body. The receive uses the long poll's
wait_ms.
The image's bases are pinned by digest — #33
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 — #35
Links to issues and pull requests, internal names, local paths and wording are removed from the README, the docs and the earlier release notes. The agent files (AGENTS.md) ship with the repository.
Behaviour changes to know before it rolls
- The bus consumer runs at most
AGENT_BUS_WORKERSturns at once and leaves the rest on the bus, unclaimed. - One customer holds at most
AGENT_BUS_TENANT_WORKERSworkers while others wait.
Settings it needs
No setting is required. Two optional settings are new, each with the default above: AGENT_BUS_WORKERS and AGENT_BUS_TENANT_WORKERS. 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 (#34, for lake#871): deferred for review, not in this release.
- Unchanged from v0.2.0 otherwise, except that bus back-pressure is now included.
Known issues
Security-relevant first.
- The image bundles GPL and LGPL code (#37): 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. - Library agents hold live task credentials for every tenant they serve: one shared pod runs every tenant's turns with their task credentials.
- The workspace is not passed explicitly (#11): the agent sends only
customer_idon its reads, never the task'sworkspace_id. - The lease is kept by activity only. Lake renews a claim's lease on every capability call made with the task credential, so a turn is reclaimed only if one step outlasts
lease_seconds. Not observed. - The command line validates without workspace evidence (#14).
- Corpus drafts fail validation: the corpus's examples do not choose a registry level for S-1. The image keeps the
a882954corpus.
Closed since v0.2.0: #23 (the bus claimed tasks before a worker was free), by #31.
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 image; moving it to :v0.3.0 is a separate operator change.
The image
Built from the tag v0.3.0 with BuildKit (linux/amd64, the repository's Dockerfile, with the catalog context catalog-cf20d264 and the corpus context agent-autosuggest-corpus-a882954), then tagged :v0.3.0 on that digest without rebuilding:
docker.io/oramasearch/agent-autosuggest:9d38f4e@sha256:865cb6d404a05b3a8e0597cf9e2973865862dddd6f72e323a1e79c4b4dcd47f8, 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, on the release branch) |
78 tests: 78 passed, 0 failed, 0 skipped. test_service.py 17, test_turn_destinations.py 15, test_service_auth.py 13, test_lake_1153_shapes.py 7, test_bus_backpressure.py 6 (new), test_solution_evals.py 5, test_lake_bus.py 4, test_apps.py 3, test_solutions.py 3, test_app_evals.py 2, test_release.py 2, test_catalog.py 1 |
| Offline evals (no model) | evals/runtime-solutions.jsonl and evals/data-apps.jsonl, run through enforcement and validation inside the suite above; all pass |
| Version | pyproject.toml and uv.lock 0.3.0; the installed package reports it and these notes exist and are indexed (tests/test_release.py) |
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-model evals | Not run (needs a live model) |
| Dev environment | Not run (above) |
| Linux image build (BuildKit, from the tag) | Built from v0.3.0 (9d38f4e): oramasearch/agent-autosuggest:9d38f4e, also :v0.3.0, sha256:865cb6d404a05b3a8e0597cf9e2973865862dddd6f72e323a1e79c4b4dcd47f8 |