camstack 1.2.0 → 1.2.2

package/dist/{chunk-LQUCPQ55.js → chunk-QCUR7GXB.js}

@@ -19628,7 +19628,8 @@ var PipelineStepInputSchema = external_exports.lazy(() => external_exports.objec
   modelId: external_exports.string().optional(),
   enabled: external_exports.boolean().default(true),
   children: external_exports.array(PipelineStepInputSchema).optional(),
-  settings: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+  settings: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  jumpDeviceKey: external_exports.string().optional()
 }));
 var ModelSubstitutionSchema = external_exports.object({
   addonId: external_exports.string(),
@@ -20050,10 +20051,40 @@ var NativeCropBboxSchema = external_exports.object({
   h: external_exports.number()
 });
 var NativeCropResultSchema = external_exports.object({
-  /** Packed rgb (24-bit) pixels of the crop. */
-  bytes: external_exports.instanceof(Uint8Array),
+  /**
+  * Packed rgb (24-bit) pixels of the crop. Present on the DEFAULT (raw) path —
+  * same-node (in-process / UDS) callers get zero-copy RGB and encode locally.
+  * OMITTED when the caller requested `encodeJpeg` (the cross-node compressed
+  * path below), where shipping raw RGB is both an invariant violation and, for
+  * a native full frame (~26 MB at 4K), larger than Moleculer's 10 MB
+  * `maxPacketSize` → the packet is dropped and the call 60s-times-out. That is
+  * the cross-node native-media miss: `bytes` is replaced by `jpeg`.
+  */
+  bytes: external_exports.instanceof(Uint8Array).optional(),
+  /**
+  * Base64 JPEG of the crop — the COMPRESSED cross-node payload. The OWNING node
+  * (which holds the native surface) encodes it in-process, so a native 4K frame
+  * ships as ~0.5–2 MB (well under `maxPacketSize`) and NO raw pixels ever cross
+  * a process boundary (CLAUDE.md invariant #21). Present ONLY when the request
+  * set `encodeJpeg: true`; `bytes` is then absent.
+  */
+  jpeg: external_exports.string().optional(),
   width: external_exports.number().int().positive(),
-  height: external_exports.number().int().positive()
+  height: external_exports.number().int().positive(),
+  /**
+  * Which source served this crop, so a quality-sensitive consumer (the native
+  * `keyFrame`) can reject a degraded fallback:
+  * - `native` — cut from the decode worker's retained NATIVE surface (the
+  *   quality path).
+  * - `ram-fullframe` — the native surface MISSED but the request was full-frame,
+  *   so the ≤640 RAM `RetainedFrameStore` served it (honest lower-res; legit for
+  *   the blank-frame guard / 640-snapshot resolve, NOT for the clean keyFrame).
+  *
+  * OPTIONAL: a pre-tier runner (version skew) omits it — an ABSENT `tier` MUST be
+  * treated as `native` (accepted) by every consumer so mixed-version clusters
+  * keep the pre-tier behaviour. An ROI miss returns `null` (no tier at all).
+  */
+  tier: external_exports.enum(["native", "ram-fullframe"]).optional()
 });
 var DetailParentSchema = external_exports.object({
   bbox: NativeCropBboxSchema,
@@ -20121,6 +20152,11 @@ var RunnerFrameSourceSchema = external_exports.discriminatedUnion("kind", [exter
   /** Operator override for the owner host the runner dials. */
   hubHostnameOverride: external_exports.string().optional()
 })]).describe("Per-camera frame-source mode for the runner (P2c)");
+var RunnerInferenceDeviceSchema = external_exports.object({
+  deviceKey: external_exports.string(),
+  weight: external_exports.number().positive().default(1),
+  maxSessions: external_exports.number().int().positive().nullable().default(null)
+});
 var RunnerCameraConfigSchema = external_exports.object({
   deviceId: external_exports.number(),
   /**
@@ -20228,7 +20264,16 @@ var RunnerCameraConfigSchema = external_exports.object({
   * omitted ⇒ the runner's default device. The engine itself stays node-local —
   * this only selects WHICH device pool of that node runs the session.
   */
-  deviceKey: external_exports.string().optional()
+  deviceKey: external_exports.string().optional(),
+  /**
+  * Step-tree device-jump roster (phase 1): the node's ENABLED inference
+  * devices, populated by the orchestrator ONLY when `deviceKey` is set and the
+  * node has ≥2 enabled devices. The runner uses it to AUTO-jump an enrichment
+  * step whose model has no build for the elected device's format onto another
+  * enabled device of the SAME node (weighted-least-loaded). Absent/single-entry
+  * ⇒ no jump possible; the step runs on `deviceKey`.
+  */
+  inferenceDevices: external_exports.array(RunnerInferenceDeviceSchema).readonly().optional()
 });
 var RunnerCameraDeviceUIFields = [
   {
@@ -20420,15 +20465,31 @@ var pipelineRunnerCapability = {
     * `FrameHandle` that rode an inference-result event and a normalized `bbox`,
     * the runner asks the decode worker still holding that frame's NATIVE
     * surface to GPU/CPU-crop ONLY the ROI at native res and download just the
-    * crop. Returns `null` on a miss (handle not registered, or the worker's
-    * tiny native-retention ring already evicted the frame) — the caller falls
-    * back to a detection-frame crop. Routed to the frame's owning node by
-    * `handle.nodeId`; NEVER ships a full native frame.
+    * crop. Routed to the frame's owning node by `handle.nodeId`; NEVER ships a
+    * full native frame.
+    *
+    * Miss behaviour differs by request shape (see `NativeCropResultSchema.tier`):
+    * - an ROI (subject-crop) miss returns `null` — the caller reports the miss
+    *   and retries; it is NEVER handed a ≤640 crop masquerading as native.
+    * - a FULL-FRAME miss falls back to the ≤640 RAM `RetainedFrameStore`, tagged
+    *   `tier: 'ram-fullframe'` (honest lower-res for the blank-frame guard /
+    *   640-snapshot resolve). A native hit is tagged `tier: 'native'`.
     */
     getNativeCrop: method(external_exports.object({
       handle: FrameHandleSchema,
       bbox: NativeCropBboxSchema,
-      maxWidth: external_exports.number().int().positive().optional()
+      maxWidth: external_exports.number().int().positive().optional(),
+      /**
+      * When `true`, the runner encodes the resolved crop to JPEG ON THE
+      * OWNING NODE and returns it in `jpeg` (base64) INSTEAD of raw `bytes`.
+      * Callers set this for CROSS-NODE fetches (`handle.nodeId` is a remote
+      * agent) so the compressed payload fits Moleculer's `maxPacketSize` and
+      * no raw pixels cross the process boundary. Same-node callers omit it
+      * and keep the zero-copy raw `bytes` path. Additive + optional: a
+      * pre-encode runner (version skew) ignores it and returns `bytes`, so
+      * the caller falls back to encoding locally.
+      */
+      encodeJpeg: external_exports.boolean().optional()
     }), NativeCropResultSchema.nullable()),
     /**
     * Two-plane design: run the DETAIL subtree (crop children —
@@ -24146,7 +24207,8 @@ var LinkedDeviceSchema = external_exports.object({
   deviceId: external_exports.number(),
   name: external_exports.string(),
   location: external_exports.string().nullable(),
-  features: external_exports.array(external_exports.string())
+  features: external_exports.array(external_exports.string()),
+  producesTrackedEvents: external_exports.boolean().optional()
 });
 var SavedDeviceRowSchema = external_exports.object({
   /** Numeric id reserved at allocateDeviceId time. */
@@ -26063,6 +26125,7 @@ var TrackSchema = external_exports.object({
   deviceId: external_exports.number(),
   className: external_exports.string(),
   label: external_exports.string().optional(),
+  producingDeviceName: external_exports.string().optional(),
   /** Track provenance. Absent ⇒ `pipeline` (legacy rows). */
   source: TrackSourceSchema.optional(),
   firstSeen: external_exports.number(),
@@ -26192,7 +26255,8 @@ var MediaFileKindEnum = external_exports.enum([
   "fullFrameBoxed",
   "faceCrop",
   "plateCrop",
-  "keyFrame"
+  "keyFrame",
+  "keyFrameSmall"
 ]);
 var MediaFileSchema = external_exports.object({
   key: external_exports.string(),
@@ -26653,7 +26717,16 @@ var PipelineTemplateSchema = external_exports.object({
 });
 var DeviceStepConfigSchema = external_exports.object({
   modelId: external_exports.string().optional(),
-  settings: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+  settings: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  /**
+  * Step-tree device jump (same-node, phase 1) — OPTIONAL manual override.
+  * When set, this step runs on the named enabled device of the SAME node
+  * (`<backend>:<device>`) instead of the camera's elected device, bypassing
+  * the runtime AUTO-jump. The orchestrator rejects a `jumpDeviceKey` pointing
+  * at a disabled/absent device on that node at save time. Absent ⇒ the runner
+  * auto-jumps only when the effective device's format cannot run the step.
+  */
+  jumpDeviceKey: external_exports.string().optional()
 });
 var AgentPipelineSettingsSchema = external_exports.object({
   maxCameras: external_exports.number().int().nonnegative().nullable().default(null),

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-LQUCPQ55.js";
+} from "./chunk-QCUR7GXB.js";
 import "./chunk-K3NQKI34.js";
 
 // src/cli.ts
@@ -1079,7 +1079,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-GAE4KR5T.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-4OS76PKO.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-GAE4KR5T.js → discover-4OS76PKO.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-LQUCPQ55.js";
+} from "./chunk-QCUR7GXB.js";
 import "./chunk-K3NQKI34.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "camstack",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "CLI tool for managing and running CamStack server",
   "keywords": [
     "camstack",