# 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 Desci Qvac API
  version: 1.0.0
extends: openapi/thehiveryiq-com-desci-qvac-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: 7
- target: $.paths['/v1/desci/qvac/scan'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a DeSci research scan
      effect: write
      questions:
      - How do I kick off a scan pass for new DeSci QVAC findings?
      - Can I run the scan with a specific analyst instead of the default?
      instructions:
      - text: Run a DeSci QVAC scan pass.
      - text: Run a DeSci scan with analyst {analyst_id}.
        slots:
          analyst_id: requestBody.analyst_id
      - text: Run a DeSci scan with seed_if_empty set to {seed_if_empty}.
        slots:
          seed_if_empty: requestBody.seed_if_empty
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/desci/qvac/findings'].get
  update:
    x-apievangelist-phrasing:
      intent: List DeSci research findings
      effect: read
      questions:
      - What research findings have the DeSci analysts surfaced?
      - Can I filter findings to tier_1 severity or a single QVAC module?
      - Are findings that were already purchased included in the list?
      instructions:
      - text: List the DeSci findings.
      - text: Show the top {top_n} {severity} findings for module {qvac_module}.
        slots:
          top_n: query.top_n
          severity: query.severity
          qvac_module: query.qvac_module
      - text: List findings discovered by {discovered_by}.
        slots:
          discovered_by: query.discovered_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/desci/qvac/findings/{node_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a DeSci finding
      effect: read
      questions:
      - How do I read the details of a single DeSci finding?
      - What does a specific research finding node contain?
      instructions:
      - text: Get finding {node_id}.
        slots:
          node_id: path.node_id
      - text: Show research finding {node_id}.
        slots:
          node_id: path.node_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/desci/qvac/findings/{node_id}/purchase'].post
  update:
    x-apievangelist-phrasing:
      intent: Purchase a DeSci finding
      effect: write
      questions:
      - How do I buy a research finding from the DeSci marketplace?
      - Is my wallet screened against sanctions when purchasing a finding?
      instructions:
      - text: Buy finding {node_id} with wallet {buyer_wallet}.
        slots:
          node_id: path.node_id
          buyer_wallet: requestBody.buyer_wallet
      - text: Purchase finding {node_id} for {buyer_did} from wallet {buyer_wallet} paying in {asset_requested}.
        slots:
          node_id: path.node_id
          buyer_did: requestBody.buyer_did
          buyer_wallet: requestBody.buyer_wallet
          asset_requested: requestBody.asset_requested
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/desci/qvac/leaderboard'].get
  update:
    x-apievangelist-phrasing:
      intent: View the DeSci analyst leaderboard
      effect: read
      questions:
      - Which DeSci analysts have the best research record?
      - Can I see just the top few DeSci analysts?
      instructions:
      - text: Show the DeSci analyst leaderboard.
      - text: Show the top {top_n} DeSci analysts.
        slots:
          top_n: query.top_n
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/desci/qvac/analysts'].get
  update:
    x-apievangelist-phrasing:
      intent: List DeSci research analysts
      effect: read
      questions:
      - Which research analysts are running DeSci scans?
      - What analysts exist in DeSci QVAC?
      instructions:
      - text: List the DeSci analysts.
      - text: Show every research analyst.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/desci/qvac/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get DeSci research stats
      effect: read
      questions:
      - How many DeSci findings have been discovered and sold?
      - What are the overall DeSci QVAC statistics?
      instructions:
      - text: Show DeSci stats.
      - text: Report DeSci findings and sales totals.
      method: generated
      generated: '2026-09-26'