Select the detection audit payload on getTableState

Adds identifierToBox to TableStateGQL and selects it, alongside the
homography that was already in the schema but never requested, so the
photo path can draw a detection back over the image it came from. The
live and shot queries keep the layout-only selection: their frame lives
inside a video the app never holds, and one of them polls every five
seconds.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

src/operations/legacy_shotsim.gql

@@ -0,0 +1,25 @@
+# Legacy shot-sim operations still used by mobile master's
+# LiveStreamPicker / RecordedShotPicker; remove when those are deleted.
+
+query GetRecordedStreams($limit: Int! = 25) {
+  getFeedVideos(
+    limit: $limit
+    filters: { isStreamCompleted: true, excludeVideosWithNoShots: true }
+    includePrivate: MINE
+    feedInput: { allUsers: true }
+  ) {
+    videos {
+      id
+      name
+      createdAt
+      screenshotUri
+      framesPerSecond
+      totalShots
+      owner {
+        id
+        username
+        profileImageUri
+      }
+    }
+  }
+}

src/operations/live_streams.gql

@@ -0,0 +1,34 @@
+# Lightweight listing of live (in-progress) streams for pickers like the
+# Shot Lab "follow a live stream" flow. Selects only what a picker card
+# needs; intentionally avoids the heavy VideoCardFields fragment.
+query GetLiveStreams($limit: Int! = 25) {
+  getFeedVideos(
+    limit: $limit
+    filters: { isStreamCompleted: false, requireCursorCompletion: false }
+    includePrivate: MINE
+    feedInput: { allUsers: true }
+  ) {
+    videos {
+      id
+      name
+      startTime
+      createdAt
+      screenshotUri
+      elapsedTime
+      owner {
+        id
+        username
+        profileImageUri
+      }
+      stream {
+        id
+        isCompleted
+        lastSegmentUploadedAt
+      }
+    }
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+  }
+}

src/operations/recorded_shots.gql

@@ -1,12 +1,19 @@
-# Lightweight two-step picker data for Shot Lab's video-first source: the
+# Lightweight two-step picker data for Shot Lab's video-first source: recent
-# caller's recent videos (completed or still uploading), then that video's
+# videos from the requested audience (mine, followed users, or public), then
-# shots. The stream fields hint at "actively updating" without gating.
+# that video's shots. The stream fields hint at "actively updating" without
-query GetShotLabVideos($userId: Int!, $limit: Int! = 25) {
+# gating.
+query GetShotLabVideos(
+  $feedInput: VideoFeedInputGQL!
+  $includePrivate: IncludePrivateEnum!
+  $limit: Int! = 25
+  $after: String = null
+) {
   getFeedVideos(
     limit: $limit
+    after: $after
     includeCallersVideos: false
-    includePrivate: MINE
+    includePrivate: $includePrivate
-    feedInput: { userId: $userId }
+    feedInput: $feedInput
   ) {
     videos {
       id
@@ -26,6 +33,10 @@ query GetShotLabVideos($userId: Int!, $limit: Int! = 25) {
         lastSegmentUploadedAt
       }
     }
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
   }
 }
 

src/operations/session-coach.gql

@@ -14,6 +14,16 @@ query GetSessionCoach($videoId: Int!) {
     unknownOutcomeCount
     analyzedShotCount
     makePercentage
+    longestMakeStreak
+    recentBaseline {
+      sessionCount
+      attemptCount
+      madeCount
+      makePercentage
+    }
+    positiveCandidates {
+      ...SessionCoachCandidateFields
+    }
     primaryCandidate {
       ...SessionCoachCandidateFields
     }
@@ -59,6 +69,10 @@ fragment SessionCoachCandidateFields on SessionCoachCandidateGQL {
     patternShotCount
     score
     rankReason
+    baselineSessionCount
+    baselineAttemptCount
+    baselineMadeCount
+    baselineMakePercentage
   }
 }
 
@@ -68,7 +82,13 @@ fragment SessionCoachGenerationFields on SessionCoachGenerationGQL {
   createdAt
   completedAt
   decision {
+    selectedPositiveCandidateId
+    positiveTitle
+    positiveBody
     selectedCandidateId
+    supportingCandidateIds
+    supportingShotIds
+    sessionSummary
     title
     body
     suggestedAction
@@ -95,5 +115,6 @@ fragment SessionCoachGenerationFields on SessionCoachGenerationGQL {
     startedAt
     lastEnqueuedAt
     abstentionReason
+    synthesisRationale
   }
 }

src/operations/share_link.gql

@@ -0,0 +1,8 @@
+mutation CreateShotShareLink($shotIds: [Int!]!, $paddingSeconds: Float = null) {
+  createShotShareLink(
+    input: { shotIds: $shotIds, paddingSeconds: $paddingSeconds }
+  ) {
+    slug
+    url
+  }
+}

src/operations/shot_simulation.gql

@@ -1,3 +1,72 @@
+fragment TableStateLayoutFields on TableStateGQL {
+  identifierToPosition
+  identifierToColor {
+    hex
+  }
+}
+
+fragment DetectionBoxFields on BoundingBoxGQL {
+  left
+  top
+  width
+  height
+}
+
+fragment DetectionPocketPointFields on PocketPointsGQL {
+  topLeft {
+    x
+    y
+  }
+  topSide {
+    x
+    y
+  }
+  topRight {
+    x
+    y
+  }
+  bottomLeft {
+    x
+    y
+  }
+  bottomSide {
+    x
+    y
+  }
+  bottomRight {
+    x
+    y
+  }
+}
+
+# Everything needed to redraw a detection over the image it came from:
+# the detector's boxes plus the homography that turned them into plane
+# positions. Boxes, pocket boxes, and source points share the crop's
+# coordinate space; the crop locates that space in the full frame.
+#
+# Only the photo query selects this. The live and shot queries read a
+# frame out of a video the app never holds, so there is no image to
+# overlay, and getLiveTableState is polled every five seconds.
+fragment TableStateDetectionFields on TableStateGQL {
+  identifierToBox {
+    ...DetectionBoxFields
+  }
+  homography {
+    crop {
+      ...DetectionBoxFields
+    }
+    pockets {
+      ...DetectionBoxFields
+    }
+    sourcePoints {
+      ...DetectionPocketPointFields
+    }
+    destPoints {
+      ...DetectionPocketPointFields
+    }
+  }
+}
+
 query GetTableState(
   $b64Image: String!
   $tableSize: Float
@@ -8,10 +77,8 @@ query GetTableState(
     tableSize: $tableSize
     useHomography: $useHomography
   ) {
-    identifierToPosition
+    ...TableStateLayoutFields
-    identifierToColor {
+    ...TableStateDetectionFields
-      hex
-    }
   }
 }
 
@@ -20,10 +87,7 @@ query GetLiveTableState($videoId: Int!) {
     videoId
     frameIndex
     tableState {
-      identifierToPosition
+      ...TableStateLayoutFields
-      identifierToColor {
-        hex
-      }
     }
   }
 }
@@ -34,10 +98,7 @@ query GetShotTableState($shotId: Int!) {
     videoId
     frameIndex
     tableState {
-      identifierToPosition
+      ...TableStateLayoutFields
-      identifierToColor {
-        hex
-      }
     }
   }
 }

