C# Executions

Execution calls perform governed runtime actions and return canonical envelope metadata.

var response = await session.ExecuteAsync(new ExecutionRequest {
  Input = new { orderId = "123", reason = "duplicate" },
  Route = new RouteRef { Provider = "openai", Model = "gpt-4o-mini" }
});
if (response.Error is not null) throw new InvalidOperationException(response.Error.Code);
Console.WriteLine(response.Meta.RequestId);

Required Invariants

• meta.requestId always present
• meta.timingMs.total always present
• error populated indicates failure; successful calls keep error null and return data

Recommended Handling

• Correlate request IDs with audit and lineage views
• Treat retryable=true as hint, not guarantee