Pi agent embedding (@mariozechner/pi-agent-core)
Grounding
pi-mono/packages/agent/README.md— Agent options, event tables, tool parallel vs sequential,convertToLlm/transformContextflow diagram.pi-mono/packages/coding-agent/examples/sdk/— integration patterns (README.mdindex + numbered examples).pi-mono/packages/coding-agent/docs/sdk.md— higher-level SDK documentation when present.
Invariants
- Event ordering and barrier behavior (
message_endbefore tool preflight) are specified inpi-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 underpi-mono/packages/coding-agent/examples/sdk/.
Anti-patterns
- Do not merge pi-coding-agent session semantics with core
Agentwithout readingagent-session.tswhen the question is about the CLI harness specifically — route CLI questions topi-cli-workspaceafter citing boundaries from READMEs.