naftiko: 1.0.0-alpha2
info:
  label: Langflow Monitor
  description: 'Langflow Monitor. 15 operations. Lead operation: Delete Vertex Builds. Self-contained Naftiko capability covering
    one Langflow business surface.'
  tags:
  - Langflow
  - Monitor
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys:
    LANGFLOW_API_KEY: LANGFLOW_API_KEY
    LANGFLOW_BASE_URL: LANGFLOW_BASE_URL
capability:
  consumes:
  - type: http
    namespace: monitor
    baseUri: '{{env.LANGFLOW_BASE_URL}}'
    description: Langflow Monitor business capability.
    resources:
    - name: api-v1-monitor-builds
      path: /api/v1/monitor/builds
      operations:
      - name: delete-vertex-builds
        method: DELETE
        description: Delete Vertex Builds
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: flow_id
          in: query
          type: string
          description: flow_id parameter.
          required: true
      - name: get-vertex-builds
        method: GET
        description: Get Vertex Builds
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: flow_id
          in: query
          type: string
          description: flow_id parameter.
          required: true
    - name: api-v1-monitor-messages
      path: /api/v1/monitor/messages
      operations:
      - name: delete-messages
        method: DELETE
        description: Delete Messages
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: get-messages
        method: GET
        description: Get Messages
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: flow_id
          in: query
          type: string
          description: flow_id parameter.
          required: false
        - name: session_id
          in: query
          type: string
          description: session_id parameter.
          required: false
        - name: sender
          in: query
          type: string
          description: sender parameter.
          required: false
        - name: sender_name
          in: query
          type: string
          description: sender_name parameter.
          required: false
        - name: order_by
          in: query
          type: string
          description: order_by parameter.
          required: false
    - name: api-v1-monitor-messages-session-old-session-id
      path: /api/v1/monitor/messages/session/{old_session_id}
      operations:
      - name: update-session-id
        method: PATCH
        description: Update Session Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: old_session_id
          in: path
          type: string
          description: old_session_id parameter.
          required: true
        - name: new_session_id
          in: query
          type: string
          description: The new session ID to update to
          required: true
    - name: api-v1-monitor-messages-session-session-id
      path: /api/v1/monitor/messages/session/{session_id}
      operations:
      - name: delete-messages-session
        method: DELETE
        description: Delete Messages Session
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: session_id parameter.
          required: true
    - name: api-v1-monitor-messages-sessions
      path: /api/v1/monitor/messages/sessions
      operations:
      - name: delete-messages-sessions
        method: DELETE
        description: Delete Messages Sessions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: get-message-sessions
        method: GET
        description: Get Message Sessions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: flow_id
          in: query
          type: string
          description: flow_id parameter.
          required: false
    - name: api-v1-monitor-messages-shared
      path: /api/v1/monitor/messages/shared
      operations:
      - name: get-shared-messages
        method: GET
        description: Get Shared Messages
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: source_flow_id
          in: query
          type: string
          description: The original public flow ID
          required: true
        - name: session_id
          in: query
          type: string
          description: session_id parameter.
          required: false
        - name: order_by
          in: query
          type: string
          description: order_by parameter.
          required: false
    - name: api-v1-monitor-messages-shared-session-old-session-id
      path: /api/v1/monitor/messages/shared/session/{old_session_id}
      operations:
      - name: rename-shared-session
        method: PATCH
        description: Rename Shared Session
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: old_session_id
          in: path
          type: string
          description: old_session_id parameter.
          required: true
        - name: new_session_id
          in: query
          type: string
          description: The new session ID
          required: true
        - name: source_flow_id
          in: query
          type: string
          description: The original public flow ID
          required: true
    - name: api-v1-monitor-messages-shared-session-session-id
      path: /api/v1/monitor/messages/shared/session/{session_id}
      operations:
      - name: delete-shared-messages-session
        method: DELETE
        description: Delete Shared Messages Session
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: session_id
          in: path
          type: string
          description: session_id parameter.
          required: true
        - name: source_flow_id
          in: query
          type: string
          description: The original public flow ID
          required: true
    - name: api-v1-monitor-messages-shared-sessions
      path: /api/v1/monitor/messages/shared/sessions
      operations:
      - name: get-shared-message-sessions
        method: GET
        description: Get Shared Message Sessions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: source_flow_id
          in: query
          type: string
          description: The original public flow ID
          required: true
    - name: api-v1-monitor-messages-shared-message-id
      path: /api/v1/monitor/messages/shared/{message_id}
      operations:
      - name: update-shared-message
        method: PUT
        description: Update Shared Message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: message_id
          in: path
          type: string
          description: message_id parameter.
          required: true
        - name: source_flow_id
          in: query
          type: string
          description: The original public flow ID
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-monitor-messages-message-id
      path: /api/v1/monitor/messages/{message_id}
      operations:
      - name: update-message
        method: PUT
        description: Update Message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: message_id
          in: path
          type: string
          description: message_id parameter.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-monitor-transactions
      path: /api/v1/monitor/transactions
      operations:
      - name: get-transactions
        method: GET
        description: Get Transactions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: flow_id
          in: query
          type: string
          description: flow_id parameter.
          required: true
        - name: page
          in: query
          type: integer
          description: Page number
          required: false
        - name: size
          in: query
          type: integer
          description: Page size
          required: false
    authentication:
      type: apikey
      key: x-api-key
      value: '{{env.LANGFLOW_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: monitor-rest
    port: 8080
    description: REST adapter for Langflow Monitor.
    resources:
    - path: /v1/api/v1/monitor/builds
      name: api-v1-monitor-builds
      description: REST surface for /api/v1/monitor/builds.
      operations:
      - method: DELETE
        name: delete-vertex-builds
        description: Delete Vertex Builds
        call: monitor.delete-vertex-builds
        with:
          flow_id: rest.flow_id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: get-vertex-builds
        description: Get Vertex Builds
        call: monitor.get-vertex-builds
        with:
          flow_id: rest.flow_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/monitor/messages
      name: api-v1-monitor-messages
      description: REST surface for /api/v1/monitor/messages.
      operations:
      - method: DELETE
        name: delete-messages
        description: Delete Messages
        call: monitor.delete-messages
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: get-messages
        description: Get Messages
        call: monitor.get-messages
        with:
          flow_id: rest.flow_id
          session_id: rest.session_id
          sender: rest.sender
          sender_name: rest.sender_name
          order_by: rest.order_by
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/monitor/messages/session/{old_session_id}
      name: api-v1-monitor-messages-session-old-session-id
      description: REST surface for /api/v1/monitor/messages/session/{old_session_id}.
      operations:
      - method: PATCH
        name: update-session-id
        description: Update Session Id
        call: monitor.update-session-id
        with:
          old_session_id: rest.old_session_id
          new_session_id: rest.new_session_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/monitor/messages/session/{session_id}
      name: api-v1-monitor-messages-session-session-id
      description: REST surface for /api/v1/monitor/messages/session/{session_id}.
      operations:
      - method: DELETE
        name: delete-messages-session
        description: Delete Messages Session
        call: monitor.delete-messages-session
        with:
          session_id: rest.session_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/monitor/messages/sessions
      name: api-v1-monitor-messages-sessions
      description: REST surface for /api/v1/monitor/messages/sessions.
      operations:
      - method: DELETE
        name: delete-messages-sessions
        description: Delete Messages Sessions
        call: monitor.delete-messages-sessions
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: get-message-sessions
        description: Get Message Sessions
        call: monitor.get-message-sessions
        with:
          flow_id: rest.flow_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/monitor/messages/shared
      name: api-v1-monitor-messages-shared
      description: REST surface for /api/v1/monitor/messages/shared.
      operations:
      - method: GET
        name: get-shared-messages
        description: Get Shared Messages
        call: monitor.get-shared-messages
        with:
          source_flow_id: rest.source_flow_id
          session_id: rest.session_id
          order_by: rest.order_by
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/monitor/messages/shared/session/{old_session_id}
      name: api-v1-monitor-messages-shared-session-old-session-id
      description: REST surface for /api/v1/monitor/messages/shared/session/{old_session_id}.
      operations:
      - method: PATCH
        name: rename-shared-session
        description: Rename Shared Session
        call: monitor.rename-shared-session
        with:
          old_session_id: rest.old_session_id
          new_session_id: rest.new_session_id
          source_flow_id: rest.source_flow_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/monitor/messages/shared/session/{session_id}
      name: api-v1-monitor-messages-shared-session-session-id
      description: REST surface for /api/v1/monitor/messages/shared/session/{session_id}.
      operations:
      - method: DELETE
        name: delete-shared-messages-session
        description: Delete Shared Messages Session
        call: monitor.delete-shared-messages-session
        with:
          session_id: rest.session_id
          source_flow_id: rest.source_flow_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/monitor/messages/shared/sessions
      name: api-v1-monitor-messages-shared-sessions
      description: REST surface for /api/v1/monitor/messages/shared/sessions.
      operations:
      - method: GET
        name: get-shared-message-sessions
        description: Get Shared Message Sessions
        call: monitor.get-shared-message-sessions
        with:
          source_flow_id: rest.source_flow_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/monitor/messages/shared/{message_id}
      name: api-v1-monitor-messages-shared-message-id
      description: REST surface for /api/v1/monitor/messages/shared/{message_id}.
      operations:
      - method: PUT
        name: update-shared-message
        description: Update Shared Message
        call: monitor.update-shared-message
        with:
          message_id: rest.message_id
          source_flow_id: rest.source_flow_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/monitor/messages/{message_id}
      name: api-v1-monitor-messages-message-id
      description: REST surface for /api/v1/monitor/messages/{message_id}.
      operations:
      - method: PUT
        name: update-message
        description: Update Message
        call: monitor.update-message
        with:
          message_id: rest.message_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/monitor/transactions
      name: api-v1-monitor-transactions
      description: REST surface for /api/v1/monitor/transactions.
      operations:
      - method: GET
        name: get-transactions
        description: Get Transactions
        call: monitor.get-transactions
        with:
          flow_id: rest.flow_id
          page: rest.page
          size: rest.size
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: monitor-mcp
    port: 9090
    transport: http
    description: MCP adapter for Langflow Monitor. One tool per consumed operation.
    tools:
    - name: langflow-delete-vertex-builds
      description: Delete Vertex Builds
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: monitor.delete-vertex-builds
      with:
        flow_id: tools.flow_id
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-get-vertex-builds
      description: Get Vertex Builds
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: monitor.get-vertex-builds
      with:
        flow_id: tools.flow_id
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-delete-messages
      description: Delete Messages
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: monitor.delete-messages
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-get-messages
      description: Get Messages
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: monitor.get-messages
      with:
        flow_id: tools.flow_id
        session_id: tools.session_id
        sender: tools.sender
        sender_name: tools.sender_name
        order_by: tools.order_by
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-update-session-id
      description: Update Session Id
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: monitor.update-session-id
      with:
        old_session_id: tools.old_session_id
        new_session_id: tools.new_session_id
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-delete-messages-session
      description: Delete Messages Session
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: monitor.delete-messages-session
      with:
        session_id: tools.session_id
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-delete-messages-sessions
      description: Delete Messages Sessions
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: monitor.delete-messages-sessions
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-get-message-sessions
      description: Get Message Sessions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: monitor.get-message-sessions
      with:
        flow_id: tools.flow_id
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-get-shared-messages
      description: Get Shared Messages
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: monitor.get-shared-messages
      with:
        source_flow_id: tools.source_flow_id
        session_id: tools.session_id
        order_by: tools.order_by
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-rename-shared-session
      description: Rename Shared Session
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: monitor.rename-shared-session
      with:
        old_session_id: tools.old_session_id
        new_session_id: tools.new_session_id
        source_flow_id: tools.source_flow_id
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-delete-shared-messages-session
      description: Delete Shared Messages Session
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: monitor.delete-shared-messages-session
      with:
        session_id: tools.session_id
        source_flow_id: tools.source_flow_id
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-get-shared-message-sessions
      description: Get Shared Message Sessions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: monitor.get-shared-message-sessions
      with:
        source_flow_id: tools.source_flow_id
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-update-shared-message
      description: Update Shared Message
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: monitor.update-shared-message
      with:
        message_id: tools.message_id
        source_flow_id: tools.source_flow_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-update-message
      description: Update Message
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: monitor.update-message
      with:
        message_id: tools.message_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langflow-get-transactions
      description: Get Transactions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: monitor.get-transactions
      with:
        flow_id: tools.flow_id
        page: tools.page
        size: tools.size
      outputParameters:
      - type: object
        mapping: $.