Java Executions

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

var response = session.execute(new ExecutionRequest()
  .input(Map.of("orderId", "123", "reason", "duplicate"))
  .route(new RouteRef("openai", "gpt-4o-mini", null))
);
if (response.error() != null) throw new IllegalStateException(response.error().code());
System.out.println(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