@camstack/addon-pipeline 1.2.0 → 1.2.2

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 (34) hide show
  1. package/dist/audio-analyzer/index.js +1 -1
  2. package/dist/audio-analyzer/index.mjs +1 -1
  3. package/dist/detection-pipeline/index.js +2 -2
  4. package/dist/detection-pipeline/index.mjs +2 -2
  5. package/dist/{dist-DWy-H6bo.js → dist-CVjqvU8G.js} +95 -13
  6. package/dist/{dist-DLWXeXC1.mjs → dist-ClyAFBZk.mjs} +95 -13
  7. package/dist/motion-wasm/index.js +1 -1
  8. package/dist/motion-wasm/index.mjs +1 -1
  9. package/dist/pipeline-runner/index.js +228 -24
  10. package/dist/pipeline-runner/index.mjs +228 -24
  11. package/dist/recorder/index.js +1 -1
  12. package/dist/recorder/index.mjs +1 -1
  13. package/dist/session-decode/decode-worker-child.js +55 -7
  14. package/dist/session-decode/decode-worker-child.mjs +55 -7
  15. package/dist/{step-definitions-BQG_6dmZ.js → step-definitions-D76MMwbo.js} +1 -1
  16. package/dist/{step-definitions-CVk19Y0u.mjs → step-definitions-DMOw4fzn.mjs} +1 -1
  17. package/dist/stream-broker/_stub.js +1 -1
  18. package/dist/stream-broker/{_virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-CpB1jG0N.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-7jRy3Uzr.mjs} +3 -3
  19. package/dist/stream-broker/_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-CQC_f4Yv.mjs +26 -0
  20. package/dist/stream-broker/{hostInit--Zair8Av.mjs → hostInit-4pxims1d.mjs} +3 -3
  21. package/dist/stream-broker/index.js +1 -1
  22. package/dist/stream-broker/index.mjs +1 -1
  23. package/dist/stream-broker/remoteEntry.js +1 -1
  24. package/dist/{worker-protocol-CyVJTZEO.mjs → worker-protocol-D7RzZIla.mjs} +16 -2
  25. package/dist/{worker-protocol-PP4jKHHJ.js → worker-protocol-DextwlTX.js} +21 -1
  26. package/embed-dist/assets/{MaskShapeCanvas-DI4BY7W2-sOOxiGvP.js → MaskShapeCanvas-DI4BY7W2-BPRZW9TX.js} +1 -1
  27. package/embed-dist/assets/{MotionZonesSettings-NcxxQN8r-DdTQuT23.js → MotionZonesSettings-NcxxQN8r-Bw6Nlg-Q.js} +1 -1
  28. package/embed-dist/assets/{PrivacyMaskSettings-APgPLF7p-BrR0L3ql.js → PrivacyMaskSettings-APgPLF7p-BLF9QKG8.js} +1 -1
  29. package/embed-dist/assets/{index-Dk21l1_3.js → index-DiUhKfSk.js} +13 -13
  30. package/embed-dist/assets/index-Dv5H-32C.css +2 -0
  31. package/embed-dist/index.html +2 -2
  32. package/package.json +1 -1
  33. package/dist/stream-broker/_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-BflyNuZv.mjs +0 -26
  34. package/embed-dist/assets/index-D4MGuECB.css +0 -2
@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
5
  const require_chunk = require("../chunk-D6vf50IK.js");
6
- const require_dist = require("../dist-DWy-H6bo.js");
6
+ const require_dist = require("../dist-CVjqvU8G.js");
7
7
  const require_node_topology_platform = require("../node-topology-platform-CFZ7F4xW.js");
8
8
  const require_model_download_service_Cp9f4dk6 = require("../model-download-service-Cp9f4dk6-Dv-oFwjN.js");
9
9
  let node_fs = require("node:fs");
@@ -1,5 +1,5 @@
1
1
  import { t as __require } from "../chunk-BdkLduGY.mjs";
