osp-provider-contracts 0.2.12

Shared contracts for OSP providers and orchestrator.

osp-provider-contracts

Shared Python contract package for OSP providers and orchestrator: typed interfaces, canonical errors, capabilities schema, idempotency helpers, and lightweight conformance assertions.

For maintainer-facing internals and invariants, see src/README.md.

Scope (v0.1)

• Small, explicit provider protocol
• Shared request/result/context types
• Canonical error taxonomy with retry metadata
• Capabilities schema validation
• Conformance assertions for provider test suites
• Canonical gate reason enum for approval-required flows

No pytest plugin is included in v0.1.

Approval-Required Contract

Providers that need human approval should raise ValidationError with detail="approval_required" and include a structured extra payload:

• gate_reason: one of osp_provider_contracts.GateReason string values
• importance: integer risk/urgency indicator when applicable (1 => 2 approvals)
• required_approvals: optional explicit quorum override (e.g., 2 for dual control)
• reason: stable machine-readable reason string
• details: provider-specific context for operators and audit

Install

pip install osp-provider-contracts

Development

env -u VIRTUAL_ENV uv sync --extra dev
hatch shell
hatch run dev:check
hatch run dev:build
hatch run dev:verify

Release

See docs/release.md for the manual/gated publish flow.

Tag and push:

git tag v0.2.0
git push origin v0.2.0