Ruby Executions

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

response = session.execute(
  input: { orderId: "123", reason: "duplicate" },
  route: { provider: "openai", model: "gpt-4o-mini" }
)

raise response.error.code if response.error
puts response.meta.request_id

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