@skaft/hamr 0.4.1

package/dist/hamr/providers/parsers/utils.js

@@ -0,0 +1,477 @@
+/**
+ * Shared parsing utilities for Hamr tool-call parsers.
+ *
+ * These are the building blocks used by individual parser implementations.
+ * They handle reasoning-tag sanitization, JSON repair, safe value coercion,
+ * call id generation, and safe Pythonic argument parsing.
+ */
+// ─── Reasoning-tag sanitization ─────────────────────────
+/**
+ * Strip <think>/<thinking> reasoning tags from model output.
+ * These tags are model-internal and should not affect tool-call parsing.
+ */
+export function sanitizeReasoningTags(content) {
+    // Fast-path: skip regex if no reasoning tags present.
+    // Must check for both opening (<think) and closing (</think) variants.
+    if (!content.includes("<think") && !content.includes("</think"))
+        return content;
+    return content
+        .replace(/<(think|thinking)\b[^>]*>[\s\S]*?<\/\1>/gi, "")
+        .replace(/<\/think(?:ing)?>/gi, "")
+        .trim();
+}
+// ─── JSON parsing with repair ───────────────────────────
+/**
+ * Fast-path JSON parse: try native JSON.parse and return immediately on success.
+ *
+ * This is the hot path — the vast majority of model-generated tool-call blocks
+ * are already valid JSON. A single try/catch is orders of magnitude cheaper than
+ * running the full repair cascade, and it avoids allocating intermediate strings.
+ *
+ * Use this directly when you know the source produces clean JSON (e.g., structured
+ * output from providers that guarantee valid JSON). Otherwise prefer safeJsonParse.
+ */
+export function fastJsonParse(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return { ok: false, error: "empty input" };
+    try {
+        return { ok: true, value: JSON.parse(trimmed) };
+    }
+    catch {
+        return { ok: false, error: `invalid JSON: ${trimmed.slice(0, 120)}` };
+    }
+}
+/**
+ * Parse JSON with limited repair for common local-model mistakes:
+ * - Trailing commas in objects/arrays
+ * - Missing closing braces/brackets
+ * - Bare keys without quotes in simple cases
+ *
+ * Uses fastJsonParse as a fast path — returns immediately on valid JSON.
+ * Only runs the repair cascade when the initial parse fails.
+ *
+ * This is intentionally conservative. Complex repair often masks real errors.
+ */
+export function safeJsonParse(raw) {
+    // ── Fast path: native JSON.parse ──────────────────────
+    // >90% of local-model tool-call blocks are valid JSON.
+    // This single try/catch avoids the regex, stack-walk, and
+    // substring allocations of the repair cascade below.
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return { ok: false, error: "empty input" };
+    const fast = fastJsonParse(raw);
+    if (fast.ok)
+        return fast;
+    // ── Repair cascade (only reached when fast path fails) ──
+    // Repair 1: trailing commas
+    const noTrailing = trimmed.replace(/,\s*([}\]])/g, "$1");
+    try {
+        return { ok: true, value: JSON.parse(noTrailing) };
+    }
+    catch {
+        // continue
+    }
+    // Repair 2: unclosed braces/brackets (simple stack-based)
+    const repaired = repairUnclosed(noTrailing);
+    if (repaired) {
+        try {
+            return { ok: true, value: JSON.parse(repaired) };
+        }
+        catch {
+            // continue
+        }
+    }
+    // Repair 3: extract from surrounding text (model sometimes wraps JSON in prose)
+    const extracted = extractJsonObject(trimmed);
+    if (extracted) {
+        try {
+            return { ok: true, value: JSON.parse(extracted) };
+        }
+        catch {
+            // continue
+        }
+    }
+    return { ok: false, error: `could not parse JSON: ${trimmed.slice(0, 120)}` };
+}
+/**
+ * Repair unclosed braces/brackets by adding missing closing chars.
+ */
+function repairUnclosed(json) {
+    const stack = [];
+    let inString = false;
+    let escape = false;
+    for (const ch of json) {
+        if (escape) {
+            escape = false;
+            continue;
+        }
+        if (ch === "\\" && inString) {
+            escape = true;
+            continue;
+        }
+        if (ch === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (ch === "{")
+            stack.push("}");
+        else if (ch === "[")
+            stack.push("]");
+        else if (ch === "}" || ch === "]") {
+            if (stack.length > 0 && stack[stack.length - 1] === ch) {
+                stack.pop();
+            }
+        }
+    }
+    if (stack.length === 0)
+        return null; // no repair needed
+    // Only repair if the imbalance is reasonable (< 10 unclosed)
+    if (stack.length > 10)
+        return null;
+    return json + stack.reverse().join("");
+}
+/**
+ * Extract a JSON object from text that may have prose around it.
+ */
+function extractJsonObject(text) {
+    const start = text.indexOf("{");
+    if (start === -1)
+        return null;
+    // Find matching closing brace
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    for (let i = start; i < text.length; i++) {
+        const ch = text[i];
+        if (escape) {
+            escape = false;
+            continue;
+        }
+        if (ch === "\\" && inString) {
+            escape = true;
+            continue;
+        }
+        if (ch === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (ch === "{")
+            depth++;
+        else if (ch === "}") {
+            depth--;
+            if (depth === 0)
+                return text.slice(start, i + 1);
+        }
+    }
+    return null; // unclosed
+}
+// ─── Call id generation ──────────────────────────────────
+let callIdCounter = 0;
+/**
+ * Generate a deterministic-ish call id.
+ * Uses the model-provided id if available, otherwise `call_N`.
+ */
+export function generateCallId(provided, index) {
+    if (provided && provided.trim().length > 0) {
+        const sanitized = provided
+            .trim()
+            .replace(/[^a-zA-Z0-9_-]/g, "_")
+            .slice(0, 64);
+        if (sanitized.length > 0)
+            return sanitized;
+    }
+    const idx = index ?? ++callIdCounter;
+    return `call_${idx}`;
+}
+/** Reset the call id counter (useful for tests). */
+export function resetCallIdCounter() {
+    callIdCounter = 0;
+}
+// ─── Safe value coercion ─────────────────────────────────
+/**
+ * Coerce a string value to the appropriate JS type for common literal forms.
+ * Handles: booleans, null, numbers, quoted strings, nested JSON.
+ * Strings that don't match any known literal are returned as-is.
+ */
+export function coerceValue(raw) {
+    const trimmed = raw.trim();
+    // Booleans
+    if (trimmed === "true")
+        return true;
+    if (trimmed === "false")
+        return false;
+    // Null
+    if (trimmed === "null")
+        return null;
+    // None (Pythonic)
+    if (trimmed === "None")
+        return null;
+    // Numbers (including negative, decimals, scientific notation)
+    if (/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/.test(trimmed)) {
+        return Number(trimmed);
+    }
+    // Quoted strings — unquote
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"') && trimmed.length >= 2) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'") && trimmed.length >= 2)) {
+        return trimmed.slice(1, -1);
+    }
+    // Nested JSON objects/arrays
+    if ((trimmed.startsWith("{") && trimmed.endsWith("}")) || (trimmed.startsWith("[") && trimmed.endsWith("]"))) {
+        const parsed = safeJsonParse(trimmed);
+        if (parsed.ok)
+            return parsed.value;
+    }
+    return trimmed;
+}
+// ─── Helper for building parsed calls ────────────────────
+export function makeCall(name, args, opts = {}) {
+    const warnings = [...(opts.warnings ?? [])];
+    return {
+        id: generateCallId(opts.id, opts.index),
+        name,
+        arguments: args,
+        rawSource: opts.rawSource,
+        parserId: opts.parserId,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+// ─── Safe Pythonic argument parsing ──────────────────────
+/**
+ * Parse a Pythonic function-call argument string into key-value pairs.
+ *
+ * Example input: `location="San Francisco", unit='celsius', count=42`
+ * Returns: `{ location: "San Francisco", unit: "celsius", count: 42 }`
+ *
+ * This is a safe tokenizer — it does NOT eval anything.
+ */
+export function parsePythonicArgs(argsStr) {
+    const result = {};
+    if (!argsStr.trim())
+        return result;
+    const tokens = tokenizePythonicArgs(argsStr);
+    let i = 0;
+    while (i < tokens.length) {
+        // Expect: identifier = value
+        if (i >= tokens.length)
+            break;
+        const keyToken = tokens[i];
+        if (keyToken.type !== "identifier") {
+            i++;
+            continue;
+        }
+        const key = keyToken.value;
+        i++;
+        // Skip '='
+        if (i < tokens.length && tokens[i].type === "operator" && tokens[i].value === "=") {
+            i++;
+        }
+        else {
+            // Positional arg or missing value — skip
+            continue;
+        }
+        // Value
+        if (i < tokens.length) {
+            const valToken = tokens[i];
+            result[key] = coercePythonicValue(valToken);
+            i++;
+            // Skip comma
+            if (i < tokens.length && tokens[i].type === "operator" && tokens[i].value === ",") {
+                i++;
+            }
+        }
+    }
+    return result;
+}
+function tokenizePythonicArgs(input) {
+    const tokens = [];
+    let i = 0;
+    while (i < input.length) {
+        const ch = input[i];
+        // Whitespace
+        if (/\s/.test(ch)) {
+            i++;
+            continue;
+        }
+        // Operator/comma/eq
+        if (ch === "," || ch === "=") {
+            tokens.push({ type: "operator", value: ch });
+            i++;
+            continue;
+        }
+        // Single-quoted string
+        if (ch === "'") {
+            i++;
+            let val = "";
+            while (i < input.length && input[i] !== "'") {
+                if (input[i] === "\\" && i + 1 < input.length) {
+                    val += input[++i];
+                }
+                else {
+                    val += input[i];
+                }
+                i++;
+            }
+            if (i < input.length)
+                i++; // closing quote
+            tokens.push({ type: "string", value: val });
+            continue;
+        }
+        // Double-quoted string
+        if (ch === '"') {
+            i++;
+            let val = "";
+            while (i < input.length && input[i] !== '"') {
+                if (input[i] === "\\" && i + 1 < input.length) {
+                    val += input[++i];
+                }
+                else {
+                    val += input[i];
+                }
+                i++;
+            }
+            if (i < input.length)
+                i++; // closing quote
+            tokens.push({ type: "string", value: val });
+            continue;
+        }
+        // Number
+        if (/[-\d]/.test(ch)) {
+            const start = i;
+            if (ch === "-")
+                i++;
+            while (i < input.length && /[\d.eE+-]/.test(input[i]))
+                i++;
+            const numStr = input.slice(start, i);
+            if (/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/.test(numStr)) {
+                tokens.push({ type: "number", value: numStr });
+                continue;
+            }
+            // Not a valid number, back up
+            i = start;
+        }
+        // Identifier / name
+        if (/[a-zA-Z_]/.test(ch)) {
+            const start = i;
+            while (i < input.length && /[\w.]/.test(input[i]))
+                i++;
+            const val = input.slice(start, i);
+            if (val === "True")
+                tokens.push({ type: "name", value: "True" });
+            else if (val === "False")
+                tokens.push({ type: "name", value: "False" });
+            else if (val === "None")
+                tokens.push({ type: "name", value: "None" });
+            else
+                tokens.push({ type: "identifier", value: val });
+            continue;
+        }
+        // Anything else
+        tokens.push({ type: "other", value: ch });
+        i++;
+    }
+    return tokens;
+}
+function coercePythonicValue(token) {
+    switch (token.type) {
+        case "string":
+            return token.value;
+        case "number":
+            return Number(token.value);
+        case "name":
+            if (token.value === "True")
+                return true;
+            if (token.value === "False")
+                return false;
+            if (token.value === "None")
+                return null;
+            return token.value;
+        case "identifier":
+            // Bare identifier in value position — treat as string
+            return token.value;
+        default:
+            return token.value;
+    }
+}
+export function extractDelimitedBlocks(content, openTag, closeTag) {
+    const blocks = [];
+    const between = [];
+    let after = "";
+    // Find first occurrence
+    const firstOpen = content.indexOf(openTag);
+    if (firstOpen === -1) {
+        return { before: content, blocks: [], between: [], after: "" };
+    }
+    const before = content.slice(0, firstOpen);
+    let remaining = content.slice(firstOpen);
+    while (remaining.length > 0) {
+        const openIdx = remaining.indexOf(openTag);
+        if (openIdx === -1) {
+            // No more open tags — remaining is trailing text after last block
+            after = remaining;
+            break;
+        }
+        if (openIdx > 0) {
+            // Text between blocks
+            between.push(remaining.slice(0, openIdx));
+            remaining = remaining.slice(openIdx);
+            continue;
+        }
+        // openIdx === 0 — we're at an open tag
+        // Find matching close tag
+        const closeIdx = remaining.indexOf(closeTag, openTag.length);
+        if (closeIdx === -1) {
+            // No matching close tag — treat remaining as text
+            between.push(remaining);
+            break;
+        }
+        const block = remaining.slice(openTag.length, closeIdx);
+        blocks.push(block);
+        remaining = remaining.slice(closeIdx + closeTag.length);
+    }
+    return {
+        before,
+        blocks,
+        between,
+        after,
+    };
+}
+// ─── Content extraction helpers ─────────────────────────
+/**
+ * Extract all content that is NOT inside tool-call delimiters.
+ * Used to separate tool calls from prose for transcript rendering.
+ */
+export function extractNonToolContent(content, openTag, closeTag) {
+    const delimited = extractDelimitedBlocks(content, openTag, closeTag);
+    const parts = [];
+    if (delimited.before.trim())
+        parts.push(delimited.before);
+    for (const b of delimited.between) {
+        if (b.trim())
+            parts.push(b);
+    }
+    if (delimited.after.trim())
+        parts.push(delimited.after);
+    return parts.join("\n").trim();
+}
+// ─── Multiple pattern extraction ─────────────────────────
+/**
+ * Try to find a pattern anywhere in the text (not just at start).
+ * Returns the match and the text before/after for multi-pattern parsing.
+ */
+export function findPattern(content, regex) {
+    const m = regex.exec(content);
+    if (!m)
+        return null;
+    return {
+        match: m,
+        before: content.slice(0, m.index),
+        after: content.slice(m.index + m[0].length),
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/hamr/providers/parsers/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared parsing utilities for Hamr tool-call parsers.\n *\n * These are the building blocks used by individual parser implementations.\n * They handle reasoning-tag sanitization, JSON repair, safe value coercion,\n * call id generation, and safe Pythonic argument parsing.\n */\n\nimport type { ParsedToolCall } from \"./types.ts\";\n\n// ─── Reasoning-tag sanitization ─────────────────────────\n\n/**\n * Strip <think>/<thinking> reasoning tags from model output.\n * These tags are model-internal and should not affect tool-call parsing.\n */\nexport function sanitizeReasoningTags(content: string): string {\n\t// Fast-path: skip regex if no reasoning tags present.\n\t// Must check for both opening (<think) and closing (</think) variants.\n\tif (!content.includes(\"<think\") && !content.includes(\"</think\")) return content;\n\treturn content\n\t\t.replace(/<(think|thinking)\\b[^>]*>[\\s\\S]*?<\\/\\1>/gi, \"\")\n\t\t.replace(/<\\/think(?:ing)?>/gi, \"\")\n\t\t.trim();\n}\n\n// ─── JSON parsing with repair ───────────────────────────\n\n/**\n * Fast-path JSON parse: try native JSON.parse and return immediately on success.\n *\n * This is the hot path — the vast majority of model-generated tool-call blocks\n * are already valid JSON. A single try/catch is orders of magnitude cheaper than\n * running the full repair cascade, and it avoids allocating intermediate strings.\n *\n * Use this directly when you know the source produces clean JSON (e.g., structured\n * output from providers that guarantee valid JSON). Otherwise prefer safeJsonParse.\n */\nexport function fastJsonParse(raw: string): { ok: true; value: unknown } | { ok: false; error: string } {\n\tconst trimmed = raw.trim();\n\tif (!trimmed) return { ok: false, error: \"empty input\" };\n\ttry {\n\t\treturn { ok: true, value: JSON.parse(trimmed) };\n\t} catch {\n\t\treturn { ok: false, error: `invalid JSON: ${trimmed.slice(0, 120)}` };\n\t}\n}\n\n/**\n * Parse JSON with limited repair for common local-model mistakes:\n * - Trailing commas in objects/arrays\n * - Missing closing braces/brackets\n * - Bare keys without quotes in simple cases\n *\n * Uses fastJsonParse as a fast path — returns immediately on valid JSON.\n * Only runs the repair cascade when the initial parse fails.\n *\n * This is intentionally conservative. Complex repair often masks real errors.\n */\nexport function safeJsonParse(raw: string): { ok: true; value: unknown } | { ok: false; error: string } {\n\t// ── Fast path: native JSON.parse ──────────────────────\n\t// >90% of local-model tool-call blocks are valid JSON.\n\t// This single try/catch avoids the regex, stack-walk, and\n\t// substring allocations of the repair cascade below.\n\tconst trimmed = raw.trim();\n\tif (!trimmed) return { ok: false, error: \"empty input\" };\n\n\tconst fast = fastJsonParse(raw);\n\tif (fast.ok) return fast;\n\n\t// ── Repair cascade (only reached when fast path fails) ──\n\n\t// Repair 1: trailing commas\n\tconst noTrailing = trimmed.replace(/,\\s*([}\\]])/g, \"$1\");\n\ttry {\n\t\treturn { ok: true, value: JSON.parse(noTrailing) };\n\t} catch {\n\t\t// continue\n\t}\n\n\t// Repair 2: unclosed braces/brackets (simple stack-based)\n\tconst repaired = repairUnclosed(noTrailing);\n\tif (repaired) {\n\t\ttry {\n\t\t\treturn { ok: true, value: JSON.parse(repaired) };\n\t\t} catch {\n\t\t\t// continue\n\t\t}\n\t}\n\n\t// Repair 3: extract from surrounding text (model sometimes wraps JSON in prose)\n\tconst extracted = extractJsonObject(trimmed);\n\tif (extracted) {\n\t\ttry {\n\t\t\treturn { ok: true, value: JSON.parse(extracted) };\n\t\t} catch {\n\t\t\t// continue\n\t\t}\n\t}\n\n\treturn { ok: false, error: `could not parse JSON: ${trimmed.slice(0, 120)}` };\n}\n\n/**\n * Repair unclosed braces/brackets by adding missing closing chars.\n */\nfunction repairUnclosed(json: string): string | null {\n\tconst stack: string[] = [];\n\tlet inString = false;\n\tlet escape = false;\n\n\tfor (const ch of json) {\n\t\tif (escape) {\n\t\t\tescape = false;\n\t\t\tcontinue;\n\t\t}\n\t\tif (ch === \"\\\\\" && inString) {\n\t\t\tescape = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (ch === '\"') {\n\t\t\tinString = !inString;\n\t\t\tcontinue;\n\t\t}\n\t\tif (inString) continue;\n\n\t\tif (ch === \"{\") stack.push(\"}\");\n\t\telse if (ch === \"[\") stack.push(\"]\");\n\t\telse if (ch === \"}\" || ch === \"]\") {\n\t\t\tif (stack.length > 0 && stack[stack.length - 1] === ch) {\n\t\t\t\tstack.pop();\n\t\t\t}\n\t\t}\n\t}\n\n\tif (stack.length === 0) return null; // no repair needed\n\t// Only repair if the imbalance is reasonable (< 10 unclosed)\n\tif (stack.length > 10) return null;\n\treturn json + stack.reverse().join(\"\");\n}\n\n/**\n * Extract a JSON object from text that may have prose around it.\n */\nfunction extractJsonObject(text: string): string | null {\n\tconst start = text.indexOf(\"{\");\n\tif (start === -1) return null;\n\t// Find matching closing brace\n\tlet depth = 0;\n\tlet inString = false;\n\tlet escape = false;\n\n\tfor (let i = start; i < text.length; i++) {\n\t\tconst ch = text[i];\n\t\tif (escape) {\n\t\t\tescape = false;\n\t\t\tcontinue;\n\t\t}\n\t\tif (ch === \"\\\\\" && inString) {\n\t\t\tescape = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (ch === '\"') {\n\t\t\tinString = !inString;\n\t\t\tcontinue;\n\t\t}\n\t\tif (inString) continue;\n\t\tif (ch === \"{\") depth++;\n\t\telse if (ch === \"}\") {\n\t\t\tdepth--;\n\t\t\tif (depth === 0) return text.slice(start, i + 1);\n\t\t}\n\t}\n\treturn null; // unclosed\n}\n\n// ─── Call id generation ──────────────────────────────────\n\nlet callIdCounter = 0;\n\n/**\n * Generate a deterministic-ish call id.\n * Uses the model-provided id if available, otherwise `call_N`.\n */\nexport function generateCallId(provided?: string, index?: number): string {\n\tif (provided && provided.trim().length > 0) {\n\t\tconst sanitized = provided\n\t\t\t.trim()\n\t\t\t.replace(/[^a-zA-Z0-9_-]/g, \"_\")\n\t\t\t.slice(0, 64);\n\t\tif (sanitized.length > 0) return sanitized;\n\t}\n\tconst idx = index ?? ++callIdCounter;\n\treturn `call_${idx}`;\n}\n\n/** Reset the call id counter (useful for tests). */\nexport function resetCallIdCounter(): void {\n\tcallIdCounter = 0;\n}\n\n// ─── Safe value coercion ─────────────────────────────────\n\n/**\n * Coerce a string value to the appropriate JS type for common literal forms.\n * Handles: booleans, null, numbers, quoted strings, nested JSON.\n * Strings that don't match any known literal are returned as-is.\n */\nexport function coerceValue(raw: string): unknown {\n\tconst trimmed = raw.trim();\n\n\t// Booleans\n\tif (trimmed === \"true\") return true;\n\tif (trimmed === \"false\") return false;\n\n\t// Null\n\tif (trimmed === \"null\") return null;\n\n\t// None (Pythonic)\n\tif (trimmed === \"None\") return null;\n\n\t// Numbers (including negative, decimals, scientific notation)\n\tif (/^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$/.test(trimmed)) {\n\t\treturn Number(trimmed);\n\t}\n\n\t// Quoted strings — unquote\n\tif (\n\t\t(trimmed.startsWith('\"') && trimmed.endsWith('\"') && trimmed.length >= 2) ||\n\t\t(trimmed.startsWith(\"'\") && trimmed.endsWith(\"'\") && trimmed.length >= 2)\n\t) {\n\t\treturn trimmed.slice(1, -1);\n\t}\n\n\t// Nested JSON objects/arrays\n\tif ((trimmed.startsWith(\"{\") && trimmed.endsWith(\"}\")) || (trimmed.startsWith(\"[\") && trimmed.endsWith(\"]\"))) {\n\t\tconst parsed = safeJsonParse(trimmed);\n\t\tif (parsed.ok) return parsed.value;\n\t}\n\n\treturn trimmed;\n}\n\n// ─── Helper for building parsed calls ────────────────────\n\nexport function makeCall(\n\tname: string,\n\targs: Record<string, unknown>,\n\topts: { id?: string; index?: number; rawSource?: string; parserId?: string; warnings?: string[] } = {},\n): ParsedToolCall {\n\tconst warnings = [...(opts.warnings ?? [])];\n\treturn {\n\t\tid: generateCallId(opts.id, opts.index),\n\t\tname,\n\t\targuments: args,\n\t\trawSource: opts.rawSource,\n\t\tparserId: opts.parserId,\n\t\twarnings: warnings.length > 0 ? warnings : undefined,\n\t};\n}\n\n// ─── Safe Pythonic argument parsing ──────────────────────\n\n/**\n * Parse a Pythonic function-call argument string into key-value pairs.\n *\n * Example input: `location=\"San Francisco\", unit='celsius', count=42`\n * Returns: `{ location: \"San Francisco\", unit: \"celsius\", count: 42 }`\n *\n * This is a safe tokenizer — it does NOT eval anything.\n */\nexport function parsePythonicArgs(argsStr: string): Record<string, unknown> {\n\tconst result: Record<string, unknown> = {};\n\tif (!argsStr.trim()) return result;\n\n\tconst tokens = tokenizePythonicArgs(argsStr);\n\tlet i = 0;\n\n\twhile (i < tokens.length) {\n\t\t// Expect: identifier = value\n\t\tif (i >= tokens.length) break;\n\t\tconst keyToken = tokens[i];\n\t\tif (keyToken.type !== \"identifier\") {\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\t\tconst key = keyToken.value;\n\t\ti++;\n\n\t\t// Skip '='\n\t\tif (i < tokens.length && tokens[i].type === \"operator\" && tokens[i].value === \"=\") {\n\t\t\ti++;\n\t\t} else {\n\t\t\t// Positional arg or missing value — skip\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Value\n\t\tif (i < tokens.length) {\n\t\t\tconst valToken = tokens[i];\n\t\t\tresult[key] = coercePythonicValue(valToken);\n\t\t\ti++;\n\t\t\t// Skip comma\n\t\t\tif (i < tokens.length && tokens[i].type === \"operator\" && tokens[i].value === \",\") {\n\t\t\t\ti++;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn result;\n}\n\ninterface PyToken {\n\ttype: \"identifier\" | \"string\" | \"number\" | \"operator\" | \"name\" | \"other\";\n\tvalue: string;\n}\n\nfunction tokenizePythonicArgs(input: string): PyToken[] {\n\tconst tokens: PyToken[] = [];\n\tlet i = 0;\n\n\twhile (i < input.length) {\n\t\tconst ch = input[i];\n\n\t\t// Whitespace\n\t\tif (/\\s/.test(ch)) {\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Operator/comma/eq\n\t\tif (ch === \",\" || ch === \"=\") {\n\t\t\ttokens.push({ type: \"operator\", value: ch });\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Single-quoted string\n\t\tif (ch === \"'\") {\n\t\t\ti++;\n\t\t\tlet val = \"\";\n\t\t\twhile (i < input.length && input[i] !== \"'\") {\n\t\t\t\tif (input[i] === \"\\\\\" && i + 1 < input.length) {\n\t\t\t\t\tval += input[++i];\n\t\t\t\t} else {\n\t\t\t\t\tval += input[i];\n\t\t\t\t}\n\t\t\t\ti++;\n\t\t\t}\n\t\t\tif (i < input.length) i++; // closing quote\n\t\t\ttokens.push({ type: \"string\", value: val });\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Double-quoted string\n\t\tif (ch === '\"') {\n\t\t\ti++;\n\t\t\tlet val = \"\";\n\t\t\twhile (i < input.length && input[i] !== '\"') {\n\t\t\t\tif (input[i] === \"\\\\\" && i + 1 < input.length) {\n\t\t\t\t\tval += input[++i];\n\t\t\t\t} else {\n\t\t\t\t\tval += input[i];\n\t\t\t\t}\n\t\t\t\ti++;\n\t\t\t}\n\t\t\tif (i < input.length) i++; // closing quote\n\t\t\ttokens.push({ type: \"string\", value: val });\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Number\n\t\tif (/[-\\d]/.test(ch)) {\n\t\t\tconst start = i;\n\t\t\tif (ch === \"-\") i++;\n\t\t\twhile (i < input.length && /[\\d.eE+-]/.test(input[i])) i++;\n\t\t\tconst numStr = input.slice(start, i);\n\t\t\tif (/^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$/.test(numStr)) {\n\t\t\t\ttokens.push({ type: \"number\", value: numStr });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\t// Not a valid number, back up\n\t\t\ti = start;\n\t\t}\n\n\t\t// Identifier / name\n\t\tif (/[a-zA-Z_]/.test(ch)) {\n\t\t\tconst start = i;\n\t\t\twhile (i < input.length && /[\\w.]/.test(input[i])) i++;\n\t\t\tconst val = input.slice(start, i);\n\t\t\tif (val === \"True\") tokens.push({ type: \"name\", value: \"True\" });\n\t\t\telse if (val === \"False\") tokens.push({ type: \"name\", value: \"False\" });\n\t\t\telse if (val === \"None\") tokens.push({ type: \"name\", value: \"None\" });\n\t\t\telse tokens.push({ type: \"identifier\", value: val });\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Anything else\n\t\ttokens.push({ type: \"other\", value: ch });\n\t\ti++;\n\t}\n\n\treturn tokens;\n}\n\nfunction coercePythonicValue(token: PyToken): unknown {\n\tswitch (token.type) {\n\t\tcase \"string\":\n\t\t\treturn token.value;\n\t\tcase \"number\":\n\t\t\treturn Number(token.value);\n\t\tcase \"name\":\n\t\t\tif (token.value === \"True\") return true;\n\t\t\tif (token.value === \"False\") return false;\n\t\t\tif (token.value === \"None\") return null;\n\t\t\treturn token.value;\n\t\tcase \"identifier\":\n\t\t\t// Bare identifier in value position — treat as string\n\t\t\treturn token.value;\n\t\tdefault:\n\t\t\treturn token.value;\n\t}\n}\n\n// ─── Tool-call delimiter extraction ──────────────────────\n\n/**\n * Split content into segments separated by tool-call blocks.\n * Returns { before, blocks, between } where:\n * - before is text before the first block\n * - blocks is an array of matched tool-call text\n * - between is text after the last block\n */\nexport interface DelimitedResult {\n\tbefore: string;\n\tblocks: string[];\n\tbetween: string[];\n\tafter: string;\n}\n\nexport function extractDelimitedBlocks(content: string, openTag: string, closeTag: string): DelimitedResult {\n\tconst blocks: string[] = [];\n\tconst between: string[] = [];\n\tlet after = \"\";\n\n\t// Find first occurrence\n\tconst firstOpen = content.indexOf(openTag);\n\tif (firstOpen === -1) {\n\t\treturn { before: content, blocks: [], between: [], after: \"\" };\n\t}\n\tconst before = content.slice(0, firstOpen);\n\tlet remaining = content.slice(firstOpen);\n\n\twhile (remaining.length > 0) {\n\t\tconst openIdx = remaining.indexOf(openTag);\n\n\t\tif (openIdx === -1) {\n\t\t\t// No more open tags — remaining is trailing text after last block\n\t\t\tafter = remaining;\n\t\t\tbreak;\n\t\t}\n\n\t\tif (openIdx > 0) {\n\t\t\t// Text between blocks\n\t\t\tbetween.push(remaining.slice(0, openIdx));\n\t\t\tremaining = remaining.slice(openIdx);\n\t\t\tcontinue;\n\t\t}\n\n\t\t// openIdx === 0 — we're at an open tag\n\t\t// Find matching close tag\n\t\tconst closeIdx = remaining.indexOf(closeTag, openTag.length);\n\t\tif (closeIdx === -1) {\n\t\t\t// No matching close tag — treat remaining as text\n\t\t\tbetween.push(remaining);\n\t\t\tbreak;\n\t\t}\n\n\t\tconst block = remaining.slice(openTag.length, closeIdx);\n\t\tblocks.push(block);\n\t\tremaining = remaining.slice(closeIdx + closeTag.length);\n\t}\n\n\treturn {\n\t\tbefore,\n\t\tblocks,\n\t\tbetween,\n\t\tafter,\n\t};\n}\n\n// ─── Content extraction helpers ─────────────────────────\n\n/**\n * Extract all content that is NOT inside tool-call delimiters.\n * Used to separate tool calls from prose for transcript rendering.\n */\nexport function extractNonToolContent(content: string, openTag: string, closeTag: string): string {\n\tconst delimited = extractDelimitedBlocks(content, openTag, closeTag);\n\n\tconst parts: string[] = [];\n\tif (delimited.before.trim()) parts.push(delimited.before);\n\tfor (const b of delimited.between) {\n\t\tif (b.trim()) parts.push(b);\n\t}\n\tif (delimited.after.trim()) parts.push(delimited.after);\n\n\treturn parts.join(\"\\n\").trim();\n}\n\n// ─── Multiple pattern extraction ─────────────────────────\n\n/**\n * Try to find a pattern anywhere in the text (not just at start).\n * Returns the match and the text before/after for multi-pattern parsing.\n */\nexport function findPattern(\n\tcontent: string,\n\tregex: RegExp,\n): { match: RegExpMatchArray; before: string; after: string } | null {\n\tconst m = regex.exec(content);\n\tif (!m) return null;\n\treturn {\n\t\tmatch: m,\n\t\tbefore: content.slice(0, m.index),\n\t\tafter: content.slice(m.index + m[0].length),\n\t};\n}\n"]}

package/dist/hamr/providers/parsers/xlam.d.ts

@@ -0,0 +1,23 @@
+/**
+ * xLAM tool-call parser.
+ *
+ * Parses xLAM-format tool calls. The xLAM family uses Hermes-compatible
+ * XML-style tags with JSON tool call objects:
+ *
+ *   <tool_call>
+ *   {"name": "get_weather", "arguments": {"location": "SF", "unit": "celsius"}}
+ *   </tool_call>
+ *
+ * Reference: vLLM
+ *   --tool-call-parser xlam
+ *   vllm/entrypoints/openai/tool_parsers/xlam_tool_parser.py
+ *
+ * Note: xLAM also supports a second format using plain function name then args:
+ *   get_weather
+ *   {"location": "SF", "unit": "celsius"}
+ * This parser handles both formats.
+ */
+import type { ToolCallParser } from "./types.ts";
+export declare const xlamParser: ToolCallParser;
+export declare function createXlamParser(): ToolCallParser;
+//# sourceMappingURL=xlam.d.ts.map

package/dist/hamr/providers/parsers/xlam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xlam.d.ts","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/xlam.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAuC,cAAc,EAAE,MAAM,YAAY,CAAC;AAOtF,eAAO,MAAM,UAAU,EAAE,cAiFxB,CAAC;AAwBF,wBAAgB,gBAAgB,IAAI,cAAc,CAEjD"}