$worker

opencode

Name: opencode
Author: iii

v0.1.9

OpenCode as an iii worker — opencode::* functions run headless OpenCode turns, mirror raw JSON events onto opencode::events, and stream AgentEvent frames onto agent::events.

iiiverified

29 installs0 in 7d0 today

install

$iii worker add opencode

bundlelicense: Apache-2.0coding-agent opencode cli headless agent

7functions 0triggers 1skills 2deps v0.1.9version

repoiii-hq/workers

exact versions are immutable; binary and bundle artifacts are digest-pinned.

functions

opencode::on-config-change

function

Internal: reload opencode configuration when it changes.

request

empty object

response

valuenull

opencode::run

function

Run one OpenCode turn and wait for the result. Accepts `prompt` or a `messages` array; streams raw OpenCode JSON events onto opencode::events, AgentEvent frames onto agent::events, and returns {session_id, result, usage, total_cost_usd}.

request

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 ofrequired
  any of (2)
  variant 1
  valuestring
  variant 2
  itemsobject[]
  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

response

busyboolean
is_errorboolean
num_turnsnumber
opencode_session_idany of
any of (2)
variant 1
valuestring
variant 2
valuenull
reasonstring
resultstring
session_idstringrequired
stop_reasonstring
total_cost_usdnumber
usageany of
any of (2)
variant 1
cache_read_tokensnumber
cache_write_tokensnumber
input_tokensnumberrequired
output_tokensnumberrequired
reasoning_tokensnumber
variant 2
valuenull

opencode::sessions::list

function

List every OpenCode session this worker has run.

request

empty object

response

sessionsobject[]required
- cwdstringrequired
- modelstringrequired
- opencode_session_idany ofrequired
  any of (2)
  variant 1
  valuestring
  variant 2
  valuenull
- session_idstringrequired
- statusstringrequiredenum: working, done, error
- total_cost_usdnumberrequired
- turnsnumberrequired
- updated_at_msnumberrequired
- usageany ofrequired
  any of (2)
  variant 1
  cache_read_tokensnumber
  cache_write_tokensnumber
  input_tokensnumberrequired
  output_tokensnumberrequired
  reasoning_tokensnumber
  variant 2
  valuenull

opencode::start

function

Start an OpenCode turn and return immediately; watch agent::events (group_id = session_id) for progress and turn_end.

request

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 ofrequired
  any of (2)
  variant 1
  valuestring
  variant 2
  itemsobject[]
  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

response

session_idstringrequired
startedbooleanrequired

opencode::status

function

Point-in-time status of an OpenCode session.

request

session_idstringrequired
iii session id returned by opencode::run / opencode::start

response

livebooleanrequired
recordany ofrequired
any of (2)
variant 1
cwdstringrequired
modelstringrequired
opencode_session_idany ofrequired
… expand 2 nestedcollapse
any of (2)
variant 1
valuestring
variant 2
valuenull
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 2
valuenull
variant 2
valuenull
session_idstringrequired

opencode::stop

function

Interrupt a live OpenCode run for a session.

request

session_idstringrequired
iii session id returned by opencode::run / opencode::start

response

reasonstring
session_idstringrequired
stoppedbooleanrequired

run::start_and_wait

function

Alias for opencode::run under the shared agent entrypoint: run a turn for {session_id, messages} and return when it ends.

request

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 ofrequired
  any of (2)
  variant 1
  valuestring
  variant 2
  itemsobject[]
  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

response

busyboolean
is_errorboolean
num_turnsnumber
opencode_session_idany of
any of (2)
variant 1
valuestring
variant 2
valuenull
reasonstring
resultstring
session_idstringrequired
stop_reasonstring
total_cost_usdnumber
usageany of
any of (2)
variant 1
cache_read_tokensnumber
cache_write_tokensnumber
input_tokensnumberrequired
output_tokensnumberrequired
reasoning_tokensnumber
variant 2
valuenull

triggers

no triggers registered