OpenAI Agents Engine

const saveFile = tool({
  name: 'save_file',
  description: 'Save the whole text of a file, at a path relative to the working directory.',
  parameters: {
    type: 'object',
    properties: { path: { type: 'string' }, text: { type: 'string' } },
    required: ['path', 'text'],
    additionalProperties: false,
  },
  execute: async (input) => {
    const { path, text } = input as { path: string; text: string };
    await mkdir(dirname(path), { recursive: true });
    await writeFile(path, text);
    return `saved ${path}`;
  },
});

// Offline, the model replays the turns recorded in writer.json, so the
// example runs with no key. `WRITER_MODEL=gpt-5` gives the agent that OpenAI
// model instead, with `OPENAI_API_KEY` set.
const liveModel = process.env.WRITER_MODEL;

const agent = new Agent({
  name: 'Page writer',
  instructions: 'You rewrite documentation pages so a person reads them once and knows what to do. Save the page with the save_file tool, then reply with the JSON the prompt asks for.',
  model: liveModel ?? replayedModel('writer.json'),
  tools: [saveFile],
});

// The replayed model is an object, whose name the SDK does not expose, so
// the seat is told which model to record. A model name needs no option.
const writer = openaiAgent(agent, liveModel === undefined ? { model: 'replayed/replayed-writer' } : {});
const reader = codex('gpt-5.6-luna');
const judgeSeat = recordedJudge('judge.json');

const brief = briefFromFile('briefs/page.md');
const file = brief.files?.[0];
if (file === undefined) throw new Error('briefs/page.md names no file in its front matter');

const team = workflow('openai-agents-writer', {
  brief,
  roles: { write: writer, read: [reader] },
  stages: [
    stage('write', {
      agent: 'write',
      writes: file,
      reviewedBy: 'read',
      refine: judge(judgeSeat, { cap: 3 }),
      desc: 'Rewrite the page so a person reads it once and knows what to do. On a later round, change only the sentences the findings name.',
      gate: 'The reader finds nothing that fails, or the judge says the page holds for this use case.',
    }),
  ],
});

{
  "status": "pass",
  "stop": "the judge chose holds"
}