b4145861d2
HUX-11 contract freeze: identity/capabilities/manifest/error records, event turn and idempotency and delegation/side-effect kinds, memory no-store/supersedes/ retrieval removal, revisions for optimistic concurrency, artifact access, budget scope/spend/subagents and external side-effect gating, notebook notes and dedupe keys. ADR-0001 records the wire and compatibility rules. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RNPhwu2bsaRNg3DETSAZoM
158 lines
4.0 KiB
JSON
158 lines
4.0 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://hermes.bstein.dev/contracts/hux/v1/identity.schema.json",
|
|
"title": "HUX identity, capability negotiation and data manifest",
|
|
"description": "HUX-11 foundation records. capabilities is the first call every client makes: it learns the contract version, which cards are on for this tenant (a card is on only when its whole dependency chain is on), and the server build. manifest is stored on the tenant PVC and tells a rolled-back reader whether it can read the data.",
|
|
"$defs": {
|
|
"capabilities": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": [
|
|
"schema",
|
|
"contract_version",
|
|
"identity",
|
|
"cards",
|
|
"server"
|
|
],
|
|
"properties": {
|
|
"schema": {
|
|
"const": "hux.capabilities.v1"
|
|
},
|
|
"contract_version": {
|
|
"$ref": "common.schema.json#/$defs/contract_version"
|
|
},
|
|
"identity": {
|
|
"$ref": "common.schema.json#/$defs/identity"
|
|
},
|
|
"cards": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": [
|
|
"card",
|
|
"flag",
|
|
"enabled",
|
|
"routes"
|
|
],
|
|
"properties": {
|
|
"card": {
|
|
"type": "string",
|
|
"pattern": "^HUX-[0-9]{2}$"
|
|
},
|
|
"flag": {
|
|
"type": "string",
|
|
"pattern": "^hux\\.[a-z_]+$"
|
|
},
|
|
"enabled": {
|
|
"type": "boolean"
|
|
},
|
|
"routes": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"pattern": "^/hux/v1/"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"server": {
|
|
"$ref": "common.schema.json#/$defs/build"
|
|
}
|
|
}
|
|
},
|
|
"manifest": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": [
|
|
"schema",
|
|
"contract_version",
|
|
"data_layout_version",
|
|
"min_reader_contract_version",
|
|
"created_at",
|
|
"updated_at"
|
|
],
|
|
"properties": {
|
|
"schema": {
|
|
"const": "hux.manifest.v1"
|
|
},
|
|
"contract_version": {
|
|
"$ref": "common.schema.json#/$defs/contract_version"
|
|
},
|
|
"data_layout_version": {
|
|
"type": "integer",
|
|
"minimum": 1
|
|
},
|
|
"min_reader_contract_version": {
|
|
"$ref": "common.schema.json#/$defs/contract_version"
|
|
},
|
|
"created_at": {
|
|
"$ref": "common.schema.json#/$defs/timestamp"
|
|
},
|
|
"updated_at": {
|
|
"$ref": "common.schema.json#/$defs/timestamp"
|
|
}
|
|
}
|
|
},
|
|
"error": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": [
|
|
"schema",
|
|
"status",
|
|
"code",
|
|
"message"
|
|
],
|
|
"properties": {
|
|
"schema": {
|
|
"const": "hux.error.v1"
|
|
},
|
|
"status": {
|
|
"type": "integer",
|
|
"minimum": 400,
|
|
"maximum": 599
|
|
},
|
|
"code": {
|
|
"type": "string",
|
|
"enum": [
|
|
"unauthorized",
|
|
"forbidden",
|
|
"not_found",
|
|
"conflict",
|
|
"flag_off",
|
|
"invalid",
|
|
"too_large",
|
|
"rate_limited",
|
|
"approval_required",
|
|
"budget_exhausted"
|
|
]
|
|
},
|
|
"message": {
|
|
"type": "string",
|
|
"maxLength": 280
|
|
},
|
|
"details": {
|
|
"type": "array",
|
|
"maxItems": 32,
|
|
"items": {
|
|
"type": "string",
|
|
"maxLength": 280
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"oneOf": [
|
|
{
|
|
"$ref": "#/$defs/capabilities"
|
|
},
|
|
{
|
|
"$ref": "#/$defs/manifest"
|
|
},
|
|
{
|
|
"$ref": "#/$defs/error"
|
|
}
|
|
]
|
|
}
|