Show case Modeler API to setup an agent

If the showcase goers in the right direction, there are 2 blocks of topics that we need to discuss:

Integration decisions:

• Is modeler API a fixed dependency?
• Do we allow different modelers?
• If no modeler is available, the agent can not be edited?

Tasks to do in bpmn_io:

• Property panel too high, should be embedded in the canvas and have a scrollable container when it's too high
• Property panel: replace their forms with Drupal form API components
• Hide all non-editable components in the property panel
• Hide non-supported components in the left components panel
• Auto-fill task label when adding a new template
• Adding a new tool should start with the template selector, not that the user has to trigger that as a second step
• Each tool can only be added once
• Add zoom in/out widgets

Testing instructions

I started with the current version of Drupal 11.x (core, not recommended-project) and I am using ddev. Make changes as needed if you are using a different setup.

Install modules and Drush

Install from source, so that we can use git to pull different versions.

ddev composer require --prefer-source drupal/bpmn_io:^3@dev drupal/modeler_api:^1@dev drupal/ai_agents:^1.1@dev
ddev composer require drush/drush

Check out specific branches

I copied and pasted the instructions from this issue. (Expand the "Show commands" section.)

cd modules/contrib/ai_agents
git remote add ai_agents-3524652 git@git.drupal.org:issue/ai_agents-3524652.git
git fetch ai_agents-3524652
git checkout -b '3524652-show-case-modeler' --track ai_agents-3524652/'3524652-show-case-modeler'

Then I switched to the dev branch of bpmn_io:

cd ../bpmn_io
git switch 3.0.x
cd ../../..

Install Drupal and enable modules

ddev drush si --yes
ddev drush en ai_agents_modeler_api --yes

Generate a one-time login link

ddev drush uli

Open the link in a browser.

Edit an AI agent

1. Go to Administration > Configuration > AI > AI Agents Settings (/admin/config/ai/agents).
2. Find an agent with Type: config, such as field_agent_triage.
3. Follow the Edit link.

Alternatively, from /admin/config/ai/agents, use the "Add AI Agent" action link (/admin/structure/ai_agent/add).

Testing results

When I enabled the ai_agents module, I got three warnings like this:

Schema errors for ai_agents.ai_agent.content_type_agent_triage …

I also see those warnings on /admin/config/ai/agents after clearing caches.

My guess is that these warnings are not related to this issue. They might be there because I am using the latest 11.x version of Drupal core, not any release.

Initially, I enabled the ai_agents module without the ai_agents_modeler_api submodule. That leads to a WSOD when I try to edit an agent. I think we need to disable the Edit link unless the appropriate modules are enabled. If this issue is intended as a proof of concept, then that can be done as a follow-up issue, but for now I am setting the status to NW.

I am testing this issue while at MidCamp, so I added the issue tag for that. @cosmicdreams is here, too.

@marcus_johansson this is now ready for review, as discussed in our call. It keeps the original functionality and adds the alternative agent form only if the ai_agents_modeler_api submodule is enabled. That gives people a chance to play around with this new stuff, but it also keeps the functionality untouched for productions systems.