@sentientui/mcp 0.18.1 → 0.18.3

package/dist/{chunk-HEMPCGWX.js → chunk-FPHH4LA7.js}

@@ -1804,10 +1804,11 @@ time.
 1. Run \`npx @sentientui/cli init\` (detects Next App/Pages, Vite, Remix, CRA; installs
    @sentientui/react; writes .env.local; scaffolds an example). It does NOT edit your layout \u2014
    it prints the wrap snippet for step 2.
-2. Wrap the root layout with <AdaptiveRoot apiKey context> (from '@sentientui/react/next';
-   other React apps use <AdaptiveProvider> from '@sentientui/react') and add
-   suppressHydrationWarning to <html> \u2014 an inline script sets persona attributes pre-paint.
-   Nothing adapts and nothing is tracked until this wrap is in place.
+2. Wrap the root layout with <AdaptiveRoot apiKey>{children}</AdaptiveRoot> (from
+   '@sentientui/react/next'; other React apps use <AdaptiveProvider> from '@sentientui/react')
+   and add suppressHydrationWarning to <html> \u2014 an inline script sets persona attributes
+   pre-paint. Nothing adapts and nothing is tracked until this wrap is in place. Declare no
+   components here: every <Adaptive> registers itself when it renders (see Rung 2).
 3. \`npm run dev\`, then open the app with \`?sentient_persona=a\` vs
    \`?sentient_persona=b\` to see it adapt \u2014 in keyless local mode any key drives the built-in
    heuristic. No API key needed. Against a real project the key must be one you declared.
@@ -1844,9 +1845,17 @@ original:
 
 Mount + deploy registers the region. SentientUI writes versions per visitor type in the
 dashboard ("Who sees what") \u2014 no redeploy. The children render for holdout traffic, unknown
-visitor types, types with no version yet, and every error path. No server preload: mounted
-regions are requested in one batched call. First visit shows the original briefly, then swaps;
-return visits start from the last version. Keyless local mode renders originals only. Pass
+visitor types, types with no version yet, and every error path. Mounted regions are requested
+in one batched call after mount: the first visit shows the original briefly, then swaps; return
+visits start from the last version. Keyless local mode renders originals only.
+
+Optional server preload (Next.js App Router): registrySlotIds={['hero-cta']} for generated
+regions, components={[{ id, variantIds }]} for code variants, both on AdaptiveRoot \u2014 the first
+paint then shows the served version. List ONLY ids rendered on every page that AdaptiveRoot
+wraps (in app/layout.tsx, every route): a declared id is decided on every request, rendered or
+not, and those visits count as views that can never convert.
+
+Pass
 onFormSubmit to allow form versions; set reportBaselineText={false} on regions wrapping
 personalized or account content. (Formerly <AdaptiveSlot>.)
 
@@ -2106,18 +2115,23 @@ function registerCellTools(server, client) {
         personas: z15.array(personaOutput),
         cells: z15.array(cellOutput),
         autoFill: z15.boolean(),
-        personaSource: z15.string().describe("Active persona-set source: default | declared | discovered"),
+        // Nullable: a project with no persona set at all reports null, not a
+        // string. That is the NORMAL state since the default vocabulary was
+        // emptied, so a non-nullable schema failed output validation on most
+        // projects and the tool returned nothing but a zod error.
+        personaSource: z15.string().nullable().describe('Active persona-set source: default | declared | discovered, or null when the project has no persona set (one "everyone" row)'),
         undecidedShare: z15.number()
       },
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
     withApiErrorGuidance(async ({ projectId }) => {
+      var _a;
       const id = encodeURIComponent(projectId);
       const data = await client.get(`/projects/${id}/cells`);
       const byCell = new Map(data.cells.map((c) => [`${c.slotId}::${c.persona}`, c]));
       const lines = [
         `Slots: ${data.slots.map((s) => `${untrusted(s.displayName)}${s.live === false ? " [draft]" : ""}`).join(", ") || "(none published)"}`,
-        `Auto-fill on first miss: ${data.autoFill ? "ON" : "off"} \xB7 persona source: ${data.personaSource}`
+        `Auto-fill on first miss: ${data.autoFill ? "ON" : "off"} \xB7 persona source: ${(_a = data.personaSource) != null ? _a : 'none (one "everyone" row)'}`
       ];
       for (const p of data.personas) {
         const states = data.slots.map((s) => {
@@ -2232,7 +2246,7 @@ function registerCellTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.18.1" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.18.3" : "0.0.0-dev";
 function createMcpServer(client) {
   const server = new McpServer(
     {

package/dist/index.cjs

@@ -1810,10 +1810,11 @@ time.
 1. Run \`npx @sentientui/cli init\` (detects Next App/Pages, Vite, Remix, CRA; installs
    @sentientui/react; writes .env.local; scaffolds an example). It does NOT edit your layout \u2014
    it prints the wrap snippet for step 2.
-2. Wrap the root layout with <AdaptiveRoot apiKey context> (from '@sentientui/react/next';
-   other React apps use <AdaptiveProvider> from '@sentientui/react') and add
-   suppressHydrationWarning to <html> \u2014 an inline script sets persona attributes pre-paint.
-   Nothing adapts and nothing is tracked until this wrap is in place.
+2. Wrap the root layout with <AdaptiveRoot apiKey>{children}</AdaptiveRoot> (from
+   '@sentientui/react/next'; other React apps use <AdaptiveProvider> from '@sentientui/react')
+   and add suppressHydrationWarning to <html> \u2014 an inline script sets persona attributes
+   pre-paint. Nothing adapts and nothing is tracked until this wrap is in place. Declare no
+   components here: every <Adaptive> registers itself when it renders (see Rung 2).
 3. \`npm run dev\`, then open the app with \`?sentient_persona=a\` vs
    \`?sentient_persona=b\` to see it adapt \u2014 in keyless local mode any key drives the built-in
    heuristic. No API key needed. Against a real project the key must be one you declared.
@@ -1850,9 +1851,17 @@ original:
 
 Mount + deploy registers the region. SentientUI writes versions per visitor type in the
 dashboard ("Who sees what") \u2014 no redeploy. The children render for holdout traffic, unknown
-visitor types, types with no version yet, and every error path. No server preload: mounted
-regions are requested in one batched call. First visit shows the original briefly, then swaps;
-return visits start from the last version. Keyless local mode renders originals only. Pass
+visitor types, types with no version yet, and every error path. Mounted regions are requested
+in one batched call after mount: the first visit shows the original briefly, then swaps; return
+visits start from the last version. Keyless local mode renders originals only.
+
+Optional server preload (Next.js App Router): registrySlotIds={['hero-cta']} for generated
+regions, components={[{ id, variantIds }]} for code variants, both on AdaptiveRoot \u2014 the first
+paint then shows the served version. List ONLY ids rendered on every page that AdaptiveRoot
+wraps (in app/layout.tsx, every route): a declared id is decided on every request, rendered or
+not, and those visits count as views that can never convert.
+
+Pass
 onFormSubmit to allow form versions; set reportBaselineText={false} on regions wrapping
 personalized or account content. (Formerly <AdaptiveSlot>.)
 
@@ -2112,18 +2121,23 @@ function registerCellTools(server, client) {
         personas: import_zod15.z.array(personaOutput),
         cells: import_zod15.z.array(cellOutput),
         autoFill: import_zod15.z.boolean(),
-        personaSource: import_zod15.z.string().describe("Active persona-set source: default | declared | discovered"),
+        // Nullable: a project with no persona set at all reports null, not a
+        // string. That is the NORMAL state since the default vocabulary was
+        // emptied, so a non-nullable schema failed output validation on most
+        // projects and the tool returned nothing but a zod error.
+        personaSource: import_zod15.z.string().nullable().describe('Active persona-set source: default | declared | discovered, or null when the project has no persona set (one "everyone" row)'),
         undecidedShare: import_zod15.z.number()
       },
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
     withApiErrorGuidance(async ({ projectId }) => {
+      var _a2;
       const id = encodeURIComponent(projectId);
       const data = await client.get(`/projects/${id}/cells`);
       const byCell = new Map(data.cells.map((c) => [`${c.slotId}::${c.persona}`, c]));
       const lines = [
         `Slots: ${data.slots.map((s) => `${untrusted(s.displayName)}${s.live === false ? " [draft]" : ""}`).join(", ") || "(none published)"}`,
-        `Auto-fill on first miss: ${data.autoFill ? "ON" : "off"} \xB7 persona source: ${data.personaSource}`
+        `Auto-fill on first miss: ${data.autoFill ? "ON" : "off"} \xB7 persona source: ${(_a2 = data.personaSource) != null ? _a2 : 'none (one "everyone" row)'}`
       ];
       for (const p of data.personas) {
         const states = data.slots.map((s) => {
@@ -2238,7 +2252,7 @@ function registerCellTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.18.1" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.18.3" : "0.0.0-dev";
 function createMcpServer(client) {
   const server = new import_mcp.McpServer(
     {

package/dist/index.js

@@ -2,7 +2,7 @@
 import {
   ApiClient,
   createMcpServer
-} from "./chunk-HEMPCGWX.js";
+} from "./chunk-FPHH4LA7.js";
 
 // src/index.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/lib.cjs

@@ -1834,10 +1834,11 @@ time.
 1. Run \`npx @sentientui/cli init\` (detects Next App/Pages, Vite, Remix, CRA; installs
    @sentientui/react; writes .env.local; scaffolds an example). It does NOT edit your layout \u2014
    it prints the wrap snippet for step 2.
-2. Wrap the root layout with <AdaptiveRoot apiKey context> (from '@sentientui/react/next';
-   other React apps use <AdaptiveProvider> from '@sentientui/react') and add
-   suppressHydrationWarning to <html> \u2014 an inline script sets persona attributes pre-paint.
-   Nothing adapts and nothing is tracked until this wrap is in place.
+2. Wrap the root layout with <AdaptiveRoot apiKey>{children}</AdaptiveRoot> (from
+   '@sentientui/react/next'; other React apps use <AdaptiveProvider> from '@sentientui/react')
+   and add suppressHydrationWarning to <html> \u2014 an inline script sets persona attributes
+   pre-paint. Nothing adapts and nothing is tracked until this wrap is in place. Declare no
+   components here: every <Adaptive> registers itself when it renders (see Rung 2).
 3. \`npm run dev\`, then open the app with \`?sentient_persona=a\` vs
    \`?sentient_persona=b\` to see it adapt \u2014 in keyless local mode any key drives the built-in
    heuristic. No API key needed. Against a real project the key must be one you declared.
@@ -1874,9 +1875,17 @@ original:
 
 Mount + deploy registers the region. SentientUI writes versions per visitor type in the
 dashboard ("Who sees what") \u2014 no redeploy. The children render for holdout traffic, unknown
-visitor types, types with no version yet, and every error path. No server preload: mounted
-regions are requested in one batched call. First visit shows the original briefly, then swaps;
-return visits start from the last version. Keyless local mode renders originals only. Pass
+visitor types, types with no version yet, and every error path. Mounted regions are requested
+in one batched call after mount: the first visit shows the original briefly, then swaps; return
+visits start from the last version. Keyless local mode renders originals only.
+
+Optional server preload (Next.js App Router): registrySlotIds={['hero-cta']} for generated
+regions, components={[{ id, variantIds }]} for code variants, both on AdaptiveRoot \u2014 the first
+paint then shows the served version. List ONLY ids rendered on every page that AdaptiveRoot
+wraps (in app/layout.tsx, every route): a declared id is decided on every request, rendered or
+not, and those visits count as views that can never convert.
+
+Pass
 onFormSubmit to allow form versions; set reportBaselineText={false} on regions wrapping
 personalized or account content. (Formerly <AdaptiveSlot>.)
 
@@ -2136,18 +2145,23 @@ function registerCellTools(server, client) {
         personas: import_zod15.z.array(personaOutput),
         cells: import_zod15.z.array(cellOutput),
         autoFill: import_zod15.z.boolean(),
-        personaSource: import_zod15.z.string().describe("Active persona-set source: default | declared | discovered"),
+        // Nullable: a project with no persona set at all reports null, not a
+        // string. That is the NORMAL state since the default vocabulary was
+        // emptied, so a non-nullable schema failed output validation on most
+        // projects and the tool returned nothing but a zod error.
+        personaSource: import_zod15.z.string().nullable().describe('Active persona-set source: default | declared | discovered, or null when the project has no persona set (one "everyone" row)'),
         undecidedShare: import_zod15.z.number()
       },
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
     withApiErrorGuidance(async ({ projectId }) => {
+      var _a;
       const id = encodeURIComponent(projectId);
       const data = await client.get(`/projects/${id}/cells`);
       const byCell = new Map(data.cells.map((c) => [`${c.slotId}::${c.persona}`, c]));
       const lines = [
         `Slots: ${data.slots.map((s) => `${untrusted(s.displayName)}${s.live === false ? " [draft]" : ""}`).join(", ") || "(none published)"}`,
-        `Auto-fill on first miss: ${data.autoFill ? "ON" : "off"} \xB7 persona source: ${data.personaSource}`
+        `Auto-fill on first miss: ${data.autoFill ? "ON" : "off"} \xB7 persona source: ${(_a = data.personaSource) != null ? _a : 'none (one "everyone" row)'}`
       ];
       for (const p of data.personas) {
         const states = data.slots.map((s) => {
@@ -2262,7 +2276,7 @@ function registerCellTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.18.1" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.18.3" : "0.0.0-dev";
 function createMcpServer(client) {
   const server = new import_mcp.McpServer(
     {

package/dist/lib.js

@@ -4,7 +4,7 @@ import {
   ApiError,
   PUBLIC_UI_RESOURCE_URIS,
   createMcpServer
-} from "./chunk-HEMPCGWX.js";
+} from "./chunk-FPHH4LA7.js";
 export {
   ApiClient,
   ApiError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentientui/mcp",
-  "version": "0.18.1",
+  "version": "0.18.3",
   "description": "MCP server for SentientUI — exposes project data and actions to AI agents",
   "license": "MIT",
   "homepage": "https://sentient-ui.com",