@trillboards/edge-sdk 0.2.140 → 0.2.150

package/dist/ProfileReviewWork.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reviewContextHash = void 0;
+exports.promoteProfileDependencies = promoteProfileDependencies;
+exports.planProfileReview = planProfileReview;
+exports.validateProfileWork = validateProfileWork;
+exports.reviewProfileBatch = reviewProfileBatch;
+const crypto_1 = require("crypto");
+const reviewContextHash = (context) => (0, crypto_1.createHash)('sha256').update(JSON.stringify(context ?? null)).digest('hex');
+exports.reviewContextHash = reviewContextHash;
+const hasOwn = (value, field) => Object.prototype.hasOwnProperty.call(value, field);
+// These values participate in localSensing's existing presence-contradiction
+// repair. Preserve that cross-field check even if one has a separate region.
+const PRESENCE_DEPENDENCIES = new Set(['people_present', 'confidence', 'person_count', 'face_count', 'people_count', 'human_count']);
+function promoteProfileDependencies(work) {
+    if (work.items.some(i => PRESENCE_DEPENDENCIES.has(i.field) && i.selected)) {
+        for (const item of work.items)
+            if (PRESENCE_DEPENDENCIES.has(item.field) && !item.selected) {
+                item.selected = true;
+                item.reason = 'presence_dependency';
+                delete item.referenceSha256;
+                delete item.referenceCapturedAtMs;
+                delete item.referenceEvidenceId;
+            }
+    }
+}
+function declarations(context) {
+    const schema = context.schema;
+    const properties = schema?.properties;
+    if (!properties || typeof properties !== 'object' || Array.isArray(properties))
+        throw Error('No profile schema');
+    if (Object.values(properties).some(p => !p || typeof p !== 'object' || Array.isArray(p)))
+        throw Error('Invalid field schema');
+    const producers = Array.isArray(context.producerFields) ? context.producerFields : [];
+    const owners = new Map();
+    for (const p of producers) {
+        if (!p || typeof p.field !== 'string' || typeof p.modelId !== 'string' || !p.modelId || owners.has(p.field)) {
+            throw Error('Ambiguous profile producer');
+        }
+        owners.set(p.field, p.modelId);
+    }
+    const fields = [...new Set([...Object.keys(properties), ...owners.keys(),
+            ...(Array.isArray(context.absenceWatchedFields) ? context.absenceWatchedFields : [])])].sort();
+    if (!fields.length || fields.length > 64 || fields.some(f => typeof f !== 'string' || !/^[a-zA-Z_][a-zA-Z0-9_]{0,127}$/.test(f) ||
+        ['__proto__', 'prototype', 'constructor'].includes(f)))
+        throw Error('Unsupported profile fields');
+    // Cross-field schema rules cannot be split into independent questions.
+    const simple = Object.keys(schema).every(k => ['type', 'properties', 'required', 'additionalProperties', 'title', 'description', '$schema'].includes(k)) &&
+        (schema.required === undefined || Array.isArray(schema.required) && schema.required.every((f) => fields.includes(f)));
+    return { schema, properties, producers, owners, fields, simple };
+}
+/** Each lasso affects its own field. A full-frame question does not select the other fields. */
+function planProfileReview(context, grouping) {
+    try {
+        if (!context)
+            return undefined;
+        const d = declarations(context), regions = new Set();
+        for (const r of Array.isArray(context.regions) ? context.regions : [])
+            if (Array.isArray(r) && typeof r[0] === 'string')
+                regions.add(r[0]);
+        const contextSha256 = (0, exports.reviewContextHash)(context);
+        const binding = grouping.version === 1 && grouping.mode === 'shadow' && grouping.contextSha256 === contextSha256;
+        const items = d.fields.map(field => {
+            const matches = grouping.scopes.filter(s => s.field === (regions.has(field) ? field : '*'));
+            const scope = matches.length === 1 ? matches[0] : undefined;
+            const selected = !binding || !d.simple || !scope || scope.select !== false;
+            const producer = d.owners.has(field) ? 'detector' : hasOwn(d.properties, field) ? 'vlm' : 'unresolved';
+            return { field, producer, selected: producer === 'unresolved' || selected,
+                reason: !binding ? 'context_mismatch' : !d.simple ? 'dependent_schema' : !scope ? 'missing_scope' : scope.reason,
+                ...(!selected && scope ? { referenceSha256: scope.referenceSha256, referenceCapturedAtMs: scope.referenceCapturedAtMs } : {}) };
+        });
+        const work = { version: 1, mode: 'shadow', contextSha256, imageSha256: grouping.imageSha256, capturedAtMs: grouping.capturedAtMs, items };
+        promoteProfileDependencies(work);
+        return work;
+    }
+    catch {
+        return undefined;
+    } // The full existing review remains available.
+}
+function validateProfileWork(work, context, sha256, capturedAtMs) {
+    const d = declarations(context);
+    if (!work || work.version !== 1 || work.mode !== 'shadow' || work.contextSha256 !== (0, exports.reviewContextHash)(context) ||
+        work.imageSha256 !== sha256 || work.capturedAtMs !== capturedAtMs || !Array.isArray(work.items) ||
+        work.items.length !== d.fields.length || new Set(work.items.map(i => i.field)).size !== d.fields.length)
+        throw Error('Invalid profile work identity');
+    for (const item of work.items) {
+        const owner = d.owners.has(item.field) ? 'detector' : hasOwn(d.properties, item.field) ? 'vlm' : 'unresolved';
+        if (!d.fields.includes(item.field) || item.producer !== owner || typeof item.selected !== 'boolean' ||
+            typeof item.reason !== 'string' || (!d.simple && !item.selected))
+            throw Error('Invalid profile work partition');
+    }
+    const presence = work.items.filter(i => PRESENCE_DEPENDENCIES.has(i.field));
+    if (presence.some(i => i.selected) && presence.some(i => !i.selected))
+        throw Error('Incomplete presence dependency');
+}
+/** Runs due questions together using existing model adapters; it has no upload capability. */
+async function reviewProfileBatch(input) {
+    const { context, work } = input, d = declarations(context);
+    if (!d.simple && Object.keys(d.properties).some(f => d.owners.has(f)))
+        throw Error('Dependent producer schema cannot be projected');
+    const sha256 = (0, crypto_1.createHash)('sha256').update(input.jpeg).digest('hex');
+    validateProfileWork(work, context, sha256, input.capturedAtMs);
+    if (!input.evidenceId || context.version !== 1 || typeof context.prompt !== 'string' ||
+        !Array.isArray(context.regions) || !Array.isArray(context.operatingPoints) || !Array.isArray(context.producerFields) ||
+        !Array.isArray(context.absenceWatchedFields))
+        throw Error('Incomplete retained profile');
+    const selected = work.items.filter(i => i.selected), vlm = selected.filter(i => i.producer === 'vlm').map(i => i.field);
+    const detector = selected.filter(i => i.producer === 'detector').map(i => i.field);
+    const structured = Object.create(null), resolved = new Set();
+    const modelCalls = { vlm: 0, producerBatches: 0 };
+    if (detector.length) {
+        modelCalls.producerBatches++;
+        const produced = await input.produce(d.producers.filter(p => detector.includes(p.field)));
+        for (const p of produced.produced) {
+            if (!detector.includes(p.field) || d.owners.get(p.field) !== p.modelId || resolved.has(p.field) ||
+                typeof p.value !== 'boolean' && !(typeof p.value === 'number' && Number.isFinite(p.value)))
+                throw Error('Invalid specialist result');
+            structured[p.field] = p.value;
+            resolved.add(p.field);
+        }
+    }
+    if (vlm.length) {
+        modelCalls.vlm++;
+        const schema = d.simple ? { ...d.schema, properties: Object.fromEntries(vlm.map(f => [f, d.properties[f]])),
+            required: (d.schema.required ?? []).filter((f) => vlm.includes(f)) } : d.schema;
+        const prompt = context.prompt + '\nThis review batch asks only for these JSON fields: ' + vlm.join(', ') +
+            '. Other configured questions are unreviewed in this batch; do not answer or infer their state. Keep the original region and field definitions.';
+        const result = await input.analyze({ jpeg: input.jpeg, schema, prompt });
+        if (!result || typeof result !== 'object' || Array.isArray(result))
+            throw Error('Invalid model response');
+        for (const f of vlm) {
+            // The existing model provider validates its schema. Do not manufacture missing answers.
+            const value = result[f], spec = d.properties[f];
+            const typeOk = spec.type === undefined || spec.type === 'integer' && Number.isInteger(value) ||
+                spec.type === 'number' && typeof value === 'number' && Number.isFinite(value) ||
+                spec.type === 'array' && Array.isArray(value) || spec.type === 'object' && typeof value === 'object' && !Array.isArray(value) ||
+                ['boolean', 'string'].includes(spec.type) && typeof value === spec.type;
+            if (hasOwn(result, f) && value !== undefined && value !== null && typeOk &&
+                (!Array.isArray(spec.enum) || spec.enum.includes(value))) {
+                structured[f] = value;
+                resolved.add(f);
+            }
+        }
+    }
+    return { version: 1, kind: 'profile_work_rehearsal', evidenceId: input.evidenceId, imageSha256: sha256,
+        contextSha256: work.contextSha256, capturedAtMs: input.capturedAtMs, reviewedAtMs: Date.now(),
+        selectedFields: selected.map(i => i.field), unreviewedFields: work.items.filter(i => !i.selected).map(i => i.field),
+        structured, unresolvedFields: selected.filter(i => !resolved.has(i.field)).map(i => i.field), modelCalls };
+}
+//# sourceMappingURL=ProfileReviewWork.js.map

