camstack 1.0.4 → 1.0.6

package/dist/{chunk-ACMTCEYY.js → chunk-YPXFYDJW.js}

@@ -18242,6 +18242,24 @@ var DetectorOutputSchema = external_exports.object({
   inferenceMs: external_exports.number(),
   modelId: external_exports.string()
 });
+var EngineProvisioningSchema = external_exports.object({
+  runtimeId: external_exports.enum([
+    "onnx",
+    "openvino",
+    "coreml"
+  ]).nullable(),
+  device: external_exports.string().nullable(),
+  state: external_exports.enum([
+    "idle",
+    "installing",
+    "verifying",
+    "ready",
+    "failed"
+  ]),
+  progress: external_exports.number().optional(),
+  error: external_exports.string().optional(),
+  nextRetryAt: external_exports.number().optional()
+});
 var PipelineStepInputSchema = external_exports.lazy(() => external_exports.object({
   addonId: external_exports.string(),
   modelId: external_exports.string(),
@@ -18319,6 +18337,15 @@ var pipelineExecutorCapability = {
       kind: "mutation",
       auth: "admin"
     }),
+    /**
+    * Per-node detection-engine provisioning snapshot. Returns the live
+    * state of the lazy runtime-provisioning machine on `nodeId`
+    * (idle / installing / verifying / ready / failed). The UI pairs this
+    * one-shot query with the `pipeline.engine-provisioning` live event
+    * (emitted on every transition) to drive a per-node "engine ready?"
+    * indicator without polling. Phase 2.
+    */
+    getEngineProvisioning: method(external_exports.object({ nodeId: external_exports.string() }), EngineProvisioningSchema),
     getVideoPipelineSteps: method(external_exports.void(), external_exports.record(external_exports.string(), external_exports.object({
       modelId: external_exports.string(),
       settings: external_exports.record(external_exports.string(), external_exports.unknown()).readonly()
@@ -22474,7 +22501,10 @@ var AgentAddonConfigSchema = external_exports.object({
   modelId: external_exports.string(),
   settings: external_exports.record(external_exports.string(), external_exports.unknown()).readonly()
 });
-var AgentPipelineSettingsSchema = external_exports.object({ addonDefaults: external_exports.record(external_exports.string(), AgentAddonConfigSchema).readonly() });
+var AgentPipelineSettingsSchema = external_exports.object({
+  addonDefaults: external_exports.record(external_exports.string(), AgentAddonConfigSchema).readonly(),
+  maxCameras: external_exports.number().int().nonnegative().nullable().default(null)
+});
 var CameraPipelineForAgentSchema = external_exports.object({
   steps: external_exports.array(PipelineStepInputSchema).readonly(),
   audio: external_exports.object({
@@ -22543,6 +22573,117 @@ var GlobalMetricsSchema = external_exports.object({
   queueDepth: external_exports.number()
 });
 var CapabilityBindingsSchema = external_exports.record(external_exports.string(), external_exports.string());
+var CameraSourceStreamSchema = external_exports.object({
+  camStreamId: external_exports.string(),
+  codec: external_exports.string(),
+  width: external_exports.number(),
+  height: external_exports.number(),
+  fps: external_exports.number(),
+  kind: external_exports.string()
+});
+var CameraSourceStatusSchema = external_exports.object({ streams: external_exports.array(CameraSourceStreamSchema).readonly() });
+var CameraAssignmentStatusSchema = external_exports.object({
+  detectionNodeId: external_exports.string().nullable(),
+  decoderNodeId: external_exports.string().nullable(),
+  audioNodeId: external_exports.string().nullable(),
+  pinned: external_exports.object({
+    detection: external_exports.boolean(),
+    decoder: external_exports.boolean(),
+    audio: external_exports.boolean()
+  }),
+  reasons: external_exports.object({
+    detection: external_exports.string().optional(),
+    decoder: external_exports.string().optional(),
+    audio: external_exports.string().optional()
+  })
+});
+var CameraBrokerProfileSchema = external_exports.object({
+  profile: external_exports.string(),
+  status: external_exports.string(),
+  codec: external_exports.string(),
+  width: external_exports.number(),
+  height: external_exports.number(),
+  subscribers: external_exports.number(),
+  inFps: external_exports.number(),
+  outFps: external_exports.number()
+});
+var CameraBrokerStatusSchema = external_exports.object({
+  profiles: external_exports.array(CameraBrokerProfileSchema).readonly(),
+  webrtcSessions: external_exports.number(),
+  rtspRestream: external_exports.boolean()
+});
+var CameraDecoderShmSchema = external_exports.object({
+  framesWritten: external_exports.number(),
+  getFrameHits: external_exports.number(),
+  getFrameMisses: external_exports.number(),
+  budgetMb: external_exports.number()
+});
+var CameraDecoderStatusSchema = external_exports.object({
+  nodeId: external_exports.string(),
+  formats: external_exports.array(external_exports.string()).readonly(),
+  sessionCount: external_exports.number(),
+  shm: CameraDecoderShmSchema
+});
+var CameraMotionStatusSchema = external_exports.object({
+  enabled: external_exports.boolean(),
+  fps: external_exports.number()
+});
+var CameraDetectionProvisioningStateSchema = external_exports.enum([
+  "idle",
+  "installing",
+  "verifying",
+  "ready",
+  "failed"
+]);
+var CameraDetectionProvisioningSchema = external_exports.object({
+  state: CameraDetectionProvisioningStateSchema,
+  error: external_exports.string().optional()
+});
+var CameraDetectionPhaseSchema = external_exports.enum([
+  "idle",
+  "watching",
+  "active"
+]);
+var CameraDetectionStatusSchema = external_exports.object({
+  nodeId: external_exports.string(),
+  engine: external_exports.object({
+    backend: external_exports.string(),
+    device: external_exports.string()
+  }),
+  phase: CameraDetectionPhaseSchema,
+  configuredFps: external_exports.number(),
+  actualFps: external_exports.number(),
+  queueDepth: external_exports.number(),
+  avgInferenceMs: external_exports.number(),
+  provisioning: CameraDetectionProvisioningSchema
+});
+var CameraAudioStatusSchema = external_exports.object({
+  nodeId: external_exports.string(),
+  enabled: external_exports.boolean()
+});
+var CameraRecordingModeSchema = external_exports.enum([
+  "off",
+  "continuous",
+  "events"
+]);
+var CameraRecordingStatusSchema = external_exports.object({
+  mode: CameraRecordingModeSchema,
+  active: external_exports.boolean(),
+  storageBytes: external_exports.number()
+});
+var CameraStatusSchema = external_exports.object({
+  deviceId: external_exports.number(),
+  assignment: CameraAssignmentStatusSchema,
+  source: CameraSourceStatusSchema,
+  broker: CameraBrokerStatusSchema.nullable(),
+  decoder: CameraDecoderStatusSchema.nullable(),
+  motion: CameraMotionStatusSchema.nullable(),
+  detection: CameraDetectionStatusSchema.nullable(),
+  audio: CameraAudioStatusSchema.nullable(),
+  recording: CameraRecordingStatusSchema.nullable(),
+  /** Unix timestamp (ms) when this snapshot was composed server-side. */
+  fetchedAt: external_exports.number()
+});
 var pipelineOrchestratorCapability = {
   name: "pipeline-orchestrator",
   scope: "system",
@@ -22707,6 +22848,25 @@ var pipelineOrchestratorCapability = {
       kind: "mutation",
       auth: "admin"
     }),
+    /**
+    * Set the per-node camera cap for one agent.
+    *
+    * `maxCameras: 0` and `maxCameras: null` are both treated as unlimited
+    * by the load balancer (0 is stored as-is; the balancer treats ≤0 as
+    * unlimited alongside null). Pass `null` to clear an existing cap.
+    * Note: the admin UI normalises 0→null before calling this method, so
+    * `maxCameras: 0` only reaches the store via direct SDK or CLI calls.
+    * Changes take effect immediately on the next dispatch cycle — cameras
+    * currently assigned over-cap are left in place (no forced eviction),
+    * but new assignments obey the updated cap.
+    */
+    setAgentMaxCameras: method(external_exports.object({
+      agentNodeId: external_exports.string(),
+      maxCameras: external_exports.number().int().nonnegative().nullable()
+    }), external_exports.object({ success: external_exports.literal(true) }), {
+      kind: "mutation",
+      auth: "admin"
+    }),
     /** Read one camera's settings. Null when never touched (inherits agent defaults fully). */
     getCameraSettings: method(external_exports.object({ deviceId: external_exports.number() }), CameraPipelineSettingsSchema.nullable()),
     /** Set or clear the 3-state toggle for one (camera, addonId). Pass `enabled: null` to clear and revert to agent default. */
@@ -22747,6 +22907,29 @@ var pipelineOrchestratorCapability = {
       deviceId: external_exports.number(),
       agentNodeId: external_exports.string().optional()
     }), CameraPipelineConfigSchema),
+    /**
+    * Server-composed aggregated status for a single camera.
+    *
+    * Fans out in parallel (bounded, per-stage graceful degradation) to
+    * broker / decoder / motion / detection / audio / recording source caps
+    * via `ctx.api`. A stage whose source errors or times out becomes `null`
+    * in the returned payload — one slow agent never breaks the whole call.
+    *
+    * Intended for "on open / on camera select" snapshots. Live deltas
+    * keep arriving from the existing ~1Hz events the UI already subscribes to.
+    */
+    getCameraStatus: method(external_exports.object({ deviceId: external_exports.number() }), CameraStatusSchema),
+    /**
+    * Server-composed aggregated status for multiple cameras in one call.
+    *
+    * `deviceIds` defaults to all cameras currently tracked by the
+    * orchestrator's assignment map when omitted.
+    *
+    * Runs per-device composition in parallel (bounded). Use this to
+    * populate the cluster assignments table and the pipeline flow overview
+    * 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()),
     /** 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. */
@@ -26571,6 +26754,69 @@ var integrationsCapability = {
     })
   }
 };
+var jobKindSchema = external_exports.enum([
+  "install",
+  "update",
+  "uninstall",
+  "restart"
+]);
+var taskPhaseSchema = external_exports.enum([
+  "queued",
+  "fetching",
+  "staged",
+  "validating",
+  "applying",
+  "restarting",
+  "applied",
+  "done",
+  "failed",
+  "skipped"
+]);
+var taskTargetSchema = external_exports.enum(["framework", "addon"]);
+var taskLogEntrySchema = external_exports.object({
+  tsMs: external_exports.number(),
+  nodeId: external_exports.string(),
+  packageName: external_exports.string(),
+  phase: taskPhaseSchema,
+  message: external_exports.string()
+});
+var lifecycleTaskSchema = external_exports.object({
+  taskId: external_exports.string(),
+  nodeId: external_exports.string(),
+  packageName: external_exports.string(),
+  fromVersion: external_exports.string().nullable(),
+  toVersion: external_exports.string(),
+  target: taskTargetSchema,
+  phase: taskPhaseSchema,
+  stagedPath: external_exports.string().nullable(),
+  attempts: external_exports.number(),
+  steps: external_exports.array(taskLogEntrySchema),
+  error: external_exports.string().nullable(),
+  startedAtMs: external_exports.number().nullable(),
+  finishedAtMs: external_exports.number().nullable()
+});
+var lifecycleJobStateSchema = external_exports.enum([
+  "running",
+  "completed",
+  "failed",
+  "partially-failed",
+  "cancelled"
+]);
+var lifecycleJobScopeSchema = external_exports.enum([
+  "single",
+  "bulk",
+  "cluster"
+]);
+var lifecycleJobSchema = external_exports.object({
+  jobId: external_exports.string(),
+  kind: jobKindSchema,
+  createdAtMs: external_exports.number(),
+  createdBy: external_exports.string(),
+  scope: lifecycleJobScopeSchema,
+  tasks: external_exports.array(lifecycleTaskSchema),
+  state: lifecycleJobStateSchema,
+  schemaVersion: external_exports.literal(1)
+});
 var LogLevelSchema$1 = external_exports.enum([
   "debug",
   "info",
@@ -26720,7 +26966,7 @@ var BulkUpdatePhaseSchema = external_exports.enum([
   "restarting",
   "finalizing"
 ]);
-var BulkUpdateStateSchema = external_exports.object({
+external_exports.object({
   id: external_exports.string(),
   nodeId: external_exports.string(),
   startedAtMs: external_exports.number(),
@@ -26938,54 +27184,6 @@ var addonsCapability = {
       kind: "mutation",
       auth: "admin"
     }),
-    /**
-    * Kicks off a server-side bulk update operation and returns the bulk
-    * id immediately. The operation runs asynchronously; observe progress
-    * via the `AddonsBulkUpdateProgress` event or `getBulkUpdateState`.
-    * Items with `isSystem: true` use `deferRestart` — the hub restarts
-    * ONCE at the end of the system phase, after all system packages are
-    * installed.
-    *
-    * `items[].version` is REQUIRED — callers must pass the resolved
-    * version from `listUpdates`. There is no `'latest'` default here
-    * (unlike `updatePackage`) to guarantee deterministic bulk rolls.
-    */
-    startBulkUpdate: method(external_exports.object({
-      nodeId: external_exports.string(),
-      items: external_exports.array(external_exports.object({
-        name: external_exports.string(),
-        version: external_exports.string(),
-        isSystem: external_exports.boolean()
-      })).readonly()
-    }), external_exports.object({ id: external_exports.string() }), {
-      kind: "mutation",
-      auth: "admin"
-    }),
-    /**
-    * Returns the current state of a bulk update by id.
-    * Returns `null` if the id is unknown or has been auto-cleaned
-    * (5 minutes after `completedAt` the record is evicted from memory).
-    */
-    getBulkUpdateState: method(external_exports.object({ id: external_exports.string() }), BulkUpdateStateSchema.nullable(), { auth: "admin" }),
-    /**
-    * Cancels an in-flight bulk update. The update loop exits after the
-    * currently-processing item completes — cancellation is not
-    * instantaneous. Has no effect once the `restarting` phase has been
-    * entered (the hub is already shutting down at that point).
-    * Returns `{ cancelled: false }` if the id is unknown, the operation
-    * has already completed, or the `restarting` phase is active.
-    */
-    cancelBulkUpdate: method(external_exports.object({ id: external_exports.string() }), external_exports.object({ cancelled: external_exports.boolean() }), {
-      kind: "mutation",
-      auth: "admin"
-    }),
-    /**
-    * Lists all currently active (non-completed) bulk updates.
-    * If `nodeId` is provided, filters to only bulk updates targeting
-    * that node. Useful for restoring an in-progress banner on a fresh
-    * page load when the UI reconnects mid-operation.
-    */
-    listActiveBulkUpdates: method(external_exports.object({ nodeId: external_exports.string().optional() }), external_exports.array(BulkUpdateStateSchema).readonly(), { auth: "admin" }),
     getVersions: method(external_exports.object({ name: external_exports.string() }), external_exports.array(PackageVersionInfoSchema).readonly()),
     restartAddon: method(external_exports.object({ addonId: external_exports.string() }), RestartAddonResultSchema, {
       kind: "mutation",
@@ -27022,6 +27220,51 @@ var addonsCapability = {
       auth: "admin"
     }),
     custom: method(CustomActionInputSchema, external_exports.unknown(), { kind: "mutation" }),
+    /**
+    * Start a lifecycle job (install / update / uninstall / restart) for one
+    * or more addon packages. Returns the `jobId` immediately — the job runs
+    * asynchronously. Observe progress via `EventCategory.AddonsJobProgress` /
+    * `AddonsJobLog` events or poll `getJob`.
+    *
+    * For a single-addon update on the hub the provider also routes
+    * `updatePackage` through this path so the fast swap + atomic-restart
+    * path (`applyStagedAddonUpdate`) is always used.
+    */
+    startJob: method(external_exports.object({
+      kind: external_exports.enum([
+        "install",
+        "update",
+        "uninstall",
+        "restart"
+      ]),
+      targets: external_exports.array(external_exports.object({
+        name: external_exports.string().min(1),
+        version: external_exports.string().min(1)
+      })).min(1),
+      nodeIds: external_exports.array(external_exports.string()).optional()
+    }), external_exports.object({ jobId: external_exports.string() }), {
+      kind: "mutation",
+      auth: "admin"
+    }),
+    /**
+    * Retrieve a lifecycle job by id. Returns `null` when the id is unknown
+    * (e.g. evicted after the retention window).
+    */
+    getJob: method(external_exports.object({ jobId: external_exports.string() }), lifecycleJobSchema.nullable(), { auth: "admin" }),
+    /**
+    * List lifecycle jobs. When `activeOnly` is true, only jobs still in
+    * `running` state are returned.
+    */
+    listJobs: method(external_exports.object({ activeOnly: external_exports.boolean().optional() }), external_exports.array(lifecycleJobSchema), { auth: "admin" }),
+    /**
+    * Cancel a lifecycle job that is queued but not yet actively running.
+    * Returns `{ cancelled: false }` if the job is unknown, already in a
+    * terminal state, or actively executing (cannot abort mid-flight).
+    */
+    cancelJob: method(external_exports.object({ jobId: external_exports.string() }), external_exports.object({ cancelled: external_exports.boolean() }), {
+      kind: "mutation",
+      auth: "admin"
+    }),
     onAddonLogs: method(external_exports.object({
       addonId: external_exports.string(),
       level: LogLevelSchema$1.optional()
@@ -27078,7 +27321,7 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
-  "addons.cancelBulkUpdate": {
+  "addons.cancelJob": {
     capName: "addons",
     capScope: "system",
     addonId: null,
@@ -27108,7 +27351,7 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
-  "addons.getBulkUpdateState": {
+  "addons.getJob": {
     capName: "addons",
     capScope: "system",
     addonId: null,
@@ -27156,19 +27399,19 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
-  "addons.listActiveBulkUpdates": {
+  "addons.listCapabilityProviders": {
     capName: "addons",
     capScope: "system",
     addonId: null,
     access: "view"
   },
-  "addons.listCapabilityProviders": {
+  "addons.listFrameworkPackages": {
     capName: "addons",
     capScope: "system",
     addonId: null,
     access: "view"
   },
-  "addons.listFrameworkPackages": {
+  "addons.listJobs": {
     capName: "addons",
     capScope: "system",
     addonId: null,
@@ -27252,7 +27495,7 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
-  "addons.startBulkUpdate": {
+  "addons.startJob": {
     capName: "addons",
     capScope: "system",
     addonId: null,
@@ -29478,6 +29721,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "pipelineExecutor.getEngineProvisioning": {
+    capName: "pipeline-executor",
+    capScope: "system",
+    addonId: null,
+    access: "view"
+  },
   "pipelineExecutor.getGlobalPipelineConfig": {
     capName: "pipeline-executor",
     capScope: "system",
@@ -29682,6 +29931,18 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "pipelineOrchestrator.getCameraStatus": {
+    capName: "pipeline-orchestrator",
+    capScope: "system",
+    addonId: null,
+    access: "view"
+  },
+  "pipelineOrchestrator.getCameraStatuses": {
+    capName: "pipeline-orchestrator",
+    capScope: "system",
+    addonId: null,
+    access: "view"
+  },
   "pipelineOrchestrator.getCameraStepOverrides": {
     capName: "pipeline-orchestrator",
     capScope: "system",
@@ -29766,6 +30027,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
+  "pipelineOrchestrator.setAgentMaxCameras": {
+    capName: "pipeline-orchestrator",
+    capScope: "system",
+    addonId: null,
+    access: "create"
+  },
   "pipelineOrchestrator.setCameraPipelineForAgent": {
     capName: "pipeline-orchestrator",
     capScope: "system",
@@ -31239,6 +31506,32 @@ var CAP_PROVIDER_KIND_MAP = Object.freeze({
   "network-access": "ingress",
   "smtp-provider": "email"
 });
+var frameworkSwapPackageSchema = external_exports.object({
+  name: external_exports.string(),
+  stagedPath: external_exports.string(),
+  backupPath: external_exports.string(),
+  toVersion: external_exports.string(),
+  fromVersion: external_exports.string().nullable()
+});
+var pendingFrameworkSwapSchema = external_exports.object({
+  jobId: external_exports.string(),
+  taskId: external_exports.string(),
+  packages: external_exports.array(frameworkSwapPackageSchema),
+  requestedAtMs: external_exports.number(),
+  schemaVersion: external_exports.literal(1)
+});
+var frameworkSwapConfirmSchema = external_exports.object({
+  jobId: external_exports.string(),
+  taskId: external_exports.string(),
+  backups: external_exports.array(external_exports.object({
+    name: external_exports.string(),
+    backupPath: external_exports.string(),
+    livePath: external_exports.string()
+  })),
+  appliedAtMs: external_exports.number(),
+  bootAttempts: external_exports.number(),
+  schemaVersion: external_exports.literal(1)
+});
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, Math.max(0, ms)));
 }

package/dist/cli.js

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

package/dist/{discover-WN3J572U.js → discover-ETACVQW3.js}

@@ -3,7 +3,7 @@ import {
   discoverNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-ACMTCEYY.js";
+} from "./chunk-YPXFYDJW.js";
 import "./chunk-K3NQKI34.js";
 export {
   discoverNodes,

package/package.json

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