# 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 Model Receipts API
  version: 1.0.0
extends: openapi/thehiveryiq-com-model-receipts-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: 8
- target: $.paths['/v1/model-receipts/adapters'].get
  update:
    x-apievangelist-phrasing:
      intent: List registered model adapters
      effect: read
      questions:
      - Which model providers and models can I get signed receipts for?
      - What environment variable does each model adapter expect?
      instructions:
      - text: List every registered model-receipt adapter.
      - text: Show the provider/model adapters and their env var names.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/model-receipts/openrouter/models'].get
  update:
    x-apievangelist-phrasing:
      intent: Search OpenRouter models available for receipts
      effect: read
      questions:
      - Which OpenRouter models can I run through the receipt runner?
      - Can I search the OpenRouter model list by name and see which are prewired?
      instructions:
      - text: Search OpenRouter models matching {q}.
        slots:
          q: query.q
      - text: List the first {limit} OpenRouter models I can receipt.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/model-receipts/leanstral-demo'].get
  update:
    x-apievangelist-phrasing:
      intent: Run the Leanstral receipt demo
      effect: read
      questions:
      - Can I see a signed receipt for a Mistral Leanstral call on a Lean 4 prompt?
      - What does the Leanstral demo return when no Mistral key is configured?
      instructions:
      - text: Run the Leanstral 1.5 receipt demo.
      - text: Show me the default Lean 4 demo receipt.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/model-receipts/run'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a model call and get a signed receipt
      effect: write
      questions:
      - How do I get a signed receipt for a call to a specific model?
      - What prompt is used if I do not send one to the receipt runner?
      - Can I set max tokens and temperature on a receipted model call?
      instructions:
      - text: Run {model} on {provider} with prompt "{prompt}" and receipt it.
        slots:
          model: requestBody.model
          provider: requestBody.provider
          prompt: requestBody.prompt
      - text: Receipt a call to {model} capped at {max_tokens} tokens, temperature {temperature}.
        slots:
          model: requestBody.model
          max_tokens: requestBody.max_tokens
          temperature: requestBody.temperature
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/model-receipts/adapter-health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check live health of every model adapter
      effect: read
      questions:
      - Which model adapters are healthy and configured right now?
      - Is there a live health check across all receipt adapters?
      instructions:
      - text: Show live adapter health for model receipts.
      - text: Check which receipt adapters are currently working.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/model-receipts/demo-matrix'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the per-model demo matrix
      effect: read
      questions:
      - Where is the per-model demo matrix for model receipts?
      - Can I see a model-by-model demo grid of receipt support?
      instructions:
      - text: Get the model receipts demo matrix.
      - text: Show the per-model demo matrix view.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/model-receipts/smartmorph-route-demo'].get
  update:
    x-apievangelist-phrasing:
      intent: View the SmartMorph routing proof with built-in prompt
      effect: read
      questions:
      - Can I quickly see a SmartMorph route decision using the built-in prompt?
      - Is there a simple GET to trigger the SmartMorphAgent route demo?
      instructions:
      - text: Run the SmartMorph route demo with the built-in prompt via GET.
      - text: Show a quick SmartMorph routing proof.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/model-receipts/smartmorph-route-demo'].post
  update:
    x-apievangelist-phrasing:
      intent: Run the SmartMorph live route comparison
      effect: write
      questions:
      - How does SmartMorph compare live latency and token cost across models to pick a route?
      - Does the SmartMorph route proof sign a separate decision receipt?
      instructions:
      - text: Run the live SmartMorph route comparison and sign the decision receipt.
      - text: Compare Mistral and DeepInfra live and pick a route by the SmartMorph rules.
      method: generated
      generated: '2026-09-26'