camstack 1.2.45 → 1.2.46

package/dist/{chunk-3WS4SP46.js → chunk-HAO7UL6U.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-DJlqY62B.mjs
+// ../types/dist/sleep-CdbM8ge4.mjs
 var WELL_KNOWN_TABS = [
   {
     id: "overview",
@@ -23694,7 +23694,23 @@ var NcHistoryEntrySchema = external_exports.object({
   updatedAt: external_exports.number(),
   /** Failure detail — present on a `dead` row. */
   error: external_exports.string().optional(),
-  subject: NcHistorySubjectSchema
+  subject: NcHistorySubjectSchema,
+  /**
+  * Ids of the artefacts (still, then gif, then clip) this row's successful
+  * delivery indexed in the artefact library — a REFERENCE, never the bytes
+  * (an artefact is often megabytes; this row is durable JSON rewritten on
+  * every delivery attempt). Absent on a row still pending/dead, a row
+  * delivered before this field shipped, or a wiring with no artefact index.
+  *
+  * Resolve one to a fetchable URL with `resolveArtifactUrl` — an id
+  * outlives any one URL's TTL, so a caller mints a fresh link on demand
+  * rather than trusting one frozen at delivery time. `resolveArtifactUrl`
+  * also answers `null` for an id whose artefact has since expired past the
+  * retained shelf's own age bound — the degrade a caller (the Home
+  * Assistant export) must render as "no image right now", never as a
+  * broken link.
+  */
+  artifactIds: external_exports.array(external_exports.string().min(1)).optional()
 });
 var NcHistoryFilterSchema = external_exports.object({
   ruleId: external_exports.string().optional(),
@@ -23940,6 +23956,20 @@ var notificationRulesCapability = {
     */
     getHistory: method(external_exports.object({ filter: NcHistoryFilterSchema.default({ limit: 100 }) }), external_exports.object({ entries: external_exports.array(NcHistoryEntrySchema) }), { auth: "admin" }),
     /**
+    * Mint a fresh, externally-reachable URL for one artefact a history row
+    * named in {@link NcHistoryEntrySchema.shape.artifactIds} — the SAME
+    * signed-link mechanism the dispatcher uses to attach media to an
+    * outgoing notification (one derivation; this never re-implements it).
+    *
+    * `url: null` on THREE causes a caller must treat identically ("no image
+    * right now", never a broken link): the id is unknown, its artefact has
+    * expired past the retained shelf's own age bound, or this install has no
+    * externally-reachable base URL. A caller that received a URL on a
+    * previous call and now gets `null` must stop showing it — a link that
+    * worked five minutes ago is not proof it works now.
+    */
+    resolveArtifactUrl: method(external_exports.object({ artifactId: external_exports.string().min(1) }), external_exports.object({ url: external_exports.string().nullable() }), { auth: "admin" }),
+    /**
     * Snooze windows currently in effect, plus any whose digest has not yet
     * gone out. `caller: 'required'`: a user sees their OWN windows and the
     * global ones that silence them, never another person's private silence.
@@ -35381,6 +35411,23 @@ var ReadGopBytesResultSchema = external_exports.object({
   /** Media ms the returned fragment covers. */
   gopDurMs: external_exports.number()
 });
+var ReadWindowBytesResultSchema = external_exports.discriminatedUnion("kind", [external_exports.object({
+  kind: external_exports.literal("ok"),
+  data: external_exports.instanceof(Uint8Array),
+  /** Absolute epoch ms of the returned bytes' first sample — at or before
+  *  the requested `fromMs` (anchored on the nearest keyframe). */
+  gopStartMs: external_exports.number(),
+  /** Media ms the returned bytes cover, from `gopStartMs`. */
+  gopDurMs: external_exports.number(),
+  /** `false` ⇒ the safety byte cap cut the read short before it reached
+  *  the requested `toMs`; the caller got fewer frames than asked for. */
+  reachesRequestedEnd: external_exports.boolean()
+}), external_exports.object({
+  kind: external_exports.literal("spans-multiple-segments"),
+  /** Where the covering segment's own footage runs out — informational,
+  *  not a retry hint (retrying the same window would refuse again). */
+  segmentEndMs: external_exports.number()
+})]);
 var recordingCapability = {
   name: "recording",
   scope: "system",
@@ -35460,6 +35507,21 @@ var recordingCapability = {
       kind: "query",
       auth: "admin"
     }),
+    /** Read a WINDOW `[fromMs, toMs)` of segment `startMs`, by mfra byte
+    *  range — the multi-GOP twin of `readGopBytes`. Refuses (does not
+    *  degrade) when the window runs past the covering segment. Used by the
+    *  replay clip's `recording` source to fetch several seconds of native
+    *  footage for its single ffmpeg decode pass. */
+    readWindowBytes: method(external_exports.object({
+      deviceId: external_exports.number(),
+      profile: external_exports.string(),
+      startMs: external_exports.number(),
+      fromMs: external_exports.number(),
+      toMs: external_exports.number()
+    }), ReadWindowBytesResultSchema, {
+      kind: "query",
+      auth: "admin"
+    }),
     setDeviceConfig: method(external_exports.object({
       deviceId: external_exports.number(),
       config: RecordingConfigSchema
@@ -40278,6 +40340,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "notificationRules.resolveArtifactUrl": {
+    capName: "notification-rules",
+    capScope: "system",
+    addonId: null,
+    access: "view"
+  },
   "notificationRules.setAlarmConfig": {
     capName: "notification-rules",
     capScope: "system",
@@ -41682,6 +41750,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "recording.readWindowBytes": {
+    capName: "recording",
+    capScope: "system",
+    addonId: null,
+    access: "view"
+  },
   "recording.refreshStorageLocationsForMigration": {
     capName: "recording",
     capScope: "system",
@@ -44512,6 +44586,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
     form: "single",
     optional: false
   }],
+  "recording.readWindowBytes": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
   "recording.relocateFootage": [{
     name: "deviceId",
     form: "single",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-3WS4SP46.js";
+} from "./chunk-HAO7UL6U.js";
 import "./chunk-LMMQX4CK.js";
 
 // src/cli.ts
@@ -38,7 +38,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-ENSEYM5A.js");
+  await import("./launcher-Y5I6QU24.js");
 }
 
 // src/commands/agent.ts
@@ -83,7 +83,7 @@ async function runAgent(args) {
     ...typeof values.port === "string" ? { port: values.port } : {}
   };
   Object.assign(process.env, buildAgentEnv(opts));
-  await import("./launcher-ENSEYM5A.js");
+  await import("./launcher-Y5I6QU24.js");
 }
 
 // src/commands/setup.ts
@@ -1130,7 +1130,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-6BMNE6PK.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-27QPK6P7.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-6BMNE6PK.js → discover-27QPK6P7.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-3WS4SP46.js";
+} from "./chunk-HAO7UL6U.js";
 import "./chunk-LMMQX4CK.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,

package/dist/{launcher-ENSEYM5A.js → launcher-Y5I6QU24.js}

@@ -23633,9 +23633,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-BNhvXrQk.js
-var require_dist_BNhvXrQk = __commonJS({
-  "../system/dist/dist-BNhvXrQk.js"(exports) {
+// ../system/dist/dist-jRSrzoXr.js
+var require_dist_jRSrzoXr = __commonJS({
+  "../system/dist/dist-jRSrzoXr.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -34136,7 +34136,23 @@ var require_dist_BNhvXrQk = __commonJS({
       updatedAt: zod.z.number(),
       /** Failure detail — present on a `dead` row. */
       error: zod.z.string().optional(),
-      subject: NcHistorySubjectSchema
+      subject: NcHistorySubjectSchema,
+      /**
+      * Ids of the artefacts (still, then gif, then clip) this row's successful
+      * delivery indexed in the artefact library — a REFERENCE, never the bytes
+      * (an artefact is often megabytes; this row is durable JSON rewritten on
+      * every delivery attempt). Absent on a row still pending/dead, a row
+      * delivered before this field shipped, or a wiring with no artefact index.
+      *
+      * Resolve one to a fetchable URL with `resolveArtifactUrl` — an id
+      * outlives any one URL's TTL, so a caller mints a fresh link on demand
+      * rather than trusting one frozen at delivery time. `resolveArtifactUrl`
+      * also answers `null` for an id whose artefact has since expired past the
+      * retained shelf's own age bound — the degrade a caller (the Home
+      * Assistant export) must render as "no image right now", never as a
+      * broken link.
+      */
+      artifactIds: zod.z.array(zod.z.string().min(1)).optional()
     });
     var NcHistoryFilterSchema = zod.z.object({
       ruleId: zod.z.string().optional(),
@@ -34382,6 +34398,20 @@ var require_dist_BNhvXrQk = __commonJS({
         */
         getHistory: method(zod.z.object({ filter: NcHistoryFilterSchema.default({ limit: 100 }) }), zod.z.object({ entries: zod.z.array(NcHistoryEntrySchema) }), { auth: "admin" }),
         /**
+        * Mint a fresh, externally-reachable URL for one artefact a history row
+        * named in {@link NcHistoryEntrySchema.shape.artifactIds} — the SAME
+        * signed-link mechanism the dispatcher uses to attach media to an
+        * outgoing notification (one derivation; this never re-implements it).
+        *
+        * `url: null` on THREE causes a caller must treat identically ("no image
+        * right now", never a broken link): the id is unknown, its artefact has
+        * expired past the retained shelf's own age bound, or this install has no
+        * externally-reachable base URL. A caller that received a URL on a
+        * previous call and now gets `null` must stop showing it — a link that
+        * worked five minutes ago is not proof it works now.
+        */
+        resolveArtifactUrl: method(zod.z.object({ artifactId: zod.z.string().min(1) }), zod.z.object({ url: zod.z.string().nullable() }), { auth: "admin" }),
+        /**
         * Snooze windows currently in effect, plus any whose digest has not yet
         * gone out. `caller: 'required'`: a user sees their OWN windows and the
         * global ones that silence them, never another person's private silence.
@@ -45678,6 +45708,23 @@ var require_dist_BNhvXrQk = __commonJS({
       /** Media ms the returned fragment covers. */
       gopDurMs: zod.z.number()
     });
+    var ReadWindowBytesResultSchema = zod.z.discriminatedUnion("kind", [zod.z.object({
+      kind: zod.z.literal("ok"),
+      data: zod.z.instanceof(Uint8Array),
+      /** Absolute epoch ms of the returned bytes' first sample — at or before
+      *  the requested `fromMs` (anchored on the nearest keyframe). */
+      gopStartMs: zod.z.number(),
+      /** Media ms the returned bytes cover, from `gopStartMs`. */
+      gopDurMs: zod.z.number(),
+      /** `false` ⇒ the safety byte cap cut the read short before it reached
+      *  the requested `toMs`; the caller got fewer frames than asked for. */
+      reachesRequestedEnd: zod.z.boolean()
+    }), zod.z.object({
+      kind: zod.z.literal("spans-multiple-segments"),
+      /** Where the covering segment's own footage runs out — informational,
+      *  not a retry hint (retrying the same window would refuse again). */
+      segmentEndMs: zod.z.number()
+    })]);
     var recordingCapability = {
       name: "recording",
       scope: "system",
@@ -45757,6 +45804,21 @@ var require_dist_BNhvXrQk = __commonJS({
           kind: "query",
           auth: "admin"
         }),
+        /** Read a WINDOW `[fromMs, toMs)` of segment `startMs`, by mfra byte
+        *  range — the multi-GOP twin of `readGopBytes`. Refuses (does not
+        *  degrade) when the window runs past the covering segment. Used by the
+        *  replay clip's `recording` source to fetch several seconds of native
+        *  footage for its single ffmpeg decode pass. */
+        readWindowBytes: method(zod.z.object({
+          deviceId: zod.z.number(),
+          profile: zod.z.string(),
+          startMs: zod.z.number(),
+          fromMs: zod.z.number(),
+          toMs: zod.z.number()
+        }), ReadWindowBytesResultSchema, {
+          kind: "query",
+          auth: "admin"
+        }),
         setDeviceConfig: method(zod.z.object({
           deviceId: zod.z.number(),
           config: RecordingConfigSchema
@@ -51265,6 +51327,12 @@ var require_dist_BNhvXrQk = __commonJS({
         addonId: null,
         access: "view"
       },
+      "notificationRules.resolveArtifactUrl": {
+        capName: "notification-rules",
+        capScope: "system",
+        addonId: null,
+        access: "view"
+      },
       "notificationRules.setAlarmConfig": {
         capName: "notification-rules",
         capScope: "system",
@@ -52669,6 +52737,12 @@ var require_dist_BNhvXrQk = __commonJS({
         addonId: null,
         access: "view"
       },
+      "recording.readWindowBytes": {
+        capName: "recording",
+        capScope: "system",
+        addonId: null,
+        access: "view"
+      },
       "recording.refreshStorageLocationsForMigration": {
         capName: "recording",
         capScope: "system",
@@ -55499,6 +55573,11 @@ var require_dist_BNhvXrQk = __commonJS({
         form: "single",
         optional: false
       }],
+      "recording.readWindowBytes": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "recording.relocateFootage": [{
         name: "deviceId",
         form: "single",
@@ -57153,7 +57232,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
+    var require_dist10 = require_dist_jRSrzoXr();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -57972,7 +58051,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
+    var require_dist10 = require_dist_jRSrzoXr();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -58066,7 +58145,7 @@ var require_core_blocks_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
+    var require_dist10 = require_dist_jRSrzoXr();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -58963,11 +59042,11 @@ var require_core_blocks = __commonJS({
   }
 });
 
-// ../system/dist/retired-settings-keys-DVgdWTd7.js
-var require_retired_settings_keys_DVgdWTd7 = __commonJS({
-  "../system/dist/retired-settings-keys-DVgdWTd7.js"(exports) {
+// ../system/dist/retired-settings-keys-ovd_DQzc.js
+var require_retired_settings_keys_ovd_DQzc = __commonJS({
+  "../system/dist/retired-settings-keys-ovd_DQzc.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_BNhvXrQk();
+    var require_dist10 = require_dist_jRSrzoXr();
     function settingsStoreIsAuthoritativeHere(env) {
       const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
       return raw === "" || raw === "hub";
@@ -61010,8 +61089,8 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
-    var require_retired_settings_keys = require_retired_settings_keys_DVgdWTd7();
+    var require_dist10 = require_dist_jRSrzoXr();
+    var require_retired_settings_keys = require_retired_settings_keys_ovd_DQzc();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -65680,7 +65759,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
+    var require_dist10 = require_dist_jRSrzoXr();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -65817,7 +65896,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
+    var require_dist10 = require_dist_jRSrzoXr();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -66007,7 +66086,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
+    var require_dist10 = require_dist_jRSrzoXr();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -73691,7 +73770,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
+    var require_dist10 = require_dist_jRSrzoXr();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -74256,7 +74335,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
+    var require_dist10 = require_dist_jRSrzoXr();
     var node_child_process = __require("child_process");
     var node_util = __require("util");
     var node_os = __require("os");
@@ -75198,7 +75277,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
+    var require_dist10 = require_dist_jRSrzoXr();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -76314,8 +76393,8 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
-    var require_retired_settings_keys = require_retired_settings_keys_DVgdWTd7();
+    var require_dist10 = require_dist_jRSrzoXr();
+    var require_retired_settings_keys = require_retired_settings_keys_ovd_DQzc();
     var node_crypto = __require("crypto");
     var node_fs = __require("fs");
     var node_module = __require("module");
@@ -78509,7 +78588,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
+    var require_dist10 = require_dist_jRSrzoXr();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -80388,7 +80467,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
+    var require_dist10 = require_dist_jRSrzoXr();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -98449,7 +98528,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
+    var require_dist10 = require_dist_jRSrzoXr();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -100392,9 +100471,9 @@ var require_event_category_EY0GNjV9 = __commonJS({
   }
 });
 
-// ../types/dist/sleep-BCRrMlni.js
-var require_sleep_BCRrMlni = __commonJS({
-  "../types/dist/sleep-BCRrMlni.js"(exports) {
+// ../types/dist/sleep-CSodb2vQ.js
+var require_sleep_CSodb2vQ = __commonJS({
+  "../types/dist/sleep-CSodb2vQ.js"(exports) {
     "use strict";
     var require_event_category = require_event_category_EY0GNjV9();
     var zod = require_zod();
@@ -102922,6 +103001,7 @@ var require_sleep_BCRrMlni = __commonJS({
           testRule: (input) => dispatch("notification-rules", "notificationRules", "testRule", "mutation", input),
           getConditionCatalog: (input) => dispatch("notification-rules", "notificationRules", "getConditionCatalog", "query", input),
           getHistory: (input) => dispatch("notification-rules", "notificationRules", "getHistory", "query", input),
+          resolveArtifactUrl: (input) => dispatch("notification-rules", "notificationRules", "resolveArtifactUrl", "query", input),
           listSnoozes: (input) => dispatch("notification-rules", "notificationRules", "listSnoozes", "query", input),
           createSnooze: (input) => dispatch("notification-rules", "notificationRules", "createSnooze", "mutation", input),
           cancelSnooze: (input) => dispatch("notification-rules", "notificationRules", "cancelSnooze", "mutation", input),
@@ -103265,6 +103345,7 @@ var require_sleep_BCRrMlni = __commonJS({
           locateSegment: (input) => dispatchSystem("recording", "locateSegment", "query", input),
           readSegmentBytes: (input) => dispatchSystem("recording", "readSegmentBytes", "query", input),
           readGopBytes: (input) => dispatchSystem("recording", "readGopBytes", "query", input),
+          readWindowBytes: (input) => dispatchSystem("recording", "readWindowBytes", "query", input),
           setDeviceConfig: (input) => dispatchSystem("recording", "setDeviceConfig", "mutation", input),
           rescanStorage: (input) => dispatchSystem("recording", "rescanStorage", "mutation", input),
           pruneFootage: (input) => dispatchSystem("recording", "pruneFootage", "mutation", input),
@@ -103946,7 +104027,7 @@ var require_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_event_category = require_event_category_EY0GNjV9();
-    var require_sleep = require_sleep_BCRrMlni();
+    var require_sleep = require_sleep_CSodb2vQ();
     var require_err_msg = require_err_msg_COpsHMw2();
     var CAP_INPUT_DEFAULTS = Object.freeze({
       "addons": { "getLogs": { "limit": 100 } },
@@ -121685,7 +121766,7 @@ var require_dist3 = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_BNhvXrQk();
+    var require_dist10 = require_dist_jRSrzoXr();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -202333,7 +202414,7 @@ var require_dist4 = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_event_category = require_event_category_EY0GNjV9();
-    var require_sleep = require_sleep_BCRrMlni();
+    var require_sleep = require_sleep_CSodb2vQ();
     var require_canonical_hash = require_canonical_hash_DNV8S5ET();
     var require_enums2 = require_enums();
     var require_err_msg = require_err_msg_COpsHMw2();
@@ -213320,7 +213401,23 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       updatedAt: zod.z.number(),
       /** Failure detail — present on a `dead` row. */
       error: zod.z.string().optional(),
-      subject: NcHistorySubjectSchema
+      subject: NcHistorySubjectSchema,
+      /**
+      * Ids of the artefacts (still, then gif, then clip) this row's successful
+      * delivery indexed in the artefact library — a REFERENCE, never the bytes
+      * (an artefact is often megabytes; this row is durable JSON rewritten on
+      * every delivery attempt). Absent on a row still pending/dead, a row
+      * delivered before this field shipped, or a wiring with no artefact index.
+      *
+      * Resolve one to a fetchable URL with `resolveArtifactUrl` — an id
+      * outlives any one URL's TTL, so a caller mints a fresh link on demand
+      * rather than trusting one frozen at delivery time. `resolveArtifactUrl`
+      * also answers `null` for an id whose artefact has since expired past the
+      * retained shelf's own age bound — the degrade a caller (the Home
+      * Assistant export) must render as "no image right now", never as a
+      * broken link.
+      */
+      artifactIds: zod.z.array(zod.z.string().min(1)).optional()
     });
     var NC_HISTORY_LIMIT_DEFAULT = 100;
     var NC_HISTORY_LIMIT_MAX = 500;
@@ -213568,6 +213665,20 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         */
         getHistory: require_sleep.method(zod.z.object({ filter: NcHistoryFilterSchema.default({ limit: 100 }) }), zod.z.object({ entries: zod.z.array(NcHistoryEntrySchema) }), { auth: "admin" }),
         /**
+        * Mint a fresh, externally-reachable URL for one artefact a history row
+        * named in {@link NcHistoryEntrySchema.shape.artifactIds} — the SAME
+        * signed-link mechanism the dispatcher uses to attach media to an
+        * outgoing notification (one derivation; this never re-implements it).
+        *
+        * `url: null` on THREE causes a caller must treat identically ("no image
+        * right now", never a broken link): the id is unknown, its artefact has
+        * expired past the retained shelf's own age bound, or this install has no
+        * externally-reachable base URL. A caller that received a URL on a
+        * previous call and now gets `null` must stop showing it — a link that
+        * worked five minutes ago is not proof it works now.
+        */
+        resolveArtifactUrl: require_sleep.method(zod.z.object({ artifactId: zod.z.string().min(1) }), zod.z.object({ url: zod.z.string().nullable() }), { auth: "admin" }),
+        /**
         * Snooze windows currently in effect, plus any whose digest has not yet
         * gone out. `caller: 'required'`: a user sees their OWN windows and the
         * global ones that silence them, never another person's private silence.
@@ -225037,6 +225148,23 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       /** Media ms the returned fragment covers. */
       gopDurMs: zod.z.number()
     });
+    var ReadWindowBytesResultSchema = zod.z.discriminatedUnion("kind", [zod.z.object({
+      kind: zod.z.literal("ok"),
+      data: zod.z.instanceof(Uint8Array),
+      /** Absolute epoch ms of the returned bytes' first sample — at or before
+      *  the requested `fromMs` (anchored on the nearest keyframe). */
+      gopStartMs: zod.z.number(),
+      /** Media ms the returned bytes cover, from `gopStartMs`. */
+      gopDurMs: zod.z.number(),
+      /** `false` ⇒ the safety byte cap cut the read short before it reached
+      *  the requested `toMs`; the caller got fewer frames than asked for. */
+      reachesRequestedEnd: zod.z.boolean()
+    }), zod.z.object({
+      kind: zod.z.literal("spans-multiple-segments"),
+      /** Where the covering segment's own footage runs out — informational,
+      *  not a retry hint (retrying the same window would refuse again). */
+      segmentEndMs: zod.z.number()
+    })]);
     var recordingCapability = {
       name: "recording",
       scope: "system",
@@ -225116,6 +225244,21 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
           kind: "query",
           auth: "admin"
         }),
+        /** Read a WINDOW `[fromMs, toMs)` of segment `startMs`, by mfra byte
+        *  range — the multi-GOP twin of `readGopBytes`. Refuses (does not
+        *  degrade) when the window runs past the covering segment. Used by the
+        *  replay clip's `recording` source to fetch several seconds of native
+        *  footage for its single ffmpeg decode pass. */
+        readWindowBytes: require_sleep.method(zod.z.object({
+          deviceId: zod.z.number(),
+          profile: zod.z.string(),
+          startMs: zod.z.number(),
+          fromMs: zod.z.number(),
+          toMs: zod.z.number()
+        }), ReadWindowBytesResultSchema, {
+          kind: "query",
+          auth: "admin"
+        }),
         setDeviceConfig: require_sleep.method(zod.z.object({
           deviceId: zod.z.number(),
           config: RecordingConfigSchema
@@ -233543,6 +233686,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         addonId: null,
         access: "view"
       },
+      "notificationRules.resolveArtifactUrl": {
+        capName: "notification-rules",
+        capScope: "system",
+        addonId: null,
+        access: "view"
+      },
       "notificationRules.setAlarmConfig": {
         capName: "notification-rules",
         capScope: "system",
@@ -234947,6 +235096,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         addonId: null,
         access: "view"
       },
+      "recording.readWindowBytes": {
+        capName: "recording",
+        capScope: "system",
+        addonId: null,
+        access: "view"
+      },
       "recording.refreshStorageLocationsForMigration": {
         capName: "recording",
         capScope: "system",
@@ -238029,6 +238184,11 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         form: "single",
         optional: false
       }],
+      "recording.readWindowBytes": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "recording.relocateFootage": [{
         name: "deviceId",
         form: "single",
@@ -238505,6 +238665,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       "recording.pruneFootage",
       "recording.readGopBytes",
       "recording.readSegmentBytes",
+      "recording.readWindowBytes",
       "recording.relocateFootage",
       "recording.renderClip",
       "recording.renderGif",
@@ -242826,6 +242987,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.RawStateResultSchema = require_sleep.RawStateResultSchema;
     exports.ReadGopBytesResultSchema = ReadGopBytesResultSchema;
     exports.ReadSegmentBytesResultSchema = ReadSegmentBytesResultSchema;
+    exports.ReadWindowBytesResultSchema = ReadWindowBytesResultSchema;
     exports.ReadinessRegistry = require_sleep.ReadinessRegistry;
     exports.ReadinessTimeoutError = require_sleep.ReadinessTimeoutError;
     exports.RecentTracksPageSchema = RecentTracksPageSchema;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "camstack",
-  "version": "1.2.45",
+  "version": "1.2.46",
   "description": "CLI tool for managing and running CamStack server",
   "keywords": [
     "camstack",