release: Release v0.0.9

[pedronauck]

Release v0.0.9

This PR prepares the release of version v0.0.9.

Changelog

0.0.9 - 2026-07-04

♻️ Refactoring

• Tasks orchestration (refactor: tasks orchestration #269)

🐛 Bug Fixes

• Network optimizations (fix: network optimizations #263)
• Native tools (fix: native tools #266)
• Align release-gated network integration tests with fix: network optimizations #263 behavior

📚 Documentation

• Update skills
• New skill
• Add feature stories
• Add v0.0.9 release notes

📦 Build System

• Update go deps
• Gitignore

Release Notes

Features

Network delivery policies, subscriptions, and thread-to-task promotion

AGH network channels gain durable delivery control. Each channel now carries a fan-out policy — deliver to all members, route to a designated coordinator peer, or match by capability (the default) — managed with agh network channels create and agh network channels update. Peers and tasks can subscribe to channels: inspect subscriptions with agh network subscriptions and manage per-task subscriptions with agh task subscribe <task-id>. Executable thread messages can be promoted into durable workspace tasks straight from the CLI with agh network promote, or by an agent through the agh__task_promote_from_thread native tool, and designated sibling task runs can be fanned out as part of a workflow. Network and task views now surface task links, peer and coordination cost, and delivered size and token metrics, while mentions are normalized (trimmed, empties removed) and size and token limits are enforced as non-negative.

Task blocking, recovery, and needs-attention triage

Tasks are now first-class to block, triage, and recover. A task can be explicitly blocked and unblocked with agh task block <id> and agh task unblock <id>, and every block is kept as durable history you can inspect with agh task blocks <id>. A new needs_attention status surfaces tasks that stalled and need a human or coordinator to step in — task details now carry the blocked reason and the wake creator so it is clear why a task is waiting and who nudged it. Clear the state with agh task recover <id>, recover a specific stalled run with agh task run recover <run-id>, or let an agent do it through the agh__task_recover native tool and the HTTP/UDS API. Task completion now returns the IDs of any tasks it created, and stronger validation rejects invalid created-task references before they are persisted. Claim tokens are redacted across task outputs and hook payloads, and the new needs_attention_after setting controls how long a task may wait before it is flagged for attention.

Fixes

Clearer native tool errors and availability diagnostics

Native and hosted tool calls now fail legibly. Hosted MCP tool calls return richer, structured JSON error details — the tool ID, an error code, and any denial reasons — instead of opaque failures, and advertised tools carry improved metadata and descriptions. When runtime diagnostic data cannot be retrieved, native tool lookups report a clear "unavailable" diagnostic rather than a silent miss. Hosted and session MCP availability handling is safer overall, with clearer informational and warning logs and graceful fallbacks when a feature is disabled. Documentation and the runtime envelope now consistently direct agents to the canonical agh__* tool IDs and the harness-returned tool references.

Summary by CodeRabbit

• Chores
  • Updated a bundled web assets dependency to a newer version.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agh-site	Ready	Preview, Comment	Jul 4, 2026 3:13am

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 18492461-73c7-4020-ad14-f17d1a2091f9

📥 Commits

Reviewing files that changed from the base of the PR and between 95ae3b8 and 1088e30.

⛔ Files ignored due to path filters (9)

• .release-notes/archive/v0.0.9/clearer-native-tool-errors-and-availability-diagnostics-1783130275.md is excluded by !**/*.md
• .release-notes/archive/v0.0.9/network-delivery-policies-subscriptions-and-thread-to-task-promotion-1783130274.md is excluded by !**/*.md
• .release-notes/archive/v0.0.9/task-blocking-recovery-and-needs-attention-triage-1783130273.md is excluded by !**/*.md
• CHANGELOG.md is excluded by !**/*.md
• RELEASE_BODY.md is excluded by !**/*.md
• RELEASE_NOTES.md is excluded by !**/*.md
• go.sum is excluded by !**/*.sum, !**/*.sum
• package.json is excluded by !**/*.json
• packages/site/content/blog/changelog/v0.0.9.mdx is excluded by !**/*.mdx

📒 Files selected for processing (1)

• go.mod

---

Walkthrough

This change updates the github.com/compozy/agh-web-assets dependency version in go.mod from v0.0.38 to v0.0.46.

Changes

Dependency Version Bump

Layer / File(s)	Summary
Update agh-web-assets version go.mod	Bumped the github.com/compozy/agh-web-assets require entry from v0.0.38 to v0.0.46.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Possibly related PRs

• compozy/agh#251: Also bumps the github.com/compozy/agh-web-assets version in go.mod.
• compozy/agh#260: Also bumps the github.com/compozy/agh-web-assets version in go.mod (v0.0.33→v0.0.38).

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title matches the PR's release-prep intent for v0.0.9 and is related to the changeset.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch release/v0.0.9

---

_{Comment @coderabbitai help to get the list of available commands.}

[pedronauck]

✅ Dry-Run Completed Successfully

📊 Build Summary

• Version: 0.0.0-1783134864
• Commit: 057142a

📦 Built Artifacts

Not available.

---

This is an automated comment from the release dry-run check.