sliccy 6.167.0 → 6.169.0

package/dist/node-server/computer-demo.js

@@ -0,0 +1,126 @@
+/**
+ * Reference HTTP computer behind `--computer-demo`. Implements the
+ * phase-3 URL contract so `computer add url http://127.0.0.1:<port>` and
+ * the fake-LLM e2e can drive a real remote without a third-party host.
+ *
+ *   GET  /computer
+ *   GET  /computer/screenshot?maxWidth=&format=
+ *   GET  /computer/text
+ *   POST /computer/input
+ *   WS   /computer/frames?fps=4   (optional; HTTP poll still works)
+ */
+import { WebSocketServer } from 'ws';
+/** 1×1 SOF0 JPEG — enough for protocol tests; not a displayable photo. */
+export const COMPUTER_DEMO_JPEG = Uint8Array.of(0xff, 0xd8, 0xff, 0xc0, 0x00, 0x0b, 0x08, 0x00, 0x01, 0x00, 0x01, 0x01, 0x01, 0x11, 0x00, 0xff, 0xd9);
+export class ComputerDemoState {
+    seq = 0;
+    events = [];
+    descriptor() {
+        return {
+            id: 'url:demo',
+            kind: 'url',
+            title: 'computer-demo',
+            size: { width: 1, height: 1 },
+            state: 'live',
+            capabilities: {
+                screenshot: true,
+                text: true,
+                frames: 'poll',
+                keyboard: true,
+                mouse: 'absolute',
+                scroll: true,
+                exec: false,
+                inputAllowed: true,
+            },
+            pid: null,
+        };
+    }
+    screenshot() {
+        this.seq += 1;
+        return {
+            bytes: COMPUTER_DEMO_JPEG,
+            mime: 'image/jpeg',
+            width: 1,
+            height: 1,
+            seq: this.seq,
+        };
+    }
+    text() {
+        if (this.events.length === 0)
+            return 'demo\n';
+        return `${this.events.map((event) => event.type).join('\n')}\n`;
+    }
+    input(events) {
+        this.events.push(...events);
+    }
+}
+function isInputEvent(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    if (!('type' in value) || typeof value.type !== 'string')
+        return false;
+    return (value.type === 'mousemove' ||
+        value.type === 'button' ||
+        value.type === 'click' ||
+        value.type === 'scroll' ||
+        value.type === 'drag' ||
+        value.type === 'key' ||
+        value.type === 'text' ||
+        value.type === 'wait');
+}
+export function registerComputerDemoRoutes(app, state) {
+    app.get('/computer', (_req, res) => {
+        res.json(state.descriptor());
+    });
+    app.get('/computer/screenshot', (_req, res) => {
+        const shot = state.screenshot();
+        res.set('Content-Type', shot.mime);
+        res.set('Cache-Control', 'no-store');
+        res.send(Buffer.from(shot.bytes));
+    });
+    app.get('/computer/text', (_req, res) => {
+        res.type('text/plain').send(state.text());
+    });
+    app.post('/computer/input', (req, res) => {
+        if (!Array.isArray(req.body)) {
+            res.status(400).json({ error: 'expected ComputerInputEvent[]' });
+            return;
+        }
+        const events = [];
+        for (const item of req.body) {
+            if (!isInputEvent(item)) {
+                res.status(400).json({ error: 'invalid ComputerInputEvent' });
+                return;
+            }
+            events.push(item);
+        }
+        state.input(events);
+        res.json({ ok: true, count: events.length });
+    });
+}
+export function createComputerDemoFrameServer(state) {
+    const wss = new WebSocketServer({ noServer: true });
+    wss.on('connection', (ws, request) => {
+        const url = new URL(request.url ?? '/', 'http://computer-demo.local');
+        const fps = Math.min(8, Math.max(1, Number(url.searchParams.get('fps')) || 4));
+        const tick = () => {
+            if (ws.readyState !== ws.OPEN)
+                return;
+            const shot = state.screenshot();
+            ws.send(shot.bytes);
+        };
+        tick();
+        const timer = setInterval(tick, Math.round(1000 / fps));
+        ws.on('close', () => clearInterval(timer));
+    });
+    return wss;
+}
+/** True when this upgrade was the demo frames socket. */
+export function handleComputerDemoUpgrade(pathname, request, socket, head, wss) {
+    if (pathname !== '/computer/frames')
+        return false;
+    wss.handleUpgrade(request, socket, head, (ws) => {
+        wss.emit('connection', ws, request);
+    });
+    return true;
+}