package/dist/ProfileReviewWork.js.map

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

package/dist/RetainedFieldContract.d.ts

@@ -0,0 +1,21 @@
+/** Names/types/owners only: the complete profile never becomes a second VLM prompt. */
+export type RetainedFieldContract = {
+    version: 1;
+    required: RequiredField[];
+} | {
+    version: 1;
+    unavailable: string;
+};
+type RequiredField = {
+    field: string;
+    type: string;
+    modelId?: string;
+};
+/** Inspect the raw partition before sanitization can discard a requested check. */
+export declare function captureFieldContract(raw: Record<string, any>): RetainedFieldContract | null;
+/** Absent on old evidence; present malformed metadata must never become silence. */
+export declare function readFieldContract(value: unknown): RequiredField[] | null;
+/** Apply to fresh AND cached answers before any complete checkpoint or upload. */
+export declare function assertCompleteFields(required: RequiredField[] | null, structured: Record<string, unknown>, producedBy: Record<string, string> | null): void;
+export {};
+//# sourceMappingURL=RetainedFieldContract.d.ts.map

package/dist/RetainedFieldContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetainedFieldContract.d.ts","sourceRoot":"","sources":["../src/RetainedFieldContract.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,MAAM,qBAAqB,GAAG;IAAE,OAAO,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,GACzE;IAAE,OAAO,EAAE,CAAC,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AACxC,KAAK,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAOvE,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,qBAAqB,GAAG,IAAI,CAoC3F;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,EAAE,GAAG,IAAI,CAiBxE;AAaD,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxG,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,CAQjD"}

