doccupine 0.0.29 → 0.0.31

package/LICENSE

@@ -0,0 +1,8 @@
+Copyright © 2026, Doccupine.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+No licensee or downstream recipient may use the Software (including any modified or derivative versions) to directly compete with the original Licensor by offering it to third parties as a hosted, managed, or Software-as-a-Service (SaaS) product or cloud service where the primary value of the service is the functionality of the Software itself.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -12,6 +12,8 @@ Doccupine is built on open standards, enabling customization and extensibility f
 - 📦 Built-in file structure
 - ⚡ Live Preview & Auto-Update
 - 🚀 Easy Deployment
+- 🤖 AI-powered
+- 🔌 Model Context Protocol (MCP)
 
 ## Getting Started
 
@@ -32,6 +34,6 @@ This will start the development server on port 3000. Open your browser and navig
 
 ## Start documenting
 
-Start documenting your project by editing the **index.mdx** file in the choosen MDX directory.
+Start documenting your project by editing the `index.mdx` file in the choosen MDX directory, this is the content for the home page of your documentation website.
 
 In your MDX directory, you can structure your content using folders and files. Doccupine will automatically generate a navigation menu based on the configured categories and order.

package/dist/index.js

@@ -3,18 +3,23 @@ import { program } from "commander";
 import chokidar from "chokidar";
 import fs from "fs-extra";
 import path from "path";
+import { fileURLToPath } from "url";
 import matter from "gray-matter";
 import chalk from "chalk";
 import prompts from "prompts";
+import { envExampleTemplate } from "./templates/env.example.js";
 import { gitignoreTemplate } from "./templates/gitignore.js";
 import { nextConfigTemplate } from "./templates/next.config.js";
 import { packageJsonTemplate } from "./templates/package.js";
 import { proxyTemplate } from "./templates/proxy.js";
 import { tsconfigTemplate } from "./templates/tsconfig.js";
+import { mcpRoutesTemplate } from "./templates/app/api/mcp/route.js";
+import { ragRoutesTemplate } from "./templates/app/api/rag/route.js";
 import { routesTemplate } from "./templates/app/api/theme/routes.js";
 import { layoutTemplate } from "./templates/app/layout.js";
 import { notFoundTemplate } from "./templates/app/not-found.js";
 import { themeTemplate } from "./templates/app/theme.js";
+import { chatTemplate } from "./templates/components/Chat.js";
 import { clickOutsideTemplate } from "./templates/components/ClickOutside.js";
 import { docsTemplate } from "./templates/components/Docs.js";
 import { docsSideBarTemplate } from "./templates/components/DocsSideBar.js";
@@ -39,14 +44,24 @@ import { headerTemplate } from "./templates/components/layout/Header.js";
 import { iconTemplate } from "./templates/components/layout/Icon.js";
 import { pictogramsTemplate } from "./templates/components/layout/Pictograms.js";
 import { sharedStyledTemplate } from "./templates/components/layout/SharedStyles.js";
+import { staticLinksTemplate } from "./templates/components/layout/StaticLinks.js";
 import { stepsTemplate } from "./templates/components/layout/Stepts.js";
 import { tabsTemplate } from "./templates/components/layout/Tabs.js";
 import { themeToggleTemplate } from "./templates/components/layout/ThemeToggle.js";
 import { typographyTemplate } from "./templates/components/layout/Typography.js";
 import { updateTemplate } from "./templates/components/layout/Update.js";
+import { mcpIndexTemplate } from "./templates/services/mcp/index.js";
+import { mcpServerTemplate } from "./templates/services/mcp/server.js";
+import { mcpToolsTemplate } from "./templates/services/mcp/tools.js";
+import { mcpTypesTemplate } from "./templates/services/mcp/types.js";
+import { llmConfigTemplate } from "./templates/services/llm/config.js";
+import { llmFactoryTemplate } from "./templates/services/llm/factory.js";
+import { llmIndexTemplate } from "./templates/services/llm/index.js";
+import { llmTypesTemplate } from "./templates/services/llm/types.js";
 import { styledDTemplate } from "./templates/types/styled.js";
 import { orderNavItemsTemplate } from "./templates/utils/orderNavItems.js";
 import { accordionMdxTemplate } from "./templates/mdx/accordion.mdx.js";
+import { aiAssistantMdxTemplate } from "./templates/mdx/ai-assistant.mdx.js";
 import { buttonsMdxTemplate } from "./templates/mdx/buttons.mdx.js";
 import { calloutsMdxTemplate } from "./templates/mdx/callouts.mdx.js";
 import { cardsMdxTemplate } from "./templates/mdx/cards.mdx.js";
