feat(tools)!: move to function calling (#1141)

Author: olimorris

README.md

@@ -29,11 +29,11 @@ Thank you to the following people:
 - :speech_balloon: [Copilot Chat](https://github.com/features/copilot) meets [Zed AI](https://zed.dev/blog/zed-ai), in Neovim
 - :electric_plug: Support for Anthropic, Copilot, GitHub Models, DeepSeek, Gemini, Mistral AI, Novita, Ollama, OpenAI, Azure OpenAI, HuggingFace and xAI LLMs (or [bring your own](https://codecompanion.olimorris.dev/extending/adapters.html))
 - :heart_hands: User contributed and supported [adapters](https://codecompanion.olimorris.dev/configuration/adapters#community-adapters)
-- :rocket: Inline transformations, code creation and refactoring
-- :robot: Variables, Slash Commands, Agents/Tools and Workflows to improve LLM output
-- :sparkles: Built in prompt library for common tasks like advice on LSP errors and code explanations
-- :building_construction: Create your own custom prompts, Variables and Slash Commands
-- :books: Have multiple chats open at the same time
+- :rocket: [Inline transformations](https://codecompanion.olimorris.dev/usage/inline-assistant.html), code creation and refactoring
+- :robot: [Variables](https://codecompanion.olimorris.dev/usage/chat-buffer/variables.html), [Slash Commands](https://codecompanion.olimorris.dev/usage/chat-buffer/slash-commands.html), [Agents/Tools](https://codecompanion.olimorris.dev/usage/chat-buffer/agents.html) and [Workflows](https://codecompanion.olimorris.dev/usage/workflows.html) to improve LLM output
+- :sparkles: Built in [prompt library](https://codecompanion.olimorris.dev/usage/action-palette.html) for common tasks like advice on LSP errors and code explanations
+- :building_construction: Create your own [custom prompts](https://codecompanion.olimorris.dev/extending/prompts.html), Variables and Slash Commands
+- :books: Have [multiple chats](https://codecompanion.olimorris.dev/usage/introduction.html#quickly-accessing-a-chat-buffer) open at the same time
 - :muscle: Async execution for fast performance
 
 <!-- panvimdoc-ignore-start -->
@@ -42,19 +42,15 @@ Thank you to the following people:
 
 <div align="center">
   <p>
-    <h3>The Chat Buffer</h3>
+    <h3>The Chat Buffer</h3> - <a href="https://github.com/user-attachments/assets/aa109f1d-0ec9-4f08-bd9a-df99da03b9a4">Link</a>
     <video controls muted src="https://github.com/user-attachments/assets/aa109f1d-0ec9-4f08-bd9a-df99da03b9a4"></video>
   </p>
   <p>
-    <h3>Using Agents and Tools</h3>
-    <video controls muted src="https://github.com/user-attachments/assets/16bd6c17-bd70-41a1-83aa-7af45c166ae9"></video>
+    <h3>Tools + Agentic Workflows</h3> - <a href="https://github.com/user-attachments/assets/362b7cfd-e794-4d9c-9a74-90d5e2a87a32">Link</a>
+    <video controls muted src="https://github.com/user-attachments/assets/362b7cfd-e794-4d9c-9a74-90d5e2a87a32"></video>
   </p>
   <p>
-    <h3>Agentic Workflows</h3>
-    <video controls muted src="https://github.com/user-attachments/assets/31bae248-ae70-4395-9df1-67fc252475ca"></video>
-  </p>
-  <p>
-    <h3>Inline Assistant</h3>
+    <h3>Inline Assistant</h3> - <a href="https://github.com/user-attachments/assets/dcddcb85-cba0-4017-9723-6e6b7f080fee">Link</a>
     <video controls muted src="https://github.com/user-attachments/assets/dcddcb85-cba0-4017-9723-6e6b7f080fee"></video>
   </p>
 </div>
@@ -63,7 +59,7 @@ Thank you to the following people:
 
 ## :rocket: Getting Started
 
-Please visit the [docs](https://codecompanion.olimorris.dev) for information on installation, configuration and usage.
+Everything you need to know about CodeCompanion (installation, configuration and usage) is within the [docs](https://codecompanion.olimorris.dev).
 
 ## :toolbox: Troubleshooting
 
@@ -102,15 +98,14 @@ I am open to contributions but they will be implemented at my discretion. Feel f
 ## :clap: Acknowledgements
 
 - [Steven Arcangeli](https://github.com/stevearc) for his genius creation of the chat buffer and his feedback early on
-- [Manoel Campos](https://github.com/manoelcampos) for the [xml2lua](https://github.com/manoelcampos/xml2lua) library that's used in the tools implementation
+- [Manoel Campos](https://github.com/manoelcampos) for the [xml2lua](https://github.com/manoelcampos/xml2lua) library that's used in the inline assistant implementation
 - [Dante.nvim](https://github.com/S1M0N38/dante.nvim) for the beautifully simple diff implementation
 - [Wtf.nvim](https://github.com/piersolenski/wtf.nvim) for the LSP assistant action
 - [CopilotChat.nvim](https://github.com/CopilotC-Nvim/CopilotChat.nvim) for the rendering and usability of the chat
 buffer
 - [Aerial.nvim](https://github.com/stevearc/aerial.nvim) for the Tree-sitter parsing which inspired the symbols Slash
 Command
-- [Saghen](https://github.com/Saghen) for the fantastic docs inspiration from [blink.cmp](https://github.com/Saghen/blink.cmp)
-- [Catwell](https://github.com/catwell) for the [queue](https://github.com/catwell/cw-lua/blob/master/deque/deque.lua)
-inspiration that I use to stack agents and tools
-
+- [Saghen](https://github.com/Saghen) for the fantastic docs inspiration from [blink.cmp](https://github.com/Saghen/blink.cmp) and continued PRs to the project
+- [Catwell](https://github.com/catwell) for the [queue](https://github.com/catwell/cw-lua/blob/master/deque/deque.lua) inspiration that I use to stack agents and tools
+- [ravitemer](https://github.com/ravitemer) for the fantastic extensions API
 <!-- panvimdoc-ignore-end -->

codecompanion-workspace.json

@@ -57,7 +57,7 @@
     },
     {
       "name": "Tools",
-      "system_prompt": "In the CodeCompanion plugin, tools can be leveraged by an LLM to execute lua functions or shell commands on the users machine. By responding with XML, CodeCompanion will pass the response, call the corresponding tool. This feature has been implemented via the agent/init.lua file, which passes all of the tools and adds them to a queue. Then those tools are run consecutively by the executor/init.lua file.",
+      "system_prompt": "In the CodeCompanion plugin, tools can be leveraged by an LLM to execute lua functions or shell commands on the users machine. CodeCompanion uses an LLM's native function calling to receive a response in JSON, parse the response and call the corresponding tool. This feature has been implemented via the agent/init.lua file, which passes all of the tools and adds them to a queue. Then those tools are run consecutively by the executor/init.lua file.",
       "opts": {
         "remove_config_system_prompt": true
       },
@@ -102,6 +102,11 @@
       "path": "lua/codecompanion/strategies/chat/init.lua",
       "description": "The `${filename}` file is the entry point for the chat strategy, which is called the `chat buffer`. All methods directly relating to the chat buffer reside here."
     },
+    "chat-messages": {
+      "type": "file",
+      "path": "tests/stubs/messages.lua",
+      "description": "This is an example of what the messages table looks like. This is the table which contains all of the user and LLM messages that are sent to the LLM. It also includes output from the tools that the LLM has requested to run. The role is the person that has sent the message. Content is the message itself. Cycle is a way of grouping messages together in a turn where a turn is defined as a user message and a LLM message (sometimes a tool message too"
+    },
     "workflow-example": {
       "type": "file",
       "path": "tests/stubs/workflow.lua",
@@ -167,7 +172,7 @@
     "agents-init": {
       "type": "file",
       "path": "lua/codecompanion/strategies/chat/agents/init.lua",
-      "description": "This is the entry point for the agent. If XML is detected in an LLM's response then this file is triggered which in turns add tools to a queue before calling the executor"
+      "description": "This is the entry point for the agent. If an LLM's response includes a function call (or tool call) then this file is triggered which in turns add tools to a queue before calling the executor"
     },
     "executor-init": {
       "type": "file",

doc/.vitepress/theme/vaporwave.css

@@ -69,6 +69,9 @@
     var(--vw-green) 25%,
     var(--vw-base-bg)
   );
+
+  /* even‑row stripes */
+  --vp-c-bg-soft: color-mix(in srgb, var(--vw-blue) 5%, var(--vp-c-bg));
 }
 
 .dark {
@@ -90,6 +93,12 @@
 
   /* Override base background for dark mode */
   --vw-base-bg-mixer: 20%;
+
+  .vp-doc table th,
+  .vp-doc table td {
+    border: 1px solid color-mix(in srgb, var(--vw-green) 40%, var(--vp-c-bg)) !important;
+  }
+  --vp-c-bg-soft: color-mix(in srgb, var(--vp-c-bg-alt) 80%, var(--vp-c-bg));
 }
 
 /* Mermaid */