# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Dynamicfeed Ai Robot API
  version: 1.0.0
extends: openapi/dynamicfeed-ai-robot-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 10
- target: $.paths['/v1/anchor/daily'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the RFC 3161 anchor for a day's snapshot
      effect: read
      questions:
      - Is each day's world-state snapshot timestamped so I can prove what was reported?
      - Can I fetch the daily anchor proof for a past date?
      instructions:
      - text: Get the daily anchor proof for {date}.
        slots:
          date: query.date
      - text: Anchor today's world-state snapshot and return its timestamp proof.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/awareness'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a go/no-go verdict for a robot at a location
      effect: read
      questions:
      - Can one call tell my robot whether it is safe to operate at a location?
      - What happens to the verdict when some feeds time out and the snapshot is degraded?
      - Which robot classes does situational awareness support?
      instructions:
      - text: Get a situational-awareness verdict for my orbital robot at its current location.
      - text: Run a general awareness check for any robot class at these coordinates.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/preflight'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a drone pre-flight safety check
      effect: read
      questions:
      - Is it safe to fly my drone here right now given wind, air quality and space weather?
      - Does the drone pre-flight check consider GPS integrity?
      instructions:
      - text: Run a drone pre-flight check at my launch site.
      - text: Give me a take-off verdict for my aerial drone at these coordinates.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/road'].post
  update:
    x-apievangelist-phrasing:
      intent: Check road hazards for an autonomous vehicle
      effect: read
      questions:
      - Are there weather or earthquake hazards along my autonomous vehicle's route?
      - What go or no-go verdict does the ground vehicle check return?
      instructions:
      - text: Run a road hazard check for my ground vehicle at this location.
      - text: Check over-the-horizon hazards for an autonomous car near these coordinates.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/humanoid'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a humanoid robot pre-operation check
      effect: read
      questions:
      - Is it safe for my humanoid robot to work among people given wind and icy ground?
      - Which conditions does the humanoid check weigh, like topple risk and slipping?
      instructions:
      - text: Run a humanoid pre-operation check at this site.
      - text: Give my bipedal robot a go or no-go verdict for its work location.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/marine'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a marine vessel pre-operation check
      effect: read
      questions:
      - Is wave height too high for my uncrewed surface vessel to operate today?
      - Does the marine check account for tsunami risk from nearby earthquakes?
      instructions:
      - text: Run a marine pre-operation check for my vessel at these coordinates.
      - text: Get a go or no-go verdict for my USV based on waves and wind.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/robot-receipt'].post
  update:
    x-apievangelist-phrasing:
      intent: Witness a robot decision as a black-box receipt
      effect: write
      questions:
      - Can I record a signed black-box receipt of what my robot was told when it acted?
      - Do I have to send raw sensor data to create a robot decision receipt?
      instructions:
      - text: Create a robot receipt for my drone's last decision from its hashed inputs.
      - text: Witness this embodied-AI decision as a signed black-box record.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/robot-receipt/sample'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a sample robot decision receipt
      effect: read
      questions:
      - What does a robot black-box receipt look like?
      - Is there a demo robot receipt I can verify in the browser?
      instructions:
      - text: Show me a sample robot receipt.
      - text: Get the demo robot-receipt/v1 for testing verification.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/anchor'].post
  update:
    x-apievangelist-phrasing:
      intent: Timestamp a snapshot hash with RFC 3161
      effect: write
      questions:
      - Can I get an independent RFC 3161 timestamp token proving a record existed at a time?
      - Can I timestamp just a SHA-256 digest instead of the whole snapshot?
      instructions:
      - text: Timestamp this snapshot's hash with an independent authority.
      - text: Anchor my SHA-256 digest with an RFC 3161 timestamp token.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/anchor/upgrade'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-check a stored timestamp proof
      effect: read
      questions:
      - Can I re-check an old OpenTimestamps proof against its block attestation?
      - Do RFC 3161 timestamp tokens ever need upgrading?
      instructions:
      - text: Re-check my stored timestamp token.
      - text: Upgrade my legacy OpenTimestamps proof to its block attestation.
      method: generated
      generated: '2026-10-01'