§ integrations / openai

OpenAI Responses + Function Calling.

Adapter for OpenAI Responses (and the older Chat Completions tool path). Each function invocation is scope-checked against the active OC Agent delegation, then emits a signed agent-action envelope with the canonical input hash.

· in design· targeted Q3 2026 · partner-priority

What it does

OpenAI's function-calling and Responses APIs both produce tool-call deltas that name a function and pass JSON arguments. The adapter sits between the OpenAI SDK and your function handlers:

Pre-call: parse the function name + arguments, derive an exercised scope, verify it is admissible against the delegation. Refuses the call if not.
Canonicalize the call, hash, BIP-322 sign as the agent address. Emit an agent-action envelope (kind 30084, oc-agent-act: d-tag).
Return the function result to OpenAI's tool-result block, with the envelope id available for downstream replay.

Compatibility

Single adapter handles both code paths:

Responses API — newer, streaming-first, structured tool deltas. Adapter listens to the response stream, inserts envelope emission inline.
Chat Completions tool calls — legacy but widely deployed. Adapter wraps the synchronous response.

Both paths target the same agent-action envelope shape, so audit exports do not branch on which OpenAI surface produced them.

Status

Adapter package: targeted Q3 2026 in oc-packages. Sub-scope checking and canonicalization are already in @orangecheck/agent-core; the adapter is the OpenAI-specific glue.

preview · adapter shape

import OpenAI from 'openai';
import { withOcAgent } from '@orangecheck/agent-openai'; // q3 · in design

const client = new OpenAI();

const tools = [
  { type: 'function', function: { name: 'invoice.create', parameters: invoiceSchema } },
  { type: 'function', function: { name: 'invoice.refund', parameters: refundSchema } },
];

// scope-checked + envelope-emitting wrapper
const handler = withOcAgent({
  agent,
  delegation,
  tools: { 'invoice.create': createImpl, 'invoice.refund': refundImpl },
});

const response = await client.responses.create({
  model: 'gpt-4o',
  input: 'invoice acme for $14.20',
  tools,
});

await handler.process(response);

Want this adapter sooner?

Adapter prioritization is design-partner-driven. Tell us your stack, the volume, and the compliance bar — adapters that named partners need move from "planned" to "shipping" inside a quarter.

request access →read the docs →back to gallery →