athena-agent-launcher 0.3.0 → 0.3.1

package/bin/launcher.mjs

@@ -139,42 +139,93 @@ async function runSetup() {
   process.stdout.write("  Run an agent with: athena-agent run <agent-id>\n\n");
 }
 
-// Return the absolute path to `hermes` if it's findable on PATH, in
-// ~/.local/bin, or in a few other common locations. Returns null if not found.
+// Return the absolute path to `hermes` if it's findable on PATH or in a few
+// common install locations. Cross-platform (uses `where` on Windows, `which`
+// elsewhere) and never throws if the finder binary is missing. Returns null if
+// not found.
 async function locateHermes() {
-  const userLocalBin = join(homedir(), ".local", "bin", "hermes");
-  const candidates = [userLocalBin, "/usr/local/bin/hermes", "/opt/homebrew/bin/hermes"];
+  const isWin = process.platform === "win32";
+  const home = homedir();
+  const candidates = isWin
+    ? [
+        join(home, ".local", "bin", "hermes.exe"),
+        join(home, ".local", "bin", "hermes.cmd"),
+        join(home, ".local", "bin", "hermes"),
+      ]
+    : [join(home, ".local", "bin", "hermes"), "/usr/local/bin/hermes", "/opt/homebrew/bin/hermes"];
   for (const p of candidates) {
     if (existsSync(p)) return p;
   }
-  const which = await new Promise((resolve) => {
-    const c = spawn("which", ["hermes"], { stdio: ["ignore", "pipe", "ignore"] });
+  // `where` (Windows) / `which` (POSIX). Wrapped so a missing finder binary
+  // surfaces as null instead of an unhandled 'error' event (the ENOENT crash).
+  const finder = isWin ? "where" : "which";
+  return await new Promise((resolve) => {
     let out = "";
-    c.stdout.on("data", (d) => (out += d.toString()));
-    c.on("exit", () => resolve(out.trim()));
+    let child;
+    try {
+      child = spawn(finder, ["hermes"], { stdio: ["ignore", "pipe", "ignore"] });
+    } catch {
+      return resolve(null);
+    }
+    child.on("error", () => resolve(null));
+    child.stdout.on("data", (d) => (out += d.toString()));
+    child.on("exit", () => {
+      const first = out
+        .split(/\r?\n/)
+        .map((s) => s.trim())
+        .filter(Boolean)[0];
+      resolve(first || null);
+    });
   });
-  return which || null;
 }
 
 async function ensureHermesInstalled() {
   const found = await locateHermes();
   if (found) return found;
 
+  const isWin = process.platform === "win32";
   process.stderr.write(
-    "[athena-agent] Hermes is not installed. Installing silently (this is a one-time setup)…\n",
+    "[athena-agent] Hermes is not installed. Installing (this is a one-time setup)…\n",
   );
-  // `bash -s -- --skip-setup` passes the flag to the install script and
-  // suppresses its post-install wizard, so the user only ever sees Athena's UX.
   const code = await new Promise((resolve) => {
-    const c = spawn(
-      "bash",
-      ["-c", "curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-setup"],
-      { stdio: "inherit" },
-    );
+    let c;
+    try {
+      c = isWin
+        ? // Native Windows installer (PowerShell). Hermes' CLI + ACP run
+          // natively; only its own dashboard pane needs WSL2, which we don't use.
+          spawn(
+            "powershell",
+            [
+              "-NoProfile",
+              "-ExecutionPolicy",
+              "Bypass",
+              "-Command",
+              "iex (irm https://hermes-agent.nousresearch.com/install.ps1)",
+            ],
+            { stdio: "inherit" },
+          )
+        : // `bash -s -- --skip-setup` suppresses the installer's wizard so the
+          // user only ever sees Athena's UX.
+          spawn(
+            "bash",
+            [
+              "-c",
+              "curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-setup",
+            ],
+            { stdio: "inherit" },
+          );
+    } catch {
+      return resolve(1);
+    }
+    c.on("error", () => resolve(1));
     c.on("exit", (code) => resolve(code ?? 1));
   });
   if (code !== 0) {
-    process.stderr.write("[athena-agent] Hermes install failed. See output above.\n");
+    process.stderr.write(
+      "[athena-agent] Hermes install failed. On Windows you can also install it manually\n" +
+        "  (PowerShell):  iex (irm https://hermes-agent.nousresearch.com/install.ps1)\n" +
+        "  then re-run this command. Or use WSL2 for the fully-supported Linux path.\n",
+    );
     return null;
   }
   process.stderr.write("[athena-agent] Hermes installed.\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "athena-agent-launcher",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Run an Athena-configured agent locally. Resolves runtime + bindings from the Athena control plane and spawns the correct agent binary (Anthropic SDK, OpenClaw, or Hermes).",
   "type": "module",
   "bin": {