skip to content
iii / worker
$worker

claude-code

v0.1.4

Claude Code as an iii worker — claude::* functions run headless Claude Code turns, mirror raw messages onto claude::events, and stream AgentEvent frames onto agent::events.

iiiverified
37 installs2 in 7d0 today
install
$iii worker add claude-code@0.1.4
bundlecoding-agentclaudeanthropiccliheadless
7functions0triggers1skills2depsv0.1.4version
repoiii-hq/workers

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

functions

7

claude::on-config-change

function

Internal: reload claude-code configuration when it changes.

request
empty object
response
valuenull

claude::run

function

Run one Claude Code turn and wait for the result. Accepts `prompt` or a `messages` array plus a raw SDK `options` pass-through; streams raw Claude Code messages onto claude::events, AgentEvent frames onto agent::events, and returns {session_id, result, usage, total_cost_usd}.

request
  • allowed_toolsstring[]

    Allow rules, e.g. "Bash(git *)"

  • append_system_promptstring

    Append to the default system prompt

  • cwdstring

    Working directory the turn runs in

  • disallowed_toolsstring[]

    Deny rules

  • iii_contextboolean

    Append the iii runtime discovery prompt (engine catalog via the iii CLI)

  • max_turnsintegermax 9007199254740991

    Cap on agentic turns

  • 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 id or alias; empty = Claude Code default

  • optionsobject

    Raw Agent SDK options forwarded verbatim (camelCase), e.g. forkSession, includePartialMessages

  • permission_modestringenum: default, acceptEdits, plan, bypassPermissions

    Claude Code permission mode for this turn

  • promptstring

    The user prompt for this turn

  • session_idstring

    iii session id; reuse to resume the same Claude Code conversation

  • system_promptstring

    Replace the Claude Code system prompt

  • timeout_msintegermax 9007199254740991

    Reserved for callers; not forwarded

response
  • busyboolean
  • claude_session_idany of
    any of (2)
    variant 1
    valuestring
    variant 2
    valuenull
  • is_errorboolean
  • num_turnsnumber
  • 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
    variant 2
    valuenull

claude::sessions::list

function

List every Claude Code session this worker has run.

request
empty object
response
  • sessionsobject[]required
    • claude_session_idany ofrequired
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • cwdstringrequired
    • modelstringrequired
    • 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
      variant 2
      valuenull

claude::start

function

Start a Claude Code turn and return immediately; watch agent::events (group_id = session_id) for progress and turn_end.

request
  • allowed_toolsstring[]

    Allow rules, e.g. "Bash(git *)"

  • append_system_promptstring

    Append to the default system prompt

  • cwdstring

    Working directory the turn runs in

  • disallowed_toolsstring[]

    Deny rules

  • iii_contextboolean

    Append the iii runtime discovery prompt (engine catalog via the iii CLI)

  • max_turnsintegermax 9007199254740991

    Cap on agentic turns

  • 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 id or alias; empty = Claude Code default

  • optionsobject

    Raw Agent SDK options forwarded verbatim (camelCase), e.g. forkSession, includePartialMessages

  • permission_modestringenum: default, acceptEdits, plan, bypassPermissions

    Claude Code permission mode for this turn

  • promptstring

    The user prompt for this turn

  • session_idstring

    iii session id; reuse to resume the same Claude Code conversation

  • system_promptstring

    Replace the Claude Code system prompt

  • timeout_msintegermax 9007199254740991

    Reserved for callers; not forwarded

response
  • session_idstringrequired
  • startedbooleanrequired

claude::status

function

Point-in-time status of a Claude Code session.

request
  • session_idstringrequired

    iii session id returned by claude::run / claude::start

response
  • livebooleanrequired
  • recordany ofrequired
    any of (2)
    variant 1
    • claude_session_idany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • cwdstringrequired
    • modelstringrequired
    • session_idstringrequired
    • statusstringrequiredenum: working, done, error
    • total_cost_usdnumberrequired
    • turnsnumberrequired
    • updated_at_msnumberrequired
    • usageany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      • cache_read_tokensnumber
      • cache_write_tokensnumber
      • input_tokensnumberrequired
      • output_tokensnumberrequired
      variant 2
      valuenull
    variant 2
    valuenull
  • session_idstringrequired

claude::stop

function

Interrupt a live Claude Code run for a session.

request
  • session_idstringrequired

    iii session id returned by claude::run / claude::start

response
  • reasonstring
  • session_idstringrequired
  • stoppedbooleanrequired

run::start_and_wait

function

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

request
  • allowed_toolsstring[]

    Allow rules, e.g. "Bash(git *)"

  • append_system_promptstring

    Append to the default system prompt

  • cwdstring

    Working directory the turn runs in

  • disallowed_toolsstring[]

    Deny rules

  • iii_contextboolean

    Append the iii runtime discovery prompt (engine catalog via the iii CLI)

  • max_turnsintegermax 9007199254740991

    Cap on agentic turns

  • 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 id or alias; empty = Claude Code default

  • optionsobject

    Raw Agent SDK options forwarded verbatim (camelCase), e.g. forkSession, includePartialMessages

  • permission_modestringenum: default, acceptEdits, plan, bypassPermissions

    Claude Code permission mode for this turn

  • promptstring

    The user prompt for this turn

  • session_idstring

    iii session id; reuse to resume the same Claude Code conversation

  • system_promptstring

    Replace the Claude Code system prompt

  • timeout_msintegermax 9007199254740991

    Reserved for callers; not forwarded

response
  • busyboolean
  • claude_session_idany of
    any of (2)
    variant 1
    valuestring
    variant 2
    valuenull
  • is_errorboolean
  • num_turnsnumber
  • 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
    variant 2
    valuenull

triggers

0
no triggers registered