@camstack/types 1.2.589 → 1.2.591

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/dist/addon.js +4 -4
  3. package/dist/addon.mjs +4 -4
  4. package/dist/capabilities/battery.cap.d.ts +7 -41
  5. package/dist/capabilities/index.d.ts +6 -2
  6. package/dist/capabilities/low-power-sleep.cap.d.ts +83 -0
  7. package/dist/capabilities/pipeline-executor.cap.d.ts +18 -2
  8. package/dist/capabilities/resync.cap.d.ts +40 -0
  9. package/dist/client.js +9 -4
  10. package/dist/client.mjs +9 -4
  11. package/dist/{composed-stable-id-Kt5VKzGZ.mjs → composed-stable-id-BNTaDZEh.mjs} +9 -8
  12. package/dist/{composed-stable-id-DDv-Og0u.js → composed-stable-id-BdeYe5dD.js} +9 -8
  13. package/dist/device/device-feature-requirements.d.ts +3 -4
  14. package/dist/device/device-profile.d.ts +1 -1
  15. package/dist/device/device-type.d.ts +9 -8
  16. package/dist/device/low-power-sleep.d.ts +19 -0
  17. package/dist/device/resync-through-adoption.d.ts +12 -0
  18. package/dist/enums/event-category.d.ts +1 -1
  19. package/dist/enums.js +1 -1
  20. package/dist/enums.mjs +1 -1
  21. package/dist/{event-category-CE_VCE2G.js → event-category-BKxXXxnV.js} +1 -1
  22. package/dist/{event-category-Hwx_JSCU.mjs → event-category-CY27-fF0.mjs} +1 -1
  23. package/dist/generated/addon-api.d.ts +37 -8
  24. package/dist/generated/addon-cap-facts.d.ts +1 -1
  25. package/dist/generated/cap-status-types.d.ts +3 -1
  26. package/dist/generated/cap-vocabulary.d.ts +1 -1
  27. package/dist/generated/capability-router-map.d.ts +8 -2
  28. package/dist/generated/device-local-state.d.ts +3 -0
  29. package/dist/generated/device-proxy.d.ts +5 -0
  30. package/dist/generated/device-scoped-caps.d.ts +1 -1
  31. package/dist/generated/history-catalog.d.ts +1 -1
  32. package/dist/generated/method-access-map.d.ts +1 -1
  33. package/dist/generated/method-device-selectors.d.ts +1 -1
  34. package/dist/generated/runtime-state-durability.d.ts +1 -1
  35. package/dist/{implemented-methods-CbdShcW1.js → implemented-methods-BarLh7tc.js} +1 -1
  36. package/dist/{implemented-methods-BiV3Y-40.mjs → implemented-methods-k3KProJd.mjs} +1 -1
  37. package/dist/index.d.ts +2 -0
  38. package/dist/index.js +273 -67
  39. package/dist/index.mjs +266 -68
  40. package/dist/interfaces/event-bus.d.ts +1 -1
  41. package/dist/interfaces/pipeline-executor-capability.d.ts +7 -0
  42. package/dist/node.js +2 -2
  43. package/dist/node.mjs +2 -2
  44. package/dist/pipeline/second-pass/small-subject-recovery.d.ts +4 -8
  45. package/dist/{sleep-CICYFVJf.js → sleep-BA_SIc0O.js} +47 -9
  46. package/dist/{sleep-CFN40XWx.mjs → sleep-BT1bLgPq.mjs} +47 -9
  47. package/dist/types/pipeline-step.d.ts +35 -1
  48. package/package.json +1 -1
@@ -1453,7 +1453,7 @@ export interface EventCatalog {
1453
1453
  };
1454
1454
  };
1455
1455
  /**
1456
- * Emitted by the battery cap provider when `wakeForStream` enters the
1456
+ * Emitted by the battery cap provider when `wakeUp` enters the
1457
1457
  * wake-in-progress window. Subscribers (stream-broker manager) flip
1458
1458
  * the broker's placeholder reason to `'waking'` so encoded-path
1459
1459
  * viewers see a labelled tile instead of the generic reconnecting
@@ -1,5 +1,6 @@
1
1
  import type { PipelineEngineChoice } from '../types/pipeline.js';
2
2
  import type { PipelineExecutionPlane } from '../types/pipeline-step.js';
3
+ import type { NormalizedRect } from '../pipeline/second-pass/small-subject-recovery.js';
3
4
  import type { PipelineSchema } from '../types/pipeline-schema.js';
4
5
  import type { ModelFormat } from '../types/models.js';
5
6
  import type { FrameInput } from '../types/io.js';
@@ -102,6 +103,12 @@ export interface PipelineRunInput {
102
103
  * the camera's live trace stream. Absent ⇒ unchanged behaviour.
103
104
  */
