@nanisoft/prism-mcp-server 0.4.1 → 0.4.3

package/LICENSE

@@ -1,21 +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.
+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/README.md

@@ -1,66 +1,66 @@
-# @nanisoft/prism-mcp-server
-
-Prism's read-only MCP tool surface. Eight retrieval tools answer over the
-bundled `PrismDocsStore` corpus from the same Cloudflare Worker that serves the
-site, at `https://prism.nanisoft.com/mcp`.
-
-The package is **transport-free**: `createPrismMcpServer(store, options)` returns
-an `McpServer`, and the Worker connects it to `createMcpHandler` from the Agents
-SDK's MCP server entry. There is one implementation and no stdio binary at
-launch; a stdio-only client bridges with `npx mcp-remote
-https://prism.nanisoft.com/mcp`.
-
-## Commands
-
-```sh
-pnpm --filter @nanisoft/prism-mcp-server build   # stamp the corpus, then tsc into dist/
-pnpm --filter @nanisoft/prism-mcp-server test    # the Vitest floor (in-memory round-trips)
-```
-
-`pretest` compiles the package first. The suite reaches the corpus through
-`@nanisoft/prism-llms`'s emitted `data.json`.
-
-## The eight tools
-
-Every tool is self-contained, idempotent, stateless and returns Markdown. A
-lookup miss is an `isError` result with did-you-mean suggestions and a browse
-pointer, never a throw. Every description carries the import rule and the
-surface rule.
-
-| Tool | Arguments | Purpose |
-| --- | --- | --- |
-| `list_items` | `{ kind?, category? }` | The kind-grouped catalogue index; `category` is Component-only. |
-| `get_item_doc` | `{ name, kind? }` | The assembled per-item Markdown plus its footer. |
-| `get_item_props` | `{ name, kind? }` | The `## Props` section, or `## Composition` for a Block or Page. |
-| `get_item_source` | `{ name, kind? }` | The public import line plus the verbatim demo. |
-| `get_theme_doc` | `{ pack?, mode?, group? }` | A pack's resolved values, or one bound scale. |
-| `list_pages` | `{}` | The Overview, Foundation, Content and Changelogs page index. |
-| `get_page` | `{ url }` | One non-item page as Markdown; a catalogue URL points at `get_item_doc`. |
-| `search_docs` | `{ query, kind?, limit? }` | Substring search over names, descriptions and page bodies. |
-
-`kind` is the closed union `component | block | page`; `get_theme_doc`'s `group`
-is `semantic | motion | typography | spacing | shadow | breakpoint | container`.
-
-## The store
-
-`createPrismMcpServer` runs `parsePrismDocsStore` from `@nanisoft/prism-llms` at
-its door, so a raw `data.json` is validated once and every transport inherits the
-same rejection. The Worker bundles `@nanisoft/prism-llms/data.json` as an ESM
-module; there is no `fs`, `fetch`, KV, cache or runtime lookup at isolate scope.
-
-## The build stamp
-
-`scripts/stamp-built.mjs` writes the gitignored `src/generated/built.ts` before
-the build. The stamp is derived from the corpus source commit date plus the
-corpus version, so the same commit rebuilds to the same value. When git or the
-corpus is unavailable it is `undefined`, and `list_items` omits the
-`(built ...)` clause rather than fabricating a date. The stamp lives in this lane,
-never in the corpus `dist`, so corpus build-twice determinism is untouched.
-
-## Auth
-
-Public read-only in version one: the corpus is public and the tools are pure
-reads over an immutable blob. The Cloudflare Access escalation is pre-written in
-`apps/site/worker/access.ts` and inert until enabled. It flips when a tool gains
-anything non-public: org-internal examples, write-back, telemetry or a per-user
-quota.
+# @nanisoft/prism-mcp-server
+
+Prism's read-only MCP tool surface. Eight retrieval tools answer over the
+bundled `PrismDocsStore` corpus from the same Cloudflare Worker that serves the
+site, at `https://prism.nanisoft.com/mcp`.
+
+The package is **transport-free**: `createPrismMcpServer(store, options)` returns
+an `McpServer`, and the Worker connects it to `createMcpHandler` from the Agents
+SDK's MCP server entry. There is one implementation and no stdio binary at
+launch; a stdio-only client bridges with `npx mcp-remote
+https://prism.nanisoft.com/mcp`.
+
+## Commands
+
+```sh
+pnpm --filter @nanisoft/prism-mcp-server build   # stamp the corpus, then tsc into dist/
+pnpm --filter @nanisoft/prism-mcp-server test    # the Vitest floor (in-memory round-trips)
+```
+
+`pretest` compiles the package first. The suite reaches the corpus through
+`@nanisoft/prism-llms`'s emitted `data.json`.
+
+## The eight tools
+
+Every tool is self-contained, idempotent, stateless and returns Markdown. A
+lookup miss is an `isError` result with did-you-mean suggestions and a browse
+pointer, never a throw. Every description carries the import rule and the
+surface rule.
+
+| Tool | Arguments | Purpose |
+| --- | --- | --- |
+| `list_items` | `{ kind?, category? }` | The kind-grouped catalogue index; `category` is Component-only. |
+| `get_item_doc` | `{ name, kind? }` | The assembled per-item Markdown plus its footer. |
+| `get_item_props` | `{ name, kind? }` | The `## Props` section, or `## Composition` for a Block or Page. |
+| `get_item_source` | `{ name, kind? }` | The public import line plus the verbatim demo. |
+| `get_theme_doc` | `{ pack?, mode?, group? }` | A pack's resolved values, or one bound scale. |
+| `list_pages` | `{}` | The Overview, Foundation, Content and Changelogs page index. |
+| `get_page` | `{ url }` | One non-item page as Markdown; a catalogue URL points at `get_item_doc`. |
+| `search_docs` | `{ query, kind?, limit? }` | Substring search over names, descriptions and page bodies. |
+
+`kind` is the closed union `component | block | page`; `get_theme_doc`'s `group`
+is `semantic | motion | typography | spacing | shadow | breakpoint | container`.
+
+## The store
+
+`createPrismMcpServer` runs `parsePrismDocsStore` from `@nanisoft/prism-llms` at
+its door, so a raw `data.json` is validated once and every transport inherits the
+same rejection. The Worker bundles `@nanisoft/prism-llms/data.json` as an ESM
+module; there is no `fs`, `fetch`, KV, cache or runtime lookup at isolate scope.
+
+## The build stamp
+
+`scripts/stamp-built.mjs` writes the gitignored `src/generated/built.ts` before
+the build. The stamp is derived from the corpus source commit date plus the
+corpus version, so the same commit rebuilds to the same value. When git or the
+corpus is unavailable it is `undefined`, and `list_items` omits the
+`(built ...)` clause rather than fabricating a date. The stamp lives in this lane,
+never in the corpus `dist`, so corpus build-twice determinism is untouched.
+
+## Auth
+
+Public read-only in version one: the corpus is public and the tools are pure
+reads over an immutable blob. The Cloudflare Access escalation is pre-written in
+`apps/site/worker/access.ts` and inert until enabled. It flips when a tool gains
+anything non-public: org-internal examples, write-back, telemetry or a per-user
+quota.

