ai-remote 0.5.1 → 0.6.0

package/dist/cli-known-hosts-UU427T4N.mjs

@@ -0,0 +1,12 @@
+import {
+  checkHostKey,
+  forgetHostKey,
+  hostAddress,
+  knownHosts
+} from "./cli-chunk-WWORJ2NE.mjs";
+export {
+  checkHostKey,
+  forgetHostKey,
+  hostAddress,
+  knownHosts
+};

package/dist/{cli-secrets-26D3F6EN.mjs → cli-secrets-BMYFPDB2.mjs}

@@ -198,7 +198,7 @@ function savedSecrets() {
       if (!seen.has(entry.key)) seen.set(entry.key, entry);
     }
   }
-  return [...seen.values()].map(({ key, backend, savedAt }) => ({ key, backend, savedAt })).sort((a, b) => a.key < b.key ? -1 : a.key > b.key ? 1 : 0);
+  return [...seen.values()].map(({ key, backend, savedAt }) => ({ key, backend, savedAt })).toSorted((a, b) => a.key < b.key ? -1 : a.key > b.key ? 1 : 0);
 }
 async function forgetAll() {
   const keys = savedSecrets().map((entry) => entry.key);

package/dist/cli-shell-JEC6BEME.mjs

@@ -0,0 +1,11 @@
+import {
+  Shell,
+  bareUsername
+} from "./cli-chunk-L6E2YYPQ.mjs";
+import "./cli-chunk-UD2YES3P.mjs";
+import "./cli-chunk-XT2FISR5.mjs";
+import "./cli-chunk-WWORJ2NE.mjs";
+export {
+  Shell,
+  bareUsername
+};

package/dist/{cli-window-WLRFUKSW.mjs → cli-window-AWXZ5NJX.mjs}

@@ -4,8 +4,8 @@ import {
   openWindow,
   readCurrentDisplaySize,
   runWindow
-} from "./cli-chunk-DGYNADUR.mjs";
-import "./cli-chunk-WBOYG4KJ.mjs";
+} from "./cli-chunk-P4645KKB.mjs";
+import "./cli-chunk-TKKENOSJ.mjs";
 export {
   detectCurrentDisplaySize,
   nativeWindowAvailable,

package/dist/cli.mjs

@@ -13,7 +13,7 @@ import {
   metaPath,
   sessionName,
   socketPath
-} from "./cli-chunk-WBOYG4KJ.mjs";
+} from "./cli-chunk-TKKENOSJ.mjs";
 
 // src/cli/cli.ts
 import { resolve as resolvePath } from "node:path";
@@ -28,15 +28,93 @@ function splitTarget(target, fallbackPort) {
   return { account, host, port: port ? Number(port) : fallbackPort };
 }
 
