@camstack/types 1.2.339 → 1.2.340

package/dist/capabilities/pipeline-analytics.cap.d.ts

@@ -1340,20 +1340,232 @@ export declare const RetrainFrameListSchema: z.ZodObject<{
     autoPickMediaId: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type RetrainFrameList = z.infer<typeof RetrainFrameListSchema>;
+/** Exclusive partition of a corpus copy's annotation progress (design §4.2). */
+export declare const RetrainFrameWorkStateSchema: z.ZodEnum<{
+    annotated: "annotated";
+    complete: "complete";
+    unannotated: "unannotated";
+}>;
+export type RetrainFrameWorkState = z.infer<typeof RetrainFrameWorkStateSchema>;
+/**
+ * Filters for paginated corpus list, KPI, and matching export (design §4.4).
+ * Every narrowing field is ANDed; omitted fields impose no constraint.
+ */
+export declare const RetrainCorpusFilterSchema: z.ZodObject<{
+    workState: z.ZodOptional<z.ZodEnum<{
+        annotated: "annotated";
+        complete: "complete";
+        unannotated: "unannotated";
+    }>>;
+    deviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    collectionId: z.ZodOptional<z.ZodString>;
+    classes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        animal: "animal";
+        face: "face";
+        package: "package";
+        person: "person";
+        plate: "plate";
+        vehicle: "vehicle";
+    }>>>;
+    page: z.ZodDefault<z.ZodNumber>;
+    pageSize: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type RetrainCorpusFilter = z.infer<typeof RetrainCorpusFilterSchema>;
+/**
+ * One row on the Frames corpus grid: a wire frame plus its exclusive work
+ * state (`workStateOf`), so the UI can badge To do / In progress / Complete
+ * when the filter is All (annotation counts are not otherwise on the wire).
+ */
+export declare const RetrainCorpusPageFrameSchema: z.ZodObject<{
+    frameId: z.ZodString;
+    deviceId: z.ZodNumber;
+    origin: z.ZodEnum<{
+        recording: "recording";
+        track: "track";
+    }>;
+    trackId: z.ZodOptional<z.ZodString>;
+    sourceMediaId: z.ZodOptional<z.ZodNumber>;
+    epochMs: z.ZodOptional<z.ZodNumber>;
+    sourceKind: z.ZodEnum<{
+        confirmationCrop: "confirmationCrop";
+        crop: "crop";
+        debugCrop: "debugCrop";
+        faceCrop: "faceCrop";
+        firstFrame: "firstFrame";
+        fullFrame: "fullFrame";
+        fullFrameBoxed: "fullFrameBoxed";
+        keyFrame: "keyFrame";
+        keyFrameSmall: "keyFrameSmall";
+        lastFrame: "lastFrame";
+        lastSceneFrame: "lastSceneFrame";
+        plateCrop: "plateCrop";
+        sceneFrame: "sceneFrame";
+        snapshot: "snapshot";
+        thumbnail: "thumbnail";
+        thumbnailSmall: "thumbnailSmall";
+    }>;
+    sizeBytes: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    copiedAt: z.ZodNumber;
+    capturedAt: z.ZodOptional<z.ZodNumber>;
+    complete: z.ZodBoolean;
+    pipelineBoxes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        bbox: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, z.core.$strip>;
+        macroClass: z.ZodEnum<{
+            animal: "animal";
+            face: "face";
+            package: "package";
+            person: "person";
+            plate: "plate";
+            vehicle: "vehicle";
+        }>;
+        label: z.ZodOptional<z.ZodString>;
+        subLabel: z.ZodOptional<z.ZodString>;
+        score: z.ZodOptional<z.ZodNumber>;
+        modelId: z.ZodOptional<z.ZodString>;
+        trackId: z.ZodString;
+        basis: z.ZodEnum<{
+            position: "position";
+            "subject-box": "subject-box";
+        }>;
+        deltaMs: z.ZodNumber;
+    }, z.core.$strip>>>>;
+    collectionIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+    workState: z.ZodEnum<{
+        annotated: "annotated";
+        complete: "complete";
+        unannotated: "unannotated";
+    }>;
+}, z.core.$strip>;
+export type RetrainCorpusPageFrame = z.infer<typeof RetrainCorpusPageFrameSchema>;
+export declare const RetrainCorpusPageSchema: z.ZodObject<{
+    frames: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        frameId: z.ZodString;
+        deviceId: z.ZodNumber;
+        origin: z.ZodEnum<{
+            recording: "recording";
+            track: "track";
+        }>;
+        trackId: z.ZodOptional<z.ZodString>;
+        sourceMediaId: z.ZodOptional<z.ZodNumber>;
+        epochMs: z.ZodOptional<z.ZodNumber>;
+        sourceKind: z.ZodEnum<{
+            confirmationCrop: "confirmationCrop";
+            crop: "crop";
+            debugCrop: "debugCrop";
+            faceCrop: "faceCrop";
+            firstFrame: "firstFrame";
+            fullFrame: "fullFrame";
+            fullFrameBoxed: "fullFrameBoxed";
+            keyFrame: "keyFrame";
+            keyFrameSmall: "keyFrameSmall";
+            lastFrame: "lastFrame";
+            lastSceneFrame: "lastSceneFrame";
+            plateCrop: "plateCrop";
+            sceneFrame: "sceneFrame";
+            snapshot: "snapshot";
+            thumbnail: "thumbnail";
+            thumbnailSmall: "thumbnailSmall";
+        }>;
+        sizeBytes: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        copiedAt: z.ZodNumber;
+        capturedAt: z.ZodOptional<z.ZodNumber>;
+        complete: z.ZodBoolean;
+        pipelineBoxes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            bbox: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, z.core.$strip>;
+            macroClass: z.ZodEnum<{
+                animal: "animal";
+                face: "face";
+                package: "package";
+                person: "person";
+                plate: "plate";
+                vehicle: "vehicle";
+            }>;
+            label: z.ZodOptional<z.ZodString>;
+            subLabel: z.ZodOptional<z.ZodString>;
+            score: z.ZodOptional<z.ZodNumber>;
+            modelId: z.ZodOptional<z.ZodString>;
+            trackId: z.ZodString;
+            basis: z.ZodEnum<{
+                position: "position";
+                "subject-box": "subject-box";
+            }>;
+            deltaMs: z.ZodNumber;
+        }, z.core.$strip>>>>;
+        collectionIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+        workState: z.ZodEnum<{
+            annotated: "annotated";
+            complete: "complete";
+            unannotated: "unannotated";
+        }>;
+    }, z.core.$strip>>>;
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    pageSize: z.ZodNumber;
+}, z.core.$strip>;
+export type RetrainCorpusPage = z.infer<typeof RetrainCorpusPageSchema>;
+export declare const RetrainCorpusKpiCameraRowSchema: z.ZodObject<{
+    deviceId: z.ZodNumber;
+    unannotated: z.ZodNumber;
+    annotated: z.ZodNumber;
+    complete: z.ZodNumber;
+    pctOfCorpus: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type RetrainCorpusKpiCameraRow = z.infer<typeof RetrainCorpusKpiCameraRowSchema>;
+export declare const RetrainCorpusKpiSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    unannotated: z.ZodNumber;
+    annotated: z.ZodNumber;
+    complete: z.ZodNumber;
+    cameras: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        deviceId: z.ZodNumber;
+        unannotated: z.ZodNumber;
+        annotated: z.ZodNumber;
+        complete: z.ZodNumber;
+        pctOfCorpus: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type RetrainCorpusKpi = z.infer<typeof RetrainCorpusKpiSchema>;
 /**
  * Which frames an annotated export carries. Every field narrows; an empty
- * filter is every annotated copy. A dataset VERSION is a frozen `frameIds`
- * list owned by whoever trains (the training orchestrator), so `frameIds` is
- * the primitive a version export uses; `batchId` re-selects what an earlier
- * export carried (`exportedInBatch`).
+ * filter is every annotated copy. `frameIds` is the primitive a job or
+ * download uses; `batchId` re-selects what an earlier export carried
+ * (`exportedInBatch`). Frozen dataset versions were removed — live selection
+ * resolves to `frameIds` at plan/start.
  */
 export declare const RetrainExportFilterSchema: z.ZodObject<{
     deviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     frameIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     collectionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    datasetVersionId: z.ZodOptional<z.ZodString>;
+    collectionId: z.ZodOptional<z.ZodString>;
     batchId: z.ZodOptional<z.ZodString>;
     completeOnly: z.ZodOptional<z.ZodBoolean>;
+    workState: z.ZodOptional<z.ZodEnum<{
+        annotated: "annotated";
+        complete: "complete";
+        unannotated: "unannotated";
+    }>>;
+    classes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        animal: "animal";
+        face: "face";
+        package: "package";
+        person: "person";
+        plate: "plate";
+        vehicle: "vehicle";
+    }>>>;
 }, z.core.$strip>;
 export type RetrainExportFilter = z.infer<typeof RetrainExportFilterSchema>;
 /**
@@ -1750,7 +1962,10 @@ export declare const RetrainDatasetStatsSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type RetrainDatasetStats = z.infer<typeof RetrainDatasetStatsSchema>;
-/** An immutable dataset version, without its frame list. */
+/**
+ * Shape of a historically frozen dataset version (stats + selection). Kept for
+ * typed stats/selection helpers and any leftover rows; no public freeze API.
+ */
 export declare const RetrainDatasetVersionSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
