Repository navigation
Release v0.2.1
agent-application v0.2.1
Released 2026-10-25. A patch release. One change since v0.2.0: the Application Agent
can repair an App that failed and change an existing App from more instructions, always as a
diff the person confirms, plus Lake's opt-in auto-fix (lake#1207). Private repository and image,
docker.io/oramasearch/agent-application:v0.2.1. Tracking issue:
#42.
It is a patch: the existing turns (design, confirm, deploy) and every setting are unchanged; the two
new turn kinds are only sent by a Lake that carries lake#1218.
This release is the tree of dev at 73efc06 with these notes, the version and the README's release
line.
How it works: repairing and changing an App,
building, confirming and deploying Apps, service and bus operation.
What it includes
Every pull request merged into dev since v0.2.0:
| PR | Change |
|---|---|
| #40 | repair and change turns on an existing App, with commits, a diff the person confirms, and opt-in auto-fix (lake#1207) |
| #39 | Records the v0.2.0 image digest in the v0.2.0 notes |
| #38 | Merges main back into dev after v0.2.0 |
Repair and change turns (#40)
- Reads the App's facts:
receive_app_events,app_logs(when logs are unavailable it says so,
lake#1206, and never gives missing logs as the
reason),list_buildsandbuild_logs, and every file under the App's folder, from the source Lake
recorded at the last deploy when the App runs a built image. - Proposes, writes nothing: the proposal is
{kind: proposal, confirm: true, turn, diagnosis, diff, files, delete, app}, holding only the changed files and a unified diff computed by the agent, not
the model. It is checked before it is shown: safe paths, the code compiles, no secret literal or
turn credential,app.tomlkeeps its name, framework and port, and at least one file changes. A
failed check goes back to the model, twice at most. - On confirm (
context.confirmed_proposal): refuses a proposal for another App, commits the files
onmainin onecommit_repository_files(each write a liquid drip attributed to the person), sets
APP_DEPSand builds when a package outside app-runtime's baked set is now needed, deploys the new
revision or image, follows the rollout and reports. - Auto-fix (
context.auto_fix: {attempt, max_attempts}, granted by Lake only when the person opted
in): applies its own proposal, names the attempt, and writes nothing when it finds no fix. Turn.kindcomes from the body'skind;list_buildsandget_auto_fixjoin the read set. New
promptprompts/repair-v1.md; the design prompt is stillv1.
Settings it needs
No new setting. The settings of v0.2.0 still apply
(AGENT_SERVICE_TOKEN and LAKE_URL required, AGENT_MODEL read, all rendered by the operator).
The new turns need the Lake that sends them, grants their tools and holds the auto-fix gate:
lake#1218, merged into lake's dev on 2026-10-25 and
not in a lake release yet (lake v0.7.0 does not have it). An older Lake never sends repair or
change.
What it does not include
Unchanged from v0.2.0:
- no conversation memory that survives the process;
prior_turnis not read; - no explicit
workspace_idon its calls; - no creating secrets;
- no frameworks beyond FastAPI, Streamlit and static sites;
- no idle backoff on the bus;
- no live eval result, and no eval cases yet for repair and change turns
(#41).
Known issues
Security-relevant first. All open at this tag.
- Library agents hold live task credentials for every tenant they serve
(lake#871). - The bus consumer claims tasks into an unbounded queue before a worker is free
(#33, LSR-075). - Conversation histories are unbounded
(#34, LSR-076). - A confirmed turn cannot create an App with a Lake secret reference
(lake#891). - Confirmation gates do not establish a separate human confirmer
(lake#989, LSR-183, low). Auto-fix applies its own
proposal without a confirm, by design, only when the person opted in on Lake. - Repair and change turns are proven with scripted model answers only
(#41), and have not run against a live
Lake carrying lake#1218. - App logs may be unavailable (lake#1206); a
repair then works from events, build logs and source. - A repository with the same name in another workspace makes the deploy fail with a conflict
(#18). - No explicit workspace IDs, and no idle backoff on the bus
(#3).
Where it has run
The v0.2.1 tree has not run on the dev environment. At this tag the dev member of
lake-nonprod pins oramasearch/agent-application:32caa4c (the v0.2.0 tree); no build of #40 has
been pinned there. Steve asked for the release on 2026-10-25 ("merge it all, cut releases, push all
to nonprod"), together with lake#1218.
The image
Built from the tag v0.2.1 (9301750) on the cluster BuildKit with build-agent.sh (linux/amd64, the
repository's Dockerfile), then tagged :v0.2.1 on that digest without rebuilding:
docker.io/oramasearch/agent-application:9301750@sha256:ff5740591a5b2e056b7fa8b2519f7901a8ad01baf5839a351db4f8f2939e5e4c, also tagged :v0.2.1 (same digest). The Docker Hub
repository answers 404 anonymously (private).
It is not rolled anywhere yet: pinning it on an environment is a separate change to the operator's set
files, through dev, testing, staging and prod in order.
Verification
| Proof | Result |
|---|---|
Test suite (uv run --frozen pytest -q -ra, macOS arm64, Python 3.12.11, release branch) |
72 tests: 72 passed, 0 failed, 0 skipped. test_agent.py 21, test_service_auth.py 13, test_repair.py 10 (new, #40), test_turn_destinations.py 10, test_service.py 7 (one new: the service passes the turn kind), test_release.py 3 (the installed package is 0.2.1, these notes exist and are indexed), test_evals.py 3, test_generated_apps.py 3, test_lake_bus.py 2 |
| Release test | tests/test_release.py reads the version from pyproject.toml and the installed package, and fails when docs/releases/v<version>.md or its index line is missing |
Live model evals (application-agent-evals) |
Not run (needs a live model; no repair or change cases yet, #41) |
| Linux image build (cluster BuildKit, from the tag) | Built from v0.2.1 with build-agent.sh: oramasearch/agent-application:9301750, also :v0.2.1, sha256:ff5740591a5b2e056b7fa8b2519f7901a8ad01baf5839a351db4f8f2939e5e4c; private (404 anonymously) |