# 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 Morph API
  version: 1.0.0
extends: openapi/thehiveryiq-com-morph-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: 25
- target: $.paths['/v1/morph/offer'].post
  update:
    x-apievangelist-phrasing:
      intent: Request a Morph offer for an agent intent
      effect: write
      questions:
      - How do I get a HiveMorph offer token for what my agent wants to do?
      - What happens when an offer request fails one of the three gates?
      - Can I bundle several asks of different kinds into one offer request?
      instructions:
      - text: Request a Morph offer for intent "{intent_text}" from counterparty {counterparty_did}.
        slots:
          intent_text: requestBody.intent_text
          counterparty_did: requestBody.counterparty_did
      - text: Ask Morph for an offer covering {asks} for {counterparty_did} with intent "{intent_text}".
        slots:
          asks: requestBody.asks
          counterparty_did: requestBody.counterparty_did
          intent_text: requestBody.intent_text
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/settle/{token_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Settle a reserved Morph offer
      effect: write
      questions:
      - How do I commit the reservation behind a Morph offer token?
      - Does settling an offer write a final receipt to the audit chain?
      instructions:
      - text: Settle Morph token {token_id} using reservation {reservation_id}.
        slots:
          token_id: path.token_id
          reservation_id: requestBody.reservation_id
      - text: Commit reservation {reservation_id} for offer token {token_id} and finalize it.
        slots:
          reservation_id: requestBody.reservation_id
          token_id: path.token_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/audit/recent'].get
  update:
    x-apievangelist-phrasing:
      intent: Show the latest Morph audit chain entries
      effect: read
      questions:
      - Where can I see the most recent rows in the Morph audit chain?
      - How many audit chain entries does the recent audit view return?
      instructions:
      - text: Show me the last 50 Morph audit chain rows.
      - text: Pull the recent Morph audit log so I can check what just settled.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/identity/{mii_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an agent's spectral identity card
      effect: read
      questions:
      - What does an agent's spectral identity card include, like tier, wings and sound?
      - Can I get the identity card for a specific shape such as Provenancer?
      - Which tier is my agent's MII in?
      instructions:
      - text: Get the spectral identity card for MII {mii_id}.
        slots:
          mii_id: path.mii_id
      - text: Show the identity card for MII {mii_id} rendered as the {shape} shape.
        slots:
          mii_id: path.mii_id
          shape: query.shape
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/supermodels'].get
  update:
    x-apievangelist-phrasing:
      intent: List all supermodel character cards
      effect: read
      questions:
      - Which supermodel characters does HiveMorph have and what role does each play?
      - Can I hide the treasury and cold-reserve supermodels from a buyer-facing list?
      instructions:
      - text: List every supermodel character card.
      - text: List the supermodels with include_cold set to {include_cold}.
        slots:
          include_cold: query.include_cold
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/supermodels/{name_or_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one supermodel card by name or id
      effect: read
      questions:
      - What is the tagline, motto and palette of the MERCHANT supermodel?
      - Can I look up a single supermodel by its W-number id?
      instructions:
      - text: Show the supermodel card for {name_or_id}.
        slots:
          name_or_id: path.name_or_id
      - text: Fetch the capabilities and bio of supermodel {name_or_id}.
        slots:
          name_or_id: path.name_or_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/carousel'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the cross-sell carousel for a shape
      effect: read
      questions:
      - Can I discover the full vertical menu without minting an offer token first?
      - What cross-sell contrails appear alongside a given primary shape?
      instructions:
      - text: Get the carousel cross-sell list for primary shape {primary}.
        slots:
          primary: query.primary
      - text: Show the default Morph carousel of verticals.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/brood/pending-approvals'].get
  update:
    x-apievangelist-phrasing:
      intent: List variants awaiting manual approval
      effect: read
      questions:
      - Which brood variants are still waiting for me to approve them?
      - Are there any proposed variants sitting in the approval queue?
      instructions:
      - text: List all brood variants in proposed state awaiting approval.
      - text: Show my pending variant approval queue.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/brood/conversion'].get
  update:
    x-apievangelist-phrasing:
      intent: View the brood conversion ledger
      effect: read
      questions:
      - How are my variants converting by parent, variant and kit version?
      - Can I filter the conversion ledger down to one supermodel's brood?
      instructions:
      - text: Show the brood conversion ledger for supermodel {supermodel}.
        slots:
          supermodel: query.supermodel
      - text: Pull the full conversion ledger across all broods.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/brood/all'].get
  update:
    x-apievangelist-phrasing:
      intent: List every brood and its variants
      effect: read
      questions:
      - What broods exist and which variants belong to each?
      - Where can I see all supermodel broods at once?
      instructions:
      - text: List every brood with its variants.
      - text: Give me an overview of all supermodel broods.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/brood/conversion-leaderboard'].get
  update:
    x-apievangelist-phrasing:
      intent: Rank variants by revenue per offer
      effect: read
      questions:
      - Which variants earn the most revenue per offer shown?
      - Can I exclude variants with too few offers from the conversion ranking?
      instructions:
      - text: Show the conversion leaderboard, only counting variants with at least {min_offers} offers.
        slots:
          min_offers: query.min_offers
      - text: Rank my brood variants by revenue per offer.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/brood/spawn-from-proposal'].post
  update:
    x-apievangelist-phrasing:
      intent: Stage a spawn-monitor proposal as a variant
      effect: write
      questions:
      - How do I turn a spawn-monitor proposal into a proposed variant?
      - Will a variant staged from a radar proposal get auto-approved?
      instructions:
      - text: Stage the spawn-monitor proposal for parent {parent_id} with signal {signal} as a proposed variant.
        slots:
          parent_id: requestBody.parent_id
          signal: requestBody.signal
      - text: Stage a proposal for parent {parent_id} on signal {signal} with rationale "{rationale}".
        slots:
          parent_id: requestBody.parent_id
          signal: requestBody.signal
          rationale: requestBody.rationale
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/brood/{supermodel}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one brood's parent and variants
      effect: read
      questions:
      - What variants are in the PROVENANCER brood right now?
      - Can I look up a single brood by W-id or supermodel name?
      instructions:
      - text: Show the brood for supermodel {supermodel}.
        slots:
          supermodel: path.supermodel
      - text: Get the parent and variants of brood {supermodel}.
        slots:
          supermodel: path.supermodel
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/brood/{supermodel}/spawn'].post
  update:
    x-apievangelist-phrasing:
      intent: Propose a new variant for a brood
      effect: write
      questions:
      - How do I propose a new variant with different kit deltas for a supermodel's brood?
      - When does a newly spawned variant skip the proposed state?
      instructions:
      - text: Spawn a new variant in brood {supermodel}.
        slots:
          supermodel: path.supermodel
      - text: Spawn variant {variant_label} in brood {supermodel} with kit deltas {kit_deltas}.
        slots:
          variant_label: requestBody.variant_label
          supermodel: path.supermodel
          kit_deltas: requestBody.kit_deltas
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/brood/variant/{variant_id}/approve'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve a proposed variant by id
      effect: write
      questions:
      - How do I approve a proposed variant so traffic starts routing to it?
      - Can I approve a variant by id alone, without naming its supermodel?
      instructions:
      - text: Approve variant {variant_id} so it starts receiving traffic.
        slots:
          variant_id: path.variant_id
      - text: Move proposed variant {variant_id} to approved.
        slots:
          variant_id: path.variant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/brood/{supermodel}/variant/{variant_id}/approve'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve a variant within a named brood
      effect: write
      questions:
      - Can I approve a variant while checking it really belongs to a given supermodel?
      - Is there a brood-scoped way to approve a variant?
      instructions:
      - text: Approve variant {variant_id} in brood {supermodel}, confirming it belongs there.
        slots:
          variant_id: path.variant_id
          supermodel: path.supermodel
      - text: In the {supermodel} brood, approve variant {variant_id}.
        slots:
          supermodel: path.supermodel
          variant_id: path.variant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/brood/variant/{variant_id}/promote'].post
  update:
    x-apievangelist-phrasing:
      intent: Promote a variant to the new baseline
      effect: write
      questions:
      - How do I hot-swap a winning variant in as the new baseline?
      - What happens to sibling variants when one gets promoted?
      instructions:
      - text: Promote variant {variant_id} to be the new baseline.
        slots:
          variant_id: path.variant_id
      - text: Make approved variant {variant_id} the baseline and cull its siblings.
        slots:
          variant_id: path.variant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/brood/{supermodel}/variant/{variant_id}/promote'].post
  update:
    x-apievangelist-phrasing:
      intent: Promote a variant within a named brood
      effect: write
      questions:
      - Can I promote a variant while verifying it belongs to a specific supermodel's brood?
      - Is there a brood-scoped version of the promote action?
      instructions:
      - text: Promote variant {variant_id} in brood {supermodel} to baseline.
        slots:
          variant_id: path.variant_id
          supermodel: path.supermodel
      - text: In the {supermodel} brood, promote variant {variant_id}.
        slots:
          supermodel: path.supermodel
          variant_id: path.variant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/brood/variant/{variant_id}/cull'].post
  update:
    x-apievangelist-phrasing:
      intent: Cull a variant so it stops getting traffic
      effect: destructive
      questions:
      - How do I stop a losing variant from receiving traffic?
      - Can I cull a variant that has already been promoted to baseline?
      instructions:
      - text: Cull variant {variant_id}.
        slots:
          variant_id: path.variant_id
      - text: Mark variant {variant_id} as culled so traffic stops routing to it.
        slots:
          variant_id: path.variant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/brood/{supermodel}/variant/{variant_id}/cull'].post
  update:
    x-apievangelist-phrasing:
      intent: Cull a variant within a named brood
      effect: destructive
      questions:
      - Can I cull a variant while checking it belongs to a given supermodel?
      - Is there a brood-scoped way to cull a variant?
      instructions:
      - text: Cull variant {variant_id} in brood {supermodel}.
        slots:
          variant_id: path.variant_id
          supermodel: path.supermodel
      - text: In the {supermodel} brood, stop traffic to variant {variant_id}.
        slots:
          supermodel: path.supermodel
          variant_id: path.variant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/spawn-monitor/scan'].get
  update:
    x-apievangelist-phrasing:
      intent: Preview spawn proposals from the monitor
      effect: read
      questions:
      - What variant proposals would the spawn monitor emit right now?
      - Can I change how far back the spawn monitor looks for signals?
      instructions:
      - text: Run a read-only spawn monitor scan.
      - text: Scan for spawn proposals over the last {lookback_sec} seconds.
        slots:
          lookback_sec: query.lookback_sec
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/money-flavor/probe'].get
  update:
    x-apievangelist-phrasing:
      intent: Probe how a payment envelope would be priced
      effect: read
      questions:
      - Would a counterparty's payment be accepted, and at what price multiplier, before anything is minted?
      - How does asset or chain change the money-flavor classification?
      instructions:
      - text: Probe the money flavor for counterparty {counterparty_did}.
        slots:
          counterparty_did: query.counterparty_did
      - text: Check the flavor and multiplier for {counterparty_did} paying in {asset} on {chain}.
        slots:
          counterparty_did: query.counterparty_did
          asset: query.asset
          chain: query.chain
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/money-flavor/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get aggregate money-flavor statistics
      effect: read
      questions:
      - What mix of money flavors has come through recently?
      - Can I set the time window used for flavor statistics?
      instructions:
      - text: Show money flavor stats for the last {window_sec} seconds.
        slots:
          window_sec: query.window_sec
      - text: Summarize recent money flavor classifications from the audit chain.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/auto-cull/scan'].get
  update:
    x-apievangelist-phrasing:
      intent: Preview which variants would be auto-culled
      effect: read
      questions:
      - Which variants are losing badly enough to be culled?
      - Can I see the auto-cull candidates without changing anything?
      instructions:
      - text: List the variants that the auto-cull would remove.
      - text: Scan for auto-cull candidates without mutating anything.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/auto-cull/run'].post
  update:
    x-apievangelist-phrasing:
      intent: Run the auto-cull on losing variants
      effect: destructive
      questions:
      - How do I actually cull all losing variants in one go?
      - Does the auto-cull run default to a dry run?
      instructions:
      - text: Run the auto-cull with dry_run set to {dry_run}.
        slots:
          dry_run: query.dry_run
      - text: Produce the auto-cull plan for losers as a dry run.
      method: generated
      generated: '2026-09-26'