@camstack/types 1.2.366 → 1.2.368

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-NZlEFYGX.js");
+const require_sleep = require("./sleep-CXlc9YJ5.js");
 const require_event_category = require("./event-category-T43rdQWR.js");
 const require_err_msg = require("./err-msg-Dx2Kor0g.js");
 //#region src/generated/cap-input-defaults.ts
@@ -16,7 +16,7 @@ const require_err_msg = require("./err-msg-Dx2Kor0g.js");
 * Plain data, zero Zod: a forked runner must not import the schema barrel
 * (~144MB RSS per runner — D28).
 *
-* Coverage: 26 caps, 67 methods with defaults.
+* Coverage: 27 caps, 69 methods with defaults.
 */
 var CAP_INPUT_DEFAULTS = Object.freeze({
 	"addons": { "getLogs": { "limit": 100 } },
@@ -40,6 +40,16 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 		"pageSize": 50
 	} },
 	"device-credentials": { "listDeviceCredentials": { "includeRevoked": false } },
+	"device-history": {
+		"query": {
+			"resolution": "auto",
+			"maxPoints": 1e3
+		},
+		"queryNode": {
+			"resolution": "auto",
+			"maxPoints": 1e3
+		}
+	},
 	"device-manager": { "adoptionListCandidates": {
 		"page": 1,
 		"pageSize": 50

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { A as viewerUiCapability, At as createSecretsAccess, Bt as PEER_BYTES_STALL_MS, C as isZodSecret, Cn as isSecretClear, Dn as makeSecretMarker, E as HF_REPO, En as isSecretMarkerLike, Ft as registerKnownSecret, Gt as DisposerChain, I as adminUiCapability, It as scrubKnownSecrets, Kt as BaseAddon, Lt as shortSecretRefHash, Mt as clearKnownSecrets, Nt as forgetKnownSecret, On as toSecretFieldView, Ot as resolveSecretViewsIn, P as describeCustomActions, Pt as knownSecretCount, Q as readNodePin, Rt as PEER_BYTES_CHUNK_BYTES, S as collectZodSecretPaths, Sn as classifySecretWrite, Tn as isSecretMarker, Ut as DATAPLANE_SECRET_HEADER, Vt as PEER_BYTES_TICKET_TTL_MS, W as expandCapMethods, Z as nodePin, _ as createEventBusSliceSource, an as formatSecretScope, at as scopeKey, c as asString, cn as normalizeSecretOwner, d as parseJsonUnknown, et as MODEL_FORMATS, f as hfModelUrl, fn as createEvent, g as createDeviceProxy, h as isDeviceScopedCap, in as buildSecretRef, j as DEVICE_CHILDREN_BATCH_MAX, jt as MIN_SCRUBBED_LENGTH, k as deviceOpsCapability, kt as REVALIDATE_AFTER_MS, ln as parseSecretRef, m as DEVICE_SCOPED_CAPS, nn as SECRET_REF_SCHEME, nt as ReadinessTimeoutError, o as asJsonObject, on as globalSecretScope, p as BOOT_RECOVERY_BACKOFF_MS, pn as emitReadiness, qt as normalizeAddonInitResult, r as maskUrlCredentials, rn as arrayItemFieldPath, sn as isSecretRef, t as sleep, tt as ReadinessRegistry, wn as isSecretFieldView, xn as SECRET_CLEAR, zt as PEER_BYTES_MAX_OUTSTANDING } from "./sleep-DxJdzHni.mjs";
+import { A as viewerUiCapability, At as createSecretsAccess, Bt as PEER_BYTES_STALL_MS, C as isZodSecret, Cn as isSecretClear, Dn as makeSecretMarker, E as HF_REPO, En as isSecretMarkerLike, Ft as registerKnownSecret, Gt as DisposerChain, I as adminUiCapability, It as scrubKnownSecrets, Kt as BaseAddon, Lt as shortSecretRefHash, Mt as clearKnownSecrets, Nt as forgetKnownSecret, On as toSecretFieldView, Ot as resolveSecretViewsIn, P as describeCustomActions, Pt as knownSecretCount, Q as readNodePin, Rt as PEER_BYTES_CHUNK_BYTES, S as collectZodSecretPaths, Sn as classifySecretWrite, Tn as isSecretMarker, Ut as DATAPLANE_SECRET_HEADER, Vt as PEER_BYTES_TICKET_TTL_MS, W as expandCapMethods, Z as nodePin, _ as createEventBusSliceSource, an as formatSecretScope, at as scopeKey, c as asString, cn as normalizeSecretOwner, d as parseJsonUnknown, et as MODEL_FORMATS, f as hfModelUrl, fn as createEvent, g as createDeviceProxy, h as isDeviceScopedCap, in as buildSecretRef, j as DEVICE_CHILDREN_BATCH_MAX, jt as MIN_SCRUBBED_LENGTH, k as deviceOpsCapability, kt as REVALIDATE_AFTER_MS, ln as parseSecretRef, m as DEVICE_SCOPED_CAPS, nn as SECRET_REF_SCHEME, nt as ReadinessTimeoutError, o as asJsonObject, on as globalSecretScope, p as BOOT_RECOVERY_BACKOFF_MS, pn as emitReadiness, qt as normalizeAddonInitResult, r as maskUrlCredentials, rn as arrayItemFieldPath, sn as isSecretRef, t as sleep, tt as ReadinessRegistry, wn as isSecretFieldView, xn as SECRET_CLEAR, zt as PEER_BYTES_MAX_OUTSTANDING } from "./sleep--g-h2_c_.mjs";
 import { t as EventCategory } from "./event-category-C4hVnRo8.mjs";
 import { a as DeviceType, t as errMsg } from "./err-msg-DX6i_MY4.mjs";
 //#region src/generated/cap-input-defaults.ts
@@ -15,7 +15,7 @@ import { a as DeviceType, t as errMsg } from "./err-msg-DX6i_MY4.mjs";
 * Plain data, zero Zod: a forked runner must not import the schema barrel
 * (~144MB RSS per runner — D28).
 *
-* Coverage: 26 caps, 67 methods with defaults.
+* Coverage: 27 caps, 69 methods with defaults.
 */
 var CAP_INPUT_DEFAULTS = Object.freeze({
 	"addons": { "getLogs": { "limit": 100 } },
@@ -39,6 +39,16 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 		"pageSize": 50
 	} },
 	"device-credentials": { "listDeviceCredentials": { "includeRevoked": false } },
+	"device-history": {
+		"query": {
+			"resolution": "auto",
+			"maxPoints": 1e3
+		},
+		"queryNode": {
+			"resolution": "auto",
+			"maxPoints": 1e3
+		}
+	},
 	"device-manager": { "adoptionListCandidates": {
 		"page": 1,
 		"pageSize": 50

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

@@ -0,0 +1,444 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+/**
+ * device-history — the ONE mechanism for numeric history (D850).
+ *
+ * A device value is recorded because its capability says so (the `history`
+ * block of a `*.cap.ts`, captured hub-side from `DeviceStateChanged`); any
+ * other series is DECLARED by the addon that produces it and fed with points
+ * (`record`) or closed five-minute buckets (`recordBuckets`). Rollups 5m / 1h /
+ * 1d are computed here and nowhere else. Storage is `history.db` (D851).
+ *
+ * Who the PRODUCER is: `declareSeries`, `record` and `recordBuckets` are owner
+ * checked against the `callerAddonId` the transport stamps into a call that
+ * crossed a process (never in an input schema, so a session cannot supply it).
+ * A call with no stamp is refused `not-owner`. The methods are `admin` so a
+ * non-admin session never reaches them; an addon's `ctx.api` call bypasses the
+ * tier by design.
+ */
+/** Whose history: a real device, or a cluster node (load, memory). */
+export declare const DeviceHistorySubjectSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"device">;
+    deviceId: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"node">;
+    nodeId: z.ZodString;
+}, z.core.$strip>], "kind">;
+export type DeviceHistorySubject = z.infer<typeof DeviceHistorySubjectSchema>;
+export declare const DeviceHistoryKindSchema: z.ZodEnum<{
+    boolean: "boolean";
+    counter: "counter";
+    gauge: "gauge";
+}>;
+export type DeviceHistoryKind = z.infer<typeof DeviceHistoryKindSchema>;
+export declare const DeviceHistoryResolutionSchema: z.ZodEnum<{
+    "1d": "1d";
+    "1h": "1h";
+    "5m": "5m";
+    raw: "raw";
+}>;
+export type DeviceHistoryResolution = z.infer<typeof DeviceHistoryResolutionSchema>;
+/** Why a producer's point or bucket was not stored. Counted, never silent (D391). */
+export declare const DeviceHistoryRefusalReasonSchema: z.ZodEnum<{
+    "ingest-mismatch": "ingest-mismatch";
+    "not-a-real-device": "not-a-real-device";
+    "not-owner": "not-owner";
+    "opted-out": "opted-out";
+    "out-of-range": "out-of-range";
+    rate: "rate";
+    undeclared: "undeclared";
+}>;
+export type DeviceHistoryRefusalReason = z.infer<typeof DeviceHistoryRefusalReasonSchema>;
+declare const IngestResultSchema: z.ZodObject<{
+    accepted: z.ZodNumber;
+    refused: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        reason: z.ZodEnum<{
+            "ingest-mismatch": "ingest-mismatch";
+            "not-a-real-device": "not-a-real-device";
+            "not-owner": "not-owner";
+            "opted-out": "opted-out";
+            "out-of-range": "out-of-range";
+            rate: "rate";
+            undeclared: "undeclared";
+        }>;
+        count: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type DeviceHistoryIngestResult = z.infer<typeof IngestResultSchema>;
+declare const SeriesInfoSchema: z.ZodObject<{
+    key: z.ZodString;
+    scope: z.ZodString;
+    kind: z.ZodEnum<{
+        boolean: "boolean";
+        counter: "counter";
+        gauge: "gauge";
+    }>;
+    unit: z.ZodNullable<z.ZodString>;
+    displayName: z.ZodString;
+    source: z.ZodEnum<{
+        addon: "addon";
+        cap: "cap";
+    }>;
+    firstTs: z.ZodNumber;
+    lastTs: z.ZodNumber;
+}, z.core.$strip>;
+export type DeviceHistorySeriesInfo = z.infer<typeof SeriesInfoSchema>;
+declare const QueryPointSchema: z.ZodObject<{
+    t: z.ZodNumber;
+    samples: z.ZodNumber;
+    mean: z.ZodNullable<z.ZodNumber>;
+    twMean: z.ZodNullable<z.ZodNumber>;
+    min: z.ZodNumber;
+    max: z.ZodNumber;
+    last: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type DeviceHistoryQueryPoint = z.infer<typeof QueryPointSchema>;
+/** Operator/diagnostic view: rows per tier, last runs, refusals and drops since boot. */
+export declare const DeviceHistoryStatusSchema: z.ZodObject<{
+    startedAt: z.ZodNumber;
+    ready: z.ZodBoolean;
+    series: z.ZodNumber;
+    metrics: z.ZodNumber;
+    optedOutDevices: z.ZodNumber;
+    tiers: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        tier: z.ZodEnum<{
+            "1d": "1d";
+            "1h": "1h";
+            "5m": "5m";
+            raw: "raw";
+        }>;
+        rows: z.ZodNullable<z.ZodNumber>;
+        approxBytes: z.ZodNullable<z.ZodNumber>;
+        countedAt: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    capture: z.ZodObject<{
+        eventsSeen: z.ZodNumber;
+        pointsEmitted: z.ZodNumber;
+        pointsWritten: z.ZodNumber;
+        pointsDropped: z.ZodNumber;
+        bufferDepth: z.ZodNumber;
+        trailingEmitted: z.ZodNumber;
+        reconciledPoints: z.ZodNumber;
+        reconcileRuns: z.ZodNumber;
+        reconcileFailures: z.ZodNumber;
+        lastReconcileAt: z.ZodNullable<z.ZodNumber>;
+        lastFlushAt: z.ZodNullable<z.ZodNumber>;
+        flushFailures: z.ZodNumber;
+        skipped: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strip>;
+    ingest: z.ZodObject<{
+        accepted: z.ZodNumber;
+        refused: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strip>;
+    rollup: z.ZodObject<{
+        last5mAt: z.ZodNullable<z.ZodNumber>;
+        last1hAt: z.ZodNullable<z.ZodNumber>;
+        last1dAt: z.ZodNullable<z.ZodNumber>;
+        errors: z.ZodNumber;
+        dirty5m: z.ZodNumber;
+        dirty1h: z.ZodNumber;
+        dirty1d: z.ZodNumber;
+    }, z.core.$strip>;
+    retention: z.ZodObject<{
+        lastRunAt: z.ZodNullable<z.ZodNumber>;
+        deleted: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        purgedSeries: z.ZodNumber;
+    }, z.core.$strip>;
+    directory: z.ZodObject<{
+        devices: z.ZodNumber;
+        lastRefreshAt: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type DeviceHistoryStatus = z.infer<typeof DeviceHistoryStatusSchema>;
+export declare const deviceHistoryCapability: {
+    readonly name: 'device-history';
+    readonly scope: 'system';
+    readonly mode: 'singleton';
+    readonly methods: {
+        /**
+         * The series a DEVICE has, and their span. `deviceId` is a flat top-level field
+         * on purpose: the generated device selector (and so the scope gate) only sees
+         * top-level ids, and a nested `subject.deviceId` would let a principal limited
+         * to one device read another's history. Node series are the admin-only
+         * `listNodeSeries` / `queryNode`.
+         */
+        readonly listSeries: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            scope: z.ZodString;
+            kind: z.ZodEnum<{
+                boolean: "boolean";
+                counter: "counter";
+                gauge: "gauge";
+            }>;
+            unit: z.ZodNullable<z.ZodString>;
+            displayName: z.ZodString;
+            source: z.ZodEnum<{
+                addon: "addon";
+                cap: "cap";
+            }>;
+            firstTs: z.ZodNumber;
+            lastTs: z.ZodNumber;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly listNodeSeries: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            nodeId: z.ZodString;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            scope: z.ZodString;
+            kind: z.ZodEnum<{
+                boolean: "boolean";
+                counter: "counter";
+                gauge: "gauge";
+            }>;
+            unit: z.ZodNullable<z.ZodString>;
+            displayName: z.ZodString;
+            source: z.ZodEnum<{
+                addon: "addon";
+                cap: "cap";
+            }>;
+            firstTs: z.ZodNumber;
+            lastTs: z.ZodNumber;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * One series (or every scope of it) at one resolution. `auto` picks the
+         * finest tier whose retention covers `from` and whose point count fits
+         * `maxPoints`; when even the coarsest tier does not fit, the newest
+         * `maxPoints` points are returned and `truncated` is true.
+         */
+        readonly query: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            key: z.ZodString;
+            scope: z.ZodOptional<z.ZodString>;
+            from: z.ZodNumber;
+            to: z.ZodNumber;
+            resolution: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+                "1d": "1d";
+                "1h": "1h";
+                "5m": "5m";
+                raw: "raw";
+            }>, z.ZodLiteral<"auto">]>>;
+            maxPoints: z.ZodDefault<z.ZodNumber>;
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            resolution: z.ZodEnum<{
+                "1d": "1d";
+                "1h": "1h";
+                "5m": "5m";
+                raw: "raw";
+            }>;
+            series: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                scope: z.ZodString;
+                before: z.ZodNullable<z.ZodObject<{
+                    t: z.ZodNumber;
+                    value: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strip>>;
+                points: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    t: z.ZodNumber;
+                    samples: z.ZodNumber;
+                    mean: z.ZodNullable<z.ZodNumber>;
+                    twMean: z.ZodNullable<z.ZodNumber>;
+                    min: z.ZodNumber;
+                    max: z.ZodNumber;
+                    last: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>>;
+            truncated: z.ZodBoolean;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly queryNode: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            key: z.ZodString;
+            scope: z.ZodOptional<z.ZodString>;
+            from: z.ZodNumber;
+            to: z.ZodNumber;
+            resolution: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+                "1d": "1d";
+                "1h": "1h";
+                "5m": "5m";
+                raw: "raw";
+            }>, z.ZodLiteral<"auto">]>>;
+            maxPoints: z.ZodDefault<z.ZodNumber>;
+            nodeId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            resolution: z.ZodEnum<{
+                "1d": "1d";
+                "1h": "1h";
+                "5m": "5m";
+                raw: "raw";
+            }>;
+            series: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                scope: z.ZodString;
+                before: z.ZodNullable<z.ZodObject<{
+                    t: z.ZodNumber;
+                    value: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strip>>;
+                points: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    t: z.ZodNumber;
+                    samples: z.ZodNumber;
+                    mean: z.ZodNullable<z.ZodNumber>;
+                    twMean: z.ZodNullable<z.ZodNumber>;
+                    min: z.ZodNumber;
+                    max: z.ZodNumber;
+                    last: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>>;
+            truncated: z.ZodBoolean;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /** Producer: declare (idempotent) a series key this addon owns: `addon:<callerAddonId>/<name>`. */
+        readonly declareSeries: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            name: z.ZodString;
+            subjectKind: z.ZodEnum<{
+                device: "device";
+                node: "node";
+            }>;
+            kind: z.ZodEnum<{
+                boolean: "boolean";
+                counter: "counter";
+                gauge: "gauge";
+            }>;
+            unit: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodString;
+            ingest: z.ZodEnum<{
+                buckets: "buckets";
+                points: "points";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            key: z.ZodString;
+        }, z.core.$strip>, "mutation">;
+        /** Producer: points. Low rate: at most one per 10 s per series, sustained. */
+        readonly record: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            points: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                subject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"device">;
+                    deviceId: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"node">;
+                    nodeId: z.ZodString;
+                }, z.core.$strip>], "kind">;
+                scope: z.ZodDefault<z.ZodString>;
+                ts: z.ZodNumber;
+                value: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            accepted: z.ZodNumber;
+            refused: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                reason: z.ZodEnum<{
+                    "ingest-mismatch": "ingest-mismatch";
+                    "not-a-real-device": "not-a-real-device";
+                    "not-owner": "not-owner";
+                    "opted-out": "opted-out";
+                    "out-of-range": "out-of-range";
+                    rate: "rate";
+                    undeclared: "undeclared";
+                }>;
+                count: z.ZodNumber;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, "mutation">;
+        /** Producer: CLOSED five-minute buckets. Idempotent upsert keyed (series, bucketStart). */
+        readonly recordBuckets: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            buckets: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                subject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"device">;
+                    deviceId: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"node">;
+                    nodeId: z.ZodString;
+                }, z.core.$strip>], "kind">;
+                scope: z.ZodDefault<z.ZodString>;
+                bucketStart: z.ZodNumber;
+                samples: z.ZodNumber;
+                sum: z.ZodNumber;
+                min: z.ZodNumber;
+                max: z.ZodNumber;
+                last: z.ZodNullable<z.ZodNumber>;
+                lastTs: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            accepted: z.ZodNumber;
+            refused: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                reason: z.ZodEnum<{
+                    "ingest-mismatch": "ingest-mismatch";
+                    "not-a-real-device": "not-a-real-device";
+                    "not-owner": "not-owner";
+                    "opted-out": "opted-out";
+                    "out-of-range": "out-of-range";
+                    rate: "rate";
+                    undeclared: "undeclared";
+                }>;
+                count: z.ZodNumber;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, "mutation">;
+        /** Per-device opt-out. This addon IS the authority: the switch stores nothing elsewhere (D62). */
+        readonly getDeviceEnabled: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            enabled: z.ZodBoolean;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly setDeviceEnabled: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            enabled: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodObject<{
+            enabled: z.ZodBoolean;
+        }, z.core.$strip>, "mutation">;
+        readonly getStatus: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+            startedAt: z.ZodNumber;
+            ready: z.ZodBoolean;
+            series: z.ZodNumber;
+            metrics: z.ZodNumber;
+            optedOutDevices: z.ZodNumber;
+            tiers: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                tier: z.ZodEnum<{
+                    "1d": "1d";
+                    "1h": "1h";
+                    "5m": "5m";
+                    raw: "raw";
+                }>;
+                rows: z.ZodNullable<z.ZodNumber>;
+                approxBytes: z.ZodNullable<z.ZodNumber>;
+                countedAt: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            capture: z.ZodObject<{
+                eventsSeen: z.ZodNumber;
+                pointsEmitted: z.ZodNumber;
+                pointsWritten: z.ZodNumber;
+                pointsDropped: z.ZodNumber;
+                bufferDepth: z.ZodNumber;
+                trailingEmitted: z.ZodNumber;
+                reconciledPoints: z.ZodNumber;
+                reconcileRuns: z.ZodNumber;
+                reconcileFailures: z.ZodNumber;
+                lastReconcileAt: z.ZodNullable<z.ZodNumber>;
+                lastFlushAt: z.ZodNullable<z.ZodNumber>;
+                flushFailures: z.ZodNumber;
+                skipped: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            }, z.core.$strip>;
+            ingest: z.ZodObject<{
+                accepted: z.ZodNumber;
+                refused: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            }, z.core.$strip>;
+            rollup: z.ZodObject<{
+                last5mAt: z.ZodNullable<z.ZodNumber>;
+                last1hAt: z.ZodNullable<z.ZodNumber>;
+                last1dAt: z.ZodNullable<z.ZodNumber>;
+                errors: z.ZodNumber;
+                dirty5m: z.ZodNumber;
+                dirty1h: z.ZodNumber;
+                dirty1d: z.ZodNumber;
+            }, z.core.$strip>;
+            retention: z.ZodObject<{
+                lastRunAt: z.ZodNullable<z.ZodNumber>;
+                deleted: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                purgedSeries: z.ZodNumber;
+            }, z.core.$strip>;
+            directory: z.ZodObject<{
+                devices: z.ZodNumber;
+                lastRefreshAt: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+    };
+};
+export type IDeviceHistoryProvider = InferProvider<typeof deviceHistoryCapability>;
+export {};

package/dist/capabilities/index.d.ts

@@ -46,6 +46,7 @@ export { CustomModelDescriptorSchema, customModelRegistryCapability, ImportModel
 export { type DataStoreEngineInfo, dataStoreProviderCapability, EngineInfoSchema as DataStoreEngineInfoSchema, type IDataStoreProvider, } from './data-store-provider.cap.js';
 export { type ArchiveSqliteSnapshot, ArchiveSqliteSnapshotSchema, DATABASE_SNAPSHOT_PARTIAL_SUFFIX, DATABASE_SNAPSHOT_SUFFIX, DATABASE_SNAPSHOT_TIMEOUT_MS, type DatabaseSnapshotRequest, DatabaseSnapshotRequestSchema, type DatabaseSnapshotResult, DatabaseSnapshotResultSchema, type DatabaseSnapshotTable, DatabaseSnapshotTableSchema, type DatabaseSnapshotTargets, DatabaseSnapshotTargetsSchema, type DatabaseSnapshotWritten, DatabaseSnapshotWrittenSchema, databaseSnapshotCapability, type IDatabaseSnapshotProvider, } from './database-snapshot.cap.js';
 export { type IKeychainProvider, KEYCHAIN_MAX_REFS_PER_CALL, type KeychainResolveEntry, KeychainResolveEntrySchema, type KeychainResolveResult, KeychainResolveResultSchema, type KeychainSecretMeta, KeychainSecretMetaSchema, type KeychainState, KeychainStateSchema, type KeychainUnavailableReason, KeychainUnavailableReasonSchema, keychainCapability, } from './keychain.cap.js';
+export { type DeviceHistoryStatus, DeviceHistoryStatusSchema, type DeviceHistoryIngestResult, type DeviceHistoryKind, DeviceHistoryKindSchema, type DeviceHistoryQueryPoint, type DeviceHistoryRefusalReason, DeviceHistoryRefusalReasonSchema, type DeviceHistoryResolution, DeviceHistoryResolutionSchema, type DeviceHistorySeriesInfo, type DeviceHistorySubject, DeviceHistorySubjectSchema, type IDeviceHistoryProvider, deviceHistoryCapability, } from './device-history.cap.js';
 export { type DeviceCaStatus, DeviceCaStatusSchema, type DeviceCertificateSettings, DeviceCertificateSettingsSchema, deviceCredentialsCapability, type IDeviceCredentialsProvider, } from './device-credentials.cap.js';
 export { type HttpsLeafInfo, HttpsLeafInfoSchema, type INodeCertificatesProvider, type MeshLeafInfo, MeshLeafInfoSchema, type NodeHttpsState, NodeHttpsStateSchema, nodeCertificatesCapability, } from './node-certificates.cap.js';
 export { type IKeychainAdminProvider, KEYCHAIN_RESET_CONFIRMATION, type KeychainAdminSecret, KeychainAdminSecretSchema, type KeychainAuditAction, KeychainAuditActionSchema, type KeychainAuditEntry, KeychainAuditEntrySchema, type KeychainKeySource, type KeychainKeySourceKind, KeychainKeySourceKindSchema, KeychainKeySourceSchema, KEYCHAIN_RESET_TRIGGER_ACTOR, type KeychainResetRecord, KeychainResetRecordSchema, type KeychainSecretUsage, KeychainSecretUsageSchema, type KeychainStatus, KeychainStatusSchema, keychainAdminCapability, type SystemHeldSecretName, SystemHeldSecretNameSchema, } from './keychain-admin.cap.js';
@@ -286,6 +287,7 @@ import type { coverCapability } from './cover.cap.js';
 import type { customModelRegistryCapability } from './custom-model-registry.cap.js';
 import type { dataStoreProviderCapability } from './data-store-provider.cap.js';
 import type { databaseSnapshotCapability } from './database-snapshot.cap.js';
+import type { deviceHistoryCapability } from './device-history.cap.js';
 import type { keychainCapability } from './keychain.cap.js';
 import type { keychainAdminCapability } from './keychain-admin.cap.js';
 import type { deviceCredentialsCapability } from './device-credentials.cap.js';
@@ -413,6 +415,6 @@ import type { trainingProviderCapability } from './training-provider.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 streamSignalsCapability | typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageMigrationCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof storageOccupancyCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof dataStoreProviderCapability | typeof databaseSnapshotCapability | typeof keychainCapability | typeof keychainAdminCapability | typeof deviceCredentialsCapability | typeof nodeCertificatesCapability | 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 deviceAdminLinkCapability | 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 calendarSourceCapability | typeof calendarsCapability | 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 composerCapability | typeof coreBlocksCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof navigationCapability | 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 zonesCapability | typeof zoneRulesCapability | typeof trainingCapability | typeof trainingProviderCapability | 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 recordingArchiveCapability | typeof recordingExportCapability | typeof recordingSignalCapability | 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 oidcConnectionsCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof cameraGridLayoutCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof recordingOnboardCapability | typeof imageSettingsCapability | typeof osdCapability | typeof osdManagerCapability | typeof accessoriesCapability | typeof batteryCapability | typeof networkLinkCapability | 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 | typeof deviceExtensionCapability;
+type AnyCapability = typeof streamSignalsCapability | typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageMigrationCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof storageOccupancyCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof dataStoreProviderCapability | typeof databaseSnapshotCapability | typeof deviceHistoryCapability | typeof keychainCapability | typeof keychainAdminCapability | typeof deviceCredentialsCapability | typeof nodeCertificatesCapability | 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 deviceAdminLinkCapability | 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 calendarSourceCapability | typeof calendarsCapability | 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 composerCapability | typeof coreBlocksCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof navigationCapability | 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 zonesCapability | typeof zoneRulesCapability | typeof trainingCapability | typeof trainingProviderCapability | 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 recordingArchiveCapability | typeof recordingExportCapability | typeof recordingSignalCapability | 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 oidcConnectionsCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof cameraGridLayoutCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof recordingOnboardCapability | typeof imageSettingsCapability | typeof osdCapability | typeof osdManagerCapability | typeof accessoriesCapability | typeof batteryCapability | typeof networkLinkCapability | 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 | typeof deviceExtensionCapability;
 export type CapabilityName = AnyCapability['name'];
 export type ITypedReadinessRegistry = IReadinessRegistry<CapabilityName>;

package/dist/client.js

@@ -26470,6 +26470,12 @@ function createDeviceProxy(api, binding, opts) {
 		getDeviceLiveContribution: (input) => dispatchSystem("deviceExport", "getDeviceLiveContribution", "query", input),
 		applyDeviceSettingsPatch: (input) => dispatchSystem("deviceExport", "applyDeviceSettingsPatch", "mutation", input)
 	};
+	const deviceHistoryInterface = {
+		listSeries: (input) => dispatchSystem("deviceHistory", "listSeries", "query", input),
+		query: (input) => dispatchSystem("deviceHistory", "query", "query", input),
+		getDeviceEnabled: (input) => dispatchSystem("deviceHistory", "getDeviceEnabled", "query", input),
+		setDeviceEnabled: (input) => dispatchSystem("deviceHistory", "setDeviceEnabled", "mutation", input)
+	};
 	const deviceManagerInterface = {
 		loadConfig: (input) => dispatchSystem("deviceManager", "loadConfig", "query", input),
 		loadRuntimeState: (input) => dispatchSystem("deviceManager", "loadRuntimeState", "query", input),
@@ -26781,6 +26787,7 @@ function createDeviceProxy(api, binding, opts) {
 		audioAnalyzer: audioAnalyzerInterface,
 		deviceAdoption: deviceAdoptionInterface,
 		deviceExport: deviceExportInterface,
+		deviceHistory: deviceHistoryInterface,
 		deviceManager: deviceManagerInterface,
 		deviceState: deviceStateInterface,
 		faceGallery: faceGalleryInterface,
@@ -27663,6 +27670,14 @@ function createSystemProxy(api) {
 			exposeDevice: (input) => dispatch("deviceExport", "exposeDevice", "mutation", input),
 			unexposeDevice: (input) => dispatch("deviceExport", "unexposeDevice", "mutation", input)
 		},
+		deviceHistory: {
+			listNodeSeries: (input) => dispatch("deviceHistory", "listNodeSeries", "query", input),
+			queryNode: (input) => dispatch("deviceHistory", "queryNode", "query", input),
+			declareSeries: (input) => dispatch("deviceHistory", "declareSeries", "mutation", input),
+			record: (input) => dispatch("deviceHistory", "record", "mutation", input),
+			recordBuckets: (input) => dispatch("deviceHistory", "recordBuckets", "mutation", input),
+			getStatus: (input) => dispatch("deviceHistory", "getStatus", "query", input)
+		},
 		deviceManager: {
 			allocateDeviceId: (input) => dispatch("deviceManager", "allocateDeviceId", "mutation", input),
 			migrateDevice: (input) => dispatch("deviceManager", "migrateDevice", "mutation", input),

package/dist/client.mjs

@@ -26469,6 +26469,12 @@ function createDeviceProxy(api, binding, opts) {
 		getDeviceLiveContribution: (input) => dispatchSystem("deviceExport", "getDeviceLiveContribution", "query", input),
 		applyDeviceSettingsPatch: (input) => dispatchSystem("deviceExport", "applyDeviceSettingsPatch", "mutation", input)
 	};
+	const deviceHistoryInterface = {
+		listSeries: (input) => dispatchSystem("deviceHistory", "listSeries", "query", input),
+		query: (input) => dispatchSystem("deviceHistory", "query", "query", input),
+		getDeviceEnabled: (input) => dispatchSystem("deviceHistory", "getDeviceEnabled", "query", input),
+		setDeviceEnabled: (input) => dispatchSystem("deviceHistory", "setDeviceEnabled", "mutation", input)
+	};
 	const deviceManagerInterface = {
 		loadConfig: (input) => dispatchSystem("deviceManager", "loadConfig", "query", input),
 		loadRuntimeState: (input) => dispatchSystem("deviceManager", "loadRuntimeState", "query", input),
@@ -26780,6 +26786,7 @@ function createDeviceProxy(api, binding, opts) {
 		audioAnalyzer: audioAnalyzerInterface,
 		deviceAdoption: deviceAdoptionInterface,
 		deviceExport: deviceExportInterface,
+		deviceHistory: deviceHistoryInterface,
 		deviceManager: deviceManagerInterface,
 		deviceState: deviceStateInterface,
 		faceGallery: faceGalleryInterface,
@@ -27662,6 +27669,14 @@ function createSystemProxy(api) {
 			exposeDevice: (input) => dispatch("deviceExport", "exposeDevice", "mutation", input),
 			unexposeDevice: (input) => dispatch("deviceExport", "unexposeDevice", "mutation", input)
 		},
+		deviceHistory: {
+			listNodeSeries: (input) => dispatch("deviceHistory", "listNodeSeries", "query", input),
+			queryNode: (input) => dispatch("deviceHistory", "queryNode", "query", input),
+			declareSeries: (input) => dispatch("deviceHistory", "declareSeries", "mutation", input),
+			record: (input) => dispatch("deviceHistory", "record", "mutation", input),
+			recordBuckets: (input) => dispatch("deviceHistory", "recordBuckets", "mutation", input),
+			getStatus: (input) => dispatch("deviceHistory", "getStatus", "query", input)
+		},
 		deviceManager: {
 			allocateDeviceId: (input) => dispatch("deviceManager", "allocateDeviceId", "mutation", input),
 			migrateDevice: (input) => dispatch("deviceManager", "migrateDevice", "mutation", input),