+// src/cli/args.ts
+var CliError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+  }
+  code;
+};
+var VALUE_FLAGS = /* @__PURE__ */ new Set([
+  "u",
+  "user",
+  "d",
+  "domain",
+  "s",
+  "security",
+  "W",
+  "width",
+  "H",
+  "height",
+  "o",
+  "out",
+  "at",
+  "button",
+  "max-edge",
+  "view-port",
+  "idle",
+  "name",
+  "session",
+  "ssh-user",
+  "ssh-port",
+  "settle",
+  "vnc-port",
+  "port",
+  "keys",
+  "region"
+]);
+var OPTIONAL_VALUE_FLAGS = { shot: /\.(png|jpe?g)$/i };
+function parse(argv) {
+  const flags = {};
+  const positional = [];
+  const identities = [];
+  for (let i = 0; i < argv.length; i++) {
+    const token = argv[i];
+    if (!token.startsWith("-") || token === "-") {
+      positional.push(token);
+      continue;
+    }
+    const split = token.indexOf("=");
+    const name = (split === -1 ? token : token.slice(0, split)).replace(/^--?/, "");
+    const attached = split === -1 ? void 0 : token.slice(split + 1);
+    if (name === "i" || name === "identity") {
+      identities.push(attached ?? argv[++i] ?? "");
+      continue;
+    }
+    if (attached !== void 0) {
+      if (!VALUE_FLAGS.has(name) && !(name in OPTIONAL_VALUE_FLAGS)) {
+        throw new CliError(`--${name} takes no value, so --${name}=... is not a thing.`, 12);
+      }
+      flags[name] = attached;
+    } else if (VALUE_FLAGS.has(name)) flags[name] = argv[++i] ?? "";
+    else if (name in OPTIONAL_VALUE_FLAGS) {
+      const next = argv[i + 1];
+      flags[name] = next !== void 0 && OPTIONAL_VALUE_FLAGS[name].test(next) ? argv[++i] : true;
+    } else flags[name] = true;
+  }
+  return { command: positional[0] ?? "", rest: positional.slice(1), flags, identities };
+}
+var flag = (args, ...names) => {
+  for (const name of names) if (typeof args.flags[name] === "string") return args.flags[name];
+  return void 0;
+};
+var has = (args, ...names) => names.some((name) => args.flags[name] === true);
+var shotFile = (args) => {
+  const value = args.flags.shot;
+  if (value === void 0) return void 0;
+  return typeof value === "string" && value || flag(args, "o", "out") || "screen.png";
+};
+
 // src/cli/prompt.ts
 function canPrompt() {
-  return Boolean(process.stdin.isTTY) && !process.env.AI_REMOTE_NO_PROMPT;
+  return process.stdin.isTTY && !process.env.AI_REMOTE_NO_PROMPT;
 }
 function askPassword(label) {
   if (!canPrompt()) return Promise.resolve("");
   return new Promise((resolve, reject) => {
     const input = process.stdin;
-    const wasRaw = Boolean(input.isRaw);
+    const wasRaw = input.isRaw;
     const bytes = [];
     const done = (finish) => {
       input.off("data", onData);
@@ -180,6 +258,7 @@ The rest drive that session, and take no host:
   ${NAME} clipboard [on|off]       share this machine's clipboard both ways
   ${NAME} cp <src> <dst>           copy files; a remote path starts with ':'
   ${NAME} do    "steps"            several actions in one go
+  ${NAME} batch actions.json       structured actions; - reads JSON from stdin
   ${NAME} vnc                      give this session a screen over VNC
                                    (--vnc-port N, default 5900)
   ${NAME} view                     open the window on the session
@@ -189,6 +268,8 @@ The rest drive that session, and take no host:
   ${NAME} list                     every session open, and every password kept
   ${NAME} saved                    machines with a password kept
   ${NAME} forget [<host[:port]>]   throw one away; --all throws all
+  ${NAME} hosts                    SSH host keys this machine has accepted
+  ${NAME} forget-host <host[:port]> stop trusting one, after a rebuild
   ${NAME} close                    close it; --all closes every session
   ${NAME} probe [<host[:port]>]    is anything listening?
   ${NAME} --version                which version this is
@@ -228,6 +309,10 @@ Options for open
       --side-panel       open the SSH terminal docked on the right
       --audio            play the remote computer's sound in the window (RDP)
       --no-clipboard     do not share this machine's clipboard (shared by default)
+      --insecure-host-key
+                         accept an SSH host key that does not match the one on
+                         file. For a machine you rebuild often, and nothing else:
+                         a changed key is otherwise refused, which is the point
       --keys MODE        adapt | literal  (default: adapt)
                          adapt swaps Control and Command when one end is a Mac,
                          so Command-C copies on Windows and Control-C copies on
@@ -247,7 +332,14 @@ Options for the rest
   -r, --recursive        for cp: copy a directory
       --reconnect        for exec: a new terminal first, then the command
   -o, --out FILE         where a screenshot goes       (default: screen.png)
+      --shot [FILE.png]  for click, type, key, do and batch: screenshot the
+                         steps produced, in the same command. Waits for the
+                         frame they caused rather than a fixed delay, and says
+                         so when nothing on screen changed. Bare --shot writes
+                         to -o, or to screen.png; a name that is not a .png
+                         has to be given as --shot=NAME
       --max-edge N       shrink a screenshot to fit N
+      --region X,Y,W,H   capture a desktop region; --json reports its origin
       --json             machine-readable result on stdout
 
 Signing in
@@ -269,58 +361,6 @@ Signing in
 
 Exit codes: 0 ok \xB7 10 unreachable \xB7 11 auth rejected \xB7 12 bad usage \xB7 13 timeout
 `;
-var VALUE_FLAGS = /* @__PURE__ */ new Set([
-  "u",
-  "user",
-  "d",
-  "domain",
-  "s",
-  "security",
-  "W",
-  "width",
-  "H",
-  "height",
-  "o",
-  "out",
-  "at",
-  "button",
-  "max-edge",
-  "view-port",
-  "idle",
-  "name",
-  "session",
-  "ssh-user",
-  "ssh-port",
-  "settle",
-  "vnc-port",
-  "port",
-  "keys"
-]);
-function parse(argv) {
-  const flags = {};
-  const positional = [];
-  const identities = [];
-  for (let i = 0; i < argv.length; i++) {
-    const token = argv[i];
-    if (!token.startsWith("-") || token === "-") {
-      positional.push(token);
-      continue;
-    }
-    const name = token.replace(/^--?/, "");
-    if (name === "i" || name === "identity") {
-      identities.push(argv[++i] ?? "");
-      continue;
-    }
-    if (VALUE_FLAGS.has(name)) flags[name] = argv[++i] ?? "";
-    else flags[name] = true;
-  }
-  return { command: positional[0] ?? "", rest: positional.slice(1), flags, identities };
-}
-var flag = (args, ...names) => {
-  for (const name of names) if (typeof args.flags[name] === "string") return args.flags[name];
-  return void 0;
-};
-var has = (args, ...names) => names.some((name) => args.flags[name] === true);
 var PORTS = { rdp: 3389, vnc: 5900, ssh: 22 };
 function modeFor(args, target) {
   if (has(args, "ssh", "ssh-only", "terminal")) return "ssh";
@@ -332,19 +372,12 @@ function modeFor(args, target) {
   return "rdp";
 }
 var defaultPort = (mode) => PORTS[mode];
-var CliError = class extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-  }
-  code;
-};
 var password = () => process.env.AI_REMOTE_PASSWORD ?? "";
 function splitKey(key) {
   const at = key.lastIndexOf("@");
   return at === -1 ? ["", key] : [key.slice(0, at), key.slice(at + 1)];
 }
-var secrets = () => import("./cli-secrets-26D3F6EN.mjs");
+var secrets = () => import("./cli-secrets-BMYFPDB2.mjs");
 async function passwordFor(host, port, username) {
   const exported = password();
   if (exported) return exported;
@@ -388,7 +421,7 @@ function refuseTarget(command, token) {
     12
   );
 }
-var DESKTOP_ONLY = /* @__PURE__ */ new Set(["shot", "click", "type", "key", "do"]);
+var DESKTOP_ONLY = /* @__PURE__ */ new Set(["shot", "click", "type", "key", "do", "batch"]);
 var TAKES_NOTHING = /* @__PURE__ */ new Set(["shot", "view", "status", "shell", "close", "vnc", "reconnect"]);
 var COORDINATE = /^-?\d+\s*,\s*-?\d+$/;
 function refuseLegacyTarget(args) {
@@ -419,7 +452,7 @@ async function ask(name, op, args = {}, timeoutMs) {
 async function tell(session, op, args = {}, timeoutMs) {
   const result = await ask(session.name, op, args, timeoutMs).catch((error) => {
     const message = error instanceof Error ? error.message : String(error);
-    if (/^Unknown operation/.test(message)) {
+    if (message.startsWith("Unknown operation")) {
       throw new CliError(
         `The session ${session.name} does not support \`${op}\`: it was started by an older version of ${NAME} and is still running it.
   ${NAME} close --session ${session.name}    then open it again`,
@@ -440,7 +473,7 @@ async function startSession(args, name, host, port, secret, account = "") {
   const explicitHeight = flag(args, "H", "height");
   let fullscreenSize = null;
   if (mode === "rdp" && has(args, "fullscreen") && (!explicitWidth || !explicitHeight)) {
-    const { detectCurrentDisplaySize } = await import("./cli-window-WLRFUKSW.mjs");
+    const { detectCurrentDisplaySize } = await import("./cli-window-AWXZ5NJX.mjs");
     const display = await detectCurrentDisplaySize();
     if (display) fullscreenSize = fullscreenRdpSize(display, has(args, "side-panel"));
   }
@@ -485,6 +518,7 @@ async function startSession(args, name, host, port, secret, account = "") {
   if (has(args, "no-view", "headless")) daemonArgs.push("--no-view");
   if (has(args, "no-open")) daemonArgs.push("--no-open");
   if (has(args, "no-clipboard")) daemonArgs.push("--no-clipboard");
+  if (has(args, "insecure-host-key")) daemonArgs.push("--insecure-host-key");
   if (has(args, "watch-only", "observe")) daemonArgs.push("--watch-only");
   if (has(args, "tab")) daemonArgs.push("--tab");
   if (has(args, "fullscreen")) daemonArgs.push("--fullscreen");
@@ -563,7 +597,7 @@ async function main() {
   }
   const json = has(args, "json");
   if (args.command === "__display-size") {
-    const { readCurrentDisplaySize } = await import("./cli-window-WLRFUKSW.mjs");
+    const { readCurrentDisplaySize } = await import("./cli-window-AWXZ5NJX.mjs");
     const size = await readCurrentDisplaySize();
     if (size) process.stdout.write(`${JSON.stringify(size)}
 `);
@@ -572,7 +606,7 @@ async function main() {
   if (args.command === "__session") {
     const mode = modeFor(args, args.rest[0]);
     const { host, port } = splitTarget(args.rest[0] ?? "", defaultPort(mode));
-    const { runDaemon } = await import("./cli-daemon-M3KM2YHW.mjs");
+    const { runDaemon } = await import("./cli-daemon-3L36TBIB.mjs");
     await runDaemon({
       name: sessionName(host, port, flag(args, "name", "session")),
       host,
@@ -600,12 +634,13 @@ async function main() {
       audio: has(args, "audio", "sound") && mode === "rdp" && !has(args, "no-view", "headless"),
       idleMs: Math.max(0, Number(flag(args, "idle") ?? 0)) * 6e4,
       keys: flag(args, "keys") === "literal" ? "literal" : "adapt",
-      clipboard: !has(args, "no-clipboard")
+      clipboard: !has(args, "no-clipboard"),
+      insecureHostKey: has(args, "insecure-host-key")
     });
     return;
   }
   if (args.command === "__window") {
-    const { runWindow } = await import("./cli-window-WLRFUKSW.mjs");
+    const { runWindow } = await import("./cli-window-AWXZ5NJX.mjs");
     await runWindow(process.argv.slice(3));
     return;
   }
@@ -764,6 +799,36 @@ Saved, nothing open (\`${NAME} open <host>\` needs no password):
     }
     return;
   }
+  if (args.command === "hosts") {
+    const { knownHosts } = await import("./cli-known-hosts-UU427T4N.mjs");
+    const entries = knownHosts();
+    if (json) {
+      process.stdout.write(`${JSON.stringify({ hosts: entries })}
+`);
+      return;
+    }
+    if (!entries.length) {
+      process.stdout.write("No SSH host keys have been accepted yet.\n");
+      return;
+    }
+    for (const entry of entries) {
+      process.stdout.write(`  ${entry.address.padEnd(28)}  ${entry.fingerprint}  ${entry.keyType}  first seen ${entry.firstSeen.slice(0, 10)}
+`);
+    }
+    return;
+  }
+  if (args.command === "forget-host") {
+    const { forgetHostKey } = await import("./cli-known-hosts-UU427T4N.mjs");
+    const target = args.rest[0];
+    if (!target) throw new CliError(`\`${NAME} forget-host <host[:port]>\` needs a machine to forget.`, 2);
+    const where = splitTarget(target, 22);
+    const address = `${where.host}:${where.port}`;
+    const forgotten = forgetHostKey(address);
+    process.stdout.write(forgotten ? `Forgot the host key for ${address}. The next connection records a new one.
+` : `No host key was on file for ${address}. \`${NAME} hosts\` lists what is.
+`);
+    return;
+  }
   if (args.command === "forget") {
     const { forgetAll, forgetSecret, secretKey } = await secrets();
     if (has(args, "all")) {
@@ -903,6 +968,22 @@ Open the host again without --ssh for a desktop.`,
     width: session.width,
     height: session.height
   };
+  const runSteps = async (script) => {
+    const shot = shotFile(args);
+    if (shot === void 0) return tell(session, "script", { script });
+    return tell(session, "act", {
+      script,
+      file: resolvePath(shot),
+      maxEdge: Number(flag(args, "max-edge") ?? 0),
+      region: flag(args, "region")
+    });
+  };
+  const observation = (shot) => shot === void 0 ? { observe: false } : {
+    observe: true,
+    file: resolvePath(shot),
+    region: flag(args, "region"),
+    maxEdge: Number(flag(args, "max-edge") ?? 0)
+  };
   switch (args.command) {
     case "status": {
       Object.assign(summary, await tell(session, "status", {}, 1e4));
@@ -923,7 +1004,7 @@ Open the host again without --ssh for a desktop.`,
     case "shot": {
       const file = resolvePath(flag(args, "o", "out") ?? "screen.png");
       const maxEdge = Number(flag(args, "max-edge") ?? 0);
-      Object.assign(summary, await tell(session, "shot", { file, maxEdge }));
+      Object.assign(summary, await tell(session, "shot", { file, maxEdge, region: flag(args, "region") }));
       break;
     }
     case "click": {
@@ -932,7 +1013,7 @@ Open the host again without --ssh for a desktop.`,
       const [x, y] = spec.split(",").map(Number);
       const button = flag(args, "button") ?? "left";
       const step = `click ${x},${y}${button === "left" ? "" : `,${button}`}`;
-      await tell(session, "script", { script: has(args, "double") ? `${step}; ${step}` : step });
+      Object.assign(summary, await runSteps(has(args, "double") ? `${step}; ${step}` : step));
       Object.assign(summary, { clicked: { x, y, button } });
       break;
     }
@@ -940,13 +1021,16 @@ Open the host again without --ssh for a desktop.`,
       refuseSessionHost(args, "type", session);
       const text = args.rest.join(" ");
       if (!text) throw new CliError("type needs some text", 12);
-      await tell(session, "script", { script: `type ${text}` });
+      Object.assign(summary, await tell(session, "batch", {
+        actions: [{ type: "type", text }],
+        ...observation(shotFile(args))
+      }));
       Object.assign(summary, { typed: text.length });
       break;
     }
     case "key": {
       if (!args.rest.length) throw new CliError("key needs at least one code, e.g. MetaLeft", 12);
-      await tell(session, "script", { script: args.rest.map((code) => `key ${code}`).join("; ") });
+      Object.assign(summary, await runSteps(args.rest.map((code) => `key ${code}`).join("; ")));
       Object.assign(summary, { keys: args.rest });
       break;
     }
@@ -954,7 +1038,20 @@ Open the host again without --ssh for a desktop.`,
       refuseSessionHost(args, "do", session);
       const script = args.rest.join(" ");
       if (!script) throw new CliError('do needs a script, e.g. "key MetaLeft; wait 800; shot s.png"', 12);
-      Object.assign(summary, await tell(session, "script", { script }));
+      Object.assign(summary, await runSteps(script));
+      break;
+    }
+    case "batch": {
+      const file = args.rest[0];
+      if (!file || args.rest.length !== 1) throw new CliError("batch needs a JSON file containing an action array; use - for stdin.", 12);
+      const source = readFileSync2(file === "-" ? 0 : resolvePath(file), "utf8");
+      let actions;
+      try {
+        actions = JSON.parse(source);
+      } catch (error) {
+        throw new CliError(`${file === "-" ? "stdin" : file} is not valid JSON: ${error.message}`, 12);
+      }
+      Object.assign(summary, await tell(session, "batch", { actions, ...observation(shotFile(args)) }));
       break;
     }
     case "exec": {
@@ -987,7 +1084,7 @@ function report(json, command, summary) {
 `);
 }
 async function sshLogin(args, session, what) {
-  const { bareUsername } = await import("./cli-shell-22PZYNSJ.mjs");
+  const { bareUsername } = await import("./cli-shell-JEC6BEME.mjs");
   const username = bareUsername(flag(args, "ssh-user") ?? session.sshUser ?? "");
   if (!username) {
     throw new CliError(
@@ -998,12 +1095,12 @@ async function sshLogin(args, session, what) {
   const { loadIdentities } = await import("./cli-identities-GBQWYF2O.mjs");
   const { identities, skipped } = await loadIdentities(args.identities);
   const port = Number(flag(args, "ssh-port") ?? session.sshPort ?? 22);
-  let password2 = await passwordFor(session.host, port, username);
-  if (!password2 && session.port !== port) {
-    password2 = await passwordFor(session.host, session.port, username);
+  let sshPassword = await passwordFor(session.host, port, username);
+  if (!sshPassword && session.port !== port) {
+    sshPassword = await passwordFor(session.host, session.port, username);
   }
   let asked = false;
-  if (!password2 && !identities.length) {
+  if (!sshPassword && !identities.length) {
     if (!prompting(args)) {
       throw new CliError(
         `${what} signs in for itself, and this shell has nothing for it to use.
@@ -1014,10 +1111,10 @@ Keys passed over: ${skipped.join("; ")}` : ""),
         11
       );
     }
-    password2 = await promptFor(session.host, port, username);
-    asked = Boolean(password2);
+    sshPassword = await promptFor(session.host, port, username);
+    asked = Boolean(sshPassword);
   }
-  return { username, port, identities, password: password2, asked };
+  return { username, port, identities, password: sshPassword, asked };
 }
 function resolveEndpoint(args, endpoint) {
   if (!endpoint.remote) return { endpoint, session: null };
@@ -1069,7 +1166,7 @@ async function copyFiles(args, json) {
     upload,
     walkLocal,
     walkRemote
-  } = await import("./cli-copy-ZBTICP7N.mjs");
+  } = await import("./cli-copy-2HQU2E7D.mjs");
   const from = resolveEndpoint(args, parseEndpoint(args.rest[0]));
   const to = resolveEndpoint(args, parseEndpoint(args.rest[1]));
   if (!from.endpoint.remote && !to.endpoint.remote) {
@@ -1091,7 +1188,8 @@ async function copyFiles(args, json) {
       port: login.port,
       username: login.username,
       password: login.password,
-      identities: login.identities
+      identities: login.identities,
+      insecureHostKey: has(args, "insecure-host-key")
     });
     await connection.connect().catch((error) => {
       throw new CliError(error.message, /password|auth|denied|refused the/i.test(error.message) ? 11 : 10);
@@ -1147,7 +1245,7 @@ async function copyFiles(args, json) {
   }
 }
 async function interactiveShell(args, session) {
-  const { Shell } = await import("./cli-shell-22PZYNSJ.mjs");
+  const { Shell } = await import("./cli-shell-JEC6BEME.mjs");
   const login = await sshLogin(args, session, "a terminal");
   const { username, port, identities } = login;
   const prompts = prompting(args);
@@ -1160,6 +1258,7 @@ async function interactiveShell(args, session) {
       username,
       password: secret,
       identities,
+      insecureHostKey: has(args, "insecure-host-key"),
       columns: process.stdout.columns ?? 120,
       rows: process.stdout.rows ?? 30
     });
@@ -1215,11 +1314,11 @@ async function probe(host, port) {
   });
 }
 function describe(command, summary) {
-  const size = `${summary.width}x${summary.height}`;
+  const size = `${summary.desktopWidth ?? summary.width}x${summary.desktopHeight ?? summary.height}`;
   const terminalOnly = summary.mode === "ssh";
   if (command === "open") {
     const window = summary.window === "window" ? "A window is open on it." : summary.window === "tab" ? "It opened in your browser." : summary.viewer ? `Open it at ${summary.viewer}` : "No window (headless).";
-    const shape = terminalOnly ? "a terminal" : `${size}`;
+    const shape = terminalOnly ? "a terminal" : size;
     const next = terminalOnly ? `
 Session ${summary.name}. \`${NAME} exec "cmd"\` runs something there, \`${NAME} shell\` opens it, \`${NAME} close\` ends it.` : `
 Session ${summary.name}. Run more commands with no host, then \`${NAME} close\` when you are done.`;
@@ -1235,9 +1334,14 @@ ${summary.viewer ? `Window: ${summary.viewer} (${summary.viewers} watching)` : "
     if (summary.already) {
       return `${summary.name} already has a screen (${summary.mode}), ${size}.`;
     }
-    return `${summary.name} now has a screen over VNC, ${size}.${summary.viewer ? ` Watch it at ${summary.viewer}` : ""}
-\`${NAME} shot\`, \`${NAME} click X,Y\` and \`${NAME} type\` now work on it.${summary.saved ? `
-The password is saved in ${summary.saved}.` : ""}`;
+    return [
+      `${summary.name} now has a screen over VNC, ${size}.`,
+      summary.viewer ? ` Watch it at ${summary.viewer}` : "",
+      `
+\`${NAME} shot\`, \`${NAME} click X,Y\` and \`${NAME} type\` now work on it.`,
+      summary.saved ? `
+The password is saved in ${summary.saved}.` : ""
+    ].join("");
   }
   if (command === "view") {
     if (summary.viewer) return `Window: ${summary.viewer}`;
@@ -1258,13 +1362,15 @@ The password is saved in ${summary.saved}.` : ""}`;
     return `${summary.replaced ? "Replaced" : "Opened"} the terminal on ${summary.name}. It is a new login, so it sees whatever the PATH says now -- and has forgotten the working directory and any exported variables.`;
   }
   if (command === "shot") return `Wrote ${summary.file} (${summary.width}x${summary.height}) from ${summary.name}.`;
+  const looked = summary.file ? ` Wrote ${summary.file} (${summary.width}x${summary.height})` + (summary.changed === false ? ", though nothing on screen changed" : "") + (summary.quiet === false ? "; the screen was still moving" : "") + "." : "";
   if (command === "click") {
     const { x, y } = summary.clicked;
-    return `Clicked (${x}, ${y}) on a ${size} desktop.`;
+    return `Clicked (${x}, ${y}) on a ${size} desktop.${looked}`;
   }
-  if (command === "type") return `Typed ${summary.typed} characters.`;
-  if (command === "key") return `Pressed ${summary.keys.join(", ")}.`;
-  if (command === "do") return `Ran ${summary.steps.length} steps: ${summary.steps.join(" \u2192 ")}`;
+  if (command === "type") return `Typed ${summary.typed} characters.${looked}`;
+  if (command === "batch") return `Ran ${summary.actions} actions (${summary.clicks} clicks) in ${summary.dispatchMs} ms of dispatch.${looked}`;
+  if (command === "key") return `Pressed ${summary.keys.join(", ")}.${looked}`;
+  if (command === "do") return `Ran ${summary.steps.length} steps: ${summary.steps.join(" \u2192 ")}${looked}`;
   return "Done.";
 }
 main().catch((error) => {

package/dist/computer.d.ts

@@ -0,0 +1,77 @@
+export type ComputerPoint = {
+    x: number;
+    y: number;
+};
+export type ComputerAction = ({
+    type: 'click';
+    button?: number;
+    count?: number;
+    intervalMs?: number;
+} & ComputerPoint) | ({
+    type: 'move';
+} & ComputerPoint) | ({
+    type: 'scroll';
+    dx?: number;
+    dy?: number;
+} & ComputerPoint) | {
+    type: 'type';
+    text: string;
+    chunkSize?: number;
+    intervalMs?: number;
+} | {
+    type: 'key';
+    chord: string;
+} | {
+    type: 'wait';
+    ms: number;
+} | {
+    type: 'drag';
+    path: ComputerPoint[];
+    button?: number;
+    intervalMs?: number;
+};
+export interface ObservationOptions {
+    region?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    maxEdge?: number;
+}
+export interface ComputerScreenshot {
+    base64: string;
+    width: number;
+    height: number;
+    desktopWidth: number;
+    desktopHeight: number;
+    viewport?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    generation: number;
+    changed: boolean;
+    quiet: boolean;
+    painted: boolean;
+    waitedMs: number;
+}
+export interface ComputerBatchResult {
+    actions: number;
+    clicks: number;
+    /** Input dispatch and requested pacing; not proof of application completion. */
+    dispatchMs: number;
+}
+/** Map a point in a returned image back to full-desktop coordinates. */
+export declare function desktopPoint(image: ComputerScreenshot, point: ComputerPoint): ComputerPoint;
+export declare class RemoteComputer {
+    readonly session: string;
+    constructor(session: string);
+    private call;
+    screenshot(options?: ObservationOptions): Promise<ComputerScreenshot>;
+    /** One IPC call, no reconnect or model invocation between actions. */
+    act(actions: ComputerAction[], options?: ObservationOptions): Promise<ComputerBatchResult & ComputerScreenshot>;
+    /** Explicitly skip observation for a known sequence; inspect when needed. */
+    dispatch(actions: ComputerAction[]): Promise<ComputerBatchResult>;
+}

package/dist/computer.js

@@ -0,0 +1,3 @@
+import g from"node:net";import{StringDecoder as f}from"node:string_decoder";function w(t,e){let r=new f("utf8"),n="";t.on("data",u=>{for(n+=r.write(u);;){let s=n.indexOf(`
+`);if(s===-1)return;let o=n.slice(0,s);if(n=n.slice(s+1),!!o.trim())try{e(JSON.parse(o))}catch{}}})}var x=(t,e)=>{t.write(`${JSON.stringify(e)}
+`)};function p(t,e,r={},n=12e4){return new Promise((u,s)=>{let o=g.connect(t),a=!1,c=(i,l)=>{a||(a=!0,clearTimeout(b),o.destroy(),i?s(i):u(l))},b=setTimeout(()=>c(new Error(`The session did not answer "${e}" in time.`)),n);o.on("connect",()=>x(o,{id:1,op:e,args:r})),o.on("error",i=>{c(Object.assign(i,{notRunning:i.code==="ENOENT"||i.code==="ECONNREFUSED"}))}),w(o,i=>c(null,i))})}import{homedir as y}from"node:os";import{join as m}from"node:path";var k=m(y(),".ai-remote"),P=m(k,"run");var h=t=>m(P,`${t}.sock`);function T(t,e){if(!Number.isFinite(e.x)||!Number.isFinite(e.y)||e.x<0||e.y<0||e.x>=t.width||e.y>=t.height)throw new Error("Point must be inside the screenshot.");let r=t.viewport??{x:0,y:0,width:t.desktopWidth,height:t.desktopHeight};return{x:Math.min(r.x+r.width-1,Math.floor(r.x+e.x*r.width/t.width)),y:Math.min(r.y+r.height-1,Math.floor(r.y+e.y*r.height/t.height))}}var d=class{session;constructor(e){if(!/^[\w.-]+$/.test(e)||e==="."||e==="..")throw new Error("Use a session name from ai-remote status --json.");this.session=e}async call(e,r){let n=await p(h(this.session),e,r);if(!n.ok)throw new Error(n.error??"Remote operation failed.");return n.result}screenshot(e={}){return this.call("shot",{...e})}act(e,r={}){return this.call("batch",{...r,actions:e})}dispatch(e){return this.call("batch",{actions:e,observe:!1})}};export{d as RemoteComputer,T as desktopPoint};