@trillboards/edge-sdk 0.2.14 → 0.2.15

package/deploy/windows/README.md

@@ -16,7 +16,14 @@ bin\trillboards-edge.cmd     launcher (PATH=bin first; node lib\...\cli.js)
 bin\trillboards-setup.vbs    no-console launcher for the customer setup app
 bin\trillboards-setup.ps1    native Windows Forms customer setup window
 bin\trillboards-pair.cmd     hidden setup engine used by the setup window
+bin\trillboards-hidden-run.vbs  runs a helper with NO console (never use cmd's
+                             `start`: it allocates a visible console before the
+                             child can hide itself)
 bin\register-task.ps1        registers the logon Scheduled Task
+bin\stop-existing.ps1        DISABLES the task, stops this install's processes,
+                             and proves bin\node.exe is unlocked before a swap
+bin\ensure-sensing.ps1       re-arms the task (register/enable/start) — closing
+                             the setup window must never stop sensing
 lib\edge-sdk\dist\cli.js     the connector CLI
 lib\node_modules\...         runtime subset (NO onnxruntime/sharp/sqlite; LiteRT-LM
                              provides the on-device VLM outside Node)

package/deploy/windows/build-windows.ps1

@@ -173,6 +173,10 @@ Copy-Item -Force "$Here\trillboards-pair.cmd" "$Payload\bin\trillboards-pair.cmd
 Copy-Item -Force "$Here\trillboards-setup.ps1" "$Payload\bin\trillboards-setup.ps1"
 Copy-Item -Force "$Here\trillboards-setup.vbs" "$Payload\bin\trillboards-setup.vbs"
 Copy-Item -Force "$Here\trillboards-edge-task.vbs" "$Payload\bin\trillboards-edge-task.vbs"
+# Hidden fire-and-forget host: the launcher's local-AI repair goes through this
+# instead of cmd's `start`, which would allocate a visible console.
+Copy-Item -Force "$Here\trillboards-hidden-run.vbs" "$Payload\bin\trillboards-hidden-run.vbs"
+Copy-Item -Force "$Here\ensure-sensing.ps1"   "$Payload\bin\ensure-sensing.ps1"
 Copy-Item -Force "$Here\run-connector.ps1"      "$Payload\bin\run-connector.ps1"
 Copy-Item -Force "$Here\register-task.ps1"    "$Payload\bin\register-task.ps1"
 Copy-Item -Force "$Here\stop-existing.ps1"    "$Payload\bin\stop-existing.ps1"

package/deploy/windows/ensure-sensing.ps1

@@ -0,0 +1,58 @@
+<#
+  ensure-sensing.ps1 -- make the background connector registered, ENABLED and
+  running. Idempotent, windowless, and safe to call at any moment.
+
+  This exists because of one field rule: a customer closing something they CAN
+  see must never be what stops sensing. The setup wizard is the only visible
+  Trillboards window, and closing it taskkill /T /F's the pairing helper tree --
+  which may be sitting between "config written" and "scheduled task started".
+  It is also the recovery for a disabled task: stop-existing.ps1 disables
+  TrillboardsEdge during an upgrade, and a DISABLED task suppresses the AtLogOn
+  trigger, so a reboot would not bring sensing back on its own.
+#>
+[CmdletBinding()]
+param(
+  [Parameter(Mandatory = $true)][string]$InstallDir
+)
+
+$ErrorActionPreference = "Stop"
+$TaskName = "TrillboardsEdge"
+
+# Before pairing there is nothing to run: starting the task without a config
+# just crash-loops it against the RestartCount budget.
+if (-not (Test-Path (Join-Path $InstallDir "trillboards.config.json"))) {
+  Write-Host "No paired configuration yet - nothing to resume."
+  exit 0
+}
+
+$task = Get-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue
+if (-not $task) {
+  $register = Join-Path $InstallDir "bin\register-task.ps1"
+  if (-not (Test-Path $register)) {
+    Write-Error "Cannot resume sensing: $register is missing."
+    exit 1
+  }
+  & $register -InstallDir $InstallDir | Out-Null
+  $task = Get-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue
+  if (-not $task) {
+    Write-Error "Cannot resume sensing: scheduled task '$TaskName' did not register."
+    exit 1
+  }
+}
+
+if ($task.State -eq 'Disabled') {
+  Enable-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue | Out-Null
+  $task = Get-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue
+}
+
+if ($task -and $task.State -ne 'Running') {
+  Start-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue
+}
+
+$final = Get-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue
+if (-not $final -or $final.State -eq 'Disabled') {
+  Write-Error "Scheduled task '$TaskName' is not runnable after resume."
+  exit 1
+}
+Write-Host "Background sensing is registered, enabled and scheduled (state: $($final.State))."
+exit 0