@@ -1794,59 +2009,61 @@ export declare const RetrainDatasetVersionSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type RetrainDatasetVersion = z.infer<typeof RetrainDatasetVersionSchema>;
-export declare const CreateRetrainDatasetVersionResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    kind: z.ZodLiteral<"created">;
-    version: z.ZodObject<{
-        id: z.ZodString;
-        name: z.ZodString;
-        createdAt: z.ZodNumber;
-        selection: z.ZodObject<{
-            deviceIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodNumber>>>;
-            collectionIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
-            frameIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
-        }, z.core.$strip>;
-        layout: z.ZodEnum<{
-            crops: "crops";
-            frames: "frames";
-        }>;
-        completeOnly: z.ZodBoolean;
-        frameCount: z.ZodNumber;
-        annotationHash: z.ZodString;
-        manifestSchema: z.ZodString;
-        stats: z.ZodObject<{
+/**
+ * Live training corpus criteria — same shape as `TrainingCorpusSelection` on
+ * the training cap. Resolved here so plan/start and the annotated export share
+ * one definition of "the frames" (`buildRetrainExportPlan`).
+ */
+export declare const RetrainTrainingCorpusSelectionSchema: z.ZodObject<{
+    collectionIds: z.ZodArray<z.ZodString>;
+    workState: z.ZodDefault<z.ZodEnum<{
+        annotated_or_complete: "annotated_or_complete";
+        any_annotated: "any_annotated";
+        complete: "complete";
+    }>>;
+}, z.core.$strip>;
+export type RetrainTrainingCorpusSelection = z.infer<typeof RetrainTrainingCorpusSelectionSchema>;
+export declare const RetrainTrainingCorpusResolveResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"resolved">;
+    frameIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    stats: z.ZodObject<{
+        frames: z.ZodNumber;
+        completeFrames: z.ZodNumber;
+        completeness: z.ZodNumber;
+        subjects: z.ZodNumber;
+        modelErrors: z.ZodNumber;
+        hardNegatives: z.ZodNumber;
+        cells: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            macroClass: z.ZodString;
+            deviceId: z.ZodNumber;
+            lighting: z.ZodEnum<{
+                day: "day";
+                night: "night";
+                unknown: "unknown";
+            }>;
+            subjects: z.ZodNumber;
+            frames: z.ZodNumber;
+        }, z.core.$strip>>>;
+        cameras: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            deviceId: z.ZodNumber;
             frames: z.ZodNumber;
             completeFrames: z.ZodNumber;
-            completeness: z.ZodNumber;
-            subjects: z.ZodNumber;
-            modelErrors: z.ZodNumber;
-            hardNegatives: z.ZodNumber;
-            cells: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-                macroClass: z.ZodString;
-                deviceId: z.ZodNumber;
-                lighting: z.ZodEnum<{
-                    day: "day";
-                    night: "night";
-                    unknown: "unknown";
-                }>;
-                subjects: z.ZodNumber;
-                frames: z.ZodNumber;
-            }, z.core.$strip>>>;
-            cameras: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-                deviceId: z.ZodNumber;
-                frames: z.ZodNumber;
-                completeFrames: z.ZodNumber;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>;
+    annotationHash: z.ZodString;
+    layout: z.ZodEnum<{
+        crops: "crops";
+        frames: "frames";
+    }>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"refused">;
     reason: z.ZodEnum<{
-        "duplicate-name": "duplicate-name";
-        "empty-name": "empty-name";
         "no-frames": "no-frames";
+        "unknown-collection": "unknown-collection";
     }>;
+    detail: z.ZodString;
 }, z.core.$strip>], "kind">;
