@miradorlabs/web-grpc 2.62.0 → 2.64.0

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

@@ -681,6 +681,98 @@ export function aIFileGroupByToJSON(object: AIFileGroupBy): string {
   }
 }
 
+/** AIFundingMode mirrors telemetry.api.v1.AIFundingMode. */
+export enum AIFundingMode {
+  AI_FUNDING_MODE_UNSPECIFIED = 0,
+  AI_FUNDING_MODE_SUBSCRIPTION = 1,
+  AI_FUNDING_MODE_PREPAID_CREDITS = 2,
+  AI_FUNDING_MODE_API_METERED = 3,
+  AI_FUNDING_MODE_UNKNOWN = 4,
+  UNRECOGNIZED = -1,
+}
+
+export function aIFundingModeFromJSON(object: any): AIFundingMode {
+  switch (object) {
+    case 0:
+    case "AI_FUNDING_MODE_UNSPECIFIED":
+      return AIFundingMode.AI_FUNDING_MODE_UNSPECIFIED;
+    case 1:
+    case "AI_FUNDING_MODE_SUBSCRIPTION":
+      return AIFundingMode.AI_FUNDING_MODE_SUBSCRIPTION;
+    case 2:
+    case "AI_FUNDING_MODE_PREPAID_CREDITS":
+      return AIFundingMode.AI_FUNDING_MODE_PREPAID_CREDITS;
+    case 3:
+    case "AI_FUNDING_MODE_API_METERED":
+      return AIFundingMode.AI_FUNDING_MODE_API_METERED;
+    case 4:
+    case "AI_FUNDING_MODE_UNKNOWN":
+      return AIFundingMode.AI_FUNDING_MODE_UNKNOWN;
+    case -1:
+    case "UNRECOGNIZED":
+    default:
+      return AIFundingMode.UNRECOGNIZED;
+  }
+}
+
+export function aIFundingModeToJSON(object: AIFundingMode): string {
+  switch (object) {
+    case AIFundingMode.AI_FUNDING_MODE_UNSPECIFIED:
+      return "AI_FUNDING_MODE_UNSPECIFIED";
+    case AIFundingMode.AI_FUNDING_MODE_SUBSCRIPTION:
+      return "AI_FUNDING_MODE_SUBSCRIPTION";
+    case AIFundingMode.AI_FUNDING_MODE_PREPAID_CREDITS:
+      return "AI_FUNDING_MODE_PREPAID_CREDITS";
+    case AIFundingMode.AI_FUNDING_MODE_API_METERED:
+      return "AI_FUNDING_MODE_API_METERED";
+    case AIFundingMode.AI_FUNDING_MODE_UNKNOWN:
+      return "AI_FUNDING_MODE_UNKNOWN";
+    case AIFundingMode.UNRECOGNIZED:
+    default:
+      return "UNRECOGNIZED";
+  }
+}
+
+/** AIEntitlementRole mirrors telemetry.api.v1.AIEntitlementRole. */
+export enum AIEntitlementRole {
+  AI_ENTITLEMENT_ROLE_UNSPECIFIED = 0,
+  AI_ENTITLEMENT_ROLE_ALLOWANCE = 1,
+  AI_ENTITLEMENT_ROLE_SPEND_CAP = 2,
+  UNRECOGNIZED = -1,
+}
+
+export function aIEntitlementRoleFromJSON(object: any): AIEntitlementRole {
+  switch (object) {
+    case 0:
+    case "AI_ENTITLEMENT_ROLE_UNSPECIFIED":
+      return AIEntitlementRole.AI_ENTITLEMENT_ROLE_UNSPECIFIED;
+    case 1:
+    case "AI_ENTITLEMENT_ROLE_ALLOWANCE":
+      return AIEntitlementRole.AI_ENTITLEMENT_ROLE_ALLOWANCE;
+    case 2:
+    case "AI_ENTITLEMENT_ROLE_SPEND_CAP":
+      return AIEntitlementRole.AI_ENTITLEMENT_ROLE_SPEND_CAP;
+    case -1:
+    case "UNRECOGNIZED":
+    default:
+      return AIEntitlementRole.UNRECOGNIZED;
+  }
+}
+
+export function aIEntitlementRoleToJSON(object: AIEntitlementRole): string {
+  switch (object) {
+    case AIEntitlementRole.AI_ENTITLEMENT_ROLE_UNSPECIFIED:
+      return "AI_ENTITLEMENT_ROLE_UNSPECIFIED";
+    case AIEntitlementRole.AI_ENTITLEMENT_ROLE_ALLOWANCE:
+      return "AI_ENTITLEMENT_ROLE_ALLOWANCE";
+    case AIEntitlementRole.AI_ENTITLEMENT_ROLE_SPEND_CAP:
+      return "AI_ENTITLEMENT_ROLE_SPEND_CAP";
+    case AIEntitlementRole.UNRECOGNIZED:
+    default:
+      return "UNRECOGNIZED";
+  }
+}
+
 export interface ListSessionsRequest {
   organizationId: string;
   projectId: string;
@@ -866,6 +958,11 @@ export interface AISessionEvent {
   version: number;
   /** Opaque keyset cursor for this event's position. */
   cursor: string;
+  /**
+   * The funding facility observed for this event at ingest (a per-event facility lens, not a reconciled
+   * figure). '' / unrecognized map to UNSPECIFIED.
+   */
+  fundingMode: AIFundingMode;
 }
 
 export interface AIContentPart {
@@ -970,7 +1067,11 @@ export interface SessionTimelinePoint {
   provider: string;
   finishReason: string;
   durationMs?: number | undefined;
-  usage: AITokenUsage | undefined;
+  usage:
+    | AITokenUsage
+    | undefined;
+  /** Funding facility observed on this event (lens, not reconciled) so the timeline can tint by facility. */
+  fundingMode: AIFundingMode;
 }
 
 export interface ListPrincipalsRequest {
@@ -1241,13 +1342,28 @@ export interface BurnRateSparkPoint {
   rate: BurnRateMeasures | undefined;
 }
 
-/** BurnRateMeasures — usd_per_hour = bucket cost x 60; tokens_per_min = cache-inclusive input + output. */
+/**
+ * BurnRateMeasures — usd_per_hour = bucket cost x 60 (NOTIONAL, gross list price); tokens_per_min =
+ * cache-inclusive input + output. subscription_facility_usd_per_hour is the slice observed on the
+ * subscription funding facility at ingest (a LENS, like AIFacilityCostBreakdown.subscription_facility_usd —
+ * NOT reconciled subsidised dollars; the "_facility_" is load-bearing). The burn card may present
+ * usd_per_hour minus this as a metered-view rate, but that is a display lens, not settled billing.
+ */
 export interface BurnRateMeasures {
   usdPerHour: number;
   tokensPerMin: number;
   modelCalls: number;
   costUnavailableCount: number;
   usageUnavailableCount: number;
+  subscriptionFacilityUsdPerHour: number;
+  /**
+   * Per-minute token rate by kind, so the burn card watches each tick live. tokens_per_min stays the
+   * cache-inclusive input + output headline; input already includes cache_read (these are the raw columns).
+   */
+  inputTokensPerMin: number;
+  outputTokensPerMin: number;
+  cacheReadTokensPerMin: number;
+  cacheWriteTokensPerMin: number;
 }
 
 export interface DailyActivityRequest {
@@ -1560,6 +1676,83 @@ export interface AITokenUsage {
   cacheReadTokens: number;
   cacheWriteTokens: number;
   providerCostUsd: number;
+  /**
+   * Session cost sliced by the funding facility observed on each event at ingest (a LENS, not a
+   * reconciled billable figure). Populated only on a session summary's usage; nil elsewhere.
+   */
+  facilityCostBreakdown: AIFacilityCostBreakdown | undefined;
+}
+
+/**
+ * AIFacilityCostBreakdown mirrors telemetry.api.v1.AIFacilityCostBreakdown: a session's provider cost
+ * partitioned by the funding facility observed on each model_call at ingest. A LENS on where spend
+ * landed, NOT a reconciled billable/subsidised answer — a subscription facility can still incur
+ * metered overage, and the facility is the one observed at ingest. Over ai_events FINAL (deduplicated).
+ */
+export interface AIFacilityCostBreakdown {
+  /** sum of provider cost over priced model_calls — the gross */
+  notionalUsd: number;
+  /** _facility_usd = cost by OBSERVED facility, NOT reconciled billable dollars (name is load-bearing). */
+  subscriptionFacilityUsd: number;
+  prepaidCreditsFacilityUsd: number;
+  apiMeteredFacilityUsd: number;
+  /** unstamped or observed-unknown, one bucket */
+  unknownFacilityUsd: number;
+  pricedCalls: number;
+  /** an unpriced call is not free, just uncosted */
+  totalCalls: number;
+}
+
+export interface StreamEntitlementsRequest {
+  organizationId: string;
+  projectId: string;
+}
+
+/**
+ * EntitlementsSnapshot is one tick of the funding-usage board (first frame = full snapshot). Streams
+ * carry no ResponseStatus.
+ */
+export interface EntitlementsSnapshot {
+  seats: SeatEntitlement[];
+  asOf: Date | undefined;
+}
+
+/**
+ * SeatEntitlement mirrors telemetry.api.v1.SeatEntitlement: one entitlement owner's latest observed
+ * funding state. Seat-scoped ((source_system, account_id)); principal_id/name best-effort. Seat-scoped:
+ * windows are one seat's usage bars, never a team-pool sum. credits_balance_raw is verbatim, not USD.
+ */
+export interface SeatEntitlement {
+  sourceSystem: string;
+  accountId: string;
+  principalId: string;
+  principalName: string;
+  fundingMode: AIFundingMode;
+  windows: EntitlementWindow[];
+  /** As-of entitlement-state time (keyed on terma source_time), NOT ingest time. */
+  eventTime: Date | undefined;
+  creditsBalanceRaw?: string | undefined;
+  creditsUnlimited?:
+    | boolean
+    | undefined;
+  /** harness plan label verbatim ("Max 20x" / "Max 5x" / "Codex seat") */
+  planType: string;
+  seatTier: string;
+  /** raw provenance for the registered/observed/inferred toggle */
+  evidenceSource: string;
+}
+
+/**
+ * EntitlementWindow mirrors telemetry.api.v1.EntitlementWindow: one usage % bar. used_pct is nullable
+ * (unset = unobserved, never 0). kind is the harness window discriminator verbatim; window_seconds is
+ * the window's total span (unset = unobserved).
+ */
+export interface EntitlementWindow {
+  kind: string;
+  usedPct?: number | undefined;
+  resetsAt: Date | undefined;
+  role: AIEntitlementRole;
+  windowSeconds?: number | undefined;
 }
 
 function createBaseListSessionsRequest(): ListSessionsRequest {
@@ -3689,6 +3882,7 @@ function createBaseAISessionEvent(): AISessionEvent {
     logicalEventId: "",
     version: 0,
     cursor: "",
+    fundingMode: 0,
   };
 }
 
@@ -3748,6 +3942,9 @@ export const AISessionEvent: MessageFns<AISessionEvent> = {
     if (message.cursor !== "") {
       writer.uint32(146).string(message.cursor);
     }
+    if (message.fundingMode !== 0) {
+      writer.uint32(152).int32(message.fundingMode);
+    }
     return writer;
   },
 
@@ -3908,6 +4105,14 @@ export const AISessionEvent: MessageFns<AISessionEvent> = {
             message.cursor = reader.string();
             continue;
           }
+          case 19: {
+            if (tag !== 152) {
+              break;
+            }
+
+            message.fundingMode = reader.int32() as any;
+            continue;
+          }
         }
         if ((tag & 7) === 4 || tag === 0) {
           break;
@@ -3978,6 +4183,11 @@ export const AISessionEvent: MessageFns<AISessionEvent> = {
         : "",
       version: isSet(object.version) ? globalThis.Number(object.version) : 0,
       cursor: isSet(object.cursor) ? globalThis.String(object.cursor) : "",
+      fundingMode: isSet(object.fundingMode)
+        ? aIFundingModeFromJSON(object.fundingMode)
+        : isSet(object.funding_mode)
+        ? aIFundingModeFromJSON(object.funding_mode)
+        : 0,
     };
   },
 
@@ -4037,6 +4247,9 @@ export const AISessionEvent: MessageFns<AISessionEvent> = {
     if (message.cursor !== "") {
       obj.cursor = message.cursor;
     }
+    if (message.fundingMode !== 0) {
+      obj.fundingMode = aIFundingModeToJSON(message.fundingMode);
+    }
     return obj;
   },
 
@@ -4065,6 +4278,7 @@ export const AISessionEvent: MessageFns<AISessionEvent> = {
     message.logicalEventId = object.logicalEventId ?? "";
     message.version = object.version ?? 0;
     message.cursor = object.cursor ?? "";
+    message.fundingMode = object.fundingMode ?? 0;
     return message;
   },
 };
@@ -5241,6 +5455,7 @@ function createBaseSessionTimelinePoint(): SessionTimelinePoint {
     finishReason: "",
     durationMs: undefined,
     usage: undefined,
+    fundingMode: 0,
   };
 }
 
@@ -5273,6 +5488,9 @@ export const SessionTimelinePoint: MessageFns<SessionTimelinePoint> = {
     if (message.usage !== undefined) {
       AITokenUsage.encode(message.usage, writer.uint32(74).fork()).join();
     }
+    if (message.fundingMode !== 0) {
+      writer.uint32(80).int32(message.fundingMode);
+    }
     return writer;
   },
 
@@ -5361,6 +5579,14 @@ export const SessionTimelinePoint: MessageFns<SessionTimelinePoint> = {
             message.usage = AITokenUsage.decode(reader, reader.uint32());
             continue;
           }
+          case 10: {
+            if (tag !== 80) {
+              break;
+            }
+
+            message.fundingMode = reader.int32() as any;
+            continue;
+          }
         }
         if ((tag & 7) === 4 || tag === 0) {
           break;
@@ -5400,6 +5626,11 @@ export const SessionTimelinePoint: MessageFns<SessionTimelinePoint> = {
         ? globalThis.Number(object.duration_ms)
         : undefined,
       usage: isSet(object.usage) ? AITokenUsage.fromJSON(object.usage) : undefined,
+      fundingMode: isSet(object.fundingMode)
+        ? aIFundingModeFromJSON(object.fundingMode)
+        : isSet(object.funding_mode)
+        ? aIFundingModeFromJSON(object.funding_mode)
+        : 0,
     };
   },
 
