From 8dfd1ec36dcec863d4dcf0c55dcb8ece6491f484 Mon Sep 17 00:00:00 2001
From: corb3nik <ian@atvh.dev>
Date: Thu, 18 Dec 2025 09:55:28 -0500
Subject: [PATCH] Add ai reference doc

---
 .vitepress/sidebars/reference.ts |  4 ++++
 src/reference/ai-providers.md    | 22 ++++++++++++++++++++++
 2 files changed, 26 insertions(+)
 create mode 100644 src/reference/ai-providers.md

diff --git a/.vitepress/sidebars/reference.ts b/.vitepress/sidebars/reference.ts
index 7e89c48..068bff5 100644
--- a/.vitepress/sidebars/reference.ts
+++ b/.vitepress/sidebars/reference.ts
@@ -8,6 +8,10 @@ export const referenceSidebar: DefaultTheme.SidebarItem[] = [
         text: "Introduction",
         link: "/reference/",
       },
+      {
+        text: "AI Providers & Capabilities",
+        link: "/reference/ai-providers",
+      },
     ],
   },
   {
diff --git a/src/reference/ai-providers.md b/src/reference/ai-providers.md
new file mode 100644
index 0000000..0473805
--- /dev/null
+++ b/src/reference/ai-providers.md
@@ -0,0 +1,22 @@
+# AI Providers & Capabilities
+
+This reference document provides a comprehensive overview of which AI providers support which capabilities in Caido's AI integration.
+
+::: warning
+Caido's AI provider does not support text embedding models or image models. Only text generation language models are supported.
+:::
+
+## Capabilities Matrix
+
+| Capability | OpenAI | Anthropic | Gemini | OpenRouter |
+|-----------|--------|-----------|--------|------------|
+| Reasoning |x|x|x|x|
+| Reasoning Signature | | | | |
+| Reasoning Summary | | | | |
+| Tool Calling | | | | |
+| Tool Calling Signature | | | | |
+| Parallel Tool Calling | | | | |
+| Streaming Response | | | | |
+| Streaming Reasoning | | | | |
+| Streaming Tool Call | | | | |
+| Structured Output | | | | |