Add VideoPlayerClusters query + FinalizePlayerAssignments mutation

Operation file for the per-video player-labeling UI that consumes the
schema types added in #240.

  - VideoPlayerClusters($videoId): read clusters + crops
  - FinalizePlayerAssignments($input): apply user assignments and
    shot moves in one transaction

Generated by `just gql`.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

src/operations/feed.gql

@@ -31,41 +31,26 @@ fragment VideoCardFields on VideoGQL {
   }
   name
   screenshotUri
-  totalShotsMade
   totalShots
   makePercentage
   averageTimeBetweenShots
   averageDifficulty
-  createdAt
-  updatedAt
   startTime
-  endTime
   private
   elapsedTime
-  screenshotUri
   stream {
     id
     lastIntendedSegmentBound
-    isCompleted
     streamSegmentType
   }
   tableSize
   pocketSize
   tags {
-    tagClasses {
-      name
-    }
     name
   }
   currentProcessing {
     id
-    errors {
-      message
-    }
     status
-    statuses {
-      status
-    }
   }
   reactions {
     videoId
@@ -90,6 +75,26 @@ fragment VideoCardFields on VideoGQL {
   }
 }
 
+# Lightweight version of GetVideoFeed for counting sessions only
+query GetVideoFeedSessionCount(
+  $limit: Int! = 100
+  $filters: VideoFilterInput = null
+  $includePrivate: IncludePrivateEnum = MINE
+  $feedInput: VideoFeedInputGQL = null
+) {
+  getFeedVideos(
+    limit: $limit
+    filters: $filters
+    includePrivate: $includePrivate
+    feedInput: $feedInput
+  ) {
+    videos {
+      id
+      totalShots
+    }
+  }
+}
+
 query GetVideoFeed(
   $limit: Int! = 5
   $after: String = null

src/operations/payments.gql

@@ -20,8 +20,15 @@ mutation CreateSubscription($priceId: String!) {
   }
 }
 
