# CliSubprocessCore v0.2.0 - Table of Contents

> Shared CLI subprocess runtime foundation with first-party common provider profiles.

## Pages

- Project Overview
  - [Overview](overview.md)

- Examples
  - [Examples](examples.md)

- Provider Profiles
  - [Provider Profile Contract](provider-profile-contract.md)
  - [Custom Provider Profiles](custom-provider-profiles.md)
  - [Built-In Provider Profiles](built-in-provider-profiles.md)
  - [Provider Feature Manifests](provider-feature-manifests.md)

- Developer Guides
  - [Developer Guide: Model Registry](developer-guide-model-registry.md)
  - [Developer Guide: Runtime Layers](developer-guide-runtime-layers.md)
  - [Developer Guide: Claude Backends](developer-guide-claude-backends.md)
  - [Developer Guide: Codex Backends](developer-guide-codex-backends.md)
  - [Developer Guide: Adding Transports](developer-guide-adding-transports.md)
  - [Developer Guide: Provider Profiles](developer-guide-provider-profiles.md)

- Runtime &amp; APIs
  - [Getting Started](getting-started.md)
  - [Execution Surface Compatibility](execution-surface-compatibility.md)
  - [Event And Payload Model](event-and-payload-model.md)
  - [Recovery Envelope](recovery-envelope.md)
  - [Command API](command-api.md)
  - [Raw Sessions And Transport](raw-transport.md)
  - [Channel API](channel-api.md)
  - [JSON-RPC](json-rpc.md)
  - [Session API](session-api.md)

- Operations &amp; Conformance
  - [Shutdown And Timeouts](shutdown-and-timeouts.md)
  - [Testing And Conformance](testing-and-conformance.md)

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

## Modules

- [CliSubprocessCore](CliSubprocessCore.md): Public entrypoints for the shared CLI subprocess runtime foundation.

- [CliSubprocessCore.AdapterSelectionPolicy](CliSubprocessCore.AdapterSelectionPolicy.md): Phase 6 adapter selection policy declaration for CLI runtime profiles.
- [CliSubprocessCore.Application](CliSubprocessCore.Application.md): OTP application supervision tree for the core runtime.

- [CliSubprocessCore.Channel](CliSubprocessCore.Channel.md): Generic long-lived CLI IO channel above the raw session layer.
- [CliSubprocessCore.Channel.Delivery](CliSubprocessCore.Channel.Delivery.md): Stable mailbox-delivery metadata for direct channel subscribers.

- [CliSubprocessCore.Command](CliSubprocessCore.Command.md): Normalized subprocess invocation data shared by provider profiles.
- [CliSubprocessCore.Command.Options](CliSubprocessCore.Command.Options.md): Validated command-lane options for provider-aware one-shot execution.

- [CliSubprocessCore.Command.RunResult](CliSubprocessCore.Command.RunResult.md): Core-owned result for provider-aware one-shot command execution.

- [CliSubprocessCore.CommandSpec](CliSubprocessCore.CommandSpec.md): Resolved subprocess program plus any argv prefix that must precede provider
arguments.
- [CliSubprocessCore.Event](CliSubprocessCore.Event.md): Normalized runtime event envelope emitted by the core session layer.

- [CliSubprocessCore.ExecutionSurface](CliSubprocessCore.ExecutionSurface.md): Backward-compatible execution-surface facade for downstream CLI packages.
- [CliSubprocessCore.GovernedAuthority](CliSubprocessCore.GovernedAuthority.md): Normalized materialized authority for governed CLI launch.
- [CliSubprocessCore.JSONRPC](CliSubprocessCore.JSONRPC.md): JSON-RPC helper on top of `CliSubprocessCore.ProtocolSession`.
- [CliSubprocessCore.LineageFact](CliSubprocessCore.LineageFact.md): Stable raw fact shapes for provider pressure, reconnect, and subprocess lineage.

