Skip to content

v0.8.0

Choose a tag to compare

@YidiDev YidiDev released this 19 Oct 23:44
· 10 commits to main since this release

OpenCode Agent Communicator v0.8.0

This release moves the communicator to the public OpenCode v2 Effect plugin API and hardens startup, ownership recovery, cancellation, and durable queue admission. It retains all 21 tools and three bundled skills.

Breaking changes

  • Requires Linux x64 and stable OpenCode >=2.0.26 <2.1.0. OpenCode 1 is no longer supported.
  • Sensitive actions use static allow/deny policies with secure defaults. Legacy ask values are rejected; review your configuration before upgrading.
  • Reads and sanitized exports cover the current model context, not complete history. Unsanitized export and obsolete CLI-export configuration are rejected.
  • session_send defaults to transcript-visible user-turn queue delivery. Existing-root requests no longer require a prior busy observation.

Reliability and security

  • Scoped startup acquisition and disposal prevent abandoned generations from retaining resources.
  • Queue admission shares a participant gate with stop, revalidates its fenced claim before effects, and records cancellation or ambiguous persistence without replaying native effects.
  • Clock-regression handling preserves monotonic expiry, persisted lease chronology, and fencing.
  • Reads and exports charge the whole restricted context snapshot on each call, including fixed-message misses. Limits apply after the host materializes context; they are not raw transport allocation guarantees.
  • Participant discovery scans bounded keyset pages and evicts old discovery candidates at capacity without deleting durable protocol state.
  • The packed live harness verifies actual correlated tool calls, manifests, lock operations, message recovery, and durable request/answer/ack exchanges.

Known limitations

The public v2 API does not provide authoritative current activity. Explicit context delivery returns target_status_unknown; session_stop returns native_unavailable, both before effects. Use user-turn delivery or queue-based requests for supported communication. Visible current-context reads work with unknown activity, but is_live: false does not prove that a peer is idle.

Issue #46 remains open for the extended isolated multi-repository soak and reproduction of the reported prolonged-runtime failure. This release does not claim that investigation is complete.

Installation

Use the immutable v0.8.0 Git tag and the updated absolute file:// installation example in the README. Review the configuration guide, then quit and restart OpenCode to load the new plugin.

This is a GitHub-only release. No npm publication was requested or dispatched. The attached package archive has a SHA-256 checksum in SHA256SUMS.

Verification

  • Ordinary suite: 1,946 passed, 4 reviewed skips; format, lint, conventions, and typecheck passed.
  • Per-file branch coverage and LCOV CI checks passed.
  • Package verification: exact 302-path archive and ordered 21-tool manifest.
  • Packed-package, isolated OpenCode 2.0.26 live compatibility, Linux-store, secure-export, and Alpine package-portability checks passed.

Changes: #47 and #48. Full changelog.