@burtson-labs/agent-core 1.6.13

package/dist/tools/toolAvailabilityDetector.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Tool-availability self-correction detector.
+ *
+ * Failure mode: after a compaction-heavy turn, OR when an earlier tool
+ * call errored, the model sometimes claims a tool "isn't available" /
+ * "I don't have access to X" / "no X tool exists" — even though the
+ * tool IS registered and would have shown up in the native-tools
+ * schema sent on this very turn. The model is hallucinating absence,
+ * usually because a prior error message ("Error: tool 'X' not
+ * registered" from a typo, or "Expected object, received string"
+ * from a schema rejection) survived into the compacted history while
+ * the actual success path didn't.
+ *
+ * Captured 2026-05-25 (Mark, live CLI session): model said it couldn't
+ * trash messages even though `burtson-labs.trashMessage` was registered
+ * in the MCP pool with 119 other tools. Restarting Bandit "fixed" it.
+ * That's a band-aid; the framework should detect the false claim and
+ * correct the model inline.
+ *
+ * Strategy: if the model's response (with no tool_call) contains a
+ * negation phrase paired with a tool-name-shaped token that matches
+ * a registered tool, push a corrective user message that lists the
+ * actually-available tools by name. Capped per-turn to avoid loops.
+ */
+export interface ToolAvailabilityCheckResult {
+    /** True iff the response claims a tool is missing AND that tool IS registered. */
+    detected: boolean;
+    /** Names of registered tools that the model appears to be denying access to. */
+    matchedToolNames: string[];
+    /** Subset of registered tool names relevant to the model's claim, for the nudge body. */
+    suggestedTools: string[];
+}
+/**
+ * Pure check — does the response text appear to deny access to a
+ * tool that's actually registered?
+ *
+ * @param response          Model's most recent assistant message (post-strip).
+ * @param registeredTools   Names of every tool currently in the registry.
+ *                          MCP namespacing preserved ("burtson-labs.trashMessage").
+ * @returns ToolAvailabilityCheckResult — see field docs.
+ */
+export declare function detectFalseToolAbsence(response: string, registeredTools: string[]): ToolAvailabilityCheckResult;
+/**
+ * Build the corrective user message body. Lists the actually-registered
+ * tool names so the model sees concrete evidence its claim was wrong.
+ */
+export declare function buildToolAvailabilityNudge(result: ToolAvailabilityCheckResult): string;
+//# sourceMappingURL=toolAvailabilityDetector.d.ts.map

package/dist/tools/toolAvailabilityDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolAvailabilityDetector.d.ts","sourceRoot":"","sources":["../../src/tools/toolAvailabilityDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA+BH,MAAM,WAAW,2BAA2B;IAC1C,kFAAkF;IAClF,QAAQ,EAAE,OAAO,CAAC;IAClB,gFAAgF;IAChF,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,yFAAyF;IACzF,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EAAE,GACxB,2BAA2B,CA6D7B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,2BAA2B,GAAG,MAAM,CAWtF"}

