claude-yes 1.160.3 → 1.161.0

package/dist/SUPPORTED_CLIS-CHmQfHCh.js

@@ -0,0 +1,8 @@
+import "./ts-CRo3qQWb.js";
+import "./logger-CDIsZ-Pp.js";
+import "./versionChecker-DrjR4P0K.js";
+import "./pidStore-fqXqTKkh.js";
+import "./globalPidIndex-DlmmJlO8.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-DYTnLX8C.js";
+
+export { SUPPORTED_CLIS };

package/dist/{SUPPORTED_CLIS-WcYvfnJQ.js → SUPPORTED_CLIS-DYTnLX8C.js}

@@ -1,8 +1,8 @@
-import { t as CLIS_CONFIG } from "./ts-DcZvAsIp.js";
+import { t as CLIS_CONFIG } from "./ts-CRo3qQWb.js";
 
 //#region ts/SUPPORTED_CLIS.ts
 const SUPPORTED_CLIS = Object.keys(CLIS_CONFIG);
 
 //#endregion
 export { SUPPORTED_CLIS as t };
-//# sourceMappingURL=SUPPORTED_CLIS-WcYvfnJQ.js.map
+//# sourceMappingURL=SUPPORTED_CLIS-DYTnLX8C.js.map

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 import { t as invokedCliName } from "./invokedCli-uqM2YYA7.js";
 import { n as logger } from "./logger-CDIsZ-Pp.js";
-import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-DOse329y.js";
+import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-DrjR4P0K.js";
 import { argv } from "process";
 import { execFileSync, spawn } from "child_process";
 import ms from "ms";
