@camstack/addon-provider-rtsp 1.2.43 → 1.2.46

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
@@ -8059,6 +8059,21 @@ var RelocateJobSchema = object({
8059
8059
  bytesMoved: number().int(),
8060
8060
  /** Total files discovered up front; null while (or when) unknown. */
8061
8061
  filesTotal: number().int().nullable(),
8062
+ /**
8063
+ * Rows this run CORRECTED while moving them — a durable mutation the move
8064
+ * made that nobody asked for, so it is reported where the operator reads the
8065
+ * job rather than only in a log line.
8066
+ *
8067
+ * A footage segment records its byte count in its own NAME, and the durable
8068
+ * hour row derives its aggregates from those names. A file that does not
8069
+ * match its name therefore makes the ledger's sums — and with them quota and
8070
+ * pressure eviction — wrong by the difference, and only a rename can fix it.
8071
+ * On 2026-08-30 one such row also stalled a 110 749-file drain permanently.
8072
+ *
8073
+ * Absent on lanes where the question has no meaning: a media blob's size is
8074
+ * in its row, not in its name, so `MediaRelocateEngine` never reconciles one.
8075
+ */
8076
+ rowsReconciled: number().int().nonnegative().optional(),
8062
8077
  startedAt: number(),
8063
8078
  finishedAt: number().nullable(),
8064
8079
  error: string().nullable()
@@ -8127,14 +8142,42 @@ var RelocateMediaInputSchema = object({
8127
8142
  /** Omitted = `move`, the pre-existing behaviour. */
8128
8143
  mode: MediaRelocateModeSchema.optional()
8129
8144
  });
8130
- /** How many rows still carry NO `locationId` — the population a repoint would
8131
- * silently re-aim at a disk that does not hold their bytes. Zero is the only
8132
- * value that permits a non-blocking `eventMedia` cutover. */
8133
- var UnstampedEventMediaCountSchema = object({
8134
- media: number().int().nonnegative(),
8135
- retrainFrames: number().int().nonnegative(),
8136
- total: number().int().nonnegative()
8145
+ /**
8146
+ * The unstamped population of ONE collection split, because the gate and the
8147
+ * operator ask two different questions and only one of them has to be cheap.
8148
+ *
8149
+ * `present` is the GATE: "is there at least one row that would be orphaned by a
8150
+ * repoint". It is a single indexed seek to the first matching row, so it stays
8151
+ * answerable on a saturated disk and answers in O(log n) precisely in the state
8152
+ * that matters — after a seal, when the population is empty.
8153
+ *
8154
+ * `rows` is the NUMBER, for the refusal message and the operator's sense of
8155
+ * scale. It is a second, indexed `COUNT(*)`, and `null` means **not
8156
+ * measurable** — never zero. `{ present: true, rows: null }` is a legitimate
8157
+ * and useful answer: "there are some, and this read could not say how many"
8158
+ * still refuses the cutover, which is the whole job.
8159
+ */
8160
+ var UnstampedRowsSchema = object({
8161
+ present: boolean(),
8162
+ rows: number().int().nonnegative().nullable()
8137
8163
  });
8164
+ /**
8165
+ * How many rows still carry NO `locationId` — the population a repoint would
8166
+ * silently re-aim at a disk that does not hold their bytes.
8167
+ *
8168
+ * **`null` = the count could not be taken**, and it is NOT permission to cut
8169
+ * over. The gate opens on a measured absence and on nothing else; an unread
8170
+ * collection and an empty one are different facts, and this repo has already
8171
+ * paid for conflating them (`RelocateResidueSchema`, D295).
8172
+ */
8173
+ var UnstampedEventMediaCountSchema = object({
8174
+ media: UnstampedRowsSchema,
8175
+ retrainFrames: UnstampedRowsSchema,
8176
+ /** True when EITHER collection holds one. The refusal reads this. */
8177
+ anyPresent: boolean(),
8178
+ /** Sum across both, or `null` when either lane could not be counted. */
8179
+ total: number().int().nonnegative().nullable()
8180
+ }).nullable();
8138
8181
  var StorageMigrationMediaMoveInputSchema = RelocateMediaInputSchema.extend({ leaseId: string().min(1) });
8139
8182
  /** The independently selectable logical storage classes — every class
8140
8183
  * `storage.listLocationDeclarations` reports, so an operator never meets a
@@ -8220,13 +8263,53 @@ var StorageMigrationParticipantSchema = _enum([
8220
8263
  "recorder",
8221
8264
  "analytics"
8222
8265
  ]);
8266
+ /**
8267
+ * The mover's own numbers, folded onto the coordinator's durable move record.
8268
+ *
8269
+ * The long half of a non-blocking migration is `draining`, and it is measured
8270
+ * in hours: 136 885 files at ~4 MB/s is about five of them. Before this shape
8271
+ * existed the only place those numbers appeared was a Loki line, so an operator
8272
+ * watching the Admin UI saw `phase: draining` and nothing else for a whole
8273
+ * afternoon.
8274
+ *
8275
+ * It is POLLED, never pushed. Events are telemetry and may be dropped
8276
+ * (D8/D11), and a dropped progress event is indistinguishable from a stalled
8277
+ * mover — which is the exact failure this is meant to end. The coordinator's
8278
+ * `waitForMoves` already fetches the whole {@link RelocateJob} on every tick to
8279
+ * read `state`; folding the counters costs no extra read and makes the durable
8280
+ * record say afterwards how far a move actually got.
8281
+ *
8282
+ * `filesTotal` is `null` for "no honest denominator" and is never zero-filled:
8283
+ * a windowed footage job (`sinceMs`) and a node with no ledger both genuinely
8284
+ * cannot say M, and a 0 there would render as "100 % done".
8285
+ */
8286
+ var StorageMigrationMoveProgressSchema = object({
8287
+ filesMoved: number().int().nonnegative(),
8288
+ /** The archive census — the **M** of "N of M" (D295). `null` = unknowable. */
8289
+ filesTotal: number().int().nonnegative().nullable(),
8290
+ bytesMoved: number().int().nonnegative(),
8291
+ /** Rows the mover corrected while moving them — see `RelocateJob`. Absent on
8292
+ * a lane that cannot reconcile. A migration that silently rewrote durable
8293
+ * rows would be the same failure as one that silently skipped them. */
8294
+ rowsReconciled: number().int().nonnegative().optional(),
8295
+ /** The MOVER's start, not the migration's: a drain restarted after an addon
8296
+ * crash gets a new mover, and a rate computed from the migration's start
8297
+ * would silently average in the time nothing was running. */
8298
+ startedAt: number(),
8299
+ /** When the coordinator last read these numbers. Paired with `startedAt` it
8300
+ * is the only honest rate: both clocks are the hub's, so a UI never has to
8301
+ * subtract its own. */
8302
+ observedAt: number()
8303
+ });
8223
8304
  var StorageMigrationMoveSchema = object({
8224
8305
  storageClass: StorageMigrationClassSchema,
8225
8306
  fromLocationId: string(),
8226
8307
  toLocationId: string(),
8227
8308
  moverJobId: string().nullable(),
8228
8309
  state: RelocateJobStateSchema.nullable(),
8229
- error: string().nullable()
8310
+ error: string().nullable(),
8311
+ /** Last observed mover counters; `null` until the mover has been polled once. */
8312
+ progress: StorageMigrationMoveProgressSchema.nullable()
8230
8313
  });
8231
8314
  var StorageMigrationJobSchema = object({
8232
8315
  jobId: string(),
@@ -8272,6 +8355,98 @@ var StorageMigrationPlanSchema = object({
8272
8355
  findings: array(StorageMigrationFindingSchema)
8273
8356
  });
8274
8357
  /**
8358
+ * A mover as it exists RIGHT NOW, whether or not a migration job owns it.
8359
+ *
8360
+ * The coordinator's job record is the state of record for a migration, and its
8361
+ * moves carry {@link StorageMigrationMoveProgress}. But the movers are usable
8362
+ * standalone — `recording.relocateFootage` and `pipelineAnalytics.relocateMedia`
8363
+ * are both operator-callable, and on 2026-08-29 a five-hour drain was armed that
8364
+ * way because no supported UI path existed. A mover armed like that has no job
8365
+ * to fold progress into, so it has to be readable on its own or it is invisible.
8366
+ *
8367
+ * `migrationJobId` is what tells the two apart: `null` means nothing here
8368
+ * orchestrated it.
8369
+ */
8370
+ var StorageMigrationMoverSchema = object({
8371
+ lane: _enum(["footage", "media"]),
8372
+ job: RelocateJobSchema,
8373
+ /** The coordinator job that armed this mover, or `null` for a mover armed
8374
+ * directly against the owning addon. */
8375
+ migrationJobId: string().nullable(),
8376
+ /** When the hub read these counters. Stamped here so a rate is `bytesMoved`
8377
+ * over (`observedAt` − `job.startedAt`) with BOTH ends on the hub's clock —
8378
+ * a browser subtracting its own `Date.now()` from a server `startedAt` is a
8379
+ * rate made of two different clocks. */
8380
+ observedAt: number()
8381
+ });
8382
+ /**
8383
+ * What a SOURCE still holds for one storage class — the number that makes a
8384
+ * "drain remaining" action honest rather than hopeful.
8385
+ *
8386
+ * It comes from the archive (`SegmentHourLedger.census` for footage, the media
8387
+ * engine's own selection count for media), never from the resident index: a
8388
+ * drain sized off `RecordingIndex` is what reported `done` over 80.3 GB it had
8389
+ * never been told about (D295).
8390
+ *
8391
+ * `items`/`bytes` are `null` for "the archive could not be asked", which is
8392
+ * deliberately NOT zero: a drain is still offered for an unknown residue,
8393
+ * because refusing on an unanswerable read would hide exactly the case an
8394
+ * operator needs to act on.
8395
+ */
8396
+ var StorageMigrationResidueSchema = object({
8397
+ storageClass: StorageMigrationClassSchema,
8398
+ /** The location still holding the data. `'*'` for the media lane, whose rows
8399
+ * move from wherever they are rather than from one named source. */
8400
+ fromLocationId: string(),
8401
+ /** Where a drain would move it — the class's CURRENT default. */
8402
+ toLocationId: string(),
8403
+ /** Segments (footage lane) or rows (media lane) still on the source. */
8404
+ items: number().int().nonnegative().nullable(),
8405
+ /** Bytes on the source; `null` when the lane counts rows rather than bytes. */
8406
+ bytes: number().int().nonnegative().nullable()
8407
+ });
8408
+ /**
8409
+ * Run the DRAIN half and nothing else.
8410
+ *
8411
+ * A migration that reached `done` has already repointed, so `start` correctly
8412
+ * refuses its destination ("already the default") — there is nothing left to
8413
+ * repoint. But the drain can fail, be cancelled, be interrupted by a restart,
8414
+ * or finish against a work list that was a tenth of the archive (D295), and
8415
+ * before this there was no supported way to run only that half: the only way
8416
+ * through was calling `recording.relocateFootage` by hand over admin tRPC.
8417
+ *
8418
+ * `drain` NEVER calls `setDefaultLocations`. That is what keeps `start`'s
8419
+ * refusal meaningful: the two verbs are disjoint, so nothing here can silently
8420
+ * re-repoint a class that is already migrated.
8421
+ */
8422
+ var StorageMigrationDrainInputSchema = object({
8423
+ /** The classes to drain. Each must appear in `storageMigration.residue`, so
8424
+ * a class whose source is already empty is refused rather than started. */
8425
+ classes: array(StorageMigrationClassSchema).min(1),
8426
+ throttleMbps: number().min(1).max(1e3).optional()
8427
+ });
8428
+ /** What a footage source still holds, asked of the durable hour ledger. */
8429
+ var RelocateResidueInputSchema = object({
8430
+ fromLocationId: string().min(1),
8431
+ /** Narrow to one logical class; omit for every profile on the location. */
8432
+ footageClass: RelocateFootageClassSchema.optional()
8433
+ });
8434
+ /** `null` = the archive could not answer (no ledger on this node, or the
8435
+ * aggregate failed). Never conflated with an empty source. */
8436
+ var RelocateResidueSchema = object({
8437
+ segments: number().int().nonnegative(),
8438
+ bytes: number().int().nonnegative()
8439
+ }).nullable();
8440
+ /** How many rows a media pass would still act on against a given target — the
8441
+ * media lane's denominator AND its residue, from ONE derivation so the two can
8442
+ * never disagree. `null` = the count could not be taken. */
8443
+ var RelocatableMediaCountSchema = object({ rows: number().int().nonnegative() }).nullable();
8444
+ var RelocatableMediaCountInputSchema = object({
8445
+ toLocationId: string().min(1),
8446
+ /** Omitted = `move`. */
8447
+ mode: MediaRelocateModeSchema.optional()
8448
+ });
8449
+ /**
8275
8450
  * `StorageLocationType` — an addon-declared id that identifies the *kind* of
8276
8451
  * storage a location serves. Defined here (not in `capabilities/storage.cap.ts`)
8277
8452
  * so the persisted record schema and the consumer-facing cap can both consume it
@@ -8375,6 +8550,32 @@ var StorageLocationRefSchema = union([StorageLocationTypeSchema, string().regex(
8375
8550
  * two addons declaring the same `id` must agree on `cardinality` (validated
8376
8551
  * at kernel aggregation time, not here).
8377
8552
  */
8553
+ /**
8554
+ * `StorageAccess` — how the service that DECLARED a storage-location kind
8555
+ * actually reaches the bytes. It is the constraint that decides which
8556
+ * `storage-provider`s may back a location of that kind.
8557
+ *
8558
+ * - `'local-path'` — the service asks `storage.resolve` for a path string and
8559
+ * then does its own `node:fs` I/O on it (the recorder's segment writer, the
8560
+ * post-analysis media roots). Only a provider that serves a genuine local
8561
+ * filesystem (`getProviderInfo().nodeLocal === true`) can satisfy that: a
8562
+ * remote provider's `resolve` returns a path on the REMOTE host, and
8563
+ * `fs.readdir` of it on this node either fails or — far worse — succeeds
8564
+ * against a same-named local directory that is something else entirely.
8565
+ *
8566
+ * - `'cap-mediated'` — every byte travels through the `storage` cap
8567
+ * (`read`/`write`, or `beginUpload`/`writeChunk`/`finalizeUpload`). The
8568
+ * service never sees a path, so any provider can back it. `backups` is the
8569
+ * one kind that qualifies today.
8570
+ *
8571
+ * Before this existed, `recordings` was unreachable by SFTP/S3/WebDAV only as
8572
+ * an EMERGENT property of how the recorder happened to be written. Nothing
8573
+ * refused the configuration; the first write simply went somewhere wrong, and
8574
+ * a recording write that goes wrong surfaces as a silent black window rather
8575
+ * than an error (the read path does not `stat`). This turns that accident into
8576
+ * a declared, enforced, testable refusal.
8577
+ */
8578
+ var StorageAccessSchema = _enum(["local-path", "cap-mediated"]);
8378
8579
  var StorageLocationDeclarationSchema = object({
8379
8580
  /**
8380
8581
  * Global location identifier, e.g. `recordings` or `recordingsLow`.
@@ -8394,6 +8595,19 @@ var StorageLocationDeclarationSchema = object({
8394
8595
  */
8395
8596
  cardinality: _enum(["single", "multi"]),
8396
8597
  /**
8598
+ * HOW the declaring service reaches the bytes — and therefore WHICH
8599
+ * providers may back a location of this kind. See {@link StorageAccessSchema}
8600
+ * and {@link STORAGE_ACCESS_FALLBACK}.
8601
+ *
8602
+ * Absent means `'local-path'`. That default is FAIL-CLOSED on purpose: it
8603
+ * can only over-restrict (refuse a remote provider for a kind that might
8604
+ * have coped) and never under-restrict. Declaring `'cap-mediated'` is the
8605
+ * permissive direction and is therefore never inferred — a repo guard
8606
+ * (`scripts/check-storage-access-declarations.ts`) refuses to let it be
8607
+ * reached by omission.
8608
+ */
8609
+ access: StorageAccessSchema.optional(),
8610
+ /**
8397
8611
  * When set, the default instance for this location inherits its resolved
8398
8612
  * root from the named location's default instance. Useful for derivative
8399
8613
  * slots (e.g. `recordingsLow` → `recordings`) so operators only need to
@@ -18261,8 +18475,10 @@ var TrackSchema = object({
18261
18475
  lastSeen: number(),
18262
18476
  /** Frame-rate position history (subject to maxPositionHistory cap). */
18263
18477
  positions: array(TrackPositionSchema).readonly(),
18264
- /** Periodic snapshots at snapshotIntervalMs cadence (subject to
18265
- * saveThumbnails policy). */
18478
+ /** Periodic snapshots at snapshotIntervalMs cadence DEBUG media, produced
18479
+ * only while `MediaSettings.debugMediaEnabled` is on for the camera (D299;
18480
+ * the retired `saveThumbnails` used to gate this and the rolling
18481
+ * `lastFrame` together). Empty is the healthy default, not a capture gap. */
18266
18482
  snapshots: array(TrackSnapshotSchema).readonly(),
18267
18483
  /** Deduplicated zones the track has entered at least once. Zone IDS. */
18268
18484
  zonesVisited: array(string()).readonly(),
@@ -19122,7 +19338,10 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
19122
19338
  }), method(RelocateMediaInputSchema, object({ jobId: string() }), {
19123
19339
  kind: "mutation",
19124
19340
  auth: "admin"
19125
- }), method(object({}), UnstampedEventMediaCountSchema, { auth: "admin" }), method(object({}), array(RelocateJobSchema).readonly(), {
19341
+ }), method(object({}), UnstampedEventMediaCountSchema, { auth: "admin" }), method(RelocatableMediaCountInputSchema, RelocatableMediaCountSchema, {
19342
+ kind: "query",
19343
+ auth: "admin"
19344
+ }), method(object({}), array(RelocateJobSchema).readonly(), {
19126
19345
  kind: "query",
19127
19346
  auth: "admin"
19128
19347
  }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
@@ -21185,6 +21404,9 @@ method(StorageMigrationInputSchema, StorageMigrationPlanSchema, { auth: "admin"
21185
21404
  }), method(object({ jobId: string().optional() }), StorageMigrationJobSchema.nullable(), { auth: "admin" }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
21186
21405
  kind: "mutation",
21187
21406
  auth: "admin"
21407
+ }), method(object({}), array(StorageMigrationMoverSchema).readonly(), { auth: "admin" }), method(object({}), array(StorageMigrationResidueSchema).readonly(), { auth: "admin" }), method(StorageMigrationDrainInputSchema, object({ jobId: string() }), {
21408
+ kind: "mutation",
21409
+ auth: "admin"
21188
21410
  });
21189
21411
  var ProviderInfoSchema = discriminatedUnion("shouldSaveDiskSpace", [object({
21190
21412
  providerId: string().min(1),
@@ -21583,12 +21805,38 @@ response: record(string(), unknown()) }), object({
21583
21805
  *
21584
21806
  * ## Why this is a capability and not a helper
21585
21807
  *
21586
- * Six stores in `addon-post-analysis` already hold vectors object CLIP, face,
21587
- * plate, vehicle, identity, and the event store's derivativesand every one of
21588
- * them keeps its vectors in a `JSON` settings-store column and ranks them by
21589
- * brute-force cosine in JS. Measured on the live hub that costs ~11.7 KB per row
21590
- * (512 floats as TEXT, `JSON.parse`d on every search) and made semantic search
21591
- * load 5,000 rows before ranking anything.
21808
+ * This capability was introduced with the claim that SIX stores in
21809
+ * `addon-post-analysis` held vectors in a `JSON` settings-store columnobject
21810
+ * CLIP, face, plate, vehicle, identity, and the event store's derivatives. That
21811
+ * claim was never true, and leaving it here made five stores look like pending
21812
+ * work when three of them have no vector at all. Counted column by column on
21813
+ * 2026-08-30, exactly THREE ever held one:
21814
+ *
21815
+ * - `object-clip` — 512-dim CLIP image embedding, migrated 2026-08-06.
21816
+ * - `faces.embedding` — 512-dim ArcFace face embedding, migrated 2026-08-30.
21817
+ * - `identity-samples.embedding` — the same ArcFace vector for an ENROLLED
21818
+ * face, migrated 2026-08-30 into its OWN index (see below).
21819
+ *
21820
+ * `plates` and `vehicle-samples` store a plate STRING and a score; `vehicles`
21821
+ * and `identities` store a name; the event store stores no derivative vector.
21822
+ * They are not migration candidates and never were.
21823
+ *
21824
+ * Measured on the live hub the JSON encoding cost ~11.7 KB per row (512 floats
21825
+ * as TEXT, `JSON.parse`d on every search) and made semantic search load 5,000
21826
+ * rows before ranking anything.
21827
+ *
21828
+ * ## One index per COMPARISON, never per encoder
21829
+ *
21830
+ * `faces` and `identity-samples` hold the same 512 ArcFace dims from the same
21831
+ * model, and they still get two indexes. An index is a set of things that are
21832
+ * ranked against each other and that live and die together, and these two are
21833
+ * neither: a `faces` row is TRACK-OWNED and cascades away with its track under
21834
+ * a per-camera capacity cap, an `identity-samples` row is retention-EXEMPT
21835
+ * forever and is the gallery every recognition ranks against. One index would
21836
+ * mean every gallery load and every reconcile carried a filter whose failure
21837
+ * mode is either ranking a candidate against itself or reclaiming an enrolled
21838
+ * person's only sample. The dimension they share is not a reason to share an
21839
+ * index; the question they answer is, and it differs.
21592
21840
  *
21593
21841
  * The fix is not a faster loop, it is a different backend — and the backend
21594
21842
  * should be replaceable without touching six callers. So: a singleton
@@ -21693,7 +21941,20 @@ var VectorQueryResultSchema = object({
21693
21941
  */
21694
21942
  scanned: number(),
21695
21943
  /** True when the backend could not consider every row that passed the filter. */
21696
- truncated: boolean()
21944
+ truncated: boolean(),
21945
+ /**
21946
+ * The `topK` the backend actually ran with.
21947
+ *
21948
+ * Every backend has a ceiling — sqlite-vec's is 4,096 — and a caller asking
21949
+ * past it used to learn nothing but a boolean, from a WARN in the provider's
21950
+ * own log rather than in its answer. That is how an audit asking for 20,000
21951
+ * consumed 4,096 and reported `examined: 4096` as if it had walked the index,
21952
+ * for weeks. `truncated` says THAT the answer was short; this says BY HOW
21953
+ * MUCH, in the return value, where the caller cannot fail to see it.
21954
+ *
21955
+ * Equals the requested `topK` whenever nothing was lowered.
21956
+ */
21957
+ effectiveTopK: number().int().positive()
21697
21958
  });
21698
21959
  var VectorDeleteInputSchema = object({
21699
21960
  index: string(),
@@ -21722,6 +21983,68 @@ var VectorGetResultSchema = object({ items: array(object({
21722
21983
  id: string(),
21723
21984
  metadata: VectorMetadataSchema
21724
21985
  })) });
21986
+ /**
21987
+ * Ids to read back WITH their vectors.
21988
+ *
21989
+ * The sibling of {@link VectorGetResultSchema}, and deliberately a separate
21990
+ * method rather than a flag on it: `getByIds` promises no vectors and its one
21991
+ * caller depends on that promise. This one promises the opposite.
21992
+ *
21993
+ * It exists because a store cannot put its vectors here otherwise. An ArcFace
21994
+ * gallery is ranked IN PROCESS, per detection, against every enrolled sample —
21995
+ * a per-face cross-process KNN would be a network round trip inside the
21996
+ * recognition loop. So the gallery is loaded once and held in RAM, and loading
21997
+ * it requires the index to hand the floats back. Without this method the only
21998
+ * way to keep a readable vector is a JSON column, which is the thing this
21999
+ * capability exists to delete.
22000
+ *
22001
+ * BOUNDED BY THE CALLER: ids are named, never "everything". Enumerating an
22002
+ * index is {@link VectorScanInputSchema}'s job, and it returns no vectors.
22003
+ */
22004
+ var VectorFetchInputSchema = object({
22005
+ index: string(),
22006
+ ids: array(string())
22007
+ });
22008
+ var VectorFetchResultSchema = object({ items: array(object({
22009
+ id: string(),
22010
+ /** base64 Float32LE — the same wire form `upsert` accepts. */
22011
+ vector: string(),
22012
+ metadata: VectorMetadataSchema
22013
+ })) });
22014
+ /**
22015
+ * ENUMERATE an index: one page of rows in a stable order, no ranking.
22016
+ *
22017
+ * A reconcile does not want the nearest rows, it wants ALL of them, and asking
22018
+ * a KNN for "all" is the wrong question twice over. It hits the backend's `k`
22019
+ * ceiling — 4,096 on sqlite-vec against a 22,128-row index — and it needs a
22020
+ * probe vector it does not have, so the audit passed a ZERO vector whose cosine
22021
+ * distance to every row is degenerate. `examined: 4096` then read as "we
22022
+ * looked" for as long as anyone cared to read it.
22023
+ *
22024
+ * This is the primitive that question actually needs: a bounded page, ordered
22025
+ * by the backend's own row order, costing no distance computation at all.
22026
+ * Vectors are NOT returned — an enumeration that shipped 2 KB per row would be
22027
+ * the full-table read this capability was built to stop.
22028
+ */
22029
+ var VectorScanInputSchema = object({
22030
+ index: string(),
22031
+ /** Opaque resume point. `0` starts at the top; pass back `nextCursor`. */
22032
+ cursor: number().int().nonnegative().default(0),
22033
+ limit: number().int().positive()
22034
+ });
22035
+ var VectorScanResultSchema = object({
22036
+ items: array(object({
22037
+ id: string(),
22038
+ metadata: VectorMetadataSchema
22039
+ })),
22040
+ /**
22041
+ * Where the next page starts, or `null` when the walk reached the end.
22042
+ *
22043
+ * `null` is the ONLY end-of-index signal. A caller must not infer the end
22044
+ * from a short page: a backend is free to return fewer rows than asked.
22045
+ */
22046
+ nextCursor: number().int().nonnegative().nullable()
22047
+ });
21725
22048
  var VectorStatsInputSchema = object({ index: string() });
21726
22049
  var VectorStatsResultSchema = object({
21727
22050
  /** Provider id, so an operator can tell brute force from an ANN index. */
@@ -21740,7 +22063,7 @@ method(VectorDeclareIndexInputSchema, _void(), {
21740
22063
  }), method(VectorUpsertInputSchema, VectorUpsertResultSchema, {
21741
22064
  kind: "mutation",
21742
22065
  auth: "admin"
21743
- }), method(VectorQueryInputSchema, VectorQueryResultSchema, { auth: "admin" }), method(VectorGetInputSchema, VectorGetResultSchema, { auth: "admin" }), method(VectorDeleteInputSchema, VectorDeleteResultSchema, {
22066
+ }), method(VectorQueryInputSchema, VectorQueryResultSchema, { auth: "admin" }), method(VectorGetInputSchema, VectorGetResultSchema, { auth: "admin" }), method(VectorFetchInputSchema, VectorFetchResultSchema, { auth: "admin" }), method(VectorScanInputSchema, VectorScanResultSchema, { auth: "admin" }), method(VectorDeleteInputSchema, VectorDeleteResultSchema, {
21744
22067
  kind: "mutation",
21745
22068
  auth: "admin"
21746
22069
  }), method(VectorDeleteByFilterInputSchema, VectorDeleteResultSchema, {
@@ -28367,6 +28690,9 @@ method(object({
28367
28690
  }), method(object({}), array(RelocateJobSchema).readonly(), {
28368
28691
  kind: "query",
28369
28692
  auth: "admin"
28693
+ }), method(RelocateResidueInputSchema, RelocateResidueSchema, {
28694
+ kind: "query",
28695
+ auth: "admin"
28370
28696
  }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
28371
28697
  kind: "mutation",
28372
28698
  auth: "admin"
@@ -35067,6 +35393,12 @@ Object.freeze({
35067
35393
  addonId: null,
35068
35394
  access: "create"
35069
35395
  },
35396
+ "pipelineAnalytics.countRelocatableMedia": {
35397
+ capName: "pipeline-analytics",
35398
+ capScope: "device",
35399
+ addonId: null,
35400
+ access: "view"
35401
+ },
35070
35402
  "pipelineAnalytics.countUnstampedEventMedia": {
35071
35403
  capName: "pipeline-analytics",
35072
35404
  capScope: "device",
@@ -36231,6 +36563,12 @@ Object.freeze({
36231
36563
  addonId: null,
36232
36564
  access: "view"
36233
36565
  },
36566
+ "recording.getRelocateResidue": {
36567
+ capName: "recording",
36568
+ capScope: "system",
36569
+ addonId: null,
36570
+ access: "view"
36571
+ },
36234
36572
  "recording.getStorageMigrationMoveStatus": {
36235
36573
  capName: "recording",
36236
36574
  capScope: "system",
@@ -36777,12 +37115,30 @@ Object.freeze({
36777
37115
  addonId: null,
36778
37116
  access: "create"
36779
37117
  },
37118
+ "storageMigration.drain": {
37119
+ capName: "storage-migration",
37120
+ capScope: "system",
37121
+ addonId: null,
37122
+ access: "create"
37123
+ },
37124
+ "storageMigration.movers": {
37125
+ capName: "storage-migration",
37126
+ capScope: "system",
37127
+ addonId: null,
37128
+ access: "view"
37129
+ },
36780
37130
  "storageMigration.plan": {
36781
37131
  capName: "storage-migration",
36782
37132
  capScope: "system",
36783
37133
  addonId: null,
36784
37134
  access: "view"
36785
37135
  },
37136
+ "storageMigration.residue": {
37137
+ capName: "storage-migration",
37138
+ capScope: "system",
37139
+ addonId: null,
37140
+ access: "view"
37141
+ },
36786
37142
  "storageMigration.start": {
36787
37143
  capName: "storage-migration",
36788
37144
  capScope: "system",
@@ -37617,6 +37973,12 @@ Object.freeze({
37617
37973
  addonId: null,
37618
37974
  access: "delete"
37619
37975
  },
37976
+ "vectorStore.fetchByIds": {
37977
+ capName: "vector-store",
37978
+ capScope: "system",
37979
+ addonId: null,
37980
+ access: "view"
37981
+ },
37620
37982
  "vectorStore.getByIds": {
37621
37983
  capName: "vector-store",
37622
37984
  capScope: "system",
@@ -37629,6 +37991,12 @@ Object.freeze({
37629
37991
  addonId: null,
37630
37992
  access: "view"
37631
37993
  },
37994
+ "vectorStore.scan": {
37995
+ capName: "vector-store",
37996
+ capScope: "system",
37997
+ addonId: null,
37998
+ access: "view"
37999
+ },
37632
38000
  "vectorStore.stats": {
37633
38001
  capName: "vector-store",
37634
38002
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -8035,6 +8035,21 @@ var RelocateJobSchema = object({
8035
8035
  bytesMoved: number().int(),
8036
8036
  /** Total files discovered up front; null while (or when) unknown. */
8037
8037
  filesTotal: number().int().nullable(),
8038
+ /**
8039
+ * Rows this run CORRECTED while moving them — a durable mutation the move
8040
+ * made that nobody asked for, so it is reported where the operator reads the
8041
+ * job rather than only in a log line.
8042
+ *
8043
+ * A footage segment records its byte count in its own NAME, and the durable
8044
+ * hour row derives its aggregates from those names. A file that does not
8045
+ * match its name therefore makes the ledger's sums — and with them quota and
8046
+ * pressure eviction — wrong by the difference, and only a rename can fix it.
8047
+ * On 2026-08-30 one such row also stalled a 110 749-file drain permanently.
8048
+ *
8049
+ * Absent on lanes where the question has no meaning: a media blob's size is
8050
+ * in its row, not in its name, so `MediaRelocateEngine` never reconciles one.
8051
+ */
8052
+ rowsReconciled: number().int().nonnegative().optional(),
8038
8053
  startedAt: number(),
8039
8054
  finishedAt: number().nullable(),
8040
8055
  error: string().nullable()
@@ -8103,14 +8118,42 @@ var RelocateMediaInputSchema = object({
8103
8118
  /** Omitted = `move`, the pre-existing behaviour. */
8104
8119
  mode: MediaRelocateModeSchema.optional()
8105
8120
  });
8106
- /** How many rows still carry NO `locationId` — the population a repoint would
8107
- * silently re-aim at a disk that does not hold their bytes. Zero is the only
8108
- * value that permits a non-blocking `eventMedia` cutover. */
8109
- var UnstampedEventMediaCountSchema = object({
8110
- media: number().int().nonnegative(),
8111
- retrainFrames: number().int().nonnegative(),
8112
- total: number().int().nonnegative()
8121
+ /**
8122
+ * The unstamped population of ONE collection split, because the gate and the
8123
+ * operator ask two different questions and only one of them has to be cheap.
8124
+ *
8125
+ * `present` is the GATE: "is there at least one row that would be orphaned by a
8126
+ * repoint". It is a single indexed seek to the first matching row, so it stays
8127
+ * answerable on a saturated disk and answers in O(log n) precisely in the state
8128
+ * that matters — after a seal, when the population is empty.
8129
+ *
8130
+ * `rows` is the NUMBER, for the refusal message and the operator's sense of
8131
+ * scale. It is a second, indexed `COUNT(*)`, and `null` means **not
8132
+ * measurable** — never zero. `{ present: true, rows: null }` is a legitimate
8133
+ * and useful answer: "there are some, and this read could not say how many"
8134
+ * still refuses the cutover, which is the whole job.
8135
+ */
8136
+ var UnstampedRowsSchema = object({
8137
+ present: boolean(),
8138
+ rows: number().int().nonnegative().nullable()
8113
8139
  });
8140
+ /**
8141
+ * How many rows still carry NO `locationId` — the population a repoint would
8142
+ * silently re-aim at a disk that does not hold their bytes.
8143
+ *
8144
+ * **`null` = the count could not be taken**, and it is NOT permission to cut
8145
+ * over. The gate opens on a measured absence and on nothing else; an unread
8146
+ * collection and an empty one are different facts, and this repo has already
8147
+ * paid for conflating them (`RelocateResidueSchema`, D295).
8148
+ */
8149
+ var UnstampedEventMediaCountSchema = object({
8150
+ media: UnstampedRowsSchema,
8151
+ retrainFrames: UnstampedRowsSchema,
8152
+ /** True when EITHER collection holds one. The refusal reads this. */
8153
+ anyPresent: boolean(),
8154
+ /** Sum across both, or `null` when either lane could not be counted. */
8155
+ total: number().int().nonnegative().nullable()
8156
+ }).nullable();
8114
8157
  var StorageMigrationMediaMoveInputSchema = RelocateMediaInputSchema.extend({ leaseId: string().min(1) });
8115
8158
  /** The independently selectable logical storage classes — every class
8116
8159
  * `storage.listLocationDeclarations` reports, so an operator never meets a
@@ -8196,13 +8239,53 @@ var StorageMigrationParticipantSchema = _enum([
8196
8239
  "recorder",
8197
8240
  "analytics"
8198
8241
  ]);
8242
+ /**
8243
+ * The mover's own numbers, folded onto the coordinator's durable move record.
8244
+ *
8245
+ * The long half of a non-blocking migration is `draining`, and it is measured
8246
+ * in hours: 136 885 files at ~4 MB/s is about five of them. Before this shape
8247
+ * existed the only place those numbers appeared was a Loki line, so an operator
8248
+ * watching the Admin UI saw `phase: draining` and nothing else for a whole
8249
+ * afternoon.
8250
+ *
8251
+ * It is POLLED, never pushed. Events are telemetry and may be dropped
8252
+ * (D8/D11), and a dropped progress event is indistinguishable from a stalled
8253
+ * mover — which is the exact failure this is meant to end. The coordinator's
8254
+ * `waitForMoves` already fetches the whole {@link RelocateJob} on every tick to
8255
+ * read `state`; folding the counters costs no extra read and makes the durable
8256
+ * record say afterwards how far a move actually got.
8257
+ *
8258
+ * `filesTotal` is `null` for "no honest denominator" and is never zero-filled:
8259
+ * a windowed footage job (`sinceMs`) and a node with no ledger both genuinely
8260
+ * cannot say M, and a 0 there would render as "100 % done".
8261
+ */
8262
+ var StorageMigrationMoveProgressSchema = object({
8263
+ filesMoved: number().int().nonnegative(),
8264
+ /** The archive census — the **M** of "N of M" (D295). `null` = unknowable. */
8265
+ filesTotal: number().int().nonnegative().nullable(),
8266
+ bytesMoved: number().int().nonnegative(),
8267
+ /** Rows the mover corrected while moving them — see `RelocateJob`. Absent on
8268
+ * a lane that cannot reconcile. A migration that silently rewrote durable
8269
+ * rows would be the same failure as one that silently skipped them. */
8270
+ rowsReconciled: number().int().nonnegative().optional(),
8271
+ /** The MOVER's start, not the migration's: a drain restarted after an addon
8272
+ * crash gets a new mover, and a rate computed from the migration's start
8273
+ * would silently average in the time nothing was running. */
8274
+ startedAt: number(),
8275
+ /** When the coordinator last read these numbers. Paired with `startedAt` it
8276
+ * is the only honest rate: both clocks are the hub's, so a UI never has to
8277
+ * subtract its own. */
8278
+ observedAt: number()
8279
+ });
8199
8280
  var StorageMigrationMoveSchema = object({
8200
8281
  storageClass: StorageMigrationClassSchema,
8201
8282
  fromLocationId: string(),
8202
8283
  toLocationId: string(),
8203
8284
  moverJobId: string().nullable(),
8204
8285
  state: RelocateJobStateSchema.nullable(),
8205
- error: string().nullable()
8286
+ error: string().nullable(),
8287
+ /** Last observed mover counters; `null` until the mover has been polled once. */
8288
+ progress: StorageMigrationMoveProgressSchema.nullable()
8206
8289
  });
8207
8290
  var StorageMigrationJobSchema = object({
8208
8291
  jobId: string(),
@@ -8248,6 +8331,98 @@ var StorageMigrationPlanSchema = object({
8248
8331
  findings: array(StorageMigrationFindingSchema)
8249
8332
  });
8250
8333
  /**
8334
+ * A mover as it exists RIGHT NOW, whether or not a migration job owns it.
8335
+ *
8336
+ * The coordinator's job record is the state of record for a migration, and its
8337
+ * moves carry {@link StorageMigrationMoveProgress}. But the movers are usable
8338
+ * standalone — `recording.relocateFootage` and `pipelineAnalytics.relocateMedia`
8339
+ * are both operator-callable, and on 2026-08-29 a five-hour drain was armed that
8340
+ * way because no supported UI path existed. A mover armed like that has no job
8341
+ * to fold progress into, so it has to be readable on its own or it is invisible.
8342
+ *
8343
+ * `migrationJobId` is what tells the two apart: `null` means nothing here
8344
+ * orchestrated it.
8345
+ */
8346
+ var StorageMigrationMoverSchema = object({
8347
+ lane: _enum(["footage", "media"]),
8348
+ job: RelocateJobSchema,
8349
+ /** The coordinator job that armed this mover, or `null` for a mover armed
8350
+ * directly against the owning addon. */
8351
+ migrationJobId: string().nullable(),
8352
+ /** When the hub read these counters. Stamped here so a rate is `bytesMoved`
8353
+ * over (`observedAt` − `job.startedAt`) with BOTH ends on the hub's clock —
8354
+ * a browser subtracting its own `Date.now()` from a server `startedAt` is a
8355
+ * rate made of two different clocks. */
8356
+ observedAt: number()
8357
+ });
8358
+ /**
8359
+ * What a SOURCE still holds for one storage class — the number that makes a
8360
+ * "drain remaining" action honest rather than hopeful.
8361
+ *
8362
+ * It comes from the archive (`SegmentHourLedger.census` for footage, the media
8363
+ * engine's own selection count for media), never from the resident index: a
8364
+ * drain sized off `RecordingIndex` is what reported `done` over 80.3 GB it had
8365
+ * never been told about (D295).
8366
+ *
8367
+ * `items`/`bytes` are `null` for "the archive could not be asked", which is
8368
+ * deliberately NOT zero: a drain is still offered for an unknown residue,
8369
+ * because refusing on an unanswerable read would hide exactly the case an
8370
+ * operator needs to act on.
8371
+ */
8372
+ var StorageMigrationResidueSchema = object({
8373
+ storageClass: StorageMigrationClassSchema,
8374
+ /** The location still holding the data. `'*'` for the media lane, whose rows
8375
+ * move from wherever they are rather than from one named source. */
8376
+ fromLocationId: string(),
8377
+ /** Where a drain would move it — the class's CURRENT default. */
8378
+ toLocationId: string(),
8379
+ /** Segments (footage lane) or rows (media lane) still on the source. */
8380
+ items: number().int().nonnegative().nullable(),
8381
+ /** Bytes on the source; `null` when the lane counts rows rather than bytes. */
8382
+ bytes: number().int().nonnegative().nullable()
8383
+ });
8384
+ /**
8385
+ * Run the DRAIN half and nothing else.
8386
+ *
8387
+ * A migration that reached `done` has already repointed, so `start` correctly
8388
+ * refuses its destination ("already the default") — there is nothing left to
8389
+ * repoint. But the drain can fail, be cancelled, be interrupted by a restart,
8390
+ * or finish against a work list that was a tenth of the archive (D295), and
8391
+ * before this there was no supported way to run only that half: the only way
8392
+ * through was calling `recording.relocateFootage` by hand over admin tRPC.
8393
+ *
8394
+ * `drain` NEVER calls `setDefaultLocations`. That is what keeps `start`'s
8395
+ * refusal meaningful: the two verbs are disjoint, so nothing here can silently
8396
+ * re-repoint a class that is already migrated.
8397
+ */
8398
+ var StorageMigrationDrainInputSchema = object({
8399
+ /** The classes to drain. Each must appear in `storageMigration.residue`, so
8400
+ * a class whose source is already empty is refused rather than started. */
8401
+ classes: array(StorageMigrationClassSchema).min(1),
8402
+ throttleMbps: number().min(1).max(1e3).optional()
8403
+ });
8404
+ /** What a footage source still holds, asked of the durable hour ledger. */
8405
+ var RelocateResidueInputSchema = object({
8406
+ fromLocationId: string().min(1),
8407
+ /** Narrow to one logical class; omit for every profile on the location. */
8408
+ footageClass: RelocateFootageClassSchema.optional()
8409
+ });
8410
+ /** `null` = the archive could not answer (no ledger on this node, or the
8411
+ * aggregate failed). Never conflated with an empty source. */
8412
+ var RelocateResidueSchema = object({
8413
+ segments: number().int().nonnegative(),
8414
+ bytes: number().int().nonnegative()
8415
+ }).nullable();
8416
+ /** How many rows a media pass would still act on against a given target — the
8417
+ * media lane's denominator AND its residue, from ONE derivation so the two can
8418
+ * never disagree. `null` = the count could not be taken. */
8419
+ var RelocatableMediaCountSchema = object({ rows: number().int().nonnegative() }).nullable();
8420
+ var RelocatableMediaCountInputSchema = object({
8421
+ toLocationId: string().min(1),
8422
+ /** Omitted = `move`. */
8423
+ mode: MediaRelocateModeSchema.optional()
8424
+ });
8425
+ /**
8251
8426
  * `StorageLocationType` — an addon-declared id that identifies the *kind* of
8252
8427
  * storage a location serves. Defined here (not in `capabilities/storage.cap.ts`)
8253
8428
  * so the persisted record schema and the consumer-facing cap can both consume it
@@ -8351,6 +8526,32 @@ var StorageLocationRefSchema = union([StorageLocationTypeSchema, string().regex(
8351
8526
  * two addons declaring the same `id` must agree on `cardinality` (validated
8352
8527
  * at kernel aggregation time, not here).
8353
8528
  */
8529
+ /**
8530
+ * `StorageAccess` — how the service that DECLARED a storage-location kind
8531
+ * actually reaches the bytes. It is the constraint that decides which
8532
+ * `storage-provider`s may back a location of that kind.
8533
+ *
8534
+ * - `'local-path'` — the service asks `storage.resolve` for a path string and
8535
+ * then does its own `node:fs` I/O on it (the recorder's segment writer, the
8536
+ * post-analysis media roots). Only a provider that serves a genuine local
8537
+ * filesystem (`getProviderInfo().nodeLocal === true`) can satisfy that: a
8538
+ * remote provider's `resolve` returns a path on the REMOTE host, and
8539
+ * `fs.readdir` of it on this node either fails or — far worse — succeeds
8540
+ * against a same-named local directory that is something else entirely.
8541
+ *
8542
+ * - `'cap-mediated'` — every byte travels through the `storage` cap
8543
+ * (`read`/`write`, or `beginUpload`/`writeChunk`/`finalizeUpload`). The
8544
+ * service never sees a path, so any provider can back it. `backups` is the
8545
+ * one kind that qualifies today.
8546
+ *
8547
+ * Before this existed, `recordings` was unreachable by SFTP/S3/WebDAV only as
8548
+ * an EMERGENT property of how the recorder happened to be written. Nothing
8549
+ * refused the configuration; the first write simply went somewhere wrong, and
8550
+ * a recording write that goes wrong surfaces as a silent black window rather
8551
+ * than an error (the read path does not `stat`). This turns that accident into
8552
+ * a declared, enforced, testable refusal.
8553
+ */
8554
+ var StorageAccessSchema = _enum(["local-path", "cap-mediated"]);
8354
8555
  var StorageLocationDeclarationSchema = object({
8355
8556
  /**
8356
8557
  * Global location identifier, e.g. `recordings` or `recordingsLow`.
@@ -8370,6 +8571,19 @@ var StorageLocationDeclarationSchema = object({
8370
8571
  */
8371
8572
  cardinality: _enum(["single", "multi"]),
8372
8573
  /**
8574
+ * HOW the declaring service reaches the bytes — and therefore WHICH
8575
+ * providers may back a location of this kind. See {@link StorageAccessSchema}
8576
+ * and {@link STORAGE_ACCESS_FALLBACK}.
8577
+ *
8578
+ * Absent means `'local-path'`. That default is FAIL-CLOSED on purpose: it
8579
+ * can only over-restrict (refuse a remote provider for a kind that might
8580
+ * have coped) and never under-restrict. Declaring `'cap-mediated'` is the
8581
+ * permissive direction and is therefore never inferred — a repo guard
8582
+ * (`scripts/check-storage-access-declarations.ts`) refuses to let it be
8583
+ * reached by omission.
8584
+ */
8585
+ access: StorageAccessSchema.optional(),
8586
+ /**
8373
8587
  * When set, the default instance for this location inherits its resolved
8374
8588
  * root from the named location's default instance. Useful for derivative
8375
8589
  * slots (e.g. `recordingsLow` → `recordings`) so operators only need to
@@ -18237,8 +18451,10 @@ var TrackSchema = object({
18237
18451
  lastSeen: number(),
18238
18452
  /** Frame-rate position history (subject to maxPositionHistory cap). */
18239
18453
  positions: array(TrackPositionSchema).readonly(),
18240
- /** Periodic snapshots at snapshotIntervalMs cadence (subject to
18241
- * saveThumbnails policy). */
18454
+ /** Periodic snapshots at snapshotIntervalMs cadence DEBUG media, produced
18455
+ * only while `MediaSettings.debugMediaEnabled` is on for the camera (D299;
18456
+ * the retired `saveThumbnails` used to gate this and the rolling
18457
+ * `lastFrame` together). Empty is the healthy default, not a capture gap. */
18242
18458
  snapshots: array(TrackSnapshotSchema).readonly(),
18243
18459
  /** Deduplicated zones the track has entered at least once. Zone IDS. */
18244
18460
  zonesVisited: array(string()).readonly(),
@@ -19098,7 +19314,10 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
19098
19314
  }), method(RelocateMediaInputSchema, object({ jobId: string() }), {
19099
19315
  kind: "mutation",
19100
19316
  auth: "admin"
19101
- }), method(object({}), UnstampedEventMediaCountSchema, { auth: "admin" }), method(object({}), array(RelocateJobSchema).readonly(), {
19317
+ }), method(object({}), UnstampedEventMediaCountSchema, { auth: "admin" }), method(RelocatableMediaCountInputSchema, RelocatableMediaCountSchema, {
19318
+ kind: "query",
19319
+ auth: "admin"
19320
+ }), method(object({}), array(RelocateJobSchema).readonly(), {
19102
19321
  kind: "query",
19103
19322
  auth: "admin"
19104
19323
  }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
@@ -21161,6 +21380,9 @@ method(StorageMigrationInputSchema, StorageMigrationPlanSchema, { auth: "admin"
21161
21380
  }), method(object({ jobId: string().optional() }), StorageMigrationJobSchema.nullable(), { auth: "admin" }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
21162
21381
  kind: "mutation",
21163
21382
  auth: "admin"
21383
+ }), method(object({}), array(StorageMigrationMoverSchema).readonly(), { auth: "admin" }), method(object({}), array(StorageMigrationResidueSchema).readonly(), { auth: "admin" }), method(StorageMigrationDrainInputSchema, object({ jobId: string() }), {
21384
+ kind: "mutation",
21385
+ auth: "admin"
21164
21386
  });
21165
21387
  var ProviderInfoSchema = discriminatedUnion("shouldSaveDiskSpace", [object({
21166
21388
  providerId: string().min(1),
@@ -21559,12 +21781,38 @@ response: record(string(), unknown()) }), object({
21559
21781
  *
21560
21782
  * ## Why this is a capability and not a helper
21561
21783
  *
21562
- * Six stores in `addon-post-analysis` already hold vectors object CLIP, face,
21563
- * plate, vehicle, identity, and the event store's derivativesand every one of
21564
- * them keeps its vectors in a `JSON` settings-store column and ranks them by
21565
- * brute-force cosine in JS. Measured on the live hub that costs ~11.7 KB per row
21566
- * (512 floats as TEXT, `JSON.parse`d on every search) and made semantic search
21567
- * load 5,000 rows before ranking anything.
21784
+ * This capability was introduced with the claim that SIX stores in
21785
+ * `addon-post-analysis` held vectors in a `JSON` settings-store columnobject
21786
+ * CLIP, face, plate, vehicle, identity, and the event store's derivatives. That
21787
+ * claim was never true, and leaving it here made five stores look like pending
21788
+ * work when three of them have no vector at all. Counted column by column on
21789
+ * 2026-08-30, exactly THREE ever held one:
21790
+ *
21791
+ * - `object-clip` — 512-dim CLIP image embedding, migrated 2026-08-06.
21792
+ * - `faces.embedding` — 512-dim ArcFace face embedding, migrated 2026-08-30.
21793
+ * - `identity-samples.embedding` — the same ArcFace vector for an ENROLLED
21794
+ * face, migrated 2026-08-30 into its OWN index (see below).
21795
+ *
21796
+ * `plates` and `vehicle-samples` store a plate STRING and a score; `vehicles`
21797
+ * and `identities` store a name; the event store stores no derivative vector.
21798
+ * They are not migration candidates and never were.
21799
+ *
21800
+ * Measured on the live hub the JSON encoding cost ~11.7 KB per row (512 floats
21801
+ * as TEXT, `JSON.parse`d on every search) and made semantic search load 5,000
21802
+ * rows before ranking anything.
21803
+ *
21804
+ * ## One index per COMPARISON, never per encoder
21805
+ *
21806
+ * `faces` and `identity-samples` hold the same 512 ArcFace dims from the same
21807
+ * model, and they still get two indexes. An index is a set of things that are
21808
+ * ranked against each other and that live and die together, and these two are
21809
+ * neither: a `faces` row is TRACK-OWNED and cascades away with its track under
21810
+ * a per-camera capacity cap, an `identity-samples` row is retention-EXEMPT
21811
+ * forever and is the gallery every recognition ranks against. One index would
21812
+ * mean every gallery load and every reconcile carried a filter whose failure
21813
+ * mode is either ranking a candidate against itself or reclaiming an enrolled
21814
+ * person's only sample. The dimension they share is not a reason to share an
21815
+ * index; the question they answer is, and it differs.
21568
21816
  *
21569
21817
  * The fix is not a faster loop, it is a different backend — and the backend
21570
21818
  * should be replaceable without touching six callers. So: a singleton
@@ -21669,7 +21917,20 @@ var VectorQueryResultSchema = object({
21669
21917
  */
21670
21918
  scanned: number(),
21671
21919
  /** True when the backend could not consider every row that passed the filter. */
21672
- truncated: boolean()
21920
+ truncated: boolean(),
21921
+ /**
21922
+ * The `topK` the backend actually ran with.
21923
+ *
21924
+ * Every backend has a ceiling — sqlite-vec's is 4,096 — and a caller asking
21925
+ * past it used to learn nothing but a boolean, from a WARN in the provider's
21926
+ * own log rather than in its answer. That is how an audit asking for 20,000
21927
+ * consumed 4,096 and reported `examined: 4096` as if it had walked the index,
21928
+ * for weeks. `truncated` says THAT the answer was short; this says BY HOW
21929
+ * MUCH, in the return value, where the caller cannot fail to see it.
21930
+ *
21931
+ * Equals the requested `topK` whenever nothing was lowered.
21932
+ */
21933
+ effectiveTopK: number().int().positive()
21673
21934
  });
21674
21935
  var VectorDeleteInputSchema = object({
21675
21936
  index: string(),
@@ -21698,6 +21959,68 @@ var VectorGetResultSchema = object({ items: array(object({
21698
21959
  id: string(),
21699
21960
  metadata: VectorMetadataSchema
21700
21961
  })) });
21962
+ /**
21963
+ * Ids to read back WITH their vectors.
21964
+ *
21965
+ * The sibling of {@link VectorGetResultSchema}, and deliberately a separate
21966
+ * method rather than a flag on it: `getByIds` promises no vectors and its one
21967
+ * caller depends on that promise. This one promises the opposite.
21968
+ *
21969
+ * It exists because a store cannot put its vectors here otherwise. An ArcFace
21970
+ * gallery is ranked IN PROCESS, per detection, against every enrolled sample —
21971
+ * a per-face cross-process KNN would be a network round trip inside the
21972
+ * recognition loop. So the gallery is loaded once and held in RAM, and loading
21973
+ * it requires the index to hand the floats back. Without this method the only
21974
+ * way to keep a readable vector is a JSON column, which is the thing this
21975
+ * capability exists to delete.
21976
+ *
21977
+ * BOUNDED BY THE CALLER: ids are named, never "everything". Enumerating an
21978
+ * index is {@link VectorScanInputSchema}'s job, and it returns no vectors.
21979
+ */
21980
+ var VectorFetchInputSchema = object({
21981
+ index: string(),
21982
+ ids: array(string())
21983
+ });
21984
+ var VectorFetchResultSchema = object({ items: array(object({
21985
+ id: string(),
21986
+ /** base64 Float32LE — the same wire form `upsert` accepts. */
21987
+ vector: string(),
21988
+ metadata: VectorMetadataSchema
21989
+ })) });
21990
+ /**
21991
+ * ENUMERATE an index: one page of rows in a stable order, no ranking.
21992
+ *
21993
+ * A reconcile does not want the nearest rows, it wants ALL of them, and asking
21994
+ * a KNN for "all" is the wrong question twice over. It hits the backend's `k`
21995
+ * ceiling — 4,096 on sqlite-vec against a 22,128-row index — and it needs a
21996
+ * probe vector it does not have, so the audit passed a ZERO vector whose cosine
21997
+ * distance to every row is degenerate. `examined: 4096` then read as "we
21998
+ * looked" for as long as anyone cared to read it.
21999
+ *
22000
+ * This is the primitive that question actually needs: a bounded page, ordered
22001
+ * by the backend's own row order, costing no distance computation at all.
22002
+ * Vectors are NOT returned — an enumeration that shipped 2 KB per row would be
22003
+ * the full-table read this capability was built to stop.
22004
+ */
22005
+ var VectorScanInputSchema = object({
22006
+ index: string(),
22007
+ /** Opaque resume point. `0` starts at the top; pass back `nextCursor`. */
22008
+ cursor: number().int().nonnegative().default(0),
22009
+ limit: number().int().positive()
22010
+ });
22011
+ var VectorScanResultSchema = object({
22012
+ items: array(object({
22013
+ id: string(),
22014
+ metadata: VectorMetadataSchema
22015
+ })),
22016
+ /**
22017
+ * Where the next page starts, or `null` when the walk reached the end.
22018
+ *
22019
+ * `null` is the ONLY end-of-index signal. A caller must not infer the end
22020
+ * from a short page: a backend is free to return fewer rows than asked.
22021
+ */
22022
+ nextCursor: number().int().nonnegative().nullable()
22023
+ });
21701
22024
  var VectorStatsInputSchema = object({ index: string() });
21702
22025
  var VectorStatsResultSchema = object({
21703
22026
  /** Provider id, so an operator can tell brute force from an ANN index. */
@@ -21716,7 +22039,7 @@ method(VectorDeclareIndexInputSchema, _void(), {
21716
22039
  }), method(VectorUpsertInputSchema, VectorUpsertResultSchema, {
21717
22040
  kind: "mutation",
21718
22041
  auth: "admin"
21719
- }), method(VectorQueryInputSchema, VectorQueryResultSchema, { auth: "admin" }), method(VectorGetInputSchema, VectorGetResultSchema, { auth: "admin" }), method(VectorDeleteInputSchema, VectorDeleteResultSchema, {
22042
+ }), method(VectorQueryInputSchema, VectorQueryResultSchema, { auth: "admin" }), method(VectorGetInputSchema, VectorGetResultSchema, { auth: "admin" }), method(VectorFetchInputSchema, VectorFetchResultSchema, { auth: "admin" }), method(VectorScanInputSchema, VectorScanResultSchema, { auth: "admin" }), method(VectorDeleteInputSchema, VectorDeleteResultSchema, {
21720
22043
  kind: "mutation",
21721
22044
  auth: "admin"
21722
22045
  }), method(VectorDeleteByFilterInputSchema, VectorDeleteResultSchema, {
@@ -28343,6 +28666,9 @@ method(object({
28343
28666
  }), method(object({}), array(RelocateJobSchema).readonly(), {
28344
28667
  kind: "query",
28345
28668
  auth: "admin"
28669
+ }), method(RelocateResidueInputSchema, RelocateResidueSchema, {
28670
+ kind: "query",
28671
+ auth: "admin"
28346
28672
  }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
28347
28673
  kind: "mutation",
28348
28674
  auth: "admin"
@@ -35043,6 +35369,12 @@ Object.freeze({
35043
35369
  addonId: null,
35044
35370
  access: "create"
35045
35371
  },
35372
+ "pipelineAnalytics.countRelocatableMedia": {
35373
+ capName: "pipeline-analytics",
35374
+ capScope: "device",
35375
+ addonId: null,
35376
+ access: "view"
35377
+ },
35046
35378
  "pipelineAnalytics.countUnstampedEventMedia": {
35047
35379
  capName: "pipeline-analytics",
35048
35380
  capScope: "device",
@@ -36207,6 +36539,12 @@ Object.freeze({
36207
36539
  addonId: null,
36208
36540
  access: "view"
36209
36541
  },
36542
+ "recording.getRelocateResidue": {
36543
+ capName: "recording",
36544
+ capScope: "system",
36545
+ addonId: null,
36546
+ access: "view"
36547
+ },
36210
36548
  "recording.getStorageMigrationMoveStatus": {
36211
36549
  capName: "recording",
36212
36550
  capScope: "system",
@@ -36753,12 +37091,30 @@ Object.freeze({
36753
37091
  addonId: null,
36754
37092
  access: "create"
36755
37093
  },
37094
+ "storageMigration.drain": {
37095
+ capName: "storage-migration",
37096
+ capScope: "system",
37097
+ addonId: null,
37098
+ access: "create"
37099
+ },
37100
+ "storageMigration.movers": {
37101
+ capName: "storage-migration",
37102
+ capScope: "system",
37103
+ addonId: null,
37104
+ access: "view"
37105
+ },
36756
37106
  "storageMigration.plan": {
36757
37107
  capName: "storage-migration",
36758
37108
  capScope: "system",
36759
37109
  addonId: null,
36760
37110
  access: "view"
36761
37111
  },
37112
+ "storageMigration.residue": {
37113
+ capName: "storage-migration",
37114
+ capScope: "system",
37115
+ addonId: null,
37116
+ access: "view"
37117
+ },
36762
37118
  "storageMigration.start": {
36763
37119
  capName: "storage-migration",
36764
37120
  capScope: "system",
@@ -37593,6 +37949,12 @@ Object.freeze({
37593
37949
  addonId: null,
37594
37950
  access: "delete"
37595
37951
  },
37952
+ "vectorStore.fetchByIds": {
37953
+ capName: "vector-store",
37954
+ capScope: "system",
37955
+ addonId: null,
37956
+ access: "view"
37957
+ },
37596
37958
  "vectorStore.getByIds": {
37597
37959
  capName: "vector-store",
37598
37960
  capScope: "system",
@@ -37605,6 +37967,12 @@ Object.freeze({
37605
37967
  addonId: null,
37606
37968
  access: "view"
37607
37969
  },
37970
+ "vectorStore.scan": {
37971
+ capName: "vector-store",
37972
+ capScope: "system",
37973
+ addonId: null,
37974
+ access: "view"
37975
+ },
37608
37976
  "vectorStore.stats": {
37609
37977
  capName: "vector-store",
37610
37978
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-rtsp",
3
- "version": "1.2.43",
3
+ "version": "1.2.46",
4
4
  "description": "Generic RTSP camera device provider addon for CamStack",
5
5
  "keywords": [
6
6
  "camstack",