itermbot 1.0.13 → 1.0.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "itermbot",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "iTermBot: ReAct agent (LangChain) + DeepAgent (DeepAgents) using BotBotGo packages",
   "type": "module",
   "main": "dist/index.js",

package/skills/disk-usage-investigate/scripts/locate-heavy-paths.sh

@@ -0,0 +1,135 @@
+#!/usr/bin/env bash
+set -u
+
+TOP_N=15
+SHOW_HOTSPOTS=1
+HOME_PATH="${HOME:-}"
+DATA_PATH="/System/Volumes/Data"
+
+print_usage() {
+  cat <<'EOF'
+Usage: locate-heavy-paths.sh [options]
+
+Read-only disk usage locator for macOS.
+It only reports heavy directories and does not delete anything.
+
+Options:
+  --top N           Show top N lines per section (default: 15)
+  --home PATH       Override home path (default: $HOME)
+  --data PATH       Override data volume path (default: /System/Volumes/Data)
+  --no-hotspots     Skip known hotspot checks
+  -h, --help        Show help
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --top)
+      TOP_N="${2:-}"
+      shift 2
+      ;;
+    --home)
+      HOME_PATH="${2:-}"
+      shift 2
+      ;;
+    --data)
+      DATA_PATH="${2:-}"
+      shift 2
+      ;;
+    --no-hotspots)
+      SHOW_HOTSPOTS=0
+      shift
+      ;;
+    -h|--help)
+      print_usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown option: $1" >&2
+      print_usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+if ! [[ "$TOP_N" =~ ^[0-9]+$ ]] || [[ "$TOP_N" -le 0 ]]; then
+  echo "Invalid --top value: $TOP_N" >&2
+  exit 1
+fi
+
+if [[ -z "$HOME_PATH" ]]; then
+  echo "HOME is not set; use --home PATH" >&2
+  exit 1
+fi
+
+print_header() {
+  local title="$1"
+  printf "\n== %s ==\n" "$title"
+}
+
+run_df() {
+  print_header "Filesystem Pressure"
+  if ! df -h /; then
+    echo "Failed: df -h /" >&2
+  fi
+}
+
+run_du_top() {
+  local path="$1"
+  local label="$2"
+
+  print_header "$label"
+  if [[ ! -d "$path" ]]; then
+    echo "Skip (not found): $path"
+    return 0
+  fi
+
+  du -xhd 1 "$path" 2>/dev/null | sort -hr | head -n "$TOP_N"
+}
+
+run_hotspots() {
+  local -a hotspots=(
+    "$HOME_PATH/Downloads"
+    "$HOME_PATH/Desktop"
+    "$HOME_PATH/Movies"
+    "$HOME_PATH/Pictures"
+    "$HOME_PATH/Library/Application Support/MobileSync/Backup"
+    "$HOME_PATH/Library/Developer/Xcode"
+    "$HOME_PATH/Library/Developer/CoreSimulator"
+    "$HOME_PATH/Library/Developer/Xcode/DerivedData"
+    "$HOME_PATH/Library/Containers/com.docker.docker"
+    "$HOME_PATH/Library/Caches"
+    "$HOME_PATH/Library/Containers"
+    "/opt/homebrew/Cellar"
+    "/opt/homebrew/Caskroom"
+    "$HOME_PATH/Library/Caches/Homebrew"
+    "/private/var/vm"
+  )
+
+  print_header "Known Hotspots (depth=1)"
+  for p in "${hotspots[@]}"; do
+    if [[ -d "$p" ]]; then
+      echo "-- $p"
+      du -xhd 1 "$p" 2>/dev/null | sort -hr | head -n 8
+    fi
+  done
+
+  print_header "Time Machine Local Snapshots (diagnostic only)"
+  if command -v tmutil >/dev/null 2>&1; then
+    tmutil listlocalsnapshots / 2>/dev/null || true
+  else
+    echo "tmutil not found"
+  fi
+}
+
+echo "Disk usage locator (read-only). No cleanup actions are performed."
+run_df
+run_du_top "$DATA_PATH" "Top Directories: $DATA_PATH (depth=1)"
+run_du_top "$HOME_PATH" "Top Directories: $HOME_PATH (depth=1)"
+
+if [[ "$SHOW_HOTSPOTS" -eq 1 ]]; then
+  run_hotspots
+fi
+
+print_header "Done"
+echo "Only location analysis completed. No files were deleted or modified."

package/src/external-modules.d.ts

@@ -1,6 +1,9 @@
 declare module "@botbotgo/agent" {
   export function createAgentDeepRuntime(...args: any[]): any;
   export function createAgentReactRuntime(...args: any[]): any;
+}
+
+declare module "@botbotgo/agent/recovery" {
   export function runWithTextToolCallRecovery(...args: any[]): Promise<any>;
 }
 

package/test/integration/chat-flow.integration.test.mjs

@@ -5,7 +5,7 @@ import {
   setDirectCommandTranslationPrompt,
   tryHandleDirectTargetPanelCommand,
 } from "../../dist/iterm/direct-command-router.js";
-import { runWithTextToolCallRecovery } from "@botbotgo/agent";
+import { runWithTextToolCallRecovery } from "@botbotgo/agent/recovery";
 
 setDirectCommandTranslationPrompt([
   "You convert a user's single terminal request into exactly one safe shell command.",

package/test/integration/live-iterm-llm.integration.test.mjs

@@ -9,7 +9,7 @@ import { resolveConfigPath } from "@botbotgo/common/config";
 import { createAgentModel } from "@botbotgo/model";
 import { createAgentTools } from "@botbotgo/toolkit";
 import { itermListCurrentWindowSessions } from "@botbotgo/toolkit-builtin/iterm";
-import { runWithTextToolCallRecovery } from "@botbotgo/agent";
+import { runWithTextToolCallRecovery } from "@botbotgo/agent/recovery";
 import { runLlmHealthCheck } from "../../dist/startup/diagnostics.js";
 import { tryHandleDirectTargetPanelCommand } from "../../dist/iterm/direct-command-router.js";
 

package/test/unit/tool-call-recovery-bootstrap.test.mjs

@@ -1,7 +1,7 @@
 import test, { beforeEach } from "node:test";
 import assert from "node:assert/strict";
 import { AgentContextTokens } from "@botbotgo/common";
-import { runWithTextToolCallRecovery } from "@botbotgo/agent";
+import { runWithTextToolCallRecovery } from "@botbotgo/agent/recovery";
 
 beforeEach(() => {
   delete process.env.ITB_BOOTSTRAP_EVIDENCE_COMMAND;

package/test/unit/tool-call-recovery-core.test.mjs

@@ -1,7 +1,7 @@
 import test, { beforeEach } from "node:test";
 import assert from "node:assert/strict";
 import { AgentContextTokens } from "@botbotgo/common";
-import { runWithTextToolCallRecovery } from "@botbotgo/agent";
+import { runWithTextToolCallRecovery } from "@botbotgo/agent/recovery";
 
 beforeEach(() => {
   delete process.env.ITB_BOOTSTRAP_EVIDENCE_COMMAND;

package/test/unit/tool-call-recovery-scope.test.mjs

@@ -1,7 +1,7 @@
 import test, { beforeEach } from "node:test";
 import assert from "node:assert/strict";
 import { AgentContextTokens } from "@botbotgo/common";
-import { runWithTextToolCallRecovery } from "@botbotgo/agent";
+import { runWithTextToolCallRecovery } from "@botbotgo/agent/recovery";
 
 beforeEach(() => {
   delete process.env.ITB_BOOTSTRAP_EVIDENCE_COMMAND;