@miradorlabs/web-grpc 3.18.0 → 3.20.0

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

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.12.4
+//   protoc-gen-ts_proto  v2.13.0
 //   protoc               v3.21.12
 // source: proto/gateway/web/v1/reference_gateway.proto
 
@@ -9,6 +9,7 @@ import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
 import type { Metadata } from "@grpc/grpc-js";
 import { Timestamp } from "../../../../google/protobuf/timestamp";
 import { ResponseStatus } from "../../common/v1/status";
+import { Pagination } from "./trace_gateway";
 
 export const protobufPackage = "gateway.web.v1";
 
@@ -58,6 +59,90 @@ export function aIReferenceNameScopeToJSON(object: AIReferenceNameScope): string
   }
 }
 
+/** AIReferenceGroupStatus mirrors telemetry.api.v1.AIReferenceGroupStatus. Unspecified does not filter. */
+export enum AIReferenceGroupStatus {
+  AI_REFERENCE_GROUP_STATUS_UNSPECIFIED = 0,
+  /** AI_REFERENCE_GROUP_STATUS_UNREVIEWED - A stored name in the group awaits review (unreviewed_names is not empty). */
+  AI_REFERENCE_GROUP_STATUS_UNREVIEWED = 1,
+  /** AI_REFERENCE_GROUP_STATUS_REVIEWED - No stored name in the group awaits review. */
+  AI_REFERENCE_GROUP_STATUS_REVIEWED = 2,
+  UNRECOGNIZED = -1,
+}
+
+export function aIReferenceGroupStatusFromJSON(object: any): AIReferenceGroupStatus {
+  switch (object) {
+    case 0:
+    case "AI_REFERENCE_GROUP_STATUS_UNSPECIFIED":
+      return AIReferenceGroupStatus.AI_REFERENCE_GROUP_STATUS_UNSPECIFIED;
+    case 1:
+    case "AI_REFERENCE_GROUP_STATUS_UNREVIEWED":
+      return AIReferenceGroupStatus.AI_REFERENCE_GROUP_STATUS_UNREVIEWED;
+    case 2:
+    case "AI_REFERENCE_GROUP_STATUS_REVIEWED":
+      return AIReferenceGroupStatus.AI_REFERENCE_GROUP_STATUS_REVIEWED;
+    case -1:
+    case "UNRECOGNIZED":
+    default:
+      return AIReferenceGroupStatus.UNRECOGNIZED;
+  }
+}
+
+export function aIReferenceGroupStatusToJSON(object: AIReferenceGroupStatus): string {
+  switch (object) {
+    case AIReferenceGroupStatus.AI_REFERENCE_GROUP_STATUS_UNSPECIFIED:
+      return "AI_REFERENCE_GROUP_STATUS_UNSPECIFIED";
+    case AIReferenceGroupStatus.AI_REFERENCE_GROUP_STATUS_UNREVIEWED:
+      return "AI_REFERENCE_GROUP_STATUS_UNREVIEWED";
+    case AIReferenceGroupStatus.AI_REFERENCE_GROUP_STATUS_REVIEWED:
+      return "AI_REFERENCE_GROUP_STATUS_REVIEWED";
+    case AIReferenceGroupStatus.UNRECOGNIZED:
+    default:
+      return "UNRECOGNIZED";
+  }
+}
+
+/** AIReferenceGroupObservation mirrors telemetry.api.v1.AIReferenceGroupObservation. Unspecified does not filter. */
+export enum AIReferenceGroupObservation {
+  AI_REFERENCE_GROUP_OBSERVATION_UNSPECIFIED = 0,
+  /** AI_REFERENCE_GROUP_OBSERVATION_OBSERVED - An organization of the request's organization_ids reported a name in the group. */
+  AI_REFERENCE_GROUP_OBSERVATION_OBSERVED = 1,
+  /** AI_REFERENCE_GROUP_OBSERVATION_UNOBSERVED - Only the registry holds the group's names (a price catalog's spelling, another organization's name). */
+  AI_REFERENCE_GROUP_OBSERVATION_UNOBSERVED = 2,
+  UNRECOGNIZED = -1,
+}
+
+export function aIReferenceGroupObservationFromJSON(object: any): AIReferenceGroupObservation {
+  switch (object) {
+    case 0:
+    case "AI_REFERENCE_GROUP_OBSERVATION_UNSPECIFIED":
+      return AIReferenceGroupObservation.AI_REFERENCE_GROUP_OBSERVATION_UNSPECIFIED;
+    case 1:
+    case "AI_REFERENCE_GROUP_OBSERVATION_OBSERVED":
+      return AIReferenceGroupObservation.AI_REFERENCE_GROUP_OBSERVATION_OBSERVED;
+    case 2:
+    case "AI_REFERENCE_GROUP_OBSERVATION_UNOBSERVED":
+      return AIReferenceGroupObservation.AI_REFERENCE_GROUP_OBSERVATION_UNOBSERVED;
+    case -1:
+    case "UNRECOGNIZED":
+    default:
+      return AIReferenceGroupObservation.UNRECOGNIZED;
+  }
+}
+
+export function aIReferenceGroupObservationToJSON(object: AIReferenceGroupObservation): string {
+  switch (object) {
+    case AIReferenceGroupObservation.AI_REFERENCE_GROUP_OBSERVATION_UNSPECIFIED:
+      return "AI_REFERENCE_GROUP_OBSERVATION_UNSPECIFIED";
+    case AIReferenceGroupObservation.AI_REFERENCE_GROUP_OBSERVATION_OBSERVED:
+      return "AI_REFERENCE_GROUP_OBSERVATION_OBSERVED";
+    case AIReferenceGroupObservation.AI_REFERENCE_GROUP_OBSERVATION_UNOBSERVED:
+      return "AI_REFERENCE_GROUP_OBSERVATION_UNOBSERVED";
+    case AIReferenceGroupObservation.UNRECOGNIZED:
+    default:
+      return "UNRECOGNIZED";
+  }
+}
+
 /** AIReferenceNameOrigin mirrors telemetry.api.v1.AIReferenceNameOrigin. */
 export enum AIReferenceNameOrigin {
   AI_REFERENCE_NAME_ORIGIN_UNSPECIFIED = 0,
@@ -249,6 +334,156 @@ export interface ListAIBillersResponse {
   billers: AIReferenceName[];
 }
 
+export interface ListAIProviderGroupsRequest {
+  /**
+   * The caller's organizations of this product whose telemetry counts as observed; the gateway resolves the
+   * caller's membership of each, and any other id fails the request.
+   */
+  organizationIds: string[];
+  filter:
+    | AIReferenceGroupFilter
+    | undefined;
+  /** 1-indexed; below 1 = 1. A page past the last returns the last page: read pagination.page. */
+  page: number;
+  /** 1-1000; 0 = 50. */
+  perPage: number;
+}
+
+export interface ListAIProviderGroupsResponse {
+  status: ResponseStatus | undefined;
+  groups: AIReferenceGroup[];
+  /** total_count is the groups the filter keeps, exact, computed on every request; anchor_timestamp is unset. */
+  pagination: Pagination | undefined;
+  counts: AIReferenceGroupCounts | undefined;
+}
+
+export interface ListAIModelGroupsRequest {
+  /**
+   * The caller's organizations of this product whose telemetry counts as observed; the gateway resolves the
+   * caller's membership of each, and any other id fails the request.
+   */
+  organizationIds: string[];
+  filter:
+    | AIReferenceGroupFilter
+    | undefined;
+  /** 1-indexed; below 1 = 1. A page past the last returns the last page: read pagination.page. */
+  page: number;
+  /** 1-1000; 0 = 50. */
+  perPage: number;
+}
+
+export interface ListAIModelGroupsResponse {
+  status: ResponseStatus | undefined;
+  groups: AIReferenceGroup[];
+  /** total_count is the groups the filter keeps, exact, computed on every request; anchor_timestamp is unset. */
+  pagination: Pagination | undefined;
+  counts: AIReferenceGroupCounts | undefined;
+}
+
+export interface ListAIEffortGroupsRequest {
+  /**
+   * The caller's organizations of this product whose telemetry counts as observed; the gateway resolves the
+   * caller's membership of each, and any other id fails the request.
+   */
+  organizationIds: string[];
+  filter:
+    | AIReferenceGroupFilter
+    | undefined;
+  /** 1-indexed; below 1 = 1. A page past the last returns the last page: read pagination.page. */
+  page: number;
+  /** 1-1000; 0 = 50. */
+  perPage: number;
+}
+
+export interface ListAIEffortGroupsResponse {
+  status: ResponseStatus | undefined;
+  groups: AIReferenceGroup[];
+  /** total_count is the groups the filter keeps, exact, computed on every request; anchor_timestamp is unset. */
+  pagination: Pagination | undefined;
+  counts: AIReferenceGroupCounts | undefined;
+}
+
+export interface ListAIBillerGroupsRequest {
+  /**
+   * The caller's organizations of this product whose telemetry counts as observed; the gateway resolves the
+   * caller's membership of each, and any other id fails the request.
+   */
+  organizationIds: string[];
+  filter:
+    | AIReferenceGroupFilter
+    | undefined;
+  /** 1-indexed; below 1 = 1. A page past the last returns the last page: read pagination.page. */
+  page: number;
+  /** 1-1000; 0 = 50. */
+  perPage: number;
+}
+
+export interface ListAIBillerGroupsResponse {
+  status: ResponseStatus | undefined;
+  groups: AIReferenceGroup[];
+  /** total_count is the groups the filter keeps, exact, computed on every request; anchor_timestamp is unset. */
+  pagination: Pagination | undefined;
+  counts: AIReferenceGroupCounts | undefined;
+}
+
+/**
+ * AIReferenceGroupFilter mirrors telemetry.api.v1.AIReferenceGroupFilter. Set fields AND; an unset field does
+ * not filter. Each field matches the group as a whole.
+ */
+export interface AIReferenceGroupFilter {
+  /** Case-insensitive substring (trimmed) of the group's display name or any of its stored names. */
+  search: string;
+  status: AIReferenceGroupStatus;
+  observation: AIReferenceGroupObservation;
+  /** Exact source ("claude", "price:litellm"): keeps the groups holding a name it reported. */
+  sourceSystem: string;
+}
+
+/** AIReferenceGroup mirrors telemetry.api.v1.AIReferenceGroup: one row of a reference table. */
+export interface AIReferenceGroup {
+  displayName: string;
+  /** Sorted by name (byte order); the empty effort first. */
+  names: AIReferenceName[];
+  /** Every source that reported a name in the group, sorted (byte order). */
+  sourceSystems: string[];
+  /**
+   * Staff set at least one of the names (origin MANUAL). Independent of status: a group with a confirmed name
+   * still awaits review while unreviewed_names is not empty.
+   */
+  confirmed: boolean;
+  /** The stored names awaiting review (origin not MANUAL; never the empty effort), sorted (byte order). */
+  unreviewedNames: string[];
+  /** An organization of the request's organization_ids reported a name in the group. */
+  observed: boolean;
+}
+
+/**
+ * AIReferenceGroupCounts mirrors telemetry.api.v1.AIReferenceGroupCounts. Every count is exact, computed on
+ * every request.
+ */
+export interface AIReferenceGroupCounts {
+  /** The whole table, unfiltered. */
+  totalNameCount: number;
+  totalGroupCount: number;
+  totalUnreviewedGroupCount: number;
+  /** The groups each status would keep under the filter's search, observation and source_system. */
+  unreviewedGroupCount: number;
+  reviewedGroupCount: number;
+  /** The groups each observation would keep under the filter's search, status and source_system. */
+  observedGroupCount: number;
+  unobservedGroupCount: number;
+  /** The unreviewed names in the groups the whole filter keeps: what Confirm<X> with the same filter writes. */
+  unreviewedNameCount: number;
+  /** Every source that reported a name in the table (unfiltered), sorted by source_system (byte order). */
+  sources: AIReferenceSourceCount[];
+}
+
+/** AIReferenceSourceCount is one source and the groups holding a name it reported. */
+export interface AIReferenceSourceCount {
+  sourceSystem: string;
+  groupCount: number;
+}
+
 /** AIReferenceName mirrors telemetry.api.v1.AIReferenceName: one raw name's display name. */
 export interface AIReferenceName {
   name: string;
@@ -1860,34 +2095,28 @@ export const ListAIBillersResponse: MessageFns<ListAIBillersResponse> = {
   },
 };
 
-function createBaseAIReferenceName(): AIReferenceName {
-  return { name: "", displayName: "", sourceSystems: [], origin: 0, updatedAt: undefined, observed: false };
+function createBaseListAIProviderGroupsRequest(): ListAIProviderGroupsRequest {
+  return { organizationIds: [], filter: undefined, page: 0, perPage: 0 };
 }
 
-export const AIReferenceName: MessageFns<AIReferenceName> = {
-  encode(message: AIReferenceName, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
-    if (message.name !== "") {
-      writer.uint32(10).string(message.name);
-    }
-    if (message.displayName !== "") {
-      writer.uint32(18).string(message.displayName);
-    }
-    for (const v of message.sourceSystems) {
-      writer.uint32(26).string(v!);
+export const ListAIProviderGroupsRequest: MessageFns<ListAIProviderGroupsRequest> = {
+  encode(message: ListAIProviderGroupsRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    for (const v of message.organizationIds) {
+      writer.uint32(10).string(v!);
     }
-    if (message.origin !== 0) {
-      writer.uint32(32).int32(message.origin);
+    if (message.filter !== undefined) {
+      AIReferenceGroupFilter.encode(message.filter, writer.uint32(18).fork()).join();
     }
-    if (message.updatedAt !== undefined) {
-      Timestamp.encode(toTimestamp(message.updatedAt), writer.uint32(42).fork()).join();
+    if (message.page !== 0) {
+      writer.uint32(24).int32(message.page);
     }
-    if (message.observed !== false) {
-      writer.uint32(48).bool(message.observed);
+    if (message.perPage !== 0) {
+      writer.uint32(32).int32(message.perPage);
     }
     return writer;
   },
 
-  decode(input: BinaryReader | Uint8Array, length?: number): AIReferenceName {
+  decode(input: BinaryReader | Uint8Array, length?: number): ListAIProviderGroupsRequest {
     const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
     const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
     if (previousRecursionDepth >= 100) {
@@ -1896,7 +2125,7 @@ export const AIReferenceName: MessageFns<AIReferenceName> = {
     (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
     try {
       const end = length === undefined ? reader.len : reader.pos + length;
-      const message = createBaseAIReferenceName();
+      const message = createBaseListAIProviderGroupsRequest();
       while (reader.pos < end) {
         const tag = reader.uint32();
         switch (tag >>> 3) {
@@ -1905,7 +2134,7 @@ export const AIReferenceName: MessageFns<AIReferenceName> = {
               break;
             }
 
-            message.name = reader.string();
+            message.organizationIds.push(reader.string());
             continue;
           }
           case 2: {
@@ -1913,15 +2142,15 @@ export const AIReferenceName: MessageFns<AIReferenceName> = {
               break;
             }
 
-            message.displayName = reader.string();
+            message.filter = AIReferenceGroupFilter.decode(reader, reader.uint32());
             continue;
           }
           case 3: {
-            if (tag !== 26) {
+            if (tag !== 24) {
               break;
             }
 
-            message.sourceSystems.push(reader.string());
+            message.page = reader.int32();
             continue;
           }
           case 4: {
@@ -1929,23 +2158,134 @@ export const AIReferenceName: MessageFns<AIReferenceName> = {
               break;
             }
 
-            message.origin = reader.int32() as any;
+            message.perPage = reader.int32();
             continue;
           }
-          case 5: {
-            if (tag !== 42) {
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): ListAIProviderGroupsRequest {
+    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))
+        : [],
+      filter: isSet(object.filter) ? AIReferenceGroupFilter.fromJSON(object.filter) : undefined,
+      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: ListAIProviderGroupsRequest): unknown {
+    const obj: any = {};
+    if (message.organizationIds?.length) {
+      obj.organizationIds = message.organizationIds;
+    }
+    if (message.filter !== undefined) {
+      obj.filter = AIReferenceGroupFilter.toJSON(message.filter);
+    }
+    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<ListAIProviderGroupsRequest>, I>>(base?: I): ListAIProviderGroupsRequest {
+    return ListAIProviderGroupsRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ListAIProviderGroupsRequest>, I>>(object: I): ListAIProviderGroupsRequest {
+    const message = createBaseListAIProviderGroupsRequest();
+    message.organizationIds = object.organizationIds?.map((e) => e) || [];
+    message.filter = (object.filter !== undefined && object.filter !== null)
+      ? AIReferenceGroupFilter.fromPartial(object.filter)
+      : undefined;
+    message.page = object.page ?? 0;
+    message.perPage = object.perPage ?? 0;
+    return message;
+  },
+};
+
+function createBaseListAIProviderGroupsResponse(): ListAIProviderGroupsResponse {
+  return { status: undefined, groups: [], pagination: undefined, counts: undefined };
+}
+
+export const ListAIProviderGroupsResponse: MessageFns<ListAIProviderGroupsResponse> = {
+  encode(message: ListAIProviderGroupsResponse, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.status !== undefined) {
+      ResponseStatus.encode(message.status, writer.uint32(10).fork()).join();
+    }
+    for (const v of message.groups) {
+      AIReferenceGroup.encode(v!, writer.uint32(18).fork()).join();
+    }
+    if (message.pagination !== undefined) {
+      Pagination.encode(message.pagination, writer.uint32(26).fork()).join();
+    }
+    if (message.counts !== undefined) {
+      AIReferenceGroupCounts.encode(message.counts, writer.uint32(34).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ListAIProviderGroupsResponse {
+    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 = createBaseListAIProviderGroupsResponse();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
               break;
             }
 
-            message.updatedAt = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
+            message.status = ResponseStatus.decode(reader, reader.uint32());
             continue;
           }
-          case 6: {
-            if (tag !== 48) {
+          case 2: {
+            if (tag !== 18) {
               break;
             }
 
-            message.observed = reader.bool();
+            message.groups.push(AIReferenceGroup.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.counts = AIReferenceGroupCounts.decode(reader, reader.uint32());
             continue;
           }
         }
@@ -1960,81 +2300,1621 @@ export const AIReferenceName: MessageFns<AIReferenceName> = {
     }
   },
 
-  fromJSON(object: any): AIReferenceName {
+  fromJSON(object: any): ListAIProviderGroupsResponse {
     return {
-      name: isSet(object.name) ? globalThis.String(object.name) : "",
-      displayName: isSet(object.displayName)
-        ? globalThis.String(object.displayName)
-        : isSet(object.display_name)
-        ? globalThis.String(object.display_name)
-        : "",
-      sourceSystems: globalThis.Array.isArray(object?.sourceSystems)
-        ? object.sourceSystems.map((e: any) => globalThis.String(e))
-        : globalThis.Array.isArray(object?.source_systems)
-        ? object.source_systems.map((e: any) => globalThis.String(e))
+      status: isSet(object.status) ? ResponseStatus.fromJSON(object.status) : undefined,
+      groups: globalThis.Array.isArray(object?.groups)
+        ? object.groups.map((e: any) => AIReferenceGroup.fromJSON(e))
         : [],
-      origin: isSet(object.origin) ? aIReferenceNameOriginFromJSON(object.origin) : 0,
-      updatedAt: isSet(object.updatedAt)
-        ? fromJsonTimestamp(object.updatedAt)
-        : isSet(object.updated_at)
-        ? fromJsonTimestamp(object.updated_at)
-        : undefined,
-      observed: isSet(object.observed) ? globalThis.Boolean(object.observed) : false,
+      pagination: isSet(object.pagination) ? Pagination.fromJSON(object.pagination) : undefined,
+      counts: isSet(object.counts) ? AIReferenceGroupCounts.fromJSON(object.counts) : undefined,
     };
   },
 
-  toJSON(message: AIReferenceName): unknown {
+  toJSON(message: ListAIProviderGroupsResponse): unknown {
     const obj: any = {};
-    if (message.name !== "") {
-      obj.name = message.name;
-    }
-    if (message.displayName !== "") {
-      obj.displayName = message.displayName;
-    }
-    if (message.sourceSystems?.length) {
-      obj.sourceSystems = message.sourceSystems;
+    if (message.status !== undefined) {
+      obj.status = ResponseStatus.toJSON(message.status);
     }
-    if (message.origin !== 0) {
-      obj.origin = aIReferenceNameOriginToJSON(message.origin);
+    if (message.groups?.length) {
+      obj.groups = message.groups.map((e) => AIReferenceGroup.toJSON(e));
     }
-    if (message.updatedAt !== undefined) {
-      obj.updatedAt = message.updatedAt.toISOString();
+    if (message.pagination !== undefined) {
+      obj.pagination = Pagination.toJSON(message.pagination);
     }
-    if (message.observed !== false) {
-      obj.observed = message.observed;
+    if (message.counts !== undefined) {
+      obj.counts = AIReferenceGroupCounts.toJSON(message.counts);
     }
     return obj;
   },
 
-  create<I extends Exact<DeepPartial<AIReferenceName>, I>>(base?: I): AIReferenceName {
-    return AIReferenceName.fromPartial(base ?? ({} as any));
+  create<I extends Exact<DeepPartial<ListAIProviderGroupsResponse>, I>>(base?: I): ListAIProviderGroupsResponse {
+    return ListAIProviderGroupsResponse.fromPartial(base ?? ({} as any));
   },
-  fromPartial<I extends Exact<DeepPartial<AIReferenceName>, I>>(object: I): AIReferenceName {
-    const message = createBaseAIReferenceName();
-    message.name = object.name ?? "";
-    message.displayName = object.displayName ?? "";
-    message.sourceSystems = object.sourceSystems?.map((e) => e) || [];
-    message.origin = object.origin ?? 0;
-    message.updatedAt = object.updatedAt ?? undefined;
-    message.observed = object.observed ?? false;
+  fromPartial<I extends Exact<DeepPartial<ListAIProviderGroupsResponse>, I>>(object: I): ListAIProviderGroupsResponse {
+    const message = createBaseListAIProviderGroupsResponse();
+    message.status = (object.status !== undefined && object.status !== null)
+      ? ResponseStatus.fromPartial(object.status)
+      : undefined;
+    message.groups = object.groups?.map((e) => AIReferenceGroup.fromPartial(e)) || [];
+    message.pagination = (object.pagination !== undefined && object.pagination !== null)
+      ? Pagination.fromPartial(object.pagination)
+      : undefined;
+    message.counts = (object.counts !== undefined && object.counts !== null)
+      ? AIReferenceGroupCounts.fromPartial(object.counts)
+      : undefined;
     return message;
   },
 };
 
-/**
- * ReferenceGatewayService is the frontend-facing surface for the AI reference data an org reads: its
- * principals (writes org-admin only) and the provider / model / effort / biller display names. The
- * name tables are global: each List returns the names the org's own telemetry reported, mapped through
- * them (scope ALL: every recorded name); Mirador staff edit them through AdminGatewayService. It proxies telemetry.api.v1.AIReferenceService.
- */
-export interface ReferenceGatewayService {
-  ListPrincipals(request: ListPrincipalsRequest, metadata?: Metadata): Promise<ListPrincipalsResponse>;
+function createBaseListAIModelGroupsRequest(): ListAIModelGroupsRequest {
+  return { organizationIds: [], filter: undefined, page: 0, perPage: 0 };
+}
+
+export const ListAIModelGroupsRequest: MessageFns<ListAIModelGroupsRequest> = {
+  encode(message: ListAIModelGroupsRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    for (const v of message.organizationIds) {
+      writer.uint32(10).string(v!);
+    }
+    if (message.filter !== undefined) {
+      AIReferenceGroupFilter.encode(message.filter, writer.uint32(18).fork()).join();
+    }
+    if (message.page !== 0) {
+      writer.uint32(24).int32(message.page);
+    }
+    if (message.perPage !== 0) {
+      writer.uint32(32).int32(message.perPage);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ListAIModelGroupsRequest {
+    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 = createBaseListAIModelGroupsRequest();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.organizationIds.push(reader.string());
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.filter = AIReferenceGroupFilter.decode(reader, reader.uint32());
+            continue;
+          }
+          case 3: {
+            if (tag !== 24) {
+              break;
+            }
+
+            message.page = reader.int32();
+            continue;
+          }
+          case 4: {
+            if (tag !== 32) {
+              break;
+            }
+
+            message.perPage = reader.int32();
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): ListAIModelGroupsRequest {
+    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))
+        : [],
+      filter: isSet(object.filter) ? AIReferenceGroupFilter.fromJSON(object.filter) : undefined,
+      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: ListAIModelGroupsRequest): unknown {
+    const obj: any = {};
+    if (message.organizationIds?.length) {
+      obj.organizationIds = message.organizationIds;
+    }
+    if (message.filter !== undefined) {
+      obj.filter = AIReferenceGroupFilter.toJSON(message.filter);
+    }
+    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<ListAIModelGroupsRequest>, I>>(base?: I): ListAIModelGroupsRequest {
+    return ListAIModelGroupsRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ListAIModelGroupsRequest>, I>>(object: I): ListAIModelGroupsRequest {
+    const message = createBaseListAIModelGroupsRequest();
+    message.organizationIds = object.organizationIds?.map((e) => e) || [];
+    message.filter = (object.filter !== undefined && object.filter !== null)
+      ? AIReferenceGroupFilter.fromPartial(object.filter)
+      : undefined;
+    message.page = object.page ?? 0;
+    message.perPage = object.perPage ?? 0;
+    return message;
+  },
+};
+
+function createBaseListAIModelGroupsResponse(): ListAIModelGroupsResponse {
+  return { status: undefined, groups: [], pagination: undefined, counts: undefined };
+}
+
+export const ListAIModelGroupsResponse: MessageFns<ListAIModelGroupsResponse> = {
+  encode(message: ListAIModelGroupsResponse, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.status !== undefined) {
+      ResponseStatus.encode(message.status, writer.uint32(10).fork()).join();
+    }
+    for (const v of message.groups) {
+      AIReferenceGroup.encode(v!, writer.uint32(18).fork()).join();
+    }
+    if (message.pagination !== undefined) {
+      Pagination.encode(message.pagination, writer.uint32(26).fork()).join();
+    }
+    if (message.counts !== undefined) {
+      AIReferenceGroupCounts.encode(message.counts, writer.uint32(34).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ListAIModelGroupsResponse {
+    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 = createBaseListAIModelGroupsResponse();
+      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.groups.push(AIReferenceGroup.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.counts = AIReferenceGroupCounts.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): ListAIModelGroupsResponse {
+    return {
+      status: isSet(object.status) ? ResponseStatus.fromJSON(object.status) : undefined,
+      groups: globalThis.Array.isArray(object?.groups)
+        ? object.groups.map((e: any) => AIReferenceGroup.fromJSON(e))
+        : [],
+      pagination: isSet(object.pagination) ? Pagination.fromJSON(object.pagination) : undefined,
+      counts: isSet(object.counts) ? AIReferenceGroupCounts.fromJSON(object.counts) : undefined,
+    };
+  },
+
+  toJSON(message: ListAIModelGroupsResponse): unknown {
+    const obj: any = {};
+    if (message.status !== undefined) {
+      obj.status = ResponseStatus.toJSON(message.status);
+    }
+    if (message.groups?.length) {
+      obj.groups = message.groups.map((e) => AIReferenceGroup.toJSON(e));
+    }
+    if (message.pagination !== undefined) {
+      obj.pagination = Pagination.toJSON(message.pagination);
+    }
+    if (message.counts !== undefined) {
+      obj.counts = AIReferenceGroupCounts.toJSON(message.counts);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<ListAIModelGroupsResponse>, I>>(base?: I): ListAIModelGroupsResponse {
+    return ListAIModelGroupsResponse.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ListAIModelGroupsResponse>, I>>(object: I): ListAIModelGroupsResponse {
+    const message = createBaseListAIModelGroupsResponse();
+    message.status = (object.status !== undefined && object.status !== null)
+      ? ResponseStatus.fromPartial(object.status)
+      : undefined;
+    message.groups = object.groups?.map((e) => AIReferenceGroup.fromPartial(e)) || [];
+    message.pagination = (object.pagination !== undefined && object.pagination !== null)
+      ? Pagination.fromPartial(object.pagination)
+      : undefined;
+    message.counts = (object.counts !== undefined && object.counts !== null)
+      ? AIReferenceGroupCounts.fromPartial(object.counts)
+      : undefined;
+    return message;
+  },
+};
+
+function createBaseListAIEffortGroupsRequest(): ListAIEffortGroupsRequest {
+  return { organizationIds: [], filter: undefined, page: 0, perPage: 0 };
+}
+
+export const ListAIEffortGroupsRequest: MessageFns<ListAIEffortGroupsRequest> = {
+  encode(message: ListAIEffortGroupsRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    for (const v of message.organizationIds) {
+      writer.uint32(10).string(v!);
+    }
+    if (message.filter !== undefined) {
+      AIReferenceGroupFilter.encode(message.filter, writer.uint32(18).fork()).join();
+    }
+    if (message.page !== 0) {
+      writer.uint32(24).int32(message.page);
+    }
+    if (message.perPage !== 0) {
+      writer.uint32(32).int32(message.perPage);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ListAIEffortGroupsRequest {
+    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 = createBaseListAIEffortGroupsRequest();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.organizationIds.push(reader.string());
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.filter = AIReferenceGroupFilter.decode(reader, reader.uint32());
+            continue;
+          }
+          case 3: {
+            if (tag !== 24) {
+              break;
+            }
+
+            message.page = reader.int32();
+            continue;
+          }
+          case 4: {
+            if (tag !== 32) {
+              break;
+            }
+
+            message.perPage = reader.int32();
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): ListAIEffortGroupsRequest {
+    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))
+        : [],
+      filter: isSet(object.filter) ? AIReferenceGroupFilter.fromJSON(object.filter) : undefined,
+      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: ListAIEffortGroupsRequest): unknown {
+    const obj: any = {};
+    if (message.organizationIds?.length) {
+      obj.organizationIds = message.organizationIds;
+    }
+    if (message.filter !== undefined) {
+      obj.filter = AIReferenceGroupFilter.toJSON(message.filter);
+    }
+    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<ListAIEffortGroupsRequest>, I>>(base?: I): ListAIEffortGroupsRequest {
+    return ListAIEffortGroupsRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ListAIEffortGroupsRequest>, I>>(object: I): ListAIEffortGroupsRequest {
+    const message = createBaseListAIEffortGroupsRequest();
+    message.organizationIds = object.organizationIds?.map((e) => e) || [];
+    message.filter = (object.filter !== undefined && object.filter !== null)
+      ? AIReferenceGroupFilter.fromPartial(object.filter)
+      : undefined;
+    message.page = object.page ?? 0;
+    message.perPage = object.perPage ?? 0;
+    return message;
+  },
+};
+
+function createBaseListAIEffortGroupsResponse(): ListAIEffortGroupsResponse {
+  return { status: undefined, groups: [], pagination: undefined, counts: undefined };
+}
+
+export const ListAIEffortGroupsResponse: MessageFns<ListAIEffortGroupsResponse> = {
+  encode(message: ListAIEffortGroupsResponse, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.status !== undefined) {
+      ResponseStatus.encode(message.status, writer.uint32(10).fork()).join();
+    }
+    for (const v of message.groups) {
+      AIReferenceGroup.encode(v!, writer.uint32(18).fork()).join();
+    }
+    if (message.pagination !== undefined) {
+      Pagination.encode(message.pagination, writer.uint32(26).fork()).join();
+    }
+    if (message.counts !== undefined) {
+      AIReferenceGroupCounts.encode(message.counts, writer.uint32(34).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ListAIEffortGroupsResponse {
+    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 = createBaseListAIEffortGroupsResponse();
+      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.groups.push(AIReferenceGroup.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.counts = AIReferenceGroupCounts.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): ListAIEffortGroupsResponse {
+    return {
+      status: isSet(object.status) ? ResponseStatus.fromJSON(object.status) : undefined,
+      groups: globalThis.Array.isArray(object?.groups)
+        ? object.groups.map((e: any) => AIReferenceGroup.fromJSON(e))
+        : [],
+      pagination: isSet(object.pagination) ? Pagination.fromJSON(object.pagination) : undefined,
+      counts: isSet(object.counts) ? AIReferenceGroupCounts.fromJSON(object.counts) : undefined,
+    };
+  },
+
+  toJSON(message: ListAIEffortGroupsResponse): unknown {
+    const obj: any = {};
+    if (message.status !== undefined) {
+      obj.status = ResponseStatus.toJSON(message.status);
+    }
+    if (message.groups?.length) {
+      obj.groups = message.groups.map((e) => AIReferenceGroup.toJSON(e));
+    }
+    if (message.pagination !== undefined) {
+      obj.pagination = Pagination.toJSON(message.pagination);
+    }
+    if (message.counts !== undefined) {
+      obj.counts = AIReferenceGroupCounts.toJSON(message.counts);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<ListAIEffortGroupsResponse>, I>>(base?: I): ListAIEffortGroupsResponse {
+    return ListAIEffortGroupsResponse.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ListAIEffortGroupsResponse>, I>>(object: I): ListAIEffortGroupsResponse {
+    const message = createBaseListAIEffortGroupsResponse();
+    message.status = (object.status !== undefined && object.status !== null)
+      ? ResponseStatus.fromPartial(object.status)
+      : undefined;
+    message.groups = object.groups?.map((e) => AIReferenceGroup.fromPartial(e)) || [];
+    message.pagination = (object.pagination !== undefined && object.pagination !== null)
+      ? Pagination.fromPartial(object.pagination)
+      : undefined;
+    message.counts = (object.counts !== undefined && object.counts !== null)
+      ? AIReferenceGroupCounts.fromPartial(object.counts)
+      : undefined;
+    return message;
+  },
+};
+
+function createBaseListAIBillerGroupsRequest(): ListAIBillerGroupsRequest {
+  return { organizationIds: [], filter: undefined, page: 0, perPage: 0 };
+}
+
+export const ListAIBillerGroupsRequest: MessageFns<ListAIBillerGroupsRequest> = {
+  encode(message: ListAIBillerGroupsRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    for (const v of message.organizationIds) {
+      writer.uint32(10).string(v!);
+    }
+    if (message.filter !== undefined) {
+      AIReferenceGroupFilter.encode(message.filter, writer.uint32(18).fork()).join();
+    }
+    if (message.page !== 0) {
+      writer.uint32(24).int32(message.page);
+    }
+    if (message.perPage !== 0) {
+      writer.uint32(32).int32(message.perPage);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ListAIBillerGroupsRequest {
+    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 = createBaseListAIBillerGroupsRequest();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.organizationIds.push(reader.string());
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.filter = AIReferenceGroupFilter.decode(reader, reader.uint32());
+            continue;
+          }
+          case 3: {
+            if (tag !== 24) {
+              break;
+            }
+
+            message.page = reader.int32();
+            continue;
+          }
+          case 4: {
+            if (tag !== 32) {
+              break;
+            }
+
+            message.perPage = reader.int32();
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): ListAIBillerGroupsRequest {
+    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))
+        : [],
+      filter: isSet(object.filter) ? AIReferenceGroupFilter.fromJSON(object.filter) : undefined,
+      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: ListAIBillerGroupsRequest): unknown {
+    const obj: any = {};
+    if (message.organizationIds?.length) {
+      obj.organizationIds = message.organizationIds;
+    }
+    if (message.filter !== undefined) {
+      obj.filter = AIReferenceGroupFilter.toJSON(message.filter);
+    }
+    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<ListAIBillerGroupsRequest>, I>>(base?: I): ListAIBillerGroupsRequest {
+    return ListAIBillerGroupsRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ListAIBillerGroupsRequest>, I>>(object: I): ListAIBillerGroupsRequest {
+    const message = createBaseListAIBillerGroupsRequest();
+    message.organizationIds = object.organizationIds?.map((e) => e) || [];
+    message.filter = (object.filter !== undefined && object.filter !== null)
+      ? AIReferenceGroupFilter.fromPartial(object.filter)
+      : undefined;
+    message.page = object.page ?? 0;
+    message.perPage = object.perPage ?? 0;
+    return message;
+  },
+};
+
+function createBaseListAIBillerGroupsResponse(): ListAIBillerGroupsResponse {
+  return { status: undefined, groups: [], pagination: undefined, counts: undefined };
+}
+
+export const ListAIBillerGroupsResponse: MessageFns<ListAIBillerGroupsResponse> = {
+  encode(message: ListAIBillerGroupsResponse, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.status !== undefined) {
+      ResponseStatus.encode(message.status, writer.uint32(10).fork()).join();
+    }
+    for (const v of message.groups) {
+      AIReferenceGroup.encode(v!, writer.uint32(18).fork()).join();
+    }
+    if (message.pagination !== undefined) {
+      Pagination.encode(message.pagination, writer.uint32(26).fork()).join();
+    }
+    if (message.counts !== undefined) {
+      AIReferenceGroupCounts.encode(message.counts, writer.uint32(34).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ListAIBillerGroupsResponse {
+    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 = createBaseListAIBillerGroupsResponse();
+      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.groups.push(AIReferenceGroup.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.counts = AIReferenceGroupCounts.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): ListAIBillerGroupsResponse {
+    return {
+      status: isSet(object.status) ? ResponseStatus.fromJSON(object.status) : undefined,
+      groups: globalThis.Array.isArray(object?.groups)
+        ? object.groups.map((e: any) => AIReferenceGroup.fromJSON(e))
+        : [],
+      pagination: isSet(object.pagination) ? Pagination.fromJSON(object.pagination) : undefined,
+      counts: isSet(object.counts) ? AIReferenceGroupCounts.fromJSON(object.counts) : undefined,
+    };
+  },
+
+  toJSON(message: ListAIBillerGroupsResponse): unknown {
+    const obj: any = {};
+    if (message.status !== undefined) {
+      obj.status = ResponseStatus.toJSON(message.status);
+    }
+    if (message.groups?.length) {
+      obj.groups = message.groups.map((e) => AIReferenceGroup.toJSON(e));
+    }
+    if (message.pagination !== undefined) {
+      obj.pagination = Pagination.toJSON(message.pagination);
+    }
+    if (message.counts !== undefined) {
+      obj.counts = AIReferenceGroupCounts.toJSON(message.counts);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<ListAIBillerGroupsResponse>, I>>(base?: I): ListAIBillerGroupsResponse {
+    return ListAIBillerGroupsResponse.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ListAIBillerGroupsResponse>, I>>(object: I): ListAIBillerGroupsResponse {
+    const message = createBaseListAIBillerGroupsResponse();
+    message.status = (object.status !== undefined && object.status !== null)
+      ? ResponseStatus.fromPartial(object.status)
+      : undefined;
+    message.groups = object.groups?.map((e) => AIReferenceGroup.fromPartial(e)) || [];
+    message.pagination = (object.pagination !== undefined && object.pagination !== null)
+      ? Pagination.fromPartial(object.pagination)
+      : undefined;
+    message.counts = (object.counts !== undefined && object.counts !== null)
+      ? AIReferenceGroupCounts.fromPartial(object.counts)
+      : undefined;
+    return message;
+  },
+};
+
+function createBaseAIReferenceGroupFilter(): AIReferenceGroupFilter {
+  return { search: "", status: 0, observation: 0, sourceSystem: "" };
+}
+
+export const AIReferenceGroupFilter: MessageFns<AIReferenceGroupFilter> = {
+  encode(message: AIReferenceGroupFilter, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.search !== "") {
+      writer.uint32(10).string(message.search);
+    }
+    if (message.status !== 0) {
+      writer.uint32(16).int32(message.status);
+    }
+    if (message.observation !== 0) {
+      writer.uint32(24).int32(message.observation);
+    }
+    if (message.sourceSystem !== "") {
+      writer.uint32(34).string(message.sourceSystem);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): AIReferenceGroupFilter {
+    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 = createBaseAIReferenceGroupFilter();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.search = reader.string();
+            continue;
+          }
+          case 2: {
+            if (tag !== 16) {
+              break;
+            }
+
+            message.status = reader.int32() as any;
+            continue;
+          }
+          case 3: {
+            if (tag !== 24) {
+              break;
+            }
+
+            message.observation = reader.int32() as any;
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.sourceSystem = 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): AIReferenceGroupFilter {
+    return {
+      search: isSet(object.search) ? globalThis.String(object.search) : "",
+      status: isSet(object.status) ? aIReferenceGroupStatusFromJSON(object.status) : 0,
+      observation: isSet(object.observation) ? aIReferenceGroupObservationFromJSON(object.observation) : 0,
+      sourceSystem: isSet(object.sourceSystem)
+        ? globalThis.String(object.sourceSystem)
+        : isSet(object.source_system)
+        ? globalThis.String(object.source_system)
+        : "",
+    };
+  },
+
+  toJSON(message: AIReferenceGroupFilter): unknown {
+    const obj: any = {};
+    if (message.search !== "") {
+      obj.search = message.search;
+    }
+    if (message.status !== 0) {
+      obj.status = aIReferenceGroupStatusToJSON(message.status);
+    }
+    if (message.observation !== 0) {
+      obj.observation = aIReferenceGroupObservationToJSON(message.observation);
+    }
+    if (message.sourceSystem !== "") {
+      obj.sourceSystem = message.sourceSystem;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<AIReferenceGroupFilter>, I>>(base?: I): AIReferenceGroupFilter {
+    return AIReferenceGroupFilter.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<AIReferenceGroupFilter>, I>>(object: I): AIReferenceGroupFilter {
+    const message = createBaseAIReferenceGroupFilter();
+    message.search = object.search ?? "";
+    message.status = object.status ?? 0;
+    message.observation = object.observation ?? 0;
+    message.sourceSystem = object.sourceSystem ?? "";
+    return message;
+  },
+};
+
+function createBaseAIReferenceGroup(): AIReferenceGroup {
+  return { displayName: "", names: [], sourceSystems: [], confirmed: false, unreviewedNames: [], observed: false };
+}
+
+export const AIReferenceGroup: MessageFns<AIReferenceGroup> = {
+  encode(message: AIReferenceGroup, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.displayName !== "") {
+      writer.uint32(10).string(message.displayName);
+    }
+    for (const v of message.names) {
+      AIReferenceName.encode(v!, writer.uint32(18).fork()).join();
+    }
+    for (const v of message.sourceSystems) {
+      writer.uint32(26).string(v!);
+    }
+    if (message.confirmed !== false) {
+      writer.uint32(32).bool(message.confirmed);
+    }
+    for (const v of message.unreviewedNames) {
+      writer.uint32(42).string(v!);
+    }
+    if (message.observed !== false) {
+      writer.uint32(48).bool(message.observed);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): AIReferenceGroup {
+    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 = createBaseAIReferenceGroup();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.displayName = reader.string();
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.names.push(AIReferenceName.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.sourceSystems.push(reader.string());
+            continue;
+          }
+          case 4: {
+            if (tag !== 32) {
+              break;
+            }
+
+            message.confirmed = reader.bool();
+            continue;
+          }
+          case 5: {
+            if (tag !== 42) {
+              break;
+            }
+
+            message.unreviewedNames.push(reader.string());
+            continue;
+          }
+          case 6: {
+            if (tag !== 48) {
+              break;
+            }
+
+            message.observed = reader.bool();
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): AIReferenceGroup {
+    return {
+      displayName: isSet(object.displayName)
+        ? globalThis.String(object.displayName)
+        : isSet(object.display_name)
+        ? globalThis.String(object.display_name)
+        : "",
+      names: globalThis.Array.isArray(object?.names) ? object.names.map((e: any) => AIReferenceName.fromJSON(e)) : [],
+      sourceSystems: globalThis.Array.isArray(object?.sourceSystems)
+        ? object.sourceSystems.map((e: any) => globalThis.String(e))
+        : globalThis.Array.isArray(object?.source_systems)
+        ? object.source_systems.map((e: any) => globalThis.String(e))
+        : [],
+      confirmed: isSet(object.confirmed) ? globalThis.Boolean(object.confirmed) : false,
+      unreviewedNames: globalThis.Array.isArray(object?.unreviewedNames)
+        ? object.unreviewedNames.map((e: any) => globalThis.String(e))
+        : globalThis.Array.isArray(object?.unreviewed_names)
+        ? object.unreviewed_names.map((e: any) => globalThis.String(e))
+        : [],
+      observed: isSet(object.observed) ? globalThis.Boolean(object.observed) : false,
+    };
+  },
+
+  toJSON(message: AIReferenceGroup): unknown {
+    const obj: any = {};
+    if (message.displayName !== "") {
+      obj.displayName = message.displayName;
+    }
+    if (message.names?.length) {
+      obj.names = message.names.map((e) => AIReferenceName.toJSON(e));
+    }
+    if (message.sourceSystems?.length) {
+      obj.sourceSystems = message.sourceSystems;
+    }
+    if (message.confirmed !== false) {
+      obj.confirmed = message.confirmed;
+    }
+    if (message.unreviewedNames?.length) {
+      obj.unreviewedNames = message.unreviewedNames;
+    }
+    if (message.observed !== false) {
+      obj.observed = message.observed;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<AIReferenceGroup>, I>>(base?: I): AIReferenceGroup {
+    return AIReferenceGroup.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<AIReferenceGroup>, I>>(object: I): AIReferenceGroup {
+    const message = createBaseAIReferenceGroup();
+    message.displayName = object.displayName ?? "";
+    message.names = object.names?.map((e) => AIReferenceName.fromPartial(e)) || [];
+    message.sourceSystems = object.sourceSystems?.map((e) => e) || [];
+    message.confirmed = object.confirmed ?? false;
+    message.unreviewedNames = object.unreviewedNames?.map((e) => e) || [];
+    message.observed = object.observed ?? false;
+    return message;
+  },
+};
+
+function createBaseAIReferenceGroupCounts(): AIReferenceGroupCounts {
+  return {
+    totalNameCount: 0,
+    totalGroupCount: 0,
+    totalUnreviewedGroupCount: 0,
+    unreviewedGroupCount: 0,
+    reviewedGroupCount: 0,
+    observedGroupCount: 0,
+    unobservedGroupCount: 0,
+    unreviewedNameCount: 0,
+    sources: [],
+  };
+}
+
+export const AIReferenceGroupCounts: MessageFns<AIReferenceGroupCounts> = {
+  encode(message: AIReferenceGroupCounts, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.totalNameCount !== 0) {
+      writer.uint32(8).int64(message.totalNameCount);
+    }
+    if (message.totalGroupCount !== 0) {
+      writer.uint32(16).int64(message.totalGroupCount);
+    }
+    if (message.totalUnreviewedGroupCount !== 0) {
+      writer.uint32(24).int64(message.totalUnreviewedGroupCount);
+    }
+    if (message.unreviewedGroupCount !== 0) {
+      writer.uint32(32).int64(message.unreviewedGroupCount);
+    }
+    if (message.reviewedGroupCount !== 0) {
+      writer.uint32(40).int64(message.reviewedGroupCount);
+    }
+    if (message.observedGroupCount !== 0) {
+      writer.uint32(48).int64(message.observedGroupCount);
+    }
+    if (message.unobservedGroupCount !== 0) {
+      writer.uint32(56).int64(message.unobservedGroupCount);
+    }
+    if (message.unreviewedNameCount !== 0) {
+      writer.uint32(64).int64(message.unreviewedNameCount);
+    }
+    for (const v of message.sources) {
+      AIReferenceSourceCount.encode(v!, writer.uint32(74).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): AIReferenceGroupCounts {
+    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 = createBaseAIReferenceGroupCounts();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 8) {
+              break;
+            }
+
+            message.totalNameCount = longToNumber(reader.int64());
+            continue;
+          }
+          case 2: {
+            if (tag !== 16) {
+              break;
+            }
+
+            message.totalGroupCount = longToNumber(reader.int64());
+            continue;
+          }
+          case 3: {
+            if (tag !== 24) {
+              break;
+            }
+
+            message.totalUnreviewedGroupCount = longToNumber(reader.int64());
+            continue;
+          }
+          case 4: {
+            if (tag !== 32) {
+              break;
+            }
+
+            message.unreviewedGroupCount = longToNumber(reader.int64());
+            continue;
+          }
+          case 5: {
+            if (tag !== 40) {
+              break;
+            }
+
+            message.reviewedGroupCount = longToNumber(reader.int64());
+            continue;
+          }
+          case 6: {
+            if (tag !== 48) {
+              break;
+            }
+
+            message.observedGroupCount = longToNumber(reader.int64());
+            continue;
+          }
+          case 7: {
+            if (tag !== 56) {
+              break;
+            }
+
+            message.unobservedGroupCount = longToNumber(reader.int64());
+            continue;
+          }
+          case 8: {
+            if (tag !== 64) {
+              break;
+            }
+
+            message.unreviewedNameCount = longToNumber(reader.int64());
+            continue;
+          }
+          case 9: {
+            if (tag !== 74) {
+              break;
+            }
+
+            message.sources.push(AIReferenceSourceCount.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): AIReferenceGroupCounts {
+    return {
+      totalNameCount: isSet(object.totalNameCount)
+        ? globalThis.Number(object.totalNameCount)
+        : isSet(object.total_name_count)
+        ? globalThis.Number(object.total_name_count)
+        : 0,
+      totalGroupCount: isSet(object.totalGroupCount)
+        ? globalThis.Number(object.totalGroupCount)
+        : isSet(object.total_group_count)
+        ? globalThis.Number(object.total_group_count)
+        : 0,
+      totalUnreviewedGroupCount: isSet(object.totalUnreviewedGroupCount)
+        ? globalThis.Number(object.totalUnreviewedGroupCount)
+        : isSet(object.total_unreviewed_group_count)
+        ? globalThis.Number(object.total_unreviewed_group_count)
+        : 0,
+      unreviewedGroupCount: isSet(object.unreviewedGroupCount)
+        ? globalThis.Number(object.unreviewedGroupCount)
+        : isSet(object.unreviewed_group_count)
+        ? globalThis.Number(object.unreviewed_group_count)
+        : 0,
+      reviewedGroupCount: isSet(object.reviewedGroupCount)
+        ? globalThis.Number(object.reviewedGroupCount)
+        : isSet(object.reviewed_group_count)
+        ? globalThis.Number(object.reviewed_group_count)
+        : 0,
+      observedGroupCount: isSet(object.observedGroupCount)
+        ? globalThis.Number(object.observedGroupCount)
+        : isSet(object.observed_group_count)
+        ? globalThis.Number(object.observed_group_count)
+        : 0,
+      unobservedGroupCount: isSet(object.unobservedGroupCount)
+        ? globalThis.Number(object.unobservedGroupCount)
+        : isSet(object.unobserved_group_count)
+        ? globalThis.Number(object.unobserved_group_count)
+        : 0,
+      unreviewedNameCount: isSet(object.unreviewedNameCount)
+        ? globalThis.Number(object.unreviewedNameCount)
+        : isSet(object.unreviewed_name_count)
+        ? globalThis.Number(object.unreviewed_name_count)
+        : 0,
+      sources: globalThis.Array.isArray(object?.sources)
+        ? object.sources.map((e: any) => AIReferenceSourceCount.fromJSON(e))
+        : [],
+    };
+  },
+
+  toJSON(message: AIReferenceGroupCounts): unknown {
+    const obj: any = {};
+    if (message.totalNameCount !== 0) {
+      obj.totalNameCount = Math.round(message.totalNameCount);
+    }
+    if (message.totalGroupCount !== 0) {
+      obj.totalGroupCount = Math.round(message.totalGroupCount);
+    }
+    if (message.totalUnreviewedGroupCount !== 0) {
+      obj.totalUnreviewedGroupCount = Math.round(message.totalUnreviewedGroupCount);
+    }
+    if (message.unreviewedGroupCount !== 0) {
+      obj.unreviewedGroupCount = Math.round(message.unreviewedGroupCount);
+    }
+    if (message.reviewedGroupCount !== 0) {
+      obj.reviewedGroupCount = Math.round(message.reviewedGroupCount);
+    }
+    if (message.observedGroupCount !== 0) {
+      obj.observedGroupCount = Math.round(message.observedGroupCount);
+    }
+    if (message.unobservedGroupCount !== 0) {
+      obj.unobservedGroupCount = Math.round(message.unobservedGroupCount);
+    }
+    if (message.unreviewedNameCount !== 0) {
+      obj.unreviewedNameCount = Math.round(message.unreviewedNameCount);
+    }
+    if (message.sources?.length) {
+      obj.sources = message.sources.map((e) => AIReferenceSourceCount.toJSON(e));
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<AIReferenceGroupCounts>, I>>(base?: I): AIReferenceGroupCounts {
+    return AIReferenceGroupCounts.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<AIReferenceGroupCounts>, I>>(object: I): AIReferenceGroupCounts {
+    const message = createBaseAIReferenceGroupCounts();
+    message.totalNameCount = object.totalNameCount ?? 0;
+    message.totalGroupCount = object.totalGroupCount ?? 0;
+    message.totalUnreviewedGroupCount = object.totalUnreviewedGroupCount ?? 0;
+    message.unreviewedGroupCount = object.unreviewedGroupCount ?? 0;
+    message.reviewedGroupCount = object.reviewedGroupCount ?? 0;
+    message.observedGroupCount = object.observedGroupCount ?? 0;
+    message.unobservedGroupCount = object.unobservedGroupCount ?? 0;
+    message.unreviewedNameCount = object.unreviewedNameCount ?? 0;
+    message.sources = object.sources?.map((e) => AIReferenceSourceCount.fromPartial(e)) || [];
+    return message;
+  },
+};
+
+function createBaseAIReferenceSourceCount(): AIReferenceSourceCount {
+  return { sourceSystem: "", groupCount: 0 };
+}
+
+export const AIReferenceSourceCount: MessageFns<AIReferenceSourceCount> = {
+  encode(message: AIReferenceSourceCount, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.sourceSystem !== "") {
+      writer.uint32(10).string(message.sourceSystem);
+    }
+    if (message.groupCount !== 0) {
+      writer.uint32(16).int64(message.groupCount);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): AIReferenceSourceCount {
+    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 = createBaseAIReferenceSourceCount();
+      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 !== 16) {
+              break;
+            }
+
+            message.groupCount = longToNumber(reader.int64());
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): AIReferenceSourceCount {
+    return {
+      sourceSystem: isSet(object.sourceSystem)
+        ? globalThis.String(object.sourceSystem)
+        : isSet(object.source_system)
+        ? globalThis.String(object.source_system)
+        : "",
+      groupCount: isSet(object.groupCount)
+        ? globalThis.Number(object.groupCount)
+        : isSet(object.group_count)
+        ? globalThis.Number(object.group_count)
+        : 0,
+    };
+  },
+
+  toJSON(message: AIReferenceSourceCount): unknown {
+    const obj: any = {};
+    if (message.sourceSystem !== "") {
+      obj.sourceSystem = message.sourceSystem;
+    }
+    if (message.groupCount !== 0) {
+      obj.groupCount = Math.round(message.groupCount);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<AIReferenceSourceCount>, I>>(base?: I): AIReferenceSourceCount {
+    return AIReferenceSourceCount.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<AIReferenceSourceCount>, I>>(object: I): AIReferenceSourceCount {
+    const message = createBaseAIReferenceSourceCount();
+    message.sourceSystem = object.sourceSystem ?? "";
+    message.groupCount = object.groupCount ?? 0;
+    return message;
+  },
+};
+
+function createBaseAIReferenceName(): AIReferenceName {
+  return { name: "", displayName: "", sourceSystems: [], origin: 0, updatedAt: undefined, observed: false };
+}
+
+export const AIReferenceName: MessageFns<AIReferenceName> = {
+  encode(message: AIReferenceName, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.name !== "") {
+      writer.uint32(10).string(message.name);
+    }
+    if (message.displayName !== "") {
+      writer.uint32(18).string(message.displayName);
+    }
+    for (const v of message.sourceSystems) {
+      writer.uint32(26).string(v!);
+    }
+    if (message.origin !== 0) {
+      writer.uint32(32).int32(message.origin);
+    }
+    if (message.updatedAt !== undefined) {
+      Timestamp.encode(toTimestamp(message.updatedAt), writer.uint32(42).fork()).join();
+    }
+    if (message.observed !== false) {
+      writer.uint32(48).bool(message.observed);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): AIReferenceName {
+    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 = createBaseAIReferenceName();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.name = reader.string();
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.displayName = reader.string();
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.sourceSystems.push(reader.string());
+            continue;
+          }
+          case 4: {
+            if (tag !== 32) {
+              break;
+            }
+
+            message.origin = reader.int32() as any;
+            continue;
+          }
+          case 5: {
+            if (tag !== 42) {
+              break;
+            }
+
+            message.updatedAt = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 6: {
+            if (tag !== 48) {
+              break;
+            }
+
+            message.observed = reader.bool();
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): AIReferenceName {
+    return {
+      name: isSet(object.name) ? globalThis.String(object.name) : "",
+      displayName: isSet(object.displayName)
+        ? globalThis.String(object.displayName)
+        : isSet(object.display_name)
+        ? globalThis.String(object.display_name)
+        : "",
+      sourceSystems: globalThis.Array.isArray(object?.sourceSystems)
+        ? object.sourceSystems.map((e: any) => globalThis.String(e))
+        : globalThis.Array.isArray(object?.source_systems)
+        ? object.source_systems.map((e: any) => globalThis.String(e))
+        : [],
+      origin: isSet(object.origin) ? aIReferenceNameOriginFromJSON(object.origin) : 0,
+      updatedAt: isSet(object.updatedAt)
+        ? fromJsonTimestamp(object.updatedAt)
+        : isSet(object.updated_at)
+        ? fromJsonTimestamp(object.updated_at)
+        : undefined,
+      observed: isSet(object.observed) ? globalThis.Boolean(object.observed) : false,
+    };
+  },
+
+  toJSON(message: AIReferenceName): unknown {
+    const obj: any = {};
+    if (message.name !== "") {
+      obj.name = message.name;
+    }
+    if (message.displayName !== "") {
+      obj.displayName = message.displayName;
+    }
+    if (message.sourceSystems?.length) {
+      obj.sourceSystems = message.sourceSystems;
+    }
+    if (message.origin !== 0) {
+      obj.origin = aIReferenceNameOriginToJSON(message.origin);
+    }
+    if (message.updatedAt !== undefined) {
+      obj.updatedAt = message.updatedAt.toISOString();
+    }
+    if (message.observed !== false) {
+      obj.observed = message.observed;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<AIReferenceName>, I>>(base?: I): AIReferenceName {
+    return AIReferenceName.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<AIReferenceName>, I>>(object: I): AIReferenceName {
+    const message = createBaseAIReferenceName();
+    message.name = object.name ?? "";
+    message.displayName = object.displayName ?? "";
+    message.sourceSystems = object.sourceSystems?.map((e) => e) || [];
+    message.origin = object.origin ?? 0;
+    message.updatedAt = object.updatedAt ?? undefined;
+    message.observed = object.observed ?? false;
+    return message;
+  },
+};
+
+/**
+ * ReferenceGatewayService is the frontend-facing surface for the AI reference data an org reads: its
+ * principals (writes org-admin only) and the provider / model / effort / biller display names. The
+ * name tables are global: each List returns the names the org's own telemetry reported, mapped through
+ * them (scope ALL: every recorded name); Mirador staff edit them through AdminGatewayService. It proxies telemetry.api.v1.AIReferenceService.
+ */
+export interface ReferenceGatewayService {
+  ListPrincipals(request: ListPrincipalsRequest, metadata?: Metadata): Promise<ListPrincipalsResponse>;
   UpdatePrincipal(request: UpdatePrincipalRequest, metadata?: Metadata): Promise<UpdatePrincipalResponse>;
   /** Any org member reads the name tables. Every stored name of the table has an entry, recorded or not. */
   ListAIProviders(request: ListAIProvidersRequest, metadata?: Metadata): Promise<ListAIProvidersResponse>;
   ListAIModels(request: ListAIModelsRequest, metadata?: Metadata): Promise<ListAIModelsResponse>;
   ListAIEfforts(request: ListAIEffortsRequest, metadata?: Metadata): Promise<ListAIEffortsResponse>;
   ListAIBillers(request: ListAIBillersRequest, metadata?: Metadata): Promise<ListAIBillersResponse>;
+  /**
+   * Each List<X>Groups pages one table as the admin pages show it: one group per display name, filtered and
+   * counted server-side (it proxies telemetry.api.v1.AIReferenceService). A name is observed when an organization
+   * of organization_ids reported it, and carries the sources that reported it to them; every other recorded name
+   * is listed unobserved with only its price-catalog sources. The empty effort (a call that reported none) is
+   * always listed observed.
+   *
+   * Groups come in one fixed order, so there is no sort field: efforts by their step on the effort meter
+   * (default, minimal, low, medium, high, xhigh, max, then unplaced), then display name; the other tables by
+   * display name. A display name that is no level takes the step of its first stored name the meter places, else
+   * of its own words; a top-step spelling other than max ("maximum", "ultra", "highest") sits at xhigh. Display
+   * names compare as bytes and name one group each, so no two groups tie and pages never overlap. An empty result
+   * is page 1 of total_pages 0.
+   */
+  ListAIProviderGroups(
+    request: ListAIProviderGroupsRequest,
+    metadata?: Metadata,
+  ): Promise<ListAIProviderGroupsResponse>;
+  ListAIModelGroups(request: ListAIModelGroupsRequest, metadata?: Metadata): Promise<ListAIModelGroupsResponse>;
+  ListAIEffortGroups(request: ListAIEffortGroupsRequest, metadata?: Metadata): Promise<ListAIEffortGroupsResponse>;
+  ListAIBillerGroups(request: ListAIBillerGroupsRequest, metadata?: Metadata): Promise<ListAIBillerGroupsResponse>;
 }
 
 export const ReferenceGatewayServiceServiceName = "gateway.web.v1.ReferenceGatewayService";
@@ -2050,6 +3930,10 @@ export class ReferenceGatewayServiceClientImpl implements ReferenceGatewayServic
     this.ListAIModels = this.ListAIModels.bind(this);
     this.ListAIEfforts = this.ListAIEfforts.bind(this);
     this.ListAIBillers = this.ListAIBillers.bind(this);
+    this.ListAIProviderGroups = this.ListAIProviderGroups.bind(this);
+    this.ListAIModelGroups = this.ListAIModelGroups.bind(this);
+    this.ListAIEffortGroups = this.ListAIEffortGroups.bind(this);
+    this.ListAIBillerGroups = this.ListAIBillerGroups.bind(this);
   }
   ListPrincipals(request: ListPrincipalsRequest, metadata?: Metadata): Promise<ListPrincipalsResponse> {
     const data = ListPrincipalsRequest.encode(request).finish();
@@ -2086,6 +3970,33 @@ export class ReferenceGatewayServiceClientImpl implements ReferenceGatewayServic
     const promise = this.rpc.request(this.service, "ListAIBillers", data, metadata);
     return promise.then((data) => ListAIBillersResponse.decode(new BinaryReader(data)));
   }
+
+  ListAIProviderGroups(
+    request: ListAIProviderGroupsRequest,
+    metadata?: Metadata,
+  ): Promise<ListAIProviderGroupsResponse> {
+    const data = ListAIProviderGroupsRequest.encode(request).finish();
+    const promise = this.rpc.request(this.service, "ListAIProviderGroups", data, metadata);
+    return promise.then((data) => ListAIProviderGroupsResponse.decode(new BinaryReader(data)));
+  }
+
+  ListAIModelGroups(request: ListAIModelGroupsRequest, metadata?: Metadata): Promise<ListAIModelGroupsResponse> {
+    const data = ListAIModelGroupsRequest.encode(request).finish();
+    const promise = this.rpc.request(this.service, "ListAIModelGroups", data, metadata);
+    return promise.then((data) => ListAIModelGroupsResponse.decode(new BinaryReader(data)));
+  }
+
+  ListAIEffortGroups(request: ListAIEffortGroupsRequest, metadata?: Metadata): Promise<ListAIEffortGroupsResponse> {
+    const data = ListAIEffortGroupsRequest.encode(request).finish();
+    const promise = this.rpc.request(this.service, "ListAIEffortGroups", data, metadata);
+    return promise.then((data) => ListAIEffortGroupsResponse.decode(new BinaryReader(data)));
+  }
+
+  ListAIBillerGroups(request: ListAIBillerGroupsRequest, metadata?: Metadata): Promise<ListAIBillerGroupsResponse> {
+    const data = ListAIBillerGroupsRequest.encode(request).finish();
+    const promise = this.rpc.request(this.service, "ListAIBillerGroups", data, metadata);
+    return promise.then((data) => ListAIBillerGroupsResponse.decode(new BinaryReader(data)));
+  }
 }
 
 interface Rpc {