# omp-spt — glossary

> Authoritative for meaning (grill-with-docs convention). Glossary only — no
> implementation detail. Decisions and rationale live in `SCOPE.md` and `docs/adr/`.

## Product and topologies

**omp-spt** — the OMP-native harness adapter for spt-core. The repository,
registered adapter, and consolidated adapter executable share this identity.
_Avoid_: spt-claude-code, claude-spt, omps

**OMP** — the Oh My Pi terminal coding agent that omp-spt integrates with.
Use **OMP** for the product or UI and `omp` for its executable.
_Avoid_: Claude Code, CC

**native OMP endpoint** — an spt-hosted endpoint where `omp` owns a broker-held
terminal and loads the **OMP SPT extension**. It may run unattended, but its
native TUI remains attachable whenever an operator needs to observe or control it.
_Avoid_: RPC bridge endpoint, non-interactive endpoint

**OMP SPT extension** — the OMP runtime extension that binds a native OMP
session to an SPT endpoint and owns message delivery, activity, replies, and
lifecycle integration. It does not render or proxy the terminal.
_Avoid_: Claude hook, RPC host, terminal bridge

**ready OMP endpoint** — a native OMP endpoint that receives SPT messages
without a Psyche.
_Avoid_: OMP Worker

**live OMP endpoint** — a native OMP endpoint whose SPT lifecycle includes a
Psyche and durable mind continuity.
_Avoid_: OMP Worker, treating every ready endpoint as live

**session activation** — binding an ordinary, already-open OMP session as a
ready OMP endpoint or live OMP endpoint. Activation establishes the immutable
endpoint/session relationship; it does not permit later switching or rebinding.
_Avoid_: requiring every endpoint to originate from `spt endpoint create`,
in-session endpoint switching

**live auto-resume** — an explicit session-activation path that selects the
most-recently-active compatible live endpoint when no endpoint id is supplied.
Outside that explicit path, activation requires selecting or creating an id and
never guesses identity silently.
_Avoid_: implicit most-recent selection, deriving identity from the OMP session


**endpoint activity state** — spt-core's published busy/idle record of the
agent's actual harness state. It is routing control, not telemetry:
`--active-only` can enter only through a busy boundary and `--idle-only` can
wake only after an idle transition. The extension keeps it synchronized with
OMP's authoritative activity signal.
_Avoid_: advisory presence, terminal-quiescence inference, eventually-consistent
busy/idle reporting, adapter-side serialization over spt-core's API


**delivery-degraded endpoint** — a live endpoint whose OMP work continues while
activity publication or inbound polling is temporarily unavailable. Its cyan
identity remains visible with the warning suffix ` · comms recovering...`;
constrained messages remain in spt-core custody until synchronization recovers.
_Avoid_: replacing endpoint identity with an error, healthy-looking divergence,
stopping local agent work, technical diagnostics in the footer

**busy delivery** — delivery accepted while an agent turn is active. It joins
that existing turn at its next safe model boundary and never wakes the endpoint
or starts a separate turn.
_Avoid_: active wake, nested turn, busy next-turn delivery

**idle delivery** — delivery accepted while no agent turn is active. It wakes
the endpoint and opens one ordinary model turn for the accepted message.
_Avoid_: steering an absent turn, treating idle delivery as busy injection

**safe-boundary delivery** — delivery of a listener event already steered onto
an active OMP turn, or of `api poll` output read at an active context boundary,
before the next tool or model continuation. Listener and poll remain independent
surfaces; the adapter neither batches them nor invents cross-channel ordering.
If a steered listener event finds no injectable boundary, it becomes ordinary
idle delivery after the active turn ends rather than interrupting it.
_Avoid_: synthetic delivery batches, cross-channel chronology, arbitrary event
injection, forced turn interruption

**message stub** — the short turn-opening prompt `<msg from="…"/>` used for
an inbound peer message while the full SPT event envelope enters the same model
turn as extension-provided context. The peer body is never interpreted as an
OMP slash command.
_Avoid_: typing the peer body directly into the OMP editor

