@trillboards/edge-core 0.1.0

package/dist/DeviceIdentity.d.ts

@@ -0,0 +1,32 @@
+/**
+ * DeviceIdentity — Cross-platform device fingerprinting.
+ * Port of DeviceIdentity.kt with Linux/Windows support.
+ *
+ * Linux: SHA-256 of /etc/machine-id + CPU model
+ * Windows: SHA-256 of registry MachineGuid + CPU model
+ * Persisted to ~/.trillboards/identity.json for stability.
+ */
+import type { DeviceIdentityInfo, PlatformAdapter } from './types';
+export declare class DeviceIdentity {
+    private identityInfo;
+    private platform;
+    constructor(platform: PlatformAdapter);
+    /**
+     * Generate or load a stable device fingerprint.
+     * SHA-256 hash of platform-specific machine identifiers.
+     */
+    getFingerprint(): Promise<string>;
+    /**
+     * Ephemeral session ID — new UUID each process launch.
+     * NOT persisted. Used for session-level tracking.
+     */
+    getSessionId(): string;
+    /**
+     * Full identity info including fingerprint, session, platform.
+     */
+    getIdentityInfo(): Promise<DeviceIdentityInfo>;
+    private detectPlatform;
+    private loadPersistedIdentity;
+    private persistIdentity;
+}
+//# sourceMappingURL=DeviceIdentity.d.ts.map

package/dist/DeviceIdentity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceIdentity.d.ts","sourceRoot":"","sources":["../src/DeviceIdentity.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAKnE,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,QAAQ,EAAE,eAAe;IAIrC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvC;;;OAGG;IACH,YAAY,IAAI,MAAM;IAOtB;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAmCpD,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,qBAAqB;IAY7B,OAAO,CAAC,eAAe;CAUxB"}