package/dist/tools/toolAvailabilityDetector.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * Tool-availability self-correction detector.
+ *
+ * Failure mode: after a compaction-heavy turn, OR when an earlier tool
+ * call errored, the model sometimes claims a tool "isn't available" /
+ * "I don't have access to X" / "no X tool exists" — even though the
+ * tool IS registered and would have shown up in the native-tools
+ * schema sent on this very turn. The model is hallucinating absence,
+ * usually because a prior error message ("Error: tool 'X' not
+ * registered" from a typo, or "Expected object, received string"
+ * from a schema rejection) survived into the compacted history while
+ * the actual success path didn't.
+ *
+ * Captured 2026-05-25 (Mark, live CLI session): model said it couldn't
+ * trash messages even though `burtson-labs.trashMessage` was registered
+ * in the MCP pool with 119 other tools. Restarting Bandit "fixed" it.
+ * That's a band-aid; the framework should detect the false claim and
+ * correct the model inline.
+ *
+ * Strategy: if the model's response (with no tool_call) contains a
+ * negation phrase paired with a tool-name-shaped token that matches
+ * a registered tool, push a corrective user message that lists the
+ * actually-available tools by name. Capped per-turn to avoid loops.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectFalseToolAbsence = detectFalseToolAbsence;
+exports.buildToolAvailabilityNudge = buildToolAvailabilityNudge;
+/**
+ * Phrases that signal the model is asserting tool unavailability.
+ * Tuned for sensitivity — we'd rather false-positive once than miss
+ * the failure mode. The verification step (does the named tool ACTUALLY
+ * exist in the registry?) is what gates the corrective nudge, so a
+ * false positive here is harmless.
+ */
+const ABSENCE_PHRASES = [
+    // "I don't have access to" / "I do not have a … tool"
+    /\b(?:I|we)\s+(?:do\s+not|don'?t|does\s+not|doesn'?t)\s+have\s+(?:access\s+to\s+)?/i,
+    // "I am unable to find/locate/access"
+    /\b(?:I'?m|I am)\s+unable\s+to\s+(?:find|locate|access|use)/i,
+    // "cannot find / locate / access X tool"
+    /\b(?:cannot|can'?t)\s+(?:find|locate|access|use|call|invoke)\s+/i,
+    // "no such tool" / "no … tool is available"
+    /\bno\s+(?:such\s+)?\S+(?:\s+\S+){0,3}\s+tool\b/i,
+    /\bthere\s+is\s+no\s+\S+(?:\s+\S+){0,3}\s+tool\b/i,
+    // "X is not available / unavailable"
+    /\b(?:is\s+not\s+available|isn'?t\s+available|are\s+not\s+available|aren'?t\s+available|is\s+unavailable|are\s+unavailable)\b/i,
+    /\b(?:not\s+available|unavailable)\s+(?:in|for|to|here|right\s+now|at\s+the\s+moment)/i,
+    // "I don't see / can't see X tool in"
+    /\b(?:do\s+not|don'?t|cannot|can'?t)\s+see\s+(?:a\s+|an\s+|the\s+)?/i,
+];
+/** Verb keywords that hint the model is talking about an actionable tool. */
+const ACTION_HINTS = [
+    /\b(?:trash|archive|delete|remove|send|create|update|modify|read|list|search|fetch|get|post|move|reply)\b/i,
+];
+/**
+ * Pure check — does the response text appear to deny access to a
+ * tool that's actually registered?
+ *
+ * @param response          Model's most recent assistant message (post-strip).
+ * @param registeredTools   Names of every tool currently in the registry.
+ *                          MCP namespacing preserved ("burtson-labs.trashMessage").
+ * @returns ToolAvailabilityCheckResult — see field docs.
+ */
+function detectFalseToolAbsence(response, registeredTools) {
+    if (!response || registeredTools.length === 0) {
+        return { detected: false, matchedToolNames: [], suggestedTools: [] };
+    }
+    const hasAbsencePhrase = ABSENCE_PHRASES.some((re) => re.test(response));
+    if (!hasAbsencePhrase) {
+        return { detected: false, matchedToolNames: [], suggestedTools: [] };
+    }
+    // Find any registered tool whose bare name (post-MCP-namespace strip)
+    // appears in the response. We test the bare name first because the
+    // model rarely uses the full "burtson-labs." prefix when complaining
+    // — it'll say "trashMessage" or "trash message" or "delete email".
+    const matched = [];
+    for (const full of registeredTools) {
+        const bare = stripNamespace(full);
+        // Exact bare-name substring (case-insensitive). Use word boundaries
+        // when feasible — guards against "createFilter" matching mid-word.
+        const bareRe = new RegExp(`\\b${escapeRegex(bare)}\\b`, 'i');
+        if (bareRe.test(response)) {
+            matched.push(full);
+            continue;
+        }
+        // snake_case → space match: trashMessage → "trash message"
+        const spaced = bare.replace(/([a-z])([A-Z])/g, '$1 $2').replace(/_/g, ' ').toLowerCase();
+        if (spaced !== bare.toLowerCase()) {
+            const spacedRe = new RegExp(`\\b${escapeRegex(spaced)}\\b`, 'i');
+            if (spacedRe.test(response)) {
+                matched.push(full);
+            }
+        }
+    }
+    if (matched.length === 0) {
+        // Fallback: model said "I don't have access to a Gmail tool" without
+        // naming the exact registered name. If the response contains an
+        // action verb AND any MCP tool exists that starts with a matching
+        // verb stem, suggest those. Conservative — only kicks in when an
+        // action hint is present so we don't false-positive on general
+        // chitchat.
+        const hasAction = ACTION_HINTS.some((re) => re.test(response));
+        if (!hasAction) {
+            return { detected: false, matchedToolNames: [], suggestedTools: [] };
+        }
+        // Heuristic: pick the first 6 registered tools whose bare name starts
+        // with one of the action verbs the model mentioned. Caps the prompt
+        // budget on the corrective message.
+        const verbMatches = ACTION_HINTS
+            .map((re) => response.match(re)?.[0]?.toLowerCase() ?? '')
+            .filter(Boolean);
+        if (verbMatches.length === 0) {
+            return { detected: false, matchedToolNames: [], suggestedTools: [] };
+        }
+        const fallback = registeredTools.filter((full) => {
+            const bare = stripNamespace(full).toLowerCase();
+            return verbMatches.some((v) => bare.startsWith(v));
+        });
+        if (fallback.length === 0) {
+            return { detected: false, matchedToolNames: [], suggestedTools: [] };
+        }
+        return { detected: true, matchedToolNames: [], suggestedTools: fallback.slice(0, 6) };
+    }
+    return { detected: true, matchedToolNames: matched, suggestedTools: matched.slice(0, 6) };
+}
+/**
+ * Build the corrective user message body. Lists the actually-registered
+ * tool names so the model sees concrete evidence its claim was wrong.
+ */
+function buildToolAvailabilityNudge(result) {
+    const names = result.suggestedTools.length > 0 ? result.suggestedTools : result.matchedToolNames;
+    const list = names.map((n) => `  - ${n}`).join('\n');
+    return ('You claimed a tool is unavailable, but the following tool(s) ARE registered for this turn ' +
+        '(check the system tool list — they were sent in the native-tools schema, even if a prior compaction collapsed earlier results):\n' +
+        `${list}\n\n` +
+        'Re-attempt the action with the correct tool name from the list above. If you have already tried these and they errored, ' +
+        'explain WHICH parameter or precondition failed — do not claim absence. If none of these match the user\'s ask, ' +
+        'state honestly which capability you lack rather than guessing.');
+}
+function stripNamespace(toolName) {
+    const dotIdx = toolName.indexOf('.');
+    if (dotIdx > 0)
+        return toolName.slice(dotIdx + 1);
+    const underIdx = toolName.indexOf('__');
+    if (underIdx > 0 && toolName.startsWith('mcp__')) {
+        const after = toolName.slice(underIdx + 2);
+        const next = after.indexOf('__');
+        return next > 0 ? after.slice(next + 2) : after;
+    }
+    return toolName;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=toolAvailabilityDetector.js.map

package/dist/tools/toolAvailabilityDetector.js.map

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

package/dist/tools/unified-patch.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Minimal unified-diff parser + applier.
+ *
+ * Models trained on github code have seen far more unified-diff format
+ * than they have seen our `apply_edit` find/replace shape, and patches
+ * carry built-in context lines that double as preview-friendly diffs
+ * for approval UIs. This module powers the `apply_patch` tool —
+ * deliberately small, no external deps, just enough to handle the
+ * common cases (one or more hunks per file, ~3 lines of context, no
+ * binary patches, no rename headers).
+ *
+ * Format reminder:
+ *
+ *   @@ -10,5 +10,7 @@
+ *    unchanged line
+ *    another unchanged
+ *   -removed line
+ *   +added line
+ *   +another added
+ *    unchanged line
+ *
+ * What we DO support:
+ *   - Multiple hunks per patch
+ *   - File header lines (`--- a/…` / `+++ b/…`) — parsed and ignored;
+ *     the caller owns the path
+ *   - Trailing-newline absence on the final hunk
+ *   - Small context drift (find the hunk by content even if the
+ *     line numbers are off by a few)
+ *
+ * What we DON'T support (yet):
+ *   - Binary patches
+ *   - Rename / mode-change headers
+ *   - `git diff --no-index` style headers
+ *   - Whitespace-only matches across mixed-indent context
+ */
+export interface PatchHunk {
+    /** 1-based starting line in the original file (per @@ header). */
+    oldStart: number;
+    /** Lines of the original this hunk modifies (per @@ header). */
+    oldCount: number;
+    /** 1-based starting line in the new file. */
+    newStart: number;
+    /** Lines of the new file produced by this hunk. */
+    newCount: number;
+    /** Raw body lines including the leading marker (` ` / `-` / `+`). */
+    bodyLines: string[];
+}
+export interface ParsedPatch {
+    /** Whatever path appeared on the `--- a/…` line, if present. The
+     *  caller should still pass an explicit `path` argument to the tool;
+     *  this is informational only. */
+    oldPath?: string;
+    /** Whatever path appeared on the `+++ b/…` line, if present. */
+    newPath?: string;
+    hunks: PatchHunk[];
+}
+/**
+ * Parse a unified-diff string into hunks. Returns null when the input
+ * doesn't look like a unified diff (no `@@` header found).
+ */
+export declare function parseUnifiedPatch(patch: string): ParsedPatch | null;
+export interface ApplyResult {
+    ok: true;
+    next: string;
+}
+export interface ApplyError {
+    ok: false;
+    hunkIndex: number;
+    reason: string;
+    /** Lines of the file near where the hunk was expected — included in
+     *  the error so the model can see what's actually there and adjust
+     *  the patch on retry. */
+    contextSnippet?: string;
+}
+/**
+ * Apply a parsed patch to a string. Tolerates small line-number drift
+ * (the @@ header says "line 42" but the actual matching context is at
+ * line 39) by searching forward + backward up to FUZZ lines.
+ *
+ * Lines in the source preserve their original line endings via the
+ * caller (we operate on `\n`-split arrays and re-join at the end).
+ * Files with `\r\n` should be normalised by the caller before parsing
+ * the patch — keeping that detail outside this module avoids having
+ * to thread a "preserve CRLF" flag through every code path.
+ */
+export declare function applyParsedPatch(source: string, patch: ParsedPatch): ApplyResult | ApplyError;
+//# sourceMappingURL=unified-patch.d.ts.map

package/dist/tools/unified-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-patch.d.ts","sourceRoot":"","sources":["../../src/tools/unified-patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,MAAM,WAAW,SAAS;IACxB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B;;sCAEkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAsEnE;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,KAAK,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf;;8BAE0B;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,WAAW,GAAG,UAAU,CAuC7F"}

package/dist/tools/unified-patch.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Minimal unified-diff parser + applier.
+ *
+ * Models trained on github code have seen far more unified-diff format
+ * than they have seen our `apply_edit` find/replace shape, and patches
+ * carry built-in context lines that double as preview-friendly diffs
+ * for approval UIs. This module powers the `apply_patch` tool —
+ * deliberately small, no external deps, just enough to handle the
+ * common cases (one or more hunks per file, ~3 lines of context, no
+ * binary patches, no rename headers).
+ *
+ * Format reminder:
+ *
+ *   @@ -10,5 +10,7 @@
+ *    unchanged line
+ *    another unchanged
+ *   -removed line
+ *   +added line
+ *   +another added
+ *    unchanged line
+ *
+ * What we DO support:
+ *   - Multiple hunks per patch
+ *   - File header lines (`--- a/…` / `+++ b/…`) — parsed and ignored;
+ *     the caller owns the path
+ *   - Trailing-newline absence on the final hunk
+ *   - Small context drift (find the hunk by content even if the
+ *     line numbers are off by a few)
+ *
+ * What we DON'T support (yet):
+ *   - Binary patches
+ *   - Rename / mode-change headers
+ *   - `git diff --no-index` style headers
+ *   - Whitespace-only matches across mixed-indent context
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseUnifiedPatch = parseUnifiedPatch;
+exports.applyParsedPatch = applyParsedPatch;
+/**
+ * Parse a unified-diff string into hunks. Returns null when the input
+ * doesn't look like a unified diff (no `@@` header found).
+ */
+function parseUnifiedPatch(patch) {
+    const lines = patch.split('\n');
+    let i = 0;
+    let oldPath;
+    let newPath;
+    // Optional file headers — strip them off if present so we land on
+    // the first @@ hunk header.
+    while (i < lines.length) {
+        const line = lines[i];
+        if (line.startsWith('--- ')) {
+            oldPath = line.slice(4).trim();
+            i++;
+            continue;
+        }
+        if (line.startsWith('+++ ')) {
+            newPath = line.slice(4).trim();
+            i++;
+            continue;
+        }
+        if (line.startsWith('diff ') || line.startsWith('index ')) {
+            i++;
+            continue;
+        }
+        break;
+    }
+    const hunks = [];
+    while (i < lines.length) {
+        const header = lines[i];
+        const headerMatch = /^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/.exec(header);
+        if (!headerMatch) {
+            // Skip blank lines or trailing junk between hunks; bail if we
+            // hit something that isn't a header AND isn't whitespace.
+            if (header.trim() === '') {
+                i++;
+                continue;
+            }
+            if (hunks.length === 0)
+                return null;
+            break;
+        }
+        const oldStart = parseInt(headerMatch[1], 10);
+        const oldCount = headerMatch[2] !== undefined ? parseInt(headerMatch[2], 10) : 1;
+        const newStart = parseInt(headerMatch[3], 10);
+        const newCount = headerMatch[4] !== undefined ? parseInt(headerMatch[4], 10) : 1;
+        i++;
+        const bodyLines = [];
+        let oldSeen = 0;
+        let newSeen = 0;
+        while (i < lines.length && (oldSeen < oldCount || newSeen < newCount)) {
+            const line = lines[i];
+            if (line.startsWith('@@'))
+                break;
+            if (line.startsWith(' ')) {
+                oldSeen++;
+                newSeen++;
+            }
+            else if (line.startsWith('-')) {
+                oldSeen++;
+            }
+            else if (line.startsWith('+')) {
+                newSeen++;
+            }
+            else if (line.startsWith('\\')) { /* "" — ignore */ }
+            else if (line === '') {
+                // Empty line in the body — treat as a blank context line.
+                // Some diff tools omit the leading space on empty context.
+                oldSeen++;
+                newSeen++;
+                bodyLines.push(' ');
+                i++;
+                continue;
+            }
+            else {
+                // Anything else is junk; bail on this hunk.
+                break;
+            }
+            bodyLines.push(line);
+            i++;
+        }
+        hunks.push({ oldStart, oldCount, newStart, newCount, bodyLines });
+    }
+    if (hunks.length === 0)
+        return null;
+    return { oldPath, newPath, hunks };
+}
+/**
+ * Apply a parsed patch to a string. Tolerates small line-number drift
+ * (the @@ header says "line 42" but the actual matching context is at
+ * line 39) by searching forward + backward up to FUZZ lines.
+ *
+ * Lines in the source preserve their original line endings via the
+ * caller (we operate on `\n`-split arrays and re-join at the end).
+ * Files with `\r\n` should be normalised by the caller before parsing
+ * the patch — keeping that detail outside this module avoids having
+ * to thread a "preserve CRLF" flag through every code path.
+ */
+function applyParsedPatch(source, patch) {
+    const FUZZ = 5;
+    const lines = source.split('\n');
+    // Track the running line offset induced by prior hunks so the next
+    // hunk can search relative to its position in the modified file.
+    let runningDelta = 0;
+    for (let h = 0; h < patch.hunks.length; h++) {
+        const hunk = patch.hunks[h];
+        // Build the "original" context (every body line that's a delete
+        // or context, in order) so we can find the actual position of the
+        // hunk in `lines` even when line numbers have drifted.
+        const originalContext = [];
+        const newBody = [];
+        for (const raw of hunk.bodyLines) {
+            const marker = raw[0] ?? ' ';
+            const body = raw.slice(1);
+            if (marker === ' ') {
+                originalContext.push(body);
+                newBody.push(body);
+            }
+            else if (marker === '-') {
+                originalContext.push(body);
+            }
+            else if (marker === '+') {
+                newBody.push(body);
+            }
+        }
+        // Find the original-context block in `lines`. Start by checking
+        // the header-claimed position (adjusted for prior hunk deltas);
+        // if that doesn't match, scan a small window forward and back.
+        const expected = (hunk.oldStart - 1) + runningDelta;
+        const matchIndex = findContextIndex(lines, originalContext, expected, FUZZ);
+        if (matchIndex < 0) {
+            const sample = lines.slice(Math.max(0, expected - 2), expected + 5).join('\n');
+            return {
+                ok: false,
+                hunkIndex: h,
+                reason: `hunk ${h + 1} did not apply at or near line ${hunk.oldStart}: the - / context lines don't match the file. Re-read the file with read_file and regenerate the patch with current line content.`,
+                contextSnippet: sample
+            };
+        }
+        // Splice in the new body in place of the original-context block.
+        lines.splice(matchIndex, originalContext.length, ...newBody);
+        runningDelta += newBody.length - originalContext.length;
+    }
+    return { ok: true, next: lines.join('\n') };
+}
+/**
+ * Locate the run of `context` inside `lines`, preferring a position
+ * close to `expected`. Returns -1 when no match within `fuzz` lines on
+ * either side.
+ */
+function findContextIndex(lines, context, expected, fuzz) {
+    if (context.length === 0) {
+        // Pure-insert hunk (no - or context lines) — use the expected
+        // position directly. Clamp to bounds.
+        return Math.max(0, Math.min(expected, lines.length));
+    }
+    const matches = (start) => {
+        if (start < 0 || start + context.length > lines.length)
+            return false;
+        for (let i = 0; i < context.length; i++) {
+            if (lines[start + i] !== context[i])
+                return false;
+        }
+        return true;
+    };
+    if (matches(expected))
+        return expected;
+    for (let d = 1; d <= fuzz; d++) {
+        if (matches(expected - d))
+            return expected - d;
+        if (matches(expected + d))
+            return expected + d;
+    }
+    return -1;
+}
+//# sourceMappingURL=unified-patch.js.map

package/dist/tools/unified-patch.js.map

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

package/dist/types/agent.d.ts

@@ -0,0 +1,69 @@
+export type AgentStepStatus = "pending" | "in_progress" | "completed" | "failed";
+export interface AgentStep {
+    id: string;
+    title: string;
+    description?: string;
+    status?: AgentStepStatus;
+    command?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentPlan {
+    id: string;
+    goal: string;
+    summary: string;
+    steps: AgentStep[];
+    createdAt: number;
+    version: string;
+}
+export interface AgentContext {
+    files: string[];
+    goals: string[];
+    repository?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentEvent<TPayload = unknown> {
+    type: string;
+    payload?: TPayload;
+    timestamp: number;
+}
+export interface AgentDiff {
+    path: string;
+    type: "create" | "update" | "delete";
+    preview?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentExecutionResult {
+    stepId: string;
+    status: AgentStepStatus;
+    diff?: AgentDiff[];
+    logs?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface AgentReport {
+    goal: string;
+    summary: string;
+    steps: AgentExecutionResult[];
+    startedAt: number;
+    completedAt: number;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentAskResult {
+    prompt: string;
+    response: string;
+    durationMs: number;
+    metadata?: Record<string, unknown>;
+}
+export type PlanValidationResult = {
+    ok: true;
+    plan: AgentPlan;
+} | {
+    ok: false;
+    errors: string[];
+};
+/**
+ * Structural validator for AgentPlan objects returned by the planner.
+ * Used to catch malformed or incomplete plans before they reach the executor.
+ * Emits a PLAN_PARSE_FAILED event so the runtime can surface the error cleanly.
+ */
+export declare function validateAgentPlan(raw: unknown): PlanValidationResult;
+//# sourceMappingURL=agent.d.ts.map

package/dist/types/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEjF,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,UAAU,CAAC,QAAQ,GAAG,OAAO;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAID,MAAM,MAAM,oBAAoB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpC;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,CAgDpE"}