pi coding agent as an iii worker — pi::run drives headless turns and pi::terminal::* runs the same agent in a shell::pty session on its own console page. Both publish raw events on the pi::raw-event trigger type and AgentEvent frames on pi::agent-event.
iiiverifiedexact versions are immutable; binary and bundle artifacts are digest-pinned.
Check which providers a pi terminal on this host can use. Reports the credential kind, a subscription login or an API key, read from `pi auth check`; never returns the credential itself.
Queue a follow-up message for a live Pi run; processed after the agent would otherwise stop.
Instruction to inject into the live run
iii session id of a live run
Internal: reload pi configuration when it changes.
Run one Pi coding-agent turn and wait for the result. Accepts `prompt` or a `messages` array; publishes raw Pi events on the pi::raw-event trigger type and AgentEvent frames on pi::agent-event (bind with { session_id }), and returns {session_id, result, usage, total_cost_usd}.
Working directory the turn runs in
Prepend the iii runtime discovery context (engine catalog via the iii CLI)
Alternative to prompt: role/content messages; the last user entry becomes the prompt
Model as "provider/modelId"; empty = Pi settings default
The session delegating this run. Written to the child session metadata, which is what nests it under its parent in the console — the same link a harness sub-agent carries.
The user prompt for this turn
iii session id; reuse to resume the same Pi conversation
Reasoning depth for this turn
Reserved for callers; not forwarded
Tool allowlist; empty = Pi defaults (read, bash, edit, write)
List every Pi session this worker has run.
Start a Pi turn and return immediately; bind pi::agent-event with { session_id } for progress and turn_end.
Working directory the turn runs in
Prepend the iii runtime discovery context (engine catalog via the iii CLI)
Alternative to prompt: role/content messages; the last user entry becomes the prompt
Model as "provider/modelId"; empty = Pi settings default
The session delegating this run. Written to the child session metadata, which is what nests it under its parent in the console — the same link a harness sub-agent carries.
The user prompt for this turn
iii session id; reuse to resume the same Pi conversation
Reasoning depth for this turn
Reserved for callers; not forwarded
Tool allowlist; empty = Pi defaults (read, bash, edit, write)
Check the status of a Pi session.
iii session id returned by pi::run / pi::start
Inject a steering instruction into a live Pi run; applied after the current tool calls finish.
Instruction to inject into the live run
iii session id of a live run
Stop a live Pi run for a session.
iii session id returned by pi::run / pi::start
Delegate one task to Pi and return its session id immediately — the sub-agent shape: it never parks the caller. The outcome is written to state under scope `agent_tasks`, key the child session id, so bind a `state` trigger on that BEFORE calling and be woken by it; progress arrives on pi::agent-event (bind with { session_id }). Pass `parent_session_id` to nest the child under the session that delegated it.
Working directory the turn runs in
Prepend the iii runtime discovery context (engine catalog via the iii CLI)
Model as "provider/modelId"; empty = Pi settings default
The session delegating this run. Written to the child session metadata, which is what nests it under its parent in the console — the same link a harness sub-agent carries.
iii session id; reuse to resume the same Pi conversation
The child's self-contained goal. It cannot see the caller's context, so name every resource it needs.
Reasoning depth for this turn
Reserved for callers; not forwarded
Tool allowlist; empty = Pi defaults (read, bash, edit, write)
A pi lifecycle event from a terminal session (session_start, agent_start, tool_start, tool_end, agent_end, session_end), posted by the workspace extension. Translated into AgentEvent frames on the pi::agent-event feed.
What a Pi terminal session runs: the pi binary, its argv, the workspace directory, and the session environment. The console page passes this straight to shell::pty::open.
The `iii` CLI on the terminal host that carries this session's activity to the bus. Empty means nothing will reach the pi::agent-event feed.
Anything wrong that does not stop a session from opening.
Console UI asset content (console plumbing).
Alias for pi::run under the shared agent entrypoint: run a turn for {session_id, messages} and return when it ends.
Working directory the turn runs in
Prepend the iii runtime discovery context (engine catalog via the iii CLI)
Alternative to prompt: role/content messages; the last user entry becomes the prompt
Model as "provider/modelId"; empty = Pi settings default
The session delegating this run. Written to the child session metadata, which is what nests it under its parent in the console — the same link a harness sub-agent carries.
The user prompt for this turn
iii session id; reuse to resume the same Pi conversation
Reasoning depth for this turn
Reserved for callers; not forwarded
Tool allowlist; empty = Pi defaults (read, bash, edit, write)
Translated AgentEvent frames of one Pi session (pi::run, pi::start, pi::task, run::start_and_wait and the console terminal). Config: { session_id, metadata? }. Payload: { session_id, event_id, seq, epoch, source, event }. Ephemeral: not stored or replayed.
Raw Pi AgentSession events (agent_start/end, turn_start/end, message_start/update/end, tool_execution_*, queue_update, compaction_*) of one session, verbatim. Config: { session_id, metadata? }. Payload: { session_id, event_id, seq, epoch, source, event }. Ephemeral: not stored or replayed.