@skaft/hamr 0.4.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"pythonic.js","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/pythonic.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pythonic tool-call parser.\n *\n * Parses Python-list-format tool calls used by models that generate\n * Python syntax for function calls:\n *\n *   [get_weather(city='San Francisco', metric='celsius'),\n *    get_weather(city='Seattle', metric='celsius')]\n *\n * Also supports bare calls without the list wrapper:\n *\n *   get_weather(city='San Francisco', metric='celsius')\n *\n * This parser uses a safe tokenizer — it does NOT eval anything.\n * Supports parallel tool calls (multiple functions in one list).\n *\n * Variants:\n *   - pythonic: general Pythonic list format\n *   - llama4_pythonic: subset with Llama-4-specific handling\n *\n * Reference: vLLM docs/features/tool_calling.md → \"Models with Pythonic Tool Calls\"\n *   --tool-call-parser pythonic\n *   vllm/entrypoints/openai/tool_parsers/pythonic_tool_parser.py\n */\n\nimport type { ParsedToolCall, ToolCallParseResult, ToolCallParser } from \"./types.ts\";\nimport { generateCallId, parsePythonicArgs, sanitizeReasoningTags } from \"./utils.ts\";\n\n// ─── Token types ──────────────────────────────────────────\n\ninterface Token {\n\ttype: \"lparen\" | \"rparen\" | \"lbracket\" | \"rbracket\" | \"comma\" | \"name\" | \"text\" | \"whitespace\";\n\tvalue: string;\n\tpos: number;\n}\n\n// ─── Shared parser logic ──────────────────────────────────\n\nfunction tokenize(input: string): Token[] {\n\tconst tokens: Token[] = [];\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\tconst start = i;\n\t\t\twhile (i < input.length && /\\s/.test(input[i])) i++;\n\t\t\ttokens.push({ type: \"whitespace\", value: input.slice(start, i), pos: start });\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Brackets/parens\n\t\tif (ch === \"(\") {\n\t\t\ttokens.push({ type: \"lparen\", value: \"(\", pos: i });\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\t\tif (ch === \")\") {\n\t\t\ttokens.push({ type: \"rparen\", value: \")\", pos: i });\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\t\tif (ch === \"[\") {\n\t\t\ttokens.push({ type: \"lbracket\", value: \"[\", pos: i });\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\t\tif (ch === \"]\") {\n\t\t\ttokens.push({ type: \"rbracket\", value: \"]\", pos: i });\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\t\tif (ch === \",\") {\n\t\t\ttokens.push({ type: \"comma\", value: \",\", pos: i });\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Strings (single or double quoted)\n\t\tif (ch === \"'\" || ch === '\"') {\n\t\t\tconst quote = ch;\n\t\t\tconst start = i;\n\t\t\ti++;\n\t\t\twhile (i < input.length && input[i] !== quote) {\n\t\t\t\tif (input[i] === \"\\\\\" && i + 1 < input.length) i++;\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: \"text\", value: input.slice(start, i), pos: start });\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Names/identifiers\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\ttokens.push({ type: \"name\", value: input.slice(start, i), pos: start });\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Anything else as text\n\t\ttokens.push({ type: \"text\", value: ch, pos: i });\n\t\ti++;\n\t}\n\n\treturn tokens;\n}\n\nfunction parsePythonicCalls(text: string, parserId: string): { calls: ParsedToolCall[]; remainder: string } {\n\tconst tokens = tokenize(text);\n\tconst calls: ParsedToolCall[] = [];\n\tconst nonCallTokens: Token[] = [];\n\n\tlet i = 0;\n\twhile (i < tokens.length) {\n\t\t// Skip whitespace in non-call context\n\t\twhile (i < tokens.length && tokens[i].type === \"whitespace\") {\n\t\t\tnonCallTokens.push(tokens[i]);\n\t\t\ti++;\n\t\t}\n\t\tif (i >= tokens.length) break;\n\n\t\t// Check for function call pattern: name ( args )\n\t\tif (tokens[i].type === \"name\" && i + 1 < tokens.length && tokens[i + 1].type === \"lparen\") {\n\t\t\tconst fnName = tokens[i].value;\n\t\t\ti += 2; // skip name and '('\n\n\t\t\t// Collect args until matching ')'\n\t\t\tlet depth = 1;\n\t\t\tconst argTokens: Token[] = [];\n\t\t\twhile (i < tokens.length && depth > 0) {\n\t\t\t\tconst tok = tokens[i];\n\t\t\t\tif (tok.type === \"lparen\") depth++;\n\t\t\t\telse if (tok.type === \"rparen\") {\n\t\t\t\t\tdepth--;\n\t\t\t\t\tif (depth === 0) {\n\t\t\t\t\t\ti++;\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\targTokens.push(tok);\n\t\t\t\ti++;\n\t\t\t}\n\n\t\t\tif (depth === 0) {\n\t\t\t\t// Successfully parsed a function call\n\t\t\t\tconst argsStr = argTokens.map((t) => t.value).join(\"\");\n\t\t\t\tconst args = parsePythonicArgs(argsStr);\n\t\t\t\tcalls.push({\n\t\t\t\t\tid: generateCallId(undefined, calls.length + 1),\n\t\t\t\t\tname: fnName,\n\t\t\t\t\targuments: args,\n\t\t\t\t\trawSource: `${fnName}(${argsStr})`,\n\t\t\t\t\tparserId,\n\t\t\t\t});\n\n\t\t\t\t// Check for comma after call\n\t\t\t\twhile (i < tokens.length && tokens[i].type === \"whitespace\") i++;\n\t\t\t\tif (i < tokens.length && tokens[i].type === \"comma\") {\n\t\t\t\t\ti++; // skip comma\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\n\t\t// Check for list wrapper: [ call1, call2, ... ]\n\t\tif (tokens[i].type === \"lbracket\") {\n\t\t\tconst listStart = i;\n\t\t\ti++; // skip '['\n\t\t\tlet depth = 1;\n\t\t\tconst listTokens: Token[] = [];\n\n\t\t\twhile (i < tokens.length && depth > 0) {\n\t\t\t\tconst tok = tokens[i];\n\t\t\t\tif (tok.type === \"lbracket\") depth++;\n\t\t\t\telse if (tok.type === \"rbracket\") {\n\t\t\t\t\tdepth--;\n\t\t\t\t\tif (depth === 0) {\n\t\t\t\t\t\ti++;\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tlistTokens.push(tok);\n\t\t\t\ti++;\n\t\t\t}\n\n\t\t\tif (depth === 0) {\n\t\t\t\t// Recursively parse the list contents\n\t\t\t\tconst listContent = listTokens.map((t) => t.value).join(\"\");\n\t\t\t\tconst nested = parsePythonicCalls(listContent, parserId);\n\t\t\t\tfor (const call of nested.calls) {\n\t\t\t\t\tcalls.push(call);\n\t\t\t\t}\n\t\t\t\t// Check for comma after list\n\t\t\t\twhile (i < tokens.length && tokens[i].type === \"whitespace\") i++;\n\t\t\t\tif (i < tokens.length && tokens[i].type === \"comma\") {\n\t\t\t\t\ti++;\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Unclosed bracket — push remaining as non-call\n\t\t\tnonCallTokens.push(tokens[listStart]);\n\t\t\tfor (let j = listStart + 1; j < i; j++) {\n\t\t\t\tnonCallTokens.push(tokens[j]);\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Not a function call — accumulate as non-call text\n\t\tnonCallTokens.push(tokens[i]);\n\t\ti++;\n\t}\n\n\tconst remainder = nonCallTokens\n\t\t.map((t) => t.value)\n\t\t.join(\"\")\n\t\t.trim();\n\treturn { calls, remainder };\n}\n\n// ─── Parser instances ─────────────────────────────────────\n\nconst PYTHONIC_DESCRIPTION = 'Pythonic list format: [func_name(key=\"value\", ...), ...]';\nconst PYTHONIC_FAMILIES = [\"Llama 4\", \"Pythonic-capable models\"];\n\nexport const pythonicParser: ToolCallParser = {\n\tid: \"pythonic\",\n\tdescription: PYTHONIC_DESCRIPTION,\n\tmodelFamilies: PYTHONIC_FAMILIES,\n\n\tparse(content: string): ToolCallParseResult {\n\t\tconst sanitized = sanitizeReasoningTags(content);\n\t\tconst { calls, remainder } = parsePythonicCalls(sanitized, \"pythonic\");\n\n\t\treturn {\n\t\t\tok: true,\n\t\t\tparserId: \"pythonic\",\n\t\t\tcalls,\n\t\t\tcontent: remainder,\n\t\t};\n\t},\n};\n\nexport const llama4PythonicParser: ToolCallParser = {\n\tid: \"llama4_pythonic\",\n\tdescription: \"Llama 4 Pythonic format: same as pythonic but with Llama-4-specific patterns\",\n\tmodelFamilies: [\"Llama 4\"],\n\n\tparse(content: string): ToolCallParseResult {\n\t\tconst sanitized = sanitizeReasoningTags(content);\n\n\t\t// Llama 4 may wrap calls in <|python_tag|> — strip those\n\t\tconst cleaned = sanitized.replace(/<\\|python_tag\\|>/gi, \"\").trim();\n\n\t\tconst { calls, remainder } = parsePythonicCalls(cleaned, \"llama4_pythonic\");\n\n\t\treturn {\n\t\t\tok: true,\n\t\t\tparserId: \"llama4_pythonic\",\n\t\t\tcalls,\n\t\t\tcontent: remainder,\n\t\t};\n\t},\n};\n\n// ─── Factories ────────────────────────────────────────────\n\nexport function createPythonicParser(): ToolCallParser {\n\treturn pythonicParser;\n}\n\nexport function createLlama4PythonicParser(): ToolCallParser {\n\treturn llama4PythonicParser;\n}\n"]}

