@sentientui/mcp 0.17.2 → 0.17.4

package/dist/{chunk-PHUP47GG.js → chunk-CEZJQSKB.js}

@@ -348,8 +348,8 @@ function rangeInputSchema(defaultRange) {
 }
 function rangeQuery(args) {
   const p = new URLSearchParams();
-  if (args.from) {
-    p.set("from", args.from);
+  if (args.from || args.to) {
+    if (args.from) p.set("from", args.from);
     if (args.to) p.set("to", args.to);
   } else if (args.range) {
     p.set("range", args.range);
@@ -369,10 +369,27 @@ var windowOutputSchema = z.object({
 function windowLine(window) {
   if (!window) return "";
   if (window.start && window.end) {
-    return `Window: ${window.start.slice(0, 10)} to ${window.end.slice(0, 10)} (${window.timezone}, exclusive end)`;
+    const from = localDate(window.start, window.timezone);
+    const lastIncluded = localDate(
+      new Date(new Date(window.end).getTime() - 1).toISOString(),
+      window.timezone
+    );
+    return `Window: ${from} through ${lastIncluded} inclusive (${window.timezone})`;
   }
   return `Window: all retained data (${window.retentionDays}-day retention)`;
 }
+function localDate(iso, timeZone) {
+  try {
+    return new Intl.DateTimeFormat("en-CA", {
+      timeZone,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit"
+    }).format(new Date(iso));
+  } catch (e) {
+    return iso.slice(0, 10);
+  }
+}
 function apiErrorGuidance(err, extra) {
   if (extra && Object.prototype.hasOwnProperty.call(extra, err.message)) {
     return extra[err.message];
@@ -393,6 +410,12 @@ function apiErrorGuidance(err, extra) {
   if (err.message === "invalid_range") {
     return "Invalid time window. Use range '7d', '30d', '90d' or 'all', or from/to as YYYY-MM-DD dates.";
   }
+  if (err.message === "plan_required" || err.message === "plan_upgrade_required") {
+    return "This feature is not included on the project\u2019s current plan. Upgrade the SentientUI plan to turn it on \u2014 re-authenticating will not help.";
+  }
+  if (err.message === "agent_analytics_requires_paid_plan") {
+    return "Agent analytics is available on paid plans only. Upgrade the SentientUI plan to read agent traffic for this project.";
+  }
   if (err.status === 402) {
     return `This feature requires a higher plan (${err.message}). Upgrade your SentientUI plan, then try again.`;
   }
@@ -681,6 +704,8 @@ var EMPTY_REASON_TEXT = {
   // The stale/never-ran texts name the remedy: an agent that is not told about
   // refresh_insights has no way to know it can fix this itself.
   job_never_ran: "The analysis job has not run yet. Call refresh_insights to run it now.",
+  // No refresh_insights hint here: on a free plan that call just 403s.
+  plan_locked: "AI analysis requires a Starter plan or higher. The measured findings are complete; only the written analysis is plan-gated.",
   job_stale: "These numbers are out of date \u2014 the analysis job has not run recently. Call refresh_insights to regenerate them.",
   data_unavailable: "The project data could not be read just now \u2014 nothing is wrong with the setup. Retry shortly."
 };
@@ -1009,6 +1034,13 @@ function registerGoalTools(server, client) {
 // src/tools/funnels.ts
 import { z as z7 } from "zod";
 var funnelIdSchema = z7.string().describe('Funnel slug (from list_funnels), e.g. "checkout"');
+function stepChangeText(dropOffFromPrevious) {
+  if (dropOffFromPrevious == null) return "";
+  if (dropOffFromPrevious < 0) {
+    return ` (${Math.round(-dropOffFromPrevious * 100)}% MORE than the previous step \u2014 some visitors reached it without the step before, or completed that step before this window)`;
+  }
+  return ` (${Math.round(dropOffFromPrevious * 100)}% drop-off from previous)`;
+}
 function registerFunnelTools(server, client) {
   server.registerTool(
     "list_funnels",
@@ -1118,7 +1150,7 @@ function registerFunnelTools(server, client) {
       const lines = [`${data.displayName} \u2014 last ${data.windowDays} days`];
       for (const s of data.steps) {
         lines.push(
-          `${s.stepIndex + 1}. ${s.displayName}: ${s.reached} reached` + (s.dropOffFromPrevious != null ? ` (${Math.round(s.dropOffFromPrevious * 100)}% drop-off from previous)` : "") + (s.neverFired ? " [never recorded \u2014 check the goal name]" : "")
+          `${s.stepIndex + 1}. ${s.displayName}: ${s.reached} reached` + stepChangeText(s.dropOffFromPrevious) + (s.neverFired ? " [never recorded \u2014 check the goal name]" : "")
         );
         for (const v of s.variants) {
           lines.push(`   ${v.componentId}/${v.variantId}: ${v.reached}/${v.assigned} assigned sessions reached this step`);
@@ -1895,7 +1927,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.17.2" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.17.4" : "0.0.0-dev";
 function createMcpServer(client) {
   const server = new McpServer(
     {

package/dist/index.cjs

@@ -91,8 +91,8 @@ function rangeInputSchema(defaultRange) {
 }
 function rangeQuery(args) {
   const p = new URLSearchParams();
-  if (args.from) {
-    p.set("from", args.from);
+  if (args.from || args.to) {
+    if (args.from) p.set("from", args.from);
     if (args.to) p.set("to", args.to);
   } else if (args.range) {
     p.set("range", args.range);
@@ -112,10 +112,27 @@ var windowOutputSchema = import_zod.z.object({
 function windowLine(window) {
   if (!window) return "";
   if (window.start && window.end) {
-    return `Window: ${window.start.slice(0, 10)} to ${window.end.slice(0, 10)} (${window.timezone}, exclusive end)`;
+    const from = localDate(window.start, window.timezone);
+    const lastIncluded = localDate(
+      new Date(new Date(window.end).getTime() - 1).toISOString(),
+      window.timezone
+    );
+    return `Window: ${from} through ${lastIncluded} inclusive (${window.timezone})`;
   }
   return `Window: all retained data (${window.retentionDays}-day retention)`;
 }
+function localDate(iso, timeZone) {
+  try {
+    return new Intl.DateTimeFormat("en-CA", {
+      timeZone,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit"
+    }).format(new Date(iso));
+  } catch (e) {
+    return iso.slice(0, 10);
+  }
+}
 function apiErrorGuidance(err, extra) {
   if (extra && Object.prototype.hasOwnProperty.call(extra, err.message)) {
     return extra[err.message];
@@ -136,6 +153,12 @@ function apiErrorGuidance(err, extra) {
   if (err.message === "invalid_range") {
     return "Invalid time window. Use range '7d', '30d', '90d' or 'all', or from/to as YYYY-MM-DD dates.";
   }
+  if (err.message === "plan_required" || err.message === "plan_upgrade_required") {
+    return "This feature is not included on the project\u2019s current plan. Upgrade the SentientUI plan to turn it on \u2014 re-authenticating will not help.";
+  }
+  if (err.message === "agent_analytics_requires_paid_plan") {
+    return "Agent analytics is available on paid plans only. Upgrade the SentientUI plan to read agent traffic for this project.";
+  }
   if (err.status === 402) {
     return `This feature requires a higher plan (${err.message}). Upgrade your SentientUI plan, then try again.`;
   }
@@ -687,6 +710,8 @@ var EMPTY_REASON_TEXT = {
   // The stale/never-ran texts name the remedy: an agent that is not told about
   // refresh_insights has no way to know it can fix this itself.
   job_never_ran: "The analysis job has not run yet. Call refresh_insights to run it now.",
+  // No refresh_insights hint here: on a free plan that call just 403s.
+  plan_locked: "AI analysis requires a Starter plan or higher. The measured findings are complete; only the written analysis is plan-gated.",
   job_stale: "These numbers are out of date \u2014 the analysis job has not run recently. Call refresh_insights to regenerate them.",
   data_unavailable: "The project data could not be read just now \u2014 nothing is wrong with the setup. Retry shortly."
 };
@@ -1015,6 +1040,13 @@ function registerGoalTools(server, client) {
 // src/tools/funnels.ts
 var import_zod7 = require("zod");
 var funnelIdSchema = import_zod7.z.string().describe('Funnel slug (from list_funnels), e.g. "checkout"');
+function stepChangeText(dropOffFromPrevious) {
+  if (dropOffFromPrevious == null) return "";
+  if (dropOffFromPrevious < 0) {
+    return ` (${Math.round(-dropOffFromPrevious * 100)}% MORE than the previous step \u2014 some visitors reached it without the step before, or completed that step before this window)`;
+  }
+  return ` (${Math.round(dropOffFromPrevious * 100)}% drop-off from previous)`;
+}
 function registerFunnelTools(server, client) {
   server.registerTool(
     "list_funnels",
@@ -1124,7 +1156,7 @@ function registerFunnelTools(server, client) {
       const lines = [`${data.displayName} \u2014 last ${data.windowDays} days`];
       for (const s of data.steps) {
         lines.push(
-          `${s.stepIndex + 1}. ${s.displayName}: ${s.reached} reached` + (s.dropOffFromPrevious != null ? ` (${Math.round(s.dropOffFromPrevious * 100)}% drop-off from previous)` : "") + (s.neverFired ? " [never recorded \u2014 check the goal name]" : "")
+          `${s.stepIndex + 1}. ${s.displayName}: ${s.reached} reached` + stepChangeText(s.dropOffFromPrevious) + (s.neverFired ? " [never recorded \u2014 check the goal name]" : "")
         );
         for (const v of s.variants) {
           lines.push(`   ${v.componentId}/${v.variantId}: ${v.reached}/${v.assigned} assigned sessions reached this step`);
@@ -1901,7 +1933,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.17.2" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.17.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-PHUP47GG.js";
+} from "./chunk-CEZJQSKB.js";
 
 // src/index.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/lib.cjs

@@ -115,8 +115,8 @@ function rangeInputSchema(defaultRange) {
 }
 function rangeQuery(args) {
   const p = new URLSearchParams();
-  if (args.from) {
-    p.set("from", args.from);
+  if (args.from || args.to) {
+    if (args.from) p.set("from", args.from);
     if (args.to) p.set("to", args.to);
   } else if (args.range) {
     p.set("range", args.range);
@@ -136,10 +136,27 @@ var windowOutputSchema = import_zod.z.object({
 function windowLine(window) {
   if (!window) return "";
   if (window.start && window.end) {
-    return `Window: ${window.start.slice(0, 10)} to ${window.end.slice(0, 10)} (${window.timezone}, exclusive end)`;
+    const from = localDate(window.start, window.timezone);
+    const lastIncluded = localDate(
+      new Date(new Date(window.end).getTime() - 1).toISOString(),
+      window.timezone
+    );
+    return `Window: ${from} through ${lastIncluded} inclusive (${window.timezone})`;
   }
   return `Window: all retained data (${window.retentionDays}-day retention)`;
 }
+function localDate(iso, timeZone) {
+  try {
+    return new Intl.DateTimeFormat("en-CA", {
+      timeZone,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit"
+    }).format(new Date(iso));
+  } catch (e) {
+    return iso.slice(0, 10);
+  }
+}
 function apiErrorGuidance(err, extra) {
   if (extra && Object.prototype.hasOwnProperty.call(extra, err.message)) {
     return extra[err.message];
@@ -160,6 +177,12 @@ function apiErrorGuidance(err, extra) {
   if (err.message === "invalid_range") {
     return "Invalid time window. Use range '7d', '30d', '90d' or 'all', or from/to as YYYY-MM-DD dates.";
   }
+  if (err.message === "plan_required" || err.message === "plan_upgrade_required") {
+    return "This feature is not included on the project\u2019s current plan. Upgrade the SentientUI plan to turn it on \u2014 re-authenticating will not help.";
+  }
+  if (err.message === "agent_analytics_requires_paid_plan") {
+    return "Agent analytics is available on paid plans only. Upgrade the SentientUI plan to read agent traffic for this project.";
+  }
   if (err.status === 402) {
     return `This feature requires a higher plan (${err.message}). Upgrade your SentientUI plan, then try again.`;
   }
@@ -711,6 +734,8 @@ var EMPTY_REASON_TEXT = {
   // The stale/never-ran texts name the remedy: an agent that is not told about
   // refresh_insights has no way to know it can fix this itself.
   job_never_ran: "The analysis job has not run yet. Call refresh_insights to run it now.",
+  // No refresh_insights hint here: on a free plan that call just 403s.
+  plan_locked: "AI analysis requires a Starter plan or higher. The measured findings are complete; only the written analysis is plan-gated.",
   job_stale: "These numbers are out of date \u2014 the analysis job has not run recently. Call refresh_insights to regenerate them.",
   data_unavailable: "The project data could not be read just now \u2014 nothing is wrong with the setup. Retry shortly."
 };
@@ -1039,6 +1064,13 @@ function registerGoalTools(server, client) {
 // src/tools/funnels.ts
 var import_zod7 = require("zod");
 var funnelIdSchema = import_zod7.z.string().describe('Funnel slug (from list_funnels), e.g. "checkout"');
+function stepChangeText(dropOffFromPrevious) {
+  if (dropOffFromPrevious == null) return "";
+  if (dropOffFromPrevious < 0) {
+    return ` (${Math.round(-dropOffFromPrevious * 100)}% MORE than the previous step \u2014 some visitors reached it without the step before, or completed that step before this window)`;
+  }
+  return ` (${Math.round(dropOffFromPrevious * 100)}% drop-off from previous)`;
+}
 function registerFunnelTools(server, client) {
   server.registerTool(
     "list_funnels",
@@ -1148,7 +1180,7 @@ function registerFunnelTools(server, client) {
       const lines = [`${data.displayName} \u2014 last ${data.windowDays} days`];
       for (const s of data.steps) {
         lines.push(
-          `${s.stepIndex + 1}. ${s.displayName}: ${s.reached} reached` + (s.dropOffFromPrevious != null ? ` (${Math.round(s.dropOffFromPrevious * 100)}% drop-off from previous)` : "") + (s.neverFired ? " [never recorded \u2014 check the goal name]" : "")
+          `${s.stepIndex + 1}. ${s.displayName}: ${s.reached} reached` + stepChangeText(s.dropOffFromPrevious) + (s.neverFired ? " [never recorded \u2014 check the goal name]" : "")
         );
         for (const v of s.variants) {
           lines.push(`   ${v.componentId}/${v.variantId}: ${v.reached}/${v.assigned} assigned sessions reached this step`);
@@ -1925,7 +1957,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.17.2" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.17.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-PHUP47GG.js";
+} from "./chunk-CEZJQSKB.js";
 export {
   ApiClient,
   ApiError,

package/package.json

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