@miradorlabs/web-grpc 2.40.0 → 2.45.0

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,9 +312,49 @@ 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 StreamSessionRequest {
+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 {
+  organizationId: string;
+  projectId: string;
+  routingKey: string;
+  sourceSystem: string;
+}
+
+export interface ListSessionEventsResponse {
+  status: ResponseStatus | undefined;
+  events: AISessionEvent[];
+}
+
+export interface StreamSessionEventsRequest {
   organizationId: string;
   projectId: string;
   routingKey: string;
@@ -346,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;
@@ -356,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 {
@@ -392,6 +445,27 @@ export interface ListGitActivitiesResponse {
   activities: AIGitActivity[];
 }
 
+export interface StreamGitActivitiesRequest {
+  organizationId: string;
+  projectId: string;
+  routingKey: string;
+  sourceSystem: string;
+}
+
+/**
+ * GitActivityFrame mirrors telemetry.api.v1.GitActivityFrame: an UPSERT of one
+ * activity's latest coalesced state (replace by activity_id, re-sort by
+ * event_time) or a nonterminal GitActivitiesSnapshotCompleted. Streams carry no
+ * ResponseStatus.
+ */
+export interface GitActivityFrame {
+  upsert?: AIGitActivity | undefined;
+  snapshotCompleted?: GitActivitiesSnapshotCompleted | undefined;
+}
+
+export interface GitActivitiesSnapshotCompleted {
+}
+
 export interface AIGitActivity {
   eventTime: Date | undefined;
   sourceSystem: string;
@@ -421,6 +495,8 @@ export interface AIGitActivity {
   prBaseRef: string;
   prHeadRef: string;
   mergeCommitSha: string;
+  /** UPSERT key for StreamGitActivities; clients replace by it */
+  activityId: string;
 }
 
 export interface AITokenUsage {
@@ -905,6 +981,9 @@ function createBaseAISession(): AISession {
     gitOrgs: [],
     repositories: [],
     filesTouched: 0,
+    sessionVersion: 0,
+    createdAt: undefined,
+    updatedAt: undefined,
   };
 }
 
@@ -979,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;
   },
 
@@ -1179,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;
@@ -1290,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,
     };
   },
 
@@ -1364,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;
   },
 
@@ -1397,16 +1533,275 @@ 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 createBaseStreamSessionRequest(): StreamSessionRequest {
+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;
+  },
+};
+
+function createBaseListSessionEventsRequest(): ListSessionEventsRequest {
   return { organizationId: "", projectId: "", routingKey: "", sourceSystem: "" };
 }
 
