UiPath Automation Governance

naftiko: "1.0.0-alpha1"

info:
  label: "UiPath Automation Governance"
  description: "Unified workflow for automation governance combining Automation Hub for pipeline management, Platform Management for user and license administration, and Test Manager for quality assurance. Used by Center of Excellence managers and platform administrators overseeing the enterprise automation program."
  tags:
    - UiPath
    - Automation Governance
    - Center of Excellence
    - Platform Administration
    - Licensing
    - Quality Assurance
  created: "2026-05-03"
  modified: "2026-05-03"

binds:
  - namespace: env
    keys:
      UIPATH_AUTOMATION_HUB_API_KEY: UIPATH_AUTOMATION_HUB_API_KEY
      UIPATH_BEARER_TOKEN: UIPATH_BEARER_TOKEN

capability:
  consumes:
    - import: automation-hub
      location: ./shared/automation-hub.yaml
    - import: platform-management
      location: ./shared/platform-management.yaml
    - import: test-manager
      location: ./shared/test-manager.yaml

  exposes:
    - type: rest
      port: 8082
      namespace: automation-governance-api
      description: "Unified REST API for automation governance across Automation Hub, Platform Management, and Test Manager."
      resources:
        - path: /v1/automation-ideas
          name: automation-ideas
          description: "Automation idea pipeline management"
          operations:
            - method: GET
              name: list-automations
              description: "List automation ideas in the pipeline"
              call: "automation-hub.list-automations"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: create-automation-idea
              description: "Submit a new automation idea"
              call: "automation-hub.create-automation-idea"
              with:
                name: "rest.name"
                description: "rest.description"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/pipeline
          name: pipeline
          description: "Automation pipeline overview"
          operations:
            - method: GET
              name: get-pipeline
              description: "Get automation pipeline status"
              call: "automation-hub.get-automation-pipeline"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/users
          name: users
          description: "Platform user management"
          operations:
            - method: POST
              name: create-user
              description: "Create a platform user"
              call: "platform-management.create-user"
              with:
                email: "rest.email"
                name: "rest.name"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/groups
          name: groups
          description: "Platform group management"
          operations:
            - method: GET
              name: list-groups
              description: "List organization groups"
              call: "platform-management.list-groups"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/audit-events
          name: audit-events
          description: "Organization audit log"
          operations:
            - method: GET
              name: query-audit-events
              description: "Query audit log events"
              call: "platform-management.query-audit-events"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/test-projects
          name: test-projects
          description: "Test project management"
          operations:
            - method: GET
              name: list-test-projects
              description: "List test projects"
              call: "test-manager.list-projects"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/test-executions
          name: test-executions
          description: "Test execution results"
          operations:
            - method: GET
              name: list-test-executions
              description: "List test executions"
              call: "test-manager.list-test-executions"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9082
      namespace: automation-governance-mcp
      transport: http
      description: "MCP server for AI-assisted automation governance across Automation Hub, Platform Management, and Test Manager."
      tools:
        - name: list-automation-ideas
          description: "List automation ideas in the Automation Hub pipeline"
          hints:
            readOnly: true
            openWorld: true
          call: "automation-hub.list-automations"
          outputParameters:
            - type: object
              mapping: "$."
        - name: create-automation-idea
          description: "Submit a new automation idea to the Automation Hub pipeline"
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: "automation-hub.create-automation-idea"
          with:
            name: "tools.name"
            description: "tools.description"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-automation-pipeline
          description: "Get the overall automation pipeline status and metrics"
          hints:
            readOnly: true
            openWorld: true
          call: "automation-hub.get-automation-pipeline"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-user
          description: "Get details of an organization user"
          hints:
            readOnly: true
            openWorld: true
          call: "platform-management.get-user"
          with:
            userId: "tools.userId"
          outputParameters:
            - type: object
              mapping: "$."
        - name: create-user
          description: "Create a new user in the UiPath organization"
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: "platform-management.create-user"
          with:
            email: "tools.email"
            name: "tools.name"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-groups
          description: "List organization groups and memberships"
          hints:
            readOnly: true
            openWorld: true
          call: "platform-management.list-groups"
          outputParameters:
            - type: object
              mapping: "$."
        - name: query-audit-events
          description: "Query organization audit log for compliance and governance"
          hints:
            readOnly: true
            openWorld: true
          call: "platform-management.query-audit-events"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-license-allocation
          description: "Get license allocation for an organization group"
          hints:
            readOnly: true
            openWorld: true
          call: "platform-management.get-group-license-allocation"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-test-projects
          description: "List test projects for QA governance"
          hints:
            readOnly: true
            openWorld: true
          call: "test-manager.list-projects"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-test-executions
          description: "List test execution history for quality reporting"
          hints:
            readOnly: true
            openWorld: true
          call: "test-manager.list-test-executions"
          outputParameters:
            - type: object
              mapping: "$."
        - name: create-test-case
          description: "Create a new test case in a test project"
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: "test-manager.create-test-case"
          with:
            projectId: "tools.projectId"
            testCaseName: "tools.testCaseName"
          outputParameters:
            - type: object
              mapping: "$."