@@ -5432,6 +5663,9 @@ export const SessionTimelinePoint: MessageFns<SessionTimelinePoint> = {
     if (message.usage !== undefined) {
       obj.usage = AITokenUsage.toJSON(message.usage);
     }
+    if (message.fundingMode !== 0) {
+      obj.fundingMode = aIFundingModeToJSON(message.fundingMode);
+    }
     return obj;
   },
 
@@ -5451,6 +5685,7 @@ export const SessionTimelinePoint: MessageFns<SessionTimelinePoint> = {
     message.usage = (object.usage !== undefined && object.usage !== null)
       ? AITokenUsage.fromPartial(object.usage)
       : undefined;
+    message.fundingMode = object.fundingMode ?? 0;
     return message;
   },
 };
@@ -9396,7 +9631,18 @@ export const BurnRateSparkPoint: MessageFns<BurnRateSparkPoint> = {
 };
 
 function createBaseBurnRateMeasures(): BurnRateMeasures {
-  return { usdPerHour: 0, tokensPerMin: 0, modelCalls: 0, costUnavailableCount: 0, usageUnavailableCount: 0 };
+  return {
+    usdPerHour: 0,
+    tokensPerMin: 0,
+    modelCalls: 0,
+    costUnavailableCount: 0,
+    usageUnavailableCount: 0,
+    subscriptionFacilityUsdPerHour: 0,
+    inputTokensPerMin: 0,
+    outputTokensPerMin: 0,
+    cacheReadTokensPerMin: 0,
+    cacheWriteTokensPerMin: 0,
+  };
 }
 
 export const BurnRateMeasures: MessageFns<BurnRateMeasures> = {
@@ -9416,6 +9662,21 @@ export const BurnRateMeasures: MessageFns<BurnRateMeasures> = {
     if (message.usageUnavailableCount !== 0) {
       writer.uint32(40).uint64(message.usageUnavailableCount);
     }
+    if (message.subscriptionFacilityUsdPerHour !== 0) {
+      writer.uint32(49).double(message.subscriptionFacilityUsdPerHour);
+    }
+    if (message.inputTokensPerMin !== 0) {
+      writer.uint32(57).double(message.inputTokensPerMin);
+    }
+    if (message.outputTokensPerMin !== 0) {
+      writer.uint32(65).double(message.outputTokensPerMin);
+    }
+    if (message.cacheReadTokensPerMin !== 0) {
+      writer.uint32(73).double(message.cacheReadTokensPerMin);
+    }
+    if (message.cacheWriteTokensPerMin !== 0) {
+      writer.uint32(81).double(message.cacheWriteTokensPerMin);
+    }
     return writer;
   },
 
@@ -9472,6 +9733,46 @@ export const BurnRateMeasures: MessageFns<BurnRateMeasures> = {
             message.usageUnavailableCount = longToNumber(reader.uint64());
             continue;
           }
+          case 6: {
+            if (tag !== 49) {
+              break;
+            }
+
+            message.subscriptionFacilityUsdPerHour = reader.double();
+            continue;
+          }
+          case 7: {
+            if (tag !== 57) {
+              break;
+            }
+
+            message.inputTokensPerMin = reader.double();
+            continue;
+          }
+          case 8: {
+            if (tag !== 65) {
+              break;
+            }
+
+            message.outputTokensPerMin = reader.double();
+            continue;
+          }
+          case 9: {
+            if (tag !== 73) {
+              break;
+            }
+
+            message.cacheReadTokensPerMin = reader.double();
+            continue;
+          }
+          case 10: {
+            if (tag !== 81) {
+              break;
+            }
+
+            message.cacheWriteTokensPerMin = reader.double();
+            continue;
+          }
         }
         if ((tag & 7) === 4 || tag === 0) {
           break;
@@ -9511,6 +9812,31 @@ export const BurnRateMeasures: MessageFns<BurnRateMeasures> = {
         : isSet(object.usage_unavailable_count)
         ? globalThis.Number(object.usage_unavailable_count)
         : 0,
+      subscriptionFacilityUsdPerHour: isSet(object.subscriptionFacilityUsdPerHour)
+        ? globalThis.Number(object.subscriptionFacilityUsdPerHour)
+        : isSet(object.subscription_facility_usd_per_hour)
+        ? globalThis.Number(object.subscription_facility_usd_per_hour)
+        : 0,
+      inputTokensPerMin: isSet(object.inputTokensPerMin)
+        ? globalThis.Number(object.inputTokensPerMin)
+        : isSet(object.input_tokens_per_min)
+        ? globalThis.Number(object.input_tokens_per_min)
+        : 0,
+      outputTokensPerMin: isSet(object.outputTokensPerMin)
+        ? globalThis.Number(object.outputTokensPerMin)
+        : isSet(object.output_tokens_per_min)
+        ? globalThis.Number(object.output_tokens_per_min)
+        : 0,
+      cacheReadTokensPerMin: isSet(object.cacheReadTokensPerMin)
+        ? globalThis.Number(object.cacheReadTokensPerMin)
+        : isSet(object.cache_read_tokens_per_min)
+        ? globalThis.Number(object.cache_read_tokens_per_min)
+        : 0,
+      cacheWriteTokensPerMin: isSet(object.cacheWriteTokensPerMin)
+        ? globalThis.Number(object.cacheWriteTokensPerMin)
+        : isSet(object.cache_write_tokens_per_min)
+        ? globalThis.Number(object.cache_write_tokens_per_min)
+        : 0,
     };
   },
 
