@livedesk/client 0.1.0

package/README.md

@@ -0,0 +1,36 @@
+# LiveDesk Client
+
+Run a direct LiveDesk remote client from a controlled computer.
+
+```powershell
+npx @livedesk/client connect --manager 127.0.0.1:5197 --pair <token>
+```
+
+For LAN use, start `@livedesk/hub` with an externally reachable RemoteHub host
+and point clients at that address:
+
+```powershell
+$env:REMOTE_HUB_HOST="0.0.0.0"
+$env:REMOTE_HUB_PORT="5197"
+npm run dev:hub
+
+npx @livedesk/client connect --manager 192.168.0.10:5197 --pair <strong-token>
+```
+
+The client registers the device, sends status heartbeats, can return
+manager-requested thumbnails, can stream a focused view-only live screen, and
+can receive safe task-only instructions.
+
+By default, the launcher uses the packaged C# RemoteFast engine when supported.
+It falls back to the Node engine for AI assist or when a compatible .NET runtime
+is unavailable.
+
+Useful flags:
+
+```powershell
+npx @livedesk/client connect --manager 127.0.0.1:5197 --pair <token> --no-thumbnail
+npx @livedesk/client connect --manager 127.0.0.1:5197 --pair <token> --no-live
+npx @livedesk/client connect --manager 127.0.0.1:5197 --pair <token> --engine node
+npx @livedesk/client connect --manager 127.0.0.1:5197 --pair <token> --engine fast
+npx @livedesk/client connect --manager 127.0.0.1:5197 --pair <token> --engine fast --trace-frames
+```

package/bin/livedesk-client-fast.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawn } from 'node:child_process';
+
+const launcherPath = join(dirname(fileURLToPath(import.meta.url)), 'livedesk-client.js');
+const child = spawn(process.execPath, [launcherPath, '--fast', ...process.argv.slice(2)], {
+    stdio: 'inherit',
+    windowsHide: true
+});
+
+child.once('error', error => {
+    console.error(`Failed to launch C# RemoteFast: ${error.message}`);
+    process.exitCode = 1;
+});
+child.once('exit', (code, signal) => {
+    if (signal) {
+        process.kill(process.pid, signal);
+        return;
+    }
+    process.exit(code ?? 0);
+});