package/dist/RetainedFieldContract.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.captureFieldContract = captureFieldContract;
+exports.readFieldContract = readFieldContract;
+exports.assertCompleteFields = assertCompleteFields;
+const types = new Set(['hidden', 'counter', 'gauge', 'boolean', 'enum', 'category', 'list', 'distribution', 'string']);
+const object = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+const name = (value) => typeof value === 'string' && !!value.trim() && value === value.trim();
+const unavailable = (reason) => ({ version: 1, unavailable: reason });
+/** Inspect the raw partition before sanitization can discard a requested check. */
+function captureFieldContract(raw) {
+    // Older APIs have no ownership partition. Preserve their existing behavior.
+    if (raw.fieldRouting === undefined)
+        return null;
+    const routing = raw.fieldRouting;
+    if (!Array.isArray(raw.fields) || !object(routing)
+        || !Array.isArray(routing.vlm) || !Array.isArray(routing.producer) || !Array.isArray(routing.withheld)) {
+        return unavailable('malformed field partition');
+    }
+    const requested = new Map();
+    for (const field of raw.fields) {
+        if (!object(field) || !name(field.field) || !types.has(field.type) || requested.has(field.field)) {
+            return unavailable('malformed or duplicate requested field');
+        }
+        requested.set(field.field, field.type);
+    }
+    if (routing.withheld.length) {
+        const fields = routing.withheld.map((entry) => object(entry) && name(entry.field) ? entry.field : '<malformed>');
+        return unavailable('withheld fields: ' + fields.join(', '));
+    }
+    const seen = new Set();
+    const required = [];
+    for (const [owner, entries] of [['vlm', routing.vlm], ['producer', routing.producer]]) {
+        for (const field of entries) {
+            if (!object(field) || !name(field.field) || !types.has(field.type)
+                || requested.get(field.field) !== field.type || seen.has(field.field)
+                || owner === 'producer' && !name(field.modelId)) {
+                return unavailable('malformed or ambiguous field ownership');
+            }
+            seen.add(field.field);
+            // Hidden fields are internal and intentionally have no model answer.
+            if (field.type !== 'hidden')
+                required.push({ field: field.field, type: field.type,
+                    ...(owner === 'producer' ? { modelId: field.modelId } : {}) });
+        }
+    }
+    const missing = [...requested.keys()].filter(field => !seen.has(field));
+    return missing.length ? unavailable('unrouted fields: ' + missing.join(', ')) : { version: 1, required };
+}
+/** Absent on old evidence; present malformed metadata must never become silence. */
+function readFieldContract(value) {
+    if (value === undefined)
+        return null;
+    if (!object(value) || value.version !== 1 || Object.keys(value).length !== 2
+        || !Array.isArray(value.required)) {
+        const reason = object(value) && typeof value.unavailable === 'string' ? value.unavailable : 'malformed saved field contract';
+        throw Error('Retained profile unavailable; evidence retained: ' + reason);
+    }
+    const seen = new Set();
+    for (const field of value.required) {
+        if (!object(field) || !name(field.field) || !types.has(field.type) || field.type === 'hidden'
+            || seen.has(field.field) || Object.keys(field).some(key => !['field', 'type', 'modelId'].includes(key))
+            || field.modelId !== undefined && !name(field.modelId)) {
+            throw Error('Retained profile unavailable; malformed saved field contract');
+        }
+        seen.add(field.field);
+    }
+    return value.required;
+}
+function hasType(value, type) {
+    switch (type) {
+        case 'boolean': return typeof value === 'boolean';
+        case 'counter': return Number.isSafeInteger(value);
+        case 'gauge': return typeof value === 'number' && Number.isFinite(value);
+        case 'list': return Array.isArray(value) && value.every(item => typeof item === 'string');
+        case 'distribution': return object(value) && Object.values(value).every(item => typeof item === 'number' && Number.isFinite(item));
+        default: return typeof value === 'string';
+    }
+}
+/** Apply to fresh AND cached answers before any complete checkpoint or upload. */
+function assertCompleteFields(required, structured, producedBy) {
+    if (!required)
+        return;
+    const missing = required.filter(field => !Object.prototype.hasOwnProperty.call(structured, field.field)
+        || !hasType(structured[field.field], field.type)
+        || field.modelId !== undefined && (!producedBy || !Object.prototype.hasOwnProperty.call(producedBy, field.field)
+            || producedBy[field.field] !== field.modelId));
+    if (missing.length)
+        throw Error('Incomplete retained review; evidence retained for missing or invalid fields: '
+            + missing.map(field => field.field).join(', '));
+}
+//# sourceMappingURL=RetainedFieldContract.js.map