- [CliSubprocessCore.LowerSimulationScenario](CliSubprocessCore.LowerSimulationScenario.md): Phase 6 lower simulation scenario declaration for CLI subprocess profiles.
- [CliSubprocessCore.ModelInput](CliSubprocessCore.ModelInput.md): Normalizes mixed model input into one authoritative model payload.
- [CliSubprocessCore.ModelRegistry](CliSubprocessCore.ModelRegistry.md): Canonical model resolution, validation, and argument payload construction.
- [CliSubprocessCore.ModelRegistry.Model](CliSubprocessCore.ModelRegistry.Model.md): Canonical model metadata loaded by `CliSubprocessCore.ModelRegistry`.

- [CliSubprocessCore.ModelRegistry.Selection](CliSubprocessCore.ModelRegistry.Selection.md): Resolved model selection returned by `CliSubprocessCore.ModelRegistry`.

- [CliSubprocessCore.Ollama](CliSubprocessCore.Ollama.md): Ollama HTTP integration used by model validation and backend resolution.
- [CliSubprocessCore.Payload](CliSubprocessCore.Payload.md): Namespace for the normalized runtime payload structs emitted by the core.

- [CliSubprocessCore.Payload.ApprovalRequested](CliSubprocessCore.Payload.ApprovalRequested.md): Represents an approval request emitted by a provider CLI.
- [CliSubprocessCore.Payload.ApprovalResolved](CliSubprocessCore.Payload.ApprovalResolved.md): Represents an approval decision.
- [CliSubprocessCore.Payload.AssistantDelta](CliSubprocessCore.Payload.AssistantDelta.md): Represents a streamed assistant delta.
- [CliSubprocessCore.Payload.AssistantMessage](CliSubprocessCore.Payload.AssistantMessage.md): Represents a completed assistant message.
- [CliSubprocessCore.Payload.CostUpdate](CliSubprocessCore.Payload.CostUpdate.md): Represents token and cost accounting updates.
- [CliSubprocessCore.Payload.Error](CliSubprocessCore.Payload.Error.md): Represents a normalized runtime error.
- [CliSubprocessCore.Payload.Raw](CliSubprocessCore.Payload.Raw.md): Represents an unnormalized raw provider payload.
- [CliSubprocessCore.Payload.Result](CliSubprocessCore.Payload.Result.md): Represents the terminal result of a provider CLI run.
- [CliSubprocessCore.Payload.RunStarted](CliSubprocessCore.Payload.RunStarted.md): Marks the start of a provider CLI run.
- [CliSubprocessCore.Payload.Stderr](CliSubprocessCore.Payload.Stderr.md): Represents stderr output emitted by a provider CLI.
- [CliSubprocessCore.Payload.Thinking](CliSubprocessCore.Payload.Thinking.md): Represents provider thinking output.
- [CliSubprocessCore.Payload.ToolResult](CliSubprocessCore.Payload.ToolResult.md): Represents a tool invocation result.
- [CliSubprocessCore.Payload.ToolUse](CliSubprocessCore.Payload.ToolUse.md): Represents a tool invocation request.
- [CliSubprocessCore.Payload.UserMessage](CliSubprocessCore.Payload.UserMessage.md): Represents normalized user input.
- [CliSubprocessCore.ProcessExit](CliSubprocessCore.ProcessExit.md): Facade helpers for normalized process exits returned by core-owned lanes.
- [CliSubprocessCore.ProtocolAdapter](CliSubprocessCore.ProtocolAdapter.md): Pure codec and protocol-state boundary used by `CliSubprocessCore.ProtocolSession`.
- [CliSubprocessCore.ProtocolSession](CliSubprocessCore.ProtocolSession.md): Generic protocol-session runtime above `CliSubprocessCore.Channel`.
- [CliSubprocessCore.ProviderCLI](CliSubprocessCore.ProviderCLI.md): Shared provider-specific CLI resolution policies for the core runtime.
- [CliSubprocessCore.ProviderFeatures](CliSubprocessCore.ProviderFeatures.md): Canonical provider feature metadata for the built-in CLI profiles.
- [CliSubprocessCore.ProviderProfile](CliSubprocessCore.ProviderProfile.md): Behaviour contract for built-in and external provider CLI profiles.

- [CliSubprocessCore.ProviderProfiles.Amp](CliSubprocessCore.ProviderProfiles.Amp.md): Built-in provider profile for the common Amp CLI runtime.

