@camstack/types 1.2.222 → 1.2.224

package/dist/{canonical-hash-C5pB-QV1.mjs → canonical-hash-CvL03d3i.mjs}

@@ -57,6 +57,7 @@ function buildInputArgs(input, decodeHwAccel) {
 	const args = [];
 	if (!isSoftwareDecode(decodeHwAccel)) args.push("-hwaccel", String(decodeHwAccel));
 	if (input.extraArgs?.length) args.push(...input.extraArgs);
+	if (input.decodeThreadCount !== void 0 && input.decodeThreadCount > 0) args.push("-threads", String(input.decodeThreadCount));
 	if (input.analyzeDurationUs !== void 0) args.push("-analyzeduration", String(input.analyzeDurationUs));
 	if (input.probeSizeBytes !== void 0) args.push("-probesize", String(input.probeSizeBytes));
 	if (input.lowDelay === true) args.push("-flags", "low_delay");
@@ -327,7 +328,7 @@ function buildFfmpegArgs(inv) {
 		...(inv.extraInputs ?? []).flatMap((extra) => buildInputArgs(extra, inv.decodeHwAccel)),
 		...graph ? ["-filter_complex", graph.graph] : []
 	];
-	const threadArgs = inv.threadCount > 0 ? ["-threads", String(inv.threadCount)] : [];
+	const threadArgs = [...inv.threadCount > 0 ? ["-threads", String(inv.threadCount)] : [], ...inv.filterThreadCount !== void 0 && inv.filterThreadCount > 0 ? ["-filter_threads", String(inv.filterThreadCount)] : []];
 	const maps = resolveStreamMaps(inv);
 	const videoMapArgs = maps.video ? ["-map", maps.video] : [];
 	const audioMapArgs = maps.audio ? ["-map", maps.audio] : [];

package/dist/{canonical-hash-BS9dQmcQ.js → canonical-hash-DYsYm8is.js}

@@ -57,6 +57,7 @@ function buildInputArgs(input, decodeHwAccel) {
 	const args = [];
 	if (!isSoftwareDecode(decodeHwAccel)) args.push("-hwaccel", String(decodeHwAccel));
 	if (input.extraArgs?.length) args.push(...input.extraArgs);
+	if (input.decodeThreadCount !== void 0 && input.decodeThreadCount > 0) args.push("-threads", String(input.decodeThreadCount));
 	if (input.analyzeDurationUs !== void 0) args.push("-analyzeduration", String(input.analyzeDurationUs));
 	if (input.probeSizeBytes !== void 0) args.push("-probesize", String(input.probeSizeBytes));
 	if (input.lowDelay === true) args.push("-flags", "low_delay");
@@ -327,7 +328,7 @@ function buildFfmpegArgs(inv) {
 		...(inv.extraInputs ?? []).flatMap((extra) => buildInputArgs(extra, inv.decodeHwAccel)),
 		...graph ? ["-filter_complex", graph.graph] : []
 	];
-	const threadArgs = inv.threadCount > 0 ? ["-threads", String(inv.threadCount)] : [];
+	const threadArgs = [...inv.threadCount > 0 ? ["-threads", String(inv.threadCount)] : [], ...inv.filterThreadCount !== void 0 && inv.filterThreadCount > 0 ? ["-filter_threads", String(inv.filterThreadCount)] : []];
 	const maps = resolveStreamMaps(inv);
 	const videoMapArgs = maps.video ? ["-map", maps.video] : [];
 	const audioMapArgs = maps.audio ? ["-map", maps.audio] : [];

package/dist/capabilities/camera-grid-layout.cap.d.ts

@@ -90,6 +90,7 @@ declare const GridProfileOfferSchema: z.ZodObject<{
     offered: z.ZodBoolean;
     missingSources: z.ZodArray<z.ZodNumber>;
     canvas: z.ZodString;
+    published: z.ZodBoolean;
 }, z.core.$strip>;
 export declare const GridLayoutViewSchema: z.ZodObject<{
     instanceId: z.ZodString;
@@ -120,6 +121,7 @@ export declare const GridLayoutViewSchema: z.ZodObject<{
         offered: z.ZodBoolean;
         missingSources: z.ZodArray<z.ZodNumber>;
         canvas: z.ZodString;
+        published: z.ZodBoolean;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type GridNormalizedRect = z.infer<typeof GridNormalizedRectSchema>;
@@ -130,6 +132,11 @@ export declare const GridLayoutPatchSchema: z.ZodObject<{
     deviceId: z.ZodNumber;
     name: z.ZodOptional<z.ZodString>;
     fps: z.ZodOptional<z.ZodNumber>;
+    publishedProfiles: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        high: "high";
+        mid: "mid";
+        low: "low";
+    }>>>;
     cells: z.ZodArray<z.ZodObject<{
         deviceId: z.ZodNumber;
         source: z.ZodObject<{
@@ -210,6 +217,7 @@ export declare const cameraGridLayoutCapability: {
                 offered: z.ZodBoolean;
                 missingSources: z.ZodArray<z.ZodNumber>;
                 canvas: z.ZodString;
+                published: z.ZodBoolean;
             }, z.core.$strip>>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         /** Write the geometry back. Returns the grid as it now stands, profiles included. */
@@ -217,6 +225,11 @@ export declare const cameraGridLayoutCapability: {
             deviceId: z.ZodNumber;
             name: z.ZodOptional<z.ZodString>;
             fps: z.ZodOptional<z.ZodNumber>;
+            publishedProfiles: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                high: "high";
+                mid: "mid";
+                low: "low";
+            }>>>;
             cells: z.ZodArray<z.ZodObject<{
                 deviceId: z.ZodNumber;
                 source: z.ZodObject<{
@@ -261,6 +274,7 @@ export declare const cameraGridLayoutCapability: {
                 offered: z.ZodBoolean;
                 missingSources: z.ZodArray<z.ZodNumber>;
                 canvas: z.ZodString;
+                published: z.ZodBoolean;
             }, z.core.$strip>>;
         }, z.core.$strip>, "mutation">;
     };

package/dist/ffmpeg/invocation.d.ts

@@ -60,6 +60,24 @@ export interface FfmpegInputPlan {
      */
     readonly analyzeDurationUs?: number;
     readonly probeSizeBytes?: number;
+    /**
+     * `-threads` for the DECODER, emitted before `-i`.
+     *
+     * Distinct from {@link FfmpegInvocation.threadCount}, which lands after the
+     * video args and therefore bounds the ENCODER only. Nothing bounded the
+     * decoder at all until 2026-09-18, and that is where the threads were: left
+     * at auto, libavcodec creates `min(cores, 16)` frame threads per input, on a
+     * 20-core hub, per child.
+     *
+     * Measured the same day: a grid tile reading a 1080p sub-stream held 72
+     * threads; with this set to 1 and `filterThreadCount` to 1 it holds 26. The
+     * container's pid cgroup counts every one against a 2048 ceiling it was
+     * actively refusing at.
+     *
+     * A parallel decode is still a real thing — a 4K software decode at 25 fps
+     * cannot keep up single-threaded — so this is a number, not a flag.
+     */
+    readonly decodeThreadCount?: number;
     /**
      * A headerless stream of raw frames — `-f rawvideo` and the three facts that
      * demuxer cannot discover for itself.
@@ -389,6 +407,21 @@ export interface FfmpegInvocation {
     readonly audio: FfmpegAudioPlan;
     /** `0` = auto (omit `-threads` and let ffmpeg decide). */
     readonly threadCount: number;
+    /**
+     * `-filter_threads` — the size of libavfilter's OWN slice pool, which
+     * `-threads` does not touch.
+     *
+     * A separate number because it is a separate pool: ffmpeg sizes the filter
+     * pool to the core count independently of the codec threads, per graph. On
+     * this 20-core hub that is ~15 threads per graph doing nothing measurable on
+     * a 320x180-class output, and the container's pid cgroup counts every one of
+     * them. Measured on the hub 2026-09-18: a recorder passthrough went 20 → 5
+     * threads, a snapshot grab 35 → 4, an egress transcode 62 → 18, with
+     * `-threads` and this set together.
+     *
+     * Omitted when absent, so no shipped argv changes by adding the field.
+     */
+    readonly filterThreadCount?: number;
     /** Consumer output options, emitted verbatim after the encode block. */
     readonly outputArgs: readonly string[];
     readonly sink: FfmpegSink;

package/dist/ffmpeg/process.d.ts

@@ -81,6 +81,18 @@ export interface FfmpegProcessOptions {
      * it is bounded by {@link maxRestarts} regardless of what this returns.
      */
     readonly onExit?: (exit: FfmpegExit) => void;
+    /**
+     * Called ONCE, when the wrapper stops restarting and the child is gone for
+     * good.
+     *
+     * `onExit` cannot answer this: it fires on every exit, including the ones
+     * that are about to be respawned, so a caller using it to tear down would
+     * tear down on the first hiccup. And the `start()` promise cannot answer it
+     * either — its `reject` is spent the moment the child first goes live, so a
+     * give-up AFTER that reached nobody at all. A camera-grid tile that died an
+     * hour in was indistinguishable, to its owner, from one that never started.
+     */
+    readonly onGiveUp?: (error: Error) => void;
     /** Wall-clock budget for the first output byte. `0` disables the deadline. */
     readonly firstDataTimeoutMs?: number;
     /** `0` ⇒ never restart (a run-to-completion job). */

package/dist/index.js

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sleep = require("./sleep-VlZxDyXq.js");
 const require_event_category = require("./event-category-BVfsrBYA.js");
-const require_canonical_hash = require("./canonical-hash-BS9dQmcQ.js");
+const require_canonical_hash = require("./canonical-hash-DYsYm8is.js");
 const require_enums = require("./enums.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 let zod = require("zod");
@@ -32559,7 +32559,16 @@ var GridProfileOfferSchema = zod.z.object({
 	* grid came out as, and because it is the number an operator would otherwise
 	* expect to type.
 	*/
-	canvas: zod.z.string()
+	canvas: zod.z.string(),
+	/**
+	* Whether this profile is PUBLISHED, of the ones the grid could serve.
+	*
+	* A grid's `high` is composed of its sources' `high`, so on a 4K fleet it is
+	* a 4K canvas built from 4K decodes — something to opt into, not something a
+	* viewer's adaptive should be handed by climbing to the top rung it can see.
+	* Default is `mid` + `low`.
+	*/
+	published: zod.z.boolean()
 });
 var GridLayoutViewSchema = zod.z.object({
 	/** The persisted grid row this camera was declared from. */
@@ -32582,6 +32591,12 @@ var GridLayoutPatchSchema = zod.z.object({
 	deviceId: zod.z.number().int().nonnegative(),
 	name: zod.z.string().min(1).max(160).optional(),
 	fps: zod.z.number().int().min(1).max(60).optional(),
+	/** Which profiles to publish. See `GridProfileOffer.published`. */
+	publishedProfiles: zod.z.array(zod.z.enum([
+		"high",
+		"mid",
+		"low"
+	])).max(3).optional(),
 	/**
 	* The whole cell list at once. A per-cell patch would need an ordering the
 	* editor does not have, and a half-applied layout is a picture nobody asked

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { $ as CAM_PROFILE_ORDER, A as DeviceType, At as isEvent, B as systemMethod, Bt as isAudioChunkFormat, C as customAction, Ct as SHARE_VIEW_KINDS, D as ChargingStatus, Dt as createDurableState, E as deviceCustomAction, Et as normalizeAddonInitResult, F as event, Ft as hydrateSchema, G as ReadinessRegistry, H as nodePin, I as expandCapMethods, It as resolveHydratedFieldValue, J as readinessKey, K as ReadinessTimeoutError, L as isDeviceConfigCap, Lt as AUDIO_CHUNK_FORMATS, M as DEFAULT_RUNTIME_STATE_DURABILITY, Mt as WELL_KNOWN_TAB_MAP, N as DEVICE_SETTINGS_CONTRIBUTION_METHODS, Nt as collectHydratedFieldEntries, O as DeviceFeature, Ot as createEvent, P as DEVICE_STATUS_METHOD, Pt as collectHydratedFieldValues, Q as BrokerStatusSchema, R as method, Rt as audioChunkBytesPerSample, S as DEVICE_CHILDREN_BATCH_MAX, St as DATAPLANE_SECRET_HEADER, T as describeCustomActions, Tt as BaseAddon, U as readNodePin, V as CAP_NODE_PIN_CONTEXT_KEY, W as toNodeId, X as AudioChunkFormatSchema, Y as scopeKey, Z as BrokerStatsSchema, _ as createMirrorSource, _t as SubscribeFramesResultSchema, a as asJsonObject, at as DecodedFrameSchema, b as deviceOpsCapability, bt as parseProfileBrokerId, c as parseJsonArray, ct as FrameHandleSchema, d as BOOT_RECOVERY_BACKOFF_MS, dt as ProfileSlotStatusSchema, et as CamProfileSchema, f as DEVICE_SCOPED_CAPS, ft as StreamSourceEntrySchema, g as createLazyTrpcSource, gt as SubscribeFramesInputSchema, h as createEventBusSliceSource, ht as SubscribeAudioChunksResultSchema, i as asJsonArray, it as DecodedAudioChunkSchema, j as adminUiCapability, jt as WELL_KNOWN_TABS, k as DeviceRole, kt as emitReadiness, l as parseJsonObject, lt as ProfileRtspEntrySchema, m as createDeviceProxy, mt as SubscribeAudioChunksInputSchema, n as sleepCancellable, nt as CamStreamResolutionSchema, o as asNumber, ot as EncodedPacketSchema, p as isDeviceScopedCap, pt as StreamSourceSchema, q as emitDownForOwnedCaps, r as asBoolean, rt as CameraStreamSchema, s as asString, st as FrameHandleFormatSchema, t as sleep, tt as CamStreamKindSchema, u as parseJsonUnknown, ut as ProfileSlotSchema, v as createSliceHandle, vt as makeProfileBrokerId, w as defineCustomActions, wt as DisposerChain, x as viewerUiCapability, xt as selectAssignedProfileSlots, y as RawStateResultSchema, yt as makeSourceBrokerId, z as resolveCapMount, zt as expandAudioChunkToF32le } from "./sleep-GU_us3DG.mjs";
 import { t as EventCategory } from "./event-category-BVDXG4tB.mjs";
-import { a as buildAudioArgs, c as buildVideoArgs, d as logBannerArgs, f as pickVideoEncoder, i as audioPlanFromEncodeProfile, l as invocationFromEncodeProfile, n as Fmp4BoxSplitter, o as buildFfmpegArgs, p as resolveStreamMaps, r as AUDIO_PRESETS, s as buildInputArgs, t as canonicalHash, u as isSoftwareDecode } from "./canonical-hash-C5pB-QV1.mjs";
+import { a as buildAudioArgs, c as buildVideoArgs, d as logBannerArgs, f as pickVideoEncoder, i as audioPlanFromEncodeProfile, l as invocationFromEncodeProfile, n as Fmp4BoxSplitter, o as buildFfmpegArgs, p as resolveStreamMaps, r as AUDIO_PRESETS, s as buildInputArgs, t as canonicalHash, u as isSoftwareDecode } from "./canonical-hash-CvL03d3i.mjs";
 import { EventSourceType } from "./enums.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 import { z } from "zod";
@@ -32558,7 +32558,16 @@ var GridProfileOfferSchema = z.object({
 	* grid came out as, and because it is the number an operator would otherwise
 	* expect to type.
 	*/
-	canvas: z.string()
+	canvas: z.string(),
+	/**
+	* Whether this profile is PUBLISHED, of the ones the grid could serve.
+	*
+	* A grid's `high` is composed of its sources' `high`, so on a 4K fleet it is
+	* a 4K canvas built from 4K decodes — something to opt into, not something a
+	* viewer's adaptive should be handed by climbing to the top rung it can see.
+	* Default is `mid` + `low`.
+	*/
+	published: z.boolean()
 });
 var GridLayoutViewSchema = z.object({
 	/** The persisted grid row this camera was declared from. */
@@ -32581,6 +32590,12 @@ var GridLayoutPatchSchema = z.object({
 	deviceId: z.number().int().nonnegative(),
 	name: z.string().min(1).max(160).optional(),
 	fps: z.number().int().min(1).max(60).optional(),
+	/** Which profiles to publish. See `GridProfileOffer.published`. */
+	publishedProfiles: z.array(z.enum([
+		"high",
+		"mid",
+		"low"
+	])).max(3).optional(),
 	/**
 	* The whole cell list at once. A per-cell patch would need an ordering the
 	* editor does not have, and a half-applied layout is a picture nobody asked

package/dist/node.js

@@ -21,7 +21,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_canonical_hash = require("./canonical-hash-BS9dQmcQ.js");
+const require_canonical_hash = require("./canonical-hash-DYsYm8is.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");
@@ -1158,7 +1158,9 @@ var FfmpegProcess = class {
 				tags: this.logTags,
 				meta: { stderrTail: this.stderrTail }
 			});
-			onDead(new Error(reason));
+			const error = new Error(reason);
+			onDead(error);
+			this.opts.onGiveUp?.(error);
 			return;
 		}
 		this.scheduleRestart(onLive, onDead);
@@ -1166,7 +1168,10 @@ var FfmpegProcess = class {
 	scheduleRestart(onLive, onDead) {
 		if (this.stopped) return;
 		const maxRestarts = this.opts.maxRestarts ?? 0;
-		if (maxRestarts === 0) return;
+		if (maxRestarts === 0) {
+			this.opts.onGiveUp?.(/* @__PURE__ */ new Error(`ffmpeg ${this.opts.role} ended and restarts are disabled`));
+			return;
+		}
 		if (this.producedOutput && this.now - this.startedAtMs >= (this.opts.stableRunMs ?? DEFAULT_STABLE_RUN_MS)) this.consecutiveFailures = 0;
 		if (this.consecutiveFailures > maxRestarts) return;
 		(this.opts.setTimeoutFn ?? setTimeout)(() => {

package/dist/node.mjs

@@ -1,4 +1,4 @@
-import { n as Fmp4BoxSplitter, o as buildFfmpegArgs, t as canonicalHash, u as isSoftwareDecode } from "./canonical-hash-C5pB-QV1.mjs";
+import { n as Fmp4BoxSplitter, o as buildFfmpegArgs, t as canonicalHash, u as isSoftwareDecode } from "./canonical-hash-CvL03d3i.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 import { createHash, createHmac, randomUUID, timingSafeEqual } from "node:crypto";
 import * as fs from "node:fs";
@@ -1135,7 +1135,9 @@ var FfmpegProcess = class {
 				tags: this.logTags,
 				meta: { stderrTail: this.stderrTail }
 			});
-			onDead(new Error(reason));
+			const error = new Error(reason);
+			onDead(error);
+			this.opts.onGiveUp?.(error);
 			return;
 		}
 		this.scheduleRestart(onLive, onDead);
@@ -1143,7 +1145,10 @@ var FfmpegProcess = class {
 	scheduleRestart(onLive, onDead) {
 		if (this.stopped) return;
 		const maxRestarts = this.opts.maxRestarts ?? 0;
-		if (maxRestarts === 0) return;
+		if (maxRestarts === 0) {
+			this.opts.onGiveUp?.(/* @__PURE__ */ new Error(`ffmpeg ${this.opts.role} ended and restarts are disabled`));
+			return;
+		}
 		if (this.producedOutput && this.now - this.startedAtMs >= (this.opts.stableRunMs ?? DEFAULT_STABLE_RUN_MS)) this.consecutiveFailures = 0;
 		if (this.consecutiveFailures > maxRestarts) return;
 		(this.opts.setTimeoutFn ?? setTimeout)(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.222",
+  "version": "1.2.224",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",