Hive Civilization · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Thehiveryiq Com Designer API

8 actions 8 updates phrasing extends openapi/thehiveryiq-com-designer-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['/v1/designer/chat'].post
$.paths['/v1/designer/mint'].post
$.paths['/v1/agents/{slug}/chat'].post
$.paths['/v1/designer/quota'].get
$.paths['/v1/designer/agents/{slug}'].get
$.paths['/v1/designer/agents'].get
$.paths['/v1/designer/admin/recover_mint'].post

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 Designer API
  version: 1.0.0
extends: openapi/thehiveryiq-com-designer-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/designer/chat'].post
  update:
    x-apievangelist-phrasing:
      intent: Chat with the agent designer wizard
      effect: write
      questions:
      - How do I design a new agent through a conversational wizard?
      - How many free designer turns do I get per day before paying?
      instructions:
      - text: Continue the agent designer wizard with messages {messages}.
        slots:
          messages: requestBody.messages
      - text: Send {messages} to the designer with draft spec {spec} at step {step_hint}.
        slots:
          messages: requestBody.messages
          spec: requestBody.spec
          step_hint: requestBody.step_hint
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/designer/mint'].post
  update:
    x-apievangelist-phrasing:
      intent: Mint and publish a finished agent design
      effect: write
      questions:
      - How do I publish the agent I designed so it can start earning?
      - Why does minting an agent need an EIP-712 signature from my wallet?
      instructions:
      - text: Mint agent spec {spec} for publisher {publisher_address} with signature {eip712_signature}.
        slots:
          spec: requestBody.spec
          publisher_address: requestBody.publisher_address
          eip712_signature: requestBody.eip712_signature
      - text: Publish my finalized agent {spec} to wallet {publisher_address}, signed {eip712_signature}.
        slots:
          spec: requestBody.spec
          publisher_address: requestBody.publisher_address
          eip712_signature: requestBody.eip712_signature
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/agents/{slug}/chat'].post
  update:
    x-apievangelist-phrasing:
      intent: Chat with a published designer agent
      effect: write
      questions:
      - How do I talk to an agent someone built and published with the designer?
      - What does each call to a published agent cost?
      instructions:
      - text: 'Chat with agent {slug}: {messages}.'
        slots:
          slug: path.slug
          messages: requestBody.messages
      - text: Send messages {messages} to the published agent {slug}.
        slots:
          messages: requestBody.messages
          slug: path.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/designer/quota'].get
  update:
    x-apievangelist-phrasing:
      intent: Check today's free designer quota
      effect: read
      questions:
      - How much of today's free designer quota is left?
      - Has the global daily free designer ceiling been hit?
      instructions:
      - text: Show today's designer free-quota state.
      - text: Check whether free designer turns remain today.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/designer/agents/{slug}'].get
  update:
    x-apievangelist-phrasing:
      intent: View a published designer agent's profile
      effect: read
      questions:
      - What is the public profile of a designer-built agent?
      - Can I look up a designed agent by its slug?
      instructions:
      - text: Show the public profile for designer agent {slug}.
        slots:
          slug: path.slug
      - text: Get designer agent {slug}.
        slots:
          slug: path.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/designer/agents'].get
  update:
    x-apievangelist-phrasing:
      intent: List recently minted designer agents
      effect: read
      questions:
      - Which agents have been minted with the designer most recently?
      - Can I limit how many recent designer agents are listed?
      instructions:
      - text: List the {limit} most recent designer agents.
        slots:
          limit: query.limit
      - text: Show recently published designer agents.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/designer/admin/recover_mint'].post
  update:
    x-apievangelist-phrasing:
      intent: Recover a paid mint that failed to persist
      effect: write
      questions:
      - Can an admin restore an agent mint from its payment transaction hash?
      - How do I recover a designer mint that was paid for but not saved?
      instructions:
      - text: Recover the mint of {spec} for {publisher_address} using payment tx {tx_hash}.
        slots:
          spec: requestBody.spec
          publisher_address: requestBody.publisher_address
          tx_hash: requestBody.tx_hash
      - text: Admin-recover mint tx {tx_hash} on {chain} for publisher {publisher_address} with spec {spec}.
        slots:
          tx_hash: requestBody.tx_hash
          chain: requestBody.chain
          publisher_address: requestBody.publisher_address
          spec: requestBody.spec
      method: generated
      generated: '2026-09-26'