package/THIRD-PARTY-NOTICES.md

@@ -32,13 +32,28 @@ compiled output is part of the component package's precompiled `styles.css`.
 
 ## Fonts
 
-The documentation site self-hosts Inter under `apps/site/src/fonts/`, loaded
-through `next/font/local`. The shipped files are `InterVariable.woff2` and
-`InterVariable-Italic.woff2` from the official Inter release 4.1, and the site
-is the only consumer. Inter is licensed under the **SIL Open Font License,
-Version 1.1**; the license text is committed at
-`apps/site/src/fonts/LICENSE.txt`. Inter is copyright The Inter Project Authors
-(rsms.me/inter).
+`@nanisoft/prism-ui` redistributes Inter, because its stylesheet ships the
+`@font-face` rules that back the `--font-sans` token. The binaries are the four
+static Latin subsets in `dist/fonts`: `inter-latin-400.woff2`,
+`inter-latin-500.woff2`, `inter-latin-600.woff2` and
+`inter-latin-400-italic.woff2`, together with the licence text as
+`dist/fonts/Inter-OFL.txt`. Nothing else in these packages ships a font, and no
+downstream site loads its own copy: `next/font` and every other font loader are
+absent from the site as well as from the packages, because a site that loads its
+own face stops rendering the face the library ships.
+
+The four files are the Latin subset of the official Inter release 4.001 (see the
+`name` table's unique identifier, `4.001;RSMS;...`). The three upright files are
+the static instances that release publishes; the italic is the same release's
+variable italic, instanced at weight 400 and subset to the same 230 codepoints
+as its upright siblings, so the four files cover one character set.
+
+Inter is licensed under the **SIL Open Font License, Version 1.1**; the license
+text is committed at `packages/ui/public/fonts/Inter-OFL.txt` and ships beside
+the binaries. Inter is copyright The Inter Project Authors (rsms.me/inter). The
+Open Font License permits redistribution inside a package of this kind, and
+requires the license to travel with the files, which is why it is in `dist/fonts`
+rather than only in this notice.
 
 ## Build and development toolchain
 

package/dist/generated/built.js

@@ -2,5 +2,5 @@
 // Derived from the corpus source commit date plus the corpus version. The
 // fallback is undefined (git or the corpus unavailable), which makes
 // list_items omit the (built ...) clause rather than fabricate a date.
-export const BUILT = "2026-09-28";
-export const BUILT_CORPUS = "0.7.0";
+export const BUILT = "2026-11-07";
+export const BUILT_CORPUS = "1.5.0";

package/dist/generated/server-version.js

@@ -2,4 +2,4 @@
 // Derived from this package's own package.json, which is the single place a
 // release writes a version. There is no fallback value: an unreadable manifest
 // throws in the step above rather than stamping a version this package is not.
-export const SERVER_VERSION = "0.4.1";
+export const SERVER_VERSION = "0.4.3";

package/dist/render.js

@@ -12,15 +12,47 @@ const error = (value) => ({
 function fence(code, language = 'tsx') {
     return `\`\`\`${language}\n${code.replace(/\r\n/g, '\n').replace(/\n$/, '')}\n\`\`\``;
 }
+/**
+ * The name an agent is given for a Kind.
+ *
+ * A lookup rather than a chain of `if`s ending in a default, and the parameter is
+ * an `ItemKind` rather than a `string`. The previous version took a string and
+ * returned `'Page'` for anything it did not recognise, which is the worst possible
+ * shape for this function: a Kind added to the store and the catalogue would be
+ * announced to every agent reading the corpus as a Page, and nothing would fail.
+ * An agent that is told a live surface is a page will look for navigation, props
+ * and a documentation file, and will be wrong about all three.
+ *
+ * Narrowing the parameter is what makes the map total. A Kind added to `ItemKind`
+ * makes this function a compile error rather than a silent mislabel, and that is
+ * the entire reason the signature is `ItemKind` and not `string`.
+ */
+const KIND_LABELS = {
+    component: 'Component',
+    block: 'Block',
+    page: 'Page',
+    /**
+     * `Live` is the Kind's discriminator and `Live surface` is what an agent is
+     * told, and the two differ deliberately. The other three are nouns that are also
+     * their own label, so there was nothing to decide; `live` is an adjective, and an
+     * agent handed the bare word `Live` is handed an adjective to reason about. A noun
+     * phrase tells it what it is looking at.
+     *
+     * That also forced the one sentence this label appears in to stop being phrased
+     * around a noun, because "the surface of this Live" reads as an error and "of this
+     * Live surface" reads as a stutter. The sentence is now "A <label> is made of the
+     * exports below", which is true of all four and awkward about none of them.
+     */
+    live: 'Live surface',
+};
 function kindLabel(kind) {
-    if (kind === 'component')
-        return 'Component';
-    if (kind === 'block')
-        return 'Block';
-    return 'Page';
+    return KIND_LABELS[kind];
 }
 function countKinds(items) {
-    const counts = { component: 0, block: 0, page: 0 };
+    // Built from the label table rather than written out, for the same reason: a Kind
+    // added to `ItemKind` would not be a missing key here, it would be a compile
+    // error, which is the outcome worth having.
+    const counts = Object.fromEntries(Object.keys(KIND_LABELS).map((kind) => [kind, 0]));
     for (const item of items)
         counts[item.kind] += 1;
     return counts;
@@ -158,7 +190,7 @@ export function renderItemProps(store, args) {
         return text(`# ${item.name} - props\n\n${item.props}\n\nThis is the complete public Prism API for \`${item.name}\`; internal primitive props are not a consumer contract.\n\nImport rule: ${IMPORT_RULE}`);
     }
     if (item.composition) {
-        return text(`# ${item.name} - composition\n\nThe public surface of this ${kindLabel(item.kind)} is the composition below.\n\n${item.composition}\n\nImport rule: ${IMPORT_RULE}`);
+        return text(`# ${item.name} - composition\n\nA ${kindLabel(item.kind)} is made of the exports below.\n\n${item.composition}\n\nImport rule: ${IMPORT_RULE}`);
     }
     return error(`No props or composition are recorded for \`${item.name}\`. Use \`get_item_doc\` for its documentation.`);
 }

package/dist/schemas.d.ts

@@ -12,6 +12,7 @@ export declare const listItemsSchema: z.ZodObject<{
         component: "component";
         block: "block";
         page: "page";
+        live: "live";
     }>>;
     category: z.ZodOptional<z.ZodEnum<{
         "Call to action": "Call to action";
@@ -29,6 +30,7 @@ export declare const getItemDocSchema: z.ZodObject<{
         component: "component";
         block: "block";
         page: "page";
+        live: "live";
     }>>;
 }, z.core.$strip>;
 export declare const getItemPropsSchema: z.ZodObject<{
@@ -37,6 +39,7 @@ export declare const getItemPropsSchema: z.ZodObject<{
         component: "component";
         block: "block";
         page: "page";
+        live: "live";
     }>>;
 }, z.core.$strip>;
 export declare const getItemSourceSchema: z.ZodObject<{
@@ -45,6 +48,7 @@ export declare const getItemSourceSchema: z.ZodObject<{
         component: "component";
         block: "block";
         page: "page";
+        live: "live";
     }>>;
 }, z.core.$strip>;
 export declare const getThemeDocSchema: z.ZodObject<{
@@ -55,6 +59,8 @@ export declare const getThemeDocSchema: z.ZodObject<{
         lavender: "lavender";
         sky: "sky";
         peach: "peach";
+        cyan: "cyan";
+        gold: "gold";
     }>>;
     mode: z.ZodOptional<z.ZodEnum<{
         light: "light";
@@ -80,6 +86,7 @@ export declare const searchDocsSchema: z.ZodObject<{
         component: "component";
         block: "block";
         page: "page";
+        live: "live";
         doc: "doc";
     }>>;
     limit: z.ZodOptional<z.ZodNumber>;

package/dist/vocab.d.ts

@@ -1,10 +1,10 @@
-export declare const ITEM_KINDS: readonly ["component", "block", "page"];
+export declare const ITEM_KINDS: readonly ["component", "block", "page", "live"];
 export declare const COMPONENT_CATEGORIES: readonly ["Call to action", "Forms and inputs", "Feedback", "Layout", "Data display", "Typography", "Miscellaneous"];
-export declare const PACKS: readonly ["default", "blush", "mint", "lavender", "sky", "peach"];
+export declare const PACKS: readonly ["default", "blush", "mint", "lavender", "sky", "peach", "cyan", "gold"];
 export declare const MODES: readonly ["light", "dark"];
 export declare const SCALE_GROUPS: readonly ["motion", "typography", "spacing", "shadow", "breakpoint", "container"];
 /** `'doc'` means a non-item page: a guide, a Foundation or a Content page. */
-export declare const SEARCH_KINDS: readonly ["component", "block", "page", "doc"];
+export declare const SEARCH_KINDS: readonly ["component", "block", "page", "live", "doc"];
 /** The `get_theme_doc` group: the pack-by-mode semantic set or one bound scale. */
 export declare const TOKEN_GROUPS: readonly ["semantic", "motion", "typography", "spacing", "shadow", "breakpoint", "container"];
 export type ItemKind = (typeof ITEM_KINDS)[number];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanisoft/prism-mcp-server",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "type": "module",
   "description": "Prism's read-only MCP tool surface: eight retrieval tools over the bundled PrismDocsStore corpus. Transport-free: one factory serves the site Worker at /mcp.",
   "license": "MIT",
@@ -32,7 +32,7 @@
   "dependencies": {
     "@modelcontextprotocol/server": "2.0.0",
     "zod": "^4.2.0",
-    "@nanisoft/prism-llms": "0.5.1"
+    "@nanisoft/prism-llms": "0.6.0"
   },
   "devDependencies": {
     "@modelcontextprotocol/client": "2.0.0",