@camstack/types 1.2.401 → 1.2.403

package/dist/capabilities/user-management.cap.d.ts

@@ -6,7 +6,17 @@ declare const UserSummarySchema: z.ZodObject<{
     isAdmin: z.ZodDefault<z.ZodBoolean>;
     allowedProviders: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>;
     allowedDevices: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>;
-    scopes: z.ZodDefault<z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    scopes: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"viewer">;
+        allow: z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodArray<z.ZodNumber>]>;
+        block: z.ZodArray<z.ZodNumber>;
+        features: z.ZodArray<z.ZodEnum<{
+            "face-assignment": "face-assignment";
+            "plate-assignment": "plate-assignment";
+            retrain: "retrain";
+            scenes: "scenes";
+        }>>;
+    }, z.core.$strip>, z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"category">;
         target: z.ZodEnum<{
             device: "device";
@@ -53,7 +63,7 @@ declare const UserSummarySchema: z.ZodObject<{
             view: "view";
         }>>;
         includeLinked: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>], "type">>>>;
+    }, z.core.$strip>], "type">>]>>>;
     totpEnabled: z.ZodDefault<z.ZodBoolean>;
     createdAt: z.ZodNumber;
     updatedAt: z.ZodNumber;
@@ -64,7 +74,17 @@ declare const CreateUserInputSchema: z.ZodObject<{
     isAdmin: z.ZodDefault<z.ZodBoolean>;
     allowedProviders: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>;
     allowedDevices: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>>;
-    scopes: z.ZodOptional<z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    scopes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"viewer">;
+        allow: z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodArray<z.ZodNumber>]>;
+        block: z.ZodArray<z.ZodNumber>;
+        features: z.ZodArray<z.ZodEnum<{
+            "face-assignment": "face-assignment";
+            "plate-assignment": "plate-assignment";
+            retrain: "retrain";
+            scenes: "scenes";
+        }>>;
+    }, z.core.$strip>, z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"category">;
         target: z.ZodEnum<{
             device: "device";
@@ -111,14 +131,24 @@ declare const CreateUserInputSchema: z.ZodObject<{
             view: "view";
         }>>;
         includeLinked: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>], "type">>>>;
+    }, z.core.$strip>], "type">>]>>>;
 }, z.core.$strip>;
 declare const UpdateUserInputSchema: z.ZodObject<{
     id: z.ZodString;
     isAdmin: z.ZodOptional<z.ZodBoolean>;
     allowedProviders: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>;
     allowedDevices: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>>;
-    scopes: z.ZodOptional<z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    scopes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"viewer">;
+        allow: z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodArray<z.ZodNumber>]>;
+        block: z.ZodArray<z.ZodNumber>;
+        features: z.ZodArray<z.ZodEnum<{
+            "face-assignment": "face-assignment";
+            "plate-assignment": "plate-assignment";
+            retrain: "retrain";
+            scenes: "scenes";
+        }>>;
+    }, z.core.$strip>, z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"category">;
         target: z.ZodEnum<{
             device: "device";
@@ -165,7 +195,7 @@ declare const UpdateUserInputSchema: z.ZodObject<{
             view: "view";
         }>>;
         includeLinked: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>], "type">>>>;
+    }, z.core.$strip>], "type">>]>>>;
 }, z.core.$strip>;
 declare const OauthSessionSummarySchema: z.ZodObject<{
     id: z.ZodString;
@@ -256,7 +286,17 @@ export declare const userManagementCapability: {
             isAdmin: z.ZodDefault<z.ZodBoolean>;
             allowedProviders: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>;
             allowedDevices: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>;
-            scopes: z.ZodDefault<z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            scopes: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"viewer">;
+                allow: z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodArray<z.ZodNumber>]>;
+                block: z.ZodArray<z.ZodNumber>;
+                features: z.ZodArray<z.ZodEnum<{
+                    "face-assignment": "face-assignment";
+                    "plate-assignment": "plate-assignment";
+                    retrain: "retrain";
+                    scenes: "scenes";
+                }>>;
+            }, z.core.$strip>, z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"category">;
                 target: z.ZodEnum<{
                     device: "device";
@@ -303,7 +343,7 @@ export declare const userManagementCapability: {
                     view: "view";
                 }>>;
                 includeLinked: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strip>], "type">>>>;
