@camstack/types 1.2.357 → 1.2.359

package/dist/interfaces/event-bus.d.ts

@@ -723,6 +723,12 @@ export interface TopologyNode {
      * hub, offline rows, and when the hub cannot tell. Mirrors `TopologyNodeSchema`.
      */
     readonly meshTransport?: 'tls' | 'clear';
+    /**
+     * Whether the hub holds this online agent's capability registration.
+     * `false` = online but not ready. Absent for the hub and offline rows.
+     * Mirrors `TopologyNodeSchema`.
+     */
+    readonly capabilitiesRegistered?: boolean;
 }
 /**
  * Why a broker's stream health flipped — the discriminator that separates an

package/dist/retrain-review.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Retrain review — what an operator DID to the proposals a frame was offered.
+ *
+ * A training annotation used to keep only its final box. Whether the operator
+ * accepted a pipeline box as drawn, nudged it, relabelled it, deleted it or
+ * drew a new one was lost the moment Save was pressed — and that difference is
+ * the signal that says where the model is wrong. Each saved annotation now
+ * carries the `origin` snapshot it started from, and each frame carries the
+ * proposals the operator `dismissed`; this module is the ONE place that turns
+ * those facts into a per-box verdict, so the server (list answers), the MCP
+ * tools and the viewer all read the same classification.
+ *
+ * Pure, and free of runtime imports from the capability file (type imports are
+ * erased), so the viewer can take it from `@camstack/types/client`.
+ *
+ * ## Statuses
+ *
+ * - `added`        — the operator drew it (no proposal behind it).
+ * - `removed`      — a proposal the operator dismissed (a deletion is a fact).
+ * - `reclassified` — kept, but its class or label changed.
+ * - `adjusted`     — kept, same class and label, but the rectangle moved.
+ * - `unchanged`    — kept as proposed.
+ * - `model-error`  — kept as a deliberate "do not detect here". NOT `removed`:
+ *   a removed proposal teaches nothing, a model error teaches the detector a
+ *   specific false positive. The two must never be counted together.
+ *
+ * ## Exact versus approximate
+ *
+ * A row saved with an `origin` is judged against that snapshot: exact. A row
+ * saved before origins existed has none; it is matched against the proposals
+ * the pipeline would draw now (exact bbox first, then best overlap) and every
+ * verdict reached that way is flagged `approximate`, because a re-derived
+ * proposal is not the one the operator saw.
+ */
+import type { RetrainDismissed, RetrainOrigin } from './capabilities/pipeline-analytics.cap.js';
+/** Every status, in the order a summary lists them. */
+export declare const RETRAIN_REVIEW_STATUSES: readonly ['unchanged', 'adjusted', 'reclassified', 'added', 'removed', 'model-error'];
+/** One of {@link RETRAIN_REVIEW_STATUSES} (the cap's `RetrainReviewStatus` is the same union). */
+export type RetrainReviewStatusName = (typeof RETRAIN_REVIEW_STATUSES)[number];
+/**
+ * Two boxes overlapping at least this much are the same subject when a legacy
+ * row (no origin) is matched against a proposal. Deliberately loose: a legacy
+ * row is judged on evidence that is no longer exact.
+ */
+export declare const RETRAIN_REVIEW_MATCH_IOU = 0.5;
+/**
+ * A kept box overlapping its origin at least this much is `unchanged`; below it
+ * the rectangle was moved or resized on purpose (`adjusted`). Not 1.0: the
+ * canvas rounds, and a box dragged by one pixel and dragged back is not an edit.
+ */
+export declare const RETRAIN_REVIEW_ADJUSTED_IOU = 0.95;
+/** The facts about a saved box the classification reads. */
+export interface RetrainReviewSavedBox {
+    readonly id: string;
+    readonly bbox: RetrainOrigin['bbox'];
+    readonly macroClass: RetrainOrigin['macroClass'];
+    readonly label?: string;
+    readonly kind: 'subject' | 'model_error';
+    /** The snapshot the box started from; `null` on a pre-origin row. */
+    readonly origin: RetrainOrigin | null;
+}
+/** One verdict: a saved box, or a dismissed / vanished proposal. */
+export interface RetrainReviewBox {
+    /** The saved row's id, or the proposal's ref for a `removed` verdict. */
+    readonly ref: string;
+    readonly savedId?: string;
+    readonly status: RetrainReviewStatusName;
+    /** `true` when the baseline was re-derived rather than snapshotted. */
+    readonly approximate: boolean;
+    /** The proposal this box was judged against, when there was one. */
+    readonly origin?: RetrainOrigin;
+    /** Overlap with that proposal, when both rectangles exist. */
+    readonly iou?: number;
+}
+export interface RetrainReview {
+    readonly boxes: readonly RetrainReviewBox[];
+    /** Any verdict in `boxes` is approximate. */
+    readonly approximate: boolean;
+}
+export interface RetrainReviewOptions {
+    /** Overlap that makes a legacy row and a proposal one subject. */
+    readonly matchIou?: number;
+    /** Overlap below which a kept box counts as `adjusted`. */
+    readonly adjustedIou?: number;
+    /**
+     * Treat a proposal nobody claimed as `removed` (approximate). Only for a
+     * frame whose rows predate origins: with exact data an unclaimed proposal is
+     * simply one the operator has not decided on yet, and must not be reported.
+     */
+    readonly inferRemoved?: boolean;
+}
+export interface RetrainReviewSummary {
+    readonly counts: Readonly<Record<RetrainReviewStatusName, number>>;
+    readonly total: number;
+    /** Verdicts other than `unchanged` — the frames worth a second look. */
+    readonly changed: number;
+    readonly approximate: boolean;
+}
+/** Intersection over union of two normalised rectangles. */
+export declare function retrainBoxIou(a: RetrainOrigin['bbox'], b: RetrainOrigin['bbox']): number;
+/**
+ * Classify what the operator did on ONE frame.
+ *
+ * @param saved     the frame's saved boxes.
+ * @param origins   the proposals known now (the pipeline's boxes, re-derived) —
+ *                  consulted ONLY for rows that carry no origin snapshot.
+ * @param dismissed the proposals the operator deleted, with their snapshots.
+ */
+export declare function classifyRetrainReview(saved: readonly RetrainReviewSavedBox[], origins: readonly RetrainOrigin[], dismissed: readonly RetrainDismissed[], opts?: RetrainReviewOptions): RetrainReview;
+/** Counts per status, plus the totals a list row shows. */
+export declare function summarizeReview(review: RetrainReview): RetrainReviewSummary;
+/** The prefix of the error a stale `expectedRevision` save is refused with. */
+export declare const RETRAIN_REVISION_CONFLICT = "retrain-revision-conflict";
+export interface RetrainRevisionConflict {
+    readonly currentRevision: number;
+    readonly expectedRevision: number;
+}
+/** The message a refused save carries — `parseRetrainRevisionConflict` reads it back. */
+export declare function retrainRevisionConflictMessage(frameId: string, conflict: RetrainRevisionConflict): string;
+/** The conflict an error message names, or `null` when it is some other error. */
+export declare function parseRetrainRevisionConflict(message: string): RetrainRevisionConflict | null;

