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.
iii trigger compose::add worker=pi@0.1.33Run in your project with the iii engine running. Exact versions are immutable and 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; streams raw Pi events onto pi::events, AgentEvent frames onto agent::events, 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; watch agent::events (group_id = 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 streams onto agent::events (group_id = 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 events stream.
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 events stream.
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)
Find workers, kits and executables, or jump to a page.