+            }, z.core.$strip>], "type">>]>>>;
             totpEnabled: z.ZodDefault<z.ZodBoolean>;
             createdAt: z.ZodNumber;
             updatedAt: z.ZodNumber;
@@ -314,7 +354,17 @@ export declare const userManagementCapability: {
             isAdmin: z.ZodDefault<z.ZodBoolean>;
             allowedProviders: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>;
             allowedDevices: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>>;
-            scopes: z.ZodOptional<z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            scopes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"viewer">;
+                allow: z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodArray<z.ZodNumber>]>;
+                block: z.ZodArray<z.ZodNumber>;
+                features: z.ZodArray<z.ZodEnum<{
+                    "face-assignment": "face-assignment";
+                    "plate-assignment": "plate-assignment";
+                    retrain: "retrain";
+                    scenes: "scenes";
+                }>>;
+            }, z.core.$strip>, z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"category">;
                 target: z.ZodEnum<{
                     device: "device";
@@ -361,14 +411,24 @@ export declare const userManagementCapability: {
                     view: "view";
                 }>>;
                 includeLinked: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strip>], "type">>>>;
+            }, z.core.$strip>], "type">>]>>>;
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodString;
             username: z.ZodString;
             isAdmin: z.ZodDefault<z.ZodBoolean>;
             allowedProviders: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>;
             allowedDevices: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>;
-            scopes: z.ZodDefault<z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            scopes: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"viewer">;
+                allow: z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodArray<z.ZodNumber>]>;
+                block: z.ZodArray<z.ZodNumber>;
+                features: z.ZodArray<z.ZodEnum<{
+                    "face-assignment": "face-assignment";
+                    "plate-assignment": "plate-assignment";
+                    retrain: "retrain";
+                    scenes: "scenes";
+                }>>;
+            }, z.core.$strip>, z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"category">;
                 target: z.ZodEnum<{
                     device: "device";
@@ -415,7 +475,7 @@ export declare const userManagementCapability: {
                     view: "view";
                 }>>;
                 includeLinked: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strip>], "type">>>>;
+            }, z.core.$strip>], "type">>]>>>;
             totpEnabled: z.ZodDefault<z.ZodBoolean>;
             createdAt: z.ZodNumber;
             updatedAt: z.ZodNumber;
@@ -425,7 +485,17 @@ export declare const userManagementCapability: {
             isAdmin: z.ZodOptional<z.ZodBoolean>;
             allowedProviders: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>;
             allowedDevices: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>>;
-            scopes: z.ZodOptional<z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            scopes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"viewer">;
+                allow: z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodArray<z.ZodNumber>]>;
+                block: z.ZodArray<z.ZodNumber>;
+                features: z.ZodArray<z.ZodEnum<{
+                    "face-assignment": "face-assignment";
+                    "plate-assignment": "plate-assignment";
+                    retrain: "retrain";
+                    scenes: "scenes";
+                }>>;
+            }, z.core.$strip>, z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"category">;
                 target: z.ZodEnum<{
                     device: "device";
@@ -472,7 +542,7 @@ export declare const userManagementCapability: {
                     view: "view";
                 }>>;
                 includeLinked: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strip>], "type">>>>;
+            }, z.core.$strip>], "type">>]>>>;
         }, z.core.$strip>, z.ZodObject<{
             success: z.ZodLiteral<true>;
         }, z.core.$strip>, "mutation">;
@@ -489,7 +559,17 @@ export declare const userManagementCapability: {
         }, z.core.$strip>, "mutation">;
         readonly setUserScopes: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             userId: z.ZodString;