104
105
  readonly replay?: true;
106
+ /**
107
+ * The motion analyzer's fresh merged subjects (D394), normalised to the
108
+ * frame; feeds the motion-guided root crop (D1060). See
109
+ * `pipelineExecutor.runPipeline.motionRegions`. Absent ⇒ full frame.
110
+ */
111
+ readonly motionRegions?: readonly NormalizedRect[];
105
112
  }
106
113
  /**
107
114
  * Singleton capability provided by the pipeline-executor addon.
package/dist/node.js CHANGED
@@ -21,8 +21,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
21
21
  enumerable: true
22
22
  }) : target, mod));
23
23
  //#endregion
24
- const require_composed_stable_id = require("./composed-stable-id-DDv-Og0u.js");
25
- const require_implemented_methods = require("./implemented-methods-CbdShcW1.js");
24
+ const require_composed_stable_id = require("./composed-stable-id-BdeYe5dD.js");
25
+ const require_implemented_methods = require("./implemented-methods-BarLh7tc.js");
26
26
  let node_crypto = require("node:crypto");
27
27
  let node_fs = require("node:fs");
28
28
  node_fs = __toESM(node_fs);
package/dist/node.mjs CHANGED
@@ -1,5 +1,5 @@
1
- import { s as errMsg } from "./composed-stable-id-Kt5VKzGZ.mjs";
2
- import { a as CUSTOMIZATION_BLOCK_NAME_PREFIX, ar as getFfmpegDownloadUrl, er as FFMPEG_PATH_ENV, fr as buildFfmpegArgs, gr as isSoftwareDecode, ir as getFfmpegArtifact, nr as ffmpegBinaryName, or as canonicalHash, rr as FFMPEG_RELEASE, sr as Fmp4BoxSplitter, t as implementedMethodsOf, tr as chooseFfmpegBinary, z as compositionSourceKey } from "./implemented-methods-BiV3Y-40.mjs";
1
+ import { s as errMsg } from "./composed-stable-id-BNTaDZEh.mjs";
2
+ import { a as CUSTOMIZATION_BLOCK_NAME_PREFIX, ar as getFfmpegDownloadUrl, er as FFMPEG_PATH_ENV, fr as buildFfmpegArgs, gr as isSoftwareDecode, ir as getFfmpegArtifact, nr as ffmpegBinaryName, or as canonicalHash, rr as FFMPEG_RELEASE, sr as Fmp4BoxSplitter, t as implementedMethodsOf, tr as chooseFfmpegBinary, z as compositionSourceKey } from "./implemented-methods-k3KProJd.mjs";
3
3
  import { createHash, createHmac, randomUUID, timingSafeEqual } from "node:crypto";
4
4
  import * as fs from "node:fs";
5
5
  import { chmodSync, copyFileSync, createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
@@ -59,17 +59,13 @@
59
59
  * offline accuracy evaluation (`addon-benchmark`) plan the SAME crops: one
60
60
  * module, two callers, no copy to drift.
61
61
  */
62
+ import type { z } from 'zod';
63
+ import type { NormalizedRectSchema, PipelineStepInputOutput } from '../../capabilities/pipeline-executor.cap.js';
62
64
  import type { ObjectDetection } from '../../types/detection.js';
63
- import type { PipelineStepInputOutput } from '../../capabilities/pipeline-executor.cap.js';
64
65
  /** The object-detection step id — the first-level detector both recipes run. */
65
66
  export declare const OBJECT_DETECTION_STEP_ID = "object-detection";
