@towles/tool 0.0.112 → 0.0.114

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@towles/tool",
-  "version": "0.0.112",
+  "version": "0.0.114",
   "description": "One off quality of life scripts that I use on a daily basis.",
   "homepage": "https://github.com/ChrisTowles/towles-tool#readme",
   "bugs": {

package/packages/agentboard/apps/tui/src/components/DetailPanel.tsx

@@ -252,6 +252,7 @@ function AgentListItem(props: AgentListItemProps) {
       return props.agent.status === "done" ? "✓" : props.agent.status === "error" ? "✗" : "⚠";
     if (props.agent.status === "running") return SPINNERS[props.spinIdx() % SPINNERS.length]!;
     if (props.agent.status === "waiting") return "◉";
+    if (props.agent.status === "question") return "?";
     return "○";
   };
 
@@ -270,6 +271,7 @@ function AgentListItem(props: AgentListItemProps) {
     if (props.agent.status === "error") return "error";
     if (props.agent.status === "interrupted") return "stopped";
     if (props.agent.status === "waiting") return "waiting";
+    if (props.agent.status === "question") return "question";
     return "";
   };
 

package/packages/agentboard/apps/tui/src/components/SessionCard.tsx

@@ -33,6 +33,8 @@ export function SessionCard(props: SessionCardProps) {
     if (s === "error") return P().red;
     if (s === "interrupted") return P().peach;
     if (s === "running") return P().yellow;
+    if (s === "waiting") return P().blue;
+    if (s === "question") return P().green;
     if (props.isFocused) return P().lavender;
     return "transparent";
   };
@@ -47,6 +49,8 @@ export function SessionCard(props: SessionCardProps) {
   const statusIcon = () => {
     const s = status();
     if (s === "running") return SPINNERS[props.spinIdx() % SPINNERS.length]!;
+    if (s === "waiting") return "◉";
+    if (s === "question") return "?";
     if (isUnseenTerminal()) return UNSEEN_ICON;
     return "";
   };

package/packages/agentboard/apps/tui/src/session-status.ts

@@ -7,7 +7,7 @@ export function computeSessionStatusCounts(sessions: SessionData[]): SessionStat
   let idle = 0;
   for (const s of sessions) {
     const status = s.agentState?.status;
-    if (status === "running" || status === "waiting") {
+    if (status === "running" || status === "waiting" || status === "question") {
       active++;
     } else if (status === "error") {
       error++;

package/packages/agentboard/packages/runtime/src/agents/tracker.ts

@@ -6,6 +6,7 @@ const TERMINAL_PRUNE_MS = 5 * 60 * 1000;
 
 const STATUS_PRIORITY: Record<string, number> = {
   running: 5,
+  question: 4,
   error: 4,
   interrupted: 3,
   waiting: 2,

package/packages/agentboard/packages/runtime/src/agents/watchers/claude-code.test.ts

@@ -2,13 +2,13 @@ import { describe, it, expect } from "bun:test";
 import { determineStatus } from "./claude-code";
 
 describe("determineStatus", () => {
-  it('returns "idle" when no message', () => {
-    expect(determineStatus({})).toBe("idle");
-    expect(determineStatus({ message: undefined })).toBe("idle");
+  it("returns null when no message", () => {
+    expect(determineStatus({})).toBeNull();
+    expect(determineStatus({ message: undefined })).toBeNull();
   });
 
-  it('returns "idle" when message has no role', () => {
-    expect(determineStatus({ message: { content: "hi" } })).toBe("idle");
+  it("returns null when message has no role", () => {
+    expect(determineStatus({ message: { content: "hi" } })).toBeNull();
   });
 
   it('returns "running" for user messages', () => {
@@ -53,11 +53,11 @@ describe("determineStatus", () => {
     ).toBe("done");
   });
 
-  it('returns "idle" for unknown roles', () => {
+  it("returns null for unknown roles", () => {
     expect(
       determineStatus({
         message: { role: "system", content: "system message" },
       }),
-    ).toBe("idle");
+    ).toBeNull();
   });
 });

package/packages/agentboard/packages/runtime/src/agents/watchers/claude-code.ts

@@ -47,9 +47,9 @@ const STALE_MS = 5 * 60 * 1000;
 
 // --- Status detection ---
 
-export function determineStatus(entry: JournalEntry): AgentStatus {
+export function determineStatus(entry: JournalEntry): AgentStatus | null {
   const msg = entry.message;
-  if (!msg?.role) return "idle";
+  if (!msg?.role) return null;
 
   const content = msg.content;
   const items: ContentItem[] = Array.isArray(content)
@@ -59,13 +59,15 @@ export function determineStatus(entry: JournalEntry): AgentStatus {
       : [];
 
   if (msg.role === "assistant") {
-    const hasToolUse = items.some((c) => c.type === "tool_use");
-    return hasToolUse ? "running" : "done";
+    const toolUses = items.filter((c) => c.type === "tool_use");
+    if (toolUses.length === 0) return "done";
+    const allAsking = toolUses.every((c) => (c as any).name === "AskUserQuestion");
+    return allAsking ? "question" : "running";
   }
 
   if (msg.role === "user") return "running";
 
-  return "idle";
+  return null;
 }
 
 function extractThreadName(entry: JournalEntry): string | undefined {
@@ -195,7 +197,7 @@ export class ClaudeCodeAgentWatcher implements AgentWatcher {
           const name = extractThreadName(entry);
           if (name) threadName = name;
         }
-        latestStatus = determineStatus(entry);
+        latestStatus = determineStatus(entry) ?? latestStatus;
       }
 
       // If "running" but journal file is stale, the process likely exited
@@ -238,7 +240,7 @@ export class ClaudeCodeAgentWatcher implements AgentWatcher {
         if (name) threadName = name;
       }
 
-      latestStatus = determineStatus(entry);
+      latestStatus = determineStatus(entry) ?? latestStatus;
     }
 
     const prevStatus = prev?.status;

package/packages/agentboard/packages/runtime/src/contracts/agent.ts

@@ -1,4 +1,4 @@
-export type AgentStatus = "idle" | "running" | "done" | "error" | "waiting" | "interrupted";
+export type AgentStatus = "idle" | "running" | "done" | "error" | "waiting" | "question" | "interrupted";
 
 export interface AgentEvent {
   agent: string;

package/packages/agentboard/packages/runtime/src/server/index.ts

@@ -187,6 +187,22 @@ export function startServer(
     return null;
   }
 
+  /** If any pane agent is alive for this session, override terminal agentState to waiting. */
+  function overrideTerminalIfPaneAlive(
+    sessionName: string,
+    state: AgentEvent | null,
+  ): AgentEvent | null {
+    if (!state || !TERMINAL_STATUSES.has(state.status)) return state;
+    const paneAgents = paneAgentsBySession.get(sessionName);
+    if (!paneAgents || paneAgents.size === 0) return state;
+    for (const presence of paneAgents.values()) {
+      if (presence.agent === state.agent && presence.threadId === state.threadId) {
+        return { ...state, status: "waiting" };
+      }
+    }
+    return state;
+  }
+
   /** Merge pane-detected agents into watcher-provided agents for a session.
    *  Watcher events take precedence — pane presence only adds synthetic entries
    *  for agents that aren't already tracked by watchers. */
@@ -205,12 +221,11 @@ export function startServer(
       const trackedIdx = trackedByKey.get(key);
 
       if (trackedIdx != null) {
-        // Watcher already tracks this agent — correct terminal statuses
-        // using pane liveness (process is confirmed alive, so terminal
-        // journal status is a between-turn artifact).
+        // Watcher already tracks this agent — process is confirmed alive,
+        // so terminal journal status means it's waiting for user input.
         const tracked = result[trackedIdx]!;
         if (TERMINAL_STATUSES.has(tracked.status)) {
-          tracked.status = "running";
+          tracked.status = "waiting";
           tracked.paneId = presence.paneId;
         }
         continue;
@@ -298,7 +313,7 @@ export function startServer(
           ports: getSessionPorts(name),
           windows,
           uptime,
-          agentState: tracker.getState(name),
+          agentState: overrideTerminalIfPaneAlive(name, tracker.getState(name)),
           agents: mergeAgentsWithPanePresence(name, tracker.getAgents(name)),
           eventTimestamps: tracker.getEventTimestamps(name),
           metadata: metadataStore.get(name),
@@ -1079,8 +1094,12 @@ export function startServer(
       const data = JSON.parse(readFileSync(join(sessionsDir, `${agentPid}.json`), "utf-8"));
       const threadId: string | undefined = data.sessionId;
       if (!threadId) return {};
-      // Try to get thread name and status from the journal
       const journalInfo = resolveClaudeCodeJournalInfo(threadId);
+      // Process is alive (found via process tree), so terminal journal status
+      // means it's waiting for user input.
+      if (journalInfo.status && TERMINAL_STATUSES.has(journalInfo.status)) {
+        journalInfo.status = "waiting";
+      }
       return { threadId, ...journalInfo };
     } catch {
       return {};
@@ -1119,10 +1138,16 @@ export function startServer(
                 if (t && !t.startsWith("<") && !t.startsWith("{")) threadName = t.slice(0, 80);
               }
 
-              // Determine status from last entry (same logic as ClaudeCodeAgentWatcher)
               if (msg.role === "assistant") {
                 const items = Array.isArray(msg.content) ? msg.content : [];
-                lastStatus = items.some((c: any) => c.type === "tool_use") ? "running" : "done";
+                const toolUses = items.filter((c: any) => c.type === "tool_use");
+                if (toolUses.length === 0) {
+                  lastStatus = "done";
+                } else {
+                  lastStatus = toolUses.every((c: any) => c.name === "AskUserQuestion")
+                    ? "question"
+                    : "running";
+                }
               } else if (msg.role === "user") {
                 lastStatus = "running";
               }

package/packages/agentboard/packages/runtime/src/server/pane-scanner.ts

@@ -100,9 +100,9 @@ function resolveClaudeCodePaneInfo(
     if (!threadId) return {};
     const journalInfo = resolveClaudeCodeJournalInfo(threadId);
     // Process is alive (found via process tree), so terminal journal status
-    // is a between-turn artifact — override to running.
+    // means it's waiting for user input.
     if (journalInfo.status && TERMINAL_STATUSES.has(journalInfo.status)) {
-      journalInfo.status = "running";
+      journalInfo.status = "waiting";
     }
     return { threadId, ...journalInfo };
   } catch {
@@ -143,7 +143,14 @@ function resolveClaudeCodeJournalInfo(threadId: string): {
 
             if (msg.role === "assistant") {
               const items = Array.isArray(msg.content) ? msg.content : [];
-              lastStatus = items.some((c: any) => c.type === "tool_use") ? "running" : "done";
+              const toolUses = items.filter((c: any) => c.type === "tool_use");
+              if (toolUses.length === 0) {
+                lastStatus = "done";
+              } else {
+                lastStatus = toolUses.every((c: any) => c.name === "AskUserQuestion")
+                  ? "question"
+                  : "running";
+              }
             } else if (msg.role === "user") {
               lastStatus = "running";
             }

package/packages/agentboard/packages/runtime/src/themes.ts

@@ -62,6 +62,7 @@ const CATPPUCCIN_MOCHA: Theme = {
     done: "#a6e3a1",
     error: "#f38ba8",
     waiting: "#89b4fa",
+    question: "#a6e3a1",
     interrupted: "#fab387",
   },
   icons: {
@@ -70,6 +71,7 @@ const CATPPUCCIN_MOCHA: Theme = {
     done: "✓",
     error: "✗",
     waiting: "◉",
+    question: "?",
     interrupted: "⚠",
   },
 };
@@ -104,6 +106,7 @@ const CATPPUCCIN_LATTE: Theme = {
     done: "#40a02b",
     error: "#d20f39",
     waiting: "#1e66f5",
+    question: "#40a02b",
     interrupted: "#fe640b",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -139,6 +142,7 @@ const TOKYO_NIGHT: Theme = {
     done: "#9ece6a",
     error: "#f7768e",
     waiting: "#7aa2f7",
+    question: "#9ece6a",
     interrupted: "#ff9e64",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -174,6 +178,7 @@ const GRUVBOX_DARK: Theme = {
     done: "#b8bb26",
     error: "#fb4934",
     waiting: "#83a598",
+    question: "#b8bb26",
     interrupted: "#fe8019",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -209,6 +214,7 @@ const NORD: Theme = {
     done: "#a3be8c",
     error: "#bf616a",
     waiting: "#81a1c1",
+    question: "#a3be8c",
     interrupted: "#d08770",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -244,6 +250,7 @@ const DRACULA: Theme = {
     done: "#50fa7b",
     error: "#ff5555",
     waiting: "#8be9fd",
+    question: "#50fa7b",
     interrupted: "#ffb86c",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -279,6 +286,7 @@ const CATPPUCCIN_FRAPPE: Theme = {
     done: "#a6d189",
     error: "#e78284",
     waiting: "#8da4e2",
+    question: "#a6d189",
     interrupted: "#ef9f76",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -314,6 +322,7 @@ const CATPPUCCIN_MACCHIATO: Theme = {
     done: "#a6da95",
     error: "#ed8796",
     waiting: "#8aadf4",
+    question: "#a6da95",
     interrupted: "#f5a97f",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -349,6 +358,7 @@ const GITHUB_DARK: Theme = {
     done: "#3fb950",
     error: "#f85149",
     waiting: "#58a6ff",
+    question: "#3fb950",
     interrupted: "#d29922",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -384,6 +394,7 @@ const ONE_DARK: Theme = {
     done: "#98c379",
     error: "#e06c75",
     waiting: "#61afef",
+    question: "#98c379",
     interrupted: "#d19a66",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -419,6 +430,7 @@ const KANAGAWA: Theme = {
     done: "#98BB6C",
     error: "#E82424",
     waiting: "#7E9CD8",
+    question: "#98BB6C",
     interrupted: "#FFA066",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -454,6 +466,7 @@ const EVERFOREST: Theme = {
     done: "#a7c080",
     error: "#e67e80",
     waiting: "#7fbbb3",
+    question: "#a7c080",
     interrupted: "#e69875",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -489,6 +502,7 @@ const MATERIAL: Theme = {
     done: "#c3e88d",
     error: "#f07178",
     waiting: "#82aaff",
+    question: "#c3e88d",
     interrupted: "#f78c6c",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -524,6 +538,7 @@ const COBALT2: Theme = {
     done: "#9eff80",
     error: "#ff0088",
     waiting: "#0088ff",
+    question: "#9eff80",
     interrupted: "#ff628c",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -559,6 +574,7 @@ const FLEXOKI: Theme = {
     done: "#879A39",
     error: "#D14D41",
     waiting: "#4385BE",
+    question: "#879A39",
     interrupted: "#DA702C",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -594,6 +610,7 @@ const AYU: Theme = {
     done: "#7FD962",
     error: "#D95757",
     waiting: "#59C2FF",
+    question: "#7FD962",
     interrupted: "#FF8F40",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -629,6 +646,7 @@ const AURA: Theme = {
     done: "#61ffca",
     error: "#ff6767",
     waiting: "#a277ff",
+    question: "#61ffca",
     interrupted: "#ffca85",
   },
   icons: CATPPUCCIN_MOCHA.icons,
@@ -664,6 +682,7 @@ const MATRIX: Theme = {
     done: "#62ff94",
     error: "#ff4b4b",
     waiting: "#30b3ff",
+    question: "#62ff94",
     interrupted: "#ffa83d",
   },
   icons: CATPPUCCIN_MOCHA.icons,

package/src/commands/agentboard.ts

@@ -1,6 +1,6 @@
 import { defineCommand } from "citty";
 import { execSync, spawn, spawnSync } from "node:child_process";
-import { readFileSync, writeFileSync, existsSync, realpathSync } from "node:fs";
+import { readFileSync, writeFileSync, existsSync, realpathSync, unlinkSync } from "node:fs";
 import { resolve } from "node:path";
 import consola from "consola";
 import { colors } from "consola/utils";
@@ -186,6 +186,23 @@ async function serverAlive(): Promise<boolean> {
   }
 }
 
+const PID_FILE = "/tmp/agentboard.pid";
+
+function stopServer(): boolean {
+  if (!existsSync(PID_FILE)) return false;
+  const pid = Number.parseInt(readFileSync(PID_FILE, "utf8").trim(), 10);
+  if (Number.isNaN(pid)) return false;
+  try {
+    process.kill(pid, "SIGTERM");
+  } catch {
+    // process already dead
+  }
+  try {
+    unlinkSync(PID_FILE);
+  } catch {}
+  return true;
+}
+
 async function ensureServerUp(): Promise<boolean> {
   if (await serverAlive()) return true;
 
@@ -374,7 +391,15 @@ async function restart(): Promise<void> {
     // no tmux or no sessions
   }
 
-  // 2. Ensure server is running
+  // 2. Stop existing server, then start fresh
+  const wasStopped = stopServer();
+  if (wasStopped) {
+    // Wait for port to free up
+    for (let i = 0; i < 20; i++) {
+      if (!(await serverAlive())) break;
+      await new Promise((r) => setTimeout(r, 100));
+    }
+  }
   if (!(await ensureServerUp())) {
     consola.error("Failed to start agentboard server");
     process.exit(1);