@miradorlabs/web-grpc 3.32.0 → 3.34.0

package/proto/gateway/web/v1/admin_gateway.ts

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.15.0
+//   protoc-gen-ts_proto  v2.15.3
 //   protoc               v3.21.12
 // source: proto/gateway/web/v1/admin_gateway.proto
 
@@ -9,6 +9,12 @@ import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
 import type { Metadata } from "@grpc/grpc-js";
 import { Timestamp } from "../../../../google/protobuf/timestamp";
 import { ResponseStatus } from "../../common/v1/status";
+import {
+  RelayHeartbeatFilter,
+  RelayHeartbeatSort,
+  relayHeartbeatSortFromJSON,
+  relayHeartbeatSortToJSON,
+} from "./ai_gateway";
 import { InviteCodeState, inviteCodeStateFromJSON, inviteCodeStateToJSON } from "./beta_gateway";
 import { AIReferenceGroupFilter, AIReferenceName } from "./reference_gateway";
 
@@ -188,6 +194,74 @@ export interface ConfirmAIBillersResponse {
   confirmedNameCount: number;
 }
 
+export interface ListAdminRelayHeartbeatsRequest {
+  filter:
+    | RelayHeartbeatFilter
+    | undefined;
+  /** Unspecified is RELAY_HEARTBEAT_SORT_LAST_SEEN_DESC; an unknown value is a validation error. */
+  sort: RelayHeartbeatSort;
+  /** The server default (100) when 0, coerced to 1000 above it; negative is a validation error. */
+  pageSize: number;
+  /**
+   * Opaque keyset cursor from a prior response's next_page_token; empty starts at the most recently seen
+   * relay. Valid only with the scope, sort and filter that produced it (the page size may change); any other token
+   * is a validation error. Weakly consistent: the order key (last_seen) moves forward as
+   * heartbeats arrive, so a relay that beats while the caller pages moves ahead of the cursor and is missed until
+   * a refresh.
+   */
+  pageToken: string;
+}
+
+export interface ListAdminRelayHeartbeatsResponse {
+  status: ResponseStatus | undefined;
+  relayHeartbeats: AdminRelayHeartbeat[];
+  /** Empty once the last page has been returned. */
+  nextPageToken: string;
+}
+
+/**
+ * AdminRelayHeartbeat mirrors telemetry.api.v1.AdminRelayHeartbeat. One relay machine for staff: RelayHeartbeat's
+ * summary plus the latest heartbeat's metadata and counters. The gateway stamps the organization, project, first and
+ * last seen and key id; the rest is what the relay reported, for display only. Every latest field is from one
+ * heartbeat, the last the gateway received.
+ */
+export interface AdminRelayHeartbeat {
+  organizationId: string;
+  projectId: string;
+  /** terma.user.id as the relay reported it; "" = signed out or an older relay. Client-claimed: display only. */
+  accountUserId: string;
+  hostName: string;
+  /** first heartbeat the gateway received */
+  firstSeen:
+    | Date
+    | undefined;
+  /** latest heartbeat the gateway received */
+  lastSeen:
+    | Date
+    | undefined;
+  /** of the latest heartbeat (by received time) */
+  termaVersion: string;
+  /** of the latest heartbeat: service, hook, manual, verbatim */
+  launch: string;
+  /** of the latest heartbeat: start, interval, setup, exit, verbatim */
+  reason: string;
+  /** of the latest heartbeat, verbatim; "" unless the relay stopped */
+  exitReason: string;
+  /** the key that signed the latest heartbeat */
+  miradorApiKeyId: string;
+  /**
+   * The latest heartbeat's terma.relay.heartbeat.counter.<name> ints by <name> (received.logs, dropped.no_key.traces,
+   * ...): figures since the beat before it that carried counters, not lifetime totals. A missing name was not
+   * reported, never zero; an empty map is a beat that carried none.
+   */
+  counters: { [key: string]: number };
+}
+
+export interface AdminRelayHeartbeat_CountersEntry {
+  key: string;
+  value: number;
+}
+
 function createBaseGetAdminStatusRequest(): GetAdminStatusRequest {
   return {};
 }
@@ -2541,6 +2615,663 @@ export const ConfirmAIBillersResponse: MessageFns<ConfirmAIBillersResponse> = {
   },
 };
 