package/dist/hamr/providers/parsers/qwen3-xml.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Qwen3 XML tool-call parser.
+ *
+ * Parses Qwen3-Coder / Qwen3 XML-format tool calls:
+ *
+ *   <tool_call>
+ *   <function=get_weather>
+ *   <parameter=location>San Francisco</parameter>
+ *   <parameter=unit>celsius</parameter>
+ *   </function>
+ *   </tool_call>
+ *
+ * Reference: vLLM docs/features/tool_calling.md → "Qwen3-Coder Models"
+ *   Supported via --tool-call-parser qwen3_xml
+ */
+import type { ToolCallParser } from "./types.ts";
+export declare const qwen3XmlParser: ToolCallParser;
+export declare function createQwen3XmlParser(): ToolCallParser;
+//# sourceMappingURL=qwen3-xml.d.ts.map

package/dist/hamr/providers/parsers/qwen3-xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen3-xml.d.ts","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/qwen3-xml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAuC,cAAc,EAAE,MAAM,YAAY,CAAC;AAQtF,eAAO,MAAM,cAAc,EAAE,cAqD5B,CAAC;AAmDF,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/dist/hamr/providers/parsers/qwen3-xml.js

@@ -0,0 +1,107 @@
+/**
+ * Qwen3 XML tool-call parser.
+ *
+ * Parses Qwen3-Coder / Qwen3 XML-format tool calls:
+ *
+ *   <tool_call>
+ *   <function=get_weather>
+ *   <parameter=location>San Francisco</parameter>
+ *   <parameter=unit>celsius</parameter>
+ *   </function>
+ *   </tool_call>
+ *
+ * Reference: vLLM docs/features/tool_calling.md → "Qwen3-Coder Models"
+ *   Supported via --tool-call-parser qwen3_xml
+ */
+import { coerceValue, extractDelimitedBlocks, generateCallId, sanitizeReasoningTags } from "./utils.js";
+const PARSER_ID = "qwen3_xml";
+const DESCRIPTION = "Qwen3-Coder / Qwen3 XML format: <tool_call><function=name><parameter=key>value</parameter></function></tool_call>";
+const FAMILIES = ["Qwen3", "Qwen3-Coder", "Qwen3.5", "Qwen3.6"];
+export const qwen3XmlParser = {
+    id: PARSER_ID,
+    description: DESCRIPTION,
+    modelFamilies: FAMILIES,
+    parse(content) {
+        const sanitized = sanitizeReasoningTags(content);
+        const delimited = extractDelimitedBlocks(sanitized, "<tool_call>", "</tool_call>");
+        if (delimited.blocks.length === 0) {
+            return {
+                ok: true,
+                parserId: PARSER_ID,
+                calls: [],
+                content: sanitized,
+            };
+        }
+        const calls = [];
+        const warnings = [];
+        for (let i = 0; i < delimited.blocks.length; i++) {
+            const block = delimited.blocks[i];
+            const parsed = parseQwenFunctionBlock(block, i);
+            if (!parsed.ok) {
+                // Unrecoverable parse error in a tool-call block
+                return {
+                    ok: false,
+                    parserId: PARSER_ID,
+                    calls: [],
+                    content: sanitized,
+                    error: parsed.error,
+                };
+            }
+            if (parsed.call) {
+                if (parsed.warnings)
+                    warnings.push(...parsed.warnings);
+                calls.push(parsed.call);
+            }
+        }
+        // Extract non-tool text from between blocks
+        const nonToolContent = [delimited.before, ...delimited.between, delimited.after].filter(Boolean).join("\n").trim();
+        return {
+            ok: true,
+            parserId: PARSER_ID,
+            calls,
+            content: nonToolContent,
+            warnings: warnings.length > 0 ? warnings : undefined,
+        };
+    },
+};
+// ─── Block parser ─────────────────────────────────────────
+function parseQwenFunctionBlock(block, index) {
+    const trimmed = block.trim();
+    // Find <function=NAME>...</function>
+    const fnMatch = trimmed.match(/<function=([^>\s]+)>\s*([\s\S]*?)\s*<\/function>/i);
+    if (!fnMatch?.[1]) {
+        return { ok: false, error: "Qwen tool_call block missing <function=...> wrapper" };
+    }
+    const fnName = fnMatch[1].trim();
+    const argsBody = fnMatch[2] ?? "";
+    const args = {};
+    const warnings = [];
+    const paramRegex = /<parameter=([^>\s]+)>\s*([\s\S]*?)\s*<\/parameter>/gi;
+    let foundAnyParam = false;
+    for (const param of argsBody.matchAll(paramRegex)) {
+        const key = param[1]?.trim();
+        if (!key)
+            continue;
+        foundAnyParam = true;
+        const rawValue = (param[2] ?? "").trim();
+        args[key] = coerceValue(rawValue);
+    }
+    if (!foundAnyParam && argsBody.trim().length > 0) {
+        // Block has content but no valid <parameter=...> tags
+        return { ok: false, error: "Qwen tool_call block contained malformed <parameter=...>" };
+    }
+    const call = {
+        id: generateCallId(undefined, index + 1),
+        name: fnName,
+        arguments: args,
+        rawSource: `<function=${fnName}>${argsBody}</function>`,
+        parserId: PARSER_ID,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+    return { ok: true, call };
+}
+// ─── Factory ──────────────────────────────────────────────
+export function createQwen3XmlParser() {
+    return qwen3XmlParser;
+}
+//# sourceMappingURL=qwen3-xml.js.map

package/dist/hamr/providers/parsers/qwen3-xml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen3-xml.js","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/qwen3-xml.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Qwen3 XML tool-call parser.\n *\n * Parses Qwen3-Coder / Qwen3 XML-format tool calls:\n *\n *   <tool_call>\n *   <function=get_weather>\n *   <parameter=location>San Francisco</parameter>\n *   <parameter=unit>celsius</parameter>\n *   </function>\n *   </tool_call>\n *\n * Reference: vLLM docs/features/tool_calling.md → \"Qwen3-Coder Models\"\n *   Supported via --tool-call-parser qwen3_xml\n */\n\nimport type { ParsedToolCall, ToolCallParseResult, ToolCallParser } from \"./types.ts\";\nimport { coerceValue, extractDelimitedBlocks, generateCallId, sanitizeReasoningTags } from \"./utils.ts\";\n\nconst PARSER_ID = \"qwen3_xml\";\nconst DESCRIPTION =\n\t\"Qwen3-Coder / Qwen3 XML format: <tool_call><function=name><parameter=key>value</parameter></function></tool_call>\";\nconst FAMILIES = [\"Qwen3\", \"Qwen3-Coder\", \"Qwen3.5\", \"Qwen3.6\"];\n\nexport const qwen3XmlParser: ToolCallParser = {\n\tid: PARSER_ID,\n\tdescription: DESCRIPTION,\n\tmodelFamilies: FAMILIES,\n\n\tparse(content: string): ToolCallParseResult {\n\t\tconst sanitized = sanitizeReasoningTags(content);\n\t\tconst delimited = extractDelimitedBlocks(sanitized, \"<tool_call>\", \"</tool_call>\");\n\n\t\tif (delimited.blocks.length === 0) {\n\t\t\treturn {\n\t\t\t\tok: true,\n\t\t\t\tparserId: PARSER_ID,\n\t\t\t\tcalls: [],\n\t\t\t\tcontent: sanitized,\n\t\t\t};\n\t\t}\n\n\t\tconst calls: ParsedToolCall[] = [];\n\t\tconst warnings: string[] = [];\n\n\t\tfor (let i = 0; i < delimited.blocks.length; i++) {\n\t\t\tconst block = delimited.blocks[i];\n\t\t\tconst parsed = parseQwenFunctionBlock(block, i);\n\n\t\t\tif (!parsed.ok) {\n\t\t\t\t// Unrecoverable parse error in a tool-call block\n\t\t\t\treturn {\n\t\t\t\t\tok: false,\n\t\t\t\t\tparserId: PARSER_ID,\n\t\t\t\t\tcalls: [],\n\t\t\t\t\tcontent: sanitized,\n\t\t\t\t\terror: parsed.error,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tif (parsed.call) {\n\t\t\t\tif (parsed.warnings) warnings.push(...parsed.warnings);\n\t\t\t\tcalls.push(parsed.call);\n\t\t\t}\n\t\t}\n\n\t\t// Extract non-tool text from between blocks\n\t\tconst nonToolContent = [delimited.before, ...delimited.between, delimited.after].filter(Boolean).join(\"\\n\").trim();\n\n\t\treturn {\n\t\t\tok: true,\n\t\t\tparserId: PARSER_ID,\n\t\t\tcalls,\n\t\t\tcontent: nonToolContent,\n\t\t\twarnings: warnings.length > 0 ? warnings : undefined,\n\t\t};\n\t},\n};\n\n// ─── Block parser ─────────────────────────────────────────\n\nfunction parseQwenFunctionBlock(\n\tblock: string,\n\tindex: number,\n): { ok: true; call?: ParsedToolCall; warnings?: string[] } | { ok: false; error: string } {\n\tconst trimmed = block.trim();\n\n\t// Find <function=NAME>...</function>\n\tconst fnMatch = trimmed.match(/<function=([^>\\s]+)>\\s*([\\s\\S]*?)\\s*<\\/function>/i);\n\tif (!fnMatch?.[1]) {\n\t\treturn { ok: false, error: \"Qwen tool_call block missing <function=...> wrapper\" };\n\t}\n\n\tconst fnName = fnMatch[1].trim();\n\tconst argsBody = fnMatch[2] ?? \"\";\n\tconst args: Record<string, unknown> = {};\n\tconst warnings: string[] = [];\n\tconst paramRegex = /<parameter=([^>\\s]+)>\\s*([\\s\\S]*?)\\s*<\\/parameter>/gi;\n\tlet foundAnyParam = false;\n\n\tfor (const param of argsBody.matchAll(paramRegex)) {\n\t\tconst key = param[1]?.trim();\n\t\tif (!key) continue;\n\t\tfoundAnyParam = true;\n\n\t\tconst rawValue = (param[2] ?? \"\").trim();\n\t\targs[key] = coerceValue(rawValue);\n\t}\n\n\tif (!foundAnyParam && argsBody.trim().length > 0) {\n\t\t// Block has content but no valid <parameter=...> tags\n\t\treturn { ok: false, error: \"Qwen tool_call block contained malformed <parameter=...>\" };\n\t}\n\n\tconst call: ParsedToolCall = {\n\t\tid: generateCallId(undefined, index + 1),\n\t\tname: fnName,\n\t\targuments: args,\n\t\trawSource: `<function=${fnName}>${argsBody}</function>`,\n\t\tparserId: PARSER_ID,\n\t\twarnings: warnings.length > 0 ? warnings : undefined,\n\t};\n\n\treturn { ok: true, call };\n}\n\n// ─── Factory ──────────────────────────────────────────────\n\nexport function createQwen3XmlParser(): ToolCallParser {\n\treturn qwen3XmlParser;\n}\n"]}

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

