@camstack/types 1.2.260 → 1.2.262

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

@@ -0,0 +1,62 @@
+/**
+ * An EXTENSION SLOT — one way a device can be extended by OTHER devices,
+ * 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
+ * `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).
+ *
+ * Two shapes:
+ *
+ *  - `association` — the host LISTS other devices (a camera's linked devices,
+ *    its doorbell trigger sources). Removing every source is "off"; there is
+ *    no separate switch.
+ *  - `graft` — the host GAINS a whole capability (`projects`), registered
+ *    natively by the host's own provider from sources it owns. Declared here
+ *    so the contract has room for it; the first graft (HA consumables) is
+ *    slice 2, and a graft carries its own `enabled` switch.
+ */
+import type { z } from 'zod';
+import type { DeviceType } from '../device/device-type.js';
+/** How a slot extends its host. See the module docblock. */
+export type ExtensionSlotShape = 'association' | 'graft';
+/** How many sources a slot takes. */
+export type ExtensionSlotCardinality = 'one' | 'many';
+/**
+ * One slot, as declared in its owning `*.cap.ts`.
+ *
+ * `value` is the slot's EDITABLE value — what `setSlot` takes and `listSlots`
+ * returns. It must be a Zod OBJECT that does not itself carry a `slot` key:
+ * codegen extends it with `slot: z.literal(<id>)` to build the discriminated
+ * union, and it must be a NAMED EXPORT of the declaring cap file (codegen
+ * imports it by name so the generated module never imports the caps barrel).
+ */
+export interface ExtensionSlotDescriptor<TValue extends z.ZodObject = z.ZodObject> {
+    /** Kebab id, unique across every cap. Becomes a member of `ExtensionSlotId`. */
+    readonly id: string;
+    /** Operator-facing name of the slot ("Linked devices"). */
+    readonly label: string;
+    /** One sentence saying what a source of this slot DOES to the host. */
+    readonly description: string;
+    readonly shape: ExtensionSlotShape;
+    /**
+     * Host device types the slot is offered on. Absent = the declaring cap's
+     * `deviceTypes`; a slot on a cap that declares none (a `system` cap such as
+     * `device-manager`) MUST state it (guarded).
+     */
+    readonly hostDeviceTypes?: readonly DeviceType[];
+    /**
+     * Source filter for the picker, tested against a candidate's capabilities
+     * (D12: its bindings, never the global cap list). `'any'` = no cap filter.
+     */
+    readonly sourceCaps: readonly string[] | 'any';
+    readonly cardinality: ExtensionSlotCardinality;
+    /** graft only — MUST equal the declaring cap's `name` (guarded). */
+    readonly projects?: string;
+    /** The slot's editable value. See the interface docblock. */
+    readonly value: TValue;
+}

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

@@ -0,0 +1,70 @@
+/**
+ * The owner's side of `device-extension` (D648): `defineExtensionSlotProvider`
+ * binds ONE slot id to the functions that read and write the owner's existing
+ * store, and `createDeviceExtensionProvider` turns an owner's slots into the
+ * cap provider it registers.
+ *
+ * The id is typed on the GENERATED `ExtensionSlotId`, so a typo does not
+ * compile, and the literal `defineExtensionSlotProvider('<id>'` is what
+ * `scripts/check-extension-slots.ts` counts to prove every declared slot has
+ * exactly one owner.
+ *
+ * Nothing here persists. An owner's `set` goes through the write path the
+ * owner already had for its store; this module only routes, checks the host
+ * type and logs the write.
+ */
+import type { IScopedLogger } from '../interfaces/logging.js';
+import { type ExtensionCandidate, type ExtensionSetResult, type ExtensionSlotActivation, type ExtensionSlotSource, type IDeviceExtensionProvider } from '../capabilities/device-extension.cap.js';
+import { type ExtensionSlotId, type ExtensionSlotValue } from '../generated/extension-slots.js';
+/** The value shape of ONE slot, picked out of the generated union. */
+export type ExtensionSlotValueOf<Id extends ExtensionSlotId> = Extract<ExtensionSlotValue, {
+    readonly slot: Id;
+}>;
+/** What an owner reads for one host: everything of the row but the routing. */
+export interface ExtensionSlotListing<Id extends ExtensionSlotId> {
+    /** The store written (D62), `<addon>:<key>`. */
+    readonly authority: string;
+    /** graft: its switch; association: null. */
+    readonly enabled: boolean | null;
+    readonly activation: ExtensionSlotActivation | null;
+    readonly value: ExtensionSlotValueOf<Id>;
+    readonly sources: readonly ExtensionSlotSource[];
+    /** Linked by the owner's own structure, not picked (D655). Omit when none. */
+    readonly impliedSources?: readonly ExtensionSlotSource[];
+}
+/** The three functions an owner implements for one slot. */
+export interface ExtensionSlotImpl<Id extends ExtensionSlotId> {
+    /** The slot as the owner's store holds it, or null when this host is not the owner's. */
+    list(deviceId: number): Promise<ExtensionSlotListing<Id> | null>;
+    /** Write through the owner's EXISTING path. Refuse by name before persisting. */
+    set(deviceId: number, value: ExtensionSlotValueOf<Id>): Promise<ExtensionSetResult>;
+    /** Devices the editor may offer, suggestions pre-marked and never saved. */
+    candidates(deviceId: number): Promise<readonly ExtensionCandidate[]>;
+}
+/** A slot bound to its owner, with the id erased so owners can hold a list. */
+export interface ExtensionSlotProvider {
+    readonly slot: ExtensionSlotId;
+    list(deviceId: number): Promise<ExtensionSlotListing<ExtensionSlotId> | null>;
+    set(deviceId: number, value: ExtensionSlotValue): Promise<ExtensionSetResult>;
+    candidates(deviceId: number): Promise<readonly ExtensionCandidate[]>;
+}
+/** Bind slot `slot` to its owner's functions. See the module docblock. */
+export declare function defineExtensionSlotProvider<Id extends ExtensionSlotId>(slot: Id, impl: ExtensionSlotImpl<Id>): ExtensionSlotProvider;
+/** `<source>:<slotId>`. */
+export declare function extensionSlotRef(source: string, slot: ExtensionSlotId): string;
+export interface DeviceExtensionProviderOptions {
+    /** The routing prefix of every `slotRef` this owner serves. */
+    readonly source: string;
+    readonly label: string;
+    readonly slots: readonly ExtensionSlotProvider[];
+    /**
+     * The host's device type, answered LOCALLY by the owner (R6: a provider
+     * answers `[]` for a host it does not serve without a fleet round trip), or
+     * null when the owner does not know the device. A THROW is not "unknown":
+     * it propagates, and the dispatcher turns it into an `unreachable` row.
+     */
+    readonly hostTypeOf: (deviceId: number) => Promise<string | null>;
+    readonly logger: IScopedLogger;
+}
+/** Build the `device-extension` provider one owner registers. */
+export declare function createDeviceExtensionProvider(options: DeviceExtensionProviderOptions): IDeviceExtensionProvider;

