Struct InferenceContext 

pub struct InferenceContext<'a> {

    pub project_root: &'a Path,
    pub config: &'a KodaConfig,
    pub db: &'a Database,
    pub session_id: &'a str,
    pub system_prompt: &'a str,
    pub provider: &'a dyn LlmProvider,
    pub tools: &'a ToolRegistry,
    pub tool_defs: &'a [ToolDefinition],
    pub pending_images: Option<Vec<ImageData>>,
    pub mode: TrustMode,
    pub sink: &'a dyn EngineSink,
    pub cancel: CancellationToken,
    pub cmd_rx: &'a mut Receiver<EngineCommand>,
    pub file_tracker: &'a mut FileTracker,
    pub bg_agents: &'a Arc<BgAgentRegistry>,
    pub sub_agent_cache: &'a SubAgentCache,
}

All parameters for the inference loop, bundled into a single struct.

Fields

project_root: &'a Path

Project root directory.

config: &'a KodaConfig

Global configuration.

db: &'a Database

Database handle for message persistence.

session_id: &'a str

Current session identifier.

system_prompt: &'a str

System prompt for this session.

provider: &'a dyn LlmProvider

LLM provider to use.

tools: &'a ToolRegistry

Tool registry with all available tools.

tool_defs: &'a [ToolDefinition]

Pre-computed tool definitions sent to the LLM.

pending_images: Option<Vec<ImageData>>

Images attached to the current prompt (consumed on first turn).

mode: TrustMode

Current trust mode.

sink: &'a dyn EngineSink

Event sink for streaming output to the client.

cancel: CancellationToken

Cancellation token for graceful interruption.

cmd_rx: &'a mut Receiver<EngineCommand>

Channel for receiving client commands (approval responses, etc.).

file_tracker: &'a mut FileTracker

File lifecycle tracker for ownership-aware approval (#465).

bg_agents: &'a Arc<BgAgentRegistry>

Background sub-agent registry (#1022 B12). Owned by crate::session::KodaSession so bg agents survive across turns; this is just a borrow into the loop. Drained at the top of every iteration to inject completed bg results into the conversation.

sub_agent_cache: &'a SubAgentCache

Cross-turn sub-agent result cache (#1022 B12). Owned by crate::session::KodaSession. Generation-based invalidation on mutating tool calls is honored uniformly via crate::tool_dispatch::execute_one_tool.