# SystemOneSDK v0.6.0 - Table of Contents

> Provider-neutral Elixir SDK for System One semantics, evaluation, batching, telemetry, and OTP integration.

## Pages

- Start Here
  - [Overview](readme.md)
  - [Guide Index](guide-index.md)
  - [Getting Started with 0.6.0](getting-started.md)

- Usage
  - [Client Configuration](client-configuration.md)
  - [Providers and contracts](providers-and-contracts.md)
  - [Generic System One endpoints](generic-endpoints.md)
  - [System One and Legacy Wire Questions](system-one-and-questions.md)
  - [Models](models.md)
  - [Errors And Retries](errors-and-retries.md)

- Semantic API
  - [Semantic Questions and Prepared Sets](semantic-questions.md)
  - [Answers, Distributions and Explicit Policy](answers-and-confidence.md)
  - [Batching and Lifecycle](batching.md)
  - [Application Testing Through the Real SDK](testing.md)

- Operations
  - [Privacy-Oriented Semantic Telemetry](telemetry.md)
  - [Runtime Bounds and Capability Audit](runtime-capabilities.md)
  - [Runtime controls and semantic contracts](runtime-controls.md)

- Patterns
  - [Confidence-Gated Routing](confidence-routing.md)
  - [Composite Scoring](composite-scoring.md)
  - [Speculative Read-Only Fan-Out](speculative-fan-out.md)
  - [Recursive Decision Patterns](recursive-decisions.md)
  - [Bounded OTP Server Integration](otp-server.md)
  - [Evaluating Model Judgments and Application Decisions](evaluating-decisions.md)

- Examples
  - [Live Example Catalog](live-example.md)
  - [Decision Evaluation Workflow](decision-evaluation.md)
  - [SystemOneSDK 0.6.0](system_one_sdk.md)

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

## Modules

- [SystemOneSDK.JSON](SystemOneSDK.JSON.md): JSON normalization for the semantic API, with collision detection and bounded nesting.
- [SystemOneSDK.Provider](SystemOneSDK.Provider.md): Runtime provider contract for System One execution.
- [SystemOneSDK.Providers.TypeSafe](SystemOneSDK.Providers.TypeSafe.md): Built-in TypeSafe provider backed by `TypeSafeAPISDK`.

- Semantic Questions
  - [SystemOneSDK.Prepared](SystemOneSDK.Prepared.md): A validated, immutable semantic question contract.
  - [SystemOneSDK.Question.Choice](SystemOneSDK.Question.Choice.md): Strict Choice with 2..255 alternatives and finite caller-key restoration.
  - [SystemOneSDK.Question.Noul](SystemOneSDK.Question.Noul.md): Strict semantic yes/no question. `new/2` returns a tuple; `new!/2` raises.
  - [SystemOneSDK.Question.Score](SystemOneSDK.Question.Score.md): Strict Score on 2..10 ordered levels.

- Semantic Helpers
  - [SystemOneSDK.Answer](SystemOneSDK.Answer.md): Uncertainty helpers with explicit application-owned policy thresholds.
  - [SystemOneSDK.Answer.Choice](SystemOneSDK.Answer.Choice.md): Read a Choice distribution without imposing routing policy.
  - [SystemOneSDK.Answer.Noul](SystemOneSDK.Answer.Noul.md): Noul decision helpers. The threshold is application policy, not a safety guarantee.
  - [SystemOneSDK.Answer.Score](SystemOneSDK.Answer.Score.md): Score distributions, rounded expectations, modal levels and normalization.
  - [SystemOneSDK.Response](SystemOneSDK.Response.md): Answer accessors and capped metadata for System One responses.

- Batch and Observability
  - [SystemOneSDK.Batch](SystemOneSDK.Batch.md): Lazy, bounded evaluation using an owned supervisor and unlinked tasks.
  - [SystemOneSDK.OTP.Server](SystemOneSDK.OTP.Server.md): Capped OTP facade for asynchronous System One evaluations inside a GenServer.
  - [SystemOneSDK.RuntimeCapabilities](SystemOneSDK.RuntimeCapabilities.md): Fail-closed runtime capability view across System One providers.
  - [SystemOneSDK.Telemetry](SystemOneSDK.Telemetry.md): Privacy-oriented semantic spans above Pristine's attempt telemetry.