@@ -0,0 +1,13 @@
+/**
+ * Tool-call parser registry.
+ *
+ * Maps parser IDs to parser implementations. Supports registration,
+ * lookup, listing, and parse dispatch. Designed to mirror vLLM's
+ * ToolParserManager but for Hamr's TypeScript runtime.
+ *
+ * Reference: vLLM docs/features/tool_calling.md and
+ *   vllm/entrypoints/openai/tool_parsers/ directory.
+ */
+import type { ToolCallParserRegistry } from "./types.ts";
+export declare const toolCallParserRegistry: ToolCallParserRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAA8D,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAOrH,eAAO,MAAM,sBAAsB,EAAE,sBAuCpC,CAAC"}

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

@@ -0,0 +1,51 @@
+/**
+ * Tool-call parser registry.
+ *
+ * Maps parser IDs to parser implementations. Supports registration,
+ * lookup, listing, and parse dispatch. Designed to mirror vLLM's
+ * ToolParserManager but for Hamr's TypeScript runtime.
+ *
+ * Reference: vLLM docs/features/tool_calling.md and
+ *   vllm/entrypoints/openai/tool_parsers/ directory.
+ */
+import { sanitizeReasoningTags } from "./utils.js";
+// ─── Singleton registry ───────────────────────────────────
+const parsers = new Map();
+export const toolCallParserRegistry = {
+    register(id, factory) {
+        const normalized = id.trim().toLowerCase();
+        if (!normalized)
+            throw new Error("parser id must not be empty");
+        parsers.set(normalized, factory);
+    },
+    get(id) {
+        const factory = parsers.get(id.trim().toLowerCase());
+        return factory?.();
+    },
+    listIds() {
+        return Array.from(parsers.keys()).sort();
+    },
+    listParsers() {
+        return Array.from(parsers.entries())
+            .map(([id, factory]) => {
+            const parser = factory();
+            return { id, description: parser.description, modelFamilies: parser.modelFamilies };
+        })
+            .sort((a, b) => a.id.localeCompare(b.id));
+    },
+    parse(id, content) {
+        const parser = this.get(id);
+        if (!parser) {
+            return {
+                ok: false,
+                parserId: id,
+                calls: [],
+                content,
+                error: `unknown parser: "${id}". Available: ${this.listIds().join(", ")}`,
+            };
+        }
+        const sanitized = sanitizeReasoningTags(content);
+        return parser.parse(sanitized);
+    },
+};
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,6DAA6D;AAE7D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiC,CAAC;AAEzD,MAAM,CAAC,MAAM,sBAAsB,GAA2B;IAC7D,QAAQ,CAAC,EAAU,EAAE,OAA8B;QAClD,MAAM,UAAU,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,EAAU;QACb,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QACrD,OAAO,OAAO,EAAE,EAAE,CAAC;IACpB,CAAC;IAED,OAAO;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,WAAW;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;aAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE;YACtB,MAAM,MAAM,GAAG,OAAO,EAAE,CAAC;YACzB,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;QACrF,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,EAAU,EAAE,OAAe;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,OAAO;gBACN,EAAE,EAAE,KAAK;gBACT,QAAQ,EAAE,EAAE;gBACZ,KAAK,EAAE,EAAE;gBACT,OAAO;gBACP,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACzE,CAAC;QACH,CAAC;QACD,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACjD,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;CACD,CAAC","sourcesContent":["/**\n * Tool-call parser registry.\n *\n * Maps parser IDs to parser implementations. Supports registration,\n * lookup, listing, and parse dispatch. Designed to mirror vLLM's\n * ToolParserManager but for Hamr's TypeScript runtime.\n *\n * Reference: vLLM docs/features/tool_calling.md and\n *   vllm/entrypoints/openai/tool_parsers/ directory.\n */\n\nimport type { ToolCallParseResult, ToolCallParser, ToolCallParserFactory, ToolCallParserRegistry } from \"./types.ts\";\nimport { sanitizeReasoningTags } from \"./utils.ts\";\n\n// ─── Singleton registry ───────────────────────────────────\n\nconst parsers = new Map<string, ToolCallParserFactory>();\n\nexport const toolCallParserRegistry: ToolCallParserRegistry = {\n\tregister(id: string, factory: ToolCallParserFactory): void {\n\t\tconst normalized = id.trim().toLowerCase();\n\t\tif (!normalized) throw new Error(\"parser id must not be empty\");\n\t\tparsers.set(normalized, factory);\n\t},\n\n\tget(id: string): ToolCallParser | undefined {\n\t\tconst factory = parsers.get(id.trim().toLowerCase());\n\t\treturn factory?.();\n\t},\n\n\tlistIds(): string[] {\n\t\treturn Array.from(parsers.keys()).sort();\n\t},\n\n\tlistParsers(): Array<{ id: string; description: string; modelFamilies: string[] }> {\n\t\treturn Array.from(parsers.entries())\n\t\t\t.map(([id, factory]) => {\n\t\t\t\tconst parser = factory();\n\t\t\t\treturn { id, description: parser.description, modelFamilies: parser.modelFamilies };\n\t\t\t})\n\t\t\t.sort((a, b) => a.id.localeCompare(b.id));\n\t},\n\n\tparse(id: string, content: string): ToolCallParseResult {\n\t\tconst parser = this.get(id);\n\t\tif (!parser) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\tparserId: id,\n\t\t\t\tcalls: [],\n\t\t\t\tcontent,\n\t\t\t\terror: `unknown parser: \"${id}\". Available: ${this.listIds().join(\", \")}`,\n\t\t\t};\n\t\t}\n\t\tconst sanitized = sanitizeReasoningTags(content);\n\t\treturn parser.parse(sanitized);\n\t},\n};\n"]}

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

