@miradorlabs/web-grpc 3.35.0 → 3.36.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miradorlabs/web-grpc",
-  "version": "3.35.0",
+  "version": "3.36.1",
   "description": "Generated gRPC (grpc-js) client stubs for the Mirador web gateway.",
   "main": "index.js",
   "types": "index.d.ts",

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

@@ -454,8 +454,6 @@ export enum AISpendForecastDimension {
   AI_SPEND_FORECAST_DIMENSION_MODEL = 1,
   AI_SPEND_FORECAST_DIMENSION_PROVIDER = 2,
   AI_SPEND_FORECAST_DIMENSION_SOURCE_SYSTEM = 3,
-  AI_SPEND_FORECAST_DIMENSION_USER = 4,
-  AI_SPEND_FORECAST_DIMENSION_API_KEY = 5,
   UNRECOGNIZED = -1,
 }
 
@@ -473,12 +471,6 @@ export function aISpendForecastDimensionFromJSON(object: any): AISpendForecastDi
     case 3:
     case "AI_SPEND_FORECAST_DIMENSION_SOURCE_SYSTEM":
       return AISpendForecastDimension.AI_SPEND_FORECAST_DIMENSION_SOURCE_SYSTEM;
-    case 4:
-    case "AI_SPEND_FORECAST_DIMENSION_USER":
-      return AISpendForecastDimension.AI_SPEND_FORECAST_DIMENSION_USER;
-    case 5:
-    case "AI_SPEND_FORECAST_DIMENSION_API_KEY":
-      return AISpendForecastDimension.AI_SPEND_FORECAST_DIMENSION_API_KEY;
     case -1:
     case "UNRECOGNIZED":
     default:
@@ -496,10 +488,6 @@ export function aISpendForecastDimensionToJSON(object: AISpendForecastDimension)
       return "AI_SPEND_FORECAST_DIMENSION_PROVIDER";
     case AISpendForecastDimension.AI_SPEND_FORECAST_DIMENSION_SOURCE_SYSTEM:
       return "AI_SPEND_FORECAST_DIMENSION_SOURCE_SYSTEM";
-    case AISpendForecastDimension.AI_SPEND_FORECAST_DIMENSION_USER:
-      return "AI_SPEND_FORECAST_DIMENSION_USER";
-    case AISpendForecastDimension.AI_SPEND_FORECAST_DIMENSION_API_KEY:
-      return "AI_SPEND_FORECAST_DIMENSION_API_KEY";
     case AISpendForecastDimension.UNRECOGNIZED:
     default:
       return "UNRECOGNIZED";
@@ -1692,14 +1680,23 @@ export interface SpendForecastRequest {
   filter: SpendForecastFilter | undefined;
 }
 
-/** SpendForecastFilter narrows the cost a forecast counts. An empty list does not filter. */
+/**
+ * SpendForecastFilter narrows the cost a forecast counts: OR within a list, AND across lists, and an empty list does
+ * not filter. source_systems and principals select as DailyActivityRequest.Filter's do, at most 500 entries each.
+ */
 export interface SpendForecastFilter {
   /**
-   * OR within the list. UNKNOWN selects every cost off the three named facilities (observed-unknown, never-stamped
-   * or an unrecognized facility); UNSPECIFIED is rejected.
+   * UNKNOWN selects every cost off the three named facilities (observed-unknown, never-stamped or an unrecognized
+   * facility); UNSPECIFIED is rejected.
    * [API_METERED, PREPAID_CREDITS, UNKNOWN] is the cost not drawn on a subscription facility.
    */
   fundingModes: AIFundingMode[];
+  sourceSystems: string[];
+  /**
+   * Cost belongs to its user id, else its api key: an api-key principal matches only cost with no user id. A
+   * principal with an empty id selects cost that recorded neither.
+   */
+  principals: DailyActivityPrincipal[];
 }
 
 /**
@@ -1731,7 +1728,17 @@ export interface SpendForecast {
    * projection.expected_usd exactly; a group's low_usd and high_usd do not sum to total's.
    */
   breakdowns: SpendForecastBreakdown[];
