@camstack/addon-notifiers 1.2.47 → 1.2.50

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/addon.js +387 -19
  2. package/dist/addon.mjs +387 -19
  3. package/package.json +1 -1
package/dist/addon.js CHANGED
@@ -8136,6 +8136,21 @@ var RelocateJobSchema = object({
8136
8136
  bytesMoved: number().int(),
8137
8137
  /** Total files discovered up front; null while (or when) unknown. */
8138
8138
  filesTotal: number().int().nullable(),
8139
+ /**
8140
+ * Rows this run CORRECTED while moving them — a durable mutation the move
8141
+ * made that nobody asked for, so it is reported where the operator reads the
8142
+ * job rather than only in a log line.
8143
+ *
8144
+ * A footage segment records its byte count in its own NAME, and the durable
8145
+ * hour row derives its aggregates from those names. A file that does not
8146
+ * match its name therefore makes the ledger's sums — and with them quota and
8147
+ * pressure eviction — wrong by the difference, and only a rename can fix it.
8148
+ * On 2026-08-30 one such row also stalled a 110 749-file drain permanently.
8149
+ *
8150
+ * Absent on lanes where the question has no meaning: a media blob's size is
8151
+ * in its row, not in its name, so `MediaRelocateEngine` never reconciles one.
8152
+ */
8153
+ rowsReconciled: number().int().nonnegative().optional(),
8139
8154
  startedAt: number(),
8140
8155
  finishedAt: number().nullable(),
8141
8156
  error: string().nullable()
@@ -8204,14 +8219,42 @@ var RelocateMediaInputSchema = object({
8204
8219
  /** Omitted = `move`, the pre-existing behaviour. */
8205
8220
  mode: MediaRelocateModeSchema.optional()
8206
8221
  });
8207
- /** How many rows still carry NO `locationId` — the population a repoint would
8208
- * silently re-aim at a disk that does not hold their bytes. Zero is the only
8209
- * value that permits a non-blocking `eventMedia` cutover. */
8210
- var UnstampedEventMediaCountSchema = object({
8211
- media: number().int().nonnegative(),
8212
- retrainFrames: number().int().nonnegative(),
8213
- total: number().int().nonnegative()
8222
+ /**
8223
+ * The unstamped population of ONE collection — split, because the gate and the
8224
+ * operator ask two different questions and only one of them has to be cheap.
8225
+ *
8226
+ * `present` is the GATE: "is there at least one row that would be orphaned by a
8227
+ * repoint". It is a single indexed seek to the first matching row, so it stays
8228
+ * answerable on a saturated disk and answers in O(log n) precisely in the state
8229
+ * that matters — after a seal, when the population is empty.
8230
+ *
8231
+ * `rows` is the NUMBER, for the refusal message and the operator's sense of
8232
+ * scale. It is a second, indexed `COUNT(*)`, and `null` means **not
8233
+ * measurable** — never zero. `{ present: true, rows: null }` is a legitimate
8234
+ * and useful answer: "there are some, and this read could not say how many"
8235
+ * still refuses the cutover, which is the whole job.
8236
+ */
8237
+ var UnstampedRowsSchema = object({
8238
+ present: boolean(),
8239
+ rows: number().int().nonnegative().nullable()
8214
8240
  });
8241
+ /**
8242
+ * How many rows still carry NO `locationId` — the population a repoint would
8243
+ * silently re-aim at a disk that does not hold their bytes.
8244
+ *
8245
+ * **`null` = the count could not be taken**, and it is NOT permission to cut
8246
+ * over. The gate opens on a measured absence and on nothing else; an unread
8247
+ * collection and an empty one are different facts, and this repo has already
8248
+ * paid for conflating them (`RelocateResidueSchema`, D295).
8249
+ */
8250
+ var UnstampedEventMediaCountSchema = object({
8251
+ media: UnstampedRowsSchema,
8252
+ retrainFrames: UnstampedRowsSchema,
8253
+ /** True when EITHER collection holds one. The refusal reads this. */
8254
+ anyPresent: boolean(),
8255
+ /** Sum across both, or `null` when either lane could not be counted. */
8256
+ total: number().int().nonnegative().nullable()
8257
+ }).nullable();
8215
8258
  var StorageMigrationMediaMoveInputSchema = RelocateMediaInputSchema.extend({ leaseId: string().min(1) });
8216
8259
  /** The independently selectable logical storage classes — every class
8217
8260
  * `storage.listLocationDeclarations` reports, so an operator never meets a
@@ -8297,13 +8340,53 @@ var StorageMigrationParticipantSchema = _enum([
8297
8340
  "recorder",
8298
8341
  "analytics"
8299
8342
  ]);
8343
+ /**
8344
+ * The mover's own numbers, folded onto the coordinator's durable move record.
8345
+ *
8346
+ * The long half of a non-blocking migration is `draining`, and it is measured
8347
+ * in hours: 136 885 files at ~4 MB/s is about five of them. Before this shape
8348
+ * existed the only place those numbers appeared was a Loki line, so an operator
8349
+ * watching the Admin UI saw `phase: draining` and nothing else for a whole
8350
+ * afternoon.
8351
+ *
8352
+ * It is POLLED, never pushed. Events are telemetry and may be dropped
8353
+ * (D8/D11), and a dropped progress event is indistinguishable from a stalled
8354
+ * mover — which is the exact failure this is meant to end. The coordinator's
8355
+ * `waitForMoves` already fetches the whole {@link RelocateJob} on every tick to
8356
+ * read `state`; folding the counters costs no extra read and makes the durable
8357
+ * record say afterwards how far a move actually got.
8358
+ *
8359
+ * `filesTotal` is `null` for "no honest denominator" and is never zero-filled:
8360
+ * a windowed footage job (`sinceMs`) and a node with no ledger both genuinely
8361
+ * cannot say M, and a 0 there would render as "100 % done".
8362
+ */
8363
+ var StorageMigrationMoveProgressSchema = object({
8364
+ filesMoved: number().int().nonnegative(),
8365
+ /** The archive census — the **M** of "N of M" (D295). `null` = unknowable. */
8366
+ filesTotal: number().int().nonnegative().nullable(),
8367
+ bytesMoved: number().int().nonnegative(),
8368
+ /** Rows the mover corrected while moving them — see `RelocateJob`. Absent on
8369
+ * a lane that cannot reconcile. A migration that silently rewrote durable
8370
+ * rows would be the same failure as one that silently skipped them. */
8371
+ rowsReconciled: number().int().nonnegative().optional(),
8372
+ /** The MOVER's start, not the migration's: a drain restarted after an addon
8373
+ * crash gets a new mover, and a rate computed from the migration's start
8374
+ * would silently average in the time nothing was running. */
8375
+ startedAt: number(),
8376
+ /** When the coordinator last read these numbers. Paired with `startedAt` it
8377
+ * is the only honest rate: both clocks are the hub's, so a UI never has to
8378
+ * subtract its own. */
8379
+ observedAt: number()
8380
+ });
8300
8381
  var StorageMigrationMoveSchema = object({
8301
8382
  storageClass: StorageMigrationClassSchema,
8302
8383
  fromLocationId: string(),
8303
8384
  toLocationId: string(),
8304
8385
  moverJobId: string().nullable(),
8305
8386
  state: RelocateJobStateSchema.nullable(),
8306
- error: string().nullable()
8387
+ error: string().nullable(),
8388
+ /** Last observed mover counters; `null` until the mover has been polled once. */
8389
+ progress: StorageMigrationMoveProgressSchema.nullable()
8307
8390
  });
8308
8391
  var StorageMigrationJobSchema = object({
8309
8392
  jobId: string(),
@@ -8349,6 +8432,98 @@ var StorageMigrationPlanSchema = object({
8349
8432
  findings: array(StorageMigrationFindingSchema)
8350
8433
  });
8351
8434
  /**
8435
+ * A mover as it exists RIGHT NOW, whether or not a migration job owns it.
8436
+ *
8437
+ * The coordinator's job record is the state of record for a migration, and its
8438
+ * moves carry {@link StorageMigrationMoveProgress}. But the movers are usable
8439
+ * standalone — `recording.relocateFootage` and `pipelineAnalytics.relocateMedia`
8440
+ * are both operator-callable, and on 2026-08-29 a five-hour drain was armed that
8441
+ * way because no supported UI path existed. A mover armed like that has no job
8442
+ * to fold progress into, so it has to be readable on its own or it is invisible.
8443
+ *
8444
+ * `migrationJobId` is what tells the two apart: `null` means nothing here
8445
+ * orchestrated it.
8446
+ */
8447
+ var StorageMigrationMoverSchema = object({
8448
+ lane: _enum(["footage", "media"]),
8449
+ job: RelocateJobSchema,
8450
+ /** The coordinator job that armed this mover, or `null` for a mover armed
8451
+ * directly against the owning addon. */
8452
+ migrationJobId: string().nullable(),
8453
+ /** When the hub read these counters. Stamped here so a rate is `bytesMoved`
8454
+ * over (`observedAt` − `job.startedAt`) with BOTH ends on the hub's clock —
8455
+ * a browser subtracting its own `Date.now()` from a server `startedAt` is a
8456
+ * rate made of two different clocks. */
8457
+ observedAt: number()
8458
+ });
8459
+ /**
8460
+ * What a SOURCE still holds for one storage class — the number that makes a
8461
+ * "drain remaining" action honest rather than hopeful.
8462
+ *
8463
+ * It comes from the archive (`SegmentHourLedger.census` for footage, the media
8464
+ * engine's own selection count for media), never from the resident index: a
8465
+ * drain sized off `RecordingIndex` is what reported `done` over 80.3 GB it had
8466
+ * never been told about (D295).
8467
+ *
8468
+ * `items`/`bytes` are `null` for "the archive could not be asked", which is
8469
+ * deliberately NOT zero: a drain is still offered for an unknown residue,
8470
+ * because refusing on an unanswerable read would hide exactly the case an
8471
+ * operator needs to act on.
8472
+ */
8473
+ var StorageMigrationResidueSchema = object({
8474
+ storageClass: StorageMigrationClassSchema,
8475
+ /** The location still holding the data. `'*'` for the media lane, whose rows
8476
+ * move from wherever they are rather than from one named source. */
8477
+ fromLocationId: string(),
8478
+ /** Where a drain would move it — the class's CURRENT default. */
8479
+ toLocationId: string(),
8480
+ /** Segments (footage lane) or rows (media lane) still on the source. */
8481
+ items: number().int().nonnegative().nullable(),
8482
+ /** Bytes on the source; `null` when the lane counts rows rather than bytes. */
8483
+ bytes: number().int().nonnegative().nullable()
8484
+ });
8485
+ /**
8486
+ * Run the DRAIN half and nothing else.
8487
+ *
8488
+ * A migration that reached `done` has already repointed, so `start` correctly
8489
+ * refuses its destination ("already the default") — there is nothing left to
8490
+ * repoint. But the drain can fail, be cancelled, be interrupted by a restart,
8491
+ * or finish against a work list that was a tenth of the archive (D295), and
8492
+ * before this there was no supported way to run only that half: the only way
8493
+ * through was calling `recording.relocateFootage` by hand over admin tRPC.
8494
+ *
8495
+ * `drain` NEVER calls `setDefaultLocations`. That is what keeps `start`'s
8496
+ * refusal meaningful: the two verbs are disjoint, so nothing here can silently
8497
+ * re-repoint a class that is already migrated.
8498
+ */
8499
+ var StorageMigrationDrainInputSchema = object({
8500
+ /** The classes to drain. Each must appear in `storageMigration.residue`, so
8501
+ * a class whose source is already empty is refused rather than started. */
8502
+ classes: array(StorageMigrationClassSchema).min(1),
8503
+ throttleMbps: number().min(1).max(1e3).optional()
8504
+ });
8505
+ /** What a footage source still holds, asked of the durable hour ledger. */
8506
+ var RelocateResidueInputSchema = object({
8507
+ fromLocationId: string().min(1),
8508
+ /** Narrow to one logical class; omit for every profile on the location. */
8509
+ footageClass: RelocateFootageClassSchema.optional()
8510
+ });
8511
+ /** `null` = the archive could not answer (no ledger on this node, or the
8512
+ * aggregate failed). Never conflated with an empty source. */
8513
+ var RelocateResidueSchema = object({
8514
+ segments: number().int().nonnegative(),
8515
+ bytes: number().int().nonnegative()
8516
+ }).nullable();
8517
+ /** How many rows a media pass would still act on against a given target — the
8518
+ * media lane's denominator AND its residue, from ONE derivation so the two can
8519
+ * never disagree. `null` = the count could not be taken. */
8520
+ var RelocatableMediaCountSchema = object({ rows: number().int().nonnegative() }).nullable();
8521
+ var RelocatableMediaCountInputSchema = object({
8522
+ toLocationId: string().min(1),
8523
+ /** Omitted = `move`. */
8524
+ mode: MediaRelocateModeSchema.optional()
8525
+ });
8526
+ /**
8352
8527
  * `StorageLocationType` — an addon-declared id that identifies the *kind* of
8353
8528
  * storage a location serves. Defined here (not in `capabilities/storage.cap.ts`)
8354
8529
  * so the persisted record schema and the consumer-facing cap can both consume it
@@ -8452,6 +8627,32 @@ var StorageLocationRefSchema = union([StorageLocationTypeSchema, string().regex(
8452
8627
  * two addons declaring the same `id` must agree on `cardinality` (validated
8453
8628
  * at kernel aggregation time, not here).
8454
8629
  */
8630
+ /**
8631
+ * `StorageAccess` — how the service that DECLARED a storage-location kind
8632
+ * actually reaches the bytes. It is the constraint that decides which
8633
+ * `storage-provider`s may back a location of that kind.
8634
+ *
8635
+ * - `'local-path'` — the service asks `storage.resolve` for a path string and
8636
+ * then does its own `node:fs` I/O on it (the recorder's segment writer, the
8637
+ * post-analysis media roots). Only a provider that serves a genuine local
8638
+ * filesystem (`getProviderInfo().nodeLocal === true`) can satisfy that: a
8639
+ * remote provider's `resolve` returns a path on the REMOTE host, and
8640
+ * `fs.readdir` of it on this node either fails or — far worse — succeeds
8641
+ * against a same-named local directory that is something else entirely.
8642
+ *
8643
+ * - `'cap-mediated'` — every byte travels through the `storage` cap
8644
+ * (`read`/`write`, or `beginUpload`/`writeChunk`/`finalizeUpload`). The
8645
+ * service never sees a path, so any provider can back it. `backups` is the
8646
+ * one kind that qualifies today.
8647
+ *
8648
+ * Before this existed, `recordings` was unreachable by SFTP/S3/WebDAV only as
8649
+ * an EMERGENT property of how the recorder happened to be written. Nothing
8650
+ * refused the configuration; the first write simply went somewhere wrong, and
8651
+ * a recording write that goes wrong surfaces as a silent black window rather
8652
+ * than an error (the read path does not `stat`). This turns that accident into
8653
+ * a declared, enforced, testable refusal.
8654
+ */
8655
+ var StorageAccessSchema = _enum(["local-path", "cap-mediated"]);
8455
8656
  var StorageLocationDeclarationSchema = object({
8456
8657
  /**
8457
8658
  * Global location identifier, e.g. `recordings` or `recordingsLow`.
@@ -8471,6 +8672,19 @@ var StorageLocationDeclarationSchema = object({
8471
8672
  */
8472
8673
  cardinality: _enum(["single", "multi"]),
8473
8674
  /**
8675
+ * HOW the declaring service reaches the bytes — and therefore WHICH
8676
+ * providers may back a location of this kind. See {@link StorageAccessSchema}
8677
+ * and {@link STORAGE_ACCESS_FALLBACK}.
8678
+ *
8679
+ * Absent means `'local-path'`. That default is FAIL-CLOSED on purpose: it
8680
+ * can only over-restrict (refuse a remote provider for a kind that might
8681
+ * have coped) and never under-restrict. Declaring `'cap-mediated'` is the
8682
+ * permissive direction and is therefore never inferred — a repo guard
8683
+ * (`scripts/check-storage-access-declarations.ts`) refuses to let it be
8684
+ * reached by omission.
8685
+ */
8686
+ access: StorageAccessSchema.optional(),
8687
+ /**
8474
8688
  * When set, the default instance for this location inherits its resolved
8475
8689
  * root from the named location's default instance. Useful for derivative
8476
8690
  * slots (e.g. `recordingsLow` → `recordings`) so operators only need to
@@ -18051,8 +18265,10 @@ var TrackSchema = object({
18051
18265
  lastSeen: number(),
18052
18266
  /** Frame-rate position history (subject to maxPositionHistory cap). */
18053
18267
  positions: array(TrackPositionSchema).readonly(),
18054
- /** Periodic snapshots at snapshotIntervalMs cadence (subject to
18055
- * saveThumbnails policy). */
18268
+ /** Periodic snapshots at snapshotIntervalMs cadence — DEBUG media, produced
18269
+ * only while `MediaSettings.debugMediaEnabled` is on for the camera (D299;
18270
+ * the retired `saveThumbnails` used to gate this and the rolling
18271
+ * `lastFrame` together). Empty is the healthy default, not a capture gap. */
18056
18272
  snapshots: array(TrackSnapshotSchema).readonly(),
18057
18273
  /** Deduplicated zones the track has entered at least once. Zone IDS. */
18058
18274
  zonesVisited: array(string()).readonly(),
@@ -18912,7 +19128,10 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
18912
19128
  }), method(RelocateMediaInputSchema, object({ jobId: string() }), {
18913
19129
  kind: "mutation",
18914
19130
  auth: "admin"
18915
- }), method(object({}), UnstampedEventMediaCountSchema, { auth: "admin" }), method(object({}), array(RelocateJobSchema).readonly(), {
19131
+ }), method(object({}), UnstampedEventMediaCountSchema, { auth: "admin" }), method(RelocatableMediaCountInputSchema, RelocatableMediaCountSchema, {
19132
+ kind: "query",
19133
+ auth: "admin"
19134
+ }), method(object({}), array(RelocateJobSchema).readonly(), {
18916
19135
  kind: "query",
18917
19136
  auth: "admin"
18918
19137
  }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
@@ -20871,6 +21090,9 @@ method(StorageMigrationInputSchema, StorageMigrationPlanSchema, { auth: "admin"
20871
21090
  }), method(object({ jobId: string().optional() }), StorageMigrationJobSchema.nullable(), { auth: "admin" }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
20872
21091
  kind: "mutation",
20873
21092
  auth: "admin"
21093
+ }), method(object({}), array(StorageMigrationMoverSchema).readonly(), { auth: "admin" }), method(object({}), array(StorageMigrationResidueSchema).readonly(), { auth: "admin" }), method(StorageMigrationDrainInputSchema, object({ jobId: string() }), {
21094
+ kind: "mutation",
21095
+ auth: "admin"
20874
21096
  });
20875
21097
  var ProviderInfoSchema = discriminatedUnion("shouldSaveDiskSpace", [object({
20876
21098
  providerId: string().min(1),
@@ -21269,12 +21491,38 @@ response: record(string(), unknown()) }), object({
21269
21491
  *
21270
21492
  * ## Why this is a capability and not a helper
21271
21493
  *
21272
- * Six stores in `addon-post-analysis` already hold vectors — object CLIP, face,
21273
- * plate, vehicle, identity, and the event store's derivatives — and every one of
21274
- * them keeps its vectors in a `JSON` settings-store column and ranks them by
21275
- * brute-force cosine in JS. Measured on the live hub that costs ~11.7 KB per row
21276
- * (512 floats as TEXT, `JSON.parse`d on every search) and made semantic search
21277
- * load 5,000 rows before ranking anything.
21494
+ * This capability was introduced with the claim that SIX stores in
21495
+ * `addon-post-analysis` held vectors in a `JSON` settings-store column — object
21496
+ * CLIP, face, plate, vehicle, identity, and the event store's derivatives. That
21497
+ * claim was never true, and leaving it here made five stores look like pending
21498
+ * work when three of them have no vector at all. Counted column by column on
21499
+ * 2026-08-30, exactly THREE ever held one:
21500
+ *
21501
+ * - `object-clip` — 512-dim CLIP image embedding, migrated 2026-08-06.
21502
+ * - `faces.embedding` — 512-dim ArcFace face embedding, migrated 2026-08-30.
21503
+ * - `identity-samples.embedding` — the same ArcFace vector for an ENROLLED
21504
+ * face, migrated 2026-08-30 into its OWN index (see below).
21505
+ *
21506
+ * `plates` and `vehicle-samples` store a plate STRING and a score; `vehicles`
21507
+ * and `identities` store a name; the event store stores no derivative vector.
21508
+ * They are not migration candidates and never were.
21509
+ *
21510
+ * Measured on the live hub the JSON encoding cost ~11.7 KB per row (512 floats
21511
+ * as TEXT, `JSON.parse`d on every search) and made semantic search load 5,000
21512
+ * rows before ranking anything.
21513
+ *
21514
+ * ## One index per COMPARISON, never per encoder
21515
+ *
21516
+ * `faces` and `identity-samples` hold the same 512 ArcFace dims from the same
21517
+ * model, and they still get two indexes. An index is a set of things that are
21518
+ * ranked against each other and that live and die together, and these two are
21519
+ * neither: a `faces` row is TRACK-OWNED and cascades away with its track under
21520
+ * a per-camera capacity cap, an `identity-samples` row is retention-EXEMPT
21521
+ * forever and is the gallery every recognition ranks against. One index would
21522
+ * mean every gallery load and every reconcile carried a filter whose failure
21523
+ * mode is either ranking a candidate against itself or reclaiming an enrolled
21524
+ * person's only sample. The dimension they share is not a reason to share an
21525
+ * index; the question they answer is, and it differs.
21278
21526
  *
21279
21527
  * The fix is not a faster loop, it is a different backend — and the backend
21280
21528
  * should be replaceable without touching six callers. So: a singleton
@@ -21379,7 +21627,20 @@ var VectorQueryResultSchema = object({
21379
21627
  */
21380
21628
  scanned: number(),
21381
21629
  /** True when the backend could not consider every row that passed the filter. */
21382
- truncated: boolean()
21630
+ truncated: boolean(),
21631
+ /**
21632
+ * The `topK` the backend actually ran with.
21633
+ *
21634
+ * Every backend has a ceiling — sqlite-vec's is 4,096 — and a caller asking
21635
+ * past it used to learn nothing but a boolean, from a WARN in the provider's
21636
+ * own log rather than in its answer. That is how an audit asking for 20,000
21637
+ * consumed 4,096 and reported `examined: 4096` as if it had walked the index,
21638
+ * for weeks. `truncated` says THAT the answer was short; this says BY HOW
21639
+ * MUCH, in the return value, where the caller cannot fail to see it.
21640
+ *
21641
+ * Equals the requested `topK` whenever nothing was lowered.
21642
+ */
21643
+ effectiveTopK: number().int().positive()
21383
21644
  });
21384
21645
  var VectorDeleteInputSchema = object({
21385
21646
  index: string(),
@@ -21408,6 +21669,68 @@ var VectorGetResultSchema = object({ items: array(object({
21408
21669
  id: string(),
21409
21670
  metadata: VectorMetadataSchema
21410
21671
  })) });
21672
+ /**
21673
+ * Ids to read back WITH their vectors.
21674
+ *
21675
+ * The sibling of {@link VectorGetResultSchema}, and deliberately a separate
21676
+ * method rather than a flag on it: `getByIds` promises no vectors and its one
21677
+ * caller depends on that promise. This one promises the opposite.
21678
+ *
21679
+ * It exists because a store cannot put its vectors here otherwise. An ArcFace
21680
+ * gallery is ranked IN PROCESS, per detection, against every enrolled sample —
21681
+ * a per-face cross-process KNN would be a network round trip inside the
21682
+ * recognition loop. So the gallery is loaded once and held in RAM, and loading
21683
+ * it requires the index to hand the floats back. Without this method the only
21684
+ * way to keep a readable vector is a JSON column, which is the thing this
21685
+ * capability exists to delete.
21686
+ *
21687
+ * BOUNDED BY THE CALLER: ids are named, never "everything". Enumerating an
21688
+ * index is {@link VectorScanInputSchema}'s job, and it returns no vectors.
21689
+ */
21690
+ var VectorFetchInputSchema = object({
21691
+ index: string(),
21692
+ ids: array(string())
21693
+ });
21694
+ var VectorFetchResultSchema = object({ items: array(object({
21695
+ id: string(),
21696
+ /** base64 Float32LE — the same wire form `upsert` accepts. */
21697
+ vector: string(),
21698
+ metadata: VectorMetadataSchema
21699
+ })) });
21700
+ /**
21701
+ * ENUMERATE an index: one page of rows in a stable order, no ranking.
21702
+ *
21703
+ * A reconcile does not want the nearest rows, it wants ALL of them, and asking
21704
+ * a KNN for "all" is the wrong question twice over. It hits the backend's `k`
21705
+ * ceiling — 4,096 on sqlite-vec against a 22,128-row index — and it needs a
21706
+ * probe vector it does not have, so the audit passed a ZERO vector whose cosine
21707
+ * distance to every row is degenerate. `examined: 4096` then read as "we
21708
+ * looked" for as long as anyone cared to read it.
21709
+ *
21710
+ * This is the primitive that question actually needs: a bounded page, ordered
21711
+ * by the backend's own row order, costing no distance computation at all.
21712
+ * Vectors are NOT returned — an enumeration that shipped 2 KB per row would be
21713
+ * the full-table read this capability was built to stop.
21714
+ */
21715
+ var VectorScanInputSchema = object({
21716
+ index: string(),
21717
+ /** Opaque resume point. `0` starts at the top; pass back `nextCursor`. */
21718
+ cursor: number().int().nonnegative().default(0),
21719
+ limit: number().int().positive()
21720
+ });
21721
+ var VectorScanResultSchema = object({
21722
+ items: array(object({
21723
+ id: string(),
21724
+ metadata: VectorMetadataSchema
21725
+ })),
21726
+ /**
21727
+ * Where the next page starts, or `null` when the walk reached the end.
21728
+ *
21729
+ * `null` is the ONLY end-of-index signal. A caller must not infer the end
21730
+ * from a short page: a backend is free to return fewer rows than asked.
21731
+ */
21732
+ nextCursor: number().int().nonnegative().nullable()
21733
+ });
21411
21734
  var VectorStatsInputSchema = object({ index: string() });
21412
21735
  var VectorStatsResultSchema = object({
21413
21736
  /** Provider id, so an operator can tell brute force from an ANN index. */
@@ -21426,7 +21749,7 @@ method(VectorDeclareIndexInputSchema, _void(), {
21426
21749
  }), method(VectorUpsertInputSchema, VectorUpsertResultSchema, {
21427
21750
  kind: "mutation",
21428
21751
  auth: "admin"
21429
- }), method(VectorQueryInputSchema, VectorQueryResultSchema, { auth: "admin" }), method(VectorGetInputSchema, VectorGetResultSchema, { auth: "admin" }), method(VectorDeleteInputSchema, VectorDeleteResultSchema, {
21752
+ }), method(VectorQueryInputSchema, VectorQueryResultSchema, { auth: "admin" }), method(VectorGetInputSchema, VectorGetResultSchema, { auth: "admin" }), method(VectorFetchInputSchema, VectorFetchResultSchema, { auth: "admin" }), method(VectorScanInputSchema, VectorScanResultSchema, { auth: "admin" }), method(VectorDeleteInputSchema, VectorDeleteResultSchema, {
21430
21753
  kind: "mutation",
21431
21754
  auth: "admin"
21432
21755
  }), method(VectorDeleteByFilterInputSchema, VectorDeleteResultSchema, {
@@ -26330,6 +26653,9 @@ method(object({
26330
26653
  }), method(object({}), array(RelocateJobSchema).readonly(), {
26331
26654
  kind: "query",
26332
26655
  auth: "admin"
26656
+ }), method(RelocateResidueInputSchema, RelocateResidueSchema, {
26657
+ kind: "query",
26658
+ auth: "admin"
26333
26659
  }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
26334
26660
  kind: "mutation",
26335
26661
  auth: "admin"
@@ -31295,6 +31621,12 @@ Object.freeze({
31295
31621
  addonId: null,
31296
31622
  access: "create"
31297
31623
  },
31624
+ "pipelineAnalytics.countRelocatableMedia": {
31625
+ capName: "pipeline-analytics",
31626
+ capScope: "device",
31627
+ addonId: null,
31628
+ access: "view"
31629
+ },
31298
31630
  "pipelineAnalytics.countUnstampedEventMedia": {
31299
31631
  capName: "pipeline-analytics",
31300
31632
  capScope: "device",
@@ -32459,6 +32791,12 @@ Object.freeze({
32459
32791
  addonId: null,
32460
32792
  access: "view"
32461
32793
  },
32794
+ "recording.getRelocateResidue": {
32795
+ capName: "recording",
32796
+ capScope: "system",
32797
+ addonId: null,
32798
+ access: "view"
32799
+ },
32462
32800
  "recording.getStorageMigrationMoveStatus": {
32463
32801
  capName: "recording",
32464
32802
  capScope: "system",
@@ -33005,12 +33343,30 @@ Object.freeze({
33005
33343
  addonId: null,
33006
33344
  access: "create"
33007
33345
  },
33346
+ "storageMigration.drain": {
33347
+ capName: "storage-migration",
33348
+ capScope: "system",
33349
+ addonId: null,
33350
+ access: "create"
33351
+ },
33352
+ "storageMigration.movers": {
33353
+ capName: "storage-migration",
33354
+ capScope: "system",
33355
+ addonId: null,
33356
+ access: "view"
33357
+ },
33008
33358
  "storageMigration.plan": {
33009
33359
  capName: "storage-migration",
33010
33360
  capScope: "system",
33011
33361
  addonId: null,
33012
33362
  access: "view"
33013
33363
  },
33364
+ "storageMigration.residue": {
33365
+ capName: "storage-migration",
33366
+ capScope: "system",
33367
+ addonId: null,
33368
+ access: "view"
33369
+ },
33014
33370
  "storageMigration.start": {
33015
33371
  capName: "storage-migration",
33016
33372
  capScope: "system",
@@ -33845,6 +34201,12 @@ Object.freeze({
33845
34201
  addonId: null,
33846
34202
  access: "delete"
33847
34203
  },
34204
+ "vectorStore.fetchByIds": {
34205
+ capName: "vector-store",
34206
+ capScope: "system",
34207
+ addonId: null,
34208
+ access: "view"
34209
+ },
33848
34210
  "vectorStore.getByIds": {
33849
34211
  capName: "vector-store",
33850
34212
  capScope: "system",
@@ -33857,6 +34219,12 @@ Object.freeze({
33857
34219
  addonId: null,
33858
34220
  access: "view"
33859
34221
  },
34222
+ "vectorStore.scan": {
34223
+ capName: "vector-store",
34224
+ capScope: "system",
34225
+ addonId: null,
34226
+ access: "view"
34227
+ },
33860
34228
  "vectorStore.stats": {
33861
34229
  capName: "vector-store",
33862
34230
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -8109,6 +8109,21 @@ var RelocateJobSchema = object({
8109
8109
  bytesMoved: number().int(),
8110
8110
  /** Total files discovered up front; null while (or when) unknown. */
8111
8111
  filesTotal: number().int().nullable(),
8112
+ /**
8113
+ * Rows this run CORRECTED while moving them — a durable mutation the move
8114
+ * made that nobody asked for, so it is reported where the operator reads the
8115
+ * job rather than only in a log line.
8116
+ *
8117
+ * A footage segment records its byte count in its own NAME, and the durable
8118
+ * hour row derives its aggregates from those names. A file that does not
8119
+ * match its name therefore makes the ledger's sums — and with them quota and
8120
+ * pressure eviction — wrong by the difference, and only a rename can fix it.
8121
+ * On 2026-08-30 one such row also stalled a 110 749-file drain permanently.
8122
+ *
8123
+ * Absent on lanes where the question has no meaning: a media blob's size is
8124
+ * in its row, not in its name, so `MediaRelocateEngine` never reconciles one.
8125
+ */
8126
+ rowsReconciled: number().int().nonnegative().optional(),
8112
8127
  startedAt: number(),
8113
8128
  finishedAt: number().nullable(),
8114
8129
  error: string().nullable()
@@ -8177,14 +8192,42 @@ var RelocateMediaInputSchema = object({
8177
8192
  /** Omitted = `move`, the pre-existing behaviour. */
8178
8193
  mode: MediaRelocateModeSchema.optional()
8179
8194
  });
8180
- /** How many rows still carry NO `locationId` — the population a repoint would
8181
- * silently re-aim at a disk that does not hold their bytes. Zero is the only
8182
- * value that permits a non-blocking `eventMedia` cutover. */
8183
- var UnstampedEventMediaCountSchema = object({
8184
- media: number().int().nonnegative(),
8185
- retrainFrames: number().int().nonnegative(),
8186
- total: number().int().nonnegative()
8195
+ /**
8196
+ * The unstamped population of ONE collection — split, because the gate and the
8197
+ * operator ask two different questions and only one of them has to be cheap.
8198
+ *
8199
+ * `present` is the GATE: "is there at least one row that would be orphaned by a
8200
+ * repoint". It is a single indexed seek to the first matching row, so it stays
8201
+ * answerable on a saturated disk and answers in O(log n) precisely in the state
8202
+ * that matters — after a seal, when the population is empty.
8203
+ *
8204
+ * `rows` is the NUMBER, for the refusal message and the operator's sense of
8205
+ * scale. It is a second, indexed `COUNT(*)`, and `null` means **not
8206
+ * measurable** — never zero. `{ present: true, rows: null }` is a legitimate
8207
+ * and useful answer: "there are some, and this read could not say how many"
8208
+ * still refuses the cutover, which is the whole job.
8209
+ */
8210
+ var UnstampedRowsSchema = object({
8211
+ present: boolean(),
8212
+ rows: number().int().nonnegative().nullable()
8187
8213
  });
8214
+ /**
8215
+ * How many rows still carry NO `locationId` — the population a repoint would
8216
+ * silently re-aim at a disk that does not hold their bytes.
8217
+ *
8218
+ * **`null` = the count could not be taken**, and it is NOT permission to cut
8219
+ * over. The gate opens on a measured absence and on nothing else; an unread
8220
+ * collection and an empty one are different facts, and this repo has already
8221
+ * paid for conflating them (`RelocateResidueSchema`, D295).
8222
+ */
8223
+ var UnstampedEventMediaCountSchema = object({
8224
+ media: UnstampedRowsSchema,
8225
+ retrainFrames: UnstampedRowsSchema,
8226
+ /** True when EITHER collection holds one. The refusal reads this. */
8227
+ anyPresent: boolean(),
8228
+ /** Sum across both, or `null` when either lane could not be counted. */
8229
+ total: number().int().nonnegative().nullable()
8230
+ }).nullable();
8188
8231
  var StorageMigrationMediaMoveInputSchema = RelocateMediaInputSchema.extend({ leaseId: string().min(1) });
8189
8232
  /** The independently selectable logical storage classes — every class
8190
8233
  * `storage.listLocationDeclarations` reports, so an operator never meets a
@@ -8270,13 +8313,53 @@ var StorageMigrationParticipantSchema = _enum([
8270
8313
  "recorder",
8271
8314
  "analytics"
8272
8315
  ]);
8316
+ /**
8317
+ * The mover's own numbers, folded onto the coordinator's durable move record.
8318
+ *
8319
+ * The long half of a non-blocking migration is `draining`, and it is measured
8320
+ * in hours: 136 885 files at ~4 MB/s is about five of them. Before this shape
8321
+ * existed the only place those numbers appeared was a Loki line, so an operator
8322
+ * watching the Admin UI saw `phase: draining` and nothing else for a whole
8323
+ * afternoon.
8324
+ *
8325
+ * It is POLLED, never pushed. Events are telemetry and may be dropped
8326
+ * (D8/D11), and a dropped progress event is indistinguishable from a stalled
8327
+ * mover — which is the exact failure this is meant to end. The coordinator's
8328
+ * `waitForMoves` already fetches the whole {@link RelocateJob} on every tick to
8329
+ * read `state`; folding the counters costs no extra read and makes the durable
8330
+ * record say afterwards how far a move actually got.
8331
+ *
8332
+ * `filesTotal` is `null` for "no honest denominator" and is never zero-filled:
8333
+ * a windowed footage job (`sinceMs`) and a node with no ledger both genuinely
8334
+ * cannot say M, and a 0 there would render as "100 % done".
8335
+ */
8336
+ var StorageMigrationMoveProgressSchema = object({
8337
+ filesMoved: number().int().nonnegative(),
8338
+ /** The archive census — the **M** of "N of M" (D295). `null` = unknowable. */
8339
+ filesTotal: number().int().nonnegative().nullable(),
8340
+ bytesMoved: number().int().nonnegative(),
8341
+ /** Rows the mover corrected while moving them — see `RelocateJob`. Absent on
8342
+ * a lane that cannot reconcile. A migration that silently rewrote durable
8343
+ * rows would be the same failure as one that silently skipped them. */
8344
+ rowsReconciled: number().int().nonnegative().optional(),
8345
+ /** The MOVER's start, not the migration's: a drain restarted after an addon
8346
+ * crash gets a new mover, and a rate computed from the migration's start
8347
+ * would silently average in the time nothing was running. */
8348
+ startedAt: number(),
8349
+ /** When the coordinator last read these numbers. Paired with `startedAt` it
8350
+ * is the only honest rate: both clocks are the hub's, so a UI never has to
8351
+ * subtract its own. */
8352
+ observedAt: number()
8353
+ });
8273
8354
  var StorageMigrationMoveSchema = object({
8274
8355
  storageClass: StorageMigrationClassSchema,
8275
8356
  fromLocationId: string(),
8276
8357
  toLocationId: string(),
8277
8358
  moverJobId: string().nullable(),
8278
8359
  state: RelocateJobStateSchema.nullable(),
8279
- error: string().nullable()
8360
+ error: string().nullable(),
8361
+ /** Last observed mover counters; `null` until the mover has been polled once. */
8362
+ progress: StorageMigrationMoveProgressSchema.nullable()
8280
8363
  });
8281
8364
  var StorageMigrationJobSchema = object({
8282
8365
  jobId: string(),
@@ -8322,6 +8405,98 @@ var StorageMigrationPlanSchema = object({
8322
8405
  findings: array(StorageMigrationFindingSchema)
8323
8406
  });
8324
8407
  /**
8408
+ * A mover as it exists RIGHT NOW, whether or not a migration job owns it.
8409
+ *
8410
+ * The coordinator's job record is the state of record for a migration, and its
8411
+ * moves carry {@link StorageMigrationMoveProgress}. But the movers are usable
8412
+ * standalone — `recording.relocateFootage` and `pipelineAnalytics.relocateMedia`
8413
+ * are both operator-callable, and on 2026-08-29 a five-hour drain was armed that
8414
+ * way because no supported UI path existed. A mover armed like that has no job
8415
+ * to fold progress into, so it has to be readable on its own or it is invisible.
8416
+ *
8417
+ * `migrationJobId` is what tells the two apart: `null` means nothing here
8418
+ * orchestrated it.
8419
+ */
8420
+ var StorageMigrationMoverSchema = object({
8421
+ lane: _enum(["footage", "media"]),
8422
+ job: RelocateJobSchema,
8423
+ /** The coordinator job that armed this mover, or `null` for a mover armed
8424
+ * directly against the owning addon. */
8425
+ migrationJobId: string().nullable(),
8426
+ /** When the hub read these counters. Stamped here so a rate is `bytesMoved`
8427
+ * over (`observedAt` − `job.startedAt`) with BOTH ends on the hub's clock —
8428
+ * a browser subtracting its own `Date.now()` from a server `startedAt` is a
8429
+ * rate made of two different clocks. */
8430
+ observedAt: number()
8431
+ });
8432
+ /**
8433
+ * What a SOURCE still holds for one storage class — the number that makes a
8434
+ * "drain remaining" action honest rather than hopeful.
8435
+ *
8436
+ * It comes from the archive (`SegmentHourLedger.census` for footage, the media
8437
+ * engine's own selection count for media), never from the resident index: a
8438
+ * drain sized off `RecordingIndex` is what reported `done` over 80.3 GB it had
8439
+ * never been told about (D295).
8440
+ *
8441
+ * `items`/`bytes` are `null` for "the archive could not be asked", which is
8442
+ * deliberately NOT zero: a drain is still offered for an unknown residue,
8443
+ * because refusing on an unanswerable read would hide exactly the case an
8444
+ * operator needs to act on.
8445
+ */
8446
+ var StorageMigrationResidueSchema = object({
8447
+ storageClass: StorageMigrationClassSchema,
8448
+ /** The location still holding the data. `'*'` for the media lane, whose rows
8449
+ * move from wherever they are rather than from one named source. */
8450
+ fromLocationId: string(),
8451
+ /** Where a drain would move it — the class's CURRENT default. */
8452
+ toLocationId: string(),
8453
+ /** Segments (footage lane) or rows (media lane) still on the source. */
8454
+ items: number().int().nonnegative().nullable(),
8455
+ /** Bytes on the source; `null` when the lane counts rows rather than bytes. */
8456
+ bytes: number().int().nonnegative().nullable()
8457
+ });
8458
+ /**
8459
+ * Run the DRAIN half and nothing else.
8460
+ *
8461
+ * A migration that reached `done` has already repointed, so `start` correctly
8462
+ * refuses its destination ("already the default") — there is nothing left to
8463
+ * repoint. But the drain can fail, be cancelled, be interrupted by a restart,
8464
+ * or finish against a work list that was a tenth of the archive (D295), and
8465
+ * before this there was no supported way to run only that half: the only way
8466
+ * through was calling `recording.relocateFootage` by hand over admin tRPC.
8467
+ *
8468
+ * `drain` NEVER calls `setDefaultLocations`. That is what keeps `start`'s
8469
+ * refusal meaningful: the two verbs are disjoint, so nothing here can silently
8470
+ * re-repoint a class that is already migrated.
8471
+ */
8472
+ var StorageMigrationDrainInputSchema = object({
8473
+ /** The classes to drain. Each must appear in `storageMigration.residue`, so
8474
+ * a class whose source is already empty is refused rather than started. */
8475
+ classes: array(StorageMigrationClassSchema).min(1),
8476
+ throttleMbps: number().min(1).max(1e3).optional()
8477
+ });
8478
+ /** What a footage source still holds, asked of the durable hour ledger. */
8479
+ var RelocateResidueInputSchema = object({
8480
+ fromLocationId: string().min(1),
8481
+ /** Narrow to one logical class; omit for every profile on the location. */
8482
+ footageClass: RelocateFootageClassSchema.optional()
8483
+ });
8484
+ /** `null` = the archive could not answer (no ledger on this node, or the
8485
+ * aggregate failed). Never conflated with an empty source. */
8486
+ var RelocateResidueSchema = object({
8487
+ segments: number().int().nonnegative(),
8488
+ bytes: number().int().nonnegative()
8489
+ }).nullable();
8490
+ /** How many rows a media pass would still act on against a given target — the
8491
+ * media lane's denominator AND its residue, from ONE derivation so the two can
8492
+ * never disagree. `null` = the count could not be taken. */
8493
+ var RelocatableMediaCountSchema = object({ rows: number().int().nonnegative() }).nullable();
8494
+ var RelocatableMediaCountInputSchema = object({
8495
+ toLocationId: string().min(1),
8496
+ /** Omitted = `move`. */
8497
+ mode: MediaRelocateModeSchema.optional()
8498
+ });
8499
+ /**
8325
8500
  * `StorageLocationType` — an addon-declared id that identifies the *kind* of
8326
8501
  * storage a location serves. Defined here (not in `capabilities/storage.cap.ts`)
8327
8502
  * so the persisted record schema and the consumer-facing cap can both consume it
@@ -8425,6 +8600,32 @@ var StorageLocationRefSchema = union([StorageLocationTypeSchema, string().regex(
8425
8600
  * two addons declaring the same `id` must agree on `cardinality` (validated
8426
8601
  * at kernel aggregation time, not here).
8427
8602
  */
8603
+ /**
8604
+ * `StorageAccess` — how the service that DECLARED a storage-location kind
8605
+ * actually reaches the bytes. It is the constraint that decides which
8606
+ * `storage-provider`s may back a location of that kind.
8607
+ *
8608
+ * - `'local-path'` — the service asks `storage.resolve` for a path string and
8609
+ * then does its own `node:fs` I/O on it (the recorder's segment writer, the
8610
+ * post-analysis media roots). Only a provider that serves a genuine local
8611
+ * filesystem (`getProviderInfo().nodeLocal === true`) can satisfy that: a
8612
+ * remote provider's `resolve` returns a path on the REMOTE host, and
8613
+ * `fs.readdir` of it on this node either fails or — far worse — succeeds
8614
+ * against a same-named local directory that is something else entirely.
8615
+ *
8616
+ * - `'cap-mediated'` — every byte travels through the `storage` cap
8617
+ * (`read`/`write`, or `beginUpload`/`writeChunk`/`finalizeUpload`). The
8618
+ * service never sees a path, so any provider can back it. `backups` is the
8619
+ * one kind that qualifies today.
8620
+ *
8621
+ * Before this existed, `recordings` was unreachable by SFTP/S3/WebDAV only as
8622
+ * an EMERGENT property of how the recorder happened to be written. Nothing
8623
+ * refused the configuration; the first write simply went somewhere wrong, and
8624
+ * a recording write that goes wrong surfaces as a silent black window rather
8625
+ * than an error (the read path does not `stat`). This turns that accident into
8626
+ * a declared, enforced, testable refusal.
8627
+ */
8628
+ var StorageAccessSchema = _enum(["local-path", "cap-mediated"]);
8428
8629
  var StorageLocationDeclarationSchema = object({
8429
8630
  /**
8430
8631
  * Global location identifier, e.g. `recordings` or `recordingsLow`.
@@ -8444,6 +8645,19 @@ var StorageLocationDeclarationSchema = object({
8444
8645
  */
8445
8646
  cardinality: _enum(["single", "multi"]),
8446
8647
  /**
8648
+ * HOW the declaring service reaches the bytes — and therefore WHICH
8649
+ * providers may back a location of this kind. See {@link StorageAccessSchema}
8650
+ * and {@link STORAGE_ACCESS_FALLBACK}.
8651
+ *
8652
+ * Absent means `'local-path'`. That default is FAIL-CLOSED on purpose: it
8653
+ * can only over-restrict (refuse a remote provider for a kind that might
8654
+ * have coped) and never under-restrict. Declaring `'cap-mediated'` is the
8655
+ * permissive direction and is therefore never inferred — a repo guard
8656
+ * (`scripts/check-storage-access-declarations.ts`) refuses to let it be
8657
+ * reached by omission.
8658
+ */
8659
+ access: StorageAccessSchema.optional(),
8660
+ /**
8447
8661
  * When set, the default instance for this location inherits its resolved
8448
8662
  * root from the named location's default instance. Useful for derivative
8449
8663
  * slots (e.g. `recordingsLow` → `recordings`) so operators only need to
@@ -18024,8 +18238,10 @@ var TrackSchema = object({
18024
18238
  lastSeen: number(),
18025
18239
  /** Frame-rate position history (subject to maxPositionHistory cap). */
18026
18240
  positions: array(TrackPositionSchema).readonly(),
18027
- /** Periodic snapshots at snapshotIntervalMs cadence (subject to
18028
- * saveThumbnails policy). */
18241
+ /** Periodic snapshots at snapshotIntervalMs cadence — DEBUG media, produced
18242
+ * only while `MediaSettings.debugMediaEnabled` is on for the camera (D299;
18243
+ * the retired `saveThumbnails` used to gate this and the rolling
18244
+ * `lastFrame` together). Empty is the healthy default, not a capture gap. */
18029
18245
  snapshots: array(TrackSnapshotSchema).readonly(),
18030
18246
  /** Deduplicated zones the track has entered at least once. Zone IDS. */
18031
18247
  zonesVisited: array(string()).readonly(),
@@ -18885,7 +19101,10 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
18885
19101
  }), method(RelocateMediaInputSchema, object({ jobId: string() }), {
18886
19102
  kind: "mutation",
18887
19103
  auth: "admin"
18888
- }), method(object({}), UnstampedEventMediaCountSchema, { auth: "admin" }), method(object({}), array(RelocateJobSchema).readonly(), {
19104
+ }), method(object({}), UnstampedEventMediaCountSchema, { auth: "admin" }), method(RelocatableMediaCountInputSchema, RelocatableMediaCountSchema, {
19105
+ kind: "query",
19106
+ auth: "admin"
19107
+ }), method(object({}), array(RelocateJobSchema).readonly(), {
18889
19108
  kind: "query",
18890
19109
  auth: "admin"
18891
19110
  }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
@@ -20844,6 +21063,9 @@ method(StorageMigrationInputSchema, StorageMigrationPlanSchema, { auth: "admin"
20844
21063
  }), method(object({ jobId: string().optional() }), StorageMigrationJobSchema.nullable(), { auth: "admin" }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
20845
21064
  kind: "mutation",
20846
21065
  auth: "admin"
21066
+ }), method(object({}), array(StorageMigrationMoverSchema).readonly(), { auth: "admin" }), method(object({}), array(StorageMigrationResidueSchema).readonly(), { auth: "admin" }), method(StorageMigrationDrainInputSchema, object({ jobId: string() }), {
21067
+ kind: "mutation",
21068
+ auth: "admin"
20847
21069
  });
20848
21070
  var ProviderInfoSchema = discriminatedUnion("shouldSaveDiskSpace", [object({
20849
21071
  providerId: string().min(1),
@@ -21242,12 +21464,38 @@ response: record(string(), unknown()) }), object({
21242
21464
  *
21243
21465
  * ## Why this is a capability and not a helper
21244
21466
  *
21245
- * Six stores in `addon-post-analysis` already hold vectors — object CLIP, face,
21246
- * plate, vehicle, identity, and the event store's derivatives — and every one of
21247
- * them keeps its vectors in a `JSON` settings-store column and ranks them by
21248
- * brute-force cosine in JS. Measured on the live hub that costs ~11.7 KB per row
21249
- * (512 floats as TEXT, `JSON.parse`d on every search) and made semantic search
21250
- * load 5,000 rows before ranking anything.
21467
+ * This capability was introduced with the claim that SIX stores in
21468
+ * `addon-post-analysis` held vectors in a `JSON` settings-store column — object
21469
+ * CLIP, face, plate, vehicle, identity, and the event store's derivatives. That
21470
+ * claim was never true, and leaving it here made five stores look like pending
21471
+ * work when three of them have no vector at all. Counted column by column on
21472
+ * 2026-08-30, exactly THREE ever held one:
21473
+ *
21474
+ * - `object-clip` — 512-dim CLIP image embedding, migrated 2026-08-06.
21475
+ * - `faces.embedding` — 512-dim ArcFace face embedding, migrated 2026-08-30.
21476
+ * - `identity-samples.embedding` — the same ArcFace vector for an ENROLLED
21477
+ * face, migrated 2026-08-30 into its OWN index (see below).
21478
+ *
21479
+ * `plates` and `vehicle-samples` store a plate STRING and a score; `vehicles`
21480
+ * and `identities` store a name; the event store stores no derivative vector.
21481
+ * They are not migration candidates and never were.
21482
+ *
21483
+ * Measured on the live hub the JSON encoding cost ~11.7 KB per row (512 floats
21484
+ * as TEXT, `JSON.parse`d on every search) and made semantic search load 5,000
21485
+ * rows before ranking anything.
21486
+ *
21487
+ * ## One index per COMPARISON, never per encoder
21488
+ *
21489
+ * `faces` and `identity-samples` hold the same 512 ArcFace dims from the same
21490
+ * model, and they still get two indexes. An index is a set of things that are
21491
+ * ranked against each other and that live and die together, and these two are
21492
+ * neither: a `faces` row is TRACK-OWNED and cascades away with its track under
21493
+ * a per-camera capacity cap, an `identity-samples` row is retention-EXEMPT
21494
+ * forever and is the gallery every recognition ranks against. One index would
21495
+ * mean every gallery load and every reconcile carried a filter whose failure
21496
+ * mode is either ranking a candidate against itself or reclaiming an enrolled
21497
+ * person's only sample. The dimension they share is not a reason to share an
21498
+ * index; the question they answer is, and it differs.
21251
21499
  *
21252
21500
  * The fix is not a faster loop, it is a different backend — and the backend
21253
21501
  * should be replaceable without touching six callers. So: a singleton
@@ -21352,7 +21600,20 @@ var VectorQueryResultSchema = object({
21352
21600
  */
21353
21601
  scanned: number(),
21354
21602
  /** True when the backend could not consider every row that passed the filter. */
21355
- truncated: boolean()
21603
+ truncated: boolean(),
21604
+ /**
21605
+ * The `topK` the backend actually ran with.
21606
+ *
21607
+ * Every backend has a ceiling — sqlite-vec's is 4,096 — and a caller asking
21608
+ * past it used to learn nothing but a boolean, from a WARN in the provider's
21609
+ * own log rather than in its answer. That is how an audit asking for 20,000
21610
+ * consumed 4,096 and reported `examined: 4096` as if it had walked the index,
21611
+ * for weeks. `truncated` says THAT the answer was short; this says BY HOW
21612
+ * MUCH, in the return value, where the caller cannot fail to see it.
21613
+ *
21614
+ * Equals the requested `topK` whenever nothing was lowered.
21615
+ */
21616
+ effectiveTopK: number().int().positive()
21356
21617
  });
21357
21618
  var VectorDeleteInputSchema = object({
21358
21619
  index: string(),
@@ -21381,6 +21642,68 @@ var VectorGetResultSchema = object({ items: array(object({
21381
21642
  id: string(),
21382
21643
  metadata: VectorMetadataSchema
21383
21644
  })) });
21645
+ /**
21646
+ * Ids to read back WITH their vectors.
21647
+ *
21648
+ * The sibling of {@link VectorGetResultSchema}, and deliberately a separate
21649
+ * method rather than a flag on it: `getByIds` promises no vectors and its one
21650
+ * caller depends on that promise. This one promises the opposite.
21651
+ *
21652
+ * It exists because a store cannot put its vectors here otherwise. An ArcFace
21653
+ * gallery is ranked IN PROCESS, per detection, against every enrolled sample —
21654
+ * a per-face cross-process KNN would be a network round trip inside the
21655
+ * recognition loop. So the gallery is loaded once and held in RAM, and loading
21656
+ * it requires the index to hand the floats back. Without this method the only
21657
+ * way to keep a readable vector is a JSON column, which is the thing this
21658
+ * capability exists to delete.
21659
+ *
21660
+ * BOUNDED BY THE CALLER: ids are named, never "everything". Enumerating an
21661
+ * index is {@link VectorScanInputSchema}'s job, and it returns no vectors.
21662
+ */
21663
+ var VectorFetchInputSchema = object({
21664
+ index: string(),
21665
+ ids: array(string())
21666
+ });
21667
+ var VectorFetchResultSchema = object({ items: array(object({
21668
+ id: string(),
21669
+ /** base64 Float32LE — the same wire form `upsert` accepts. */
21670
+ vector: string(),
21671
+ metadata: VectorMetadataSchema
21672
+ })) });
21673
+ /**
21674
+ * ENUMERATE an index: one page of rows in a stable order, no ranking.
21675
+ *
21676
+ * A reconcile does not want the nearest rows, it wants ALL of them, and asking
21677
+ * a KNN for "all" is the wrong question twice over. It hits the backend's `k`
21678
+ * ceiling — 4,096 on sqlite-vec against a 22,128-row index — and it needs a
21679
+ * probe vector it does not have, so the audit passed a ZERO vector whose cosine
21680
+ * distance to every row is degenerate. `examined: 4096` then read as "we
21681
+ * looked" for as long as anyone cared to read it.
21682
+ *
21683
+ * This is the primitive that question actually needs: a bounded page, ordered
21684
+ * by the backend's own row order, costing no distance computation at all.
21685
+ * Vectors are NOT returned — an enumeration that shipped 2 KB per row would be
21686
+ * the full-table read this capability was built to stop.
21687
+ */
21688
+ var VectorScanInputSchema = object({
21689
+ index: string(),
21690
+ /** Opaque resume point. `0` starts at the top; pass back `nextCursor`. */
21691
+ cursor: number().int().nonnegative().default(0),
21692
+ limit: number().int().positive()
21693
+ });
21694
+ var VectorScanResultSchema = object({
21695
+ items: array(object({
21696
+ id: string(),
21697
+ metadata: VectorMetadataSchema
21698
+ })),
21699
+ /**
21700
+ * Where the next page starts, or `null` when the walk reached the end.
21701
+ *
21702
+ * `null` is the ONLY end-of-index signal. A caller must not infer the end
21703
+ * from a short page: a backend is free to return fewer rows than asked.
21704
+ */
21705
+ nextCursor: number().int().nonnegative().nullable()
21706
+ });
21384
21707
  var VectorStatsInputSchema = object({ index: string() });
21385
21708
  var VectorStatsResultSchema = object({
21386
21709
  /** Provider id, so an operator can tell brute force from an ANN index. */
@@ -21399,7 +21722,7 @@ method(VectorDeclareIndexInputSchema, _void(), {
21399
21722
  }), method(VectorUpsertInputSchema, VectorUpsertResultSchema, {
21400
21723
  kind: "mutation",
21401
21724
  auth: "admin"
21402
- }), method(VectorQueryInputSchema, VectorQueryResultSchema, { auth: "admin" }), method(VectorGetInputSchema, VectorGetResultSchema, { auth: "admin" }), method(VectorDeleteInputSchema, VectorDeleteResultSchema, {
21725
+ }), method(VectorQueryInputSchema, VectorQueryResultSchema, { auth: "admin" }), method(VectorGetInputSchema, VectorGetResultSchema, { auth: "admin" }), method(VectorFetchInputSchema, VectorFetchResultSchema, { auth: "admin" }), method(VectorScanInputSchema, VectorScanResultSchema, { auth: "admin" }), method(VectorDeleteInputSchema, VectorDeleteResultSchema, {
21403
21726
  kind: "mutation",
21404
21727
  auth: "admin"
21405
21728
  }), method(VectorDeleteByFilterInputSchema, VectorDeleteResultSchema, {
@@ -26303,6 +26626,9 @@ method(object({
26303
26626
  }), method(object({}), array(RelocateJobSchema).readonly(), {
26304
26627
  kind: "query",
26305
26628
  auth: "admin"
26629
+ }), method(RelocateResidueInputSchema, RelocateResidueSchema, {
26630
+ kind: "query",
26631
+ auth: "admin"
26306
26632
  }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
26307
26633
  kind: "mutation",
26308
26634
  auth: "admin"
@@ -31268,6 +31594,12 @@ Object.freeze({
31268
31594
  addonId: null,
31269
31595
  access: "create"
31270
31596
  },
31597
+ "pipelineAnalytics.countRelocatableMedia": {
31598
+ capName: "pipeline-analytics",
31599
+ capScope: "device",
31600
+ addonId: null,
31601
+ access: "view"
31602
+ },
31271
31603
  "pipelineAnalytics.countUnstampedEventMedia": {
31272
31604
  capName: "pipeline-analytics",
31273
31605
  capScope: "device",
@@ -32432,6 +32764,12 @@ Object.freeze({
32432
32764
  addonId: null,
32433
32765
  access: "view"
32434
32766
  },
32767
+ "recording.getRelocateResidue": {
32768
+ capName: "recording",
32769
+ capScope: "system",
32770
+ addonId: null,
32771
+ access: "view"
32772
+ },
32435
32773
  "recording.getStorageMigrationMoveStatus": {
32436
32774
  capName: "recording",
32437
32775
  capScope: "system",
@@ -32978,12 +33316,30 @@ Object.freeze({
32978
33316
  addonId: null,
32979
33317
  access: "create"
32980
33318
  },
33319
+ "storageMigration.drain": {
33320
+ capName: "storage-migration",
33321
+ capScope: "system",
33322
+ addonId: null,
33323
+ access: "create"
33324
+ },
33325
+ "storageMigration.movers": {
33326
+ capName: "storage-migration",
33327
+ capScope: "system",
33328
+ addonId: null,
33329
+ access: "view"
33330
+ },
32981
33331
  "storageMigration.plan": {
32982
33332
  capName: "storage-migration",
32983
33333
  capScope: "system",
32984
33334
  addonId: null,
32985
33335
  access: "view"
32986
33336
  },
33337
+ "storageMigration.residue": {
33338
+ capName: "storage-migration",
33339
+ capScope: "system",
33340
+ addonId: null,
33341
+ access: "view"
33342
+ },
32987
33343
  "storageMigration.start": {
32988
33344
  capName: "storage-migration",
32989
33345
  capScope: "system",
@@ -33818,6 +34174,12 @@ Object.freeze({
33818
34174
  addonId: null,
33819
34175
  access: "delete"
33820
34176
  },
34177
+ "vectorStore.fetchByIds": {
34178
+ capName: "vector-store",
34179
+ capScope: "system",
34180
+ addonId: null,
34181
+ access: "view"
34182
+ },
33821
34183
  "vectorStore.getByIds": {
33822
34184
  capName: "vector-store",
33823
34185
  capScope: "system",
@@ -33830,6 +34192,12 @@ Object.freeze({
33830
34192
  addonId: null,
33831
34193
  access: "view"
33832
34194
  },
34195
+ "vectorStore.scan": {
34196
+ capName: "vector-store",
34197
+ capScope: "system",
34198
+ addonId: null,
34199
+ access: "view"
34200
+ },
33833
34201
  "vectorStore.stats": {
33834
34202
  capName: "vector-store",
33835
34203
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-notifiers",
3
- "version": "1.2.47",
3
+ "version": "1.2.50",
4
4
  "description": "System notifiers addon for CamStack — a `notification-output` collection provider hosting per-kind notifier adapters (ntfy, pushover, gotify, telegram, discord, webhook, zentik).",
5
5
  "keywords": [
6
6
  "camstack",