package/deploy/windows/install-update.ps1

@@ -43,6 +43,31 @@ function Register-Connector([string]$Root) {
   if ($LASTEXITCODE -ne 0) { throw "Scheduled-task registration failed." }
 }
 
+function Assert-ConnectorScheduled {
+  # stop-existing.ps1 DISABLES the task so restart-on-failure cannot relaunch
+  # node.exe mid-swap. A disabled task suppresses the AtLogOn trigger too, so
+  # leaving it disabled would mean sensing never comes back - not even after a
+  # reboot. Re-registration should have re-enabled it; verify rather than trust.
+  $task = Get-ScheduledTask -TaskName "TrillboardsEdge" -ErrorAction SilentlyContinue
+  if (-not $task) { throw "Scheduled task 'TrillboardsEdge' is missing after registration." }
+  if ($task.State -eq 'Disabled') {
+    Enable-ScheduledTask -TaskName "TrillboardsEdge" -ErrorAction SilentlyContinue | Out-Null
+    $task = Get-ScheduledTask -TaskName "TrillboardsEdge" -ErrorAction SilentlyContinue
+    if (-not $task -or $task.State -eq 'Disabled') {
+      throw "Scheduled task 'TrillboardsEdge' stayed disabled - sensing would not restart at logon."
+    }
+  }
+}
+
+function Restore-ConnectorSchedule {
+  # Failure path. Whatever went wrong, the customer must NOT be left with a
+  # permanently disabled connector: that is a silent, reboot-proof outage.
+  Enable-ScheduledTask -TaskName "TrillboardsEdge" -ErrorAction SilentlyContinue | Out-Null
+  if (Test-Path (Join-Path $InstallDir "trillboards.config.json")) {
+    Start-ScheduledTask -TaskName "TrillboardsEdge" -ErrorAction SilentlyContinue
+  }
+}
+
 try {
   Assert-ConnectorVersion $StagingDir
   & (Join-Path $StagingDir "bin\stop-existing.ps1") -InstallDir $InstallDir
@@ -66,6 +91,7 @@ try {
 
   Assert-ConnectorVersion $InstallDir
   Register-Connector $InstallDir
+  Assert-ConnectorScheduled
   if (Test-Path (Join-Path $InstallDir "trillboards.config.json")) {
     Start-ScheduledTask -TaskName "TrillboardsEdge" -ErrorAction Stop
   }
@@ -90,12 +116,12 @@ try {
     }
   }
   if ($movedPrevious.Count -gt 0) {
-    try {
-      Register-Connector $InstallDir
-      if (Test-Path (Join-Path $InstallDir "trillboards.config.json")) {
-        Start-ScheduledTask -TaskName "TrillboardsEdge" -ErrorAction SilentlyContinue
-      }
-    } catch {}
+    try { Register-Connector $InstallDir } catch {}
   }
+  # UNCONDITIONAL. When the failure happened before anything moved there is no
+  # re-registration to re-enable the task, and stop-existing.ps1 already
+  # disabled it - so this is the only thing standing between a failed upgrade
+  # and a connector that never runs again.
+  try { Restore-ConnectorSchedule } catch {}
   throw "Trillboards Edge update failed and the previous version was restored: $($failure.Exception.Message)"
 }

package/deploy/windows/stop-existing.ps1

