camstack 1.2.139 → 1.2.141

package/dist/{chunk-CN634R3T.js → chunk-I7QELQM5.js}

@@ -28352,6 +28352,14 @@ var NativeCropResultSchema = external_exports.object({
   * set `encodeJpeg: true`; `bytes` is then absent.
   */
   jpeg: external_exports.string().optional(),
+  /**
+  * The SAME compressed JPEG as `jpeg`, as bytes (D462). Present instead of
+  * `jpeg` when the request set `acceptJpegBytes`; a request that did not gets
+  * `jpeg` exactly as before. MsgPack and the mesh leg both carry binary —
+  * `bytes` above has crossed this boundary as a `Uint8Array` all along — so
+  * base64 was buying nothing but a multi-megabyte string in the relay's heap.
+  */
+  jpegBytes: external_exports.instanceof(Uint8Array).optional(),
   width: external_exports.number().int().positive(),
   height: external_exports.number().int().positive(),
   /**
@@ -28393,7 +28401,14 @@ var ParkTrackFrameResultSchema = external_exports.discriminatedUnion("parked", [
   detail: external_exports.string().optional()
 })]);
 var ParkedTrackFrameSchema = external_exports.object({
-  jpeg: external_exports.string(),
+  /**
+  * Base64 JPEG — the pre-D462 wire. OPTIONAL since D462: a request that set
+  * `acceptJpegBytes` is answered in `jpegBytes` and this is then absent.
+  * Exactly one of the two is present.
+  */
+  jpeg: external_exports.string().optional(),
+  /** The same JPEG as bytes, for a caller that declared it reads them (D462). */
+  jpegBytes: external_exports.instanceof(Uint8Array).optional(),
   width: external_exports.number().int().positive(),
   height: external_exports.number().int().positive(),
   /** The frame instant the parcel shows (the caller's clock, echoed back). */
@@ -29049,6 +29064,13 @@ var pipelineRunnerCapability = {
       bbox: NativeCropBboxSchema,
       maxWidth: external_exports.number().int().positive().optional(),
       /**
+      * The caller reads a `Uint8Array` (D462). When set, a JPEG answer comes
+      * back in `jpegBytes` instead of base64 `jpeg`. Absent means the old
+      * wire — never assume consent: a pre-D462 caller parses the field as
+      * base64 and bytes would decode to garbage rather than fail.
+      */
+      acceptJpegBytes: external_exports.boolean().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
@@ -29221,7 +29243,14 @@ var pipelineRunnerCapability = {
     getParkedTrackFrame: method(external_exports.object({
       deviceId: external_exports.number(),
       trackId: external_exports.string(),
-      kind: ParkedFrameKindSchema
+      kind: ParkedFrameKindSchema,
+      /**
+      * The caller reads a `Uint8Array` (D462). When set, a JPEG answer comes
+      * back in `jpegBytes` instead of base64 `jpeg`. Absent means the old
+      * wire — never assume consent: a pre-D462 caller parses the field as
+      * base64 and bytes would decode to garbage rather than fail.
+      */
+      acceptJpegBytes: external_exports.boolean().optional()
     }), ParkedTrackFrameSchema.nullable()),
     /**
     * Drop every parcel of a track — the hub closed it. Idempotent. A track

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-CN634R3T.js";
+} from "./chunk-I7QELQM5.js";
 import "./chunk-LMMQX4CK.js";
 
 // src/cli.ts
@@ -38,7 +38,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-XPB2M67K.js");
+  await import("./launcher-VU6P7QP5.js");
 }
 
 // src/commands/agent.ts
@@ -83,7 +83,7 @@ async function runAgent(args) {
     ...typeof values.port === "string" ? { port: values.port } : {}
   };
   Object.assign(process.env, buildAgentEnv(opts));
-  await import("./launcher-XPB2M67K.js");
+  await import("./launcher-VU6P7QP5.js");
 }
 
 // src/commands/setup.ts
@@ -531,6 +531,7 @@ async function deployAddon(addonPath, opts) {
       targets.push({ label: "hub" });
     }
     const outcomes = [];
+    let propagating = false;
     for (const t of targets) {
       console.log(`[camstack] \u2192 Deploying ${path2.basename(tgzPath)} to ${t.label}...`);
       const result = await withNetworkRetry(
@@ -553,6 +554,7 @@ async function deployAddon(addonPath, opts) {
         console.error(`[camstack]   \u2717 ${t.label}: ${misrouted}`);
         outcomes.push({ target: t.label, ok: false, detail: misrouted });
       } else if (result.success) {
+        if (result.propagatingToAgentsInBackground === true) propagating = true;
         const { detail, warning } = describeDeployOutcome(result, t.nodeId !== void 0);
         console.log(`[camstack]   \u2713 ${t.label}: ${detail}`);
         if (warning) console.warn(`[camstack]   \u26A0 ${t.label}: ${warning}`);
@@ -569,6 +571,14 @@ async function deployAddon(addonPath, opts) {
       process.exit(1);
     }
     console.log(`[camstack] \u2713 Deployed to ${outcomes.length} target(s)`);
+    if (propagating) {
+      console.log(
+        "[camstack]   \u2026 agents are updated in the BACKGROUND and are NOT covered by the \u2713 above."
+      );
+      console.log(
+        "[camstack]     Confirm with: hub log line `propagation done` (per-agent success/error)."
+      );
+    }
     if (opts.verify !== false) {
       process.stdout.write("[camstack] Verifying hub health");
       const healthy = await verifyHubHealthy(opts.serverUrl, { attempts: 20, delayMs: 1500 });
@@ -1130,7 +1140,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-5XVCTM5V.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-ELE6KHU4.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-5XVCTM5V.js → discover-ELE6KHU4.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-CN634R3T.js";
+} from "./chunk-I7QELQM5.js";
 import "./chunk-LMMQX4CK.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,

package/dist/{launcher-XPB2M67K.js → launcher-VU6P7QP5.js}

@@ -23633,9 +23633,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-CllKpcTd.js
-var require_dist_CllKpcTd = __commonJS({
-  "../system/dist/dist-CllKpcTd.js"(exports) {
+// ../system/dist/dist-0sWJNwme.js
+var require_dist_0sWJNwme = __commonJS({
+  "../system/dist/dist-0sWJNwme.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -39130,6 +39130,14 @@ var require_dist_CllKpcTd = __commonJS({
       * set `encodeJpeg: true`; `bytes` is then absent.
       */
       jpeg: zod.z.string().optional(),
+      /**
+      * The SAME compressed JPEG as `jpeg`, as bytes (D462). Present instead of
+      * `jpeg` when the request set `acceptJpegBytes`; a request that did not gets
+      * `jpeg` exactly as before. MsgPack and the mesh leg both carry binary —
+      * `bytes` above has crossed this boundary as a `Uint8Array` all along — so
+      * base64 was buying nothing but a multi-megabyte string in the relay's heap.
+      */
+      jpegBytes: zod.z.instanceof(Uint8Array).optional(),
       width: zod.z.number().int().positive(),
       height: zod.z.number().int().positive(),
       /**
@@ -39171,7 +39179,14 @@ var require_dist_CllKpcTd = __commonJS({
       detail: zod.z.string().optional()
     })]);
     var ParkedTrackFrameSchema = zod.z.object({
-      jpeg: zod.z.string(),
+      /**
+      * Base64 JPEG — the pre-D462 wire. OPTIONAL since D462: a request that set
+      * `acceptJpegBytes` is answered in `jpegBytes` and this is then absent.
+      * Exactly one of the two is present.
+      */
+      jpeg: zod.z.string().optional(),
+      /** The same JPEG as bytes, for a caller that declared it reads them (D462). */
+      jpegBytes: zod.z.instanceof(Uint8Array).optional(),
       width: zod.z.number().int().positive(),
       height: zod.z.number().int().positive(),
       /** The frame instant the parcel shows (the caller's clock, echoed back). */
@@ -39654,6 +39669,13 @@ var require_dist_CllKpcTd = __commonJS({
           bbox: NativeCropBboxSchema,
           maxWidth: zod.z.number().int().positive().optional(),
           /**
+          * The caller reads a `Uint8Array` (D462). When set, a JPEG answer comes
+          * back in `jpegBytes` instead of base64 `jpeg`. Absent means the old
+          * wire — never assume consent: a pre-D462 caller parses the field as
+          * base64 and bytes would decode to garbage rather than fail.
+          */
+          acceptJpegBytes: zod.z.boolean().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
@@ -39826,7 +39848,14 @@ var require_dist_CllKpcTd = __commonJS({
         getParkedTrackFrame: method(zod.z.object({
           deviceId: zod.z.number(),
           trackId: zod.z.string(),
-          kind: ParkedFrameKindSchema
+          kind: ParkedFrameKindSchema,
+          /**
+          * The caller reads a `Uint8Array` (D462). When set, a JPEG answer comes
+          * back in `jpegBytes` instead of base64 `jpeg`. Absent means the old
+          * wire — never assume consent: a pre-D462 caller parses the field as
+          * base64 and bytes would decode to garbage rather than fail.
+          */
+          acceptJpegBytes: zod.z.boolean().optional()
         }), ParkedTrackFrameSchema.nullable()),
         /**
         * Drop every parcel of a track — the hub closed it. Idempotent. A track
@@ -61710,7 +61739,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -62529,7 +62558,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -62623,7 +62652,7 @@ var require_core_blocks_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -63520,11 +63549,11 @@ var require_core_blocks = __commonJS({
   }
 });
 
-// ../system/dist/retired-settings-keys-7iEsSzmD.js
-var require_retired_settings_keys_7iEsSzmD = __commonJS({
-  "../system/dist/retired-settings-keys-7iEsSzmD.js"(exports) {
+// ../system/dist/retired-settings-keys-Dh-XMfFx.js
+var require_retired_settings_keys_Dh_XMfFx = __commonJS({
+  "../system/dist/retired-settings-keys-Dh-XMfFx.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     function settingsStoreIsAuthoritativeHere(env) {
       const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
       return raw === "" || raw === "hub";
@@ -65759,8 +65788,8 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
-    var require_retired_settings_keys = require_retired_settings_keys_7iEsSzmD();
+    var require_dist10 = require_dist_0sWJNwme();
+    var require_retired_settings_keys = require_retired_settings_keys_Dh_XMfFx();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -71385,7 +71414,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -71522,7 +71551,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -71718,7 +71747,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -79531,7 +79560,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -80118,7 +80147,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     var node_fs_promises = __require("fs/promises");
     var node_fs = __require("fs");
     node_fs = require_chunk.__toESM(node_fs);
@@ -82871,7 +82900,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -84098,8 +84127,8 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
-    var require_retired_settings_keys = require_retired_settings_keys_7iEsSzmD();
+    var require_dist10 = require_dist_0sWJNwme();
+    var require_retired_settings_keys = require_retired_settings_keys_Dh_XMfFx();
     var require_wal_checkpoint_policy = require_wal_checkpoint_policy_CCJZngds();
     var node_crypto = __require("crypto");
     var node_path = __require("path");
@@ -86766,7 +86795,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     var require_hub_cap_forward = require_hub_cap_forward_DmHNjbB0();
     var zod = require_zod();
     var node_crypto = __require("crypto");
@@ -90416,7 +90445,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -108477,7 +108506,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -121213,9 +121242,9 @@ var require_dist2 = __commonJS({
   }
 });
 
-// ../system/dist/manifest-system-deps-DfpwaXkh.js
-var require_manifest_system_deps_DfpwaXkh = __commonJS({
-  "../system/dist/manifest-system-deps-DfpwaXkh.js"(exports) {
+// ../system/dist/manifest-system-deps-YYKKCKSF.js
+var require_manifest_system_deps_YYKKCKSF = __commonJS({
+  "../system/dist/manifest-system-deps-YYKKCKSF.js"(exports) {
     "use strict";
     var require_chunk = require_chunk_Cek0wNdY();
     require_hub_cap_forward_DmHNjbB0();
@@ -121265,7 +121294,9 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
             childrenConnected: listed.length,
             childrenUndeclared: registry.undeclaredChildCount(),
             crossNodeDelivered: crossNode?.delivered ?? 0,
-            crossNodeSuppressed: crossNode?.suppressed ?? 0
+            crossNodeSuppressed: crossNode?.suppressed ?? 0,
+            categories: registry.categoryFanout(),
+            categoryOverflow: registry.categoryCensusOverflow()
           };
         } catch {
           return;
@@ -121275,8 +121306,10 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
     var EVENT_PLANE_TOP_N = 5;
     var EMPTY_EVENT_PLANE_BASELINE = {
       children: /* @__PURE__ */ new Map(),
+      categories: /* @__PURE__ */ new Map(),
       crossNodeDelivered: 0,
-      crossNodeSuppressed: 0
+      crossNodeSuppressed: 0,
+      categoryOverflow: 0
     };
     function diffEventPlane(baseline, current, topN = 5) {
       const deltas = [];
@@ -121294,6 +121327,23 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
           suppressed
         });
       }
+      const categoryDeltas = [];
+      let categoryBroadcasts = 0;
+      let orphanBroadcasts = 0;
+      for (const sample of current.categories) {
+        const before = baseline.categories.get(sample.category);
+        const broadcasts = Math.max(0, sample.broadcasts - (before?.broadcasts ?? 0));
+        if (broadcasts === 0) continue;
+        const wanted = Math.max(0, sample.wanted - (before?.wanted ?? 0));
+        categoryBroadcasts += broadcasts;
+        if (wanted === 0) orphanBroadcasts += broadcasts;
+        categoryDeltas.push({
+          category: sample.category,
+          broadcasts,
+          wanted
+        });
+      }
+      const byBroadcasts = categoryDeltas.toSorted((a, b) => b.broadcasts - a.broadcasts || a.category.localeCompare(b.category));
       return {
         udsMode: current.udsMode,
         crossNodeMode: current.crossNodeMode,
@@ -121303,7 +121353,12 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
         fanoutSuppressed,
         crossNodeDelivered: Math.max(0, current.crossNodeDelivered - baseline.crossNodeDelivered),
         crossNodeSuppressed: Math.max(0, current.crossNodeSuppressed - baseline.crossNodeSuppressed),
-        top: deltas.toSorted((a, b) => b.sent - a.sent || a.childId.localeCompare(b.childId)).slice(0, topN)
+        top: deltas.toSorted((a, b) => b.sent - a.sent || a.childId.localeCompare(b.childId)).slice(0, topN),
+        categoryBroadcasts,
+        orphanBroadcasts,
+        topCategories: byBroadcasts.slice(0, topN),
+        topOrphans: byBroadcasts.filter((c) => c.wanted === 0).slice(0, topN),
+        categoryOverflow: Math.max(0, current.categoryOverflow - baseline.categoryOverflow)
       };
     }
     function createEventPlaneMeter(reader, topN = 5) {
@@ -121314,8 +121369,10 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
         const window2 = diffEventPlane(baseline, current, topN);
         baseline = {
           children: new Map(current.children.map((s) => [s.childId, s])),
+          categories: new Map(current.categories.map((c) => [c.category, c])),
           crossNodeDelivered: current.crossNodeDelivered,
-          crossNodeSuppressed: current.crossNodeSuppressed
+          crossNodeSuppressed: current.crossNodeSuppressed,
+          categoryOverflow: current.categoryOverflow
         };
         return window2;
       } };
@@ -121323,7 +121380,9 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
     function formatEventPlane(window2) {
       if (window2 === void 0) return "";
       const top = window2.top.map((d) => `${d.childId}:${d.sent}/${d.suppressed}`).join(",");
-      return ` fanoutMode=uds:${window2.udsMode}/cross-node:${window2.crossNodeMode} children=${window2.childrenConnected} childrenUndeclared=${window2.childrenUndeclared} fanoutSent=${window2.fanoutSent} fanoutSuppressed=${window2.fanoutSuppressed} crossNodeDelivered=${window2.crossNodeDelivered} crossNodeSuppressed=${window2.crossNodeSuppressed}` + (top.length === 0 ? "" : ` fanoutTop=${top}`);
+      const cats = window2.topCategories.map((c) => `${c.category}:${c.broadcasts}/${c.wanted}`).join(",");
+      const orphans = window2.topOrphans.map((c) => `${c.category}:${c.broadcasts}`).join(",");
+      return ` fanoutMode=uds:${window2.udsMode}/cross-node:${window2.crossNodeMode} children=${window2.childrenConnected} childrenUndeclared=${window2.childrenUndeclared} fanoutSent=${window2.fanoutSent} fanoutSuppressed=${window2.fanoutSuppressed} crossNodeDelivered=${window2.crossNodeDelivered} crossNodeSuppressed=${window2.crossNodeSuppressed} fanoutEvents=${window2.categoryBroadcasts} fanoutOrphans=${window2.orphanBroadcasts} fanoutCatsDropped=${window2.categoryOverflow}` + (top.length === 0 ? "" : ` fanoutTop=${top}`) + (cats.length === 0 ? "" : ` fanoutCats=${cats}`) + (orphans.length === 0 ? "" : ` fanoutOrphanTop=${orphans}`);
     }
     var EMPTY_CAP_ACTION_READING = /* @__PURE__ */ new Map();
     var CAP_ACTION_UNLABELLED = "(unlabelled)";
@@ -126394,6 +126453,12 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
       fanoutMode = readFanoutMode();
       /** Per-child event fan-out counters (sent / suppressed). */
       childEventStats = /* @__PURE__ */ new Map();
+      /** D467: per-category production census (cumulative). See {@link CategoryFanoutSample}. */
+      categoryStats = /* @__PURE__ */ new Map();
+      /** Broadcasts whose category did not fit in {@link CATEGORY_CENSUS_MAX}. */
+      categoryOverflow = 0;
+      /** One INFO line the first time the census cap trips, never per event. */
+      categoryOverflowLogged = false;
       /** Last pattern-set string logged per child, to dedup the INFO line. */
       loggedPatternSet = /* @__PURE__ */ new Map();
       /**
@@ -126449,6 +126514,25 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
         };
       }
       /**
+      * D467: every category this node has broadcast, with its emit count and how
+      * many child subscriptions matched. Cumulative for the life of the process —
+      * the heartbeat differences it, the same discipline as the per-child
+      * counters. Largest `broadcasts` first.
+      */
+      categoryFanout() {
+        const out = [];
+        for (const [category, s] of this.categoryStats) out.push({
+          category,
+          broadcasts: s.broadcasts,
+          wanted: s.wanted
+        });
+        return out.toSorted((a, b) => b.broadcasts - a.broadcasts || a.category.localeCompare(b.category));
+      }
+      /** Broadcasts the census could not attribute because it was full (cumulative). */
+      categoryCensusOverflow() {
+        return this.categoryOverflow;
+      }
+      /**
       * This child's socket traffic — bytes and messages, both directions, split by
       * frame kind — or `null` when the child is gone or its channel keeps no
       * counters (an in-process or test transport).
@@ -126539,6 +126623,17 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
       */
       childWantsEvent(entry, category) {
         if (this.fanoutMode === "broadcast") return true;
+        return this.childSubscribesTo(entry, category);
+      }
+      /**
+      * The SUBSCRIPTION answer alone, with no fan-out-mode override.
+      *
+      * {@link childWantsEvent} answers "will this child be sent the event", which
+      * under `broadcast` is `true` for everything and therefore cannot say whether
+      * anyone actually asked. The D467 census needs the second question, so the
+      * two are separate functions and `broadcast` mode overrides only the first.
+      */
+      childSubscribesTo(entry, category) {
         if (entry.eventPatterns === null) return true;
         return entry.eventPatterns.some((p) => matchesPattern(p, category));
       }
@@ -126841,8 +126936,10 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
           event,
           sourceNodeId
         };
+        let subscribed = 0;
         for (const entry of this.children.values()) {
           if (entry.childId === exceptChildId) continue;
+          if (this.childSubscribesTo(entry, event.category)) subscribed += 1;
           const wants = this.childWantsEvent(entry, event.category);
           const stats = this.statsFor(entry.childId);
           if (!wants) stats.suppressed++;
@@ -126851,6 +126948,34 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
             entry.channel.emit(msg);
           }
         }
+        this.recordCategoryBroadcast(event.category, subscribed);
+      }
+      /**
+      * Record one PRODUCED event against its category. Called once per broadcast,
+      * outside the per-child loop, because production is what the census measures.
+      */
+      recordCategoryBroadcast(category, subscribed) {
+        const existing = this.categoryStats.get(category);
+        if (existing !== void 0) {
+          existing.broadcasts += 1;
+          existing.wanted += subscribed;
+          return;
+        }
+        if (this.categoryStats.size >= 256) {
+          this.categoryOverflow += 1;
+          if (!this.categoryOverflowLogged) {
+            this.categoryOverflowLogged = true;
+            this.logger?.info("event category census full \u2014 further new categories are unattributed", {
+              max: 256,
+              firstDropped: category
+            });
+          }
+          return;
+        }
+        this.categoryStats.set(category, {
+          broadcasts: 1,
+          wanted: subscribed
+        });
       }
       /**
       * E2: Send a `set-log-level` control message to a specific child.
@@ -130540,11 +130665,11 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
   }
 });
 
-// ../system/dist/custom-action-registry-B42MC_Pv.js
-var require_custom_action_registry_B42MC_Pv = __commonJS({
-  "../system/dist/custom-action-registry-B42MC_Pv.js"(exports) {
+// ../system/dist/custom-action-registry-DvVMHLfJ.js
+var require_custom_action_registry_DvVMHLfJ = __commonJS({
+  "../system/dist/custom-action-registry-DvVMHLfJ.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     var CustomActionRegistry = class {
       byAddon = /* @__PURE__ */ new Map();
       registerAddon(addonId, catalog, handler) {
@@ -134358,7 +134483,7 @@ var require_dist3 = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_CllKpcTd();
+    var require_dist10 = require_dist_0sWJNwme();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -134385,9 +134510,9 @@ var require_dist3 = __commonJS({
     var require_builtins_winston_logging_index = require_winston_logging();
     var require_event_loop_stall_monitor = require_event_loop_stall_monitor_CAsHdMwP();
     var require_tls$1 = require_tls_BFs4PzoW();
-    var require_manifest_system_deps = require_manifest_system_deps_DfpwaXkh();
+    var require_manifest_system_deps = require_manifest_system_deps_YYKKCKSF();
     var require_resource_monitor = require_resource_monitor_LVE1BoLs();
-    var require_custom_action_registry = require_custom_action_registry_B42MC_Pv();
+    var require_custom_action_registry = require_custom_action_registry_DvVMHLfJ();
     var zod = require_zod();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
@@ -199088,8 +199213,9 @@ ${originalIndentation}`;
             const type2 = resolvePacketType(packet[5]);
             this.emit("data", type2, msg);
             const rest = packet.slice(length);
-            this.bufs = rest.length > 0 ? [rest] : [];
-            this.bufLen = rest.length;
+            const carried = rest.length > 0 && rest.length * 8 < rest.buffer.byteLength ? Buffer.from(rest) : rest;
+            this.bufs = carried.length > 0 ? [carried] : [];
+            this.bufLen = carried.length;
           }
           cb();
         }
@@ -231696,6 +231822,14 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       * set `encodeJpeg: true`; `bytes` is then absent.
       */
       jpeg: zod.z.string().optional(),
+      /**
+      * The SAME compressed JPEG as `jpeg`, as bytes (D462). Present instead of
+      * `jpeg` when the request set `acceptJpegBytes`; a request that did not gets
+      * `jpeg` exactly as before. MsgPack and the mesh leg both carry binary —
+      * `bytes` above has crossed this boundary as a `Uint8Array` all along — so
+      * base64 was buying nothing but a multi-megabyte string in the relay's heap.
+      */
+      jpegBytes: zod.z.instanceof(Uint8Array).optional(),
       width: zod.z.number().int().positive(),
       height: zod.z.number().int().positive(),
       /**
@@ -231737,7 +231871,14 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       detail: zod.z.string().optional()
     })]);
     var ParkedTrackFrameSchema = zod.z.object({
-      jpeg: zod.z.string(),
+      /**
+      * Base64 JPEG — the pre-D462 wire. OPTIONAL since D462: a request that set
+      * `acceptJpegBytes` is answered in `jpegBytes` and this is then absent.
+      * Exactly one of the two is present.
+      */
+      jpeg: zod.z.string().optional(),
+      /** The same JPEG as bytes, for a caller that declared it reads them (D462). */
+      jpegBytes: zod.z.instanceof(Uint8Array).optional(),
       width: zod.z.number().int().positive(),
       height: zod.z.number().int().positive(),
       /** The frame instant the parcel shows (the caller's clock, echoed back). */
@@ -232393,6 +232534,13 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
           bbox: NativeCropBboxSchema,
           maxWidth: zod.z.number().int().positive().optional(),
           /**
+          * The caller reads a `Uint8Array` (D462). When set, a JPEG answer comes
+          * back in `jpegBytes` instead of base64 `jpeg`. Absent means the old
+          * wire — never assume consent: a pre-D462 caller parses the field as
+          * base64 and bytes would decode to garbage rather than fail.
+          */
+          acceptJpegBytes: zod.z.boolean().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
@@ -232565,7 +232713,14 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         getParkedTrackFrame: require_sleep.method(zod.z.object({
           deviceId: zod.z.number(),
           trackId: zod.z.string(),
-          kind: ParkedFrameKindSchema
+          kind: ParkedFrameKindSchema,
+          /**
+          * The caller reads a `Uint8Array` (D462). When set, a JPEG answer comes
+          * back in `jpegBytes` instead of base64 `jpeg`. Absent means the old
+          * wire — never assume consent: a pre-D462 caller parses the field as
+          * base64 and bytes would decode to garbage rather than fail.
+          */
+          acceptJpegBytes: zod.z.boolean().optional()
         }), ParkedTrackFrameSchema.nullable()),
         /**
         * Drop every parcel of a track — the hub closed it. Idempotent. A track
@@ -357630,8 +357785,10 @@ var require_parser2 = __commonJS({
           const type = resolvePacketType(packet[5]);
           this.emit("data", type, msg);
           const rest = packet.slice(length);
-          this.bufs = rest.length > 0 ? [rest] : [];
-          this.bufLen = rest.length;
+          const pinsTooMuch = rest.length > 0 && rest.length * 8 < rest.buffer.byteLength;
+          const carried = pinsTooMuch ? Buffer.from(rest) : rest;
+          this.bufs = carried.length > 0 ? [carried] : [];
+          this.bufLen = carried.length;
         }
         cb();
       }
@@ -413995,7 +414152,7 @@ var require_agent_addon_delivery = __commonJS({
     exports.AGENT_RELOAD_TIMEOUT_MS = exports.AGENT_DEPLOY_CONTROL_TIMEOUT_MS = void 0;
     exports.isAgentDeployResponse = isAgentDeployResponse;
     exports.deliverAddonToAgent = deliverAddonToAgent;
-    exports.AGENT_DEPLOY_CONTROL_TIMEOUT_MS = 3e4;
+    exports.AGENT_DEPLOY_CONTROL_TIMEOUT_MS = 3e5;
     exports.AGENT_RELOAD_TIMEOUT_MS = 6e4;
     function isAgentDeployResponse(value) {
       if (value === null || typeof value !== "object")

package/package.json

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