cmdr-agent 2.4.0 → 2.5.1

package/dist/src/llm/repair/tool-repair.js

@@ -0,0 +1,313 @@
+/**
+ * Tool repair module — attempts to fix malformed tool calls before giving up.
+ *
+ * Strategies (applied in order):
+ * A. Strip surrounding text, re-extract JSON
+ * B. Fix common JSON issues (trailing commas, unquoted keys, partial brackets)
+ * C. Fuzzy-match partial tool names to closest registered tool
+ * D. Coerce argument types ("true" → true, "42" → 42) per Zod schema
+ *
+ * If any strategy produces a valid tool call, it's returned immediately.
+ * If none succeed, null is returned → caller should retry or give up.
+ */
+import { validateToolCallShape } from '../validation/tool-call-schema.js';
+/**
+ * Attempt to repair a set of rejected tool calls.
+ *
+ * @param rawText    The full LLM output text that contained the failed tool calls.
+ * @param rejected   The tool calls that failed validation, with error details.
+ * @param context    Available tool names and schemas for fuzzy matching + type coercion.
+ * @returns          Repaired tool calls, or null if repair failed entirely.
+ */
+export function attemptRepair(rawText, rejected, context) {
+    const repaired = [];
+    const fixes = [];
+    for (const call of rejected) {
+        // Strategy C: Fuzzy-match tool name
+        let toolName = call.name;
+        const nameFixed = fuzzyMatchToolName(toolName, context.availableTools);
+        if (nameFixed && nameFixed !== toolName) {
+            fixes.push(`Fixed tool name: "${toolName}" → "${nameFixed}"`);
+            toolName = nameFixed;
+        }
+        // Strategy D: Type coercion per Zod schema
+        let args = { ...call.arguments };
+        const schema = context.toolSchemas.get(toolName);
+        if (schema) {
+            const coerced = coerceArgumentTypes(args, schema);
+            if (coerced.fixed) {
+                args = coerced.args;
+                fixes.push(...coerced.fixes);
+            }
+        }
+        // Validate after fixes
+        const validation = validateToolCallShape({ name: toolName, arguments: args });
+        if (validation.ok) {
+            // Double-check input schema if available
+            if (schema) {
+                const result = schema.safeParse(args);
+                if (result.success) {
+                    repaired.push({ name: toolName, arguments: result.data });
+                    continue;
+                }
+            }
+            else {
+                repaired.push(validation.toolCall);
+                continue;
+            }
+        }
+    }
+    // Strategy A+B: Re-extract from raw text if per-call repair failed
+    if (repaired.length < rejected.length && rawText) {
+        const extracted = extractFromRawText(rawText, context);
+        if (extracted.length > 0) {
+            fixes.push(`Re-extracted ${extracted.length} tool call(s) from raw output`);
+            for (const tc of extracted) {
+                if (!repaired.some(r => r.name === tc.name)) {
+                    repaired.push(tc);
+                }
+            }
+        }
+    }
+    return repaired.length > 0 ? { repaired, fixes } : null;
+}
+// ---------------------------------------------------------------------------
+// Strategy A: Re-extract JSON from raw text
+// ---------------------------------------------------------------------------
+function extractFromRawText(text, context) {
+    const results = [];
+    // Strip markdown code fences and try to find JSON objects
+    const stripped = text
+        .replace(/```(?:json|tool_call)?\s*\n?/g, '')
+        .replace(/```/g, '');
+    // Find all JSON-like objects in the text
+    const jsonRegex = /\{[^{}]*(?:\{[^{}]*\}[^{}]*)*\}/g;
+    let match;
+    while ((match = jsonRegex.exec(stripped)) !== null) {
+        const candidate = match[0];
+        const parsed = tryParseAndRepairJson(candidate);
+        if (parsed && parsed.name && typeof parsed.name === 'string') {
+            const args = (parsed.arguments ?? parsed.args ?? parsed.params ?? parsed.input ?? {});
+            const toolName = fuzzyMatchToolName(parsed.name, context.availableTools) ?? parsed.name;
+            const validation = validateToolCallShape({ name: toolName, arguments: args });
+            if (validation.ok) {
+                results.push(validation.toolCall);
+            }
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Strategy B: Fix common JSON issues
+// ---------------------------------------------------------------------------
+function tryParseAndRepairJson(text) {
+    // Try direct parse first
+    try {
+        const parsed = JSON.parse(text);
+        if (typeof parsed === 'object' && parsed !== null)
+            return parsed;
+    }
+    catch {
+        // Fall through to repairs
+    }
+    let repaired = text;
+    // Fix trailing commas: { "a": 1, }
+    repaired = repaired.replace(/,\s*([}\]])/g, '$1');
+    // Fix unquoted keys: { name: "value" } → { "name": "value" }
+    repaired = repaired.replace(/([{,]\s*)(\w+)\s*:/g, '$1"$2":');
+    // Fix single-quoted strings: { 'name': 'value' } → { "name": "value" }
+    repaired = repaired.replace(/'([^'\\]*(?:\\.[^'\\]*)*)'/g, '"$1"');
+    // Fix missing closing bracket
+    const openBraces = (repaired.match(/\{/g) || []).length;
+    const closeBraces = (repaired.match(/\}/g) || []).length;
+    if (openBraces > closeBraces) {
+        repaired += '}'.repeat(openBraces - closeBraces);
+    }
+    // Fix missing closing square bracket in arrays
+    const openBrackets = (repaired.match(/\[/g) || []).length;
+    const closeBrackets = (repaired.match(/\]/g) || []).length;
+    if (openBrackets > closeBrackets) {
+        // Insert before last }
+        const lastBrace = repaired.lastIndexOf('}');
+        if (lastBrace > 0) {
+            repaired = repaired.slice(0, lastBrace) + ']'.repeat(openBrackets - closeBrackets) + repaired.slice(lastBrace);
+        }
+    }
+    try {
+        const parsed = JSON.parse(repaired);
+        if (typeof parsed === 'object' && parsed !== null)
+            return parsed;
+    }
+    catch {
+        // Could not repair
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Strategy C: Fuzzy tool name matching
+// ---------------------------------------------------------------------------
+/**
+ * Find the closest registered tool name for a possibly misspelled/partial name.
+ * Uses: exact match → case-insensitive → prefix match → Levenshtein distance.
+ */
+function fuzzyMatchToolName(name, available) {
+    if (!name || available.length === 0)
+        return null;
+    // Exact match
+    if (available.includes(name))
+        return name;
+    // Case-insensitive match
+    const lower = name.toLowerCase();
+    const ciMatch = available.find(t => t.toLowerCase() === lower);
+    if (ciMatch)
+        return ciMatch;
+    // Prefix match (e.g., "file_wr" → "file_write")
+    const prefixMatches = available.filter(t => t.toLowerCase().startsWith(lower));
+    if (prefixMatches.length === 1)
+        return prefixMatches[0];
+    // Contains match (e.g., "write" → "file_write")
+    const containsMatches = available.filter(t => t.toLowerCase().includes(lower));
+    if (containsMatches.length === 1)
+        return containsMatches[0];
+    // Levenshtein distance (max distance 3 to avoid wild matches)
+    let bestMatch = null;
+    let bestDist = 4;
+    for (const tool of available) {
+        const dist = levenshtein(lower, tool.toLowerCase());
+        if (dist < bestDist) {
+            bestDist = dist;
+            bestMatch = tool;
+        }
+    }
+    return bestMatch;
+}
+function levenshtein(a, b) {
+    const m = a.length;
+    const n = b.length;
+    // Use single-row optimization for memory efficiency
+    const row = Array.from({ length: n + 1 }, (_, i) => i);
+    for (let i = 1; i <= m; i++) {
+        let prev = i - 1;
+        row[0] = i;
+        for (let j = 1; j <= n; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            const val = Math.min(row[j] + 1, // deletion
+            row[j - 1] + 1, // insertion
+            prev + cost);
+            prev = row[j];
+            row[j] = val;
+        }
+    }
+    return row[n];
+}
+/**
+ * Coerce argument types to match the tool's Zod schema.
+ * Handles: string "true" → boolean, "42" → number, "null" → null.
+ */
+function coerceArgumentTypes(args, schema) {
+    const result = { ...args };
+    const fixes = [];
+    let fixed = false;
+    // Extract shape from ZodObject if possible
+    const shape = getZodObjectShape(schema);
+    if (!shape)
+        return { args, fixed: false, fixes };
+    for (const [key, value] of Object.entries(args)) {
+        const fieldSchema = shape[key];
+        if (!fieldSchema)
+            continue;
+        const expectedType = getZodBaseType(fieldSchema);
+        if (!expectedType)
+            continue;
+        // String → boolean coercion
+        if (expectedType === 'boolean' && typeof value === 'string') {
+            const lower = value.toLowerCase();
+            if (lower === 'true' || lower === 'yes' || lower === '1') {
+                result[key] = true;
+                fixes.push(`Coerced "${key}": "${value}" → true`);
+                fixed = true;
+            }
+            else if (lower === 'false' || lower === 'no' || lower === '0') {
+                result[key] = false;
+                fixes.push(`Coerced "${key}": "${value}" → false`);
+                fixed = true;
+            }
+        }
+        // String → number coercion
+        if (expectedType === 'number' && typeof value === 'string') {
+            const num = Number(value);
+            if (!isNaN(num) && value.trim() !== '') {
+                result[key] = num;
+                fixes.push(`Coerced "${key}": "${value}" → ${num}`);
+                fixed = true;
+            }
+        }
+        // String → null coercion
+        if (expectedType === 'null' && typeof value === 'string') {
+            if (value.toLowerCase() === 'null' || value === '') {
+                result[key] = null;
+                fixes.push(`Coerced "${key}": "${value}" → null`);
+                fixed = true;
+            }
+        }
+        // Array string → array coercion (e.g. "[1,2,3]" → [1,2,3])
+        if (expectedType === 'array' && typeof value === 'string') {
+            try {
+                const parsed = JSON.parse(value);
+                if (Array.isArray(parsed)) {
+                    result[key] = parsed;
+                    fixes.push(`Coerced "${key}": string → array`);
+                    fixed = true;
+                }
+            }
+            catch {
+                // Not valid JSON array
+            }
+        }
+    }
+    return { args: result, fixed, fixes };
+}
+// ---------------------------------------------------------------------------
+// Zod introspection helpers
+// ---------------------------------------------------------------------------
+function getZodObjectShape(schema) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const def = schema?._def;
+        if (def?.typeName === 'ZodObject') {
+            return def.shape();
+        }
+        // Handle ZodEffects wrapping (e.g., .transform(), .refine())
+        if (def?.typeName === 'ZodEffects' && def?.schema) {
+            return getZodObjectShape(def.schema);
+        }
+    }
+    catch {
+        // Schema introspection failed
+    }
+    return null;
+}
+function getZodBaseType(schema) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const def = schema?._def;
+        const typeName = def?.typeName;
+        if (!typeName)
+            return null;
+        switch (typeName) {
+            case 'ZodString': return 'string';
+            case 'ZodNumber': return 'number';
+            case 'ZodBoolean': return 'boolean';
+            case 'ZodNull': return 'null';
+            case 'ZodArray': return 'array';
+            case 'ZodOptional': return getZodBaseType(def.innerType);
+            case 'ZodDefault': return getZodBaseType(def.innerType);
+            case 'ZodNullable': return getZodBaseType(def.innerType);
+            default: return null;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=tool-repair.js.map

package/dist/src/llm/repair/tool-repair.js.map

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

package/dist/src/llm/shared/text-cleanup.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Pre-parse text cleanup — sanitizes raw LLM output before tool call parsing.
+ *
+ * Fixes common model artifacts that break JSON/XML parsing:
+ * - Markdown code fence wrappers around JSON
+ * - Thinking/reasoning tags (<think>, <thought>, etc.)
+ * - Control characters
+ * - Repeated newlines in JSON
+ * - Incomplete/truncated brackets
+ */
+/**
+ * Clean raw LLM output text before passing it to tool call parsers.
+ * This is a pure function that returns sanitized text — idempotent and safe.
+ */
+export declare function cleanLLMOutput(text: string): string;
+//# sourceMappingURL=text-cleanup.d.ts.map

package/dist/src/llm/shared/text-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-cleanup.d.ts","sourceRoot":"","sources":["../../../../src/llm/shared/text-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBnD"}

package/dist/src/llm/shared/text-cleanup.js

@@ -0,0 +1,120 @@
+/**
+ * Pre-parse text cleanup — sanitizes raw LLM output before tool call parsing.
+ *
+ * Fixes common model artifacts that break JSON/XML parsing:
+ * - Markdown code fence wrappers around JSON
+ * - Thinking/reasoning tags (<think>, <thought>, etc.)
+ * - Control characters
+ * - Repeated newlines in JSON
+ * - Incomplete/truncated brackets
+ */
+// ---------------------------------------------------------------------------
+// Main cleanup function
+// ---------------------------------------------------------------------------
+/**
+ * Clean raw LLM output text before passing it to tool call parsers.
+ * This is a pure function that returns sanitized text — idempotent and safe.
+ */
+export function cleanLLMOutput(text) {
+    if (!text)
+        return text;
+    let cleaned = text;
+    // 1. Strip thinking/reasoning tags and their content
+    cleaned = stripThinkingTags(cleaned);
+    // 2. Strip control characters (except newline, tab, carriage return)
+    cleaned = stripControlChars(cleaned);
+    // 3. Unwrap bare markdown JSON fences that wrap the entire response
+    //    (but NOT tool_call fences — those are handled by the parser)
+    cleaned = unwrapBareJsonFences(cleaned);
+    // 4. Collapse excessive whitespace inside JSON-like structures
+    cleaned = collapseJsonWhitespace(cleaned);
+    return cleaned;
+}
+// ---------------------------------------------------------------------------
+// Individual cleanup strategies
+// ---------------------------------------------------------------------------
+/**
+ * Strip thinking/reasoning tags and their content.
+ * Models like Qwen3, DeepSeek emit <think>...</think> blocks.
+ */
+function stripThinkingTags(text) {
+    // <think>...</think>
+    let cleaned = text.replace(/<think>[\s\S]*?<\/think>/gi, '');
+    // <thought>...</thought>
+    cleaned = cleaned.replace(/<thought>[\s\S]*?<\/thought>/gi, '');
+    // <reasoning>...</reasoning>
+    cleaned = cleaned.replace(/<reasoning>[\s\S]*?<\/reasoning>/gi, '');
+    // <reflection>...</reflection>
+    cleaned = cleaned.replace(/<reflection>[\s\S]*?<\/reflection>/gi, '');
+    // Ollama-specific thinking channel markers
+    cleaned = cleaned.replace(/<\|channel>thought[\s\S]*?<channel\|>/g, '');
+    cleaned = cleaned.replace(/<channel\|>/g, '');
+    return cleaned.trim();
+}
+/**
+ * Strip control characters that break JSON parsing.
+ * Preserves: \n (0x0A), \r (0x0D), \t (0x09)
+ */
+function stripControlChars(text) {
+    // eslint-disable-next-line no-control-regex
+    return text.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '');
+}
+/**
+ * Unwrap bare JSON code fences that wrap the entire response.
+ *
+ * Some models wrap their entire tool call in ```json ... ``` instead of
+ * using the proper ```tool_call format. We unwrap these to expose the
+ * raw JSON for the parser.
+ *
+ * Does NOT unwrap ```tool_call fences — those are handled by the parser.
+ */
+function unwrapBareJsonFences(text) {
+    const trimmed = text.trim();
+    // Check if the entire response is a single ```json fence
+    const jsonFenceMatch = trimmed.match(/^```(?:json)?\s*\n([\s\S]*?)\n```\s*$/);
+    if (jsonFenceMatch) {
+        const inner = jsonFenceMatch[1].trim();
+        // Only unwrap if the inner content looks like a tool call JSON
+        if (isToolCallLike(inner)) {
+            // Re-wrap as ```tool_call so the parser picks it up
+            return '```tool_call\n' + inner + '\n```';
+        }
+    }
+    return text;
+}
+/**
+ * Collapse excessive whitespace inside JSON structures.
+ * Some models emit JSON with many blank lines between keys.
+ */
+function collapseJsonWhitespace(text) {
+    // Only apply inside ```tool_call blocks to avoid mangling prose
+    return text.replace(/```tool_call\s*\n([\s\S]*?)\n```/g, (_match, inner) => {
+        const collapsed = inner
+            .split('\n')
+            .map((line) => line.trimEnd())
+            .filter((line, i, arr) => {
+            // Remove blank lines between JSON lines, but keep at least one
+            if (line === '' && i > 0 && arr[i - 1] === '')
+                return false;
+            return true;
+        })
+            .join('\n');
+        return '```tool_call\n' + collapsed + '\n```';
+    });
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Heuristic: does this text look like a tool call JSON object?
+ */
+function isToolCallLike(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith('{'))
+        return false;
+    // Check for tool call shape indicators
+    return ((trimmed.includes('"name"') && trimmed.includes('"arguments"')) ||
+        (trimmed.includes('"name"') && trimmed.includes('"args"')) ||
+        (trimmed.includes('"function"') && trimmed.includes('"arguments"')));
+}
+//# sourceMappingURL=text-cleanup.js.map

package/dist/src/llm/shared/text-cleanup.js.map

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

package/dist/src/llm/shared/tool-parsing.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Unified tool call parser for all LLM adapters.
+ *
+ * Consolidates the tool parsing logic that was duplicated across
+ * ollama.ts, openai.ts, and anthropic.ts into a single, well-tested module.
+ *
+ * Supports:
+ * - Native API tool calls (Ollama, OpenAI, Anthropic)
+ * - Text-based JSON format: ```tool_call\n{JSON}\n```
+ * - XML function format: <function=name><parameter=key>value</parameter></function>
+ * - Invoke format: <invoke name="..."><parameter name="...">value</parameter></invoke>
+ * - MiniMax wrapper: <minimax:tool_call>...</minimax:tool_call>
+ *
+ * Each strategy runs in order and returns on first match (waterfall).
+ */
+import type { ContentBlock } from '../../core/types.js';
+export interface ToolParseConfig {
+    /** Enable JSON ```tool_call``` format parsing. Default: true */
+    jsonToolFormat?: boolean;
+    /** Enable XML <function=name> format parsing. Default: true */
+    xmlToolFormat?: boolean;
+    /** Enable <invoke> tag format parsing. Default: true */
+    invokeFormat?: boolean;
+}
+export interface NativeToolCall {
+    function: {
+        name: string;
+        arguments: Record<string, unknown> | string;
+    };
+    id?: string;
+}
+/**
+ * Three-stage tool resolution waterfall.
+ * This is the main entry point for all adapters.
+ *
+ * 1. Native tool_calls from API (highest confidence)
+ * 2. Text-based JSON format
+ * 3. Text-based XML format
+ *
+ * Returns an array of ContentBlocks (text + tool_use mixed).
+ */
+export declare function resolveToolCalls(nativeToolCalls: NativeToolCall[] | null | undefined, textContent: string, config?: ToolParseConfig, hasTools?: boolean): ContentBlock[];
+/**
+ * Parse tool calls from text output using multiple strategies.
+ * Returns ContentBlock[] with interleaved text and tool_use blocks.
+ */
+export declare function parseTextToolCalls(text: string, config?: ToolParseConfig): ContentBlock[];
+/**
+ * Parse multiple JSON objects from a block that may contain:
+ * - A single JSON object
+ * - A JSON array
+ * - One object per line
+ * - Comma-separated objects
+ */
+export declare function parseMultipleJsonObjects(block: string): Array<{
+    name: string;
+    arguments: Record<string, unknown>;
+}>;
+/**
+ * Build the tool-call instruction suffix to inject into the system prompt
+ * for models that don't support native tool calling.
+ */
+export declare function buildToolPromptSuffix(tools: readonly {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}[], options?: {
+    strict?: boolean;
+}): string;
+//# sourceMappingURL=tool-parsing.d.ts.map

package/dist/src/llm/shared/tool-parsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-parsing.d.ts","sourceRoot":"","sources":["../../../../src/llm/shared/tool-parsing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAA2B,MAAM,qBAAqB,CAAA;AAQhF,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAA;KAC5C,CAAA;IACD,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAuBD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,cAAc,EAAE,GAAG,IAAI,GAAG,SAAS,EACpD,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,eAAe,EACxB,QAAQ,CAAC,EAAE,OAAO,GACjB,YAAY,EAAE,CA6ChB;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,eAAe,GACvB,YAAY,EAAE,CAgChB;AA8JD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CA+C7D;AAkBD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAAE,EAC7F,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,MAAM,CA0BR"}