API Evangelist conversational phrasing for Thehiveryiq Com Organic API

# 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 Organic API
  version: 1.0.0
extends: openapi/thehiveryiq-com-organic-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: 10
- target: $.paths['/v1/rosetta/normalize'].post
  update:
    x-apievangelist-phrasing:
      intent: Normalize free-form input to a canonical schema
      effect: read
      questions:
      - Can I turn a messy natural-language request into a canonical intent, quote or route?
      - How do I normalize input written in another locale into the canonical schema?
      instructions:
      - text: Normalize {input} into the canonical {target} schema.
        slots:
          input: requestBody.input
          target: requestBody.target
      - text: Normalize {input} written in locale {locale}.
        slots:
          input: requestBody.input
          locale: requestBody.locale
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/prospector/score'].post
  update:
    x-apievangelist-phrasing:
      intent: Score an agent's intent as a prospect
      effect: read
      questions:
      - How promising is an agent as a prospect given what it wants to do?
      - Can I get a prospector score for an agent DID and its stated intent?
      instructions:
      - text: Score agent {agent_did} as a prospect for intent {intent}.
        slots:
          agent_did: requestBody.agent_did
          intent: requestBody.intent
      - text: Rate prospect {agent_did} wanting {intent} given context {context}.
        slots:
          agent_did: requestBody.agent_did
          intent: requestBody.intent
          context: requestBody.context
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/hktn/lookup'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an HKTN registration
      effect: read
      questions:
      - What HKTN tier is an agent registered under?
      - Can I find an HKTN record by its hktn id or by agent DID?
      instructions:
      - text: Look up HKTN {hktn}.
        slots:
          hktn: query.hktn
      - text: Find the HKTN registration for agent {agent_did}.
        slots:
          agent_did: query.agent_did
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/hktn/register'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit an HKTN registration intent
      effect: write
      questions:
      - How does an agent register for an HKTN tier and see the x402 discount it could earn?
      - Can I self-claim a Warm or Hot HKTN tier when registering?
      instructions:
      - text: Register agent {agent_did} for HKTN.
        slots:
          agent_did: requestBody.agent_did
      - text: Register {agent_did} for HKTN requesting tier {requested_tier}, vouched by operator {operator_did}.
        slots:
          agent_did: requestBody.agent_did
          requested_tier: requestBody.requested_tier
          operator_did: requestBody.operator_did
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/rubric/select'].post
  update:
    x-apievangelist-phrasing:
      intent: Select the rubric for an intent
      effect: read
      questions:
      - Which evaluation rubric applies to a given intent and amount?
      - Can constraints change which rubric gets picked for my request?
      instructions:
      - text: Select a rubric for intent {intent}.
        slots:
          intent: requestBody.intent
      - text: Pick the rubric for {intent} at {amount_usd} USD with constraints {constraints}.
        slots:
          intent: requestBody.intent
          amount_usd: requestBody.amount_usd
          constraints: requestBody.constraints
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/settlement/reference'].get
  update:
    x-apievangelist-phrasing:
      intent: Generate a USDC settlement reference
      effect: read
      questions:
      - How do I get a settlement reference for paying an amount in USDC?
      - Can I attach a short memo to a USDC settlement reference?
      instructions:
      - text: Get a settlement reference for {amount_usdc} USDC.
        slots:
          amount_usdc: query.amount_usdc
      - text: Create a settlement reference for {amount_usdc} USDC with memo {memo}.
        slots:
          amount_usdc: query.amount_usdc
          memo: query.memo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/receipt/emit'].get
  update:
    x-apievangelist-phrasing:
      intent: Preflight the receipt emit endpoint
      effect: read
      questions:
      - What do I need to send before emitting a signed receipt?
      - Can I check what a given receipt profile requires without writing anything?
      instructions:
      - text: Preflight receipt emission.
      - text: Preflight emitting a {profile} receipt.
        slots:
          profile: query.profile
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/receipt/emit'].post
  update:
    x-apievangelist-phrasing:
      intent: Emit a signed receipt for an artifact
      effect: write
      questions:
      - How does an agent get a signed receipt over an artifact it produced?
      - Which receipt profiles exist, and when is a delegation envelope required?
      instructions:
      - text: Emit a receipt for artifact {artifact} from agent {agent_did}.
        slots:
          artifact: requestBody.artifact
          agent_did: requestBody.agent_did
      - text: Emit a post-quantum receipt for {artifact} from {agent_did} using envelope {regulated_envelope_jti} and profile {profile}.
        slots:
          artifact: requestBody.artifact
          agent_did: requestBody.agent_did
          regulated_envelope_jti: requestBody.regulated_envelope_jti
          profile: query.profile
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/receipt/benchmark'].get
  update:
    x-apievangelist-phrasing:
      intent: Benchmark the receipt signing path
      effect: read
      questions:
      - How long does it take to hash, sign and verify a receipt end to end?
      - Can I see per-phase timing for the post-quantum receipt profile?
      instructions:
      - text: Run the receipt benchmark.
      - text: Benchmark the {profile} receipt profile.
        slots:
          profile: query.profile
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/pricing'].get
  update:
    x-apievangelist-phrasing:
      intent: Get receipt and service pricing
      effect: read
      questions:
      - What are the published prices for Hive's receipt services?
      - Where is the pricing table for the core API?
      instructions:
      - text: Show the pricing table.
      - text: Get current service pricing.
      method: generated
      generated: '2026-09-26'