# backplane_agent_runtime v1.10.52 - Table of Contents

> Embedded Elixir/OTP runtime and opt-in tools for bounded independent agents.

## Pages

- [Backplane Agent Runtime](readme.md)
- [Codex Tool Profiles](codex.md)
- [Linux PTY native helper](native-pty.md)
- [Embedded execution](embedding.md)
- [Agent runtime persistence adapter](persistence.md)
- [Tool Input Schemas](schemas.md)
- [Changelog](changelog.md)

## Modules

- [Backplane.AgentRuntime.AgentHost](Backplane.AgentRuntime.AgentHost.md): Runtime instance agent registry for hosted and owner-bound identities.
- [Backplane.AgentRuntime.Application](Backplane.AgentRuntime.Application.md)
- [Backplane.AgentRuntime.Approval](Backplane.AgentRuntime.Approval.md): Approval contracts for Backplane agent runtime.
- [Backplane.AgentRuntime.Attempt](Backplane.AgentRuntime.Attempt.md): Attempt identity and bounded retry accounting.
- [Backplane.AgentRuntime.Budget](Backplane.AgentRuntime.Budget.md): Finite root budgets and idempotent work reservations.
- [Backplane.AgentRuntime.Codex](Backplane.AgentRuntime.Codex.md): Public entry point for explicit, host-configured Codex tool profiles.
- [Backplane.AgentRuntime.Codex.ApplyPatch](Backplane.AgentRuntime.Codex.ApplyPatch.md): Structured, workspace-confined application of Codex patch operations.
- [Backplane.AgentRuntime.Codex.Catalog](Backplane.AgentRuntime.Codex.Catalog.md): Codex projection over the existing strict runtime catalog.

- [Backplane.AgentRuntime.Codex.CodeMode](Backplane.AgentRuntime.Codex.CodeMode.md): Opt-in, capability-limited JavaScript Code Mode.
- [Backplane.AgentRuntime.Codex.CodeMode.Worker](Backplane.AgentRuntime.Codex.CodeMode.Worker.md)
- [Backplane.AgentRuntime.Codex.ContextTools](Backplane.AgentRuntime.Codex.ContextTools.md): Context window operations which preserve run-owned resources and authority.

- [Backplane.AgentRuntime.Codex.Contract](Backplane.AgentRuntime.Codex.Contract.md): Provider-neutral representation of a Codex callable tool.
- [Backplane.AgentRuntime.Codex.Control](Backplane.AgentRuntime.Codex.Control.md): Pinned interactive, permission, environment, and context control tools.
- [Backplane.AgentRuntime.Codex.Dynamic](Backplane.AgentRuntime.Codex.Dynamic.md): Host-mediated dynamic Codex catalog.
- [Backplane.AgentRuntime.Codex.DynamicRuntime](Backplane.AgentRuntime.Codex.DynamicRuntime.md): Host-mediated MCP resources, deferred tool publication, and plugin requests.
- [Backplane.AgentRuntime.Codex.ExtensionRuntime](Backplane.AgentRuntime.Codex.ExtensionRuntime.md): Owner-bound runtime for the pinned Codex stateful extension tools.
- [Backplane.AgentRuntime.Codex.Extensions](Backplane.AgentRuntime.Codex.Extensions.md): Scoped, ephemeral reference backends for Codex stateful extensions.
- [Backplane.AgentRuntime.Codex.Headless](Backplane.AgentRuntime.Codex.Headless.md): One host-authored Code Mode occurrence owned by the existing Conversation.
- [Backplane.AgentRuntime.Codex.Hosted](Backplane.AgentRuntime.Codex.Hosted.md): Provider-hosted capability negotiation and observation boundary.

- [Backplane.AgentRuntime.Codex.Image](Backplane.AgentRuntime.Codex.Image.md): Host-configured image-generation adapter; no local fake executor.
- [Backplane.AgentRuntime.Codex.Interactions](Backplane.AgentRuntime.Codex.Interactions.md): Host-owned interaction ledger for Codex user input and messages.
- [Backplane.AgentRuntime.Codex.Invocation](Backplane.AgentRuntime.Codex.Invocation.md): Lossless decoding of Codex function and custom/raw tool calls.
- [Backplane.AgentRuntime.Codex.MultiAgent](Backplane.AgentRuntime.Codex.MultiAgent.md): Supervised Codex V1/V2 collaboration runtime.
- [Backplane.AgentRuntime.Codex.PathGuard](Backplane.AgentRuntime.Codex.PathGuard.md): Canonical, symlink-aware containment for Codex workspace paths.
- [Backplane.AgentRuntime.Codex.Permissions](Backplane.AgentRuntime.Codex.Permissions.md): Host-mediated permission requests and capability grants.

- [Backplane.AgentRuntime.Codex.Profile](Backplane.AgentRuntime.Codex.Profile.md): Builds explicit host-authored Codex profiles through strict catalog admission.
- [Backplane.AgentRuntime.Codex.Readiness](Backplane.AgentRuntime.Codex.Readiness.md): Host-provided readiness and authorization gate with cancellable waits.