package/dist/RetainedFieldContract.js.map

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

package/dist/ReviewModelUse.d.ts

@@ -0,0 +1,7 @@
+export type ReviewModelUse = 'detector' | 'vlm' | 'both';
+/** Conservative admission for LocalSensingClient's captured execution branches.
+ * Missing/invalid/legacy or mixed contracts reserve both models. Execution still
+ * validates the complete contract; admission must never supply a fallback answer.
+ */
+export declare function retainedReviewModelUse(context: Record<string, any> | undefined): ReviewModelUse;
+//# sourceMappingURL=ReviewModelUse.d.ts.map

package/dist/ReviewModelUse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewModelUse.d.ts","sourceRoot":"","sources":["../src/ReviewModelUse.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,cAAc,CAc/F"}

package/dist/ReviewModelUse.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retainedReviewModelUse = retainedReviewModelUse;
+const RuntimeModelSelection_1 = require("./RuntimeModelSelection");
+const detectorCountReview_1 = require("./detectorCountReview");
+/** Conservative admission for LocalSensingClient's captured execution branches.
+ * Missing/invalid/legacy or mixed contracts reserve both models. Execution still
+ * validates the complete contract; admission must never supply a fallback answer.
+ */
+function retainedReviewModelUse(context) {
+    try {
+        if (!context || context.version !== 1 || !Array.isArray(context.producerFields)
+            || !Array.isArray(context.regions))
+            return 'both';
+        const selection = (0, RuntimeModelSelection_1.retainedModelSelection)(context);
+        if (!selection || selection.models.length !== 1)
+            return 'both';
+        const model = selection.models[0];
+        if (context.detectorCounts === true && context.scopedVlmReview === undefined
+            && model.format === 'onnx' && model.modelId === 'rfdetr_medium'
+            && (0, detectorCountReview_1.isPersonCountContract)(context.producerFields, new Map(context.regions)))
+            return 'detector';
+        if (context.detectorCounts === undefined && !context.producerFields.length
+            && !context.scopedVlmReview?.personCounts && model.format === 'litert-lm')
+            return 'vlm';
+    }
+    catch { /* The normal review path reports invalid evidence; reserve both. */ }
+    return 'both';
+}
+//# sourceMappingURL=ReviewModelUse.js.map

