ExchangeRequestPreset `exchange.request-preset@1`

Version: 1.0.0
Owner: exchange
Visibility: public
Status: active
Compatibility: backward
Decision: ADR-025
Schema: https://openvibe.network/contracts/exchange/request-preset.v1.json

A person-owned request preset with model fallbacks, system prompt, routing and sampling defaults.

Fields

Field	Type	Required	Constraints
`model`	string		`minLength 1` `maxLength 256`
`models`	array of string		`minItems 1` `maxItems 8` `items: minLength 1` `items: maxLength 256`
`provider`	object		`no other fields`
`provider.order`	array of string		`maxItems 64` `unique items` `items: pattern ^[a-zA-Z0-9._-]{1,100}$`
`provider.only`	array of string		`maxItems 64` `unique items` `items: pattern ^[a-zA-Z0-9._-]{1,100}$`
`provider.ignore`	array of string		`maxItems 64` `unique items` `items: pattern ^[a-zA-Z0-9._-]{1,100}$`
`provider.allow_fallbacks`	boolean
`provider.sort`	enum		`one of "price", "throughput", "latency", "quality", "value"`
`provider.max_price`	object		`no other fields`
`provider.max_price.prompt`	number		`minimum 0`
`provider.max_price.completion`	number		`minimum 0`
`provider.data_collection`	enum		`one of "allow", "deny"`
`provider.zdr`	boolean
`name`	string	yes	`pattern ^[a-z0-9][a-z0-9_-]{0,63}$`
`system`	string		`maxLength 32000`
`temperature`	number		`minimum 0` `maximum 2`
`top_p`	number		`minimum 0` `maximum 1`
`max_tokens`	integer		`minimum 1` `maximum 64000`
`seed`	integer
`response_format`	object

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

Valid: example

{
  "name": "writer",
  "model": "maker/model",
  "system": "Write clearly",
  "provider": {
    "sort": "price"
  }
}

Rejected: example

{
  "name": "writer",
  "model": "maker/model",
  "temperature": 3
}

const contracts = require('openvibe-contracts');
contracts.validate('exchange.request-preset@1', value);   // { valid, errors: [{ path, message }] }