-  asOf: Date | undefined;
+  asOf:
+    | Date
+    | undefined;
+  /**
+   * The cost per principal, attributed as filter.principals selects it (user id, else api key), for principals with
+   * cost in the month or the replayed history (one absent spent nothing), ascending by (source_system, kind, id).
+   * Partitions total's month_to_date_usd and projection.expected_usd exactly; the entry with kind API_KEY and an
+   * empty id is the cost that recorded neither id. Sent back as a filter principal an entry selects its own cost; one
+   * with an empty source_system needs source_systems [""] beside it, as a filter's empty source means any.
+   */
+  principals: SpendForecastPrincipal[];
 }
 
 export interface SpendForecastBreakdown {
@@ -1746,6 +1753,12 @@ export interface SpendForecastGroup {
   measures: SpendForecastMeasures | undefined;
 }
 
+/** SpendForecastPrincipal is one principal's cost, on the source system that reported it. */
+export interface SpendForecastPrincipal {
+  principal: DailyActivityPrincipal | undefined;
+  measures: SpendForecastMeasures | undefined;
+}
+
 export interface SpendForecastMeasures {
   monthToDateUsd: number;
   /** absent when history_weeks is 0 */
@@ -2107,6 +2120,7 @@ export interface AIFileRow {
   lastPushedAt: Date | undefined;
   discardedAt: Date | undefined;
   discardReason: string;
+  /** The kept checkout copies' stored edit counts summed; 4294967295 means at least that many. */
   editCount: number;
   /** unique, sorted by (source_system, session_id) */
   sessions: AISessionRef[];
@@ -2184,8 +2198,10 @@ export interface FileTiers {
 }
 
 export interface FileTierBucket {
+  /** distinct (repository_key, ref, path) with a copy in the bucket */
   files: number;
   branches: number;
+  /** distinct (source_system, session_id) across the bucket's copies */
   sessions: number;
   costUsd: number;
   outputTokens: number;
@@ -12048,7 +12064,7 @@ export const SpendForecastRequest: MessageFns<SpendForecastRequest> = {
 };
 
 function createBaseSpendForecastFilter(): SpendForecastFilter {
-  return { fundingModes: [] };
+  return { fundingModes: [], sourceSystems: [], principals: [] };
 }
 
 export const SpendForecastFilter: MessageFns<SpendForecastFilter> = {
@@ -12056,6 +12072,12 @@ export const SpendForecastFilter: MessageFns<SpendForecastFilter> = {
     for (const v of message.fundingModes) {
       writer.uint32(8).int32(v!);
     }
+    for (const v of message.sourceSystems) {
+      writer.uint32(18).string(v!);
+    }
+    for (const v of message.principals) {
+      DailyActivityPrincipal.encode(v!, writer.uint32(26).fork()).join();
+    }
     return writer;
   },
 
@@ -12090,6 +12112,22 @@ export const SpendForecastFilter: MessageFns<SpendForecastFilter> = {
 
             break;
           }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.sourceSystems.push(reader.string());
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.principals.push(DailyActivityPrincipal.decode(reader, reader.uint32()));
+            continue;
+          }
         }
         if ((tag & 7) === 4 || tag === 0) {
           break;
@@ -12109,6 +12147,14 @@ export const SpendForecastFilter: MessageFns<SpendForecastFilter> = {
         : globalThis.Array.isArray(object?.funding_modes)
         ? object.funding_modes.map((e: any) => aIFundingModeFromJSON(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))
+        : [],
+      principals: globalThis.Array.isArray(object?.principals)
+        ? object.principals.map((e: any) => DailyActivityPrincipal.fromJSON(e))
+        : [],
     };
   },
 
@@ -12117,6 +12163,12 @@ export const SpendForecastFilter: MessageFns<SpendForecastFilter> = {
     if (message.fundingModes?.length) {
       obj.fundingModes = message.fundingModes.map((e) => aIFundingModeToJSON(e));
     }
+    if (message.sourceSystems?.length) {
+      obj.sourceSystems = message.sourceSystems;
+    }
+    if (message.principals?.length) {
+      obj.principals = message.principals.map((e) => DailyActivityPrincipal.toJSON(e));
+    }
     return obj;
   },
 
@@ -12126,6 +12178,8 @@ export const SpendForecastFilter: MessageFns<SpendForecastFilter> = {
   fromPartial<I extends Exact<DeepPartial<SpendForecastFilter>, I>>(object: I): SpendForecastFilter {
     const message = createBaseSpendForecastFilter();
     message.fundingModes = object.fundingModes?.map((e) => e) || [];
+    message.sourceSystems = object.sourceSystems?.map((e) => e) || [];
+    message.principals = object.principals?.map((e) => DailyActivityPrincipal.fromPartial(e)) || [];
     return message;
   },
 };
@@ -12140,6 +12194,7 @@ function createBaseSpendForecast(): SpendForecast {
     total: undefined,
     breakdowns: [],
     asOf: undefined,
+    principals: [],
   };
 }
 
@@ -12169,6 +12224,9 @@ export const SpendForecast: MessageFns<SpendForecast> = {
     if (message.asOf !== undefined) {
       Timestamp.encode(toTimestamp(message.asOf), writer.uint32(66).fork()).join();
     }
+    for (const v of message.principals) {
+      SpendForecastPrincipal.encode(v!, writer.uint32(74).fork()).join();
+    }
     return writer;
   },
 
@@ -12249,6 +12307,14 @@ export const SpendForecast: MessageFns<SpendForecast> = {
             message.asOf = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
             continue;
           }
+          case 9: {
+            if (tag !== 74) {
+              break;
+            }
+
+            message.principals.push(SpendForecastPrincipal.decode(reader, reader.uint32()));
+            continue;
+          }
         }
         if ((tag & 7) === 4 || tag === 0) {
           break;
@@ -12293,6 +12359,9 @@ export const SpendForecast: MessageFns<SpendForecast> = {
         : isSet(object.as_of)
         ? fromJsonTimestamp(object.as_of)
         : undefined,
+      principals: globalThis.Array.isArray(object?.principals)
+        ? object.principals.map((e: any) => SpendForecastPrincipal.fromJSON(e))
+        : [],
     };
   },
 
@@ -12322,6 +12391,9 @@ export const SpendForecast: MessageFns<SpendForecast> = {
     if (message.asOf !== undefined) {
       obj.asOf = message.asOf.toISOString();
     }
+    if (message.principals?.length) {
+      obj.principals = message.principals.map((e) => SpendForecastPrincipal.toJSON(e));
+    }
     return obj;
   },
 
@@ -12340,6 +12412,7 @@ export const SpendForecast: MessageFns<SpendForecast> = {
       : undefined;
     message.breakdowns = object.breakdowns?.map((e) => SpendForecastBreakdown.fromPartial(e)) || [];
     message.asOf = object.asOf ?? undefined;
+    message.principals = object.principals?.map((e) => SpendForecastPrincipal.fromPartial(e)) || [];
     return message;
   },
 };
