# 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 Discovery API
  version: 1.0.0
extends: openapi/thehiveryiq-com-discovery-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: 5
- target: $.paths['/v1/discovery/featured'].get
  update:
    x-apievangelist-phrasing:
      intent: List top-yield Hive endpoints
      effect: read
      questions:
      - Which Hive paid endpoints give the best value per call?
      - Can I get sample curl commands for the top featured endpoints?
      instructions:
      - text: List the featured Hive endpoints.
      - text: Show the top {n} endpoints by capability gradient.
        slots:
          n: query.n
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/discovery/stranded'].get
  update:
    x-apievangelist-phrasing:
      intent: Find paid endpoints nobody used today
      effect: read
      questions:
      - Which paid endpoints had zero calls in the last 24 hours?
      - Where are the under-used surfaces I could integrate with?
      instructions:
      - text: List stranded paid endpoints.
      - text: Show paid surfaces with no consumes in the past day, ranked by potential yield.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/agent/tools'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the curated top-10 agent tool list
      effect: read
      questions:
      - What are the ten most useful tools for my autonomous agent?
      - Is there a tool index with input schemas I can feed to an agent framework?
      instructions:
      - text: Get the curated agent tool index.
      - text: Show me the ten recommended agent tools with schemas and pricing.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/catalog'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the full catalog of paid endpoints
      effect: read
      questions:
      - What does every paid endpoint cost and which payment rails are accepted?
      - Is there a machine-readable list of all paid Hive endpoints?
      instructions:
      - text: Get the full paid endpoint catalog.
      - text: List every paid endpoint with its price and rail.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/.well-known/machine.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch the machine.json agent handshake
      effect: read
      questions:
      - Where is the minimal machine-readable handshake for agent bots?
      - What does /.well-known/machine.json point to?
      instructions:
      - text: Fetch /.well-known/machine.json.
      - text: Get the v2 machine handshake document.
      method: generated
      generated: '2026-09-26'