@miradorlabs/web-grpc 2.42.0 → 2.45.0

package/google/protobuf/timestamp.ts

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.12.2
+//   protoc-gen-ts_proto  v2.12.3
 //   protoc               v3.21.12
 // source: google/protobuf/timestamp.proto
 

package/package.json

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

package/proto/gateway/common/v1/attribute_value.ts

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.12.2
+//   protoc-gen-ts_proto  v2.12.3
 //   protoc               v3.21.12
 // source: proto/gateway/common/v1/attribute_value.proto
 

package/proto/gateway/common/v1/status.ts

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.12.2
+//   protoc-gen-ts_proto  v2.12.3
 //   protoc               v3.21.12
 // source: proto/gateway/common/v1/status.proto
 

package/proto/gateway/common/v1/types.ts

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.12.2
+//   protoc-gen-ts_proto  v2.12.3
 //   protoc               v3.21.12
 // source: proto/gateway/common/v1/types.proto
 

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

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.12.2
+//   protoc-gen-ts_proto  v2.12.3
 //   protoc               v3.21.12
 // source: proto/gateway/web/v1/account_gateway.proto
 

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

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.12.2
+//   protoc-gen-ts_proto  v2.12.3
 //   protoc               v3.21.12
 // source: proto/gateway/web/v1/ai_gateway.proto
 
