@miradorlabs/web-grpc 3.38.0 → 3.39.0

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

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.15.3
+//   protoc-gen-ts_proto  v2.18.0
 //   protoc               v3.21.12
 // source: proto/gateway/web/v1/admin_gateway.proto
 
@@ -16,10 +16,135 @@ import {
   relayHeartbeatSortToJSON,
 } from "./ai_gateway";
 import { InviteCodeState, inviteCodeStateFromJSON, inviteCodeStateToJSON } from "./beta_gateway";
-import { AIReferenceGroupFilter, AIReferenceName } from "./reference_gateway";
+import {
+  AIPrincipalKind,
+  aIPrincipalKindFromJSON,
+  aIPrincipalKindToJSON,
+  AIReferenceGroupFilter,
+  AIReferenceName,
+} from "./reference_gateway";
+import { Pagination } from "./trace_gateway";
 
 export const protobufPackage = "gateway.web.v1";
 
+export const protobufFileName = "proto/gateway/web/v1/admin_gateway.proto";
+
+/** AdminUsageDimension mirrors ai.api.v1.AdminUsageDimension: one dimension a usage group is keyed by. */
+export enum AdminUsageDimension {
+  ADMIN_USAGE_DIMENSION_UNSPECIFIED = 0,
+  ADMIN_USAGE_DIMENSION_ORGANIZATION = 1,
+  /** ADMIN_USAGE_DIMENSION_PRINCIPAL - The usage's principal as reported: its user id, else its api key id, else unattributed. */
+  ADMIN_USAGE_DIMENSION_PRINCIPAL = 2,
+  /** ADMIN_USAGE_DIMENSION_SOURCE - The source system (harness) as stored. */
+  ADMIN_USAGE_DIMENSION_SOURCE = 3,
+  /** ADMIN_USAGE_DIMENSION_MODEL - The model as stored, not its display name. */
+  ADMIN_USAGE_DIMENSION_MODEL = 4,
+  /** ADMIN_USAGE_DIMENSION_DAY - The UTC day. */
+  ADMIN_USAGE_DIMENSION_DAY = 5,
+  UNRECOGNIZED = -1,
+}
+
+export function adminUsageDimensionFromJSON(object: any): AdminUsageDimension {
+  switch (object) {
+    case 0:
+    case "ADMIN_USAGE_DIMENSION_UNSPECIFIED":
+      return AdminUsageDimension.ADMIN_USAGE_DIMENSION_UNSPECIFIED;
+    case 1:
+    case "ADMIN_USAGE_DIMENSION_ORGANIZATION":
+      return AdminUsageDimension.ADMIN_USAGE_DIMENSION_ORGANIZATION;
+    case 2:
+    case "ADMIN_USAGE_DIMENSION_PRINCIPAL":
+      return AdminUsageDimension.ADMIN_USAGE_DIMENSION_PRINCIPAL;
+    case 3:
+    case "ADMIN_USAGE_DIMENSION_SOURCE":
+      return AdminUsageDimension.ADMIN_USAGE_DIMENSION_SOURCE;
+    case 4:
+    case "ADMIN_USAGE_DIMENSION_MODEL":
+      return AdminUsageDimension.ADMIN_USAGE_DIMENSION_MODEL;
+    case 5:
+    case "ADMIN_USAGE_DIMENSION_DAY":
+      return AdminUsageDimension.ADMIN_USAGE_DIMENSION_DAY;
+    case -1:
+    case "UNRECOGNIZED":
+    default:
+      return AdminUsageDimension.UNRECOGNIZED;
+  }
+}
+
+export function adminUsageDimensionToJSON(object: AdminUsageDimension): string {
+  switch (object) {
+    case AdminUsageDimension.ADMIN_USAGE_DIMENSION_UNSPECIFIED:
+      return "ADMIN_USAGE_DIMENSION_UNSPECIFIED";
+    case AdminUsageDimension.ADMIN_USAGE_DIMENSION_ORGANIZATION:
+      return "ADMIN_USAGE_DIMENSION_ORGANIZATION";
+    case AdminUsageDimension.ADMIN_USAGE_DIMENSION_PRINCIPAL:
+      return "ADMIN_USAGE_DIMENSION_PRINCIPAL";
+    case AdminUsageDimension.ADMIN_USAGE_DIMENSION_SOURCE:
+      return "ADMIN_USAGE_DIMENSION_SOURCE";
+    case AdminUsageDimension.ADMIN_USAGE_DIMENSION_MODEL:
+      return "ADMIN_USAGE_DIMENSION_MODEL";
+    case AdminUsageDimension.ADMIN_USAGE_DIMENSION_DAY:
+      return "ADMIN_USAGE_DIMENSION_DAY";
+    case AdminUsageDimension.UNRECOGNIZED:
+    default:
+      return "UNRECOGNIZED";
+  }
+}
+
+/** AdminUsageGroupSort mirrors ai.api.v1.AdminUsageGroupSort; ties break on the group key ascending. */
+export enum AdminUsageGroupSort {
+  ADMIN_USAGE_GROUP_SORT_UNSPECIFIED = 0,
+  ADMIN_USAGE_GROUP_SORT_COST_DESC = 1,
+  /** ADMIN_USAGE_GROUP_SORT_TOKENS_DESC - input_tokens + output_tokens, so cache reads and writes count (they are part of input). */
+  ADMIN_USAGE_GROUP_SORT_TOKENS_DESC = 2,
+  ADMIN_USAGE_GROUP_SORT_CALLS_DESC = 3,
+  /** ADMIN_USAGE_GROUP_SORT_GROUP_ASC - The group key ascending, in group_by order: a day series reads in date order. */
+  ADMIN_USAGE_GROUP_SORT_GROUP_ASC = 4,
+  UNRECOGNIZED = -1,
+}
+
+export function adminUsageGroupSortFromJSON(object: any): AdminUsageGroupSort {
+  switch (object) {
+    case 0:
+    case "ADMIN_USAGE_GROUP_SORT_UNSPECIFIED":
+      return AdminUsageGroupSort.ADMIN_USAGE_GROUP_SORT_UNSPECIFIED;
+    case 1:
+    case "ADMIN_USAGE_GROUP_SORT_COST_DESC":
+      return AdminUsageGroupSort.ADMIN_USAGE_GROUP_SORT_COST_DESC;
+    case 2:
+    case "ADMIN_USAGE_GROUP_SORT_TOKENS_DESC":
+      return AdminUsageGroupSort.ADMIN_USAGE_GROUP_SORT_TOKENS_DESC;
+    case 3:
+    case "ADMIN_USAGE_GROUP_SORT_CALLS_DESC":
+      return AdminUsageGroupSort.ADMIN_USAGE_GROUP_SORT_CALLS_DESC;
+    case 4:
+    case "ADMIN_USAGE_GROUP_SORT_GROUP_ASC":
+      return AdminUsageGroupSort.ADMIN_USAGE_GROUP_SORT_GROUP_ASC;
+    case -1:
+    case "UNRECOGNIZED":
+    default:
+      return AdminUsageGroupSort.UNRECOGNIZED;
+  }
+}
+
+export function adminUsageGroupSortToJSON(object: AdminUsageGroupSort): string {
+  switch (object) {
+    case AdminUsageGroupSort.ADMIN_USAGE_GROUP_SORT_UNSPECIFIED:
+      return "ADMIN_USAGE_GROUP_SORT_UNSPECIFIED";
+    case AdminUsageGroupSort.ADMIN_USAGE_GROUP_SORT_COST_DESC:
+      return "ADMIN_USAGE_GROUP_SORT_COST_DESC";
+    case AdminUsageGroupSort.ADMIN_USAGE_GROUP_SORT_TOKENS_DESC:
+      return "ADMIN_USAGE_GROUP_SORT_TOKENS_DESC";
+    case AdminUsageGroupSort.ADMIN_USAGE_GROUP_SORT_CALLS_DESC:
+      return "ADMIN_USAGE_GROUP_SORT_CALLS_DESC";
+    case AdminUsageGroupSort.ADMIN_USAGE_GROUP_SORT_GROUP_ASC:
+      return "ADMIN_USAGE_GROUP_SORT_GROUP_ASC";
+    case AdminUsageGroupSort.UNRECOGNIZED:
+    default:
+      return "UNRECOGNIZED";
+  }
+}
+
 export interface GetAdminStatusRequest {
 }
 
