naftiko: 1.0.0-alpha2
info:
  label: Spring Integration - Integration Monitoring
  description: Workflow capability for monitoring and managing Spring Integration message flows at runtime. Provides channel
    statistics, handler metrics, adapter lifecycle control, and integration flow graph visualization. Used by integration
    engineers, platform operations teams, and system administrators.
  tags:
  - Enterprise Integration
  - Integration
  - Management
  - Messaging
  - Monitoring
  - Spring
  created: '2026-05-02'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    SPRING_INTEGRATION_BASE_URL: SPRING_INTEGRATION_BASE_URL
capability:
  consumes:
  - type: http
    namespace: spring-integration-mgmt
    baseUri: '{{env.SPRING_INTEGRATION_BASE_URL}}/api'
    description: Spring Integration management REST API
    resources:
    - name: channels
      path: /channels
      description: Message channel statistics and listing
      operations:
      - name: list-channels
        method: GET
        description: List all message channels with statistics
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
        - name: size
          in: query
          type: integer
          required: false
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-channel
        method: GET
        description: Get channel details and statistics
        inputParameters:
        - name: name
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: handlers
      path: /handlers
      description: Message handler metrics
      operations:
      - name: list-handlers
        method: GET
        description: List all message handlers with metrics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-handler
        method: GET
        description: Get handler details and metrics
        inputParameters:
        - name: name
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: adapters
      path: /inboundChannelAdapters
      description: Inbound adapter lifecycle management
      operations:
      - name: list-adapters
        method: GET
        description: List all inbound channel adapters
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: control-adapter
        method: POST
        description: Start or stop an inbound adapter
        inputParameters:
        - name: name
          in: path
          type: string
          required: true
        body:
          type: json
          data:
            action: '{{tools.action}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: graph
      path: /graph
      description: Integration flow visualization graph
      operations:
      - name: get-graph
        method: GET
        description: Get the complete integration flow graph
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: integration-monitoring-api
    description: Unified REST API for Spring Integration monitoring and management.
    resources:
    - path: /v1/channels
      name: channels
      description: Message channel statistics and monitoring
      operations:
      - method: GET
        name: list-channels
        description: List all message channels with send counts and performance stats
        call: spring-integration-mgmt.list-channels
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/channels/{name}
      name: channel-detail
      description: Individual channel statistics
      operations:
      - method: GET
        name: get-channel
        description: Get detailed statistics for a specific channel
        call: spring-integration-mgmt.get-channel
        with:
          name: rest.name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/handlers
      name: handlers
      description: Message handler performance metrics
      operations:
      - method: GET
        name: list-handlers
        description: List all message handlers with handle counts and durations
        call: spring-integration-mgmt.list-handlers
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/adapters
      name: adapters
      description: Inbound adapter lifecycle management
      operations:
      - method: GET
        name: list-adapters
        description: List all inbound channel adapters and their running state
        call: spring-integration-mgmt.list-adapters
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/graph
      name: flow-graph
      description: Integration flow visualization
      operations:
      - method: GET
        name: get-flow-graph
        description: Get the complete integration flow graph
        call: spring-integration-mgmt.get-graph
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: integration-monitoring-mcp
    transport: http
    description: MCP server for AI-assisted Spring Integration monitoring and operations.
    tools:
    - name: list-message-channels
      description: List all Spring Integration message channels with send counts, error counts, and performance statistics
      hints:
        readOnly: true
        openWorld: true
      call: spring-integration-mgmt.list-channels
      outputParameters:
      - type: object
        mapping: $.
    - name: get-channel-statistics
      description: Get detailed runtime statistics for a specific Spring Integration message channel by name
      hints:
        readOnly: true
        openWorld: false
      call: spring-integration-mgmt.get-channel
      with:
        name: tools.channelName
      outputParameters:
      - type: object
        mapping: $.
    - name: list-message-handlers
      description: List all Spring Integration message handlers with handle counts and mean processing duration
      hints:
        readOnly: true
        openWorld: true
      call: spring-integration-mgmt.list-handlers
      outputParameters:
      - type: object
        mapping: $.
    - name: get-handler-metrics
      description: Get performance metrics for a specific Spring Integration message handler
      hints:
        readOnly: true
        openWorld: false
      call: spring-integration-mgmt.get-handler
      with:
        name: tools.handlerName
      outputParameters:
      - type: object
        mapping: $.
    - name: get-flow-graph
      description: Retrieve the complete Spring Integration message flow graph showing channels, handlers, and connections
      hints:
        readOnly: true
        openWorld: true
      call: spring-integration-mgmt.get-graph
      outputParameters:
      - type: object
        mapping: $.
    - name: start-inbound-adapter
      description: Start a stopped Spring Integration inbound channel adapter to resume message ingestion
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: spring-integration-mgmt.control-adapter
      with:
        name: tools.adapterName
        action: start
      outputParameters:
      - type: object
        mapping: $.
    - name: stop-inbound-adapter
      description: Stop a running Spring Integration inbound channel adapter to pause message ingestion
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: spring-integration-mgmt.control-adapter
      with:
        name: tools.adapterName
        action: stop
      outputParameters:
      - type: object
        mapping: $.