OpenAI Agents Adapter

Source references:

• https://github.com/openai/openai-agents-python
• https://openai.github.io/openai-agents-python/guardrails/

Agent contract mapping

• Agent instructions + tool lists are treated as contract projections.
• Enforce AEEF contract fields externally when runtime does not natively represent them.

Hook mapping

• Guardrail pre-checks -> pre-phase hooks.
• Tool/event callbacks -> post-phase hooks.
• Human escalation handlers -> stop-phase hooks.

Gate enforcement points

• Guardrail results map to GateDecision artifacts.
• Production profile requires explicit human approver for deployment gates.

Handoff mapping

• Handoff primitives are normalized to AEEF HandoffArtifact schema.

Run-ledger mapping

• Trace spans and tool events are transformed to RunLedgerEntry.
• Must include skill_ids, gate_decisions, and artifact references.