@proagentstore/cli 0.4.62 → 0.4.64

package/dist/bootstrap.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bootstrap.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import {
+  BOOTSTRAP_ENV,
+  NO_SELF_UPDATE_ENV,
+  cachedPayloads,
+  installPayload,
+  latestPublishedVersion,
+  newestPayload,
+  olderThan,
+  payloadAt
+} from "./chunk-JOWYSZOL.js";
+
+// src/bootstrap.ts
+import { existsSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+
+// src/bootstrap/stub.ts
+import { pathToFileURL } from "url";
+function checksForUpdate(args) {
+  return args.find((a) => !a.startsWith("-")) === "up";
+}
+async function runStub(deps) {
+  const log = deps.log ?? ((line) => process.stderr.write(`${line}
+`));
+  const local = () => newestPayload([...deps.bundled ? [deps.bundled] : [], ...(deps.cached ?? cachedPayloads)()]);
+  let chosen = local();
+  if (checksForUpdate(deps.args) && !deps.fromSource && process.env[NO_SELF_UPDATE_ENV] !== "1") {
+    const latest = await (deps.latest ?? (() => latestPublishedVersion(15e3)))();
+    if (latest && (!chosen || olderThan(chosen.version, latest))) {
+      log(`pags: updating ${chosen?.version ?? "(none)"} \u2192 ${latest}\u2026`);
+      try {
+        chosen = await (deps.install ?? ((v) => installPayload(v)))(latest);
+        log(`pags: now on ${chosen.version}`);
+      } catch (e) {
+        log(`pags: could not fetch ${latest} (${e instanceof Error ? e.message : String(e)}) \u2014 starting ${chosen?.version ?? "nothing"} instead`);
+      }
+    }
+  }
+  if (!chosen) throw new Error("pags: no CLI to run \u2014 reinstall with `npm i -g @proagentstore/cli`");
+  process.env[BOOTSTRAP_ENV] = deps.self;
+  await (deps.load ?? ((entry) => import(pathToFileURL(entry).href)))(chosen.entry);
+  return chosen;
+}
+
+// src/bootstrap.ts
+var self = fileURLToPath(import.meta.url);
+var packageDir = join(dirname(self), "..");
+try {
+  await runStub({
+    bundled: payloadAt(packageDir),
+    args: process.argv.slice(2),
+    self,
+    fromSource: existsSync(join(packageDir, "src", "bootstrap.ts"))
+  });
+} catch (e) {
+  process.stderr.write(`${e instanceof Error ? e.message : String(e)}
+`);
+  process.exit(1);
+}

package/dist/chunk-JOWYSZOL.js

@@ -0,0 +1,97 @@
+// src/bootstrap/payload.ts
+import { execFile } from "child_process";
+import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, renameSync, rmSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { promisify } from "util";
+var run = promisify(execFile);
+var CLI_PACKAGE = "@proagentstore/cli";
+var BOOTSTRAP_ENV = "PAGS_BOOTSTRAP";
+var NO_SELF_UPDATE_ENV = "PAGS_NO_SELF_UPDATE";
+var KEEP = 2;
+function payloadRoot() {
+  return process.env.PAGS_CLI_CACHE || join(homedir(), ".config", "proagentstore", "cli");
+}
+function olderThan(a, b) {
+  const parse = (v) => /^(\d+)\.(\d+)\.(\d+)/.exec(v.trim())?.slice(1).map(Number);
+  const x = parse(a);
+  const y = parse(b);
+  if (!x || !y) return false;
+  for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] < y[i];
+  return false;
+}
+function payloadAt(dir) {
+  try {
+    const pkg = JSON.parse(readFileSync(join(dir, "package.json"), "utf-8"));
+    if (pkg.name !== CLI_PACKAGE || !pkg.version) return null;
+    const entry = join(dir, pkg.pagsPayload || "dist/index.js");
+    return existsSync(entry) ? { version: pkg.version, entry } : null;
+  } catch {
+    return null;
+  }
+}
+var installedAt = (prefix) => join(prefix, "node_modules", ...CLI_PACKAGE.split("/"));
+var packageDir = (root, version) => installedAt(join(root, version));
+function cachedPayloads(root = payloadRoot()) {
+  let names;
+  try {
+    names = readdirSync(root);
+  } catch {
+    return [];
+  }
+  return names.flatMap((v) => v.startsWith(".") ? [] : payloadAt(packageDir(root, v)) ?? []);
+}
+function newestPayload(payloads) {
+  return payloads.reduce((best, p) => !best || olderThan(best.version, p.version) ? p : best, null);
+}
+async function latestPublishedVersion(timeoutMs = 3e4) {
+  try {
+    const { stdout } = await run("npm", ["view", CLI_PACKAGE, "version"], { timeout: timeoutMs });
+    return stdout.trim() || null;
+  } catch {
+    return null;
+  }
+}
+async function npmInstallInto(dir, version) {
+  try {
+    await run("npm", ["install", "--prefix", dir, "--omit=dev", "--no-audit", "--no-fund", "--no-save", `${CLI_PACKAGE}@${version}`], { timeout: 5 * 6e4 });
+  } catch (e) {
+    const stderr = String(e.stderr ?? "").trim();
+    throw new Error((stderr || (e instanceof Error ? e.message : String(e))).slice(-400));
+  }
+}
+async function installPayload(version, root = payloadRoot(), install = npmInstallInto) {
+  const done = payloadAt(packageDir(root, version));
+  if (done) return done;
+  mkdirSync(root, { recursive: true });
+  const scratch = mkdtempSync(join(root, `.install-${version}-`));
+  try {
+    await install(scratch, version);
+    if (payloadAt(installedAt(scratch))?.version !== version) throw new Error(`npm installed no ${CLI_PACKAGE}@${version}`);
+    try {
+      renameSync(scratch, join(root, version));
+    } catch (e) {
+      if (!payloadAt(packageDir(root, version))) throw e;
+    }
+  } finally {
+    rmSync(scratch, { recursive: true, force: true });
+  }
+  const payload = payloadAt(packageDir(root, version));
+  if (!payload) throw new Error(`${CLI_PACKAGE}@${version} is not usable after install`);
+  for (const old of cachedPayloads(root).sort((a, b) => olderThan(a.version, b.version) ? 1 : -1).slice(KEEP)) {
+    rmSync(join(root, old.version), { recursive: true, force: true });
+  }
+  return payload;
+}
+
+export {
+  CLI_PACKAGE,
+  BOOTSTRAP_ENV,
+  NO_SELF_UPDATE_ENV,
+  olderThan,
+  payloadAt,
+  cachedPayloads,
+  newestPayload,
+  latestPublishedVersion,
+  installPayload
+};

