# Pristine v0.3.0 - Table of Contents

> Shared runtime substrate for first-party OpenAPI-based Elixir SDKs.

## Pages

- Project
  - [README](readme.md)
  - [Changelog](changelog.md)
  - [License](license.md)

- Guides
  - [Getting Started](getting-started.md)
  - [Foundation Runtime](foundation-runtime.md)
  - [Manual Contexts And Adapters](manual-contexts-and-adapters.md)
  - [OAuth And Token Sources](oauth-and-token-sources.md)
  - [Streaming And SSE](streaming-and-sse.md)

## Modules

- [Pristine](Pristine.md): Shared runtime substrate for first-party OpenAPI-based SDKs.

- [Pristine.AdapterSelectionPolicy](Pristine.AdapterSelectionPolicy.md): Phase 6 adapter selection policy declaration for Pristine lower simulation.
- [Pristine.Adapters.AdmissionControl.Dispatch](Pristine.Adapters.AdmissionControl.Dispatch.md): Admission-control adapter backed by `Foundation.Dispatch`.
- [Pristine.Adapters.AdmissionControl.Noop](Pristine.Adapters.AdmissionControl.Noop.md): Admission-control adapter that performs no coordination.

- [Pristine.Adapters.Auth.ApiKey](Pristine.Adapters.Auth.ApiKey.md): Static API key auth adapter.

- [Pristine.Adapters.Auth.Basic](Pristine.Adapters.Auth.Basic.md): Basic auth adapter.

- [Pristine.Adapters.Auth.Bearer](Pristine.Adapters.Auth.Bearer.md): Bearer token auth adapter.

- [Pristine.Adapters.Auth.GovernedCredential](Pristine.Adapters.Auth.GovernedCredential.md): Governed auth adapter backed by `Pristine.GovernedAuthority`.

- [Pristine.Adapters.Auth.OAuth2](Pristine.Adapters.Auth.OAuth2.md): OAuth2 bearer adapter backed by a token source.

- [Pristine.Adapters.BytesSemaphore.GenServer](Pristine.Adapters.BytesSemaphore.GenServer.md): GenServer-based byte-budget semaphore adapter.
- [Pristine.Adapters.CircuitBreaker.Foundation](Pristine.Adapters.CircuitBreaker.Foundation.md): Circuit breaker adapter backed by Foundation.CircuitBreaker.Registry.

- [Pristine.Adapters.CircuitBreaker.Noop](Pristine.Adapters.CircuitBreaker.Noop.md): Circuit breaker adapter that performs no checks.

- [Pristine.Adapters.Compression.Gzip](Pristine.Adapters.Compression.Gzip.md): Gzip compression adapter using Erlang's :zlib module.
- [Pristine.Adapters.Multipart.Ex](Pristine.Adapters.Multipart.Ex.md): Multipart adapter backed by multipart_ex.

- [Pristine.Adapters.OAuthBackend.Native](Pristine.Adapters.OAuthBackend.Native.md): In-tree OAuth backend adapter for Pristine's control-plane helpers.

- [Pristine.Adapters.OAuthBrowser.SystemCmd](Pristine.Adapters.OAuthBrowser.SystemCmd.md): System-command browser launcher adapter for interactive OAuth flows.

- [Pristine.Adapters.OAuthCallbackListener.Bandit](Pristine.Adapters.OAuthCallbackListener.Bandit.md): Bandit-backed loopback callback listener adapter for interactive OAuth flows.

- [Pristine.Adapters.PoolManager](Pristine.Adapters.PoolManager.md): Pool manager adapter backed by `Pristine.PoolKey`.

- [Pristine.Adapters.RateLimit.BackoffWindow](Pristine.Adapters.RateLimit.BackoffWindow.md): Rate limit adapter backed by Foundation.RateLimit.BackoffWindow.

- [Pristine.Adapters.RateLimit.Noop](Pristine.Adapters.RateLimit.Noop.md): Rate limit adapter that performs no limiting.

- [Pristine.Adapters.ResultClassifier.HTTP](Pristine.Adapters.ResultClassifier.HTTP.md): Generic HTTP result classifier for Pristine request execution.

- [Pristine.Adapters.Retry.Foundation](Pristine.Adapters.Retry.Foundation.md): Retry adapter backed by Foundation retry policies.
- [Pristine.Adapters.Retry.Noop](Pristine.Adapters.Retry.Noop.md): Retry adapter that performs no retries.
- [Pristine.Adapters.Semaphore.Counting](Pristine.Adapters.Semaphore.Counting.md): Counting semaphore adapter using Foundation.Semaphore.Counting.
- [Pristine.Adapters.Serializer.JSON](Pristine.Adapters.Serializer.JSON.md): JSON serializer using Jason with optional Sinter validation.

- [Pristine.Adapters.Streaming.SSE](Pristine.Adapters.Streaming.SSE.md): SSE decoder adapter built on `Pristine.Streaming.SSEDecoder`.