@@ -12518,6 +12591,95 @@ export const SpendForecastGroup: MessageFns<SpendForecastGroup> = {
   },
 };
 
+function createBaseSpendForecastPrincipal(): SpendForecastPrincipal {
+  return { principal: undefined, measures: undefined };
+}
+
+export const SpendForecastPrincipal: MessageFns<SpendForecastPrincipal> = {
+  encode(message: SpendForecastPrincipal, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.principal !== undefined) {
+      DailyActivityPrincipal.encode(message.principal, writer.uint32(10).fork()).join();
+    }
+    if (message.measures !== undefined) {
+      SpendForecastMeasures.encode(message.measures, writer.uint32(18).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): SpendForecastPrincipal {
+    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 = createBaseSpendForecastPrincipal();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.principal = DailyActivityPrincipal.decode(reader, reader.uint32());
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.measures = SpendForecastMeasures.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): SpendForecastPrincipal {
+    return {
+      principal: isSet(object.principal) ? DailyActivityPrincipal.fromJSON(object.principal) : undefined,
+      measures: isSet(object.measures) ? SpendForecastMeasures.fromJSON(object.measures) : undefined,
+    };
+  },
+
+  toJSON(message: SpendForecastPrincipal): unknown {
+    const obj: any = {};
+    if (message.principal !== undefined) {
+      obj.principal = DailyActivityPrincipal.toJSON(message.principal);
+    }
+    if (message.measures !== undefined) {
+      obj.measures = SpendForecastMeasures.toJSON(message.measures);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<SpendForecastPrincipal>, I>>(base?: I): SpendForecastPrincipal {
+    return SpendForecastPrincipal.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<SpendForecastPrincipal>, I>>(object: I): SpendForecastPrincipal {
+    const message = createBaseSpendForecastPrincipal();
+    message.principal = (object.principal !== undefined && object.principal !== null)
+      ? DailyActivityPrincipal.fromPartial(object.principal)
+      : undefined;
+    message.measures = (object.measures !== undefined && object.measures !== null)
+      ? SpendForecastMeasures.fromPartial(object.measures)
+      : undefined;
+    return message;
+  },
+};
+
 function createBaseSpendForecastMeasures(): SpendForecastMeasures {
   return { monthToDateUsd: 0, projection: undefined };
 }
@@ -22557,9 +22719,9 @@ export interface AIGatewayService {
   StreamDailyActivity(request: DailyActivityRequest, metadata?: Metadata): Observable<DailyActivity>;
   /**
    * Live current-UTC-month spend forecast: month-to-date cost and the projected month-end total (a band from
-   * replaying recent weeks), for the project and per model, provider, source system, user and api key, off the
-   * same daily rollup as StreamDailyActivity; filter.funding_modes forecasts the cost on the listed funding modes. Mirrors
-   * telemetry.api.v1.
+   * replaying recent weeks), for the project, per model, provider and source system, and per principal, off the
+   * same daily rollup as StreamDailyActivity; the filter narrows it by funding mode, source system and principal.
+   * Mirrors telemetry.api.v1.
    */
   StreamSpendForecast(request: SpendForecastRequest, metadata?: Metadata): Observable<SpendForecast>;
   /**
@@ -22579,8 +22741,8 @@ export interface AIGatewayService {
   StreamProjectSummaries(request: ProjectSummariesRequest, metadata?: Metadata): Observable<ProjectSummaries>;
   /**
    * Per-file working-state feed (keyset-paginated) behind the unlanded-work funnel: one row per
-   * (repository_key, ref, path) the AI edited (with filter.sessions or filter.paths, one they name), its
-   * most-edited checkout copy among those the filter keeps. Mirrors telemetry.api.v1.
+   * (repository_key, ref, path) the AI edited (with filter.sessions or filter.paths, one they name): its kept
+   * checkout copies' edits, costs and tokens added up, its state from the most-edited copy. Mirrors telemetry.api.v1.
    */
   ListFiles(request: ListFilesRequest, metadata?: Metadata): Promise<ListFilesResponse>;
   /**
@@ -22590,7 +22752,8 @@ export interface AIGatewayService {
   ListFileDirectories(request: ListFileDirectoriesRequest, metadata?: Metadata): Promise<ListFileDirectoriesResponse>;
   /**
    * Live stream of the unlanded-work funnel: aging tiers + discarded (git-invisible churn), a complete
-   * snapshot re-derived each tick. Counts every checkout copy, edited or not.
+   * snapshot re-derived each tick. Every checkout copy, edited or not, lands in its own bucket; files and
+   * sessions are distinct counts, so they do not add up across buckets or groups. Mirrors telemetry.api.v1.
    */
   StreamFilesSummary(request: FilesSummaryRequest, metadata?: Metadata): Observable<FilesSummary>;
   /** Latest observed list price per catalog listing from the global catalog, under stored names. */

package/proto/gateway/web/v1/ai_gateway_grpc_pb.js

@@ -774,9 +774,9 @@ streamDailyActivity: {
     responseDeserialize: deserialize_gateway_web_v1_DailyActivity,
   },
   // Live current-UTC-month spend forecast: month-to-date cost and the projected month-end total (a band from
-// replaying recent weeks), for the project and per model, provider, source system, user and api key, off the
-// same daily rollup as StreamDailyActivity; filter.funding_modes forecasts the cost on the listed funding modes. Mirrors
-// telemetry.api.v1.
+// replaying recent weeks), for the project, per model, provider and source system, and per principal, off the
+// same daily rollup as StreamDailyActivity; the filter narrows it by funding mode, source system and principal.
+// Mirrors telemetry.api.v1.
 streamSpendForecast: {
     path: '/gateway.web.v1.AIGatewayService/StreamSpendForecast',
     requestStream: false,
@@ -828,8 +828,8 @@ streamProjectSummaries: {
     responseDeserialize: deserialize_gateway_web_v1_ProjectSummaries,
   },
   // Per-file working-state feed (keyset-paginated) behind the unlanded-work funnel: one row per
-// (repository_key, ref, path) the AI edited (with filter.sessions or filter.paths, one they name), its
-// most-edited checkout copy among those the filter keeps. Mirrors telemetry.api.v1.
+// (repository_key, ref, path) the AI edited (with filter.sessions or filter.paths, one they name): its kept
+// checkout copies' edits, costs and tokens added up, its state from the most-edited copy. Mirrors telemetry.api.v1.
 listFiles: {
     path: '/gateway.web.v1.AIGatewayService/ListFiles',
     requestStream: false,
@@ -855,7 +855,8 @@ listFileDirectories: {
     responseDeserialize: deserialize_gateway_web_v1_ListFileDirectoriesResponse,
   },
   // Live stream of the unlanded-work funnel: aging tiers + discarded (git-invisible churn), a complete
-// snapshot re-derived each tick. Counts every checkout copy, edited or not.
+// snapshot re-derived each tick. Every checkout copy, edited or not, lands in its own bucket; files and
+// sessions are distinct counts, so they do not add up across buckets or groups. Mirrors telemetry.api.v1.
 streamFilesSummary: {
     path: '/gateway.web.v1.AIGatewayService/StreamFilesSummary',
     requestStream: false,

package/proto/gateway/web/v1/ai_gateway_pb.js

@@ -151,6 +151,7 @@ goog.exportSymbol('proto.gateway.web.v1.SpendForecastBreakdown', null, global);
 goog.exportSymbol('proto.gateway.web.v1.SpendForecastFilter', null, global);
 goog.exportSymbol('proto.gateway.web.v1.SpendForecastGroup', null, global);
 goog.exportSymbol('proto.gateway.web.v1.SpendForecastMeasures', null, global);
+goog.exportSymbol('proto.gateway.web.v1.SpendForecastPrincipal', null, global);
 goog.exportSymbol('proto.gateway.web.v1.SpendForecastRequest', null, global);
 goog.exportSymbol('proto.gateway.web.v1.SpendProjection', null, global);
 goog.exportSymbol('proto.gateway.web.v1.StreamEntitlementsRequest', null, global);
@@ -1401,6 +1402,27 @@ if (goog.DEBUG && !COMPILED) {
    */
   proto.gateway.web.v1.SpendForecastGroup.displayName = 'proto.gateway.web.v1.SpendForecastGroup';
 }
+/**
+ * Generated by JsPbCodeGenerator.
+ * @param {Array=} opt_data Optional initial data array, typically from a
+ * server response, or constructed directly in Javascript. The array is used
+ * in place and becomes part of the constructed object. It is not cloned.
+ * If no data is provided, the constructed object will be empty, but still
+ * valid.
+ * @extends {jspb.Message}
+ * @constructor
+ */
+proto.gateway.web.v1.SpendForecastPrincipal = function(opt_data) {
+  jspb.Message.initialize(this, opt_data, 0, -1, null, null);
+};
+goog.inherits(proto.gateway.web.v1.SpendForecastPrincipal, jspb.Message);
+if (goog.DEBUG && !COMPILED) {
+  /**
+   * @public
+   * @override
+   */
+  proto.gateway.web.v1.SpendForecastPrincipal.displayName = 'proto.gateway.web.v1.SpendForecastPrincipal';
+}
 /**
  * Generated by JsPbCodeGenerator.
  * @param {Array=} opt_data Optional initial data array, typically from a
@@ -20956,7 +20978,7 @@ proto.gateway.web.v1.SpendForecastRequest.prototype.hasFilter = function() {
  * @private {!Array<number>}
  * @const
  */
-proto.gateway.web.v1.SpendForecastFilter.repeatedFields_ = [1];
+proto.gateway.web.v1.SpendForecastFilter.repeatedFields_ = [1,2,3];
 
 
 
@@ -20989,7 +21011,10 @@ proto.gateway.web.v1.SpendForecastFilter.prototype.toObject = function(opt_inclu
  */
 proto.gateway.web.v1.SpendForecastFilter.toObject = function(includeInstance, msg) {
   var f, obj = {
-fundingModesList: (f = jspb.Message.getRepeatedField(msg, 1)) == null ? undefined : f
+fundingModesList: (f = jspb.Message.getRepeatedField(msg, 1)) == null ? undefined : f,
+sourceSystemsList: (f = jspb.Message.getRepeatedField(msg, 2)) == null ? undefined : f,
+principalsList: jspb.Message.toObjectList(msg.getPrincipalsList(),
+    proto.gateway.web.v1.DailyActivityPrincipal.toObject, includeInstance)
   };
 
   if (includeInstance) {
@@ -21029,6 +21054,15 @@ proto.gateway.web.v1.SpendForecastFilter.deserializeBinaryFromReader = function(
     case 1:
       reader.readPackableEnumInto(msg.getFundingModesList());
       break;
+    case 2:
+      var value = /** @type {string} */ (reader.readStringRequireUtf8());
+      msg.addSourceSystems(value);
+      break;
+    case 3:
+      var value = new proto.gateway.web.v1.DailyActivityPrincipal;
+      reader.readMessage(value,proto.gateway.web.v1.DailyActivityPrincipal.deserializeBinaryFromReader);
+      msg.addPrincipals(value);
+      break;
     default:
       reader.skipField();
       break;
@@ -21065,6 +21099,21 @@ proto.gateway.web.v1.SpendForecastFilter.serializeBinaryToWriter = function(mess
       f
     );
   }
+  f = message.getSourceSystemsList();
+  if (f.length > 0) {
+    writer.writeRepeatedString(
+      2,
+      f
+    );
+  }
+  f = message.getPrincipalsList();
+  if (f.length > 0) {
+    writer.writeRepeatedMessage(
+      3,
+      f,
+      proto.gateway.web.v1.DailyActivityPrincipal.serializeBinaryToWriter
+    );
+  }
 };
 
 
@@ -21105,13 +21154,88 @@ proto.gateway.web.v1.SpendForecastFilter.prototype.clearFundingModesList = funct
 };
 
 
+/**
+ * repeated string source_systems = 2;
+ * @return {!Array<string>}
+ */
+proto.gateway.web.v1.SpendForecastFilter.prototype.getSourceSystemsList = function() {
+  return /** @type {!Array<string>} */ (jspb.Message.getRepeatedField(this, 2));
+};
+
+
+/**
+ * @param {!Array<string>} value
+ * @return {!proto.gateway.web.v1.SpendForecastFilter} returns this
+ */
+proto.gateway.web.v1.SpendForecastFilter.prototype.setSourceSystemsList = function(value) {
+  return jspb.Message.setField(this, 2, value || []);
+};
+
+
+/**
+ * @param {string} value
+ * @param {number=} opt_index
+ * @return {!proto.gateway.web.v1.SpendForecastFilter} returns this
+ */
+proto.gateway.web.v1.SpendForecastFilter.prototype.addSourceSystems = function(value, opt_index) {
+  return jspb.Message.addToRepeatedField(this, 2, value, opt_index);
+};
+
+
+/**
+ * Clears the list making it empty but non-null.
+ * @return {!proto.gateway.web.v1.SpendForecastFilter} returns this
+ */
+proto.gateway.web.v1.SpendForecastFilter.prototype.clearSourceSystemsList = function() {
+  return this.setSourceSystemsList([]);
+};
+
+
+/**
+ * repeated DailyActivityPrincipal principals = 3;
+ * @return {!Array<!proto.gateway.web.v1.DailyActivityPrincipal>}
+ */
+proto.gateway.web.v1.SpendForecastFilter.prototype.getPrincipalsList = function() {
+  return /** @type{!Array<!proto.gateway.web.v1.DailyActivityPrincipal>} */ (
+    jspb.Message.getRepeatedWrapperField(this, proto.gateway.web.v1.DailyActivityPrincipal, 3));
+};
+
+
+/**
+ * @param {!Array<!proto.gateway.web.v1.DailyActivityPrincipal>} value
+ * @return {!proto.gateway.web.v1.SpendForecastFilter} returns this
+*/
+proto.gateway.web.v1.SpendForecastFilter.prototype.setPrincipalsList = function(value) {
+  return jspb.Message.setRepeatedWrapperField(this, 3, value);
+};
+
+
+/**
+ * @param {!proto.gateway.web.v1.DailyActivityPrincipal=} opt_value
+ * @param {number=} opt_index
+ * @return {!proto.gateway.web.v1.DailyActivityPrincipal}
+ */
+proto.gateway.web.v1.SpendForecastFilter.prototype.addPrincipals = function(opt_value, opt_index) {
+  return jspb.Message.addToRepeatedWrapperField(this, 3, opt_value, proto.gateway.web.v1.DailyActivityPrincipal, opt_index);
+};
+
+
+/**
+ * Clears the list making it empty but non-null.
+ * @return {!proto.gateway.web.v1.SpendForecastFilter} returns this
+ */
+proto.gateway.web.v1.SpendForecastFilter.prototype.clearPrincipalsList = function() {
+  return this.setPrincipalsList([]);
+};
+
+
 
 /**
  * List of repeated fields within this message type.
  * @private {!Array<number>}
  * @const
  */
-proto.gateway.web.v1.SpendForecast.repeatedFields_ = [7];
+proto.gateway.web.v1.SpendForecast.repeatedFields_ = [7,9];
 
 
 
@@ -21152,7 +21276,9 @@ historyWeeks: jspb.Message.getFieldWithDefault(msg, 5, 0),
 total: (f = msg.getTotal()) && proto.gateway.web.v1.SpendForecastMeasures.toObject(includeInstance, f),
 breakdownsList: jspb.Message.toObjectList(msg.getBreakdownsList(),
     proto.gateway.web.v1.SpendForecastBreakdown.toObject, includeInstance),
-asOf: (f = msg.getAsOf()) && google_protobuf_timestamp_pb.Timestamp.toObject(includeInstance, f)
+asOf: (f = msg.getAsOf()) && google_protobuf_timestamp_pb.Timestamp.toObject(includeInstance, f),
+principalsList: jspb.Message.toObjectList(msg.getPrincipalsList(),
+    proto.gateway.web.v1.SpendForecastPrincipal.toObject, includeInstance)
   };
 
   if (includeInstance) {
@@ -21224,6 +21350,11 @@ proto.gateway.web.v1.SpendForecast.deserializeBinaryFromReader = function(msg, r
       reader.readMessage(value,google_protobuf_timestamp_pb.Timestamp.deserializeBinaryFromReader);
       msg.setAsOf(value);
       break;
+    case 9:
+      var value = new proto.gateway.web.v1.SpendForecastPrincipal;
+      reader.readMessage(value,proto.gateway.web.v1.SpendForecastPrincipal.deserializeBinaryFromReader);
+      msg.addPrincipals(value);
+      break;
     default:
       reader.skipField();
       break;
@@ -21312,6 +21443,14 @@ proto.gateway.web.v1.SpendForecast.serializeBinaryToWriter = function(message, w
       google_protobuf_timestamp_pb.Timestamp.serializeBinaryToWriter
     );
   }
+  f = message.getPrincipalsList();
+  if (f.length > 0) {
+    writer.writeRepeatedMessage(
+      9,
+      f,
+      proto.gateway.web.v1.SpendForecastPrincipal.serializeBinaryToWriter
+    );
+  }
 };
 
 
@@ -21517,6 +21656,44 @@ proto.gateway.web.v1.SpendForecast.prototype.hasAsOf = function() {
 };
 
 
+/**
+ * repeated SpendForecastPrincipal principals = 9;
+ * @return {!Array<!proto.gateway.web.v1.SpendForecastPrincipal>}
+ */
+proto.gateway.web.v1.SpendForecast.prototype.getPrincipalsList = function() {
+  return /** @type{!Array<!proto.gateway.web.v1.SpendForecastPrincipal>} */ (
+    jspb.Message.getRepeatedWrapperField(this, proto.gateway.web.v1.SpendForecastPrincipal, 9));
+};
+
+
+/**
+ * @param {!Array<!proto.gateway.web.v1.SpendForecastPrincipal>} value
+ * @return {!proto.gateway.web.v1.SpendForecast} returns this
+*/
+proto.gateway.web.v1.SpendForecast.prototype.setPrincipalsList = function(value) {
+  return jspb.Message.setRepeatedWrapperField(this, 9, value);
+};
+
+
+/**
+ * @param {!proto.gateway.web.v1.SpendForecastPrincipal=} opt_value
+ * @param {number=} opt_index
+ * @return {!proto.gateway.web.v1.SpendForecastPrincipal}
+ */
+proto.gateway.web.v1.SpendForecast.prototype.addPrincipals = function(opt_value, opt_index) {
+  return jspb.Message.addToRepeatedWrapperField(this, 9, opt_value, proto.gateway.web.v1.SpendForecastPrincipal, opt_index);
+};
+
+
+/**
+ * Clears the list making it empty but non-null.
+ * @return {!proto.gateway.web.v1.SpendForecast} returns this
+ */
+proto.gateway.web.v1.SpendForecast.prototype.clearPrincipalsList = function() {
+  return this.setPrincipalsList([]);
+};
+
+
 
 /**
  * List of repeated fields within this message type.
@@ -21891,6 +22068,208 @@ proto.gateway.web.v1.SpendForecastGroup.prototype.hasMeasures = function() {
 
 
 
+if (jspb.Message.GENERATE_TO_OBJECT) {
+/**
+ * Creates an object representation of this proto.
+ * Field names that are reserved in JavaScript and will be renamed to pb_name.
+ * Optional fields that are not set will be set to undefined.
+ * To access a reserved field use, foo.pb_<name>, eg, foo.pb_default.
+ * For the list of reserved names please see:
+ *     net/proto2/compiler/js/internal/generator.cc#kKeyword.
+ * @param {boolean=} opt_includeInstance Deprecated. whether to include the
+ *     JSPB instance for transitional soy proto support:
+ *     http://goto/soy-param-migration
+ * @return {!Object}
+ */
+proto.gateway.web.v1.SpendForecastPrincipal.prototype.toObject = function(opt_includeInstance) {
+  return proto.gateway.web.v1.SpendForecastPrincipal.toObject(opt_includeInstance, this);
+};
+
+
+/**
+ * Static version of the {@see toObject} method.
+ * @param {boolean|undefined} includeInstance Deprecated. Whether to include
+ *     the JSPB instance for transitional soy proto support:
+ *     http://goto/soy-param-migration
+ * @param {!proto.gateway.web.v1.SpendForecastPrincipal} msg The msg instance to transform.
+ * @return {!Object}
+ * @suppress {unusedLocalVariables} f is only used for nested messages
+ */
+proto.gateway.web.v1.SpendForecastPrincipal.toObject = function(includeInstance, msg) {
+  var f, obj = {
+principal: (f = msg.getPrincipal()) && proto.gateway.web.v1.DailyActivityPrincipal.toObject(includeInstance, f),
+measures: (f = msg.getMeasures()) && proto.gateway.web.v1.SpendForecastMeasures.toObject(includeInstance, f)
+  };
+
+  if (includeInstance) {
+    obj.$jspbMessageInstance = msg;
+  }
+  return obj;
+};
+}
+
+
+/**
+ * Deserializes binary data (in protobuf wire format).
+ * @param {jspb.binary.bytesource.ByteSource} bytes The bytes to deserialize.
+ * @return {!proto.gateway.web.v1.SpendForecastPrincipal}
+ */
+proto.gateway.web.v1.SpendForecastPrincipal.deserializeBinary = function(bytes) {
+  var reader = new jspb.BinaryReader(bytes);
+  var msg = new proto.gateway.web.v1.SpendForecastPrincipal;
+  return proto.gateway.web.v1.SpendForecastPrincipal.deserializeBinaryFromReader(msg, reader);
+};
+
+
+/**
+ * Deserializes binary data (in protobuf wire format) from the
+ * given reader into the given message object.
+ * @param {!proto.gateway.web.v1.SpendForecastPrincipal} msg The message object to deserialize into.
+ * @param {!jspb.BinaryReader} reader The BinaryReader to use.
+ * @return {!proto.gateway.web.v1.SpendForecastPrincipal}
+ */
+proto.gateway.web.v1.SpendForecastPrincipal.deserializeBinaryFromReader = function(msg, reader) {
+  while (reader.nextField()) {
+    if (reader.isEndGroup()) {
+      break;
+    }
+    var field = reader.getFieldNumber();
+    switch (field) {
+    case 1:
+      var value = new proto.gateway.web.v1.DailyActivityPrincipal;
+      reader.readMessage(value,proto.gateway.web.v1.DailyActivityPrincipal.deserializeBinaryFromReader);
+      msg.setPrincipal(value);
+      break;
+    case 2:
+      var value = new proto.gateway.web.v1.SpendForecastMeasures;
+      reader.readMessage(value,proto.gateway.web.v1.SpendForecastMeasures.deserializeBinaryFromReader);
+      msg.setMeasures(value);
+      break;
+    default:
+      reader.skipField();
+      break;
+    }
+  }
+  return msg;
+};
+
+
+/**
+ * Serializes the message to binary data (in protobuf wire format).
+ * @return {!Uint8Array}
+ */
+proto.gateway.web.v1.SpendForecastPrincipal.prototype.serializeBinary = function() {
+  var writer = new jspb.BinaryWriter();
+  proto.gateway.web.v1.SpendForecastPrincipal.serializeBinaryToWriter(this, writer);
+  return writer.getResultBuffer();
+};
+
+
+/**
+ * Serializes the given message to binary data (in protobuf wire
+ * format), writing to the given BinaryWriter.
+ * @param {!proto.gateway.web.v1.SpendForecastPrincipal} message
+ * @param {!jspb.BinaryWriter} writer
+ * @suppress {unusedLocalVariables} f is only used for nested messages
+ */
+proto.gateway.web.v1.SpendForecastPrincipal.serializeBinaryToWriter = function(message, writer) {
+  var f = undefined;
+  f = message.getPrincipal();
+  if (f != null) {
+    writer.writeMessage(
+      1,
+      f,
+      proto.gateway.web.v1.DailyActivityPrincipal.serializeBinaryToWriter
+    );
+  }
+  f = message.getMeasures();
+  if (f != null) {
+    writer.writeMessage(
+      2,
+      f,
+      proto.gateway.web.v1.SpendForecastMeasures.serializeBinaryToWriter
+    );
+  }
+};
+
+
+/**
+ * optional DailyActivityPrincipal principal = 1;
+ * @return {?proto.gateway.web.v1.DailyActivityPrincipal}
+ */
+proto.gateway.web.v1.SpendForecastPrincipal.prototype.getPrincipal = function() {
+  return /** @type{?proto.gateway.web.v1.DailyActivityPrincipal} */ (
+    jspb.Message.getWrapperField(this, proto.gateway.web.v1.DailyActivityPrincipal, 1));
+};
+
+
+/**
+ * @param {?proto.gateway.web.v1.DailyActivityPrincipal|undefined} value
+ * @return {!proto.gateway.web.v1.SpendForecastPrincipal} returns this
+*/
+proto.gateway.web.v1.SpendForecastPrincipal.prototype.setPrincipal = function(value) {
+  return jspb.Message.setWrapperField(this, 1, value);
+};
+
+
+/**
+ * Clears the message field making it undefined.
+ * @return {!proto.gateway.web.v1.SpendForecastPrincipal} returns this
+ */
+proto.gateway.web.v1.SpendForecastPrincipal.prototype.clearPrincipal = function() {
+  return this.setPrincipal(undefined);
+};
+
+
+/**
+ * Returns whether this field is set.
+ * @return {boolean}
+ */
+proto.gateway.web.v1.SpendForecastPrincipal.prototype.hasPrincipal = function() {
+  return jspb.Message.getField(this, 1) != null;
+};
+
+
+/**
+ * optional SpendForecastMeasures measures = 2;
+ * @return {?proto.gateway.web.v1.SpendForecastMeasures}
+ */
+proto.gateway.web.v1.SpendForecastPrincipal.prototype.getMeasures = function() {
+  return /** @type{?proto.gateway.web.v1.SpendForecastMeasures} */ (
+    jspb.Message.getWrapperField(this, proto.gateway.web.v1.SpendForecastMeasures, 2));
+};
+
+
+/**
+ * @param {?proto.gateway.web.v1.SpendForecastMeasures|undefined} value
+ * @return {!proto.gateway.web.v1.SpendForecastPrincipal} returns this
+*/
+proto.gateway.web.v1.SpendForecastPrincipal.prototype.setMeasures = function(value) {
+  return jspb.Message.setWrapperField(this, 2, value);
+};
+
+
+/**
+ * Clears the message field making it undefined.
+ * @return {!proto.gateway.web.v1.SpendForecastPrincipal} returns this
+ */
+proto.gateway.web.v1.SpendForecastPrincipal.prototype.clearMeasures = function() {
+  return this.setMeasures(undefined);
+};
+
+
+/**
+ * Returns whether this field is set.
+ * @return {boolean}
+ */
+proto.gateway.web.v1.SpendForecastPrincipal.prototype.hasMeasures = function() {
+  return jspb.Message.getField(this, 2) != null;
+};
+
+
+
+
+
 if (jspb.Message.GENERATE_TO_OBJECT) {
 /**
  * Creates an object representation of this proto.
@@ -40975,9 +41354,7 @@ proto.gateway.web.v1.AISpendForecastDimension = {
   AI_SPEND_FORECAST_DIMENSION_UNSPECIFIED: 0,
   AI_SPEND_FORECAST_DIMENSION_MODEL: 1,
   AI_SPEND_FORECAST_DIMENSION_PROVIDER: 2,
-  AI_SPEND_FORECAST_DIMENSION_SOURCE_SYSTEM: 3,
-  AI_SPEND_FORECAST_DIMENSION_USER: 4,
-  AI_SPEND_FORECAST_DIMENSION_API_KEY: 5
+  AI_SPEND_FORECAST_DIMENSION_SOURCE_SYSTEM: 3
 };
 
 /**