@camstack/types 1.2.303 → 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/dist/types/model-variant-groups.d.ts

@@ -15,7 +15,7 @@
  */
 import type { ModelFormat } from './models.js';
 export type VariantPrecision = 'fp32' | 'int8';
-export type VariantOptimization = 'standard' | 'fast';
+export type VariantOptimization = 'standard' | 'test';
 /**
  * Minimal structural shape the grouped selector needs. Both the full
  * `ModelCatalogEntry` (config UI) and the reduced `PipelineModelOption`
@@ -74,7 +74,7 @@ export interface ModelVariantFamily {
 /**
  * Fold a flat catalog into the `family → tier → variant` tree. Deterministic
  * ordering: tiers by the canonical size ladder (unknown tiers appended
- * alphabetically), variants standard-before-int8 and fast last.
+ * alphabetically), variants standard-before-int8 and test last.
  */
 export declare function buildModelVariantGroups(models: readonly ModelVariantSource[]): readonly ModelVariantFamily[];
 /**

package/dist/types/models.d.ts

@@ -115,7 +115,7 @@ export declare const ModelVariantGroupSchema: z.ZodObject<{
     }>>;
     optimization: z.ZodOptional<z.ZodEnum<{
         standard: "standard";
-        fast: "fast";
+        test: "test";
     }>>;
     resolution: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -155,9 +155,10 @@ export type ModelHosting = (typeof MODEL_HOSTING)[number];
  * are per upstream. A persisted custom-model row written when this field was a
  * string still parses — the string is lifted into `{ weights }`.
  *
- * Every licence surface (the admin "Models and licenses" page,
- * `THIRD_PARTY_MODELS.md`, the Hugging Face model table) is GENERATED from
- * these records by `scripts/gen-model-licenses.ts` (D661).
+ * Every machine licence surface (`THIRD_PARTY_MODELS.md`, the Hugging Face
+ * model table) is GENERATED from these records by
+ * `scripts/gen-model-licenses.ts` (D661). Operator-facing docs live in
+ * `camstack/docs` → `/docs/detection/models`.
  */
 export declare const ModelLicenseSchema: z.ZodPreprocess<z.ZodObject<{
     weights: z.ZodString;
@@ -313,7 +314,7 @@ export declare const ModelCatalogEntrySchema: z.ZodObject<{
         }>>;
         optimization: z.ZodOptional<z.ZodEnum<{
             standard: "standard";
-            fast: "fast";
+            test: "test";
         }>>;
         resolution: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
@@ -585,7 +586,7 @@ export declare const ConvertResultSchema: z.ZodObject<{
             }>>;
             optimization: z.ZodOptional<z.ZodEnum<{
                 standard: "standard";
-                fast: "fast";
+                test: "test";
             }>>;
             resolution: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;

package/dist/types/pipeline-step.d.ts

@@ -18,7 +18,7 @@ export interface IPipelineStep {
      */
     getConfigSchema(model?: ModelCatalogEntry): readonly ConfigField[];
 }
-export type PostprocessorType = 'yolo' | 'ssd' | 'rfdetr' | 'yolonas' | 'yolo-seg' | 'scrfd' | 'yunet' | 'arcface' | 'clip' | 'softmax' | 'ctc' | 'plate-slots' | 'saliency' | 'yamnet';
+export type PostprocessorType = 'yolo' | 'ssd' | 'rfdetr' | 'yolonas' | 'yolo-seg' | 'scrfd' | 'yunet' | 'yolo-split-dfl' | 'arcface' | 'clip' | 'softmax' | 'ctc' | 'plate-slots' | 'saliency' | 'yamnet';
 export interface StepDefinition {
     /** Unique step identifier (e.g., 'object-detection', 'face-detection') */
     readonly id: string;

package/package.json

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