@@ -0,0 +1,83 @@
+/**
+ * Canonical types for Hamr tool-call parsers.
+ *
+ * Parsers convert model text output into normalized ParsedToolCall records.
+ * Inspired by vLLM's tool-call-parser architecture but implemented natively
+ * so Hamr does not depend on vLLM runtime normalization.
+ */
+export interface ParsedToolCall {
+    /** Stable call id, either from model output or deterministically generated. */
+    id: string;
+    /** Function/tool name. */
+    name: string;
+    /** Parsed arguments object. */
+    arguments: Record<string, unknown>;
+    /** Raw source text span (the exact substring that was parsed). */
+    rawSource?: string;
+    /** Parser id that produced this call. */
+    parserId?: string;
+    /** Recoverable parse warnings. */
+    warnings?: string[];
+}
+export interface ToolCallParseResult {
+    /** Whether parsing itself succeeded (even if no calls were found). */
+    ok: boolean;
+    /** Parser id used. */
+    parserId: string;
+    /** Parsed calls. This is empty when no calls were detected — that is not an error. */
+    calls: ParsedToolCall[];
+    /** Non-call content that should remain in the assistant message. */
+    content: string;
+    /** Errors when ok=false. */
+    error?: string;
+    /** Recoverable warnings (call-level warnings are on each ParsedToolCall). */
+    warnings?: string[];
+}
+/**
+ * A tool-call parser converts raw model text into normalized tool call records.
+ *
+ * Parsers are stateless single-invocation functions. Streaming buffering
+ * is handled by the caller (the provider client), which feeds complete
+ * model output to the parser after the stream ends.
+ */
+export interface ToolCallParser {
+    /** Unique parser id, matching vLLM's --tool-call-parser names where practical. */
+    readonly id: string;
+    /** Human-readable description for config docs. */
+    readonly description: string;
+    /** Model families this parser is designed for (for docs and auto-detection). */
+    readonly modelFamilies: string[];
+    /** Parse a complete model response text into canonical calls. */
+    parse(content: string): ToolCallParseResult;
+}
+/**
+ * Factory function that creates a parser instance.
+ * Matching vLLM's approach, parsers receive a tokenizer only when needed
+ * (primarily for parsers that need to decode token IDs). For Hamr's
+ * text-based parsing, most parsers use the default no-op factory.
+ */
+export type ToolCallParserFactory = () => ToolCallParser;
+export interface ToolCallParserRegistry {
+    /** Register a parser factory under a given id. */
+    register(id: string, factory: ToolCallParserFactory): void;
+    /** Get a parser by id. Returns undefined if not registered. */
+    get(id: string): ToolCallParser | undefined;
+    /** List all registered parser ids. */
+    listIds(): string[];
+    /** List all registered parsers with their descriptions. */
+    listParsers(): Array<{
+        id: string;
+        description: string;
+        modelFamilies: string[];
+    }>;
+    /** Parse content using the parser registered under `id`. */
+    parse(id: string, content: string): ToolCallParseResult;
+}
+/**
+ * Conservative auto-detection. Inspects the model id string for substrings
+ * matching known model families. Returns undefined when uncertain.
+ *
+ * Config override always takes priority over auto-detection.
+ */
+export declare function detectParserId(modelId: string): string | undefined;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,cAAc;IAC9B,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAID,MAAM,WAAW,mBAAmB;IACnC,sEAAsE;IACtE,EAAE,EAAE,OAAO,CAAC;IACZ,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAID;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACjC,iEAAiE;IACjE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAAC;CAC5C;AAID;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,cAAc,CAAC;AAIzD,MAAM,WAAW,sBAAsB;IACtC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3D,+DAA+D;IAC/D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAC5C,sCAAsC;IACtC,OAAO,IAAI,MAAM,EAAE,CAAC;IACpB,2DAA2D;IAC3D,WAAW,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACnF,4DAA4D;IAC5D,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAAC;CACxD;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiGlE"}

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

