tryharness 0.7.23 → 0.7.25

package/lib/nudge.mjs

@@ -18,16 +18,50 @@ export function nudgeText(agent, tasks, unread = [], goals = [], swarm = "") {
 }
 
 function queueText(agent, tasks, unread, goals) {
-  const waiting = (tasks || []).filter((task) => task.status === "open" && (!task.target_agent || task.target_agent === agent));
-  const held = (tasks || []).filter((task) => task.claimed_by === agent && (task.status === "claimed" || task.status === "needs_input"));
-  if (!waiting.length && !held.length && !unread.length && !goals.length) return "";
-  const line = (task) => `- ${task.id}: ${task.objective}${task.origin_agent ? ` (from ${task.trust === "agent" && task.origin_chain?.length > 1 ? task.origin_chain.join(" → ") : task.origin_agent}${task.trust === "agent" ? ", agent-written" : ""})` : ""}${task.status === "needs_input" ? " · your question was answered" : ""}${task.thread_with ? ` · shared with ${task.thread_with}` : ""}`;
+  const waiting = (tasks || []).filter(
+    (task) =>
+      task.status === "open" &&
+      (!task.target_agent || task.target_agent === agent)
+  );
+  const held = (tasks || []).filter(
+    (task) =>
+      task.claimed_by === agent &&
+      (task.status === "claimed" || task.status === "needs_input")
+  );
+  if (!waiting.length && !held.length && !unread.length && !goals.length)
+    return "";
+  const line = (task) =>
+    `- ${task.id}: ${task.objective}${task.origin_agent ? ` (from ${task.trust === "agent" && task.origin_chain?.length > 1 ? task.origin_chain.join(" → ") : task.origin_agent}${task.trust === "agent" ? ", agent-written" : ""})` : ""}${task.status === "needs_input" ? " · your question was answered" : ""}${task.thread_with ? ` · shared with ${task.thread_with}` : ""}`;
   const parts = ["Harness task board:"];
-  if (waiting.length) parts.push(`${waiting.length} task${waiting.length === 1 ? "" : "s"} waiting for you:`, ...waiting.slice(0, 5).map(line));
-  if (held.length) parts.push(`${held.length} you already claimed:`, ...held.slice(0, 5).map(line));
-  if (unread.length) parts.push(...unread.slice(0, 5).map((row) => `- ${row.task_id}: ${row.count} new message${row.count === 1 ? "" : "s"} from ${row.sender} on "${row.objective}" (read_thread)`));
-  if (goals.length) parts.push(`You are on ${goals.length} goal room${goals.length === 1 ? "" : "s"} (read_room to catch up, post_to_room to contribute):`, ...goals.slice(0, 5).map((goal) => `- ${goal.id}: ${goal.objective} · ${goal.posts} posts`));
-  parts.push("Read one with get_task, claim it with claim_task before working, and report_task when done or stuck.");
+  if (waiting.length)
+    parts.push(
+      `${waiting.length} task${waiting.length === 1 ? "" : "s"} waiting for you:`,
+      ...waiting.slice(0, 5).map(line)
+    );
+  if (held.length)
+    parts.push(
+      `${held.length} you already claimed:`,
+      ...held.slice(0, 5).map(line)
+    );
+  if (unread.length)
+    parts.push(
+      ...unread
+        .slice(0, 5)
+        .map(
+          (row) =>
+            `- ${row.task_id}: ${row.count} new message${row.count === 1 ? "" : "s"} from ${row.sender} on "${row.objective}" (read_thread)`
+        )
+    );
+  if (goals.length)
+    parts.push(
+      `You are on ${goals.length} goal room${goals.length === 1 ? "" : "s"} (read_room to catch up, post_to_room to contribute):`,
+      ...goals
+        .slice(0, 5)
+        .map((goal) => `- ${goal.id}: ${goal.objective} · ${goal.posts} posts`)
+    );
+  parts.push(
+    "Read one with get_task, claim it with claim_task before working, and report_task when done or stuck."
+  );
   return parts.join("\n");
 }
 
