@camstack/types 1.2.99 → 1.2.101

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_event_category = require("./event-category-EY0GNjV9.js");
-const require_sleep = require("./sleep-C2XhJhkd.js");
+const require_sleep = require("./sleep-BwXldPpA.js");
 const require_canonical_hash = require("./canonical-hash-DNV8S5ET.js");
 const require_enums = require("./enums.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
@@ -2605,6 +2605,32 @@ var ModelVariantGroupSchema = zod.z.object({
 	*/
 	resolution: zod.z.number().int().positive().optional()
 });
+/**
+* Where a catalog entry came from. The pipeline stepper partitions the picker
+* by this id (CamStack / Frigate / Scrypted / Custom). Absent on older durable
+* registry rows — {@link inferModelProvider} fills it at read time. Built-in
+* catalog entries omit it and `getSchema` treats them as `camstack`.
+*/
+var MODEL_PROVIDER_IDS = [
+	"camstack",
+	"frigate",
+	"scrypted",
+	"custom"
+];
+var ModelProviderIdSchema = zod.z.enum(MODEL_PROVIDER_IDS);
+/**
+* Resolve a catalog entry's picker provider. An explicit stamp always wins;
+* otherwise Frigate/Scrypted are recognised from id prefix or description.
+* Unstamped BYO registry rows fall through to `custom`. Family `yolov9` is
+* NOT a Scrypted signal — CamStack ships that family too.
+*/
+function inferModelProvider(entry) {
+	if (entry.provider !== void 0) return entry.provider;
+	const haystack = `${entry.id} ${entry.description ?? ""}`;
+	if (/scrypted/i.test(haystack)) return "scrypted";
+	if (/frigate/i.test(haystack)) return "frigate";
+	return "custom";
+}
 var ModelCatalogEntrySchema = zod.z.object({
 	id: zod.z.string(),
 	name: zod.z.string(),
@@ -2702,6 +2728,12 @@ var ModelCatalogEntrySchema = zod.z.object({
 	*/
 	group: ModelVariantGroupSchema.optional(),
 	/**
+	* Catalog source for the pipeline stepper's provider-first picker. Absent on
+	* built-in CamStack entries (treated as `camstack`) and on registry rows
+	* persisted before this field existed (`inferModelProvider` fills those).
+	*/
+	provider: ModelProviderIdSchema.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).
@@ -12453,12 +12485,15 @@ var NC_AUDIO_DBFS_FLOOR = -96;
 * there is no second switch that can disagree with the first and every rule
 * authored before the decision migrates for free (`audioModeOf`):
 *
-*  - **LABEL mode — `labels` present.** The rule fires on the FIRST frame the
-*    classifier labels with one of them. No window, no percentage:
-*    `hitPercent` and `samplingSeconds` are ignored, and the rule's own
-*    `throttle` cooldown is the only brake. The per-label confidence floor is
-*    the analyzer's (`classificationMinScore`, per device) — a label only
-*    reaches this condition if the classifier was already confident enough.
+*  - **LABEL mode — `labels` present.** The rule fires when `confirmHits`
+*    labelled frames land inside `confirmWindowSec` (default 2 in 5 s).
+*    `hitPercent` and `samplingSeconds` are still ignored — a percentage of
+*    frames is the wrong question for a classifier that labels 1–3 frames
+*    per episode. The count window is the brake that drops a single-frame
+*    false positive; the rule's own `throttle` cooldown is the other. The
+*    per-label confidence floor is the analyzer's (`classificationMinScore`,
+*    per device) — a label only reaches this condition if the classifier was
+*    already confident enough. `confirmHits: 1` restores first-frame fire.
 *  - **LEVEL mode — `dbThreshold` present, no labels.** The sampling window IS
 *    the condition: at least `hitPercent`% of the samples over
 *    `samplingSeconds` must be at or above `dbThreshold` dBFS (see
@@ -12485,14 +12520,22 @@ var NC_AUDIO_DBFS_FLOOR = -96;
 * an operator who typed `dog` mean the same thing.
 */
 var NcAudioConditionSchema = zod.z.object({
-	/** LABEL MODE: audio macro labels. Present ⇒ fires on the first labelled frame. */
+	/** LABEL MODE: audio macro labels. Present ⇒ count-in-window confirm. */
 	labels: zod.z.array(zod.z.string().min(1)).min(1).optional(),
 	/** LEVEL MODE: floor in dBFS (negative-going, `0` = full scale). */
 	dbThreshold: zod.z.number().min(-96).max(0).optional(),
 	/** LEVEL MODE ONLY: percentage of the window's samples that must be hits (1–100). */
 	hitPercent: zod.z.number().int().min(1).max(100).default(60),
 	/** LEVEL MODE ONLY: length of the sampling window in seconds. */
-	samplingSeconds: zod.z.number().int().min(1).max(300).default(10)
+	samplingSeconds: zod.z.number().int().min(1).max(300).default(10),
+	/**
+	* LABEL MODE: how many labelled frames must land inside
+	* {@link NcAudioConditionSchema.shape.confirmWindowSec} before dispatch.
+	* Absent ⇒ 2 (the matcher default). `1` is first-frame fire.
+	*/
+	confirmHits: zod.z.number().int().min(1).max(20).optional(),
+	/** LABEL MODE: the window those frames must share, in seconds. Absent ⇒ 5. */
+	confirmWindowSec: zod.z.number().int().min(1).max(60).optional()
 });
 /**
 * Which zone-crossing DIRECTION a rule accepts (`ObjectEvent.zoneCrossing`).
@@ -15452,6 +15495,46 @@ var RecentTracksPageSchema = zod.z.object({
 	/** Cursor for the next page, or null when this page is the last. */
 	nextCursor: zod.z.string().nullable()
 });
+var LIST_GROUPS_DEFAULT_LIMIT = 40;
+var LIST_GROUPS_MAX_LIMIT = 100;
+var AnalyticsGroupRecordSchema = zod.z.object({
+	id: zod.z.string(),
+	deviceId: zod.z.number().int(),
+	openedAt: zod.z.number().int(),
+	closedAt: zod.z.number().int(),
+	timestamp: zod.z.number().int(),
+	memberCount: zod.z.number().int(),
+	memberTrackIds: zod.z.array(zod.z.string()).readonly(),
+	className: zod.z.string(),
+	classes: zod.z.array(zod.z.string()).readonly(),
+	/** Relative event-media path, or null when the group has no picture yet. */
+	mediaUrl: zod.z.string().nullable(),
+	singleton: zod.z.boolean()
+});
+var AnalyticsGroupMemberSchema = zod.z.object({
+	trackId: zod.z.string(),
+	deviceId: zod.z.number().int(),
+	className: zod.z.string(),
+	firstSeen: zod.z.number().int(),
+	lastSeen: zod.z.number().int(),
+	mediaUrl: zod.z.string().nullable()
+});
+var AnalyticsGroupDetailSchema = AnalyticsGroupRecordSchema.extend({ members: zod.z.array(AnalyticsGroupMemberSchema).readonly() });
+var ListGroupsQueryInput = zod.z.object({
+	/** Devices to merge. An empty array yields `{ groups: [], nextCursor: null }`. */
+	deviceIds: zod.z.array(zod.z.number()),
+	/** Window lower bound on `closedAt` (inclusive). */
+	since: zod.z.number().optional(),
+	/** Window upper bound on `openedAt` (inclusive). */
+	until: zod.z.number().optional(),
+	limit: zod.z.number().int().min(1).max(LIST_GROUPS_MAX_LIMIT).default(LIST_GROUPS_DEFAULT_LIMIT),
+	/** Opaque continuation cursor from a previous page's `nextCursor`. */
+	cursor: zod.z.string().optional()
+});
+var ListGroupsPageSchema = zod.z.object({
+	groups: zod.z.array(AnalyticsGroupRecordSchema).readonly(),
+	nextCursor: zod.z.string().nullable()
+});
 var KeyEventQueryInput = zod.z.object({
 	deviceId: zod.z.number(),
 	/** Window lower bound (track firstSeen ≥ since). */
@@ -15527,7 +15610,9 @@ var TrackCascadeCountsSchema = zod.z.object({
 	/** Unassigned plate reads removed (best-effort; plate leg deferred to plate-intelligence). */
 	plates: zod.z.number().int(),
 	/** Per-track CLIP search vectors removed (best-effort). */
-	embeddings: zod.z.number().int()
+	embeddings: zod.z.number().int(),
+	/** Group membership + group rows removed with their last member (best-effort). */
+	groups: zod.z.number().int()
 });
 /** Disk-wins reconcile: media rows whose blobs are gone, then empty tracks. */
 var DiskReconcileCountsSchema = zod.z.object({
@@ -15699,6 +15784,16 @@ var pipelineAnalyticsCapability = {
 		* are not included (same contract as `listTracks`).
 		*/
 		listRecentTracks: require_sleep.method(RecentTracksQueryInput, RecentTracksPageSchema),
+		/**
+		* Batched co-moving group listing — the Groups feed. Same merge/cursor
+		* contract as {@link listRecentTracks}. A group is a sealed partition of
+		* one session; `getGroup` is the detail with members.
+		*/
+		listGroups: require_sleep.method(ListGroupsQueryInput, ListGroupsPageSchema),
+		getGroup: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number(),
+			groupId: zod.z.string().min(1)
+		}), AnalyticsGroupDetailSchema.nullable()),
 		clearTracks: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.void(), {
 			kind: "mutation",
 			auth: "admin"
@@ -16387,7 +16482,8 @@ var PipelineModelOptionSchema = zod.z.object({
 		sizeMB: zod.z.number()
 	})),
 	group: ModelVariantGroupSchema.optional(),
-	legacy: zod.z.boolean().optional()
+	legacy: zod.z.boolean().optional(),
+	provider: ModelProviderIdSchema.optional()
 });
 var ConfigFieldBridge = zod.z.custom();
 var PipelineAddonSchemaSchema = zod.z.object({
@@ -37777,6 +37873,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.getGroup": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.getKeyEvents": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -37861,6 +37963,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.listGroups": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.listOpsLog": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -41537,6 +41645,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"pipelineAnalytics.getGroup": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"pipelineAnalytics.getKeyEvents": [{
 		name: "deviceId",
 		form: "single",
@@ -41592,6 +41705,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "array",
 		optional: false
 	}],
+	"pipelineAnalytics.listGroups": [{
+		name: "deviceIds",
+		form: "array",
+		optional: false
+	}],
 	"pipelineAnalytics.listOpsLog": [{
 		name: "deviceId",
 		form: "single",
@@ -43590,6 +43708,19 @@ var NC_AUDIO_HIT_PERCENT_MIN = 1;
 var NC_AUDIO_HIT_PERCENT_MAX = 100;
 var NC_AUDIO_SAMPLING_MIN_SEC = 1;
 var NC_AUDIO_SAMPLING_MAX_SEC = 300;
+/**
+* LABEL-mode confirm-count defaults. Chosen against the live "Pianti" rule
+* (2026-08-23): 15 notifies in 12 h, each a single YAMNet `crying` frame,
+* nobody actually crying. Two labelled frames in 5 s drops the single-frame
+* false positives and still catches a real episode (YAMNet labels 2–3
+* frames of a genuine cry).
+*/
+var NC_AUDIO_CONFIRM_HITS_DEFAULT = 2;
+var NC_AUDIO_CONFIRM_WINDOW_SEC_DEFAULT = 5;
+var NC_AUDIO_CONFIRM_HITS_MIN = 1;
+var NC_AUDIO_CONFIRM_HITS_MAX = 20;
+var NC_AUDIO_CONFIRM_WINDOW_MIN_SEC = 1;
+var NC_AUDIO_CONFIRM_WINDOW_MAX_SEC = 60;
 /** Schema defaults — an untouched sub-field must author exactly these. */
 var NC_AUDIO_DEFAULTS = {
 	hitPercent: 60,
@@ -43669,7 +43800,15 @@ function patchAudio(current, patch) {
 		...labels !== void 0 ? { labels: [...labels] } : {},
 		...dbThreshold !== void 0 ? { dbThreshold: clampInt(dbThreshold, NC_AUDIO_DB_MIN, 0) } : {},
 		hitPercent: clampInt(patch.hitPercent ?? base.hitPercent, 1, 100),
-		samplingSeconds: clampInt(patch.samplingSeconds ?? base.samplingSeconds, 1, 300)
+		samplingSeconds: clampInt(patch.samplingSeconds ?? base.samplingSeconds, 1, 300),
+		...(() => {
+			const hits = has(patch, "confirmHits") ? patch.confirmHits : base.confirmHits;
+			const windowSec = has(patch, "confirmWindowSec") ? patch.confirmWindowSec : base.confirmWindowSec;
+			return {
+				...hits !== void 0 ? { confirmHits: clampInt(hits, 1, 20) } : {},
+				...windowSec !== void 0 ? { confirmWindowSec: clampInt(windowSec, 1, 60) } : {}
+			};
+		})()
 	};
 }
 /**
@@ -47428,6 +47567,9 @@ exports.AlertSeveritySchema = AlertSeveritySchema;
 exports.AlertSourceSchema = AlertSourceSchema;
 exports.AlertStatusSchema = AlertStatusSchema;
 exports.AmbientLightSensorStatusSchema = AmbientLightSensorStatusSchema;
+exports.AnalyticsGroupDetailSchema = AnalyticsGroupDetailSchema;
+exports.AnalyticsGroupMemberSchema = AnalyticsGroupMemberSchema;
+exports.AnalyticsGroupRecordSchema = AnalyticsGroupRecordSchema;
 exports.ApiKeyRecordSchema = ApiKeyRecordSchema;
 exports.ApiKeySummarySchema = ApiKeySummarySchema;
 exports.ArchiveEntrySchema = ArchiveEntrySchema;
@@ -47771,6 +47913,8 @@ exports.LawnMowerActivitySchema = LawnMowerActivitySchema;
 exports.LawnMowerControlStatusSchema = LawnMowerControlStatusSchema;
 exports.LinkedDeviceSchema = LinkedDeviceSchema;
 exports.LinkedDevicesModeSchema = LinkedDevicesModeSchema;
+exports.ListGroupsPageSchema = ListGroupsPageSchema;
+exports.ListGroupsQueryInput = ListGroupsQueryInput;
 exports.LlmDefaultSchema = LlmDefaultSchema;
 exports.LlmDefaultSelectorSchema = LlmDefaultSelectorSchema;
 exports.LlmDownloadProgressSchema = LlmDownloadProgressSchema;
@@ -47814,6 +47958,7 @@ exports.MAX_EXPRESSION_SOURCE_LENGTH = MAX_EXPRESSION_SOURCE_LENGTH;
 exports.METHOD_ACCESS_MAP = METHOD_ACCESS_MAP;
 exports.METHOD_DEVICE_SELECTORS = METHOD_DEVICE_SELECTORS;
 exports.MODEL_FORMATS = MODEL_FORMATS;
+exports.MODEL_PROVIDER_IDS = MODEL_PROVIDER_IDS;
 exports.MOTION_TRIGGER_FEATURE = MOTION_TRIGGER_FEATURE;
 exports.ManagedModelCatalogEntrySchema = ManagedModelCatalogEntrySchema;
 exports.ManagedModelExtraFileSchema = ManagedModelExtraFileSchema;
@@ -47844,6 +47989,7 @@ exports.ModelDistributeResultSchema = ModelDistributeResultSchema;
 exports.ModelExtraFileSchema = ModelExtraFileSchema;
 exports.ModelFormatEntrySchema = ModelFormatEntrySchema;
 exports.ModelFormatsSchema = ModelFormatsSchema;
+exports.ModelProviderIdSchema = ModelProviderIdSchema;
 exports.ModelSubstitutionSchema = ModelSubstitutionSchema;
 exports.ModelVariantGroupSchema = ModelVariantGroupSchema;
 exports.MotionAnalysisResultSchema = MotionAnalysisResultSchema;
@@ -47873,6 +48019,12 @@ exports.NATIVE_LEASE_SECTION_ID = NATIVE_LEASE_SECTION_ID;
 exports.NATIVE_LEASE_TILE_BUDGET_FIELD = NATIVE_LEASE_TILE_BUDGET_FIELD;
 exports.NATIVE_LEASE_TILE_BUDGET_KEY = NATIVE_LEASE_TILE_BUDGET_KEY;
 exports.NC_ALARM_SYSTEM_EVENT_KINDS = NC_ALARM_SYSTEM_EVENT_KINDS;
+exports.NC_AUDIO_CONFIRM_HITS_DEFAULT = NC_AUDIO_CONFIRM_HITS_DEFAULT;
+exports.NC_AUDIO_CONFIRM_HITS_MAX = NC_AUDIO_CONFIRM_HITS_MAX;
+exports.NC_AUDIO_CONFIRM_HITS_MIN = NC_AUDIO_CONFIRM_HITS_MIN;
+exports.NC_AUDIO_CONFIRM_WINDOW_MAX_SEC = NC_AUDIO_CONFIRM_WINDOW_MAX_SEC;
+exports.NC_AUDIO_CONFIRM_WINDOW_MIN_SEC = NC_AUDIO_CONFIRM_WINDOW_MIN_SEC;
+exports.NC_AUDIO_CONFIRM_WINDOW_SEC_DEFAULT = NC_AUDIO_CONFIRM_WINDOW_SEC_DEFAULT;
 exports.NC_AUDIO_DBFS_FLOOR = NC_AUDIO_DBFS_FLOOR;
 exports.NC_AUDIO_DB_MAX = NC_AUDIO_DB_MAX;
 exports.NC_AUDIO_DB_MIN = NC_AUDIO_DB_MIN;
@@ -48493,6 +48645,7 @@ exports.humiditySensorCapability = humiditySensorCapability;
 exports.hydrateSchema = require_sleep.hydrateSchema;
 exports.imageCapability = imageCapability;
 exports.imageSettingsCapability = imageSettingsCapability;
+exports.inferModelProvider = inferModelProvider;
 exports.initialPoolMemoryState = initialPoolMemoryState;
 exports.integrationsCapability = integrationsCapability;
 exports.intercomCapability = intercomCapability;