dynamo-parsers (v1, legacy)

Rust crate for parsing tool calls and reasoning content out of raw LLM output. This is the v1 batch path: it jails (buffers) the whole model output, then parses.

This is the crate to depend on today. dynamo-parsers (v1) is the stable, published parser API. The pure-streaming v2 crate (dynamo-parsers-v2, under ../v2/) is still under active development (WIP) — its API changes freely on the 0.x line and it is not yet a drop-in replacement. v2 will eventually replace v1 (v1 is not being merged into v2 — when v2 is done this crate is removed outright), but until then, external consumers should use v1.

Using the crate

Add it from crates.io (published as dynamo-parsers):

[dependencies]
dynamo-parsers = "3"

use dynamo_parsers::tool_calling::detect_and_parse_tool_call;

// registry dispatch by parser name; returns (tool calls, leftover normal_text)
let (calls, normal_text) = detect_and_parse_tool_call(input, "qwen3_coder", None)?;

The crate import path is dynamo_parsers (crate name, unaffected by the directory move under parsers/v1/). The WIP streaming crate is dynamo_parsers_v2 — do not reach for it in production yet.

v1-specific API

The v1 batch entry points (in src/tool_calling/parsers.rs) that v2 does not mirror:

• detect_and_parse_tool_call(input, parser_name, schema) -> (calls, normal_text) — registry dispatch.
• try_tool_call_parse(input, config) -> (calls, normal_text) — lower-level, bypasses the registry.
• detect_tool_call_start(chunk, parser_name) — streaming: "is this chunk starting a tool-call block?"
• find_tool_call_end_position(chunk, parser_name) — streaming: "where does the block end in this chunk?"

The registry (tool_calling/parsers.rs) maps a parser name to a ParserConfig variant (Dsml / Json / Xml / KimiK2 / Pythonic / Harmony); per-parser presets are in tool_calling/config.rs. Reasoning parsers register by name in reasoning/mod.rs; see src/reasoning/README.md.

For the family-to-grammar-to-file mapping (the cheat-sheet), the parser goals, and the step-by-step add flow, see ../v2/README.md.