§ 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.

· shipping· published to npm · MIT· package @orangecheck/agent-openai@0.2.0

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: @orangecheck/agent-openai@0.2.0 is on npm. Source in oc-packages/agent-openai. MIT. Ships stampFunctionCall, postActionToFleet, and invokeWithStampAndPost — sub-scope checking and canonicalization come from @orangecheck/agent-core; this package is the OpenAI-specific glue.

What Fleet adds on top: the managed signing pipeline, OC Stamp anchoring, Nostr publishing, audit-bundle assembly, and the operator dashboard.

preview · adapter shape

import OpenAI from 'openai';
import { invokeWithStampAndPost } from '@orangecheck/agent-openai';

const openai = new OpenAI();

// stamp the function call, run the handler, post the receipt to fleet.
// scope is enforced pre-call against the live delegation; if not
// admissible, invokeWithStampAndPost throws and your handler never runs.
const { result, action, posted } = await invokeWithStampAndPost({
  agent,                                  // bip-322 SignerRef
  delegation,                             // active OC Agent delegation
  call: toolCall,                         // raw openai tool_call object
  execute: async (fc) => createImpl(fc),  // your real handler
  fleet: {
    apiToken: process.env.OC_FLEET_TOKEN!,
    projectId: process.env.OC_FLEET_PROJECT_ID!,
  },
});

// posted = { id, project_id, delegation_id } once fleet accepts.
// omit `fleet` to stamp + execute without persistence — posted = null.

Already using the package?

Fleet adds the managed pipeline (OC Stamp anchoring, Nostr publishing, audit-bundle assembly, operator dashboard) on top of the open package. Design partners pair with an OrangeCheck engineer for the integration.

request access →read the docs →back to gallery →