Skip to main content

Crate subc_control

Crate subc_control 

Source
Expand description

Client-facing subc channel-0 control wire shapes.

This crate is the client ↔ subc control-plane boundary. It depends only on [subc-protocol] for shared primitives such as RouteTarget and BindIdentity; clients can use it without depending on the daemon implementation.

Modules§

ops
Reserved dotted operation prefixes for the v0.4 control vocabulary.

Structs§

ActivityActor
Verified identity stamped by the daemon, not supplied by a recording module.
ActivityCursor
A live-feed position. Query continuation positions are sequence numbers only.
ActivityEntry
One durably appended event. prev is reserved for a future hash chain and is deliberately absent from this format. Identity is (daemon_incarnation, seq), and entries are ordered by seq rather than by their wall-clock timestamps.
ActivityQueryRequest
Filter a newest-first scan. cursor is exclusive: only lower seqs follow it.
ActivityQueryResponse
A page plus the current incarnation’s head at scan capture, even on an empty page. Subscribe from head to move from the scan to live entries without a gap.
ActivityRecordRequest
Report an event. Shape checking lives here; kind, size, ownership and rate validation remain the daemon’s responsibility. There is no actor field.
ActivityRecordResponse
Sent only after the assigned sequence has been durably appended.
ActivityRoute
A route binding owned by the recording module, checked at this epoch.
ActivityScope
A live scope owned by the recording module, checked at this epoch.
ActivitySubject
A short typed pointer, never a secret value.
ActivitySubscribeRequest
Replay after since and remain open for live entries. A refused or lagged feed ends with an Error frame carrying one of the activity refusal-code constants.
ActivitySubscribeResponse
One successful append delivered on the subscription’s correlation id. There is no separate acknowledgement; each response is one streamed entry.
AppOpenReply
A successful app.open reply.
AppOpenRequest
Ask the daemon to start the operator app named app.
BusyGaugeReading
A declared busy gauge’s last reading from the daemon’s health cache.
CapabilityRequirementStatus
CatalogEntry
A registered module’s catalog projection.
ChildResourceReading
One reading of a module process’s memory and CPU time.
ConnectionDescribeReply
The daemon’s current view of the caller’s connection.
ConnectionDescribeRequest
Ask the daemon what it knows about this connection.
ConsumerIdentity
Daemon-spawned consumer identity presented on route.open.
DaemonBuildProvenance
Build metadata embedded in the daemon binary.
DaemonObservedProcess
Runtime process facts observed for the daemon itself.
LiveSpawn
One process present in an atomic supervisor spawn snapshot.
NotReadyReason
Why a registered module is not accepting new route binds.
OrderedJsonObject
Ordered JSON members retained for an unknown tagged value.
PendingReloadVerdict
Independent comparisons of configured path, launch spec and running image at list time. An absent verdict means the daemon predates this field, not agreement.
RescanExpect
What must still match for the daemon to accept an apply of this preview, so the apply does what the preview described.
RescanModuleAction
One module’s entry in a candidate preview.
ScopeServedByReply
Volatile bind history in one daemon incarnation; unknown never means served.
ScopeServedByRequest
Ask about an epoch owned by the registered module sending the request.
SpawnCursor
A daemon-incarnation-scoped position in the supervised spawn event stream.
SpawnEvent
One retained or live spawn event.
SpawnSnapshot
Atomic live-process census and the cursor at which it was observed.
StagedGeneration
Names one state of the daemon’s staged configuration. The counter alone is not enough: it starts again at zero when the daemon restarts, and a restarted daemon may hold different staged specs under the same number.
StderrTail
A module’s retained stderr, oldest entry first.
SubtreeReading
A report-only memory reading of a module’s process container.
SupervisorDaemonProvenance
Daemon provenance paired with its runtime process observation.
SupervisorEntry
A supervised module’s current state and process observations.
SupervisorHealthEntry
SupervisorModuleProvenance
Source-tagged provenance for one supervised module.
SupervisorObservedProcess
Process facts observed by the daemon for a supervised module.
SupervisorRescanResult
SupervisorRoute
One live consumer route in a SupervisorRouteModule.
SupervisorRouteModule
Live routes served by one module.
TerminalEntry
One terminal child exit and the supervisor action it selected.
TerminalHistory
Bounded terminal history for one module, oldest retained record first.

Enums§

