@skaft/hamr 0.4.1

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

@@ -0,0 +1,150 @@
+/**
+ * DeepSeek V3 / V3.1 tool-call parser.
+ *
+ * Parses DeepSeek tool-call format. DeepSeek models output tool calls in
+ * a format similar to Hermes, using XML-style tags with JSON inside:
+ *
+ *   <tool_call>
+ *   {"name": "get_weather", "arguments": {"location": "SF", "unit": "celsius"}}
+ *   </tool_call>
+ *
+ * DeepSeek V3.1 may also use a <｜tool▁call▁begin｜>...<｜tool▁call▁end｜> format
+ * with a special token prefix.
+ *
+ * DeepSeek reasoning models (R1) may emit tool calls inside <think> blocks
+ * — the sanitizeReasoningTags step strips those before parsing.
+ *
+ * Reference: vLLM
+ *   --tool-call-parser deepseek_v3
+ *   --tool-call-parser deepseek_v31
+ *   vllm/entrypoints/openai/tool_parsers/deepseek_v3_tool_parser.py
+ *   vllm/entrypoints/openai/tool_parsers/deepseek_v31_tool_parser.py
+ */
+import { extractDelimitedBlocks, generateCallId, safeJsonParse, sanitizeReasoningTags } from "./utils.js";
+// ─── DeepSeek V3 ──────────────────────────────────────────
+const DSV3_ID = "deepseek_v3";
+const DSV3_DESC = 'DeepSeek V3 format: <tool_call>{"name":"...","arguments":{...}}</tool_call>';
+const DSV3_FAMILIES = ["DeepSeek V3", "DeepSeek Chat", "DeepSeek R1", "DeepSeek"];
+const DEEPSEEK_BEGIN = "<｜tool▁call▁begin｜>";
+const DEEPSEEK_END = "<｜tool▁call▁end｜>";
+export const deepseekV3Parser = {
+    id: DSV3_ID,
+    description: DSV3_DESC,
+    modelFamilies: DSV3_FAMILIES,
+    parse(content) {
+        const sanitized = sanitizeReasoningTags(content);
+        return parseDeepSeekContent(sanitized, DSV3_ID);
+    },
+};
+// ─── DeepSeek V3.1 ────────────────────────────────────────
+const DSV31_ID = "deepseek_v31";
+const DSV31_DESC = "DeepSeek V3.1 format: special-token-delimited tool calls with JSON";
+const DSV31_FAMILIES = ["DeepSeek V3.1"];
+export const deepseekV31Parser = {
+    id: DSV31_ID,
+    description: DSV31_DESC,
+    modelFamilies: DSV31_FAMILIES,
+    parse(content) {
+        const sanitized = sanitizeReasoningTags(content);
+        return parseDeepSeekContent(sanitized, DSV31_ID);
+    },
+};
+// ─── Shared implementation ────────────────────────────────
+function parseDeepSeekContent(sanitized, parserId) {
+    // Try <tool_call>...</tool_call> delimiters first (Hermes-compatible style)
+    const delimited = extractDelimitedBlocks(sanitized, "<tool_call>", "</tool_call>");
+    if (delimited.blocks.length > 0) {
+        return parseHermesStyleBlocks(delimited, parserId);
+    }
+    // Try special token delimiters
+    const specialDelimited = extractDelimitedBlocks(sanitized, DEEPSEEK_BEGIN, DEEPSEEK_END);
+    if (specialDelimited.blocks.length > 0) {
+        return parseHermesStyleBlocks(specialDelimited, parserId);
+    }
+    return {
+        ok: true,
+        parserId,
+        calls: [],
+        content: sanitized,
+    };
+}
+function parseHermesStyleBlocks(delimited, parserId) {
+    const calls = [];
+    const warnings = [];
+    for (let i = 0; i < delimited.blocks.length; i++) {
+        const block = delimited.blocks[i].trim();
+        if (!block)
+            continue;
+        const nonToolContent = [delimited.before, ...delimited.between, delimited.after].filter(Boolean).join("\n").trim();
+        const parsed = safeJsonParse(block);
+        if (!parsed.ok) {
+            return {
+                ok: false,
+                parserId,
+                calls: [],
+                content: nonToolContent,
+                error: `DeepSeek tool_call block ${i + 1}: ${parsed.error}`,
+            };
+        }
+        if (typeof parsed.value !== "object" || parsed.value === null || Array.isArray(parsed.value)) {
+            return {
+                ok: false,
+                parserId,
+                calls: [],
+                content: nonToolContent,
+                error: `DeepSeek tool_call block ${i + 1}: expected JSON object`,
+            };
+        }
+        const obj = parsed.value;
+        const name = obj.name ?? obj.tool_name ?? obj.function;
+        if (typeof name !== "string" || !name.trim()) {
+            return {
+                ok: false,
+                parserId,
+                calls: [],
+                content: nonToolContent,
+                error: `DeepSeek tool_call block ${i + 1}: missing "name"`,
+            };
+        }
+        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(`DeepSeek block ${i + 1}: 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: block,
+            parserId,
+        });
+    }
+    const nonToolContent = [delimited.before, ...delimited.between, delimited.after].filter(Boolean).join("\n").trim();
+    return {
+        ok: true,
+        parserId,
+        calls,
+        content: nonToolContent,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+// ─── Factories ────────────────────────────────────────────
+export function createDeepseekV3Parser() {
+    return deepseekV3Parser;
+}
+export function createDeepseekV31Parser() {
+    return deepseekV31Parser;
+}
+//# sourceMappingURL=deepseek.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.js","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/deepseek.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * DeepSeek V3 / V3.1 tool-call parser.\n *\n * Parses DeepSeek tool-call format. DeepSeek models output tool calls in\n * a format similar to Hermes, using XML-style tags with JSON inside:\n *\n *   <tool_call>\n *   {\"name\": \"get_weather\", \"arguments\": {\"location\": \"SF\", \"unit\": \"celsius\"}}\n *   </tool_call>\n *\n * DeepSeek V3.1 may also use a <｜tool▁call▁begin｜>...<｜tool▁call▁end｜> format\n * with a special token prefix.\n *\n * DeepSeek reasoning models (R1) may emit tool calls inside <think> blocks\n * — the sanitizeReasoningTags step strips those before parsing.\n *\n * Reference: vLLM\n *   --tool-call-parser deepseek_v3\n *   --tool-call-parser deepseek_v31\n *   vllm/entrypoints/openai/tool_parsers/deepseek_v3_tool_parser.py\n *   vllm/entrypoints/openai/tool_parsers/deepseek_v31_tool_parser.py\n */\n\nimport type { ParsedToolCall, ToolCallParseResult, ToolCallParser } from \"./types.ts\";\nimport { extractDelimitedBlocks, generateCallId, safeJsonParse, sanitizeReasoningTags } from \"./utils.ts\";\n\n// ─── DeepSeek V3 ──────────────────────────────────────────\n\nconst DSV3_ID = \"deepseek_v3\";\nconst DSV3_DESC = 'DeepSeek V3 format: <tool_call>{\"name\":\"...\",\"arguments\":{...}}</tool_call>';\nconst DSV3_FAMILIES = [\"DeepSeek V3\", \"DeepSeek Chat\", \"DeepSeek R1\", \"DeepSeek\"];\n\nconst DEEPSEEK_BEGIN = \"<｜tool▁call▁begin｜>\";\nconst DEEPSEEK_END = \"<｜tool▁call▁end｜>\";\n\nexport const deepseekV3Parser: ToolCallParser = {\n\tid: DSV3_ID,\n\tdescription: DSV3_DESC,\n\tmodelFamilies: DSV3_FAMILIES,\n\n\tparse(content: string): ToolCallParseResult {\n\t\tconst sanitized = sanitizeReasoningTags(content);\n\t\treturn parseDeepSeekContent(sanitized, DSV3_ID);\n\t},\n};\n\n// ─── DeepSeek V3.1 ────────────────────────────────────────\n\nconst DSV31_ID = \"deepseek_v31\";\nconst DSV31_DESC = \"DeepSeek V3.1 format: special-token-delimited tool calls with JSON\";\nconst DSV31_FAMILIES = [\"DeepSeek V3.1\"];\n\nexport const deepseekV31Parser: ToolCallParser = {\n\tid: DSV31_ID,\n\tdescription: DSV31_DESC,\n\tmodelFamilies: DSV31_FAMILIES,\n\n\tparse(content: string): ToolCallParseResult {\n\t\tconst sanitized = sanitizeReasoningTags(content);\n\t\treturn parseDeepSeekContent(sanitized, DSV31_ID);\n\t},\n};\n\n// ─── Shared implementation ────────────────────────────────\n\nfunction parseDeepSeekContent(sanitized: string, parserId: string): ToolCallParseResult {\n\t// Try <tool_call>...</tool_call> delimiters first (Hermes-compatible style)\n\tconst delimited = extractDelimitedBlocks(sanitized, \"<tool_call>\", \"</tool_call>\");\n\n\tif (delimited.blocks.length > 0) {\n\t\treturn parseHermesStyleBlocks(delimited, parserId);\n\t}\n\n\t// Try special token delimiters\n\tconst specialDelimited = extractDelimitedBlocks(sanitized, DEEPSEEK_BEGIN, DEEPSEEK_END);\n\n\tif (specialDelimited.blocks.length > 0) {\n\t\treturn parseHermesStyleBlocks(specialDelimited, parserId);\n\t}\n\n\treturn {\n\t\tok: true,\n\t\tparserId,\n\t\tcalls: [],\n\t\tcontent: sanitized,\n\t};\n}\n\nfunction parseHermesStyleBlocks(\n\tdelimited: ReturnType<typeof extractDelimitedBlocks>,\n\tparserId: string,\n): ToolCallParseResult {\n\tconst calls: ParsedToolCall[] = [];\n\tconst warnings: string[] = [];\n\n\tfor (let i = 0; i < delimited.blocks.length; i++) {\n\t\tconst block = delimited.blocks[i].trim();\n\t\tif (!block) continue;\n\n\t\tconst nonToolContent = [delimited.before, ...delimited.between, delimited.after].filter(Boolean).join(\"\\n\").trim();\n\n\t\tconst parsed = safeJsonParse(block);\n\t\tif (!parsed.ok) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\tparserId,\n\t\t\t\tcalls: [],\n\t\t\t\tcontent: nonToolContent,\n\t\t\t\terror: `DeepSeek tool_call block ${i + 1}: ${parsed.error}`,\n\t\t\t};\n\t\t}\n\n\t\tif (typeof parsed.value !== \"object\" || parsed.value === null || Array.isArray(parsed.value)) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\tparserId,\n\t\t\t\tcalls: [],\n\t\t\t\tcontent: nonToolContent,\n\t\t\t\terror: `DeepSeek tool_call block ${i + 1}: expected JSON object`,\n\t\t\t};\n\t\t}\n\n\t\tconst obj = parsed.value as Record<string, unknown>;\n\t\tconst name = obj.name ?? obj.tool_name ?? obj.function;\n\t\tif (typeof name !== \"string\" || !name.trim()) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\tparserId,\n\t\t\t\tcalls: [],\n\t\t\t\tcontent: nonToolContent,\n\t\t\t\terror: `DeepSeek tool_call block ${i + 1}: missing \"name\"`,\n\t\t\t};\n\t\t}\n\n\t\tlet args: Record<string, unknown> = {};\n\t\tconst rawArgs = obj.arguments ?? obj.parameters ?? obj.input;\n\t\tif (typeof rawArgs === \"string\") {\n\t\t\tconst parsedArgs = safeJsonParse(rawArgs);\n\t\t\tif (\n\t\t\t\tparsedArgs.ok &&\n\t\t\t\ttypeof parsedArgs.value === \"object\" &&\n\t\t\t\tparsedArgs.value !== null &&\n\t\t\t\t!Array.isArray(parsedArgs.value)\n\t\t\t) {\n\t\t\t\targs = parsedArgs.value as Record<string, unknown>;\n\t\t\t} else {\n\t\t\t\twarnings.push(`DeepSeek block ${i + 1}: arguments string parse failed`);\n\t\t\t}\n\t\t} else if (typeof rawArgs === \"object\" && rawArgs !== null && !Array.isArray(rawArgs)) {\n\t\t\targs = rawArgs as Record<string, unknown>;\n\t\t}\n\n\t\tcalls.push({\n\t\t\tid: generateCallId((obj.id ?? obj.call_id) as string | undefined, i + 1),\n\t\t\tname: name.trim(),\n\t\t\targuments: args,\n\t\t\trawSource: block,\n\t\t\tparserId,\n\t\t});\n\t}\n\n\tconst nonToolContent = [delimited.before, ...delimited.between, delimited.after].filter(Boolean).join(\"\\n\").trim();\n\n\treturn {\n\t\tok: true,\n\t\tparserId,\n\t\tcalls,\n\t\tcontent: nonToolContent,\n\t\twarnings: warnings.length > 0 ? warnings : undefined,\n\t};\n}\n\n// ─── Factories ────────────────────────────────────────────\n\nexport function createDeepseekV3Parser(): ToolCallParser {\n\treturn deepseekV3Parser;\n}\n\nexport function createDeepseekV31Parser(): ToolCallParser {\n\treturn deepseekV31Parser;\n}\n"]}

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

@@ -0,0 +1,19 @@
+/**
+ * Generic tool-call parser (fallback).
+ *
+ * This is Hamr's existing content-based tool-call parsing, preserved as
+ * the "generic" parser. It tries multiple strategies:
+ *
+ * 1. <tool_call>{"name":"...","arguments":{...}}</tool_call> blocks (Hermes-style)
+ * 2. ```json fenced code blocks
+ * 3. Bare JSON objects (last resort)
+ *
+ * This parser is the safe default when no specific parser is configured
+ * or auto-detected.
+ *
+ * It also supports the Qwen3 XML format via alias ('qwen3_coder' maps to 'qwen3_xml').
+ */
+import type { ToolCallParser } from "./types.ts";
+export declare const genericParser: ToolCallParser;
+export declare function createGenericParser(): ToolCallParser;
+//# sourceMappingURL=generic.d.ts.map

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

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

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

@@ -0,0 +1,263 @@
+/**
+ * Generic tool-call parser (fallback).
+ *
+ * This is Hamr's existing content-based tool-call parsing, preserved as
+ * the "generic" parser. It tries multiple strategies:
+ *
+ * 1. <tool_call>{"name":"...","arguments":{...}}</tool_call> blocks (Hermes-style)
+ * 2. ```json fenced code blocks
+ * 3. Bare JSON objects (last resort)
+ *
+ * This parser is the safe default when no specific parser is configured
+ * or auto-detected.
+ *
+ * It also supports the Qwen3 XML format via alias ('qwen3_coder' maps to 'qwen3_xml').
+ */
+import { extractDelimitedBlocks, generateCallId, safeJsonParse, sanitizeReasoningTags } from "./utils.js";
+const PARSER_ID = "generic";
+const DESCRIPTION = "Generic multi-strategy fallback: tries Hermes-style, fenced JSON, and bare JSON";
+const FAMILIES = ["Any", "Unknown", "Generic"];
+export const genericParser = {
+    id: PARSER_ID,
+    description: DESCRIPTION,
+    modelFamilies: FAMILIES,
+    parse(content) {
+        const sanitized = sanitizeReasoningTags(content);
+        const calls = [];
+        const warnings = [];
+        // Strategy 1: <tool_call>...</tool_call> blocks
+        const toolCallBlocks = extractDelimitedBlocks(sanitized, "<tool_call>", "</tool_call>");
+        let sawMalformedBlock = false;
+        for (const block of toolCallBlocks.blocks) {
+            const trimmed = block.trim();
+            if (!trimmed)
+                continue;
+            const parsed = safeJsonParse(trimmed);
+            if (!parsed.ok) {
+                sawMalformedBlock = true;
+                continue;
+            }
+            if (typeof parsed.value !== "object" || parsed.value === null) {
+                sawMalformedBlock = true;
+                continue;
+            }
+            const obj = parsed.value;
+            // Check for array of tool_calls (OpenAI-style wrapped)
+            if (Array.isArray(obj.tool_calls)) {
+                for (const tc of obj.tool_calls) {
+                    if (tc && typeof tc === "object") {
+                        const tcObj = tc;
+                        const fn = tcObj.function;
+                        if (fn && typeof fn === "object") {
+                            const fnObj = fn;
+                            const name = fnObj.name;
+                            if (typeof name === "string") {
+                                const args = parseArgsValue(fnObj.arguments);
+                                calls.push({
+                                    id: generateCallId((tcObj.id ?? fnObj.id), calls.length + 1),
+                                    name,
+                                    arguments: args,
+                                    rawSource: JSON.stringify(tc),
+                                    parserId: PARSER_ID,
+                                });
+                            }
+                        }
+                    }
+                }
+                continue;
+            }
+            // Single named call
+            const name = obj.name ?? obj.tool_name;
+            if (typeof name !== "string" || !name.trim()) {
+                sawMalformedBlock = true;
+                continue;
+            }
+            const args = parseArgsValue(obj.arguments ?? obj.parameters ?? obj.input);
+            calls.push({
+                id: generateCallId((obj.id ?? obj.call_id), calls.length + 1),
+                name: name.trim(),
+                arguments: args,
+                rawSource: trimmed,
+                parserId: PARSER_ID,
+            });
+        }
+        // Strategy 2: ```json fenced code blocks
+        const fencedBlocks = extractFencedJsonBlocks(sanitized);
+        for (const block of fencedBlocks) {
+            const parsed = safeJsonParse(block);
+            if (!parsed.ok)
+                continue;
+            if (typeof parsed.value !== "object" || parsed.value === null)
+                continue;
+            const obj = parsed.value;
+            // Handle OpenAI-style tool_calls array inside the block
+            if (Array.isArray(obj.tool_calls)) {
+                for (const tc of obj.tool_calls) {
+                    if (tc && typeof tc === "object") {
+                        const tcObj = tc;
+                        const fn = tcObj.function;
+                        if (fn && typeof fn === "object") {
+                            const fnObj = fn;
+                            const name = fnObj.name;
+                            if (typeof name === "string") {
+                                const args = parseArgsValue(fnObj.arguments);
+                                calls.push({
+                                    id: generateCallId((tcObj.id ?? fnObj.id), calls.length + 1),
+                                    name,
+                                    arguments: args,
+                                    rawSource: JSON.stringify(tc),
+                                    parserId: PARSER_ID,
+                                    warnings: ["parsed from fenced code block"],
+                                });
+                            }
+                        }
+                    }
+                }
+                continue;
+            }
+            // Handle single named call in fenced block
+            const name = obj.name ?? obj.tool_name;
+            if (typeof name !== "string" || !name.trim())
+                continue;
+            const args = parseArgsValue(obj.arguments ?? obj.parameters ?? obj.input);
+            calls.push({
+                id: generateCallId((obj.id ?? obj.call_id), calls.length + 1),
+                name: name.trim(),
+                arguments: args,
+                rawSource: block,
+                parserId: PARSER_ID,
+                warnings: ["parsed from fenced code block"],
+            });
+        }
+        // Strategy 3: Bare JSON object (last resort, only when no other calls found)
+        if (calls.length === 0) {
+            const trimmed = sanitized.trim();
+            if (trimmed.startsWith("{")) {
+                const parsed = safeJsonParse(trimmed);
+                if (parsed.ok && typeof parsed.value === "object" && parsed.value !== null) {
+                    const obj = parsed.value;
+                    // Handle OpenAI-style tool_calls array
+                    if (Array.isArray(obj.tool_calls)) {
+                        for (const tc of obj.tool_calls) {
+                            if (tc && typeof tc === "object") {
+                                const tcObj = tc;
+                                const fn = tcObj.function;
+                                if (fn && typeof fn === "object") {
+                                    const fnObj = fn;
+                                    const name = fnObj.name;
+                                    if (typeof name === "string") {
+                                        const args = parseArgsValue(fnObj.arguments);
+                                        calls.push({
+                                            id: generateCallId((tcObj.id ?? fnObj.id), calls.length + 1),
+                                            name,
+                                            arguments: args,
+                                            rawSource: JSON.stringify(tc),
+                                            parserId: PARSER_ID,
+                                            warnings: ["parsed from bare JSON text"],
+                                        });
+                                    }
+                                }
+                            }
+                        }
+                    }
+                    else {
+                        const name = obj.name ?? obj.tool_name;
+                        if (typeof name === "string" && name.trim()) {
+                            const args = parseArgsValue(obj.arguments ?? obj.parameters ?? obj.input);
+                            calls.push({
+                                id: generateCallId((obj.id ?? obj.call_id), 1),
+                                name: name.trim(),
+                                arguments: args,
+                                rawSource: trimmed,
+                                parserId: PARSER_ID,
+                                warnings: ["parsed from bare JSON text"],
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        // If we saw malformed blocks but found no calls, check if the content
+        // is actually a standalone tool-call response (not inside prose/code blocks).
+        // Only flag as error if the malformed blocks appear to be intentional tool calls.
+        if (sawMalformedBlock && calls.length === 0 && toolCallBlocks.blocks.length > 0) {
+            if (isStandaloneToolCallContent(sanitized, toolCallBlocks)) {
+                return {
+                    ok: false,
+                    parserId: PARSER_ID,
+                    calls: [],
+                    content: sanitized,
+                    error: "tool_call block contained malformed JSON",
+                };
+            }
+        }
+        // Compute non-tool content
+        let nonToolContent = sanitized;
+        if (toolCallBlocks.blocks.length > 0) {
+            nonToolContent = [toolCallBlocks.before, ...toolCallBlocks.between, toolCallBlocks.after]
+                .filter(Boolean)
+                .join("\n")
+                .trim();
+        }
+        else {
+            nonToolContent = sanitized;
+        }
+        return {
+            ok: true,
+            parserId: PARSER_ID,
+            calls,
+            content: nonToolContent,
+            warnings: warnings.length > 0 ? warnings : undefined,
+        };
+    },
+};
+// ─── Helpers ──────────────────────────────────────────────
+function parseArgsValue(raw) {
+    if (typeof raw === "string") {
+        const parsed = safeJsonParse(raw);
+        if (parsed.ok && typeof parsed.value === "object" && parsed.value !== null && !Array.isArray(parsed.value)) {
+            return parsed.value;
+        }
+    }
+    else if (typeof raw === "object" && raw !== null && !Array.isArray(raw)) {
+        return raw;
+    }
+    return {};
+}
+function extractFencedJsonBlocks(content) {
+    return [...content.matchAll(/```(?:json)?\s*([\s\S]*?)\s*```/g)].map((m) => m[1]);
+}
+/**
+ * Check if the content is primarily a tool-call response (standalone blocks).
+ * If tool_calls appear inside prose/fenced code, they are likely examples.
+ */
+function isStandaloneToolCallContent(content, blocks) {
+    // If content is entirely within fenced code blocks, it's not a standalone tool call
+    const fencedContent = content.match(/```[\s\S]*?```/g);
+    if (fencedContent) {
+        for (const fenced of fencedContent) {
+            if (fenced.includes("<tool_call>"))
+                return false;
+        }
+    }
+    // If there's substantial non-whitespace content before the first block, not standalone
+    if (blocks.before.trim().length > 0) {
+        // Allow a short preamble (like model intro text) but not full prose
+        if (blocks.before.trim().split(/\s+/).length > 5)
+            return false;
+    }
+    // If there's text between blocks that looks like prose, not standalone
+    for (const between of blocks.between) {
+        if (between.trim().split(/\s+/).length > 5)
+            return false;
+    }
+    // If there's substantial text after the last block, not standalone
+    if (blocks.after.trim().split(/\s+/).length > 5)
+        return false;
+    return true;
+}
+// ─── Factory ──────────────────────────────────────────────
+export function createGenericParser() {
+    return genericParser;
+}
+//# sourceMappingURL=generic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/generic.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Generic tool-call parser (fallback).\n *\n * This is Hamr's existing content-based tool-call parsing, preserved as\n * the \"generic\" parser. It tries multiple strategies:\n *\n * 1. <tool_call>{\"name\":\"...\",\"arguments\":{...}}</tool_call> blocks (Hermes-style)\n * 2. ```json fenced code blocks\n * 3. Bare JSON objects (last resort)\n *\n * This parser is the safe default when no specific parser is configured\n * or auto-detected.\n *\n * It also supports the Qwen3 XML format via alias ('qwen3_coder' maps to 'qwen3_xml').\n */\n\nimport type { ParsedToolCall, ToolCallParseResult, ToolCallParser } from \"./types.ts\";\nimport { extractDelimitedBlocks, generateCallId, safeJsonParse, sanitizeReasoningTags } from \"./utils.ts\";\n\nconst PARSER_ID = \"generic\";\nconst DESCRIPTION = \"Generic multi-strategy fallback: tries Hermes-style, fenced JSON, and bare JSON\";\nconst FAMILIES = [\"Any\", \"Unknown\", \"Generic\"];\n\nexport const genericParser: 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 calls: ParsedToolCall[] = [];\n\t\tconst warnings: string[] = [];\n\n\t\t// Strategy 1: <tool_call>...</tool_call> blocks\n\t\tconst toolCallBlocks = extractDelimitedBlocks(sanitized, \"<tool_call>\", \"</tool_call>\");\n\t\tlet sawMalformedBlock = false;\n\n\t\tfor (const block of toolCallBlocks.blocks) {\n\t\t\tconst trimmed = block.trim();\n\t\t\tif (!trimmed) continue;\n\n\t\t\tconst parsed = safeJsonParse(trimmed);\n\t\t\tif (!parsed.ok) {\n\t\t\t\tsawMalformedBlock = true;\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\tsawMalformedBlock = true;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst obj = parsed.value as Record<string, unknown>;\n\n\t\t\t// Check for array of tool_calls (OpenAI-style wrapped)\n\t\t\tif (Array.isArray(obj.tool_calls)) {\n\t\t\t\tfor (const tc of obj.tool_calls) {\n\t\t\t\t\tif (tc && typeof tc === \"object\") {\n\t\t\t\t\t\tconst tcObj = tc as Record<string, unknown>;\n\t\t\t\t\t\tconst fn = tcObj.function;\n\t\t\t\t\t\tif (fn && typeof fn === \"object\") {\n\t\t\t\t\t\t\tconst fnObj = fn as Record<string, unknown>;\n\t\t\t\t\t\t\tconst name = fnObj.name;\n\t\t\t\t\t\t\tif (typeof name === \"string\") {\n\t\t\t\t\t\t\t\tconst args = parseArgsValue(fnObj.arguments);\n\t\t\t\t\t\t\t\tcalls.push({\n\t\t\t\t\t\t\t\t\tid: generateCallId((tcObj.id ?? fnObj.id) as string | undefined, calls.length + 1),\n\t\t\t\t\t\t\t\t\tname,\n\t\t\t\t\t\t\t\t\targuments: args,\n\t\t\t\t\t\t\t\t\trawSource: JSON.stringify(tc),\n\t\t\t\t\t\t\t\t\tparserId: PARSER_ID,\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Single named call\n\t\t\tconst name = obj.name ?? obj.tool_name;\n\t\t\tif (typeof name !== \"string\" || !name.trim()) {\n\t\t\t\tsawMalformedBlock = true;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst args = parseArgsValue(obj.arguments ?? obj.parameters ?? obj.input);\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: trimmed,\n\t\t\t\tparserId: PARSER_ID,\n\t\t\t});\n\t\t}\n\n\t\t// Strategy 2: ```json fenced code blocks\n\t\tconst fencedBlocks = extractFencedJsonBlocks(sanitized);\n\t\tfor (const block of fencedBlocks) {\n\t\t\tconst parsed = safeJsonParse(block);\n\t\t\tif (!parsed.ok) continue;\n\t\t\tif (typeof parsed.value !== \"object\" || parsed.value === null) continue;\n\t\t\tconst obj = parsed.value as Record<string, unknown>;\n\n\t\t\t// Handle OpenAI-style tool_calls array inside the block\n\t\t\tif (Array.isArray(obj.tool_calls)) {\n\t\t\t\tfor (const tc of obj.tool_calls) {\n\t\t\t\t\tif (tc && typeof tc === \"object\") {\n\t\t\t\t\t\tconst tcObj = tc as Record<string, unknown>;\n\t\t\t\t\t\tconst fn = tcObj.function;\n\t\t\t\t\t\tif (fn && typeof fn === \"object\") {\n\t\t\t\t\t\t\tconst fnObj = fn as Record<string, unknown>;\n\t\t\t\t\t\t\tconst name = fnObj.name;\n\t\t\t\t\t\t\tif (typeof name === \"string\") {\n\t\t\t\t\t\t\t\tconst args = parseArgsValue(fnObj.arguments);\n\t\t\t\t\t\t\t\tcalls.push({\n\t\t\t\t\t\t\t\t\tid: generateCallId((tcObj.id ?? fnObj.id) as string | undefined, calls.length + 1),\n\t\t\t\t\t\t\t\t\tname,\n\t\t\t\t\t\t\t\t\targuments: args,\n\t\t\t\t\t\t\t\t\trawSource: JSON.stringify(tc),\n\t\t\t\t\t\t\t\t\tparserId: PARSER_ID,\n\t\t\t\t\t\t\t\t\twarnings: [\"parsed from fenced code block\"],\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Handle single named call in fenced block\n\t\t\tconst name = obj.name ?? obj.tool_name;\n\t\t\tif (typeof name !== \"string\" || !name.trim()) continue;\n\t\t\tconst args = parseArgsValue(obj.arguments ?? obj.parameters ?? obj.input);\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: block,\n\t\t\t\tparserId: PARSER_ID,\n\t\t\t\twarnings: [\"parsed from fenced code block\"],\n\t\t\t});\n\t\t}\n\n\t\t// Strategy 3: Bare JSON object (last resort, only when no other calls found)\n\t\tif (calls.length === 0) {\n\t\t\tconst trimmed = sanitized.trim();\n\t\t\tif (trimmed.startsWith(\"{\")) {\n\t\t\t\tconst parsed = safeJsonParse(trimmed);\n\t\t\t\tif (parsed.ok && typeof parsed.value === \"object\" && parsed.value !== null) {\n\t\t\t\t\tconst obj = parsed.value as Record<string, unknown>;\n\n\t\t\t\t\t// Handle OpenAI-style tool_calls array\n\t\t\t\t\tif (Array.isArray(obj.tool_calls)) {\n\t\t\t\t\t\tfor (const tc of obj.tool_calls) {\n\t\t\t\t\t\t\tif (tc && typeof tc === \"object\") {\n\t\t\t\t\t\t\t\tconst tcObj = tc as Record<string, unknown>;\n\t\t\t\t\t\t\t\tconst fn = tcObj.function;\n\t\t\t\t\t\t\t\tif (fn && typeof fn === \"object\") {\n\t\t\t\t\t\t\t\t\tconst fnObj = fn as Record<string, unknown>;\n\t\t\t\t\t\t\t\t\tconst name = fnObj.name;\n\t\t\t\t\t\t\t\t\tif (typeof name === \"string\") {\n\t\t\t\t\t\t\t\t\t\tconst args = parseArgsValue(fnObj.arguments);\n\t\t\t\t\t\t\t\t\t\tcalls.push({\n\t\t\t\t\t\t\t\t\t\t\tid: generateCallId((tcObj.id ?? fnObj.id) as string | undefined, calls.length + 1),\n\t\t\t\t\t\t\t\t\t\t\tname,\n\t\t\t\t\t\t\t\t\t\t\targuments: args,\n\t\t\t\t\t\t\t\t\t\t\trawSource: JSON.stringify(tc),\n\t\t\t\t\t\t\t\t\t\t\tparserId: PARSER_ID,\n\t\t\t\t\t\t\t\t\t\t\twarnings: [\"parsed from bare JSON text\"],\n\t\t\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\tconst name = obj.name ?? obj.tool_name;\n\t\t\t\t\t\tif (typeof name === \"string\" && name.trim()) {\n\t\t\t\t\t\t\tconst args = parseArgsValue(obj.arguments ?? obj.parameters ?? obj.input);\n\t\t\t\t\t\t\tcalls.push({\n\t\t\t\t\t\t\t\tid: generateCallId((obj.id ?? obj.call_id) as string | undefined, 1),\n\t\t\t\t\t\t\t\tname: name.trim(),\n\t\t\t\t\t\t\t\targuments: args,\n\t\t\t\t\t\t\t\trawSource: trimmed,\n\t\t\t\t\t\t\t\tparserId: PARSER_ID,\n\t\t\t\t\t\t\t\twarnings: [\"parsed from bare JSON text\"],\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// If we saw malformed blocks but found no calls, check if the content\n\t\t// is actually a standalone tool-call response (not inside prose/code blocks).\n\t\t// Only flag as error if the malformed blocks appear to be intentional tool calls.\n\t\tif (sawMalformedBlock && calls.length === 0 && toolCallBlocks.blocks.length > 0) {\n\t\t\tif (isStandaloneToolCallContent(sanitized, toolCallBlocks)) {\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: \"tool_call block contained malformed JSON\",\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\n\t\t// Compute non-tool content\n\t\tlet nonToolContent = sanitized;\n\t\tif (toolCallBlocks.blocks.length > 0) {\n\t\t\tnonToolContent = [toolCallBlocks.before, ...toolCallBlocks.between, toolCallBlocks.after]\n\t\t\t\t.filter(Boolean)\n\t\t\t\t.join(\"\\n\")\n\t\t\t\t.trim();\n\t\t} else {\n\t\t\tnonToolContent = sanitized;\n\t\t}\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 parseArgsValue(raw: unknown): Record<string, unknown> {\n\tif (typeof raw === \"string\") {\n\t\tconst parsed = safeJsonParse(raw);\n\t\tif (parsed.ok && typeof parsed.value === \"object\" && parsed.value !== null && !Array.isArray(parsed.value)) {\n\t\t\treturn parsed.value as Record<string, unknown>;\n\t\t}\n\t} else if (typeof raw === \"object\" && raw !== null && !Array.isArray(raw)) {\n\t\treturn raw as Record<string, unknown>;\n\t}\n\treturn {};\n}\n\nfunction extractFencedJsonBlocks(content: string): string[] {\n\treturn [...content.matchAll(/```(?:json)?\\s*([\\s\\S]*?)\\s*```/g)].map((m) => m[1]);\n}\n\n/**\n * Check if the content is primarily a tool-call response (standalone blocks).\n * If tool_calls appear inside prose/fenced code, they are likely examples.\n */\nfunction isStandaloneToolCallContent(content: string, blocks: ReturnType<typeof extractDelimitedBlocks>): boolean {\n\t// If content is entirely within fenced code blocks, it's not a standalone tool call\n\tconst fencedContent = content.match(/```[\\s\\S]*?```/g);\n\tif (fencedContent) {\n\t\tfor (const fenced of fencedContent) {\n\t\t\tif (fenced.includes(\"<tool_call>\")) return false;\n\t\t}\n\t}\n\n\t// If there's substantial non-whitespace content before the first block, not standalone\n\tif (blocks.before.trim().length > 0) {\n\t\t// Allow a short preamble (like model intro text) but not full prose\n\t\tif (blocks.before.trim().split(/\\s+/).length > 5) return false;\n\t}\n\n\t// If there's text between blocks that looks like prose, not standalone\n\tfor (const between of blocks.between) {\n\t\tif (between.trim().split(/\\s+/).length > 5) return false;\n\t}\n\n\t// If there's substantial text after the last block, not standalone\n\tif (blocks.after.trim().split(/\\s+/).length > 5) return false;\n\n\treturn true;\n}\n\n// ─── Factory ──────────────────────────────────────────────\n\nexport function createGenericParser(): ToolCallParser {\n\treturn genericParser;\n}\n"]}

package/dist/hamr/providers/parsers/glm-step.d.ts

@@ -0,0 +1,28 @@
+/**
+ * GLM and Step tool-call parsers.
+ *
+ * GLM 4.5/4.7 models and Step 3/3.5 models use specialized tool-call formats.
+ *
+ * GLM format (as documented by vLLM):
+ *   Uses a function-call token followed by a JSON object:
+ *   <|tool_call|>{"name": "get_weather", "arguments": {"location": "SF"}}
+ *
+ * Step 3 format:
+ *   Uses XML-style tags similar to Qwen but with Step-specific markup.
+ *
+ * These parsers are currently stubs that fall back to Hermes-style parsing
+ * and will be refined as format-specific documentation becomes available.
+ *
+ * Reference: vLLM
+ *   --tool-call-parser glm45, glm47, step3, step3p5
+ */
+import type { ToolCallParser } from "./types.ts";
+export declare const glm45Parser: ToolCallParser;
+export declare const glm47Parser: ToolCallParser;
+export declare const step3Parser: ToolCallParser;
+export declare const step3p5Parser: ToolCallParser;
+export declare function createGlm45Parser(): ToolCallParser;
+export declare function createGlm47Parser(): ToolCallParser;
+export declare function createStep3Parser(): ToolCallParser;
+export declare function createStep3p5Parser(): ToolCallParser;
+//# sourceMappingURL=glm-step.d.ts.map

package/dist/hamr/providers/parsers/glm-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glm-step.d.ts","sourceRoot":"","sources":["../../../../src/hamr/providers/parsers/glm-step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAuB,cAAc,EAAE,MAAM,YAAY,CAAC;AAKtE,eAAO,MAAM,WAAW,EAAE,cAsBzB,CAAC;AAIF,eAAO,MAAM,WAAW,EAAE,cAoBzB,CAAC;AAIF,eAAO,MAAM,WAAW,EAAE,cAoBzB,CAAC;AAIF,eAAO,MAAM,aAAa,EAAE,cAgB3B,CAAC;AAuMF,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AACD,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AACD,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AACD,wBAAgB,mBAAmB,IAAI,cAAc,CAEpD"}