Is the next eclipse visible from here

arazzo: 1.0.1
info:
  title: Is the next eclipse visible from here
  version: 1.0.0
  summary: >-
    Resolve an observer, then ask the eclipse endpoint for an explicit
    visible-from-here answer with local contact times.
sourceDescriptions:
- name: eclipsesApi
  url: ../openapi/cyclecalcs-eclipses-api-openapi.yml
  type: openapi
- name: placesApi
  url: ../openapi/cyclecalcs-places-api-openapi.yml
  type: openapi
workflows:
- workflowId: eclipseVisibleFromHere
  summary: Place name to a per-observer eclipse verdict.
  inputs:
    type: object
    required: [place]
    properties:
      place:
        type: string
        description: 'City or "City,CC", e.g. "Reykjavik,IS".'
      type:
        type: string
        description: solar | lunar
      count:
        type: integer
        description: How many eclipses to return.
  steps:
  - stepId: resolvePlace
    operationId: getPlaces
    parameters:
    - name: q
      in: query
      value: $inputs.place
    - name: limit
      in: query
      value: 1
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      lat: $response.body#/data/results/0/latitude
      lon: $response.body#/data/results/0/longitude
      tz: $response.body#/data/results/0/timezone
  - stepId: nextEclipses
    description: >-
      With lat/lon present the response carries local circumstances and an
      explicit visibility answer, not just global geometry.
    operationId: getEclipses
    parameters:
    - name: lat
      in: query
      value: $steps.resolvePlace.outputs.lat
    - name: lon
      in: query
      value: $steps.resolvePlace.outputs.lon
    - name: tz
      in: query
      value: $steps.resolvePlace.outputs.tz
    - name: type
      in: query
      value: $inputs.type
    - name: count
      in: query
      value: $inputs.count
    - name: direction
      in: query
      value: next
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      eclipses: $response.body#/data
  outputs:
    eclipses: $steps.nextEclipses.outputs.eclipses
x-generated: '2026-08-09'
x-method: generated