@@ -12,16 +12,32 @@ $ErrorActionPreference = "Stop"
 $root = [IO.Path]::GetFullPath($InstallDir).TrimEnd('\')
 $rootPrefix = $root + '\'
 
+# DISABLE BEFORE STOP. register-task.ps1 registers the task with
+# `-RestartCount 99 -RestartInterval 1 minute`, so Stop-ScheduledTask ends the
+# instance as a FAILURE and Task Scheduler relaunches node.exe about a minute
+# later — right inside the installer's bin\ + lib\ move. That is the "reinstall
+# hit a locked node.exe" the field test saw. Disabling suppresses the restart
+# AND the AtLogOn trigger for the whole swap window; install-update.ps1 owns
+# re-enabling it on every exit path, and the uninstaller deletes the task.
+Disable-ScheduledTask -TaskName "TrillboardsEdge" -ErrorAction SilentlyContinue | Out-Null
 Stop-ScheduledTask -TaskName "TrillboardsEdge" -ErrorAction SilentlyContinue
 Start-Sleep -Milliseconds 750
 
 function Get-TrillboardsEdgeProcesses {
+  # The process that actually holds bin\node.exe open is node.exe itself, and
+  # its command line names NONE of these scripts — it names the cli.js entry.
+  # Win32_Process.ExecutablePath is empty across a 32/64-bit boundary, and then
+  # the marker list is the only matcher left, so it has to cover the runtime.
   $markers = @(
     'trillboards-edge-task.vbs',
+    'trillboards-hidden-run.vbs',
     'run-connector.ps1',
     'trillboards-edge.cmd',
     'trillboards-setup.ps1',
-    'trillboards-pair.cmd'
+    'trillboards-pair.cmd',
+    'setup-litertlm.ps1',
+    'cli.js',
+    'ffmpeg.exe'
   )
 
   @(Get-CimInstance Win32_Process -ErrorAction SilentlyContinue | Where-Object {
@@ -69,4 +85,38 @@ if ($remaining.Count -gt 0) {
   throw "Could not stop the existing Trillboards connector processes: $ids"
 }
 
+function Assert-BinariesUnlocked {
+  # "No matching process" is NOT "the file is writable". A handle held by an
+  # AV scanner, an Explorer preview, or a process we could not attribute keeps
+  # bin\node.exe locked, and install-update.ps1 would then fail HALFWAY through
+  # moving bin\ and lib\. Prove writability before the installer commits.
+  param([string]$Root, [int]$TimeoutSeconds = 15)
+
+  $targets = @(
+    (Join-Path $Root 'bin\node.exe'),
+    (Join-Path $Root 'bin\ffmpeg.exe')
+  ) | Where-Object { Test-Path -LiteralPath $_ }
+  if ($targets.Count -eq 0) { return }
+
+  $deadline = [DateTime]::UtcNow.AddSeconds($TimeoutSeconds)
+  foreach ($target in $targets) {
+    while ($true) {
+      $stream = $null
+      try {
+        $stream = [IO.File]::Open($target, [IO.FileMode]::Open, [IO.FileAccess]::ReadWrite, [IO.FileShare]::None)
+        break
+      } catch {
+        if ([DateTime]::UtcNow -ge $deadline) {
+          throw "A Trillboards connector binary is still locked by another process: $target"
+        }
+        Start-Sleep -Milliseconds 300
+      } finally {
+        if ($null -ne $stream) { $stream.Dispose() }
+      }
+    }
+  }
+}
+
+Assert-BinariesUnlocked -Root $root
+
 Write-Host "Stopped existing Trillboards Edge processes."

package/deploy/windows/trillboards-edge.cmd

@@ -19,12 +19,18 @@ if /I "%~1"=="auto-sense" (
   if errorlevel 1 set "NEEDS_LOCAL_AI=1"
   curl.exe --fail --silent --max-time 2 http://127.0.0.1:9379/v1/models >nul 2>&1
   if errorlevel 1 set "NEEDS_LOCAL_AI=1"
+  REM Launch the repair through the wscript host, NOT `start`. cmd's `start`
+  REM allocates a NEW console for the child before PowerShell can hide itself,
+  REM so the customer saw a black window on exactly the reboot that needs a
+  REM repair. wscript.exe is GUI-subsystem and Run(...,0,False) creates the
+  REM process hidden from its first instruction.
   if "!NEEDS_LOCAL_AI!"=="1" if exist "%BIN%setup-litertlm.ps1" (
     set "SETUP_PROGRESS=%LOCALAPPDATA%\Trillboards\setup-progress.json"
+    set "HIDDEN_RUN=%WINDIR%\System32\wscript.exe"
     if exist "!SETUP_PROGRESS!" (
-      start "" powershell.exe -NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File "%BIN%setup-litertlm.ps1" -RequireBundledModel -ProgressPath "!SETUP_PROGRESS!"
+      "!HIDDEN_RUN!" "%BIN%trillboards-hidden-run.vbs" "powershell.exe" "-NoProfile" "-ExecutionPolicy" "Bypass" "-WindowStyle" "Hidden" "-File" "%BIN%setup-litertlm.ps1" "-RequireBundledModel" "-ProgressPath" "!SETUP_PROGRESS!"
     ) else (
-      start "" powershell.exe -NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File "%BIN%setup-litertlm.ps1" -RequireBundledModel
+      "!HIDDEN_RUN!" "%BIN%trillboards-hidden-run.vbs" "powershell.exe" "-NoProfile" "-ExecutionPolicy" "Bypass" "-WindowStyle" "Hidden" "-File" "%BIN%setup-litertlm.ps1" "-RequireBundledModel"
     )
   )
 )

package/deploy/windows/trillboards-hidden-run.vbs

@@ -0,0 +1,47 @@
+Option Explicit
+
+' trillboards-hidden-run.vbs — run a command with NO console window, ever.
+'
+' cmd's `start "" prog.exe` allocates a NEW console (conhost) for the child
+' BEFORE the child can hide itself, so `powershell.exe -WindowStyle Hidden`
+' still flashes — and on a slow logon it is a black window the customer sees
+' and closes. wscript.exe is a GUI-subsystem host: WScript.Shell.Run with
+' window style 0 (SW_HIDE) creates the process with a hidden console from the
+' very first instruction. This is the same mechanism trillboards-edge-task.vbs
+' uses for the connector supervisor; this host is the fire-and-forget variant
+' for helpers launched from a .cmd.
+'
+' Usage:
+'   wscript.exe "trillboards-hidden-run.vbs" <exe> [arg]...
+' Every argument after <exe> is forwarded verbatim; arguments containing
+' whitespace are re-quoted so paths like %LOCALAPPDATA%\Trillboards survive.
+
+Dim shell, index, command, argument
+
+If WScript.Arguments.Count < 1 Then
+  ' Nothing to run. Exit quietly — a hidden helper must never pop a dialog.
+  WScript.Quit 2
+End If
+
+Set shell = CreateObject("WScript.Shell")
+
+command = ""
+For index = 0 To WScript.Arguments.Count - 1
+  argument = WScript.Arguments(index)
+  ' Re-quote anything that is empty or contains whitespace. Arguments that are
+  ' already quoted are left alone so callers can pass pre-quoted values.
+  If Len(argument) = 0 Then
+    argument = Chr(34) & Chr(34)
+  ElseIf InStr(argument, " ") > 0 Or InStr(argument, vbTab) > 0 Then
+    If Not (Left(argument, 1) = Chr(34) And Right(argument, 1) = Chr(34)) Then
+      argument = Chr(34) & argument & Chr(34)
+    End If
+  End If
+  If Len(command) > 0 Then command = command & " "
+  command = command & argument
+Next
+
+' Style 0 == SW_HIDE. False == do not wait: a local-AI repair must never hold
+' up the connector's own startup.
+shell.Run command, 0, False
+WScript.Quit 0

package/deploy/windows/trillboards-setup.ps1

@@ -287,6 +287,30 @@ function Stop-SetupProcess {
   }
 }
 
+function Resume-BackgroundSensing {
+  # The wizard is the ONE window a customer can see, and closing it
+  # taskkill /T /F's the whole pairing tree. If that happens between "config
+  # written" and "scheduled task started" — or during an upgrade, while
+  # stop-existing.ps1 has the task disabled — sensing would stay down with
+  # nothing to retry it. Closing a window must never be what stops sensing.
+  $installDir = Split-Path -Parent $BinDir
+  $ensure = Join-Path $BinDir 'ensure-sensing.ps1'
+  if (-not (Test-Path $ensure)) { return }
+  if (-not (Test-Path (Join-Path $installDir 'trillboards.config.json'))) { return }
+
+  $startInfo = New-Object System.Diagnostics.ProcessStartInfo
+  $startInfo.FileName = 'powershell.exe'
+  $startInfo.Arguments = ('-NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File "{0}" -InstallDir "{1}"' -f $ensure, $installDir)
+  $startInfo.UseShellExecute = $false
+  $startInfo.CreateNoWindow = $true
+  $startInfo.WindowStyle = [System.Diagnostics.ProcessWindowStyle]::Hidden
+  try {
+    [void][System.Diagnostics.Process]::Start($startInfo)
+  } catch {
+    # Best-effort: the logon trigger is still the primary recovery path.
+  }
+}
+
 function Render-State($State) {
   $stage = [string](Get-StateValue $State 'stage')
   if (-not $stage) { return }
@@ -380,6 +404,7 @@ $Action.Add_Click({
 
 $Form.Add_FormClosing({
   Stop-SetupProcess
+  Resume-BackgroundSensing
   if ($null -ne $script:SetupMutex) {
     try { $script:SetupMutex.ReleaseMutex() } catch { }
     $script:SetupMutex.Dispose()

package/dist/AudienceAnalyzeClient.d.ts

@@ -64,8 +64,22 @@ export interface CameraHealthReport {
     lastFailureMessage?: string;
     /** AI/inference state, deliberately separate from RTSP/video health. */
     sensingState?: CameraSensingState;
-    /** Authenticated attestation that the connector decoded a local frame. */
-    captureProof?: 'decoded_frame';
+    /**
+     * What the connector actually PROVED, locally, without uploading the image.
+     * Two different facts, never interchangeable:
+     *
+     *   `stream_open`   — the RTSP handshake completed: the RECORDER IS REACHABLE.
+     *                     Says nothing about video. Carries NO `lastFrameAtMs`.
+     *   `decoded_frame` — ffmpeg decoded a real frame off this feed: VIDEO IS
+     *                     HEALTHY. Always accompanied by `lastFrameAtMs`.
+     *
+     * Collapsing these is how a camera that answers RTSP and delivers nothing
+     * rendered as "Live — connected and sending video": a bare handshake claimed
+     * `decoded_frame`, and every reconnect refreshed the frame clock, so the feed
+     * could never age into "waiting for video". Reachability is the WEAKER claim
+     * and must never be able to mint a frame timestamp.
+     */
+    captureProof?: 'decoded_frame' | 'stream_open';
 }
 /** Minimal injectable HTTP transport — lets tests stub the network entirely. */
 export interface HttpPoster {

package/dist/AudienceAnalyzeClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AudienceAnalyzeClient.d.ts","sourceRoot":"","sources":["../src/AudienceAnalyzeClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AudienceAnalyzeClient.d.ts","sourceRoot":"","sources":["../src/AudienceAnalyzeClient.ts"],"names":[],"mappings":"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"}

package/dist/AudienceAnalyzeClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"AudienceAnalyzeClient.js","sourceRoot":"","sources":["../src/AudienceAnalyzeClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AudienceAnalyzeClient.js","sourceRoot":"","sources":["../src/AudienceAnalyzeClient.ts"],"names":[],"mappings":"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"}

package/dist/CloudSensingManager.d.ts

@@ -5,6 +5,7 @@ import { SharedFrameSource } from './MosaicSource';
 import type { EdgeAgentConfig, MosaicTile, RecorderIdentity } from './config';
 import { type VlmAdmissionStats } from './VlmAdmissionGate';
 import { type MotionGateOptions, type MotionGateReason } from './SceneChangeDetector';
+import { type VlmCandidateBufferOptions, type VlmCandidateBufferStats } from './VlmCandidateBuffer';
 import type { DeployedCadence } from './deployedCadence';
 import type { LiteRtAccelerator, LiteRtAcceleratorHealth } from './LiteRtVlmProvider';
 export declare function classifyRtspFailureClass(err: unknown): CameraHealthFailureClass;
@@ -195,6 +196,37 @@ export interface CloudSensingManagerOptions {
          */
         minScanIntervalMs?: number;
     };
+    /**
+     * Bounded hold for frames the cascade already called interesting but the
+     * admission gate could not take yet.
+     *
+     * ON BY DEFAULT WHEREVER IT CAN BE, which is wherever `motionGate` is on —
+     * and that is not a hedge, it is the precondition. Without a cascade nothing
+     * has classified the frame, so holding it would be the undifferentiated queue
+     * `VlmAdmissionGate` exists to refuse; the feature is therefore structurally
+     * coupled to its own classifier rather than to a flag someone has to
+     * remember. That lands it exactly where the single-conversation backend
+     * lives (local sensing enables the cascade by default) and leaves the
+     * genuinely-concurrent cloud path untouched.
+     *
+     * It is on rather than off because the thing it fixes is not a tuning
+     * preference: a motion-positive frame dropped at the gate is the alert not
+     * firing, and a connector shipped with the fix switched off is a connector
+     * that still drops it. Memory cannot run away — the hold is capped in
+     * frames, per feed, and in bytes, all enforced on the way in (see
+     * VlmCandidateBuffer). `enabled: false` restores the pure drop semantics.
+     */
+    candidateBuffer?: VlmCandidateBufferOptions & {
+        /** Default: true whenever the motion cascade is on. */
+        enabled?: boolean;
+        /**
+         * How often the buffer is offered to a freed slot (ms). Default: the same
+         * derived value as `admissionRetryDelayMs` (250…5000), because it answers
+         * the same question — how quickly should a waiting frame notice a slot
+         * freed — and two knobs for one question drift apart.
+         */
+        pumpIntervalMs?: number;
+    };
     /**
      * Let the motion verdict drive the periodic/face-triggered cadence switch —
      * finally supplying the `setFaceDetected` signal this loop was always
@@ -253,6 +285,13 @@ export declare class CloudSensingManager extends EventEmitter {
     private readonly cameraHealthHeartbeatIntervalMs;
     private readonly admissionGate;
     private readonly admissionRetryDelayMs;
+    /**
+     * The bounded hold between the cascade and the gate. NULL when there is no
+     * cascade to name a candidate — see the `candidateBuffer` option.
+     */
+    private readonly candidates;
+    private readonly candidatePumpIntervalMs;
+    private candidatePumpTimer;
     private readonly motionDrivesCadence;
     /** Retained so a cadence change can rebuild each feed's gate heartbeat. */
     private motionGateOptions;
@@ -380,6 +419,31 @@ export declare class CloudSensingManager extends EventEmitter {
             skipped: number;
             byReason: Record<MotionGateReason, number>;
         };
+        /**
+         * The bounded hold between the cascade and the gate. `served` is the whole
+         * point — frames that were interesting, could not be analyzed at the
+         * instant they were taken, and reached the model anyway. `evicted` and
+         * `expired` are the price, and they are reported rather than absorbed: a
+         * silent eviction would move the lost frame from one invisible place to
+         * another, which is the defect this buffer exists to fix.
+         */
+        candidateBuffer: {
+            enabled: boolean;
+            /** Held right now. */
+            buffered: number;
+            bytes: number;
+            maxFrames: number;
+            maxPerFeed: number;
+            maxBytes: number;
+            ttlMs: number;
+            enqueued: number;
+            served: number;
+            evicted: number;
+            expired: number;
+            /** How long the oldest waiting candidate has been waiting. */
+            oldestAgeMs: number | null;
+            perFeed: VlmCandidateBufferStats['perFeed'];
+        };
         /**
          * Frames sent to the cloud VLM for confirmation (local sensing with
          * escalation enabled). 0 — and `cloudEscalationEnabled:false` — for a
@@ -408,6 +472,10 @@ export declare class CloudSensingManager extends EventEmitter {
             motionSkipped: number;
             /** This feed's skips, attributed to the cascade stage that made them. */
             motionSkippedByReason: Record<MotionGateReason, number>;
+            /** Candidates this feed is holding right now — "camera 12 is waiting". */
+            candidatesBuffered: number;
+            /** Candidates of this feed's that the hold delivered to the model. */
+            candidatesServed: number;
             cloudEscalated: number;
             faceDetected: boolean;
             currentIntervalMs: number;
@@ -524,6 +592,22 @@ export declare class CloudSensingManager extends EventEmitter {
     private emitLoopError;
     private reportCameraFailure;
     private reportCameraHealth;
+    /**
+     * Report this feed as `open`, carrying the proof we ACTUALLY have.
+     *
+     * `frameProven` and `streamOpened` are two different facts and the caller must
+     * not conflate them:
+     *
+     *   `streamOpened` — `camera.open()` resolved. The RTSP handshake completed,
+     *                    so the RECORDER IS REACHABLE. No frame has decoded, so
+     *                    this deliberately carries NO `lastFrameAtMs` and does NOT
+     *                    advance `lastCaptureAtMs` — a feed that has proved only
+     *                    reachability is still owed a video probe, immediately.
+     *   `frameProven`  — ffmpeg handed us real bytes. VIDEO IS HEALTHY.
+     *
+     * Both force a report, because both are transitions an operator is waiting on
+     * ("Connecting…" must clear the moment the recorder answers).
+     */
     private reportCameraOpen;
     private healthProbeDue;
     /**
@@ -532,14 +616,74 @@ export declare class CloudSensingManager extends EventEmitter {
      */
     private captureHealthFrame;
     /**
-     * One cascade pass for a feed: admission → capture → motion → inference,
-     * with a bounded decode-only health probe when admission is denied.
+     * One cascade pass for a feed. Which pass depends on whether there is a
+     * cascade to name a candidate — see the class header for why the order
+     * differs and why that is not two behaviours bolted together.
      *
-     * The admission check comes first so denied inference frames are dropped,
-     * never buffered. Video health is independent: at most one feed at a time
-     * may take a slow-cadence decode-only proof while the model is occupied.
+     * Deliberately NOT `async`: it hands the chosen pass's promise straight back
+     * instead of adopting it. An `async` dispatcher would insert two microtask
+     * hops in front of every capture on a path this PR does not otherwise
+     * change, and a fake-timer test that advances a fixed number of drains would
+     * then complete fewer ticks per advance — which is not a behaviour change but
+     * is indistinguishable from one at 2 a.m. Zero delta on the untouched path is
+     * cheaper to hold than the argument about whether the delta mattered.
      */
     private captureAndPost;
+    /**
+     * LOOK FIRST, admit second: capture → motion → (candidate) → admission.
+     *
+     * Runs only with the cascade on, because only the cascade can answer "is
+     * this frame worth holding?". A candidate the gate cannot take right now
+     * goes into the bounded hold instead of onto the floor; anything the cascade
+     * rejected is dropped exactly as before and is never offered.
+     */
+    private lookThenAdmit;
+    /**
+     * ADMIT FIRST, look second — the original order, unchanged, and the only one
+     * available without a cascade: nothing has classified the frame, so paying
+     * for a grab the model cannot take buys nothing, and a denied tick drops
+     * without touching the camera. Video health stays independent: at most one
+     * feed at a time may take a slow-cadence decode-only proof while the model
+     * is occupied.
+     */
+    private admitThenLook;
+    /**
+     * Everything that happens once a frame has been analyzed, in ONE place, so a
+     * held frame and a fresh one can never be counted — or reported to the portal
+     * — differently.
+     *
+     * Synchronous on purpose. The obvious factoring wraps the `analyze()` call
+     * itself, but that turns every caller's inline await into an await of an
+     * async helper, which adds microtask hops to the pre-existing capture path
+     * for no behavioural gain. What the two callers genuinely share is the
+     * bookkeeping AFTER the call, and that is what lives here; the four-line
+     * try/catch around the call stays at each site, where its `unavailable`
+     * report is visible next to the thing that can fail.
+     */
+    private recordAnalysis;
+    /**
+     * Arm the candidate pump for ONE run of the manager.
+     *
+     * A manager-scoped chain rather than a per-feed one, and that is the point:
+     * service order across feeds has to be a DECISION (least-recently-served,
+     * see VlmCandidateBuffer), not a race between 32 independent timers all
+     * polling for the same freed slot. `generation` carries the same meaning it
+     * carries in `scheduleNext` — a pump that survives a stop()/start() cycle
+     * must not arm a second chain.
+     */
+    private scheduleCandidatePump;
+    /**
+     * Offer the hold to every slot that is free right now.
+     *
+     * Synchronous by construction: each admitted candidate is launched as its own
+     * task and the pump does not await it, so one slow inference cannot delay the
+     * next pump tick or another feed's turn. Concurrency stays bounded by the
+     * admission gate, which is the only thing that ever knew the backend's real
+     * capacity.
+     */
+    private pumpCandidates;
+    /** Analyze one held candidate and give the slot back. Never throws. */
+    private serveCandidate;
     /**
      * Convert a camera frame to JPEG bytes for the POST.
      *