# 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 Echo API
  version: 1.0.0
extends: openapi/thehiveryiq-com-xcalibur-echo-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: 3
- target: $.paths['/v1/xcalibur/echo/compress'].post
  update:
    x-apievangelist-phrasing:
      intent: Compress a prompt with a signed receipt
      effect: write
      questions:
      - Can I shrink a long prompt to a target length while keeping most of its content?
      - How is content preservation scored when a prompt is compressed?
      instructions:
      - text: 'Compress this prompt: {prompt}.'
        slots:
          prompt: requestBody.prompt
      - text: Compress {prompt} to ratio {target_ratio} keeping preservation above {min_preservation}.
        slots:
          prompt: requestBody.prompt
          target_ratio: requestBody.target_ratio
          min_preservation: requestBody.min_preservation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/xcalibur/echo/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a prompt compression receipt
      effect: read
      questions:
      - Is a compression receipt's signature and token math correct?
      - Can I confirm a compressed prompt matches the hash in its receipt?
      instructions:
      - text: Verify compression receipt {receipt}.
        slots:
          receipt: requestBody.receipt
      - text: Check receipt {receipt} against compressed prompt {compressed_prompt}.
        slots:
          receipt: requestBody.receipt
          compressed_prompt: requestBody.compressed_prompt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/xcalibur/echo/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the ECHO compressor's health
      effect: read
      questions:
      - Is the XCALIBUR ECHO prompt compressor up?
      - Can I run a liveness probe on ECHO?
      instructions:
      - text: Check ECHO health.
      - text: Confirm the prompt compressor is live.
      method: generated
      generated: '2026-09-26'