OpenAI Agents

Gate every OpenAI Agents SDK tool call through LatchGate’s enforcement pipeline.

Prerequisites

• LatchGate running (latchgate up or production deployment)

Install

pip install latchgate-openai-agents

Quick start

from agents import Agent, Runner
from latchgate_openai_agents import latchgate_tools

async def main():
    tools = await latchgate_tools(gate_url="http://localhost:3000")

    agent = Agent(
        name="Secure Worker",
        instructions="You have access to LatchGate-protected tools with full audit trail.",
        tools=tools,
    )

    result = await Runner.run(agent, "Fetch https://httpbin.org/get")
    print(result.final_output)

How it works

latchgate_tools() discovers all registered LatchGate actions via the REST API and wraps each one as an OpenAI Agents SDK FunctionTool. When the LLM calls a tool, the wrapper routes it through LatchGateClient.execute() — the full enforcement pipeline runs transparently.

Filtering actions

tools = await latchgate_tools(
    gate_url="http://localhost:3000",
    include={"http_fetch", "github_read"},
    exclude={"send_message"},
)

UDS transport (production)

from latchgate import LatchGateClient

client = LatchGateClient(socket="/run/latchgate/gate.sock", agent_id="my-openai-agent")
tools = await latchgate_tools(client=client)

Audit callback

Use on_audit for programmatic access to receipt metadata after each successful execution:

def my_audit_handler(record):
    # record.action_id, record.receipt_id, record.trace_id, record.verification
    audit_log.store(record)

tools = await latchgate_tools(
    gate_url="http://localhost:3000",
    on_audit=my_audit_handler,
)

LATCHGATE_URL environment variable

You can set LATCHGATE_URL instead of passing gate_url explicitly:

# With LATCHGATE_URL=http://localhost:3000 set:
tools = await latchgate_tools()

Discovery timeout

Control the HTTP timeout for the discovery phase (default 15 seconds):

tools = await latchgate_tools(
    gate_url="http://localhost:3000",
    discovery_timeout=10.0,
)

More details

Full API reference: latchgate-integrations/openai-agents/README.md.