# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Thehiveryiq Com Xcalibur Quorum API
  version: 1.0.0
extends: openapi/thehiveryiq-com-xcalibur-quorum-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/v1/xcalibur/quorum/complete'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an M-of-N consensus answer from several LLMs
      effect: write
      questions:
      - How do I send one prompt to several models and only accept an answer most of them agree on?
      - Can I choose which models vote and how many votes count as a quorum?
      - Do I get receipts for the models that dissented?
      instructions:
      - text: Run a quorum over {prompt}.
        slots:
          prompt: requestBody.prompt
      - text: Ask models {models} to answer {prompt} and require {m} to agree.
        slots:
          models: requestBody.models
          prompt: requestBody.prompt
          m: requestBody.m
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/xcalibur/quorum/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a QUORUM receipt signature
      effect: read
      questions:
      - How can I confirm a consensus receipt was really signed by the quorum service?
      - What does QUORUM receipt verification return?
      instructions:
      - text: Verify QUORUM receipt {receipt}.
        slots:
          receipt: requestBody.receipt
      - text: Check the ed25519 signature on consensus receipt {receipt}.
        slots:
          receipt: requestBody.receipt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/xcalibur/quorum/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check QUORUM liveness and available models
      effect: read
      questions:
      - Is the QUORUM consensus service alive, and which model IDs can it call?
      - Where do I get the quorum service's public key and version?
      instructions:
      - text: Check QUORUM health.
      - text: List the model IDs QUORUM can currently dispatch to.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/xcalibur/quorum/registry'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the QUORUM model registry
      effect: read
      questions:
      - Which model families and eras can participate in quorum votes?
      - What provider model names sit behind each logical model ID?
      instructions:
      - text: Show the full QUORUM model registry.
      - text: List every model eligible to vote, with its family and era.
      method: generated
      generated: '2026-09-26'