@visorcraft/idlehands 1.1.17 → 1.2.0

package/dist/agent/tool-loop-detection.js

@@ -0,0 +1,310 @@
+import crypto from 'node:crypto';
+const DEFAULT_DETECTORS = {
+    genericRepeat: true,
+    knownPollNoProgress: true,
+    pingPong: true,
+};
+const DEFAULTS = {
+    enabled: true,
+    historySize: 30,
+    warningThreshold: 4,
+    criticalThreshold: 8,
+    globalCircuitBreakerThreshold: 12,
+    readCacheTtlMs: 15_000,
+    detectors: { ...DEFAULT_DETECTORS },
+    perTool: {},
+};
+const KNOWN_POLL_TOOLS = new Set(['command_status', 'process.poll', 'process.log']);
+export function createToolLoopState() {
+    return {
+        history: [],
+        bySignature: new Map(),
+        byOutcomeKey: new Map(),
+    };
+}
+function normalizePolicy(base, incoming) {
+    const out = {
+        warningThreshold: Number.isFinite(Number(incoming?.warningThreshold)) ? Math.max(2, Math.floor(Number(incoming?.warningThreshold))) : base.warningThreshold,
+        criticalThreshold: Number.isFinite(Number(incoming?.criticalThreshold)) ? Math.max(3, Math.floor(Number(incoming?.criticalThreshold))) : base.criticalThreshold,
+        globalCircuitBreakerThreshold: Number.isFinite(Number(incoming?.globalCircuitBreakerThreshold)) ? Math.max(4, Math.floor(Number(incoming?.globalCircuitBreakerThreshold))) : base.globalCircuitBreakerThreshold,
+        detectors: {
+            genericRepeat: incoming?.detectors?.genericRepeat ?? base.detectors.genericRepeat,
+            knownPollNoProgress: incoming?.detectors?.knownPollNoProgress ?? base.detectors.knownPollNoProgress,
+            pingPong: incoming?.detectors?.pingPong ?? base.detectors.pingPong,
+        },
+    };
+    if (out.warningThreshold >= out.criticalThreshold)
+        out.criticalThreshold = out.warningThreshold + 2;
+    if (out.criticalThreshold >= out.globalCircuitBreakerThreshold)
+        out.globalCircuitBreakerThreshold = out.criticalThreshold + 2;
+    return out;
+}
+function normalizeConfig(config) {
+    const basePolicy = {
+        warningThreshold: Number.isFinite(Number(config?.warningThreshold)) ? Math.max(2, Math.floor(Number(config?.warningThreshold))) : DEFAULTS.warningThreshold,
+        criticalThreshold: Number.isFinite(Number(config?.criticalThreshold)) ? Math.max(3, Math.floor(Number(config?.criticalThreshold))) : DEFAULTS.criticalThreshold,
+        globalCircuitBreakerThreshold: Number.isFinite(Number(config?.globalCircuitBreakerThreshold)) ? Math.max(4, Math.floor(Number(config?.globalCircuitBreakerThreshold))) : DEFAULTS.globalCircuitBreakerThreshold,
+        detectors: {
+            genericRepeat: config?.detectors?.genericRepeat ?? DEFAULT_DETECTORS.genericRepeat,
+            knownPollNoProgress: config?.detectors?.knownPollNoProgress ?? DEFAULT_DETECTORS.knownPollNoProgress,
+            pingPong: config?.detectors?.pingPong ?? DEFAULT_DETECTORS.pingPong,
+        },
+    };
+    const normalizedBasePolicy = normalizePolicy(basePolicy);
+    const perTool = {};
+    for (const [tool, policy] of Object.entries(config?.perTool ?? {})) {
+        const key = String(tool || '').trim();
+        if (!key)
+            continue;
+        perTool[key] = normalizePolicy(normalizedBasePolicy, policy);
+    }
+    return {
+        enabled: config?.enabled ?? DEFAULTS.enabled,
+        historySize: Number.isFinite(Number(config?.historySize)) ? Math.max(10, Math.floor(Number(config?.historySize))) : DEFAULTS.historySize,
+        warningThreshold: normalizedBasePolicy.warningThreshold,
+        criticalThreshold: normalizedBasePolicy.criticalThreshold,
+        globalCircuitBreakerThreshold: normalizedBasePolicy.globalCircuitBreakerThreshold,
+        readCacheTtlMs: Number.isFinite(Number(config?.readCacheTtlMs)) ? Math.max(0, Math.floor(Number(config?.readCacheTtlMs))) : DEFAULTS.readCacheTtlMs,
+        detectors: normalizedBasePolicy.detectors,
+        perTool,
+    };
+}
+function resolvePolicyForTool(cfg, toolName) {
+    return cfg.perTool[toolName] ?? {
+        warningThreshold: cfg.warningThreshold,
+        criticalThreshold: cfg.criticalThreshold,
+        globalCircuitBreakerThreshold: cfg.globalCircuitBreakerThreshold,
+        detectors: cfg.detectors,
+    };
+}
+export function stableStringify(value) {
+    if (value === null || value === undefined)
+        return JSON.stringify(value);
+    if (typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        return `[${value.map((v) => stableStringify(v)).join(',')}]`;
+    }
+    const obj = value;
+    const keys = Object.keys(obj).sort();
+    const parts = [];
+    for (const key of keys) {
+        const v = obj[key];
+        if (v === undefined)
+            continue;
+        parts.push(`${JSON.stringify(key)}:${stableStringify(v)}`);
+    }
+    return `{${parts.join(',')}}`;
+}
+function sha256(input) {
+    return crypto.createHash('sha256').update(input).digest('hex');
+}
+export function hashToolArgs(params) {
+    return sha256(stableStringify(params ?? {}));
+}
+export function hashToolCall(toolName, params) {
+    const argsHash = hashToolArgs(params);
+    return {
+        argsHash,
+        signature: `${toolName}:${argsHash}`,
+    };
+}
+function hashToolOutcome(result, error) {
+    if (error != null) {
+        const msg = typeof error === 'string' ? error : error?.message ? String(error.message) : String(error);
+        return `error:${sha256(msg.trim())}`;
+    }
+    const raw = typeof result === 'string' ? result : JSON.stringify(result ?? '');
+    // For large outputs, hash prefix + length to avoid expensive full hashing
+    // This still detects "same outcome" reliably for loop detection purposes
+    if (raw.length > 4096) {
+        const prefix = raw.slice(0, 2048);
+        const suffix = raw.slice(-1024);
+        return `ok:${sha256(`${prefix}...${suffix}|len:${raw.length}`)}`;
+    }
+    return `ok:${sha256(raw ?? '')}`;
+}
+export function recordToolCall(state, toolName, params, toolCallId, config) {
+    const cfg = normalizeConfig(config);
+    const { argsHash, signature } = hashToolCall(toolName, params);
+    const rec = {
+        toolName,
+        argsHash,
+        signature,
+        toolCallId,
+        timestamp: Date.now(),
+    };
+    state.history.push(rec);
+    state.bySignature.set(signature, (state.bySignature.get(signature) ?? 0) + 1);
+    while (state.history.length > cfg.historySize) {
+        const dropped = state.history.shift();
+        if (!dropped)
+            break;
+        const sigCount = (state.bySignature.get(dropped.signature) ?? 0) - 1;
+        if (sigCount > 0)
+            state.bySignature.set(dropped.signature, sigCount);
+        else
+            state.bySignature.delete(dropped.signature);
+        if (dropped.resultHash) {
+            const key = `${dropped.signature}|${dropped.resultHash}`;
+            const outCount = (state.byOutcomeKey.get(key) ?? 0) - 1;
+            if (outCount > 0)
+                state.byOutcomeKey.set(key, outCount);
+            else
+                state.byOutcomeKey.delete(key);
+        }
+    }
+    return rec;
+}
+export function recordToolCallOutcome(state, args, record) {
+    const outHash = hashToolOutcome(args.result, args.error);
+    // If caller passed the record from recordToolCall, use it directly
+    if (record && !record.resultHash) {
+        record.resultHash = outHash;
+    }
+    else {
+        // Fallback: search backwards for matching record without outcome
+        const { signature } = hashToolCall(args.toolName, args.toolParams);
+        for (let i = state.history.length - 1; i >= 0; i--) {
+            const rec = state.history[i];
+            if (rec.signature !== signature)
+                continue;
+            if (args.toolCallId && rec.toolCallId && rec.toolCallId !== args.toolCallId)
+                continue;
+            if (!rec.resultHash) {
+                rec.resultHash = outHash;
+                break;
+            }
+        }
+    }
+    const { signature } = hashToolCall(args.toolName, args.toolParams);
+    const key = `${signature}|${outHash}`;
+    state.byOutcomeKey.set(key, (state.byOutcomeKey.get(key) ?? 0) + 1);
+}
+function consecutiveSignatureStreak(history, signature) {
+    let count = 0;
+    for (let i = history.length - 1; i >= 0; i--) {
+        const rec = history[i];
+        if (rec.signature !== signature)
+            break;
+        count++;
+    }
+    return count;
+}
+function consecutiveOutcomeStreak(history, signature, outcomeHash) {
+    let count = 0;
+    for (let i = history.length - 1; i >= 0; i--) {
+        const rec = history[i];
+        if (rec.signature !== signature)
+            break;
+        if (rec.resultHash !== outcomeHash)
+            break;
+        count++;
+    }
+    return count;
+}
+export function detectToolCallLoop(state, toolName, params, config) {
+    const cfg = normalizeConfig(config);
+    const policy = resolvePolicyForTool(cfg, toolName);
+    const { signature, argsHash } = hashToolCall(toolName, params);
+    if (!cfg.enabled) {
+        return { level: 'none', signature, argsHash, count: 0 };
+    }
+    const genericCount = state.bySignature.get(signature) ?? 0;
+    const signatureStreak = consecutiveSignatureStreak(state.history, signature);
+    if (policy.detectors.genericRepeat && genericCount >= policy.globalCircuitBreakerThreshold) {
+        return {
+            level: 'critical',
+            detector: 'global_circuit_breaker',
+            message: `Global circuit breaker: identical tool signature repeated ${genericCount}x`,
+            signature,
+            argsHash,
+            count: genericCount,
+        };
+    }
+    const latestSameOutcome = [...state.history]
+        .reverse()
+        .find((h) => h.signature === signature && typeof h.resultHash === 'string' && h.resultHash.length > 0);
+    const outcomeKey = latestSameOutcome?.resultHash ? `${signature}|${latestSameOutcome.resultHash}` : '';
+    const outcomeCount = outcomeKey ? (state.byOutcomeKey.get(outcomeKey) ?? 0) : 0;
+    const outcomeStreak = latestSameOutcome?.resultHash
+        ? consecutiveOutcomeStreak(state.history, signature, latestSameOutcome.resultHash)
+        : 0;
+    if (policy.detectors.knownPollNoProgress &&
+        KNOWN_POLL_TOOLS.has(toolName) &&
+        Math.max(outcomeCount, outcomeStreak) >= policy.criticalThreshold) {
+        const count = Math.max(outcomeCount, outcomeStreak);
+        return {
+            level: 'critical',
+            detector: 'known_poll_no_progress',
+            message: `${toolName} repeated with no outcome change (${count}x)`,
+            signature,
+            argsHash,
+            count,
+        };
+    }
+    if (policy.detectors.pingPong && state.history.length >= 4) {
+        const tail = state.history.slice(-4);
+        const [a, b, c, d] = tail;
+        // Ping-pong: A→B→A→B with same outcomes each time
+        // But only flag if at least one is a read-only tool (avoid false positives on legitimate edit patterns)
+        const readOnlyTools = new Set(['read_file', 'read_files', 'list_dir', 'search_files', 'exec']);
+        const isAReadOnly = readOnlyTools.has(a.toolName);
+        const isBReadOnly = readOnlyTools.has(b.toolName);
+        const hasReadOnly = isAReadOnly || isBReadOnly;
+        if (hasReadOnly &&
+            a.signature === c.signature &&
+            b.signature === d.signature &&
+            a.signature !== b.signature &&
+            a.resultHash && b.resultHash && c.resultHash && d.resultHash &&
+            a.resultHash === c.resultHash &&
+            b.resultHash === d.resultHash) {
+            return {
+                level: 'warning',
+                detector: 'ping_pong',
+                message: `Detected ping-pong tool loop between ${a.toolName} and ${b.toolName}`,
+                signature,
+                argsHash,
+                count: 4,
+            };
+        }
+    }
+    if (policy.detectors.genericRepeat) {
+        const repeatCount = Math.max(outcomeStreak, signatureStreak);
+        if (repeatCount >= policy.criticalThreshold) {
+            return {
+                level: 'critical',
+                detector: 'generic_repeat',
+                message: `Repeated identical tool call with no meaningful change (${repeatCount}x)`,
+                signature,
+                argsHash,
+                count: repeatCount,
+            };
+        }
+        if (repeatCount >= policy.warningThreshold) {
+            return {
+                level: 'warning',
+                detector: 'generic_repeat',
+                message: `Repeated identical tool call detected (${repeatCount}x)`,
+                signature,
+                argsHash,
+                count: repeatCount,
+            };
+        }
+    }
+    return { level: 'none', signature, argsHash, count: Math.max(outcomeStreak, signatureStreak) };
+}
+export function getToolCallStats(state) {
+    const signatures = [...state.bySignature.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .map(([signature, count]) => ({ signature, count }));
+    const outcomes = [...state.byOutcomeKey.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .map(([key, count]) => ({ key, count }));
+    return {
+        totalHistory: state.history.length,
+        signatures,
+        outcomes,
+    };
+}
+//# sourceMappingURL=tool-loop-detection.js.map

package/dist/agent/tool-loop-detection.js.map

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

package/dist/agent/tool-loop-guard.js

@@ -0,0 +1,235 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { createToolLoopState, detectToolCallLoop, getToolCallStats, hashToolCall, recordToolCall, recordToolCallOutcome, stableStringify, } from './tool-loop-detection.js';
+export class ToolLoopGuard {
+    loopState = createToolLoopState();
+    readCache = new Map();
+    config;
+    recordByCallId = new Map();
+    telemetry = {
+        callsRegistered: 0,
+        dedupedReplays: 0,
+        readCacheLookups: 0,
+        readCacheHits: 0,
+        warnings: 0,
+        criticals: 0,
+        recoveryRecommended: 0,
+    };
+    constructor(config) {
+        this.config = {
+            enabled: config?.enabled ?? true,
+            historySize: config?.historySize ?? 30,
+            warningThreshold: config?.warningThreshold ?? 4,
+            criticalThreshold: config?.criticalThreshold ?? 8,
+            globalCircuitBreakerThreshold: config?.globalCircuitBreakerThreshold ?? 12,
+            readCacheTtlMs: config?.readCacheTtlMs ?? 15_000,
+            detectors: {
+                genericRepeat: config?.detectors?.genericRepeat ?? true,
+                knownPollNoProgress: config?.detectors?.knownPollNoProgress ?? true,
+                pingPong: config?.detectors?.pingPong ?? true,
+            },
+            perTool: config?.perTool ?? {},
+        };
+    }
+    parseArgs(raw) {
+        try {
+            const parsed = raw ? JSON.parse(raw) : {};
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            // keep below
+        }
+        return {};
+    }
+    computeSignature(toolName, args) {
+        return hashToolCall(toolName, args).signature;
+    }
+    prepareTurn(toolCalls) {
+        const uniqueCalls = [];
+        const replayByCallId = new Map();
+        const canonicalBySig = new Map();
+        const signatureByCallId = new Map();
+        const parsedArgsByCallId = new Map();
+        for (const tc of toolCalls) {
+            const toolName = tc.function?.name ?? '';
+            const callId = tc.id ?? `${toolName}:${Date.now()}:${Math.random().toString(36).slice(2, 8)}`;
+            if (!tc.id)
+                tc.id = callId;
+            const args = this.parseArgs(tc.function?.arguments ?? '{}');
+            const sig = this.computeSignature(toolName, args);
+            signatureByCallId.set(callId, sig);
+            parsedArgsByCallId.set(callId, args);
+            const canonicalId = canonicalBySig.get(sig);
+            if (!canonicalId) {
+                canonicalBySig.set(sig, callId);
+                uniqueCalls.push(tc);
+            }
+            else {
+                replayByCallId.set(callId, canonicalId);
+            }
+        }
+        this.telemetry.dedupedReplays += replayByCallId.size;
+        return { uniqueCalls, replayByCallId, signatureByCallId, parsedArgsByCallId };
+    }
+    detect(toolName, args) {
+        const detected = detectToolCallLoop(this.loopState, toolName, args, this.config);
+        if (detected.level === 'warning')
+            this.telemetry.warnings += 1;
+        if (detected.level === 'critical')
+            this.telemetry.criticals += 1;
+        return detected;
+    }
+    registerCall(toolName, args, toolCallId) {
+        const rec = recordToolCall(this.loopState, toolName, args, toolCallId, this.config);
+        this.telemetry.callsRegistered += 1;
+        if (toolCallId) {
+            this.recordByCallId.set(toolCallId, rec);
+        }
+    }
+    registerOutcome(toolName, args, outcome) {
+        const record = outcome.toolCallId ? this.recordByCallId.get(outcome.toolCallId) : undefined;
+        recordToolCallOutcome(this.loopState, {
+            toolName,
+            toolParams: args,
+            toolCallId: outcome.toolCallId,
+            result: outcome.result,
+            error: outcome.error,
+        }, record);
+        // Clean up the record reference after outcome is recorded
+        if (outcome.toolCallId) {
+            this.recordByCallId.delete(outcome.toolCallId);
+        }
+    }
+    getStats() {
+        const base = getToolCallStats(this.loopState);
+        const readCacheHitRate = this.telemetry.readCacheLookups > 0
+            ? this.telemetry.readCacheHits / this.telemetry.readCacheLookups
+            : 0;
+        const dedupeRate = this.telemetry.callsRegistered > 0
+            ? this.telemetry.dedupedReplays / this.telemetry.callsRegistered
+            : 0;
+        return {
+            ...base,
+            telemetry: {
+                ...this.telemetry,
+                readCacheHitRate,
+                dedupeRate,
+            },
+        };
+    }
+    shouldDisableToolsNextTurn(result) {
+        const should = result.level === 'critical';
+        if (should)
+            this.telemetry.recoveryRecommended += 1;
+        return should;
+    }
+    async getReadCacheReplay(toolName, args, cwd) {
+        if (!isReadCacheableTool(toolName))
+            return null;
+        this.telemetry.readCacheLookups += 1;
+        const sig = this.computeSignature(toolName, args);
+        const cached = this.readCache.get(sig);
+        if (!cached)
+            return null;
+        if (typeof this.config.readCacheTtlMs === 'number' && this.config.readCacheTtlMs > 0) {
+            if (Date.now() - cached.cachedAt > this.config.readCacheTtlMs) {
+                this.readCache.delete(sig);
+                return null;
+            }
+        }
+        const { paths } = extractReadPaths(toolName, args, cwd);
+        if (!paths.length || paths.length !== cached.paths.length) {
+            this.readCache.delete(sig);
+            return null;
+        }
+        const versions = await Promise.all(paths.map((p) => getResourceVersion(p)));
+        const stillValid = versions.every((v, i) => Boolean(v) && v === cached.versions[i]);
+        if (!stillValid) {
+            this.readCache.delete(sig);
+            return null;
+        }
+        this.telemetry.readCacheHits += 1;
+        return makeCacheHint(toolName);
+    }
+    async storeReadCache(toolName, args, cwd, content) {
+        if (!isReadCacheableTool(toolName))
+            return;
+        if (content.startsWith('ERROR:'))
+            return;
+        const { paths } = extractReadPaths(toolName, args, cwd);
+        if (!paths.length)
+            return;
+        const versions = await Promise.all(paths.map((p) => getResourceVersion(p)));
+        if (versions.some((v) => !v))
+            return;
+        const sig = this.computeSignature(toolName, args);
+        this.readCache.set(sig, {
+            content,
+            paths,
+            versions: versions,
+            cachedAt: Date.now(),
+        });
+    }
+    formatWarning(result, toolName) {
+        if (result.level === 'none')
+            return null;
+        return {
+            level: result.level,
+            detector: result.detector ?? 'generic_repeat',
+            toolName,
+            count: result.count,
+            message: result.message ?? `${toolName}: repeated identical tool call detected`,
+        };
+    }
+}
+function isReadCacheableTool(toolName) {
+    return toolName === 'read_file' || toolName === 'read_files' || toolName === 'list_dir';
+}
+function makeCacheHint(toolName) {
+    if (toolName === 'read_file')
+        return '[CACHE HIT] File unchanged since previous read. Use the content you already have.';
+    if (toolName === 'read_files')
+        return '[CACHE HIT] Files unchanged since previous read. Use the content you already have.';
+    if (toolName === 'list_dir')
+        return '[CACHE HIT] Directory unchanged since previous read. Use the content you already have.';
+    return '[CACHE HIT] Resource unchanged since previous read. Use the content you already have.';
+}
+function resolveWithCwd(baseCwd, p) {
+    return path.resolve(baseCwd, p);
+}
+function extractReadPaths(toolName, args, cwd) {
+    if (toolName === 'read_file' || toolName === 'list_dir') {
+        const p = typeof args.path === 'string' ? args.path.trim() : '';
+        if (!p)
+            return { paths: [] };
+        return { paths: [resolveWithCwd(cwd, p)] };
+    }
+    if (toolName === 'read_files') {
+        const reqs = args?.requests;
+        if (!Array.isArray(reqs))
+            return { paths: [] };
+        const paths = [];
+        for (const req of reqs) {
+            const p = typeof req?.path === 'string' ? req.path.trim() : '';
+            if (p)
+                paths.push(resolveWithCwd(cwd, p));
+        }
+        return { paths };
+    }
+    return { paths: [] };
+}
+async function getResourceVersion(absPath) {
+    try {
+        const stat = await fs.stat(absPath);
+        return `${absPath}:${stat.mtimeMs}:${stat.size}`;
+    }
+    catch {
+        return null;
+    }
+}
+export function stableToolArgsForTests(v) {
+    return stableStringify(v);
+}
+//# sourceMappingURL=tool-loop-guard.js.map

package/dist/agent/tool-loop-guard.js.map

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