@camstack/types 1.2.118 → 1.2.120

package/dist/addon/base-addon.d.ts

@@ -189,7 +189,65 @@ export declare abstract class BaseAddon<TConfig extends object = Record<string,
     protected globalSettingsSchema(_cap?: string): ConfigUISchema | null;
     /** Override to provide device-level settings UI schema. */
     protected deviceSettingsSchema(): ConfigUISchema | null;
+    /**
+     * INTEGRATION-LEVEL SETTINGS — declare which of this addon's global sections
+     * ARE the configuration of its integration.
+     *
+     * Return the `ConfigSection.id`s, from {@link globalSettingsSchema}, that an
+     * operator should find on the addon's integration page (System →
+     * Integrations → <name>) rather than only in the cluster-wide list of every
+     * addon. Empty (the default) means the addon has no integration-level
+     * settings and no such surface is offered — this is opt-in, because whether
+     * an addon's configuration IS its integration's configuration depends on the
+     * nature of the integration.
+     *
+     * WHAT THIS IS NOT. It is not a scope. The selected sections keep living in
+     * the ONE global schema, in the ONE addon store, written by the ONE
+     * `updateGlobalSettings` path. There is deliberately no
+     * `updateIntegrationSettings`: a second write path is how a surface acquires
+     * a second store key, and this repo has shipped that twice (`btmPath@hub`,
+     * D266). Selecting sections cannot introduce a key that selecting cannot.
+     *
+     * WHY IT IS A LIST OF SECTION IDS AND NOT A MARKER ON THE SECTION.
+     * `ConfigFieldBase` used to carry `scope?: 'device' | 'global'` and it was
+     * removed with the reason recorded at
+     * `packages/types/src/interfaces/config-ui.ts:249` — *"a field's scope is
+     * determined by WHICH schema it lives in, not by a field-level marker."* A
+     * marker sprinkled across sections also has to borrow a field that already
+     * means something else; borrowing `section.tab` put the literal word
+     * "integration" into an operator-facing tab bar, because `tab` means "how to
+     * GROUP this visually" and cannot also mean "where this lives" (D269
+     * supersedes D268). One declaration, in one place, next to the schema whose
+     * ids it names.
+     */
+    protected integrationSettingSections(): readonly string[];
     getGlobalSettings(overlay?: Record<string, unknown>, cap?: string, nodeId?: string): Promise<ConfigUISchemaWithValues | null>;
