camstack 1.1.23 → 1.1.25

package/dist/{chunk-ODEV2JIB.js → chunk-F4PHL6CW.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-DJaTV2D7.mjs
+// ../types/dist/sleep-Baang_XW.mjs
 var WELL_KNOWN_TABS = [
   {
     id: "overview",
@@ -15132,6 +15132,12 @@ function method(input, output, options) {
     timeoutMs: options?.timeoutMs
   };
 }
+function systemMethod(input, output, options) {
+  return {
+    ...method(input, output, options),
+    systemOnly: true
+  };
+}
 function event(data) {
   return { data };
 }
@@ -19232,6 +19238,7 @@ var PipelineAddonSchemaSchema = external_exports.object({
   defaultModelId: external_exports.string(),
   defaultModelIdByFormat: external_exports.record(external_exports.string(), external_exports.string()).optional(),
   enabledByDefault: external_exports.boolean().optional(),
+  backfillIntoExistingOverrides: external_exports.boolean().optional(),
   defaultConfidence: external_exports.number(),
   group: external_exports.string().optional(),
   configSchema: external_exports.array(ConfigFieldBridge).readonly().optional()
@@ -19500,7 +19507,15 @@ var pipelineExecutorCapability = {
       image: external_exports.instanceof(Uint8Array).optional(),
       referenceImage: external_exports.string().optional(),
       deviceId: external_exports.number().optional(),
-      sessionId: external_exports.string().optional()
+      sessionId: external_exports.string().optional(),
+      /**
+      * Execution plane. 'full' (default) runs the whole tree — benchmark,
+      * reference-image, and detail-subtree calls. 'frame' is the live
+      * per-frame dispatch: ONLY root-plane steps run; crop children
+      * (inputClasses ≠ null) are skipped and served per-track via
+      * pipelineRunner.runDetailSubtree (two-plane design).
+      */
+      plane: external_exports.enum(["full", "frame"]).optional()
     }), PipelineRunResultBridge, { kind: "mutation" }),
     /**
     * Batched run — N raw frames packed into one cap call. The provider
@@ -19671,6 +19686,32 @@ var zonesCapability = {
   */
   runtimeState: external_exports.object({ zones: external_exports.array(ZoneSchema).readonly() })
 };
+var NativeCropBboxSchema = external_exports.object({
+  x: external_exports.number(),
+  y: external_exports.number(),
+  w: external_exports.number(),
+  h: external_exports.number()
+});
+var NativeCropResultSchema = external_exports.object({
+  /** Packed rgb (24-bit) pixels of the crop. */
+  bytes: external_exports.instanceof(Uint8Array),
+  width: external_exports.number().int().positive(),
+  height: external_exports.number().int().positive()
+});
+var DetailParentSchema = external_exports.object({
+  bbox: NativeCropBboxSchema,
+  className: external_exports.string()
+});
+var DetailResultSchema = external_exports.object({
+  stepId: external_exports.string(),
+  className: external_exports.string(),
+  score: external_exports.number(),
+  /** FRAME-space bbox (already mapped back from crop space). */
+  bbox: NativeCropBboxSchema.optional(),
+  embedding: external_exports.string().optional(),
+  label: external_exports.string().optional(),
+  alignedCropJpeg: external_exports.string().optional()
+});
 var motionCooldownMsField = {
   min: 0,
   max: 6e4,
@@ -19996,7 +20037,42 @@ var pipelineRunnerCapability = {
     /** All per-camera metrics in one round-trip. */
     getAllCameraMetrics: method(external_exports.void(), external_exports.array(CameraMetricsWithDeviceIdSchema).readonly()),
     /** List the deviceIds currently attached to this runner. */
-    getLocalCameras: method(external_exports.void(), external_exports.array(external_exports.number()).readonly())
+    getLocalCameras: method(external_exports.void(), external_exports.array(external_exports.number()).readonly()),
+    /**
+    * Best-effort NATIVE-resolution crop of a retention-ring frame. Given the
+    * `FrameHandle` that rode an inference-result event and a normalized `bbox`,
+    * the runner asks the decode worker still holding that frame's NATIVE
+    * surface to GPU/CPU-crop ONLY the ROI at native res and download just the
+    * crop. Returns `null` on a miss (handle not registered, or the worker's
+    * tiny native-retention ring already evicted the frame) — the caller falls
+    * back to a detection-frame crop. Routed to the frame's owning node by
+    * `handle.nodeId`; NEVER ships a full native frame.
+    */
+    getNativeCrop: method(external_exports.object({
+      handle: FrameHandleSchema,
+      bbox: NativeCropBboxSchema,
+      maxWidth: external_exports.number().int().positive().optional()
+    }), NativeCropResultSchema.nullable()),
+    /**
+    * Two-plane design: run the DETAIL subtree (crop children —
+    * embedding, classifier, refiner steps whose `inputClasses ≠ null`)
+    * for a single tracked detection. The per-frame plane (`runPipeline`
+    * with `plane: 'frame'`) skips crop children entirely; a track-level
+    * caller invokes this per-track, on its own cadence, instead of on
+    * every frame. Takes either a `frameHandle` (shm lease/session —
+    * preferred, zero-copy) or a `cropJpeg` fallback when the lease/
+    * session backing the frame is already gone. `steps` narrows which
+    * configured children to run (default: all configured children for
+    * `parent.className`). Returns `null` when neither frame source is
+    * resolvable (handle evicted and no cropJpeg fallback supplied).
+    */
+    runDetailSubtree: method(external_exports.object({
+      deviceId: external_exports.number(),
+      frameHandle: FrameHandleSchema.optional(),
+      cropJpeg: external_exports.string().optional(),
+      parent: DetailParentSchema,
+      steps: external_exports.array(external_exports.string()).optional()
+    }), external_exports.object({ details: external_exports.array(DetailResultSchema) }).nullable(), { kind: "mutation" })
   }
 };
 var MotionStatusSchema = external_exports.object({
@@ -24985,7 +25061,17 @@ var TrackSchema = external_exports.object({
   /** Cumulative normalized distance travelled (0..1 units = full frame width). */
   totalDistance: external_exports.number(),
   state: TrackStateSchema,
-  active: external_exports.boolean()
+  active: external_exports.boolean(),
+  /** Deterministic key-event importance score in [0,1] (server-computed at
+  *  track expiry, recomputed on late label). Absent on legacy rows written
+  *  before scoring shipped — consumers degrade to absence / compute-on-read. */
+  importance: external_exports.number().optional(),
+  /** Id of the track's highest-confidence ObjectEvent (its representative
+  *  "best" frame). Absent when the track produced no object events. */
+  bestEventId: external_exports.string().optional(),
+  /** Tag of the importance sub-signal that dominated the score
+  *  (identity|dwell|proximity|class|confidence|travel|zone). */
+  importanceReason: external_exports.string().optional()
 });
 var BaseEventFields = {
   id: external_exports.string(),
@@ -25042,8 +25128,18 @@ var ObjectEventSchema = external_exports.object({
   frameHeight: external_exports.number().optional(),
   /** MediaStore key for the crop attached to this event (if any). */
   mediaKey: external_exports.string().optional(),
+  /** Design B: MediaStore key of the track's native-resolution key frame (the
+  *  best-detection full frame). Resolve via the event-media data-plane
+  *  (`/addon/<addonId>/event-media/<keyFrameMediaKey>`) for a detail view that
+  *  draws `bbox` over the native frame. Absent on legacy rows / non-decoded
+  *  sources — consumers fall back to `mediaKey` (the tight crop). */
+  keyFrameMediaKey: external_exports.string().optional(),
   /** Populated by B5 (recording playback URL for this event). */
-  mediaUrl: external_exports.string().optional()
+  mediaUrl: external_exports.string().optional(),
+  /** The parent track's key-event importance [0,1], propagated to every object
+  *  event of the track (so an event row can be sorted by importance without a
+  *  track join). Absent on legacy rows / before the track was scored. */
+  importance: external_exports.number().optional()
 });
 var AudioEventSchema = external_exports.object({
   ...BaseEventFields,
@@ -25067,7 +25163,8 @@ var MediaFileKindEnum = external_exports.enum([
   "fullFrame",
   "fullFrameBoxed",
   "faceCrop",
-  "plateCrop"
+  "plateCrop",
+  "keyFrame"
 ]);
 var MediaFileSchema = external_exports.object({
   key: external_exports.string(),
@@ -25088,6 +25185,32 @@ var DeviceEventQueryInput = external_exports.object({
   projection: external_exports.enum(["full", "slim"]).optional()
 });
 var ObjectEventQueryInput = DeviceEventQueryInput.extend({ classFilter: external_exports.string().optional() });
+var KeyEventQueryInput = external_exports.object({
+  deviceId: external_exports.number(),
+  /** Window lower bound (track firstSeen ≥ since). */
+  since: external_exports.number(),
+  /** Window upper bound (track firstSeen ≤ until). */
+  until: external_exports.number(),
+  limit: external_exports.number().int().min(1).max(200).default(50),
+  /** Drop tracks scoring below this importance. */
+  minImportance: external_exports.number().min(0).max(1).optional(),
+  /** Restrict to a single class (e.g. 'person'). */
+  classFilter: external_exports.string().optional()
+});
+var KeyEventSchema = external_exports.object({
+  /** The representative event id (the track's best ObjectEvent, else its trackId). */
+  id: external_exports.string(),
+  trackId: external_exports.string(),
+  /** Track start time (firstSeen). */
+  timestamp: external_exports.number(),
+  className: external_exports.string(),
+  label: external_exports.string().optional(),
+  importance: external_exports.number(),
+  /** Highest-confidence ObjectEvent id for the track (empty when none). */
+  bestEventId: external_exports.string(),
+  /** Track lifetime in ms (lastSeen - firstSeen). */
+  windowMs: external_exports.number().optional()
+});
 var TrackedDetectionSchema = external_exports.object({
   trackId: external_exports.string(),
   className: external_exports.string(),
@@ -25136,6 +25259,15 @@ var pipelineAnalyticsCapability = {
     getMotionEvents: method(DeviceEventQueryInput, external_exports.array(MotionEventSchema).readonly()),
     getObjectEvents: method(ObjectEventQueryInput, external_exports.array(ObjectEventSchema).readonly()),
     getAudioEvents: method(DeviceEventQueryInput, external_exports.array(AudioEventSchema).readonly()),
+    /**
+    * Importance-ranked highlights for a device+window. Queries completed
+    * tracks by (deviceId, firstSeen ∈ [since,until]), scores each (or reuses
+    * the persisted score), filters by minImportance/classFilter, orders by
+    * importance desc, and returns up to `limit` compact key events mapped to
+    * each track's best event. Legacy tracks lacking a persisted score are
+    * scored on-read (no write). Degrades to `[]` on error.
+    */
+    getKeyEvents: method(KeyEventQueryInput, external_exports.array(KeyEventSchema).readonly()),
     /** Server-side bucketed event counts for the 24-hour timeline.
     *  Returns one entry per non-empty bucket; empty buckets are omitted. */
     getEventDensity: method(external_exports.object({
@@ -26102,7 +26234,20 @@ var snapshotCapability = {
     invalidateCache: method(external_exports.object({ deviceId: external_exports.number() }), external_exports.void(), {
       kind: "mutation",
       auth: "admin"
-    })
+    }),
+    /**
+    * Cache-only batch overview — answers from the wrapper's in-memory cache in
+    * O(n) and NEVER triggers a capture. Lets a grid skip requesting images for
+    * devices that never produced a frame, and gives it an ETag per device for
+    * conditional (304-able) image fetches. `lastCapturedAt`/`cacheAgeMs`/`etag`
+    * are null for a device with no cached frame.
+    */
+    getSnapshotOverview: systemMethod(external_exports.object({ deviceIds: external_exports.array(external_exports.number()).min(1).max(200) }), external_exports.array(external_exports.object({
+      deviceId: external_exports.number(),
+      lastCapturedAt: external_exports.number().nullable(),
+      cacheAgeMs: external_exports.number().nullable(),
+      etag: external_exports.string().nullable()
+    })))
   },
   status: {
     schema: SnapshotStatusSchema,
@@ -27500,7 +27645,17 @@ var FaceInfoSchema = external_exports.object({
   recognizedIdentityId: external_exports.string().optional(),
   identityName: external_exports.string().optional(),
   assigned: external_exports.boolean(),
-  base64: external_exports.string().optional()
+  base64: external_exports.string().optional(),
+  /** Design B: the face bbox (pixel space) on the key frame — lets a detail
+  *  view draw the box over the native `keyFrameMediaKey` frame. Absent on
+  *  legacy rows written before design B. */
+  faceBbox: BoundingBoxSchema.optional(),
+  /** Design B: MediaStore key of the track's native-resolution key frame.
+  *  Fetch the native JPEG via the event-media data-plane
+  *  (`/addon/<addonId>/event-media/<keyFrameMediaKey>`). Absent when the
+  *  track produced no key frame (e.g. native/onboard source) — the UI falls
+  *  back to the inline `base64` face crop. */
+  keyFrameMediaKey: external_exports.string().optional()
 });
 var FaceFilterEnum = external_exports.enum([
   "unassigned",
@@ -31888,6 +32043,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "pipelineAnalytics.getKeyEvents": {
+    capName: "pipeline-analytics",
+    capScope: "device",
+    addonId: null,
+    access: "view"
+  },
   "pipelineAnalytics.getMotionEvents": {
     capName: "pipeline-analytics",
     capScope: "device",
@@ -32416,12 +32577,24 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "pipelineRunner.getNativeCrop": {
+    capName: "pipeline-runner",
+    capScope: "system",
+    addonId: null,
+    access: "view"
+  },
   "pipelineRunner.reportMotion": {
     capName: "pipeline-runner",
     capScope: "system",
     addonId: null,
     access: "create"
   },
+  "pipelineRunner.runDetailSubtree": {
+    capName: "pipeline-runner",
+    capScope: "system",
+    addonId: null,
+    access: "create"
+  },
   "plateGallery.correctPlateText": {
     capName: "plate-gallery",
     capScope: "system",
@@ -32782,6 +32955,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "snapshot.getSnapshotOverview": {
+    capName: "snapshot",
+    capScope: "device",
+    addonId: null,
+    access: "view"
+  },
   "snapshot.invalidateCache": {
     capName: "snapshot",
     capScope: "device",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-ODEV2JIB.js";
+} from "./chunk-F4PHL6CW.js";
 import "./chunk-K3NQKI34.js";
 
 // src/cli.ts
@@ -1079,7 +1079,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-VNCOKFC2.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-BDNJGQ2G.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-VNCOKFC2.js → discover-BDNJGQ2G.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-ODEV2JIB.js";
+} from "./chunk-F4PHL6CW.js";
 import "./chunk-K3NQKI34.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,

package/package.json

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