ai-remote 0.4.17 → 0.5.0

package/README.md

@@ -91,10 +91,10 @@ Silencing them is a choice made where the command is run:
 npx --silent ai-remote list           # this invocation only
 NPM_CONFIG_LOGLEVEL=error npx ...     # this shell only
 npm config set loglevel error         # this machine, all npm commands
-npm install -g ai-remote              # no npm in the path at all; use `remotectl`
+npm install -g ai-remote              # no npm in the path at all; use `ai-remote`
 ```
 
-The last one also skips the 300 ms: `remotectl list` answers in about 27 ms. It
+The last one also skips the 300 ms: `ai-remote list` answers in about 27 ms. It
 is a per-machine decision rather than something the package can carry, which is
 why `npx` is still what the examples here use.
 
@@ -439,8 +439,8 @@ where a decrypted key belongs, and it is offered from there.
 - `--max-edge N`: Shrink a screenshot to fit N.
 - `--json`: Output machine-readable JSON results on stdout.
 
-The password, where one is wanted, comes from `AI_REMOTE_PASSWORD` (or
-`REMOTECTL_PASSWORD`). There is no `--password` flag: a command line is visible
+The password, where one is wanted, comes from `AI_REMOTE_PASSWORD`. There is no
+`--password` flag: a command line is visible
 to every process on the machine.
 
 ---

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ai-remote
-description: Drive a remote Windows, Linux or macOS desktop from the command line with `npx ai-remote` (also installed as `remotectl`) — open one session, then screenshot it, click, type, press keys, run shell commands over SSH, and watch it in a window. Use this skill whenever the user wants to control, inspect, automate or screenshot a machine over RDP/VNC/SSH — including when they never name the tool and just say "click the button on that Windows box", "what's on the screen of 192.168.x.x", "log into the VM and run this", or "take a screenshot of the remote desktop".
+description: Drive a remote Windows, Linux or macOS desktop from the command line with `npx ai-remote` — open one session, then screenshot it, click, type, press keys, run shell commands over SSH, and watch it in a window. Use this skill whenever the user wants to control, inspect, automate or screenshot a machine over RDP/VNC/SSH — including when they never name the tool and just say "click the button on that Windows box", "what's on the screen of 192.168.x.x", "log into the VM and run this", or "take a screenshot of the remote desktop".
 ---
 
 # Driving a remote desktop with ai-remote
@@ -286,8 +286,7 @@ agent.
 A desktop always wants one; a terminal usually does not, because of the keys
 above. Three places are tried, in this order:
 
-1. `AI_REMOTE_PASSWORD` in this shell, or `REMOTECTL_PASSWORD` under the other
-   name.
+1. `AI_REMOTE_PASSWORD` in this shell.
 2. Whatever `--save` kept for that machine.
 3. You, at the terminal — only when one is attached, and only after the first
    two have come up empty.
@@ -453,19 +452,18 @@ Every command takes `--session NAME` to pick between open sessions, and `--json`
 for machine-readable output. `ai-remote --help` is the authority; this file is
 the map.
 
-## Working inside this repository
+## Working with the installed package
 
-This repo *is* ai-remote. When testing a change, drive the local build rather
-than the published package, or you will be exercising the last release instead
-of your edit:
+The published package does not include its TypeScript source tree. The CLI and
+its internal modules are bundled into `dist`, so paths such as
+`packages/core/src/cli/cli.ts` will not exist in an installed copy. Use the
+public command when driving a machine:
 
 ```bash
-node packages/core/scripts/build.mjs        # after editing packages/core/src/cli/*
-node packages/core/dist/cli.mjs open HOST -u USER --headless
+npx ai-remote open HOST -u USER --headless
 ```
 
-The CLI's own source is [`packages/core/src/cli/`](src/cli/):
-`cli.ts` is the grammar, `sessions.ts` decides which session a command drives,
-`daemon.ts` is the process that holds the connection, `copy.ts` is `cp` over the
-SFTP client in [`protocols/ssh/sftp.ts`](src/protocols/ssh/sftp.ts), and
-`viewer.ts` plus `window.ts` are the window. `pnpm test` covers them.
+Do not edit or import files under `dist`; they are generated implementation
+artifacts, not public entry points. To change ai-remote itself, work from a
+source checkout, rebuild the package there, and test the generated CLI before
+publishing a new version.

package/dist/{cli-chunk-DGHEB4P5.mjs → cli-chunk-F2TSY3YW.mjs}

@@ -3,7 +3,7 @@ import {
   VERSION,
   isTitlebarDragPoint,
   logicalDisplaySize
-} from "./cli-chunk-ZQ32C4LC.mjs";
+} from "./cli-chunk-OZG2CODR.mjs";
 
 // src/cli/window.ts
 import { spawn } from "node:child_process";
@@ -412,6 +412,29 @@ async function runWindow(argv) {
   } catch {
   }
   const webview = window.createWebview({ url, enableDevtools: false });
+  const SETTLE_MS = 400;
+  let reportedFullscreen = null;
+  let seen = null;
+  let seenSince = 0;
+  let publishing = !flags.fullscreen;
+  function publishFullscreen(force = false) {
+    if (!publishing) return;
+    const on = window.fullscreen !== null;
+    const now = Date.now();
+    if (on !== seen) {
+      seen = on;
+      seenSince = now;
+    }
+    if (!force && (on === reportedFullscreen || now - seenSince < SETTLE_MS)) return;
+    reportedFullscreen = on;
+    try {
+      webview.evaluateScript(`window.aiRemoteFullscreen && window.aiRemoteFullscreen(${on})`);
+    } catch {
+    }
+  }
+  window.on("resize", () => publishFullscreen());
+  webview.on("page-load-finished", () => publishFullscreen(true));
+  setInterval(() => publishFullscreen(), 150).unref();
   const debugDrag = process.env.AI_REMOTE_DEBUG_DRAG === "1";
   let pageDrag = null;
   let dragPointer = null;
@@ -427,6 +450,14 @@ async function runWindow(argv) {
       pageDrag = null;
       return;
     }
+    if (note.t === "fullscreen") {
+      try {
+        window.setFullscreen(window.fullscreen !== null ? void 0 : FullscreenType.Borderless);
+      } catch {
+      }
+      publishFullscreen();
+      return;
+    }
     if (typeof note.x !== "number" || typeof note.y !== "number") return;
     if (note.t === "drag-start") {
       if (window.fullscreen !== null) return;
@@ -468,6 +499,7 @@ async function runWindow(argv) {
         window.setFullscreen(FullscreenType.Borderless);
       } catch {
       }
+      publishing = true;
     }, 400);
   }
   await application.whenReady({ interval: 33 });

package/dist/{cli-chunk-ZQ32C4LC.mjs → cli-chunk-OZG2CODR.mjs}

@@ -1,5 +1,5 @@
 // src/cli/generated/version.ts
-var VERSION = "0.4.17";
+var VERSION = "0.5.0";
 
 // src/cli/viewer-layout.ts
 var TERMINAL_COLUMNS = 80;