66
- /** Fraction of a frame, `[0, 1]` on both axes. */
67
- export interface NormalizedRect {
68
- readonly x: number;
69
- readonly y: number;
70
- readonly w: number;
71
- readonly h: number;
72
- }
67
+ /** Fraction of a frame, `[0, 1]` on both axes. Derived from its wire schema. */
68
+ export type NormalizedRect = z.infer<typeof NormalizedRectSchema>;
73
69
  export interface FrameDims {
74
70
  readonly width: number;
75
71
  readonly height: number;
@@ -1,5 +1,5 @@
1
- const require_event_category = require("./event-category-CE_VCE2G.js");
2
- const require_composed_stable_id = require("./composed-stable-id-DDv-Og0u.js");
1
+ const require_event_category = require("./event-category-BKxXXxnV.js");
2
+ const require_composed_stable_id = require("./composed-stable-id-BdeYe5dD.js");
3
3
  let zod = require("zod");
4
4
  //#region src/audio/audio-chunk-format.ts
5
5
  /**
@@ -7985,7 +7985,7 @@ var MODEL_FORMATS = [
7985
7985
  //#region src/generated/cap-vocabulary.ts
7986
7986
  /**
7987
7987
  * THE cap vocabulary (D920), projected from the declarations of every
7988
- * `*.cap.ts` (D1050): 211 caps (109 device, 102 system).
7988
+ * `*.cap.ts` (D1050): 213 caps (111 device, 102 system).
7989
7989
  * Device caps in their declared picker order, then system caps by name.
7990
7990
  */
7991
7991
  var CAP_VOCABULARY = {
@@ -14669,6 +14669,14 @@ var CAP_VOCABULARY = {
14669
14669
  icon: "refresh-cw"
14670
14670
  }]
14671
14671
  },
