Skip to content

v0.0.2

Choose a tag to compare

@github-actions github-actions released this 17 Nov 17:22
· 12 commits to master since this release
b1ae2bd

[0.0.2] - 2026-11-17

Added

  • The jobs.runs source (source contract version 1, package.json's sources): one event per finished job run, from
    the plugin's own run records, with no network. events_list and probe are tools RPC methods; an event is the job's
    name and how its run ended, at the run's end, never what the run said. When retention has removed a run a read had
    not reached, the page says so with gap. npm run conformance runs the source contract's kit and writes the report
    a release attaches.

Changed

  • The tools RPC's transport is source-contract's tools-rpc module (v0.2.0), bundled, instead of the family's copy:
    the same rules, describe and envelope.
  • events_list and probe are reads: the default rules allow jobs_events_list and jobs_probe under every access.
  • A slot the runner skips (overlap, expired or ended) records when the skip was recorded as its end, so the
    jobs.runs source lists it like every other skip.
  • Tested on OpenCode 2.2.3, 2.2.4, 2.2.5, 2.2.6, 2.2.7 and 2.3.0 (TESTED_HOSTS in src/constants.ts), within the
    host range >=2.2.3 <2.4.0.

Known limits

  • Runs happen only while OpenCode runs. Nothing runs while OpenCode is closed. A slot due in that time runs when OpenCode next starts if it is no later than the job's maxLate (one hour by default); a later slot is skipped as expired.
  • Scripts have fixed limits by default. A script runs in a QuickJS VM with 64 MB of memory, 100 tool calls and 64 KB of output. A job can raise each one up to the maximum in docs/scripting.md.
  • A changed declared file is re-approved under all. The run record names the script's digest, but not yet the declared-file set (its paths, modes and caps), so the record alone does not show which file declaration a run used.
  • Declared files are read on the host. Each one is read up to its size limit, before the VM starts, and that memory is outside memoryMb.
  • A restore can fail. When a file cannot be put back after a failed commit, its run records rollback_failed and the error names the kept original, which a person must restore by hand.
  • A run stopped while its own subagent works ends at its timeout. A run waits until its session is idle with no
    subagent or shell of its own still running. If the session is stopped while one is, OpenCode reports no further idle,
    so the run is recorded as timed_out when the job's timeout passes, rather than at once.
  • An agent without the default rules still runs its jobs. Status warns with JOBS_AGENT_UNGUARDED and the block to paste; nothing blocks the run.
  • Updates are not automatic for a Git install, and opencode plugin update and opencode plugin check do not work on one: to move to a newer release, remove the old entry and add the new tag.