@nanisoft/prism-mcp-server 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NaniSoft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/factory.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The pure, transport-agnostic factory (ADR-0004): tool logic written once
+ * here, served by any transport. The site Worker wires it through
+ * `createMcpHandler(factory)`; a stdio-only client bridges with
+ * `npx mcp-remote` — there is deliberately no second implementation.
+ *
+ * The factory runs per request on the Worker lane, so the lookup maps are
+ * built inside it (never at isolate scope — ticket 05's startup-limit rule).
+ */
+import { McpServer } from '@modelcontextprotocol/server';
+import { type PrismDocsStore } from './store.js';
+export interface PrismMcpServerOptions {
+    /**
+     * The corpus build date (`YYYY-MM-DD`) for the `list_items` header.
+     *
+     * `PrismDocsStore` carries no build date (ADR-0004 §5 fixes the interface and
+     * prism-llms emits exactly those fields), so the bundler supplies this when
+     * it knows one; when absent the header simply states version + counts rather
+     * than inventing a date. If prism-llms grows a `built` field, render it from
+     * the store and retire this option.
+     */
+    readonly built?: string;
+}
+/**
+ * Build an `McpServer` with the eight Prism tools over `docs`. Pure: reads
+ * `docs`, touches no I/O, registers no transport. The store guard runs here at
+ * the door as well — callers that bypass their own validation get a precise
+ * `TypeError` naming the field, not a deep tool failure.
+ */
+export declare function createPrismMcpServer(docs: PrismDocsStore, options?: PrismMcpServerOptions): McpServer;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAIzD,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAGtE,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,GAAE,qBAA0B,GAAG,SAAS,CAWzG"}

package/dist/factory.js

@@ -0,0 +1,33 @@
+/**
+ * The pure, transport-agnostic factory (ADR-0004): tool logic written once
+ * here, served by any transport. The site Worker wires it through
+ * `createMcpHandler(factory)`; a stdio-only client bridges with
+ * `npx mcp-remote` — there is deliberately no second implementation.
+ *
+ * The factory runs per request on the Worker lane, so the lookup maps are
+ * built inside it (never at isolate scope — ticket 05's startup-limit rule).
+ */
+import { McpServer } from '@modelcontextprotocol/server';
+import { createItemLookup, createPageLookup, createThemeLookup } from './lookup.js';
+import { registerPrismTools } from './tools.js';
+import { parsePrismDocsStore } from './store.js';
+import { SERVER_NAME, SERVER_VERSION } from './version.js';
+/**
+ * Build an `McpServer` with the eight Prism tools over `docs`. Pure: reads
+ * `docs`, touches no I/O, registers no transport. The store guard runs here at
+ * the door as well — callers that bypass their own validation get a precise
+ * `TypeError` naming the field, not a deep tool failure.
+ */
+export function createPrismMcpServer(docs, options = {}) {
+    const store = parsePrismDocsStore(docs);
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION });
+    registerPrismTools(server, {
+        docs: store,
+        items: createItemLookup(store.items),
+        pages: createPageLookup(store.pages, store.baseUrl),
+        themes: createThemeLookup(store.themes),
+        built: options.built,
+    });
+    return server;
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAuB,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAe3D;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAoB,EAAE,OAAO,GAA0B,EAAE;IAC5F,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IAC7E,kBAAkB,CAAC,MAAM,EAAE;QACzB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC;QACpC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;QACnD,MAAM,EAAE,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC;QACvC,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `@nanisoft/prism-mcp-server` — the Prism MCP tool surface (ADR-0004).
+ *
+ * Transport-free: this package exports the pure `createPrismMcpServer(docs)`
+ * factory plus the `PrismDocsStore` corpus contract it reads (this package is
+ * that interface's canonical home — the consumer). It imports nothing from any
+ * other workspace package at runtime; apps/site bundles the factory together
+ * with `@nanisoft/prism-llms`' `data.json` at build time.
+ */
+export { createPrismMcpServer, type PrismMcpServerOptions } from './factory.js';
+export { parsePrismDocsStore } from './store.js';
+export type { PrismDocsStore, PrismDocsItem, PrismDocsPage, PrismDocsTheme } from './store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * `@nanisoft/prism-mcp-server` — the Prism MCP tool surface (ADR-0004).
+ *
+ * Transport-free: this package exports the pure `createPrismMcpServer(docs)`
+ * factory plus the `PrismDocsStore` corpus contract it reads (this package is
+ * that interface's canonical home — the consumer). It imports nothing from any
+ * other workspace package at runtime; apps/site bundles the factory together
+ * with `@nanisoft/prism-llms`' `data.json` at build time.
+ */
+export { createPrismMcpServer } from './factory.js';
+export { parsePrismDocsStore } from './store.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,oBAAoB,EAA8B,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/lookup.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Case-insensitive resolution over the bundled corpus, with did-you-mean
+ * suggestions on a miss (ADR-0004 §2: lookups are case-insensitive and a miss
+ * returns the closest matches plus a browse pointer — never a throw).
+ *
+ * Maps are built once per `createPrismMcpServer()` call — per request on the
+ * Worker lane, never at isolate scope (ticket 05's startup-limit rule).
+ */
+import type { PrismDocsItem, PrismDocsPage, PrismDocsTheme } from './store.js';
+/** One catalog item kind — the `kind` parameter shared by the item tools. */
+export type ItemKind = PrismDocsItem['kind'];
+/** Order the catalog tools group and count kinds in. */
+export declare const ITEM_KINDS: readonly ItemKind[];
+/** The theme atom a bare `get_theme_doc()` answers with. */
+export declare const DEFAULT_PACK = "blue";
+export declare const DEFAULT_MODE = "light";
+/** Smallest-edit-distance suggestions, closest and shortest first. */
+export declare function didYouMean(query: string, candidates: readonly string[], limit?: number): string[];
+/** What resolving an item name produced. */
+export type ItemMatch = {
+    readonly status: 'ok';
+    readonly item: PrismDocsItem;
+} | {
+    readonly status: 'kind-mismatch';
+    readonly item: PrismDocsItem;
+} | {
+    readonly status: 'miss';
+    readonly suggestions: readonly string[];
+};
+export interface ItemLookup {
+    /** Every item name, in corpus order — the suggestion pool and catalog input. */
+    readonly names: readonly string[];
+    find(name: string, kind?: ItemKind): ItemMatch;
+    suggest(name: string): readonly string[];
+}
+export declare function createItemLookup(items: readonly PrismDocsItem[]): ItemLookup;
+export interface PageLookup {
+    /** Every page url, in corpus order. */
+    readonly urls: readonly string[];
+    find(url: string): PrismDocsPage | undefined;
+    suggest(url: string): readonly string[];
+}
+/**
+ * Site-pathname lookup (`/docs/theming`), tolerant of case, trailing slashes,
+ * and absolute site URLs (`https://prism.nanisoft.com/docs/theming`).
+ */
+export declare function createPageLookup(pages: readonly PrismDocsPage[], baseUrl: string): PageLookup;
+export interface ThemeLookup {
+    /** Every theme-atom slug, in corpus order. */
+    readonly slugs: readonly string[];
+    find(pack: string, mode: string): PrismDocsTheme | undefined;
+    suggest(slug: string): readonly string[];
+}
+/** Theme atoms are slugged `<pack>-<mode>` (prism-llms emits four). */
+export declare const themeSlug: (pack: string, mode: string) => string;
+export declare function createThemeLookup(themes: readonly PrismDocsTheme[]): ThemeLookup;
+/** Resolve which example's source `get_item_source` should return. */
+export type ExampleMatch = {
+    readonly status: 'ok';
+    readonly example: NonNullable<PrismDocsItem['examples']>[number];
+} | {
+    readonly status: 'none';
+} | {
+    readonly status: 'miss';
+    readonly suggestions: readonly string[];
+};
+export declare function resolveExample(item: PrismDocsItem, slug?: string): ExampleMatch;
+//# sourceMappingURL=lookup.d.ts.map

package/dist/lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../src/lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/E,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAE7C,wDAAwD;AACxD,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAAmC,CAAC;AAE9E,4DAA4D;AAC5D,eAAO,MAAM,YAAY,SAAS,CAAC;AACnC,eAAO,MAAM,YAAY,UAAU,CAAC;AAKpC,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CAa5F;AAoBD,4CAA4C;AAC5C,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GAClE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAEzE,MAAM,WAAW,UAAU;IACzB,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,UAAU,CAe5E;AAED,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAC7C,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAgB7F;AAED,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAC7D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,uEAAuE;AACvE,eAAO,MAAM,SAAS,SAAU,MAAM,QAAQ,MAAM,KAAG,MAA2B,CAAC;AAEnF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,WAAW,CAQhF;AAED,sEAAsE;AACtE,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;CAAE,GAC3F;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAEzE,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAS/E"}

package/dist/lookup.js

@@ -0,0 +1,113 @@
+/**
+ * Case-insensitive resolution over the bundled corpus, with did-you-mean
+ * suggestions on a miss (ADR-0004 §2: lookups are case-insensitive and a miss
+ * returns the closest matches plus a browse pointer — never a throw).
+ *
+ * Maps are built once per `createPrismMcpServer()` call — per request on the
+ * Worker lane, never at isolate scope (ticket 05's startup-limit rule).
+ */
+/** Order the catalog tools group and count kinds in. */
+export const ITEM_KINDS = ['component', 'block', 'page'];
+/** The theme atom a bare `get_theme_doc()` answers with. */
+export const DEFAULT_PACK = 'blue';
+export const DEFAULT_MODE = 'light';
+/** Lower-cased, trimmed lookup key. */
+const fold = (value) => value.trim().toLowerCase();
+/** Smallest-edit-distance suggestions, closest and shortest first. */
+export function didYouMean(query, candidates, limit = 3) {
+    const target = fold(query);
+    return candidates
+        .map((candidate) => {
+        const folded = fold(candidate);
+        // A substring hit is a better lead than its raw edit distance suggests.
+        const distance = folded.includes(target) ? Math.min(levenshtein(target, folded), 1) : levenshtein(target, folded);
+        return { candidate, distance };
+    })
+        .filter((entry) => entry.distance <= 3)
+        .sort((a, b) => a.distance - b.distance || a.candidate.length - b.candidate.length)
+        .slice(0, limit)
+        .map((entry) => entry.candidate);
+}
+/** Classic two-row Levenshtein distance, case-folded by the caller. */
+function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    let previous = Array.from({ length: b.length + 1 }, (_, index) => index);
+    for (let i = 1; i <= a.length; i += 1) {
+        const current = [i];
+        for (let j = 1; j <= b.length; j += 1) {
+            const substitution = (previous[j - 1] ?? 0) + (a[i - 1] === b[j - 1] ? 0 : 1);
+            current.push(Math.min((previous[j] ?? 0) + 1, (current[j - 1] ?? 0) + 1, substitution));
+        }
+        previous = current;
+    }
+    return previous[b.length] ?? a.length + b.length;
+}
+export function createItemLookup(items) {
+    const byKey = new Map(items.map((item) => [fold(item.name), item]));
+    const names = items.map((item) => item.name);
+    return {
+        names,
+        find(name, kind) {
+            const item = byKey.get(fold(name));
+            if (!item)
+                return { status: 'miss', suggestions: didYouMean(name, names) };
+            // `kind` is a disambiguator, not a filter: a wrong one is a miss the
+            // agent must hear about, not a silent hit for the wrong entity.
+            if (kind && item.kind !== kind)
+                return { status: 'kind-mismatch', item };
+            return { status: 'ok', item };
+        },
+        suggest: (name) => didYouMean(name, names),
+    };
+}
+/**
+ * Site-pathname lookup (`/docs/theming`), tolerant of case, trailing slashes,
+ * and absolute site URLs (`https://prism.nanisoft.com/docs/theming`).
+ */
+export function createPageLookup(pages, baseUrl) {
+    const origin = baseUrl.replace(/\/+$/, '');
+    const keyOf = (url) => {
+        let path = url.trim();
+        if (path.toLowerCase().startsWith(origin.toLowerCase()))
+            path = path.slice(origin.length) || '/';
+        if (path.length > 1)
+            path = path.replace(/\/+$/, '');
+        return fold(path);
+    };
+    const byKey = new Map(pages.map((page) => [keyOf(page.url), page]));
+    const urls = pages.map((page) => page.url);
+    return {
+        urls,
+        find: (url) => byKey.get(keyOf(url)),
+        suggest: (url) => didYouMean(keyOf(url), urls),
+    };
+}
+/** Theme atoms are slugged `<pack>-<mode>` (prism-llms emits four). */
+export const themeSlug = (pack, mode) => `${pack}-${mode}`;
+export function createThemeLookup(themes) {
+    const byKey = new Map(themes.map((theme) => [fold(theme.slug), theme]));
+    const slugs = themes.map((theme) => theme.slug);
+    return {
+        slugs,
+        find: (pack, mode) => byKey.get(fold(themeSlug(pack, mode))),
+        suggest: (slug) => didYouMean(slug, slugs),
+    };
+}
+export function resolveExample(item, slug) {
+    const examples = item.examples ?? [];
+    if (examples.length === 0)
+        return { status: 'none' };
+    if (slug === undefined)
+        return { status: 'ok', example: examples[0] };
+    const byKey = new Map(examples.map((example) => [fold(example.slug), example]));
+    const example = byKey.get(fold(slug));
+    if (example)
+        return { status: 'ok', example };
+    return { status: 'miss', suggestions: didYouMean(slug, examples.map((entry) => entry.slug)) };
+}
+//# sourceMappingURL=lookup.js.map

package/dist/lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.js","sourceRoot":"","sources":["../src/lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,wDAAwD;AACxD,MAAM,CAAC,MAAM,UAAU,GAAwB,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAE9E,4DAA4D;AAC5D,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AACnC,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC;AAEpC,uCAAuC;AACvC,MAAM,IAAI,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAEnE,sEAAsE;AACtE,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,UAA6B,EAAE,KAAK,GAAG,CAAC;IAChF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,OAAO,UAAU;SACd,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,wEAAwE;QACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACjC,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;SACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;SAClF,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AACrC,CAAC;AAED,uEAAuE;AACvE,SAAS,WAAW,CAAC,CAAS,EAAE,CAAS;IACvC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IAEpC,IAAI,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IACzE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,YAAY,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9E,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;QAC1F,CAAC;QACD,QAAQ,GAAG,OAAO,CAAC;IACrB,CAAC;IACD,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;AACnD,CAAC;AAeD,MAAM,UAAU,gBAAgB,CAAC,KAA+B;IAC9D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAU,CAAC,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO;QACL,KAAK;QACL,IAAI,CAAC,IAAI,EAAE,IAAI;YACb,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACnC,IAAI,CAAC,IAAI;gBAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YAC3E,qEAAqE;YACrE,gEAAgE;YAChE,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;gBAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;YACzE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAChC,CAAC;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC;KAC3C,CAAC;AACJ,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA+B,EAAE,OAAe;IAC/E,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,CAAC,GAAW,EAAU,EAAE;QACpC,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;QACjG,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAU,CAAC,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;KAC/C,CAAC;AACJ,CAAC;AASD,uEAAuE;AACvE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,IAAY,EAAU,EAAE,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;AAEnF,MAAM,UAAU,iBAAiB,CAAC,MAAiC;IACjE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAU,CAAC,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO;QACL,KAAK;QACL,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5D,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC;KAC3C,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,cAAc,CAAC,IAAmB,EAAE,IAAa;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IACrC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACrD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAE,EAAE,CAAC;IAEvE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAU,CAAC,CAAC,CAAC;IACzF,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,IAAI,OAAO;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;AAChG,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The markdown every tool answers with — the corpus is Markdown, so JSON
+ * envelopes would only add tokens and quoting (ADR-0004 §2). All of these are
+ * pure string builders over already-resolved data; lookup/search logic lives
+ * elsewhere. Result text always prints the next call to make (§7).
+ */
+import type { PrismDocsItem, PrismDocsPage, PrismDocsStore, PrismDocsTheme } from './store.js';
+import { type ItemKind } from './lookup.js';
+import type { SearchHit } from './search.js';
+/** The one import rule every description and every miss carries. */
+export declare const IMPORT_RULE = "Always import from '@nanisoft/prism-ui', never from antd directly.";
+/**
+ * `list_items` — the cold-start catalog. The header line carries the corpus
+ * version (mismatch detection) and, when the bundler supplies one, the build
+ * date; pass-throughs are marked with their antd base so the delegation seam
+ * is visible before any per-item call.
+ */
+export declare function catalogMarkdown(docs: PrismDocsStore, kind?: ItemKind, built?: string): string;
+/**
+ * `get_item_doc` — the generator's page verbatim (usage rules, props, example,
+ * the `> Extends:` seam), plus at most one steering footer built from the data.
+ */
+export declare function itemDocMarkdown(item: PrismDocsItem): string;
+/**
+ * `get_item_props` — only the Prism-added delta. A pass-through's answer *is*
+ * the routing instruction (ADR-0004 §4: plasma's `_No additional props…_` line
+ * is the switch-servers signal).
+ */
+export declare function itemPropsMarkdown(item: PrismDocsItem): string;
+/** `get_item_source` — the documented example, verbatim, in one fenced block. */
+export declare function itemSourceMarkdown(item: PrismDocsItem, example: {
+    readonly slug: string;
+    readonly title?: string;
+    readonly code: string;
+}): string;
+/** `get_theme_doc` — the pack × mode atom verbatim, plus the sibling slugs. */
+export declare function themeMarkdown(theme: PrismDocsTheme, all: readonly PrismDocsTheme[]): string;
+/** `list_pages` — the site's llms.txt body as an index. */
+export declare function pagesIndexMarkdown(pages: readonly PrismDocsPage[], baseUrl: string): string;
+/** `get_page` — the prerendered page verbatim, cited back to the site. */
+export declare function pageMarkdown(page: PrismDocsPage, baseUrl: string): string;
+/** `search_docs` — ranked hits, each printing its own next call. */
+export declare function searchResultsMarkdown(query: string, hits: readonly SearchHit[]): string;
+/** A lookup miss: the closest names plus the browse pointer, as an error. */
+export declare function missMarkdown(target: string, suggestions: readonly string[], browseHint: string): string;
+/** A name hit whose `kind` argument pointed somewhere else. */
+export declare function kindMismatchMarkdown(item: PrismDocsItem, requested: ItemKind): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,oEAAoE;AACpE,eAAO,MAAM,WAAW,uEAAuE,CAAC;AAOhG;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAqB7F;AAOD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAM3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAoB7D;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAelJ;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAI3F;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAc3F;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAavF;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAKvG;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,GAAG,MAAM,CAErF"}

package/dist/render.js

@@ -0,0 +1,156 @@
+/**
+ * The markdown every tool answers with — the corpus is Markdown, so JSON
+ * envelopes would only add tokens and quoting (ADR-0004 §2). All of these are
+ * pure string builders over already-resolved data; lookup/search logic lives
+ * elsewhere. Result text always prints the next call to make (§7).
+ */
+import { ITEM_KINDS } from './lookup.js';
+/** The one import rule every description and every miss carries. */
+export const IMPORT_RULE = "Always import from '@nanisoft/prism-ui', never from antd directly.";
+const KIND_LABEL = { component: 'component', block: 'block', page: 'page' };
+const KIND_HEADING = { component: 'Components', block: 'Blocks', page: 'Pages' };
+const plural = (count, noun) => (count === 1 ? `1 ${noun}` : `${count} ${noun}s`);
+/**
+ * `list_items` — the cold-start catalog. The header line carries the corpus
+ * version (mismatch detection) and, when the bundler supplies one, the build
+ * date; pass-throughs are marked with their antd base so the delegation seam
+ * is visible before any per-item call.
+ */
+export function catalogMarkdown(docs, kind, built) {
+    const counts = new Map(ITEM_KINDS.map((entry) => [entry, docs.items.filter((item) => item.kind === entry).length]));
+    const summary = ITEM_KINDS.map((entry) => plural(counts.get(entry) ?? 0, KIND_LABEL[entry])).join(', ');
+    const lines = [`Prism ${docs.prismVersion} — ${summary}${built ? ` (built ${built})` : ''}`, ''];
+    if (kind)
+        lines.push(`Filtered to ${KIND_LABEL[kind]}s — omit \`kind\` for the whole catalog.`, '');
+    for (const entry of ITEM_KINDS) {
+        if (kind && entry !== kind)
+            continue;
+        const inKind = docs.items.filter((item) => item.kind === entry);
+        lines.push(`## ${KIND_HEADING[entry]}`, '');
+        if (inKind.length === 0) {
+            lines.push(`No ${KIND_LABEL[entry]}s in this build.`, '');
+            continue;
+        }
+        for (const item of inKind)
+            lines.push(catalogEntry(item));
+        lines.push('');
+    }
+    lines.push('---', '', `Next: \`get_item_doc\` for an item's full doc, \`get_item_props\` for its Prism-added props, \`search_docs\` to search everything. Items marked _(extends antd …)_ are pass-throughs — their inherited antd props live in the antd MCP. ${IMPORT_RULE}`);
+    return lines.join('\n');
+}
+function catalogEntry(item) {
+    const base = item.antdBase ? ` _(extends antd ${item.antdBase})_` : '';
+    return `- **${item.name}** — ${item.description}${base}`;
+}
+/**
+ * `get_item_doc` — the generator's page verbatim (usage rules, props, example,
+ * the `> Extends:` seam), plus at most one steering footer built from the data.
+ */
+export function itemDocMarkdown(item) {
+    const pointers = [];
+    if (item.props)
+        pointers.push(`Prism-added props only: \`get_item_props { "name": "${item.name}" }\``);
+    if ((item.examples?.length ?? 0) > 0)
+        pointers.push(`Copyable example source: \`get_item_source { "name": "${item.name}" }\``);
+    if (item.antdBase)
+        pointers.push(`Inherited antd props and demos: antd MCP \`antd_info ${item.antdBase}\``);
+    return pointers.length > 0 ? `${item.doc}\n\n---\n\n${pointers.join(' · ')}` : item.doc;
+}
+/**
+ * `get_item_props` — only the Prism-added delta. A pass-through's answer *is*
+ * the routing instruction (ADR-0004 §4: plasma's `_No additional props…_` line
+ * is the switch-servers signal).
+ */
+export function itemPropsMarkdown(item) {
+    if (item.props) {
+        return item.antdBase
+            ? `${item.props}\n\n---\n\nBeyond these Prism-added props, the inherited antd surface lives in the antd MCP (\`antd_info ${item.antdBase}\`). ${IMPORT_RULE}`
+            : item.props;
+    }
+    if (item.antdBase) {
+        return [
+            `## ${item.name} — props`,
+            '',
+            `${item.name} — antd ${item.antdBase}, unchanged. Props: use the antd MCP (\`antd_info ${item.antdBase}\`). ${IMPORT_RULE}`,
+            '',
+            '_No additional props beyond the antd base component._',
+        ].join('\n');
+    }
+    return [
+        `## ${item.name} — props`,
+        '',
+        `\`${item.name}\` documents no Prism-added props in this build. Its usage rules and example live in the full doc: \`get_item_doc { "name": "${item.name}" }\`.`,
+    ].join('\n');
+}
+/** `get_item_source` — the documented example, verbatim, in one fenced block. */
+export function itemSourceMarkdown(item, example) {
+    const labelled = example.title ? `${example.title} (\`${example.slug}\`)` : `\`${example.slug}\``;
+    const others = (item.examples ?? []).filter((entry) => entry.slug !== example.slug).map((entry) => `\`${entry.slug}\``);
+    const lines = [
+        `# ${item.name} — example source: ${labelled}`,
+        '',
+        '```tsx',
+        example.code,
+        '```',
+        '',
+        `Verbatim from the docs demo — self-contained (imports only \`@nanisoft/prism-ui\` and \`react\`). ${IMPORT_RULE}`,
+    ];
+    if (others.length > 0)
+        lines.push('', `Other examples: ${others.join(', ')} — pass \`example\` to pick one.`);
+    return lines.join('\n');
+}
+/** `get_theme_doc` — the pack × mode atom verbatim, plus the sibling slugs. */
+export function themeMarkdown(theme, all) {
+    const others = all.filter((entry) => entry.slug !== theme.slug).map((entry) => `\`${entry.slug}\``);
+    const footer = others.length > 0 ? `\n\n---\n\nOther theme atoms: ${others.join(', ')} — pass \`pack\`/\`mode\` to switch.` : '';
+    return `${theme.markdown}${footer}`;
+}
+/** `list_pages` — the site's llms.txt body as an index. */
+export function pagesIndexMarkdown(pages, baseUrl) {
+    const lines = ['# Prism docs pages', ''];
+    if (pages.length === 0) {
+        lines.push('This build carries no docs pages — the catalog is the whole corpus for now.');
+    }
+    else {
+        lines.push(`Found ${pages.length}:`, '');
+        for (const page of pages) {
+            lines.push(`- **${page.title}** — \`${page.url}\`${page.description ? ` — ${page.description}` : ''}`);
+            lines.push(`  → \`get_page { "url": "${page.url}" }\``);
+        }
+        lines.push('');
+    }
+    lines.push('---', '', `Full site index: ${baseUrl}/llms.txt · Catalog: \`list_items\`.`);
+    return lines.join('\n');
+}
+/** `get_page` — the prerendered page verbatim, cited back to the site. */
+export function pageMarkdown(page, baseUrl) {
+    return `${page.markdown}\n\n---\n\nSource: ${baseUrl}${page.url} · More: \`list_pages\`.`;
+}
+/** `search_docs` — ranked hits, each printing its own next call. */
+export function searchResultsMarkdown(query, hits) {
+    const lines = [`# Search results for "${query}"`, ''];
+    if (hits.length === 0) {
+        lines.push('No matches.', '', 'Try broader terms — or browse: `list_items` for the catalog, `list_pages` for docs pages.');
+        return lines.join('\n');
+    }
+    lines.push(`Found ${hits.length} result(s):`, '');
+    hits.forEach((hit, index) => {
+        if (index > 0)
+            lines.push('---', '');
+        lines.push(`## ${hit.title} (${hit.kind})`, hit.snippet, `→ \`${hit.followUp}\`${hit.followUp.startsWith('get_item_source') ? ' for the copyable source.' : ''}`);
+    });
+    return lines.join('\n');
+}
+/** A lookup miss: the closest names plus the browse pointer, as an error. */
+export function missMarkdown(target, suggestions, browseHint) {
+    const lines = [`\`${target}\` not found.`];
+    if (suggestions.length > 0)
+        lines.push('', `Did you mean: ${suggestions.map((name) => `**${name}**`).join(', ')}?`);
+    lines.push('', browseHint);
+    return lines.join('\n');
+}
+/** A name hit whose `kind` argument pointed somewhere else. */
+export function kindMismatchMarkdown(item, requested) {
+    return `\`${item.name}\` is a ${item.kind}, not a ${requested}. Retry with \`kind\` omitted — or with \`"${item.kind}"\`.`;
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/search.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `search_docs` — dependency-free term-frequency ranking over the bundled
+ * corpus (ADR-0004 §1: plasma's recipe; the corpus is small enough that no
+ * search index earns its bundle size). One entry point over items and docs
+ * pages; the component/block/page/doc distinction is a `kind` filter.
+ */
+import type { PrismDocsItem, PrismDocsStore } from './store.js';
+import type { ItemKind } from './lookup.js';
+/** `SearchKind`'s `'doc'` means a docs page, not a `page`-kind catalog item. */
+export type SearchKind = ItemKind | 'doc';
+export interface SearchHit {
+    /** The item name or the page title, as the result heading shows it. */
+    readonly title: string;
+    /** `component | block | page` for catalog items, `doc` for docs pages. */
+    readonly kind: SearchKind;
+    /** The one-liner the hit is sold with — the same text llms.txt bullets use. */
+    readonly snippet: string;
+    /** The exact follow-up call the result prints for the agent to make. */
+    readonly followUp: string;
+}
+export interface SearchQuery {
+    readonly query: string;
+    readonly kind?: SearchKind;
+    readonly limit?: number;
+}
+/** Default cap — ADR-0004 §7: "search caps at 5 hits with snippets". */
+export declare const DEFAULT_SEARCH_LIMIT = 5;
+export declare const MAX_SEARCH_LIMIT = 10;
+export declare function searchCorpus(docs: PrismDocsStore, { query, kind, limit }: SearchQuery): SearchHit[];
+/** The next call a search hit (or doc footer) prints, steered by the data. */
+export declare function followUpForItem(item: PrismDocsItem): string;
+/** Lower-case word tokens; empty for a whitespace-only query. */
+export declare function tokenize(query: string): string[];
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,gFAAgF;AAChF,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE1C,MAAM,WAAW,SAAS;IACxB,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAKD,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAA4B,EAAE,EAAE,WAAW,GAAG,SAAS,EAAE,CA8C1H;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAI3D;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhD"}

package/dist/search.js

@@ -0,0 +1,68 @@
+/**
+ * `search_docs` — dependency-free term-frequency ranking over the bundled
+ * corpus (ADR-0004 §1: plasma's recipe; the corpus is small enough that no
+ * search index earns its bundle size). One entry point over items and docs
+ * pages; the component/block/page/doc distinction is a `kind` filter.
+ */
+/** Field weights: a name hit outranks a description hit outranks a body hit. */
+const WEIGHTS = { name: 8, summary: 3, body: 1 };
+/** Default cap — ADR-0004 §7: "search caps at 5 hits with snippets". */
+export const DEFAULT_SEARCH_LIMIT = 5;
+export const MAX_SEARCH_LIMIT = 10;
+export function searchCorpus(docs, { query, kind, limit = DEFAULT_SEARCH_LIMIT }) {
+    const terms = tokenize(query);
+    const capped = Math.min(Math.max(limit, 1), MAX_SEARCH_LIMIT);
+    const scoreItem = (item) => terms.reduce((total, term) => total +
+        WEIGHTS.name * countOccurrences(item.name.toLowerCase(), term) +
+        WEIGHTS.summary * countOccurrences(item.description.toLowerCase(), term) +
+        WEIGHTS.body * countOccurrences(item.doc.toLowerCase(), term), 0);
+    const scorePage = (page) => terms.reduce((total, term) => total +
+        WEIGHTS.name * countOccurrences(page.title.toLowerCase(), term) +
+        WEIGHTS.summary * countOccurrences((page.description ?? '').toLowerCase(), term) +
+        WEIGHTS.body * countOccurrences(page.markdown.toLowerCase(), term), 0);
+    const wantItems = kind === undefined || kind !== 'doc';
+    const wantPages = kind === undefined || kind === 'doc';
+    const candidates = [];
+    if (wantItems) {
+        for (const item of docs.items) {
+            if (kind !== undefined && item.kind !== kind)
+                continue;
+            const score = scoreItem(item);
+            if (score > 0)
+                candidates.push({ score, title: item.name, kind: item.kind, snippet: item.description, followUp: followUpForItem(item) });
+        }
+    }
+    if (wantPages) {
+        for (const page of docs.pages) {
+            const score = scorePage(page);
+            if (score > 0)
+                candidates.push({ score, title: page.title, kind: 'doc', snippet: page.description ?? page.title, followUp: `get_page { "url": "${page.url}" }` });
+        }
+    }
+    return candidates
+        .sort((a, b) => b.score - a.score || a.title.localeCompare(b.title))
+        .slice(0, capped)
+        .map(({ score: _score, ...hit }) => hit);
+}
+/** The next call a search hit (or doc footer) prints, steered by the data. */
+export function followUpForItem(item) {
+    if ((item.examples?.length ?? 0) > 0)
+        return `get_item_source { "name": "${item.name}" }`;
+    if (item.antdBase)
+        return `antd_info ${item.antdBase} (antd MCP)`;
+    return `get_item_doc { "name": "${item.name}" }`;
+}
+/** Lower-case word tokens; empty for a whitespace-only query. */
+export function tokenize(query) {
+    return query.toLowerCase().split(/[^a-z0-9]+/).filter((term) => term.length > 0);
+}
+function countOccurrences(haystack, needle) {
+    let count = 0;
+    let from = haystack.indexOf(needle);
+    while (from !== -1) {
+        count += 1;
+        from = haystack.indexOf(needle, from + needle.length);
+    }
+    return count;
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The corpus contract (ADR-0004 §5): the single backing store every MCP tool
+ * reads. `@nanisoft/prism-llms` emits its projection into this shape at build
+ * time (`dist/data.json`) and validates against it type-only; this package is
+ * the canonical home because it is the consumer — the tools make exactly one
+ * assumption about the corpus, and it is this interface.
+ */
+/** One catalog item — a component, block, or page from prism-ui. */
+export interface PrismDocsItem {
+    /** The prism-ui export name, e.g. `Button`, `PageHeader`, `DocsShell`. */
+    readonly name: string;
+    readonly kind: 'component' | 'block' | 'page';
+    /** The one-liner that becomes the llms.txt bullet and the search hit. */
+    readonly description: string;
+    /** Full per-item Markdown: usage rules, Prism props, example. */
+    readonly doc: string;
+    /** The extracted Prism-added props section — absent for pass-throughs. */
+    readonly props?: string;
+    /** Documented examples; `code` is the verbatim `demos/<slug>.tsx` source. */
+    readonly examples?: ReadonlyArray<{
+        readonly slug: string;
+        readonly title?: string;
+        readonly code: string;
+    }>;
+    /**
+     * The antd surface this item passes through unchanged (`Button`), absent for
+     * wrappers and prism-original items — a wrapper's base rides its doc's
+     * `> Extends:` note.
+     */
+    readonly antdBase?: string;
+}
+/** One docs page (guides only — blog is lane-only, excluded from the store). */
+export interface PrismDocsPage {
+    /** Site pathname, e.g. `/docs/theming`. */
+    readonly url: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly markdown: string;
+}
+/** One theme atom per pack × mode (`blue-light`, …), as Markdown. */
+export interface PrismDocsTheme {
+    readonly slug: string;
+    readonly markdown: string;
+}
+export interface PrismDocsStore {
+    /** The resolved prism-ui version — echoed by `list_items` for mismatch detection. */
+    readonly prismVersion: string;
+    /** `https://prism.nanisoft.com`, interpolated at build. */
+    readonly baseUrl: string;
+    readonly items: ReadonlyArray<PrismDocsItem>;
+    readonly pages: ReadonlyArray<PrismDocsPage>;
+    readonly themes: ReadonlyArray<PrismDocsTheme>;
+}
+/**
+ * Validate an unknown value (typically the parsed `dist/data.json`) against
+ * the store contract and return it typed. A JSON import type-widens `kind` to
+ * `string`, so only a runtime guard validates the literals — prism-llms'
+ * check gate runs this over its emit, and the server factory runs it over its
+ * bundled corpus at the door.
+ */
+export declare function parsePrismDocsStore(value: unknown): PrismDocsStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9C,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;QAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,qFAAqF;IACrF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CAChD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAiElE"}

package/dist/store.js

@@ -0,0 +1,80 @@
+/**
+ * The corpus contract (ADR-0004 §5): the single backing store every MCP tool
+ * reads. `@nanisoft/prism-llms` emits its projection into this shape at build
+ * time (`dist/data.json`) and validates against it type-only; this package is
+ * the canonical home because it is the consumer — the tools make exactly one
+ * assumption about the corpus, and it is this interface.
+ */
+/**
+ * Validate an unknown value (typically the parsed `dist/data.json`) against
+ * the store contract and return it typed. A JSON import type-widens `kind` to
+ * `string`, so only a runtime guard validates the literals — prism-llms'
+ * check gate runs this over its emit, and the server factory runs it over its
+ * bundled corpus at the door.
+ */
+export function parsePrismDocsStore(value) {
+    const fail = (path, expected) => {
+        throw new TypeError(`PrismDocsStore: ${path} must be ${expected}`);
+    };
+    const str = (path, v) => (typeof v === 'string' ? v : fail(path, 'a string'));
+    const arr = (path, v) => (Array.isArray(v) ? v : fail(path, 'an array'));
+    if (typeof value !== 'object' || value === null)
+        fail('store', 'an object');
+    const store = value;
+    const items = arr('items', store.items).map((entry, index) => {
+        if (typeof entry !== 'object' || entry === null)
+            fail(`items[${index}]`, 'an object');
+        const item = entry;
+        const rawKind = str(`items[${index}].kind`, item.kind);
+        const kind = rawKind === 'component' || rawKind === 'block' || rawKind === 'page' ? rawKind : fail(`items[${index}].kind`, "one of 'component' | 'block' | 'page'");
+        const examples = item.examples === undefined
+            ? undefined
+            : arr(`items[${index}].examples`, item.examples).map((example, exampleIndex) => {
+                if (typeof example !== 'object' || example === null)
+                    fail(`items[${index}].examples[${exampleIndex}]`, 'an object');
+                const demo = example;
+                return {
+                    slug: str(`items[${index}].examples[${exampleIndex}].slug`, demo.slug),
+                    ...(demo.title !== undefined ? { title: str(`items[${index}].examples[${exampleIndex}].title`, demo.title) } : {}),
+                    code: str(`items[${index}].examples[${exampleIndex}].code`, demo.code),
+                };
+            });
+        return {
+            name: str(`items[${index}].name`, item.name),
+            kind,
+            description: str(`items[${index}].description`, item.description),
+            doc: str(`items[${index}].doc`, item.doc),
+            ...(item.props !== undefined ? { props: str(`items[${index}].props`, item.props) } : {}),
+            ...(examples !== undefined ? { examples } : {}),
+            ...(item.antdBase !== undefined ? { antdBase: str(`items[${index}].antdBase`, item.antdBase) } : {}),
+        };
+    });
+    const pages = arr('pages', store.pages).map((entry, index) => {
+        if (typeof entry !== 'object' || entry === null)
+            fail(`pages[${index}]`, 'an object');
+        const page = entry;
+        return {
+            url: str(`pages[${index}].url`, page.url),
+            title: str(`pages[${index}].title`, page.title),
+            ...(page.description !== undefined ? { description: str(`pages[${index}].description`, page.description) } : {}),
+            markdown: str(`pages[${index}].markdown`, page.markdown),
+        };
+    });
+    const themes = arr('themes', store.themes).map((entry, index) => {
+        if (typeof entry !== 'object' || entry === null)
+            fail(`themes[${index}]`, 'an object');
+        const theme = entry;
+        return {
+            slug: str(`themes[${index}].slug`, theme.slug),
+            markdown: str(`themes[${index}].markdown`, theme.markdown),
+        };
+    });
+    return {
+        prismVersion: str('prismVersion', store.prismVersion),
+        baseUrl: str('baseUrl', store.baseUrl),
+        items,
+        pages,
+        themes,
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The eight read-only tools (ADR-0004 §1/§2) — unprefixed names, markdown in
+ * and out, `isError: true` for lookup misses (never a throw), tools only (no
+ * resources/prompts in v1). Descriptions are the steering surface most clients
+ * show, so each carries the scope, the antd delegation rule, and the import
+ * invariant.
+ */
+import type { McpServer } from '@modelcontextprotocol/server';
+import { type ItemLookup, type PageLookup, type ThemeLookup } from './lookup.js';
+import type { PrismDocsStore } from './store.js';
+/** Everything a handler reads — built fresh per `createPrismMcpServer()` call. */
+export interface PrismToolContext {
+    readonly docs: PrismDocsStore;
+    readonly items: ItemLookup;
+    readonly pages: PageLookup;
+    readonly themes: ThemeLookup;
+    /** Corpus build date (YYYY-MM-DD) for the `list_items` header, when known. */
+    readonly built?: string;
+}
+/** Registers exactly the eight v1 tools; nothing else (no resources/prompts). */
+export declare function registerPrismTools(server: McpServer, ctx: PrismToolContext): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,8BAA8B,CAAC;AAG9E,OAAO,EAML,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAerB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAYjD,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAKD,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAmJjF"}

package/dist/tools.js

@@ -0,0 +1,120 @@
+/**
+ * The eight read-only tools (ADR-0004 §1/§2) — unprefixed names, markdown in
+ * and out, `isError: true` for lookup misses (never a throw), tools only (no
+ * resources/prompts in v1). Descriptions are the steering surface most clients
+ * show, so each carries the scope, the antd delegation rule, and the import
+ * invariant.
+ */
+import { z } from 'zod';
+import { DEFAULT_MODE, DEFAULT_PACK, resolveExample, themeSlug, } from './lookup.js';
+import { catalogMarkdown, itemDocMarkdown, itemPropsMarkdown, itemSourceMarkdown, kindMismatchMarkdown, missMarkdown, pageMarkdown, pagesIndexMarkdown, searchResultsMarkdown, themeMarkdown, IMPORT_RULE, } from './render.js';
+import { searchCorpus } from './search.js';
+/** Prism-owned surface only; the upstream antd surface delegates. */
+const ANTD_RULE = 'Prism answers its own surface only — inherited antd props, demos, and tokens belong to the antd MCP.';
+const Kind = z.enum(['component', 'block', 'page']);
+const SearchKind = z.enum(['component', 'block', 'page', 'doc']);
+const NAME_DESC = "e.g. 'Button', 'PageHeader', 'SettingsPage'";
+const KIND_DESC = 'Disambiguate when the name exists as more than one kind.';
+const CATALOG_HINT = 'Browse the catalog: `list_items`.';
+/** The one response shape: markdown text, with lookup misses flagged as errors. */
+const markdown = (text, isError = false) => ({ content: [{ type: 'text', text }], isError });
+/** Registers exactly the eight v1 tools; nothing else (no resources/prompts). */
+export function registerPrismTools(server, ctx) {
+    server.registerTool('list_items', {
+        description: `Catalog of every Prism item — components, blocks, and pages — with kind, one-liner, and antd base. ` +
+            `Start here to learn Prism's vocabulary; the header carries the Prism version and the corpus build ` +
+            `date, so you can detect a corpus/installed-version mismatch before trusting the answer. ` +
+            `${ANTD_RULE} ${IMPORT_RULE}`,
+        inputSchema: { kind: Kind.optional().describe('Filter to one kind; omit for the whole catalog.') },
+    }, ({ kind }) => markdown(catalogMarkdown(ctx.docs, kind, ctx.built)));
+    server.registerTool('get_item_doc', {
+        description: `Full Prism documentation for one component, block, or page: usage rules (RFC-2119), Prism-added props, ` +
+            `and an example. Covers Prism's own surface only — for inherited antd props on pass-through re-exports ` +
+            `use the antd MCP. ${IMPORT_RULE}`,
+        inputSchema: { name: z.string().describe(NAME_DESC), kind: Kind.optional().describe(KIND_DESC) },
+    }, ({ name, kind }) => {
+        const match = ctx.items.find(name, kind);
+        if (match.status === 'miss')
+            return markdown(missMarkdown(name, match.suggestions, CATALOG_HINT), true);
+        if (match.status === 'kind-mismatch')
+            return markdown(kindMismatchMarkdown(match.item, kind), true);
+        return markdown(itemDocMarkdown(match.item));
+    });
+    server.registerTool('get_item_props', {
+        description: `Prism-added props for one component, block, or page, as Markdown — the API delta Prism adds on top of ` +
+            `antd, not the inherited antd table. A pass-through re-export answers with the antd MCP pointer instead. ${IMPORT_RULE}`,
+        inputSchema: { name: z.string().describe(NAME_DESC), kind: Kind.optional().describe(KIND_DESC) },
+    }, ({ name, kind }) => {
+        const match = ctx.items.find(name, kind);
+        if (match.status === 'miss')
+            return markdown(missMarkdown(name, match.suggestions, CATALOG_HINT), true);
+        if (match.status === 'kind-mismatch')
+            return markdown(kindMismatchMarkdown(match.item, kind), true);
+        return markdown(itemPropsMarkdown(match.item));
+    });
+    server.registerTool('get_item_source', {
+        description: `Documented example source for one item — verbatim, self-contained TSX in one fenced block, ready to paste. ` +
+            `Returns documented usage, never prism-ui implementation files; raw antd demos belong to the antd MCP's ` +
+            `antd_demo. ${IMPORT_RULE}`,
+        inputSchema: {
+            name: z.string().describe(NAME_DESC),
+            example: z.string().optional().describe("Example slug; omit for the item's first example."),
+        },
+    }, ({ name, example }) => {
+        const match = ctx.items.find(name);
+        if (match.status === 'miss')
+            return markdown(missMarkdown(name, match.suggestions, CATALOG_HINT), true);
+        const item = match.item;
+        const resolved = resolveExample(item, example);
+        if (resolved.status === 'none') {
+            return markdown(`\`${item.name}\` documents no examples in this build — its usage rules live in the full doc: \`get_item_doc { "name": "${item.name}" }\`.`, true);
+        }
+        if (resolved.status === 'miss') {
+            return markdown(missMarkdown(`example "${example}" of ${item.name}`, resolved.suggestions, `Available examples of \`${item.name}\` are listed by its doc: \`get_item_doc { "name": "${item.name}" }\`.`), true);
+        }
+        return markdown(itemSourceMarkdown(item, resolved.example));
+    });
+    server.registerTool('get_theme_doc', {
+        description: `Theme and token documentation for one Prism brand pack × mode (blue | green × light | dark), including the ` +
+            `createPrismTheme() snippet. Prism's multi-pack theming is not answerable by antd's antd_token. ` +
+            `${ANTD_RULE} ${IMPORT_RULE}`,
+        inputSchema: {
+            pack: z.enum(['blue', 'green']).optional().describe(`Brand pack (default '${DEFAULT_PACK}').`),
+            mode: z.enum(['light', 'dark']).optional().describe(`Mode (default '${DEFAULT_MODE}').`),
+        },
+    }, ({ pack, mode }) => {
+        const resolvedPack = pack ?? DEFAULT_PACK;
+        const resolvedMode = mode ?? DEFAULT_MODE;
+        const theme = ctx.themes.find(resolvedPack, resolvedMode);
+        if (!theme) {
+            const slug = themeSlug(resolvedPack, resolvedMode);
+            return markdown(missMarkdown(slug, ctx.themes.suggest(slug), `Available theme atoms: ${ctx.themes.slugs.map((entry) => `\`${entry}\``).join(', ')}.`), true);
+        }
+        return markdown(themeMarkdown(theme, ctx.docs.themes));
+    });
+    server.registerTool('list_pages', {
+        description: `Index of the Prism docs pages (guides): title, url, and one-liner — the site's llms.txt body. ` +
+            `For the component/block/page catalog use list_items. ${IMPORT_RULE}`,
+        inputSchema: {},
+    }, () => markdown(pagesIndexMarkdown(ctx.docs.pages, ctx.docs.baseUrl)));
+    server.registerTool('get_page', {
+        description: `One Prism docs page as Markdown, by site pathname (e.g. '/docs/theming') — mirrors fumadocs' get_page ` +
+            `contract exactly. Docs describe Prism behaviour; inherited antd surface stays with the antd MCP. ${IMPORT_RULE}`,
+        inputSchema: { url: z.string().describe("Site pathname, e.g. '/docs/theming'.") },
+    }, ({ url }) => {
+        const page = ctx.pages.find(url);
+        if (!page)
+            return markdown(missMarkdown(url, ctx.pages.suggest(url), 'Index of pages: `list_pages`.'), true);
+        return markdown(pageMarkdown(page, ctx.docs.baseUrl));
+    });
+    server.registerTool('search_docs', {
+        description: `One search entry point over the whole Prism corpus — components, blocks, pages, and docs pages. Ranked ` +
+            `hits with kind, snippet, and the suggested follow-up call. ${ANTD_RULE} ${IMPORT_RULE}`,
+        inputSchema: {
+            query: z.string().describe('Free text — item names, features, guide topics.'),
+            kind: SearchKind.optional().describe("'doc' means a docs page; the other three filter catalog items."),
+            limit: z.number().int().min(1).max(10).optional().describe('Max hits, 1–10 (default 5).'),
+        },
+    }, ({ query, kind, limit }) => markdown(searchResultsMarkdown(query, searchCorpus(ctx.docs, { query, kind, limit }))));
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The MCP server identity (`serverInfo` in the protocol handshake).
+ *
+ * Keep in sync with `package.json` — this is a literal because importing the
+ * package JSON would drag a file outside `rootDir` into the tsc build. This is
+ * *protocol* metadata, not the corpus version: `list_items` echoes the store's
+ * own `prismVersion` so agents can detect a corpus/installed-version mismatch.
+ */
+export declare const SERVER_NAME = "prism-mcp-server";
+export declare const SERVER_VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,qBAAqB,CAAC;AAC9C,eAAO,MAAM,cAAc,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,11 @@
+/**
+ * The MCP server identity (`serverInfo` in the protocol handshake).
+ *
+ * Keep in sync with `package.json` — this is a literal because importing the
+ * package JSON would drag a file outside `rootDir` into the tsc build. This is
+ * *protocol* metadata, not the corpus version: `list_items` echoes the store's
+ * own `prismVersion` so agents can detect a corpus/installed-version mismatch.
+ */
+export const SERVER_NAME = 'prism-mcp-server';
+export const SERVER_VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@nanisoft/prism-mcp-server",
+  "version": "0.2.0",
+  "description": "Tool logic for the Prism MCP server — transport-free, fed by prism-llms output. The HTTP transport lives in the apps/site Worker at /mcp.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@modelcontextprotocol/client": "2.0.0",
+    "publint": "^0.3.24",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/server": "2.0.0",
+    "zod": "^4.6.5"
+  },
+  "author": "NaniSoft",
+  "homepage": "https://prism.nanisoft.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NaniSoft/prism.git",
+    "directory": "packages/mcp-server"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "oxlint .",
+    "test": "vitest run"
+  }
+}