- [Pristine.Adapters.Telemetry.Foundation](Pristine.Adapters.Telemetry.Foundation.md): Telemetry adapter backed by `Foundation.Telemetry`.
- [Pristine.Adapters.Telemetry.Noop](Pristine.Adapters.Telemetry.Noop.md): Telemetry adapter that does nothing.
- [Pristine.Adapters.Telemetry.Raw](Pristine.Adapters.Telemetry.Raw.md): Telemetry adapter that emits raw event names without prefixes.

- [Pristine.Adapters.TokenSource.File](Pristine.Adapters.TokenSource.File.md): JSON file-backed token source for reusable OAuth2 token persistence.
- [Pristine.Adapters.TokenSource.Refreshable](Pristine.Adapters.TokenSource.Refreshable.md): Token source wrapper that refreshes expiring OAuth2 tokens through `Pristine.OAuth2`.
- [Pristine.Adapters.TokenSource.Static](Pristine.Adapters.TokenSource.Static.md): Static token source useful for tests and simple callers.

- [Pristine.Adapters.Tokenizer.Tiktoken](Pristine.Adapters.Tokenizer.Tiktoken.md): Tokenizer adapter backed by TiktokenEx encodings.

- [Pristine.Adapters.Transport.Finch](Pristine.Adapters.Transport.Finch.md): Compatibility-named unary HTTP transport adapter backed by the Execution Plane.

- [Pristine.Adapters.Transport.FinchStream](Pristine.Adapters.Transport.FinchStream.md): Streaming HTTP transport adapter using Finch.
- [Pristine.Adapters.Transport.LowerSimulation](Pristine.Adapters.Transport.LowerSimulation.md): Configured unary HTTP simulation transport backed by Execution Plane.
- [Pristine.Client](Pristine.Client.md): Provider-agnostic runtime client used by generated providers and thin facades.

- [Pristine.Core.Auth](Pristine.Core.Auth.md): Apply auth modules to request headers.

- [Pristine.Core.Context](Pristine.Core.Context.md): Internal runtime context for executing request specs.
- [Pristine.Core.EndpointMetadata](Pristine.Core.EndpointMetadata.md): Internal endpoint metadata contract used by the request pipeline.
- [Pristine.Core.Headers](Pristine.Core.Headers.md): Header normalization and merging utilities.

- [Pristine.Core.Pipeline](Pristine.Core.Pipeline.md): Execute normalized request metadata through the shared request pipeline.

- [Pristine.Core.Querystring](Pristine.Core.Querystring.md): Query string encoder with configurable array and nested formats.

- [Pristine.Core.Request](Pristine.Core.Request.md): Normalized request data used by the transport port.

- [Pristine.Core.RequestPath](Pristine.Core.RequestPath.md): Request path validation helpers.

- [Pristine.Core.Response](Pristine.Core.Response.md): Internal normalized response data from the transport port.

- [Pristine.Core.ResultClassification](Pristine.Core.ResultClassification.md): Internal normalized classification for a single request outcome.

- [Pristine.Core.StreamResponse](Pristine.Core.StreamResponse.md): Response wrapper for streaming HTTP responses.
- [Pristine.Core.TelemetryHeaders](Pristine.Core.TelemetryHeaders.md): Build platform and retry telemetry headers.

- [Pristine.Core.Types](Pristine.Core.Types.md): Build Sinter schemas from manifest type definitions.

- [Pristine.Core.Url](Pristine.Core.Url.md): URL builder with path params and query encoding.

- [Pristine.GovernedAuthority](Pristine.GovernedAuthority.md): Authority-materialized HTTP inputs for governed Pristine execution.
- [Pristine.GovernedOperationDescriptor](Pristine.GovernedOperationDescriptor.md): Standalone-safe descriptor for governed OpenAPI operation admission.
- [Pristine.LowerSimulationScenario](Pristine.LowerSimulationScenario.md): Phase 6 lower simulation scenario declaration for Pristine HTTP transport.
- [Pristine.OAuth2](Pristine.OAuth2.md): Generic OAuth2 control-plane helpers built on Pristine's transport boundary.

- [Pristine.OAuth2.AuthorizationRequest](Pristine.OAuth2.AuthorizationRequest.md): Authorization URL and any generated state associated with it.

- [Pristine.OAuth2.Browser](Pristine.OAuth2.Browser.md): Best-effort browser launcher for interactive OAuth flows.

- [Pristine.OAuth2.CallbackServer](Pristine.OAuth2.CallbackServer.md): Exact loopback callback capture for interactive OAuth flows.

- [Pristine.OAuth2.Interactive](Pristine.OAuth2.Interactive.md): Interactive authorization-code orchestration for OAuth2 providers.

- [Pristine.OAuth2.Provider](Pristine.OAuth2.Provider.md): Normalized OAuth2 provider configuration.

- [Pristine.OAuth2.SavedToken](Pristine.OAuth2.SavedToken.md): Shared persisted-token workflow for OAuth2 token sources.

- [Pristine.OAuth2.Token](Pristine.OAuth2.Token.md): Pristine-native OAuth2 token representation.

- [Pristine.Operation](Pristine.Operation.md): Normalized runtime operation envelope rendered by generated providers.

