@camstack/types 1.2.283 → 1.2.284

package/dist/capabilities/ptz-autotrack.cap.d.ts

@@ -67,8 +67,7 @@ export declare const ptzAutotrackCapability: {
     readonly deviceNative: true;
     readonly mode: "singleton";
     /**
-     * Two kinds of provider behind one name, the same shape `snapshot` and
-     * `doorbell` use:
+     * Two kinds of provider behind one name, the same shape `snapshot` uses:
      *
      *  - **Native**: the camera's own firmware autotrack, registered per device by
      *    the driver when the probe says it exists (Reolink: yes; Hikvision:
@@ -76,7 +75,7 @@ export declare const ptzAutotrackCapability: {
      *  - **Wrapper**: the emulated implementation (`@camstack/system`'s `autotrack` builtin),
      *    which follows a subject with `ptz.move` pulses driven by the detection
      *    pipeline. `defaultActive: false` — the operator binds it per camera in
-     *    the bindings UI, exactly as `virtual-doorbell` is bound.
+     *    the bindings UI.
      *
      * The binding chooses WHICH implementation answers; `setEnabled` stays the
      * one switch for the function either way. A camera never has both driving its

package/dist/catalogs/sensor-active-state.d.ts

@@ -2,13 +2,12 @@
  * LA tabella "quale booleano di questo tipo di device conta come ALTO", e il
  * valutatore puro del suo FRONTE.
  *
- * Viveva dentro il builtin virtual-doorbell
- * (`@camstack/system` — `builtins/doorbell/trigger-engine.ts`) e i suoi
- * predicati erano privati al modulo. Il recorder ne ha bisogno per il trigger
- * `RecordingTriggers.sensorDeviceIds`: copiarla avrebbe creato la SECONDA
- * tabella, che diverge alla prima cap aggiunta e il cui sintomo — "il sensore
- * fa suonare il campanello ma non registra" — è esattamente D62. Quindi si
- * SPOSTA qui e il doorbell la ri-esporta.
+ * UNA tabella per tutti quelli che chiedono "questo device è ALTO?": il
+ * trigger `RecordingTriggers.sensorDeviceIds` del recorder, i marker dei
+ * sensori della post-analysis, il bridge camera-sensors dell'orchestratore e
+ * le sorgenti di un campanello composto (`doorbellFeatureSources`, D671).
+ * Una seconda copia divergerebbe alla prima cap aggiunta, e il sintomo — "il
+ * sensore fa suonare il campanello ma non registra" — è esattamente D62.
  *
  * ⚠ NON è `DEVICE_STATE_READERS` (`catalogs/device-state-vocabulary.ts`), e le
  * due non vanno unificate: quella risponde a "qual è la PAROLA di stato per una
@@ -65,9 +64,8 @@ export declare function sliceActiveValue(capName: string, slice: Readonly<Record
  *  it is absent, non-numeric or the zero "never observed" sentinel. */
 export declare function sliceChangedAt(capName: string, slice: Readonly<Record<string, unknown>>): number | null;
 /**
- * Perché una slice non ha portato un fronte alto. Stesso vocabolario che il
- * virtual-doorbell riporta dal 2026-08-05: UN enum, così "perché non è scattato
- * niente" ha una risposta sola, chiunque lo chieda.
+ * Perché una slice non ha portato un fronte alto. UN enum, così "perché non è
+ * scattato niente" ha una risposta sola, chiunque lo chieda.
  */
 export type SensorEdgeIgnoreReason = 
 /** Not a recognised binary/switch source cap. */

package/dist/composition/presets/doorbell-feature.d.ts

@@ -16,5 +16,5 @@ export interface DoorbellFeatureInput {
 }
 /** Every source cap of `source` that `SOURCE_CAP_ACTIVE_FIELD` knows AND the device has bound. */
 export declare function doorbellFeatureSources(source: CompositionSourceRef, boundCaps: readonly string[]): readonly DoorbellFeatureSource[];
-/** The D671 feature, byte for byte what the migration writes. Throws on zero sources. */
+/** The canonical D671 doorbell feature. Throws on zero sources. */
 export declare function buildDoorbellCompositionFeature(input: DoorbellFeatureInput): CompositionFieldsFeature;

package/dist/{composition-Dq42XWp0.mjs → composition-43aqsZQj.mjs}

@@ -904,13 +904,12 @@ function chooseFfmpegBinary(input) {
 * LA tabella "quale booleano di questo tipo di device conta come ALTO", e il
 * valutatore puro del suo FRONTE.
 *
-* Viveva dentro il builtin virtual-doorbell
-* (`@camstack/system` — `builtins/doorbell/trigger-engine.ts`) e i suoi
-* predicati erano privati al modulo. Il recorder ne ha bisogno per il trigger
-* `RecordingTriggers.sensorDeviceIds`: copiarla avrebbe creato la SECONDA
-* tabella, che diverge alla prima cap aggiunta e il cui sintomo — "il sensore
-* fa suonare il campanello ma non registra" — è esattamente D62. Quindi si
-* SPOSTA qui e il doorbell la ri-esporta.
+* UNA tabella per tutti quelli che chiedono "questo device è ALTO?": il
+* trigger `RecordingTriggers.sensorDeviceIds` del recorder, i marker dei
+* sensori della post-analysis, il bridge camera-sensors dell'orchestratore e
+* le sorgenti di un campanello composto (`doorbellFeatureSources`, D671).
+* Una seconda copia divergerebbe alla prima cap aggiunta, e il sintomo — "il
+* sensore fa suonare il campanello ma non registra" — è esattamente D62.
 *
 * ⚠ NON è `DEVICE_STATE_READERS` (`catalogs/device-state-vocabulary.ts`), e le
 * due non vanno unificate: quella risponde a "qual è la PAROLA di stato per una

package/dist/{composition-DG4jVTfB.js → composition-w3gBWMer.js}

@@ -904,13 +904,12 @@ function chooseFfmpegBinary(input) {
 * LA tabella "quale booleano di questo tipo di device conta come ALTO", e il
 * valutatore puro del suo FRONTE.
 *
-* Viveva dentro il builtin virtual-doorbell
-* (`@camstack/system` — `builtins/doorbell/trigger-engine.ts`) e i suoi
-* predicati erano privati al modulo. Il recorder ne ha bisogno per il trigger
-* `RecordingTriggers.sensorDeviceIds`: copiarla avrebbe creato la SECONDA
-* tabella, che diverge alla prima cap aggiunta e il cui sintomo — "il sensore
-* fa suonare il campanello ma non registra" — è esattamente D62. Quindi si
-* SPOSTA qui e il doorbell la ri-esporta.
+* UNA tabella per tutti quelli che chiedono "questo device è ALTO?": il
+* trigger `RecordingTriggers.sensorDeviceIds` del recorder, i marker dei
+* sensori della post-analysis, il bridge camera-sensors dell'orchestratore e
+* le sorgenti di un campanello composto (`doorbellFeatureSources`, D671).
+* Una seconda copia divergerebbe alla prima cap aggiunta, e il sintomo — "il
+* sensore fa suonare il campanello ma non registra" — è esattamente D62.
 *
 * ⚠ NON è `DEVICE_STATE_READERS` (`catalogs/device-state-vocabulary.ts`), e le
 * due non vanno unificate: quella risponde a "qual è la PAROLA di stato per una

package/dist/device/hub-motion-read.d.ts

@@ -0,0 +1,22 @@
+/**
+ * A camera's `motion` slice, read from the HUB (D696).
+ *
+ * The orchestrator is the only writer of a camera's `motion` runtime slice, and
+ * it writes the EFFECTIVE value on the hub. A camera provider's local runtime
+ * state therefore holds no `motion` slice, and its `motion.isDetected` answers
+ * from here. Two answers are UNKNOWN, and both make the call fail rather than
+ * answer `false` (D49, D393):
+ * - the read did not answer (the hub is unreachable, the call threw);
+ * - the read answered with no `detected`: nobody has published the camera's
+ *   motion since the hub started (the slice is session-durable).
+ */
+/** The one `deviceState` read this needs. `ctx.api.deviceState` satisfies it. */
+export interface HubMotionSliceReader {
+    readonly getCapSlice: {
+        readonly query: (input: {
+            deviceId: number;
+            capName: string;
+        }) => Promise<Readonly<Record<string, unknown>> | null>;
+    };
+}
+export declare function readHubMotionDetected(deviceState: HubMotionSliceReader, deviceId: number): Promise<boolean>;

package/dist/device-extension/slot-descriptor.d.ts

@@ -3,15 +3,15 @@
  * declared by the capability that already owns the function (D648).
  *
  * A slot is metadata, and behavioural metadata lives in the owning `*.cap.ts`
- * (D4): `device-manager.cap.ts` declares `linked-devices`, `doorbell.cap.ts`
- * declares `doorbell-source`. `npm run codegen` folds every declaration into
+ * (D4): `device-manager.cap.ts` declares `linked-devices`, today the only
+ * slot. `npm run codegen` folds every declaration into
  * `generated/extension-slots.ts` (the id enum, the table and the discriminated
  * union of slot values), and `device-extension` is the device-scoped
  * collection contract that lists and writes them. The contract persists
  * NOTHING: each slot is served by the addon that owns its store (D62).
  *
  * One shape, `association` — the host LISTS other devices (a camera's linked
- * devices, its doorbell trigger sources). Removing every source is "off";
+ * devices). Removing every source is "off";
  * there is no separate switch.
  *
  * A host that GAINS a whole capability from other devices is not a slot: that

package/dist/enums/event-category.d.ts

@@ -530,6 +530,15 @@ export declare enum EventCategory {
      */
     PipelineAudioInferenceResult = "pipeline.audio-inference-result",
     DetectionPhaseTransition = "detection.phase-transition",
+    /**
+     * A camera provider's RAW onboard motion push (D673): the `MotionOnMotionChanged`
+     * data shape without `triggeredBy`, built by `providerMotionEvent`. Its one
+     * consumer is the orchestrator's camera-sensors bridge, which re-emits the
+     * camera's EFFECTIVE onboard motion as `MotionOnMotionChanged` (a pass-through
+     * for a camera with no attached sensor). Providers must not emit
+     * `MotionOnMotionChanged` themselves; `scripts/check-onboard-motion-emitters.ts`
+     * keeps it so (camera-grid is a named, deferred exception).
+     */
     ProviderMotion = "provider.motion",
     ProviderDetection = "provider.detection",
     EnrichmentEmbeddingStored = "enrichment.embedding.stored",

package/dist/enums.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_category = require("./event-category-MbnB-6AN.js");
+const require_event_category = require("./event-category-DmS_tLsU.js");
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/enums.mjs

@@ -1,4 +1,4 @@
-import { t as EventCategory } from "./event-category-C5xZWqz6.mjs";
+import { t as EventCategory } from "./event-category-BGmz_oxW.mjs";
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/{event-category-C5xZWqz6.mjs → event-category-BGmz_oxW.mjs}

@@ -531,6 +531,15 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["PipelineAudioInferenceResult"] = "pipeline.audio-inference-result";
 	EventCategory["DetectionPhaseTransition"] = "detection.phase-transition";
+	/**
+	* A camera provider's RAW onboard motion push (D673): the `MotionOnMotionChanged`
+	* data shape without `triggeredBy`, built by `providerMotionEvent`. Its one
+	* consumer is the orchestrator's camera-sensors bridge, which re-emits the
+	* camera's EFFECTIVE onboard motion as `MotionOnMotionChanged` (a pass-through
+	* for a camera with no attached sensor). Providers must not emit
+	* `MotionOnMotionChanged` themselves; `scripts/check-onboard-motion-emitters.ts`
+	* keeps it so (camera-grid is a named, deferred exception).
+	*/
 	EventCategory["ProviderMotion"] = "provider.motion";
 	EventCategory["ProviderDetection"] = "provider.detection";
 	EventCategory["EnrichmentEmbeddingStored"] = "enrichment.embedding.stored";

package/dist/{event-category-MbnB-6AN.js → event-category-DmS_tLsU.js}

@@ -531,6 +531,15 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["PipelineAudioInferenceResult"] = "pipeline.audio-inference-result";
 	EventCategory["DetectionPhaseTransition"] = "detection.phase-transition";
+	/**
+	* A camera provider's RAW onboard motion push (D673): the `MotionOnMotionChanged`
+	* data shape without `triggeredBy`, built by `providerMotionEvent`. Its one
+	* consumer is the orchestrator's camera-sensors bridge, which re-emits the
+	* camera's EFFECTIVE onboard motion as `MotionOnMotionChanged` (a pass-through
+	* for a camera with no attached sensor). Providers must not emit
+	* `MotionOnMotionChanged` themselves; `scripts/check-onboard-motion-emitters.ts`
+	* keeps it so (camera-grid is a named, deferred exception).
+	*/
 	EventCategory["ProviderMotion"] = "provider.motion";
 	EventCategory["ProviderDetection"] = "provider.detection";
 	EventCategory["EnrichmentEmbeddingStored"] = "enrichment.embedding.stored";

package/dist/generated/extension-slots.d.ts

@@ -6,16 +6,15 @@
  * caps' descriptors and value schemas — never the caps barrel — so
  * `device-extension.cap.ts` can import this module without a cycle.
  *
- * Coverage: 2 slot(s).
+ * Coverage: 1 slot(s).
  */
 import { z } from 'zod';
 import { DeviceType } from '../device/device-type.js';
 import type { ExtensionSlotDescriptor } from '../device-extension/slot-descriptor.js';
 /** Every declared slot id, in table order. */
-export declare const EXTENSION_SLOT_IDS: readonly ["doorbell-source", "linked-devices"];
+export declare const EXTENSION_SLOT_IDS: readonly ["linked-devices"];
 export declare const ExtensionSlotIdSchema: z.ZodEnum<{
     "linked-devices": "linked-devices";
-    "doorbell-source": "doorbell-source";
 }>;
 export type ExtensionSlotId = z.infer<typeof ExtensionSlotIdSchema>;
 /** One row of the table: the descriptor, who declared it, where it is offered. */
@@ -28,9 +27,6 @@ export interface ExtensionSlotEntry {
 export declare const EXTENSION_SLOTS: Readonly<Record<ExtensionSlotId, ExtensionSlotEntry>>;
 /** A slot's editable value, discriminated on `slot`. */
 export declare const ExtensionSlotValueSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    deviceIds: z.ZodArray<z.ZodNumber>;
-    slot: z.ZodLiteral<"doorbell-source">;
-}, z.core.$strip>, z.ZodObject<{
     deviceIds: z.ZodArray<z.ZodNumber>;
     trackedDeviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     slot: z.ZodLiteral<"linked-devices">;

package/dist/index.d.ts

@@ -250,7 +250,10 @@ export type { StateLabel, StateLabelKey, StateLabelLocale } from './i18n/state-l
 export { isStateLabelKey, STATE_LABEL_KEYS, STATE_LABELS, stateLabel, } from './i18n/state-labels.js';
 export { assertTimelapseCadences, DEFAULT_TIMELAPSE_PREVIEW_TEXT, readTimelapseGeneratedAt, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleInputSchema, TimelapseRulePatchSchema, TimelapseRuleSchema, TimelapseTemplateSchema, } from './notification/timelapse-rule.js';
 export { CLUSTER_MODEL_SCOPED_STEPS, CLUSTER_MODEL_SECTION_ID, CLUSTER_STEP_SETTING_FIELDS, type ClusterModelScopedStep, type ClusterStepModels, type ClusterStepSettingField, type ClusterStepSettings, clusterModelSettingKey, clusterStepSettingFieldsFor, clusterStepSettingKey, DEFAULT_CLUSTER_STEP_MODELS, DEFAULT_CLUSTER_STEP_SETTINGS, DEFAULT_MIN_LANDMARK_FACE_SIZE_PX, type HydratedClusterSection, type HydratedClusterView, interpretStoredClusterModel, type InvalidClusterStepModelEntry, invalidClusterStepModelEntries, isClusterScopedStep, overlayClusterStepSettings, pickClusterStepModels, pickClusterStepSettings, pickInvalidClusterStepModels, readClusterStepModels, readClusterStepSettings, resolveClusterStepModelId, type StepModelScope, type StoredClusterModelInterpretation, } from './pipeline/cluster-model-scope.js';
-export { CAMERA_SENSORS_NOT_LOADED, CAMERA_SENSORS_SETTINGS_KEY, CAMERA_TRIGGER, type CameraSensorAttachment, CameraSensorAttachmentSchema, type CameraSensorRef, CameraSensorRefSchema, cameraSensorRefKey, type CameraSensorsConfig, CameraSensorsConfigSchema, type CameraSensorsMode, CameraSensorsModeSchema, type CameraSensorsNotForwarded, CameraSensorsNotForwardedSchema, type CameraSensorsStatus, CameraSensorsStatusSchema, MAX_CAMERA_SENSORS, type MotionTriggeredBy, type MotionTriggeredByReading, MotionTriggeredBySchema, readMotionTriggeredBy, } from './pipeline/camera-sensors.js';
+export { CAMERA_SENSORS_NOT_LOADED, CAMERA_SENSORS_SETTINGS_KEY, CAMERA_TRIGGER, type CameraSensorAttachment, CameraSensorAttachmentSchema, type CameraSensorRef, CameraSensorRefSchema, cameraSensorRefKey, type CameraSensorsConfig, CameraSensorsConfigSchema, type CameraOwnMotion, CameraOwnMotionSchema, type CameraRawLevel, CameraRawLevelSchema, type CameraSensorEntry, CameraSensorEntrySchema, type CameraSensorMode, CameraSensorModeSchema, type CameraSensorsNotEnforced, CameraSensorsNotEnforcedSchema, type CameraSensorsNotForwarded, CameraSensorsNotForwardedSchema, type CameraSensorsStatus, CameraSensorsStatusSchema, DEFAULT_CAMERA_SENSOR_MODE, MAX_CAMERA_SENSORS, type MotionTriggeredBy, type MotionTriggeredByReading, MotionTriggeredBySchema, readMotionTriggeredBy, } from './pipeline/camera-sensors.js';
+export { cameraOwnsMotionViaSensor } from './pipeline/motion-ownership.js';
+export { readHubMotionDetected } from './device/hub-motion-read.js';
+export { type ProviderMotionData, ProviderMotionDataSchema, providerMotionEvent, } from './pipeline/provider-motion.js';
 export { type FormatRunnableModel, stepModelRunsOnFormat, } from './pipeline/step-format-runnable.js';
 export { DEFAULT_DETAIL_CROP_CONVENTION, DETAIL_CROP_PADDING_FIELD, DETAIL_CROP_PADDING_KEY, DETAIL_CROP_SECTION_ID, DETAIL_CROP_SQUARE_KEY, type DetailCropConvention, DetailCropConventionSchema, type DetailCropRect, deriveDetailCropRect, FULL_IMAGE_BBOX, type HydratedSettingsSection, type HydratedSettingsView, pickDetailCropConvention, readDetailCropConvention, } from './pipeline/detail-crop.js';
 export { DEFAULT_NATIVE_LEASE_SETTINGS, NATIVE_LEASE_ACTIVITY_FIELD, NATIVE_LEASE_ACTIVITY_KEY, NATIVE_LEASE_ADMISSION_FIELD, NATIVE_LEASE_ADMISSION_KEY, NATIVE_LEASE_BUDGET_FIELD, NATIVE_LEASE_BUDGET_KEY, NATIVE_LEASE_HOLD_FIELD, NATIVE_LEASE_HOLD_KEY, NATIVE_LEASE_SCENE_BUDGET_FIELD, NATIVE_LEASE_SCENE_BUDGET_KEY, NATIVE_LEASE_SECTION_ID, NATIVE_LEASE_TILE_BUDGET_FIELD, NATIVE_LEASE_TILE_BUDGET_KEY, type NativeLeaseAdmission, NativeLeaseAdmissionSchema, type NativeLeaseKnob, type NativeLeaseNumberKnob, type NativeLeaseSettings, type NativeLeaseSettingsOverride, NativeLeaseSettingsSchema, pickNativeLeaseOverride, readNativeLeaseOverride, } from './pipeline/native-lease.js';