+function createBaseListAdminRelayHeartbeatsRequest(): ListAdminRelayHeartbeatsRequest {
+  return { filter: undefined, sort: 0, pageSize: 0, pageToken: "" };
+}
+
+export const ListAdminRelayHeartbeatsRequest: MessageFns<ListAdminRelayHeartbeatsRequest> = {
+  encode(message: ListAdminRelayHeartbeatsRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.filter !== undefined) {
+      RelayHeartbeatFilter.encode(message.filter, writer.uint32(10).fork()).join();
+    }
+    if (message.sort !== 0) {
+      writer.uint32(16).int32(message.sort);
+    }
+    if (message.pageSize !== 0) {
+      writer.uint32(24).int32(message.pageSize);
+    }
+    if (message.pageToken !== "") {
+      writer.uint32(34).string(message.pageToken);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ListAdminRelayHeartbeatsRequest {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
+    if (previousRecursionDepth >= 100) {
+      throw new globalThis.Error("protobuf decode recursion limit exceeded");
+    }
+    (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
+    try {
+      const end = length === undefined ? reader.len : reader.pos + length;
+      const message = createBaseListAdminRelayHeartbeatsRequest();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.filter = RelayHeartbeatFilter.decode(reader, reader.uint32());
+            continue;
+          }
+          case 2: {
+            if (tag !== 16) {
+              break;
+            }
+
+            message.sort = reader.int32() as any;
+            continue;
+          }
+          case 3: {
+            if (tag !== 24) {
+              break;
+            }
+
+            message.pageSize = reader.int32();
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.pageToken = reader.string();
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): ListAdminRelayHeartbeatsRequest {
+    return {
+      filter: isSet(object.filter) ? RelayHeartbeatFilter.fromJSON(object.filter) : undefined,
+      sort: isSet(object.sort) ? relayHeartbeatSortFromJSON(object.sort) : 0,
+      pageSize: isSet(object.pageSize)
+        ? globalThis.Number(object.pageSize)
+        : isSet(object.page_size)
+        ? globalThis.Number(object.page_size)
+        : 0,
+      pageToken: isSet(object.pageToken)
+        ? globalThis.String(object.pageToken)
+        : isSet(object.page_token)
+        ? globalThis.String(object.page_token)
+        : "",
+    };
+  },
+
+  toJSON(message: ListAdminRelayHeartbeatsRequest): unknown {
+    const obj: any = {};
+    if (message.filter !== undefined) {
+      obj.filter = RelayHeartbeatFilter.toJSON(message.filter);
+    }
+    if (message.sort !== 0) {
+      obj.sort = relayHeartbeatSortToJSON(message.sort);
+    }
+    if (message.pageSize !== 0) {
+      obj.pageSize = Math.round(message.pageSize);
+    }
+    if (message.pageToken !== "") {
+      obj.pageToken = message.pageToken;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<ListAdminRelayHeartbeatsRequest>, I>>(base?: I): ListAdminRelayHeartbeatsRequest {
+    return ListAdminRelayHeartbeatsRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ListAdminRelayHeartbeatsRequest>, I>>(
+    object: I,
+  ): ListAdminRelayHeartbeatsRequest {
+    const message = createBaseListAdminRelayHeartbeatsRequest();
+    message.filter = (object.filter !== undefined && object.filter !== null)
+      ? RelayHeartbeatFilter.fromPartial(object.filter)
+      : undefined;
+    message.sort = object.sort ?? 0;
+    message.pageSize = object.pageSize ?? 0;
+    message.pageToken = object.pageToken ?? "";
+    return message;
+  },
+};
+
+function createBaseListAdminRelayHeartbeatsResponse(): ListAdminRelayHeartbeatsResponse {
+  return { status: undefined, relayHeartbeats: [], nextPageToken: "" };
+}
+
+export const ListAdminRelayHeartbeatsResponse: MessageFns<ListAdminRelayHeartbeatsResponse> = {
+  encode(message: ListAdminRelayHeartbeatsResponse, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.status !== undefined) {
+      ResponseStatus.encode(message.status, writer.uint32(10).fork()).join();
+    }
+    for (const v of message.relayHeartbeats) {
+      AdminRelayHeartbeat.encode(v!, writer.uint32(18).fork()).join();
+    }
+    if (message.nextPageToken !== "") {
+      writer.uint32(26).string(message.nextPageToken);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ListAdminRelayHeartbeatsResponse {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
+    if (previousRecursionDepth >= 100) {
+      throw new globalThis.Error("protobuf decode recursion limit exceeded");
+    }
+    (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
+    try {
+      const end = length === undefined ? reader.len : reader.pos + length;
+      const message = createBaseListAdminRelayHeartbeatsResponse();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.status = ResponseStatus.decode(reader, reader.uint32());
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.relayHeartbeats.push(AdminRelayHeartbeat.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.nextPageToken = reader.string();
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): ListAdminRelayHeartbeatsResponse {
+    return {
+      status: isSet(object.status) ? ResponseStatus.fromJSON(object.status) : undefined,
+      relayHeartbeats: globalThis.Array.isArray(object?.relayHeartbeats)
+        ? object.relayHeartbeats.map((e: any) => AdminRelayHeartbeat.fromJSON(e))
+        : globalThis.Array.isArray(object?.relay_heartbeats)
+        ? object.relay_heartbeats.map((e: any) => AdminRelayHeartbeat.fromJSON(e))
+        : [],
+      nextPageToken: isSet(object.nextPageToken)
+        ? globalThis.String(object.nextPageToken)
+        : isSet(object.next_page_token)
+        ? globalThis.String(object.next_page_token)
+        : "",
+    };
+  },
+
+  toJSON(message: ListAdminRelayHeartbeatsResponse): unknown {
+    const obj: any = {};
+    if (message.status !== undefined) {
+      obj.status = ResponseStatus.toJSON(message.status);
+    }
+    if (message.relayHeartbeats?.length) {
+      obj.relayHeartbeats = message.relayHeartbeats.map((e) => AdminRelayHeartbeat.toJSON(e));
+    }
+    if (message.nextPageToken !== "") {
+      obj.nextPageToken = message.nextPageToken;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<ListAdminRelayHeartbeatsResponse>, I>>(
+    base?: I,
+  ): ListAdminRelayHeartbeatsResponse {
+    return ListAdminRelayHeartbeatsResponse.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ListAdminRelayHeartbeatsResponse>, I>>(
+    object: I,
+  ): ListAdminRelayHeartbeatsResponse {
+    const message = createBaseListAdminRelayHeartbeatsResponse();
+    message.status = (object.status !== undefined && object.status !== null)
+      ? ResponseStatus.fromPartial(object.status)
+      : undefined;
+    message.relayHeartbeats = object.relayHeartbeats?.map((e) => AdminRelayHeartbeat.fromPartial(e)) || [];
+    message.nextPageToken = object.nextPageToken ?? "";
+    return message;
+  },
+};
+
+function createBaseAdminRelayHeartbeat(): AdminRelayHeartbeat {
+  return {
+    organizationId: "",
+    projectId: "",
+    accountUserId: "",
+    hostName: "",
+    firstSeen: undefined,
+    lastSeen: undefined,
+    termaVersion: "",
+    launch: "",
+    reason: "",
+    exitReason: "",
+    miradorApiKeyId: "",
+    counters: {},
+  };
+}
+
+export const AdminRelayHeartbeat: MessageFns<AdminRelayHeartbeat> = {
+  encode(message: AdminRelayHeartbeat, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.organizationId !== "") {
+      writer.uint32(10).string(message.organizationId);
+    }
+    if (message.projectId !== "") {
+      writer.uint32(18).string(message.projectId);
+    }
+    if (message.accountUserId !== "") {
+      writer.uint32(26).string(message.accountUserId);
+    }
+    if (message.hostName !== "") {
+      writer.uint32(34).string(message.hostName);
+    }
+    if (message.firstSeen !== undefined) {
+      Timestamp.encode(toTimestamp(message.firstSeen), writer.uint32(42).fork()).join();
+    }
+    if (message.lastSeen !== undefined) {
+      Timestamp.encode(toTimestamp(message.lastSeen), writer.uint32(50).fork()).join();
+    }
+    if (message.termaVersion !== "") {
+      writer.uint32(58).string(message.termaVersion);
+    }
+    if (message.launch !== "") {
+      writer.uint32(66).string(message.launch);
+    }
+    if (message.reason !== "") {
+      writer.uint32(74).string(message.reason);
+    }
+    if (message.exitReason !== "") {
+      writer.uint32(82).string(message.exitReason);
+    }
+    if (message.miradorApiKeyId !== "") {
+      writer.uint32(90).string(message.miradorApiKeyId);
+    }
+    globalThis.Object.entries(message.counters).forEach(([key, value]: [string, number]) => {
+      AdminRelayHeartbeat_CountersEntry.encode({ key: key as any, value }, writer.uint32(98).fork()).join();
+    });
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): AdminRelayHeartbeat {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
+    if (previousRecursionDepth >= 100) {
+      throw new globalThis.Error("protobuf decode recursion limit exceeded");
+    }
+    (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
+    try {
+      const end = length === undefined ? reader.len : reader.pos + length;
+      const message = createBaseAdminRelayHeartbeat();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.organizationId = reader.string();
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.projectId = reader.string();
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.accountUserId = reader.string();
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.hostName = reader.string();
+            continue;
+          }
+          case 5: {
+            if (tag !== 42) {
+              break;
+            }
+
+            message.firstSeen = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 6: {
+            if (tag !== 50) {
+              break;
+            }
+
+            message.lastSeen = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 7: {
+            if (tag !== 58) {
+              break;
+            }
+
+            message.termaVersion = reader.string();
+            continue;
+          }
+          case 8: {
+            if (tag !== 66) {
+              break;
+            }
+
+            message.launch = reader.string();
+            continue;
+          }
+          case 9: {
+            if (tag !== 74) {
+              break;
+            }
+
+            message.reason = reader.string();
+            continue;
+          }
+          case 10: {
+            if (tag !== 82) {
+              break;
+            }
+
+            message.exitReason = reader.string();
+            continue;
+          }
+          case 11: {
+            if (tag !== 90) {
+              break;
+            }
+
+            message.miradorApiKeyId = reader.string();
+            continue;
+          }
+          case 12: {
+            if (tag !== 98) {
+              break;
+            }
+
+            const entry12 = AdminRelayHeartbeat_CountersEntry.decode(reader, reader.uint32());
+            if (entry12.value !== undefined) {
+              message.counters[entry12.key] = entry12.value;
+            }
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): AdminRelayHeartbeat {
+    return {
+      organizationId: isSet(object.organizationId)
+        ? globalThis.String(object.organizationId)
+        : isSet(object.organization_id)
+        ? globalThis.String(object.organization_id)
+        : "",
+      projectId: isSet(object.projectId)
+        ? globalThis.String(object.projectId)
+        : isSet(object.project_id)
+        ? globalThis.String(object.project_id)
+        : "",
+      accountUserId: isSet(object.accountUserId)
+        ? globalThis.String(object.accountUserId)
+        : isSet(object.account_user_id)
+        ? globalThis.String(object.account_user_id)
+        : "",
+      hostName: isSet(object.hostName)
+        ? globalThis.String(object.hostName)
+        : isSet(object.host_name)
+        ? globalThis.String(object.host_name)
+        : "",
+      firstSeen: isSet(object.firstSeen)
+        ? fromJsonTimestamp(object.firstSeen)
+        : isSet(object.first_seen)
+        ? fromJsonTimestamp(object.first_seen)
+        : undefined,
+      lastSeen: isSet(object.lastSeen)
+        ? fromJsonTimestamp(object.lastSeen)
+        : isSet(object.last_seen)
+        ? fromJsonTimestamp(object.last_seen)
+        : undefined,
+      termaVersion: isSet(object.termaVersion)
+        ? globalThis.String(object.termaVersion)
+        : isSet(object.terma_version)
+        ? globalThis.String(object.terma_version)
+        : "",
+      launch: isSet(object.launch) ? globalThis.String(object.launch) : "",
+      reason: isSet(object.reason) ? globalThis.String(object.reason) : "",
+      exitReason: isSet(object.exitReason)
+        ? globalThis.String(object.exitReason)
+        : isSet(object.exit_reason)
+        ? globalThis.String(object.exit_reason)
+        : "",
+      miradorApiKeyId: isSet(object.miradorApiKeyId)
+        ? globalThis.String(object.miradorApiKeyId)
+        : isSet(object.mirador_api_key_id)
+        ? globalThis.String(object.mirador_api_key_id)
+        : "",
+      counters: isObject(object.counters)
+        ? (globalThis.Object.entries(object.counters) as [string, any][]).reduce(
+          (acc: { [key: string]: number }, [key, value]: [string, any]) => {
+            globalThis.Object.defineProperty(acc, key, {
+              value: globalThis.Number(value),
+              enumerable: true,
+              configurable: true,
+              writable: true,
+            });
+            return acc;
+          },
+          {},
+        )
+        : {},
+    };
+  },
+
+  toJSON(message: AdminRelayHeartbeat): unknown {
+    const obj: any = {};
+    if (message.organizationId !== "") {
+      obj.organizationId = message.organizationId;
+    }
+    if (message.projectId !== "") {
+      obj.projectId = message.projectId;
+    }
+    if (message.accountUserId !== "") {
+      obj.accountUserId = message.accountUserId;
+    }
+    if (message.hostName !== "") {
+      obj.hostName = message.hostName;
+    }
+    if (message.firstSeen !== undefined) {
+      obj.firstSeen = message.firstSeen.toISOString();
+    }
+    if (message.lastSeen !== undefined) {
+      obj.lastSeen = message.lastSeen.toISOString();
+    }
+    if (message.termaVersion !== "") {
+      obj.termaVersion = message.termaVersion;
+    }
+    if (message.launch !== "") {
+      obj.launch = message.launch;
+    }
+    if (message.reason !== "") {
+      obj.reason = message.reason;
+    }
+    if (message.exitReason !== "") {
+      obj.exitReason = message.exitReason;
+    }
+    if (message.miradorApiKeyId !== "") {
+      obj.miradorApiKeyId = message.miradorApiKeyId;
+    }
+    if (message.counters) {
+      const entries = globalThis.Object.entries(message.counters) as [string, number][];
+      if (entries.length > 0) {
+        obj.counters = {};
+        entries.forEach(([k, v]) => {
+          obj.counters[k] = Math.round(v);
+        });
+      }
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<AdminRelayHeartbeat>, I>>(base?: I): AdminRelayHeartbeat {
+    return AdminRelayHeartbeat.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<AdminRelayHeartbeat>, I>>(object: I): AdminRelayHeartbeat {
+    const message = createBaseAdminRelayHeartbeat();
+    message.organizationId = object.organizationId ?? "";
+    message.projectId = object.projectId ?? "";
+    message.accountUserId = object.accountUserId ?? "";
+    message.hostName = object.hostName ?? "";
+    message.firstSeen = object.firstSeen ?? undefined;
+    message.lastSeen = object.lastSeen ?? undefined;
+    message.termaVersion = object.termaVersion ?? "";
+    message.launch = object.launch ?? "";
+    message.reason = object.reason ?? "";
+    message.exitReason = object.exitReason ?? "";
+    message.miradorApiKeyId = object.miradorApiKeyId ?? "";
+    message.counters = (globalThis.Object.entries(object.counters ?? {}) as [string, number][]).reduce(
+      (acc: { [key: string]: number }, [key, value]: [string, number]) => {
+        if (value !== undefined) {
+          acc[key] = globalThis.Number(value);
+        }
+        return acc;
+      },
+      {},
+    );
+    return message;
+  },
+};
+
+function createBaseAdminRelayHeartbeat_CountersEntry(): AdminRelayHeartbeat_CountersEntry {
+  return { key: "", value: 0 };
+}
+
+export const AdminRelayHeartbeat_CountersEntry: MessageFns<AdminRelayHeartbeat_CountersEntry> = {
+  encode(message: AdminRelayHeartbeat_CountersEntry, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.key !== "") {
+      writer.uint32(10).string(message.key);
+    }
+    if (message.value !== 0) {
+      writer.uint32(16).int64(message.value);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): AdminRelayHeartbeat_CountersEntry {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
+    if (previousRecursionDepth >= 100) {
+      throw new globalThis.Error("protobuf decode recursion limit exceeded");
+    }
+    (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
+    try {
+      const end = length === undefined ? reader.len : reader.pos + length;
+      const message = createBaseAdminRelayHeartbeat_CountersEntry();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.key = reader.string();
+            continue;
+          }
+          case 2: {
+            if (tag !== 16) {
+              break;
+            }
+
+            message.value = longToNumber(reader.int64());
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): AdminRelayHeartbeat_CountersEntry {
+    return {
+      key: isSet(object.key) ? globalThis.String(object.key) : "",
+      value: isSet(object.value) ? globalThis.Number(object.value) : 0,
+    };
+  },
+
+  toJSON(message: AdminRelayHeartbeat_CountersEntry): unknown {
+    const obj: any = {};
+    if (message.key !== "") {
+      obj.key = message.key;
+    }
+    if (message.value !== 0) {
+      obj.value = Math.round(message.value);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<AdminRelayHeartbeat_CountersEntry>, I>>(
+    base?: I,
+  ): AdminRelayHeartbeat_CountersEntry {
+    return AdminRelayHeartbeat_CountersEntry.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<AdminRelayHeartbeat_CountersEntry>, I>>(
+    object: I,
+  ): AdminRelayHeartbeat_CountersEntry {
+    const message = createBaseAdminRelayHeartbeat_CountersEntry();
+    message.key = object.key ?? "";
+    message.value = object.value ?? 0;
+    return message;
+  },
+};
+
 /**
  * AdminGatewayService is the browser-facing surface of the admin tools, across every domain, which only
  * Mirador staff (a verified mirador.org primary email) may use. The gateway's admin gate admits every RPC
@@ -2574,6 +3305,15 @@ export interface AdminGatewayService {
   ConfirmAIModels(request: ConfirmAIModelsRequest, metadata?: Metadata): Promise<ConfirmAIModelsResponse>;
   ConfirmAIEfforts(request: ConfirmAIEffortsRequest, metadata?: Metadata): Promise<ConfirmAIEffortsResponse>;
   ConfirmAIBillers(request: ConfirmAIBillersRequest, metadata?: Metadata): Promise<ConfirmAIBillersResponse>;
+  /**
+   * Every Terma relay across the fleet with its latest heartbeat in full, one row per (organization, project, user,
+   * host), most recently seen first (keyset-paginated); it proxies
+   * telemetry.api.v1.TelemetryAdminService.ListRelayHeartbeats. Rows carry ids, not names.
+   */
+  ListRelayHeartbeats(
+    request: ListAdminRelayHeartbeatsRequest,
+    metadata?: Metadata,
+  ): Promise<ListAdminRelayHeartbeatsResponse>;
 }
 
 export const AdminGatewayServiceServiceName = "gateway.web.v1.AdminGatewayService";
@@ -2595,6 +3335,7 @@ export class AdminGatewayServiceClientImpl implements AdminGatewayService {
     this.ConfirmAIModels = this.ConfirmAIModels.bind(this);
     this.ConfirmAIEfforts = this.ConfirmAIEfforts.bind(this);
     this.ConfirmAIBillers = this.ConfirmAIBillers.bind(this);
+    this.ListRelayHeartbeats = this.ListRelayHeartbeats.bind(this);
   }
   GetAdminStatus(request: GetAdminStatusRequest, metadata?: Metadata): Promise<GetAdminStatusResponse> {
     const data = GetAdminStatusRequest.encode(request).finish();
@@ -2667,6 +3408,15 @@ export class AdminGatewayServiceClientImpl implements AdminGatewayService {
     const promise = this.rpc.request(this.service, "ConfirmAIBillers", data, metadata);
     return promise.then((data) => ConfirmAIBillersResponse.decode(new BinaryReader(data)));
   }
+
+  ListRelayHeartbeats(
+    request: ListAdminRelayHeartbeatsRequest,
+    metadata?: Metadata,
+  ): Promise<ListAdminRelayHeartbeatsResponse> {
+    const data = ListAdminRelayHeartbeatsRequest.encode(request).finish();
+    const promise = this.rpc.request(this.service, "ListRelayHeartbeats", data, metadata);
+    return promise.then((data) => ListAdminRelayHeartbeatsResponse.decode(new BinaryReader(data)));
+  }
 }
 
 interface Rpc {
@@ -2718,6 +3468,10 @@ function longToNumber(int64: { toString(): string }): number {
   return num;
 }
 
+function isObject(value: any): boolean {
+  return typeof value === "object" && value !== null;
+}
+
 function isSet(value: any): boolean {
   return value !== null && value !== undefined;
 }