WatchRateApprovedPayload `watch.rate.approved@1`

Generated at 2026-11-13 06:25:48 UTC from openvibe-contracts v0.419.0 and openvibe-sdk v0.161.0.

Version: 1.0.0
Owner: watch
Visibility: first-party
Status: active
Compatibility: backward
Schema: https://openvibe.network/contracts/events/payloads/watch.rate.approved.v1.json

watch.rate.approved v1 (OpenVibe.Watch server/provider-rates.js decide(); plan P6, flag WATCH_PROVIDER_RATES off by default): a person approved a pending provider-rate change. The payload is the change (watch.rate.changed@1) plus the decision. It is EVIDENCE, not a billable rate: Watch writes no rate card, applied is always false, and OpenVibe.AI's catalog operator alone changes the supply rate card through AI's own path. Money is integer nano-USD per million tokens as a decimal string (D1: never a float). Envelope: subject { type: provider-rate, id: <source_key> }, visibility internal, priority important, source and actor service:watch; actor is the service, and decided_by names the person.

Fields

Field	Type	Required	Description	Constraints
`change_id`	string	yes		`pattern ^prc_[0-9A-HJKMNP-TV-Z]{26}$`
`source_key`	string	yes	The source Watch fetched: the provider's key in its registry (deepinfra, featherless).
`provider`	string	yes	The provider whose document stated the rate (deepinfra, featherless).
`model`	string	yes	The model id exactly as the provider's document stated it.
`token_class`	enum	yes	The D1 token classes.	`one of "input", "cached_read", "cache_write", "output"`
`from_nano_usd_per_m`	string \| null	yes	The value Watch last observed, as an integer nano-USD per million tokens string; null for a first price.	`pattern ^[0-9]{1,19}$`
`to_nano_usd_per_m`	string	yes	The value the document stated, as an integer nano-USD per million tokens string.	`pattern ^[0-9]{1,19}$`
`currency`	string	yes	The document's currency; USD for both sources today.
`region`	string	yes	The document's scope; global for both sources today.
`effective_date`	string	yes	The first day this value was observed (YYYY-MM-DD).	`format date`
`source_url`	string	yes	The official document fetched.	`format uri`
`fetched_at`	string	yes		`format date-time`
`approval_required`	const	yes	false: the decision is made.	`= false`
`state`	const	yes		`= "approved"`
`decided_by`	string	yes	The person who approved it. A service or an agent may not; Watch refuses those with watch.rate_person_only.	`pattern ^usr_[0-9A-HJKMNP-TV-Z]{26}$`
`decided_at`	string	yes		`format date-time`
`applied`	const	yes	Always false: an approval is evidence and never writes a billable rate.	`= false`

Examples

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

Valid: deepinfra-input

{
  "change_id": "prc_01JAB2C3D4E5F6G7H8J9K0MNPQ",
  "source_key": "deepinfra",
  "provider": "deepinfra",
  "model": "Qwen/Qwen3-Coder-30B-A3B-Instruct",
  "token_class": "input",
  "from_nano_usd_per_m": "70000000",
  "to_nano_usd_per_m": "90000000",
  "currency": "USD",
  "region": "global",
  "effective_date": "2026-11-03",
  "source_url": "https://api.deepinfra.com/models/list",
  "fetched_at": "2026-11-03T09:15:00.000Z",
  "approval_required": false,
  "state": "approved",
  "decided_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPR",
  "decided_at": "2026-11-03T12:00:00.000Z",
  "applied": false
}

Rejected: applied-true

{
  "change_id": "prc_01JAB2C3D4E5F6G7H8J9K0MNPQ",
  "source_key": "deepinfra",
  "provider": "deepinfra",
  "model": "Qwen/Qwen3-Coder-30B-A3B-Instruct",
  "token_class": "input",
  "from_nano_usd_per_m": "70000000",
  "to_nano_usd_per_m": "90000000",
  "currency": "USD",
  "region": "global",
  "effective_date": "2026-11-03",
  "source_url": "https://api.deepinfra.com/models/list",
  "fetched_at": "2026-11-03T09:15:00.000Z",
  "approval_required": false,
  "state": "approved",
  "decided_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPR",
  "decided_at": "2026-11-03T12:00:00.000Z",
  "applied": true
}

Rejected: service-decided

{
  "change_id": "prc_01JAB2C3D4E5F6G7H8J9K0MNPQ",
  "source_key": "deepinfra",
  "provider": "deepinfra",
  "model": "Qwen/Qwen3-Coder-30B-A3B-Instruct",
  "token_class": "input",
  "from_nano_usd_per_m": "70000000",
  "to_nano_usd_per_m": "90000000",
  "currency": "USD",
  "region": "global",
  "effective_date": "2026-11-03",
  "source_url": "https://api.deepinfra.com/models/list",
  "fetched_at": "2026-11-03T09:15:00.000Z",
  "approval_required": false,
  "state": "approved",
  "decided_by": "svc_aix-admin",
  "decided_at": "2026-11-03T12:00:00.000Z",
  "applied": false
}

Validate

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

WatchRateApprovedPayload watch.rate.approved@1

Fields

Examples

Validate

WatchRateApprovedPayload `watch.rate.approved@1`