@assistant-ui/mcp-docs-server 0.1.17 → 0.1.18

package/.docs/organized/code-examples/with-tanstack.md

@@ -22,7 +22,8 @@
 
 ```json
 {
-  "name": "assistant-ui-with-tanstack",
+  "name": "with-tanstack",
+  "version": "0.0.0",
   "private": true,
   "type": "module",
   "scripts": {
@@ -36,28 +37,28 @@
     "@radix-ui/react-slot": "^1.2.4",
     "@radix-ui/react-tooltip": "^1.2.8",
     "@tailwindcss/vite": "^4.1.18",
-    "@tanstack/react-router": "^1.141.1",
-    "@tanstack/react-start": "^1.141.1",
-    "@tanstack/router-plugin": "^1.141.1",
+    "@tanstack/react-router": "^1.141.8",
+    "@tanstack/react-start": "^1.142.1",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.560.0",
-    "nitro": "latest",
-    "openai": "^6.10.0",
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3",
+    "lucide-react": "^0.562.0",
+    "nitro": "^3.0.1-alpha.1",
+    "openai": "^6.15.0",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.4.0",
     "tailwindcss": "^4.1.18",
-    "vite-tsconfig-paths": "^5.1.4"
+    "vite-tsconfig-paths": "^6.0.3"
   },
   "devDependencies": {
-    "@types/node": "^25.0.0",
+    "@assistant-ui/x-buildutils": "workspace:*",
+    "@types/node": "^25.0.3",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^5.1.2",
     "typescript": "^5.9.3",
-    "vite": "^7.2.7"
+    "vite": "^7.3.0"
   }
 }
 
@@ -368,7 +369,7 @@ const ThreadScrollToBottom: FC = () => {
       <TooltipIconButton
         tooltip="Scroll to bottom"
         variant="outline"
-        className="aui-thread-scroll-to-bottom -top-12 absolute z-10 self-center rounded-full p-4 disabled:invisible dark:bg-background dark:hover:bg-accent"
+        className="aui-thread-scroll-to-bottom absolute -top-12 z-10 self-center rounded-full p-4 disabled:invisible dark:bg-background dark:hover:bg-accent"
       >
         <ArrowDownIcon />
       </TooltipIconButton>
@@ -541,7 +542,7 @@ const AssistantActionBar: FC = () => {
       hideWhenRunning
       autohide="not-last"
       autohideFloat="single-branch"
-      className="aui-assistant-action-bar-root -ml-1 col-start-3 row-start-2 flex gap-1 text-muted-foreground data-floating:absolute data-floating:rounded-md data-floating:border data-floating:bg-background data-floating:p-1 data-floating:shadow-sm"
+      className="aui-assistant-action-bar-root col-start-3 row-start-2 -ml-1 flex gap-1 text-muted-foreground data-floating:absolute data-floating:rounded-md data-floating:border data-floating:bg-background data-floating:p-1 data-floating:shadow-sm"
     >
       <ActionBarPrimitive.Copy asChild>
         <TooltipIconButton tooltip="Copy">
@@ -572,12 +573,12 @@ const UserMessage: FC = () => {
         <div className="aui-user-message-content wrap-break-word rounded-3xl bg-muted px-5 py-2.5 text-foreground">
           <MessagePrimitive.Parts />
         </div>
-        <div className="aui-user-action-bar-wrapper -translate-x-full -translate-y-1/2 absolute top-1/2 left-0 pr-2">
+        <div className="aui-user-action-bar-wrapper absolute top-1/2 left-0 -translate-x-full -translate-y-1/2 pr-2">
           <UserActionBar />
         </div>
       </div>
 
-      <BranchPicker className="aui-user-branch-picker -mr-1 col-span-full col-start-1 row-start-3 justify-end" />
+      <BranchPicker className="aui-user-branch-picker col-span-full col-start-1 row-start-3 -mr-1 justify-end" />
     </MessagePrimitive.Root>
   );
 };
@@ -632,7 +633,7 @@ const BranchPicker: FC<BranchPickerPrimitive.Root.Props> = ({
     <BranchPickerPrimitive.Root
       hideWhenSingleBranch
       className={cn(
-        "aui-branch-picker-root -ml-2 mr-2 inline-flex items-center text-muted-foreground text-xs",
+        "aui-branch-picker-root mr-2 -ml-2 inline-flex items-center text-muted-foreground text-xs",
         className,
       )}
       {...rest}
@@ -1516,32 +1517,13 @@ export const chatStream = createServerFn({ method: "POST" })
 
 ```json
 {
-  "include": ["**/*.ts", "**/*.tsx"],
+  "extends": "@assistant-ui/x-buildutils/ts/base",
   "compilerOptions": {
-    "target": "ES2022",
-    "jsx": "react-jsx",
-    "module": "ESNext",
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
     "types": ["vite/client"],
-
-    /* Bundler mode */
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": false,
-    "noEmit": true,
-
-    /* Linting */
-    "skipLibCheck": true,
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedSideEffectImports": true,
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["./src/*"]
-    }
-  }
+    "paths": { "@/*": ["./src/*"] }
+  },
+  "include": ["**/*.ts", "**/*.tsx"],
+  "exclude": ["node_modules"]
 }
 
 ```

package/.docs/raw/docs/runtimes/custom/custom-thread-list.mdx

@@ -217,6 +217,42 @@ When the hook mounts it calls `list()` on your adapter, hydrates existing thread
 - `generateTitle()` powers the automatic title button and expects an `AssistantStream`.
 - Provide a `runtimeHook` that always returns a fresh runtime instance per active thread.
 
+## Avoiding Race Conditions in History Adapters
+
+<Callout type="warn">
+When implementing a custom history adapter, you must await thread initialization before saving messages. Failing to do so can cause the first message to be lost due to a race condition.
+</Callout>
+
+If you're building a history adapter that persists messages to your own database, use `api.threadListItem().initialize()` to ensure the thread is fully initialized before saving:
+
+```tsx
+import { useAssistantApi } from "@assistant-ui/react";
+
+// Inside your unstable_Provider component
+const api = useAssistantApi();
+
+const history = useMemo<ThreadHistoryAdapter>(
+  () => ({
+    async append(message) {
+      // Wait for initialization to complete and get the remoteId
+      const { remoteId } = await api.threadListItem().initialize();
+
+      // Now safe to save the message using the remoteId
+      await saveMessageToDatabase(remoteId, message);
+    },
+    // ...
+  }),
+  [api],
+);
+```
+
+The `initialize()` method:
+- Can be called multiple times safely
+- Always waits for the initial `initialize()` call to complete
+- Returns the same `remoteId` on subsequent calls
+
+See `AssistantCloudThreadHistoryAdapter` in the source code for a production-ready reference implementation.
+
 ## Optional Adapters
 
 If you need history or attachment support, expose them via `unstable_Provider`. The cloud implementation wraps each thread runtime with `RuntimeAdapterProvider` to inject:

package/.docs/raw/docs/runtimes/custom/local.mdx

@@ -415,7 +415,7 @@ For custom thread storage, use `useRemoteThreadListRuntime` with your own adapte
 ```tsx
 import {
   unstable_useRemoteThreadListRuntime as useRemoteThreadListRuntime,
-  useThreadListItem,
+  useAssistantApi,
   RuntimeAdapterProvider,
   AssistantRuntimeProvider,
   type unstable_RemoteThreadListAdapter as RemoteThreadListAdapter,
@@ -487,13 +487,13 @@ export function MyRuntimeProvider({ children }) {
       // The Provider component adds thread-specific adapters
       unstable_Provider: ({ children }) => {
         // This runs in the context of each thread
-        const threadListItem = useThreadListItem();
-        const remoteId = threadListItem.remoteId;
+        const api = useAssistantApi();
 
         // Create thread-specific history adapter
         const history = useMemo<ThreadHistoryAdapter>(
           () => ({
             async load() {
+              const { remoteId } = api.threadListItem().getState();
               if (!remoteId) return { messages: [] };
 
               const messages = await db.messages.findByThreadId(remoteId);
@@ -508,10 +508,8 @@ export function MyRuntimeProvider({ children }) {
             },
 
             async append(message) {
-              if (!remoteId) {
-                console.warn("Cannot save message - thread not initialized");
-                return;
-              }
+              // Wait for initialization to get remoteId (safe to call multiple times)
+              const { remoteId } = await api.threadListItem().initialize();
 
               await db.messages.create({
                 threadId: remoteId,
@@ -522,7 +520,7 @@ export function MyRuntimeProvider({ children }) {
               });
             },
           }),
-          [remoteId],
+          [api],
         );
 
         const adapters = useMemo(() => ({ history }), [history]);
@@ -570,6 +568,31 @@ The complete multi-thread implementation requires:
 
 Without the history adapter, threads would have no message persistence, making them effectively useless. The Provider pattern allows you to add thread-specific functionality while keeping the runtime creation simple.
 
+<Callout type="warn" title="Avoiding Race Conditions">
+When implementing a history adapter, `append()` may be called before the thread is fully initialized, causing the first message to be lost. Instead of checking `if (!remoteId)`, await initialization to ensure the `remoteId` is available:
+
+```tsx
+import { useAssistantApi } from "@assistant-ui/react";
+
+// Inside your unstable_Provider component
+const api = useAssistantApi();
+
+const history = useMemo<ThreadHistoryAdapter>(
+  () => ({
+    async append(message) {
+      // Wait for initialization - safe to call multiple times
+      const { remoteId } = await api.threadListItem().initialize();
+      await db.messages.create({ threadId: remoteId, ...message });
+    },
+    // ...
+  }),
+  [api],
+);
+```
+
+See `AssistantCloudThreadHistoryAdapter` in the source for a production reference.
+</Callout>
+
 #### Database Schema Example
 
 ```typescript

package/.docs/raw/docs/ui/Scrollbar.mdx

@@ -11,12 +11,6 @@ An example implementation of this is [shadcn/ui's Scroll Area](https://ui.shadcn
 
 <InstallCommand shadcn={["scroll-area"]} />
 
-### @radix-ui/react-scroll-area v1.2.0 release candidate required
-
-The v1.2.0-rc.x release candidate can be installed via
-
-<InstallCommand npm={["@radix-ui/react-scroll-area@next"]} />
-
 ## Additional Styles
 
 The Radix UI Viewport component adds an intermediate `<div data-radix-scroll-area-content>` element.

package/dist/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const ROOT_DIR: string;
+export declare const PACKAGE_DIR: string;
+export declare const EXAMPLES_PATH: string;
+export declare const DOCS_PATH: string;
+export declare const CODE_EXAMPLES_PATH: string;
+export declare const MDX_EXTENSION = ".mdx";
+export declare const MD_EXTENSION = ".md";
+export declare const MAX_FILE_SIZE: number;
+export declare const IS_PREPARE_MODE: boolean | undefined;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,QAAQ,QAA+B,CAAC;AACrD,eAAO,MAAM,WAAW,QAAyB,CAAC;AAElD,eAAO,MAAM,aAAa,QAA6B,CAAC;AAGxD,eAAO,MAAM,SAAS,QAA8B,CAAC;AACrD,eAAO,MAAM,kBAAkB,QAA6C,CAAC;AAE7E,eAAO,MAAM,aAAa,SAAS,CAAC;AACpC,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,eAAO,MAAM,aAAa,QAAmB,CAAC;AAE9C,eAAO,MAAM,eAAe,qBAE3B,CAAC"}

package/dist/constants.js

@@ -0,0 +1,14 @@
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export const ROOT_DIR = join(__dirname, "../../../");
+export const PACKAGE_DIR = join(__dirname, "../");
+export const EXAMPLES_PATH = join(ROOT_DIR, "examples");
+const DOCS_BASE = join(PACKAGE_DIR, ".docs");
+export const DOCS_PATH = join(DOCS_BASE, "raw/docs");
+export const CODE_EXAMPLES_PATH = join(DOCS_BASE, "organized/code-examples");
+export const MDX_EXTENSION = ".mdx";
+export const MD_EXTENSION = ".md";
+export const MAX_FILE_SIZE = 10 * 1024 * 1024;
+export const IS_PREPARE_MODE = process.argv[1]?.includes("prepare-docs/prepare");
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAExD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAElC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CACtD,sBAAsB,CACvB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const server: McpServer;
+export declare function runServer(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAcpE,eAAO,MAAM,MAAM,WAGjB,CAAC;AAeH,wBAAsB,SAAS,kBAW9B"}

package/dist/index.js

@@ -1 +1,33 @@
-export { runServer, server } from './chunk-NVNFQ5ZO.js';
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { docsTools } from "./tools/docs.js";
+import { examplesTools } from "./tools/examples.js";
+import { logger } from "./utils/logger.js";
+import { PACKAGE_DIR } from "./constants.js";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+const packageJson = JSON.parse(readFileSync(join(PACKAGE_DIR, "package.json"), "utf-8"));
+export const server = new McpServer({
+    name: "assistant-ui-docs",
+    version: packageJson.version,
+});
+server.tool(docsTools.name, docsTools.description, docsTools.parameters, docsTools.execute);
+server.tool(examplesTools.name, examplesTools.description, examplesTools.parameters, examplesTools.execute);
+export async function runServer() {
+    try {
+        logger.info(`Starting assistant-ui MCP docs server v${packageJson.version}`);
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+    }
+    catch (error) {
+        logger.error("Failed to start MCP server", error);
+        process.exit(1);
+    }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    void runServer().catch((error) => {
+        console.error("Failed to start server:", error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CACzD,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAClC,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,WAAW,CAAC,OAAO;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,IAAI,CACT,SAAS,CAAC,IAAI,EACd,SAAS,CAAC,WAAW,EACrB,SAAS,CAAC,UAAU,EACpB,SAAS,CAAC,OAAO,CAClB,CAAC;AACF,MAAM,CAAC,IAAI,CACT,aAAa,CAAC,IAAI,EAClB,aAAa,CAAC,WAAW,EACzB,aAAa,CAAC,UAAU,EACxB,aAAa,CAAC,OAAO,CACtB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,CACT,0CAA0C,WAAW,CAAC,OAAO,EAAE,CAChE,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,KAAK,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC/B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/prepare-docs/code-examples.d.ts

@@ -0,0 +1,2 @@
+export declare function prepareCodeExamples(): Promise<void>;
+//# sourceMappingURL=code-examples.d.ts.map

package/dist/prepare-docs/code-examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-examples.d.ts","sourceRoot":"","sources":["../../src/prepare-docs/code-examples.ts"],"names":[],"mappings":"AA2FA,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkEzD"}

package/dist/prepare-docs/code-examples.js

@@ -0,0 +1,129 @@
+import { rm, mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { join, relative, extname } from "node:path";
+import { logger } from "../utils/logger.js";
+import { ROOT_DIR, EXAMPLES_PATH } from "../constants.js";
+const OUTPUT_DIR = join(ROOT_DIR, "packages/mcp-docs-server/.docs/organized/code-examples");
+const MAX_LINES = 10000;
+async function scanDirectory(dir, baseDir) {
+    const files = [];
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                const skipDirs = [
+                    "node_modules",
+                    "dist",
+                    "build",
+                    ".next",
+                    ".git",
+                    ".turbo",
+                ];
+                if (!skipDirs.includes(entry.name)) {
+                    const subFiles = await scanDirectory(fullPath, baseDir);
+                    files.push(...subFiles);
+                }
+            }
+            else if (entry.isFile()) {
+                const includeExts = [
+                    ".ts",
+                    ".tsx",
+                    ".js",
+                    ".jsx",
+                    ".json",
+                    ".css",
+                    ".md",
+                    ".mdx",
+                ];
+                const ext = extname(entry.name).toLowerCase();
+                if (includeExts.includes(ext) ||
+                    entry.name === "package.json" ||
+                    entry.name === "tsconfig.json") {
+                    try {
+                        const content = await readFile(fullPath, "utf-8");
+                        const relativePath = relative(baseDir, fullPath);
+                        files.push({ path: relativePath, content });
+                    }
+                    catch (error) {
+                        logger.warn(`Failed to read file: ${fullPath}`, error);
+                    }
+                }
+            }
+        }
+    }
+    catch (error) {
+        logger.error(`Failed to scan directory: ${dir}`, error);
+    }
+    return files;
+}
+function getFileType(filename) {
+    const ext = extname(filename).toLowerCase();
+    const extMap = {
+        ".ts": "typescript",
+        ".tsx": "tsx",
+        ".js": "javascript",
+        ".jsx": "jsx",
+        ".json": "json",
+        ".css": "css",
+        ".md": "markdown",
+        ".mdx": "mdx",
+    };
+    return extMap[ext] || "text";
+}
+export async function prepareCodeExamples() {
+    logger.info("Preparing code examples...");
+    try {
+        await rm(OUTPUT_DIR, { recursive: true, force: true });
+        await mkdir(OUTPUT_DIR, { recursive: true });
+        const exampleDirs = await readdir(EXAMPLES_PATH, { withFileTypes: true });
+        for (const dir of exampleDirs) {
+            if (dir.isDirectory() && !dir.name.startsWith(".")) {
+                const examplePath = join(EXAMPLES_PATH, dir.name);
+                logger.info(`Processing example: ${dir.name}`);
+                let description = "";
+                try {
+                    const packageJsonPath = join(examplePath, "package.json");
+                    const packageJson = JSON.parse(await readFile(packageJsonPath, "utf-8"));
+                    description = packageJson.description || "";
+                }
+                catch (error) {
+                    if (error?.code !== "ENOENT") {
+                        logger.warn(`Failed to read package.json for ${dir.name}:`, error);
+                    }
+                    else {
+                        logger.debug(`No package.json found for example: ${dir.name}`);
+                    }
+                }
+                const files = await scanDirectory(examplePath, examplePath);
+                files.sort((a, b) => a.path.localeCompare(b.path));
+                let markdown = `# Example: ${dir.name}\n\n`;
+                if (description) {
+                    markdown += `${description}\n\n`;
+                }
+                let totalLines = 0;
+                for (const file of files) {
+                    const lines = file.content.split("\n").length;
+                    if (totalLines + lines > MAX_LINES) {
+                        markdown += `\n_Note: Additional files truncated due to size limits_\n`;
+                        break;
+                    }
+                    // Normalize Windows backslashes to forward slashes for consistent markdown output
+                    markdown += `## ${file.path.replace(/\\/g, "/")}\n\n`;
+                    markdown += `\`\`\`${getFileType(file.path)}\n`;
+                    markdown += file.content;
+                    markdown += `\n\`\`\`\n\n`;
+                    totalLines += lines;
+                }
+                const outputPath = join(OUTPUT_DIR, `${dir.name}.md`);
+                await writeFile(outputPath, markdown, "utf-8");
+                logger.debug(`Created example: ${outputPath}`);
+            }
+        }
+        logger.info("Code examples preparation complete");
+    }
+    catch (error) {
+        logger.error("Failed to prepare code examples", error);
+        throw error;
+    }
+}
+//# sourceMappingURL=code-examples.js.map

package/dist/prepare-docs/code-examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-examples.js","sourceRoot":"","sources":["../../src/prepare-docs/code-examples.ts"],"names":[],"mappings":"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"}

package/dist/prepare-docs/copy-raw.d.ts

@@ -0,0 +1,2 @@
+export declare function copyRaw(): Promise<void>;
+//# sourceMappingURL=copy-raw.d.ts.map

package/dist/prepare-docs/copy-raw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-raw.d.ts","sourceRoot":"","sources":["../../src/prepare-docs/copy-raw.ts"],"names":[],"mappings":"AAkCA,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAoB7C"}

package/dist/prepare-docs/copy-raw.js

@@ -0,0 +1,50 @@
+import { rm, mkdir, readdir, copyFile } from "node:fs/promises";
+import { join, extname } from "node:path";
+import { logger } from "../utils/logger.js";
+import { ROOT_DIR } from "../constants.js";
+const DOCS_SOURCE = join(ROOT_DIR, "apps/docs/content/docs");
+const BLOG_SOURCE = join(ROOT_DIR, "apps/docs/content/blog");
+const DOCS_DEST = join(ROOT_DIR, "packages/mcp-docs-server/.docs/raw");
+async function copyDir(src, dest) {
+    try {
+        await mkdir(dest, { recursive: true });
+        const entries = await readdir(src, { withFileTypes: true });
+        for (const entry of entries) {
+            const srcPath = join(src, entry.name);
+            const destPath = join(dest, entry.name);
+            if (entry.isDirectory()) {
+                await copyDir(srcPath, destPath);
+            }
+            else if (entry.isFile()) {
+                const ext = extname(entry.name).toLowerCase();
+                if (ext === ".mdx" || ext === ".md") {
+                    await copyFile(srcPath, destPath);
+                    logger.debug(`Copied: ${srcPath} -> ${destPath}`);
+                }
+            }
+        }
+    }
+    catch (error) {
+        logger.error(`Failed to copy directory: ${src}`, error);
+        throw error;
+    }
+}
+export async function copyRaw() {
+    logger.info("Copying raw documentation files...");
+    try {
+        await rm(DOCS_DEST, { recursive: true, force: true });
+        await mkdir(DOCS_DEST, { recursive: true });
+        const docsPath = join(DOCS_DEST, "docs");
+        await copyDir(DOCS_SOURCE, docsPath);
+        logger.info(`Copied documentation to ${docsPath}`);
+        const blogPath = join(DOCS_DEST, "blog");
+        await copyDir(BLOG_SOURCE, blogPath);
+        logger.info(`Copied blog posts to ${blogPath}`);
+        logger.info("Raw documentation copy complete");
+    }
+    catch (error) {
+        logger.error("Failed to copy raw documentation", error);
+        throw error;
+    }
+}
+//# sourceMappingURL=copy-raw.js.map

package/dist/prepare-docs/copy-raw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-raw.js","sourceRoot":"","sources":["../../src/prepare-docs/copy-raw.ts"],"names":[],"mappings":"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"}

package/dist/prepare-docs/prepare.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prepare.d.ts.map

package/dist/prepare-docs/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../src/prepare-docs/prepare.ts"],"names":[],"mappings":""}