@@ -0,0 +1,93 @@
+/**
+ * Canonical types for Hamr tool-call parsers.
+ *
+ * Parsers convert model text output into normalized ParsedToolCall records.
+ * Inspired by vLLM's tool-call-parser architecture but implemented natively
+ * so Hamr does not depend on vLLM runtime normalization.
+ */
+// ─── Auto-detection ───────────────────────────────────────
+/**
+ * Conservative auto-detection. Inspects the model id string for substrings
+ * matching known model families. Returns undefined when uncertain.
+ *
+ * Config override always takes priority over auto-detection.
+ */
+export function detectParserId(modelId) {
+    const lower = modelId.toLowerCase();
+    // Order matters: more specific patterns first.
+    const patterns = [
+        // XML/tag-based families
+        { pattern: /\bqwen3[-.]?coder\b/i, parser: "qwen3_xml" },
+        { pattern: /\bqwen3\.6\b/i, parser: "qwen3_xml" },
+        { pattern: /\bqwen3\.5\b/i, parser: "qwen3_xml" },
+        { pattern: /\bqwen3\b/i, parser: "qwen3_xml" },
+        { pattern: /\bqwen2\.5\b/i, parser: "hermes" }, // Qwen2.5 uses Hermes-style
+        // No broad /\bqwen\b/i catch-all — Qwen3.X / Qwen3-Coder / Qwen3 are matched above.
+        // Hermes family
+        { pattern: /\bhermes\b/i, parser: "hermes" },
+        { pattern: /\bnous\b/i, parser: "hermes" },
+        { pattern: /openhermes/i, parser: "hermes" },
+        // Llama 3/4 JSON
+        { pattern: /\bllama-?4\b/i, parser: "llama4_pythonic" },
+        { pattern: /\bllama-?3\.?[23]\b/i, parser: "llama3_json" },
+        { pattern: /\bllama-?3\b/i, parser: "llama3_json" },
+        { pattern: /meta-llama/i, parser: "llama3_json" },
+        // DeepSeek
+        { pattern: /deepseek-?v3\.1/i, parser: "deepseek_v31" },
+        { pattern: /deepseek-?v3/i, parser: "deepseek_v3" },
+        { pattern: /deepseek-?r1/i, parser: "deepseek_v3" },
+        { pattern: /deepseek/i, parser: "deepseek_v3" },
+        // Mistral
+        { pattern: /\bmistral\b/i, parser: "mistral" },
+        { pattern: /mixtral/i, parser: "mistral" },
+        // xLAM
+        { pattern: /\bxlam\b/i, parser: "xlam" },
+        // Granite
+        { pattern: /\bgranite-?4\b/i, parser: "granite4" },
+        { pattern: /\bgranite-?20b-fc\b/i, parser: "granite-20b-fc" },
+        { pattern: /\bgranite\b/i, parser: "granite" },
+        // InternLM
+        { pattern: /\binternlm/i, parser: "internlm" },
+        // FunctionGemma / Gemma
+        { pattern: /\bfunctiongemma\b/i, parser: "functiongemma" },
+        { pattern: /\bgemma-?2.*function/i, parser: "functiongemma" },
+        // Gemma 3/4 (including QAT/quantized variants). These models use the
+        // OpenAI native tool_calls convention (role: 'tool', tool_call_id)
+        // rather than XML-wrapped <tool_response> user messages.
+        { pattern: /\bgemma-?[34]/i, parser: "gemma_native" },
+        { pattern: /\bgemma\b/i, parser: "gemma_native" },
+        // OLMo3
+        { pattern: /\bolmo[e3]/i, parser: "olmo3" },
+        // GLM family
+        { pattern: /\bglm-?4\.7\b/i, parser: "glm47" },
+        { pattern: /\bglm-?4\.5\b/i, parser: "glm45" },
+        { pattern: /\bglm-?4\b/i, parser: "glm45" },
+        { pattern: /\bglm\b/i, parser: "glm45" },
+        // Step family
+        { pattern: /\bstep-?3\.5\b/i, parser: "step3p5" },
+        { pattern: /\bstep-?3\b/i, parser: "step3" },
+        // No broad /\bstep\b/i catch-all — "step" is a common word in unrelated model names.
+        // Kimi
+        { pattern: /\bkimi[-_]?k2\b/i, parser: "kimi_k2" },
+        { pattern: /\bkimi\b/i, parser: "kimi_k2" },
+        // Hunyuan
+        { pattern: /\bhunyuan[-_]?a13b\b/i, parser: "hunyuan_a13b" },
+        { pattern: /\bhunyuan\b/i, parser: "hunyuan_a13b" },
+        // LongCat
+        { pattern: /\blongcat\b/i, parser: "longcat" },
+        // Jamba
+        { pattern: /\bjamba\b/i, parser: "jamba" },
+        // MiniMax
+        { pattern: /\bminimax\b/i, parser: "minimax" },
+        // GigaChat
+        { pattern: /\bgigachat\b/i, parser: "gigachat3" },
+        // Pythonic (Llama 4, etc.)
+        { pattern: /\bllama-?4\b/i, parser: "llama4_pythonic" },
+    ];
+    for (const { pattern, parser } of patterns) {
+        if (pattern.test(lower))
+            return parser;
+    }
+    return undefined;
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/types.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Canonical types for Hamr tool-call parsers.\n *\n * Parsers convert model text output into normalized ParsedToolCall records.\n * Inspired by vLLM's tool-call-parser architecture but implemented natively\n * so Hamr does not depend on vLLM runtime normalization.\n */\n\n// ─── Canonical tool call ──────────────────────────────────\n\nexport interface ParsedToolCall {\n\t/** Stable call id, either from model output or deterministically generated. */\n\tid: string;\n\t/** Function/tool name. */\n\tname: string;\n\t/** Parsed arguments object. */\n\targuments: Record<string, unknown>;\n\t/** Raw source text span (the exact substring that was parsed). */\n\trawSource?: string;\n\t/** Parser id that produced this call. */\n\tparserId?: string;\n\t/** Recoverable parse warnings. */\n\twarnings?: string[];\n}\n\n// ─── Parser result ────────────────────────────────────────\n\nexport interface ToolCallParseResult {\n\t/** Whether parsing itself succeeded (even if no calls were found). */\n\tok: boolean;\n\t/** Parser id used. */\n\tparserId: string;\n\t/** Parsed calls. This is empty when no calls were detected — that is not an error. */\n\tcalls: ParsedToolCall[];\n\t/** Non-call content that should remain in the assistant message. */\n\tcontent: string;\n\t/** Errors when ok=false. */\n\terror?: string;\n\t/** Recoverable warnings (call-level warnings are on each ParsedToolCall). */\n\twarnings?: string[];\n}\n\n// ─── Parser interface ─────────────────────────────────────\n\n/**\n * A tool-call parser converts raw model text into normalized tool call records.\n *\n * Parsers are stateless single-invocation functions. Streaming buffering\n * is handled by the caller (the provider client), which feeds complete\n * model output to the parser after the stream ends.\n */\nexport interface ToolCallParser {\n\t/** Unique parser id, matching vLLM's --tool-call-parser names where practical. */\n\treadonly id: string;\n\t/** Human-readable description for config docs. */\n\treadonly description: string;\n\t/** Model families this parser is designed for (for docs and auto-detection). */\n\treadonly modelFamilies: string[];\n\t/** Parse a complete model response text into canonical calls. */\n\tparse(content: string): ToolCallParseResult;\n}\n\n// ─── Parser factory ───────────────────────────────────────\n\n/**\n * Factory function that creates a parser instance.\n * Matching vLLM's approach, parsers receive a tokenizer only when needed\n * (primarily for parsers that need to decode token IDs). For Hamr's\n * text-based parsing, most parsers use the default no-op factory.\n */\nexport type ToolCallParserFactory = () => ToolCallParser;\n\n// ─── Registry ─────────────────────────────────────────────\n\nexport interface ToolCallParserRegistry {\n\t/** Register a parser factory under a given id. */\n\tregister(id: string, factory: ToolCallParserFactory): void;\n\t/** Get a parser by id. Returns undefined if not registered. */\n\tget(id: string): ToolCallParser | undefined;\n\t/** List all registered parser ids. */\n\tlistIds(): string[];\n\t/** List all registered parsers with their descriptions. */\n\tlistParsers(): Array<{ id: string; description: string; modelFamilies: string[] }>;\n\t/** Parse content using the parser registered under `id`. */\n\tparse(id: string, content: string): ToolCallParseResult;\n}\n\n// ─── Auto-detection ───────────────────────────────────────\n\n/**\n * Conservative auto-detection. Inspects the model id string for substrings\n * matching known model families. Returns undefined when uncertain.\n *\n * Config override always takes priority over auto-detection.\n */\nexport function detectParserId(modelId: string): string | undefined {\n\tconst lower = modelId.toLowerCase();\n\n\t// Order matters: more specific patterns first.\n\tconst patterns: Array<{ pattern: RegExp; parser: string }> = [\n\t\t// XML/tag-based families\n\t\t{ pattern: /\\bqwen3[-.]?coder\\b/i, parser: \"qwen3_xml\" },\n\t\t{ pattern: /\\bqwen3\\.6\\b/i, parser: \"qwen3_xml\" },\n\t\t{ pattern: /\\bqwen3\\.5\\b/i, parser: \"qwen3_xml\" },\n\t\t{ pattern: /\\bqwen3\\b/i, parser: \"qwen3_xml\" },\n\t\t{ pattern: /\\bqwen2\\.5\\b/i, parser: \"hermes\" }, // Qwen2.5 uses Hermes-style\n\t\t// No broad /\\bqwen\\b/i catch-all — Qwen3.X / Qwen3-Coder / Qwen3 are matched above.\n\n\t\t// Hermes family\n\t\t{ pattern: /\\bhermes\\b/i, parser: \"hermes\" },\n\t\t{ pattern: /\\bnous\\b/i, parser: \"hermes\" },\n\t\t{ pattern: /openhermes/i, parser: \"hermes\" },\n\n\t\t// Llama 3/4 JSON\n\t\t{ pattern: /\\bllama-?4\\b/i, parser: \"llama4_pythonic\" },\n\t\t{ pattern: /\\bllama-?3\\.?[23]\\b/i, parser: \"llama3_json\" },\n\t\t{ pattern: /\\bllama-?3\\b/i, parser: \"llama3_json\" },\n\t\t{ pattern: /meta-llama/i, parser: \"llama3_json\" },\n\n\t\t// DeepSeek\n\t\t{ pattern: /deepseek-?v3\\.1/i, parser: \"deepseek_v31\" },\n\t\t{ pattern: /deepseek-?v3/i, parser: \"deepseek_v3\" },\n\t\t{ pattern: /deepseek-?r1/i, parser: \"deepseek_v3\" },\n\t\t{ pattern: /deepseek/i, parser: \"deepseek_v3\" },\n\n\t\t// Mistral\n\t\t{ pattern: /\\bmistral\\b/i, parser: \"mistral\" },\n\t\t{ pattern: /mixtral/i, parser: \"mistral\" },\n\n\t\t// xLAM\n\t\t{ pattern: /\\bxlam\\b/i, parser: \"xlam\" },\n\n\t\t// Granite\n\t\t{ pattern: /\\bgranite-?4\\b/i, parser: \"granite4\" },\n\t\t{ pattern: /\\bgranite-?20b-fc\\b/i, parser: \"granite-20b-fc\" },\n\t\t{ pattern: /\\bgranite\\b/i, parser: \"granite\" },\n\n\t\t// InternLM\n\t\t{ pattern: /\\binternlm/i, parser: \"internlm\" },\n\n\t\t// FunctionGemma / Gemma\n\t\t{ pattern: /\\bfunctiongemma\\b/i, parser: \"functiongemma\" },\n\t\t{ pattern: /\\bgemma-?2.*function/i, parser: \"functiongemma\" },\n\t\t// Gemma 3/4 (including QAT/quantized variants). These models use the\n\t\t// OpenAI native tool_calls convention (role: 'tool', tool_call_id)\n\t\t// rather than XML-wrapped <tool_response> user messages.\n\t\t{ pattern: /\\bgemma-?[34]/i, parser: \"gemma_native\" },\n\t\t{ pattern: /\\bgemma\\b/i, parser: \"gemma_native\" },\n\n\t\t// OLMo3\n\t\t{ pattern: /\\bolmo[e3]/i, parser: \"olmo3\" },\n\n\t\t// GLM family\n\t\t{ pattern: /\\bglm-?4\\.7\\b/i, parser: \"glm47\" },\n\t\t{ pattern: /\\bglm-?4\\.5\\b/i, parser: \"glm45\" },\n\t\t{ pattern: /\\bglm-?4\\b/i, parser: \"glm45\" },\n\t\t{ pattern: /\\bglm\\b/i, parser: \"glm45\" },\n\n\t\t// Step family\n\t\t{ pattern: /\\bstep-?3\\.5\\b/i, parser: \"step3p5\" },\n\t\t{ pattern: /\\bstep-?3\\b/i, parser: \"step3\" },\n\t\t// No broad /\\bstep\\b/i catch-all — \"step\" is a common word in unrelated model names.\n\n\t\t// Kimi\n\t\t{ pattern: /\\bkimi[-_]?k2\\b/i, parser: \"kimi_k2\" },\n\t\t{ pattern: /\\bkimi\\b/i, parser: \"kimi_k2\" },\n\n\t\t// Hunyuan\n\t\t{ pattern: /\\bhunyuan[-_]?a13b\\b/i, parser: \"hunyuan_a13b\" },\n\t\t{ pattern: /\\bhunyuan\\b/i, parser: \"hunyuan_a13b\" },\n\n\t\t// LongCat\n\t\t{ pattern: /\\blongcat\\b/i, parser: \"longcat\" },\n\n\t\t// Jamba\n\t\t{ pattern: /\\bjamba\\b/i, parser: \"jamba\" },\n\n\t\t// MiniMax\n\t\t{ pattern: /\\bminimax\\b/i, parser: \"minimax\" },\n\n\t\t// GigaChat\n\t\t{ pattern: /\\bgigachat\\b/i, parser: \"gigachat3\" },\n\n\t\t// Pythonic (Llama 4, etc.)\n\t\t{ pattern: /\\bllama-?4\\b/i, parser: \"llama4_pythonic\" },\n\t];\n\n\tfor (const { pattern, parser } of patterns) {\n\t\tif (pattern.test(lower)) return parser;\n\t}\n\n\treturn undefined;\n}\n"]}

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