package/dist/index.js

@@ -1,4 +1,11 @@
 #!/usr/bin/env node
+import {
+  BOOTSTRAP_ENV,
+  CLI_PACKAGE,
+  installPayload,
+  latestPublishedVersion,
+  olderThan
+} from "./chunk-JOWYSZOL.js";
 
 // src/index.ts
 import { createRequire as createRequire3 } from "module";
@@ -1090,7 +1097,7 @@ var publishCommand = new Command6("publish").description("Publish an agent to Pr
 });
 
 // src/commands/runner/command.ts
-import { spawn as spawn3 } from "child_process";
+import { spawn as spawn4 } from "child_process";
 import { randomUUID as randomUUID2 } from "crypto";
 import { Command as Command7 } from "commander";
 
@@ -1198,44 +1205,59 @@ async function waitForLocalRunner(opts, timeoutMs = 15e3) {
 import { hostname as hostname3 } from "os";
 
 // src/commands/runner/self-update.ts
-import { execFile } from "child_process";
+import { execFile, spawn as spawn3 } from "child_process";
 import { promisify } from "util";
 var run = promisify(execFile);
 var RUNNER_UPDATE_PATH = "/pags/runner/update";
 var RUNNER_RESTART_EXIT_CODE = 75;
 var SUPERVISED_ENV = "PAGS_UP_SUPERVISED";
-var CLI_PACKAGE = "@proagentstore/cli";
-function olderThan(a, b) {
-  const parse = (v) => /^(\d+)\.(\d+)\.(\d+)/.exec(v.trim())?.slice(1).map(Number);
-  const x = parse(a);
-  const y = parse(b);
-  if (!x || !y) return false;
-  for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] < y[i];
-  return false;
+var SUPERVISOR_RESTARTS = "2";
+var SERVICE_ENV = "PAGS_SERVICE";
+var RESTART_COMMAND_ENV = "PAGS_RESTART_COMMAND";
+function restarterFrom(env) {
+  if (env[SUPERVISED_ENV] === SUPERVISOR_RESTARTS) return "pags-up";
+  if (env[SUPERVISED_ENV] === "1") return "pags-up-child-only";
+  if (env[SERVICE_ENV] === "1") return "service";
+  if (env[RESTART_COMMAND_ENV]?.trim()) return "command";
+  return null;
+}
+function supervisorNote(restarter) {
+  return restarter === "pags-up-child-only" ? "The `pags up` on this machine predates supervisor restarts (#860): the runner comes back on the new release, but the `pags up` window keeps running its own older code until it is restarted there once." : null;
+}
+function leaveForRestart(restarter, deps = { spawn: spawn3, exit: (code) => process.exit(code) }) {
+  if (restarter === "command") {
+    deps.spawn(process.env[RESTART_COMMAND_ENV], { shell: true, detached: true, stdio: "ignore", env: process.env }).unref();
+    deps.exit(0);
+    return;
+  }
+  deps.exit(RUNNER_RESTART_EXIT_CODE);
+}
+function restartUpArgs(opts) {
+  const args = ["up"];
+  if (opts.headless) args.push("--headless");
+  if (opts.force) args.push("--force");
+  if (opts.instance) args.push("--instance", opts.instance);
+  return args;
 }
 function planRunnerUpdate(f) {
   if (f.fromSource) return { action: "refused", current: f.current, reason: "This runner runs from a source checkout \u2014 update it with `git pull` there, not npm." };
   if (!f.latest) return { action: "refused", current: f.current, reason: `npm could not be asked for the latest ${CLI_PACKAGE} from this machine.` };
   if (!olderThan(f.current, f.latest)) return { action: "up-to-date", current: f.current };
-  if (!f.supervised) {
+  if (!f.restarter) {
     return {
       action: "refused",
       current: f.current,
-      reason: `This runner was not started by a \`pags up\` that can restart it (\`pags runner connect\` directly, or a \`pags up\` older than the respawn). Update once at the machine: \`npm i -g ${CLI_PACKAGE}\` and restart \`pags up\` \u2014 later updates can then be done remotely.`
+      reason: `Nothing would start this runner again after an update: it was not started by \`pags up\`, and neither ${SERVICE_ENV}=1 (a launchd/systemd unit that restarts it on a non-zero exit) nor ${RESTART_COMMAND_ENV} (a command that starts it again) is set. Run it under \`pags up\`, or set one of the two where it is started \u2014 later updates can then be done remotely. (A \`pags up\` older than 0.4.62 cannot restart it either: update once at the machine with \`npm i -g ${CLI_PACKAGE}\`.)`
     };
   }
   if (f.busy.length > 0) return { action: "wait", current: f.current, latest: f.latest, waitingFor: f.busy };
-  return { action: "update", current: f.current, latest: f.latest };
-}
-async function latestPublishedVersion() {
-  try {
-    const { stdout } = await run("npm", ["view", CLI_PACKAGE, "version"], { timeout: 3e4 });
-    return stdout.trim() || null;
-  } catch {
-    return null;
-  }
+  return { action: "update", current: f.current, latest: f.latest, restarter: f.restarter };
 }
 async function installVersion(version2) {
+  if (process.env[BOOTSTRAP_ENV]) {
+    await installPayload(version2);
+    return;
+  }
   try {
     await run("npm", ["i", "-g", `${CLI_PACKAGE}@${version2}`], { timeout: 5 * 6e4 });
   } catch (e) {
@@ -1386,7 +1408,7 @@ async function connectViaRelay(instanceIds, localUrl, runnerToken, opts, force =
       current: CLI_VERSION,
       latest: await latestPublishedVersion(),
       fromSource: runsFromSource(),
-      supervised: process.env[SUPERVISED_ENV] === "1",
+      restarter: restarterFrom(process.env),
       busy: (sessions.sessions ?? []).filter((s) => s.alive && s.runState && s.runState !== "idle").map((s) => s.sessionId)
     };
   };
@@ -1396,7 +1418,7 @@ async function connectViaRelay(instanceIds, localUrl, runnerToken, opts, force =
     writeLine(`Installed ${plan.latest} \u2014 restarting; every agent re-attaches on the way back up.`);
     setTimeout(() => {
       for (const id of [...attached.keys()]) detach(id);
-      process.exit(RUNNER_RESTART_EXIT_CODE);
+      leaveForRestart(plan.restarter);
     }, 500).unref();
   };
   let updateWaiting = false;
@@ -1427,7 +1449,8 @@ async function connectViaRelay(instanceIds, localUrl, runnerToken, opts, force =
     } catch (e) {
       return { status: 500, result: { error: `npm could not install ${plan.latest}: ${e instanceof Error ? e.message : String(e)}` } };
     }
-    return { status: 200, result: { action: "restarting", current: plan.current, latest: plan.latest } };
+    const supervisor = supervisorNote(plan.restarter);
+    return { status: 200, result: { action: "restarting", current: plan.current, latest: plan.latest, restartedBy: plan.restarter, ...supervisor ? { supervisor } : {} } };
   };
   const answerControl = async (path, body) => {
     if (path === RUNNER_UPDATE_PATH) return answerUpdate(body);
@@ -1734,7 +1757,7 @@ function createRunnerCommand() {
     const primary = instanceIds[0];
     const runnerOpts = { ...opts, host, port, token: runnerToken };
     const spec = runnerSpawnSpec(runnerOpts);
-    const runner = spawn3(spec.command, spec.args, {
+    const runner = spawn4(spec.command, spec.args, {
       cwd: spec.cwd,
       stdio: ["ignore", "pipe", "pipe"],
       shell: process.platform === "win32"
@@ -1885,6 +1908,7 @@ function createRunnerCommand() {
 var runnerCommand = createRunnerCommand();
 
 // src/commands/up.ts
+import { execFileSync as execFileSync2 } from "child_process";
 import { createRequire as createRequire2 } from "module";
 import { Command as Command8 } from "commander";
 import { hostname as hostname5 } from "os";
@@ -2011,7 +2035,7 @@ var API_BASE3 = "https://api.proagentstore.online";
 var CLI_VERSION2 = createRequire2(import.meta.url)("../package.json").version;
 async function stopRunnerProcesses() {
   if (process.platform === "win32") return false;
-  const { execFileSync: execFileSync2 } = await import("child_process");
+  const { execFileSync: execFileSync3 } = await import("child_process");
   const patterns = [
     "dist/browser-runner/index.js",
     "browser-runner/src/index",
@@ -2020,7 +2044,7 @@ async function stopRunnerProcesses() {
   let stopped = false;
   for (const p of patterns) {
     try {
-      execFileSync2("pkill", ["-f", p], { stdio: "ignore" });
+      execFileSync3("pkill", ["-f", p], { stdio: "ignore" });
       stopped = true;
     } catch {
     }
@@ -2104,17 +2128,16 @@ var upCommand = new Command8("up").description("Start the browser runner for all
   state.activeInstance = instances.length === 1 ? instances[0].name || instances[0].slug || instances[0].id.slice(0, 8) : `${instances.length} agents`;
   printStep(`Connecting ${state.activeInstance}\u2026`, "wait");
   await stopRunnerProcesses();
-  const { spawn: spawn4 } = await import("child_process");
+  const { spawn: spawn5 } = await import("child_process");
   const cliPath = process.argv[1];
   const args = [cliPath, "runner", "connect", ...instances.map((i) => i.id)];
   if (opts.headless) args.push("--headless");
   if (opts.force) args.push("--force");
   if (!opts.instance) args.push("--watch-instances");
-  const spawnChild = () => spawn4(process.execPath, args, {
+  const child = spawn5(process.execPath, args, {
     stdio: ["ignore", "pipe", "pipe"],
-    env: { ...process.env, PAGS_TOKEN: session.token, [SUPERVISED_ENV]: "1" }
+    env: { ...process.env, PAGS_TOKEN: session.token, [SUPERVISED_ENV]: SUPERVISOR_RESTARTS }
   });
-  let child = spawnChild();
   const logs = [];
   const handleOutput = (data2) => {
     const text = data2.toString("utf-8");
@@ -2173,17 +2196,11 @@ var upCommand = new Command8("up").description("Start the browser runner for all
     }
   };
   let childDead = false;
-  const wire = () => {
-    child.stdout?.on("data", handleOutput);
-    child.stderr?.on("data", handleOutput);
-    child.on("exit", onChildExit);
-  };
-  function onChildExit(code) {
+  child.stdout?.on("data", handleOutput);
+  child.stderr?.on("data", handleOutput);
+  child.on("exit", (code) => {
     if (code === RUNNER_RESTART_EXIT_CODE) {
-      state.lastEvent = "Runner updated remotely \u2014 restarting on the new version";
-      printStatus(state);
-      child = spawnChild();
-      wire();
+      restartUp("Runner updated remotely \u2014 restarting pags up on the new version\u2026", { PAGS_NO_PROMPT: "1" });
       return;
     }
     childDead = true;
@@ -2194,8 +2211,20 @@ var upCommand = new Command8("up").description("Start the browser runner for all
       if (recent.length) state.lastEvent += ": " + recent[recent.length - 1].slice(0, 60);
       printStatus(state);
     }
+  });
+  function restartUp(why, env = {}) {
+    writeLine(`  ${why}`);
+    try {
+      if (process.stdin.isTTY) process.stdin.setRawMode(false);
+      process.stdin.pause();
+      execFileSync2(process.execPath, [process.argv[1], ...restartUpArgs(opts)], { stdio: "inherit", env: { ...process.env, ...env } });
+    } catch (e) {
+      const status = e.status;
+      writeLine(`  Restart failed${typeof status === "number" ? ` (exit ${status})` : ""} \u2014 the runner is NOT running. Run 'pags up' again.`);
+      process.exit(typeof status === "number" && status !== 0 ? status : 1);
+    }
+    process.exit(0);
   }
-  wire();
   const shutdown = () => {
     child.kill();
     clearScreen();
@@ -2223,25 +2252,7 @@ var upCommand = new Command8("up").description("Start the browser runner for all
       printStatus(state);
     }
     if (key === "r") {
-      if (childDead) {
-        writeLine("  Restarting runner...");
-        const { execFileSync: execFileSync2 } = await import("child_process");
-        const restartArgs = [process.argv[1], "up"];
-        if (opts.headless) restartArgs.push("--headless");
-        if (opts.force) restartArgs.push("--force");
-        if (opts.instance) restartArgs.push("--instance", opts.instance);
-        try {
-          execFileSync2(process.execPath, restartArgs, {
-            stdio: "inherit",
-            env: process.env
-          });
-        } catch (e) {
-          const status = e.status;
-          writeLine(`  Restart failed${typeof status === "number" ? ` (exit ${status})` : ""} \u2014 the runner is NOT running. Run 'pags up' again.`);
-          process.exit(typeof status === "number" && status !== 0 ? status : 1);
-        }
-        process.exit(0);
-      }
+      if (childDead) restartUp("Restarting runner...");
       printStatus(state);
     }
   }

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@proagentstore/cli",
-  "version": "0.4.62",
+  "version": "0.4.64",
   "description": "CLI for creating, publishing, and running ProAgentStore agents",
   "license": "MIT",
   "type": "module",
   "bin": {
-    "pags": "dist/index.js"
+    "pags": "dist/bootstrap.js"
   },
+  "pagsPayload": "dist/index.js",
   "homepage": "https://github.com/ProAgentStore/platform#readme",
   "repository": {
     "type": "git",
@@ -25,7 +26,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "pnpm --filter @proagentstore/browser-runner build && tsup src/index.ts --format esm --dts && node scripts/copy-browser-runner.mjs",
+    "build": "pnpm --filter @proagentstore/browser-runner build && tsup src/index.ts src/bootstrap.ts --format esm --dts && node scripts/copy-browser-runner.mjs",
     "dev": "tsx src/index.ts",
     "typecheck": "tsc --noEmit"
   },