@@ -262,6 +387,103 @@ export interface AdminRelayHeartbeat_CountersEntry {
   value: number;
 }
 
+export interface ListAdminUsageGroupsRequest {
+  /**
+   * The window is [start_time, end_time) in whole UTC days: both UTC midnights, end after start, at most 92 days
+   * apart, within 1970-01-01 to 2149-06-06; anything else is a validation error.
+   */
+  startTime: Date | undefined;
+  endTime:
+    | Date
+    | undefined;
+  /**
+   * The dimensions a row is grouped by, each at most once; empty is one row, the totals. UNSPECIFIED, an unknown
+   * value or a repeat is a validation error.
+   */
+  groupBy: AdminUsageDimension[];
+  filter:
+    | AdminUsageGroupFilter
+    | undefined;
+  /** Unspecified is ADMIN_USAGE_GROUP_SORT_COST_DESC; an unknown value is a validation error. */
+  sort: AdminUsageGroupSort;
+  /** 1-indexed; below 1 = 1. A page past the last returns the last page: read pagination.page. */
+  page: number;
+  /** The server default (50) when 0, coerced to 1000 above it; negative is a validation error. */
+  perPage: number;
+}
+
+export interface ListAdminUsageGroupsResponse {
+  status: ResponseStatus | undefined;
+  groups: AdminUsageGroup[];
+  /**
+   * total_count is the groups the window and filter hold, exact, computed on every request (a refresh between two
+   * pages can move groups across them); anchor_timestamp is unset.
+   */
+  pagination:
+    | Pagination
+    | undefined;
+  /**
+   * The newest daily-activity refresh among the slices read (its run's start), whatever the page. It is no
+   * completeness mark: a day the job no longer refreshes keeps its last run's figures. Unset when no slice matched.
+   */
+  refreshedAt: Date | undefined;
+}
+
+/**
+ * AdminUsageGroupFilter mirrors ai.api.v1.AdminUsageGroupFilter: fields AND, a repeated field matches any of its
+ * values, and an unset or empty field does not filter.
+ */
+export interface AdminUsageGroupFilter {
+  /** Canonical UUIDs, at most 100; a malformed id is a validation error. */
+  organizationIds: string[];
+  /**
+   * Stored user ids, matched exactly, at most 100, each non-empty and at most 256 bytes. For a session the Terma CLI
+   * relayed this is the Mirador account user id the CLI claims (the relay's account_user_id); otherwise it is the
+   * harness's own id.
+   */
+  userIds: string[];
+}
+
+/**
+ * AdminUsageGroup mirrors ai.api.v1.AdminUsageGroup. A key field is set only for a dimension in group_by, where ''
+ * means the slices reported none (no model). Distinct counts are not additive across groups. A group can hold no
+ * tokens or cost: usage that is only sessions, files or git activity still counts.
+ */
+export interface AdminUsageGroup {
+  organizationId: string;
+  /** USER for a user id, API_KEY for an api key id, UNSPECIFIED (with principal_id '') for unattributed usage. */
+  principalKind: AIPrincipalKind;
+  /**
+   * As reported, for display: a Mirador account user id is client-claimed through the Terma CLI, and a harness's
+   * own id names no Mirador user.
+   */
+  principalId: string;
+  sourceSystem: string;
+  model: string;
+  /** the UTC midnight */
+  day:
+    | Date
+    | undefined;
+  /** includes cache reads and writes */
+  inputTokens: number;
+  outputTokens: number;
+  cacheReadTokens: number;
+  cacheWriteTokens: number;
+  costUsd: number;
+  /** The part of cost_usd billed to a subscription. */
+  subscriptionCostUsd: number;
+  modelCalls: number;
+  toolCalls: number;
+  userMessages: number;
+  /**
+   * Distinct (source system, session) pairs across the fleet: a session reported to two projects counts once.
+   * Approximate past a few thousand (about 0.5%).
+   */
+  sessions: number;
+  /** Distinct stored user ids among the group's usage, exact; ids, not people. */
+  userIdCount: number;
+}
+
 export interface ResolveOrgDetailsRequest {
   /** UUIDs, at most 1000; a malformed id is a validation error. */
   organizationIds: string[];
@@ -3322,19 +3544,37 @@ export const AdminRelayHeartbeat_CountersEntry: MessageFns<AdminRelayHeartbeat_C
   },
 };
 
