@burtson-labs/agent-core 1.6.13

package/dist/tools/compactMessages.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * Message-history compaction for the tool-use loop.
+ *
+ * Why this exists:
+ *   The loop appends every tool result as a `user` message carrying
+ *   the raw output (read_file content, search_code hits, command
+ *   stdout). After ~6 iterations on a medium-sized codebase the
+ *   cumulative tool output is ~12-18k tokens — enough to push past
+ *   the Ollama num_ctx ceiling on small/medium models, which causes
+ *   silent front-truncation of the system prompt (the exact failure
+ *   mode that made `bandit-core:12b-it-qat` appear to "refuse" C#
+ *   edits until num_ctx was properly configured).
+ *
+ * Strategy (deterministic, no extra LLM calls):
+ *   1. Count tokens with a cheap char/4 heuristic.
+ *   2. If the total fits a configurable budget, return as-is.
+ *   3. Otherwise, walk the message list from oldest to newest and
+ *      replace the *body* of earlier tool-result messages with a
+ *      one-line placeholder ("[read_file api/foo.cs — 412 lines, see
+ *      earlier]"). We always keep the system prompt, the initial user
+ *      prompt, the last N tool results in full, and any assistant
+ *      message that contains a tool call (the model needs to see its
+ *      own prior reasoning).
+ *
+ * The compacted messages retain the same `role` / `content` shape so
+ * the loop doesn't need to change — it just passes them through chat.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compactToolMessages = compactToolMessages;
+const DEFAULT_BUDGET = 12000;
+// Bumped 2 → 4 (2026-05-06): keepRecent = 2 over-collapsed traces where
+// the most recent two tool results were tiny (e.g. `check_task` returns
+// 78 chars each). Trace 23-34Z went 30k → 3.5k tokens at iter 7 because
+// the last two surviving in-full results were small `check_task` polls,
+// and every substantive read got replaced with a 1-line placeholder.
+// 4 keeps enough recent reads in full to give the model real working
+// material on the next iteration without ballooning back over budget.
+const DEFAULT_KEEP_RECENT = 4;
+const DEFAULT_CPT = 4;
+const TOOL_RESULT_PREFIX = '<tool_result name="';
+/** Heuristic token count — good enough for budget checks. */
+function estimateTokens(content, cpt) {
+    return Math.ceil(content.length / cpt);
+}
+function isToolResultMessage(msg) {
+    return msg.role === 'user' && msg.content.startsWith(TOOL_RESULT_PREFIX);
+}
+/**
+ * Extract the tool name + first interesting line from a tool_result
+ * envelope so the placeholder carries enough signal for the model to
+ * know what it already saw.
+ */
+function summarizeToolResult(content) {
+    const nameMatch = content.match(/<tool_result name="([^"]+)"/);
+    const toolName = nameMatch?.[1] ?? 'tool';
+    // First non-tag line of the body.
+    const bodyStart = content.indexOf('>');
+    const body = bodyStart >= 0 ? content.slice(bodyStart + 1) : content;
+    const firstLine = body.split('\n').find((l) => l.trim().length > 0)?.trim() ?? '';
+    const shortFirst = firstLine.length > 80 ? firstLine.slice(0, 77) + '…' : firstLine;
+    const lineCount = body.split('\n').filter((l) => l.length > 0).length;
+    return `<tool_result name="${toolName}">[earlier run, ${lineCount} lines elided — summary: ${shortFirst}]</tool_result>`;
+}
+/**
+ * Main entry point. Returns compacted messages plus a report of what
+ * changed. Callers can log the report so agents/CLIs can surface
+ * "compacted history — N msgs, saved X tokens" as a status line.
+ */
+function compactToolMessages(messages, options = {}) {
+    const budget = options.tokenBudget ?? DEFAULT_BUDGET;
+    const keepRecent = options.keepRecentToolResults ?? DEFAULT_KEEP_RECENT;
+    const cpt = options.charsPerToken ?? DEFAULT_CPT;
+    const beforeTokens = messages.reduce((acc, m) => acc + estimateTokens(m.content, cpt), 0);
+    if (beforeTokens <= budget) {
+        return {
+            compacted: messages,
+            beforeTokens,
+            afterTokens: beforeTokens,
+            messagesCompacted: 0
+        };
+    }
+    // Index tool-result messages so we can decide which to summarize.
+    const toolResultIndices = [];
+    for (let i = 0; i < messages.length; i++) {
+        if (isToolResultMessage(messages[i]))
+            toolResultIndices.push(i);
+    }
+    // Greedy compaction (2026-05-06): summarize OLDEST tool results first
+    // and stop the moment we drop under budget. Previously we summarized
+    // every tool result except the last `keepRecent` in one pass —
+    // regardless of whether fewer summarizations would already fit. The
+    // self-eval trace went 30k → 3.5k tokens at iter 7 because of that,
+    // even though dropping the single oldest huge read would have been
+    // enough to clear budget. Greedy keeps as much real context in front
+    // of the model as possible.
+    //
+    // Floor: never summarize the most recent `keepRecent` tool results
+    // even if we're still over budget after exhausting the older ones —
+    // those go to the message-drop branch below instead.
+    const minKeepInFull = Math.min(toolResultIndices.length, keepRecent);
+    const summarizableIndices = toolResultIndices.slice(0, toolResultIndices.length - minKeepInFull);
+    const summarized = new Set();
+    let estimatedAfter = beforeTokens;
+    for (const idx of summarizableIndices) {
+        if (estimatedAfter <= budget)
+            break;
+        const original = messages[idx].content;
+        const summary = summarizeToolResult(original);
+        estimatedAfter -= estimateTokens(original, cpt);
+        estimatedAfter += estimateTokens(summary, cpt);
+        summarized.add(idx);
+    }
+    const out = [];
+    let messagesCompacted = 0;
+    for (let i = 0; i < messages.length; i++) {
+        if (summarized.has(i)) {
+            out.push({ role: messages[i].role, content: summarizeToolResult(messages[i].content) });
+            messagesCompacted++;
+        }
+        else {
+            out.push(messages[i]);
+        }
+    }
+    let afterTokens = out.reduce((acc, m) => acc + estimateTokens(m.content, cpt), 0);
+    // Still over budget after compacting tool results? Drop the oldest
+    // non-system, non-first-user messages until we fit. This is the
+    // "last resort" branch — well within budget in normal usage.
+    if (afterTokens > budget) {
+        const systemIndices = new Set();
+        const firstUserIndex = out.findIndex((m) => m.role === 'user');
+        out.forEach((m, i) => {
+            if (m.role === 'system')
+                systemIndices.add(i);
+        });
+        // Walk forward from iteration after the first user, drop messages
+        // until budget fits or we hit the last two (needed for model state).
+        let i = firstUserIndex + 1;
+        while (afterTokens > budget && i < out.length - 2) {
+            if (systemIndices.has(i)) {
+                i++;
+                continue;
+            }
+            const droppedTokens = estimateTokens(out[i].content, cpt);
+            out.splice(i, 1);
+            afterTokens -= droppedTokens;
+            messagesCompacted++;
+            // Don't advance i — splice shifted subsequent messages left.
+        }
+    }
+    return {
+        compacted: out,
+        beforeTokens,
+        afterTokens,
+        messagesCompacted
+    };
+}
+//# sourceMappingURL=compactMessages.js.map

