@visorcraft/idlehands 0.9.1

package/dist/vim.js

@@ -0,0 +1,160 @@
+/**
+ * Minimal vi-mode editing layer for the readline REPL (Phase 14b).
+ *
+ * Implements a small, predictable subset of vi keybindings:
+ * - Normal/Insert mode toggle
+ * - Movement: h, l, w, b, 0, $, ^
+ * - Editing: x, dd, i, a, A, I, o (appends newline placeholder)
+ * - Yank/Paste: yy, p
+ * - Mode switching: Escape → Normal, i/a/A/I → Insert
+ *
+ * Works alongside readline by intercepting keypress events
+ * in Normal mode and passing through in Insert mode.
+ */
+export function createVimState() {
+    return { mode: 'insert', yankBuffer: '', pendingKey: '' };
+}
+/**
+ * Handle a keypress event in vim mode.
+ * Returns true if the key was consumed (should not propagate),
+ * false if it should propagate to readline normally.
+ */
+export function handleVimKeypress(state, rl, ch, key) {
+    // Escape always switches to normal mode
+    if (key?.name === 'escape') {
+        state.mode = 'normal';
+        state.pendingKey = '';
+        return true;
+    }
+    // In insert mode, pass everything through except Escape
+    if (state.mode === 'insert') {
+        return false;
+    }
+    // --- Normal mode ---
+    const line = getLine(rl);
+    const cursor = getCursor(rl);
+    const k = ch ?? key?.sequence ?? key?.name ?? '';
+    // Multi-key commands
+    if (state.pendingKey) {
+        const combo = state.pendingKey + k;
+        state.pendingKey = '';
+        if (combo === 'dd') {
+            state.yankBuffer = line;
+            setLine(rl, '');
+            return true;
+        }
+        if (combo === 'yy') {
+            state.yankBuffer = line;
+            return true;
+        }
+        // Unknown combo — ignore
+        return true;
+    }
+    // Start of multi-key sequences
+    if (k === 'd' || k === 'y') {
+        state.pendingKey = k;
+        return true;
+    }
+    // Movement
+    if (k === 'h' || key?.name === 'left') {
+        if (cursor > 0)
+            setCursor(rl, cursor - 1);
+        return true;
+    }
+    if (k === 'l' || key?.name === 'right') {
+        if (cursor < line.length)
+            setCursor(rl, cursor + 1);
+        return true;
+    }
+    if (k === '0') {
+        setCursor(rl, 0);
+        return true;
+    }
+    if (k === '$') {
+        setCursor(rl, line.length);
+        return true;
+    }
+    if (k === '^') {
+        const m = line.match(/^\s*/);
+        setCursor(rl, m ? m[0].length : 0);
+        return true;
+    }
+    if (k === 'w') {
+        const after = line.slice(cursor);
+        const m = after.match(/^\S*\s*/);
+        const jump = m ? m[0].length : 0;
+        setCursor(rl, Math.min(cursor + (jump || 1), line.length));
+        return true;
+    }
+    if (k === 'b') {
+        const before = line.slice(0, cursor);
+        const m = before.match(/\s*\S*$/);
+        const jump = m ? m[0].length : 0;
+        setCursor(rl, Math.max(cursor - (jump || 1), 0));
+        return true;
+    }
+    // Editing
+    if (k === 'x') {
+        if (cursor < line.length) {
+            const newLine = line.slice(0, cursor) + line.slice(cursor + 1);
+            setLine(rl, newLine);
+            setCursor(rl, Math.min(cursor, newLine.length));
+        }
+        return true;
+    }
+    // Mode switches to insert
+    if (k === 'i') {
+        state.mode = 'insert';
+        return true;
+    }
+    if (k === 'a') {
+        state.mode = 'insert';
+        if (cursor < line.length)
+            setCursor(rl, cursor + 1);
+        return true;
+    }
+    if (k === 'A') {
+        state.mode = 'insert';
+        setCursor(rl, line.length);
+        return true;
+    }
+    if (k === 'I') {
+        state.mode = 'insert';
+        const m = line.match(/^\s*/);
+        setCursor(rl, m ? m[0].length : 0);
+        return true;
+    }
+    // Paste
+    if (k === 'p') {
+        if (state.yankBuffer) {
+            const newLine = line.slice(0, cursor + 1) + state.yankBuffer + line.slice(cursor + 1);
+            setLine(rl, newLine);
+            setCursor(rl, cursor + state.yankBuffer.length);
+        }
+        return true;
+    }
+    // Unknown normal-mode key — consume silently
+    return true;
+}
+// --- Internal readline manipulation ---
+function getLine(rl) {
+    return String(rl.line ?? '');
+}
+function getCursor(rl) {
+    return rl.cursor ?? 0;
+}
+function setLine(rl, text) {
+    // Clear current line and rewrite
+    rl.write(null, { ctrl: true, name: 'u' });
+    if (text)
+        rl.write(text);
+}
+function setCursor(rl, pos) {
+    rl.cursor = Math.max(0, Math.min(pos, getLine(rl).length));
+    // Force readline to refresh the display
+    try {
+        rl._refreshLine?.();
+    }
+    catch { }
+}
+//# sourceMappingURL=vim.js.map