src/operations/video_upload.gql

@@ -48,6 +48,52 @@ mutation GetUploadLink($videoId: Int!, $segmentIndex: Int!) {
       }
     }
     stream {
+      id
+      uploadCompletionCursor
+    }
+  }
+}
+
+mutation GetUploadLinks($videoId: Int!, $segmentIndexes: [Int!]!) {
+  getUploadLinks(videoId: $videoId, segmentIndexes: $segmentIndexes) {
+    value {
+      ... on UploadLinkBatch {
+        links {
+          segmentIndex
+          uploadUrl
+          headers {
+            key
+            value
+          }
+        }
+        alreadyUploaded
+      }
+      ... on GetUploadLinkErrors {
+        error {
+          ... on MustHaveSetForUploadLinkErr {
+            resolution
+            framesPerSecond
+          }
+          ... on ProcessingFailedErr {
+            processing {
+              status
+              errors {
+                message
+              }
+            }
+          }
+          ... on StorageLimitExceededErr {
+            reason
+            tierName
+            retainedStorageUsedBytes
+            retainedStorageLimitBytes
+            remainingStorageBytes
+          }
+        }
+      }
+    }
+    stream {
+      id
       uploadCompletionCursor
     }
   }
@@ -127,6 +173,7 @@ fragment UploadStreamWithDetails on VideoGQL {
   name
   startTime
   stream {
+    id
     isCompleted
     lastIntendedSegmentBound
     uploadCompletionCursor

src/schema.gql

@@ -249,6 +249,11 @@ input CreatePoolHallCameraInput {
   claimTermsText: String = null
 }
 
+input CreateShotShareLinkInput {
+  shotIds: [Int!]!
+  paddingSeconds: Float = null
+}
+
 input CreatePoolHallInput {
   name: String!
   address: String = null
@@ -526,6 +531,11 @@ type GetUploadLinkReturn {
   stream: UploadStreamGQL
 }
 
+type GetUploadLinksReturn {
+  value: UploadLinkBatchGetUploadLinkErrors!
+  stream: UploadStreamGQL
+}
+
 type HLSPlaylistGQL {
   videoId: Int!
   m3u8Text: String!
@@ -701,6 +711,7 @@ type Mutation {
   cancelCameraClaimSession(claimSessionId: ID!): CameraClaimSession!
   endCameraLease(leaseId: ID!): CameraLease!
   extendCameraLease(leaseId: ID!, additionalMinutes: Int! = 60): CameraLease!
+  createShotShareLink(input: CreateShotShareLinkInput!): ShareLinkGQL!
   finalizePlayerAssignments(
     input: FinalizePlayerAssignmentsInput!
   ): [PlayerClusterGQL!]!
@@ -755,6 +766,7 @@ type Mutation {
     expectedDurationSeconds: Float = null
   ): CreateUploadStreamReturn!
   getUploadLink(videoId: Int!, segmentIndex: Int!): GetUploadLinkReturn!
+  getUploadLinks(videoId: Int!, segmentIndexes: [Int!]!): GetUploadLinksReturn!
   getHlsInitUploadLink(videoId: Int!): GetUploadLinkReturn!
   setSegmentDuration(
     videoId: Int!
@@ -1289,11 +1301,25 @@ type SegmentAlreadyUploadedErr {
   segmentId: Int!
 }
 
+type SegmentUploadLink {
+  segmentIndex: Int!
+  uploadUrl: String!
+  headers: [Header]!
+}
+
 type SerializedShotPathsGQL {
   b64EncodedBuffer: String
 }
 
+type SessionCoachBaselineGQL {
+  sessionCount: Int!
+  attemptCount: Int!
+  madeCount: Int!
+  makePercentage: Float!
+}
+
 enum SessionCoachCandidateFamilyEnum {
+  OVERALL
   AIMING
   CUT_ANGLE
   SPIN
@@ -1317,13 +1343,22 @@ type SessionCoachCandidateGQL {
 }
 
 enum SessionCoachCandidateKindEnum {
+  BASELINE_COMPARISON
+  SESSION_STREAK
+  STRENGTH_PATTERN
   DIRECTIONAL_MISS
   OUTCOME_PATTERN
   USAGE_PATTERN
 }
 
 type SessionCoachDecisionGQL {
+  selectedPositiveCandidateId: ID
+  positiveTitle: String
+  positiveBody: String
   selectedCandidateId: ID
+  supportingCandidateIds: [ID!]!
+  supportingShotIds: [Int!]!
+  sessionSummary: String
   title: String
   body: String
   suggestedAction: String
@@ -1346,6 +1381,10 @@ type SessionCoachEvidenceGQL {
   patternShotCount: Int!
   score: Float!
   rankReason: String!
+  baselineSessionCount: Int!
+  baselineAttemptCount: Int!
+  baselineMadeCount: Int!
+  baselineMakePercentage: Float
 }
 
 type SessionCoachGQL {
@@ -1363,6 +1402,9 @@ type SessionCoachGQL {
   unknownOutcomeCount: Int!
   analyzedShotCount: Int!
   makePercentage: Float
+  longestMakeStreak: Int!
+  recentBaseline: SessionCoachBaselineGQL
+  positiveCandidates: [SessionCoachCandidateGQL!]!
   primaryCandidate: SessionCoachCandidateGQL
   candidates: [SessionCoachCandidateGQL!]!
   agentGeneration: SessionCoachGenerationGQL
@@ -1386,6 +1428,7 @@ type SessionCoachGenerationDiagnosticsGQL {
   startedAt: DateTime
   lastEnqueuedAt: DateTime
   abstentionReason: String
+  synthesisRationale: String
 }
 
 type SessionCoachGenerationGQL {
@@ -1665,6 +1708,7 @@ type TableStateGQL {
   identifierToPosition: [[Float!]!]!
   homography: HomographyInfoGQL
   identifierToColor: [RGBColorGQL]!
+  identifierToBox: [BoundingBoxGQL!]!
 }
 
 type TagClassGQL {
@@ -1750,6 +1794,13 @@ type UploadLink {
   headers: [Header]!
 }
 
+type UploadLinkBatch {
+  links: [SegmentUploadLink!]!
+  alreadyUploaded: [Int!]!
+}
+
+union UploadLinkBatchGetUploadLinkErrors = UploadLinkBatch | GetUploadLinkErrors
+
 union UploadLinkGetProfileUploadLinkErrors =
     UploadLink
   | GetProfileUploadLinkErrors
@@ -1869,6 +1920,11 @@ type UserSubscriptionStatusGQL {
   stripeSubscriptionId: String
 }
 
+type ShareLinkGQL {
+  slug: String!
+  url: String!
+}
+
 type VideoExportJobGQL {
   id: Int!
   videoId: Int!
@@ -1879,7 +1935,7 @@ type VideoExportJobGQL {
   shotIds: [Int!]
   runId: Int
   downloadUrl: String
-  fileSizeBytes: Int
+  fileSizeBytes: BigInt
   expiresAt: DateTime
   createdAt: DateTime
 }