-export type CreateRetrainDatasetVersionResult = z.infer<typeof CreateRetrainDatasetVersionResultSchema>;
+export type RetrainTrainingCorpusResolveResult = z.infer<typeof RetrainTrainingCorpusResolveResultSchema>;
 /** The outcome of a lifecycle move owned by the retrain page. */
 export declare const RetrainTransitionResultSchema: z.ZodObject<{
     trackId: z.ZodString;
@@ -4245,6 +4462,121 @@ export declare const pipelineAnalyticsCapability: {
             frameCount: z.ZodNumber;
             annotationCount: z.ZodNumber;
         }, z.core.$strip>>>, "query">;
+        /**
+         * Paginated corpus copies for the Frames grid — index reads only.
+         *
+         * Filters AND (`workState`, cameras, one collection, annotated classes).
+         * An answered empty match is `{ frames: [], total: 0, … }` (D315), never a
+         * pending masquerade. Classification uses `workStateOf` (annotation count
+         * wins over a stray `complete` flag).
+         */
+        readonly listRetrainCorpusPage: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            workState: z.ZodOptional<z.ZodEnum<{
+                annotated: "annotated";
+                complete: "complete";
+                unannotated: "unannotated";
+            }>>;
+            deviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            collectionId: z.ZodOptional<z.ZodString>;
+            classes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                animal: "animal";
+                face: "face";
+                package: "package";
+                person: "person";
+                plate: "plate";
+                vehicle: "vehicle";
+            }>>>;
+            page: z.ZodDefault<z.ZodNumber>;
+            pageSize: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            frames: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                frameId: z.ZodString;
+                deviceId: z.ZodNumber;
+                origin: z.ZodEnum<{
+                    recording: "recording";
+                    track: "track";
+                }>;
+                trackId: z.ZodOptional<z.ZodString>;
+                sourceMediaId: z.ZodOptional<z.ZodNumber>;
+                epochMs: z.ZodOptional<z.ZodNumber>;
+                sourceKind: z.ZodEnum<{
+                    confirmationCrop: "confirmationCrop";
+                    crop: "crop";
+                    debugCrop: "debugCrop";
+                    faceCrop: "faceCrop";
+                    firstFrame: "firstFrame";
+                    fullFrame: "fullFrame";
+                    fullFrameBoxed: "fullFrameBoxed";
+                    keyFrame: "keyFrame";
+                    keyFrameSmall: "keyFrameSmall";
+                    lastFrame: "lastFrame";
+                    lastSceneFrame: "lastSceneFrame";
+                    plateCrop: "plateCrop";
+                    sceneFrame: "sceneFrame";
+                    snapshot: "snapshot";
+                    thumbnail: "thumbnail";
+                    thumbnailSmall: "thumbnailSmall";
+                }>;
+                sizeBytes: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                copiedAt: z.ZodNumber;
+                capturedAt: z.ZodOptional<z.ZodNumber>;
+                complete: z.ZodBoolean;
+                pipelineBoxes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    bbox: z.ZodObject<{
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                        w: z.ZodNumber;
+                        h: z.ZodNumber;
+                    }, z.core.$strip>;
+                    macroClass: z.ZodEnum<{
+                        animal: "animal";
+                        face: "face";
+                        package: "package";
+                        person: "person";
+                        plate: "plate";
+                        vehicle: "vehicle";
+                    }>;
+                    label: z.ZodOptional<z.ZodString>;
+                    subLabel: z.ZodOptional<z.ZodString>;
+                    score: z.ZodOptional<z.ZodNumber>;
+                    modelId: z.ZodOptional<z.ZodString>;
+                    trackId: z.ZodString;
+                    basis: z.ZodEnum<{
+                        position: "position";
+                        "subject-box": "subject-box";
+                    }>;
+                    deltaMs: z.ZodNumber;
+                }, z.core.$strip>>>>;
+                collectionIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+                workState: z.ZodEnum<{
+                    annotated: "annotated";
+                    complete: "complete";
+                    unannotated: "unannotated";
+                }>;
+            }, z.core.$strip>>>;
+            total: z.ZodNumber;
+            page: z.ZodNumber;
+            pageSize: z.ZodNumber;
+        }, z.core.$strip>, "query">;
+        /**
+         * Global + per-camera corpus KPI. Unfiltered totals; `%` on a camera row is
+         * `complete(camera) / corpus total`, or `null` when the corpus is empty.
+         */
+        readonly getRetrainCorpusKpi: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+            total: z.ZodNumber;
+            unannotated: z.ZodNumber;
+            annotated: z.ZodNumber;
+            complete: z.ZodNumber;
+            cameras: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                deviceId: z.ZodNumber;
+                unannotated: z.ZodNumber;
+                annotated: z.ZodNumber;
+                complete: z.ZodNumber;
+                pctOfCorpus: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, "query">;
         /**
          * What a track can contribute, and what it already has.
          *
@@ -4736,9 +5068,22 @@ export declare const pipelineAnalyticsCapability: {
             deviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
             frameIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
             collectionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            datasetVersionId: z.ZodOptional<z.ZodString>;
+            collectionId: z.ZodOptional<z.ZodString>;
             batchId: z.ZodOptional<z.ZodString>;
             completeOnly: z.ZodOptional<z.ZodBoolean>;
+            workState: z.ZodOptional<z.ZodEnum<{
+                annotated: "annotated";
+                complete: "complete";
+                unannotated: "unannotated";
+            }>>;
+            classes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                animal: "animal";
+                face: "face";
+                package: "package";
+                person: "person";
+                plate: "plate";
+                vehicle: "vehicle";
+            }>>>;
             layout: z.ZodOptional<z.ZodEnum<{
                 crops: "crops";
                 frames: "frames";
@@ -4830,9 +5175,22 @@ export declare const pipelineAnalyticsCapability: {
                 deviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
                 frameIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 collectionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                datasetVersionId: z.ZodOptional<z.ZodString>;
+                collectionId: z.ZodOptional<z.ZodString>;
                 batchId: z.ZodOptional<z.ZodString>;
                 completeOnly: z.ZodOptional<z.ZodBoolean>;
+                workState: z.ZodOptional<z.ZodEnum<{
+                    annotated: "annotated";
+                    complete: "complete";
+                    unannotated: "unannotated";
+                }>>;
+                classes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    animal: "animal";
+                    face: "face";
+                    package: "package";
+                    person: "person";
+                    plate: "plate";
+                    vehicle: "vehicle";
+                }>>>;
             }, z.core.$strip>;
             layout: z.ZodEnum<{
                 crops: "crops";
@@ -4870,9 +5228,22 @@ export declare const pipelineAnalyticsCapability: {
                 deviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
                 frameIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 collectionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                datasetVersionId: z.ZodOptional<z.ZodString>;
+                collectionId: z.ZodOptional<z.ZodString>;
                 batchId: z.ZodOptional<z.ZodString>;
                 completeOnly: z.ZodOptional<z.ZodBoolean>;
+                workState: z.ZodOptional<z.ZodEnum<{
+                    annotated: "annotated";
+                    complete: "complete";
+                    unannotated: "unannotated";
+                }>>;
+                classes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    animal: "animal";
+                    face: "face";
+                    package: "package";
+                    person: "person";
+                    plate: "plate";
+                    vehicle: "vehicle";
+                }>>>;
             }, z.core.$strip>;
             layout: z.ZodEnum<{
                 crops: "crops";
@@ -4888,168 +5259,6 @@ export declare const pipelineAnalyticsCapability: {
             frames: z.ZodNumber;
             annotations: z.ZodNumber;
         }, z.core.$strip>, "mutation">;
-        /** The counts a selection would freeze — class × camera × day/night,
-         *  completeness — without freezing anything. Index reads only. */
-        readonly previewRetrainDataset: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
-            selection: z.ZodObject<{
-                deviceIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodNumber>>>;
-                collectionIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
-                frameIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
-            }, z.core.$strip>;
-            completeOnly: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strip>, z.ZodObject<{
-            frames: z.ZodNumber;
-            completeFrames: z.ZodNumber;
-            completeness: z.ZodNumber;
-            subjects: z.ZodNumber;
-            modelErrors: z.ZodNumber;
-            hardNegatives: z.ZodNumber;
-            cells: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-                macroClass: z.ZodString;
-                deviceId: z.ZodNumber;
-                lighting: z.ZodEnum<{
-                    day: "day";
-                    night: "night";
-                    unknown: "unknown";
-                }>;
-                subjects: z.ZodNumber;
-                frames: z.ZodNumber;
-            }, z.core.$strip>>>;
-            cameras: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-                deviceId: z.ZodNumber;
-                frames: z.ZodNumber;
-                completeFrames: z.ZodNumber;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>, "query">;
-        /**
-         * Freeze a dataset version: the frames the selection yields (the same plan
-         * the annotated export builds), the hash of what they teach, the export
-         * parameters and the counts. Immutable — a different selection is a new
-         * version. Export it with `getRetrainExportUrl({ datasetVersionId })`.
-         */
-        readonly createRetrainDatasetVersion: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
-            name: z.ZodString;
-            selection: z.ZodObject<{
-                deviceIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodNumber>>>;
-                collectionIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
-                frameIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
-            }, z.core.$strip>;
-            layout: z.ZodEnum<{
-                crops: "crops";
-                frames: "frames";
-            }>;
-            completeOnly: z.ZodBoolean;
-        }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
-            kind: z.ZodLiteral<"created">;
-            version: z.ZodObject<{
-                id: z.ZodString;
-                name: z.ZodString;
-                createdAt: z.ZodNumber;
-                selection: z.ZodObject<{
-                    deviceIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodNumber>>>;
-                    collectionIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
-                    frameIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
-                }, z.core.$strip>;
-                layout: z.ZodEnum<{
-                    crops: "crops";
-                    frames: "frames";
-                }>;
-                completeOnly: z.ZodBoolean;
-                frameCount: z.ZodNumber;
-                annotationHash: z.ZodString;
-                manifestSchema: z.ZodString;
-                stats: z.ZodObject<{
-                    frames: z.ZodNumber;
-                    completeFrames: z.ZodNumber;
-                    completeness: z.ZodNumber;
-                    subjects: z.ZodNumber;
-                    modelErrors: z.ZodNumber;
-                    hardNegatives: z.ZodNumber;
-                    cells: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-                        macroClass: z.ZodString;
-                        deviceId: z.ZodNumber;
-                        lighting: z.ZodEnum<{
-                            day: "day";
-                            night: "night";
-                            unknown: "unknown";
-                        }>;
-                        subjects: z.ZodNumber;
-                        frames: z.ZodNumber;
-                    }, z.core.$strip>>>;
-                    cameras: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-                        deviceId: z.ZodNumber;
-                        frames: z.ZodNumber;
-                        completeFrames: z.ZodNumber;
-                    }, z.core.$strip>>>;
-                }, z.core.$strip>;
-            }, z.core.$strip>;
-        }, z.core.$strip>, z.ZodObject<{
-            kind: z.ZodLiteral<"refused">;
-            reason: z.ZodEnum<{
-                "duplicate-name": "duplicate-name";
-                "empty-name": "empty-name";
-                "no-frames": "no-frames";
-            }>;
-        }, z.core.$strip>], "kind">, "mutation">;
-        /** Every dataset version, newest first. */
-        readonly listRetrainDatasetVersions: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            name: z.ZodString;
-            createdAt: z.ZodNumber;
-            selection: z.ZodObject<{
-                deviceIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodNumber>>>;
-                collectionIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
-                frameIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
-            }, z.core.$strip>;
-            layout: z.ZodEnum<{
-                crops: "crops";
-                frames: "frames";
-            }>;
-            completeOnly: z.ZodBoolean;
-            frameCount: z.ZodNumber;
-            annotationHash: z.ZodString;
-            manifestSchema: z.ZodString;
-            stats: z.ZodObject<{
-                frames: z.ZodNumber;
-                completeFrames: z.ZodNumber;
-                completeness: z.ZodNumber;
-                subjects: z.ZodNumber;
-                modelErrors: z.ZodNumber;
-                hardNegatives: z.ZodNumber;
-                cells: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-                    macroClass: z.ZodString;
-                    deviceId: z.ZodNumber;
-                    lighting: z.ZodEnum<{
-                        day: "day";
-                        night: "night";
-                        unknown: "unknown";
-                    }>;
-                    subjects: z.ZodNumber;
-                    frames: z.ZodNumber;
-                }, z.core.$strip>>>;
-                cameras: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-                    deviceId: z.ZodNumber;
-                    frames: z.ZodNumber;
-                    completeFrames: z.ZodNumber;
-                }, z.core.$strip>>>;
-            }, z.core.$strip>;
-        }, z.core.$strip>>>, "query">;
-        /** Delete a version. Its frames stay in the dataset. */
-        readonly deleteRetrainDatasetVersion: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
-            id: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
-            deleted: z.ZodBoolean;
-        }, z.core.$strip>, "mutation">;
-        /** Does the corpus still teach what the version froze? `missingFrames`
-         *  counts frames that left the dataset (or lost every box and tick). */
-        readonly verifyRetrainDatasetVersion: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
-            id: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
-            found: z.ZodBoolean;
-            annotationHash: z.ZodString;
-            matches: z.ZodBoolean;
-            missingFrames: z.ZodNumber;
-        }, z.core.$strip>, "query">;
         /** The enabled, vision-capable LLM profiles, each saying whether a frame
          *  sent to it leaves the house. */
         readonly listRetrainAssistProfiles: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -5197,6 +5406,58 @@ export declare const pipelineAnalyticsCapability: {
             createdAt: z.ZodNumber;
             frameCount: z.ZodNumber;
         }, z.core.$strip>>>, "query">;
