@camstack/addon-provider-ecowitt 0.2.120 → 0.2.121

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 +882 -461
  2. package/dist/addon.mjs +882 -461
  3. package/package.json +1 -1
package/dist/addon.js CHANGED
@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
2
  let http = require("http");
3
3
  let events = require("events");
4
4
  let dgram = require("dgram");
5
- //#region ../types/dist/event-category-BGmz_oxW.mjs
5
+ //#region ../types/dist/event-category-B_0XEcLF.mjs
6
6
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
7
7
  EventCategory["SystemBoot"] = "system.boot";
8
8
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -503,15 +503,6 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
503
503
  EventCategory["AgentWsDisconnected"] = "agent.ws.disconnected";
504
504
  EventCategory["AgentBackupActivated"] = "agent.backup.activated";
505
505
  EventCategory["OrchestrationSettingsUpdated"] = "orchestration.settings-updated";
506
- /**
507
- * Per-agent hwaccel preference changed (user override set, cleared, or
508
- * re-probed). Observability event — decoders pull the current pref at
509
- * `createSession`, so running sessions keep their current backend until
510
- * they rotate naturally (camera add/remove, stream restart). Future
511
- * work can wire a listener in stream-broker that force-rotates live
512
- * sessions; for now this event powers logs + admin-UI toast feedback.
513
- */
514
- EventCategory["PipelineAgentHwaccelChanged"] = "pipeline.agent-hwaccel-changed";
515
506
  EventCategory["MotionAnalysis"] = "detection.motion-analysis";
516
507
  /** All raw motion zones from CCL before minArea filter — for UI debug overlay. */
517
508
  EventCategory["MotionZonesRaw"] = "detection.motion-zones-raw";
