Hive Civilization · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Thehiveryiq Com R2 Discovery API

8 actions 8 updates phrasing extends openapi/thehiveryiq-com-r2-discovery-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Hive Civilization's API. It is a proposal applied on top of the contract, not a document Hive Civilization publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 8

$.info
$.paths['/manifest'].get
$.paths['/a2a'].get
$.paths['/a2a'].post
$.paths['/.well-known/a2a.json'].get
$.paths['/status'].get
$.paths['/v1/a2a/status'].get
$.paths['/v1/transaction-harness'].get

OpenAPI Overlay

Raw ↑
# 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 R2 Discovery API
  version: 1.0.0
extends: openapi/thehiveryiq-com-r2-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: 7
- target: $.paths['/manifest'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the Hivemorph plugin manifest
      effect: read
      questions:
      - Where is the plugin manifest that points to Hivemorph's OpenAPI and MCP descriptor?
      - Does Hivemorph publish a ChatGPT-style plugin manifest?
      instructions:
      - text: Get the Hivemorph plugin manifest.
      - text: Show me the manifest with discovery pointers.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/a2a'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the A2A JSON-RPC transport
      effect: read
      questions:
      - Which JSON-RPC methods does the A2A endpoint support?
      - What protocol version does the A2A transport speak?
      instructions:
      - text: Show me the A2A transport descriptor.
      - text: List the A2A methods available at /a2a.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/a2a'].post
  update:
    x-apievangelist-phrasing:
      intent: Send an A2A JSON-RPC request
      effect: write
      questions:
      - Can my agent call agent.discover or receipt.verify over JSON-RPC?
      - Does the A2A endpoint accept batch requests?
      instructions:
      - text: Send an agent.card request over A2A.
      - text: Post a batch of A2A JSON-RPC calls including pricing.read.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/.well-known/a2a.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the well-known A2A descriptor
      effect: read
      questions:
      - Is there a .well-known/a2a.json file for crawlers to find the A2A endpoint?
      - What does the well-known A2A alias return?
      instructions:
      - text: Fetch /.well-known/a2a.json.
      - text: Get the A2A descriptor from the well-known path.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check Hivemorph live status
      effect: read
      questions:
      - Which Hivemorph layers are live, in pilot or on the roadmap?
      - What commit is deployed and how long has the process been up?
      instructions:
      - text: Show me the Hivemorph status page.
      - text: Check per-layer status R1 through R12 at /status.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/a2a/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check status via the A2A path
      effect: read
      questions:
      - Can agents fetch Hivemorph status under the /v1/a2a path?
      - Is there an A2A-namespaced alias for the status payload?
      instructions:
      - text: Get status from /v1/a2a/status.
      - text: Check status through the A2A alias.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/transaction-harness'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the 14-stage transaction harness
      effect: read
      questions:
      - Which stages of the transaction harness are live versus sample or roadmap?
      - Where are the signed sample artifacts for each transaction stage?
      instructions:
      - text: Get the machine-readable transaction harness.
      - text: List every transaction stage with its label and endpoints.
      method: generated
      generated: '2026-09-26'