Module runtime 

Primitive live-runtime contracts and the Codex app-server reference adapter.

These APIs control harness-native sessions; they do not emulate terminal keystrokes and do not claim to attach to an arbitrary already-running TUI.

Structs

AcpRuntimeBackend

Generic ACP v1 client backend for any ACP agent command.

BearerToken

Bearer credential whose Debug output never contains the secret.

ClaudeCodeRuntimeBackend

Claude Code live-runtime backend using bidirectional stream-json print mode with supercode registered as the CLI’s permission handler.

CodexRuntimeBackend

Codex live-runtime backend using the official codex app-server JSONL protocol (initialize, thread/start|resume, turn/start|interrupt).

HarnessEvent

Protocol-neutral envelope around a native live event.

HostedHarnessConnection

SDK connection to a hosted native runtime. Closing it shuts down the owner runtime; terminal HTTP attachments are non-owning frontend leases.

HostedHarnessRuntime

Shared owner of a single harness-native runtime.

McpServerLaunch

One stdio MCP server the caller wants mounted into the session it is starting. Uniform shape; each backend translates it into whatever its own harness accepts (the ACP backend into session/new’s mcpServers).

OpenCodeRuntimeBackend

OpenCode live-runtime backend using its official HTTP API and SSE event stream. OpenCodeRuntimeBackend::connect can join the server embedded in an already-running TUI when that TUI was launched with a known host/port.

PiRuntimeBackend

Pi live-runtime backend using pi --mode rpc JSONL.

ResolvedRuntimeConnection

Endpoint and credential resolved from a RuntimeConnectLaunch.

RuntimeAttachRequest

Request to resume or attach through a new adapter connection.

RuntimeCapabilities

Mechanical facts an adapter can guarantee.

RuntimeConnectLaunch

Connect to an already-running harness endpoint instead of spawning one.

RuntimeHandle

Identity returned after a live session is started or resumed.

RuntimeInput

User input accepted by a live runtime.

RuntimeLaunch

Executable configuration used to launch one adapter endpoint.

RuntimeStartRequest

Request to create a fresh runtime session.

SupercodeHttpRuntimeBackend

Adapter that joins one authenticated Supercode SDK runtime without taking ownership of the process or creating a second model loop.

Enums

RuntimeEndpoint

Observable endpoint backing a runtime connection.

Traits

RuntimeBackend

Factory for starting, resuming, and (where the native protocol permits it) joining one harness’s already-running runtime endpoint.

RuntimeConnection

One connected harness-native runtime session.