Skip to content

Release v0.3.1

Latest

Choose a tag to compare

@homer6 homer6 released this 16 Nov 08:31
a256372

Released 2026-11-16. A patch release. The Dockerfile has one build stage again, pinned by digest, since v0.3.0. It fixes v0.3.0's known issue 3 (#78). Nothing the agent does has changed. Image: docker.io/oramasearch/agent-application:v0.3.1.

This release is the tree of dev after #82 (7a85b94), with these notes and the version.

What changed

Every pull request merged into dev since v0.3.0 (git log --first-parent v0.3.0..origin/dev):

PR What it does
#81 Records the v0.3.0 image digest in the v0.3.0 notes; documentation only
#82 One digest-pinned build stage: the unpinned stage a merge had left beside it is removed, so the venv is built on the pinned bases. Fixes #78

One build stage, pinned by digest — #82

In v0.3.0 the Dockerfile had two stages named build. The second, which builds the venv, named python:3.12-slim and ghcr.io/astral-sh/uv:0.11.7 by tag only, so the digest pins did not hold for it. Now there is one build stage, and every FROM and COPY --from names the multi-platform index digest of its tag. The bases are the same digests v0.3.0 pinned. The comments in the Dockerfile header no longer reference internal issues.

No source file under src/ changed, and no setting is new or removed (git diff v0.3.0..v0.3.1 -- src is empty).

Not included

  • Claiming tasks by reference and naming the task on every call (#74): deferred for review, not in this release.

Known issues

Security-relevant first.

  1. 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.
  2. The image bundles GPL and LGPL code (#77): it is built on python:3.12-slim (Debian: glibc, bash, coreutils, dpkg, readline). The move to scratch with static binaries is deferred; it is noted here and does not block this release.
  3. Confirmation gates do not establish a separate human confirmer (on Lake's side, low).
  4. ensure_repository does 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.
  5. No explicit workspace IDs on data-plane calls (#3), and no idle backoff on the bus.
  6. Generated Apps may still select whole tables (#51) where they should aggregate in SQL and page row-level reads.
  7. No evals for repair and change turns (#41).

v0.3.0's known issue 3, the two build stages (#78), is fixed by #82.

Where it has run

The v0.3.1 tree had not run on a development environment when it was released. Moving a Lake to :v0.3.1 is a separate change to the operator's defaults or the Lake's resource.

The image

Built from the tag v0.3.1 (a256372) with BuildKit (linux/amd64, the repository's Dockerfile), then tagged :v0.3.1 on that digest without rebuilding:

docker.io/oramasearch/agent-application:a256372@sha256:e87d1ec1df245e0b2f8bb23e6dd164fb0b18a46f0c24ef95a41303f03a1de3a4, also tagged :v0.3.1 (same digest). The image is published on Docker Hub; its GPL/LGPL base is a known issue (#77).

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, tests/test_generated_apps.py 9, tests/test_service.py 8, tests/test_bus_backpressure.py 6, 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.1; 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.1 --check) Passed, regenerated for v0.3.1
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.1: oramasearch/agent-application:a256372, also :v0.3.1, sha256:e87d1ec1df245e0b2f8bb23e6dd164fb0b18a46f0c24ef95a41303f03a1de3a4