Skip to content

Corpus Reasoning Bid v1

Source schema: doc/schemas/corpus-reasoning-bid.v1.schema.json

Provider response envelope for one Corpus reasoning query. Accepted and counter bids embed an ordinary procurement-offer.v1 instead of defining a parallel pricing contract.

Governing Basis

Project Lineage

Fields

Field Required Shape Description
schema/v yes const: 1
bid/id yes string
query/id yes string
correlation/id yes string
bidder/node-id yes string
decision yes enum: accept, decline, counter
created-at yes string
bid/valid-until yes string
policy/digest yes ref: #/$defs/sha256_digest
procurement-offer no ref: procurement-offer.v1.schema.json
decline/reason no enum: no-capacity, out-of-policy, topic-mismatch, price-too-low, unavailable, other
diagnostic/ref no string
signature yes ref: #/$defs/signature
extensions no ref: #/$defs/extensions

Definitions

Definition Shape Description
sha256_digest string
signature object
extensions object

Conditional Rules

Rule 1

When:

{
  "properties": {
    "decision": {
      "enum": [
        "accept",
        "counter"
      ]
    }
  },
  "required": [
    "decision"
  ]
}

Then:

{
  "required": [
    "procurement-offer"
  ]
}

Rule 2

When:

{
  "properties": {
    "decision": {
      "const": "decline"
    }
  },
  "required": [
    "decision"
  ]
}

Then:

{
  "required": [
    "decline/reason"
  ],
  "not": {
    "required": [
      "procurement-offer"
    ]
  }
}

Field Semantics

schema/v

  • Required: yes
  • Shape: const: 1

bid/id

  • Required: yes
  • Shape: string

query/id

  • Required: yes
  • Shape: string

correlation/id

  • Required: yes
  • Shape: string

bidder/node-id

  • Required: yes
  • Shape: string

decision

  • Required: yes
  • Shape: enum: accept, decline, counter

created-at

  • Required: yes
  • Shape: string

bid/valid-until

  • Required: yes
  • Shape: string

policy/digest

  • Required: yes
  • Shape: ref: #/$defs/sha256_digest

procurement-offer

  • Required: no
  • Shape: ref: procurement-offer.v1.schema.json

decline/reason

  • Required: no
  • Shape: enum: no-capacity, out-of-policy, topic-mismatch, price-too-low, unavailable, other

diagnostic/ref

  • Required: no
  • Shape: string

signature

  • Required: yes
  • Shape: ref: #/$defs/signature

extensions

  • Required: no
  • Shape: ref: #/$defs/extensions

Definition Semantics

$defs.sha256_digest

  • Shape: string

$defs.signature

  • Shape: object

$defs.extensions

  • Shape: object