@camstack/addon-export-alexa 1.2.21 → 1.2.22

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.
@@ -26,7 +26,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
26
26
  //#endregion
27
27
  let node_crypto = require("node:crypto");
28
28
  node_crypto = __toESM(node_crypto);
29
- //#region ../types/dist/event-category-Cv9dO26A.mjs
29
+ //#region ../types/dist/event-category-Bxo5yJjt.mjs
30
30
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
31
31
  EventCategory["SystemBoot"] = "system.boot";
32
32
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -233,6 +233,33 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
233
233
  EventCategory["PipelineCameraAssigned"] = "pipeline.camera-assigned";
234
234
  EventCategory["PipelineCameraUnassigned"] = "pipeline.camera-unassigned";
235
235
  /**
236
+ * A node the orchestrator would otherwise place cameras on has NO usable
237
+ * inference device: the operator enabled one or more accelerators there and
238
+ * the live probe reports every one of them unavailable. Emitted once per
239
+ * TRANSITION into that state (never per dispatch), and the node is dropped
240
+ * from the placement candidate set for as long as it holds.
241
+ *
242
+ * This exists because the state was previously invisible: little-unraid
243
+ * absorbed 283k inference errors in a day while still being handed cameras,
244
+ * and nothing in the system said so.
245
+ *
246
+ * A node with no accelerators configured at all is NOT this — its devices
247
+ * are `disabled`, not `unavailable`, and the runner's default CPU pool
248
+ * serves it exactly as before.
249
+ */
250
+ EventCategory["PipelineNodeInferenceUnavailable"] = "pipeline.node-inference-unavailable";
251
+ /**
252
+ * A camera has an OPEN detection session and has produced no detection at
253
+ * all for longer than the blind threshold — the camera is being decoded and
254
+ * inferred and is returning nothing. Emitted once per transition into blind,
255
+ * per camera.
256
+ *
257
+ * The failure it reports: a 1h43 detection blackout on the entrance camera
258
+ * that nobody noticed, because "a camera that detects nothing" and "a quiet
259
+ * camera" produce byte-identical silence.
260
+ */
261
+ EventCategory["PipelineDetectionBlind"] = "pipeline.detection-blind";
262
+ /**
236
263
  * Per-camera pipeline config was mutated by the orchestrator
237
264
  * (3-level settings change via `setAgentAddonDefaults` /
238
265
  * `setCameraStepToggle` / `setCameraPipelineForAgent` or a
@@ -3024,6 +3051,9 @@ function handlePipeResult(left, next, ctx) {
3024
3051
  fallback: left.fallback
3025
3052
  }, ctx);
3026
3053
  }
3054
+ var $ZodPreprocess = /*@__PURE__*/ $constructor("$ZodPreprocess", (inst, def) => {
3055
+ $ZodPipe.init(inst, def);
3056
+ });
3027
3057
  var $ZodReadonly = /*@__PURE__*/ $constructor("$ZodReadonly", (inst, def) => {
3028
3058
  $ZodType.init(inst, def);
3029
3059
  defineLazy(inst._zod, "propValues", () => def.innerType._zod.propValues);
@@ -5209,6 +5239,10 @@ function pipe(in_, out) {
5209
5239
  out
5210
5240
  });
5211
5241
  }
