feat(inspector): add model call statistics

crates/app/ironclaw_composition/src/observability/budget.rs

@@ -122,6 +122,7 @@ mod tests {
             surface_version: None,
             model_preference: None,
             fallback_index: 0,
+            iteration: 0,
             capability_view: None,
         };
         let _ = governor

crates/contracts/ironclaw_loop_contracts/src/host/model.rs

@@ -41,6 +41,9 @@ pub struct LoopModelRequest {
     /// Zero-based index into the host-resolved ordered fallback chain.
     #[serde(default)]
     pub fallback_index: u32,
+    /// Zero-based agent-loop iteration that issued this provider call.
+    #[serde(default)]
+    pub iteration: u32,
     #[serde(default, skip_serializing_if = "Option::is_none")]
     pub capability_view: Option<LoopModelCapabilityView>,
 }

crates/kernel/ironclaw_turns/tests/agent_loop_host_contract.rs

@@ -286,6 +286,7 @@ async fn host_managed_model_port_routes_gateway_and_emits_model_milestones() {
             surface_version: Some(CapabilitySurfaceVersion::new("surface-v1").unwrap()),
             model_preference: Some(context.resolved_run_profile.model_profile_id.clone()),
             fallback_index: 0,
+            iteration: 0,
             capability_view: None,
         })
         .await
@@ -345,6 +346,7 @@ async fn host_managed_model_port_returns_response_when_model_started_milestone_f
             surface_version: None,
             model_preference: None,
             fallback_index: 0,
+            iteration: 0,
             capability_view: None,
         })
         .await
@@ -390,6 +392,7 @@ async fn host_managed_model_port_returns_response_when_model_completed_milestone
             surface_version: None,
             model_preference: None,
             fallback_index: 0,
+            iteration: 0,
             capability_view: None,
         })
         .await
@@ -432,6 +435,7 @@ async fn host_managed_model_port_sanitizes_gateway_errors() {
             surface_version: None,
             model_preference: None,
             fallback_index: 0,
+            iteration: 0,
             capability_view: None,
         })
         .await
@@ -2913,6 +2917,7 @@ impl AgentLoopDriver for ReplyDriver {
                         .clone(),
                 ),
                 fallback_index: 0,
+                iteration: 0,
                 capability_view: None,
             })
             .await
@@ -3205,6 +3210,7 @@ async fn host_managed_model_port_times_out_a_hung_gateway() {
             surface_version: Some(CapabilitySurfaceVersion::new("surface-v1").unwrap()),
             model_preference: Some(context.resolved_run_profile.model_profile_id.clone()),
             fallback_index: 0,
+            iteration: 0,
             capability_view: None,
         })
         .await
@@ -3243,6 +3249,7 @@ async fn host_managed_model_port_allows_long_calls_that_keep_streaming_progress(
             surface_version: Some(CapabilitySurfaceVersion::new("surface-v1").unwrap()),
             model_preference: Some(context.resolved_run_profile.model_profile_id.clone()),
             fallback_index: 0,
+            iteration: 0,
             capability_view: None,
         })
         .await
@@ -3860,6 +3867,7 @@ fn simple_model_request(context: &LoopRunContext) -> LoopModelRequest {
         surface_version: None,
         model_preference: Some(context.resolved_run_profile.model_profile_id.clone()),
         fallback_index: 0,
+        iteration: 0,
         capability_view: None,
     }
 }

crates/loop/ironclaw_agent_loop/src/executor/failure_explanation.rs

@@ -74,6 +74,7 @@ pub(super) async fn explain_failure(
             surface_version: None,
             model_preference: None,
             fallback_index: state.model_state.fallback_index,
+            iteration: state.iteration,
             capability_view: Some(LoopModelCapabilityView {
                 visible_capability_ids: Vec::new(),
             }),

crates/loop/ironclaw_agent_loop/src/executor/model.rs

@@ -79,6 +79,7 @@ impl ExecutorStage<ModelInput> for ModelStage {
             surface_version: Some(surface_version.clone()),
             model_preference,
             fallback_index,
+            iteration: state.iteration,
             capability_view: Some(capability_view.clone()),
         };
         let visible_capability_count = capability_view.visible_capability_ids.len();

crates/loop/ironclaw_agent_loop/src/executor/tests/cancellation.rs

@@ -488,14 +488,16 @@ async fn model_cancelled_returns_cancelled_without_retry() {
         "model cancelled",
     )]);
     let executor = CanonicalAgentLoopExecutor;
-    let state = LoopExecutionState::initial_for_run(host.run_context());
+    let mut state = LoopExecutionState::initial_for_run(host.run_context());
+    state.iteration = 3;
 
     let result = executor
         .execute_family(&crate::families::default(), &host, state)
         .await;
 
     assert!(matches!(result, Err(AgentLoopExecutorError::Cancelled)));
     assert_eq!(host.model_requests().len(), 1);
+    assert_eq!(host.model_requests()[0].iteration, 3);
 }
 
 #[tokio::test]

crates/loop/ironclaw_hooks/src/middleware/model_port.rs

@@ -165,6 +165,7 @@ mod tests {
             surface_version: None,
             model_preference: None,
             fallback_index: 0,
+            iteration: 0,
             capability_view: None,
         }
     }

crates/loop/ironclaw_loop_host/src/budget_accountant.rs

@@ -899,6 +899,7 @@ mod tests {
             surface_version: None,
             model_preference: None,
             fallback_index: 0,
+            iteration: 0,
             capability_view: None,
         }
     }