- [Pristine.PoolKey](Pristine.PoolKey.md): Centralized pool key generation and URL normalization.
- [Pristine.Ports.AdmissionControl](Pristine.Ports.AdmissionControl.md): Admission-control boundary for optional high-throughput request shaping.

- [Pristine.Ports.Auth](Pristine.Ports.Auth.md): Auth boundary for producing headers.

- [Pristine.Ports.BytesSemaphore](Pristine.Ports.BytesSemaphore.md): Port for byte-budget rate limiting via semaphores.
- [Pristine.Ports.CircuitBreaker](Pristine.Ports.CircuitBreaker.md): Circuit breaker boundary.

- [Pristine.Ports.Compression](Pristine.Ports.Compression.md): Compression boundary for request/response payloads.
- [Pristine.Ports.Multipart](Pristine.Ports.Multipart.md): Multipart encoding boundary.

- [Pristine.Ports.OAuthBackend](Pristine.Ports.OAuthBackend.md): Boundary for OAuth control-plane request shaping and token normalization.

- [Pristine.Ports.OAuthBackend.Request](Pristine.Ports.OAuthBackend.Request.md): Normalized OAuth backend request data prior to transport dispatch.

- [Pristine.Ports.OAuthBrowser](Pristine.Ports.OAuthBrowser.md): Boundary for best-effort browser launch in interactive OAuth flows.

- [Pristine.Ports.OAuthCallbackListener](Pristine.Ports.OAuthCallbackListener.md): Boundary for loopback OAuth callback capture.

- [Pristine.Ports.PoolManager](Pristine.Ports.PoolManager.md): Port for pool name resolution and URL normalization.

- [Pristine.Ports.RateLimit](Pristine.Ports.RateLimit.md): Rate limit boundary.

- [Pristine.Ports.ResultClassifier](Pristine.Ports.ResultClassifier.md): Classification boundary for normalized request outcomes.

- [Pristine.Ports.Retry](Pristine.Ports.Retry.md): Retry boundary for retrying operations.
- [Pristine.Ports.Semaphore](Pristine.Ports.Semaphore.md): Port for connection/concurrency limiting via semaphores.
- [Pristine.Ports.Serializer](Pristine.Ports.Serializer.md): Serialization boundary for request/response payloads.

- [Pristine.Ports.StreamTransport](Pristine.Ports.StreamTransport.md): Port for streaming HTTP transport.
- [Pristine.Ports.Streaming](Pristine.Ports.Streaming.md): Port for SSE decoding and streaming helpers.

- [Pristine.Ports.Telemetry](Pristine.Ports.Telemetry.md): Telemetry boundary for observability and metrics.
- [Pristine.Ports.TokenSource](Pristine.Ports.TokenSource.md): Boundary for retrieving and storing OAuth2 tokens.

- [Pristine.Ports.Tokenizer](Pristine.Ports.Tokenizer.md): Tokenizer boundary for encoding and decoding text.

- [Pristine.Ports.Transport](Pristine.Ports.Transport.md): Transport boundary for sending requests.

- [Pristine.Profiles.Foundation](Pristine.Profiles.Foundation.md): Internal Foundation-backed production profile wiring.
- [Pristine.Response](Pristine.Response.md): Public runtime response wrapper for execute and stream workflows.

- [Pristine.Runtime.Schema](Pristine.Runtime.Schema.md): Internal schema resolution and materialization helpers for runtime execution.

- [Pristine.RuntimeGateway](Pristine.RuntimeGateway.md): HTTP-family execution boundary for explicit local or Runtime Client placement.
- [Pristine.RuntimeGateway.Local](Pristine.RuntimeGateway.Local.md): Same-node HTTP-family gateway.
- [Pristine.RuntimeGateway.RuntimeClient](Pristine.RuntimeGateway.RuntimeClient.md): HTTP-family gateway backed only by an injected Execution Plane Runtime Client.
- [Pristine.SDK.Context](Pristine.SDK.Context.md): SDK-facing runtime context contract.
- [Pristine.SDK.Error](Pristine.SDK.Error.md): SDK-facing error contract for request execution.

- [Pristine.SDK.OpenAPI.Client](Pristine.SDK.OpenAPI.Client.md): SDK-facing request contracts for generated provider SDKs.

- [Pristine.SDK.ProviderProfile](Pristine.SDK.ProviderProfile.md): Provider-specific runtime profile for shared error normalization and result classification.

- [Pristine.SDK.Response](Pristine.SDK.Response.md): SDK-facing helper for constructing normalized transport responses.

- [Pristine.Streaming.Event](Pristine.Streaming.Event.md): Represents a Server-Sent Event (SSE).
- [Pristine.Streaming.SSEDecoder](Pristine.Streaming.SSEDecoder.md): Stateful decoder for Server-Sent Events (SSE) streams.

- Exceptions
  - [Pristine.Error](Pristine.Error.md): Structured error types for API responses.
  - [Pristine.OAuth2.Error](Pristine.OAuth2.Error.md): Error returned by the Pristine OAuth2 control-plane helpers.

