@camstack/types 1.2.110 → 1.2.111

package/dist/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_event_category = require("./event-category-EY0GNjV9.js");
-const require_sleep = require("./sleep-DnbNfEhn.js");
+const require_sleep = require("./sleep-BCRrMlni.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 //#region src/generated/cap-input-defaults.ts
 /**

package/dist/addon.mjs

@@ -1,5 +1,5 @@
 import { t as EventCategory } from "./event-category-CIa_iT6b.mjs";
-import { B as ReadinessRegistry, E as adminUiCapability, L as nodePin, R as readNodePin, St as emitReadiness, T as DeviceType, V as ReadinessTimeoutError, W as scopeKey, _t as DisposerChain, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, gt as DATAPLANE_SECRET_HEADER, h as createEventBusSliceSource, j as expandCapMethods, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, vt as BaseAddon, x as viewerUiCapability, yt as normalizeAddonInitResult } from "./sleep-swxwnJmL.mjs";
+import { B as ReadinessRegistry, E as adminUiCapability, L as nodePin, R as readNodePin, St as emitReadiness, T as DeviceType, V as ReadinessTimeoutError, W as scopeKey, _t as DisposerChain, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, gt as DATAPLANE_SECRET_HEADER, h as createEventBusSliceSource, j as expandCapMethods, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, vt as BaseAddon, x as viewerUiCapability, yt as normalizeAddonInitResult } from "./sleep-DJlqY62B.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 //#region src/generated/cap-input-defaults.ts
 /**

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

@@ -1338,6 +1338,34 @@ declare const EventPruneCountsSchema: z.ZodObject<{
     audio: z.ZodNumber;
 }, z.core.$strip>;
 export type EventPruneCounts = z.infer<typeof EventPruneCountsSchema>;
+declare const ReplayTrackSchema: z.ZodObject<{
+    className: z.ZodString;
+    firstSeenMs: z.ZodNumber;
+    lastSeenMs: z.ZodNumber;
+    bbox: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, z.core.$strip>;
+    framesMatched: z.ZodNumber;
+}, z.core.$strip>;
+declare const RunReplayFrameProcessorResultSchema: z.ZodObject<{
+    tracks: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        className: z.ZodString;
+        firstSeenMs: z.ZodNumber;
+        lastSeenMs: z.ZodNumber;
+        bbox: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, z.core.$strip>;
+        framesMatched: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ReplayTrack = z.infer<typeof ReplayTrackSchema>;
+export type RunReplayFrameProcessorResult = z.infer<typeof RunReplayFrameProcessorResultSchema>;
 export declare const pipelineAnalyticsCapability: {
     readonly name: "pipeline-analytics";
     readonly scope: "device";
@@ -2751,6 +2779,73 @@ export declare const pipelineAnalyticsCapability: {
             reason: z.ZodString;
             detail: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>], "kind">, "mutation">;
+        /**
+         * The FrameProcessor pass of a replay run — see the `Replay` section
+         * above this capability's definition for why this is not the
+         * `processFrame` method this file's header says pipeline-analytics does
+         * not have.
+         *
+         * Constructs a FRESH `FrameProcessor` for `(deviceId, source)`, feeds it
+         * `frames` IN THE ORDER GIVEN (the caller is responsible for time
+         * ordering — this method does not sort), and returns the tracks it
+         * produced. Zero persistence: no `TrackStore`, no event bus, no media
+         * capture. `zones` / `detectionRules` are the run's OWN zone set —
+         * typically the camera's real zones plus an ephemeral overlay
+         * (`addon-benchmark`'s `replay-plan.ts`), never read from or written to
+         * the `zones` capability by this method itself.
+         */
+        readonly runReplayFrameProcessor: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            source: z.ZodEnum<{
+                pipeline: "pipeline";
+                onboard: "onboard";
+            }>;
+            zones: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                kind: z.ZodDefault<z.ZodEnum<{
+                    polygon: "polygon";
+                    tripwire: "tripwire";
+                }>>;
+                polygon: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>>>;
+                color: z.ZodDefault<z.ZodString>;
+            }, z.core.$strip>>>>;
+            detectionRules: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+                zoneIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+                mode: z.ZodEnum<{
+                    include: "include";
+                    exclude: "exclude";
+                }>;
+                classFilter: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+                overlapThreshold: z.ZodOptional<z.ZodNumber>;
+                bboxInclusionPct: z.ZodOptional<z.ZodNumber>;
+                preferMask: z.ZodOptional<z.ZodBoolean>;
+                enabled: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strip>>>>;
+            zoneMembershipMinOverlap: z.ZodOptional<z.ZodNumber>;
+            frames: z.ZodArray<z.ZodObject<{
+                timestamp: z.ZodNumber;
+                frame: z.ZodCustom<import("../index.js").FrameResult, import("../index.js").FrameResult>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            tracks: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                className: z.ZodString;
+                firstSeenMs: z.ZodNumber;
+                lastSeenMs: z.ZodNumber;
+                bbox: z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$strip>;
+                framesMatched: z.ZodNumber;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, "mutation">;
         /** Every annotation on a track, oldest first. */
         readonly listRetrainAnnotations: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             trackId: z.ZodString;

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

@@ -638,6 +638,56 @@ export declare const pipelineExecutorCapability: {
             success: z.ZodLiteral<true>;
             clearedDevices: z.ZodNumber;
         }, z.core.$strip>, "mutation">;
+        /**
+         * Which of THIS node's inference devices the executor currently refuses,
+         * and why. `nodeId` is the ROUTING key (stripped by the generated router).
+         *
+         * The channel that did not exist. Pool health was known only inside the
+         * detection addon and was an input to no routing decision anywhere: the
+         * per-dispatch capability gate is keyed on model FORMAT and so can never
+         * separate `openvino:gpu` from `openvino:npu`, and the orchestrator's live
+         * eligibility probe (`platformProbe.getCapabilities`) answers about
+         * HARDWARE — which was present throughout. So when the hub's `openvino:gpu`
+         * Python worker was SIGABRT'd by the Intel GPU plugin on 2026-08-25, the
+         * balancer went on handing that dead pool cameras by rotation for 31 hours:
+         * ~370 000 `PoolWorker[w0]: not initialized` lines, every frame lost.
+         *
+         * Read semantics the caller depends on, and which the provider guarantees:
+         * this is a synchronous read of in-memory state. It never probes hardware,
+         * never spawns a pool and never throws — an EMPTY `unhealthy` means "asked,
+         * nothing is refused", which is what re-admits a device. A read that FAILS
+         * (node offline, version skew) must therefore be distinguishable from an
+         * empty answer, and it is: it rejects.
+         */
+        readonly getInferenceDeviceHealth: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            nodeId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            unhealthy: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                deviceKey: z.ZodString;
+                state: z.ZodEnum<{
+                    failed: "failed";
+                    backoff: "backoff";
+                }>;
+                since: z.ZodNumber;
+                deaths: z.ZodNumber;
+                lastError: z.ZodString;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Re-arm a terminally `failed` inference device on `nodeId`: forget its
+         * restart budget so the next dispatch builds a fresh pool.
+         *
+         * The terminal state is deliberate (the abort it bounds is deterministic —
+         * an automatic probation would just respawn Python forever, more slowly),
+         * and a terminal state an operator cannot leave is a silent fault. This is
+         * the way out. `rearmed:false` means there was nothing to forget.
+         */
+        readonly rearmInferenceDevice: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            nodeId: z.ZodString;
+            deviceKey: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            rearmed: z.ZodBoolean;
+        }, z.core.$strip>, "mutation">;
         readonly getSchema: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
             availableEngines: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 engine: z.ZodObject<{

package/dist/generated/addon-api.d.ts

@@ -5108,6 +5108,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof pipelineAnalyticsCapability.methods.proposeRetrainAnnotations.output>;
             meta: object;
         }>;