package/dist/{sleep-vWTnHq9G.mjs → sleep-BBF1iXUi.mjs}

@@ -5131,6 +5131,7 @@ function createDeviceProxy(api, binding, opts) {
 		proposeRetrainAnnotations: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "proposeRetrainAnnotations", "mutation", input),
 		listRetrainAnnotations: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listRetrainAnnotations", "query", input),
 		saveRetrainAnnotations: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "saveRetrainAnnotations", "mutation", input),
+		backfillRetrainOrigins: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "backfillRetrainOrigins", "mutation", input),
 		completeRetrainTrack: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "completeRetrainTrack", "mutation", input),
 		restageRetrainTrack: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "restageRetrainTrack", "mutation", input),
 		getRetrainExportUrl: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getRetrainExportUrl", "query", input),
@@ -5414,6 +5415,8 @@ function createDeviceProxy(api, binding, opts) {
 		getAudioAssignment: (input) => dispatchSystem("pipelineOrchestrator", "getAudioAssignment", "query", input),
 		getCameraSettings: (input) => dispatchSystem("pipelineOrchestrator", "getCameraSettings", "query", input),
 		setCameraStepToggle: (input) => dispatchSystem("pipelineOrchestrator", "setCameraStepToggle", "mutation", input),
+		getCameraDetectionSource: (input) => dispatchSystem("pipelineOrchestrator", "getCameraDetectionSource", "query", input),
+		setCameraDetectionSource: (input) => dispatchSystem("pipelineOrchestrator", "setCameraDetectionSource", "mutation", input),
 		getCameraStepOverrides: (input) => dispatchSystem("pipelineOrchestrator", "getCameraStepOverrides", "query", input),
 		setCameraStepOverride: (input) => dispatchSystem("pipelineOrchestrator", "setCameraStepOverride", "mutation", input),
 		setCameraStepSettings: (input) => dispatchSystem("pipelineOrchestrator", "setCameraStepSettings", "mutation", input),

package/dist/{sleep-BFVY4_xY.js → sleep-BBXNq778.js}

@@ -5131,6 +5131,7 @@ function createDeviceProxy(api, binding, opts) {
 		proposeRetrainAnnotations: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "proposeRetrainAnnotations", "mutation", input),
 		listRetrainAnnotations: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listRetrainAnnotations", "query", input),
 		saveRetrainAnnotations: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "saveRetrainAnnotations", "mutation", input),
+		backfillRetrainOrigins: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "backfillRetrainOrigins", "mutation", input),
 		completeRetrainTrack: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "completeRetrainTrack", "mutation", input),
 		restageRetrainTrack: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "restageRetrainTrack", "mutation", input),
 		getRetrainExportUrl: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getRetrainExportUrl", "query", input),
@@ -5414,6 +5415,8 @@ function createDeviceProxy(api, binding, opts) {
 		getAudioAssignment: (input) => dispatchSystem("pipelineOrchestrator", "getAudioAssignment", "query", input),
 		getCameraSettings: (input) => dispatchSystem("pipelineOrchestrator", "getCameraSettings", "query", input),
 		setCameraStepToggle: (input) => dispatchSystem("pipelineOrchestrator", "setCameraStepToggle", "mutation", input),
+		getCameraDetectionSource: (input) => dispatchSystem("pipelineOrchestrator", "getCameraDetectionSource", "query", input),
+		setCameraDetectionSource: (input) => dispatchSystem("pipelineOrchestrator", "setCameraDetectionSource", "mutation", input),
 		getCameraStepOverrides: (input) => dispatchSystem("pipelineOrchestrator", "getCameraStepOverrides", "query", input),
 		setCameraStepOverride: (input) => dispatchSystem("pipelineOrchestrator", "setCameraStepOverride", "mutation", input),
 		setCameraStepSettings: (input) => dispatchSystem("pipelineOrchestrator", "setCameraStepSettings", "mutation", input),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.357",
+  "version": "1.2.359",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",