@githolon/runtime 0.110.0

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

@@ -0,0 +1,611 @@
+// @generated by protoc-gen-es v2.13.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file nomos/runtime/v2/custody_desk.proto (package nomos.runtime.v2, syntax proto3)
+/* eslint-disable */
+
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+
+/**
+ * Describes the file nomos/runtime/v2/custody_desk.proto.
+ */
+export declare const file_nomos_runtime_v2_custody_desk: GenFile;
+
+/**
+ * The custody desk opens and inventories persistent Git custody. It has no
+ * application-session command: interaction binding lives in interaction_desk,
+ * while replica acquisition belongs exclusively to the background follow.
+ * A workspace custody open in progress: the one progress fact shared by host health, the
+ * shell's local-custody receipt and the office's answer to a paper that must wait for it.
+ * The workspace is named because an operator and a waiting peer must see which open it is.
+ *
+ * @generated from message nomos.runtime.v2.CustodyOpening
+ */
+export declare type CustodyOpening = Message<"nomos.runtime.v2.CustodyOpening"> & {
+  /**
+   * @generated from field: string workspace = 1;
+   */
+  workspace: string;
+
+  /**
+   * advertise | fetch | import | restore | retry-wait
+   *
+   * @generated from field: string phase = 2;
+   */
+  phase: string;
+
+  /**
+   * 1-based attempt currently running or next to run, and the attempt budget.
+   *
+   * @generated from field: uint32 attempt = 3;
+   */
+  attempt: number;
+
+  /**
+   * @generated from field: uint32 attempts = 4;
+   */
+  attempts: number;
+
+  /**
+   * @generated from field: uint64 started_unix_millis = 5;
+   */
+  startedUnixMillis: bigint;
+
+  /**
+   * @generated from field: uint64 phase_started_unix_millis = 6;
+   */
+  phaseStartedUnixMillis: bigint;
+
+  /**
+   * The most recent failed attempt, cut to a bounded length. Empty until one fails.
+   *
+   * @generated from field: string last_error = 7;
+   */
+  lastError: string;
+
+  /**
+   * @generated from field: uint64 last_error_unix_millis = 8;
+   */
+  lastErrorUnixMillis: bigint;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.CustodyOpening.
+ * Use `create(CustodyOpeningSchema)` to create a new message.
+ */
+export declare const CustodyOpeningSchema: GenMessage<CustodyOpening>;
+
+/**
+ * The answer to a paper whose workspace is still being opened. The paper was not executed:
+ * resend it after retry_after_millis. Opening continues regardless of who waits.
+ *
+ * @generated from message nomos.runtime.v2.WorkspaceOpening
+ */
+export declare type WorkspaceOpening = Message<"nomos.runtime.v2.WorkspaceOpening"> & {
+  /**
+   * @generated from field: nomos.runtime.v2.CustodyOpening opening = 1;
+   */
+  opening?: CustodyOpening | undefined;
+
+  /**
+   * @generated from field: uint32 retry_after_millis = 2;
+   */
+  retryAfterMillis: number;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.WorkspaceOpening.
+ * Use `create(WorkspaceOpeningSchema)` to create a new message.
+ */
+export declare const WorkspaceOpeningSchema: GenMessage<WorkspaceOpening>;
+
+/**
+ * @generated from message nomos.runtime.v2.ListWorkspacesRequest
+ */
+export declare type ListWorkspacesRequest = Message<"nomos.runtime.v2.ListWorkspacesRequest"> & {
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ListWorkspacesRequest.
+ * Use `create(ListWorkspacesRequestSchema)` to create a new message.
+ */
+export declare const ListWorkspacesRequestSchema: GenMessage<ListWorkspacesRequest>;
+
+/**
+ * The peer's local physical inventory: the union of kernel-resident workspaces
+ * and the replica follows this peer keeps. Observation only: listing never
+ * acquires custody, mounts, fetches, or reads history; its cost is bounded by
+ * the inventory's size.
+ *
+ * @generated from message nomos.runtime.v2.WorkspaceSummary
+ */
+export declare type WorkspaceSummary = Message<"nomos.runtime.v2.WorkspaceSummary"> & {
+  /**
+   * @generated from field: string workspace = 2;
+   */
+  workspace: string;
+
+  /**
+   * @generated from field: repeated string sessions = 5;
+   */
+  sessions: string[];
+
+  /**
+   * @generated from field: bool kernel_resident = 6;
+   */
+  kernelResident: boolean;
+
+  /**
+   * Observed in this listing only for kernel-resident workspaces; a followed
+   * workspace whose kernel is not resident reports false without a ref read.
+   *
+   * @generated from field: bool git_custodied = 7;
+   */
+  gitCustodied: boolean;
+
+  /**
+   * This peer keeps a replica follow for the workspace.
+   *
+   * @generated from field: bool followed = 8;
+   */
+  followed: boolean;
+
+  /**
+   * Domain key -> law identity (sha256) the workspace currently serves: a
+   * kernel-authored observation present only when its kernel is resident.
+   *
+   * @generated from field: map<string, string> current_law = 9;
+   */
+  currentLaw: { [key: string]: string };
+
+  /**
+   * The provider now serves this name from a DIFFERENT genesis than this peer's
+   * local custody: the workspace was re-founded ("reborn") remotely. Sync refuses
+   * to merge, rebase or offer across geneses and holds no retry; dropping the
+   * local copy is the application's fix. Present only while that is the case.
+   *
+   * @generated from field: optional nomos.runtime.v2.WorkspaceRebirth reborn_remotely = 10;
+   */
+  rebornRemotely?: WorkspaceRebirth | undefined;
+
+  /**
+   * An application-authorized drop of the local copy is waiting for, or running,
+   * its refetch from the current provider.
+   *
+   * @generated from field: bool local_copy_drop_pending = 11;
+   */
+  localCopyDropPending: boolean;
+
+  /**
+   * This peer's kernel refuses the local copy's custody format (it was written by an
+   * older storage format). The copy is kept, never synced, maintained or retried; the
+   * application opens around it. Present only while that is the case: the reason.
+   *
+   * @generated from field: optional string local_copy_unreadable = 12;
+   */
+  localCopyUnreadable?: string | undefined;
+
+  /**
+   * Local copies this peer replaced and preserved (never deleted) under
+   * refs/heads/custody-preserved/, with what they held that the provider never admitted.
+   *
+   * @generated from field: repeated nomos.runtime.v2.PreservedLocalCopy preserved_copies = 13;
+   */
+  preservedCopies: PreservedLocalCopy[];
+};
+
+/**
+ * Describes the message nomos.runtime.v2.WorkspaceSummary.
+ * Use `create(WorkspaceSummarySchema)` to create a new message.
+ */
+export declare const WorkspaceSummarySchema: GenMessage<WorkspaceSummary>;
+
+/**
+ * A local copy replaced by a refetch and kept aside, not merged. Recorded when the
+ * replacement happens, from Git alone, so it stays visible after main moved on.
+ *
+ * @generated from message nomos.runtime.v2.PreservedLocalCopy
+ */
+export declare type PreservedLocalCopy = Message<"nomos.runtime.v2.PreservedLocalCopy"> & {
+  /**
+   * @generated from field: string workspace = 1;
+   */
+  workspace: string;
+
+  /**
+   * @generated from field: string preserved_head = 2;
+   */
+  preservedHead: string;
+
+  /**
+   * refs/heads/custody-preserved/<preserved_head>
+   *
+   * @generated from field: string preserved_ref = 3;
+   */
+  preservedRef: string;
+
+  /**
+   * Why it was replaced, e.g. "local copy is from an older storage format".
+   *
+   * @generated from field: string reason = 4;
+   */
+  reason: string;
+
+  /**
+   * Commits on the preserved copy above the provider's last admitted head.
+   *
+   * @generated from field: uint64 unsynced_local_changes = 5;
+   */
+  unsyncedLocalChanges: bigint;
+
+  /**
+   * False when Git could not determine them: unsynced_local_changes then means "unknown".
+   *
+   * @generated from field: bool changes_counted = 6;
+   */
+  changesCounted: boolean;
+
+  /**
+   * The application's own open refetched it (an unreadable Home), not a user's drop.
+   *
+   * @generated from field: bool automatic = 7;
+   */
+  automatic: boolean;
+
+  /**
+   * @generated from field: uint64 preserved_at_unix_millis = 8;
+   */
+  preservedAtUnixMillis: bigint;
+
+  /**
+   * @generated from field: optional string synced_head = 9;
+   */
+  syncedHead?: string | undefined;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.PreservedLocalCopy.
+ * Use `create(PreservedLocalCopySchema)` to create a new message.
+ */
+export declare const PreservedLocalCopySchema: GenMessage<PreservedLocalCopy>;
+
+/**
+ * Local custody belongs to a different genesis than the one the provider serves.
+ *
+ * @generated from message nomos.runtime.v2.WorkspaceRebirth
+ */
+export declare type WorkspaceRebirth = Message<"nomos.runtime.v2.WorkspaceRebirth"> & {
+  /**
+   * @generated from field: string local_genesis = 1;
+   */
+  localGenesis: string;
+
+  /**
+   * @generated from field: string remote_genesis = 2;
+   */
+  remoteGenesis: string;
+
+  /**
+   * @generated from field: string local_head = 3;
+   */
+  localHead: string;
+
+  /**
+   * @generated from field: string remote_head = 4;
+   */
+  remoteHead: string;
+
+  /**
+   * Short human-readable explanation, suitable next to the workspace's name.
+   *
+   * @generated from field: string detail = 5;
+   */
+  detail: string;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.WorkspaceRebirth.
+ * Use `create(WorkspaceRebirthSchema)` to create a new message.
+ */
+export declare const WorkspaceRebirthSchema: GenMessage<WorkspaceRebirth>;
+
+/**
+ * What dropping this peer's local copy of a workspace would discard. Local-only
+ * observation: no network, no mutation. A device replica is a droppable cache of
+ * the provider's custody; these counts are the work that cache holds which the
+ * provider has not admitted.
+ *
+ * @generated from message nomos.runtime.v2.PreviewLocalCopyDropRequest
+ */
+export declare type PreviewLocalCopyDropRequest = Message<"nomos.runtime.v2.PreviewLocalCopyDropRequest"> & {
+  /**
+   * @generated from field: string workspace = 1;
+   */
+  workspace: string;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.PreviewLocalCopyDropRequest.
+ * Use `create(PreviewLocalCopyDropRequestSchema)` to create a new message.
+ */
+export declare const PreviewLocalCopyDropRequestSchema: GenMessage<PreviewLocalCopyDropRequest>;
+
+/**
+ * @generated from message nomos.runtime.v2.LocalCopyDropPreview
+ */
+export declare type LocalCopyDropPreview = Message<"nomos.runtime.v2.LocalCopyDropPreview"> & {
+  /**
+   * @generated from field: string workspace = 1;
+   */
+  workspace: string;
+
+  /**
+   * The exact local head the drop must name. Absent when there is no local copy.
+   *
+   * @generated from field: optional string local_head = 2;
+   */
+  localHead?: string | undefined;
+
+  /**
+   * The last head the provider admitted and this peer tracked; absent if never synced.
+   *
+   * @generated from field: optional string synced_head = 3;
+   */
+  syncedHead?: string | undefined;
+
+  /**
+   * Local commits the provider has not admitted.
+   *
+   * @generated from field: uint64 unsynced_local_changes = 4;
+   */
+  unsyncedLocalChanges: bigint;
+
+  /**
+   * Refused local intents parked on this device's refused-offer desk.
+   *
+   * @generated from field: uint64 parked_local_changes = 5;
+   */
+  parkedLocalChanges: bigint;
+
+  /**
+   * Outbound letters (cross-workspace effects) not yet delivered.
+   *
+   * @generated from field: uint64 undelivered_letters = 6;
+   */
+  undeliveredLetters: bigint;
+
+  /**
+   * False when the outbox inventory is still being prepared and the letter count
+   * is a lower bound.
+   *
+   * @generated from field: bool letters_counted = 7;
+   */
+  lettersCounted: boolean;
+
+  /**
+   * A provider exists to refetch from. A drop is refused without one.
+   *
+   * @generated from field: bool followed = 8;
+   */
+  followed: boolean;
+
+  /**
+   * @generated from field: optional nomos.runtime.v2.WorkspaceRebirth reborn_remotely = 9;
+   */
+  rebornRemotely?: WorkspaceRebirth | undefined;
+
+  /**
+   * False when the unsynced local changes could not be determined from Git (for example
+   * the provider's last admitted head is not on local main). unsynced_local_changes is
+   * then 0 and means "unknown", never "none".
+   *
+   * @generated from field: bool changes_counted = 10;
+   */
+  changesCounted: boolean;
+
+  /**
+   * The reason this peer's kernel cannot read the local copy, when it cannot.
+   *
+   * @generated from field: optional string local_copy_unreadable = 11;
+   */
+  localCopyUnreadable?: string | undefined;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.LocalCopyDropPreview.
+ * Use `create(LocalCopyDropPreviewSchema)` to create a new message.
+ */
+export declare const LocalCopyDropPreviewSchema: GenMessage<LocalCopyDropPreview>;
+
+/**
+ * Authorize dropping exactly this local head and refetching the workspace from its
+ * current provider. Only this workspace's local custody and its projections, caches
+ * and indexes are replaced; device keys, credentials and other workspaces are not
+ * touched. The previous local head is preserved under a custody-preserved ref.
+ *
+ * @generated from message nomos.runtime.v2.DropLocalCopyRequest
+ */
+export declare type DropLocalCopyRequest = Message<"nomos.runtime.v2.DropLocalCopyRequest"> & {
+  /**
+   * @generated from field: string workspace = 1;
+   */
+  workspace: string;
+
+  /**
+   * @generated from field: string expected_local_head = 2;
+   */
+  expectedLocalHead: string;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.DropLocalCopyRequest.
+ * Use `create(DropLocalCopyRequestSchema)` to create a new message.
+ */
+export declare const DropLocalCopyRequestSchema: GenMessage<DropLocalCopyRequest>;
+
+/**
+ * @generated from message nomos.runtime.v2.LocalCopyDropScheduled
+ */
+export declare type LocalCopyDropScheduled = Message<"nomos.runtime.v2.LocalCopyDropScheduled"> & {
+  /**
+   * @generated from field: string workspace = 1;
+   */
+  workspace: string;
+
+  /**
+   * @generated from field: string dropped_head = 2;
+   */
+  droppedHead: string;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.LocalCopyDropScheduled.
+ * Use `create(LocalCopyDropScheduledSchema)` to create a new message.
+ */
+export declare const LocalCopyDropScheduledSchema: GenMessage<LocalCopyDropScheduled>;
+
+/**
+ * Fetch this workspace now: the explicit form of what a read of a workspace this peer does not
+ * hold reaches (placement discovery, then the Replica Follow its placement retains, which mounts
+ * the provider's head alone). Nothing is read, bound or opened; the answer returns as soon as the
+ * follow exists, and the follow fetches on its own.
+ *
+ * @generated from message nomos.runtime.v2.FetchWorkspaceRequest
+ */
+export declare type FetchWorkspaceRequest = Message<"nomos.runtime.v2.FetchWorkspaceRequest"> & {
+  /**
+   * @generated from field: string workspace = 1;
+   */
+  workspace: string;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.FetchWorkspaceRequest.
+ * Use `create(FetchWorkspaceRequestSchema)` to create a new message.
+ */
+export declare const FetchWorkspaceRequestSchema: GenMessage<FetchWorkspaceRequest>;
+
+/**
+ * A provider serving a workspace's derived law products (architecture/lazy_history.md): the
+ * products of every closure selected at its main, as the kernel exports them from custody.
+ *
+ * @generated from message nomos.runtime.v2.ProvideLawProductsRequest
+ */
+export declare type ProvideLawProductsRequest = Message<"nomos.runtime.v2.ProvideLawProductsRequest"> & {
+  /**
+   * @generated from field: string workspace = 1;
+   */
+  workspace: string;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.ProvideLawProductsRequest.
+ * Use `create(ProvideLawProductsRequestSchema)` to create a new message.
+ */
+export declare const ProvideLawProductsRequestSchema: GenMessage<ProvideLawProductsRequest>;
+
+/**
+ * @generated from message nomos.runtime.v2.WorkspaceFetch
+ */
+export declare type WorkspaceFetch = Message<"nomos.runtime.v2.WorkspaceFetch"> & {
+  /**
+   * @generated from field: string workspace = 1;
+   */
+  workspace: string;
+
+  /**
+   * This peer already holds a readable copy: nothing to fetch.
+   *
+   * @generated from field: bool held = 2;
+   */
+  held: boolean;
+
+  /**
+   * A Replica Follow now retains the workspace and fetches it in the background.
+   *
+   * @generated from field: bool following = 3;
+   */
+  following: boolean;
+
+  /**
+   * Why not, when neither: the placement keeps it remote, or the directory could not be asked.
+   *
+   * @generated from field: string detail = 4;
+   */
+  detail: string;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.WorkspaceFetch.
+ * Use `create(WorkspaceFetchSchema)` to create a new message.
+ */
+export declare const WorkspaceFetchSchema: GenMessage<WorkspaceFetch>;
+
+/**
+ * @generated from message nomos.runtime.v2.WorkspaceList
+ */
+export declare type WorkspaceList = Message<"nomos.runtime.v2.WorkspaceList"> & {
+  /**
+   * @generated from field: repeated nomos.runtime.v2.WorkspaceSummary workspaces = 1;
+   */
+  workspaces: WorkspaceSummary[];
+};
+
+/**
+ * Describes the message nomos.runtime.v2.WorkspaceList.
+ * Use `create(WorkspaceListSchema)` to create a new message.
+ */
+export declare const WorkspaceListSchema: GenMessage<WorkspaceList>;
+
+/**
+ * @generated from message nomos.runtime.v2.WorkspaceStatusRequest
+ */
+export declare type WorkspaceStatusRequest = Message<"nomos.runtime.v2.WorkspaceStatusRequest"> & {
+  /**
+   * @generated from field: string session = 1;
+   */
+  session: string;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.WorkspaceStatusRequest.
+ * Use `create(WorkspaceStatusRequestSchema)` to create a new message.
+ */
+export declare const WorkspaceStatusRequestSchema: GenMessage<WorkspaceStatusRequest>;
+
+/**
+ * Observation only: querying status must not acquire custody, connect a session,
+ * or open a workspace. An absent local head says nothing about remote custody.
+ *
+ * @generated from message nomos.runtime.v2.WorkspaceStatus
+ */
+export declare type WorkspaceStatus = Message<"nomos.runtime.v2.WorkspaceStatus"> & {
+  /**
+   * @generated from field: string workspace = 1;
+   */
+  workspace: string;
+
+  /**
+   * @generated from field: optional string head = 2;
+   */
+  head?: string | undefined;
+
+  /**
+   * Absent on older hosts or when residency cannot be observed.
+   *
+   * @generated from field: optional bool kernel_resident = 3;
+   */
+  kernelResident?: boolean | undefined;
+
+  /**
+   * Last complete physical retention receipt, including delivery metadata.
+   *
+   * @generated from field: optional string sealed_head = 4;
+   */
+  sealedHead?: string | undefined;
+};
+
+/**
+ * Describes the message nomos.runtime.v2.WorkspaceStatus.
+ * Use `create(WorkspaceStatusSchema)` to create a new message.
+ */
+export declare const WorkspaceStatusSchema: GenMessage<WorkspaceStatus>;