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

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":""}

package/dist/prepare-docs/prepare.js

@@ -1,199 +1,22 @@
-import { ROOT_DIR, logger, EXAMPLES_PATH } from '../chunk-M2RKUM66.js';
-import { rm, mkdir, readdir, readFile, writeFile, copyFile } from 'fs/promises';
-import { join, extname, relative } from 'path';
-
-var DOCS_SOURCE = join(ROOT_DIR, "apps/docs/content/docs");
-var BLOG_SOURCE = join(ROOT_DIR, "apps/docs/content/blog");
-var 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;
-  }
-}
-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;
-  }
-}
-var OUTPUT_DIR = join(
-  ROOT_DIR,
-  "packages/mcp-docs-server/.docs/organized/code-examples"
-);
-var MAX_LINES = 1e4;
-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);
-          }
-        }
-      }
+import { logger } from "../utils/logger.js";
+import { copyRaw } from "./copy-raw.js";
+import { prepareCodeExamples } from "./code-examples.js";
+async function prepare() {
+    logger.info("Starting documentation preparation...");
+    try {
+        await copyRaw();
+        await prepareCodeExamples();
+        logger.info("Documentation preparation complete");
     }
-  } 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";
-}
-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}
-
-`;
-        if (description) {
-          markdown += `${description}
-
-`;
-        }
-        let totalLines = 0;
-        for (const file of files) {
-          const lines = file.content.split("\n").length;
-          if (totalLines + lines > MAX_LINES) {
-            markdown += `
-_Note: Additional files truncated due to size limits_
-`;
-            break;
-          }
-          markdown += `## ${file.path.replace(/\\/g, "/")}
-
-`;
-          markdown += `\`\`\`${getFileType(file.path)}
-`;
-          markdown += file.content;
-          markdown += `
-\`\`\`
-
-`;
-          totalLines += lines;
-        }
-        const outputPath = join(OUTPUT_DIR, `${dir.name}.md`);
-        await writeFile(outputPath, markdown, "utf-8");
-        logger.debug(`Created example: ${outputPath}`);
-      }
+    catch (error) {
+        logger.error("Documentation preparation failed", error);
+        throw error;
     }
-    logger.info("Code examples preparation complete");
-  } catch (error) {
-    logger.error("Failed to prepare code examples", error);
-    throw error;
-  }
-}
-
-// src/prepare-docs/prepare.ts
-async function prepare() {
-  logger.info("Starting documentation preparation...");
-  try {
-    await copyRaw();
-    await prepareCodeExamples();
-    logger.info("Documentation preparation complete");
-  } catch (error) {
-    logger.error("Documentation preparation failed", error);
-    throw error;
-  }
 }
-if (process.env.PREPARE === "true") {
-  prepare().catch((error) => {
-    logger.error("Preparation failed", error);
-    process.exit(1);
-  });
+if (import.meta.url === `file://${process.argv[1]}`) {
+    prepare().catch((error) => {
+        logger.error("Preparation failed", error);
+        process.exit(1);
+    });
 }
-
-export { prepare };
+//# sourceMappingURL=prepare.js.map