Skip to content

Release v0.2.1

Choose a tag to compare

@homer6 homer6 released this 26 Oct 03:02
· 67 commits to main since this release
9301750

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_builds and build_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.toml keeps 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
    on main in one commit_repository_files (each write a liquid drip attributed to the person), sets
    APP_DEPS and 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.kind comes from the body's kind; list_builds and get_auto_fix join the read set. New
    prompt prompts/repair-v1.md; the design prompt is still v1.

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_turn is not read;
  • no explicit workspace_id on 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.

  1. Library agents hold live task credentials for every tenant they serve
    (lake#871).
  2. The bus consumer claims tasks into an unbounded queue before a worker is free
    (#33, LSR-075).
  3. Conversation histories are unbounded
    (#34, LSR-076).
  4. A confirmed turn cannot create an App with a Lake secret reference
    (lake#891).
  5. 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.
  6. Repair and change turns are proven with scripted model answers only
    (#41), and have not run against a live
    Lake carrying lake#1218.
  7. App logs may be unavailable (lake#1206); a
    repair then works from events, build logs and source.
  8. A repository with the same name in another workspace makes the deploy fail with a conflict
    (#18).
  9. 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)