PHP 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']
]);

if ($response['error']) { throw new RuntimeException($response['error']['code']); }
echo $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