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

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

@@ -0,0 +1,278 @@
+---
+title: react-o11y
+description: Headless primitives for visualizing observability spans (traces, waterfalls).
+platforms: ["react"]
+---
+
+<Callout type="warn">
+`@assistant-ui/react-o11y` is currently v0.0.11 and experimental. The API may change without notice.
+</Callout>
+
+`@assistant-ui/react-o11y` provides headless, Radix-style primitives for rendering observability spans as collapsible, indented hierarchical UIs. Use it to build trace inspectors, waterfall debug panels, or LLM call timelines on top of your own span data source.
+
+- **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.
+
+## Installation
+
+<InstallCommand npm={["@assistant-ui/react-o11y"]} />
+
+## Quick start
+
+Mount `SpanResource` with your span data, then render primitives that read from the resource's state:
+
+```tsx title="components/trace-view.tsx"
+"use client";
+
+import {
+  SpanPrimitive,
+  SpanResource,
+  type SpanData,
+} from "@assistant-ui/react-o11y";
+import { useAui, AuiProvider } from "@assistant-ui/store";
+
+function SpanRow() {
+  return (
+    <SpanPrimitive.Root className="flex items-center gap-2 py-1">
+      <SpanPrimitive.Indent />
+      <SpanPrimitive.CollapseToggle className="size-4 cursor-pointer">
+        ▸
+      </SpanPrimitive.CollapseToggle>
+      <SpanPrimitive.StatusIndicator className="size-2 rounded-full data-[span-status=running]:bg-yellow-500 data-[span-status=completed]:bg-green-500 data-[span-status=failed]:bg-red-500" />
+      <SpanPrimitive.TypeBadge className="rounded bg-muted px-1.5 text-xs" />
+      <SpanPrimitive.Name className="text-sm" />
+      <SpanPrimitive.Children components={{ Span: SpanRow }} />
+    </SpanPrimitive.Root>
+  );
+}
+
+export function TraceView({ spans }: { spans: SpanData[] }) {
+  const aui = useAui({ resource: SpanResource({ spans }) });
+
+  return (
+    <AuiProvider value={aui}>
+      <SpanPrimitive.Children components={{ Span: SpanRow }} />
+    </AuiProvider>
+  );
+}
+```
+
+`SpanData` is the input shape your code produces (see [SpanData](#spandata)). `SpanResource` enriches it with depth, child counts, time range, and collapse state.
+
+## Anatomy
+
+```tsx
+import {
+  SpanPrimitive,
+  SpanResource,
+  SpanByIndexProvider,
+} from "@assistant-ui/react-o11y";
+
+// Top-level: mount SpanResource via useAui
+const aui = useAui({ resource: SpanResource({ spans }) });
+
+<AuiProvider value={aui}>
+  {/* Render visible spans (flat-list output respecting collapsed state) */}
+  <SpanPrimitive.Children components={{ Span: SpanRow }} />
+</AuiProvider>;
+
+// Each <SpanRow /> sits inside its own SpanByIndexProvider context and reads via primitives
+function SpanRow() {
+  return (
+    <SpanPrimitive.Root>
+      <SpanPrimitive.Indent />
+      <SpanPrimitive.CollapseToggle />
+      <SpanPrimitive.StatusIndicator />
+      <SpanPrimitive.TypeBadge />
+      <SpanPrimitive.Name />
+    </SpanPrimitive.Root>
+  );
+}
+```
+
+`SpanPrimitive.Children` produces a flat list of visible spans (collapsed subtrees are excluded). Each rendered child is wrapped in a `SpanByIndexProvider` so its primitives resolve to that specific span's state.
+
+## API reference
+
+### SpanResource
+
+Tap resource that ingests raw span data and exposes a tree-aware reactive state to primitives.
+
+```ts
+SpanResource({ spans }: { spans: SpanData[] }): ClientOutput<"span">;
+```
+
+Mount through `useAui({ resource: SpanResource({ spans }) })`.
+
+The resource computes:
+
+- **depth** of each span based on parent chain.
+- **hasChildren** flag.
+- **timeRange** (`min` / `max` across all spans).
+- **collapse state** managed internally; toggles through primitives.
+
+### SpanData
+
+Input shape you provide to `SpanResource`:
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `id` | `string` | Unique span identifier. |
+| `parentSpanId` | `string \| null` | Parent span id, or `null` for root spans. |
+| `name` | `string` | Display name. |
+| `type` | `string` | Span category (e.g. `llm`, `tool`, `http`). Used by `TypeBadge`. |
+| `status` | `"running" \| "completed" \| "failed" \| "skipped"` | Lifecycle state. Used by `StatusIndicator`. |
+| `startedAt` | `number` | Start timestamp (ms). |
+| `endedAt` | `number \| null` | End timestamp (ms), or `null` if still running. |
+| `latencyMs` | `number \| null` | Pre-computed latency, or `null` if running. |
+
+### SpanState
+
+Returned by `useAuiState((s) => s.span)` inside any span-scoped subtree:
+
+```ts
+type SpanState = {
+  id: string;
+  parentSpanId: string | null;
+  name: string;
+  type: string;
+  status: "running" | "completed" | "failed" | "skipped";
+  startedAt: number;
+  endedAt: number | null;
+  latencyMs: number | null;
+  depth: number;
+  hasChildren: boolean;
+  isCollapsed: boolean;
+  children: SpanItemState[];
+  timeRange: { min: number; max: number };
+};
+```
+
+### SpanPrimitive.Root
+
+Container `<div>` exposing span state via data attributes for styling:
+
+| Attribute | Source |
+| --- | --- |
+| `data-span-id` | `span.id` |
+| `data-span-status` | `span.status` |
+| `data-span-type` | `span.type` |
+| `data-span-depth` | `span.depth` |
+| `data-collapsed` | `span.isCollapsed` |
+
+Accepts all standard `<div>` props.
+
+### SpanPrimitive.Indent
+
+A `<div>` that adds horizontal padding proportional to span depth.
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `baseIndent` | `number` | `8` | Base padding in pixels. |
+| `indentPerLevel` | `number` | `12` | Additional padding per depth level. |
+
+Final `paddingLeft = baseIndent + depth * indentPerLevel`.
+
+### SpanPrimitive.CollapseToggle
+
+A `<button>` that toggles the current span's collapsed state. Renders only when the span has children. Stops click propagation so it can be nested inside a clickable row.
+
+Exposes `data-collapsed` for styling. Accepts all standard `<button>` props.
+
+### SpanPrimitive.StatusIndicator
+
+A `<span>` that exposes `data-span-status` for status-based styling (color, icon swap, etc.). Renders no built-in glyph; you provide the visual.
+
+```tsx
+<SpanPrimitive.StatusIndicator className="size-2 rounded-full data-[span-status=running]:bg-yellow-500 data-[span-status=completed]:bg-green-500 data-[span-status=failed]:bg-red-500 data-[span-status=skipped]:bg-gray-400" />
+```
+
+### SpanPrimitive.TypeBadge
+
+A `<span>` that defaults its children to `span.type` (override by passing custom children). Exposes `data-span-type`.
+
+### SpanPrimitive.Name
+
+A `<span>` that defaults its children to `span.name`. Override by passing custom children.
+
+### SpanPrimitive.Children
+
+Iterates over visible child spans and renders each.
+
+Two usage modes:
+
+**Render-prop:**
+
+```tsx
+<SpanPrimitive.Children>
+  {({ span }) => <CustomRow span={span} />}
+</SpanPrimitive.Children>
+```
+
+**Component prop (recommended for performance):**
+
+```tsx
+<SpanPrimitive.Children components={{ Span: SpanRow }} />
+```
+
+The `components.Span` form is memoized; pass a stable component reference to avoid re-renders on unrelated state changes.
+
+Each child is wrapped in `SpanByIndexProvider` automatically, so primitives inside `SpanRow` read that child's state.
+
+### SpanByIndexProvider
+
+Lower-level escape hatch. Selects one span by index and provides its scope to descendants:
+
+```tsx
+<SpanByIndexProvider index={0}>
+  <SpanPrimitive.Root>{/* reads span at index 0 */}</SpanPrimitive.Root>
+</SpanByIndexProvider>
+```
+
+Most users do not need to use this directly; `SpanPrimitive.Children` wires it up automatically.
+
+### SpanPrimitive.ChildByIndex
+
+Convenience component that pairs `SpanByIndexProvider` with a render component:
+
+```tsx
+<SpanPrimitive.ChildByIndex index={0} components={{ Span: SpanRow }} />
+```
+
+Useful when you want explicit control over which child indices to render (e.g. for virtualization).
+
+## Styling
+
+All primitives forward refs and accept standard DOM props (`className`, `style`, etc.). Use the data attributes for state-based styling:
+
+```css
+[data-span-status="running"] {
+  /* yellow indicator */
+}
+[data-span-status="failed"] {
+  /* red indicator */
+}
+[data-collapsed="true"] svg {
+  transform: rotate(0deg);
+}
+[data-collapsed="false"] svg {
+  transform: rotate(90deg);
+}
+```
+
+## Related
+
+<Cards>
+  <Card
+    title="heat-graph"
+    description="Activity heatmap primitives in the same Radix-style headless pattern."
+    href="/docs/utilities/heat-graph"
+  />
+  <Card
+    title="Primitives overview"
+    description="The broader assistant-ui primitive system."
+    href="/docs/primitives"
+  />
+</Cards>

package/.docs/raw/docs/utilities/tw-shimmer.mdx

@@ -1,6 +1,7 @@
 ---
 title: tw-shimmer
 description: Tailwind CSS v4 plugin for shimmer effects.
+platforms: ["react"]
 ---
 
 `tw-shimmer` is a zero-dependency Tailwind CSS v4 plugin that provides polished shimmer animations for both text and skeleton loaders. It uses sine-eased gradients with 17 carefully calculated stops and OKLCH color mixing for smooth, banding-free effects.

package/README.md

@@ -1,28 +1,23 @@
-# Assistant-UI MCP Docs Server
+# `@assistant-ui/mcp-docs-server`
 
-A Model Context Protocol (MCP) server that provides AI assistants with direct access to assistant-ui's documentation and examples.
+Model Context Protocol (MCP) server that gives AI assistants direct access to assistant-ui's documentation and example projects. Exposes `assistantUIDocs` (retrieve documentation by path) and `assistantUIExamples` (access complete example projects).
 
-> **📖 Full Documentation**
-> For detailed installation instructions, troubleshooting, and advanced usage, visit the [complete documentation](https://www.assistant-ui.com/docs/llm#mcp).
+> [!NOTE]
+> Detailed installation, troubleshooting, and advanced usage at [assistant-ui.com/docs/llm#mcp](https://www.assistant-ui.com/docs/llm#mcp).
 
 ## Installation
 
 ### Claude Code
 
 ```bash
-# Add to current project
 claude mcp add assistant-ui -- npx -y @assistant-ui/mcp-docs-server
-
-# Or add globally for all projects
+# or globally for all projects
 claude mcp add --scope user assistant-ui -- npx -y @assistant-ui/mcp-docs-server
 ```
 
 ### Claude Desktop
 
-Add to your Claude Desktop configuration:
-
-- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
 
 ```json
 {
@@ -35,39 +30,13 @@ Add to your Claude Desktop configuration:
 }
 ```
 
-### Cursor
-
-Add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
+### Cursor / Windsurf
 
-```json
-{
-  "mcpServers": {
-    "assistant-ui": {
-      "command": "npx",
-      "args": ["-y", "@assistant-ui/mcp-docs-server"]
-    }
-  }
-}
-```
-
-### Windsurf
-
-Add to `~/.codeium/windsurf/mcp_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "assistant-ui": {
-      "command": "npx",
-      "args": ["-y", "@assistant-ui/mcp-docs-server"]
-    }
-  }
-}
-```
+Add to `.cursor/mcp.json` (or `~/.cursor/mcp.json`) for Cursor, or `~/.codeium/windsurf/mcp_config.json` for Windsurf, using the same `mcpServers` block as above.
 
-### VSCode
+### VS Code
 
-Add to `.vscode/mcp.json` in your project:
+Add to `.vscode/mcp.json`:
 
 ```json
 {
@@ -83,7 +52,7 @@ Add to `.vscode/mcp.json` in your project:
 
 ### Zed
 
-Add to `settings.json` (open via `cmd+,` or `zed: open settings`):
+Add to `settings.json`:
 
 ```json
 {
@@ -91,38 +60,11 @@ Add to `settings.json` (open via `cmd+,` or `zed: open settings`):
     "assistant-ui": {
       "command": {
         "path": "npx",
-        "args": ["-y", "@assistant-ui/mcp-docs-server"],
-        "env": {}
-      },
-      "settings": {}
+        "args": ["-y", "@assistant-ui/mcp-docs-server"]
+      }
     }
   }
 }
 ```
 
-## Tools
-
-- **assistantUIDocs** - Retrieve documentation by path
-- **assistantUIExamples** - Access complete example projects
-
-## Managing the Server
-
-### Claude Code
-
-```bash
-# View configured servers
-claude mcp list
-
-# Get server details
-claude mcp get assistant-ui
-
-# Remove the server
-claude mcp remove assistant-ui
-
-# Restart the server
-claude mcp restart assistant-ui
-```
-
-## License
-
-MIT
+To list, get, or remove the server, use your editor's MCP management commands.

package/dist/constants.d.ts

@@ -1,10 +1,13 @@
-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;
+//#region src/constants.d.ts
+declare const ROOT_DIR: string;
+declare const PACKAGE_DIR: string;
+declare const EXAMPLES_PATH: string;
+declare const DOCS_PATH: string;
+declare const CODE_EXAMPLES_PATH: string;
+declare const MDX_EXTENSION = ".mdx";
+declare const MD_EXTENSION = ".md";
+declare const MAX_FILE_SIZE: number;
+declare const IS_PREPARE_MODE: boolean | undefined;
+//#endregion
+export { CODE_EXAMPLES_PATH, DOCS_PATH, EXAMPLES_PATH, IS_PREPARE_MODE, MAX_FILE_SIZE, MDX_EXTENSION, MD_EXTENSION, PACKAGE_DIR, ROOT_DIR };
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"constants.d.ts","names":[],"sources":["../src/constants.ts"],"mappings":";cAKa,QAAA;AAAA,cACA,WAAA;AAAA,cAEA,aAAA;AAAA,cAGA,SAAA;AAAA,cACA,kBAAA;AAAA,cAEA,aAAA;AAAA,cACA,YAAA;AAAA,cAEA,aAAA;AAAA,cAEA,eAAA"}

package/dist/constants.js

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

package/dist/constants.js.map

@@ -1 +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"}
+{"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"}

package/dist/index.d.ts

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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,kCAAgD;AAcpE,eAAO,MAAM,MAAM,WAGjB,CAAC;AAeH,wBAAsB,SAAS,kBAW9B"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;cAca,MAAA,EAAM,SAGjB;AAAA,iBAeoB,SAAA,CAAA,GAAS,OAAA"}

package/dist/index.js

@@ -1,33 +1,34 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { PACKAGE_DIR } from "./constants.js";
+import { logger } from "./utils/logger.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";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { readFileSync } from "node:fs";
+//#region src/index.ts
 const packageJson = JSON.parse(readFileSync(join(PACKAGE_DIR, "package.json"), "utf-8"));
-export const server = new McpServer({
-    name: "assistant-ui-docs",
-    version: packageJson.version,
+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);
-    });
+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]}`) runServer().catch((error) => {
+	console.error("Failed to start server:", error);
+	process.exit(1);
+});
+//#endregion
+export { runServer, server };
+
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"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"}

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

@@ -1,2 +1,5 @@
-export declare function prepareCodeExamples(): Promise<void>;
+//#region src/prepare-docs/code-examples.d.ts
+declare function prepareCodeExamples(): Promise<void>;
+//#endregion
+export { prepareCodeExamples };
 //# sourceMappingURL=code-examples.d.ts.map

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

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