@skaft/hamr 0.4.1

package/dist/hamr/providers/parsers/llama3-json.js

@@ -0,0 +1,157 @@
+/**
+ * Llama 3 JSON tool-call parser.
+ *
+ * Parses Llama 3.x JSON-format tool calls:
+ *
+ *   <|python_tag|>{"name": "get_weather", "parameters": {"location": "SF", "unit": "celsius"}}
+ *
+ * The model outputs a `<|python_tag|>` prefix followed by a JSON object
+ * with "name" and "parameters" fields. Multiple calls can appear as
+ * separate `<|python_tag|>` blocks.
+ *
+ * vLLM also supports a custom chat template that wraps calls in a
+ * `<|start_header_id|>assistant<|end_header_id|>` structure, but
+ * the parser handles the raw `<|python_tag|>` blocks directly.
+ *
+ * Reference: vLLM docs/features/tool_calling.md
+ *   --tool-call-parser llama3_json
+ *   --chat-template examples/tool_chat_template_llama3.1_json.jinja
+ *   vllm/entrypoints/openai/tool_parsers/llama_tool_parser.py
+ */
+import { generateCallId, safeJsonParse, sanitizeReasoningTags } from "./utils.js";
+const PARSER_ID = "llama3_json";
+const DESCRIPTION = 'Llama 3.x JSON format: <|python_tag|>{"name":"...","parameters":{...}}';
+const FAMILIES = ["Llama 3", "Llama 3.1", "Llama 3.2", "Llama 3.3", "Meta Llama 3"];
+const PYTHON_TAG = "<|python_tag|>";
+export const llama3JsonParser = {
+    id: PARSER_ID,
+    description: DESCRIPTION,
+    modelFamilies: FAMILIES,
+    parse(content) {
+        const sanitized = sanitizeReasoningTags(content);
+        // Strip Llama header/footer tags if present (model output format)
+        const text = sanitized
+            .replace(/<\|start_header_id\|>assistant<\|end_header_id\|>/gi, "")
+            .replace(/<\|eot_id\|>/gi, "")
+            .trim();
+        const calls = [];
+        let remaining = text;
+        const nonToolParts = [];
+        while (remaining.length > 0) {
+            const tagIdx = remaining.indexOf(PYTHON_TAG);
+            if (tagIdx === -1) {
+                nonToolParts.push(remaining);
+                break;
+            }
+            // Text before the tag
+            if (tagIdx > 0) {
+                nonToolParts.push(remaining.slice(0, tagIdx));
+            }
+            remaining = remaining.slice(tagIdx + PYTHON_TAG.length);
+            // Find the JSON object after the tag
+            const jsonStart = remaining.search(/\S/);
+            if (jsonStart === -1)
+                break;
+            remaining = remaining.slice(jsonStart);
+            if (!remaining.startsWith("{")) {
+                // Not JSON — this is prose, treat as non-tool content
+                const nextTag = remaining.indexOf(PYTHON_TAG);
+                if (nextTag === -1) {
+                    nonToolParts.push(remaining);
+                    break;
+                }
+                nonToolParts.push(remaining.slice(0, nextTag));
+                remaining = remaining.slice(nextTag);
+                continue;
+            }
+            // Extract the JSON object (balanced braces)
+            const jsonEnd = findBalancedClose(remaining, "{", "}");
+            if (jsonEnd === -1) {
+                nonToolParts.push(remaining);
+                break;
+            }
+            const jsonStr = remaining.slice(0, jsonEnd + 1);
+            remaining = remaining.slice(jsonEnd + 1);
+            const parsed = safeJsonParse(jsonStr);
+            if (!parsed.ok) {
+                // Malformed JSON — skip and continue
+                nonToolParts.push(`${PYTHON_TAG}${jsonStr}`);
+                continue;
+            }
+            if (typeof parsed.value !== "object" || parsed.value === null) {
+                nonToolParts.push(`${PYTHON_TAG}${jsonStr}`);
+                continue;
+            }
+            const obj = parsed.value;
+            const name = obj.name ?? obj.tool_name ?? obj.function;
+            if (typeof name !== "string" || !name.trim()) {
+                nonToolParts.push(`${PYTHON_TAG}${jsonStr}`);
+                continue;
+            }
+            let args = {};
+            const rawArgs = obj.parameters ?? obj.arguments ?? obj.input ?? obj.args;
+            if (typeof rawArgs === "string") {
+                const parsedArgs = safeJsonParse(rawArgs);
+                if (parsedArgs.ok &&
+                    typeof parsedArgs.value === "object" &&
+                    parsedArgs.value !== null &&
+                    !Array.isArray(parsedArgs.value)) {
+                    args = parsedArgs.value;
+                }
+            }
+            else if (typeof rawArgs === "object" && rawArgs !== null && !Array.isArray(rawArgs)) {
+                args = rawArgs;
+            }
+            calls.push({
+                id: generateCallId((obj.id ?? obj.call_id), calls.length + 1),
+                name: name.trim(),
+                arguments: args,
+                rawSource: jsonStr,
+                parserId: PARSER_ID,
+            });
+        }
+        const nonToolContent = nonToolParts.join("").trim();
+        return {
+            ok: true,
+            parserId: PARSER_ID,
+            calls,
+            content: nonToolContent,
+        };
+    },
+};
+// ─── Helpers ──────────────────────────────────────────────
+function findBalancedClose(text, open, close) {
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    for (let i = 0; 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 === open)
+            depth++;
+        else if (ch === close) {
+            depth--;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+// ─── Factory ──────────────────────────────────────────────
+export function createLlama3JsonParser() {
+    return llama3JsonParser;
+}
+//# sourceMappingURL=llama3-json.js.map

package/dist/hamr/providers/parsers/llama3-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llama3-json.js","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/llama3-json.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Llama 3 JSON tool-call parser.\n *\n * Parses Llama 3.x JSON-format tool calls:\n *\n *   <|python_tag|>{\"name\": \"get_weather\", \"parameters\": {\"location\": \"SF\", \"unit\": \"celsius\"}}\n *\n * The model outputs a `<|python_tag|>` prefix followed by a JSON object\n * with \"name\" and \"parameters\" fields. Multiple calls can appear as\n * separate `<|python_tag|>` blocks.\n *\n * vLLM also supports a custom chat template that wraps calls in a\n * `<|start_header_id|>assistant<|end_header_id|>` structure, but\n * the parser handles the raw `<|python_tag|>` blocks directly.\n *\n * Reference: vLLM docs/features/tool_calling.md\n *   --tool-call-parser llama3_json\n *   --chat-template examples/tool_chat_template_llama3.1_json.jinja\n *   vllm/entrypoints/openai/tool_parsers/llama_tool_parser.py\n */\n\nimport type { ParsedToolCall, ToolCallParseResult, ToolCallParser } from \"./types.ts\";\nimport { generateCallId, safeJsonParse, sanitizeReasoningTags } from \"./utils.ts\";\n\nconst PARSER_ID = \"llama3_json\";\nconst DESCRIPTION = 'Llama 3.x JSON format: <|python_tag|>{\"name\":\"...\",\"parameters\":{...}}';\nconst FAMILIES = [\"Llama 3\", \"Llama 3.1\", \"Llama 3.2\", \"Llama 3.3\", \"Meta Llama 3\"];\n\nconst PYTHON_TAG = \"<|python_tag|>\";\n\nexport const llama3JsonParser: ToolCallParser = {\n\tid: PARSER_ID,\n\tdescription: DESCRIPTION,\n\tmodelFamilies: FAMILIES,\n\n\tparse(content: string): ToolCallParseResult {\n\t\tconst sanitized = sanitizeReasoningTags(content);\n\n\t\t// Strip Llama header/footer tags if present (model output format)\n\t\tconst text = sanitized\n\t\t\t.replace(/<\\|start_header_id\\|>assistant<\\|end_header_id\\|>/gi, \"\")\n\t\t\t.replace(/<\\|eot_id\\|>/gi, \"\")\n\t\t\t.trim();\n\n\t\tconst calls: ParsedToolCall[] = [];\n\t\tlet remaining = text;\n\t\tconst nonToolParts: string[] = [];\n\n\t\twhile (remaining.length > 0) {\n\t\t\tconst tagIdx = remaining.indexOf(PYTHON_TAG);\n\t\t\tif (tagIdx === -1) {\n\t\t\t\tnonToolParts.push(remaining);\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\t// Text before the tag\n\t\t\tif (tagIdx > 0) {\n\t\t\t\tnonToolParts.push(remaining.slice(0, tagIdx));\n\t\t\t}\n\t\t\tremaining = remaining.slice(tagIdx + PYTHON_TAG.length);\n\n\t\t\t// Find the JSON object after the tag\n\t\t\tconst jsonStart = remaining.search(/\\S/);\n\t\t\tif (jsonStart === -1) break;\n\t\t\tremaining = remaining.slice(jsonStart);\n\n\t\t\tif (!remaining.startsWith(\"{\")) {\n\t\t\t\t// Not JSON — this is prose, treat as non-tool content\n\t\t\t\tconst nextTag = remaining.indexOf(PYTHON_TAG);\n\t\t\t\tif (nextTag === -1) {\n\t\t\t\t\tnonToolParts.push(remaining);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tnonToolParts.push(remaining.slice(0, nextTag));\n\t\t\t\tremaining = remaining.slice(nextTag);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Extract the JSON object (balanced braces)\n\t\t\tconst jsonEnd = findBalancedClose(remaining, \"{\", \"}\");\n\t\t\tif (jsonEnd === -1) {\n\t\t\t\tnonToolParts.push(remaining);\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tconst jsonStr = remaining.slice(0, jsonEnd + 1);\n\t\t\tremaining = remaining.slice(jsonEnd + 1);\n\n\t\t\tconst parsed = safeJsonParse(jsonStr);\n\t\t\tif (!parsed.ok) {\n\t\t\t\t// Malformed JSON — skip and continue\n\t\t\t\tnonToolParts.push(`${PYTHON_TAG}${jsonStr}`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (typeof parsed.value !== \"object\" || parsed.value === null) {\n\t\t\t\tnonToolParts.push(`${PYTHON_TAG}${jsonStr}`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst obj = parsed.value as Record<string, unknown>;\n\t\t\tconst name = obj.name ?? obj.tool_name ?? obj.function;\n\t\t\tif (typeof name !== \"string\" || !name.trim()) {\n\t\t\t\tnonToolParts.push(`${PYTHON_TAG}${jsonStr}`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tlet args: Record<string, unknown> = {};\n\t\t\tconst rawArgs = obj.parameters ?? obj.arguments ?? obj.input ?? obj.args;\n\n\t\t\tif (typeof rawArgs === \"string\") {\n\t\t\t\tconst parsedArgs = safeJsonParse(rawArgs);\n\t\t\t\tif (\n\t\t\t\t\tparsedArgs.ok &&\n\t\t\t\t\ttypeof parsedArgs.value === \"object\" &&\n\t\t\t\t\tparsedArgs.value !== null &&\n\t\t\t\t\t!Array.isArray(parsedArgs.value)\n\t\t\t\t) {\n\t\t\t\t\targs = parsedArgs.value as Record<string, unknown>;\n\t\t\t\t}\n\t\t\t} else if (typeof rawArgs === \"object\" && rawArgs !== null && !Array.isArray(rawArgs)) {\n\t\t\t\targs = rawArgs as Record<string, unknown>;\n\t\t\t}\n\n\t\t\tcalls.push({\n\t\t\t\tid: generateCallId((obj.id ?? obj.call_id) as string | undefined, calls.length + 1),\n\t\t\t\tname: name.trim(),\n\t\t\t\targuments: args,\n\t\t\t\trawSource: jsonStr,\n\t\t\t\tparserId: PARSER_ID,\n\t\t\t});\n\t\t}\n\n\t\tconst nonToolContent = nonToolParts.join(\"\").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};\n\t},\n};\n\n// ─── Helpers ──────────────────────────────────────────────\n\nfunction findBalancedClose(text: string, open: string, close: string): number {\n\tlet depth = 0;\n\tlet inString = false;\n\tlet escape = false;\n\n\tfor (let i = 0; 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 === open) depth++;\n\t\telse if (ch === close) {\n\t\t\tdepth--;\n\t\t\tif (depth === 0) return i;\n\t\t}\n\t}\n\treturn -1;\n}\n\n// ─── Factory ──────────────────────────────────────────────\n\nexport function createLlama3JsonParser(): ToolCallParser {\n\treturn llama3JsonParser;\n}\n"]}

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

@@ -0,0 +1,22 @@
+/**
+ * Mistral tool-call parser.
+ *
+ * Parses Mistral-format tool calls:
+ *
+ *   [TOOL_CALLS][{"name": "get_weather", "arguments": {"location": "SF", "unit": "celsius"}}]
+ *
+ * The model outputs a [TOOL_CALLS] prefix followed by a JSON array of
+ * tool call objects. Each object has "name" and "arguments" fields.
+ * Multiple calls can appear in the same JSON array.
+ *
+ * Variants:
+ *   - mistral: standard Mistral format
+ *
+ * Reference: vLLM docs/features/tool_calling.md
+ *   --tool-call-parser mistral
+ *   vllm/entrypoints/openai/tool_parsers/mistral_tool_parser.py
+ */
+import type { ToolCallParser } from "./types.ts";
+export declare const mistralParser: ToolCallParser;
+export declare function createMistralParser(): ToolCallParser;
+//# sourceMappingURL=mistral.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mistral.d.ts","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/mistral.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAuC,cAAc,EAAE,MAAM,YAAY,CAAC;AAStF,eAAO,MAAM,aAAa,EAAE,cAgH3B,CAAC;AAmCF,wBAAgB,mBAAmB,IAAI,cAAc,CAEpD"}

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

@@ -0,0 +1,157 @@
+/**
+ * Mistral tool-call parser.
+ *
+ * Parses Mistral-format tool calls:
+ *
+ *   [TOOL_CALLS][{"name": "get_weather", "arguments": {"location": "SF", "unit": "celsius"}}]
+ *
+ * The model outputs a [TOOL_CALLS] prefix followed by a JSON array of
+ * tool call objects. Each object has "name" and "arguments" fields.
+ * Multiple calls can appear in the same JSON array.
+ *
+ * Variants:
+ *   - mistral: standard Mistral format
+ *
+ * Reference: vLLM docs/features/tool_calling.md
+ *   --tool-call-parser mistral
+ *   vllm/entrypoints/openai/tool_parsers/mistral_tool_parser.py
+ */
+import { generateCallId, safeJsonParse, sanitizeReasoningTags } from "./utils.js";
+const PARSER_ID = "mistral";
+const DESCRIPTION = 'Mistral format: [TOOL_CALLS][{"name":"...","arguments":{...}}, ...]';
+const FAMILIES = ["Mistral", "Mixtral", "Mistral Nemo", "Codestral"];
+const TOOL_CALLS_PREFIX = "[TOOL_CALLS]";
+export const mistralParser = {
+    id: PARSER_ID,
+    description: DESCRIPTION,
+    modelFamilies: FAMILIES,
+    parse(content) {
+        const sanitized = sanitizeReasoningTags(content);
+        const prefixIdx = sanitized.indexOf(TOOL_CALLS_PREFIX);
+        if (prefixIdx === -1) {
+            return {
+                ok: true,
+                parserId: PARSER_ID,
+                calls: [],
+                content: sanitized,
+            };
+        }
+        const before = sanitized.slice(0, prefixIdx).trim();
+        const afterPrefix = sanitized.slice(prefixIdx + TOOL_CALLS_PREFIX.length).trim();
+        if (!afterPrefix.startsWith("[")) {
+            return {
+                ok: false,
+                parserId: PARSER_ID,
+                calls: [],
+                content: sanitized,
+                error: "Mistral: [TOOL_CALLS] not followed by JSON array",
+            };
+        }
+        // Find matching closing bracket
+        const closeIdx = findBalancedClose(afterPrefix, "[", "]");
+        const jsonStr = closeIdx !== -1 ? afterPrefix.slice(0, closeIdx + 1) : afterPrefix;
+        const afterContent = closeIdx !== -1 ? afterPrefix.slice(closeIdx + 1).trim() : "";
+        const parsed = safeJsonParse(jsonStr);
+        if (!parsed.ok) {
+            return {
+                ok: false,
+                parserId: PARSER_ID,
+                calls: [],
+                content: sanitized,
+                error: `Mistral: ${parsed.error}`,
+            };
+        }
+        if (!Array.isArray(parsed.value)) {
+            return {
+                ok: false,
+                parserId: PARSER_ID,
+                calls: [],
+                content: sanitized,
+                error: "Mistral: [TOOL_CALLS] content is not a JSON array",
+            };
+        }
+        const calls = [];
+        const warnings = [];
+        for (let i = 0; i < parsed.value.length; i++) {
+            const item = parsed.value[i];
+            if (typeof item !== "object" || item === null) {
+                warnings.push(`Mistral item ${i}: not a JSON object, skipping`);
+                continue;
+            }
+            const obj = item;
+            const name = obj.name ?? obj.tool_name ?? obj.function;
+            if (typeof name !== "string" || !name.trim()) {
+                warnings.push(`Mistral item ${i}: missing "name", skipping`);
+                continue;
+            }
+            let args = {};
+            const rawArgs = obj.arguments ?? obj.parameters ?? obj.input;
+            if (typeof rawArgs === "string") {
+                const parsedArgs = safeJsonParse(rawArgs);
+                if (parsedArgs.ok &&
+                    typeof parsedArgs.value === "object" &&
+                    parsedArgs.value !== null &&
+                    !Array.isArray(parsedArgs.value)) {
+                    args = parsedArgs.value;
+                }
+                else {
+                    warnings.push(`Mistral item ${i}: arguments string parse failed`);
+                }
+            }
+            else if (typeof rawArgs === "object" && rawArgs !== null && !Array.isArray(rawArgs)) {
+                args = rawArgs;
+            }
+            calls.push({
+                id: generateCallId((obj.id ?? obj.call_id), i + 1),
+                name: name.trim(),
+                arguments: args,
+                rawSource: JSON.stringify(item),
+                parserId: PARSER_ID,
+            });
+        }
+        const nonToolContent = [before, afterContent].filter(Boolean).join("\n");
+        return {
+            ok: true,
+            parserId: PARSER_ID,
+            calls,
+            content: nonToolContent,
+            warnings: warnings.length > 0 ? warnings : undefined,
+        };
+    },
+};
+// ─── Helpers ──────────────────────────────────────────────
+function findBalancedClose(text, open, close) {
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    for (let i = 0; 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 === open)
+            depth++;
+        else if (ch === close) {
+            depth--;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+// ─── Factory ──────────────────────────────────────────────
+export function createMistralParser() {
+    return mistralParser;
+}
+//# sourceMappingURL=mistral.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mistral.js","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/mistral.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Mistral tool-call parser.\n *\n * Parses Mistral-format tool calls:\n *\n *   [TOOL_CALLS][{\"name\": \"get_weather\", \"arguments\": {\"location\": \"SF\", \"unit\": \"celsius\"}}]\n *\n * The model outputs a [TOOL_CALLS] prefix followed by a JSON array of\n * tool call objects. Each object has \"name\" and \"arguments\" fields.\n * Multiple calls can appear in the same JSON array.\n *\n * Variants:\n *   - mistral: standard Mistral format\n *\n * Reference: vLLM docs/features/tool_calling.md\n *   --tool-call-parser mistral\n *   vllm/entrypoints/openai/tool_parsers/mistral_tool_parser.py\n */\n\nimport type { ParsedToolCall, ToolCallParseResult, ToolCallParser } from \"./types.ts\";\nimport { generateCallId, safeJsonParse, sanitizeReasoningTags } from \"./utils.ts\";\n\nconst PARSER_ID = \"mistral\";\nconst DESCRIPTION = 'Mistral format: [TOOL_CALLS][{\"name\":\"...\",\"arguments\":{...}}, ...]';\nconst FAMILIES = [\"Mistral\", \"Mixtral\", \"Mistral Nemo\", \"Codestral\"];\n\nconst TOOL_CALLS_PREFIX = \"[TOOL_CALLS]\";\n\nexport const mistralParser: ToolCallParser = {\n\tid: PARSER_ID,\n\tdescription: DESCRIPTION,\n\tmodelFamilies: FAMILIES,\n\n\tparse(content: string): ToolCallParseResult {\n\t\tconst sanitized = sanitizeReasoningTags(content);\n\n\t\tconst prefixIdx = sanitized.indexOf(TOOL_CALLS_PREFIX);\n\t\tif (prefixIdx === -1) {\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 before = sanitized.slice(0, prefixIdx).trim();\n\t\tconst afterPrefix = sanitized.slice(prefixIdx + TOOL_CALLS_PREFIX.length).trim();\n\n\t\tif (!afterPrefix.startsWith(\"[\")) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\tparserId: PARSER_ID,\n\t\t\t\tcalls: [],\n\t\t\t\tcontent: sanitized,\n\t\t\t\terror: \"Mistral: [TOOL_CALLS] not followed by JSON array\",\n\t\t\t};\n\t\t}\n\n\t\t// Find matching closing bracket\n\t\tconst closeIdx = findBalancedClose(afterPrefix, \"[\", \"]\");\n\t\tconst jsonStr = closeIdx !== -1 ? afterPrefix.slice(0, closeIdx + 1) : afterPrefix;\n\t\tconst afterContent = closeIdx !== -1 ? afterPrefix.slice(closeIdx + 1).trim() : \"\";\n\n\t\tconst parsed = safeJsonParse(jsonStr);\n\t\tif (!parsed.ok) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\tparserId: PARSER_ID,\n\t\t\t\tcalls: [],\n\t\t\t\tcontent: sanitized,\n\t\t\t\terror: `Mistral: ${parsed.error}`,\n\t\t\t};\n\t\t}\n\n\t\tif (!Array.isArray(parsed.value)) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\tparserId: PARSER_ID,\n\t\t\t\tcalls: [],\n\t\t\t\tcontent: sanitized,\n\t\t\t\terror: \"Mistral: [TOOL_CALLS] content is not a JSON array\",\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 < parsed.value.length; i++) {\n\t\t\tconst item = parsed.value[i];\n\t\t\tif (typeof item !== \"object\" || item === null) {\n\t\t\t\twarnings.push(`Mistral item ${i}: not a JSON object, skipping`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst obj = item as Record<string, unknown>;\n\t\t\tconst name = obj.name ?? obj.tool_name ?? obj.function;\n\t\t\tif (typeof name !== \"string\" || !name.trim()) {\n\t\t\t\twarnings.push(`Mistral item ${i}: missing \"name\", skipping`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tlet args: Record<string, unknown> = {};\n\t\t\tconst rawArgs = obj.arguments ?? obj.parameters ?? obj.input;\n\n\t\t\tif (typeof rawArgs === \"string\") {\n\t\t\t\tconst parsedArgs = safeJsonParse(rawArgs);\n\t\t\t\tif (\n\t\t\t\t\tparsedArgs.ok &&\n\t\t\t\t\ttypeof parsedArgs.value === \"object\" &&\n\t\t\t\t\tparsedArgs.value !== null &&\n\t\t\t\t\t!Array.isArray(parsedArgs.value)\n\t\t\t\t) {\n\t\t\t\t\targs = parsedArgs.value as Record<string, unknown>;\n\t\t\t\t} else {\n\t\t\t\t\twarnings.push(`Mistral item ${i}: arguments string parse failed`);\n\t\t\t\t}\n\t\t\t} else if (typeof rawArgs === \"object\" && rawArgs !== null && !Array.isArray(rawArgs)) {\n\t\t\t\targs = rawArgs as Record<string, unknown>;\n\t\t\t}\n\n\t\t\tcalls.push({\n\t\t\t\tid: generateCallId((obj.id ?? obj.call_id) as string | undefined, i + 1),\n\t\t\t\tname: name.trim(),\n\t\t\t\targuments: args,\n\t\t\t\trawSource: JSON.stringify(item),\n\t\t\t\tparserId: PARSER_ID,\n\t\t\t});\n\t\t}\n\n\t\tconst nonToolContent = [before, afterContent].filter(Boolean).join(\"\\n\");\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// ─── Helpers ──────────────────────────────────────────────\n\nfunction findBalancedClose(text: string, open: string, close: string): number {\n\tlet depth = 0;\n\tlet inString = false;\n\tlet escape = false;\n\n\tfor (let i = 0; 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 === open) depth++;\n\t\telse if (ch === close) {\n\t\t\tdepth--;\n\t\t\tif (depth === 0) return i;\n\t\t}\n\t}\n\treturn -1;\n}\n\n// ─── Factory ──────────────────────────────────────────────\n\nexport function createMistralParser(): ToolCallParser {\n\treturn mistralParser;\n}\n"]}

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

@@ -0,0 +1,30 @@
+/**
+ * Pythonic tool-call parser.
+ *
+ * Parses Python-list-format tool calls used by models that generate
+ * Python syntax for function calls:
+ *
+ *   [get_weather(city='San Francisco', metric='celsius'),
+ *    get_weather(city='Seattle', metric='celsius')]
+ *
+ * Also supports bare calls without the list wrapper:
+ *
+ *   get_weather(city='San Francisco', metric='celsius')
+ *
+ * This parser uses a safe tokenizer — it does NOT eval anything.
+ * Supports parallel tool calls (multiple functions in one list).
+ *
+ * Variants:
+ *   - pythonic: general Pythonic list format
+ *   - llama4_pythonic: subset with Llama-4-specific handling
+ *
+ * Reference: vLLM docs/features/tool_calling.md → "Models with Pythonic Tool Calls"
+ *   --tool-call-parser pythonic
+ *   vllm/entrypoints/openai/tool_parsers/pythonic_tool_parser.py
+ */
+import type { ToolCallParser } from "./types.ts";
+export declare const pythonicParser: ToolCallParser;
+export declare const llama4PythonicParser: ToolCallParser;
+export declare function createPythonicParser(): ToolCallParser;
+export declare function createLlama4PythonicParser(): ToolCallParser;
+//# sourceMappingURL=pythonic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pythonic.d.ts","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/pythonic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAuC,cAAc,EAAE,MAAM,YAAY,CAAC;AA2MtF,eAAO,MAAM,cAAc,EAAE,cAgB5B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAoBlC,CAAC;AAIF,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAED,wBAAgB,0BAA0B,IAAI,cAAc,CAE3D"}

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

@@ -0,0 +1,243 @@
+/**
+ * Pythonic tool-call parser.
+ *
+ * Parses Python-list-format tool calls used by models that generate
+ * Python syntax for function calls:
+ *
+ *   [get_weather(city='San Francisco', metric='celsius'),
+ *    get_weather(city='Seattle', metric='celsius')]
+ *
+ * Also supports bare calls without the list wrapper:
+ *
+ *   get_weather(city='San Francisco', metric='celsius')
+ *
+ * This parser uses a safe tokenizer — it does NOT eval anything.
+ * Supports parallel tool calls (multiple functions in one list).
+ *
+ * Variants:
+ *   - pythonic: general Pythonic list format
+ *   - llama4_pythonic: subset with Llama-4-specific handling
+ *
+ * Reference: vLLM docs/features/tool_calling.md → "Models with Pythonic Tool Calls"
+ *   --tool-call-parser pythonic
+ *   vllm/entrypoints/openai/tool_parsers/pythonic_tool_parser.py
+ */
+import { generateCallId, parsePythonicArgs, sanitizeReasoningTags } from "./utils.js";
+// ─── Shared parser logic ──────────────────────────────────
+function tokenize(input) {
+    const tokens = [];
+    let i = 0;
+    while (i < input.length) {
+        const ch = input[i];
+        // Whitespace
+        if (/\s/.test(ch)) {
+            const start = i;
+            while (i < input.length && /\s/.test(input[i]))
+                i++;
+            tokens.push({ type: "whitespace", value: input.slice(start, i), pos: start });
+            continue;
+        }
+        // Brackets/parens
+        if (ch === "(") {
+            tokens.push({ type: "lparen", value: "(", pos: i });
+            i++;
+            continue;
+        }
+        if (ch === ")") {
+            tokens.push({ type: "rparen", value: ")", pos: i });
+            i++;
+            continue;
+        }
+        if (ch === "[") {
+            tokens.push({ type: "lbracket", value: "[", pos: i });
+            i++;
+            continue;
+        }
+        if (ch === "]") {
+            tokens.push({ type: "rbracket", value: "]", pos: i });
+            i++;
+            continue;
+        }
+        if (ch === ",") {
+            tokens.push({ type: "comma", value: ",", pos: i });
+            i++;
+            continue;
+        }
+        // Strings (single or double quoted)
+        if (ch === "'" || ch === '"') {
+            const quote = ch;
+            const start = i;
+            i++;
+            while (i < input.length && input[i] !== quote) {
+                if (input[i] === "\\" && i + 1 < input.length)
+                    i++;
+                i++;
+            }
+            if (i < input.length)
+                i++; // closing quote
+            tokens.push({ type: "text", value: input.slice(start, i), pos: start });
+            continue;
+        }
+        // Names/identifiers
+        if (/[a-zA-Z_]/.test(ch)) {
+            const start = i;
+            while (i < input.length && /[\w.]/.test(input[i]))
+                i++;
+            tokens.push({ type: "name", value: input.slice(start, i), pos: start });
+            continue;
+        }
+        // Anything else as text
+        tokens.push({ type: "text", value: ch, pos: i });
+        i++;
+    }
+    return tokens;
+}
+function parsePythonicCalls(text, parserId) {
+    const tokens = tokenize(text);
+    const calls = [];
+    const nonCallTokens = [];
+    let i = 0;
+    while (i < tokens.length) {
+        // Skip whitespace in non-call context
+        while (i < tokens.length && tokens[i].type === "whitespace") {
+            nonCallTokens.push(tokens[i]);
+            i++;
+        }
+        if (i >= tokens.length)
+            break;
+        // Check for function call pattern: name ( args )
+        if (tokens[i].type === "name" && i + 1 < tokens.length && tokens[i + 1].type === "lparen") {
+            const fnName = tokens[i].value;
+            i += 2; // skip name and '('
+            // Collect args until matching ')'
+            let depth = 1;
+            const argTokens = [];
+            while (i < tokens.length && depth > 0) {
+                const tok = tokens[i];
+                if (tok.type === "lparen")
+                    depth++;
+                else if (tok.type === "rparen") {
+                    depth--;
+                    if (depth === 0) {
+                        i++;
+                        break;
+                    }
+                }
+                argTokens.push(tok);
+                i++;
+            }
+            if (depth === 0) {
+                // Successfully parsed a function call
+                const argsStr = argTokens.map((t) => t.value).join("");
+                const args = parsePythonicArgs(argsStr);
+                calls.push({
+                    id: generateCallId(undefined, calls.length + 1),
+                    name: fnName,
+                    arguments: args,
+                    rawSource: `${fnName}(${argsStr})`,
+                    parserId,
+                });
+                // Check for comma after call
+                while (i < tokens.length && tokens[i].type === "whitespace")
+                    i++;
+                if (i < tokens.length && tokens[i].type === "comma") {
+                    i++; // skip comma
+                }
+                continue;
+            }
+        }
+        // Check for list wrapper: [ call1, call2, ... ]
+        if (tokens[i].type === "lbracket") {
+            const listStart = i;
+            i++; // skip '['
+            let depth = 1;
+            const listTokens = [];
+            while (i < tokens.length && depth > 0) {
+                const tok = tokens[i];
+                if (tok.type === "lbracket")
+                    depth++;
+                else if (tok.type === "rbracket") {
+                    depth--;
+                    if (depth === 0) {
+                        i++;
+                        break;
+                    }
+                }
+                listTokens.push(tok);
+                i++;
+            }
+            if (depth === 0) {
+                // Recursively parse the list contents
+                const listContent = listTokens.map((t) => t.value).join("");
+                const nested = parsePythonicCalls(listContent, parserId);
+                for (const call of nested.calls) {
+                    calls.push(call);
+                }
+                // Check for comma after list
+                while (i < tokens.length && tokens[i].type === "whitespace")
+                    i++;
+                if (i < tokens.length && tokens[i].type === "comma") {
+                    i++;
+                }
+                continue;
+            }
+            // Unclosed bracket — push remaining as non-call
+            nonCallTokens.push(tokens[listStart]);
+            for (let j = listStart + 1; j < i; j++) {
+                nonCallTokens.push(tokens[j]);
+            }
+            continue;
+        }
+        // Not a function call — accumulate as non-call text
+        nonCallTokens.push(tokens[i]);
+        i++;
+    }
+    const remainder = nonCallTokens
+        .map((t) => t.value)
+        .join("")
+        .trim();
+    return { calls, remainder };
+}
+// ─── Parser instances ─────────────────────────────────────
+const PYTHONIC_DESCRIPTION = 'Pythonic list format: [func_name(key="value", ...), ...]';
+const PYTHONIC_FAMILIES = ["Llama 4", "Pythonic-capable models"];
+export const pythonicParser = {
+    id: "pythonic",
+    description: PYTHONIC_DESCRIPTION,
+    modelFamilies: PYTHONIC_FAMILIES,
+    parse(content) {
+        const sanitized = sanitizeReasoningTags(content);
+        const { calls, remainder } = parsePythonicCalls(sanitized, "pythonic");
+        return {
+            ok: true,
+            parserId: "pythonic",
+            calls,
+            content: remainder,
+        };
+    },
+};
+export const llama4PythonicParser = {
+    id: "llama4_pythonic",
+    description: "Llama 4 Pythonic format: same as pythonic but with Llama-4-specific patterns",
+    modelFamilies: ["Llama 4"],
+    parse(content) {
+        const sanitized = sanitizeReasoningTags(content);
+        // Llama 4 may wrap calls in <|python_tag|> — strip those
+        const cleaned = sanitized.replace(/<\|python_tag\|>/gi, "").trim();
+        const { calls, remainder } = parsePythonicCalls(cleaned, "llama4_pythonic");
+        return {
+            ok: true,
+            parserId: "llama4_pythonic",
+            calls,
+            content: remainder,
+        };
+    },
+};
+// ─── Factories ────────────────────────────────────────────
+export function createPythonicParser() {
+    return pythonicParser;
+}
+export function createLlama4PythonicParser() {
+    return llama4PythonicParser;
+}
+//# sourceMappingURL=pythonic.js.map