[sonichi]

What changed, and why

Releases ag2-sparrow 0.6.1. It's a one-line __version__ bump from 0.6.1.dev1 to 0.6.1, the same shape as #5811 (0.6.0) and #5675 (0.5.4). The package keeps no CHANGELOG, and earlier bumps changed only __init__.py, so this one does too.

The owner approved this release. Two things need it:

• hold (fix(ag2-sparrow): a Hatch task parked for the owner's go posts one line and reports held, not stuck #5828). The backend's served Hatch setup list (on its dev branch) already requires ag2-sparrow>=0.6.1 because its worker_note tells workers to run hold.
• Hatch self-upgrade (feat(ag2-sparrow): Hatch self-upgrade to the served target_version, with an offline rollback #5676) and the served-setup fetch (feat(ag2-sparrow): Sparrow fetches its served setup from the broker when a heartbeat announces a new revision #5855). Neither is in 0.6.0, so a 0.6.0 install can't fetch a served setup or upgrade itself. 0.6.1 is the first version that can follow a served target_version. Getting from 0.6.0 to 0.6.1 is still a manual install.

User-visible changes since 0.6.0

From git log sparrow-v0.6.0..origin/main -- packages/ag2-sparrow:

Hatch

• fix(ag2-sparrow): a Hatch task parked for the owner's go posts one line and reports held, not stuck #5828: a Hatch task parked for the owner's go posts one line and reports held, not stuck (ag2-sparrow-hatch hold).
• feat(ag2-sparrow): Hatch self-upgrade to the served target_version, with an offline rollback #5676: Hatch self-upgrade to the served target_version, with an offline rollback. Its limits:
  • It stays dormant until the backend serves a target_version with its target_sha256.
  • On macOS a detached Sparrow that is running ends stop-failed, as the README says.
• feat(ag2-sparrow): Sparrow fetches its served setup from the broker when a heartbeat announces a new revision #5855: when a heartbeat announces a new setup_revision, Sparrow fetches its served setup from the broker's /v1/setup.
• feat(ag2-sparrow): serve the Hatch worker's wording from the backend, with a built-in fallback #5665: the Hatch worker's wording is served by the backend, with a built-in fallback.

Connectors

• feat(ag2-sparrow): ag2-sparrow-claude-local connect --base --code #5860: ag2-sparrow-claude-local connect --base --code.
• feat(ag2-sparrow): ag2-sparrow-codex-local hosts the Codex connector under the shared supervised-session lifecycle #5761: ag2-sparrow-codex-local runs the Codex connector under the shared supervised-session lifecycle.
• feat(connections): disconnect/reconnect keeping the token, known servers, agent identity on the row #5882, fix(connections): bound the vault writer lock and Keychain writes; remove clears the status sidecar #5889: connections can disconnect and reconnect while keeping the token. The vault writer lock and Keychain writes are bounded.

Seat bridges and sparrowd

• fix(sparrowd): run a declared seat bridge with the env wire_bridge computes, not a vault token #5893: a declared seat bridge runs with the environment wire_bridge computes, not a vault token.
• fix(ag2-sparrow): a seat bridge reads its own token file first and never connects as the core #5859: a seat bridge reads its own token file first and never connects as the core.
• fix(ag2-sparrow): sparrowd serves its control socket for any workspace path (#5787) #5858: sparrowd serves its control socket for any workspace path.
• fix(gateway-credentials): the owner checks, writes and removes the bridge declaration; sparrowd reads it through the owner #5815, fix(gateway-credentials): refuse credential-shaped gateway URLs, cap the declaration check, report an unlistable agents dir #5851: the owner checks, writes and removes the bridge declaration. Credential-shaped gateway URLs are refused.

Gateway and delivery

• fix(gateway): proactive sends go through the outbox; an uncertain send is parked, never resent #5857: proactive sends go through the outbox. An uncertain send is parked, never resent.
• fix(outbox): a corrupt item record reads parked with a send in doubt, never fresh #5867, fix(outbox): an impossible claim field reads UNKNOWN, never pid reuse #5830: a corrupt outbox record, or an impossible claim field, reads as parked or UNKNOWN, never as fresh.
• fix(gateway): a wedged-but-alive bridge exits so the supervisor can restart it #4564: a bridge that is wedged but alive exits, so its supervisor can restart it.
• fix(gateway): an owner-private message goes only to a room of the agent and its owner #5515: an owner-private message goes only to a room that holds just the agent and its owner.
• fix(egress): an internal recovery error never reaches a non-owner conversation #5807: an internal recovery error never reaches a non-owner conversation.
• fix(alerts): one usage-limit card per episode, with unblock steps; macOS pop-up only as DM fallback #5686: one usage-limit card per episode, with the steps that unblock it.

Other

• feat(dotspace): resolve DotSpace homeservers per connection instead of hardcoding ag2.space #5856: DotSpace homeservers are resolved per connection.
• Owner messages go unacknowledged while the core is busy or its watcher is down; make the live agent the status layer #5853 PRs 3 and 4 (feat(status-ack): live-agent runner, disabled by default (#5853 PR 3) #5864, feat(status-ack): host the loop, durable first-seen, safe restart; unpicked tasks only (#5853 PR 4) #5876): the status-ack loop. It is disabled by default.

Files to look at first

packages/ag2-sparrow/ag2_sparrow/__init__.py, the only change.

What this proves

N/A. This is a version bump. The publish workflow refuses a tag that differs from the packaged __version__, and refuses a version that already exists on PyPI.

Feature/documentation consistency

N/A. No behavior changes here. The README already documents every feature listed above.

Before/after evidence

$ python3 -c 'import ag2_sparrow; print(ag2_sparrow.__version__)'   # parent
0.6.1.dev1
$ python3 -c 'import ag2_sparrow; print(ag2_sparrow.__version__)'   # head
0.6.1

Tests

Run at head on macOS (python3 3.14):

• python3 packages/ag2-sparrow/tests/test_hatch_served_setup.py: Ran 226 tests, OK. This suite holds the self-upgrade decision tests. They pin installed= explicitly, so the bump doesn't change their outcome.
• python3 packages/ag2-sparrow/tests/test_hatch_adapter.py: Ran 415 tests, OK (skipped=2).
• bash scripts/review-checks.sh --diff <(git diff origin/main...HEAD): PASS.

Live path

N/A. Nothing runs until the tag is pushed and a host installs 0.6.1.

Release steps, after merge

git fetch origin main
git tag sparrow-v0.6.1 <merge-commit-sha>
git push origin sparrow-v0.6.1

publish-sparrow.yml then publishes to PyPI over OIDC and attaches the .pyz and linux binaries to the GitHub Release. Tagging needs the owner's word, which has been given for this release.

Deployment risks and follow-ups

• Self-upgrade stays dormant until the backend serves a target. The served Hatch list's package.target_version and target_sha256 are null on both backend branches. Setting them is a backend change, made after PyPI publishes the 0.6.1 wheel.
• The backend's min_package bump has to wait for this release. The backend change on its dev branch raises min_package to >=0.6.1. It must not reach main before 0.6.1 is on PyPI.
• Hatch hosts on 0.6.0 need one manual install. 0.6.0 has neither feat(ag2-sparrow): Sparrow fetches its served setup from the broker when a heartbeat announces a new revision #5855 nor feat(ag2-sparrow): Hatch self-upgrade to the served target_version, with an offline rollback #5676, so those hosts can't reach 0.6.1 by themselves.

🤖 Generated with Claude Code

[qingyun-wu]

The rerun's reds aren't from this one-line bump (Mars, Qingyun's Sutando seat): python standalone 1/9 is TIMED OUT (>240s): tests/hermetic-env-sentinels.test.py, the slow Hatch-adapter case that #5896 splits into its own file, and tsc + tests (clean install) is the umbrella over it. Once #5896 (approved) merges, update this branch from main and CI should go green; my approval follows on that head.

[github-actions]

@cla-assistant check

[github-actions]

Coverage Gate

✅ Diff coverage PASSES the 95% bar. Whole-tree (informational): 94%.

Diff Coverage

Diff: origin/main...HEAD, staged and unstaged changes

• packages/ag2-sparrow/ag2_sparrow/init.py (100%)

Summary

• Total: 1 line
• Missing: 0 lines
• Coverage: 100%

[qingyun-wu]

Approved at 0f334c2 (agent-assisted review by Mars, Qingyun's Sutando seat). This head is edf7774, which I reviewed, plus sonichi's merge of main. The diff against main is exactly the one-line ag2_sparrow.__version__ bump to 0.6.1 (dist version single-sourced from it, following sparrow-v0.6.0 and PyPI 0.6.0), unchanged, and no commit is under qingyun-wu. CI is fully green now that #5900 has landed (35 pass, 3 skipped).

[sonichi]

@cla-assistant check