@burtson-labs/agent-core 1.6.13

package/dist/tools/language-adapters.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Language-aware pre-write validation adapters.
+ *
+ * Each adapter checks file content for syntax errors *before* write_file
+ * commits the content to disk. On failure the tool returns an isError result
+ * so the model can self-correct without ever writing an invalid file.
+ *
+ * All subprocess-based adapters (Python, TypeScript, C#) silently pass through
+ * (ok: true) when the required runtime / compiler is not found on PATH, so the
+ * agent degrades gracefully on systems without those tools installed.
+ *
+ * Adapter routing is by file extension (without leading dot, e.g. "ts").
+ */
+import type { ToolExecutionContext, ILanguageAdapterRegistry, ValidationResult } from './tool-types';
+export interface LanguageAdapter {
+    /** File extensions this adapter handles, without leading dot (e.g. ['ts', 'tsx']). */
+    extensions: string[];
+    validate(filePath: string, content: string, ctx: ToolExecutionContext): Promise<ValidationResult>;
+}
+export declare class LanguageAdapterRegistry implements ILanguageAdapterRegistry {
+    private readonly adapters;
+    register(adapter: LanguageAdapter): this;
+    validate(filePath: string, content: string, ctx: ToolExecutionContext): Promise<ValidationResult>;
+}
+export declare class JsonAdapter implements LanguageAdapter {
+    readonly extensions: string[];
+    validate(_filePath: string, content: string, _ctx: ToolExecutionContext): Promise<ValidationResult>;
+}
+export declare class PythonAdapter implements LanguageAdapter {
+    readonly extensions: string[];
+    validate(_filePath: string, content: string, ctx: ToolExecutionContext): Promise<ValidationResult>;
+}
+export declare class TypeScriptAdapter implements LanguageAdapter {
+    readonly extensions: string[];
+    validate(_filePath: string, content: string, ctx: ToolExecutionContext): Promise<ValidationResult>;
+}
+export declare class CSharpAdapter implements LanguageAdapter {
+    readonly extensions: string[];
+    validate(_filePath: string, content: string, ctx: ToolExecutionContext): Promise<ValidationResult>;
+}
+/**
+ * Creates a registry pre-loaded with all built-in language adapters:
+ * JSON, Python, TypeScript/TSX, and C#.
+ *
+ * Each adapter silently passes through when its runtime/compiler is unavailable.
+ */
+export declare function createDefaultLanguageAdapters(): LanguageAdapterRegistry;
+//# sourceMappingURL=language-adapters.d.ts.map

package/dist/tools/language-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-adapters.d.ts","sourceRoot":"","sources":["../../src/tools/language-adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIrG,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACnG;AAID,qBAAa,uBAAwB,YAAW,wBAAwB;IACtE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAElD,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAKlC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAQxG;AAID,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,CAAC,UAAU,WAAY;IAEzB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAQ1G;AAID,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,UAAU,WAAU;IAEvB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAczG;AAID,qBAAa,iBAAkB,YAAW,eAAe;IACvD,QAAQ,CAAC,UAAU,WAAiB;IAE9B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA2BzG;AAsFD,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,UAAU,WAAU;IAEvB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAoCzG;AAID;;;;;GAKG;AACH,wBAAgB,6BAA6B,IAAI,uBAAuB,CAMvE"}

package/dist/tools/language-adapters.js

@@ -0,0 +1,299 @@
+"use strict";
+/**
+ * Language-aware pre-write validation adapters.
+ *
+ * Each adapter checks file content for syntax errors *before* write_file
+ * commits the content to disk. On failure the tool returns an isError result
+ * so the model can self-correct without ever writing an invalid file.
+ *
+ * All subprocess-based adapters (Python, TypeScript, C#) silently pass through
+ * (ok: true) when the required runtime / compiler is not found on PATH, so the
+ * agent degrades gracefully on systems without those tools installed.
+ *
+ * Adapter routing is by file extension (without leading dot, e.g. "ts").
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CSharpAdapter = exports.TypeScriptAdapter = exports.PythonAdapter = exports.JsonAdapter = exports.LanguageAdapterRegistry = void 0;
+exports.createDefaultLanguageAdapters = createDefaultLanguageAdapters;
+const path = __importStar(require("path"));
+// ── Registry ─────────────────────────────────────────────────────────────────
+class LanguageAdapterRegistry {
+    constructor() {
+        this.adapters = [];
+    }
+    register(adapter) {
+        this.adapters.push(adapter);
+        return this;
+    }
+    async validate(filePath, content, ctx) {
+        const ext = path.extname(filePath).slice(1).toLowerCase();
+        const adapter = this.adapters.find(a => a.extensions.includes(ext));
+        if (!adapter) {
+            return { ok: true };
+        }
+        return adapter.validate(filePath, content, ctx);
+    }
+}
+exports.LanguageAdapterRegistry = LanguageAdapterRegistry;
+// ── JSON adapter ──────────────────────────────────────────────────────────────
+class JsonAdapter {
+    constructor() {
+        this.extensions = ['json'];
+    }
+    async validate(_filePath, content, _ctx) {
+        try {
+            JSON.parse(content);
+            return { ok: true };
+        }
+        catch (err) {
+            return { ok: false, error: `JSON syntax error: ${err.message}` };
+        }
+    }
+}
+exports.JsonAdapter = JsonAdapter;
+// ── Python adapter ────────────────────────────────────────────────────────────
+class PythonAdapter {
+    constructor() {
+        this.extensions = ['py'];
+    }
+    async validate(_filePath, content, ctx) {
+        // Base64-encode to avoid all shell-quoting issues (base64 chars: A-Za-z0-9+/=).
+        const b64 = Buffer.from(content).toString('base64');
+        const result = await ctx.runCommand('python3', ['-c', `import ast, base64; ast.parse(base64.b64decode("${b64}").decode())`]);
+        // exitCode 127 = command not found (python3 not on PATH) → pass through
+        if (result.exitCode === 0 || result.exitCode === 127) {
+            return { ok: true };
+        }
+        const detail = (result.stderr || result.stdout).trim();
+        return { ok: false, error: `Python syntax error:\n${detail}` };
+    }
+}
+exports.PythonAdapter = PythonAdapter;
+// ── TypeScript / TSX adapter ──────────────────────────────────────────────────
+class TypeScriptAdapter {
+    constructor() {
+        this.extensions = ['ts', 'tsx'];
+    }
+    async validate(_filePath, content, ctx) {
+        // Base64-encode content so it can be safely embedded in the node -e script.
+        const b64 = Buffer.from(content).toString('base64');
+        // The script tries to require 'typescript' from the workspace node_modules.
+        // If TypeScript is not installed, the catch block exits 0 (silent skip).
+        // ts.transpileModule() is the standard public API for isolated syntax checking —
+        // it reports parse errors without needing a full compiler project.
+        const script = [
+            'try{',
+            "const ts=require('typescript');",
+            `const r=ts.transpileModule(Buffer.from('${b64}','base64').toString(),`,
+            '{reportDiagnostics:true,compilerOptions:{strict:false,skipLibCheck:true}});',
+            'const d=r.diagnostics||[];',
+            'if(d.length){',
+            "process.stdout.write(d.map(x=>typeof x.messageText==='string'?x.messageText:x.messageText.messageText).join('\\n'));",
+            'process.exit(1);}',
+            '}catch(e){process.exit(0);}' // TypeScript package not found → skip
+        ].join('');
+        const result = await ctx.runCommand('node', ['-e', script], ctx.workspaceRoot);
+        if (result.exitCode !== 0) {
+            const detail = (result.stdout || result.stderr).trim();
+            return { ok: false, error: `TypeScript syntax error:\n${detail}` };
+        }
+        return { ok: true };
+    }
+}
+exports.TypeScriptAdapter = TypeScriptAdapter;
+// ── C# adapter ────────────────────────────────────────────────────────────────
+/**
+ * Cheap C# sanity check that runs even when no Mono/.NET SDK is installed.
+ * Catches the common `apply_edit` corruption mode on
+ * S3Api/FileController.cs — the final edit left orphaned method-body
+ * fragments *after* the class's closing brace, which csc catches as
+ * CS1022/CS1008 but silently passes when csc is absent (the adapter
+ * exits 0 on ENOENT as a deliberate skip).
+ *
+ * Strict bracket balancing only — no parser, no AST. String literals
+ * and `//` / `/* ... *\/` comments are skipped so braces inside them
+ * don't confuse the count. False positives on weird but legal code are
+ * possible but rare; the trade-off is cheap universal coverage vs zero
+ * coverage without a toolchain.
+ */
+function cSharpStructureCheck(content) {
+    let braces = 0;
+    let parens = 0;
+    let brackets = 0;
+    let i = 0;
+    const n = content.length;
+    while (i < n) {
+        const ch = content[i];
+        // Line comment — skip to newline.
+        if (ch === '/' && content[i + 1] === '/') {
+            while (i < n && content[i] !== '\n')
+                i++;
+            continue;
+        }
+        // Block comment — skip to closing */.
+        if (ch === '/' && content[i + 1] === '*') {
+            i += 2;
+            while (i < n && !(content[i] === '*' && content[i + 1] === '/'))
+                i++;
+            i += 2;
+            continue;
+        }
+        // String / char / verbatim-string / interpolated-string — skip to
+        // the matching delimiter. Interpolated strings can contain braces
+        // that are NOT structural, so we must not count them.
+        if (ch === '"' || ch === '\'' || (ch === '@' && content[i + 1] === '"') || (ch === '$' && content[i + 1] === '"')) {
+            const verbatim = ch === '@';
+            const interpolated = ch === '$';
+            const quote = verbatim || interpolated ? '"' : ch;
+            i += verbatim || interpolated ? 2 : 1;
+            let interpDepth = 0;
+            while (i < n) {
+                const c = content[i];
+                if (!verbatim && c === '\\' && content[i + 1] !== undefined) {
+                    i += 2;
+                    continue;
+                }
+                if (interpolated && c === '{' && content[i + 1] !== '{') {
+                    interpDepth++;
+                    i++;
+                    continue;
+                }
+                if (interpolated && c === '}' && interpDepth > 0) {
+                    interpDepth--;
+                    i++;
+                    continue;
+                }
+                if (c === quote && interpDepth === 0) {
+                    i++;
+                    break;
+                }
+                i++;
+            }
+            continue;
+        }
+        if (ch === '{')
+            braces++;
+        else if (ch === '}')
+            braces--;
+        else if (ch === '(')
+            parens++;
+        else if (ch === ')')
+            parens--;
+        else if (ch === '[')
+            brackets++;
+        else if (ch === ']')
+            brackets--;
+        // An early negative count means a close-bracket with no matching
+        // open — definitive corruption, no need to scan the rest.
+        if (braces < 0 || parens < 0 || brackets < 0) {
+            return {
+                ok: false,
+                error: `Unbalanced ${braces < 0 ? 'curly brace' : parens < 0 ? 'parenthesis' : 'square bracket'} — a closing delimiter appears with no matching opener (position ${i}). This usually means the last apply_edit truncated or duplicated code at a boundary. Re-read the file and reapply the intended change against the current file content.`
+            };
+        }
+        i++;
+    }
+    if (braces !== 0 || parens !== 0 || brackets !== 0) {
+        const detail = [];
+        if (braces !== 0)
+            detail.push(`${braces > 0 ? braces + ' unclosed' : -braces + ' extra'} curly brace${Math.abs(braces) === 1 ? '' : 's'}`);
+        if (parens !== 0)
+            detail.push(`${parens > 0 ? parens + ' unclosed' : -parens + ' extra'} parenthes${Math.abs(parens) === 1 ? 'is' : 'es'}`);
+        if (brackets !== 0)
+            detail.push(`${brackets > 0 ? brackets + ' unclosed' : -brackets + ' extra'} square bracket${Math.abs(brackets) === 1 ? '' : 's'}`);
+        return {
+            ok: false,
+            error: `C# structure check: ${detail.join(', ')}. The file is not syntactically balanced. Re-read the file and reapply the intended change against the current content.`
+        };
+    }
+    return { ok: true };
+}
+class CSharpAdapter {
+    constructor() {
+        this.extensions = ['cs'];
+    }
+    async validate(_filePath, content, ctx) {
+        // First: cheap structural check that always runs. Catches the
+        // truncated-close-brace / duplicated-fragment corruption mode from
+        // broken apply_edit calls even when no compiler is installed.
+        const structural = cSharpStructureCheck(content);
+        if (!structural.ok)
+            return structural;
+        // Base64-encode content for safe interpolation into the node -e script.
+        const b64 = Buffer.from(content).toString('base64');
+        // The script:
+        // 1. Writes content to an OS temp file
+        // 2. Tries 'csc' (Mono C# compiler), then 'mcs' (older Mono alias)
+        // 3. Cleans up the temp file + output DLL regardless of outcome
+        // 4. If neither compiler is found (ENOENT), exits 0 → silent skip
+        const script = [
+            "const fs=require('fs'),os=require('os'),cp=require('child_process');",
+            "const tmp=os.tmpdir()+'/bandit_'+process.pid+'.cs';",
+            "const out=tmp+'.dll';",
+            'try{',
+            `  fs.writeFileSync(tmp,Buffer.from('${b64}','base64'));`,
+            "  let r=cp.spawnSync('csc',['/nologo','/t:library','/out:'+out,tmp],{encoding:'utf8'});",
+            "  if(r.error&&r.error.code==='ENOENT')",
+            "    r=cp.spawnSync('mcs',['-nologo','-t:library','-out:'+out,tmp],{encoding:'utf8'});",
+            '  try{fs.unlinkSync(tmp);fs.unlinkSync(out);}catch{}',
+            "  if(r.error&&r.error.code==='ENOENT')process.exit(0);",
+            "  if(r.status!==0){process.stdout.write((r.stdout||'')+(r.stderr||''));process.exit(1);}",
+            "}catch(e){try{fs.unlinkSync(tmp);}catch{}process.exit(0);}"
+        ].join('\n');
+        const result = await ctx.runCommand('node', ['-e', script]);
+        if (result.exitCode !== 0) {
+            const detail = (result.stdout || result.stderr).trim();
+            return { ok: false, error: `C# compilation error:\n${detail}` };
+        }
+        return { ok: true };
+    }
+}
+exports.CSharpAdapter = CSharpAdapter;
+// ── Factory ───────────────────────────────────────────────────────────────────
+/**
+ * Creates a registry pre-loaded with all built-in language adapters:
+ * JSON, Python, TypeScript/TSX, and C#.
+ *
+ * Each adapter silently passes through when its runtime/compiler is unavailable.
+ */
+function createDefaultLanguageAdapters() {
+    return new LanguageAdapterRegistry()
+        .register(new JsonAdapter())
+        .register(new PythonAdapter())
+        .register(new TypeScriptAdapter())
+        .register(new CSharpAdapter());
+}
+//# sourceMappingURL=language-adapters.js.map

package/dist/tools/language-adapters.js.map

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

package/dist/tools/loop/compactionTrigger.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Per-iteration compaction trigger for ToolUseLoop.runWithMessages.
+ *
+ * Decides whether the running message log needs compaction this
+ * iteration, runs `compactToolMessages` if so, mutates the messages
+ * array in place, emits `tool_loop:compacted`, and signals whether
+ * the compaction was *aggressive* (large enough drop to warrant a
+ * goal-anchor re-injection on the same iteration).
+ *
+ * Aggressive thresholds (preserved from the in-class implementation):
+ *
+ *   dropRatio >= 0.25  OR  dropAbsolute >= 10,000 tokens
+ *
+ * Threshold history (kept for the why-trace):
+ *   - 2026-05-06: original threshold was >50% drop or >20k absolute.
+ *     Caught the 43k→4.5k case but missed lower-percentage drops.
+ *   - 2026-05-07: lowered to >25% drop or >10k absolute after an
+ *     81k→75k compaction (only 7% drop, 6k absolute) was followed by
+ *     the model fabricating a fake user prompt out of comments it had
+ *     read in `AgentRuntime.ts`. Below-threshold compactions weren't
+ *     firing the re-anchor and the model drifted unchallenged.
+ *
+ * The in-place mutation matters — subsequent iterations need to see
+ * the compacted history so earlier tool results don't grow back every
+ * time the loop re-enters.
+ */
+import type { ToolLoopMessage } from '../tool-types';
+export type CompactionEmit = (type: string, payload?: unknown) => void;
+export interface ApplyCompactionArgs {
+    /** Mutable message log — replaced in place when compaction fires. */
+    messages: ToolLoopMessage[];
+    /** Token budget for the chat messages. `undefined`/`<=0`/non-finite
+     * disables compaction (returns aggressive=false without doing work). */
+    tokenBudget: number | undefined;
+    /** Event sink for `tool_loop:compacted`. */
+    emit: CompactionEmit;
+    /** Current iteration counter — propagated into the event payload. */
+    iteration: number;
+}
+export interface ApplyCompactionResult {
+    /** True when this iteration's compaction dropped >=25% of tokens OR
+     * >=10,000 absolute tokens. The orchestrator uses this to override
+     * the eligibility floor and refire gap on the goal-anchor injection. */
+    aggressive: boolean;
+}
+export declare function applyCompactionIfNeeded(args: ApplyCompactionArgs): ApplyCompactionResult;
+//# sourceMappingURL=compactionTrigger.d.ts.map

package/dist/tools/loop/compactionTrigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactionTrigger.d.ts","sourceRoot":"","sources":["../../../src/tools/loop/compactionTrigger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B;4EACwE;IACxE,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,4CAA4C;IAC5C,IAAI,EAAE,cAAc,CAAC;IACrB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC;;4EAEwE;IACxE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,mBAAmB,GAAG,qBAAqB,CAgCxF"}

package/dist/tools/loop/compactionTrigger.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyCompactionIfNeeded = applyCompactionIfNeeded;
+const compactMessages_1 = require("../compactMessages");
+function applyCompactionIfNeeded(args) {
+    const { messages, tokenBudget, emit, iteration } = args;
+    if (tokenBudget === undefined || tokenBudget <= 0 || !Number.isFinite(tokenBudget)) {
+        return { aggressive: false };
+    }
+    const report = (0, compactMessages_1.compactToolMessages)(messages, { tokenBudget });
+    if (report.messagesCompacted === 0) {
+        return { aggressive: false };
+    }
+    emit('tool_loop:compacted', {
+        iteration,
+        messagesCompacted: report.messagesCompacted,
+        beforeTokens: report.beforeTokens,
+        afterTokens: report.afterTokens
+    });
+    const dropRatio = report.beforeTokens > 0
+        ? (report.beforeTokens - report.afterTokens) / report.beforeTokens
+        : 0;
+    const dropAbsolute = report.beforeTokens - report.afterTokens;
+    const aggressive = dropRatio >= 0.25 || dropAbsolute >= 10000;
+    // Replace messages in place so subsequent iterations keep the
+    // compacted history — if we didn't, earlier tool results would
+    // grow back every time the loop re-entered.
+    messages.length = 0;
+    messages.push(...report.compacted);
+    return { aggressive };
+}
+//# sourceMappingURL=compactionTrigger.js.map

package/dist/tools/loop/compactionTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactionTrigger.js","sourceRoot":"","sources":["../../../src/tools/loop/compactionTrigger.ts"],"names":[],"mappings":";;AAkDA,0DAgCC;AAvDD,wDAAyD;AAuBzD,SAAgB,uBAAuB,CAAC,IAAyB;IAC/D,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAExD,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACnF,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,qCAAmB,EAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IAC9D,IAAI,MAAM,CAAC,iBAAiB,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,qBAAqB,EAAE;QAC1B,SAAS;QACT,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,GAAG,CAAC;QACvC,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,YAAY;QAClE,CAAC,CAAC,CAAC,CAAC;IACN,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC;IAC9D,MAAM,UAAU,GAAG,SAAS,IAAI,IAAI,IAAI,YAAY,IAAI,KAAM,CAAC;IAE/D,8DAA8D;IAC9D,+DAA+D;IAC/D,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAEnC,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC"}

package/dist/tools/loop/finalAnswerNudges.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Announce-intent + ask-user nudge detectors for the final-response
+ * branch of ToolUseLoop.runWithMessages.
+ *
+ * Both run AFTER the loop has decided the model's response has no tool
+ * calls (i.e. the response is on track to become the final answer) but
+ * BEFORE we commit to that as the turn's exit. They catch two failure
+ * modes where the model has effectively stalled but the surrounding
+ * detectors don't catch it:
+ *
+ * 1. announce-intent — model said "Let me X" / "I'll Y" / "I'm currently
+ *    porting Z" but emitted no tool call. The user sees an
+ *    announcement, never the work. One nudge per turn; if the model
+ *    ignores, the loop terminates and the user sees the announcement
+ *    as the final answer.
+ *
+ *    The NARRATE_PROGRESS_RE gerund branch requires a syntactic
+ *    complement (preposition / article / object pronoun) after the
+ *    -ing verb so casual greeting prose ("I'm doing well", "I'm feeling
+ *    fine", "I'm going home") doesn't false-positive. The pre-2026-06-02
+ *    version of that branch was `i(?:'m| am)\s+\w+ing` alone, which
+ *    matched "I'm doing" on every casual conversational reply and
+ *    chewed through the no-tool-call hard cap. Regression captured in
+ *    `intentNudgeDetectors.test.ts`.
+ *
+ * 2. ask-user — model asked the user a decision question ("Shall I
+ *    proceed?", "Do you want me to continue?") in plain prose while
+ *    the `ask_user` tool is registered. The interactive prompt is the
+ *    surface the user expects; passive prose loses the round-trip.
+ *    One nudge per turn.
+ *
+ * Both detectors:
+ * - read from `finalResponse` (the response after tool_call markup
+ *   has been stripped)
+ * - strip reasoning fences before inspecting the visible prose
+ * - return `{ fired }` so the orchestrator can update its mutable
+ *   `*Nudged` flag, push the returned message, and `continue` the loop
+ *
+ * The orchestrator is responsible for the once-per-turn guard
+ * (`!announceIntentNudged` / `!askUserNudged` predicates in the gate
+ * args) — the detectors only check the SHAPE of the response.
+ */
+import type { ToolLoopMessage } from '../tool-types';
+export type NudgeEmit = (type: string, payload?: unknown) => void;
+export interface AnnounceIntentNudgeArgs {
+    /** The response after tool_call markup has been stripped. The visible
+     * prose stripped of reasoning fences is computed internally. */
+    finalResponse: string;
+    /** Current iteration counter (propagated into the emit payload). */
+    iteration: number;
+    /** Event sink for `tool_loop:announce_intent_nudge`. */
+    emit: NudgeEmit;
+}
+export interface NudgeResult {
+    /** True when the detector matched. Caller pushes `message` and continues. */
+    fired: boolean;
+    /** The user message to append when fired. Undefined when not fired. */
+    message?: ToolLoopMessage;
+}
+export declare function tryAnnounceIntentNudge(args: AnnounceIntentNudgeArgs): NudgeResult;
+export interface AskUserNudgeArgs extends AnnounceIntentNudgeArgs {
+    /** When false, ask-user tool isn't registered — the nudge is meaningless
+     * and never fires. The orchestrator can pre-gate, but the detector
+     * accepts the flag so the boundary stays narrow. */
+    askUserAvailable: boolean;
+}
+export declare function tryAskUserNudge(args: AskUserNudgeArgs): NudgeResult;
+//# sourceMappingURL=finalAnswerNudges.d.ts.map

package/dist/tools/loop/finalAnswerNudges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalAnswerNudges.d.ts","sourceRoot":"","sources":["../../../src/tools/loop/finalAnswerNudges.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAElE,MAAM,WAAW,uBAAuB;IACtC;oEACgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,KAAK,EAAE,OAAO,CAAC;IACf,uEAAuE;IACvE,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AA2CD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,uBAAuB,GAAG,WAAW,CAwBjF;AAED,MAAM,WAAW,gBAAiB,SAAQ,uBAAuB;IAC/D;;wDAEoD;IACpD,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAUD,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAmBnE"}

package/dist/tools/loop/finalAnswerNudges.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tryAnnounceIntentNudge = tryAnnounceIntentNudge;
+exports.tryAskUserNudge = tryAskUserNudge;
+const ANNOUNCE_RE = /^(?:next,?\s+|now,?\s+|then,?\s+)?(?:let me|let us|let'?s|i(?:'ll| will| am going to| 'm going to| 'm about to| should))\s+(?:dig|continue|explore|investigate|check|look|read|inspect|analyze|examine|review|verify|find|search|trace|walk|drill|keep|move on)/;
+// gemma-family progress narration that ALSO exits without acting:
+// "I am on it", "I'm currently porting…", "I've already started…",
+// "I'll keep pushing…". The ^-anchored ANNOUNCE_RE above only catches
+// "let me/I'll + investigation verb" and misses these present-
+// progressive / on-it / start-claim openers.
+//
+// The gerund branch requires a complement (preposition/article/object
+// pronoun) after the -ing verb so casual greeting prose doesn't
+// false-positive. Pre-2026-06-02 the gerund branch was
+// `i(?:'m| am)\s+\w+ing` alone, which matched "I'm doing well" (a
+// perfectly fine reply to "how are you?") and chewed through the
+// no-tool-call hard cap on every casual conversational turn. Real
+// progress narration ("I'm porting the runtime", "I'm working on it",
+// "I'm thinking through the problem") has a syntactic complement;
+// "I'm doing well" / "I'm feeling fine" / "I'm going home" does not.
+const NARRATE_PROGRESS_RE = new RegExp("^(?:next,?\\s+|now,?\\s+|then,?\\s+)?(?:" +
+    "i(?:'m| am)\\s+on it|" +
+    "i(?:'m| am)\\s+(?:currently\\s+|now\\s+)?\\w+ing\\s+(?:on|with|to|in|the|a|an|that|this|it|my|our|your|some|all|more|through|over|out)\\b|" +
+    "i(?:'ve| have)\\s+(?:already\\s+)?(?:started|begun|kicked off)|" +
+    "i(?:'ll| will)\\s+(?:keep|continue)\\b" +
+    ")");
+function stripReasoningFences(text) {
+    return text
+        .replace(/```bandit-reasoning\b[\s\S]*?```/gi, '')
+        .replace(/```bandit-reasoning\b[\s\S]*$/i, '')
+        .replace(/<think\b[\s\S]*?<\/think\s*>/gi, '')
+        .replace(/<think\b[\s\S]*$/i, '')
+        .trim();
+}
+const ANNOUNCE_INTENT_NUDGE_BODY = 'Your response announces an action ("Let me X", "I\'ll Y next") but emits NO tool call — so the loop will exit and the user only sees your announcement, not the result. ' +
+    'Take the action now: emit the `read_file`, `search_code`, `list_files`, `run_command`, or other tool call you just described. ' +
+    'If you have nothing more to investigate, write a complete final answer instead — do not announce future work without doing it.';
+function tryAnnounceIntentNudge(args) {
+    const { finalResponse, iteration, emit } = args;
+    if (!finalResponse)
+        return { fired: false };
+    const visible = stripReasoningFences(finalResponse);
+    // Cap visible length so legitimate wrap-ups (a model writing a
+    // multi-paragraph summary that happens to start with "Let me
+    // explain …") aren't caught. The failure mode is a SHORT
+    // announcement followed by silence, not a long answer.
+    if (!visible || visible.length > 600)
+        return { fired: false };
+    const opener = visible.slice(0, 240).toLowerCase();
+    if (!ANNOUNCE_RE.test(opener) && !NARRATE_PROGRESS_RE.test(opener)) {
+        return { fired: false };
+    }
+    emit('tool_loop:announce_intent_nudge', {
+        iteration,
+        responsePreview: visible.slice(0, 240)
+    });
+    return {
+        fired: true,
+        message: { role: 'user', content: ANNOUNCE_INTENT_NUDGE_BODY }
+    };
+}
+const DECISION_RE = /(shall i|should i|do you want me to|would you like me to|want me to (?:proceed|continue|go ahead)|which (?:option|approach|one)|proceed with the|go ahead with|or were you looking|or do you want|let me know (?:if|which|whether))/;
+const ASK_USER_NUDGE_BODY = 'You asked the user to choose or approve, but you did it in prose and the loop is exiting — they get a passive question, not an interactive prompt. ' +
+    'Call the `ask_user` tool now: pose the question with 2–4 concrete options (put the recommended one first and append " (Recommended)"). ' +
+    'Do not ask for a decision in plain prose when ask_user is available.';
+function tryAskUserNudge(args) {
+    const { finalResponse, iteration, emit, askUserAvailable } = args;
+    if (!askUserAvailable || !finalResponse)
+        return { fired: false };
+    const visibleQ = stripReasoningFences(finalResponse);
+    if (!visibleQ)
+        return { fired: false };
+    if (!/\?\s*$/.test(visibleQ))
+        return { fired: false };
+    const tail = visibleQ.slice(-320).toLowerCase();
+    if (!DECISION_RE.test(tail))
+        return { fired: false };
+    emit('tool_loop:ask_user_nudge', {
+        iteration,
+        responsePreview: visibleQ.slice(-240)
+    });
+    return {
+        fired: true,
+        message: { role: 'user', content: ASK_USER_NUDGE_BODY }
+    };
+}
+//# sourceMappingURL=finalAnswerNudges.js.map

package/dist/tools/loop/finalAnswerNudges.js.map

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