Repository navigation
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_drafteval.
Known issues
Security-relevant first. All open at this tag.
- 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 toscratchwith static binaries before it is. - The eval grader passes a reply that names no issue when
ZETTA_ISSUE_URLis 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. - #12: no explicit
workspace_idon data-plane calls and delegations, and no idle backoff on the bus. - #27: the draft's lock hashes are read from
pypi.org, not confirmed reachable from the pod, and no livemethodology_drafteval. - #25, #23: the live evals have not run on v12 to v17, nor the count evals.
- lake#1191: outside the Quickstart, Ask Orama cannot find "the last-uploaded dataset", because
list_datasetshas no upload time. - #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 |