@camstack/addon-terminal 0.1.79 → 0.1.81

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/addon.js CHANGED
@@ -7948,17 +7948,29 @@ var HHMM = /^([01]\d|2[0-3]):[0-5]\d$/;
7948
7948
  /**
7949
7949
  * DERIVED per-camera storage summary — the single field cheap consumers read
7950
7950
  * (the viewer's status dot, the camera list) instead of walking `bands`:
7951
- * - `off` — no band covers the camera (or it is disabled).
7952
- * - `events` — every band records around triggers only.
7953
- * - `continuous` — at least one band records continuously.
7954
- *
7955
- * NEVER authored: the recorder stamps it from the authoritative `bands` on
7956
- * every save (`activeModeForConfig`). Writing it has no effect.
7951
+ * - `off` — no band covers the camera (or it is disabled).
7952
+ * - `events` — every band records around triggers only.
7953
+ * - `continuous` — at least one band records continuously.
7954
+ * - `on-device-decision`— the DEVICE decides: recording runs for as long as the
7955
+ * camera raises its own `recording-signal` level (a robot that cleans). There
7956
+ * is no schedule to author, because there is no hour to program — see
7957
+ * {@link RecordingConfigSchema}`.deviceDecision`.
7958
+ *
7959
+ * NEVER authored: the recorder stamps it from the authoritative intent
7960
+ * (`bands` + `deviceDecision`) on every save (`activeModeForConfig`). Writing it
7961
+ * has no effect.
7962
+ *
7963
+ * `on-device-decision` is named for WHO decides, not for how the recording is
7964
+ * requested. `on-demand` was rejected: in this repo's vocabulary a "demand" is
7965
+ * something the operator makes (the live gate is the recorder's own "demand
7966
+ * window"), and a knob whose name suggests the operator starts it while the
7967
+ * device actually does is the D62 shape — a control nobody can predict.
7957
7968
  */
7958
7969
  var RecordingStorageModeSchema = _enum([
7959
7970
  "off",
7960
7971
  "events",
7961
- "continuous"
7972
+ "continuous",
7973
+ "on-device-decision"
7962
7974
  ]);
7963
7975
  /**
7964
7976
  * Le macro classi che possono aprire una finestra di registrazione — le stesse
@@ -8008,22 +8020,7 @@ var RecordingTriggersSchema = object({
8008
8020
  * il livello: un contatto trovato già aperto al riavvio del runner non fa
8009
8021
  * registrare.
8010
8022
  */
8011
- sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional(),
8012
- /**
8013
- * La camera registra per tutta la durata del SEGNALE che lei stessa
8014
- * pubblica — la cap `recording-signal` (`active: true` mentre il device è in
8015
- * funzione: un robot che pulisce). È un LIVELLO, non un fronte: la finestra
8016
- * resta aperta finché il segnale è alto e si chiude `postBufferSec` dopo la
8017
- * caduta, così una pulizia di quaranta minuti è UNA clip.
8018
- *
8019
- * Non nomina un device: il segnale è della camera stessa, tenuto fresco dal
8020
- * suo provider (D224); il recorder lo ascolta su `DeviceStateChanged` e lo
8021
- * riconcilia leggendo la slice via RPC, con un tetto oltre il quale un
8022
- * segnale mai abbassato (un evento perso) non può tenere aperta una
8023
- * registrazione (D11). Vedi `recorder/addon/band-decision.ts`
8024
- * (`holdTrigger` / `releaseTrigger`).
8025
- */
8026
- deviceSignal: boolean().optional()
8023
+ sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
8027
8024
  });
8028
8025
  /**
8029
8026
  * Mode of a single recording band — the recorder per-band vocabulary.
@@ -8107,8 +8104,29 @@ var RecordingConfigSchema = object({
8107
8104
  * "off" is the absence of a covering band, never a band value.
8108
8105
  */
8109
8106
  bands: array(RecordingBandSchema).default([]),
8107
+ /**
8108
+ * THE device-decided intent: record for as long as the camera itself raises
8109
+ * `recording-signal` (`active: true` while the device is in function — a
8110
+ * robot that cleans). AUTHORED, unlike `mode`, and the only authored
8111
+ * recording intent that is not a band.
8112
+ *
8113
+ * It carries NO schedule on purpose. A band is an HOUR, and this feature has
8114
+ * no hour to program: the device decides. What it costs the operator is one
8115
+ * flag — "this camera can record on its own" — and what it buys is the same
8116
+ * hold/release the recorder already implements (D371, `holdTrigger` /
8117
+ * `releaseTrigger`): the window opens on the rise, stays open for the whole
8118
+ * job however long it is, and closes one pad after the fall.
8119
+ *
8120
+ * EXCLUSIVE with `bands` (below): two authorities deciding when the same
8121
+ * camera records is the D62 failure. `off` remains `enabled: false`, so an
8122
+ * operator switching this camera off is REPORTED off, never as broken.
8123
+ */
8124
+ deviceDecision: boolean().optional(),
8110
8125
  retention: RecordingRetentionSchema.optional()
