@camstack/types 1.2.113 → 1.2.115

package/dist/addon.js

@@ -312,7 +312,7 @@ function materialise(defaults) {
 * barrel (`ALL_CAPABILITY_DEFINITIONS`), which would cost ~144MB RSS per
 * forked runner. See docs/decisions/adr-0028.md.
 *
-* Coverage: 17 collection caps, 30 array methods.
+* Coverage: 18 collection caps, 31 array methods.
 */
 var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"addon-pages-source": ["listPages"],
@@ -333,6 +333,7 @@ var COLLECTION_ARRAY_METHODS = Object.freeze({
 		"listProfiles",
 		"listRuntimeNodes"
 	],
+	"log-channels": ["list"],
 	"log-destination": ["query"],
 	"login-method": ["getLoginMethods"],
 	"mqtt-broker": ["listBrokers"],

package/dist/addon.mjs

@@ -311,7 +311,7 @@ function materialise(defaults) {
 * barrel (`ALL_CAPABILITY_DEFINITIONS`), which would cost ~144MB RSS per
 * forked runner. See docs/decisions/adr-0028.md.
 *
-* Coverage: 17 collection caps, 30 array methods.
+* Coverage: 18 collection caps, 31 array methods.
 */
 var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"addon-pages-source": ["listPages"],
@@ -332,6 +332,7 @@ var COLLECTION_ARRAY_METHODS = Object.freeze({
 		"listProfiles",
 		"listRuntimeNodes"
 	],
+	"log-channels": ["list"],
 	"log-destination": ["query"],
 	"login-method": ["getLoginMethods"],
 	"mqtt-broker": ["listBrokers"],

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

@@ -177,6 +177,40 @@ export declare const dataStoreProviderCapability: {
                 offset: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
         }, z.core.$strip>, z.ZodNumber, import("./capability-definition.js").CapabilityMethodKind>;
+        /** `COUNT(*)` plus one SUM/MIN/MAX per field, in one statement. Mirror of
+         *  `settings-store.aggregate` — see it for why an unresolvable field is
+         *  refused rather than dropped. */
+        readonly aggregate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            fields: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                as: z.ZodString;
+                field: z.ZodString;
+                op: z.ZodEnum<{
+                    min: "min";
+                    max: "max";
+                    sum: "sum";
+                }>;
+            }, z.core.$strip>>>;
+            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>>>;
+                whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                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.ZodObject<{
+            count: z.ZodNumber;
+            values: z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>, 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>;

package/dist/capabilities/device-manager.cap.d.ts

@@ -19,6 +19,28 @@
 import { z } from 'zod';
 import { DeviceType } from '../device/device-type.js';
 import { StreamSourceEntrySchema } from './schemas/streaming-shared.js';
+/**
+ * Most parents one `getChildrenBatch` may name.
+ *
+ * Every parent in the set becomes one bound `?` in the `parentDeviceId IN (…)`
+ * the store compiles ({@link DeviceRowStore.listByParentMany} →
+ * `filter-compiler.ts`), so the set size IS the SQL variable count. Two bounds
+ * meet here and 256 clears both:
+ *
+ *  - `SQLITE_MAX_VARIABLE_NUMBER` is 32 766 on SQLite ≥ 3.32 but **999** on
+ *    anything older, and better-sqlite3 links whatever amalgamation it was
+ *    built against on the host. A fleet-sized set (1 017 parents today) sits
+ *    ON that older limit; 256 stays a factor of four below it, so the batch
+ *    can never turn a boot into `too many SQL variables` on a host nobody
+ *    checked the build of.
+ *  - One call's answer is the children of those parents, and the answer
+ *    crosses a process boundary. Capping the ask caps the message.
+ *
+ * A caller with more parents sends ⌈n/256⌉ calls — four for today's fleet,
+ * against 1 024 today. The cap is on the SCHEMA, not only on the caller: an
+ * over-eager caller is refused, not silently truncated to a wrong answer.
+ */
+export declare const DEVICE_CHILDREN_BATCH_MAX = 256;
 /** Cap-wire shape of a per-cap display refinement — mirrors
  *  `DeviceCapDisplayOverride` in `device-management.ts`. */
 export declare const DeviceCapDisplayOverrideSchema: z.ZodObject<{
@@ -675,6 +697,83 @@ export declare const deviceManagerCapability: {
                 }, z.core.$strip>>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * `getChildren` for a NAMED SET of parents, in one call.
+         *
+         * The accessory reconcile in `device-cap-proxy.ts` asks this question once
+         * per registered device — every `BaseDevice` inherits a
+         * `getAccessoryChildren()` that returns `[]`, so even a leaf accessory
+         * pays a round-trip to learn it has nothing to prune. Measured on the live
+         * hub 2026-08-27 over a 120-second boot window, fleet of 1 017 devices:
+         * `DeviceRowStore.list < DeviceRowStore.listByParent < getChildren` at
+         * **1 024 calls** returning **919 rows in total** — 1 024 RPCs and 1 024
+         * indexed scans to move less than one row each. `listByParentMany`
+         * collapses the scans; this collapses the RPCs.
+         *
+         * Keyed by parent id as a STRING — a JSON object cannot key by number
+         * (same reason as `getDeviceStatusAggregateBatch`). The per-parent value
+         * is exactly what `getChildren` returns for that parent.
+         *
+         * A parent with no children — or one the fleet does not know — is ABSENT
+         * from the record, never an invented empty row: the same contract as
+         * `DeviceRowStore.getMany`/`listByParentMany`. An EMPTY `parentDeviceIds`
+         * reads nothing at all rather than degrading to "every device".
+         *
+         * `parentDeviceIds` is capped at {@link DEVICE_CHILDREN_BATCH_MAX} — see
+         * that constant for why. A caller with more parents than that sends more
+         * than one call; it never sends one pathological one.
+         *
+         * Version skew: this is a NEW method, not a new field on `getChildren`, so
+         * a hub that predates it answers NOT_FOUND rather than silently stripping
+         * an unknown input key and answering a DIFFERENT question. The kernel-side
+         * loader degrades to per-parent `getChildren` on that error — see
+         * `children-batch-loader.ts`.
+         */
+        readonly getChildrenBatch: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            parentDeviceIds: z.ZodArray<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            stableId: z.ZodString;
+            addonId: z.ZodString;
+            type: z.ZodEnum<typeof DeviceType>;
+            name: z.ZodString;
+            location: z.ZodNullable<z.ZodString>;
+            disabled: z.ZodBoolean;
+            parentDeviceId: z.ZodNullable<z.ZodNumber>;
+            role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            online: z.ZodBoolean;
+            probed: z.ZodOptional<z.ZodBoolean>;
+            features: z.ZodArray<z.ZodString>;
+            isCamera: z.ZodBoolean;
+            config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            sourceInfo: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                system: z.ZodString;
+                uniqueId: z.ZodOptional<z.ZodString>;
+                raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
+            integrationId: z.ZodOptional<z.ZodString>;
+            linkDeviceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            primaryChildEntityId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            childLayout: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                childKey: z.ZodString;
+                section: z.ZodString;
+                order: z.ZodOptional<z.ZodNumber>;
+                collapsed: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>>;
+            display: z.ZodOptional<z.ZodObject<{
+                icon: z.ZodOptional<z.ZodString>;
+                label: z.ZodOptional<z.ZodString>;
+                unit: z.ZodOptional<z.ZodString>;
+                precision: z.ZodOptional<z.ZodNumber>;
+                hidden: z.ZodOptional<z.ZodBoolean>;
+                perCap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    unit: z.ZodOptional<z.ZodString>;
+                    precision: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * Resolve the devices LINKED to a camera — the single policy authority
          * both consumers call (viewer devices panel + pipeline-analytics event

package/dist/capabilities/index.d.ts

@@ -50,7 +50,7 @@ export { AdoptInputSchema as AdoptionAdoptInputSchema, type AdoptionFilter, Adop
 export type { IDeviceExportProvider } from './device-export.cap.js';
 export { DeviceExportStatusSchema, deviceExportCapability, ExportSetupFieldSchema, ExportSetupSchema, ExposedDeviceSchema, ExposeInputSchema as DeviceExportExposeInputSchema, UnexposeInputSchema as DeviceExportUnexposeInputSchema, } from './device-export.cap.js';
 export type { DeviceInfo, DeviceManagerApplyInitialMetaInput } from './device-manager.cap.js';
-export { ConfigEntrySchema, DeviceInfoSchema, deviceManagerCapability, type IDeviceManagerProvider, type LinkedDevice, LinkedDeviceSchema, type LinkedDevicesMode, LinkedDevicesModeSchema, } from './device-manager.cap.js';
+export { ConfigEntrySchema, DEVICE_CHILDREN_BATCH_MAX, DeviceInfoSchema, deviceManagerCapability, type IDeviceManagerProvider, type LinkedDevice, LinkedDeviceSchema, type LinkedDevicesMode, LinkedDevicesModeSchema, } from './device-manager.cap.js';
 export { DiscoveredDeviceSchema, deviceProviderCapability, ProviderStatusSchema, } from './device-provider.cap.js';
 export { deviceStateCapability } from './device-state.cap.js';
 export type { IEmbeddingEncoderProvider } from './embedding-encoder.cap.js';
@@ -59,6 +59,8 @@ export { filesystemBrowseCapability, type IFilesystemBrowseProvider, } from './f
 export { type HfModelResolution, HfModelResolutionSchema, type ILlmProvider, type LlmDefault, LlmDefaultSchema, type LlmDefaultSelector, LlmDefaultSelectorSchema, type LlmProfile, type LlmProfileKind, type LlmProfileKindDescriptor, LlmProfileKindDescriptorSchema, LlmProfileKindSchema, LlmProfileSchema, type LlmRuntimeNode, LlmRuntimeNodeSchema, type LlmUsageRollup, LlmUsageRollupSchema, llmCapability, type ManagedModelCatalogEntry, ManagedModelCatalogEntrySchema, } from './llm.cap.js';
 export { type ILlmRuntimeProvider, type LlmDownloadProgress, LlmDownloadProgressSchema, type LlmNodeModel, LlmNodeModelSchema, type LlmRuntimeCompleteInput, LlmRuntimeCompleteInputSchema, type LlmRuntimeDiskUsage, LlmRuntimeDiskUsageSchema, type LlmRuntimeStatus, LlmRuntimeStatusSchema, llmRuntimeCapability, type ManagedModelExtraFile, ManagedModelExtraFileSchema, type ManagedModelRef, ManagedModelRefSchema, type ManagedRuntimeConfig, ManagedRuntimeConfigSchema, } from './llm-runtime.cap.js';
 export { type LlmErrorCode, LlmErrorCodeSchema, type LlmGenerateBaseInput, LlmGenerateBaseInputSchema, type LlmGenerateErr, LlmGenerateErrSchema, type LlmGenerateOk, LlmGenerateOkSchema, type LlmGenerateResult, LlmGenerateResultSchema, type LlmImage, LlmImageSchema, type LlmRetryPolicy, LlmRetryPolicySchema, LlmTimeoutDefaults, type LlmUsage, LlmUsageSchema, } from './llm-shared.js';
+export type { ILogChannelsProvider, LogChannelApplyResult } from './log-channels.cap.js';
+export { LogChannelApplyResultSchema, logChannelsCapability } from './log-channels.cap.js';
 export { LogEntrySchema, LogLevelSchema, logDestinationCapability } from './log-destination.cap.js';
 export type { ILoginMethodProvider, LoginMethodContribution, LoginStage, PasskeyLoginMethod, RedirectLoginMethod, WidgetLoginMethod, } from './login-method.cap.js';
 export { LoginMethodContributionSchema, LoginStageEnum, loginMethodCapability, PasskeyLoginMethodSchema, RedirectLoginMethodSchema, WidgetLoginMethodSchema, } from './login-method.cap.js';
@@ -189,7 +191,7 @@ export { type CamStreamDescriptor, CamStreamDescriptorSchema, type IStreamCatalo
 export { type IStreamParamsProvider, type StreamParamsOptions, StreamParamsOptionsSchema, type StreamParamsStatus, StreamParamsStatusSchema, type StreamProfile, StreamProfileConfigSchema, StreamProfileOptionsSchema, type StreamProfilePatch, StreamProfilePatchSchema, StreamProfileSchema, streamParamsCapability, } from './stream-params.cap.js';
 export { buildStreamParamsConfigSchema, parseStreamParamsFormPatch, STREAM_PROFILE_META, type StreamProfileMeta, } from './stream-params-config-schema.js';
 export { type ISwitchProvider, type SwitchStatus, SwitchStatusSchema, switchCapability, } from './switch.cap.js';
-export { type DiagnosticId, DiagnosticIdSchema, type DiagnosticWindow, type DiagnosticWindowPatch, DiagnosticWindowPatchSchema, DiagnosticWindowSchema, FeatureManifestSchema, type GetLoggingSettingsInput, GetLoggingSettingsInputSchema, HealthStatusSchema, type ISystemProvider, type LoggingEffective, LoggingEffectiveSchema, type LoggingExplicit, LoggingExplicitSchema, type LoggingLevelLayer, LoggingLevelLayerSchema, type LoggingLevelSource, LoggingLevelSourceSchema, type LoggingScopeKind, LoggingScopeKindSchema, type LoggingSettingsPatch, LoggingSettingsPatchSchema, type LoggingSettingsState, LoggingSettingsStateSchema, NetworkAddressSchema, type RequestCensusGroup, RequestCensusGroupSchema, type RequestCensusProcedure, RequestCensusProcedureSchema, type RequestCensusSnapshot, RequestCensusSnapshotSchema, type RequestCensusStatus, RequestCensusStatusSchema, type SetLoggingSettingsInput, SetLoggingSettingsInputSchema, type SetSiteLocationInput, SetSiteLocationInputSchema, type SiteLocation, SiteLocationSchema, type SiteLocationSource, SiteLocationSourceSchema, type SiteLocationStatus, SiteLocationStatusSchema, systemCapability, } from './system.cap.js';
+export { type DiagnosticId, DiagnosticIdSchema, type DiagnosticWindow, type DiagnosticWindowPatch, DiagnosticWindowPatchSchema, DiagnosticWindowSchema, FeatureManifestSchema, type GetLoggingSettingsInput, GetLoggingSettingsInputSchema, HealthStatusSchema, type ISystemProvider, type LogChannelWindowPatch, LogChannelWindowPatchSchema, type LogChannelWindowState, LogChannelWindowStateSchema, type LoggingEffective, LoggingEffectiveSchema, type LoggingExplicit, LoggingExplicitSchema, type LoggingLevelLayer, LoggingLevelLayerSchema, type LoggingLevelSource, LoggingLevelSourceSchema, type LoggingScopeKind, LoggingScopeKindSchema, type LoggingSettingsPatch, LoggingSettingsPatchSchema, type LoggingSettingsState, LoggingSettingsStateSchema, NetworkAddressSchema, type RequestCensusGroup, RequestCensusGroupSchema, type RequestCensusProcedure, RequestCensusProcedureSchema, type RequestCensusSnapshot, RequestCensusSnapshotSchema, type RequestCensusStatus, RequestCensusStatusSchema, type SetLoggingSettingsInput, SetLoggingSettingsInputSchema, type SetSiteLocationInput, SetSiteLocationInputSchema, type SiteLocation, SiteLocationSchema, type SiteLocationSource, SiteLocationSourceSchema, type SiteLocationStatus, SiteLocationStatusSchema, systemCapability, type TransportPlane, type TransportPlaneCounts, TransportPlaneCountsSchema, TransportPlaneSchema, } from './system.cap.js';
 export { type ITamperProvider, type TamperStatus, TamperStatusSchema, tamperCapability, } from './tamper.cap.js';
 export { type ITemperatureSensorProvider, type TemperatureSensorStatus, TemperatureSensorStatusSchema, temperatureSensorCapability, } from './temperature-sensor.cap.js';
 export { type IToastProvider, ToastSchema, toastCapability } from './toast.cap.js';
@@ -277,6 +279,7 @@ import type { llmCapability } from './llm.cap.js';
 import type { llmRuntimeCapability } from './llm-runtime.cap.js';
 import type { localNetworkCapability } from './local-network.cap.js';
 import type { lockControlCapability } from './lock-control.cap.js';
+import type { logChannelsCapability } from './log-channels.cap.js';
 import type { logDestinationCapability } from './log-destination.cap.js';
 import type { loginMethodCapability } from './login-method.cap.js';
 import type { mediaPlayerCapability } from './media-player.cap.js';
@@ -353,6 +356,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 storageMigrationCapability | 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 vectorStoreCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof coreBlocksCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof consumablesCapability | typeof connectionTestCapability | 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 | typeof osdCapability | typeof osdManagerCapability | typeof accessoriesCapability | typeof batteryCapability | typeof buttonCapability | typeof cameraCredentialsCapability | typeof deviceStatusCapability | typeof doorbellCapability | typeof eventEmitterCapability | typeof faceGalleryCapability | typeof featureProbeCapability | typeof intercomCapability | typeof nativeObjectDetectionCapability | typeof plateGalleryCapability | typeof switchCapability | typeof updateCapability | typeof videoclipsCapability;
+type AnyCapability = typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageMigrationCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof dataStoreProviderCapability | typeof logChannelsCapability | 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 vectorStoreCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof coreBlocksCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof consumablesCapability | typeof connectionTestCapability | 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 | typeof osdCapability | typeof osdManagerCapability | typeof accessoriesCapability | typeof batteryCapability | typeof buttonCapability | typeof cameraCredentialsCapability | typeof deviceStatusCapability | typeof doorbellCapability | typeof eventEmitterCapability | typeof faceGalleryCapability | typeof featureProbeCapability | typeof intercomCapability | typeof nativeObjectDetectionCapability | typeof plateGalleryCapability | typeof switchCapability | typeof updateCapability | typeof videoclipsCapability;
 export type CapabilityName = AnyCapability['name'];
 export type ITypedReadinessRegistry = IReadinessRegistry<CapabilityName>;

package/dist/capabilities/log-channels.cap.d.ts

@@ -0,0 +1,93 @@
+/**
+ * `log-channels` — the capability an addon DECLARES its diagnostic channels
+ * through. It stores nothing.
+ *
+ * ## Why a capability at all, and why this shape
+ *
+ * Which channels exist is knowledge only the addon has: `stream-broker` knows
+ * webrtc/ICE/RTP, `provider-reolink` knows baichuan/handshake. A central list
+ * maintained by hand rots at the first addition and rots INVISIBLY — nothing
+ * fails, an operator just never sees the channel somebody added. So the list
+ * is assembled from declarations at runtime.
+ *
+ * The shape is copied from `log-destination.cap.ts`, which already does
+ * exactly this job: `mode: 'collection'`, `internal: true`,
+ * `mount: { kind: 'skip' }` — no tRPC route, no generated hooks — while
+ * `addons.listCapabilityProviders` still enumerates it, and the hub's
+ * `CapabilityRegistry` still holds an RPC proxy per provider so a forked
+ * runner's declarations reach hub-main over the transport that already exists.
+ * No new UDS message, no second registry.
+ *
+ * ## What it deliberately does NOT own
+ *
+ * The VALUES — which channel is armed, for which cameras, until when — live in
+ * ONE place: the logging settings document on the `system` cap
+ * (`getLoggingSettings` / `setLoggingSettings`). Two authorities over the same
+ * value is the defect the plan behind this work exists to remove, and
+ * `setRequestCensus` was retired (D245) rather than allowed to be a second
+ * one. {@link logChannelsCapability} therefore has no getter for a level, no
+ * setter for a window and no persistence of any kind.
+ *
+ * ## Why `apply` is here even so
+ *
+ * The gate lives in the addon's PROCESS; the document lives in hub-main. Some
+ * seam has to carry the value from the authority to the mirror, and a channel
+ * that cannot be reached is precisely the dead knob this whole slice exists to
+ * make impossible (D62 — `audioThresholdDbfs`, the HA entities with no source).
+ * `apply` is that seam and nothing more: it writes an in-memory mirror, it
+ * persists nothing, it is never the source of a value, and it is called only
+ * with a set the hub actually read (D49 — a read that fails does not call it
+ * at all, so no channel is silently disarmed by a bad read).
+ */
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+/** What `apply` reports back — enough to log, not enough to be a second state. */
+declare const LogChannelApplyResultSchema: z.ZodObject<{
+    armed: z.ZodNumber;
+    unknown: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const logChannelsCapability: {
+    readonly name: "log-channels";
+    readonly scope: "system";
+    readonly mode: "collection";
+    readonly internal: true;
+    readonly methods: {
+        /** The channels this addon declares. Inert: no value, no state. */
+        readonly list: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            defaultLevel: z.ZodEnum<{
+                error: "error";
+                info: "info";
+                warn: "warn";
+            }>;
+            perDevice: z.ZodBoolean;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Refresh this process's mirror from the document's FULL set of armed
+         * windows.
+         *
+         * Full and not incremental on purpose: the document is the authority, so a
+         * channel it does not name is disarmed here. An incremental apply would
+         * let a disarm get lost in transit and leave a channel running that
+         * nobody can see is running.
+         */
+        readonly apply: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            windows: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                channel: z.ZodString;
+                armedUntilMs: z.ZodNumber;
+                deviceIds: z.ZodNullable<z.ZodReadonly<z.ZodArray<z.ZodNumber>>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            armed: z.ZodNumber;
+            unknown: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, "mutation">;
+    };
+    /** In-process only — enumerated through `addons.listCapabilityProviders`. */
+    readonly mount: {
+        readonly kind: "skip";
+    };
+};
+export type ILogChannelsProvider = InferProvider<typeof logChannelsCapability>;
+export type LogChannelApplyResult = z.infer<typeof LogChannelApplyResultSchema>;
+export { LogChannelApplyResultSchema };

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

@@ -33,6 +33,33 @@ declare const MutationFilterSchema: z.ZodObject<{
     whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
     whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
+/**
+ * One scalar an {@link settingsStoreCapability.methods.aggregate} call asks for.
+ *
+ * `as` names the slot in the result, so the SAME column may be asked twice with
+ * two operations (`MIN(startMs)` and `MAX(startMs)` in one round trip) — which
+ * a `Record<column, op>` shape could not express.
+ */
+declare const AggregateFieldSchema: z.ZodObject<{
+    as: z.ZodString;
+    field: z.ZodString;
+    op: z.ZodEnum<{
+        min: "min";
+        max: "max";
+        sum: "sum";
+    }>;
+}, z.core.$strip>;
+/**
+ * `COUNT(*)` plus one number per requested field.
+ *
+ * `null` means NO ROW MATCHED, never zero: a `SUM` over an empty set and a sum
+ * that really is 0 are different facts, and an accounting caller that renders
+ * "0 bytes, oldest = 0" for "nothing here" reports a lie about a disk.
+ */
+declare const AggregateResultSchema: z.ZodObject<{
+    count: z.ZodNumber;
+    values: z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
 /** A single stored record: `{ id, data }`. */
 declare const SettingsRecordSchema: z.ZodObject<{
     id: z.ZodString;
@@ -238,6 +265,57 @@ export declare const settingsStoreCapability: {
                 offset: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
         }, z.core.$strip>, z.ZodNumber, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * `COUNT(*)` and one `SUM` / `MIN` / `MAX` per requested field, in ONE
+         * statement, over the rows `filter` selects.
+         *
+         * Exists because "how much is there" was being answered by materialising
+         * "what is there". The recorder's storage-pressure sweep asked its in-RAM
+         * footage index for bytes/count/oldest/newest across a set of storage
+         * locations twice a minute, and the only way to answer that from a map is
+         * to visit every row — 7.1 M of them on the live hub, ~15 M row visits a
+         * minute on the main thread, which is also why the whole archive had to
+         * stay resident to be visited. The question is a sum; nothing needs to be
+         * materialised to answer it.
+         *
+         * **The engine REFUSES a field it cannot serve**, exactly as
+         * `query.columns` does and unlike a PREDICATE, which is skipped when
+         * unresolvable. A dropped predicate over-matches and the caller sees extra
+         * rows; a dropped aggregate returns a NUMBER that is wrong and looks
+         * exactly like a real one. That asymmetry is what this repo has already
+         * paid for once in `count`.
+         */
+        readonly aggregate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            fields: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                as: z.ZodString;
+                field: z.ZodString;
+                op: z.ZodEnum<{
+                    min: "min";
+                    max: "max";
+                    sum: "sum";
+                }>;
+            }, z.core.$strip>>>;
+            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>>>;
+                whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                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.ZodObject<{
+            count: z.ZodNumber;
+            values: z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>, 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>;
@@ -316,7 +394,9 @@ 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 { CollectionColumnSchema, CollectionIndexSchema, MutationFilterSchema, QueryFilterSchema, SettingsRecordSchema, };
+export { AggregateFieldSchema, AggregateResultSchema, CollectionColumnSchema, CollectionIndexSchema, MutationFilterSchema, QueryFilterSchema, SettingsRecordSchema, };
+export type AggregateField = z.infer<typeof AggregateFieldSchema>;
+export type AggregateResult = z.infer<typeof AggregateResultSchema>;
 export type MutationFilter = z.infer<typeof MutationFilterSchema>;
 export type CollectionColumn = z.infer<typeof CollectionColumnSchema>;
 export type CollectionIndex = z.infer<typeof CollectionIndexSchema>;