Capability Schema Present v1¶

Source schema: doc/schemas/capability-schema-present.v1.schema.json

Peer-message response payload used to present one capability-schema.v1 artifact over an authenticated Node-to-Node session. It mirrors the thin capability-passport-present.v1 pattern while allowing explicit error responses for unavailable schemas.

Governing Basis¶

Project Lineage¶

Fields¶

Field	Required	Shape	Description
`schema`	`yes`	const: `capability-schema-present.v1`	Schema discriminator. MUST be exactly `capability-schema-present.v1`.
`status`	`yes`	enum: `ok`, `error`	Whether the requested schema artifact is present in this response.
`artifact`	`no`	object	Returned `capability-schema.v1` artifact. Required when `status = "ok"`.
`error`	`no`	object	Machine-readable error object. Required when `status = "error"`.

Conditional Rules¶

Rule 1¶

When:

{
  "properties": {
    "status": {
      "const": "ok"
    }
  },
  "required": [
    "status"
  ]
}

Then:

{
  "required": [
    "artifact"
  ]
}

Rule 2¶

When:

{
  "properties": {
    "status": {
      "const": "error"
    }
  },
  "required": [
    "status"
  ]
}

Then:

{
  "required": [
    "error"
  ]
}

Field Semantics¶

`schema`¶

Required: yes
Shape: const: capability-schema-present.v1

Schema discriminator. MUST be exactly capability-schema-present.v1.

`status`¶

Required: yes
Shape: enum: ok, error

Whether the requested schema artifact is present in this response.

`artifact`¶

Required: no
Shape: object

Returned capability-schema.v1 artifact. Required when status = "ok".

`error`¶

Required: no
Shape: object

Machine-readable error object. Required when status = "error".