- [Backplane.AgentRuntime.Codex.Reconciliation](Backplane.AgentRuntime.Codex.Reconciliation.md): Explicit, observation-only reconciliation of fenced runtime lifetimes.
- [Backplane.AgentRuntime.Codex.Reconciliation.Adapter](Backplane.AgentRuntime.Codex.Reconciliation.Adapter.md): Trusted host storage for immutable recovery evidence and separate closure receipts.
- [Backplane.AgentRuntime.Codex.ResourceRegistry](Backplane.AgentRuntime.Codex.ResourceRegistry.md): Process-local run resources with owner/incarnation fencing and bounded cleanup.
- [Backplane.AgentRuntime.Codex.Result](Backplane.AgentRuntime.Codex.Result.md): Provider-facing result shaping without discarding structured content.

- [Backplane.AgentRuntime.Codex.Services](Backplane.AgentRuntime.Codex.Services.md): Explicit opt-in service-backed Codex profile.
- [Backplane.AgentRuntime.Codex.Session](Backplane.AgentRuntime.Codex.Session.md): Host-owned resource lifetime across distinct, bounded Conversation runs.
- [Backplane.AgentRuntime.Codex.Tools](Backplane.AgentRuntime.Codex.Tools.md): Pinned local Codex tool contracts and executable host adapters.
- [Backplane.AgentRuntime.Codex.Web](Backplane.AgentRuntime.Codex.Web.md): Bounded, host-authorized HTTP fetch adapter for Codex service tools.
- [Backplane.AgentRuntime.Collaboration](Backplane.AgentRuntime.Collaboration.md): Host-controlled, opt-in collaboration operations.
- [Backplane.AgentRuntime.Command](Backplane.AgentRuntime.Command.md): Authorized command execution with environment allowlists and output caps.
- [Backplane.AgentRuntime.Context](Backplane.AgentRuntime.Context.md): Versioned context ownership and composition.
- [Backplane.AgentRuntime.Conversation](Backplane.AgentRuntime.Conversation.md): Single authoritative owner of a bounded embedded conversation.
- [Backplane.AgentRuntime.ConversationAdapter](Backplane.AgentRuntime.ConversationAdapter.md): Host boundaries for `Backplane.AgentRuntime.Conversation`.
- [Backplane.AgentRuntime.Dependency](Backplane.AgentRuntime.Dependency.md): Peer run dependency waits and cycle/held-context rejection.
- [Backplane.AgentRuntime.EphemeralStore](Backplane.AgentRuntime.EphemeralStore.md): In-memory runtime store for tests and transient embedded runs.
- [Backplane.AgentRuntime.Error](Backplane.AgentRuntime.Error.md)
- [Backplane.AgentRuntime.Event](Backplane.AgentRuntime.Event.md): Deterministic canonical event envelopes with per-aggregate sequences.
- [Backplane.AgentRuntime.EventStream](Backplane.AgentRuntime.EventStream.md): Per-aggregate ordered event projection and bounded cursor replay.
- [Backplane.AgentRuntime.Execution](Backplane.AgentRuntime.Execution.md): Store-first runtime execution boundary.
- [Backplane.AgentRuntime.ExecutionController](Backplane.AgentRuntime.ExecutionController.md): One-run control owner that keeps store and backend work outside callbacks.
- [Backplane.AgentRuntime.Goal](Backplane.AgentRuntime.Goal.md): Optional persistent thread goal owner. Host owns storage, user provenance and ordinary Session admission.
- [Backplane.AgentRuntime.Goal.Host](Backplane.AgentRuntime.Goal.Host.md): Host provenance and fast atomic admission through the existing thread/session owner.
- [Backplane.AgentRuntime.Goal.State](Backplane.AgentRuntime.Goal.State.md): Pure thread goal transitions and committed, idempotent accounting.
- [Backplane.AgentRuntime.Goal.Store](Backplane.AgentRuntime.Goal.Store.md): Host-owned durable thread records; CAS atomically stores goals and receipt fences.
- [Backplane.AgentRuntime.ID](Backplane.AgentRuntime.ID.md)
- [Backplane.AgentRuntime.Inbox](Backplane.AgentRuntime.Inbox.md): Bounded receiver inbox with payload-digest deduplication.
- [Backplane.AgentRuntime.InputSchema](Backplane.AgentRuntime.InputSchema.md): JSON Schema Draft 2020-12 boundary for MCP tool arguments.
- [Backplane.AgentRuntime.Kernel](Backplane.AgentRuntime.Kernel.md): Deterministic execution kernel for Backplane agent runtime runs.
- [Backplane.AgentRuntime.LoopBreaker](Backplane.AgentRuntime.LoopBreaker.md): Normalized fingerprints for repeated model/tool/delegation work.
- [Backplane.AgentRuntime.Message](Backplane.AgentRuntime.Message.md): Typed runtime messages with trusted provenance and bounded payload/TTL.
- [Backplane.AgentRuntime.Outbox](Backplane.AgentRuntime.Outbox.md): Sender-intent outbox with idempotency and bounded replay.
- [Backplane.AgentRuntime.Plan](Backplane.AgentRuntime.Plan.md): Host-started task-scoped plan document with expected-revision replacement.