@@ -481,7 +481,7 @@ function buildRustArgs(argv, cliFromScript, supportedClis) {
 	const rawArg = process.argv[2];
 	const managerCommands = !invokedCliName(process.argv);
 	const isHelpFlag = rawArg === "-h" || rawArg === "--help";
-	const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-BJ2xKtDu.js");
+	const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-5AXvxB0S.js");
 	if (isHelpFlag && process.argv.length === 3) {
 		cmdHelp(managerCommands);
 		process.exit(0);
@@ -514,7 +514,7 @@ if (config.useRust) {
 		}
 	}
 	if (rustBinary) {
-		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-pKjUYMIj.js");
+		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-CHmQfHCh.js");
 		const rustArgs = buildRustArgs(process.argv, config.cli, SUPPORTED_CLIS);
 		if (config.verbose) {
 			console.log(`[rust] Using binary: ${rustBinary}`);

package/dist/index.js

@@ -1,6 +1,6 @@
-import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-DcZvAsIp.js";
+import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-CRo3qQWb.js";
 import "./logger-CDIsZ-Pp.js";
-import "./versionChecker-DOse329y.js";
+import "./versionChecker-DrjR4P0K.js";
 import "./pidStore-fqXqTKkh.js";
 import "./globalPidIndex-DlmmJlO8.js";
 

package/dist/{schedule-YIA3BrZV.js → schedule-CCvB7SCT.js}

@@ -1,9 +1,9 @@
-import "./ts-DcZvAsIp.js";
+import "./ts-CRo3qQWb.js";
 import "./logger-CDIsZ-Pp.js";
-import "./versionChecker-DOse329y.js";
+import "./versionChecker-DrjR4P0K.js";
 import "./pidStore-fqXqTKkh.js";
 import "./globalPidIndex-DlmmJlO8.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-WcYvfnJQ.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-DYTnLX8C.js";
 import { o as resolveSpawnCwd } from "./workspaceConfig-B0Q9-q2B.js";
 import { createHash } from "node:crypto";
 
@@ -141,4 +141,4 @@ async function cmdSchedule(rest) {
 
 //#endregion
 export { cmdSchedule };
-//# sourceMappingURL=schedule-YIA3BrZV.js.map
+//# sourceMappingURL=schedule-CCvB7SCT.js.map

package/dist/{serve-D3vy56FC.js → serve-BRARQjsC.js}

@@ -1,16 +1,16 @@
-import "./ts-DcZvAsIp.js";
+import "./ts-CRo3qQWb.js";
 import "./logger-CDIsZ-Pp.js";
-import { r as getInstalledPackage } from "./versionChecker-DOse329y.js";
+import { r as getInstalledPackage } from "./versionChecker-DrjR4P0K.js";
 import "./pidStore-fqXqTKkh.js";
 import { a as updateGlobalPidStatus } from "./globalPidIndex-DlmmJlO8.js";
 import { t as pgidForWrapper } from "./reaper-C-eWAxIj.js";
 import "./configShared-CEyhl0WH.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-WcYvfnJQ.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-DYTnLX8C.js";
 import "./e2e-Bfw7qL9O.js";
 import "./webrtcLink-CBZkZ-LT.js";
 import "./remotes-DBCvpp3B.js";
 import { a as isProvisionAllowed, i as hasSpawnHook, n as getSpawnHook, o as resolveSpawnCwd, t as getProvisionRoot } from "./workspaceConfig-B0Q9-q2B.js";
-import { D as writeToIpc, T as snapshotStatus, _ as readPtysize, b as resolveOne, c as extractTaskCounts, g as readNotes, i as controlCodeFromName, m as listRecords, o as deriveLiveStatus, v as renderRawLog } from "./subcommands-Cz17HvuK.js";
+import { D as writeToIpc, T as snapshotStatus, _ as readPtysize, b as resolveOne, c as extractTaskCounts, g as readNotes, i as controlCodeFromName, m as listRecords, o as deriveLiveStatus, v as renderRawLog } from "./subcommands-DGkBxWS5.js";
 import yargs from "yargs";
 import { mkdir, open, readFile, stat, unlink, writeFile } from "fs/promises";
 import { homedir, hostname, userInfo } from "os";
@@ -1389,4 +1389,4 @@ Options:
 
 //#endregion
 export { cmdServe };
-//# sourceMappingURL=serve-D3vy56FC.js.map
+//# sourceMappingURL=serve-BRARQjsC.js.map

package/dist/{setup-B1meh4do.js → setup-Cx7jDKtC.js}

@@ -32,7 +32,7 @@ async function cmdSetup(rest) {
 	if (!existsSync(abs)) process.stderr.write(`  note: that directory doesn't exist yet — create it, or agents spawned there will fail\n`);
 	if (noShare) return 0;
 	process.stdout.write(`\nsharing this machine to agent-yes.com…\n`);
-	const { cmdServe } = await import("./serve-D3vy56FC.js");
+	const { cmdServe } = await import("./serve-BRARQjsC.js");
 	return cmdServe([
 		"install",
 		"--share",
@@ -42,4 +42,4 @@ async function cmdSetup(rest) {
 
 //#endregion
 export { cmdSetup };
-//# sourceMappingURL=setup-B1meh4do.js.map
+//# sourceMappingURL=setup-Cx7jDKtC.js.map

package/dist/{subcommands-BJ2xKtDu.js → subcommands-5AXvxB0S.js}

@@ -4,6 +4,6 @@ import "./configShared-CEyhl0WH.js";
 import "./e2e-Bfw7qL9O.js";
 import "./webrtcLink-CBZkZ-LT.js";
 import "./remotes-DBCvpp3B.js";
-import { C as restartHintLines, D as writeToIpc, E as stopTipForCli, S as resolveResumeArgs, T as snapshotStatus, _ as readPtysize, a as cursorAbs, b as resolveOne, c as extractTaskCounts, d as isExitRequest, f as isPidAlive, g as readNotes, h as matchKeyword, i as controlCodeFromName, l as finalizedLines, m as listRecords, n as READ_PAGE_DEFAULT, o as deriveLiveStatus, p as isSubcommand, r as cmdHelp, s as extractNeedsInput, t as GRACEFUL_EXIT_COMMANDS, u as isAgentStuck, v as renderRawLog, w as runSubcommand, x as resolveReadWindow, y as renderRawLogLines } from "./subcommands-Cz17HvuK.js";
+import { C as restartHintLines, D as writeToIpc, E as stopTipForCli, S as resolveResumeArgs, T as snapshotStatus, _ as readPtysize, a as cursorAbs, b as resolveOne, c as extractTaskCounts, d as isExitRequest, f as isPidAlive, g as readNotes, h as matchKeyword, i as controlCodeFromName, l as finalizedLines, m as listRecords, n as READ_PAGE_DEFAULT, o as deriveLiveStatus, p as isSubcommand, r as cmdHelp, s as extractNeedsInput, t as GRACEFUL_EXIT_COMMANDS, u as isAgentStuck, v as renderRawLog, w as runSubcommand, x as resolveReadWindow, y as renderRawLogLines } from "./subcommands-DGkBxWS5.js";
 
 export { cmdHelp, isSubcommand, runSubcommand };

package/dist/{subcommands-Cz17HvuK.js → subcommands-DGkBxWS5.js}

@@ -500,6 +500,7 @@ const SUBCOMMANDS = new Set([
 	"tail",
 	"head",
 	"send",
+	"spawn",
 	"attach",
 	"stop",
 	"exit",
@@ -548,21 +549,22 @@ async function runSubcommand(argv) {
 			case "tail": return await cmdRead(rest, { mode: "tail" });
 			case "head": return await cmdRead(rest, { mode: "head" });
 			case "send": return await cmdSend(rest);
+			case "spawn": return await cmdSpawn(rest);
 			case "attach": return await cmdAttach(rest);
 			case "stop": return await cmdStop(rest);
 			case "exit": return await cmdExit(rest);
 			case "restart": return await cmdRestart(rest);
 			case "note": return await cmdNote(rest);
 			case "serve": {
-				const { cmdServe } = await import("./serve-D3vy56FC.js");
+				const { cmdServe } = await import("./serve-BRARQjsC.js");
 				return cmdServe(rest);
 			}
 			case "setup": {
-				const { cmdSetup } = await import("./setup-B1meh4do.js");
+				const { cmdSetup } = await import("./setup-Cx7jDKtC.js");
 				return cmdSetup(rest);
 			}
 			case "schedule": {
-				const { cmdSchedule } = await import("./schedule-YIA3BrZV.js");
+				const { cmdSchedule } = await import("./schedule-CCvB7SCT.js");
 				return cmdSchedule(rest);
 			}
 			case "remote": {
@@ -716,14 +718,15 @@ async function resolveOne(keyword, opts) {
 async function remoteGet(remote, pathname) {
 	return fetch(`${remote.url}${pathname}`, { headers: { Authorization: `Bearer ${remote.token}` } });
 }
-async function remotePost(remote, pathname, body) {
+async function remotePost(remote, pathname, body, signal) {
 	return fetch(`${remote.url}${pathname}`, {
 		method: "POST",
 		headers: {
 			Authorization: `Bearer ${remote.token}`,
 			"Content-Type": "application/json"
 		},
-		body: JSON.stringify(body)
+		body: JSON.stringify(body),
+		...signal ? { signal } : {}
 	});
 }
 async function runRemoteLs(remote, opts) {
@@ -875,6 +878,44 @@ async function runRemoteSend(remote, msg, code) {
 	process.stdout.write(`sent to remote pid ${data.pid} (${remote.url}  ${keyword})\n`);
 	return 0;
 }
+/**
+* Spawn an agent on a remote host by POSTing its existing `/api/spawn`. The
+* remote applies ITS OWN spawn hook + provision allowlist server-side (the hook
+* never crosses the wire). `hint` is the user-typed target (alias or
+* token@host:port) so the printed follow-ups are copy-pasteable.
+*
+* NO retry: a POST that already spawned must never be re-sent (double-spawn). A
+* generous timeout still bounds a half-open/stalled connection — on timeout the
+* result is UNKNOWN, so we say so and point at `ay ls` rather than retrying.
+*/
+async function runRemoteSpawn(remote, hint, spec) {
+	const SPAWN_TIMEOUT_MS = Number(process.env.AGENT_YES_REMOTE_SPAWN_TIMEOUT_MS) || 12e4;
+	let res;
+	try {
+		res = await remotePost(remote, "/api/spawn", {
+			cli: spec.cli,
+			cwd: spec.cwd || void 0,
+			from: spec.from || void 0,
+			prompt: spec.prompt || void 0
+		}, AbortSignal.timeout(SPAWN_TIMEOUT_MS));
+	} catch (e) {
+		const name = e?.name;
+		if (name === "TimeoutError" || name === "AbortError") {
+			process.stderr.write(`remote spawn: no response from ${remote.url} within ${Math.round(SPAWN_TIMEOUT_MS / 1e3)}s — result UNKNOWN (not retried).\n  ay ls ${hint}    # check whether it started\n`);
+			return 2;
+		}
+		process.stderr.write(`remote spawn failed: ${e.message}\n`);
+		return 1;
+	}
+	if (!res.ok) {
+		process.stderr.write(`remote spawn failed ${res.status}: ${await res.text()}\n`);
+		return 1;
+	}
+	const r = await res.json();
+	process.stdout.write(`spawned ${r.cli} on ${remote.url} in ${r.cwd}${r.hook ? " (via spawn hook)" : ""}${r.provisioned ? ` (${r.provisioned.action})` : ""}\n`);
+	process.stderr.write(`\n  ay ls ${hint}    # the new ${r.cli} agent appears here\n`);
+	return 0;
+}
 async function runRemoteStatus(remote) {
 	const keyword = remote.keyword ?? "";
 	if (!keyword) {
@@ -1819,6 +1860,40 @@ function extractActivityFromLines(lines) {
 	}
 	return null;
 }
+async function cmdSpawn(rest) {
+	const argv = await yargs(rest).usage("Usage: ay spawn <remote> [--cli claude] [--cwd <dir>] [--from <src>] -- <prompt>").option("cli", {
+		type: "string",
+		default: "claude",
+		description: "CLI to wrap (claude|codex|gemini|…)"
+	}).option("cwd", {
+		type: "string",
+		description: "Working dir ON THE REMOTE (resolved against the remote's workspace root)"
+	}).option("from", {
+		type: "string",
+		description: "Provision a worktree from a GitHub source (owner/repo@branch) on the remote"
+	}).option("prompt", {
+		type: "string",
+		description: "Initial prompt (or pass it after `--`)"
+	}).help(false).version(false).exitProcess(false).parseAsync();
+	const target = argv._[0] !== void 0 ? String(argv._[0]) : void 0;
+	if (!target) throw new Error("usage: ay spawn <remote> [--cli X] [--cwd D] [--from S] -- <prompt>");
+	const prompt = String(argv.prompt ?? argv._.slice(1).map(String).join(" "));
+	const remote = await resolveRemoteSpec(target);
+	if (!remote) {
+		process.stderr.write(`ay spawn: '${target}' is not a known remote (token@host:port or a saved alias).\n  to spawn locally:  ay ${argv.cli}${prompt ? ` -- "${prompt}"` : ""}\n  to add a remote:   ay remote add <alias> http://<token>@<host>:<port>\n`);
+		return 1;
+	}
+	if (remote.keyword) {
+		process.stderr.write(`ay spawn: target '${target}' carries a ':${remote.keyword}' keyword — spawn takes a remote, not an existing agent. Drop the ':${remote.keyword}'.\n`);
+		return 1;
+	}
+	return runRemoteSpawn(remote, target, {
+		cli: String(argv.cli || "claude"),
+		cwd: argv.cwd ? String(argv.cwd) : void 0,
+		from: argv.from ? String(argv.from) : void 0,
+		prompt: prompt || void 0
+	});
+}
 async function cmdSend(rest) {
 	const argv = await yargs(rest).usage("Usage: ay send <keyword> <msg|-> [options]").option("code", {
 		type: "string",
@@ -2719,4 +2794,4 @@ async function cmdResultSet(rest) {
 
 //#endregion
 export { restartHintLines as C, writeToIpc as D, stopTipForCli as E, resolveResumeArgs as S, snapshotStatus as T, readPtysize as _, cursorAbs as a, resolveOne as b, extractTaskCounts as c, isExitRequest as d, isPidAlive as f, readNotes as g, matchKeyword as h, controlCodeFromName as i, finalizedLines as l, listRecords as m, READ_PAGE_DEFAULT as n, deriveLiveStatus as o, isSubcommand as p, cmdHelp as r, extractNeedsInput as s, GRACEFUL_EXIT_COMMANDS as t, isAgentStuck as u, renderRawLog as v, runSubcommand as w, resolveReadWindow as x, renderRawLogLines as y };
-//# sourceMappingURL=subcommands-Cz17HvuK.js.map
+//# sourceMappingURL=subcommands-DGkBxWS5.js.map

package/dist/{ts-DcZvAsIp.js → ts-CRo3qQWb.js}

@@ -1,5 +1,5 @@
 import { n as logger, t as addTransport } from "./logger-CDIsZ-Pp.js";
-import { r as getInstalledPackage } from "./versionChecker-DOse329y.js";
+import { r as getInstalledPackage } from "./versionChecker-DrjR4P0K.js";
 import { t as agentYesHome } from "./agentYesHome-_eJa3DaX.js";
 import { i as shouldUseLock, r as releaseLock, t as acquireLock } from "./runningLock-V4qvXgAw.js";
 import { t as PidStore } from "./pidStore-fqXqTKkh.js";
@@ -1802,4 +1802,4 @@ function sleep(ms) {
 
 //#endregion
 export { removeControlCharacters as a, AgentContext as i, agentYes as n, config as r, CLIS_CONFIG as t };
-//# sourceMappingURL=ts-DcZvAsIp.js.map
+//# sourceMappingURL=ts-CRo3qQWb.js.map

package/dist/{versionChecker-DOse329y.js → versionChecker-DrjR4P0K.js}

@@ -7,7 +7,7 @@ import { fileURLToPath } from "url";
 
 //#region package.json
 var name = "claude-yes";
-var version = "1.160.3";
+var version = "1.161.0";
 
 //#endregion
 //#region ts/versionChecker.ts
@@ -215,4 +215,4 @@ async function displayVersion() {
 
 //#endregion
 export { versionString as i, displayVersion as n, getInstalledPackage as r, checkAndAutoUpdate as t };
-//# sourceMappingURL=versionChecker-DOse329y.js.map
+//# sourceMappingURL=versionChecker-DrjR4P0K.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-yes",
-  "version": "1.160.3",
+  "version": "1.161.0",
   "description": "A wrapper tool that automates interactions with various AI CLI tools by automatically handling common prompts and responses.",
   "keywords": [
     "ai",

package/ts/subcommands.ts

@@ -251,6 +251,7 @@ const SUBCOMMANDS = new Set([
   "tail",
   "head",
   "send",
+  "spawn",
   "attach",
   "stop",
   "exit",
@@ -325,6 +326,8 @@ export async function runSubcommand(argv: string[]): Promise<number | null> {
         return await cmdRead(rest, { mode: "head" });
       case "send":
         return await cmdSend(rest);
+      case "spawn":
+        return await cmdSpawn(rest);
       case "attach":
         return await cmdAttach(rest);
       case "stop":
@@ -648,11 +651,13 @@ async function remotePost(
   remote: ResolvedRemote,
   pathname: string,
   body: unknown,
+  signal?: AbortSignal,
 ): Promise<Response> {
   return fetch(`${remote.url}${pathname}`, {
     method: "POST",
     headers: { Authorization: `Bearer ${remote.token}`, "Content-Type": "application/json" },
     body: JSON.stringify(body),
+    ...(signal ? { signal } : {}),
   });
 }
 
@@ -839,6 +844,79 @@ async function runRemoteSend(remote: ResolvedRemote, msg: string, code: string):
   return 0;
 }
 
+/**
+ * Spawn an agent on a remote host by POSTing its existing `/api/spawn`. The
+ * remote applies ITS OWN spawn hook + provision allowlist server-side (the hook
+ * never crosses the wire). `hint` is the user-typed target (alias or
+ * token@host:port) so the printed follow-ups are copy-pasteable.
+ *
+ * NO retry: a POST that already spawned must never be re-sent (double-spawn). A
+ * generous timeout still bounds a half-open/stalled connection — on timeout the
+ * result is UNKNOWN, so we say so and point at `ay ls` rather than retrying.
+ */
+async function runRemoteSpawn(
+  remote: ResolvedRemote,
+  hint: string,
+  spec: { cli: string; cwd?: string; from?: string; prompt?: string },
+): Promise<number> {
+  // A hooked `/api/spawn` (#126) can legitimately block up to the remote's
+  // handshake window, so the timeout is generous; it only guards a dead/half-open
+  // connection that would otherwise hang the CLI forever.
+  const SPAWN_TIMEOUT_MS = Number(process.env.AGENT_YES_REMOTE_SPAWN_TIMEOUT_MS) || 120_000;
+  let res: Response;
+  try {
+    res = await remotePost(
+      remote,
+      "/api/spawn",
+      {
+        cli: spec.cli,
+        cwd: spec.cwd || undefined,
+        from: spec.from || undefined,
+        prompt: spec.prompt || undefined,
+      },
+      AbortSignal.timeout(SPAWN_TIMEOUT_MS),
+    );
+  } catch (e) {
+    const name = (e as Error)?.name;
+    if (name === "TimeoutError" || name === "AbortError") {
+      // The request may or may not have spawned — do NOT retry. Let the operator check.
+      process.stderr.write(
+        `remote spawn: no response from ${remote.url} within ${Math.round(SPAWN_TIMEOUT_MS / 1000)}s — ` +
+          `result UNKNOWN (not retried).\n  ay ls ${hint}    # check whether it started\n`,
+      );
+      return 2;
+    }
+    process.stderr.write(`remote spawn failed: ${(e as Error).message}\n`);
+    return 1;
+  }
+  if (!res.ok) {
+    process.stderr.write(`remote spawn failed ${res.status}: ${await res.text()}\n`);
+    return 1;
+  }
+  const r = (await res.json()) as {
+    pid: number;
+    cli: string;
+    cwd: string;
+    hook?: boolean;
+    provisioned?: { action: string };
+  };
+  process.stdout.write(
+    `spawned ${r.cli} on ${remote.url} in ${r.cwd}` +
+      `${r.hook ? " (via spawn hook)" : ""}` +
+      `${r.provisioned ? ` (${r.provisioned.action})` : ""}\n`,
+  );
+  // We deliberately do NOT print the agent's own pid. `/api/spawn` returns the
+  // `ay` LAUNCHER pid, which is not the agent's registered pid (the record's
+  // pid/wrapper_pid are the runtime process, not the launcher) — and picking the
+  // freshly-registered agent by "newest" would, under a concurrent spawn,
+  // surface a sibling's (or another user's) pid. Point at the remote's list,
+  // where the new agent reliably appears, instead of guessing.
+  // (A one-step `ay tail <remote>:<pid>` would need /api/spawn to return a
+  // correlatable agent id — a server change left for a follow-up.)
+  process.stderr.write(`\n  ay ls ${hint}    # the new ${r.cli} agent appears here\n`);
+  return 0;
+}
+
 async function runRemoteStatus(remote: ResolvedRemote): Promise<number> {
   const keyword = remote.keyword ?? "";
   if (!keyword) {
@@ -2072,6 +2150,65 @@ function extractActivityFromLines(lines: string[]): string | null {
   return null;
 }
 
+// ---------------------------------------------------------------------------
+// ay spawn — launch an agent on a REMOTE host (POSTs the remote's /api/spawn)
+// ---------------------------------------------------------------------------
+
+async function cmdSpawn(rest: string[]): Promise<number> {
+  const y = yargs(rest)
+    .usage("Usage: ay spawn <remote> [--cli claude] [--cwd <dir>] [--from <src>] -- <prompt>")
+    .option("cli", {
+      type: "string",
+      default: "claude",
+      description: "CLI to wrap (claude|codex|gemini|…)",
+    })
+    .option("cwd", {
+      type: "string",
+      description: "Working dir ON THE REMOTE (resolved against the remote's workspace root)",
+    })
+    .option("from", {
+      type: "string",
+      description: "Provision a worktree from a GitHub source (owner/repo@branch) on the remote",
+    })
+    .option("prompt", { type: "string", description: "Initial prompt (or pass it after `--`)" })
+    .help(false)
+    .version(false)
+    .exitProcess(false);
+
+  const argv = await y.parseAsync();
+  const target = argv._[0] !== undefined ? String(argv._[0]) : undefined;
+  if (!target)
+    throw new Error("usage: ay spawn <remote> [--cli X] [--cwd D] [--from S] -- <prompt>");
+  const prompt = String(argv.prompt ?? argv._.slice(1).map(String).join(" "));
+
+  // v1 is remote-only: local spawning is just running the agent directly. A
+  // target that doesn't resolve as a remote is almost certainly a mistake (e.g.
+  // passing a cli name), so fail loudly with the local equivalent.
+  const remote = await resolveRemoteSpec(target);
+  if (!remote) {
+    process.stderr.write(
+      `ay spawn: '${target}' is not a known remote (token@host:port or a saved alias).\n` +
+        `  to spawn locally:  ay ${argv.cli}${prompt ? ` -- "${prompt}"` : ""}\n` +
+        `  to add a remote:   ay remote add <alias> http://<token>@<host>:<port>\n`,
+    );
+    return 1;
+  }
+  if (remote.keyword) {
+    process.stderr.write(
+      `ay spawn: target '${target}' carries a ':${remote.keyword}' keyword — spawn takes a remote, ` +
+        `not an existing agent. Drop the ':${remote.keyword}'.\n`,
+    );
+    return 1;
+  }
+
+  return runRemoteSpawn(remote, target, {
+    cli: String(argv.cli || "claude"),
+    cwd: argv.cwd ? String(argv.cwd) : undefined,
+    from: argv.from ? String(argv.from) : undefined,
+    prompt: prompt || undefined,
+  });
+}
+
 // ---------------------------------------------------------------------------
 // ay send
 // ---------------------------------------------------------------------------

package/dist/SUPPORTED_CLIS-pKjUYMIj.js

@@ -1,8 +0,0 @@
-import "./ts-DcZvAsIp.js";
-import "./logger-CDIsZ-Pp.js";
-import "./versionChecker-DOse329y.js";
-import "./pidStore-fqXqTKkh.js";
-import "./globalPidIndex-DlmmJlO8.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-WcYvfnJQ.js";
-
-export { SUPPORTED_CLIS };