package/dist/ReviewModelUse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewModelUse.js","sourceRoot":"","sources":["../src/ReviewModelUse.ts"],"names":[],"mappings":";;AASA,wDAcC;AAvBD,mEAAiE;AACjE,+DAA8D;AAI9D;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,OAAwC;IAC7E,IAAI,CAAC;QACH,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC;eAC1E,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,CAAC;QACpD,MAAM,SAAS,GAAG,IAAA,8CAAsB,EAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QAC/D,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,OAAO,CAAC,cAAc,KAAK,IAAI,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS;eACvE,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,eAAe;eAC5D,IAAA,2CAAqB,EAAC,OAAO,CAAC,cAAc,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAAE,OAAO,UAAU,CAAC;QAChG,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM;eACrE,CAAC,OAAO,CAAC,eAAe,EAAE,YAAY,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;YAAE,OAAO,KAAK,CAAC;IAC5F,CAAC;IAAC,MAAM,CAAC,CAAC,oEAAoE,CAAC,CAAC;IAChF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/ReviewPriority.d.ts

@@ -0,0 +1,12 @@
+/** Explicit local test policy. Names and model answers never imply urgency. */
+export type ReviewPriority = 'urgent' | 'high' | 'normal';
+export type ReviewPolicy = import('@trillboards/edge-core').WireConnectorReviewPolicy;
+/** Missing is legacy/unconfigured. Present malformed metadata stays a named failure. */
+export declare function parseReviewPolicy(value: unknown): ReviewPolicy | null;
+export declare function isReviewPriority(value: unknown): value is ReviewPriority;
+export declare function reviewPriorityRank(value: unknown): number;
+/** Snapshot configuration so caller mutations cannot reprioritize saved work. */
+export declare function freezeReviewPriorities(input: Readonly<Record<string, ReviewPriority>> | undefined, feeds: readonly string[], enabled: boolean): ReadonlyMap<string, ReviewPriority> | null;
+/** Four preference turns, then one ordinary fair-camera turn. No timer hold. */
+export declare const PRIORITY_BURST = 4;
+//# sourceMappingURL=ReviewPriority.d.ts.map

package/dist/ReviewPriority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewPriority.d.ts","sourceRoot":"","sources":["../src/ReviewPriority.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,OAAO,wBAAwB,EAAE,yBAAyB,CAAC;AAEtF,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAQrE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGzD;AAED,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,GAAG,SAAS,EAChG,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAaxF;AAED,gFAAgF;AAChF,eAAO,MAAM,cAAc,IAAI,CAAC"}

