Corpus Reasoning Query v1¶
Source schema: doc/schemas/corpus-reasoning-query.v1.schema.json
MVP Corpus procurement query. It decorates an existing question-envelope.v1 with a resolved topic, buyer price bracket, reply target, and fan-out bounds.
Governing Basis¶
Project Lineage¶
Fields¶
| Field | Required | Shape | Description |
|---|---|---|---|
schema/v |
yes |
const: 1 |
|
query/id |
yes |
string | |
correlation/id |
yes |
string | |
idempotency/key |
yes |
ref: #/$defs/sha256_digest |
|
requester/node-id |
yes |
string | |
requester/participant-id |
yes |
string | |
topic/term |
yes |
ref: #/$defs/topic_term |
|
corpus/taxonomy-digest |
yes |
ref: #/$defs/sha256_digest |
|
query/keywords |
yes |
array | |
question |
yes |
ref: question-envelope.v1.schema.json |
|
pricing/min-amount |
yes |
integer | Minimum acceptable buyer price in minor units. |
pricing/max-amount |
yes |
integer | Maximum acceptable buyer price in minor units. |
pricing/currency |
yes |
string | |
max/candidates |
yes |
integer | |
created-at |
yes |
string | |
deadline-at |
yes |
string | |
reply/target |
yes |
ref: #/$defs/reply_target |
|
extensions |
no |
ref: #/$defs/extensions |
Definitions¶
| Definition | Shape | Description |
|---|---|---|
sha256_digest |
string | |
topic_term |
string | |
reply_target |
object | |
extensions |
object | |
| ## Field Semantics |
schema/v¶
- Required:
yes - Shape: const:
1
query/id¶
- Required:
yes - Shape: string
correlation/id¶
- Required:
yes - Shape: string
idempotency/key¶
- Required:
yes - Shape: ref:
#/$defs/sha256_digest
requester/node-id¶
- Required:
yes - Shape: string
requester/participant-id¶
- Required:
yes - Shape: string
topic/term¶
- Required:
yes - Shape: ref:
#/$defs/topic_term
corpus/taxonomy-digest¶
- Required:
yes - Shape: ref:
#/$defs/sha256_digest
query/keywords¶
- Required:
yes - Shape: array
question¶
- Required:
yes - Shape: ref:
question-envelope.v1.schema.json
pricing/min-amount¶
- Required:
yes - Shape: integer
Minimum acceptable buyer price in minor units.
pricing/max-amount¶
- Required:
yes - Shape: integer
Maximum acceptable buyer price in minor units.
pricing/currency¶
- Required:
yes - Shape: string
max/candidates¶
- Required:
yes - Shape: integer
created-at¶
- Required:
yes - Shape: string
deadline-at¶
- Required:
yes - Shape: string
reply/target¶
- Required:
yes - Shape: ref:
#/$defs/reply_target
extensions¶
- Required:
no - Shape: ref:
#/$defs/extensions
Definition Semantics¶
$defs.sha256_digest¶
- Shape: string
$defs.topic_term¶
- Shape: string
$defs.reply_target¶
- Shape: object
$defs.extensions¶
- Shape: object