5242
+ var ZodPreprocess = /*@__PURE__*/ $constructor("ZodPreprocess", (inst, def) => {
5243
+ ZodPipe.init(inst, def);
5244
+ $ZodPreprocess.init(inst, def);
5245
+ });
5212
5246
  var ZodReadonly = /*@__PURE__*/ $constructor("ZodReadonly", (inst, def) => {
5213
5247
  $ZodReadonly.init(inst, def);
5214
5248
  ZodType.init(inst, def);
@@ -5267,6 +5301,13 @@ function _instanceof(cls, params = {}) {
5267
5301
  };
5268
5302
  return inst;
5269
5303
  }
5304
+ function preprocess(fn, schema) {
5305
+ return new ZodPreprocess({
5306
+ type: "pipe",
5307
+ in: transform(fn),
5308
+ out: schema
5309
+ });
5310
+ }
5270
5311
  //#endregion
5271
5312
  //#region ../../node_modules/zod/v4/classic/compat.js
5272
5313
  /** @deprecated Use the raw string literal codes instead, e.g. "invalid_type". */
@@ -12445,6 +12486,17 @@ var LlmImageSchema = object({
12445
12486
  bytes: _instanceof(Uint8Array),
12446
12487
  mimeType: string()
12447
12488
  });
12489
+ /**
12490
+ * Retry policy. `enabled: false` is NOT the same as `maxAttempts: 1` in intent —
12491
+ * the flag is what a consumer table flips, the count is what the operator tunes.
12492
+ * A retry doubles the wall time of a call, so the two gates that run inside a
12493
+ * notification's budget keep it off (see `CONSUMER_RETRY_POLICY` in addon-ai).
12494
+ */
12495
+ var LlmRetryPolicySchema = object({
12496
+ enabled: boolean().default(false),
12497
+ /** Total attempts INCLUDING the first. 1 = no retry. */
12498
+ maxAttempts: number().int().min(1).max(5).default(1)
12499
+ });
12448
12500
  var LlmGenerateBaseInputSchema = object({
12449
12501
  /** Collection routing (the notification-output posture). */
12450
12502
  addonId: string().optional(),
@@ -12459,7 +12511,28 @@ var LlmGenerateBaseInputSchema = object({
12459
12511
  jsonSchema: record(string(), unknown()).optional(),
12460
12512
  /** Per-call override of the profile default. */
12461
12513
  maxTokens: number().int().positive().optional(),
12462
- temperature: number().optional()
12514
+ temperature: number().optional(),
12515
+ /** Per-call override of the profile default (nucleus sampling). */
12516
+ topP: number().min(0).max(1).optional(),
12517
+ /** Per-call override of the profile default (top-k sampling). */
12518
+ topK: number().int().positive().optional(),
12519
+ /** Per-call override of `profile.timeoutMs` — the total generation bound. */
12520
+ timeoutMs: number().int().positive().optional(),
12521
+ /** Per-call override; beats both the consumer table and the profile. */
12522
+ retry: LlmRetryPolicySchema.optional(),
12523
+ /**
12524
+ * Caller-minted id that makes this generation CANCELLABLE.
12525
+ *
12526
+ * Without it a caller that stops waiting cannot stop the work: the gates race
12527
+ * the call against 8 s and free their own slot when the timer wins, while the
12528
+ * generation upstream keeps running to `profile.timeoutMs` — 60 s by default,
12529
+ * on a single-threaded local model. The per-camera bound then counts WAITS,
12530
+ * not generations, and the real load is unbounded.
12531
+ *
12532
+ * `AbortSignal` cannot cross a process boundary; an id can. Pass one here and
12533
+ * `llm.cancel({ requestId })` tears the socket down.
12534
+ */
12535
+ requestId: string().optional()
12463
12536
  });
12464
12537
  /**
12465
12538
  * `llm-runtime` — node-side managed llama.cpp executor (spec §4). Registered
@@ -12472,6 +12545,18 @@ var LlmGenerateBaseInputSchema = object({
12472
12545
  * Resource ceiling = llama-server flags + idleStopMinutes ONLY (no RSS
12473
12546
  * watchdog — operator decision #3).
12474
12547
  */
12548
+ /**
12549
+ * A companion artifact that MUST land beside the main GGUF: the `mmproj`
12550
+ * projector of a vision model, or shards 2..N of a split GGUF. Carried on the
12551
+ * REF rather than looked up at install time, so what the operator approved in
12552
+ * the preview is exactly what the node downloads.
12553
+ */
12554
+ var ManagedModelExtraFileSchema = object({
12555
+ url: string(),
12556
+ filename: string(),
12557
+ sizeBytes: number(),
12558
+ sha256: string().optional()
12559
+ });
12475
12560
  var ManagedModelRefSchema = discriminatedUnion("kind", [
12476
12561
  object({
12477
12562
  kind: literal("catalog"),
@@ -12480,7 +12565,11 @@ var ManagedModelRefSchema = discriminatedUnion("kind", [
12480
12565
  object({
12481
12566
  kind: literal("url"),
12482
12567
  url: string(),
12483
- sha256: string().optional()
12568
+ sha256: string().optional(),
12569
+ /** Picker/status label; the file basename when absent. */
12570
+ label: string().optional(),
12571
+ sizeBytes: number().optional(),
12572
+ extraFiles: array(ManagedModelExtraFileSchema).optional()
12484
12573
  }),
12485
12574
  object({
12486
12575
  kind: literal("path"),
@@ -12498,13 +12587,82 @@ var ManagedRuntimeConfigSchema = object({
12498
12587
  gpuLayers: number().int().default(0),
12499
12588
  /** Default: cpus-2, clamped ≥1 (resolved node-side). */
12500
12589
  threads: number().int().optional(),
12501
- /** Concurrent slots. */
12590
+ /** Concurrent slots (`--parallel`). */
12502
12591
  parallel: number().int().default(1),
12592
+ /** Logical batch size (`-b`). Larger = faster prompt ingest, more RAM. */
12593
+ batchSize: number().int().positive().optional(),
12594
+ /** Physical batch / micro-batch (`-ub`). */
12595
+ ubatchSize: number().int().positive().optional(),
12596
+ /**
12597
+ * `--flash-attn`. Cuts KV-cache memory on the backends that implement it and
12598
+ * is a no-op elsewhere, so it is offered rather than assumed.
12599
+ */
12600
+ flashAttention: boolean().default(false),
12601
+ /**
12602
+ * `--mlock`. Pins the weights in RAM so the OS cannot page them out mid
12603
+ * inference. Costs the full model size in resident memory — which is exactly
12604
+ * what the RAM budget is counting.
12605
+ */
12606
+ mlock: boolean().default(false),
12607
+ /**
12608
+ * `--no-mmap`. Reads the whole GGUF up front instead of mapping it. Slower to
12609
+ * start, but avoids the page-fault stalls a network or spinning-disk model
12610
+ * store produces on every first token.
12611
+ */
12612
+ noMmap: boolean().default(false),
12613
+ /** `--cache-type-k` / `--cache-type-v` — quantising the KV cache is the
12614
+ * cheapest way to fit a longer context in the same RAM. */
12615
+ cacheTypeK: _enum([
12616
+ "f32",
12617
+ "f16",
12618
+ "q8_0",
12619
+ "q5_1",
12620
+ "q5_0",
12621
+ "q4_1",
12622
+ "q4_0"
12623
+ ]).optional(),
12624
+ cacheTypeV: _enum([
12625
+ "f32",
12626
+ "f16",
12627
+ "q8_0",
12628
+ "q5_1",
12629
+ "q5_0",
12630
+ "q4_1",
12631
+ "q4_0"
12632
+ ]).optional(),
12633
+ /**
12634
+ * Escape hatch for llama-server flags this schema does NOT model — `--jinja`
12635
+ * (which most vision chat templates need and some language-only models
12636
+ * dislike), `--cont-batching`, `--rope-scaling`, …
12637
+ *
12638
+ * It is NOT a second place to set the flags above. A token that collides
12639
+ * with a typed field is REJECTED at start, naming the field that owns it
12640
+ * (`assertNoOwnedFlags`), because two knobs writing the same argv is exactly
12641
+ * the "two switches that disagree" failure this repo has already shipped
12642
+ * twice (D62).
12643
+ */
12644
+ extraArgs: array(string()).default([]),
12503
12645
  /** Else lazy: first generate boots it. */
12504
12646
  autoStart: boolean().default(false),
12505
12647
  /** 0 = never; frees RAM after quiet periods. */
12506
12648
  idleStopMinutes: number().int().default(30)
12507
12649
  });
12650
+ /**
12651
+ * Where a multi-GB install currently is. A single 0..1 fraction cannot answer
12652
+ * "is it stuck?" for an install that is three files (shards + mmproj) followed
12653
+ * by a sha256 pass over 22 GB — during which the fraction sat at 1.0 and the
12654
+ * node looked hung. Phase + file + bytes is the smallest shape that does.
12655
+ */
12656
+ var LlmDownloadProgressSchema = object({
12657
+ phase: _enum(["downloading", "verifying"]),
12658
+ /** The artifact currently moving, e.g. `mmproj-F16.gguf`. */
12659
+ file: string(),
12660
+ fileIndex: number().int(),
12661
+ fileCount: number().int(),
12662
+ /** Across the WHOLE install, not the current file. */
12663
+ downloadedBytes: number(),
12664
+ totalBytes: number().optional()
12665
+ });
12508
12666
  var LlmRuntimeStatusSchema = object({
12509
12667
  /** Status is ALWAYS node-qualified. */
12510
12668
  nodeId: string(),
@@ -12521,6 +12679,8 @@ var LlmRuntimeStatusSchema = object({
12521
12679
  modelPath: string().optional(),
12522
12680
  modelId: string().optional(),
12523
12681
  downloadProgress: number().min(0).max(1).optional(),
12682
+ /** Detail behind `downloadProgress`; present for the same lifetime. */
12683
+ download: LlmDownloadProgressSchema.optional(),
12524
12684
  lastError: string().optional(),
12525
12685
  crashesInWindow: number(),
12526
12686
  /** Child RSS (sampled best-effort). */
@@ -12531,7 +12691,14 @@ var LlmNodeModelSchema = object({
12531
12691
  file: string(),
12532
12692
  sizeBytes: number(),
12533
12693
  catalogId: string().optional(),
12534
- installedAt: number().optional()
12694
+ installedAt: number().optional(),
12695
+ /**
12696
+ * Absolute path on the node. Present so a file that is on disk but matches
12697
+ * no catalog entry — a custom Hugging Face install, or a GGUF the operator
12698
+ * copied in by hand — is still SELECTABLE, as a `{kind:'path'}` ref. Without
12699
+ * it the picker could list such a file and do nothing with it.
12700
+ */
12701
+ path: string().optional()
12535
12702
  });
12536
12703
  var LlmRuntimeDiskUsageSchema = object({
12537
12704
  nodeId: string(),
@@ -12587,10 +12754,47 @@ var LlmProfileSchema = object({
12587
12754
  baseUrl: string().optional(),
12588
12755
  /** ConfigUISchema type:'password' — never round-trips (spec §5). */
12589
12756
  apiKey: string().optional(),
12757
+ /** Vision on/off. A vision call against a `false` profile is REFUSED, never
12758
+ * degraded to text — that shipped once and produced a confident answer to a
12759
+ * question about a picture nobody sent. */
12590
12760
  supportsVision: boolean(),
12591
12761
  temperature: number().min(0).max(2).optional(),
12762
+ /** Nucleus sampling. Every wire we speak has it. */
12763
+ topP: number().min(0).max(1).optional(),
12764
+ /** Top-k sampling. Carried only by the wires that have it — NEITHER OpenAI
12765
+ * wire does, and the client drops it there (measured: the request body gets
12766
+ * `top_p` and no `top_k`). The profile editor hides the field wherever it
12767
+ * would change nothing; `KINDS_WITH_TOP_K` is the single owner of that list. */
12768
+ topK: number().int().positive().optional(),
12592
12769
  maxTokens: number().int().positive().optional(),
12770
+ /** Prompt context window. Advisory for cloud kinds (they enforce their own);
12771
+ * for `managed-local` it is the llama.cpp `--ctx-size` the runtime starts
12772
+ * the model with, so it is the one field that changes a PROCESS. */
12773
+ contextLength: number().int().positive().optional(),
12774
+ /** Default system prompt. A caller's `system` REPLACES it (never appends —
12775
+ * two system prompts fighting is worse than either alone). */
12776
+ systemPrompt: string().optional(),
12777
+ /** Total generation bound — the only one a unary call has. */
12593
12778
  timeoutMs: number().int().positive().default(6e4),
12779
+ /** The TCP handshake only — "is the port even open". NOT the wait for
12780
+ * response headers: on the LM Studio / llama-server wire those are written
12781
+ * once the model has finished loading, so they belong to the bound below. */
12782
+ connectTimeoutMs: number().int().positive().default(1e4),
12783
+ /** Accepted, but no output yet — response headers included, because a cold
12784
+ * GPU load is exactly what happens before them. */
12785
+ firstTokenTimeoutMs: number().int().positive().default(12e4),
12786
+ /** Output started then stopped. */
12787
+ idleTimeoutMs: number().int().positive().default(6e4),
12788
+ /** Profile-level default. The per-consumer table and a per-call override
12789
+ * both beat it — see `resolveRetryPolicy`. */
12790
+ retry: LlmRetryPolicySchema.default({
12791
+ enabled: false,
12792
+ maxAttempts: 1
12793
+ }),
12794
+ /** Whether this profile may use tools. The tool-call plumbing rides the
12795
+ * library; the REGISTRY of callable tools is ours and is empty in v1, so a
12796
+ * `true` here buys the wiring, not behaviour, until tools are registered. */
12797
+ toolsEnabled: boolean().default(false),
12594
12798
  extraHeaders: record(string(), string()).optional(),
12595
12799
  /** kind === 'managed-local' only (spec §4). */
12596
12800
  runtime: ManagedRuntimeConfigSchema.optional()
@@ -12640,6 +12844,36 @@ var ManagedModelCatalogEntrySchema = object({
12640
12844
  /** Vision models: companion projector file. */
12641
12845
  mmprojUrl: string().optional()
12642
12846
  });
12847
+ /**
12848
+ * The outcome of turning one operator-typed Hugging Face reference into a
12849
+ * download plan. A RESULT, never a throw: "this repo has 24 quantizations and
12850
+ * I will not pick for you" is a normal answer the UI has to render, not an
12851
+ * exception.
12852
+ *
12853
+ * `candidates` is the whole reason the refusal is usable — every string in it
12854
+ * is a tag that resolves when pasted back as `<org>/<repo>:<TAG>`.
12855
+ */
12856
+ var HfModelResolutionSchema = discriminatedUnion("ok", [object({
12857
+ ok: literal(true),
12858
+ /** Ready to hand to `installModel` unchanged. */
12859
+ model: ManagedModelRefSchema,
12860
+ label: string(),
12861
+ repo: string(),
12862
+ quantization: string(),
12863
+ purpose: _enum(["text", "vision"]),
12864
+ totalBytes: number(),
12865
+ /** mmproj + shards, for the preview: an operator approving 23 GB should
12866
+ * see that 0.9 GB of it is a projector they did not name. */
12867
+ extraFilenames: array(string())
12868
+ }), object({
12869
+ ok: literal(false),
12870
+ code: string(),
12871
+ message: string(),
12872
+ candidates: array(string()).optional(),
12873
+ /** Set when the refusal was only the ceiling: re-calling with
12874
+ * `maxBytes: requiredBytes` is the operator's explicit override. */
12875
+ requiredBytes: number().optional()
12876
+ })]);
12643
12877
  var LlmRuntimeNodeSchema = object({
12644
12878
  nodeId: string(),
12645
12879
  reachable: boolean(),
@@ -12652,7 +12886,10 @@ var ProfileRefInputSchema = object({
12652
12886
  addonId: string(),
12653
12887
  profileId: string()
12654
12888
  });
12655
- method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }), method(GenerateVisionInputSchema, LlmGenerateResultSchema, { kind: "mutation" }), method(object({}), array(LlmProfileKindDescriptorSchema)), method(object({}), array(LlmProfileSchema)), method(object({ profile: LlmProfileSchema }), LlmProfileSchema, {
12889
+ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }), method(GenerateVisionInputSchema, LlmGenerateResultSchema, { kind: "mutation" }), method(object({
12890
+ addonId: string().optional(),
12891
+ requestId: string()
12892
+ }), _void(), { kind: "mutation" }), method(object({}), array(LlmProfileKindDescriptorSchema)), method(object({}), array(LlmProfileSchema)), method(object({ profile: LlmProfileSchema }), LlmProfileSchema, {
12656
12893
  kind: "mutation",
12657
12894
  auth: "admin"
12658
12895
  }), method(ProfileRefInputSchema, _void(), {
@@ -12673,6 +12910,15 @@ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }
12673
12910
  consumer: string().optional(),
12674
12911
  profileId: string().optional()
12675
12912
  }), array(LlmUsageRollupSchema)), method(object({}), array(ManagedModelCatalogEntrySchema)), method(object({}), array(LlmRuntimeNodeSchema)), method(object({ nodeId: string() }), array(LlmNodeModelSchema)), method(object({
12913
+ /** `https://huggingface.co/<org>/<repo>/resolve/main/<f>.gguf`,
12914
+ * `<org>/<repo>/<f>.gguf`, `<org>/<repo>` or `<org>/<repo>:<QUANT>`. */
12915
+ ref: string(),
12916
+ /** Explicit ceiling override, in bytes. Absent = the built-in ceiling. */
12917
+ maxBytes: number().positive().optional()
12918
+ }), HfModelResolutionSchema, {
12919
+ kind: "mutation",
12920
+ auth: "admin"
12921
+ }), method(object({
12676
12922
  nodeId: string(),
12677
12923
  model: ManagedModelRefSchema
12678
12924
  }), _void(), {
@@ -14282,6 +14528,8 @@ var NcSystemEventKindSchema = _enum([
14282
14528
  "stream-offline",
14283
14529
  "node-online",
14284
14530
  "node-offline",
14531
+ "node-inference-unavailable",
14532
+ "detection-blind",
14285
14533
  "addon-update-available",
14286
14534
  "server-update-available",
14287
14535
  "alarm-triggered",
@@ -14343,7 +14591,16 @@ var NcScheduleSchema = object({
14343
14591
  });
14344
14592
  /** Fuzzy plate matcher — OCR noise makes exact match useless (spec row 12/13). */
14345
14593
  var NcPlateMatcherSchema = object({
14346
- values: array(string().min(1)).min(1),
14594
+ /**
14595
+ * Plate texts (or gallery vehicle names) to match. EMPTY = **any plate the
14596
+ * pipeline could read** — the plate half of "no selection = no narrowing",
14597
+ * and the switch that says this rule is about vehicles that were IDENTIFIED
14598
+ * rather than merely seen. A subject carrying no plate still fails.
14599
+ *
14600
+ * The `.min(1)` this used to carry made that state unauthorable; nothing has
14601
+ * ever persisted an empty list, so widening it cannot change an existing rule.
14602
+ */
14603
+ values: array(string().min(1)),
14347
14604
  /** Max Levenshtein distance after normalization (uppercase alphanumeric). */
14348
14605
  maxDistance: number().int().min(0).max(3).default(1)
14349
14606
  });
@@ -14377,28 +14634,36 @@ var NcOccupancyConditionSchema = object({
14377
14634
  /**
14378
14635
  * Audio condition (IMMEDIATE trigger) — a rule on SOUND, not on a picture.
14379
14636
  *
14380
- * Operator-approved vocabulary (2026-08-12, option A — the same one the
14381
- * reference notifier uses, so an operator moving between them re-uses what
14382
- * they already know): a rule matches when, over a sampling window of
14383
- * `samplingSeconds`, at least `hitPercent`% of the audio samples in that
14384
- * window are HITS. A sample is a hit when it satisfies BOTH present filters:
14385
- *
14386
- * - `dbThreshold` — its level is at or above this many dBFS (see
14387
- * {@link NC_AUDIO_DBFS_FLOOR}: negative-going, `0` = full scale);
14388
- * - `labels` — the classifier put at least one of these labels on it.
14389
- *
14390
- * Both are OPTIONAL and independent, which is the point of the shape: a
14391
- * loudness rule ("something loud at 3am") needs no model to be right, and a
14392
- * label rule ("a dog barked") needs no threshold. **Fail-closed when NEITHER
14393
- * is given** — a window in which every sample is trivially a hit would fire on
14394
- * silence, so the engine refuses such a condition rather than notifying on
14395
- * nothing (the schema cannot express "at least one of" without becoming a
14396
- * ZodEffects the cap path would have to special-case).
14397
- *
14398
- * `hitPercent` is over the samples the window actually HOLDS, and the window
14399
- * must be FULL before it can match — a window that has been open for two
14400
- * seconds of its ten is 100% of nothing, and firing on it would make
14401
- * `samplingSeconds` decorative.
14637
+ * **TWO EXCLUSIVE MODES** (operator decision 2026-08-14, D157). Which one a
14638
+ * rule is in is not a stored field — it is WHICH FILTER the rule carries, so
14639
+ * there is no second switch that can disagree with the first and every rule
14640
+ * authored before the decision migrates for free (`audioModeOf`):
14641
+ *
14642
+ * - **LABEL mode — `labels` present.** The rule fires on the FIRST frame the
14643
+ * classifier labels with one of them. No window, no percentage:
14644
+ * `hitPercent` and `samplingSeconds` are ignored, and the rule's own
14645
+ * `throttle` cooldown is the only brake. The per-label confidence floor is
14646
+ * the analyzer's (`classificationMinScore`, per device) — a label only
14647
+ * reaches this condition if the classifier was already confident enough.
14648
+ * - **LEVEL mode — `dbThreshold` present, no labels.** The sampling window IS
14649
+ * the condition: at least `hitPercent`% of the samples over
14650
+ * `samplingSeconds` must be at or above `dbThreshold` dBFS (see
14651
+ * {@link NC_AUDIO_DBFS_FLOOR}: negative-going, `0` = full scale). The window
14652
+ * must be FULL before it can match — a window open for two of its ten
14653
+ * seconds is 100% of nothing.
14654
+ *
14655
+ * **Why label mode has no window.** It had one, and it never fired: the
14656
+ * analyzer emits ~1 audio frame per second but YAMNet only LABELS one to three
14657
+ * of them per episode, even through continuous crying. The measured maximum
14658
+ * `hitPercent` over the whole live history was 40 — under the shipped default
14659
+ * of 60, so a label rule could not fire at all, ever. A percentage of frames is
14660
+ * the wrong question to ask of a sparse classifier.
14661
+ *
14662
+ * **Fail-closed when NEITHER is given** — every sample would be a trivial hit
14663
+ * and the rule would fire on silence. The schema cannot express "exactly one
14664
+ * of" without becoming a ZodEffects the cap path would have to special-case, so
14665
+ * the exclusivity is enforced where every editor writes (`patchAudio`) and a
14666
+ * legacy rule carrying both resolves to LABEL (the mode that fires).
14402
14667
  *
14403
14668
  * Labels are the audio macro classes (`AUDIO_MACRO_LABELS` / the NC taxonomy's
14404
14669
  * `audio-*` ids). Both spellings are accepted — the matcher normalizes the
@@ -14406,13 +14671,13 @@ var NcOccupancyConditionSchema = object({
14406
14671
  * an operator who typed `dog` mean the same thing.
14407
14672
  */
14408
14673
  var NcAudioConditionSchema = object({
14409
- /** Audio macro labels; absent = any sound (level-only rule). */
14674
+ /** LABEL MODE: audio macro labels. Present ⇒ fires on the first labelled frame. */
14410
14675
  labels: array(string().min(1)).min(1).optional(),
14411
- /** Level floor in dBFS (negative-going, `0` = full scale); absent = any level. */
14676
+ /** LEVEL MODE: floor in dBFS (negative-going, `0` = full scale). */
14412
14677
  dbThreshold: number().min(-96).max(0).optional(),
14413
- /** Percentage of the window's samples that must be hits (1–100). */
14678
+ /** LEVEL MODE ONLY: percentage of the window's samples that must be hits (1–100). */
14414
14679
  hitPercent: number().int().min(1).max(100).default(60),
14415
- /** Length of the sampling window in seconds. */
14680
+ /** LEVEL MODE ONLY: length of the sampling window in seconds. */
14416
14681
  samplingSeconds: number().int().min(1).max(300).default(10)
14417
14682
  });
14418
14683
  /**
@@ -14550,13 +14815,81 @@ var NcRuleActionsSchema = object({
14550
14815
  */
14551
14816
  buttons: array(NcRuleNotificationButtonSchema).max(8).optional()
14552
14817
  });
14818
+ /**
14819
+ * "This rule applies only while `deviceId` is in one of `states`."
14820
+ *
14821
+ * The states are the DEVICE's own vocabulary — `AlarmState` for a panel,
14822
+ * `on`/`off` for a switch — not a normalised set, because normalising would
14823
+ * make the condition lie about devices whose states have no equivalent.
14824
+ *
14825
+ * An unreadable state does NOT match: see the engine's fail-closed gate. A
14826
+ * condition that fired on "I could not read it" would be worse than no gate.
14827
+ */
14828
+ var NcDeviceStateConditionSchema = object({
14829
+ deviceId: number().int(),
14830
+ /** Any of these matches. */
14831
+ states: array(string().min(1)).min(1)
14832
+ });
14833
+ /**
14834
+ * "This rule applies only while scene `sceneId` is `matched` / `diverged`."
14835
+ *
14836
+ * A GATE, not a trigger. `occupancy` and `audio` each DISCRIMINATE their rule —
14837
+ * carrying one makes the rule fire on that subject and nothing else. Scene is
14838
+ * the other shape entirely, the `deviceState` shape: it narrows a rule that
14839
+ * already has a trigger ("tell me about a person at the front door, but only
14840
+ * while the bin is still out"). That is why it composes with every delivery
14841
+ * instead of owning one, and why no new `NcDelivery` member and no new subject
14842
+ * kind exist for it — see D159.
14843
+ *
14844
+ * ── Identity ───────────────────────────────────────────────────────────────
14845
+ * `sceneId` is `SceneMonitor.id`, a `randomUUID()` minted by `createScene` —
14846
+ * globally unique, so it needs no device to disambiguate it. `deviceId` is
14847
+ * carried as a HINT for the editor and for the log line, never as part of the
14848
+ * lookup key: a rule whose hint drifted must still gate correctly.
14849
+ *
14850
+ * ── Which boolean ──────────────────────────────────────────────────────────
14851
+ * `latched` ABSENT means "whatever the scene itself says" — `SceneMonitor.emit`
14852
+ * already declares which boolean drives notification rules, and a second knob
14853
+ * that could disagree with it is exactly the D62 failure. Set it only to
14854
+ * override one rule against the scene's own default.
14855
+ *
14856
+ * - LIVE reading (`emit`/`latched` resolve to live): passes iff
14857
+ * `verdict === requiredState`. `unknown` — no reference for this light, view
14858
+ * shifted, no snapshot — passes NEITHER. A scene that cannot judge is not
14859
+ * evidence, in either direction.
14860
+ * - LATCHED reading: passes iff `latched === (requiredState === 'diverged')`.
14861
+ * The latch is a durable fact about the past ("it has diverged since I armed
14862
+ * it"), so a camera that has gone dark does not clear it — that is the whole
14863
+ * reason the operator asked for a latch.
14864
+ *
14865
+ * The gate reads an in-memory mirror (`NcSceneStateCache`) refreshed OFF the
14866
+ * event path, never the cap: D49. A mirror that has never loaded, or a scene it
14867
+ * does not carry, reads absent and the rule does NOT fire — fail closed, and
14868
+ * said out loud in the log rather than dropped in silence.
14869
+ */
14870
+ var NcSceneConditionSchema = object({
14871
+ /** `SceneMonitor.id` — the uuid the cap mints. The whole lookup key. */
14872
+ sceneId: string().min(1),
14873
+ /** The camera the scene lives on. A hint for the editor and the log line. */
14874
+ deviceId: number().int().optional(),
14875
+ /** The state the scene must be in for the rule to fire. */
14876
+ requiredState: _enum(["matched", "diverged"]),
14877
+ /**
14878
+ * Read the LATCH (`true`) or the LIVE verdict (`false`). Absent = follow the
14879
+ * scene's own `emit` field, which is the only place that decision belongs.
14880
+ */
14881
+ latched: boolean().optional()
14882
+ });
14553
14883
  var NcConditionsSchema = object({
14554
14884
  /** Gate on ANOTHER device's current state (the alarm armed, a switch on). */
14555
- deviceState: object({
14556
- deviceId: number().int(),
14557
- /** Any of these matches. */
14558
- states: array(string().min(1)).min(1)
14559
- }).optional(),
14885
+ deviceState: NcDeviceStateConditionSchema.optional(),
14886
+ /**
14887
+ * Gate on a SCENE's state — "only while the bin is still out". Composes with
14888
+ * every trigger (detection, occupancy, audio, sensor, package, track-end);
14889
+ * unlike `occupancy`/`audio` it discriminates nothing. See
14890
+ * {@link NcSceneCondition} and D159.
14891
+ */
14892
+ scene: NcSceneConditionSchema.optional(),
14560
14893
  /** Device scope — absent = all devices. */
14561
14894
  devices: array(number()).optional(),
14562
14895
  /** Detector class names (any overlap with the record's class set). */
@@ -14582,18 +14915,47 @@ var NcConditionsSchema = object({
14582
14915
  */
14583
14916
  labelEquals: array(string().min(1)).optional(),
14584
14917
  /**
14585
- * Identity matcher. P1 boundary: matched against the record's collapsed
14586
- * `label` (the identity display name propagated by the face pipeline) —
14587
- * identity-ID matching rides in P2 when identity ids reach the record.
14918
+ * KNOWN FACES — the rule's identity scope, and the switch that says the rule
14919
+ * is about recognised people at all.
14920
+ *
14921
+ * Three states, and the empty one is the point:
14922
+ *
14923
+ * | value | meaning |
14924
+ * | --- | --- |
14925
+ * | absent | the rule does not care who it is; an unrecognised person matches |
14926
+ * | `[]` | **only known faces** — any identity in the gallery, nobody in particular |
14927
+ * | a list | only these identities |
14928
+ *
14929
+ * `[]` is the repo-wide "no selection = no narrowing" reading (an absent
14930
+ * `devices` list is every device), applied one level down: the operator has
14931
+ * turned the face scope ON and narrowed it to nothing, which is every known
14932
+ * face. No second field states the same thing — a switch that can disagree
14933
+ * with the list under it is worse than no switch (D62).
14934
+ *
14935
+ * MEMBERS ARE FACE-GALLERY `Identity.id`s (uuid), not display names. A name is
14936
+ * renameable, and a rule authored on "Gianluca" went silently dark the moment
14937
+ * the operator fixed the spelling. The id reaches the record on
14938
+ * `LabelAttribution.identityId`; the name is what the editor shows and what
14939
+ * `{{label}}` renders.
14940
+ *
14941
+ * Rules written before this carry NAMES, and are resolved to ids lazily at
14942
+ * load (`NcRuleStore.load`) against the live gallery — a name nothing answers
14943
+ * for is left as it stands and reported, never dropped. The engine also
14944
+ * accepts a display-name hit as a compatibility leg, so a rule whose
14945
+ * migration could not resolve keeps matching exactly what it matched before.
14588
14946
  */
14589
14947
  identities: array(string().min(1)).optional(),
14590
- /** Fuzzy plate matcher against the record's `label` (plate text). */
14948
+ /**
14949
+ * KNOWN PLATES / VEHICLES — the plate mirror of {@link identities}, including
14950
+ * the empty-list reading: `values: []` is "any plate the OCR could read",
14951
+ * a non-empty list is those plates (fuzzily). See {@link NcPlateMatcherSchema}.
14952
+ */
14591
14953
  plates: NcPlateMatcherSchema.optional(),
14592
14954
  /**
14593
- * Identity EXCLUDE — mirror of {@link identities} with `notIn` semantics.
14594
- * Same P1 boundary: matched against the record's collapsed `label` (the
14595
- * identity display name). A record with NO label passes (nothing to
14596
- * exclude), unlike the include variant which fails on an absent label.
14955
+ * Identity EXCLUDE — mirror of {@link identities} with `notIn` semantics, and
14956
+ * the same id members and the same lazy name→id migration. A record with NO
14957
+ * identity passes (nothing to exclude), unlike the include variant which
14958
+ * fails on an unrecognised subject. An EMPTY list excludes nobody.
14597
14959
  */
14598
14960
  identitiesExclude: array(string().min(1)).optional(),
14599
14961
  /**
@@ -14985,7 +15347,80 @@ var NcRuleInputSchema = object({
14985
15347
  * a rule that predates the gate must keep delivering byte-for-byte as it
14986
15348
  * did, and absent is the only way to say that without a migration.
14987
15349
  */
14988
- confirm: NcConfirmSchema.optional()
15350
+ confirm: NcConfirmSchema.optional(),
15351
+ /**
15352
+ * WAIT for face/plate recognition before saying anything.
15353
+ *
15354
+ * A notification's TEXT is frozen at enqueue and its media is re-resolved at
15355
+ * send; the identity is neither. A face is confirmed after `confirmFrames`
15356
+ * agreeing observations — p50 **11.4 s** after the track was first seen,
15357
+ * measured on this hub — and an `immediate` rule enqueues on the first object
15358
+ * event, seconds before that. So "Gianluca è arrivato" is unsayable on the
15359
+ * immediate path, and no amount of media re-resolution fixes a sentence.
15360
+ *
15361
+ * Only two honest answers exist, and this flag picks between them. It has
15362
+ * effect ONLY on a rule that declares a recognition scope
15363
+ * ({@link NcConditions.identities} or {@link NcConditions.plates}) — on any
15364
+ * other rule there is nothing to wait for and the flag is inert.
15365
+ *
15366
+ * | value | what happens |
15367
+ * | --- | --- |
15368
+ * | `true` | the rule stops firing on the object event and fires at TRACK CLOSE instead, once, with the name — later, and complete |
15369
+ * | absent / `false` | it fires at once WITHOUT the name, and if recognition lands before the track closes a SECOND, "…is Gianluca" notification follows (one per track, per rule, per target) |
15370
+ *
15371
+ * `.optional()` and deliberately NOT `.default()`: a Zod default does not run
15372
+ * on the addon cap path, and absent has to keep meaning exactly what every
15373
+ * rule authored before this field meant.
15374
+ *
15375
+ * The cost of `true` is stated here because the editor states it too: a rule
15376
+ * that waits also inherits track-close SEMANTICS — its `zones` condition
15377
+ * tests every zone the track visited and a `crossing` condition can no longer
15378
+ * be satisfied, because a closed track carries no crossing.
15379
+ */
15380
+ waitForEnhancement: boolean().optional(),
15381
+ /**
15382
+ * GROUP a burst of subjects into ONE notification that grows.
15383
+ *
15384
+ * Seconds of quiet after the last matching subject before the burst is
15385
+ * considered over. While it is open, the first subject enqueues immediately —
15386
+ * **exactly as today, with no added latency** — and every real growth (a new
15387
+ * subject, or a name confirmed on one already in it) REPLACES that
15388
+ * notification with an updated one naming everybody. The push carries the
15389
+ * group's own coalescing tag, so the phone replaces rather than stacks.
15390
+ *
15391
+ * `0` / absent = off, and off is today's behaviour byte for byte.
15392
+ *
15393
+ * ### Why an idle cutoff and not a window
15394
+ *
15395
+ * The measured seven-person arrival on device 590 spans 110 s with every
15396
+ * internal gap under 30 s. A 12 s fixed window cuts it into three groups; an
15397
+ * idle cutoff holds it as one and ends it when the arrival actually ends.
15398
+ * 30 is Frigate's shipped value for the same decision.
15399
+ *
15400
+ * ### What it replaces
15401
+ *
15402
+ * The blind cooldown, which collapses a burst by DISCARDING it. Measured on
15403
+ * device 615 / *Persona su Uscio* over six days: 116 qualifying tracks → 74
15404
+ * notifications, **44 (37.9%) suppressed outright**, 23 of them overlapping a
15405
+ * track that did fire and 7 carrying a confirmed identity nobody heard about.
15406
+ * A group collapses the same volume by MERGING, so the cooldown becomes a
15407
+ * budget over GROUPS — which is what it always meant — and a growth is never
15408
+ * throttled by the window its own first member spent.
15409
+ *
15410
+ * ### Interaction with {@link waitForEnhancement}
15411
+ *
15412
+ * They compose, and the order matters. `waitForEnhancement` defers the rule to
15413
+ * TRACK CLOSE, so with both set the group is opened by the first member to
15414
+ * CLOSE — already carrying its name — and grows as later members close. That
15415
+ * is later, and complete. With grouping alone the group opens on the first
15416
+ * object event and picks up names as they are confirmed, through the growth
15417
+ * path. Neither combination fires twice for one subject.
15418
+ *
15419
+ * `.optional()` and deliberately NOT `.default()`: a Zod default does not run
15420
+ * on the addon cap path, so absent must keep meaning what it meant before this
15421
+ * field existed.
15422
+ */
15423
+ groupIdleSec: number().int().min(0).max(600).optional()
14989
15424
  });
14990
15425
  /**
14991
15426
  * Partial patch for `updateRule` — any subset of the input fields, plus the
@@ -15092,6 +15527,7 @@ var NcConditionDescriptorSchema = object({
15092
15527
  "occupancy",
15093
15528
  "audio",
15094
15529
  "deviceState",
15530
+ "scene",
15095
15531
  "systemEvent"
15096
15532
  ]),
15097
15533
  operator: _enum([
@@ -15497,7 +15933,87 @@ var MethodAccessSchema = _enum([
15497
15933
  var AllowedProviderSchema = union([literal("*"), array(string())]);
15498
15934
  var AllowedDevicesSchema = record(string(), union([literal("*"), array(string())]));
15499
15935
  var CapScopeSchema = _enum(["device", "system"]);
15500
- var TokenScopeSchema = discriminatedUnion("type", [
15936
+ /**
15937
+ * DeviceSelector (scope model v3 — 2026-08-12).
15938
+ *
15939
+ * A `device` grant no longer carries a frozen list of deviceIds. It carries
15940
+ * a SELECTOR the matcher resolves against the live fleet, so the grant can be
15941
+ * DYNAMIC: a `types:['camera']` selector automatically covers a camera added
15942
+ * AFTER the grant was minted — no re-grant, no re-login.
15943
+ *
15944
+ * - `all` — every device in the deployment. The broad viewer/operator
15945
+ * lever without a `category` grant (a `category` grant also covers device
15946
+ * caps that carry no deviceId; `all` is specifically the device set).
15947
+ * - `ids` — an explicit deviceId list. This is what a v2 `device:[…]`
15948
+ * grant migrates to (see {@link TokenScopeSchema}); STATIC — a new camera
15949
+ * is NOT covered until the grant is edited.
15950
+ * - `types` — every device of a `DeviceType` (e.g. every `camera`).
15951
+ * DYNAMIC. A device that changes type, or a new device of the type,
15952
+ * re-resolves on the next request.
15953
+ * - `locations` — every device whose operator-assigned `location` label is
15954
+ * in the set (e.g. "Garden", "Front door"). DYNAMIC. A device with a
15955
+ * null/unset location matches NO `locations` selector.
15956
+ */
15957
+ var DeviceSelectorSchema = discriminatedUnion("kind", [
15958
+ object({ kind: literal("all") }),
15959
+ object({
15960
+ kind: literal("ids"),
15961
+ ids: array(number().int()).min(1)
15962
+ }),
15963
+ object({
15964
+ kind: literal("types"),
15965
+ types: array(_enum(DeviceType)).min(1)
15966
+ }),
15967
+ object({
15968
+ kind: literal("locations"),
15969
+ locations: array(string().min(1)).min(1)
15970
+ })
15971
+ ]);
15972
+ var DeviceTokenScopeSchema = object({
15973
+ type: literal("device"),
15974
+ /** The device SET this grant covers — resolved against the live fleet. */
15975
+ selector: DeviceSelectorSchema,
15976
+ access: array(MethodAccessSchema).min(1),
15977
+ /**
15978
+ * Whether a grant on a PARENT device transparently covers its accessory
15979
+ * CHILDREN (siren / floodlight / PIR) via the persisted-parentage walk.
15980
+ * Direction is parent → children ONLY.
15981
+ *
15982
+ * Absent → the matcher DERIVES it from the access flavour: `view`
15983
+ * inherits (a camera viewer sees the camera's accessories), `create` /
15984
+ * `delete` do NOT (actuating/removing a child is an explicit act the
15985
+ * operator must grant on the child, not inherit from the parent). Set it
15986
+ * explicitly to override that default per grant.
15987
+ */
15988
+ includeLinked: boolean().optional()
15989
+ });
15990
+ /**
15991
+ * v2 → v3 lazy migration. A pre-v3 `device` grant carried
15992
+ * `targets: string[]` (stringified deviceIds); it rewrites to the equivalent
15993
+ * `selector: {kind:'ids', ids}`. Applied as a `preprocess` so it runs on
15994
+ * EVERY parse path — stored records AND the JWT-carried scope arrays
15995
+ * normalised at the request boundary ({@link normalizeTokenScopes} in
15996
+ * `device-selector.ts`). Chosen over a one-time DB migration because a
15997
+ * migration cannot reach a JWT already in a client's hands; parse-time
15998
+ * migration covers both without a flag day. No cast — the raw object is read
15999
+ * through `Reflect.get` (its static type is `unknown`).
16000
+ */
16001
+ function migrateLegacyTokenScope(raw) {
16002
+ if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return raw;
16003
+ if (Reflect.get(raw, "type") !== "device") return raw;
16004
+ if (Reflect.get(raw, "selector") !== void 0) return raw;
16005
+ const targets = Reflect.get(raw, "targets");
16006
+ if (!Array.isArray(targets)) return raw;
16007
+ return {
16008
+ type: "device",
16009
+ selector: {
16010
+ kind: "ids",
16011
+ ids: targets.map((t) => typeof t === "string" ? Number(t) : t).filter((n) => typeof n === "number" && Number.isInteger(n))
16012
+ },
16013
+ access: Reflect.get(raw, "access")
16014
+ };
16015
+ }
16016
+ var TokenScopeSchema = preprocess(migrateLegacyTokenScope, discriminatedUnion("type", [
15501
16017
  object({
15502
16018
  type: literal("category"),
15503
16019
  target: CapScopeSchema,
@@ -15513,18 +16029,8 @@ var TokenScopeSchema = discriminatedUnion("type", [
15513
16029
  target: string(),
15514
16030
  access: array(MethodAccessSchema).min(1)
15515
16031
  }),
15516
- object({
15517
- type: literal("device"),
15518
- /**
15519
- * One or more deviceIds (serialised as strings for wire-format
15520
- * consistency with the rest of the union). Matcher accepts if
15521
- * `input.deviceId` ∈ `targets`. Array shape avoids the row-explosion
15522
- * of one scope-per-device when granting access to a set of cameras.
15523
- */
15524
- targets: array(string()).min(1),
15525
- access: array(MethodAccessSchema).min(1)
15526
- })
15527
- ]);
16032
+ DeviceTokenScopeSchema
16033
+ ]));
15528
16034
  object({
15529
16035
  id: string(),
15530
16036
  username: string(),
@@ -15847,7 +16353,7 @@ var TrackEnvelopeSchema = object({
15847
16353
  * `snapshots[]` references — megabytes across a page of tracks. `slim`
15848
16354
  * keeps every scalar the list surfaces actually render (ids, class(es),
15849
16355
  * label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
15850
- * zonesVisited, bestEventId, envelope, hasFace) and returns `positions` /
16356
+ * zonesVisited, bestEventId, envelope, hasFace, hasRider) and returns `positions` /
15851
16357
  * `snapshots` as EMPTY arrays — detail views re-fetch the full row via
15852
16358
  * `getTrack`. Mirrors the event-store `projection` convention
15853
16359
  * (`getObjectEvents` et al.).
@@ -15983,7 +16489,21 @@ union([literal(1), literal(2)]);
15983
16489
  var LabelAttributionSchema = object({
15984
16490
  stepId: string(),
15985
16491
  modelId: string().optional(),
15986
- decidedAt: number()
16492
+ decidedAt: number(),
16493
+ /**
16494
+ * The GALLERY id behind a recognised tier-2 label — a face-gallery
16495
+ * `Identity.id` or a plate-gallery `Vehicle.id` (both `randomUUID`).
16496
+ *
16497
+ * The text alone is a DISPLAY NAME, and a display name is renameable: a
16498
+ * notification rule authored on "Gianluca" stopped matching the moment the
16499
+ * operator fixed the spelling in the gallery, and nothing said so. The id is
16500
+ * the thing that does not move, so it is what a rule matches on
16501
+ * (`NcConditions.identities`) and the text is what a human is shown.
16502
+ *
16503
+ * Absent when the label names no gallery row — a plate the OCR read but no
16504
+ * vehicle claims, a sub-class, a species, any tier-1 value.
16505
+ */
16506
+ identityId: string().optional()
15987
16507
  });
15988
16508
  /**
15989
16509
  * The TIERED label model (roadmap 4g), spread into `TrackSchema` and
@@ -16120,6 +16640,28 @@ var TrackSchema = object({
16120
16640
  * `=== true` and render nothing otherwise, never infer "no face".
16121
16641
  */
16122
16642
  hasFace: boolean().optional(),
16643
+ /**
16644
+ * This subject CONTAINS a folded rider — a person the rider-pairing step
16645
+ * ([D34](../decisions/adr-0034.md)) removed from the frame BEFORE the tracker,
16646
+ * so the passage is tracked once and as a VEHICLE.
16647
+ *
16648
+ * It exists because the fold's record was dishonest. D34 and the code both
16649
+ * said "the person is not lost — it is reported so both entities stay on the
16650
+ * record"; in fact the pair went into a per-processor RAM field behind an
16651
+ * accessor nobody called, and every durable surface said `vehicle`, full
16652
+ * stop. This is the composition note that makes the row true.
16653
+ *
16654
+ * A COMPOSITION, never a class and never a label. "This vehicle contains a
16655
+ * person" is not an answer to "what is this" — both label tiers would refuse
16656
+ * a macro token anyway (D89), and correctly. Nothing here changes what the
16657
+ * subject IS: a cyclist stays one vehicle track, occupancy still counts one,
16658
+ * and a `person` rule still does not fire for someone cycling past.
16659
+ *
16660
+ * **Absent ≠ false**, exactly like {@link hasFace}: every row written before
16661
+ * the column, and every hub that predates the field, omits it. Test
16662
+ * `=== true` and render nothing otherwise — never infer "no rider".
16663
+ */
16664
+ hasRider: boolean().optional(),
16123
16665
  ...TrackFlagFields,
16124
16666
  ...TrackRetrainFields
16125
16667
  });
@@ -17515,6 +18057,17 @@ var maxSessionHoldMsField = {
17515
18057
  default: 12e4,
17516
18058
  step: 5e3
17517
18059
  };
18060
+ /**
18061
+ * Quiet period that closes an `audioMode: 'on-motion'` audio window. Floor of
18062
+ * 5s so a rearm can never degenerate into per-event stream churn; default 90s
18063
+ * comfortably outlives the gap between two PIR wakes on a battery camera.
18064
+ */
18065
+ var audioMotionWindowMsField = {
18066
+ min: 5e3,
18067
+ max: 6e5,
18068
+ default: 9e4,
18069
+ step: 5e3
18070
+ };
17518
18071
  var motionFpsField = {
17519
18072
  min: 1,
17520
18073
  max: 30,
@@ -17546,7 +18099,7 @@ var detectionFpsField = {
17546
18099
  var occupancyRecheckSecField = {
17547
18100
  min: 0,
17548
18101
  max: 300,
17549
- default: 30,
18102
+ default: 300,
17550
18103
  step: 5
17551
18104
  };
17552
18105
  var occupancyRecheckFramesField = {
@@ -17691,6 +18244,27 @@ var RunnerCameraConfigSchema = object({
17691
18244
  * resolved `CameraDetectionConfig`.
17692
18245
  */
17693
18246
  maxSessionHoldMs: number().min(maxSessionHoldMsField.min).max(maxSessionHoldMsField.max).optional(),
18247
+ /**
18248
+ * Orchestrator-side quiet period (ms) that closes an `audioMode:
18249
+ * 'on-motion'` audio window, measured from the LAST motion event.
18250
+ *
18251
+ * This exists because the falling edge cannot be relied on. Camera-native
18252
+ * providers emit motion as a RISING EDGE ONLY (Reolink's Baichuan push and
18253
+ * its email-push SMTP path both emit `detected: true` and never the
18254
+ * counterpart); only the frame-diff analyzer emits falls. So on an
18255
+ * onboard-only camera a window that closed only on `detected: false` never
18256
+ * closed at all, and `on-motion` silently behaved as `always-on` — on a
18257
+ * battery camera, the one failure mode the mode exists to prevent.
18258
+ *
18259
+ * Every motion event rearms this timer WITHOUT restarting the stream, so a
18260
+ * burst of re-fires costs nothing. A falling edge, when one does arrive,
18261
+ * still closes earlier via `motionCooldownMs` — whichever comes first wins.
18262
+ *
18263
+ * Not consumed by the runner: carried here so it shares the per-camera
18264
+ * device-settings surface with `motionCooldownMs`, exactly like
18265
+ * `maxSessionHoldMs`.
18266
+ */
18267
+ audioMotionWindowMs: number().min(audioMotionWindowMsField.min).max(audioMotionWindowMsField.max).optional(),
17694
18268
  motionFps: number().min(motionFpsField.min).max(motionFpsField.max).default(motionFpsField.default),
17695
18269
  detectionFps: number().min(detectionFpsField.min).max(detectionFpsField.max).default(detectionFpsField.default),
17696
18270
  motionStreamId: string(),
@@ -17786,7 +18360,7 @@ var RunnerCameraConfigSchema = object({
17786
18360
  */
17787
18361
  inferenceDevices: array(RunnerInferenceDeviceSchema).readonly().optional()
17788
18362
  });
17789
- motionFpsField.min, motionFpsField.max, motionFpsField.step, motionFpsField.default, detectionFpsField.min, detectionFpsField.max, detectionFpsField.step, detectionFpsField.default, motionCooldownMsField.min, motionCooldownMsField.max, motionCooldownMsField.step, motionCooldownMsField.default, maxSessionHoldMsField.min, maxSessionHoldMsField.max, maxSessionHoldMsField.step, maxSessionHoldMsField.default, occupancyRecheckSecField.min, occupancyRecheckSecField.max, occupancyRecheckSecField.step, occupancyRecheckSecField.default, occupancyRecheckFramesField.min, occupancyRecheckFramesField.max, occupancyRecheckFramesField.step, occupancyRecheckFramesField.default;
18363
+ motionFpsField.min, motionFpsField.max, motionFpsField.step, motionFpsField.default, detectionFpsField.min, detectionFpsField.max, detectionFpsField.step, detectionFpsField.default, motionCooldownMsField.min, motionCooldownMsField.max, motionCooldownMsField.step, motionCooldownMsField.default, maxSessionHoldMsField.min, maxSessionHoldMsField.max, maxSessionHoldMsField.step, maxSessionHoldMsField.default, audioMotionWindowMsField.min, audioMotionWindowMsField.max, audioMotionWindowMsField.step, audioMotionWindowMsField.default, occupancyRecheckSecField.min, occupancyRecheckSecField.max, occupancyRecheckSecField.step, occupancyRecheckSecField.default, occupancyRecheckFramesField.min, occupancyRecheckFramesField.max, occupancyRecheckFramesField.step, occupancyRecheckFramesField.default;
17790
18364
  /**
17791
18365
  * Runtime load summary returned by `getLocalLoad`. Used by the orchestrator's
17792
18366
  * load-balancing levels (L2 capacity-based, L3 hardware-aware) to decide
@@ -20324,6 +20898,25 @@ var BatteryStatusSchema = object({
20324
20898
  /** Ms epoch of the last observation. Lets consumers reason about freshness. */
20325
20899
  lastUpdated: number(),
20326
20900
  /**
20901
+ * Ms epoch of the last time the device PROVED it was reachable — a
20902
+ * completed firmware round-trip, an observed wake, or an inbound push
20903
+ * (firmware event, email). `0`/absent = never since this slice was born.
20904
+ *
20905
+ * This is the ONLY input that separates "asleep" from "gone", and it is
20906
+ * fed exclusively by PASSIVE signals: nothing may write it by reaching
20907
+ * for the radio, because a poll that confirms reachability is the same
20908
+ * poll that drains the battery. See {@link deriveBatteryPresence} — the
20909
+ * single derivation every consumer must use; no surface computes its own.
20910
+ *
20911
+ * It is deliberately NOT a clock in the
20912
+ * `scripts/check-runtime-state-durability.ts` sense: it is the
20913
+ * observation itself, and it is the only thing a 30-hour silence is
20914
+ * visible in. Writers quantise it (see `CONTACT_WRITE_QUANTUM_MS` in the
20915
+ * Reolink provider) so a value that means "recently" cannot cost a
20916
+ * SQLite commit per round-trip.
20917
+ */
20918
+ lastContactAt: number().optional(),
20919
+ /**
20327
20920
  * True when the source is a BINARY low-battery indicator (HA
20328
20921
  * `binary_sensor` device_class=battery / `LOW_BAT`) that has no real
20329
20922
  * charge level — `percentage` is then a coarse stand-in (100 = normal,
@@ -23861,7 +24454,7 @@ method(object({
23861
24454
  toMs: number()
23862
24455
  }), RecordingAvailabilitySchema, {
23863
24456
  kind: "query",
23864
- auth: "admin"
24457
+ auth: "protected"
23865
24458
  }), method(object({
23866
24459
  deviceId: number(),
23867
24460
  fromMs: number(),
@@ -23869,14 +24462,14 @@ method(object({
23869
24462
  tzOffsetMinutes: number()
23870
24463
  }), RecordingDaysSchema, {
23871
24464
  kind: "query",
23872
- auth: "admin"
24465
+ auth: "protected"
23873
24466
  }), method(object({
23874
24467
  deviceId: number(),
23875
24468
  fromMs: number(),
23876
24469
  toMs: number()
23877
24470
  }), RecordingManifestSchema, {
23878
24471
  kind: "query",
23879
- auth: "admin"
24472
+ auth: "protected"
23880
24473
  }), method(object({}), RecordingStorageUsageSchema, {
23881
24474
  kind: "query",
23882
24475
  auth: "admin"
@@ -24166,14 +24759,77 @@ method(object({
24166
24759
  * thing except the comparator: `similarity` (CLIP cosine at the same ROI coords
24167
24760
  * vs condition-tagged references) and `llm` (vision-LLM judgment over the crop).
24168
24761
  *
24169
- * D14 device-config archetype (`deviceConfig.ui.kind:'widget'`) — the framework
24170
- * derives the device-detail contribution; the provider carries NO hand-written
24171
- * settings-contribution methods. `status.kind:'push'` — the engine pushes on
24172
- * every hysteresis flip / availability change; consumers never poll.
24173
- */
24174
- /** Extensible condition tag. Seeded 'day' | 'night'; open by design so more can
24175
- * be added without a wire break (matching falls back to any-condition refs). */
24762
+ * **No `deviceConfig`, deliberately.** This shipped as the D14 widget archetype,
24763
+ * which put a "Scenes" tab on one camera's detail page. That is the wrong shape
24764
+ * for the thing: a scene is a standing question about the property ("is the bin
24765
+ * still out"), and the operator's question is "which of my scenes have tripped",
24766
+ * across every camera at once — not "what does camera 617 think". Buried one
24767
+ * camera deep it also could not be found. The surface is now a top-level admin
24768
+ * page (`/scenes`, `pages/Scenes.tsx`) that lists every scene on every camera and
24769
+ * picks the camera inside the create flow, the same shape Events and Faces have.
24770
+ *
24771
+ * The consequence to keep in mind: `host/scene-monitor-editor` is gone from
24772
+ * `HOST_WIDGETS` too. `scripts/check-host-widget-resolves.ts` asserts BOTH
24773
+ * directions, so a registration nobody declares fails exactly as loudly as a
24774
+ * declaration nobody registers. The editor is imported directly by the page.
24775
+ *
24776
+ * `status.kind:'push'` — the engine pushes on every hysteresis flip /
24777
+ * availability change; consumers never poll.
24778
+ */
24779
+ /** Extensible condition tag. Seeded 'day' | 'ir' (the two variants the operator
24780
+ * captures) plus 'night' | 'dawn' | 'dusk' from the resolver's sun-times band.
24781
+ * Open by design so more can be added without a wire break.
24782
+ *
24783
+ * Matching does NOT fall back across conditions: cross-condition cosines are
24784
+ * not comparable, so "I have never seen this scene in this light" is reported
24785
+ * as `unknown`, never guessed. A day reference scored against an IR frame
24786
+ * collapses the cosine and would latch a false alarm every single night. */
24176
24787
  var SceneConditionSchema = string();
24788
+ /**
24789
+ * What a scene does when the CURRENT light has no reference of its own.
24790
+ *
24791
+ * The lighting variants are not equally likely to exist. Almost every operator
24792
+ * captures daylight and then never stands outside at 22:00 to capture IR, and a
24793
+ * scene that is only ever going to be asked about a daytime question ("is the
24794
+ * bin still on the kerb at 08:00") does not need a night reference at all. The
24795
+ * night half must therefore be OPTIONAL, and optional means the scene keeps
24796
+ * working without it rather than degrading into a permanent complaint.
24797
+ *
24798
+ * - `skip` (default) — the check in that light is not made. Not a verdict, not
24799
+ * an alarm, not even an `unknown`: the live state simply stays whatever the
24800
+ * last covered light left it at, the latch is untouched, and the hysteresis
24801
+ * run is neither spent nor cleared. The scene resumes by itself at first
24802
+ * light. This is the only behaviour under which "I never captured IR" is a
24803
+ * configuration choice instead of a nightly fault.
24804
+ * - `judge-anyway` — score against the OTHER conditions' references. Available
24805
+ * for cameras whose IR frame is close enough to daylight (a floodlit
24806
+ * driveway, an always-white-light doorbell), and wrong for everything else:
24807
+ * cross-condition cosines are not comparable, so a day reference against a
24808
+ * true IR frame collapses and the scene reports a theft at 21:40.
24809
+ *
24810
+ * Never applies when the scene has NO comparable reference at all — that is
24811
+ * "not armed yet", it is reported as `no-reference-for-condition`, and silence
24812
+ * there would hide a scene the operator never finished setting up.
24813
+ */
24814
+ var SceneUncoveredPolicySchema = _enum(["skip", "judge-anyway"]);
24815
+ /** `matched` = the baseline is what we see; `diverged` = it demonstrably is not;
24816
+ * `unknown` = we cannot judge (no reference for this condition, encoder model
24817
+ * changed, view shifted, no snapshot). `unknown` is a real value, not a null,
24818
+ * and never counts toward hysteresis in either direction. */
24819
+ var SceneVerdictSchema = _enum([
24820
+ "matched",
24821
+ "diverged",
24822
+ "unknown"
24823
+ ]);
24824
+ /** Why a scene cannot judge. Named, because this feature's failure mode is
24825
+ * silence that reads as "nothing has happened". */
24826
+ var SceneUnavailableSchema = _enum([
24827
+ "no-reference-for-condition",
24828
+ "view-shifted",
24829
+ "no-vision-profile",
24830
+ "encoder-model-changed",
24831
+ "no-snapshot"
24832
+ ]);
24177
24833
  /** One captured reference — condition-tagged, model-version-gated. `embedding`
24178
24834
  * is `number[]` (Float32Array does NOT survive MsgPack/UDS). */
24179
24835
  var SceneReferenceSchema = object({
@@ -24181,7 +24837,14 @@ var SceneReferenceSchema = object({
24181
24837
  modelId: string(),
24182
24838
  condition: SceneConditionSchema,
24183
24839
  capturedAt: number(),
24184
- thumbnailMediaId: string().optional()
24840
+ thumbnailMediaId: string().optional(),
24841
+ /** Whole-frame (downscaled) embedding captured alongside the ROI crop. The
24842
+ * anti-view-shift anchor: a bumped camera, a PTZ preset or a re-aim makes the
24843
+ * normalized rect frame a different piece of world, and the scene would
24844
+ * diverge forever with a perfectly plausible cosine. Checked LAZILY, only
24845
+ * when hysteresis is about to flip — one extra encode per candidate
24846
+ * transition, not per poll. */
24847
+ anchorEmbedding: array(number()).optional()
24185
24848
  });
24186
24849
  var SceneMonitorStateSchema = object({
24187
24850
  id: string(),
@@ -24203,6 +24866,28 @@ var SceneCheckSchema = discriminatedUnion("mode", [object({
24203
24866
  profileId: string().optional(),
24204
24867
  hysteresisCount: number().int().positive()
24205
24868
  })]);
24869
+ var SCENE_DEFAULT_ANCHOR_THRESHOLD = .85;
24870
+ /** Night is OPTIONAL. A scene with only a daylight reference sits the IR hours
24871
+ * out in silence rather than reporting a fault every night. */
24872
+ var SCENE_DEFAULT_UNCOVERED_POLICY = "skip";
24873
+ /**
24874
+ * Vision-model adjudication of a candidate flip. Field names deliberately
24875
+ * mirror `NcConfirmSchema` so an operator meets one vocabulary, not two.
24876
+ *
24877
+ * `onTimeout` defaults to **'hold'**, the OPPOSITE of `NcConfirmGate`'s
24878
+ * fail-open: a notification suppressed is the worse error there, but a vision
24879
+ * model that timed out has not told us the bin is gone, and a latch is a
24880
+ * stateful claim that costs the operator a trip to reset.
24881
+ */
24882
+ var SceneConfirmSchema = object({
24883
+ enabled: boolean().default(false),
24884
+ prompt: string().min(1).max(1e3),
24885
+ profileId: string().optional(),
24886
+ timeoutMs: number().int().min(1e3).max(2e4).default(8e3),
24887
+ maxImagePx: number().int().min(64).max(2048).default(448),
24888
+ /** What a timeout / unavailable model means for the PENDING flip. */
24889
+ onTimeout: _enum(["flip", "hold"]).default("hold")
24890
+ });
24206
24891
  var SceneMonitorSchema = object({
24207
24892
  id: string(),
24208
24893
  label: string(),
@@ -24221,7 +24906,56 @@ var SceneMonitorSchema = object({
24221
24906
  lastConfidence: number().nullable(),
24222
24907
  currentCondition: SceneConditionSchema.nullable(),
24223
24908
  availability: _enum(["ok", "unavailable"]),
24224
- unavailableReason: string().nullable()
24909
+ unavailableReason: string().nullable(),
24910
+ /** Which state is "the initial screen". `null` until the first capture. */
24911
+ baselineStateId: string().nullable(),
24912
+ /** Which boolean drives notification rules and any export. */
24913
+ emit: _enum(["latched", "live"]).default("latched"),
24914
+ /** Live: does the region match the baseline RIGHT NOW. */
24915
+ verdict: SceneVerdictSchema,
24916
+ /** Has it been `diverged` at least once since `armedAt` — the operator's boolean. */
24917
+ latched: boolean(),
24918
+ /** Last reset (or creation). */
24919
+ armedAt: number(),
24920
+ divergedAt: number().nullable(),
24921
+ restoredAt: number().nullable(),
24922
+ /** A check is only COUNTED when the device has been quiet this long. Motion
24923
+ * during the window DISCARDS the observation — a car pulling up in front of
24924
+ * the bin must not be able to spend hysteresis credit. */
24925
+ quietSeconds: number().int().min(0).max(3600).default(60),
24926
+ /** An observation only advances the pending count when it is at least this
24927
+ * far from the previously counted one, so N agreeing checks span real time
24928
+ * rather than N adjacent polls inside one occlusion. */
24929
+ minObservationSpacingSec: number().int().min(0).max(3600).default(120),
24930
+ /** Vision-model adjudication of a candidate flip. Similarity primary only. */
24931
+ confirm: SceneConfirmSchema.optional(),
24932
+ /** Whole-frame anchor cosine below which a flip is REFUSED as `view-shifted`. */
24933
+ anchorThreshold: number().min(0).max(1).default(SCENE_DEFAULT_ANCHOR_THRESHOLD),
24934
+ /** Clear the latch on its own when the scene matches again? Default false —
24935
+ * `restoredAt` and the `scene-restored` edge are recorded regardless, so an
24936
+ * automation can react to the bin coming back without the operator's own
24937
+ * alarm silently clearing itself. */
24938
+ autoRestore: boolean().default(false),
24939
+ /** What to do when the current light has no reference of its own. See
24940
+ * {@link SceneUncoveredPolicySchema} — the default makes night OPTIONAL. */
24941
+ onUncoveredCondition: SceneUncoveredPolicySchema.default(SCENE_DEFAULT_UNCOVERED_POLICY),
24942
+ /**
24943
+ * The light whose checks are currently being SAT OUT under
24944
+ * `onUncoveredCondition: 'skip'` — `null` when the scene is checking normally.
24945
+ *
24946
+ * Engine-reported and advisory only: it moves no verdict, no latch and no
24947
+ * hysteresis. It exists so the card can say *"night (IR) — checks paused,
24948
+ * nothing captured in this light"* in the same calm voice as the coverage
24949
+ * line, because the alternative is a scene that silently stops answering
24950
+ * after sunset with nothing anywhere saying why. A skipped check must never
24951
+ * read as a broken one.
24952
+ */
24953
+ suspendedCondition: SceneConditionSchema.nullable().default(null),
24954
+ /** Named cause when `verdict === 'unknown'`. */
24955
+ unavailable: SceneUnavailableSchema.nullable(),
24956
+ /** Conditions that have at least one comparable reference — the coverage line
24957
+ * ("day ✓ · ir ✓ · dusk ✗") that turns a silent fallback into a visible fact. */
24958
+ coveredConditions: array(SceneConditionSchema)
24225
24959
  });
24226
24960
  var SceneMonitorStatusSchema = object({
24227
24961
  monitors: array(SceneMonitorSchema),
@@ -24254,7 +24988,15 @@ DeviceType.Camera, method(object({ deviceId: number() }), SceneMonitorStatusSche
24254
24988
  "both"
24255
24989
  ]).optional(),
24256
24990
  checkIntervalSec: number().optional(),
24257
- check: SceneCheckSchema.optional()
24991
+ check: SceneCheckSchema.optional(),
24992
+ emit: _enum(["latched", "live"]).optional(),
24993
+ quietSeconds: number().int().min(0).max(3600).optional(),
24994
+ minObservationSpacingSec: number().int().min(0).max(3600).optional(),
24995
+ anchorThreshold: number().min(0).max(1).optional(),
24996
+ autoRestore: boolean().optional(),
24997
+ onUncoveredCondition: SceneUncoveredPolicySchema.optional(),
24998
+ /** `null` clears the vision-model adjudicator. */
24999
+ confirm: SceneConfirmSchema.nullable().optional()
24258
25000
  })
24259
25001
  }), _void(), {
24260
25002
  kind: "mutation",
@@ -24291,6 +25033,14 @@ DeviceType.Camera, method(object({ deviceId: number() }), SceneMonitorStatusSche
24291
25033
  }), _void(), {
24292
25034
  kind: "mutation",
24293
25035
  auth: "admin"
25036
+ }), method(object({
25037
+ deviceId: number(),
25038
+ monitorId: string(),
25039
+ /** Defaults to TRUE at the provider seam — see `SCENE_RESET_RECAPTURES`. */
25040
+ recapture: boolean().optional()
25041
+ }), _void(), {
25042
+ kind: "mutation",
25043
+ auth: "admin"
24294
25044
  });
24295
25045
  /**
24296
25046
  * Per-stage gating mode applied to the zones a rule references.
@@ -24444,6 +25194,16 @@ var CamStreamDescriptorSchema = object({
24444
25194
  /** Transport-specific opaque metadata (e.g. rfc4571 SDP). */
24445
25195
  metadata: record(string(), unknown()).optional()
24446
25196
  });
25197
+ object({
25198
+ /** The descriptors as last built from a real camera response. Never a guess:
25199
+ * a failed or refused build writes NOTHING, so a restored catalog is always
25200
+ * one the camera itself once produced. */
25201
+ descriptors: array(CamStreamDescriptorSchema),
25202
+ /** Ms epoch of the build that produced {@link descriptors}. Lets the wake
25203
+ * path decide whether the camera's own awake window is worth spending on a
25204
+ * re-read. */
25205
+ lastFetchedAt: number()
25206
+ });
24447
25207
  DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), array(CamStreamDescriptorSchema).readonly());
24448
25208
  /** One of the camera's stream profiles. */
24449
25209
  var StreamProfileSchema = _enum([
@@ -24599,12 +25359,64 @@ var NetworkAddressSchema = object({
24599
25359
  family: string(),
24600
25360
  internal: boolean()
24601
25361
  });
25362
+ /**
25363
+ * Provenance of the site coordinates, and the whole reason this is not just two
25364
+ * numbers.
25365
+ *
25366
+ * - `operator-set` — a human typed it, or accepted a detection. Authoritative;
25367
+ * nothing overwrites it.
25368
+ * - `derived-from-ip` — the hub geolocated its own public IP once, because a
25369
+ * default that is right to a few kilometres beats the coarse UTC clock split
25370
+ * the sun-times consumers otherwise fall back to.
25371
+ *
25372
+ * The UI shows which one it is. An operator who cannot tell a guess from their
25373
+ * own input will eventually trust the guess.
25374
+ */
25375
+ var SiteLocationSourceSchema = _enum(["operator-set", "derived-from-ip"]);
25376
+ /**
25377
+ * The read shape: the location plus the honest state of the one-shot derivation.
25378
+ *
25379
+ * `derivationAttemptedAt` is what makes the "one call, ever" contract
25380
+ * inspectable. When it is set and `location` is null, the geo-IP lookup ran and
25381
+ * failed; the hub will NOT try again on its own — the fallback is declared
25382
+ * (consumers degrade to their own last resort) and the operator either types the
25383
+ * coordinates or presses detect.
25384
+ */
25385
+ var SiteLocationStatusSchema = object({
25386
+ location: object({
25387
+ /** WGS84 decimal degrees. */
25388
+ latitude: number().min(-90).max(90),
25389
+ longitude: number().min(-180).max(180),
25390
+ source: SiteLocationSourceSchema,
25391
+ /** Epoch ms the value was last written. */
25392
+ updatedAt: number(),
25393
+ /**
25394
+ * Human-readable place the geo-IP service reported ("Napoli, IT"). Display
25395
+ * only — never parsed, never matched on. Absent for an operator-typed value.
25396
+ */
25397
+ label: string().optional()
25398
+ }).nullable(),
25399
+ derivationAttemptedAt: number().nullable(),
25400
+ /** Why the last derivation failed, for the UI to show instead of a shrug. */
25401
+ derivationError: string().nullable()
25402
+ });
25403
+ /** `null` clears the location and re-arms nothing — the derivation stays spent. */
25404
+ var SetSiteLocationInputSchema = object({
25405
+ latitude: number().min(-90).max(90),
25406
+ longitude: number().min(-180).max(180)
25407
+ }).nullable();
24602
25408
  method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), method(_void(), FeatureManifestSchema), method(_void(), array(NetworkAddressSchema).readonly()), method(_void(), unknown().nullable(), { auth: "admin" }), method(record(string(), unknown()), _null(), {
24603
25409
  kind: "mutation",
24604
25410
  auth: "admin"
24605
25411
  }), method(_void(), _void(), {
24606
25412
  kind: "mutation",
24607
25413
  auth: "admin"
25414
+ }), method(_void(), SiteLocationStatusSchema), method(SetSiteLocationInputSchema, SiteLocationStatusSchema, {
25415
+ kind: "mutation",
25416
+ auth: "admin"
25417
+ }), method(_void(), SiteLocationStatusSchema, {
25418
+ kind: "mutation",
25419
+ auth: "admin"
24608
25420
  });
24609
25421
  object({
24610
25422
  /** True when the device's tamper switch / case-open contact is
@@ -27334,6 +28146,12 @@ Object.freeze({
27334
28146
  addonId: null,
27335
28147
  access: "create"
27336
28148
  },
28149
+ "llm.cancel": {
28150
+ capName: "llm",
28151
+ capScope: "system",
28152
+ addonId: null,
28153
+ access: "create"
28154
+ },
27337
28155
  "llm.deleteModel": {
27338
28156
  capName: "llm",
27339
28157
  capScope: "system",
@@ -27418,6 +28236,12 @@ Object.freeze({
27418
28236
  addonId: null,
27419
28237
  access: "view"
27420
28238
  },
28239
+ "llm.resolveModelRef": {
28240
+ capName: "llm",
28241
+ capScope: "system",
28242
+ addonId: null,
28243
+ access: "create"
28244
+ },
27421
28245
  "llm.setDefault": {
27422
28246
  capName: "llm",
27423
28247
  capScope: "system",
@@ -29584,6 +30408,12 @@ Object.freeze({
29584
30408
  addonId: null,
29585
30409
  access: "create"
29586
30410
  },
30411
+ "sceneMonitor.resetScene": {
30412
+ capName: "scene-monitor",
30413
+ capScope: "device",
30414
+ addonId: null,
30415
+ access: "delete"
30416
+ },
29587
30417
  "sceneMonitor.updateScene": {
29588
30418
  capName: "scene-monitor",
29589
30419
  capScope: "device",
@@ -30262,6 +31092,12 @@ Object.freeze({
30262
31092
  addonId: null,
30263
31093
  access: "create"
30264
31094
  },
31095
+ "system.detectSiteLocation": {
31096
+ capName: "system",
31097
+ capScope: "system",
31098
+ addonId: null,
31099
+ access: "create"
31100
+ },
30265
31101
  "system.featureFlags": {
30266
31102
  capName: "system",
30267
31103
  capScope: "system",
@@ -30280,6 +31116,12 @@ Object.freeze({
30280
31116
  addonId: null,
30281
31117
  access: "view"
30282
31118
  },
31119
+ "system.getSiteLocation": {
31120
+ capName: "system",
31121
+ capScope: "system",
31122
+ addonId: null,
31123
+ access: "view"
31124
+ },
30283
31125
  "system.health": {
30284
31126
  capName: "system",
30285
31127
  capScope: "system",
@@ -30304,6 +31146,12 @@ Object.freeze({
30304
31146
  addonId: null,
30305
31147
  access: "create"
30306
31148
  },
31149
+ "system.setSiteLocation": {
31150
+ capName: "system",
31151
+ capScope: "system",
31152
+ addonId: null,
31153
+ access: "create"
31154
+ },
30307
31155
  "terminalSession.adoptLegacyMonitor": {
30308
31156
  capName: "terminal-session",
30309
31157
  capScope: "system",
@@ -30875,6 +31723,1683 @@ Object.freeze({
30875
31723
  access: "create"
30876
31724
  }
30877
31725
  });
31726
+ Object.freeze({
31727
+ "accessories.setChildHidden": [{
31728
+ name: "childDeviceId",
31729
+ form: "single",
31730
+ optional: false
31731
+ }, {
31732
+ name: "deviceId",
31733
+ form: "single",
31734
+ optional: false
31735
+ }],
31736
+ "addonSettings.getDeviceSettings": [{
31737
+ name: "deviceId",
31738
+ form: "single",
31739
+ optional: false
31740
+ }],
31741
+ "addonSettings.updateDeviceSettings": [{
31742
+ name: "deviceId",
31743
+ form: "single",
31744
+ optional: false
31745
+ }],
31746
+ "alarmPanel.arm": [{
31747
+ name: "deviceId",
31748
+ form: "single",
31749
+ optional: false
31750
+ }],
31751
+ "alarmPanel.disarm": [{
31752
+ name: "deviceId",
31753
+ form: "single",
31754
+ optional: false
31755
+ }],
31756
+ "alarmPanel.trigger": [{
31757
+ name: "deviceId",
31758
+ form: "single",
31759
+ optional: false
31760
+ }],
31761
+ "audioAnalysis.resolveDeviceSettings": [{
31762
+ name: "deviceId",
31763
+ form: "single",
31764
+ optional: false
31765
+ }],
31766
+ "audioAnalyzer.classify": [{
31767
+ name: "deviceId",
31768
+ form: "single",
31769
+ optional: true
31770
+ }],
31771
+ "audioMetrics.getCurrentSnapshot": [{
31772
+ name: "deviceId",
31773
+ form: "single",
31774
+ optional: false
31775
+ }],
31776
+ "audioMetrics.getHistory": [{
31777
+ name: "deviceId",
31778
+ form: "single",
31779
+ optional: false
31780
+ }],
31781
+ "automationControl.disable": [{
31782
+ name: "deviceId",
31783
+ form: "single",
31784
+ optional: false
31785
+ }],
31786
+ "automationControl.enable": [{
31787
+ name: "deviceId",
31788
+ form: "single",
31789
+ optional: false
31790
+ }],
31791
+ "automationControl.trigger": [{
31792
+ name: "deviceId",
31793
+ form: "single",
31794
+ optional: false
31795
+ }],
31796
+ "battery.wakeForStream": [{
31797
+ name: "deviceId",
31798
+ form: "single",
31799
+ optional: false
31800
+ }],
31801
+ "brightness.setBrightness": [{
31802
+ name: "deviceId",
31803
+ form: "single",
31804
+ optional: false
31805
+ }],
31806
+ "button.press": [{
31807
+ name: "deviceId",
31808
+ form: "single",
31809
+ optional: false
31810
+ }],
31811
+ "cameraCredentials.getCredentials": [{
31812
+ name: "deviceId",
31813
+ form: "single",
31814
+ optional: false
31815
+ }],
31816
+ "cameraStreams.getBrokerStreams": [{
31817
+ name: "deviceId",
31818
+ form: "single",
31819
+ optional: false
31820
+ }],
31821
+ "cameraStreams.getCameraStreams": [{
31822
+ name: "deviceId",
31823
+ form: "single",
31824
+ optional: false
31825
+ }],
31826
+ "cameraStreams.getProfileRtspEntries": [{
31827
+ name: "deviceId",
31828
+ form: "single",
31829
+ optional: false
31830
+ }],
31831
+ "cameraStreams.getRtspEntries": [{
31832
+ name: "deviceId",
31833
+ form: "single",
31834
+ optional: false
31835
+ }],
31836
+ "cameraStreams.pickStream": [{
31837
+ name: "deviceId",
31838
+ form: "single",
31839
+ optional: false
31840
+ }],
31841
+ "climateControl.setFanMode": [{
31842
+ name: "deviceId",
31843
+ form: "single",
31844
+ optional: false
31845
+ }],
31846
+ "climateControl.setMode": [{
31847
+ name: "deviceId",
31848
+ form: "single",
31849
+ optional: false
31850
+ }],
31851
+ "climateControl.setPreset": [{
31852
+ name: "deviceId",
31853
+ form: "single",
31854
+ optional: false
31855
+ }],
31856
+ "climateControl.setSwingHorizontal": [{
31857
+ name: "deviceId",
31858
+ form: "single",
31859
+ optional: false
31860
+ }],
31861
+ "climateControl.setSwingVertical": [{
31862
+ name: "deviceId",
31863
+ form: "single",
31864
+ optional: false
31865
+ }],
31866
+ "climateControl.setTarget": [{
31867
+ name: "deviceId",
31868
+ form: "single",
31869
+ optional: false
31870
+ }],
31871
+ "climateControl.setTargetHumidity": [{
31872
+ name: "deviceId",
31873
+ form: "single",
31874
+ optional: false
31875
+ }],
31876
+ "climateControl.setTargetRange": [{
31877
+ name: "deviceId",
31878
+ form: "single",
31879
+ optional: false
31880
+ }],
31881
+ "color.setColor": [{
31882
+ name: "deviceId",
31883
+ form: "single",
31884
+ optional: false
31885
+ }],
31886
+ "consumables.reset": [{
31887
+ name: "deviceId",
31888
+ form: "single",
31889
+ optional: false
31890
+ }],
31891
+ "control.setValue": [{
31892
+ name: "deviceId",
31893
+ form: "single",
31894
+ optional: false
31895
+ }],
31896
+ "cover.close": [{
31897
+ name: "deviceId",
31898
+ form: "single",
31899
+ optional: false
31900
+ }],
31901
+ "cover.open": [{
31902
+ name: "deviceId",
31903
+ form: "single",
31904
+ optional: false
31905
+ }],
31906
+ "cover.setPosition": [{
31907
+ name: "deviceId",
31908
+ form: "single",
31909
+ optional: false
31910
+ }],
31911
+ "cover.setTiltPosition": [{
31912
+ name: "deviceId",
31913
+ form: "single",
31914
+ optional: false
31915
+ }],
31916
+ "cover.stop": [{
31917
+ name: "deviceId",
31918
+ form: "single",
31919
+ optional: false
31920
+ }],
31921
+ "dayNight.getOptions": [{
31922
+ name: "deviceId",
31923
+ form: "single",
31924
+ optional: false
31925
+ }],
31926
+ "dayNight.setSettings": [{
31927
+ name: "deviceId",
31928
+ form: "single",
31929
+ optional: false
31930
+ }],
31931
+ "decoder.createSession": [{
31932
+ name: "deviceId",
31933
+ form: "single",
31934
+ optional: true
31935
+ }],
31936
+ "deviceAdoption.release": [{
31937
+ name: "camDeviceId",
31938
+ form: "single",
31939
+ optional: false
31940
+ }],
31941
+ "deviceAdoption.resync": [{
31942
+ name: "camDeviceId",
31943
+ form: "single",
31944
+ optional: false
31945
+ }],
31946
+ "deviceDiscovery.adoptDevice": [{
31947
+ name: "deviceId",
31948
+ form: "single",
31949
+ optional: false
31950
+ }],
31951
+ "deviceDiscovery.listDiscovered": [{
31952
+ name: "deviceId",
31953
+ form: "single",
31954
+ optional: false
31955
+ }],
31956
+ "deviceDiscovery.refreshDiscovery": [{
31957
+ name: "deviceId",
31958
+ form: "single",
31959
+ optional: false
31960
+ }],
31961
+ "deviceDiscovery.releaseDevice": [{
31962
+ name: "childDeviceId",
31963
+ form: "single",
31964
+ optional: false
31965
+ }, {
31966
+ name: "deviceId",
31967
+ form: "single",
31968
+ optional: false
31969
+ }],
31970
+ "deviceManager.adoptionRelease": [{
31971
+ name: "camDeviceId",
31972
+ form: "single",
31973
+ optional: false
31974
+ }],
31975
+ "deviceManager.adoptionResync": [{
31976
+ name: "camDeviceId",
31977
+ form: "single",
31978
+ optional: false
31979
+ }],
31980
+ "deviceManager.applyInitialMeta": [{
31981
+ name: "deviceId",
31982
+ form: "single",
31983
+ optional: false
31984
+ }, {
31985
+ name: "linkDeviceId",
31986
+ form: "single",
31987
+ optional: true
31988
+ }],
31989
+ "deviceManager.disable": [{
31990
+ name: "deviceId",
31991
+ form: "single",
31992
+ optional: false
31993
+ }],
31994
+ "deviceManager.enable": [{
31995
+ name: "deviceId",
31996
+ form: "single",
31997
+ optional: false
31998
+ }],
31999
+ "deviceManager.getBindings": [{
32000
+ name: "deviceId",
32001
+ form: "single",
32002
+ optional: false
32003
+ }],
32004
+ "deviceManager.getChildren": [{
32005
+ name: "parentDeviceId",
32006
+ form: "single",
32007
+ optional: false
32008
+ }],
32009
+ "deviceManager.getConfigSchema": [{
32010
+ name: "deviceId",
32011
+ form: "single",
32012
+ optional: false
32013
+ }],
32014
+ "deviceManager.getDevice": [{
32015
+ name: "deviceId",
32016
+ form: "single",
32017
+ optional: false
32018
+ }],
32019
+ "deviceManager.getDeviceAggregate": [{
32020
+ name: "deviceId",
32021
+ form: "single",
32022
+ optional: false
32023
+ }],
32024
+ "deviceManager.getDeviceLiveInfoAggregate": [{
32025
+ name: "deviceId",
32026
+ form: "single",
32027
+ optional: false
32028
+ }],
32029
+ "deviceManager.getDeviceSettingsAggregate": [{
32030
+ name: "deviceId",
32031
+ form: "single",
32032
+ optional: false
32033
+ }],
32034
+ "deviceManager.getDeviceStatusAggregate": [{
32035
+ name: "deviceId",
32036
+ form: "single",
32037
+ optional: false
32038
+ }],
32039
+ "deviceManager.getDeviceStatusAggregateBatch": [{
32040
+ name: "deviceIds",
32041
+ form: "array",
32042
+ optional: false
32043
+ }],
32044
+ "deviceManager.getLinkedDevices": [{
32045
+ name: "deviceId",
32046
+ form: "single",
32047
+ optional: false
32048
+ }],
32049
+ "deviceManager.getSettingsSchema": [{
32050
+ name: "deviceId",
32051
+ form: "single",
32052
+ optional: false
32053
+ }],
32054
+ "deviceManager.getStreamProfileMap": [{
32055
+ name: "deviceId",
32056
+ form: "single",
32057
+ optional: false
32058
+ }],
32059
+ "deviceManager.getStreamSources": [{
32060
+ name: "deviceId",
32061
+ form: "single",
32062
+ optional: false
32063
+ }],
32064
+ "deviceManager.getWireableFields": [{
32065
+ name: "deviceId",
32066
+ form: "single",
32067
+ optional: false
32068
+ }],
32069
+ "deviceManager.loadConfig": [{
32070
+ name: "deviceId",
32071
+ form: "single",
32072
+ optional: false
32073
+ }],
32074
+ "deviceManager.loadMeta": [{
32075
+ name: "deviceId",
32076
+ form: "single",
32077
+ optional: false
32078
+ }],
32079
+ "deviceManager.loadRuntimeState": [{
32080
+ name: "deviceId",
32081
+ form: "single",
32082
+ optional: false
32083
+ }],
32084
+ "deviceManager.persistConfig": [{
32085
+ name: "deviceId",
32086
+ form: "single",
32087
+ optional: false
32088
+ }],
32089
+ "deviceManager.probeStreams": [{
32090
+ name: "deviceId",
32091
+ form: "single",
32092
+ optional: false
32093
+ }],
32094
+ "deviceManager.registerDevice": [{
32095
+ name: "parentDeviceId",
32096
+ form: "single",
32097
+ optional: true
32098
+ }],
32099
+ "deviceManager.remove": [{
32100
+ name: "deviceId",
32101
+ form: "single",
32102
+ optional: false
32103
+ }],
32104
+ "deviceManager.removeDevice": [{
32105
+ name: "deviceId",
32106
+ form: "single",
32107
+ optional: false
32108
+ }],
32109
+ "deviceManager.runDeviceAction": [{
32110
+ name: "deviceId",
32111
+ form: "single",
32112
+ optional: false
32113
+ }],
32114
+ "deviceManager.setChildLayout": [{
32115
+ name: "deviceId",
32116
+ form: "single",
32117
+ optional: false
32118
+ }],
32119
+ "deviceManager.setDisabled": [{
32120
+ name: "deviceId",
32121
+ form: "single",
32122
+ optional: false
32123
+ }],
32124
+ "deviceManager.setDisplay": [{
32125
+ name: "deviceId",
32126
+ form: "single",
32127
+ optional: false
32128
+ }],
32129
+ "deviceManager.setIntegrationId": [{
32130
+ name: "deviceId",
32131
+ form: "single",
32132
+ optional: false
32133
+ }],
32134
+ "deviceManager.setLinkDeviceId": [{
32135
+ name: "deviceId",
32136
+ form: "single",
32137
+ optional: false
32138
+ }, {
32139
+ name: "linkDeviceId",
32140
+ form: "single",
32141
+ optional: true
32142
+ }],
32143
+ "deviceManager.setLocation": [{
32144
+ name: "deviceId",
32145
+ form: "single",
32146
+ optional: false
32147
+ }],
32148
+ "deviceManager.setMetadata": [{
32149
+ name: "deviceId",
32150
+ form: "single",
32151
+ optional: false
32152
+ }],
32153
+ "deviceManager.setName": [{
32154
+ name: "deviceId",
32155
+ form: "single",
32156
+ optional: false
32157
+ }],
32158
+ "deviceManager.setPrimaryChildEntityId": [{
32159
+ name: "deviceId",
32160
+ form: "single",
32161
+ optional: false
32162
+ }],
32163
+ "deviceManager.setRole": [{
32164
+ name: "deviceId",
32165
+ form: "single",
32166
+ optional: false
32167
+ }],
32168
+ "deviceManager.setStreamProfileMap": [{
32169
+ name: "deviceId",
32170
+ form: "single",
32171
+ optional: false
32172
+ }],
32173
+ "deviceManager.setType": [{
32174
+ name: "deviceId",
32175
+ form: "single",
32176
+ optional: false
32177
+ }],
32178
+ "deviceManager.setWrapperActive": [{
32179
+ name: "deviceId",
32180
+ form: "single",
32181
+ optional: false
32182
+ }],
32183
+ "deviceManager.testField": [{
32184
+ name: "deviceId",
32185
+ form: "single",
32186
+ optional: false
32187
+ }],
32188
+ "deviceManager.updateConfig": [{
32189
+ name: "deviceId",
32190
+ form: "single",
32191
+ optional: false
32192
+ }],
32193
+ "deviceManager.updateDeviceField": [{
32194
+ name: "deviceId",
32195
+ form: "single",
32196
+ optional: false
32197
+ }],
32198
+ "deviceManager.updateDeviceFieldsBatch": [{
32199
+ name: "deviceId",
32200
+ form: "single",
32201
+ optional: false
32202
+ }],
32203
+ "deviceOps.getConfigEntries": [{
32204
+ name: "deviceId",
32205
+ form: "single",
32206
+ optional: false
32207
+ }],
32208
+ "deviceOps.getRawState": [{
32209
+ name: "deviceId",
32210
+ form: "single",
32211
+ optional: false
32212
+ }],
32213
+ "deviceOps.getSettingsSchema": [{
32214
+ name: "deviceId",
32215
+ form: "single",
32216
+ optional: false
32217
+ }],
32218
+ "deviceOps.getStreamSources": [{
32219
+ name: "deviceId",
32220
+ form: "single",
32221
+ optional: false
32222
+ }],
32223
+ "deviceOps.removeDevice": [{
32224
+ name: "deviceId",
32225
+ form: "single",
32226
+ optional: false
32227
+ }],
32228
+ "deviceOps.runAction": [{
32229
+ name: "deviceId",
32230
+ form: "single",
32231
+ optional: false
32232
+ }],
32233
+ "deviceOps.setConfig": [{
32234
+ name: "deviceId",
32235
+ form: "single",
32236
+ optional: false
32237
+ }],
32238
+ "deviceState.getCapSlice": [{
32239
+ name: "deviceId",
32240
+ form: "single",
32241
+ optional: false
32242
+ }],
32243
+ "deviceState.getSnapshot": [{
32244
+ name: "deviceId",
32245
+ form: "single",
32246
+ optional: false
32247
+ }],
32248
+ "deviceState.setCapSlice": [{
32249
+ name: "deviceId",
32250
+ form: "single",
32251
+ optional: false
32252
+ }],
32253
+ "events.getEventClipUrl": [{
32254
+ name: "deviceId",
32255
+ form: "single",
32256
+ optional: false
32257
+ }],
32258
+ "events.getEvents": [{
32259
+ name: "deviceId",
32260
+ form: "single",
32261
+ optional: false
32262
+ }],
32263
+ "events.getEventThumbnail": [{
32264
+ name: "deviceId",
32265
+ form: "single",
32266
+ optional: false
32267
+ }],
32268
+ "faceGallery.getFaceByTrack": [{
32269
+ name: "deviceId",
32270
+ form: "single",
32271
+ optional: false
32272
+ }],
32273
+ "faceGallery.listRecentFaces": [{
32274
+ name: "deviceId",
32275
+ form: "single",
32276
+ optional: true
32277
+ }],
32278
+ "fanControl.setDirection": [{
32279
+ name: "deviceId",
32280
+ form: "single",
32281
+ optional: false
32282
+ }],
32283
+ "fanControl.setOscillating": [{
32284
+ name: "deviceId",
32285
+ form: "single",
32286
+ optional: false
32287
+ }],
32288
+ "fanControl.setPercentage": [{
32289
+ name: "deviceId",
32290
+ form: "single",
32291
+ optional: false
32292
+ }],
32293
+ "fanControl.setPreset": [{
32294
+ name: "deviceId",
32295
+ form: "single",
32296
+ optional: false
32297
+ }],
32298
+ "humidifier.setMode": [{
32299
+ name: "deviceId",
32300
+ form: "single",
32301
+ optional: false
32302
+ }],
32303
+ "humidifier.setOn": [{
32304
+ name: "deviceId",
32305
+ form: "single",
32306
+ optional: false
32307
+ }],
32308
+ "humidifier.setTargetHumidity": [{
32309
+ name: "deviceId",
32310
+ form: "single",
32311
+ optional: false
32312
+ }],
32313
+ "imageSettings.getOptions": [{
32314
+ name: "deviceId",
32315
+ form: "single",
32316
+ optional: false
32317
+ }],
32318
+ "imageSettings.setSettings": [{
32319
+ name: "deviceId",
32320
+ form: "single",
32321
+ optional: false
32322
+ }],
32323
+ "intercom.endTalkSession": [{
32324
+ name: "deviceId",
32325
+ form: "single",
32326
+ optional: false
32327
+ }],
32328
+ "intercom.handleAnswer": [{
32329
+ name: "deviceId",
32330
+ form: "single",
32331
+ optional: false
32332
+ }],
32333
+ "intercom.pushTalkAudio": [{
32334
+ name: "deviceId",
32335
+ form: "single",
32336
+ optional: false
32337
+ }],
32338
+ "intercom.startSession": [{
32339
+ name: "deviceId",
32340
+ form: "single",
32341
+ optional: false
32342
+ }],
32343
+ "intercom.startTalkSession": [{
32344
+ name: "deviceId",
32345
+ form: "single",
32346
+ optional: false
32347
+ }],
32348
+ "intercom.stopSession": [{
32349
+ name: "deviceId",
32350
+ form: "single",
32351
+ optional: false
32352
+ }],
32353
+ "lawnMowerControl.dock": [{
32354
+ name: "deviceId",
32355
+ form: "single",
32356
+ optional: false
32357
+ }],
32358
+ "lawnMowerControl.pause": [{
32359
+ name: "deviceId",
32360
+ form: "single",
32361
+ optional: false
32362
+ }],
32363
+ "lawnMowerControl.startMowing": [{
32364
+ name: "deviceId",
32365
+ form: "single",
32366
+ optional: false
32367
+ }],
32368
+ "lockControl.lock": [{
32369
+ name: "deviceId",
32370
+ form: "single",
32371
+ optional: false
32372
+ }],
32373
+ "lockControl.open": [{
32374
+ name: "deviceId",
32375
+ form: "single",
32376
+ optional: false
32377
+ }],
32378
+ "lockControl.unlock": [{
32379
+ name: "deviceId",
32380
+ form: "single",
32381
+ optional: false
32382
+ }],
32383
+ "mediaPlayer.next": [{
32384
+ name: "deviceId",
32385
+ form: "single",
32386
+ optional: false
32387
+ }],
32388
+ "mediaPlayer.pause": [{
32389
+ name: "deviceId",
32390
+ form: "single",
32391
+ optional: false
32392
+ }],
32393
+ "mediaPlayer.play": [{
32394
+ name: "deviceId",
32395
+ form: "single",
32396
+ optional: false
32397
+ }],
32398
+ "mediaPlayer.playMedia": [{
32399
+ name: "deviceId",
32400
+ form: "single",
32401
+ optional: false
32402
+ }],
32403
+ "mediaPlayer.previous": [{
32404
+ name: "deviceId",
32405
+ form: "single",
32406
+ optional: false
32407
+ }],
32408
+ "mediaPlayer.seek": [{
32409
+ name: "deviceId",
32410
+ form: "single",
32411
+ optional: false
32412
+ }],
32413
+ "mediaPlayer.selectSource": [{
32414
+ name: "deviceId",
32415
+ form: "single",
32416
+ optional: false
32417
+ }],
32418
+ "mediaPlayer.setMute": [{
32419
+ name: "deviceId",
32420
+ form: "single",
32421
+ optional: false
32422
+ }],
32423
+ "mediaPlayer.setRepeat": [{
32424
+ name: "deviceId",
32425
+ form: "single",
32426
+ optional: false
32427
+ }],
32428
+ "mediaPlayer.setShuffle": [{
32429
+ name: "deviceId",
32430
+ form: "single",
32431
+ optional: false
32432
+ }],
32433
+ "mediaPlayer.setVolume": [{
32434
+ name: "deviceId",
32435
+ form: "single",
32436
+ optional: false
32437
+ }],
32438
+ "mediaPlayer.stop": [{
32439
+ name: "deviceId",
32440
+ form: "single",
32441
+ optional: false
32442
+ }],
32443
+ "motion.isDetected": [{
32444
+ name: "deviceId",
32445
+ form: "single",
32446
+ optional: false
32447
+ }],
32448
+ "motionDetection.analyze": [{
32449
+ name: "deviceId",
32450
+ form: "single",
32451
+ optional: false
32452
+ }],
32453
+ "motionDetection.removeCamera": [{
32454
+ name: "deviceId",
32455
+ form: "single",
32456
+ optional: false
32457
+ }],
32458
+ "motionTrigger.setMotionTrigger": [{
32459
+ name: "deviceId",
32460
+ form: "single",
32461
+ optional: false
32462
+ }],
32463
+ "motionZones.getOptions": [{
32464
+ name: "deviceId",
32465
+ form: "single",
32466
+ optional: false
32467
+ }],
32468
+ "motionZones.setZone": [{
32469
+ name: "deviceId",
32470
+ form: "single",
32471
+ optional: false
32472
+ }],
32473
+ "nativeObjectDetection.setEnabled": [{
32474
+ name: "deviceId",
32475
+ form: "single",
32476
+ optional: false
32477
+ }],
32478
+ "networkQuality.getDeviceStats": [{
32479
+ name: "deviceId",
32480
+ form: "single",
32481
+ optional: false
32482
+ }],
32483
+ "networkQuality.reportClientStats": [{
32484
+ name: "deviceId",
32485
+ form: "single",
32486
+ optional: false
32487
+ }],
32488
+ "notificationRules.setDeviceMuted": [{
32489
+ name: "deviceId",
32490
+ form: "single",
32491
+ optional: false
32492
+ }],
32493
+ "notifier.cancel": [{
32494
+ name: "deviceId",
32495
+ form: "single",
32496
+ optional: false
32497
+ }],
32498
+ "notifier.send": [{
32499
+ name: "deviceId",
32500
+ form: "single",
32501
+ optional: false
32502
+ }],
32503
+ "osd.setOverlay": [{
32504
+ name: "deviceId",
32505
+ form: "single",
32506
+ optional: false
32507
+ }],
32508
+ "osdManager.clearSlotBinding": [{
32509
+ name: "deviceId",
32510
+ form: "single",
32511
+ optional: false
32512
+ }],
32513
+ "osdManager.copyDeviceConfiguration": [{
32514
+ name: "sourceDeviceId",
32515
+ form: "single",
32516
+ optional: false
32517
+ }, {
32518
+ name: "targetDeviceId",
32519
+ form: "single",
32520
+ optional: false
32521
+ }],
32522
+ "osdManager.getDeviceOsd": [{
32523
+ name: "deviceId",
32524
+ form: "single",
32525
+ optional: false
32526
+ }],
32527
+ "osdManager.getSourceCatalog": [{
32528
+ name: "deviceId",
32529
+ form: "single",
32530
+ optional: false
32531
+ }],
32532
+ "osdManager.previewSlot": [{
32533
+ name: "deviceId",
32534
+ form: "single",
32535
+ optional: false
32536
+ }],
32537
+ "osdManager.renderDevice": [{
32538
+ name: "deviceId",
32539
+ form: "single",
32540
+ optional: false
32541
+ }],
32542
+ "osdManager.setSlotBinding": [{
32543
+ name: "deviceId",
32544
+ form: "single",
32545
+ optional: false
32546
+ }],
32547
+ "petFeeder.callPet": [{
32548
+ name: "deviceId",
32549
+ form: "single",
32550
+ optional: false
32551
+ }],
32552
+ "petFeeder.cancelFeed": [{
32553
+ name: "deviceId",
32554
+ form: "single",
32555
+ optional: false
32556
+ }],
32557
+ "petFeeder.feed": [{
32558
+ name: "deviceId",
32559
+ form: "single",
32560
+ optional: false
32561
+ }],
32562
+ "petFeeder.markFoodReplenished": [{
32563
+ name: "deviceId",
32564
+ form: "single",
32565
+ optional: false
32566
+ }],
32567
+ "petFeeder.playSound": [{
32568
+ name: "deviceId",
32569
+ form: "single",
32570
+ optional: false
32571
+ }],
32572
+ "petFeeder.resetDesiccant": [{
32573
+ name: "deviceId",
32574
+ form: "single",
32575
+ optional: false
32576
+ }],
32577
+ "petFeeder.setChildLock": [{
32578
+ name: "deviceId",
32579
+ form: "single",
32580
+ optional: false
32581
+ }],
32582
+ "petFeeder.setFeedSound": [{
32583
+ name: "deviceId",
32584
+ form: "single",
32585
+ optional: false
32586
+ }],
32587
+ "petFeeder.setIndicatorLight": [{
32588
+ name: "deviceId",
32589
+ form: "single",
32590
+ optional: false
32591
+ }],
32592
+ "petFeeder.setVolume": [{
32593
+ name: "deviceId",
32594
+ form: "single",
32595
+ optional: false
32596
+ }],
32597
+ "pipelineAnalytics.clearTracks": [{
32598
+ name: "deviceId",
32599
+ form: "single",
32600
+ optional: false
32601
+ }],
32602
+ "pipelineAnalytics.completeRetrainTrack": [{
32603
+ name: "deviceId",
32604
+ form: "single",
32605
+ optional: false
32606
+ }],
32607
+ "pipelineAnalytics.deleteDeviceEvents": [{
32608
+ name: "deviceId",
32609
+ form: "single",
32610
+ optional: false
32611
+ }],
32612
+ "pipelineAnalytics.deleteTracks": [{
32613
+ name: "deviceId",
32614
+ form: "single",
32615
+ optional: false
32616
+ }],
32617
+ "pipelineAnalytics.deselectRetrainFrame": [{
32618
+ name: "deviceId",
32619
+ form: "single",
32620
+ optional: false
32621
+ }],
32622
+ "pipelineAnalytics.getActiveTracks": [{
32623
+ name: "deviceId",
32624
+ form: "single",
32625
+ optional: false
32626
+ }],
32627
+ "pipelineAnalytics.getAudioEvents": [{
32628
+ name: "deviceId",
32629
+ form: "single",
32630
+ optional: false
32631
+ }],
32632
+ "pipelineAnalytics.getEventDensity": [{
32633
+ name: "deviceId",
32634
+ form: "single",
32635
+ optional: false
32636
+ }],
32637
+ "pipelineAnalytics.getKeyEvents": [{
32638
+ name: "deviceId",
32639
+ form: "single",
32640
+ optional: false
32641
+ }],
32642
+ "pipelineAnalytics.getMotionEvents": [{
32643
+ name: "deviceId",
32644
+ form: "single",
32645
+ optional: false
32646
+ }],
32647
+ "pipelineAnalytics.getObjectEvents": [{
32648
+ name: "deviceId",
32649
+ form: "single",
32650
+ optional: false
32651
+ }],
32652
+ "pipelineAnalytics.getRetrainExportUrl": [{
32653
+ name: "deviceIds",
32654
+ form: "array",
32655
+ optional: true
32656
+ }],
32657
+ "pipelineAnalytics.getSensorEvents": [{
32658
+ name: "deviceId",
32659
+ form: "single",
32660
+ optional: false
32661
+ }],
32662
+ "pipelineAnalytics.getTrack": [{
32663
+ name: "deviceId",
32664
+ form: "single",
32665
+ optional: false
32666
+ }],
32667
+ "pipelineAnalytics.getTrainingExportSummary": [{
32668
+ name: "deviceIds",
32669
+ form: "array",
32670
+ optional: true
32671
+ }],
32672
+ "pipelineAnalytics.getTrainingExportUrl": [{
32673
+ name: "deviceIds",
32674
+ form: "array",
32675
+ optional: true
32676
+ }],
32677
+ "pipelineAnalytics.listEventKinds": [{
32678
+ name: "deviceId",
32679
+ form: "single",
32680
+ optional: false
32681
+ }],
32682
+ "pipelineAnalytics.listEventKindsBatch": [{
32683
+ name: "deviceIds",
32684
+ form: "array",
32685
+ optional: false
32686
+ }],
32687
+ "pipelineAnalytics.listOpsLog": [{
32688
+ name: "deviceId",
32689
+ form: "single",
32690
+ optional: true
32691
+ }],
32692
+ "pipelineAnalytics.listRecentTracks": [{
32693
+ name: "deviceIds",
32694
+ form: "array",
32695
+ optional: false
32696
+ }],
32697
+ "pipelineAnalytics.listRetrainStaging": [{
32698
+ name: "deviceIds",
32699
+ form: "array",
32700
+ optional: true
32701
+ }],
32702
+ "pipelineAnalytics.listTracks": [{
32703
+ name: "deviceId",
32704
+ form: "single",
32705
+ optional: false
32706
+ }],
32707
+ "pipelineAnalytics.proposeRetrainAnnotations": [{
32708
+ name: "deviceId",
32709
+ form: "single",
32710
+ optional: false
32711
+ }],
32712
+ "pipelineAnalytics.pruneEventsBefore": [{
32713
+ name: "deviceId",
32714
+ form: "single",
32715
+ optional: false
32716
+ }],
32717
+ "pipelineAnalytics.pruneTracksBefore": [{
32718
+ name: "deviceId",
32719
+ form: "single",
32720
+ optional: false
32721
+ }],
32722
+ "pipelineAnalytics.rebuildObjectEmbeddings": [{
32723
+ name: "deviceId",
32724
+ form: "single",
32725
+ optional: true
32726
+ }],
32727
+ "pipelineAnalytics.restageRetrainTrack": [{
32728
+ name: "deviceId",
32729
+ form: "single",
32730
+ optional: false
32731
+ }],
32732
+ "pipelineAnalytics.saveRetrainAnnotations": [{
32733
+ name: "deviceId",
32734
+ form: "single",
32735
+ optional: false
32736
+ }],
32737
+ "pipelineAnalytics.searchObjectEvents": [{
32738
+ name: "deviceId",
32739
+ form: "single",
32740
+ optional: true
32741
+ }],
32742
+ "pipelineAnalytics.selectRetrainFrames": [{
32743
+ name: "deviceId",
32744
+ form: "single",
32745
+ optional: false
32746
+ }],
32747
+ "pipelineAnalytics.setTrackFlags": [{
32748
+ name: "deviceId",
32749
+ form: "single",
32750
+ optional: false
32751
+ }],
32752
+ "pipelineAnalytics.wipeAllAnalytics": [{
32753
+ name: "deviceId",
32754
+ form: "single",
32755
+ optional: false
32756
+ }],
32757
+ "pipelineExecutor.runPipeline": [{
32758
+ name: "deviceId",
32759
+ form: "single",
32760
+ optional: true
32761
+ }],
32762
+ "pipelineExecutor.runPipelineBatch": [{
32763
+ name: "deviceId",
32764
+ form: "single",
32765
+ optional: true
32766
+ }],
32767
+ "pipelineOrchestrator.assignAudio": [{
32768
+ name: "deviceId",
32769
+ form: "single",
32770
+ optional: false
32771
+ }],
32772
+ "pipelineOrchestrator.assignPipeline": [{
32773
+ name: "deviceId",
32774
+ form: "single",
32775
+ optional: false
32776
+ }],
32777
+ "pipelineOrchestrator.getAudioAssignment": [{
32778
+ name: "deviceId",
32779
+ form: "single",
32780
+ optional: false
32781
+ }],
32782
+ "pipelineOrchestrator.getCameraMetrics": [{
32783
+ name: "deviceId",
32784
+ form: "single",
32785
+ optional: false
32786
+ }],
32787
+ "pipelineOrchestrator.getCameraSettings": [{
32788
+ name: "deviceId",
32789
+ form: "single",
32790
+ optional: false
32791
+ }],
32792
+ "pipelineOrchestrator.getCameraStatus": [{
32793
+ name: "deviceId",
32794
+ form: "single",
32795
+ optional: false
32796
+ }],
32797
+ "pipelineOrchestrator.getCameraStatuses": [{
32798
+ name: "deviceIds",
32799
+ form: "array",
32800
+ optional: true
32801
+ }],
32802
+ "pipelineOrchestrator.getCameraStepOverrides": [{
32803
+ name: "deviceId",
32804
+ form: "single",
32805
+ optional: false
32806
+ }],
32807
+ "pipelineOrchestrator.getCameraSwitches": [{
32808
+ name: "deviceId",
32809
+ form: "single",
32810
+ optional: false
32811
+ }],
32812
+ "pipelineOrchestrator.getPipelineAssignment": [{
32813
+ name: "deviceId",
32814
+ form: "single",
32815
+ optional: false
32816
+ }],
32817
+ "pipelineOrchestrator.getPipelineDevicePin": [{
32818
+ name: "deviceId",
32819
+ form: "single",
32820
+ optional: false
32821
+ }],
32822
+ "pipelineOrchestrator.resolvePipeline": [{
32823
+ name: "deviceId",
32824
+ form: "single",
32825
+ optional: false
32826
+ }],
32827
+ "pipelineOrchestrator.setCameraPipelineForAgent": [{
32828
+ name: "deviceId",
32829
+ form: "single",
32830
+ optional: false
32831
+ }],
32832
+ "pipelineOrchestrator.setCameraStepOverride": [{
32833
+ name: "deviceId",
32834
+ form: "single",
32835
+ optional: false
32836
+ }],
32837
+ "pipelineOrchestrator.setCameraStepToggle": [{
32838
+ name: "deviceId",
32839
+ form: "single",
32840
+ optional: false
32841
+ }],
32842
+ "pipelineOrchestrator.setCameraSwitch": [{
32843
+ name: "deviceId",
32844
+ form: "single",
32845
+ optional: false
32846
+ }],
32847
+ "pipelineOrchestrator.setPipelineDevicePin": [{
32848
+ name: "deviceId",
32849
+ form: "single",
32850
+ optional: false
32851
+ }],
32852
+ "pipelineOrchestrator.unassignAudio": [{
32853
+ name: "deviceId",
32854
+ form: "single",
32855
+ optional: false
32856
+ }],
32857
+ "pipelineOrchestrator.unassignPipeline": [{
32858
+ name: "deviceId",
32859
+ form: "single",
32860
+ optional: false
32861
+ }],
32862
+ "pipelineRunner.attachCamera": [{
32863
+ name: "deviceId",
32864
+ form: "single",
32865
+ optional: false
32866
+ }],
32867
+ "pipelineRunner.detachCamera": [{
32868
+ name: "deviceId",
32869
+ form: "single",
32870
+ optional: false
32871
+ }],
32872
+ "pipelineRunner.getCameraMetrics": [{
32873
+ name: "deviceId",
32874
+ form: "single",
32875
+ optional: false
32876
+ }],
32877
+ "pipelineRunner.reportMotion": [{
32878
+ name: "deviceId",
32879
+ form: "single",
32880
+ optional: false
32881
+ }],
32882
+ "pipelineRunner.runDetailSubtree": [{
32883
+ name: "deviceId",
32884
+ form: "single",
32885
+ optional: false
32886
+ }],
32887
+ "pipelineRunner.runStatelessStep": [{
32888
+ name: "sourceDeviceId",
32889
+ form: "single",
32890
+ optional: false
32891
+ }],
32892
+ "plateGallery.getPlateByTrack": [{
32893
+ name: "deviceId",
32894
+ form: "single",
32895
+ optional: false
32896
+ }],
32897
+ "plateGallery.listPlates": [{
32898
+ name: "deviceId",
32899
+ form: "single",
32900
+ optional: true
32901
+ }],
32902
+ "privacyMask.getOptions": [{
32903
+ name: "deviceId",
32904
+ form: "single",
32905
+ optional: false
32906
+ }],
32907
+ "privacyMask.setAudioEnabled": [{
32908
+ name: "deviceId",
32909
+ form: "single",
32910
+ optional: false
32911
+ }],
32912
+ "privacyMask.setMask": [{
32913
+ name: "deviceId",
32914
+ form: "single",
32915
+ optional: false
32916
+ }],
32917
+ "ptz.continuousMove": [{
32918
+ name: "deviceId",
32919
+ form: "single",
32920
+ optional: false
32921
+ }],
32922
+ "ptz.deletePreset": [{
32923
+ name: "deviceId",
32924
+ form: "single",
32925
+ optional: false
32926
+ }],
32927
+ "ptz.getOptions": [{
32928
+ name: "deviceId",
32929
+ form: "single",
32930
+ optional: false
32931
+ }],
32932
+ "ptz.getPosition": [{
32933
+ name: "deviceId",
32934
+ form: "single",
32935
+ optional: false
32936
+ }],
32937
+ "ptz.getPresets": [{
32938
+ name: "deviceId",
32939
+ form: "single",
32940
+ optional: false
32941
+ }],
32942
+ "ptz.goHome": [{
32943
+ name: "deviceId",
32944
+ form: "single",
32945
+ optional: false
32946
+ }],
32947
+ "ptz.goToPreset": [{
32948
+ name: "deviceId",
32949
+ form: "single",
32950
+ optional: false
32951
+ }],
32952
+ "ptz.move": [{
32953
+ name: "deviceId",
32954
+ form: "single",
32955
+ optional: false
32956
+ }],
32957
+ "ptz.savePreset": [{
32958
+ name: "deviceId",
32959
+ form: "single",
32960
+ optional: false
32961
+ }],
32962
+ "ptz.setAutofocus": [{
32963
+ name: "deviceId",
32964
+ form: "single",
32965
+ optional: false
32966
+ }],
32967
+ "ptz.stop": [{
32968
+ name: "deviceId",
32969
+ form: "single",
32970
+ optional: false
32971
+ }],
32972
+ "ptzAutotrack.getSettings": [{
32973
+ name: "deviceId",
32974
+ form: "single",
32975
+ optional: false
32976
+ }],
32977
+ "ptzAutotrack.getStatus": [{
32978
+ name: "deviceId",
32979
+ form: "single",
32980
+ optional: false
32981
+ }],
32982
+ "ptzAutotrack.setEnabled": [{
32983
+ name: "deviceId",
32984
+ form: "single",
32985
+ optional: false
32986
+ }],
32987
+ "ptzAutotrack.setSettings": [{
32988
+ name: "deviceId",
32989
+ form: "single",
32990
+ optional: false
32991
+ }],
32992
+ "reboot.reboot": [{
32993
+ name: "deviceId",
32994
+ form: "single",
32995
+ optional: false
32996
+ }],
32997
+ "recording.deleteFootprint": [{
32998
+ name: "deviceId",
32999
+ form: "single",
33000
+ optional: false
33001
+ }],
33002
+ "recording.getAvailability": [{
33003
+ name: "deviceId",
33004
+ form: "single",
33005
+ optional: false
33006
+ }],
33007
+ "recording.getDaysWithRecordings": [{
33008
+ name: "deviceId",
33009
+ form: "single",
33010
+ optional: false
33011
+ }],
33012
+ "recording.getDeviceConfig": [{
33013
+ name: "deviceId",
33014
+ form: "single",
33015
+ optional: false
33016
+ }],
33017
+ "recording.getPlaybackManifest": [{
33018
+ name: "deviceId",
33019
+ form: "single",
33020
+ optional: false
33021
+ }],
33022
+ "recording.listOpsLog": [{
33023
+ name: "deviceId",
33024
+ form: "single",
33025
+ optional: true
33026
+ }],
33027
+ "recording.locateSegment": [{
33028
+ name: "deviceId",
33029
+ form: "single",
33030
+ optional: false
33031
+ }],
33032
+ "recording.pruneFootage": [{
33033
+ name: "deviceId",
33034
+ form: "single",
33035
+ optional: false
33036
+ }],
33037
+ "recording.readGopBytes": [{
33038
+ name: "deviceId",
33039
+ form: "single",
33040
+ optional: false
33041
+ }],
33042
+ "recording.readSegmentBytes": [{
33043
+ name: "deviceId",
33044
+ form: "single",
33045
+ optional: false
33046
+ }],
33047
+ "recording.relocateFootage": [{
33048
+ name: "deviceId",
33049
+ form: "single",
33050
+ optional: true
33051
+ }],
33052
+ "recording.renderClip": [{
33053
+ name: "deviceId",
33054
+ form: "single",
33055
+ optional: false
33056
+ }],
33057
+ "recording.renderGif": [{
33058
+ name: "deviceId",
33059
+ form: "single",
33060
+ optional: false
33061
+ }],
33062
+ "recording.rescanStorage": [{
33063
+ name: "deviceId",
33064
+ form: "single",
33065
+ optional: false
33066
+ }],
33067
+ "recording.setDeviceConfig": [{
33068
+ name: "deviceId",
33069
+ form: "single",
33070
+ optional: false
33071
+ }],
33072
+ "recording.startStorageMigrationMove": [{
33073
+ name: "deviceId",
33074
+ form: "single",
33075
+ optional: true
33076
+ }],
33077
+ "recordingExport.createExport": [{
33078
+ name: "deviceId",
33079
+ form: "single",
33080
+ optional: false
33081
+ }],
33082
+ "recordingExport.listExports": [{
33083
+ name: "deviceId",
33084
+ form: "single",
33085
+ optional: true
33086
+ }],
33087
+ "sceneMonitor.captureReference": [{
33088
+ name: "deviceId",
33089
+ form: "single",
33090
+ optional: false
33091
+ }],
33092
+ "sceneMonitor.createScene": [{
33093
+ name: "deviceId",
33094
+ form: "single",
33095
+ optional: false
33096
+ }],
33097
+ "sceneMonitor.deleteReference": [{
33098
+ name: "deviceId",
33099
+ form: "single",
33100
+ optional: false
33101
+ }],
33102
+ "sceneMonitor.deleteScene": [{
33103
+ name: "deviceId",
33104
+ form: "single",
33105
+ optional: false
33106
+ }],
33107
+ "sceneMonitor.listScenes": [{
33108
+ name: "deviceId",
33109
+ form: "single",
33110
+ optional: false
33111
+ }],
33112
+ "sceneMonitor.recheckNow": [{
33113
+ name: "deviceId",
33114
+ form: "single",
33115
+ optional: false
33116
+ }],
33117
+ "sceneMonitor.resetScene": [{
33118
+ name: "deviceId",
33119
+ form: "single",
33120
+ optional: false
33121
+ }],
33122
+ "sceneMonitor.updateScene": [{
33123
+ name: "deviceId",
33124
+ form: "single",
33125
+ optional: false
33126
+ }],
33127
+ "scriptRunner.run": [{
33128
+ name: "deviceId",
33129
+ form: "single",
33130
+ optional: false
33131
+ }],
33132
+ "scriptRunner.stop": [{
33133
+ name: "deviceId",
33134
+ form: "single",
33135
+ optional: false
33136
+ }],
33137
+ "snapshot.getSnapshot": [{
33138
+ name: "deviceId",
33139
+ form: "single",
33140
+ optional: false
33141
+ }],
33142
+ "snapshot.getSnapshotOverview": [{
33143
+ name: "deviceIds",
33144
+ form: "array",
33145
+ optional: false
33146
+ }],
33147
+ "snapshot.invalidateCache": [{
33148
+ name: "deviceId",
33149
+ form: "single",
33150
+ optional: false
33151
+ }],
33152
+ "streamBroker.acquireEgressTranscode": [{
33153
+ name: "deviceId",
33154
+ form: "single",
33155
+ optional: false
33156
+ }],
33157
+ "streamBroker.assignProfile": [{
33158
+ name: "deviceId",
33159
+ form: "single",
33160
+ optional: false
33161
+ }],
33162
+ "streamBroker.getDeviceAudioMute": [{
33163
+ name: "deviceId",
33164
+ form: "single",
33165
+ optional: false
33166
+ }],
33167
+ "streamBroker.getStreamWithCodec": [{
33168
+ name: "deviceId",
33169
+ form: "single",
33170
+ optional: false
33171
+ }],
33172
+ "streamBroker.produceEventMedia": [{
33173
+ name: "deviceId",
33174
+ form: "single",
33175
+ optional: false
33176
+ }],
33177
+ "streamBroker.publishCameraStream": [{
33178
+ name: "deviceId",
33179
+ form: "single",
33180
+ optional: false
33181
+ }],
33182
+ "streamBroker.renderPreBufferClip": [{
33183
+ name: "deviceId",
33184
+ form: "single",
33185
+ optional: false
33186
+ }],
33187
+ "streamBroker.restartProfile": [{
33188
+ name: "deviceId",
33189
+ form: "single",
33190
+ optional: false
33191
+ }],
33192
+ "streamBroker.retractCameraStream": [{
33193
+ name: "deviceId",
33194
+ form: "single",
33195
+ optional: false
33196
+ }],
33197
+ "streamBroker.setDeviceAudioMute": [{
33198
+ name: "deviceId",
33199
+ form: "single",
33200
+ optional: false
33201
+ }],
33202
+ "streamBroker.unassignProfile": [{
33203
+ name: "deviceId",
33204
+ form: "single",
33205
+ optional: false
33206
+ }],
33207
+ "streamCatalog.getCatalog": [{
33208
+ name: "deviceId",
33209
+ form: "single",
33210
+ optional: false
33211
+ }],
33212
+ "streamParams.getConfigSchema": [{
33213
+ name: "deviceId",
33214
+ form: "single",
33215
+ optional: false
33216
+ }],
33217
+ "streamParams.getOptions": [{
33218
+ name: "deviceId",
33219
+ form: "single",
33220
+ optional: false
33221
+ }],
33222
+ "streamParams.setProfile": [{
33223
+ name: "deviceId",
33224
+ form: "single",
33225
+ optional: false
33226
+ }],
33227
+ "switch.setState": [{
33228
+ name: "deviceId",
33229
+ form: "single",
33230
+ optional: false
33231
+ }],
33232
+ "vacuumControl.locate": [{
33233
+ name: "deviceId",
33234
+ form: "single",
33235
+ optional: false
33236
+ }],
33237
+ "vacuumControl.pause": [{
33238
+ name: "deviceId",
33239
+ form: "single",
33240
+ optional: false
33241
+ }],
33242
+ "vacuumControl.returnToBase": [{
33243
+ name: "deviceId",
33244
+ form: "single",
33245
+ optional: false
33246
+ }],
33247
+ "vacuumControl.setFanSpeed": [{
33248
+ name: "deviceId",
33249
+ form: "single",
33250
+ optional: false
33251
+ }],
33252
+ "vacuumControl.start": [{
33253
+ name: "deviceId",
33254
+ form: "single",
33255
+ optional: false
33256
+ }],
33257
+ "vacuumControl.stop": [{
33258
+ name: "deviceId",
33259
+ form: "single",
33260
+ optional: false
33261
+ }],
33262
+ "valve.close": [{
33263
+ name: "deviceId",
33264
+ form: "single",
33265
+ optional: false
33266
+ }],
33267
+ "valve.open": [{
33268
+ name: "deviceId",
33269
+ form: "single",
33270
+ optional: false
33271
+ }],
33272
+ "valve.setPosition": [{
33273
+ name: "deviceId",
33274
+ form: "single",
33275
+ optional: false
33276
+ }],
33277
+ "valve.stop": [{
33278
+ name: "deviceId",
33279
+ form: "single",
33280
+ optional: false
33281
+ }],
33282
+ "videoclips.getClipPlayback": [{
33283
+ name: "deviceId",
33284
+ form: "single",
33285
+ optional: false
33286
+ }],
33287
+ "videoclips.listClips": [{
33288
+ name: "deviceId",
33289
+ form: "single",
33290
+ optional: false
33291
+ }],
33292
+ "waterHeater.setAway": [{
33293
+ name: "deviceId",
33294
+ form: "single",
33295
+ optional: false
33296
+ }],
33297
+ "waterHeater.setOperationMode": [{
33298
+ name: "deviceId",
33299
+ form: "single",
33300
+ optional: false
33301
+ }],
33302
+ "waterHeater.setTargetTemp": [{
33303
+ name: "deviceId",
33304
+ form: "single",
33305
+ optional: false
33306
+ }],
33307
+ "webrtcSession.addIceCandidate": [{
33308
+ name: "deviceId",
33309
+ form: "single",
33310
+ optional: false
33311
+ }],
33312
+ "webrtcSession.closeSession": [{
33313
+ name: "deviceId",
33314
+ form: "single",
33315
+ optional: false
33316
+ }],
33317
+ "webrtcSession.createSession": [{
33318
+ name: "deviceId",
33319
+ form: "single",
33320
+ optional: false
33321
+ }],
33322
+ "webrtcSession.getIceCandidates": [{
33323
+ name: "deviceId",
33324
+ form: "single",
33325
+ optional: false
33326
+ }],
33327
+ "webrtcSession.getSessionState": [{
33328
+ name: "deviceId",
33329
+ form: "single",
33330
+ optional: false
33331
+ }],
33332
+ "webrtcSession.handleAnswer": [{
33333
+ name: "deviceId",
33334
+ form: "single",
33335
+ optional: false
33336
+ }],
33337
+ "webrtcSession.handleOffer": [{
33338
+ name: "deviceId",
33339
+ form: "single",
33340
+ optional: false
33341
+ }],
33342
+ "webrtcSession.hasAdaptiveBitrate": [{
33343
+ name: "deviceId",
33344
+ form: "single",
33345
+ optional: false
33346
+ }],
33347
+ "webrtcSession.listStreams": [{
33348
+ name: "deviceId",
33349
+ form: "single",
33350
+ optional: false
33351
+ }],
33352
+ "zoneAnalytics.getCameraHistory": [{
33353
+ name: "deviceId",
33354
+ form: "single",
33355
+ optional: false
33356
+ }],
33357
+ "zoneAnalytics.getCurrentSnapshot": [{
33358
+ name: "deviceId",
33359
+ form: "single",
33360
+ optional: false
33361
+ }],
33362
+ "zoneAnalytics.getUnzonedHistory": [{
33363
+ name: "deviceId",
33364
+ form: "single",
33365
+ optional: false
33366
+ }],
33367
+ "zoneAnalytics.getZoneHistory": [{
33368
+ name: "deviceId",
33369
+ form: "single",
33370
+ optional: false
33371
+ }],
33372
+ "zoneRules.listRules": [{
33373
+ name: "deviceId",
33374
+ form: "single",
33375
+ optional: false
33376
+ }],
33377
+ "zoneRules.setRules": [{
33378
+ name: "deviceId",
33379
+ form: "single",
33380
+ optional: false
33381
+ }],
33382
+ "zones.addZone": [{
33383
+ name: "deviceId",
33384
+ form: "single",
33385
+ optional: false
33386
+ }],
33387
+ "zones.listZones": [{
33388
+ name: "deviceId",
33389
+ form: "single",
33390
+ optional: false
33391
+ }],
33392
+ "zones.removeZone": [{
33393
+ name: "deviceId",
33394
+ form: "single",
33395
+ optional: false
33396
+ }],
33397
+ "zones.updateZone": [{
33398
+ name: "deviceId",
33399
+ form: "single",
33400
+ optional: false
33401
+ }]
33402
+ });
30878
33403
  Object.freeze({
30879
33404
  "broker": "broker",
30880
33405
  "device-export": "device-export",
@@ -32163,28 +34688,6 @@ async function handleInitiateSessionWithOffer(header, endpointRaw, payloadRaw, d
32163
34688
  if (pref === "low" || pref === "mid" || pref === "high") return pref;
32164
34689
  })();
32165
34690
  const sourceProfile = explicitSourceProfile ?? mappedFromPreference ?? "high";
32166
- try {
32167
- if (isSleepingBatteryStatus(null)) {
32168
- const wakeStart = Date.now();
32169
- const wake = await api.battery.wakeForStream.mutate({
32170
- deviceId,
32171
- timeoutMs: 8e3
32172
- }).catch(() => ({
32173
- awoke: false,
32174
- durationMs: 0
32175
- }));
32176
- log.info("alexa rtc-session: battery pre-wake", { meta: {
32177
- awoke: wake.awoke,
32178
- waitedMs: wake.durationMs || Date.now() - wakeStart
32179
- } });
32180
- }
32181
- } catch (err) {
32182
- log.debug("alexa rtc-session: pre-wake skipped", { meta: { error: err instanceof Error ? err.message : String(err) } });
32183
- }
32184
- function isSleepingBatteryStatus(value) {
32185
- if (typeof value !== "object" || value === null) return false;
32186
- return value["sleeping"] === true;
32187
- }
32188
34691
  let derivedTarget;
32189
34692
  /**
32190
34693
  * The primitive's release handle, when this session acquired one. Recorded so