Skip to content

Release v0.3.0

Choose a tag to compare

@homer6 homer6 released this 16 Nov 07:25
· 9 commits to main since this release
c8d1645

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_CONVERSATIONS conversations (default 256), each at most AGENT_CONVERSATION_TURNS turns (20) and AGENT_CONVERSATION_BYTES (1 MiB), all of them at most AGENT_CONVERSATIONS_BYTES (64 MiB); one idle for AGENT_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 direct POST /v1/turn keeps its own key in a separate namespace. Seeding from the history Lake 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

  1. A bus turn's conversation is scoped to the account and workspace of Lake's claim. The same conversation_id in another account or workspace is another conversation.
  2. Conversations are forgotten past the limits above, oldest or idle first.
  3. The bus consumer runs at most AGENT_BUS_WORKERS turns 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.

  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), so the image is not published. It moves to scratch with static binaries before it is.
  3. 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.
  4. Confirmation gates do not establish a separate human confirmer (lake#989, low).
  5. 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.
  6. No explicit workspace IDs on data-plane calls (#3), and no idle backoff on the bus.
  7. Generated Apps may still select whole tables (#51) where they should aggregate in SQL and page row-level reads.
  8. 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