The Complete Production SOP: Deploying OpenAI SDK & Realtime API Expert in Codex, Claude Code, Cursor, and Windsurf

---
name: "openai-docs"
description: "Authoritative reference for OpenAI Responses API, Realtime Agents, and Codex system capabilities."
version: "1.0.0"
runtimes: ["codex", "claude-code", "cursor", "windsurf"]
---

# OpenAI SDK & Realtime API Expert

## Mandatory Schema Enforcement
- Every structured output function MUST use `strict: true` and include all declared properties in `required`.
- Realtime events must enforce 24kHz PCM16 or G.711 format alignment.
- Prefer the unified Responses API pattern over deprecated completion endpoints.

OPENAI_API_KEY=sk-proj-xxxxxxxxxxxxxxxxxxxxxxxx
OPENAI_REALTIME_MODEL=gpt-4o-realtime-preview-2024-12-17
OPENAI_RESPONSES_MODEL=gpt-4o

import { OpenAI } from 'openai';

export const sessionUpdateEvent = {
  type: 'session.update',
  session: {
    modalities: ['text', 'audio'],
    voice: 'verse',
    input_audio_format: 'pcm16',
    output_audio_format: 'pcm16',
    input_audio_transcription: { model: 'whisper-1' },
    turn_detection: { type: 'server_vad', threshold: 0.5, silence_duration_ms: 200 },
    tools: [{
      type: 'function',
      name: 'fetch_order_status',
      description: 'Retrieve real-time order status by identifier.',
      strict: true,
      parameters: {
        type: 'object',
        properties: {
          order_id: { type: 'string', description: 'The tracking UUID' }
        },
        required: ['order_id'],
        additionalProperties: false
      }
    }]
  }
} as const;

import { describe, it, expect } from 'vitest';
import { sessionUpdateEvent } from '../src/realtime/session-config';

describe('OpenAI Realtime Schema Gate', () => {
  it('enforces strict flag and required properties on tools', () => {
    const tool = sessionUpdateEvent.session.tools[0];
    expect(tool.strict).toBe(true);
    expect(tool.parameters.additionalProperties).toBe(false);
    expect(tool.parameters.required).toContain('order_id');
  });
});