# 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 Salvage API
  version: 1.0.0
extends: openapi/thehiveryiq-com-salvage-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: 23
- target: $.paths['/v1/salvage/listener/observe'].post
  update:
    x-apievangelist-phrasing:
      intent: Inject a failure signal for a transaction
      effect: write
      questions:
      - How do I manually feed a transaction signal into the Salvage listener from an external source?
      - Can I report that a transaction reverted along with the proof type and signal source?
      instructions:
      - text: Inject a signal for transaction {tx_id} from source {source_id} of type {source_type} with proof {proof_type}.
        slots:
          tx_id: requestBody.tx_id
          source_id: requestBody.source_id
          source_type: requestBody.source_type
          proof_type: requestBody.proof_type
      - text: Record that transaction {tx_id} has status {tx_status}, observed by {source_id} ({source_type}) with {proof_type} proof.
        slots:
          tx_id: requestBody.tx_id
          tx_status: requestBody.tx_status
          source_id: requestBody.source_id
          source_type: requestBody.source_type
          proof_type: requestBody.proof_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/listener/observe/bridge'].post
  update:
    x-apievangelist-phrasing:
      intent: Report a cross-chain bridge observation
      effect: write
      questions:
      - How do I tell Salvage a bridge transfer left the source chain but never arrived at the destination?
      - Is there a shorthand for reporting bridge transfers without building a full signal?
      instructions:
      - text: 'Report bridge transaction {tx_id} from {source_chain} to {dest_chain}: source confirmed {source_confirmed}, arrived {dest_arrived}.'
        slots:
          tx_id: requestBody.tx_id
          source_chain: requestBody.source_chain
          dest_chain: requestBody.dest_chain
          source_confirmed: requestBody.source_confirmed
          dest_arrived: requestBody.dest_arrived
      - text: Flag bridge transfer {tx_id} from {source_chain} to {dest_chain} as confirmed at source ({source_confirmed}) but not arrived ({dest_arrived}).
        slots:
          tx_id: requestBody.tx_id
          source_chain: requestBody.source_chain
          dest_chain: requestBody.dest_chain
          source_confirmed: requestBody.source_confirmed
          dest_arrived: requestBody.dest_arrived
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/listener/queue'].get
  update:
    x-apievangelist-phrasing:
      intent: List verified failures awaiting recovery
      effect: read
      questions:
      - Which verified transaction failures are still waiting to be recovered?
      - What's in the listener queue right now?
      instructions:
      - text: Show me the verified failures waiting in the recovery queue.
      - text: List every failed transaction the listener has verified but not yet recovered.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/listener/sources'].get
  update:
    x-apievangelist-phrasing:
      intent: View the signal source trust registry
      effect: read
      questions:
      - How much does Salvage trust each of my signal sources?
      - Where can I see the registry of signal sources and their trust levels?
      instructions:
      - text: Show the trust registry for all signal sources.
      - text: List the signal sources the listener knows about and their trust standing.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/listener/quarantine'].get
  update:
    x-apievangelist-phrasing:
      intent: List permanently quarantined signal sources
      effect: read
      questions:
      - Which signal sources have been permanently quarantined?
      - Has any of my feeds been banned from submitting signals?
      instructions:
      - text: List the quarantined signal sources.
      - text: Show me every signal source that has been permanently quarantined.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/recovery/file'].post
  update:
    x-apievangelist-phrasing:
      intent: File a recovery claim for a failed transaction
      effect: write
      questions:
      - How do I file a claim to recover funds from a failed transaction?
      - Can I set a commission rate when filing a recovery claim?
      - What happens if the claim ID I pass doesn't match the computed deterministic ID?
      instructions:
      - text: File a recovery claim for transaction {tx_id} worth {amount_usd} USD for victim wallet {victim_wallet}, claimant {claimant_did} against {counterparty_did}.
        slots:
          tx_id: requestBody.tx_id
          amount_usd: requestBody.amount_usd
          victim_wallet: requestBody.victim_wallet
          claimant_did: requestBody.claimant_did
          counterparty_did: requestBody.counterparty_did
      - text: File claim {claim_id} on transaction {tx_id} for {amount_usd} USD, wallet {victim_wallet}, claimant {claimant_did} vs {counterparty_did}.
        slots:
          claim_id: query.claim_id
          tx_id: requestBody.tx_id
          amount_usd: requestBody.amount_usd
          victim_wallet: requestBody.victim_wallet
          claimant_did: requestBody.claimant_did
          counterparty_did: requestBody.counterparty_did
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/recovery/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of a recovery claim
      effect: read
      questions:
      - Where does my recovery claim stand right now?
      - Has my salvage claim been settled or is it still in negotiation?
      instructions:
      - text: Check the status of recovery claim {claim_id}.
        slots:
          claim_id: query.claim_id
      - text: Tell me where claim {claim_id} is in the recovery process.
        slots:
          claim_id: query.claim_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/recovery/auto'].post
  update:
    x-apievangelist-phrasing:
      intent: Auto-process the top verified failures
      effect: write
      questions:
      - Can I automatically process the top verified failures in the queue instead of filing claims one by one?
      - How many queued failures can I batch into recovery at once?
      instructions:
      - text: Auto-process the top {n} verified failures from the queue.
        slots:
          n: requestBody.n
      - text: Run automatic recovery on the top {n} queued failures as claimant {claimant_did}.
        slots:
          n: requestBody.n
          claimant_did: requestBody.claimant_did
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/recovery/agents'].get
  update:
    x-apievangelist-phrasing:
      intent: View the recovery agent roster
      effect: read
      questions:
      - Which recovery agents are active and how large are their bonds?
      - Is any recovery agent currently suspended, and what are their clean streaks?
      instructions:
      - text: Show the recovery agent roster with bonds and suspension status.
      - text: List all recovery agents with their clean streaks.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/recovery/slash'].post
  update:
    x-apievangelist-phrasing:
      intent: Slash an agent's bond for a fraudulent claim
      effect: destructive
      questions:
      - How do I emergency-slash a recovery agent's bond for fraud?
      - What happens to an agent when its bond is slashed?
      instructions:
      - text: Slash the bond of agent {agent_id} because {reason}.
        slots:
          agent_id: requestBody.agent_id
          reason: requestBody.reason
      - text: Suspend recovery agent {agent_id} and slash its full bond, citing {reason}.
        slots:
          agent_id: requestBody.agent_id
          reason: requestBody.reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/reinforcement/risk'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the risk score for an agent or counterparty
      effect: read
      questions:
      - How risky is a given agent or counterparty according to the reinforcement layer?
      - What risk score has Salvage assigned to this counterparty?
      instructions:
      - text: Get the risk score for agent {agent_id}.
        slots:
          agent_id: query.agent_id
      - text: How risky is counterparty {agent_id}? Pull its reinforcement score.
        slots:
          agent_id: query.agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/reinforcement/patterns'].get
  update:
    x-apievangelist-phrasing:
      intent: View clustered transaction failure patterns
      effect: read
      questions:
      - What recurring failure patterns has the Pattern Analyzer found?
      - Are my transaction failures clustering around common causes?
      instructions:
      - text: Show the clustered failure patterns.
      - text: List the failure clusters identified by the Pattern Analyzer.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/reinforcement/run'].get
  update:
    x-apievangelist-phrasing:
      intent: Run a full reinforcement cycle
      effect: write
      questions:
      - Can I trigger a full analyze, score and bond-proposal cycle on demand?
      - How do I refresh risk scores and bond proposals in one pass?
      instructions:
      - text: Run a full reinforcement cycle now.
      - text: Analyze failures, rescore agents and propose new bonds in one reinforcement run.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/reinforcement/bond_proposals'].get
  update:
    x-apievangelist-phrasing:
      intent: List pending bond adjustment proposals
      effect: read
      questions:
      - Which HiveBond adjustments are waiting for human approval?
      - What bond changes has the reinforcement system proposed?
      instructions:
      - text: Show pending bond adjustment proposals.
      - text: List the HiveBond proposals awaiting my approval.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/fleet/preset'].post
  update:
    x-apievangelist-phrasing:
      intent: Instantiate a named salvage fleet preset
      effect: write
      questions:
      - Which fleet presets can I spin up, like salvage_starter or salvage_standard?
      - Why does the salvage_tier2_blocked preset always fail?
      instructions:
      - text: Instantiate the {name} fleet preset.
        slots:
          name: query.name
      - text: Spin up a salvage fleet using preset {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/fleet/projections'].get
  update:
    x-apievangelist-phrasing:
      intent: Project daily earnings for the fleet
      effect: read
      questions:
      - How much could my salvage fleet earn per day at its current configuration?
      - Can I project daily revenue for a preset at a given daily volume?
      instructions:
      - text: Project fleet earnings per day at {daily_volume_usd} USD daily volume.
        slots:
          daily_volume_usd: query.daily_volume_usd
      - text: Show projected dollars per day for preset {preset}.
        slots:
          preset: query.preset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/self_tune/tick'].post
  update:
    x-apievangelist-phrasing:
      intent: Run the fleet self-tune rules once
      effect: write
      questions:
      - How do I run the fleet self-tune rules from a cron job?
      - Which self-tune rules fire when false positives spike?
      instructions:
      - text: Run one self-tune tick.
      - text: Run a self-tune tick with {false_positive_count} false positives out of {total_signals} signals.
        slots:
          false_positive_count: requestBody.false_positive_count
          total_signals: requestBody.total_signals
      - text: Self-tune the fleet given {claims_resolved_last_hour} claims resolved last hour and arbitration queue depth {arb_queue_depth}.
        slots:
          claims_resolved_last_hour: requestBody.claims_resolved_last_hour
          arb_queue_depth: requestBody.arb_queue_depth
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/self_tune/state'].get
  update:
    x-apievangelist-phrasing:
      intent: View fleet self-tune state and history
      effect: read
      questions:
      - What has the fleet self-tuner changed recently?
      - Where can I see the self-tune tick history?
      instructions:
      - text: Show the current self-tune state and tick history.
      - text: List past self-tune ticks and what each one changed.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/economics'].get
  update:
    x-apievangelist-phrasing:
      intent: View live salvage economics and tier progress
      effect: read
      questions:
      - What is the salvage operation actually earning per day versus projections?
      - How close is the fleet to its next tier target?
      instructions:
      - text: Show live salvage economics, projected versus actual.
      - text: Report tier progress and anti-bloat status for the salvage operation.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/compliance/queue'].get
  update:
    x-apievangelist-phrasing:
      intent: List frozen claims awaiting compliance review
      effect: read
      questions:
      - Which recovery claims are frozen pending human compliance review?
      - Do I have any frozen claims that need a reviewer?
      instructions:
      - text: Show the frozen claims in the compliance queue.
      - text: List claims waiting for a human compliance reviewer.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/compliance/review'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a compliance review outcome for a claim
      effect: write
      questions:
      - How do I clear a frozen claim after reviewing it?
      - Can I mark a frozen claim as confirmed fraud?
      instructions:
      - text: Mark frozen claim {claim_id} as {outcome}.
        slots:
          claim_id: requestBody.claim_id
          outcome: requestBody.outcome
      - text: Record reviewer {reviewer}'s outcome {outcome} on frozen claim {claim_id}.
        slots:
          reviewer: requestBody.reviewer
          outcome: requestBody.outcome
          claim_id: requestBody.claim_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/registry'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the full append-only claim registry
      effect: read
      questions:
      - Where can I see every recovery claim ever filed?
      - Is the claim registry append-only?
      instructions:
      - text: Pull the full claim registry.
      - text: Export every entry in the append-only salvage claim registry.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/salvage/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get salvage totals, commission and hit rate
      effect: read
      questions:
      - How much has been recovered in total and what commission was earned?
      - What's the claim hit rate and dead-letter count?
      instructions:
      - text: 'Show salvage stats: total recovered, commission, and hit rate.'
      - text: Summarize listener, recovery, reinforcement and compliance numbers.
      method: generated
      generated: '2026-09-26'