@@ -257,11 +257,21 @@ export function aIGitOutcomeToJSON(object: AIGitOutcome): string {
 export interface ListSessionsRequest {
   organizationId: string;
   projectId: string;
+  /**
+   * Structured filter, built directly by the frontend (AIP-160 is a REST
+   * api-gateway concern and never reaches this proto).
+   */
   filter: AISessionFilter | undefined;
   pageSize: number;
   pageToken: string;
 }
 
+/**
+ * AISessionFilter selects sessions. Non-empty fields are ANDed; within a repeated
+ * field the values are ORed (any-of). id fields match by equality; model is
+ * membership. started_after/started_before are a half-open window over the
+ * session start time.
+ */
 export interface AISessionFilter {
   sourceSystem: string[];
   userId: string[];
@@ -302,6 +312,34 @@ export interface AISession {
   gitOrgs: string[];
   repositories: string[];
   filesTouched: number;
+  /** Content-derived rollup version; stale-frame guard for StreamSessions clients. */
+  sessionVersion: number;
+  /**
+   * Ingest-time creation (frozen) / latest ingest time — gateway wall-clock, not
+   * provider event time.
+   */
+  createdAt: Date | undefined;
+  updatedAt: Date | undefined;
+}
+
+export interface StreamSessionsRequest {
+  organizationId: string;
+  projectId: string;
+  /** Same structured filter as ListSessions (started_after/before live inside it). */
+  filter: AISessionFilter | undefined;
+}
+
+/**
+ * SessionFrame mirrors telemetry.api.v1.SessionFrame: an UPSERT of one session
+ * (keyed by routing_key + source_system) or a nonterminal
+ * SessionsSnapshotCompleted. Streams carry no ResponseStatus.
+ */
+export interface SessionFrame {
+  upsert?: AISession | undefined;
+  snapshotCompleted?: SessionsSnapshotCompleted | undefined;
+}
+
+export interface SessionsSnapshotCompleted {
 }
 
 export interface ListSessionEventsRequest {
@@ -358,6 +396,7 @@ export interface AIContentPart {
 export interface ListPrincipalsRequest {
   organizationId: string;
   projectId: string;
+  /** Structured filter (both optional, ANDed): kind and source_system, exact match. */
   kind?: AIPrincipalKind | undefined;
   sourceSystem: string;
   pageSize: number;
@@ -368,6 +407,8 @@ export interface ListPrincipalsResponse {
   status: ResponseStatus | undefined;
   principals: AIPrincipal[];
   nextPageToken: string;
+  /** Exact total for the filter, computed on the first page only. */
+  totalCount?: number | undefined;
 }
 
 export interface AIPrincipal {
@@ -940,6 +981,9 @@ function createBaseAISession(): AISession {
     gitOrgs: [],
     repositories: [],
     filesTouched: 0,
+    sessionVersion: 0,
+    createdAt: undefined,
+    updatedAt: undefined,
   };
 }
 
@@ -1014,6 +1058,15 @@ export const AISession: MessageFns<AISession> = {
     if (message.filesTouched !== 0) {
       writer.uint32(184).uint64(message.filesTouched);
     }
+    if (message.sessionVersion !== 0) {
+      writer.uint32(192).uint64(message.sessionVersion);
+    }
+    if (message.createdAt !== undefined) {
+      Timestamp.encode(toTimestamp(message.createdAt), writer.uint32(202).fork()).join();
+    }
+    if (message.updatedAt !== undefined) {
+      Timestamp.encode(toTimestamp(message.updatedAt), writer.uint32(210).fork()).join();
+    }
     return writer;
   },
 
@@ -1214,6 +1267,30 @@ export const AISession: MessageFns<AISession> = {
             message.filesTouched = longToNumber(reader.uint64());
             continue;
           }
+          case 24: {
+            if (tag !== 192) {
+              break;
+            }
+
+            message.sessionVersion = longToNumber(reader.uint64());
+            continue;
+          }
+          case 25: {
+            if (tag !== 202) {
+              break;
+            }
+
+            message.createdAt = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
+            continue;
+          }
+          case 26: {
+            if (tag !== 210) {
+              break;
+            }
+
+            message.updatedAt = fromTimestamp(Timestamp.decode(reader, reader.uint32()));
+            continue;
+          }
         }
         if ((tag & 7) === 4 || tag === 0) {
           break;
@@ -1325,6 +1402,21 @@ export const AISession: MessageFns<AISession> = {
         : isSet(object.files_touched)
         ? globalThis.Number(object.files_touched)
         : 0,
+      sessionVersion: isSet(object.sessionVersion)
+        ? globalThis.Number(object.sessionVersion)
+        : isSet(object.session_version)
+        ? globalThis.Number(object.session_version)
+        : 0,
+      createdAt: isSet(object.createdAt)
+        ? fromJsonTimestamp(object.createdAt)
+        : isSet(object.created_at)
+        ? fromJsonTimestamp(object.created_at)
+        : undefined,
+      updatedAt: isSet(object.updatedAt)
+        ? fromJsonTimestamp(object.updatedAt)
+        : isSet(object.updated_at)
+        ? fromJsonTimestamp(object.updated_at)
+        : undefined,
     };
   },
 
@@ -1399,6 +1491,15 @@ export const AISession: MessageFns<AISession> = {
     if (message.filesTouched !== 0) {
       obj.filesTouched = Math.round(message.filesTouched);
     }
+    if (message.sessionVersion !== 0) {
+      obj.sessionVersion = Math.round(message.sessionVersion);
+    }
+    if (message.createdAt !== undefined) {
+      obj.createdAt = message.createdAt.toISOString();
+    }
+    if (message.updatedAt !== undefined) {
+      obj.updatedAt = message.updatedAt.toISOString();
+    }
     return obj;
   },
 
@@ -1432,6 +1533,265 @@ export const AISession: MessageFns<AISession> = {
     message.gitOrgs = object.gitOrgs?.map((e) => e) || [];
     message.repositories = object.repositories?.map((e) => e) || [];
     message.filesTouched = object.filesTouched ?? 0;
+    message.sessionVersion = object.sessionVersion ?? 0;
+    message.createdAt = object.createdAt ?? undefined;
+    message.updatedAt = object.updatedAt ?? undefined;
+    return message;
+  },
+};
+
+function createBaseStreamSessionsRequest(): StreamSessionsRequest {
+  return { organizationId: "", projectId: "", filter: undefined };
+}
+
+export const StreamSessionsRequest: MessageFns<StreamSessionsRequest> = {
+  encode(message: StreamSessionsRequest, 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.filter !== undefined) {
+      AISessionFilter.encode(message.filter, writer.uint32(26).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): StreamSessionsRequest {
+    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 = createBaseStreamSessionsRequest();
+      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.filter = AISessionFilter.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): StreamSessionsRequest {
+    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)
+        : "",
+      filter: isSet(object.filter) ? AISessionFilter.fromJSON(object.filter) : undefined,
+    };
+  },
+
+  toJSON(message: StreamSessionsRequest): unknown {
+    const obj: any = {};
+    if (message.organizationId !== "") {
+      obj.organizationId = message.organizationId;
+    }
+    if (message.projectId !== "") {
+      obj.projectId = message.projectId;
+    }
+    if (message.filter !== undefined) {
+      obj.filter = AISessionFilter.toJSON(message.filter);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<StreamSessionsRequest>, I>>(base?: I): StreamSessionsRequest {
+    return StreamSessionsRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<StreamSessionsRequest>, I>>(object: I): StreamSessionsRequest {
+    const message = createBaseStreamSessionsRequest();
+    message.organizationId = object.organizationId ?? "";
+    message.projectId = object.projectId ?? "";
+    message.filter = (object.filter !== undefined && object.filter !== null)
+      ? AISessionFilter.fromPartial(object.filter)
+      : undefined;
+    return message;
+  },
+};
+
+function createBaseSessionFrame(): SessionFrame {
+  return { upsert: undefined, snapshotCompleted: undefined };
+}
+
+export const SessionFrame: MessageFns<SessionFrame> = {
+  encode(message: SessionFrame, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.upsert !== undefined) {
+      AISession.encode(message.upsert, writer.uint32(10).fork()).join();
+    }
+    if (message.snapshotCompleted !== undefined) {
+      SessionsSnapshotCompleted.encode(message.snapshotCompleted, writer.uint32(18).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): SessionFrame {
+    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 = createBaseSessionFrame();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.upsert = AISession.decode(reader, reader.uint32());
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.snapshotCompleted = SessionsSnapshotCompleted.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): SessionFrame {
+    return {
+      upsert: isSet(object.upsert) ? AISession.fromJSON(object.upsert) : undefined,
+      snapshotCompleted: isSet(object.snapshotCompleted)
+        ? SessionsSnapshotCompleted.fromJSON(object.snapshotCompleted)
+        : isSet(object.snapshot_completed)
+        ? SessionsSnapshotCompleted.fromJSON(object.snapshot_completed)
+        : undefined,
+    };
+  },
+
+  toJSON(message: SessionFrame): unknown {
+    const obj: any = {};
+    if (message.upsert !== undefined) {
+      obj.upsert = AISession.toJSON(message.upsert);
+    }
+    if (message.snapshotCompleted !== undefined) {
+      obj.snapshotCompleted = SessionsSnapshotCompleted.toJSON(message.snapshotCompleted);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<SessionFrame>, I>>(base?: I): SessionFrame {
+    return SessionFrame.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<SessionFrame>, I>>(object: I): SessionFrame {
+    const message = createBaseSessionFrame();
+    message.upsert = (object.upsert !== undefined && object.upsert !== null)
+      ? AISession.fromPartial(object.upsert)
+      : undefined;
+    message.snapshotCompleted = (object.snapshotCompleted !== undefined && object.snapshotCompleted !== null)
+      ? SessionsSnapshotCompleted.fromPartial(object.snapshotCompleted)
+      : undefined;
+    return message;
+  },
+};
+
+function createBaseSessionsSnapshotCompleted(): SessionsSnapshotCompleted {
+  return {};
+}
+
+export const SessionsSnapshotCompleted: MessageFns<SessionsSnapshotCompleted> = {
+  encode(_: SessionsSnapshotCompleted, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): SessionsSnapshotCompleted {
+    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 = createBaseSessionsSnapshotCompleted();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(_: any): SessionsSnapshotCompleted {
+    return {};
+  },
+
+  toJSON(_: SessionsSnapshotCompleted): unknown {
+    const obj: any = {};
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<SessionsSnapshotCompleted>, I>>(base?: I): SessionsSnapshotCompleted {
+    return SessionsSnapshotCompleted.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<SessionsSnapshotCompleted>, I>>(_: I): SessionsSnapshotCompleted {
+    const message = createBaseSessionsSnapshotCompleted();
     return message;
   },
 };
@@ -2554,7 +2914,7 @@ export const ListPrincipalsRequest: MessageFns<ListPrincipalsRequest> = {
 };
 
 function createBaseListPrincipalsResponse(): ListPrincipalsResponse {
-  return { status: undefined, principals: [], nextPageToken: "" };
+  return { status: undefined, principals: [], nextPageToken: "", totalCount: undefined };
 }
 
 export const ListPrincipalsResponse: MessageFns<ListPrincipalsResponse> = {
@@ -2568,6 +2928,9 @@ export const ListPrincipalsResponse: MessageFns<ListPrincipalsResponse> = {
     if (message.nextPageToken !== "") {
       writer.uint32(26).string(message.nextPageToken);
     }
+    if (message.totalCount !== undefined) {
+      writer.uint32(32).int64(message.totalCount);
+    }
     return writer;
   },
 
@@ -2608,6 +2971,14 @@ export const ListPrincipalsResponse: MessageFns<ListPrincipalsResponse> = {
             message.nextPageToken = reader.string();
             continue;
           }
+          case 4: {
+            if (tag !== 32) {
+              break;
+            }
+
+            message.totalCount = longToNumber(reader.int64());
+            continue;
+          }
         }
         if ((tag & 7) === 4 || tag === 0) {
           break;
@@ -2631,6 +3002,11 @@ export const ListPrincipalsResponse: MessageFns<ListPrincipalsResponse> = {
         : isSet(object.next_page_token)
         ? globalThis.String(object.next_page_token)
         : "",
+      totalCount: isSet(object.totalCount)
+        ? globalThis.Number(object.totalCount)
+        : isSet(object.total_count)
+        ? globalThis.Number(object.total_count)
+        : undefined,
     };
   },
 
@@ -2645,6 +3021,9 @@ export const ListPrincipalsResponse: MessageFns<ListPrincipalsResponse> = {
     if (message.nextPageToken !== "") {
       obj.nextPageToken = message.nextPageToken;
     }
+    if (message.totalCount !== undefined) {
+      obj.totalCount = Math.round(message.totalCount);
+    }
     return obj;
   },
 
@@ -2658,6 +3037,7 @@ export const ListPrincipalsResponse: MessageFns<ListPrincipalsResponse> = {
       : undefined;
     message.principals = object.principals?.map((e) => AIPrincipal.fromPartial(e)) || [];
     message.nextPageToken = object.nextPageToken ?? "";
+    message.totalCount = object.totalCount ?? undefined;
     return message;
   },
 };
@@ -4357,6 +4737,16 @@ export const AITokenUsage: MessageFns<AITokenUsage> = {
  */
 export interface AIGatewayService {
   ListSessions(request: ListSessionsRequest, metadata?: Metadata): Promise<ListSessionsResponse>;
+  /**
+   * Live UPSERT catalog over the same slice as ListSessions (same filter): an
+   * UPSERT per session keyed by routing_key + source_system, a nonterminal
+   * SessionsSnapshotCompleted, then new sessions as created + rollup updates until
+   * cancel. UPSERT-only (no removal frame): a session whose rollup shifts out of the
+   * filter simply stops being re-sent, so this notifies about currently-matching rows
+   * rather than maintaining a filtered catalog. Best-effort live delta; ListSessions
+   * is the authoritative catalog.
+   */
+  StreamSessions(request: StreamSessionsRequest, metadata?: Metadata): Observable<SessionFrame>;
   ListSessionEvents(request: ListSessionEventsRequest, metadata?: Metadata): Promise<ListSessionEventsResponse>;
   StreamSessionEvents(request: StreamSessionEventsRequest, metadata?: Metadata): Observable<AISessionEventEnvelope>;
   ListPrincipals(request: ListPrincipalsRequest, metadata?: Metadata): Promise<ListPrincipalsResponse>;
@@ -4377,6 +4767,7 @@ export class AIGatewayServiceClientImpl implements AIGatewayService {
     this.service = opts?.service || AIGatewayServiceServiceName;
     this.rpc = rpc;
     this.ListSessions = this.ListSessions.bind(this);
+    this.StreamSessions = this.StreamSessions.bind(this);
     this.ListSessionEvents = this.ListSessionEvents.bind(this);
     this.StreamSessionEvents = this.StreamSessionEvents.bind(this);
     this.ListPrincipals = this.ListPrincipals.bind(this);
@@ -4390,6 +4781,12 @@ export class AIGatewayServiceClientImpl implements AIGatewayService {
     return promise.then((data) => ListSessionsResponse.decode(new BinaryReader(data)));
   }
 
+  StreamSessions(request: StreamSessionsRequest, metadata?: Metadata): Observable<SessionFrame> {
+    const data = StreamSessionsRequest.encode(request).finish();
+    const result = this.rpc.serverStreamingRequest(this.service, "StreamSessions", data, metadata);
+    return result.pipe(map((data) => SessionFrame.decode(new BinaryReader(data))));
+  }
+
   ListSessionEvents(request: ListSessionEventsRequest, metadata?: Metadata): Promise<ListSessionEventsResponse> {
     const data = ListSessionEventsRequest.encode(request).finish();
     const promise = this.rpc.request(this.service, "ListSessionEvents", data, metadata);

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

@@ -116,6 +116,17 @@ function deserialize_gateway_web_v1_ListSessionsResponse(buffer_arg) {
   return proto_gateway_web_v1_ai_gateway_pb.ListSessionsResponse.deserializeBinary(new Uint8Array(buffer_arg));
 }
 
+function serialize_gateway_web_v1_SessionFrame(arg) {
+  if (!(arg instanceof proto_gateway_web_v1_ai_gateway_pb.SessionFrame)) {
+    throw new Error('Expected argument of type gateway.web.v1.SessionFrame');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_gateway_web_v1_SessionFrame(buffer_arg) {
+  return proto_gateway_web_v1_ai_gateway_pb.SessionFrame.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
 function serialize_gateway_web_v1_StreamGitActivitiesRequest(arg) {
   if (!(arg instanceof proto_gateway_web_v1_ai_gateway_pb.StreamGitActivitiesRequest)) {
     throw new Error('Expected argument of type gateway.web.v1.StreamGitActivitiesRequest');
@@ -138,6 +149,17 @@ function deserialize_gateway_web_v1_StreamSessionEventsRequest(buffer_arg) {
   return proto_gateway_web_v1_ai_gateway_pb.StreamSessionEventsRequest.deserializeBinary(new Uint8Array(buffer_arg));
 }
 
+function serialize_gateway_web_v1_StreamSessionsRequest(arg) {
+  if (!(arg instanceof proto_gateway_web_v1_ai_gateway_pb.StreamSessionsRequest)) {
+    throw new Error('Expected argument of type gateway.web.v1.StreamSessionsRequest');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_gateway_web_v1_StreamSessionsRequest(buffer_arg) {
+  return proto_gateway_web_v1_ai_gateway_pb.StreamSessionsRequest.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
 function serialize_gateway_web_v1_UpdatePrincipalRequest(arg) {
   if (!(arg instanceof proto_gateway_web_v1_ai_gateway_pb.UpdatePrincipalRequest)) {
     throw new Error('Expected argument of type gateway.web.v1.UpdatePrincipalRequest');
@@ -179,6 +201,24 @@ var AIGatewayServiceService = exports.AIGatewayServiceService = {
     responseSerialize: serialize_gateway_web_v1_ListSessionsResponse,
     responseDeserialize: deserialize_gateway_web_v1_ListSessionsResponse,
   },
+  // Live UPSERT catalog over the same slice as ListSessions (same filter): an
+// UPSERT per session keyed by routing_key + source_system, a nonterminal
+// SessionsSnapshotCompleted, then new sessions as created + rollup updates until
+// cancel. UPSERT-only (no removal frame): a session whose rollup shifts out of the
+// filter simply stops being re-sent, so this notifies about currently-matching rows
+// rather than maintaining a filtered catalog. Best-effort live delta; ListSessions
+// is the authoritative catalog.
+streamSessions: {
+    path: '/gateway.web.v1.AIGatewayService/StreamSessions',
+    requestStream: false,
+    responseStream: true,
+    requestType: proto_gateway_web_v1_ai_gateway_pb.StreamSessionsRequest,
+    responseType: proto_gateway_web_v1_ai_gateway_pb.SessionFrame,
+    requestSerialize: serialize_gateway_web_v1_StreamSessionsRequest,
+    requestDeserialize: deserialize_gateway_web_v1_StreamSessionsRequest,
+    responseSerialize: serialize_gateway_web_v1_SessionFrame,
+    responseDeserialize: deserialize_gateway_web_v1_SessionFrame,
+  },
   listSessionEvents: {
     path: '/gateway.web.v1.AIGatewayService/ListSessionEvents',
     requestStream: false,