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