@camstack/addon-pipeline 1.2.107 → 1.2.115

package/dist/{dist-CkXAzTZ2.mjs → dist-DGQkkWc6.mjs}

@@ -9058,6 +9058,15 @@ var LabelDefinitionSchema = object({
 	description: string().optional(),
 	icon: string().optional()
 });
+var ClassMapDefinitionSchema = object({
+	mapping: record(string(), _enum([
+		"person",
+		"vehicle",
+		"animal",
+		"package"
+	])),
+	preserveOriginal: boolean()
+});
 var MODEL_FORMATS = [
 	"onnx",
 	"coreml",
@@ -9236,7 +9245,13 @@ var ModelCatalogEntrySchema = object({
 	* `id` stays the source of truth for resolution/download/persistence; grouping
 	* is a presentation overlay resolved back to an `id`.
 	*/
-	group: ModelVariantGroupSchema.optional()
+	group: ModelVariantGroupSchema.optional(),
+	/**
+	* Per-MODEL class map override. Absent ⇒ the step's `StepDefinition.classMap`
+	* applies (Frigate / COCO public catalog). Set on a custom model whose raw
+	* labels already ARE the CamStack macros (Scrypted identity map).
+	*/
+	classMap: ClassMapDefinitionSchema.optional()
 });
 var ConvertTargetSchema = discriminatedUnion("format", [object({
 	format: literal("openvino"),
@@ -9265,7 +9280,8 @@ var ModelConvertMetadataSchema = object({
 		"ocr",
 		"segmentation"
 	]),
-	faceAlignment: boolean().optional()
+	faceAlignment: boolean().optional(),
+	classMap: ClassMapDefinitionSchema.optional()
 });
 var ConvertResultSchema = object({
 	entry: ModelCatalogEntrySchema,
@@ -19049,6 +19065,33 @@ var NativeCropRefSchema = object({
 		h: number()
 	})
 });
+object({
+	crop: object({
+		left: number(),
+		top: number(),
+		width: number().positive(),
+		height: number().positive()
+	}).optional(),
+	content: object({
+		width: number().int().positive(),
+		height: number().int().positive()
+	}),
+	fit: _enum(["stretch", "contain"]),
+	format: _enum([
+		"rgb",
+		"gray",
+		"jpeg"
+	])
+});
+var FrameRefSchema = object({
+	registryId: string().min(1),
+	id: string().min(1),
+	width: number().int().positive(),
+	height: number().int().positive(),
+	format: _enum(["rgb", "gray"]),
+	timestamp: number(),
+	capturedAt: number().optional()
+});
 var ModelFormatSchema$1 = _enum([
 	"onnx",
 	"coreml",
@@ -19369,7 +19412,7 @@ var pipelineExecutorCapability = {
 		* legacy call shape used by existing benchmark code; once all
 		* callers pass it explicitly we make it required.
 		*
-		* Exactly one of `frame`, `frameHandle`, `imageBase64`,
+		* Exactly one of `frame`, `frameRef`, `frameHandle`, `imageBase64`,
 		* `referenceImage` must be provided:
 		*  - `frame`: runtime dispatch path (runner → decoded broker frame).
 		*    Carries the raw buffer, dimensions, and format; the executor
@@ -19391,6 +19434,12 @@ var pipelineExecutorCapability = {
 			steps: array(PipelineStepInputSchema).min(1),
 			frame: FrameInputSchema.optional(),
 			/**
+			* Process-local lazy frame. Valid only when caller and provider resolve
+			* in the same execution-group process; split/cross-node callers use
+			* `frame`/`image` inline compatibility instead.
+			*/
+			frameRef: FrameRefSchema.optional(),
+			/**
 			* CB5 shm passthrough — a `FrameHandle` naming the same ring slot
 			* the decoded pixels live in. One more member of the one-of
 			* frame/frameHandle/image/imageBase64/referenceImage group.
@@ -19700,7 +19749,10 @@ var NativeCropResultSchema = object({
 	* 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).
+	*   quality path). A subject-tile serve is also native-resolution and stays
+	*   `native` here: the public enum cannot name `tile` without a breaking cap
+	*   change. Runner telemetry distinguishes lease vs tile via `source` on the
+	*   internal crop result (`nativeHits` vs `tileHits`).
 	* - `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).
@@ -20191,12 +20243,41 @@ var RunnerLocalLoadSchema = object({
 * legacy `OrchestratorMetricsSchema` shape so existing dashboards keep
 * working unchanged when they switch to reading from the runner cap.
 */
+var FrameLazyCountersSchema = object({
+	framesDecoded: number(),
+	framesAdmitted: number(),
+	framesDroppedPixelFree: number(),
+	viewsMaterialized: number(),
+	viewsSkipped: number(),
+	workerToRunnerBytes: number(),
+	runnerToPoolRawBytes: number(),
+	runnerToPoolJpegBytes: number(),
+	onDemandFullFrameRequests: number(),
+	onDemandCropRequests: number(),
+	nativeHits: number(),
+	nativeMisses: number(),
+	tileHits: number(),
+	tileMisses: number(),
+	fallbackHits: number(),
+	fallbackMisses: number(),
+	retainedWritesAvoided: number(),
+	residentRefs: number(),
+	residentBytes: number(),
+	releases: number(),
+	evictions: number(),
+	staleMisses: number()
+});
+var FrameLazyMetricsSchema = object({
+	node: FrameLazyCountersSchema,
+	cameras: array(FrameLazyCountersSchema.extend({ deviceId: number() }))
+});
 var RunnerLocalMetricsSchema = object({
 	nodeId: string(),
 	activeCameras: number(),
 	throttledCameras: number(),
 	avgInferenceTimeMs: number(),
-	queueDepth: number()
+	queueDepth: number(),
+	frameLazy: FrameLazyMetricsSchema.optional()
 });
 /**
 * Pipeline Runner capability — runtime detection workhorse.
@@ -21653,6 +21734,9 @@ method(_void(), ProviderInfoSchema), method(object({ config: record(string(), un
 	location: StorageLocationSchema,
 	relativePath: string()
 }), _void(), { kind: "mutation" }), method(object({ location: StorageLocationSchema }), number().nullable()), method(BeginUploadInputSchema, BeginUploadResultSchema, { kind: "mutation" }), method(WriteChunkInputSchema, _void(), { kind: "mutation" }), method(FinalizeUploadInputSchema, _void(), { kind: "mutation" }), method(AbortUploadInputSchema, _void(), { kind: "mutation" }), method(BeginDownloadInputSchema, BeginDownloadResultSchema, { kind: "mutation" }), method(ReadChunkInputSchema, _instanceof(Uint8Array)), method(EndDownloadInputSchema, _void(), { kind: "mutation" });
+/** Profile-exported FormBuilder schema. Shape is ConfigUISchema at the UI. */
+var ProfileSettingsSchemaBridge = unknown().nullable();
+var ProfileSettingsBagSchema = record(string(), unknown());
 /**
 * A live terminal session hosted by the provider addon. Output and input do
 * NOT flow through the capability — they use the addon data plane
@@ -21687,7 +21771,9 @@ var TerminalProfileInfoSchema = object({
 	executable: string().optional(),
 	args: array(string()).readonly().optional(),
 	cwd: string().optional(),
-	environment: array(string()).readonly().optional()
+	environment: array(string()).readonly().optional(),
+	/** ConfigUISchema for instance knobs, or null when the profile has none. */
+	settingsSchema: ProfileSettingsSchemaBridge.optional()
 });
 /**
 * A durable operator-created Terminal instance. Profiles are templates; only
@@ -21704,7 +21790,8 @@ var TerminalInstanceInfoSchema = object({
 	executable: string(),
 	args: array(string()).readonly(),
 	cwd: string(),
-	environment: array(string()).readonly()
+	environment: array(string()).readonly(),
+	profileSettings: ProfileSettingsBagSchema
 });
 var TerminalLegacyCameraSchema = object({
 	stableId: string(),
@@ -21738,7 +21825,8 @@ method(_void(), array(TerminalProfileInfoSchema).readonly(), { auth: "admin" }),
 	executable: string().max(1024).optional(),
 	args: array(string().max(2048)).max(64).optional(),
 	cwd: string().max(1024).optional(),
-	environment: array(string().max(4096)).max(64).optional()
+	environment: array(string().max(4096)).max(64).optional(),
+	profileSettings: ProfileSettingsBagSchema.optional()
 }), TerminalInstanceInfoSchema, {
 	kind: "mutation",
 	auth: "admin"
@@ -21748,7 +21836,8 @@ method(_void(), array(TerminalProfileInfoSchema).readonly(), { auth: "admin" }),
 	executable: string().max(1024).optional(),
 	args: array(string().max(2048)).max(64).optional(),
 	cwd: string().max(1024).optional(),
-	environment: array(string().max(4096)).max(64).optional()
+	environment: array(string().max(4096)).max(64).optional(),
+	profileSettings: ProfileSettingsBagSchema.optional()
 }), TerminalInstanceInfoSchema, {
 	kind: "mutation",
 	auth: "admin"
@@ -24703,10 +24792,10 @@ DeviceType.LawnMower, method(object({ deviceId: number().int().nonnegative() }),
 *
 *  • The SDK (mobile / web client) consumes `getConnectionEndpoints()`
 *    to receive an ordered list of candidate base URLs it should race
-*    on connect — LAN IPv4 first (lowest latency when on same network),
-*    then public hostname (if a tunnel is up), then IPv6. The SDK can
-*    race them with short timeouts and stick with the winner for the
-*    session.
+*    on connect — LAN IPv4 and stable LAN IPv6 first (lowest latency
+*    when on the same network), then public hostname (if a tunnel is
+*    up). The SDK can race them with short timeouts and stick with the
+*    winner for the session.
 *
 * Why hub-only: agents are not directly addressable by the operator's
 * clients — they reverse-connect to the hub. Exposing their interfaces
@@ -24861,6 +24950,17 @@ var NotificationEndpointSchema = object({
 	/** What the ranking currently resolves to (null when nothing is reachable). */
 	resolved: string().nullable()
 });
+/**
+* The URLs the SDK / viewer should race for API access. `baseUrls` empty =
+* AUTO (every LAN IPv4 + the public tunnel). `resolved` is what that choice
+* currently expands to, so the UI can show the effective set either way.
+*/
+var ViewerEndpointsSchema = object({
+	/** The operator's explicit race set, or empty for AUTO. */
+	baseUrls: array(string()).readonly(),
+	/** What the ranking currently resolves to (may be empty if nothing is up). */
+	resolved: array(string()).readonly()
+});
 var AllowedAddressesSchema = object({ 
 /**
 * Allowlist of interface addresses operators have explicitly opted
@@ -24892,17 +24992,18 @@ method(_void(), ListResultSchema), method(_void(), PreferredSchema), method(obje
 	*/
 	port: number().int().min(1).max(65535).optional(),
 	/** Include `http(s)://127.0.0.1:<port>` as the lowest-priority
-	*  candidate. Default `true`. */
+	*  candidate. Default `false` — loopback is not a client route. */
 	includeLoopback: boolean().optional(),
-	/** Skip IPv6 entries. Some legacy clients can't parse them.
-	*  Default `false`. */
+	/** Skip IPv6 entries. Default `false` — the palette includes stable
+	*  LAN IPv6 (ICE/WebRTC uses dual-stack regardless). Pass `true` to
+	*  hide them. The viewer HTTP/WS race is `getViewerEndpoints`. */
 	ipv4Only: boolean().optional(),
 	/** Scheme to emit for LAN/loopback URLs. Default `'http'`.
 	*  Pass `'https'` when the caller is itself loaded over HTTPS
 	*  to avoid mixed-content blocks in the browser. The public
 	*  tunnel always emits `https://` regardless. */
 	scheme: _enum(["http", "https"]).optional()
-}), GetConnectionEndpointsResultSchema), method(_void(), NotificationEndpointSchema), method(object({ baseUrl: string().nullable() }), NotificationEndpointSchema, { kind: "mutation" }), method(_void(), AllowedAddressesSchema), method(AllowedAddressesSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), AllowedAddressesSchema, { kind: "mutation" }), method(_void(), TlsStatusSchema), method(object({ reason: string().optional() }), TlsStatusSchema, {
+}), GetConnectionEndpointsResultSchema), method(_void(), NotificationEndpointSchema), method(object({ baseUrl: string().nullable() }), NotificationEndpointSchema, { kind: "mutation" }), method(_void(), ViewerEndpointsSchema), method(object({ baseUrls: array(string()).readonly() }), ViewerEndpointsSchema, { kind: "mutation" }), method(_void(), AllowedAddressesSchema), method(AllowedAddressesSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), AllowedAddressesSchema, { kind: "mutation" }), method(_void(), TlsStatusSchema), method(object({ reason: string().optional() }), TlsStatusSchema, {
 	kind: "mutation",
 	auth: "admin"
 }), method(object({
@@ -30886,6 +30987,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"localNetwork.getViewerEndpoints": {
+		capName: "local-network",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"localNetwork.list": {
 		capName: "local-network",
 		capScope: "system",
@@ -30922,6 +31029,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"localNetwork.setViewerEndpoints": {
+		capName: "local-network",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"localNetwork.uploadCertificate": {
 		capName: "local-network",
 		capScope: "system",

package/dist/{event-loop-stall-monitor-fHkfgmlw.mjs → event-loop-stall-monitor-D5jK5v4Z.mjs}

@@ -1,4 +1,5 @@
-import { K as hfModelUrl, a as COCO_80_LABELS, j as audioKindId, o as COCO_TO_MACRO, r as AUDIO_MACRO_LABELS } from "./dist-CkXAzTZ2.mjs";
+import { K as hfModelUrl, a as COCO_80_LABELS, j as audioKindId, o as COCO_TO_MACRO, r as AUDIO_MACRO_LABELS } from "./dist-DGQkkWc6.mjs";
+import { randomUUID } from "node:crypto";
 import { PerformanceObserver } from "node:perf_hooks";
 //#region src/detection-pipeline/registry/model-catalogs.ts
 var HF_REPO = "camstack/camstack-models";
@@ -1890,6 +1891,226 @@ function resolveModelForFormat(stepId, chosenModelId, format) {
 	return getDefaultModelForFormat(stepId, format);
 }
 //#endregion
+//#region src/session-decode/frame-view-geometry.ts
+function positiveInteger(value, label) {
+	if (!Number.isFinite(value) || value <= 0) throw new Error(`${label} must be positive`);
+	return Math.max(1, Math.round(value));
+}
+function clampCrop(sourceWidth, sourceHeight, crop) {
+	if (!crop) return {
+		left: 0,
+		top: 0,
+		width: sourceWidth,
+		height: sourceHeight
+	};
+	const left = Math.max(0, Math.min(sourceWidth - 1, Math.floor(crop.left)));
+	const top = Math.max(0, Math.min(sourceHeight - 1, Math.floor(crop.top)));
+	const right = Math.max(left + 1, Math.min(sourceWidth, Math.ceil(crop.left + crop.width)));
+	const bottom = Math.max(top + 1, Math.min(sourceHeight, Math.ceil(crop.top + crop.height)));
+	return {
+		left,
+		top,
+		width: right - left,
+		height: bottom - top
+	};
+}
+/** Pure geometry for worker-side crop/resize without model padding. */
+function resolveFrameViewGeometry(sourceWidthInput, sourceHeightInput, spec) {
+	const sourceWidth = positiveInteger(sourceWidthInput, "source width");
+	const sourceHeight = positiveInteger(sourceHeightInput, "source height");
+	const targetWidth = positiveInteger(spec.content.width, "content width");
+	const targetHeight = positiveInteger(spec.content.height, "content height");
+	const sourceCrop = clampCrop(sourceWidth, sourceHeight, spec.crop);
+	const output = spec.fit === "stretch" ? {
+		width: targetWidth,
+		height: targetHeight
+	} : (() => {
+		const scale = Math.min(targetWidth / sourceCrop.width, targetHeight / sourceCrop.height);
+		return {
+			width: Math.max(1, Math.round(sourceCrop.width * scale)),
+			height: Math.max(1, Math.round(sourceCrop.height * scale))
+		};
+	})();
+	return {
+		source: {
+			width: sourceWidth,
+			height: sourceHeight
+		},
+		sourceCrop,
+		output,
+		scale: {
+			x: output.width / sourceCrop.width,
+			y: output.height / sourceCrop.height
+		}
+	};
+}
+//#endregion
+//#region src/session-decode/local-frame-registry.ts
+var DEFAULT_MAX_FRAMES = 24;
+var DEFAULT_MAX_BYTES = 512 * 1024 * 1024;
+function estimateFrameBytes(image) {
+	return image.width * image.height * (image.format === "gray" ? 1 : 3);
+}
+function releasesNative(reason) {
+	return reason !== "success";
+}
+/**
+* Bounded process-local registry. A serialized ref from another process misses
+* by registry id; an evicted id never aliases a newer frame. View resolution
+* is lease-only ({@link acquire} → {@link LocalFrameLease.resolve}) so an
+* in-flight `toBuffer()` is covered by `refs > 1` and cannot be LRU-evicted.
+*/
+var LocalFrameRegistry = class {
+	registryId;
+	maxFrames;
+	maxBytes;
+	entries = /* @__PURE__ */ new Map();
+	bytes = 0;
+	releaseCount = 0;
+	evictionCount = 0;
+	staleMissCount = 0;
+	constructor(options = {}) {
+		this.registryId = options.registryId ?? `${process.pid}-${randomUUID()}`;
+		this.maxFrames = options.maxFrames ?? DEFAULT_MAX_FRAMES;
+		this.maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+	}
+	get size() {
+		return this.entries.size;
+	}
+	get estimatedBytes() {
+		return this.bytes;
+	}
+	getStats() {
+		let residentRefs = 0;
+		for (const entry of this.entries.values()) residentRefs += entry.refs;
+		return {
+			residentFrames: this.entries.size,
+			residentRefs,
+			residentBytes: this.bytes,
+			releases: this.releaseCount,
+			evictions: this.evictionCount,
+			staleMisses: this.staleMissCount
+		};
+	}
+	register(image, metadata) {
+		const estimatedBytes = estimateFrameBytes(image);
+		if (this.maxFrames < 1 || estimatedBytes > this.maxBytes) {
+			image.close();
+			image.releaseNativeLease?.();
+			return null;
+		}
+		const ref = {
+			registryId: this.registryId,
+			id: randomUUID(),
+			width: image.width,
+			height: image.height,
+			format: image.format,
+			timestamp: metadata.timestamp,
+			...metadata.capturedAt !== void 0 ? { capturedAt: metadata.capturedAt } : {}
+		};
+		this.entries.set(ref.id, {
+			ref,
+			image,
+			estimatedBytes,
+			refs: 1,
+			releaseNativeOnClose: false
+		});
+		this.bytes += estimatedBytes;
+		this.evictToBounds();
+		return this.entries.has(ref.id) ? ref : null;
+	}
+	acquire(ref) {
+		if (ref.registryId === this.registryId && !this.entries.has(ref.id)) this.staleMissCount += 1;
+		const entry = this.getEntry(ref);
+		if (!entry) return null;
+		entry.refs += 1;
+		this.touch(entry);
+		let released = false;
+		return {
+			resolve: (spec) => this.resolveFromLease(entry, spec),
+			release: (reason) => {
+				if (released) return;
+				released = true;
+				this.release(ref, reason);
+			}
+		};
+	}
+	release(ref, reason) {
+		const entry = this.getEntry(ref);
+		if (!entry) return;
+		this.releaseCount += 1;
+		if (releasesNative(reason)) entry.releaseNativeOnClose = true;
+		entry.refs = Math.max(0, entry.refs - 1);
+		if (entry.refs === 0) this.drop(entry);
+	}
+	clear(reason = "detach") {
+		for (const entry of [...this.entries.values()]) {
+			if (releasesNative(reason)) entry.releaseNativeOnClose = true;
+			this.drop(entry);
+		}
+	}
+	getEntry(ref) {
+		if (ref.registryId !== this.registryId) return null;
+		return this.entries.get(ref.id) ?? null;
+	}
+	touch(entry) {
+		this.entries.delete(entry.ref.id);
+		this.entries.set(entry.ref.id, entry);
+	}
+	/**
+	* Materialize a view for a live lease only. Public callers must go through
+	* {@link acquire} so `refs > 1` covers the whole `toBuffer()` window.
+	*/
+	async resolveFromLease(entry, spec) {
+		if (!this.entries.has(entry.ref.id)) return {
+			kind: "miss",
+			reason: "stale-ref"
+		};
+		this.touch(entry);
+		const geometry = resolveFrameViewGeometry(entry.image.width, entry.image.height, spec);
+		return {
+			kind: "view",
+			data: await entry.image.toBuffer({
+				crop: geometry.sourceCrop,
+				resize: geometry.output,
+				format: spec.format
+			}),
+			width: geometry.output.width,
+			height: geometry.output.height,
+			format: spec.format,
+			geometry
+		};
+	}
+	/** Oldest owner-only / queued entry (`refs === 1`). Consumer leases (`refs > 1`) stay. */
+	findOwnerOnlyVictim() {
+		for (const entry of this.entries.values()) if (entry.refs <= 1) return entry;
+	}
+	evictToBounds() {
+		while (this.entries.size > this.maxFrames || this.bytes > this.maxBytes) {
+			const victim = this.findOwnerOnlyVictim();
+			if (!victim) break;
+			victim.releaseNativeOnClose = true;
+			this.evictionCount += 1;
+			this.drop(victim);
+		}
+	}
+	drop(entry) {
+		if (!this.entries.delete(entry.ref.id)) return;
+		this.bytes = Math.max(0, this.bytes - entry.estimatedBytes);
+		entry.image.close();
+		if (entry.releaseNativeOnClose) entry.image.releaseNativeLease?.();
+	}
+};
+function envPositiveInt(name, fallback) {
+	const parsed = Number(process.env[name]);
+	return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : fallback;
+}
+/** Shared only by addons in the same grouped runner process. */
+var localFrameRegistry = new LocalFrameRegistry({
+	maxFrames: envPositiveInt("CAMSTACK_LOCAL_FRAME_MAX_FRAMES", DEFAULT_MAX_FRAMES),
+	maxBytes: envPositiveInt("CAMSTACK_LOCAL_FRAME_BUDGET_MB", DEFAULT_MAX_BYTES / 1048576) * 1048576
+});
+//#endregion
 //#region src/detection-pipeline/diagnostics/event-loop-stall-monitor.ts
 /**
 * event-loop-stall-monitor — names the thing that freezes the detection process.
@@ -2026,4 +2247,4 @@ function startEventLoopStallMonitor(logger, reportThresholdMs = STALL_REPORT_MS)
 	};
 }
 //#endregion
-export { getDefaultModelForFormat as a, getStepDefinition as c, ALL_STEPS as i, resolveModelForFormat as l, startEventLoopStallMonitor as n, getDefaultModelForFormatFromDef as o, ALL_PIPELINE_STEPS as r, getStep as s, attributeStall as t, landmarkPrecisionVerdict as u };
+export { ALL_PIPELINE_STEPS as a, getDefaultModelForFormatFromDef as c, resolveModelForFormat as d, landmarkPrecisionVerdict as f, resolveFrameViewGeometry as i, getStep as l, startEventLoopStallMonitor as n, ALL_STEPS as o, localFrameRegistry as r, getDefaultModelForFormat as s, attributeStall as t, getStepDefinition as u };