package/dist/ReviewPriority.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRIORITY_BURST = void 0;
+exports.parseReviewPolicy = parseReviewPolicy;
+exports.isReviewPriority = isReviewPriority;
+exports.reviewPriorityRank = reviewPriorityRank;
+exports.freezeReviewPriorities = freezeReviewPriorities;
+/** Missing is legacy/unconfigured. Present malformed metadata stays a named failure. */
+function parseReviewPolicy(value) {
+    if (value === undefined || value === null)
+        return null;
+    if (typeof value === 'object' && !Array.isArray(value)) {
+        const policy = value;
+        if (policy.version === 1 && isReviewPriority(policy.priority)
+            && Object.keys(policy).length === 2)
+            return { version: 1, priority: policy.priority };
+    }
+    return { version: 1, invalid: true };
+}
+function isReviewPriority(value) {
+    return value === 'urgent' || value === 'high' || value === 'normal';
+}
+function reviewPriorityRank(value) {
+    // Old or damaged optional scheduling metadata must not delete evidence.
+    return value === 'urgent' ? 2 : value === 'high' ? 1 : 0;
+}
+/** Snapshot configuration so caller mutations cannot reprioritize saved work. */
+function freezeReviewPriorities(input, feeds, enabled) {
+    if (input === undefined)
+        return null;
+    if (!enabled || !input || typeof input !== 'object' || Array.isArray(input)) {
+        throw Error('Review priority requires an explicit continuous-review feed policy');
+    }
+    const result = new Map();
+    for (const [name, priority] of Object.entries(input)) {
+        if (!feeds.includes(name) || !isReviewPriority(priority)) {
+            throw Error('Review priority contains an unknown feed or invalid priority');
+        }
+        result.set(name, priority);
+    }
+    return result;
+}
+/** Four preference turns, then one ordinary fair-camera turn. No timer hold. */
+exports.PRIORITY_BURST = 4;
+//# sourceMappingURL=ReviewPriority.js.map

package/dist/ReviewPriority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewPriority.js","sourceRoot":"","sources":["../src/ReviewPriority.ts"],"names":[],"mappings":";;;AAKA,8CAQC;AAED,4CAEC;AAED,gDAGC;AAGD,wDAcC;AAnCD,wFAAwF;AACxF,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC;eACxD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC1F,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ,CAAC;AACtE,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAc;IAC/C,wEAAwE;IACxE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,iFAAiF;AACjF,SAAgB,sBAAsB,CAAC,KAA2D,EAChG,KAAwB,EAAE,OAAgB;IAC1C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5E,MAAM,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzD,MAAM,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gFAAgF;AACnE,QAAA,cAAc,GAAG,CAAC,CAAC"}

package/dist/RuntimeModelSelection.d.ts

@@ -0,0 +1,10 @@
+import type { WireConnectorModelSelection } from '@trillboards/edge-core';
+export type ModelSelection = Exclude<WireConnectorModelSelection, {
+    invalid: true;
+}>;
+export type ModelPin = ModelSelection['models'][number];
+export declare function parseModelSelection(value: unknown, allowImageClassifier?: boolean, allowRfDetrSource?: boolean): WireConnectorModelSelection | null;
+export declare function retainedModelSelection(context: Record<string, any> | undefined, allowImageClassifier?: boolean, allowRfDetrSource?: boolean): ModelSelection | null;
+/** Runtime-generated metadata, outside model text. Missing proof is never success. */
+export declare function assertVlmRuntimeProof(value: any, pin: ModelPin, requestedModel: string): void;
+//# sourceMappingURL=RuntimeModelSelection.d.ts.map

package/dist/RuntimeModelSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeModelSelection.d.ts","sourceRoot":"","sources":["../src/RuntimeModelSelection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,2BAA2B,EAAE;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC;AACrF,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAMxD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,oBAAoB,UAAQ,EAAE,iBAAiB,UAAQ,GAAG,2BAA2B,GAAG,IAAI,CAiB/I;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EAAE,oBAAoB,UAAQ,EAAE,iBAAiB,UAAQ,GAAG,cAAc,GAAG,IAAI,CAY/J;AAED,sFAAsF;AACtF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAU7F"}