package/dist/node-server/index.js

@@ -27,6 +27,7 @@ import { FileRegistry } from './cloud/registry-file.js';
 import { runResume } from './cloud/resume.js';
 import { runStart } from './cloud/start.js';
 import { registerCloudStatusEndpoint } from './cloud-status.js';
+import { ComputerDemoState, createComputerDemoFrameServer, handleComputerDemoUpgrade, registerComputerDemoRoutes, } from './computer-demo.js';
 import { ElectronAppAlreadyRunningError, ElectronOverlayInjector, launchElectronApp, resolveOverlayThinBridge, } from './electron-controller.js';
 import { getElectronAppPorts } from './electron-runtime.js';
 import { ElectronTrayFollower } from './electron-tray-follower.js';
@@ -580,9 +581,11 @@ function rejectUpgradeUnauthorized(socket, reason) {
  * `Sec-WebSocket-Protocol` token = socket destroyed before
  * `wss.emit('connection', ...)` ever fires. Legacy modes (dev / electron /
  * serve-only / hosted) pass `null` to keep same-origin behavior unchanged.
- * `/licks-ws` is loopback-only and stays ungated.
+ * `/licks-ws` is loopback-only and stays ungated. When `--computer-demo` is
+ * on, `/computer/frames` is the optional push socket for the URL adapter
+ * reference server (HTTP poll still works without the upgrade).
  */
-function attachCdpUpgradeRouting(server, wss, lickWss, bridgeToken) {
+function attachCdpUpgradeRouting(server, wss, lickWss, bridgeToken, computerDemoWss = null) {
     server.on('upgrade', (request, socket, head) => {
         const { pathname } = new URL(request.url, `http://${request.headers.host}`);
         if (pathname === '/cdp') {
@@ -607,6 +610,9 @@ function attachCdpUpgradeRouting(server, wss, lickWss, bridgeToken) {
                 lickWss.emit('connection', ws, request);
             });
         }
+        else if (computerDemoWss) {
+            handleComputerDemoUpgrade(pathname, request, socket, head, computerDemoWss);
+        }
     });
 }
 /**
@@ -1256,6 +1262,9 @@ async function main() {
     // trusted process so the in-browser agent can request, but never fabricate,
     // an approval. Loopback-only; selects a backend by environment at call time.
     registerSudoApproveEndpoint(app);
+    const computerDemo = RUNTIME_FLAGS.computerDemo ? new ComputerDemoState() : null;
+    if (computerDemo)
+        registerComputerDemoRoutes(app, computerDemo);
     // Fetch proxy — forwards cross-origin requests from the browser to bypass CORS,
     // injecting/unmasking secrets and streaming the response with a UTF-8-safe scrub.
     registerFetchProxyRoute(app, { secretProxy });
@@ -1267,7 +1276,8 @@ async function main() {
     // 4. CDP WebSocket proxy at /cdp — noServer mode so we own the upgrade
     //    handler routing for /cdp and /licks-ws.
     const wss = createCdpWebSocketServer(state.bridgeToken);
-    attachCdpUpgradeRouting(server, wss, lickWss, state.bridgeToken);
+    const computerDemoWss = computerDemo ? createComputerDemoFrameServer(computerDemo) : null;
+    attachCdpUpgradeRouting(server, wss, lickWss, state.bridgeToken, computerDemoWss);
     const cdpCtx = {
         wss,
         secretProxy,

package/dist/node-server/runtime-flags.d.ts

@@ -24,6 +24,8 @@ export interface CliRuntimeFlags {
     installCli: boolean;
     /** Target directory for --install-cli (default: OS-idiomatic, see install-cli.ts) */
     installDir: string | null;
+    /** Mount GET/POST `/computer` + optional WS `/computer/frames` (URL adapter reference). */
+    computerDemo: boolean;
     /**
      * Mount table: OS-folder → SLICC-target mappings served over the local
      * host-FS bridge (`/api/hostfs`) and auto-mounted by the webapp at boot,

package/dist/node-server/runtime-flags.js

@@ -92,6 +92,7 @@ function createDefaultFlags() {
         hosted: false,
         installCli: false,
         installDir: null,
+        computerDemo: false,
         mounts: [],
     };
 }
@@ -122,6 +123,10 @@ function applySimpleFlag(flags, arg) {
         flags.installCli = true;
         return true;
     }
+    if (arg === '--computer-demo') {
+        flags.computerDemo = true;
+        return true;
+    }
     return false;
 }
 /** `--flag=value` style flags that consume no following token. Returns whether handled. */