+mutation CreateCustomerPortalSession {
+  createCustomerPortalSession {
+    portalUrl
+  }
+}
+
 query GetAvailableSubscriptionOptions {
   getAvailableSubscriptionOptions {
+    trialPeriodDays
     products {
       id
       name

src/operations/shooter.gql

@@ -0,0 +1,34 @@
+fragment PlayerClusterShotFields on PlayerClusterShotGQL {
+  shotId
+  bboxX1
+  bboxY1
+  bboxX2
+  bboxY2
+  confidence
+  isConfirmed
+  cropUrl
+  fullFrameUrl
+}
+
+fragment PlayerClusterFields on PlayerClusterGQL {
+  videoId
+  clusterId
+  nShots
+  userId
+  confirmed
+  shots {
+    ...PlayerClusterShotFields
+  }
+}
+
+query VideoPlayerClusters($videoId: Int!) {
+  videoPlayerClusters(videoId: $videoId) {
+    ...PlayerClusterFields
+  }
+}
+
+mutation FinalizePlayerAssignments($input: FinalizePlayerAssignmentsInput!) {
+  finalizePlayerAssignments(input: $input) {
+    ...PlayerClusterFields
+  }
+}

src/operations/user.gql

@@ -92,6 +92,17 @@ query GetUserTags {
   }
 }
 
+query GetGameTypeTagMetrics($input: GameTypeTagMetricsInput!) {
+  getGameTypeTagMetrics(input: $input) {
+    tagName
+    tagLabel
+    tableSize
+    shotCount
+    madeShots
+    makeRate
+  }
+}
+
 mutation followUser($followedUserId: Int!) {
   followUser(followedUserId: $followedUserId) {
     id

src/operations/video.gql

@@ -10,6 +10,7 @@ query GetStreamMonitoringDetails($videoId: Int!, $debuggingJson: JSON) {
     stream {
       id
       linksRequested
+      lowestUnuploadedSegmentIndex
       uploadsCompleted
       segmentProcessingCursor
       isCompleted

src/operations/video_upload.gql

@@ -1,5 +1,11 @@
-mutation CreateUploadStream($videoMetadataInput: VideoMetadataInput!) {
+mutation CreateUploadStream(
-  createUploadStream(videoMetadata: $videoMetadataInput) {
+  $videoMetadataInput: VideoMetadataInput!
+  $expectedDurationSeconds: Float = null
+) {
+  createUploadStream(
+    videoMetadata: $videoMetadataInput
+    expectedDurationSeconds: $expectedDurationSeconds
+  ) {
     videoId
   }
 }

src/schema.gql

@@ -28,7 +28,7 @@ type Query {
   getLongestRunsLeaderboard(
     interval: TimeInterval = null
     when: DateTime = null
-    limit: Int! = 100
+    limit: Int! = 50
     requiredTags: [String!] = null
   ): RunLeaderboardGQL!
   getMakesLeaderboard(
@@ -49,6 +49,7 @@ type Query {
     limit: Int! = 500
     countRespectsLimit: Boolean! = false
   ): GetRunsResult!
+  videoPlayerClusters(videoId: Int!): [PlayerClusterGQL!]!
   getShotAnnotationTypes(errorTypes: Boolean = false): [ShotAnnotationTypeGQL!]!
   getTableState(
     b64Image: String!
@@ -97,6 +98,7 @@ type Query {
   ): UserRelationshipsResult!
   getAvailableSubscriptionOptions: StripeSubscriptionOptionsGQL!
   getUserSubscriptionStatus: UserSubscriptionStatusGQL!
+  getQuotaStatus: QuotaStatusGQL!
   getPlayTime(userId: Int!, filters: VideoFilterInput = null): UserPlayTimeGQL!
   getUserVideos(
     userId: Int = null
@@ -105,6 +107,7 @@ type Query {
     filters: VideoFilterInput = null
   ): VideoHistoryGQL!
   getUserTags(includeRetiredTags: Boolean = false): [TagGQL!]!
+  getGameTypeTagMetrics(input: GameTypeTagMetricsInput!): [GameTypeTagMetric!]!
   getVideo(videoId: Int!, debuggingJson: JSON = null): VideoGQL!
   getVideos(videoIds: [Int!]!): [VideoGQL!]!
 }
@@ -605,6 +608,8 @@ type IntPoint2D {
 
 type VideoProcessingGQL {
   id: Int!
+  parentProcessingId: Int
+  labels: [String!]!
   errors: [VideoProcessingErrorGQL!]!
   status: ProcessingStatusEnum!
   statuses: [VideoProcessingStatusGQL!]!
@@ -856,6 +861,27 @@ input DatetimeOrdering {
   startingAt: DateTime = null
 }
 
+type PlayerClusterGQL {
+  videoId: Int!
+  clusterId: Int!
+  nShots: Int!
+  userId: Int
+  confirmed: Boolean!
+  shots: [PlayerClusterShotGQL!]!
+}
+
+type PlayerClusterShotGQL {
+  shotId: Int!
+  bboxX1: Int!
+  bboxY1: Int!
+  bboxX2: Int!
+  bboxY2: Int!
+  confidence: Float!
+  isConfirmed: Boolean!
+  cropUrl: String
+  fullFrameUrl: String
+}
+
 type TableStateGQL {
   identifierToPosition: [[Float!]!]!
   homography: HomographyInfoGQL
@@ -936,6 +962,7 @@ type UserRelationship {
 
 type StripeSubscriptionOptionsGQL {
   products: [StripeProductGQL!]!
+  trialPeriodDays: Int
 }
 
 type StripeProductGQL {
@@ -958,6 +985,9 @@ type StripePriceGQL {
 
 type UserSubscriptionStatusGQL {
   hasActiveSubscription: Boolean!
+  entitlementSource: EntitlementSourceTypeEnum
+  entitlementStartsAt: DateTime
+  entitlementEndsAt: DateTime
   subscriptionStatus: StripeSubscriptionStatusEnum
   currentPeriodStart: DateTime
   currentPeriodEnd: DateTime
@@ -966,6 +996,13 @@ type UserSubscriptionStatusGQL {
   stripeSubscriptionId: String
 }
 
+enum EntitlementSourceTypeEnum {
+  ADMIN
+  MANUAL
+  STRIPE
+  ALPHA_LEGACY
+}
+
 enum StripeSubscriptionStatusEnum {
   INCOMPLETE
   INCOMPLETE_EXPIRED
@@ -977,6 +1014,17 @@ enum StripeSubscriptionStatusEnum {
   PAUSED
 }
 
+type QuotaStatusGQL {
+  tierName: String!
+  periodStart: DateTime!
+  periodEnd: DateTime!
+  durationUsedSeconds: Float!
+  durationLimitSeconds: Int
+  maxVideoDurationSeconds: Int
+  durationRemainingSeconds: Float
+  canUpload: Boolean!
+}
+
 type UserPlayTimeGQL {
   totalSeconds: Float!
 }
@@ -993,6 +1041,25 @@ type TagClassGQL {
   name: String!
 }
 
+type GameTypeTagMetric {
+  tagName: String!
+  tagLabel: String!
+  tableSize: Float
+  shotCount: Int!
+  madeShots: Int!
+  makeRate: Float!
+}
+
+input GameTypeTagMetricsInput {
+  userId: Int!
+  createdAt: DateRangeFilter = null
+  maxTags: Int = null
+  groupByTableSize: Boolean! = true
+  includeUnknown: Boolean! = true
+  tagClass: String = "game_type"
+  includePrivate: IncludePrivateEnum! = MINE
+}
+
 """
 The `JSON` scalar type represents JSON values as specified by [ECMA-404](https://ecma-international.org/wp-content/uploads/ECMA-404_2nd_edition_december_2017.pdf).
 """
@@ -1049,6 +1116,9 @@ type Mutation {
   markAllNotificationsAsRead: Boolean!
   markNotificationsAsRead(notificationIds: [Int!]!): Boolean!
   deleteNotification(notificationId: Int!): Boolean!
+  finalizePlayerAssignments(
+    input: FinalizePlayerAssignmentsInput!
+  ): [PlayerClusterGQL!]!
   addAnnotationToShot(
     shotId: Int!
     annotationName: String!
@@ -1073,7 +1143,16 @@ type Mutation {
   ensureStripeCustomerExists: UserGQL!
   deleteUser: Boolean!
   createSubscription(priceId: String!): CreateSubscriptionResultGQL!
+  createCustomerPortalSession: CreateCustomerPortalSessionResultGQL!
   cancelSubscription: UserSubscriptionStatusGQL!
+  grantManualEntitlement(
+    userId: Int!
+    tierName: String! = "pro"
+    startsAt: DateTime = null
+    endsAt: DateTime = null
+    reason: String = null
+  ): UserSubscriptionStatusGQL!
+  revokeManualEntitlement(userId: Int!): UserSubscriptionStatusGQL!
   submitCancellationFeedback(
     reasons: [CancellationReasonEnum!] = null
     feedback: String = null
@@ -1082,6 +1161,7 @@ type Mutation {
   findPrerecordTableLayout(b64Image: String!, videoId: Int!): HomographyInfoGQL
   createUploadStream(
     videoMetadata: VideoMetadataInput!
+    expectedDurationSeconds: Float = null
   ): CreateUploadStreamReturn!
   getUploadLink(videoId: Int!, segmentIndex: Int!): GetUploadLinkReturn!
   getHlsInitUploadLink(videoId: Int!): GetUploadLinkReturn!
@@ -1110,6 +1190,22 @@ enum ReportReasonEnum {
   OTHER
 }
 
+input FinalizePlayerAssignmentsInput {
+  videoId: Int!
+  clusterAssignments: [ClusterAssignmentInput!]! = []
+  shotMoves: [ShotMoveInput!]! = []
+}
+
+input ClusterAssignmentInput {
+  clusterId: Int!
+  userId: Int = null
+}
+
+input ShotMoveInput {
+  shotId: Int!
+  newClusterId: Int!
+}
+
 type AddShotAnnotationReturn {
   value: SuccessfulAddAddShotAnnotationErrors!
 }
@@ -1203,6 +1299,10 @@ type CreateSubscriptionResultGQL {
   sessionId: String!
 }
 
+type CreateCustomerPortalSessionResultGQL {
+  portalUrl: String!
+}
+
 enum CancellationReasonEnum {
   DONT_PLAY_ENOUGH
   TOO_EXPENSIVE