Skip to content

Release v0.3.0

Latest

Choose a tag to compare

@homer6 homer6 released this 16 Nov 07:25
cc43317

Released 2026-11-16. A minor release. The agent's licence and open-source preparation, the image's bases pinned by digest, and the engine-issue link in refusals made a setting, since v0.2.1. Refusals no longer link to a tracker unless one is configured, a change a person can see, which is why this is a minor release and not a patch. Image: docker.io/oramasearch/agent-ask-orama:v0.3.0.

This release is the tree of dev after #66 (50a3a4c), with these notes, the version and the README's release line. The prompt is still v17.

What changed

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

PR What it does
#60 Merges main back into dev after the v0.2.1 release; nothing new
#61 Records the v0.2.1 image digest in the v0.2.1 notes; documentation only
#63 Adds a security policy, SECURITY.md: how to report a vulnerability privately, and what we commit to
#64 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
#67 Prepares the tree for a public export: the engine-issue link in refusals becomes the ZETTA_ISSUE_URL setting, the reports of an earlier live eval run are removed, and internal links, names and wording are removed from the README, the docs and the release notes
#66 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)

The licence — #66

agent-ask-orama 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 — #63

SECURITY.md says how to report a vulnerability privately and what we commit to in reply.

The engine-issue link is a setting — #67

When Ask Orama says a methodology is not supported yet, it names the engine issue that tracks it (zetta#N). The link to that issue now comes from ZETTA_ISSUE_URL, a template with {n} for the number (for example https://github.com/<owner>/zetta/issues/{n}). Unset, the issue is named without a link, so an install never points people at a tracker it was not given. Prompt v17's one line that carried a fixed tracker address reads the same way; v14 to v16 stay as they were, for trace history.

The eval reports of an earlier live run are removed from reports/; its README says how a report is produced.

The image's bases are pinned by digest — #64

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.

Before it rolls: settings

No setting is required. One optional setting is new: ZETTA_ISSUE_URL (above). The settings of v0.2.0 still apply (AGENT_SERVICE_TOKEN and LAKE_URL required, both rendered by the operator). git diff v0.2.1..v0.3.0 -- src adds no other environment read.

Not included

  • Claiming tasks by reference and naming the task on every call (#65, for lake#871): deferred for review, not in this release.
  • No conversation memory across restarts (conversations are in memory, bounded).
  • No explicit workspace ids on data-plane calls, and no idle backoff on the bus.
  • No live eval results for prompts v12 to v17, and no live methodology_draft eval.

Known issues

Security-relevant first. All open at this tag.

  1. The image bundles GPL and LGPL code (#68): 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.
  2. The eval grader passes a reply that names no issue when ZETTA_ISSUE_URL is unset (#69): the grader accepts the issue's name or its link, and with no link configured the empty link matches every reply. One test fails on it: tests/test_agent.py::test_evals_are_generated_from_the_index_and_graded_by_rules.
  3. #12: no explicit workspace_id on data-plane calls and delegations, and no idle backoff on the bus.
  4. #27: the draft's lock hashes are read from pypi.org, not confirmed reachable from the pod, and no live methodology_draft eval.
  5. #25, #23: the live evals have not run on v12 to v17, nor the count evals.
  6. lake#1191: outside the Quickstart, Ask Orama cannot find "the last-uploaded dataset", because list_datasets has no upload time.
  7. #3: models are listed by project id instead of project name.

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 (cc43317) with BuildKit (linux/amd64, the repository's Dockerfile), then tagged :v0.3.0 on that digest without rebuilding:

docker.io/oramasearch/agent-ask-orama:cc43317@sha256:937e30a4280cb6a86110c031f84ee7ca1048475ea19b373c7192e2feb083783f, 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, release branch) 146 tests: 145 passed, 1 failed (#69, fails alone too), 0 skipped. tests/test_agent.py 78 (1 failed), tests/test_turn_destinations.py 16, tests/test_conversations.py 13, tests/test_service_auth.py 13, tests/test_methodology_draft.py 7, tests/test_bus_backpressure.py 6, tests/test_conversation_owner.py 5, tests/test_lake_bus.py 5, tests/test_release.py 3 (the installed package is 0.3.0, these notes exist and are indexed, /healthz reports it with prompt v17)
Offline evals Run inside the test suite (a fake Lake and a scripted model); counted above
Live evals (ask-orama-evals) Not run (they need a live model and a person's Lake key)
Version pyproject.toml and uv.lock 0.3.0 (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
Dev environment Not run (above)
Linux image build (BuildKit, from the tag) Built from v0.3.0: oramasearch/agent-ask-orama:cc43317, also :v0.3.0, sha256:937e30a4280cb6a86110c031f84ee7ca1048475ea19b373c7192e2feb083783f