@mindexec/cli 0.2.101 → 0.2.103

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindexec/cli",
-  "version": "0.2.101",
+  "version": "0.2.103",
   "description": "MindExec local runtime and bridge CLI",
   "main": "server.js",
   "type": "module",
@@ -47,7 +47,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@mindexec/remote": "^0.1.15",
+    "@mindexec/remote": "^0.1.16",
     "@openai/codex-sdk": "^0.137.0",
     "chokidar": "^3.6.0",
     "cors": "^2.8.5",

package/remote-hub.js

@@ -20,6 +20,7 @@ const MAX_SYNTHETIC_DEVICES = 1000;
 const DEFAULT_HOST_TARGET_LEASE_MS = 30000;
 const SYNTHETIC_FRAME_DATA_URL = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAIAAAABCAYAAAD0In+KAAAADElEQVR42mP8z8AAAAMBAQDJ/pLvAAAAAElFTkSuQmCC';
 const SYNTHETIC_FRAME_PAYLOAD = Buffer.from(SYNTHETIC_FRAME_DATA_URL.split(',')[1], 'base64');
+const SYNTHETIC_FRAME_HASH = crypto.createHash('sha256').update(SYNTHETIC_FRAME_PAYLOAD).digest('hex').slice(0, 16);
 
 function isEnabledValue(value, fallback = true) {
     if (value === undefined || value === null || value === '') {
@@ -785,6 +786,9 @@ export function createRemoteHub(options = {}) {
             receivedAt: now,
             byteLength: 68,
             transport: 'synthetic',
+            contentHash: SYNTHETIC_FRAME_HASH,
+            captureMs: 0,
+            sameContentStreak: 0,
             dataUrl: SYNTHETIC_FRAME_DATA_URL,
             payload: SYNTHETIC_FRAME_PAYLOAD,
             accessToken: createFrameAccessToken()
@@ -1468,6 +1472,37 @@ export function createRemoteHub(options = {}) {
         return Buffer.from(base64, 'base64');
     }
 
+    function buildFrameContentHash(message, payload) {
+        const provided = safeString(message.contentHash || message.frameHash || message.hash, 96)
+            .toLowerCase()
+            .replace(/[^a-z0-9:_-]/g, '')
+            .slice(0, 64);
+        if (provided) {
+            return provided;
+        }
+
+        if (!Buffer.isBuffer(payload) || payload.length === 0) {
+            return '';
+        }
+
+        return crypto.createHash('sha256').update(payload).digest('hex').slice(0, 16);
+    }
+
+    function readFrameCaptureMs(message) {
+        const value = Number(message.captureMs);
+        return Number.isFinite(value) && value >= 0
+            ? Math.round(value)
+            : 0;
+    }
+
+    function computeSameContentStreak(previousFrame, contentHash) {
+        if (!contentHash || !previousFrame?.contentHash || previousFrame.contentHash !== contentHash) {
+            return 0;
+        }
+
+        return clampNumber(Number(previousFrame.sameContentStreak || 0) + 1, 0, 1000000, 1);
+    }
+
     function applyThumbnailFrame(device, message, framePayload, transport = 'json-base64') {
         const frameData = Buffer.isBuffer(framePayload)
             ? ''
@@ -1489,6 +1524,8 @@ export function createRemoteHub(options = {}) {
         const mimeType = safeString(message.mimeType || message.format || 'image/jpeg', 80) || 'image/jpeg';
         const capturedAt = safeString(message.capturedAt, 80) || device.lastSeenAt;
         const payload = buildFramePayloadBuffer(framePayload, frameData);
+        const contentHash = buildFrameContentHash(message, payload);
+        const sameContentStreak = computeSameContentStreak(device.latestThumbnail, contentHash);
         device.latestThumbnail = {
             streamId: safeString(message.streamId, 128) || 'thumbnail',
             frameSeq,
@@ -1501,6 +1538,9 @@ export function createRemoteHub(options = {}) {
             receivedAt: device.lastSeenAt,
             byteLength,
             transport,
+            contentHash,
+            captureMs: readFrameCaptureMs(message),
+            sameContentStreak,
             dataUrl: buildFrameDataUrl(framePayload, frameData, mimeType),
             payload,
             accessToken: createFrameAccessToken()
@@ -1511,7 +1551,9 @@ export function createRemoteHub(options = {}) {
             frameSeq,
             width: device.latestThumbnail.width,
             height: device.latestThumbnail.height,
-            transport
+            transport,
+            contentHash,
+            sameContentStreak
         });
         return true;
     }
@@ -1550,6 +1592,8 @@ export function createRemoteHub(options = {}) {
         const mimeType = safeString(message.mimeType || message.format || 'image/jpeg', 80) || 'image/jpeg';
         const capturedAt = safeString(message.capturedAt, 80) || device.lastSeenAt;
         const payload = buildFramePayloadBuffer(framePayload, frameData);
+        const contentHash = buildFrameContentHash(message, payload);
+        const sameContentStreak = computeSameContentStreak(device.latestLiveFrame, contentHash);
         device.latestLiveFrame = {
             streamId,
             frameSeq,
@@ -1564,6 +1608,9 @@ export function createRemoteHub(options = {}) {
             receivedAt: device.lastSeenAt,
             byteLength,
             transport,
+            contentHash,
+            captureMs: readFrameCaptureMs(message),
+            sameContentStreak,
             dataUrl: buildFrameDataUrl(framePayload, frameData, mimeType),
             payload,
             accessToken: createFrameAccessToken()
@@ -1578,7 +1625,9 @@ export function createRemoteHub(options = {}) {
             width: device.latestLiveFrame.width,
             height: device.latestLiveFrame.height,
             mode: device.latestLiveFrame.mode,
-            transport
+            transport,
+            contentHash,
+            sameContentStreak
         });
         return true;
     }

package/scripts/remote-hub-smoke.mjs

@@ -169,10 +169,14 @@ try {
     assert.equal(binaryThumbnailDevice.latestThumbnail.streamId, 'smoke-thumb-binary');
     assert.equal(binaryThumbnailDevice.latestThumbnail.transport, 'binary');
     assert.equal(binaryThumbnailDevice.latestThumbnail.byteLength, smokePngFrame.length);
+    assert.equal(typeof binaryThumbnailDevice.latestThumbnail.contentHash, 'string');
+    assert.equal(binaryThumbnailDevice.latestThumbnail.contentHash.length, 16);
+    assert.equal(binaryThumbnailDevice.latestThumbnail.sameContentStreak, 1);
     assert.equal(binaryThumbnailDevice.counters.thumbnailFramesReceived, 2);
     const serializedBinaryThumbnail = hub.getDeviceThumbnail('smoke-device', { includeDataUrl: false });
     assert.equal(serializedBinaryThumbnail.streamId, 'smoke-thumb-binary');
     assert.equal(serializedBinaryThumbnail.frameSeq, 4);
+    assert.equal(serializedBinaryThumbnail.contentHash, binaryThumbnailDevice.latestThumbnail.contentHash);
     assert.ok(serializedBinaryThumbnail.framePath.includes('/api/remote/devices/smoke-device/thumbnail?'));
     assert.ok(!('dataUrl' in serializedBinaryThumbnail));
     assert.ok(!('payload' in serializedBinaryThumbnail));
@@ -242,10 +246,14 @@ try {
     assert.equal(binaryLiveDevice.latestLiveFrame.streamId, 'smoke-live');
     assert.equal(binaryLiveDevice.latestLiveFrame.transport, 'binary');
     assert.equal(binaryLiveDevice.latestLiveFrame.byteLength, smokePngFrame.length);
+    assert.equal(typeof binaryLiveDevice.latestLiveFrame.contentHash, 'string');
+    assert.equal(binaryLiveDevice.latestLiveFrame.contentHash.length, 16);
+    assert.equal(binaryLiveDevice.latestLiveFrame.sameContentStreak, 1);
     assert.equal(binaryLiveDevice.counters.liveFramesReceived, 2);
     const serializedBinaryLiveFrame = hub.getDeviceLiveFrame('smoke-device', { includeDataUrl: false });
     assert.equal(serializedBinaryLiveFrame.streamId, 'smoke-live');
     assert.equal(serializedBinaryLiveFrame.frameSeq, 5);
+    assert.equal(serializedBinaryLiveFrame.contentHash, binaryLiveDevice.latestLiveFrame.contentHash);
     assert.ok(serializedBinaryLiveFrame.framePath.includes('/api/remote/devices/smoke-device/live/frame?'));
     assert.ok(!('dataUrl' in serializedBinaryLiveFrame));
     assert.ok(!('payload' in serializedBinaryLiveFrame));