package/dist/generated/addon-api.d.ts

@@ -40,6 +40,7 @@ import type { deviceAdminLinkCapability } from '../capabilities/device-admin-lin
 import type { deviceAdoptionCapability } from '../capabilities/device-adoption.cap.js';
 import type { deviceDiscoveryCapability } from '../capabilities/device-discovery.cap.js';
 import type { deviceExportCapability } from '../capabilities/device-export.cap.js';
+import type { deviceExtensionCapability } from '../capabilities/device-extension.cap.js';
 import type { deviceManagerCapability } from '../capabilities/device-manager.cap.js';
 import type { deviceOpsCapability } from '../capabilities/device-ops.cap.js';
 import type { deviceProviderCapability } from '../capabilities/device-provider.cap.js';
@@ -2104,33 +2105,47 @@ export type AppRouter = TrpcCoreRouter<{
             meta: object;
         }>;
     }>>;
-    deviceManager: TRPCBuiltRouter<{
+    deviceExtension: TRPCBuiltRouter<{
         ctx: TrpcContext;
         meta: object;
         errorShape: AugmentedErrorShape;
         transformer: true;
     }, TRPCDecorateCreateRouterOptions<{
-        getDeviceSettingsContribution: TRPCQueryProcedure<{
+        listSources: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;
-            } & z.input<typeof DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceSettingsContribution.input>;
-            output: z.infer<typeof DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceSettingsContribution.output>;
+            } & z.input<typeof deviceExtensionCapability.methods.listSources.input>;
+            output: z.infer<typeof deviceExtensionCapability.methods.listSources.output>;
             meta: object;
         }>;
-        getDeviceLiveContribution: TRPCQueryProcedure<{
+        listSlots: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;
-            } & z.input<typeof DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceLiveContribution.input>;
-            output: z.infer<typeof DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceLiveContribution.output>;
+            } & z.input<typeof deviceExtensionCapability.methods.listSlots.input>;
+            output: z.infer<typeof deviceExtensionCapability.methods.listSlots.output>;
             meta: object;
         }>;
-        applyDeviceSettingsPatch: TRPCMutationProcedure<{
+        listCandidates: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;
-            } & z.input<typeof DEVICE_SETTINGS_CONTRIBUTION_METHODS.applyDeviceSettingsPatch.input>;
-            output: z.infer<typeof DEVICE_SETTINGS_CONTRIBUTION_METHODS.applyDeviceSettingsPatch.output>;
+            } & z.input<typeof deviceExtensionCapability.methods.listCandidates.input>;
+            output: z.infer<typeof deviceExtensionCapability.methods.listCandidates.output>;
+            meta: object;
+        }>;
+        setSlot: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof deviceExtensionCapability.methods.setSlot.input>;
+            output: z.infer<typeof deviceExtensionCapability.methods.setSlot.output>;
             meta: object;
         }>;
+    }>>;
+    deviceManager: TRPCBuiltRouter<{
+        ctx: TrpcContext;
+        meta: object;
+        errorShape: AugmentedErrorShape;
+        transformer: true;
+    }, TRPCDecorateCreateRouterOptions<{
         allocateDeviceId: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;
@@ -2982,27 +2997,6 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof DEVICE_STATUS_METHOD.getStatus.output>;
             meta: object;
         }>;
-        getDeviceSettingsContribution: TRPCQueryProcedure<{
-            input: {
-                [x: string]: unknown;
-            } & z.input<typeof DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceSettingsContribution.input>;
-            output: z.infer<typeof DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceSettingsContribution.output>;
-            meta: object;
-        }>;
-        getDeviceLiveContribution: TRPCQueryProcedure<{
-            input: {
-                [x: string]: unknown;
-            } & z.input<typeof DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceLiveContribution.input>;
-            output: z.infer<typeof DEVICE_SETTINGS_CONTRIBUTION_METHODS.getDeviceLiveContribution.output>;
-            meta: object;
-        }>;
-        applyDeviceSettingsPatch: TRPCMutationProcedure<{
-            input: {
-                [x: string]: unknown;
-            } & z.input<typeof DEVICE_SETTINGS_CONTRIBUTION_METHODS.applyDeviceSettingsPatch.input>;
-            output: z.infer<typeof DEVICE_SETTINGS_CONTRIBUTION_METHODS.applyDeviceSettingsPatch.output>;
-            meta: object;
-        }>;
     }>>;
     embeddingEncoder: TRPCBuiltRouter<{
         ctx: TrpcContext;
@@ -3032,6 +3026,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof embeddingEncoderCapability.methods.getInfo.output>;
             meta: object;
         }>;