@@ -9531,6 +9857,21 @@ export const BurnRateMeasures: MessageFns<BurnRateMeasures> = {
     if (message.usageUnavailableCount !== 0) {
       obj.usageUnavailableCount = Math.round(message.usageUnavailableCount);
     }
+    if (message.subscriptionFacilityUsdPerHour !== 0) {
+      obj.subscriptionFacilityUsdPerHour = message.subscriptionFacilityUsdPerHour;
+    }
+    if (message.inputTokensPerMin !== 0) {
+      obj.inputTokensPerMin = message.inputTokensPerMin;
+    }
+    if (message.outputTokensPerMin !== 0) {
+      obj.outputTokensPerMin = message.outputTokensPerMin;
+    }
+    if (message.cacheReadTokensPerMin !== 0) {
+      obj.cacheReadTokensPerMin = message.cacheReadTokensPerMin;
+    }
+    if (message.cacheWriteTokensPerMin !== 0) {
+      obj.cacheWriteTokensPerMin = message.cacheWriteTokensPerMin;
+    }
     return obj;
   },
 
@@ -9544,6 +9885,11 @@ export const BurnRateMeasures: MessageFns<BurnRateMeasures> = {
     message.modelCalls = object.modelCalls ?? 0;
     message.costUnavailableCount = object.costUnavailableCount ?? 0;
     message.usageUnavailableCount = object.usageUnavailableCount ?? 0;
+    message.subscriptionFacilityUsdPerHour = object.subscriptionFacilityUsdPerHour ?? 0;
+    message.inputTokensPerMin = object.inputTokensPerMin ?? 0;
+    message.outputTokensPerMin = object.outputTokensPerMin ?? 0;
+    message.cacheReadTokensPerMin = object.cacheReadTokensPerMin ?? 0;
+    message.cacheWriteTokensPerMin = object.cacheWriteTokensPerMin ?? 0;
     return message;
   },
 };