**bound OMP session** — the single OMP session owned by a native OMP endpoint
for that endpoint's lifetime. Switching or resuming to another OMP session
requires stopping and relaunching the endpoint rather than mutating the binding
inside the TUI.
_Avoid_: treating the endpoint id as a movable session selector

**OMP-native checkpoint** — an agent-driven continuity transition that saves
the current live context, resets OMP context through native session APIs, and
wakes the same endpoint from the saved state without operator intervention.
_Avoid_: Claude `/clear` keystroke choreography, save-only checkpoint



**durable role** — the endpoint's persistent statement of purpose and optional
service description. The OMP-native role skill may inspect it, rewrite it from
a directive, or open an interactive draft when no directive is supplied.
_Avoid_: transient prompt persona, OMP profile


**OMP SPT setup** — the agent-facing readiness flow that diagnoses and
completes OMP, spt-core, GitHub transport, omp-spt activation, and requested
subnet onboarding from an ordinary OMP session. Operator-only authentication
remains an explicit handoff, not a silently skipped setup step.
_Avoid_: documentation-only setup, separate plugin bootstrap


**startup brief** — concise adapter-authored context supplied when an OMP
session activates, teaching identity, roster, messaging, continuity, and
lifecycle operations that the session can perform through public `spt` commands.
It is guidance, not a parallel command or transport layer.
_Avoid_: skill emulation, full CLI reference injection

**update notice** — concise agent-facing context emitted when the active
spt-core or omp-spt version is known to trail an available compatible release.
It identifies the affected component and the public update command.
_Avoid_: silent background update, generic startup announcement


**commune** — an agent-authored continuity drop that updates a live endpoint's
durable mind without ending the endpoint. Its explicit checkpoint mode performs
the save step of an OMP-native checkpoint.
_Avoid_: signoff, generic project notes


**signoff** — an agent-authored final continuity drop followed by graceful
endpoint shutdown. The OMP-native signoff skill keeps final context explicit
rather than relying solely on automatic echo-commune.
_Avoid_: commune, forced endpoint stop


**peer-message shortform** — the explicit assistant-output form
`@<target[,target] message @>` that dispatches the enclosed message to the named
SPT endpoints after the OMP turn. It is a deliberate side effect, not ordinary
prose containing an `@` mention.
_Avoid_: harness-specific alternate syntax, implicit mention dispatch


**targeted hint** — concise adapter-authored context injected when a user turn
clearly concerns live activation, identity, messaging, subnet onboarding, or
checkpointing. A hint points to the canonical capability without replacing its
full instructions.
_Avoid_: fuzzy general coaching, full skill-body injection


**receivability** — the state in which a bound OMP endpoint can accept and
deliver another peer message. Cancellation, interruption, or failed turns must
restore receivability automatically after settling affected delivery custody,
unless listener recovery itself exhausts and closes the endpoint.
_Avoid_: stale busy state, best-effort recovery

**continuity drop** — a project-local commune or signoff file written under
`.spt/` for spt-core to ingest into an endpoint's durable mind. The directory is
harness-neutral; the filename identifies the endpoint and drop kind.
_Avoid_: OMP config, `.claude` state

**claude-spt** — the sister Claude Code adapter from which omp-spt was forked.
Its plugin, hooks, ccs profiles, and Claude-specific lifecycle are lineage, not
supported omp-spt surfaces. Its development lives in the private
`BigscreenVR/claude-spt-bs` repo (omp-spt's `upstream` remote); the public
`SaberMage/claude-spt` repo is a per-release source-only mirror, not a release
channel.
_Avoid_: treating claude-spt behavior as omp-spt capability, treating the
public claude-spt repo as its development home


**capability parity** — omp-spt provides the same user outcome as claude-spt,
including agent-facing outcomes, through the best OMP-native surface or a
discoverable public `spt` command. It does not require matching Claude command
names or implementation mechanisms.
_Avoid_: command-for-command parity, core-only parity, source parity

**parity seam** — the harness-native interaction boundary that best supplies a
missing capability, such as a startup brief, skill, extension event, or public
`spt` command. The seam is selected per capability rather than imposed on the
whole parity program.
_Avoid_: universal skill layer, universal startup injection