Jentic Arazzo Engine Bridge

naftiko: "1.0.0-alpha2"

info:
  title: Jentic Arazzo Engine Bridge
  description: >-
    Bridges to a self-hosted Jentic Arazzo Engine instance (the open-source
    Python workflow runner) so a Naftiko capability can execute Arazzo
    workflows locally — useful for air-gapped, regulated, or private
    workflow execution where the hosted Jentic catalog is not an option.
    Standards-aligned: both products share the OpenAPI Initiative's
    Arazzo workflow specification.
  tags:
    - Naftiko
    - Jentic
    - Partnership
    - Arazzo
    - Self-Hosted
    - Open-Source
    - Workflow
  created: '2026-05-15'
  modified: '2026-05-15'

binds:
  - namespace: arazzo-env
    description: Self-hosted Jentic Arazzo Engine endpoint.
    keys:
      ARAZZO_ENGINE_BASE: ARAZZO_ENGINE_BASE

capability:
  consumes:
    - namespace: arazzo
      type: http
      baseUri: '{{ARAZZO_ENGINE_BASE}}'
      resources:
        - name: list-workflows
          path: '/workflows'
          operations:
            - name: list-local-workflows
              method: GET
            - name: register-local-workflow
              method: POST
        - name: workflow
          path: '/workflows/{{workflow_id}}'
          operations:
            - name: get-local-workflow
              method: GET
              inputParameters:
                - { name: workflow_id, in: path, required: true }
            - name: delete-local-workflow
              method: DELETE
              inputParameters:
                - { name: workflow_id, in: path, required: true }
        - name: execute-local-workflow
          path: '/workflows/{{workflow_id}}/execute'
          operations:
            - name: execute-local-workflow
              method: POST
              inputParameters:
                - { name: workflow_id, in: path, required: true }
        - name: validate-arazzo
          path: '/workflows/validate'
          operations:
            - name: validate-arazzo
              method: POST

  exposes:
    - type: rest
      address: 0.0.0.0
      port: 8080
      namespace: jentic-arazzo-engine-bridge-rest
      description: REST surface for managing self-hosted Arazzo workflow execution.
      resources:
        - name: workflows
          path: '/workflows'
          operations:
            - name: list-local-workflows
              method: GET
              call: arazzo.list-local-workflows
            - name: register-local-workflow
              method: POST
              call: arazzo.register-local-workflow
        - name: workflow
          path: '/workflows/{workflow_id}'
          operations:
            - name: get-local-workflow
              method: GET
              inputParameters:
                - { name: workflow_id, in: path, type: string, required: true }
              call: arazzo.get-local-workflow
            - name: delete-local-workflow
              method: DELETE
              inputParameters:
                - { name: workflow_id, in: path, type: string, required: true }
              call: arazzo.delete-local-workflow
        - name: execute-local-workflow
          path: '/workflows/{workflow_id}/execute'
          operations:
            - name: execute-local-workflow
              method: POST
              inputParameters:
                - { name: workflow_id, in: path, type: string, required: true }
              call: arazzo.execute-local-workflow
        - name: validate-arazzo
          path: '/workflows/validate'
          operations:
            - name: validate-arazzo
              method: POST
              call: arazzo.validate-arazzo

    - type: mcp
      address: 0.0.0.0
      port: 3010
      namespace: jentic-arazzo-engine-bridge-mcp
      description: MCP server exposing self-hosted Arazzo workflow execution to agents.
      tools:
        - name: list-local-workflows
          description: List Arazzo workflows registered with the local Jentic Arazzo Engine.
          hints: { readOnly: true }
          call: arazzo.list-local-workflows
        - name: register-local-workflow
          description: Register a new Arazzo workflow with the local engine.
          hints: { destructiveHint: false }
          call: arazzo.register-local-workflow
        - name: get-local-workflow
          description: Get a single locally-registered Arazzo workflow.
          hints: { readOnly: true }
          inputParameters:
            - { name: workflow_id, type: string, required: true, description: Local workflow ID. }
          call: arazzo.get-local-workflow
        - name: delete-local-workflow
          description: Delete a locally-registered Arazzo workflow.
          hints: { destructiveHint: true }
          inputParameters:
            - { name: workflow_id, type: string, required: true, description: Local workflow ID. }
          call: arazzo.delete-local-workflow
        - name: execute-local-workflow
          description: Execute an Arazzo workflow locally (air-gapped, no hosted Jentic dependency).
          hints: { destructiveHint: true }
          inputParameters:
            - { name: workflow_id, type: string, required: true, description: Local workflow ID. }
          call: arazzo.execute-local-workflow
        - name: validate-arazzo
          description: Validate an Arazzo spec against the OpenAPI Initiative specification without persisting.
          hints: { readOnly: true }
          call: arazzo.validate-arazzo