EVE Online ESI — User Interface

naftiko: 1.0.0-alpha2
info:
  label: EVE Online ESI — User Interface
  description: 'ESI — User Interface. 5 operations. Lead operation: EVE Online Set Autopilot Waypoint. Self-contained Naftiko capability covering one EVE Online business surface.'
  tags:
    - EVE Online
    - ESI
    - User Interface
  created: '2026-05-30'
  modified: '2026-05-30'
binds:
  - namespace: env
    keys:
      EVE_ONLINE_ACCESS_TOKEN: EVE_ONLINE_ACCESS_TOKEN
capability:
  consumes:
    - type: http
      namespace: eve-online-user-interface
      baseUri: https://esi.evetech.net/latest
      description: EVE Online ESI — User Interface business capability. Self-contained, no shared references.
      authentication:
        type: bearer
        token: '{{env.EVE_ONLINE_ACCESS_TOKEN}}'
      resources:
        - name: ui-autopilot-waypoint
          path: /ui/autopilot/waypoint/
          operations:
            - name: post_ui_autopilot_waypoint
              method: POST
              description: EVE Online Set Autopilot Waypoint
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: add_to_beginning
                  in: query
                  type: boolean
                  required: true
                  description: Whether this solar system should be added to the beginning of all waypoints
                - name: clear_other_waypoints
                  in: query
                  type: boolean
                  required: true
                  description: Whether clean other waypoints beforing adding this one
                - name: destination_id
                  in: query
                  type: integer
                  required: true
                  description: The destination to travel to, can be solar system, station or structure's id
        - name: ui-openwindow-contract
          path: /ui/openwindow/contract/
          operations:
            - name: post_ui_openwindow_contract
              method: POST
              description: EVE Online Open Contract Window
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: contract_id
                  in: query
                  type: integer
                  required: true
                  description: The contract to open
        - name: ui-openwindow-information
          path: /ui/openwindow/information/
          operations:
            - name: post_ui_openwindow_information
              method: POST
              description: EVE Online Open Information Window
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: target_id
                  in: query
                  type: integer
                  required: true
                  description: The target to open
        - name: ui-openwindow-marketdetails
          path: /ui/openwindow/marketdetails/
          operations:
            - name: post_ui_openwindow_marketdetails
              method: POST
              description: EVE Online Open Market Details
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: type_id
                  in: query
                  type: integer
                  required: true
                  description: The item type to open in market window
        - name: ui-openwindow-newmail
          path: /ui/openwindow/newmail/
          operations:
            - name: post_ui_openwindow_newmail
              method: POST
              description: EVE Online Open New Mail Window
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
                  description: Request body payload.
  exposes:
    - type: rest
      namespace: eve-online-user-interface-rest
      port: 8080
      description: REST adapter for EVE Online ESI — User Interface. One Spectral-compliant resource per consumed operation, prefixed with /v1.
      resources:
        - path: /v1/ui/autopilot/waypoint
          name: ui-autopilot-waypoint
          description: REST surface for /ui/autopilot/waypoint/.
          operations:
            - method: POST
              name: post_ui_autopilot_waypoint
              description: EVE Online Set Autopilot Waypoint
              call: eve-online-user-interface.post_ui_autopilot_waypoint
              with:
                add_to_beginning: rest.add_to_beginning
                clear_other_waypoints: rest.clear_other_waypoints
                destination_id: rest.destination_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/ui/openwindow/contract
          name: ui-openwindow-contract
          description: REST surface for /ui/openwindow/contract/.
          operations:
            - method: POST
              name: post_ui_openwindow_contract
              description: EVE Online Open Contract Window
              call: eve-online-user-interface.post_ui_openwindow_contract
              with:
                contract_id: rest.contract_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/ui/openwindow/information
          name: ui-openwindow-information
          description: REST surface for /ui/openwindow/information/.
          operations:
            - method: POST
              name: post_ui_openwindow_information
              description: EVE Online Open Information Window
              call: eve-online-user-interface.post_ui_openwindow_information
              with:
                target_id: rest.target_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/ui/openwindow/marketdetails
          name: ui-openwindow-marketdetails
          description: REST surface for /ui/openwindow/marketdetails/.
          operations:
            - method: POST
              name: post_ui_openwindow_marketdetails
              description: EVE Online Open Market Details
              call: eve-online-user-interface.post_ui_openwindow_marketdetails
              with:
                type_id: rest.type_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/ui/openwindow/newmail
          name: ui-openwindow-newmail
          description: REST surface for /ui/openwindow/newmail/.
          operations:
            - method: POST
              name: post_ui_openwindow_newmail
              description: EVE Online Open New Mail Window
              call: eve-online-user-interface.post_ui_openwindow_newmail
              with:
                body: rest.body
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: eve-online-user-interface-mcp
      port: 9090
      transport: http
      description: MCP adapter for EVE Online ESI — User Interface. One tool per consumed operation, routed inline through this capability's consumes block.
      tools:
        - name: set-autopilot-waypoint
          description: EVE Online Set Autopilot Waypoint
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: eve-online-user-interface.post_ui_autopilot_waypoint
          with:
            add_to_beginning: tools.add_to_beginning
            clear_other_waypoints: tools.clear_other_waypoints
            destination_id: tools.destination_id
          outputParameters:
            - type: object
              mapping: $.
        - name: open-contract-window
          description: EVE Online Open Contract Window
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: eve-online-user-interface.post_ui_openwindow_contract
          with:
            contract_id: tools.contract_id
          outputParameters:
            - type: object
              mapping: $.
        - name: open-information-window
          description: EVE Online Open Information Window
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: eve-online-user-interface.post_ui_openwindow_information
          with:
            target_id: tools.target_id
          outputParameters:
            - type: object
              mapping: $.
        - name: open-market-details
          description: EVE Online Open Market Details
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: eve-online-user-interface.post_ui_openwindow_marketdetails
          with:
            type_id: tools.type_id
          outputParameters:
            - type: object
              mapping: $.
        - name: open-new-mail-window
          description: EVE Online Open New Mail Window
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: eve-online-user-interface.post_ui_openwindow_newmail
          with:
            body: tools.body
          outputParameters:
            - type: object
              mapping: $.