@assistant-ui/mcp-docs-server 0.1.36 → 0.1.39

package/.docs/raw/docs/ui/model-selector.mdx

@@ -5,10 +5,14 @@ platforms: ["react"]
 ---
 
 import { ModelSelectorSample } from "@/components/docs/samples/model-selector";
+import * as ModelSelectorRadixSamples from "@/components/docs/samples/model-selector.radix";
+import { Flavored, FlavorSwitcher } from "@/components/docs/contexts/flavor.server";
 
 A picker that lets users switch between AI models and choose a reasoning effort (thinking) level. It is built on Popover + Command, so search, provider grouping, and filtering compose in without being built in. The default export integrates with assistant-ui's `ModelContext` system, so the selection reaches your backend on every request with no extra wiring.
 
-<ModelSelectorSample />
+<FlavorSwitcher />
+
+<Flavored radix={<ModelSelectorRadixSamples.ModelSelectorSample />} base={<ModelSelectorSample />} />
 
 ## Getting Started
 
@@ -141,6 +145,26 @@ function EffortDropdown() {
 
 Render it inside `ModelSelector.Content` in place of `ModelSelector.Effort`. The same hook supports any shape that reads the levels and writes the selection.
 
+## Provider Logos
+
+Each model's `icon` accepts any `ReactNode` and renders in the trigger and the dropdown items. The optional `logos` registry item ships `OpenAILogo`, `ClaudeLogo`, and `GeminiLogo` marks to plug in:
+
+<InstallCommand shadcn={["logos"]} />
+
+```tsx
+import { ClaudeLogo, GeminiLogo, OpenAILogo } from "@/components/assistant-ui/logos";
+
+<ModelSelector
+  models={[
+    { id: "gpt-5.5", name: "GPT-5.5", icon: <OpenAILogo /> },
+    { id: "claude-opus-4.5", name: "Claude Opus 4.5", icon: <ClaudeLogo /> },
+    { id: "gemini-3-pro", name: "Gemini 3 Pro", icon: <GeminiLogo /> },
+  ]}
+/>;
+```
+
+Icons are opt-in per model — omit `icon` and the entry renders text-only.
+
 ## Search
 
 Search is opt-in. Pass `searchable` to the default component:
@@ -149,7 +173,7 @@ Search is opt-in. Pass `searchable` to the default component:
 <ModelSelector models={models} searchable />
 ```
 
-Or compose `ModelSelector.Search` into a custom layout. Matching runs against each model's `id`, `name`, and `keywords`; add the provider name to `keywords` so typing "openai" finds its models.
+The same prop works on `ModelSelector.Content` when it renders its default children. Or compose `ModelSelector.Search` into a custom layout. Matching runs against each model's `id`, `name`, and `keywords`; add the provider name to `keywords` so typing "openai" finds its models.
 
 ## Composition
 
@@ -204,6 +228,7 @@ import {
 | `ModelSelector.Value` | Selected model name, icon, and active effort |
 | `ModelSelector.Content` | Popover content wrapping a Command |
 | `ModelSelector.Search` | Search input that filters the list |
+| `ModelSelector.FocusAnchor` | Visually hidden input that anchors keyboard navigation when there is no search box |
 | `ModelSelector.List` | List of model items (renders all models by default) |
 | `ModelSelector.Empty` | Empty state shown when search has no matches |
 | `ModelSelector.Group` | Labeled group of items (e.g. by provider) |
@@ -213,12 +238,20 @@ import {
 
 `ModelSelector.List` is a Command list, so filtering and keyboard navigation work across groups automatically. Custom sorting is plain code: order the models before rendering items.
 
+Keyboard navigation needs a focused input to drive it. When content is unfiltered (`searchable={false}` on `ModelSelector.Content`, or the default children), `ModelSelector.Content` renders a visually hidden `ModelSelector.FocusAnchor` automatically, so custom layouts without a search box stay keyboard-operable. In a custom layout that renders neither `ModelSelector.Search` nor `searchable={false}`, place `ModelSelector.FocusAnchor` yourself to keep the list reachable from the keyboard.
+
 <Callout type="warn">
   `ModelSelector.Content` wraps a Command whose root keydown handler claims
-  <kbd>Enter</kbd> to select the highlighted model. Interactive elements
-  composed inside it (filter chips, custom effort controls) should stop
-  propagation for Enter in their own `onKeyDown` so the focused control
-  activates instead. `ModelSelector.Effort` already does this.
+  <Kbd>Enter</Kbd> to select the highlighted model and the arrow keys to move
+  through the list. Interactive elements composed inside it (filter chips,
+  custom effort controls) should stop propagation for the keys they handle in
+  their own `onKeyDown` so the focused control responds instead.
+  `ModelSelector.Effort` does this for <Kbd>Home</Kbd> / <Kbd>End</Kbd> (which
+  cmdk would otherwise use to jump to the first / last model), lets its
+  radiogroup own <Kbd>ArrowLeft</Kbd> / <Kbd>ArrowRight</Kbd>, and hands
+  <Kbd>ArrowUp</Kbd> / <Kbd>ArrowDown</Kbd> back to the model list by
+  refocusing cmdk's input, so the highlight only moves while a following
+  <Kbd>Enter</Kbd> can act on it.
 </Callout>
 
 ## Variants
@@ -247,6 +280,30 @@ Use the `size` prop to control the trigger dimensions.
 <ModelSelector size="lg" />      // Large (h-10)
 ```
 
+## Keyboard Navigation
+
+The picker is fully operable from the keyboard, including when search is disabled.
+
+| Key | Action |
+| --- | --- |
+| <Kbd>ArrowDown</Kbd> / <Kbd>ArrowUp</Kbd> | Open the popover from the focused trigger; move between models once open, returning focus to the list from the Thinking row |
+| <Kbd>Enter</Kbd> | Select the highlighted model and close |
+| <Kbd>Escape</Kbd> | Close the popover and return focus to the trigger |
+| <Kbd>Tab</Kbd> | Move from the model list to the Thinking row |
+| <Kbd>ArrowLeft</Kbd> / <Kbd>ArrowRight</Kbd> | Move between reasoning effort levels (Thinking row) |
+| <Kbd>Home</Kbd> / <Kbd>End</Kbd> | Jump to the first / last model (list) or effort level (Thinking row) |
+
+When `searchable` is set, typing filters the list; otherwise the keys above drive selection directly.
+
+## Accessibility
+
+The picker implements the WAI-ARIA combobox pattern over Popover + Command.
+
+- The trigger is `role="combobox"` with `aria-haspopup="listbox"`; the popover primitive manages `aria-expanded` and `aria-controls`.
+- The model list is a Command (cmdk) listbox: each item is `role="option"` with `aria-selected`, and the active item is tracked with `aria-activedescendant`.
+- Keyboard navigation works without a visible search box: `ModelSelector.Content` renders a visually hidden input (`ModelSelector.FocusAnchor`) that anchors cmdk's focus so the list stays reachable. Pass `searchable` to surface a real search input instead.
+- The Thinking row (`ModelSelector.Effort`) is a `role="radiogroup"` of `role="radio"` toggles with roving tabindex, so it is a single tab stop and <Kbd>ArrowLeft</Kbd> / <Kbd>ArrowRight</Kbd> move focus and select in one step. <Kbd>ArrowUp</Kbd> / <Kbd>ArrowDown</Kbd> return focus to the model list.
+
 ## How It Works
 
 The default `ModelSelector` export registers the selection with assistant-ui's `ModelContext` system:
@@ -318,6 +375,12 @@ This works out of the box with `@assistant-ui/react-ai-sdk`. `ModelSelector.Root
       default: '"default"',
       description: "Size of the trigger button.",
     },
+    {
+      name: "align",
+      type: '"start" | "center" | "end"',
+      default: '"start"',
+      description: "Alignment of the dropdown relative to the trigger.",
+    },
     {
       name: "contentClassName",
       type: "string",

package/.docs/raw/docs/ui/select.mdx

@@ -2,8 +2,10 @@
 title: Select
 description: A dropdown select component with composable sub-components.
 links:
-  - label: Radix UI Select
+  - label: Radix UI Select (Radix styles)
     url: https://www.radix-ui.com/primitives/docs/components/select
+  - label: Base UI Select (base styles)
+    url: https://base-ui.com/react/components/select
 platforms: ["react"]
 ---
 
@@ -18,12 +20,16 @@ import {
   SelectSizesSample,
   SelectScrollableSample,
 } from "@/components/docs/samples/select";
+import * as SelectRadixSamples from "@/components/docs/samples/select.radix";
+import { Flavored, FlavorSwitcher } from "@/components/docs/contexts/flavor.server";
 
 <Callout>
   This is a **standalone component** that does not depend on the assistant-ui runtime. Use it anywhere in your application.
 </Callout>
 
-<SelectSample />
+<FlavorSwitcher />
+
+<Flavored radix={<SelectRadixSamples.SelectSample />} base={<SelectSample />} />
 
 ## Installation
 
@@ -60,7 +66,7 @@ export function FruitPicker() {
 
 Use the `variant` prop on `SelectTrigger` to change the visual style.
 
-<SelectVariantsSample />
+<Flavored radix={<SelectRadixSamples.SelectVariantsSample />} base={<SelectVariantsSample />} />
 
 ```tsx
 <SelectTrigger variant="outline" /> // Border (default)
@@ -72,7 +78,7 @@ Use the `variant` prop on `SelectTrigger` to change the visual style.
 
 Use the `size` prop on `SelectTrigger` to change the height.
 
-<SelectSizesSample />
+<Flavored radix={<SelectRadixSamples.SelectSizesSample />} base={<SelectSizesSample />} />
 
 ```tsx
 <SelectTrigger size="default" /> // 36px (default)
@@ -83,34 +89,34 @@ Use the `size` prop on `SelectTrigger` to change the height.
 
 Long lists automatically become scrollable.
 
-<PreviewCode file="components/docs/samples/select" name="SelectScrollableSample">
-  <SelectScrollableSample />
+<PreviewCode file="components/docs/samples/select" name="SelectScrollableSample" base={<SelectScrollableSample />}>
+  <SelectRadixSamples.SelectScrollableSample />
 </PreviewCode>
 
 ### Groups
 
 Use the composable API for grouped options:
 
-<PreviewCode file="components/docs/samples/select" name="SelectGroupsSample">
-  <SelectGroupsSample />
+<PreviewCode file="components/docs/samples/select" name="SelectGroupsSample" base={<SelectGroupsSample />}>
+  <SelectRadixSamples.SelectGroupsSample />
 </PreviewCode>
 
 ### Disabled Items
 
-<PreviewCode file="components/docs/samples/select" name="SelectDisabledItemsSample">
-  <SelectDisabledItemsSample />
+<PreviewCode file="components/docs/samples/select" name="SelectDisabledItemsSample" base={<SelectDisabledItemsSample />}>
+  <SelectRadixSamples.SelectDisabledItemsSample />
 </PreviewCode>
 
 ### With Placeholder
 
-<PreviewCode file="components/docs/samples/select" name="SelectPlaceholderSample">
-  <SelectPlaceholderSample />
+<PreviewCode file="components/docs/samples/select" name="SelectPlaceholderSample" base={<SelectPlaceholderSample />}>
+  <SelectRadixSamples.SelectPlaceholderSample />
 </PreviewCode>
 
 ### Disabled Select
 
-<PreviewCode file="components/docs/samples/select" name="SelectDisabledSample">
-  <SelectDisabledSample />
+<PreviewCode file="components/docs/samples/select" name="SelectDisabledSample" base={<SelectDisabledSample />}>
+  <SelectRadixSamples.SelectDisabledSample />
 </PreviewCode>
 
 ## API Reference
@@ -131,6 +137,8 @@ Use the composable API for grouped options:
 | `SelectScrollUpButton` | Scroll indicator for long lists. |
 | `SelectScrollDownButton` | Scroll indicator for long lists. |
 
+With the Base UI flavor, `SelectValue` resolves the trigger label from the `items` prop on `SelectRoot`; pass the same array you map into `SelectItem` children. The Radix flavor reads the label from the selected item's text automatically.
+
 ### Select
 
 A convenience component that renders a complete select with options.

package/.docs/raw/docs/ui/sources.mdx

@@ -109,7 +109,7 @@ Root container rendered as an `<a>` tag. Accepts all `<a>` props plus `variant`
 | `size` | `"sm" \| "default" \| "lg"` | `"default"` | Size of the badge |
 | `target` | `string` | `"_blank"` | Link target |
 | `rel` | `string` | `"noopener noreferrer"` | Link rel attribute |
-| `asChild` | `boolean` | `false` | Render as a child element using Radix Slot |
+| `asChild` | `boolean` | `false` | Merge props with a child element instead of rendering an anchor. Effective with the Radix badge; the Base UI badge ignores it |
 | `className` | `string` | — | Additional CSS classes |
 
 ### `SourceIcon`

package/.docs/raw/docs/ui/tabs.mdx

@@ -2,8 +2,10 @@
 title: Tabs
 description: A multi-variant tabs component for organizing content into switchable panels.
 links:
-  - label: Radix UI Tabs
+  - label: Radix UI Tabs (Radix styles)
     url: https://www.radix-ui.com/primitives/docs/components/tabs
+  - label: Base UI Tabs (base styles)
+    url: https://base-ui.com/react/components/tabs
 platforms: ["react"]
 ---
 
@@ -17,12 +19,16 @@ import {
   TabsAsLinkSample,
   TabsAnimatedIndicatorSample,
 } from "@/components/docs/samples/tabs";
+import * as TabsRadixSamples from "@/components/docs/samples/tabs.radix";
+import { Flavored, FlavorSwitcher } from "@/components/docs/contexts/flavor.server";
 
 <Callout>
   This is a **standalone component** that does not depend on the assistant-ui runtime. Use it anywhere in your application.
 </Callout>
 
-<TabsSample />
+<FlavorSwitcher />
+
+<Flavored radix={<TabsRadixSamples.TabsSample />} base={<TabsSample />} />
 
 ## Installation
 
@@ -58,7 +64,7 @@ export function Example() {
 
 Use the `variant` prop on `TabsList` to change the visual style. Child components inherit the variant automatically.
 
-<TabsVariantsSample />
+<Flavored radix={<TabsRadixSamples.TabsVariantsSample />} base={<TabsVariantsSample />} />
 
 ```tsx
 <TabsList variant="default" />  // Muted background with shadow (default)
@@ -72,7 +78,7 @@ Use the `variant` prop on `TabsList` to change the visual style. Child component
 
 Use the `size` prop on `TabsList` to change the tab height. Child components inherit the size automatically.
 
-<TabsSizesSample />
+<Flavored radix={<TabsRadixSamples.TabsSizesSample />} base={<TabsSizesSample />} />
 
 ```tsx
 <TabsList size="sm" />      // 32px height
@@ -84,24 +90,24 @@ Use the `size` prop on `TabsList` to change the tab height. Child components inh
 
 Tabs automatically style SVG icons placed inside triggers.
 
-<PreviewCode file="components/docs/samples/tabs" name="TabsWithIconsSample">
-  <TabsWithIconsSample />
+<PreviewCode file="components/docs/samples/tabs" name="TabsWithIconsSample" base={<TabsWithIconsSample />}>
+  <TabsRadixSamples.TabsWithIconsSample />
 </PreviewCode>
 
 ### Controlled
 
 Use `value` and `onValueChange` for controlled tab state.
 
-<PreviewCode file="components/docs/samples/tabs" name="TabsControlledSample">
-  <TabsControlledSample />
+<PreviewCode file="components/docs/samples/tabs" name="TabsControlledSample" base={<TabsControlledSample />}>
+  <TabsRadixSamples.TabsControlledSample />
 </PreviewCode>
 
 ### As Link
 
-Use the `asChild` prop on `TabsTrigger` to render as a different element, like a navigation link.
+Compose with `render` (Base UI) or `asChild` (Radix) on `TabsTrigger` to render as a different element, like a navigation link.
 
-<PreviewCode file="components/docs/samples/tabs" name="TabsAsLinkSample">
-  <TabsAsLinkSample />
+<PreviewCode file="components/docs/samples/tabs" name="TabsAsLinkSample" base={<TabsAsLinkSample />}>
+  <TabsRadixSamples.TabsAsLinkSample />
 </PreviewCode>
 
 ### Animated Indicator
@@ -116,8 +122,8 @@ All variants feature smooth animated indicators that slide between tabs:
 | `pills` | Sliding pill background |
 | `outline` | Sliding border |
 
-<PreviewCode file="components/docs/samples/tabs" name="TabsAnimatedIndicatorSample">
-  <TabsAnimatedIndicatorSample />
+<PreviewCode file="components/docs/samples/tabs" name="TabsAnimatedIndicatorSample" base={<TabsAnimatedIndicatorSample />}>
+  <TabsRadixSamples.TabsAnimatedIndicatorSample />
 </PreviewCode>
 
 ## API Reference
@@ -201,11 +207,16 @@ An individual tab button.
       required: true,
       description: "The unique value for this tab.",
     },
+    {
+      name: "render",
+      type: "ReactElement | function",
+      description: "Base UI: compose as a different element instead of rendering a button.",
+    },
     {
       name: "asChild",
       type: "boolean",
       default: "false",
-      description: "Merge props with child element instead of rendering a button.",
+      description: "Radix: merge props with a child element instead of rendering a button.",
     },
     {
       name: "disabled",

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

@@ -20,9 +20,9 @@ import { HeatGraphDemo } from "@/app/(demos)/heat-graph/heat-graph-demo";
 <Tabs items={["shadcn", "npm", "pnpm", "yarn"]}>
   <Tab value="shadcn">
     ```sh
-    npx shadcn@latest add https://r.assistant-ui.com/heat-graph
+    npx shadcn@latest add @assistant-ui/heat-graph
     ```
-    This installs a pre-styled `HeatGraph` component to `components/assistant-ui/heat-graph.tsx` along with the `heat-graph` package.
+    This installs a pre-styled `HeatGraph` component to `components/assistant-ui/heat-graph.tsx` along with the `heat-graph` package. The `@assistant-ui` namespace resolves through the registry entry configured in [Manual Setup](/docs/installation#manual-setup).
   </Tab>
   <Tab value="npm">
     ```sh

package/README.md

@@ -1,6 +1,6 @@
 # `@assistant-ui/mcp-docs-server`
 
-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).
+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), `assistantUIExamples` (access complete example projects), and `assistantUISearch` (keyword search across the bundled docs), and serves the same docs and examples as readable MCP **resources** (`aui-docs:///{path}`, `aui-example:///{name}`).
 
 > [!NOTE]
 > Detailed installation, troubleshooting, and advanced usage at [assistant-ui.com/docs/llm#mcp](https://www.assistant-ui.com/docs/llm#mcp).

package/dist/constants.d.ts

@@ -7,7 +7,8 @@ declare const CODE_EXAMPLES_PATH: string;
 declare const MDX_EXTENSION = ".mdx";
 declare const MD_EXTENSION = ".md";
 declare const MAX_FILE_SIZE: number;
+declare const MAX_DIRECTORY_CONTENT_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 };
+export { CODE_EXAMPLES_PATH, DOCS_PATH, EXAMPLES_PATH, IS_PREPARE_MODE, MAX_DIRECTORY_CONTENT_SIZE, 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","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"}
+{"version":3,"file":"constants.d.ts","names":[],"sources":["../src/constants.ts"],"mappings":";cAKa;cACA;cAEA;cAGA;cACA;cAEA;cACA;cAEA;cAEA;cAEA"}

package/dist/constants.js

@@ -11,8 +11,9 @@ 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 MAX_DIRECTORY_CONTENT_SIZE = 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 };
+export { CODE_EXAMPLES_PATH, DOCS_PATH, EXAMPLES_PATH, IS_PREPARE_MODE, MAX_DIRECTORY_CONTENT_SIZE, 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","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"}
+{"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 MAX_DIRECTORY_CONTENT_SIZE = 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,6BAA6B,OAAO;AAEjD,MAAa,kBAAkB,QAAQ,KAAK,EAAE,EAAE,SAC9C,sBACF"}

package/dist/index.d.ts

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

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,iBAuBoB,SAAA,IAAS,OAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;cAsBa,QAAM;iBAqFG,aAAS"}

package/dist/index.js

@@ -2,6 +2,10 @@ 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 { searchTools } from "./tools/search.js";
+import { xuluxTemplateDetailsTool, xuluxTemplatePreviewTool, xuluxTemplatesListTool } from "./tools/xulux-templates.js";
+import { xuluxPlaygroundPrompt } from "./prompts/xulux-playground.js";
+import { registerResources } from "./tools/resources.js";
 import { join } from "node:path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -30,6 +34,53 @@ server.registerTool(examplesTools.name, {
 		openWorldHint: false
 	}
 }, examplesTools.execute);
