# 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 Pq API
  version: 1.0.0
extends: openapi/thehiveryiq-com-pq-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/smsh/pq/selftest'].get
  update:
    x-apievangelist-phrasing:
      intent: Run the post-quantum crypto self-test
      effect: read
      questions:
      - Does the ML-DSA-65 and ML-KEM-768 implementation pass a NIST conformance round trip?
      - What are the real signing and key-encapsulation latencies?
      instructions:
      - text: Run the post-quantum self-test.
      - text: Check ML-DSA-65 and ML-KEM-768 conformance and latency.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/smsh/pq/keys/sample'].get
  update:
    x-apievangelist-phrasing:
      intent: Generate a sample ML-DSA-65 keypair
      effect: read
      questions:
      - Can I get a throwaway ML-DSA-65 keypair for integration testing?
      - Is the sample keypair safe to use for real keys?
      instructions:
      - text: Generate a demo ML-DSA-65 keypair.
      - text: Give me a base64 test keypair for post-quantum signing.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/smsh/pq/sign'].post
  update:
    x-apievangelist-phrasing:
      intent: Sign a message with ML-DSA-65
      effect: write
      questions:
      - How do I sign a message with a post-quantum ML-DSA-65 key?
      - What does each post-quantum signing call cost?
      instructions:
      - text: Sign message {message_b64} with secret key {sk_b64}.
        slots:
          message_b64: requestBody.message_b64
          sk_b64: requestBody.sk_b64
      - text: Produce an ML-DSA-65 signature over {message_b64} using {sk_b64}.
        slots:
          message_b64: requestBody.message_b64
          sk_b64: requestBody.sk_b64
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/smsh/pq/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify an ML-DSA-65 signature
      effect: read
      questions:
      - Can I verify a post-quantum signature for free?
      - What inputs does ML-DSA-65 signature verification need?
      instructions:
      - text: Verify signature {sig_b64} on {message_b64} with public key {pk_b64}.
        slots:
          sig_b64: requestBody.sig_b64
          message_b64: requestBody.message_b64
          pk_b64: requestBody.pk_b64
      - text: Check that {message_b64} was signed by {pk_b64} with signature {sig_b64}.
        slots:
          message_b64: requestBody.message_b64
          pk_b64: requestBody.pk_b64
          sig_b64: requestBody.sig_b64
      method: generated
      generated: '2026-09-26'