camstack 1.2.130 → 1.2.133

package/dist/{chunk-FK6R4ZJQ.js → chunk-LMISNMUF.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-DMghvp8F.mjs
+// ../types/dist/sleep-ox21Ig4I.mjs
 var WELL_KNOWN_TABS = [
   {
     id: "overview",
@@ -20299,7 +20299,7 @@ var detectionPipelineCapability = {
 var SourceInfoSchema = external_exports.object({
   /** Live dispatch key — mutable when the source system allows rename. */
   id: external_exports.string(),
-  /** Source system tag — e.g. 'homeassistant' | 'reolink' | 'frigate'. */
+  /** Source system tag — e.g. 'homeassistant' | 'reolink' | 'onvif'. */
   system: external_exports.string(),
   /** Immutable upstream identifier when available (HA `unique_id`, … ).
   *  Used to detect rename when `id` changes. */
@@ -24872,7 +24872,7 @@ var NcRuleInputSchema = external_exports.object({
   * The measured seven-person arrival on device 590 spans 110 s with every
   * internal gap under 30 s. A 12 s fixed window cuts it into three groups; an
   * idle cutoff holds it as one and ends it when the arrival actually ends.
-  * 30 is Frigate's shipped value for the same decision.
+  * 30 s is a widely shipped value for the same decision.
   *
   * ### What it replaces
   *
@@ -26729,6 +26729,12 @@ var ZoneCrossingSchema = external_exports.object({
   /** Zone display name at crossing time (falls back to the id). */
   zoneName: external_exports.string().optional()
 });
+var ZoneOverlapSchema = external_exports.object({
+  zoneId: external_exports.string(),
+  zoneName: external_exports.string().optional(),
+  /** Percentage of the BOX area inside the zone, 0–100. */
+  overlapPct: external_exports.number()
+});
 var ObjectEventSchema = external_exports.object({
   ...BaseEventFields,
   kind: external_exports.literal("object"),
@@ -26753,6 +26759,35 @@ var ObjectEventSchema = external_exports.object({
   bbox: BoundingBoxSchema.optional(),
   /** Heavy JSON — omitted in slim projection. */
   zones: external_exports.array(external_exports.string()).readonly().optional(),
+  /**
+  * How far inside each stamped zone the box actually was, as a percentage of
+  * the BOX area.
+  *
+  * Membership alone cannot express "at least a third of it inside", which is
+  * the bar an operator argues with — and the number already existed: the
+  * engine computed it, the pipeline logged it, and then discarded it. It
+  * matters most on the events that carry no track, where a rule has nothing
+  * else to judge by.
+  */
+  zoneOverlaps: external_exports.array(ZoneOverlapSchema).readonly().optional(),
+  /**
+  * Present when this event describes a detection the TRACKER refused, so it
+  * has no track and never will.
+  *
+  * A zone-scoped immediate rule asks "is there an animal in the flowerbed
+  * NOW?"; tracking answers a different question ("is this the same subject as
+  * before?") whose confirmation threshold presumes continuity. On 2026-09-09 a
+  * dog at 0.7729, 100% inside a watched zone, was refused three times in six
+  * seconds with three different candidate ids — seven analysed frames in the
+  * window, the subject in a handful of them, metres apart — and produced no
+  * event at all.
+  *
+  * It is NAMED rather than merely implied by a missing `trackId`: an event
+  * with no track and no reason is indistinguishable from a track whose media
+  * went missing, and a consumer that asks this one for a best shot or a
+  * history is asking for something that never existed.
+  */
+  spawnRefused: external_exports.string().optional(),
   /** Omitted in slim projection. */
   state: TrackStateSchema.optional(),
   /**
@@ -28232,6 +28267,35 @@ var NativeCropResultSchema = external_exports.object({
   */
   tier: external_exports.enum(["native", "ram-fullframe"]).optional()
 });
+var ParkedFrameKindSchema = external_exports.enum(["keyFrame", "thumbnail"]);
+var ParkRefusalSchema = external_exports.enum(["handle-gone", "encode-failed"]);
+var ParkTrackFrameResultSchema = external_exports.discriminatedUnion("parked", [external_exports.object({
+  parked: external_exports.literal(true),
+  /** The node holding the parcel — what a later retrieval must be pinned to. */
+  nodeId: external_exports.string(),
+  width: external_exports.number().int().positive(),
+  height: external_exports.number().int().positive(),
+  /** JPEG bytes the parcel costs on the node. */
+  bytes: external_exports.number().int().nonnegative(),
+  /** Whether this park replaced a parcel already held for the key. */
+  replaced: external_exports.boolean()
+}), external_exports.object({
+  parked: external_exports.literal(false),
+  nodeId: external_exports.string(),
+  reason: ParkRefusalSchema,
+  /** Age of the handle at the park, on the runner's clock; null if unknown. */
+  handleAgeMs: external_exports.number().nullable(),
+  detail: external_exports.string().optional()
+})]);
+var ParkedTrackFrameSchema = external_exports.object({
+  jpeg: external_exports.string(),
+  width: external_exports.number().int().positive(),
+  height: external_exports.number().int().positive(),
+  /** The frame instant the parcel shows (the caller's clock, echoed back). */
+  timestamp: external_exports.number(),
+  /** When the node stored it (the node's clock). */
+  parkedAt: external_exports.number()
+});
 var DetailParentSchema = external_exports.object({
   bbox: NativeCropBboxSchema,
   className: external_exports.string()
@@ -28477,7 +28541,7 @@ var RunnerCameraConfigSchema = external_exports.object({
   * - `analyzer`: ML/frame-diff motion detection (motion-wasm or other
   *   analyzer providers) running on decoded frames in this runner.
   * - `onboard`: camera-native motion pushes (Reolink Baichuan, ONVIF
-  *   analytics, Frigate motion). The provider emits ProviderMotion
+  *   analytics). The provider emits ProviderMotion
   *   events; the orchestrator forwards to `reportMotion`.
   */
   motionSources: MotionSourcesSchema.default(["analyzer"]),
@@ -29008,7 +29072,60 @@ var pipelineRunnerCapability = {
       className: external_exports.string(),
       /** Camera the pixels came from. Diagnostics + log tags ONLY — never routing. */
       sourceDeviceId: external_exports.number()
-    }), RunStatelessStepResultSchema, { kind: "mutation" })
+    }), RunStatelessStepResultSchema, { kind: "mutation" }),
+    /**
+    * PARK a frame for a track at the instant it is judged to matter
+    * ([D422](../../../docs/decisions/adr-0422-a-relevant-frame-is-parked-when-it-becomes-relevant.md)).
+    *
+    * The hub's `BestDetectionTracker` — the single "best per track" policy —
+    * concludes a frame is a track's best and calls this on the node that
+    * owns `handle` (`nodePin(handle.nodeId)`), while the handle is young. The
+    * runner cuts `bbox` from the native surface it already holds (a full
+    * frame for `keyFrame`, the caller's subject window for `thumbnail`),
+    * encodes ONE JPEG, and keeps it under `(deviceId, trackId, kind)`. Every
+    * later consumer retrieves by that key (`getParkedTrackFrame`) — a lookup
+    * that cannot miss on age. D52 holds: the rectangle is cut by the runner,
+    * never a pre-cut tile the caller decided. D9/D18 hold: one compressed
+    * encode at a decision point, never a stream.
+    *
+    * Idempotent per `(trackId, kind)`: a later park replaces (the ranking is
+    * the hub's; this adds no second opinion), an out-of-order older instant
+    * is ignored. Bounded per device and per node on the runner
+    * (`parked-frame-store.ts`), oldest-first eviction, never a refusal for
+    * space. A refusal names its reason and is logged on the runner with the
+    * handle's measured age — it is never retried into a loop.
+    */
+    parkTrackFrame: method(external_exports.object({
+      deviceId: external_exports.number(),
+      /** Opaque to the runner — the hub's track id. */
+      trackId: external_exports.string(),
+      kind: ParkedFrameKindSchema,
+      handle: FrameHandleSchema,
+      /** Normalized [0,1] window to cut. `{0,0,1,1}` for a full frame. */
+      bbox: NativeCropBboxSchema,
+      /** Width cap for a full-frame park (the `keyFrame` native cap). */
+      maxWidth: external_exports.number().int().positive().optional(),
+      /** The frame instant (caller's clock) — orders parks for one key. */
+      timestamp: external_exports.number()
+    }), ParkTrackFrameResultSchema, { kind: "mutation" }),
+    /**
+    * Retrieve a parked parcel by `(deviceId, trackId, kind)`. Pinned to the
+    * node that answered the park (`ParkTrackFrameResult.nodeId`). `null` means
+    * nothing was parked under that key on this node — never "too old".
+    */
+    getParkedTrackFrame: method(external_exports.object({
+      deviceId: external_exports.number(),
+      trackId: external_exports.string(),
+      kind: ParkedFrameKindSchema
+    }), ParkedTrackFrameSchema.nullable()),
+    /**
+    * Drop every parcel of a track — the hub closed it. Idempotent. A track
+    * whose release is lost ages out on the runner under a hard ceiling.
+    */
+    releaseParkedTrackFrames: method(external_exports.object({
+      deviceId: external_exports.number(),
+      trackId: external_exports.string()
+    }), external_exports.object({ released: external_exports.number().int().nonnegative() }), { kind: "mutation" })
   }
 };
 var CameraPipelineConfigSchema = external_exports.object({
@@ -32606,8 +32723,8 @@ var batteryCapability = {
   /**
   * Runtime-state slice — every provider that registers this cap
   * stores the same shape under `device.runtimeState[battery]`.
-  * Cross-provider uniformity: a Reolink Argus, a Frigate sensor
-  * proxy, an ONVIF battery cam all read/write the same keys.
+  * Cross-provider uniformity: a Reolink Argus, a sensor proxy,
+  * an ONVIF battery cam all read/write the same keys.
   * Consumers (BatteryBadge, snapshot wrapper sleep gate) read once
   * via `device.runtimeState.getCapState('battery')` regardless of
   * the underlying driver.
@@ -34460,7 +34577,7 @@ var AvailableIntegrationTypeSchema = external_exports.object({
   * Which integration-marker cap the addon declared, so the wizard can
   * branch on CAP — never on addon name. `device-adoption` integrations
   * (Home Assistant, …) route through the broker step (Approach A);
-  * `device-provider` integrations (Reolink/Frigate/ONVIF) keep the
+  * `device-provider` integrations (Reolink/ONVIF) keep the
   * legacy config → discovery flow.
   */
   kind: external_exports.enum(["device-adoption", "device-provider"]),
@@ -37714,9 +37831,11 @@ var RecordingManifestSchema = external_exports.object({
 });
 var RecordingDeviceUsageSchema = external_exports.object({
   deviceId: external_exports.number(),
+  /** Bytes the ARCHIVE holds for this camera on this node's resolvable
+  *  recordings locations. */
   usedBytes: external_exports.number(),
   /**
-  * Start of this camera's OLDEST indexed segment, across every profile and
+  * Start of this camera's OLDEST ARCHIVED segment, across every profile and
   * location — the "Oldest footage" column in Recordings → Storage, and the
   * only honest answer to "is retention actually holding?" per camera.
   *
@@ -37726,7 +37845,24 @@ var RecordingDeviceUsageSchema = external_exports.object({
   * (types) and the addon ship on different trains, and the addon is usually
   * the later of the two.
   */
-  oldestMs: external_exports.number().nullable().optional()
+  oldestMs: external_exports.number().nullable().optional(),
+  /** Segments the archive holds for this camera — the "M" beside `usedBytes`.
+  *  OPTIONAL for the same train-skew reason as `oldestMs`. */
+  segments: external_exports.number().optional(),
+  /**
+  * RESIDENCY, not the archive: bytes the recorder process currently holds in
+  * its RAM index — the live tail plus the hours a reader hydrated.
+  *
+  * It answers "what can be served without touching the disk", never "how much
+  * footage this camera has". A UI that renders it must label it as such, and
+  * must never total it as storage. OPTIONAL: a recorder predating D418 omits
+  * it, and so does a node whose ledger could not answer.
+  */
+  residentBytes: external_exports.number().optional(),
+  /** The residency counterpart of `oldestMs` — the oldest segment currently in
+  *  RAM, which on a healthy recorder is minutes ago and means nothing about
+  *  retention. `null` = nothing resident. */
+  residentOldestMs: external_exports.number().nullable().optional()
 });
 var RecordingLocationUsageSchema = external_exports.object({
   /** StorageLocation id; null for the legacy/degraded single-root fallback. */
@@ -37760,6 +37896,17 @@ var RecordingStorageUsageSchema = external_exports.object({
   totalUsedBytes: external_exports.number(),
   devices: external_exports.array(RecordingDeviceUsageSchema),
   /**
+  * WHERE `devices[]` came from, so an empty table is never mistaken for empty
+  * disks (D418).
+  *
+  * `archive` = the durable hour ledger answered. `unavailable` = this node
+  * declared no ledger and the recorder REFUSED rather than answering the
+  * question with the resident index (D295 rule 3) — the rows are UNKNOWN, not
+  * zero, and a UI must say so. OPTIONAL: a recorder predating D418 omits it,
+  * and its rows are residency.
+  */
+  devicesRead: external_exports.enum(["archive", "unavailable"]).optional(),
+  /**
   * Per-physical-volume capacity. OPTIONAL, and consumers must render the rest
   * of the payload without it: the hub serves this method through a BAKED
   * router, so a hub whose framework train predates a change to this array
@@ -44528,6 +44675,24 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "pipelineRunner.getParkedTrackFrame": {
+    capName: "pipeline-runner",
+    capScope: "system",
+    addonId: null,
+    access: "view"
+  },
+  "pipelineRunner.parkTrackFrame": {
+    capName: "pipeline-runner",
+    capScope: "system",
+    addonId: null,
+    access: "create"
+  },
+  "pipelineRunner.releaseParkedTrackFrames": {
+    capName: "pipeline-runner",
+    capScope: "system",
+    addonId: null,
+    access: "create"
+  },
   "pipelineRunner.reportMotion": {
     capName: "pipeline-runner",
     capScope: "system",
@@ -47805,6 +47970,21 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
     form: "single",
     optional: false
   }],
+  "pipelineRunner.getParkedTrackFrame": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
+  "pipelineRunner.parkTrackFrame": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
+  "pipelineRunner.releaseParkedTrackFrames": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
   "pipelineRunner.reportMotion": [{
     name: "deviceId",
     form: "single",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-FK6R4ZJQ.js";
+} from "./chunk-LMISNMUF.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-O4PI5LJI.js");
+  await import("./launcher-G2NZEBWS.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-O4PI5LJI.js");
+  await import("./launcher-G2NZEBWS.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-Q75B3UUE.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-R4IJGYTA.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-Q75B3UUE.js → discover-R4IJGYTA.js}

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