@camstack/system 1.2.55 → 1.2.57

package/dist/builtins/system-config/system-config.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CblJsHb-.js");
+const require_dist = require("../../dist-BupxnZOi.js");
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/system-config/system-config.addon.mjs

@@ -1,4 +1,4 @@
-import { Ot as hydrateSchema, dt as BaseAddon, ut as errMsg } from "../../dist-BOpRqInW.mjs";
+import { Ot as hydrateSchema, dt as BaseAddon, ut as errMsg } from "../../dist-DhL_zGRT.mjs";
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/winston-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CblJsHb-.js");
+const require_dist = require("../../dist-BupxnZOi.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);

package/dist/builtins/winston-logging/index.mjs

@@ -1,4 +1,4 @@
-import { U as logDestinationCapability, dt as BaseAddon } from "../../dist-BOpRqInW.mjs";
+import { U as logDestinationCapability, dt as BaseAddon } from "../../dist-DhL_zGRT.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";

package/dist/{dist-CblJsHb-.js → dist-BupxnZOi.js}

@@ -12825,14 +12825,6 @@ var RebuildObjectEmbeddingsInput = zod.z.object({
 	deviceId: zod.z.number().optional(),
 	since: zod.z.number().optional(),
 	until: zod.z.number().optional(),
-	/**
-	* Fraction added on EACH side of the detection box before cropping.
-	* ~0.2 (a 1.4x window) gives CLIP the surroundings it is trained on; 0 is
-	* the pixel-tight crop the first implementation used.
-	*/
-	cropMargin: zod.z.number().min(0).max(4).optional(),
-	/** Square the window before extracting, so a tall subject is not squashed. */
-	square: zod.z.boolean().optional(),
 	/** Stop after this many tracks; the result reports whether more remain. */
 	maxTracks: zod.z.number().int().positive().optional()
 });
@@ -12867,6 +12859,14 @@ var RebuildStatusSchema = zod.z.object({
 	missingKeyFrame: zod.z.number(),
 	/** Tracks with no usable detection box. */
 	missingBbox: zod.z.number(),
+	/**
+	* Tracks the pipeline REFUSED rather than broke on: the camera is not
+	* attached, or `clip-embedding` is not enabled in its step tree. Separate
+	* from `failed` because the remedy is a configuration change, not an engine
+	* investigation — and because a pass over decommissioned cameras would
+	* otherwise read as a total engine outage.
+	*/
+	notRunnable: zod.z.number(),
 	failed: zod.z.number(),
 	/** Set once a pass ends: true only when EVERYTHING was covered. */
 	complete: zod.z.boolean().nullable(),
@@ -14338,16 +14338,44 @@ var pipelineRunnerCapability = {
 		* for a single tracked detection. The per-frame plane (`runPipeline`
 		* with `plane: 'frame'`) skips crop children entirely; a track-level
 		* caller invokes this per-track, on its own cadence, instead of on
-		* every frame. Takes either a `frameHandle` (shm lease/session —
-		* preferred, zero-copy) or a `cropJpeg` fallback when the lease/
-		* session backing the frame is already gone. `steps` narrows which
-		* configured children to run (default: all configured children for
-		* `parent.className`). Returns `null` when neither frame source is
-		* resolvable (handle evicted and no cropJpeg fallback supplied).
+		* every frame. `steps` narrows which configured children to run
+		* (default: all configured children for `parent.className`).
+		*
+		* ## Three pixel sources, and WHO decides the rectangle
+		*
+		* Tried in this order; the difference between them is not the pixels but
+		* which side derives the crop, and confusing the two is how the CLIP index
+		* ended up holding two incomparable feature spaces:
+		*
+		* 1. `frameHandle` — shm lease/session, preferred and zero-copy. **The
+		*    runner cuts**, applying the cluster crop convention.
+		* 2. `frameJpeg` — a FULL FRAME supplied by the caller (the embedding
+		*    rebuild's stored key frame). **The runner cuts**, applying the same
+		*    convention to the same function, so a rebuilt vector lands in the same
+		*    feature space as a live one.
+		* 3. `cropJpeg` — an ALREADY-CUT tile. **The caller decided the
+		*    rectangle**; the runner applies NO padding and no squaring and feeds
+		*    it to the model verbatim. Only for the lease-miss retry, where the
+		*    caller holds pixels the runner can no longer reach.
+		*
+		* Returns `null` when no source resolves (handle evicted and no fallback
+		* supplied), when the camera is not attached, or when no enabled step
+		* matches — every one of those is logged on the runner with the deviceId.
 		*/
 		runDetailSubtree: method(zod.z.object({
 			deviceId: zod.z.number(),
 			frameHandle: FrameHandleSchema.optional(),
+			/**
+			* FULL FRAME (base64 JPEG). The runner derives the crop rectangle from
+			* `parent.bbox` with the cluster crop convention and cuts it itself —
+			* do NOT pre-crop for this field, that is what `cropJpeg` is.
+			*/
+			frameJpeg: zod.z.string().optional(),
+			/**
+			* PRE-CUT tile (base64 JPEG), used verbatim — NO padding is applied.
+			* The fallback when the lease/session backing the frame is gone and the
+			* caller already holds a crop.
+			*/
 			cropJpeg: zod.z.string().optional(),
 			parent: DetailParentSchema,
 			steps: zod.z.array(zod.z.string()).optional()
@@ -30307,6 +30335,30 @@ function decodeVectorBase64(encoded) {
 function vectorDimFromBase64(encoded) {
 	return Math.floor(Buffer.from(encoded, "base64").byteLength / 4);
 }
+zod.z.object({
+	/**
+	* Fraction of the box's own size added on EACH side before cutting.
+	*
+	* CLIP is trained on natural images WITH surroundings; a pixel-tight crop
+	* removes exactly the context it is strongest on (a dog cut to its outline
+	* is a dark blob). The right value is an empirical question, which is why it
+	* is a setting: 0 / 0.15 / 0.2 / 0.5 are the interesting points.
+	*/
+	paddingRatio: zod.z.number().min(0).max(4),
+	/**
+	* Square the window (in PIXELS) before cutting.
+	*
+	* CLIP's input is square, so a tall bbox resized straight to NxN is squashed
+	* — a standing person becomes a shape the model never saw. Squaring costs
+	* extra background, which is context the model wants anyway. Off by default
+	* because the live path has never squared and the stored index reflects that.
+	*/
+	square: zod.z.boolean()
+});
+({
+	paddingRatio: .15,
+	square: false
+}).paddingRatio;
 /**
 * Scores all applicable inference backends for the given hardware.
 *

package/dist/{dist-BOpRqInW.mjs → dist-DhL_zGRT.mjs}

@@ -12825,14 +12825,6 @@ var RebuildObjectEmbeddingsInput = z.object({
 	deviceId: z.number().optional(),
 	since: z.number().optional(),
 	until: z.number().optional(),
-	/**
-	* Fraction added on EACH side of the detection box before cropping.
-	* ~0.2 (a 1.4x window) gives CLIP the surroundings it is trained on; 0 is
-	* the pixel-tight crop the first implementation used.
-	*/
-	cropMargin: z.number().min(0).max(4).optional(),
-	/** Square the window before extracting, so a tall subject is not squashed. */
-	square: z.boolean().optional(),
 	/** Stop after this many tracks; the result reports whether more remain. */
 	maxTracks: z.number().int().positive().optional()
 });
@@ -12867,6 +12859,14 @@ var RebuildStatusSchema = z.object({
 	missingKeyFrame: z.number(),
 	/** Tracks with no usable detection box. */
 	missingBbox: z.number(),
+	/**
+	* Tracks the pipeline REFUSED rather than broke on: the camera is not
+	* attached, or `clip-embedding` is not enabled in its step tree. Separate
+	* from `failed` because the remedy is a configuration change, not an engine
+	* investigation — and because a pass over decommissioned cameras would
+	* otherwise read as a total engine outage.
+	*/
+	notRunnable: z.number(),
 	failed: z.number(),
 	/** Set once a pass ends: true only when EVERYTHING was covered. */
 	complete: z.boolean().nullable(),
@@ -14338,16 +14338,44 @@ var pipelineRunnerCapability = {
 		* for a single tracked detection. The per-frame plane (`runPipeline`
 		* with `plane: 'frame'`) skips crop children entirely; a track-level
 		* caller invokes this per-track, on its own cadence, instead of on
-		* every frame. Takes either a `frameHandle` (shm lease/session —
-		* preferred, zero-copy) or a `cropJpeg` fallback when the lease/
-		* session backing the frame is already gone. `steps` narrows which
-		* configured children to run (default: all configured children for
-		* `parent.className`). Returns `null` when neither frame source is
-		* resolvable (handle evicted and no cropJpeg fallback supplied).
+		* every frame. `steps` narrows which configured children to run
+		* (default: all configured children for `parent.className`).
+		*
+		* ## Three pixel sources, and WHO decides the rectangle
+		*
+		* Tried in this order; the difference between them is not the pixels but
+		* which side derives the crop, and confusing the two is how the CLIP index
+		* ended up holding two incomparable feature spaces:
+		*
+		* 1. `frameHandle` — shm lease/session, preferred and zero-copy. **The
+		*    runner cuts**, applying the cluster crop convention.
+		* 2. `frameJpeg` — a FULL FRAME supplied by the caller (the embedding
+		*    rebuild's stored key frame). **The runner cuts**, applying the same
+		*    convention to the same function, so a rebuilt vector lands in the same
+		*    feature space as a live one.
+		* 3. `cropJpeg` — an ALREADY-CUT tile. **The caller decided the
+		*    rectangle**; the runner applies NO padding and no squaring and feeds
+		*    it to the model verbatim. Only for the lease-miss retry, where the
+		*    caller holds pixels the runner can no longer reach.
+		*
+		* Returns `null` when no source resolves (handle evicted and no fallback
+		* supplied), when the camera is not attached, or when no enabled step
+		* matches — every one of those is logged on the runner with the deviceId.
 		*/
 		runDetailSubtree: method(z.object({
 			deviceId: z.number(),
 			frameHandle: FrameHandleSchema.optional(),
+			/**
+			* FULL FRAME (base64 JPEG). The runner derives the crop rectangle from
+			* `parent.bbox` with the cluster crop convention and cuts it itself —
+			* do NOT pre-crop for this field, that is what `cropJpeg` is.
+			*/
+			frameJpeg: z.string().optional(),
+			/**
+			* PRE-CUT tile (base64 JPEG), used verbatim — NO padding is applied.
+			* The fallback when the lease/session backing the frame is gone and the
+			* caller already holds a crop.
+			*/
 			cropJpeg: z.string().optional(),
 			parent: DetailParentSchema,
 			steps: z.array(z.string()).optional()
@@ -30307,6 +30335,30 @@ function decodeVectorBase64(encoded) {
 function vectorDimFromBase64(encoded) {
 	return Math.floor(Buffer.from(encoded, "base64").byteLength / 4);
 }
+z.object({
+	/**
+	* Fraction of the box's own size added on EACH side before cutting.
+	*
+	* CLIP is trained on natural images WITH surroundings; a pixel-tight crop
+	* removes exactly the context it is strongest on (a dog cut to its outline
+	* is a dark blob). The right value is an empirical question, which is why it
+	* is a setting: 0 / 0.15 / 0.2 / 0.5 are the interesting points.
+	*/
+	paddingRatio: z.number().min(0).max(4),
+	/**
+	* Square the window (in PIXELS) before cutting.
+	*
+	* CLIP's input is square, so a tall bbox resized straight to NxN is squashed
+	* — a standing person becomes a shape the model never saw. Squaring costs
+	* extra background, which is context the model wants anyway. Off by default
+	* because the live path has never squared and the stored index reflects that.
+	*/
+	square: z.boolean()
+});
+({
+	paddingRatio: .15,
+	square: false
+}).paddingRatio;
 /**
 * Scores all applicable inference backends for the given hardware.
 *

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-CblJsHb-.js");
+const require_dist = require("./dist-BupxnZOi.js");
 const require_model_download_service = require("./model-download-service-hf0ookyy.js");
 const require_manifest_python_deps = require("./manifest-python-deps-BqE5j0-O.js");
 const require_resource_monitor = require("./resource-monitor-DNNomR-i.js");

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { a as __toCommonJS, i as __require, n as __esmMin, o as __toESM$1, r as __exportAll, t as __commonJSMin$1 } from "./chunk-CNf5ZN-e.mjs";
-import { B as kebabToCamel, Ct as asString$1, Dt as expandCapMethods, Ft as scopeKey, G as looseSchema, I as isArrayOutputSchema, J as objectInputDeclaresAddonId, L as isCollectionArrayMethod, Lt as EventCategory$1, Mt as parseJsonUnknown$1, N as extractNestedAddonId, Nt as readinessKey, Pt as resolveCapMount, R as isObjectInput, St as asNumber, Tt as emitDownForOwnedCaps, V as lifecycleJobSchema, W as logLevelAtMost, Z as procedureAuthKey, c as METHOD_ACCESS_MAP, ft as DATAPLANE_SECRET_HEADER$1, h as addonSettingsCapability, jt as parseJsonObject, l as RUNTIME_DEFAULTS, mt as DEVICE_STATUS_METHOD, pt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, t as ALL_CAPABILITY_DEFINITIONS, ut as errMsg$1, vt as ReadinessRegistry, wt as createEvent, xt as asJsonObject$1, yt as ReadinessTimeoutError, z as isVoidInput } from "./dist-BOpRqInW.mjs";
+import { B as kebabToCamel, Ct as asString$1, Dt as expandCapMethods, Ft as scopeKey, G as looseSchema, I as isArrayOutputSchema, J as objectInputDeclaresAddonId, L as isCollectionArrayMethod, Lt as EventCategory$1, Mt as parseJsonUnknown$1, N as extractNestedAddonId, Nt as readinessKey, Pt as resolveCapMount, R as isObjectInput, St as asNumber, Tt as emitDownForOwnedCaps, V as lifecycleJobSchema, W as logLevelAtMost, Z as procedureAuthKey, c as METHOD_ACCESS_MAP, ft as DATAPLANE_SECRET_HEADER$1, h as addonSettingsCapability, jt as parseJsonObject, l as RUNTIME_DEFAULTS, mt as DEVICE_STATUS_METHOD, pt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, t as ALL_CAPABILITY_DEFINITIONS, ut as errMsg$1, vt as ReadinessRegistry, wt as createEvent, xt as asJsonObject$1, yt as ReadinessTimeoutError, z as isVoidInput } from "./dist-DhL_zGRT.mjs";
 import { a as downloadModel, c as getModelFilePath, d as contentTypeFor, f as createAuthenticatedFileServer, h as resolveFilePath, i as downloadFile, l as isModelDownloaded, m as parseTokenizedUrl, n as collectModelFiles, o as ensureModel, p as parseRangeHeader, r as deleteModelFromDisk, s as fetchJson, t as ModelDownloadService, u as createFileDataPlaneHandler } from "./model-download-service-Cp9f4dk6.mjs";
 import { $ as buildNativeCapProxy, A as createHubCapForwardService, B as AGENT_CAP_FWD_ACTION, C as brokerTransportLink, Ct as resolveAddonClass, D as localProviderLink, E as ipcParentLink, F as createUdsLogger, G as callWithServiceDiscovery, H as CapRouteResolver, I as createUdsLoggerWithControl, J as UdsLocalTransportServer, K as createLocalTransport, L as LocalChildClient, M as createUdsEventBridge, N as createUdsEventBus, O as HUB_CAP_FWD_ACTION, P as udsChildLogToWorkerEntry, Q as encodeFrame, R as LocalChildRegistry, S as brokerCallForCap, St as runNpm, T as ipcChildLink, U as CapRouteError, V as AGENT_CAP_FWD_SERVICE, W as classifyCapRoute, X as localEndpointPath, Y as SocketChannel, Z as FrameDecoder, _ as createKernelHwAccel, _t as CapabilityHandle, a as getWorkerDeviceRegistry, b as __resetCapUsageRegistryForTests, bt as installManifestNativeDeps, c as setHubConnected, ct as NATIVE_PROVIDER_SERVICE_INFIX, d as getBrokerEventBus, dt as capBareAction, et as buildUdsNativeCapProxy, f as getMoleculerEventStats, ft as capServiceName, g as AddonDepsManager, gt as DeviceRegistry, h as subscribePassthrough, ht as serializeTypedArrays, i as createUdsAddonContext, it as mountNativeCapService, j as createParentUnownedCallHandler, k as HUB_CAP_FWD_SERVICE, l as EVENT_TOPIC_PREFIX, lt as capActionName, m as setNodeEventInterest, mt as deserializeTypedArrays, n as adaptBrokerToCluster, o as getOrInitReadinessRegistry, ot as createAddonService, p as registerEventBusService, pt as parseCapAction, q as UdsLocalTransportClient, r as createAddonContext, s as getOrInitReadinessRegistryForClient, st as validateProviderRegistrations, t as installManifestPythonDeps, tt as createBrokerDeviceManagerApi, u as clusterEventTopic, ut as capActionSuffix, v as resolveHwAccel, vt as CapabilityUnavailableError, w as buildLinkChain, wt as createAddonDataPlaneFacility, x as getCapUsageRegistry, xt as resolveNpmInvocation, y as CapUsageRegistry, yt as copyBundledNativeModules, z as UDS_NO_ROUTE_PREFIX } from "./manifest-python-deps-Ck4-9K9m.mjs";
 import { n as getSinglePidStats, t as getPidStats } from "./resource-monitor-BkP504Vq.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.55",
+  "version": "1.2.57",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",