ai-remote 0.3.1 → 0.4.0

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "ai-remote",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "RDP, VNC and SSH protocol engines that run in Node, a Worker or a browser -- plus `npx ai-remote`, a CLI that drives a machine and shows you what it is doing",
   "type": "module",
   "bin": {
-    "ai-remote": "./dist/cli.mjs",
-    "remotectl": "./dist/cli.mjs"
+    "ai-remote": "dist/cli.mjs",
+    "remotectl": "dist/cli.mjs"
   },
   "license": "MIT",
   "author": {
@@ -15,7 +15,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/guocity/vnc-node-worker.git"
+    "url": "git+https://github.com/guocity/vnc-node-worker.git"
   },
   "keywords": [
     "remote-desktop",
@@ -88,5 +88,8 @@
   },
   "engines": {
     "node": ">=22"
+  },
+  "optionalDependencies": {
+    "@webviewjs/webview": "^0.4.3"
   }
 }

package/src/cli/cli.ts

@@ -12,6 +12,7 @@ import { spawn } from 'node:child_process';
 import { readFileSync, readdirSync, existsSync, openSync, unlinkSync } from 'node:fs';
 import { bareUsername, Shell } from './shell';
 import { runDaemon } from './daemon';
+import { runWindow } from './window';
 import { request } from './ipc';
 import { ensureRunDir, logPath, metaPath, RUN_DIR, sessionName, socketPath } from './paths';
 
@@ -187,6 +188,8 @@ async function startSession(args: Args, name: string, host: string, port: number
   ];
   if (has(args, 'no-view', 'headless')) daemonArgs.push('--no-view');
   if (has(args, 'no-open')) daemonArgs.push('--no-open');
+  if (has(args, 'tab')) daemonArgs.push('--tab');
+  if (has(args, 'fullscreen')) daemonArgs.push('--fullscreen');
 
   // Its output goes to a file rather than nowhere: a session that fails to
   // start is the one moment its log is worth having.
@@ -274,6 +277,8 @@ async function main(): Promise<void> {
       viewPort: Number(flag(args, 'view-port') ?? 7373),
       sshUsername: flag(args, 'ssh-user') ?? flag(args, 'u', 'user') ?? '',
       sshPort: Number(flag(args, 'ssh-port') ?? 22),
+      tab: has(args, 'tab'),
+      fullscreen: has(args, 'fullscreen'),
       // Zero by default: a session stays open until it is closed. An agent
       // that pauses to think is not an agent that has finished.
       idleMs: Math.max(0, Number(flag(args, 'idle') ?? 0)) * 60_000,
@@ -281,6 +286,9 @@ async function main(): Promise<void> {
     return;
   }
 
+  // The hidden command the native window runs as.
+  if (args.command === '__window') { await runWindow(process.argv.slice(3)); return; }
+
   if (args.command === 'shell') { await interactiveShell(args, host); return; }
 
   // Everything else runs against a session: the one already open, or a new one.
@@ -297,7 +305,7 @@ async function main(): Promise<void> {
       if (!has(args, 'no-view', 'headless') && !status.viewer) {
         Object.assign(status, await ask(name, 'view-open', { launch: !has(args, 'no-open') }));
       }
-      Object.assign(report, { viewer: status.viewer });
+      Object.assign(report, { viewer: status.viewer, window: status.window, viewers: status.viewers });
       break;
 
     case 'view': {
@@ -424,8 +432,10 @@ function describe(command: string, report: Record<string, unknown>): string {
   const where = report.reused ? 'the open session' : 'a new session';
 
   if (command === 'open') {
-    return `${report.reused ? 'Already connected' : 'Connected'} to ${report.host}:${report.port} at ${size}.`
-      + `${report.viewer ? `\nWindow: ${report.viewer}` : ''}`
+    const window = report.window === 'window' ? 'A window is open on it.'
+      : report.window === 'tab' ? 'It opened in your browser.'
+      : report.viewer ? `Open it at ${report.viewer}` : 'No window (headless).';
+    return `${report.reused ? 'Already connected' : 'Connected'} to ${report.host}:${report.port} at ${size}. ${window}`
       + `\nRun more commands against it, then \`${NAME} close ${report.host}\` when you are done.`;
   }
   if (command === 'view') {

package/src/cli/daemon.ts

@@ -26,6 +26,10 @@ export interface DaemonOptions extends SessionOptions {
   viewPort: number;
   /** Account for the terminal, when one is wanted. Blank leaves SSH unopened. */
   sshUsername: string;
+  /** Open in the default browser rather than a window of its own. */
+  tab: boolean;
+  /** Start the window already filling the display. */
+  fullscreen: boolean;
   sshPort: number;
   idleMs: number;
 }
@@ -104,7 +108,12 @@ export async function runDaemon(options: DaemonOptions): Promise<void> {
       if (launch) viewer.launch();
       return viewer;
     }
-    viewer = await startViewer(session, options.viewPort, { launch, openShell });
+    viewer = await startViewer(session, options.viewPort, {
+      launch,
+      openShell,
+      tab: options.tab,
+      fullscreen: options.fullscreen,
+    });
     writeMeta();
     return viewer;
   }
@@ -147,7 +156,7 @@ export async function runDaemon(options: DaemonOptions): Promise<void> {
     switch (message.op) {
       case 'view-open': {
         const opened = await openViewer(args.launch !== false);
-        return { viewer: opened.url };
+        return { viewer: opened.url, window: opened.window?.kind ?? null };
       }
 
       case 'view-close':
@@ -162,6 +171,8 @@ export async function runDaemon(options: DaemonOptions): Promise<void> {
           height: session.framebuffer.height,
           connected: session.connected,
           viewer: viewer?.url ?? null,
+          window: viewer?.window?.kind ?? null,
+          viewers: viewer?.viewers ?? 0,
           shell: shell ? 'open' : shellStarting ? 'opening' : 'closed',
           pid: process.pid,
         };