# 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 Forge API
  version: 1.0.0
extends: openapi/thehiveryiq-com-forge-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: 6
- target: $.paths['/v1/forge/agent/qvac_provider/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List the QVAC provider agent's offerings
      effect: read
      questions:
      - What models or capabilities does the QVAC provider agent offer?
      - Can I filter the QVAC provider listing with metadata?
      instructions:
      - text: List what the QVAC provider agent offers.
      - text: List QVAC provider offerings matching metadata {metadata}.
        slots:
          metadata: requestBody.metadata
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/forge/agents'].get
  update:
    x-apievangelist-phrasing:
      intent: List all forge agents
      effect: read
      questions:
      - Which agents are available in the forge?
      - What forge agents can I invoke?
      instructions:
      - text: List all forge agents.
      - text: Show me every agent registered in the forge.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/forge/agent/qvac_provider'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the QVAC provider agent's details
      effect: read
      questions:
      - What is the QVAC provider agent and how is it configured?
      - Where do I see the profile of the QVAC forge agent?
      instructions:
      - text: Get the QVAC provider agent's profile.
      - text: Describe the QVAC forge agent.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/forge/agent/qvac_provider/invoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Run inference on the QVAC provider agent
      effect: write
      questions:
      - How do I send a prompt to a QVAC model through the forge?
      - Can I set the USDC price and payout address when invoking the provider?
      instructions:
      - text: Invoke QVAC model {model} with prompt {prompt}.
        slots:
          model: requestBody.model
          prompt: requestBody.prompt
      - text: Run {prompt} on the QVAC provider for {price_usdc} USDC paid out to {payout_address}.
        slots:
          prompt: requestBody.prompt
          price_usdc: requestBody.price_usdc
          payout_address: requestBody.payout_address
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/forge/agent/qvac_provider/invoke/public'].post
  update:
    x-apievangelist-phrasing:
      intent: Pay-per-call QVAC inference via x402
      effect: write
      questions:
      - How do I call the QVAC provider publicly and pay per request with x402?
      - What happens if I call the public forge invoke without an X-Payment header?
      instructions:
      - text: Invoke the public x402-gated QVAC endpoint with model {model} and prompt {prompt}.
        slots:
          model: requestBody.model
          prompt: requestBody.prompt
      - text: Pay via x402 and run {prompt} on the public QVAC route.
        slots:
          prompt: requestBody.prompt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/forge/agent/qvac_provider/economics'].get
  update:
    x-apievangelist-phrasing:
      intent: See the QVAC provider agent's economics
      effect: read
      questions:
      - How much has the QVAC provider agent earned and what does it cost?
      - Where are the revenue and pricing numbers for the QVAC agent?
      instructions:
      - text: Show the QVAC provider agent's economics.
      - text: Get earnings and pricing for the QVAC forge agent.
      method: generated
      generated: '2026-09-26'