@camstack/types 1.2.326 → 1.2.328

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

@@ -930,11 +930,24 @@ export declare const RetrainAnnotationKindSchema: z.ZodEnum<{
     subject: "subject";
     model_error: "model_error";
 }>;
-/** Did a human draw this box, or did the assist propose it? */
+/**
+ * Where a box came from. A machine-sourced box is a DRAFT on the page until
+ * the operator confirms it; once saved it keeps its source as provenance.
+ *
+ * - `operator` — drawn by hand.
+ * - `assist`   — proposed by a detector run on the copy (the camera's own
+ *   model, or a larger teacher model).
+ * - `pipeline` — the box the live pipeline actually drew on that frame, read
+ *   back from the track store (never a re-run).
+ * - `llm`      — proposed by a vision-capable LLM profile.
+ */
 export declare const RetrainAnnotationSourceSchema: z.ZodEnum<{
     operator: "operator";
+    pipeline: "pipeline";
     assist: "assist";
+    llm: "llm";
 }>;
+export type RetrainAnnotationSource = z.infer<typeof RetrainAnnotationSourceSchema>;
 /**
  * One annotated subject.
  *
@@ -945,7 +958,7 @@ export declare const RetrainAnnotationSourceSchema: z.ZodEnum<{
  */
 export declare const RetrainAnnotationSchema: z.ZodObject<{
     id: z.ZodString;
-    trackId: z.ZodString;
+    trackId: z.ZodOptional<z.ZodString>;
     deviceId: z.ZodNumber;
     mediaKey: z.ZodString;
     bbox: z.ZodObject<{
@@ -970,7 +983,9 @@ export declare const RetrainAnnotationSchema: z.ZodObject<{
     }>;
     source: z.ZodEnum<{
         operator: "operator";
+        pipeline: "pipeline";
         assist: "assist";
+        llm: "llm";
     }>;
     assistModelId: z.ZodOptional<z.ZodString>;
     assistScore: z.ZodOptional<z.ZodNumber>;
@@ -993,7 +1008,9 @@ export declare const RetrainAnnotationDraftSchema: z.ZodObject<{
     label: z.ZodOptional<z.ZodString>;
     source: z.ZodEnum<{
         operator: "operator";
+        pipeline: "pipeline";
         assist: "assist";
+        llm: "llm";
     }>;
     subLabel: z.ZodOptional<z.ZodString>;
     macroClass: z.ZodEnum<{
@@ -1046,12 +1063,61 @@ export declare const RetrainFrameCandidateSchema: z.ZodObject<{
     copied: z.ZodBoolean;
 }, z.core.$strip>;
 export type RetrainFrameCandidate = z.infer<typeof RetrainFrameCandidateSchema>;
+/**
+ * One box the live pipeline drew on a copied frame — what a correction starts
+ * from. Derived when the frame is listed, from the track store: the subject
+ * box recorded on the source media row when there is one, else the track
+ * position nearest the frame's capture time. Never stored as an annotation
+ * until the operator confirms it.
+ */
+export declare const RetrainPipelineBoxSchema: z.ZodObject<{
+    bbox: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, z.core.$strip>;
+    macroClass: z.ZodEnum<{
+        person: "person";
+        vehicle: "vehicle";
+        animal: "animal";
+        package: "package";
+        face: "face";
+        plate: "plate";
+    }>;
+    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>;
+export type RetrainPipelineBox = z.infer<typeof RetrainPipelineBoxSchema>;
+/**
+ * Where a retrain frame came from: a TRACK's stored media (copy-on-select),
+ * or the RECORDING at an instant — the frame a model saw nothing in has no
+ * track at all.
+ */
+export declare const RetrainFrameOriginSchema: z.ZodEnum<{
+    recording: "recording";
+    track: "track";
+}>;
+export type RetrainFrameOrigin = z.infer<typeof RetrainFrameOriginSchema>;
 /** A frame the dataset OWNS: bytes copied at selection time. */
 export declare const RetrainFrameSchema: z.ZodObject<{
     frameId: z.ZodString;
     deviceId: z.ZodNumber;
-    trackId: z.ZodString;
-    sourceMediaId: 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<{
         crop: "crop";
         thumbnail: "thumbnail";
@@ -1074,6 +1140,35 @@ export declare const RetrainFrameSchema: z.ZodObject<{
     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<{
+            person: "person";
+            vehicle: "vehicle";
+            animal: "animal";
+            package: "package";
+            face: "face";
+            plate: "plate";
+        }>;
+        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>>>;
 }, z.core.$strip>;
 export type RetrainFrame = z.infer<typeof RetrainFrameSchema>;
 /** Why a copy-on-select could not be honoured — named, never a silent skip. */
@@ -1086,8 +1181,13 @@ export declare const RetrainFrameSelectionSchema: z.ZodObject<{
     copied: z.ZodReadonly<z.ZodArray<z.ZodObject<{
         frameId: z.ZodString;
         deviceId: z.ZodNumber;
-        trackId: z.ZodString;
-        sourceMediaId: 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<{
             crop: "crop";
             thumbnail: "thumbnail";
@@ -1110,6 +1210,35 @@ export declare const RetrainFrameSelectionSchema: z.ZodObject<{
         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<{
+                person: "person";
+                vehicle: "vehicle";
+                animal: "animal";
+                package: "package";
+                face: "face";
+                plate: "plate";
+            }>;
+            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>>>;
     }, z.core.$strip>>>;
     refused: z.ZodReadonly<z.ZodArray<z.ZodObject<{
         sourceMediaId: z.ZodNumber;
@@ -1149,8 +1278,13 @@ export declare const RetrainFrameListSchema: z.ZodObject<{
     copies: z.ZodReadonly<z.ZodArray<z.ZodObject<{
         frameId: z.ZodString;
         deviceId: z.ZodNumber;
-        trackId: z.ZodString;
-        sourceMediaId: 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<{
             crop: "crop";
             thumbnail: "thumbnail";
@@ -1173,10 +1307,91 @@ export declare const RetrainFrameListSchema: z.ZodObject<{
         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<{
+                person: "person";
+                vehicle: "vehicle";
+                animal: "animal";
+                package: "package";
+                face: "face";
+                plate: "plate";
+            }>;
+            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>>>;
     }, z.core.$strip>>>;
     autoPickMediaId: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type RetrainFrameList = z.infer<typeof RetrainFrameListSchema>;
+/**
+ * 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`).
+ */
+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>>;
+    batchId: z.ZodOptional<z.ZodString>;
+    completeOnly: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type RetrainExportFilter = z.infer<typeof RetrainExportFilterSchema>;
+/**
+ * `frames`: the full frame copies, boxes in `annotations.json`.
+ * `crops`: additionally one JPEG per subject, cut with the runtime detail-crop
+ * convention — the classifier layout.
+ */
+export declare const RetrainExportLayoutSchema: z.ZodEnum<{
+    frames: "frames";
+    crops: "crops";
+}>;
+export type RetrainExportLayout = z.infer<typeof RetrainExportLayoutSchema>;
+/**
+ * Where `writeRetrainArchive` streams the tar: one HTTP request whose body is
+ * the archive, sent chunk by chunk. Covers a presigned PUT and a provider
+ * addon's data-plane upload route alike. Headers are sent verbatim and never
+ * logged.
+ */
+export declare const RetrainArchiveTargetSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"http">;
+    method: z.ZodEnum<{
+        PUT: "PUT";
+        POST: "POST";
+    }>;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type RetrainArchiveTarget = z.infer<typeof RetrainArchiveTargetSchema>;
+export declare const RetrainArchiveResultSchema: z.ZodObject<{
+    batchId: z.ZodString;
+    frames: z.ZodNumber;
+    crops: z.ZodNumber;
+    annotations: z.ZodNumber;
+    missing: z.ZodNumber;
+    bytes: z.ZodNumber;
+    sha256: z.ZodString;
+    status: z.ZodNumber;
+}, z.core.$strip>;
+export type RetrainArchiveResult = z.infer<typeof RetrainArchiveResultSchema>;
 /** What the operator asked the assist to look for. */
 export declare const RetrainAssistSubjectSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"package">;
@@ -1215,7 +1430,9 @@ export declare const RetrainAssistResultSchema: z.ZodDiscriminatedUnion<[z.ZodOb
         label: z.ZodOptional<z.ZodString>;
         source: z.ZodEnum<{
             operator: "operator";
+            pipeline: "pipeline";
             assist: "assist";
+            llm: "llm";
         }>;
         subLabel: z.ZodOptional<z.ZodString>;
         macroClass: z.ZodEnum<{
@@ -1236,99 +1453,362 @@ export declare const RetrainAssistResultSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     detail: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "kind">;
 export type RetrainAssistResult = z.infer<typeof RetrainAssistResultSchema>;
-/** The outcome of a lifecycle move owned by the retrain page. */
-export declare const RetrainTransitionResultSchema: z.ZodObject<{
-    trackId: z.ZodString;
-    retrainStatus: z.ZodEnum<{
-        none: "none";
-        staging: "staging";
-        trained: "trained";
-    }>;
-    changed: z.ZodBoolean;
-    reason: z.ZodOptional<z.ZodEnum<{
-        "unknown-track": "unknown-track";
-        "no-frames-copied": "no-frames-copied";
-        "not-staging": "not-staging";
-        "not-trained": "not-trained";
-        unchanged: "unchanged";
-    }>>;
-}, z.core.$strip>;
-export type RetrainTransitionResult = z.infer<typeof RetrainTransitionResultSchema>;
-declare const RecentTracksQueryInput: z.ZodObject<{
-    deviceIds: z.ZodArray<z.ZodNumber>;
-    since: z.ZodOptional<z.ZodNumber>;
-    until: z.ZodOptional<z.ZodNumber>;
-    limit: z.ZodDefault<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    projection: z.ZodOptional<z.ZodEnum<{
-        full: "full";
-        slim: "slim";
-    }>>;
-    includeStationary: z.ZodOptional<z.ZodBoolean>;
-    classes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    excludeSources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        sensor: "sensor";
-        pipeline: "pipeline";
-        audio: "audio";
-        onboard: "onboard";
-    }>>>;
+/** A named set over the retrain corpus — membership only, it owns no pixels. */
+export declare const RetrainCollectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    createdAt: z.ZodNumber;
+    frameCount: z.ZodNumber;
 }, z.core.$strip>;
-export type RecentTracksQuery = z.infer<typeof RecentTracksQueryInput>;
-declare const RecentTracksPageSchema: z.ZodObject<{
-    tracks: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-        retrainStatus: z.ZodOptional<z.ZodEnum<{
-            none: "none";
-            staging: "staging";
-            trained: "trained";
-        }>>;
-        markForTrain: z.ZodOptional<z.ZodBoolean>;
-        debug: z.ZodOptional<z.ZodBoolean>;
-        debugNote: z.ZodOptional<z.ZodString>;
-        favourited: z.ZodOptional<z.ZodBoolean>;
-        producingDeviceName: z.ZodOptional<z.ZodString>;
-        source: z.ZodOptional<z.ZodEnum<{
-            sensor: "sensor";
-            pipeline: "pipeline";
-            audio: "audio";
-            onboard: "onboard";
-        }>>;
-        firstSeen: z.ZodNumber;
-        lastSeen: z.ZodNumber;
-        positions: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-            x: z.ZodNumber;
-            y: z.ZodNumber;
-            timestamp: z.ZodNumber;
+export type RetrainCollection = z.infer<typeof RetrainCollectionSchema>;
+export declare const RetrainCollectionCreateResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"created">;
+    collection: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        createdAt: z.ZodNumber;
+        frameCount: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"refused">;
+    reason: z.ZodEnum<{
+        "empty-name": "empty-name";
+        "duplicate-name": "duplicate-name";
+    }>;
+}, z.core.$strip>], "kind">;
+export type RetrainCollectionCreateResult = z.infer<typeof RetrainCollectionCreateResultSchema>;
+export declare const RetrainCollectionRenameResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"renamed">;
+    collection: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        createdAt: z.ZodNumber;
+        frameCount: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"refused">;
+    reason: z.ZodEnum<{
+        "empty-name": "empty-name";
+        "duplicate-name": "duplicate-name";
+        "unknown-collection": "unknown-collection";
+    }>;
+}, z.core.$strip>], "kind">;
+export type RetrainCollectionRenameResult = z.infer<typeof RetrainCollectionRenameResultSchema>;
+/**
+ * The outcome of adding the frame at a recording instant. Every refusal is
+ * named: `still-unavailable` (not recording, a gap, or an undecodable frame —
+ * `detail` says which), `still-busy` (the recorder is at its decode bound; try
+ * again), `unreadable-image`, `write-failed`, `unknown-collection`.
+ */
+export declare const AddRetrainFrameFromRecordingResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"added">;
+    collectionId: z.ZodString;
+    frame: 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<{
+            crop: "crop";
+            thumbnail: "thumbnail";
+            snapshot: "snapshot";
+            firstFrame: "firstFrame";
+            lastFrame: "lastFrame";
+            fullFrame: "fullFrame";
+            fullFrameBoxed: "fullFrameBoxed";
+            faceCrop: "faceCrop";
+            plateCrop: "plateCrop";
+            keyFrame: "keyFrame";
+            keyFrameSmall: "keyFrameSmall";
+            thumbnailSmall: "thumbnailSmall";
+            confirmationCrop: "confirmationCrop";
+            debugCrop: "debugCrop";
+            sceneFrame: "sceneFrame";
+            lastSceneFrame: "lastSceneFrame";
+        }>;
+        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>;
-            source: z.ZodOptional<z.ZodEnum<{
-                frame: "frame";
-                recovery: "recovery";
-            }>>;
+            macroClass: z.ZodEnum<{
+                person: "person";
+                vehicle: "vehicle";
+                animal: "animal";
+                package: "package";
+                face: "face";
+                plate: "plate";
+            }>;
+            label: z.ZodOptional<z.ZodString>;
+            subLabel: z.ZodOptional<z.ZodString>;
             score: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>>;
-        snapshots: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-            timestamp: z.ZodNumber;
-            position: z.ZodObject<{
-                x: z.ZodNumber;
-                y: z.ZodNumber;
-                timestamp: z.ZodNumber;
-                bbox: z.ZodObject<{
-                    x: z.ZodNumber;
-                    y: z.ZodNumber;
-                    w: z.ZodNumber;
-                    h: z.ZodNumber;
-                }, z.core.$strip>;
-                source: z.ZodOptional<z.ZodEnum<{
-                    frame: "frame";
-                    recovery: "recovery";
-                }>>;
-                score: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>;
-            mediaId: 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>>>;
+    }, z.core.$strip>;
+    reused: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"refused">;
+    reason: z.ZodEnum<{
+        "unreadable-image": "unreadable-image";
+        "write-failed": "write-failed";
+        "unknown-collection": "unknown-collection";
+        "still-unavailable": "still-unavailable";
+        "still-busy": "still-busy";
+    }>;
+    detail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">;
+export type AddRetrainFrameFromRecordingResult = z.infer<typeof AddRetrainFrameFromRecordingResultSchema>;
+/** A vision LLM profile the AI assist may use, and where it sends the frame. */
+export declare const RetrainAssistProfileSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    model: z.ZodString;
+    kind: z.ZodString;
+    leavesHouse: z.ZodBoolean;
+}, z.core.$strip>;
+export type RetrainAssistProfile = z.infer<typeof RetrainAssistProfileSchema>;
+/** A box the AI assist proposed: a draft, plus the model's own reason. */
+export declare const RetrainLlmProposalSchema: z.ZodObject<{
+    bbox: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, z.core.$strip>;
+    kind: z.ZodEnum<{
+        subject: "subject";
+        model_error: "model_error";
+    }>;
+    label: z.ZodOptional<z.ZodString>;
+    source: z.ZodEnum<{
+        operator: "operator";
+        pipeline: "pipeline";
+        assist: "assist";
+        llm: "llm";
+    }>;
+    subLabel: z.ZodOptional<z.ZodString>;
+    macroClass: z.ZodEnum<{
+        person: "person";
+        vehicle: "vehicle";
+        animal: "animal";
+        package: "package";
+        face: "face";
+        plate: "plate";
+    }>;
+    assistModelId: z.ZodOptional<z.ZodString>;
+    assistScore: z.ZodOptional<z.ZodNumber>;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type RetrainLlmProposal = z.infer<typeof RetrainLlmProposalSchema>;
+/** What the AI assist said about a box that was already on the canvas. */
+export declare const RetrainLlmReviewSchema: z.ZodObject<{
+    ref: z.ZodString;
+    verdict: z.ZodEnum<{
+        confirmed: "confirmed";
+        "wrong-class": "wrong-class";
+        "not-an-object": "not-an-object";
+        uncertain: "uncertain";
+    }>;
+    suggestedClass: z.ZodOptional<z.ZodEnum<{
+        person: "person";
+        vehicle: "vehicle";
+        animal: "animal";
+        package: "package";
+        face: "face";
+        plate: "plate";
+    }>>;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type RetrainLlmReview = z.infer<typeof RetrainLlmReviewSchema>;
+/**
+ * The AI assist's answer. `proposed` carries drafts (`source: 'llm'`, the
+ * model and its confidence) and reviews; items the model got wrong (a box off
+ * the frame, an unasked class, an unknown ref) are dropped and counted in
+ * `rejected`. A whole answer that is not the schema is `malformed-answer`.
+ */
+export declare const RetrainLlmAssistResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"proposed">;
+    profileId: z.ZodString;
+    model: z.ZodString;
+    leftHouse: z.ZodBoolean;
+    proposals: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        bbox: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, z.core.$strip>;
+        kind: z.ZodEnum<{
+            subject: "subject";
+            model_error: "model_error";
+        }>;
+        label: z.ZodOptional<z.ZodString>;
+        source: z.ZodEnum<{
+            operator: "operator";
+            pipeline: "pipeline";
+            assist: "assist";
+            llm: "llm";
+        }>;
+        subLabel: z.ZodOptional<z.ZodString>;
+        macroClass: z.ZodEnum<{
+            person: "person";
+            vehicle: "vehicle";
+            animal: "animal";
+            package: "package";
+            face: "face";
+            plate: "plate";
+        }>;
+        assistModelId: z.ZodOptional<z.ZodString>;
+        assistScore: z.ZodOptional<z.ZodNumber>;
+        reason: z.ZodString;
+    }, z.core.$strip>>>;
+    reviews: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        verdict: z.ZodEnum<{
+            confirmed: "confirmed";
+            "wrong-class": "wrong-class";
+            "not-an-object": "not-an-object";
+            uncertain: "uncertain";
+        }>;
+        suggestedClass: z.ZodOptional<z.ZodEnum<{
+            person: "person";
+            vehicle: "vehicle";
+            animal: "animal";
+            package: "package";
+            face: "face";
+            plate: "plate";
+        }>>;
+        reason: z.ZodString;
+    }, z.core.$strip>>>;
+    rejected: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"refused">;
+    reason: z.ZodEnum<{
+        "unknown-frame": "unknown-frame";
+        "unreadable-frame": "unreadable-frame";
+        "unknown-profile": "unknown-profile";
+        "profile-disabled": "profile-disabled";
+        "no-vision": "no-vision";
+        "cloud-not-confirmed": "cloud-not-confirmed";
+        "llm-error": "llm-error";
+        "malformed-answer": "malformed-answer";
+    }>;
+    detail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">;
+export type RetrainLlmAssistResult = z.infer<typeof RetrainLlmAssistResultSchema>;
+/** The outcome of a lifecycle move owned by the retrain page. */
+export declare const RetrainTransitionResultSchema: z.ZodObject<{
+    trackId: z.ZodString;
+    retrainStatus: z.ZodEnum<{
+        none: "none";
+        staging: "staging";
+        trained: "trained";
+    }>;
+    changed: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodEnum<{
+        "unknown-track": "unknown-track";
+        "no-frames-copied": "no-frames-copied";
+        "not-staging": "not-staging";
+        "not-trained": "not-trained";
+        unchanged: "unchanged";
+    }>>;
+}, z.core.$strip>;
+export type RetrainTransitionResult = z.infer<typeof RetrainTransitionResultSchema>;
+declare const RecentTracksQueryInput: z.ZodObject<{
+    deviceIds: z.ZodArray<z.ZodNumber>;
+    since: z.ZodOptional<z.ZodNumber>;
+    until: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    projection: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        slim: "slim";
+    }>>;
+    includeStationary: z.ZodOptional<z.ZodBoolean>;
+    classes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    excludeSources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        sensor: "sensor";
+        pipeline: "pipeline";
+        audio: "audio";
+        onboard: "onboard";
+    }>>>;
+}, z.core.$strip>;
+export type RecentTracksQuery = z.infer<typeof RecentTracksQueryInput>;
+declare const RecentTracksPageSchema: z.ZodObject<{
+    tracks: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        retrainStatus: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            staging: "staging";
+            trained: "trained";
+        }>>;
+        markForTrain: z.ZodOptional<z.ZodBoolean>;
+        debug: z.ZodOptional<z.ZodBoolean>;
+        debugNote: z.ZodOptional<z.ZodString>;
+        favourited: z.ZodOptional<z.ZodBoolean>;
+        producingDeviceName: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<{
+            sensor: "sensor";
+            pipeline: "pipeline";
+            audio: "audio";
+            onboard: "onboard";
+        }>>;
+        firstSeen: z.ZodNumber;
+        lastSeen: z.ZodNumber;
+        positions: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            timestamp: z.ZodNumber;
+            bbox: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, z.core.$strip>;
+            source: z.ZodOptional<z.ZodEnum<{
+                frame: "frame";
+                recovery: "recovery";
+            }>>;
+            score: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        snapshots: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            timestamp: z.ZodNumber;
+            position: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                timestamp: z.ZodNumber;
+                bbox: z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$strip>;
+                source: z.ZodOptional<z.ZodEnum<{
+                    frame: "frame";
+                    recovery: "recovery";
+                }>>;
+                score: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>;
+            mediaId: z.ZodNumber;
         }, z.core.$strip>>>;
         zonesVisited: z.ZodReadonly<z.ZodArray<z.ZodString>>;
         zoneNames: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
@@ -3676,8 +4156,13 @@ export declare const pipelineAnalyticsCapability: {
             copies: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 frameId: z.ZodString;
                 deviceId: z.ZodNumber;
-                trackId: z.ZodString;
-                sourceMediaId: 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<{
                     crop: "crop";
                     thumbnail: "thumbnail";
@@ -3700,6 +4185,35 @@ export declare const pipelineAnalyticsCapability: {
                 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<{
+                        person: "person";
+                        vehicle: "vehicle";
+                        animal: "animal";
+                        package: "package";
+                        face: "face";
+                        plate: "plate";
+                    }>;
+                    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>>>;
             }, z.core.$strip>>>;
             autoPickMediaId: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>, "query">;
@@ -3725,8 +4239,13 @@ export declare const pipelineAnalyticsCapability: {
             copied: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 frameId: z.ZodString;
                 deviceId: z.ZodNumber;
-                trackId: z.ZodString;
-                sourceMediaId: 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<{
                     crop: "crop";
                     thumbnail: "thumbnail";
@@ -3749,6 +4268,35 @@ export declare const pipelineAnalyticsCapability: {
                 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<{
+                        person: "person";
+                        vehicle: "vehicle";
+                        animal: "animal";
+                        package: "package";
+                        face: "face";
+                        plate: "plate";
+                    }>;
+                    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>>>;
             }, z.core.$strip>>>;
             refused: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 sourceMediaId: z.ZodNumber;
@@ -3764,7 +4312,7 @@ export declare const pipelineAnalyticsCapability: {
          *  a frame leaves the dataset before export. */
         readonly deselectRetrainFrame: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
-            trackId: z.ZodString;
+            trackId: z.ZodOptional<z.ZodString>;
             frameId: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
             removed: z.ZodBoolean;
@@ -3803,7 +4351,7 @@ export declare const pipelineAnalyticsCapability: {
          */
         readonly proposeRetrainAnnotations: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
-            trackId: z.ZodString;
+            trackId: z.ZodOptional<z.ZodString>;
             frameId: z.ZodString;
             subject: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"package">;
@@ -3838,7 +4386,9 @@ export declare const pipelineAnalyticsCapability: {
                 label: z.ZodOptional<z.ZodString>;
                 source: z.ZodEnum<{
                     operator: "operator";
+                    pipeline: "pipeline";
                     assist: "assist";
+                    llm: "llm";
                 }>;
                 subLabel: z.ZodOptional<z.ZodString>;
                 macroClass: z.ZodEnum<{
@@ -3858,12 +4408,14 @@ export declare const pipelineAnalyticsCapability: {
             reason: z.ZodString;
             detail: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>], "kind">, "mutation">;
-        /** Every annotation on a track, oldest first. */
+        /** Every annotation on a track, or on named frames (a recording still has
+         *  no track), oldest first. One of the two is required. */
         readonly listRetrainAnnotations: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
-            trackId: z.ZodString;
+            trackId: z.ZodOptional<z.ZodString>;
+            frameIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
-            trackId: z.ZodString;
+            trackId: z.ZodOptional<z.ZodString>;
             deviceId: z.ZodNumber;
             mediaKey: z.ZodString;
             bbox: z.ZodObject<{
@@ -3888,7 +4440,9 @@ export declare const pipelineAnalyticsCapability: {
             }>;
             source: z.ZodEnum<{
                 operator: "operator";
+                pipeline: "pipeline";
                 assist: "assist";
+                llm: "llm";
             }>;
             assistModelId: z.ZodOptional<z.ZodString>;
             assistScore: z.ZodOptional<z.ZodNumber>;
@@ -3910,7 +4464,7 @@ export declare const pipelineAnalyticsCapability: {
          */
         readonly saveRetrainAnnotations: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
-            trackId: z.ZodString;
+            trackId: z.ZodOptional<z.ZodString>;
             frameId: z.ZodString;
             annotations: z.ZodArray<z.ZodObject<{
                 bbox: z.ZodObject<{
@@ -3926,7 +4480,9 @@ export declare const pipelineAnalyticsCapability: {
                 label: z.ZodOptional<z.ZodString>;
                 source: z.ZodEnum<{
                     operator: "operator";
+                    pipeline: "pipeline";
                     assist: "assist";
+                    llm: "llm";
                 }>;
                 subLabel: z.ZodOptional<z.ZodString>;
                 macroClass: z.ZodEnum<{
@@ -3942,7 +4498,7 @@ export declare const pipelineAnalyticsCapability: {
             }, z.core.$strip>>;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
-            trackId: z.ZodString;
+            trackId: z.ZodOptional<z.ZodString>;
             deviceId: z.ZodNumber;
             mediaKey: z.ZodString;
             bbox: z.ZodObject<{
@@ -3967,7 +4523,9 @@ export declare const pipelineAnalyticsCapability: {
             }>;
             source: z.ZodEnum<{
                 operator: "operator";
+                pipeline: "pipeline";
                 assist: "assist";
+                llm: "llm";
             }>;
             assistModelId: z.ZodOptional<z.ZodString>;
             assistScore: z.ZodOptional<z.ZodNumber>;
@@ -4045,9 +4603,474 @@ export declare const pipelineAnalyticsCapability: {
          */
         readonly getRetrainExportUrl: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            frameIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            collectionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            batchId: z.ZodOptional<z.ZodString>;
+            completeOnly: z.ZodOptional<z.ZodBoolean>;
+            layout: z.ZodOptional<z.ZodEnum<{
+                frames: "frames";
+                crops: "crops";
+            }>>;
         }, z.core.$strip>, z.ZodObject<{
             url: z.ZodString;
         }, z.core.$strip>, "query">;
+        /**
+         * The operator's "every subject in this frame is boxed" — set and cleared
+         * by hand, never derived: a frame with no box may be a complete hard
+         * negative, and a frame with three boxes may still miss a fourth person.
+         */
+        readonly setRetrainFrameComplete: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            trackId: z.ZodOptional<z.ZodString>;
+            frameId: z.ZodString;
+            complete: z.ZodBoolean;
+        }, z.core.$strip>, 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<{
+                crop: "crop";
+                thumbnail: "thumbnail";
+                snapshot: "snapshot";
+                firstFrame: "firstFrame";
+                lastFrame: "lastFrame";
+                fullFrame: "fullFrame";
+                fullFrameBoxed: "fullFrameBoxed";
+                faceCrop: "faceCrop";
+                plateCrop: "plateCrop";
+                keyFrame: "keyFrame";
+                keyFrameSmall: "keyFrameSmall";
+                thumbnailSmall: "thumbnailSmall";
+                confirmationCrop: "confirmationCrop";
+                debugCrop: "debugCrop";
+                sceneFrame: "sceneFrame";
+                lastSceneFrame: "lastSceneFrame";
+            }>;
+            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<{
+                    person: "person";
+                    vehicle: "vehicle";
+                    animal: "animal";
+                    package: "package";
+                    face: "face";
+                    plate: "plate";
+                }>;
+                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>>>;
+        }, z.core.$strip>, "mutation">;
+        /**
+         * Stream the annotated archive to a TARGET instead of a browser — the
+         * same tar `getRetrainExportUrl` serves (manifest first, one JPEG in
+         * memory at a time, paced), written chunk by chunk into one HTTP request.
+         * The bytes never cross this cap and never land on the hub's disk; the
+         * answer is what was sent, with its sha256.
+         */
+        readonly writeRetrainArchive: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            filter: z.ZodObject<{
+                deviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+                frameIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                collectionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                batchId: z.ZodOptional<z.ZodString>;
+                completeOnly: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>;
+            layout: z.ZodEnum<{
+                frames: "frames";
+                crops: "crops";
+            }>;
+            target: z.ZodObject<{
+                kind: z.ZodLiteral<"http">;
+                method: z.ZodEnum<{
+                    PUT: "PUT";
+                    POST: "POST";
+                }>;
+                url: z.ZodString;
+                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            batchId: z.ZodString;
+            frames: z.ZodNumber;
+            crops: z.ZodNumber;
+            annotations: z.ZodNumber;
+            missing: z.ZodNumber;
+            bytes: z.ZodNumber;
+            sha256: z.ZodString;
+            status: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
+        /** 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<{
+            id: z.ZodString;
+            name: z.ZodString;
+            model: z.ZodString;
+            kind: z.ZodString;
+            leavesHouse: z.ZodBoolean;
+        }, z.core.$strip>>>, "query">;
+        /**
+         * Ask a vision LLM (the `llm` capability) about ONE copied frame: list the
+         * objects of `classes` with boxes, and review the boxes already on the
+         * canvas (sent by `ref`). Answers drafts (`source: 'llm'`) and reviews —
+         * nothing is stored, nothing is accepted. A profile that sends the frame
+         * outside the house is refused unless `allowCloud` says the operator
+         * confirmed this run.
+         */
+        readonly proposeRetrainAnnotationsWithLlm: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            trackId: z.ZodOptional<z.ZodString>;
+            frameId: z.ZodString;
+            profileId: z.ZodString;
+            classes: z.ZodArray<z.ZodEnum<{
+                person: "person";
+                vehicle: "vehicle";
+                animal: "animal";
+                package: "package";
+                face: "face";
+                plate: "plate";
+            }>>;
+            boxes: z.ZodArray<z.ZodObject<{
+                ref: z.ZodString;
+                bbox: z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$strip>;
+                macroClass: z.ZodEnum<{
+                    person: "person";
+                    vehicle: "vehicle";
+                    animal: "animal";
+                    package: "package";
+                    face: "face";
+                    plate: "plate";
+                }>;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            allowCloud: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"proposed">;
+            profileId: z.ZodString;
+            model: z.ZodString;
+            leftHouse: z.ZodBoolean;
+            proposals: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                bbox: z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$strip>;
+                kind: z.ZodEnum<{
+                    subject: "subject";
+                    model_error: "model_error";
+                }>;
+                label: z.ZodOptional<z.ZodString>;
+                source: z.ZodEnum<{
+                    operator: "operator";
+                    pipeline: "pipeline";
+                    assist: "assist";
+                    llm: "llm";
+                }>;
+                subLabel: z.ZodOptional<z.ZodString>;
+                macroClass: z.ZodEnum<{
+                    person: "person";
+                    vehicle: "vehicle";
+                    animal: "animal";
+                    package: "package";
+                    face: "face";
+                    plate: "plate";
+                }>;
+                assistModelId: z.ZodOptional<z.ZodString>;
+                assistScore: z.ZodOptional<z.ZodNumber>;
+                reason: z.ZodString;
+            }, z.core.$strip>>>;
+            reviews: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                ref: z.ZodString;
+                verdict: z.ZodEnum<{
+                    confirmed: "confirmed";
+                    "wrong-class": "wrong-class";
+                    "not-an-object": "not-an-object";
+                    uncertain: "uncertain";
+                }>;
+                suggestedClass: z.ZodOptional<z.ZodEnum<{
+                    person: "person";
+                    vehicle: "vehicle";
+                    animal: "animal";
+                    package: "package";
+                    face: "face";
+                    plate: "plate";
+                }>>;
+                reason: z.ZodString;
+            }, z.core.$strip>>>;
+            rejected: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"refused">;
+            reason: z.ZodEnum<{
+                "unknown-frame": "unknown-frame";
+                "unreadable-frame": "unreadable-frame";
+                "unknown-profile": "unknown-profile";
+                "profile-disabled": "profile-disabled";
+                "no-vision": "no-vision";
+                "cloud-not-confirmed": "cloud-not-confirmed";
+                "llm-error": "llm-error";
+                "malformed-answer": "malformed-answer";
+            }>;
+            detail: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "kind">, "mutation">;
+        /**
+         * Create a named collection — a set over the retrain corpus ("packages
+         * porch night"). Names are unique case-insensitively and never empty;
+         * both refusals are named.
+         */
+        readonly createRetrainCollection: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"created">;
+            collection: z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                createdAt: z.ZodNumber;
+                frameCount: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"refused">;
+            reason: z.ZodEnum<{
+                "empty-name": "empty-name";
+                "duplicate-name": "duplicate-name";
+            }>;
+        }, z.core.$strip>], "kind">, "mutation">;
+        /** Every collection, newest first, with its frame count. */
+        readonly listRetrainCollections: 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;
+            frameCount: z.ZodNumber;
+        }, z.core.$strip>>>, "query">;
+        readonly renameRetrainCollection: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"renamed">;
+            collection: z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                createdAt: z.ZodNumber;
+                frameCount: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"refused">;
+            reason: z.ZodEnum<{
+                "empty-name": "empty-name";
+                "duplicate-name": "duplicate-name";
+                "unknown-collection": "unknown-collection";
+            }>;
+        }, z.core.$strip>], "kind">, "mutation">;
+        /**
+         * Delete a collection. Its recording stills that no other collection
+         * holds are deleted with their annotations (nothing else reaches them);
+         * frames copied from tracks always stay in the dataset.
+         */
+        readonly deleteRetrainCollection: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            deleted: z.ZodBoolean;
+            removedFrames: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
+        /**
+         * Add the frame at a recording instant to a collection — the frame the
+         * model may have seen NOTHING in. The recorder re-decodes the native
+         * frame at `epochMs`; the dataset copies it (trackless, durable). The same
+         * moment twice is one copy. Every refusal is named.
+         */
+        readonly addRetrainFrameFromRecording: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            collectionId: z.ZodString;
+            deviceId: z.ZodNumber;
+            epochMs: z.ZodNumber;
+        }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"added">;
+            collectionId: z.ZodString;
+            frame: 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<{
+                    crop: "crop";
+                    thumbnail: "thumbnail";
+                    snapshot: "snapshot";
+                    firstFrame: "firstFrame";
+                    lastFrame: "lastFrame";
+                    fullFrame: "fullFrame";
+                    fullFrameBoxed: "fullFrameBoxed";
+                    faceCrop: "faceCrop";
+                    plateCrop: "plateCrop";
+                    keyFrame: "keyFrame";
+                    keyFrameSmall: "keyFrameSmall";
+                    thumbnailSmall: "thumbnailSmall";
+                    confirmationCrop: "confirmationCrop";
+                    debugCrop: "debugCrop";
+                    sceneFrame: "sceneFrame";
+                    lastSceneFrame: "lastSceneFrame";
+                }>;
+                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<{
+                        person: "person";
+                        vehicle: "vehicle";
+                        animal: "animal";
+                        package: "package";
+                        face: "face";
+                        plate: "plate";
+                    }>;
+                    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>>>;
+            }, z.core.$strip>;
+            reused: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"refused">;
+            reason: z.ZodEnum<{
+                "unreadable-image": "unreadable-image";
+                "write-failed": "write-failed";
+                "unknown-collection": "unknown-collection";
+                "still-unavailable": "still-unavailable";
+                "still-busy": "still-busy";
+            }>;
+            detail: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "kind">, "mutation">;
+        /** Add frames already in the dataset to a collection. */
+        readonly addRetrainFramesToCollection: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            collectionId: z.ZodString;
+            frameIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            added: z.ZodNumber;
+            alreadyMember: z.ZodNumber;
+            unknownFrameIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, "mutation">;
+        /** Remove a frame from a collection. A recording still left in no
+         *  collection is deleted with its annotations (`deletedFrame`). */
+        readonly removeRetrainFrameFromCollection: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            collectionId: z.ZodString;
+            frameId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            removed: z.ZodBoolean;
+            deletedFrame: z.ZodBoolean;
+        }, z.core.$strip>, "mutation">;
+        /** The frames of a collection, with their pipeline boxes. */
+        readonly listRetrainCollectionFrames: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            collectionId: z.ZodString;
+        }, z.core.$strip>, 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<{
+                crop: "crop";
+                thumbnail: "thumbnail";
+                snapshot: "snapshot";
+                firstFrame: "firstFrame";
+                lastFrame: "lastFrame";
+                fullFrame: "fullFrame";
+                fullFrameBoxed: "fullFrameBoxed";
+                faceCrop: "faceCrop";
+                plateCrop: "plateCrop";
+                keyFrame: "keyFrame";
+                keyFrameSmall: "keyFrameSmall";
+                thumbnailSmall: "thumbnailSmall";
+                confirmationCrop: "confirmationCrop";
+                debugCrop: "debugCrop";
+                sceneFrame: "sceneFrame";
+                lastSceneFrame: "lastSceneFrame";
+            }>;
+            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<{
+                    person: "person";
+                    vehicle: "vehicle";
+                    animal: "animal";
+                    package: "package";
+                    face: "face";
+                    plate: "plate";
+                }>;
+                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>>>;
+        }, z.core.$strip>>>, "query">;
         /**
          * The media an EVENT owns.
          *