@@ -14795,7 +15141,14 @@ export const AIModelPrice: MessageFns<AIModelPrice> = {
 };
 
 function createBaseAITokenUsage(): AITokenUsage {
-  return { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, providerCostUsd: 0 };
+  return {
+    inputTokens: 0,
+    outputTokens: 0,
+    cacheReadTokens: 0,
+    cacheWriteTokens: 0,
+    providerCostUsd: 0,
+    facilityCostBreakdown: undefined,
+  };
 }
 
 export const AITokenUsage: MessageFns<AITokenUsage> = {
@@ -14815,6 +15168,9 @@ export const AITokenUsage: MessageFns<AITokenUsage> = {
     if (message.providerCostUsd !== 0) {
       writer.uint32(41).double(message.providerCostUsd);
     }
+    if (message.facilityCostBreakdown !== undefined) {
+      AIFacilityCostBreakdown.encode(message.facilityCostBreakdown, writer.uint32(50).fork()).join();
+    }
     return writer;
   },
 
@@ -14871,6 +15227,14 @@ export const AITokenUsage: MessageFns<AITokenUsage> = {
             message.providerCostUsd = reader.double();
             continue;
           }
+          case 6: {
+            if (tag !== 50) {
+              break;
+            }
+
+            message.facilityCostBreakdown = AIFacilityCostBreakdown.decode(reader, reader.uint32());
+            continue;
+          }
         }
         if ((tag & 7) === 4 || tag === 0) {
           break;
@@ -14910,6 +15274,11 @@ export const AITokenUsage: MessageFns<AITokenUsage> = {
         : isSet(object.provider_cost_usd)
         ? globalThis.Number(object.provider_cost_usd)
         : 0,
+      facilityCostBreakdown: isSet(object.facilityCostBreakdown)
+        ? AIFacilityCostBreakdown.fromJSON(object.facilityCostBreakdown)
+        : isSet(object.facility_cost_breakdown)
+        ? AIFacilityCostBreakdown.fromJSON(object.facility_cost_breakdown)
+        : undefined,
     };
   },
 
@@ -14930,6 +15299,9 @@ export const AITokenUsage: MessageFns<AITokenUsage> = {
     if (message.providerCostUsd !== 0) {
       obj.providerCostUsd = message.providerCostUsd;
     }
+    if (message.facilityCostBreakdown !== undefined) {
+      obj.facilityCostBreakdown = AIFacilityCostBreakdown.toJSON(message.facilityCostBreakdown);
+    }
     return obj;
   },
 
