@camstack/types 1.1.42 → 1.1.44

package/dist/capabilities/pipeline-runner.cap.d.ts

@@ -21,6 +21,39 @@ export declare const NativeCropResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type NativeCropBbox = z.infer<typeof NativeCropBboxSchema>;
 export type NativeCropCapResult = z.infer<typeof NativeCropResultSchema>;
+/** Parent detection context passed to `runDetailSubtree` — the crop's
+ *  originating detection, in FRAME-space coordinates. Reuses
+ *  `NativeCropBboxSchema`'s `{x,y,w,h}` shape (same numeric fields; here
+ *  the coordinates are frame-space rather than getNativeCrop's
+ *  normalized [0,1] convention). */
+declare const DetailParentSchema: z.ZodObject<{
+    bbox: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, z.core.$strip>;
+    className: z.ZodString;
+}, z.core.$strip>;
+/** One child-step result from `runDetailSubtree` — an embedding, label,
+ *  or refined detection produced by running the crop-subtree on a
+ *  single tracked detection. */
+declare const DetailResultSchema: z.ZodObject<{
+    stepId: z.ZodString;
+    className: z.ZodString;
+    score: z.ZodNumber;
+    bbox: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, z.core.$strip>>;
+    embedding: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    alignedCropJpeg: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DetailParent = z.infer<typeof DetailParentSchema>;
+export type DetailResult = z.infer<typeof DetailResultSchema>;
 /**
  * Source enum for motion signals fed to the runner. Extensible — add
  * new variants here when new motion-trigger paths are wired in
@@ -436,7 +469,81 @@ export declare const pipelineRunnerCapability: {
             width: z.ZodNumber;
             height: z.ZodNumber;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * 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).
+         */
+        readonly runDetailSubtree: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            frameHandle: z.ZodOptional<z.ZodObject<{
+                shmId: z.ZodString;
+                slot: z.ZodNumber;
+                seq: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                format: z.ZodEnum<{
+                    jpeg: "jpeg";
+                    rgb: "rgb";
+                    bgr: "bgr";
+                    yuv420: "yuv420";
+                    gray: "gray";
+                }>;
+                pts: z.ZodNumber;
+                byteLength: z.ZodNumber;
+                nodeId: z.ZodString;
+                slotCount: z.ZodNumber;
+            }, z.core.$strip>>;
+            cropJpeg: z.ZodOptional<z.ZodString>;
+            parent: z.ZodObject<{
+                bbox: z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$strip>;
+                className: z.ZodString;
+            }, z.core.$strip>;
+            steps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
+            details: z.ZodArray<z.ZodObject<{
+                stepId: z.ZodString;
+                className: z.ZodString;
+                score: z.ZodNumber;
+                bbox: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$strip>>;
+                embedding: z.ZodOptional<z.ZodString>;
+                label: z.ZodOptional<z.ZodString>;
+                alignedCropJpeg: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>, "mutation">;
     };
 };
 export type IPipelineRunnerProvider = InferProvider<typeof pipelineRunnerCapability>;
+/**
+ * Named input/output types for `runDetailSubtree`, derived from the cap
+ * definition above (`InferProvider`) rather than a standalone exported zod
+ * schema — the method's input stays an INLINE `z.object({...})` literal so
+ * `scripts/lib/parse-cap.ts`'s `deviceBound` regex (which only scans a
+ * method's own inline call body for `deviceId: z.number(`) keeps detecting
+ * it as device-bound and `generate-device-proxy.ts` keeps mounting it on
+ * `DeviceProxy.pipelineRunner`. Extracting the input into a separate named
+ * schema constant (as `RunnerCameraConfigSchema` does for `attachCamera`)
+ * would silently drop it from the device proxy — verified via `npm run
+ * codegen` while implementing this cap.
+ */
+export type RunDetailSubtreeInput = Parameters<IPipelineRunnerProvider['runDetailSubtree']>[0];
+export type RunDetailSubtreeResult = NonNullable<Awaited<ReturnType<IPipelineRunnerProvider['runDetailSubtree']>>>;
 export { RunnerCameraConfigSchema, RunnerLocalLoadSchema, RunnerLocalMetricsSchema };

package/dist/capabilities/plate-gallery.cap.d.ts

@@ -1,5 +1,22 @@
 import { z } from 'zod';
 import { type InferProvider } from './capability-definition.js';