+server.registerTool(searchTools.name, {
+	title: "Search assistant-ui Documentation",
+	description: searchTools.description,
+	inputSchema: searchTools.parameters,
+	annotations: {
+		readOnlyHint: true,
+		openWorldHint: false
+	}
+}, searchTools.execute);
+server.registerTool(xuluxTemplatesListTool.name, {
+	title: "assistant-ui Templates",
+	description: xuluxTemplatesListTool.description,
+	inputSchema: xuluxTemplatesListTool.parameters,
+	annotations: {
+		readOnlyHint: true,
+		openWorldHint: true
+	}
+}, xuluxTemplatesListTool.execute);
+server.registerTool(xuluxTemplateDetailsTool.name, {
+	title: "assistant-ui Template Details",
+	description: xuluxTemplateDetailsTool.description,
+	inputSchema: xuluxTemplateDetailsTool.parameters,
+	annotations: {
+		readOnlyHint: true,
+		openWorldHint: true
+	}
+}, xuluxTemplateDetailsTool.execute);
+server.registerTool(xuluxTemplatePreviewTool.name, {
+	title: "assistant-ui Template Preview URLs",
+	description: xuluxTemplatePreviewTool.description,
+	inputSchema: xuluxTemplatePreviewTool.parameters,
+	annotations: {
+		readOnlyHint: false,
+		openWorldHint: true
+	}
+}, xuluxTemplatePreviewTool.execute);
+server.registerPrompt(xuluxPlaygroundPrompt.name, {
+	title: "assistant-ui Template Workflow",
+	description: xuluxPlaygroundPrompt.description
+}, () => ({ messages: [{
+	role: "user",
+	content: {
+		type: "text",
+		text: xuluxPlaygroundPrompt.text
+	}
+}] }));
+registerResources(server);
 async function runServer() {
 	try {
 		logger.info(`Starting assistant-ui MCP docs server v${packageJson.version}`);

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.registerTool(\n  docsTools.name,\n  {\n    title: \"assistant-ui Documentation\",\n    description: docsTools.description,\n    inputSchema: docsTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  docsTools.execute,\n);\nserver.registerTool(\n  examplesTools.name,\n  {\n    title: \"assistant-ui Examples\",\n    description: examplesTools.description,\n    inputSchema: examplesTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\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,aACL,UAAU,MACV;CACE,OAAO;CACP,aAAa,UAAU;CACvB,aAAa,UAAU;CACvB,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,UAAU,OACZ;AACA,OAAO,aACL,cAAc,MACd;CACE,OAAO;CACP,aAAa,cAAc;CAC3B,aAAa,cAAc;CAC3B,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,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"}
+{"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 { searchTools } from \"./tools/search.js\";\nimport {\n  xuluxTemplatesListTool,\n  xuluxTemplateDetailsTool,\n  xuluxTemplatePreviewTool,\n} from \"./tools/xulux-templates.js\";\nimport { xuluxPlaygroundPrompt } from \"./prompts/xulux-playground.js\";\nimport { registerResources } from \"./tools/resources.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.registerTool(\n  docsTools.name,\n  {\n    title: \"assistant-ui Documentation\",\n    description: docsTools.description,\n    inputSchema: docsTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  docsTools.execute,\n);\nserver.registerTool(\n  examplesTools.name,\n  {\n    title: \"assistant-ui Examples\",\n    description: examplesTools.description,\n    inputSchema: examplesTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  examplesTools.execute,\n);\nserver.registerTool(\n  searchTools.name,\n  {\n    title: \"Search assistant-ui Documentation\",\n    description: searchTools.description,\n    inputSchema: searchTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  searchTools.execute,\n);\n\nserver.registerTool(\n  xuluxTemplatesListTool.name,\n  {\n    title: \"assistant-ui Templates\",\n    description: xuluxTemplatesListTool.description,\n    inputSchema: xuluxTemplatesListTool.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: true },\n  },\n  xuluxTemplatesListTool.execute,\n);\nserver.registerTool(\n  xuluxTemplateDetailsTool.name,\n  {\n    title: \"assistant-ui Template Details\",\n    description: xuluxTemplateDetailsTool.description,\n    inputSchema: xuluxTemplateDetailsTool.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: true },\n  },\n  xuluxTemplateDetailsTool.execute,\n);\nserver.registerTool(\n  xuluxTemplatePreviewTool.name,\n  {\n    title: \"assistant-ui Template Preview URLs\",\n    description: xuluxTemplatePreviewTool.description,\n    inputSchema: xuluxTemplatePreviewTool.parameters,\n    annotations: { readOnlyHint: false, openWorldHint: true },\n  },\n  xuluxTemplatePreviewTool.execute,\n);\n\nserver.registerPrompt(\n  xuluxPlaygroundPrompt.name,\n  {\n    title: \"assistant-ui Template Workflow\",\n    description: xuluxPlaygroundPrompt.description,\n  },\n  () => ({\n    messages: [\n      {\n        role: \"user\" as const,\n        content: { type: \"text\" as const, text: xuluxPlaygroundPrompt.text },\n      },\n    ],\n  }),\n);\n\nregisterResources(server);\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":";;;;;;;;;;;;;AAkBA,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,aACL,UAAU,MACV;CACE,OAAO;CACP,aAAa,UAAU;CACvB,aAAa,UAAU;CACvB,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,UAAU,OACZ;AACA,OAAO,aACL,cAAc,MACd;CACE,OAAO;CACP,aAAa,cAAc;CAC3B,aAAa,cAAc;CAC3B,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,cAAc,OAChB;AACA,OAAO,aACL,YAAY,MACZ;CACE,OAAO;CACP,aAAa,YAAY;CACzB,aAAa,YAAY;CACzB,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,YAAY,OACd;AAEA,OAAO,aACL,uBAAuB,MACvB;CACE,OAAO;CACP,aAAa,uBAAuB;CACpC,aAAa,uBAAuB;CACpC,aAAa;EAAE,cAAc;EAAM,eAAe;CAAK;AACzD,GACA,uBAAuB,OACzB;AACA,OAAO,aACL,yBAAyB,MACzB;CACE,OAAO;CACP,aAAa,yBAAyB;CACtC,aAAa,yBAAyB;CACtC,aAAa;EAAE,cAAc;EAAM,eAAe;CAAK;AACzD,GACA,yBAAyB,OAC3B;AACA,OAAO,aACL,yBAAyB,MACzB;CACE,OAAO;CACP,aAAa,yBAAyB;CACtC,aAAa,yBAAyB;CACtC,aAAa;EAAE,cAAc;EAAO,eAAe;CAAK;AAC1D,GACA,yBAAyB,OAC3B;AAEA,OAAO,eACL,sBAAsB,MACtB;CACE,OAAO;CACP,aAAa,sBAAsB;AACrC,UACO,EACL,UAAU,CACR;CACE,MAAM;CACN,SAAS;EAAE,MAAM;EAAiB,MAAM,sBAAsB;CAAK;AACrE,CACF,EACF,EACF;AAEA,kBAAkB,MAAM;AAExB,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,IAAuB,OAAO"}
+{"version":3,"file":"code-examples.d.ts","names":[],"sources":["../../src/prepare-docs/code-examples.ts"],"mappings":";iBA2FsB,uBAAuB"}

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,IAAW,OAAO"}
+{"version":3,"file":"copy-raw.d.ts","names":[],"sources":["../../src/prepare-docs/copy-raw.ts"],"mappings":";iBAiCsB,WAAW"}

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

@@ -4,7 +4,6 @@ import { extname, join } from "node:path";
 import { copyFile, mkdir, readdir, rm } from "node:fs/promises";
 //#region src/prepare-docs/copy-raw.ts
 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 {
@@ -38,9 +37,6 @@ async function copyRaw() {
 		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);

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,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"}
+{"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 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    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,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,OAAO,KAAK,iCAAiC;CAC/C,SAAS,OAAO;EACd,OAAO,MAAM,oCAAoC,KAAK;EACtD,MAAM;CACR;AACF"}

package/dist/prompts/xulux-playground.d.ts

@@ -0,0 +1,12 @@
+//#region src/prompts/xulux-playground.d.ts
+declare const XULUX_PLAYGROUND_PROMPT_NAME = "assistant-ui-template-workflow";
+declare const XULUX_PLAYGROUND_PROMPT_DESCRIPTION = "How to use the assistant-ui template tools to discover hosted templates, inspect their customization contracts, and retrieve preview/download URLs.";
+declare const XULUX_PLAYGROUND_PROMPT = "You have access to assistant-ui template tools for hosted app templates.\n\n<workflow>\nFollow this template-first workflow for any assistant-ui app-building request:\n\n1. Call **assistantUITemplates** FIRST. Never decide on a template or claim one exists without listing.\n2. Call **assistantUITemplateDetails** on any candidate template before deciding whether it fits.\n   - Review the whole template shape: features, assistantPlacement, configRoots schemas, rules, built-in tools, renderers, and exampleConfig.\n   - If `customizable` is empty, the entry is a fixed demo. Use it as-is; never pass a config for it.\n3. Decide one of three paths:\n   - The template fits as-is: call **assistantUITemplatePreview** with templateId and optional versionId.\n   - The template fits with supported customization: author a config using the configRoots schemas and rules from assistantUITemplateDetails, then call **assistantUITemplatePreview** with that config.\n   - No template fits: do NOT call assistantUITemplatePreview. Do not force the request into a template or fake domain content with mock config. Instead, ground yourself in the assistant-ui docs (assistantUIDocs, assistantUISearch, assistantUIExamples) and produce an honest, docs-grounded build guide or prompt for the user.\n</workflow>\n\n<important_constraints>\n- Only use URLs copied exactly from tool results. Never guess, fabricate, or use placeholder URLs.\n- If assistantUITemplatePreview returns validationWarnings or an error, call assistantUITemplateDetails again and correct the config against configRoots. Pass only the documented top-level config roots.\n- Customization is for supported adaptation within a template's shape, not for turning it into a completely different kind of product.\n- Responses may include `catalogDegraded: true` when the live template catalog is unreachable. In that mode, template details and preview URLs may be unavailable; tell the user rather than improvising.\n</important_constraints>";
+declare const xuluxPlaygroundPrompt: {
+  name: string;
+  description: string;
+  text: string;
+};
+//#endregion
+export { XULUX_PLAYGROUND_PROMPT, XULUX_PLAYGROUND_PROMPT_DESCRIPTION, XULUX_PLAYGROUND_PROMPT_NAME, xuluxPlaygroundPrompt };
+//# sourceMappingURL=xulux-playground.d.ts.map

package/dist/prompts/xulux-playground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xulux-playground.d.ts","names":[],"sources":["../../src/prompts/xulux-playground.ts"],"mappings":";cAIa;cAEA;cAGA;cAsBA"}

package/dist/prompts/xulux-playground.js

@@ -0,0 +1,33 @@
+//#region src/prompts/xulux-playground.ts
+const XULUX_PLAYGROUND_PROMPT_NAME = "assistant-ui-template-workflow";
+const XULUX_PLAYGROUND_PROMPT_DESCRIPTION = "How to use the assistant-ui template tools to discover hosted templates, inspect their customization contracts, and retrieve preview/download URLs.";
+const XULUX_PLAYGROUND_PROMPT = `You have access to assistant-ui template tools for hosted app templates.
+
+<workflow>
+Follow this template-first workflow for any assistant-ui app-building request:
+
+1. Call **assistantUITemplates** FIRST. Never decide on a template or claim one exists without listing.
+2. Call **assistantUITemplateDetails** on any candidate template before deciding whether it fits.
+   - Review the whole template shape: features, assistantPlacement, configRoots schemas, rules, built-in tools, renderers, and exampleConfig.
+   - If \`customizable\` is empty, the entry is a fixed demo. Use it as-is; never pass a config for it.
+3. Decide one of three paths:
+   - The template fits as-is: call **assistantUITemplatePreview** with templateId and optional versionId.
+   - The template fits with supported customization: author a config using the configRoots schemas and rules from assistantUITemplateDetails, then call **assistantUITemplatePreview** with that config.
+   - No template fits: do NOT call assistantUITemplatePreview. Do not force the request into a template or fake domain content with mock config. Instead, ground yourself in the assistant-ui docs (assistantUIDocs, assistantUISearch, assistantUIExamples) and produce an honest, docs-grounded build guide or prompt for the user.
+</workflow>
+
+<important_constraints>
+- Only use URLs copied exactly from tool results. Never guess, fabricate, or use placeholder URLs.
+- If assistantUITemplatePreview returns validationWarnings or an error, call assistantUITemplateDetails again and correct the config against configRoots. Pass only the documented top-level config roots.
+- Customization is for supported adaptation within a template's shape, not for turning it into a completely different kind of product.
+- Responses may include \`catalogDegraded: true\` when the live template catalog is unreachable. In that mode, template details and preview URLs may be unavailable; tell the user rather than improvising.
+</important_constraints>`;
+const xuluxPlaygroundPrompt = {
+	name: XULUX_PLAYGROUND_PROMPT_NAME,
+	description: XULUX_PLAYGROUND_PROMPT_DESCRIPTION,
+	text: XULUX_PLAYGROUND_PROMPT
+};
+//#endregion
+export { XULUX_PLAYGROUND_PROMPT, XULUX_PLAYGROUND_PROMPT_DESCRIPTION, XULUX_PLAYGROUND_PROMPT_NAME, xuluxPlaygroundPrompt };
+
+//# sourceMappingURL=xulux-playground.js.map

package/dist/prompts/xulux-playground.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xulux-playground.js","names":[],"sources":["../../src/prompts/xulux-playground.ts"],"sourcesContent":["// Skill-style MCP prompt teaching agents the assistant-ui template workflow.\n// Adapted for MCP clients: tools return URLs and data only; there is no\n// browser canvas UI here.\n\nexport const XULUX_PLAYGROUND_PROMPT_NAME = \"assistant-ui-template-workflow\";\n\nexport const XULUX_PLAYGROUND_PROMPT_DESCRIPTION =\n  \"How to use the assistant-ui template tools to discover hosted templates, inspect their customization contracts, and retrieve preview/download URLs.\";\n\nexport const XULUX_PLAYGROUND_PROMPT = `You have access to assistant-ui template tools for hosted app templates.\n\n<workflow>\nFollow this template-first workflow for any assistant-ui app-building request:\n\n1. Call **assistantUITemplates** FIRST. Never decide on a template or claim one exists without listing.\n2. Call **assistantUITemplateDetails** on any candidate template before deciding whether it fits.\n   - Review the whole template shape: features, assistantPlacement, configRoots schemas, rules, built-in tools, renderers, and exampleConfig.\n   - If \\`customizable\\` is empty, the entry is a fixed demo. Use it as-is; never pass a config for it.\n3. Decide one of three paths:\n   - The template fits as-is: call **assistantUITemplatePreview** with templateId and optional versionId.\n   - The template fits with supported customization: author a config using the configRoots schemas and rules from assistantUITemplateDetails, then call **assistantUITemplatePreview** with that config.\n   - No template fits: do NOT call assistantUITemplatePreview. Do not force the request into a template or fake domain content with mock config. Instead, ground yourself in the assistant-ui docs (assistantUIDocs, assistantUISearch, assistantUIExamples) and produce an honest, docs-grounded build guide or prompt for the user.\n</workflow>\n\n<important_constraints>\n- Only use URLs copied exactly from tool results. Never guess, fabricate, or use placeholder URLs.\n- If assistantUITemplatePreview returns validationWarnings or an error, call assistantUITemplateDetails again and correct the config against configRoots. Pass only the documented top-level config roots.\n- Customization is for supported adaptation within a template's shape, not for turning it into a completely different kind of product.\n- Responses may include \\`catalogDegraded: true\\` when the live template catalog is unreachable. In that mode, template details and preview URLs may be unavailable; tell the user rather than improvising.\n</important_constraints>`;\n\nexport const xuluxPlaygroundPrompt = {\n  name: XULUX_PLAYGROUND_PROMPT_NAME,\n  description: XULUX_PLAYGROUND_PROMPT_DESCRIPTION,\n  text: XULUX_PLAYGROUND_PROMPT,\n};\n"],"mappings":";AAIA,MAAa,+BAA+B;AAE5C,MAAa,sCACX;AAEF,MAAa,0BAA0B;;;;;;;;;;;;;;;;;;;;;AAsBvC,MAAa,wBAAwB;CACnC,MAAM;CACN,aAAa;CACb,MAAM;AACR"}