@camstack/types 1.2.304 → 1.2.305

package/dist/interfaces/event-bus.d.ts

@@ -508,8 +508,31 @@ export interface PhaseTransitionPayload {
     cooldownMs?: number;
     /** Ms epoch of the transition. */
     timestamp?: number;
+    /**
+     * Why the phase changed. `motion`: the runner's motion gate (an `on-motion`
+     * registration) — `source` and `cooldownMs` are set. `attach` / `detach`:
+     * the camera was attached `always-on` (every on-motion detection SESSION
+     * is) or detached while active. An attach names the motion that opened the
+     * session (`source` + `triggeredBy`) when the orchestrator sent it; a
+     * detach names none. `cooldownMs` is absent on both. Absent on a runner older than 2026-10-06,
+     * whose attach claimed `source: 'analyzer'` and whose detach emitted
+     * nothing.
+     */
+    cause?: PhaseTransitionCause;
+    /**
+     * On a `cause: 'attach'` of an on-motion SESSION: what raised the motion
+     * that opened it (D672) — the camera itself, or an attached sensor with its
+     * deviceId. `source` is then the motion source that passed the camera's
+     * gate. Absent on an attach with no motion behind it (occupancy burst,
+     * standing always-on camera, re-dispatch) and from an orchestrator that does
+     * not send `sessionTrigger`.
+     */
+    triggeredBy?: import('../pipeline/camera-sensors.js').MotionTriggeredBy;
+    /** The attached sensor's device name when `triggeredBy.kind === 'sensor'` and it is known. */
+    sensorName?: string;
     [key: string]: unknown;
 }
+export type PhaseTransitionCause = 'motion' | 'attach' | 'detach';
 /**
  * Scope of a readiness transition — the "who does this ready/down apply to".
  *

package/dist/interfaces/pipeline-runner-capability.d.ts

@@ -37,6 +37,12 @@ export interface RunnerCameraConfig {
      * as `['pipeline']` — today's behaviour, unchanged.
      */
     readonly detectionSources?: import('../capabilities/pipeline-runner.cap.js').DetectionSources;
+    /**
+     * What opened this attach — a SESSION attach only (`SessionTriggerSchema`,
+     * D672 rule 11 as amended 2026-10-06). The runner names it on the phase
+     * event and decides nothing on it. Absent ⇒ no source is named.
+     */
+    readonly sessionTrigger?: import('../capabilities/pipeline-runner.cap.js').SessionTrigger;
     readonly pipelineEnabled: boolean;
     /**
      * Which of the node's inference accelerators this session runs on

package/dist/notification/alarm-settings.d.ts

@@ -9,6 +9,31 @@ import { type NcAlarmBlocking, type NcAlarmBlockingEdit, type NcAlarmModeDelays,
 export type NcAlarmDelayField = 'exitDelaySec' | 'entryDelaySec' | 'triggeredDurationSec';
 export declare const NC_ALARM_DELAY_FIELDS: readonly NcAlarmDelayField[];
 export type NcAlarmDelaySource = 'mode' | 'default';
+/**
+ * The STOCK after-trigger duration a panel seeds and every mode inherits unless it sets its
+ * own (D706: 30 s, was 10 s under D701). Only the seed: a persisted value is never rewritten.
+ * The panel's defaults, its one-shot migration and the admin UI's "pick a timed action" fill
+ * all read this one constant.
+ */
+export declare const NC_ALARM_DEFAULT_TRIGGERED_DURATION_SEC = 30;
+/** The per-mode notification switches (D706), both off unless the mode sets them. */
+export type NcAlarmNotifyField = 'notifyDuringEntryDelay' | 'notifySensorRewatched';
+export declare const NC_ALARM_NOTIFY_FIELDS: readonly NcAlarmNotifyField[];
+/** What one mode's notification switches resolve to (D706). */
+export interface NcAlarmModeNotifyPolicy {
+    /** The alarm rules' own pushes go out during this mode's entry delay. */
+    readonly notifyDuringEntryDelay: boolean;
+    /** A bypassed sensor that rejoins the watch is announced. */
+    readonly notifySensorRewatched: boolean;
+}
+/**
+ * The switches `mode` runs on. There is no global value: absent is OFF (operator decision
+ * 2026-10-06 — the entry-delay notification is the only one by default, and "watched again"
+ * is not sent). An answer from an older hub carries no switch and reads as off.
+ */
+export declare function resolveModeNotifyPolicy(settings: {
+    readonly modeDelays?: readonly NcAlarmModeDelays[];
+}, mode: AlarmArmMode): NcAlarmModeNotifyPolicy;
 /**
  * Derive the post-triggered action from a stored blob that may predate the field:
  * a positive duration meant re-arm; zero/absent meant stay triggered.

package/package.json

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