@sentientui/mcp 0.18.3 → 0.18.4

package/dist/{chunk-FPHH4LA7.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
@@ -2246,7 +2271,7 @@ function registerCellTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.18.3" : "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
@@ -2252,7 +2277,7 @@ function registerCellTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.18.3" : "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-FPHH4LA7.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
@@ -2276,7 +2301,7 @@ function registerCellTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.18.3" : "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-FPHH4LA7.js";
+} from "./chunk-X3CXBGWM.js";
 export {
   ApiClient,
   ApiError,

package/package.json

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