+        resetFailedModels: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof embeddingEncoderCapability.methods.resetFailedModels.input>;
+            output: z.infer<typeof embeddingEncoderCapability.methods.resetFailedModels.output>;
+            meta: object;
+        }>;
     }>>;
     enumSensor: TRPCBuiltRouter<{
         ctx: TrpcContext;
@@ -6080,6 +6081,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof pipelineOrchestratorCapability.methods.getAgentLoad.output>;
             meta: object;
         }>;
+        getClusterModelChoice: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof pipelineOrchestratorCapability.methods.getClusterModelChoice.input>;
+            output: z.infer<typeof pipelineOrchestratorCapability.methods.getClusterModelChoice.output>;
+            meta: object;
+        }>;
         getGlobalMetrics: TRPCQueryProcedure<{
             input: {
                 nodeId?: string | undefined;

package/dist/generated/capability-router-map.d.ts

@@ -46,6 +46,7 @@ export { deviceAdminLinkCapability } from '../capabilities/device-admin-link.cap
 export { deviceAdoptionCapability } from '../capabilities/device-adoption.cap.js';
 export { deviceDiscoveryCapability } from '../capabilities/device-discovery.cap.js';
 export { deviceExportCapability } from '../capabilities/device-export.cap.js';
+export { deviceExtensionCapability } from '../capabilities/device-extension.cap.js';
 export { deviceManagerCapability } from '../capabilities/device-manager.cap.js';
 export { deviceOpsCapability } from '../capabilities/device-ops.cap.js';
 export { deviceProviderCapability } from '../capabilities/device-provider.cap.js';
@@ -207,6 +208,7 @@ export declare const CAPABILITY_NAMES: {
     readonly deviceAdoption: "device-adoption";
     readonly deviceDiscovery: "device-discovery";
     readonly deviceExport: "device-export";
+    readonly deviceExtension: "device-extension";
     readonly deviceManager: "device-manager";
     readonly deviceOps: "device-ops";
     readonly deviceProvider: "device-provider";
@@ -381,6 +383,7 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly deviceAdoption: TRouter;
     readonly deviceDiscovery: TRouter;
     readonly deviceExport: TRouter;
+    readonly deviceExtension: TRouter;
     readonly deviceManager: TRouter;
     readonly deviceOps: TRouter;
     readonly deviceProvider: TRouter;
@@ -498,8 +501,8 @@ export interface CapabilityRouterMap<TRouter = unknown> {
 export declare const SINGLETON_CAPABILITY_NAMES: readonly ["accessories", "addon-pages", "addon-settings", "addon-widgets", "addons", "admin-ui", "air-quality-sensor", "alarm-panel", "alerts", "ambient-light-sensor", "audio-analysis", "audio-analyzer", "audio-codec", "audio-metrics", "automation-control", "backup", "battery", "binary", "brightness", "button", "camera-credentials", "camera-grid-layout", "camera-pipeline-config", "camera-streams", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "core-blocks", "cover", "day-night", "decoder", "detection-pipeline", "device-admin-link", "device-adoption", "device-discovery", "device-manager", "device-ops", "device-state", "device-status", "doorbell", "enum-sensor", "event-emitter", "face-gallery", "fan-control", "feature-probe", "filesystem-browse", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "integrations", "intercom", "lawn-mower-control", "llm-runtime", "local-network", "lock-control", "media-player", "metrics-provider", "model-convert", "model-distributor", "motion", "motion-detection", "motion-trigger", "motion-zones", "native-object-detection", "navigation", "network-link", "network-quality", "nodes", "notification-rules", "notifier", "numeric-sensor", "osd", "osd-manager", "pet-feeder", "pipeline-analytics", "pipeline-executor", "pipeline-orchestrator", "pipeline-runner", "plate-gallery", "platform-probe", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "reboot", "recording-archive", "recording-export", "recording-onboard", "recording-signal", "scene-monitor", "script-runner", "server-management", "settings-store", "smoke", "snapshot", "sso-bridge", "storage", "storage-migration", "stream-broker", "stream-catalog", "stream-params", "stream-signals", "switch", "system", "tamper", "temperature-sensor", "terminal-session", "toast", "update", "user-management", "vacuum-control", "valve", "vector-store", "vibration", "viewer-ui", "water-heater", "weather", "webrtc-session", "zone-analytics", "zone-rules", "zones"];
 /** Union of singleton capability names (literal string union). */
 export type SingletonCapabilityName = typeof SINGLETON_CAPABILITY_NAMES[number];
-/** Capability names whose mode is `collection` (30 caps). */
-export declare const COLLECTION_CAPABILITY_NAMES: readonly ["addon-pages-source", "addon-routes", "addon-widgets-source", "auth-provider", "broker", "connection-test", "custom-model-registry", "data-store-provider", "device-export", "device-provider", "embedding-encoder", "failure-contribution", "llm", "load-contribution", "log-channels", "log-destination", "login-method", "mesh-network", "mqtt-broker", "network-access", "notification-output", "oauth-integration", "recording", "smtp-provider", "storage-evictable", "storage-occupancy", "storage-provider", "turn-provider", "user-passkeys", "videoclips"];
+/** Capability names whose mode is `collection` (31 caps). */
+export declare const COLLECTION_CAPABILITY_NAMES: readonly ["addon-pages-source", "addon-routes", "addon-widgets-source", "auth-provider", "broker", "connection-test", "custom-model-registry", "data-store-provider", "device-export", "device-extension", "device-provider", "embedding-encoder", "failure-contribution", "llm", "load-contribution", "log-channels", "log-destination", "login-method", "mesh-network", "mqtt-broker", "network-access", "notification-output", "oauth-integration", "recording", "smtp-provider", "storage-evictable", "storage-occupancy", "storage-provider", "turn-provider", "user-passkeys", "videoclips"];
 /** Union of collection capability names (literal string union). */
 export type CollectionCapabilityName = typeof COLLECTION_CAPABILITY_NAMES[number];
 /** Capability mode lookup at runtime — mirrors the `.cap.ts` definitions. */

package/dist/generated/collection-array-methods.d.ts

@@ -8,7 +8,7 @@
  * barrel (`ALL_CAPABILITY_DEFINITIONS`), which would cost ~144MB RSS per
  * forked runner. See docs/decisions/adr-0028.md.
  *
- * Coverage: 23 collection caps, 37 array methods.
+ * Coverage: 24 collection caps, 39 array methods.
  */
 export declare const COLLECTION_ARRAY_METHODS: Readonly<Record<string, readonly string[]>>;
 /**

package/dist/generated/device-proxy.d.ts

@@ -15,6 +15,7 @@ import type { brightnessCapability } from '../capabilities/brightness.cap.js';
 import type { buttonCapability } from '../capabilities/button.cap.js';
 import type { cameraCredentialsCapability } from '../capabilities/camera-credentials.cap.js';
 import type { cameraGridLayoutCapability } from '../capabilities/camera-grid-layout.cap.js';
+import type { cameraPipelineConfigCapability } from '../capabilities/camera-pipeline-config.cap.js';
 import type { cameraStreamsCapability } from '../capabilities/camera-streams.cap.js';
 import type { carbonMonoxideCapability } from '../capabilities/carbon-monoxide.cap.js';
 import type { climateControlCapability } from '../capabilities/climate-control.cap.js';
@@ -28,6 +29,7 @@ import type { dayNightCapability } from '../capabilities/day-night.cap.js';
 import type { detectionPipelineCapability } from '../capabilities/detection-pipeline.cap.js';
 import type { deviceAdminLinkCapability } from '../capabilities/device-admin-link.cap.js';
 import type { deviceDiscoveryCapability } from '../capabilities/device-discovery.cap.js';
+import type { deviceExtensionCapability } from '../capabilities/device-extension.cap.js';
 import type { deviceOpsCapability } from '../capabilities/device-ops.cap.js';
 import type { deviceStatusCapability } from '../capabilities/device-status.cap.js';
 import type { doorbellCapability } from '../capabilities/doorbell.cap.js';
@@ -52,7 +54,6 @@ import type { motionZonesCapability } from '../capabilities/motion-zones.cap.js'
 import type { nativeObjectDetectionCapability } from '../capabilities/native-object-detection.cap.js';
 import type { navigationCapability } from '../capabilities/navigation.cap.js';
 import type { networkLinkCapability } from '../capabilities/network-link.cap.js';
-import type { notificationRulesCapability } from '../capabilities/notification-rules.cap.js';
 import type { notifierCapability } from '../capabilities/notifier.cap.js';
 import type { numericSensorCapability } from '../capabilities/numeric-sensor.cap.js';
 import type { osdCapability } from '../capabilities/osd.cap.js';
@@ -91,14 +92,13 @@ import type { zoneRulesCapability } from '../capabilities/zone-rules.cap.js';
 import type { zonesCapability } from '../capabilities/zones.cap.js';
 import type { addonSettingsCapability } from '../capabilities/addon-settings.cap.js';
 import type { audioAnalyzerCapability } from '../capabilities/audio-analyzer.cap.js';
-import type { cameraPipelineConfigCapability } from '../capabilities/camera-pipeline-config.cap.js';
 import type { deviceAdoptionCapability } from '../capabilities/device-adoption.cap.js';
 import type { deviceExportCapability } from '../capabilities/device-export.cap.js';
 import type { deviceManagerCapability } from '../capabilities/device-manager.cap.js';
-import type { deviceProviderCapability } from '../capabilities/device-provider.cap.js';
 import type { deviceStateCapability } from '../capabilities/device-state.cap.js';
 import type { faceGalleryCapability } from '../capabilities/face-gallery.cap.js';
 import type { networkQualityCapability } from '../capabilities/network-quality.cap.js';
+import type { notificationRulesCapability } from '../capabilities/notification-rules.cap.js';
 import type { osdManagerCapability } from '../capabilities/osd-manager.cap.js';
 import type { pipelineExecutorCapability } from '../capabilities/pipeline-executor.cap.js';
 import type { pipelineOrchestratorCapability } from '../capabilities/pipeline-orchestrator.cap.js';
@@ -214,6 +214,7 @@ export interface DeviceProxy {
     readonly button?: InferDeviceProxyCap<typeof buttonCapability>;
     readonly cameraCredentials?: InferDeviceProxyCap<typeof cameraCredentialsCapability>;
     readonly cameraGridLayout?: InferDeviceProxyCap<typeof cameraGridLayoutCapability>;
+    readonly cameraPipelineConfig?: InferDeviceProxyCap<typeof cameraPipelineConfigCapability>;
     readonly cameraStreams?: InferDeviceProxyCap<typeof cameraStreamsCapability>;
     readonly carbonMonoxide?: InferDeviceProxyCap<typeof carbonMonoxideCapability>;
     readonly climateControl?: InferDeviceProxyCap<typeof climateControlCapability>;
@@ -227,6 +228,7 @@ export interface DeviceProxy {
     readonly detectionPipeline?: InferDeviceProxyCap<typeof detectionPipelineCapability>;
     readonly deviceAdminLink?: InferDeviceProxyCap<typeof deviceAdminLinkCapability>;
     readonly deviceDiscovery?: InferDeviceProxyCap<typeof deviceDiscoveryCapability>;
+    readonly deviceExtension?: InferDeviceProxyCap<typeof deviceExtensionCapability>;
     readonly deviceOps?: InferDeviceProxyCap<typeof deviceOpsCapability>;
     readonly deviceStatus?: InferDeviceProxyCap<typeof deviceStatusCapability>;
     readonly doorbell?: InferDeviceProxyCap<typeof doorbellCapability>;
@@ -251,7 +253,6 @@ export interface DeviceProxy {
     readonly nativeObjectDetection?: InferDeviceProxyCap<typeof nativeObjectDetectionCapability>;
     readonly navigation?: InferDeviceProxyCap<typeof navigationCapability>;
     readonly networkLink?: InferDeviceProxyCap<typeof networkLinkCapability>;
-    readonly notificationRules?: InferDeviceProxyCap<typeof notificationRulesCapability>;
     readonly notifier?: InferDeviceProxyCap<typeof notifierCapability>;
     readonly numericSensor?: InferDeviceProxyCap<typeof numericSensorCapability>;
     readonly osd?: InferDeviceProxyCap<typeof osdCapability>;
@@ -290,17 +291,16 @@ export interface DeviceProxy {
     readonly zones?: InferDeviceProxyCap<typeof zonesCapability>;
     readonly addonSettings: Pick<InferDeviceProxyCap<typeof addonSettingsCapability>, 'getDeviceSettings' | 'updateDeviceSettings'>;
     readonly audioAnalyzer: Pick<InferDeviceProxyCap<typeof audioAnalyzerCapability>, 'detachDevice'>;
-    readonly cameraPipelineConfig: Pick<InferDeviceProxyCap<typeof cameraPipelineConfigCapability>, 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
     readonly deviceAdoption: Pick<InferDeviceProxyCap<typeof deviceAdoptionCapability>, 'getStatus'>;
     readonly deviceExport: Pick<InferDeviceProxyCap<typeof deviceExportCapability>, 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
-    readonly deviceManager: Pick<InferDeviceProxyCap<typeof deviceManagerCapability>, 'loadConfig' | 'loadRuntimeState' | 'loadMeta' | 'setName' | 'setLocation' | 'setType' | 'setIntegrationId' | 'setLinkDeviceId' | 'setPrimaryChildEntityId' | 'setChildLayout' | 'setDisplay' | 'getWireableFields' | 'setRole' | 'applyInitialMeta' | 'setMetadata' | 'setDisabled' | 'getDevice' | 'getLinkedDevices' | 'getStreamSources' | 'getConfigSchema' | 'getSettingsSchema' | 'updateConfig' | 'enable' | 'disable' | 'remove' | 'getStreamProfileMap' | 'setStreamProfileMap' | 'probeStreams' | 'getBindings' | 'setWrapperActive' | 'getDeviceSettingsAggregate' | 'getDeviceLiveInfoAggregate' | 'getDeviceAggregate' | 'runDeviceAction' | 'updateDeviceField' | 'updateDeviceFieldsBatch' | 'testField' | 'getDeviceStatusAggregate' | 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
-    readonly deviceProvider: Pick<InferDeviceProxyCap<typeof deviceProviderCapability>, 'reloadDevice'>;
+    readonly deviceManager: Pick<InferDeviceProxyCap<typeof deviceManagerCapability>, 'loadConfig' | 'loadRuntimeState' | 'loadMeta' | 'setName' | 'setLocation' | 'setType' | 'setIntegrationId' | 'setLinkDeviceId' | 'setPrimaryChildEntityId' | 'setChildLayout' | 'setDisplay' | 'getWireableFields' | 'setRole' | 'applyInitialMeta' | 'setMetadata' | 'setDisabled' | 'getDevice' | 'getLinkedDevices' | 'getStreamSources' | 'getConfigSchema' | 'getSettingsSchema' | 'updateConfig' | 'enable' | 'disable' | 'remove' | 'getStreamProfileMap' | 'setStreamProfileMap' | 'probeStreams' | 'getBindings' | 'setWrapperActive' | 'getDeviceSettingsAggregate' | 'getDeviceLiveInfoAggregate' | 'getDeviceAggregate' | 'runDeviceAction' | 'updateDeviceField' | 'updateDeviceFieldsBatch' | 'testField' | 'getDeviceStatusAggregate'>;
     readonly deviceState: Pick<InferDeviceProxyCap<typeof deviceStateCapability>, 'getSnapshot' | 'getCapSlice' | 'setCapSlice'>;
     readonly faceGallery: Pick<InferDeviceProxyCap<typeof faceGalleryCapability>, 'listRecentFaces' | 'getFaceByTrack'>;
     readonly networkQuality: Pick<InferDeviceProxyCap<typeof networkQualityCapability>, 'getDeviceStats' | 'reportClientStats'>;
+    readonly notificationRules: Pick<InferDeviceProxyCap<typeof notificationRulesCapability>, 'setDeviceMuted'>;
     readonly osdManager: Pick<InferDeviceProxyCap<typeof osdManagerCapability>, 'getDeviceOsd' | 'getSourceCatalog' | 'setSlotBinding' | 'clearSlotBinding' | 'previewSlot' | 'renderDevice'>;
     readonly pipelineExecutor: Pick<InferDeviceProxyCap<typeof pipelineExecutorCapability>, 'runPipeline' | 'runPipelineBatch'>;
-    readonly pipelineOrchestrator: Pick<InferDeviceProxyCap<typeof pipelineOrchestratorCapability>, 'assignPipeline' | 'unassignPipeline' | 'setPipelineDevicePin' | 'getPipelineDevicePin' | 'getPipelineAssignment' | 'getCameraMetrics' | 'assignAudio' | 'unassignAudio' | 'getAudioAssignment' | 'getAudioAssignments' | 'getCameraSettings' | 'setCameraStepToggle' | 'getCameraStepOverrides' | 'setCameraStepOverride' | 'setCameraPipelineForAgent' | 'resolvePipeline' | 'getCameraSwitches' | 'setCameraSwitch' | 'getCameraStatus' | 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
+    readonly pipelineOrchestrator: Pick<InferDeviceProxyCap<typeof pipelineOrchestratorCapability>, 'assignPipeline' | 'unassignPipeline' | 'setPipelineDevicePin' | 'getPipelineDevicePin' | 'getPipelineAssignment' | 'getCameraMetrics' | 'assignAudio' | 'unassignAudio' | 'getAudioAssignment' | 'getCameraSettings' | 'setCameraStepToggle' | 'getCameraStepOverrides' | 'setCameraStepOverride' | 'setCameraPipelineForAgent' | 'resolvePipeline' | 'getCameraSwitches' | 'setCameraSwitch' | 'getCameraStatus' | 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
     readonly pipelineRunner: Pick<InferDeviceProxyCap<typeof pipelineRunnerCapability>, 'detachCamera' | 'getCameraMetrics' | 'requestOccupancyBurst' | 'runDetailSubtree' | 'parkTrackFrame' | 'getParkedTrackFrame' | 'releaseParkedTrackFrames'>;
     readonly plateGallery: Pick<InferDeviceProxyCap<typeof plateGalleryCapability>, 'listPlates' | 'getPlateByTrack'>;
     readonly recordingArchive: Pick<InferDeviceProxyCap<typeof recordingArchiveCapability>, 'getDeviceConfig' | 'locateSegment' | 'readSegmentBytes' | 'readGopBytes' | 'readWindowBytes' | 'setDeviceConfig' | 'rescanStorage' | 'pruneFootage' | 'deleteFootprint' | 'renderGif' | 'renderClip' | 'getStatus' | 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;

package/dist/generated/device-scoped-caps.d.ts

@@ -5,7 +5,7 @@
  * can answer "may a rule actuate this?" without importing the schema barrel
  * (~144MB RSS per runner, D28).
  *
- * Coverage: 87 device-scoped capabilities.
+ * Coverage: 88 device-scoped capabilities.
  */
 export declare const DEVICE_SCOPED_CAPS: ReadonlySet<string>;
 /**

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

@@ -0,0 +1,40 @@
+/**
+ * AUTO-GENERATED by scripts/generate-extension-slots.ts — DO NOT EDIT.
+ *
+ * Every extension slot declared by a capability (`extensionSlots` in its
+ * `*.cap.ts`, D648), folded into one typed table. Imports ONLY the declaring
+ * 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).
+ */
+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 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. */
+export interface ExtensionSlotEntry {
+    readonly descriptor: ExtensionSlotDescriptor;
+    readonly declaringCap: string;
+    /** `descriptor.hostDeviceTypes ?? declaringCap.deviceTypes`, resolved here. */
+    readonly hostDeviceTypes: readonly DeviceType[];
+}
+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">;
+}, z.core.$strip>], "slot">;
+export type ExtensionSlotValue = z.infer<typeof ExtensionSlotValueSchema>;
+/** Every device type at least one slot is offered on — `device-extension`'s `deviceTypes`. */
+export declare const EXTENSION_HOST_DEVICE_TYPES: readonly DeviceType[];

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 1178 method paths across 160 capabilities.
+ * Coverage: 1178 method paths across 161 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/method-device-selectors.d.ts

@@ -6,7 +6,7 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 395 methods carry a device reference, of which
+ * Coverage: 399 methods carry a device reference, of which
  * 138 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying

package/dist/generated/system-proxy.d.ts

@@ -28,6 +28,7 @@ import type { networkAccessCapability } from '../capabilities/network-access.cap
 import type { networkQualityCapability } from '../capabilities/network-quality.cap.js';
 import type { nodesCapability } from '../capabilities/nodes.cap.js';
 import type { notificationOutputCapability } from '../capabilities/notification-output.cap.js';
+import type { notificationRulesCapability } from '../capabilities/notification-rules.cap.js';
 import type { osdManagerCapability } from '../capabilities/osd-manager.cap.js';
 import type { pipelineExecutorCapability } from '../capabilities/pipeline-executor.cap.js';
 import type { pipelineOrchestratorCapability } from '../capabilities/pipeline-orchestrator.cap.js';
@@ -69,7 +70,7 @@ export interface SystemProxy {
     readonly deviceAdoption: Pick<InferProvider<typeof deviceAdoptionCapability>, 'listCandidateFilters' | 'listCandidates' | 'getCandidate' | 'refresh' | 'adopt' | 'release' | 'resync'>;
     readonly deviceExport: Pick<InferProvider<typeof deviceExportCapability>, 'getStatus' | 'listSupportedDeviceKinds' | 'listExposedDevices' | 'exposeDevice' | 'unexposeDevice'>;
     readonly deviceManager: Pick<InferProvider<typeof deviceManagerCapability>, 'allocateDeviceId' | 'migrateDevice' | 'registerDevice' | 'removeDevice' | 'persistConfig' | 'getRoleDisplayDefaults' | 'setRoleDisplayDefaults' | 'listLocations' | 'addLocation' | 'removeLocation' | 'renameLocation' | 'listLocationIcons' | 'setLocationIcon' | 'listLocationDescriptions' | 'setLocationDescription' | 'listSiteZones' | 'setSiteZone' | 'removeSiteZone' | 'renameSiteZone' | 'setLocationZone' | 'listPersistedByAddon' | 'listAll' | 'getChildren' | 'getChildrenBatch' | 'getLinkedDevicesBatch' | 'removeByIntegration' | 'getBindingsBatch' | 'getAllBindings' | 'listDeviceIdsByCaps' | 'listWrappersForCap' | 'listBindableCapsForDeviceType' | 'discoverDevices' | 'adoptDevice' | 'getCreationSchema' | 'createDevice' | 'testCreationField' | 'adoptionListCandidateFilters' | 'adoptionListCandidates' | 'adoptionRefresh' | 'adoptionAdopt' | 'adoptionRelease' | 'adoptionStartJob' | 'adoptionListJobs' | 'adoptionCancelJob' | 'adoptionResync' | 'discoveryProviders' | 'discoverAllProviders' | 'discoverProvider' | 'providerCreationType' | 'providerDiscoveryParamsSchema' | 'getDeviceStatusAggregateBatch'>;
-    readonly deviceProvider: Pick<InferProvider<typeof deviceProviderCapability>, 'start' | 'stop' | 'getStatus' | 'getDevices' | 'supportsDiscovery' | 'discoverDevices' | 'getDiscoveryParamsSchema' | 'getManualCreationType' | 'adoptDiscoveredDevice' | 'supportsManualCreation' | 'getChildCreationSchema' | 'createDevice' | 'testCreationField'>;
+    readonly deviceProvider: Pick<InferProvider<typeof deviceProviderCapability>, 'start' | 'stop' | 'getStatus' | 'getDevices' | 'reloadDevice' | 'supportsDiscovery' | 'discoverDevices' | 'getDiscoveryParamsSchema' | 'getManualCreationType' | 'adoptDiscoveredDevice' | 'supportsManualCreation' | 'getChildCreationSchema' | 'createDevice' | 'testCreationField'>;
     readonly deviceState: Pick<InferProvider<typeof deviceStateCapability>, 'getAllSnapshots'>;
     readonly faceGallery: Pick<InferProvider<typeof faceGalleryCapability>, 'listIdentities' | 'createIdentity' | 'renameIdentity' | 'deleteIdentity' | 'listIdentitySamples' | 'auditIdentitySamples' | 'removeSample' | 'getFaceMedia' | 'assignFace' | 'unassignFace' | 'deleteFace' | 'assignFaces' | 'unassignFaces' | 'suggestFaceClusters'>;
     readonly integrations: Pick<InferProvider<typeof integrationsCapability>, 'list' | 'get' | 'getByAddonId' | 'create' | 'update' | 'delete' | 'getSettings' | 'setSettings' | 'getAvailableTypes' | 'testConnection'>;
@@ -82,9 +83,10 @@ export interface SystemProxy {
     readonly networkQuality: Pick<InferProvider<typeof networkQualityCapability>, 'getAllStats'>;
     readonly nodes: Pick<InferProvider<typeof nodesCapability>, 'topology' | 'directory' | 'deployAddon' | 'undeployAddon' | 'restartAddon' | 'restartProcess' | 'restartNode' | 'shutdownNode' | 'renameNode' | 'clusterAddonStatus' | 'getCapUsageGraph' | 'getNodeAddons' | 'setProcessLogLevel' | 'executeQuery'>;
     readonly notificationOutput: Pick<InferProvider<typeof notificationOutputCapability>, 'listTargetKinds' | 'listTargets' | 'discoverTargets' | 'send' | 'testTarget' | 'upsertTarget' | 'deleteTarget' | 'setTargetEnabled'>;
+    readonly notificationRules: Pick<InferProvider<typeof notificationRulesCapability>, 'listRules' | 'getRule' | 'createRule' | 'updateRule' | 'deleteRule' | 'setRuleEnabled' | 'getClipRetentionAsks' | 'listDeviceMutes' | 'testRule' | 'previewStateSummary' | 'getConditionCatalog' | 'getTemplateCatalog' | 'previewTemplate' | 'getHistory' | 'getRuleLastRuns' | 'resolveArtifactUrl' | 'listSnoozes' | 'createSnooze' | 'cancelSnooze' | 'getAlarmConfig' | 'setAlarmConfig'>;
     readonly osdManager: Pick<InferProvider<typeof osdManagerCapability>, 'getConditionSupport' | 'copyDeviceConfiguration'>;
     readonly pipelineExecutor: Pick<InferProvider<typeof pipelineExecutorCapability>, 'getAvailableEngines' | 'getSelectedEngine' | 'getDefaultSteps' | 'getEngineProvisioning' | 'getVideoPipelineSteps' | 'setVideoPipelineSteps' | 'clearDeviceOverrides' | 'getInferenceDeviceHealth' | 'rearmInferenceDevice' | 'getSchema' | 'getGlobalSteps' | 'getGlobalPipelineConfig' | 'getOrchestratorConfigSchema' | 'validatePipeline' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate' | 'getCapabilities' | 'getAddonModels' | 'downloadModel' | 'deleteModel' | 'cacheFrameInPool' | 'inferCached' | 'uncacheFrame' | 'getEffectiveTuning' | 'listLoadedEngines' | 'spinEngine' | 'killEngine' | 'listReferenceImages' | 'getReferenceImage' | 'getReferenceAudioFiles' | 'getReferenceAudio' | 'getAudioCapabilities' | 'runAudioTest' | 'getDetectionConfigSchema'>;
-    readonly pipelineOrchestrator: Pick<InferProvider<typeof pipelineOrchestratorCapability>, 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'rebalance' | 'getPipelineAssignments' | 'getAgentLoad' | 'getGlobalMetrics' | 'getCapabilityBindings' | 'setCapabilityBinding' | 'getIngestOwner' | 'getAudioNodeLoad' | 'getAgentSettings' | 'listAgentSettings' | 'removeAgentSettings' | 'setAgentMaxCameras' | 'setAgentDetectWeight' | 'setAgentCapabilities' | 'setAgentDecodeLimits' | 'setAgentReachableHost' | 'setAgentInferenceDevices' | 'getNodeInferenceDevices' | 'resetNodePipelineDefaults' | 'getCameraStatuses' | 'reconcileFromDisk' | 'getReconcileFromDiskStatus' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate'>;
+    readonly pipelineOrchestrator: Pick<InferProvider<typeof pipelineOrchestratorCapability>, 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'rebalance' | 'getPipelineAssignments' | 'getAgentLoad' | 'getClusterModelChoice' | 'getGlobalMetrics' | 'getCapabilityBindings' | 'setCapabilityBinding' | 'getIngestOwner' | 'getAudioNodeLoad' | 'getAudioAssignments' | 'getAgentSettings' | 'listAgentSettings' | 'removeAgentSettings' | 'setAgentMaxCameras' | 'setAgentDetectWeight' | 'setAgentCapabilities' | 'setAgentDecodeLimits' | 'setAgentReachableHost' | 'setAgentInferenceDevices' | 'getNodeInferenceDevices' | 'resetNodePipelineDefaults' | 'getCameraStatuses' | 'reconcileFromDisk' | 'getReconcileFromDiskStatus' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate'>;
     readonly pipelineRunner: Pick<InferProvider<typeof pipelineRunnerCapability>, 'attachCamera' | 'reportMotion' | 'getLocalLoad' | 'getLocalMetrics' | 'getAllCameraMetrics' | 'getLocalCameras' | 'getNativeCrop' | 'runStatelessStep'>;
     readonly plateGallery: Pick<InferProvider<typeof plateGalleryCapability>, 'getPlateMedia' | 'searchPlates' | 'suggestPlateClusters' | 'correctPlateText' | 'deletePlate' | 'listVehicles' | 'createVehicle' | 'renameVehicle' | 'deleteVehicle' | 'listVehicleSamples' | 'removeVehicleSample' | 'assignPlate' | 'unassignPlate' | 'assignPlates' | 'unassignPlates'>;
     readonly recordingArchive: Pick<InferProvider<typeof recordingArchiveCapability>, 'getAvailabilityBatch' | 'getDaysWithRecordingsBatch' | 'getStorageUsage' | 'listOpsLog' | 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'refreshStorageLocationsForMigration' | 'startStorageMigrationMove' | 'getStorageMigrationMoveStatus' | 'cancelStorageMigrationMove' | 'relocateFootage' | 'listRelocateJobs' | 'getRelocateResidue' | 'reconcileLedgerAgainstDisk' | 'cancelRelocateJob' | 'planStorageRebalance' | 'startStorageRebalance' | 'getPlacement' | 'setDevicePlacement'>;

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export type { EventOwnerType, MediaOwnerKey, MediaOwnerKeyInput, MediaOwnerType,
 export { EVENT_OWNER_TYPES, EventOwnerTypeSchema, MEDIA_OWNER_TYPES, MEDIA_PRESENCE_OWNER_KINDS, MediaPresenceOwnerKindSchema, formatMediaOwnerKey, isEventOwnerType, isMediaOwnerType, parseMediaOwnerKey, } from './media/media-owner-key.js';
 export type { CapabilitiesAccess } from './addon/base-addon.js';
 export { BaseAddon, normalizeAddonInitResult } from './addon/base-addon.js';
+export { normalizeNodeId } from './addon/per-node-store.js';
 export type { AddonRouteInvokeRequest, AddonRouteReplyEnvelope, } from './addon/build-addon-route-provider.js';
 export { buildAddonRouteProvider } from './addon/build-addon-route-provider.js';
 export type { DurableState, DurableStateDeps } from './addon/durable-state.js';
@@ -131,6 +132,7 @@ export * from './types/labels.js';
 export * from './types/live-state.js';
 export * from './types/model-variant-groups.js';
 export * from './types/models.js';
+export * from './types/clip-model.js';
 export * from './types/pipeline.js';
 export type { AvailableEngine, PipelineAddonSchema, PipelineDefaultStep, PipelineModelOption, PipelineSchema, PipelineSlotSchema, PipelineTemplate, PipelineTemplateStep, TemplateValidationResult, } from './types/pipeline-schema.js';
 export * from './types/pipeline-step.js';
@@ -140,6 +142,7 @@ export type { AutomationAction, AutomationCondition, AutomationConditionAll, Aut
 export { AutomationActionSchema, AutomationConditionOperatorSchema, AutomationConditionSchema, AutomationRecipeSchema, AutomationTriggerSchema, conditionDepth, countConditionLeaves, generateAutomationBlock, MAX_CONDITION_DEPTH, MAX_CONDITION_LEAVES, validateRecipeBounds, } from './automation/index.js';
 export * from './cap-call-context.js';
 export * from './capabilities/index.js';
+export * from './device-extension/index.js';
 export { APPLE_SA_TO_MACRO, AUDIO_MACRO_LABELS, getAudioMacroClassIds, mapAudioLabelToMacro, YAMNET_TO_MACRO, } from './catalogs/audio-classmap.js';
 export { COCO_80_LABELS, COCO_TO_MACRO, DETECTION_MACRO_CLASSES, isDetectionMacroClass, MACRO_LABELS, } from './catalogs/coco-classmap.js';
 export { DEVICE_STATE_READERS, readDeviceStateFrom, stateVocabularyFor, } from './catalogs/device-state-vocabulary.js';
@@ -237,7 +240,8 @@ export { describeSystemEventDeliveryProblem, isSystemEventSummaryRule, NC_SYSTEM
 export { NC_SERVER_PACKAGE_NAME, NC_UPDATE_EVENT_PACKAGE_NAMES, type NcInstalledPackageLike, type NcScopePickerItem, nodePickerItems, packagePickerItems, } from './notification/scope-picker-items.js';
 export type { TimelapseCadencePair, TimelapsePreviewMode, TimelapseRule, TimelapseRuleInput, TimelapseRulePatch, TimelapseTemplate, } from './notification/timelapse-rule.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, isClusterScopedStep, overlayClusterStepSettings, pickClusterStepModels, pickClusterStepSettings, readClusterStepModels, readClusterStepSettings, resolveClusterStepModelId, type StepModelScope, } from './pipeline/cluster-model-scope.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 { 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';
 export { ACCESS_ROLES, type AccessRoleAssignment, type AccessRoleId, type AccessRoleSpec, buildRoleScopes, detectAccessRole, roleSpec, } from './schemas/access-roles.js';