package/dist/tools/compactMessages.js.map

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

package/dist/tools/core-tools.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Core agent tools: read_file, write_file, apply_edit, replace_range, list_files, search_code, run_command.
+ *
+ * All tools delegate to the injected ToolExecutionContext — no direct
+ * dependency on Node.js APIs, VS Code, or any specific host.
+ */
+import type { AgentTool } from './tool-types';
+import { ToolRegistry } from './tool-registry';
+declare const readFileTool: AgentTool;
+declare const writeFileTool: AgentTool;
+declare const deleteFileTool: AgentTool;
+declare const applyEditTool: AgentTool;
+declare const replaceRangeTool: AgentTool;
+declare const applyPatchTool: AgentTool;
+declare const listFilesTool: AgentTool;
+declare const lsTool: AgentTool;
+declare const findDirectoryTool: AgentTool;
+declare const searchCodeTool: AgentTool;
+declare const runCommandTool: AgentTool;
+declare const watchCommandTool: AgentTool;
+/**
+ * Returns a ToolRegistry pre-loaded with all core tools.
+ * Pass the result to ToolUseLoop or use it standalone.
+ * Git tools are registered separately via createGitToolRegistry() and
+ * can be merged with registry.registerAll([...gitRegistry.getAll()]).
+ */
+export declare function createCoreToolRegistry(): ToolRegistry;
+export { readFileTool, writeFileTool, deleteFileTool, applyEditTool, replaceRangeTool, applyPatchTool, listFilesTool, lsTool, findDirectoryTool, searchCodeTool, runCommandTool, watchCommandTool };
+//# sourceMappingURL=core-tools.d.ts.map

package/dist/tools/core-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-tools.d.ts","sourceRoot":"","sources":["../../src/tools/core-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAoC,MAAM,cAAc,CAAC;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA+G/C,QAAA,MAAM,YAAY,EAAE,SAuGnB,CAAC;AAIF,QAAA,MAAM,aAAa,EAAE,SAqFpB,CAAC;AAYF,QAAA,MAAM,cAAc,EAAE,SAgDrB,CAAC;AAoBF,QAAA,MAAM,aAAa,EAAE,SA6VpB,CAAC;AAQF,QAAA,MAAM,gBAAgB,EAAE,SAgJvB,CAAC;AA2BF,QAAA,MAAM,cAAc,EAAE,SA0TrB,CAAC;AAyPF,QAAA,MAAM,aAAa,EAAE,SAyBpB,CAAC;AAQF,QAAA,MAAM,MAAM,EAAE,SAqCb,CAAC;AA2DF,QAAA,MAAM,iBAAiB,EAAE,SA6FxB,CAAC;AAIF,QAAA,MAAM,cAAc,EAAE,SAwBrB,CAAC;AAyRF,QAAA,MAAM,cAAc,EAAE,SAqFrB,CAAC;AAmBF,QAAA,MAAM,gBAAgB,EAAE,SAqFvB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAerD;AAED,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,gBAAgB,EACjB,CAAC"}