@miradorlabs/web-grpc 3.6.0 → 3.8.0

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

@@ -1409,6 +1409,29 @@ export interface DailyActivityRequest {
   /** Inclusive UTC calendar-day bounds, YYYY-MM-DD. end_date >= start_date. */
   startDate: string;
   endDate: string;
+  /** Optional slice; unset returns the whole project. */
+  filter: DailyActivityRequest_Filter | undefined;
+}
+
+/**
+ * Filter slices the calendar by stored names: OR within a list, AND across lists, empty = no filter, at
+ * most 500 entries each. A tool call or user message counts for its turn's model and provider; git
+ * activity and files for the model of the tool call that produced them; "" selects what recorded none.
+ * Work belongs to its user id, else its api key: an api-key principal matches only work with no user id.
+ */
+export interface DailyActivityRequest_Filter {
+  sourceSystems: string[];
+  models: string[];
+  providers: string[];
+  /** A principal with an empty id selects work that recorded neither a user id nor an api key. */
+  principals: DailyActivityPrincipal[];
+}
+
+/** DailyActivityPrincipal is one user id or api key, as one source system reported it (empty = any source). */
+export interface DailyActivityPrincipal {
+  kind: AIPrincipalKind;
+  id: string;
+  sourceSystem: string;
 }
 
 /**
@@ -1425,11 +1448,13 @@ export interface DailyActivity {
   asOf: Date | undefined;
 }
 
+/** principals are the ids with activity in the slice that day: a call's user id, else its api key. */
 export interface DailyActivityDay {
   /** YYYY-MM-DD UTC */
   day: string;
   measures: DailyActivityMeasures | undefined;
   provisional: boolean;
+  principals: DailyActivityPrincipal[];
 }
 
 /**
@@ -1462,6 +1487,8 @@ export interface DailyActivityMeasures {
   subscriptionFacilityCacheReadTokens: number;
   subscriptionFacilityCacheWriteTokens: number;
   subscriptionFacilityUsd: number;
+  /** distinct sessions with activity in the slice that day (exact to a few thousand, ~0.5% beyond) */
+  sessions: number;
 }
 
 export interface ActivityRhythmRequest {
@@ -1636,6 +1663,57 @@ export interface ModelActivityPrincipal {
   costUsd: number;
 }
 
+export interface SessionUsageTrendRequest {
+  organizationId: string;
+  projectId: string;
+  sourceSystem: string;
+  /** The session's routing-key partitions, 1 to 100, read as one session. */
+  sessionIds: string[];
+  /**
+   * Bucket width in seconds, > 0; buckets start at multiples of it since the Unix epoch (UTC). Widened to
+   * the next step of 1, 5, 10, 15, 30, 60, 120, 300, 600, 900, 1800, 3600, 7200, 10800, 21600, 43200 s or a
+   * whole number of days when the session would span more than 2000 buckets.
+   */
+  bucketSeconds: number;
+}
+
+export interface SessionUsageTrendResponse {
+  status:
+    | ResponseStatus
+    | undefined;
+  /** the width the buckets use */
+  bucketSeconds: number;
+  /** per (bucket, model), by bucket_start then model */
+  buckets: SessionUsageBucket[];
+  /** per (bucket, action), by bucket_start then action */
+  gitBuckets: SessionGitBucket[];
+}
+
+/**
+ * SessionUsageBucket: model is the stored name, '' when unreported; input_tokens is cache-inclusive, the
+ * cache fields are subsets.
+ */
+export interface SessionUsageBucket {
+  bucketStart: Date | undefined;
+  model: string;
+  modelCalls: number;
+  inputTokens: number;
+  outputTokens: number;
+  cacheReadTokens: number;
+  cacheWriteTokens: number;
+  costUsd: number;
+}
+
+/**
+ * SessionGitBucket: the stored action (commit, push, pr_create, pr_merge, …), counted as the session rollup
+ * counts it (known failures left out).
+ */
+export interface SessionGitBucket {
+  bucketStart: Date | undefined;
+  action: string;
+  count: number;
+}
+
 /** AISessionRef is a session's identity: two sources can issue the same session_id. */
 export interface AISessionRef {
   sourceSystem: string;
@@ -9870,7 +9948,7 @@ export const BurnRateMeasures: MessageFns<BurnRateMeasures> = {
 };
 
 function createBaseDailyActivityRequest(): DailyActivityRequest {
-  return { organizationId: "", projectId: "", startDate: "", endDate: "" };
+  return { organizationId: "", projectId: "", startDate: "", endDate: "", filter: undefined };
 }
 
 export const DailyActivityRequest: MessageFns<DailyActivityRequest> = {
@@ -9887,6 +9965,9 @@ export const DailyActivityRequest: MessageFns<DailyActivityRequest> = {
     if (message.endDate !== "") {
       writer.uint32(34).string(message.endDate);
     }
+    if (message.filter !== undefined) {
+      DailyActivityRequest_Filter.encode(message.filter, writer.uint32(42).fork()).join();
+    }
     return writer;
   },
 
@@ -9935,6 +10016,14 @@ export const DailyActivityRequest: MessageFns<DailyActivityRequest> = {
             message.endDate = reader.string();
             continue;
           }
+          case 5: {
+            if (tag !== 42) {
+              break;
+            }
+
+            message.filter = DailyActivityRequest_Filter.decode(reader, reader.uint32());
+            continue;
+          }
         }
         if ((tag & 7) === 4 || tag === 0) {
           break;
@@ -9969,6 +10058,7 @@ export const DailyActivityRequest: MessageFns<DailyActivityRequest> = {
         : isSet(object.end_date)
         ? globalThis.String(object.end_date)
         : "",
+      filter: isSet(object.filter) ? DailyActivityRequest_Filter.fromJSON(object.filter) : undefined,
     };
   },
 
@@ -9986,6 +10076,9 @@ export const DailyActivityRequest: MessageFns<DailyActivityRequest> = {
     if (message.endDate !== "") {
       obj.endDate = message.endDate;
     }
+    if (message.filter !== undefined) {
+      obj.filter = DailyActivityRequest_Filter.toJSON(message.filter);
+    }
     return obj;
   },
 
@@ -9998,6 +10091,239 @@ export const DailyActivityRequest: MessageFns<DailyActivityRequest> = {
     message.projectId = object.projectId ?? "";
     message.startDate = object.startDate ?? "";
     message.endDate = object.endDate ?? "";
+    message.filter = (object.filter !== undefined && object.filter !== null)
+      ? DailyActivityRequest_Filter.fromPartial(object.filter)
+      : undefined;
+    return message;
+  },
+};
+
+function createBaseDailyActivityRequest_Filter(): DailyActivityRequest_Filter {
+  return { sourceSystems: [], models: [], providers: [], principals: [] };
+}
+
+export const DailyActivityRequest_Filter: MessageFns<DailyActivityRequest_Filter> = {
+  encode(message: DailyActivityRequest_Filter, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    for (const v of message.sourceSystems) {
+      writer.uint32(10).string(v!);
+    }
+    for (const v of message.models) {
+      writer.uint32(18).string(v!);
+    }
+    for (const v of message.providers) {
+      writer.uint32(26).string(v!);
+    }
+    for (const v of message.principals) {
+      DailyActivityPrincipal.encode(v!, writer.uint32(34).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): DailyActivityRequest_Filter {
+    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 = createBaseDailyActivityRequest_Filter();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.sourceSystems.push(reader.string());
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.models.push(reader.string());
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.providers.push(reader.string());
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.principals.push(DailyActivityPrincipal.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): DailyActivityRequest_Filter {
+    return {
+      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))
+        : [],
+      models: globalThis.Array.isArray(object?.models) ? object.models.map((e: any) => globalThis.String(e)) : [],
+      providers: globalThis.Array.isArray(object?.providers)
+        ? object.providers.map((e: any) => globalThis.String(e))
+        : [],
+      principals: globalThis.Array.isArray(object?.principals)
+        ? object.principals.map((e: any) => DailyActivityPrincipal.fromJSON(e))
+        : [],
+    };
+  },
+
+  toJSON(message: DailyActivityRequest_Filter): unknown {
+    const obj: any = {};
+    if (message.sourceSystems?.length) {
+      obj.sourceSystems = message.sourceSystems;
+    }
+    if (message.models?.length) {
+      obj.models = message.models;
+    }
+    if (message.providers?.length) {
+      obj.providers = message.providers;
+    }
+    if (message.principals?.length) {
+      obj.principals = message.principals.map((e) => DailyActivityPrincipal.toJSON(e));
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<DailyActivityRequest_Filter>, I>>(base?: I): DailyActivityRequest_Filter {
+    return DailyActivityRequest_Filter.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<DailyActivityRequest_Filter>, I>>(object: I): DailyActivityRequest_Filter {
+    const message = createBaseDailyActivityRequest_Filter();
+    message.sourceSystems = object.sourceSystems?.map((e) => e) || [];
+    message.models = object.models?.map((e) => e) || [];
+    message.providers = object.providers?.map((e) => e) || [];
+    message.principals = object.principals?.map((e) => DailyActivityPrincipal.fromPartial(e)) || [];
+    return message;
+  },
+};
+
+function createBaseDailyActivityPrincipal(): DailyActivityPrincipal {
+  return { kind: 0, id: "", sourceSystem: "" };
+}
+
+export const DailyActivityPrincipal: MessageFns<DailyActivityPrincipal> = {
+  encode(message: DailyActivityPrincipal, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.kind !== 0) {
+      writer.uint32(8).int32(message.kind);
+    }
+    if (message.id !== "") {
+      writer.uint32(18).string(message.id);
+    }
+    if (message.sourceSystem !== "") {
+      writer.uint32(26).string(message.sourceSystem);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): DailyActivityPrincipal {
+    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 = createBaseDailyActivityPrincipal();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 8) {
+              break;
+            }
+
+            message.kind = reader.int32() as any;
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.id = reader.string();
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              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): DailyActivityPrincipal {
+    return {
+      kind: isSet(object.kind) ? aIPrincipalKindFromJSON(object.kind) : 0,
+      id: isSet(object.id) ? globalThis.String(object.id) : "",
+      sourceSystem: isSet(object.sourceSystem)
+        ? globalThis.String(object.sourceSystem)
+        : isSet(object.source_system)
+        ? globalThis.String(object.source_system)
+        : "",
+    };
+  },
+
+  toJSON(message: DailyActivityPrincipal): unknown {
+    const obj: any = {};
+    if (message.kind !== 0) {
+      obj.kind = aIPrincipalKindToJSON(message.kind);
+    }
+    if (message.id !== "") {
+      obj.id = message.id;
+    }
+    if (message.sourceSystem !== "") {
+      obj.sourceSystem = message.sourceSystem;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<DailyActivityPrincipal>, I>>(base?: I): DailyActivityPrincipal {
+    return DailyActivityPrincipal.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<DailyActivityPrincipal>, I>>(object: I): DailyActivityPrincipal {
+    const message = createBaseDailyActivityPrincipal();
+    message.kind = object.kind ?? 0;
+    message.id = object.id ?? "";
+    message.sourceSystem = object.sourceSystem ?? "";
     return message;
   },
 };
@@ -10168,7 +10494,7 @@ export const DailyActivity: MessageFns<DailyActivity> = {
 };
 
 function createBaseDailyActivityDay(): DailyActivityDay {
-  return { day: "", measures: undefined, provisional: false };
+  return { day: "", measures: undefined, provisional: false, principals: [] };
 }
 
 export const DailyActivityDay: MessageFns<DailyActivityDay> = {
@@ -10182,6 +10508,9 @@ export const DailyActivityDay: MessageFns<DailyActivityDay> = {
     if (message.provisional !== false) {
       writer.uint32(24).bool(message.provisional);
     }
+    for (const v of message.principals) {
+      DailyActivityPrincipal.encode(v!, writer.uint32(34).fork()).join();
+    }
     return writer;
   },
 
@@ -10222,6 +10551,14 @@ export const DailyActivityDay: MessageFns<DailyActivityDay> = {
             message.provisional = reader.bool();
             continue;
           }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.principals.push(DailyActivityPrincipal.decode(reader, reader.uint32()));
+            continue;
+          }
         }
         if ((tag & 7) === 4 || tag === 0) {
           break;
@@ -10239,6 +10576,9 @@ export const DailyActivityDay: MessageFns<DailyActivityDay> = {
       day: isSet(object.day) ? globalThis.String(object.day) : "",
       measures: isSet(object.measures) ? DailyActivityMeasures.fromJSON(object.measures) : undefined,
       provisional: isSet(object.provisional) ? globalThis.Boolean(object.provisional) : false,
+      principals: globalThis.Array.isArray(object?.principals)
+        ? object.principals.map((e: any) => DailyActivityPrincipal.fromJSON(e))
+        : [],
     };
   },
 
@@ -10253,6 +10593,9 @@ export const DailyActivityDay: MessageFns<DailyActivityDay> = {
     if (message.provisional !== false) {
       obj.provisional = message.provisional;
     }
+    if (message.principals?.length) {
+      obj.principals = message.principals.map((e) => DailyActivityPrincipal.toJSON(e));
+    }
     return obj;
   },
 
@@ -10266,6 +10609,7 @@ export const DailyActivityDay: MessageFns<DailyActivityDay> = {
       ? DailyActivityMeasures.fromPartial(object.measures)
       : undefined;
     message.provisional = object.provisional ?? false;
+    message.principals = object.principals?.map((e) => DailyActivityPrincipal.fromPartial(e)) || [];
     return message;
   },
 };
@@ -10291,6 +10635,7 @@ function createBaseDailyActivityMeasures(): DailyActivityMeasures {
     subscriptionFacilityCacheReadTokens: 0,
     subscriptionFacilityCacheWriteTokens: 0,
     subscriptionFacilityUsd: 0,
+    sessions: 0,
   };
 }
 
@@ -10353,6 +10698,9 @@ export const DailyActivityMeasures: MessageFns<DailyActivityMeasures> = {
     if (message.subscriptionFacilityUsd !== 0) {
       writer.uint32(153).double(message.subscriptionFacilityUsd);
     }
+    if (message.sessions !== 0) {
+      writer.uint32(160).uint64(message.sessions);
+    }
     return writer;
   },
 
@@ -10521,6 +10869,14 @@ export const DailyActivityMeasures: MessageFns<DailyActivityMeasures> = {
             message.subscriptionFacilityUsd = reader.double();
             continue;
           }
+          case 20: {
+            if (tag !== 160) {
+              break;
+            }
+
+            message.sessions = longToNumber(reader.uint64());
+            continue;
+          }
         }
         if ((tag & 7) === 4 || tag === 0) {
           break;
@@ -10626,6 +10982,7 @@ export const DailyActivityMeasures: MessageFns<DailyActivityMeasures> = {
         : isSet(object.subscription_facility_usd)
         ? globalThis.Number(object.subscription_facility_usd)
         : 0,
+      sessions: isSet(object.sessions) ? globalThis.Number(object.sessions) : 0,
     };
   },
 
@@ -10688,6 +11045,9 @@ export const DailyActivityMeasures: MessageFns<DailyActivityMeasures> = {
     if (message.subscriptionFacilityUsd !== 0) {
       obj.subscriptionFacilityUsd = message.subscriptionFacilityUsd;
     }
+    if (message.sessions !== 0) {
+      obj.sessions = Math.round(message.sessions);
+    }
     return obj;
   },
 
@@ -10715,6 +11075,7 @@ export const DailyActivityMeasures: MessageFns<DailyActivityMeasures> = {
     message.subscriptionFacilityCacheReadTokens = object.subscriptionFacilityCacheReadTokens ?? 0;
     message.subscriptionFacilityCacheWriteTokens = object.subscriptionFacilityCacheWriteTokens ?? 0;
     message.subscriptionFacilityUsd = object.subscriptionFacilityUsd ?? 0;
+    message.sessions = object.sessions ?? 0;
     return message;
   },
 };
@@ -13454,73 +13815,565 @@ export const ModelActivity: MessageFns<ModelActivity> = {
     if (message.subagentRuns !== 0) {
       obj.subagentRuns = Math.round(message.subagentRuns);
     }
-    if (message.ttftMsSum !== 0) {
-      obj.ttftMsSum = Math.round(message.ttftMsSum);
+    if (message.ttftMsSum !== 0) {
+      obj.ttftMsSum = Math.round(message.ttftMsSum);
+    }
+    if (message.ttftCalls !== 0) {
+      obj.ttftCalls = Math.round(message.ttftCalls);
+    }
+    if (message.providers?.length) {
+      obj.providers = message.providers;
+    }
+    if (message.principals?.length) {
+      obj.principals = message.principals.map((e) => ModelActivityPrincipal.toJSON(e));
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<ModelActivity>, I>>(base?: I): ModelActivity {
+    return ModelActivity.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ModelActivity>, I>>(object: I): ModelActivity {
+    const message = createBaseModelActivity();
+    message.key = object.key ?? "";
+    message.modelCalls = object.modelCalls ?? 0;
+    message.failedCalls = object.failedCalls ?? 0;
+    message.inputTokens = object.inputTokens ?? 0;
+    message.outputTokens = object.outputTokens ?? 0;
+    message.cacheReadTokens = object.cacheReadTokens ?? 0;
+    message.cacheWriteTokens = object.cacheWriteTokens ?? 0;
+    message.costUsd = object.costUsd ?? 0;
+    message.subscriptionCostUsd = object.subscriptionCostUsd ?? 0;
+    message.sessions = object.sessions ?? 0;
+    message.toolCalls = object.toolCalls ?? 0;
+    message.compactions = object.compactions ?? 0;
+    message.subagentRuns = object.subagentRuns ?? 0;
+    message.ttftMsSum = object.ttftMsSum ?? 0;
+    message.ttftCalls = object.ttftCalls ?? 0;
+    message.providers = object.providers?.map((e) => e) || [];
+    message.principals = object.principals?.map((e) => ModelActivityPrincipal.fromPartial(e)) || [];
+    return message;
+  },
+};
+
+function createBaseModelActivityPrincipal(): ModelActivityPrincipal {
+  return { kind: 0, id: "", sourceSystem: "", modelCalls: 0, sessions: 0, inputTokens: 0, outputTokens: 0, costUsd: 0 };
+}
+
+export const ModelActivityPrincipal: MessageFns<ModelActivityPrincipal> = {
+  encode(message: ModelActivityPrincipal, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.kind !== 0) {
+      writer.uint32(8).int32(message.kind);
+    }
+    if (message.id !== "") {
+      writer.uint32(18).string(message.id);
+    }
+    if (message.sourceSystem !== "") {
+      writer.uint32(26).string(message.sourceSystem);
+    }
+    if (message.modelCalls !== 0) {
+      writer.uint32(32).uint64(message.modelCalls);
+    }
+    if (message.sessions !== 0) {
+      writer.uint32(40).uint64(message.sessions);
+    }
+    if (message.inputTokens !== 0) {
+      writer.uint32(48).uint64(message.inputTokens);
+    }
+    if (message.outputTokens !== 0) {
+      writer.uint32(56).uint64(message.outputTokens);
+    }
+    if (message.costUsd !== 0) {
+      writer.uint32(65).double(message.costUsd);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ModelActivityPrincipal {
+    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 = createBaseModelActivityPrincipal();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 8) {
+              break;
+            }
+
+            message.kind = reader.int32() as any;
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.id = reader.string();
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.sourceSystem = reader.string();
+            continue;
+          }
+          case 4: {
+            if (tag !== 32) {
+              break;
+            }
+
+            message.modelCalls = longToNumber(reader.uint64());
+            continue;
+          }
+          case 5: {
+            if (tag !== 40) {
+              break;
+            }
+
+            message.sessions = longToNumber(reader.uint64());
+            continue;
+          }
+          case 6: {
+            if (tag !== 48) {
+              break;
+            }
+
+            message.inputTokens = longToNumber(reader.uint64());
+            continue;
+          }
+          case 7: {
+            if (tag !== 56) {
+              break;
+            }
+
+            message.outputTokens = longToNumber(reader.uint64());
+            continue;
+          }
+          case 8: {
+            if (tag !== 65) {
+              break;
+            }
+
+            message.costUsd = reader.double();
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): ModelActivityPrincipal {
+    return {
+      kind: isSet(object.kind) ? aIPrincipalKindFromJSON(object.kind) : 0,
+      id: isSet(object.id) ? globalThis.String(object.id) : "",
+      sourceSystem: isSet(object.sourceSystem)
+        ? globalThis.String(object.sourceSystem)
+        : isSet(object.source_system)
+        ? globalThis.String(object.source_system)
+        : "",
+      modelCalls: isSet(object.modelCalls)
+        ? globalThis.Number(object.modelCalls)
+        : isSet(object.model_calls)
+        ? globalThis.Number(object.model_calls)
+        : 0,
+      sessions: isSet(object.sessions) ? globalThis.Number(object.sessions) : 0,
+      inputTokens: isSet(object.inputTokens)
+        ? globalThis.Number(object.inputTokens)
+        : isSet(object.input_tokens)
+        ? globalThis.Number(object.input_tokens)
+        : 0,
+      outputTokens: isSet(object.outputTokens)
+        ? globalThis.Number(object.outputTokens)
+        : isSet(object.output_tokens)
+        ? globalThis.Number(object.output_tokens)
+        : 0,
+      costUsd: isSet(object.costUsd)
+        ? globalThis.Number(object.costUsd)
+        : isSet(object.cost_usd)
+        ? globalThis.Number(object.cost_usd)
+        : 0,
+    };
+  },
+
+  toJSON(message: ModelActivityPrincipal): unknown {
+    const obj: any = {};
+    if (message.kind !== 0) {
+      obj.kind = aIPrincipalKindToJSON(message.kind);
+    }
+    if (message.id !== "") {
+      obj.id = message.id;
+    }
+    if (message.sourceSystem !== "") {
+      obj.sourceSystem = message.sourceSystem;
+    }
+    if (message.modelCalls !== 0) {
+      obj.modelCalls = Math.round(message.modelCalls);
+    }
+    if (message.sessions !== 0) {
+      obj.sessions = Math.round(message.sessions);
+    }
+    if (message.inputTokens !== 0) {
+      obj.inputTokens = Math.round(message.inputTokens);
+    }
+    if (message.outputTokens !== 0) {
+      obj.outputTokens = Math.round(message.outputTokens);
+    }
+    if (message.costUsd !== 0) {
+      obj.costUsd = message.costUsd;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<ModelActivityPrincipal>, I>>(base?: I): ModelActivityPrincipal {
+    return ModelActivityPrincipal.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ModelActivityPrincipal>, I>>(object: I): ModelActivityPrincipal {
+    const message = createBaseModelActivityPrincipal();
+    message.kind = object.kind ?? 0;
+    message.id = object.id ?? "";
+    message.sourceSystem = object.sourceSystem ?? "";
+    message.modelCalls = object.modelCalls ?? 0;
+    message.sessions = object.sessions ?? 0;
+    message.inputTokens = object.inputTokens ?? 0;
+    message.outputTokens = object.outputTokens ?? 0;
+    message.costUsd = object.costUsd ?? 0;
+    return message;
+  },
+};
+
+function createBaseSessionUsageTrendRequest(): SessionUsageTrendRequest {
+  return { organizationId: "", projectId: "", sourceSystem: "", sessionIds: [], bucketSeconds: 0 };
+}
+
+export const SessionUsageTrendRequest: MessageFns<SessionUsageTrendRequest> = {
+  encode(message: SessionUsageTrendRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.organizationId !== "") {
+      writer.uint32(10).string(message.organizationId);
+    }
+    if (message.projectId !== "") {
+      writer.uint32(18).string(message.projectId);
+    }
+    if (message.sourceSystem !== "") {
+      writer.uint32(26).string(message.sourceSystem);
+    }
+    for (const v of message.sessionIds) {
+      writer.uint32(34).string(v!);
+    }
+    if (message.bucketSeconds !== 0) {
+      writer.uint32(40).uint32(message.bucketSeconds);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): SessionUsageTrendRequest {
+    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 = createBaseSessionUsageTrendRequest();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.organizationId = reader.string();
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.projectId = reader.string();
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.sourceSystem = reader.string();
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.sessionIds.push(reader.string());
+            continue;
+          }
+          case 5: {
+            if (tag !== 40) {
+              break;
+            }
+
+            message.bucketSeconds = 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): SessionUsageTrendRequest {
+    return {
+      organizationId: isSet(object.organizationId)
+        ? globalThis.String(object.organizationId)
+        : isSet(object.organization_id)
+        ? globalThis.String(object.organization_id)
+        : "",
+      projectId: isSet(object.projectId)
+        ? globalThis.String(object.projectId)
+        : isSet(object.project_id)
+        ? globalThis.String(object.project_id)
+        : "",
+      sourceSystem: isSet(object.sourceSystem)
+        ? globalThis.String(object.sourceSystem)
+        : isSet(object.source_system)
+        ? globalThis.String(object.source_system)
+        : "",
+      sessionIds: globalThis.Array.isArray(object?.sessionIds)
+        ? object.sessionIds.map((e: any) => globalThis.String(e))
+        : globalThis.Array.isArray(object?.session_ids)
+        ? object.session_ids.map((e: any) => globalThis.String(e))
+        : [],
+      bucketSeconds: isSet(object.bucketSeconds)
+        ? globalThis.Number(object.bucketSeconds)
+        : isSet(object.bucket_seconds)
+        ? globalThis.Number(object.bucket_seconds)
+        : 0,
+    };
+  },
+
+  toJSON(message: SessionUsageTrendRequest): unknown {
+    const obj: any = {};
+    if (message.organizationId !== "") {
+      obj.organizationId = message.organizationId;
+    }
+    if (message.projectId !== "") {
+      obj.projectId = message.projectId;
+    }
+    if (message.sourceSystem !== "") {
+      obj.sourceSystem = message.sourceSystem;
+    }
+    if (message.sessionIds?.length) {
+      obj.sessionIds = message.sessionIds;
+    }
+    if (message.bucketSeconds !== 0) {
+      obj.bucketSeconds = Math.round(message.bucketSeconds);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<SessionUsageTrendRequest>, I>>(base?: I): SessionUsageTrendRequest {
+    return SessionUsageTrendRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<SessionUsageTrendRequest>, I>>(object: I): SessionUsageTrendRequest {
+    const message = createBaseSessionUsageTrendRequest();
+    message.organizationId = object.organizationId ?? "";
+    message.projectId = object.projectId ?? "";
+    message.sourceSystem = object.sourceSystem ?? "";
+    message.sessionIds = object.sessionIds?.map((e) => e) || [];
+    message.bucketSeconds = object.bucketSeconds ?? 0;
+    return message;
+  },
+};
+
+function createBaseSessionUsageTrendResponse(): SessionUsageTrendResponse {
+  return { status: undefined, bucketSeconds: 0, buckets: [], gitBuckets: [] };
+}
+
+export const SessionUsageTrendResponse: MessageFns<SessionUsageTrendResponse> = {
+  encode(message: SessionUsageTrendResponse, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.status !== undefined) {
+      ResponseStatus.encode(message.status, writer.uint32(10).fork()).join();
+    }
+    if (message.bucketSeconds !== 0) {
+      writer.uint32(16).uint32(message.bucketSeconds);
+    }
+    for (const v of message.buckets) {
+      SessionUsageBucket.encode(v!, writer.uint32(26).fork()).join();
+    }
+    for (const v of message.gitBuckets) {
+      SessionGitBucket.encode(v!, writer.uint32(34).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): SessionUsageTrendResponse {
+    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 = createBaseSessionUsageTrendResponse();
+      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 !== 16) {
+              break;
+            }
+
+            message.bucketSeconds = reader.uint32();
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.buckets.push(SessionUsageBucket.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.gitBuckets.push(SessionGitBucket.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): SessionUsageTrendResponse {
+    return {
+      status: isSet(object.status) ? ResponseStatus.fromJSON(object.status) : undefined,
+      bucketSeconds: isSet(object.bucketSeconds)
+        ? globalThis.Number(object.bucketSeconds)
+        : isSet(object.bucket_seconds)
+        ? globalThis.Number(object.bucket_seconds)
+        : 0,
+      buckets: globalThis.Array.isArray(object?.buckets)
+        ? object.buckets.map((e: any) => SessionUsageBucket.fromJSON(e))
+        : [],
+      gitBuckets: globalThis.Array.isArray(object?.gitBuckets)
+        ? object.gitBuckets.map((e: any) => SessionGitBucket.fromJSON(e))
+        : globalThis.Array.isArray(object?.git_buckets)
+        ? object.git_buckets.map((e: any) => SessionGitBucket.fromJSON(e))
+        : [],
+    };
+  },
+
+  toJSON(message: SessionUsageTrendResponse): unknown {
+    const obj: any = {};
+    if (message.status !== undefined) {
+      obj.status = ResponseStatus.toJSON(message.status);
     }
-    if (message.ttftCalls !== 0) {
-      obj.ttftCalls = Math.round(message.ttftCalls);
+    if (message.bucketSeconds !== 0) {
+      obj.bucketSeconds = Math.round(message.bucketSeconds);
     }
-    if (message.providers?.length) {
-      obj.providers = message.providers;
+    if (message.buckets?.length) {
+      obj.buckets = message.buckets.map((e) => SessionUsageBucket.toJSON(e));
     }
-    if (message.principals?.length) {
-      obj.principals = message.principals.map((e) => ModelActivityPrincipal.toJSON(e));
+    if (message.gitBuckets?.length) {
+      obj.gitBuckets = message.gitBuckets.map((e) => SessionGitBucket.toJSON(e));
     }
     return obj;
   },
 
-  create<I extends Exact<DeepPartial<ModelActivity>, I>>(base?: I): ModelActivity {
-    return ModelActivity.fromPartial(base ?? ({} as any));
+  create<I extends Exact<DeepPartial<SessionUsageTrendResponse>, I>>(base?: I): SessionUsageTrendResponse {
+    return SessionUsageTrendResponse.fromPartial(base ?? ({} as any));
   },
-  fromPartial<I extends Exact<DeepPartial<ModelActivity>, I>>(object: I): ModelActivity {
-    const message = createBaseModelActivity();
-    message.key = object.key ?? "";
-    message.modelCalls = object.modelCalls ?? 0;
-    message.failedCalls = object.failedCalls ?? 0;
-    message.inputTokens = object.inputTokens ?? 0;
-    message.outputTokens = object.outputTokens ?? 0;
-    message.cacheReadTokens = object.cacheReadTokens ?? 0;
-    message.cacheWriteTokens = object.cacheWriteTokens ?? 0;
-    message.costUsd = object.costUsd ?? 0;
-    message.subscriptionCostUsd = object.subscriptionCostUsd ?? 0;
-    message.sessions = object.sessions ?? 0;
-    message.toolCalls = object.toolCalls ?? 0;
-    message.compactions = object.compactions ?? 0;
-    message.subagentRuns = object.subagentRuns ?? 0;
-    message.ttftMsSum = object.ttftMsSum ?? 0;
-    message.ttftCalls = object.ttftCalls ?? 0;
-    message.providers = object.providers?.map((e) => e) || [];
-    message.principals = object.principals?.map((e) => ModelActivityPrincipal.fromPartial(e)) || [];
+  fromPartial<I extends Exact<DeepPartial<SessionUsageTrendResponse>, I>>(object: I): SessionUsageTrendResponse {
+    const message = createBaseSessionUsageTrendResponse();
+    message.status = (object.status !== undefined && object.status !== null)
+      ? ResponseStatus.fromPartial(object.status)
+      : undefined;
+    message.bucketSeconds = object.bucketSeconds ?? 0;
+    message.buckets = object.buckets?.map((e) => SessionUsageBucket.fromPartial(e)) || [];
+    message.gitBuckets = object.gitBuckets?.map((e) => SessionGitBucket.fromPartial(e)) || [];
     return message;
   },
 };
 
-function createBaseModelActivityPrincipal(): ModelActivityPrincipal {
-  return { kind: 0, id: "", sourceSystem: "", modelCalls: 0, sessions: 0, inputTokens: 0, outputTokens: 0, costUsd: 0 };
+function createBaseSessionUsageBucket(): SessionUsageBucket {
+  return {
+    bucketStart: undefined,
+    model: "",
+    modelCalls: 0,
+    inputTokens: 0,
+    outputTokens: 0,
+    cacheReadTokens: 0,
+    cacheWriteTokens: 0,
+    costUsd: 0,
+  };
 }
 
-export const ModelActivityPrincipal: MessageFns<ModelActivityPrincipal> = {
-  encode(message: ModelActivityPrincipal, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
-    if (message.kind !== 0) {
-      writer.uint32(8).int32(message.kind);
-    }
-    if (message.id !== "") {
-      writer.uint32(18).string(message.id);
+export const SessionUsageBucket: MessageFns<SessionUsageBucket> = {
+  encode(message: SessionUsageBucket, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.bucketStart !== undefined) {
+      Timestamp.encode(toTimestamp(message.bucketStart), writer.uint32(10).fork()).join();
     }
-    if (message.sourceSystem !== "") {
-      writer.uint32(26).string(message.sourceSystem);
+    if (message.model !== "") {
+      writer.uint32(18).string(message.model);
     }
     if (message.modelCalls !== 0) {
-      writer.uint32(32).uint64(message.modelCalls);
-    }
-    if (message.sessions !== 0) {
-      writer.uint32(40).uint64(message.sessions);
+      writer.uint32(24).uint64(message.modelCalls);
     }
     if (message.inputTokens !== 0) {
-      writer.uint32(48).uint64(message.inputTokens);
+      writer.uint32(32).uint64(message.inputTokens);
     }
     if (message.outputTokens !== 0) {
-      writer.uint32(56).uint64(message.outputTokens);
+      writer.uint32(40).uint64(message.outputTokens);
+    }
+    if (message.cacheReadTokens !== 0) {
+      writer.uint32(48).uint64(message.cacheReadTokens);
+    }
+    if (message.cacheWriteTokens !== 0) {
+      writer.uint32(56).uint64(message.cacheWriteTokens);
     }
     if (message.costUsd !== 0) {
       writer.uint32(65).double(message.costUsd);
@@ -13528,7 +14381,7 @@ export const ModelActivityPrincipal: MessageFns<ModelActivityPrincipal> = {
     return writer;
   },
 
-  decode(input: BinaryReader | Uint8Array, length?: number): ModelActivityPrincipal {
+  decode(input: BinaryReader | Uint8Array, length?: number): SessionUsageBucket {
     const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
     const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
     if (previousRecursionDepth >= 100) {
@@ -13537,16 +14390,16 @@ export const ModelActivityPrincipal: MessageFns<ModelActivityPrincipal> = {
     (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
     try {
       const end = length === undefined ? reader.len : reader.pos + length;
-      const message = createBaseModelActivityPrincipal();
+      const message = createBaseSessionUsageBucket();
       while (reader.pos < end) {
         const tag = reader.uint32();
         switch (tag >>> 3) {
           case 1: {
-            if (tag !== 8) {
+            if (tag !== 10) {
               break;
             }
 
-            message.kind = reader.int32() as any;
+            message.bucketStart = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
             continue;
           }
           case 2: {
@@ -13554,15 +14407,15 @@ export const ModelActivityPrincipal: MessageFns<ModelActivityPrincipal> = {
               break;
             }
 
-            message.id = reader.string();
+            message.model = reader.string();
             continue;
           }
           case 3: {
-            if (tag !== 26) {
+            if (tag !== 24) {
               break;
             }
 
-            message.sourceSystem = reader.string();
+            message.modelCalls = longToNumber(reader.uint64());
             continue;
           }
           case 4: {
@@ -13570,7 +14423,7 @@ export const ModelActivityPrincipal: MessageFns<ModelActivityPrincipal> = {
               break;
             }
 
-            message.modelCalls = longToNumber(reader.uint64());
+            message.inputTokens = longToNumber(reader.uint64());
             continue;
           }
           case 5: {
@@ -13578,7 +14431,7 @@ export const ModelActivityPrincipal: MessageFns<ModelActivityPrincipal> = {
               break;
             }
 
-            message.sessions = longToNumber(reader.uint64());
+            message.outputTokens = longToNumber(reader.uint64());
             continue;
           }
           case 6: {
@@ -13586,7 +14439,7 @@ export const ModelActivityPrincipal: MessageFns<ModelActivityPrincipal> = {
               break;
             }
 
-            message.inputTokens = longToNumber(reader.uint64());
+            message.cacheReadTokens = longToNumber(reader.uint64());
             continue;
           }
           case 7: {
@@ -13594,7 +14447,7 @@ export const ModelActivityPrincipal: MessageFns<ModelActivityPrincipal> = {
               break;
             }
 
-            message.outputTokens = longToNumber(reader.uint64());
+            message.cacheWriteTokens = longToNumber(reader.uint64());
             continue;
           }
           case 8: {
@@ -13617,21 +14470,19 @@ export const ModelActivityPrincipal: MessageFns<ModelActivityPrincipal> = {
     }
   },
 
-  fromJSON(object: any): ModelActivityPrincipal {
+  fromJSON(object: any): SessionUsageBucket {
     return {
-      kind: isSet(object.kind) ? aIPrincipalKindFromJSON(object.kind) : 0,
-      id: isSet(object.id) ? globalThis.String(object.id) : "",
-      sourceSystem: isSet(object.sourceSystem)
-        ? globalThis.String(object.sourceSystem)
-        : isSet(object.source_system)
-        ? globalThis.String(object.source_system)
-        : "",
+      bucketStart: isSet(object.bucketStart)
+        ? fromJsonTimestamp(object.bucketStart)
+        : isSet(object.bucket_start)
+        ? fromJsonTimestamp(object.bucket_start)
+        : undefined,
+      model: isSet(object.model) ? globalThis.String(object.model) : "",
       modelCalls: isSet(object.modelCalls)
         ? globalThis.Number(object.modelCalls)
         : isSet(object.model_calls)
         ? globalThis.Number(object.model_calls)
         : 0,
-      sessions: isSet(object.sessions) ? globalThis.Number(object.sessions) : 0,
       inputTokens: isSet(object.inputTokens)
         ? globalThis.Number(object.inputTokens)
         : isSet(object.input_tokens)
@@ -13642,6 +14493,16 @@ export const ModelActivityPrincipal: MessageFns<ModelActivityPrincipal> = {
         : isSet(object.output_tokens)
         ? globalThis.Number(object.output_tokens)
         : 0,
+      cacheReadTokens: isSet(object.cacheReadTokens)
+        ? globalThis.Number(object.cacheReadTokens)
+        : isSet(object.cache_read_tokens)
+        ? globalThis.Number(object.cache_read_tokens)
+        : 0,
+      cacheWriteTokens: isSet(object.cacheWriteTokens)
+        ? globalThis.Number(object.cacheWriteTokens)
+        : isSet(object.cache_write_tokens)
+        ? globalThis.Number(object.cache_write_tokens)
+        : 0,
       costUsd: isSet(object.costUsd)
         ? globalThis.Number(object.costUsd)
         : isSet(object.cost_usd)
@@ -13650,52 +14511,157 @@ export const ModelActivityPrincipal: MessageFns<ModelActivityPrincipal> = {
     };
   },
 
-  toJSON(message: ModelActivityPrincipal): unknown {
+  toJSON(message: SessionUsageBucket): unknown {
     const obj: any = {};
-    if (message.kind !== 0) {
-      obj.kind = aIPrincipalKindToJSON(message.kind);
-    }
-    if (message.id !== "") {
-      obj.id = message.id;
+    if (message.bucketStart !== undefined) {
+      obj.bucketStart = message.bucketStart.toISOString();
     }
-    if (message.sourceSystem !== "") {
-      obj.sourceSystem = message.sourceSystem;
+    if (message.model !== "") {
+      obj.model = message.model;
     }
     if (message.modelCalls !== 0) {
       obj.modelCalls = Math.round(message.modelCalls);
     }
-    if (message.sessions !== 0) {
-      obj.sessions = Math.round(message.sessions);
-    }
     if (message.inputTokens !== 0) {
       obj.inputTokens = Math.round(message.inputTokens);
     }
     if (message.outputTokens !== 0) {
       obj.outputTokens = Math.round(message.outputTokens);
     }
+    if (message.cacheReadTokens !== 0) {
+      obj.cacheReadTokens = Math.round(message.cacheReadTokens);
+    }
+    if (message.cacheWriteTokens !== 0) {
+      obj.cacheWriteTokens = Math.round(message.cacheWriteTokens);
+    }
     if (message.costUsd !== 0) {
       obj.costUsd = message.costUsd;
     }
     return obj;
   },
 
-  create<I extends Exact<DeepPartial<ModelActivityPrincipal>, I>>(base?: I): ModelActivityPrincipal {
-    return ModelActivityPrincipal.fromPartial(base ?? ({} as any));
+  create<I extends Exact<DeepPartial<SessionUsageBucket>, I>>(base?: I): SessionUsageBucket {
+    return SessionUsageBucket.fromPartial(base ?? ({} as any));
   },
-  fromPartial<I extends Exact<DeepPartial<ModelActivityPrincipal>, I>>(object: I): ModelActivityPrincipal {
-    const message = createBaseModelActivityPrincipal();
-    message.kind = object.kind ?? 0;
-    message.id = object.id ?? "";
-    message.sourceSystem = object.sourceSystem ?? "";
+  fromPartial<I extends Exact<DeepPartial<SessionUsageBucket>, I>>(object: I): SessionUsageBucket {
+    const message = createBaseSessionUsageBucket();
+    message.bucketStart = object.bucketStart ?? undefined;
+    message.model = object.model ?? "";
     message.modelCalls = object.modelCalls ?? 0;
-    message.sessions = object.sessions ?? 0;
     message.inputTokens = object.inputTokens ?? 0;
     message.outputTokens = object.outputTokens ?? 0;
+    message.cacheReadTokens = object.cacheReadTokens ?? 0;
+    message.cacheWriteTokens = object.cacheWriteTokens ?? 0;
     message.costUsd = object.costUsd ?? 0;
     return message;
   },
 };
 
+function createBaseSessionGitBucket(): SessionGitBucket {
+  return { bucketStart: undefined, action: "", count: 0 };
+}
+
+export const SessionGitBucket: MessageFns<SessionGitBucket> = {
+  encode(message: SessionGitBucket, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.bucketStart !== undefined) {
+      Timestamp.encode(toTimestamp(message.bucketStart), writer.uint32(10).fork()).join();
+    }
+    if (message.action !== "") {
+      writer.uint32(18).string(message.action);
+    }
+    if (message.count !== 0) {
+      writer.uint32(24).uint64(message.count);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): SessionGitBucket {
+    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 = createBaseSessionGitBucket();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.bucketStart = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.action = reader.string();
+            continue;
+          }
+          case 3: {
+            if (tag !== 24) {
+              break;
+            }
+
+            message.count = longToNumber(reader.uint64());
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): SessionGitBucket {
+    return {
+      bucketStart: isSet(object.bucketStart)
+        ? fromJsonTimestamp(object.bucketStart)
+        : isSet(object.bucket_start)
+        ? fromJsonTimestamp(object.bucket_start)
+        : undefined,
+      action: isSet(object.action) ? globalThis.String(object.action) : "",
+      count: isSet(object.count) ? globalThis.Number(object.count) : 0,
+    };
+  },
+
+  toJSON(message: SessionGitBucket): unknown {
+    const obj: any = {};
+    if (message.bucketStart !== undefined) {
+      obj.bucketStart = message.bucketStart.toISOString();
+    }
+    if (message.action !== "") {
+      obj.action = message.action;
+    }
+    if (message.count !== 0) {
+      obj.count = Math.round(message.count);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<SessionGitBucket>, I>>(base?: I): SessionGitBucket {
+    return SessionGitBucket.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<SessionGitBucket>, I>>(object: I): SessionGitBucket {
+    const message = createBaseSessionGitBucket();
+    message.bucketStart = object.bucketStart ?? undefined;
+    message.action = object.action ?? "";
+    message.count = object.count ?? 0;
+    return message;
+  },
+};
+
 function createBaseAISessionRef(): AISessionRef {
   return { sourceSystem: "", sessionId: "" };
 }
@@ -17741,6 +18707,11 @@ export interface AIGatewayService {
    * costliest first. Mirrors telemetry.api.v1.
    */
   ListModelActivity(request: ModelActivityRequest, metadata?: Metadata): Promise<ModelActivityResponse>;
+  /**
+   * One session's model calls and git activity on one epoch-aligned time grid: per bucket, each model's
+   * calls, tokens and cost, and each git action's count. Mirrors telemetry.api.v1.
+   */
+  GetSessionUsageTrend(request: SessionUsageTrendRequest, metadata?: Metadata): Promise<SessionUsageTrendResponse>;
   /**
    * Per-seat entitlement usage board: every entitlement owner's latest observed funding facility and
    * per-harness usage % windows. Stream-first (first frame = full snapshot), seat-scoped. Mirrors
@@ -17777,6 +18748,7 @@ export class AIGatewayServiceClientImpl implements AIGatewayService {
     this.ListModelPriceHistory = this.ListModelPriceHistory.bind(this);
     this.ListResourceRankings = this.ListResourceRankings.bind(this);
     this.ListModelActivity = this.ListModelActivity.bind(this);
+    this.GetSessionUsageTrend = this.GetSessionUsageTrend.bind(this);
     this.StreamEntitlements = this.StreamEntitlements.bind(this);
   }
   ListSessions(request: ListSessionsRequest, metadata?: Metadata): Promise<ListSessionsResponse> {
@@ -17914,6 +18886,12 @@ export class AIGatewayServiceClientImpl implements AIGatewayService {
     return promise.then((data) => ModelActivityResponse.decode(new BinaryReader(data)));
   }
 
+  GetSessionUsageTrend(request: SessionUsageTrendRequest, metadata?: Metadata): Promise<SessionUsageTrendResponse> {
+    const data = SessionUsageTrendRequest.encode(request).finish();
+    const promise = this.rpc.request(this.service, "GetSessionUsageTrend", data, metadata);
+    return promise.then((data) => SessionUsageTrendResponse.decode(new BinaryReader(data)));
+  }
+
   StreamEntitlements(request: StreamEntitlementsRequest, metadata?: Metadata): Observable<EntitlementsSnapshot> {
     const data = StreamEntitlementsRequest.encode(request).finish();
     const result = this.rpc.serverStreamingRequest(this.service, "StreamEntitlements", data, metadata);