2
- import { D as mapAudioLabelToMacro, H as errMsg, J as hydrateSchema, U as BaseAddon, _ as audioAnalysisCapability, d as HF_BASE_URL, n as AUDIO_BACKEND_CHOICES, o as DEFAULT_AUDIO_ANALYZER_CONFIG, v as audioAnalyzerCapability } from "../dist-DLWXeXC1.mjs";
2
+ import { D as mapAudioLabelToMacro, H as errMsg, J as hydrateSchema, U as BaseAddon, _ as audioAnalysisCapability, d as HF_BASE_URL, n as AUDIO_BACKEND_CHOICES, o as DEFAULT_AUDIO_ANALYZER_CONFIG, v as audioAnalyzerCapability } from "../dist-ClyAFBZk.mjs";
3
3
  import { t as pickNodePlatformArch } from "../node-topology-platform-BkR_k6WT.mjs";
4
4
  import { i as downloadFile } from "../model-download-service-Cp9f4dk6-CwUb5v3Y.mjs";
5
5
  import * as fs from "node:fs";
@@ -3,8 +3,8 @@ Object.defineProperties(exports, {
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
5
  const require_chunk = require("../chunk-D6vf50IK.js");
6
- const require_dist = require("../dist-DWy-H6bo.js");
7
- const require_step_definitions = require("../step-definitions-BQG_6dmZ.js");
6
+ const require_dist = require("../dist-CVjqvU8G.js");
7
+ const require_step_definitions = require("../step-definitions-D76MMwbo.js");
8
8
  const require_node_topology_platform = require("../node-topology-platform-CFZ7F4xW.js");
9
9
  const require_model_download_service_Cp9f4dk6 = require("../model-download-service-Cp9f4dk6-Dv-oFwjN.js");
10
10
  let node_child_process = require("node:child_process");
@@ -1,6 +1,6 @@
1
1
  import { t as __require } from "../chunk-BdkLduGY.mjs";
2
- import { B as supportedRuntimes$1, C as detectionPipelineCapability, H as errMsg, J as hydrateSchema, L as runtimeDevices$1, M as pipelineExecutorCapability, Q as parseJsonUnknown, T as evaluateZoneRules, U as BaseAddon, dt as string, ft as union, h as YAMNET_TO_MACRO, j as nodePin, lt as object, pt as EventCategory, q as createEvent, rt as array, s as DEVICE_BACKEND_TO_FORMAT, t as APPLE_SA_TO_MACRO, tt as sleep, w as enumerateInferenceDevices, x as defaultDeviceFor$1 } from "../dist-DLWXeXC1.mjs";
3
- import { a as getStepDefinition, i as getStep, n as ALL_STEPS, o as resolveModelForFormat, r as getDefaultModelForFormat, t as ALL_PIPELINE_STEPS } from "../step-definitions-CVk19Y0u.mjs";
2
+ import { B as supportedRuntimes$1, C as detectionPipelineCapability, H as errMsg, J as hydrateSchema, L as runtimeDevices$1, M as pipelineExecutorCapability, Q as parseJsonUnknown, T as evaluateZoneRules, U as BaseAddon, dt as string, ft as union, h as YAMNET_TO_MACRO, j as nodePin, lt as object, pt as EventCategory, q as createEvent, rt as array, s as DEVICE_BACKEND_TO_FORMAT, t as APPLE_SA_TO_MACRO, tt as sleep, w as enumerateInferenceDevices, x as defaultDeviceFor$1 } from "../dist-ClyAFBZk.mjs";
3
+ import { a as getStepDefinition, i as getStep, n as ALL_STEPS, o as resolveModelForFormat, r as getDefaultModelForFormat, t as ALL_PIPELINE_STEPS } from "../step-definitions-DMOw4fzn.mjs";
4
4
  import { t as pickNodePlatformArch } from "../node-topology-platform-BkR_k6WT.mjs";
5
5
  import { a as ensureModel, o as isModelDownloaded, r as deleteModelFromDisk } from "../model-download-service-Cp9f4dk6-CwUb5v3Y.mjs";
6
6
  import { spawn } from "node:child_process";
@@ -11860,7 +11860,8 @@ var PipelineStepInputSchema = lazy(() => object({
11860
11860
  modelId: string().optional(),
11861
11861
  enabled: boolean().default(true),
11862
11862
  children: array(PipelineStepInputSchema).optional(),
11863
- settings: record(string(), unknown()).optional()
11863
+ settings: record(string(), unknown()).optional(),
11864
+ jumpDeviceKey: string().optional()
11864
11865
  }));
11865
11866
  var ModelSubstitutionSchema = object({
11866
11867
  addonId: string(),
@@ -12318,10 +12319,40 @@ var NativeCropBboxSchema = object({
12318
12319
  });
12319
12320
  /** Result of a best-effort native-resolution crop (`getNativeCrop`). */
12320
12321
  var NativeCropResultSchema = object({
12321
- /** Packed rgb (24-bit) pixels of the crop. */
12322
- bytes: _instanceof(Uint8Array),
12322
+ /**
12323
+ * Packed rgb (24-bit) pixels of the crop. Present on the DEFAULT (raw) path —
12324
+ * same-node (in-process / UDS) callers get zero-copy RGB and encode locally.
12325
+ * OMITTED when the caller requested `encodeJpeg` (the cross-node compressed
12326
+ * path below), where shipping raw RGB is both an invariant violation and, for
12327
+ * a native full frame (~26 MB at 4K), larger than Moleculer's 10 MB
12328
+ * `maxPacketSize` → the packet is dropped and the call 60s-times-out. That is
12329
+ * the cross-node native-media miss: `bytes` is replaced by `jpeg`.
12330
+ */
12331
+ bytes: _instanceof(Uint8Array).optional(),
12332
+ /**
12333
+ * Base64 JPEG of the crop — the COMPRESSED cross-node payload. The OWNING node
12334
+ * (which holds the native surface) encodes it in-process, so a native 4K frame
12335
+ * ships as ~0.5–2 MB (well under `maxPacketSize`) and NO raw pixels ever cross
12336
+ * a process boundary (CLAUDE.md invariant #21). Present ONLY when the request
12337
+ * set `encodeJpeg: true`; `bytes` is then absent.
12338
+ */
12339
+ jpeg: string().optional(),
12323
12340
  width: number().int().positive(),
12324
- height: number().int().positive()
12341
+ height: number().int().positive(),
12342
+ /**
12343
+ * Which source served this crop, so a quality-sensitive consumer (the native
12344
+ * `keyFrame`) can reject a degraded fallback:
12345
+ * - `native` — cut from the decode worker's retained NATIVE surface (the
12346
+ * quality path).
12347
+ * - `ram-fullframe` — the native surface MISSED but the request was full-frame,
12348
+ * so the ≤640 RAM `RetainedFrameStore` served it (honest lower-res; legit for
12349
+ * the blank-frame guard / 640-snapshot resolve, NOT for the clean keyFrame).
12350
+ *
12351
+ * OPTIONAL: a pre-tier runner (version skew) omits it — an ABSENT `tier` MUST be
12352
+ * treated as `native` (accepted) by every consumer so mixed-version clusters
12353
+ * keep the pre-tier behaviour. An ROI miss returns `null` (no tier at all).
12354
+ */
12355
+ tier: _enum(["native", "ram-fullframe"]).optional()
12325
12356
  });
12326
12357
  /** Parent detection context passed to `runDetailSubtree` — the crop's
12327
12358
  * originating detection, in FRAME-space coordinates. Reuses
@@ -12451,6 +12482,20 @@ var RunnerFrameSourceSchema = discriminatedUnion("kind", [object({ kind: literal
12451
12482
  hubHostnameOverride: string().optional()
12452
12483
  })]).describe("Per-camera frame-source mode for the runner (P2c)");
12453
12484
  /**
12485
+ * One ENABLED inference device on the runner's node, as the step-tree
12486
+ * device-jump resolver sees it (phase 1). The orchestrator populates this
12487
+ * roster on the attach payload whenever the camera is elected onto a specific
12488
+ * `deviceKey` and the node has ≥2 enabled devices — it is the candidate set the
12489
+ * runner auto-jumps an enrichment step to when the elected device's format
12490
+ * cannot run that step's model. `weight`/`maxSessions` mirror the balancer's
12491
+ * per-device knobs so the auto choice is weighted-least-loaded.
12492
+ */
12493
+ var RunnerInferenceDeviceSchema = object({
12494
+ deviceKey: string(),
12495
+ weight: number().positive().default(1),
12496
+ maxSessions: number().int().positive().nullable().default(null)
12497
+ });
12498
+ /**
12454
12499
  * Camera assignment payload sent by `addon-pipeline-orchestrator` to a
12455
12500
  * specific runner instance via `attachCamera`. Carries everything the
12456
12501
  * runner needs to subscribe to the local broker and execute inference.
@@ -12568,7 +12613,16 @@ var RunnerCameraConfigSchema = object({
12568
12613
  * omitted ⇒ the runner's default device. The engine itself stays node-local —
12569
12614
  * this only selects WHICH device pool of that node runs the session.
12570
12615
  */
12571
- deviceKey: string().optional()
12616
+ deviceKey: string().optional(),
12617
+ /**
12618
+ * Step-tree device-jump roster (phase 1): the node's ENABLED inference
12619
+ * devices, populated by the orchestrator ONLY when `deviceKey` is set and the
12620
+ * node has ≥2 enabled devices. The runner uses it to AUTO-jump an enrichment
12621
+ * step whose model has no build for the elected device's format onto another
12622
+ * enabled device of the SAME node (weighted-least-loaded). Absent/single-entry
12623
+ * ⇒ no jump possible; the step runs on `deviceKey`.
12624
+ */
12625
+ inferenceDevices: array(RunnerInferenceDeviceSchema).readonly().optional()
12572
12626
  });
12573
12627
  motionFpsField.min, motionFpsField.max, motionFpsField.step, motionFpsField.default, detectionFpsField.min, detectionFpsField.max, detectionFpsField.step, detectionFpsField.default, motionCooldownMsField.min, motionCooldownMsField.max, motionCooldownMsField.step, motionCooldownMsField.default, occupancyRecheckSecField.min, occupancyRecheckSecField.max, occupancyRecheckSecField.step, occupancyRecheckSecField.default, occupancyRecheckFramesField.min, occupancyRecheckFramesField.max, occupancyRecheckFramesField.step, occupancyRecheckFramesField.default;
12574
12628
  /**
@@ -12675,15 +12729,31 @@ var pipelineRunnerCapability = {
12675
12729
  * `FrameHandle` that rode an inference-result event and a normalized `bbox`,
12676
12730
  * the runner asks the decode worker still holding that frame's NATIVE
12677
12731
  * surface to GPU/CPU-crop ONLY the ROI at native res and download just the
12678
- * crop. Returns `null` on a miss (handle not registered, or the worker's
12679
- * tiny native-retention ring already evicted the frame) — the caller falls
12680
- * back to a detection-frame crop. Routed to the frame's owning node by
12681
- * `handle.nodeId`; NEVER ships a full native frame.
12732
+ * crop. Routed to the frame's owning node by `handle.nodeId`; NEVER ships a
12733
+ * full native frame.
12734
+ *
12735
+ * Miss behaviour differs by request shape (see `NativeCropResultSchema.tier`):
12736
+ * - an ROI (subject-crop) miss returns `null` — the caller reports the miss
12737
+ * and retries; it is NEVER handed a ≤640 crop masquerading as native.
12738
+ * - a FULL-FRAME miss falls back to the ≤640 RAM `RetainedFrameStore`, tagged
12739
+ * `tier: 'ram-fullframe'` (honest lower-res for the blank-frame guard /
12740
+ * 640-snapshot resolve). A native hit is tagged `tier: 'native'`.
12682
12741
  */
12683
12742
  getNativeCrop: method(object({
12684
12743
  handle: FrameHandleSchema,
12685
12744
  bbox: NativeCropBboxSchema,
12686
- maxWidth: number().int().positive().optional()
12745
+ maxWidth: number().int().positive().optional(),
12746
+ /**
12747
+ * When `true`, the runner encodes the resolved crop to JPEG ON THE
12748
+ * OWNING NODE and returns it in `jpeg` (base64) INSTEAD of raw `bytes`.
12749
+ * Callers set this for CROSS-NODE fetches (`handle.nodeId` is a remote
12750
+ * agent) so the compressed payload fits Moleculer's `maxPacketSize` and
12751
+ * no raw pixels cross the process boundary. Same-node callers omit it
12752
+ * and keep the zero-copy raw `bytes` path. Additive + optional: a
12753
+ * pre-encode runner (version skew) ignores it and returns `bytes`, so
12754
+ * the caller falls back to encoding locally.
12755
+ */
12756
+ encodeJpeg: boolean().optional()
12687
12757
  }), NativeCropResultSchema.nullable()),
12688
12758
  /**
12689
12759
  * Two-plane design: run the DETAIL subtree (crop children —
@@ -15937,7 +16007,8 @@ var LinkedDeviceSchema = object({
15937
16007
  deviceId: number(),
15938
16008
  name: string(),
15939
16009
  location: string().nullable(),
15940
- features: array(string())
16010
+ features: array(string()),
16011
+ producesTrackedEvents: boolean().optional()
15941
16012
  });
15942
16013
  var SavedDeviceRowSchema = object({
15943
16014
  /** Numeric id reserved at allocateDeviceId time. */
@@ -17567,6 +17638,7 @@ var TrackSchema = object({
17567
17638
  deviceId: number(),
17568
17639
  className: string(),
17569
17640
  label: string().optional(),
17641
+ producingDeviceName: string().optional(),
17570
17642
  /** Track provenance. Absent ⇒ `pipeline` (legacy rows). */
17571
17643
  source: TrackSourceSchema.optional(),
17572
17644
  firstSeen: number(),
@@ -17704,7 +17776,8 @@ var MediaFileKindEnum = _enum([
17704
17776
  "fullFrameBoxed",
17705
17777
  "faceCrop",
17706
17778
  "plateCrop",
17707
- "keyFrame"
17779
+ "keyFrame",
17780
+ "keyFrameSmall"
17708
17781
  ]);
17709
17782
  var MediaFileSchema = object({
17710
17783
  key: string(),
@@ -18035,7 +18108,16 @@ var PipelineTemplateSchema = object({
18035
18108
  });
18036
18109
  var DeviceStepConfigSchema = object({
18037
18110
  modelId: string().optional(),
18038
- settings: record(string(), unknown()).optional()
18111
+ settings: record(string(), unknown()).optional(),
18112
+ /**
18113
+ * Step-tree device jump (same-node, phase 1) — OPTIONAL manual override.
18114
+ * When set, this step runs on the named enabled device of the SAME node
18115
+ * (`<backend>:<device>`) instead of the camera's elected device, bypassing
18116
+ * the runtime AUTO-jump. The orchestrator rejects a `jumpDeviceKey` pointing
18117
+ * at a disabled/absent device on that node at save time. Absent ⇒ the runner
18118
+ * auto-jumps only when the effective device's format cannot run the step.
18119
+ */
18120
+ jumpDeviceKey: string().optional()
18039
18121
  });
18040
18122
  var AgentPipelineSettingsSchema = object({
18041
18123
  maxCameras: number().int().nonnegative().nullable().default(null),
@@ -11860,7 +11860,8 @@ var PipelineStepInputSchema = lazy(() => object({
11860
11860
  modelId: string().optional(),
11861
11861
  enabled: boolean().default(true),
11862
11862
  children: array(PipelineStepInputSchema).optional(),
11863
- settings: record(string(), unknown()).optional()
11863
+ settings: record(string(), unknown()).optional(),
11864
+ jumpDeviceKey: string().optional()
11864
11865
  }));
11865
11866
  var ModelSubstitutionSchema = object({
11866
11867
  addonId: string(),
@@ -12318,10 +12319,40 @@ var NativeCropBboxSchema = object({
12318
12319
  });
12319
12320
  /** Result of a best-effort native-resolution crop (`getNativeCrop`). */
12320
12321
  var NativeCropResultSchema = object({
12321
- /** Packed rgb (24-bit) pixels of the crop. */
12322
- bytes: _instanceof(Uint8Array),
12322
+ /**
12323
+ * Packed rgb (24-bit) pixels of the crop. Present on the DEFAULT (raw) path —
12324
+ * same-node (in-process / UDS) callers get zero-copy RGB and encode locally.
12325
+ * OMITTED when the caller requested `encodeJpeg` (the cross-node compressed
12326
+ * path below), where shipping raw RGB is both an invariant violation and, for
12327
+ * a native full frame (~26 MB at 4K), larger than Moleculer's 10 MB
12328
+ * `maxPacketSize` → the packet is dropped and the call 60s-times-out. That is
12329
+ * the cross-node native-media miss: `bytes` is replaced by `jpeg`.
12330
+ */
12331
+ bytes: _instanceof(Uint8Array).optional(),
12332
+ /**
12333
+ * Base64 JPEG of the crop — the COMPRESSED cross-node payload. The OWNING node
12334
+ * (which holds the native surface) encodes it in-process, so a native 4K frame
12335
+ * ships as ~0.5–2 MB (well under `maxPacketSize`) and NO raw pixels ever cross
12336
+ * a process boundary (CLAUDE.md invariant #21). Present ONLY when the request
12337
+ * set `encodeJpeg: true`; `bytes` is then absent.
12338
+ */
12339
+ jpeg: string().optional(),
12323
12340
  width: number().int().positive(),
12324
- height: number().int().positive()
12341
+ height: number().int().positive(),
12342
+ /**
12343
+ * Which source served this crop, so a quality-sensitive consumer (the native
12344
+ * `keyFrame`) can reject a degraded fallback:
12345
+ * - `native` — cut from the decode worker's retained NATIVE surface (the
12346
+ * quality path).
12347
+ * - `ram-fullframe` — the native surface MISSED but the request was full-frame,
12348
+ * so the ≤640 RAM `RetainedFrameStore` served it (honest lower-res; legit for
12349
+ * the blank-frame guard / 640-snapshot resolve, NOT for the clean keyFrame).
12350
+ *
12351
+ * OPTIONAL: a pre-tier runner (version skew) omits it — an ABSENT `tier` MUST be
12352
+ * treated as `native` (accepted) by every consumer so mixed-version clusters
12353
+ * keep the pre-tier behaviour. An ROI miss returns `null` (no tier at all).
12354
+ */
12355
+ tier: _enum(["native", "ram-fullframe"]).optional()
12325
12356
  });
12326
12357
  /** Parent detection context passed to `runDetailSubtree` — the crop's
12327
12358
  * originating detection, in FRAME-space coordinates. Reuses
@@ -12451,6 +12482,20 @@ var RunnerFrameSourceSchema = discriminatedUnion("kind", [object({ kind: literal
12451
12482
  hubHostnameOverride: string().optional()
12452
12483
  })]).describe("Per-camera frame-source mode for the runner (P2c)");
12453
12484
  /**
12485
+ * One ENABLED inference device on the runner's node, as the step-tree
12486
+ * device-jump resolver sees it (phase 1). The orchestrator populates this
12487
+ * roster on the attach payload whenever the camera is elected onto a specific
12488
+ * `deviceKey` and the node has ≥2 enabled devices — it is the candidate set the
12489
+ * runner auto-jumps an enrichment step to when the elected device's format
12490
+ * cannot run that step's model. `weight`/`maxSessions` mirror the balancer's
12491
+ * per-device knobs so the auto choice is weighted-least-loaded.
12492
+ */
12493
+ var RunnerInferenceDeviceSchema = object({
12494
+ deviceKey: string(),
12495
+ weight: number().positive().default(1),
12496
+ maxSessions: number().int().positive().nullable().default(null)
12497
+ });
12498
+ /**
12454
12499
  * Camera assignment payload sent by `addon-pipeline-orchestrator` to a
12455
12500
  * specific runner instance via `attachCamera`. Carries everything the
12456
12501
  * runner needs to subscribe to the local broker and execute inference.
@@ -12568,7 +12613,16 @@ var RunnerCameraConfigSchema = object({
12568
12613
  * omitted ⇒ the runner's default device. The engine itself stays node-local —
12569
12614
  * this only selects WHICH device pool of that node runs the session.
12570
12615
  */
12571
- deviceKey: string().optional()
12616
+ deviceKey: string().optional(),
12617
+ /**
12618
+ * Step-tree device-jump roster (phase 1): the node's ENABLED inference
12619
+ * devices, populated by the orchestrator ONLY when `deviceKey` is set and the
12620
+ * node has ≥2 enabled devices. The runner uses it to AUTO-jump an enrichment
12621
+ * step whose model has no build for the elected device's format onto another
12622
+ * enabled device of the SAME node (weighted-least-loaded). Absent/single-entry
12623
+ * ⇒ no jump possible; the step runs on `deviceKey`.
12624
+ */
12625
+ inferenceDevices: array(RunnerInferenceDeviceSchema).readonly().optional()
12572
12626
  });
12573
12627
  motionFpsField.min, motionFpsField.max, motionFpsField.step, motionFpsField.default, detectionFpsField.min, detectionFpsField.max, detectionFpsField.step, detectionFpsField.default, motionCooldownMsField.min, motionCooldownMsField.max, motionCooldownMsField.step, motionCooldownMsField.default, occupancyRecheckSecField.min, occupancyRecheckSecField.max, occupancyRecheckSecField.step, occupancyRecheckSecField.default, occupancyRecheckFramesField.min, occupancyRecheckFramesField.max, occupancyRecheckFramesField.step, occupancyRecheckFramesField.default;
12574
12628
  /**
@@ -12675,15 +12729,31 @@ var pipelineRunnerCapability = {
12675
12729
  * `FrameHandle` that rode an inference-result event and a normalized `bbox`,
12676
12730
  * the runner asks the decode worker still holding that frame's NATIVE
12677
12731
  * surface to GPU/CPU-crop ONLY the ROI at native res and download just the
12678
- * crop. Returns `null` on a miss (handle not registered, or the worker's
12679
- * tiny native-retention ring already evicted the frame) — the caller falls
12680
- * back to a detection-frame crop. Routed to the frame's owning node by
12681
- * `handle.nodeId`; NEVER ships a full native frame.
12732
+ * crop. Routed to the frame's owning node by `handle.nodeId`; NEVER ships a
12733
+ * full native frame.
12734
+ *
12735
+ * Miss behaviour differs by request shape (see `NativeCropResultSchema.tier`):
12736
+ * - an ROI (subject-crop) miss returns `null` — the caller reports the miss
12737
+ * and retries; it is NEVER handed a ≤640 crop masquerading as native.
12738
+ * - a FULL-FRAME miss falls back to the ≤640 RAM `RetainedFrameStore`, tagged
12739
+ * `tier: 'ram-fullframe'` (honest lower-res for the blank-frame guard /
12740
+ * 640-snapshot resolve). A native hit is tagged `tier: 'native'`.
12682
12741
  */
12683
12742
  getNativeCrop: method(object({
12684
12743
  handle: FrameHandleSchema,
12685
12744
  bbox: NativeCropBboxSchema,
12686
- maxWidth: number().int().positive().optional()
12745
+ maxWidth: number().int().positive().optional(),
12746
+ /**
12747
+ * When `true`, the runner encodes the resolved crop to JPEG ON THE
12748
+ * OWNING NODE and returns it in `jpeg` (base64) INSTEAD of raw `bytes`.
12749
+ * Callers set this for CROSS-NODE fetches (`handle.nodeId` is a remote
12750
+ * agent) so the compressed payload fits Moleculer's `maxPacketSize` and
12751
+ * no raw pixels cross the process boundary. Same-node callers omit it
12752
+ * and keep the zero-copy raw `bytes` path. Additive + optional: a
12753
+ * pre-encode runner (version skew) ignores it and returns `bytes`, so
12754
+ * the caller falls back to encoding locally.
12755
+ */
12756
+ encodeJpeg: boolean().optional()
12687
12757
  }), NativeCropResultSchema.nullable()),
12688
12758
  /**
12689
12759
  * Two-plane design: run the DETAIL subtree (crop children —
@@ -15937,7 +16007,8 @@ var LinkedDeviceSchema = object({
15937
16007
  deviceId: number(),
15938
16008
  name: string(),
15939
16009
  location: string().nullable(),
15940
- features: array(string())
16010
+ features: array(string()),
16011
+ producesTrackedEvents: boolean().optional()
15941
16012
  });
15942
16013
  var SavedDeviceRowSchema = object({
15943
16014
  /** Numeric id reserved at allocateDeviceId time. */
@@ -17567,6 +17638,7 @@ var TrackSchema = object({
17567
17638
  deviceId: number(),
17568
17639
  className: string(),
17569
17640
  label: string().optional(),
17641
+ producingDeviceName: string().optional(),
17570
17642
  /** Track provenance. Absent ⇒ `pipeline` (legacy rows). */
17571
17643
  source: TrackSourceSchema.optional(),
17572
17644
  firstSeen: number(),
@@ -17704,7 +17776,8 @@ var MediaFileKindEnum = _enum([
17704
17776
  "fullFrameBoxed",
17705
17777
  "faceCrop",
17706
17778
  "plateCrop",
17707
- "keyFrame"
17779
+ "keyFrame",
17780
+ "keyFrameSmall"
17708
17781
  ]);
17709
17782
  var MediaFileSchema = object({
17710
17783
  key: string(),
@@ -18035,7 +18108,16 @@ var PipelineTemplateSchema = object({
18035
18108
  });
18036
18109
  var DeviceStepConfigSchema = object({
18037
18110
  modelId: string().optional(),
18038
- settings: record(string(), unknown()).optional()
18111
+ settings: record(string(), unknown()).optional(),
18112
+ /**
18113
+ * Step-tree device jump (same-node, phase 1) — OPTIONAL manual override.
18114
+ * When set, this step runs on the named enabled device of the SAME node
18115
+ * (`<backend>:<device>`) instead of the camera's elected device, bypassing
18116
+ * the runtime AUTO-jump. The orchestrator rejects a `jumpDeviceKey` pointing
18117
+ * at a disabled/absent device on that node at save time. Absent ⇒ the runner
18118
+ * auto-jumps only when the effective device's format cannot run the step.
18119
+ */
18120
+ jumpDeviceKey: string().optional()
18039
18121
  });
18040
18122
  var AgentPipelineSettingsSchema = object({
18041
18123
  maxCameras: number().int().nonnegative().nullable().default(null),
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_dist = require("../dist-DWy-H6bo.js");
5
+ const require_dist = require("../dist-CVjqvU8G.js");
6
6
  let node_fs = require("node:fs");
7
7
  let node_path = require("node:path");
8
8
  //#region src/motion-wasm/wasm-motion-detector.ts
@@ -1,4 +1,4 @@
1
- import { A as motionDetectionCapability, J as hydrateSchema, K as DeviceType, T as evaluateZoneRules, U as BaseAddon } from "../dist-DLWXeXC1.mjs";
1
+ import { A as motionDetectionCapability, J as hydrateSchema, K as DeviceType, T as evaluateZoneRules, U as BaseAddon } from "../dist-ClyAFBZk.mjs";
2
2
  import { readFileSync } from "node:fs";
3
3
  import { join } from "node:path";
4
4
  //#region src/motion-wasm/wasm-motion-detector.ts