8111
- }).strict();
8126
+ }).strict().refine((config) => config.deviceDecision !== true || config.bands.length === 0, {
8127
+ message: "deviceDecision is a whole-config mode and carries no schedule: it cannot be combined with bands",
8128
+ path: ["bands"]
8129
+ });
8112
8130
  /**
8113
8131
  * Entity-relocation job state (storage entity-routing spec, Phase 4).
8114
8132
  *
@@ -21043,11 +21061,7 @@ var CameraAudioStatusSchema = object({
21043
21061
  });
21044
21062
  /** Recording block — null when no recording cap is active for this device. */
21045
21063
  var CameraRecordingStatusSchema = object({
21046
- mode: _enum([
21047
- "off",
21048
- "continuous",
21049
- "events"
21050
- ]),
21064
+ mode: RecordingStorageModeSchema,
21051
21065
  active: boolean(),
21052
21066
  storageBytes: number()
21053
21067
  });
@@ -29449,11 +29463,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
29449
29463
  var RecordingStatusSchema = object({
29450
29464
  deviceId: number(),
29451
29465
  enabled: boolean(),
29452
- activeMode: _enum([
29453
- "off",
29454
- "continuous",
29455
- "events"
29456
- ]),
29466
+ /** THE derived storage mode, from the one definition
29467
+ * (`deriveRecordingMode`) — never a second enum. A duplicated list is how
29468
+ * `on-device-decision` could have reached the recorder and not the status. */
29469
+ activeMode: RecordingStorageModeSchema,
29457
29470
  nodeId: string(),
29458
29471
  storageBytes: number()
29459
29472
  });
package/dist/addon.mjs CHANGED
@@ -7925,17 +7925,29 @@ var HHMM = /^([01]\d|2[0-3]):[0-5]\d$/;
7925
7925
  /**
7926
7926
  * DERIVED per-camera storage summary — the single field cheap consumers read
7927
7927
  * (the viewer's status dot, the camera list) instead of walking `bands`:
7928
- * - `off` — no band covers the camera (or it is disabled).
7929
- * - `events` — every band records around triggers only.
7930
- * - `continuous` — at least one band records continuously.
7931
- *
7932
- * NEVER authored: the recorder stamps it from the authoritative `bands` on
7933
- * every save (`activeModeForConfig`). Writing it has no effect.
7928
+ * - `off` — no band covers the camera (or it is disabled).
7929
+ * - `events` — every band records around triggers only.
7930
+ * - `continuous` — at least one band records continuously.
7931
+ * - `on-device-decision`— the DEVICE decides: recording runs for as long as the
7932
+ * camera raises its own `recording-signal` level (a robot that cleans). There
7933
+ * is no schedule to author, because there is no hour to program — see
7934
+ * {@link RecordingConfigSchema}`.deviceDecision`.
7935
+ *
7936
+ * NEVER authored: the recorder stamps it from the authoritative intent
7937
+ * (`bands` + `deviceDecision`) on every save (`activeModeForConfig`). Writing it
7938
+ * has no effect.
7939
+ *
7940
+ * `on-device-decision` is named for WHO decides, not for how the recording is
7941
+ * requested. `on-demand` was rejected: in this repo's vocabulary a "demand" is
7942
+ * something the operator makes (the live gate is the recorder's own "demand
7943
+ * window"), and a knob whose name suggests the operator starts it while the
7944
+ * device actually does is the D62 shape — a control nobody can predict.
7934
7945
  */
7935
7946
  var RecordingStorageModeSchema = _enum([
7936
7947
  "off",
7937
7948
  "events",
7938
- "continuous"
7949
+ "continuous",
7950
+ "on-device-decision"
7939
7951
  ]);
7940
7952
  /**
7941
7953
  * Le macro classi che possono aprire una finestra di registrazione — le stesse
@@ -7985,22 +7997,7 @@ var RecordingTriggersSchema = object({
7985
7997
  * il livello: un contatto trovato già aperto al riavvio del runner non fa
7986
7998
  * registrare.
7987
7999
  */
