@githolon/runtime 0.110.0

package/src/protocol/nomos/runtime/v2/residency_desk_pb.d.ts

@@ -0,0 +1,1162 @@
+// @generated by protoc-gen-es v2.13.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file nomos/runtime/v2/residency_desk.proto (package nomos.runtime.v2, syntax proto3)
+/* eslint-disable */
+
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+import type { AggregateTypeCount, CustodyRetentionIntent, KernelResidencyIntent } from "../../kernel/v1/kernel_pb.js";
+import type { CustodyOpening, WorkspaceStatus } from "./custody_desk_pb.js";
+
+/**
+ * Describes the file nomos/runtime/v2/residency_desk.proto.
+ */
+export declare const file_nomos_runtime_v2_residency_desk: GenFile;
+
+/**
+ * A platform shell reports physical memory pressure; it never chooses which
+ * workspace to evict. The peer office applies the shared warm-lease policy and
+ * preserves Git custody while releasing only kernel residency.
+ *
+ * @generated from message nomos.runtime.v2.ResidencyPressureRequest
+ */
+export declare type ResidencyPressureRequest = Message<"nomos.runtime.v2.ResidencyPressureRequest"> & {
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ResidencyPressureRequest.
+ * Use `create(ResidencyPressureRequestSchema)` to create a new message.
+ */
+export declare const ResidencyPressureRequestSchema: GenMessage<ResidencyPressureRequest>;
+
+/**
+ * Internal Peer Runtime paper used by its background scheduler. The shell
+ * never authors this request; it only executes the resulting physical effect.
+ *
+ * @generated from message nomos.runtime.v2.RetainFrontierRequest
+ */
+export declare type RetainFrontierRequest = Message<"nomos.runtime.v2.RetainFrontierRequest"> & {
+  /**
+   * @generated from field: string workspace = 1;
+   */
+  workspace: string;
+
+  /**
+   * @generated from field: string branch = 2;
+   */
+  branch: string;
+
+  /**
+   * @generated from field: string head = 3;
+   */
+  head: string;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.RetainFrontierRequest.
+ * Use `create(RetainFrontierRequestSchema)` to create a new message.
+ */
+export declare const RetainFrontierRequestSchema: GenMessage<RetainFrontierRequest>;
+
+/**
+ * @generated from message nomos.runtime.v2.ResidencyPressureRelieved
+ */
+export declare type ResidencyPressureRelieved = Message<"nomos.runtime.v2.ResidencyPressureRelieved"> & {
+  /**
+   * @generated from field: repeated string evicted_workspaces = 1;
+   */
+  evictedWorkspaces: string[];
+
+  /**
+   * @generated from field: repeated string warm_workspaces = 2;
+   */
+  warmWorkspaces: string[];
+
+  /**
+   * @generated from field: uint64 warm_residency_millis = 3;
+   */
+  warmResidencyMillis: bigint;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ResidencyPressureRelieved.
+ * Use `create(ResidencyPressureRelievedSchema)` to create a new message.
+ */
+export declare const ResidencyPressureRelievedSchema: GenMessage<ResidencyPressureRelieved>;
+
+/**
+ * ── Physical host telemetry ───────────────────────────────────────────────────
+ * A platform-shell process describes itself. This is operator telemetry with no
+ * authority: nothing here admits an effect, selects a kernel or moves custody.
+ * It is the ONE contract for a host's /health and /kernel/refresh answers,
+ * the edge's /v1/ops/residency aggregate, placement headroom, peer restarts and the
+ * kernel-release swap proof. Until 2026-09-07 each of those hand-rolled its own
+ * JSON and a renamed field (pid/booted → replica) silently broke kernel releases.
+ * Physical detail about ONE resident workspace, keyed by a name in
+ * HostHealth.resident_workspaces. Telemetry only: it ranks candidates for an operator or a
+ * shedding policy and admits nothing.
+ *
+ * @generated from message nomos.runtime.v2.ResidentWorkspaceDetail
+ */
+export declare type ResidentWorkspaceDetail = Message<"nomos.runtime.v2.ResidentWorkspaceDetail"> & {
+  /**
+   * @generated from field: string workspace = 1;
+   */
+  workspace: string;
+
+  /**
+   * Milliseconds since this host last carried work for this workspace. A host that has not
+   * observed it since starting reports its own uptime, never zero.
+   *
+   * @generated from field: uint64 idle_millis = 2;
+   */
+  idleMillis: bigint;
+
+  /**
+   * Bytes of retained Git custody in the kernel's preopened filesystem. This is the only
+   * per-workspace magnitude a peer can state honestly — the kernel's linear memory is one
+   * allocator shared by every resident — so it is a FLOOR on a workspace's footprint, not its total.
+   *
+   * @generated from field: optional uint64 repository_bytes = 3;
+   */
+  repositoryBytes?: bigint | undefined;
+
+  /**
+   * Exact resident SQLite image (`page_count x page_size`) for this workspace's current `main`
+   * projection. This is a useful operational proxy for materialized frontier size, not canonical
+   * application-state bytes and not total resident memory. Absent means not measured.
+   *
+   * @generated from field: optional uint64 materialized_frontier_bytes = 4;
+   */
+  materializedFrontierBytes?: bigint | undefined;
+
+  /**
+   * One exhaustive operator posture derived from the typed facts below. A consumer never infers
+   * readiness from non-zero byte counts, and aligned means the SQLite accelerator and Git custody
+   * name the SAME authenticated head.
+   *
+   * @generated from field: nomos.runtime.v2.ResidentWorkspaceReadiness readiness = 5;
+   */
+  readiness: ResidentWorkspaceReadiness;
+
+  /**
+   * Exact Git head whose verified SQLite accelerator can currently answer reads. Absent means no
+   * read-ready projection is attached; it does not mean an on-disk accelerator is impossible.
+   *
+   * @generated from field: optional string sqlite_head = 6;
+   */
+  sqliteHead?: string | undefined;
+
+  /**
+   * Exact refs/heads/main currently mounted as local Git custody. Absent is compatible with
+   * SQLITE_ONLY: a disposable cloud process may serve a retained verified accelerator before it
+   * has reason to reopen shallow Git custody.
+   *
+   * @generated from field: optional string git_head = 7;
+   */
+  gitHead?: string | undefined;
+
+  /**
+   * @generated from field: nomos.runtime.v2.LocalHistoryPosture history_posture = 8;
+   */
+  historyPosture: LocalHistoryPosture;
+
+  /**
+   * Exact number of Git shallow boundaries when history posture is PARTIAL.
+   *
+   * @generated from field: uint32 shallow_boundaries = 9;
+   */
+  shallowBoundaries: number;
+
+  /**
+   * Host times of the independently amortised physical byte samples. Heads and lifecycle posture
+   * are refreshed by their own transitions and do not inherit these ages.
+   *
+   * @generated from field: optional uint64 repository_measured_at_unix_millis = 10;
+   */
+  repositoryMeasuredAtUnixMillis?: bigint | undefined;
+
+  /**
+   * @generated from field: optional uint64 frontier_measured_at_unix_millis = 11;
+   */
+  frontierMeasuredAtUnixMillis?: bigint | undefined;
+
+  /**
+   * The placement this host last resolved for the workspace. A cached observation from the
+   * placement desk's own reads, never a kernel read at health time. Absent means the host has
+   * not resolved placement for it since the process started — UNKNOWN, not "no policy".
+   *
+   * @generated from field: optional nomos.runtime.v2.ResidentPlacement placement = 12;
+   */
+  placement?: ResidentPlacement | undefined;
+
+  /**
+   * What the host's last inspection of this workspace's durable outbox found. Cached from the
+   * correspondence desk's own inventory; absent means not inspected since the process started.
+   *
+   * @generated from field: optional nomos.runtime.v2.ResidentOutbox outbox = 13;
+   */
+  outbox?: ResidentOutbox | undefined;
+
+  /**
+   * How much state the workspace holds, and of what, at its last census. Sampled on the idle
+   * lane only when the head moved; absent when never taken or the kernel predates the census.
+   *
+   * @generated from field: optional nomos.runtime.v2.ResidentAggregateCensus census = 14;
+   */
+  census?: ResidentAggregateCensus | undefined;
+
+  /**
+   * Last exact head this process's kernel fully replayed from genesis for this workspace.
+   * HostHealth copies the kernel's idle-lane observation; consumers must match git_head.
+   *
+   * @generated from field: optional string full_replay_head = 15;
+   */
+  fullReplayHead?: string | undefined;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ResidentWorkspaceDetail.
+ * Use `create(ResidentWorkspaceDetailSchema)` to create a new message.
+ */
+export declare const ResidentWorkspaceDetailSchema: GenMessage<ResidentWorkspaceDetail>;
+
+/**
+ * The frontier's authenticated aggregate count, and the most numerous types from the resident
+ * read accelerator. `top_types` describe the head's state only when `types_state_root` equals
+ * `state_root`; otherwise they describe the (named) older state the accelerator is bound to.
+ *
+ * @generated from message nomos.runtime.v2.ResidentAggregateCensus
+ */
+export declare type ResidentAggregateCensus = Message<"nomos.runtime.v2.ResidentAggregateCensus"> & {
+  /**
+   * @generated from field: string head = 1;
+   */
+  head: string;
+
+  /**
+   * @generated from field: optional uint64 aggregate_count = 2;
+   */
+  aggregateCount?: bigint | undefined;
+
+  /**
+   * @generated from field: optional string state_root = 3;
+   */
+  stateRoot?: string | undefined;
+
+  /**
+   * @generated from field: repeated nomos.kernel.v1.AggregateTypeCount top_types = 4;
+   */
+  topTypes: AggregateTypeCount[];
+
+  /**
+   * @generated from field: optional string types_state_root = 5;
+   */
+  typesStateRoot?: string | undefined;
+
+  /**
+   * @generated from field: uint64 observed_unix_millis = 6;
+   */
+  observedUnixMillis: bigint;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ResidentAggregateCensus.
+ * Use `create(ResidentAggregateCensusSchema)` to create a new message.
+ */
+export declare const ResidentAggregateCensusSchema: GenMessage<ResidentAggregateCensus>;
+
+/**
+ * One peer-class rule of a declared placement policy. A class whose custody retention is NONE
+ * holds no replica: it reaches the workspace through the named remotes only.
+ *
+ * @generated from message nomos.runtime.v2.ResidentPlacementRule
+ */
+export declare type ResidentPlacementRule = Message<"nomos.runtime.v2.ResidentPlacementRule"> & {
+  /**
+   * @generated from field: string peer_class = 1;
+   */
+  peerClass: string;
+
+  /**
+   * @generated from field: nomos.kernel.v1.KernelResidencyIntent kernel_residency = 2;
+   */
+  kernelResidency: KernelResidencyIntent;
+
+  /**
+   * @generated from field: nomos.kernel.v1.CustodyRetentionIntent custody_retention = 3;
+   */
+  custodyRetention: CustodyRetentionIntent;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ResidentPlacementRule.
+ * Use `create(ResidentPlacementRuleSchema)` to create a new message.
+ */
+export declare const ResidentPlacementRuleSchema: GenMessage<ResidentPlacementRule>;
+
+/**
+ * Operator view of one workspace's custody placement. Remote and mailbox URLs are deliberately
+ * reduced to names and a presence bit: this report is served unauthenticated.
+ *
+ * @generated from message nomos.runtime.v2.ResidentPlacement
+ */
+export declare type ResidentPlacement = Message<"nomos.runtime.v2.ResidentPlacement"> & {
+  /**
+   * The workspace's independent placement frontier. Absent means no policy was ever adopted,
+   * and every other declared field below is empty.
+   *
+   * @generated from field: optional string frontier = 1;
+   */
+  frontier?: string | undefined;
+
+  /**
+   * @generated from field: string declaration = 2;
+   */
+  declaration: string;
+
+  /**
+   * @generated from field: string adopted_by = 3;
+   */
+  adoptedBy: string;
+
+  /**
+   * @generated from field: repeated nomos.runtime.v2.ResidentPlacementRule rules = 4;
+   */
+  rules: ResidentPlacementRule[];
+
+  /**
+   * @generated from field: repeated string remote_names = 5;
+   */
+  remoteNames: string[];
+
+  /**
+   * @generated from field: bool recipient_mailbox_declared = 6;
+   */
+  recipientMailboxDeclared: boolean;
+
+  /**
+   * This host's interpretation of the policy for its own peer classes.
+   *
+   * @generated from field: nomos.kernel.v1.KernelResidencyIntent effective_kernel_residency = 7;
+   */
+  effectiveKernelResidency: KernelResidencyIntent;
+
+  /**
+   * @generated from field: nomos.kernel.v1.CustodyRetentionIntent effective_custody_retention = 8;
+   */
+  effectiveCustodyRetention: CustodyRetentionIntent;
+
+  /**
+   * @generated from field: repeated string effective_remote_names = 9;
+   */
+  effectiveRemoteNames: string[];
+
+  /**
+   * @generated from field: uint64 observed_unix_millis = 10;
+   */
+  observedUnixMillis: bigint;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ResidentPlacement.
+ * Use `create(ResidentPlacementSchema)` to create a new message.
+ */
+export declare const ResidentPlacementSchema: GenMessage<ResidentPlacement>;
+
+/**
+ * Undelivered outbound commitments at the last outbox inspection. Inventory only: the durable
+ * outbox in Git is the work; this is the host's latest look at it.
+ *
+ * @generated from message nomos.runtime.v2.ResidentOutbox
+ */
+export declare type ResidentOutbox = Message<"nomos.runtime.v2.ResidentOutbox"> & {
+  /**
+   * @generated from field: uint32 entries = 1;
+   */
+  entries: number;
+
+  /**
+   * The kernel still has preparation work before the outbox can be judged complete.
+   *
+   * @generated from field: bool work_pending = 2;
+   */
+  workPending: boolean;
+
+  /**
+   * Earliest future commitment the kernel reported. Absent when none is scheduled.
+   *
+   * @generated from field: optional uint64 next_due_unix_millis = 3;
+   */
+  nextDueUnixMillis?: bigint | undefined;
+
+  /**
+   * @generated from field: uint64 observed_unix_millis = 4;
+   */
+  observedUnixMillis: bigint;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ResidentOutbox.
+ * Use `create(ResidentOutboxSchema)` to create a new message.
+ */
+export declare const ResidentOutboxSchema: GenMessage<ResidentOutbox>;
+
+/**
+ * One exclusive top-level class of kernel ABI work. Counters are cumulative for
+ * the installed kernel in this process; Prometheus treats a process/kernel swap
+ * as an ordinary counter reset. `family` is the bounded dashboard vocabulary,
+ * while `operation` is the exact generated oneof path (also bounded by the ABI).
+ * Neither field contains a workspace, law identity, intent or tenant value.
+ *
+ * @generated from message nomos.runtime.v2.KernelWorkCounter
+ */
+export declare type KernelWorkCounter = Message<"nomos.runtime.v2.KernelWorkCounter"> & {
+  /**
+   * @generated from field: string family = 1;
+   */
+  family: string;
+
+  /**
+   * @generated from field: string operation = 2;
+   */
+  operation: string;
+
+  /**
+   * @generated from field: uint64 calls = 3;
+   */
+  calls: bigint;
+
+  /**
+   * @generated from field: uint64 failures = 4;
+   */
+  failures: bigint;
+
+  /**
+   * @generated from field: uint64 cpu_micros = 5;
+   */
+  cpuMicros: bigint;
+
+  /**
+   * @generated from field: uint64 wall_micros = 6;
+   */
+  wallMicros: bigint;
+
+  /**
+   * @generated from field: repeated nomos.runtime.v2.KernelWorkCpuBucket cpu_buckets = 7;
+   */
+  cpuBuckets: KernelWorkCpuBucket[];
+
+  /**
+   * @generated from field: uint64 last_completed_unix_millis = 8;
+   */
+  lastCompletedUnixMillis: bigint;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.KernelWorkCounter.
+ * Use `create(KernelWorkCounterSchema)` to create a new message.
+ */
+export declare const KernelWorkCounterSchema: GenMessage<KernelWorkCounter>;
+
+/**
+ * Cumulative histogram bucket for one KernelWorkCounter. The bounds are fixed
+ * by the peer runtime and cumulative, matching the Prometheus histogram model.
+ *
+ * @generated from message nomos.runtime.v2.KernelWorkCpuBucket
+ */
+export declare type KernelWorkCpuBucket = Message<"nomos.runtime.v2.KernelWorkCpuBucket"> & {
+  /**
+   * @generated from field: uint64 le_micros = 1;
+   */
+  leMicros: bigint;
+
+  /**
+   * @generated from field: uint64 calls = 2;
+   */
+  calls: bigint;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.KernelWorkCpuBucket.
+ * Use `create(KernelWorkCpuBucketSchema)` to create a new message.
+ */
+export declare const KernelWorkCpuBucketSchema: GenMessage<KernelWorkCpuBucket>;
+
+/**
+ * A call which is executing at the instant /health is observed. This is useful
+ * for a genuinely long replay or index rebuild; most calls complete between
+ * scrapes and are represented by the cumulative counters above.
+ *
+ * @generated from message nomos.runtime.v2.ActiveKernelWork
+ */
+export declare type ActiveKernelWork = Message<"nomos.runtime.v2.ActiveKernelWork"> & {
+  /**
+   * @generated from field: string family = 1;
+   */
+  family: string;
+
+  /**
+   * @generated from field: string operation = 2;
+   */
+  operation: string;
+
+  /**
+   * @generated from field: uint64 started_unix_millis = 3;
+   */
+  startedUnixMillis: bigint;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ActiveKernelWork.
+ * Use `create(ActiveKernelWorkSchema)` to create a new message.
+ */
+export declare const ActiveKernelWorkSchema: GenMessage<ActiveKernelWork>;
+
+/**
+ * Operator telemetry only. Top-level families are mutually exclusive so their
+ * CPU totals form one honest 100% partition. Kernel-owned nested phase timings
+ * remain separate drill-down evidence and must never be added to these totals.
+ *
+ * @generated from message nomos.runtime.v2.KernelWorkSnapshot
+ */
+export declare type KernelWorkSnapshot = Message<"nomos.runtime.v2.KernelWorkSnapshot"> & {
+  /**
+   * @generated from field: uint64 started_unix_millis = 1;
+   */
+  startedUnixMillis: bigint;
+
+  /**
+   * @generated from field: uint64 observed_unix_millis = 2;
+   */
+  observedUnixMillis: bigint;
+
+  /**
+   * @generated from field: repeated nomos.runtime.v2.KernelWorkCounter counters = 3;
+   */
+  counters: KernelWorkCounter[];
+
+  /**
+   * @generated from field: optional nomos.runtime.v2.ActiveKernelWork active = 4;
+   */
+  active?: ActiveKernelWork | undefined;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.KernelWorkSnapshot.
+ * Use `create(KernelWorkSnapshotSchema)` to create a new message.
+ */
+export declare const KernelWorkSnapshotSchema: GenMessage<KernelWorkSnapshot>;
+
+/**
+ * @generated from message nomos.runtime.v2.HostHealth
+ */
+export declare type HostHealth = Message<"nomos.runtime.v2.HostHealth"> & {
+  /**
+   * Process identity of the shell. A swap in place keeps it; a replacement changes it.
+   *
+   * @generated from field: uint64 replica = 1;
+   */
+  replica: bigint;
+
+  /**
+   * SHA-256 of the installed kernel wasm, lowercase hex.
+   *
+   * @generated from field: string kernel_sha256 = 2;
+   */
+  kernelSha256: string;
+
+  /**
+   * Workspaces the kernel currently has mounted (empty between operations). THIS remains the
+   * membership answer: a host predating `residents` still answers it, and placement reads it to
+   * decide colocation during a rollout, when old and new container images serve side by side.
+   *
+   * @generated from field: repeated string resident_workspaces = 3;
+   */
+  residentWorkspaces: string[];
+
+  /**
+   * @generated from field: double wasm_linear_mem_mb = 4;
+   */
+  wasmLinearMemMb: number;
+
+  /**
+   * @generated from field: double process_rss_mb = 5;
+   */
+  processRssMb: number;
+
+  /**
+   * RSS ceiling the placement policy reserves fold-spike headroom below.
+   *
+   * @generated from field: uint32 rss_critical_mb = 6;
+   */
+  rssCriticalMb: number;
+
+  /**
+   * Per-resident detail for the names above. Empty from a host that predates it; a reader must
+   * treat absent detail as UNKNOWN, never as an idle or empty workspace.
+   *
+   * @generated from field: repeated nomos.runtime.v2.ResidentWorkspaceDetail residents = 7;
+   */
+  residents: ResidentWorkspaceDetail[];
+
+  /**
+   * Complete work accounting for the dedicated kernel execution thread. Empty
+   * from a host which predates this contract; absence means UNKNOWN, not idle.
+   *
+   * @generated from field: optional nomos.runtime.v2.KernelWorkSnapshot kernel_work = 8;
+   */
+  kernelWork?: KernelWorkSnapshot | undefined;
+
+  /**
+   * Custody opens this host is performing right now. An open is mostly waiting on the Git
+   * provider, which no CPU or kernel-work figure shows. Empty means none in progress on a host
+   * that reports `artifacts`; a host predating this contract reports neither.
+   *
+   * @generated from field: repeated nomos.runtime.v2.CustodyOpening openings = 9;
+   */
+  openings: CustodyOpening[];
+
+  /**
+   * Every Git HTTP request this host made to its custody provider since the process started.
+   *
+   * @generated from field: optional nomos.runtime.v2.ArtifactsTransportSnapshot artifacts = 10;
+   */
+  artifacts?: ArtifactsTransportSnapshot | undefined;
+
+  /**
+   * Physical retention publications by settled outcome since the process started.
+   *
+   * @generated from field: repeated nomos.runtime.v2.RetentionOutcomeCounter retention = 11;
+   */
+  retention: RetentionOutcomeCounter[];
+
+  /**
+   * Outbound correspondence this host is holding back, and WHY. Idle outbox work is paid for
+   * by these: a letter that stays retryable is re-inspected on its backoff forever, so an
+   * outbox that never empties never lets the host go quiet. The reason names the event the
+   * letter is actually waiting on, which is what lets it become event driven.
+   *
+   * @generated from field: repeated nomos.runtime.v2.CorrespondenceHold correspondence_holds = 12;
+   */
+  correspondenceHolds: CorrespondenceHold[];
+};
+
+/**
+ * Describes the message nomos.runtime.v2.HostHealth.
+ * Use `create(HostHealthSchema)` to create a new message.
+ */
+export declare const HostHealthSchema: GenMessage<HostHealth>;
+
+/**
+ * Cumulative counters for one (operation, outcome) pair of provider Git HTTP requests.
+ * operation: info-refs-upload | info-refs-receive | upload-pack | receive-pack | other
+ * outcome: 2xx | 3xx | 4xx | 5xx | timeout | transport
+ * Wall time runs until the response body is fully read or the request fails, so a slow pack
+ * download counts in full, not just its headers.
+ *
+ * @generated from message nomos.runtime.v2.ArtifactsRequestCounter
+ */
+export declare type ArtifactsRequestCounter = Message<"nomos.runtime.v2.ArtifactsRequestCounter"> & {
+  /**
+   * @generated from field: string operation = 1;
+   */
+  operation: string;
+
+  /**
+   * @generated from field: string outcome = 2;
+   */
+  outcome: string;
+
+  /**
+   * @generated from field: uint64 requests = 3;
+   */
+  requests: bigint;
+
+  /**
+   * @generated from field: uint64 wall_micros = 4;
+   */
+  wallMicros: bigint;
+
+  /**
+   * @generated from field: uint64 response_bytes = 5;
+   */
+  responseBytes: bigint;
+
+  /**
+   * @generated from field: repeated nomos.runtime.v2.ArtifactsLatencyBucket latency_buckets = 6;
+   */
+  latencyBuckets: ArtifactsLatencyBucket[];
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ArtifactsRequestCounter.
+ * Use `create(ArtifactsRequestCounterSchema)` to create a new message.
+ */
+export declare const ArtifactsRequestCounterSchema: GenMessage<ArtifactsRequestCounter>;
+
+/**
+ * Cumulative wall-time histogram bucket, Prometheus model, fixed bounds.
+ *
+ * @generated from message nomos.runtime.v2.ArtifactsLatencyBucket
+ */
+export declare type ArtifactsLatencyBucket = Message<"nomos.runtime.v2.ArtifactsLatencyBucket"> & {
+  /**
+   * @generated from field: uint64 le_micros = 1;
+   */
+  leMicros: bigint;
+
+  /**
+   * @generated from field: uint64 requests = 2;
+   */
+  requests: bigint;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ArtifactsLatencyBucket.
+ * Use `create(ArtifactsLatencyBucketSchema)` to create a new message.
+ */
+export declare const ArtifactsLatencyBucketSchema: GenMessage<ArtifactsLatencyBucket>;
+
+/**
+ * @generated from message nomos.runtime.v2.ArtifactsTransportSnapshot
+ */
+export declare type ArtifactsTransportSnapshot = Message<"nomos.runtime.v2.ArtifactsTransportSnapshot"> & {
+  /**
+   * @generated from field: uint64 started_unix_millis = 1;
+   */
+  startedUnixMillis: bigint;
+
+  /**
+   * @generated from field: repeated nomos.runtime.v2.ArtifactsRequestCounter counters = 2;
+   */
+  counters: ArtifactsRequestCounter[];
+
+  /**
+   * Requests started and not yet settled at observation time.
+   *
+   * @generated from field: uint32 in_flight = 3;
+   */
+  inFlight: number;
+
+  /**
+   * Start time of the oldest unsettled request; 0 when none is in flight.
+   *
+   * @generated from field: uint64 oldest_in_flight_started_unix_millis = 4;
+   */
+  oldestInFlightStartedUnixMillis: bigint;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ArtifactsTransportSnapshot.
+ * Use `create(ArtifactsTransportSnapshotSchema)` to create a new message.
+ */
+export declare const ArtifactsTransportSnapshotSchema: GenMessage<ArtifactsTransportSnapshot>;
+
+/**
+ * outcome: retained | superseded | failed
+ *
+ * @generated from message nomos.runtime.v2.RetentionOutcomeCounter
+ */
+export declare type RetentionOutcomeCounter = Message<"nomos.runtime.v2.RetentionOutcomeCounter"> & {
+  /**
+   * @generated from field: string outcome = 1;
+   */
+  outcome: string;
+
+  /**
+   * @generated from field: uint64 publications = 2;
+   */
+  publications: bigint;
+
+  /**
+   * Physical attempts spent across those publications.
+   *
+   * @generated from field: uint64 attempts = 3;
+   */
+  attempts: bigint;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.RetentionOutcomeCounter.
+ * Use `create(RetentionOutcomeCounterSchema)` to create a new message.
+ */
+export declare const RetentionOutcomeCounterSchema: GenMessage<RetentionOutcomeCounter>;
+
+/**
+ * Outcome of asking a shell to reconcile to the provider-selected kernel in place.
+ *
+ * @generated from message nomos.runtime.v2.KernelRefreshOutcome
+ */
+export declare type KernelRefreshOutcome = Message<"nomos.runtime.v2.KernelRefreshOutcome"> & {
+  /**
+   * @generated from field: nomos.runtime.v2.HostHealth host = 1;
+   */
+  host?: HostHealth | undefined;
+
+  /**
+   * @generated from field: bool changed = 2;
+   */
+  changed: boolean;
+
+  /**
+   * @generated from field: string previous_sha256 = 3;
+   */
+  previousSha256: string;
+
+  /**
+   * @generated from field: string sha256 = 4;
+   */
+  sha256: string;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.KernelRefreshOutcome.
+ * Use `create(KernelRefreshOutcomeSchema)` to create a new message.
+ */
+export declare const KernelRefreshOutcomeSchema: GenMessage<KernelRefreshOutcome>;
+
+/**
+ * One physical Peer Runtime host as the provider adapter sees it.
+ * One outbound letter — or a whole correspondent, when the route itself is down — that this
+ * host is holding back rather than delivering, with the last reason it could not settle.
+ *
+ * @generated from message nomos.runtime.v2.CorrespondenceHold
+ */
+export declare type CorrespondenceHold = Message<"nomos.runtime.v2.CorrespondenceHold"> & {
+  /**
+   * @generated from field: string source_workspace = 1;
+   */
+  sourceWorkspace: string;
+
+  /**
+   * @generated from field: string target_workspace = 2;
+   */
+  targetWorkspace: string;
+
+  /**
+   * Empty when the hold covers every letter to this target (a route, mailbox or transport
+   * outage applies to the correspondent, not to one letter).
+   *
+   * @generated from field: string source_offer_path = 3;
+   */
+  sourceOfferPath: string;
+
+  /**
+   * Stable machine code: the failure code the target or transport returned, or one of
+   * nomos.correspondence.{identity_mismatch,target_deferred,no_settlement,
+   * outcome_not_recorded,outcome_not_durable}.
+   *
+   * @generated from field: string reason = 4;
+   */
+  reason: string;
+
+  /**
+   * Human detail for the reason, truncated. Never payload bytes.
+   *
+   * @generated from field: string detail = 5;
+   */
+  detail: string;
+
+  /**
+   * Consecutive unsettled attempts behind the current hold.
+   *
+   * @generated from field: uint32 failures = 6;
+   */
+  failures: number;
+
+  /**
+   * @generated from field: uint64 retry_at_millis = 7;
+   */
+  retryAtMillis: bigint;
+
+  /**
+   * When this letter (or correspondent) was first held without an intervening settlement.
+   *
+   * @generated from field: uint64 held_since_millis = 8;
+   */
+  heldSinceMillis: bigint;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.CorrespondenceHold.
+ * Use `create(CorrespondenceHoldSchema)` to create a new message.
+ */
+export declare const CorrespondenceHoldSchema: GenMessage<CorrespondenceHold>;
+
+/**
+ * @generated from message nomos.runtime.v2.ResidencyHost
+ */
+export declare type ResidencyHost = Message<"nomos.runtime.v2.ResidencyHost"> & {
+  /**
+   * @generated from field: string host_id = 1;
+   */
+  hostId: string;
+
+  /**
+   * Provider instance state: running, healthy, stopped, …
+   *
+   * @generated from field: string status = 2;
+   */
+  status: string;
+
+  /**
+   * @generated from field: bool live = 3;
+   */
+  live: boolean;
+
+  /**
+   * @generated from field: uint64 last_change_millis = 4;
+   */
+  lastChangeMillis: bigint;
+
+  /**
+   * @generated from field: optional nomos.runtime.v2.HostHealth host = 5;
+   */
+  host?: HostHealth | undefined;
+
+  /**
+   * @generated from field: optional nomos.runtime.v2.KernelRefreshOutcome refresh = 6;
+   */
+  refresh?: KernelRefreshOutcome | undefined;
+
+  /**
+   * Set when the plane is registered live but could not be reached.
+   *
+   * @generated from field: optional string error = 7;
+   */
+  error?: string | undefined;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ResidencyHost.
+ * Use `create(ResidencyHostSchema)` to create a new message.
+ */
+export declare const ResidencyHostSchema: GenMessage<ResidencyHost>;
+
+/**
+ * @generated from message nomos.runtime.v2.ResidencyReport
+ */
+export declare type ResidencyReport = Message<"nomos.runtime.v2.ResidencyReport"> & {
+  /**
+   * @generated from field: bool ok = 1;
+   */
+  ok: boolean;
+
+  /**
+   * @generated from field: uint64 now_millis = 2;
+   */
+  nowMillis: bigint;
+
+  /**
+   * @generated from field: uint32 host_capacity = 3;
+   */
+  hostCapacity: number;
+
+  /**
+   * @generated from field: uint32 live_hosts = 4;
+   */
+  liveHosts: number;
+
+  /**
+   * @generated from field: uint32 resident_workspaces = 5;
+   */
+  residentWorkspaces: number;
+
+  /**
+   * @generated from field: repeated nomos.runtime.v2.ResidencyHost hosts = 6;
+   */
+  hosts: ResidencyHost[];
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ResidencyReport.
+ * Use `create(ResidencyReportSchema)` to create a new message.
+ */
+export declare const ResidencyReportSchema: GenMessage<ResidencyReport>;
+
+/**
+ * The deploy canary's view of one workspace: its Peer Office custody status beside the
+ * physical health of the host currently serving it (GET /v2/workspaces/<ws>/peer-status).
+ *
+ * @generated from message nomos.runtime.v2.PeerStatusReport
+ */
+export declare type PeerStatusReport = Message<"nomos.runtime.v2.PeerStatusReport"> & {
+  /**
+   * @generated from field: bool ok = 1;
+   */
+  ok: boolean;
+
+  /**
+   * @generated from field: string workspace = 2;
+   */
+  workspace: string;
+
+  /**
+   * @generated from field: nomos.runtime.v2.WorkspaceStatus peer_office = 3;
+   */
+  peerOffice?: WorkspaceStatus | undefined;
+
+  /**
+   * @generated from field: nomos.runtime.v2.HostHealth physical = 4;
+   */
+  physical?: HostHealth | undefined;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.PeerStatusReport.
+ * Use `create(PeerStatusReportSchema)` to create a new message.
+ */
+export declare const PeerStatusReportSchema: GenMessage<PeerStatusReport>;
+
+/**
+ * A host restart (POST /v1/ops/restart-peers): every selected Peer Runtime host restarted.
+ *
+ * @generated from message nomos.runtime.v2.RestartedHost
+ */
+export declare type RestartedHost = Message<"nomos.runtime.v2.RestartedHost"> & {
+  /**
+   * @generated from field: string host_id = 1;
+   */
+  hostId: string;
+
+  /**
+   * True only when a previously-live host's replacement answered typed health.
+   *
+   * @generated from field: bool live = 2;
+   */
+  live: boolean;
+
+  /**
+   * Digest reported by the replacement after restart; empty for a previously stopped slot
+   * or when replacement verification failed.
+   *
+   * @generated from field: string kernel_sha256 = 3;
+   */
+  kernelSha256: string;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.RestartedHost.
+ * Use `create(RestartedHostSchema)` to create a new message.
+ */
+export declare const RestartedHostSchema: GenMessage<RestartedHost>;
+
+/**
+ * @generated from message nomos.runtime.v2.RestartError
+ */
+export declare type RestartError = Message<"nomos.runtime.v2.RestartError"> & {
+  /**
+   * @generated from field: string host_id = 1;
+   */
+  hostId: string;
+
+  /**
+   * @generated from field: string error = 2;
+   */
+  error: string;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.RestartError.
+ * Use `create(RestartErrorSchema)` to create a new message.
+ */
+export declare const RestartErrorSchema: GenMessage<RestartError>;
+
+/**
+ * @generated from message nomos.runtime.v2.RestartReport
+ */
+export declare type RestartReport = Message<"nomos.runtime.v2.RestartReport"> & {
+  /**
+   * @generated from field: bool ok = 1;
+   */
+  ok: boolean;
+
+  /**
+   * @generated from field: repeated string host_ids = 2;
+   */
+  hostIds: string[];
+
+  /**
+   * @generated from field: repeated nomos.runtime.v2.RestartedHost restarted = 3;
+   */
+  restarted: RestartedHost[];
+
+  /**
+   * @generated from field: repeated nomos.runtime.v2.RestartError errors = 4;
+   */
+  errors: RestartError[];
+};
+
+/**
+ * Describes the message nomos.runtime.v2.RestartReport.
+ * Use `create(RestartReportSchema)` to create a new message.
+ */
+export declare const RestartReportSchema: GenMessage<RestartReport>;
+
+/**
+ * @generated from enum nomos.runtime.v2.ResidentWorkspaceReadiness
+ */
+export enum ResidentWorkspaceReadiness {
+  /**
+   * @generated from enum value: RESIDENT_WORKSPACE_READINESS_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * @generated from enum value: RESIDENT_WORKSPACE_READINESS_SQLITE_ONLY = 1;
+   */
+  SQLITE_ONLY = 1,
+
+  /**
+   * @generated from enum value: RESIDENT_WORKSPACE_READINESS_GIT_CUSTODY_ONLY = 2;
+   */
+  GIT_CUSTODY_ONLY = 2,
+
+  /**
+   * @generated from enum value: RESIDENT_WORKSPACE_READINESS_SQLITE_AND_GIT_ALIGNED = 3;
+   */
+  SQLITE_AND_GIT_ALIGNED = 3,
+
+  /**
+   * @generated from enum value: RESIDENT_WORKSPACE_READINESS_SQLITE_GIT_FULL_HISTORY = 4;
+   */
+  SQLITE_GIT_FULL_HISTORY = 4,
+
+  /**
+   * Both physical capabilities exist, but their heads differ. This is maintenance debt, never a
+   * weaker form of ALIGNED readiness.
+   *
+   * @generated from enum value: RESIDENT_WORKSPACE_READINESS_HEADS_DIVERGED = 5;
+   */
+  HEADS_DIVERGED = 5,
+}
+
+/**
+ * Describes the enum nomos.runtime.v2.ResidentWorkspaceReadiness.
+ */
+export declare const ResidentWorkspaceReadinessSchema: GenEnum<ResidentWorkspaceReadiness>;
+
+/**
+ * @generated from enum nomos.runtime.v2.LocalHistoryPosture
+ */
+export enum LocalHistoryPosture {
+  /**
+   * @generated from enum value: LOCAL_HISTORY_POSTURE_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * @generated from enum value: LOCAL_HISTORY_POSTURE_PARTIAL = 1;
+   */
+  PARTIAL = 1,
+
+  /**
+   * @generated from enum value: LOCAL_HISTORY_POSTURE_COMPLETE = 2;
+   */
+  COMPLETE = 2,
+}
+
+/**
+ * Describes the enum nomos.runtime.v2.LocalHistoryPosture.
+ */
+export declare const LocalHistoryPostureSchema: GenEnum<LocalHistoryPosture>;