package/dist/RuntimeModelSelection.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseModelSelection = parseModelSelection;
+exports.retainedModelSelection = retainedModelSelection;
+exports.assertVlmRuntimeProof = assertVlmRuntimeProof;
+const record = (v) => v && typeof v === 'object' && !Array.isArray(v);
+const key = (v) => typeof v === 'string' && /^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,127}$/.test(v);
+const keys = (v, expected) => record(v) && Object.keys(v).length === expected.length
+    && expected.every(k => Object.prototype.hasOwnProperty.call(v, k));
+function parseModelSelection(value, allowImageClassifier = false, allowRfDetrSource = false) {
+    if (value === undefined || value === null)
+        return null;
+    const v = value;
+    if (keys(v, ['version', 'selectionId', 'models', 'fieldOwners']) && v.version === 1 && key(v.selectionId)
+        && Array.isArray(v.models) && v.models.length >= 1 && v.models.length <= 16
+        && Array.isArray(v.fieldOwners) && v.fieldOwners.length >= 1 && v.fieldOwners.length <= 128
+        && v.models.every((m) => keys(m, ['modelId', 'format', 'sha256']) && key(m.modelId)
+            && (['onnx', 'litert-lm'].includes(m.format) || allowImageClassifier && m.format === 'tflite-image-classifier'
+                || allowRfDetrSource && m.format === 'safetensors-rfdetr')
+            && typeof m.sha256 === 'string' && /^[a-f0-9]{64}$/.test(m.sha256))
+        && v.fieldOwners.every((f) => keys(f, ['field', 'modelId']) && key(f.field) && key(f.modelId))
+        && new Set(v.models.map((m) => m.modelId)).size === v.models.length
+        && new Set(v.fieldOwners.map((f) => f.field)).size === v.fieldOwners.length
+        && v.fieldOwners.every((f) => v.models.some((m) => m.modelId === f.modelId))
+        && v.models.every((m) => v.fieldOwners.some((f) => f.modelId === m.modelId))
+        && v.models.filter((m) => m.format === 'litert-lm').length <= 1)
+        return JSON.parse(JSON.stringify(v));
+    return { version: 1, invalid: true };
+}
+function retainedModelSelection(context, allowImageClassifier = false, allowRfDetrSource = false) {
+    if (!context || context.modelSelection === undefined)
+        return null;
+    const selection = parseModelSelection(context.modelSelection, allowImageClassifier, allowRfDetrSource);
+    if (!selection || 'invalid' in selection)
+        throw Error('Invalid retained model selection; evidence retained');
+    const required = context.retainedFieldContract?.required;
+    if (!Array.isArray(required) || required.length !== selection.fieldOwners.length
+        || selection.fieldOwners.some(owner => {
+            const field = required.find((f) => f.field === owner.field);
+            const model = selection.models.find(m => m.modelId === owner.modelId);
+            return !field || (model.format !== 'litert-lm' ? field.modelId !== owner.modelId : field.modelId !== undefined);
+        }))
+        throw Error('Retained model selection does not match captured field ownership');
+    return selection;
+}
+/** Runtime-generated metadata, outside model text. Missing proof is never success. */
+function assertVlmRuntimeProof(value, pin, requestedModel) {
+    // The stock CLI spells a default CPU engine explicitly in its load proof,
+    // even though the request uses the bare model alias. This is the same CPU
+    // request, not permission to demote a selected GPU request or change weights.
+    const matchingRuntime = value?.runtimeModelId === requestedModel
+        || !requestedModel.includes(',') && value?.runtimeModelId === `${requestedModel},cpu`;
+    if (!keys(value, ['version', 'sha256', 'format', 'runtimeModelId']) || value.version !== 1
+        || value.sha256 !== pin.sha256 || value.format !== 'litert-lm' || !matchingRuntime) {
+        throw Error('Model verification failed: LiteRT-LM did not execute the selected artifact');
+    }
+}
+//# sourceMappingURL=RuntimeModelSelection.js.map

package/dist/RuntimeModelSelection.js.map

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

package/dist/SceneChangeDetector.d.ts

