@camstack/types 1.1.50 → 1.1.51

package/dist/capabilities/index.d.ts

@@ -78,7 +78,7 @@ export { type ILlmRuntimeProvider, llmRuntimeCapability, type LlmNodeModel, LlmN
 export { type LlmErrorCode, LlmErrorCodeSchema, type LlmGenerateBaseInput, LlmGenerateBaseInputSchema, type LlmGenerateErr, LlmGenerateErrSchema, type LlmGenerateOk, LlmGenerateOkSchema, type LlmGenerateResult, LlmGenerateResultSchema, type LlmImage, LlmImageSchema, type LlmUsage, LlmUsageSchema, } from './llm-shared.js';
 export { type IOauthIntegrationProvider, type OauthIntegrationDescriptor, OauthIntegrationDescriptorSchema, oauthIntegrationCapability, } from './oauth-integration.cap.js';
 export { type AudioEvent, AudioEventSchema, type DetectionSource, DetectionSourceSchema, type EventKind, type EventKindCategory, EventKindCategorySchema, type EventKindDescriptor, EventKindDescriptorSchema, type EventKindIcon, EventKindIconSchema, EventKindSchema, type EventPruneCounts, type EventStoreDeviceFootprint, type EventStoreFootprint, type IPipelineAnalyticsProvider, type KeyEvent, KeyEventSchema, type MediaFile, type MediaFileKind, MediaFileSchema, type MotionEvent, MotionEventSchema, type ObjectEvent, ObjectEventSchema, pipelineAnalyticsCapability, type RecentTracksPage, RecentTracksPageSchema, type RecentTracksQuery, RecentTracksQueryInput, type ScoredObjectEvent, ScoredObjectEventSchema, type SensorEvent, SensorEventSchema, type Track, type TrackCascadeCounts, TrackCascadeCountsSchema, TrackedDetectionSchema, type TrackEnvelope, TrackEnvelopeSchema, type TrackProjection, TrackProjectionSchema, TrackSchema, type TrackState, TrackStateSchema, type TrackZoneFilter, TrackZoneFilterSchema, } from './pipeline-analytics.cap.js';
-export { EVENT_KIND_BY_CAP, type SensorEventKindDescriptor } from './sensor-event-kinds.js';
+export { EVENT_KIND_BY_CAP, EVENTFUL_CAP_NAMES, buildEventKindDescriptor, type SensorEventKindDescriptor, } from './sensor-event-kinds.js';
 export type { PipelineStepInputOutput, PipelineValidationIssue, PipelineValidationResult, } from './pipeline-executor.cap.js';
 export { ModelSubstitutionSchema, PipelineDefaultStepSchema, PipelineEngineChoiceSchema, PipelineRunResultBridge, PipelineStepInputSchema, PipelineValidationIssueSchema, PipelineValidationResultSchema, pipelineExecutorCapability, } from './pipeline-executor.cap.js';
 export type { CameraAssignmentStatus, CameraAudioStatus, CameraBrokerProfile, CameraBrokerStatus, CameraDecoderShm, CameraDecoderStatus, CameraDetectionPhase, CameraDetectionProvisioning, CameraDetectionProvisioningState, CameraDetectionStatus, CameraMotionStatus, CameraRecordingMode, CameraRecordingStatus, CameraSourceStatus, CameraSourceStream, CameraStatus, IngestOwner, } from './pipeline-orchestrator.cap.js';

package/dist/capabilities/pipeline-analytics.cap.d.ts

@@ -76,6 +76,7 @@ export declare const EventKindIconSchema: z.ZodEnum<{
 export type EventKindIcon = z.infer<typeof EventKindIconSchema>;
 export declare const EventKindCategorySchema: z.ZodEnum<{
     sensor: "sensor";
+    control: "control";
     audio: "audio";
     custom: "custom";
     motion: "motion";
@@ -83,10 +84,18 @@ export declare const EventKindCategorySchema: z.ZodEnum<{
     detection: "detection";
 }>;
 export type EventKindCategory = z.infer<typeof EventKindCategorySchema>;
+/** Taxonomy level — macro (timeline lane) vs sub (events-page leaf). */
+export declare const EventKindLevelSchema: z.ZodEnum<{
+    sub: "sub";
+    macro: "macro";
+}>;
+export type EventKindLevel = z.infer<typeof EventKindLevelSchema>;
 declare const EventKindDescriptorSchema: z.ZodObject<{
     kind: z.ZodString;
+    labelKey: z.ZodString;
     label: z.ZodString;
     color: z.ZodString;
+    iconId: z.ZodString;
     icon: z.ZodEnum<{
         button: "button";
         generic: "generic";
@@ -103,12 +112,18 @@ declare const EventKindDescriptorSchema: z.ZodObject<{
     }>;
     category: z.ZodEnum<{
         sensor: "sensor";
+        control: "control";
         audio: "audio";
         custom: "custom";
         motion: "motion";
         package: "package";
         detection: "detection";
     }>;
+    parentKind: z.ZodNullable<z.ZodString>;
+    level: z.ZodEnum<{
+        sub: "sub";
+        macro: "macro";
+    }>;
     source: z.ZodObject<{
         capName: z.ZodString;
         deviceId: z.ZodNumber;
@@ -168,11 +183,27 @@ declare const TrackAudioLabelSchema: z.ZodObject<{
     lastAt: z.ZodNumber;
 }, z.core.$strip>;
 export type TrackAudioLabel = z.infer<typeof TrackAudioLabelSchema>;
+/**
+ * How a track was produced. `pipeline` (default / absent) = the spatial
+ * detection+tracking pipeline. `sensor` = a SYNTHETIC track projected from a
+ * linked sensor/control state change (no positions; carries a snapshot). The
+ * spatial subsystems (tracker association, occupancy count, re-id/embedding,
+ * resurrection) MUST skip `sensor` tracks — they have no bbox trajectory.
+ */
+export declare const TrackSourceSchema: z.ZodEnum<{
+    sensor: "sensor";
+    pipeline: "pipeline";
+}>;
+export type TrackSource = z.infer<typeof TrackSourceSchema>;
 declare const TrackSchema: z.ZodObject<{
     trackId: z.ZodString;
     deviceId: z.ZodNumber;
     className: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodEnum<{
+        sensor: "sensor";
+        pipeline: "pipeline";
+    }>>;
     firstSeen: z.ZodNumber;
     lastSeen: z.ZodNumber;
     positions: z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -365,6 +396,10 @@ declare const RecentTracksPageSchema: z.ZodObject<{
         deviceId: z.ZodNumber;
         className: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<{
+            sensor: "sensor";
+            pipeline: "pipeline";
+        }>>;
         firstSeen: z.ZodNumber;
         lastSeen: z.ZodNumber;
         positions: z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -541,6 +576,10 @@ export declare const pipelineAnalyticsCapability: {
             deviceId: z.ZodNumber;
             className: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            source: z.ZodOptional<z.ZodEnum<{
+                sensor: "sensor";
+                pipeline: "pipeline";
+            }>>;
             firstSeen: z.ZodNumber;
             lastSeen: z.ZodNumber;
             positions: z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -605,6 +644,10 @@ export declare const pipelineAnalyticsCapability: {
             deviceId: z.ZodNumber;
             className: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            source: z.ZodOptional<z.ZodEnum<{
+                sensor: "sensor";
+                pipeline: "pipeline";
+            }>>;
             firstSeen: z.ZodNumber;
             lastSeen: z.ZodNumber;
             positions: z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -691,6 +734,10 @@ export declare const pipelineAnalyticsCapability: {
             deviceId: z.ZodNumber;
             className: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            source: z.ZodOptional<z.ZodEnum<{
+                sensor: "sensor";
+                pipeline: "pipeline";
+            }>>;
             firstSeen: z.ZodNumber;
             lastSeen: z.ZodNumber;
             positions: z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -773,6 +820,10 @@ export declare const pipelineAnalyticsCapability: {
                 deviceId: z.ZodNumber;
                 className: z.ZodString;
                 label: z.ZodOptional<z.ZodString>;
+                source: z.ZodOptional<z.ZodEnum<{
+                    sensor: "sensor";
+                    pipeline: "pipeline";
+                }>>;
                 firstSeen: z.ZodNumber;
                 lastSeen: z.ZodNumber;
                 positions: z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -941,8 +992,10 @@ export declare const pipelineAnalyticsCapability: {
             deviceId: z.ZodNumber;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             kind: z.ZodString;
+            labelKey: z.ZodString;
             label: z.ZodString;
             color: z.ZodString;
+            iconId: z.ZodString;
             icon: z.ZodEnum<{
                 button: "button";
                 generic: "generic";
@@ -959,12 +1012,18 @@ export declare const pipelineAnalyticsCapability: {
             }>;
             category: z.ZodEnum<{
                 sensor: "sensor";
+                control: "control";
                 audio: "audio";
                 custom: "custom";
                 motion: "motion";
                 package: "package";
                 detection: "detection";
             }>;
+            parentKind: z.ZodNullable<z.ZodString>;
+            level: z.ZodEnum<{
+                sub: "sub";
+                macro: "macro";
+            }>;
             source: z.ZodObject<{
                 capName: z.ZodString;
                 deviceId: z.ZodNumber;

package/dist/capabilities/sensor-event-kinds.d.ts

@@ -1,25 +1,42 @@
 /**
- * Static event-kind descriptors for the SENSOR cap family — the mapping
+ * Cap → event-kind mapping for the SENSOR / CONTROL cap families — the table
  * `pipeline-analytics.listEventKinds` uses to turn a linked device's bound
- * sensor caps (contact / flood / gas / carbon-monoxide / enum-sensor /
- * event-emitter) into per-camera event-kind entries.
+ * caps into per-camera event-kind descriptors.
  *
- * Lives beside the sensor cap definitions so adding a new sensor cap and its
- * event-kind descriptor happens in one place. The `source` field of the full
- * `EventKindDescriptor` is stamped at compose time (per linked device) — this
- * map carries only the static half.
+ * The descriptor DATA (color / iconId / labelKey / parentKind / category)
+ * is NOT duplicated here — every entry is derived from the single
+ * `EVENT_TAXONOMY` dictionary (`catalogs/event-taxonomy.ts`). This file owns
+ * ONLY the cap-name → taxonomy-kind mapping. Adding a new eventful sensor /
+ * control cap means adding one line here (and a taxonomy entry); the anti-
+ * drift guard `scripts/check-event-kind-coverage.ts` fails the build if an
+ * eventful cap is missing.
  */
-import type { EventKindCategory, EventKindIcon } from './pipeline-analytics.cap.js';
-/** The static half of an `EventKindDescriptor` (no per-device `source`). */
-export interface SensorEventKindDescriptor {
-    readonly kind: string;
-    readonly label: string;
-    readonly color: string;
+import { type EventTaxonomyEntry } from '../catalogs/event-taxonomy.js';
+import type { EventKindDescriptor, EventKindIcon } from './pipeline-analytics.cap.js';
+/**
+ * The static half of an `EventKindDescriptor` (no per-device `source`).
+ * Extends the taxonomy entry with the legacy closed-enum `icon` glyph kept
+ * as a fallback for clients that predate `iconId`.
+ */
+export interface SensorEventKindDescriptor extends EventTaxonomyEntry {
+    /** Legacy closed-vocab glyph — fallback for `iconId`. */
     readonly icon: EventKindIcon;
-    readonly category: EventKindCategory;
 }
 /**
- * Sensor cap name → static event-kind descriptor. A linked device
+ * Sensor / control cap name → static event-kind descriptor. A linked device
  * contributes one entry per bound cap present in this map.
  */
 export declare const EVENT_KIND_BY_CAP: Readonly<Record<string, SensorEventKindDescriptor>>;
+/** The cap names covered by the taxonomy (for the anti-drift guard). */
+export declare const EVENTFUL_CAP_NAMES: readonly string[];
+/**
+ * Build a full `EventKindDescriptor` for a taxonomy `kind`, stamping the
+ * per-device `source`. Returns null when `kind` is not in the taxonomy.
+ * This is THE bridge from the serializable taxonomy dictionary to the cap
+ * wire shape — every event-kind descriptor the server emits goes through it,
+ * so color/iconId/labelKey are never re-declared at a call site.
+ */
+export declare function buildEventKindDescriptor(kind: string, source: {
+    readonly capName: string;
+    readonly deviceId: number;
+}): EventKindDescriptor | null;

package/dist/catalogs/event-taxonomy.d.ts

@@ -0,0 +1,44 @@
+export type EventTaxonomyCategory = 'motion' | 'audio' | 'detection' | 'sensor' | 'control' | 'package' | 'custom';
+export type EventTaxonomyLevel = 'macro' | 'sub';
+/**
+ * The static, serializable half of an event kind. Descriptors surfaced by
+ * `listEventKinds` extend this with a per-device `source`.
+ */
+export interface EventTaxonomyEntry {
+    /** Unique kind id ('vehicle', 'car', 'lock', 'audio-dog', …). */
+    readonly kind: string;
+    /** Macro parent ('car' → 'vehicle'); null for a macro. */
+    readonly parentKind: string | null;
+    /** Derived from `parentKind` — explicit for the UI. */
+    readonly level: EventTaxonomyLevel;
+    readonly category: EventTaxonomyCategory;
+    /** Hex color for timeline/legend rendering. */
+    readonly color: string;
+    /** Dictionary id → lucide component on the UI side. */
+    readonly iconId: string;
+    /** i18n key; `label` is the English fallback. */
+    readonly labelKey: string;
+    /** English fallback label (UI translates `labelKey` when it can). */
+    readonly label: string;
+}
+export declare const TAXONOMY_COLORS: {
+    readonly motion: "#f59e0b";
+    readonly audio: "#06b6d4";
+    readonly person: "#22c55e";
+    readonly vehicle: "#3b82f6";
+    readonly animal: "#f97316";
+    readonly package: "#a855f7";
+    readonly sensor: "#8b5cf6";
+    readonly control: "#10b981";
+    readonly genericDetection: "#64748b";
+};
+/** Global default color when a kind is unknown (matches legacy box-drawer). */
+export declare const DEFAULT_EVENT_COLOR = "#22ff55";
+/** The complete taxonomy dictionary, keyed by kind. */
+export declare const EVENT_TAXONOMY: Readonly<Record<string, EventTaxonomyEntry>>;
+/** Taxonomy entry for a kind, or undefined when unknown. */
+export declare function getTaxonomyEntry(kind: string): EventTaxonomyEntry | undefined;
+/** Color for a kind — dictionary value, else the global default. */
+export declare function colorForKind(kind: string): string;
+/** The sub kinds whose `parentKind` is `macro` (empty for a leaf macro). */
+export declare function subKindsOf(macro: string): readonly EventTaxonomyEntry[];

package/dist/catalogs/index.d.ts

@@ -1 +1,3 @@
 export * from './coco-classmap.js';
+export * from './audio-classmap.js';
+export * from './event-taxonomy.js';

package/dist/generated/addon-api.d.ts

@@ -9671,6 +9671,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 state: "idle" | "left" | "moving" | "new" | "entered";
                 active: boolean;
                 label?: string | undefined;
+                source?: "pipeline" | "sensor" | undefined;
                 classes?: readonly string[] | undefined;
                 importance?: number | undefined;
                 bestEventId?: string | undefined;
@@ -9734,6 +9735,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 state: "idle" | "left" | "moving" | "new" | "entered";
                 active: boolean;
                 label?: string | undefined;
+                source?: "pipeline" | "sensor" | undefined;
                 classes?: readonly string[] | undefined;
                 importance?: number | undefined;
                 bestEventId?: string | undefined;
@@ -9813,6 +9815,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 state: "idle" | "left" | "moving" | "new" | "entered";
                 active: boolean;
                 label?: string | undefined;
+                source?: "pipeline" | "sensor" | undefined;
                 classes?: readonly string[] | undefined;
                 importance?: number | undefined;
                 bestEventId?: string | undefined;
@@ -9881,6 +9884,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                     state: "idle" | "left" | "moving" | "new" | "entered";
                     active: boolean;
                     label?: string | undefined;
+                    source?: "pipeline" | "sensor" | undefined;
                     classes?: readonly string[] | undefined;
                     importance?: number | undefined;
                     bestEventId?: string | undefined;
@@ -10012,10 +10016,14 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
             };
             output: readonly {
                 kind: string;
+                labelKey: string;
                 label: string;
                 color: string;
+                iconId: string;
                 icon: "motion" | "smoke" | "button" | "audio" | "person" | "vehicle" | "animal" | "package" | "generic" | "door" | "pir" | "water";
-                category: "custom" | "motion" | "audio" | "package" | "sensor" | "detection";
+                category: "custom" | "motion" | "control" | "audio" | "package" | "sensor" | "detection";
+                parentKind: string | null;
+                level: "sub" | "macro";
                 source: {
                     capName: string;
                     deviceId: number;
@@ -26409,6 +26417,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 state: "idle" | "left" | "moving" | "new" | "entered";
                 active: boolean;
                 label?: string | undefined;
+                source?: "pipeline" | "sensor" | undefined;
                 classes?: readonly string[] | undefined;
                 importance?: number | undefined;
                 bestEventId?: string | undefined;
@@ -26472,6 +26481,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 state: "idle" | "left" | "moving" | "new" | "entered";
                 active: boolean;
                 label?: string | undefined;
+                source?: "pipeline" | "sensor" | undefined;
                 classes?: readonly string[] | undefined;
                 importance?: number | undefined;
                 bestEventId?: string | undefined;
@@ -26551,6 +26561,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 state: "idle" | "left" | "moving" | "new" | "entered";
                 active: boolean;
                 label?: string | undefined;
+                source?: "pipeline" | "sensor" | undefined;
                 classes?: readonly string[] | undefined;
                 importance?: number | undefined;
                 bestEventId?: string | undefined;
@@ -26619,6 +26630,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                     state: "idle" | "left" | "moving" | "new" | "entered";
                     active: boolean;
                     label?: string | undefined;
+                    source?: "pipeline" | "sensor" | undefined;
                     classes?: readonly string[] | undefined;
                     importance?: number | undefined;
                     bestEventId?: string | undefined;
@@ -26750,10 +26762,14 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
             };
             output: readonly {
                 kind: string;
+                labelKey: string;
                 label: string;
                 color: string;
+                iconId: string;
                 icon: "motion" | "smoke" | "button" | "audio" | "person" | "vehicle" | "animal" | "package" | "generic" | "door" | "pir" | "water";
-                category: "custom" | "motion" | "audio" | "package" | "sensor" | "detection";
+                category: "custom" | "motion" | "control" | "audio" | "package" | "sensor" | "detection";
+                parentKind: string | null;
+                level: "sub" | "macro";
                 source: {
                     capName: string;
                     deviceId: number;

package/dist/index.d.ts

@@ -119,6 +119,7 @@ export { runInferenceStep } from './utils/run-inference-step.js';
 export type { InferenceStepResult } from './utils/run-inference-step.js';
 export { COCO_80_LABELS, COCO_TO_MACRO, MACRO_LABELS, } from './catalogs/coco-classmap.js';
 export { AUDIO_MACRO_LABELS, YAMNET_TO_MACRO, APPLE_SA_TO_MACRO, mapAudioLabelToMacro, getAudioMacroClassIds, } from './catalogs/audio-classmap.js';
+export { EVENT_TAXONOMY, TAXONOMY_COLORS, DEFAULT_EVENT_COLOR, getTaxonomyEntry, colorForKind, subKindsOf, type EventTaxonomyEntry, type EventTaxonomyCategory, type EventTaxonomyLevel, } from './catalogs/event-taxonomy.js';
 export type { CameraMotionConfig, CameraNativeDetectionConfig, CameraDetectionCapabilities, } from './types/camera-detection.js';
 export { type DeviceTypeInfo, DEVICE_TYPE_INFO } from './types/device-type.js';
 export type { DeviceBinding, DeviceBindingEntry } from './device/device-binding.js';