@miradorlabs/web-grpc 3.36.0 → 3.36.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miradorlabs/web-grpc",
-  "version": "3.36.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

@@ -2120,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[];
@@ -2197,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;
@@ -22738,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>;
   /**
@@ -22749,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

@@ -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,