@@ -5382,7 +5373,7 @@ var ZodIssueCode$1 = {
5382
5373
  var ZodFirstPartyTypeKind$1;
5383
5374
  ZodFirstPartyTypeKind$1 || (ZodFirstPartyTypeKind$1 = {});
5384
5375
  //#endregion
5385
- //#region ../types/dist/sleep-DXKLNFvA.mjs
5376
+ //#region ../types/dist/sleep-BNeXenvr.mjs
5386
5377
  /**
5387
5378
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5388
5379
  * window to float samples (D455).
@@ -6748,32 +6739,12 @@ object({
6748
6739
  audioCodec: string().optional(),
6749
6740
  metadata: record(string(), unknown()).readonly().optional()
6750
6741
  });
6751
- var EncodedPacketSchema = object({
6752
- type: _enum(["video", "audio"]),
6753
- data: _instanceof(Uint8Array),
6754
- pts: number(),
6755
- dts: number(),
6756
- keyframe: boolean(),
6757
- codec: string()
6758
- });
6759
- var DecodedFrameSchema = object({
6760
- data: _instanceof(Uint8Array),
6761
- width: number(),
6762
- height: number(),
6763
- format: _enum([
6764
- "jpeg",
6765
- "rgb",
6766
- "bgr",
6767
- "yuv420",
6768
- "gray"
6769
- ]),
6770
- timestamp: number()
6771
- });
6772
6742
  /**
6773
6743
  * Wire schema for `FrameHandle` — a zero-pixel, serialisable reference to a
6774
6744
  * frame in a shared-memory ring (Phase 5 / D9). Mirrors the `FrameHandle` TS
6775
- * interface in `interfaces/frame-handle.ts` field-for-field so a decoder cap
6776
- * method (`pullHandles`) can carry handles over tRPC / Moleculer.
6745
+ * interface in `interfaces/frame-handle.ts` field-for-field so a cap method
6746
+ * (the runner's native-crop and pipeline-executor inputs) can carry handles
6747
+ * over tRPC / Moleculer.
6777
6748
  *
6778
6749
  * The `satisfies` assertion below pins this schema to the interface: if a
6779
6750
  * field is added to / removed from `FrameHandle` without a matching schema
@@ -6799,50 +6770,6 @@ var FrameHandleSchema = object({
6799
6770
  slotCount: number().int().positive()
6800
6771
  });
6801
6772
  /**
6802
- * Pixel format a frame-handle subscriber can request from the broker
6803
- * (Phase 5 / D9). The packed, raster subset of `FrameFormat` — the formats a
6804
- * `frameSink: 'shm'` decoder session can write into a `FrameRing` slot.
6805
- * `jpeg` is excluded: a variable-length stream is not a fixed-stride ring
6806
- * payload, and no decoded-frame consumer requests it over the shm plane.
6807
- */
6808
- var FrameHandleFormatSchema = _enum([
6809
- "rgb",
6810
- "bgr",
6811
- "yuv420",
6812
- "gray"
6813
- ]);
6814
- /**
6815
- * Input for `stream-broker.subscribeFrames` (Phase 5 / D9). A consumer asks the
6816
- * broker for a `FrameHandle` stream of one `format`; the broker maintains one
6817
- * shared-memory ring per `(brokerId, format)` actually requested, so a `gray`
6818
- * subscriber (motion) and an `rgb` subscriber (detection) each read the format
6819
- * they asked for with no broker-side conversion.
6820
- */
6821
- var SubscribeFramesInputSchema = object({
6822
- brokerId: string(),
6823
- format: FrameHandleFormatSchema,
6824
- /**
6825
- * Optional reader-side cadence hint in frames per second. The broker does
6826
- * NOT throttle — latest-wins ring reads drop frames implicitly for a slow
6827
- * consumer. The value is echoed back in `SubscribeFramesResult.maxFps` so
6828
- * the consumer can pace its own `pullFrameHandles` polling.
6829
- */
6830
- maxFps: number().positive().optional(),
6831
- /** Short caller-identity tag (`motion`, `detection`, …) for diagnostics. */
6832
- tag: string().optional()
6833
- });
6834
- /**
6835
- * Result of `stream-broker.subscribeFrames`. The consumer then polls
6836
- * `pullFrameHandles({ subscriptionId, maxCount })` and feeds each returned
6837
- * `FrameHandle` to a `FrameRingReader`.
6838
- */
6839
- var SubscribeFramesResultSchema = object({
6840
- /** Opaque id the consumer passes to `pullFrameHandles` / `unsubscribeFrames`. */
6841
- subscriptionId: string(),
6842
- /** Reader-side cadence hint (frames/s) — echoes `SubscribeFramesInput.maxFps`. */
6843
- maxFps: number().nonnegative()
6844
- });
6845
- /**
6846
6773
  * Wire schema for a decoded audio chunk (Phase 5 / D9). Mirrors the
6847
6774
  * `DecodedAudioChunk` TS interface in `interfaces/stream-broker.ts`: PCM
6848
6775
  * sample bytes plus the track parameters a consumer needs to interpret them.
@@ -6850,8 +6777,8 @@ var SubscribeFramesResultSchema = object({
6850
6777
  * Audio chunks are tiny (a ~500ms AudioCodecSession window is a few KB of
6851
6778
  * Float32 PCM), so unlike video frames they ship their bytes INLINE over
6852
6779
  * tRPC / Moleculer — no shared-memory plane. `data` is typed `Uint8Array`
6853
- * (the wire-serialisable supertype of `Buffer`) to match `DecodedFrameSchema`
6854
- * / `EncodedPacketSchema`'s precedent; a `Buffer` is assignable to it.
6780
+ * (the wire-serialisable supertype of `Buffer`); a `Buffer` is assignable to
6781
+ * it.
6855
6782
  */
6856
6783
  var AudioChunkFormatSchema = _enum(AUDIO_CHUNK_FORMATS);
6857
6784
  var DecodedAudioChunkSchema = object({
@@ -6869,11 +6796,10 @@ var DecodedAudioChunkSchema = object({
6869
6796
  format: AudioChunkFormatSchema.optional()
6870
6797
  });
6871
6798
  /**
6872
- * Input for `stream-broker.subscribeAudioChunks` (Phase 5 / D9). The
6873
- * handle-free, ship-bytes-inline analogue of `subscribeFrames`: a consumer
6874
- * asks the broker for the decoded audio-chunk stream of one broker; the
6875
- * broker keeps a per-subscription bounded FIFO queue the consumer drains via
6876
- * `pullAudioChunks`.
6799
+ * Input for `stream-broker.subscribeAudioChunks` (Phase 5 / D9). Audio ships
6800
+ * its bytes inline: a consumer asks the broker for the decoded audio-chunk
6801
+ * stream of one broker; the broker keeps a per-subscription bounded FIFO queue
6802
+ * the consumer drains via `pullAudioChunks`.
6877
6803
  */
6878
6804
  var SubscribeAudioChunksInputSchema = object({
6879
6805
  brokerId: string(),
@@ -6904,9 +6830,7 @@ var BrokerStatsSchema = object({
6904
6830
  "stopped"
6905
6831
  ]),
6906
6832
  inputFps: number(),
6907
- decodeFps: number(),
6908
6833
  encodedSubscribers: number(),
6909
- decodedSubscribers: number(),
6910
6834
  uptimeMs: number(),
6911
6835
  bitrateKbps: number(),
6912
6836
  idrIntervalMs: number(),
@@ -6919,14 +6843,6 @@ var BrokerStatsSchema = object({
6919
6843
  preBufferMs: number(),
6920
6844
  preBufferPackets: number(),
6921
6845
  /**
6922
- * Moleculer node id of the decoder provider currently servicing this
6923
- * stream's decoded subscribers. `null` until the deferred decoder is
6924
- * created (no decoded clients yet, or codec not detected). Surfaces the
6925
- * runtime decoder placement so the UI can show "Decoder: <agent>" without
6926
- * a separate cap call per broker.
6927
- */
6928
- decoderNodeId: string().nullable(),
6929
- /**
6930
6846
  * Detected audio track parameters from the RTSP DESCRIBE / SDP. `null`
6931
6847
  * when the stream has no audio track or the broker is in cold start.
6932
6848
  * `supported = false` means the codec was detected but the local
@@ -10262,70 +10178,6 @@ var StorageLocationDeclarationSchema = object({
10262
10178
  "backup"
10263
10179
  ]).optional()
10264
10180
  });
10265
- var DecoderStatsSchema = object({
10266
- inputFps: number(),
10267
- outputFps: number(),
10268
- avgDecodeTimeMs: number(),
10269
- droppedFrames: number(),
10270
- /**
10271
- * Pull-mode adaptive-fps telemetry (optional — only pull sessions run the
10272
- * lag-driven controller; push sessions omit these). `lagMs` is the EWMA of
10273
- * the decoder's real-time drift (rising = falling behind live); `adaptiveFps`
10274
- * is the current lag-throttled emit rate (≤ `effectiveFps` ceiling).
10275
- */
10276
- lagMs: number().optional(),
10277
- effectiveFps: number().optional(),
10278
- adaptiveFps: number().optional()
10279
- });
10280
- var DecoderSessionConfigSchema = object({
10281
- codec: string(),
10282
- maxFps: number().default(0),
10283
- outputFormat: _enum([
10284
- "jpeg",
10285
- "rgb",
10286
- "bgr",
10287
- "yuv420",
10288
- "gray"
10289
- ]).default("jpeg"),
10290
- scale: number().default(1),
10291
- width: number().optional(),
10292
- height: number().optional(),
10293
- /**
10294
- * Identifier of the camera this decoder session serves. Optional
10295
- * because the cap is generic (any caller could request decode), but
10296
- * stream-broker passes it so decoder logs include `deviceId` for
10297
- * per-camera filtering when diagnosing failures (e.g. node-av
10298
- * sendPacket errors on a single hung camera).
10299
- */
10300
- deviceId: number().int().nonnegative().optional(),
10301
- /**
10302
- * Free-form tag for log scoping. Stream-broker uses
10303
- * `broker:<deviceId>/<profile>`. Decoder session logger surfaces it
10304
- * on every line so `grep tag=broker:5/high` filters one camera
10305
- * profile cleanly.
10306
- */
10307
- tag: string().optional(),
10308
- /**
10309
- * Where the session delivers decoded frames (Phase 5 / D9):
10310
- *
10311
- * - `'callback'` (default) — the legacy pixel path: decoded frames are
10312
- * buffered as `DecodedFrame`s and drained via `pullFrames`.
10313
- * - `'shm'` — the shared-memory frame plane: decoded frames are written
10314
- * into an OS shared-memory ring and drained as zero-pixel
10315
- * `FrameHandle`s via `pullHandles`. A session is one mode or the
10316
- * other — `pullFrames` returns nothing for an `'shm'` session and
10317
- * `pullHandles` returns nothing for a `'callback'` session.
10318
- */
10319
- frameSink: _enum(["callback", "shm"]).default("callback"),
10320
- /**
10321
- * Per-camera decoder DEBUG facility. When `true`, a pull-mode session emits
10322
- * a throttled (~1Hz) structured `decoder debug` line (effective/adaptive fps,
10323
- * real-time lag, dropped-frame delta, avg decode time, hwaccel). Mirrors the
10324
- * stream-broker's `streamingDebug` gate — off by default so production logs
10325
- * stay quiet and the emit path pays zero per-frame cost when disabled.
10326
- */
10327
- debug: boolean().optional()
10328
- });
10329
10181
  /**
10330
10182
  * Per-component log CHANNELS — the gate a hot path consults, and the registry
10331
10183
  * an addon declares its channels in.
@@ -10468,6 +10320,26 @@ var ClipSearchStrictnessSchema = _enum([
10468
10320
  "balanced",
10469
10321
  "strict"
10470
10322
  ]);
10323
+ /** Steps whose effect a root label can BE. */
10324
+ var LABEL_SUPPLY_STEP_IDS = [
10325
+ "animal-classifier",
10326
+ "vehicle-classifier",
10327
+ "package-detection"
10328
+ ];
10329
+ /** Steps whose box a root detection can BE. */
10330
+ var CROP_SUPPLY_STEP_IDS = ["plate-detection", "face-detection"];
10331
+ /**
10332
+ * Steps whose per-detection MASK a root detection can carry (D737). The live
10333
+ * mask step is `segmentation` — a frame-plane refiner that runs its own model
10334
+ * once per detection crop. (`instance-segmentation` is a dormant step id that
10335
+ * no camera tree carries.)
10336
+ */
10337
+ var MASK_SUPPLY_STEP_IDS = ["segmentation"];
10338
+ [
10339
+ ...LABEL_SUPPLY_STEP_IDS,
10340
+ ...CROP_SUPPLY_STEP_IDS,
10341
+ ...MASK_SUPPLY_STEP_IDS
10342
+ ];
10471
10343
  var MODEL_FORMATS = [
10472
10344
  "onnx",
10473
10345
  "coreml",
@@ -10496,7 +10368,53 @@ var ModelFormatEntrySchema = object({
10496
10368
  /** Multi-file payload (directory members or sibling files). */
10497
10369
  files: array(string()).readonly().optional(),
10498
10370
  /** Runtime(s) that can use this format. If omitted, inferred from ModelFormat key */
10499
- runtimes: array(_enum(["python"])).readonly().optional()
10371
+ runtimes: array(_enum(["python"])).readonly().optional(),
10372
+ /**
10373
+ * Content revision of the artefact, for one hosted OFF the CamStack mirror.
10374
+ * A format on the mirror leaves it unset: its revision (the sha256 of its
10375
+ * weight file) comes from the downloader's generated table, kept in step
10376
+ * with the mirror by `scripts/check-hosted-model-revisions.ts` (D744). A
10377
+ * node records the revision it downloaded next to the file
10378
+ * (`<file>.revision`); a copy with no record or a different one is stale
10379
+ * unless its weight file hashes to the revision, and a stale copy is
10380
+ * downloaded again, the old one serving until the new one is complete. No
10381
+ * revision at all ⇒ a file on disk is current, whatever it holds (D743).
10382
+ */
10383
+ revision: string().min(1).optional()
10384
+ });
10385
+ /**
10386
+ * What a node holds for one (model, format) (D746). `current` is a complete
10387
+ * copy at its catalog revision — exactly what `downloaded: true` means.
10388
+ * `stale` is bytes on disk that are not (yet) proven current under D743/D744:
10389
+ * no or a different revision record, or a missing sibling. `missing` is no
10390
+ * copy. `downloaded` alone folds `stale` into "not downloaded", which hid
10391
+ * reclaimable bytes and a copy about to be replaced.
10392
+ */
10393
+ var ModelOnDiskStateSchema = _enum([
10394
+ "current",
10395
+ "stale",
10396
+ "missing"
10397
+ ]);
10398
+ /**
10399
+ * The numeric precision of one format's BUILD (D746) — reported only when the
10400
+ * build states it (file-name token, an INT8 variant, an EdgeTPU compile, a
10401
+ * CamStack Core ML export). Absent means "not stated", never "fp32".
10402
+ */
10403
+ var ModelFormatPrecisionSchema = _enum([
10404
+ "fp32",
10405
+ "fp16",
10406
+ "int8"
10407
+ ]);
10408
+ /**
10409
+ * One format of one model as a node's `pipelineExecutor.getSchema` reports it.
10410
+ * `onDisk` / `precision` are optional for version skew: a runner that predates
10411
+ * them omits them, and a reader falls back to `downloaded`.
10412
+ */
10413
+ var PipelineModelFormatStatusSchema = object({
10414
+ downloaded: boolean(),
10415
+ sizeMB: number(),
10416
+ onDisk: ModelOnDiskStateSchema.optional(),
10417
+ precision: ModelFormatPrecisionSchema.optional()
10500
10418
  });
10501
10419
  /**
10502
10420
  * Extra file that must be downloaded alongside the model (e.g., labels JSON, dict.txt).
@@ -10600,6 +10518,46 @@ var ModelLicenseSchema = preprocess((value) => typeof value === "string" ? { wei
10600
10518
  /** True when the weights or their data forbid commercial use. */
10601
10519
  nonCommercial: boolean().optional()
10602
10520
  }));
10521
+ /**
10522
+ * One step a ROOT detector can supply from its own output (D730) — see
10523
+ * `ModelCatalogEntry.suppliesSteps`.
10524
+ *
10525
+ * - `label`: the root's raw class IS the step's answer. `labelToEffect` maps
10526
+ * the root's label to the step's vocabulary; `uncovered` is the vocabulary
10527
+ * the root cannot produce (shown as unavailable, never a blocker).
10528
+ * - `crop`: the root draws the box the step would have found (`license_plate`
10529
+ * for plate-detection, `face` for face-detection). The box becomes a detail
10530
+ * child of the `parentMacro` detection that contains it — never a track.
10531
+ * - `mask`: the root's decode emits an instance mask with every detection (a
10532
+ * YOLO26-seg root, D737) — the `segmentation` step's result, carried on the
10533
+ * detection in the shape that step produces. Derived from the model's
10534
+ * postprocessor on read, never stored by an import.
10535
+ */
10536
+ var RootStepSupplySchema = discriminatedUnion("kind", [
10537
+ object({
10538
+ kind: literal("label"),
10539
+ stepId: _enum(LABEL_SUPPLY_STEP_IDS),
10540
+ labelToEffect: record(string(), string()),
10541
+ uncovered: array(string()).readonly()
10542
+ }),
10543
+ object({
10544
+ kind: literal("crop"),
10545
+ stepId: _enum(CROP_SUPPLY_STEP_IDS),
10546
+ rootLabels: array(string()).readonly(),
10547
+ parentMacro: _enum(["vehicle", "person"]),
10548
+ childClass: _enum(["plate", "face"]),
10549
+ /**
10550
+ * The root's smaller input side, stamped on read by `rootSuppliesOf` from
10551
+ * the model entry — what a step's `minRootInputPx` gate judges. Never
10552
+ * stored by an import.
10553
+ */
10554
+ rootInputPx: number().int().positive().optional()
10555
+ }),
10556
+ object({
10557
+ kind: literal("mask"),
10558
+ stepId: _enum(MASK_SUPPLY_STEP_IDS)
10559
+ })
10560
+ ]);
10603
10561
  var ModelCatalogEntrySchema = object({
10604
10562
  id: string(),
10605
10563
  name: string(),
@@ -10665,6 +10623,35 @@ var ModelCatalogEntrySchema = object({
10665
10623
  */
10666
10624
  defaultConfidence: number().min(0).max(1).optional(),
10667
10625
  /**
10626
+ * Per-MODEL default of the per-class confidence floors (`minConfidence<Macro>`
10627
+ * on a detector step), keyed by macro class: `{ person: 0.45 }`. A class
10628
+ * absent here runs at the step slider's global default. The same row shape
10629
+ * the floor measurement produces (`model-floors.json`: modelId → floors), so
10630
+ * a measured table is copied in as-is. An operator override is bound to the
10631
+ * model it was made for and does not survive a model change (D738). A custom
10632
+ * / imported model may declare it; without it, the global defaults apply.
10633
+ */
10634
+ defaultClassFloors: record(string(), number().min(0).max(1)).optional(),
10635
+ /**
10636
+ * The inference precision this model's OpenVINO IR needs on an Intel GPU.
10637
+ * Absent ⇒ the device default (f16 on a GPU). Set to `'f32'` for an FP32 IR
10638
+ * that produces invalid output at f16 — measured 2026-10-07 for YOLO26
10639
+ * base IRs (`yolo26s`: 0 true / 146 false positives; `yolo26m*`: NaN
10640
+ * scores) on the Core Ultra iGPU and the N100. Threaded to the pool as
10641
+ * `PoolModelConfig.gpuInferencePrecision`; the pool sets
10642
+ * INFERENCE_PRECISION_HINT on a GPU only. Costs ~60% latency on the GPU.
10643
+ */
10644
+ gpuInferencePrecision: _enum(["f32", "f16"]).optional(),
10645
+ /**
10646
+ * ROOT detectors only: per supplied step (`animal-classifier`, …), the
10647
+ * minimum DETECTION score from which this root's own fine label (species,
10648
+ * vehicle type — D736 root supply) is taken (D741). Below it the detection
10649
+ * keeps its macro class without the fine label. `1` = never take it from
10650
+ * this root. Absent ⇒ no floor beyond the macro floor. The supplied step's
10651
+ * `minConfidence` slider, bound to the ROOT model, overrides it.
10652
+ */
10653
+ suppliedLabelFloors: record(string(), number().min(0).max(1)).optional(),
10654
+ /**
10668
10655
  * When true, the executor produces a landmark-aligned crop (similarity warp
10669
10656
  * onto the canonical template) before this step runs, instead of a plain
10670
10657
  * axis-aligned bbox crop. Required for face-recognition embedders (ArcFace):
@@ -10726,6 +10713,16 @@ var ModelCatalogEntrySchema = object({
10726
10713
  */
10727
10714
  classMap: DetectionCatalogClassMapSchema.optional(),
10728
10715
  /**
10716
+ * The pipeline steps this ROOT detector can supply from its own output
10717
+ * (D730): its labels name a step's effect (`deer` for `animal-classifier`)
10718
+ * or draw a step's box (`license_plate` for `plate-detection`). Computed at
10719
+ * import from THIS model's labelmap by `deriveRootSupplies`, never written
10720
+ * by hand and never assumed per family; a row without it is derived on read
10721
+ * (`rootSuppliesOf`). Whether a camera uses it is the step's own
10722
+ * `useRootModel` flag (`resolveRootSupply`).
10723
+ */
10724
+ suppliesSteps: array(RootStepSupplySchema).readonly().optional(),
10725
+ /**
10729
10726
  * The model's CLIP feature-space contract (text encoder, dimension, vector
10730
10727
  * index, token window, search floor) — see `clip-model.ts`. Present ONLY on a
10731
10728
  * CLIP image encoder; its absence is what "not a CLIP model" means to the
@@ -12327,13 +12324,6 @@ var BrokerRtspClientSchema = object({
12327
12324
  lastRtpAt: number(),
12328
12325
  bytesSent: number()
12329
12326
  });
12330
- var BrokerDecodedClientSchema = object({
12331
- tag: string(),
12332
- subscribedAt: number(),
12333
- maxFps: number(),
12334
- framesDelivered: number(),
12335
- framesDropped: number()
12336
- });
12337
12327
  var BrokerAudioClientSchema = object({
12338
12328
  tag: string(),
12339
12329
  subscribedAt: number(),
@@ -12425,7 +12415,6 @@ var BrokerEncodedClientSchema = object({
12425
12415
  });
12426
12416
  var BrokerClientsSchema = object({
12427
12417
  rtsp: array(BrokerRtspClientSchema).readonly(),
12428
- decoded: array(BrokerDecodedClientSchema).readonly(),
12429
12418
  audio: array(BrokerAudioClientSchema).readonly(),
12430
12419
  encoded: array(BrokerEncodedClientSchema).readonly(),
12431
12420
  pipeClients: number(),
@@ -12794,11 +12783,7 @@ method(object({
12794
12783
  auth: "admin"
12795
12784
  }), method(object({ brokerId: string() }), BrokerClientsSchema), method(object({
12796
12785
  brokerId: string(),
12797
- channel: _enum([
12798
- "rtsp",
12799
- "decoded",
12800
- "audio"
12801
- ]),
12786
+ channel: _enum(["rtsp", "audio"]),
12802
12787
  handle: string()
12803
12788
  }), object({ killed: boolean() }), {
12804
12789
  kind: "mutation",
@@ -12833,10 +12818,7 @@ method(object({
12833
12818
  }), method(SubscribeAudioChunksInputSchema, SubscribeAudioChunksResultSchema, { kind: "mutation" }), method(object({
12834
12819
  subscriptionId: string(),
12835
12820
  maxCount: number().int().positive().default(8)
12836
- }), array(DecodedAudioChunkSchema).readonly()), method(object({ subscriptionId: string() }), object({ released: boolean() }), { kind: "mutation" }), method(SubscribeFramesInputSchema, SubscribeFramesResultSchema, { kind: "mutation" }), method(object({
12837
- subscriptionId: string(),
12838
- maxCount: number().int().positive().default(4)
12839
- }), array(FrameHandleSchema).readonly()), method(object({ subscriptionId: string() }), object({ released: boolean() }), { kind: "mutation" }), method(object({
12821
+ }), array(DecodedAudioChunkSchema).readonly()), method(object({ subscriptionId: string() }), object({ released: boolean() }), { kind: "mutation" }), method(object({
12840
12822
  brokerId: string(),
12841
12823
  seconds: number().min(0).max(30)
12842
12824
  }), _void(), {
@@ -14095,54 +14077,12 @@ id: union([string(), number()]) }), {
14095
14077
  kind: "mutation",
14096
14078
  auth: "admin"
14097
14079
  });
14098
- /**
14099
- * shm ring usage stats for a `frameSink: 'shm'` decoder session —
14100
- * exposed via `decoder.getShmStats` so downstream consumers can
14101
- * observe ring pressure (slot count, byte budget, hit/miss ratio).
14102
- */
14103
- var ShmRingStatsSchema = object({
14104
- sessionId: string(),
14105
- slotCount: number().int(),
14106
- slotByteLength: number().int(),
14107
- segmentBytes: number().int(),
14108
- budgetMb: number().int(),
14109
- framesWritten: number().int(),
14110
- getFrameHits: number().int(),
14111
- getFrameMisses: number().int()
14112
- });
14113
- method(object({ codec: string() }), boolean()), method(_void(), object({
14080
+ method(_void(), object({
14114
14081
  id: string(),
14115
14082
  name: string(),
14116
- isPullMode: boolean().optional(),
14117
- priority: number().optional(),
14118
14083
  hwaccel: string().optional(),
14119
14084
  probedBestHwaccel: string().optional()
14120
- })), method(DecoderSessionConfigSchema, object({
14121
- sessionId: string(),
14122
- nodeId: string()
14123
- })), method(object({ sessionId: string() }), _void()), method(object({
14124
- sessionId: string(),
14125
- packet: EncodedPacketSchema
14126
- }), _void()), method(object({
14127
- sessionId: string(),
14128
- url: string()
14129
- }), _void()), method(object({
14130
- sessionId: string(),
14131
- maxCount: number().default(1),
14132
- waitMs: number().optional()
14133
- }), array(DecodedFrameSchema)), method(object({
14134
- sessionId: string(),
14135
- maxCount: number().default(1),
14136
- waitMs: number().optional()
14137
- }), array(FrameHandleSchema)), method(object({ handle: FrameHandleSchema }), DecodedFrameSchema.nullable()), method(object({ sessionId: string() }), ShmRingStatsSchema.nullable()), method(object({
14138
- sessionId: string(),
14139
- config: DecoderSessionConfigSchema.partial()
14140
- }), _void()), method(object({ sessionId: string() }), DecoderStatsSchema), method(_void(), array(object({
14141
- sessionId: string(),
14142
- codec: string(),
14143
- outputFormat: string(),
14144
- createdAtMs: number()
14145
- })).readonly()), method(_void(), object({ backend: string() }), {
14085
+ })), method(_void(), object({ backend: string() }), {
14146
14086
  kind: "mutation",
14147
14087
  auth: "admin"
14148
14088
  });
@@ -16287,6 +16227,12 @@ method(_void(), array(string()).readonly(), { auth: "admin" }), method(object({
16287
16227
  kind: "mutation",
16288
16228
  auth: "admin"
16289
16229
  });
16230
+ var HUB_ADDRESS_ROLES = [
16231
+ "appConnections",
16232
+ "notificationTaps",
16233
+ "internal",
16234
+ "publicEndpoint"
16235
+ ];
16290
16236
  /**
16291
16237
  * Transport bounds for AI capability methods.
16292
16238
  *
@@ -18889,6 +18835,8 @@ var NcSystemEventKindSchema = _enum([
18889
18835
  "stream-offline",
18890
18836
  "node-online",
18891
18837
  "node-offline",
18838
+ "node-restarting",
18839
+ "node-updating",
18892
18840
  "node-inference-unavailable",
18893
18841
  "detection-blind",
18894
18842
  "addon-crash-loop",
@@ -20494,7 +20442,13 @@ var NcAlarmModeDelaysListSchema = array(object({
20494
20442
  * Absent = false (logged, not sent). Even when true it is not sent when that same sensor
20495
20443
  * is the one that starts the entry delay — the entry-delay notification already names it.
20496
20444
  */
20497
- notifySensorRewatched: boolean().optional()
20445
+ notifySensorRewatched: boolean().optional(),
20446
+ /**
20447
+ * D735: notify "ignored" when a sensor this arm bypassed really MOVED while armed (its own
20448
+ * change time is after the arm) and set nothing off. Absent = false (logged, not sent). A
20449
+ * re-sync, a recovery from `unavailable` or a duplicate is never announced, switch or not.
20450
+ */
20451
+ notifySensorIgnored: boolean().optional()
20498
20452
  })).max(8).refine(uniqueModes, { message: "modeDelays: at most one entry per arm mode" });
20499
20453
  var NcAlarmModeDelaysEditListSchema = array(object({
20500
20454
  mode: AlarmArmModeSchema,
@@ -20507,7 +20461,9 @@ var NcAlarmModeDelaysEditListSchema = array(object({
20507
20461
  /** D706: set the switch, or `null` to clear it (back to the default, false). */
20508
20462
  notifyDuringEntryDelay: boolean().nullable().optional(),
20509
20463
  /** D706: set the switch, or `null` to clear it (back to the default, false). */
20510
- notifySensorRewatched: boolean().nullable().optional()
20464
+ notifySensorRewatched: boolean().nullable().optional(),
20465
+ /** D735: set the switch, or `null` to clear it (back to the default, false). */
20466
+ notifySensorIgnored: boolean().nullable().optional()
20511
20467
  })).max(8).refine(uniqueModes, { message: "modeDelays: at most one edit per arm mode" });
20512
20468
  /** One switch of the alarm table: put ONE device on, or take it off, ONE mode's list. */
20513
20469
  var NcAlarmNonBlockingEditSchema = object({
@@ -21485,8 +21441,8 @@ Object.freeze(Object.fromEntries([{
21485
21441
  var CLUSTER_STEP_SETTING_FIELDS = [{
21486
21442
  stepId: "face-embedding",
21487
21443
  key: "minLandmarkFaceSize",
21488
- label: "Min face size for recognition (detection px)",
21489
- description: "Refuse to embed a face smaller than this IN THE DETECTION FRAME. Applies to every node — the enrolled gallery is one index, and two admission floors would fill it from two policies. 0 disables the gate.",
21444
+ label: "Min face size to embed (detection-frame px)",
21445
+ description: "Faces smaller than this in the small frame the detector sees are not embedded, so they can never be recognised. Below it the face cannot be aligned reliably and a bad embedding matches everyone. Same value on every node. 0 = no limit.",
21490
21446
  type: "slider",
21491
21447
  min: 0,
21492
21448
  max: 64,
@@ -23406,6 +23362,34 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
23406
23362
  timestamp: number()
23407
23363
  });
23408
23364
  /**
23365
+ * A root model's boxes standing in for one crop-kind step's own inference
23366
+ * (D730) — see `runPipeline.suppliedRoot`.
23367
+ */
23368
+ var SuppliedRootOutputSchema = object({
23369
+ stepId: string(),
23370
+ /** The root model that drew the boxes — stamped on the result. */
23371
+ modelId: string(),
23372
+ detections: array(object({
23373
+ /** `[x1, y1, x2, y2]` in the pixels of the call's image. */
23374
+ bbox: tuple([
23375
+ number(),
23376
+ number(),
23377
+ number(),
23378
+ number()
23379
+ ]),
23380
+ score: number(),
23381
+ /**
23382
+ * Five facial landmarks in the same pixels — a face the step's own
23383
+ * detector already re-found inside a root face box (D730), so its
23384
+ * embedder child aligns it exactly as it aligns any detected face.
23385
+ */
23386
+ landmarks: array(object({
23387
+ x: number(),
23388
+ y: number()
23389
+ })).optional()
23390
+ })).min(1)
23391
+ });
23392
+ /**
23409
23393
  * Reference to the frame's retained NATIVE surface + the parent crop's placement
23410
23394
  * within the frame, so the executor can re-cut a leaf child ROI at native
23411
23395
  * resolution on the detail plane. See the `runPipeline` `nativeCropRef` field.
@@ -23453,7 +23437,7 @@ var FrameRefSchema = object({
23453
23437
  timestamp: number(),
23454
23438
  capturedAt: number().optional()
23455
23439
  });
23456
- var ModelFormatSchema$1 = _enum([
23440
+ var ModelFormatSchema$2 = _enum([
23457
23441
  "onnx",
23458
23442
  "coreml",
23459
23443
  "openvino",
@@ -23471,7 +23455,7 @@ var PipelineSlotSchema = _enum([
23471
23455
  var PipelineEngineChoiceSchema = object({
23472
23456
  runtime: literal("python"),
23473
23457
  backend: string(),
23474
- format: ModelFormatSchema$1,
23458
+ format: ModelFormatSchema$2,
23475
23459
  device: string().optional()
23476
23460
  });
23477
23461
  /**
@@ -23510,32 +23494,15 @@ var PipelineDefaultStepSchema = lazy(() => object({
23510
23494
  group: string().optional(),
23511
23495
  settings: record(string(), unknown()).optional()
23512
23496
  }));
23513
- var PipelineTemplateStepSchema = lazy(() => object({
23514
- addonId: string(),
23515
- enabled: boolean(),
23516
- modelId: string(),
23517
- children: array(PipelineTemplateStepSchema).readonly(),
23518
- settings: record(string(), unknown()).optional()
23519
- }));
23520
- var PipelineTemplateSchema$1 = object({
23521
- id: string(),
23522
- name: string(),
23523
- createdAt: string(),
23524
- updatedAt: string(),
23525
- engine: PipelineEngineChoiceSchema,
23526
- steps: array(PipelineTemplateStepSchema).readonly()
23527
- });
23528
23497
  var PipelineModelOptionSchema = object({
23529
23498
  id: string(),
23530
23499
  name: string(),
23531
- formats: record(string(), object({
23532
- downloaded: boolean(),
23533
- sizeMB: number()
23534
- })),
23500
+ formats: record(string(), PipelineModelFormatStatusSchema),
23535
23501
  group: ModelVariantGroupSchema.optional(),
23536
23502
  legacy: boolean().optional(),
23537
23503
  provider: ModelProviderIdSchema.optional(),
23538
- defaultConfidence: number().optional()
23504
+ defaultConfidence: number().optional(),
23505
+ suppliesSteps: array(RootStepSupplySchema).readonly().optional()
23539
23506
  });
23540
23507
  var ConfigFieldBridge = custom();
23541
23508
  var PipelineAddonSchemaSchema = object({
@@ -23697,6 +23664,22 @@ method(_void(), array(PipelineEngineChoiceSchema)), method(_void(), PipelineEngi
23697
23664
  }), {
23698
23665
  kind: "mutation",
23699
23666
  auth: "admin"
23667
+ }), method(object({
23668
+ nodeId: string(),
23669
+ deviceIds: array(number()).readonly().optional(),
23670
+ dryRun: boolean()
23671
+ }), object({
23672
+ entries: array(object({
23673
+ deviceId: number(),
23674
+ keys: array(string()).readonly()
23675
+ })).readonly(),
23676
+ refused: array(object({
23677
+ deviceId: number(),
23678
+ reason: string()
23679
+ })).readonly()
23680
+ }), {
23681
+ kind: "mutation",
23682
+ auth: "admin"
23700
23683
  }), method(object({ nodeId: string() }), object({ unhealthy: array(object({
23701
23684
  /** `<backend>:<device>`, e.g. `openvino:gpu`. */
23702
23685
  deviceKey: string(),
@@ -23722,22 +23705,14 @@ method(_void(), array(PipelineEngineChoiceSchema)), method(_void(), PipelineEngi
23722
23705
  }), method(_void(), PipelineSchemaSchema), method(_void(), array(PipelineDefaultStepSchema).readonly().nullable()), method(_void(), PipelineConfigBridge), method(_void(), ConfigUISchemaBridge), method(object({
23723
23706
  steps: array(PipelineStepInputSchema),
23724
23707
  deviceKey: string().optional()
23725
- }), PipelineValidationResultSchema), method(_void(), array(PipelineTemplateSchema$1).readonly()), method(object({
23726
- name: string(),
23727
- steps: array(PipelineTemplateStepSchema).readonly(),
23728
- engine: PipelineEngineChoiceSchema
23729
- }), PipelineTemplateSchema$1, { kind: "mutation" }), method(object({
23730
- id: string(),
23731
- name: string().optional(),
23732
- steps: array(PipelineTemplateStepSchema).readonly().optional()
23733
- }), PipelineTemplateSchema$1, { kind: "mutation" }), method(object({ id: string() }), _void(), { kind: "mutation" }), method(_void(), InferenceCapabilitiesBridge), method(object({ addonId: string() }), ModelAvailabilityListBridge), method(object({
23708
+ }), PipelineValidationResultSchema), method(_void(), InferenceCapabilitiesBridge), method(object({ addonId: string() }), ModelAvailabilityListBridge), method(object({
23734
23709
  addonId: string(),
23735
23710
  modelId: string(),
23736
- format: ModelFormatSchema$1
23711
+ format: ModelFormatSchema$2
23737
23712
  }), DownloadModelResultSchema, { kind: "mutation" }), method(object({
23738
23713
  addonId: string(),
23739
23714
  modelId: string(),
23740
- format: ModelFormatSchema$1
23715
+ format: ModelFormatSchema$2
23741
23716
  }), object({ success: literal(true) }), { kind: "mutation" }), method(object({
23742
23717
  steps: array(PipelineStepInputSchema).min(1),
23743
23718
  frame: FrameInputSchema.optional(),
@@ -23803,7 +23778,16 @@ method(_void(), array(PipelineEngineChoiceSchema)), method(_void(), PipelineEngi
23803
23778
  * `device-not-servable`), and nothing reaches the camera's live
23804
23779
  * trace stream. Absent ⇒ unchanged behaviour.
23805
23780
  */
23806
- replay: literal(true).optional()
23781
+ replay: literal(true).optional(),
23782
+ /**
23783
+ * Root-supplied detections for the tree's ROOT step (D730). Set by
23784
+ * `runDetailSubtree` when the camera's root model supplies a crop-kind
23785
+ * step (a Frigate+ `license_plate` for `plate-detection`): the step is
23786
+ * NOT inferred, these boxes are its output, and its children (the plate
23787
+ * reader) run on them through their own crop policy. Boxes are in the
23788
+ * PIXELS of the image this call carries. Absent ⇒ the root step runs.
23789
+ */
23790
+ suppliedRoot: SuppliedRootOutputSchema.optional()
23807
23791
  }), PipelineRunResultBridge, { kind: "mutation" }), method(object({
23808
23792
  steps: array(PipelineStepInputSchema).min(1),
23809
23793
  frames: array(FrameInputSchema).min(1).max(255),
@@ -23885,6 +23869,375 @@ method(_void(), array(PipelineEngineChoiceSchema)), method(_void(), PipelineEngi
23885
23869
  filename: string().optional(),
23886
23870
  settings: record(string(), unknown()).optional()
23887
23871
  }), AudioTestResultSchema, { kind: "mutation" }), method(_void(), ConfigUISchemaNullableBridge);
23872
+ /**
23873
+ * The wire shapes of the Auto tune plan and apply (D745), used by the
23874
+ * `pipeline-orchestrator` cap. The recommender's own types
23875
+ * (`recommend.ts`) are the TS face of the same data; these
23876
+ * schemas are what crosses the cap boundary.
23877
+ */
23878
+ var ModelFormatSchema$1 = _enum(MODEL_FORMATS);
23879
+ /** The operator's range for it. */
23880
+ var MIN_SESSIONS_PER_DEVICE_RANGE = {
23881
+ min: 1,
23882
+ max: 8
23883
+ };
23884
+ var HardwareClassIdSchema = _enum([
23885
+ "intel-core-ultra",
23886
+ "intel-n-series",
23887
+ "apple-m-base",
23888
+ "apple-m-pro",
23889
+ "unknown"
23890
+ ]);
23891
+ var AcceleratorKindSchema = _enum([
23892
+ "intel-npu",
23893
+ "intel-igpu",
23894
+ "x86-cpu",
23895
+ "arm-cpu",
23896
+ "apple-ane",
23897
+ "coral"
23898
+ ]);
23899
+ var RecommendationReasonSchema = discriminatedUnion("kind", [
23900
+ object({
23901
+ kind: literal("capacity"),
23902
+ sessions: number(),
23903
+ minSessions: number()
23904
+ }),
23905
+ object({
23906
+ kind: literal("tie-faster"),
23907
+ over: string(),
23908
+ recallDelta: number()
23909
+ }),
23910
+ object({
23911
+ kind: literal("stepped-down"),
23912
+ from: string(),
23913
+ to: string(),
23914
+ limitedBy: string()
23915
+ }),
23916
+ object({
23917
+ kind: literal("no-fit-lightest"),
23918
+ sessions: number(),
23919
+ minSessions: number()
23920
+ }),
23921
+ object({
23922
+ kind: literal("derived-latency"),
23923
+ modelId: string()
23924
+ }),
23925
+ object({ kind: literal("cpu-device") }),
23926
+ object({ kind: literal("coral-untouched") }),
23927
+ object({ kind: literal("device-disabled") }),
23928
+ object({ kind: literal("device-unavailable") }),
23929
+ object({ kind: literal("node-offline") }),
23930
+ object({ kind: literal("no-hardware-facts") }),
23931
+ object({
23932
+ kind: literal("no-measured-data"),
23933
+ hardwareClass: HardwareClassIdSchema
23934
+ }),
23935
+ object({
23936
+ kind: literal("no-family-build"),
23937
+ format: ModelFormatSchema$1
23938
+ })
23939
+ ]);
23940
+ var DeviceModelChoiceSchema = object({
23941
+ modelId: string(),
23942
+ p50Ms: number(),
23943
+ fps: number(),
23944
+ measured: boolean(),
23945
+ /** Parallel sessions at the camera rate with the headroom kept free: ⌊fps × (1 − headroom) / camera fps⌋. */
23946
+ capacitySessions: number(),
23947
+ personRecall: number()
23948
+ });
23949
+ var DeviceRecommendationSchema = object({
23950
+ deviceKey: string(),
23951
+ accelerator: AcceleratorKindSchema.nullable(),
23952
+ enabled: boolean(),
23953
+ available: boolean(),
23954
+ chosen: DeviceModelChoiceSchema.nullable(),
23955
+ reasons: array(RecommendationReasonSchema).readonly()
23956
+ });
23957
+ var NodeRecommendationSchema = object({
23958
+ nodeId: string(),
23959
+ reachable: boolean(),
23960
+ hardwareClass: HardwareClassIdSchema.nullable(),
23961
+ cpuModel: string().nullable(),
23962
+ skipped: boolean(),
23963
+ acceleratorModelId: string().nullable(),
23964
+ devices: array(DeviceRecommendationSchema).readonly(),
23965
+ reasons: array(RecommendationReasonSchema).readonly()
23966
+ });
23967
+ var ModelPinChangeSchema = object({
23968
+ stepId: string(),
23969
+ before: string().nullable(),
23970
+ after: string().nullable()
23971
+ });
23972
+ var NodeDeviceChangeSchema = object({
23973
+ nodeId: string(),
23974
+ deviceKey: string(),
23975
+ madeExplicit: boolean(),
23976
+ modelPins: array(ModelPinChangeSchema).readonly(),
23977
+ thresholds: array(object({
23978
+ stepId: string(),
23979
+ keys: array(string()).readonly()
23980
+ })).readonly()
23981
+ });
23982
+ var CameraOverrideClearSchema = object({
23983
+ deviceId: number(),
23984
+ source: _enum(["step-override", "wholesale"]),
23985
+ nodeId: string(),
23986
+ deviceKey: string().nullable(),
23987
+ stepId: string(),
23988
+ modelIdBefore: string().nullable(),
23989
+ keys: array(string()).readonly()
23990
+ });
23991
+ var DetectorStoreClearSchema = object({
23992
+ deviceId: number(),
23993
+ keys: array(string()).readonly()
23994
+ });
23995
+ var AutoTuneWarningSchema = discriminatedUnion("kind", [
23996
+ object({
23997
+ kind: literal("detector-store-cluster-wide"),
23998
+ skippedNodes: array(string()).readonly()
23999
+ }),
24000
+ object({
24001
+ kind: literal("detector-store-unreadable"),
24002
+ error: string()
24003
+ }),
24004
+ object({
24005
+ kind: literal("coral-enabled"),
24006
+ nodeId: string(),
24007
+ deviceKey: string()
24008
+ })
24009
+ ]);
24010
+ var AutoTuneOptionsSchema = object({
24011
+ /** Share of each accelerator's throughput kept free (0.3–0.5). */
24012
+ headroom: number().min(.3).max(.5).default(.4),
24013
+ /**
24014
+ * The least number of parallel sessions every device must sustain at the
24015
+ * camera rate with the headroom kept free (D755). The most accurate model
24016
+ * that reaches it wins.
24017
+ */
24018
+ minSessionsPerDevice: number().int().min(MIN_SESSIONS_PER_DEVICE_RANGE.min).max(MIN_SESSIONS_PER_DEVICE_RANGE.max).default(2)
24019
+ });
24020
+ var AutoTunePlanSchema = object({
24021
+ /** Hash of everything the apply will write — the apply refuses a different one. */
24022
+ planHash: string(),
24023
+ family: literal("yolov9"),
24024
+ headroom: number(),
24025
+ minSessionsPerDevice: number(),
24026
+ /** The detection rate a session is counted at (the fastest camera running the pipeline root). */
24027
+ cameraFps: number(),
24028
+ generatedAt: number(),
24029
+ nodes: array(NodeRecommendationSchema).readonly(),
24030
+ nodeChanges: array(NodeDeviceChangeSchema).readonly(),
24031
+ cameraClears: array(CameraOverrideClearSchema).readonly(),
24032
+ detectorStoreClears: array(DetectorStoreClearSchema).readonly(),
24033
+ warnings: array(AutoTuneWarningSchema).readonly()
24034
+ });
24035
+ var AutoTuneApplyInputSchema = object({
24036
+ planHash: string(),
24037
+ headroom: number().min(.3).max(.5).default(.4),
24038
+ minSessionsPerDevice: number().int().min(MIN_SESSIONS_PER_DEVICE_RANGE.min).max(MIN_SESSIONS_PER_DEVICE_RANGE.max).default(2)
24039
+ });
24040
+ var AutoTunePhaseResultSchema = object({
24041
+ phase: _enum([
24042
+ "download",
24043
+ "camera-overrides",
24044
+ "detector-thresholds",
24045
+ "node-models",
24046
+ "redispatch"
24047
+ ]),
24048
+ ok: boolean(),
24049
+ detail: string()
24050
+ });
24051
+ var AutoTuneApplyResultSchema = discriminatedUnion("kind", [
24052
+ object({
24053
+ kind: literal("applied"),
24054
+ planHash: string(),
24055
+ phases: array(AutoTunePhaseResultSchema).readonly()
24056
+ }),
24057
+ object({
24058
+ kind: literal("aborted"),
24059
+ phases: array(AutoTunePhaseResultSchema).readonly()
24060
+ }),
24061
+ object({
24062
+ kind: literal("stale"),
24063
+ plan: AutoTunePlanSchema
24064
+ }),
24065
+ object({
24066
+ kind: literal("refused"),
24067
+ reason: _enum(["apply-in-progress"])
24068
+ })
24069
+ ]);
24070
+ /**
24071
+ * Wire shapes of the Load balancing surface (D748): the session placement
24072
+ * policy, the atomic share write, the observed placement statistics, the
24073
+ * hardware share suggestion and the stale device pins.
24074
+ */
24075
+ /**
24076
+ * How a new detection session picks its node and device.
24077
+ * - `least-loaded` — the historical rule: lowest `attached / weight`, a
24078
+ * constant node order at a tie (D37). An idle node always ties at 0, so a
24079
+ * weight only bites once a node already holds a session.
24080
+ * - `share` — the share of PARALLEL sessions is held to the weights, and a
24081
+ * full or drowning node yields to a free one (D748).
24082
+ */
24083
+ var SessionPlacementPolicySchema = _enum(["least-loaded", "share"]);
24084
+ var LoadBalancingSharesInputSchema = object({
24085
+ /** nodeId → share (> 0). A node left out keeps its weight. */
24086
+ nodes: record(string(), number().positive()).default({}),
24087
+ /** nodeId → deviceKey → share (> 0). A device left out keeps its weight. */
24088
+ devices: record(string(), record(string(), number().positive())).default({})
24089
+ });
24090
+ var PlacementStatsInputSchema = object({
24091
+ /** Window the observed shares are averaged over (default 1 h, max 24 h). */
24092
+ windowMs: number().int().min(6e4).max(1440 * 60 * 1e3).default(3600 * 1e3) });
24093
+ var PlacementDeviceStatsSchema = object({
24094
+ deviceKey: string(),
24095
+ /** Sessions running on this device now. */
24096
+ sessionsNow: number(),
24097
+ /** Sessions started on this device inside the window. */
24098
+ sessionsStarted: number(),
24099
+ /** Time-weighted share of the node's parallel sessions over the window (0–1); null = no session ran. */
24100
+ observedShare: number().nullable()
24101
+ });
24102
+ var PlacementNodeStatsSchema = object({
24103
+ nodeId: string(),
24104
+ sessionsNow: number(),
24105
+ sessionsStarted: number(),
24106
+ /** Time-weighted share of the cluster's parallel sessions over the window (0–1); null = none ran. */
24107
+ observedShare: number().nullable(),
24108
+ /** Most sessions this node ran at once inside the window. */
24109
+ peakSessions: number(),
24110
+ /** Sessions a share election handed elsewhere because this node was full or drowning. */
24111
+ yieldsAway: number(),
24112
+ devices: array(PlacementDeviceStatsSchema).readonly()
24113
+ });
24114
+ /** A camera's device pin that the session path cannot honour. */
24115
+ var StaleDevicePinSchema = object({
24116
+ deviceId: number(),
24117
+ deviceKey: string(),
24118
+ /** `disabled` — the key exists on some node but is not enabled anywhere; `absent` — no node has it. */
24119
+ reason: _enum(["disabled", "absent"])
24120
+ });
24121
+ var PlacementStatsSchema = object({
24122
+ policy: SessionPlacementPolicySchema,
24123
+ windowMs: number(),
24124
+ /** How much of the window was actually observed (the hub keeps it in memory). */
24125
+ observedForMs: number(),
24126
+ sessionsNow: number(),
24127
+ /** Most parallel sessions across the cluster inside the window. */
24128
+ clusterPeakSessions: number(),
24129
+ nodes: array(PlacementNodeStatsSchema).readonly(),
24130
+ stalePins: array(StaleDevicePinSchema).readonly()
24131
+ });
24132
+ /**
24133
+ * Where an automatic share's capacity comes from (D755).
24134
+ * - `hardware` — the static capacity of each device at its Auto tune model:
24135
+ * the measured latency table for the node's hardware class.
24136
+ * - `benchmark` — the node's own measured capacity (node benchmark results).
24137
+ * A node with no results falls back to `hardware`, and says so.
24138
+ */
24139
+ var CapacitySourceSchema = _enum(["hardware", "benchmark"]);
24140
+ /** Why a node under the `benchmark` source was sized from hardware instead. */
24141
+ var CapacityFallbackSchema = _enum(["no-benchmark-results", "partial-benchmark-results"]);
24142
+ var SuggestSharesInputSchema = object({
24143
+ headroom: number().min(.3).max(.5).default(.4),
24144
+ /** Default `hardware`. */
24145
+ source: CapacitySourceSchema.default("hardware")
24146
+ });
24147
+ var SuggestedDeviceShareSchema = object({
24148
+ deviceKey: string(),
24149
+ /** Share of the node (0–100, rounded). */
24150
+ share: number(),
24151
+ modelId: string().nullable(),
24152
+ /** Inferences per second at that model, from the measured table; null when sized by a benchmark. */
24153
+ fps: number().nullable(),
24154
+ /** False for a table cell derived from another chip; true for a measured cell or a benchmark. */
24155
+ measured: boolean(),
24156
+ /**
24157
+ * Advisory session cap: ⌊fps × (1 − headroom) / camera fps⌋ from the table,
24158
+ * or the benchmark's measured max sessions. Never enforced.
24159
+ */
24160
+ suggestedMaxSessions: number().nullable()
24161
+ });
24162
+ var SuggestedNodeShareSchema = object({
24163
+ nodeId: string(),
24164
+ /** Share of the cluster (0–100, rounded); null = node skipped (offline, unknown hardware). */
24165
+ share: number().nullable(),
24166
+ /** Parallel sessions the node sustains at the suggested models with the headroom kept free. */
24167
+ capacitySessions: number(),
24168
+ devices: array(SuggestedDeviceShareSchema).readonly(),
24169
+ skippedReason: string().nullable(),
24170
+ /** What this node's capacity was read from; null when the node is skipped. */
24171
+ capacitySource: CapacitySourceSchema.nullable(),
24172
+ /** Set when the `benchmark` source was asked for and this node used `hardware`. */
24173
+ capacityFallback: CapacityFallbackSchema.nullable()
24174
+ });
24175
+ var SuggestSharesResultSchema = object({
24176
+ headroom: number(),
24177
+ /** The source asked for; each node says what it actually used. */
24178
+ source: CapacitySourceSchema,
24179
+ /** Camera detection rate the capacity is counted in (the fastest camera's fps). */
24180
+ cameraFps: number(),
24181
+ /** The Auto tune capacity floor the models were picked at. */
24182
+ minSessionsPerDevice: number(),
24183
+ nodes: array(SuggestedNodeShareSchema).readonly()
24184
+ });
24185
+ /**
24186
+ * Where the node and device shares come from (D750, D755).
24187
+ * - `hardware` (default) — computed by the system from each node's static
24188
+ * capacity (its accelerators at their Auto tune models, from the measured
24189
+ * latency table), recomputed whenever a node or device joins, leaves, is
24190
+ * switched on or off, or changes model. No load input.
24191
+ * - `benchmark` — the same, from each node's measured capacity (node
24192
+ * benchmark results); a node without results falls back to `hardware`.
24193
+ * - `manual` — the operator's stored sliders.
24194
+ * Either way a node or device that cannot take sessions gives its share to
24195
+ * the others in proportion; the stored values are never rewritten for that.
24196
+ */
24197
+ var ShareSourceSchema = _enum([
24198
+ "hardware",
24199
+ "benchmark",
24200
+ "manual"
24201
+ ]);
24202
+ var SetShareSourceInputSchema = object({ source: ShareSourceSchema });
24203
+ object({
24204
+ nodes: record(string(), number()),
24205
+ devices: record(string(), record(string(), number()))
24206
+ });
24207
+ var EffectiveDeviceShareSchema = object({
24208
+ deviceKey: string(),
24209
+ /** Can take sessions now (enabled, available, can run the root). */
24210
+ eligible: boolean(),
24211
+ /** The share the source assigns, as a percentage of the node's devices. */
24212
+ configuredPct: number(),
24213
+ /** The share actually used, after an ineligible device's share went to the others. */
24214
+ effectivePct: number()
24215
+ });
24216
+ var EffectiveNodeShareSchema = object({
24217
+ nodeId: string(),
24218
+ eligible: boolean(),
24219
+ configuredPct: number(),
24220
+ effectivePct: number(),
24221
+ /** Automatic sources: what this node's share was computed from; null under `manual` or before the first answer. */
24222
+ capacitySource: CapacitySourceSchema.nullable(),
24223
+ /** Automatic `benchmark`: why this node used `hardware` instead. */
24224
+ capacityFallback: CapacityFallbackSchema.nullable(),
24225
+ devices: array(EffectiveDeviceShareSchema).readonly()
24226
+ });
24227
+ var EffectiveSharesSchema = object({
24228
+ source: ShareSourceSchema,
24229
+ policy: SessionPlacementPolicySchema,
24230
+ /** An automatic source with no computed answer yet: the stored sliders are used meanwhile. */
24231
+ autoPending: boolean(),
24232
+ /** When the automatic shares were last computed (ms epoch); null = never. */
24233
+ computedAt: number().nullable(),
24234
+ /** What made the system recompute them last. */
24235
+ trigger: string().nullable(),
24236
+ nodes: array(EffectiveNodeShareSchema).readonly(),
24237
+ /** The relative weights the election reads (before eligibility). */
24238
+ nodeWeights: record(string(), number()),
24239
+ deviceWeights: record(string(), record(string(), number()))
24240
+ });
23888
24241
  object({
23889
24242
  activeCameras: number(),
23890
24243
  throttledCameras: number(),
@@ -24802,14 +25155,15 @@ var RunnerLocalLoadSchema = object({
24802
25155
  * Per-inference-device live load (multi-device C4). One entry per deviceKey
24803
25156
  * this runner currently has attached cameras on, so the orchestrator's second
24804
25157
  * `balance()` pass (over a node's devices) weights on real per-pool session
24805
- * counts. Empty on single-device / pre-multi-device runners. `queueDepthTotal`
24806
- * per device is 0 until the pool backlog gets a public accessor (follow-up).
25158
+ * counts. Empty on single-device / pre-multi-device runners. There is no
25159
+ * per-device queue depth: the inference pool's backlog has no accessor, and
25160
+ * a field that always read 0 was removed rather than shown as a measurement
25161
+ * (D762).
24807
25162
  */
24808
25163
  devices: array(object({
24809
25164
  deviceKey: string(),
24810
25165
  backend: string(),
24811
- attachedCameras: number(),
24812
- queueDepthTotal: number()
25166
+ attachedCameras: number()
24813
25167
  })).default([]),
24814
25168
  /** Hardware capability flags reported by this node. */
24815
25169
  hardware: object({
@@ -24945,7 +25299,22 @@ method(RunnerCameraConfigSchema, object({ success: literal(true) }), { kind: "mu
24945
25299
  */
24946
25300
  cropJpeg: string().optional(),
24947
25301
  parent: DetailParentSchema,
24948
- steps: array(string()).optional()
25302
+ steps: array(string()).optional(),
25303
+ /**
25304
+ * The camera's root model already drew this step's boxes (D730): a
25305
+ * `license_plate` inside the parent vehicle. The named step is NOT
25306
+ * inferred — these FRAME-space boxes are its output — and its
25307
+ * requested children (the plate reader) run on them. Absent ⇒ every
25308
+ * requested step infers as before.
25309
+ */
25310
+ supplied: object({
25311
+ stepId: string(),
25312
+ modelId: string(),
25313
+ boxes: array(object({
25314
+ bbox: NativeCropBboxSchema,
25315
+ score: number()
25316
+ })).min(1)
25317
+ }).optional()
24949
25318
  }), object({ details: array(DetailResultSchema) }).nullable(), { kind: "mutation" }), method(object({
24950
25319
  /** Catalog step id, e.g. `clip-embedding`. */
24951
25320
  stepId: string(),
@@ -25008,14 +25377,6 @@ var CameraPipelineConfigSchema = object({
25008
25377
  settings: record(string(), unknown()).readonly().optional()
25009
25378
  }).nullable().optional()
25010
25379
  });
25011
- var PipelineTemplateSchema = object({
25012
- id: string(),
25013
- name: string(),
25014
- description: string().optional(),
25015
- config: CameraPipelineConfigSchema,
25016
- createdAt: string(),
25017
- updatedAt: string()
25018
- });
25019
25380
  var DeviceStepConfigSchema = object({
25020
25381
  modelId: string().optional(),
25021
25382
  settings: record(string(), unknown()).optional(),
@@ -25089,9 +25450,10 @@ var CameraStepOverridePatchSchema = object({
25089
25450
  modelId: string().optional(),
25090
25451
  settings: record(string(), unknown()).readonly().optional()
25091
25452
  });
25453
+ var CameraStepSettingsSchema = record(string(), record(string(), unknown()).readonly());
25092
25454
  var CameraPipelineSettingsSchema = object({
25093
- pinnedAgentNodeId: string().optional(),
25094
25455
  stepToggles: record(string(), boolean()).optional(),
25456
+ stepSettings: CameraStepSettingsSchema.optional(),
25095
25457
  stepOverridesByDevice: record(string(), record(string(), record(string(), CameraStepOverridePatchSchema))).optional(),
25096
25458
  pipelineByAgent: record(string(), CameraPipelineForAgentSchema).optional()
25097
25459
  });
@@ -25124,7 +25486,10 @@ var PipelineAssignmentSchema = object({
25124
25486
  });
25125
25487
  /**
25126
25488
  * Per-agent load summary surfaced to the load balancer + dashboards.
25127
- * Aggregated from each runner's `getLocalLoad` cap call.
25489
+ * Aggregated from each runner's `getLocalLoad` cap call. In the
25490
+ * `getAgentLoad` report, a single-device node's default-pool sessions (no
25491
+ * `deviceKey`) are credited to its one eligible device in `load.devices` —
25492
+ * the default pool IS that device (D745); the balancer's census stays raw.
25128
25493
  */
25129
25494
  var AgentLoadSummarySchema = object({
25130
25495
  nodeId: string(),
@@ -25213,26 +25578,27 @@ var CameraBrokerStatusSchema = object({
25213
25578
  width: number(),
25214
25579
  height: number(),
25215
25580
  subscribers: number(),
25216
- inFps: number(),
25217
- outFps: number()
25581
+ /**
25582
+ * Encoded packets/s the broker receives from the camera. null when the
25583
+ * broker's stats read failed — unknown, never 0 (a 0 here reads as a stall).
25584
+ * There is no output rate: decoding runs in the session decode workers, not
25585
+ * in the broker, so the broker's own decoded-frame rate is 0 on every live
25586
+ * camera and is not served (D758).
25587
+ */
25588
+ inFps: number().nullable()
25218
25589
  })).readonly(),
25219
25590
  webrtcSessions: number(),
25220
25591
  rtspRestream: boolean()
25221
25592
  });
25222
- /** Shared-memory ring statistics within the decoder block. */
25223
- var CameraDecoderShmSchema = object({
25224
- framesWritten: number(),
25225
- getFrameHits: number(),
25226
- getFrameMisses: number(),
25227
- budgetMb: number()
25228
- });
25229
- /** Decoder block — null when the decoder stage is unreachable or inactive. */
25230
- var CameraDecoderStatusSchema = object({
25231
- nodeId: string(),
25232
- formats: array(string()).readonly(),
25233
- sessionCount: number(),
25234
- shm: CameraDecoderShmSchema
25235
- });
25593
+ /**
25594
+ * Decoder block — WHERE decode runs (co-located with the detection node by
25595
+ * construction); null when the camera has no detection node. It carries no
25596
+ * frame counter: the shared-memory plane whose counters it used to serve is
25597
+ * gone, and those fields read 0 forever. Whether frames actually flow is read
25598
+ * from `detection.actualFps` (frames delivered to and processed by the
25599
+ * detector), never from a counter nothing feeds.
25600
+ */
25601
+ var CameraDecoderStatusSchema = object({ nodeId: string() });
25236
25602
  /** Motion block — null when motion detection is not active for this device. */
25237
25603
  var CameraMotionStatusSchema = object({
25238
25604
  enabled: boolean(),
@@ -25589,12 +25955,6 @@ method(object({
25589
25955
  }), object({ success: literal(true) }), {
25590
25956
  kind: "mutation",
25591
25957
  auth: "admin"
25592
- }), method(object({
25593
- agentNodeId: string(),
25594
- detectWeight: number().positive().nullable()
25595
- }), object({ success: literal(true) }), {
25596
- kind: "mutation",
25597
- auth: "admin"
25598
25958
  }), method(object({
25599
25959
  agentNodeId: string(),
25600
25960
  detect: boolean().nullable().optional(),
@@ -25636,6 +25996,15 @@ method(object({
25636
25996
  }), {
25637
25997
  kind: "mutation",
25638
25998
  auth: "admin"
25999
+ }), method(AutoTuneOptionsSchema, AutoTunePlanSchema, { auth: "admin" }), method(AutoTuneApplyInputSchema, AutoTuneApplyResultSchema, {
26000
+ kind: "mutation",
26001
+ auth: "admin"
26002
+ }), method(LoadBalancingSharesInputSchema, object({ success: literal(true) }), {
26003
+ kind: "mutation",
26004
+ auth: "admin"
26005
+ }), method(PlacementStatsInputSchema, PlacementStatsSchema, { auth: "admin" }), method(SuggestSharesInputSchema, SuggestSharesResultSchema, { auth: "admin" }), method(_void(), EffectiveSharesSchema, { auth: "admin" }), method(SetShareSourceInputSchema, object({ success: literal(true) }), {
26006
+ kind: "mutation",
26007
+ auth: "admin"
25639
26008
  }), method(object({ deviceId: number() }), CameraPipelineSettingsSchema.nullable()), method(object({
25640
26009
  deviceId: number(),
25641
26010
  addonId: string(),
@@ -25652,6 +26021,13 @@ method(object({
25652
26021
  }), object({ success: literal(true) }), {
25653
26022
  kind: "mutation",
25654
26023
  auth: "admin"
26024
+ }), method(object({
26025
+ deviceId: number(),
26026
+ addonId: string(),
26027
+ settings: record(string(), unknown()).nullable()
26028
+ }), object({ success: literal(true) }), {
26029
+ kind: "mutation",
26030
+ auth: "admin"
25655
26031
  }), method(object({
25656
26032
  deviceId: number(),
25657
26033
  agentNodeId: string(),
@@ -25675,25 +26051,7 @@ method(object({
25675
26051
  }), method(_void(), DiskReconcileJobSchema, {
25676
26052
  kind: "mutation",
25677
26053
  auth: "admin"
25678
- }), method(_void(), DiskReconcileJobSchema, { auth: "admin" }), method(_void(), array(PipelineTemplateSchema).readonly()), method(object({
25679
- name: string(),
25680
- description: string().optional(),
25681
- config: CameraPipelineConfigSchema
25682
- }), PipelineTemplateSchema, {
25683
- kind: "mutation",
25684
- auth: "admin"
25685
- }), method(object({
25686
- id: string(),
25687
- name: string().optional(),
25688
- description: string().optional(),
25689
- config: CameraPipelineConfigSchema.optional()
25690
- }), PipelineTemplateSchema, {
25691
- kind: "mutation",
25692
- auth: "admin"
25693
- }), method(object({ id: string() }), object({ success: literal(true) }), {
25694
- kind: "mutation",
25695
- auth: "admin"
25696
- });
26054
+ }), method(_void(), DiskReconcileJobSchema, { auth: "admin" });
25697
26055
  /**
25698
26056
  * Cap → event-kind mapping for the SENSOR / CONTROL cap families — the table
25699
26057
  * `pipeline-analytics.listEventKinds` uses to turn a linked device's bound
@@ -27942,8 +28300,6 @@ var WebrtcStreamChoiceSchema = object({
27942
28300
  ]).nullable(),
27943
28301
  /** Input FPS from the camera (null for adaptive). */
27944
28302
  inputFps: number().nullable(),
27945
- /** Decoded FPS (null for adaptive). */
27946
- decodeFps: number().nullable(),
27947
28303
  /** Bitrate in kbps (null for adaptive). */
27948
28304
  bitrateKbps: number().nullable()
27949
28305
  });
@@ -28275,6 +28631,14 @@ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), ar
28275
28631
  */
28276
28632
  alive: boolean()
28277
28633
  })), method(object({
28634
+ deviceId: number().int().nonnegative(),
28635
+ sessionId: string(),
28636
+ downlinkMbps: number().nonnegative()
28637
+ }), object({
28638
+ outcome: _enum(["switching", "held"]),
28639
+ tier: CamProfileSchema.nullable(),
28640
+ reason: string()
28641
+ }), { kind: "mutation" }), method(object({
28278
28642
  deviceId: number().int().nonnegative(),
28279
28643
  sessionId: string()
28280
28644
  }), WebrtcSessionDebugSchema, { kind: "query" });
@@ -32086,7 +32450,8 @@ var ConnectionEndpointSchema = object({
32086
32450
  "lan-ipv6",
32087
32451
  "public",
32088
32452
  "loopback",
32089
- "app-link"
32453
+ "app-link",
32454
+ "custom"
32090
32455
  ]),
32091
32456
  /**
32092
32457
  * Originating-interface kind — `lan`/`wifi`/`docker`/`vpn`/`other`/
@@ -32155,7 +32520,7 @@ var GetConnectionEndpointsResultSchema = object({
32155
32520
  localPort: AdvertisedLocalPortSchema
32156
32521
  });
32157
32522
  /**
32158
- * The address flagged for notification links. `baseUrl: null` = AUTO, which
32523
+ * The address flagged for notification taps (`notificationTaps`). `baseUrl: null` = AUTO, which
32159
32524
  * since D709 is the CamStack app link; `resolved` reports the effective value,
32160
32525
  * so the UI can show it either way.
32161
32526
  */
@@ -32188,6 +32553,72 @@ var ViewerEndpointsSchema = object({
32188
32553
  /** What the ranking currently resolves to (may be empty if nothing is up). */
32189
32554
  resolved: array(string()).readonly()
32190
32555
  });
32556
+ /**
32557
+ * DEPRECATED compatibility shape of `getHubAddresses` (D729 amendment, kept
32558
+ * for addons built against it): `cluster` is the `internal` role, `browser`
32559
+ * the `publicEndpoint` role; `override` is the flagged address.
32560
+ */
32561
+ var HubAddressSnapshotSchema = object({
32562
+ override: string().nullable(),
32563
+ resolved: string().nullable(),
32564
+ source: _enum([
32565
+ "override",
32566
+ "auto",
32567
+ "none"
32568
+ ])
32569
+ });
32570
+ var HubAddressesSchema = object({
32571
+ cluster: HubAddressSnapshotSchema,
32572
+ browser: HubAddressSnapshotSchema
32573
+ });
32574
+ /**
32575
+ * What an address is used for (`hub-address.ts`, D734). `appConnections` is
32576
+ * many-valued; `notificationTaps`, `publicEndpoint` and `internal` are carried
32577
+ * by at most one address.
32578
+ */
32579
+ var HubAddressRoleSchema = _enum(HUB_ADDRESS_ROLES);
32580
+ var RoleSourceSchema = _enum([
32581
+ "flagged",
32582
+ "auto",
32583
+ "none"
32584
+ ]);
32585
+ /** One single-valued role: the flagged address, the one in use, and why. */
32586
+ var HubAddressRoleResolutionSchema = object({
32587
+ /** The address carrying the flag, or null = automatic. */
32588
+ flagged: string().nullable(),
32589
+ /** The address in use, or null when nothing qualifies (never loopback). */
32590
+ resolved: string().nullable(),
32591
+ source: RoleSourceSchema
32592
+ });
32593
+ var HubAppConnectionsResolutionSchema = object({
32594
+ /** The addresses flagged `appConnections`, or empty = automatic. */
32595
+ flagged: array(string()).readonly(),
32596
+ /** What the apps race right now. */
32597
+ resolved: array(string()).readonly(),
32598
+ source: RoleSourceSchema
32599
+ });
32600
+ var HubAddressBookSchema = object({
32601
+ rows: array(ConnectionEndpointSchema.extend({
32602
+ /** In the hub's detected palette right now. */
32603
+ detected: boolean(),
32604
+ /** Entered by the operator (removable). */
32605
+ custom: boolean(),
32606
+ /** The roles explicitly flagged on this address. */
32607
+ flags: array(HubAddressRoleSchema).readonly(),
32608
+ /** The roles this address serves right now — flagged or automatic. */
32609
+ inUse: array(HubAddressRoleSchema).readonly(),
32610
+ /** The roles this address may be flagged with. */
32611
+ eligible: array(HubAddressRoleSchema).readonly()
32612
+ })).readonly(),
32613
+ roles: object({
32614
+ appConnections: HubAppConnectionsResolutionSchema,
32615
+ notificationTaps: HubAddressRoleResolutionSchema,
32616
+ internal: HubAddressRoleResolutionSchema,
32617
+ publicEndpoint: HubAddressRoleResolutionSchema
32618
+ }),
32619
+ /** The `hub=` an app link carries (D709), or null. */
32620
+ appLinkHub: string().nullable()
32621
+ });
32191
32622
  var AllowedAddressesSchema = object({
32192
32623
  /**
32193
32624
  * Allowlist of interface addresses operators have explicitly opted
@@ -32231,10 +32662,27 @@ method(_void(), ListResultSchema), method(_void(), PreferredSchema), method(obje
32231
32662
  * tunnel always emits `https://` regardless. */
32232
32663
  scheme: _enum(["http", "https"]).optional(),
32233
32664
  /** Append the CamStack app link entry (`kind: 'app-link'`, D709) —
32234
- * an address notification links can be flagged with, not a hub
32665
+ * an address notification taps can be flagged with, not a hub
32235
32666
  * route. Default `false`: racers and rankers never see it. */
32236
32667
  includeAppLink: boolean().optional()
32237
- }), GetConnectionEndpointsResultSchema), method(_void(), NotificationEndpointSchema), method(object({ baseUrl: string().nullable() }), NotificationEndpointSchema, { kind: "mutation" }), method(_void(), ViewerEndpointsSchema), method(object({ baseUrls: array(string()).readonly() }), ViewerEndpointsSchema, { kind: "mutation" }), method(_void(), AllowedAddressesSchema), method(AllowedAddressesSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), AllowedAddressesSchema, { kind: "mutation" }), method(_void(), TlsStatusSchema), method(object({ reason: string().optional() }), TlsStatusSchema, {
32668
+ }), GetConnectionEndpointsResultSchema), method(_void(), NotificationEndpointSchema), method(object({ baseUrl: string().nullable() }), NotificationEndpointSchema, { kind: "mutation" }), method(_void(), ViewerEndpointsSchema), method(object({ baseUrls: array(string()).readonly() }), ViewerEndpointsSchema, { kind: "mutation" }), method(object({ scheme: _enum(["http", "https"]).optional() }).optional(), HubAddressBookSchema), method(object({
32669
+ baseUrl: string(),
32670
+ label: string().max(80)
32671
+ }), HubAddressBookSchema, {
32672
+ kind: "mutation",
32673
+ auth: "admin"
32674
+ }), method(object({ baseUrl: string() }), HubAddressBookSchema, {
32675
+ kind: "mutation",
32676
+ auth: "admin"
32677
+ }), method(object({
32678
+ role: HubAddressRoleSchema,
32679
+ baseUrl: string().nullable(),
32680
+ enabled: boolean(),
32681
+ acceptInsecureHttp: boolean().optional()
32682
+ }), HubAddressBookSchema, {
32683
+ kind: "mutation",
32684
+ auth: "admin"
32685
+ }), method(_void(), HubAddressesSchema), method(_void(), AllowedAddressesSchema), method(AllowedAddressesSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), AllowedAddressesSchema, { kind: "mutation" }), method(_void(), TlsStatusSchema), method(object({ reason: string().optional() }), TlsStatusSchema, {
32238
32686
  kind: "mutation",
32239
32687
  auth: "admin"
32240
32688
  }), method(object({
@@ -32692,7 +33140,8 @@ var MotionStatusSchema = object({
32692
33140
  * writes this slice (not even a boot seed), and neither does the runner's
32693
33141
  * phase machine: its phase is "a session is attached" for every on-motion
32694
33142
  * session, not motion, and it now has its own `DetectionPhaseTransition`.
32695
- * A provider's `isDetected` answers from the hub's slice.
33143
+ * A provider's `isDetected` and `getStatus` answer from the hub's slice
33144
+ * (`hubMotionNativeProvider`).
32696
33145
  * - **Sensors** (Home Assistant binary sensors, Homematic, Matter, Alexa
32697
33146
  * imports) — the provider pushes both edges itself, from the upstream
32698
33147
  * system's own state change. That is the sensor's own fact.
@@ -39239,6 +39688,16 @@ var zoneRulesCapability = {
39239
39688
  durability: "restored"
39240
39689
  };
39241
39690
  SOURCE_CAPS.filter((cap) => cap !== "switch" && cap !== "motion");
39691
+ Object.freeze({
39692
+ person: .5,
39693
+ vehicle: .5,
39694
+ animal: .5
39695
+ });
39696
+ Object.freeze({
39697
+ person: .65,
39698
+ vehicle: .65,
39699
+ animal: .65
39700
+ });
39242
39701
  /**
39243
39702
  * Accessory device helpers — shared across drivers.
39244
39703
  *
@@ -42119,90 +42578,18 @@ Object.freeze({
42119
42578
  addonId: null,
42120
42579
  access: "create"
42121
42580
  },
42122
- "decoder.createSession": {
42123
- capName: "decoder",
42124
- capScope: "system",
42125
- addonId: null,
42126
- access: "view"
42127
- },
42128
- "decoder.destroySession": {
42129
- capName: "decoder",
42130
- capScope: "system",
42131
- addonId: null,
42132
- access: "delete"
42133
- },
42134
- "decoder.getFrame": {
42135
- capName: "decoder",
42136
- capScope: "system",
42137
- addonId: null,
42138
- access: "view"
42139
- },
42140
42581
  "decoder.getInfo": {
42141
42582
  capName: "decoder",
42142
42583
  capScope: "system",
42143
42584
  addonId: null,
42144
42585
  access: "view"
42145
42586
  },
42146
- "decoder.getShmStats": {
42147
- capName: "decoder",
42148
- capScope: "system",
42149
- addonId: null,
42150
- access: "view"
42151
- },
42152
- "decoder.getStats": {
42153
- capName: "decoder",
42154
- capScope: "system",
42155
- addonId: null,
42156
- access: "view"
42157
- },
42158
- "decoder.listActiveSessions": {
42159
- capName: "decoder",
42160
- capScope: "system",
42161
- addonId: null,
42162
- access: "view"
42163
- },
42164
- "decoder.openStream": {
42165
- capName: "decoder",
42166
- capScope: "system",
42167
- addonId: null,
42168
- access: "view"
42169
- },
42170
- "decoder.pullFrames": {
42171
- capName: "decoder",
42172
- capScope: "system",
42173
- addonId: null,
42174
- access: "view"
42175
- },
42176
- "decoder.pullHandles": {
42177
- capName: "decoder",
42178
- capScope: "system",
42179
- addonId: null,
42180
- access: "view"
42181
- },
42182
- "decoder.pushPacket": {
42183
- capName: "decoder",
42184
- capScope: "system",
42185
- addonId: null,
42186
- access: "view"
42187
- },
42188
42587
  "decoder.reprobeHwaccel": {
42189
42588
  capName: "decoder",
42190
42589
  capScope: "system",
42191
42590
  addonId: null,
42192
42591
  access: "create"
42193
42592
  },
42194
- "decoder.supportsCodec": {
42195
- capName: "decoder",
42196
- capScope: "system",
42197
- addonId: null,
42198
- access: "view"
42199
- },
42200
- "decoder.updateConfig": {
42201
- capName: "decoder",
42202
- capScope: "system",
42203
- addonId: null,
42204
- access: "view"
42205
- },
42206
42593
  "detectionPipeline.applyDeviceSettingsPatch": {
42207
42594
  capName: "detection-pipeline",
42208
42595
  capScope: "device",
@@ -43691,12 +44078,24 @@ Object.freeze({
43691
44078
  addonId: null,
43692
44079
  access: "view"
43693
44080
  },
44081
+ "localNetwork.addCustomAddress": {
44082
+ capName: "local-network",
44083
+ capScope: "system",
44084
+ addonId: null,
44085
+ access: "create"
44086
+ },
43694
44087
  "localNetwork.downloadCa": {
43695
44088
  capName: "local-network",
43696
44089
  capScope: "system",
43697
44090
  addonId: null,
43698
44091
  access: "view"
43699
44092
  },
44093
+ "localNetwork.getAddresses": {
44094
+ capName: "local-network",
44095
+ capScope: "system",
44096
+ addonId: null,
44097
+ access: "view"
44098
+ },
43700
44099
  "localNetwork.getAllowedAddresses": {
43701
44100
  capName: "local-network",
43702
44101
  capScope: "system",
@@ -43709,6 +44108,12 @@ Object.freeze({
43709
44108
  addonId: null,
43710
44109
  access: "view"
43711
44110
  },
44111
+ "localNetwork.getHubAddresses": {
44112
+ capName: "local-network",
44113
+ capScope: "system",
44114
+ addonId: null,
44115
+ access: "view"
44116
+ },
43712
44117
  "localNetwork.getNotificationEndpoint": {
43713
44118
  capName: "local-network",
43714
44119
  capScope: "system",
@@ -43745,6 +44150,12 @@ Object.freeze({
43745
44150
  addonId: null,
43746
44151
  access: "create"
43747
44152
  },
44153
+ "localNetwork.removeCustomAddress": {
44154
+ capName: "local-network",
44155
+ capScope: "system",
44156
+ addonId: null,
44157
+ access: "delete"
44158
+ },
43748
44159
  "localNetwork.resetAllowlistToBestMatch": {
43749
44160
  capName: "local-network",
43750
44161
  capScope: "system",
@@ -43757,6 +44168,12 @@ Object.freeze({
43757
44168
  addonId: null,
43758
44169
  access: "create"
43759
44170
  },
44171
+ "localNetwork.setAddressRole": {
44172
+ capName: "local-network",
44173
+ capScope: "system",
44174
+ addonId: null,
44175
+ access: "create"
44176
+ },
43760
44177
  "localNetwork.setAllowedAddresses": {
43761
44178
  capName: "local-network",
43762
44179
  capScope: "system",
@@ -45251,13 +45668,13 @@ Object.freeze({
45251
45668
  addonId: null,
45252
45669
  access: "delete"
45253
45670
  },
45254
- "pipelineExecutor.deleteModel": {
45671
+ "pipelineExecutor.clearModelBoundDeviceOverrides": {
45255
45672
  capName: "pipeline-executor",
45256
45673
  capScope: "system",
45257
45674
  addonId: null,
45258
45675
  access: "delete"
45259
45676
  },
45260
- "pipelineExecutor.deleteTemplate": {
45677
+ "pipelineExecutor.deleteModel": {
45261
45678
  capName: "pipeline-executor",
45262
45679
  capScope: "system",
45263
45680
  addonId: null,
@@ -45401,12 +45818,6 @@ Object.freeze({
45401
45818
  addonId: null,
45402
45819
  access: "view"
45403
45820
  },
45404
- "pipelineExecutor.listTemplates": {
45405
- capName: "pipeline-executor",
45406
- capScope: "system",
45407
- addonId: null,
45408
- access: "view"
45409
- },
45410
45821
  "pipelineExecutor.rearmInferenceDevice": {
45411
45822
  capName: "pipeline-executor",
45412
45823
  capScope: "system",
@@ -45431,12 +45842,6 @@ Object.freeze({
45431
45842
  addonId: null,
45432
45843
  access: "create"
45433
45844
  },
45434
- "pipelineExecutor.saveTemplate": {
45435
- capName: "pipeline-executor",
45436
- capScope: "system",
45437
- addonId: null,
45438
- access: "create"
45439
- },
45440
45845
  "pipelineExecutor.setVideoPipelineSteps": {
45441
45846
  capName: "pipeline-executor",
45442
45847
  capScope: "system",
@@ -45455,41 +45860,35 @@ Object.freeze({
45455
45860
  addonId: null,
45456
45861
  access: "create"
45457
45862
  },
45458
- "pipelineExecutor.updateTemplate": {
45459
- capName: "pipeline-executor",
45460
- capScope: "system",
45461
- addonId: null,
45462
- access: "create"
45463
- },
45464
45863
  "pipelineExecutor.validatePipeline": {
45465
45864
  capName: "pipeline-executor",
45466
45865
  capScope: "system",
45467
45866
  addonId: null,
45468
45867
  access: "view"
45469
45868
  },
45470
- "pipelineOrchestrator.applyDeviceSettingsPatch": {
45869
+ "pipelineOrchestrator.applyAutoTune": {
45471
45870
  capName: "pipeline-orchestrator",
45472
45871
  capScope: "system",
45473
45872
  addonId: null,
45474
45873
  access: "create"
45475
45874
  },
45476
- "pipelineOrchestrator.assignAudio": {
45875
+ "pipelineOrchestrator.applyDeviceSettingsPatch": {
45477
45876
  capName: "pipeline-orchestrator",
45478
45877
  capScope: "system",
45479
45878
  addonId: null,
45480
45879
  access: "create"
45481
45880
  },
45482
- "pipelineOrchestrator.assignPipeline": {
45881
+ "pipelineOrchestrator.assignAudio": {
45483
45882
  capName: "pipeline-orchestrator",
45484
45883
  capScope: "system",
45485
45884
  addonId: null,
45486
45885
  access: "create"
45487
45886
  },
45488
- "pipelineOrchestrator.deleteTemplate": {
45887
+ "pipelineOrchestrator.assignPipeline": {
45489
45888
  capName: "pipeline-orchestrator",
45490
45889
  capScope: "system",
45491
45890
  addonId: null,
45492
- access: "delete"
45891
+ access: "create"
45493
45892
  },
45494
45893
  "pipelineOrchestrator.getAgentLoad": {
45495
45894
  capName: "pipeline-orchestrator",
@@ -45581,6 +45980,12 @@ Object.freeze({
45581
45980
  addonId: null,
45582
45981
  access: "view"
45583
45982
  },
45983
+ "pipelineOrchestrator.getEffectiveShares": {
45984
+ capName: "pipeline-orchestrator",
45985
+ capScope: "system",
45986
+ addonId: null,
45987
+ access: "view"
45988
+ },
45584
45989
  "pipelineOrchestrator.getGlobalMetrics": {
45585
45990
  capName: "pipeline-orchestrator",
45586
45991
  capScope: "system",
@@ -45617,19 +46022,19 @@ Object.freeze({
45617
46022
  addonId: null,
45618
46023
  access: "view"
45619
46024
  },
45620
- "pipelineOrchestrator.getReconcileFromDiskStatus": {
46025
+ "pipelineOrchestrator.getPlacementStats": {
45621
46026
  capName: "pipeline-orchestrator",
45622
46027
  capScope: "system",
45623
46028
  addonId: null,
45624
46029
  access: "view"
45625
46030
  },
45626
- "pipelineOrchestrator.listAgentSettings": {
46031
+ "pipelineOrchestrator.getReconcileFromDiskStatus": {
45627
46032
  capName: "pipeline-orchestrator",
45628
46033
  capScope: "system",
45629
46034
  addonId: null,
45630
46035
  access: "view"
45631
46036
  },
45632
- "pipelineOrchestrator.listTemplates": {
46037
+ "pipelineOrchestrator.listAgentSettings": {
45633
46038
  capName: "pipeline-orchestrator",
45634
46039
  capScope: "system",
45635
46040
  addonId: null,
@@ -45641,6 +46046,12 @@ Object.freeze({
45641
46046
  addonId: null,
45642
46047
  access: "create"
45643
46048
  },
46049
+ "pipelineOrchestrator.planAutoTune": {
46050
+ capName: "pipeline-orchestrator",
46051
+ capScope: "system",
46052
+ addonId: null,
46053
+ access: "view"
46054
+ },
45644
46055
  "pipelineOrchestrator.rebalance": {
45645
46056
  capName: "pipeline-orchestrator",
45646
46057
  capScope: "system",
@@ -45683,12 +46094,6 @@ Object.freeze({
45683
46094
  addonId: null,
45684
46095
  access: "create"
45685
46096
  },
45686
- "pipelineOrchestrator.saveTemplate": {
45687
- capName: "pipeline-orchestrator",
45688
- capScope: "system",
45689
- addonId: null,
45690
- access: "create"
45691
- },
45692
46097
  "pipelineOrchestrator.setAgentCapabilities": {
45693
46098
  capName: "pipeline-orchestrator",
45694
46099
  capScope: "system",
@@ -45701,12 +46106,6 @@ Object.freeze({
45701
46106
  addonId: null,
45702
46107
  access: "create"
45703
46108
  },
45704
- "pipelineOrchestrator.setAgentDetectWeight": {
45705
- capName: "pipeline-orchestrator",
45706
- capScope: "system",
45707
- addonId: null,
45708
- access: "create"
45709
- },
45710
46109
  "pipelineOrchestrator.setAgentInferenceDevices": {
45711
46110
  capName: "pipeline-orchestrator",
45712
46111
  capScope: "system",
@@ -45743,6 +46142,12 @@ Object.freeze({
45743
46142
  addonId: null,
45744
46143
  access: "create"
45745
46144
  },
46145
+ "pipelineOrchestrator.setCameraStepSettings": {
46146
+ capName: "pipeline-orchestrator",
46147
+ capScope: "system",
46148
+ addonId: null,
46149
+ access: "create"
46150
+ },
45746
46151
  "pipelineOrchestrator.setCameraStepToggle": {
45747
46152
  capName: "pipeline-orchestrator",
45748
46153
  capScope: "system",
@@ -45761,25 +46166,37 @@ Object.freeze({
45761
46166
  addonId: null,
45762
46167
  access: "create"
45763
46168
  },
46169
+ "pipelineOrchestrator.setLoadBalancingShares": {
46170
+ capName: "pipeline-orchestrator",
46171
+ capScope: "system",
46172
+ addonId: null,
46173
+ access: "create"
46174
+ },
45764
46175
  "pipelineOrchestrator.setPipelineDevicePin": {
45765
46176
  capName: "pipeline-orchestrator",
45766
46177
  capScope: "system",
45767
46178
  addonId: null,
45768
46179
  access: "create"
45769
46180
  },
45770
- "pipelineOrchestrator.unassignAudio": {
46181
+ "pipelineOrchestrator.setShareSource": {
45771
46182
  capName: "pipeline-orchestrator",
45772
46183
  capScope: "system",
45773
46184
  addonId: null,
45774
46185
  access: "create"
45775
46186
  },
45776
- "pipelineOrchestrator.unassignPipeline": {
46187
+ "pipelineOrchestrator.suggestShares": {
46188
+ capName: "pipeline-orchestrator",
46189
+ capScope: "system",
46190
+ addonId: null,
46191
+ access: "view"
46192
+ },
46193
+ "pipelineOrchestrator.unassignAudio": {
45777
46194
  capName: "pipeline-orchestrator",
45778
46195
  capScope: "system",
45779
46196
  addonId: null,
45780
46197
  access: "create"
45781
46198
  },
45782
- "pipelineOrchestrator.updateTemplate": {
46199
+ "pipelineOrchestrator.unassignPipeline": {
45783
46200
  capName: "pipeline-orchestrator",
45784
46201
  capScope: "system",
45785
46202
  addonId: null,
@@ -47219,12 +47636,6 @@ Object.freeze({
47219
47636
  addonId: null,
47220
47637
  access: "view"
47221
47638
  },
47222
- "streamBroker.pullFrameHandles": {
47223
- capName: "stream-broker",
47224
- capScope: "system",
47225
- addonId: null,
47226
- access: "view"
47227
- },
47228
47639
  "streamBroker.regenerateRtspToken": {
47229
47640
  capName: "stream-broker",
47230
47641
  capScope: "system",
@@ -47291,12 +47702,6 @@ Object.freeze({
47291
47702
  addonId: null,
47292
47703
  access: "create"
47293
47704
  },
47294
- "streamBroker.subscribeFrames": {
47295
- capName: "stream-broker",
47296
- capScope: "system",
47297
- addonId: null,
47298
- access: "create"
47299
- },
47300
47705
  "streamBroker.unassignProfile": {
47301
47706
  capName: "stream-broker",
47302
47707
  capScope: "system",
@@ -47309,12 +47714,6 @@ Object.freeze({
47309
47714
  addonId: null,
47310
47715
  access: "create"
47311
47716
  },
47312
- "streamBroker.unsubscribeFrames": {
47313
- capName: "stream-broker",
47314
- capScope: "system",
47315
- addonId: null,
47316
- access: "create"
47317
- },
47318
47717
  "streamCatalog.getCatalog": {
47319
47718
  capName: "stream-catalog",
47320
47719
  capScope: "device",
@@ -48011,6 +48410,12 @@ Object.freeze({
48011
48410
  addonId: null,
48012
48411
  access: "create"
48013
48412
  },
48413
+ "webrtcSession.applyDownlinkProbe": {
48414
+ capName: "webrtc-session",
48415
+ capScope: "device",
48416
+ addonId: null,
48417
+ access: "create"
48418
+ },
48014
48419
  "webrtcSession.closeSession": {
48015
48420
  capName: "webrtc-session",
48016
48421
  capScope: "device",
@@ -49822,11 +50227,6 @@ Object.freeze({
49822
50227
  form: "single",
49823
50228
  optional: false
49824
50229
  }],
49825
- "decoder.createSession": [{
49826
- name: "deviceId",
49827
- form: "single",
49828
- optional: true
49829
- }],
49830
50230
  "detectionPipeline.applyDeviceSettingsPatch": [{
49831
50231
  name: "deviceId",
49832
50232
  form: "single",
@@ -51057,6 +51457,11 @@ Object.freeze({
51057
51457
  form: "single",
51058
51458
  optional: false
51059
51459
  }],
51460
+ "pipelineExecutor.clearModelBoundDeviceOverrides": [{
51461
+ name: "deviceIds",
51462
+ form: "array",
51463
+ optional: true
51464
+ }],
51060
51465
  "pipelineExecutor.runPipeline": [{
51061
51466
  name: "deviceId",
51062
51467
  form: "single",
@@ -51162,6 +51567,11 @@ Object.freeze({
51162
51567
  form: "single",
51163
51568
  optional: false
51164
51569
  }],
51570
+ "pipelineOrchestrator.setCameraStepSettings": [{
51571
+ name: "deviceId",
51572
+ form: "single",
51573
+ optional: false
51574
+ }],
51165
51575
  "pipelineOrchestrator.setCameraStepToggle": [{
51166
51576
  name: "deviceId",
51167
51577
  form: "single",
@@ -51933,6 +52343,11 @@ Object.freeze({
51933
52343
  form: "single",
51934
52344
  optional: false
51935
52345
  }],
52346
+ "webrtcSession.applyDownlinkProbe": [{
52347
+ name: "deviceId",
52348
+ form: "single",
52349
+ optional: false
52350
+ }],
51936
52351
  "webrtcSession.closeSession": [{
51937
52352
  name: "deviceId",
51938
52353
  form: "single",
@@ -52162,6 +52577,8 @@ new Map(Object.entries({
52162
52577
  "detection-blind": "device-events",
52163
52578
  "node-online": "system",
52164
52579
  "node-offline": "system",
52580
+ "node-restarting": "system",
52581
+ "node-updating": "system",
52165
52582
  "node-inference-unavailable": "system",
52166
52583
  "addon-crash-loop": "system",
52167
52584
  "addon-update-available": "system",
@@ -52239,6 +52656,7 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
52239
52656
  kinds: [
52240
52657
  "node-offline",
52241
52658
  "node-online",
52659
+ "node-restarting",
52242
52660
  "node-inference-unavailable"
52243
52661
  ]
52244
52662
  },
@@ -52260,6 +52678,7 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
52260
52678
  label: "Server & container updates",
52261
52679
  kinds: [
52262
52680
  "server-update-available",
52681
+ "node-updating",
52263
52682
  "server-updated",
52264
52683
  "wrapper-update-available"
52265
52684
  ]
@@ -52407,6 +52826,7 @@ var STATE_SUMMARY_SECTION_VARS = [
52407
52826
  kinds: [
52408
52827
  "node-offline",
52409
52828
  "node-online",
52829
+ "node-restarting",
52410
52830
  "node-inference-unavailable"
52411
52831
  ]
52412
52832
  },
@@ -52428,6 +52848,7 @@ var STATE_SUMMARY_SECTION_VARS = [
52428
52848
  example: "server 1.2.377 → 1.2.378",
52429
52849
  kinds: [
52430
52850
  "server-update-available",
52851
+ "node-updating",
52431
52852
  "server-updated",
52432
52853
  "wrapper-update-available"
52433
52854
  ]
@@ -52460,7 +52881,7 @@ var STATE_SUMMARY_VARS = [
52460
52881
  {
52461
52882
  name: "summarySection",
52462
52883
  label: "Summary: this section",
52463
- description: "The section a per-section summary row is about (D698); on a summary sent as one message, every section it reports, comma-separated.",
52884
+ description: "The section a per-section summary row is about; on a summary sent as one message, every section it reports, comma-separated.",
52464
52885
  example: "Batterie scariche",
52465
52886
  group: "system",
52466
52887
  families: ["rule"],