@miradorlabs/web-grpc 3.34.0 → 3.36.0

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 */
@@ -12048,7 +12061,7 @@ export const SpendForecastRequest: MessageFns<SpendForecastRequest> = {
 };
 
 function createBaseSpendForecastFilter(): SpendForecastFilter {
-  return { fundingModes: [] };
+  return { fundingModes: [], sourceSystems: [], principals: [] };
 }
 
 export const SpendForecastFilter: MessageFns<SpendForecastFilter> = {
@@ -12056,6 +12069,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 +12109,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 +12144,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 +12160,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 +12175,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 +12191,7 @@ function createBaseSpendForecast(): SpendForecast {
     total: undefined,
     breakdowns: [],
     asOf: undefined,
+    principals: [],
   };
 }
 
@@ -12169,6 +12221,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 +12304,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 +12356,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 +12388,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 +12409,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 +12588,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 +22716,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>;
   /**

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,