Pi AI library (@mariozechner/pi-ai)
Grounding
pi-mono/packages/ai/README.md— primary API surface, providers list, examples.pi-mono/AGENTS.md— section Adding a New LLM Provider (packages/ai) (file checklist:types.ts,providers/,register-builtins.ts, tests, coding-agent touchpoints).pi-mono/packages/ai/src/— read only the specific provider or type files needed after narrowing via README.
Invariants
- Library scope is tool-capable models — stated in
pi-mono/packages/ai/README.mdopening note. - Provider work spans multiple files — follow
pi-mono/AGENTS.mdchecklist verbatim when changingpi-mono.
Workflows
- Call pattern: Use README Quick Start for
stream/complete/Context/Toolshapes; cite line ranges by re-reading the file, do not paraphrase signatures from memory. - New provider: Execute the AGENTS.md checklist in order; link each step to the listed paths.
Anti-patterns
- Do not document providers that appear only in other products; enumerate from
pi-mono/packages/ai/README.mdSupported Providers section.