- [CliSubprocessCore.ProviderProfiles.Antigravity](CliSubprocessCore.ProviderProfiles.Antigravity.md): Built-in provider profile for the Antigravity CLI (`agy`).
- [CliSubprocessCore.ProviderProfiles.Claude](CliSubprocessCore.ProviderProfiles.Claude.md): Built-in provider profile for the common Claude CLI runtime.

- [CliSubprocessCore.ProviderProfiles.Codex](CliSubprocessCore.ProviderProfiles.Codex.md): Built-in provider profile for the common Codex CLI runtime.

- [CliSubprocessCore.ProviderProfiles.Cursor](CliSubprocessCore.ProviderProfiles.Cursor.md): Built-in provider profile for the Cursor Agent CLI (`agent`).
- [CliSubprocessCore.ProviderRegistry](CliSubprocessCore.ProviderRegistry.md): Registry of provider profile modules available to the core runtime.

- [CliSubprocessCore.ProviderRuntimeProfile](CliSubprocessCore.ProviderRuntimeProfile.md): Application-configured provider runtime profile selection.
- [CliSubprocessCore.RawSession](CliSubprocessCore.RawSession.md): Provider-agnostic handle for long-lived raw subprocess sessions.
- [CliSubprocessCore.RawSession.Delivery](CliSubprocessCore.RawSession.Delivery.md): Stable mailbox-delivery metadata for raw-session consumers.
- [CliSubprocessCore.RecoveryEnvelope](CliSubprocessCore.RecoveryEnvelope.md): Normalized recoverability facts for provider and transport failures.
- [CliSubprocessCore.Runtime](CliSubprocessCore.Runtime.md): Runtime state helpers for normalized session event emission.

- [CliSubprocessCore.Schema](CliSubprocessCore.Schema.md): Canonical schema helpers and shared validation error types for common-lane
dynamic boundaries.

- [CliSubprocessCore.Session](CliSubprocessCore.Session.md): Common CLI session runtime above the raw transport layer.

- [CliSubprocessCore.Session.Delivery](CliSubprocessCore.Session.Delivery.md): Stable mailbox-delivery metadata for direct session subscribers.
- [CliSubprocessCore.Session.Options](CliSubprocessCore.Session.Options.md): Validated startup options for the common session engine.

- [CliSubprocessCore.TaskSupport](CliSubprocessCore.TaskSupport.md): Small task helpers shared by the runtime and transport layers.

- [CliSubprocessCore.TestSupport.FakeSSH](CliSubprocessCore.TestSupport.FakeSSH.md): Canonical fake-SSH parity harness for exercising the real execution-surface
path without injecting fake transport implementations.
- [CliSubprocessCore.TestSupport.LiveSSH](CliSubprocessCore.TestSupport.LiveSSH.md): Shared config-driven helpers for opt-in live SSH execution-surface tests.
- [CliSubprocessCore.Tool](CliSubprocessCore.Tool.md): Neutral, serializable tool data used by the common CLI runtime.
- [CliSubprocessCore.Tool.Descriptor](CliSubprocessCore.Tool.Descriptor.md): Serializable description of a tool contract.

- [CliSubprocessCore.Tool.Request](CliSubprocessCore.Tool.Request.md): Serializable tool request data normalized by the core.

- [CliSubprocessCore.Tool.Response](CliSubprocessCore.Tool.Response.md): Serializable tool response data normalized by the core.

- [CliSubprocessCore.TransportError](CliSubprocessCore.TransportError.md): Facade helpers for transport errors returned by core-owned lanes.
- [CliSubprocessCore.TransportInfo](CliSubprocessCore.TransportInfo.md): Facade helpers for transport metadata snapshots returned by core-owned lanes.

- Exceptions
  - [CliSubprocessCore.Command.Error](CliSubprocessCore.Command.Error.md): Structured failures for the provider-aware non-PTY command lane.

  - [CliSubprocessCore.ProviderCLI.Error](CliSubprocessCore.ProviderCLI.Error.md): Exception returned when provider CLI resolution fails.

  - [CliSubprocessCore.ProviderCLI.ErrorRuntimeFailure](CliSubprocessCore.ProviderCLI.ErrorRuntimeFailure.md): Structured provider CLI runtime failure.

