ai-remote 0.5.1 → 0.6.1

package/dist/cli.mjs

@@ -13,7 +13,7 @@ import {
   metaPath,
   sessionName,
   socketPath
-} from "./cli-chunk-WBOYG4KJ.mjs";
+} from "./cli-chunk-MURUADW4.mjs";
 
 // src/cli/cli.ts
 import { resolve as resolvePath } from "node:path";
@@ -28,15 +28,116 @@ 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",
+  // How an input is performed rather than where: how long a button or chord is
+  // held, how many times, what is held down with it, and the floor between one
+  // action and the next.
+  "hold",
+  "count",
+  "with",
+  "pace"
+]);
+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";
+};
+function clickAction(args) {
+  const spec = args.rest[0];
+  if (!spec) throw new CliError("click needs a position, e.g. click 640,400", 12);
+  const [x, y] = spec.split(",").map(Number);
+  return {
+    type: "click",
+    x,
+    y,
+    mouse_button: flag(args, "button") ?? "left",
+    count: has(args, "double") ? 2 : Number(flag(args, "count") ?? 1),
+    intervalMs: Number(flag(args, "pace") ?? 0),
+    duration: Number(flag(args, "hold") ?? 0),
+    ...flag(args, "with") ? { key: flag(args, "with") } : {}
+  };
+}
+var audioEnabled = (args, mode) => mode === "rdp" && !has(args, "no-view", "headless", "no-audio");
+
 // 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);
@@ -172,6 +273,7 @@ The rest drive that session, and take no host:
 
   ${NAME} shot                     screenshot the desktop
   ${NAME} click X,Y                click, --button right|middle, --double
+                                   --hold MS, --count N, --with Shift
   ${NAME} type  "text"             type into whatever has focus
   ${NAME} key   <Code>             press keys, e.g. MetaLeft, ControlLeft+KeyA
   ${NAME} exec  "cmd"              run a command in the terminal (SSH)
@@ -180,8 +282,10 @@ 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} input off                take the pointer from the window (on gives it back)
   ${NAME} view                     open the window on the session
   ${NAME} view --watch-only        a window that watches rather than drives
   ${NAME} view --close             close the window, session keeps running
@@ -189,6 +293,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
@@ -226,8 +332,12 @@ Options for open
   -H, --height N         desktop height                (default: 800)
       --fullscreen       fill the display; RDP uses its current resolution
       --side-panel       open the SSH terminal docked on the right