+    /**
+     * The integration-level view of this addon's settings: exactly the sections
+     * named by {@link integrationSettingSections}, hydrated from the SAME store
+     * `getGlobalSettings` reads, and narrowed to cluster-scoped fields.
+     *
+     * Returns `null` when the addon declared nothing — an addon that opts out has
+     * no integration settings surface at all, rather than an empty one that reads
+     * as a failed load.
+     *
+     * Three properties hold BY CONSTRUCTION, which is why they are here in core
+     * and not in whichever UI happens to render this:
+     *
+     *  1. **One key.** The payload is a SUBSET of the global schema, so a field
+     *     shown here is the same field, with the same bare key, that the addon's
+     *     own page shows. There is no integration-specific writer — callers save
+     *     through `updateGlobalSettings` — so a second store key is unreachable,
+     *     not merely discouraged.
+     *  2. **No node scope.** `perNode: true` fields are DROPPED. Their store key
+     *     is `<key>@<nodeId>` and an integration is not a node; whichever node
+     *     such a field silently picked would be a wrong answer for the operator
+     *     who opened the page (D266).
+     *  3. **No silent typo.** A declared id that names no section throws. The
+     *     alternative — skip it — turns a rename into a surface that quietly
+     *     empties, which looks exactly like an addon with nothing to configure.
+     */
+    getIntegrationSettings(nodeId?: string): Promise<ConfigUISchemaWithValues | null>;
     /**
      * The raw addon store PROJECTED onto the target node's bare per-node keys:
      * every `perNode: true` field carries THAT node's scoped value on its bare

package/dist/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_event_category = require("./event-category-BaEgqJNv.js");
-const require_sleep = require("./sleep-9d8tJRbO.js");
+const require_sleep = require("./sleep-DUxF5DdC.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 //#region src/generated/cap-input-defaults.ts
 /**
@@ -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

@@ -1,5 +1,5 @@
 import { t as EventCategory } from "./event-category-BZL-fdNj.mjs";
-import { B as ReadinessRegistry, E as adminUiCapability, L as nodePin, R as readNodePin, St as emitReadiness, T as DeviceType, V as ReadinessTimeoutError, W as scopeKey, _t as DisposerChain, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, gt as DATAPLANE_SECRET_HEADER, h as createEventBusSliceSource, j as expandCapMethods, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, vt as BaseAddon, x as viewerUiCapability, yt as normalizeAddonInitResult } from "./sleep-Dolp38qx.mjs";
+import { B as ReadinessRegistry, E as adminUiCapability, L as nodePin, R as readNodePin, St as emitReadiness, T as DeviceType, V as ReadinessTimeoutError, W as scopeKey, _t as DisposerChain, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, gt as DATAPLANE_SECRET_HEADER, h as createEventBusSliceSource, j as expandCapMethods, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, vt as BaseAddon, x as viewerUiCapability, yt as normalizeAddonInitResult } from "./sleep-C9C8EoK8.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 //#region src/generated/cap-input-defaults.ts
 /**
@@ -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/addon-settings.cap.d.ts

@@ -126,6 +126,35 @@ export declare const addonSettingsCapability: {
         }, z.core.$strip>, z.ZodObject<{
             success: z.ZodLiteral<true>;
         }, z.core.$strip>, "mutation">;
+        readonly getIntegrationSettings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            addonId: z.ZodString;
+            nodeId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
+            tabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                icon: z.ZodString;
+                order: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            sections: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodEnum<{
+                    card: "card";
+                    accordion: "accordion";
+                }>>;
+                defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+                columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+                tab: z.ZodOptional<z.ZodString>;
+                location: z.ZodOptional<z.ZodEnum<{
+                    settings: "settings";
+                    "top-tab": "top-tab";
+                }>>;
+                order: z.ZodOptional<z.ZodNumber>;
+                fields: z.ZodArray<z.ZodAny>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly getDeviceSettings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             addonId: z.ZodString;
             deviceId: z.ZodNumber;

package/dist/capabilities/audio-analyzer.cap.d.ts

@@ -61,9 +61,13 @@ export type AudioBackendChoice = (typeof AUDIO_BACKEND_CHOICES)[number]['value']
 /**
  * Shared shape of the audio-analyzer addon's global settings.
  * `audioBackend` = operator choice (wins); `probedBestAudioBackend`
- * = hint refreshed by `reprobeAudioEngine`. `selectedAudioModel`
- * replaces the orchestrator's legacy
- * `AgentPipelineSettings.audio.modelId`.
+ * = hint refreshed by `reprobeAudioEngine`.
+ *
+ * There is NO model id here. The backend IS the model: YAMNet ships one
+ * ONNX graph and Apple SoundAnalysis is a built-in with nothing swappable,
+ * so `createAudioPipeline` takes a backend and no model. A
+ * `selectedAudioModel` select shipped here until 2026-08-28 (D272) and
+ * reached inference on no path — it was a log field.
  *
  * NOTE — enable/disable is NOT stored here:
  *   - per-device: `audio-analysis` wrapper cap + `setWrapperActive`
@@ -75,7 +79,6 @@ export type AudioBackendChoice = (typeof AUDIO_BACKEND_CHOICES)[number]['value']
 export interface AudioAnalyzerGlobalConfig {
     readonly audioBackend: AudioBackendChoice;
     readonly probedBestAudioBackend: string;
-    readonly selectedAudioModel: string;
 }
 export declare const DEFAULT_AUDIO_ANALYZER_CONFIG: AudioAnalyzerGlobalConfig;
 export declare const audioAnalyzerCapability: {

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';
@@ -209,6 +210,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof addonSettingsCapability.methods.updateGlobalSettings.output>;
             meta: object;
         }>;
+        getIntegrationSettings: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof addonSettingsCapability.methods.getIntegrationSettings.input>;
+            output: z.infer<typeof addonSettingsCapability.methods.getIntegrationSettings.output>;
+            meta: object;
+        }>;
         getDeviceSettings: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;
@@ -2998,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;
@@ -7772,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: 975 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

@@ -56,7 +56,7 @@ import type { userManagementCapability } from '../capabilities/user-management.c
 export interface SystemProxy {
     readonly addonPages: Pick<InferProvider<typeof addonPagesCapability>, 'listPages'>;
     readonly addons: Pick<InferProvider<typeof addonsCapability>, 'list' | 'getLogs' | 'listPackages' | 'installPackage' | 'installFromWorkspace' | 'isWorkspaceAvailable' | 'listWorkspacePackages' | 'uninstallPackage' | 'reloadPackages' | 'searchAvailable' | 'listUpdates' | 'updatePackage' | 'rollbackPackage' | 'forceRefresh' | 'restartServer' | 'getLastRestart' | 'listFrameworkPackages' | 'listCapabilityProviders' | 'setCapabilityProviderEnabled' | 'getVersions' | 'restartAddon' | 'retryLoad' | 'getAutoUpdateSettings' | 'setAutoUpdateSettings' | 'getAddonAutoUpdate' | 'setAddonAutoUpdate' | 'applyAutoUpdateToAll' | 'custom' | 'startJob' | 'getJob' | 'listJobs' | 'cancelJob' | 'onAddonLogs'>;
-    readonly addonSettings: Pick<InferProvider<typeof addonSettingsCapability>, 'getGlobalSettings' | 'updateGlobalSettings'>;
+    readonly addonSettings: Pick<InferProvider<typeof addonSettingsCapability>, 'getGlobalSettings' | 'updateGlobalSettings' | 'getIntegrationSettings'>;
     readonly addonWidgets: Pick<InferProvider<typeof addonWidgetsCapability>, 'listWidgets'>;
     readonly alerts: Pick<InferProvider<typeof alertsCapability>, 'emit' | 'update' | 'list' | 'getUnreadCount' | 'markRead' | 'markAllRead' | 'dismiss'>;
     readonly audioAnalyzer: Pick<InferProvider<typeof audioAnalyzerCapability>, 'analyseChunk' | 'classify' | 'isReady' | 'dispose' | 'reprobeAudioEngine'>;
@@ -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';