camstack 1.2.28 → 1.2.29

package/dist/{chunk-2THGXGK3.js → chunk-LH2PIENV.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-BxO5xNe6.mjs
+// ../types/dist/sleep-zMxKWD0M.mjs
 var WELL_KNOWN_TABS = [
   {
     id: "overview",
@@ -15601,6 +15601,11 @@ var RecordingBandSchema = external_exports.object({
   preBufferSec: external_exports.number().min(0).optional(),
   postBufferSec: external_exports.number().min(0).optional()
 });
+var DEFAULT_EVENTS_BAND_BUFFER_SEC = {
+  preBufferSec: 10,
+  postBufferSec: 30
+};
+var VISIT_MERGE_GAP_MS = DEFAULT_EVENTS_BAND_BUFFER_SEC.postBufferSec * 1e3;
 var RecordingRetentionSchema = external_exports.object({
   maxAgeDays: external_exports.number().min(0).optional(),
   maxSizeGb: external_exports.number().min(0).optional()
@@ -15617,6 +15622,12 @@ var RecordingConfigSchema = external_exports.object({
   /** DERIVED summary of `bands`, stamped by the recorder on every save.
   *  Authoring it has no effect — see {@link RecordingStorageModeSchema}. */
   mode: RecordingStorageModeSchema.optional(),
+  /**
+  * Which assigned broker slots to record. Absent / empty = {@link
+  * DEFAULT_RECORDING_PROFILES} (`high`+`low`) intersected with the
+  * camera's currently assigned slots — never `mid` unless the operator
+  * picks it, and never a slot the broker has not assigned.
+  */
   profiles: external_exports.array(CamProfileSchema).optional(),
   segmentSeconds: external_exports.number().int().positive().optional(),
   /**
@@ -15679,7 +15690,11 @@ var RelocateFootageInputSchema = external_exports.object({
   profiles: external_exports.array(external_exports.string()).optional(),
   /** Copy throttle in MB/s (default 40) — the drain is a background chore,
   *  never allowed to starve live writers. */
-  throttleMbps: external_exports.number().min(1).max(1e3).optional()
+  throttleMbps: external_exports.number().min(1).max(1e3).optional(),
+  /** Move only segments whose startMs is >= this. Absent = the whole source
+  *  pile. Used when a full drain is too expensive and the operator only
+  *  wants the recent window on the new disk. */
+  sinceMs: external_exports.number().int().optional()
 });
 var StorageMigrationLeaseInputSchema = external_exports.object({ leaseId: external_exports.string().min(1) });
 var StorageMigrationFootageMoveInputSchema = RelocateFootageInputSchema.extend({ leaseId: external_exports.string().min(1) });
@@ -22666,6 +22681,7 @@ var NcSystemEventKindSchema = external_exports.enum([
   "node-offline",
   "node-inference-unavailable",
   "detection-blind",
+  "addon-crash-loop",
   "addon-update-available",
   "server-update-available",
   "alarm-triggered",
@@ -22673,6 +22689,9 @@ var NcSystemEventKindSchema = external_exports.enum([
   "alarm-disarmed",
   "alarm-arming",
   "alarm-arm-refused",
+  "addon-updated",
+  "server-updated",
+  "export-completed",
   "camera-online",
   "camera-offline",
   "camera-disabled",
@@ -24086,7 +24105,9 @@ var TrackFlagFields = {
   *  `'staging'`. */
   markForTrain: external_exports.boolean().optional(),
   /** Operator marked this track for diagnostic attention. */
-  debug: external_exports.boolean().optional()
+  debug: external_exports.boolean().optional(),
+  /** Operator favourited this track. Pins it against pruning. */
+  favourited: external_exports.boolean().optional()
 };
 var TrackRetrainFields = { retrainStatus: RetrainStatusSchema.optional() };
 var TrackFlagsPatchSchema = external_exports.object(TrackFlagFields);
@@ -24094,6 +24115,7 @@ var TrackFlagsSchema = external_exports.object({
   trackId: external_exports.string(),
   markForTrain: external_exports.boolean(),
   debug: external_exports.boolean(),
+  favourited: external_exports.boolean(),
   /** The lifecycle state the boolean was derived from. Required here (unlike on
   *  a track row) because this shape is only ever produced by the write body,
   *  which always knows it — and a surface that has just written needs to render
@@ -24616,6 +24638,11 @@ var TrackCascadeCountsSchema = external_exports.object({
   /** Per-track CLIP search vectors removed (best-effort). */
   embeddings: external_exports.number().int()
 });
+var DiskReconcileCountsSchema = external_exports.object({
+  mediaDropped: external_exports.number().int(),
+  tracks: external_exports.number().int(),
+  events: external_exports.number().int()
+});
 var EventStoreDeviceFootprintSchema = external_exports.object({
   deviceId: external_exports.number(),
   /** Persisted event rows (motion + object + audio) for the camera. */
@@ -24872,6 +24899,17 @@ var pipelineAnalyticsCapability = {
       auth: "admin"
     }),
     /**
+    * Disk-wins reconcile for one camera. Drops media index rows whose blobs
+    * are gone, then cascades tracks (including favourited and staging) that
+    * have no remaining files. Enrolled identity/vehicle/scene media is never
+    * probed. Trackless motion/audio events with no remaining file are dropped,
+    * including snapshot-less rows.
+    */
+    reconcileFromDisk: method(external_exports.object({ deviceId: external_exports.number() }), DiskReconcileCountsSchema, {
+      kind: "mutation",
+      auth: "admin"
+    }),
+    /**
     * Delete whole tracks (object events) by id for the given device,
     * cascading their media in lockstep. Returns the number of tracks
     * actually deleted plus the ids that could not be removed.
@@ -24890,7 +24928,7 @@ var pipelineAnalyticsCapability = {
       auth: "admin"
     }),
     /**
-    * Set the per-track operator flags (`markForTrain`, `debug`) on ONE track.
+    * Set the per-track operator flags (`markForTrain`, `debug`, `favourited`) on ONE track.
     * The patch is PARTIAL — an omitted key is left untouched — because the
     * three surfaces that write it (admin Events grid, viewer track detail,
     * viewer cluster detail) each own one toggle and must not clobber the other.
@@ -26878,6 +26916,24 @@ var CameraStatusDegradationSchema = external_exports.object({
   /** Wall-clock ms spent on the stage before it was abandoned. */
   elapsedMs: external_exports.number()
 });
+var DiskReconcileJobSchema = external_exports.object({
+  state: external_exports.enum([
+    "idle",
+    "running",
+    "done",
+    "error"
+  ]),
+  total: external_exports.number().int().nonnegative(),
+  completed: external_exports.number().int().nonnegative(),
+  currentDeviceId: external_exports.number().int().nullable(),
+  failed: external_exports.array(external_exports.number().int()).readonly(),
+  mediaDropped: external_exports.number().int().nonnegative(),
+  tracks: external_exports.number().int().nonnegative(),
+  events: external_exports.number().int().nonnegative(),
+  startedAtMs: external_exports.number().int().nullable(),
+  finishedAtMs: external_exports.number().int().nullable(),
+  error: external_exports.string().nullable()
+});
 var CameraStatusSchema = external_exports.object({
   deviceId: external_exports.number(),
   assignment: CameraAssignmentStatusSchema,
@@ -27402,6 +27458,18 @@ var pipelineOrchestratorCapability = {
     * rail without issuing N parallel browser round-trips.
     */
     getCameraStatuses: method(external_exports.object({ deviceIds: external_exports.array(external_exports.number()).optional() }), external_exports.array(CameraStatusSchema).readonly()),
+    /**
+    * Disk-wins fleet reconcile after a recordings wipe. Starts the walk in
+    * the addon process and returns immediately with the job snapshot — the
+    * work outlives the tRPC/UDS 60s timeout. Poll `getReconcileFromDiskStatus`.
+    * Admin-only. Idempotent while a job is already running.
+    */
+    reconcileFromDisk: method(external_exports.void(), DiskReconcileJobSchema, {
+      kind: "mutation",
+      auth: "admin"
+    }),
+    /** Snapshot of the in-flight or last disk-wins fleet reconcile. */
+    getReconcileFromDiskStatus: method(external_exports.void(), DiskReconcileJobSchema, { auth: "admin" }),
     /** List every template the operator has saved. */
     listTemplates: method(external_exports.void(), external_exports.array(PipelineTemplateSchema).readonly()),
     /** Create a new named preset from a given CameraPipelineConfig. */
@@ -28541,8 +28609,57 @@ var ClipSchema = external_exports.object({
     startMs: external_exports.number(),
     endMs: external_exports.number()
   }),
-  /** Thumbnail URL (lazy; e.g. analytics `getEventMedia`). Never inlined. */
-  thumbnail: external_exports.string().optional()
+  /**
+  * Lazy thumbnail URL, never inlined.
+  *
+  * Recording-derived clips (events-mode keep-window, and the prepared
+  * continuous event+fragment visit) MUST use the snapshot of the **main
+  * event of the interval** — `getEventMedia({ eventId, kind: 'snapshot' })`
+  * of the event that owns `kind` (object > motion > audio). Do not extract
+  * a keyframe from the recorded segments. Other providers (onboard, HKSV)
+  * mint their own stills.
+  *
+  * **VOUCHED, never fabricated.** A provider emits this only for an event it
+  * has CONFIRMED owns at least one media row (its own, or its owning track's).
+  * Absent is meaningful — "this visit has no event still" — never "we did not
+  * look". Stamping it from a URL template made 35% of one camera's clips point
+  * at a 404 (device 3836, 2026-08-17: 64 of 179 clips dead, 63 of them motion).
+  * A read that FAILS drops the claim; it never invents it.
+  */
+  thumbnail: external_exports.string().optional(),
+  /**
+  * An instant INSIDE this visit's footage, hole-safe, where a recorded still
+  * can be decoded. Present whenever the visit came from recorded availability;
+  * absent on a per-event padded window (there is no footage to promise).
+  *
+  * This is not a thumbnail and not a second byte path: it is the argument to
+  * the recorder's existing still route. The surface — never the provider —
+  * decides whether to use it. It is the midpoint of the visit's LONGEST
+  * contiguous range, not of the visit: a visit spans its holes by
+  * construction, so a naive midpoint lands in dead air.
+  */
+  stillAtMs: external_exports.number().optional(),
+  /**
+  * Analytics event ids that overlap this visit — a BOUNDED sample, newest
+  * first within kind (object → motion → audio), capped at
+  * {@link MAX_CLIP_EVENT_IDS}. Empty on footage-only clips.
+  *
+  * Bounded because it is not a payload the surface pages through: one visit on
+  * device 615 carried 2 345 ids, and `eventIds` was 99% of a 153 KB
+  * camera-day. Read {@link eventCount} for the true total.
+  */
+  eventIds: external_exports.array(external_exports.string()).optional(),
+  /** How many analytics events actually overlap this visit. Differs from
+  *  `eventIds.length` exactly when the sample was capped — so a truncated
+  *  list is never mistaken for a quiet visit. */
+  eventCount: external_exports.number().int().nonnegative().optional(),
+  /** Intra-visit footage holes (GOP rolls, discarded segments) still shorter
+  *  than `VISIT_MERGE_GAP_MS`. Playback concatenates around them; the timeline
+  *  bar keeps showing them via `recording.getAvailability`. */
+  holes: external_exports.array(external_exports.object({
+    startMs: external_exports.number(),
+    endMs: external_exports.number()
+  })).optional()
 });
 var ClipPlaybackSchema = external_exports.object({
   /** HLS master URL through the hub data-plane (Range + token in path). */
@@ -29090,7 +29207,14 @@ var SearchResultSchema = external_exports.object({
 });
 var AutoUpdateSettingsSchema = external_exports.object({
   channel: ChannelSchema,
-  intervalSeconds: external_exports.number()
+  intervalSeconds: external_exports.number(),
+  /**
+  * Cadence of the "an update exists" POLLER, in seconds. Independent of
+  * `channel`: the poller runs while auto-apply is `off`, because being told
+  * about a publish and installing it are different decisions. Clamped
+  * server-side to 900 s … 604800 s; defaults to 21600 s (6 h).
+  */
+  updateCheckIntervalSeconds: external_exports.number()
 });
 var AddonAutoUpdateSchema = ChannelWithInheritSchema;
 var RestartAddonResultSchema = external_exports.unknown();
@@ -29341,7 +29465,9 @@ var addonsCapability = {
     getAutoUpdateSettings: method(external_exports.void(), AutoUpdateSettingsSchema, { auth: "admin" }),
     setAutoUpdateSettings: method(external_exports.object({
       channel: ChannelSchema,
-      intervalSeconds: external_exports.number().min(300).max(86400).optional()
+      intervalSeconds: external_exports.number().min(300).max(86400).optional(),
+      /** Availability-poll cadence; see AutoUpdateSettingsSchema. */
+      updateCheckIntervalSeconds: external_exports.number().min(900).max(604800).optional()
     }), external_exports.unknown(), {
       kind: "mutation",
       auth: "admin"
@@ -34623,7 +34749,9 @@ var ExportOptionsSchema = external_exports.object({
   includeAudio: external_exports.boolean(),
   maxLifeMs: external_exports.number().int().positive(),
   deleteAfterDownload: external_exports.boolean(),
-  title: external_exports.string().max(200).optional()
+  title: external_exports.string().max(200).optional(),
+  /** Notification-output target ids to ping when this export becomes ready. */
+  notifyTargetIds: external_exports.array(external_exports.string().min(1)).max(20).optional()
 }).superRefine((v, ctx) => {
   if (v.speed !== void 0 && v.timelapse !== void 0) ctx.addIssue({
     code: external_exports.ZodIssueCode.custom,
@@ -34678,14 +34806,23 @@ var recordingExportCapability = {
   scope: "system",
   mode: "singleton",
   methods: {
-    /** Queue a render of `[fromMs,toMs)` for `deviceId`/`profile`. Fails fast
-    *  when no footage covers the range. Returns the queued record. */
+    /** Queue a render of `[fromMs,toMs)` for `deviceId`/`profiles` (legacy
+    *  singular `profile` still accepted). Fails fast when no footage covers
+    *  the range. One job per profile; returns the first queued record. */
     createExport: method(external_exports.object({
       deviceId: external_exports.number(),
-      profile: external_exports.string(),
+      /** @deprecated Prefer `profiles`. Kept so timelapse/notifiers keep working. */
+      profile: external_exports.string().optional(),
+      profiles: external_exports.array(external_exports.string()).min(1).optional(),
       fromMs: external_exports.number(),
       toMs: external_exports.number(),
       options: ExportOptionsSchema
+    }).superRefine((v, ctx) => {
+      if ((v.profiles !== void 0 && v.profiles.length > 0 ? v.profiles : v.profile !== void 0 ? [v.profile] : []).length < 1) ctx.addIssue({
+        code: external_exports.ZodIssueCode.custom,
+        message: "pass profiles[] (min 1) or legacy profile",
+        path: ["profiles"]
+      });
     }), ExportRecordSchema, {
       kind: "mutation",
       auth: "protected"
@@ -39630,6 +39767,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
+  "pipelineAnalytics.reconcileFromDisk": {
+    capName: "pipeline-analytics",
+    capScope: "device",
+    addonId: null,
+    access: "create"
+  },
   "pipelineAnalytics.refreshStorageLocationsForMigration": {
     capName: "pipeline-analytics",
     capScope: "device",
@@ -40032,6 +40175,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "pipelineOrchestrator.getReconcileFromDiskStatus": {
+    capName: "pipeline-orchestrator",
+    capScope: "system",
+    addonId: null,
+    access: "view"
+  },
   "pipelineOrchestrator.listAgentSettings": {
     capName: "pipeline-orchestrator",
     capScope: "system",
@@ -40056,6 +40205,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
+  "pipelineOrchestrator.reconcileFromDisk": {
+    capName: "pipeline-orchestrator",
+    capScope: "system",
+    addonId: null,
+    access: "create"
+  },
   "pipelineOrchestrator.removeAgentSettings": {
     capName: "pipeline-orchestrator",
     capScope: "system",
@@ -43047,6 +43202,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
     form: "single",
     optional: true
   }],
+  "pipelineAnalytics.reconcileFromDisk": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
   "pipelineAnalytics.restageRetrainTrack": [{
     name: "deviceId",
     form: "single",
@@ -44227,6 +44387,18 @@ var UNIT_TABLE = {
     offset: 0
   }
 };
+var MB = 1024 * 1024;
+var DEFAULT_POOL_MEMORY_POLICY = {
+  sampleIntervalMs: 6e4,
+  baselineSettleSamples: 5,
+  baselineSampleCount: 3,
+  restartMultiple: 4,
+  floorBytes: 1024 * MB,
+  ceilingBytes: 3072 * MB,
+  cooldownMs: 30 * 6e4,
+  maxRestartsPerWindow: 6,
+  restartWindowMs: 1440 * 6e4
+};
 
 // src/commands/discover.ts
 var DEFAULT_MULTICAST_GROUP = "239.0.0.0";

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-2THGXGK3.js";
+} from "./chunk-LH2PIENV.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-XHGXNFNV.js");
+  await import("./launcher-MEE5XESN.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-XHGXNFNV.js");
+  await import("./launcher-MEE5XESN.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-5Y5DI4XF.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-LPBV7MTE.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-5Y5DI4XF.js → discover-LPBV7MTE.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-2THGXGK3.js";
+} from "./chunk-LH2PIENV.js";
 import "./chunk-LMMQX4CK.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,