Struct Shim 

pub struct Shim<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: BoxCodec> Shim<C>

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

Creates a ready shim for one conversation.

pub fn record_box(&mut self, box_: C::Box)

Appends one externally produced box in canonical history order.

pub fn record_boxes(&mut self, boxes: impl IntoIterator<Item = C::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::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.