| name | openapi-openai |
| description | Update openai_dart from OpenAI OpenAPI changes. Use for spec refresh, change review, scaffolding, and verification. |
OpenAI 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/openai_dart/.agents/skills/openapi-openai/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/openai_dart/.agents/skills/openapi-openai/config
- Implement with
scaffold plus the package references, then promote the reviewed candidate from output_dir/latest-<spec>.json into packages/openai_dart/specs/ before final verification.
- Verify:
python3 .agents/shared/api-toolkit/scripts/api_toolkit.py verify --config-dir packages/openai_dart/.agents/skills/openapi-openai/config --checks all --scope all
Specs
| Spec | Description |
|---|
main | OpenAI API for GPT, DALL-E, Whisper, and more |
Package References
Separate Dart Quality Steps
cd packages/openai_dart
dart analyze --fatal-infos
dart format --set-exit-if-changed .
dart test test/unit/
