@camstack/types 1.2.116 → 1.2.117

package/dist/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_category = require("./event-category-EY0GNjV9.js");
-const require_sleep = require("./sleep-CSodb2vQ.js");
+const require_event_category = require("./event-category-BaEgqJNv.js");
+const require_sleep = require("./sleep-9d8tJRbO.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: 18 collection caps, 31 array methods.
+* Coverage: 19 collection caps, 32 array methods.
 */
 var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"addon-pages-source": ["listPages"],
@@ -333,6 +333,7 @@ var COLLECTION_ARRAY_METHODS = Object.freeze({
 		"listProfiles",
 		"listRuntimeNodes"
 	],
+	"load-contribution": ["list"],
 	"log-channels": ["list"],
 	"log-destination": ["query"],
 	"login-method": ["getLoginMethods"],

package/dist/addon.mjs

@@ -1,5 +1,5 @@
-import { t as EventCategory } from "./event-category-CIa_iT6b.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-CdbM8ge4.mjs";
+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 { 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: 18 collection caps, 31 array methods.
+* Coverage: 19 collection caps, 32 array methods.
 */
 var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"addon-pages-source": ["listPages"],
@@ -332,6 +332,7 @@ var COLLECTION_ARRAY_METHODS = Object.freeze({
 		"listProfiles",
 		"listRuntimeNodes"
 	],
+	"load-contribution": ["list"],
 	"log-channels": ["list"],
 	"log-destination": ["query"],
 	"login-method": ["getLoginMethods"],

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

@@ -117,6 +117,17 @@ export declare const dataStoreProviderCapability: {
                 data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /** Insert many records in ONE transaction. All or nothing. */
+        readonly insertMany: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            records: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            inserted: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
         /** Update an existing record by ID. */
         readonly update: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             namespace: z.ZodOptional<z.ZodString>;

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 { 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';
 export { LoginMethodContributionSchema, LoginStageEnum, loginMethodCapability, PasskeyLoginMethodSchema, RedirectLoginMethodSchema, WidgetLoginMethodSchema, } from './login-method.cap.js';
 export { type IMetricsProvider, metricsProviderCapability, SystemMetricsSchema, } from './metrics-provider.cap.js';
@@ -91,7 +93,7 @@ export type { CameraStream, CamProfile, CamStreamKind, DecodedAudioChunkWire, Fr
 export { BrokerStatsSchema, BrokerStatusSchema, CAM_PROFILE_ORDER, CameraStreamSchema, CamProfileSchema, CamStreamKindSchema, CamStreamResolutionSchema, DecodedAudioChunkSchema, DecodedFrameSchema, EncodedPacketSchema, FrameHandleFormatSchema, FrameHandleSchema, makeProfileBrokerId, makeSourceBrokerId, ProfileRtspEntrySchema, ProfileSlotSchema, ProfileSlotStatusSchema, parseProfileBrokerId, StreamSourceEntrySchema, StreamSourceSchema, SubscribeAudioChunksInputSchema, SubscribeAudioChunksResultSchema, SubscribeFramesInputSchema, SubscribeFramesResultSchema, selectAssignedProfileSlots, } from './schemas/streaming-shared.js';
 export { buildEventKindDescriptor, EVENT_KIND_BY_CAP, EVENTFUL_CAP_NAMES, type SensorEventKindDescriptor, } from './sensor-event-kinds.js';
 export { type ImageContract, ImageContractSchema, type ImageContractState, ImageContractStateSchema, type IServerManagementProvider, type ServerBootMode, ServerBootModeSchema, type ServerPackageStatus, ServerPackageStatusSchema, type ServerRollbackInfo, ServerRollbackInfoSchema, type ServerUpdateActionResult, ServerUpdateActionResultSchema, type ServerUpdateCheckResult, ServerUpdateCheckResultSchema, type ServerUpdateState, ServerUpdateStateSchema, serverManagementCapability, } from './server-management.cap.js';
-export { type CollectionColumn, CollectionColumnSchema, type CollectionIndex, CollectionIndexSchema, type ISettingsStoreProvider, type MutationFilter, MutationFilterSchema, QueryFilterSchema, SettingsRecordSchema, type SettingsStoreClient, settingsStoreCapability, } from './settings-store.cap.js';
+export { type BulkRecord, BulkRecordSchema, type CollectionColumn, CollectionColumnSchema, type CollectionIndex, CollectionIndexSchema, type ISettingsStoreProvider, type MutationFilter, MutationFilterSchema, QueryFilterSchema, SettingsRecordSchema, type SettingsStoreClient, settingsStoreCapability, } from './settings-store.cap.js';
 export type { ISmtpProvider } from './smtp-provider.cap.js';
 export { SendEmailInputSchema, SendEmailResultSchema, SmtpStatusSchema, smtpProviderCapability, } from './smtp-provider.cap.js';
 export { type ISnapshotOrchestrator, SnapshotImageSchema, snapshotCapability, } from './snapshot.cap.js';
@@ -191,7 +193,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 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 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';
@@ -280,6 +282,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 { loadContributionCapability } from './load-contribution.cap.js';
 import type { logDestinationCapability } from './log-destination.cap.js';
 import type { loginMethodCapability } from './login-method.cap.js';
 import type { mediaPlayerCapability } from './media-player.cap.js';
@@ -356,6 +359,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 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 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/load-contribution.cap.d.ts

@@ -0,0 +1,146 @@
+/**
+ * `load-contribution` — the capability an addon reports its OWN cost through,
+ * already attributed. It stores nothing.
+ *
+ * ## Why this exists, and why it is not a pid→camera map
+ *
+ * Four of the five load families in
+ * `packages/addon-admin-ui/src/components/cluster/load/camera-load-attribution.ts`
+ * are per-camera by construction — one forked decode worker per decode
+ * session, one ffmpeg per (camera, encode plan), one ffmpeg per (camera,
+ * recording profile), one ffmpeg ingest per camera source — and none could be
+ * READ per camera. The obvious repair is to surface each child's pid so an
+ * observer can join it against the OS process table. That repair is wrong
+ * here, for a reason worth writing down:
+ *
+ *  - the join needs an entity with GLOBAL knowledge (which pid belongs to
+ *    which camera, for every addon), and every such entity is a list that a
+ *    new addon has to be added to — the failure mode of a central list is that
+ *    nothing breaks, the operator simply never sees what somebody added;
+ *  - the pair has to be shipped somewhere it can outlive the process it
+ *    describes, and pids are recycled. A stale entry charges one camera for
+ *    another camera's work, silently and plausibly. This repo has already paid
+ *    for a registry that answered while the truth was elsewhere (D49).
+ *
+ * The recorder does not need to be told which camera its ffmpeg serves. It
+ * spawned it. So each addon reports what it already knows, and no entity needs
+ * global knowledge. The shape is copied from `log-channels.cap.ts` /
+ * `log-destination.cap.ts` (`mode: 'collection'`, `internal: true`,
+ * `mount: { kind: 'skip' }`): no tRPC route, no generated hooks, while
+ * `addons.listCapabilityProviders` still enumerates it and the hub's
+ * `CapabilityRegistry` still holds an RPC proxy per provider, so a forked
+ * runner's entries reach hub-main over transport that already exists. No new
+ * UDS message, no second registry (D3).
+ *
+ * ## The external observer still has a job
+ *
+ * `metrics.node-processes-snapshot` measures every camstack-shaped process on
+ * the node whether or not anybody claims it. Contributions cover what the
+ * addons know about; the snapshot covers what is actually running. **The
+ * difference is the finding** — a process nobody claims is either a leak or a
+ * cost family nobody has taught to report, and both are worth seeing. So an
+ * unclaimed process stays in an "unattributed" bucket and is never folded into
+ * a neighbour.
+ *
+ * ## Absent, never zero
+ *
+ * Every measurement here is optional. An addon that cannot produce a number
+ * omits it, and the consumer reads UNKNOWN. A zero would say "this camera cost
+ * nothing", which is a measurement, and a measurement nobody made is the one
+ * thing this whole surface exists to prevent.
+ *
+ * ## Detection declares its own renunciation
+ *
+ * The shared inference pool is one process per (node, runtime, hardware
+ * device) serving every camera. It contributes an entry with `deviceId: null`
+ * and `attribution: 'unattributable'` — the giving-up is DATA, reported by the
+ * only component that knows it, rather than a deduction an observer makes.
+ * `isChartablePerCamera` keeps refusing it.
+ */
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+/**
+ * The load families an addon can report. Kept as a tuple so the Zod enum and
+ * the TypeScript union have one source.
+ *
+ * `detection` is a member on purpose — see the module docblock. It is the one
+ * role that reports itself as unattributable.
+ */
+export declare const LOAD_CONTRIBUTION_ROLES: readonly ["decode", "transcode", "recording", "streaming", "detection"];
+export type LoadContributionRole = (typeof LOAD_CONTRIBUTION_ROLES)[number];
+/**
+ * How well the reporting addon can tie this entry to ONE camera. The
+ * contributor decides, because the contributor is the only one who knows.
+ *
+ * - `measured` — the numbers on this entry are this camera's, measured. The
+ *   entry owns a process (or an equivalent exclusive resource) that serves
+ *   exactly one camera.
+ * - `accounted` — per-camera work really is COUNTED (frames submitted,
+ *   inference milliseconds), but the cost is shared and can only ever be
+ *   apportioned. A consumer must label it as a share, never as a cost.
+ * - `unattributable` — no camera owns this. Reported anyway, with
+ *   `deviceId: null`, so the shared cost is visible as shared instead of
+ *   invisible.
+ */
+export declare const LOAD_CONTRIBUTION_ATTRIBUTIONS: readonly ["measured", "accounted", "unattributable"];
+export type LoadContributionAttribution = (typeof LOAD_CONTRIBUTION_ATTRIBUTIONS)[number];
+declare const LoadContributionSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        streaming: "streaming";
+        decode: "decode";
+        recording: "recording";
+        transcode: "transcode";
+        detection: "detection";
+    }>;
+    deviceId: z.ZodNullable<z.ZodNumber>;
+    attribution: z.ZodEnum<{
+        measured: "measured";
+        accounted: "accounted";
+        unattributable: "unattributable";
+    }>;
+    unit: z.ZodString;
+    pid: z.ZodOptional<z.ZodNumber>;
+    startedAtMs: z.ZodOptional<z.ZodNumber>;
+    cpuSeconds: z.ZodOptional<z.ZodNumber>;
+    rssBytes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type LoadContribution = z.infer<typeof LoadContributionSchema>;
+export declare const loadContributionCapability: {
+    readonly name: "load-contribution";
+    readonly scope: "system";
+    readonly mode: "collection";
+    readonly internal: true;
+    readonly methods: {
+        /**
+         * This addon's own cost entries, computed live from state it already
+         * holds. Inert: no persistence, no sampling, no timer. It is answered on
+         * whatever beat the caller already has.
+         */
+        readonly list: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<{
+                streaming: "streaming";
+                decode: "decode";
+                recording: "recording";
+                transcode: "transcode";
+                detection: "detection";
+            }>;
+            deviceId: z.ZodNullable<z.ZodNumber>;
+            attribution: z.ZodEnum<{
+                measured: "measured";
+                accounted: "accounted";
+                unattributable: "unattributable";
+            }>;
+            unit: z.ZodString;
+            pid: z.ZodOptional<z.ZodNumber>;
+            startedAtMs: z.ZodOptional<z.ZodNumber>;
+            cpuSeconds: z.ZodOptional<z.ZodNumber>;
+            rssBytes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+    };
+    /** In-process only — enumerated through `addons.listCapabilityProviders`. */
+    readonly mount: {
+        readonly kind: "skip";
+    };
+};
+export type ILoadContributionProvider = InferProvider<typeof loadContributionCapability>;
+export { LoadContributionSchema };

package/dist/capabilities/metrics-provider.cap.d.ts

@@ -185,27 +185,16 @@ declare const NodeProcessSchema: z.ZodObject<{
         system: "system";
         root: "root";
         managed: "managed";
-        ghost: "ghost";
     }>;
     addonId: z.ZodNullable<z.ZodString>;
     nodeId: z.ZodNullable<z.ZodString>;
     command: z.ZodString;
     cpuPercent: z.ZodNumber;
     memoryRssBytes: z.ZodNumber;
+    cpuMainPercent: z.ZodNullable<z.ZodNumber>;
+    cpuGcPercent: z.ZodNullable<z.ZodNumber>;
+    threadCount: z.ZodNullable<z.ZodNumber>;
     uptimeSec: z.ZodNumber;
-    orphaned: z.ZodBoolean;
-}, z.core.$strip>;
-declare const KillProcessInputSchema: z.ZodObject<{
-    pid: z.ZodNumber;
-    force: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-declare const KillProcessResultSchema: z.ZodObject<{
-    success: z.ZodBoolean;
-    reason: z.ZodOptional<z.ZodString>;
-    signal: z.ZodOptional<z.ZodEnum<{
-        SIGTERM: "SIGTERM";
-        SIGKILL: "SIGKILL";
-    }>>;
 }, z.core.$strip>;
 declare const DumpHeapSnapshotInputSchema: z.ZodObject<{
     addonId: z.ZodString;
@@ -216,6 +205,92 @@ declare const DumpHeapSnapshotResultSchema: z.ZodObject<{
     pid: z.ZodOptional<z.ZodNumber>;
     reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * One point of one function's series.
+ *
+ * The unsuffixed fields are the bucket's **MAXIMUM**, and that choice is the
+ * point of the whole surface. The two obvious reductions both lie: a mean per
+ * bucket smears a spike away, and taking every Nth sample skips it outright.
+ * Either would give us a tool built to find peaks that does not show peaks.
+ * `...Min` carries the other end, `samples` says how many raw snapshots folded
+ * into the bucket, and a mean stays derivable where it is wanted.
+ *
+ * An UNREDUCED point is a one-sample bucket: `samples === 1` and each `...Min`
+ * equals its unsuffixed twin. Reduced and unreduced are the same shape, so a
+ * caller cannot tell which it received — which is what "one reader" means.
+ */
+declare const LoadPointSchema: z.ZodObject<{
+    atMs: z.ZodNumber;
+    samples: z.ZodNumber;
+    cpuMainPercent: z.ZodNullable<z.ZodNumber>;
+    cpuMainPercentMin: z.ZodNullable<z.ZodNumber>;
+    cpuGcPercent: z.ZodNullable<z.ZodNumber>;
+    cpuGcPercentMin: z.ZodNullable<z.ZodNumber>;
+    cpuLifetimePercent: z.ZodNumber;
+    cpuLifetimePercentMin: z.ZodNumber;
+    memoryRssBytes: z.ZodNumber;
+    memoryRssBytesMin: z.ZodNumber;
+    processCount: z.ZodNumber;
+    processCountMin: z.ZodNumber;
+}, z.core.$strip>;
+/** One function's series. `key` is an addonId, `__root__` or `__unattributed__`. */
+declare const LoadFunctionSeriesSchema: z.ZodObject<{
+    key: z.ZodString;
+    kind: z.ZodEnum<{
+        addon: "addon";
+        root: "root";
+        unattributed: "unattributed";
+    }>;
+    points: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        atMs: z.ZodNumber;
+        samples: z.ZodNumber;
+        cpuMainPercent: z.ZodNullable<z.ZodNumber>;
+        cpuMainPercentMin: z.ZodNullable<z.ZodNumber>;
+        cpuGcPercent: z.ZodNullable<z.ZodNumber>;
+        cpuGcPercentMin: z.ZodNullable<z.ZodNumber>;
+        cpuLifetimePercent: z.ZodNumber;
+        cpuLifetimePercentMin: z.ZodNumber;
+        memoryRssBytes: z.ZodNumber;
+        memoryRssBytesMin: z.ZodNumber;
+        processCount: z.ZodNumber;
+        processCountMin: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const NodeLoadSeriesSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    series: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        kind: z.ZodEnum<{
+            addon: "addon";
+            root: "root";
+            unattributed: "unattributed";
+        }>;
+        points: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            atMs: z.ZodNumber;
+            samples: z.ZodNumber;
+            cpuMainPercent: z.ZodNullable<z.ZodNumber>;
+            cpuMainPercentMin: z.ZodNullable<z.ZodNumber>;
+            cpuGcPercent: z.ZodNullable<z.ZodNumber>;
+            cpuGcPercentMin: z.ZodNullable<z.ZodNumber>;
+            cpuLifetimePercent: z.ZodNumber;
+            cpuLifetimePercentMin: z.ZodNumber;
+            memoryRssBytes: z.ZodNumber;
+            memoryRssBytesMin: z.ZodNumber;
+            processCount: z.ZodNumber;
+            processCountMin: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    bucketMs: z.ZodNumber;
+    retainedSamples: z.ZodNumber;
+    oldestAtMs: z.ZodNullable<z.ZodNumber>;
+    cadenceMs: z.ZodNumber;
+    durable: z.ZodBoolean;
+}, z.core.$strip>;
+declare const GetLoadSeriesInputSchema: z.ZodObject<{
+    forNodeId: z.ZodString;
+    sinceMs: z.ZodOptional<z.ZodNumber>;
+    maxPoints: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
 declare const SystemMetricsSchema: z.ZodObject<{
     cpuPercent: z.ZodNumber;
     memoryPercent: z.ZodNumber;
@@ -490,10 +565,17 @@ export declare const metricsProviderCapability: {
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * Snapshot of every camstack-related process on this node with a
-         * ghost/managed/root classification. Powers the Cluster → Agent →
-         * Processes tab: cross-references `$process.list` against a `ps` scan
-         * so orphaned trees (PPID=1) or unknown children show up as `ghost`
-         * and can be killed from the UI.
+         * root/managed/system classification. Powers the Cluster → Agent →
+         * Processes tab: cross-references `$process.list` against a `ps` scan so
+         * per-addon CPU and RSS can be attributed, and so a process the cluster
+         * does not manage is still visible.
+         *
+         * **Read-only, by design.** This cap once carried a `killProcess`
+         * mutation; it was deleted on 2026-08-27. A runner's lifecycle belongs to
+         * `CrashSupervisor` and is driven through `addons.restartAddon` /
+         * `$process.restart` — signalling a raw pid went around the supervisor
+         * (D6), and the one class it was willing to signal turned out to be the
+         * container's own init and the operator's desktop app.
          */
         readonly listNodeProcesses: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             pid: z.ZodNumber;
@@ -503,39 +585,75 @@ export declare const metricsProviderCapability: {
                 system: "system";
                 root: "root";
                 managed: "managed";
-                ghost: "ghost";
             }>;
             addonId: z.ZodNullable<z.ZodString>;
             nodeId: z.ZodNullable<z.ZodString>;
             command: z.ZodString;
             cpuPercent: z.ZodNumber;
             memoryRssBytes: z.ZodNumber;
+            cpuMainPercent: z.ZodNullable<z.ZodNumber>;
+            cpuGcPercent: z.ZodNullable<z.ZodNumber>;
+            threadCount: z.ZodNullable<z.ZodNumber>;
             uptimeSec: z.ZodNumber;
-            orphaned: z.ZodBoolean;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
-         * Send SIGTERM (or SIGKILL when `force`) to a pid inside this node's
-         * process tree. The provider refuses pids that aren't in the live
-         * `listNodeProcesses()` snapshot — callers can't use this endpoint
-         * to kill arbitrary system processes.
+         * The retained per-node load series — the ONE reader over BOTH tiers.
+         *
+         * The in-memory ring is the HOT window (the last 180 snapshots, held by
+         * every node's `native-metrics`); the hub's `metrics:node-load-samples`
+         * table is the COLD one (the operator's retention, six hours by default).
+         * This method merges them and DEDUPES on `atMs`, so a snapshot present in
+         * both contributes once and the caller never learns which tier a point
+         * came from. There is deliberately no second read surface: two readers is
+         * how two charts start disagreeing about the same node.
+         *
+         * Reads only; nothing is sampled to answer it. Normally called UNPINNED —
+         * the hub hears every node's snapshot and holds every node's rows — and
+         * answers for any `forNodeId`. Pinned to an agent it answers from that
+         * agent's ring alone (`durable: false`). Empty is a legitimate answer: a
+         * node nobody has heard from has no series, and saying so is the truth.
          */
-        readonly killProcess: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
-            pid: z.ZodNumber;
-            force: z.ZodOptional<z.ZodBoolean>;
+        readonly getLoadSeries: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            forNodeId: z.ZodString;
+            sinceMs: z.ZodOptional<z.ZodNumber>;
+            maxPoints: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>, z.ZodObject<{
-            success: z.ZodBoolean;
-            reason: z.ZodOptional<z.ZodString>;
-            signal: z.ZodOptional<z.ZodEnum<{
-                SIGTERM: "SIGTERM";
-                SIGKILL: "SIGKILL";
-            }>>;
-        }, z.core.$strip>, "mutation">;
+            nodeId: z.ZodString;
+            series: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                kind: z.ZodEnum<{
+                    addon: "addon";
+                    root: "root";
+                    unattributed: "unattributed";
+                }>;
+                points: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    atMs: z.ZodNumber;
+                    samples: z.ZodNumber;
+                    cpuMainPercent: z.ZodNullable<z.ZodNumber>;
+                    cpuMainPercentMin: z.ZodNullable<z.ZodNumber>;
+                    cpuGcPercent: z.ZodNullable<z.ZodNumber>;
+                    cpuGcPercentMin: z.ZodNullable<z.ZodNumber>;
+                    cpuLifetimePercent: z.ZodNumber;
+                    cpuLifetimePercentMin: z.ZodNumber;
+                    memoryRssBytes: z.ZodNumber;
+                    memoryRssBytesMin: z.ZodNumber;
+                    processCount: z.ZodNumber;
+                    processCountMin: z.ZodNumber;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>>;
+            bucketMs: z.ZodNumber;
+            retainedSamples: z.ZodNumber;
+            oldestAtMs: z.ZodNullable<z.ZodNumber>;
+            cadenceMs: z.ZodNumber;
+            durable: z.ZodBoolean;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * Tell the addon's forked runner to write a V8 heap snapshot to disk (via
          * SIGUSR2 — the runner's diagnostic handler). Also logs its
-         * `process.memoryUsage()` + heap-space breakdown. Refuses pids not in the
-         * live `listNodeProcesses()` snapshot. Use for deep per-addon memory
-         * attribution; copy the returned path off the node to analyze.
+         * `process.memoryUsage()` + heap-space breakdown. Resolves the pid from
+         * `$process.list`, so it can only reach a runner this node spawned. Use
+         * for deep per-addon memory attribution; copy the returned path off the
+         * node to analyze.
          */
         readonly dumpHeapSnapshot: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             addonId: z.ZodString;
@@ -548,4 +666,4 @@ export declare const metricsProviderCapability: {
     };
 };
 export type IMetricsProvider = InferProvider<typeof metricsProviderCapability>;
-export { SystemMetricsSchema, SystemResourceSnapshotSchema, DiskSpaceInfoSchema, MetricsGpuInfoSchema, PidResourceStatsSchema, AddonInstanceSchema, NodeProcessSchema, KillProcessInputSchema, KillProcessResultSchema, DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, CpuBreakdownSchema, MemoryInfoSchema, DiskIoSnapshotSchema, NetworkIoSnapshotSchema, ProcessResourceInfoSchema, PressureInfoSchema, };
+export { SystemMetricsSchema, SystemResourceSnapshotSchema, DiskSpaceInfoSchema, MetricsGpuInfoSchema, PidResourceStatsSchema, AddonInstanceSchema, NodeProcessSchema, DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, LoadPointSchema, LoadFunctionSeriesSchema, NodeLoadSeriesSchema, GetLoadSeriesInputSchema, CpuBreakdownSchema, MemoryInfoSchema, DiskIoSnapshotSchema, NetworkIoSnapshotSchema, ProcessResourceInfoSchema, PressureInfoSchema, };

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

@@ -65,6 +65,19 @@ declare const SettingsRecordSchema: z.ZodObject<{
     id: z.ZodString;
     data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, z.core.$strip>;
+/**
+ * One record of a BULK insert — {@link SettingsRecordSchema} with the id made
+ * optional.
+ *
+ * A separate schema rather than loosening the shared one: every other method
+ * on this cap addresses a row BY its id, and making that field optional
+ * everywhere would turn a forgotten key into a silently generated one on
+ * `update` and `delete` as well.
+ */
+declare const BulkRecordSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
 /**
  * Column declaration for a structured (SQL-backed) collection.
  *
@@ -188,6 +201,39 @@ export declare const settingsStoreCapability: {
                 data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /**
+         * Insert MANY records in ONE transaction, returning how many landed.
+         *
+         * The write-side twin of {@link deleteWhere}, and it exists for the same
+         * reason: without it, appending a batch is N round trips and N COMMITs on
+         * the single shared connection that also serves every cluster-wide
+         * configuration read. The durable load series writes one process row per
+         * process per sample — 76 rows every 10 s on the live fleet — and the
+         * operator's rule for it is *one transaction per sample, never one per
+         * row*. `insert` cannot express that; nothing else could.
+         *
+         * **All or nothing.** A batch that fails on its fifth row leaves none of
+         * the five behind. A half-written sample is worse than a missing one: the
+         * missing one reads as "nobody reported", which is true, while the half
+         * one reads as "these were the only processes running", which is not.
+         *
+         * `id` is OPTIONAL per record, and that is the difference from
+         * {@link insert}. A collection whose primary key is an `INTEGER` rowid
+         * alias has no id to supply — SQLite assigns it, for free, and inventing a
+         * `randomUUID()` for such a column would write a 36-character string into
+         * an integer key. Omitted on a TEXT key, a uuid is generated exactly as
+         * `insert` does.
+         */
+        readonly insertMany: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            records: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            inserted: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
         /** Update an existing record by ID. */
         readonly update: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             namespace: z.ZodOptional<z.ZodString>;
@@ -394,7 +440,8 @@ export type ISettingsStoreProvider = InferProvider<typeof settingsStoreCapabilit
  * Methods are accessed as `client.get.query(input)`, `client.set.mutate(input)`, etc.
  */
 export type SettingsStoreClient = import('../generated/addon-api.js').AddonApi['settingsStore'];
-export { AggregateFieldSchema, AggregateResultSchema, CollectionColumnSchema, CollectionIndexSchema, MutationFilterSchema, QueryFilterSchema, SettingsRecordSchema, };
+export { AggregateFieldSchema, AggregateResultSchema, BulkRecordSchema, CollectionColumnSchema, CollectionIndexSchema, MutationFilterSchema, QueryFilterSchema, SettingsRecordSchema, };
+export type BulkRecord = z.infer<typeof BulkRecordSchema>;
 export type AggregateField = z.infer<typeof AggregateFieldSchema>;
 export type AggregateResult = z.infer<typeof AggregateResultSchema>;
 export type MutationFilter = z.infer<typeof MutationFilterSchema>;