@assistant-ui/mcp-docs-server 0.1.32 → 0.1.34

package/.docs/raw/docs/{integrations/tools/react-mcp.mdx → tools/user-managed-mcp.mdx}

@@ -3,7 +3,7 @@ title: User-managed MCP servers
 description: Let end users add and authenticate MCP servers from the browser with @assistant-ui/react-mcp.
 ---
 
-[`@assistant-ui/react-mcp`](https://npmjs.com/package/@assistant-ui/react-mcp) is the user-facing layer for MCP. Where the [server-side MCP guide](/docs/integrations/tools/mcp) wires a single fixed set of MCP servers into your API route, this package lets *end users* see a list of connectors, sign in via OAuth, paste a custom server URL, and have the resulting tool catalog flow into the chat — automatically.
+[`@assistant-ui/react-mcp`](https://npmjs.com/package/@assistant-ui/react-mcp) is the user-facing layer for MCP. Where the [server-side MCP guide](/docs/tools/mcp) wires a single fixed set of MCP servers into your API route, this package lets *end users* see a list of connectors, sign in via OAuth, paste a custom server URL, and have the resulting tool catalog flow into the chat — automatically.
 
 Two ways a server reaches the user:
 
@@ -17,12 +17,12 @@ Both flow through one connection lifecycle, one persisted state surface, and one
 ```
 useAui({ mcp: McpManagerResource({ connectors }) })
         │
-        ├─ Tap resource — connection lifecycle, server lookup, OAuth/bearer auth
+        ├─ Resource — connection lifecycle, server lookup, OAuth/bearer auth
         ├─ Auto-mounts the modelContext scope when no chat runtime provides one
         └─ Registers connected tools as frontend tools — your chat sees them automatically
 ```
 
-The manager is a single tap resource. Mount it with `useAui` like any other scope. OAuth (PKCE + RFC 7591 dynamic client registration), bearer, and "no auth" are first-class. Token refresh runs inside the MCP SDK on 401; this package mediates persistence and the redirect step.
+The manager is a single resource. Mount it with `useAui` like any other scope. OAuth (PKCE + RFC 7591 dynamic client registration), bearer, and "no auth" are first-class. Token refresh runs inside the MCP SDK on 401; this package mediates persistence and the redirect step.
 
 ## Setup
 
@@ -221,7 +221,7 @@ Tool names are prefixed `serverId__toolName` to avoid collisions across connecte
 If no chat runtime is mounted, `McpManagerResource` brings its own minimal `modelContext` along. Tools are still callable directly:
 
 ```ts
-// In an event handler — never in render. See the tap conventions.
+// In an event handler, never in render.
 const aui = useAui();
 const out = await aui.mcp().server({ id: "linear" }).callTool("search", { q });
 ```
@@ -293,7 +293,7 @@ const connectionState = useAuiState((s) => s.mcpServer.connectionState);
 //                                          ^ requires McpServerByIdProvider
 ```
 
-Imperative methods — `useAui` + resolve in a callback (never during render — see the [tap skill](https://github.com/assistant-ui/assistant-ui/blob/main/.claude/skills/tap/SKILL.md) for why):
+Imperative methods: `useAui` + resolve in a callback (never during render):
 
 ```ts
 const aui = useAui();
@@ -327,11 +327,11 @@ What's deferred:
   <Card
     title="Server-side MCP"
     description="App-developer-controlled MCP servers wired into the API route."
-    href="/docs/integrations/tools/mcp"
+    href="/docs/tools/mcp"
   />
   <Card
     title="Tools and tool UI"
     description="Build custom renderers for tool calls and approvals."
-    href="/docs/guides/tools"
+    href="/docs/tools/defining-tools"
   />
 </Cards>

package/.docs/raw/docs/ui/directive-text.mdx

@@ -49,7 +49,7 @@ Keep your markdown renderer (e.g. `MarkdownText`) for assistant messages — ass
 
 ```tsx
 import { createDirectiveText } from "@/components/assistant-ui/directive-text";
-import { unstable_defaultDirectiveFormatter } from "@assistant-ui/core";
+import { unstable_defaultDirectiveFormatter } from "@assistant-ui/react";
 import { FileTextIcon, SparklesIcon, UserIcon, WrenchIcon } from "lucide-react";
 
 const DirectiveTextWithIcons = createDirectiveText(
@@ -74,7 +74,7 @@ A matching `iconMap` / `fallbackIcon` option is accepted by [`ComposerTriggerPop
 The default format is `:type[label]{name=id}`. For a different format, build a custom `Unstable_DirectiveFormatter` and wrap it with `createDirectiveText`:
 
 ```tsx
-import type { Unstable_DirectiveFormatter } from "@assistant-ui/core";
+import type { Unstable_DirectiveFormatter } from "@assistant-ui/react";
 import { createDirectiveText } from "@/components/assistant-ui/directive-text";
 
 const slashFormatter: Unstable_DirectiveFormatter = {
@@ -97,7 +97,7 @@ Because `directive-text.tsx` is copied into your project, you can also edit it d
 
 ### `DirectiveText`
 
-A `TextMessagePartComponent` that parses `:type[label]{name=id}` directives and renders them as inline chips. Uses the default formatter from `@assistant-ui/core` and renders chips without icons. For per-type icons, build a component with `createDirectiveText(formatter, { iconMap })`.
+A `TextMessagePartComponent` that parses `:type[label]{name=id}` directives and renders them as inline chips. Uses the default formatter from `@assistant-ui/react` and renders chips without icons. For per-type icons, build a component with `createDirectiveText(formatter, { iconMap })`.
 
 ### `createDirectiveText(formatter, options?)`
 

package/.docs/raw/docs/ui/mcp-config.mdx

@@ -4,7 +4,7 @@ description: Drop-in shadcn dialog that lists MCP connectors and custom servers,
 platforms: ["react"]
 ---
 
-`McpConfigDialog` is a shadcn template that wraps the [`@assistant-ui/react-mcp`](/docs/integrations/tools/react-mcp) primitives. Render it anywhere inside an `McpManagerResource`-mounted client and your users get a styled MCP server panel — no manual primitive composition.
+`McpConfigDialog` is a shadcn template that wraps the [`@assistant-ui/react-mcp`](/docs/tools/user-managed-mcp) primitives. Render it anywhere inside an `McpManagerResource`-mounted client and your users get a styled MCP server panel — no manual primitive composition.
 
 ## Getting Started
 
@@ -81,7 +81,7 @@ Pass children to swap the default button for your own:
 
 ### Wire up the OAuth callback
 
-Required for any OAuth-enabled connector or custom server. See the [OAuth callback section in the react-mcp guide](/docs/integrations/tools/react-mcp#handle-the-oauth-callback) for the route handler.
+Required for any OAuth-enabled connector or custom server. See the [OAuth callback section in the react-mcp guide](/docs/tools/user-managed-mcp#handle-the-oauth-callback) for the route handler.
 
   </Step>
 </Steps>
@@ -92,11 +92,11 @@ Required for any OAuth-enabled connector or custom server. See the [OAuth callba
   <Card
     title="User-managed MCP servers"
     description="Full @assistant-ui/react-mcp guide — connectors, custom servers, OAuth, storage, custom primitives."
-    href="/docs/integrations/tools/react-mcp"
+    href="/docs/tools/user-managed-mcp"
   />
   <Card
     title="Server-side MCP"
     description="App-developer-controlled MCP servers wired into the API route."
-    href="/docs/integrations/tools/mcp"
+    href="/docs/tools/mcp"
   />
 </Cards>

package/.docs/raw/docs/ui/mermaid.mdx

@@ -50,34 +50,41 @@ export const MarkdownText = memo(MarkdownTextImpl);
 
 ## Configuration
 
-Configure mermaid options in `mermaid-diagram.tsx`:
+Configure rendering options in `mermaid-diagram.tsx`:
 
 ```tsx title="/components/assistant-ui/mermaid-diagram.tsx"
-mermaid.initialize({ theme: "default" });
+renderMermaidSVG(code, {
+  bg: "var(--background)",
+  fg: "var(--foreground)",
+  muted: "var(--muted-foreground)",
+  border: "var(--border)",
+  accent: "var(--foreground)",
+  transparent: true,
+});
 ```
 
+The palette follows your theme's background, foreground, and shadcn color tokens, so diagrams match light and dark mode automatically.
+
 ## Streaming Performance
 
 The `MermaidDiagram` component is optimized for streaming scenarios:
 
-- **Smart completion detection**: Only renders when the specific code block is complete
-- **Zero failed renders**: Avoids parsing incomplete diagram code during streaming  
+- **Skeleton while streaming**: Shows a placeholder skeleton until the response finishes streaming, then renders the diagram synchronously
+- **Raw source fallback**: Invalid or unsupported diagrams fall back to displaying the raw source
 
 
 ## Supported Diagram Types
 
-Mermaid supports various diagram types including:
+The component renders these diagram types:
 
 - Flowcharts and decision trees
 - Sequence diagrams
-- Gantt charts
 - Class diagrams
 - State diagrams
-- Git graphs
-- User journey maps
 - Entity relationship diagrams
+- XY charts (bar, line, combined)
 
-See the [Mermaid documentation](https://mermaid.js.org/) for complete syntax reference.
+Other mermaid diagram types fall back to displaying the raw source. See the [Mermaid documentation](https://mermaid.js.org/) for syntax reference.
 
 ## Related Components
 

package/.docs/raw/docs/ui/part-grouping.mdx

@@ -10,18 +10,19 @@ import { PartGroupingSample } from "@/components/docs/samples/part-grouping";
 
 ## Basic Usage
 
-For adjacent grouping, use `MessagePrimitive.GroupedParts`. Return a group-key path for each part; adjacent parts that share a group key are coalesced and rendered through the group case.
+For adjacent grouping, use `MessagePrimitive.GroupedParts`. For the common case — grouping by `part.type` — pass `groupPartByType` to map each part type to a group-key path. Adjacent parts that share a group key are coalesced and rendered through the group case.
 
 ```tsx title="/components/assistant-ui/thread.tsx"
+import { MessagePrimitive, groupPartByType } from "@assistant-ui/react";
+
 const AssistantMessage: FC = () => {
   return (
     <MessagePrimitive.Root className="...">
       <div className="...">
         <MessagePrimitive.GroupedParts
-          groupBy={(part) => {
-            if (part.type === "tool-call") return ["group-tool"];
-            return null;
-          }}
+          groupBy={groupPartByType({
+            "tool-call": ["group-tool"],
+          })}
         >
           {({ part, children }) => {
             switch (part.type) {
@@ -42,6 +43,8 @@ const AssistantMessage: FC = () => {
 };
 ```
 
+Reach for an inline `groupBy={(part) => …}` only when the helper isn't expressive enough — e.g. you need to branch on `part.toolName`, `part.parentId`, or part metadata.
+
 ## How Adjacent Grouping Works
 
 `groupBy` receives each part and returns either `null` for an ungrouped leaf or a group-key path such as `["group-chainOfThought", "group-tool"]`. Group keys must start with `"group-"` so your render function can distinguish synthetic groups from real part types.
@@ -89,7 +92,7 @@ function ParentGroup({
 
 <MessagePrimitive.GroupedParts
   groupBy={(part) => {
-    if (!part.parentId) return null;
+    if (!part.parentId) return [];
     return [`group-parent-${part.parentId}`];
   }}
 >
@@ -117,7 +120,7 @@ Organize adjacent tool calls by tool name:
 ```tsx
 <MessagePrimitive.GroupedParts
   groupBy={(part) => {
-    if (part.type !== "tool-call") return null;
+    if (part.type !== "tool-call") return [];
     return [`group-tool-${part.toolName}`];
   }}
 >
@@ -147,10 +150,9 @@ Combine multiple text parts into cohesive blocks:
 
 ```tsx
 <MessagePrimitive.GroupedParts
-  groupBy={(part) => {
-    if (part.type === "text") return ["group-text-block"];
-    return null;
-  }}
+  groupBy={groupPartByType({
+    text: ["group-text-block"],
+  })}
 >
   {({ part, children }) => {
     switch (part.type) {
@@ -177,12 +179,11 @@ Separate different types of content for distinct visual treatment:
 
 ```tsx
 <MessagePrimitive.GroupedParts
-  groupBy={(part) => {
-    if (part.type === "text") return ["group-content-text"];
-    if (part.type === "tool-call") return ["group-content-tools"];
-    if (part.type === "reasoning") return ["group-content-reasoning"];
-    return null;
-  }}
+  groupBy={groupPartByType({
+    text: ["group-content-text"],
+    "tool-call": ["group-content-tools"],
+    reasoning: ["group-content-reasoning"],
+  })}
 >
   {({ part, children }) => {
     switch (part.type) {
@@ -205,6 +206,52 @@ Separate different types of content for distinct visual treatment:
 </MessagePrimitive.GroupedParts>
 ```
 
+### Keep Standalone Tool UIs Out of the Trace
+
+Tool UIs fall into three buckets: prompting the user (human-in-the-loop), informing the user (generative UI), and traces of what the model is doing (routine tool calls). The first two should be surfaced on their own, while the last belongs folded into a collapsible chain-of-thought group.
+
+Mark a tool with `display: "standalone"` to keep its UI out of the grouped trace. `human` tools and MCP apps are standalone automatically; every other tool defaults to `"inline"` and opts in explicitly:
+
+```tsx
+const toolkit = defineToolkit({
+  ask_user: { type: "human", render: AskUI }, // standalone (forced)
+  search_web: { type: "frontend", render: SearchUI }, // inline trace (default)
+  checkout: {
+    type: "frontend",
+    render: CheckoutUI,
+    display: "standalone", // opt in
+  },
+});
+```
+
+The synthetic `"standalone-tool-call"` key on `groupPartByType` matches all of these. `MessagePrimitive.GroupedParts` passes the live tool-UI registry to `groupBy` as a second `context` argument, and the helper reads it to resolve the registry-driven cases — MCP-app calls are detected from the part alone, so nothing is threaded in:
+
+```tsx
+<MessagePrimitive.GroupedParts
+  groupBy={groupPartByType({
+    reasoning: ["group-chainOfThought", "group-reasoning"],
+    "tool-call": ["group-chainOfThought", "group-tool"],
+    "standalone-tool-call": [], // ungrouped — rendered on its own
+  })}
+>
+  {({ part, children }) => {
+    switch (part.type) {
+      case "group-chainOfThought":
+        return <div className="chain-of-thought">{children}</div>;
+      case "tool-call":
+        return part.toolUI ?? <ToolFallback {...part} />;
+      // ...
+      default:
+        return null;
+    }
+  }}
+</MessagePrimitive.GroupedParts>;
+```
+
+<Callout type="info">
+  The `"mcp-app"` key is deprecated in favor of `"standalone-tool-call"`, which is a superset (it also matches MCP-app tool calls). Existing `"mcp-app"` usage keeps working.
+</Callout>
+
 ### Group by Custom Metadata
 
 Use any custom metadata in your parts for grouping:
@@ -219,7 +266,7 @@ const priorityStyles = {
 <MessagePrimitive.GroupedParts
   groupBy={(part) => {
     const priority = part.metadata?.priority;
-    if (!priority) return null;
+    if (!priority) return [];
     return [`group-priority-${priority}`];
   }}
 >
@@ -300,9 +347,9 @@ const stream = createAssistantStream(async (controller) => {
   parameters={[
     {
       name: "groupBy",
-      type: "(part: PartState, index: number, parts: readonly PartState[]) => GroupKey",
+      type: "(part: PartState) => readonly `group-${string}`[]",
       description:
-        "Maps a part to a group-key path. Return null, undefined, or [] to leave the part ungrouped. Group keys must start with group-.",
+        "Maps a part to a group-key path. Return `[]` to leave the part ungrouped. Group keys must start with `group-`. Prefer `groupPartByType` for the common `part.type → path` case.",
       required: true,
     },
     {
@@ -315,6 +362,19 @@ const stream = createAssistantStream(async (controller) => {
   ]}
 />
 
+### groupPartByType helper
+
+`groupPartByType` builds a `groupBy` from a `part.type → group-key path` map. Part types missing from the map are left ungrouped. The returned function carries an internal memo fingerprint so the tree survives unrelated re-renders.
+
+```typescript
+import { groupPartByType } from "@assistant-ui/react";
+
+groupPartByType({
+  reasoning: ["group-thought", "group-reasoning"],
+  "tool-call": ["group-thought", "group-tool"],
+});
+```
+
 ### GroupPart Type
 
 ```typescript
@@ -331,34 +391,9 @@ type GroupPart<TKey extends `group-${string}` = `group-${string}`> = {
 2. **Handle ungrouped parts**: Always include leaf cases for the part types your message can render.
 3. **Only render `children` for groups**: Leaf parts receive a sentinel `children` value that throws if rendered accidentally.
 4. **Use `group-` prefixes**: Synthetic group keys must start with `group-` so they cannot collide with real part types.
-5. **Keep `groupBy` stable**: Prefer a module-level function or `useCallback` for frequently re-rendering message trees.
 
 ## Common Patterns
 
-### Conditional Grouping
-
-Only group when certain conditions are met:
-
-```tsx
-<MessagePrimitive.GroupedParts
-  groupBy={(part, index, parts) => {
-    const hasManyParts = parts.length >= 5;
-    if (!hasManyParts) return null;
-    if (part.type === "tool-call") return ["group-tools"];
-    return null;
-  }}
->
-  {({ part, children }) => {
-    if (part.type === "group-tools") {
-      return <div className="rounded-lg border p-3">{children}</div>;
-    }
-    if (part.type === "tool-call") return part.toolUI ?? <ToolFallback {...part} />;
-    if (part.type === "text") return <MarkdownText />;
-    return null;
-  }}
-</MessagePrimitive.GroupedParts>
-```
-
 ### Nested Grouping
 
 Create hierarchical adjacent groups by returning multiple keys:
@@ -370,7 +405,7 @@ Create hierarchical adjacent groups by returning multiple keys:
       return ["group-chainOfThought", "group-reasoning"];
     if (part.type === "tool-call")
       return ["group-chainOfThought", `group-tool-${part.toolName}`];
-    return null;
+    return [];
   }}
 >
   {({ part, children }) => {
@@ -391,10 +426,9 @@ Adjust group appearance based on the group node's status or indices:
 
 ```tsx
 <MessagePrimitive.GroupedParts
-  groupBy={(part) => {
-    if (part.type === "tool-call") return ["group-tools"];
-    return null;
-  }}
+  groupBy={groupPartByType({
+    "tool-call": ["group-tools"],
+  })}
 >
   {({ part, children }) => {
     if (part.type === "group-tools") {

package/.docs/raw/docs/ui/reasoning.mdx

@@ -31,7 +31,7 @@ Render reasoning parts through `MessagePrimitive.GroupedParts`. Group consecutiv
 While reasoning is streaming, `part.status.type === "running"`. Pass that to `defaultOpen` so the accordion auto-opens during streaming and lets the user collapse it once the model moves on.
 
 ```tsx title="/app/components/assistant-ui/thread.tsx"
-import { MessagePrimitive } from "@assistant-ui/react";
+import { MessagePrimitive, groupPartByType } from "@assistant-ui/react";
 import { MarkdownText } from "@/components/assistant-ui/markdown-text";
 import { ToolFallback } from "@/components/assistant-ui/tool-fallback";
 import {
@@ -47,10 +47,9 @@ const AssistantMessage: FC = () => {
     <MessagePrimitive.Root className="...">
       <div className="...">
         <MessagePrimitive.GroupedParts // [!code ++]
-          groupBy={(part) => { // [!code ++]
-            if (part.type === "reasoning") return ["group-reasoning"]; // [!code ++]
-            return null; // [!code ++]
-          }} // [!code ++]
+          groupBy={groupPartByType({ // [!code ++]
+            reasoning: ["group-reasoning"], // [!code ++]
+          })} // [!code ++]
         > // [!code ++]
           {({ part, children }) => { // [!code ++]
             switch (part.type) { // [!code ++]

package/.docs/raw/docs/ui/tool-fallback.mdx

@@ -9,6 +9,7 @@ import {
   ToolFallbackRunningSample,
   ToolFallbackCancelledSample,
   ToolFallbackStreamingSample,
+  ToolFallbackRequiresActionSample,
 } from "@/components/docs/samples/tool-fallback";
 
 <ToolFallbackSample />
@@ -71,6 +72,12 @@ Shows a muted appearance when a tool call was cancelled.
 
 <ToolFallbackCancelledSample />
 
+### Approval State
+
+Shows the default Allow / Deny buttons rendered when a tool call enters `requires-action`. The block auto-expands so the decision is visible without a click. Edit your project's copy of `tool-fallback.tsx` to add trust escalation, edit-args, custom labels, or analytics hooks — the shadcn philosophy is you own the file.
+
+<ToolFallbackRequiresActionSample />
+
 ## Composable API
 
 All sub-components are exported for custom layouts:
@@ -83,6 +90,7 @@ All sub-components are exported for custom layouts:
 | `ToolFallback.Args` | Displays tool arguments |
 | `ToolFallback.Result` | Displays tool execution result |
 | `ToolFallback.Error` | Displays error or cancellation messages |
+| `ToolFallback.Approval` | Renders Allow / Deny buttons for `requires-action` tools; wires `resume` / `addResult` / `respondToApproval` |
 
 ```tsx
 import {
@@ -93,6 +101,7 @@ import {
   ToolFallbackArgs,
   ToolFallbackResult,
   ToolFallbackError,
+  ToolFallbackApproval,
 } from "@/components/assistant-ui/tool-fallback";
 
 // Compound component syntax
@@ -101,6 +110,13 @@ import {
   <ToolFallback.Content>
     <ToolFallback.Error status={status} />
     <ToolFallback.Args argsText={argsText} />
+    <ToolFallback.Approval
+      addResult={addResult}
+      resume={resume}
+      interrupt={interrupt}
+      approval={approval}
+      respondToApproval={respondToApproval}
+    />
     <ToolFallback.Result result={result} />
   </ToolFallback.Content>
 </ToolFallback.Root>

package/.docs/raw/docs/ui/tool-group.mdx

@@ -29,10 +29,10 @@ This adds `/components/assistant-ui/tool-group.tsx` and `/components/assistant-u
 
 ### Use it in your application
 
-Use `MessagePrimitive.GroupedParts` and return `"group-tool"` for tool-call parts. The group case wraps `children`; the tool-call leaf renders the resolved tool UI or your fallback.
+Use `MessagePrimitive.GroupedParts` with `groupPartByType` to map tool-call parts to `"group-tool"`. The group case wraps `children`; the tool-call leaf renders the resolved tool UI or your fallback.
 
 ```tsx title="/components/assistant-ui/thread.tsx"
-import { MessagePrimitive } from "@assistant-ui/react";
+import { MessagePrimitive, groupPartByType } from "@assistant-ui/react";
 import { ToolFallback } from "@/components/assistant-ui/tool-fallback";
 import {
   ToolGroupContent,
@@ -44,10 +44,9 @@ const AssistantMessage = () => {
   return (
     <MessagePrimitive.Root>
       <MessagePrimitive.GroupedParts
-        groupBy={(part) => {
-          if (part.type === "tool-call") return ["group-tool"];
-          return null;
-        }}
+        groupBy={groupPartByType({
+          "tool-call": ["group-tool"],
+        })}
       >
         {({ part, children }) => {
           switch (part.type) {

package/.docs/raw/docs/utilities/heat-graph.mdx

@@ -4,7 +4,7 @@ description: Headless, composable activity heatmap components for React.
 platforms: ["react"]
 ---
 
-import { HeatGraphDemo } from "@/app/heat-graph/heat-graph-demo";
+import { HeatGraphDemo } from "@/app/(demos)/heat-graph/heat-graph-demo";
 
 `heat-graph` provides headless, Radix-style primitives for building GitHub-style activity heatmap graphs.
 

package/.docs/raw/docs/utilities/react-o11y.mdx

@@ -13,7 +13,7 @@ platforms: ["react"]
 - **Headless** — Zero styling opinions, bring your own CSS / Tailwind.
 - **Composable** — Radix-style primitive parts you fully control.
 - **Tree-aware** — Automatic depth, parent / child collapse, time range computation.
-- **Tap-powered** — Built on the same `@assistant-ui/tap` reactive primitives as the runtimes.
+- **Reactive** — Built on the same reactive core as the runtimes, so spans stream into your UI as they change.
 
 ## Installation
 
@@ -98,7 +98,7 @@ function SpanRow() {
 
 ### SpanResource
 
-Tap resource that ingests raw span data and exposes a tree-aware reactive state to primitives.
+Resource that ingests raw span data and exposes a tree-aware reactive state to primitives.
 
 ```ts
 SpanResource({ spans }: { spans: SpanData[] }): ClientOutput<"span">;

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { dirname, join } from \"node:path\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport const ROOT_DIR = join(__dirname, \"../../../\");\nexport const PACKAGE_DIR = join(__dirname, \"../\");\n\nexport const EXAMPLES_PATH = join(ROOT_DIR, \"examples\");\n\nconst DOCS_BASE = join(PACKAGE_DIR, \".docs\");\nexport const DOCS_PATH = join(DOCS_BASE, \"raw/docs\");\nexport const CODE_EXAMPLES_PATH = join(DOCS_BASE, \"organized/code-examples\");\n\nexport const MDX_EXTENSION = \".mdx\";\nexport const MD_EXTENSION = \".md\";\n\nexport const MAX_FILE_SIZE = 10 * 1024 * 1024;\n\nexport const IS_PREPARE_MODE = process.argv[1]?.includes(\n  \"prepare-docs/prepare\",\n);\n"],"mappings":";;;AAGA,MAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,GAAG,CAAC;AAExD,MAAa,WAAW,KAAK,WAAW,WAAW;AACnD,MAAa,cAAc,KAAK,WAAW,KAAK;AAEhD,MAAa,gBAAgB,KAAK,UAAU,UAAU;AAEtD,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,MAAa,YAAY,KAAK,WAAW,UAAU;AACnD,MAAa,qBAAqB,KAAK,WAAW,yBAAyB;AAE3E,MAAa,gBAAgB;AAC7B,MAAa,eAAe;AAE5B,MAAa,gBAAgB,KAAK,OAAO;AAEzC,MAAa,kBAAkB,QAAQ,KAAK,IAAI,SAC9C,sBACF"}
+{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { dirname, join } from \"node:path\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport const ROOT_DIR = join(__dirname, \"../../../\");\nexport const PACKAGE_DIR = join(__dirname, \"../\");\n\nexport const EXAMPLES_PATH = join(ROOT_DIR, \"examples\");\n\nconst DOCS_BASE = join(PACKAGE_DIR, \".docs\");\nexport const DOCS_PATH = join(DOCS_BASE, \"raw/docs\");\nexport const CODE_EXAMPLES_PATH = join(DOCS_BASE, \"organized/code-examples\");\n\nexport const MDX_EXTENSION = \".mdx\";\nexport const MD_EXTENSION = \".md\";\n\nexport const MAX_FILE_SIZE = 10 * 1024 * 1024;\n\nexport const IS_PREPARE_MODE = process.argv[1]?.includes(\n  \"prepare-docs/prepare\",\n);\n"],"mappings":";;;AAGA,MAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,GAAG,CAAC;AAExD,MAAa,WAAW,KAAK,WAAW,WAAW;AACnD,MAAa,cAAc,KAAK,WAAW,KAAK;AAEhD,MAAa,gBAAgB,KAAK,UAAU,UAAU;AAEtD,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,MAAa,YAAY,KAAK,WAAW,UAAU;AACnD,MAAa,qBAAqB,KAAK,WAAW,yBAAyB;AAE3E,MAAa,gBAAgB;AAC7B,MAAa,eAAe;AAE5B,MAAa,gBAAgB,KAAK,OAAO;AAEzC,MAAa,kBAAkB,QAAQ,KAAK,EAAE,EAAE,SAC9C,sBACF"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;cAca,MAAA,EAAM,SAGjB;AAAA,iBAeoB,SAAA,CAAA,GAAS,OAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;cAca,MAAA,EAAM,SAGjB;AAAA,iBAeoB,SAAA,IAAS,OAAA"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { docsTools } from \"./tools/docs.js\";\nimport { examplesTools } from \"./tools/examples.js\";\nimport { logger } from \"./utils/logger.js\";\nimport { PACKAGE_DIR } from \"./constants.js\";\n\nimport { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst packageJson = JSON.parse(\n  readFileSync(join(PACKAGE_DIR, \"package.json\"), \"utf-8\"),\n);\n\nexport const server = new McpServer({\n  name: \"assistant-ui-docs\",\n  version: packageJson.version,\n});\n\nserver.tool(\n  docsTools.name,\n  docsTools.description,\n  docsTools.parameters,\n  docsTools.execute,\n);\nserver.tool(\n  examplesTools.name,\n  examplesTools.description,\n  examplesTools.parameters,\n  examplesTools.execute,\n);\n\nexport async function runServer() {\n  try {\n    logger.info(\n      `Starting assistant-ui MCP docs server v${packageJson.version}`,\n    );\n    const transport = new StdioServerTransport();\n    await server.connect(transport);\n  } catch (error) {\n    logger.error(\"Failed to start MCP server\", error);\n    process.exit(1);\n  }\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  void runServer().catch((error) => {\n    console.error(\"Failed to start server:\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;;;;;;AAUA,MAAM,cAAc,KAAK,MACvB,aAAa,KAAK,aAAa,cAAc,GAAG,OAAO,CACzD;AAEA,MAAa,SAAS,IAAI,UAAU;CAClC,MAAM;CACN,SAAS,YAAY;AACvB,CAAC;AAED,OAAO,KACL,UAAU,MACV,UAAU,aACV,UAAU,YACV,UAAU,OACZ;AACA,OAAO,KACL,cAAc,MACd,cAAc,aACd,cAAc,YACd,cAAc,OAChB;AAEA,eAAsB,YAAY;CAChC,IAAI;EACF,OAAO,KACL,0CAA0C,YAAY,SACxD;EACA,MAAM,YAAY,IAAI,qBAAqB;EAC3C,MAAM,OAAO,QAAQ,SAAS;CAChC,SAAS,OAAO;EACd,OAAO,MAAM,8BAA8B,KAAK;EAChD,QAAQ,KAAK,CAAC;CAChB;AACF;AAEA,IAAI,OAAO,KAAK,QAAQ,UAAU,QAAQ,KAAK,MAC7C,UAAe,EAAE,OAAO,UAAU;CAChC,QAAQ,MAAM,2BAA2B,KAAK;CAC9C,QAAQ,KAAK,CAAC;AAChB,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { docsTools } from \"./tools/docs.js\";\nimport { examplesTools } from \"./tools/examples.js\";\nimport { logger } from \"./utils/logger.js\";\nimport { PACKAGE_DIR } from \"./constants.js\";\n\nimport { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst packageJson = JSON.parse(\n  readFileSync(join(PACKAGE_DIR, \"package.json\"), \"utf-8\"),\n);\n\nexport const server = new McpServer({\n  name: \"assistant-ui-docs\",\n  version: packageJson.version,\n});\n\nserver.tool(\n  docsTools.name,\n  docsTools.description,\n  docsTools.parameters,\n  docsTools.execute,\n);\nserver.tool(\n  examplesTools.name,\n  examplesTools.description,\n  examplesTools.parameters,\n  examplesTools.execute,\n);\n\nexport async function runServer() {\n  try {\n    logger.info(\n      `Starting assistant-ui MCP docs server v${packageJson.version}`,\n    );\n    const transport = new StdioServerTransport();\n    await server.connect(transport);\n  } catch (error) {\n    logger.error(\"Failed to start MCP server\", error);\n    process.exit(1);\n  }\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  void runServer().catch((error) => {\n    console.error(\"Failed to start server:\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;;;;;;AAUA,MAAM,cAAc,KAAK,MACvB,aAAa,KAAK,aAAa,cAAc,GAAG,OAAO,CACzD;AAEA,MAAa,SAAS,IAAI,UAAU;CAClC,MAAM;CACN,SAAS,YAAY;AACvB,CAAC;AAED,OAAO,KACL,UAAU,MACV,UAAU,aACV,UAAU,YACV,UAAU,OACZ;AACA,OAAO,KACL,cAAc,MACd,cAAc,aACd,cAAc,YACd,cAAc,OAChB;AAEA,eAAsB,YAAY;CAChC,IAAI;EACF,OAAO,KACL,0CAA0C,YAAY,SACxD;EACA,MAAM,YAAY,IAAI,qBAAqB;EAC3C,MAAM,OAAO,QAAQ,SAAS;CAChC,SAAS,OAAO;EACd,OAAO,MAAM,8BAA8B,KAAK;EAChD,QAAQ,KAAK,CAAC;CAChB;AACF;AAEA,IAAI,OAAO,KAAK,QAAQ,UAAU,QAAQ,KAAK,MAC7C,UAAe,CAAC,CAAC,OAAO,UAAU;CAChC,QAAQ,MAAM,2BAA2B,KAAK;CAC9C,QAAQ,KAAK,CAAC;AAChB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"code-examples.d.ts","names":[],"sources":["../../src/prepare-docs/code-examples.ts"],"mappings":";iBA2FsB,mBAAA,CAAA,GAAuB,OAAO"}
+{"version":3,"file":"code-examples.d.ts","names":[],"sources":["../../src/prepare-docs/code-examples.ts"],"mappings":";iBA2FsB,mBAAA,IAAuB,OAAO"}

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

@@ -1 +1 @@
-{"version":3,"file":"code-examples.js","names":[],"sources":["../../src/prepare-docs/code-examples.ts"],"sourcesContent":["import { rm, mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport { join, relative, extname } from \"node:path\";\nimport { logger } from \"../utils/logger.js\";\nimport { ROOT_DIR, EXAMPLES_PATH } from \"../constants.js\";\n\nconst OUTPUT_DIR = join(\n  ROOT_DIR,\n  \"packages/mcp-docs-server/.docs/organized/code-examples\",\n);\nconst MAX_LINES = 10000;\n\ninterface FileContent {\n  path: string;\n  content: string;\n}\n\nasync function scanDirectory(\n  dir: string,\n  baseDir: string,\n): Promise<FileContent[]> {\n  const files: FileContent[] = [];\n\n  try {\n    const entries = await readdir(dir, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const fullPath = join(dir, entry.name);\n\n      if (entry.isDirectory()) {\n        const skipDirs = [\n          \"node_modules\",\n          \"dist\",\n          \"build\",\n          \".next\",\n          \".git\",\n          \".turbo\",\n        ];\n        if (!skipDirs.includes(entry.name)) {\n          const subFiles = await scanDirectory(fullPath, baseDir);\n          files.push(...subFiles);\n        }\n      } else if (entry.isFile()) {\n        const includeExts = [\n          \".ts\",\n          \".tsx\",\n          \".js\",\n          \".jsx\",\n          \".json\",\n          \".css\",\n          \".md\",\n          \".mdx\",\n        ];\n        const ext = extname(entry.name).toLowerCase();\n\n        if (\n          includeExts.includes(ext) ||\n          entry.name === \"package.json\" ||\n          entry.name === \"tsconfig.json\"\n        ) {\n          try {\n            const content = await readFile(fullPath, \"utf-8\");\n            const relativePath = relative(baseDir, fullPath);\n            files.push({ path: relativePath, content });\n          } catch (error) {\n            logger.warn(`Failed to read file: ${fullPath}`, error);\n          }\n        }\n      }\n    }\n  } catch (error) {\n    logger.error(`Failed to scan directory: ${dir}`, error);\n  }\n\n  return files;\n}\n\nfunction getFileType(filename: string): string {\n  const ext = extname(filename).toLowerCase();\n  const extMap: Record<string, string> = {\n    \".ts\": \"typescript\",\n    \".tsx\": \"tsx\",\n    \".js\": \"javascript\",\n    \".jsx\": \"jsx\",\n    \".json\": \"json\",\n    \".css\": \"css\",\n    \".md\": \"markdown\",\n    \".mdx\": \"mdx\",\n  };\n  return extMap[ext] || \"text\";\n}\n\nexport async function prepareCodeExamples(): Promise<void> {\n  logger.info(\"Preparing code examples...\");\n\n  try {\n    await rm(OUTPUT_DIR, { recursive: true, force: true });\n    await mkdir(OUTPUT_DIR, { recursive: true });\n\n    const exampleDirs = await readdir(EXAMPLES_PATH, { withFileTypes: true });\n\n    for (const dir of exampleDirs) {\n      if (dir.isDirectory() && !dir.name.startsWith(\".\")) {\n        const examplePath = join(EXAMPLES_PATH, dir.name);\n        logger.info(`Processing example: ${dir.name}`);\n\n        let description = \"\";\n        try {\n          const packageJsonPath = join(examplePath, \"package.json\");\n          const packageJson = JSON.parse(\n            await readFile(packageJsonPath, \"utf-8\"),\n          );\n          description = packageJson.description || \"\";\n        } catch (error: any) {\n          if (error?.code !== \"ENOENT\") {\n            logger.warn(`Failed to read package.json for ${dir.name}:`, error);\n          } else {\n            logger.debug(`No package.json found for example: ${dir.name}`);\n          }\n        }\n\n        const files = await scanDirectory(examplePath, examplePath);\n\n        files.sort((a, b) => a.path.localeCompare(b.path));\n\n        let markdown = `# Example: ${dir.name}\\n\\n`;\n        if (description) {\n          markdown += `${description}\\n\\n`;\n        }\n\n        let totalLines = 0;\n        for (const file of files) {\n          const lines = file.content.split(\"\\n\").length;\n          if (totalLines + lines > MAX_LINES) {\n            markdown += `\\n_Note: Additional files truncated due to size limits_\\n`;\n            break;\n          }\n\n          // Normalize Windows backslashes to forward slashes for consistent markdown output\n          markdown += `## ${file.path.replace(/\\\\/g, \"/\")}\\n\\n`;\n          markdown += `\\`\\`\\`${getFileType(file.path)}\\n`;\n          markdown += file.content;\n          markdown += `\\n\\`\\`\\`\\n\\n`;\n\n          totalLines += lines;\n        }\n\n        const outputPath = join(OUTPUT_DIR, `${dir.name}.md`);\n        await writeFile(outputPath, markdown, \"utf-8\");\n        logger.debug(`Created example: ${outputPath}`);\n      }\n    }\n\n    logger.info(\"Code examples preparation complete\");\n  } catch (error) {\n    logger.error(\"Failed to prepare code examples\", error);\n    throw error;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"code-examples.js","names":[],"sources":["../../src/prepare-docs/code-examples.ts"],"sourcesContent":["import { rm, mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport { join, relative, extname } from \"node:path\";\nimport { logger } from \"../utils/logger.js\";\nimport { ROOT_DIR, EXAMPLES_PATH } from \"../constants.js\";\n\nconst OUTPUT_DIR = join(\n  ROOT_DIR,\n  \"packages/mcp-docs-server/.docs/organized/code-examples\",\n);\nconst MAX_LINES = 10000;\n\ninterface FileContent {\n  path: string;\n  content: string;\n}\n\nasync function scanDirectory(\n  dir: string,\n  baseDir: string,\n): Promise<FileContent[]> {\n  const files: FileContent[] = [];\n\n  try {\n    const entries = await readdir(dir, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const fullPath = join(dir, entry.name);\n\n      if (entry.isDirectory()) {\n        const skipDirs = [\n          \"node_modules\",\n          \"dist\",\n          \"build\",\n          \".next\",\n          \".git\",\n          \".turbo\",\n        ];\n        if (!skipDirs.includes(entry.name)) {\n          const subFiles = await scanDirectory(fullPath, baseDir);\n          files.push(...subFiles);\n        }\n      } else if (entry.isFile()) {\n        const includeExts = [\n          \".ts\",\n          \".tsx\",\n          \".js\",\n          \".jsx\",\n          \".json\",\n          \".css\",\n          \".md\",\n          \".mdx\",\n        ];\n        const ext = extname(entry.name).toLowerCase();\n\n        if (\n          includeExts.includes(ext) ||\n          entry.name === \"package.json\" ||\n          entry.name === \"tsconfig.json\"\n        ) {\n          try {\n            const content = await readFile(fullPath, \"utf-8\");\n            const relativePath = relative(baseDir, fullPath);\n            files.push({ path: relativePath, content });\n          } catch (error) {\n            logger.warn(`Failed to read file: ${fullPath}`, error);\n          }\n        }\n      }\n    }\n  } catch (error) {\n    logger.error(`Failed to scan directory: ${dir}`, error);\n  }\n\n  return files;\n}\n\nfunction getFileType(filename: string): string {\n  const ext = extname(filename).toLowerCase();\n  const extMap: Record<string, string> = {\n    \".ts\": \"typescript\",\n    \".tsx\": \"tsx\",\n    \".js\": \"javascript\",\n    \".jsx\": \"jsx\",\n    \".json\": \"json\",\n    \".css\": \"css\",\n    \".md\": \"markdown\",\n    \".mdx\": \"mdx\",\n  };\n  return extMap[ext] || \"text\";\n}\n\nexport async function prepareCodeExamples(): Promise<void> {\n  logger.info(\"Preparing code examples...\");\n\n  try {\n    await rm(OUTPUT_DIR, { recursive: true, force: true });\n    await mkdir(OUTPUT_DIR, { recursive: true });\n\n    const exampleDirs = await readdir(EXAMPLES_PATH, { withFileTypes: true });\n\n    for (const dir of exampleDirs) {\n      if (dir.isDirectory() && !dir.name.startsWith(\".\")) {\n        const examplePath = join(EXAMPLES_PATH, dir.name);\n        logger.info(`Processing example: ${dir.name}`);\n\n        let description = \"\";\n        try {\n          const packageJsonPath = join(examplePath, \"package.json\");\n          const packageJson = JSON.parse(\n            await readFile(packageJsonPath, \"utf-8\"),\n          );\n          description = packageJson.description || \"\";\n        } catch (error: any) {\n          if (error?.code !== \"ENOENT\") {\n            logger.warn(`Failed to read package.json for ${dir.name}:`, error);\n          } else {\n            logger.debug(`No package.json found for example: ${dir.name}`);\n          }\n        }\n\n        const files = await scanDirectory(examplePath, examplePath);\n\n        files.sort((a, b) => a.path.localeCompare(b.path));\n\n        let markdown = `# Example: ${dir.name}\\n\\n`;\n        if (description) {\n          markdown += `${description}\\n\\n`;\n        }\n\n        let totalLines = 0;\n        for (const file of files) {\n          const lines = file.content.split(\"\\n\").length;\n          if (totalLines + lines > MAX_LINES) {\n            markdown += `\\n_Note: Additional files truncated due to size limits_\\n`;\n            break;\n          }\n\n          // Normalize Windows backslashes to forward slashes for consistent markdown output\n          markdown += `## ${file.path.replace(/\\\\/g, \"/\")}\\n\\n`;\n          markdown += `\\`\\`\\`${getFileType(file.path)}\\n`;\n          markdown += file.content;\n          markdown += `\\n\\`\\`\\`\\n\\n`;\n\n          totalLines += lines;\n        }\n\n        const outputPath = join(OUTPUT_DIR, `${dir.name}.md`);\n        await writeFile(outputPath, markdown, \"utf-8\");\n        logger.debug(`Created example: ${outputPath}`);\n      }\n    }\n\n    logger.info(\"Code examples preparation complete\");\n  } catch (error) {\n    logger.error(\"Failed to prepare code examples\", error);\n    throw error;\n  }\n}\n"],"mappings":";;;;;AAKA,MAAM,aAAa,KACjB,UACA,wDACF;AACA,MAAM,YAAY;AAOlB,eAAe,cACb,KACA,SACwB;CACxB,MAAM,QAAuB,CAAC;CAE9B,IAAI;EACF,MAAM,UAAU,MAAM,QAAQ,KAAK,EAAE,eAAe,KAAK,CAAC;EAE1D,KAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,WAAW,KAAK,KAAK,MAAM,IAAI;GAErC,IAAI,MAAM,YAAY;QAShB,CAAC;KAPH;KACA;KACA;KACA;KACA;KACA;IAEU,CAAC,CAAC,SAAS,MAAM,IAAI,GAAG;KAClC,MAAM,WAAW,MAAM,cAAc,UAAU,OAAO;KACtD,MAAM,KAAK,GAAG,QAAQ;IACxB;UACK,IAAI,MAAM,OAAO,GAAG;IACzB,MAAM,cAAc;KAClB;KACA;KACA;KACA;KACA;KACA;KACA;KACA;IACF;IACA,MAAM,MAAM,QAAQ,MAAM,IAAI,CAAC,CAAC,YAAY;IAE5C,IACE,YAAY,SAAS,GAAG,KACxB,MAAM,SAAS,kBACf,MAAM,SAAS,iBAEf,IAAI;KACF,MAAM,UAAU,MAAM,SAAS,UAAU,OAAO;KAChD,MAAM,eAAe,SAAS,SAAS,QAAQ;KAC/C,MAAM,KAAK;MAAE,MAAM;MAAc;KAAQ,CAAC;IAC5C,SAAS,OAAO;KACd,OAAO,KAAK,wBAAwB,YAAY,KAAK;IACvD;GAEJ;EACF;CACF,SAAS,OAAO;EACd,OAAO,MAAM,6BAA6B,OAAO,KAAK;CACxD;CAEA,OAAO;AACT;AAEA,SAAS,YAAY,UAA0B;CAY7C,OAAO;EATL,OAAO;EACP,QAAQ;EACR,OAAO;EACP,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,OAAO;EACP,QAAQ;CAEE,EAXA,QAAQ,QAAQ,CAAC,CAAC,YAWd,MAAM;AACxB;AAEA,eAAsB,sBAAqC;CACzD,OAAO,KAAK,4BAA4B;CAExC,IAAI;EACF,MAAM,GAAG,YAAY;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;EACrD,MAAM,MAAM,YAAY,EAAE,WAAW,KAAK,CAAC;EAE3C,MAAM,cAAc,MAAM,QAAQ,eAAe,EAAE,eAAe,KAAK,CAAC;EAExE,KAAK,MAAM,OAAO,aAChB,IAAI,IAAI,YAAY,KAAK,CAAC,IAAI,KAAK,WAAW,GAAG,GAAG;GAClD,MAAM,cAAc,KAAK,eAAe,IAAI,IAAI;GAChD,OAAO,KAAK,uBAAuB,IAAI,MAAM;GAE7C,IAAI,cAAc;GAClB,IAAI;IACF,MAAM,kBAAkB,KAAK,aAAa,cAAc;IAIxD,cAHoB,KAAK,MACvB,MAAM,SAAS,iBAAiB,OAAO,CAEjB,CAAC,CAAC,eAAe;GAC3C,SAAS,OAAY;IACnB,IAAI,OAAO,SAAS,UAClB,OAAO,KAAK,mCAAmC,IAAI,KAAK,IAAI,KAAK;SAEjE,OAAO,MAAM,sCAAsC,IAAI,MAAM;GAEjE;GAEA,MAAM,QAAQ,MAAM,cAAc,aAAa,WAAW;GAE1D,MAAM,MAAM,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;GAEjD,IAAI,WAAW,cAAc,IAAI,KAAK;GACtC,IAAI,aACF,YAAY,GAAG,YAAY;GAG7B,IAAI,aAAa;GACjB,KAAK,MAAM,QAAQ,OAAO;IACxB,MAAM,QAAQ,KAAK,QAAQ,MAAM,IAAI,CAAC,CAAC;IACvC,IAAI,aAAa,QAAQ,WAAW;KAClC,YAAY;KACZ;IACF;IAGA,YAAY,MAAM,KAAK,KAAK,QAAQ,OAAO,GAAG,EAAE;IAChD,YAAY,SAAS,YAAY,KAAK,IAAI,EAAE;IAC5C,YAAY,KAAK;IACjB,YAAY;IAEZ,cAAc;GAChB;GAEA,MAAM,aAAa,KAAK,YAAY,GAAG,IAAI,KAAK,IAAI;GACpD,MAAM,UAAU,YAAY,UAAU,OAAO;GAC7C,OAAO,MAAM,oBAAoB,YAAY;EAC/C;EAGF,OAAO,KAAK,oCAAoC;CAClD,SAAS,OAAO;EACd,OAAO,MAAM,mCAAmC,KAAK;EACrD,MAAM;CACR;AACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"copy-raw.d.ts","names":[],"sources":["../../src/prepare-docs/copy-raw.ts"],"mappings":";iBAkCsB,OAAA,CAAA,GAAW,OAAO"}
+{"version":3,"file":"copy-raw.d.ts","names":[],"sources":["../../src/prepare-docs/copy-raw.ts"],"mappings":";iBAkCsB,OAAA,IAAW,OAAO"}

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

@@ -1 +1 @@
-{"version":3,"file":"copy-raw.js","names":[],"sources":["../../src/prepare-docs/copy-raw.ts"],"sourcesContent":["import { rm, mkdir, readdir, copyFile } from \"node:fs/promises\";\nimport { join, extname } from \"node:path\";\nimport { logger } from \"../utils/logger.js\";\nimport { ROOT_DIR } from \"../constants.js\";\n\nconst DOCS_SOURCE = join(ROOT_DIR, \"apps/docs/content/docs\");\nconst BLOG_SOURCE = join(ROOT_DIR, \"apps/docs/content/blog\");\nconst DOCS_DEST = join(ROOT_DIR, \"packages/mcp-docs-server/.docs/raw\");\n\nasync function copyDir(src: string, dest: string): Promise<void> {\n  try {\n    await mkdir(dest, { recursive: true });\n    const entries = await readdir(src, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const srcPath = join(src, entry.name);\n      const destPath = join(dest, entry.name);\n\n      if (entry.isDirectory()) {\n        await copyDir(srcPath, destPath);\n      } else if (entry.isFile()) {\n        const ext = extname(entry.name).toLowerCase();\n        if (ext === \".mdx\" || ext === \".md\") {\n          await copyFile(srcPath, destPath);\n          logger.debug(`Copied: ${srcPath} -> ${destPath}`);\n        }\n      }\n    }\n  } catch (error) {\n    logger.error(`Failed to copy directory: ${src}`, error);\n    throw error;\n  }\n}\n\nexport async function copyRaw(): Promise<void> {\n  logger.info(\"Copying raw documentation files...\");\n\n  try {\n    await rm(DOCS_DEST, { recursive: true, force: true });\n    await mkdir(DOCS_DEST, { recursive: true });\n\n    const docsPath = join(DOCS_DEST, \"docs\");\n    await copyDir(DOCS_SOURCE, docsPath);\n    logger.info(`Copied documentation to ${docsPath}`);\n\n    const blogPath = join(DOCS_DEST, \"blog\");\n    await copyDir(BLOG_SOURCE, blogPath);\n    logger.info(`Copied blog posts to ${blogPath}`);\n\n    logger.info(\"Raw documentation copy complete\");\n  } catch (error) {\n    logger.error(\"Failed to copy raw documentation\", error);\n    throw error;\n  }\n}\n"],"mappings":";;;;;AAKA,MAAM,cAAc,KAAK,UAAU,wBAAwB;AAC3D,MAAM,cAAc,KAAK,UAAU,wBAAwB;AAC3D,MAAM,YAAY,KAAK,UAAU,oCAAoC;AAErE,eAAe,QAAQ,KAAa,MAA6B;CAC/D,IAAI;EACF,MAAM,MAAM,MAAM,EAAE,WAAW,KAAK,CAAC;EACrC,MAAM,UAAU,MAAM,QAAQ,KAAK,EAAE,eAAe,KAAK,CAAC;EAE1D,KAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,UAAU,KAAK,KAAK,MAAM,IAAI;GACpC,MAAM,WAAW,KAAK,MAAM,MAAM,IAAI;GAEtC,IAAI,MAAM,YAAY,GACpB,MAAM,QAAQ,SAAS,QAAQ;QAC1B,IAAI,MAAM,OAAO,GAAG;IACzB,MAAM,MAAM,QAAQ,MAAM,IAAI,EAAE,YAAY;IAC5C,IAAI,QAAQ,UAAU,QAAQ,OAAO;KACnC,MAAM,SAAS,SAAS,QAAQ;KAChC,OAAO,MAAM,WAAW,QAAQ,MAAM,UAAU;IAClD;GACF;EACF;CACF,SAAS,OAAO;EACd,OAAO,MAAM,6BAA6B,OAAO,KAAK;EACtD,MAAM;CACR;AACF;AAEA,eAAsB,UAAyB;CAC7C,OAAO,KAAK,oCAAoC;CAEhD,IAAI;EACF,MAAM,GAAG,WAAW;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;EACpD,MAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;EAE1C,MAAM,WAAW,KAAK,WAAW,MAAM;EACvC,MAAM,QAAQ,aAAa,QAAQ;EACnC,OAAO,KAAK,2BAA2B,UAAU;EAEjD,MAAM,WAAW,KAAK,WAAW,MAAM;EACvC,MAAM,QAAQ,aAAa,QAAQ;EACnC,OAAO,KAAK,wBAAwB,UAAU;EAE9C,OAAO,KAAK,iCAAiC;CAC/C,SAAS,OAAO;EACd,OAAO,MAAM,oCAAoC,KAAK;EACtD,MAAM;CACR;AACF"}
+{"version":3,"file":"copy-raw.js","names":[],"sources":["../../src/prepare-docs/copy-raw.ts"],"sourcesContent":["import { rm, mkdir, readdir, copyFile } from \"node:fs/promises\";\nimport { join, extname } from \"node:path\";\nimport { logger } from \"../utils/logger.js\";\nimport { ROOT_DIR } from \"../constants.js\";\n\nconst DOCS_SOURCE = join(ROOT_DIR, \"apps/docs/content/docs\");\nconst BLOG_SOURCE = join(ROOT_DIR, \"apps/docs/content/blog\");\nconst DOCS_DEST = join(ROOT_DIR, \"packages/mcp-docs-server/.docs/raw\");\n\nasync function copyDir(src: string, dest: string): Promise<void> {\n  try {\n    await mkdir(dest, { recursive: true });\n    const entries = await readdir(src, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const srcPath = join(src, entry.name);\n      const destPath = join(dest, entry.name);\n\n      if (entry.isDirectory()) {\n        await copyDir(srcPath, destPath);\n      } else if (entry.isFile()) {\n        const ext = extname(entry.name).toLowerCase();\n        if (ext === \".mdx\" || ext === \".md\") {\n          await copyFile(srcPath, destPath);\n          logger.debug(`Copied: ${srcPath} -> ${destPath}`);\n        }\n      }\n    }\n  } catch (error) {\n    logger.error(`Failed to copy directory: ${src}`, error);\n    throw error;\n  }\n}\n\nexport async function copyRaw(): Promise<void> {\n  logger.info(\"Copying raw documentation files...\");\n\n  try {\n    await rm(DOCS_DEST, { recursive: true, force: true });\n    await mkdir(DOCS_DEST, { recursive: true });\n\n    const docsPath = join(DOCS_DEST, \"docs\");\n    await copyDir(DOCS_SOURCE, docsPath);\n    logger.info(`Copied documentation to ${docsPath}`);\n\n    const blogPath = join(DOCS_DEST, \"blog\");\n    await copyDir(BLOG_SOURCE, blogPath);\n    logger.info(`Copied blog posts to ${blogPath}`);\n\n    logger.info(\"Raw documentation copy complete\");\n  } catch (error) {\n    logger.error(\"Failed to copy raw documentation\", error);\n    throw error;\n  }\n}\n"],"mappings":";;;;;AAKA,MAAM,cAAc,KAAK,UAAU,wBAAwB;AAC3D,MAAM,cAAc,KAAK,UAAU,wBAAwB;AAC3D,MAAM,YAAY,KAAK,UAAU,oCAAoC;AAErE,eAAe,QAAQ,KAAa,MAA6B;CAC/D,IAAI;EACF,MAAM,MAAM,MAAM,EAAE,WAAW,KAAK,CAAC;EACrC,MAAM,UAAU,MAAM,QAAQ,KAAK,EAAE,eAAe,KAAK,CAAC;EAE1D,KAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,UAAU,KAAK,KAAK,MAAM,IAAI;GACpC,MAAM,WAAW,KAAK,MAAM,MAAM,IAAI;GAEtC,IAAI,MAAM,YAAY,GACpB,MAAM,QAAQ,SAAS,QAAQ;QAC1B,IAAI,MAAM,OAAO,GAAG;IACzB,MAAM,MAAM,QAAQ,MAAM,IAAI,CAAC,CAAC,YAAY;IAC5C,IAAI,QAAQ,UAAU,QAAQ,OAAO;KACnC,MAAM,SAAS,SAAS,QAAQ;KAChC,OAAO,MAAM,WAAW,QAAQ,MAAM,UAAU;IAClD;GACF;EACF;CACF,SAAS,OAAO;EACd,OAAO,MAAM,6BAA6B,OAAO,KAAK;EACtD,MAAM;CACR;AACF;AAEA,eAAsB,UAAyB;CAC7C,OAAO,KAAK,oCAAoC;CAEhD,IAAI;EACF,MAAM,GAAG,WAAW;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;EACpD,MAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;EAE1C,MAAM,WAAW,KAAK,WAAW,MAAM;EACvC,MAAM,QAAQ,aAAa,QAAQ;EACnC,OAAO,KAAK,2BAA2B,UAAU;EAEjD,MAAM,WAAW,KAAK,WAAW,MAAM;EACvC,MAAM,QAAQ,aAAa,QAAQ;EACnC,OAAO,KAAK,wBAAwB,UAAU;EAE9C,OAAO,KAAK,iCAAiC;CAC/C,SAAS,OAAO;EACd,OAAO,MAAM,oCAAoC,KAAK;EACtD,MAAM;CACR;AACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"prepare.js","names":[],"sources":["../../src/prepare-docs/prepare.ts"],"sourcesContent":["import { logger } from \"../utils/logger.js\";\nimport { copyRaw } from \"./copy-raw.js\";\nimport { prepareCodeExamples } from \"./code-examples.js\";\n\nasync function prepare(): Promise<void> {\n  logger.info(\"Starting documentation preparation...\");\n\n  try {\n    await copyRaw();\n    await prepareCodeExamples();\n\n    logger.info(\"Documentation preparation complete\");\n  } catch (error) {\n    logger.error(\"Documentation preparation failed\", error);\n    throw error;\n  }\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  prepare().catch((error) => {\n    logger.error(\"Preparation failed\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;AAIA,eAAe,UAAyB;CACtC,OAAO,KAAK,uCAAuC;CAEnD,IAAI;EACF,MAAM,QAAQ;EACd,MAAM,oBAAoB;EAE1B,OAAO,KAAK,oCAAoC;CAClD,SAAS,OAAO;EACd,OAAO,MAAM,oCAAoC,KAAK;EACtD,MAAM;CACR;AACF;AAEA,IAAI,OAAO,KAAK,QAAQ,UAAU,QAAQ,KAAK,MAC7C,QAAQ,EAAE,OAAO,UAAU;CACzB,OAAO,MAAM,sBAAsB,KAAK;CACxC,QAAQ,KAAK,CAAC;AAChB,CAAC"}
+{"version":3,"file":"prepare.js","names":[],"sources":["../../src/prepare-docs/prepare.ts"],"sourcesContent":["import { logger } from \"../utils/logger.js\";\nimport { copyRaw } from \"./copy-raw.js\";\nimport { prepareCodeExamples } from \"./code-examples.js\";\n\nasync function prepare(): Promise<void> {\n  logger.info(\"Starting documentation preparation...\");\n\n  try {\n    await copyRaw();\n    await prepareCodeExamples();\n\n    logger.info(\"Documentation preparation complete\");\n  } catch (error) {\n    logger.error(\"Documentation preparation failed\", error);\n    throw error;\n  }\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  prepare().catch((error) => {\n    logger.error(\"Preparation failed\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;AAIA,eAAe,UAAyB;CACtC,OAAO,KAAK,uCAAuC;CAEnD,IAAI;EACF,MAAM,QAAQ;EACd,MAAM,oBAAoB;EAE1B,OAAO,KAAK,oCAAoC;CAClD,SAAS,OAAO;EACd,OAAO,MAAM,oCAAoC,KAAK;EACtD,MAAM;CACR;AACF;AAEA,IAAI,OAAO,KAAK,QAAQ,UAAU,QAAQ,KAAK,MAC7C,QAAQ,CAAC,CAAC,OAAO,UAAU;CACzB,OAAO,MAAM,sBAAsB,KAAK;CACxC,QAAQ,KAAK,CAAC;AAChB,CAAC"}