@@ -14943,107 +15315,949 @@ export const AITokenUsage: MessageFns<AITokenUsage> = {
     message.cacheReadTokens = object.cacheReadTokens ?? 0;
     message.cacheWriteTokens = object.cacheWriteTokens ?? 0;
     message.providerCostUsd = object.providerCostUsd ?? 0;
+    message.facilityCostBreakdown =
+      (object.facilityCostBreakdown !== undefined && object.facilityCostBreakdown !== null)
+        ? AIFacilityCostBreakdown.fromPartial(object.facilityCostBreakdown)
+        : 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>;
-  ListPrincipals(request: ListPrincipalsRequest, metadata?: Metadata): Promise<ListPrincipalsResponse>;
-  UpdatePrincipal(request: UpdatePrincipalRequest, metadata?: Metadata): Promise<UpdatePrincipalResponse>;
-  /** 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 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>;
-  /** Per-file working-state feed (keyset-paginated) behind the unlanded-work funnel. */
-  ListFiles(request: ListFilesRequest, metadata?: Metadata): Promise<ListFilesResponse>;
-  /**
-   * Live stream of the unlanded-work funnel: aging tiers + discarded (git-invisible churn), observed vs
-   * unverified, a complete snapshot re-derived each tick.
-   */
-  StreamFilesSummary(request: FilesSummaryRequest, metadata?: Metadata): Observable<FilesSummary>;
-  /** Latest observed list price per (source, provider, model) from the global catalog. */
-  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 is required.
-   */
-  ListModelPriceHistory(
-    request: ListModelPriceHistoryRequest,
-    metadata?: Metadata,
-  ): Promise<ListModelPriceHistoryResponse>;
+function createBaseAIFacilityCostBreakdown(): AIFacilityCostBreakdown {
+  return {
+    notionalUsd: 0,
+    subscriptionFacilityUsd: 0,
+    prepaidCreditsFacilityUsd: 0,
+    apiMeteredFacilityUsd: 0,
+    unknownFacilityUsd: 0,
+    pricedCalls: 0,
+    totalCalls: 0,
+  };
+}
+
+export const AIFacilityCostBreakdown: MessageFns<AIFacilityCostBreakdown> = {
+  encode(message: AIFacilityCostBreakdown, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.notionalUsd !== 0) {
+      writer.uint32(9).double(message.notionalUsd);
+    }
+    if (message.subscriptionFacilityUsd !== 0) {
+      writer.uint32(17).double(message.subscriptionFacilityUsd);
+    }
+    if (message.prepaidCreditsFacilityUsd !== 0) {
+      writer.uint32(25).double(message.prepaidCreditsFacilityUsd);
+    }
+    if (message.apiMeteredFacilityUsd !== 0) {
+      writer.uint32(33).double(message.apiMeteredFacilityUsd);
+    }
+    if (message.unknownFacilityUsd !== 0) {
+      writer.uint32(41).double(message.unknownFacilityUsd);
+    }
+    if (message.pricedCalls !== 0) {
+      writer.uint32(48).uint64(message.pricedCalls);
+    }
+    if (message.totalCalls !== 0) {
+      writer.uint32(56).uint64(message.totalCalls);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): AIFacilityCostBreakdown {
+    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 = createBaseAIFacilityCostBreakdown();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 9) {
+              break;
+            }
+
+            message.notionalUsd = reader.double();
+            continue;
+          }
+          case 2: {
+            if (tag !== 17) {
+              break;
+            }
+
+            message.subscriptionFacilityUsd = reader.double();
+            continue;
+          }
+          case 3: {
+            if (tag !== 25) {
+              break;
+            }
+
+            message.prepaidCreditsFacilityUsd = reader.double();
+            continue;
+          }
+          case 4: {
+            if (tag !== 33) {
+              break;
+            }
+
+            message.apiMeteredFacilityUsd = reader.double();
+            continue;
+          }
+          case 5: {
+            if (tag !== 41) {
+              break;
+            }
+
+            message.unknownFacilityUsd = reader.double();
+            continue;
+          }
+          case 6: {
+            if (tag !== 48) {
+              break;
+            }
+
+            message.pricedCalls = longToNumber(reader.uint64());
+            continue;
+          }
+          case 7: {
+            if (tag !== 56) {
+              break;
+            }
+
+            message.totalCalls = longToNumber(reader.uint64());
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): AIFacilityCostBreakdown {
+    return {
+      notionalUsd: isSet(object.notionalUsd)
+        ? globalThis.Number(object.notionalUsd)
+        : isSet(object.notional_usd)
+        ? globalThis.Number(object.notional_usd)
+        : 0,
+      subscriptionFacilityUsd: isSet(object.subscriptionFacilityUsd)
+        ? globalThis.Number(object.subscriptionFacilityUsd)
+        : isSet(object.subscription_facility_usd)
+        ? globalThis.Number(object.subscription_facility_usd)
+        : 0,
+      prepaidCreditsFacilityUsd: isSet(object.prepaidCreditsFacilityUsd)
+        ? globalThis.Number(object.prepaidCreditsFacilityUsd)
+        : isSet(object.prepaid_credits_facility_usd)
+        ? globalThis.Number(object.prepaid_credits_facility_usd)
+        : 0,
+      apiMeteredFacilityUsd: isSet(object.apiMeteredFacilityUsd)
+        ? globalThis.Number(object.apiMeteredFacilityUsd)
+        : isSet(object.api_metered_facility_usd)
+        ? globalThis.Number(object.api_metered_facility_usd)
+        : 0,
+      unknownFacilityUsd: isSet(object.unknownFacilityUsd)
+        ? globalThis.Number(object.unknownFacilityUsd)
+        : isSet(object.unknown_facility_usd)
+        ? globalThis.Number(object.unknown_facility_usd)
+        : 0,
+      pricedCalls: isSet(object.pricedCalls)
+        ? globalThis.Number(object.pricedCalls)
+        : isSet(object.priced_calls)
+        ? globalThis.Number(object.priced_calls)
+        : 0,
+      totalCalls: isSet(object.totalCalls)
+        ? globalThis.Number(object.totalCalls)
+        : isSet(object.total_calls)
+        ? globalThis.Number(object.total_calls)
+        : 0,
+    };
+  },
+
+  toJSON(message: AIFacilityCostBreakdown): unknown {
+    const obj: any = {};
+    if (message.notionalUsd !== 0) {
+      obj.notionalUsd = message.notionalUsd;
+    }
+    if (message.subscriptionFacilityUsd !== 0) {
+      obj.subscriptionFacilityUsd = message.subscriptionFacilityUsd;
+    }
+    if (message.prepaidCreditsFacilityUsd !== 0) {
+      obj.prepaidCreditsFacilityUsd = message.prepaidCreditsFacilityUsd;
+    }
+    if (message.apiMeteredFacilityUsd !== 0) {
+      obj.apiMeteredFacilityUsd = message.apiMeteredFacilityUsd;
+    }
+    if (message.unknownFacilityUsd !== 0) {
+      obj.unknownFacilityUsd = message.unknownFacilityUsd;
+    }
+    if (message.pricedCalls !== 0) {
+      obj.pricedCalls = Math.round(message.pricedCalls);
+    }
+    if (message.totalCalls !== 0) {
+      obj.totalCalls = Math.round(message.totalCalls);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<AIFacilityCostBreakdown>, I>>(base?: I): AIFacilityCostBreakdown {
+    return AIFacilityCostBreakdown.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<AIFacilityCostBreakdown>, I>>(object: I): AIFacilityCostBreakdown {
+    const message = createBaseAIFacilityCostBreakdown();
+    message.notionalUsd = object.notionalUsd ?? 0;
+    message.subscriptionFacilityUsd = object.subscriptionFacilityUsd ?? 0;
+    message.prepaidCreditsFacilityUsd = object.prepaidCreditsFacilityUsd ?? 0;
+    message.apiMeteredFacilityUsd = object.apiMeteredFacilityUsd ?? 0;
+    message.unknownFacilityUsd = object.unknownFacilityUsd ?? 0;
+    message.pricedCalls = object.pricedCalls ?? 0;
+    message.totalCalls = object.totalCalls ?? 0;
+    return message;
+  },
+};
+
+function createBaseStreamEntitlementsRequest(): StreamEntitlementsRequest {
+  return { organizationId: "", projectId: "" };
+}
+
+export const StreamEntitlementsRequest: MessageFns<StreamEntitlementsRequest> = {
+  encode(message: StreamEntitlementsRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.organizationId !== "") {
+      writer.uint32(10).string(message.organizationId);
+    }
+    if (message.projectId !== "") {
+      writer.uint32(18).string(message.projectId);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): StreamEntitlementsRequest {
+    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 = createBaseStreamEntitlementsRequest();
+      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;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): StreamEntitlementsRequest {
+    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)
+        : "",
+    };
+  },
+
+  toJSON(message: StreamEntitlementsRequest): unknown {
+    const obj: any = {};
+    if (message.organizationId !== "") {
+      obj.organizationId = message.organizationId;
+    }
+    if (message.projectId !== "") {
+      obj.projectId = message.projectId;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<StreamEntitlementsRequest>, I>>(base?: I): StreamEntitlementsRequest {
+    return StreamEntitlementsRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<StreamEntitlementsRequest>, I>>(object: I): StreamEntitlementsRequest {
+    const message = createBaseStreamEntitlementsRequest();
+    message.organizationId = object.organizationId ?? "";
+    message.projectId = object.projectId ?? "";
+    return message;
+  },
+};
+
+function createBaseEntitlementsSnapshot(): EntitlementsSnapshot {
+  return { seats: [], asOf: undefined };
+}
+
+export const EntitlementsSnapshot: MessageFns<EntitlementsSnapshot> = {
+  encode(message: EntitlementsSnapshot, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    for (const v of message.seats) {
+      SeatEntitlement.encode(v!, writer.uint32(10).fork()).join();
+    }
+    if (message.asOf !== undefined) {
+      Timestamp.encode(toTimestamp(message.asOf), writer.uint32(18).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): EntitlementsSnapshot {
+    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 = createBaseEntitlementsSnapshot();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.seats.push(SeatEntitlement.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.asOf = 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): EntitlementsSnapshot {
+    return {
+      seats: globalThis.Array.isArray(object?.seats) ? object.seats.map((e: any) => SeatEntitlement.fromJSON(e)) : [],
+      asOf: isSet(object.asOf)
+        ? fromJsonTimestamp(object.asOf)
+        : isSet(object.as_of)
+        ? fromJsonTimestamp(object.as_of)
+        : undefined,
+    };
+  },
+
+  toJSON(message: EntitlementsSnapshot): unknown {
+    const obj: any = {};
+    if (message.seats?.length) {
+      obj.seats = message.seats.map((e) => SeatEntitlement.toJSON(e));
+    }
+    if (message.asOf !== undefined) {
+      obj.asOf = message.asOf.toISOString();
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<EntitlementsSnapshot>, I>>(base?: I): EntitlementsSnapshot {
+    return EntitlementsSnapshot.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<EntitlementsSnapshot>, I>>(object: I): EntitlementsSnapshot {
+    const message = createBaseEntitlementsSnapshot();
+    message.seats = object.seats?.map((e) => SeatEntitlement.fromPartial(e)) || [];
+    message.asOf = object.asOf ?? undefined;
+    return message;
+  },
+};
+
+function createBaseSeatEntitlement(): SeatEntitlement {
+  return {
+    sourceSystem: "",
+    accountId: "",
+    principalId: "",
+    principalName: "",
+    fundingMode: 0,
+    windows: [],
+    eventTime: undefined,
+    creditsBalanceRaw: undefined,
+    creditsUnlimited: undefined,
+    planType: "",
+    seatTier: "",
+    evidenceSource: "",
+  };
+}
+
+export const SeatEntitlement: MessageFns<SeatEntitlement> = {
+  encode(message: SeatEntitlement, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.sourceSystem !== "") {
+      writer.uint32(10).string(message.sourceSystem);
+    }
+    if (message.accountId !== "") {
+      writer.uint32(18).string(message.accountId);
+    }
+    if (message.principalId !== "") {
+      writer.uint32(26).string(message.principalId);
+    }
+    if (message.principalName !== "") {
+      writer.uint32(34).string(message.principalName);
+    }
+    if (message.fundingMode !== 0) {
+      writer.uint32(40).int32(message.fundingMode);
+    }
+    for (const v of message.windows) {
+      EntitlementWindow.encode(v!, writer.uint32(50).fork()).join();
+    }
+    if (message.eventTime !== undefined) {
+      Timestamp.encode(toTimestamp(message.eventTime), writer.uint32(58).fork()).join();
+    }
+    if (message.creditsBalanceRaw !== undefined) {
+      writer.uint32(66).string(message.creditsBalanceRaw);
+    }
+    if (message.creditsUnlimited !== undefined) {
+      writer.uint32(72).bool(message.creditsUnlimited);
+    }
+    if (message.planType !== "") {
+      writer.uint32(82).string(message.planType);
+    }
+    if (message.seatTier !== "") {
+      writer.uint32(90).string(message.seatTier);
+    }
+    if (message.evidenceSource !== "") {
+      writer.uint32(98).string(message.evidenceSource);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): SeatEntitlement {
+    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 = createBaseSeatEntitlement();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.sourceSystem = reader.string();
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.accountId = reader.string();
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.principalId = reader.string();
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.principalName = reader.string();
+            continue;
+          }
+          case 5: {
+            if (tag !== 40) {
+              break;
+            }
+
+            message.fundingMode = reader.int32() as any;
+            continue;
+          }
+          case 6: {
+            if (tag !== 50) {
+              break;
+            }
+
+            message.windows.push(EntitlementWindow.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 7: {
+            if (tag !== 58) {
+              break;
+            }
+
+            message.eventTime = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 8: {
+            if (tag !== 66) {
+              break;
+            }
+
+            message.creditsBalanceRaw = reader.string();
+            continue;
+          }
+          case 9: {
+            if (tag !== 72) {
+              break;
+            }
+
+            message.creditsUnlimited = reader.bool();
+            continue;
+          }
+          case 10: {
+            if (tag !== 82) {
+              break;
+            }
+
+            message.planType = reader.string();
+            continue;
+          }
+          case 11: {
+            if (tag !== 90) {
+              break;
+            }
+
+            message.seatTier = reader.string();
+            continue;
+          }
+          case 12: {
+            if (tag !== 98) {
+              break;
+            }
+
+            message.evidenceSource = 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): SeatEntitlement {
+    return {
+      sourceSystem: isSet(object.sourceSystem)
+        ? globalThis.String(object.sourceSystem)
+        : isSet(object.source_system)
+        ? globalThis.String(object.source_system)
+        : "",
+      accountId: isSet(object.accountId)
+        ? globalThis.String(object.accountId)
+        : isSet(object.account_id)
+        ? globalThis.String(object.account_id)
+        : "",
+      principalId: isSet(object.principalId)
+        ? globalThis.String(object.principalId)
+        : isSet(object.principal_id)
+        ? globalThis.String(object.principal_id)
+        : "",
+      principalName: isSet(object.principalName)
+        ? globalThis.String(object.principalName)
+        : isSet(object.principal_name)
+        ? globalThis.String(object.principal_name)
+        : "",
+      fundingMode: isSet(object.fundingMode)
+        ? aIFundingModeFromJSON(object.fundingMode)
+        : isSet(object.funding_mode)
+        ? aIFundingModeFromJSON(object.funding_mode)
+        : 0,
+      windows: globalThis.Array.isArray(object?.windows)
+        ? object.windows.map((e: any) => EntitlementWindow.fromJSON(e))
+        : [],
+      eventTime: isSet(object.eventTime)
+        ? fromJsonTimestamp(object.eventTime)
+        : isSet(object.event_time)
+        ? fromJsonTimestamp(object.event_time)
+        : undefined,
+      creditsBalanceRaw: isSet(object.creditsBalanceRaw)
+        ? globalThis.String(object.creditsBalanceRaw)
+        : isSet(object.credits_balance_raw)
+        ? globalThis.String(object.credits_balance_raw)
+        : undefined,
+      creditsUnlimited: isSet(object.creditsUnlimited)
+        ? globalThis.Boolean(object.creditsUnlimited)
+        : isSet(object.credits_unlimited)
+        ? globalThis.Boolean(object.credits_unlimited)
+        : undefined,
+      planType: isSet(object.planType)
+        ? globalThis.String(object.planType)
+        : isSet(object.plan_type)
+        ? globalThis.String(object.plan_type)
+        : "",
+      seatTier: isSet(object.seatTier)
+        ? globalThis.String(object.seatTier)
+        : isSet(object.seat_tier)
+        ? globalThis.String(object.seat_tier)
+        : "",
+      evidenceSource: isSet(object.evidenceSource)
+        ? globalThis.String(object.evidenceSource)
+        : isSet(object.evidence_source)
+        ? globalThis.String(object.evidence_source)
+        : "",
+    };
+  },
+
+  toJSON(message: SeatEntitlement): unknown {
+    const obj: any = {};
+    if (message.sourceSystem !== "") {
+      obj.sourceSystem = message.sourceSystem;
+    }
+    if (message.accountId !== "") {
+      obj.accountId = message.accountId;
+    }
+    if (message.principalId !== "") {
+      obj.principalId = message.principalId;
+    }
+    if (message.principalName !== "") {
+      obj.principalName = message.principalName;
+    }
+    if (message.fundingMode !== 0) {
+      obj.fundingMode = aIFundingModeToJSON(message.fundingMode);
+    }
+    if (message.windows?.length) {
+      obj.windows = message.windows.map((e) => EntitlementWindow.toJSON(e));
+    }
+    if (message.eventTime !== undefined) {
+      obj.eventTime = message.eventTime.toISOString();
+    }
+    if (message.creditsBalanceRaw !== undefined) {
+      obj.creditsBalanceRaw = message.creditsBalanceRaw;
+    }
+    if (message.creditsUnlimited !== undefined) {
+      obj.creditsUnlimited = message.creditsUnlimited;
+    }
+    if (message.planType !== "") {
+      obj.planType = message.planType;
+    }
+    if (message.seatTier !== "") {
+      obj.seatTier = message.seatTier;
+    }
+    if (message.evidenceSource !== "") {
+      obj.evidenceSource = message.evidenceSource;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<SeatEntitlement>, I>>(base?: I): SeatEntitlement {
+    return SeatEntitlement.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<SeatEntitlement>, I>>(object: I): SeatEntitlement {
+    const message = createBaseSeatEntitlement();
+    message.sourceSystem = object.sourceSystem ?? "";
+    message.accountId = object.accountId ?? "";
+    message.principalId = object.principalId ?? "";
+    message.principalName = object.principalName ?? "";
+    message.fundingMode = object.fundingMode ?? 0;
+    message.windows = object.windows?.map((e) => EntitlementWindow.fromPartial(e)) || [];
+    message.eventTime = object.eventTime ?? undefined;
+    message.creditsBalanceRaw = object.creditsBalanceRaw ?? undefined;
+    message.creditsUnlimited = object.creditsUnlimited ?? undefined;
+    message.planType = object.planType ?? "";
+    message.seatTier = object.seatTier ?? "";
+    message.evidenceSource = object.evidenceSource ?? "";
+    return message;
+  },
+};
+
+function createBaseEntitlementWindow(): EntitlementWindow {
+  return { kind: "", usedPct: undefined, resetsAt: undefined, role: 0, windowSeconds: undefined };
+}
+
+export const EntitlementWindow: MessageFns<EntitlementWindow> = {
+  encode(message: EntitlementWindow, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.kind !== "") {
+      writer.uint32(10).string(message.kind);
+    }
+    if (message.usedPct !== undefined) {
+      writer.uint32(17).double(message.usedPct);
+    }
+    if (message.resetsAt !== undefined) {
+      Timestamp.encode(toTimestamp(message.resetsAt), writer.uint32(26).fork()).join();
+    }
+    if (message.role !== 0) {
+      writer.uint32(32).int32(message.role);
+    }
+    if (message.windowSeconds !== undefined) {
+      writer.uint32(40).uint32(message.windowSeconds);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): EntitlementWindow {
+    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 = createBaseEntitlementWindow();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.kind = reader.string();
+            continue;
+          }
+          case 2: {
+            if (tag !== 17) {
+              break;
+            }
+
+            message.usedPct = reader.double();
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.resetsAt = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 4: {
+            if (tag !== 32) {
+              break;
+            }
+
+            message.role = reader.int32() as any;
+            continue;
+          }
+          case 5: {
+            if (tag !== 40) {
+              break;
+            }
+
+            message.windowSeconds = 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): EntitlementWindow {
+    return {
+      kind: isSet(object.kind) ? globalThis.String(object.kind) : "",
+      usedPct: isSet(object.usedPct)
+        ? globalThis.Number(object.usedPct)
+        : isSet(object.used_pct)
+        ? globalThis.Number(object.used_pct)
+        : undefined,
+      resetsAt: isSet(object.resetsAt)
+        ? fromJsonTimestamp(object.resetsAt)
+        : isSet(object.resets_at)
+        ? fromJsonTimestamp(object.resets_at)
+        : undefined,
+      role: isSet(object.role) ? aIEntitlementRoleFromJSON(object.role) : 0,
+      windowSeconds: isSet(object.windowSeconds)
+        ? globalThis.Number(object.windowSeconds)
+        : isSet(object.window_seconds)
+        ? globalThis.Number(object.window_seconds)
+        : undefined,
+    };
+  },
+
+  toJSON(message: EntitlementWindow): unknown {
+    const obj: any = {};
+    if (message.kind !== "") {
+      obj.kind = message.kind;
+    }
+    if (message.usedPct !== undefined) {
+      obj.usedPct = message.usedPct;
+    }
+    if (message.resetsAt !== undefined) {
+      obj.resetsAt = message.resetsAt.toISOString();
+    }
+    if (message.role !== 0) {
+      obj.role = aIEntitlementRoleToJSON(message.role);
+    }
+    if (message.windowSeconds !== undefined) {
+      obj.windowSeconds = Math.round(message.windowSeconds);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<EntitlementWindow>, I>>(base?: I): EntitlementWindow {
+    return EntitlementWindow.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<EntitlementWindow>, I>>(object: I): EntitlementWindow {
+    const message = createBaseEntitlementWindow();
+    message.kind = object.kind ?? "";
+    message.usedPct = object.usedPct ?? undefined;
+    message.resetsAt = object.resetsAt ?? undefined;
+    message.role = object.role ?? 0;
+    message.windowSeconds = object.windowSeconds ?? 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>;
+  ListPrincipals(request: ListPrincipalsRequest, metadata?: Metadata): Promise<ListPrincipalsResponse>;
+  UpdatePrincipal(request: UpdatePrincipalRequest, metadata?: Metadata): Promise<UpdatePrincipalResponse>;
+  /** 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 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>;
+  /** Per-file working-state feed (keyset-paginated) behind the unlanded-work funnel. */
+  ListFiles(request: ListFilesRequest, metadata?: Metadata): Promise<ListFilesResponse>;
+  /**
+   * Live stream of the unlanded-work funnel: aging tiers + discarded (git-invisible churn), observed vs
+   * unverified, a complete snapshot re-derived each tick.
+   */
+  StreamFilesSummary(request: FilesSummaryRequest, metadata?: Metadata): Observable<FilesSummary>;
+  /** Latest observed list price per (source, provider, model) from the global catalog. */
+  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 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>;
+  /**
+   * 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>;
 }
 
 export const AIGatewayServiceServiceName = "gateway.web.v1.AIGatewayService";
@@ -15075,6 +16289,7 @@ export class AIGatewayServiceClientImpl implements AIGatewayService {
     this.ListModelPrices = this.ListModelPrices.bind(this);
     this.ListModelPriceHistory = this.ListModelPriceHistory.bind(this);
     this.ListResourceRankings = this.ListResourceRankings.bind(this);
+    this.StreamEntitlements = this.StreamEntitlements.bind(this);
   }
   ListSessions(request: ListSessionsRequest, metadata?: Metadata): Promise<ListSessionsResponse> {
     const data = ListSessionsRequest.encode(request).finish();
@@ -15216,6 +16431,12 @@ export class AIGatewayServiceClientImpl implements AIGatewayService {
     const promise = this.rpc.request(this.service, "ListResourceRankings", data, metadata);
     return promise.then((data) => ResourceRankingsResponse.decode(new BinaryReader(data)));
   }
+
+  StreamEntitlements(request: StreamEntitlementsRequest, metadata?: Metadata): Observable<EntitlementsSnapshot> {
+    const data = StreamEntitlementsRequest.encode(request).finish();
+    const result = this.rpc.serverStreamingRequest(this.service, "StreamEntitlements", data, metadata);
+    return result.pipe(map((data) => EntitlementsSnapshot.decode(new BinaryReader(data))));
+  }
 }
 
 interface Rpc {