Repository navigation
Release v0.3.0
Released 2026-11-16. A minor release. One image, docker.io/oramasearch/agent-creator:v0.3.0, built on agent-runtime v0.3.0.
Since v0.2.0: the MIT licence, a security policy and the tree prepared for a public export. Underneath, the agent-runtime it runs on bounds its bus consumer and conversation memory and pins its base images by digest. The definition itself (prompt, the rule checks in defects, the turn answer, and how Lake reaches it) is unchanged from v0.2.0.
This release is the tree of dev after #27 (597250b), with these notes and the version.
What it includes
Every pull request merged into dev since the tag v0.2.0 (git log --first-parent v0.2.0..origin/dev):
| PR | What it does |
|---|---|
| #19 | Merges main back into dev after the v0.2.0 release; nothing new |
| #20 | Records the v0.2.0 image digest in the v0.2.0 notes; documentation only |
| #23 | Adds a security policy, SECURITY.md: how to report a vulnerability privately, and what we commit to |
| #26 | Prepares the tree for a public export: internal links, names and wording removed from the README, the docs and the release notes |
| #27 | 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 — #27
agent-creator 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.
From agent-runtime v0.3.0, underneath
The image is FROM oramasearch/agent-runtime:${RUNTIME_TAG} built with RUNTIME_TAG=v0.3.0, so it carries every change in agent-runtime since its v0.2.0 (notes):
- the bus consumer claims a task only when a worker is free, at most
AGENT_BUS_WORKERS(default 4) at once andAGENT_BUS_TENANT_WORKERS(default one fewer) for one customer; - conversation memory is bounded (
AGENT_CONVERSATIONS,AGENT_CONVERSATION_TURNS,AGENT_CONVERSATION_BYTES,AGENT_CONVERSATIONS_BYTES,AGENT_CONVERSATION_IDLE_SECONDS), and a bus turn continues only the conversation itsprior_turnleft in the same account and workspace; - the runtime's base images are pinned by digest;
- the runtime's MIT licence and security policy.
The vendored copy of agent-runtime's skills (tests/fixtures/agent-runtime-skills.json) is the same as agent-runtime v0.3.0's skills.json.
Settings it needs
No setting is required. The seven optional settings agent-runtime v0.3.0 adds (above) have defaults. The definition reads no new setting.
Not included
- Bounded workspace facts, sent to the model as untrusted data (#24): deferred for review.
- The agent-runtime base named by tag and digest (#25): deferred for review. The Dockerfile still names the runtime by
RUNTIME_TAGalone.
Known issues
Security-relevant first.
- Build logs and App events go unbounded into the system prompt and can steer the proposal (#22). The fix is #24, not in this release.
- The runtime writes every turn's trace to the shared pod's disk (agent-runtime#38): one AgentCreator pod serves every tenant, so every tenant's turn content stays under
TRACE_DIR. - The image bundles GPL and LGPL code (#28): it is built on agent-runtime's
python:3.12-slimbase (Debian: glibc, bash, coreutils, dpkg, readline), so the image is not published. It moves with agent-runtime toscratchwith static binaries before it is. - The runtime base is named by tag only (#25, deferred): a later build of the same tree could get a different runtime if the tag moved.
- Workspace identity is not passed explicitly on every call (#9, with agent-runtime#6): App and build reads carry only
customer_id. - The structured answer is shipped, the issue is still open (#1), for Lake's side to read
result.
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 AgentCreator image; moving it to :v0.3.0 is a separate operator change.
The image
Built from the tag v0.3.0 (62d8260) with BuildKit (linux/amd64, the repository's Dockerfile, on oramasearch/agent-runtime:v0.3.0@sha256:6917619aeb7cc03a93df29c0bbff38ef6e93d5314c3cd162a0123e7bb1390b52 with RUNTIME_TAG=v0.3.0), then tagged :v0.3.0 on that digest without rebuilding:
docker.io/oramasearch/agent-creator:62d8260-0@sha256:d0e4bd43ff7d31cdd2f0fe6b920cf7dc870364f9b0bcdc87b94d1151ab1515a0, also tagged :v0.3.0 (same digest). The image is not published (#28).
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 -p 3.12 --group dev pytest -q -ra, macOS arm64, Python 3.12) |
29 passed, 0 failed, 0 skipped: tests/test_creator.py 25, tests/test_grants.py 3, tests/test_release.py 1 (reads the version from pyproject.toml and requires these notes and their index line) |
| Skills fixture | tests/fixtures/agent-runtime-skills.json is byte for byte agent-runtime v0.3.0's skills.json |
SPDX headers (python3 tools/spdx-headers.py --check) |
Passed |
SBOM (python3 tools/sbom.py --check) |
Passed, regenerated for v0.3.0 |
| Offline evals | None: every eval case runs against a live workspace |
Live evals (evals/run.py) |
Not run (needs a live model and a live workspace) |
| Dev environment | Not run (above) |
| Linux image build (BuildKit, from the tag) | Built from v0.3.0 on agent-runtime v0.3.0: oramasearch/agent-creator:62d8260-0, also :v0.3.0, sha256:d0e4bd43ff7d31cdd2f0fe6b920cf7dc870364f9b0bcdc87b94d1151ab1515a0 |