@camstack/types 1.2.193 → 1.2.195

package/dist/{sleep-B8nfmQ8a.js → sleep-9Ix5MtX4.js}

@@ -2792,6 +2792,53 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
 	return DeviceRole;
 }({});
 //#endregion
+//#region src/capabilities/custom-actions.ts
+/**
+* Identity — preserves literal types for downstream inference.
+*
+* The constraint is `Record<string, unknown>` (not `CustomActionsSpec`) so
+* TypeScript does not widen each entry's literal `kind`/`auth` fields to
+* the broader unions declared on `CustomActionSpec`'s default generics.
+* Shape validity is enforced separately by the `customAction(...)` helper
+* whose return type is already a `CustomActionSpec<...>`.
+*/
+function defineCustomActions(spec) {
+	return spec;
+}
+function customAction(input, output, options) {
+	return {
+		input,
+		output,
+		kind: options?.kind ?? "query",
+		auth: options?.auth ?? "protected",
+		scope: options?.scope ?? { kind: "system" },
+		...options?.caller ? { caller: "required" } : {}
+	};
+}
+function deviceCustomAction(input, output, options) {
+	return {
+		input,
+		output,
+		kind: options?.kind ?? "query",
+		auth: options?.auth ?? "protected",
+		scope: {
+			kind: "device",
+			...options?.deviceTypes ? { deviceTypes: options.deviceTypes } : {}
+		}
+	};
+}
+/** Strip a catalog to what crosses the wire. Pure; the schemas are not touched. */
+function describeCustomActions(catalog) {
+	const out = {};
+	for (const [name, spec] of Object.entries(catalog)) out[name] = {
+		kind: spec.kind,
+		auth: spec.auth,
+		scope: spec.scope,
+		...spec.caller === "required" ? { caller: "required" } : {}
+	};
+	return out;
+}
+//#endregion
 //#region src/device/children-batch-max.ts
 /**
 * Most parents one `getChildrenBatch` may name.
@@ -4611,6 +4658,30 @@ Object.defineProperty(exports, "createSliceHandle", {
 		return createSliceHandle;
 	}
 });
+Object.defineProperty(exports, "customAction", {
+	enumerable: true,
+	get: function() {
+		return customAction;
+	}
+});
+Object.defineProperty(exports, "defineCustomActions", {
+	enumerable: true,
+	get: function() {
+		return defineCustomActions;
+	}
+});
+Object.defineProperty(exports, "describeCustomActions", {
+	enumerable: true,
+	get: function() {
+		return describeCustomActions;
+	}
+});
+Object.defineProperty(exports, "deviceCustomAction", {
+	enumerable: true,
+	get: function() {
+		return deviceCustomAction;
+	}
+});
 Object.defineProperty(exports, "deviceOpsCapability", {
 	enumerable: true,
 	get: function() {

package/dist/{sleep-BEyvfshj.mjs → sleep-B9qx0cEV.mjs}

@@ -2792,6 +2792,53 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
 	return DeviceRole;
 }({});
 //#endregion
+//#region src/capabilities/custom-actions.ts
+/**
+* Identity — preserves literal types for downstream inference.
+*
+* The constraint is `Record<string, unknown>` (not `CustomActionsSpec`) so
+* TypeScript does not widen each entry's literal `kind`/`auth` fields to
+* the broader unions declared on `CustomActionSpec`'s default generics.
+* Shape validity is enforced separately by the `customAction(...)` helper
+* whose return type is already a `CustomActionSpec<...>`.
+*/
+function defineCustomActions(spec) {
+	return spec;
+}
+function customAction(input, output, options) {
+	return {
+		input,
+		output,
+		kind: options?.kind ?? "query",
+		auth: options?.auth ?? "protected",
+		scope: options?.scope ?? { kind: "system" },
+		...options?.caller ? { caller: "required" } : {}
+	};
+}
+function deviceCustomAction(input, output, options) {
+	return {
+		input,
+		output,
+		kind: options?.kind ?? "query",
+		auth: options?.auth ?? "protected",
+		scope: {
+			kind: "device",
+			...options?.deviceTypes ? { deviceTypes: options.deviceTypes } : {}
+		}
+	};
+}
+/** Strip a catalog to what crosses the wire. Pure; the schemas are not touched. */
+function describeCustomActions(catalog) {
+	const out = {};
+	for (const [name, spec] of Object.entries(catalog)) out[name] = {
+		kind: spec.kind,
+		auth: spec.auth,
+		scope: spec.scope,
+		...spec.caller === "required" ? { caller: "required" } : {}
+	};
+	return out;
+}
+//#endregion
 //#region src/device/children-batch-max.ts
 /**
 * Most parents one `getChildrenBatch` may name.
@@ -4257,4 +4304,4 @@ function sleepCancellable(ms, signal) {
 	});
 }
 //#endregion
-export { CameraStreamSchema as $, DEVICE_STATUS_METHOD as A, collectHydratedFieldValues as At, toNodeId as B, ChargingStatus as C, createDurableState as Ct, adminUiCapability as D, WELL_KNOWN_TABS as Dt, DeviceType as E, isEvent as Et, resolveCapMount as F, expandAudioChunkToF32le as Ft, scopeKey as G, ReadinessTimeoutError as H, systemMethod as I, isAudioChunkFormat as It, BrokerStatusSchema as J, AudioChunkFormatSchema as K, CAP_NODE_PIN_CONTEXT_KEY as L, expandCapMethods as M, resolveHydratedFieldValue as Mt, isDeviceConfigCap as N, AUDIO_CHUNK_FORMATS as Nt, DEFAULT_RUNTIME_STATE_DURABILITY as O, WELL_KNOWN_TAB_MAP as Ot, method as P, audioChunkBytesPerSample as Pt, CamStreamResolutionSchema as Q, nodePin as R, DEVICE_CHILDREN_BATCH_MAX as S, normalizeAddonInitResult as St, DeviceRole as T, emitReadiness as Tt, emitDownForOwnedCaps as U, ReadinessRegistry as V, readinessKey as W, CamProfileSchema as X, CAM_PROFILE_ORDER as Y, CamStreamKindSchema as Z, createMirrorSource as _, selectAssignedProfileSlots as _t, asJsonObject as a, ProfileRtspEntrySchema as at, deviceOpsCapability as b, DisposerChain as bt, parseJsonArray as c, StreamSourceEntrySchema$1 as ct, BOOT_RECOVERY_BACKOFF_MS as d, SubscribeAudioChunksResultSchema as dt, DecodedAudioChunkSchema as et, DEVICE_SCOPED_CAPS as f, SubscribeFramesInputSchema as ft, createLazyTrpcSource as g, parseProfileBrokerId as gt, createEventBusSliceSource as h, makeSourceBrokerId as ht, asJsonArray as i, FrameHandleSchema as it, event as j, hydrateSchema as jt, DEVICE_SETTINGS_CONTRIBUTION_METHODS as k, collectHydratedFieldEntries as kt, parseJsonObject as l, StreamSourceSchema as lt, createDeviceProxy as m, makeProfileBrokerId as mt, sleepCancellable as n, EncodedPacketSchema as nt, asNumber as o, ProfileSlotSchema as ot, isDeviceScopedCap as p, SubscribeFramesResultSchema as pt, BrokerStatsSchema as q, asBoolean as r, FrameHandleFormatSchema as rt, asString as s, ProfileSlotStatusSchema as st, sleep as t, DecodedFrameSchema as tt, parseJsonUnknown as u, SubscribeAudioChunksInputSchema as ut, createSliceHandle as v, DATAPLANE_SECRET_HEADER as vt, DeviceFeature as w, createEvent as wt, viewerUiCapability as x, BaseAddon as xt, RawStateResultSchema as y, SHARE_VIEW_KINDS as yt, readNodePin as z };
+export { CAM_PROFILE_ORDER as $, DeviceType as A, isEvent as At, systemMethod as B, isAudioChunkFormat as Bt, customAction as C, SHARE_VIEW_KINDS as Ct, ChargingStatus as D, createDurableState as Dt, deviceCustomAction as E, normalizeAddonInitResult as Et, event as F, hydrateSchema as Ft, ReadinessRegistry as G, nodePin as H, expandCapMethods as I, resolveHydratedFieldValue as It, readinessKey as J, ReadinessTimeoutError as K, isDeviceConfigCap as L, AUDIO_CHUNK_FORMATS as Lt, DEFAULT_RUNTIME_STATE_DURABILITY as M, WELL_KNOWN_TAB_MAP as Mt, DEVICE_SETTINGS_CONTRIBUTION_METHODS as N, collectHydratedFieldEntries as Nt, DeviceFeature as O, createEvent as Ot, DEVICE_STATUS_METHOD as P, collectHydratedFieldValues as Pt, BrokerStatusSchema as Q, method as R, audioChunkBytesPerSample as Rt, DEVICE_CHILDREN_BATCH_MAX as S, DATAPLANE_SECRET_HEADER as St, describeCustomActions as T, BaseAddon as Tt, readNodePin as U, CAP_NODE_PIN_CONTEXT_KEY as V, toNodeId as W, AudioChunkFormatSchema as X, scopeKey as Y, BrokerStatsSchema as Z, createMirrorSource as _, SubscribeFramesResultSchema as _t, asJsonObject as a, DecodedFrameSchema as at, deviceOpsCapability as b, parseProfileBrokerId as bt, parseJsonArray as c, FrameHandleSchema as ct, BOOT_RECOVERY_BACKOFF_MS as d, ProfileSlotStatusSchema as dt, CamProfileSchema as et, DEVICE_SCOPED_CAPS as f, StreamSourceEntrySchema$1 as ft, createLazyTrpcSource as g, SubscribeFramesInputSchema as gt, createEventBusSliceSource as h, SubscribeAudioChunksResultSchema as ht, asJsonArray as i, DecodedAudioChunkSchema as it, adminUiCapability as j, WELL_KNOWN_TABS as jt, DeviceRole as k, emitReadiness as kt, parseJsonObject as l, ProfileRtspEntrySchema as lt, createDeviceProxy as m, SubscribeAudioChunksInputSchema as mt, sleepCancellable as n, CamStreamResolutionSchema as nt, asNumber as o, EncodedPacketSchema as ot, isDeviceScopedCap as p, StreamSourceSchema as pt, emitDownForOwnedCaps as q, asBoolean as r, CameraStreamSchema as rt, asString as s, FrameHandleFormatSchema as st, sleep as t, CamStreamKindSchema as tt, parseJsonUnknown as u, ProfileSlotSchema as ut, createSliceHandle as v, makeProfileBrokerId as vt, defineCustomActions as w, DisposerChain as wt, viewerUiCapability as x, selectAssignedProfileSlots as xt, RawStateResultSchema as y, makeSourceBrokerId as yt, resolveCapMount as z, expandAudioChunkToF32le as zt };

package/dist/types/detection.d.ts

@@ -1,4 +1,5 @@
 import type { FirstLevelMacroClass } from './labels.js';
+import type { TrackState } from '../capabilities/pipeline-analytics.cap.js';
 import type { BoundingBox as EngineBoundingBox, FrameInput, Landmark } from './io.js';
 export interface SpatialDetection {
     readonly class: string;
@@ -126,9 +127,29 @@ export type MacroClass = FirstLevelMacro | DetailMacro | 'audio' | string;
 /** Tracker-enriched info attached to first-level detections only. */
 export interface TrackInfo {
     readonly trackId: string;
-    readonly moving?: boolean;
-    /** Pixels per second in frame coordinates. */
-    readonly speedPx?: number;
+    /**
+     * What the tracker says this subject is DOING, as of this frame.
+     *
+     * Computed for every track on every frame by `StateAnalyzer` (10 s to
+     * `stationary`) and carried here so a consumer can draw a parked car
+     * differently from one that is moving — which is the whole reason the
+     * verdict is computed.
+     *
+     * It replaces an unused `moving?: boolean` (and a `speedPx?: number`) that
+     * sat here declared and NEVER assigned anywhere in the repo, while the live
+     * overlay drew a person standing still exactly like one walking. A boolean
+     * would also have been lossy: `stationary` and `loitering` are different
+     * things to show.
+     *
+     * ABSENT means the tracker has not classified this track yet — not "moving".
+     * A fresh track must not flash as stationary for its first frames.
+     *
+     * The CANONICAL `TrackState`, the same enum tracks and events already carry
+     * (`idle` is the still one — `stationary` and `loitering` both map into it).
+     * Deliberately not `ObjectState`, the analyzer's internal spelling: one fact
+     * with two vocabularies on the wire is how two readers start disagreeing.
+     */
+    readonly movementState?: TrackState;
     /** IDs of zones the bbox overlaps at this frame. */
     readonly zones?: readonly string[];
     /** Wall-clock timestamp (ms) when the track was first seen. */

package/dist/types/models.d.ts

@@ -236,9 +236,9 @@ export declare const ModelCatalogEntrySchema: z.ZodObject<{
         nhwc: "nhwc";
     }>>;
     inputNormalization: z.ZodOptional<z.ZodEnum<{
+        none: "none";
         "zero-one": "zero-one";
         imagenet: "imagenet";
-        none: "none";
     }>>;
     outputProbabilities: z.ZodOptional<z.ZodBoolean>;
     preprocessMode: z.ZodOptional<z.ZodEnum<{
@@ -351,19 +351,19 @@ export declare const ModelConvertMetadataSchema: z.ZodObject<{
         nhwc: "nhwc";
     }>>;
     inputNormalization: z.ZodOptional<z.ZodEnum<{
+        none: "none";
         "zero-one": "zero-one";
         imagenet: "imagenet";
-        none: "none";
     }>>;
     preprocessMode: z.ZodOptional<z.ZodEnum<{
         letterbox: "letterbox";
         resize: "resize";
     }>>;
     outputFormat: z.ZodEnum<{
+        classification: "classification";
         yolo: "yolo";
         ssd: "ssd";
         embedding: "embedding";
-        classification: "classification";
         ocr: "ocr";
         segmentation: "segmentation";
     }>;
@@ -481,9 +481,9 @@ export declare const ConvertResultSchema: z.ZodObject<{
             nhwc: "nhwc";
         }>>;
         inputNormalization: z.ZodOptional<z.ZodEnum<{
+            none: "none";
             "zero-one": "zero-one";
             imagenet: "imagenet";
-            none: "none";
         }>>;
         outputProbabilities: z.ZodOptional<z.ZodBoolean>;
         preprocessMode: z.ZodOptional<z.ZodEnum<{

package/package.json

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