@camstack/types 1.2.119 → 1.2.120

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: 19 collection caps, 32 array methods.
+* Coverage: 20 collection caps, 33 array methods.
 */
 var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"addon-pages-source": ["listPages"],
@@ -323,6 +323,7 @@ var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"data-store-provider": ["histogram", "query"],
 	"device-export": ["listExposedDevices", "listSupportedDeviceKinds"],
 	"device-provider": ["discoverDevices", "getDevices"],
+	"failure-contribution": ["list"],
 	"llm": [
 		"getDefaults",
 		"getUsage",

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: 19 collection caps, 32 array methods.
+* Coverage: 20 collection caps, 33 array methods.
 */
 var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"addon-pages-source": ["listPages"],
@@ -322,6 +322,7 @@ var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"data-store-provider": ["histogram", "query"],
 	"device-export": ["listExposedDevices", "listSupportedDeviceKinds"],
 	"device-provider": ["discoverDevices", "getDevices"],
+	"failure-contribution": ["list"],
 	"llm": [
 		"getDefaults",
 		"getUsage",

package/dist/capabilities/failure-contribution.cap.d.ts

@@ -0,0 +1,111 @@
+/**
+ * `failure-contribution` — the capability an addon reports its OWN losses
+ * through, per camera, with the denominator attached. It stores nothing.
+ *
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
+ *
+ * `load-contribution` answers *what did this camera COST*. This answers *what
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
+ * copied: the contributor reports what it already knows, hub-main adds only
+ * `addonId`, nothing needs global knowledge, and there is no central list for
+ * somebody to forget to edit.
+ *
+ * They are not merged, because their invariants are opposites:
+ *
+ *  - a `load-contribution` measurement is **absent, never zero** — a zero would
+ *    claim a camera cost nothing, which is a measurement nobody made;
+ *  - a `failure-contribution` zero is the **most valuable value on the
+ *    surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
+ *    and it is exactly what an absent entry cannot say.
+ *
+ * Putting a loss counter on a cost entry would also break the reconciliation
+ * that gives `load-contribution` its point: contributions are subtracted from
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
+ * has no process.
+ *
+ * ## Why not a log line, since the counters already exist
+ *
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
+ * ends in a log line, and a log line is the thing the operator asked to stop
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
+ * media blackout were both diagnosed. The counters stay; this is where they can
+ * be READ.
+ *
+ * ## The rate is served with its denominator or not at all
+ *
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
+ * than yesterday" and was **flat across twelve hours** once divided by the
+ * successes on the same path. A surface that publishes only the numerator
+ * reproduces that mistake on every read.
+ *
+ * ## Shape
+ *
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and 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 entries reach hub-main over transport that already exists.
+ * No new UDS message, no second registry (D3). The operator reads the assembled
+ * result through `system.getFailureContributions`.
+ */
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+declare const FailureReasonCountSchema: z.ZodObject<{
+    reason: z.ZodString;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+declare const FailureContributionSchema: z.ZodObject<{
+    family: z.ZodString;
+    deviceId: z.ZodNumber;
+    variant: z.ZodOptional<z.ZodString>;
+    sinceMs: z.ZodNumber;
+    atMs: z.ZodNumber;
+    attempts: z.ZodNumber;
+    succeeded: z.ZodNumber;
+    reasons: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        reason: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type FailureContribution = z.infer<typeof FailureContributionSchema>;
+export declare const failureContributionCapability: {
+    readonly name: "failure-contribution";
+    readonly scope: "system";
+    readonly mode: "collection";
+    readonly internal: true;
+    readonly methods: {
+        /**
+         * This addon's per-camera failure counters, read live from bounded in-RAM
+         * state it already keeps. Inert: no persistence, no sampling, no timer.
+         *
+         * READING NEVER RESETS. The counters are CUMULATIVE since `sinceMs`, and a
+         * consumer that wants a rate differences two reads. A draining read would
+         * make two operators with the page open each destroy half of the other's
+         * numbers, and `load-contribution` already settled the same question the
+         * same way for `cpuSeconds`.
+         */
+        readonly list: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            family: z.ZodString;
+            deviceId: z.ZodNumber;
+            variant: z.ZodOptional<z.ZodString>;
+            sinceMs: z.ZodNumber;
+            atMs: z.ZodNumber;
+            attempts: z.ZodNumber;
+            succeeded: z.ZodNumber;
+            reasons: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                reason: z.ZodString;
+                count: z.ZodNumber;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+    };
+    /** In-process only — enumerated through `addons.listCapabilityProviders`. */
+    readonly mount: {
+        readonly kind: "skip";
+    };
+};
+export type IFailureContributionProvider = InferProvider<typeof failureContributionCapability>;
+export { FailureContributionSchema, FailureReasonCountSchema };

package/dist/capabilities/index.d.ts

@@ -62,6 +62,8 @@ export { type LlmErrorCode, LlmErrorCodeSchema, type LlmGenerateBaseInput, LlmGe
 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 { FailureContribution, IFailureContributionProvider, } from './failure-contribution.cap.js';
+export { FailureContributionSchema, FailureReasonCountSchema, failureContributionCapability, } from './failure-contribution.cap.js';
 export type { ILoadContributionProvider, LoadContribution, LoadContributionAttribution, LoadContributionRole, } from './load-contribution.cap.js';
 export { LOAD_CONTRIBUTION_ATTRIBUTIONS, LOAD_CONTRIBUTION_ROLES, LoadContributionSchema, loadContributionCapability, } from './load-contribution.cap.js';
 export type { ILoginMethodProvider, LoginMethodContribution, LoginStage, PasskeyLoginMethod, RedirectLoginMethod, WidgetLoginMethod, } from './login-method.cap.js';
@@ -193,7 +195,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 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 ReportedLoadContribution, ReportedLoadContributionSchema, 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 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 ReportedFailureContribution, ReportedFailureContributionSchema, type ReportedLoadContribution, ReportedLoadContributionSchema, 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';
@@ -282,6 +284,7 @@ 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 { failureContributionCapability } from './failure-contribution.cap.js';
 import type { loadContributionCapability } from './load-contribution.cap.js';
 import type { logDestinationCapability } from './log-destination.cap.js';
 import type { loginMethodCapability } from './login-method.cap.js';
@@ -359,6 +362,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 logChannelsCapability | typeof logDestinationCapability | typeof loadContributionCapability | 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 loadContributionCapability | typeof failureContributionCapability | 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/pipeline-analytics.cap.d.ts

@@ -437,6 +437,7 @@ declare const TrackSchema: z.ZodObject<{
     hasFace: z.ZodOptional<z.ZodBoolean>;
     hasEmbeddedFace: z.ZodOptional<z.ZodBoolean>;
     hasRider: z.ZodOptional<z.ZodBoolean>;
+    previewMissReason: z.ZodOptional<z.ZodString>;
     label: z.ZodOptional<z.ZodString>;
     labelScore: z.ZodOptional<z.ZodNumber>;
     labelMeta: z.ZodOptional<z.ZodObject<{
@@ -1090,6 +1091,7 @@ declare const RecentTracksPageSchema: z.ZodObject<{
         hasFace: z.ZodOptional<z.ZodBoolean>;
         hasEmbeddedFace: z.ZodOptional<z.ZodBoolean>;
         hasRider: z.ZodOptional<z.ZodBoolean>;
+        previewMissReason: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
         labelScore: z.ZodOptional<z.ZodNumber>;
         labelMeta: z.ZodOptional<z.ZodObject<{
@@ -1451,6 +1453,7 @@ export declare const pipelineAnalyticsCapability: {
             hasFace: z.ZodOptional<z.ZodBoolean>;
             hasEmbeddedFace: z.ZodOptional<z.ZodBoolean>;
             hasRider: z.ZodOptional<z.ZodBoolean>;
+            previewMissReason: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
             labelScore: z.ZodOptional<z.ZodNumber>;
             labelMeta: z.ZodOptional<z.ZodObject<{
@@ -1548,6 +1551,7 @@ export declare const pipelineAnalyticsCapability: {
             hasFace: z.ZodOptional<z.ZodBoolean>;
             hasEmbeddedFace: z.ZodOptional<z.ZodBoolean>;
             hasRider: z.ZodOptional<z.ZodBoolean>;
+            previewMissReason: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
             labelScore: z.ZodOptional<z.ZodNumber>;
             labelMeta: z.ZodOptional<z.ZodObject<{
@@ -1668,6 +1672,7 @@ export declare const pipelineAnalyticsCapability: {
             hasFace: z.ZodOptional<z.ZodBoolean>;
             hasEmbeddedFace: z.ZodOptional<z.ZodBoolean>;
             hasRider: z.ZodOptional<z.ZodBoolean>;
+            previewMissReason: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
             labelScore: z.ZodOptional<z.ZodNumber>;
             labelMeta: z.ZodOptional<z.ZodObject<{
@@ -1784,6 +1789,7 @@ export declare const pipelineAnalyticsCapability: {
                 hasFace: z.ZodOptional<z.ZodBoolean>;
                 hasEmbeddedFace: z.ZodOptional<z.ZodBoolean>;
                 hasRider: z.ZodOptional<z.ZodBoolean>;
+                previewMissReason: z.ZodOptional<z.ZodString>;
                 label: z.ZodOptional<z.ZodString>;
                 labelScore: z.ZodOptional<z.ZodNumber>;
                 labelMeta: z.ZodOptional<z.ZodObject<{

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

@@ -508,6 +508,27 @@ declare const ReportedLoadContributionSchema: z.ZodObject<{
     addonId: z.ZodString;
 }, z.core.$strip>;
 export type ReportedLoadContribution = z.infer<typeof ReportedLoadContributionSchema>;
+/**
+ * One per-camera failure counter, plus WHO reported it.
+ *
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
+ * the hub as it enumerates providers, never by the contributor.
+ */
+declare const ReportedFailureContributionSchema: z.ZodObject<{
+    family: z.ZodString;
+    deviceId: z.ZodNumber;
+    variant: z.ZodOptional<z.ZodString>;
+    sinceMs: z.ZodNumber;
+    atMs: z.ZodNumber;
+    attempts: z.ZodNumber;
+    succeeded: z.ZodNumber;
+    reasons: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        reason: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>>;
+    addonId: z.ZodString;
+}, z.core.$strip>;
+export type ReportedFailureContribution = z.infer<typeof ReportedFailureContributionSchema>;
 declare const GetLoggingSettingsInputSchema: z.ZodObject<{
     scopeNodeId: z.ZodOptional<z.ZodString>;
     scopeComponent: z.ZodOptional<z.ZodString>;
@@ -805,6 +826,41 @@ export declare const systemCapability: {
             rssBytes: z.ZodOptional<z.ZodNumber>;
             addonId: z.ZodString;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Every `failure-contribution` an addon on this cluster reports — per
+         * camera, per reason, **with the denominator attached**.
+         *
+         * This is the surface the operator asked for on 2026-08-28 (*"possiamo
+         * armare questi errori intanto? Così al prossimo giro ricontrolliamo tutti
+         * questi punti"*). Before it, four live failure modes could only be counted
+         * by grepping Loki and hand-correlating timestamps, which is exactly how a
+         * 22% thumbnail gap and a 3-hour media blackout were diagnosed — twice.
+         *
+         * Read it as a RATIO, never as a count. `attempts` is on every entry
+         * because the count on its own lies: `enrichment crop native miss` read as
+         * "35x worse than yesterday" and was flat across twelve hours once divided
+         * by the successes on the same path.
+         *
+         * The counters are CUMULATIVE since each entry's `sinceMs`. Reading does
+         * not reset them, and `sinceMs` changing means the reporting runner
+         * respawned — a consumer differencing two reads drops that interval.
+         *
+         * Admin-only: the rows name cameras and the paths that fail on them.
+         */
+        readonly getFailureContributions: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            family: z.ZodString;
+            deviceId: z.ZodNumber;
+            variant: z.ZodOptional<z.ZodString>;
+            sinceMs: z.ZodNumber;
+            atMs: z.ZodNumber;
+            attempts: z.ZodNumber;
+            succeeded: z.ZodNumber;
+            reasons: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                reason: z.ZodString;
+                count: z.ZodNumber;
+            }, z.core.$strip>>>;
+            addonId: z.ZodString;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * The logging settings document — levels and armed diagnostics — resolved
          * for `nodeId`, or for the cluster when `nodeId` is absent.
@@ -1002,4 +1058,4 @@ export type SiteLocation = z.infer<typeof SiteLocationSchema>;
 export type SiteLocationSource = z.infer<typeof SiteLocationSourceSchema>;
 export type SiteLocationStatus = z.infer<typeof SiteLocationStatusSchema>;
 export type SetSiteLocationInput = z.infer<typeof SetSiteLocationInputSchema>;
-export { DiagnosticIdSchema, DiagnosticWindowPatchSchema, DiagnosticWindowSchema, FeatureManifestSchema, GetLoggingSettingsInputSchema, HealthStatusSchema, LoggingEffectiveSchema, LoggingExplicitSchema, LoggingLevelLayerSchema, LoggingLevelSourceSchema, LoggingScopeKindSchema, LoggingSettingsPatchSchema, LoggingSettingsStateSchema, LogChannelWindowPatchSchema, LogChannelWindowStateSchema, LogLevelSchema, NetworkAddressSchema, ReportedLoadContributionSchema, RequestCensusGroupSchema, RequestCensusProcedureSchema, RequestCensusSnapshotSchema, RequestCensusStatusSchema, SetLoggingSettingsInputSchema, SetSiteLocationInputSchema, SiteLocationSchema, SiteLocationSourceSchema, SiteLocationStatusSchema, TransportPlaneCountsSchema, TransportPlaneSchema, };
+export { DiagnosticIdSchema, DiagnosticWindowPatchSchema, DiagnosticWindowSchema, FeatureManifestSchema, GetLoggingSettingsInputSchema, HealthStatusSchema, LoggingEffectiveSchema, LoggingExplicitSchema, LoggingLevelLayerSchema, LoggingLevelSourceSchema, LoggingScopeKindSchema, LoggingSettingsPatchSchema, LoggingSettingsStateSchema, LogChannelWindowPatchSchema, LogChannelWindowStateSchema, LogLevelSchema, NetworkAddressSchema, ReportedFailureContributionSchema, ReportedLoadContributionSchema, RequestCensusGroupSchema, RequestCensusProcedureSchema, RequestCensusSnapshotSchema, RequestCensusStatusSchema, SetLoggingSettingsInputSchema, SetSiteLocationInputSchema, SiteLocationSchema, SiteLocationSourceSchema, SiteLocationStatusSchema, TransportPlaneCountsSchema, TransportPlaneSchema, };

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

@@ -45,6 +45,7 @@ import type { deviceStateCapability } from '../capabilities/device-state.cap.js'
 import type { embeddingEncoderCapability } from '../capabilities/embedding-encoder.cap.js';
 import type { eventsCapability } from '../capabilities/events.cap.js';
 import type { faceGalleryCapability } from '../capabilities/face-gallery.cap.js';
+import type { failureContributionCapability } from '../capabilities/failure-contribution.cap.js';
 import type { fanControlCapability } from '../capabilities/fan-control.cap.js';
 import type { filesystemBrowseCapability } from '../capabilities/filesystem-browse.cap.js';
 import type { humidifierCapability } from '../capabilities/humidifier.cap.js';
@@ -3005,6 +3006,21 @@ export type AppRouter = TrpcCoreRouter<{
             meta: object;
         }>;
     }>>;
+    failureContribution: TRPCBuiltRouter<{
+        ctx: TrpcContext;
+        meta: object;
+        errorShape: AugmentedErrorShape;
+        transformer: true;
+    }, TRPCDecorateCreateRouterOptions<{
+        list: TRPCQueryProcedure<{
+            input: {
+                nodeId?: string | undefined;
+                addonId?: string | undefined;
+            } | undefined;
+            output: z.infer<typeof failureContributionCapability.methods.list.output>;
+            meta: object;
+        }>;
+    }>>;
     fanControl: TRPCBuiltRouter<{
         ctx: TrpcContext;
         meta: object;
@@ -7779,6 +7795,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof systemCapability.methods.getLoadContributions.output>;
             meta: object;
         }>;
+        getFailureContributions: TRPCQueryProcedure<{
+            input: {
+                nodeId?: string | undefined;
+            } | undefined;
+            output: z.infer<typeof systemCapability.methods.getFailureContributions.output>;
+            meta: object;
+        }>;
         getLoggingSettings: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;

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

@@ -55,6 +55,7 @@ export { enumSensorCapability } from '../capabilities/enum-sensor.cap.js';
 export { eventEmitterCapability } from '../capabilities/event-emitter.cap.js';
 export { eventsCapability } from '../capabilities/events.cap.js';
 export { faceGalleryCapability } from '../capabilities/face-gallery.cap.js';
+export { failureContributionCapability } from '../capabilities/failure-contribution.cap.js';
 export { fanControlCapability } from '../capabilities/fan-control.cap.js';
 export { featureProbeCapability } from '../capabilities/feature-probe.cap.js';
 export { filesystemBrowseCapability } from '../capabilities/filesystem-browse.cap.js';
@@ -207,6 +208,7 @@ export declare const CAPABILITY_NAMES: {
     readonly eventEmitter: "event-emitter";
     readonly events: "events";
     readonly faceGallery: "face-gallery";
+    readonly failureContribution: "failure-contribution";
     readonly fanControl: "fan-control";
     readonly featureProbe: "feature-probe";
     readonly filesystemBrowse: "filesystem-browse";
@@ -372,6 +374,7 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly eventEmitter: TRouter;
     readonly events: TRouter;
     readonly faceGallery: TRouter;
+    readonly failureContribution: TRouter;
     readonly fanControl: TRouter;
     readonly featureProbe: TRouter;
     readonly filesystemBrowse: TRouter;
@@ -471,8 +474,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-pipeline-config", "camera-streams", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "core-blocks", "cover", "day-night", "decoder", "detection-pipeline", "device-adoption", "device-discovery", "device-manager", "device-ops", "device-state", "device-status", "doorbell", "enum-sensor", "event-emitter", "events", "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", "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", "recording-export", "scene-monitor", "script-runner", "server-management", "settings-store", "smoke", "snapshot", "sso-bridge", "storage", "storage-migration", "stream-broker", "stream-catalog", "stream-params", "switch", "system", "tamper", "temperature-sensor", "terminal-session", "toast", "update", "user-management", "vacuum-control", "valve", "vector-store", "vibration", "videoclips", "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` (26 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", "llm", "load-contribution", "log-channels", "log-destination", "login-method", "mesh-network", "mqtt-broker", "network-access", "notification-output", "oauth-integration", "smtp-provider", "storage-evictable", "storage-provider", "turn-provider", "user-passkeys"];
+/** Capability names whose mode is `collection` (27 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", "smtp-provider", "storage-evictable", "storage-provider", "turn-provider", "user-passkeys"];
 /** 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: 19 collection caps, 32 array methods.
+ * Coverage: 20 collection caps, 33 array methods.
  */
 export declare const COLLECTION_ARRAY_METHODS: Readonly<Record<string, readonly string[]>>;
 /**

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: 976 method paths across 125 capabilities.
+ * Coverage: 978 method paths across 126 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

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

@@ -94,7 +94,7 @@ export interface SystemProxy {
     readonly storage: Pick<InferProvider<typeof storageCapability>, 'resolve' | 'write' | 'read' | 'exists' | 'list' | 'delete' | 'getAvailableSpace' | 'beginUpload' | 'writeChunk' | 'finalizeUpload' | 'abortUpload' | 'beginDownload' | 'readChunk' | 'endDownload' | 'listLocations' | 'getDefaultLocation' | 'listLocationDeclarations' | 'upsertLocation' | 'deleteLocation' | 'testLocation' | 'listProviders' | 'testConfig'>;
     readonly storageMigration: Pick<InferProvider<typeof storageMigrationCapability>, 'plan' | 'start' | 'status' | 'cancel'>;
     readonly streamBroker: Pick<InferProvider<typeof streamBrokerCapability>, 'fetchEventMedia' | 'listAllCameraStreams' | 'listAllProfileSlots' | 'getBrokerStats' | 'probeStream' | 'listClients' | 'killClient' | 'getStreamUrl' | 'getStreamWithCodec' | 'releaseStreamWithCodec' | 'acquireEgressTranscode' | 'releaseEgressTranscode' | 'subscribeAudioChunks' | 'pullAudioChunks' | 'unsubscribeAudioChunks' | 'subscribeFrames' | 'pullFrameHandles' | 'unsubscribeFrames' | 'setPreBufferDuration' | 'getPreBufferInfo' | 'getRtspPort' | 'getAllRtspEntries' | 'getRtspEntry' | 'regenerateRtspToken' | 'setRtspEnabled' | 'isRtspEnabled'>;
-    readonly system: Pick<InferProvider<typeof systemCapability>, 'info' | 'health' | 'featureFlags' | 'networkAddresses' | 'getRetentionConfig' | 'setRetentionConfig' | 'forceRetentionCleanup' | 'getSiteLocation' | 'setSiteLocation' | 'detectSiteLocation' | 'getRequestCensus' | 'getLoadContributions' | 'getLoggingSettings' | 'setLoggingSettings'>;
+    readonly system: Pick<InferProvider<typeof systemCapability>, 'info' | 'health' | 'featureFlags' | 'networkAddresses' | 'getRetentionConfig' | 'setRetentionConfig' | 'forceRetentionCleanup' | 'getSiteLocation' | 'setSiteLocation' | 'detectSiteLocation' | 'getRequestCensus' | 'getLoadContributions' | 'getFailureContributions' | 'getLoggingSettings' | 'setLoggingSettings'>;
     readonly terminalSession: Pick<InferProvider<typeof terminalSessionCapability>, 'listProfiles' | 'listInstances' | 'createInstance' | 'updateInstance' | 'deleteInstance' | 'setInstanceEnabled' | 'listLegacyCameras' | 'adoptLegacyMonitor' | 'listSessions' | 'openSession' | 'resize' | 'pullOutput' | 'writeInput' | 'close'>;
     readonly toast: Pick<InferProvider<typeof toastCapability>, 'onToast'>;
     readonly turnProvider: Pick<InferProvider<typeof turnProviderCapability>, 'getTurnServers'>;

package/dist/index.d.ts

@@ -103,6 +103,8 @@ export { emitDownForOwnedCaps, ReadinessRegistry, ReadinessTimeoutError, readine
 export * from './stream-selection.js';
 export { ROOT_BUCKET_KEY, UNATTRIBUTED_BUCKET_KEY, foldSnapshotByFunction, reducePoints, resolveBucketMs, } from './metrics/load-series-fold.js';
 export type { LoadBucket, LoadBucketKind, LoadPoint, LoadProcessRow, } from './metrics/load-series-fold.js';
+export { FailureCounters, MAX_KEYS, MAX_REASONS_PER_KEY, OVERFLOW_REASON, failureRate, } from './metrics/failure-counters.js';
+export type { FailureCounterSample, FailureObservation, FailureReasonCount, } from './metrics/failure-counters.js';
 export type { AgentAddonConfig, AgentPipelineSettings, CameraPipelineSettings, CameraStepOverridePatch, DeviceStepConfig, } from './types/agent-pipeline-settings.js';
 export * from './types/analytics.js';
 export type { CameraPipelineConfig, PipelineTemplate as CameraPipelineTemplate, } from './types/camera-pipeline.js';