+declare const VehicleSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    sampleCount: z.ZodNumber;
+    coverMediaKey: z.ZodOptional<z.ZodString>;
+    coverBase64: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Vehicle = z.infer<typeof VehicleSchema>;
+declare const VehicleSampleInfoSchema: z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+    score: z.ZodNumber;
+    addedAt: z.ZodNumber;
+    deviceId: z.ZodOptional<z.ZodNumber>;
+    base64: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type VehicleSampleInfo = z.infer<typeof VehicleSampleInfoSchema>;
 declare const PlateInfoSchema: z.ZodObject<{
     plateId: z.ZodString;
     deviceId: z.ZodNumber;
@@ -8,6 +25,16 @@ declare const PlateInfoSchema: z.ZodObject<{
     text: z.ZodString;
     score: z.ZodNumber;
     corrected: z.ZodBoolean;
+    recognizedVehicleId: z.ZodOptional<z.ZodString>;
+    vehicleName: z.ZodOptional<z.ZodString>;
+    assigned: z.ZodBoolean;
+    plateBbox: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, z.core.$strip>>;
+    keyFrameMediaKey: z.ZodOptional<z.ZodString>;
     base64: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type PlateInfo = z.infer<typeof PlateInfoSchema>;
@@ -35,6 +62,16 @@ export declare const plateGalleryCapability: {
             text: z.ZodString;
             score: z.ZodNumber;
             corrected: z.ZodBoolean;
+            recognizedVehicleId: z.ZodOptional<z.ZodString>;
+            vehicleName: z.ZodOptional<z.ZodString>;
+            assigned: z.ZodBoolean;
+            plateBbox: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, z.core.$strip>>;
+            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
             base64: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly getPlateByTrack: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
@@ -48,6 +85,16 @@ export declare const plateGalleryCapability: {
             text: z.ZodString;
             score: z.ZodNumber;
             corrected: z.ZodBoolean;
+            recognizedVehicleId: z.ZodOptional<z.ZodString>;
+            vehicleName: z.ZodOptional<z.ZodString>;
+            assigned: z.ZodBoolean;
+            plateBbox: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, z.core.$strip>>;
+            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
             base64: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly getPlateMedia: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
@@ -72,6 +119,16 @@ export declare const plateGalleryCapability: {
             text: z.ZodString;
             score: z.ZodNumber;
             corrected: z.ZodBoolean;
+            recognizedVehicleId: z.ZodOptional<z.ZodString>;
+            vehicleName: z.ZodOptional<z.ZodString>;
+            assigned: z.ZodBoolean;
+            plateBbox: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, z.core.$strip>>;
+            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
             base64: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         /** Suggest groups of near-identical reads (same physical plate) for review/merge. */
@@ -94,6 +151,63 @@ export declare const plateGalleryCapability: {
         readonly deletePlate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             plateId: z.ZodString;
         }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly listVehicles: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            sampleCount: z.ZodNumber;
+            coverMediaKey: z.ZodOptional<z.ZodString>;
+            coverBase64: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly createVehicle: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            sampleCount: z.ZodNumber;
+            coverMediaKey: z.ZodOptional<z.ZodString>;
+            coverBase64: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, "mutation">;
+        readonly renameVehicle: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly deleteVehicle: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly listVehicleSamples: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            vehicleId: z.ZodString;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            text: z.ZodString;
+            score: z.ZodNumber;
+            addedAt: z.ZodNumber;
+            deviceId: z.ZodOptional<z.ZodNumber>;
+            base64: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly removeVehicleSample: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            vehicleId: z.ZodString;
+            sampleId: z.ZodString;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly assignPlate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            plateId: z.ZodString;
+            vehicleId: z.ZodString;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly unassignPlate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            plateId: z.ZodString;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly assignPlates: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            plateIds: z.ZodArray<z.ZodString>;
+            vehicleId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            assigned: z.ZodNumber;
+            failed: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, "mutation">;
+        readonly unassignPlates: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            plateIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            unassigned: z.ZodNumber;
+            failed: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, "mutation">;
     };
 };
 export type IPlateGalleryProvider = InferProvider<typeof plateGalleryCapability>;

package/dist/capabilities/platform-probe.cap.d.ts

@@ -242,6 +242,7 @@ export declare const platformProbeCapability: {
                 openvino: "openvino";
                 tflite: "tflite";
                 pt: "pt";
+                gguf: "gguf";
             }>;
             reason: z.ZodString;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;