@camstack/types 1.2.304 → 1.2.306

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

@@ -343,6 +343,15 @@ export interface DetailStepAnnounce {
     readonly stepId: string;
     readonly inputClasses: readonly string[];
     readonly cadence: StepCadence;
+    /**
+     * The root model that already fills this step for this camera (D715): the
+     * model declares the fill and the step's `labelLink` policy lets it be
+     * skipped. A consumer does not dispatch the step for a track whose detection
+     * carries the linked label (`detector-link:<stepId>`); a track without one
+     * (a class the detector cannot name) still gets the step. Absent ⇒ the step
+     * runs as before.
+     */
+    readonly filledBy?: string;
 }
 /**
  * Raw inference output emitted by `addon-pipeline-runner` per detection
@@ -508,8 +517,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/pipeline/native-lease.d.ts

@@ -24,9 +24,9 @@
  * ## What each knob costs
  *
  * A HELD frame is a full NATIVE-resolution copy in system RAM. With the
- * default pinned-RGB24 lease path (`CAMSTACK_SESSION_PINNED_RGB_CROP`, on):
- * 4K ≈ 24.9 MB/frame, 1080p ≈ 6.2 MB/frame. On the YUV420P path (flag off, and
- * for software-decoded sessions): 4K ≈ 12.4 MB, 1080p ≈ 3.1 MB. Worst-case
+ * pinned-RGB24 lease path (hardware sessions):
+ * 4K ≈ 24.9 MB/frame, 1080p ≈ 6.2 MB/frame. On the YUV420P path (software-decoded
+ * sessions): 4K ≈ 12.4 MB, 1080p ≈ 3.1 MB. Worst-case
  * resident RAM for ONE busy camera is now `frameBytes × holdFrames`, clamped by
  * the budget ceiling — bounded by a COUNT because a held frame is waiting for
  * one specific event (its own detection result), not for a clock.

package/dist/types/models.d.ts

@@ -183,6 +183,17 @@ export declare const ModelLicenseSchema: z.ZodPreprocess<z.ZodObject<{
     nonCommercial: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>>;
 export type ModelLicense = z.infer<typeof ModelLicenseSchema>;
+/** One `fillsClassifierEffects` entry — see `ModelCatalogEntry.fillsClassifierEffects`. */
+export declare const FillsClassifierEffectSchema: z.ZodObject<{
+    stepId: z.ZodEnum<{
+        "animal-classifier": "animal-classifier";
+        "vehicle-classifier": "vehicle-classifier";
+        "package-detection": "package-detection";
+    }>;
+    labelToEffect: z.ZodRecord<z.ZodString, z.ZodString>;
+    uncovered: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type FillsClassifierEffect = z.infer<typeof FillsClassifierEffectSchema>;
 export declare const ModelCatalogEntrySchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
@@ -333,6 +344,15 @@ export declare const ModelCatalogEntrySchema: z.ZodObject<{
         }>>;
         preserveOriginal: z.ZodBoolean;
     }, z.core.$strip>>;
+    fillsClassifierEffects: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        stepId: z.ZodEnum<{
+            "animal-classifier": "animal-classifier";
+            "vehicle-classifier": "vehicle-classifier";
+            "package-detection": "package-detection";
+        }>;
+        labelToEffect: z.ZodRecord<z.ZodString, z.ZodString>;
+        uncovered: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>>;
     clip: z.ZodOptional<z.ZodObject<{
         textModelId: z.ZodString;
         embeddingDim: z.ZodNumber;
@@ -605,6 +625,15 @@ export declare const ConvertResultSchema: z.ZodObject<{
             }>>;
             preserveOriginal: z.ZodBoolean;
         }, z.core.$strip>>;
+        fillsClassifierEffects: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            stepId: z.ZodEnum<{
+                "animal-classifier": "animal-classifier";
+                "vehicle-classifier": "vehicle-classifier";
+                "package-detection": "package-detection";
+            }>;
+            labelToEffect: z.ZodRecord<z.ZodString, z.ZodString>;
+            uncovered: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>>;
         clip: z.ZodOptional<z.ZodObject<{
             textModelId: z.ZodString;
             embeddingDim: z.ZodNumber;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.304",
+  "version": "1.2.306",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",
@@ -39,6 +39,11 @@
       "import": "./dist/enums.mjs",
       "require": "./dist/enums.js"
     },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.mjs",
+      "require": "./dist/client.js"
+    },
     "./catalogs": {
       "types": "./dist/catalogs/index.d.ts",
       "import": "./dist/catalogs/index.mjs",
@@ -55,7 +60,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "vite build && tsc -p tsconfig.json --emitDeclarationOnly",
+    "build": "vite build && vite build -c vite.client.config.ts && tsc -p tsconfig.json --emitDeclarationOnly",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit -p tsconfig.spec.json",
     "test": "vitest run",