@camstack/types 1.2.285 → 1.2.287

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.
@@ -1473,7 +1473,7 @@ export declare const deviceManagerCapability: {
1473
1473
  * sources could be switched off without switching off the rest (D556, then
1474
1474
  * D555's re-key by source). The operator removed the whole idea the same
1475
1475
  * day: *"tutti i providers funzionano sempre, non serve
1476
- * disattivarli/attivarli … loro vivono lì"* (D557 amended, third). A
1476
+ * disattivarli/attivarli … loro vivono lì"* [all the providers always work, there is no need to deactivate/activate them … they live there] (D557 amended, third). A
1477
1477
  * collection cap's providers are a DERIVED set — every addon that provides
1478
1478
  * the cap for this device type, computed on every read and persisted
1479
1479
  * nowhere — so there is nothing here to activate, and a verb that accepted
@@ -5,6 +5,7 @@ declare const ProviderStatusSchema: z.ZodObject<{
5
5
  connected: z.ZodBoolean;
6
6
  deviceCount: z.ZodNumber;
7
7
  error: z.ZodOptional<z.ZodString>;
8
+ motionSliceWriter: z.ZodOptional<z.ZodLiteral<"orchestrator">>;
8
9
  }, z.core.$strip>;
9
10
  declare const DiscoveredDeviceSchema: z.ZodObject<{
10
11
  externalId: z.ZodString;
@@ -79,6 +80,7 @@ export declare const deviceProviderCapability: {
79
80
  connected: z.ZodBoolean;
80
81
  deviceCount: z.ZodNumber;
81
82
  error: z.ZodOptional<z.ZodString>;
83
+ motionSliceWriter: z.ZodOptional<z.ZodLiteral<"orchestrator">>;
82
84
  }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
83
85
  readonly getDevices: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodArray<z.ZodObject<{
84
86
  id: z.ZodString;
@@ -29,7 +29,7 @@
29
29
  * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
30
30
  * ends in a log line, and a log line is the thing the operator asked to stop
31
31
  * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
32
- * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
32
+ * ricontrolliamo tutti questi punti"* [can we instrument these errors in the meantime? That way next round we recheck all these points]. Reading them meant grepping Loki and
33
33
  * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
34
34
  * media blackout were both diagnosed. The counters stay; this is where they can
35
35
  * be READ.
@@ -15,7 +15,7 @@ import { type InferProvider } from './capability-definition.js';
15
15
  */
16
16
  /**
17
17
  * How long after a camera's last rising edge `pipeline-analytics` closes the
18
- * motion EPISODE row it kept open for it (D475) — "il delay della cap", in
18
+ * motion EPISODE row it kept open for it (D475) — "il delay della cap" [the cap's delay], in
19
19
  * the operator's words. One authority for the whole system: the writer of a
20
20
  * `Camera` device's slice (the orchestrator, D696) writes this SAME constant
21
21
  * in `autoClearAfterMs` while `detected: true` (never a camera's own clock —
@@ -342,7 +342,7 @@ export type ReadGopBytesResult = z.infer<typeof ReadGopBytesResultSchema>;
342
342
  /**
343
343
  * A time WINDOW of one finalized segment, cut by byte range — the multi-GOP
344
344
  * twin of {@link ReadGopBytesResultSchema}'s single instant. Built for the
345
- * replay clip's `recording` source (`docs/design/plans/2026-08-26-replay-clip-su-pipeline.md`):
345
+ * replay clip's `recording` source (`docs/design/plans/2026-08-26-clip-replay-on-pipeline.md`):
346
346
  * a replay needs several seconds of native pixels, not one frame.
347
347
  *
348
348
  * `ok.data` is standalone-demuxable, same as a GOP read. `ok.reachesRequestedEnd`
@@ -835,7 +835,7 @@ export declare const systemCapability: {
835
835
  *
836
836
  * This is the surface the operator asked for on 2026-08-28 (*"possiamo
837
837
  * armare questi errori intanto? Così al prossimo giro ricontrolliamo tutti
838
- * questi punti"*). Before it, four live failure modes could only be counted
838
+ * questi punti"* [can we instrument these errors in the meantime? That way next round we recheck all these points]). Before it, four live failure modes could only be counted
839
839
  * by grepping Loki and hand-correlating timestamps, which is exactly how a
840
840
  * 22% thumbnail gap and a 3-hour media blackout were diagnosed — twice.
841
841
  *
@@ -25,7 +25,7 @@ import { type InferProvider } from './capability-definition.js';
25
25
  *
26
26
  * `listClips` is asked of ONE provider at a time, and NAMING it is REQUIRED
27
27
  * ({@link videoclipsCapability.methods.listClips} `provider`, D554 amended). It is not
28
- * a union over everything a camera has: *"l'utilizzatore è uno solo"*. There
28
+ * a union over everything a camera has: *"l'utilizzatore è uno solo"* [there is only one user]. There
29
29
  * is no default, because a collection cap's binding set is DERIVED and PLURAL
30
30
  * (D554 amended, `getBindings` step 0) — "the bound one" does not exist to
31
31
  * resolve to, and the one thing that could take its place is a second
@@ -230,7 +230,7 @@ export type ClipPlayback = z.infer<typeof ClipPlaybackSchema>;
230
230
  * **One authorised yes is one wake.** `next-natural` — take the clip the next
231
231
  * time the camera is awake for its own reasons — is deliberately not a member:
232
232
  * it was proposed, it is free on the battery, and the operator declined it on
233
- * 2026-09-20 (*"Quando un export viene richiesto si sveglia la camera."*,
233
+ * 2026-09-20 (*"Quando un export viene richiesto si sveglia la camera."* [When an export is requested the camera wakes up],
234
234
  * D558 "Considered and not taken").
235
235
  */
236
236
  export declare const ClipWakeSchema: z.ZodEnum<{
@@ -570,7 +570,7 @@ export declare const videoclipsCapability: {
570
570
  * **It is a SECTION of the Recording tab, at the end of it — not a tab of
571
571
  * its own.** It shipped as a `clips` top-tab and the operator rejected the
572
572
  * placement: *"utilizzerei la stessa tab recordings, lì abbiamo già tutto il
573
- * necessario, una nuova sezione alla fine per le clips"*. The Recording tab
573
+ * necessario, una nuova sezione alla fine per le clips"* [I would use the same recordings tab, there we already have everything necessary, a new section at the end for the clips]. The Recording tab
574
574
  * already holds the recorder's panel, the schedule bands and the unified
575
575
  * retention policy; footage the camera itself holds is the same question,
576
576
  * asked of a different store. `order: 100` puts it after all of them with
@@ -1,18 +1,18 @@
1
1
  /**
2
- * LA tabella "quale booleano di questo tipo di device conta come ALTO", e il
3
- * valutatore puro del suo FRONTE.
2
+ * THE table "which boolean of this device type counts as HIGH", and the
3
+ * pure evaluator of its EDGE.
4
4
  *
5
- * UNA tabella per tutti quelli che chiedono "questo device è ALTO?": il
6
- * trigger `RecordingTriggers.sensorDeviceIds` del recorder, i marker dei
7
- * sensori della post-analysis, il bridge camera-sensors dell'orchestratore e
8
- * le sorgenti di un campanello composto (`doorbellFeatureSources`, D671).
9
- * Una seconda copia divergerebbe alla prima cap aggiunta, e il sintomo — "il
10
- * sensore fa suonare il campanello ma non registra" — è esattamente D62.
5
+ * ONE table for everyone who asks "is this device HIGH?": the
6
+ * recorder's `RecordingTriggers.sensorDeviceIds` trigger, the post-analysis
7
+ * sensor markers, the orchestrator's camera-sensors bridge and
8
+ * the sources of a composite doorbell (`doorbellFeatureSources`, D671).
9
+ * A second copy would diverge at the first cap added, and the symptom — "the
10
+ * sensor rings the doorbell but does not record" — is exactly D62.
11
11
  *
12
- * ⚠ NON è `DEVICE_STATE_READERS` (`catalogs/device-state-vocabulary.ts`), e le
13
- * due non vanno unificate: quella risponde a "qual è la PAROLA di stato per una
14
- * regola" (e include `presence`, `cover`, `alarm-panel`), questa a "qual è il
15
- * booleano il cui FRONTE conta". Vocabolari deliberatamente diversi.
12
+ * ⚠ NOT `DEVICE_STATE_READERS` (`catalogs/device-state-vocabulary.ts`), and the
13
+ * two must not be unified: that one answers "what is the state WORD for a
14
+ * rule" (and includes `presence`, `cover`, `alarm-panel`), this one "which
15
+ * boolean's EDGE counts". Deliberately different vocabularies.
16
16
  */
17
17
  /**
18
18
  * Known binary / switch source caps → the boolean slice field whose
@@ -64,8 +64,8 @@ export declare function sliceActiveValue(capName: string, slice: Readonly<Record
64
64
  * it is absent, non-numeric or the zero "never observed" sentinel. */
65
65
  export declare function sliceChangedAt(capName: string, slice: Readonly<Record<string, unknown>>): number | null;
66
66
  /**
67
- * Perché una slice non ha portato un fronte alto. UN enum, così "perché non è
68
- * scattato niente" ha una risposta sola, chiunque lo chieda.
67
+ * Why a slice did not carry a rising edge. ONE enum, so "why did nothing
68
+ * fire" has a single answer, whoever asks.
69
69
  */
70
70
  export type SensorEdgeIgnoreReason =
71
71
  /** Not a recognised binary/switch source cap. */
@@ -87,19 +87,19 @@ export type SensorEdgeIgnoreReason =
87
87
  export interface SensorEdgeInput {
88
88
  readonly capName: string;
89
89
  readonly slice: Readonly<Record<string, unknown>>;
90
- /** Ultimo booleano osservato per questa `(device, cap)`; `undefined` = mai vista. */
90
+ /** Last boolean observed for this `(device, cap)`; `undefined` = never seen. */
91
91
  readonly prior: boolean | undefined;
92
- /** Quando l'OSSERVATORE ha iniziato a guardare — il pavimento per una prima
93
- * osservazione già attiva. Ogni osservatore ha il suo. */
92
+ /** When the OBSERVER started watching — the floor for a first
93
+ * already-active observation. Each observer has its own. */
94
94
  readonly startedAtMs: number;
95
95
  readonly nowMs: number;
96
96
  readonly firstSightingFreshnessMs: number;
97
97
  }
98
98
  /**
99
- * `value` è restituito su ogni cammino in cui la slice PORTAVA un booleano,
100
- * anche quando non c'è fronte: il chiamante aggiorna la sua memoria con quello
101
- * e non rilegge la slice. Su `unknown-cap` / `non-boolean-value` è `null` e la
102
- * memoria non va toccata.
99
+ * `value` is returned on every path where the slice CARRIED a boolean,
100
+ * even when there is no edge: the caller updates its memory with that
101
+ * and does not re-read the slice. On `unknown-cap` / `non-boolean-value` it is `null` and the
102
+ * memory must not be touched.
103
103
  */
104
104
  export type SensorEdgeVerdict = {
105
105
  readonly edge: 'rising';
@@ -137,16 +137,16 @@ export type SensorLevelEdgeVerdict = {
137
137
  */
138
138
  export declare function evaluateSensorLevelEdge(input: SensorLevelEdgeInput): SensorLevelEdgeVerdict;
139
139
  /**
140
- * IL fronte. Puro: nessun orologio proprio, nessuna memoria — il chiamante
141
- * porta `prior`, `nowMs` e il proprio `startedAtMs`.
140
+ * THE edge. Pure: no clock of its own, no memory — the caller
141
+ * brings `prior`, `nowMs` and its own `startedAtMs`.
142
142
  *
143
- * Il caso della PRIMA slice già attiva è trattato esplicitamente e vale come
144
- * fronte solo se il timestamp UPSTREAM della transizione è posteriore a
145
- * `startedAtMs` **e** entro `firstSightingFreshnessMs`. Entrambe le metà
146
- * servono: la sola freschezza scatterebbe su un'idratazione al boot di uno
147
- * stato flippato pochi secondi prima del riavvio, e il solo "dopo che abbiamo
148
- * iniziato" scatterebbe, su un processo di lunga vita, per una sorgente
149
- * adottata oggi il cui stato è cambiato ieri. Il caso ambiguo ERRA VERSO IL
150
- * SILENZIO e lo dichiara (`baseline-seeded-stale-active`).
143
+ * The case of the FIRST slice already active is treated explicitly and counts as an
144
+ * edge only if the UPSTREAM timestamp of the transition is later than
145
+ * `startedAtMs` **and** within `firstSightingFreshnessMs`. Both halves
146
+ * are needed: freshness alone would fire on a boot-time hydration of a
147
+ * state flipped a few seconds before the restart, and "after we started"
148
+ * alone would fire, on a long-lived process, for a source
149
+ * adopted today whose state changed yesterday. The ambiguous case ERRS TOWARD
150
+ * SILENCE and declares it (`baseline-seeded-stale-active`).
151
151
  */
152
152
  export declare function evaluateSensorEdge(input: SensorEdgeInput): SensorEdgeVerdict;
@@ -901,20 +901,20 @@ function chooseFfmpegBinary(input) {
901
901
  //#endregion
902
902
  //#region src/catalogs/sensor-active-state.ts
903
903
  /**
904
- * LA tabella "quale booleano di questo tipo di device conta come ALTO", e il
905
- * valutatore puro del suo FRONTE.
904
+ * THE table "which boolean of this device type counts as HIGH", and the
905
+ * pure evaluator of its EDGE.
906
906
  *
907
- * UNA tabella per tutti quelli che chiedono "questo device è ALTO?": il
908
- * trigger `RecordingTriggers.sensorDeviceIds` del recorder, i marker dei
909
- * sensori della post-analysis, il bridge camera-sensors dell'orchestratore e
910
- * le sorgenti di un campanello composto (`doorbellFeatureSources`, D671).
911
- * Una seconda copia divergerebbe alla prima cap aggiunta, e il sintomo — "il
912
- * sensore fa suonare il campanello ma non registra" — è esattamente D62.
907
+ * ONE table for everyone who asks "is this device HIGH?": the
908
+ * recorder's `RecordingTriggers.sensorDeviceIds` trigger, the post-analysis
909
+ * sensor markers, the orchestrator's camera-sensors bridge and
910
+ * the sources of a composite doorbell (`doorbellFeatureSources`, D671).
911
+ * A second copy would diverge at the first cap added, and the symptom — "the
912
+ * sensor rings the doorbell but does not record" — is exactly D62.
913
913
  *
914
- * ⚠ NON è `DEVICE_STATE_READERS` (`catalogs/device-state-vocabulary.ts`), e le
915
- * due non vanno unificate: quella risponde a "qual è la PAROLA di stato per una
916
- * regola" (e include `presence`, `cover`, `alarm-panel`), questa a "qual è il
917
- * booleano il cui FRONTE conta". Vocabolari deliberatamente diversi.
914
+ * ⚠ NOT `DEVICE_STATE_READERS` (`catalogs/device-state-vocabulary.ts`), and the
915
+ * two must not be unified: that one answers "what is the state WORD for a
916
+ * rule" (and includes `presence`, `cover`, `alarm-panel`), this one "which
917
+ * boolean's EDGE counts". Deliberately different vocabularies.
918
918
  */
919
919
  /**
920
920
  * Known binary / switch source caps → the boolean slice field whose
@@ -1030,17 +1030,17 @@ function evaluateSensorLevelEdge(input) {
1030
1030
  };
1031
1031
  }
1032
1032
  /**
1033
- * IL fronte. Puro: nessun orologio proprio, nessuna memoria — il chiamante
1034
- * porta `prior`, `nowMs` e il proprio `startedAtMs`.
1033
+ * THE edge. Pure: no clock of its own, no memory — the caller
1034
+ * brings `prior`, `nowMs` and its own `startedAtMs`.
1035
1035
  *
1036
- * Il caso della PRIMA slice già attiva è trattato esplicitamente e vale come
1037
- * fronte solo se il timestamp UPSTREAM della transizione è posteriore a
1038
- * `startedAtMs` **e** entro `firstSightingFreshnessMs`. Entrambe le metà
1039
- * servono: la sola freschezza scatterebbe su un'idratazione al boot di uno
1040
- * stato flippato pochi secondi prima del riavvio, e il solo "dopo che abbiamo
1041
- * iniziato" scatterebbe, su un processo di lunga vita, per una sorgente
1042
- * adottata oggi il cui stato è cambiato ieri. Il caso ambiguo ERRA VERSO IL
1043
- * SILENZIO e lo dichiara (`baseline-seeded-stale-active`).
1036
+ * The case of the FIRST slice already active is treated explicitly and counts as an
1037
+ * edge only if the UPSTREAM timestamp of the transition is later than
1038
+ * `startedAtMs` **and** within `firstSightingFreshnessMs`. Both halves
1039
+ * are needed: freshness alone would fire on a boot-time hydration of a
1040
+ * state flipped a few seconds before the restart, and "after we started"
1041
+ * alone would fire, on a long-lived process, for a source
1042
+ * adopted today whose state changed yesterday. The ambiguous case ERRS TOWARD
1043
+ * SILENCE and declares it (`baseline-seeded-stale-active`).
1044
1044
  */
1045
1045
  function evaluateSensorEdge(input) {
1046
1046
  const value = sliceActiveValue(input.capName, input.slice);
@@ -901,20 +901,20 @@ function chooseFfmpegBinary(input) {
901
901
  //#endregion
902
902
  //#region src/catalogs/sensor-active-state.ts
903
903
  /**
904
- * LA tabella "quale booleano di questo tipo di device conta come ALTO", e il
905
- * valutatore puro del suo FRONTE.
904
+ * THE table "which boolean of this device type counts as HIGH", and the
905
+ * pure evaluator of its EDGE.
906
906
  *
907
- * UNA tabella per tutti quelli che chiedono "questo device è ALTO?": il
908
- * trigger `RecordingTriggers.sensorDeviceIds` del recorder, i marker dei
909
- * sensori della post-analysis, il bridge camera-sensors dell'orchestratore e
910
- * le sorgenti di un campanello composto (`doorbellFeatureSources`, D671).
911
- * Una seconda copia divergerebbe alla prima cap aggiunta, e il sintomo — "il
912
- * sensore fa suonare il campanello ma non registra" — è esattamente D62.
907
+ * ONE table for everyone who asks "is this device HIGH?": the
908
+ * recorder's `RecordingTriggers.sensorDeviceIds` trigger, the post-analysis
909
+ * sensor markers, the orchestrator's camera-sensors bridge and
910
+ * the sources of a composite doorbell (`doorbellFeatureSources`, D671).
911
+ * A second copy would diverge at the first cap added, and the symptom — "the
912
+ * sensor rings the doorbell but does not record" — is exactly D62.
913
913
  *
914
- * ⚠ NON è `DEVICE_STATE_READERS` (`catalogs/device-state-vocabulary.ts`), e le
915
- * due non vanno unificate: quella risponde a "qual è la PAROLA di stato per una
916
- * regola" (e include `presence`, `cover`, `alarm-panel`), questa a "qual è il
917
- * booleano il cui FRONTE conta". Vocabolari deliberatamente diversi.
914
+ * ⚠ NOT `DEVICE_STATE_READERS` (`catalogs/device-state-vocabulary.ts`), and the
915
+ * two must not be unified: that one answers "what is the state WORD for a
916
+ * rule" (and includes `presence`, `cover`, `alarm-panel`), this one "which
917
+ * boolean's EDGE counts". Deliberately different vocabularies.
918
918
  */
919
919
  /**
920
920
  * Known binary / switch source caps → the boolean slice field whose
@@ -1030,17 +1030,17 @@ function evaluateSensorLevelEdge(input) {
1030
1030
  };
1031
1031
  }
1032
1032
  /**
1033
- * IL fronte. Puro: nessun orologio proprio, nessuna memoria — il chiamante
1034
- * porta `prior`, `nowMs` e il proprio `startedAtMs`.
1033
+ * THE edge. Pure: no clock of its own, no memory — the caller
1034
+ * brings `prior`, `nowMs` and its own `startedAtMs`.
1035
1035
  *
1036
- * Il caso della PRIMA slice già attiva è trattato esplicitamente e vale come
1037
- * fronte solo se il timestamp UPSTREAM della transizione è posteriore a
1038
- * `startedAtMs` **e** entro `firstSightingFreshnessMs`. Entrambe le metà
1039
- * servono: la sola freschezza scatterebbe su un'idratazione al boot di uno
1040
- * stato flippato pochi secondi prima del riavvio, e il solo "dopo che abbiamo
1041
- * iniziato" scatterebbe, su un processo di lunga vita, per una sorgente
1042
- * adottata oggi il cui stato è cambiato ieri. Il caso ambiguo ERRA VERSO IL
1043
- * SILENZIO e lo dichiara (`baseline-seeded-stale-active`).
1036
+ * The case of the FIRST slice already active is treated explicitly and counts as an
1037
+ * edge only if the UPSTREAM timestamp of the transition is later than
1038
+ * `startedAtMs` **and** within `firstSightingFreshnessMs`. Both halves
1039
+ * are needed: freshness alone would fire on a boot-time hydration of a
1040
+ * state flipped a few seconds before the restart, and "after we started"
1041
+ * alone would fire, on a long-lived process, for a source
1042
+ * adopted today whose state changed yesterday. The ambiguous case ERRS TOWARD
1043
+ * SILENCE and declares it (`baseline-seeded-stale-active`).
1044
1044
  */
1045
1045
  function evaluateSensorEdge(input) {
1046
1046
  const value = sliceActiveValue(input.capName, input.slice);
@@ -48,6 +48,8 @@ export interface ProviderStatus {
48
48
  readonly connected: boolean;
49
49
  readonly deviceCount: number;
50
50
  readonly error?: string;
51
+ /** This provider writes no camera's `motion` slice (D696); see `device-provider.cap.ts`. */
52
+ readonly motionSliceWriter?: 'orchestrator';
51
53
  }
52
54
  /**
53
55
  * Outcome of an `onRestoreDevices` pass. Optional for back-compat:
package/dist/index.js CHANGED
@@ -1,7 +1,7 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
2
  const require_sleep = require("./sleep-G4F3X9X_.js");
3
3
  const require_event_category = require("./event-category-DmS_tLsU.js");
4
- const require_composition = require("./composition-w3gBWMer.js");
4
+ const require_composition = require("./composition-DexM_etk.js");
5
5
  const require_err_msg = require("./err-msg-Dx2Kor0g.js");
6
6
  const require_enums = require("./enums.js");
7
7
  let zod = require("zod");
@@ -2354,22 +2354,22 @@ var CLASS_MAP_MACRO_TARGETS = [
2354
2354
  "package"
2355
2355
  ];
2356
2356
  /**
2357
- * Le macro classi di PRIMO LIVELLO: quelle che un object detector emette e che
2358
- * un operatore può selezionare.
2357
+ * The FIRST-LEVEL macro classes: those an object detector emits and that
2358
+ * an operator can select.
2359
2359
  *
2360
- * Sono le tre offerte dallo step `object-detection`
2360
+ * They are the three offered by the `object-detection` step
2361
2361
  * (`addon-pipeline/src/detection-pipeline/registry/step-definitions.ts`,
2362
- * `enabledMacroClasses`). `package` sta in {@link CLASS_MAP_MACRO_TARGETS} e in
2363
- * `MACRO_LABELS` — è una macro vera — ma NON qui: appartiene allo step
2364
- * `package-detection`, la cui abilitazione è guidata dalle zone, e offrire la
2365
- * stessa parola due volte ha già fatto accendere a un operatore il proxy COCO
2362
+ * `enabledMacroClasses`). `package` is in {@link CLASS_MAP_MACRO_TARGETS} and in
2363
+ * `MACRO_LABELS` — it is a true macro — but NOT here: it belongs to the step
2364
+ * `package-detection`, whose enablement is driven by zones, and offering the
2365
+ * same word twice has already made an operator turn on the COCO proxy
2366
2366
  * (suitcase/backpack/handbag) lasciando spento il detector dedicato.
2367
2367
  *
2368
- * UNA lista. Prima di oggi le stesse tre erano scritte a mano nell'offerta
2369
- * dello step e una seconda volta come union `FirstLevelMacro`
2370
- * (`types/detection.ts`); una terza copia per il trigger di registrazione
2371
- * (`RecordingTriggers.objectClasses`) avrebbe reso invisibile la divergenza
2372
- * successiva.
2368
+ * ONE list. Before today the same three were hand-written in the step's offer
2369
+ * and a second time as the union `FirstLevelMacro`
2370
+ * (`types/detection.ts`); a third copy for the recording trigger
2371
+ * (`RecordingTriggers.objectClasses`) would have made the later divergence
2372
+ * invisible.
2373
2373
  */
2374
2374
  var FIRST_LEVEL_MACRO_CLASSES = [
2375
2375
  "person",
@@ -2377,8 +2377,8 @@ var FIRST_LEVEL_MACRO_CLASSES = [
2377
2377
  "animal"
2378
2378
  ];
2379
2379
  /**
2380
- * True quando `value` è una macro di primo livello. Type guard, non cast: un
2381
- * `className` che arriva dal bus è una stringa qualunque finché non passa di
2380
+ * True when `value` is a first-level macro. Type guard, not cast: a
2381
+ * `className` coming from the bus is any string until it passes through
2382
2382
  * qui.
2383
2383
  */
2384
2384
  function isFirstLevelMacroClass(value) {
@@ -2462,26 +2462,26 @@ var RecordingStorageModeSchema = zod.z.enum([
2462
2462
  "on-device-decision"
2463
2463
  ]);
2464
2464
  /**
2465
- * Le macro classi che possono aprire una finestra di registrazione — le stesse
2466
- * tre offerte dallo step `object-detection`, da UNA lista
2465
+ * The macro classes that can open a recording window — the same
2466
+ * three offered by the `object-detection` step, from ONE list
2467
2467
  * ({@link FIRST_LEVEL_MACRO_CLASSES}).
2468
2468
  */
2469
2469
  var RecordingObjectTriggerClassSchema = zod.z.enum(FIRST_LEVEL_MACRO_CLASSES);
2470
2470
  /**
2471
- * True quando `values` non ripete un elemento.
2471
+ * True when `values` does not repeat an element.
2472
2472
  *
2473
- * Un duplicato non è innocuo: ogni voce di `objectClasses` / `sensorDeviceIds`
2474
- * diventa una SORGENTE in `bandTriggerSources`, e la stessa sorgente due volte
2475
- * conterebbe due volte le sue finestre in `segmentMissedByMs`.
2473
+ * A duplicate is not harmless: every entry of `objectClasses` / `sensorDeviceIds`
2474
+ * becomes a SOURCE in `bandTriggerSources`, and the same source twice
2475
+ * would count its windows twice in `segmentMissedByMs`.
2476
2476
  */
2477
2477
  var noDuplicates = (values) => new Set(values).size === values.length;
2478
2478
  /**
2479
- * Quanti device sorgente una singola banda può ascoltare.
2479
+ * How many source devices a single band can listen to.
2480
2480
  *
2481
- * Non è un gusto: ogni sorgente è una CHIAVE nel `TriggerState` del recorder, e
2482
- * il limite per chiave (`MAX_TRIGGER_WINDOWS = 32`) senza un limite sulle
2483
- * chiavi lascerebbe crescere la mappa con l'inventario dell'operatore. 16
2484
- * sensori su UNA camera è già oltre qualunque installazione osservata.
2481
+ * It is not a whim: every source is a KEY in the recorder's `TriggerState`, and
2482
+ * the per-key limit (`MAX_TRIGGER_WINDOWS = 32`) without a limit on the
2483
+ * keys would let the map grow with the operator's inventory. 16
2484
+ * sensors on ONE camera is already beyond any installation observed.
2485
2485
  */
2486
2486
  var MAX_SENSOR_TRIGGER_DEVICES = 16;
2487
2487
  /**
@@ -2513,34 +2513,34 @@ var RecordingTriggersSchema = zod.z.object({
2513
2513
  motion: zod.z.boolean().optional(),
2514
2514
  audioThresholdDbfs: zod.z.number().optional(),
2515
2515
  /**
2516
- * Le macro classi la cui detection apre una finestra. ASSENTE = la sorgente
2517
- * non è ascoltata; un array VUOTO è rifiutato, perché "banda events, trigger
2518
- * object acceso, nessuna classe" è la stessa forma "abilitata e non registra
2519
- * nulla, per sempre" contro cui è scritto `eventsBandCanEverDemand`.
2516
+ * The macro classes whose detection opens a window. ABSENT = the source
2517
+ * is not listened to; an EMPTY array is rejected, because "events band, object
2518
+ * trigger on, no class" is the same shape "enabled and records
2519
+ * nothing, forever" that `eventsBandCanEverDemand` is written against.
2520
2520
  *
2521
- * Il segnale letto è GIÀ FILTRATO: solo detection `source: 'pipeline'`, cioè
2522
- * quelle che hanno attraversato `enabledMacroClasses`, i
2523
- * `minConfidence<Macro>` e il full-frame guard. L'AI a bordo camera
2524
- * (`source: 'onboard'`) non attraversa nessuno di quei gate e NON apre
2525
- * finestre — vedi `recorder/object-trigger.ts`.
2521
+ * The signal read is ALREADY FILTERED: only `source: 'pipeline'` detections, i.e.
2522
+ * those that went through `enabledMacroClasses`, the
2523
+ * `minConfidence<Macro>` and the full-frame guard. The camera's onboard AI
2524
+ * (`source: 'onboard'`) goes through none of those gates and does NOT open
2525
+ * windows — see `recorder/object-trigger.ts`.
2526
2526
  */
2527
2527
  objectClasses: zod.z.array(RecordingObjectTriggerClassSchema).min(1).refine(noDuplicates, { message: "objectClasses must not repeat a class" }).optional(),
2528
2528
  /**
2529
- * I device LINKED il cui FRONTE ALTO apre una finestra. Assente = la sorgente
2530
- * non è ascoltata; un array vuoto è rifiutato per la stessa ragione di
2529
+ * The LINKED devices whose RISING EDGE opens a window. Absent = the source
2530
+ * is not listened to; an empty array is rejected for the same reason as
2531
2531
  * `objectClasses`.
2532
2532
  *
2533
- * Sono id di device SORGENTE, non camere: la banda li nomina, quindi il
2534
- * percorso caldo (`DeviceStateChanged`, a ritmo di bus su tutta la flotta)
2535
- * non fa RPC. L'OFFERTA da cui l'operatore li sceglie è un'altra domanda, e
2536
- * si risolve con `deviceManager.getLinkedDevices` + `getBindingsBatch` per
2537
- * device (D12) — mai un elenco globale di cap.
2533
+ * These are SOURCE device ids, not cameras: the band names them, so the
2534
+ * hot path (`DeviceStateChanged`, at bus rate across the whole fleet)
2535
+ * does no RPC. The OFFER from which the operator picks them is another question, and
2536
+ * is resolved with `deviceManager.getLinkedDevices` + `getBindingsBatch` per
2537
+ * device (D12) — never a global list of caps.
2538
2538
  *
2539
- * Cosa vuol dire "alto" dipende dal TIPO di device e non è deciso qui:
2540
- * `SOURCE_CAP_ACTIVE_FIELD` (`catalogs/sensor-active-state.ts`) è LA tabella,
2541
- * la stessa del campanello composto (D671). Ed è il FRONTE, non
2542
- * il livello: un contatto trovato già aperto al riavvio del runner non fa
2543
- * registrare.
2539
+ * What "high" means depends on the device TYPE and is not decided here:
2540
+ * `SOURCE_CAP_ACTIVE_FIELD` (`catalogs/sensor-active-state.ts`) is THE table,
2541
+ * the same one as the composite doorbell (D671). And it is the EDGE, not
2542
+ * the level: a contact found already open at runner restart does not
2543
+ * record.
2544
2544
  */
2545
2545
  sensorDeviceIds: zod.z.array(zod.z.number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
2546
2546
  });
@@ -4220,7 +4220,7 @@ function findTimezone(id) {
4220
4220
  * - **VALUE** — at which level, for which scope, until when. That stays ONE
4221
4221
  * thing: the logging settings document on the `system` cap. Two authorities
4222
4222
  * over the values is the exact defect
4223
- * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
4223
+ * `docs/design/plans/2026-08-26-per-component-logging.md` was written to
4224
4224
  * remove; re-introducing it from the cure side would be grotesque.
4225
4225
  *
4226
4226
  * Nothing in this file reads a clock, an env var or a store. The registry is
@@ -11933,7 +11933,7 @@ var dataStoreProviderCapability = {
11933
11933
  *
11934
11934
  * ⚠ An earlier version of this comment blamed Zod stripping, and that
11935
11935
  * was wrong — corrected 2026-08-26 after the hop map
11936
- * (`docs/design/2026-08-26-mappa-hop-argomenti.md`) traced the path.
11936
+ * (`docs/design/2026-08-26-topic-hop-map.md`) traced the path.
11937
11937
  * There is **no Zod parse at all** between the door and the engine: the
11938
11938
  * dispatcher forwards the payload verbatim and UDS carries it whole. A
11939
11939
  * field declared here reaches `SqliteSettingsBackend` either way.
@@ -13327,7 +13327,17 @@ function siteZoneKey(label) {
13327
13327
  var ProviderStatusSchema = zod.z.object({
13328
13328
  connected: zod.z.boolean(),
13329
13329
  deviceCount: zod.z.number(),
13330
- error: zod.z.string().optional()
13330
+ error: zod.z.string().optional(),
13331
+ /**
13332
+ * `'orchestrator'`: this provider writes NO camera's `motion` runtime slice
13333
+ * — the orchestrator is its only writer (D696). Set by `BaseDeviceProvider`,
13334
+ * which every provider bundles, so only a provider BUILT from D696-amended
13335
+ * code says it. ABSENT means an older provider that may still write it (raw
13336
+ * VMD writes, a boot seed), and the orchestrator's provider gate keeps that
13337
+ * provider's cameras unwritten (`camera-sensors/motion-slice-provider-gate.ts`)
13338
+ * — the provider twin of the runner's `getLocalLoad().motionSliceWriter`.
13339
+ */
13340
+ motionSliceWriter: zod.z.literal("orchestrator").optional()
13331
13341
  });
13332
13342
  var DiscoveredDeviceSchema = zod.z.object({
13333
13343
  externalId: zod.z.string(),
@@ -14520,7 +14530,7 @@ var deviceManagerCapability = {
14520
14530
  * sources could be switched off without switching off the rest (D556, then
14521
14531
  * D555's re-key by source). The operator removed the whole idea the same
14522
14532
  * day: *"tutti i providers funzionano sempre, non serve
14523
- * disattivarli/attivarli … loro vivono lì"* (D557 amended, third). A
14533
+ * disattivarli/attivarli … loro vivono lì"* [all the providers always work, there is no need to deactivate/activate them … they live there] (D557 amended, third). A
14524
14534
  * collection cap's providers are a DERIVED set — every addon that provides
14525
14535
  * the cap for this device type, computed on every read and persisted
14526
14536
  * nowhere — so there is nothing here to activate, and a verb that accepted
@@ -15486,7 +15496,7 @@ var embeddingEncoderCapability = {
15486
15496
  * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
15487
15497
  * ends in a log line, and a log line is the thing the operator asked to stop
15488
15498
  * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
15489
- * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
15499
+ * ricontrolliamo tutti questi punti"* [can we instrument these errors in the meantime? That way next round we recheck all these points]. Reading them meant grepping Loki and
15490
15500
  * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
15491
15501
  * media blackout were both diagnosed. The counters stay; this is where they can
15492
15502
  * be READ.
@@ -23170,14 +23180,14 @@ var TrackSchema = zod.z.object({
23170
23180
  * `derive-returned-null tile=standin`,
23171
23181
  * `native-tile tile=native no-key-frame-at-close`, …) written at close and
23172
23182
  * CLEARED by the late-keyFrame upgrade when a native tile lands after all.
23173
- * The operator-facing answer to "perché manca l'immagine?" on a track whose
23183
+ * The operator-facing answer to "perché manca l'immagine?" [why is the image missing?] on a track whose
23174
23184
  * tile is a face/plate stand-in, a raster crop, or an icon.
23175
23185
  *
23176
23186
  * **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
23177
23187
  * the TILE ranked below native, so a track whose thumbnail landed natively
23178
23188
  * while its key frame missed carried no reason at all — three of the four
23179
23189
  * `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
23180
- * that shape, and their "niente ultimo" had no cause anywhere on the row.
23190
+ * that shape, and their "niente ultimo" [no last frame] had no cause anywhere on the row.
23181
23191
  * The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
23182
23192
  * lastFrame copy source`), so its absence is now on this line whatever the
23183
23193
  * tile ended up being.
@@ -23264,7 +23274,7 @@ var MotionEventSchema = zod.z.object({
23264
23274
  /**
23265
23275
  * Ms offsets from `timestamp` (the episode's own first rising edge, so the
23266
23276
  * first entry is always `0`) of every genuine off→on transition the
23267
- * episode saw — "ogni evento on si deve salvare" (D475). NOT one entry per
23277
+ * episode saw — "ogni evento on si deve salvare" [every ON event must be saved] (D475). NOT one entry per
23268
23278
  * push: a firmware source that keepalives at ~1 Hz for the whole burst
23269
23279
  * (Reolink, Hikvision) produces exactly one edge; a source that reports an
23270
23280
  * explicit `false` mid-episode and then resumes before the quiet window
@@ -30715,7 +30725,7 @@ var vectorStoreCapability = {
30715
30725
  *
30716
30726
  * `listClips` is asked of ONE provider at a time, and NAMING it is REQUIRED
30717
30727
  * ({@link videoclipsCapability.methods.listClips} `provider`, D554 amended). It is not
30718
- * a union over everything a camera has: *"l'utilizzatore è uno solo"*. There
30728
+ * a union over everything a camera has: *"l'utilizzatore è uno solo"* [there is only one user]. There
30719
30729
  * is no default, because a collection cap's binding set is DERIVED and PLURAL
30720
30730
  * (D554 amended, `getBindings` step 0) — "the bound one" does not exist to
30721
30731
  * resolve to, and the one thing that could take its place is a second
@@ -31057,7 +31067,7 @@ var ClipPlaybackSchema = zod.z.object({
31057
31067
  * **One authorised yes is one wake.** `next-natural` — take the clip the next
31058
31068
  * time the camera is awake for its own reasons — is deliberately not a member:
31059
31069
  * it was proposed, it is free on the battery, and the operator declined it on
31060
- * 2026-09-20 (*"Quando un export viene richiesto si sveglia la camera."*,
31070
+ * 2026-09-20 (*"Quando un export viene richiesto si sveglia la camera."* [When an export is requested the camera wakes up],
31061
31071
  * D558 "Considered and not taken").
31062
31072
  */
31063
31073
  var ClipWakeSchema = zod.z.enum(["authorised"]);
@@ -31453,7 +31463,7 @@ var videoclipsCapability = {
31453
31463
  * **It is a SECTION of the Recording tab, at the end of it — not a tab of
31454
31464
  * its own.** It shipped as a `clips` top-tab and the operator rejected the
31455
31465
  * placement: *"utilizzerei la stessa tab recordings, lì abbiamo già tutto il
31456
- * necessario, una nuova sezione alla fine per le clips"*. The Recording tab
31466
+ * necessario, una nuova sezione alla fine per le clips"* [I would use the same recordings tab, there we already have everything necessary, a new section at the end for the clips]. The Recording tab
31457
31467
  * already holds the recorder's panel, the schedule bands and the unified
31458
31468
  * retention policy; footage the camera itself holds is the same question,
31459
31469
  * asked of a different store. `order: 100` puts it after all of them with
@@ -31514,7 +31524,7 @@ var videoclipsCapability = {
31514
31524
  * It replaced `sources?: string[]`, a VIEW filter over source ids that
31515
31525
  * assumed the answer was a fan-out over everything a camera has. The
31516
31526
  * operator settled otherwise on 2026-09-20 — *"l'utilizzatore è uno
31517
- * solo"* — so the list is asked of one provider at a time and there is
31527
+ * solo"* [there is only one user] — so the list is asked of one provider at a time and there is
31518
31528
  * nothing to filter out of it.
31519
31529
  */
31520
31530
  provider: zod.z.string().min(1)
@@ -37404,7 +37414,7 @@ authKey: zod.z.string().optional() }), zod.z.object({
37404
37414
  */
37405
37415
  /**
37406
37416
  * How long after a camera's last rising edge `pipeline-analytics` closes the
37407
- * motion EPISODE row it kept open for it (D475) — "il delay della cap", in
37417
+ * motion EPISODE row it kept open for it (D475) — "il delay della cap" [the cap's delay], in
37408
37418
  * the operator's words. One authority for the whole system: the writer of a
37409
37419
  * `Camera` device's slice (the orchestrator, D696) writes this SAME constant
37410
37420
  * in `autoClearAfterMs` while `detected: true` (never a camera's own clock —
@@ -41371,7 +41381,7 @@ var ReadGopBytesResultSchema = zod.z.object({
41371
41381
  /**
41372
41382
  * A time WINDOW of one finalized segment, cut by byte range — the multi-GOP
41373
41383
  * twin of {@link ReadGopBytesResultSchema}'s single instant. Built for the
41374
- * replay clip's `recording` source (`docs/design/plans/2026-08-26-replay-clip-su-pipeline.md`):
41384
+ * replay clip's `recording` source (`docs/design/plans/2026-08-26-clip-replay-on-pipeline.md`):
41375
41385
  * a replay needs several seconds of native pixels, not one frame.
41376
41386
  *
41377
41387
  * `ok.data` is standalone-demuxable, same as a GOP read. `ok.reachesRequestedEnd`
@@ -44771,7 +44781,7 @@ var systemCapability = {
44771
44781
  *
44772
44782
  * This is the surface the operator asked for on 2026-08-28 (*"possiamo
44773
44783
  * armare questi errori intanto? Così al prossimo giro ricontrolliamo tutti
44774
- * questi punti"*). Before it, four live failure modes could only be counted
44784
+ * questi punti"* [can we instrument these errors in the meantime? That way next round we recheck all these points]). Before it, four live failure modes could only be counted
44775
44785
  * by grepping Loki and hand-correlating timestamps, which is exactly how a
44776
44786
  * 22% thumbnail gap and a 3-hour media blackout were diagnosed — twice.
44777
44787
  *
@@ -48058,13 +48068,14 @@ var BaseDeviceProvider = class extends require_sleep.BaseAddon {
48058
48068
  async getStatus() {
48059
48069
  const all = await this.ctx.kernel.devices?.getAll() ?? [];
48060
48070
  const summary = this.restoreFailureSummary();
48061
- if (summary === null) return {
48071
+ const base = {
48062
48072
  connected: true,
48063
- deviceCount: all.length
48073
+ deviceCount: all.length,
48074
+ motionSliceWriter: "orchestrator"
48064
48075
  };
48076
+ if (summary === null) return base;
48065
48077
  return {
48066
- connected: true,
48067
- deviceCount: all.length,
48078
+ ...base,
48068
48079
  error: summary
48069
48080
  };
48070
48081
  }
@@ -67228,7 +67239,7 @@ var PreviewTextField = zod.z.string().max(200);
67228
67239
  * Whether the notification's preview is a STILL or a short animation.
67229
67240
  *
67230
67241
  * The operator's ask, verbatim: *"inviato come gif o video (come per le altre
67231
- * rule)"* — the other rules already offer an animated preview, and a ten-hour
67242
+ * rule)"* [sent as a gif or video (as for the other rules)] — the other rules already offer an animated preview, and a ten-hour
67232
67243
  * night reads better as three seconds of motion than as one frame of it. Both
67233
67244
  * modes get the SAME treatment (blurred frame, large centred title); `'gif'`
67234
67245
  * simply applies it to a dozen frames sampled across the render and assembles
package/dist/index.mjs CHANGED
@@ -1,6 +1,6 @@
1
1
  import { $ as CamProfileSchema, A as DEVICE_STATUS_METHOD, At as normalizeAddonInitResult, B as nodePin, Bt as hydrateSchema, C as customAction, Ct as PEER_BYTES_STALL_MS, D as adminUiCapability, Dt as SHARE_VIEW_KINDS, E as deviceCustomAction, Et as DATAPLANE_SECRET_HEADER, F as method, Ft as isEvent, G as emitDownForOwnedCaps, Gt as isAudioChunkFormat, H as toNodeId, Ht as AUDIO_CHUNK_FORMATS, I as optionalMethod, It as WELL_KNOWN_TABS, J as AudioChunkFormatSchema, K as readinessKey, L as resolveCapMount, Lt as WELL_KNOWN_TAB_MAP, M as event, Mt as createDurableState, N as expandCapMethods, Nt as createEvent, O as DEFAULT_RUNTIME_STATE_DURABILITY, Ot as DisposerChain, P as isDeviceConfigCap, Pt as emitReadiness, Q as CAM_PROFILE_ORDER, R as systemMethod, Rt as collectHydratedFieldEntries, S as DEVICE_CHILDREN_BATCH_MAX, St as PEER_BYTES_MAX_OUTSTANDING, T as describeCustomActions, Tt as PeerBytesTicketSchema, U as ReadinessRegistry, Ut as audioChunkBytesPerSample, V as readNodePin, Vt as resolveHydratedFieldValue, W as ReadinessTimeoutError, Wt as expandAudioChunkToF32le, X as BrokerStatsSchema, Y as AudioStreamPickSchema, Z as BrokerStatusSchema, _ as createMirrorSource, _t as makeProfileBrokerId, a as asJsonObject, at as EncodedPacketSchema, b as deviceOpsCapability, bt as selectAssignedProfileSlots, c as parseJsonArray, ct as ProfileRtspEntrySchema, d as BOOT_RECOVERY_BACKOFF_MS, dt as StreamSourceEntrySchema, et as CamStreamKindSchema, f as DEVICE_SCOPED_CAPS, ft as StreamSourceSchema, g as createLazyTrpcSource, gt as SubscribeFramesResultSchema, h as createEventBusSliceSource, ht as SubscribeFramesInputSchema, i as asJsonArray, it as DecodedFrameSchema, j as PROVIDER_PIN_FIELD, jt as normalizeNodeId, k as DEVICE_SETTINGS_CONTRIBUTION_METHODS, kt as BaseAddon, l as parseJsonObject, lt as ProfileSlotSchema, m as createDeviceProxy, mt as SubscribeAudioChunksResultSchema, n as sleepCancellable, nt as CameraStreamSchema, o as asNumber, ot as FrameHandleFormatSchema, p as isDeviceScopedCap, pt as SubscribeAudioChunksInputSchema, q as scopeKey, r as asBoolean, rt as DecodedAudioChunkSchema, s as asString, st as FrameHandleSchema, t as sleep, tt as CamStreamResolutionSchema, u as parseJsonUnknown, ut as ProfileSlotStatusSchema, v as createSliceHandle, vt as makeSourceBrokerId, w as defineCustomActions, wt as PEER_BYTES_TICKET_TTL_MS, x as viewerUiCapability, xt as PEER_BYTES_CHUNK_BYTES, y as RawStateResultSchema, yt as parseProfileBrokerId, z as CAP_NODE_PIN_CONTEXT_KEY, zt as collectHydratedFieldValues } from "./sleep-CDCONfkt.mjs";
2
2
  import { i as publicEventCategories, n as OWNER_ONLY_EVENT_CATEGORIES, r as isOwnerOnlyEventCategory, t as EventCategory } from "./event-category-BGmz_oxW.mjs";
3
- import { $ as MAX_EXPRESSION_AST_NODES, A as compositionFeatureEnabled, At as AUDIO_PRESETS, B as createStatefulExpressionMemory, Bt as resolveStreamMaps, C as CompositionTargetSchema, D as MAX_COMPOSITION_ITEMS, E as MAX_COMPOSITION_FIELDS_PER_FEATURE, F as featureFieldEntries, Ft as buildVideoArgs, G as createExpressionScope, H as evaluateStatefulExpressionCall, I as featureSources, It as invocationFromEncodeProfile, J as compileExpressionSafe, K as evaluateAst, L as fieldReads, Lt as isSoftwareDecode, M as compositionReadKey, Mt as buildAudioArgs, N as compositionSliceKey, Nt as buildFfmpegArgs, O as composedDeviceRef, Ot as canonicalHash, P as compositionSourceKey, Pt as buildInputArgs, Q as EXPRESSION_IDENTIFIER_RE, R as EXPRESSION_INJECTED_NOW, Rt as logBannerArgs, S as CompositionSourceRefSchema, St as FFMPEG_PATH_ENV, T as MAX_COMPOSITION_FEATURES, U as toExpressionValue, V as evaluateExpressionSource, W as validateExpressionSource, X as tokenize, Y as parseExpression, Z as EXPRESSION_COMPILE_CACHE_CAPACITY, _ as CompositionItemEntrySchema, _t as evaluateSensorEdge, a as CUSTOMIZATION_BLOCK_NAME_PREFIX, at as EXPRESSION_BUILTINS, b as CompositionPassthroughFeatureSchema, bt as sliceActiveValue, c as CompositionCommandTargetSchema, ct as evaluateRose, d as CompositionFeatureSchema, dt as ExpressionParseError, et as MAX_EXPRESSION_BINDINGS, f as CompositionFieldReadSchema, ft as DEFAULT_FIRST_SIGHTING_FRESHNESS_MS, g as CompositionFromSourceSchema, gt as SOURCE_DEVICE_TYPES, h as CompositionForwardCommandSchema, ht as SOURCE_CAP_CHANGED_AT_FIELD, i as COMPOSITION_ITEM_KEY_RE, it as RESERVED_BINDING_NAMES, j as compositionItemFieldPath, jt as audioPlanFromEncodeProfile, k as composedDeviceStableId, kt as Fmp4BoxSplitter, l as CompositionExistingTargetSchema, lt as isStatefulBuiltin, m as CompositionFieldsFeatureSchema, mt as SOURCE_CAP_ACTIVE_FIELD, n as COMPOSER_ADDON_ID, nt as MAX_EXPRESSION_EVAL_STEPS, o as CompositionBindingSchema, ot as EXPRESSION_BUILTIN_NAMES, p as CompositionFieldSourceSchema, pt as SOURCE_CAPS, q as compileExpression, r as COMPOSITION_ITEM_ARRAY_PATH, rt as MAX_EXPRESSION_SOURCE_LENGTH, s as CompositionCodeSourceSchema, st as evaluateCount, t as COMPOSED_DEVICE_STABLE_ID_PREFIX, tt as MAX_EXPRESSION_CALL_ARGS, u as CompositionExpressionSourceSchema, ut as ExpressionEvalError, v as CompositionLiteralBindingSchema, vt as evaluateSensorLevelEdge, w as MAX_COMPOSITION_CODE_LENGTH, x as CompositionSchema, xt as sliceChangedAt, y as CompositionNewTargetSchema, yt as isSourceCap, z as cloneStatefulExpressionMemory, zt as pickVideoEncoder } from "./composition-43aqsZQj.mjs";
3
+ import { $ as MAX_EXPRESSION_AST_NODES, A as compositionFeatureEnabled, At as AUDIO_PRESETS, B as createStatefulExpressionMemory, Bt as resolveStreamMaps, C as CompositionTargetSchema, D as MAX_COMPOSITION_ITEMS, E as MAX_COMPOSITION_FIELDS_PER_FEATURE, F as featureFieldEntries, Ft as buildVideoArgs, G as createExpressionScope, H as evaluateStatefulExpressionCall, I as featureSources, It as invocationFromEncodeProfile, J as compileExpressionSafe, K as evaluateAst, L as fieldReads, Lt as isSoftwareDecode, M as compositionReadKey, Mt as buildAudioArgs, N as compositionSliceKey, Nt as buildFfmpegArgs, O as composedDeviceRef, Ot as canonicalHash, P as compositionSourceKey, Pt as buildInputArgs, Q as EXPRESSION_IDENTIFIER_RE, R as EXPRESSION_INJECTED_NOW, Rt as logBannerArgs, S as CompositionSourceRefSchema, St as FFMPEG_PATH_ENV, T as MAX_COMPOSITION_FEATURES, U as toExpressionValue, V as evaluateExpressionSource, W as validateExpressionSource, X as tokenize, Y as parseExpression, Z as EXPRESSION_COMPILE_CACHE_CAPACITY, _ as CompositionItemEntrySchema, _t as evaluateSensorEdge, a as CUSTOMIZATION_BLOCK_NAME_PREFIX, at as EXPRESSION_BUILTINS, b as CompositionPassthroughFeatureSchema, bt as sliceActiveValue, c as CompositionCommandTargetSchema, ct as evaluateRose, d as CompositionFeatureSchema, dt as ExpressionParseError, et as MAX_EXPRESSION_BINDINGS, f as CompositionFieldReadSchema, ft as DEFAULT_FIRST_SIGHTING_FRESHNESS_MS, g as CompositionFromSourceSchema, gt as SOURCE_DEVICE_TYPES, h as CompositionForwardCommandSchema, ht as SOURCE_CAP_CHANGED_AT_FIELD, i as COMPOSITION_ITEM_KEY_RE, it as RESERVED_BINDING_NAMES, j as compositionItemFieldPath, jt as audioPlanFromEncodeProfile, k as composedDeviceStableId, kt as Fmp4BoxSplitter, l as CompositionExistingTargetSchema, lt as isStatefulBuiltin, m as CompositionFieldsFeatureSchema, mt as SOURCE_CAP_ACTIVE_FIELD, n as COMPOSER_ADDON_ID, nt as MAX_EXPRESSION_EVAL_STEPS, o as CompositionBindingSchema, ot as EXPRESSION_BUILTIN_NAMES, p as CompositionFieldSourceSchema, pt as SOURCE_CAPS, q as compileExpression, r as COMPOSITION_ITEM_ARRAY_PATH, rt as MAX_EXPRESSION_SOURCE_LENGTH, s as CompositionCodeSourceSchema, st as evaluateCount, t as COMPOSED_DEVICE_STABLE_ID_PREFIX, tt as MAX_EXPRESSION_CALL_ARGS, u as CompositionExpressionSourceSchema, ut as ExpressionEvalError, v as CompositionLiteralBindingSchema, vt as evaluateSensorLevelEdge, w as MAX_COMPOSITION_CODE_LENGTH, x as CompositionSchema, xt as sliceChangedAt, y as CompositionNewTargetSchema, yt as isSourceCap, z as cloneStatefulExpressionMemory, zt as pickVideoEncoder } from "./composition-D7ULvLdD.mjs";
4
4
  import { a as DeviceType, i as DeviceRole, n as ChargingStatus, r as DeviceFeature, t as errMsg } from "./err-msg-DX6i_MY4.mjs";
5
5
  import { EventSourceType } from "./enums.mjs";
6
6
  import { z } from "zod";
@@ -2353,22 +2353,22 @@ var CLASS_MAP_MACRO_TARGETS = [
2353
2353
  "package"
2354
2354
  ];
2355
2355
  /**
2356
- * Le macro classi di PRIMO LIVELLO: quelle che un object detector emette e che
2357
- * un operatore può selezionare.
2356
+ * The FIRST-LEVEL macro classes: those an object detector emits and that
2357
+ * an operator can select.
2358
2358
  *
2359
- * Sono le tre offerte dallo step `object-detection`
2359
+ * They are the three offered by the `object-detection` step
2360
2360
  * (`addon-pipeline/src/detection-pipeline/registry/step-definitions.ts`,
2361
- * `enabledMacroClasses`). `package` sta in {@link CLASS_MAP_MACRO_TARGETS} e in
2362
- * `MACRO_LABELS` — è una macro vera — ma NON qui: appartiene allo step
2363
- * `package-detection`, la cui abilitazione è guidata dalle zone, e offrire la
2364
- * stessa parola due volte ha già fatto accendere a un operatore il proxy COCO
2361
+ * `enabledMacroClasses`). `package` is in {@link CLASS_MAP_MACRO_TARGETS} and in
2362
+ * `MACRO_LABELS` — it is a true macro — but NOT here: it belongs to the step
2363
+ * `package-detection`, whose enablement is driven by zones, and offering the
2364
+ * same word twice has already made an operator turn on the COCO proxy
2365
2365
  * (suitcase/backpack/handbag) lasciando spento il detector dedicato.
2366
2366
  *
2367
- * UNA lista. Prima di oggi le stesse tre erano scritte a mano nell'offerta
2368
- * dello step e una seconda volta come union `FirstLevelMacro`
2369
- * (`types/detection.ts`); una terza copia per il trigger di registrazione
2370
- * (`RecordingTriggers.objectClasses`) avrebbe reso invisibile la divergenza
2371
- * successiva.
2367
+ * ONE list. Before today the same three were hand-written in the step's offer
2368
+ * and a second time as the union `FirstLevelMacro`
2369
+ * (`types/detection.ts`); a third copy for the recording trigger
2370
+ * (`RecordingTriggers.objectClasses`) would have made the later divergence
2371
+ * invisible.
2372
2372
  */
2373
2373
  var FIRST_LEVEL_MACRO_CLASSES = [
2374
2374
  "person",
@@ -2376,8 +2376,8 @@ var FIRST_LEVEL_MACRO_CLASSES = [
2376
2376
  "animal"
2377
2377
  ];
2378
2378
  /**
2379
- * True quando `value` è una macro di primo livello. Type guard, non cast: un
2380
- * `className` che arriva dal bus è una stringa qualunque finché non passa di
2379
+ * True when `value` is a first-level macro. Type guard, not cast: a
2380
+ * `className` coming from the bus is any string until it passes through
2381
2381
  * qui.
2382
2382
  */
2383
2383
  function isFirstLevelMacroClass(value) {
@@ -2461,26 +2461,26 @@ var RecordingStorageModeSchema = z.enum([
2461
2461
  "on-device-decision"
2462
2462
  ]);
2463
2463
  /**
2464
- * Le macro classi che possono aprire una finestra di registrazione — le stesse
2465
- * tre offerte dallo step `object-detection`, da UNA lista
2464
+ * The macro classes that can open a recording window — the same
2465
+ * three offered by the `object-detection` step, from ONE list
2466
2466
  * ({@link FIRST_LEVEL_MACRO_CLASSES}).
2467
2467
  */
2468
2468
  var RecordingObjectTriggerClassSchema = z.enum(FIRST_LEVEL_MACRO_CLASSES);
2469
2469
  /**
2470
- * True quando `values` non ripete un elemento.
2470
+ * True when `values` does not repeat an element.
2471
2471
  *
2472
- * Un duplicato non è innocuo: ogni voce di `objectClasses` / `sensorDeviceIds`
2473
- * diventa una SORGENTE in `bandTriggerSources`, e la stessa sorgente due volte
2474
- * conterebbe due volte le sue finestre in `segmentMissedByMs`.
2472
+ * A duplicate is not harmless: every entry of `objectClasses` / `sensorDeviceIds`
2473
+ * becomes a SOURCE in `bandTriggerSources`, and the same source twice
2474
+ * would count its windows twice in `segmentMissedByMs`.
2475
2475
  */
2476
2476
  var noDuplicates = (values) => new Set(values).size === values.length;
2477
2477
  /**
2478
- * Quanti device sorgente una singola banda può ascoltare.
2478
+ * How many source devices a single band can listen to.
2479
2479
  *
2480
- * Non è un gusto: ogni sorgente è una CHIAVE nel `TriggerState` del recorder, e
2481
- * il limite per chiave (`MAX_TRIGGER_WINDOWS = 32`) senza un limite sulle
2482
- * chiavi lascerebbe crescere la mappa con l'inventario dell'operatore. 16
2483
- * sensori su UNA camera è già oltre qualunque installazione osservata.
2480
+ * It is not a whim: every source is a KEY in the recorder's `TriggerState`, and
2481
+ * the per-key limit (`MAX_TRIGGER_WINDOWS = 32`) without a limit on the
2482
+ * keys would let the map grow with the operator's inventory. 16
2483
+ * sensors on ONE camera is already beyond any installation observed.
2484
2484
  */
2485
2485
  var MAX_SENSOR_TRIGGER_DEVICES = 16;
2486
2486
  /**
@@ -2512,34 +2512,34 @@ var RecordingTriggersSchema = z.object({
2512
2512
  motion: z.boolean().optional(),
2513
2513
  audioThresholdDbfs: z.number().optional(),
2514
2514
  /**
2515
- * Le macro classi la cui detection apre una finestra. ASSENTE = la sorgente
2516
- * non è ascoltata; un array VUOTO è rifiutato, perché "banda events, trigger
2517
- * object acceso, nessuna classe" è la stessa forma "abilitata e non registra
2518
- * nulla, per sempre" contro cui è scritto `eventsBandCanEverDemand`.
2515
+ * The macro classes whose detection opens a window. ABSENT = the source
2516
+ * is not listened to; an EMPTY array is rejected, because "events band, object
2517
+ * trigger on, no class" is the same shape "enabled and records
2518
+ * nothing, forever" that `eventsBandCanEverDemand` is written against.
2519
2519
  *
2520
- * Il segnale letto è GIÀ FILTRATO: solo detection `source: 'pipeline'`, cioè
2521
- * quelle che hanno attraversato `enabledMacroClasses`, i
2522
- * `minConfidence<Macro>` e il full-frame guard. L'AI a bordo camera
2523
- * (`source: 'onboard'`) non attraversa nessuno di quei gate e NON apre
2524
- * finestre — vedi `recorder/object-trigger.ts`.
2520
+ * The signal read is ALREADY FILTERED: only `source: 'pipeline'` detections, i.e.
2521
+ * those that went through `enabledMacroClasses`, the
2522
+ * `minConfidence<Macro>` and the full-frame guard. The camera's onboard AI
2523
+ * (`source: 'onboard'`) goes through none of those gates and does NOT open
2524
+ * windows — see `recorder/object-trigger.ts`.
2525
2525
  */
2526
2526
  objectClasses: z.array(RecordingObjectTriggerClassSchema).min(1).refine(noDuplicates, { message: "objectClasses must not repeat a class" }).optional(),
2527
2527
  /**
2528
- * I device LINKED il cui FRONTE ALTO apre una finestra. Assente = la sorgente
2529
- * non è ascoltata; un array vuoto è rifiutato per la stessa ragione di
2528
+ * The LINKED devices whose RISING EDGE opens a window. Absent = the source
2529
+ * is not listened to; an empty array is rejected for the same reason as
2530
2530
  * `objectClasses`.
2531
2531
  *
2532
- * Sono id di device SORGENTE, non camere: la banda li nomina, quindi il
2533
- * percorso caldo (`DeviceStateChanged`, a ritmo di bus su tutta la flotta)
2534
- * non fa RPC. L'OFFERTA da cui l'operatore li sceglie è un'altra domanda, e
2535
- * si risolve con `deviceManager.getLinkedDevices` + `getBindingsBatch` per
2536
- * device (D12) — mai un elenco globale di cap.
2532
+ * These are SOURCE device ids, not cameras: the band names them, so the
2533
+ * hot path (`DeviceStateChanged`, at bus rate across the whole fleet)
2534
+ * does no RPC. The OFFER from which the operator picks them is another question, and
2535
+ * is resolved with `deviceManager.getLinkedDevices` + `getBindingsBatch` per
2536
+ * device (D12) — never a global list of caps.
2537
2537
  *
2538
- * Cosa vuol dire "alto" dipende dal TIPO di device e non è deciso qui:
2539
- * `SOURCE_CAP_ACTIVE_FIELD` (`catalogs/sensor-active-state.ts`) è LA tabella,
2540
- * la stessa del campanello composto (D671). Ed è il FRONTE, non
2541
- * il livello: un contatto trovato già aperto al riavvio del runner non fa
2542
- * registrare.
2538
+ * What "high" means depends on the device TYPE and is not decided here:
2539
+ * `SOURCE_CAP_ACTIVE_FIELD` (`catalogs/sensor-active-state.ts`) is THE table,
2540
+ * the same one as the composite doorbell (D671). And it is the EDGE, not
2541
+ * the level: a contact found already open at runner restart does not
2542
+ * record.
2543
2543
  */
2544
2544
  sensorDeviceIds: z.array(z.number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
2545
2545
  });
@@ -4219,7 +4219,7 @@ function findTimezone(id) {
4219
4219
  * - **VALUE** — at which level, for which scope, until when. That stays ONE
4220
4220
  * thing: the logging settings document on the `system` cap. Two authorities
4221
4221
  * over the values is the exact defect
4222
- * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
4222
+ * `docs/design/plans/2026-08-26-per-component-logging.md` was written to
4223
4223
  * remove; re-introducing it from the cure side would be grotesque.
4224
4224
  *
4225
4225
  * Nothing in this file reads a clock, an env var or a store. The registry is
@@ -11932,7 +11932,7 @@ var dataStoreProviderCapability = {
11932
11932
  *
11933
11933
  * ⚠ An earlier version of this comment blamed Zod stripping, and that
11934
11934
  * was wrong — corrected 2026-08-26 after the hop map
11935
- * (`docs/design/2026-08-26-mappa-hop-argomenti.md`) traced the path.
11935
+ * (`docs/design/2026-08-26-topic-hop-map.md`) traced the path.
11936
11936
  * There is **no Zod parse at all** between the door and the engine: the
11937
11937
  * dispatcher forwards the payload verbatim and UDS carries it whole. A
11938
11938
  * field declared here reaches `SqliteSettingsBackend` either way.
@@ -13326,7 +13326,17 @@ function siteZoneKey(label) {
13326
13326
  var ProviderStatusSchema = z.object({
13327
13327
  connected: z.boolean(),
13328
13328
  deviceCount: z.number(),
13329
- error: z.string().optional()
13329
+ error: z.string().optional(),
13330
+ /**
13331
+ * `'orchestrator'`: this provider writes NO camera's `motion` runtime slice
13332
+ * — the orchestrator is its only writer (D696). Set by `BaseDeviceProvider`,
13333
+ * which every provider bundles, so only a provider BUILT from D696-amended
13334
+ * code says it. ABSENT means an older provider that may still write it (raw
13335
+ * VMD writes, a boot seed), and the orchestrator's provider gate keeps that
13336
+ * provider's cameras unwritten (`camera-sensors/motion-slice-provider-gate.ts`)
13337
+ * — the provider twin of the runner's `getLocalLoad().motionSliceWriter`.
13338
+ */
13339
+ motionSliceWriter: z.literal("orchestrator").optional()
13330
13340
  });
13331
13341
  var DiscoveredDeviceSchema = z.object({
13332
13342
  externalId: z.string(),
@@ -14519,7 +14529,7 @@ var deviceManagerCapability = {
14519
14529
  * sources could be switched off without switching off the rest (D556, then
14520
14530
  * D555's re-key by source). The operator removed the whole idea the same
14521
14531
  * day: *"tutti i providers funzionano sempre, non serve
14522
- * disattivarli/attivarli … loro vivono lì"* (D557 amended, third). A
14532
+ * disattivarli/attivarli … loro vivono lì"* [all the providers always work, there is no need to deactivate/activate them … they live there] (D557 amended, third). A
14523
14533
  * collection cap's providers are a DERIVED set — every addon that provides
14524
14534
  * the cap for this device type, computed on every read and persisted
14525
14535
  * nowhere — so there is nothing here to activate, and a verb that accepted
@@ -15485,7 +15495,7 @@ var embeddingEncoderCapability = {
15485
15495
  * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
15486
15496
  * ends in a log line, and a log line is the thing the operator asked to stop
15487
15497
  * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
15488
- * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
15498
+ * ricontrolliamo tutti questi punti"* [can we instrument these errors in the meantime? That way next round we recheck all these points]. Reading them meant grepping Loki and
15489
15499
  * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
15490
15500
  * media blackout were both diagnosed. The counters stay; this is where they can
15491
15501
  * be READ.
@@ -23169,14 +23179,14 @@ var TrackSchema = z.object({
23169
23179
  * `derive-returned-null tile=standin`,
23170
23180
  * `native-tile tile=native no-key-frame-at-close`, …) written at close and
23171
23181
  * CLEARED by the late-keyFrame upgrade when a native tile lands after all.
23172
- * The operator-facing answer to "perché manca l'immagine?" on a track whose
23182
+ * The operator-facing answer to "perché manca l'immagine?" [why is the image missing?] on a track whose
23173
23183
  * tile is a face/plate stand-in, a raster crop, or an icon.
23174
23184
  *
23175
23185
  * **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
23176
23186
  * the TILE ranked below native, so a track whose thumbnail landed natively
23177
23187
  * while its key frame missed carried no reason at all — three of the four
23178
23188
  * `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
23179
- * that shape, and their "niente ultimo" had no cause anywhere on the row.
23189
+ * that shape, and their "niente ultimo" [no last frame] had no cause anywhere on the row.
23180
23190
  * The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
23181
23191
  * lastFrame copy source`), so its absence is now on this line whatever the
23182
23192
  * tile ended up being.
@@ -23263,7 +23273,7 @@ var MotionEventSchema = z.object({
23263
23273
  /**
23264
23274
  * Ms offsets from `timestamp` (the episode's own first rising edge, so the
23265
23275
  * first entry is always `0`) of every genuine off→on transition the
23266
- * episode saw — "ogni evento on si deve salvare" (D475). NOT one entry per
23276
+ * episode saw — "ogni evento on si deve salvare" [every ON event must be saved] (D475). NOT one entry per
23267
23277
  * push: a firmware source that keepalives at ~1 Hz for the whole burst
23268
23278
  * (Reolink, Hikvision) produces exactly one edge; a source that reports an
23269
23279
  * explicit `false` mid-episode and then resumes before the quiet window
@@ -30714,7 +30724,7 @@ var vectorStoreCapability = {
30714
30724
  *
30715
30725
  * `listClips` is asked of ONE provider at a time, and NAMING it is REQUIRED
30716
30726
  * ({@link videoclipsCapability.methods.listClips} `provider`, D554 amended). It is not
30717
- * a union over everything a camera has: *"l'utilizzatore è uno solo"*. There
30727
+ * a union over everything a camera has: *"l'utilizzatore è uno solo"* [there is only one user]. There
30718
30728
  * is no default, because a collection cap's binding set is DERIVED and PLURAL
30719
30729
  * (D554 amended, `getBindings` step 0) — "the bound one" does not exist to
30720
30730
  * resolve to, and the one thing that could take its place is a second
@@ -31056,7 +31066,7 @@ var ClipPlaybackSchema = z.object({
31056
31066
  * **One authorised yes is one wake.** `next-natural` — take the clip the next
31057
31067
  * time the camera is awake for its own reasons — is deliberately not a member:
31058
31068
  * it was proposed, it is free on the battery, and the operator declined it on
31059
- * 2026-09-20 (*"Quando un export viene richiesto si sveglia la camera."*,
31069
+ * 2026-09-20 (*"Quando un export viene richiesto si sveglia la camera."* [When an export is requested the camera wakes up],
31060
31070
  * D558 "Considered and not taken").
31061
31071
  */
31062
31072
  var ClipWakeSchema = z.enum(["authorised"]);
@@ -31452,7 +31462,7 @@ var videoclipsCapability = {
31452
31462
  * **It is a SECTION of the Recording tab, at the end of it — not a tab of
31453
31463
  * its own.** It shipped as a `clips` top-tab and the operator rejected the
31454
31464
  * placement: *"utilizzerei la stessa tab recordings, lì abbiamo già tutto il
31455
- * necessario, una nuova sezione alla fine per le clips"*. The Recording tab
31465
+ * necessario, una nuova sezione alla fine per le clips"* [I would use the same recordings tab, there we already have everything necessary, a new section at the end for the clips]. The Recording tab
31456
31466
  * already holds the recorder's panel, the schedule bands and the unified
31457
31467
  * retention policy; footage the camera itself holds is the same question,
31458
31468
  * asked of a different store. `order: 100` puts it after all of them with
@@ -31513,7 +31523,7 @@ var videoclipsCapability = {
31513
31523
  * It replaced `sources?: string[]`, a VIEW filter over source ids that
31514
31524
  * assumed the answer was a fan-out over everything a camera has. The
31515
31525
  * operator settled otherwise on 2026-09-20 — *"l'utilizzatore è uno
31516
- * solo"* — so the list is asked of one provider at a time and there is
31526
+ * solo"* [there is only one user] — so the list is asked of one provider at a time and there is
31517
31527
  * nothing to filter out of it.
31518
31528
  */
31519
31529
  provider: z.string().min(1)
@@ -37403,7 +37413,7 @@ authKey: z.string().optional() }), z.object({
37403
37413
  */
37404
37414
  /**
37405
37415
  * How long after a camera's last rising edge `pipeline-analytics` closes the
37406
- * motion EPISODE row it kept open for it (D475) — "il delay della cap", in
37416
+ * motion EPISODE row it kept open for it (D475) — "il delay della cap" [the cap's delay], in
37407
37417
  * the operator's words. One authority for the whole system: the writer of a
37408
37418
  * `Camera` device's slice (the orchestrator, D696) writes this SAME constant
37409
37419
  * in `autoClearAfterMs` while `detected: true` (never a camera's own clock —
@@ -41370,7 +41380,7 @@ var ReadGopBytesResultSchema = z.object({
41370
41380
  /**
41371
41381
  * A time WINDOW of one finalized segment, cut by byte range — the multi-GOP
41372
41382
  * twin of {@link ReadGopBytesResultSchema}'s single instant. Built for the
41373
- * replay clip's `recording` source (`docs/design/plans/2026-08-26-replay-clip-su-pipeline.md`):
41383
+ * replay clip's `recording` source (`docs/design/plans/2026-08-26-clip-replay-on-pipeline.md`):
41374
41384
  * a replay needs several seconds of native pixels, not one frame.
41375
41385
  *
41376
41386
  * `ok.data` is standalone-demuxable, same as a GOP read. `ok.reachesRequestedEnd`
@@ -44770,7 +44780,7 @@ var systemCapability = {
44770
44780
  *
44771
44781
  * This is the surface the operator asked for on 2026-08-28 (*"possiamo
44772
44782
  * armare questi errori intanto? Così al prossimo giro ricontrolliamo tutti
44773
- * questi punti"*). Before it, four live failure modes could only be counted
44783
+ * questi punti"* [can we instrument these errors in the meantime? That way next round we recheck all these points]). Before it, four live failure modes could only be counted
44774
44784
  * by grepping Loki and hand-correlating timestamps, which is exactly how a
44775
44785
  * 22% thumbnail gap and a 3-hour media blackout were diagnosed — twice.
44776
44786
  *
@@ -48057,13 +48067,14 @@ var BaseDeviceProvider = class extends BaseAddon {
48057
48067
  async getStatus() {
48058
48068
  const all = await this.ctx.kernel.devices?.getAll() ?? [];
48059
48069
  const summary = this.restoreFailureSummary();
48060
- if (summary === null) return {
48070
+ const base = {
48061
48071
  connected: true,
48062
- deviceCount: all.length
48072
+ deviceCount: all.length,
48073
+ motionSliceWriter: "orchestrator"
48063
48074
  };
48075
+ if (summary === null) return base;
48064
48076
  return {
48065
- connected: true,
48066
- deviceCount: all.length,
48077
+ ...base,
48067
48078
  error: summary
48068
48079
  };
48069
48080
  }
@@ -67227,7 +67238,7 @@ var PreviewTextField = z.string().max(200);
67227
67238
  * Whether the notification's preview is a STILL or a short animation.
67228
67239
  *
67229
67240
  * The operator's ask, verbatim: *"inviato come gif o video (come per le altre
67230
- * rule)"* — the other rules already offer an animated preview, and a ten-hour
67241
+ * rule)"* [sent as a gif or video (as for the other rules)] — the other rules already offer an animated preview, and a ten-hour
67231
67242
  * night reads better as three seconds of motion than as one frame of it. Both
67232
67243
  * modes get the SAME treatment (blurred frame, large centred title); `'gif'`
67233
67244
  * simply applies it to a dozen frames sampled across the render and assembles
@@ -55,8 +55,8 @@ export declare const RecordingStorageModeSchema: z.ZodEnum<{
55
55
  }>;
56
56
  export type RecordingStorageMode = z.infer<typeof RecordingStorageModeSchema>;
57
57
  /**
58
- * Le macro classi che possono aprire una finestra di registrazione — le stesse
59
- * tre offerte dallo step `object-detection`, da UNA lista
58
+ * The macro classes that can open a recording window — the same
59
+ * three offered by the `object-detection` step, from ONE list
60
60
  * ({@link FIRST_LEVEL_MACRO_CLASSES}).
61
61
  */
62
62
  export declare const RecordingObjectTriggerClassSchema: z.ZodEnum<{
@@ -66,12 +66,12 @@ export declare const RecordingObjectTriggerClassSchema: z.ZodEnum<{
66
66
  }>;
67
67
  export type RecordingObjectTriggerClass = z.infer<typeof RecordingObjectTriggerClassSchema>;
68
68
  /**
69
- * Quanti device sorgente una singola banda può ascoltare.
69
+ * How many source devices a single band can listen to.
70
70
  *
71
- * Non è un gusto: ogni sorgente è una CHIAVE nel `TriggerState` del recorder, e
72
- * il limite per chiave (`MAX_TRIGGER_WINDOWS = 32`) senza un limite sulle
73
- * chiavi lascerebbe crescere la mappa con l'inventario dell'operatore. 16
74
- * sensori su UNA camera è già oltre qualunque installazione osservata.
71
+ * It is not a whim: every source is a KEY in the recorder's `TriggerState`, and
72
+ * the per-key limit (`MAX_TRIGGER_WINDOWS = 32`) without a limit on the
73
+ * keys would let the map grow with the operator's inventory. 16
74
+ * sensors on ONE camera is already beyond any installation observed.
75
75
  */
76
76
  export declare const MAX_SENSOR_TRIGGER_DEVICES = 16;
77
77
  /**
@@ -12,7 +12,7 @@
12
12
  * - **VALUE** — at which level, for which scope, until when. That stays ONE
13
13
  * thing: the logging settings document on the `system` cap. Two authorities
14
14
  * over the values is the exact defect
15
- * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
15
+ * `docs/design/plans/2026-08-26-per-component-logging.md` was written to
16
16
  * remove; re-introducing it from the cure side would be grotesque.
17
17
  *
18
18
  * Nothing in this file reads a clock, an env var or a store. The registry is
package/dist/node.js CHANGED
@@ -21,7 +21,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
21
21
  enumerable: true
22
22
  }) : target, mod));
23
23
  //#endregion
24
- const require_composition = require("./composition-w3gBWMer.js");
24
+ const require_composition = require("./composition-DexM_etk.js");
25
25
  const require_err_msg = require("./err-msg-Dx2Kor0g.js");
26
26
  let node_crypto = require("node:crypto");
27
27
  let node_fs = require("node:fs");
package/dist/node.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import { Ct as chooseFfmpegBinary, Dt as getFfmpegDownloadUrl, Et as getFfmpegArtifact, Lt as isSoftwareDecode, Nt as buildFfmpegArgs, Ot as canonicalHash, P as compositionSourceKey, St as FFMPEG_PATH_ENV, Tt as FFMPEG_RELEASE, a as CUSTOMIZATION_BLOCK_NAME_PREFIX, kt as Fmp4BoxSplitter, wt as ffmpegBinaryName } from "./composition-43aqsZQj.mjs";
1
+ import { Ct as chooseFfmpegBinary, Dt as getFfmpegDownloadUrl, Et as getFfmpegArtifact, Lt as isSoftwareDecode, Nt as buildFfmpegArgs, Ot as canonicalHash, P as compositionSourceKey, St as FFMPEG_PATH_ENV, Tt as FFMPEG_RELEASE, a as CUSTOMIZATION_BLOCK_NAME_PREFIX, kt as Fmp4BoxSplitter, wt as ffmpegBinaryName } from "./composition-D7ULvLdD.mjs";
2
2
  import { t as errMsg } from "./err-msg-DX6i_MY4.mjs";
3
3
  import { createHash, createHmac, randomUUID, timingSafeEqual } from "node:crypto";
4
4
  import * as fs from "node:fs";
@@ -11,7 +11,7 @@
11
11
  * The divergence it caused is on the record: the viewer filtered conditions on
12
12
  * the served `appliesTo` alone, so a viewer-authored occupancy rule was still
13
13
  * offered `sensorKinds`, `eventTypeTokens` and `source` — the exact "in
14
- * occupancy alcuni campi non hanno senso" failure the admin UI fixed on
14
+ * occupancy alcuni campi non hanno senso" [in occupancy some fields make no sense] failure the admin UI fixed on
15
15
  * 2026-08-14 and the viewer never got. Beside it, the viewer's rule list had no
16
16
  * sections and no seeded creates, so the two features that have no delivery of
17
17
  * their own (sound, occupancy) were unauthorable from the phone.
@@ -318,7 +318,7 @@ export declare function droppedConditionsForKind(conditions: NcAuthoredCondition
318
318
  * The sections a rule LIST is split into.
319
319
  *
320
320
  * Operator request, 2026-08-13: "vorrei che le system rules fossero in una
321
- * sezione a parte, più facile da utilizzare, affianco alle detection rules". A
321
+ * sezione a parte, più facile da utilizzare, affianco alle detection rules" [I would like the system rules to be in a separate section, easier to use, next to the detection rules]. A
322
322
  * system rule and a detection rule share a store and nothing else — different
323
323
  * triggers, different conditions, no media, a different question ("is my
324
324
  * installation healthy?" vs "what did the camera see?").
@@ -420,7 +420,7 @@ export declare const NC_AUDIO_SEED: NcAudioCondition;
420
420
  * so the preset seeds it — otherwise the operator lands on a form identical to
421
421
  * a detection rule's and has to know that the feature lives behind an expander
422
422
  * on a trigger they must pick first. That is exactly the gap reported on
423
- * 2026-08-13 ("non vedo un modo per creare le nuove rules audio e occupancy")
423
+ * 2026-08-13 ("non vedo un modo per creare le nuove rules audio e occupancy" [I do not see a way to create the new audio and occupancy rules])
424
424
  * for two features whose engines had already shipped.
425
425
  *
426
426
  * A system seed carries its event kinds for the same reason: the kind is derived
@@ -39,7 +39,7 @@ export declare const TIMELAPSE_DENSE_FLOOR_SEC = 0.1;
39
39
  * Whether the notification's preview is a STILL or a short animation.
40
40
  *
41
41
  * The operator's ask, verbatim: *"inviato come gif o video (come per le altre
42
- * rule)"* — the other rules already offer an animated preview, and a ten-hour
42
+ * rule)"* [sent as a gif or video (as for the other rules)] — the other rules already offer an animated preview, and a ten-hour
43
43
  * night reads better as three seconds of motion than as one frame of it. Both
44
44
  * modes get the SAME treatment (blurred frame, large centred title); `'gif'`
45
45
  * simply applies it to a dozen frames sampled across the render and assembles
@@ -117,11 +117,11 @@ export type DetectionKind = 'first-level' | 'detail' | 'audio';
117
117
  /**
118
118
  * First-level macro classes produced by object detectors.
119
119
  *
120
- * Alias di {@link FirstLevelMacroClass} — LA lista sta in `labels.ts`
121
- * (`FIRST_LEVEL_MACRO_CLASSES`), che è anche l'offerta dello step
122
- * `object-detection` e il dominio di `RecordingTriggers.objectClasses`. Non
123
- * riscrivere l'union qui: erano due copie a mano, ed è così che una macro
124
- * aggiunta in un posto solo passa inosservata.
120
+ * Alias of {@link FirstLevelMacroClass} — THE list lives in `labels.ts`
121
+ * (`FIRST_LEVEL_MACRO_CLASSES`), which is also the offer of the
122
+ * `object-detection` step and the domain of `RecordingTriggers.objectClasses`. Do not
123
+ * rewrite the union here: there were two hand-kept copies, and that is how a macro
124
+ * added in one place only goes unnoticed.
125
125
  */
126
126
  export type FirstLevelMacro = FirstLevelMacroClass;
127
127
  /** Detail macro classes produced by crop+recognize steps. */
@@ -250,10 +250,10 @@ export interface DetectionBase {
250
250
  readonly score: number;
251
251
  /**
252
252
  * Enrichment labels — each with its own score. Ordered:
253
- * (1) catena di enricher diretti sulla detection,
254
- * (2) labels ereditate dai children details (in ordine di apparizione).
255
- * Lo score preserva il valore prodotto dall'enricher originale anche
256
- * quando la label è ereditata.
253
+ * (1) chain of direct enrichers on the detection,
254
+ * (2) labels inherited from the children details (in order of appearance).
255
+ * The score preserves the value produced by the original enricher even
256
+ * when the label is inherited.
257
257
  */
258
258
  readonly labels: readonly ScoredLabel[];
259
259
  readonly track?: TrackInfo;
@@ -23,28 +23,28 @@ export interface ClassMapDefinition {
23
23
  /** Detection-macro targets a catalog `classMap` may resolve to. */
24
24
  export declare const CLASS_MAP_MACRO_TARGETS: readonly ["person", "vehicle", "animal", "package"];
25
25
  /**
26
- * Le macro classi di PRIMO LIVELLO: quelle che un object detector emette e che
27
- * un operatore può selezionare.
26
+ * The FIRST-LEVEL macro classes: those an object detector emits and that
27
+ * an operator can select.
28
28
  *
29
- * Sono le tre offerte dallo step `object-detection`
29
+ * They are the three offered by the `object-detection` step
30
30
  * (`addon-pipeline/src/detection-pipeline/registry/step-definitions.ts`,
31
- * `enabledMacroClasses`). `package` sta in {@link CLASS_MAP_MACRO_TARGETS} e in
32
- * `MACRO_LABELS` — è una macro vera — ma NON qui: appartiene allo step
33
- * `package-detection`, la cui abilitazione è guidata dalle zone, e offrire la
34
- * stessa parola due volte ha già fatto accendere a un operatore il proxy COCO
31
+ * `enabledMacroClasses`). `package` is in {@link CLASS_MAP_MACRO_TARGETS} and in
32
+ * `MACRO_LABELS` — it is a true macro — but NOT here: it belongs to the step
33
+ * `package-detection`, whose enablement is driven by zones, and offering the
34
+ * same word twice has already made an operator turn on the COCO proxy
35
35
  * (suitcase/backpack/handbag) lasciando spento il detector dedicato.
36
36
  *
37
- * UNA lista. Prima di oggi le stesse tre erano scritte a mano nell'offerta
38
- * dello step e una seconda volta come union `FirstLevelMacro`
39
- * (`types/detection.ts`); una terza copia per il trigger di registrazione
40
- * (`RecordingTriggers.objectClasses`) avrebbe reso invisibile la divergenza
41
- * successiva.
37
+ * ONE list. Before today the same three were hand-written in the step's offer
38
+ * and a second time as the union `FirstLevelMacro`
39
+ * (`types/detection.ts`); a third copy for the recording trigger
40
+ * (`RecordingTriggers.objectClasses`) would have made the later divergence
41
+ * invisible.
42
42
  */
43
43
  export declare const FIRST_LEVEL_MACRO_CLASSES: readonly ["person", "vehicle", "animal"];
44
44
  export type FirstLevelMacroClass = (typeof FIRST_LEVEL_MACRO_CLASSES)[number];
45
45
  /**
46
- * True quando `value` è una macro di primo livello. Type guard, non cast: un
47
- * `className` che arriva dal bus è una stringa qualunque finché non passa di
46
+ * True when `value` is a first-level macro. Type guard, not cast: a
47
+ * `className` coming from the bus is any string until it passes through
48
48
  * qui.
49
49
  */
50
50
  export declare function isFirstLevelMacroClass(value: string): value is FirstLevelMacroClass;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/types",
3
- "version": "1.2.285",
3
+ "version": "1.2.287",
4
4
  "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
5
5
  "keywords": [
6
6
  "camstack",