Skip to main content

Installation

Peer dependency: @openai/agents >= 0.0.1.

Three-line setup

createVaneHooks()

Returns a RunHooks object compatible with the OpenAI Agents SDK run() function.

Options

What gets attested

Tool duration is tracked by pairing onToolStart and onToolEnd using a "agentName::toolName" key. This is sufficient for agents that don’t call the same tool twice concurrently in a single turn.

Error handling

Attestation calls are fire-and-forget. Errors are logged to console.error and execution continues.

VaneRunHooks type

The hook signatures are a structural match for @openai/agents RunHooks. If the SDK changes its hook signatures, TypeScript will surface an error at the run() call site, not inside this package.

Full example

Every tool call, agent start, agent end, and handoff in this run will produce a signed record in Vane.

Multi-agent handoffs

When agents hand off to each other, Vane records the handoff:
This gives you a complete picture of which agent did what, and which agents handed off to which others, all in the signed attestation chain.