Struct DialectSpec 

pub struct DialectSpec {
    pub id: String,
    pub tool_open: String,
    pub tool_close: String,
    pub body_codecs: Vec<BodyCodec>,
    pub emission: EmissionProfile,
    pub id_prefix: String,
}

A model’s tool-call dialect, described entirely as data.

See the module docs for the consumer contract. tool_open == tool_close is a valid spec (fenced dialects); an empty marker is not.

Fields

id: String

Stable identifier — QWEN_XML_DIALECT_ID for the builtin, DERIVED_DIALECT_ID for template-derived specs.

tool_open: String

Marker that opens a tool-call envelope, e.g. <tool_call>.

tool_close: String

Marker that closes a tool-call envelope, e.g. </tool_call>.

body_codecs: Vec<BodyCodec>

Body encodings to try, in order, against the envelope contents.

emission: EmissionProfile

Whitespace layout for emitted calls (grammar + Self::render_call).

id_prefix: String

Prefix for synthesized tool-call IDs, e.g. call_qwen_.

Implementations

impl DialectSpec

pub fn qwen_xml() -> Self

The built-in Qwen 2 / 2.5 / 3 (and Hermes-family) dialect: <tool_call> envelope with a JSON body, falling back to the <function=...> inner-XML body Qwen 3 emits under --jinja.

pub fn supports_json_body(&self) -> bool

Whether the JSON body codec applies — the precondition for GBNF grammar enforcement, which can only originate JSON-shaped bodies.

pub fn render_call(&self, name: &str, arguments: &Value) -> String

Render one canonical tool call exactly as the grammar would enforce it: envelope markers, EmissionProfile newlines, and a JSON body with name before arguments.

This is the bridge that proves grammar and parser share one source: tests feed render_call output through the parser and require the call to round-trip.

Trait Implementations

impl Clone for DialectSpec

fn clone(&self) -> DialectSpec

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DialectSpec

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DialectSpec

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for DialectSpec

fn eq(&self, other: &DialectSpec) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for DialectSpec

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for DialectSpec

impl StructuralPartialEq for DialectSpec