@sentientui/mcp 0.18.2 → 0.18.4

package/dist/{chunk-5TEQLWMW.js → chunk-X3CXBGWM.js}

@@ -1905,6 +1905,31 @@ combined tag contains the site's config, so its hash differs per site; the split
 byte-identical everywhere, so one hash covers it. Existing three-tag and config + loader installs
 keep working.
 
+## Capture AI assistants (server-side, any framework)
+
+AI assistants that fetch pages for their users (ChatGPT-User, Claude-User, Perplexity-User)
+and AI crawlers (GPTBot, ClaudeBot, \u2026) run no JavaScript, so the snippet and the React SDK never
+see them. Only your server does. Without server-side capture the dashboard's agent line reads
+"not measured", not zero. Capture only observes: it never changes what is served.
+
+- Next.js with AdaptiveRoot: already on (captureAgents defaults to true).
+- Edge (Vercel Routing Middleware, Cloudflare Workers, Netlify Edge) \u2014 covers ANY framework on
+  those hosts, static sites included:
+    import { captureAgentRequest } from '@sentientui/core/server';
+    captureAgentRequest(request, { apiKey: 'pk_...', source: 'edge', waitUntil });
+  waitUntil is required on edge runtimes (ctx.waitUntil.bind(ctx) on Workers; waitUntil from
+  '@vercel/functions' on Vercel), or the platform drops the request when the response returns.
+- Node servers (Express, Nuxt/Nitro on Node, any (req, res, next) stack):
+    import { sentientAgentMiddleware } from '@sentientui/core/server';
+    app.use(sentientAgentMiddleware({ apiKey: 'pk_...' }));
+- Hono / Remix / React Router / Astro / SvelteKit: call captureAgentRequest(request, { apiKey })
+  from the request hook.
+
+Only the path is sent (never the query string), with the user agent. The API re-derives the
+agent itself and collapses the same fetch reported twice (e.g. edge + SSR), so running two
+capture paths does not double-count. Hosted builders (Shopify themes, Webflow, Squarespace, Wix)
+give no per-request hook and stay unmeasured.
+
 ## Testing the integration
 
 Use '@sentientui/react/testing': renderWithSentient(ui, { variants, slots, persona }) forces
@@ -2115,18 +2140,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) => {
@@ -2241,7 +2271,7 @@ function registerCellTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.18.2" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.18.4" : "0.0.0-dev";
 function createMcpServer(client) {
   const server = new McpServer(
     {

package/dist/index.cjs

@@ -1911,6 +1911,31 @@ combined tag contains the site's config, so its hash differs per site; the split
 byte-identical everywhere, so one hash covers it. Existing three-tag and config + loader installs
 keep working.
 
+## Capture AI assistants (server-side, any framework)
+
+AI assistants that fetch pages for their users (ChatGPT-User, Claude-User, Perplexity-User)
+and AI crawlers (GPTBot, ClaudeBot, \u2026) run no JavaScript, so the snippet and the React SDK never
+see them. Only your server does. Without server-side capture the dashboard's agent line reads
+"not measured", not zero. Capture only observes: it never changes what is served.
+
+- Next.js with AdaptiveRoot: already on (captureAgents defaults to true).
+- Edge (Vercel Routing Middleware, Cloudflare Workers, Netlify Edge) \u2014 covers ANY framework on
+  those hosts, static sites included:
+    import { captureAgentRequest } from '@sentientui/core/server';
+    captureAgentRequest(request, { apiKey: 'pk_...', source: 'edge', waitUntil });
+  waitUntil is required on edge runtimes (ctx.waitUntil.bind(ctx) on Workers; waitUntil from
+  '@vercel/functions' on Vercel), or the platform drops the request when the response returns.
+- Node servers (Express, Nuxt/Nitro on Node, any (req, res, next) stack):
+    import { sentientAgentMiddleware } from '@sentientui/core/server';
+    app.use(sentientAgentMiddleware({ apiKey: 'pk_...' }));
+- Hono / Remix / React Router / Astro / SvelteKit: call captureAgentRequest(request, { apiKey })
+  from the request hook.
+
+Only the path is sent (never the query string), with the user agent. The API re-derives the
+agent itself and collapses the same fetch reported twice (e.g. edge + SSR), so running two
+capture paths does not double-count. Hosted builders (Shopify themes, Webflow, Squarespace, Wix)
+give no per-request hook and stay unmeasured.
+
 ## Testing the integration
 
 Use '@sentientui/react/testing': renderWithSentient(ui, { variants, slots, persona }) forces
@@ -2121,18 +2146,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) => {
@@ -2247,7 +2277,7 @@ function registerCellTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.18.2" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.18.4" : "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-5TEQLWMW.js";
+} from "./chunk-X3CXBGWM.js";
 
 // src/index.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/lib.cjs

@@ -1935,6 +1935,31 @@ combined tag contains the site's config, so its hash differs per site; the split
 byte-identical everywhere, so one hash covers it. Existing three-tag and config + loader installs
 keep working.
 
+## Capture AI assistants (server-side, any framework)
+
+AI assistants that fetch pages for their users (ChatGPT-User, Claude-User, Perplexity-User)
+and AI crawlers (GPTBot, ClaudeBot, \u2026) run no JavaScript, so the snippet and the React SDK never
+see them. Only your server does. Without server-side capture the dashboard's agent line reads
+"not measured", not zero. Capture only observes: it never changes what is served.
+
+- Next.js with AdaptiveRoot: already on (captureAgents defaults to true).
+- Edge (Vercel Routing Middleware, Cloudflare Workers, Netlify Edge) \u2014 covers ANY framework on
+  those hosts, static sites included:
+    import { captureAgentRequest } from '@sentientui/core/server';
+    captureAgentRequest(request, { apiKey: 'pk_...', source: 'edge', waitUntil });
+  waitUntil is required on edge runtimes (ctx.waitUntil.bind(ctx) on Workers; waitUntil from
+  '@vercel/functions' on Vercel), or the platform drops the request when the response returns.
+- Node servers (Express, Nuxt/Nitro on Node, any (req, res, next) stack):
+    import { sentientAgentMiddleware } from '@sentientui/core/server';
+    app.use(sentientAgentMiddleware({ apiKey: 'pk_...' }));
+- Hono / Remix / React Router / Astro / SvelteKit: call captureAgentRequest(request, { apiKey })
+  from the request hook.
+
+Only the path is sent (never the query string), with the user agent. The API re-derives the
+agent itself and collapses the same fetch reported twice (e.g. edge + SSR), so running two
+capture paths does not double-count. Hosted builders (Shopify themes, Webflow, Squarespace, Wix)
+give no per-request hook and stay unmeasured.
+
 ## Testing the integration
 
 Use '@sentientui/react/testing': renderWithSentient(ui, { variants, slots, persona }) forces
@@ -2145,18 +2170,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) => {
@@ -2271,7 +2301,7 @@ function registerCellTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.18.2" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.18.4" : "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-5TEQLWMW.js";
+} from "./chunk-X3CXBGWM.js";
 export {
   ApiClient,
   ApiError,

package/package.json

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