@@ -0,0 +1,106 @@
+/**
+ * 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.
+ */
+import type { ParsedToolCall } from "./types.ts";
+/**
+ * Strip <think>/<thinking> reasoning tags from model output.
+ * These tags are model-internal and should not affect tool-call parsing.
+ */
+export declare function sanitizeReasoningTags(content: string): string;
+/**
+ * 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 declare function fastJsonParse(raw: string): {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * 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 declare function safeJsonParse(raw: string): {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Generate a deterministic-ish call id.
+ * Uses the model-provided id if available, otherwise `call_N`.
+ */
+export declare function generateCallId(provided?: string, index?: number): string;
+/** Reset the call id counter (useful for tests). */
+export declare function resetCallIdCounter(): void;
+/**
+ * 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 declare function coerceValue(raw: string): unknown;
+export declare function makeCall(name: string, args: Record<string, unknown>, opts?: {
+    id?: string;
+    index?: number;
+    rawSource?: string;
+    parserId?: string;
+    warnings?: string[];
+}): ParsedToolCall;
+/**
+ * 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 declare function parsePythonicArgs(argsStr: string): Record<string, unknown>;
+/**
+ * Split content into segments separated by tool-call blocks.
+ * Returns { before, blocks, between } where:
+ * - before is text before the first block
+ * - blocks is an array of matched tool-call text
+ * - between is text after the last block
+ */
+export interface DelimitedResult {
+    before: string;
+    blocks: string[];
+    between: string[];
+    after: string;
+}
+export declare function extractDelimitedBlocks(content: string, openTag: string, closeTag: string): DelimitedResult;
+/**
+ * Extract all content that is NOT inside tool-call delimiters.
+ * Used to separate tool calls from prose for transcript rendering.
+ */
+export declare function extractNonToolContent(content: string, openTag: string, closeTag: string): string;
+/**
+ * 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 declare function findPattern(content: string, regex: RegExp): {
+    match: RegExpMatchArray;
+    before: string;
+    after: string;
+} | null;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAID;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAQtG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA0CtG;AA+ED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAUxE;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAID;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAiChD;AAID,wBAAgB,QAAQ,CACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GACpG,cAAc,CAUhB;AAID;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuC1E;AAoHD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAiD1G;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWhG;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQnE"}