-export const StreamSessionRequest: MessageFns<StreamSessionRequest> = {
-  encode(message: StreamSessionRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+export const ListSessionEventsRequest: MessageFns<ListSessionEventsRequest> = {
+  encode(message: ListSessionEventsRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
     if (message.organizationId !== "") {
       writer.uint32(10).string(message.organizationId);
     }
@@ -1422,7 +1817,7 @@ export const StreamSessionRequest: MessageFns<StreamSessionRequest> = {
     return writer;
   },
 
-  decode(input: BinaryReader | Uint8Array, length?: number): StreamSessionRequest {
+  decode(input: BinaryReader | Uint8Array, length?: number): ListSessionEventsRequest {
     const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
     const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
     if (previousRecursionDepth >= 100) {
@@ -1431,7 +1826,7 @@ export const StreamSessionRequest: MessageFns<StreamSessionRequest> = {
     (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
     try {
       const end = length === undefined ? reader.len : reader.pos + length;
-      const message = createBaseStreamSessionRequest();
+      const message = createBaseListSessionEventsRequest();
       while (reader.pos < end) {
         const tag = reader.uint32();
         switch (tag >>> 3) {
@@ -1479,7 +1874,7 @@ export const StreamSessionRequest: MessageFns<StreamSessionRequest> = {
     }
   },
 
-  fromJSON(object: any): StreamSessionRequest {
+  fromJSON(object: any): ListSessionEventsRequest {
     return {
       organizationId: isSet(object.organizationId)
         ? globalThis.String(object.organizationId)
@@ -1504,7 +1899,7 @@ export const StreamSessionRequest: MessageFns<StreamSessionRequest> = {
     };
   },
 
-  toJSON(message: StreamSessionRequest): unknown {
+  toJSON(message: ListSessionEventsRequest): unknown {
     const obj: any = {};
     if (message.organizationId !== "") {
       obj.organizationId = message.organizationId;
@@ -1521,11 +1916,231 @@ export const StreamSessionRequest: MessageFns<StreamSessionRequest> = {
     return obj;
   },
 
-  create<I extends Exact<DeepPartial<StreamSessionRequest>, I>>(base?: I): StreamSessionRequest {
-    return StreamSessionRequest.fromPartial(base ?? ({} as any));
+  create<I extends Exact<DeepPartial<ListSessionEventsRequest>, I>>(base?: I): ListSessionEventsRequest {
+    return ListSessionEventsRequest.fromPartial(base ?? ({} as any));
   },
-  fromPartial<I extends Exact<DeepPartial<StreamSessionRequest>, I>>(object: I): StreamSessionRequest {
-    const message = createBaseStreamSessionRequest();
+  fromPartial<I extends Exact<DeepPartial<ListSessionEventsRequest>, I>>(object: I): ListSessionEventsRequest {
+    const message = createBaseListSessionEventsRequest();
+    message.organizationId = object.organizationId ?? "";
+    message.projectId = object.projectId ?? "";
+    message.routingKey = object.routingKey ?? "";
+    message.sourceSystem = object.sourceSystem ?? "";
+    return message;
+  },
+};
+
+function createBaseListSessionEventsResponse(): ListSessionEventsResponse {
+  return { status: undefined, events: [] };
+}
+
+export const ListSessionEventsResponse: MessageFns<ListSessionEventsResponse> = {
+  encode(message: ListSessionEventsResponse, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.status !== undefined) {
+      ResponseStatus.encode(message.status, writer.uint32(10).fork()).join();
+    }
+    for (const v of message.events) {
+      AISessionEvent.encode(v!, writer.uint32(18).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ListSessionEventsResponse {
+    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 = createBaseListSessionEventsResponse();
+      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 !== 18) {
+              break;
+            }
+
+            message.events.push(AISessionEvent.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): ListSessionEventsResponse {
+    return {
+      status: isSet(object.status) ? ResponseStatus.fromJSON(object.status) : undefined,
+      events: globalThis.Array.isArray(object?.events) ? object.events.map((e: any) => AISessionEvent.fromJSON(e)) : [],
+    };
+  },
+
+  toJSON(message: ListSessionEventsResponse): unknown {
+    const obj: any = {};
+    if (message.status !== undefined) {
+      obj.status = ResponseStatus.toJSON(message.status);
+    }
+    if (message.events?.length) {
+      obj.events = message.events.map((e) => AISessionEvent.toJSON(e));
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<ListSessionEventsResponse>, I>>(base?: I): ListSessionEventsResponse {
+    return ListSessionEventsResponse.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ListSessionEventsResponse>, I>>(object: I): ListSessionEventsResponse {
+    const message = createBaseListSessionEventsResponse();
+    message.status = (object.status !== undefined && object.status !== null)
+      ? ResponseStatus.fromPartial(object.status)
+      : undefined;
+    message.events = object.events?.map((e) => AISessionEvent.fromPartial(e)) || [];
+    return message;
+  },
+};
+
+function createBaseStreamSessionEventsRequest(): StreamSessionEventsRequest {
+  return { organizationId: "", projectId: "", routingKey: "", sourceSystem: "" };
+}
+
+export const StreamSessionEventsRequest: MessageFns<StreamSessionEventsRequest> = {
+  encode(message: StreamSessionEventsRequest, 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.routingKey !== "") {
+      writer.uint32(26).string(message.routingKey);
+    }
+    if (message.sourceSystem !== "") {
+      writer.uint32(34).string(message.sourceSystem);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): StreamSessionEventsRequest {
+    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 = createBaseStreamSessionEventsRequest();
+      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.routingKey = reader.string();
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              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): StreamSessionEventsRequest {
+    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)
+        : "",
+      routingKey: isSet(object.routingKey)
+        ? globalThis.String(object.routingKey)
+        : isSet(object.routing_key)
+        ? globalThis.String(object.routing_key)
+        : "",
+      sourceSystem: isSet(object.sourceSystem)
+        ? globalThis.String(object.sourceSystem)
+        : isSet(object.source_system)
+        ? globalThis.String(object.source_system)
+        : "",
+    };
+  },
+
+  toJSON(message: StreamSessionEventsRequest): unknown {
+    const obj: any = {};
+    if (message.organizationId !== "") {
+      obj.organizationId = message.organizationId;
+    }
+    if (message.projectId !== "") {
+      obj.projectId = message.projectId;
+    }
+    if (message.routingKey !== "") {
+      obj.routingKey = message.routingKey;
+    }
+    if (message.sourceSystem !== "") {
+      obj.sourceSystem = message.sourceSystem;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<StreamSessionEventsRequest>, I>>(base?: I): StreamSessionEventsRequest {
+    return StreamSessionEventsRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<StreamSessionEventsRequest>, I>>(object: I): StreamSessionEventsRequest {
+    const message = createBaseStreamSessionEventsRequest();
     message.organizationId = object.organizationId ?? "";
     message.projectId = object.projectId ?? "";
     message.routingKey = object.routingKey ?? "";
@@ -2299,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> = {
@@ -2313,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;
   },
 
@@ -2353,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;
@@ -2376,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,
     };
   },
 
@@ -2390,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;
   },
 
@@ -2403,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;
   },
 };
@@ -3016,6 +3651,284 @@ export const ListGitActivitiesResponse: MessageFns<ListGitActivitiesResponse> =
   },
 };
 
+function createBaseStreamGitActivitiesRequest(): StreamGitActivitiesRequest {
+  return { organizationId: "", projectId: "", routingKey: "", sourceSystem: "" };
+}
+
+export const StreamGitActivitiesRequest: MessageFns<StreamGitActivitiesRequest> = {
+  encode(message: StreamGitActivitiesRequest, 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.routingKey !== "") {
+      writer.uint32(26).string(message.routingKey);
+    }
+    if (message.sourceSystem !== "") {
+      writer.uint32(34).string(message.sourceSystem);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): StreamGitActivitiesRequest {
+    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 = createBaseStreamGitActivitiesRequest();
+      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.routingKey = reader.string();
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              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): StreamGitActivitiesRequest {
+    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)
+        : "",
+      routingKey: isSet(object.routingKey)
+        ? globalThis.String(object.routingKey)
+        : isSet(object.routing_key)
+        ? globalThis.String(object.routing_key)
+        : "",
+      sourceSystem: isSet(object.sourceSystem)
+        ? globalThis.String(object.sourceSystem)
+        : isSet(object.source_system)
+        ? globalThis.String(object.source_system)
+        : "",
+    };
+  },
+
+  toJSON(message: StreamGitActivitiesRequest): unknown {
+    const obj: any = {};
+    if (message.organizationId !== "") {
+      obj.organizationId = message.organizationId;
+    }
+    if (message.projectId !== "") {
+      obj.projectId = message.projectId;
+    }
+    if (message.routingKey !== "") {
+      obj.routingKey = message.routingKey;
+    }
+    if (message.sourceSystem !== "") {
+      obj.sourceSystem = message.sourceSystem;
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<StreamGitActivitiesRequest>, I>>(base?: I): StreamGitActivitiesRequest {
+    return StreamGitActivitiesRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<StreamGitActivitiesRequest>, I>>(object: I): StreamGitActivitiesRequest {
+    const message = createBaseStreamGitActivitiesRequest();
+    message.organizationId = object.organizationId ?? "";
+    message.projectId = object.projectId ?? "";
+    message.routingKey = object.routingKey ?? "";
+    message.sourceSystem = object.sourceSystem ?? "";
+    return message;
+  },
+};
+
+function createBaseGitActivityFrame(): GitActivityFrame {
+  return { upsert: undefined, snapshotCompleted: undefined };
+}
+
+export const GitActivityFrame: MessageFns<GitActivityFrame> = {
+  encode(message: GitActivityFrame, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.upsert !== undefined) {
+      AIGitActivity.encode(message.upsert, writer.uint32(10).fork()).join();
+    }
+    if (message.snapshotCompleted !== undefined) {
+      GitActivitiesSnapshotCompleted.encode(message.snapshotCompleted, writer.uint32(18).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): GitActivityFrame {
+    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 = createBaseGitActivityFrame();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.upsert = AIGitActivity.decode(reader, reader.uint32());
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.snapshotCompleted = GitActivitiesSnapshotCompleted.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): GitActivityFrame {
+    return {
+      upsert: isSet(object.upsert) ? AIGitActivity.fromJSON(object.upsert) : undefined,
+      snapshotCompleted: isSet(object.snapshotCompleted)
+        ? GitActivitiesSnapshotCompleted.fromJSON(object.snapshotCompleted)
+        : isSet(object.snapshot_completed)
+        ? GitActivitiesSnapshotCompleted.fromJSON(object.snapshot_completed)
+        : undefined,
+    };
+  },
+
+  toJSON(message: GitActivityFrame): unknown {
+    const obj: any = {};
+    if (message.upsert !== undefined) {
+      obj.upsert = AIGitActivity.toJSON(message.upsert);
+    }
+    if (message.snapshotCompleted !== undefined) {
+      obj.snapshotCompleted = GitActivitiesSnapshotCompleted.toJSON(message.snapshotCompleted);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<GitActivityFrame>, I>>(base?: I): GitActivityFrame {
+    return GitActivityFrame.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<GitActivityFrame>, I>>(object: I): GitActivityFrame {
+    const message = createBaseGitActivityFrame();
+    message.upsert = (object.upsert !== undefined && object.upsert !== null)
+      ? AIGitActivity.fromPartial(object.upsert)
+      : undefined;
+    message.snapshotCompleted = (object.snapshotCompleted !== undefined && object.snapshotCompleted !== null)
+      ? GitActivitiesSnapshotCompleted.fromPartial(object.snapshotCompleted)
+      : undefined;
+    return message;
+  },
+};
+
+function createBaseGitActivitiesSnapshotCompleted(): GitActivitiesSnapshotCompleted {
+  return {};
+}
+
+export const GitActivitiesSnapshotCompleted: MessageFns<GitActivitiesSnapshotCompleted> = {
+  encode(_: GitActivitiesSnapshotCompleted, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): GitActivitiesSnapshotCompleted {
+    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 = createBaseGitActivitiesSnapshotCompleted();
+      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): GitActivitiesSnapshotCompleted {
+    return {};
+  },
+
+  toJSON(_: GitActivitiesSnapshotCompleted): unknown {
+    const obj: any = {};
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<GitActivitiesSnapshotCompleted>, I>>(base?: I): GitActivitiesSnapshotCompleted {
+    return GitActivitiesSnapshotCompleted.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<GitActivitiesSnapshotCompleted>, I>>(_: I): GitActivitiesSnapshotCompleted {
+    const message = createBaseGitActivitiesSnapshotCompleted();
+    return message;
+  },
+};
+
 function createBaseAIGitActivity(): AIGitActivity {
   return {
     eventTime: undefined,
@@ -3046,6 +3959,7 @@ function createBaseAIGitActivity(): AIGitActivity {
     prBaseRef: "",
     prHeadRef: "",
     mergeCommitSha: "",
+    activityId: "",
   };
 }
 
@@ -3135,6 +4049,9 @@ export const AIGitActivity: MessageFns<AIGitActivity> = {
     if (message.mergeCommitSha !== "") {
       writer.uint32(226).string(message.mergeCommitSha);
     }
+    if (message.activityId !== "") {
+      writer.uint32(234).string(message.activityId);
+    }
     return writer;
   },
 
@@ -3375,6 +4292,14 @@ export const AIGitActivity: MessageFns<AIGitActivity> = {
             message.mergeCommitSha = reader.string();
             continue;
           }
+          case 29: {
+            if (tag !== 234) {
+              break;
+            }
+
+            message.activityId = reader.string();
+            continue;
+          }
         }
         if ((tag & 7) === 4 || tag === 0) {
           break;
@@ -3511,6 +4436,11 @@ export const AIGitActivity: MessageFns<AIGitActivity> = {
         : isSet(object.merge_commit_sha)
         ? globalThis.String(object.merge_commit_sha)
         : "",
+      activityId: isSet(object.activityId)
+        ? globalThis.String(object.activityId)
+        : isSet(object.activity_id)
+        ? globalThis.String(object.activity_id)
+        : "",
     };
   },
 
@@ -3600,6 +4530,9 @@ export const AIGitActivity: MessageFns<AIGitActivity> = {
     if (message.mergeCommitSha !== "") {
       obj.mergeCommitSha = message.mergeCommitSha;
     }
+    if (message.activityId !== "") {
+      obj.activityId = message.activityId;
+    }
     return obj;
   },
 
@@ -3636,6 +4569,7 @@ export const AIGitActivity: MessageFns<AIGitActivity> = {
     message.prBaseRef = object.prBaseRef ?? "";
     message.prHeadRef = object.prHeadRef ?? "";
     message.mergeCommitSha = object.mergeCommitSha ?? "";
+    message.activityId = object.activityId ?? "";
     return message;
   },
 };
@@ -3803,10 +4737,26 @@ export const AITokenUsage: MessageFns<AITokenUsage> = {
  */
 export interface AIGatewayService {
   ListSessions(request: ListSessionsRequest, metadata?: Metadata): Promise<ListSessionsResponse>;
-  StreamSession(request: StreamSessionRequest, metadata?: Metadata): Observable<AISessionEventEnvelope>;
+  /**
+   * 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>;
   UpdatePrincipal(request: UpdatePrincipalRequest, metadata?: Metadata): Promise<UpdatePrincipalResponse>;
   ListGitActivities(request: ListGitActivitiesRequest, metadata?: Metadata): Promise<ListGitActivitiesResponse>;
+  /**
+   * Live stream of one session's git/GitHub actions (UPSERT per activity keyed by
+   * activity_id, a nonterminal GitActivitiesSnapshotCompleted, then open until cancel).
+   */
+  StreamGitActivities(request: StreamGitActivitiesRequest, metadata?: Metadata): Observable<GitActivityFrame>;
 }
 
 export const AIGatewayServiceServiceName = "gateway.web.v1.AIGatewayService";
@@ -3817,10 +4767,13 @@ export class AIGatewayServiceClientImpl implements AIGatewayService {
     this.service = opts?.service || AIGatewayServiceServiceName;
     this.rpc = rpc;
     this.ListSessions = this.ListSessions.bind(this);
-    this.StreamSession = this.StreamSession.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);
     this.UpdatePrincipal = this.UpdatePrincipal.bind(this);
     this.ListGitActivities = this.ListGitActivities.bind(this);
+    this.StreamGitActivities = this.StreamGitActivities.bind(this);
   }
   ListSessions(request: ListSessionsRequest, metadata?: Metadata): Promise<ListSessionsResponse> {
     const data = ListSessionsRequest.encode(request).finish();
@@ -3828,9 +4781,21 @@ export class AIGatewayServiceClientImpl implements AIGatewayService {
     return promise.then((data) => ListSessionsResponse.decode(new BinaryReader(data)));
   }
 
-  StreamSession(request: StreamSessionRequest, metadata?: Metadata): Observable<AISessionEventEnvelope> {
-    const data = StreamSessionRequest.encode(request).finish();
-    const result = this.rpc.serverStreamingRequest(this.service, "StreamSession", data, metadata);
+  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);
+    return promise.then((data) => ListSessionEventsResponse.decode(new BinaryReader(data)));
+  }
+
+  StreamSessionEvents(request: StreamSessionEventsRequest, metadata?: Metadata): Observable<AISessionEventEnvelope> {
+    const data = StreamSessionEventsRequest.encode(request).finish();
+    const result = this.rpc.serverStreamingRequest(this.service, "StreamSessionEvents", data, metadata);
     return result.pipe(map((data) => AISessionEventEnvelope.decode(new BinaryReader(data))));
   }
 
@@ -3851,6 +4816,12 @@ export class AIGatewayServiceClientImpl implements AIGatewayService {
     const promise = this.rpc.request(this.service, "ListGitActivities", data, metadata);
     return promise.then((data) => ListGitActivitiesResponse.decode(new BinaryReader(data)));
   }
+
+  StreamGitActivities(request: StreamGitActivitiesRequest, metadata?: Metadata): Observable<GitActivityFrame> {
+    const data = StreamGitActivitiesRequest.encode(request).finish();
+    const result = this.rpc.serverStreamingRequest(this.service, "StreamGitActivities", data, metadata);
+    return result.pipe(map((data) => GitActivityFrame.decode(new BinaryReader(data))));
+  }
 }
 
 interface Rpc {