Skip to content

Release v0.3.0

Latest

Choose a tag to compare

@homer6 homer6 released this 16 Nov 07:29
3f83347

Released 2026-11-16. A minor release. Since v0.2.2: conversation history bound to its workspace and bounded, the licence, the security policy, base images pinned by digest and the public-tree cleanup. Image: docker.io/oramasearch/agent-experiments:v0.3.0, not published (see Known issues).

This release is the tree of dev with these notes and the version.

What it includes

Every pull request merged into dev since the v0.2.2 tag:

PR What it does
#41 The public-tree cleanup (see below)
#40 MIT LICENSE and COPYRIGHT (OramaSearch, Inc.), an SPDX-License-Identifier: MIT line in every source file (tools/spdx-headers.py), THIRD_PARTY_LICENSES, CONTRIBUTING.md, CLA.md, CODE_OF_CONDUCT.md, and the SBOM (sbom.spdx.json, sbom.cdx.json, tools/sbom.py)
#37 Security: conversation history is kept per workspace and bounded
#38 The Dockerfile names its base images by digest as well as by tag (python:3.12-slim, ghcr.io/astral-sh/uv:0.11.7), so a later build of the same source gets the same base
#36 SECURITY.md: how to report a vulnerability

Conversation history is bound to its workspace, and bounded — #37

  • The pod serves every workspace and looked history up by conversation id alone, so another workspace that knew the id could read or write into it, and new ids grew memory without limit (#35).
  • New conversations.py: history is keyed by customer, the checked workspace path (lake_url), workspace_id and user_id when the turn has them, and the conversation id. The store holds at most 256 conversations (least recently used dropped first), expires a conversation idle for an hour, and keeps each history to its system prompt plus at most 60 messages and 200,000 characters, dropping the oldest whole exchanges so a tool reply never loses its call.
  • run_turn works on a copy of the history and stores it back whole under the lock.

The public-tree cleanup — #41

Nothing internal is left in the files that will be published: .public-exclude was added and then removed again once the agent files were rewritten to ship publicly; issue links became plain text, the release notes name no environment, and "private" wording about the repository and its image is gone. Documentation and one Dockerfile comment only.

The licence — #40

Everything in this repository that Orama wrote is under the MIT licence. Contributors sign CLA.md once. THIRD_PARTY_LICENSES lists every runtime dependency with its licence text; none is incompatible with MIT distribution.

Before it rolls: the settings it needs

Nothing new. The variables are unchanged from v0.2.2.

What it does not include

Deferred, not in this release:

  • #39: claiming bus tasks by reference and naming the task on every call; it needs the matching Lake change.

Otherwise unchanged from v0.2.2.

Known issues

Security-relevant first. All open at this tag.

  1. #42 (release blocker for publishing): the image is built on python:3.12-slim, which bundles GPL and LGPL userland, so the image is not published. It is built and kept in the project's non-public Docker Hub repository until it moves to a scratch base with static binaries.
  2. #3: the task's workspace is not passed explicitly on data-plane calls. Lake scopes the task credential to the task's workspace.
  3. #33: in an end-to-end run against lake v0.8.1 the final turn did not explain the experiment (empty answer).
  4. #20: the agent reads EXPERIMENTS_AGENT_MODEL and not the operator's AGENT_MODEL.

Where it has run

The v0.3.0 tree had not run on a development environment when it was released. Lakes run the operator's default image of this agent; the changes since v0.2.2 are proven by the test suite only. Moving a Lake to :v0.3.0 is a separate operator change.

The image

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

docker.io/oramasearch/agent-experiments:3f83347@sha256:5d2290ba06fe0a60b04f9e6f28834da73b1ee3474c93e4af6fef45a9f899ec41, also tagged :v0.3.0 (same digest).

It is pushed only to the project's non-public Docker Hub repository, which answers 404 anonymously. Pinning it on a Lake is a separate change.

Verification

Proof Result
Test suite (uv run --frozen pytest -q -ra, macOS arm64, Python 3.12, release branch) 67 passed, 0 failed, 0 skipped; 67 tests. Includes tests/test_release.py (the declared version has these notes, indexed)
SPDX headers (python3 tools/spdx-headers.py --check) Every source file carries the header
SBOM (python3 tools/sbom.py --version v0.3.0, then --check) Regenerated on the release commit; --check passes
Batch generation, and a live turn through Lake's model gateway Not run (needs a live model and a Lake)
Linux image build (BuildKit, linux/amd64, from the tag) Built from v0.3.0: oramasearch/agent-experiments:3f83347, also :v0.3.0, sha256:5d2290ba06fe0a60b04f9e6f28834da73b1ee3474c93e4af6fef45a9f899ec41