Agent workflows
Agent integration
Use the Purveyors CLI as a stable interface for AI agents, coding assistants, and external automation.
The CLI is the preferred documented automation surface for most non-visual workflows. It gives agents stable command names, explicit auth requirements, predictable output modes, and a machine-readable manifest when needed.
The Purveyors web app and CLI both consume Parchment API contracts, keeping browser, terminal, and agent behavior aligned without runtime package coupling.
Recommended agent patterns
- For shell-based automation, authenticate once, then call purvey commands with JSON or CSV output that suits the surrounding workflow.
- For code-side integrations, use @purveyors/sdk against the stable Parchment API contracts instead of importing CLI runtime internals or screen-scraping help text.
- Use purvey context first when a model needs dense onboarding text. Use purvey manifest for the preferred machine-readable contract, or purvey context --json when an existing caller needs compatibility-parity output.
- Prefer purvey CLI commands for shell automation or @purveyors/sdk and the public Parchment API for code integrations; the former /api/tools/* endpoints are retired, and private workspace route payloads are not integration contracts.
How the web app and CLI stay aligned
- The app uses a session-authenticated @purveyors/sdk client to forward Parchment-owned Cherry Runtime streams without buffering. The CLI remains a separate Parchment API client and terminal surface; neither runtime imports the other.
- All Coffee-app product data and AI orchestration now cross Parchment contracts; Supabase is limited to browser identity and session plumbing.
- Cherry read and proposal tools execute inside Parchment. Writes stay user-confirmed through proposal cards and constrained execution routes.
- This API-first architecture keeps terminal, browser, and agent workflows aligned on the same contracts without runtime package coupling.
Agent bootstrap sequence
purvey auth login --headless
purvey manifest --pretty
purvey catalog search --origin "Ethiopia" --json