naftiko: "1.0.0-alpha1"

info:
  name: APIPark Platform Management
  description: Manage services, AI models, teams, and subscribers across the APIPark developer platform
  version: 1.0.0

import:
  - name: apipark
    location: shared/platform.yaml

capability:
  exposes:
    - type: rest
      port: 8131
      namespace: apipark-platform-rest
      resources:
        - path: "/services"
          name: services
          label: "List Services"
          description: "List all API services published on the platform"
          operations:
            - method: GET
              call: apipark.listServices
              outputParameters:
                - type: array
                  mapping: "$."
                  items:
                    type: object

        - path: "/ai-models"
          name: aiModels
          label: "List AI Models"
          description: "List all AI models available on the platform"
          operations:
            - method: GET
              call: apipark.listAiModels
              outputParameters:
                - type: array
                  mapping: "$."
                  items:
                    type: object

        - path: "/teams"
          name: teams
          label: "List Teams"
          description: "List all teams registered on the platform"
          operations:
            - method: GET
              call: apipark.listTeams
              outputParameters:
                - type: array
                  mapping: "$."
                  items:
                    type: object

        - path: "/subscribers"
          name: subscribers
          label: "List Subscribers"
          description: "List all API subscribers on the platform"
          operations:
            - method: GET
              call: apipark.listSubscribers
              outputParameters:
                - type: array
                  mapping: "$."
                  items:
                    type: object

    - type: mcp
      address: "0.0.0.0"
      port: 9131
      namespace: apipark-management
      description: "APIPark platform management — discover services, inspect AI models, list teams, and manage subscribers"
      tools:
        - name: list-services
          description: "List all API services published on the APIPark developer platform"
          hints:
            readOnly: true
          call: apipark.listServices
          outputParameters:
            - type: array
              mapping: "$."
              items:
                type: object

        - name: create-service
          description: "Publish a new API service on the APIPark platform"
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: apipark.createService
          inputParameters:
            - name: body
              type: object
              required: true
              description: "Service definition including name, description, and API configuration"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-ai-models
          description: "List all AI models available on the APIPark platform including provider and capabilities"
          hints:
            readOnly: true
          call: apipark.listAiModels
          outputParameters:
            - type: array
              mapping: "$."
              items:
                type: object

        - name: list-teams
          description: "List all teams registered on the APIPark platform with their members and permissions"
          hints:
            readOnly: true
          call: apipark.listTeams
          outputParameters:
            - type: array
              mapping: "$."
              items:
                type: object

        - name: list-subscribers
          description: "List all API subscribers and their active subscriptions on the APIPark platform"
          hints:
            readOnly: true
          call: apipark.listSubscribers
          outputParameters:
            - type: array
              mapping: "$."
              items:
                type: object