@paraharness/openai

OpenAI Responses API and Codex CLI model driver and declarative openai.* builders for Paraharness. This package connects P.agent actors and P.pool seat pools to OpenAI API key accounts and Codex CLI subscription seats, supporting server-side previous_response_id branching on same-model forks, automatic cross-seat stripping of account-bound item IDs and encrypted reasoning tokens, and native JSON-schema structured outputs.

Installation

With npm:

npm install @paraharness/openai @paraharness/core zod

With yarn:

yarn add @paraharness/openai @paraharness/core zod

With pnpm:

pnpm add @paraharness/openai @paraharness/core zod

Usage

import { P, z } from '@paraharness/core';
import { createExecutorRegistry } from '@paraharness/core/runtime';
import { openai, openaiExecutors } from '@paraharness/openai';

const primarySeat = openai.account('openai-primary').apiKey(P.env('OPENAI_API_KEY'));
const cliSeat = openai.cliAccount('codex-cli').configDir('~/.codex-seat-a');

const openaiSeats = P.pool('openai-seats')
  .with(cliSeat)
  .strategy('least-used')
  .fallback(primarySeat);

const codexModel = openai
  .model('gpt-5-codex', { effort: 'high' })
  .accountPool(openaiSeats);

const planner = P.agent('planner')
  .model(codexModel)
  .instructions('Break the architectural specification into ordered implementation tasks.')
  .input(z.object({ spec: z.string() }))
  .output(z.object({ tasks: z.array(z.string()) }));

const registry = createExecutorRegistry(openaiExecutors);

Documentation

See the @paraharness/openai API Reference for full type and builder specifications.

License

MIT © Tornike Tsomaia