@miradorlabs/web-grpc 3.33.0 → 3.35.0

package/proto/gateway/web/v1/ai_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/ai_gateway.proto
 
@@ -878,6 +878,42 @@ export function aIEntitlementRoleToJSON(object: AIEntitlementRole): string {
   }
 }
 
+/** RelayHeartbeatSort mirrors telemetry.api.v1.RelayHeartbeatSort. Unspecified is LAST_SEEN_DESC. */
+export enum RelayHeartbeatSort {
+  /** RELAY_HEARTBEAT_SORT_UNSPECIFIED - = LAST_SEEN_DESC */
+  RELAY_HEARTBEAT_SORT_UNSPECIFIED = 0,
+  /** RELAY_HEARTBEAT_SORT_LAST_SEEN_DESC - last_seen desc, then (organization_id, project_id, account_user_id, host_name) asc */
+  RELAY_HEARTBEAT_SORT_LAST_SEEN_DESC = 1,
+  UNRECOGNIZED = -1,
+}
+
+export function relayHeartbeatSortFromJSON(object: any): RelayHeartbeatSort {
+  switch (object) {
+    case 0:
+    case "RELAY_HEARTBEAT_SORT_UNSPECIFIED":
+      return RelayHeartbeatSort.RELAY_HEARTBEAT_SORT_UNSPECIFIED;
+    case 1:
+    case "RELAY_HEARTBEAT_SORT_LAST_SEEN_DESC":
+      return RelayHeartbeatSort.RELAY_HEARTBEAT_SORT_LAST_SEEN_DESC;
+    case -1:
+    case "UNRECOGNIZED":
+    default:
+      return RelayHeartbeatSort.UNRECOGNIZED;
+  }
+}
+
+export function relayHeartbeatSortToJSON(object: RelayHeartbeatSort): string {
+  switch (object) {
+    case RelayHeartbeatSort.RELAY_HEARTBEAT_SORT_UNSPECIFIED:
+      return "RELAY_HEARTBEAT_SORT_UNSPECIFIED";
+    case RelayHeartbeatSort.RELAY_HEARTBEAT_SORT_LAST_SEEN_DESC:
+      return "RELAY_HEARTBEAT_SORT_LAST_SEEN_DESC";
+    case RelayHeartbeatSort.UNRECOGNIZED:
+    default:
+      return "UNRECOGNIZED";
+  }
+}
+
 export interface ListSessionsRequest {
   organizationId: string;
   projectId: string;
@@ -2336,6 +2372,86 @@ export interface EntitlementWindow {
   windowSeconds?: number | undefined;
 }
 
+export interface ListRelayHeartbeatsRequest {
+  organizationId: string;
+  projectId: string;
+  /** organization_ids / project_ids AND with organization_id / project_id, so they can only narrow the team. */
+  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 ListRelayHeartbeatsResponse {
+  status: ResponseStatus | undefined;
+  relayHeartbeats: RelayHeartbeat[];
+  /** Empty once the last page has been returned. */
+  nextPageToken: string;
+}
+
+/**
+ * RelayHeartbeat mirrors telemetry.api.v1.RelayHeartbeat. One relay machine for its team: who, where, which
+ * version and how fresh. The gateway stamps the organization, project, first and last seen and key id; the user id,
+ * host name and version are what the relay reported, for display only. Staff read the latest heartbeat in full as
+ * AdminRelayHeartbeat.
+ */
+export interface RelayHeartbeat {
+  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;
+  /** the key that signed the latest heartbeat */
+  miradorApiKeyId: string;
+}
+
+/**
+ * RelayHeartbeatFilter mirrors telemetry.api.v1.RelayHeartbeatFilter. Fields AND; a repeated field matches any of
+ * its values; an unset or empty field does not filter.
+ */
+export interface RelayHeartbeatFilter {
+  /** UUIDs; a malformed one is a validation error. */
+  organizationIds: string[];
+  /** UUIDs; a malformed one is a validation error. */
+  projectIds: string[];
+  /** UUIDs; a malformed one is a validation error, so a signed-out relay ("") cannot be selected by user. */
+  accountUserIds: string[];
+  /** Exact host names. */
+  hostNames: string[];
+  /** Exact versions of the latest heartbeat, not any version the relay ever reported. */
+  termaVersions: string[];
+  /**
+   * A set bound applies whatever its value and must lie within 1900-01-01 to 2262-04-11; last_seen_after must be
+   * before last_seen_before when both are set.
+   */
+  lastSeenAfter:
+    | Date
+    | undefined;
+  /** exclusive */
+  lastSeenBefore: Date | undefined;
+}
+
 function createBaseListSessionsRequest(): ListSessionsRequest {
   return { organizationId: "", projectId: "", filter: undefined, sort: 0, page: 0, perPage: 0 };
 }
@@ -21676,194 +21792,902 @@ export const EntitlementWindow: MessageFns<EntitlementWindow> = {
   },
 };
 
-/**
- * AIGatewayService is the frontend-facing proxy over telemetry.api.v1.AIService.
- * It stamps the authorized organization/project and forwards telemetry-api-shaped messages.
- */
-export interface AIGatewayService {
-  /**
-   * One numbered page of the conversation catalog (sessions folded to
-   * one rollup by source_system + session_id), ranked by sort. Weakly consistent
-   * (latest-state, no frozen snapshot).
-   */
-  ListSessions(request: ListSessionsRequest, metadata?: Metadata): Promise<ListSessionsResponse>;
-  /**
-   * Keeps the first conversation page live: the whole top-N page re-derived each tick
-   * as one SessionsSnapshot, replacing client state wholesale (not a delta feed).
-   */
-  StreamSessions(request: StreamSessionsRequest, metadata?: Metadata): Observable<SessionsSnapshot>;
-  /** Live sidebar rollup (session_id + source_system): re-derived and re-emitted whole each tick. */
-  StreamSessionSummary(request: GetSessionSummaryRequest, metadata?: Metadata): Observable<AISessionSummary>;
-  ListSessionEvents(request: ListSessionEventsRequest, metadata?: Metadata): Promise<ListSessionEventsResponse>;
-  StreamSessionEvents(request: StreamSessionEventsRequest, metadata?: Metadata): Observable<AISessionEventEnvelope>;
-  /**
-   * Live, backend-computed, per-event token series for one session (replacement snapshots):
-   * one content-free point per logical event + whole-session totals; point count is capped.
-   */
-  StreamSessionTokenTimeline(
-    request: SessionTokenTimelineRequest,
-    metadata?: Metadata,
-  ): Observable<SessionTokenTimeline>;
-  /** Live "Files changed" card: per file the latest-observed git change-type + exact --numstat churn. */
-  StreamSessionFileChanges(request: SessionFileChangesRequest, metadata?: Metadata): Observable<SessionFileChanges>;
-  /** Filtered, keyset-paginated drill-down feed of git/GitHub actions (newest first). */
-  ListGitActivities(request: ListGitActivitiesRequest, metadata?: Metadata): Promise<ListGitActivitiesResponse>;
-  /**
-   * Live stream of the filtered git/GitHub feed (UPSERT per activity keyed by
-   * activity_id, a nonterminal GitActivitiesSnapshotCompleted, then open until cancel).
-   */
-  StreamGitActivities(request: StreamGitActivitiesRequest, metadata?: Metadata): Observable<GitActivityFrame>;
-  /**
-   * Live stream of the git dashboard's overview: a full windowed, dimension-sliced rollup of the filtered
-   * git activities (whole-window totals ride each frame), re-derived each tick.
-   */
-  StreamGitActivitySummary(request: GitActivitySummaryRequest, metadata?: Metadata): Observable<GitActivitySummary>;
-  /**
-   * Live token burn calendar: a windowed, dimension-sliced token/cost trend series
-   * plus whole-window totals.
-   */
-  StreamTokenActivitySummary(
-    request: TokenActivitySummaryRequest,
-    metadata?: Metadata,
-  ): Observable<TokenActivitySummary>;
-  /**
-   * Live "burn rate now" gauge: the trailing-60s cost/hr + tokens/min (total plus a per-dimension
-   * breakdown) and a fixed 60-minute one-minute rolling sparkline of that rate. Fixed horizon, fast
-   * refresh; first frame is a full snapshot.
-   */
-  StreamBurnRate(request: BurnRateRequest, metadata?: Metadata): Observable<BurnRate>;
-  /**
-   * Live token-burn calendar over an inclusive UTC [start_date, end_date] range: one complete row per
-   * covered day off the precomputed daily rollup. Covered empty days are zero; uncomputed history is
-   * omitted; today is provisional.
-   */
-  StreamDailyActivity(request: DailyActivityRequest, metadata?: Metadata): Observable<DailyActivity>;
-  /**
-   * Live current-UTC-month spend forecast: month-to-date cost and the projected month-end total (a band from
-   * replaying recent weeks), for the project and per model, provider, source system, user and api key, off the
-   * same daily rollup as StreamDailyActivity; filter.funding_modes forecasts the cost on the listed funding modes. Mirrors
-   * telemetry.api.v1.
-   */
-  StreamSpendForecast(request: SpendForecastRequest, metadata?: Metadata): Observable<SpendForecast>;
-  /**
-   * Live weekly activity rhythm: a sparse (weekday, hour) heatmap over a bounded sliding window in an
-   * explicit IANA time zone. Every latest logical event counts; settled model calls add token/cost.
-   */
-  StreamActivityRhythm(request: ActivityRhythmRequest, metadata?: Metadata): Observable<ActivityRhythm>;
-  /**
-   * Live stream of one project's dashboard bundle: headline totals, model/provider/source mix,
-   * and top sessions by cost.
-   */
-  StreamProjectOverview(request: ProjectOverviewRequest, metadata?: Metadata): Observable<ProjectOverview>;
-  /**
-   * Live organization home cards: one summary per requested project (zeros when it has no AI activity) —
-   * conversations last active in the window, their principals and git counts, and the window's burn by model.
-   */
-  StreamProjectSummaries(request: ProjectSummariesRequest, metadata?: Metadata): Observable<ProjectSummaries>;
-  /**
-   * Per-file working-state feed (keyset-paginated) behind the unlanded-work funnel: one row per
-   * (repository_key, ref, path) the AI edited (with filter.sessions or filter.paths, one they name), its
-   * most-edited checkout copy among those the filter keeps. Mirrors telemetry.api.v1.
-   */
-  ListFiles(request: ListFilesRequest, metadata?: Metadata): Promise<ListFilesResponse>;
-  /**
-   * ListFiles' files rolled up by directory, one row per (repository_key, directory), every matching directory in
-   * one response (unpaged). Mirrors telemetry.api.v1.
-   */
-  ListFileDirectories(request: ListFileDirectoriesRequest, metadata?: Metadata): Promise<ListFileDirectoriesResponse>;
-  /**
-   * Live stream of the unlanded-work funnel: aging tiers + discarded (git-invisible churn), a complete
-   * snapshot re-derived each tick. Counts every checkout copy, edited or not.
-   */
-  StreamFilesSummary(request: FilesSummaryRequest, metadata?: Metadata): Observable<FilesSummary>;
-  /** Latest observed list price per catalog listing from the global catalog, under stored names. */
-  ListModelPrices(request: ListModelPricesRequest, metadata?: Metadata): Promise<ListModelPricesResponse>;
-  /**
-   * Every stored observation for the filtered models over a time range, oldest first —
-   * the rows ListModelPrices collapses. filter.model_raws is required.
-   */
-  ListModelPriceHistory(
-    request: ListModelPriceHistoryRequest,
-    metadata?: Metadata,
-  ): Promise<ListModelPriceHistoryResponse>;
-  /**
-   * Top-N most-used resources of one kind (skills / tools / files / URLs / bash commands) over a
-   * sliding window, each with the prior equal-length window's count for a trend delta and distinct
-   * sessions. Mirrors telemetry.api.v1.
-   */
-  ListResourceRankings(request: ResourceRankingsRequest, metadata?: Metadata): Promise<ResourceRankingsResponse>;
-  /**
-   * Every model of a project over a time range: usage, the tool calls, compactions and subagent runs
-   * attributed to each, and who called it. Groups fold stored spellings; an ungrouped name is its own row,
-   * costliest first. Mirrors telemetry.api.v1.
-   */
-  ListModelActivity(request: ModelActivityRequest, metadata?: Metadata): Promise<ModelActivityResponse>;
-  /**
-   * One session's model calls and git activity on one epoch-aligned time grid: per bucket, each model's
-   * calls, tokens and cost, and each git action's count. Mirrors telemetry.api.v1.
-   */
-  GetSessionUsageTrend(request: SessionUsageTrendRequest, metadata?: Metadata): Promise<SessionUsageTrendResponse>;
-  /**
-   * Per-seat entitlement usage board: every entitlement owner's latest observed funding facility and
-   * per-harness usage % windows. Stream-first (first frame = full snapshot), seat-scoped. Mirrors
-   * telemetry.api.v1.
-   */
-  StreamEntitlements(request: StreamEntitlementsRequest, metadata?: Metadata): Observable<EntitlementsSnapshot>;
+function createBaseListRelayHeartbeatsRequest(): ListRelayHeartbeatsRequest {
+  return { organizationId: "", projectId: "", filter: undefined, sort: 0, pageSize: 0, pageToken: "" };
 }
 
-export const AIGatewayServiceServiceName = "gateway.web.v1.AIGatewayService";
-export class AIGatewayServiceClientImpl implements AIGatewayService {
-  private readonly rpc: Rpc;
-  private readonly service: string;
-  constructor(rpc: Rpc, opts?: { service?: string }) {
-    this.service = opts?.service || AIGatewayServiceServiceName;
-    this.rpc = rpc;
-    this.ListSessions = this.ListSessions.bind(this);
-    this.StreamSessions = this.StreamSessions.bind(this);
-    this.StreamSessionSummary = this.StreamSessionSummary.bind(this);
-    this.ListSessionEvents = this.ListSessionEvents.bind(this);
-    this.StreamSessionEvents = this.StreamSessionEvents.bind(this);
-    this.StreamSessionTokenTimeline = this.StreamSessionTokenTimeline.bind(this);
-    this.StreamSessionFileChanges = this.StreamSessionFileChanges.bind(this);
-    this.ListGitActivities = this.ListGitActivities.bind(this);
-    this.StreamGitActivities = this.StreamGitActivities.bind(this);
-    this.StreamGitActivitySummary = this.StreamGitActivitySummary.bind(this);
-    this.StreamTokenActivitySummary = this.StreamTokenActivitySummary.bind(this);
-    this.StreamBurnRate = this.StreamBurnRate.bind(this);
-    this.StreamDailyActivity = this.StreamDailyActivity.bind(this);
-    this.StreamSpendForecast = this.StreamSpendForecast.bind(this);
-    this.StreamActivityRhythm = this.StreamActivityRhythm.bind(this);
-    this.StreamProjectOverview = this.StreamProjectOverview.bind(this);
-    this.StreamProjectSummaries = this.StreamProjectSummaries.bind(this);
-    this.ListFiles = this.ListFiles.bind(this);
-    this.ListFileDirectories = this.ListFileDirectories.bind(this);
-    this.StreamFilesSummary = this.StreamFilesSummary.bind(this);
-    this.ListModelPrices = this.ListModelPrices.bind(this);
-    this.ListModelPriceHistory = this.ListModelPriceHistory.bind(this);
-    this.ListResourceRankings = this.ListResourceRankings.bind(this);
-    this.ListModelActivity = this.ListModelActivity.bind(this);
-    this.GetSessionUsageTrend = this.GetSessionUsageTrend.bind(this);
-    this.StreamEntitlements = this.StreamEntitlements.bind(this);
-  }
-  ListSessions(request: ListSessionsRequest, metadata?: Metadata): Promise<ListSessionsResponse> {
-    const data = ListSessionsRequest.encode(request).finish();
-    const promise = this.rpc.request(this.service, "ListSessions", data, metadata);
-    return promise.then((data) => ListSessionsResponse.decode(new BinaryReader(data)));
-  }
-
-  StreamSessions(request: StreamSessionsRequest, metadata?: Metadata): Observable<SessionsSnapshot> {
-    const data = StreamSessionsRequest.encode(request).finish();
-    const result = this.rpc.serverStreamingRequest(this.service, "StreamSessions", data, metadata);
-    return result.pipe(map((data) => SessionsSnapshot.decode(new BinaryReader(data))));
-  }
-
-  StreamSessionSummary(request: GetSessionSummaryRequest, metadata?: Metadata): Observable<AISessionSummary> {
-    const data = GetSessionSummaryRequest.encode(request).finish();
-    const result = this.rpc.serverStreamingRequest(this.service, "StreamSessionSummary", data, metadata);
-    return result.pipe(map((data) => AISessionSummary.decode(new BinaryReader(data))));
-  }
+export const ListRelayHeartbeatsRequest: MessageFns<ListRelayHeartbeatsRequest> = {
+  encode(message: ListRelayHeartbeatsRequest, 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.filter !== undefined) {
+      RelayHeartbeatFilter.encode(message.filter, writer.uint32(26).fork()).join();
+    }
+    if (message.sort !== 0) {
+      writer.uint32(32).int32(message.sort);
+    }
+    if (message.pageSize !== 0) {
+      writer.uint32(40).int32(message.pageSize);
+    }
+    if (message.pageToken !== "") {
+      writer.uint32(50).string(message.pageToken);
+    }
+    return writer;
+  },
 
-  ListSessionEvents(request: ListSessionEventsRequest, metadata?: Metadata): Promise<ListSessionEventsResponse> {
+  decode(input: BinaryReader | Uint8Array, length?: number): ListRelayHeartbeatsRequest {
+    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 = createBaseListRelayHeartbeatsRequest();
+      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.filter = RelayHeartbeatFilter.decode(reader, reader.uint32());
+            continue;
+          }
+          case 4: {
+            if (tag !== 32) {
+              break;
+            }
+
+            message.sort = reader.int32() as any;
+            continue;
+          }
+          case 5: {
+            if (tag !== 40) {
+              break;
+            }
+
+            message.pageSize = reader.int32();
+            continue;
+          }
+          case 6: {
+            if (tag !== 50) {
+              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): ListRelayHeartbeatsRequest {
+    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)
+        : "",
+      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: ListRelayHeartbeatsRequest): unknown {
+    const obj: any = {};
+    if (message.organizationId !== "") {
+      obj.organizationId = message.organizationId;
+    }
+    if (message.projectId !== "") {
+      obj.projectId = message.projectId;
+    }
+    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<ListRelayHeartbeatsRequest>, I>>(base?: I): ListRelayHeartbeatsRequest {
+    return ListRelayHeartbeatsRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ListRelayHeartbeatsRequest>, I>>(object: I): ListRelayHeartbeatsRequest {
+    const message = createBaseListRelayHeartbeatsRequest();
+    message.organizationId = object.organizationId ?? "";
+    message.projectId = object.projectId ?? "";
+    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 createBaseListRelayHeartbeatsResponse(): ListRelayHeartbeatsResponse {
+  return { status: undefined, relayHeartbeats: [], nextPageToken: "" };
+}
+
+export const ListRelayHeartbeatsResponse: MessageFns<ListRelayHeartbeatsResponse> = {
+  encode(message: ListRelayHeartbeatsResponse, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.status !== undefined) {
+      ResponseStatus.encode(message.status, writer.uint32(10).fork()).join();
+    }
+    for (const v of message.relayHeartbeats) {
+      RelayHeartbeat.encode(v!, writer.uint32(18).fork()).join();
+    }
+    if (message.nextPageToken !== "") {
+      writer.uint32(26).string(message.nextPageToken);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ListRelayHeartbeatsResponse {
+    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 = createBaseListRelayHeartbeatsResponse();
+      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(RelayHeartbeat.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): ListRelayHeartbeatsResponse {
+    return {
+      status: isSet(object.status) ? ResponseStatus.fromJSON(object.status) : undefined,
+      relayHeartbeats: globalThis.Array.isArray(object?.relayHeartbeats)
+        ? object.relayHeartbeats.map((e: any) => RelayHeartbeat.fromJSON(e))
+        : globalThis.Array.isArray(object?.relay_heartbeats)
+        ? object.relay_heartbeats.map((e: any) => RelayHeartbeat.fromJSON(e))
+        : [],
+      nextPageToken: isSet(object.nextPageToken)
+        ? globalThis.String(object.nextPageToken)
+        : isSet(object.next_page_token)
+        ? globalThis.String(object.next_page_token)
+        : "",
+    };
+  },
+
+  toJSON(message: ListRelayHeartbeatsResponse): unknown {
+    const obj: any = {};
+    if (message.status !== undefined) {
+      obj.status = ResponseStatus.toJSON(message.status);
+    }
+    if (message.relayHeartbeats?.length) {
+      obj.relayHeartbeats = message.relayHeartbeats.map((e) => RelayHeartbeat.toJSON(e));
+    }
+    if (message.nextPageToken !== "") {
+      obj.nextPageToken = message.nextPageToken;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<ListRelayHeartbeatsResponse>, I>>(base?: I): ListRelayHeartbeatsResponse {
+    return ListRelayHeartbeatsResponse.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ListRelayHeartbeatsResponse>, I>>(object: I): ListRelayHeartbeatsResponse {
+    const message = createBaseListRelayHeartbeatsResponse();
+    message.status = (object.status !== undefined && object.status !== null)
+      ? ResponseStatus.fromPartial(object.status)
+      : undefined;
+    message.relayHeartbeats = object.relayHeartbeats?.map((e) => RelayHeartbeat.fromPartial(e)) || [];
+    message.nextPageToken = object.nextPageToken ?? "";
+    return message;
+  },
+};
+
+function createBaseRelayHeartbeat(): RelayHeartbeat {
+  return {
+    organizationId: "",
+    projectId: "",
+    accountUserId: "",
+    hostName: "",
+    firstSeen: undefined,
+    lastSeen: undefined,
+    termaVersion: "",
+    miradorApiKeyId: "",
+  };
+}
+
+export const RelayHeartbeat: MessageFns<RelayHeartbeat> = {
+  encode(message: RelayHeartbeat, 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.miradorApiKeyId !== "") {
+      writer.uint32(66).string(message.miradorApiKeyId);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): RelayHeartbeat {
+    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 = createBaseRelayHeartbeat();
+      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.miradorApiKeyId = 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): RelayHeartbeat {
+    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)
+        : "",
+      miradorApiKeyId: isSet(object.miradorApiKeyId)
+        ? globalThis.String(object.miradorApiKeyId)
+        : isSet(object.mirador_api_key_id)
+        ? globalThis.String(object.mirador_api_key_id)
+        : "",
+    };
+  },
+
+  toJSON(message: RelayHeartbeat): 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.miradorApiKeyId !== "") {
+      obj.miradorApiKeyId = message.miradorApiKeyId;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<RelayHeartbeat>, I>>(base?: I): RelayHeartbeat {
+    return RelayHeartbeat.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<RelayHeartbeat>, I>>(object: I): RelayHeartbeat {
+    const message = createBaseRelayHeartbeat();
+    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.miradorApiKeyId = object.miradorApiKeyId ?? "";
+    return message;
+  },
+};
+
+function createBaseRelayHeartbeatFilter(): RelayHeartbeatFilter {
+  return {
+    organizationIds: [],
+    projectIds: [],
+    accountUserIds: [],
+    hostNames: [],
+    termaVersions: [],
+    lastSeenAfter: undefined,
+    lastSeenBefore: undefined,
+  };
+}
+
+export const RelayHeartbeatFilter: MessageFns<RelayHeartbeatFilter> = {
+  encode(message: RelayHeartbeatFilter, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    for (const v of message.organizationIds) {
+      writer.uint32(10).string(v!);
+    }
+    for (const v of message.projectIds) {
+      writer.uint32(18).string(v!);
+    }
+    for (const v of message.accountUserIds) {
+      writer.uint32(26).string(v!);
+    }
+    for (const v of message.hostNames) {
+      writer.uint32(34).string(v!);
+    }
+    for (const v of message.termaVersions) {
+      writer.uint32(42).string(v!);
+    }
+    if (message.lastSeenAfter !== undefined) {
+      Timestamp.encode(toTimestamp(message.lastSeenAfter), writer.uint32(50).fork()).join();
+    }
+    if (message.lastSeenBefore !== undefined) {
+      Timestamp.encode(toTimestamp(message.lastSeenBefore), writer.uint32(58).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): RelayHeartbeatFilter {
+    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 = createBaseRelayHeartbeatFilter();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.organizationIds.push(reader.string());
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.projectIds.push(reader.string());
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.accountUserIds.push(reader.string());
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.hostNames.push(reader.string());
+            continue;
+          }
+          case 5: {
+            if (tag !== 42) {
+              break;
+            }
+
+            message.termaVersions.push(reader.string());
+            continue;
+          }
+          case 6: {
+            if (tag !== 50) {
+              break;
+            }
+
+            message.lastSeenAfter = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 7: {
+            if (tag !== 58) {
+              break;
+            }
+
+            message.lastSeenBefore = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): RelayHeartbeatFilter {
+    return {
+      organizationIds: globalThis.Array.isArray(object?.organizationIds)
+        ? object.organizationIds.map((e: any) => globalThis.String(e))
+        : globalThis.Array.isArray(object?.organization_ids)
+        ? object.organization_ids.map((e: any) => globalThis.String(e))
+        : [],
+      projectIds: globalThis.Array.isArray(object?.projectIds)
+        ? object.projectIds.map((e: any) => globalThis.String(e))
+        : globalThis.Array.isArray(object?.project_ids)
+        ? object.project_ids.map((e: any) => globalThis.String(e))
+        : [],
+      accountUserIds: globalThis.Array.isArray(object?.accountUserIds)
+        ? object.accountUserIds.map((e: any) => globalThis.String(e))
+        : globalThis.Array.isArray(object?.account_user_ids)
+        ? object.account_user_ids.map((e: any) => globalThis.String(e))
+        : [],
+      hostNames: globalThis.Array.isArray(object?.hostNames)
+        ? object.hostNames.map((e: any) => globalThis.String(e))
+        : globalThis.Array.isArray(object?.host_names)
+        ? object.host_names.map((e: any) => globalThis.String(e))
+        : [],
+      termaVersions: globalThis.Array.isArray(object?.termaVersions)
+        ? object.termaVersions.map((e: any) => globalThis.String(e))
+        : globalThis.Array.isArray(object?.terma_versions)
+        ? object.terma_versions.map((e: any) => globalThis.String(e))
+        : [],
+      lastSeenAfter: isSet(object.lastSeenAfter)
+        ? fromJsonTimestamp(object.lastSeenAfter)
+        : isSet(object.last_seen_after)
+        ? fromJsonTimestamp(object.last_seen_after)
+        : undefined,
+      lastSeenBefore: isSet(object.lastSeenBefore)
+        ? fromJsonTimestamp(object.lastSeenBefore)
+        : isSet(object.last_seen_before)
+        ? fromJsonTimestamp(object.last_seen_before)
+        : undefined,
+    };
+  },
+
+  toJSON(message: RelayHeartbeatFilter): unknown {
+    const obj: any = {};
+    if (message.organizationIds?.length) {
+      obj.organizationIds = message.organizationIds;
+    }
+    if (message.projectIds?.length) {
+      obj.projectIds = message.projectIds;
+    }
+    if (message.accountUserIds?.length) {
+      obj.accountUserIds = message.accountUserIds;
+    }
+    if (message.hostNames?.length) {
+      obj.hostNames = message.hostNames;
+    }
+    if (message.termaVersions?.length) {
+      obj.termaVersions = message.termaVersions;
+    }
+    if (message.lastSeenAfter !== undefined) {
+      obj.lastSeenAfter = message.lastSeenAfter.toISOString();
+    }
+    if (message.lastSeenBefore !== undefined) {
+      obj.lastSeenBefore = message.lastSeenBefore.toISOString();
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<RelayHeartbeatFilter>, I>>(base?: I): RelayHeartbeatFilter {
+    return RelayHeartbeatFilter.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<RelayHeartbeatFilter>, I>>(object: I): RelayHeartbeatFilter {
+    const message = createBaseRelayHeartbeatFilter();
+    message.organizationIds = object.organizationIds?.map((e) => e) || [];
+    message.projectIds = object.projectIds?.map((e) => e) || [];
+    message.accountUserIds = object.accountUserIds?.map((e) => e) || [];
+    message.hostNames = object.hostNames?.map((e) => e) || [];
+    message.termaVersions = object.termaVersions?.map((e) => e) || [];
+    message.lastSeenAfter = object.lastSeenAfter ?? undefined;
+    message.lastSeenBefore = object.lastSeenBefore ?? undefined;
+    return message;
+  },
+};
+
+/**
+ * AIGatewayService is the frontend-facing proxy over telemetry.api.v1.AIService.
+ * It stamps the authorized organization/project and forwards telemetry-api-shaped messages.
+ */
+export interface AIGatewayService {
+  /**
+   * One numbered page of the conversation catalog (sessions folded to
+   * one rollup by source_system + session_id), ranked by sort. Weakly consistent
+   * (latest-state, no frozen snapshot).
+   */
+  ListSessions(request: ListSessionsRequest, metadata?: Metadata): Promise<ListSessionsResponse>;
+  /**
+   * Keeps the first conversation page live: the whole top-N page re-derived each tick
+   * as one SessionsSnapshot, replacing client state wholesale (not a delta feed).
+   */
+  StreamSessions(request: StreamSessionsRequest, metadata?: Metadata): Observable<SessionsSnapshot>;
+  /** Live sidebar rollup (session_id + source_system): re-derived and re-emitted whole each tick. */
+  StreamSessionSummary(request: GetSessionSummaryRequest, metadata?: Metadata): Observable<AISessionSummary>;
+  ListSessionEvents(request: ListSessionEventsRequest, metadata?: Metadata): Promise<ListSessionEventsResponse>;
+  StreamSessionEvents(request: StreamSessionEventsRequest, metadata?: Metadata): Observable<AISessionEventEnvelope>;
+  /**
+   * Live, backend-computed, per-event token series for one session (replacement snapshots):
+   * one content-free point per logical event + whole-session totals; point count is capped.
+   */
+  StreamSessionTokenTimeline(
+    request: SessionTokenTimelineRequest,
+    metadata?: Metadata,
+  ): Observable<SessionTokenTimeline>;
+  /** Live "Files changed" card: per file the latest-observed git change-type + exact --numstat churn. */
+  StreamSessionFileChanges(request: SessionFileChangesRequest, metadata?: Metadata): Observable<SessionFileChanges>;
+  /** Filtered, keyset-paginated drill-down feed of git/GitHub actions (newest first). */
+  ListGitActivities(request: ListGitActivitiesRequest, metadata?: Metadata): Promise<ListGitActivitiesResponse>;
+  /**
+   * Live stream of the filtered git/GitHub feed (UPSERT per activity keyed by
+   * activity_id, a nonterminal GitActivitiesSnapshotCompleted, then open until cancel).
+   */
+  StreamGitActivities(request: StreamGitActivitiesRequest, metadata?: Metadata): Observable<GitActivityFrame>;
+  /**
+   * Live stream of the git dashboard's overview: a full windowed, dimension-sliced rollup of the filtered
+   * git activities (whole-window totals ride each frame), re-derived each tick.
+   */
+  StreamGitActivitySummary(request: GitActivitySummaryRequest, metadata?: Metadata): Observable<GitActivitySummary>;
+  /**
+   * Live token burn calendar: a windowed, dimension-sliced token/cost trend series
+   * plus whole-window totals.
+   */
+  StreamTokenActivitySummary(
+    request: TokenActivitySummaryRequest,
+    metadata?: Metadata,
+  ): Observable<TokenActivitySummary>;
+  /**
+   * Live "burn rate now" gauge: the trailing-60s cost/hr + tokens/min (total plus a per-dimension
+   * breakdown) and a fixed 60-minute one-minute rolling sparkline of that rate. Fixed horizon, fast
+   * refresh; first frame is a full snapshot.
+   */
+  StreamBurnRate(request: BurnRateRequest, metadata?: Metadata): Observable<BurnRate>;
+  /**
+   * Live token-burn calendar over an inclusive UTC [start_date, end_date] range: one complete row per
+   * covered day off the precomputed daily rollup. Covered empty days are zero; uncomputed history is
+   * omitted; today is provisional.
+   */
+  StreamDailyActivity(request: DailyActivityRequest, metadata?: Metadata): Observable<DailyActivity>;
+  /**
+   * Live current-UTC-month spend forecast: month-to-date cost and the projected month-end total (a band from
+   * replaying recent weeks), for the project and per model, provider, source system, user and api key, off the
+   * same daily rollup as StreamDailyActivity; filter.funding_modes forecasts the cost on the listed funding modes. Mirrors
+   * telemetry.api.v1.
+   */
+  StreamSpendForecast(request: SpendForecastRequest, metadata?: Metadata): Observable<SpendForecast>;
+  /**
+   * Live weekly activity rhythm: a sparse (weekday, hour) heatmap over a bounded sliding window in an
+   * explicit IANA time zone. Every latest logical event counts; settled model calls add token/cost.
+   */
+  StreamActivityRhythm(request: ActivityRhythmRequest, metadata?: Metadata): Observable<ActivityRhythm>;
+  /**
+   * Live stream of one project's dashboard bundle: headline totals, model/provider/source mix,
+   * and top sessions by cost.
+   */
+  StreamProjectOverview(request: ProjectOverviewRequest, metadata?: Metadata): Observable<ProjectOverview>;
+  /**
+   * Live organization home cards: one summary per requested project (zeros when it has no AI activity) —
+   * conversations last active in the window, their principals and git counts, and the window's burn by model.
+   */
+  StreamProjectSummaries(request: ProjectSummariesRequest, metadata?: Metadata): Observable<ProjectSummaries>;
+  /**
+   * Per-file working-state feed (keyset-paginated) behind the unlanded-work funnel: one row per
+   * (repository_key, ref, path) the AI edited (with filter.sessions or filter.paths, one they name), its
+   * most-edited checkout copy among those the filter keeps. Mirrors telemetry.api.v1.
+   */
+  ListFiles(request: ListFilesRequest, metadata?: Metadata): Promise<ListFilesResponse>;
+  /**
+   * ListFiles' files rolled up by directory, one row per (repository_key, directory), every matching directory in
+   * one response (unpaged). Mirrors telemetry.api.v1.
+   */
+  ListFileDirectories(request: ListFileDirectoriesRequest, metadata?: Metadata): Promise<ListFileDirectoriesResponse>;
+  /**
+   * Live stream of the unlanded-work funnel: aging tiers + discarded (git-invisible churn), a complete
+   * snapshot re-derived each tick. Counts every checkout copy, edited or not.
+   */
+  StreamFilesSummary(request: FilesSummaryRequest, metadata?: Metadata): Observable<FilesSummary>;
+  /** Latest observed list price per catalog listing from the global catalog, under stored names. */
+  ListModelPrices(request: ListModelPricesRequest, metadata?: Metadata): Promise<ListModelPricesResponse>;
+  /**
+   * Every stored observation for the filtered models over a time range, oldest first —
+   * the rows ListModelPrices collapses. filter.model_raws is required.
+   */
+  ListModelPriceHistory(
+    request: ListModelPriceHistoryRequest,
+    metadata?: Metadata,
+  ): Promise<ListModelPriceHistoryResponse>;
+  /**
+   * Top-N most-used resources of one kind (skills / tools / files / URLs / bash commands) over a
+   * sliding window, each with the prior equal-length window's count for a trend delta and distinct
+   * sessions. Mirrors telemetry.api.v1.
+   */
+  ListResourceRankings(request: ResourceRankingsRequest, metadata?: Metadata): Promise<ResourceRankingsResponse>;
+  /**
+   * Every model of a project over a time range: usage, the tool calls, compactions and subagent runs
+   * attributed to each, and who called it. Groups fold stored spellings; an ungrouped name is its own row,
+   * costliest first. Mirrors telemetry.api.v1.
+   */
+  ListModelActivity(request: ModelActivityRequest, metadata?: Metadata): Promise<ModelActivityResponse>;
+  /**
+   * One session's model calls and git activity on one epoch-aligned time grid: per bucket, each model's
+   * calls, tokens and cost, and each git action's count. Mirrors telemetry.api.v1.
+   */
+  GetSessionUsageTrend(request: SessionUsageTrendRequest, metadata?: Metadata): Promise<SessionUsageTrendResponse>;
+  /**
+   * Per-seat entitlement usage board: every entitlement owner's latest observed funding facility and
+   * per-harness usage % windows. Stream-first (first frame = full snapshot), seat-scoped. Mirrors
+   * telemetry.api.v1.
+   */
+  StreamEntitlements(request: StreamEntitlementsRequest, metadata?: Metadata): Observable<EntitlementsSnapshot>;
+  /**
+   * The team's Terma relays: one row per (organization, project, user, host) with the first and last heartbeat
+   * received and the latest heartbeat's version, most recently seen first (keyset-paginated).
+   * Mirrors telemetry.api.v1.
+   */
+  ListRelayHeartbeats(request: ListRelayHeartbeatsRequest, metadata?: Metadata): Promise<ListRelayHeartbeatsResponse>;
+}
+
+export const AIGatewayServiceServiceName = "gateway.web.v1.AIGatewayService";
+export class AIGatewayServiceClientImpl implements AIGatewayService {
+  private readonly rpc: Rpc;
+  private readonly service: string;
+  constructor(rpc: Rpc, opts?: { service?: string }) {
+    this.service = opts?.service || AIGatewayServiceServiceName;
+    this.rpc = rpc;
+    this.ListSessions = this.ListSessions.bind(this);
+    this.StreamSessions = this.StreamSessions.bind(this);
+    this.StreamSessionSummary = this.StreamSessionSummary.bind(this);
+    this.ListSessionEvents = this.ListSessionEvents.bind(this);
+    this.StreamSessionEvents = this.StreamSessionEvents.bind(this);
+    this.StreamSessionTokenTimeline = this.StreamSessionTokenTimeline.bind(this);
+    this.StreamSessionFileChanges = this.StreamSessionFileChanges.bind(this);
+    this.ListGitActivities = this.ListGitActivities.bind(this);
+    this.StreamGitActivities = this.StreamGitActivities.bind(this);
+    this.StreamGitActivitySummary = this.StreamGitActivitySummary.bind(this);
+    this.StreamTokenActivitySummary = this.StreamTokenActivitySummary.bind(this);
+    this.StreamBurnRate = this.StreamBurnRate.bind(this);
+    this.StreamDailyActivity = this.StreamDailyActivity.bind(this);
+    this.StreamSpendForecast = this.StreamSpendForecast.bind(this);
+    this.StreamActivityRhythm = this.StreamActivityRhythm.bind(this);
+    this.StreamProjectOverview = this.StreamProjectOverview.bind(this);
+    this.StreamProjectSummaries = this.StreamProjectSummaries.bind(this);
+    this.ListFiles = this.ListFiles.bind(this);
+    this.ListFileDirectories = this.ListFileDirectories.bind(this);
+    this.StreamFilesSummary = this.StreamFilesSummary.bind(this);
+    this.ListModelPrices = this.ListModelPrices.bind(this);
+    this.ListModelPriceHistory = this.ListModelPriceHistory.bind(this);
+    this.ListResourceRankings = this.ListResourceRankings.bind(this);
+    this.ListModelActivity = this.ListModelActivity.bind(this);
+    this.GetSessionUsageTrend = this.GetSessionUsageTrend.bind(this);
+    this.StreamEntitlements = this.StreamEntitlements.bind(this);
+    this.ListRelayHeartbeats = this.ListRelayHeartbeats.bind(this);
+  }
+  ListSessions(request: ListSessionsRequest, metadata?: Metadata): Promise<ListSessionsResponse> {
+    const data = ListSessionsRequest.encode(request).finish();
+    const promise = this.rpc.request(this.service, "ListSessions", data, metadata);
+    return promise.then((data) => ListSessionsResponse.decode(new BinaryReader(data)));
+  }
+
+  StreamSessions(request: StreamSessionsRequest, metadata?: Metadata): Observable<SessionsSnapshot> {
+    const data = StreamSessionsRequest.encode(request).finish();
+    const result = this.rpc.serverStreamingRequest(this.service, "StreamSessions", data, metadata);
+    return result.pipe(map((data) => SessionsSnapshot.decode(new BinaryReader(data))));
+  }
+
+  StreamSessionSummary(request: GetSessionSummaryRequest, metadata?: Metadata): Observable<AISessionSummary> {
+    const data = GetSessionSummaryRequest.encode(request).finish();
+    const result = this.rpc.serverStreamingRequest(this.service, "StreamSessionSummary", data, metadata);
+    return result.pipe(map((data) => AISessionSummary.decode(new BinaryReader(data))));
+  }
+
+  ListSessionEvents(request: ListSessionEventsRequest, metadata?: Metadata): Promise<ListSessionEventsResponse> {
     const data = ListSessionEventsRequest.encode(request).finish();
     const promise = this.rpc.request(this.service, "ListSessionEvents", data, metadata);
     return promise.then((data) => ListSessionEventsResponse.decode(new BinaryReader(data)));
@@ -22009,6 +22833,12 @@ export class AIGatewayServiceClientImpl implements AIGatewayService {
     const result = this.rpc.serverStreamingRequest(this.service, "StreamEntitlements", data, metadata);
     return result.pipe(map((data) => EntitlementsSnapshot.decode(new BinaryReader(data))));
   }
+
+  ListRelayHeartbeats(request: ListRelayHeartbeatsRequest, metadata?: Metadata): Promise<ListRelayHeartbeatsResponse> {
+    const data = ListRelayHeartbeatsRequest.encode(request).finish();
+    const promise = this.rpc.request(this.service, "ListRelayHeartbeats", data, metadata);
+    return promise.then((data) => ListRelayHeartbeatsResponse.decode(new BinaryReader(data)));
+  }
 }
 
 interface Rpc {