@camstack/addon-provider-rtsp 1.2.126 → 1.2.127

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/addon.js +1318 -129
  2. package/dist/addon.mjs +1318 -129
  3. package/package.json +1 -1
package/dist/addon.js CHANGED
@@ -23,7 +23,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
23
23
  //#endregion
24
24
  let node_net = require("node:net");
25
25
  node_net = __toESM(node_net);
26
- //#region ../types/dist/event-category-C4hVnRo8.mjs
26
+ //#region ../types/dist/event-category-BvOFi6PY.mjs
27
27
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
28
28
  EventCategory["SystemBoot"] = "system.boot";
29
29
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -87,6 +87,24 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
87
87
  * consumes this category and maps it to the `addon-crash-loop` kind.
88
88
  */
89
89
  EventCategory["AddonRunnerFailed"] = "addon.runner-failed";
90
+ /**
91
+ * A runner whose addon refused to start with a typed reason (D877) - parked
92
+ * in `refused`, never counted by the crash breaker, retried on operator
93
+ * action. One event per refusal.
94
+ */
95
+ EventCategory["AddonRunnerRefused"] = "addon.runner-refused";
96
+ /**
97
+ * A runner settled on a state (D877): `running` (READY), `crashed`, `failed` or
98
+ * `refused`. In-process telemetry for the boot check (re-evaluate while any
99
+ * runner is still pending) and the alert centre (close a recovered runner).
100
+ */
101
+ EventCategory["ProcessStateChanged"] = "process.state-changed";
102
+ /**
103
+ * The node's one-shot runner boot check (D877): planned runners against the
104
+ * process service, `degraded` when any is failed, refused or missing. The
105
+ * alert centre turns it into one alert and a direct critical push.
106
+ */
107
+ EventCategory["SystemRunnerCheck"] = "system.runner-check";
90
108
  EventCategory["AddonError"] = "addon.error";
91
109
  EventCategory["AddonPageReady"] = "addon.page-ready";
92
110
  EventCategory["AddonWidgetReady"] = "addon.widget-ready";
