| name | openapi-open-responses |
| description | Update open_responses from OpenResponses OpenAPI changes. Use for spec refresh, change review, scaffolding, and verification. |
OpenResponses OpenAPI Workflow
Prerequisites
- Auth: No auth env vars required.
- CLI:
python3 .agents/shared/api-toolkit/scripts/api_toolkit.py
- Existing-package commands: run the repo-relative examples from the repository root. If you run them elsewhere, invoke the script via an absolute path and pass an absolute
--config-dir.
Workflow
- Fetch:
python3 .agents/shared/api-toolkit/scripts/api_toolkit.py fetch --config-dir packages/open_responses/.agents/skills/openapi-open-responses/config
Fetch writes the candidate spec to the configured output_dir as latest-<spec>.json.
2. Review:
python3 .agents/shared/api-toolkit/scripts/api_toolkit.py review --config-dir packages/open_responses/.agents/skills/openapi-open-responses/config
- Implement with
scaffold plus the package references, then promote the reviewed candidate from output_dir/latest-<spec>.json into packages/open_responses/specs/ before final verification.
- Verify:
python3 .agents/shared/api-toolkit/scripts/api_toolkit.py verify --config-dir packages/open_responses/.agents/skills/openapi-open-responses/config --checks all --scope all
Specs
| Spec | Description |
|---|
main | OpenResponses unified LLM API specification |
Package References
Separate Dart Quality Steps
cd packages/open_responses
dart analyze --fatal-infos
dart format --set-exit-if-changed .
dart test test/unit/
