OpenAI Agents SDK

Full working example: examples/openai-agents-demo

Setup

import gavrun
from gavrun.adapters import OpenAIPreflightHooks

gavrun.configure(
    api_key="gavrun_live_...",
    agent_manager_url="https://api.gavrun.ai",
    auto_patch=False,   # use explicit hooks instead
)

client = gavrun.get_client()

hooks = OpenAIPreflightHooks(
    client=client,
    payload_factory=lambda tool_name: client.guard_payload(
        action=tool_name,
        tools=[tool_name],
        prompt=f"Tool call: {tool_name}",
    ),
)

Usage

from agents import Agent, Runner

agent = Agent(
    name="support-agent",
    tools=[cancel_order, refund_order],
)

result = await Runner.run(agent, input="Refund order ORD-123", hooks=hooks)

on_tool_start runs the preflight check asynchronously before each tool executes. If denied, raises GavrunDecisionDenied.