@@ -61,12 +76,18 @@ import { headersAndTextMdxTemplate } from "./templates/mdx/headers-and-text.mdx.
 import { iconsMdxTemplate } from "./templates/mdx/icons.mdx.js";
 import { imageAndEmbedsMdxTemplate } from "./templates/mdx/image-and-embeds.mdx.js";
 import { indexMdxTemplate } from "./templates/mdx/index.mdx.js";
+import { linksMdxTemplate } from "./templates/mdx/links.mdx.js";
+import { mcpMdxTemplate } from "./templates/mdx/model-context-protocol.mdx.js";
 import { listAndTablesMdxTemplate } from "./templates/mdx/list-and-tables.mdx.js";
 import { navigationMdxTemplate } from "./templates/mdx/navigation.mdx.js";
 import { stepsMdxTemplate } from "./templates/mdx/steps.mdx.js";
 import { tabsMdxTemplate } from "./templates/mdx/tabs.mdx.js";
 import { themeMdxTemplate } from "./templates/mdx/theme.mdx.js";
 import { updateMdxTemplate } from "./templates/mdx/update.mdx.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf8"));
+const version = packageJson.version;
 class ConfigManager {
     configPath;
     constructor(configPath = "doccupine.json") {
@@ -141,7 +162,12 @@ class MDXToNextJSGenerator {
     watcher = null;
     configWatcher = null;
     fontWatcher = null;
-    configFiles = ["theme.json", "navigation.json", "config.json"];
+    configFiles = [
+        "theme.json",
+        "navigation.json",
+        "config.json",
+        "links.json",
+    ];
     fontConfigFile = "fonts.json";
     constructor(watchDir, outputDir) {
         this.watchDir = path.resolve(watchDir);
@@ -164,8 +190,10 @@ class MDXToNextJSGenerator {
     }
     async createNextJSStructure() {
         const structure = {
+            ".env.example": this.generateEnvExample(),
             ".gitignore": this.generateGitIgnore(),
             "config.json": this.generateConfig(),
+            "links.json": this.generateLinksConfig(),
             "navigation.json": this.generateNavigationConfig(),
             "next.config.ts": this.generateNextConfig(),
             "package.json": this.generatePackageJson(),
@@ -175,9 +203,20 @@ class MDXToNextJSGenerator {
             "app/layout.tsx": await this.generateRootLayout(),
             "app/not-found.tsx": this.generateNotFoundPage(),
             "app/theme.ts": this.generateTheme(),
+            "app/api/mcp/route.ts": this.generateMCPRoutes(),
+            "app/api/rag/route.ts": this.generateRagRoutes(),
             "app/api/theme/route.ts": this.generateRoutes(),
+            "services/mcp/index.ts": this.generateMCPIndex(),
+            "services/mcp/server.ts": this.generateMCPServer(),
+            "services/mcp/tools.ts": this.generateMCPTools(),
+            "services/mcp/types.ts": this.generateMCPTypes(),
+            "services/llm/config.ts": this.generateLLMConfig(),
+            "services/llm/factory.ts": this.generateLLMFactory(),
+            "services/llm/index.ts": this.generateLLMIndex(),
+            "services/llm/types.ts": this.generateLLMTypes(),
             "types/styled.d.ts": this.generateStyledDTypes(),
             "utils/orderNavItems.ts": this.generateOrderNavItems(),
+            "components/Chat.tsx": this.generateChat(),
             "components/ClickOutside.ts": this.generateClickOutside(),
             "components/Docs.tsx": this.generateDocs(),
             "components/DocsSideBar.tsx": this.generateDocsSideBar(),
@@ -202,6 +241,7 @@ class MDXToNextJSGenerator {
             "components/layout/Icon.tsx": this.generateIcon(),
             "components/layout/Pictograms.tsx": this.generatePictograms(),
             "components/layout/SharedStyled.ts": this.generateSharedStyled(),
+            "components/layout/StaticLinks.tsx": this.generateStaticLinks(),
             "components/layout/Steps.tsx": this.generateSteps(),
             "components/layout/Tabs.tsx": this.generateTabs(),
             "components/layout/ThemeToggle.tsx": this.generateThemeToggle(),
@@ -217,6 +257,7 @@ class MDXToNextJSGenerator {
     async createStartingDocs() {
         const structure = {
             "accordion.mdx": this.generateAccordionMdx(),
+            "ai-assistant.mdx": this.generateAiAssistantMdx(),
             "buttons.mdx": this.generateButtonsMdx(),
             "callouts.mdx": this.generateCalloutsMdx(),
             "cards.mdx": this.generateCardsMdx(),
@@ -231,6 +272,8 @@ class MDXToNextJSGenerator {
             "icons.mdx": this.generateIconsMdx(),
             "image-and-embeds.mdx": this.generateImagesAndEmbedsMdx(),
             "index.mdx": this.generateIndexMdx(),
+            "links.mdx": this.generateLinksMdx(),
+            "model-context-protocol.mdx": this.generateMCPMdx(),
             "lists-and-tables.mdx": this.generateListsAndTablesMdx(),
             "navigation.mdx": this.generateNavigationMdx(),
             "steps.mdx": this.generateStepsMdx(),
@@ -507,12 +550,18 @@ class MDXToNextJSGenerator {
             .replace(/[^a-zA-Z0-9\/\-_]/g, "-")
             .toLowerCase();
     }
+    generateEnvExample() {
+        return envExampleTemplate;
+    }
     generateGitIgnore() {
         return gitignoreTemplate;
     }
     generateConfig() {
         return `{}`;
     }
+    generateLinksConfig() {
+        return `[]`;
+    }
     generateNavigationConfig() {
         return `[]`;
     }
@@ -590,11 +639,11 @@ const content = \`${mdxFile.content.replace(/`/g, "\\`")}\`;
 export const metadata: Metadata = {
   title: \`${mdxFile.frontmatter.title || "Generated with Doccupine"} \${config.name ? "- " + config.name : "- Doccupine"}\`,
   description: \`${mdxFile.frontmatter.description ? mdxFile.frontmatter.description : '${config.description ? config.description : "Generated with Doccupine"}'}\`,
-  icons: \`${mdxFile.frontmatter.icon ? mdxFile.frontmatter.icon : "\${config.icon || 'https://doccupine.com/favicon.ico'}"}\`,
+  icons: \`${mdxFile.frontmatter.icon ? mdxFile.frontmatter.icon : '\${config.icon || "https://doccupine.com/favicon.ico"}'}\`,
   openGraph: {
     title: \`${mdxFile.frontmatter.title || "Generated with Doccupine"} \${config.name ? "- " + config.name : "- Doccupine"}\`,
     description: \`${mdxFile.frontmatter.description ? mdxFile.frontmatter.description : '${config.description ? config.description : "Generated with Doccupine"}'}\`,
-    images: \`${mdxFile.frontmatter.image ? mdxFile.frontmatter.image : "\${config.preview || 'https://doccupine.com/preview.png'}"}\`,
+    images: \`${mdxFile.frontmatter.image ? mdxFile.frontmatter.image : '\${config.preview || "https://doccupine.com/preview.png"}'}\`,
   },
 };
 
@@ -639,7 +688,7 @@ interface Config {
 
 const config = configData as Config;
 
-${indexMDX ? `const indexContent = \`${indexMDX.content.replace(/`/g, "\\`")}\`;` : `const indexContent = null;`}
+${indexMDX ? `const content = \`${indexMDX.content.replace(/`/g, "\\`")}\`;` : `const content = null;`}
 
 ${indexMDX
             ? `export const metadata: Metadata = {
@@ -649,7 +698,7 @@ ${indexMDX
   openGraph: {
     title: \`\${config.name ? config.name + " -" : "Doccupine -"} ${indexMDX.title}\`,
     description: \`${indexMDX.description ? indexMDX.description : '${config.description ? config.description : "Generated with Doccupine"}'}\`,
-    images: \`${indexMDX.image ? indexMDX.image : "\${config.preview || 'https://doccupine.com/preview.png'}"}\`,
+    images: \`${indexMDX.image ? indexMDX.image : '\${config.preview || "https://doccupine.com/preview.png"}'}\`,
   },
 };`
             : `export const metadata: Metadata = {
@@ -664,7 +713,7 @@ ${indexMDX
 };`}
 
 export default function Home() {
-  return <Docs content={indexContent} />;
+  return <Docs content={content} />;
 }
 `;
         await fs.writeFile(path.join(this.outputDir, "app", "page.tsx"), indexContent, "utf8");
@@ -676,15 +725,48 @@ export default function Home() {
     generateTheme() {
         return themeTemplate;
     }
+    generateMCPRoutes() {
+        return mcpRoutesTemplate;
+    }
+    generateRagRoutes() {
+        return ragRoutesTemplate;
+    }
     generateRoutes() {
         return routesTemplate;
     }
+    generateMCPIndex() {
+        return mcpIndexTemplate;
+    }
+    generateMCPServer() {
+        return mcpServerTemplate;
+    }
+    generateMCPTools() {
+        return mcpToolsTemplate;
+    }
+    generateMCPTypes() {
+        return mcpTypesTemplate;
+    }
+    generateLLMConfig() {
+        return llmConfigTemplate;
+    }
+    generateLLMFactory() {
+        return llmFactoryTemplate;
+    }
+    generateLLMIndex() {
+        return llmIndexTemplate;
+    }
+    generateLLMTypes() {
+        return llmTypesTemplate;
+    }
     generateStyledDTypes() {
         return styledDTemplate;
     }
     generateOrderNavItems() {
         return orderNavItemsTemplate;
     }
+    generateChat() {
+        return chatTemplate;
+    }
     generateClickOutside() {
         return clickOutsideTemplate;
     }
@@ -757,6 +839,9 @@ export default function Home() {
     generateSharedStyled() {
         return sharedStyledTemplate;
     }
+    generateStaticLinks() {
+        return staticLinksTemplate;
+    }
     generateSteps() {
         return stepsTemplate;
     }
@@ -775,6 +860,9 @@ export default function Home() {
     generateAccordionMdx() {
         return accordionMdxTemplate;
     }
+    generateAiAssistantMdx() {
+        return aiAssistantMdxTemplate;
+    }
     generateButtonsMdx() {
         return buttonsMdxTemplate;
     }
@@ -814,9 +902,15 @@ export default function Home() {
     generateImagesAndEmbedsMdx() {
         return imageAndEmbedsMdxTemplate;
     }
+    generateMCPMdx() {
+        return mcpMdxTemplate;
+    }
     generateIndexMdx() {
         return indexMdxTemplate;
     }
+    generateLinksMdx() {
+        return linksMdxTemplate;
+    }
     generateListsAndTablesMdx() {
         return listAndTablesMdxTemplate;
     }
@@ -853,7 +947,7 @@ export default function Home() {
 program
     .name("doccupine")
     .description("Watch MDX files and generate Next.js documentation pages automatically")
-    .version("0.0.29");
+    .version(version);
 program
     .command("watch", { isDefault: true })
     .description("Watch a directory for MDX changes and generate Next.js app")
@@ -870,8 +964,18 @@ program
     await generator.init();
     let devServer = null;
     console.log(chalk.blue("📦 Installing dependencies..."));
-    const { spawn } = await import("child_process");
-    const install = spawn("npm", ["install"], {
+    const { spawn, execSync } = await import("child_process");
+    // Check if pnpm is available, fallback to npm
+    let packageManager = "npm";
+    try {
+        execSync("pnpm --version", { stdio: "ignore" });
+        packageManager = "pnpm";
+    }
+    catch {
+        // pnpm not available, use npm
+    }
+    console.log(chalk.blue(`📦 Using ${packageManager}...`));
+    const install = spawn(packageManager, ["install"], {
         cwd: config.outputDir,
         stdio: "pipe",
     });

package/dist/templates/app/api/mcp/route.d.ts

@@ -0,0 +1 @@
+export declare const mcpRoutesTemplate = "import { NextResponse } from \"next/server\";\nimport { WebStandardStreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js\";\nimport { createMCPServer } from \"@/services/mcp/server\";\nimport {\n  searchDocs,\n  ensureDocsIndex,\n  getIndexStatus,\n  DOCS_TOOLS,\n  listDocs,\n  getDoc,\n} from \"@/services/mcp\";\nimport type { MCPToolName } from \"@/services/mcp\";\n\n// Create a stateless transport for serverless environment\nfunction createTransport() {\n  return new WebStandardStreamableHTTPServerTransport({\n    sessionIdGenerator: undefined, // Stateless mode for serverless\n    enableJsonResponse: true,\n  });\n}\n\n// Handle MCP protocol requests\nasync function handleMCPRequest(req: Request) {\n  const transport = createTransport();\n  const server = createMCPServer();\n\n  try {\n    await server.connect(transport);\n    const response = await transport.handleRequest(req);\n\n    // Clean up after response is done\n    response\n      .clone()\n      .body?.pipeTo(\n        new WritableStream({\n          close() {\n            transport.close();\n            server.close();\n          },\n        }),\n      )\n      .catch(() => {});\n\n    return response;\n  } catch (error) {\n    console.error(\"MCP request error:\", error);\n    return new Response(\n      JSON.stringify({\n        jsonrpc: \"2.0\",\n        error: {\n          code: -32603,\n          message: \"Internal server error\",\n        },\n        id: null,\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n\n// Handle REST API requests (original JSON format)\ninterface ToolCallRequest {\n  tool: MCPToolName;\n  params: Record<string, unknown>;\n}\n\nasync function handleRESTRequest(body: ToolCallRequest) {\n  try {\n    const { tool, params } = body;\n\n    if (!tool) {\n      return NextResponse.json(\n        { error: \"Missing 'tool' parameter\" },\n        { status: 400 },\n      );\n    }\n\n    switch (tool) {\n      case \"search_docs\": {\n        const query = String(params?.query || \"\");\n        const limit = typeof params?.limit === \"number\" ? params.limit : 6;\n        await ensureDocsIndex();\n        const results = await searchDocs(query, limit);\n        return NextResponse.json({\n          content: results.map(({ chunk, score }) => ({\n            path: chunk.path,\n            uri: chunk.uri,\n            score: score.toFixed(3),\n            text: chunk.text,\n          })),\n        });\n      }\n\n      case \"get_doc\": {\n        const path = String(params?.path || \"\");\n        const doc = await getDoc({ path });\n        if (!doc) {\n          return NextResponse.json(\n            { error: \"Document not found\" },\n            { status: 404 },\n          );\n        }\n        return NextResponse.json({ content: doc });\n      }\n\n      case \"list_docs\": {\n        const directory =\n          typeof params?.directory === \"string\" ? params.directory : undefined;\n        const docs = await listDocs({ directory });\n        return NextResponse.json({\n          content: docs.map((d) => ({\n            name: d.name,\n            path: d.path,\n            uri: d.uri,\n          })),\n        });\n      }\n\n      default:\n        return NextResponse.json(\n          { error: `Unknown tool: ${tool}` },\n          { status: 400 },\n        );\n    }\n  } catch (e: unknown) {\n    const message = e instanceof Error ? e.message : \"Unknown error\";\n    return NextResponse.json({ error: message }, { status: 500 });\n  }\n}\n\nexport async function POST(req: Request) {\n  // Clone the request to read body twice if needed\n  const clonedReq = req.clone();\n\n  try {\n    const body = await clonedReq.json();\n\n    // Check if this is an MCP protocol request (has jsonrpc field)\n    // or a REST API request (has tool field)\n    if (\"jsonrpc\" in body) {\n      // MCP protocol request - use the original request\n      return handleMCPRequest(req);\n    } else if (\"tool\" in body) {\n      // REST API request\n      return handleRESTRequest(body as ToolCallRequest);\n    } else {\n      return NextResponse.json(\n        {\n          error:\n            \"Invalid request format. Expected 'jsonrpc' (MCP) or 'tool' (REST) field.\",\n        },\n        { status: 400 },\n      );\n    }\n  } catch {\n    return NextResponse.json({ error: \"Invalid JSON body\" }, { status: 400 });\n  }\n}\n\nexport async function GET() {\n  // GET always returns REST API format (tools list and index status)\n  const status = getIndexStatus();\n  return NextResponse.json({\n    tools: DOCS_TOOLS,\n    index: {\n      ready: status.ready,\n      chunkCount: status.chunkCount,\n    },\n  });\n}\n\nexport async function DELETE(req: Request) {\n  // DELETE is only used by MCP protocol\n  return handleMCPRequest(req);\n}\n";

package/dist/templates/app/api/mcp/route.js

@@ -0,0 +1,179 @@
+export const mcpRoutesTemplate = `import { NextResponse } from "next/server";
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { createMCPServer } from "@/services/mcp/server";
+import {
+  searchDocs,
+  ensureDocsIndex,
+  getIndexStatus,
+  DOCS_TOOLS,
+  listDocs,
+  getDoc,
+} from "@/services/mcp";
+import type { MCPToolName } from "@/services/mcp";
+
+// Create a stateless transport for serverless environment
+function createTransport() {
+  return new WebStandardStreamableHTTPServerTransport({
+    sessionIdGenerator: undefined, // Stateless mode for serverless
+    enableJsonResponse: true,
+  });
+}
+
+// Handle MCP protocol requests
+async function handleMCPRequest(req: Request) {
+  const transport = createTransport();
+  const server = createMCPServer();
+
+  try {
+    await server.connect(transport);
+    const response = await transport.handleRequest(req);
+
+    // Clean up after response is done
+    response
+      .clone()
+      .body?.pipeTo(
+        new WritableStream({
+          close() {
+            transport.close();
+            server.close();
+          },
+        }),
+      )
+      .catch(() => {});
+
+    return response;
+  } catch (error) {
+    console.error("MCP request error:", error);
+    return new Response(
+      JSON.stringify({
+        jsonrpc: "2.0",
+        error: {
+          code: -32603,
+          message: "Internal server error",
+        },
+        id: null,
+      }),
+      {
+        status: 500,
+        headers: { "Content-Type": "application/json" },
+      },
+    );
+  }
+}
+
+// Handle REST API requests (original JSON format)
+interface ToolCallRequest {
+  tool: MCPToolName;
+  params: Record<string, unknown>;
+}
+
+async function handleRESTRequest(body: ToolCallRequest) {
+  try {
+    const { tool, params } = body;
+
+    if (!tool) {
+      return NextResponse.json(
+        { error: "Missing 'tool' parameter" },
+        { status: 400 },
+      );
+    }
+
+    switch (tool) {
+      case "search_docs": {
+        const query = String(params?.query || "");
+        const limit = typeof params?.limit === "number" ? params.limit : 6;
+        await ensureDocsIndex();
+        const results = await searchDocs(query, limit);
+        return NextResponse.json({
+          content: results.map(({ chunk, score }) => ({
+            path: chunk.path,
+            uri: chunk.uri,
+            score: score.toFixed(3),
+            text: chunk.text,
+          })),
+        });
+      }
+
+      case "get_doc": {
+        const path = String(params?.path || "");
+        const doc = await getDoc({ path });
+        if (!doc) {
+          return NextResponse.json(
+            { error: "Document not found" },
+            { status: 404 },
+          );
+        }
+        return NextResponse.json({ content: doc });
+      }
+
+      case "list_docs": {
+        const directory =
+          typeof params?.directory === "string" ? params.directory : undefined;
+        const docs = await listDocs({ directory });
+        return NextResponse.json({
+          content: docs.map((d) => ({
+            name: d.name,
+            path: d.path,
+            uri: d.uri,
+          })),
+        });
+      }
+
+      default:
+        return NextResponse.json(
+          { error: \`Unknown tool: \${tool}\` },
+          { status: 400 },
+        );
+    }
+  } catch (e: unknown) {
+    const message = e instanceof Error ? e.message : "Unknown error";
+    return NextResponse.json({ error: message }, { status: 500 });
+  }
+}
+
+export async function POST(req: Request) {
+  // Clone the request to read body twice if needed
+  const clonedReq = req.clone();
+
+  try {
+    const body = await clonedReq.json();
+
+    // Check if this is an MCP protocol request (has jsonrpc field)
+    // or a REST API request (has tool field)
+    if ("jsonrpc" in body) {
+      // MCP protocol request - use the original request
+      return handleMCPRequest(req);
+    } else if ("tool" in body) {
+      // REST API request
+      return handleRESTRequest(body as ToolCallRequest);
+    } else {
+      return NextResponse.json(
+        {
+          error:
+            "Invalid request format. Expected 'jsonrpc' (MCP) or 'tool' (REST) field.",
+        },
+        { status: 400 },
+      );
+    }
+  } catch {
+    return NextResponse.json({ error: "Invalid JSON body" }, { status: 400 });
+  }
+}
+
+export async function GET() {
+  // GET always returns REST API format (tools list and index status)
+  const status = getIndexStatus();
+  return NextResponse.json({
+    tools: DOCS_TOOLS,
+    index: {
+      ready: status.ready,
+      chunkCount: status.chunkCount,
+    },
+  });
+}
+
+export async function DELETE(req: Request) {
+  // DELETE is only used by MCP protocol
+  return handleMCPRequest(req);
+}
+`;

package/dist/templates/app/api/rag/route.d.ts

@@ -0,0 +1 @@
+export declare const ragRoutesTemplate = "import { NextResponse } from \"next/server\";\nimport path from \"node:path\";\nimport { getLLMConfig, createChatModel } from \"@/services/llm\";\nimport {\n  searchDocs,\n  ensureDocsIndex,\n  getIndexStatus,\n} from \"@/services/mcp/server\";\n\nconst PROJECT_ROOT = process.cwd();\n\nexport async function POST(req: Request) {\n  try {\n    const { question, refresh } = await req.json();\n\n    let config;\n    try {\n      config = getLLMConfig();\n    } catch (error: unknown) {\n      const message =\n        error instanceof Error ? error.message : \"LLM configuration error\";\n      return NextResponse.json({ error: message }, { status: 500 });\n    }\n\n    // Use MCP service to ensure docs are indexed\n    await ensureDocsIndex(Boolean(refresh));\n\n    // Use MCP search_docs tool to find relevant documentation\n    const searchResults = await searchDocs(String(question || \"\"), 6);\n\n    // Build context from search results\n    const context = searchResults\n      .map(\n        ({ chunk, score }) =>\n          `File: ${path.relative(PROJECT_ROOT, chunk.path)}\\nScore: ${score.toFixed(3)}\\n----\\n${chunk.text}`,\n      )\n      .join(\"\\n\\n================\\n\\n\");\n\n    // Create chat model and stream response\n    const llm = createChatModel(config);\n    const prompt = [\n      {\n        role: \"system\" as const,\n        content:\n          \"You are a helpful documentation assistant. Answer strictly from the provided context. If the answer is not in the context, say you don't know and suggest where to look. Make sure the mdx can be nested properly if you show code components within nested ```\",\n      },\n      {\n        role: \"user\" as const,\n        content: `Question: ${question}\\n\\nContext:\\n${context}`,\n      },\n    ];\n\n    const stream = await llm.stream(prompt);\n\n    // Build metadata from MCP search results\n    const indexStatus = getIndexStatus();\n    const metadata = {\n      sources: searchResults.map(({ chunk, score }) => ({\n        id: chunk.id,\n        path: path.relative(PROJECT_ROOT, chunk.path),\n        uri: chunk.uri,\n        score,\n      })),\n      chunkCount: indexStatus.chunkCount,\n    };\n\n    const encoder = new TextEncoder();\n    const readableStream = new ReadableStream({\n      async start(controller) {\n        try {\n          controller.enqueue(\n            encoder.encode(\n              `data: ${JSON.stringify({ type: \"metadata\", data: metadata })}\\n\\n`,\n            ),\n          );\n\n          for await (const chunk of stream) {\n            const content = chunk?.content || \"\";\n            if (content) {\n              controller.enqueue(\n                encoder.encode(\n                  `data: ${JSON.stringify({ type: \"content\", data: content })}\\n\\n`,\n                ),\n              );\n            }\n          }\n\n          controller.enqueue(\n            encoder.encode(`data: ${JSON.stringify({ type: \"done\" })}\\n\\n`),\n          );\n          controller.close();\n        } catch (error: unknown) {\n          const message =\n            error instanceof Error ? error.message : \"Stream error\";\n          controller.enqueue(\n            encoder.encode(\n              `data: ${JSON.stringify({ type: \"error\", data: message })}\\n\\n`,\n            ),\n          );\n          controller.close();\n        }\n      },\n    });\n\n    return new Response(readableStream, {\n      headers: {\n        \"Content-Type\": \"text/event-stream\",\n        \"Cache-Control\": \"no-cache\",\n        Connection: \"keep-alive\",\n      },\n    });\n  } catch (e: unknown) {\n    const message = e instanceof Error ? e.message : \"Unknown error\";\n    return NextResponse.json({ error: message }, { status: 500 });\n  }\n}\n\nexport async function GET() {\n  const status = getIndexStatus();\n  return NextResponse.json({\n    ready: status.ready,\n    chunks: status.chunkCount,\n  });\n}\n";

package/dist/templates/app/api/rag/route.js

@@ -0,0 +1,125 @@
+export const ragRoutesTemplate = `import { NextResponse } from "next/server";
+import path from "node:path";
+import { getLLMConfig, createChatModel } from "@/services/llm";
+import {
+  searchDocs,
+  ensureDocsIndex,
+  getIndexStatus,
+} from "@/services/mcp/server";
+
+const PROJECT_ROOT = process.cwd();
+
+export async function POST(req: Request) {
+  try {
+    const { question, refresh } = await req.json();
+
+    let config;
+    try {
+      config = getLLMConfig();
+    } catch (error: unknown) {
+      const message =
+        error instanceof Error ? error.message : "LLM configuration error";
+      return NextResponse.json({ error: message }, { status: 500 });
+    }
+
+    // Use MCP service to ensure docs are indexed
+    await ensureDocsIndex(Boolean(refresh));
+
+    // Use MCP search_docs tool to find relevant documentation
+    const searchResults = await searchDocs(String(question || ""), 6);
+
+    // Build context from search results
+    const context = searchResults
+      .map(
+        ({ chunk, score }) =>
+          \`File: \${path.relative(PROJECT_ROOT, chunk.path)}\\nScore: \${score.toFixed(3)}\\n----\\n\${chunk.text}\`,
+      )
+      .join("\\n\\n================\\n\\n");
+
+    // Create chat model and stream response
+    const llm = createChatModel(config);
+    const prompt = [
+      {
+        role: "system" as const,
+        content:
+          "You are a helpful documentation assistant. Answer strictly from the provided context. If the answer is not in the context, say you don't know and suggest where to look. Make sure the mdx can be nested properly if you show code components within nested \`\`\`",
+      },
+      {
+        role: "user" as const,
+        content: \`Question: \${question}\\n\\nContext:\\n\${context}\`,
+      },
+    ];
+
+    const stream = await llm.stream(prompt);
+
+    // Build metadata from MCP search results
+    const indexStatus = getIndexStatus();
+    const metadata = {
+      sources: searchResults.map(({ chunk, score }) => ({
+        id: chunk.id,
+        path: path.relative(PROJECT_ROOT, chunk.path),
+        uri: chunk.uri,
+        score,
+      })),
+      chunkCount: indexStatus.chunkCount,
+    };
+
+    const encoder = new TextEncoder();
+    const readableStream = new ReadableStream({
+      async start(controller) {
+        try {
+          controller.enqueue(
+            encoder.encode(
+              \`data: \${JSON.stringify({ type: "metadata", data: metadata })}\\n\\n\`,
+            ),
+          );
+
+          for await (const chunk of stream) {
+            const content = chunk?.content || "";
+            if (content) {
+              controller.enqueue(
+                encoder.encode(
+                  \`data: \${JSON.stringify({ type: "content", data: content })}\\n\\n\`,
+                ),
+              );
+            }
+          }
+
+          controller.enqueue(
+            encoder.encode(\`data: \${JSON.stringify({ type: "done" })}\\n\\n\`),
+          );
+          controller.close();
+        } catch (error: unknown) {
+          const message =
+            error instanceof Error ? error.message : "Stream error";
+          controller.enqueue(
+            encoder.encode(
+              \`data: \${JSON.stringify({ type: "error", data: message })}\\n\\n\`,
+            ),
+          );
+          controller.close();
+        }
+      },
+    });
+
+    return new Response(readableStream, {
+      headers: {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache",
+        Connection: "keep-alive",
+      },
+    });
+  } catch (e: unknown) {
+    const message = e instanceof Error ? e.message : "Unknown error";
+    return NextResponse.json({ error: message }, { status: 500 });
+  }
+}
+
+export async function GET() {
+  const status = getIndexStatus();
+  return NextResponse.json({
+    ready: status.ready,
+    chunks: status.chunkCount,
+  });
+}
+`;

package/dist/templates/app/api/theme/routes.d.ts

@@ -1 +1 @@
-export declare const routesTemplate = "import { NextResponse } from \"next/server\";\nimport { cookies } from \"next/headers\";\n\nexport async function POST(request: Request) {\n  try {\n    const { theme } = await request.json();\n    if (theme !== \"light\" && theme !== \"dark\") {\n      return NextResponse.json(\n        { ok: false, error: \"Invalid theme\" },\n        { status: 400 },\n      );\n    }\n\n    const cookieStore = await cookies();\n    cookieStore.set(\"theme\", theme, {\n      path: \"/\",\n      maxAge: 60 * 60 * 24 * 365,\n      sameSite: \"lax\",\n    });\n\n    return NextResponse.json({ ok: true });\n  } catch (e) {\n    return NextResponse.json(\n      { ok: false, error: \"Bad Request\" },\n      { status: 400 },\n    );\n  }\n}";
+export declare const routesTemplate = "import { NextResponse } from \"next/server\";\nimport { cookies } from \"next/headers\";\n\nexport async function POST(request: Request) {\n  try {\n    const { theme } = await request.json();\n    if (theme !== \"light\" && theme !== \"dark\") {\n      return NextResponse.json(\n        { ok: false, error: \"Invalid theme\" },\n        { status: 400 },\n      );\n    }\n\n    const cookieStore = await cookies();\n    cookieStore.set(\"theme\", theme, {\n      path: \"/\",\n      maxAge: 60 * 60 * 24 * 365,\n      sameSite: \"lax\",\n    });\n\n    return NextResponse.json({ ok: true });\n  } catch (e) {\n    return NextResponse.json(\n      { ok: false, error: \"Bad Request\" },\n      { status: 400 },\n    );\n  }\n}\n";