@camstack/addon-remote-storage 1.2.26 → 1.2.28

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.
@@ -5825,6 +5825,13 @@ var BaseAddon = class {
5825
5825
  _readinessGeneration = typeof crypto !== "undefined" && crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36).slice(2, 14);
5826
5826
  /** Capability names this addon registered at init — used to emit matching `down` events on shutdown. */
5827
5827
  _registeredCapNames = [];
5828
+ /**
5829
+ * True only after `readAddonStore` actually answered. Constructor
5830
+ * defaults look like stored config when the store is down — a forked
5831
+ * addon that auto-starts from those defaults (cloudflare-tunnel quick
5832
+ * mode, 2026-08-25) is not "the operator chose this".
5833
+ */
5834
+ settingsStoreReady = false;
5828
5835
  /** Default config values. Provided via constructor. */
5829
5836
  defaults;
5830
5837
  constructor(defaults) {
@@ -6225,7 +6232,9 @@ var BaseAddon = class {
6225
6232
  ];
6226
6233
  let lastErr;
6227
6234
  for (let attempt = 0; attempt <= delaysMs.length; attempt++) try {
6228
- return await settings.readAddonStore() ?? {};
6235
+ const stored = await settings.readAddonStore() ?? {};
6236
+ this.settingsStoreReady = true;
6237
+ return stored;
6229
6238
  } catch (err) {
6230
6239
  lastErr = err;
6231
6240
  const msg = err instanceof Error ? err.message : String(err);
@@ -6233,6 +6242,7 @@ var BaseAddon = class {
6233
6242
  if (attempt === delaysMs.length) break;
6234
6243
  await new Promise((r) => setTimeout(r, delaysMs[attempt]));
6235
6244
  }
6245
+ this.settingsStoreReady = false;
6236
6246
  this._ctx?.logger?.warn?.("readAddonStore: settings-store unavailable after retries — using defaults", { meta: { error: lastErr instanceof Error ? lastErr.message : String(lastErr) } });
6237
6247
  return {};
6238
6248
  }
@@ -6644,7 +6654,7 @@ function method(input, output, options) {
6644
6654
  input,
6645
6655
  output,
6646
6656
  kind: options?.kind ?? "query",
6647
- auth: options?.auth ?? "protected",
6657
+ ...options?.auth !== void 0 ? { auth: options.auth } : {},
6648
6658
  ...options?.access !== void 0 ? { access: options.access } : {},
6649
6659
  ...options?.caller !== void 0 ? { caller: options.caller } : {},
6650
6660
  timeoutMs: options?.timeoutMs
@@ -6664,7 +6674,7 @@ function systemMethod(input, output, options) {
6664
6674
  }
6665
6675
  var StaticDirOutputSchema$1 = object({ staticDir: string() });
6666
6676
  var VersionOutputSchema$1 = object({ version: string() });
6667
- method(_void(), StaticDirOutputSchema$1), method(_void(), VersionOutputSchema$1);
6677
+ method(_void(), StaticDirOutputSchema$1, { auth: "admin" }), method(_void(), VersionOutputSchema$1, { auth: "admin" });
6668
6678
  var DeviceType = /* @__PURE__ */ function(DeviceType) {
6669
6679
  DeviceType["Camera"] = "camera";
6670
6680
  DeviceType["Hub"] = "hub";
@@ -6985,7 +6995,7 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
6985
6995
  }({});
6986
6996
  var StaticDirOutputSchema = object({ staticDir: string() });
6987
6997
  var VersionOutputSchema = object({ version: string() });
6988
- method(_void(), StaticDirOutputSchema), method(_void(), VersionOutputSchema);
6998
+ method(_void(), StaticDirOutputSchema, { auth: "admin" }), method(_void(), VersionOutputSchema, { auth: "admin" });
6989
6999
  /**
6990
7000
  * device-ops — device-scoped cap that unifies the per-IDevice operations
6991
7001
  * previously routed through the `.device-ops` Moleculer bridge service.
@@ -7599,24 +7609,6 @@ var RecordingRetentionSchema = object({
7599
7609
  maxSizeGb: number().min(0).optional()
7600
7610
  });
7601
7611
  /**
7602
- * Scrub-thumbnail fidelity preset — the single per-camera selector bundling the
7603
- * sprite tile RESOLUTION + JPEG QUALITY the recorder packs timeline-scrub
7604
- * previews at. Five graduated steps; absent on a config = `standard` (the
7605
- * shipped default, matching `sheet-geometry`/`sheet-composer`).
7606
- *
7607
- * Existing sheets are IMMUTABLE — a changed preset applies to NEW windows only.
7608
- * Each window's index sidecar carries its own tile dims, so a camera whose
7609
- * preset changed over time renders every historical window at the dims it was
7610
- * written with.
7611
- */
7612
- var ScrubThumbnailPresetSchema = _enum([
7613
- "minimal",
7614
- "low",
7615
- "standard",
7616
- "high",
7617
- "max"
7618
- ]);
7619
- /**
7620
7612
  * The full per-camera recording intent — the wire shape of a RecordingTarget.
7621
7613
  *
7622
7614
  * `bands` is the ONLY authored recording intent: what to record, when, and on
@@ -7624,7 +7616,11 @@ var ScrubThumbnailPresetSchema = _enum([
7624
7616
  * other field is a storage knob (profiles, segment length, retention, scrub).
7625
7617
  *
7626
7618
  * STRICT on purpose: the legacy authoring surface (`schedule`/`schedules`/
7627
- * `triggers`/`preBufferSec`/`postBufferSec`/`rules`) was retired 2026-07-30.
7619
+ * `triggers`/`preBufferSec`/`postBufferSec`/`rules`) was retired 2026-07-30,
7620
+ * and `scrubThumbnails` — a five-step fidelity knob for a sprite tier that was
7621
+ * deleted on 2026-07-24 and had ZERO consumers in the recorder — on 2026-08-25
7622
+ * (D62: a switch that writes a store nobody reads is worse than no switch).
7623
+ * Stored rows keep loading: the READ schema is `.strip()` (config-store.ts).
7628
7624
  * A stale caller must fail loudly — silently stripping its legacy intent would
7629
7625
  * persist a band-less config, i.e. silently stop recording the camera.
7630
7626
  */
@@ -7647,14 +7643,7 @@ var RecordingConfigSchema = object({
7647
7643
  * "off" is the absence of a covering band, never a band value.
7648
7644
  */
7649
7645
  bands: array(RecordingBandSchema).default([]),
7650
- retention: RecordingRetentionSchema.optional(),
7651
- /**
7652
- * Per-camera scrub-thumbnail fidelity preset (resolution + JPEG quality for
7653
- * timeline-scrub sprite previews). Absent = `standard`. Applies to NEW
7654
- * windows only — existing sheets are immutable, and each window's index
7655
- * carries its own tile dims so mixed-preset history renders correctly.
7656
- */
7657
- scrubThumbnails: ScrubThumbnailPresetSchema.optional()
7646
+ retention: RecordingRetentionSchema.optional()
7658
7647
  }).strict();
7659
7648
  /**
7660
7649
  * Entity-relocation job state (storage entity-routing spec, Phase 4).
@@ -7730,10 +7719,11 @@ var RelocateFootageInputSchema = object({
7730
7719
  * `RecordingConfig.enabled` or camera wrapper bindings. */
7731
7720
  var StorageMigrationLeaseInputSchema = object({ leaseId: string().min(1) });
7732
7721
  var StorageMigrationFootageMoveInputSchema = RelocateFootageInputSchema.extend({ leaseId: string().min(1) });
7733
- var StorageMigrationMediaMoveInputSchema = object({
7722
+ var RelocateMediaInputSchema = object({
7734
7723
  toLocationId: string(),
7735
7724
  throttleMbps: number().min(1).max(1e3).optional()
7736
- }).extend({ leaseId: string().min(1) });
7725
+ });
7726
+ var StorageMigrationMediaMoveInputSchema = RelocateMediaInputSchema.extend({ leaseId: string().min(1) });
7737
7727
  /** The independently selectable logical storage classes. `recordings`
7738
7728
  * encompasses the high and mid segment profiles; `recordingsLow` is low
7739
7729
  * segments; `eventMedia` is post-analysis blobs. */
@@ -8028,7 +8018,26 @@ var LabelDefinitionSchema = object({
8028
8018
  description: string().optional(),
8029
8019
  icon: string().optional()
8030
8020
  });
8031
- var ClassMapDefinitionSchema = object({
8021
+ /**
8022
+ * Wire schema for a per-model CATALOG classMap override
8023
+ * (`ModelCatalogEntry.classMap` / `ModelConvertMetadata.classMap`) —
8024
+ * restricted to {@link CLASS_MAP_MACRO_TARGETS}, the only macros the
8025
+ * detection pipeline executor actually routes.
8026
+ *
8027
+ * This is deliberately a DIFFERENT, narrower shape than the general-purpose
8028
+ * `ClassMapDefinition` interface above (e.g. `IDetectionAddon.getClassMap()`
8029
+ * and the audio `YAMNET_TO_MACRO` catalog both use macro targets outside this
8030
+ * enum) — the two used to share the name `ClassMapDefinition`/
8031
+ * `ClassMapDefinitionSchema`, which made the schema-type-twin guard
8032
+ * (`scripts/check-schema-type-twins.ts`) flag them as a duplicated shape. They
8033
+ * are not: it is two different concepts colliding on a name. Keep this type
8034
+ * under its own name rather than reusing `ClassMapDefinition` — reusing it
8035
+ * would either narrow every `ClassMapDefinition` consumer to the four
8036
+ * detection macros (breaking `YAMNET_TO_MACRO`) or drop the validation this
8037
+ * schema exists for (see the "rejects a classMap whose target is not a
8038
+ * detection macro" test in `model-catalog-schema.test.ts`).
8039
+ */
8040
+ var DetectionCatalogClassMapSchema = object({
8032
8041
  mapping: record(string(), _enum([
8033
8042
  "person",
8034
8043
  "vehicle",
@@ -8120,6 +8129,12 @@ var ModelVariantGroupSchema = object({
8120
8129
  */
8121
8130
  resolution: number().int().positive().optional()
8122
8131
  });
8132
+ var ModelProviderIdSchema = _enum([
8133
+ "camstack",
8134
+ "frigate",
8135
+ "scrypted",
8136
+ "custom"
8137
+ ]);
8123
8138
  var ModelCatalogEntrySchema = object({
8124
8139
  id: string(),
8125
8140
  name: string(),
@@ -8217,11 +8232,17 @@ var ModelCatalogEntrySchema = object({
8217
8232
  */
8218
8233
  group: ModelVariantGroupSchema.optional(),
8219
8234
  /**
8235
+ * Catalog source for the pipeline stepper's provider-first picker. Absent on
8236
+ * built-in CamStack entries (treated as `camstack`) and on registry rows
8237
+ * persisted before this field existed (`inferModelProvider` fills those).
8238
+ */
8239
+ provider: ModelProviderIdSchema.optional(),
8240
+ /**
8220
8241
  * Per-MODEL class map override. Absent ⇒ the step's `StepDefinition.classMap`
8221
8242
  * applies (Frigate / COCO public catalog). Set on a custom model whose raw
8222
8243
  * labels already ARE the CamStack macros (Scrypted identity map).
8223
8244
  */
8224
- classMap: ClassMapDefinitionSchema.optional()
8245
+ classMap: DetectionCatalogClassMapSchema.optional()
8225
8246
  });
8226
8247
  var ConvertTargetSchema = discriminatedUnion("format", [object({
8227
8248
  format: literal("openvino"),
@@ -8251,7 +8272,7 @@ var ModelConvertMetadataSchema = object({
8251
8272
  "segmentation"
8252
8273
  ]),
8253
8274
  faceAlignment: boolean().optional(),
8254
- classMap: ClassMapDefinitionSchema.optional()
8275
+ classMap: DetectionCatalogClassMapSchema.optional()
8255
8276
  });
8256
8277
  var ConvertResultSchema = object({
8257
8278
  entry: ModelCatalogEntrySchema,
@@ -9114,7 +9135,7 @@ var AddonPageDeclarationSchema = object({
9114
9135
  /** Display label for a CUSTOM `section` id (ignored for well-known ids). */
9115
9136
  sectionLabel: string().optional()
9116
9137
  });
9117
- method(_void(), array(AddonPageDeclarationSchema).readonly());
9138
+ method(_void(), array(AddonPageDeclarationSchema).readonly(), { auth: "admin" });
9118
9139
  var AddonHttpRouteSchema = object({
9119
9140
  method: _enum([
9120
9141
  "GET",
@@ -9349,7 +9370,7 @@ var WidgetMetadataSchema = object({
9349
9370
  defaultColumns: number().int().min(1).max(12).default(6),
9350
9371
  defaultRows: number().int().min(1).max(12).default(1)
9351
9372
  });
9352
- method(_void(), array(WidgetMetadataSchema).readonly());
9373
+ method(_void(), array(WidgetMetadataSchema).readonly(), { auth: "admin" });
9353
9374
  /**
9354
9375
  * `addon-widgets` — system-scoped singleton aggregator cap. Public-facing
9355
9376
  * surface that admin-ui consumes through `useAddonWidgetsListWidgets()`.
@@ -10871,7 +10892,7 @@ var CustomModelDescriptorSchema = object({
10871
10892
  stepId: string(),
10872
10893
  entry: ModelCatalogEntrySchema
10873
10894
  });
10874
- method(_void(), array(CustomModelDescriptorSchema).readonly());
10895
+ method(_void(), array(CustomModelDescriptorSchema).readonly(), { auth: "admin" });
10875
10896
  /**
10876
10897
  * Query filter for settings-store collections.
10877
10898
  */
@@ -10958,7 +10979,8 @@ method(object({
10958
10979
  }), _void(), { kind: "mutation" }), method(object({
10959
10980
  namespace: string().optional(),
10960
10981
  collection: string(),
10961
- filter: QueryFilterSchema.optional()
10982
+ filter: QueryFilterSchema.optional(),
10983
+ columns: array(string()).readonly().optional()
10962
10984
  }), array(SettingsRecordSchema).readonly()), method(object({
10963
10985
  namespace: string().optional(),
10964
10986
  collection: string(),
@@ -11021,46 +11043,87 @@ var EngineInfoSchema = object({
11021
11043
  kind: _enum(["relational", "vector"]),
11022
11044
  displayName: string()
11023
11045
  });
11024
- method(_void(), EngineInfoSchema), method(object({
11046
+ method(_void(), EngineInfoSchema, { auth: "admin" }), method(object({
11025
11047
  namespace: string().optional(),
11026
11048
  collection: string(),
11027
11049
  key: string()
11028
- }), unknown()), method(object({
11050
+ }), unknown(), { auth: "admin" }), method(object({
11029
11051
  namespace: string().optional(),
11030
11052
  collection: string(),
11031
11053
  key: string(),
11032
11054
  value: unknown()
11033
- }), _void(), { kind: "mutation" }), method(object({
11055
+ }), _void(), {
11056
+ kind: "mutation",
11057
+ auth: "admin"
11058
+ }), method(object({
11034
11059
  namespace: string().optional(),
11035
11060
  collection: string(),
11036
- filter: QueryFilterSchema.optional()
11037
- }), array(SettingsRecordSchema).readonly()), method(object({
11061
+ filter: QueryFilterSchema.optional(),
11062
+ /**
11063
+ * SQL-level column projection — MUST mirror `settings-store.query`.
11064
+ *
11065
+ * ⚠ An earlier version of this comment blamed Zod stripping, and that
11066
+ * was wrong — corrected 2026-08-26 after the hop map
11067
+ * (`docs/design/2026-08-26-mappa-hop-argomenti.md`) traced the path.
11068
+ * There is **no Zod parse at all** between the door and the engine: the
11069
+ * dispatcher forwards the payload verbatim and UDS carries it whole. A
11070
+ * field declared here reaches `SqliteSettingsBackend` either way.
11071
+ *
11072
+ * What actually lost `columns` was the THIRD declaration of this shape:
11073
+ * `SettingsQueryInput` in `interfaces/storage.ts`, a hand-written TS
11074
+ * interface the engine destructures from. The field existed on both
11075
+ * schemas and the engine still never read it, because nothing checks a
11076
+ * registered provider against `InferProvider<cap>` —
11077
+ * `ProviderRegistration.provider` is typed `object`.
11078
+ *
11079
+ * It is declared here anyway, and must stay in step with
11080
+ * `settings-store.query`: a caller reading only the cap definitions has
11081
+ * to be able to see that this call carries a projection.
11082
+ * `data-door-schema-parity.spec.ts` keeps the two aligned.
11083
+ */
11084
+ columns: array(string()).readonly().optional()
11085
+ }), array(SettingsRecordSchema).readonly(), { auth: "admin" }), method(object({
11038
11086
  namespace: string().optional(),
11039
11087
  collection: string(),
11040
11088
  record: SettingsRecordSchema
11041
- }), _void(), { kind: "mutation" }), method(object({
11089
+ }), _void(), {
11090
+ kind: "mutation",
11091
+ auth: "admin"
11092
+ }), method(object({
11042
11093
  namespace: string().optional(),
11043
11094
  collection: string(),
11044
11095
  id: string(),
11045
11096
  data: record(string(), unknown())
11046
- }), _void(), { kind: "mutation" }), method(object({
11097
+ }), _void(), {
11098
+ kind: "mutation",
11099
+ auth: "admin"
11100
+ }), method(object({
11047
11101
  namespace: string().optional(),
11048
11102
  collection: string(),
11049
11103
  key: string()
11050
- }), _void(), { kind: "mutation" }), method(object({
11104
+ }), _void(), {
11105
+ kind: "mutation",
11106
+ auth: "admin"
11107
+ }), method(object({
11051
11108
  namespace: string().optional(),
11052
11109
  collection: string(),
11053
11110
  filter: MutationFilterSchema
11054
- }), object({ deleted: number().int() }), { kind: "mutation" }), method(object({
11111
+ }), object({ deleted: number().int() }), {
11112
+ kind: "mutation",
11113
+ auth: "admin"
11114
+ }), method(object({
11055
11115
  namespace: string().optional(),
11056
11116
  collection: string(),
11057
11117
  filter: MutationFilterSchema,
11058
11118
  data: record(string(), unknown())
11059
- }), object({ updated: number().int() }), { kind: "mutation" }), method(object({
11119
+ }), object({ updated: number().int() }), {
11120
+ kind: "mutation",
11121
+ auth: "admin"
11122
+ }), method(object({
11060
11123
  namespace: string().optional(),
11061
11124
  collection: string(),
11062
11125
  filter: QueryFilterSchema.optional()
11063
- }), number()), method(object({
11126
+ }), number(), { auth: "admin" }), method(object({
11064
11127
  namespace: string().optional(),
11065
11128
  collection: string(),
11066
11129
  field: string(),
@@ -11070,15 +11133,18 @@ method(_void(), EngineInfoSchema), method(object({
11070
11133
  }), array(object({
11071
11134
  bucket: number().int(),
11072
11135
  count: number().int()
11073
- })).readonly()), method(object({
11136
+ })).readonly(), { auth: "admin" }), method(object({
11074
11137
  namespace: string().optional(),
11075
11138
  collection: string()
11076
- }), boolean()), method(object({
11139
+ }), boolean(), { auth: "admin" }), method(object({
11077
11140
  namespace: string().optional(),
11078
11141
  collection: string(),
11079
11142
  columns: array(CollectionColumnSchema).readonly(),
11080
11143
  indexes: array(CollectionIndexSchema).readonly().optional()
11081
- }), _void(), { kind: "mutation" });
11144
+ }), _void(), {
11145
+ kind: "mutation",
11146
+ auth: "admin"
11147
+ });
11082
11148
  /**
11083
11149
  * shm ring usage stats for a `frameSink: 'shm'` decoder session —
11084
11150
  * exposed via `decoder.getShmStats` so downstream consumers can
@@ -11744,6 +11810,27 @@ var LinkedDeviceSchema = object({
11744
11810
  features: array(string()),
11745
11811
  producesTrackedEvents: boolean().optional()
11746
11812
  });
11813
+ /** One camera's resolved linked set, tagged with the camera it belongs to.
11814
+ * The batch answer needs the tag; the single-device answer already has it
11815
+ * from the input, which is why `getLinkedDevices` keeps the untagged shape. */
11816
+ var LinkedDevicesForDeviceSchema = object({
11817
+ deviceId: number(),
11818
+ mode: LinkedDevicesModeSchema,
11819
+ devices: array(LinkedDeviceSchema)
11820
+ });
11821
+ /** One device's binding map — the shape `getBindings`, `getBindingsBatch` and
11822
+ * `getAllBindings` all answer in. Declared once: three copies of the same
11823
+ * object literal is exactly how the three drift apart. */
11824
+ var DeviceBindingsForDeviceSchema = object({
11825
+ deviceId: number(),
11826
+ entries: array(object({
11827
+ capName: string(),
11828
+ kind: _enum(["native", "wrapped"]),
11829
+ providerAddonId: string(),
11830
+ providerNodeId: string(),
11831
+ nativeAddonId: string()
11832
+ }))
11833
+ });
11747
11834
  var SavedDeviceRowSchema = object({
11748
11835
  /** Numeric id reserved at allocateDeviceId time. */
11749
11836
  id: number(),
@@ -11969,11 +12056,25 @@ method(object({
11969
12056
  projection: _enum(["full", "slim"]).optional(),
11970
12057
  /** Return only camera devices. Filtering server-side instead of
11971
12058
  * shipping 293 rows to find 12. */
11972
- isCamera: boolean().optional()
12059
+ isCamera: boolean().optional(),
12060
+ /**
12061
+ * Return only these device ids. For the caller that already KNOWS the
12062
+ * handful it wants and needs a field the id-bearing answer does not
12063
+ * carry — the viewer's linked-devices panel joins `type` and `online`
12064
+ * onto ~8 linked ids and, unfiltered, dragged the fleet across to do
12065
+ * it: 433 KB slim / 958 KB full for 967 devices, on a query that
12066
+ * refetches on the reconcile interval, on a phone.
12067
+ *
12068
+ * Safe to send at a hub that predates it: Zod STRIPS unknown input
12069
+ * keys rather than rejecting them (verified against the live hub
12070
+ * 2026-08-25 — 967 rows came back), so an old hub answers exactly what
12071
+ * it answers today and the caller filters as it already does.
12072
+ */
12073
+ deviceIds: array(number()).optional()
11973
12074
  }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), DeviceInfoSchema.nullable()), method(object({ parentDeviceId: number() }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), object({
11974
12075
  mode: LinkedDevicesModeSchema,
11975
12076
  devices: array(LinkedDeviceSchema)
11976
- })), method(object({ deviceId: number() }), array(StreamSourceEntrySchema$1)), method(object({ deviceId: number() }), array(ConfigEntrySchema)), method(object({ deviceId: number() }), ConfigUISchemaOutput), method(object({
12077
+ })), method(object({ deviceIds: array(number()) }), array(LinkedDevicesForDeviceSchema)), method(object({ deviceId: number() }), array(StreamSourceEntrySchema$1)), method(object({ deviceId: number() }), array(ConfigEntrySchema)), method(object({ deviceId: number() }), ConfigUISchemaOutput), method(object({
11977
12078
  deviceId: number(),
11978
12079
  values: record(string(), unknown())
11979
12080
  }), object({ success: literal(true) }), {
@@ -12000,25 +12101,7 @@ method(object({
12000
12101
  }), method(object({ deviceId: number() }), array(StreamProbeResultSchema), {
12001
12102
  kind: "mutation",
12002
12103
  auth: "admin"
12003
- }), method(object({ deviceId: number() }), object({
12004
- deviceId: number(),
12005
- entries: array(object({
12006
- capName: string(),
12007
- kind: _enum(["native", "wrapped"]),
12008
- providerAddonId: string(),
12009
- providerNodeId: string(),
12010
- nativeAddonId: string()
12011
- }))
12012
- })), method(object({}), array(object({
12013
- deviceId: number(),
12014
- entries: array(object({
12015
- capName: string(),
12016
- kind: _enum(["native", "wrapped"]),
12017
- providerAddonId: string(),
12018
- providerNodeId: string(),
12019
- nativeAddonId: string()
12020
- }))
12021
- }))), method(object({
12104
+ }), method(object({ deviceId: number() }), DeviceBindingsForDeviceSchema), method(object({ deviceIds: array(number()) }), array(DeviceBindingsForDeviceSchema)), method(object({}), array(DeviceBindingsForDeviceSchema)), method(object({
12022
12105
  deviceId: number(),
12023
12106
  capName: string(),
12024
12107
  wrapperAddonId: string(),
@@ -12189,7 +12272,7 @@ method(object({
12189
12272
  crop: _instanceof(Uint8Array),
12190
12273
  width: number(),
12191
12274
  height: number()
12192
- }), EmbeddingResultSchema), method(object({ text: string() }), EmbeddingResultSchema), method(_void(), EmbeddingInfoSchema);
12275
+ }), EmbeddingResultSchema, { auth: "admin" }), method(object({ text: string() }), EmbeddingResultSchema, { auth: "admin" }), method(_void(), EmbeddingInfoSchema, { auth: "admin" });
12193
12276
  /**
12194
12277
  * filesystem-browse — per-node capability for browsing the node's local
12195
12278
  * filesystem. Reads are unconfined (whole filesystem, from `/` down); WRITES
@@ -12482,19 +12565,22 @@ method(LlmGenerateBaseInputSchema.extend({
12482
12565
  runtime: ManagedRuntimeConfigSchema,
12483
12566
  /** The managed profile's timeout, threaded by the hub provider. */
12484
12567
  timeoutMs: number().int().positive().optional()
12485
- }), LlmGenerateResultSchema, { kind: "mutation" }), method(object({ runtime: ManagedRuntimeConfigSchema }), LlmRuntimeStatusSchema, {
12568
+ }), LlmGenerateResultSchema, {
12569
+ kind: "mutation",
12570
+ auth: "admin"
12571
+ }), method(object({ runtime: ManagedRuntimeConfigSchema }), LlmRuntimeStatusSchema, {
12486
12572
  kind: "mutation",
12487
12573
  auth: "admin"
12488
12574
  }), method(object({}), _void(), {
12489
12575
  kind: "mutation",
12490
12576
  auth: "admin"
12491
- }), method(object({}), LlmRuntimeStatusSchema), method(object({ model: ManagedModelRefSchema }), _void(), {
12577
+ }), method(object({}), LlmRuntimeStatusSchema, { auth: "admin" }), method(object({ model: ManagedModelRefSchema }), _void(), {
12492
12578
  kind: "mutation",
12493
12579
  auth: "admin"
12494
12580
  }), method(object({ file: string() }), _void(), {
12495
12581
  kind: "mutation",
12496
12582
  auth: "admin"
12497
- }), method(object({}), array(LlmNodeModelSchema)), method(object({}), LlmRuntimeDiskUsageSchema);
12583
+ }), method(object({}), array(LlmNodeModelSchema), { auth: "admin" }), method(object({}), LlmRuntimeDiskUsageSchema, { auth: "admin" });
12498
12584
  /**
12499
12585
  * `llm` — consumer-facing LLM surface (spec §1-§3). Collection-mode: array
12500
12586
  * methods concat-fan across providers; single-row methods route to ONE
@@ -14390,12 +14476,15 @@ var NcOccupancyConditionSchema = object({
14390
14476
  * there is no second switch that can disagree with the first and every rule
14391
14477
  * authored before the decision migrates for free (`audioModeOf`):
14392
14478
  *
14393
- * - **LABEL mode — `labels` present.** The rule fires on the FIRST frame the
14394
- * classifier labels with one of them. No window, no percentage:
14395
- * `hitPercent` and `samplingSeconds` are ignored, and the rule's own
14396
- * `throttle` cooldown is the only brake. The per-label confidence floor is
14397
- * the analyzer's (`classificationMinScore`, per device) a label only
14398
- * reaches this condition if the classifier was already confident enough.
14479
+ * - **LABEL mode — `labels` present.** The rule fires when `confirmHits`
14480
+ * labelled frames land inside `confirmWindowSec` (default 2 in 5 s).
14481
+ * `hitPercent` and `samplingSeconds` are still ignored a percentage of
14482
+ * frames is the wrong question for a classifier that labels 1–3 frames
14483
+ * per episode. The count window is the brake that drops a single-frame
14484
+ * false positive; the rule's own `throttle` cooldown is the other. The
14485
+ * per-label confidence floor is the analyzer's (`classificationMinScore`,
14486
+ * per device) — a label only reaches this condition if the classifier was
14487
+ * already confident enough. `confirmHits: 1` restores first-frame fire.
14399
14488
  * - **LEVEL mode — `dbThreshold` present, no labels.** The sampling window IS
14400
14489
  * the condition: at least `hitPercent`% of the samples over
14401
14490
  * `samplingSeconds` must be at or above `dbThreshold` dBFS (see
@@ -14422,14 +14511,22 @@ var NcOccupancyConditionSchema = object({
14422
14511
  * an operator who typed `dog` mean the same thing.
14423
14512
  */
14424
14513
  var NcAudioConditionSchema = object({
14425
- /** LABEL MODE: audio macro labels. Present ⇒ fires on the first labelled frame. */
14514
+ /** LABEL MODE: audio macro labels. Present ⇒ count-in-window confirm. */
14426
14515
  labels: array(string().min(1)).min(1).optional(),
14427
14516
  /** LEVEL MODE: floor in dBFS (negative-going, `0` = full scale). */
14428
14517
  dbThreshold: number().min(-96).max(0).optional(),
14429
14518
  /** LEVEL MODE ONLY: percentage of the window's samples that must be hits (1–100). */
14430
14519
  hitPercent: number().int().min(1).max(100).default(60),
14431
14520
  /** LEVEL MODE ONLY: length of the sampling window in seconds. */
14432
- samplingSeconds: number().int().min(1).max(300).default(10)
14521
+ samplingSeconds: number().int().min(1).max(300).default(10),
14522
+ /**
14523
+ * LABEL MODE: how many labelled frames must land inside
14524
+ * {@link NcAudioConditionSchema.shape.confirmWindowSec} before dispatch.
14525
+ * Absent ⇒ 2 (the matcher default). `1` is first-frame fire.
14526
+ */
14527
+ confirmHits: number().int().min(1).max(20).optional(),
14528
+ /** LABEL MODE: the window those frames must share, in seconds. Absent ⇒ 5. */
14529
+ confirmWindowSec: number().int().min(1).max(60).optional()
14433
14530
  });
14434
14531
  /**
14435
14532
  * Which zone-crossing DIRECTION a rule accepts (`ObjectEvent.zoneCrossing`).
@@ -15956,7 +16053,7 @@ var OauthIntegrationDescriptorSchema = object({
15956
16053
  */
15957
16054
  refreshTokenTtlSec: union([number().int().positive(), literal("never")]).optional()
15958
16055
  });
15959
- method(_void(), OauthIntegrationDescriptorSchema);
16056
+ method(_void(), OauthIntegrationDescriptorSchema, { auth: "admin" });
15960
16057
  /**
15961
16058
  * pipeline-analytics — device-scoped wrapper cap. Refines raw
15962
16059
  * per-frame detections emitted by the pipeline runner into tracked
@@ -16803,6 +16900,46 @@ var RecentTracksPageSchema = object({
16803
16900
  /** Cursor for the next page, or null when this page is the last. */
16804
16901
  nextCursor: string().nullable()
16805
16902
  });
16903
+ var LIST_GROUPS_DEFAULT_LIMIT = 40;
16904
+ var LIST_GROUPS_MAX_LIMIT = 100;
16905
+ var AnalyticsGroupRecordSchema = object({
16906
+ id: string(),
16907
+ deviceId: number().int(),
16908
+ openedAt: number().int(),
16909
+ closedAt: number().int(),
16910
+ timestamp: number().int(),
16911
+ memberCount: number().int(),
16912
+ memberTrackIds: array(string()).readonly(),
16913
+ className: string(),
16914
+ classes: array(string()).readonly(),
16915
+ /** Relative event-media path, or null when the group has no picture yet. */
16916
+ mediaUrl: string().nullable(),
16917
+ singleton: boolean()
16918
+ });
16919
+ var AnalyticsGroupMemberSchema = object({
16920
+ trackId: string(),
16921
+ deviceId: number().int(),
16922
+ className: string(),
16923
+ firstSeen: number().int(),
16924
+ lastSeen: number().int(),
16925
+ mediaUrl: string().nullable()
16926
+ });
16927
+ var AnalyticsGroupDetailSchema = AnalyticsGroupRecordSchema.extend({ members: array(AnalyticsGroupMemberSchema).readonly() });
16928
+ var ListGroupsQueryInput = object({
16929
+ /** Devices to merge. An empty array yields `{ groups: [], nextCursor: null }`. */
16930
+ deviceIds: array(number()),
16931
+ /** Window lower bound on `closedAt` (inclusive). */
16932
+ since: number().optional(),
16933
+ /** Window upper bound on `openedAt` (inclusive). */
16934
+ until: number().optional(),
16935
+ limit: number().int().min(1).max(LIST_GROUPS_MAX_LIMIT).default(LIST_GROUPS_DEFAULT_LIMIT),
16936
+ /** Opaque continuation cursor from a previous page's `nextCursor`. */
16937
+ cursor: string().optional()
16938
+ });
16939
+ var ListGroupsPageSchema = object({
16940
+ groups: array(AnalyticsGroupRecordSchema).readonly(),
16941
+ nextCursor: string().nullable()
16942
+ });
16806
16943
  var KeyEventQueryInput = object({
16807
16944
  deviceId: number(),
16808
16945
  /** Window lower bound (track firstSeen ≥ since). */
@@ -16878,7 +17015,9 @@ var TrackCascadeCountsSchema = object({
16878
17015
  /** Unassigned plate reads removed (best-effort; plate leg deferred to plate-intelligence). */
16879
17016
  plates: number().int(),
16880
17017
  /** Per-track CLIP search vectors removed (best-effort). */
16881
- embeddings: number().int()
17018
+ embeddings: number().int(),
17019
+ /** Group membership + group rows removed with their last member (best-effort). */
17020
+ groups: number().int()
16882
17021
  });
16883
17022
  /** Disk-wins reconcile: media rows whose blobs are gone, then empty tracks. */
16884
17023
  var DiskReconcileCountsSchema = object({
@@ -17024,7 +17163,10 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
17024
17163
  * stationary registry). Default false: the timeline lists passages,
17025
17164
  * not parking records (operator decision, 2026-08-15). */
17026
17165
  includeStationary: boolean().optional()
17027
- }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(object({ deviceId: number() }), _void(), {
17166
+ }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(ListGroupsQueryInput, ListGroupsPageSchema), method(object({
17167
+ deviceId: number(),
17168
+ groupId: string().min(1)
17169
+ }), AnalyticsGroupDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
17028
17170
  kind: "mutation",
17029
17171
  auth: "admin"
17030
17172
  }), method(DeviceEventQueryInput, array(MotionEventSchema).readonly()), method(ObjectEventQueryInput, array(ObjectEventSchema).readonly()), method(DeviceEventQueryInput, array(AudioEventSchema).readonly()), method(object({ deviceId: number() }), array(EventKindDescriptorSchema).readonly()), method(object({ deviceIds: array(number()).min(1).max(200) }), array(EventKindsForDeviceSchema).readonly()), method(object({
@@ -17106,6 +17248,15 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
17106
17248
  }), method(object({ jobId: string() }), RelocateJobSchema.nullable(), { auth: "admin" }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
17107
17249
  kind: "mutation",
17108
17250
  auth: "admin"
17251
+ }), method(RelocateMediaInputSchema, object({ jobId: string() }), {
17252
+ kind: "mutation",
17253
+ auth: "admin"
17254
+ }), method(object({}), array(RelocateJobSchema).readonly(), {
17255
+ kind: "query",
17256
+ auth: "admin"
17257
+ }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
17258
+ kind: "mutation",
17259
+ auth: "admin"
17109
17260
  }), method(OpsLogQueryInputSchema, array(OpsLogEntrySchema).readonly(), {
17110
17261
  kind: "query",
17111
17262
  auth: "admin"
@@ -17260,6 +17411,11 @@ object({
17260
17411
  "jpeg"
17261
17412
  ])
17262
17413
  });
17414
+ /**
17415
+ * Process-local frame identity. It is serializable so it can ride an in-process
17416
+ * capability call, but `registryId` deliberately prevents resolution in any
17417
+ * other process or execution group.
17418
+ */
17263
17419
  var FrameRefSchema = object({
17264
17420
  registryId: string().min(1),
17265
17421
  id: string().min(1),
@@ -17334,7 +17490,8 @@ var PipelineModelOptionSchema = object({
17334
17490
  sizeMB: number()
17335
17491
  })),
17336
17492
  group: ModelVariantGroupSchema.optional(),
17337
- legacy: boolean().optional()
17493
+ legacy: boolean().optional(),
17494
+ provider: ModelProviderIdSchema.optional()
17338
17495
  });
17339
17496
  var ConfigFieldBridge = custom();
17340
17497
  var PipelineAddonSchemaSchema = object({
@@ -19424,7 +19581,7 @@ method(object({
19424
19581
  * linking rather than produce an eternal token.
19425
19582
  */
19426
19583
  ttlSec: union([number().int().positive(), literal("never")]).optional()
19427
- }), object({ token: string() })), method(object({ token: string() }), SsoBridgeClaimsSchema.nullable());
19584
+ }), object({ token: string() }), { auth: "admin" }), method(object({ token: string() }), SsoBridgeClaimsSchema.nullable(), { auth: "admin" });
19428
19585
  var ProviderListEntrySchema = discriminatedUnion("shouldSaveDiskSpace", [object({
19429
19586
  providerId: string().min(1),
19430
19587
  displayName: string().min(1),
@@ -19519,10 +19676,13 @@ var EvictResultSchema = object({
19519
19676
  /** True when the provider has nothing left it is willing to drop on this location. */
19520
19677
  exhausted: boolean()
19521
19678
  });
19522
- method(object({ locationId: string() }), EvictableUsageSchema), method(object({
19679
+ method(object({ locationId: string() }), EvictableUsageSchema, { auth: "admin" }), method(object({
19523
19680
  locationId: string(),
19524
19681
  targetBytes: number().int().positive()
19525
- }), EvictResultSchema, { kind: "mutation" });
19682
+ }), EvictResultSchema, {
19683
+ kind: "mutation",
19684
+ auth: "admin"
19685
+ });
19526
19686
  method(StorageMigrationInputSchema, StorageMigrationPlanSchema, { auth: "admin" }), method(StorageMigrationInputSchema, object({ jobId: string() }), {
19527
19687
  kind: "mutation",
19528
19688
  auth: "admin"
@@ -19608,43 +19768,82 @@ var storageProviderCapability = {
19608
19768
  mode: "collection",
19609
19769
  internal: true,
19610
19770
  methods: {
19771
+ /**
19772
+ * Every method below except `testLocation` had NO `auth` override —
19773
+ * `internal: true` did not gate the mount (see the 2026-08-26 note on
19774
+ * `data-store-provider`), so this was reachable on the AppRouter by ANY
19775
+ * authenticated session at the default `auth: 'protected'`: arbitrary
19776
+ * read/write/delete/list against any storage location the operator has
19777
+ * configured, keyed only by a caller-supplied `location` + `relativePath`
19778
+ * — the same "public consumers never see this cap" claim that was false
19779
+ * for `data-store-provider`, here gating raw file I/O instead of raw
19780
+ * settings rows. The only legitimate caller,
19781
+ * `addon-registry.service.ts`'s `activeStorageProvider`, calls the
19782
+ * provider object directly (in-process) — never tRPC — so `auth: 'admin'`
19783
+ * on every method costs it nothing. Public consumers already go through
19784
+ * the separate `storage` singleton cap.
19785
+ */
19611
19786
  /** Self-description for the "Add location" wizard. */
19612
- getProviderInfo: method(_void(), ProviderInfoSchema),
19787
+ getProviderInfo: method(_void(), ProviderInfoSchema, { auth: "admin" }),
19613
19788
  /** Validate config + probe connectivity. Called on add and on edit. */
19614
19789
  testLocation: method(object({ config: record(string(), unknown()) }), TestLocationResultSchema, { auth: "admin" }),
19615
19790
  resolve: method(object({
19616
19791
  location: StorageLocationSchema,
19617
19792
  relativePath: string()
19618
- }), string()),
19793
+ }), string(), { auth: "admin" }),
19619
19794
  write: method(object({
19620
19795
  location: StorageLocationSchema,
19621
19796
  relativePath: string(),
19622
19797
  data: _instanceof(Uint8Array)
19623
- }), _void(), { kind: "mutation" }),
19798
+ }), _void(), {
19799
+ kind: "mutation",
19800
+ auth: "admin"
19801
+ }),
19624
19802
  read: method(object({
19625
19803
  location: StorageLocationSchema,
19626
19804
  relativePath: string()
19627
- }), _instanceof(Uint8Array)),
19805
+ }), _instanceof(Uint8Array), { auth: "admin" }),
19628
19806
  exists: method(object({
19629
19807
  location: StorageLocationSchema,
19630
19808
  relativePath: string()
19631
- }), boolean()),
19809
+ }), boolean(), { auth: "admin" }),
19632
19810
  list: method(object({
19633
19811
  location: StorageLocationSchema,
19634
19812
  prefix: string().optional()
19635
- }), array(string()).readonly()),
19813
+ }), array(string()).readonly(), { auth: "admin" }),
19636
19814
  delete: method(object({
19637
19815
  location: StorageLocationSchema,
19638
19816
  relativePath: string()
19639
- }), _void(), { kind: "mutation" }),
19640
- getAvailableSpace: method(object({ location: StorageLocationSchema }), number().nullable()),
19641
- beginUpload: method(BeginUploadInputSchema, BeginUploadResultSchema, { kind: "mutation" }),
19642
- writeChunk: method(WriteChunkInputSchema, _void(), { kind: "mutation" }),
19643
- finalizeUpload: method(FinalizeUploadInputSchema, _void(), { kind: "mutation" }),
19644
- abortUpload: method(AbortUploadInputSchema, _void(), { kind: "mutation" }),
19645
- beginDownload: method(BeginDownloadInputSchema, BeginDownloadResultSchema, { kind: "mutation" }),
19646
- readChunk: method(ReadChunkInputSchema, _instanceof(Uint8Array)),
19647
- endDownload: method(EndDownloadInputSchema, _void(), { kind: "mutation" })
19817
+ }), _void(), {
19818
+ kind: "mutation",
19819
+ auth: "admin"
19820
+ }),
19821
+ getAvailableSpace: method(object({ location: StorageLocationSchema }), number().nullable(), { auth: "admin" }),
19822
+ beginUpload: method(BeginUploadInputSchema, BeginUploadResultSchema, {
19823
+ kind: "mutation",
19824
+ auth: "admin"
19825
+ }),
19826
+ writeChunk: method(WriteChunkInputSchema, _void(), {
19827
+ kind: "mutation",
19828
+ auth: "admin"
19829
+ }),
19830
+ finalizeUpload: method(FinalizeUploadInputSchema, _void(), {
19831
+ kind: "mutation",
19832
+ auth: "admin"
19833
+ }),
19834
+ abortUpload: method(AbortUploadInputSchema, _void(), {
19835
+ kind: "mutation",
19836
+ auth: "admin"
19837
+ }),
19838
+ beginDownload: method(BeginDownloadInputSchema, BeginDownloadResultSchema, {
19839
+ kind: "mutation",
19840
+ auth: "admin"
19841
+ }),
19842
+ readChunk: method(ReadChunkInputSchema, _instanceof(Uint8Array), { auth: "admin" }),
19843
+ endDownload: method(EndDownloadInputSchema, _void(), {
19844
+ kind: "mutation",
19845
+ auth: "admin"
19846
+ })
19648
19847
  }
19649
19848
  };
19650
19849
  /** Profile-exported FormBuilder schema. Shape is ConfigUISchema at the UI. */
@@ -19904,7 +20103,8 @@ method(object({
19904
20103
  access: "create"
19905
20104
  }), method(object({ userId: string().optional() }), object({ optionsJSON: record(string(), unknown()) }), {
19906
20105
  kind: "mutation",
19907
- access: "view"
20106
+ access: "view",
20107
+ auth: "admin"
19908
20108
  }), method(object({
19909
20109
  /** Required — the user the assertion belongs to (verified). */
19910
20110
  userId: string(),
@@ -19912,10 +20112,12 @@ method(object({
19912
20112
  response: record(string(), unknown())
19913
20113
  }), object({ verified: boolean() }), {
19914
20114
  kind: "mutation",
19915
- access: "view"
20115
+ access: "view",
20116
+ auth: "admin"
19916
20117
  }), method(object({}), object({ optionsJSON: record(string(), unknown()) }), {
19917
20118
  kind: "mutation",
19918
- access: "view"
20119
+ access: "view",
20120
+ auth: "admin"
19919
20121
  }), method(object({
19920
20122
  /** AuthenticationResponseJSON from the browser. */
19921
20123
  response: record(string(), unknown()) }), object({
@@ -19923,7 +20125,8 @@ response: record(string(), unknown()) }), object({
19923
20125
  userId: string().nullable()
19924
20126
  }), {
19925
20127
  kind: "mutation",
19926
- access: "view"
20128
+ access: "view",
20129
+ auth: "admin"
19927
20130
  }), method(object({ userId: string() }), array(PasskeySummarySchema), { auth: "admin" }), method(object({
19928
20131
  userId: string(),
19929
20132
  credentialId: string()
@@ -20095,7 +20298,19 @@ var VectorStatsResultSchema = object({
20095
20298
  /** False when the backend ranks approximately. */
20096
20299
  exact: boolean()
20097
20300
  });
20098
- method(VectorDeclareIndexInputSchema, _void(), { kind: "mutation" }), method(VectorUpsertInputSchema, VectorUpsertResultSchema, { kind: "mutation" }), method(VectorQueryInputSchema, VectorQueryResultSchema), method(VectorGetInputSchema, VectorGetResultSchema), method(VectorDeleteInputSchema, VectorDeleteResultSchema, { kind: "mutation" }), method(VectorDeleteByFilterInputSchema, VectorDeleteResultSchema, { kind: "mutation" }), method(VectorStatsInputSchema, VectorStatsResultSchema);
20301
+ method(VectorDeclareIndexInputSchema, _void(), {
20302
+ kind: "mutation",
20303
+ auth: "admin"
20304
+ }), method(VectorUpsertInputSchema, VectorUpsertResultSchema, {
20305
+ kind: "mutation",
20306
+ auth: "admin"
20307
+ }), method(VectorQueryInputSchema, VectorQueryResultSchema, { auth: "admin" }), method(VectorGetInputSchema, VectorGetResultSchema, { auth: "admin" }), method(VectorDeleteInputSchema, VectorDeleteResultSchema, {
20308
+ kind: "mutation",
20309
+ auth: "admin"
20310
+ }), method(VectorDeleteByFilterInputSchema, VectorDeleteResultSchema, {
20311
+ kind: "mutation",
20312
+ auth: "admin"
20313
+ }), method(VectorStatsInputSchema, VectorStatsResultSchema, { auth: "admin" });
20099
20314
  var ClipSchema = object({
20100
20315
  /** Opaque, provider-namespaced id. The default provider encodes the time
20101
20316
  * window so `getClipPlayback` is self-contained (no event re-query). */
@@ -21818,7 +22033,27 @@ var MediaFileLiteSchema$1 = object({
21818
22033
  sizeBytes: number(),
21819
22034
  timestamp: number()
21820
22035
  });
21821
- method(_void(), array(IdentitySchema).readonly()), method(object({ name: string().min(1) }), IdentitySchema, {
22036
+ method(object({
22037
+ /**
22038
+ * Inline {@link IdentitySchema.coverBase64} on every row.
22039
+ *
22040
+ * Default `false`, the same inversion `listRecentFaces` and
22041
+ * `listPlates` took on 2026-08-25 (see `include-crops-default.ts` for
22042
+ * why the burden belongs on the caller that WANTS the bytes). Measured
22043
+ * on the live hub the same day: four identities cost 40,979 B with the
22044
+ * covers inline, ~10 KB of base64 per row, on a query this UI mounts
22045
+ * four times and the viewer holds at `staleTime: 30_000`.
22046
+ *
22047
+ * Nothing loses its avatar: `coverMediaKey` is already on every row and
22048
+ * the `event-media` plane serves that key `immutable` with an ETag.
22049
+ *
22050
+ * **This is an INPUT field, so it does not reach the addon until the
22051
+ * next train** — the hub router validates cap inputs against its own
22052
+ * compiled Zod and strips a key it does not know. Until then the
22053
+ * provider sees `undefined`, which resolves to `false`: the cheap shape
22054
+ * is what ships, and the opt-in becomes reachable when the train lands.
22055
+ */
22056
+ includeCrops: boolean().optional() }).optional(), array(IdentitySchema).readonly()), method(object({ name: string().min(1) }), IdentitySchema, {
21822
22057
  kind: "mutation",
21823
22058
  auth: "admin"
21824
22059
  }), method(object({
@@ -23963,7 +24198,14 @@ var PlateInfoSchema = object({
23963
24198
  plateBbox: BoundingBoxSchema.optional(),
23964
24199
  /** keyFrame parity: MediaStore key of the track's native-resolution key frame. */
23965
24200
  keyFrameMediaKey: string().optional(),
23966
- base64: string().optional()
24201
+ base64: string().optional(),
24202
+ /**
24203
+ * Same crop as a data-plane URL, always present when the plate has a stored
24204
+ * crop. `getPlateByTrack` returns this and never inlines JPEG; `listPlates`
24205
+ * and `searchPlates` inline the crop only when their `includeCrops` input is
24206
+ * left at its `true` default.
24207
+ */
24208
+ cropUrl: string().optional()
23967
24209
  });
23968
24210
  var MediaFileLiteSchema = object({
23969
24211
  key: string(),
@@ -23981,14 +24223,34 @@ var PlateClusterSchema = object({
23981
24223
  });
23982
24224
  method(object({
23983
24225
  deviceId: number().int().optional(),
23984
- limit: number().int().positive().optional()
24226
+ limit: number().int().positive().optional(),
24227
+ /**
24228
+ * Inline the base64 crop on every row. Default `true` — the existing
24229
+ * behaviour, kept so no caller breaks.
24230
+ *
24231
+ * Set `false` once the caller renders {@link PlateInfo.cropUrl}.
24232
+ * Measured on the live hub at the 500 rows the Plates view asks for:
24233
+ * 879,403 B and 27.7 s with the crops inline, against a few KiB of
24234
+ * metadata without them — and the browser then caches the images.
24235
+ *
24236
+ * This is the plate twin of `faceGallery.listRecentFaces`'s option;
24237
+ * plates were the one gallery list left without it.
24238
+ *
24239
+ * **This is an INPUT field, so it does not reach the addon until the
24240
+ * next train.** The hub router validates cap inputs against its own
24241
+ * compiled Zod and strips a key it does not know. Until the train
24242
+ * ships, sending `false` is harmless and keeps the crops inline.
24243
+ */
24244
+ includeCrops: boolean().optional()
23985
24245
  }).optional(), array(PlateInfoSchema).readonly()), method(object({
23986
24246
  deviceId: number().int(),
23987
24247
  trackId: string()
23988
24248
  }), PlateInfoSchema.nullable()), method(object({ plateId: string() }), array(MediaFileLiteSchema).readonly()), method(object({
23989
24249
  text: string().min(1),
23990
24250
  maxDistance: number().int().min(0).optional(),
23991
- limit: number().int().positive().optional()
24251
+ limit: number().int().positive().optional(),
24252
+ /** See `listPlates.includeCrops`. Default `true`. */
24253
+ includeCrops: boolean().optional()
23992
24254
  }), array(PlateInfoSchema).readonly()), method(object({
23993
24255
  maxDistance: number().int().min(0).optional(),
23994
24256
  minClusterSize: number().int().min(2).optional(),
@@ -24002,7 +24264,13 @@ method(object({
24002
24264
  }), method(object({ plateId: string() }), _void(), {
24003
24265
  kind: "mutation",
24004
24266
  auth: "admin"
24005
- }), method(_void(), array(VehicleSchema).readonly()), method(object({ name: string().min(1) }), VehicleSchema, {
24267
+ }), method(object({
24268
+ /** Inline {@link VehicleSchema.coverBase64} on every row. Default
24269
+ * `false` — the vehicle twin of `faceGallery.listIdentities`'s
24270
+ * option; `coverMediaKey` + the `event-media` plane carry the picture.
24271
+ * INPUT field: stripped by the hub router until the train ships, which
24272
+ * resolves to `false` and is exactly the intended default. */
24273
+ includeCrops: boolean().optional() }).optional(), array(VehicleSchema).readonly()), method(object({ name: string().min(1) }), VehicleSchema, {
24006
24274
  kind: "mutation",
24007
24275
  auth: "admin"
24008
24276
  }), method(object({
@@ -27603,6 +27871,12 @@ Object.freeze({
27603
27871
  addonId: null,
27604
27872
  access: "view"
27605
27873
  },
27874
+ "deviceManager.getBindingsBatch": {
27875
+ capName: "device-manager",
27876
+ capScope: "system",
27877
+ addonId: null,
27878
+ access: "view"
27879
+ },
27606
27880
  "deviceManager.getChildren": {
27607
27881
  capName: "device-manager",
27608
27882
  capScope: "system",
@@ -27663,6 +27937,12 @@ Object.freeze({
27663
27937
  addonId: null,
27664
27938
  access: "view"
27665
27939
  },
27940
+ "deviceManager.getLinkedDevicesBatch": {
27941
+ capName: "device-manager",
27942
+ capScope: "system",
27943
+ addonId: null,
27944
+ access: "view"
27945
+ },
27666
27946
  "deviceManager.getRoleDisplayDefaults": {
27667
27947
  capName: "device-manager",
27668
27948
  capScope: "system",
@@ -29367,6 +29647,12 @@ Object.freeze({
29367
29647
  addonId: null,
29368
29648
  access: "create"
29369
29649
  },
29650
+ "pipelineAnalytics.cancelRelocateMedia": {
29651
+ capName: "pipeline-analytics",
29652
+ capScope: "device",
29653
+ addonId: null,
29654
+ access: "create"
29655
+ },
29370
29656
  "pipelineAnalytics.cancelStorageMigrationMove": {
29371
29657
  capName: "pipeline-analytics",
29372
29658
  capScope: "device",
@@ -29433,6 +29719,12 @@ Object.freeze({
29433
29719
  addonId: null,
29434
29720
  access: "view"
29435
29721
  },
29722
+ "pipelineAnalytics.getGroup": {
29723
+ capName: "pipeline-analytics",
29724
+ capScope: "device",
29725
+ addonId: null,
29726
+ access: "view"
29727
+ },
29436
29728
  "pipelineAnalytics.getKeyEvents": {
29437
29729
  capName: "pipeline-analytics",
29438
29730
  capScope: "device",
@@ -29517,6 +29809,12 @@ Object.freeze({
29517
29809
  addonId: null,
29518
29810
  access: "view"
29519
29811
  },
29812
+ "pipelineAnalytics.listGroups": {
29813
+ capName: "pipeline-analytics",
29814
+ capScope: "device",
29815
+ addonId: null,
29816
+ access: "view"
29817
+ },
29520
29818
  "pipelineAnalytics.listOpsLog": {
29521
29819
  capName: "pipeline-analytics",
29522
29820
  capScope: "device",
@@ -29529,6 +29827,12 @@ Object.freeze({
29529
29827
  addonId: null,
29530
29828
  access: "view"
29531
29829
  },
29830
+ "pipelineAnalytics.listRelocateMediaJobs": {
29831
+ capName: "pipeline-analytics",
29832
+ capScope: "device",
29833
+ addonId: null,
29834
+ access: "view"
29835
+ },
29532
29836
  "pipelineAnalytics.listRetrainAnnotations": {
29533
29837
  capName: "pipeline-analytics",
29534
29838
  capScope: "device",
@@ -29607,6 +29911,12 @@ Object.freeze({
29607
29911
  addonId: null,
29608
29912
  access: "create"
29609
29913
  },
29914
+ "pipelineAnalytics.relocateMedia": {
29915
+ capName: "pipeline-analytics",
29916
+ capScope: "device",
29917
+ addonId: null,
29918
+ access: "create"
29919
+ },
29610
29920
  "pipelineAnalytics.restageRetrainTrack": {
29611
29921
  capName: "pipeline-analytics",
29612
29922
  capScope: "device",
@@ -32298,6 +32608,11 @@ Object.freeze({
32298
32608
  form: "single",
32299
32609
  optional: false
32300
32610
  }],
32611
+ "deviceManager.getBindingsBatch": [{
32612
+ name: "deviceIds",
32613
+ form: "array",
32614
+ optional: false
32615
+ }],
32301
32616
  "deviceManager.getChildren": [{
32302
32617
  name: "parentDeviceId",
32303
32618
  form: "single",
@@ -32343,6 +32658,11 @@ Object.freeze({
32343
32658
  form: "single",
32344
32659
  optional: false
32345
32660
  }],
32661
+ "deviceManager.getLinkedDevicesBatch": [{
32662
+ name: "deviceIds",
32663
+ form: "array",
32664
+ optional: false
32665
+ }],
32346
32666
  "deviceManager.getSettingsSchema": [{
32347
32667
  name: "deviceId",
32348
32668
  form: "single",
@@ -32363,6 +32683,11 @@ Object.freeze({
32363
32683
  form: "single",
32364
32684
  optional: false
32365
32685
  }],
32686
+ "deviceManager.listAll": [{
32687
+ name: "deviceIds",
32688
+ form: "array",
32689
+ optional: true
32690
+ }],
32366
32691
  "deviceManager.loadConfig": [{
32367
32692
  name: "deviceId",
32368
32693
  form: "single",
@@ -32936,6 +33261,11 @@ Object.freeze({
32936
33261
  form: "single",
32937
33262
  optional: false
32938
33263
  }],
33264
+ "pipelineAnalytics.getGroup": [{
33265
+ name: "deviceId",
33266
+ form: "single",
33267
+ optional: false
33268
+ }],
32939
33269
  "pipelineAnalytics.getKeyEvents": [{
32940
33270
  name: "deviceId",
32941
33271
  form: "single",
@@ -32991,6 +33321,11 @@ Object.freeze({
32991
33321
  form: "array",
32992
33322
  optional: false
32993
33323
  }],
33324
+ "pipelineAnalytics.listGroups": [{
33325
+ name: "deviceIds",
33326
+ form: "array",
33327
+ optional: false
33328
+ }],
32994
33329
  "pipelineAnalytics.listOpsLog": [{
32995
33330
  name: "deviceId",
32996
33331
  form: "single",