-            scopes: z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            scopes: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"viewer">;
+                allow: z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodArray<z.ZodNumber>]>;
+                block: z.ZodArray<z.ZodNumber>;
+                features: z.ZodArray<z.ZodEnum<{
+                    "face-assignment": "face-assignment";
+                    "plate-assignment": "plate-assignment";
+                    retrain: "retrain";
+                    scenes: "scenes";
+                }>>;
+            }, z.core.$strip>, z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"category">;
                 target: z.ZodEnum<{
                     device: "device";
@@ -536,7 +616,7 @@ export declare const userManagementCapability: {
                     view: "view";
                 }>>;
                 includeLinked: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strip>], "type">>>;
+            }, z.core.$strip>], "type">>]>>;
         }, z.core.$strip>, z.ZodObject<{
             success: z.ZodLiteral<true>;
         }, z.core.$strip>, "mutation">;
@@ -549,7 +629,17 @@ export declare const userManagementCapability: {
             isAdmin: z.ZodDefault<z.ZodBoolean>;
             allowedProviders: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>;
             allowedDevices: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>;
-            scopes: z.ZodDefault<z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            scopes: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"viewer">;
+                allow: z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodArray<z.ZodNumber>]>;
+                block: z.ZodArray<z.ZodNumber>;
+                features: z.ZodArray<z.ZodEnum<{
+                    "face-assignment": "face-assignment";
+                    "plate-assignment": "plate-assignment";
+                    retrain: "retrain";
+                    scenes: "scenes";
+                }>>;
+            }, z.core.$strip>, z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"category">;
                 target: z.ZodEnum<{
                     device: "device";
@@ -596,7 +686,7 @@ export declare const userManagementCapability: {
                     view: "view";
                 }>>;
                 includeLinked: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strip>], "type">>>>;
+            }, z.core.$strip>], "type">>]>>>;
             totpEnabled: z.ZodDefault<z.ZodBoolean>;
             createdAt: z.ZodNumber;
             updatedAt: z.ZodNumber;

package/dist/client.js

@@ -997,6 +997,7 @@ function method(input, output, options) {
 		kind: options?.kind ?? "query",
 		...options?.auth !== void 0 ? { auth: options.auth } : {},
 		...options?.access !== void 0 ? { access: options.access } : {},
+		...options?.role !== void 0 ? { role: options.role } : {},
 		...options?.caller !== void 0 ? { caller: options.caller } : {},
 		timeoutMs: options?.timeoutMs
 	};