@@ -5411,7 +5429,7 @@ var ZodIssueCode = {
5411
5429
  var ZodFirstPartyTypeKind;
5412
5430
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5413
5431
  //#endregion
5414
- //#region ../types/dist/sleep-DRqxtc0C.mjs
5432
+ //#region ../types/dist/sleep-BOjuyoPC.mjs
5415
5433
  /**
5416
5434
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5417
5435
  * window to float samples (D455).
@@ -5528,7 +5546,7 @@ function isKeychainStoredField(field) {
5528
5546
  var SECRET_CLEAR = { $secretClear: true };
5529
5547
  /** The `'***'` token D634 redaction writes for non-admins. */
5530
5548
  var LEGACY_DEVICE_REDACTION = "***";
5531
- function isRecord$2(value) {
5549
+ function isRecord$5(value) {
5532
5550
  return typeof value === "object" && value !== null && !Array.isArray(value);
5533
5551
  }
5534
5552
  function makeSecretMarker(ref) {
@@ -5539,12 +5557,12 @@ function makeSecretMarker(ref) {
5539
5557
  }
5540
5558
  /** A stored marker: an object whose `$secret` is a non-empty string. */
5541
5559
  function isSecretMarker(value) {
5542
- if (!isRecord$2(value)) return false;
5560
+ if (!isRecord$5(value)) return false;
5543
5561
  const ref = value["$secret"];
5544
5562
  return typeof ref === "string" && ref.length > 0;
5545
5563
  }
5546
5564
  function isSecretClear(value) {
5547
- return isRecord$2(value) && value["$secretClear"] === true;
5565
+ return isRecord$5(value) && value["$secretClear"] === true;
5548
5566
  }
5549
5567
  /**
5550
5568
  * The UI view of a stored secret field value: a marker becomes "set", inline
@@ -6154,7 +6172,7 @@ var KeychainWriteRefusedError = class extends Error {
6154
6172
  }
6155
6173
  };
6156
6174
  var KEEP = { kind: "keep" };
6157
- function isRecord$1(value) {
6175
+ function isRecord$4(value) {
6158
6176
  return typeof value === "object" && value !== null && !Array.isArray(value);
6159
6177
  }
6160
6178
  function defaultMintId() {
@@ -6167,7 +6185,7 @@ function collectSecretMarkerRefs(value, out = []) {
6167
6185
  return out;
6168
6186
  }
6169
6187
  if (Array.isArray(value)) for (const item of value) collectSecretMarkerRefs(item, out);
6170
- else if (isRecord$1(value)) for (const child of Object.values(value)) collectSecretMarkerRefs(child, out);
6188
+ else if (isRecord$4(value)) for (const child of Object.values(value)) collectSecretMarkerRefs(child, out);
6171
6189
  return out;
6172
6190
  }
6173
6191
  async function storedValueEquals(secrets, marker, candidate) {
@@ -6222,7 +6240,7 @@ function rowId(row, idKey) {
6222
6240
  return null;
6223
6241
  }
6224
6242
  async function writeArray(ctx, node, incoming, stored, fieldPath) {
6225
- const storedRows = Array.isArray(stored) ? stored.filter(isRecord$1) : [];
6243
+ const storedRows = Array.isArray(stored) ? stored.filter(isRecord$4) : [];
6226
6244
  if (!Array.isArray(incoming)) {
6227
6245
  ctx.deletes.push(...collectSecretMarkerRefs(storedRows));
6228
6246
  return {
@@ -6238,7 +6256,7 @@ async function writeArray(ctx, node, incoming, stored, fieldPath) {
6238
6256
  const kept = /* @__PURE__ */ new Set();
6239
6257
  const rows = [];
6240
6258
  for (const row of incoming) {
6241
- if (!isRecord$1(row)) {
6259
+ if (!isRecord$4(row)) {
6242
6260
  rows.push(row);
6243
6261
  continue;
6244
6262
  }
@@ -6263,7 +6281,7 @@ async function writeNode(ctx, node, incoming, stored, fieldPath) {
6263
6281
  case "leaf": return writeLeaf(ctx, incoming, stored, fieldPath);
6264
6282
  case "array": return writeArray(ctx, node, incoming, stored, fieldPath);
6265
6283
  case "object": {
6266
- if (!isRecord$1(incoming)) {
6284
+ if (!isRecord$4(incoming)) {
6267
6285
  if (incoming === void 0) return KEEP;
6268
6286
  ctx.deletes.push(...collectSecretMarkerRefs(stored));
6269
6287
  return {
@@ -6271,7 +6289,7 @@ async function writeNode(ctx, node, incoming, stored, fieldPath) {
6271
6289
  value: incoming
6272
6290
  };
6273
6291
  }
6274
- const storedObj = isRecord$1(stored) ? stored : {};
6292
+ const storedObj = isRecord$4(stored) ? stored : {};
6275
6293
  return {
6276
6294
  kind: "value",
6277
6295
  value: await writeMembers(ctx, node.children, incoming, storedObj, (m) => `${fieldPath}.${m}`)
@@ -6394,7 +6412,7 @@ async function resolveSecretMarkers(value, secrets, options = {}) {
6394
6412
  value: items
6395
6413
  };
6396
6414
  }
6397
- if (isRecord$1(v)) {
6415
+ if (isRecord$4(v)) {
6398
6416
  const out = {};
6399
6417
  for (const [k, child] of Object.entries(v)) {
6400
6418
  const s = substitute(child);
@@ -6426,7 +6444,7 @@ var SecretOverwriteRefusedError = class extends Error {
6426
6444
  this.name = "SecretOverwriteRefusedError";
6427
6445
  }
6428
6446
  };
6429
- function isRecord(value) {
6447
+ function isRecord$3(value) {
6430
6448
  return typeof value === "object" && value !== null && !Array.isArray(value);
6431
6449
  }
6432
6450
  function resolvedValue(pass, marker) {
@@ -6455,7 +6473,7 @@ function inArray(pass, incoming, stored) {
6455
6473
  return incoming.map((item, index) => {
6456
6474
  const twin = stored[index];
6457
6475
  if (isSecretMarker(twin)) return typeof item === "string" && item === resolvedValue(pass, twin) ? twin : item;
6458
- if (isRecord(item) && isRecord(twin)) return inArrayRow(pass, item, twin);
6476
+ if (isRecord$3(item) && isRecord$3(twin)) return inArrayRow(pass, item, twin);
6459
6477
  if (Array.isArray(item) && Array.isArray(twin)) return inArray(pass, item, twin);
6460
6478
  return item;
6461
6479
  });
@@ -6466,7 +6484,7 @@ function inArrayRow(pass, incoming, stored) {
6466
6484
  const twin = stored[key];
6467
6485
  if (isSecretMarker(twin)) {
6468
6486
  if (typeof value === "string" && value === resolvedValue(pass, twin)) out[key] = twin;
6469
- } else if (isRecord(value) && isRecord(twin)) out[key] = inArrayRow(pass, value, twin);
6487
+ } else if (isRecord$3(value) && isRecord$3(twin)) out[key] = inArrayRow(pass, value, twin);
6470
6488
  else if (Array.isArray(value) && Array.isArray(twin)) out[key] = inArray(pass, value, twin);
6471
6489
  }
6472
6490
  return out;
@@ -6474,7 +6492,7 @@ function inArrayRow(pass, incoming, stored) {
6474
6492
  async function walk(pass, incoming, stored) {
6475
6493
  if (isSecretMarker(stored)) return atMarker(pass, incoming, stored);
6476
6494
  if (Array.isArray(incoming) && Array.isArray(stored)) return inArray(pass, incoming, stored);
6477
- if (!isRecord(incoming) || !isRecord(stored)) return incoming;
6495
+ if (!isRecord$3(incoming) || !isRecord$3(stored)) return incoming;
6478
6496
  const out = { ...incoming };
6479
6497
  for (const [key, value] of Object.entries(incoming)) out[key] = await walk(pass, value, stored[key]);
6480
6498
  return out;
@@ -6505,7 +6523,7 @@ async function restoreUnchangedSecrets(input) {
6505
6523
  function isJsonEqual(a, b) {
6506
6524
  if (Object.is(a, b)) return true;
6507
6525
  if (Array.isArray(a)) return Array.isArray(b) && a.length === b.length && a.every((v, i) => isJsonEqual(v, b[i]));
6508
- if (isRecord(a) && isRecord(b)) {
6526
+ if (isRecord$3(a) && isRecord$3(b)) {
6509
6527
  const keys = Object.keys(a);
6510
6528
  if (keys.length !== Object.keys(b).length) return false;
6511
6529
  return keys.every((k) => Object.prototype.hasOwnProperty.call(b, k) && isJsonEqual(a[k], b[k]));
@@ -6529,7 +6547,7 @@ function markerKeysOf(blob, owner) {
6529
6547
  }
6530
6548
  function nodeFromStored(value, owner) {
6531
6549
  if (isSecretMarker(value)) return isSecretRefOwnedBy(value.$secret, owner) ? { kind: "leaf" } : null;
6532
- if (!isRecord(value)) return null;
6550
+ if (!isRecord$3(value)) return null;
6533
6551
  const children = /* @__PURE__ */ new Map();
6534
6552
  for (const [key, child] of Object.entries(value)) {
6535
6553
  const node = nodeFromStored(child, owner);
@@ -6662,7 +6680,6 @@ function createHandle(raw, opts) {
6662
6680
  const writeAddon = (patch) => write("addon", opts.addonTree(), void 0, patch, () => readStoredAddonBlob(raw), (p) => raw.writeAddonStore(p));
6663
6681
  const readAddonStoreResult = raw.readAddonStoreResult;
6664
6682
  const readAddonStoreKeyResult = raw.readAddonStoreKeyResult;
6665
- const readDeviceStoreBatch = raw.readDeviceStoreBatch;
6666
6683
  const overrides = {
6667
6684
  readAddonStore: async () => resolveRead("addon", await raw.readAddonStore()),
6668
6685
  ...readAddonStoreResult !== void 0 ? { readAddonStoreResult: async () => {
@@ -6686,12 +6703,12 @@ function createHandle(raw, opts) {
6686
6703
  };
6687
6704
  } } : {},
6688
6705
  readDeviceStore: async (deviceId) => resolveRead(`device:${deviceId}`, await raw.readDeviceStore(deviceId)),
6689
- ...readDeviceStoreBatch !== void 0 ? { readDeviceStoreBatch: async (deviceIds) => {
6690
- const rows = await readDeviceStoreBatch.call(raw, deviceIds);
6706
+ readDeviceStoreBatch: async (deviceIds) => {
6707
+ const rows = await raw.readDeviceStoreBatch(deviceIds);
6691
6708
  const out = /* @__PURE__ */ new Map();
6692
6709
  for (const [deviceId, blob] of rows) out.set(deviceId, await resolveRead(`device:${deviceId}`, blob));
6693
6710
  return out;
6694
- } } : {},
6711
+ },
6695
6712
  writeAddonStore: async (patch) => {
6696
6713
  await writeAddon(patch);
6697
6714
  },
@@ -7318,7 +7335,7 @@ var BaseAddon = class {
7318
7335
  if (!ctx) return;
7319
7336
  const addonId = ctx.id;
7320
7337
  setImmediate(() => {
7321
- ctx.api.addons?.restartAddon?.mutate({ addonId }).then(() => {
7338
+ ctx.api.addons.restartAddon.mutate({ addonId }).then(() => {
7322
7339
  ctx.logger.info("addon auto-restart triggered by restart-required setting change", { meta: { changedFields: patchKeys.filter((k) => restartKeys.has(k)) } });
7323
7340
  }).catch((err) => {
7324
7341
  ctx.logger.error("addon auto-restart failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
@@ -7518,7 +7535,7 @@ var BaseAddon = class {
7518
7535
  return this._addonSecretTree;
7519
7536
  }
7520
7537
  deviceSecretTree() {
7521
- this._deviceSecretTree ??= secretTreeFromSchema(this.deviceSettingsSchema());
7538
+ this._deviceSecretTree ??= mergeSecretStatePaths(secretTreeFromSchema(this.deviceSettingsSchema()), this.secretStatePaths);
7522
7539
  return this._deviceSecretTree;
7523
7540
  }
7524
7541
  /**
@@ -7594,42 +7611,135 @@ var BaseAddon = class {
7594
7611
  this[timerOf] = timer;
7595
7612
  }
7596
7613
  /**
7597
- * Wrap `ctx.settings.readAddonStore()` with a short retry budget so a
7598
- * transient settings-store outage (mid-restart of sqlite-settings, tsx-watch
7599
- * swap, or any race where the SqliteSettingsBackend is between shutdown and
7600
- * re-initialize) doesn't propagate up into `initialize()` and leave the
7614
+ * Wrap `ctx.settings.readAddonStore()` with a retry budget so a transient
7615
+ * settings-store outage doesn't propagate up into `initialize()` and leave the
7601
7616
  * addon permanently broken.
7602
7617
  *
7603
- * Retry only the two known infra fingerprints. Anything else propagates so
7604
- * real bugs surface immediately. After the budget expires we fall back to
7605
- * `{}` (defaults) — the addon's first successful patch will rehydrate.
7618
+ * Two kinds of outage, two budgets:
7619
+ * - the store's own restart fingerprints (`SqliteSettingsBackend not
7620
+ * initialized`, `provider not available`): a short budget, then the addon
7621
+ * falls back to `{}` (defaults) - its first successful patch rehydrates;
7622
+ * - a TRANSPORT failure (the hub is restarting while this runner boots:
7623
+ * `discovery deadline exceeded`, `parent could not route`, a refused or
7624
+ * timed-out connection). Since D870 a runner's settings read THROWS instead
7625
+ * of answering `{}`, so without a budget a hub restart ends in a respawn
7626
+ * loop. A long, bounded budget; only after it the error propagates - the
7627
+ * addon never runs on defaults for a store it could not ask.
7628
+ * Anything else propagates immediately so real bugs surface.
7606
7629
  */
7607
7630
  async readAddonStoreWithRetry() {
7608
7631
  const settings = this.rawSettings();
7609
7632
  if (!settings) return {};
7610
- const delaysMs = [
7611
- 150,
7612
- 350,
7613
- 600,
7614
- 900
7615
- ];
7616
7633
  let lastErr;
7617
- for (let attempt = 0; attempt <= delaysMs.length; attempt++) try {
7634
+ for (let attempt = 0;; attempt++) try {
7618
7635
  const stored = await settings.readAddonStore() ?? {};
7619
7636
  this.settingsStoreReady = true;
7620
7637
  return stored;
7621
7638
  } catch (err) {
7622
7639
  lastErr = err;
7623
- const msg = err instanceof Error ? err.message : String(err);
7624
- if (!(msg.includes("SqliteSettingsBackend not initialized") || msg.includes("provider not available"))) throw err;
7625
- if (attempt === delaysMs.length) break;
7626
- await new Promise((r) => setTimeout(r, delaysMs[attempt]));
7640
+ const kind = classifyStoreError(err);
7641
+ if (kind === "permanent") throw err;
7642
+ const delay = (kind === "transport" ? TRANSPORT_RETRY_DELAYS_MS : RESTART_RETRY_DELAYS_MS)[attempt];
7643
+ if (delay === void 0) {
7644
+ if (kind === "transport") throw err;
7645
+ break;
7646
+ }
7647
+ await new Promise((r) => setTimeout(r, delay));
7627
7648
  }
7628
7649
  this.settingsStoreReady = false;
7629
7650
  this._ctx?.logger?.warn?.("readAddonStore: settings-store unavailable after retries — using defaults", { meta: { error: lastErr instanceof Error ? lastErr.message : String(lastErr) } });
7630
7651
  return {};
7631
7652
  }
7632
7653
  };
7654
+ /** The settings store's own restart fingerprints. */
7655
+ var RESTART_RETRY_DELAYS_MS = [
7656
+ 150,
7657
+ 350,
7658
+ 600,
7659
+ 900
7660
+ ];
7661
+ /** A hub restarting under a booting runner: ~100 s in total. */
7662
+ var TRANSPORT_RETRY_DELAYS_MS = [
7663
+ 150,
7664
+ 350,
7665
+ 600,
7666
+ 900,
7667
+ 2e3,
7668
+ 5e3,
7669
+ 1e4,
7670
+ 2e4,
7671
+ 3e4,
7672
+ 3e4
7673
+ ];
7674
+ var RESTART_FINGERPRINTS = ["SqliteSettingsBackend not initialized", "provider not available"];
7675
+ /** Node / socket error codes of a connection that did not happen or broke. */
7676
+ var TRANSPORT_CODES = new Set([
7677
+ "ECONNREFUSED",
7678
+ "ECONNRESET",
7679
+ "ETIMEDOUT",
7680
+ "EPIPE",
7681
+ "EHOSTUNREACH",
7682
+ "ENETUNREACH"
7683
+ ]);
7684
+ /** tRPC error codes that mean "the other side is not answering now", not "your call is wrong". */
7685
+ var UNAVAILABLE_TRPC_CODES = new Set([
7686
+ "TIMEOUT",
7687
+ "SERVICE_UNAVAILABLE",
7688
+ "BAD_GATEWAY",
7689
+ "GATEWAY_TIMEOUT"
7690
+ ]);
7691
+ /** The exact phrases OUR transport raises when it cannot reach the hub. */
7692
+ var TRANSPORT_PHRASES = [
7693
+ "discovery deadline exceeded",
7694
+ "parent could not route child unowned cap call",
7695
+ "UDS request timed out after",
7696
+ "channel closed"
7697
+ ];
7698
+ /** Moleculer error `type`s of a call that could not be served right now. */
7699
+ var MOLECULER_TRANSIENT_TYPES = new Set([
7700
+ "REQUEST_TIMEOUT",
7701
+ "SERVICE_NOT_FOUND",
7702
+ "SERVICE_NOT_AVAILABLE",
7703
+ "REQUEST_REJECTED",
7704
+ "BROKER_DISCONNECTED"
7705
+ ]);
7706
+ function stringProp(value, key) {
7707
+ if (typeof value !== "object" || value === null) return void 0;
7708
+ const found = Reflect.get(value, key);
7709
+ return typeof found === "string" ? found : void 0;
7710
+ }
7711
+ /** The code an error carries: its own, its cause's, or a tRPC `data.code`. */
7712
+ function errorCode(err) {
7713
+ const out = {};
7714
+ const cause = typeof err === "object" && err !== null ? Reflect.get(err, "cause") : void 0;
7715
+ const data = typeof err === "object" && err !== null ? Reflect.get(err, "data") : void 0;
7716
+ const node = stringProp(err, "code") ?? stringProp(cause, "code");
7717
+ if (node !== void 0) out.node = node;
7718
+ const trpc = stringProp(data, "code");
7719
+ if (trpc !== void 0) out.trpc = trpc;
7720
+ return out;
7721
+ }
7722
+ /**
7723
+ * Is a settings read failure worth retrying, and with which budget? Only
7724
+ * EXPLICIT signals count: a socket error code, a tRPC "unavailable" code, or
7725
+ * one of the exact phrases our own transport raises. A message that merely
7726
+ * contains "timed out" or "unreachable" is not evidence of anything, and
7727
+ * `settings store not wired` is a wiring bug that retrying cannot fix.
7728
+ */
7729
+ function classifyStoreError(err) {
7730
+ const message = err instanceof Error ? err.message : String(err);
7731
+ if (RESTART_FINGERPRINTS.some((f) => message.includes(f))) return "restart";
7732
+ const code = errorCode(err);
7733
+ if (code.node !== void 0 && TRANSPORT_CODES.has(code.node)) return "transport";
7734
+ if (code.trpc !== void 0 && UNAVAILABLE_TRPC_CODES.has(code.trpc)) return "transport";
7735
+ if (typeof err === "object" && err !== null) {
7736
+ if (Reflect.get(err, "retryable") === true) return "transport";
7737
+ const type = stringProp(err, "type");
7738
+ if (type !== void 0 && MOLECULER_TRANSIENT_TYPES.has(type)) return "transport";
7739
+ }
7740
+ if (TRANSPORT_PHRASES.some((f) => message.includes(f))) return "transport";
7741
+ return "permanent";
7742
+ }
7633
7743
  /**
7634
7744
  * Collect the keys of every field marked `perNode: true`, recursing into
7635
7745
  * layout containers (`group` fields and `sub-tabs` tabs) the same way
@@ -7719,6 +7829,156 @@ var PeerBytesTicketSchema = object({
7719
7829
  */
7720
7830
  declaredBytes: number().int().nonnegative().nullable()
7721
7831
  });
7832
+ /** Limits and names of `ctx.records` (D881). One authority; the engine and the facade read it. */
7833
+ /** The files a kind may live in. `history` is device-history's (D850), never records. */
7834
+ var RECORD_DATABASES = ["settings", "events"];
7835
+ /** The classes of a kind: the `@durable` vocabulary, one authority (replaces the annotation). */
7836
+ var RECORD_CLASSES = [
7837
+ "config",
7838
+ "ledger",
7839
+ "audit",
7840
+ "mirror",
7841
+ "ephemeral"
7842
+ ];
7843
+ var RECORD_DEFAULT_MAX_DATA_BYTES = 64 * 1024;
7844
+ var RECORD_MAX_DATA_BYTES = 1024 * 1024;
7845
+ var RECORD_BATCH_MAX = 1e3;
7846
+ var RECORD_QUERY_MAX = 1e3;
7847
+ function defOf(schema) {
7848
+ const zodBag = Reflect.get(schema, "_zod");
7849
+ if (typeof zodBag !== "object" || zodBag === null) return {};
7850
+ const def = Reflect.get(zodBag, "def");
7851
+ if (typeof def !== "object" || def === null) return {};
7852
+ return def;
7853
+ }
7854
+ function declaredHere(schema) {
7855
+ return globalRegistry.get(schema)?.secret === true;
7856
+ }
7857
+ /** Wrapper kinds whose `innerType` is the field itself. */
7858
+ var WRAPPERS = new Set([
7859
+ "optional",
7860
+ "nullable",
7861
+ "default",
7862
+ "prefault",
7863
+ "catch",
7864
+ "readonly",
7865
+ "nonoptional"
7866
+ ]);
7867
+ /**
7868
+ * The schema layers that make up ONE field: the schema itself and every
7869
+ * wrapper below it (optional / default / nullable / readonly / catch), plus
7870
+ * both sides of a pipe (`z.preprocess` puts the real schema on `out`,
7871
+ * `.transform` on `in`).
7872
+ */
7873
+ function layersOf(schema) {
7874
+ const out = [];
7875
+ const queue = [schema];
7876
+ while (queue.length > 0) {
7877
+ const s = queue.shift();
7878
+ if (!s || out.includes(s)) continue;
7879
+ out.push(s);
7880
+ const def = defOf(s);
7881
+ if (def.type !== void 0 && WRAPPERS.has(def.type) && def.innerType) queue.push(def.innerType);
7882
+ if (def.type === "pipe") {
7883
+ if (def.in) queue.push(def.in);
7884
+ if (def.out) queue.push(def.out);
7885
+ }
7886
+ }
7887
+ return out;
7888
+ }
7889
+ /** True when any layer of this field declares `.meta({ secret: true })`. */
7890
+ function isZodSecret(schema) {
7891
+ return layersOf(schema).some(declaredHere);
7892
+ }
7893
+ /**
7894
+ * Every declared secret path in a config schema: dotted keys, `[]` for "each
7895
+ * element of this array" (`connection.password`, `rows[].token`). A declared
7896
+ * object or array is reported as one path and not descended into — everything
7897
+ * under it is secret.
7898
+ */
7899
+ function collectZodSecretPaths(schema, prefix = "") {
7900
+ if (isZodSecret(schema)) return prefix.length > 0 ? [prefix] : [];
7901
+ const paths = [];
7902
+ for (const layer of layersOf(schema)) {
7903
+ const def = defOf(layer);
7904
+ if (def.type === "object" && def.shape) for (const [key, child] of Object.entries(def.shape)) paths.push(...collectZodSecretPaths(child, prefix ? `${prefix}.${key}` : key));
7905
+ else if (def.type === "array" && def.element) paths.push(...collectZodSecretPaths(def.element, `${prefix}[]`));
7906
+ else if (def.type === "union" && def.options) for (const option of def.options) paths.push(...collectZodSecretPaths(option, prefix));
7907
+ else if (def.type === "intersection") {
7908
+ if (def.left) paths.push(...collectZodSecretPaths(def.left, prefix));
7909
+ if (def.right) paths.push(...collectZodSecretPaths(def.right, prefix));
7910
+ }
7911
+ }
7912
+ return [...new Set(paths)];
7913
+ }
7914
+ /**
7915
+ * Record kinds (D881): the declaration an addon makes of one kind of fact, the
7916
+ * Zod row schema that describes it, and the helper that turns the two into the
7917
+ * JSON the engine stores.
7918
+ *
7919
+ * A kind is declared ONCE, next to the code that owns it, and the engine's
7920
+ * reconciler creates its indexes - nothing creates DDL at runtime from a write.
7921
+ * Everything the generic machinery needs (secret fields, the entry descriptor)
7922
+ * is DERIVED from the Zod schema: `.meta({ secret: true })` marks a credential,
7923
+ * never a field name (D879).
7924
+ */
7925
+ /** A JSON field path: `trackId`, `auth.accessToken`. Charset-restricted: it is rendered into DDL. */
7926
+ var RecordFieldPathSchema = string().regex(/^[A-Za-z_][A-Za-z0-9_]{0,63}(\.[A-Za-z_][A-Za-z0-9_]{0,63}){0,3}$/);
7927
+ var RecordIndexSchema = object({
7928
+ name: string().regex(/^[a-z][a-z0-9_]{0,31}$/),
7929
+ fields: array(RecordFieldPathSchema).min(1).max(4),
7930
+ unique: boolean().optional()
7931
+ }).strict();
7932
+ var RecordRetentionSchema = union([
7933
+ object({
7934
+ ttlMs: number().int().positive(),
7935
+ from: _enum(["at", "write"])
7936
+ }).strict(),
7937
+ object({
7938
+ maxRows: number().int().positive().optional(),
7939
+ maxRowsPerDevice: number().int().positive().optional()
7940
+ }).strict().refine((r) => r.maxRows !== void 0 || r.maxRowsPerDevice !== void 0, { message: "name maxRows, maxRowsPerDevice or both" }),
7941
+ object({
7942
+ owner: string().min(1),
7943
+ reason: string().min(1)
7944
+ }).strict(),
7945
+ object({ none: string().min(1) }).strict()
7946
+ ]);
7947
+ /** The descriptor a generic entries UI reads (D881 "generic entries"). */
7948
+ var EntryDescriptorSchema = object({
7949
+ title: string().min(1),
7950
+ /** The record body field shown as the entry's name. */
7951
+ nameField: string().min(1),
7952
+ /** JSON Schema of the entry body; `secret: true` marks a password field. */
7953
+ fields: record(string(), unknown())
7954
+ }).strict();
7955
+ /** What crosses the wire and sits in the engine's catalog: JSON only, no Zod. */
7956
+ var RecordKindDeclarationSchema = object({
7957
+ database: _enum(RECORD_DATABASES).default("settings"),
7958
+ class: _enum(RECORD_CLASSES),
7959
+ writeTrigger: string().min(1),
7960
+ device: _enum([
7961
+ "required",
7962
+ "optional",
7963
+ "none"
7964
+ ]).default("none"),
7965
+ at: _enum(["required", "none"]).default("none"),
7966
+ indexes: array(RecordIndexSchema).max(8).default([]),
7967
+ retention: RecordRetentionSchema,
7968
+ deviceRemoval: _enum(["delete", "none"]).default("none"),
7969
+ maxDataBytes: number().int().positive().max(RECORD_MAX_DATA_BYTES).default(RECORD_DEFAULT_MAX_DATA_BYTES),
7970
+ /** Derived from the Zod schema; never written by hand. */
7971
+ secretPaths: array(string().min(1)).default([]),
7972
+ /** The id key of each array that carries a secret (`{ headers: 'name' }`). */
7973
+ secretArrayKeys: record(string(), string()).default({}),
7974
+ /** The legacy table this kind adopts from; the boot guard reads it (D853: no migration code). */
7975
+ adoptsFrom: string().min(1).optional(),
7976
+ /** Kinds that must agree through `transact` sit in one file under one family name. */
7977
+ transactFamily: string().min(1).optional(),
7978
+ entry: EntryDescriptorSchema.optional()
7979
+ }).strict();
7980
+ /** The kind names: lower-case, dash separated, short enough for an index name. */
7981
+ var RecordKindNameSchema = string().regex(/^[a-z][a-z0-9-]{0,47}$/);
7722
7982
  /** Shared Zod schemas used across streaming capabilities. */
7723
7983
  var CamProfileSchema = _enum([
7724
7984
  "high",
@@ -8183,69 +8443,6 @@ method(object({ deviceId: number() }), array(StreamSourceEntrySchema)), method(o
8183
8443
  kind: "mutation",
8184
8444
  auth: "admin"
8185
8445
  }), method(object({ deviceId: number() }), unknown().nullable()), method(object({ deviceId: number() }), RawStateResultSchema.nullable(), { auth: "protected" });
8186
- function defOf(schema) {
8187
- return schema._zod?.def ?? {};
8188
- }
8189
- function declaredHere(schema) {
8190
- return globalRegistry.get(schema)?.secret === true;
8191
- }
8192
- /** Wrapper kinds whose `innerType` is the field itself. */
8193
- var WRAPPERS = new Set([
8194
- "optional",
8195
- "nullable",
8196
- "default",
8197
- "prefault",
8198
- "catch",
8199
- "readonly",
8200
- "nonoptional"
8201
- ]);
8202
- /**
8203
- * The schema layers that make up ONE field: the schema itself and every
8204
- * wrapper below it (optional / default / nullable / readonly / catch), plus
8205
- * both sides of a pipe (`z.preprocess` puts the real schema on `out`,
8206
- * `.transform` on `in`).
8207
- */
8208
- function layersOf(schema) {
8209
- const out = [];
8210
- const queue = [schema];
8211
- while (queue.length > 0) {
8212
- const s = queue.shift();
8213
- if (!s || out.includes(s)) continue;
8214
- out.push(s);
8215
- const def = defOf(s);
8216
- if (def.type !== void 0 && WRAPPERS.has(def.type) && def.innerType) queue.push(def.innerType);
8217
- if (def.type === "pipe") {
8218
- if (def.in) queue.push(def.in);
8219
- if (def.out) queue.push(def.out);
8220
- }
8221
- }
8222
- return out;
8223
- }
8224
- /** True when any layer of this field declares `.meta({ secret: true })`. */
8225
- function isZodSecret(schema) {
8226
- return layersOf(schema).some(declaredHere);
8227
- }
8228
- /**
8229
- * Every declared secret path in a config schema: dotted keys, `[]` for "each
8230
- * element of this array" (`connection.password`, `rows[].token`). A declared
8231
- * object or array is reported as one path and not descended into — everything
8232
- * under it is secret.
8233
- */
8234
- function collectZodSecretPaths(schema, prefix = "") {
8235
- if (isZodSecret(schema)) return prefix.length > 0 ? [prefix] : [];
8236
- const paths = [];
8237
- for (const layer of layersOf(schema)) {
8238
- const def = defOf(layer);
8239
- if (def.type === "object" && def.shape) for (const [key, child] of Object.entries(def.shape)) paths.push(...collectZodSecretPaths(child, prefix ? `${prefix}.${key}` : key));
8240
- else if (def.type === "array" && def.element) paths.push(...collectZodSecretPaths(def.element, `${prefix}[]`));
8241
- else if (def.type === "union" && def.options) for (const option of def.options) paths.push(...collectZodSecretPaths(option, prefix));
8242
- else if (def.type === "intersection") {
8243
- if (def.left) paths.push(...collectZodSecretPaths(def.left, prefix));
8244
- if (def.right) paths.push(...collectZodSecretPaths(def.right, prefix));
8245
- }
8246
- }
8247
- return [...new Set(paths)];
8248
- }
8249
8446
  object({
8250
8447
  code: string().regex(/^[a-z][a-z0-9-]*(\.[a-z0-9-]+)+$/),
8251
8448
  params: record(string(), union([string(), number()])).optional()
@@ -8340,7 +8537,7 @@ function maskUrlCredentials(rawUrl) {
8340
8537
  }
8341
8538
  }
8342
8539
  //#endregion
8343
- //#region ../types/dist/err-msg-DLerKiVO.mjs
8540
+ //#region ../types/dist/err-msg-BXKzRBwg.mjs
8344
8541
  var DeviceType = /* @__PURE__ */ function(DeviceType) {
8345
8542
  DeviceType["Camera"] = "camera";
8346
8543
  DeviceType["Hub"] = "hub";
@@ -8432,6 +8629,10 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
8432
8629
  * native PetKit (`nodepetkit` `FeederDevice`), reusable by other feeder
8433
8630
  * integrations sharing the same food/desiccant/hopper surface. */
8434
8631
  DeviceType["PetFeeder"] = "pet-feeder";
8632
+ /** Built-in dishwasher — program lifecycle, door / remote-start gates,
8633
+ * salt and rinse-aid levels. Installed with the `dishwasher` cap.
8634
+ * Sources: native Bosch Home Connect, reusable by similar integrations. */
8635
+ DeviceType["Dishwasher"] = "dishwasher";
8435
8636
  return DeviceType;
8436
8637
  }({});
8437
8638
  var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
@@ -8609,6 +8810,9 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
8609
8810
  /** Virtual HA toggle (input_boolean.*) — distinguishable from a
8610
8811
  * real Switch device for UI rendering / export adapters. */
8611
8812
  DeviceRole["BinaryHelper"] = "binary-helper";
8813
+ /** A smart plug: a `switch` whose source says it is an outlet (HA
8814
+ * `device_class: outlet`). The Alexa export shows it as a SMARTPLUG. */
8815
+ DeviceRole["Outlet"] = "outlet";
8612
8816
  /** Generic motion / occupancy / moving event source. Distinct from
8613
8817
  * the camera accessory PirSensor role: that one is a camera child;
8614
8818
  * this is a standalone HA / 3rd-party motion sensor. */
@@ -8686,7 +8890,7 @@ function errMsg(err) {
8686
8890
  return String(err);
8687
8891
  }
8688
8892
  //#endregion
8689
- //#region ../types/dist/composition-EQ9Ok0Ee.mjs
8893
+ //#region ../types/dist/composition-CB6PMT9p.mjs
8690
8894
  /**
8691
8895
  * The ffmpeg build every CamStack node downloads, per platform and arch.
8692
8896
  *
@@ -11922,11 +12126,10 @@ var ClipModelMetaSchema = object({
11922
12126
  /**
11923
12127
  * The `vector-store` index this model's vectors live in. ONE feature space
11924
12128
  * per index: two models share an index only when their vectors are ranked
11925
- * against each other, which for CLIP means never across families. MobileCLIP
11926
- * S1 and S2 share `object-clip` for history (separated by the row's
11927
- * `modelId`); any other model gets its own.
12129
+ * against each other, which for CLIP means never across families. Every
12130
+ * model gets its own.
11928
12131
  */
11929
- vectorIndex: string().regex(/^object-clip(-[a-z0-9][a-z0-9-]*)?$/),
12132
+ vectorIndex: string().regex(/^object-clip-[a-z0-9][a-z0-9-]*$/),
11930
12133
  /**
11931
12134
  * The text encoder's tokenizer, a declared SIBLING file of its onnx. The name
11932
12135
  * must be unique per tokenizer: every model's siblings land in ONE flat
@@ -13105,8 +13308,13 @@ var AlertSeveritySchema = _enum([
13105
13308
  "info",
13106
13309
  "success",
13107
13310
  "warning",
13108
- "error"
13311
+ "error",
13312
+ "critical"
13109
13313
  ]);
13314
+ var AlertActionSchema = object({
13315
+ label: string(),
13316
+ href: string().optional()
13317
+ });
13110
13318
  var AlertStatusSchema = _enum([
13111
13319
  "active",
13112
13320
  "in-progress",
@@ -13124,6 +13332,7 @@ var AlertSchema = object({
13124
13332
  severity: AlertSeveritySchema,
13125
13333
  title: string(),
13126
13334
  message: string(),
13335
+ action: AlertActionSchema.optional(),
13127
13336
  status: AlertStatusSchema,
13128
13337
  progress: number().optional(),
13129
13338
  read: boolean(),
@@ -15659,6 +15868,41 @@ var ComposableCapabilitiesSchema = object({ caps: array(object({
15659
15868
  keyField: string()
15660
15869
  }).optional()
15661
15870
  })) });
15871
+ /**
15872
+ * The report of a one-shot "move this owner's plaintext secrets into the
15873
+ * keychain" run (D878). COUNTS only - never a value, never a ref.
15874
+ *
15875
+ * The owner runs it on its own rows, through its own write path; an operator
15876
+ * script (`scripts/hub/migrate-raw-secrets.ts`) calls the owner's cap method.
15877
+ * Dry run (`apply: false`) reports what WOULD move and changes nothing.
15878
+ */
15879
+ var RawSecretMigrationInputSchema = object({
15880
+ /** `false` (the default of the script) = report only. */
15881
+ apply: boolean() });
15882
+ var RawSecretMigrationReportSchema = object({
15883
+ apply: boolean(),
15884
+ /** Rows that can carry a secret (a profile, an enrolment). */
15885
+ rows: number().int(),
15886
+ /** Rows whose secret was plaintext when the run started. */
15887
+ raw: number().int(),
15888
+ /** Rows that already held a keychain marker when the run started. */
15889
+ markers: number().int(),
15890
+ /** Plaintext rows moved by THIS run (always 0 on a dry run). */
15891
+ migrated: number().int(),
15892
+ /** Plaintext rows left in place because the move or its read-back failed. */
15893
+ failed: number().int(),
15894
+ /** After the run: rows still holding plaintext. */
15895
+ remainingRaw: number().int(),
15896
+ /** After the run: markers the keychain could not resolve right now. */
15897
+ unresolvedMarkers: number().int(),
15898
+ /**
15899
+ * A second, redundant copy of the secrets' rows that the run found (and, on
15900
+ * `apply`, deleted after verifying the first). Owners with a single copy omit it.
15901
+ */
15902
+ redundantCopies: number().int().optional(),
15903
+ /** True when nothing is raw and every marker resolves. */
15904
+ verified: boolean()
15905
+ });
15662
15906
  /** Where a block runs. The operator chooses — a block driving a device on an
15663
15907
  * agent is the reason placement is not fixed to the hub. */
15664
15908
  var CoreBlockPlacementSchema = union([literal("hub"), string().min(1)]);
@@ -15885,6 +16129,9 @@ method(object({}), object({ blocks: array(CoreBlockSchema) }), { auth: "admin" }
15885
16129
  }), SettingsUpdateResultSchema, {
15886
16130
  kind: "mutation",
15887
16131
  auth: "admin"
16132
+ }), method(RawSecretMigrationInputSchema, RawSecretMigrationReportSchema, {
16133
+ kind: "mutation",
16134
+ auth: "admin"
15888
16135
  }), method(object({}), object({ libs: array(object({
15889
16136
  filePath: string(),
15890
16137
  content: string()
@@ -16148,6 +16395,347 @@ id: union([string(), number()]) }), {
16148
16395
  auth: "admin"
16149
16396
  });
16150
16397
  /**
16398
+ * records - an addon's own facts and documents (D881): ledgers, audit rows,
16399
+ * config documents, mirrors. The third storage API next to `ctx.settings`
16400
+ * (operator intent, D870) and device-history (numbers over time, D850).
16401
+ *
16402
+ * Who the OWNER is: `callerAddonId`, stamped by the transport on a call that
16403
+ * crossed a process and stated by a hub in-process caller (`ctx.records` does
16404
+ * that with the addon id closed over). It is deliberately NOT in any input
16405
+ * schema, so a session can never supply it, and a call with no stamp is refused
16406
+ * `records/no-caller`. A kind is readable and writable only by its owner; other
16407
+ * addons go through the owner's capability.
16408
+ *
16409
+ * Every read is three-way: a row, `null`, or the call THROWS. A failed read is
16410
+ * never `[]`. Secret fields are never on the wire: a read shows the
16411
+ * redaction token, `secretRefs` hands the owner's `ctx.secrets` the refs it
16412
+ * resolves itself, and a write may carry only a keychain marker bound to the
16413
+ * row's own ref.
16414
+ *
16415
+ * Internal: addons reach it through `ctx.records`, never directly.
16416
+ */
16417
+ var RecordIdSchema = string().min(1).max(256);
16418
+ /** A JSON object body. Size is the engine's check (`maxDataBytes`), not a schema's. */
16419
+ var RecordBodySchema = record(string(), unknown());
16420
+ var RecordInputSchema = object({
16421
+ id: RecordIdSchema,
16422
+ /** The device this row belongs to (D865 removal, per-device reads). */
16423
+ deviceId: number().int().optional(),
16424
+ /** The domain clock, ms: observed / created / opened. */
16425
+ at: number().int().optional(),
16426
+ /** Producer-set expiry, ms. Refused on a kind whose retention is an engine TTL. */
16427
+ expiresAt: number().int().optional(),
16428
+ data: RecordBodySchema
16429
+ });
16430
+ var RecordViewSchema = object({
16431
+ id: string(),
16432
+ deviceId: number().int().nullable(),
16433
+ at: number().nullable(),
16434
+ expiresAt: number().nullable(),
16435
+ rev: number().int(),
16436
+ updatedAt: number(),
16437
+ data: RecordBodySchema
16438
+ });
16439
+ /** Declared index fields only. Anything else does not compile, by design. */
16440
+ var RecordWhereSchema = record(RecordFieldPathSchema, union([
16441
+ string(),
16442
+ number(),
16443
+ boolean(),
16444
+ object({ in: array(union([
16445
+ string(),
16446
+ number(),
16447
+ boolean()
16448
+ ])).min(1).max(RECORD_BATCH_MAX) }),
16449
+ object({
16450
+ gt: union([string(), number()]).optional(),
16451
+ gte: union([string(), number()]).optional(),
16452
+ lt: union([string(), number()]).optional(),
16453
+ lte: union([string(), number()]).optional()
16454
+ }).refine((r) => Object.keys(r).length > 0, { message: "name at least one bound" })
16455
+ ]));
16456
+ var KindShape = { kind: RecordKindNameSchema };
16457
+ var TimeWindowShape = {
16458
+ deviceId: number().int().optional(),
16459
+ atFrom: number().optional(),
16460
+ atTo: number().optional()
16461
+ };
16462
+ var RecordQueryInputSchema = object({
16463
+ ...KindShape,
16464
+ ...TimeWindowShape,
16465
+ where: RecordWhereSchema.optional(),
16466
+ /** Without `where`: `at` (default for a kind with a clock) or `id`. With `where` the order is the index's. */
16467
+ order: _enum(["at", "id"]).optional(),
16468
+ desc: boolean().optional(),
16469
+ limit: number().int().min(1).max(RECORD_QUERY_MAX).default(100),
16470
+ /** Opaque keyset cursor from a previous answer. There is no offset. */
16471
+ cursor: string().min(1).optional()
16472
+ });
16473
+ var RecordQueryResultSchema = object({
16474
+ records: array(RecordViewSchema),
16475
+ nextCursor: string().nullable()
16476
+ });
16477
+ var RecordKindStateSchema = _enum([
16478
+ "created",
16479
+ "unchanged",
16480
+ "updated"
16481
+ ]);
16482
+ var DeclareKindResultSchema = object({
16483
+ kindId: number().int(),
16484
+ state: RecordKindStateSchema,
16485
+ createdIndexes: array(string()),
16486
+ /** The boot guard: the kind is empty while its legacy table still holds rows. */
16487
+ adoptionPending: object({
16488
+ legacyTable: string(),
16489
+ legacyRows: number().int()
16490
+ }).nullable()
16491
+ });
16492
+ /** Keychain refs a write released (the old marker is gone from the row): the owner deletes the values. */
16493
+ var SecretRefsList = array(string());
16494
+ var RecordSecretRefsSchema = record(string(), record(string(), string()));
16495
+ method(object({ kinds: record(RecordKindNameSchema, RecordKindDeclarationSchema) }), object({ kinds: record(string(), DeclareKindResultSchema) }), {
16496
+ kind: "mutation",
16497
+ auth: "admin"
16498
+ }), method(object({
16499
+ ...KindShape,
16500
+ id: RecordIdSchema
16501
+ }), RecordViewSchema.nullable(), { auth: "admin" }), method(object({
16502
+ ...KindShape,
16503
+ ids: array(RecordIdSchema).min(1).max(RECORD_BATCH_MAX)
16504
+ }), array(RecordViewSchema), { auth: "admin" }), method(object({
16505
+ ...KindShape,
16506
+ ids: array(RecordIdSchema).min(1).max(RECORD_BATCH_MAX)
16507
+ }), RecordSecretRefsSchema, { auth: "admin" }), method(object({
16508
+ ...KindShape,
16509
+ record: RecordInputSchema,
16510
+ /** Compare-and-set. `0` means "the row must not exist". */
16511
+ ifRev: number().int().min(0).optional()
16512
+ }), object({
16513
+ rev: number().int(),
16514
+ releasedRefs: SecretRefsList
16515
+ }), {
16516
+ kind: "mutation",
16517
+ auth: "admin"
16518
+ }), method(object({
16519
+ ...KindShape,
16520
+ records: array(RecordInputSchema).min(1).max(RECORD_BATCH_MAX)
16521
+ }), object({
16522
+ count: number().int(),
16523
+ releasedRefs: SecretRefsList
16524
+ }), {
16525
+ kind: "mutation",
16526
+ auth: "admin"
16527
+ }), method(object({
16528
+ ...KindShape,
16529
+ id: RecordIdSchema,
16530
+ data: RecordBodySchema,
16531
+ at: number().int().nullable().optional(),
16532
+ expiresAt: number().int().nullable().optional(),
16533
+ ifRev: number().int().min(1).optional()
16534
+ }), object({
16535
+ rev: number().int(),
16536
+ releasedRefs: SecretRefsList
16537
+ }), {
16538
+ kind: "mutation",
16539
+ auth: "admin"
16540
+ }), method(object({
16541
+ ...KindShape,
16542
+ id: RecordIdSchema
16543
+ }), object({
16544
+ deleted: boolean(),
16545
+ secretRefs: SecretRefsList
16546
+ }), {
16547
+ kind: "mutation",
16548
+ auth: "admin"
16549
+ }), method(object({
16550
+ ...KindShape,
16551
+ ids: array(RecordIdSchema).min(1).max(RECORD_BATCH_MAX)
16552
+ }), object({
16553
+ deleted: number().int(),
16554
+ secretRefs: SecretRefsList
16555
+ }), {
16556
+ kind: "mutation",
16557
+ auth: "admin"
16558
+ }), method(RecordQueryInputSchema, RecordQueryResultSchema, { auth: "admin" }), method(object({
16559
+ ...KindShape,
16560
+ ...TimeWindowShape,
16561
+ where: RecordWhereSchema.optional()
16562
+ }), object({ count: number().int() }), { auth: "admin" }), method(object({
16563
+ ...KindShape,
16564
+ deviceId: number().int().optional(),
16565
+ from: number(),
16566
+ to: number(),
16567
+ bucketMs: number().int().positive()
16568
+ }), object({ buckets: array(object({
16569
+ bucketStart: number(),
16570
+ count: number().int()
16571
+ })) }), { auth: "admin" }), method(object({
16572
+ ...KindShape,
16573
+ op: _enum([
16574
+ "sum",
16575
+ "min",
16576
+ "max",
16577
+ "count"
16578
+ ]),
16579
+ field: RecordFieldPathSchema.optional(),
16580
+ groupBy: RecordFieldPathSchema.optional(),
16581
+ where: RecordWhereSchema.optional()
16582
+ }), object({ rows: array(object({
16583
+ group: union([
16584
+ string(),
16585
+ number(),
16586
+ _null()
16587
+ ]),
16588
+ value: number().nullable()
16589
+ })) }), { auth: "admin" }), method(object({
16590
+ ...KindShape,
16591
+ deviceId: number().int().optional(),
16592
+ atBefore: number().optional(),
16593
+ where: RecordWhereSchema.optional()
16594
+ }), object({
16595
+ deleted: number().int(),
16596
+ secretRefs: SecretRefsList
16597
+ }), {
16598
+ kind: "mutation",
16599
+ auth: "admin"
16600
+ }), method(object({
16601
+ deviceId: number().int(),
16602
+ kinds: array(RecordKindNameSchema).optional()
16603
+ }), object({
16604
+ deleted: record(string(), number().int()),
16605
+ secretRefs: SecretRefsList
16606
+ }), {
16607
+ kind: "mutation",
16608
+ auth: "admin"
16609
+ }), method(object(KindShape), object({ id: number().int() }), {
16610
+ kind: "mutation",
16611
+ auth: "admin"
16612
+ });
16613
+ /** One table of the settings database. */
16614
+ var StorageTableSchema = object({
16615
+ /** The table's full name, e.g. `recorder:addon-settings` or `addon-device-settings`. */
16616
+ name: string(),
16617
+ /** The owner prefix of a scoped name (`recorder` for `recorder:addon-settings`), else null. */
16618
+ owner: string().nullable(),
16619
+ rows: number().int().nonnegative(),
16620
+ /** Bytes the table's pages occupy (`dbstat`); null when the engine cannot measure. */
16621
+ bytes: number().int().nonnegative().nullable(),
16622
+ /** Declared by an addon since this engine process started (a running addon claims it). */
16623
+ declaredThisBoot: boolean()
16624
+ });
16625
+ /** One declared record kind (D881) as System -> Data shows it. */
16626
+ var StorageKindSchema = object({
16627
+ owner: string(),
16628
+ kind: string(),
16629
+ database: _enum(["settings", "events"]),
16630
+ class: string(),
16631
+ state: _enum([
16632
+ "declared",
16633
+ "orphaned",
16634
+ "dropped"
16635
+ ]),
16636
+ /** `null` when the caller asked for no counts (`counts: false`). */
16637
+ rows: number().int().nonnegative().nullable(),
16638
+ /** Rows x the average size of a sample; null for an empty kind. */
16639
+ bytesEstimate: number().int().nonnegative().nullable(),
16640
+ writeTrigger: string(),
16641
+ retention: RecordRetentionSchema,
16642
+ /** `true` when the kind is an entry kind (the generic entries UI lists it). */
16643
+ entry: boolean(),
16644
+ /** The whole declaration, secret paths and entry descriptor included (the entries service builds its handle from it). */
16645
+ declaration: RecordKindDeclarationSchema
16646
+ });
16647
+ method(object({ ownerPrefix: string().min(1).optional() }), object({ tables: array(StorageTableSchema) }), { auth: "admin" }), method(object({
16648
+ collection: string().min(1),
16649
+ expectRows: number().int().nonnegative()
16650
+ }), object({
16651
+ dropped: literal(true),
16652
+ rows: number().int().nonnegative()
16653
+ }), {
16654
+ kind: "mutation",
16655
+ auth: "admin"
16656
+ }), method(object({
16657
+ owner: string().min(1).optional(),
16658
+ /** `false` skips the per-kind row count (a catalog read only). Default true. */
16659
+ counts: boolean().optional()
16660
+ }), object({ kinds: array(StorageKindSchema) }), { auth: "admin" }), method(RecordQueryInputSchema.extend({
16661
+ owner: string().min(1),
16662
+ kind: RecordKindNameSchema
16663
+ }), RecordQueryResultSchema, { auth: "admin" }), method(object({
16664
+ owner: string().min(1),
16665
+ kind: RecordKindNameSchema,
16666
+ records: array(RecordInputSchema).max(RECORD_BATCH_MAX),
16667
+ /** The LAST batch: the copy is complete, the boot guard stops asking. */
16668
+ complete: boolean().optional()
16669
+ }).refine((input) => input.records.length > 0 || input.complete === true, { message: "records must be non-empty unless complete is true" }), object({ adopted: number().int() }), {
16670
+ kind: "mutation",
16671
+ auth: "admin"
16672
+ }), method(object({
16673
+ collection: string().min(1),
16674
+ cursor: string().optional(),
16675
+ limit: number().int().min(1).max(1e3).optional()
16676
+ }), object({
16677
+ rows: array(object({
16678
+ id: string(),
16679
+ data: record(string(), unknown())
16680
+ })),
16681
+ nextCursor: string().nullable()
16682
+ }), { auth: "admin" }), method(object({ collection: string().min(1) }), object({ adopted: boolean() }), { auth: "admin" });
16683
+ /**
16684
+ * record-entries - the ONE admin surface for every list of user-created entries
16685
+ * (D881): notification targets, brokers, LLM profiles, anything an addon
16686
+ * declares as an ENTRY kind (`entry: { title }` in `defineRecordKinds`).
16687
+ *
16688
+ * The UI is generic. `listEntryKinds` hands it, per kind, the JSON Schema of
16689
+ * the entry body with `secret: true` on every credential field, so a password
16690
+ * field is derived from the schema and never from a name. `putEntry` takes the
16691
+ * redaction token for an untouched secret (the stored value is kept), a string
16692
+ * for a new one, and the clear instruction to remove one. A read never carries
16693
+ * a secret value, and a locked keychain refuses the write with
16694
+ * `records/secret-unavailable` instead of storing plaintext.
16695
+ *
16696
+ * Hub-only, served in-process (it acts for each entry's owner on the keychain).
16697
+ */
16698
+ var EntryKindInfoSchema = object({
16699
+ owner: string(),
16700
+ kind: RecordKindNameSchema,
16701
+ title: string(),
16702
+ nameField: string(),
16703
+ /** JSON Schema of the body; `secret: true` marks a password field. */
16704
+ fields: record(string(), unknown()),
16705
+ secretPaths: array(string()),
16706
+ rows: number().int().nonnegative()
16707
+ });
16708
+ var EntryViewSchema = object({
16709
+ id: RecordIdSchema,
16710
+ name: string(),
16711
+ rev: number().int(),
16712
+ updatedAt: number(),
16713
+ /** Secret fields hold the redaction token. */
16714
+ data: RecordBodySchema
16715
+ });
16716
+ var EntryAddress = {
16717
+ owner: string().min(1),
16718
+ kind: RecordKindNameSchema
16719
+ };
16720
+ method(object({}), object({ kinds: array(EntryKindInfoSchema) }), { auth: "admin" }), method(object({ ...EntryAddress }), object({ entries: array(EntryViewSchema) }), { auth: "admin" }), method(object({
16721
+ ...EntryAddress,
16722
+ id: RecordIdSchema.optional(),
16723
+ data: RecordBodySchema,
16724
+ ifRev: number().int().min(1).optional()
16725
+ }), object({
16726
+ id: string(),
16727
+ rev: number().int()
16728
+ }), {
16729
+ kind: "mutation",
16730
+ auth: "admin"
16731
+ }), method(object({
16732
+ ...EntryAddress,
16733
+ id: RecordIdSchema
16734
+ }), object({ deleted: boolean() }), {
16735
+ kind: "mutation",
16736
+ auth: "admin"
16737
+ });
16738
+ /**
16151
16739
  * `keychain` — the hub's encrypted store of secret values (D787).
16152
16740
  *
16153
16741
  * Settings blobs never hold a secret: they hold a marker
@@ -16688,6 +17276,16 @@ method(object({}), KeychainStatusSchema, { auth: "admin" }), method(object({}),
16688
17276
  kind: "mutation",
16689
17277
  auth: "admin",
16690
17278
  caller: "required"
17279
+ }), method(object({
17280
+ ref: string().min(1),
17281
+ value: string().min(1)
17282
+ }), object({
17283
+ ref: string(),
17284
+ version: number().int()
17285
+ }), {
17286
+ kind: "mutation",
17287
+ auth: "admin",
17288
+ caller: "required"
16691
17289
  }), method(object({ refs: array(string().min(1)).max(1e3) }), object({
16692
17290
  deleted: array(string()).readonly(),
16693
17291
  kept: array(object({
@@ -39349,6 +39947,9 @@ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, {
39349
39947
  }), _void(), { kind: "mutation" }), method(object({}), array(LlmProfileKindDescriptorSchema)), method(object({}), array(LlmProfileSchema)), method(object({ profile: LlmProfileSchema }), LlmProfileSchema, {
39350
39948
  kind: "mutation",
39351
39949
  auth: "admin"
39950
+ }), method(RawSecretMigrationInputSchema, RawSecretMigrationReportSchema, {
39951
+ kind: "mutation",
39952
+ auth: "admin"
39352
39953
  }), method(ProfileRefInputSchema, _void(), {
39353
39954
  kind: "mutation",
39354
39955
  auth: "admin"
@@ -49858,6 +50459,41 @@ var ServerRollbackInfoSchema = object({
49858
50459
  atMs: number(),
49859
50460
  reason: string()
49860
50461
  });
50462
+ /**
50463
+ * The runner boot check (D877): the runners this node PLANNED (hub: one per
50464
+ * `resolveRunnerId` over its forked addons; agent: the runners its process
50465
+ * service holds, because only the hub plans) against the states the process
50466
+ * service reports. Kept in memory, recomputed by the same one-shot check after
50467
+ * every boot, served on `getServerPackageStatus`.
50468
+ *
50469
+ * `failed` is the D6 breaker's terminal state, `refused` a deterministic Init
50470
+ * refusal (an addon that said "I will not start, and here is why"), `missing` a
50471
+ * planned runner the process service has no entry for.
50472
+ */
50473
+ var RunnerRefusalSchema = object({
50474
+ runnerId: string(),
50475
+ addonIds: array(string()),
50476
+ reason: string()
50477
+ });
50478
+ var RunnerBootCheckSchema = object({
50479
+ checkedAtMs: number(),
50480
+ /** Runners planned for this node. */
50481
+ expected: number(),
50482
+ /** Planned runners whose process is `running`. */
50483
+ running: number(),
50484
+ failed: array(string()),
50485
+ refused: array(RunnerRefusalSchema),
50486
+ missing: array(string()),
50487
+ /**
50488
+ * Runners still on their way: `starting`, or `crashed` waiting on a backoff
50489
+ * respawn. The check is FINAL only when this is empty; until then nothing is
50490
+ * pushed and the verdict is re-evaluated on the next runner state change.
50491
+ * Optional for version skew (absent = settled).
50492
+ */
50493
+ pending: array(string()).optional(),
50494
+ /** True when the plan is the hub's (`missing` is then meaningful); false on an agent. */
50495
+ planKnown: boolean()
50496
+ });
49861
50497
  var ServerPackageStatusSchema = object({
49862
50498
  /** Root package name (`@camstack/server` on the hub). */
49863
50499
  packageName: string(),
@@ -49920,7 +50556,14 @@ var ServerPackageStatusSchema = object({
49920
50556
  * for version skew: an older provider's payload simply omits it, and an
49921
50557
  * absent wrapper is unknown — never `native`.
49922
50558
  */
49923
- wrapper: WrapperIdentitySchema.optional()
50559
+ wrapper: WrapperIdentitySchema.optional(),
50560
+ /**
50561
+ * What this node PLANNED to run against what its process service reports
50562
+ * (D877). Absent until the one-shot boot check has run (~60 s after boot) and
50563
+ * on a provider that predates it. Absent is "not checked yet", never "all
50564
+ * well": a consumer that needs the answer treats it as pending.
50565
+ */
50566
+ runners: RunnerBootCheckSchema.optional()
49924
50567
  });
49925
50568
  var ServerUpdateCheckResultSchema = object({
49926
50569
  packageName: string(),
@@ -49971,6 +50614,13 @@ var ServerUpdateOutcomeSchema = _enum([
49971
50614
  "refused",
49972
50615
  "failed"
49973
50616
  ]);
50617
+ /** One addon the pre-flight found the target version would refuse (D877). */
50618
+ var UpdateBlockerSchema = object({
50619
+ addonId: string(),
50620
+ reason: string(),
50621
+ /** What the operator does about it. */
50622
+ remedy: string()
50623
+ });
49974
50624
  var ServerUpdateActionResultSchema = object({
49975
50625
  accepted: boolean(),
49976
50626
  targetVersion: string().nullable(),
@@ -49988,14 +50638,27 @@ var ServerUpdateActionResultSchema = object({
49988
50638
  * The failure itself, verbatim enough to act on (the npm output for a
49989
50639
  * staging install). Non-null only for `failed`.
49990
50640
  */
49991
- error: string().nullable().optional()
50641
+ error: string().nullable().optional(),
50642
+ /**
50643
+ * The addons the target version would refuse to start on this node's live
50644
+ * store (D877), present when the pre-flight refused the update
50645
+ * (`reason: 'addon-would-refuse'`). Optional for version skew.
50646
+ */
50647
+ blockers: array(UpdateBlockerSchema).optional()
49992
50648
  });
49993
50649
  method(_void(), ServerPackageStatusSchema, { auth: "admin" }), method(_void(), ServerUpdateCheckResultSchema, {
49994
50650
  kind: "mutation",
49995
50651
  auth: "admin"
49996
- }), method(object({
49997
- /** Explicit target version; omitted = latest from the registry. */
49998
- version: string().optional() }), ServerUpdateActionResultSchema, {
50652
+ }), method(object({
50653
+ /** Explicit target version; omitted = latest from the registry. */
50654
+ version: string().optional(),
50655
+ /**
50656
+ * Apply even though the pre-flight (D877) found addons the target would
50657
+ * refuse to start. Off by default: those addons stay down until the
50658
+ * remedy is run, which is the incident this gate exists to prevent.
50659
+ */
50660
+ acknowledgeRefusals: boolean().optional()
50661
+ }), ServerUpdateActionResultSchema, {
49999
50662
  kind: "mutation",
50000
50663
  auth: "admin",
50001
50664
  timeoutMs: 16 * 6e4
@@ -52545,7 +53208,9 @@ var ManifestShapeSchema = object({
52545
53208
  var AddonProcessSchema = object({
52546
53209
  pid: number().optional(),
52547
53210
  mode: string(),
52548
- state: string()
53211
+ state: string(),
53212
+ /** Why the runner is `refused` (an addon's own words), when it is (D877). */
53213
+ reason: string().optional()
52549
53214
  });
52550
53215
  /**
52551
53216
  * Per-addon health snapshot from the kernel's AddonHealthMonitor.
@@ -53313,7 +53978,8 @@ var batteryCapability = {
53313
53978
  DeviceType.Button,
53314
53979
  DeviceType.Switch,
53315
53980
  DeviceType.PetFeeder,
53316
- DeviceType.Container
53981
+ DeviceType.Container,
53982
+ DeviceType.Thermostat
53317
53983
  ],
53318
53984
  methods: {
53319
53985
  /**
@@ -53934,6 +54600,12 @@ var ClimateControlStatusSchema = object({
53934
54600
  /** Horizontal louver swing on/off. Null when the device has no
53935
54601
  * horizontal swing surface (gate with `DeviceFeature.ClimateSwingHorizontal`). */
53936
54602
  swingHorizontal: boolean().nullable(),
54603
+ /** Lowest setpoint the device accepts, Celsius. Absent / null = not reported. */
54604
+ minTemp: number().nullable().optional(),
54605
+ /** Highest setpoint the device accepts, Celsius. Absent / null = not reported. */
54606
+ maxTemp: number().nullable().optional(),
54607
+ /** Setpoint granularity, Celsius (0.5, 1). Absent / null = not reported. */
54608
+ tempStep: number().positive().nullable().optional(),
53937
54609
  /** Ms epoch when the slice was last updated (push or command). */
53938
54610
  lastFetchedAt: number()
53939
54611
  });
@@ -54788,6 +55460,125 @@ onStatusChanged: { data: object({
54788
55460
  * whether persisting is worth a SQLite commit. */
54789
55461
  volatileStateFields: ["lastChangedAt"]
54790
55462
  };
55463
+ /**
55464
+ * Smart-dishwasher cap — program lifecycle, door / remote-start gates,
55465
+ * consumable levels (salt, rinse aid) and common program options.
55466
+ *
55467
+ * Sources: native Bosch Home Connect (`dishwasher` device type). Reusable
55468
+ * by any integration that exposes the same program / option surface.
55469
+ *
55470
+ * `kind: 'poll'` — cloud REST APIs typically have no push channel; the
55471
+ * provider refreshes the slice on an interval and eagerly after commands.
55472
+ */
55473
+ var DishwasherStateSchema = _enum([
55474
+ "idle",
55475
+ "running",
55476
+ "paused",
55477
+ "finished",
55478
+ "error",
55479
+ "unavailable"
55480
+ ]);
55481
+ var DishwasherConsumableLevelSchema = _enum([
55482
+ "ok",
55483
+ "low",
55484
+ "empty"
55485
+ ]);
55486
+ var DishwasherStatusSchema = object({
55487
+ state: DishwasherStateSchema,
55488
+ /** Active program id/name, or null when none selected / unknown. */
55489
+ program: string().nullable(),
55490
+ /** Program tokens the hardware accepts — drives the UI selector. */
55491
+ availablePrograms: array(string()),
55492
+ /** Minutes remaining on the active cycle, or null when not running. */
55493
+ remainingMinutes: number().int().nonnegative().nullable(),
55494
+ /** Cycle completion 0..100, or null when not applicable. */
55495
+ progressPercent: number().min(0).max(100).nullable(),
55496
+ /** True when the door is reported open. */
55497
+ doorOpen: boolean(),
55498
+ /** True when remote start is allowed (door closed, power on, etc.). */
55499
+ remoteStartAllowed: boolean(),
55500
+ /** Main power / switched-on state. */
55501
+ powerOn: boolean(),
55502
+ saltLevel: DishwasherConsumableLevelSchema.nullable(),
55503
+ rinseAidLevel: DishwasherConsumableLevelSchema.nullable(),
55504
+ halfLoad: boolean(),
55505
+ hygienePlus: boolean(),
55506
+ errorCode: number().nullable(),
55507
+ errorLabel: string().nullable(),
55508
+ lastFetchedAt: number()
55509
+ });
55510
+ var dishwasherCapability = {
55511
+ name: "dishwasher",
55512
+ scope: "device",
55513
+ deviceNative: true,
55514
+ mode: "singleton",
55515
+ deviceTypes: [DeviceType.Dishwasher],
55516
+ methods: {
55517
+ start: method(object({ deviceId: number().int().nonnegative() }), _void(), {
55518
+ kind: "mutation",
55519
+ auth: "protected"
55520
+ }),
55521
+ pause: method(object({ deviceId: number().int().nonnegative() }), _void(), {
55522
+ kind: "mutation",
55523
+ auth: "protected"
55524
+ }),
55525
+ stop: method(object({ deviceId: number().int().nonnegative() }), _void(), {
55526
+ kind: "mutation",
55527
+ auth: "protected"
55528
+ }),
55529
+ setProgram: method(object({
55530
+ deviceId: number().int().nonnegative(),
55531
+ program: string().min(1)
55532
+ }), _void(), {
55533
+ kind: "mutation",
55534
+ auth: "protected"
55535
+ }),
55536
+ setPower: method(object({
55537
+ deviceId: number().int().nonnegative(),
55538
+ on: boolean()
55539
+ }), _void(), {
55540
+ kind: "mutation",
55541
+ auth: "protected"
55542
+ }),
55543
+ setHalfLoad: method(object({
55544
+ deviceId: number().int().nonnegative(),
55545
+ on: boolean()
55546
+ }), _void(), {
55547
+ kind: "mutation",
55548
+ auth: "protected"
55549
+ }),
55550
+ setHygienePlus: method(object({
55551
+ deviceId: number().int().nonnegative(),
55552
+ on: boolean()
55553
+ }), _void(), {
55554
+ kind: "mutation",
55555
+ auth: "protected"
55556
+ }),
55557
+ setOption: method(object({
55558
+ deviceId: number().int().nonnegative(),
55559
+ key: string().min(1),
55560
+ value: union([
55561
+ boolean(),
55562
+ string(),
55563
+ number()
55564
+ ])
55565
+ }), _void(), {
55566
+ kind: "mutation",
55567
+ auth: "protected"
55568
+ })
55569
+ },
55570
+ status: {
55571
+ schema: DishwasherStatusSchema,
55572
+ kind: "poll"
55573
+ },
55574
+ runtimeState: DishwasherStatusSchema,
55575
+ durability: "session",
55576
+ history: { fields: { progressPercent: {
55577
+ kind: "gauge",
55578
+ unit: "%",
55579
+ deadband: 2
55580
+ } } }
55581
+ };
54791
55582
  var DoorbellStatusSchema = object({
54792
55583
  /** Ms epoch of the last press. null = never observed since this provider started. */
54793
55584
  lastPressedAt: number().nullable(),
@@ -55590,6 +56381,32 @@ var gasCapability = {
55590
56381
  * whether persisting is worth a SQLite commit. */
55591
56382
  volatileStateFields: ["lastChangedAt"]
55592
56383
  };
56384
+ var HeatingValveStatusSchema = object({
56385
+ /** Radiator valve opening 0 (closed) .. 100 (open). Null = not yet known. */
56386
+ position: number().min(0).max(100).nullable(),
56387
+ /** Ms epoch when the slice was last updated (push or poll). */
56388
+ lastFetchedAt: number()
56389
+ });
56390
+ var heatingValveCapability = {
56391
+ name: "heating-valve",
56392
+ scope: "device",
56393
+ deviceNative: true,
56394
+ mode: "singleton",
56395
+ deviceTypes: [DeviceType.Thermostat],
56396
+ methods: {},
56397
+ status: {
56398
+ schema: HeatingValveStatusSchema,
56399
+ kind: "push"
56400
+ },
56401
+ runtimeState: HeatingValveStatusSchema,
56402
+ durability: "session",
56403
+ history: { fields: { position: {
56404
+ kind: "gauge",
56405
+ unit: "%",
56406
+ deadband: 1
56407
+ } } },
56408
+ volatileStateFields: ["lastFetchedAt"]
56409
+ };
55593
56410
  /**
55594
56411
  * Humidifier / dehumidifier cap. Models HA `humidifier.*` entities —
55595
56412
  * an on/off actuator with an optional target-humidity setpoint and an
@@ -56722,7 +57539,19 @@ var TlsStatusSchema = object({
56722
57539
  sans: array(string()),
56723
57540
  caCertPem: string().nullable(),
56724
57541
  reissueError: string().nullable(),
56725
- restartRequired: boolean()
57542
+ restartRequired: boolean(),
57543
+ /** An uploaded certificate is served but no CA is kept for it and it is not publicly signed (D873). */
57544
+ caMissing: boolean(),
57545
+ /** Does the hub's own generated CA carry a critical name constraint? `null` while it has none. */
57546
+ localCaConstrained: boolean().nullable(),
57547
+ /** ISO time the generated CA was replaced by a constrained one; devices must re-download it. */
57548
+ caReplacedAt: string().nullable(),
57549
+ /** The uploaded certificate kept on disk, selectable again after "Revert to generated". */
57550
+ storedUpload: object({
57551
+ leafFingerprintSha256: string(),
57552
+ validTo: string(),
57553
+ hasCa: boolean()
57554
+ }).nullable()
56726
57555
  });
56727
57556
  method(_void(), ListResultSchema), method(_void(), PreferredSchema), method(object({
56728
57557
  /**
@@ -56778,6 +57607,9 @@ method(_void(), ListResultSchema), method(_void(), PreferredSchema), method(obje
56778
57607
  }), method(_void(), object({ pem: string() })), method(_void(), TlsStatusSchema, {
56779
57608
  kind: "mutation",
56780
57609
  auth: "admin"
57610
+ }), method(_void(), TlsStatusSchema, {
57611
+ kind: "mutation",
57612
+ auth: "admin"
56781
57613
  });
56782
57614
  var LockControlStatusSchema = object({
56783
57615
  /** Lifecycle state of the lock. `jammed` means the motor reported
@@ -63271,7 +64103,11 @@ method(_void(), array(UserSummarySchema), { auth: "admin" }), method(CreateUserI
63271
64103
  kind: "mutation",
63272
64104
  auth: "admin",
63273
64105
  access: "delete"
63274
- }), method(object({ userId: string() }), TotpStatusSchema, { auth: "admin" }), method(object({
64106
+ }), method(object({ userId: string() }), TotpStatusSchema, { auth: "admin" }), method(RawSecretMigrationInputSchema, RawSecretMigrationReportSchema, {
64107
+ kind: "mutation",
64108
+ auth: "admin",
64109
+ access: "create"
64110
+ }), method(object({
63275
64111
  userId: string(),
63276
64112
  code: string()
63277
64113
  }), object({ valid: boolean() }), {
@@ -64991,6 +65827,7 @@ var DEVICE_LOCAL_STATE_CAPS = {
64991
65827
  dayNight: dayNightCapability,
64992
65828
  deviceDiscovery: deviceDiscoveryCapability,
64993
65829
  deviceStatus: deviceStatusCapability,
65830
+ dishwasher: dishwasherCapability,
64994
65831
  doorbell: doorbellCapability,
64995
65832
  enumSensor: enumSensorCapability,
64996
65833
  eventEmitter: eventEmitterCapability,
@@ -64998,6 +65835,7 @@ var DEVICE_LOCAL_STATE_CAPS = {
64998
65835
  featureProbe: featureProbeCapability,
64999
65836
  flood: floodCapability,
65000
65837
  gas: gasCapability,
65838
+ heatingValve: heatingValveCapability,
65001
65839
  humidifier: humidifierCapability,
65002
65840
  humiditySensor: humiditySensorCapability,
65003
65841
  image: imageCapability,
@@ -65083,13 +65921,14 @@ var BaseDevice = class {
65083
65921
  get state() {
65084
65922
  if (!this._stateProxyCache) {
65085
65923
  const cache = {};
65086
- const handler = { get: (_target, key) => {
65924
+ const handler = { get: (target, key) => {
65087
65925
  const k = key;
65088
- if (k in cache) return cache[k];
65926
+ const existing = Reflect.get(target, k);
65927
+ if (existing !== void 0) return existing;
65089
65928
  const cap = DEVICE_LOCAL_STATE_CAPS[k];
65090
65929
  if (!cap) return void 0;
65091
65930
  const proxy = this.sliceProxy(cap);
65092
- cache[k] = proxy;
65931
+ Reflect.set(target, k, proxy);
65093
65932
  return proxy;
65094
65933
  } };
65095
65934
  this._stateProxyCache = new Proxy(cache, handler);
@@ -65288,7 +66127,7 @@ var BaseDevice = class {
65288
66127
  async updateSourceInfo(patch) {
65289
66128
  const next = mergeSourceInfo(this.sourceInfo, patch);
65290
66129
  this._sourceInfoCache = Object.freeze({ ...next });
65291
- const action = this.ctx.api?.deviceManager?.setMetadata;
66130
+ const action = this.ctx.api.deviceManager?.setMetadata;
65292
66131
  if (action) try {
65293
66132
  await action.mutate({
65294
66133
  deviceId: this.id,
@@ -65323,7 +66162,7 @@ var BaseDevice = class {
65323
66162
  * device boot on a meta refresh.
65324
66163
  */
65325
66164
  async refreshFeatures() {
65326
- const action = this.ctx.api?.deviceManager?.registerDevice;
66165
+ const action = this.ctx.api.deviceManager?.registerDevice;
65327
66166
  if (!action) return;
65328
66167
  try {
65329
66168
  await action.mutate({
@@ -65722,6 +66561,12 @@ var BaseDeviceProvider = class extends BaseAddon {
65722
66561
  provider: this
65723
66562
  }];
65724
66563
  }
66564
+ /** Flatten `super.onInitialize()` whether it returned an array or an envelope. */
66565
+ providerRegistrationsFromSuper(result) {
66566
+ if (Array.isArray(result)) return result;
66567
+ if (result !== void 0 && result.providers !== void 0) return [...result.providers];
66568
+ return [];
66569
+ }
65725
66570
  async onShutdown() {
65726
66571
  this._restoreShuttingDown = true;
65727
66572
  this.cancelRestoreRetries();
@@ -66248,7 +67093,7 @@ var BaseDeviceProvider = class extends BaseAddon {
66248
67093
  return toDeviceSummary(device, this.addonId);
66249
67094
  }
66250
67095
  };
66251
- DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Camera, DeviceType.Hub, DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder;
67096
+ DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Camera, DeviceType.Hub, DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.Dishwasher;
66252
67097
  new Set(Object.values(DeviceType));
66253
67098
  Object.freeze({
66254
67099
  "accessories.getStatus": {
@@ -67397,6 +68242,12 @@ Object.freeze({
67397
68242
  addonId: null,
67398
68243
  access: "view"
67399
68244
  },
68245
+ "coreBlocks.migrateRawSecrets": {
68246
+ capName: "core-blocks",
68247
+ capScope: "system",
68248
+ addonId: null,
68249
+ access: "create"
68250
+ },
67400
68251
  "coreBlocks.restart": {
67401
68252
  capName: "core-blocks",
67402
68253
  capScope: "system",
@@ -68663,6 +69514,60 @@ Object.freeze({
68663
69514
  addonId: null,
68664
69515
  access: "view"
68665
69516
  },
69517
+ "dishwasher.getStatus": {
69518
+ capName: "dishwasher",
69519
+ capScope: "device",
69520
+ addonId: null,
69521
+ access: "view"
69522
+ },
69523
+ "dishwasher.pause": {
69524
+ capName: "dishwasher",
69525
+ capScope: "device",
69526
+ addonId: null,
69527
+ access: "create"
69528
+ },
69529
+ "dishwasher.setHalfLoad": {
69530
+ capName: "dishwasher",
69531
+ capScope: "device",
69532
+ addonId: null,
69533
+ access: "create"
69534
+ },
69535
+ "dishwasher.setHygienePlus": {
69536
+ capName: "dishwasher",
69537
+ capScope: "device",
69538
+ addonId: null,
69539
+ access: "create"
69540
+ },
69541
+ "dishwasher.setOption": {
69542
+ capName: "dishwasher",
69543
+ capScope: "device",
69544
+ addonId: null,
69545
+ access: "create"
69546
+ },
69547
+ "dishwasher.setPower": {
69548
+ capName: "dishwasher",
69549
+ capScope: "device",
69550
+ addonId: null,
69551
+ access: "create"
69552
+ },
69553
+ "dishwasher.setProgram": {
69554
+ capName: "dishwasher",
69555
+ capScope: "device",
69556
+ addonId: null,
69557
+ access: "create"
69558
+ },
69559
+ "dishwasher.start": {
69560
+ capName: "dishwasher",
69561
+ capScope: "device",
69562
+ addonId: null,
69563
+ access: "create"
69564
+ },
69565
+ "dishwasher.stop": {
69566
+ capName: "dishwasher",
69567
+ capScope: "device",
69568
+ addonId: null,
69569
+ access: "create"
69570
+ },
68666
69571
  "doorbell.getStatus": {
68667
69572
  capName: "doorbell",
68668
69573
  capScope: "device",
@@ -68873,6 +69778,12 @@ Object.freeze({
68873
69778
  addonId: null,
68874
69779
  access: "view"
68875
69780
  },
69781
+ "heatingValve.getStatus": {
69782
+ capName: "heating-valve",
69783
+ capScope: "device",
69784
+ addonId: null,
69785
+ access: "view"
69786
+ },
68876
69787
  "humidifier.getStatus": {
68877
69788
  capName: "humidifier",
68878
69789
  capScope: "device",
@@ -69083,6 +69994,12 @@ Object.freeze({
69083
69994
  addonId: null,
69084
69995
  access: "create"
69085
69996
  },
69997
+ "keychainAdmin.importSecret": {
69998
+ capName: "keychain-admin",
69999
+ capScope: "system",
70000
+ addonId: null,
70001
+ access: "create"
70002
+ },
69086
70003
  "keychainAdmin.listAudit": {
69087
70004
  capName: "keychain-admin",
69088
70005
  capScope: "system",
@@ -69251,6 +70168,12 @@ Object.freeze({
69251
70168
  addonId: null,
69252
70169
  access: "view"
69253
70170
  },
70171
+ "llm.migrateRawSecrets": {
70172
+ capName: "llm",
70173
+ capScope: "system",
70174
+ addonId: null,
70175
+ access: "create"
70176
+ },
69254
70177
  "llm.resolveModelRef": {
69255
70178
  capName: "llm",
69256
70179
  capScope: "system",
@@ -69479,6 +70402,12 @@ Object.freeze({
69479
70402
  addonId: null,
69480
70403
  access: "create"
69481
70404
  },
70405
+ "localNetwork.useStoredUploadedCertificate": {
70406
+ capName: "local-network",
70407
+ capScope: "system",
70408
+ addonId: null,
70409
+ access: "create"
70410
+ },
69482
70411
  "lockControl.getStatus": {
69483
70412
  capName: "lock-control",
69484
70413
  capScope: "device",
@@ -72131,6 +73060,30 @@ Object.freeze({
72131
73060
  addonId: null,
72132
73061
  access: "create"
72133
73062
  },
73063
+ "recordEntries.deleteEntry": {
73064
+ capName: "record-entries",
73065
+ capScope: "system",
73066
+ addonId: null,
73067
+ access: "delete"
73068
+ },
73069
+ "recordEntries.listEntries": {
73070
+ capName: "record-entries",
73071
+ capScope: "system",
73072
+ addonId: null,
73073
+ access: "view"
73074
+ },
73075
+ "recordEntries.listEntryKinds": {
73076
+ capName: "record-entries",
73077
+ capScope: "system",
73078
+ addonId: null,
73079
+ access: "view"
73080
+ },
73081
+ "recordEntries.putEntry": {
73082
+ capName: "record-entries",
73083
+ capScope: "system",
73084
+ addonId: null,
73085
+ access: "create"
73086
+ },
72134
73087
  "recording.getAvailability": {
72135
73088
  capName: "recording",
72136
73089
  capScope: "device",
@@ -72431,6 +73384,102 @@ Object.freeze({
72431
73384
  addonId: null,
72432
73385
  access: "view"
72433
73386
  },
73387
+ "records.aggregate": {
73388
+ capName: "records",
73389
+ capScope: "system",
73390
+ addonId: null,
73391
+ access: "view"
73392
+ },
73393
+ "records.allocateId": {
73394
+ capName: "records",
73395
+ capScope: "system",
73396
+ addonId: null,
73397
+ access: "create"
73398
+ },
73399
+ "records.count": {
73400
+ capName: "records",
73401
+ capScope: "system",
73402
+ addonId: null,
73403
+ access: "view"
73404
+ },
73405
+ "records.declareKinds": {
73406
+ capName: "records",
73407
+ capScope: "system",
73408
+ addonId: null,
73409
+ access: "create"
73410
+ },
73411
+ "records.delete": {
73412
+ capName: "records",
73413
+ capScope: "system",
73414
+ addonId: null,
73415
+ access: "delete"
73416
+ },
73417
+ "records.deleteDevice": {
73418
+ capName: "records",
73419
+ capScope: "system",
73420
+ addonId: null,
73421
+ access: "delete"
73422
+ },
73423
+ "records.deleteMany": {
73424
+ capName: "records",
73425
+ capScope: "system",
73426
+ addonId: null,
73427
+ access: "delete"
73428
+ },
73429
+ "records.deleteWhere": {
73430
+ capName: "records",
73431
+ capScope: "system",
73432
+ addonId: null,
73433
+ access: "delete"
73434
+ },
73435
+ "records.get": {
73436
+ capName: "records",
73437
+ capScope: "system",
73438
+ addonId: null,
73439
+ access: "view"
73440
+ },
73441
+ "records.getMany": {
73442
+ capName: "records",
73443
+ capScope: "system",
73444
+ addonId: null,
73445
+ access: "view"
73446
+ },
73447
+ "records.histogram": {
73448
+ capName: "records",
73449
+ capScope: "system",
73450
+ addonId: null,
73451
+ access: "view"
73452
+ },
73453
+ "records.patch": {
73454
+ capName: "records",
73455
+ capScope: "system",
73456
+ addonId: null,
73457
+ access: "create"
73458
+ },
73459
+ "records.put": {
73460
+ capName: "records",
73461
+ capScope: "system",
73462
+ addonId: null,
73463
+ access: "create"
73464
+ },
73465
+ "records.putMany": {
73466
+ capName: "records",
73467
+ capScope: "system",
73468
+ addonId: null,
73469
+ access: "create"
73470
+ },
73471
+ "records.query": {
73472
+ capName: "records",
73473
+ capScope: "system",
73474
+ addonId: null,
73475
+ access: "view"
73476
+ },
73477
+ "records.secretRefs": {
73478
+ capName: "records",
73479
+ capScope: "system",
73480
+ addonId: null,
73481
+ access: "view"
73482
+ },
72434
73483
  "sceneMonitor.captureReference": {
72435
73484
  capName: "scene-monitor",
72436
73485
  capScope: "device",
@@ -72863,6 +73912,48 @@ Object.freeze({
72863
73912
  addonId: null,
72864
73913
  access: "create"
72865
73914
  },
73915
+ "storageAdmin.adoptRecords": {
73916
+ capName: "storage-admin",
73917
+ capScope: "system",
73918
+ addonId: null,
73919
+ access: "create"
73920
+ },
73921
+ "storageAdmin.dropCollection": {
73922
+ capName: "storage-admin",
73923
+ capScope: "system",
73924
+ addonId: null,
73925
+ access: "delete"
73926
+ },
73927
+ "storageAdmin.isAdoptedLegacyTable": {
73928
+ capName: "storage-admin",
73929
+ capScope: "system",
73930
+ addonId: null,
73931
+ access: "view"
73932
+ },
73933
+ "storageAdmin.listKinds": {
73934
+ capName: "storage-admin",
73935
+ capScope: "system",
73936
+ addonId: null,
73937
+ access: "view"
73938
+ },
73939
+ "storageAdmin.listTables": {
73940
+ capName: "storage-admin",
73941
+ capScope: "system",
73942
+ addonId: null,
73943
+ access: "view"
73944
+ },
73945
+ "storageAdmin.readLegacyCollection": {
73946
+ capName: "storage-admin",
73947
+ capScope: "system",
73948
+ addonId: null,
73949
+ access: "view"
73950
+ },
73951
+ "storageAdmin.readRecords": {
73952
+ capName: "storage-admin",
73953
+ capScope: "system",
73954
+ addonId: null,
73955
+ access: "view"
73956
+ },
72866
73957
  "storageEvictable.evict": {
72867
73958
  capName: "storage-evictable",
72868
73959
  capScope: "system",
@@ -73775,6 +74866,12 @@ Object.freeze({
73775
74866
  addonId: null,
73776
74867
  access: "view"
73777
74868
  },
74869
+ "userManagement.migrateRawSecrets": {
74870
+ capName: "user-management",
74871
+ capScope: "system",
74872
+ addonId: null,
74873
+ access: "create"
74874
+ },
73778
74875
  "userManagement.oauthExchangeCode": {
73779
74876
  capName: "user-management",
73780
74877
  capScope: "system",
@@ -74274,7 +75371,7 @@ Object.freeze({
74274
75371
  access: "create"
74275
75372
  }
74276
75373
  });
74277
- DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder;
75374
+ DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.Dishwasher;
74278
75375
  DeviceFeature.BatteryOperated;
74279
75376
  /** Reject after `ms`; always clears its own timer. */
74280
75377
  async function withTimeout$1(promise, ms, label) {
@@ -75164,6 +76261,51 @@ Object.freeze({
75164
76261
  form: "single",
75165
76262
  optional: false
75166
76263
  }],
76264
+ "dishwasher.getStatus": [{
76265
+ name: "deviceId",
76266
+ form: "single",
76267
+ optional: false
76268
+ }],
76269
+ "dishwasher.pause": [{
76270
+ name: "deviceId",
76271
+ form: "single",
76272
+ optional: false
76273
+ }],
76274
+ "dishwasher.setHalfLoad": [{
76275
+ name: "deviceId",
76276
+ form: "single",
76277
+ optional: false
76278
+ }],
76279
+ "dishwasher.setHygienePlus": [{
76280
+ name: "deviceId",
76281
+ form: "single",
76282
+ optional: false
76283
+ }],
76284
+ "dishwasher.setOption": [{
76285
+ name: "deviceId",
76286
+ form: "single",
76287
+ optional: false
76288
+ }],
76289
+ "dishwasher.setPower": [{
76290
+ name: "deviceId",
76291
+ form: "single",
76292
+ optional: false
76293
+ }],
76294
+ "dishwasher.setProgram": [{
76295
+ name: "deviceId",
76296
+ form: "single",
76297
+ optional: false
76298
+ }],
76299
+ "dishwasher.start": [{
76300
+ name: "deviceId",
76301
+ form: "single",
76302
+ optional: false
76303
+ }],
76304
+ "dishwasher.stop": [{
76305
+ name: "deviceId",
76306
+ form: "single",
76307
+ optional: false
76308
+ }],
75167
76309
  "doorbell.getStatus": [{
75168
76310
  name: "deviceId",
75169
76311
  form: "single",
@@ -75233,6 +76375,11 @@ Object.freeze({
75233
76375
  form: "single",
75234
76376
  optional: false
75235
76377
  }],
76378
+ "heatingValve.getStatus": [{
76379
+ name: "deviceId",
76380
+ form: "single",
76381
+ optional: false
76382
+ }],
75236
76383
  "humidifier.getStatus": [{
75237
76384
  name: "deviceId",
75238
76385
  form: "single",
@@ -76517,6 +77664,37 @@ Object.freeze({
76517
77664
  form: "single",
76518
77665
  optional: false
76519
77666
  }],
77667
+ "records.count": [{
77668
+ name: "deviceId",
77669
+ form: "single",
77670
+ optional: true
77671
+ }],
77672
+ "records.deleteDevice": [{
77673
+ name: "deviceId",
77674
+ form: "single",
77675
+ optional: false
77676
+ }],
77677
+ "records.deleteWhere": [{
77678
+ name: "deviceId",
77679
+ form: "single",
77680
+ optional: true
77681
+ }],
77682
+ "records.histogram": [{
77683
+ name: "deviceId",
77684
+ form: "single",
77685
+ optional: true
77686
+ }],
77687
+ "records.putMany": [{
77688
+ name: "records",
77689
+ form: "object-array",
77690
+ optional: false,
77691
+ itemField: "deviceId"
77692
+ }],
77693
+ "records.query": [{
77694
+ name: "deviceId",
77695
+ form: "single",
77696
+ optional: true
77697
+ }],
76520
77698
  "sceneMonitor.captureReference": [{
76521
77699
  name: "deviceId",
76522
77700
  form: "single",
@@ -76633,6 +77811,17 @@ Object.freeze({
76633
77811
  form: "single",
76634
77812
  optional: false
76635
77813
  }],
77814
+ "storageAdmin.adoptRecords": [{
77815
+ name: "records",
77816
+ form: "object-array",
77817
+ optional: false,
77818
+ itemField: "deviceId"
77819
+ }],
77820
+ "storageAdmin.readRecords": [{
77821
+ name: "deviceId",
77822
+ form: "single",
77823
+ optional: true
77824
+ }],
76636
77825
  "streamBroker.acquireEgressTranscode": [{
76637
77826
  name: "deviceId",
76638
77827
  form: "single",
@@ -78696,7 +79885,7 @@ var RtspProviderAddon = class extends BaseDeviceProvider {
78696
79885
  super({});
78697
79886
  }
78698
79887
  async onInitialize() {
78699
- return [...await super.onInitialize(), {
79888
+ return [...this.providerRegistrationsFromSuper(await super.onInitialize()), {
78700
79889
  capability: connectionTestCapability,
78701
79890
  provider: this.buildConnectionTestProvider()
78702
79891
  }];