@mariozechner/pi-agent-core Agent runtime — message flow, tool execution modes, event sequence for prompt() and continue(), embedding in apps. Use when building on Agent class, wiring subscribers, or debugging tool loops beside pi-ai. Use for "pi agent events", "beforeToolCall", "agent.subscribe", even if coding-agent CLI is not involved.
Installation
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
@mariozechner/pi-agent-core Agent runtime — message flow, tool execution modes, event sequence for prompt() and continue(), embedding in apps. Use when building on Agent class, wiring subscribers, or debugging tool loops beside pi-ai. Use for "pi agent events", "beforeToolCall", "agent.subscribe", even if coding-agent CLI is not involved.
pi-mono/packages/coding-agent/examples/sdk/ — integration patterns (README.md index + numbered examples).
pi-mono/packages/coding-agent/docs/sdk.md — higher-level SDK documentation when present.
Invariants
Event ordering and barrier behavior (message_end before tool preflight) are specified in pi-mono/packages/agent/README.md; cite that file instead of restating from memory.
Workflows
Pick integration depth: README Quick Start vs full examples/sdk/ depending on user needs; always point to concrete example filenames under pi-mono/packages/coding-agent/examples/sdk/.
Anti-patterns
Do not merge pi-coding-agent session semantics with core Agent without reading agent-session.ts when the question is about the CLI harness specifically — route CLI questions to pi-cli-workspace after citing boundaries from READMEs.
