CLI OpenAPI Contract
The CLI-facing REST API contract is defined in apps/api/src/openapi/sam-cli.ts and checked in as apps/api/openapi/sam-cli.openapi.json.
The live API serves the same document at:
GET /api/cli/openapi.jsonRegenerate the checked artifact after changing CLI-facing API routes or response shapes:
pnpm --filter @simple-agent-manager/api openapi:generateCheck that the artifact matches the source document:
pnpm --filter @simple-agent-manager/api openapi:checkThe current slice intentionally covers only the endpoints consumed by packages/cli/internal/cli/client.go. It does not attempt to describe all admin, internal, callback, or browser-only routes. Go CLI code generation with oapi-codegen should consume apps/api/openapi/sam-cli.openapi.json; wiring generated Go types/client into packages/cli is a follow-up so this PR can first establish a tested API contract boundary.