@@ -25317,6 +25318,13 @@ var TopologyNodeSchema = zod.z.object({
 	cpuModel: zod.z.string().nullable(),
 	cpuCores: zod.z.number(),
 	memoryMB: zod.z.number(),
+	/**
+	* The inference RUNTIMES installed on the node (`pythonRuntimes`: onnx,
+	* openvino, edgetpu …) — not its devices. An installed runtime says nothing
+	* about whether its hardware is there (a Coral delegate stays installed
+	* after the stick leaves, D919); the live device set is
+	* `pipelineOrchestrator.getNodeInferenceDevices`.
+	*/
 	engines: zod.z.array(zod.z.string()).readonly(),
 	isHub: zod.z.boolean(),
 	isOnline: zod.z.boolean(),
@@ -25798,21 +25806,27 @@ method(zod.z.object({
 		path: ["profiles"]
 	});
 }), ExportRecordSchema, {
+	role: "viewer",
 	kind: "mutation",
 	auth: "protected"
 }), method(zod.z.object({ deviceId: zod.z.number().optional() }), zod.z.array(ExportRecordSchema), {
+	role: "viewer",
 	kind: "query",
 	auth: "protected"
 }), method(zod.z.object({ exportId: zod.z.string() }), ExportRecordSchema, {
+	role: "viewer",
 	kind: "query",
 	auth: "protected"
 }), method(zod.z.object({ exportId: zod.z.string() }), ExportRecordSchema, {
+	role: "viewer",
 	kind: "mutation",
 	auth: "protected"
 }), method(zod.z.object({ exportId: zod.z.string() }), ExportRecordSchema, {
+	role: "viewer",
 	kind: "mutation",
 	auth: "protected"
 }), method(zod.z.object({ exportId: zod.z.string() }), ExportDownloadSchema, {
+	role: "viewer",
 	kind: "query",
 	auth: "protected"
 }), method(zod.z.object({ exportId: zod.z.string() }), ExportBytesSchema, {
@@ -28169,6 +28183,7 @@ function createSystemProxy(api) {
 			setAgentReachableHost: (input) => dispatch("pipelineOrchestrator", "setAgentReachableHost", "mutation", input),
 			setAgentInferenceDevices: (input) => dispatch("pipelineOrchestrator", "setAgentInferenceDevices", "mutation", input),
 			getNodeInferenceDevices: (input) => dispatch("pipelineOrchestrator", "getNodeInferenceDevices", "query", input),
+			forgetInferenceDevice: (input) => dispatch("pipelineOrchestrator", "forgetInferenceDevice", "mutation", input),
 			resetNodePipelineDefaults: (input) => dispatch("pipelineOrchestrator", "resetNodePipelineDefaults", "mutation", input),
 			planAutoTune: (input) => dispatch("pipelineOrchestrator", "planAutoTune", "query", input),
 			applyAutoTune: (input) => dispatch("pipelineOrchestrator", "applyAutoTune", "mutation", input),

package/dist/client.mjs

@@ -996,6 +996,7 @@ function method(input, output, options) {
 		kind: options?.kind ?? "query",
 		...options?.auth !== void 0 ? { auth: options.auth } : {},
 		...options?.access !== void 0 ? { access: options.access } : {},
+		...options?.role !== void 0 ? { role: options.role } : {},
 		...options?.caller !== void 0 ? { caller: options.caller } : {},
 		timeoutMs: options?.timeoutMs
 	};
@@ -25316,6 +25317,13 @@ var TopologyNodeSchema = z.object({
 	cpuModel: z.string().nullable(),
 	cpuCores: z.number(),
 	memoryMB: z.number(),
+	/**
+	* The inference RUNTIMES installed on the node (`pythonRuntimes`: onnx,
+	* openvino, edgetpu …) — not its devices. An installed runtime says nothing
+	* about whether its hardware is there (a Coral delegate stays installed
+	* after the stick leaves, D919); the live device set is
+	* `pipelineOrchestrator.getNodeInferenceDevices`.
+	*/
 	engines: z.array(z.string()).readonly(),
 	isHub: z.boolean(),
 	isOnline: z.boolean(),
@@ -25797,21 +25805,27 @@ method(z.object({
 		path: ["profiles"]
 	});
 }), ExportRecordSchema, {
+	role: "viewer",
 	kind: "mutation",
 	auth: "protected"
 }), method(z.object({ deviceId: z.number().optional() }), z.array(ExportRecordSchema), {
+	role: "viewer",
 	kind: "query",
 	auth: "protected"
 }), method(z.object({ exportId: z.string() }), ExportRecordSchema, {
+	role: "viewer",
 	kind: "query",
 	auth: "protected"
 }), method(z.object({ exportId: z.string() }), ExportRecordSchema, {
+	role: "viewer",
 	kind: "mutation",
 	auth: "protected"
 }), method(z.object({ exportId: z.string() }), ExportRecordSchema, {
+	role: "viewer",
 	kind: "mutation",
 	auth: "protected"
 }), method(z.object({ exportId: z.string() }), ExportDownloadSchema, {
+	role: "viewer",
 	kind: "query",
 	auth: "protected"
 }), method(z.object({ exportId: z.string() }), ExportBytesSchema, {
@@ -28168,6 +28182,7 @@ function createSystemProxy(api) {
 			setAgentReachableHost: (input) => dispatch("pipelineOrchestrator", "setAgentReachableHost", "mutation", input),
 			setAgentInferenceDevices: (input) => dispatch("pipelineOrchestrator", "setAgentInferenceDevices", "mutation", input),
 			getNodeInferenceDevices: (input) => dispatch("pipelineOrchestrator", "getNodeInferenceDevices", "query", input),
+			forgetInferenceDevice: (input) => dispatch("pipelineOrchestrator", "forgetInferenceDevice", "mutation", input),
 			resetNodePipelineDefaults: (input) => dispatch("pipelineOrchestrator", "resetNodePipelineDefaults", "mutation", input),
 			planAutoTune: (input) => dispatch("pipelineOrchestrator", "planAutoTune", "query", input),
 			applyAutoTune: (input) => dispatch("pipelineOrchestrator", "applyAutoTune", "mutation", input),

package/dist/clips/clip-event-labels.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Which of OUR object detections a clip window holds — the ONE overlap rule
+ * and the ONE label ranking, for every clip source (D923).
+ *
+ * The recorder's visits (`videoclip-visits.ts`) were the only clips labelled
+ * by CamStack's detections; a clip the CAMERA recorded (Hikvision, Reolink,
+ * Amcrest onboard storage) carried only what its firmware said, so a person
+ * our pipeline saw inside a native clip never showed on it. The rule that
+ * attaches an event to a window lives here so the visits and the native rows
+ * cannot attach by two slightly different rules.
+ *
+ * Pure, except {@link withClipEventLabels}, which only composes a provider's
+ * own `listClips` with a fetch the provider's addon supplies (`ctx.api` —
+ * addons never import each other). It runs in the PROVIDER, never in the cap
+ * mount: a mount routes, it does not compose addon output with other state.
+ */
+import { type Clip, type IVideoclipsProvider } from '../capabilities/videoclips.cap.js';
+import type { IScopedLogger } from '../interfaces/logging.js';
+/** A time window a clip covers. */
+export interface ClipEventWindow {
+    readonly startMs: number;
+    readonly endMs: number;
+}
+/** The pad an event is widened by before it is tested against a window. */
+export interface ClipEventPad {
+    readonly preMs: number;
+    readonly postMs: number;
+}
+/** The two fields of an object event the join reads. */
+export interface ClipObjectEvent {
+    readonly timestamp: number;
+    readonly className?: string;
+}
+/**
+ * Does an event at `timestamp` belong to `window`? Inside it, or its padded
+ * window (`timestamp − preMs … timestamp + postMs`) crosses it.
+ */
+export declare function eventOverlapsClipWindow(timestamp: number, window: ClipEventWindow, pad: ClipEventPad): boolean;
+/**
+ * The distinct object classes among `events`, most frequent first, capped at
+ * {@link MAX_CLIP_LABELS}. Empty when nothing classified is there — the caller
+ * then omits the field rather than carrying an empty array.
+ */
+export declare function dominantClipLabels(events: readonly ClipObjectEvent[]): string[];
+/** Our labels for one window: the overlapping events, ranked. */
+export declare function clipLabelsForWindow(window: ClipEventWindow, events: readonly ClipObjectEvent[], pad: ClipEventPad): string[];
+/**
+ * A row's labels once ours are joined: the source's own first (it named its
+ * own clip, and `nativeTypes` keeps its unmapped words), then ours that it did
+ * not already say, capped at {@link MAX_CLIP_LABELS}.
+ */
+export declare function mergeClipLabels(own: readonly string[] | undefined, ours: readonly string[]): string[];
+/** Backstop on the event read behind one listing; hitting it is logged. */
+export declare const CLIP_LABEL_EVENT_FETCH_LIMIT = 5000;
+/** What a provider's addon supplies for the join. */
+export interface ClipEventLabelDeps {
+    readonly pad: ClipEventPad;
+    /** Our object events for the device in `[since, until]` — `ctx.api`. */
+    fetchObjectEvents(input: {
+        readonly deviceId: number;
+        readonly since: number;
+        readonly until: number;
+        readonly limit: number;
+    }): Promise<readonly ClipObjectEvent[]>;
+    readonly logger: Pick<IScopedLogger, 'info' | 'warn'>;
+}
+/**
+ * Join our object events onto a listing. A read that FAILS changes nothing
+ * (D49): the rows go out as the source listed them, and the line says so.
+ */
+export declare function annotateClipsWithEventLabels(deviceId: number, clips: readonly Clip[], deps: ClipEventLabelDeps): Promise<readonly Clip[]>;
+/** The one read the join needs, as an addon's `ctx.api` serves it. */
+export interface ClipObjectEventsApi {
+    readonly pipelineAnalytics: {
+        readonly getObjectEvents: {
+            query(input: {
+                readonly deviceId: number;
+                readonly since: number;
+                readonly until: number;
+                readonly limit: number;
+                readonly projection: 'slim';
+            }): Promise<readonly ClipObjectEvent[]>;
+        };
+    };
+}
+/**
+ * The join's deps from an addon's own `ctx.api` and logger, with the
+ * canonical event pad the recorder's visits use (`EVENT_PAD_MS`) — one place,
+ * so every native provider asks the same question.
+ */
+export declare function clipEventLabelDepsFromApi(api: ClipObjectEventsApi, logger: Pick<IScopedLogger, 'info' | 'warn'>): ClipEventLabelDeps;
+/**
+ * The provider, with our detections joined onto every listing it answers.
+ * Every other method is the provider's own.
+ */
+export declare function withClipEventLabels(provider: IVideoclipsProvider, deps: ClipEventLabelDeps): IVideoclipsProvider;

package/dist/device/cap-vocabulary/entries/actuators.d.ts

@@ -0,0 +1,5 @@
+import type { CapVocabularySlice } from '../types.js';
+type ActuatorCap = 'switch' | 'brightness' | 'color' | 'cover' | 'valve' | 'lock-control' | 'climate-control' | 'fan-control' | 'humidifier' | 'water-heater' | 'heating-valve' | 'alarm-panel' | 'button' | 'control' | 'motion-trigger';
+/** The actuator family of the vocabulary. */
+export declare const ACTUATOR_CAP_VOCABULARY: CapVocabularySlice<ActuatorCap>;
+export {};

package/dist/device/cap-vocabulary/entries/appliances.d.ts

@@ -0,0 +1,5 @@
+import type { CapVocabularySlice } from '../types.js';
+type ApplianceCap = 'vacuum-control' | 'lawn-mower-control' | 'dishwasher' | 'pet-feeder' | 'media-player' | 'consumables' | 'navigation' | 'script-runner' | 'automation-control' | 'notifier' | 'update';
+/** The appliance family of the vocabulary. */
+export declare const APPLIANCE_CAP_VOCABULARY: CapVocabularySlice<ApplianceCap>;
+export {};

package/dist/device/cap-vocabulary/entries/camera.d.ts

@@ -0,0 +1,5 @@
+import type { CapVocabularySlice } from '../types.js';
+type CameraCap = 'accessories' | 'audio-analysis' | 'audio-metrics' | 'camera-credentials' | 'camera-grid-layout' | 'camera-pipeline-config' | 'camera-streams' | 'day-night' | 'detection-pipeline' | 'device-admin-link' | 'device-discovery' | 'device-extension' | 'device-ops' | 'feature-probe' | 'image' | 'image-settings' | 'intercom' | 'motion-detection' | 'motion-zones' | 'native-object-detection' | 'osd' | 'pipeline-analytics' | 'privacy-mask' | 'ptz' | 'ptz-autotrack' | 'reboot' | 'recording' | 'recording-onboard' | 'recording-signal' | 'scene-monitor' | 'snapshot' | 'stream-catalog' | 'stream-params' | 'stream-signals' | 'videoclips' | 'webrtc-session' | 'zone-analytics' | 'zone-rules' | 'zones';
+/** The camera and platform family of the vocabulary. */
+export declare const CAMERA_CAP_VOCABULARY: CapVocabularySlice<CameraCap>;
+export {};

package/dist/device/cap-vocabulary/entries/sensors.d.ts

@@ -0,0 +1,5 @@
+import type { CapVocabularySlice } from '../types.js';
+type SensorCap = 'air-quality-sensor' | 'ambient-light-sensor' | 'binary' | 'carbon-monoxide' | 'connectivity' | 'contact' | 'enum-sensor' | 'flood' | 'gas' | 'humidity-sensor' | 'motion' | 'numeric-sensor' | 'power-meter' | 'presence' | 'pressure-sensor' | 'smoke' | 'tamper' | 'temperature-sensor' | 'vibration' | 'weather' | 'battery' | 'network-link' | 'device-status' | 'doorbell' | 'event-emitter';
+/** The sensor family of the vocabulary. */
+export declare const SENSOR_CAP_VOCABULARY: CapVocabularySlice<SensorCap>;
+export {};

package/dist/device/cap-vocabulary/entries/system.d.ts

@@ -0,0 +1,8 @@
+/**
+ * System-scoped caps. None is part of a DEVICE's vocabulary: they are the
+ * cluster's own machinery, administered from their own pages. Each still has
+ * an entry, so a new cap is a decision rather than an omission.
+ */
+import type { CapVocabularySlice, SystemVocabCapName } from '../types.js';
+/** Every system-scoped cap, with why it is not a device's vocabulary. */
+export declare const SYSTEM_CAP_VOCABULARY: CapVocabularySlice<SystemVocabCapName>;

package/dist/device/cap-vocabulary/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The cap vocabulary (D920) — what every capability lets an operator DO to a
+ * device and WATCH it for, in one cap-keyed map outside the caps.
+ */
+export type { ResolvedBooleanTrigger, ResolvedEnumTrigger, ResolvedEnumValue, ResolvedEventTrigger, ResolvedNumericTrigger, ResolvedValueTrigger, ResolvedVocabAction, ResolvedVocabTrigger, VocabBindingsInput, } from './resolve.js';
+export { actionsForDevice, renderVocabPhrase, triggersForDevice, } from './resolve.js';
+export { VOCAB_TEMPLATES } from './templates.js';
+export type { ActionArgKey, ActionArgs, BooleanOffer, CapEventName, CapMethodName, CapStatusField, CapVocabularyEntry, CapVocabularyMap, CapVocabularySlice, DeviceCapVocabulary, DeviceVocabCapName, DynamicOffer, EnumOffer, EnumStateValue, L10n, LooseCapVocabularyEntry, LooseDynamicOffer, LooseVocabAction, LooseVocabOffer, LooseVocabOpenArg, LooseVocabStateTrigger, NumberOffer, SystemCapVocabulary, SystemVocabCapName, TextOffer, VocabAction, VocabCapName, VocabChoice, VocabEventTrigger, VocabIcon, VocabLocale, VocabOffer, VocabOpenArg, VocabStateTrigger, } from './types.js';
+export { CAP_VOCABULARY, CAP_VOCABULARY_BY_NAME } from './vocabulary.js';

package/dist/device/cap-vocabulary/l10n.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The one way the vocabulary writes a human string: English and Italian side
+ * by side, so neither language can be forgotten in a diff.
+ */
+import type { L10n } from './types.js';
+/** A string in English and Italian. */
+export declare function t(en: string, it: string): L10n;

package/dist/device/cap-vocabulary/resolve.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Resolve a DEVICE's vocabulary from the cap map (D920): the actions it can be
+ * made to do and the triggers it can be watched for, phrased, with the
+ * device-type / role wording applied.
+ *
+ * Walks the device's bindings (D12) and reads only the cap NAME of each entry
+ * — never the binding kind (D13): a wrapped cap and a native one speak the
+ * same words. System caps and caps the map does not know contribute nothing.
+ * The order is the map's order, so a picker draws the same device the same way.
+ */
+import type { CapabilityMethodAccess } from '../../capabilities/capability-definition.js';
+import type { EventCategory } from '../../enums/event-category.js';
+import type { DeviceBinding, DeviceBindingEntry } from '../device-binding.js';
+import type { L10n, LooseDynamicOffer, LooseVocabOpenArg, VocabIcon, VocabLocale } from './types.js';
+/** A device's caps, however the caller holds them. */
+export type VocabBindingsInput = DeviceBinding | readonly DeviceBindingEntry[] | readonly string[];
+/** One action a device can be made to do — the wire is `{ cap, method, args }`. */
+export interface ResolvedVocabAction {
+    readonly id: string;
+    readonly cap: string;
+    readonly method: string;
+    readonly label: L10n;
+    readonly phrase: L10n;
+    readonly icon: VocabIcon;
+    /** Baked args — sent as they are. */
+    readonly args: Readonly<Record<string, unknown>>;
+    /** Args the operator fills, each with how to offer its values. */
+    readonly openArgs: readonly LooseVocabOpenArg[];
+    /** The method's access tier (METHOD_ACCESS_MAP). */
+    readonly access: CapabilityMethodAccess;
+}
+interface ResolvedTriggerBase {
+    readonly id: string;
+    readonly cap: string;
+    readonly label: L10n;
+    readonly icon: VocabIcon;
+}
+/** A true/false field. `…For` phrases carry `{minutes}`. */
+export interface ResolvedBooleanTrigger extends ResolvedTriggerBase {
+    readonly kind: 'boolean';
+    readonly field: string;
+    readonly whenTrue: L10n;
+    readonly whenFalse: L10n;
+    readonly whenTrueFor: L10n;
+    readonly whenFalseFor: L10n;
+}
+/** A number: phrases carry `{threshold}` / `{delta}`. */
+export interface ResolvedNumericTrigger extends ResolvedTriggerBase {
+    readonly kind: 'numeric';
+    readonly field: string;
+    readonly unit: string | null;
+    /** Status field holding the device's own unit, when it states one. */
+    readonly unitField: string | null;
+    readonly above: L10n;
+    readonly below: L10n;
+    readonly changesBy: L10n;
+}
+/** One value of an enum trigger, phrased. */
+export interface ResolvedEnumValue {
+    readonly value: string;
+    readonly label: L10n;
+    readonly phrase: L10n;
+    readonly phraseFor: L10n;
+}
+/** A closed set of states. */
+export interface ResolvedEnumTrigger extends ResolvedTriggerBase {
+    readonly kind: 'enum';
+    readonly field: string;
+    readonly values: readonly ResolvedEnumValue[];
+}
+/** A free value: phrases carry `{value}`. */
+export interface ResolvedValueTrigger extends ResolvedTriggerBase {
+    readonly kind: 'value';
+    readonly field: string;
+    readonly phrase: L10n;
+    readonly phraseFor: L10n;
+    readonly offer: LooseDynamicOffer | null;
+}
+/** A bus event the device emits. */
+export interface ResolvedEventTrigger extends ResolvedTriggerBase {
+    readonly kind: 'event';
+    readonly category: EventCategory;
+    readonly phrase: L10n;
+}
+/** Anything a device can be watched for. */
+export type ResolvedVocabTrigger = ResolvedBooleanTrigger | ResolvedNumericTrigger | ResolvedEnumTrigger | ResolvedValueTrigger | ResolvedEventTrigger;
+/** Fill `{name}` placeholders from `values`; an unknown one stays visible. */
+export declare function renderVocabPhrase(phrase: L10n, locale: VocabLocale, values: Readonly<Record<string, string>>): string;
+/**
+ * The actions a device can be made to do, phrased for its type and role.
+ * An action whose method is no longer routable (absent from
+ * METHOD_ACCESS_MAP, or a read) is dropped.
+ */
+export declare function actionsForDevice(bindings: VocabBindingsInput, deviceType?: string, role?: string | null): readonly ResolvedVocabAction[];
+/**
+ * The triggers a device can be watched for — its state fields, then the bus
+ * events it emits — phrased for its type and role.
+ */
+export declare function triggersForDevice(bindings: VocabBindingsInput, deviceType?: string, role?: string | null): readonly ResolvedVocabTrigger[];
+export {};

package/dist/device/cap-vocabulary/templates.d.ts

@@ -0,0 +1,11 @@
+import type { L10n } from './types.js';
+/** Placeholders: `{quantity}` (with its article), `{device}`, `{threshold}`, `{delta}`. */
+export declare const NUMERIC_ABOVE: L10n;
+export declare const NUMERIC_BELOW: L10n;
+export declare const NUMERIC_CHANGES_BY: L10n;
+/** Placeholders: `{device}`, `{value}` (the value's label). */
+export declare const BECOMES: L10n;
+/** Placeholders: `{trigger}` (a whole trigger phrase), `{minutes}`. */
+export declare const HELD_FOR: L10n;
+/** Every frame, for the completeness test. */
+export declare const VOCAB_TEMPLATES: Readonly<Record<string, L10n>>;