Struct ToolCallBridge 

pub struct ToolCallBridge<I> { /* private fields */ }

Per-stream index → grammar-identity map for streamed tool calls.

I is the wire’s own index type (usize for chat-compat chunk indices, i32 for Bedrock content-block indices); it must display so a minted id can derive from it, and order so a drain preserves wire ordering.

Implementations

impl<I> ToolCallBridge<I>

where I: Eq + Hash + Ord + Copy,

pub fn new() -> Self

pub fn with_minted_namespace(minted: SyntheticIds) -> Self

A bridge minting slot identities in the given reserved namespace.

pub fn open( &mut self, index: I, wire_id: Option<&str>, name: Option<&str>, ) -> &mut ToolCallSlot

Open (or update) the slot for a wire index, establishing its identity.

On first sight the assembly key is fixed: the wire id when one is supplied, else a freshly minted identity — the single enforcement point of the mandatory-identity invariant. Later fragments update the established provider id and name from any non-empty values they carry.

pub fn get(&self, index: I) -> Option<&ToolCallSlot>

The open slot at a wire index, if any.

pub fn get_mut(&mut self, index: I) -> Option<&mut ToolCallSlot>

The open slot at a wire index, mutably — for fragment bookkeeping on an already-open slot without open’s insert-if-absent.

pub fn minted_ids(&mut self) -> &mut SyntheticIds

The bridge’s identity minter, for adapters that also mint whole-call identities: assemblies and whole calls must draw from ONE counter so their minted keys stay disjoint.

pub fn remove(&mut self, index: I) -> Option<ToolCallSlot>

Close and take the slot at a wire index, if any.

pub fn evict_if( &mut self, index: I, should_evict: impl FnOnce(&ToolCallSlot) -> bool, ) -> Option<ToolCallSlot>

Evict the slot at a wire index when the predicate says the incoming fragment belongs to a different call reusing the same index (the per-profile eviction semantics — e.g. a distinct id + name pair on a wire that restarts indices per call). Returns the evicted slot so the caller can flush it to the consumer.

pub fn decorate(&mut self, decoration: ToolCallDecoration)

Apply a provider decoration to the in-flight call it names, matched by the established provider id. Decorations ride the slot onto its end event; assembly itself is untouched.

Two matching rules keep this deterministic:

• A slot whose wire never established a provider id (empty id) never matches — a decoration for the empty string would otherwise pick an arbitrary id-less slot out of HashMap iteration order.
• Each field is first-wins: a later decoration for the same call fills only the fields still unset, so a gemini-style signature-then-params sequence composes instead of the second decoration clobbering the first’s signature with None.

pub fn is_empty(&self) -> bool

Whether any call is still open.

pub fn drain_ordered(&mut self) -> Vec<ToolCallSlot>

Drain every open slot in wire-index order, so a multi-call turn keeps its wire ordering when flushed. The caller chooses the unparseable policy per flush site when building end events.

pub fn drain_ordered_indexed(&mut self) -> Vec<(I, ToolCallSlot)>

ToolCallBridge::drain_ordered, keeping each slot’s wire index — for adapters that track per-slot state of their own beside the bridge (the Responses adapter’s pending call_ids).

Trait Implementations

impl<I: Debug> Debug for ToolCallBridge<I>

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

Formats the value using the given formatter.

impl<I> Default for ToolCallBridge<I>

where I: Eq + Hash + Ord + Copy,

fn default() -> Self

Returns the “default value” for a type.