14672
+ "resync": {
14673
+ scope: "device",
14674
+ noun: {
14675
+ en: "Re-sync",
14676
+ it: "Risincronizzazione"
14677
+ },
14678
+ notOperatorFacing: { resync: "device adoption — re-aligning a device with its source is an onboarding step, not an automation action" }
14679
+ },
14672
14680
  "recording": {
14673
14681
  scope: "device",
14674
14682
  noun: {
@@ -16680,7 +16688,6 @@ var CAP_VOCABULARY = {
16680
16688
  en: "Battery",
16681
16689
  it: "Batteria"
16682
16690
  },
16683
- notOperatorFacing: { wakeForStream: "a stream consumer wakes a sleeping camera to watch it; an automation that wants footage asks for the footage" },
16684
16691
  state: [
16685
16692
  {
16686
16693
  kind: "numeric",
@@ -16790,6 +16797,14 @@ var CAP_VOCABULARY = {
16790
16797
  icon: "moon"
16791
16798
  }]
16792
16799
  },
16800
+ "low-power-sleep": {
16801
+ scope: "device",
16802
+ noun: {
16803
+ en: "Low-power sleep",
16804
+ it: "Sospensione a basso consumo"
16805
+ },
16806
+ notOperatorFacing: { wakeUp: "a stream consumer wakes a sleeping camera to watch it; an automation that wants footage asks for the footage" }
16807
+ },
16793
16808
  "network-link": {
16794
16809
  scope: "device",
16795
16810
  noun: {
@@ -18176,6 +18191,7 @@ var CAP_NAMES = Object.freeze([
18176
18191
  "log-channels",
18177
18192
  "log-destination",
18178
18193
  "login-method",
18194
+ "low-power-sleep",
18179
18195
  "media-player",
18180
18196
  "mesh-network",
18181
18197
  "meter",
@@ -18229,6 +18245,7 @@ var CAP_NAMES = Object.freeze([
18229
18245
  "records",
18230
18246
  "remote",
18231
18247
  "remote-layout-components",
18248
+ "resync",
18232
18249
  "running-state",
18233
18250
  "scene-monitor",
18234
18251
  "schedulers",
@@ -19405,6 +19422,20 @@ var CAP_STATE_LEAVES = Object.freeze({
19405
19422
  "path": "codeRequired",
19406
19423
  "valueType": "boolean"
19407
19424
  }],
19425
+ "low-power-sleep": [
19426
+ {
19427
+ "path": "sleeping",
19428
+ "valueType": "boolean"
19429
+ },
19430
+ {
19431
+ "path": "lastContactAt",
19432
+ "valueType": "number"
19433
+ },
19434
+ {
19435
+ "path": "lastUpdated",
19436
+ "valueType": "number"
19437
+ }
19438
+ ],
19408
19439
  "media-player": [
19409
19440
  {
19410
19441
  "path": "state",
@@ -21054,10 +21085,7 @@ function createDeviceProxy(api, binding, opts) {
21054
21085
  trigger: (input, options) => dispatch("automation-control", "automationControl", "trigger", "mutation", input, void 0, options),
21055
21086
  getStatus: (input, options) => dispatch("automation-control", "automationControl", "getStatus", "query", input, void 0, options)
21056
21087
  };
21057
- const batteryInterface = {
21058
- wakeForStream: (input, options) => dispatch("battery", "battery", "wakeForStream", "mutation", input, void 0, options),
21059
- getStatus: (input, options) => dispatch("battery", "battery", "getStatus", "query", input, void 0, options)
21060
- };
21088
+ const batteryInterface = { getStatus: (input, options) => dispatch("battery", "battery", "getStatus", "query", input, void 0, options) };
21061
21089
  const binaryInterface = { getStatus: (input, options) => dispatch("binary", "binary", "getStatus", "query", input, void 0, options) };
21062
21090
  const brightnessInterface = {
21063
21091
  setBrightness: (input, options) => dispatch("brightness", "brightness", "setBrightness", "mutation", input, void 0, options),
@@ -21261,6 +21289,10 @@ function createDeviceProxy(api, binding, opts) {
21261
21289
  open: (input, options) => dispatch("lock-control", "lockControl", "open", "mutation", input, void 0, options),
21262
21290
  getStatus: (input, options) => dispatch("lock-control", "lockControl", "getStatus", "query", input, void 0, options)
21263
21291
  };
21292
+ const lowPowerSleepInterface = {
21293
+ wakeUp: (input, options) => dispatch("low-power-sleep", "lowPowerSleep", "wakeUp", "mutation", input, void 0, options),
21294
+ getStatus: (input, options) => dispatch("low-power-sleep", "lowPowerSleep", "getStatus", "query", input, void 0, options)
21295
+ };
21264
21296
  const mediaPlayerInterface = {
21265
21297
  turnOn: (input, options) => dispatch("media-player", "mediaPlayer", "turnOn", "mutation", input, void 0, options),
21266
21298
  turnOff: (input, options) => dispatch("media-player", "mediaPlayer", "turnOff", "mutation", input, void 0, options),
@@ -21502,6 +21534,7 @@ function createDeviceProxy(api, binding, opts) {
21502
21534
  getStatus: (input, options) => dispatch("recording-onboard", "recordingOnboard", "getStatus", "query", input, void 0, options)
21503
21535
  };
21504
21536
  const recordingSignalInterface = { getStatus: (input, options) => dispatch("recording-signal", "recordingSignal", "getStatus", "query", input, void 0, options) };
21537
+ const resyncInterface = { resync: (input, options) => dispatch("resync", "resync", "resync", "mutation", input, void 0, options) };
21505
21538
  const runningStateInterface = { getStatus: (input, options) => dispatch("running-state", "runningState", "getStatus", "query", input, void 0, options) };
21506
21539
  const sceneMonitorInterface = {
21507
21540
  listScenes: (input, options) => dispatch("scene-monitor", "sceneMonitor", "listScenes", "query", input, void 0, options),
@@ -21859,6 +21892,7 @@ function createDeviceProxy(api, binding, opts) {
21859
21892
  irTransmitter: createSliceHandle(stateSource, binding.deviceId, "ir-transmitter"),
21860
21893
  lawnMowerControl: createSliceHandle(stateSource, binding.deviceId, "lawn-mower-control"),
21861
21894
  lockControl: createSliceHandle(stateSource, binding.deviceId, "lock-control"),
21895
+ lowPowerSleep: createSliceHandle(stateSource, binding.deviceId, "low-power-sleep"),
21862
21896
  mediaPlayer: createSliceHandle(stateSource, binding.deviceId, "media-player"),
21863
21897
  meter: createSliceHandle(stateSource, binding.deviceId, "meter"),
21864
21898
  motion: createSliceHandle(stateSource, binding.deviceId, "motion"),
@@ -21960,6 +21994,7 @@ function createDeviceProxy(api, binding, opts) {
21960
21994
  ...bound("ir-transmitter") ? { irTransmitter: irTransmitterInterface } : {},
21961
21995
  ...bound("lawn-mower-control") ? { lawnMowerControl: lawnMowerControlInterface } : {},
21962
21996
  ...bound("lock-control") ? { lockControl: lockControlInterface } : {},
21997
+ ...bound("low-power-sleep") ? { lowPowerSleep: lowPowerSleepInterface } : {},
21963
21998
  ...bound("media-player") ? { mediaPlayer: mediaPlayerInterface } : {},
21964
21999
  ...bound("meter") ? { meter: meterInterface } : {},
21965
22000
  ...bound("motion") ? { motion: motionInterface } : {},
@@ -21987,6 +22022,7 @@ function createDeviceProxy(api, binding, opts) {
21987
22022
  ...bound("recording") ? { recording: recordingInterface } : {},
21988
22023
  ...bound("recording-onboard") ? { recordingOnboard: recordingOnboardInterface } : {},
21989
22024
  ...bound("recording-signal") ? { recordingSignal: recordingSignalInterface } : {},
22025
+ ...bound("resync") ? { resync: resyncInterface } : {},
21990
22026
  ...bound("running-state") ? { runningState: runningStateInterface } : {},
21991
22027
  ...bound("scene-monitor") ? { sceneMonitor: sceneMonitorInterface } : {},
21992
22028
  ...bound("script-runner") ? { scriptRunner: scriptRunnerInterface } : {},
@@ -22044,7 +22080,7 @@ function createDeviceProxy(api, binding, opts) {
22044
22080
  * can answer "may a rule actuate this?" without importing the schema barrel
22045
22081
  * (~144MB RSS per runner, D28).
22046
22082
  *
22047
- * Coverage: 109 device-scoped capabilities.
22083
+ * Coverage: 111 device-scoped capabilities.
22048
22084
  */
22049
22085
  var DEVICE_SCOPED_CAPS = new Set([
22050
22086
  "accessories",
@@ -22103,6 +22139,7 @@ var DEVICE_SCOPED_CAPS = new Set([
22103
22139
  "ir-transmitter",
22104
22140
  "lawn-mower-control",
22105
22141
  "lock-control",
22142
+ "low-power-sleep",
22106
22143
  "media-player",
22107
22144
  "meter",
22108
22145
  "motion",
@@ -22130,6 +22167,7 @@ var DEVICE_SCOPED_CAPS = new Set([
22130
22167
  "recording",
22131
22168
  "recording-onboard",
22132
22169
  "recording-signal",
22170
+ "resync",
22133
22171
  "running-state",
22134
22172
  "scene-monitor",
22135
22173
  "script-runner",
@@ -1,5 +1,5 @@
1
- import { t as EventCategory } from "./event-category-Hwx_JSCU.mjs";
2
- import { a as DeviceType, i as DeviceRole, s as errMsg } from "./composed-stable-id-Kt5VKzGZ.mjs";
1
+ import { t as EventCategory } from "./event-category-CY27-fF0.mjs";
2
+ import { a as DeviceType, i as DeviceRole, s as errMsg } from "./composed-stable-id-BNTaDZEh.mjs";
3
3
  import { z } from "zod";
4
4
  //#region src/audio/audio-chunk-format.ts
5
5
  /**
@@ -7985,7 +7985,7 @@ var MODEL_FORMATS = [
7985
7985
  //#region src/generated/cap-vocabulary.ts
7986
7986
  /**
7987
7987
  * THE cap vocabulary (D920), projected from the declarations of every
7988
- * `*.cap.ts` (D1050): 211 caps (109 device, 102 system).
7988
+ * `*.cap.ts` (D1050): 213 caps (111 device, 102 system).
7989
7989
  * Device caps in their declared picker order, then system caps by name.
7990
7990
  */
7991
7991
  var CAP_VOCABULARY = {
@@ -14669,6 +14669,14 @@ var CAP_VOCABULARY = {
14669
14669
  icon: "refresh-cw"
14670
14670
  }]
14671
14671
  },
14672
+ "resync": {
14673
+ scope: "device",
14674
+ noun: {
14675
+ en: "Re-sync",
14676
+ it: "Risincronizzazione"
14677
+ },
14678
+ notOperatorFacing: { resync: "device adoption — re-aligning a device with its source is an onboarding step, not an automation action" }
14679
+ },
14672
14680
  "recording": {
14673
14681
  scope: "device",
14674
14682
  noun: {
@@ -16680,7 +16688,6 @@ var CAP_VOCABULARY = {
16680
16688
  en: "Battery",
16681
16689
  it: "Batteria"
16682
16690
  },
16683
- notOperatorFacing: { wakeForStream: "a stream consumer wakes a sleeping camera to watch it; an automation that wants footage asks for the footage" },
16684
16691
  state: [
16685
16692
  {
16686
16693
  kind: "numeric",
@@ -16790,6 +16797,14 @@ var CAP_VOCABULARY = {
16790
16797
  icon: "moon"
16791
16798
  }]
16792
16799
  },
16800
+ "low-power-sleep": {
16801
+ scope: "device",
16802
+ noun: {
16803
+ en: "Low-power sleep",
16804
+ it: "Sospensione a basso consumo"
16805
+ },
16806
+ notOperatorFacing: { wakeUp: "a stream consumer wakes a sleeping camera to watch it; an automation that wants footage asks for the footage" }
16807
+ },
16793
16808
  "network-link": {
16794
16809
  scope: "device",
16795
16810
  noun: {
@@ -18176,6 +18191,7 @@ var CAP_NAMES = Object.freeze([
18176
18191
  "log-channels",
18177
18192
  "log-destination",
18178
18193
  "login-method",
18194
+ "low-power-sleep",
18179
18195
  "media-player",
18180
18196
  "mesh-network",
18181
18197
  "meter",
@@ -18229,6 +18245,7 @@ var CAP_NAMES = Object.freeze([
18229
18245
  "records",
18230
18246
  "remote",
18231
18247
  "remote-layout-components",
18248
+ "resync",
18232
18249
  "running-state",
18233
18250
  "scene-monitor",
18234
18251
  "schedulers",
@@ -19405,6 +19422,20 @@ var CAP_STATE_LEAVES = Object.freeze({
19405
19422
  "path": "codeRequired",
19406
19423
  "valueType": "boolean"
19407
19424
  }],
19425
+ "low-power-sleep": [
19426
+ {
19427
+ "path": "sleeping",
19428
+ "valueType": "boolean"
19429
+ },
19430
+ {
19431
+ "path": "lastContactAt",
19432
+ "valueType": "number"
19433
+ },
19434
+ {
19435
+ "path": "lastUpdated",
19436
+ "valueType": "number"
19437
+ }
19438
+ ],
19408
19439
  "media-player": [
19409
19440
  {
19410
19441
  "path": "state",
@@ -21054,10 +21085,7 @@ function createDeviceProxy(api, binding, opts) {
21054
21085
  trigger: (input, options) => dispatch("automation-control", "automationControl", "trigger", "mutation", input, void 0, options),
21055
21086
  getStatus: (input, options) => dispatch("automation-control", "automationControl", "getStatus", "query", input, void 0, options)
21056
21087
  };
21057
- const batteryInterface = {
21058
- wakeForStream: (input, options) => dispatch("battery", "battery", "wakeForStream", "mutation", input, void 0, options),
21059
- getStatus: (input, options) => dispatch("battery", "battery", "getStatus", "query", input, void 0, options)
21060
- };
21088
+ const batteryInterface = { getStatus: (input, options) => dispatch("battery", "battery", "getStatus", "query", input, void 0, options) };
21061
21089
  const binaryInterface = { getStatus: (input, options) => dispatch("binary", "binary", "getStatus", "query", input, void 0, options) };
21062
21090
  const brightnessInterface = {
21063
21091
  setBrightness: (input, options) => dispatch("brightness", "brightness", "setBrightness", "mutation", input, void 0, options),
@@ -21261,6 +21289,10 @@ function createDeviceProxy(api, binding, opts) {
21261
21289
  open: (input, options) => dispatch("lock-control", "lockControl", "open", "mutation", input, void 0, options),
21262
21290
  getStatus: (input, options) => dispatch("lock-control", "lockControl", "getStatus", "query", input, void 0, options)
21263
21291
  };
21292
+ const lowPowerSleepInterface = {
21293
+ wakeUp: (input, options) => dispatch("low-power-sleep", "lowPowerSleep", "wakeUp", "mutation", input, void 0, options),
21294
+ getStatus: (input, options) => dispatch("low-power-sleep", "lowPowerSleep", "getStatus", "query", input, void 0, options)
21295
+ };
21264
21296
  const mediaPlayerInterface = {
21265
21297
  turnOn: (input, options) => dispatch("media-player", "mediaPlayer", "turnOn", "mutation", input, void 0, options),
21266
21298
  turnOff: (input, options) => dispatch("media-player", "mediaPlayer", "turnOff", "mutation", input, void 0, options),
@@ -21502,6 +21534,7 @@ function createDeviceProxy(api, binding, opts) {
21502
21534
  getStatus: (input, options) => dispatch("recording-onboard", "recordingOnboard", "getStatus", "query", input, void 0, options)
21503
21535
  };
21504
21536
  const recordingSignalInterface = { getStatus: (input, options) => dispatch("recording-signal", "recordingSignal", "getStatus", "query", input, void 0, options) };
21537
+ const resyncInterface = { resync: (input, options) => dispatch("resync", "resync", "resync", "mutation", input, void 0, options) };
21505
21538
  const runningStateInterface = { getStatus: (input, options) => dispatch("running-state", "runningState", "getStatus", "query", input, void 0, options) };
21506
21539
  const sceneMonitorInterface = {
21507
21540
  listScenes: (input, options) => dispatch("scene-monitor", "sceneMonitor", "listScenes", "query", input, void 0, options),
@@ -21859,6 +21892,7 @@ function createDeviceProxy(api, binding, opts) {
21859
21892
  irTransmitter: createSliceHandle(stateSource, binding.deviceId, "ir-transmitter"),
21860
21893
  lawnMowerControl: createSliceHandle(stateSource, binding.deviceId, "lawn-mower-control"),
21861
21894
  lockControl: createSliceHandle(stateSource, binding.deviceId, "lock-control"),
21895
+ lowPowerSleep: createSliceHandle(stateSource, binding.deviceId, "low-power-sleep"),
21862
21896
  mediaPlayer: createSliceHandle(stateSource, binding.deviceId, "media-player"),
21863
21897
  meter: createSliceHandle(stateSource, binding.deviceId, "meter"),
21864
21898
  motion: createSliceHandle(stateSource, binding.deviceId, "motion"),
@@ -21960,6 +21994,7 @@ function createDeviceProxy(api, binding, opts) {
21960
21994
  ...bound("ir-transmitter") ? { irTransmitter: irTransmitterInterface } : {},
21961
21995
  ...bound("lawn-mower-control") ? { lawnMowerControl: lawnMowerControlInterface } : {},
21962
21996
  ...bound("lock-control") ? { lockControl: lockControlInterface } : {},
21997
+ ...bound("low-power-sleep") ? { lowPowerSleep: lowPowerSleepInterface } : {},
21963
21998
  ...bound("media-player") ? { mediaPlayer: mediaPlayerInterface } : {},
21964
21999
  ...bound("meter") ? { meter: meterInterface } : {},
21965
22000
  ...bound("motion") ? { motion: motionInterface } : {},
@@ -21987,6 +22022,7 @@ function createDeviceProxy(api, binding, opts) {
21987
22022
  ...bound("recording") ? { recording: recordingInterface } : {},
21988
22023
  ...bound("recording-onboard") ? { recordingOnboard: recordingOnboardInterface } : {},
21989
22024
  ...bound("recording-signal") ? { recordingSignal: recordingSignalInterface } : {},
22025
+ ...bound("resync") ? { resync: resyncInterface } : {},
21990
22026
  ...bound("running-state") ? { runningState: runningStateInterface } : {},
21991
22027
  ...bound("scene-monitor") ? { sceneMonitor: sceneMonitorInterface } : {},
21992
22028
  ...bound("script-runner") ? { scriptRunner: scriptRunnerInterface } : {},
@@ -22044,7 +22080,7 @@ function createDeviceProxy(api, binding, opts) {
22044
22080
  * can answer "may a rule actuate this?" without importing the schema barrel
22045
22081
  * (~144MB RSS per runner, D28).
22046
22082
  *
22047
- * Coverage: 109 device-scoped capabilities.
22083
+ * Coverage: 111 device-scoped capabilities.
22048
22084
  */
22049
22085
  var DEVICE_SCOPED_CAPS = new Set([
22050
22086
  "accessories",
@@ -22103,6 +22139,7 @@ var DEVICE_SCOPED_CAPS = new Set([
22103
22139
  "ir-transmitter",
22104
22140
  "lawn-mower-control",
22105
22141
  "lock-control",
22142
+ "low-power-sleep",
22106
22143
  "media-player",
22107
22144
  "meter",
22108
22145
  "motion",
@@ -22130,6 +22167,7 @@ var DEVICE_SCOPED_CAPS = new Set([
22130
22167
  "recording",
22131
22168
  "recording-onboard",
22132
22169
  "recording-signal",
22170
+ "resync",
22133
22171
  "running-state",
22134
22172
  "scene-monitor",
22135
22173
  "script-runner",
@@ -1,9 +1,10 @@
1
+ import type { SuppliedRootOutput } from '../capabilities/pipeline-executor.cap.js';
1
2
  import type { ConfigField } from '../interfaces/config-ui.js';
2
3
  import type { StepModelScope } from '../pipeline/cluster-model-scope.js';
4
+ import type { FrameViewCrop } from './frame-view.js';
3
5
  import type { ClassMapDefinition } from './labels.js';
4
6
  import type { ModelCatalogEntry } from './models.js';
5
7
  import type { PipelineSlot } from './pipeline.js';
6
- import type { SuppliedRootOutput } from '../capabilities/pipeline-executor.cap.js';
7
8
  /**
8
9
  * Each pipeline step implements this interface as a class.
9
10
  * `definition` holds the static metadata; `getConfigSchema()` declares
@@ -361,6 +362,37 @@ export interface PipelineRunOptions {
361
362
  * `pipelineExecutor.runPipeline.suppliedRoot`): that step is not inferred.
362
363
  */
363
364
  readonly suppliedRoot?: SuppliedRootOutput;
365
+ /**
366
+ * Motion-guided root crop (D1060): which pixels the object-detection root
367
+ * runs on for THIS frame. `roi` carries the frame-space crop; `full` keeps
368
+ * the full frame. Never applies to a `crop-zone` root, whose package-zone
369
+ * crop always wins. Absent ⇒ full frame.
370
+ */
371
+ readonly rootInputSource?: RootInputSource;
372
+ }
373
+ /** Why the object-detection root ran on the pixels it ran on (D1060). */
374
+ export type RootInputSourceReason =
375
+ /** A crop around the motion subjects and the recent root boxes. */
376
+ 'motion'
377
+ /** Neither motion nor a recent root box: nothing to crop around. */
378
+ | 'no-motion'
379
+ /** The crop would exceed the ceiling fraction of the frame — too little magnification. */
380
+ | 'roi-too-large'
381
+ /** A recent root box would exceed the model's subject-scale bound once cropped: the crop would magnify it into the scale the model fails at. */
382
+ | 'subject-too-large'
383
+ /** The previous crop found nothing where the root had recent boxes; this frame checks on the full frame. */
384
+ | 'roi-missed'
385
+ /** The per-camera periodic full frame. */
386
+ | 'forced-full'
387
+ /** Frame or model geometry unknown. */
388
+ | 'no-geometry';
389
+ /** The root input source decided for one frame (D1060). Rides the `pipeline.trace` event. */
390
+ export interface RootInputSource {
391
+ readonly stepId: string;
392
+ readonly source: 'roi' | 'full';
393
+ readonly reason: RootInputSourceReason;
394
+ /** Frame-space pixel crop, present iff `source === 'roi'`. */
395
+ readonly crop?: FrameViewCrop;
364
396
  }
365
397
  export interface StepTrace {
366
398
  readonly stepId: string;
@@ -396,6 +428,8 @@ export interface PipelineExecutionTrace {
396
428
  readonly steps: readonly StepTrace[];
397
429
  readonly totalMs: number;
398
430
  readonly detectionCount: number;
431
+ /** Which pixels the object-detection root ran on for this frame (D1060). */
432
+ readonly rootSource?: RootInputSource;
399
433
  readonly [key: string]: unknown;
400
434
  }
401
435
  export interface MotionBox {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/types",
3
- "version": "1.2.589",
3
+ "version": "1.2.591",
4
4
  "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
5
5
  "keywords": [
6
6
  "camstack",