opencode::on-config-change
Internal: reload opencode configuration when it changes.
empty object
valuenull
$registry / workers
opencode
v0.1.23OpenCode as an iii worker — opencode::* functions run headless OpenCode turns, deliver raw JSON events on the opencode::raw-event trigger type and AgentEvent frames on opencode::agent-event.
worker
iiiverified35 installs0 in 7d0 today
iiiverifiedinstall
$iii trigger compose::add worker=opencode
repoiii-hq/workers
exact versions are immutable; binary and bundle artifacts are digest-pinned.
functions
7function
opencode::run
Run one OpenCode coding-agent turn and wait for the result. Accepts `prompt` or a `messages` array; delivers raw events on the opencode::raw-event trigger and AgentEvent frames on opencode::agent-event (bind with { session_id }), and returns {session_id, result, usage, total_cost_usd}.
- agentstring
OpenCode agent to use
- cwdstring
Working directory the turn runs in
- iii_contextboolean
Prepend the iii runtime discovery context (engine catalog via the iii CLI)
- messagesobject[]
Alternative to prompt: role/content messages; the last user entry becomes the prompt
- contentany ofrequiredany of (2)variant 1valuestringvariant 2itemsobject[]
- typestringrequired
- rolestringrequired
- modelstring
Model as "provider/model"; empty = OpenCode default
- promptstring
The user prompt for this turn
- session_idstring
iii session id; reuse to resume the same OpenCode conversation
- timeout_msintegermax 9007199254740991
Reserved for callers; not forwarded
- busyboolean
- is_errorboolean
- num_turnsnumber
- opencode_session_idany ofany of (2)variant 1valuestringvariant 2valuenull
- reasonstring
- resultstring
- session_idstringrequired
- stop_reasonstring
- total_cost_usdnumber
- usageany ofany of (2)variant 1
- cache_read_tokensnumber
- cache_write_tokensnumber
- input_tokensnumberrequired
- output_tokensnumberrequired
- reasoning_tokensnumber
variant 2valuenull
opencode::sessions::list
List every OpenCode session this worker has run.
empty object
- sessionsobject[]required
- cwdstringrequired
- modelstringrequired
- opencode_session_idany ofrequiredany of (2)variant 1valuestringvariant 2valuenull
- session_idstringrequired
- statusstringrequiredenum: working, done, error
- total_cost_usdnumberrequired
- turnsnumberrequired
- updated_at_msnumberrequired
- usageany ofrequiredany of (2)variant 1
- cache_read_tokensnumber
- cache_write_tokensnumber
- input_tokensnumberrequired
- output_tokensnumberrequired
- reasoning_tokensnumber
variant 2valuenull
opencode::start
Start an OpenCode turn and return immediately; bind opencode::agent-event with { session_id } for progress and turn_end.
- agentstring
OpenCode agent to use
- cwdstring
Working directory the turn runs in
- iii_contextboolean
Prepend the iii runtime discovery context (engine catalog via the iii CLI)
- messagesobject[]
Alternative to prompt: role/content messages; the last user entry becomes the prompt
- contentany ofrequiredany of (2)variant 1valuestringvariant 2itemsobject[]
- typestringrequired
- rolestringrequired
- modelstring
Model as "provider/model"; empty = OpenCode default
- promptstring
The user prompt for this turn
- session_idstring
iii session id; reuse to resume the same OpenCode conversation
- timeout_msintegermax 9007199254740991
Reserved for callers; not forwarded
- session_idstringrequired
- startedbooleanrequired
opencode::status
Check the status of an OpenCode session.
- session_idstringrequired
iii session id returned by opencode::run / opencode::start
- livebooleanrequired
- recordany ofrequiredany of (2)variant 1
- cwdstringrequired
- modelstringrequired
- opencode_session_idany ofrequired
… expand 2 nestedcollapse
any of (2)variant 1valuestringvariant 2valuenull - session_idstringrequired
- statusstringrequiredenum: working, done, error
- total_cost_usdnumberrequired
- turnsnumberrequired
- updated_at_msnumberrequired
- usageany ofrequired
… expand 2 nestedcollapse
any of (2)variant 1- cache_read_tokensnumber
- cache_write_tokensnumber
- input_tokensnumberrequired
- output_tokensnumberrequired
- reasoning_tokensnumber
variant 2valuenull
variant 2valuenull - session_idstringrequired
opencode::stop
Stop a live OpenCode run for a session.
- session_idstringrequired
iii session id returned by opencode::run / opencode::start
- reasonstring
- session_idstringrequired
- stoppedbooleanrequired
run::start_and_wait
Alias for opencode::run under the shared agent entrypoint: run a turn for {session_id, messages} and return when it ends.
- agentstring
OpenCode agent to use
- cwdstring
Working directory the turn runs in
- iii_contextboolean
Prepend the iii runtime discovery context (engine catalog via the iii CLI)
- messagesobject[]
Alternative to prompt: role/content messages; the last user entry becomes the prompt
- contentany ofrequiredany of (2)variant 1valuestringvariant 2itemsobject[]
- typestringrequired
- rolestringrequired
- modelstring
Model as "provider/model"; empty = OpenCode default
- promptstring
The user prompt for this turn
- session_idstring
iii session id; reuse to resume the same OpenCode conversation
- timeout_msintegermax 9007199254740991
Reserved for callers; not forwarded
- busyboolean
- is_errorboolean
- num_turnsnumber
- opencode_session_idany ofany of (2)variant 1valuestringvariant 2valuenull
- reasonstring
- resultstring
- session_idstringrequired
- stop_reasonstring
- total_cost_usdnumber
- usageany ofany of (2)variant 1
- cache_read_tokensnumber
- cache_write_tokensnumber
- input_tokensnumberrequired
- output_tokensnumberrequired
- reasoning_tokensnumber
variant 2valuenull
triggers
2opencode::agent-event
Translated AgentEvent frames of one OpenCode session. Config: { session_id, metadata? }. Payload: { session_id, event_id, seq, epoch, source, event }. Ephemeral: not stored or replayed.
valueunknown
valueunknown
opencode::raw-event
Raw OpenCode JSON events (verbatim `opencode run --format json` lines) of one session. Config: { session_id, metadata? }. Payload: { session_id, event_id, seq, epoch, source, event }. Ephemeral: not stored or replayed.
valueunknown
valueunknown