@trillboards/edge-sdk 0.2.74 → 0.2.76

package/dist/LocalDetectorClient.js

@@ -0,0 +1,241 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultDetectorPoster = exports.LocalDetectorClient = exports.DetectorUnavailableError = exports.DEFAULT_DETECTOR_PORT = void 0;
+/**
+ * LocalDetectorClient — the Node side of the on-device object detector.
+ *
+ * ── WHY A SECOND LOOPBACK SERVICE, AND NOT A NODE MODULE ───────────────────
+ *
+ * The detector is RF-DETR Medium as fp32 ONNX. Three constraints decide where it
+ * runs, and none of them is negotiable:
+ *
+ *  1. `onnxruntime-node` is EXCLUDED BY NAME from both installers
+ *     (`build-windows.ps1` `$xd`, `build-macos-pkg.sh`'s rsync `--exclude`) to
+ *     keep the package ~50 MB instead of ~270 MB. Putting the runtime in the Node
+ *     payload reverses a deliberate packaging decision.
+ *  2. The connector ALREADY installs and manages a uv/CPython environment, and
+ *     `uv tool install` gives ONE ISOLATED VENV PER TOOL NAME
+ *     (`<uv tool dir>/<name>/`). A second tool is namespace-isolated by
+ *     construction. Adding a package INTO litert-lm's venv is not: three
+ *     `setup-litertlm` scripts document, in triplicate, that
+ *     `uv tool install --force` rebuilds that venv from scratch on any version
+ *     drift or health failure, which is why the existing shim must be re-copied
+ *     unconditionally on every run.
+ *  3. A second always-on loopback service is already a solved problem here — a
+ *     launchd LaunchAgent, a systemd unit and a Windows Scheduled Task each
+ *     supervise `litert-lm serve` today, with auto-restart, and Node never spawns
+ *     it. This client is deliberately the same shape as `LiteRtVlmProvider`: an
+ *     HTTP client over 127.0.0.1 with an injectable transport, no child process.
+ *
+ * So: its own `uv tool`, its own OS-supervised service, HTTP over loopback.
+ *
+ * ── WHY THE MODEL IS OTA'd AND NOT BUNDLED ─────────────────────────────────
+ *
+ * The macOS code-only build is hard-capped at `MAX_SLIM_PKG_BYTES` = 250 MiB and
+ * the code slice is already ~207 MB. A 124 MB ONNX does not fit and the build
+ * would `die`. `edge-core`'s `ModelManager` is model-agnostic (its own header:
+ * "adapted for Node.js/ONNX") and already runs two models on one instance, so
+ * the artifact arrives the same way Gemma's does.
+ *
+ * ── WHAT THIS FILE DOES NOT DO ─────────────────────────────────────────────
+ *
+ * It does not start the service, register it with an OS supervisor, install the
+ * uv tool, or fetch the model. Those are packaging changes in `deploy/`, and are
+ * deliberately a separate change from the wire contract. Nothing calls this yet;
+ * it advertises nothing to a device or an operator, which is the distinction that
+ * matters — `yolov8_nano` was OFFERED to profile authors for six months while the
+ * device hardcoded it unloadable, and that is the failure this ordering avoids.
+ *
+ * @reuse-audit
+ *   considered: LiteRtVlmProvider (this package)
+ *     - reused: its whole shape — loopback HTTP, an injectable `HttpJsonPoster`
+ *       so tests need no server, health via a cheap GET, and a transport failure
+ *       kept distinct from a bad answer. Deliberately NOT subclassed: that class
+ *       carries chat-completions concerns (accelerator suffixes, enum repair,
+ *       schema-as-prose) that a detector has none of, and inheriting them would
+ *       drag the `,gpu` demotion machinery into a component with no delegates.
+ *   considered: edge-sensing/src/processors/FaceDetector.ts
+ *     - rejected as a base: it is in-process `onnxruntime-node`, which is exactly
+ *       the dependency the installers exclude. Its NMS and centroid tracker are
+ *       still the ones to reuse when tracking lands — they are model-agnostic and
+ *       already written; do not write a fourth tracker.
+ */
+const http_1 = require("http");
+/** Where the detector service listens. Distinct port from litert-lm's 9379. */
+exports.DEFAULT_DETECTOR_PORT = 9380;
+const BOX_KEYS = ['x', 'y', 'width', 'height'];
+/**
+ * A REAL number, never a coercion.
+ *
+ * `Number()` is the wrong tool on a wire value and this exact test caught it:
+ * `JSON.stringify(NaN)` is `null`, and `Number(null)` is `0` — perfectly finite.
+ * So a detection whose confidence failed to compute arrived as confidence 0, and
+ * a box that lost its `x` arrived pinned to the left edge of the frame. Both are
+ * plausible values that no downstream consumer could ever question. Typed
+ * refusal is the only thing that keeps a missing field distinguishable from a
+ * measured one.
+ */
+function isFiniteNumber(v) {
+    return typeof v === 'number' && Number.isFinite(v);
+}
+/** The service was unreachable or answered non-2xx. Distinct from "no objects". */
+class DetectorUnavailableError extends Error {
+}
+exports.DetectorUnavailableError = DetectorUnavailableError;
+class LocalDetectorClient {
+    constructor(options = {}, poster) {
+        const base = (options.baseUrl || `http://127.0.0.1:${exports.DEFAULT_DETECTOR_PORT}`).replace(/\/+$/, '');
+        this.detectEndpoint = `${base}/detect`;
+        this.healthEndpoint = `${base}/health`;
+        this.timeoutMs = options.timeoutMs ?? 5000;
+        this.classes = Array.isArray(options.classes) ? options.classes.filter(Boolean) : [];
+        this.minConfidence = options.minConfidence ?? 0.25;
+        this.poster = poster ?? exports.defaultDetectorPoster;
+    }
+    getDetectEndpoint() { return this.detectEndpoint; }
+    /**
+     * Is the service up? A CHEAP probe — it must not run inference.
+     *
+     * Returns false rather than throwing: a connector whose detector is down must
+     * fall through to the VLM, not stop sensing. The runtime edge-cases runbook is
+     * a catalogue of the opposite mistake, where a failure could not report itself;
+     * this returns a boolean the caller is forced to look at.
+     */
+    async isHealthy() {
+        try {
+            const res = await this.poster(this.healthEndpoint, { method: 'GET', headers: { Accept: 'application/json' }, timeoutMs: Math.min(this.timeoutMs, 2000) }, null);
+            return res.statusCode >= 200 && res.statusCode < 300;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Detect objects in one JPEG.
+     *
+     * Throws `DetectorUnavailableError` when the SERVICE failed. An empty
+     * `detections` array is a RESULT — the frame genuinely had nothing — and the
+     * two must never collapse into one another: a gate that reads "service down"
+     * as "nothing there" suppresses every alert while looking healthy.
+     */
+    async detect(jpeg) {
+        if (!jpeg || jpeg.length === 0)
+            throw new Error('detect() requires a non-empty jpeg buffer');
+        const body = JSON.stringify({
+            image_b64: jpeg.toString('base64'),
+            ...(this.classes.length > 0 ? { classes: this.classes } : {}),
+            min_confidence: this.minConfidence,
+        });
+        let res;
+        try {
+            res = await this.poster(this.detectEndpoint, { method: 'POST', headers: { 'Content-Type': 'application/json', Accept: 'application/json' }, timeoutMs: this.timeoutMs }, body);
+        }
+        catch (err) {
+            throw new DetectorUnavailableError(`detector transport failed: ${err?.message || String(err)}`);
+        }
+        if (res.statusCode < 200 || res.statusCode >= 300) {
+            throw new DetectorUnavailableError(`detector returned HTTP ${res.statusCode}`);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(res.body);
+        }
+        catch {
+            throw new DetectorUnavailableError('detector returned a body that is not JSON');
+        }
+        // A MISSING `detections` array is a broken envelope, not an empty frame.
+        // `{ "error": "model failed" }`, a renamed field, or a captive portal's
+        // JSON all arrive here as "no array", and defaulting that to `[]` is
+        // precisely the collapse this class exists to prevent: the cascade would
+        // read a broken detector as a quiet venue and suppress every VLM call while
+        // every health surface stayed green.
+        if (!Array.isArray(parsed?.detections)) {
+            throw new DetectorUnavailableError('detector answered 2xx without a `detections` array — envelope is not the contract');
+        }
+        const detections = [];
+        for (const d of parsed.detections) {
+            // One malformed entry REJECTS THE WHOLE PAYLOAD rather than being skipped.
+            // Skipping is the same defect one size down: a schema-drifted service
+            // yields an undercount that is indistinguishable from a genuinely emptier
+            // frame, and no consumer downstream can tell those apart. Refusing is the
+            // only version that produces a signal anybody sees.
+            //
+            // The label check earns its own note: a prior eval run defaulted an absent
+            // class to index 0 and scored BUSES as people for an entire run, and the
+            // resulting table was completely plausible.
+            if (!d || typeof d.label !== 'string' || !d.label) {
+                throw new DetectorUnavailableError('detector returned a detection with no label');
+            }
+            if (!isFiniteNumber(d.confidence) || d.confidence < 0 || d.confidence > 1) {
+                throw new DetectorUnavailableError(`detector returned confidence ${JSON.stringify(d.confidence)}, which is not a number in [0,1]`);
+            }
+            const b = d.box;
+            if (!b || !BOX_KEYS.every((k) => isFiniteNumber(b[k]))) {
+                throw new DetectorUnavailableError('detector returned a detection whose box is not four finite numbers');
+            }
+            if (b.width <= 0 || b.height <= 0) {
+                throw new DetectorUnavailableError(`detector returned a box with no extent (${b.width}x${b.height})`);
+            }
+            detections.push({
+                label: d.label,
+                confidence: d.confidence,
+                box: { x: b.x, y: b.y, width: b.width, height: b.height },
+            });
+        }
+        return {
+            detections,
+            inferenceMs: isFiniteNumber(parsed?.inference_ms) && parsed.inference_ms > 0
+                ? Math.round(parsed.inference_ms)
+                : null,
+            model: typeof parsed?.model === 'string' && parsed.model ? parsed.model : null,
+        };
+    }
+}
+exports.LocalDetectorClient = LocalDetectorClient;
+/** Node built-ins only — no new dependency, matching LiteRtVlmProvider. */
+const defaultDetectorPoster = (url, options, body) => new Promise((resolve, reject) => {
+    const u = new URL(url);
+    const req = (0, http_1.request)({
+        hostname: u.hostname,
+        port: u.port,
+        path: u.pathname,
+        method: options.method,
+        headers: options.headers,
+        timeout: options.timeoutMs,
+    }, (res) => {
+        const chunks = [];
+        res.on('data', (c) => chunks.push(c));
+        res.on('end', () => resolve({ statusCode: res.statusCode || 0, body: Buffer.concat(chunks).toString('utf8') }));
+        // NO `aborted`/`error` listeners on the response, deliberately. Review
+        // asked for them on the grounds that a response aborted after its
+        // headers never settles. Measured on Node 22, three ways:
+        //
+        //   socket destroyed after headers   `req:error` ECONNRESET @2ms
+        //   truncated under Content-Length   nothing until `req:timeout` @5004ms,
+        //                                    then `res:aborted` @5005ms — AFTER
+        //                                    the destroy, and caused by it
+        //   no res `error` listener at all   no uncaughtException; Node routes it
+        //                                    to the request's handler
+        //
+        // So `aborted` cannot fire early enough to help, and `error` prevents no
+        // throw. Listeners that can only run after the thing that already settled
+        // the promise would be noise in a file whose whole premise is that a
+        // failure must be legible. The tests pin the OUTCOME instead — fails fast
+        // on a destroyed socket, settles at the timeout on a truncation, never
+        // hangs — which survives a Node change that would invalidate either
+        // listener.
+        //
+        // The one case none of this covers: a server dribbling bytes slowly under
+        // a large Content-Length keeps the socket busy, so the inactivity timeout
+        // never fires and the call is genuinely unbounded. No response listener
+        // fixes that either — it needs an overall deadline, and it applies
+        // equally to every HTTP client in this package.
+    });
+    req.on('error', reject);
+    req.on('timeout', () => { req.destroy(new Error(`detector request timed out after ${options.timeoutMs}ms`)); });
+    if (body != null)
+        req.write(body);
+    req.end();
+});
+exports.defaultDetectorPoster = defaultDetectorPoster;
+//# sourceMappingURL=LocalDetectorClient.js.map

package/dist/LocalDetectorClient.js.map

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

package/dist/diagnose.d.ts

@@ -31,7 +31,7 @@ export interface DiagnosticReport {
         skipped: number;
     };
 }
-declare const SDK_VERSION = "0.2.74";
+declare const SDK_VERSION = "0.2.76";
 declare function checkNodeVersion(): CheckResult;
 declare function checkPlatform(): CheckResult;
 declare function checkMemory(): CheckResult;

package/dist/diagnose.js

@@ -63,7 +63,7 @@ const localNetworkAccess_1 = require("./localNetworkAccess");
 // ---------------------------------------------------------------------------
 // SDK version — mirrors package.json; kept in sync by CI
 // ---------------------------------------------------------------------------
-const SDK_VERSION = '0.2.74';
+const SDK_VERSION = '0.2.76';
 exports._SDK_VERSION = SDK_VERSION;
 // ---------------------------------------------------------------------------
 // ANSI helpers (no external deps)

package/dist/index.d.ts

@@ -37,5 +37,9 @@ export type { AudioSensingOptions, AudioOnsetAttachment, AudioOnsetTransport, }
 export { encodeWav16, takeMostRecentSeconds, GEMMA_AUDIO_SAMPLE_RATE, GEMMA_AUDIO_MAX_SECONDS, } from './wavEncode';
 export { SharedFrameSource, CropViewProvider } from './MosaicSource';
 export type { CropViewProviderOptions } from './MosaicSource';
+export { LocalDetectorClient, DetectorUnavailableError, defaultDetectorPoster, DEFAULT_DETECTOR_PORT, } from './LocalDetectorClient';
+export type { Detection, DetectResult, DetectorHttpPoster, LocalDetectorClientOptions, } from './LocalDetectorClient';
+export { evaluateZone, countInZone, normalizeBox, assertNormalizedRect, DEFAULT_ZONE_PREDICATE, } from './zoneContainment';
+export type { NormalizedRect, PixelBox, FrameSize, ZonePredicate, ZoneVerdict, } from './zoneContainment';
 export type { AudienceMetricsPayload, DetectedFace, EdgeQualityReport, VASResult, DeviceCapabilityMatrix, PlatformAdapter, CameraProvider, AudioProvider, EdgeSDKConfig, } from '@trillboards/edge-core';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -4,7 +4,7 @@
 // Run: npx trillboards-edge start --config trillboards.config.json
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.attachAudioOnset = exports.SILENCE_DBFS = exports.rmsDbfs = exports.AudioOnsetDetector = exports.motionSignature = exports.downscaleRgbaToGrey = exports.decodeGreyFrame = exports.isChangeCandidate = exports.SceneChangeDetector = exports.MotionGate = exports.DurableVlmCandidateSpool = exports.DEFAULT_CANDIDATE_TTL_MS = exports.VlmCandidateBuffer = exports.VlmAdmissionGate = exports.shouldAttemptRecorderAddressRecovery = exports.rewriteStreamHost = exports.normalizeMacAddress = exports.lookupMacAddress = exports.RecorderAddressRecovery = exports.resolveFeeds = exports.classifyRtspFailureClass = exports.buildTiledCameras = exports.buildSensingLoops = exports.CloudSensingManager = exports.defaultHttpPoster = exports.AudienceAnalyzeClient = exports.LOCAL_NETWORK_DENIED_SUMMARY = exports.LOCAL_NETWORK_DENIED_SUGGESTION = exports.decideLocalNetworkVerdict = exports.probeLocalNetworkAccess = exports.describeProxy = exports.resolveProxyForUrl = exports.describeTrustAnchors = exports.resolveTrustAnchors = exports.isTrustFailure = exports.formatTransportFailure = exports.classifyTransportError = exports.TransportFailure = exports.EnterpriseHttpsAgent = exports.resetEnterpriseNetworkCaches = exports.diagnoseTransportError = exports.getEnterpriseAgent = exports.describeNetworkPosture = exports.installEnterpriseNetworking = exports.runDiagnose = exports.runInit = exports.CommandRouter = exports.resolveConfig = exports.loadConfig = exports.EdgeAgent = void 0;
-exports.CropViewProvider = exports.SharedFrameSource = exports.GEMMA_AUDIO_MAX_SECONDS = exports.GEMMA_AUDIO_SAMPLE_RATE = exports.takeMostRecentSeconds = exports.encodeWav16 = void 0;
+exports.DEFAULT_ZONE_PREDICATE = exports.assertNormalizedRect = exports.normalizeBox = exports.countInZone = exports.evaluateZone = exports.DEFAULT_DETECTOR_PORT = exports.defaultDetectorPoster = exports.DetectorUnavailableError = exports.LocalDetectorClient = exports.CropViewProvider = exports.SharedFrameSource = exports.GEMMA_AUDIO_MAX_SECONDS = exports.GEMMA_AUDIO_SAMPLE_RATE = exports.takeMostRecentSeconds = exports.encodeWav16 = void 0;
 var EdgeAgent_1 = require("./EdgeAgent");
 Object.defineProperty(exports, "EdgeAgent", { enumerable: true, get: function () { return EdgeAgent_1.EdgeAgent; } });
 var config_1 = require("./config");
@@ -98,4 +98,20 @@ Object.defineProperty(exports, "GEMMA_AUDIO_MAX_SECONDS", { enumerable: true, ge
 var MosaicSource_1 = require("./MosaicSource");
 Object.defineProperty(exports, "SharedFrameSource", { enumerable: true, get: function () { return MosaicSource_1.SharedFrameSource; } });
 Object.defineProperty(exports, "CropViewProvider", { enumerable: true, get: function () { return MosaicSource_1.CropViewProvider; } });
+// On-device object detection. The client is the WIRE CONTRACT for a loopback
+// detector service; the geometry answers "is it in the area the operator drew".
+// Nothing calls either yet — the detector service is packaging work that ships
+// separately, and advertising a capability before its artifact exists is the
+// `yolov8_nano` failure this area already paid for once.
+var LocalDetectorClient_1 = require("./LocalDetectorClient");
+Object.defineProperty(exports, "LocalDetectorClient", { enumerable: true, get: function () { return LocalDetectorClient_1.LocalDetectorClient; } });
+Object.defineProperty(exports, "DetectorUnavailableError", { enumerable: true, get: function () { return LocalDetectorClient_1.DetectorUnavailableError; } });
+Object.defineProperty(exports, "defaultDetectorPoster", { enumerable: true, get: function () { return LocalDetectorClient_1.defaultDetectorPoster; } });
+Object.defineProperty(exports, "DEFAULT_DETECTOR_PORT", { enumerable: true, get: function () { return LocalDetectorClient_1.DEFAULT_DETECTOR_PORT; } });
+var zoneContainment_1 = require("./zoneContainment");
+Object.defineProperty(exports, "evaluateZone", { enumerable: true, get: function () { return zoneContainment_1.evaluateZone; } });
+Object.defineProperty(exports, "countInZone", { enumerable: true, get: function () { return zoneContainment_1.countInZone; } });
+Object.defineProperty(exports, "normalizeBox", { enumerable: true, get: function () { return zoneContainment_1.normalizeBox; } });
+Object.defineProperty(exports, "assertNormalizedRect", { enumerable: true, get: function () { return zoneContainment_1.assertNormalizedRect; } });
+Object.defineProperty(exports, "DEFAULT_ZONE_PREDICATE", { enumerable: true, get: function () { return zoneContainment_1.DEFAULT_ZONE_PREDICATE; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,gEAAgE;AAChE,6CAA6C;AAC7C,mEAAmE;;;;AAEnE,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAElB,mCAAqD;AAA5C,oGAAA,UAAU,OAAA;AAAE,uGAAA,aAAa,OAAA;AAClC,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,+BAAiC;AAAxB,+FAAA,OAAO,OAAA;AAChB,uCAAyC;AAAhC,uGAAA,WAAW,OAAA;AAGpB,8EAA8E;AAC9E,yEAAyE;AACzE,iFAAiF;AACjF,yDAO6B;AAN3B,gIAAA,2BAA2B,OAAA;AAC3B,2HAAA,sBAAsB,OAAA;AACtB,uHAAA,kBAAkB,OAAA;AAClB,2HAAA,sBAAsB,OAAA;AACtB,iIAAA,4BAA4B,OAAA;AAC5B,yHAAA,oBAAoB,OAAA;AAGtB,uDAK4B;AAJ1B,oHAAA,gBAAgB,OAAA;AAChB,0HAAA,sBAAsB,OAAA;AACtB,0HAAA,sBAAsB,OAAA;AACtB,kHAAA,cAAc,OAAA;AAGhB,qDAA8E;AAArE,sHAAA,mBAAmB,OAAA;AAAE,uHAAA,oBAAoB,OAAA;AAElD,qDAAsE;AAA7D,qHAAA,kBAAkB,OAAA;AAAE,gHAAA,aAAa,OAAA;AAE1C,4EAA4E;AAC5E,uDAAuD;AACvD,2DAK8B;AAJ5B,6HAAA,uBAAuB,OAAA;AACvB,+HAAA,yBAAyB,OAAA;AACzB,qIAAA,+BAA+B,OAAA;AAC/B,kIAAA,4BAA4B,OAAA;AAS9B,kFAAkF;AAClF,iEAAmF;AAA1E,8HAAA,qBAAqB,OAAA;AAAE,0HAAA,iBAAiB,OAAA;AAWjD,6DAM+B;AAL7B,0HAAA,mBAAmB,OAAA;AACnB,wHAAA,iBAAiB,OAAA;AACjB,wHAAA,iBAAiB,OAAA;AACjB,+HAAA,wBAAwB,OAAA;AACxB,mHAAA,YAAY,OAAA;AAEd,qEAMmC;AALjC,kIAAA,uBAAuB,OAAA;AACvB,2HAAA,gBAAgB,OAAA;AAChB,8HAAA,mBAAmB,OAAA;AACnB,4HAAA,iBAAiB,OAAA;AACjB,+IAAA,oCAAoC,OAAA;AAStC,+DAA+D;AAC/D,6EAA6E;AAC7E,uBAAuB;AACvB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAMzB,wEAAwE;AACxE,sEAAsE;AACtE,2DAAoF;AAA3E,wHAAA,kBAAkB,OAAA;AAAE,8HAAA,wBAAwB,OAAA;AACrD,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AAYjC,6DAO+B;AAN7B,iHAAA,UAAU,OAAA;AACV,0HAAA,mBAAmB,OAAA;AACnB,wHAAA,iBAAiB,OAAA;AACjB,sHAAA,eAAe,OAAA;AACf,0HAAA,mBAAmB,OAAA;AACnB,sHAAA,eAAe,OAAA;AAajB,0EAA0E;AAC1E,2EAA2E;AAC3E,kDAAkD;AAClD,2DAAiF;AAAxE,wHAAA,kBAAkB,OAAA;AAAE,6GAAA,OAAO,OAAA;AAAE,kHAAA,YAAY,OAAA;AAMlD,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAMzB,yCAKqB;AAJnB,wGAAA,WAAW,OAAA;AACX,kHAAA,qBAAqB,OAAA;AACrB,oHAAA,uBAAuB,OAAA;AACvB,oHAAA,uBAAuB,OAAA;AAEzB,+EAA+E;AAC/E,mEAAmE;AACnE,+CAAqE;AAA5D,iHAAA,iBAAiB,OAAA;AAAE,gHAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/zoneContainment.d.ts

@@ -0,0 +1,148 @@
+/**
+ * zoneContainment — "is this thing in the area the operator drew?", in code.
+ *
+ * ── WHY THIS EXISTS ────────────────────────────────────────────────────────
+ *
+ * The operator drags a rectangle on their camera and expects "only tell me about
+ * THIS". Today that promise is kept by writing the rectangle's coordinates into
+ * an English sentence and asking a vision-language model to respect it. Measured
+ * on production, before and after the description was repaired:
+ *
+ *   - the focused field agreed with the UNRESTRICTED field on 99.5% of frames
+ *   - after the fix the model demonstrably READS the constraint (divergence
+ *     0.34% -> 3.58%), and yet `focus_true` is still 0 of 391 in a window with
+ *     MORE person activity than the one before it
+ *
+ * So the repaired prose suppresses, and whether it suppresses the RIGHT things
+ * is not knowable from the model's answer alone. A rectangle is geometry. Asking
+ * a language model to do geometry, and then having no way to check its working,
+ * is the part that has to stop.
+ *
+ * ── THE ANCHOR IS THE WHOLE PROBLEM, AND IT IS NOT A THRESHOLD ─────────────
+ *
+ * A person is a tall box. Someone standing on the pavement BESIDE a driveway
+ * overlaps the driveway's rectangle in image space with their head and shoulders
+ * while their feet are firmly outside it. Area-overlap answers "yes" and is
+ * wrong; whole-box containment answers "no" for anyone standing at the edge and
+ * is also wrong. Neither is rescued by tuning a fraction, because the error is
+ * not one of degree — the box's top is not where the person IS.
+ *
+ * A camera looks down. The ground plane is where a person occupies space, and
+ * the bottom edge of their box is where they touch it. So `groundContact` — the
+ * bottom-centre point — is the default, and it needs NO threshold: a point is
+ * inside a rectangle or it is not. That is the whole reason to prefer it. A
+ * magic fraction nobody can justify is exactly what this codebase asks not to
+ * invent, and here the physics removes the need for one.
+ *
+ * `areaOverlap` is offered for the cases where the ground plane is not the
+ * subject — a package on a shelf, a vehicle in a wide overhead view — and there
+ * the fraction is a REQUIRED, caller-supplied argument, never a default, so it
+ * appears in the route's own configuration where an operator's expectation can
+ * be compared against it.
+ *
+ * ── COORDINATE SPACES: EXACTLY ONE CONVERSION, HERE ────────────────────────
+ *
+ * Detector boxes are PIXELS in the submitted frame. `sensing_route_screens`
+ * stores `focus_x/y/width/height` NORMALIZED to [0,1] — that is what the portal
+ * writes and what `focusRegionFromScreenRow` reads. The two meet in exactly one
+ * place: this file. Every function takes the frame's dimensions explicitly
+ * rather than carrying a resolution around, because a stale resolution is
+ * silent and a missing argument is not.
+ *
+ * @reuse-audit
+ *   considered: FaceDetector.iou (edge-sensing/src/processors/FaceDetector.ts)
+ *     - not reused: IoU is a SYMMETRIC similarity between two detections, used
+ *       for NMS and tracking. Containment is asymmetric — "how much of the BOX
+ *       is in the RECT" — and IoU's denominator includes the rectangle's own
+ *       area, so a small person inside a large zone scores near zero on IoU and
+ *       1.0 here. Same rectangles, different question. When the detector's own
+ *       NMS lands it must call FaceDetector's iou, not a copy.
+ *   considered: camera-alert-focus-selector.tsx (portal)
+ *     - not reused: drag/clamp only, no containment predicate, and it is React
+ *       in a different package. Its clamping is the reason `assertNormalizedRect`
+ *       can be strict — the rect always arrives already inside [0,1].
+ */
+/** A rectangle in normalized [0,1] frame coordinates, as the operator drew it. */
+export interface NormalizedRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** A box in PIXELS of the frame it was detected in. */
+export interface PixelBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface FrameSize {
+    width: number;
+    height: number;
+}
+/**
+ * How to decide whether a box is "in" the zone.
+ *
+ * `groundContact` — the box's bottom-centre point falls inside the rect. The
+ * default, and the only one with a physical argument behind it.
+ *
+ * `areaOverlap` — at least `minOverlap` of the box's own area falls inside the
+ * rect. `minOverlap` is REQUIRED; there is no defensible default and inventing
+ * one would bury the decision.
+ */
+export type ZonePredicate = {
+    kind: 'groundContact';
+} | {
+    kind: 'areaOverlap';
+    minOverlap: number;
+};
+export declare const DEFAULT_ZONE_PREDICATE: ZonePredicate;
+export interface ZoneVerdict {
+    inside: boolean;
+    /**
+     * Fraction of the box's area inside the rect, ALWAYS computed regardless of
+     * predicate.
+     *
+     * Reported even when unused because the alternative — logging only the boolean
+     * — makes a disputed verdict unreviewable after the fact. An operator saying
+     * "it missed someone standing right there" is answerable with 0.62 and
+     * unanswerable with `false`.
+     */
+    overlapFraction: number;
+    /** The bottom-centre point in normalized coordinates, for the same reason. */
+    groundContact: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * A rect outside [0,1] is a COORDINATE-SPACE error, and it must throw.
+ *
+ * The one way this happens is a caller passing pixels where normalized values
+ * belong — and pixels are numerically valid, so the verdict would just be
+ * silently wrong forever: a rect at x=640 clamps to the frame's right edge and
+ * every person reads as outside it. That failure has no symptom other than an
+ * alert that never fires, which is the failure this whole area keeps producing.
+ * Refusing loudly is the only version anybody notices.
+ */
+export declare function assertNormalizedRect(rect: NormalizedRect): void;
+/** Convert a pixel box to normalized coordinates. The only conversion there is. */
+export declare function normalizeBox(box: PixelBox, frame: FrameSize): NormalizedRect;
+/**
+ * Is this detection inside the operator's rectangle?
+ *
+ * Throws on a malformed rect or frame — see `assertNormalizedRect`. Never
+ * returns a verdict it could not compute.
+ */
+export declare function evaluateZone(box: PixelBox, frame: FrameSize, rect: NormalizedRect, predicate?: ZonePredicate): ZoneVerdict;
+/**
+ * Count the detections inside the zone.
+ *
+ * This is the integer the focused field has been asking a language model for.
+ * `null` rect means NO zone was drawn, and then the count is every detection —
+ * which is what the unfocused field already means, so absence degrades to the
+ * existing behaviour rather than to zero. A zone that silently counts nothing is
+ * indistinguishable from a quiet venue, and that is the whole failure mode here.
+ */
+export declare function countInZone(boxes: PixelBox[], frame: FrameSize, rect: NormalizedRect | null | undefined, predicate?: ZonePredicate): number;
+//# sourceMappingURL=zoneContainment.d.ts.map

package/dist/zoneContainment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoneContainment.d.ts","sourceRoot":"","sources":["../src/zoneContainment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AAEH,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uDAAuD;AACvD,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,eAAO,MAAM,sBAAsB,EAAE,aAAyC,CAAC;AAE/E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;;;;OAQG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,aAAa,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;AAQD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAgB/D;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,GAAG,cAAc,CAgB5E;AAiBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,cAAc,EACpB,SAAS,GAAE,aAAsC,GAChD,WAAW,CAmBb;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,EAAE,EACjB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,EACvC,SAAS,GAAE,aAAsC,GAChD,MAAM,CAGR"}