@camstack/system 1.2.447 → 1.2.449

package/assets/device-history/icon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#2F7D8C" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M3 3v18h18" />
+  <path d="M7 15l4-5 3 3 5-7" />
+</svg>

package/dist/{agent-https-5DYAOJMO.js → agent-https-CMz4S56_.js}

@@ -1,7 +1,7 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-BkNfEJKa.js");
+const require_dist = require("./dist-Ct88catN.js");
 const require_x509_es = require("./x509.es-C4cOo48M.js");
-const require_constants = require("./constants-DA_tjzIk.js");
+const require_constants = require("./constants-BPWA-r-Y.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
 let _camstack_types_node = require("@camstack/types/node");

package/dist/{agent-https-BWUEf6ev.mjs → agent-https-D6lRxHma.mjs}

@@ -1,6 +1,6 @@
-import { Di as defineRecordKinds } from "./dist-CkZIrsAP.mjs";
+import { Mi as defineRecordKinds } from "./dist-DV2ll9Hi.mjs";
 import { S as backdatedNotBefore, _ as NameConstraints, a as KeyUsageFlags, c as Pkcs10CertificateRequest, d as SubjectKeyIdentifierExtension, f as X509Certificate$1, g as GeneralSubtrees, h as GeneralSubtree, i as Extension, l as Pkcs10CertificateRequestGenerator, m as cryptoProvider, n as BasicConstraintsExtension, o as KeyUsagesExtension, p as X509CertificateGenerator, r as ExtendedKeyUsageExtension, s as PemConverter, t as AuthorityKeyIdentifierExtension, u as SubjectAlternativeNameExtension, v as GeneralName, x as AsnConvert } from "./x509.es-DK__ETIe.mjs";
-import { c as SERVER_AUTH_OID$1, r as MESH_CA_COMMON_NAME, s as MESH_CA_VALIDITY_DAYS, t as CLIENT_AUTH_OID } from "./constants-6XHGmEUF.mjs";
+import { c as SERVER_AUTH_OID$1, r as MESH_CA_COMMON_NAME, s as MESH_CA_VALIDITY_DAYS, t as CLIENT_AUTH_OID } from "./constants-gzGZbnwO.mjs";
 import { z } from "zod";
 import { X509Certificate, createHash, createPrivateKey, randomBytes, webcrypto } from "node:crypto";
 import { writeOwnerOnlyFileSync } from "@camstack/types/node";

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BkNfEJKa.js");
+const require_dist = require("../../dist-Ct88catN.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { Lr as errMsg, Rr as BaseAddon, la as EventCategory, lt as addonPagesCapability } from "../../dist-CkZIrsAP.mjs";
+import { Hr as BaseAddon, Vr as errMsg, ma as EventCategory, ut as addonPagesCapability } from "../../dist-DV2ll9Hi.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BkNfEJKa.js");
+const require_dist = require("../../dist-Ct88catN.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { Lr as errMsg, Rr as BaseAddon, dt as addonWidgetsCapability, la as EventCategory } from "../../dist-CkZIrsAP.mjs";
+import { Hr as BaseAddon, Vr as errMsg, ft as addonWidgetsCapability, ma as EventCategory } from "../../dist-DV2ll9Hi.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";

package/dist/builtins/alerts/alerts.addon.js

@@ -3,9 +3,9 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BkNfEJKa.js");
+const require_dist = require("../../dist-Ct88catN.js");
 const require_read_all_rows$1 = require("../../read-all-rows-CVoO1ONM.js");
-const require_phase6_declare_gate = require("../../phase6-declare-gate-Bl7KocEs.js");
+const require_phase6_declare_gate = require("../../phase6-declare-gate-C6WqagkC.js");
 //#region src/builtins/alerts/critical-push.ts
 /** Alert categories that are critical system findings. */
 var CRITICAL_CATEGORIES = new Set([

package/dist/builtins/alerts/alerts.addon.mjs

@@ -1,6 +1,6 @@
-import { Ci as createEvent, Di as defineRecordKinds, Lr as errMsg, Rr as BaseAddon, ft as alertsCapability, i as AlertSchema, la as EventCategory } from "../../dist-CkZIrsAP.mjs";
+import { Hr as BaseAddon, Mi as defineRecordKinds, Oi as createEvent, Vr as errMsg, i as AlertSchema, ma as EventCategory, pt as alertsCapability } from "../../dist-DV2ll9Hi.mjs";
 import { t as require_read_all_rows } from "../../read-all-rows-TaPqdWNF.mjs";
-import { t as resolvePhase6UseRecordsPathForHub } from "../../phase6-declare-gate-BDWZuB2n.mjs";
+import { t as resolvePhase6UseRecordsPathForHub } from "../../phase6-declare-gate-BJplW6tX.mjs";
 //#region src/builtins/alerts/critical-push.ts
 /** Alert categories that are critical system findings. */
 var CRITICAL_CATEGORIES = new Set([

package/dist/builtins/autotrack/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BkNfEJKa.js");
+const require_dist = require("../../dist-Ct88catN.js");
 //#region src/builtins/autotrack/autotrack-config.ts
 var DEFAULT_AUTOTRACK_LOOP_CONFIG = {
 	deadZoneFraction: .5,

package/dist/builtins/autotrack/index.mjs

@@ -1,4 +1,4 @@
-import { Lr as errMsg, P as FIRST_LEVEL_MACRO_CLASSES, Pi as isEvent, Rr as BaseAddon, ht as bareAddonId, la as EventCategory, zn as ptzAutotrackCapability } from "../../dist-CkZIrsAP.mjs";
+import { Hr as BaseAddon, P as FIRST_LEVEL_MACRO_CLASSES, Un as ptzAutotrackCapability, Vr as errMsg, _t as bareAddonId, ma as EventCategory, zi as isEvent } from "../../dist-DV2ll9Hi.mjs";
 //#region src/builtins/autotrack/autotrack-config.ts
 var DEFAULT_AUTOTRACK_LOOP_CONFIG = {
 	deadZoneFraction: .5,

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.js

@@ -3,9 +3,9 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BkNfEJKa.js");
+const require_dist = require("../../dist-Ct88catN.js");
 const require_read_all_rows$1 = require("../../read-all-rows-CVoO1ONM.js");
-const require_restore_archive = require("../../restore-archive-B57xI5Ue.js");
+const require_restore_archive = require("../../restore-archive-Cprdh3P9.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = require_chunk.__toESM(node_fs_promises);

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.mjs

@@ -1,6 +1,6 @@
-import { Hi as nodePin, Rr as BaseAddon, Tn as mayWriteToLocation, ia as toNodeId, la as EventCategory, mt as backupCapability, ur as storageOccupancyCapability } from "../../dist-CkZIrsAP.mjs";
+import { Hr as BaseAddon, gt as backupCapability, kn as mayWriteToLocation, la as toNodeId, ma as EventCategory, mr as storageOccupancyCapability, qi as nodePin } from "../../dist-DV2ll9Hi.mjs";
 import { t as require_read_all_rows } from "../../read-all-rows-TaPqdWNF.mjs";
-import { _ as parseBackupSecretKey, a as BackupSnapshotRefusedError, c as backupOrchestratorRecordKinds, d as BackupEncryptionKeyStore, g as generateBackupKeyPair, h as ENCRYPTED_BACKUP_SUFFIX, i as BackupCancelledError, l as backupRecordStoresOf, n as precheckRestoreKey, o as DEFAULT_BACKUP_DATABASES, p as BackupKeyFormatError, r as prepareRestoreArchive, s as SystemBackupService, u as BackupSeedMarkerStore } from "../../restore-archive-CMr4V7Fi.mjs";
+import { _ as parseBackupSecretKey, a as BackupSnapshotRefusedError, c as backupOrchestratorRecordKinds, d as BackupEncryptionKeyStore, g as generateBackupKeyPair, h as ENCRYPTED_BACKUP_SUFFIX, i as BackupCancelledError, l as backupRecordStoresOf, n as precheckRestoreKey, o as DEFAULT_BACKUP_DATABASES, p as BackupKeyFormatError, r as prepareRestoreArchive, s as SystemBackupService, u as BackupSeedMarkerStore } from "../../restore-archive-Jiz63mVB.mjs";
 import { randomUUID } from "node:crypto";
 import * as fsp from "node:fs/promises";
 import * as path$1 from "node:path";

package/dist/builtins/calendars/calendars.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BkNfEJKa.js");
+const require_dist = require("../../dist-Ct88catN.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let zod = require("zod");
 //#region src/builtins/calendars/calendar-color.ts

package/dist/builtins/calendars/calendars.addon.mjs

@@ -1,4 +1,4 @@
-import { Di as defineRecordKinds, Rr as BaseAddon, g as CalendarPreferencesSchema, xt as calendarsCapability } from "../../dist-CkZIrsAP.mjs";
+import { Ct as calendarsCapability, Hr as BaseAddon, Mi as defineRecordKinds, g as CalendarPreferencesSchema } from "../../dist-DV2ll9Hi.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { z } from "zod";
 //#region src/builtins/calendars/calendar-color.ts

package/dist/builtins/camera-grid/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BkNfEJKa.js");
+const require_dist = require("../../dist-Ct88catN.js");
 let zod = require("zod");
 let _camstack_types_node = require("@camstack/types/node");
 let node_path = require("node:path");

package/dist/builtins/camera-grid/index.mjs

@@ -1,4 +1,4 @@
-import { Ci as createEvent, Cr as buildFfmpegArgs, En as memoizePinnedFfmpeg, Ir as DeviceType, It as declarationOwnerNodeId, K as MOTION_CLOSE_AFTER_MS, Lr as errMsg, Mi as hydrateSchema, Pr as DeviceFeature, Rr as BaseAddon, St as cameraGridLayoutCapability, ar as snapshotCapability, fr as streamCatalogCapability, j as DeclaredDevices, kn as motionCapability, la as EventCategory, o as BaseDevice, w as DERIVED_CAMERA_SILENCED_CAP_NAMES } from "../../dist-CkZIrsAP.mjs";
+import { An as memoizePinnedFfmpeg, Br as DeviceType, Dr as buildFfmpegArgs, Hr as BaseAddon, Li as hydrateSchema, Nn as motionCapability, Oi as createEvent, Rr as DeviceFeature, Rt as declarationOwnerNodeId, Vr as errMsg, gr as streamCatalogCapability, j as DeclaredDevices, lr as snapshotCapability, ma as EventCategory, o as BaseDevice, q as MOTION_CLOSE_AFTER_MS, w as DERIVED_CAMERA_SILENCED_CAP_NAMES, wt as cameraGridLayoutCapability } from "../../dist-DV2ll9Hi.mjs";
 import { z } from "zod";
 import { FfmpegProcess } from "@camstack/types/node";
 import { join } from "node:path";

package/dist/builtins/composer/composer.addon.js

@@ -3,8 +3,8 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BkNfEJKa.js");
-const require_composition_sources = require("../../composition-sources-BwIIltnZ.js");
+const require_dist = require("../../dist-Ct88catN.js");
+const require_composition_sources = require("../../composition-sources-BQmhc3se.js");
 let zod = require("zod");
 //#region src/builtins/shared/device-state-changed.ts
 /** Structural narrowing helper for untrusted bus payloads. */

package/dist/builtins/composer/composer.addon.mjs

@@ -1,5 +1,5 @@
-import { Ar as compositionSourceKey, Ci as createEvent, Dr as compositionFeatureEnabled, Er as composedDeviceStableId, Et as compositionFieldKey, In as planComposition, Ir as DeviceType, Lr as errMsg, Mr as disarmRoseMemory, Nr as toExpressionValue, Or as compositionItemFieldPath, Qt as expressionContainsBuiltinCall, Rr as BaseAddon, Sr as COMPOSER_ADDON_ID, Tr as composedDeviceRef, Tt as composerCapability, Yt as evaluateCompositionField, _t as buildCapabilityLookup, f as COMPOSED_ITEM_FIXED_FIELDS, j as DeclaredDevices, jr as createStatefulExpressionMemory, kr as compositionSliceKey, la as EventCategory, o as BaseDevice, r as ALL_CAPABILITY_DEFINITIONS, wr as cloneStatefulExpressionMemory } from "../../dist-CkZIrsAP.mjs";
-import { n as normalizedNativeOwner } from "../../composition-sources-BmC5jAUv.mjs";
+import { $t as evaluateCompositionField, Ar as composedDeviceStableId, Bn as planComposition, Br as DeviceType, Dt as composerCapability, Er as COMPOSER_ADDON_ID, Fr as createStatefulExpressionMemory, Hr as BaseAddon, Ir as disarmRoseMemory, Lr as toExpressionValue, Mr as compositionItemFieldPath, Nr as compositionSliceKey, Oi as createEvent, Or as cloneStatefulExpressionMemory, Ot as compositionFieldKey, Pr as compositionSourceKey, Vr as errMsg, f as COMPOSED_ITEM_FIXED_FIELDS, j as DeclaredDevices, jr as compositionFeatureEnabled, kr as composedDeviceRef, ma as EventCategory, nn as expressionContainsBuiltinCall, o as BaseDevice, r as ALL_CAPABILITY_DEFINITIONS, yt as buildCapabilityLookup } from "../../dist-DV2ll9Hi.mjs";
+import { n as normalizedNativeOwner } from "../../composition-sources-DzuruDVY.mjs";
 import { z } from "zod";
 //#region src/builtins/shared/device-state-changed.ts
 /** Structural narrowing helper for untrusted bus payloads. */

package/dist/builtins/console-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BkNfEJKa.js");
+const require_dist = require("../../dist-Ct88catN.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/console-logging/index.mjs

@@ -1,4 +1,4 @@
-import { Rr as BaseAddon, xn as logDestinationCapability } from "../../dist-CkZIrsAP.mjs";
+import { Hr as BaseAddon, Tn as logDestinationCapability } from "../../dist-DV2ll9Hi.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/core-blocks/core-blocks.addon.js

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BkNfEJKa.js");
+const require_dist = require("../../dist-Ct88catN.js");
 const require_read_all_rows$1 = require("../../read-all-rows-CVoO1ONM.js");
-const require_composition_sources = require("../../composition-sources-BwIIltnZ.js");
+const require_composition_sources = require("../../composition-sources-BQmhc3se.js");
 const require_prefix_range = require("../../prefix-range-D_KueXbQ.js");
 const require_prefix_walk = require("../../prefix-walk-Dv6MLZlM.js");
 let zod = require("zod");

package/dist/builtins/core-blocks/core-blocks.addon.mjs

@@ -1,6 +1,6 @@
-import { $i as resolveSecretMarkers, An as normalizeCoreBlockWrite, Ar as compositionSourceKey, At as coreBlockIdFromAddonId, Bt as describeComposableCaps, Di as defineRecordKinds, Dt as compositionSourceRefs, In as planComposition, Kn as resolveCoreBlockEntry, Li as isSecretMarker, Lr as errMsg, Mi as hydrateSchema, Mt as coreBlocksCapability, Ot as coreBlockAddonId, Rr as BaseAddon, Tr as composedDeviceRef, Un as replacedFieldKeys, _t as buildCapabilityLookup, gr as validateComposition, h as CORE_BLOCK_ADDON_PREFIX, j as DeclaredDevices, jt as coreBlockSourceKind, kt as coreBlockComposition, m as CORE_BLOCKS_ADDON_ID, na as secretTreeFromSchema, oa as transformSecretWrite, p as COMPOSER_RUNNER_ID, qn as resolveCoreBlockFiles, r as ALL_CAPABILITY_DEFINITIONS, v as CoreBlockSchema, xi as collectSecretMarkerRefs, zi as isSecretRefOwnedBy } from "../../dist-CkZIrsAP.mjs";
+import { At as coreBlockAddonId, Bn as planComposition, Ei as collectSecretMarkerRefs, Hi as isSecretMarker, Hr as BaseAddon, Ht as describeComposableCaps, Li as hydrateSchema, Mi as defineRecordKinds, Mt as coreBlockIdFromAddonId, Nt as coreBlockSourceKind, Pn as normalizeCoreBlockWrite, Pr as compositionSourceKey, Pt as coreBlocksCapability, Vr as errMsg, Wi as isSecretRefOwnedBy, Xn as resolveCoreBlockEntry, Zn as resolveCoreBlockFiles, br as validateComposition, da as transformSecretWrite, h as CORE_BLOCK_ADDON_PREFIX, ia as resolveSecretMarkers, j as DeclaredDevices, jt as coreBlockComposition, kr as composedDeviceRef, kt as compositionSourceRefs, m as CORE_BLOCKS_ADDON_ID, p as COMPOSER_RUNNER_ID, qn as replacedFieldKeys, r as ALL_CAPABILITY_DEFINITIONS, sa as secretTreeFromSchema, v as CoreBlockSchema, yt as buildCapabilityLookup } from "../../dist-DV2ll9Hi.mjs";
 import { t as require_read_all_rows } from "../../read-all-rows-TaPqdWNF.mjs";
-import { t as describeCompositionSources } from "../../composition-sources-BmC5jAUv.mjs";
+import { t as describeCompositionSources } from "../../composition-sources-DzuruDVY.mjs";
 import { t as prefixRange } from "../../prefix-range-Dl0znowN.mjs";
 import { n as unwrapStoredValue, t as loadPrefixed } from "../../prefix-walk-DAOBSyH1.mjs";
 import { createRequire } from "node:module";

package/dist/builtins/device-history/capture/capture-engine.d.ts

@@ -0,0 +1,87 @@
+/**
+* Capture of capability fields (D850, plan §5.3), driven by the GENERATED
+* history catalog — a field is recorded because its `*.cap.ts` says so, never
+* because someone listed it here.
+*
+* For a `DeviceStateChanged { deviceId, capName, slice }` the engine:
+*   1. ignores a cap with no catalog entry (the common case — cheap, uncounted);
+*   2. skips an opted-out device (counted), a device whose type is not yet
+*      known (parked, then replayed once the hub answers), and a `hub` /
+*      `container` (counted: not a real device);
+*   3. per field: skips an excluded device type, an absent or non-numeric value
+*      (null is UNKNOWN, never 0), then runs {@link decideCapture} against the
+*      last RECORDED value — change-only, deadband, capture floor;
+*   4. buffers the point for the batched write.
+*
+* A change inside the capture floor is kept PENDING and emitted when the floor
+* has passed ({@link CaptureEngine.tickPending}), so the end of a burst is never
+* lost. Reconcile ({@link CaptureEngine.reconcile}) restores what a dropped
+* event missed from the state mirror's snapshot.
+*/
+import { type CapabilityHistoryField, type DeviceHistorySubject, type IScopedLogger } from "@camstack/types";
+import type { HistoryCounters } from "../status/counters.js";
+import type { SeriesRegistry } from "../store/series-registry.js";
+import type { HistoryStore, MetricRecord } from "../store/history-store.js";
+import { type RecordedState } from "./capture-filter.js";
+import { type DeviceDirectory } from "./device-directory.js";
+import type { PointWriter } from "./point-writer.js";
+export type HistoryCatalog = Readonly<Record<string, Readonly<Record<string, CapabilityHistoryField>>>>;
+export declare const CAP_KEY_PREFIX = "cap:";
+export declare function capSeriesKey(capName: string, fieldPath: string): string;
+/** The metric rows of every catalog field (owner `device-history`). */
+export declare function catalogMetrics(catalog: HistoryCatalog, now: number): readonly MetricRecord[];
+export type SnapshotMap = Readonly<Record<string, Readonly<Record<string, Readonly<Record<string, unknown>>>>>>;
+export interface CaptureEngineDeps {
+	readonly catalog: HistoryCatalog;
+	readonly registry: SeriesRegistry;
+	readonly store: HistoryStore;
+	readonly directory: DeviceDirectory;
+	readonly writer: PointWriter;
+	readonly optedOut: () => ReadonlySet<number>;
+	readonly counters: HistoryCounters;
+	readonly logger: IScopedLogger;
+	readonly clock: () => number;
+}
+export declare class CaptureEngine {
+	private readonly deps;
+	private readonly recorded;
+	private readonly pending;
+	private readonly parked;
+	constructor(deps: CaptureEngineDeps);
+	/** Learn the last recorded value of every cap series from the store, so a restart repeats nothing. */
+	seed(): Promise<void>;
+	/** One `DeviceStateChanged`. Synchronous: the bus must never wait on us. */
+	handleState(deviceId: number, capName: string, slice: Readonly<Record<string, unknown>>, at: number): void;
+	private consider;
+	private emit;
+	/** Emit every pending change whose capture floor has passed, stamped where the floor ended. */
+	tickPending(now: number): void;
+	private park;
+	/**
+	* Restore a missed change from the state mirror's whole snapshot: a field whose
+	* value differs from the last recorded one gets a point stamped `now`.
+	* Additive only — it never removes anything, and a snapshot that could not be
+	* read is the CALLER's failure to count (D49), not an empty snapshot.
+	*/
+	reconcile(snapshots: SnapshotMap, now: number): void;
+	/**
+	* Forget what was "recorded" for points that never reached the store (dropped),
+	* so the next change-only comparison — and the next reconcile — starts from what
+	* is really there instead of leaving a hole until the value moves.
+	*/
+	forget(points: readonly {
+		key: string;
+		subject: DeviceHistorySubject;
+		scope: string;
+	}[]): void;
+	/** A purged series leaves no state behind. */
+	forgetSeries(series: {
+		key: string;
+		subject: string;
+		scope: string;
+	}): void;
+	/** For status and specs. */
+	pendingCount(): number;
+	/** The last recorded state of a series, for specs. */
+	lastRecorded(key: string, subjectId: string): RecordedState | undefined;
+}

package/dist/builtins/device-history/capture/capture-filter.d.ts

@@ -0,0 +1,37 @@
+/**
+* The per-point capture decision for a cap field (D850, plan §5.3). PURE.
+*
+* A point is written only when the value CHANGED from the last one recorded,
+* by more than the field's deadband, and no sooner than its capture floor:
+*
+*  - `unchanged`  — the same value again; a change-only series stores nothing;
+*  - `deadband`   — a change smaller than `deadband` (absolute) or
+*                   `deadbandPct` (relative to the last recorded value); a slow
+*                   drift is still caught, because the comparison is against
+*                   the last RECORDED value, not the last seen one;
+*  - `defer`      — changed, but inside `minIntervalMs` of the last recorded
+*                   point. NOT dropped: the caller keeps it pending and emits it
+*                   once the floor has passed, so a burst never loses its end.
+*/
+import { type CapabilityHistoryField } from "@camstack/types";
+export interface RecordedState {
+	readonly value: number;
+	readonly ts: number;
+}
+export type CaptureSkipReason = "unchanged" | "deadband" | "non-finite";
+export type CaptureDecision = {
+	readonly action: "emit";
+} | {
+	readonly action: "skip";
+	readonly reason: CaptureSkipReason;
+} | {
+	readonly action: "defer";
+	readonly notBefore: number;
+};
+/** The capture floor of a field: its own `minIntervalMs`, else the kind's default. */
+export declare function minIntervalOf(spec: CapabilityHistoryField): number;
+export interface DecideOptions {
+	/** Reconcile restores a missed value, so the floor does not apply to it. */
+	readonly ignoreFloor?: boolean;
+}
+export declare function decideCapture(spec: CapabilityHistoryField, recorded: RecordedState | null, value: number, now: number, options?: DecideOptions): CaptureDecision;

package/dist/builtins/device-history/capture/device-directory.d.ts

@@ -0,0 +1,47 @@
+/**
+* Which devices exist and what type they are — the "real devices only" gate
+* (`hub` and `container` are not devices anyone charts) and the
+* `excludeDeviceTypes` gate of a history field.
+*
+* Built from `deviceManager.listAll({ projection: 'slim' })` at boot and every
+* reconcile, and per device (`getDevice`) the first time a state event names one
+* the map does not know. A FAILED read changes nothing (D49): the previous map
+* stays, and the failure is counted and logged, never read as "no devices".
+*/
+import { DeviceType, type IScopedLogger } from "@camstack/types";
+import type { HistoryCounters } from "../status/counters.js";
+export interface DeviceTypeSource {
+	listAll(): Promise<readonly {
+		readonly id: number;
+		readonly type: DeviceType;
+	}[]>;
+	getDevice(deviceId: number): Promise<{
+		readonly id: number;
+		readonly type: DeviceType;
+	} | null>;
+}
+export declare function isRealDeviceType(type: DeviceType): boolean;
+export declare class DeviceDirectory {
+	private readonly source;
+	private readonly counters;
+	private readonly logger;
+	private readonly clock;
+	private types;
+	private readonly inflight;
+	private refreshInflight;
+	private lastFullRefreshAt;
+	constructor(source: DeviceTypeSource, counters: HistoryCounters, logger: IScopedLogger, clock: () => number);
+	typeOf(deviceId: number): DeviceType | undefined;
+	size(): number;
+	/** When the full listing last ANSWERED; `null` before the first answer. */
+	lastRefreshAt(): number | null;
+	/** Ids in the directory now (the last full listing plus per-device lookups). */
+	listedIds(): ReadonlySet<number>;
+	knows(deviceId: number): boolean;
+	/** Replace the map from the full listing. Returns false (map untouched) when the read failed. */
+	refresh(): Promise<boolean>;
+	private doRefresh;
+	/** The device's type, asking the hub once when the map does not know it. */
+	ensure(deviceId: number): Promise<DeviceType | undefined>;
+	private lookup;
+}

package/dist/builtins/device-history/capture/field-path.d.ts

@@ -0,0 +1,10 @@
+/** The value at `path`, or `undefined` when any step is missing or not an object. */
+export declare function readPath(slice: Readonly<Record<string, unknown>>, path: string): unknown;
+/**
+* The number a field contributes: a finite number for a gauge/counter, 0/1 for
+* a boolean field. Anything else (null, undefined, a string, NaN) is NOT a
+* reading — `null` means unknown and must never become 0.
+*/
+export declare function readNumeric(slice: Readonly<Record<string, unknown>>, path: string, kind: "gauge" | "counter" | "boolean"): number | null;
+/** A unit string a `unitFrom` sibling field states, or `null` when it states none. */
+export declare function readUnit(slice: Readonly<Record<string, unknown>>, unitFrom: string): string | null;

package/dist/builtins/device-history/capture/point-writer.d.ts

@@ -0,0 +1,63 @@
+/**
+* The write buffer for raw points — cap-field captures and producer `record`
+* calls alike (plan §5.3): points are buffered and written with ONE batched
+* `upsertMany` every flush (10 s), because the capture rate is bursty and the
+* history thread should see a handful of transactions, not hundreds.
+*
+* A failed write KEEPS the batch (it goes back to the front of the queue and is
+* retried at the next flush). Both bounds drop work OUT LOUD (D391):
+*  - a point older than {@link MAX_BUFFER_AGE_MS} after a failed write;
+*  - the OLDEST points when the queue passes {@link MAX_QUEUE_POINTS}, which a
+*    flush that hangs would otherwise let grow without limit.
+* A drop logs one ERROR with the count, one tagged line per device (rate-capped),
+* and tells the owner through `onDropped` so the capture engine forgets that it
+* ever "recorded" those values — otherwise the next change-only comparison runs
+* against a value that was never stored and the hole lasts until the value moves.
+*/
+import type { DeviceHistorySubject, IScopedLogger } from "@camstack/types";
+import type { SeriesRegistry } from "../store/series-registry.js";
+import type { HistoryStore } from "../store/history-store.js";
+import type { HistoryCounters } from "../status/counters.js";
+export declare const FLUSH_INTERVAL_MS = 1e4;
+export declare const MAX_BUFFER_AGE_MS = 6e4;
+/** Beyond this many queued points the oldest are dropped. */
+export declare const MAX_QUEUE_POINTS = 1e5;
+export interface BufferedPoint {
+	readonly key: string;
+	readonly subject: DeviceHistorySubject;
+	readonly scope: string;
+	readonly ts: number;
+	readonly value: number;
+	readonly bufferedAt: number;
+}
+export interface WrittenPoints {
+	readonly seriesId: number;
+	readonly timestamps: readonly number[];
+}
+export interface PointWriterDeps {
+	readonly registry: SeriesRegistry;
+	readonly store: HistoryStore;
+	readonly counters: HistoryCounters;
+	readonly logger: IScopedLogger;
+	readonly clock: () => number;
+	/** Called after a batch landed, so the rollup engine can mark the buckets dirty. */
+	readonly onWritten: (written: readonly WrittenPoints[]) => void;
+	/** Called with points that were buffered and then dropped. */
+	readonly onDropped: (dropped: readonly BufferedPoint[]) => void;
+}
+export declare class PointWriter {
+	private readonly deps;
+	private queue;
+	private flushing;
+	private lastDeviceLinesAt;
+	constructor(deps: PointWriterDeps);
+	enqueue(point: Omit<BufferedPoint, "bufferedAt">): void;
+	depth(): number;
+	/** One flush at a time; a call while one runs waits for it and returns. */
+	flush(): Promise<void>;
+	private doFlush;
+	private recordSpans;
+	private requeue;
+	/** Account for, say, and report to the owner a set of points that will never be written. */
+	private drop;
+}

package/dist/builtins/device-history/device-history.addon.d.ts

@@ -0,0 +1,38 @@
+/**
+* device-history — the ONE mechanism for numeric history (D850). Hub-only, its
+* own runner (not grouped, D29): it writes through the settings door into
+* `history.db`, a file with its own serving thread (D851), so a slow rollup can
+* never queue behind — or in front of — configuration reads.
+*
+* This shell only wires: the capability provider, the bus subscription, the
+* timers and the retention settings. The engine is {@link HistoryRuntime}.
+*
+* Boot waits for `onHubReachable` — the settings door and the device manager
+* are hub capabilities, and a forked runner cannot call them from
+* `onInitialize`. Until then the provider answers "starting" rather than an
+* empty history (an unanswered query is not an empty one, D315).
+*/
+import { BaseAddon, type ConfigUISchema, type ProviderRegistration } from "@camstack/types";
+export interface DeviceHistoryConfig extends Record<string, unknown> {
+	rawDays: number;
+	fiveMinuteDays: number;
+	hourDays: number;
+	/** `0` keeps the daily tier forever. */
+	dayDays: number;
+}
+/** The caller the transport stamped (never in an input schema); `null` when unstamped. */
+export declare function callerOf(input: unknown): string | null;
+export declare class DeviceHistoryAddon extends BaseAddon<DeviceHistoryConfig> {
+	private runtime;
+	private unsubscribe;
+	private removalHook;
+	constructor();
+	private retention;
+	private requireRuntime;
+	protected onInitialize(): Promise<ProviderRegistration[]>;
+	override onHubReachable(): Promise<void>;
+	private stopRuntime;
+	protected override onShutdown(): Promise<void>;
+	protected globalSettingsSchema(): ConfigUISchema;
+}
+export default DeviceHistoryAddon;