-function createBaseResolveOrgDetailsRequest(): ResolveOrgDetailsRequest {
-  return { organizationIds: [] };
+function createBaseListAdminUsageGroupsRequest(): ListAdminUsageGroupsRequest {
+  return { startTime: undefined, endTime: undefined, groupBy: [], filter: undefined, sort: 0, page: 0, perPage: 0 };
 }
 
-export const ResolveOrgDetailsRequest: MessageFns<ResolveOrgDetailsRequest> = {
-  encode(message: ResolveOrgDetailsRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
-    for (const v of message.organizationIds) {
-      writer.uint32(10).string(v!);
+export const ListAdminUsageGroupsRequest: MessageFns<ListAdminUsageGroupsRequest> = {
+  encode(message: ListAdminUsageGroupsRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.startTime !== undefined) {
+      Timestamp.encode(toTimestamp(message.startTime), writer.uint32(10).fork()).join();
+    }
+    if (message.endTime !== undefined) {
+      Timestamp.encode(toTimestamp(message.endTime), writer.uint32(18).fork()).join();
+    }
+    for (const v of message.groupBy) {
+      writer.uint32(24).int32(v!);
+    }
+    if (message.filter !== undefined) {
+      AdminUsageGroupFilter.encode(message.filter, writer.uint32(34).fork()).join();
+    }
+    if (message.sort !== 0) {
+      writer.uint32(40).int32(message.sort);
+    }
+    if (message.page !== 0) {
+      writer.uint32(48).int32(message.page);
+    }
+    if (message.perPage !== 0) {
+      writer.uint32(56).int32(message.perPage);
     }
     return writer;
   },
 
-  decode(input: BinaryReader | Uint8Array, length?: number): ResolveOrgDetailsRequest {
+  decode(input: BinaryReader | Uint8Array, length?: number): ListAdminUsageGroupsRequest {
     const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
     const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
     if (previousRecursionDepth >= 100) {
@@ -3343,7 +3583,7 @@ export const ResolveOrgDetailsRequest: MessageFns<ResolveOrgDetailsRequest> = {
     (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
     try {
       const end = length === undefined ? reader.len : reader.pos + length;
-      const message = createBaseResolveOrgDetailsRequest();
+      const message = createBaseListAdminUsageGroupsRequest();
       while (reader.pos < end) {
         const tag = reader.uint32();
         switch (tag >>> 3) {
@@ -3352,7 +3592,65 @@ export const ResolveOrgDetailsRequest: MessageFns<ResolveOrgDetailsRequest> = {
               break;
             }
 
-            message.organizationIds.push(reader.string());
+            message.startTime = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.endTime = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 3: {
+            if (tag === 24) {
+              message.groupBy.push(reader.int32() as any);
+
+              continue;
+            }
+
+            if (tag === 26) {
+              const end2 = reader.uint32() + reader.pos;
+              while (reader.pos < end2) {
+                message.groupBy.push(reader.int32() as any);
+              }
+
+              continue;
+            }
+
+            break;
+          }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.filter = AdminUsageGroupFilter.decode(reader, reader.uint32());
+            continue;
+          }
+          case 5: {
+            if (tag !== 40) {
+              break;
+            }
+
+            message.sort = reader.int32() as any;
+            continue;
+          }
+          case 6: {
+            if (tag !== 48) {
+              break;
+            }
+
+            message.page = reader.int32();
+            continue;
+          }
+          case 7: {
+            if (tag !== 56) {
+              break;
+            }
+
+            message.perPage = reader.int32();
             continue;
           }
         }
@@ -3367,50 +3665,100 @@ export const ResolveOrgDetailsRequest: MessageFns<ResolveOrgDetailsRequest> = {
     }
   },
 
-  fromJSON(object: any): ResolveOrgDetailsRequest {
+  fromJSON(object: any): ListAdminUsageGroupsRequest {
     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))
+      startTime: isSet(object.startTime)
+        ? fromJsonTimestamp(object.startTime)
+        : isSet(object.start_time)
+        ? fromJsonTimestamp(object.start_time)
+        : undefined,
+      endTime: isSet(object.endTime)
+        ? fromJsonTimestamp(object.endTime)
+        : isSet(object.end_time)
+        ? fromJsonTimestamp(object.end_time)
+        : undefined,
+      groupBy: globalThis.Array.isArray(object?.groupBy)
+        ? object.groupBy.map((e: any) => adminUsageDimensionFromJSON(e))
+        : globalThis.Array.isArray(object?.group_by)
+        ? object.group_by.map((e: any) => adminUsageDimensionFromJSON(e))
         : [],
+      filter: isSet(object.filter) ? AdminUsageGroupFilter.fromJSON(object.filter) : undefined,
+      sort: isSet(object.sort) ? adminUsageGroupSortFromJSON(object.sort) : 0,
+      page: isSet(object.page) ? globalThis.Number(object.page) : 0,
+      perPage: isSet(object.perPage)
+        ? globalThis.Number(object.perPage)
+        : isSet(object.per_page)
+        ? globalThis.Number(object.per_page)
+        : 0,
     };
   },
 
-  toJSON(message: ResolveOrgDetailsRequest): unknown {
+  toJSON(message: ListAdminUsageGroupsRequest): unknown {
     const obj: any = {};
-    if (message.organizationIds?.length) {
-      obj.organizationIds = message.organizationIds;
+    if (message.startTime !== undefined) {
+      obj.startTime = message.startTime.toISOString();
+    }
+    if (message.endTime !== undefined) {
+      obj.endTime = message.endTime.toISOString();
+    }
+    if (message.groupBy?.length) {
+      obj.groupBy = message.groupBy.map((e) => adminUsageDimensionToJSON(e));
+    }
+    if (message.filter !== undefined) {
+      obj.filter = AdminUsageGroupFilter.toJSON(message.filter);
+    }
+    if (message.sort !== 0) {
+      obj.sort = adminUsageGroupSortToJSON(message.sort);
+    }
+    if (message.page !== 0) {
+      obj.page = Math.round(message.page);
+    }
+    if (message.perPage !== 0) {
+      obj.perPage = Math.round(message.perPage);
     }
     return obj;
   },
 
-  create<I extends Exact<DeepPartial<ResolveOrgDetailsRequest>, I>>(base?: I): ResolveOrgDetailsRequest {
-    return ResolveOrgDetailsRequest.fromPartial(base ?? ({} as any));
+  create<I extends Exact<DeepPartial<ListAdminUsageGroupsRequest>, I>>(base?: I): ListAdminUsageGroupsRequest {
+    return ListAdminUsageGroupsRequest.fromPartial(base ?? ({} as any));
   },
-  fromPartial<I extends Exact<DeepPartial<ResolveOrgDetailsRequest>, I>>(object: I): ResolveOrgDetailsRequest {
-    const message = createBaseResolveOrgDetailsRequest();
-    message.organizationIds = object.organizationIds?.map((e) => e) || [];
+  fromPartial<I extends Exact<DeepPartial<ListAdminUsageGroupsRequest>, I>>(object: I): ListAdminUsageGroupsRequest {
+    const message = createBaseListAdminUsageGroupsRequest();
+    message.startTime = object.startTime ?? undefined;
+    message.endTime = object.endTime ?? undefined;
+    message.groupBy = object.groupBy?.map((e) => e) || [];
+    message.filter = (object.filter !== undefined && object.filter !== null)
+      ? AdminUsageGroupFilter.fromPartial(object.filter)
+      : undefined;
+    message.sort = object.sort ?? 0;
+    message.page = object.page ?? 0;
+    message.perPage = object.perPage ?? 0;
     return message;
   },
 };
 
-function createBaseResolveOrgDetailsResponse(): ResolveOrgDetailsResponse {
-  return { status: undefined, organizations: [] };
+function createBaseListAdminUsageGroupsResponse(): ListAdminUsageGroupsResponse {
+  return { status: undefined, groups: [], pagination: undefined, refreshedAt: undefined };
 }
 
-export const ResolveOrgDetailsResponse: MessageFns<ResolveOrgDetailsResponse> = {
-  encode(message: ResolveOrgDetailsResponse, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+export const ListAdminUsageGroupsResponse: MessageFns<ListAdminUsageGroupsResponse> = {
+  encode(message: ListAdminUsageGroupsResponse, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
     if (message.status !== undefined) {
       ResponseStatus.encode(message.status, writer.uint32(10).fork()).join();
     }
-    for (const v of message.organizations) {
-      OrgDetails.encode(v!, writer.uint32(18).fork()).join();
+    for (const v of message.groups) {
+      AdminUsageGroup.encode(v!, writer.uint32(18).fork()).join();
+    }
+    if (message.pagination !== undefined) {
+      Pagination.encode(message.pagination, writer.uint32(26).fork()).join();
+    }
+    if (message.refreshedAt !== undefined) {
+      Timestamp.encode(toTimestamp(message.refreshedAt), writer.uint32(34).fork()).join();
     }
     return writer;
   },
 
-  decode(input: BinaryReader | Uint8Array, length?: number): ResolveOrgDetailsResponse {
+  decode(input: BinaryReader | Uint8Array, length?: number): ListAdminUsageGroupsResponse {
     const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
     const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
     if (previousRecursionDepth >= 100) {
@@ -3419,7 +3767,7 @@ export const ResolveOrgDetailsResponse: MessageFns<ResolveOrgDetailsResponse> =
     (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
     try {
       const end = length === undefined ? reader.len : reader.pos + length;
-      const message = createBaseResolveOrgDetailsResponse();
+      const message = createBaseListAdminUsageGroupsResponse();
       while (reader.pos < end) {
         const tag = reader.uint32();
         switch (tag >>> 3) {
@@ -3436,7 +3784,23 @@ export const ResolveOrgDetailsResponse: MessageFns<ResolveOrgDetailsResponse> =
               break;
             }
 
-            message.organizations.push(OrgDetails.decode(reader, reader.uint32()));
+            message.groups.push(AdminUsageGroup.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.pagination = Pagination.decode(reader, reader.uint32());
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.refreshedAt = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
             continue;
           }
         }
@@ -3451,55 +3815,71 @@ export const ResolveOrgDetailsResponse: MessageFns<ResolveOrgDetailsResponse> =
     }
   },
 
-  fromJSON(object: any): ResolveOrgDetailsResponse {
+  fromJSON(object: any): ListAdminUsageGroupsResponse {
     return {
       status: isSet(object.status) ? ResponseStatus.fromJSON(object.status) : undefined,
-      organizations: globalThis.Array.isArray(object?.organizations)
-        ? object.organizations.map((e: any) => OrgDetails.fromJSON(e))
+      groups: globalThis.Array.isArray(object?.groups)
+        ? object.groups.map((e: any) => AdminUsageGroup.fromJSON(e))
         : [],
+      pagination: isSet(object.pagination) ? Pagination.fromJSON(object.pagination) : undefined,
+      refreshedAt: isSet(object.refreshedAt)
+        ? fromJsonTimestamp(object.refreshedAt)
+        : isSet(object.refreshed_at)
+        ? fromJsonTimestamp(object.refreshed_at)
+        : undefined,
     };
   },
 
-  toJSON(message: ResolveOrgDetailsResponse): unknown {
+  toJSON(message: ListAdminUsageGroupsResponse): unknown {
     const obj: any = {};
     if (message.status !== undefined) {
       obj.status = ResponseStatus.toJSON(message.status);
     }
-    if (message.organizations?.length) {
-      obj.organizations = message.organizations.map((e) => OrgDetails.toJSON(e));
+    if (message.groups?.length) {
+      obj.groups = message.groups.map((e) => AdminUsageGroup.toJSON(e));
+    }
+    if (message.pagination !== undefined) {
+      obj.pagination = Pagination.toJSON(message.pagination);
+    }
+    if (message.refreshedAt !== undefined) {
+      obj.refreshedAt = message.refreshedAt.toISOString();
     }
     return obj;
   },
 
-  create<I extends Exact<DeepPartial<ResolveOrgDetailsResponse>, I>>(base?: I): ResolveOrgDetailsResponse {
-    return ResolveOrgDetailsResponse.fromPartial(base ?? ({} as any));
+  create<I extends Exact<DeepPartial<ListAdminUsageGroupsResponse>, I>>(base?: I): ListAdminUsageGroupsResponse {
+    return ListAdminUsageGroupsResponse.fromPartial(base ?? ({} as any));
   },
-  fromPartial<I extends Exact<DeepPartial<ResolveOrgDetailsResponse>, I>>(object: I): ResolveOrgDetailsResponse {
-    const message = createBaseResolveOrgDetailsResponse();
+  fromPartial<I extends Exact<DeepPartial<ListAdminUsageGroupsResponse>, I>>(object: I): ListAdminUsageGroupsResponse {
+    const message = createBaseListAdminUsageGroupsResponse();
     message.status = (object.status !== undefined && object.status !== null)
       ? ResponseStatus.fromPartial(object.status)
       : undefined;
-    message.organizations = object.organizations?.map((e) => OrgDetails.fromPartial(e)) || [];
+    message.groups = object.groups?.map((e) => AdminUsageGroup.fromPartial(e)) || [];
+    message.pagination = (object.pagination !== undefined && object.pagination !== null)
+      ? Pagination.fromPartial(object.pagination)
+      : undefined;
+    message.refreshedAt = object.refreshedAt ?? undefined;
     return message;
   },
 };
 
-function createBaseOrgDetails(): OrgDetails {
-  return { organizationId: "", name: "" };
+function createBaseAdminUsageGroupFilter(): AdminUsageGroupFilter {
+  return { organizationIds: [], userIds: [] };
 }
 
-export const OrgDetails: MessageFns<OrgDetails> = {
-  encode(message: OrgDetails, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
-    if (message.organizationId !== "") {
-      writer.uint32(10).string(message.organizationId);
+export const AdminUsageGroupFilter: MessageFns<AdminUsageGroupFilter> = {
+  encode(message: AdminUsageGroupFilter, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    for (const v of message.organizationIds) {
+      writer.uint32(10).string(v!);
     }
-    if (message.name !== "") {
-      writer.uint32(18).string(message.name);
+    for (const v of message.userIds) {
+      writer.uint32(18).string(v!);
     }
     return writer;
   },
 
-  decode(input: BinaryReader | Uint8Array, length?: number): OrgDetails {
+  decode(input: BinaryReader | Uint8Array, length?: number): AdminUsageGroupFilter {
     const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
     const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
     if (previousRecursionDepth >= 100) {
@@ -3508,7 +3888,7 @@ export const OrgDetails: MessageFns<OrgDetails> = {
     (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
     try {
       const end = length === undefined ? reader.len : reader.pos + length;
-      const message = createBaseOrgDetails();
+      const message = createBaseAdminUsageGroupFilter();
       while (reader.pos < end) {
         const tag = reader.uint32();
         switch (tag >>> 3) {
@@ -3517,7 +3897,7 @@ export const OrgDetails: MessageFns<OrgDetails> = {
               break;
             }
 
-            message.organizationId = reader.string();
+            message.organizationIds.push(reader.string());
             continue;
           }
           case 2: {
@@ -3525,7 +3905,7 @@ export const OrgDetails: MessageFns<OrgDetails> = {
               break;
             }
 
-            message.name = reader.string();
+            message.userIds.push(reader.string());
             continue;
           }
         }
@@ -3540,52 +3920,122 @@ export const OrgDetails: MessageFns<OrgDetails> = {
     }
   },
 
-  fromJSON(object: any): OrgDetails {
+  fromJSON(object: any): AdminUsageGroupFilter {
     return {
-      organizationId: isSet(object.organizationId)
-        ? globalThis.String(object.organizationId)
-        : isSet(object.organization_id)
-        ? globalThis.String(object.organization_id)
-        : "",
-      name: isSet(object.name) ? globalThis.String(object.name) : "",
+      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))
+        : [],
+      userIds: globalThis.Array.isArray(object?.userIds)
+        ? object.userIds.map((e: any) => globalThis.String(e))
+        : globalThis.Array.isArray(object?.user_ids)
+        ? object.user_ids.map((e: any) => globalThis.String(e))
+        : [],
     };
   },
 
-  toJSON(message: OrgDetails): unknown {
+  toJSON(message: AdminUsageGroupFilter): unknown {
     const obj: any = {};
-    if (message.organizationId !== "") {
-      obj.organizationId = message.organizationId;
+    if (message.organizationIds?.length) {
+      obj.organizationIds = message.organizationIds;
     }
-    if (message.name !== "") {
-      obj.name = message.name;
+    if (message.userIds?.length) {
+      obj.userIds = message.userIds;
     }
     return obj;
   },
 
-  create<I extends Exact<DeepPartial<OrgDetails>, I>>(base?: I): OrgDetails {
-    return OrgDetails.fromPartial(base ?? ({} as any));
+  create<I extends Exact<DeepPartial<AdminUsageGroupFilter>, I>>(base?: I): AdminUsageGroupFilter {
+    return AdminUsageGroupFilter.fromPartial(base ?? ({} as any));
   },
-  fromPartial<I extends Exact<DeepPartial<OrgDetails>, I>>(object: I): OrgDetails {
-    const message = createBaseOrgDetails();
-    message.organizationId = object.organizationId ?? "";
-    message.name = object.name ?? "";
+  fromPartial<I extends Exact<DeepPartial<AdminUsageGroupFilter>, I>>(object: I): AdminUsageGroupFilter {
+    const message = createBaseAdminUsageGroupFilter();
+    message.organizationIds = object.organizationIds?.map((e) => e) || [];
+    message.userIds = object.userIds?.map((e) => e) || [];
     return message;
   },
 };
 
-function createBaseResolveProjectDetailsRequest(): ResolveProjectDetailsRequest {
-  return { projectIds: [] };
+function createBaseAdminUsageGroup(): AdminUsageGroup {
+  return {
+    organizationId: "",
+    principalKind: 0,
+    principalId: "",
+    sourceSystem: "",
+    model: "",
+    day: undefined,
+    inputTokens: 0,
+    outputTokens: 0,
+    cacheReadTokens: 0,
+    cacheWriteTokens: 0,
+    costUsd: 0,
+    subscriptionCostUsd: 0,
+    modelCalls: 0,
+    toolCalls: 0,
+    userMessages: 0,
+    sessions: 0,
+    userIdCount: 0,
+  };
 }
 
-export const ResolveProjectDetailsRequest: MessageFns<ResolveProjectDetailsRequest> = {
-  encode(message: ResolveProjectDetailsRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
-    for (const v of message.projectIds) {
-      writer.uint32(10).string(v!);
+export const AdminUsageGroup: MessageFns<AdminUsageGroup> = {
+  encode(message: AdminUsageGroup, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.organizationId !== "") {
+      writer.uint32(10).string(message.organizationId);
+    }
+    if (message.principalKind !== 0) {
+      writer.uint32(16).int32(message.principalKind);
+    }
+    if (message.principalId !== "") {
+      writer.uint32(26).string(message.principalId);
+    }
+    if (message.sourceSystem !== "") {
+      writer.uint32(34).string(message.sourceSystem);
+    }
+    if (message.model !== "") {
+      writer.uint32(42).string(message.model);
+    }
+    if (message.day !== undefined) {
+      Timestamp.encode(toTimestamp(message.day), writer.uint32(50).fork()).join();
+    }
+    if (message.inputTokens !== 0) {
+      writer.uint32(56).uint64(message.inputTokens);
+    }
+    if (message.outputTokens !== 0) {
+      writer.uint32(64).uint64(message.outputTokens);
+    }
+    if (message.cacheReadTokens !== 0) {
+      writer.uint32(72).uint64(message.cacheReadTokens);
+    }
+    if (message.cacheWriteTokens !== 0) {
+      writer.uint32(80).uint64(message.cacheWriteTokens);
+    }
+    if (message.costUsd !== 0) {
+      writer.uint32(89).double(message.costUsd);
+    }
+    if (message.subscriptionCostUsd !== 0) {
+      writer.uint32(97).double(message.subscriptionCostUsd);
+    }
+    if (message.modelCalls !== 0) {
+      writer.uint32(104).uint64(message.modelCalls);
+    }
+    if (message.toolCalls !== 0) {
+      writer.uint32(112).uint64(message.toolCalls);
+    }
+    if (message.userMessages !== 0) {
+      writer.uint32(120).uint64(message.userMessages);
+    }
+    if (message.sessions !== 0) {
+      writer.uint32(128).uint64(message.sessions);
+    }
+    if (message.userIdCount !== 0) {
+      writer.uint32(136).uint64(message.userIdCount);
     }
     return writer;
   },
 
-  decode(input: BinaryReader | Uint8Array, length?: number): ResolveProjectDetailsRequest {
+  decode(input: BinaryReader | Uint8Array, length?: number): AdminUsageGroup {
     const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
     const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
     if (previousRecursionDepth >= 100) {
@@ -3594,7 +4044,7 @@ export const ResolveProjectDetailsRequest: MessageFns<ResolveProjectDetailsReque
     (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
     try {
       const end = length === undefined ? reader.len : reader.pos + length;
-      const message = createBaseResolveProjectDetailsRequest();
+      const message = createBaseAdminUsageGroup();
       while (reader.pos < end) {
         const tag = reader.uint32();
         switch (tag >>> 3) {
@@ -3603,14 +4053,598 @@ export const ResolveProjectDetailsRequest: MessageFns<ResolveProjectDetailsReque
               break;
             }
 
-            message.projectIds.push(reader.string());
+            message.organizationId = reader.string();
             continue;
           }
-        }
-        if ((tag & 7) === 4 || tag === 0) {
-          break;
-        }
-        reader.skip(tag & 7);
+          case 2: {
+            if (tag !== 16) {
+              break;
+            }
+
+            message.principalKind = reader.int32() as any;
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.principalId = reader.string();
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.sourceSystem = reader.string();
+            continue;
+          }
+          case 5: {
+            if (tag !== 42) {
+              break;
+            }
+
+            message.model = reader.string();
+            continue;
+          }
+          case 6: {
+            if (tag !== 50) {
+              break;
+            }
+
+            message.day = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 7: {
+            if (tag !== 56) {
+              break;
+            }
+
+            message.inputTokens = longToNumber(reader.uint64());
+            continue;
+          }
+          case 8: {
+            if (tag !== 64) {
+              break;
+            }
+
+            message.outputTokens = longToNumber(reader.uint64());
+            continue;
+          }
+          case 9: {
+            if (tag !== 72) {
+              break;
+            }
+
+            message.cacheReadTokens = longToNumber(reader.uint64());
+            continue;
+          }
+          case 10: {
+            if (tag !== 80) {
+              break;
+            }
+
+            message.cacheWriteTokens = longToNumber(reader.uint64());
+            continue;
+          }
+          case 11: {
+            if (tag !== 89) {
+              break;
+            }
+
+            message.costUsd = reader.double();
+            continue;
+          }
+          case 12: {
+            if (tag !== 97) {
+              break;
+            }
+
+            message.subscriptionCostUsd = reader.double();
+            continue;
+          }
+          case 13: {
+            if (tag !== 104) {
+              break;
+            }
+
+            message.modelCalls = longToNumber(reader.uint64());
+            continue;
+          }
+          case 14: {
+            if (tag !== 112) {
+              break;
+            }
+
+            message.toolCalls = longToNumber(reader.uint64());
+            continue;
+          }
+          case 15: {
+            if (tag !== 120) {
+              break;
+            }
+
+            message.userMessages = longToNumber(reader.uint64());
+            continue;
+          }
+          case 16: {
+            if (tag !== 128) {
+              break;
+            }
+
+            message.sessions = longToNumber(reader.uint64());
+            continue;
+          }
+          case 17: {
+            if (tag !== 136) {
+              break;
+            }
+
+            message.userIdCount = 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): AdminUsageGroup {
+    return {
+      organizationId: isSet(object.organizationId)
+        ? globalThis.String(object.organizationId)
+        : isSet(object.organization_id)
+        ? globalThis.String(object.organization_id)
+        : "",
+      principalKind: isSet(object.principalKind)
+        ? aIPrincipalKindFromJSON(object.principalKind)
+        : isSet(object.principal_kind)
+        ? aIPrincipalKindFromJSON(object.principal_kind)
+        : 0,
+      principalId: isSet(object.principalId)
+        ? globalThis.String(object.principalId)
+        : isSet(object.principal_id)
+        ? globalThis.String(object.principal_id)
+        : "",
+      sourceSystem: isSet(object.sourceSystem)
+        ? globalThis.String(object.sourceSystem)
+        : isSet(object.source_system)
+        ? globalThis.String(object.source_system)
+        : "",
+      model: isSet(object.model) ? globalThis.String(object.model) : "",
+      day: isSet(object.day) ? fromJsonTimestamp(object.day) : undefined,
+      inputTokens: isSet(object.inputTokens)
+        ? globalThis.Number(object.inputTokens)
+        : isSet(object.input_tokens)
+        ? globalThis.Number(object.input_tokens)
+        : 0,
+      outputTokens: isSet(object.outputTokens)
+        ? globalThis.Number(object.outputTokens)
+        : isSet(object.output_tokens)
+        ? globalThis.Number(object.output_tokens)
+        : 0,
+      cacheReadTokens: isSet(object.cacheReadTokens)
+        ? globalThis.Number(object.cacheReadTokens)
+        : isSet(object.cache_read_tokens)
+        ? globalThis.Number(object.cache_read_tokens)
+        : 0,
+      cacheWriteTokens: isSet(object.cacheWriteTokens)
+        ? globalThis.Number(object.cacheWriteTokens)
+        : isSet(object.cache_write_tokens)
+        ? globalThis.Number(object.cache_write_tokens)
+        : 0,
+      costUsd: isSet(object.costUsd)
+        ? globalThis.Number(object.costUsd)
+        : isSet(object.cost_usd)
+        ? globalThis.Number(object.cost_usd)
+        : 0,
+      subscriptionCostUsd: isSet(object.subscriptionCostUsd)
+        ? globalThis.Number(object.subscriptionCostUsd)
+        : isSet(object.subscription_cost_usd)
+        ? globalThis.Number(object.subscription_cost_usd)
+        : 0,
+      modelCalls: isSet(object.modelCalls)
+        ? globalThis.Number(object.modelCalls)
+        : isSet(object.model_calls)
+        ? globalThis.Number(object.model_calls)
+        : 0,
+      toolCalls: isSet(object.toolCalls)
+        ? globalThis.Number(object.toolCalls)
+        : isSet(object.tool_calls)
+        ? globalThis.Number(object.tool_calls)
+        : 0,
+      userMessages: isSet(object.userMessages)
+        ? globalThis.Number(object.userMessages)
+        : isSet(object.user_messages)
+        ? globalThis.Number(object.user_messages)
+        : 0,
+      sessions: isSet(object.sessions) ? globalThis.Number(object.sessions) : 0,
+      userIdCount: isSet(object.userIdCount)
+        ? globalThis.Number(object.userIdCount)
+        : isSet(object.user_id_count)
+        ? globalThis.Number(object.user_id_count)
+        : 0,
+    };
+  },
+
+  toJSON(message: AdminUsageGroup): unknown {
+    const obj: any = {};
+    if (message.organizationId !== "") {
+      obj.organizationId = message.organizationId;
+    }
+    if (message.principalKind !== 0) {
+      obj.principalKind = aIPrincipalKindToJSON(message.principalKind);
+    }
+    if (message.principalId !== "") {
+      obj.principalId = message.principalId;
+    }
+    if (message.sourceSystem !== "") {
+      obj.sourceSystem = message.sourceSystem;
+    }
+    if (message.model !== "") {
+      obj.model = message.model;
+    }
+    if (message.day !== undefined) {
+      obj.day = message.day.toISOString();
+    }
+    if (message.inputTokens !== 0) {
+      obj.inputTokens = Math.round(message.inputTokens);
+    }
+    if (message.outputTokens !== 0) {
+      obj.outputTokens = Math.round(message.outputTokens);
+    }
+    if (message.cacheReadTokens !== 0) {
+      obj.cacheReadTokens = Math.round(message.cacheReadTokens);
+    }
+    if (message.cacheWriteTokens !== 0) {
+      obj.cacheWriteTokens = Math.round(message.cacheWriteTokens);
+    }
+    if (message.costUsd !== 0) {
+      obj.costUsd = floatToJson(message.costUsd);
+    }
+    if (message.subscriptionCostUsd !== 0) {
+      obj.subscriptionCostUsd = floatToJson(message.subscriptionCostUsd);
+    }
+    if (message.modelCalls !== 0) {
+      obj.modelCalls = Math.round(message.modelCalls);
+    }
+    if (message.toolCalls !== 0) {
+      obj.toolCalls = Math.round(message.toolCalls);
+    }
+    if (message.userMessages !== 0) {
+      obj.userMessages = Math.round(message.userMessages);
+    }
+    if (message.sessions !== 0) {
+      obj.sessions = Math.round(message.sessions);
+    }
+    if (message.userIdCount !== 0) {
+      obj.userIdCount = Math.round(message.userIdCount);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<AdminUsageGroup>, I>>(base?: I): AdminUsageGroup {
+    return AdminUsageGroup.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<AdminUsageGroup>, I>>(object: I): AdminUsageGroup {
+    const message = createBaseAdminUsageGroup();
+    message.organizationId = object.organizationId ?? "";
+    message.principalKind = object.principalKind ?? 0;
+    message.principalId = object.principalId ?? "";
+    message.sourceSystem = object.sourceSystem ?? "";
+    message.model = object.model ?? "";
+    message.day = object.day ?? undefined;
+    message.inputTokens = object.inputTokens ?? 0;
+    message.outputTokens = object.outputTokens ?? 0;
+    message.cacheReadTokens = object.cacheReadTokens ?? 0;
+    message.cacheWriteTokens = object.cacheWriteTokens ?? 0;
+    message.costUsd = object.costUsd ?? 0;
+    message.subscriptionCostUsd = object.subscriptionCostUsd ?? 0;
+    message.modelCalls = object.modelCalls ?? 0;
+    message.toolCalls = object.toolCalls ?? 0;
+    message.userMessages = object.userMessages ?? 0;
+    message.sessions = object.sessions ?? 0;
+    message.userIdCount = object.userIdCount ?? 0;
+    return message;
+  },
+};
+
+function createBaseResolveOrgDetailsRequest(): ResolveOrgDetailsRequest {
+  return { organizationIds: [] };
+}
+
+export const ResolveOrgDetailsRequest: MessageFns<ResolveOrgDetailsRequest> = {
+  encode(message: ResolveOrgDetailsRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    for (const v of message.organizationIds) {
+      writer.uint32(10).string(v!);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ResolveOrgDetailsRequest {
+    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 = createBaseResolveOrgDetailsRequest();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.organizationIds.push(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): ResolveOrgDetailsRequest {
+    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))
+        : [],
+    };
+  },
+
+  toJSON(message: ResolveOrgDetailsRequest): unknown {
+    const obj: any = {};
+    if (message.organizationIds?.length) {
+      obj.organizationIds = message.organizationIds;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<ResolveOrgDetailsRequest>, I>>(base?: I): ResolveOrgDetailsRequest {
+    return ResolveOrgDetailsRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ResolveOrgDetailsRequest>, I>>(object: I): ResolveOrgDetailsRequest {
+    const message = createBaseResolveOrgDetailsRequest();
+    message.organizationIds = object.organizationIds?.map((e) => e) || [];
+    return message;
+  },
+};
+
+function createBaseResolveOrgDetailsResponse(): ResolveOrgDetailsResponse {
+  return { status: undefined, organizations: [] };
+}
+
+export const ResolveOrgDetailsResponse: MessageFns<ResolveOrgDetailsResponse> = {
+  encode(message: ResolveOrgDetailsResponse, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.status !== undefined) {
+      ResponseStatus.encode(message.status, writer.uint32(10).fork()).join();
+    }
+    for (const v of message.organizations) {
+      OrgDetails.encode(v!, writer.uint32(18).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ResolveOrgDetailsResponse {
+    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 = createBaseResolveOrgDetailsResponse();
+      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.organizations.push(OrgDetails.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): ResolveOrgDetailsResponse {
+    return {
+      status: isSet(object.status) ? ResponseStatus.fromJSON(object.status) : undefined,
+      organizations: globalThis.Array.isArray(object?.organizations)
+        ? object.organizations.map((e: any) => OrgDetails.fromJSON(e))
+        : [],
+    };
+  },
+
+  toJSON(message: ResolveOrgDetailsResponse): unknown {
+    const obj: any = {};
+    if (message.status !== undefined) {
+      obj.status = ResponseStatus.toJSON(message.status);
+    }
+    if (message.organizations?.length) {
+      obj.organizations = message.organizations.map((e) => OrgDetails.toJSON(e));
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<ResolveOrgDetailsResponse>, I>>(base?: I): ResolveOrgDetailsResponse {
+    return ResolveOrgDetailsResponse.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ResolveOrgDetailsResponse>, I>>(object: I): ResolveOrgDetailsResponse {
+    const message = createBaseResolveOrgDetailsResponse();
+    message.status = (object.status !== undefined && object.status !== null)
+      ? ResponseStatus.fromPartial(object.status)
+      : undefined;
+    message.organizations = object.organizations?.map((e) => OrgDetails.fromPartial(e)) || [];
+    return message;
+  },
+};
+
+function createBaseOrgDetails(): OrgDetails {
+  return { organizationId: "", name: "" };
+}
+
+export const OrgDetails: MessageFns<OrgDetails> = {
+  encode(message: OrgDetails, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.organizationId !== "") {
+      writer.uint32(10).string(message.organizationId);
+    }
+    if (message.name !== "") {
+      writer.uint32(18).string(message.name);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): OrgDetails {
+    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 = createBaseOrgDetails();
+      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.name = 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): OrgDetails {
+    return {
+      organizationId: isSet(object.organizationId)
+        ? globalThis.String(object.organizationId)
+        : isSet(object.organization_id)
+        ? globalThis.String(object.organization_id)
+        : "",
+      name: isSet(object.name) ? globalThis.String(object.name) : "",
+    };
+  },
+
+  toJSON(message: OrgDetails): unknown {
+    const obj: any = {};
+    if (message.organizationId !== "") {
+      obj.organizationId = message.organizationId;
+    }
+    if (message.name !== "") {
+      obj.name = message.name;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<OrgDetails>, I>>(base?: I): OrgDetails {
+    return OrgDetails.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<OrgDetails>, I>>(object: I): OrgDetails {
+    const message = createBaseOrgDetails();
+    message.organizationId = object.organizationId ?? "";
+    message.name = object.name ?? "";
+    return message;
+  },
+};
+
+function createBaseResolveProjectDetailsRequest(): ResolveProjectDetailsRequest {
+  return { projectIds: [] };
+}
+
+export const ResolveProjectDetailsRequest: MessageFns<ResolveProjectDetailsRequest> = {
+  encode(message: ResolveProjectDetailsRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    for (const v of message.projectIds) {
+      writer.uint32(10).string(v!);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ResolveProjectDetailsRequest {
+    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 = createBaseResolveProjectDetailsRequest();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.projectIds.push(reader.string());
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
       }
       return message;
     } finally {
@@ -4155,6 +5189,11 @@ export interface AdminGatewayService {
     request: ListAdminRelayHeartbeatsRequest,
     metadata?: Metadata,
   ): Promise<ListAdminRelayHeartbeatsResponse>;
+  /**
+   * AI usage summed across every organization over whole UTC days, grouped by the dimensions asked for (none is one
+   * row, the totals), numbered pages; it proxies ai.api.v1.AIAdminService.ListUsageGroups. Rows carry ids, not names.
+   */
+  ListUsageGroups(request: ListAdminUsageGroupsRequest, metadata?: Metadata): Promise<ListAdminUsageGroupsResponse>;
   /**
    * ResolveOrgDetails resolves organization ids to their names, in batch, across every organization of this gateway's
    * product. Unknown ids, and ids of another product, are left out; it never errors on them. A malformed id, or more
@@ -4199,6 +5238,7 @@ export class AdminGatewayServiceClientImpl implements AdminGatewayService {
     this.ConfirmAIEfforts = this.ConfirmAIEfforts.bind(this);
     this.ConfirmAIBillers = this.ConfirmAIBillers.bind(this);
     this.ListRelayHeartbeats = this.ListRelayHeartbeats.bind(this);
+    this.ListUsageGroups = this.ListUsageGroups.bind(this);
     this.ResolveOrgDetails = this.ResolveOrgDetails.bind(this);
     this.ResolveProjectDetails = this.ResolveProjectDetails.bind(this);
     this.ResolveUserDetails = this.ResolveUserDetails.bind(this);
@@ -4284,6 +5324,12 @@ export class AdminGatewayServiceClientImpl implements AdminGatewayService {
     return promise.then((data) => ListAdminRelayHeartbeatsResponse.decode(new BinaryReader(data)));
   }
 
+  ListUsageGroups(request: ListAdminUsageGroupsRequest, metadata?: Metadata): Promise<ListAdminUsageGroupsResponse> {
+    const data = ListAdminUsageGroupsRequest.encode(request).finish();
+    const promise = this.rpc.request(this.service, "ListUsageGroups", data, metadata);
+    return promise.then((data) => ListAdminUsageGroupsResponse.decode(new BinaryReader(data)));
+  }
+
   ResolveOrgDetails(request: ResolveOrgDetailsRequest, metadata?: Metadata): Promise<ResolveOrgDetailsResponse> {
     const data = ResolveOrgDetailsRequest.encode(request).finish();
     const promise = this.rpc.request(this.service, "ResolveOrgDetails", data, metadata);
@@ -4310,6 +5356,10 @@ interface Rpc {
   request(service: string, method: string, data: Uint8Array, metadata?: Metadata): Promise<Uint8Array>;
 }
 
+function floatToJson(value: number | null | undefined): number | string | null | undefined {
+  return typeof value === "number" && !globalThis.Number.isFinite(value) ? globalThis.String(value) : value;
+}
+
 type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
 
 export type DeepPartial<T> = T extends Builtin ? T