tryharness 0.7.23 → 0.7.26

package/lib/onboard.mjs

@@ -1,6 +1,11 @@
 import { spawnSync } from "node:child_process";
 import pc from "picocolors";
-import { detectLocalAgents, setupHermes, setupOpenClaw, localWakes } from "./wakes.mjs";
+import {
+  detectLocalAgents,
+  setupHermes,
+  setupOpenClaw,
+  localWakes,
+} from "./wakes.mjs";
 import { columns, createUi, wrap } from "./ui.mjs";
 
 // "Your swarm" in setup: every agent class with how Harness reaches it, the recommended way already chosen, and a real
@@ -8,13 +13,19 @@ import { columns, createUi, wrap } from "./ui.mjs";
 // `npx tryharness agents`. Without a terminal to answer in, it only says what is set up and how to finish.
 
 const SETUP = { openclaw: setupOpenClaw, hermes: setupHermes };
-const LABEL = { openclaw: "OpenClaw", hermes: "Hermes", "grok-bot": "Grok Bot" };
-const later = (agent) => `Later: ${pc.cyan(`npx tryharness agents setup ${agent}`)}`;
+const LABEL = {
+  openclaw: "OpenClaw",
+  hermes: "Hermes",
+  "grok-bot": "Grok Bot",
+};
+const later = (agent) =>
+  `Later: ${pc.cyan(`npx tryharness agents setup ${agent}`)}`;
 
 // The Harness mark (src/main/home/landing/walkthrough/BrandMark.tsx) in box characters: dim corners, the bright one in
 // Harness teal, the wordmark beside it. Plain when the output is not a terminal or NO_COLOR is set.
 export function banner(version, { color = pc.isColorSupported } = {}) {
-  const c = pc.createColors(color), teal = (text) => (color ? `\x1b[38;5;36m${text}\x1b[39m` : text);
+  const c = pc.createColors(color),
+    teal = (text) => (color ? `\x1b[38;5;36m${text}\x1b[39m` : text);
   const rows = [
     [c.dim("┌───"), "           ", teal("───┐")],
     [c.dim("│"), "                 ", teal("│")],
@@ -26,34 +37,90 @@ export function banner(version, { color = pc.isColorSupported } = {}) {
     [c.dim("│"), "                 ", c.dim("│")],
     [c.dim("└───"), "           ", c.dim("───┘")],
   ];
-  const side = { 3: c.bold("harness relay"), 4: "your personal swarm", 5: c.dim(`setup ${version}`) };
-  return rows.map((parts, index) => {
-    const line = parts.join("");
-    const width = line.replace(/\x1b\[[0-9;]*m/g, "").length;
-    return side[index] ? `  ${line}${" ".repeat(23 - width)}${side[index]}` : `  ${line}`.trimEnd();
-  }).join("\n");
+  const side = {
+    3: c.bold("harness relay"),
+    4: "your personal swarm",
+    5: c.dim(`setup ${version}`),
+  };
+  return rows
+    .map((parts, index) => {
+      const line = parts.join("");
+      const width = line.replace(/\x1b\[[0-9;]*m/g, "").length;
+      return side[index]
+        ? `  ${line}${" ".repeat(23 - width)}${side[index]}`
+        : `  ${line}`.trimEnd();
+    })
+    .join("\n");
 }
 
 const copy = (text) => {
-  const tool = process.platform === "darwin" ? "pbcopy" : process.platform === "win32" ? "clip" : "xclip";
-  const result = spawnSync(tool, tool === "xclip" ? ["-selection", "clipboard"] : [], { input: text });
+  const tool =
+    process.platform === "darwin"
+      ? "pbcopy"
+      : process.platform === "win32"
+        ? "clip"
+        : "xclip";
+  const result = spawnSync(
+    tool,
+    tool === "xclip" ? ["-selection", "clipboard"] : [],
+    { input: text }
+  );
   return result.status === 0;
 };
 
 /** Post a setup check for the agent and wait for its report: the same path real work takes. */
-export async function testAgent({ agent, daemonRequest, ui = createUi(), waitMs = 10 * 60_000, sleep = (ms) => new Promise((r) => setTimeout(r, ms)) }) {
+export async function testAgent({
+  agent,
+  daemonRequest,
+  ui = createUi(),
+  waitMs = 10 * 60_000,
+  sleep = (ms) => new Promise((r) => setTimeout(r, ms)),
+}) {
   const name = LABEL[agent] || agent;
-  const posted = await daemonRequest({ command: "board.post", agent: "user", objective: "Setup check from Harness: reply ready", brief: "Harness is checking that it can wake you. Claim this task and report it done with the single word: ready. Do nothing else.", targetAgent: agent });
-  if (!posted?.ok) { ui.warn(`The test task could not be posted: ${posted?.error || "no answer"}`); return false; }
-  const started = Date.now(), spin = ui.spinner();
+  const posted = await daemonRequest({
+    command: "board.post",
+    agent: "user",
+    objective: "Setup check from Harness: reply ready",
+    brief:
+      "Harness is checking that it can wake you. Claim this task and report it done with the single word: ready. Do nothing else.",
+    targetAgent: agent,
+  });
+  if (!posted?.ok) {
+    ui.warn(
+      `The test task could not be posted: ${posted?.error || "no answer"}`
+    );
+    return false;
+  }
+  const started = Date.now(),
+    spin = ui.spinner();
   spin.start(`Waiting for ${name} to answer a test task`);
   while (Date.now() - started < waitMs) {
     await sleep(2_000);
-    const task = (await daemonRequest({ command: "board.get", agent: "user", id: posted.task.id }).catch(() => null))?.task;
-    if (task?.status === "done") { spin.stop(`${name} answered in ${Math.round((Date.now() - started) / 1000)}s. Ready.`); return true; }
-    if (task && ["failed", "needs_input"].includes(task.status)) { spin.stop(`${name} answered, but the task is ${task.status}${task.result ? `: ${task.result}` : ""}`, 2); return false; }
+    const task = (
+      await daemonRequest({
+        command: "board.get",
+        agent: "user",
+        id: posted.task.id,
+      }).catch(() => null)
+    )?.task;
+    if (task?.status === "done") {
+      spin.stop(
+        `${name} answered in ${Math.round((Date.now() - started) / 1000)}s. Ready.`
+      );
+      return true;
+    }
+    if (task && ["failed", "needs_input"].includes(task.status)) {
+      spin.stop(
+        `${name} answered, but the task is ${task.status}${task.result ? `: ${task.result}` : ""}`,
+        2
+      );
+      return false;
+    }
   }
-  spin.stop(`No answer after ${Math.round(waitMs / 60_000)} minutes. Check that ${name} is running, then: npx tryharness agents test ${agent}`, 2);
+  spin.stop(
+    `No answer after ${Math.round(waitMs / 60_000)} minutes. Check that ${name} is running, then: npx tryharness agents test ${agent}`,
+    2
+  );
   return false;
 }
 
@@ -61,21 +128,50 @@ async function setupLocal({ entry, runtimeRoot, ui, daemonRequest }) {
   const name = LABEL[entry.agent];
   const run = async () => {
     const result = SETUP[entry.agent]({ runtimeRoot });
-    if (!result.ok) { ui.warn(result.detail); return; }
+    if (!result.ok) {
+      ui.warn(result.detail);
+      return;
+    }
     ui.success(result.detail);
     await testAgent({ agent: entry.agent, daemonRequest, ui });
   };
   if (localWakes()[entry.agent]) {
-    const health = (await daemonRequest({ command: "wake.local" }).catch(() => null))?.agents?.[entry.agent];
-    if (!health || health.answering) { ui.success(`${name} is woken on this computer by its own webhook`); return; }
-    ui.warn(`${name} is not answering wakes (${health.lastFailure}). Check that it is running.`);
-    if (!ui.interactive || !(await ui.confirm({ message: `Set ${name} up again?`, initialValue: true }))) { ui.info(later(entry.agent)); return; }
+    const health = (
+      await daemonRequest({ command: "wake.local" }).catch(() => null)
+    )?.agents?.[entry.agent];
+    if (!health || health.answering) {
+      ui.success(`${name} is woken on this computer by its own webhook`);
+      return;
+    }
+    ui.warn(
+      `${name} is not answering wakes (${health.lastFailure}). Check that it is running.`
+    );
+    if (
+      !ui.interactive ||
+      !(await ui.confirm({
+        message: `Set ${name} up again?`,
+        initialValue: true,
+      }))
+    ) {
+      ui.info(later(entry.agent));
+      return;
+    }
     await run();
     return;
   }
-  if (!ui.interactive) { ui.info(`${name} found. ${later(entry.agent)}`); return; }
-  ui.step(`${name} found on this computer\n${pc.dim(`Harness adds itself to ${name}'s MCP servers and turns on its webhook with a key made here${entry.agent === "openclaw" ? ", then restarts its gateway" : ""}. Nothing to copy.`)}`);
-  if (!(await ui.confirm({ message: `Set up ${name} now?`, initialValue: true }))) { ui.info(`Skipped. ${later(entry.agent)}`); return; }
+  if (!ui.interactive) {
+    ui.info(`${name} found. ${later(entry.agent)}`);
+    return;
+  }
+  ui.step(
+    `${name} found on this computer\n${pc.dim(`Harness adds itself to ${name}'s MCP servers and turns on its webhook with a key made here${entry.agent === "openclaw" ? ", then restarts its gateway" : ""}. Nothing to copy.`)}`
+  );
+  if (
+    !(await ui.confirm({ message: `Set up ${name} now?`, initialValue: true }))
+  ) {
+    ui.info(`Skipped. ${later(entry.agent)}`);
+    return;
+  }
   await run();
 }
 
@@ -89,64 +185,190 @@ async function waitFor(check, waitMs = 10 * 60_000, everyMs = 3_000) {
 }
 
 async function setupGrok({ ui, daemonRequest, clipboard }) {
-  const list = () => daemonRequest({ command: "wake.server", input: { action: "list" } });
-  const listed = await list().catch((error) => ({ ok: false, error: error.message }));
-  if (!listed.ok) { ui.warn(`Harness could not be reached (${listed.error}). ${later("grok-bot")}`); return; }
-  const current = (listed.wakes || []).find((wake) => wake.agent === "grok-bot");
+  const list = () =>
+    daemonRequest({ command: "wake.server", input: { action: "list" } });
+  const listed = await list().catch((error) => ({
+    ok: false,
+    error: error.message,
+  }));
+  if (!listed.ok) {
+    ui.warn(
+      `Harness could not be reached (${listed.error}). ${later("grok-bot")}`
+    );
+    return;
+  }
+  const current = (listed.wakes || []).find(
+    (wake) => wake.agent === "grok-bot"
+  );
   if (current) {
-    const how = current.channel === "email" ? `email at ${current.address}` : "its webhook";
-    if (current.answering) { ui.success(`Grok Bot is woken by ${how}`); return; }
-    ui.warn(`Grok Bot is not answering wakes by ${how} (${current.last_failure})`);
-    if (!ui.interactive || !(await ui.confirm({ message: "Set it up again?", initialValue: true }))) { ui.info(later("grok-bot")); return; }
+    const how =
+      current.channel === "email"
+        ? `email at ${current.address}`
+        : "its webhook";
+    if (current.answering) {
+      ui.success(`Grok Bot is woken by ${how}`);
+      return;
+    }
+    ui.warn(
+      `Grok Bot is not answering wakes by ${how} (${current.last_failure})`
+    );
+    if (
+      !ui.interactive ||
+      !(await ui.confirm({ message: "Set it up again?", initialValue: true }))
+    ) {
+      ui.info(later("grok-bot"));
+      return;
+    }
+  }
+  if (!ui.interactive) {
+    ui.info(`Grok Bot is not set up. ${later("grok-bot")}`);
+    return;
   }
-  if (!ui.interactive) { ui.info(`Grok Bot is not set up. ${later("grok-bot")}`); return; }
   const channel = await ui.select({
     message: "How should Harness wake Grok Bot?",
     initialValue: "email",
     options: [
-      { value: "email", label: "Email", hint: "recommended · about 23s · nothing to copy back" },
-      { value: "webhook", label: "Webhook", hint: "about 17s · you paste its URL and key here" },
+      {
+        value: "email",
+        label: "Email",
+        hint: "recommended · about 23s · nothing to copy back",
+      },
+      {
+        value: "webhook",
+        label: "Webhook",
+        hint: "about 17s · you paste its URL and key here",
+      },
       { value: "skip", label: "Not now" },
     ],
   });
-  if (!channel || channel === "skip") { ui.info(`Skipped. ${later("grok-bot")}`); return; }
+  if (!channel || channel === "skip") {
+    ui.info(`Skipped. ${later("grok-bot")}`);
+    return;
+  }
   const message = listed.messages?.["grok-bot"]?.[channel];
-  if (!message) { ui.warn("Harness did not send the setup message. Update tryharness and try again."); return; }
-  const setup = (listed.setup || []).find((entry) => entry.agent === "grok-bot");
+  if (!message) {
+    ui.warn(
+      "Harness did not send the setup message. Update tryharness and try again."
+    );
+    return;
+  }
+  const setup = (listed.setup || []).find(
+    (entry) => entry.agent === "grok-bot"
+  );
   const connected = Boolean(setup) && !setup.missing?.includes("connection");
   const copied = clipboard(message);
-  ui.note(wrap(message, Math.max(40, columns() - 8)).join("\n"), copied ? "Paste this into Grok · it is on your clipboard" : "Paste this into Grok");
-  if (connected) ui.success(`Grok is already connected to Harness as Grok Bot${setup.old_approval ? `\n${pc.dim("approved before it could register its own address, so it gives you its address instead")}` : ""}`);
-  else ui.info("Grok opens Harness's approval page. Name the connection Grok Bot and approve it.");
+  ui.note(
+    wrap(message, Math.max(40, columns() - 8)).join("\n"),
+    copied
+      ? "Paste this into Grok · it is on your clipboard"
+      : "Paste this into Grok"
+  );
+  if (connected)
+    ui.success(
+      `Grok is already connected to Harness as Grok Bot${setup.old_approval ? `\n${pc.dim("approved before it could register its own address, so it gives you its address instead")}` : ""}`
+    );
+  else
+    ui.info(
+      "Grok opens Harness's approval page. Name the connection Grok Bot and approve it."
+    );
 
   const save = async (input, done) => {
-    const saved = await daemonRequest({ command: "wake.server", input: { action: "save", agent: "grok-bot", ...input } });
-    if (!saved.ok) { ui.warn(`${saved.error}. Try again: npx tryharness agents setup grok-bot`); return false; }
+    const saved = await daemonRequest({
+      command: "wake.server",
+      input: { action: "save", agent: "grok-bot", ...input },
+    });
+    if (!saved.ok) {
+      ui.warn(
+        `${saved.error}. Try again: npx tryharness agents setup grok-bot`
+      );
+      return false;
+    }
     ui.success(done(saved));
     return true;
   };
   if (channel === "webhook") {
-    ui.info("In Grok, open Routines, then Harness wake, and copy its webhook URL and key.");
-    const address = await ui.text({ message: "Grok's webhook URL", placeholder: "https://", validate: (value) => (/^https:\/\/\S+$/.test(value.trim()) ? undefined : "Paste the https URL from Grok's routine") });
-    if (!address) { ui.info(`Skipped. ${later("grok-bot")}`); return; }
-    const key = await ui.password({ message: "Its key", validate: (value) => (value.trim() ? undefined : "Paste the key from Grok's routine") });
-    if (!key) { ui.info(`Skipped. ${later("grok-bot")}`); return; }
-    if (!(await save({ channel: "webhook", address: address.trim(), key }, () => "Saved. The key is stored sealed on Harness and never shown again."))) return;
+    ui.info(
+      "In Grok, open Routines, then Harness wake, and copy its webhook URL and key."
+    );
+    const address = await ui.text({
+      message: "Grok's webhook URL",
+      placeholder: "https://",
+      validate: (value) =>
+        /^https:\/\/\S+$/.test(value.trim())
+          ? undefined
+          : "Paste the https URL from Grok's routine",
+    });
+    if (!address) {
+      ui.info(`Skipped. ${later("grok-bot")}`);
+      return;
+    }
+    const key = await ui.password({
+      message: "Its key",
+      validate: (value) =>
+        value.trim() ? undefined : "Paste the key from Grok's routine",
+    });
+    if (!key) {
+      ui.info(`Skipped. ${later("grok-bot")}`);
+      return;
+    }
+    if (
+      !(await save(
+        { channel: "webhook", address: address.trim(), key },
+        () =>
+          "Saved. The key is stored sealed on Harness and never shown again."
+      ))
+    )
+      return;
   } else {
-    const ownAddress = (value) => (/^[^\s@]+@mail\.grokbot\.com$/i.test(value.trim()) ? undefined : "Grok's address ends in @mail.grokbot.com");
+    const ownAddress = (value) =>
+      /^[^\s@]+@mail\.grokbot\.com$/i.test(value.trim())
+        ? undefined
+        : "Grok's address ends in @mail.grokbot.com";
     let address = "";
     if (setup?.old_approval) {
-      address = await ui.text({ message: "Grok's email address", placeholder: "name@mail.grokbot.com", validate: ownAddress }) ?? "";
-      if (!address) { ui.info(`Skipped. ${later("grok-bot")}`); return; }
+      address =
+        (await ui.text({
+          message: "Grok's email address",
+          placeholder: "name@mail.grokbot.com",
+          validate: ownAddress,
+        })) ?? "";
+      if (!address) {
+        ui.info(`Skipped. ${later("grok-bot")}`);
+        return;
+      }
     } else {
       // Grok registers its own address; the person may type the one Grok gives instead, and the prompt closes when it registers.
       let settled = false;
-      const registered = waitFor(async () => settled || ((await list().catch(() => null))?.wakes || []).some((wake) => wake.agent === "grok-bot"))
-        .then((ok) => (ok ? { ok, line: "Grok registered its address" } : { ok, line: "Grok has not registered yet. When it has: npx tryharness agents test grok-bot" }));
-      const answer = await ui.waitOrType({ message: "Waiting for Grok to register its address", placeholder: "or type the address Grok gives you", until: registered });
+      const registered = waitFor(
+        async () =>
+          settled ||
+          ((await list().catch(() => null))?.wakes || []).some(
+            (wake) => wake.agent === "grok-bot"
+          )
+      ).then((ok) =>
+        ok
+          ? { ok, line: "Grok registered its address" }
+          : {
+              ok,
+              line: "Grok has not registered yet. When it has: npx tryharness agents test grok-bot",
+            }
+      );
+      const answer = await ui.waitOrType({
+        message: "Waiting for Grok to register its address",
+        placeholder: "or type the address Grok gives you",
+        until: registered,
+      });
       let outcome = answer.done;
-      if (answer.cancelled) { settled = true; ui.info(`Stopped waiting. ${later("grok-bot")}`); return; }
-      if (answer.value && ownAddress(answer.value)) { settled = true; ui.warn(`${ownAddress(answer.value)}. ${later("grok-bot")}`); return; }
+      if (answer.cancelled) {
+        settled = true;
+        ui.info(`Stopped waiting. ${later("grok-bot")}`);
+        return;
+      }
+      if (answer.value && ownAddress(answer.value)) {
+        settled = true;
+        ui.warn(`${ownAddress(answer.value)}. ${later("grok-bot")}`);
+        return;
+      }
       if (answer.value) address = answer.value;
       else if (!outcome) {
         const spin = ui.spinner();
@@ -157,25 +379,54 @@ async function setupGrok({ ui, daemonRequest, clipboard }) {
       settled = true;
       if (outcome && !outcome.ok) return;
     }
-    if (address && !(await save({ channel: "email", address: address.trim() }, (saved) => `Saved. Harness wakes Grok at ${saved.wake?.address ?? address.trim()}`))) return;
+    if (
+      address &&
+      !(await save(
+        { channel: "email", address: address.trim() },
+        (saved) =>
+          `Saved. Harness wakes Grok at ${saved.wake?.address ?? address.trim()}`
+      ))
+    )
+      return;
   }
   await testAgent({ agent: "grok-bot", daemonRequest, ui });
 }
 
 /** The whole "Your swarm" step. `only` limits it to one agent (npx tryharness agents setup <agent>). */
-export async function setupSwarm({ runtimeRoot, states = [], daemonRequest, ui = createUi(), only = null, clipboard = copy }) {
+export async function setupSwarm({
+  runtimeRoot,
+  states = [],
+  daemonRequest,
+  ui = createUi(),
+  only = null,
+  clipboard = copy,
+}) {
   const want = (agent) => !only || only === agent;
   if (!only && states.length) {
     const width = Math.max(...states.map((state) => state.agent.length));
-    const rows = states.map((state) => `${!state.installed ? pc.dim("–") : state.configured ? pc.green("✓") : pc.yellow("!")} ${state.agent.padEnd(width)}  ${pc.dim(state.detail)}`);
-    ui.step(`Coding agents on this computer ${pc.dim("· Harness starts them when work is posted")}\n${rows.join("\n")}`);
+    const rows = states.map(
+      (state) =>
+        `${!state.installed ? pc.dim("–") : state.configured ? pc.green("✓") : pc.yellow("!")} ${state.agent.padEnd(width)}  ${pc.dim(state.detail)}`
+    );
+    ui.step(
+      `Coding agents on this computer ${pc.dim("· Harness starts them when work is posted")}\n${rows.join("\n")}`
+    );
   }
-  const local = detectLocalAgents().filter((entry) => entry.found && want(entry.agent));
-  for (const entry of local) await setupLocal({ entry, runtimeRoot, ui, daemonRequest });
-  if (only && LABEL[only] && only !== "grok-bot" && !local.length) ui.warn(`${LABEL[only]} was not found on this computer.`);
+  const local = detectLocalAgents().filter(
+    (entry) => entry.found && want(entry.agent)
+  );
+  for (const entry of local)
+    await setupLocal({ entry, runtimeRoot, ui, daemonRequest });
+  if (only && LABEL[only] && only !== "grok-bot" && !local.length)
+    ui.warn(`${LABEL[only]} was not found on this computer.`);
   if (want("grok-bot")) {
-    ui.step(`Grok Bot ${pc.dim("· runs in its own cloud, woken by email or webhook")}`);
+    ui.step(
+      `Grok Bot ${pc.dim("· runs in its own cloud, woken by email or webhook")}`
+    );
     await setupGrok({ ui, daemonRequest, clipboard });
   }
-  if (!only) ui.info(`Bankr and Quotient run on Harness ${pc.dim("· nothing to set up")}`);
+  if (!only)
+    ui.info(
+      `Bankr and Quotient run on Harness ${pc.dim("· nothing to set up")}`
+    );
 }