# 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 Spawn Garage V2 API
  version: 1.0.0
extends: openapi/thehiveryiq-com-spawn-garage-v2-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/morph/spawn/v2/scan'].post
  update:
    x-apievangelist-phrasing:
      intent: Run all spawn proposers once
      effect: write
      questions:
      - How do I generate fresh proposals for new agents to spawn?
      - Which signal sources feed the spawn proposal scan?
      instructions:
      - text: Run all four spawn proposers now.
      - text: Scan trail, fleet, arb and salvage sources for new spawn proposals.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/spawn/v2/proposals'].get
  update:
    x-apievangelist-phrasing:
      intent: List spawn proposals
      effect: read
      questions:
      - Which spawn proposals are waiting for a decision?
      - Can I filter spawn proposals by source or state?
      instructions:
      - text: List the newest spawn proposals.
      - text: Show up to {limit} spawn proposals from {source} in state {state}.
        slots:
          limit: query.limit
          source: query.source
          state: query.state
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/spawn/v2/promote'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve and promote a spawn proposal
      effect: write
      questions:
      - How do I approve a spawn proposal so the agent goes live?
      - What happens when the population is at its cap and I promote another proposal?
      instructions:
      - text: Promote spawn proposal {proposal_id}.
        slots:
          proposal_id: query.proposal_id
      - text: Approve {proposal_id} and retire a weak agent if the cap is full.
        slots:
          proposal_id: query.proposal_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/spawn/v2/reject'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a spawn proposal
      effect: destructive
      questions:
      - How do I turn down a spawn proposal?
      - Can I record a reason when rejecting a proposal?
      instructions:
      - text: Reject spawn proposal {proposal_id}.
        slots:
          proposal_id: query.proposal_id
      - text: Reject {proposal_id} because {reason}.
        slots:
          proposal_id: query.proposal_id
          reason: query.reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/spawn/v2/cap'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the agent population cap
      effect: read
      questions:
      - How many free slots are left under the agent population cap?
      - What did the last cull scan find?
      instructions:
      - text: Show the current population cap status.
      - text: Tell me how many spawn slots are free right now.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morph/spawn/v2/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get spawn proposal statistics
      effect: read
      questions:
      - How many spawn proposals have been promoted versus rejected?
      - What's the average time from proposal to promotion?
      instructions:
      - text: Get spawn proposal statistics.
      - text: Break down proposals by source and state with promotion counts.
      method: generated
      generated: '2026-09-26'