@nocville/npc 0.0.0-stage → 0.2.0

package/dist/cjs/doctor.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDoctor = runDoctor;
+exports.hasCodexHookWatcherOverlap = hasCodexHookWatcherOverlap;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const liveness_js_1 = require("./npcs/agent-common/liveness.js");
+const defaults_js_1 = require("./npcs/codex/defaults.js");
+/**
+ * Diagnose connectivity to the Nocville API: hit `/api/v1/health/ready`, then POST a single
+ * offline status push and report HTTP status, latency, and rate-limit headroom.
+ */
+async function runDoctor(config) {
+    const apiUrl = config.apiUrl.replace(/\/+$/, '');
+    console.log(`nocville-npc doctor — checking ${apiUrl}`);
+    console.log('');
+    if (hasCodexHookWatcherOverlap())
+        console.warn('  [WARN] Codex hooks and codex watch are both active. Stop the fallback watcher; hooks own these sessions.');
+    // 1) Health check
+    let healthOk = false;
+    {
+        const start = Date.now();
+        const t = withTimeout(5000);
+        try {
+            const res = await fetch(`${apiUrl}/api/v1/health/ready`, { method: 'GET', signal: t.signal });
+            const ms = Date.now() - start;
+            const body = await res.text();
+            healthOk = res.ok;
+            console.log(`  [${res.ok ? 'OK' : 'FAIL'}] GET /api/v1/health/ready -> ${res.status} (${ms}ms)`);
+            if (config.debug)
+                console.log(`         ${body.slice(0, 200)}`);
+        }
+        catch (err) {
+            console.log(`  [FAIL] GET /api/v1/health/ready -> ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            t.done();
+        }
+    }
+    // 2) Test status push
+    let pushOk = false;
+    const hasKey = Boolean(config.apiKey);
+    if (!hasKey) {
+        console.log('  [SKIP] POST /api/v1/status — no --api-key / NOCVILLE_API_KEY set');
+    }
+    else {
+        const start = Date.now();
+        const t = withTimeout(5000);
+        try {
+            const res = await fetch(`${apiUrl}/api/v1/status`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${config.apiKey}`,
+                },
+                signal: t.signal,
+                body: JSON.stringify({
+                    // Unique offline probe: personal-key ownership must not reserve a shared doctor ID.
+                    serviceId: `${(config.serviceId || 'npc').slice(0, 60)}-doctor-${(0, node_crypto_1.randomUUID)().slice(0, 16)}`,
+                    status: 'unknown',
+                    mood: 'idle',
+                    offline: true,
+                    subStatus: 'offline',
+                    ...(config.map ? { map: config.map } : {}),
+                }),
+            });
+            const ms = Date.now() - start;
+            const text = await res.text();
+            pushOk = res.ok;
+            let remaining = res.headers.get('x-ratelimit-remaining') ?? res.headers.get('ratelimit-remaining');
+            if (!remaining) {
+                try {
+                    const parsed = JSON.parse(text);
+                    if (typeof parsed.remaining === 'number')
+                        remaining = String(parsed.remaining);
+                }
+                catch {
+                    // non-JSON body
+                }
+            }
+            console.log(`  [${res.ok ? 'OK' : 'FAIL'}] POST /api/v1/status -> ${res.status} ` +
+                `(${ms}ms, rate-limit remaining: ${remaining ?? 'n/a'})`);
+            if (config.map)
+                console.log(`         target map: ${config.map}`);
+            if (!res.ok)
+                console.log(`         ${text.slice(0, 200)}`);
+        }
+        catch (err) {
+            console.log(`  [FAIL] POST /api/v1/status -> ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            t.done();
+        }
+    }
+    // Verdict
+    console.log('');
+    if (healthOk && pushOk) {
+        console.log('Verdict: OK — API reachable and status push accepted.');
+        console.log('The offline probe does not create a coworker in your office.');
+    }
+    else if (!healthOk) {
+        console.log('Verdict: FAIL — API health check is unreachable. Check --api-url and that the server is running.');
+    }
+    else if (!hasKey) {
+        console.log('Verdict: PARTIAL — API is up, but no API key was provided to test a push.');
+    }
+    else {
+        console.log('Verdict: FAIL — API is up but the push was rejected. Check your API key / team settings.');
+    }
+    process.exitCode = healthOk && (pushOk || !hasKey) ? 0 : 1;
+}
+function withTimeout(timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    return { signal: controller.signal, done: () => clearTimeout(timer) };
+}
+function hasCodexHookWatcherOverlap(dir = defaults_js_1.CODEX_DEFAULTS.stateDir) {
+    try {
+        const files = (0, node_fs_1.readdirSync)(dir);
+        return (files.some((file) => /^session-.*\.json$/.test(file)) &&
+            files.some((file) => {
+                const match = file.match(/^watcher-(\d+)\.pid$/);
+                return !!match && (0, liveness_js_1.isAgentAlive)({ pid: Number(match[1]) });
+            }));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cjs/index.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installGeminiHooksInto = exports.uninstallGeminiHooks = exports.setupGeminiHooks = exports.handleGeminiHookEvent = exports.geminiServiceId = exports.geminiTransition = exports.GEMINI_ADAPTER = exports.GEMINI_DEFAULTS = exports.WebPageWatcherNPC = exports.GitHubWatcherNPC = exports.ReceptionistNPC = exports.LogWatcherNPC = exports.ProcessWatcherNPC = exports.InternetConnectivityNPC = exports.userConfigPath = exports.saveUserConfig = exports.loadUserConfig = exports.redactSecrets = exports.shortPath = exports.shortCommand = exports.describeToolUse = exports.CodexWatcher = exports.parseRolloutLine = exports.uninstallCodexHooks = exports.setupCodexHooks = exports.codexTransition = exports.handleCodexHookEvent = exports.handleCodexCommand = exports.claudeTransition = exports.processHookEvent = exports.uninstallHooks = exports.setupHooks = exports.handleHookEvent = exports.handleClaudeCodeCommand = exports.ClaudeCodeNPC = exports.SystemMonitorNPC = exports.pushHistory = exports.statusColor = exports.truncate = exports.worstStatus = exports.evaluateThreshold = exports.numberFlag = exports.boolFlag = exports.stringFlag = exports.resolveConfig = exports.parseArgs = exports.Logger = exports.EventNPC = exports.PollingNPC = exports.BaseNPC = void 0;
+exports.normalizeCursorEvent = exports.isCursorInvocation = exports.CURSOR_HOOK_EVENTS = exports.installCursorHooksInto = exports.uninstallCursorHooks = exports.setupCursorHooks = exports.handleCursorHookEvent = exports.cursorServiceId = exports.CURSOR_ADAPTER = exports.CURSOR_DEFAULTS = exports.GEMINI_HOOK_EVENTS = void 0;
+// Core
+var base_npc_js_1 = require("./core/base-npc.js");
+Object.defineProperty(exports, "BaseNPC", { enumerable: true, get: function () { return base_npc_js_1.BaseNPC; } });
+var polling_npc_js_1 = require("./core/polling-npc.js");
+Object.defineProperty(exports, "PollingNPC", { enumerable: true, get: function () { return polling_npc_js_1.PollingNPC; } });
+var event_npc_js_1 = require("./core/event-npc.js");
+Object.defineProperty(exports, "EventNPC", { enumerable: true, get: function () { return event_npc_js_1.EventNPC; } });
+var logger_js_1 = require("./core/logger.js");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_js_1.Logger; } });
+var config_js_1 = require("./core/config.js");
+Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return config_js_1.parseArgs; } });
+Object.defineProperty(exports, "resolveConfig", { enumerable: true, get: function () { return config_js_1.resolveConfig; } });
+Object.defineProperty(exports, "stringFlag", { enumerable: true, get: function () { return config_js_1.stringFlag; } });
+Object.defineProperty(exports, "boolFlag", { enumerable: true, get: function () { return config_js_1.boolFlag; } });
+Object.defineProperty(exports, "numberFlag", { enumerable: true, get: function () { return config_js_1.numberFlag; } });
+var thresholds_js_1 = require("./core/thresholds.js");
+Object.defineProperty(exports, "evaluateThreshold", { enumerable: true, get: function () { return thresholds_js_1.evaluateThreshold; } });
+Object.defineProperty(exports, "worstStatus", { enumerable: true, get: function () { return thresholds_js_1.worstStatus; } });
+var text_js_1 = require("./core/text.js");
+Object.defineProperty(exports, "truncate", { enumerable: true, get: function () { return text_js_1.truncate; } });
+var screen_js_1 = require("./core/screen.js");
+Object.defineProperty(exports, "statusColor", { enumerable: true, get: function () { return screen_js_1.statusColor; } });
+Object.defineProperty(exports, "pushHistory", { enumerable: true, get: function () { return screen_js_1.pushHistory; } });
+// NPCs
+var index_js_1 = require("./npcs/system-monitor/index.js");
+Object.defineProperty(exports, "SystemMonitorNPC", { enumerable: true, get: function () { return index_js_1.SystemMonitorNPC; } });
+var index_js_2 = require("./npcs/claude-code/index.js");
+Object.defineProperty(exports, "ClaudeCodeNPC", { enumerable: true, get: function () { return index_js_2.ClaudeCodeNPC; } });
+Object.defineProperty(exports, "handleClaudeCodeCommand", { enumerable: true, get: function () { return index_js_2.handleClaudeCodeCommand; } });
+Object.defineProperty(exports, "handleHookEvent", { enumerable: true, get: function () { return index_js_2.handleHookEvent; } });
+Object.defineProperty(exports, "setupHooks", { enumerable: true, get: function () { return index_js_2.setupHooks; } });
+Object.defineProperty(exports, "uninstallHooks", { enumerable: true, get: function () { return index_js_2.uninstallHooks; } });
+Object.defineProperty(exports, "processHookEvent", { enumerable: true, get: function () { return index_js_2.processHookEvent; } });
+Object.defineProperty(exports, "claudeTransition", { enumerable: true, get: function () { return index_js_2.claudeTransition; } });
+var index_js_3 = require("./npcs/codex/index.js");
+Object.defineProperty(exports, "handleCodexCommand", { enumerable: true, get: function () { return index_js_3.handleCodexCommand; } });
+Object.defineProperty(exports, "handleCodexHookEvent", { enumerable: true, get: function () { return index_js_3.handleCodexHookEvent; } });
+Object.defineProperty(exports, "codexTransition", { enumerable: true, get: function () { return index_js_3.codexTransition; } });
+Object.defineProperty(exports, "setupCodexHooks", { enumerable: true, get: function () { return index_js_3.setupCodexHooks; } });
+Object.defineProperty(exports, "uninstallCodexHooks", { enumerable: true, get: function () { return index_js_3.uninstallCodexHooks; } });
+Object.defineProperty(exports, "parseRolloutLine", { enumerable: true, get: function () { return index_js_3.parseRolloutLine; } });
+Object.defineProperty(exports, "CodexWatcher", { enumerable: true, get: function () { return index_js_3.CodexWatcher; } });
+var activity_js_1 = require("./npcs/agent-common/activity.js");
+Object.defineProperty(exports, "describeToolUse", { enumerable: true, get: function () { return activity_js_1.describeToolUse; } });
+Object.defineProperty(exports, "shortCommand", { enumerable: true, get: function () { return activity_js_1.shortCommand; } });
+Object.defineProperty(exports, "shortPath", { enumerable: true, get: function () { return activity_js_1.shortPath; } });
+Object.defineProperty(exports, "redactSecrets", { enumerable: true, get: function () { return activity_js_1.redactSecrets; } });
+var user_config_js_1 = require("./core/user-config.js");
+Object.defineProperty(exports, "loadUserConfig", { enumerable: true, get: function () { return user_config_js_1.loadUserConfig; } });
+Object.defineProperty(exports, "saveUserConfig", { enumerable: true, get: function () { return user_config_js_1.saveUserConfig; } });
+Object.defineProperty(exports, "userConfigPath", { enumerable: true, get: function () { return user_config_js_1.userConfigPath; } });
+var index_js_4 = require("./npcs/internet-connectivity/index.js");
+Object.defineProperty(exports, "InternetConnectivityNPC", { enumerable: true, get: function () { return index_js_4.InternetConnectivityNPC; } });
+var index_js_5 = require("./npcs/process-watcher/index.js");
+Object.defineProperty(exports, "ProcessWatcherNPC", { enumerable: true, get: function () { return index_js_5.ProcessWatcherNPC; } });
+var index_js_6 = require("./npcs/log-watcher/index.js");
+Object.defineProperty(exports, "LogWatcherNPC", { enumerable: true, get: function () { return index_js_6.LogWatcherNPC; } });
+var index_js_7 = require("./npcs/receptionist/index.js");
+Object.defineProperty(exports, "ReceptionistNPC", { enumerable: true, get: function () { return index_js_7.ReceptionistNPC; } });
+var index_js_8 = require("./npcs/github-watcher/index.js");
+Object.defineProperty(exports, "GitHubWatcherNPC", { enumerable: true, get: function () { return index_js_8.GitHubWatcherNPC; } });
+var index_js_9 = require("./npcs/web-page-watcher/index.js");
+Object.defineProperty(exports, "WebPageWatcherNPC", { enumerable: true, get: function () { return index_js_9.WebPageWatcherNPC; } });
+var index_js_10 = require("./npcs/gemini/index.js");
+Object.defineProperty(exports, "GEMINI_DEFAULTS", { enumerable: true, get: function () { return index_js_10.GEMINI_DEFAULTS; } });
+Object.defineProperty(exports, "GEMINI_ADAPTER", { enumerable: true, get: function () { return index_js_10.GEMINI_ADAPTER; } });
+Object.defineProperty(exports, "geminiTransition", { enumerable: true, get: function () { return index_js_10.geminiTransition; } });
+Object.defineProperty(exports, "geminiServiceId", { enumerable: true, get: function () { return index_js_10.geminiServiceId; } });
+Object.defineProperty(exports, "handleGeminiHookEvent", { enumerable: true, get: function () { return index_js_10.handleGeminiHookEvent; } });
+Object.defineProperty(exports, "setupGeminiHooks", { enumerable: true, get: function () { return index_js_10.setupGeminiHooks; } });
+Object.defineProperty(exports, "uninstallGeminiHooks", { enumerable: true, get: function () { return index_js_10.uninstallGeminiHooks; } });
+Object.defineProperty(exports, "installGeminiHooksInto", { enumerable: true, get: function () { return index_js_10.installGeminiHooksInto; } });
+Object.defineProperty(exports, "GEMINI_HOOK_EVENTS", { enumerable: true, get: function () { return index_js_10.GEMINI_HOOK_EVENTS; } });
+var index_js_11 = require("./npcs/cursor/index.js");
+Object.defineProperty(exports, "CURSOR_DEFAULTS", { enumerable: true, get: function () { return index_js_11.CURSOR_DEFAULTS; } });
+Object.defineProperty(exports, "CURSOR_ADAPTER", { enumerable: true, get: function () { return index_js_11.CURSOR_ADAPTER; } });
+Object.defineProperty(exports, "cursorServiceId", { enumerable: true, get: function () { return index_js_11.cursorServiceId; } });
+Object.defineProperty(exports, "handleCursorHookEvent", { enumerable: true, get: function () { return index_js_11.handleCursorHookEvent; } });
+Object.defineProperty(exports, "setupCursorHooks", { enumerable: true, get: function () { return index_js_11.setupCursorHooks; } });
+Object.defineProperty(exports, "uninstallCursorHooks", { enumerable: true, get: function () { return index_js_11.uninstallCursorHooks; } });
+Object.defineProperty(exports, "installCursorHooksInto", { enumerable: true, get: function () { return index_js_11.installCursorHooksInto; } });
+Object.defineProperty(exports, "CURSOR_HOOK_EVENTS", { enumerable: true, get: function () { return index_js_11.CURSOR_HOOK_EVENTS; } });
+var normalize_js_1 = require("./npcs/cursor/normalize.js");
+Object.defineProperty(exports, "isCursorInvocation", { enumerable: true, get: function () { return normalize_js_1.isCursorInvocation; } });
+Object.defineProperty(exports, "normalizeCursorEvent", { enumerable: true, get: function () { return normalize_js_1.normalizeCursorEvent; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/npcs/agent-common/activity.js

@@ -0,0 +1,291 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THINKING = exports.ACTIVITY_MAX = void 0;
+exports.shortPath = shortPath;
+exports.redactSecrets = redactSecrets;
+exports.shortCommand = shortCommand;
+exports.patchFiles = patchFiles;
+exports.editingFiles = editingFiles;
+exports.describeToolUse = describeToolUse;
+exports.isQuestionTool = isQuestionTool;
+exports.failureText = failureText;
+const node_os_1 = require("node:os");
+const text_js_1 = require("../../core/text.js");
+/**
+ * Human-friendly activity strings for AI coding agents (Claude Code, Codex).
+ *
+ * These end up on the NPC's speech bubble and desk-sign ticker, which teammates
+ * see — so they must be short, readable, and never leak secrets or prompt text.
+ */
+/** Max length of a full activity line ("Running pnpm test", "Editing src/x.ts"). */
+exports.ACTIVITY_MAX = 60;
+/** Max length of an embedded shell command. */
+const COMMAND_MAX = 44;
+/** Max length of an embedded path. */
+const PATH_MAX = 40;
+/** Max length of an embedded search pattern / query. */
+const PATTERN_MAX = 28;
+exports.THINKING = 'Thinking…';
+function str(input, ...keys) {
+    for (const k of keys) {
+        const v = input[k];
+        if (typeof v === 'string' && v.trim())
+            return v.trim();
+    }
+    return undefined;
+}
+function asInput(raw) {
+    if (raw && typeof raw === 'object' && !Array.isArray(raw))
+        return raw;
+    if (typeof raw === 'string') {
+        // Some agents pass JSON-encoded arguments.
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed))
+                return parsed;
+        }
+        catch {
+            // Not JSON — treat as a bare command string.
+        }
+        return { command: raw };
+    }
+    if (Array.isArray(raw))
+        return { command: raw };
+    return {};
+}
+/**
+ * Make a path short and relative: strip the project cwd (or the home dir to
+ * `~`), then keep only the trailing segments if it is still long.
+ */
+function shortPath(p, cwd) {
+    let out = p.trim().replace(/^file:\/\//, '');
+    const norm = (s) => s.replace(/\\/g, '/').replace(/\/+$/, '');
+    out = norm(out);
+    const base = cwd ? norm(cwd) : '';
+    if (base && (out === base || out.startsWith(base + '/'))) {
+        out = out.slice(base.length + 1) || '.';
+    }
+    else {
+        const home = norm((0, node_os_1.homedir)());
+        if (home && out.startsWith(home + '/'))
+            out = '~' + out.slice(home.length);
+    }
+    if (out.length <= PATH_MAX)
+        return out;
+    const parts = out.split('/');
+    // Keep the last two segments; fall back to truncating the filename.
+    const tail = parts.slice(-2).join('/');
+    if (tail.length + 2 <= PATH_MAX)
+        return '…/' + tail;
+    return (0, text_js_1.truncate)(parts[parts.length - 1] ?? out, PATH_MAX);
+}
+const SECRET_FLAG = /(--?[\w-]*(?:token|key|secret|password|passwd|pwd|auth|credential)[\w-]*)(=|\s+)("[^"]*"|'[^']*'|\S+)/gi;
+/**
+ * Redact anything secret-looking from a shell command: env assignments,
+ * `--token=…`-style flags, bearer headers, URL credentials, and long opaque
+ * strings (API keys, hashes). Conservative by design — false positives are fine.
+ */
+function redactSecrets(cmd) {
+    return (cmd
+        // URL credentials: scheme://user:pass@host
+        .replace(/([a-z][a-z0-9+.-]*:\/\/)[^\s/@:]+:[^\s/@]+@/gi, '$1***@')
+        // Authorization headers
+        .replace(/(bearer|basic|token)\s+[A-Za-z0-9._~+/=-]{8,}/gi, '$1 ***')
+        // --api-key=…, --password …, -token …
+        .replace(SECRET_FLAG, (_m, flag, sep) => `${flag}${sep}***`)
+        // Well-known key prefixes
+        .replace(/\b(sk|pk|rk)-[A-Za-z0-9_-]{8,}/g, '***')
+        .replace(/\b(ghp|gho|ghs|ghu|github_pat|xox[abprs]|glpat|AKIA)[A-Za-z0-9_-]{8,}/g, '***')
+        // Long opaque tokens (≥32 chars of key-ish alphabet, no path separators)
+        .replace(/\b[A-Za-z0-9_+=-]{32,}\b/g, '***'));
+}
+/**
+ * Shorten a shell command for display: first line only, drop a leading
+ * `cd … &&`, drop leading `VAR=value` env assignments (often secrets), unwrap
+ * `bash -lc "…"` wrappers, redact secrets, and truncate.
+ */
+function shortCommand(raw, max = COMMAND_MAX) {
+    let cmd;
+    if (Array.isArray(raw)) {
+        const parts = raw.filter((x) => typeof x === 'string');
+        // Unwrap ["bash", "-lc", "<script>"] style argv.
+        const shellIdx = parts.findIndex((p) => p === '-lc' || p === '-c');
+        cmd = shellIdx >= 0 && parts[shellIdx + 1] ? parts[shellIdx + 1] : parts.join(' ');
+    }
+    else if (typeof raw === 'string') {
+        cmd = raw;
+    }
+    else {
+        return '';
+    }
+    cmd = cmd.trim();
+    // Unwrap a string-form shell wrapper: bash -lc 'pnpm test'
+    const wrapped = cmd.match(/^(?:\/\S*\/)?(?:ba|z)?sh\s+-l?c\s+(['"])([\s\S]*)\1$/);
+    if (wrapped)
+        cmd = wrapped[2].trim();
+    cmd = cmd.split('\n')[0].trim();
+    // Drop leading "cd <dir> &&" / "cd <dir>;" hops.
+    cmd = cmd.replace(/^(?:cd\s+("[^"]*"|'[^']*'|\S+)\s*(?:&&|;)\s*)+/, '');
+    // Drop leading env assignments.
+    cmd = cmd.replace(/^(?:[A-Za-z_][A-Za-z0-9_]*=("[^"]*"|'[^']*'|\S*)\s+)+/, '');
+    cmd = redactSecrets(cmd).replace(/\s+/g, ' ').trim();
+    return (0, text_js_1.truncate)(cmd, max);
+}
+function quote(s, max = PATTERN_MAX) {
+    return `'${(0, text_js_1.truncate)(s.replace(/\s+/g, ' '), max)}'`;
+}
+function hostOf(url) {
+    try {
+        return new URL(url).hostname.replace(/^www\./, '');
+    }
+    catch {
+        return (0, text_js_1.truncate)(url, PATTERN_MAX);
+    }
+}
+/** Files touched by an `apply_patch` envelope ("*** Update File: path"). */
+function patchFiles(patch) {
+    const files = [];
+    const re = /^\*\*\* (?:Update|Add|Delete) File:\s*(.+)$/gm;
+    let m;
+    while ((m = re.exec(patch)) !== null) {
+        const f = m[1].trim();
+        if (f && !files.includes(f))
+            files.push(f);
+    }
+    return files;
+}
+/** "Editing a.ts" / "Editing a.ts +2 more" for a list of files. */
+function editingFiles(files, cwd) {
+    if (files.length === 0)
+        return 'Editing files';
+    const first = shortPath(files[0], cwd);
+    return files.length === 1 ? `Editing ${first}` : `Editing ${first} +${files.length - 1} more`;
+}
+/**
+ * Describe a tool invocation in a few words. Covers Claude Code tool names and
+ * Codex tool names (Bash/shell/exec_command, apply_patch, update_plan, …);
+ * unknown tools fall back to "Using <tool>". Never includes file contents,
+ * edit strings, or prompts.
+ */
+function describeToolUse(toolName, rawInput, cwd) {
+    const name = (toolName ?? '').trim();
+    const input = asInput(rawInput);
+    const key = name.toLowerCase();
+    // MCP tools: mcp__server__tool → "Using server (tool)"
+    if (key.startsWith('mcp__')) {
+        const [, server = 'mcp', tool = ''] = name.split('__');
+        return (0, text_js_1.truncate)(tool ? `Using ${server} (${tool})` : `Using ${server}`, exports.ACTIVITY_MAX);
+    }
+    switch (key) {
+        case 'replace':
+        case 'write_file':
+        case 'edit':
+        case 'multiedit':
+        case 'write':
+        case 'notebookedit': {
+            const file = str(input, 'file_path', 'absolute_path', 'notebook_path', 'path');
+            if (file)
+                return (0, text_js_1.truncate)(`Editing ${shortPath(file, cwd)}`, exports.ACTIVITY_MAX);
+            // Codex aliases Edit/Write to apply_patch; fall through to patch parsing.
+            const patch = str(input, 'command', 'input', 'patch');
+            return (0, text_js_1.truncate)(editingFiles(patch ? patchFiles(patch) : [], cwd), exports.ACTIVITY_MAX);
+        }
+        case 'delete': {
+            const file = str(input, 'file_path', 'path');
+            return file ? (0, text_js_1.truncate)(`Deleting ${shortPath(file, cwd)}`, exports.ACTIVITY_MAX) : 'Deleting a file';
+        }
+        case 'apply_patch':
+        case 'applypatch': {
+            const patch = str(input, 'command', 'input', 'patch') ?? '';
+            return (0, text_js_1.truncate)(editingFiles(patchFiles(patch), cwd), exports.ACTIVITY_MAX);
+        }
+        case 'run_shell_command':
+        case 'bash':
+        case 'shell':
+        case 'local_shell':
+        case 'exec_command':
+        case 'container.exec':
+        case 'unified_exec': {
+            const cmd = shortCommand(input['command'] ?? input['cmd']);
+            return cmd ? `Running ${cmd}` : 'Running a command';
+        }
+        case 'bashoutput':
+        case 'write_stdin':
+            return 'Checking a running command';
+        case 'killshell':
+        case 'killbash':
+            return 'Stopping a command';
+        case 'read_file':
+        case 'read':
+        case 'notebookread':
+        case 'view': {
+            const file = str(input, 'file_path', 'absolute_path', 'notebook_path', 'path');
+            return file ? (0, text_js_1.truncate)(`Reading ${shortPath(file, cwd)}`, exports.ACTIVITY_MAX) : 'Reading files';
+        }
+        case 'view_image': {
+            const file = str(input, 'path', 'file_path');
+            return file ? (0, text_js_1.truncate)(`Viewing ${shortPath(file, cwd)}`, exports.ACTIVITY_MAX) : 'Viewing an image';
+        }
+        case 'ls': {
+            const dir = str(input, 'path');
+            return dir ? (0, text_js_1.truncate)(`Listing ${shortPath(dir, cwd)}`, exports.ACTIVITY_MAX) : 'Listing files';
+        }
+        case 'grep': {
+            const pattern = str(input, 'pattern', 'query');
+            return pattern ? `Searching for ${quote(pattern)}` : 'Searching the code';
+        }
+        case 'glob': {
+            const pattern = str(input, 'pattern');
+            return pattern ? `Finding files ${quote(pattern)}` : 'Finding files';
+        }
+        case 'toolsearch':
+            return 'Looking up tools';
+        case 'webfetch': {
+            const url = str(input, 'url');
+            return url ? `Browsing ${hostOf(url)}` : 'Browsing the web';
+        }
+        case 'websearch':
+        case 'web_search':
+        case 'web_search_preview': {
+            const q = str(input, 'query', 'q');
+            return q ? `Searching the web for ${quote(q)}` : 'Searching the web';
+        }
+        case 'task':
+        case 'agent':
+        case 'spawn_agent':
+            return 'Delegating to a subagent';
+        case 'todowrite':
+        case 'update_plan':
+        case 'taskcreate':
+        case 'taskupdate':
+            return 'Planning';
+        case 'exitplanmode':
+            return 'Plan ready for review';
+        case 'askuserquestion':
+        case 'request_user_input':
+            return 'Has a question for you';
+        case 'skill': {
+            const skill = str(input, 'skill', 'name');
+            return skill ? (0, text_js_1.truncate)(`Using skill ${skill}`, exports.ACTIVITY_MAX) : 'Using a skill';
+        }
+        case '':
+            return 'Working';
+        default:
+            return (0, text_js_1.truncate)(`Using ${name}`, exports.ACTIVITY_MAX);
+    }
+}
+/** Tools whose PreToolUse means the agent is now waiting on the human. */
+function isQuestionTool(toolName) {
+    const k = (toolName ?? '').toLowerCase();
+    return k === 'askuserquestion' || k === 'exitplanmode' || k === 'request_user_input';
+}
+/** Short failure label: "A command failed", "Edit failed". */
+function failureText(toolName) {
+    const k = (toolName ?? '').toLowerCase();
+    if (k === 'bash' || k === 'shell' || k === 'exec_command')
+        return 'A command failed';
+    if (!toolName)
+        return 'Hit an error';
+    return (0, text_js_1.truncate)(`${toolName} failed`, exports.ACTIVITY_MAX);
+}
+//# sourceMappingURL=activity.js.map

package/dist/cjs/npcs/agent-common/git-stats.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseNumstat = parseNumstat;
+exports.computeGitStats = computeGitStats;
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = require("node:path");
+const node_perf_hooks_1 = require("node:perf_hooks");
+/** Parse NUL-delimited numstat, including binary files and rename path pairs. */
+function parseNumstat(raw) {
+    const fields = raw.split('\0'), files = [];
+    for (let i = 0; i < fields.length; i++) {
+        const record = fields[i];
+        if (!record)
+            continue;
+        const match = /^(\d+|-)\t(\d+|-)\t([\s\S]*)$/.exec(record);
+        if (!match)
+            continue;
+        let path = match[3];
+        if (!path) {
+            i++;
+            path = fields[++i] ?? '';
+        }
+        if (path)
+            files.push({
+                path,
+                insertions: match[1] === '-' ? 0 : Number(match[1]),
+                deletions: match[2] === '-' ? 0 : Number(match[2]),
+            });
+    }
+    return files;
+}
+/** Both commands share one wall-clock budget; call only from detached flushes. */
+function computeGitStats(cwd, timeoutMs = 1500) {
+    const deadline = node_perf_hooks_1.performance.now() + Math.max(1, Math.min(1500, timeoutMs));
+    const git = (args) => {
+        const remaining = Math.floor(deadline - node_perf_hooks_1.performance.now());
+        if (remaining <= 0)
+            return null;
+        const result = (0, node_child_process_1.spawnSync)('git', ['--no-optional-locks', '-c', 'core.fsmonitor=false', '-C', cwd, ...args], {
+            encoding: 'utf8',
+            timeout: remaining,
+            killSignal: 'SIGKILL',
+            maxBuffer: 1 << 20,
+            windowsHide: true,
+        });
+        return result.status === 0 && !result.error ? result.stdout : null;
+    };
+    const diff = git(['diff', '--no-ext-diff', '--no-textconv', '--numstat', '-z', 'HEAD', '--']);
+    if (diff === null)
+        return null;
+    const untracked = git(['ls-files', '--others', '--exclude-standard', '-z']);
+    if (untracked === null)
+        return null;
+    const files = parseNumstat(diff);
+    for (const path of untracked.split('\0'))
+        if (path)
+            files.push({ path, insertions: 0, deletions: 0 });
+    if (files.length > 100_000)
+        return null;
+    files.sort((a, b) => b.insertions + b.deletions - (a.insertions + a.deletions) || a.path.localeCompare(b.path));
+    return {
+        filesChanged: files.length,
+        insertions: files.reduce((n, file) => n + file.insertions, 0),
+        deletions: files.reduce((n, file) => n + file.deletions, 0),
+        lastFiles: files.slice(0, 5).map((file) => (0, node_path_1.basename)(file.path)
+            // eslint-disable-next-line no-control-regex -- Strip display controls from Git filenames.
+            .replace(/[\u0000-\u001f\u007f-\u009f\u061c\u200e\u200f\u202a-\u202e\u2066-\u2069]/g, '')
+            .slice(0, 120)),
+    };
+}
+//# sourceMappingURL=git-stats.js.map