botholomew 0.15.2 → 0.15.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "botholomew",
-  "version": "0.15.2",
+  "version": "0.15.4",
   "description": "An autonomous AI agent for knowledge work — works your task queue while you sleep.",
   "type": "module",
   "bin": {

package/src/chat/agent.ts

@@ -35,11 +35,13 @@ import {
 
 registerAllTools();
 
-/** Tools available in chat mode — no worker terminal tools (complete/fail/wait), no bulk-destructive file tools (delete, copy/move, dir ops) */
+/** Tools available in chat mode — no worker terminal tools (complete/fail/wait), no bulk-destructive file tools (copy/move, dir ops) */
 const CHAT_TOOL_NAMES = new Set([
   "create_task",
   "list_tasks",
   "view_task",
+  "update_task",
+  "delete_task",
   "context_info",
   "context_tree",
   "context_read",
@@ -156,6 +158,11 @@ export interface ChatTurnCallbacks {
     isError: boolean,
     meta?: ToolEndMeta,
   ) => void;
+  /** Side-effect notification from inside a tool ("Created subtask: …"). The
+   *  TUI renders these inside the tool-call card so they stay anchored to the
+   *  tool that produced them. Workers don't supply this; tools fall back to
+   *  `logger.info`. */
+  onToolNotify?: (toolUseId: string, message: string) => void;
   /** Called between LLM turns. The TUI returns any queued user messages so
    *  the agent can inject them into the running turn instead of waiting for
    *  the entire tool loop to finish. Each returned message is logged + pushed
@@ -406,6 +413,9 @@ export async function runChatTurn(input: {
           config,
           mcpxClient,
           shouldAbort: session ? () => session.aborted : undefined,
+          notify: callbacks.onToolNotify
+            ? (msg) => callbacks.onToolNotify?.(toolUse.id, msg)
+            : undefined,
         });
         const durationMs = Date.now() - start;
         const stored = maybeStoreResult(toolUse.name, result.output);
@@ -454,6 +464,7 @@ interface ChatToolCallCtx {
   config: Required<BotholomewConfig>;
   mcpxClient: McpxClient | null;
   shouldAbort?: () => boolean;
+  notify?: (message: string) => void;
 }
 
 async function executeChatToolCall(

package/src/commands/chat.ts

@@ -8,8 +8,9 @@ export function registerChatCommand(program: Command) {
       "Open the interactive chat TUI\n\n" +
         "  Tab navigation (Ctrl+<letter> from any tab):\n" +
         "    Ctrl+a  Chat        Ctrl+t  Tasks       Ctrl+w  Workers\n" +
-        "    Ctrl+o  Tools       Ctrl+r  Threads     Ctrl+g  Help\n" +
+        "    Ctrl+o  Tools       Ctrl+e  Threads     Ctrl+g  Help\n" +
         "    Ctrl+n  Context     Ctrl+s  Schedules   Esc     Return to Chat\n\n" +
+        "  Refresh: Ctrl+R refreshes Context · Tasks · Threads · Schedules · Workers\n\n" +
         "  Chat input:\n" +
         "    Enter          Send message\n" +
         "    ⌥+Enter        Insert newline\n" +

package/src/tools/schedule/create.ts

@@ -33,7 +33,9 @@ export const createScheduleTool = {
       description: input.description,
       frequency: input.frequency,
     });
-    logger.info(`Created schedule: ${schedule.name} (${schedule.id})`);
+    const msg = `Created schedule: ${schedule.name} (${schedule.id})`;
+    if (ctx.notify) ctx.notify(msg);
+    else logger.info(msg);
     return {
       id: schedule.id,
       name: schedule.name,

package/src/tools/task/create.ts

@@ -55,7 +55,9 @@ export const createTaskTool = {
         blocked_by: input.blocked_by,
         context_paths: input.context_paths,
       });
-      logger.info(`Created subtask: ${newTask.name} (${newTask.id})`);
+      const msg = `Created subtask: ${newTask.name} (${newTask.id})`;
+      if (ctx.notify) ctx.notify(msg);
+      else logger.info(msg);
       return {
         id: newTask.id,
         name: newTask.name,

package/src/tools/task/delete.ts

@@ -44,7 +44,9 @@ export const deleteTaskTool = {
         is_error: true,
       };
     }
-    logger.info(`Deleted task: ${existing.name} (${existing.id})`);
+    const msg = `Deleted task: ${existing.name} (${existing.id})`;
+    if (ctx.notify) ctx.notify(msg);
+    else logger.info(msg);
     return {
       deleted_id: existing.id,
       message: `Deleted task "${existing.name}" (${existing.id})`,

package/src/tools/task/update.ts

@@ -91,7 +91,9 @@ export const updateTaskTool = {
       };
     }
 
-    logger.info(`Updated task: ${updated.name} (${updated.id})`);
+    const msg = `Updated task: ${updated.name} (${updated.id})`;
+    if (ctx.notify) ctx.notify(msg);
+    else logger.info(msg);
     return {
       task: {
         id: updated.id,

package/src/tools/tool.ts

@@ -22,6 +22,13 @@ export interface ToolContext {
    * Esc-to-abort by reading `session.aborted`. Workers leave this `undefined`.
    */
   shouldAbort?: () => boolean;
+  /**
+   * Chat-mode only. Tools call this to surface a short human-readable
+   * side-effect message (e.g. "Created subtask: …") that the TUI renders
+   * inside the tool-call card. Workers leave this `undefined`; tools fall
+   * back to `logger.info` so worker logs are unchanged.
+   */
+  notify?: (message: string) => void;
 }
 
 type ToolOutputBase = { is_error: z.ZodBoolean };

package/src/tui/App.tsx

@@ -65,7 +65,7 @@ const TAB_BY_CTRL_KEY: Record<string, TabId> = {
   o: 2, // t[o]ols
   n: 3, // co[n]text
   t: 4, // [t]asks
-  r: 5, // th[r]eads
+  e: 5, // thr[e]ads
   s: 6, // [s]chedules
   w: 7, // [w]orkers
   g: 8, // help (also catches Ctrl+/ on terminals that map it to BEL)
@@ -328,9 +328,18 @@ function AppInner({
               slashCommandsRef.current,
             );
             if (popupOpen) return;
+            // Ctrl+E edits a queued message when one is selected; only
+            // fall through to the Threads tab-jump when the queue is empty.
+            if (input === "e" && queuedMessagesRef.current.length > 0) {
+              // handled by the queue keybindings block below
+            } else {
+              setActiveTab(tabForKey);
+              return;
+            }
+          } else {
+            setActiveTab(tabForKey);
+            return;
           }
-          setActiveTab(tabForKey);
-          return;
         }
       }
 
@@ -476,6 +485,14 @@ function AppInner({
             }
             setActiveToolCalls([...pendingToolCalls]);
           },
+          onToolNotify: (id, message) => {
+            markActivityRef.current();
+            const tc = pendingToolCalls.find((t) => t.id === id);
+            if (tc) {
+              tc.notes = [...(tc.notes ?? []), message];
+              setActiveToolCalls([...pendingToolCalls]);
+            }
+          },
           onUsage: (info) => {
             setUsage(info);
           },

package/src/tui/components/ContextPanel.tsx

@@ -236,8 +236,9 @@ export const ContextPanel = memo(function ContextPanel({
         deleteConfirm.pressDelete(entry.path);
         return;
       }
-      if (input === "r") {
+      if (key.ctrl && (input === "r" || input === "R")) {
         refresh(currentPathRef.current);
+        return;
       }
     },
     { isActive },
@@ -367,7 +368,7 @@ export const ContextPanel = memo(function ContextPanel({
           <Text dimColor>
             {focus === "detail"
               ? "↑↓ scroll · ⇧↑↓ page · g/G top/bot · ← back to list"
-              : "↑↓ select · → drill in/enter detail · ← up · d delete (×2) · r refresh"}
+              : "↑↓ select · → drill in/enter detail · ← up · d delete (×2) · ^R refresh"}
           </Text>
         </Box>
       </Box>
@@ -400,7 +401,7 @@ function ContextDetailHeader({
   indexLoaded: boolean;
 }) {
   return (
-    <Box flexDirection="column">
+    <Box flexDirection="column" width="100%" backgroundColor={theme.headerBg}>
       <Box>
         <Text bold color="cyan" wrap="truncate-end">
           {entry.is_directory ? "📁" : "📄"} context/{entry.path}
@@ -441,9 +442,6 @@ function ContextDetailHeader({
           </Box>
         </>
       )}
-      <Box>
-        <Text dimColor>{"─".repeat(2)}</Text>
-      </Box>
     </Box>
   );
 }

package/src/tui/components/HelpPanel.tsx

@@ -56,7 +56,7 @@ export const HelpPanel = memo(function HelpPanel({
           {"  "}Ctrl+t{"         "}Tasks
         </Text>
         <Text>
-          {"  "}Ctrl+r{"         "}Threads
+          {"  "}Ctrl+e{"         "}Threads
         </Text>
         <Text>
           {"  "}Ctrl+s{"         "}Schedules
@@ -142,19 +142,21 @@ export const HelpPanel = memo(function HelpPanel({
           (cancels on any other key or after 3s)
         </Text>
         <Text>
-          {"  "}Tasks{"          "}f filter · p priority · d delete (×2) · r
-          refresh
+          {"  "}Ctrl+R{"         "}Refresh (Context · Tasks · Threads ·
+          Schedules · Workers)
+        </Text>
+        <Text>
+          {"  "}Tasks{"          "}f filter · p priority · d delete (×2)
         </Text>
         <Text>
           {"  "}Threads{"        "}f filter · s/ search · w follow · d delete
-          (×2) · r refresh
+          (×2)
         </Text>
         <Text>
-          {"  "}Schedules{"      "}f filter · e toggle · d delete (×2) · r
-          refresh
+          {"  "}Schedules{"      "}f filter · e toggle · d delete (×2)
         </Text>
         <Text>
-          {"  "}Context{"        "}d delete (×2) · r refresh
+          {"  "}Context{"        "}d delete (×2)
         </Text>
         <Text>
           {"  "}Workers{"        "}f filter · l toggle log/detail · d delete log

package/src/tui/components/SchedulePanel.tsx

@@ -207,7 +207,7 @@ export const SchedulePanel = memo(function SchedulePanel({
         deleteConfirm.pressDelete(s.name);
         return;
       }
-      if (input === "r") {
+      if (key.ctrl && (input === "r" || input === "R")) {
         forceRefresh();
         return;
       }
@@ -338,7 +338,7 @@ export const SchedulePanel = memo(function SchedulePanel({
         <Text dimColor>
           {focus === "detail"
             ? "↑↓ scroll · ⇧↑↓ page · g/G top/bot · ← back to list"
-            : "↑↓ select · → enter detail · f filter · e toggle · d delete (×2) · r refresh"}
+            : "↑↓ select · → enter detail · f filter · e toggle · d delete (×2) · ^R refresh"}
         </Text>
       </Box>
     </Box>
@@ -348,7 +348,7 @@ export const SchedulePanel = memo(function SchedulePanel({
 function ScheduleDetailHeader({ schedule }: { schedule: Schedule }) {
   const enabledKey = String(schedule.enabled);
   return (
-    <Box flexDirection="column">
+    <Box flexDirection="column" width="100%" backgroundColor={theme.headerBg}>
       <Box>
         <Text bold color={theme.info} wrap="truncate-end">
           {schedule.name}
@@ -367,9 +367,6 @@ function ScheduleDetailHeader({ schedule }: { schedule: Schedule }) {
           </Text>
         </Text>
       </Box>
-      <Box>
-        <Text dimColor>{"─".repeat(2)}</Text>
-      </Box>
     </Box>
   );
 }

package/src/tui/components/TaskPanel.tsx

@@ -241,7 +241,7 @@ export const TaskPanel = memo(function TaskPanel({
         deleteConfirm.pressDelete(t.name || t.id);
         return;
       }
-      if (input === "r") {
+      if (key.ctrl && (input === "r" || input === "R")) {
         forceRefresh();
         return;
       }
@@ -376,7 +376,7 @@ export const TaskPanel = memo(function TaskPanel({
         <Text dimColor>
           {focus === "detail"
             ? "↑↓ scroll · ⇧↑↓ page · g/G top/bot · ← back to list"
-            : "↑↓ select · → enter detail · f filter · p priority · d delete (×2) · r refresh"}
+            : "↑↓ select · → enter detail · f filter · p priority · d delete (×2) · ^R refresh"}
         </Text>
       </Box>
     </Box>
@@ -385,7 +385,7 @@ export const TaskPanel = memo(function TaskPanel({
 
 function TaskDetailHeader({ task }: { task: Task }) {
   return (
-    <Box flexDirection="column">
+    <Box flexDirection="column" width="100%" backgroundColor={theme.headerBg}>
       <Box>
         <Text bold color={theme.info} wrap="truncate-end">
           {task.name}
@@ -408,9 +408,6 @@ function TaskDetailHeader({ task }: { task: Task }) {
           </Text>
         </Text>
       </Box>
-      <Box>
-        <Text dimColor>{"─".repeat(2)}</Text>
-      </Box>
     </Box>
   );
 }

package/src/tui/components/ThreadPanel.tsx

@@ -394,7 +394,7 @@ export const ThreadPanel = memo(function ThreadPanel({
         deleteConfirm.pressDelete(t.title || "(untitled)");
         return;
       }
-      if (input === "r") {
+      if (key.ctrl && (input === "r" || input === "R")) {
         forceRefresh();
         return;
       }
@@ -575,7 +575,7 @@ export const ThreadPanel = memo(function ThreadPanel({
           <Text dimColor>
             {focus === "detail"
               ? "↑↓ scroll · ⇧↑↓ page · g/G top/bot · ← back to list"
-              : `↑↓ select · → enter detail · s search · f filter · d delete (×2)${selectedThread && !selectedThread.ended_at ? " · w follow" : ""} · r refresh`}
+              : `↑↓ select · → enter detail · s search · f filter · d delete (×2)${selectedThread && !selectedThread.ended_at ? " · w follow" : ""} · ^R refresh`}
           </Text>
         </Box>
       </Box>
@@ -591,7 +591,7 @@ function ThreadDetailHeader({
   isActiveThread: boolean;
 }) {
   return (
-    <Box flexDirection="column">
+    <Box flexDirection="column" width="100%" backgroundColor={theme.headerBg}>
       <Box>
         <Text wrap="truncate-end">
           <Text bold italic color={theme.info}>
@@ -625,9 +625,6 @@ function ThreadDetailHeader({
           </Text>
         </Text>
       </Box>
-      <Box>
-        <Text dimColor>{"─".repeat(2)}</Text>
-      </Box>
     </Box>
   );
 }

package/src/tui/components/ToolCall.tsx

@@ -40,6 +40,8 @@ export interface ToolCallData {
   timestamp: Date;
   largeResult?: LargeResultMeta;
   isError?: boolean;
+  /** Side-effect notes emitted by the tool (e.g. "Created subtask: …"). */
+  notes?: string[];
 }
 
 interface ToolCallProps {
@@ -106,6 +108,18 @@ export function ToolCall({ tool }: ToolCallProps) {
           {tool.largeResult.pages}pg]
         </Text>
       )}
+      {tool.notes?.map((note, i) => (
+        <Text
+          // biome-ignore lint/suspicious/noArrayIndexKey: notes are append-only
+          key={i}
+          color={theme.accent}
+          dimColor
+          wrap="truncate-end"
+        >
+          {"    ℹ "}
+          {note}
+        </Text>
+      ))}
     </Box>
   );
 }

package/src/tui/components/WorkerPanel.tsx

@@ -1,6 +1,6 @@
 import { basename } from "node:path";
 import { Box, Text, useInput, useStdout } from "ink";
-import { memo, useEffect, useMemo, useState } from "react";
+import { memo, useCallback, useEffect, useMemo, useState } from "react";
 import { readLogTail } from "../../worker/log-reader.ts";
 import {
   deleteWorkerLog,
@@ -70,6 +70,7 @@ export const WorkerPanel = memo(function WorkerPanel({
   const [workers, setWorkers] = useState<Worker[]>([]);
   const [selectedIndex, setSelectedIndex] = useState(0);
   const [filterIdx, setFilterIdx] = useState(0);
+  const [refreshTick, setRefreshTick] = useState(0);
   const [now, setNow] = useState(() => new Date());
   const [viewMode, setViewMode] = useState<"detail" | "log">("detail");
   const [logContent, setLogContent] = useState("");
@@ -79,6 +80,7 @@ export const WorkerPanel = memo(function WorkerPanel({
   const [logFollow, setLogFollow] = useState(true);
   const [focus, setFocus] = useState<FocusState>("list");
 
+  // biome-ignore lint/correctness/useExhaustiveDependencies: refreshTick triggers manual refresh
   useEffect(() => {
     let mounted = true;
 
@@ -104,7 +106,7 @@ export const WorkerPanel = memo(function WorkerPanel({
       mounted = false;
       clearInterval(interval);
     };
-  }, [projectDir, filterIdx]);
+  }, [projectDir, filterIdx, refreshTick]);
 
   const selected = workers[selectedIndex];
   const selectedLogPath = selected?.log_path ?? null;
@@ -171,6 +173,10 @@ export const WorkerPanel = memo(function WorkerPanel({
   const viewModeRef = useLatestRef(viewMode);
   const selectedLogPathRef = useLatestRef(selectedLogPath);
 
+  const forceRefresh = useCallback(() => {
+    setRefreshTick((t) => t + 1);
+  }, []);
+
   const deleteConfirm = useDeleteConfirm(() => {
     const path = selectedLogPathRef.current;
     if (!path) return;
@@ -238,6 +244,11 @@ export const WorkerPanel = memo(function WorkerPanel({
         deleteConfirm.pressDelete(`worker log: ${basename(path)}`);
         return;
       }
+
+      if (key.ctrl && (input === "r" || input === "R")) {
+        forceRefresh();
+        return;
+      }
     },
     { isActive },
   );
@@ -257,8 +268,8 @@ export const WorkerPanel = memo(function WorkerPanel({
           {focus === "detail"
             ? "  · ↑↓ scroll  ⇧↑↓ page  g/G top/bot  ← back to list  l toggle"
             : viewMode === "log"
-              ? "  · ↑↓ select  → enter log  l detail  f filter  d delete log (×2)"
-              : "  · ↑↓ select  → enter detail  l view log  f filter"}
+              ? "  · ↑↓ select  → enter log  l detail  f filter  d delete log (×2)  ^R refresh"
+              : "  · ↑↓ select  → enter detail  l view log  f filter  ^R refresh"}
         </Text>
       </Box>
       <DeleteArmedBanner

package/src/tui/theme.ts

@@ -49,6 +49,7 @@ export const theme = {
   accentBorder: isDark ? "yellow" : "#B8860B",
   userBg: isDark ? "#2a5a8c" : "#d0e0f0",
   selectionBg: isDark ? "#333" : "#ddd",
+  headerBg: isDark ? "#3a4655" : "#f5f7fa",
   success: "green",
   error: "red",
   info: "cyan",