OpenAPI Toolkit (ollama_dart)

Uses shared scripts from openapi-toolkit.

Prerequisites

• •Python 3.9+ with pyyaml installed
  • •Important: Install for your active Python version: python3 -m pip install pyyaml --user
  • •Verify: python3 -c "import yaml; print(yaml.__version__)"

Working Directory Requirements

Different scripts require different working directories. See the shared README for details.

Quick Start

# === FROM REPOSITORY ROOT ===

# Fetch latest spec
cd "$(git rev-parse --show-toplevel)" && \
python3 .claude/shared/openapi-toolkit/scripts/fetch_spec.py \
  --config-dir packages/ollama_dart/.claude/skills/openapi-ollama/config

# Analyze changes (specs auto-located from config)
cd "$(git rev-parse --show-toplevel)" && \
python3 .claude/shared/openapi-toolkit/scripts/analyze_changes.py \
  --config-dir packages/ollama_dart/.claude/skills/openapi-ollama/config \
  --format all

# === FROM PACKAGE ROOT ===

# IMPORTANT: Check API coverage (spec auto-located)
cd "$(git rev-parse --show-toplevel)/packages/ollama_dart" && \
python3 ../../.claude/shared/openapi-toolkit/scripts/verify_coverage.py \
  --config-dir .claude/skills/openapi-ollama/config --verbose

# Verify implementation (barrel files auto-discovered)
cd "$(git rev-parse --show-toplevel)/packages/ollama_dart" && \
python3 ../../.claude/shared/openapi-toolkit/scripts/verify_exports.py \
  --config-dir .claude/skills/openapi-ollama/config

cd "$(git rev-parse --show-toplevel)/packages/ollama_dart" && \
python3 ../../.claude/shared/openapi-toolkit/scripts/verify_model_properties.py \
  --config-dir .claude/skills/openapi-ollama/config \
  --spec specs/openapi.json

# Re-run coverage to confirm full implementation
cd "$(git rev-parse --show-toplevel)/packages/ollama_dart" && \
python3 ../../.claude/shared/openapi-toolkit/scripts/verify_coverage.py \
  --config-dir .claude/skills/openapi-ollama/config

IMPORTANT: Verify Against Official Sources

The Ollama OpenAPI spec may be incomplete or lag behind the actual implementation. Always cross-reference with these official sources before finalizing implementation:

Primary Sources (Source of Truth)

1. •

   Ollama Go Types (definitive API contract): https://github.com/ollama/ollama/blob/main/api/types.go

2. •

   Ollama JS Client (reference implementation): https://github.com/ollama/ollama-js/blob/main/src/interfaces.ts

Verification Workflow

When updating or creating models:

1. •Fetch the OpenAPI spec as usual
2. •Cross-reference each model with the Go types and JS interfaces
3. •If the official sources have parameters not in the OpenAPI spec, add them
4. •Update expected_properties in config/models.json with any new parameters found

Critical Models to Verify

These models are most likely to have parameters missing from the OpenAPI spec:

Expected Properties Validation

The config/models.json file contains an expected_properties section that lists all expected properties for critical models. The verification script will warn if any expected properties are missing from the implementation.

This serves as a regression prevention mechanism: if a future OpenAPI spec update inadvertently removes a property that should exist, the verification will catch it.

Troubleshooting

• •No changes detected: Analysis shows all zeros - package is up-to-date, no action needed
• •Unexported files warning: Add internal utility files to skip_files in config/package.json
• •Coverage < 100%: Missing APIs need implementation before other updates

Package-Specific References

• •Package Guide
• •Implementation Patterns
• •Review Checklist

External References

• •Official Ollama API Documentation
• •Official Ollama JS Client
• •Ollama OpenAPI Spec