Collins Aerospace Flight Operations

naftiko: "1.0.0-alpha1"

info:
  label: "Collins Aerospace Flight Operations"
  description: >-
    Unified workflow capability for aviation flight operations using FlightAware
    AeroAPI. Enables airlines, ground handlers, flight departments, and technology
    providers to track flights in real-time, monitor airport conditions, manage
    flight alerts, analyze operator fleet activity, and access historical flight
    data for operational planning, resource management, and maintenance scheduling.
  tags:
    - Aviation
    - Flight Operations
    - Aerospace
    - Collins Aerospace
    - FlightAware
    - Flight Tracking
  created: "2026-05-02"
  modified: "2026-05-02"

binds:
  - namespace: env
    keys:
      FLIGHTAWARE_API_KEY: FLIGHTAWARE_API_KEY

capability:
  consumes:
    - import: aeroapi
      location: ./shared/aeroapi.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: flight-operations-api
      description: "Unified REST API for aviation flight operations monitoring and planning."
      resources:
        - path: /v1/flights
          name: flights
          description: "Flight search and real-time tracking"
          operations:
            - method: GET
              name: search-flights
              description: "Search for airborne flights by criteria including location, airline, and aircraft type"
              call: "aeroapi.search-flights"
              with:
                query: "rest.query"
                max_pages: "rest.max_pages"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/flights/{ident}
          name: flight-detail
          description: "Specific flight information"
          operations:
            - method: GET
              name: get-flight
              description: "Get detailed information for a specific flight"
              call: "aeroapi.get-flight"
              with:
                ident: "rest.ident"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/flight-positions/{fa_flight_id}
          name: flight-position
          description: "Current flight position data"
          operations:
            - method: GET
              name: get-flight-position
              description: "Get current real-time position for a flight"
              call: "aeroapi.get-flight-position"
              with:
                fa_flight_id: "rest.fa_flight_id"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/flight-tracks/{fa_flight_id}
          name: flight-track
          description: "Flight position track history"
          operations:
            - method: GET
              name: get-flight-track
              description: "Get position track of a flight"
              call: "aeroapi.get-flight-track"
              with:
                fa_flight_id: "rest.fa_flight_id"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/airports
          name: airports
          description: "Airport directory and information"
          operations:
            - method: GET
              name: list-airports
              description: "Get a list of all airports"
              call: "aeroapi.get-all-airports"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/airports/{id}
          name: airport-detail
          description: "Individual airport information"
          operations:
            - method: GET
              name: get-airport
              description: "Get static information about an airport"
              call: "aeroapi.get-airport"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/airport-delays
          name: airport-delays
          description: "Airport delay monitoring"
          operations:
            - method: GET
              name: get-all-delays
              description: "Get delay information for all airports with current delays"
              call: "aeroapi.get-airport-delays"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/airport-weather/{id}
          name: airport-weather
          description: "Airport weather conditions"
          operations:
            - method: GET
              name: get-airport-weather
              description: "Get current weather conditions for an airport"
              call: "aeroapi.get-airport-weather"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/operators/{id}
          name: operator-detail
          description: "Airline and operator information"
          operations:
            - method: GET
              name: get-operator
              description: "Get information about a specific operator"
              call: "aeroapi.get-operator"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/alerts
          name: alerts
          description: "Flight event alert management"
          operations:
            - method: GET
              name: list-alerts
              description: "List all configured flight alerts"
              call: "aeroapi.get-all-alerts"
              outputParameters:
                - type: object
                  mapping: "$."

            - method: POST
              name: create-alert
              description: "Create a new flight event alert"
              call: "aeroapi.create-alert"
              with:
                ident: "rest.ident"
                events: "rest.events"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9080
      namespace: flight-operations-mcp
      transport: http
      description: "MCP server for AI-assisted aviation flight operations and planning."
      tools:
        - name: search-flights
          description: "Search for airborne flights by location, airline, aircraft type, or route"
          hints:
            readOnly: true
            openWorld: true
          call: "aeroapi.search-flights"
          with:
            query: "tools.query"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-flight
          description: "Get detailed information for a specific flight including status, route, and timing"
          hints:
            readOnly: true
            openWorld: false
          call: "aeroapi.get-flight"
          with:
            ident: "tools.ident"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-flight-position
          description: "Get the current real-time position and altitude for a flight"
          hints:
            readOnly: true
            openWorld: false
          call: "aeroapi.get-flight-position"
          with:
            fa_flight_id: "tools.fa_flight_id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-flight-track
          description: "Get the full position track history of a flight"
          hints:
            readOnly: true
            openWorld: false
          call: "aeroapi.get-flight-track"
          with:
            fa_flight_id: "tools.fa_flight_id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-flight-route
          description: "Get the filed route for a specific flight"
          hints:
            readOnly: true
            openWorld: false
          call: "aeroapi.get-flight-route"
          with:
            fa_flight_id: "tools.fa_flight_id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-airport
          description: "Get detailed information about an airport by ICAO or IATA code"
          hints:
            readOnly: true
            openWorld: false
          call: "aeroapi.get-airport"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-airport-delays
          description: "Get current delay information for a specific airport"
          hints:
            readOnly: true
            openWorld: false
          call: "aeroapi.get-airport-delays"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-airport-flights
          description: "Get all flights arriving or departing from an airport"
          hints:
            readOnly: true
            openWorld: false
          call: "aeroapi.get-airport-flights"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-airport-weather
          description: "Get current weather conditions and forecast for an airport"
          hints:
            readOnly: true
            openWorld: false
          call: "aeroapi.get-airport-weather"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-operator
          description: "Get information about an airline or operator including fleet and routes"
          hints:
            readOnly: true
            openWorld: false
          call: "aeroapi.get-operator"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-operator-flights
          description: "Get all current flights for an operator/airline"
          hints:
            readOnly: true
            openWorld: false
          call: "aeroapi.get-operator-flights"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-alerts
          description: "List all configured flight event alerts"
          hints:
            readOnly: true
            openWorld: true
          call: "aeroapi.get-all-alerts"
          outputParameters:
            - type: object
              mapping: "$."

        - name: create-alert
          description: "Create a new flight event alert for departure, arrival, or route changes"
          hints:
            readOnly: false
            destructive: false
          call: "aeroapi.create-alert"
          with:
            ident: "tools.ident"
            events: "tools.events"
          outputParameters:
            - type: object
              mapping: "$."

        - name: delete-alert
          description: "Delete a configured flight event alert"
          hints:
            readOnly: false
            destructive: true
            idempotent: true
          call: "aeroapi.delete-alert"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."