+        runReplayFrameProcessor: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof pipelineAnalyticsCapability.methods.runReplayFrameProcessor.input>;
+            output: z.infer<typeof pipelineAnalyticsCapability.methods.runReplayFrameProcessor.output>;
+            meta: object;
+        }>;
         listRetrainAnnotations: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;
@@ -5248,6 +5255,20 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof pipelineExecutorCapability.methods.clearDeviceOverrides.output>;
             meta: object;
         }>;
+        getInferenceDeviceHealth: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof pipelineExecutorCapability.methods.getInferenceDeviceHealth.input>;
+            output: z.infer<typeof pipelineExecutorCapability.methods.getInferenceDeviceHealth.output>;
+            meta: object;
+        }>;
+        rearmInferenceDevice: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof pipelineExecutorCapability.methods.rearmInferenceDevice.input>;
+            output: z.infer<typeof pipelineExecutorCapability.methods.rearmInferenceDevice.output>;
+            meta: object;
+        }>;
         getSchema: TRPCQueryProcedure<{
             input: {
                 nodeId?: string | undefined;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 958 method paths across 123 capabilities.
+ * Coverage: 961 method paths across 123 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/method-device-selectors.d.ts

@@ -6,7 +6,7 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 342 methods carry a device reference, of which
+ * Coverage: 343 methods carry a device reference, of which
  * 127 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying

package/dist/generated/system-proxy.d.ts

@@ -83,7 +83,7 @@ export interface SystemProxy {
     readonly nodes: Pick<InferProvider<typeof nodesCapability>, 'topology' | 'deployAddon' | 'undeployAddon' | 'restartAddon' | 'restartProcess' | 'restartNode' | 'shutdownNode' | 'renameNode' | 'clusterAddonStatus' | 'getCapUsageGraph' | 'getNodeAddons' | 'setProcessLogLevel' | 'executeQuery'>;
     readonly notificationOutput: Pick<InferProvider<typeof notificationOutputCapability>, 'listTargetKinds' | 'listTargets' | 'discoverTargets' | 'send' | 'testTarget' | 'upsertTarget' | 'deleteTarget' | 'setTargetEnabled'>;
     readonly osdManager: Pick<InferProvider<typeof osdManagerCapability>, 'getConditionSupport' | 'copyDeviceConfiguration'>;
-    readonly pipelineExecutor: Pick<InferProvider<typeof pipelineExecutorCapability>, 'getAvailableEngines' | 'getSelectedEngine' | 'getDefaultSteps' | 'getEngineProvisioning' | 'getVideoPipelineSteps' | 'setVideoPipelineSteps' | 'clearDeviceOverrides' | 'getSchema' | 'getGlobalSteps' | 'getGlobalPipelineConfig' | 'getOrchestratorConfigSchema' | 'validatePipeline' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate' | 'getCapabilities' | 'getAddonModels' | 'downloadModel' | 'deleteModel' | 'cacheFrameInPool' | 'inferCached' | 'uncacheFrame' | 'getEffectiveTuning' | 'listLoadedEngines' | 'spinEngine' | 'killEngine' | 'listReferenceImages' | 'getReferenceImage' | 'getReferenceAudioFiles' | 'getReferenceAudio' | 'getAudioCapabilities' | 'runAudioTest' | 'getDetectionConfigSchema'>;
+    readonly pipelineExecutor: Pick<InferProvider<typeof pipelineExecutorCapability>, 'getAvailableEngines' | 'getSelectedEngine' | 'getDefaultSteps' | 'getEngineProvisioning' | 'getVideoPipelineSteps' | 'setVideoPipelineSteps' | 'clearDeviceOverrides' | 'getInferenceDeviceHealth' | 'rearmInferenceDevice' | 'getSchema' | 'getGlobalSteps' | 'getGlobalPipelineConfig' | 'getOrchestratorConfigSchema' | 'validatePipeline' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate' | 'getCapabilities' | 'getAddonModels' | 'downloadModel' | 'deleteModel' | 'cacheFrameInPool' | 'inferCached' | 'uncacheFrame' | 'getEffectiveTuning' | 'listLoadedEngines' | 'spinEngine' | 'killEngine' | 'listReferenceImages' | 'getReferenceImage' | 'getReferenceAudioFiles' | 'getReferenceAudio' | 'getAudioCapabilities' | 'runAudioTest' | 'getDetectionConfigSchema'>;
     readonly pipelineOrchestrator: Pick<InferProvider<typeof pipelineOrchestratorCapability>, 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'rebalance' | 'getPipelineAssignments' | 'getAgentLoad' | 'getGlobalMetrics' | 'getCapabilityBindings' | 'setCapabilityBinding' | 'getIngestOwner' | 'getAudioNodeLoad' | 'getAgentSettings' | 'listAgentSettings' | 'removeAgentSettings' | 'setAgentMaxCameras' | 'setAgentDetectWeight' | 'setAgentCapabilities' | 'setAgentReachableHost' | 'setAgentInferenceDevices' | 'getNodeInferenceDevices' | 'resetNodePipelineDefaults' | 'getCameraStatuses' | 'reconcileFromDisk' | 'getReconcileFromDiskStatus' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate'>;
     readonly pipelineRunner: Pick<InferProvider<typeof pipelineRunnerCapability>, 'attachCamera' | 'reportMotion' | 'getLocalLoad' | 'getLocalMetrics' | 'getAllCameraMetrics' | 'getLocalCameras' | 'getNativeCrop' | 'runStatelessStep'>;
     readonly plateGallery: Pick<InferProvider<typeof plateGalleryCapability>, 'getPlateMedia' | 'searchPlates' | 'suggestPlateClusters' | 'correctPlateText' | 'deletePlate' | 'listVehicles' | 'createVehicle' | 'renameVehicle' | 'deleteVehicle' | 'listVehicleSamples' | 'removeVehicleSample' | 'assignPlate' | 'unassignPlate' | 'assignPlates' | 'unassignPlates'>;