@@ -35,17 +69,35 @@ function queueText(agent, tasks, unread, goals) {
 export function queueDigest(agent, tasks, unread = [], goals = []) {
   return [
     ...(tasks || [])
-      .filter((task) => (task.status === "open" && (!task.target_agent || task.target_agent === agent)) || (task.claimed_by === agent && ["claimed", "needs_input"].includes(task.status)))
+      .filter(
+        (task) =>
+          (task.status === "open" &&
+            (!task.target_agent || task.target_agent === agent)) ||
+          (task.claimed_by === agent &&
+            ["claimed", "needs_input"].includes(task.status))
+      )
       .map((task) => `${task.id}:${task.status}:${task.version}`),
     ...unread.map((row) => `${row.task_id}:unread:${row.count}`),
     ...goals.map((goal) => `${goal.id}:goal:${goal.posts}`),
-  ].sort().join("|");
+  ]
+    .sort()
+    .join("|");
 }
 
 export async function boardQueue(agent) {
   try {
-    const response = await daemonRequest({ command: "board.list", agent, unread: true, swarm: true }, 1_500);
-    return response?.ok ? { tasks: response.tasks, unread: response.unread || [], goals: response.goals || [], swarm: response.swarm || null } : null;
+    const response = await daemonRequest(
+      { command: "board.list", agent, unread: true, swarm: true },
+      1_500
+    );
+    return response?.ok
+      ? {
+          tasks: response.tasks,
+          unread: response.unread || [],
+          goals: response.goals || [],
+          swarm: response.swarm || null,
+        }
+      : null;
   } catch {
     return null;
   }
@@ -53,15 +105,40 @@ export async function boardQueue(agent) {
 
 // What this agent was last told, in the Harness home: the queue's digest and the swarm's.
 const toldFile = (agent, homeDir) => path.join(homeDir, `nudge-${agent}.json`);
-function lastTold(agent, homeDir) { try { return JSON.parse(fs.readFileSync(toldFile(agent, homeDir), "utf8")); } catch { return {}; } }
-function noteTold(agent, homeDir, told) { try { fs.writeFileSync(toldFile(agent, homeDir), JSON.stringify({ ...lastTold(agent, homeDir), ...told, at: new Date().toISOString() }), { mode: 0o600 }); } catch {} }
+function lastTold(agent, homeDir) {
+  try {
+    return JSON.parse(fs.readFileSync(toldFile(agent, homeDir), "utf8"));
+  } catch {
+    return {};
+  }
+}
+function noteTold(agent, homeDir, told) {
+  try {
+    fs.writeFileSync(
+      toldFile(agent, homeDir),
+      JSON.stringify({
+        ...lastTold(agent, homeDir),
+        ...told,
+        at: new Date().toISOString(),
+      }),
+      { mode: 0o600 }
+    );
+  } catch {}
+}
 
 /** What a session is told when it starts: its queue and the whole swarm. */
 export async function boardNudge(agent, homeDir = paths.home) {
   const queue = await boardQueue(agent);
   if (!queue) return "";
-  if (queue.swarm?.digest) noteTold(agent, homeDir, { swarm: queue.swarm.digest });
-  return nudgeText(agent, queue.tasks, queue.unread, queue.goals, queue.swarm?.text || "");
+  if (queue.swarm?.digest)
+    noteTold(agent, homeDir, { swarm: queue.swarm.digest });
+  return nudgeText(
+    agent,
+    queue.tasks,
+    queue.unread,
+    queue.goals,
+    queue.swarm?.text || ""
+  );
 }
 
 // Only what changed since this agent last saw its queue: a hook that runs on every prompt
@@ -76,46 +153,90 @@ export async function boardNudgeIfChanged(agent, homeDir = paths.home) {
   const queueMoved = digest !== (last.digest ?? null);
   const swarmMoved = Boolean(swarm?.digest) && swarm.digest !== last.swarm;
   if (!queueMoved && !swarmMoved) return "";
-  noteTold(agent, homeDir, { digest, ...(swarm?.digest ? { swarm: swarm.digest } : {}) });
-  const told = !queueMoved ? "" : digest ? queueText(agent, tasks, unread, goals) : (last.digest ? "Harness task board: nothing waits for you now." : "");
+  noteTold(agent, homeDir, {
+    digest,
+    ...(swarm?.digest ? { swarm: swarm.digest } : {}),
+  });
+  const told = !queueMoved
+    ? ""
+    : digest
+      ? queueText(agent, tasks, unread, goals)
+      : last.digest
+        ? "Harness task board: nothing waits for you now."
+        : "";
   return [told, swarmMoved ? swarm.text : ""].filter(Boolean).join("\n\n");
 }
 
 // The prompt hook also tells the daemon the person typed in this session: the agent process is the hook's parent, or
 // its grandparent when the hook runs through a shell.
-export const PS = ["/bin/ps", "/usr/bin/ps"].find((file) => fs.existsSync(file)) || "ps";
+export const PS =
+  ["/bin/ps", "/usr/bin/ps"].find((file) => fs.existsSync(file)) || "ps";
 
 function agentPids() {
   const pids = [process.ppid];
-  try { const up = Number(spawnSync(PS, ["-o", "ppid=", "-p", String(process.ppid)], { encoding: "utf8" }).stdout.trim()); if (up > 1) pids.push(up); } catch {}
+  try {
+    const up = Number(
+      spawnSync(PS, ["-o", "ppid=", "-p", String(process.ppid)], {
+        encoding: "utf8",
+      }).stdout.trim()
+    );
+    if (up > 1) pids.push(up);
+  } catch {}
   return pids;
 }
 
 // Where the session runs, as its own environment says (the agent's, which the hook shares): places.mjs reads it.
-const placeOf = (input) => ({ sessionId: input?.session_id, folder: input?.cwd || process.cwd(), env: placeEnv(process.env) });
+const placeOf = (input) => ({
+  sessionId: input?.session_id,
+  folder: input?.cwd || process.cwd(),
+  env: placeEnv(process.env),
+});
 
 // An extension or plugin running inside the agent passes its own process ids.
 export async function notePrompt(agent, input = null, pids = agentPids()) {
-  try { await daemonRequest({ command: "board.prompted", agent, pids, ...(input?.session_id ? placeOf(input) : {}) }, 1_500); } catch {}
+  try {
+    await daemonRequest(
+      {
+        command: "board.prompted",
+        agent,
+        pids,
+        ...(input?.session_id ? placeOf(input) : {}),
+      },
+      1_500
+    );
+  } catch {}
 }
 
 /** A session starting says where it runs. */
 export async function notePlace(agent, input, pids = agentPids()) {
   if (!input?.session_id) return;
-  try { await daemonRequest({ command: "board.live.place", agent, pids, ...placeOf(input) }, 1_500); } catch {}
+  try {
+    await daemonRequest(
+      { command: "board.live.place", agent, pids, ...placeOf(input) },
+      1_500
+    );
+  } catch {}
 }
 
 /** A turn ended with nothing more to do: the session waits for the person, and the buddy can say so. */
 export async function noteTurn(agent, input, pids = agentPids()) {
   if (!input?.session_id) return;
-  try { await daemonRequest({ command: "board.live.turn", agent, pids, ...placeOf(input) }, 1_500); } catch {}
+  try {
+    await daemonRequest(
+      { command: "board.live.turn", agent, pids, ...placeOf(input) },
+      1_500
+    );
+  } catch {}
 }
 
 // What the person sent this session from Harness (daemon board.live.say), taken once.
 export async function takeMessages(agent, sessionId) {
   if (!sessionId) return [];
   try {
-    const response = await daemonRequest({ command: "board.live.take", agent, sessionId }, 1_500);
+    const response = await daemonRequest(
+      { command: "board.live.take", agent, sessionId },
+      1_500
+    );
     return response?.ok ? response.messages || [] : [];
   } catch {
     return [];
@@ -123,7 +244,11 @@ export async function takeMessages(agent, sessionId) {
 }
 
 export function messagesText(messages) {
-  return messages.map((message) => `The person sent you this from Harness:\n\n${message.text}`).join("\n\n");
+  return messages
+    .map(
+      (message) => `The person sent you this from Harness:\n\n${message.text}`
+    )
+    .join("\n\n");
 }
 
 // The JSON the agent hands every hook on stdin (session_id among it); null when there is none.
@@ -131,10 +256,23 @@ async function hookInput() {
   if (process.stdin.isTTY) return null;
   let text = "";
   process.stdin.setEncoding("utf8");
-  const read = new Promise((resolve) => { process.stdin.on("data", (chunk) => { text += chunk; }); process.stdin.on("end", resolve); process.stdin.on("error", resolve); });
-  await Promise.race([read, new Promise((resolve) => setTimeout(resolve, 1_000).unref())]);
+  const read = new Promise((resolve) => {
+    process.stdin.on("data", (chunk) => {
+      text += chunk;
+    });
+    process.stdin.on("end", resolve);
+    process.stdin.on("error", resolve);
+  });
+  await Promise.race([
+    read,
+    new Promise((resolve) => setTimeout(resolve, 1_000).unref()),
+  ]);
   process.stdin.destroy();
-  try { return JSON.parse(text); } catch { return null; }
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
 }
 
 if (import.meta.url === `file://${process.argv[1]}`) {
@@ -145,13 +283,26 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   if (process.argv.includes("--stop")) {
     // The Stop hook: a message waiting for this session keeps the agent going with it.
     const messages = await takeMessages(agent, sessionId);
-    if (messages.length) process.stdout.write(JSON.stringify({ decision: "block", reason: messagesText(messages) }) + "\n");
+    if (messages.length)
+      process.stdout.write(
+        JSON.stringify({ decision: "block", reason: messagesText(messages) }) +
+          "\n"
+      );
     else await noteTurn(agent, input);
   } else {
     if (process.argv.includes("--if-changed")) await notePrompt(agent, input);
     else await notePlace(agent, input);
-    const messages = process.argv.includes("--if-changed") ? await takeMessages(agent, sessionId) : [];
-    const text = [messages.length ? messagesText(messages) : "", process.argv.includes("--if-changed") ? await boardNudgeIfChanged(agent) : await boardNudge(agent)].filter(Boolean).join("\n\n");
+    const messages = process.argv.includes("--if-changed")
+      ? await takeMessages(agent, sessionId)
+      : [];
+    const text = [
+      messages.length ? messagesText(messages) : "",
+      process.argv.includes("--if-changed")
+        ? await boardNudgeIfChanged(agent)
+        : await boardNudge(agent),
+    ]
+      .filter(Boolean)
+      .join("\n\n");
     if (text) process.stdout.write(text + "\n");
   }
 }