@visorcraft/idlehands 2.2.7 → 2.2.9

package/dist/agent/compaction-scoring.js

@@ -0,0 +1,113 @@
+/**
+ * Information density scoring for smart compaction.
+ *
+ * Scores messages by how valuable they are to keep in context,
+ * so compaction can prioritize dropping low-value messages first.
+ *
+ * Higher score = more valuable = keep longer.
+ */
+/**
+ * Score a conversation message for compaction priority.
+ * Returns 0-100 where higher = more important to keep.
+ */
+export function scoreMessage(msg, index, totalMessages, opts) {
+    let score = 50; // baseline
+    const reasons = [];
+    const content = typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content ?? '');
+    const contentLen = content.length;
+    // ── Role-based scoring ──
+    if (msg.role === 'system') {
+        return { index, score: 100, reason: 'system prompt (never drop)' };
+    }
+    if (msg.role === 'user') {
+        score += 15; // User messages are important context
+        reasons.push('user');
+        // Last user message is critical
+        if (index >= totalMessages - 3) {
+            score += 30;
+            reasons.push('recent');
+        }
+    }
+    if (msg.role === 'assistant') {
+        // Assistant messages with code are high-value
+        if (content.includes('```')) {
+            score += 20;
+            reasons.push('has_code');
+        }
+        // Assistant messages with substantive text (not just tool calls)
+        if (contentLen > 200 && !msg.tool_calls?.length) {
+            score += 10;
+            reasons.push('substantive');
+        }
+        // Planning/thinking text is lower value once executed
+        if (msg.tool_calls?.length && contentLen < 100) {
+            score -= 15;
+            reasons.push('thin_planning');
+        }
+    }
+    if (msg.role === 'tool') {
+        // Tool results for read operations are generally low-value (can be re-read)
+        if (content.includes('[read_file]') || content.includes('[list_dir]')) {
+            score -= 20;
+            reasons.push('read_result');
+        }
+        // Error messages are important (prevent re-attempting)
+        if (content.includes('ERROR') || content.includes('error:') || content.includes('failed')) {
+            score += 15;
+            reasons.push('has_error');
+        }
+        // Very long tool results are candidates for dropping (bulky)
+        if (contentLen > 3000) {
+            score -= 10;
+            reasons.push('bulky');
+        }
+    }
+    // ── Recency bonus ──
+    // Messages near the end of the conversation are more valuable
+    const recencyRatio = index / totalMessages;
+    if (recencyRatio > 0.8) {
+        score += 25;
+        reasons.push('very_recent');
+    }
+    else if (recencyRatio > 0.5) {
+        score += 10;
+        reasons.push('recent_half');
+    }
+    // ── Active file relevance ──
+    if (opts?.activeFiles?.size) {
+        for (const file of opts.activeFiles) {
+            const basename = file.split('/').pop() ?? '';
+            if (content.includes(basename)) {
+                score += 15;
+                reasons.push('active_file');
+                break;
+            }
+        }
+    }
+    // ── Instruction relevance ──
+    if (opts?.lastInstruction) {
+        const keywords = opts.lastInstruction.toLowerCase().split(/\s+/).filter(w => w.length > 3);
+        const contentLower = content.toLowerCase();
+        const hits = keywords.filter(k => contentLower.includes(k)).length;
+        if (hits > 2) {
+            score += 10;
+            reasons.push('relevant');
+        }
+    }
+    return {
+        index,
+        score: Math.max(0, Math.min(100, score)),
+        reason: reasons.join(', ') || 'baseline',
+    };
+}
+/**
+ * Given scored messages, return indices to drop (sorted lowest score first)
+ * until the token budget target is met.
+ */
+export function selectDropCandidates(scored, opts) {
+    const candidates = scored
+        .filter(s => s.index >= opts.minIndex && s.index <= opts.maxIndex && s.score < 100)
+        .sort((a, b) => a.score - b.score); // lowest score first
+    return candidates.slice(0, opts.targetDrop).map(c => c.index);
+}
+//# sourceMappingURL=compaction-scoring.js.map

package/dist/agent/compaction-scoring.js.map

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

package/dist/agent.js

@@ -41,6 +41,7 @@ import { normalizeApprovalMode } from './shared/config-utils.js';
 import { collectSnapshot } from './sys/context.js';
 import { ToolError, ValidationError } from './tools/tool-error.js';
 import * as tools from './tools.js';
+import { EditTransaction } from './tools/transaction.js';
 import { stateDir, timestampedId } from './utils.js';
 import { VaultStore } from './vault.js';
 export { parseToolCallsFromContent };
@@ -489,6 +490,7 @@ export async function createSession(opts) {
     let inFlight = null;
     let initialConnectionProbeDone = false;
     let lastEditedPath;
+    let lastTurnTransaction;
     // Plan mode state (Phase 8)
     let planSteps = [];
     // Sub-agent queue state (Phase 18): enforce sequential execution on single-GPU setups.
@@ -3002,6 +3004,8 @@ export async function createSession(opts) {
                             const absPath = args.path.startsWith('/')
                                 ? args.path
                                 : path.resolve(projectDir, args.path);
+                            // Track in turn transaction for potential atomic rollback.
+                            turnTransaction.track(absPath);
                             // ── Pre-dispatch: block edits to files in a mutation spiral ──
                             if (fileMutationBlocked.has(absPath)) {
                                 const basename = path.basename(absPath);
@@ -3493,6 +3497,7 @@ export async function createSession(opts) {
                         return { id: callId, content: truncated.content };
                     };
                     const results = [];
+                    const turnTransaction = new EditTransaction();
                     let invalidArgsThisTurn = false;
                     // Helper: catch tool errors but re-throw AgentLoopBreak (those must break the outer loop)
                     const catchToolError = async (e, tc) => {
@@ -3647,6 +3652,11 @@ export async function createSession(opts) {
                             });
                         }
                     }
+                    // Store the turn transaction for potential post-turn rollback.
+                    if (turnTransaction.hasChanges) {
+                        turnTransaction.commit();
+                        lastTurnTransaction = turnTransaction;
+                    }
                     // Bail immediately if cancelled during tool execution
                     if (ac.signal.aborted)
                         break;
@@ -3918,6 +3928,16 @@ export async function createSession(opts) {
             return currentContextTokens > 0 ? currentContextTokens : estimateTokensFromMessages(messages);
         },
         ask,
+        rollbackLastTurnEdits: async () => {
+            if (!lastTurnTransaction || !lastTurnTransaction.hasChanges) {
+                return { ok: false, error: 'No file edits to roll back.' };
+            }
+            const tx = lastTurnTransaction;
+            lastTurnTransaction = undefined;
+            const callCtx = { cwd: projectDir, noConfirm: true, dryRun: false };
+            const results = await tx.rollback(callCtx);
+            return { ok: true, results };
+        },
         rollback: () => {
             const cp = conversationBranch.rollback();
             if (!cp)