Add documentation for the Tools Library form element
>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3582361. --> Reported by: [marcus_johansson](https://www.drupal.org/user/385947) Related to !1383 >>> <p>[Tracker]<br> <strong>Update Summary: </strong>[One-line status update for stakeholders]<br> <strong>Short Description: </strong>Add documentation for the Tools Library form element<br> <strong>Check-in Date: </strong>MM/DD/YYYY<br> [/Tracker]</p> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>The <code>ToolsLibrary</code> form element (<code>src/Element/ToolsLibrary.php</code>) provides an AI tools picker with a modal interface for selecting function call tools. It is used when building forms that need to let users pick which AI tools/functions should be available for a given AI interaction (e.g. agent configuration, assistant setup).</p> <p>The other custom form elements in the AI module (<code>ai_json_schema</code>, <code>ai_prompt</code>, <code>ai_provider_configuration</code>, <code>chat_history</code>) all have dedicated documentation pages, but the <code>tools_library</code> element does not.</p> <p>Without documentation, developers building custom AI-powered forms do not know this element exists or how to use it.</p> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <ul> <li>Create a documentation page at <code>docs/developers/tools_library_element.md</code> explaining how to use the <code>tools_library</code> form element.</li> <li>Document the element's properties and how to include it in a form array.</li> <li>Show an example of adding the element to a custom form.</li> <li>Add the new page to the <code>mkdocs.yml</code> nav under Form Elements alongside the other form element docs.</li> </ul> <h3 id="summary-ai-usage">AI usage (if applicable)</h3> <p>[x] AI Assisted Issue<br> This issue was generated with AI assistance, but was reviewed and refined by the creator.</p> <p>[ ] AI Assisted Code<br> [ ] AI Generated Code<br> [ ] Vibe Coded</p> <p>- <strong>This issue was created with the help of AI</strong></p>
issue