Struct Shim 

pub struct Shim<C>
where
    C: BoxCodec,
{ /* private fields */ }

A single-owner, per-conversation bridge between K1 boxes and Codex turns.

Invoke a shim sequentially. Different shims may share cloned Adapters.

Implementations

impl<C> Shim<C>

where C: BoxCodec,

pub fn new( adapter: Adapter, conversation_key: impl Into<String>, codec: C, launcher: Box<dyn ToolCallLauncher<<C as BoxCodec>::Box>>, ) -> Shim<C>

Creates a ready shim for one conversation.

pub fn record_box(&mut self, box_: <C as BoxCodec>::Box)

Appends one externally produced box in canonical history order.

pub fn record_boxes( &mut self, boxes: impl IntoIterator<Item = <C as BoxCodec>::Box>, )

Appends externally produced boxes without changing their order.

pub fn pending_box_count(&self) -> usize

Returns the number of boxes waiting for the next fresh native turn.

pub async fn close_conversation(&mut self) -> Result<(), Error>

Closes this shim’s runtime conversation while the shim is ready.

Pending external boxes are retained and can prefix a later fresh thread.

pub async fn infer( &mut self, input: impl Into<String>, ) -> Result<ShimOutput<<C as BoxCodec>::Box>, Error>

Runs one fresh native turn through terminal completion.

Pending boxes clear only after start acceptance. Each immediately buffered call wave is checkpointed before its calls are acknowledged.