Skip to content

Interface: OpenAiModelBuilder ​

Defined in: openai/src/builders/openai-model-builder.ts:15

Fluent builder for constructing a passive OpenAiModelNode (type: 'openai:model').

Binds an OpenAI model identifier, optional reasoning effort level, and an optional P.pool of OpenAiAccountSeatNode seats with run-sticky seat affinity and cross-seat failover stripping.

Extends ​

Methods ​

accountPool() ​

ts
accountPool(pool): OpenAiModelBuilder;

Defined in: openai/src/builders/openai-model-builder.ts:41

Attaches a capacity pool of OpenAiAccountSeatNode seats to multiplex requests with run-sticky affinity.

Accepts either a compiled PoolNode<OpenAiAccountSeatNode> or a PoolBuilder instance.

Parameters ​

ParameterTypeDescription
poolMaybeBuilder<PoolNode<OpenAiAccountSeatNode>>Account seat pool node or builder.

Returns ​

OpenAiModelBuilder

New immutable model builder bound to the specified account seat pool.


effort() ​

ts
effort(level): OpenAiModelBuilder;

Defined in: openai/src/builders/openai-model-builder.ts:30

Configures the reasoning effort level for OpenAI Responses API turns on this model.

Returns a new immutable OpenAiModelBuilder with the updated effort level.

Parameters ​

ParameterTypeDescription
level"low" | "medium" | "high"Reasoning effort level.

Returns ​

OpenAiModelBuilder

New immutable model builder with effort configured.


pool() ​

ts
pool(pool): OpenAiModelBuilder;

Defined in: openai/src/builders/openai-model-builder.ts:52

Alias for accountPool(pool) attaching a capacity pool of OpenAiAccountSeatNode seats.

Preserves API symmetry across @paraharness/claude, @paraharness/openai, and @paraharness/gemini.

Parameters ​

ParameterTypeDescription
poolMaybeBuilder<PoolNode<OpenAiAccountSeatNode>>Account seat pool node or builder.

Returns ​

OpenAiModelBuilder

New immutable model builder bound to the specified account seat pool.


toAST() ​

ts
toAST(): OpenAiModelNode;

Defined in: openai/src/builders/openai-model-builder.ts:61

Compiles the builder configuration into a deeply frozen passive OpenAiModelNode AST node.

Produces a monomorphic AST node with type: 'openai:model' and vendor: 'openai'.

Returns ​

OpenAiModelNode

Frozen passive AST node representing the OpenAI model.

Overrides ​

AstBuilder.toAST

Properties ​

PropertyModifierTypeDescriptionDefined in
aliasreadonlystringLogical alias of the model within the harness definition.openai/src/builders/openai-model-builder.ts:17
modelIdreadonlystringProvider-specific OpenAI model identifier transmitted on the wire.openai/src/builders/openai-model-builder.ts:19

Released under the MIT License.