Skip to content

Provider OpenAI

provider_openai is the low-level OpenAI adapter boundary.

Customers should usually import stateplane and use StatePlaneSession(...).transform(...) instead of depending on provider_openai directly.

This package is responsible for:

  • deterministic OpenAI request rendering
  • typed response receipts
  • keeping provider-specific payload logic out of context_core

When You Should Touch This Package Directly

Most customers should not. Start with the SDK unless you have a concrete reason to bypass it.

Direct provider_openai usage is mainly for:

  • adapter development
  • low-level testing
  • cases where you already have a compiled context and only need provider rendering

Relationship To The SDK

The current layering is:

  1. context_core compiles provider-neutral context
  2. provider_openai turns compiled context into an OpenAI request
  3. stateplane exposes the supported customer API on top of both

That separation is intentional. It keeps provider-specific payload logic out of the provider-neutral compiler while still giving customers one supported import surface.