@@ -334,7 +334,7 @@ export declare class MotionGate {
      * heartbeat first (proof-of-life outranks everything), then the motion
      * verdict, then the suppressions that make a busy-but-boring scene cheap.
      */
-    evaluate(jpeg: Buffer, nowMs?: number): Promise<MotionGateResult>;
+    evaluate(jpeg: Buffer, nowMs?: number, forEvidence?: boolean, observeDecoded?: (frame: GreyFrame, result: MotionDetectResult) => void): Promise<MotionGateResult>;
     /**
      * Confirm the frame really reached the model. Called by the manager only
      * after `analyze()` resolves, so a frame the admission gate, the candidate

package/dist/SceneChangeDetector.d.ts.map

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

package/dist/SceneChangeDetector.js

@@ -390,7 +390,7 @@ class MotionGate {
      * heartbeat first (proof-of-life outranks everything), then the motion
      * verdict, then the suppressions that make a busy-but-boring scene cheap.
      */
-    async evaluate(jpeg, nowMs) {
+    async evaluate(jpeg, nowMs, forEvidence = false, observeDecoded) {
         const now = nowMs ?? this.now();
         this.evaluated++;
         const heartbeatDue = this.lastAnalyzedAtMs === null || now - this.lastAnalyzedAtMs >= this.heartbeatIntervalMs;
@@ -407,7 +407,17 @@ class MotionGate {
             return this.decide(true, 'undecodable', false, 0, [], null);
         }
         const result = this.detector.detect(grey);
+        // Reuse the raw decoded image for local selection experiments. The caller
+        // must not mutate it; no second JPEG decode is needed.
+        observeDecoded?.(grey, result);
         const live = result.motion && !result.calibrating;
+        // Preserve an audio event even while a heartbeat sample awaits the model.
+        if (forEvidence && this.pendingAudioOnsetAtMs !== null) {
+            const valid = now - this.pendingAudioOnsetAtMs <= this.audioOnsetTtlMs;
+            this.pendingAudioOnsetAtMs = null;
+            if (valid)
+                return this.decide(true, 'audio_onset', live, result.pctMotion, result.boxes, result.signature);
+        }
         if (heartbeatDue) {
             return this.decide(true, 'heartbeat', live, result.pctMotion, result.boxes, result.signature);
         }
@@ -416,7 +426,7 @@ class MotionGate {
         // camera has nothing to show for. It does NOT outrank the rate limit: the
         // inference budget is still the budget, and an un-consumed onset simply
         // stays pending and carries the NEXT look instead of being spent here.
-        const rateLimited = this.isRateLimited(now);
+        const rateLimited = !forEvidence && this.isRateLimited(now);
         if (this.pendingAudioOnsetAtMs !== null) {
             if (now - this.pendingAudioOnsetAtMs > this.audioOnsetTtlMs) {
                 // Stale: drop it rather than let it fire against a scene it never saw.
@@ -431,10 +441,12 @@ class MotionGate {
             return this.decide(false, 'no_motion', false, result.pctMotion, result.boxes, result.signature);
         }
         if (result.calibrating) {
-            // Dusk IR-cut flip / cloud shadow: everything "moved" and none of it is real.
-            return this.decide(false, 'calibrating', false, result.pctMotion, result.boxes, result.signature);
+            // Calibration can hide a real brief action as well as a lighting change.
+            // Continuous LOOK retains the evidence; the shared pump still limits AI.
+            // Legacy direct inference keeps its existing calibration suppression.
+            return this.decide(forEvidence, 'calibrating', false, result.pctMotion, result.boxes, result.signature);
         }
-        if (this.stationaryReanalyzeAfterMs > 0 &&
+        if (!forEvidence && this.stationaryReanalyzeAfterMs > 0 &&
             this.lastAnalyzedSignature !== null &&
             result.signature === this.lastAnalyzedSignature) {
             // Measured from the LAST LANDED ANALYSIS, which is exactly what the frame
@@ -450,7 +462,7 @@ class MotionGate {
                 return this.decide(false, 'stationary', live, result.pctMotion, result.boxes, result.signature);
             }
         }
-        if (this.isRateLimited(now)) {
+        if (!forEvidence && this.isRateLimited(now)) {
             return this.decide(false, 'rate_limited', live, result.pctMotion, result.boxes, result.signature);
         }
         return this.decide(true, 'motion', live, result.pctMotion, result.boxes, result.signature);