-      --audio            play the remote computer's sound in the window (RDP)
+      --no-audio         disable remote sound (enabled by default for windowed 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,9 +357,39 @@ 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
 
+Performing an input rather than merely sending it
+      --hold MS          for click and key: how long the button or chord stays
+                         down. A press and a release with nothing between is
+                         not a held key, and a control that measures how long
+                         it was held cannot be worked without this
+      --count N          for click: repeat it, --pace between repeats
+      --with CHORD       for click: a modifier held for that one action,
+                         e.g. --with ShiftLeft
+      --animate          for click, key and batch: draw the pointer travelling
+                         to each target in the window, and hold the input until
+                         it lands. Slower on purpose, and does nothing at all
+                         with no window open
+      --pace MS          a floor between one action and the next. ChatGPT's
+                         computer use waits 100ms after every action; this
+                         waits none unless asked, because a batch exists to
+                         spend one turn on many inputs
+      --exclusive        take the pointer from the window for the length of
+                         this command and give it back after. A desktop has one
+                         pointer: a hand that moves it mid-batch moves what the
+                         agent is aiming at. \`${NAME} input off\` holds it
+                         open instead, and either way the window's control
+                         button takes it back
+
 Signing in
   A terminal signs in with a key where it can: with no --identity, ssh-agent is
   asked for what it is holding and ~/.ssh/id_ed25519, id_ecdsa and id_rsa are
@@ -269,58 +409,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 +420,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 +469,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 +500,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 +521,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-G5ESQTF5.mjs");
     const display = await detectCurrentDisplaySize();
     if (display) fullscreenSize = fullscreenRdpSize(display, has(args, "side-panel"));
   }
@@ -485,17 +566,19 @@ 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");
   if (has(args, "side-panel") && mode !== "ssh") daemonArgs.push("--side-panel");
-  if (has(args, "audio", "sound")) {
+  if (has(args, "no-audio")) daemonArgs.push("--no-audio");
+  if (audioEnabled(args, mode) || has(args, "audio", "sound")) {
     if (mode !== "rdp") {
       process.stderr.write(`--audio is RDP only; a ${mode.toUpperCase()} session has no audio channel.
 `);
     } else if (has(args, "no-view", "headless")) {
       process.stderr.write("--audio needs a window to play into; ignoring it for a headless session.\n");
-    } else {
+    } else if (audioEnabled(args, mode)) {
       daemonArgs.push("--audio");
     }
   }
@@ -563,7 +646,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-G5ESQTF5.mjs");
     const size = await readCurrentDisplaySize();
     if (size) process.stdout.write(`${JSON.stringify(size)}
 `);
@@ -572,7 +655,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-SD2AS34J.mjs");
     await runDaemon({
       name: sessionName(host, port, flag(args, "name", "session")),
       host,
@@ -597,15 +680,16 @@ async function main() {
       watchOnly: has(args, "watch-only", "observe"),
       // RDP is the only protocol here with an audio channel, and a session with
       // no window has nowhere to play what the channel would carry.
-      audio: has(args, "audio", "sound") && mode === "rdp" && !has(args, "no-view", "headless"),
+      audio: audioEnabled(args, mode),
       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-G5ESQTF5.mjs");
     await runWindow(process.argv.slice(3));
     return;
   }
@@ -764,6 +848,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 +1017,28 @@ 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)
+  };
+  const pacing = () => ({
+    animate: has(args, "animate"),
+    postActionSleepMs: Number(flag(args, "pace") ?? 0),
+    // Hold the pointer for the length of this command and give it back after.
+    exclusive: has(args, "exclusive")
+  });
   switch (args.command) {
     case "status": {
       Object.assign(summary, await tell(session, "status", {}, 1e4));
@@ -923,7 +1059,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": {
@@ -931,8 +1067,11 @@ Open the host again without --ssh for a desktop.`,
       if (!spec) throw new CliError(`click needs a position, e.g. \`${NAME} click 640,400\``, 12);
       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 tell(session, "batch", {
+        actions: [clickAction(args)],
+        ...pacing(),
+        ...observation(shotFile(args))
+      }));
       Object.assign(summary, { clicked: { x, y, button } });
       break;
     }
@@ -940,13 +1079,22 @@ 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 }],
+        ...pacing(),
+        ...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("; ") });
+      const duration = Number(flag(args, "hold") ?? 0);
+      Object.assign(summary, await tell(session, "batch", {
+        actions: args.rest.map((chord) => ({ type: "key", chord, duration })),
+        ...pacing(),
+        ...observation(shotFile(args))
+      }));
       Object.assign(summary, { keys: args.rest });
       break;
     }
@@ -954,7 +1102,40 @@ 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,
+        ...pacing(),
+        ...observation(shotFile(args))
+      }));
+      break;
+    }
+    /**
+     * Who may drive: the people watching, or nobody but the agent.
+     *
+     * A remote desktop has one pointer, so an agent working while a hand rests
+     * on the trackpad is two things pulling at the same cursor. `off` takes it
+     * away from the windows; the button in the window still takes it back, and
+     * the next batch is told that it happened.
+     */
+    case "input": {
+      const word = args.rest[0];
+      if (word !== void 0 && word !== "on" && word !== "off") {
+        throw new CliError(`input takes on or off, e.g. \`${NAME} input off\``, 12);
+      }
+      Object.assign(summary, await tell(session, "input", word === void 0 ? {} : { on: word === "on" }));
       break;
     }
     case "exec": {
@@ -987,7 +1168,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 +1179,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 +1195,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 +1250,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 +1272,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 +1329,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 +1342,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 +1398,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 +1418,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 +1446,23 @@ 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.${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 === "input") {
+    const count = Number(summary.viewers ?? 0);
+    const windows = `${count} window${count === 1 ? "" : "s"}`;
+    if (summary.humanInput) {
+      return count ? `The keyboard and pointer are shared: ${windows} may drive.` : "The keyboard and pointer are shared with whoever is watching. No window is open.";
+    }
+    return count ? `The agent has the keyboard and pointer; ${windows} can only watch. The control button in the window takes them back.` : "The agent has the keyboard and pointer. No window is open, and one that opens will start watching.";
   }
-  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 === "do") return `Ran ${summary.steps.length} steps: ${summary.steps.join(" \u2192 ")}${looked}`;
   return "Done.";
 }
 main().catch((error) => {