naftiko: 1.0.0-alpha2
info:
  label: Visteon Phoenix API — Media
  description: 'Visteon Phoenix API — Media. 2 operations. Lead operation: Browse Media Library. Self-contained Naftiko capability
    covering one Visteon business surface.'
  tags:
  - Visteon
  - Media
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    VISTEON_API_KEY: VISTEON_API_KEY
capability:
  consumes:
  - type: http
    namespace: phoenix-media
    baseUri: https://developer.visteon.com/phoenix/api
    description: Visteon Phoenix API — Media business capability. Self-contained, no shared references.
    resources:
    - name: media-library
      path: /media/library
      operations:
      - name: browsemedialibrary
        method: GET
        description: Browse Media Library
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: type
          in: query
          type: string
          description: Filter by media type (music, video, photos)
        - name: offset
          in: query
          type: integer
          description: Pagination offset
        - name: limit
          in: query
          type: integer
          description: Number of items per page
    - name: media-nowplaying
      path: /media/nowplaying
      operations:
      - name: getnowplaying
        method: GET
        description: Get Now Playing
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: X-Phoenix-API-Key
      value: '{{env.VISTEON_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: phoenix-media-rest
    port: 8080
    description: REST adapter for Visteon Phoenix API — Media. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/media/library
      name: media-library
      description: REST surface for media-library.
      operations:
      - method: GET
        name: browsemedialibrary
        description: Browse Media Library
        call: phoenix-media.browsemedialibrary
        with:
          type: rest.type
          offset: rest.offset
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/media/nowplaying
      name: media-nowplaying
      description: REST surface for media-nowplaying.
      operations:
      - method: GET
        name: getnowplaying
        description: Get Now Playing
        call: phoenix-media.getnowplaying
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: phoenix-media-mcp
    port: 9090
    transport: http
    description: MCP adapter for Visteon Phoenix API — Media. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: browse-media-library
      description: Browse Media Library
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: phoenix-media.browsemedialibrary
      with:
        type: tools.type
        offset: tools.offset
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: get-now-playing
      description: Get Now Playing
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: phoenix-media.getnowplaying
      outputParameters:
      - type: object
        mapping: $.