+        /**
+         * Resolve a live training corpus selection to frame ids + stats (index
+         * reads only). Same plan the annotated export builds — training plan/start
+         * calls this instead of a frozen dataset version.
+         */
+        readonly resolveRetrainTrainingCorpus: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            collectionIds: z.ZodArray<z.ZodString>;
+            workState: z.ZodDefault<z.ZodEnum<{
+                annotated_or_complete: "annotated_or_complete";
+                any_annotated: "any_annotated";
+                complete: "complete";
+            }>>;
+        }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"resolved">;
+            frameIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+            stats: z.ZodObject<{
+                frames: z.ZodNumber;
+                completeFrames: z.ZodNumber;
+                completeness: z.ZodNumber;
+                subjects: z.ZodNumber;
+                modelErrors: z.ZodNumber;
+                hardNegatives: z.ZodNumber;
+                cells: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    macroClass: z.ZodString;
+                    deviceId: z.ZodNumber;
+                    lighting: z.ZodEnum<{
+                        day: "day";
+                        night: "night";
+                        unknown: "unknown";
+                    }>;
+                    subjects: z.ZodNumber;
+                    frames: z.ZodNumber;
+                }, z.core.$strip>>>;
+                cameras: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    deviceId: z.ZodNumber;
+                    frames: z.ZodNumber;
+                    completeFrames: z.ZodNumber;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
+            annotationHash: z.ZodString;
+            layout: z.ZodEnum<{
+                crops: "crops";
+                frames: "frames";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"refused">;
+            reason: z.ZodEnum<{
+                "no-frames": "no-frames";
+                "unknown-collection": "unknown-collection";
+            }>;
+            detail: z.ZodString;
+        }, z.core.$strip>], "kind">, "query">;
         readonly renameRetrainCollection: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodString;