tryharness 0.7.22 → 0.7.25

package/lib/adapters.mjs

@@ -11,48 +11,118 @@ export const AGENTS = MACHINE_RUNNERS;
 // join the machine's task board by launching the same stdio MCP under their own name.
 export const MCP_CLIENTS = ["grok-bot"];
 const MCP_CLIENT_APPS = {
-  "grok-bot": { darwin: ["/Applications/Grok Bot.app", path.join(os.homedir(), "Applications", "Grok Bot.app")] },
+  "grok-bot": {
+    darwin: [
+      "/Applications/Grok Bot.app",
+      path.join(os.homedir(), "Applications", "Grok Bot.app"),
+    ],
+  },
 };
 
 // Agents that run in their own cloud but have an app here, where Open brings them forward. The app is checked to be that
 // agent's (its bundle id is in Info.plist, binary or XML), so another app with the same name is never opened as it.
 const AGENT_APPS = {
-  muse: { name: "Muse", bundle: "com.meta.endo", darwin: ["/Applications/Muse.app", path.join(os.homedir(), "Applications", "Muse.app")] },
+  muse: {
+    name: "Muse",
+    bundle: "com.meta.endo",
+    darwin: [
+      "/Applications/Muse.app",
+      path.join(os.homedir(), "Applications", "Muse.app"),
+    ],
+  },
 };
-export function detectAgentApps({ platform = process.platform, exists = fs.existsSync, read = (file) => fs.readFileSync(file, "latin1") } = {}) {
+export function detectAgentApps({
+  platform = process.platform,
+  exists = fs.existsSync,
+  read = (file) => fs.readFileSync(file, "latin1"),
+} = {}) {
   return Object.entries(AGENT_APPS).flatMap(([agent, app]) => {
-    const found = (app[platform] || []).find((candidate) => exists(candidate) && (() => { try { return read(path.join(candidate, "Contents", "Info.plist")).includes(app.bundle); } catch { return false; } })());
+    const found = (app[platform] || []).find(
+      (candidate) =>
+        exists(candidate) &&
+        (() => {
+          try {
+            return read(
+              path.join(candidate, "Contents", "Info.plist")
+            ).includes(app.bundle);
+          } catch {
+            return false;
+          }
+        })()
+    );
     return found ? [{ agent, name: app.name, path: found }] : [];
   });
 }
 
-export function detectMcpClients({ platform = process.platform, exists = fs.existsSync } = {}) {
-  return MCP_CLIENTS.map((client) => ({ client, path: (MCP_CLIENT_APPS[client][platform] || []).find((candidate) => exists(candidate)) || null }));
+export function detectMcpClients({
+  platform = process.platform,
+  exists = fs.existsSync,
+} = {}) {
+  return MCP_CLIENTS.map((client) => ({
+    client,
+    path:
+      (MCP_CLIENT_APPS[client][platform] || []).find((candidate) =>
+        exists(candidate)
+      ) || null,
+  }));
 }
 
 // Grok Bot keeps its MCP server list in its account and writes it only from its own settings
 // (a one-server JSON paste); there is no file on disk to write. The snippet is the setup.
-export function mcpClientSnippet({ runtimeRoot, client, nodePath = process.execPath }) {
-  return { mcpServers: { harness: { command: nodePath, args: [path.join(runtimeRoot, "lib", "mcp-stdio.mjs"), "--agent", client] } } };
+export function mcpClientSnippet({
+  runtimeRoot,
+  client,
+  nodePath = process.execPath,
+}) {
+  return {
+    mcpServers: {
+      harness: {
+        command: nodePath,
+        args: [
+          path.join(runtimeRoot, "lib", "mcp-stdio.mjs"),
+          "--agent",
+          client,
+        ],
+      },
+    },
+  };
 }
 
 // An extension or plugin runs inside its agent and starts Harness from the runtime and Node setup used, as the hooks
 // and MCP entries written here do.
-function installAsset(source, target, { runtimeRoot, nodePath = process.execPath }) {
+function installAsset(
+  source,
+  target,
+  { runtimeRoot, nodePath = process.execPath }
+) {
   ensureDir(path.dirname(target));
-  const text = fs.readFileSync(source, "utf8").replaceAll('"__HARNESS_RUNTIME__"', JSON.stringify(runtimeRoot)).replaceAll('"__HARNESS_NODE__"', JSON.stringify(nodePath));
+  const text = fs
+    .readFileSync(source, "utf8")
+    .replaceAll('"__HARNESS_RUNTIME__"', JSON.stringify(runtimeRoot))
+    .replaceAll('"__HARNESS_NODE__"', JSON.stringify(nodePath));
   fs.writeFileSync(target, text, { mode: 0o600 });
-  try { fs.chmodSync(target, 0o600); } catch {}
+  try {
+    fs.chmodSync(target, 0o600);
+  } catch {}
 }
 
 function diagnostic(result) {
-  return (result.stderr || result.stdout || result.error || "command failed").replace(/\s+/g, " ").trim().slice(0, 240);
+  return (result.stderr || result.stdout || result.error || "command failed")
+    .replace(/\s+/g, " ")
+    .trim()
+    .slice(0, 240);
 }
 
 export function integrationAssets(homeDir = os.homedir()) {
   return {
     pi: path.join(homeDir, ".pi", "agent", "extensions", "tryharness.ts"),
-    opencode: path.join(homeDir, ".config", "opencode", "plugins", "tryharness.js"),
+    opencode: path.join(
+      homeDir,
+      ".config",
+      "opencode",
+      "plugins",
+      "tryharness.js"
+    ),
   };
 }
 
@@ -62,23 +132,74 @@ export function integrationAssets(homeDir = os.homedir()) {
 export function claudeSettingsPath(homeDir = os.homedir()) {
   return path.join(homeDir, ".claude", "settings.json");
 }
-const isHarnessHook = (entry) => JSON.stringify(entry).includes("/lib/nudge.mjs");
+const isHarnessHook = (entry) =>
+  JSON.stringify(entry).includes("/lib/nudge.mjs");
 
-export function installClaudeSessionHook({ runtimeRoot, homeDir = os.homedir(), nodePath = process.execPath }) {
+export function installClaudeSessionHook({
+  runtimeRoot,
+  homeDir = os.homedir(),
+  nodePath = process.execPath,
+}) {
   const file = claudeSettingsPath(homeDir);
   const settings = readJson(file, {});
-  const hooks = settings.hooks && typeof settings.hooks === "object" ? settings.hooks : {};
+  const hooks =
+    settings.hooks && typeof settings.hooks === "object" ? settings.hooks : {};
   const nudge = JSON.stringify(path.join(runtimeRoot, "lib", "nudge.mjs"));
-  const starts = (Array.isArray(hooks.SessionStart) ? hooks.SessionStart : []).filter((entry) => !isHarnessHook(entry));
-  starts.push({ hooks: [{ type: "command", command: `${JSON.stringify(nodePath)} ${nudge} --agent claude-code`, timeout: 10 }] });
+  const starts = (
+    Array.isArray(hooks.SessionStart) ? hooks.SessionStart : []
+  ).filter((entry) => !isHarnessHook(entry));
+  starts.push({
+    hooks: [
+      {
+        type: "command",
+        command: `${JSON.stringify(nodePath)} ${nudge} --agent claude-code`,
+        timeout: 10,
+      },
+    ],
+  });
   // Mid-session: on every prompt, one line only when the queue changed since the session last saw it.
-  const prompts = (Array.isArray(hooks.UserPromptSubmit) ? hooks.UserPromptSubmit : []).filter((entry) => !isHarnessHook(entry));
-  prompts.push({ hooks: [{ type: "command", command: `${JSON.stringify(nodePath)} ${nudge} --agent claude-code --if-changed`, timeout: 10 }] });
+  const prompts = (
+    Array.isArray(hooks.UserPromptSubmit) ? hooks.UserPromptSubmit : []
+  ).filter((entry) => !isHarnessHook(entry));
+  prompts.push({
+    hooks: [
+      {
+        type: "command",
+        command: `${JSON.stringify(nodePath)} ${nudge} --agent claude-code --if-changed`,
+        timeout: 10,
+      },
+    ],
+  });
   // When a turn ends: a message the person sent this session from Harness keeps it going.
-  const stops = (Array.isArray(hooks.Stop) ? hooks.Stop : []).filter((entry) => !isHarnessHook(entry));
-  stops.push({ hooks: [{ type: "command", command: `${JSON.stringify(nodePath)} ${nudge} --agent claude-code --stop`, timeout: 10 }] });
+  const stops = (Array.isArray(hooks.Stop) ? hooks.Stop : []).filter(
+    (entry) => !isHarnessHook(entry)
+  );
+  stops.push({
+    hooks: [
+      {
+        type: "command",
+        command: `${JSON.stringify(nodePath)} ${nudge} --agent claude-code --stop`,
+        timeout: 10,
+      },
+    ],
+  });
   ensureDir(path.dirname(file));
-  fs.writeFileSync(file, JSON.stringify({ ...settings, hooks: { ...hooks, SessionStart: starts, UserPromptSubmit: prompts, Stop: stops } }, null, 2) + "\n");
+  fs.writeFileSync(
+    file,
+    JSON.stringify(
+      {
+        ...settings,
+        hooks: {
+          ...hooks,
+          SessionStart: starts,
+          UserPromptSubmit: prompts,
+          Stop: stops,
+        },
+      },
+      null,
+      2
+    ) + "\n"
+  );
 }
 
 // Codex reads the same hook shape from ~/.codex/hooks.json (SessionStart, UserPromptSubmit and Stop,
@@ -88,19 +209,71 @@ export function codexHooksPath(homeDir = os.homedir()) {
   return path.join(homeDir, ".codex", "hooks.json");
 }
 
-export function installCodexHooks({ runtimeRoot, homeDir = os.homedir(), nodePath = process.execPath }) {
+export function installCodexHooks({
+  runtimeRoot,
+  homeDir = os.homedir(),
+  nodePath = process.execPath,
+}) {
   const file = codexHooksPath(homeDir);
   const settings = readJson(file, {});
-  const hooks = settings.hooks && typeof settings.hooks === "object" ? settings.hooks : {};
+  const hooks =
+    settings.hooks && typeof settings.hooks === "object" ? settings.hooks : {};
   const nudge = JSON.stringify(path.join(runtimeRoot, "lib", "nudge.mjs"));
-  const starts = (Array.isArray(hooks.SessionStart) ? hooks.SessionStart : []).filter((entry) => !isHarnessHook(entry));
-  starts.push({ matcher: "startup|resume", hooks: [{ type: "command", command: `${JSON.stringify(nodePath)} ${nudge} --agent codex`, statusMessage: "Reading the Harness board", timeout: 10 }] });
-  const prompts = (Array.isArray(hooks.UserPromptSubmit) ? hooks.UserPromptSubmit : []).filter((entry) => !isHarnessHook(entry));
-  prompts.push({ hooks: [{ type: "command", command: `${JSON.stringify(nodePath)} ${nudge} --agent codex --if-changed`, timeout: 10 }] });
-  const stops = (Array.isArray(hooks.Stop) ? hooks.Stop : []).filter((entry) => !isHarnessHook(entry));
-  stops.push({ hooks: [{ type: "command", command: `${JSON.stringify(nodePath)} ${nudge} --agent codex --stop`, timeout: 10 }] });
+  const starts = (
+    Array.isArray(hooks.SessionStart) ? hooks.SessionStart : []
+  ).filter((entry) => !isHarnessHook(entry));
+  starts.push({
+    matcher: "startup|resume",
+    hooks: [
+      {
+        type: "command",
+        command: `${JSON.stringify(nodePath)} ${nudge} --agent codex`,
+        statusMessage: "Reading the Harness board",
+        timeout: 10,
+      },
+    ],
+  });
+  const prompts = (
+    Array.isArray(hooks.UserPromptSubmit) ? hooks.UserPromptSubmit : []
+  ).filter((entry) => !isHarnessHook(entry));
+  prompts.push({
+    hooks: [
+      {
+        type: "command",
+        command: `${JSON.stringify(nodePath)} ${nudge} --agent codex --if-changed`,
+        timeout: 10,
+      },
+    ],
+  });
+  const stops = (Array.isArray(hooks.Stop) ? hooks.Stop : []).filter(
+    (entry) => !isHarnessHook(entry)
+  );
+  stops.push({
+    hooks: [
+      {
+        type: "command",
+        command: `${JSON.stringify(nodePath)} ${nudge} --agent codex --stop`,
+        timeout: 10,
+      },
+    ],
+  });
   ensureDir(path.dirname(file));
-  fs.writeFileSync(file, JSON.stringify({ ...settings, hooks: { ...hooks, SessionStart: starts, UserPromptSubmit: prompts, Stop: stops } }, null, 2) + "\n");
+  fs.writeFileSync(
+    file,
+    JSON.stringify(
+      {
+        ...settings,
+        hooks: {
+          ...hooks,
+          SessionStart: starts,
+          UserPromptSubmit: prompts,
+          Stop: stops,
+        },
+      },
+      null,
+      2
+    ) + "\n"
+  );
 }
 
 export function removeCodexHooks(homeDir = os.homedir()) {
@@ -109,9 +282,13 @@ export function removeCodexHooks(homeDir = os.homedir()) {
   if (!settings?.hooks) return;
   const hooks = { ...settings.hooks };
   for (const event of ["SessionStart", "UserPromptSubmit", "Stop"]) {
-    if (Array.isArray(hooks[event])) hooks[event] = hooks[event].filter((entry) => !isHarnessHook(entry));
+    if (Array.isArray(hooks[event]))
+      hooks[event] = hooks[event].filter((entry) => !isHarnessHook(entry));
   }
-  fs.writeFileSync(file, JSON.stringify({ ...settings, hooks }, null, 2) + "\n");
+  fs.writeFileSync(
+    file,
+    JSON.stringify({ ...settings, hooks }, null, 2) + "\n"
+  );
 }
 
 export function removeClaudeSessionHook(homeDir = os.homedir()) {
@@ -120,12 +297,22 @@ export function removeClaudeSessionHook(homeDir = os.homedir()) {
   if (!settings?.hooks) return;
   const hooks = { ...settings.hooks };
   for (const event of ["SessionStart", "UserPromptSubmit", "Stop"]) {
-    if (Array.isArray(hooks[event])) hooks[event] = hooks[event].filter((entry) => !isHarnessHook(entry));
+    if (Array.isArray(hooks[event]))
+      hooks[event] = hooks[event].filter((entry) => !isHarnessHook(entry));
   }
-  fs.writeFileSync(file, JSON.stringify({ ...settings, hooks }, null, 2) + "\n");
+  fs.writeFileSync(
+    file,
+    JSON.stringify({ ...settings, hooks }, null, 2) + "\n"
+  );
 }
 
-export function configureAgents({ runtimeRoot, selected = AGENTS, homeDir = os.homedir(), detected = detectAgents(), execute = run }) {
+export function configureAgents({
+  runtimeRoot,
+  selected = AGENTS,
+  homeDir = os.homedir(),
+  detected = detectAgents(),
+  execute = run,
+}) {
   const byAgent = new Map(detected.map((entry) => [entry.agent, entry]));
   const mcpPath = path.join(runtimeRoot, "lib", "mcp-stdio.mjs");
   const assets = integrationAssets(homeDir);
@@ -133,34 +320,119 @@ export function configureAgents({ runtimeRoot, selected = AGENTS, homeDir = os.h
   for (const agent of AGENTS) {
     const found = byAgent.get(agent);
     if (!found?.path) {
-      states.push({ agent, installed: false, configured: false, detail: "not installed" });
+      states.push({
+        agent,
+        installed: false,
+        configured: false,
+        detail: "not installed",
+      });
       continue;
     }
     if (!selected.includes(agent)) {
-      states.push({ agent, installed: true, configured: false, detail: "not selected" });
+      states.push({
+        agent,
+        installed: true,
+        configured: false,
+        detail: "not selected",
+      });
       continue;
     }
     if (agent === "claude-code") {
       execute(found.path, ["mcp", "remove", "--scope", "user", "harness"]);
-      const added = execute(found.path, ["mcp", "add", "--scope", "user", "harness", "--", process.execPath, mcpPath, "--agent", agent]);
+      const added = execute(found.path, [
+        "mcp",
+        "add",
+        "--scope",
+        "user",
+        "harness",
+        "--",
+        process.execPath,
+        mcpPath,
+        "--agent",
+        agent,
+      ]);
       let hooked = true;
-      try { installClaudeSessionHook({ runtimeRoot, homeDir }); } catch { hooked = false; }
-      states.push({ agent, installed: true, configured: added.ok, detail: added.ok ? (hooked ? "MCP and session-start nudge configured" : "MCP configured; the session-start hook could not be written") : diagnostic(added) });
+      try {
+        installClaudeSessionHook({ runtimeRoot, homeDir });
+      } catch {
+        hooked = false;
+      }
+      states.push({
+        agent,
+        installed: true,
+        configured: added.ok,
+        detail: added.ok
+          ? hooked
+            ? "MCP and session-start nudge configured"
+            : "MCP configured; the session-start hook could not be written"
+          : diagnostic(added),
+      });
     } else if (agent === "codex") {
       execute(found.path, ["mcp", "remove", "harness"]);
-      const added = execute(found.path, ["mcp", "add", "harness", "--", process.execPath, mcpPath, "--agent", agent]);
+      const added = execute(found.path, [
+        "mcp",
+        "add",
+        "harness",
+        "--",
+        process.execPath,
+        mcpPath,
+        "--agent",
+        agent,
+      ]);
       let hooked = true;
-      try { installCodexHooks({ runtimeRoot, homeDir }); } catch { hooked = false; }
-      states.push({ agent, installed: true, configured: added.ok, detail: added.ok ? (hooked ? "MCP and session hooks configured; in Codex run /hooks once to trust them" : "MCP configured; the session hooks could not be written") : diagnostic(added) });
+      try {
+        installCodexHooks({ runtimeRoot, homeDir });
+      } catch {
+        hooked = false;
+      }
+      states.push({
+        agent,
+        installed: true,
+        configured: added.ok,
+        detail: added.ok
+          ? hooked
+            ? "MCP and session hooks configured; in Codex run /hooks once to trust them"
+            : "MCP configured; the session hooks could not be written"
+          : diagnostic(added),
+      });
     } else if (agent === "pi") {
       // pi has no MCP client: the extension starts the same stdio server and gives pi its tools.
-      installAsset(path.join(runtimeRoot, "assets", "pi-extension.ts"), assets.pi, { runtimeRoot });
-      states.push({ agent, installed: true, configured: fs.existsSync(assets.pi), detail: "extension installed" });
+      installAsset(
+        path.join(runtimeRoot, "assets", "pi-extension.ts"),
+        assets.pi,
+        { runtimeRoot }
+      );
+      states.push({
+        agent,
+        installed: true,
+        configured: fs.existsSync(assets.pi),
+        detail: "extension installed",
+      });
     } else {
-      installAsset(path.join(runtimeRoot, "assets", "opencode-plugin.js"), assets.opencode, { runtimeRoot });
+      installAsset(
+        path.join(runtimeRoot, "assets", "opencode-plugin.js"),
+        assets.opencode,
+        { runtimeRoot }
+      );
       // The same stdio server as Claude Code and Codex. opencode has no `mcp remove`; `mcp add` replaces the entry.
-      const added = execute(found.path, ["mcp", "add", "harness", "--", process.execPath, mcpPath, "--agent", agent]);
-      states.push({ agent, installed: true, configured: added.ok, detail: added.ok ? "MCP and plugin configured" : `plugin installed; MCP: ${diagnostic(added)}` });
+      const added = execute(found.path, [
+        "mcp",
+        "add",
+        "harness",
+        "--",
+        process.execPath,
+        mcpPath,
+        "--agent",
+        agent,
+      ]);
+      states.push({
+        agent,
+        installed: true,
+        configured: added.ok,
+        detail: added.ok
+          ? "MCP and plugin configured"
+          : `plugin installed; MCP: ${diagnostic(added)}`,
+      });
     }
   }
   return states;
@@ -170,11 +442,20 @@ export function agentHealth(states) {
   return Object.fromEntries(states.map((state) => [state.agent, state]));
 }
 
-export function removeAgentConfigurations({ homeDir = os.homedir(), detected = detectAgents(), execute = run } = {}) {
+export function removeAgentConfigurations({
+  homeDir = os.homedir(),
+  detected = detectAgents(),
+  execute = run,
+} = {}) {
   for (const found of detected) {
     if (!found.path) continue;
-    if (found.agent === "claude-code") { execute(found.path, ["mcp", "remove", "--scope", "user", "harness"]); removeClaudeSessionHook(homeDir); }
-    else if (found.agent === "codex") { execute(found.path, ["mcp", "remove", "harness"]); removeCodexHooks(homeDir); }
+    if (found.agent === "claude-code") {
+      execute(found.path, ["mcp", "remove", "--scope", "user", "harness"]);
+      removeClaudeSessionHook(homeDir);
+    } else if (found.agent === "codex") {
+      execute(found.path, ["mcp", "remove", "harness"]);
+      removeCodexHooks(homeDir);
+    }
   }
   // opencode has no `mcp remove`, so its entry comes out of the config file `mcp add` wrote it to.
   for (const name of ["opencode.json", "opencode.jsonc"]) {
@@ -186,7 +467,9 @@ export function removeAgentConfigurations({ homeDir = os.homedir(), detected = d
   }
   const assets = integrationAssets(homeDir);
   for (const target of Object.values(assets)) {
-    try { fs.unlinkSync(target); } catch (error) {
+    try {
+      fs.unlinkSync(target);
+    } catch (error) {
       if (error?.code !== "ENOENT") throw error;
     }
   }