Problem/Motivation
This is a brand-new public module. The drupal.org project AI Agent Modes already exists but its canonical git.drupalcode.org repository is empty (no branches or commits yet), and there is no GitHub mirror.
The module itself is complete and working: it adds a "Mode" selector in front of any AI agent chat (the Drupal Canvas AI panel, the AI Assistant chatbot, or any custom surface via a block or render element), scoping the orchestrator to a curated subset of its sub-agents via a saved ai_agent_mode config entity, so the model gets a tighter context instead of enumerating every available sub-agent.
Depends only on drupal/ai (^1.1 || ^2) and drupal/ai_agents (^1.1).
Steps to reproduce
N/A (this is an initialization issue, not a bug report). Anyone visiting https://git.drupalcode.org/project/ai_agent_modes today will find an empty repository with no branches.
Proposed resolution
Push the module's current, reviewed source as a fresh git history (a single clean commit; there is no pre-existing history to carry over, as this has no private predecessor repo) onto the 1.0.x branch via this issue's fork and a follow-up merge request, with GitLab CI (drupalci template: phpcs, phpstan, phpunit, cspell) as the only CI, since there was never a GitHub Actions workflow for this project.
Also create a public GitHub mirror at github.com/Vardot/ai_agent_modes.
Remaining tasks
- ✅ File an issue about this project
- ✅ Addition/Change/Update/Fix to this project
- ✅ Testing to ensure no regression
- ➖ Automated unit/functional testing coverage
- ➖ Developer Documentation support on feature change/addition
- ➖ User Guide Documentation support on feature change/addition
- ➖ UX/UI designer responsibilities
- ➖ Accessibility and Readability
- ❌ Reviewed by a human
- ❌ Code review by maintainers
- ❌ Full testing and approval
- ❌ Credit contributors
- ❌ Review with the product owner
- ✅ Update Release Notes
- ✅ Release
User interface changes
- None. Initial code push only.
API changes
- None. Initial code push only.
Data model changes
- None. Initial code push only.
Release notes snippet
- Initial release: a Mode selector for AI agent chats (Drupal Canvas AI, AI Assistant chatbot, or any custom surface) that scopes an orchestrator to a curated subset of its sub-agents via a saved
ai_agent_modeconfig entity.
| Comment | File | Size | Author |
|---|---|---|---|
| #10 | ai-agent-modes-managing-modes-poster.jpg | 125.76 KB | rajab natshah |
| #10 | ai-agent-modes-using-the-mode-selector-poster.jpg | 107.86 KB | rajab natshah |
| #9 | a2-2-mode-selector-toolbar.png | 50.72 KB | rajab natshah |
| #9 | a2-1-modes-list-open.png | 101.45 KB | rajab natshah |
| #8 | ai-agent-modes-testing-report.pdf | 1.04 MB | rajab natshah |
Issue fork ai_agent_modes-3612563
Show commands
Start within a Git clone of the project using the version control instructions.
Or, if you do not have SSH keys set up on git.drupalcode.org:
Comments
Comment #4
rajab natshahComment #5
rajab natshahComment #6
rajab natshah✅ Released ai_agent_modes-1.0.0-alpha1
Comment #8
rajab natshahAttaching the screenshots, walkthrough videos and documentation used for the project page.
Screenshots (Drupal CMS 2.x, Drupal 11.4.4, Drupal Canvas AI):
- v2-1-modes-list-open.png: the Mode list at the top of the Drupal Canvas AI panel, with all modes visible.
- v2-2-mode-selector-toolbar.png: the compact Mode selector in the message box toolbar.
- 3-ai-agent-modes-settings.png: the settings screen with the four dropdown placement options.
- 3b-ai-agent-modes-listing.png: the Modes listing with each mode, its parent agent and its sub-agents.
Videos:
- ai-agent-modes-using-the-mode-selector.mp4 (43 seconds): opening the Canvas AI panel, choosing a mode, and the assistant scoped to that job.
- ai-agent-modes-managing-modes.mp4 (48 seconds): the Modes listing, a mode edit form, and the placement setting.
Documentation:
- ai-agent-modes-guide.pdf: how to use the module.
- ai-agent-modes-testing-report.pdf: the tests and experiments run against Drupal CMS.
Note on the screenshots: the option list is the real select element expanded in place. Native dropdown popups are drawn by the operating system outside the page, so they cannot be captured in a screenshot or a screen recording. The options, their order and the selection are all live from the module.
Comment #9
rajab natshahAdding the 1.0.0-alpha2 versions of the two selector screenshots. Same site, same framing as the originals, retaken after #3613457 so the default option reads "All, let the assistant decide" with no em dash.
- a2-1-modes-list-open.png: the Mode list at the top of the Drupal Canvas AI panel, with every mode the site offers.
- a2-2-mode-selector-toolbar.png: the compact selector in the message box toolbar.
The earlier v2-1 and v2-2 files are kept for history, but they show the pre-release wording and should not be used on the project page or in the documentation.
Comment #10
rajab natshahAdding the poster frames for the two walkthrough videos, so the documentation can show a real preview frame in the player rather than a black box.
- ai-agent-modes-using-the-mode-selector-poster.jpg
- ai-agent-modes-managing-modes-poster.jpg