@camstack/addon-pipeline-orchestrator 1.2.123 → 1.2.126
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.
- package/dist/_stub.js +17 -17
- package/dist/{_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_orchestrator_widgets-DL1qwx7Q.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_orchestrator_widgets-CXhvoqSz.mjs} +3 -3
- package/dist/{_virtual_mf___mfe_internal__addon_pipeline_orchestrator_widgets__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-CQ6M_h0r.mjs → _virtual_mf___mfe_internal__addon_pipeline_orchestrator_widgets__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-CJq8bXZN.mjs} +2 -2
- package/dist/{_virtual_mf___mfe_internal__addon_pipeline_orchestrator_widgets__loadShare___mf_0_camstack_mf_1_ui_mf_2_library__loadShare__.js-ya4NzlNq.mjs → _virtual_mf___mfe_internal__addon_pipeline_orchestrator_widgets__loadShare___mf_0_camstack_mf_1_ui_mf_2_library__loadShare__.js-Cg19xcCo.mjs} +1 -1
- package/dist/{hostInit-DaQPA33g.mjs → hostInit-TesSFjYU.mjs} +3 -3
- package/dist/index.js +387 -19
- package/dist/index.mjs +387 -19
- package/dist/remoteEntry.js +1 -1
- package/package.json +1 -1
package/dist/index.mjs
CHANGED
|
@@ -8851,6 +8851,21 @@ var RelocateJobSchema = object({
|
|
|
8851
8851
|
bytesMoved: number().int(),
|
|
8852
8852
|
/** Total files discovered up front; null while (or when) unknown. */
|
|
8853
8853
|
filesTotal: number().int().nullable(),
|
|
8854
|
+
/**
|
|
8855
|
+
* Rows this run CORRECTED while moving them — a durable mutation the move
|
|
8856
|
+
* made that nobody asked for, so it is reported where the operator reads the
|
|
8857
|
+
* job rather than only in a log line.
|
|
8858
|
+
*
|
|
8859
|
+
* A footage segment records its byte count in its own NAME, and the durable
|
|
8860
|
+
* hour row derives its aggregates from those names. A file that does not
|
|
8861
|
+
* match its name therefore makes the ledger's sums — and with them quota and
|
|
8862
|
+
* pressure eviction — wrong by the difference, and only a rename can fix it.
|
|
8863
|
+
* On 2026-08-30 one such row also stalled a 110 749-file drain permanently.
|
|
8864
|
+
*
|
|
8865
|
+
* Absent on lanes where the question has no meaning: a media blob's size is
|
|
8866
|
+
* in its row, not in its name, so `MediaRelocateEngine` never reconciles one.
|
|
8867
|
+
*/
|
|
8868
|
+
rowsReconciled: number().int().nonnegative().optional(),
|
|
8854
8869
|
startedAt: number(),
|
|
8855
8870
|
finishedAt: number().nullable(),
|
|
8856
8871
|
error: string().nullable()
|
|
@@ -8919,14 +8934,42 @@ var RelocateMediaInputSchema = object({
|
|
|
8919
8934
|
/** Omitted = `move`, the pre-existing behaviour. */
|
|
8920
8935
|
mode: MediaRelocateModeSchema.optional()
|
|
8921
8936
|
});
|
|
8922
|
-
/**
|
|
8923
|
-
*
|
|
8924
|
-
*
|
|
8925
|
-
|
|
8926
|
-
|
|
8927
|
-
|
|
8928
|
-
|
|
8937
|
+
/**
|
|
8938
|
+
* The unstamped population of ONE collection — split, because the gate and the
|
|
8939
|
+
* operator ask two different questions and only one of them has to be cheap.
|
|
8940
|
+
*
|
|
8941
|
+
* `present` is the GATE: "is there at least one row that would be orphaned by a
|
|
8942
|
+
* repoint". It is a single indexed seek to the first matching row, so it stays
|
|
8943
|
+
* answerable on a saturated disk and answers in O(log n) precisely in the state
|
|
8944
|
+
* that matters — after a seal, when the population is empty.
|
|
8945
|
+
*
|
|
8946
|
+
* `rows` is the NUMBER, for the refusal message and the operator's sense of
|
|
8947
|
+
* scale. It is a second, indexed `COUNT(*)`, and `null` means **not
|
|
8948
|
+
* measurable** — never zero. `{ present: true, rows: null }` is a legitimate
|
|
8949
|
+
* and useful answer: "there are some, and this read could not say how many"
|
|
8950
|
+
* still refuses the cutover, which is the whole job.
|
|
8951
|
+
*/
|
|
8952
|
+
var UnstampedRowsSchema = object({
|
|
8953
|
+
present: boolean(),
|
|
8954
|
+
rows: number().int().nonnegative().nullable()
|
|
8929
8955
|
});
|
|
8956
|
+
/**
|
|
8957
|
+
* How many rows still carry NO `locationId` — the population a repoint would
|
|
8958
|
+
* silently re-aim at a disk that does not hold their bytes.
|
|
8959
|
+
*
|
|
8960
|
+
* **`null` = the count could not be taken**, and it is NOT permission to cut
|
|
8961
|
+
* over. The gate opens on a measured absence and on nothing else; an unread
|
|
8962
|
+
* collection and an empty one are different facts, and this repo has already
|
|
8963
|
+
* paid for conflating them (`RelocateResidueSchema`, D295).
|
|
8964
|
+
*/
|
|
8965
|
+
var UnstampedEventMediaCountSchema = object({
|
|
8966
|
+
media: UnstampedRowsSchema,
|
|
8967
|
+
retrainFrames: UnstampedRowsSchema,
|
|
8968
|
+
/** True when EITHER collection holds one. The refusal reads this. */
|
|
8969
|
+
anyPresent: boolean(),
|
|
8970
|
+
/** Sum across both, or `null` when either lane could not be counted. */
|
|
8971
|
+
total: number().int().nonnegative().nullable()
|
|
8972
|
+
}).nullable();
|
|
8930
8973
|
var StorageMigrationMediaMoveInputSchema = RelocateMediaInputSchema.extend({ leaseId: string().min(1) });
|
|
8931
8974
|
/** The independently selectable logical storage classes — every class
|
|
8932
8975
|
* `storage.listLocationDeclarations` reports, so an operator never meets a
|
|
@@ -9012,13 +9055,53 @@ var StorageMigrationParticipantSchema = _enum([
|
|
|
9012
9055
|
"recorder",
|
|
9013
9056
|
"analytics"
|
|
9014
9057
|
]);
|
|
9058
|
+
/**
|
|
9059
|
+
* The mover's own numbers, folded onto the coordinator's durable move record.
|
|
9060
|
+
*
|
|
9061
|
+
* The long half of a non-blocking migration is `draining`, and it is measured
|
|
9062
|
+
* in hours: 136 885 files at ~4 MB/s is about five of them. Before this shape
|
|
9063
|
+
* existed the only place those numbers appeared was a Loki line, so an operator
|
|
9064
|
+
* watching the Admin UI saw `phase: draining` and nothing else for a whole
|
|
9065
|
+
* afternoon.
|
|
9066
|
+
*
|
|
9067
|
+
* It is POLLED, never pushed. Events are telemetry and may be dropped
|
|
9068
|
+
* (D8/D11), and a dropped progress event is indistinguishable from a stalled
|
|
9069
|
+
* mover — which is the exact failure this is meant to end. The coordinator's
|
|
9070
|
+
* `waitForMoves` already fetches the whole {@link RelocateJob} on every tick to
|
|
9071
|
+
* read `state`; folding the counters costs no extra read and makes the durable
|
|
9072
|
+
* record say afterwards how far a move actually got.
|
|
9073
|
+
*
|
|
9074
|
+
* `filesTotal` is `null` for "no honest denominator" and is never zero-filled:
|
|
9075
|
+
* a windowed footage job (`sinceMs`) and a node with no ledger both genuinely
|
|
9076
|
+
* cannot say M, and a 0 there would render as "100 % done".
|
|
9077
|
+
*/
|
|
9078
|
+
var StorageMigrationMoveProgressSchema = object({
|
|
9079
|
+
filesMoved: number().int().nonnegative(),
|
|
9080
|
+
/** The archive census — the **M** of "N of M" (D295). `null` = unknowable. */
|
|
9081
|
+
filesTotal: number().int().nonnegative().nullable(),
|
|
9082
|
+
bytesMoved: number().int().nonnegative(),
|
|
9083
|
+
/** Rows the mover corrected while moving them — see `RelocateJob`. Absent on
|
|
9084
|
+
* a lane that cannot reconcile. A migration that silently rewrote durable
|
|
9085
|
+
* rows would be the same failure as one that silently skipped them. */
|
|
9086
|
+
rowsReconciled: number().int().nonnegative().optional(),
|
|
9087
|
+
/** The MOVER's start, not the migration's: a drain restarted after an addon
|
|
9088
|
+
* crash gets a new mover, and a rate computed from the migration's start
|
|
9089
|
+
* would silently average in the time nothing was running. */
|
|
9090
|
+
startedAt: number(),
|
|
9091
|
+
/** When the coordinator last read these numbers. Paired with `startedAt` it
|
|
9092
|
+
* is the only honest rate: both clocks are the hub's, so a UI never has to
|
|
9093
|
+
* subtract its own. */
|
|
9094
|
+
observedAt: number()
|
|
9095
|
+
});
|
|
9015
9096
|
var StorageMigrationMoveSchema = object({
|
|
9016
9097
|
storageClass: StorageMigrationClassSchema,
|
|
9017
9098
|
fromLocationId: string(),
|
|
9018
9099
|
toLocationId: string(),
|
|
9019
9100
|
moverJobId: string().nullable(),
|
|
9020
9101
|
state: RelocateJobStateSchema.nullable(),
|
|
9021
|
-
error: string().nullable()
|
|
9102
|
+
error: string().nullable(),
|
|
9103
|
+
/** Last observed mover counters; `null` until the mover has been polled once. */
|
|
9104
|
+
progress: StorageMigrationMoveProgressSchema.nullable()
|
|
9022
9105
|
});
|
|
9023
9106
|
var StorageMigrationJobSchema = object({
|
|
9024
9107
|
jobId: string(),
|
|
@@ -9064,6 +9147,98 @@ var StorageMigrationPlanSchema = object({
|
|
|
9064
9147
|
findings: array(StorageMigrationFindingSchema)
|
|
9065
9148
|
});
|
|
9066
9149
|
/**
|
|
9150
|
+
* A mover as it exists RIGHT NOW, whether or not a migration job owns it.
|
|
9151
|
+
*
|
|
9152
|
+
* The coordinator's job record is the state of record for a migration, and its
|
|
9153
|
+
* moves carry {@link StorageMigrationMoveProgress}. But the movers are usable
|
|
9154
|
+
* standalone — `recording.relocateFootage` and `pipelineAnalytics.relocateMedia`
|
|
9155
|
+
* are both operator-callable, and on 2026-08-29 a five-hour drain was armed that
|
|
9156
|
+
* way because no supported UI path existed. A mover armed like that has no job
|
|
9157
|
+
* to fold progress into, so it has to be readable on its own or it is invisible.
|
|
9158
|
+
*
|
|
9159
|
+
* `migrationJobId` is what tells the two apart: `null` means nothing here
|
|
9160
|
+
* orchestrated it.
|
|
9161
|
+
*/
|
|
9162
|
+
var StorageMigrationMoverSchema = object({
|
|
9163
|
+
lane: _enum(["footage", "media"]),
|
|
9164
|
+
job: RelocateJobSchema,
|
|
9165
|
+
/** The coordinator job that armed this mover, or `null` for a mover armed
|
|
9166
|
+
* directly against the owning addon. */
|
|
9167
|
+
migrationJobId: string().nullable(),
|
|
9168
|
+
/** When the hub read these counters. Stamped here so a rate is `bytesMoved`
|
|
9169
|
+
* over (`observedAt` − `job.startedAt`) with BOTH ends on the hub's clock —
|
|
9170
|
+
* a browser subtracting its own `Date.now()` from a server `startedAt` is a
|
|
9171
|
+
* rate made of two different clocks. */
|
|
9172
|
+
observedAt: number()
|
|
9173
|
+
});
|
|
9174
|
+
/**
|
|
9175
|
+
* What a SOURCE still holds for one storage class — the number that makes a
|
|
9176
|
+
* "drain remaining" action honest rather than hopeful.
|
|
9177
|
+
*
|
|
9178
|
+
* It comes from the archive (`SegmentHourLedger.census` for footage, the media
|
|
9179
|
+
* engine's own selection count for media), never from the resident index: a
|
|
9180
|
+
* drain sized off `RecordingIndex` is what reported `done` over 80.3 GB it had
|
|
9181
|
+
* never been told about (D295).
|
|
9182
|
+
*
|
|
9183
|
+
* `items`/`bytes` are `null` for "the archive could not be asked", which is
|
|
9184
|
+
* deliberately NOT zero: a drain is still offered for an unknown residue,
|
|
9185
|
+
* because refusing on an unanswerable read would hide exactly the case an
|
|
9186
|
+
* operator needs to act on.
|
|
9187
|
+
*/
|
|
9188
|
+
var StorageMigrationResidueSchema = object({
|
|
9189
|
+
storageClass: StorageMigrationClassSchema,
|
|
9190
|
+
/** The location still holding the data. `'*'` for the media lane, whose rows
|
|
9191
|
+
* move from wherever they are rather than from one named source. */
|
|
9192
|
+
fromLocationId: string(),
|
|
9193
|
+
/** Where a drain would move it — the class's CURRENT default. */
|
|
9194
|
+
toLocationId: string(),
|
|
9195
|
+
/** Segments (footage lane) or rows (media lane) still on the source. */
|
|
9196
|
+
items: number().int().nonnegative().nullable(),
|
|
9197
|
+
/** Bytes on the source; `null` when the lane counts rows rather than bytes. */
|
|
9198
|
+
bytes: number().int().nonnegative().nullable()
|
|
9199
|
+
});
|
|
9200
|
+
/**
|
|
9201
|
+
* Run the DRAIN half and nothing else.
|
|
9202
|
+
*
|
|
9203
|
+
* A migration that reached `done` has already repointed, so `start` correctly
|
|
9204
|
+
* refuses its destination ("already the default") — there is nothing left to
|
|
9205
|
+
* repoint. But the drain can fail, be cancelled, be interrupted by a restart,
|
|
9206
|
+
* or finish against a work list that was a tenth of the archive (D295), and
|
|
9207
|
+
* before this there was no supported way to run only that half: the only way
|
|
9208
|
+
* through was calling `recording.relocateFootage` by hand over admin tRPC.
|
|
9209
|
+
*
|
|
9210
|
+
* `drain` NEVER calls `setDefaultLocations`. That is what keeps `start`'s
|
|
9211
|
+
* refusal meaningful: the two verbs are disjoint, so nothing here can silently
|
|
9212
|
+
* re-repoint a class that is already migrated.
|
|
9213
|
+
*/
|
|
9214
|
+
var StorageMigrationDrainInputSchema = object({
|
|
9215
|
+
/** The classes to drain. Each must appear in `storageMigration.residue`, so
|
|
9216
|
+
* a class whose source is already empty is refused rather than started. */
|
|
9217
|
+
classes: array(StorageMigrationClassSchema).min(1),
|
|
9218
|
+
throttleMbps: number().min(1).max(1e3).optional()
|
|
9219
|
+
});
|
|
9220
|
+
/** What a footage source still holds, asked of the durable hour ledger. */
|
|
9221
|
+
var RelocateResidueInputSchema = object({
|
|
9222
|
+
fromLocationId: string().min(1),
|
|
9223
|
+
/** Narrow to one logical class; omit for every profile on the location. */
|
|
9224
|
+
footageClass: RelocateFootageClassSchema.optional()
|
|
9225
|
+
});
|
|
9226
|
+
/** `null` = the archive could not answer (no ledger on this node, or the
|
|
9227
|
+
* aggregate failed). Never conflated with an empty source. */
|
|
9228
|
+
var RelocateResidueSchema = object({
|
|
9229
|
+
segments: number().int().nonnegative(),
|
|
9230
|
+
bytes: number().int().nonnegative()
|
|
9231
|
+
}).nullable();
|
|
9232
|
+
/** How many rows a media pass would still act on against a given target — the
|
|
9233
|
+
* media lane's denominator AND its residue, from ONE derivation so the two can
|
|
9234
|
+
* never disagree. `null` = the count could not be taken. */
|
|
9235
|
+
var RelocatableMediaCountSchema = object({ rows: number().int().nonnegative() }).nullable();
|
|
9236
|
+
var RelocatableMediaCountInputSchema = object({
|
|
9237
|
+
toLocationId: string().min(1),
|
|
9238
|
+
/** Omitted = `move`. */
|
|
9239
|
+
mode: MediaRelocateModeSchema.optional()
|
|
9240
|
+
});
|
|
9241
|
+
/**
|
|
9067
9242
|
* `StorageLocationType` — an addon-declared id that identifies the *kind* of
|
|
9068
9243
|
* storage a location serves. Defined here (not in `capabilities/storage.cap.ts`)
|
|
9069
9244
|
* so the persisted record schema and the consumer-facing cap can both consume it
|
|
@@ -9167,6 +9342,32 @@ var StorageLocationRefSchema = union([StorageLocationTypeSchema, string().regex(
|
|
|
9167
9342
|
* two addons declaring the same `id` must agree on `cardinality` (validated
|
|
9168
9343
|
* at kernel aggregation time, not here).
|
|
9169
9344
|
*/
|
|
9345
|
+
/**
|
|
9346
|
+
* `StorageAccess` — how the service that DECLARED a storage-location kind
|
|
9347
|
+
* actually reaches the bytes. It is the constraint that decides which
|
|
9348
|
+
* `storage-provider`s may back a location of that kind.
|
|
9349
|
+
*
|
|
9350
|
+
* - `'local-path'` — the service asks `storage.resolve` for a path string and
|
|
9351
|
+
* then does its own `node:fs` I/O on it (the recorder's segment writer, the
|
|
9352
|
+
* post-analysis media roots). Only a provider that serves a genuine local
|
|
9353
|
+
* filesystem (`getProviderInfo().nodeLocal === true`) can satisfy that: a
|
|
9354
|
+
* remote provider's `resolve` returns a path on the REMOTE host, and
|
|
9355
|
+
* `fs.readdir` of it on this node either fails or — far worse — succeeds
|
|
9356
|
+
* against a same-named local directory that is something else entirely.
|
|
9357
|
+
*
|
|
9358
|
+
* - `'cap-mediated'` — every byte travels through the `storage` cap
|
|
9359
|
+
* (`read`/`write`, or `beginUpload`/`writeChunk`/`finalizeUpload`). The
|
|
9360
|
+
* service never sees a path, so any provider can back it. `backups` is the
|
|
9361
|
+
* one kind that qualifies today.
|
|
9362
|
+
*
|
|
9363
|
+
* Before this existed, `recordings` was unreachable by SFTP/S3/WebDAV only as
|
|
9364
|
+
* an EMERGENT property of how the recorder happened to be written. Nothing
|
|
9365
|
+
* refused the configuration; the first write simply went somewhere wrong, and
|
|
9366
|
+
* a recording write that goes wrong surfaces as a silent black window rather
|
|
9367
|
+
* than an error (the read path does not `stat`). This turns that accident into
|
|
9368
|
+
* a declared, enforced, testable refusal.
|
|
9369
|
+
*/
|
|
9370
|
+
var StorageAccessSchema = _enum(["local-path", "cap-mediated"]);
|
|
9170
9371
|
var StorageLocationDeclarationSchema = object({
|
|
9171
9372
|
/**
|
|
9172
9373
|
* Global location identifier, e.g. `recordings` or `recordingsLow`.
|
|
@@ -9186,6 +9387,19 @@ var StorageLocationDeclarationSchema = object({
|
|
|
9186
9387
|
*/
|
|
9187
9388
|
cardinality: _enum(["single", "multi"]),
|
|
9188
9389
|
/**
|
|
9390
|
+
* HOW the declaring service reaches the bytes — and therefore WHICH
|
|
9391
|
+
* providers may back a location of this kind. See {@link StorageAccessSchema}
|
|
9392
|
+
* and {@link STORAGE_ACCESS_FALLBACK}.
|
|
9393
|
+
*
|
|
9394
|
+
* Absent means `'local-path'`. That default is FAIL-CLOSED on purpose: it
|
|
9395
|
+
* can only over-restrict (refuse a remote provider for a kind that might
|
|
9396
|
+
* have coped) and never under-restrict. Declaring `'cap-mediated'` is the
|
|
9397
|
+
* permissive direction and is therefore never inferred — a repo guard
|
|
9398
|
+
* (`scripts/check-storage-access-declarations.ts`) refuses to let it be
|
|
9399
|
+
* reached by omission.
|
|
9400
|
+
*/
|
|
9401
|
+
access: StorageAccessSchema.optional(),
|
|
9402
|
+
/**
|
|
9189
9403
|
* When set, the default instance for this location inherits its resolved
|
|
9190
9404
|
* root from the named location's default instance. Useful for derivative
|
|
9191
9405
|
* slots (e.g. `recordingsLow` → `recordings`) so operators only need to
|
|
@@ -19014,8 +19228,10 @@ var TrackSchema = object({
|
|
|
19014
19228
|
lastSeen: number(),
|
|
19015
19229
|
/** Frame-rate position history (subject to maxPositionHistory cap). */
|
|
19016
19230
|
positions: array(TrackPositionSchema).readonly(),
|
|
19017
|
-
/** Periodic snapshots at snapshotIntervalMs cadence
|
|
19018
|
-
*
|
|
19231
|
+
/** Periodic snapshots at snapshotIntervalMs cadence — DEBUG media, produced
|
|
19232
|
+
* only while `MediaSettings.debugMediaEnabled` is on for the camera (D299;
|
|
19233
|
+
* the retired `saveThumbnails` used to gate this and the rolling
|
|
19234
|
+
* `lastFrame` together). Empty is the healthy default, not a capture gap. */
|
|
19019
19235
|
snapshots: array(TrackSnapshotSchema).readonly(),
|
|
19020
19236
|
/** Deduplicated zones the track has entered at least once. Zone IDS. */
|
|
19021
19237
|
zonesVisited: array(string()).readonly(),
|
|
@@ -19875,7 +20091,10 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
|
|
|
19875
20091
|
}), method(RelocateMediaInputSchema, object({ jobId: string() }), {
|
|
19876
20092
|
kind: "mutation",
|
|
19877
20093
|
auth: "admin"
|
|
19878
|
-
}), method(object({}), UnstampedEventMediaCountSchema, { auth: "admin" }), method(
|
|
20094
|
+
}), method(object({}), UnstampedEventMediaCountSchema, { auth: "admin" }), method(RelocatableMediaCountInputSchema, RelocatableMediaCountSchema, {
|
|
20095
|
+
kind: "query",
|
|
20096
|
+
auth: "admin"
|
|
20097
|
+
}), method(object({}), array(RelocateJobSchema).readonly(), {
|
|
19879
20098
|
kind: "query",
|
|
19880
20099
|
auth: "admin"
|
|
19881
20100
|
}), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
|
|
@@ -22315,6 +22534,9 @@ method(StorageMigrationInputSchema, StorageMigrationPlanSchema, { auth: "admin"
|
|
|
22315
22534
|
}), method(object({ jobId: string().optional() }), StorageMigrationJobSchema.nullable(), { auth: "admin" }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
|
|
22316
22535
|
kind: "mutation",
|
|
22317
22536
|
auth: "admin"
|
|
22537
|
+
}), method(object({}), array(StorageMigrationMoverSchema).readonly(), { auth: "admin" }), method(object({}), array(StorageMigrationResidueSchema).readonly(), { auth: "admin" }), method(StorageMigrationDrainInputSchema, object({ jobId: string() }), {
|
|
22538
|
+
kind: "mutation",
|
|
22539
|
+
auth: "admin"
|
|
22318
22540
|
});
|
|
22319
22541
|
var ProviderInfoSchema = discriminatedUnion("shouldSaveDiskSpace", [object({
|
|
22320
22542
|
providerId: string().min(1),
|
|
@@ -22713,12 +22935,38 @@ response: record(string(), unknown()) }), object({
|
|
|
22713
22935
|
*
|
|
22714
22936
|
* ## Why this is a capability and not a helper
|
|
22715
22937
|
*
|
|
22716
|
-
*
|
|
22717
|
-
*
|
|
22718
|
-
*
|
|
22719
|
-
*
|
|
22720
|
-
*
|
|
22721
|
-
*
|
|
22938
|
+
* This capability was introduced with the claim that SIX stores in
|
|
22939
|
+
* `addon-post-analysis` held vectors in a `JSON` settings-store column — object
|
|
22940
|
+
* CLIP, face, plate, vehicle, identity, and the event store's derivatives. That
|
|
22941
|
+
* claim was never true, and leaving it here made five stores look like pending
|
|
22942
|
+
* work when three of them have no vector at all. Counted column by column on
|
|
22943
|
+
* 2026-08-30, exactly THREE ever held one:
|
|
22944
|
+
*
|
|
22945
|
+
* - `object-clip` — 512-dim CLIP image embedding, migrated 2026-08-06.
|
|
22946
|
+
* - `faces.embedding` — 512-dim ArcFace face embedding, migrated 2026-08-30.
|
|
22947
|
+
* - `identity-samples.embedding` — the same ArcFace vector for an ENROLLED
|
|
22948
|
+
* face, migrated 2026-08-30 into its OWN index (see below).
|
|
22949
|
+
*
|
|
22950
|
+
* `plates` and `vehicle-samples` store a plate STRING and a score; `vehicles`
|
|
22951
|
+
* and `identities` store a name; the event store stores no derivative vector.
|
|
22952
|
+
* They are not migration candidates and never were.
|
|
22953
|
+
*
|
|
22954
|
+
* Measured on the live hub the JSON encoding cost ~11.7 KB per row (512 floats
|
|
22955
|
+
* as TEXT, `JSON.parse`d on every search) and made semantic search load 5,000
|
|
22956
|
+
* rows before ranking anything.
|
|
22957
|
+
*
|
|
22958
|
+
* ## One index per COMPARISON, never per encoder
|
|
22959
|
+
*
|
|
22960
|
+
* `faces` and `identity-samples` hold the same 512 ArcFace dims from the same
|
|
22961
|
+
* model, and they still get two indexes. An index is a set of things that are
|
|
22962
|
+
* ranked against each other and that live and die together, and these two are
|
|
22963
|
+
* neither: a `faces` row is TRACK-OWNED and cascades away with its track under
|
|
22964
|
+
* a per-camera capacity cap, an `identity-samples` row is retention-EXEMPT
|
|
22965
|
+
* forever and is the gallery every recognition ranks against. One index would
|
|
22966
|
+
* mean every gallery load and every reconcile carried a filter whose failure
|
|
22967
|
+
* mode is either ranking a candidate against itself or reclaiming an enrolled
|
|
22968
|
+
* person's only sample. The dimension they share is not a reason to share an
|
|
22969
|
+
* index; the question they answer is, and it differs.
|
|
22722
22970
|
*
|
|
22723
22971
|
* The fix is not a faster loop, it is a different backend — and the backend
|
|
22724
22972
|
* should be replaceable without touching six callers. So: a singleton
|
|
@@ -22823,7 +23071,20 @@ var VectorQueryResultSchema = object({
|
|
|
22823
23071
|
*/
|
|
22824
23072
|
scanned: number(),
|
|
22825
23073
|
/** True when the backend could not consider every row that passed the filter. */
|
|
22826
|
-
truncated: boolean()
|
|
23074
|
+
truncated: boolean(),
|
|
23075
|
+
/**
|
|
23076
|
+
* The `topK` the backend actually ran with.
|
|
23077
|
+
*
|
|
23078
|
+
* Every backend has a ceiling — sqlite-vec's is 4,096 — and a caller asking
|
|
23079
|
+
* past it used to learn nothing but a boolean, from a WARN in the provider's
|
|
23080
|
+
* own log rather than in its answer. That is how an audit asking for 20,000
|
|
23081
|
+
* consumed 4,096 and reported `examined: 4096` as if it had walked the index,
|
|
23082
|
+
* for weeks. `truncated` says THAT the answer was short; this says BY HOW
|
|
23083
|
+
* MUCH, in the return value, where the caller cannot fail to see it.
|
|
23084
|
+
*
|
|
23085
|
+
* Equals the requested `topK` whenever nothing was lowered.
|
|
23086
|
+
*/
|
|
23087
|
+
effectiveTopK: number().int().positive()
|
|
22827
23088
|
});
|
|
22828
23089
|
var VectorDeleteInputSchema = object({
|
|
22829
23090
|
index: string(),
|
|
@@ -22852,6 +23113,68 @@ var VectorGetResultSchema = object({ items: array(object({
|
|
|
22852
23113
|
id: string(),
|
|
22853
23114
|
metadata: VectorMetadataSchema
|
|
22854
23115
|
})) });
|
|
23116
|
+
/**
|
|
23117
|
+
* Ids to read back WITH their vectors.
|
|
23118
|
+
*
|
|
23119
|
+
* The sibling of {@link VectorGetResultSchema}, and deliberately a separate
|
|
23120
|
+
* method rather than a flag on it: `getByIds` promises no vectors and its one
|
|
23121
|
+
* caller depends on that promise. This one promises the opposite.
|
|
23122
|
+
*
|
|
23123
|
+
* It exists because a store cannot put its vectors here otherwise. An ArcFace
|
|
23124
|
+
* gallery is ranked IN PROCESS, per detection, against every enrolled sample —
|
|
23125
|
+
* a per-face cross-process KNN would be a network round trip inside the
|
|
23126
|
+
* recognition loop. So the gallery is loaded once and held in RAM, and loading
|
|
23127
|
+
* it requires the index to hand the floats back. Without this method the only
|
|
23128
|
+
* way to keep a readable vector is a JSON column, which is the thing this
|
|
23129
|
+
* capability exists to delete.
|
|
23130
|
+
*
|
|
23131
|
+
* BOUNDED BY THE CALLER: ids are named, never "everything". Enumerating an
|
|
23132
|
+
* index is {@link VectorScanInputSchema}'s job, and it returns no vectors.
|
|
23133
|
+
*/
|
|
23134
|
+
var VectorFetchInputSchema = object({
|
|
23135
|
+
index: string(),
|
|
23136
|
+
ids: array(string())
|
|
23137
|
+
});
|
|
23138
|
+
var VectorFetchResultSchema = object({ items: array(object({
|
|
23139
|
+
id: string(),
|
|
23140
|
+
/** base64 Float32LE — the same wire form `upsert` accepts. */
|
|
23141
|
+
vector: string(),
|
|
23142
|
+
metadata: VectorMetadataSchema
|
|
23143
|
+
})) });
|
|
23144
|
+
/**
|
|
23145
|
+
* ENUMERATE an index: one page of rows in a stable order, no ranking.
|
|
23146
|
+
*
|
|
23147
|
+
* A reconcile does not want the nearest rows, it wants ALL of them, and asking
|
|
23148
|
+
* a KNN for "all" is the wrong question twice over. It hits the backend's `k`
|
|
23149
|
+
* ceiling — 4,096 on sqlite-vec against a 22,128-row index — and it needs a
|
|
23150
|
+
* probe vector it does not have, so the audit passed a ZERO vector whose cosine
|
|
23151
|
+
* distance to every row is degenerate. `examined: 4096` then read as "we
|
|
23152
|
+
* looked" for as long as anyone cared to read it.
|
|
23153
|
+
*
|
|
23154
|
+
* This is the primitive that question actually needs: a bounded page, ordered
|
|
23155
|
+
* by the backend's own row order, costing no distance computation at all.
|
|
23156
|
+
* Vectors are NOT returned — an enumeration that shipped 2 KB per row would be
|
|
23157
|
+
* the full-table read this capability was built to stop.
|
|
23158
|
+
*/
|
|
23159
|
+
var VectorScanInputSchema = object({
|
|
23160
|
+
index: string(),
|
|
23161
|
+
/** Opaque resume point. `0` starts at the top; pass back `nextCursor`. */
|
|
23162
|
+
cursor: number().int().nonnegative().default(0),
|
|
23163
|
+
limit: number().int().positive()
|
|
23164
|
+
});
|
|
23165
|
+
var VectorScanResultSchema = object({
|
|
23166
|
+
items: array(object({
|
|
23167
|
+
id: string(),
|
|
23168
|
+
metadata: VectorMetadataSchema
|
|
23169
|
+
})),
|
|
23170
|
+
/**
|
|
23171
|
+
* Where the next page starts, or `null` when the walk reached the end.
|
|
23172
|
+
*
|
|
23173
|
+
* `null` is the ONLY end-of-index signal. A caller must not infer the end
|
|
23174
|
+
* from a short page: a backend is free to return fewer rows than asked.
|
|
23175
|
+
*/
|
|
23176
|
+
nextCursor: number().int().nonnegative().nullable()
|
|
23177
|
+
});
|
|
22855
23178
|
var VectorStatsInputSchema = object({ index: string() });
|
|
22856
23179
|
var VectorStatsResultSchema = object({
|
|
22857
23180
|
/** Provider id, so an operator can tell brute force from an ANN index. */
|
|
@@ -22870,7 +23193,7 @@ method(VectorDeclareIndexInputSchema, _void(), {
|
|
|
22870
23193
|
}), method(VectorUpsertInputSchema, VectorUpsertResultSchema, {
|
|
22871
23194
|
kind: "mutation",
|
|
22872
23195
|
auth: "admin"
|
|
22873
|
-
}), method(VectorQueryInputSchema, VectorQueryResultSchema, { auth: "admin" }), method(VectorGetInputSchema, VectorGetResultSchema, { auth: "admin" }), method(VectorDeleteInputSchema, VectorDeleteResultSchema, {
|
|
23196
|
+
}), method(VectorQueryInputSchema, VectorQueryResultSchema, { auth: "admin" }), method(VectorGetInputSchema, VectorGetResultSchema, { auth: "admin" }), method(VectorFetchInputSchema, VectorFetchResultSchema, { auth: "admin" }), method(VectorScanInputSchema, VectorScanResultSchema, { auth: "admin" }), method(VectorDeleteInputSchema, VectorDeleteResultSchema, {
|
|
22874
23197
|
kind: "mutation",
|
|
22875
23198
|
auth: "admin"
|
|
22876
23199
|
}), method(VectorDeleteByFilterInputSchema, VectorDeleteResultSchema, {
|
|
@@ -27774,6 +28097,9 @@ method(object({
|
|
|
27774
28097
|
}), method(object({}), array(RelocateJobSchema).readonly(), {
|
|
27775
28098
|
kind: "query",
|
|
27776
28099
|
auth: "admin"
|
|
28100
|
+
}), method(RelocateResidueInputSchema, RelocateResidueSchema, {
|
|
28101
|
+
kind: "query",
|
|
28102
|
+
auth: "admin"
|
|
27777
28103
|
}), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
|
|
27778
28104
|
kind: "mutation",
|
|
27779
28105
|
auth: "admin"
|
|
@@ -32823,6 +33149,12 @@ Object.freeze({
|
|
|
32823
33149
|
addonId: null,
|
|
32824
33150
|
access: "create"
|
|
32825
33151
|
},
|
|
33152
|
+
"pipelineAnalytics.countRelocatableMedia": {
|
|
33153
|
+
capName: "pipeline-analytics",
|
|
33154
|
+
capScope: "device",
|
|
33155
|
+
addonId: null,
|
|
33156
|
+
access: "view"
|
|
33157
|
+
},
|
|
32826
33158
|
"pipelineAnalytics.countUnstampedEventMedia": {
|
|
32827
33159
|
capName: "pipeline-analytics",
|
|
32828
33160
|
capScope: "device",
|
|
@@ -33987,6 +34319,12 @@ Object.freeze({
|
|
|
33987
34319
|
addonId: null,
|
|
33988
34320
|
access: "view"
|
|
33989
34321
|
},
|
|
34322
|
+
"recording.getRelocateResidue": {
|
|
34323
|
+
capName: "recording",
|
|
34324
|
+
capScope: "system",
|
|
34325
|
+
addonId: null,
|
|
34326
|
+
access: "view"
|
|
34327
|
+
},
|
|
33990
34328
|
"recording.getStorageMigrationMoveStatus": {
|
|
33991
34329
|
capName: "recording",
|
|
33992
34330
|
capScope: "system",
|
|
@@ -34533,12 +34871,30 @@ Object.freeze({
|
|
|
34533
34871
|
addonId: null,
|
|
34534
34872
|
access: "create"
|
|
34535
34873
|
},
|
|
34874
|
+
"storageMigration.drain": {
|
|
34875
|
+
capName: "storage-migration",
|
|
34876
|
+
capScope: "system",
|
|
34877
|
+
addonId: null,
|
|
34878
|
+
access: "create"
|
|
34879
|
+
},
|
|
34880
|
+
"storageMigration.movers": {
|
|
34881
|
+
capName: "storage-migration",
|
|
34882
|
+
capScope: "system",
|
|
34883
|
+
addonId: null,
|
|
34884
|
+
access: "view"
|
|
34885
|
+
},
|
|
34536
34886
|
"storageMigration.plan": {
|
|
34537
34887
|
capName: "storage-migration",
|
|
34538
34888
|
capScope: "system",
|
|
34539
34889
|
addonId: null,
|
|
34540
34890
|
access: "view"
|
|
34541
34891
|
},
|
|
34892
|
+
"storageMigration.residue": {
|
|
34893
|
+
capName: "storage-migration",
|
|
34894
|
+
capScope: "system",
|
|
34895
|
+
addonId: null,
|
|
34896
|
+
access: "view"
|
|
34897
|
+
},
|
|
34542
34898
|
"storageMigration.start": {
|
|
34543
34899
|
capName: "storage-migration",
|
|
34544
34900
|
capScope: "system",
|
|
@@ -35373,6 +35729,12 @@ Object.freeze({
|
|
|
35373
35729
|
addonId: null,
|
|
35374
35730
|
access: "delete"
|
|
35375
35731
|
},
|
|
35732
|
+
"vectorStore.fetchByIds": {
|
|
35733
|
+
capName: "vector-store",
|
|
35734
|
+
capScope: "system",
|
|
35735
|
+
addonId: null,
|
|
35736
|
+
access: "view"
|
|
35737
|
+
},
|
|
35376
35738
|
"vectorStore.getByIds": {
|
|
35377
35739
|
capName: "vector-store",
|
|
35378
35740
|
capScope: "system",
|
|
@@ -35385,6 +35747,12 @@ Object.freeze({
|
|
|
35385
35747
|
addonId: null,
|
|
35386
35748
|
access: "view"
|
|
35387
35749
|
},
|
|
35750
|
+
"vectorStore.scan": {
|
|
35751
|
+
capName: "vector-store",
|
|
35752
|
+
capScope: "system",
|
|
35753
|
+
addonId: null,
|
|
35754
|
+
access: "view"
|
|
35755
|
+
},
|
|
35388
35756
|
"vectorStore.stats": {
|
|
35389
35757
|
capName: "vector-store",
|
|
35390
35758
|
capScope: "system",
|
package/dist/remoteEntry.js
CHANGED
|
@@ -30,7 +30,7 @@ async function d(e) {
|
|
|
30
30
|
}
|
|
31
31
|
}
|
|
32
32
|
async function f() {
|
|
33
|
-
return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_orchestrator_widgets-
|
|
33
|
+
return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_orchestrator_widgets-CXhvoqSz.mjs")).catch((e) => {
|
|
34
34
|
throw l = void 0, e;
|
|
35
35
|
}), l;
|
|
36
36
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@camstack/addon-pipeline-orchestrator",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.126",
|
|
4
4
|
"description": "Hub-side camera-to-agent load balancer — tracks runner capacity and dispatches attachCamera calls to the optimal pipeline-runner instance",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"camstack",
|