package/dist/DeviceIdentity.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * DeviceIdentity — Cross-platform device fingerprinting.
+ * Port of DeviceIdentity.kt with Linux/Windows support.
+ *
+ * Linux: SHA-256 of /etc/machine-id + CPU model
+ * Windows: SHA-256 of registry MachineGuid + CPU model
+ * Persisted to ~/.trillboards/identity.json for stability.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeviceIdentity = void 0;
+const crypto = __importStar(require("crypto"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const uuid_1 = require("uuid");
+const IDENTITY_DIR = path.join(os.homedir(), '.trillboards');
+const IDENTITY_FILE = path.join(IDENTITY_DIR, 'identity.json');
+class DeviceIdentity {
+    constructor(platform) {
+        this.identityInfo = null;
+        this.platform = platform;
+    }
+    /**
+     * Generate or load a stable device fingerprint.
+     * SHA-256 hash of platform-specific machine identifiers.
+     */
+    async getFingerprint() {
+        const info = await this.getIdentityInfo();
+        return info.fingerprint;
+    }
+    /**
+     * Ephemeral session ID — new UUID each process launch.
+     * NOT persisted. Used for session-level tracking.
+     */
+    getSessionId() {
+        if (!this.identityInfo) {
+            return (0, uuid_1.v4)();
+        }
+        return this.identityInfo.sessionId;
+    }
+    /**
+     * Full identity info including fingerprint, session, platform.
+     */
+    async getIdentityInfo() {
+        if (this.identityInfo) {
+            return this.identityInfo;
+        }
+        // Try to load persisted fingerprint
+        const persisted = this.loadPersistedIdentity();
+        if (persisted) {
+            // Reuse fingerprint, but generate fresh sessionId
+            this.identityInfo = {
+                ...persisted,
+                sessionId: (0, uuid_1.v4)(),
+            };
+            return this.identityInfo;
+        }
+        // Generate new fingerprint
+        const machineId = await this.platform.getMachineId();
+        const cpuInfo = this.platform.getCpuInfo();
+        const raw = `${machineId}|${cpuInfo.model}|${cpuInfo.architecture}`;
+        const fingerprint = crypto.createHash('sha256').update(raw).digest('hex');
+        const platformName = this.detectPlatform();
+        this.identityInfo = {
+            fingerprint,
+            sessionId: (0, uuid_1.v4)(),
+            platform: platformName,
+            machineId,
+            createdAt: Date.now(),
+        };
+        this.persistIdentity(this.identityInfo);
+        return this.identityInfo;
+    }
+    detectPlatform() {
+        const p = os.platform();
+        if (p === 'linux')
+            return 'linux';
+        if (p === 'win32')
+            return 'windows';
+        return 'linux'; // default for cross-platform
+    }
+    loadPersistedIdentity() {
+        try {
+            if (fs.existsSync(IDENTITY_FILE)) {
+                const data = fs.readFileSync(IDENTITY_FILE, 'utf-8');
+                return JSON.parse(data);
+            }
+        }
+        catch {
+            // Corrupted file — regenerate
+        }
+        return null;
+    }
+    persistIdentity(info) {
+        try {
+            if (!fs.existsSync(IDENTITY_DIR)) {
+                fs.mkdirSync(IDENTITY_DIR, { recursive: true });
+            }
+            fs.writeFileSync(IDENTITY_FILE, JSON.stringify(info, null, 2));
+        }
+        catch {
+            // Non-fatal — fingerprint still works in-memory
+        }
+    }
+}
+exports.DeviceIdentity = DeviceIdentity;
+//# sourceMappingURL=DeviceIdentity.js.map

package/dist/DeviceIdentity.js.map

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

package/dist/DeviceProfile.d.ts

@@ -0,0 +1,39 @@
+/**
+ * DeviceProfile — Capability matrix for cross-platform devices.
+ * Port of DeviceProfile.kt, extended for Linux/Windows tiers.
+ *
+ * Tiers:
+ *   TIER_1: 6+ TOPS NPU, 8GB+ — ALL models always ON (e.g., RK3588)
+ *   TIER_2: 4-8GB RAM — most models ON (e.g., Backpackster i7-7500U, Snapdragon 6xx+)
+ *   TIER_3: 2-4GB RAM — basic models, aggressive shedding
+ *   TIER_4: <2GB — display only, NO ML
+ *
+ * Extended for cross-platform:
+ *   - Linux x86_64 with OpenVINO → TIER_2 (Backpackster)
+ *   - Windows with DirectML GPU → TIER_1 or TIER_2
+ *   - Windows CPU-only → TIER_2 or TIER_3
+ */
+import { CapabilityTier, ModelAvailability, AttenuationTier, type DeviceCapabilityMatrix, type PlatformAdapter } from './types';
+/**
+ * Compute capability tier from runtime capabilities.
+ * Runtime capabilities are the PRIMARY signal, not hardware strings.
+ */
+export declare function computeTier(platform: PlatformAdapter): CapabilityTier;
+/**
+ * Get the full capability matrix for a given tier.
+ */
+export declare function getCapabilityMatrix(tier: CapabilityTier): DeviceCapabilityMatrix;
+/**
+ * Check if a model should be active given current attenuation tier.
+ */
+export declare function isModelActive(availability: ModelAvailability, currentAttenuation: AttenuationTier): boolean;
+/**
+ * Get the order in which models should be shed under memory pressure.
+ * Last in array = shed first.
+ */
+export declare function getShedOrder(): string[];
+/**
+ * Determine current attenuation tier from memory free percentage.
+ */
+export declare function getAttenuationTier(matrix: DeviceCapabilityMatrix, freeMemoryPercent: number): AttenuationTier;
+//# sourceMappingURL=DeviceProfile.d.ts.map

package/dist/DeviceProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceProfile.d.ts","sourceRoot":"","sources":["../src/DeviceProfile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACrB,MAAM,SAAS,CAAC;AA4GjB;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,cAAc,CAqBrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,sBAAsB,CAWhF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,iBAAiB,EAC/B,kBAAkB,EAAE,eAAe,GAClC,OAAO,CAcT;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,EAC9B,iBAAiB,EAAE,MAAM,GACxB,eAAe,CAMjB"}

package/dist/DeviceProfile.js

@@ -0,0 +1,199 @@
+"use strict";
+/**
+ * DeviceProfile — Capability matrix for cross-platform devices.
+ * Port of DeviceProfile.kt, extended for Linux/Windows tiers.
+ *
+ * Tiers:
+ *   TIER_1: 6+ TOPS NPU, 8GB+ — ALL models always ON (e.g., RK3588)
+ *   TIER_2: 4-8GB RAM — most models ON (e.g., Backpackster i7-7500U, Snapdragon 6xx+)
+ *   TIER_3: 2-4GB RAM — basic models, aggressive shedding
+ *   TIER_4: <2GB — display only, NO ML
+ *
+ * Extended for cross-platform:
+ *   - Linux x86_64 with OpenVINO → TIER_2 (Backpackster)
+ *   - Windows with DirectML GPU → TIER_1 or TIER_2
+ *   - Windows CPU-only → TIER_2 or TIER_3
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAttenuationTier = exports.getShedOrder = exports.isModelActive = exports.getCapabilityMatrix = exports.computeTier = void 0;
+const types_1 = require("./types");
+/** Tier-specific model shed order: last to shed → first to shed */
+const SHED_ORDER = [
+    'footTraffic',
+    'ageGender',
+    'gazeTracking',
+    'poseEngagement',
+    'ferEmotion',
+    'whisperAsr',
+    'yamnetAudio',
+    'blazeFace',
+];
+// ─── Preset Capability Matrices ─────────────────────────────────────────────
+const TIER_1_MATRIX = {
+    tier: types_1.CapabilityTier.TIER_1,
+    description: 'High-end NPU (RK3588) or dedicated GPU — ALL models always ON',
+    targetFps: 12,
+    resolution: { width: 480, height: 360 },
+    blazeFace: types_1.ModelAvailability.ALWAYS_ON,
+    yamnetAudio: types_1.ModelAvailability.ALWAYS_ON,
+    whisperAsr: types_1.ModelAvailability.ALWAYS_ON,
+    ferEmotion: types_1.ModelAvailability.ALWAYS_ON,
+    poseEngagement: types_1.ModelAvailability.ALWAYS_ON,
+    ageGender: types_1.ModelAvailability.ALWAYS_ON,
+    gazeTracking: types_1.ModelAvailability.ALWAYS_ON,
+    geminiVisionCadenceSeconds: 300,
+    geminiVisionFaceDetectedCadenceSeconds: 30,
+    federatedLearningEnabled: true,
+    federatedSparseUpload: false,
+    attenuationEnabled: false,
+    attenuationMediumThreshold: 0,
+    attenuationHighThreshold: 0,
+    attenuationCriticalThreshold: 0,
+    maxRecoveryLevel: 6,
+};
+const TIER_2_MATRIX = {
+    tier: types_1.CapabilityTier.TIER_2,
+    description: 'Mid-range (Backpackster i7, Snapdragon 6xx+, Windows mini-PC) — most models ON',
+    targetFps: 8,
+    resolution: { width: 480, height: 360 },
+    blazeFace: types_1.ModelAvailability.ALWAYS_ON,
+    yamnetAudio: types_1.ModelAvailability.ALWAYS_ON,
+    whisperAsr: types_1.ModelAvailability.ALWAYS_ON,
+    ferEmotion: types_1.ModelAvailability.SHED_AT_HIGH,
+    poseEngagement: types_1.ModelAvailability.SHED_AT_HIGH,
+    ageGender: types_1.ModelAvailability.SHED_AT_MEDIUM,
+    gazeTracking: types_1.ModelAvailability.SHED_AT_HIGH,
+    geminiVisionCadenceSeconds: 300,
+    geminiVisionFaceDetectedCadenceSeconds: 30,
+    federatedLearningEnabled: true,
+    federatedSparseUpload: false,
+    attenuationEnabled: true,
+    attenuationMediumThreshold: 30,
+    attenuationHighThreshold: 20,
+    attenuationCriticalThreshold: 10,
+    maxRecoveryLevel: 5,
+};
+const TIER_3_MATRIX = {
+    tier: types_1.CapabilityTier.TIER_3,
+    description: 'Budget (2-4GB RAM) — basic models, aggressive shedding',
+    targetFps: 4,
+    resolution: { width: 320, height: 240 },
+    blazeFace: types_1.ModelAvailability.ALWAYS_ON,
+    yamnetAudio: types_1.ModelAvailability.ALWAYS_ON,
+    whisperAsr: types_1.ModelAvailability.SHED_AT_MEDIUM,
+    ferEmotion: types_1.ModelAvailability.SHED_AT_MEDIUM,
+    poseEngagement: types_1.ModelAvailability.OFF,
+    ageGender: types_1.ModelAvailability.OFF,
+    gazeTracking: types_1.ModelAvailability.OFF,
+    geminiVisionCadenceSeconds: 300,
+    geminiVisionFaceDetectedCadenceSeconds: 30,
+    federatedLearningEnabled: true,
+    federatedSparseUpload: true, // top 5% only
+    attenuationEnabled: true,
+    attenuationMediumThreshold: 40,
+    attenuationHighThreshold: 25,
+    attenuationCriticalThreshold: 15,
+    maxRecoveryLevel: 4,
+};
+const TIER_4_MATRIX = {
+    tier: types_1.CapabilityTier.TIER_4,
+    description: 'Legacy (<2GB) — display only, NO ML',
+    targetFps: 0,
+    resolution: { width: 320, height: 240 },
+    blazeFace: types_1.ModelAvailability.OFF,
+    yamnetAudio: types_1.ModelAvailability.OFF,
+    whisperAsr: types_1.ModelAvailability.OFF,
+    ferEmotion: types_1.ModelAvailability.OFF,
+    poseEngagement: types_1.ModelAvailability.OFF,
+    ageGender: types_1.ModelAvailability.OFF,
+    gazeTracking: types_1.ModelAvailability.OFF,
+    geminiVisionCadenceSeconds: 600,
+    geminiVisionFaceDetectedCadenceSeconds: 60,
+    federatedLearningEnabled: false,
+    federatedSparseUpload: false,
+    attenuationEnabled: false,
+    attenuationMediumThreshold: 0,
+    attenuationHighThreshold: 0,
+    attenuationCriticalThreshold: 0,
+    maxRecoveryLevel: 2,
+};
+/**
+ * Compute capability tier from runtime capabilities.
+ * Runtime capabilities are the PRIMARY signal, not hardware strings.
+ */
+function computeTier(platform) {
+    const mem = platform.getMemoryInfo();
+    const cpu = platform.getCpuInfo();
+    // TIER_1: 8GB+ RAM and 6+ cores (or known NPU hardware)
+    if (mem.totalMb >= 8192 && cpu.cores >= 6) {
+        return types_1.CapabilityTier.TIER_1;
+    }
+    // TIER_2: 4GB+ RAM and 4+ cores (Backpackster: 16GB, i7-7500U 4 threads)
+    if (mem.totalMb >= 3072 && cpu.cores >= 4) {
+        return types_1.CapabilityTier.TIER_2;
+    }
+    // TIER_3: 2GB+ RAM
+    if (mem.totalMb >= 2048) {
+        return types_1.CapabilityTier.TIER_3;
+    }
+    // TIER_4: <2GB
+    return types_1.CapabilityTier.TIER_4;
+}
+exports.computeTier = computeTier;
+/**
+ * Get the full capability matrix for a given tier.
+ */
+function getCapabilityMatrix(tier) {
+    switch (tier) {
+        case types_1.CapabilityTier.TIER_1:
+            return { ...TIER_1_MATRIX };
+        case types_1.CapabilityTier.TIER_2:
+            return { ...TIER_2_MATRIX };
+        case types_1.CapabilityTier.TIER_3:
+            return { ...TIER_3_MATRIX };
+        case types_1.CapabilityTier.TIER_4:
+            return { ...TIER_4_MATRIX };
+    }
+}
+exports.getCapabilityMatrix = getCapabilityMatrix;
+/**
+ * Check if a model should be active given current attenuation tier.
+ */
+function isModelActive(availability, currentAttenuation) {
+    switch (availability) {
+        case types_1.ModelAvailability.ALWAYS_ON:
+            return true;
+        case types_1.ModelAvailability.SHED_AT_MEDIUM:
+            return currentAttenuation === types_1.AttenuationTier.NONE;
+        case types_1.ModelAvailability.SHED_AT_HIGH:
+            return (currentAttenuation === types_1.AttenuationTier.NONE ||
+                currentAttenuation === types_1.AttenuationTier.MEDIUM);
+        case types_1.ModelAvailability.OFF:
+            return false;
+    }
+}
+exports.isModelActive = isModelActive;
+/**
+ * Get the order in which models should be shed under memory pressure.
+ * Last in array = shed first.
+ */
+function getShedOrder() {
+    return [...SHED_ORDER];
+}
+exports.getShedOrder = getShedOrder;
+/**
+ * Determine current attenuation tier from memory free percentage.
+ */
+function getAttenuationTier(matrix, freeMemoryPercent) {
+    if (!matrix.attenuationEnabled)
+        return types_1.AttenuationTier.NONE;
+    if (freeMemoryPercent <= matrix.attenuationCriticalThreshold)
+        return types_1.AttenuationTier.CRITICAL;
+    if (freeMemoryPercent <= matrix.attenuationHighThreshold)
+        return types_1.AttenuationTier.HIGH;
+    if (freeMemoryPercent <= matrix.attenuationMediumThreshold)
+        return types_1.AttenuationTier.MEDIUM;
+    return types_1.AttenuationTier.NONE;
+}
+exports.getAttenuationTier = getAttenuationTier;
+//# sourceMappingURL=DeviceProfile.js.map

package/dist/DeviceProfile.js.map

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

package/dist/ObservationSignalClassifier.d.ts

@@ -0,0 +1,33 @@
+/**
+ * ObservationSignalClassifier — Signal taxonomy and classification.
+ * 1:1 port of ObservationSignalClassifier.kt.
+ *
+ * Classifies each aggregation window into:
+ *   - observationFamily: SCREEN_AUDIENCE | AMBIENT_COMMERCE_INTENT | DIAGNOSTIC_PROBE | EMPTY_SCENE
+ *   - evidenceGrade: FACE_BACKED | PERSON_BACKED | SPEECH_ONLY | PROXY_ONLY | EMPTY
+ *   - decisionability: DECISIONABLE | NON_DECISIONABLE
+ *   - measurementQuality: face_backed | ambient_proxy_only | proxy_only | empty_scene
+ */
+import type { ObservationSignalClassification } from './types';
+export interface ClassificationInput {
+    avgFaceCountWindow: number;
+    currentFaceCount: number;
+    avgPersonCountWindow: number;
+    currentPersonCount: number;
+    speechSignalsPresent: boolean;
+    proxySignalsPresent: boolean;
+    proxySignalMismatch: boolean;
+    captureMode?: string;
+}
+/**
+ * Classify an observation window. Logic matches Kotlin exactly:
+ *
+ * 1. Compute baseEvidenceGrade from sensor signals
+ * 2. Downgrade to PROXY_ONLY if captureMode is probe and not face-backed
+ * 3. Determine measurementQuality (proxySignalMismatch demotes to proxy_only)
+ * 4. Determine observationFamily (captureMode checked FIRST)
+ * 5. Determine decisionability
+ * 6. Collect per-grade decision block reasons (one reason per grade, not multiple)
+ */
+export declare function classifyObservationSignal(input: ClassificationInput): ObservationSignalClassification;
+//# sourceMappingURL=ObservationSignalClassifier.d.ts.map

package/dist/ObservationSignalClassifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservationSignalClassifier.d.ts","sourceRoot":"","sources":["../src/ObservationSignalClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAIV,+BAA+B,EAChC,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,mBAAmB,GACzB,+BAA+B,CAgGjC"}

package/dist/ObservationSignalClassifier.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * ObservationSignalClassifier — Signal taxonomy and classification.
+ * 1:1 port of ObservationSignalClassifier.kt.
+ *
+ * Classifies each aggregation window into:
+ *   - observationFamily: SCREEN_AUDIENCE | AMBIENT_COMMERCE_INTENT | DIAGNOSTIC_PROBE | EMPTY_SCENE
+ *   - evidenceGrade: FACE_BACKED | PERSON_BACKED | SPEECH_ONLY | PROXY_ONLY | EMPTY
+ *   - decisionability: DECISIONABLE | NON_DECISIONABLE
+ *   - measurementQuality: face_backed | ambient_proxy_only | proxy_only | empty_scene
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyObservationSignal = void 0;
+/**
+ * Classify an observation window. Logic matches Kotlin exactly:
+ *
+ * 1. Compute baseEvidenceGrade from sensor signals
+ * 2. Downgrade to PROXY_ONLY if captureMode is probe and not face-backed
+ * 3. Determine measurementQuality (proxySignalMismatch demotes to proxy_only)
+ * 4. Determine observationFamily (captureMode checked FIRST)
+ * 5. Determine decisionability
+ * 6. Collect per-grade decision block reasons (one reason per grade, not multiple)
+ */
+function classifyObservationSignal(input) {
+    // Step 1: Base evidence grade — Kotlin thresholds exactly
+    let baseEvidenceGrade;
+    if (input.currentFaceCount > 0 || input.avgFaceCountWindow >= 1.0) {
+        baseEvidenceGrade = 'FACE_BACKED';
+    }
+    else if (input.currentPersonCount > 0 ||
+        input.avgPersonCountWindow >= 0.75) {
+        baseEvidenceGrade = 'PERSON_BACKED';
+    }
+    else if (input.speechSignalsPresent) {
+        baseEvidenceGrade = 'SPEECH_ONLY';
+    }
+    else if (input.proxySignalsPresent || input.proxySignalMismatch) {
+        baseEvidenceGrade = 'PROXY_ONLY';
+    }
+    else {
+        baseEvidenceGrade = 'EMPTY';
+    }
+    // Step 2: Downgrade for probe mode (Kotlin line 43-47)
+    const evidenceGrade = input.captureMode === 'signal_mismatch_probe' &&
+        baseEvidenceGrade !== 'FACE_BACKED'
+        ? 'PROXY_ONLY'
+        : baseEvidenceGrade;
+    // Step 3: Measurement quality — Kotlin checks proxySignalMismatch for all non-face grades
+    let measurementQuality;
+    switch (evidenceGrade) {
+        case 'FACE_BACKED':
+            measurementQuality = 'face_backed';
+            break;
+        case 'PERSON_BACKED':
+        case 'SPEECH_ONLY':
+        case 'PROXY_ONLY':
+            measurementQuality = input.proxySignalMismatch
+                ? 'proxy_only'
+                : 'ambient_proxy_only';
+            break;
+        default:
+            measurementQuality = 'empty_scene';
+    }
+    // Step 4: Observation family — captureMode checked FIRST (Kotlin line 55-59)
+    let observationFamily;
+    if (input.captureMode === 'signal_mismatch_probe') {
+        observationFamily = 'DIAGNOSTIC_PROBE';
+    }
+    else if (evidenceGrade === 'FACE_BACKED') {
+        observationFamily = 'SCREEN_AUDIENCE';
+    }
+    else if (evidenceGrade === 'EMPTY') {
+        observationFamily = 'EMPTY_SCENE';
+    }
+    else {
+        observationFamily = 'AMBIENT_COMMERCE_INTENT';
+    }
+    // Step 5: Decisionability
+    const decisionability = observationFamily === 'SCREEN_AUDIENCE' &&
+        evidenceGrade === 'FACE_BACKED'
+        ? 'DECISIONABLE'
+        : 'NON_DECISIONABLE';
+    // Step 6: Decision block reasons — per-grade, using linkedSet semantics (no dupes)
+    const reasons = new Set();
+    if (observationFamily === 'DIAGNOSTIC_PROBE') {
+        reasons.add('diagnostic_capture');
+    }
+    if (decisionability === 'NON_DECISIONABLE') {
+        switch (evidenceGrade) {
+            case 'PERSON_BACKED':
+                reasons.add('no_face_confirmation');
+                break;
+            case 'SPEECH_ONLY':
+                reasons.add('no_visual_confirmation');
+                break;
+            case 'PROXY_ONLY':
+                reasons.add('proxy_signal_only');
+                break;
+            case 'EMPTY':
+                reasons.add('empty_scene');
+                break;
+        }
+    }
+    if (input.proxySignalMismatch) {
+        reasons.add('proxy_signal_mismatch');
+    }
+    return {
+        observationFamily,
+        evidenceGrade,
+        decisionability,
+        decisionBlockReasons: [...reasons],
+        measurementQuality,
+    };
+}
+exports.classifyObservationSignal = classifyObservationSignal;
+//# sourceMappingURL=ObservationSignalClassifier.js.map

package/dist/ObservationSignalClassifier.js.map

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

package/dist/RecoveryLadder.d.ts

@@ -0,0 +1,58 @@
+/**
+ * RecoveryLadder — 6-level autonomous recovery system.
+ * Port of RecoveryLadder.kt. Platform-specific recovery actions via callbacks.
+ *
+ * Levels:
+ * 1. Network Drop → Socket.io handles (infinite reconnect with exp backoff)
+ * 2. Player Stuck → Reload (3x) → Recreate (3x)
+ * 3. Camera/Mic Failure → Unbind/rebind hardware
+ * 4. Memory Pressure → Attenuate (shed models, restore)
+ * 5. Full Service Restart → Stop + restart service (3x per 24h)
+ * 6. OTA Rollback → Server-initiated install of previous version
+ */
+import { Subsystem, type RecoveryAction } from './types';
+import { SubsystemHealthRegistry } from './SubsystemHealthRegistry';
+export interface RecoveryCallbacks {
+    onReloadPlayer(): Promise<void>;
+    onRecreatePlayer(): Promise<void>;
+    onRebindCamera(): Promise<void>;
+    onRebindMicrophone(): Promise<void>;
+    onRestartSensingService(): Promise<void>;
+    onRestartDeviceService(): Promise<void>;
+    onRollback?(version: string): Promise<void>;
+    onEmitRecoveryEvent(event: string, details: Record<string, unknown>): void;
+}
+export declare class RecoveryLadder {
+    private healthRegistry;
+    private callbacks;
+    private maxRecoveryLevel;
+    private state;
+    private recoveryHistory;
+    private checkInterval;
+    constructor(healthRegistry: SubsystemHealthRegistry, callbacks: RecoveryCallbacks, maxRecoveryLevel?: number);
+    /**
+     * Start periodic recovery checks (every 30s, matching Kotlin).
+     */
+    start(): void;
+    /**
+     * Stop periodic checks.
+     */
+    stop(): void;
+    /**
+     * Check subsystem health and trigger recovery if needed.
+     * Called every 30s by the interval, or manually.
+     */
+    checkAndRecover(): Promise<void>;
+    /**
+     * Handle a specific subsystem failure with escalating recovery.
+     */
+    handleFailure(subsystem: Subsystem): Promise<void>;
+    private recoverPlayer;
+    private recoverHardware;
+    private attemptServiceRestart;
+    private recordAction;
+    private resetAttempts;
+    private getDayOfYear;
+    getRecoveryHistory(): RecoveryAction[];
+}
+//# sourceMappingURL=RecoveryLadder.d.ts.map

package/dist/RecoveryLadder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecoveryLadder.d.ts","sourceRoot":"","sources":["../src/RecoveryLadder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,SAAS,EAET,KAAK,cAAc,EACpB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,UAAU,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5E;AAiBD,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,aAAa,CAA+C;gBAGlE,cAAc,EAAE,uBAAuB,EACvC,SAAS,EAAE,iBAAiB,EAC5B,gBAAgB,GAAE,MAAU;IAe9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBtC;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;YA8C1C,aAAa;YAoBb,eAAe;YAmBf,qBAAqB;IAsBnC,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,YAAY;IAOpB,kBAAkB,IAAI,cAAc,EAAE;CAGvC"}