ActivityOn
Exactly one citation from which the daemon resolves the actor.
AppOpenStatus
What an app.open call did.
ChildMemoryKind
What ChildResourceReading::memory_bytes measures.
ChildResourceUnavailableReason
Why a module process’s resources could not be read.
ChildResourceUsage
A module process’s memory and CPU time as read at list time, or why none could be read.
ClientControlPush
Daemon-originated channel-0 control push body.
ClientControlRequest
Client-originated channel-0 control RPC body.
ClientControlResponse
subc’s channel-0 response body for client control RPCs.
LaunchSpecAgreement
Comparison of the configured launch inputs with the inputs recorded at spawn. No digest or configured env values are sent to clients.
LaunchSpecUnavailableReason
ModuleDeclaredProvenance
A module’s declared build metadata, if its HELLO manifest carried it.
ModuleProtocol
Which wire protocol a supervised module speaks to subc, as DECLARED in daemon config. Never inferred from observed behaviour.
OrderedJsonValue
JSON values whose object members retain wire order at every depth.
PollKind
ReloadPathAgreement
Whether the running process was spawned from the currently configured program.
ReloadPathUnavailableReason
Why configured and spawned paths cannot be compared.
RescanModuleActionKind
What applying a candidate would do to one module.
RouteCloseReason
Why subc is closing a module’s client routes.
RunningImageAgreement
Whether the executable currently running agrees with the spawned image.
RunningImageEvidence
Platform-specific evidence used to compare a running image with its spawn path.
RunningImageUnavailableReason
Reasons why an executable identity could not be observed.
ScopeServedByAnswer
Only Served establishes that the target acknowledged a scoped bind.
SpawnEventKind
Fact observed by the supervisor when a child process starts or exits.
StderrCaptureState
Whether stderr is being captured for a module, and if not, why not.
StderrTailEntry
SubtreeSource
The measurement behind a module’s memory including child processes.
SupervisorHealthStatus
SupervisorRouteConsumer
The identity tier the daemon can honestly report for a route consumer.
TerminalDisposition
The supervisor disposition selected after observing a terminal exit.
TerminalExitKind
Exit classification carried by supervisor history and census records.

Constants§

ACTIVITY_ACTOR_UNKNOWN
ACTIVITY_CURSOR_INCARNATION_MISMATCH
ACTIVITY_CURSOR_TOO_OLD
ACTIVITY_KIND_FORBIDDEN
ACTIVITY_LEDGER_CAPABILITY
Advertised in HELLO_ACK and server.describe before activity operations are used.
ACTIVITY_MALFORMED
ACTIVITY_RATE_LIMITED
ACTIVITY_READ_FORBIDDEN
ACTIVITY_SUBSCRIBER_LAGGED
ACTIVITY_TOO_LARGE
ACTIVITY_UNAVAILABLE
APP_NOT_INSTALLED
Refusal code for a known app that is not installed where the daemon looks.
APP_OPEN_DISABLED
Refusal code when the platform supports app.open but this daemon build has it switched off.
APP_OPEN_ERROR_CODES
Every app.open refusal code, in the order the daemon checks them.
APP_OPEN_NOT_USED
Refusal code on a platform that never launches apps through the daemon.
APP_UNKNOWN
Refusal code for an app id the daemon does not know.
APP_VERIFICATION_FAILED
Refusal code for an installed binary that failed the daemon’s checks. No process was started.
CONFIG_CHANGED_SINCE_PREVIEW
Refusal code for an apply whose expect no longer matches the daemon: the file it reads hashes differently, or the staged generation has moved since the preview (another rescan with module changes ran, even one that failed partway, or the daemon restarted). Nothing was applied.
RESCAN_CANDIDATE_MAX_BYTES
The largest candidate text, in bytes, a preview accepts. A daemon config file is a few kilobytes; the cap bounds what one request can make the daemon parse.
RESCAN_CANDIDATE_PREVIEW_CAPABILITY
Advertised in server.describe by a daemon that serves supervisor.rescan_checked. A client sends that op only when this is listed: an older daemon refuses the unknown op, so a client that skipped the check would fail closed rather than preview the file on disk.
RESCAN_CANDIDATE_TOO_LARGE
Refusal code for a preview whose candidate is longer than RESCAN_CANDIDATE_MAX_BYTES.
SCOPE_SERVED_BY_OP