7988
- sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional(),
7989
- /**
7990
- * La camera registra per tutta la durata del SEGNALE che lei stessa
7991
- * pubblica — la cap `recording-signal` (`active: true` mentre il device è in
7992
- * funzione: un robot che pulisce). È un LIVELLO, non un fronte: la finestra
7993
- * resta aperta finché il segnale è alto e si chiude `postBufferSec` dopo la
7994
- * caduta, così una pulizia di quaranta minuti è UNA clip.
7995
- *
7996
- * Non nomina un device: il segnale è della camera stessa, tenuto fresco dal
7997
- * suo provider (D224); il recorder lo ascolta su `DeviceStateChanged` e lo
7998
- * riconcilia leggendo la slice via RPC, con un tetto oltre il quale un
7999
- * segnale mai abbassato (un evento perso) non può tenere aperta una
8000
- * registrazione (D11). Vedi `recorder/addon/band-decision.ts`
8001
- * (`holdTrigger` / `releaseTrigger`).
8002
- */
8003
- deviceSignal: boolean().optional()
8000
+ sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
8004
8001
  });
8005
8002
  /**
8006
8003
  * Mode of a single recording band — the recorder per-band vocabulary.
@@ -8084,8 +8081,29 @@ var RecordingConfigSchema = object({
8084
8081
  * "off" is the absence of a covering band, never a band value.
8085
8082
  */
8086
8083
  bands: array(RecordingBandSchema).default([]),
8084
+ /**
8085
+ * THE device-decided intent: record for as long as the camera itself raises
8086
+ * `recording-signal` (`active: true` while the device is in function — a
8087
+ * robot that cleans). AUTHORED, unlike `mode`, and the only authored
8088
+ * recording intent that is not a band.
8089
+ *
8090
+ * It carries NO schedule on purpose. A band is an HOUR, and this feature has
8091
+ * no hour to program: the device decides. What it costs the operator is one
8092
+ * flag — "this camera can record on its own" — and what it buys is the same
8093
+ * hold/release the recorder already implements (D371, `holdTrigger` /
8094
+ * `releaseTrigger`): the window opens on the rise, stays open for the whole
8095
+ * job however long it is, and closes one pad after the fall.
8096
+ *
8097
+ * EXCLUSIVE with `bands` (below): two authorities deciding when the same
8098
+ * camera records is the D62 failure. `off` remains `enabled: false`, so an
8099
+ * operator switching this camera off is REPORTED off, never as broken.
8100
+ */
8101
+ deviceDecision: boolean().optional(),
8087
8102
  retention: RecordingRetentionSchema.optional()
8088
- }).strict();
8103
+ }).strict().refine((config) => config.deviceDecision !== true || config.bands.length === 0, {
8104
+ message: "deviceDecision is a whole-config mode and carries no schedule: it cannot be combined with bands",
8105
+ path: ["bands"]
8106
+ });
8089
8107
  /**
8090
8108
  * Entity-relocation job state (storage entity-routing spec, Phase 4).
8091
8109
  *
@@ -21020,11 +21038,7 @@ var CameraAudioStatusSchema = object({
21020
21038
  });
21021
21039
  /** Recording block — null when no recording cap is active for this device. */
21022
21040
  var CameraRecordingStatusSchema = object({
21023
- mode: _enum([
21024
- "off",
21025
- "continuous",
21026
- "events"
21027
- ]),
21041
+ mode: RecordingStorageModeSchema,
21028
21042
  active: boolean(),
21029
21043
  storageBytes: number()
21030
21044
  });
@@ -29426,11 +29440,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
29426
29440
  var RecordingStatusSchema = object({
29427
29441
  deviceId: number(),
29428
29442
  enabled: boolean(),
29429
- activeMode: _enum([
29430
- "off",
29431
- "continuous",
29432
- "events"
29433
- ]),
29443
+ /** THE derived storage mode, from the one definition
29444
+ * (`deriveRecordingMode`) — never a second enum. A duplicated list is how
29445
+ * `on-device-decision` could have reached the recorder and not the status. */
29446
+ activeMode: RecordingStorageModeSchema,
29434
29447
  nodeId: string(),
29435
29448
  storageBytes: number()
29436
29449
  });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-terminal",
3
- "version": "0.1.79",
3
+ "version": "0.1.81",
4
4
  "description": "Interactive terminal sessions (pty + xterm) as a CamStack addon",
5
5
  "keywords": [
6
6
  "camstack",