@mindexec/cli 0.2.20 → 0.2.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindexec/cli",
-  "version": "0.2.20",
+  "version": "0.2.21",
   "description": "MindExec local runtime and bridge CLI",
   "main": "server.js",
   "type": "module",
@@ -20,10 +20,11 @@
   "scripts": {
     "start": "node launch-bridge.cjs",
     "dev": "node launch-bridge.cjs --watch",
-    "test:syntax": "node --check server.js && node --check remote-hub.js && node --check codex-runtime.js && node --check launch-bridge.cjs && node --check port-guard.cjs && node --check scripts/setup-tree-sitter-grammars.mjs && node --check scripts/remote-hub-smoke.mjs && node --check scripts/remote-hub-scale-smoke.mjs && node --check scripts/remote-fleet-render-smoke.mjs",
-    "test:remote": "node scripts/remote-hub-smoke.mjs",
-    "test:remote:scale": "node scripts/remote-hub-scale-smoke.mjs",
-    "test:remote:render": "node scripts/remote-fleet-render-smoke.mjs",
+    "test:syntax": "node --check server.js && node --check remote-hub.js && node --check codex-runtime.js && node --check launch-bridge.cjs && node --check port-guard.cjs && node --check scripts/setup-tree-sitter-grammars.mjs && node --check scripts/remote-hub-smoke.mjs && node --check scripts/remote-hub-scale-smoke.mjs && node --check scripts/remote-fleet-render-smoke.mjs && node --check scripts/remote-http-smoke.mjs",
+    "test:remote": "node scripts/remote-hub-smoke.mjs",
+    "test:remote:scale": "node scripts/remote-hub-scale-smoke.mjs",
+    "test:remote:render": "node scripts/remote-fleet-render-smoke.mjs",
+    "test:remote:http": "node scripts/remote-http-smoke.mjs",
     "pack:dry": "npm pack --dry-run",
     "setup:grammars": "node scripts/setup-tree-sitter-grammars.mjs",
     "postinstall": "npm run setup:grammars"

package/scripts/remote-http-smoke.mjs

@@ -0,0 +1,267 @@
+#!/usr/bin/env node
+
+import assert from 'node:assert/strict';
+import net from 'node:net';
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const BRIDGE_TOKEN = 'remote-http-smoke-token';
+const PAIR_TOKEN = 'remote-http-pair-token';
+const SYNTHETIC_COUNT = Number(process.env.REMOTE_HTTP_SMOKE_COUNT || 250);
+
+function wait(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+async function findFreePort() {
+    return await new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.unref();
+        server.once('error', reject);
+        server.listen(0, '127.0.0.1', () => {
+            const address = server.address();
+            const port = typeof address === 'object' && address ? address.port : 0;
+            server.close(() => resolve(port));
+        });
+    });
+}
+
+async function fetchJson(url, options = {}) {
+    const response = await fetch(url, {
+        ...options,
+        headers: {
+            ...(options.body ? { 'Content-Type': 'application/json' } : {}),
+            ...(options.token ? { 'X-Bridge-Token': options.token } : {}),
+            ...(options.headers || {})
+        }
+    });
+
+    let payload = null;
+    try {
+        payload = await response.json();
+    } catch {
+        // Some failure responses may be empty.
+    }
+
+    return {
+        status: response.status,
+        ok: response.ok,
+        payload
+    };
+}
+
+async function waitForBridge(baseUrl, getFailureDetails) {
+    const startedAt = Date.now();
+    while (Date.now() - startedAt < 30000) {
+        try {
+            const result = await fetchJson(`${baseUrl}/api/remote/status`, { token: BRIDGE_TOKEN });
+            if (result.ok && result.payload?.started === true) {
+                return result.payload;
+            }
+        } catch {
+            // Server is still starting.
+        }
+        await wait(100);
+    }
+
+    throw new Error(`Timed out waiting for LocalBridge RemoteHub HTTP API.\n${getFailureDetails()}`);
+}
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const bridgeRoot = path.resolve(__dirname, '..');
+const bridgePort = await findFreePort();
+const remoteHubPort = await findFreePort();
+const baseUrl = `http://127.0.0.1:${bridgePort}`;
+
+const child = spawn(process.execPath, ['server.js'], {
+    cwd: bridgeRoot,
+    stdio: ['ignore', 'pipe', 'pipe'],
+    windowsHide: true,
+    env: {
+        ...process.env,
+        BRIDGE_PORT: String(bridgePort),
+        BRIDGE_TOKEN,
+        BRIDGE_REQUIRE_TOKEN: '1',
+        MINDEXEC_REMOTE_HUB: '1',
+        REMOTE_HUB_HOST: '127.0.0.1',
+        REMOTE_HUB_PORT: String(remoteHubPort),
+        REMOTE_HUB_PAIR_TOKEN: PAIR_TOKEN,
+        MINDEXEC_REMOTE_SYNTHETIC_FLEET: '1',
+        NO_COLOR: '1'
+    }
+});
+
+let stdout = '';
+let stderr = '';
+child.stdout.on('data', chunk => {
+    stdout += chunk.toString();
+});
+child.stderr.on('data', chunk => {
+    stderr += chunk.toString();
+});
+
+const exitPromise = new Promise(resolve => child.once('exit', resolve));
+const details = () => `stdout=${stdout}\nstderr=${stderr}`;
+
+try {
+    const status = await waitForBridge(baseUrl, details);
+    assert.equal(status.started, true);
+    assert.equal(status.port, remoteHubPort);
+    assert.equal(status.agentPackage, '@mindexec/remote');
+    assert.equal(status.canvasPagination, 'none');
+    assert.equal(status.canvasDeviceListMode, 'all-devices');
+    assert.equal(status.pairToken, PAIR_TOKEN);
+
+    const unauthorizedStatus = await fetchJson(`${baseUrl}/api/remote/status`);
+    assert.equal(unauthorizedStatus.status, 401);
+    assert.equal(unauthorizedStatus.payload?.header, 'X-Bridge-Token');
+
+    const unauthorizedDelete = await fetchJson(`${baseUrl}/api/remote/synthetic`, {
+        method: 'DELETE'
+    });
+    assert.equal(unauthorizedDelete.status, 401);
+
+    const seed = await fetchJson(`${baseUrl}/api/remote/synthetic/seed`, {
+        method: 'POST',
+        token: BRIDGE_TOKEN,
+        body: JSON.stringify({
+            count: SYNTHETIC_COUNT,
+            connectedRatio: 0.84,
+            thumbnailRatio: 0.72,
+            aiAssistRatio: 0.42,
+            liveCount: 8,
+            replace: true
+        })
+    });
+    assert.equal(seed.ok, true, JSON.stringify(seed.payload));
+    assert.equal(seed.payload?.ok, true);
+    assert.equal(seed.payload?.seeded, SYNTHETIC_COUNT);
+
+    const devicesResult = await fetchJson(`${baseUrl}/api/remote/devices`, { token: BRIDGE_TOKEN });
+    assert.equal(devicesResult.ok, true, JSON.stringify(devicesResult.payload));
+    assert.equal(devicesResult.payload?.total, SYNTHETIC_COUNT);
+    assert.equal(devicesResult.payload?.pagination, 'none');
+    assert.equal(devicesResult.payload?.canvasDeviceListMode, 'all-devices');
+    assert.equal(devicesResult.payload?.devices?.length, SYNTHETIC_COUNT);
+    assert.equal(devicesResult.payload.devices.some(device => device.connected === false), true);
+
+    const connectedTargets = devicesResult.payload.devices
+        .filter(device => device.connected && device.capabilities?.taskDispatch)
+        .slice(0, 200)
+        .map(device => device.deviceId);
+    assert.ok(connectedTargets.length >= 100);
+
+    const batch = await fetchJson(`${baseUrl}/api/remote/tasks`, {
+        method: 'POST',
+        token: BRIDGE_TOKEN,
+        body: JSON.stringify({
+            deviceIds: connectedTargets,
+            allConnected: false,
+            title: 'HTTP smoke task batch',
+            instruction: 'HTTP smoke batch: report current status to the manager.',
+            approvalLevel: 'task-only'
+        })
+    });
+    assert.equal(batch.ok, true, JSON.stringify(batch.payload));
+    assert.equal(batch.payload?.ok, true);
+    assert.equal(batch.payload?.total, connectedTargets.length);
+    assert.equal(batch.payload?.queued, connectedTargets.length);
+    assert.equal(batch.payload?.batch?.completed, connectedTargets.length);
+    assert.equal(batch.payload?.batch?.failed, 0);
+    assert.equal(batch.payload?.batch?.status, 'completed');
+
+    const aiTarget = devicesResult.payload.devices.find(device =>
+        device.connected && device.capabilities?.taskDispatch && device.capabilities?.aiAssist);
+    assert.ok(aiTarget);
+    const aiTask = await fetchJson(`${baseUrl}/api/remote/devices/${encodeURIComponent(aiTarget.deviceId)}/tasks`, {
+        method: 'POST',
+        token: BRIDGE_TOKEN,
+        body: JSON.stringify({
+            title: 'HTTP smoke AI task',
+            instruction: 'HTTP smoke AI assist: summarize fleet condition.',
+            approvalLevel: 'ai-assist'
+        })
+    });
+    assert.equal(aiTask.ok, true, JSON.stringify(aiTask.payload));
+    assert.equal(aiTask.payload?.ok, true);
+    assert.equal(aiTask.payload?.approvalLevel, 'ai-assist');
+
+    const thumbnailTarget = devicesResult.payload.devices.find(device =>
+        device.connected && device.capabilities?.thumbnail);
+    assert.ok(thumbnailTarget);
+    const thumbnailRequest = await fetchJson(`${baseUrl}/api/remote/devices/${encodeURIComponent(thumbnailTarget.deviceId)}/thumbnail/request`, {
+        method: 'POST',
+        token: BRIDGE_TOKEN,
+        body: JSON.stringify({
+            streamId: 'http-smoke-thumb',
+            maxWidth: 360,
+            maxHeight: 220,
+            quality: 50
+        })
+    });
+    assert.equal(thumbnailRequest.ok, true, JSON.stringify(thumbnailRequest.payload));
+    assert.equal(thumbnailRequest.payload?.ok, true);
+
+    const thumbnail = await fetchJson(`${baseUrl}/api/remote/devices/${encodeURIComponent(thumbnailTarget.deviceId)}/thumbnail`, {
+        token: BRIDGE_TOKEN
+    });
+    assert.equal(thumbnail.ok, true, JSON.stringify(thumbnail.payload));
+    assert.equal(thumbnail.payload?.thumbnail?.streamId, 'http-smoke-thumb');
+    assert.ok(String(thumbnail.payload?.thumbnail?.dataUrl || '').startsWith('data:image/png;base64,'));
+
+    const liveTarget = devicesResult.payload.devices.find(device =>
+        device.connected && device.capabilities?.liveStream);
+    assert.ok(liveTarget);
+    const liveStart = await fetchJson(`${baseUrl}/api/remote/devices/${encodeURIComponent(liveTarget.deviceId)}/live/start`, {
+        method: 'POST',
+        token: BRIDGE_TOKEN,
+        body: JSON.stringify({
+            streamId: 'http-smoke-live',
+            fps: 12,
+            maxWidth: 960,
+            maxHeight: 540,
+            quality: 60
+        })
+    });
+    assert.equal(liveStart.ok, true, JSON.stringify(liveStart.payload));
+    assert.equal(liveStart.payload?.ok, true);
+
+    const liveFrame = await fetchJson(`${baseUrl}/api/remote/devices/${encodeURIComponent(liveTarget.deviceId)}/live/frame`, {
+        token: BRIDGE_TOKEN
+    });
+    assert.equal(liveFrame.ok, true, JSON.stringify(liveFrame.payload));
+    assert.equal(liveFrame.payload?.frame?.streamId, 'http-smoke-live');
+    assert.equal(liveFrame.payload?.frame?.mode, 'remote-fast');
+
+    const liveStop = await fetchJson(`${baseUrl}/api/remote/devices/${encodeURIComponent(liveTarget.deviceId)}/live/stop`, {
+        method: 'POST',
+        token: BRIDGE_TOKEN,
+        body: JSON.stringify({
+            streamId: 'http-smoke-live'
+        })
+    });
+    assert.equal(liveStop.ok, true, JSON.stringify(liveStop.payload));
+    assert.equal(liveStop.payload?.ok, true);
+
+    const clear = await fetchJson(`${baseUrl}/api/remote/synthetic`, {
+        method: 'DELETE',
+        token: BRIDGE_TOKEN
+    });
+    assert.equal(clear.ok, true, JSON.stringify(clear.payload));
+    assert.equal(clear.payload?.ok, true);
+    assert.equal(clear.payload?.removed, SYNTHETIC_COUNT);
+
+    console.log(`RemoteHub HTTP smoke OK (${SYNTHETIC_COUNT} synthetic devices, bridge ${bridgePort}, remote ${remoteHubPort})`);
+} finally {
+    if (child.exitCode === null && !child.killed) {
+        child.kill('SIGTERM');
+        await Promise.race([
+            exitPromise,
+            wait(5000)
+        ]);
+        if (child.exitCode === null && !child.killed) {
+            child.kill('SIGKILL');
+        }
+    }
+}

package/server.js

@@ -1750,6 +1750,7 @@ const PROTECTED_BRIDGE_ROUTES = [
     { method: 'POST', prefix: '/api/shell/' },
     { method: 'GET', prefix: '/api/remote/' },
     { method: 'POST', prefix: '/api/remote/' },
+    { method: 'DELETE', prefix: '/api/remote/' },
     { method: 'POST', prefix: '/project/' },
     { method: 'POST', exact: '/agent/connect' },
     { method: 'POST', exact: '/api/tool/trace' }