Plan a port-to-port route, predict ETA and check active tropical cyclones

# authorship: generated by API Evangelist tooling. Stamped 2026-08-18
# on the file's own generator header (roadmap#64). An unmarked file is
# NOT assumed to be ours -- absence of evidence was never stamped.
x-method: generated
arazzo: 1.0.1
info:
  title: Plan a port-to-port route, predict ETA and check active tropical cyclones
  version: 1.0.0
  description: Native Arazzo workflow over the ShipFinder Global Maritime Data API. Generated by API Evangelist on 2026-08-09; every operationId is verified against openapi/shipfinder-ais-data-api-openapi.yml.
  x-realizes-capability-ids:
  - BC-2510.30
  x-capability-derivation:
    method: 'deterministic join: sourceDescriptions -> per-tag OpenAPI -> tag/capability edge. No classification at this step.'
    min_confidence: 0.7
    sources:
    - capability_id: BC-2510.30
      capability_name: ETA Prediction Management
      spec: shipfinder-ais-data-api-prediction-dataset-api-openapi.yml
      confidence: 0.72
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: meteorologyDatasetApi
  url: ../openapi/shipfinder-ais-data-api-meteorology-dataset-api-openapi.yml
  type: openapi
- name: predictionDatasetApi
  url: ../openapi/shipfinder-ais-data-api-prediction-dataset-api-openapi.yml
  type: openapi
workflows:
- workflowId: voyagePlanAndEta
  summary: Plan a port-to-port route, predict ETA and check active tropical cyclones
  inputs:
    type: object
    required:
    - apiKey
    - startPortCode
    - endPortCode
    - mmsi
    properties:
      apiKey:
        type: string
        description: ShipFinder API key
      startPortCode:
        type: string
        description: Origin UN/LOCODE
      endPortCode:
        type: string
        description: Destination UN/LOCODE
      mmsi:
        type: string
        description: MMSI of the vessel on the voyage
  steps:
  - stepId: route
    operationId: getRoutePlanPortToPort
    parameters:
    - name: key
      in: query
      value: $inputs.apiKey
    - name: start_port_code
      in: query
      value: $inputs.startPortCode
    - name: end_port_code
      in: query
      value: $inputs.endPortCode
    successCriteria:
    - condition: $statusCode == 200
    - context: $response.body
      condition: $.status == 0
      type: jsonpath
    outputs:
      route: $response.body#/data
  - stepId: eta
    operationId: getETA
    parameters:
    - name: key
      in: query
      value: $inputs.apiKey
    - name: mmsi
      in: query
      value: $inputs.mmsi
    successCriteria:
    - condition: $statusCode == 200
    - context: $response.body
      condition: $.status == 0
      type: jsonpath
    outputs:
      eta: $response.body#/data
  - stepId: cyclones
    operationId: getCyclonesList
    parameters:
    - name: key
      in: query
      value: $inputs.apiKey
    successCriteria:
    - condition: $statusCode == 200
    - context: $response.body
      condition: $.status == 0
      type: jsonpath
    outputs:
      cyclones: $response.body#/data
  outputs:
    cyclones: $steps.cyclones.outputs.cyclones