- Testing and Contracts
  - [SystemOneSDK.Conformance](SystemOneSDK.Conformance.md): Reusable client/provider conformance gate for the rich SystemOneSDK surface.
  - [SystemOneSDK.Test](SystemOneSDK.Test.md): Explicit, isolated application fixtures at the Pristine transport seam.
  - [SystemOneSDK.Test.ContractError](SystemOneSDK.Test.ContractError.md): Raised when an explicit application test fixture contradicts the actual request.

- Client and Operations
  - [SystemOneSDK](SystemOneSDK.md): Provider-neutral System One semantics with a default hosted TypeSafe adapter.
  - [SystemOneSDK.Client](SystemOneSDK.Client.md): Provider-neutral System One client.
  - [SystemOneSDK.Models](SystemOneSDK.Models.md): Provider-neutral model catalog resource and pure catalog helpers.
  - [SystemOneSDK.Providers.Contract](SystemOneSDK.Providers.Contract.md): Adapter from an inference-side `SystemOneContracts.Provider` into the rich SDK.
  - [SystemOneSDK.Providers.Endpoint](SystemOneSDK.Providers.Endpoint.md): Generic System One v1 HTTP endpoint provider backed directly by Pristine.
  - [SystemOneSDK.SystemOne](SystemOneSDK.SystemOne.md): Provider-neutral raw System One API surface.

- Questions
  - [SystemOneSDK.Choice](SystemOneSDK.Choice.md): A question that selects one named alternative.
  - [SystemOneSDK.Noul](SystemOneSDK.Noul.md): A yes/no question with optional instructions and true/false descriptions.
  - [SystemOneSDK.NoulCriteria](SystemOneSDK.NoulCriteria.md): Type contract for optional descriptions of the true and false Noul outcomes.
  - [SystemOneSDK.Question](SystemOneSDK.Question.md): Question validation and legacy wire normalization. Strict evaluation uses `SystemOneSDK.Prepared`.
  - [SystemOneSDK.Score](SystemOneSDK.Score.md): A question that assigns a score from an ordered rubric.

- Responses
  - [SystemOneSDK.ChoiceAnswer](SystemOneSDK.ChoiceAnswer.md): A selected option, independent confidence and complete option distribution.
  - [SystemOneSDK.ListModelsResponse](SystemOneSDK.ListModelsResponse.md): Typed list of System One models available from a provider.
  - [SystemOneSDK.ModelMetadata](SystemOneSDK.ModelMetadata.md): Provider-neutral metadata for one System One model.
  - [SystemOneSDK.NoulAnswer](SystemOneSDK.NoulAnswer.md): A probability of true. Semantic evaluations also retain the caller ID and raw answer.
  - [SystemOneSDK.ScoreAnswer](SystemOneSDK.ScoreAnswer.md): An expected score, not necessarily the most probable level.
  - [SystemOneSDK.SystemOneResponse](SystemOneSDK.SystemOneResponse.md): Typed System One response with grouped convenience accessors.
  - [SystemOneSDK.Usage](SystemOneSDK.Usage.md): Token counts returned by the API when available.

- Errors and Configuration
  - [SystemOneSDK.Constants](SystemOneSDK.Constants.md): Public defaults and environment variable names shared with the Python SDK.
  - [SystemOneSDK.Error](SystemOneSDK.Error.md): Normalized System One SDK error.
  - [SystemOneSDK.RetryPolicy](SystemOneSDK.RetryPolicy.md): Retry configuration matching the public policy of the supplied Python SDK.

## Mix Tasks

- Maintenance Tasks
  - [mix typesafe.capabilities](Mix.Tasks.Typesafe.Capabilities.md): `mix typesafe.capabilities [--require unary_cancellation,cancellation_cleanup]`
  - [mix typesafe.record](Mix.Tasks.Typesafe.Record.md): `mix typesafe.record [--output tmp/live] [--baseline test/fixtures/live] [--base-url URL] [--model MODEL]`