@camstack/types 1.2.20 → 1.2.22

package/dist/addon.js

@@ -13,7 +13,7 @@ const require_err_msg = require("./err-msg-COpsHMw2.js");
 * barrel (`ALL_CAPABILITY_DEFINITIONS`), which would cost ~144MB RSS per
 * forked runner. See docs/decisions/adr-0028.md.
 *
-* Coverage: 16 collection caps, 28 array methods.
+* Coverage: 17 collection caps, 30 array methods.
 */
 var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"addon-pages-source": ["listPages"],
@@ -21,6 +21,7 @@ var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"addon-widgets-source": ["listWidgets"],
 	"broker": ["list", "listProviders"],
 	"custom-model-registry": ["listModels"],
+	"data-store-provider": ["histogram", "query"],
 	"device-export": ["listExposedDevices", "listSupportedDeviceKinds"],
 	"device-provider": ["discoverDevices", "getDevices"],
 	"llm": [

package/dist/addon.mjs

@@ -12,7 +12,7 @@ import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 * barrel (`ALL_CAPABILITY_DEFINITIONS`), which would cost ~144MB RSS per
 * forked runner. See docs/decisions/adr-0028.md.
 *
-* Coverage: 16 collection caps, 28 array methods.
+* Coverage: 17 collection caps, 30 array methods.
 */
 var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"addon-pages-source": ["listPages"],
@@ -20,6 +20,7 @@ var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"addon-widgets-source": ["listWidgets"],
 	"broker": ["list", "listProviders"],
 	"custom-model-registry": ["listModels"],
+	"data-store-provider": ["histogram", "query"],
 	"device-export": ["listExposedDevices", "listSupportedDeviceKinds"],
 	"device-provider": ["discoverDevices", "getDevices"],
 	"llm": [

package/dist/capabilities/data-store-provider.cap.d.ts

@@ -0,0 +1,215 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+/**
+ * What one engine says about itself. The orchestrator uses `kind` to pick
+ * a registrant for a collection; `engineId` is what a log line names when
+ * a call is routed or refused.
+ */
+declare const EngineInfoSchema: z.ZodObject<{
+    engineId: z.ZodString;
+    kind: z.ZodEnum<{
+        relational: "relational";
+        vector: "vector";
+    }>;
+    displayName: z.ZodString;
+}, z.core.$strip>;
+/**
+ * data-store-provider — the engine contract behind the data door.
+ *
+ * The sibling of `storage-provider`, for rows instead of bytes. The
+ * orchestrator (singleton `settings-store` cap, owned by the
+ * storage-orchestrator builtin) dispatches every call to the registrant
+ * that serves the collection.
+ *
+ * `internal: true` — consumed only by the orchestrator. Public consumers
+ * go through `settings-store`; they never see this cap, and an engine
+ * never sees a caller.
+ *
+ * Design notes:
+ *   - **Stateless dispatch.** Every method carries its own
+ *     `namespace` + `collection`, so an engine keeps no per-caller state
+ *     and the orchestrator forwards the payload verbatim. Scoping is a
+ *     property of the input, not of the connection — see the note on
+ *     `settings-store` about what that does and does not guarantee.
+ *   - **One registrant today** (`sqlite-settings`). The collection shape
+ *     exists so a second engine is a registration rather than a second
+ *     door ([D44](../../../../docs/decisions/adr-0044.md)).
+ *
+ * The method set is deliberately identical to `settings-store`'s: the
+ * orchestrator is a router, not a translator. A capability the door
+ * gains, an engine must be able to answer.
+ */
+export declare const dataStoreProviderCapability: {
+    readonly name: "data-store-provider";
+    readonly scope: "system";
+    readonly mode: "collection";
+    readonly internal: true;
+    readonly methods: {
+        /** Self-description — how the orchestrator picks a registrant. */
+        readonly getEngineInfo: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            engineId: z.ZodString;
+            kind: z.ZodEnum<{
+                relational: "relational";
+                vector: "vector";
+            }>;
+            displayName: z.ZodString;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /** Get a single value by key from a collection. */
+        readonly get: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            key: z.ZodString;
+        }, z.core.$strip>, z.ZodUnknown, import("./capability-definition.js").CapabilityMethodKind>;
+        /** Set a value by key in a collection (upsert). */
+        readonly set: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            key: z.ZodString;
+            value: z.ZodUnknown;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Get all entries matching an optional filter. */
+        readonly query: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            filter: z.ZodOptional<z.ZodObject<{
+                where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
+                whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
+                orderBy: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodString;
+                    direction: z.ZodEnum<{
+                        asc: "asc";
+                        desc: "desc";
+                    }>;
+                }, z.core.$strip>>;
+                limit: z.ZodOptional<z.ZodNumber>;
+                offset: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /** Insert a new record. */
+        readonly insert: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            record: z.ZodObject<{
+                id: z.ZodString;
+                data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Update an existing record by ID. */
+        readonly update: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            id: z.ZodString;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Delete a record by key/ID. */
+        readonly delete: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            key: z.ZodString;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Delete every record matching `filter`, in one statement. */
+        readonly deleteWhere: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            filter: z.ZodObject<{
+                where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
+                whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            deleted: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
+        /** Apply `data` to every record matching `filter`, in one statement. */
+        readonly updateWhere: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            filter: z.ZodObject<{
+                where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
+                whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
+            }, z.core.$strip>;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>, z.ZodObject<{
+            updated: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
+        /** Count entries in a collection, optionally filtered. */
+        readonly count: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            filter: z.ZodOptional<z.ZodObject<{
+                where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
+                whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
+                orderBy: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodString;
+                    direction: z.ZodEnum<{
+                        asc: "asc";
+                        desc: "desc";
+                    }>;
+                }, z.core.$strip>>;
+                limit: z.ZodOptional<z.ZodNumber>;
+                offset: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodNumber, import("./capability-definition.js").CapabilityMethodKind>;
+        /** Grouped counts per ((field-origin)/bucketSize) bucket, filtered. */
+        readonly histogram: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            field: z.ZodString;
+            bucketSize: z.ZodNumber;
+            origin: z.ZodNumber;
+            filter: z.ZodOptional<z.ZodObject<{
+                where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
+                whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
+                orderBy: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodString;
+                    direction: z.ZodEnum<{
+                        asc: "asc";
+                        desc: "desc";
+                    }>;
+                }, z.core.$strip>>;
+                limit: z.ZodOptional<z.ZodNumber>;
+                offset: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            bucket: z.ZodNumber;
+            count: z.ZodNumber;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /** Check if a collection is empty. */
+        readonly isEmpty: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+        }, z.core.$strip>, z.ZodBoolean, import("./capability-definition.js").CapabilityMethodKind>;
+        /** Declare a typed (SQL-backed) collection with columns + indexes. */
+        readonly declareCollection: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            columns: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodEnum<{
+                    TEXT: "TEXT";
+                    INTEGER: "INTEGER";
+                    REAL: "REAL";
+                    JSON: "JSON";
+                    BOOLEAN: "BOOLEAN";
+                }>;
+                primaryKey: z.ZodOptional<z.ZodBoolean>;
+                notNull: z.ZodOptional<z.ZodBoolean>;
+                unique: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>;
+            indexes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                columns: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+                unique: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+    };
+};
+export type IDataStoreProvider = InferProvider<typeof dataStoreProviderCapability>;
+export { EngineInfoSchema };
+export type DataStoreEngineInfo = z.infer<typeof EngineInfoSchema>;

package/dist/capabilities/index.d.ts

@@ -44,6 +44,7 @@ export type { CustomModelDescriptor, ICustomModelRegistryProvider, } from './cus
 export { CustomModelDescriptorSchema, customModelRegistryCapability, } from './custom-model-registry.cap.js';
 export type { DecoderHwAccelConfig, HwAccelChoice, IDecoderCapProvider, ShmRingStats, } from './decoder.cap.js';
 export { DEFAULT_DECODER_HWACCEL_CONFIG, DecoderSessionConfigSchema, decoderCapability, HWACCEL_OPTIONS, ShmRingStatsSchema, } from './decoder.cap.js';
+export { type DataStoreEngineInfo, dataStoreProviderCapability, EngineInfoSchema as DataStoreEngineInfoSchema, type IDataStoreProvider, } from './data-store-provider.cap.js';
 export { detectionPipelineCapability, type IDetectionPipelineProvider, } from './detection-pipeline.cap.js';
 export { AdoptInputSchema as AdoptionAdoptInputSchema, type AdoptionFilter, AdoptionFilterSchema, type AdoptionStatus, AdoptionStatusSchema, AdoptResultSchema as AdoptionAdoptResultSchema, CandidateQueryFilterSchema, deviceAdoptionCapability, GetCandidateInputSchema as AdoptionGetCandidateInputSchema, type IDeviceAdoptionProvider, ListCandidatesInputSchema as AdoptionListCandidatesInputSchema, ListCandidatesOutputSchema as AdoptionListCandidatesOutputSchema, ReleaseInputSchema as AdoptionReleaseInputSchema, } from './device-adoption.cap.js';
 export type { IDeviceExportProvider } from './device-export.cap.js';
@@ -87,8 +88,8 @@ export { CameraMetricsSchema, CameraMetricsWithDeviceIdSchema, OrchestratorMetri
 export type { CameraStream, CamProfile, CamStreamKind, DecodedAudioChunkWire, FrameHandleFormat, ProfileRtspEntry, ProfileSlot, ProfileSlotStatus, SubscribeAudioChunksInput, SubscribeAudioChunksResult, SubscribeFramesInput, SubscribeFramesResult, } from './schemas/streaming-shared.js';
 export { BrokerStatsSchema, BrokerStatusSchema, CAM_PROFILE_ORDER, CameraStreamSchema, CamProfileSchema, CamStreamKindSchema, CamStreamResolutionSchema, DecodedAudioChunkSchema, DecodedFrameSchema, EncodedPacketSchema, FrameHandleFormatSchema, FrameHandleSchema, makeProfileBrokerId, makeSourceBrokerId, ProfileRtspEntrySchema, ProfileSlotSchema, ProfileSlotStatusSchema, parseProfileBrokerId, StreamSourceEntrySchema, StreamSourceSchema, SubscribeAudioChunksInputSchema, SubscribeAudioChunksResultSchema, SubscribeFramesInputSchema, SubscribeFramesResultSchema, selectAssignedProfileSlots, } from './schemas/streaming-shared.js';
 export { buildEventKindDescriptor, EVENT_KIND_BY_CAP, EVENTFUL_CAP_NAMES, type SensorEventKindDescriptor, } from './sensor-event-kinds.js';
-export { type IServerManagementProvider, type ServerBootMode, ServerBootModeSchema, type ServerPackageStatus, ServerPackageStatusSchema, type ServerRollbackInfo, ServerRollbackInfoSchema, type ServerUpdateActionResult, ServerUpdateActionResultSchema, type ServerUpdateCheckResult, ServerUpdateCheckResultSchema, type ServerUpdateState, ServerUpdateStateSchema, serverManagementCapability, } from './server-management.cap.js';
-export { type CollectionColumn, CollectionColumnSchema, type CollectionIndex, CollectionIndexSchema, type ISettingsStoreProvider, QueryFilterSchema, SettingsRecordSchema, type SettingsStoreClient, settingsStoreCapability, } from './settings-store.cap.js';
+export { type ImageContract, ImageContractSchema, type ImageContractState, ImageContractStateSchema, type IServerManagementProvider, type ServerBootMode, ServerBootModeSchema, type ServerPackageStatus, ServerPackageStatusSchema, type ServerRollbackInfo, ServerRollbackInfoSchema, type ServerUpdateActionResult, ServerUpdateActionResultSchema, type ServerUpdateCheckResult, ServerUpdateCheckResultSchema, type ServerUpdateState, ServerUpdateStateSchema, serverManagementCapability, } from './server-management.cap.js';
+export { type CollectionColumn, CollectionColumnSchema, type CollectionIndex, CollectionIndexSchema, type ISettingsStoreProvider, type MutationFilter, MutationFilterSchema, QueryFilterSchema, SettingsRecordSchema, type SettingsStoreClient, settingsStoreCapability, } from './settings-store.cap.js';
 export type { ISmtpProvider } from './smtp-provider.cap.js';
 export { SendEmailInputSchema, SendEmailResultSchema, SmtpStatusSchema, smtpProviderCapability, } from './smtp-provider.cap.js';
 export { type ISnapshotOrchestrator, SnapshotImageSchema, snapshotCapability, } from './snapshot.cap.js';
@@ -295,6 +296,7 @@ import type { recordingExportCapability } from './recording-export.cap.js';
 import type { sceneMonitorCapability } from './scene-monitor.cap.js';
 import type { scriptRunnerCapability } from './script-runner.cap.js';
 import type { serverManagementCapability } from './server-management.cap.js';
+import type { dataStoreProviderCapability } from './data-store-provider.cap.js';
 import type { settingsStoreCapability } from './settings-store.cap.js';
 import type { smokeCapability } from './smoke.cap.js';
 import type { smtpProviderCapability } from './smtp-provider.cap.js';
@@ -324,6 +326,6 @@ import type { webrtcSessionCapability } from './webrtc-session.cap.js';
 import type { zoneAnalyticsCapability } from './zone-analytics.cap.js';
 import type { zoneRulesCapability } from './zone-rules.cap.js';
 import type { zonesCapability } from './zones.cap.js';
-type AnyCapability = typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof logDestinationCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof consumablesCapability | typeof rebootCapability | typeof deviceDiscoveryCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof imageCapability | typeof lockControlCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof eventsCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof recordingExportCapability | typeof deviceOpsCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof integrationsCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof imageSettingsCapability;
+type AnyCapability = typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof dataStoreProviderCapability | typeof logDestinationCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof consumablesCapability | typeof rebootCapability | typeof deviceDiscoveryCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof imageCapability | typeof lockControlCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof eventsCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof recordingExportCapability | typeof deviceOpsCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof integrationsCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof imageSettingsCapability;
 export type CapabilityName = AnyCapability['name'];
 export type ITypedReadinessRegistry = IReadinessRegistry<CapabilityName>;

package/dist/capabilities/recording-export.cap.d.ts

@@ -42,8 +42,8 @@ export type ExportOptions = z.infer<typeof ExportOptionsSchema>;
 export declare const ExportStateSchema: z.ZodEnum<{
     queued: "queued";
     failed: "failed";
-    ready: "ready";
     deleted: "deleted";
+    ready: "ready";
     rendering: "rendering";
     expired: "expired";
 }>;
@@ -69,8 +69,8 @@ export declare const ExportRecordSchema: z.ZodObject<{
     state: z.ZodEnum<{
         queued: "queued";
         failed: "failed";
-        ready: "ready";
         deleted: "deleted";
+        ready: "ready";
         rendering: "rendering";
         expired: "expired";
     }>;
@@ -133,8 +133,8 @@ export declare const recordingExportCapability: {
             state: z.ZodEnum<{
                 queued: "queued";
                 failed: "failed";
-                ready: "ready";
                 deleted: "deleted";
+                ready: "ready";
                 rendering: "rendering";
                 expired: "expired";
             }>;
@@ -170,8 +170,8 @@ export declare const recordingExportCapability: {
             state: z.ZodEnum<{
                 queued: "queued";
                 failed: "failed";
-                ready: "ready";
                 deleted: "deleted";
+                ready: "ready";
                 rendering: "rendering";
                 expired: "expired";
             }>;
@@ -206,8 +206,8 @@ export declare const recordingExportCapability: {
             state: z.ZodEnum<{
                 queued: "queued";
                 failed: "failed";
-                ready: "ready";
                 deleted: "deleted";
+                ready: "ready";
                 rendering: "rendering";
                 expired: "expired";
             }>;
@@ -243,8 +243,8 @@ export declare const recordingExportCapability: {
             state: z.ZodEnum<{
                 queued: "queued";
                 failed: "failed";
-                ready: "ready";
                 deleted: "deleted";
+                ready: "ready";
                 rendering: "rendering";
                 expired: "expired";
             }>;
@@ -280,8 +280,8 @@ export declare const recordingExportCapability: {
             state: z.ZodEnum<{
                 queued: "queued";
                 failed: "failed";
-                ready: "ready";
                 deleted: "deleted";
+                ready: "ready";
                 rendering: "rendering";
                 expired: "expired";
             }>;

package/dist/capabilities/recording.cap.d.ts

@@ -219,7 +219,6 @@ export declare const recordingCapability: {
                 max: "max";
                 minimal: "minimal";
             }>>;
-            stripsEnabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>, "query">;
         /** Locate footage at a wall-clock instant: the covering segment's window,
          *  or a gap with the forward nearest covered edge. Used by a feeder running
@@ -288,7 +287,6 @@ export declare const recordingCapability: {
                     max: "max";
                     minimal: "minimal";
                 }>>;
-                stripsEnabled: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strict>;
         }, z.core.$strip>, z.ZodObject<{
             enabled: z.ZodBoolean;
@@ -329,7 +327,6 @@ export declare const recordingCapability: {
                 max: "max";
                 minimal: "minimal";
             }>>;
-            stripsEnabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>, "mutation">;
         /** Re-scan this device's footage from disk (stat sizes) and reseed the
          *  index, then return the fresh status. */
@@ -411,7 +408,7 @@ export declare const recordingCapability: {
             actor: z.ZodString;
         }, z.core.$strip>>>, "query">;
         /**
-         * Move footage (segments and/or strips) from one recordings location to
+         * Move footage (recorded segments) from one recordings location to
          * another — the drain workflow's mover (entity-routing spec Phase 4).
          * Throttled copy → size-verify → delete source → index refresh; resumable
          * by construction (copy-if-absent). Single-flight: one job at a time.
@@ -468,7 +465,6 @@ export declare const recordingCapability: {
             toLocationId: z.ZodString;
             entities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                 segments: "segments";
-                strips: "strips";
             }>>>;
             throttleMbps: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>, z.ZodObject<{

package/dist/capabilities/server-management.cap.d.ts

@@ -55,6 +55,52 @@ declare const ServerUpdateStateSchema: z.ZodEnum<{
     "pending-restart": "pending-restart";
     "awaiting-confirmation": "awaiting-confirmation";
 }>;
+/**
+ * Verdict of comparing the node's IMMUTABLE baked seed (the Docker image / the
+ * desktop app bundle) against the release the deployment contract would
+ * deliver today. `applyServerUpdate` swaps the data-root closure and NEVER
+ * touches the image, so `runningVersion` can be perfectly current while the
+ * container is weeks old, from a renamed repository nothing rebuilds — which
+ * is exactly what happened on 2026-08-02 (hub on `camstack-server:intel-1.1.74`
+ * while every existing surface said "up to date"). The seed version is the one
+ * image fingerprint a container can see from inside (no docker socket).
+ *
+ *  - `in-sync`       — seed equals the current release; the node runs the
+ *                      contract image.
+ *  - `behind-patch`  — same release series, older patch: the image predates
+ *                      the current release. Normal between deliberate image
+ *                      refreshes, but the starter/entrypoint are still old.
+ *  - `behind-series` — the seed's major/minor predates the current release
+ *                      series. The shape of a pinned tag or a dead image
+ *                      repository; a `docker pull` may fix nothing.
+ *  - `ahead`         — seed newer than the best-known release (stale registry
+ *                      check).
+ *  - `unknown`       — no seed (dev workspace) or nothing to compare against
+ *                      yet.
+ */
+declare const ImageContractStateSchema: z.ZodEnum<{
+    unknown: "unknown";
+    "in-sync": "in-sync";
+    "behind-patch": "behind-patch";
+    "behind-series": "behind-series";
+    ahead: "ahead";
+}>;
+declare const ImageContractSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        unknown: "unknown";
+        "in-sync": "in-sync";
+        "behind-patch": "behind-patch";
+        "behind-series": "behind-series";
+        ahead: "ahead";
+    }>;
+    seedVersion: z.ZodNullable<z.ZodString>;
+    contractVersion: z.ZodNullable<z.ZodString>;
+    contractSource: z.ZodNullable<z.ZodEnum<{
+        running: "running";
+        registry: "registry";
+    }>>;
+    message: z.ZodString;
+}, z.core.$strip>;
 declare const ServerRollbackInfoSchema: z.ZodObject<{
     fromVersion: z.ZodString;
     toVersion: z.ZodNullable<z.ZodString>;
@@ -91,6 +137,22 @@ declare const ServerPackageStatusSchema: z.ZodObject<{
     }, z.core.$strip>>;
     stateFileCorrupt: z.ZodBoolean;
     lastCheckedAtMs: z.ZodNullable<z.ZodNumber>;
+    imageContract: z.ZodOptional<z.ZodObject<{
+        state: z.ZodEnum<{
+            unknown: "unknown";
+            "in-sync": "in-sync";
+            "behind-patch": "behind-patch";
+            "behind-series": "behind-series";
+            ahead: "ahead";
+        }>;
+        seedVersion: z.ZodNullable<z.ZodString>;
+        contractVersion: z.ZodNullable<z.ZodString>;
+        contractSource: z.ZodNullable<z.ZodEnum<{
+            running: "running";
+            registry: "registry";
+        }>>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const ServerUpdateCheckResultSchema: z.ZodObject<{
     packageName: z.ZodString;
@@ -141,6 +203,22 @@ export declare const serverManagementCapability: {
             }, z.core.$strip>>;
             stateFileCorrupt: z.ZodBoolean;
             lastCheckedAtMs: z.ZodNullable<z.ZodNumber>;
+            imageContract: z.ZodOptional<z.ZodObject<{
+                state: z.ZodEnum<{
+                    unknown: "unknown";
+                    "in-sync": "in-sync";
+                    "behind-patch": "behind-patch";
+                    "behind-series": "behind-series";
+                    ahead: "ahead";
+                }>;
+                seedVersion: z.ZodNullable<z.ZodString>;
+                contractVersion: z.ZodNullable<z.ZodString>;
+                contractSource: z.ZodNullable<z.ZodEnum<{
+                    running: "running";
+                    registry: "registry";
+                }>>;
+                message: z.ZodString;
+            }, z.core.$strip>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly checkServerUpdate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
             packageName: z.ZodString;
@@ -186,8 +264,10 @@ export declare const serverManagementCapability: {
 export type IServerManagementProvider = InferProvider<typeof serverManagementCapability>;
 export type ServerBootMode = z.infer<typeof ServerBootModeSchema>;
 export type ServerUpdateState = z.infer<typeof ServerUpdateStateSchema>;
+export type ImageContractState = z.infer<typeof ImageContractStateSchema>;
+export type ImageContract = z.infer<typeof ImageContractSchema>;
 export type ServerRollbackInfo = z.infer<typeof ServerRollbackInfoSchema>;
 export type ServerPackageStatus = z.infer<typeof ServerPackageStatusSchema>;
 export type ServerUpdateCheckResult = z.infer<typeof ServerUpdateCheckResultSchema>;
 export type ServerUpdateActionResult = z.infer<typeof ServerUpdateActionResultSchema>;
-export { ServerBootModeSchema, ServerUpdateStateSchema, ServerRollbackInfoSchema, ServerPackageStatusSchema, ServerUpdateCheckResultSchema, ServerUpdateActionResultSchema, };
+export { ServerBootModeSchema, ServerUpdateStateSchema, ImageContractStateSchema, ImageContractSchema, ServerRollbackInfoSchema, ServerPackageStatusSchema, ServerUpdateCheckResultSchema, ServerUpdateActionResultSchema, };

package/dist/capabilities/settings-store.cap.d.ts

@@ -17,6 +17,20 @@ declare const QueryFilterSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+/**
+ * The predicate half of a filter, for BULK MUTATIONS.
+ *
+ * Deliberately not `QueryFilterSchema`: `orderBy` / `limit` / `offset` have no
+ * meaning for a statement that rewrites a set, and accepting them would invite
+ * a caller to believe `limit` bounds the damage. Every field is optional here
+ * only so the shape stays composable — the implementation REJECTS a filter
+ * that compiles to no predicate, because that is the whole collection.
+ */
+declare const MutationFilterSchema: z.ZodObject<{
+    where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
+    whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
+}, z.core.$strip>;
 /** A single stored record: `{ id, data }`. */
 declare const SettingsRecordSchema: z.ZodObject<{
     id: z.ZodString;
@@ -56,14 +70,27 @@ declare const CollectionIndexSchema: z.ZodObject<{
  * field provides access to additional data spaces beyond the default
  * addon settings — useful for business data (events, tracks, faces, etc.).
  *
- * Scoping: the implementation prefixes every collection with the calling
- * addon's ID automatically. Addons never see each other's data.
+ * **Scoping is the CALLER's, and it is opt-in.** The table is
+ * `namespace ? `${namespace}:${collection}` : collection` — nothing
+ * consults the identity of the caller. An earlier version of this comment
+ * claimed the implementation prefixes every collection with the calling
+ * addon's ID and that "addons never see each other's data"; that was never
+ * true, and this same file contradicted it under `declareCollection`. What
+ * exists is `addon-context-factory`, which passes `namespace: addonId` ON
+ * THE ADDON'S BEHALF for the `addon-settings` / `addon-devices` paths only.
+ * Business collections use bare names, and any caller may name any
+ * namespace, or none. Making the door enforce it is tracked separately —
+ * it renames tables, so it needs a migration.
  *
- *   - No namespace (default): `"addon-settings"` → `"<addonId>:addon-settings"`
- *   - With namespace: `{ namespace: 'events', collection: 'detections' }` →
- *     `"<addonId>:events:detections"`
+ *   - `{ collection: 'addon-settings' }` → table `addon-settings`
+ *   - `{ namespace: 'my-addon', collection: 'addon-settings' }` →
+ *     table `my-addon:addon-settings`
  *
- * Implemented by `@camstack/system/builtins/sqlite-settings` (SQLite WAL backend).
+ * Served by the **storage-orchestrator** builtin, which dispatches to the
+ * `data-store-provider` engine registered for the collection
+ * (`sqlite-settings`, a SQLite WAL backend, today). One addon owns the
+ * data door; engines sit behind it
+ * ([D44](../../../../docs/decisions/adr-0044.md)).
  * Addons access it via `ctx.api.settingsStore.*`.
  */
 export declare const settingsStoreCapability: {
@@ -128,6 +155,48 @@ export declare const settingsStoreCapability: {
             collection: z.ZodString;
             key: z.ZodString;
         }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /**
+         * Delete every record matching `filter`, in ONE statement, returning how
+         * many rows went. This exists because its absence made every retention
+         * path in the system an N+1 drain loop: `delete` takes a key, so a sweep
+         * had to SELECT a page of full rows — every column, including the fat
+         * ones — purely to learn their ids, then issue one call per row.
+         *
+         * **The filter is required and must resolve.** A predicate naming
+         * something the collection cannot express is an ERROR here, not a
+         * widening as it is on `query`, and a filter with no predicates is an
+         * error rather than "every row". Deleting a whole collection is a
+         * legitimate intent, but it must be asked for by name — not reached by
+         * an empty object.
+         */
+        readonly deleteWhere: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            filter: z.ZodObject<{
+                where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
+                whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            deleted: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
+        /**
+         * Apply `data` to every record matching `filter`, in one statement,
+         * returning how many rows changed. Same filter contract as
+         * {@link deleteWhere} — an unresolvable predicate is an error.
+         */
+        readonly updateWhere: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            filter: z.ZodObject<{
+                where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
+                whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
+            }, z.core.$strip>;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>, z.ZodObject<{
+            updated: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
         /** Count entries in a collection, optionally filtered. */
         readonly count: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             namespace: z.ZodOptional<z.ZodString>;
@@ -223,6 +292,7 @@ export type ISettingsStoreProvider = InferProvider<typeof settingsStoreCapabilit
  * Methods are accessed as `client.get.query(input)`, `client.set.mutate(input)`, etc.
  */
 export type SettingsStoreClient = import('../generated/addon-api.js').AddonApi['settingsStore'];
-export { QueryFilterSchema, SettingsRecordSchema, CollectionColumnSchema, CollectionIndexSchema };
+export { QueryFilterSchema, MutationFilterSchema, SettingsRecordSchema, CollectionColumnSchema, CollectionIndexSchema, };
+export type MutationFilter = z.infer<typeof MutationFilterSchema>;
 export type CollectionColumn = z.infer<typeof CollectionColumnSchema>;
 export type CollectionIndex = z.infer<typeof CollectionIndexSchema>;