package/dist/vim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vim.js","sourceRoot":"","sources":["../src/vim.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@visorcraft/idlehands",
+  "version": "0.9.1",
+  "type": "module",
+  "description": "Local-first coding agent CLI for OpenAI-compatible endpoints",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/visorcraft/idlehands.git"
+  },
+  "bugs": {
+    "url": "https://github.com/visorcraft/idlehands/issues"
+  },
+  "homepage": "https://github.com/visorcraft/idlehands#readme",
+  "keywords": [
+    "llm",
+    "agent",
+    "cli",
+    "openai",
+    "local-llm",
+    "tool-calling"
+  ],
+  "bin": {
+    "idlehands": "dist/index.js"
+  },
+  "files": [
+    "dist/**",
+    "src/sys/snapshot.sh",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/index.js && cp src/sys/snapshot.sh dist/sys/snapshot.sh 2>/dev/null || true",
+    "prepack": "npm run build --silent",
+    "start": "node --enable-source-maps dist/index.js",
+    "dev": "tsc -p tsconfig.json -w",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "IDLEHANDS_QUIET_WARNINGS=1 npm run build --silent && IDLEHANDS_QUIET_WARNINGS=1 node --test --test-concurrency=1 tests/*.test.ts tests/tui/*.test.ts",
+    "lint": "node -e \"console.log('no lint configured yet')\"",
+    "bench:build": "tsc -p tsconfig.json",
+    "bench:run": "node dist/bench/runner.js",
+    "bench:report": "node dist/bench/report.js",
+    "bench:compare": "node dist/bench/compare.js",
+    "bundle:mjs": "node scripts/bundle-mjs.mjs"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "dependencies": {
+    "discord.js": "^14.23.2",
+    "grammy": "^1.40.0",
+    "picocolors": "^1.1.1",
+    "tree-sitter-wasms": "^0.1.13",
+    "web-tree-sitter": "^0.26.5"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "esbuild": "^0.25.9",
+    "typescript": "^5.9.3"
+  },
+  "overrides": {
+    "undici": "^6.23.0"
+  },
+  "optionalDependencies": {
+    "node-pty": "^1.1.0"
+  }
+}

package/src/sys/snapshot.sh

@@ -0,0 +1,97 @@
+#!/bin/bash
+# System context snapshot for Idle Hands (Phase 9)
+# Usage: snapshot.sh [scope]
+# Scope: all | services | network | disk | packages
+# Target: <500 tokens for full scope, <100 tokens per individual scope, <2s to collect
+
+set -euo pipefail
+SCOPE="${1:-all}"
+
+collect_os() {
+  echo "OS: $(cat /etc/os-release 2>/dev/null | grep '^PRETTY_NAME' | cut -d'"' -f2 || uname -s) ($(uname -m))"
+  echo "Kernel: $(uname -r)"
+  echo "Hostname: $(hostname)"
+  echo "Uptime: $(uptime -p 2>/dev/null | sed 's/^up //' || echo 'unknown')"
+  # CPU
+  local cpus
+  cpus=$(nproc 2>/dev/null || echo '?')
+  local model
+  model=$(grep -m1 'model name' /proc/cpuinfo 2>/dev/null | cut -d: -f2 | xargs || echo 'unknown')
+  echo "CPU: ${model} (${cpus} cores)"
+  # RAM
+  if command -v free &>/dev/null; then
+    local total avail
+    total=$(free -h | awk '/^Mem:/{print $2}')
+    avail=$(free -h | awk '/^Mem:/{print $7}')
+    echo "RAM: ${total} (${avail} available)"
+  fi
+}
+
+collect_disk() {
+  if command -v df &>/dev/null; then
+    echo "Disk:"
+    df -h --output=target,size,used,avail,pcent / /home 2>/dev/null | tail -n +2 | while read -r mount size used avail pct; do
+      echo "  ${mount} ${pct} of ${size} (${avail} free)"
+    done
+  fi
+}
+
+collect_network() {
+  if command -v ip &>/dev/null; then
+    echo "Network:"
+    ip -br addr 2>/dev/null | grep -v '^lo ' | while read -r iface state addrs; do
+      echo "  ${iface} ${state} ${addrs}"
+    done
+  fi
+}
+
+collect_services() {
+  if command -v systemctl &>/dev/null; then
+    echo "Services (active): $(systemctl list-units --state=active --type=service --no-legend --no-pager 2>/dev/null | awk '{print $1}' | sed 's/\.service$//' | head -20 | tr '\n' ', ' | sed 's/,$//')"
+    local failed
+    failed=$(systemctl list-units --state=failed --type=service --no-legend --no-pager 2>/dev/null | awk '{print $1}' | sed 's/\.service$//' | tr '\n' ', ' | sed 's/,$//')
+    echo "Services (failed): ${failed:-none}"
+  fi
+}
+
+collect_packages() {
+  if command -v apt &>/dev/null; then
+    local installed upgradable
+    installed=$(dpkg -l 2>/dev/null | grep -c '^ii' || echo '?')
+    upgradable=$(apt list --upgradable 2>/dev/null | grep -c 'upgradable' || echo '0')
+    echo "Packages (apt): ${installed} installed, ${upgradable} upgradable"
+  elif command -v dnf &>/dev/null; then
+    local installed
+    installed=$(dnf list installed 2>/dev/null | tail -n +2 | wc -l || echo '?')
+    echo "Packages (dnf): ${installed} installed"
+  elif command -v pacman &>/dev/null; then
+    local installed
+    installed=$(pacman -Q 2>/dev/null | wc -l || echo '?')
+    echo "Packages (pacman): ${installed} installed"
+  fi
+  # Last boot
+  if command -v who &>/dev/null; then
+    echo "Last boot: $(who -b 2>/dev/null | awk '{print $3, $4}' || echo 'unknown')"
+  fi
+}
+
+echo "[System context]"
+case "$SCOPE" in
+  all)
+    collect_os
+    collect_disk
+    collect_network
+    collect_services
+    collect_packages
+    ;;
+  services) collect_services ;;
+  network) collect_network ;;
+  disk) collect_disk ;;
+  packages) collect_packages ;;
+  *)
+    echo "Unknown scope: $SCOPE"
+    echo "Valid scopes: all, services, network, disk, packages"
+    exit 1
+    ;;
+esac
+echo "[End system context]"