Repository navigation
Releases
v1.0.1
What's Changed
Full Changelog: v1.0.0...v1.0.1
v1.0.0
What's Changed
- feat: prepare public v1 release candidates by @YidiDev in #53
- docs: preserve npm reservation until attested publication by @YidiDev in #54
- test: add measured public v1 runtime soak by @YidiDev in #55
- test: handle native compaction in release soak by @YidiDev in #56
- docs: remove release invariant from agent guidance by @YidiDev in #57
- feat: release stable v1 with documented owner exception by @YidiDev in #58
Full Changelog: v0.9.1...v1.0.0
v1.0.0-rc.1
What's Changed
Full Changelog: v0.9.1...v1.0.0-rc.1
v0.9.1
Fixed
session_read now reads a bounded tail instead of rejecting all reads once the host context exceeds 512 messages. The window contains at most the newest 512 entries, and earlier_context_unavailable: true explicitly identifies excluded older context. Pagination flags and cursors apply only to that window; they do not recover complete history.
Existing work, byte, visibility, and static-policy limits remain enforced. Exports reject truncated windows before creating a file rather than silently installing a partial current-context export. Security docs and bundled guidance describe these boundaries.
Verification
- All seven PR CI checks passed, including full quality, branch coverage, LCOV, Linux-store and secure-export Docker acceptance, packed-package verification, and isolated OpenCode 2.1.3 live compatibility.
- Local focused regressions: 49 passed. Local format, lint, conventions, typecheck, package verification, black-box tests, and the 4-test/54-assertion live suite passed.
- The local full suite encountered three timeouts in unchanged SQLite tests during high machine load; CI completed the full suite without failures. No timeout, threshold, hook, or skip budget was bypassed.
Supports Linux x64 and stable OpenCode >=2.1.3 <2.2.0. Configure the installed src/ directory, not src/index.ts.
This is a GitHub-only patch release from merge commit 233b06e07745cb4f8216e95b8fb90bcde3716887 and signed tag v0.9.1; no npm publication was requested. The package archive and SHA256SUMS are attached. Issue #46 remains open for extended soak; this release does not claim to fix host scheduling delays or every prolonged-runtime failure.
v0.9.0
OpenCode Agent Communicator v0.9.0
This GitHub-only compatibility release supports Linux x64 and stable OpenCode >=2.1.3 <2.2.0. It fixes the installation path that could leave all communicator tools absent from the plugin registry.
Upgrade requirements
- Configure the installed
src/directory, notsrc/index.ts. OpenCode 2.1 rejects file sources before plugin setup; widening the version guard alone does not fix loading. - OpenCode plugin and CLI packages are aligned at
2.1.3, with Effect4.0.1. Use v0.8.0 for OpenCode 2.0 hosts; this update does not support that older runtime. - Install v0.9.0 side by side, preserve existing policy and state settings, and coordinate a shared-service restart before expecting the running host to use it.
Changes and verification
The packed live harness now loads the actual installed source directory rather than a wrapper. It checks all 21 primary tools and three skills, completed correlated tool calls, durable ask/answer/ack and wait/signal/ack exchanges, authorized idempotent starts, cross-session read policies and cursor continuation, and sanitized export with required Linux capabilities.
Registration requests share an abortable deadline, including the initial location request. Regression tests cover stalled requests, cleanup, and cancellation-timer removal after successful acquisition.
- Local quality gate: 1,957 passed, 4 reviewed skips; formatting, lint, conventions, typecheck, and black-box checks passed.
- Package verification: exact 302-path archive and ordered 21-tool manifest.
- Isolated live acceptance: 4 passed, 54 assertions.
- All seven CI checks passed for both #50 and release PR #51, including coverage thresholds, Linux-store, capability-required secure export, and package portability.
Known limits
The public host API still lacks authoritative current activity. Explicit context delivery and session_stop remain registered but fail closed. Reads and sanitized exports cover current model context, not complete history; projection bounds apply after host materialization. Static allow/deny policy defaults and fencing guarantees are unchanged.
Issue #46 remains open for the extended multi-repository soak and prolonged-runtime investigation. Actual-environment installation and smoke-test evidence is tracked separately in #49.
See the installation instructions and configuration guide. The attached package archive is covered by SHA256SUMS. No npm publication was requested or dispatched.
v0.8.0
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/denypolicies with secure defaults. Legacyaskvalues 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_senddefaults 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.
v0.7.2
Fixed
- Ownership lease expiry no longer leaves every communicator tool permanently not-ready until OpenCode restarts. A later not-yet-started tool call can replace the full composition through one serialized, fail-closed recovery with a higher fencing epoch.
- Started calls are never replayed. Recovery remains bounded and grace-aware; disposal, contention, timeout, storage, contract, workflow, and replacement ambiguity remain terminal.
Compatibility
- Linux x64 only
- Bun 1.4.0
- OpenCode >=1.18.21 <1.19.0
- Live-certified against OpenCode 1.18.21 and 1.18.25
Installation
Install from the immutable release tag as documented in the README:
install_root="$HOME/.local/share/opencode-agent-communicator/v0.7.2"
mkdir -p "$install_root"
npm install --prefix "$install_root" --save-exact --ignore-scripts \
"git+ssh://git@github.com/YidiDev/opencode-agent-communicator.git#v0.7.2"The verified npm publication workflow built the exact 317-file archive and passed all Linux, coverage, package, security, store, and live-compatibility checks. Its final registry upload failed with npm ENEEDAUTH, so version 0.7.2 is not available from npm at release time.
Full changelog: v0.7.1...v0.7.2
v0.7.1
Highlights
- Communicator tools are now primary-only in OpenCode configuration. Native
taskchildren keep their ordinary working tools and return through the native task result instead of receiving the 21 root-to-root communicator tools.
Compatibility
- Linux x64
- Bun 1.4.0
- OpenCode >=1.18.21 <1.19.0
Publication status
The immutable v0.7.1 tag and GitHub release are available. All release checks passed and the verified 311-file archive was built. npm publication is pending because the trusted-publishing job failed with ENEEDAUTH; opencode-agent-communicator@0.7.1 is not currently available from npm. See the publish workflow run.
Full changelog: v0.7.0...v0.7.1
v0.7.0
Highlights
- Replaces default peer user-message delivery with bounded, transcript-invisible provider context for active sessions.
- Adds store-backed context admissions and SQLite schema v16 with fail-closed ambiguity recovery.
- Preserves explicit
delivery: "user"for transcript-visible delivery and idle wake behavior. - Moves existing-root asks, waits, and durable requests to context while retaining the native initial turn for
session_request_start. - Revalidates exact session identity before context injection and shares native delivery quotas across transports.
Compatibility
- Linux x64
- Bun 1.4.0
- OpenCode >=1.18.21 <1.19.0
Migration
Stop all backends and back up the complete state directory before upgrading. Older plugin versions must not open a store after migration v16.
Publication status
The immutable v0.7.0 tag and GitHub release are available. All release checks passed and the verified 311-file archive was built. npm publication is pending because the trusted-publishing job failed with ENEEDAUTH; opencode-agent-communicator@0.7.0 is not currently available from npm. See the publish workflow run.
Full changelog: v0.6.0...v0.7.0
v0.6.0
Highlights
- Adds bounded transcript inspection through the
session_readtool, including exact native pagination and active-session append handling. - Enforces mandatory approval for
session_readandsession_stop. - Hardens transcript reads with overlap detection, strict error classification, readiness ordering, and a cumulative 32 MiB raw-response limit before deserialization.
- Expands regression coverage for pagination boundaries, concurrent appends, continuation handling, and resource budgets.
Compatibility
- Linux x64
- Bun 1.4.0
- OpenCode >=1.18.21 <1.19.0
Publication status
The immutable v0.6.0 tag and GitHub release are available. npm publication is pending because the trusted-publishing job failed with ENEEDAUTH; opencode-agent-communicator@0.6.0 is not currently available from npm. See the publish workflow run.
Full changelog: v0.5.0...v0.6.0