- [Backplane.AgentRuntime.Plugins.Backend](Backplane.AgentRuntime.Plugins.Backend.md): Executes an admitted plugin tool within its owning run.
- [Backplane.AgentRuntime.Plugins.MCP](Backplane.AgentRuntime.Plugins.MCP.md): Session-owned MCP connections using Backplane's shared protocol client.
- [Backplane.AgentRuntime.Plugins.Session](Backplane.AgentRuntime.Plugins.Session.md): Activates one immutable plugin installation for one run.
- [Backplane.AgentRuntime.Policy](Backplane.AgentRuntime.Policy.md): Runtime policy enforcement for Backplane agent runtime.
- [Backplane.AgentRuntime.Provider](Backplane.AgentRuntime.Provider.md): ProviderPort boundary for Backplane agent runtime.

- [Backplane.AgentRuntime.Recovery](Backplane.AgentRuntime.Recovery.md): Conservative recovery classification for committed nonterminal work.
- [Backplane.AgentRuntime.RecoveryHarness](Backplane.AgentRuntime.RecoveryHarness.md): Generic durable recovery and storage conformance harness.
- [Backplane.AgentRuntime.Resource](Backplane.AgentRuntime.Resource.md): Scoped resource operations with revision-safe writes and bounded output.
- [Backplane.AgentRuntime.RunTree](Backplane.AgentRuntime.RunTree.md): Run-owned child relationships and cancellation propagation.
- [Backplane.AgentRuntime.Scheduler](Backplane.AgentRuntime.Scheduler.md): Bounded work admission with explicit overload.
- [Backplane.AgentRuntime.Store](Backplane.AgentRuntime.Store.md): Runtime storage contract for versioned run transitions.
- [Backplane.AgentRuntime.StoreConformance](Backplane.AgentRuntime.StoreConformance.md): Reusable executable contract for host-provided durable stores.
- [Backplane.AgentRuntime.Subscriber](Backplane.AgentRuntime.Subscriber.md): Bounded event subscriptions with cursor retention and gap markers.
- [Backplane.AgentRuntime.ToolCatalog](Backplane.AgentRuntime.ToolCatalog.md): Validates complete, host-authored tool catalog revisions for a Conversation.
- [Backplane.AgentRuntime.ToolEffects](Backplane.AgentRuntime.ToolEffects.md): Tool effects and cancellation boundary for Backplane agent runtime.

- [Backplane.AgentRuntime.ToolEffects.AggregateCancellation](Backplane.AgentRuntime.ToolEffects.AggregateCancellation.md): Exact sealed sequential resource inventory, independent of single-request cancellation.
- [Backplane.AgentRuntime.ToolEffects.Cancellation](Backplane.AgentRuntime.ToolEffects.Cancellation.md): Exact trusted local cancellation evidence; never a remote rollback receipt.
- [Backplane.AgentRuntime.ToolEffects.ClockCancellation](Backplane.AgentRuntime.ToolEffects.ClockCancellation.md): Exact owned native clock wait retirement.
- [Backplane.AgentRuntime.ToolEffects.EventsCancellation](Backplane.AgentRuntime.ToolEffects.EventsCancellation.md): Exact tracked Events retirement, independent of resource cancellation.
- [Backplane.AgentRuntime.ToolEffects.Presentation](Backplane.AgentRuntime.ToolEffects.Presentation.md): A trusted backend's invocation-bound result and consumer presentation.
- [Backplane.AgentRuntime.ToolEffects.Rejection](Backplane.AgentRuntime.ToolEffects.Rejection.md): Invocation-bound assertion from a trusted backend that no tool was dispatched.
- [Backplane.AgentRuntime.ToolEffects.Retirement](Backplane.AgentRuntime.ToolEffects.Retirement.md): Typed native observation retirement; business outcome remains unknown.
- [Backplane.AgentRuntime.ToolRegistry](Backplane.AgentRuntime.ToolRegistry.md): Versioned tool registry for Backplane agent runtime.

- [Backplane.AgentRuntime.Tools](Backplane.AgentRuntime.Tools.md): Backend-conditional optional tool family wrappers.
- [Backplane.AgentRuntime.Tools.LocalCommand](Backplane.AgentRuntime.Tools.LocalCommand.md): Linux local command backend with verified process-group cleanup.
- [Backplane.AgentRuntime.Tools.LocalResource](Backplane.AgentRuntime.Tools.LocalResource.md): Local workspace resource adapter with coordinated revision writes.
- [Backplane.AgentRuntime.Types](Backplane.AgentRuntime.Types.md)
- [Backplane.AgentRuntime.Usage](Backplane.AgentRuntime.Usage.md): Attempt-attributed usage accounting without double counting.

## Mix Tasks

- [mix backplane.pty.build](Mix.Tasks.Backplane.Pty.Build.md): Builds the packaged C11 source for the current Linux target and verifies real
PTY/pidfd capabilities. Ordinary compilation does not invoke this task.
Requires a C compiler and Linux headers. Honors the trusted `CC` environment.

