# 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 Stormlock API
  version: 1.0.0
extends: openapi/thehiveryiq-com-stormlock-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: 11
- target: $.paths['/v1/stormlock/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check StormLock service health
      effect: read
      questions:
      - Is the StormLock parametric insurance service up?
      - How do I health-check StormLock?
      instructions:
      - text: Check StormLock health.
      - text: Ping the parametric policy receipt service.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/stormlock/pricing'].get
  update:
    x-apievangelist-phrasing:
      intent: Get StormLock pricing
      effect: read
      questions:
      - How much does each StormLock attestation cost?
      - What are the prices for recording parametric policy events?
      instructions:
      - text: Show StormLock pricing.
      - text: List the price of each parametric attestation type.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/stormlock/bind_attest'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a parametric policy bind
      effect: write
      questions:
      - How do I record that a parametric catastrophe policy has been bound?
      - Can I include the cedent, carrier and reinsurer when attesting a bind?
      instructions:
      - text: Record the bind of policy {policy_did} for peril {peril_class} with threshold {threshold_spec}.
        slots:
          policy_did: requestBody.policy_did
          peril_class: requestBody.peril_class
          threshold_spec: requestBody.threshold_spec
      - text: Attest binding policy {policy_did} ({peril_class}, threshold {threshold_spec}) at {bound_notional_usdc} USDC notional.
        slots:
          policy_did: requestBody.policy_did
          peril_class: requestBody.peril_class
          threshold_spec: requestBody.threshold_spec
          bound_notional_usdc: requestBody.bound_notional_usdc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/stormlock/oracle_subscribe'].post
  update:
    x-apievangelist-phrasing:
      intent: Register an oracle for a policy
      effect: write
      questions:
      - How do I attach a weather oracle to a parametric policy?
      - Which oracle feeds are registered to a policy?
      instructions:
      - text: Subscribe oracle {oracle_did} to policy {policy_did}.
        slots:
          oracle_did: requestBody.oracle_did
          policy_did: requestBody.policy_did
      - text: Register {oracle_did} as the data oracle for policy {policy_did}.
        slots:
          oracle_did: requestBody.oracle_did
          policy_did: requestBody.policy_did
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/stormlock/oracle_reading_attest'].post
  update:
    x-apievangelist-phrasing:
      intent: Record an oracle reading for a policy
      effect: write
      questions:
      - How do I log a wind speed reading from an oracle against a policy?
      - Can I record raw oracle readings without evaluating the trigger yet?
      instructions:
      - text: Record oracle {oracle_did} reading {oracle_reading_payload} for policy {policy_did}.
        slots:
          oracle_did: requestBody.oracle_did
          oracle_reading_payload: requestBody.oracle_reading_payload
          policy_did: requestBody.policy_did
      - text: Attest a single reading {oracle_reading_payload} from {oracle_did} on policy {policy_did}.
        slots:
          oracle_reading_payload: requestBody.oracle_reading_payload
          oracle_did: requestBody.oracle_did
          policy_did: requestBody.policy_did
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/stormlock/trigger_eval_attest'].post
  update:
    x-apievangelist-phrasing:
      intent: Evaluate a policy trigger against a reading
      effect: write
      questions:
      - Did this oracle reading breach the policy's parametric threshold?
      - How do I evaluate and record whether a trigger fired?
      instructions:
      - text: Evaluate reading {oracle_reading_payload} against threshold {threshold_spec} for policy {policy_did}.
        slots:
          oracle_reading_payload: requestBody.oracle_reading_payload
          threshold_spec: requestBody.threshold_spec
          policy_did: requestBody.policy_did
      - text: Check whether policy {policy_did} triggered given {oracle_reading_payload} and {threshold_spec}, and record the result.
        slots:
          policy_did: requestBody.policy_did
          oracle_reading_payload: requestBody.oracle_reading_payload
          threshold_spec: requestBody.threshold_spec
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/stormlock/loss_calc_attest'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a loss calculation and payout amount
      effect: write
      questions:
      - How do I record the calculated payout after a parametric trigger fires?
      - Can a loss calculation be recorded if the trigger result is false?
      instructions:
      - text: 'Record a loss calc for policy {policy_did}: trigger {trigger_result}, payout {payout_amount_usdc} USDC, result {loss_calc_result}.'
        slots:
          policy_did: requestBody.policy_did
          trigger_result: requestBody.trigger_result
          payout_amount_usdc: requestBody.payout_amount_usdc
          loss_calc_result: requestBody.loss_calc_result
      - text: Attest {payout_amount_usdc} USDC calculated loss on {policy_did} with trigger {trigger_result} and calc {loss_calc_result}.
        slots:
          payout_amount_usdc: requestBody.payout_amount_usdc
          policy_did: requestBody.policy_did
          trigger_result: requestBody.trigger_result
          loss_calc_result: requestBody.loss_calc_result
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/stormlock/payout_auth_attest'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a payout authorization
      effect: write
      questions:
      - How do I record that a policy payout was authorized from treasury?
      - Can I note which treasury sub-account funds the payout?
      instructions:
      - text: Authorize a {payout_amount_usdc} USDC payout on policy {policy_did}.
        slots:
          payout_amount_usdc: requestBody.payout_amount_usdc
          policy_did: requestBody.policy_did
      - text: Record payout authorization of {payout_amount_usdc} USDC for {policy_did} to cedent {cedent_did} from sub-account {treasury_sub_account}.
        slots:
          payout_amount_usdc: requestBody.payout_amount_usdc
          policy_did: requestBody.policy_did
          cedent_did: requestBody.cedent_did
          treasury_sub_account: requestBody.treasury_sub_account
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/stormlock/reinsurance_settle_attest'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a reinsurance settlement leg
      effect: write
      questions:
      - How do I log the reinsurer's settlement leg on a parametric policy?
      - Can I record the amount a reinsurer settled with the carrier?
      instructions:
      - text: Record the reinsurance settlement for policy {policy_did}.
        slots:
          policy_did: requestBody.policy_did
      - text: Attest reinsurer {reinsurer_did} settling {settle_amount_usdc} USDC with carrier {carrier_did} on {policy_did}.
        slots:
          reinsurer_did: requestBody.reinsurer_did
          settle_amount_usdc: requestBody.settle_amount_usdc
          carrier_did: requestBody.carrier_did
          policy_did: requestBody.policy_did
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/stormlock/dispute_attest'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a dispute on a policy
      effect: write
      questions:
      - How do I open a dispute on a parametric policy outcome?
      - Can the dispute record include who is disputing and on what grounds?
      instructions:
      - text: Open a dispute on policy {policy_did}.
        slots:
          policy_did: requestBody.policy_did
      - text: 'Record that {disputing_party_did} disputes policy {policy_did} on grounds: {dispute_grounds}.'
        slots:
          disputing_party_did: requestBody.disputing_party_did
          policy_did: requestBody.policy_did
          dispute_grounds: requestBody.dispute_grounds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/stormlock/chain_verify'].get
  update:
    x-apievangelist-phrasing:
      intent: Verify a policy's receipt chain
      effect: read
      questions:
      - Is the full receipt chain for a policy intact and validly signed?
      - How can I audit every event recorded against a policy in order?
      instructions:
      - text: Verify the receipt chain for policy {policy_did}.
        slots:
          policy_did: query.policy_did
      - text: Show the ordered receipts and signature validity for {policy_did}.
        slots:
          policy_did: query.policy_did
      method: generated
      generated: '2026-09-26'