@sentientui/mcp 0.17.5 → 0.17.6

package/dist/{chunk-H763K2O3.js → chunk-FBRHD7R7.js}

@@ -942,7 +942,7 @@ function registerGoalTools(server, client) {
     "get_goal_funnel",
     {
       title: "Goal funnel",
-      description: "Get goal hit counts, unique-session conversion rates, and per-variant breakdown (default window: last 30 calendar days). This is a flat per-goal list \u2014 for multi-step funnel drop-off, use get_funnel_report." + UNTRUSTED_FIELDS_NOTE,
+      description: "Get goal hit counts and unique-session conversion rates for a window (default: last 30 calendar days), plus a per-variant breakdown. NOTE: the per-variant completionRate values are ALL-TIME (bounded only by plan retention), NOT windowed \u2014 a variant completion rate needs the full assignment history as its denominator, so it does not change when you narrow `range`, and retired components keep appearing in it. Only hits/uniqueSessions/conversionRate/revenue respect the window. This is a flat per-goal list \u2014 for multi-step funnel drop-off, use get_funnel_report." + UNTRUSTED_FIELDS_NOTE,
       inputSchema: __spreadValues({ projectId: projectIdSchema }, rangeInputSchema("30d")),
       _meta: uiMeta("goal-funnel"),
       outputSchema: {
@@ -960,9 +960,13 @@ function registerGoalTools(server, client) {
               z6.object({
                 componentId: z6.string(),
                 variantId: z6.string(),
-                completionRate: z6.number().describe("Completion rate per assigned session (0-1)")
+                completionRate: z6.number().describe(
+                  "ALL-TIME completion rate per assigned session (0-1). Not windowed: unaffected by `range`/`from`/`to`, and bounded only by plan retention."
+                )
               })
-            ).describe("Per-variant breakdown")
+            ).describe(
+              "Per-variant breakdown. ALL-TIME, not windowed \u2014 do not compare these against the windowed hits/conversionRate above, and expect retired components here."
+            )
           })
         ).describe("Configured goals (empty if none)"),
         window: windowOutputSchema
@@ -1011,11 +1015,18 @@ function registerGoalTools(server, client) {
         var _a2;
         return [
           `${untrusted(g.goalName)}: ${g.hits} hits, ${g.uniqueSessions} unique sessions, ${(g.pct * 100).toFixed(1)}% conversion` + (g.revenue != null ? `, ${g.revenue.toFixed(2)} ${currency} revenue (${((_a2 = g.avgOrderValue) != null ? _a2 : 0).toFixed(2)} avg order)` : ""),
-          ...g.variants.map((v) => `  ${untrusted(v.componentId)}/${untrusted(v.variantId)}: ${(v.completionRate * 100).toFixed(1)}% per assigned session`),
+          // The per-variant rates come from an all-time query (analytics.ts
+          // query 2, deliberately unwindowed so the denominator is the full
+          // assignment history). The dashboard labels them; this text had not,
+          // so a narrowed `range` returned identical variant rates next to a
+          // windowed headline and read as a windowed comparison.
+          ...g.variants.map((v) => `  ${untrusted(v.componentId)}/${untrusted(v.variantId)}: ${(v.completionRate * 100).toFixed(1)}% per assigned session (all-time)`),
           ""
         ];
       });
-      const text = (win ? [win, "", ...lines] : lines).join("\n").trim();
+      const hasVariants = data.goals.some((g) => g.variants.length > 0);
+      const caveat = hasVariants ? ["", "Note: goal hits/conversion respect the window above; per-variant rates marked (all-time) do not."] : [];
+      const text = (win ? [win, "", ...lines, ...caveat] : [...lines, ...caveat]).join("\n").trim();
       return { content: [{ type: "text", text }], structuredContent, _meta: uiMeta("goal-funnel") };
     })
   );
@@ -1247,8 +1258,11 @@ function registerGuardrailTools(server, client) {
     "list_guardrail_events",
     {
       title: "List guardrail events",
-      description: "List variants currently paused by the guardrail in the last 24 hours." + UNTRUSTED_FIELDS_NOTE,
-      inputSchema: { projectId: projectIdSchema },
+      description: "List every variant currently paused by a guardrail (a paused variant stops serving until unpaused, however long ago the pause fired). Pass `days` to narrow to pauses fired within the last N days." + UNTRUSTED_FIELDS_NOTE,
+      inputSchema: {
+        projectId: projectIdSchema,
+        days: z8.number().int().min(1).max(365).optional().describe("Only pauses fired within the last N days. Omit for every still-paused variant.")
+      },
       outputSchema: {
         events: z8.array(
           z8.object({
@@ -1257,7 +1271,7 @@ function registerGuardrailTools(server, client) {
             pausedAt: z8.string().nullable().describe("ISO timestamp the pause fired, or null"),
             funnelId: z8.string().nullable().describe("Set when the pause came from a funnel guardrail")
           })
-        ).describe("Guardrail events in the last 24h (empty if none)")
+        ).describe("Currently paused variants (empty if none)")
       },
       annotations: {
         readOnlyHint: true,
@@ -1265,9 +1279,10 @@ function registerGuardrailTools(server, client) {
         openWorldHint: false
       }
     },
-    withApiErrorGuidance(async ({ projectId }) => {
+    withApiErrorGuidance(async ({ projectId, days }) => {
       const id = encodeURIComponent(projectId);
-      const data = await client.get(`/projects/${id}/guardrail-events`);
+      const query = days != null ? `?days=${days}` : "";
+      const data = await client.get(`/projects/${id}/guardrail-events${query}`);
       const structuredContent = {
         events: data.guardrailEvents.map((e) => {
           var _a;
@@ -1280,8 +1295,9 @@ function registerGuardrailTools(server, client) {
         })
       };
       if (!data.guardrailEvents.length) {
+        const scope = days != null ? `paused by a guardrail in the last ${days} days` : "currently paused by a guardrail";
         return {
-          content: [{ type: "text", text: "No active guardrail events in the last 24 hours." }],
+          content: [{ type: "text", text: `No variants ${scope}.` }],
           structuredContent
         };
       }
@@ -2003,7 +2019,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.17.5" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.17.6" : "0.0.0-dev";
 function createMcpServer(client) {
   const server = new McpServer(
     {

package/dist/index.cjs

@@ -948,7 +948,7 @@ function registerGoalTools(server, client) {
     "get_goal_funnel",
     {
       title: "Goal funnel",
-      description: "Get goal hit counts, unique-session conversion rates, and per-variant breakdown (default window: last 30 calendar days). This is a flat per-goal list \u2014 for multi-step funnel drop-off, use get_funnel_report." + UNTRUSTED_FIELDS_NOTE,
+      description: "Get goal hit counts and unique-session conversion rates for a window (default: last 30 calendar days), plus a per-variant breakdown. NOTE: the per-variant completionRate values are ALL-TIME (bounded only by plan retention), NOT windowed \u2014 a variant completion rate needs the full assignment history as its denominator, so it does not change when you narrow `range`, and retired components keep appearing in it. Only hits/uniqueSessions/conversionRate/revenue respect the window. This is a flat per-goal list \u2014 for multi-step funnel drop-off, use get_funnel_report." + UNTRUSTED_FIELDS_NOTE,
       inputSchema: __spreadValues({ projectId: projectIdSchema }, rangeInputSchema("30d")),
       _meta: uiMeta("goal-funnel"),
       outputSchema: {
@@ -966,9 +966,13 @@ function registerGoalTools(server, client) {
               import_zod6.z.object({
                 componentId: import_zod6.z.string(),
                 variantId: import_zod6.z.string(),
-                completionRate: import_zod6.z.number().describe("Completion rate per assigned session (0-1)")
+                completionRate: import_zod6.z.number().describe(
+                  "ALL-TIME completion rate per assigned session (0-1). Not windowed: unaffected by `range`/`from`/`to`, and bounded only by plan retention."
+                )
               })
-            ).describe("Per-variant breakdown")
+            ).describe(
+              "Per-variant breakdown. ALL-TIME, not windowed \u2014 do not compare these against the windowed hits/conversionRate above, and expect retired components here."
+            )
           })
         ).describe("Configured goals (empty if none)"),
         window: windowOutputSchema
@@ -1017,11 +1021,18 @@ function registerGoalTools(server, client) {
         var _a3;
         return [
           `${untrusted(g.goalName)}: ${g.hits} hits, ${g.uniqueSessions} unique sessions, ${(g.pct * 100).toFixed(1)}% conversion` + (g.revenue != null ? `, ${g.revenue.toFixed(2)} ${currency} revenue (${((_a3 = g.avgOrderValue) != null ? _a3 : 0).toFixed(2)} avg order)` : ""),
-          ...g.variants.map((v) => `  ${untrusted(v.componentId)}/${untrusted(v.variantId)}: ${(v.completionRate * 100).toFixed(1)}% per assigned session`),
+          // The per-variant rates come from an all-time query (analytics.ts
+          // query 2, deliberately unwindowed so the denominator is the full
+          // assignment history). The dashboard labels them; this text had not,
+          // so a narrowed `range` returned identical variant rates next to a
+          // windowed headline and read as a windowed comparison.
+          ...g.variants.map((v) => `  ${untrusted(v.componentId)}/${untrusted(v.variantId)}: ${(v.completionRate * 100).toFixed(1)}% per assigned session (all-time)`),
           ""
         ];
       });
-      const text = (win ? [win, "", ...lines] : lines).join("\n").trim();
+      const hasVariants = data.goals.some((g) => g.variants.length > 0);
+      const caveat = hasVariants ? ["", "Note: goal hits/conversion respect the window above; per-variant rates marked (all-time) do not."] : [];
+      const text = (win ? [win, "", ...lines, ...caveat] : [...lines, ...caveat]).join("\n").trim();
       return { content: [{ type: "text", text }], structuredContent, _meta: uiMeta("goal-funnel") };
     })
   );
@@ -1253,8 +1264,11 @@ function registerGuardrailTools(server, client) {
     "list_guardrail_events",
     {
       title: "List guardrail events",
-      description: "List variants currently paused by the guardrail in the last 24 hours." + UNTRUSTED_FIELDS_NOTE,
-      inputSchema: { projectId: projectIdSchema },
+      description: "List every variant currently paused by a guardrail (a paused variant stops serving until unpaused, however long ago the pause fired). Pass `days` to narrow to pauses fired within the last N days." + UNTRUSTED_FIELDS_NOTE,
+      inputSchema: {
+        projectId: projectIdSchema,
+        days: import_zod8.z.number().int().min(1).max(365).optional().describe("Only pauses fired within the last N days. Omit for every still-paused variant.")
+      },
       outputSchema: {
         events: import_zod8.z.array(
           import_zod8.z.object({
@@ -1263,7 +1277,7 @@ function registerGuardrailTools(server, client) {
             pausedAt: import_zod8.z.string().nullable().describe("ISO timestamp the pause fired, or null"),
             funnelId: import_zod8.z.string().nullable().describe("Set when the pause came from a funnel guardrail")
           })
-        ).describe("Guardrail events in the last 24h (empty if none)")
+        ).describe("Currently paused variants (empty if none)")
       },
       annotations: {
         readOnlyHint: true,
@@ -1271,9 +1285,10 @@ function registerGuardrailTools(server, client) {
         openWorldHint: false
       }
     },
-    withApiErrorGuidance(async ({ projectId }) => {
+    withApiErrorGuidance(async ({ projectId, days }) => {
       const id = encodeURIComponent(projectId);
-      const data = await client.get(`/projects/${id}/guardrail-events`);
+      const query = days != null ? `?days=${days}` : "";
+      const data = await client.get(`/projects/${id}/guardrail-events${query}`);
       const structuredContent = {
         events: data.guardrailEvents.map((e) => {
           var _a2;
@@ -1286,8 +1301,9 @@ function registerGuardrailTools(server, client) {
         })
       };
       if (!data.guardrailEvents.length) {
+        const scope = days != null ? `paused by a guardrail in the last ${days} days` : "currently paused by a guardrail";
         return {
-          content: [{ type: "text", text: "No active guardrail events in the last 24 hours." }],
+          content: [{ type: "text", text: `No variants ${scope}.` }],
           structuredContent
         };
       }
@@ -2009,7 +2025,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.17.5" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.17.6" : "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-H763K2O3.js";
+} from "./chunk-FBRHD7R7.js";
 
 // src/index.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/lib.cjs

@@ -972,7 +972,7 @@ function registerGoalTools(server, client) {
     "get_goal_funnel",
     {
       title: "Goal funnel",
-      description: "Get goal hit counts, unique-session conversion rates, and per-variant breakdown (default window: last 30 calendar days). This is a flat per-goal list \u2014 for multi-step funnel drop-off, use get_funnel_report." + UNTRUSTED_FIELDS_NOTE,
+      description: "Get goal hit counts and unique-session conversion rates for a window (default: last 30 calendar days), plus a per-variant breakdown. NOTE: the per-variant completionRate values are ALL-TIME (bounded only by plan retention), NOT windowed \u2014 a variant completion rate needs the full assignment history as its denominator, so it does not change when you narrow `range`, and retired components keep appearing in it. Only hits/uniqueSessions/conversionRate/revenue respect the window. This is a flat per-goal list \u2014 for multi-step funnel drop-off, use get_funnel_report." + UNTRUSTED_FIELDS_NOTE,
       inputSchema: __spreadValues({ projectId: projectIdSchema }, rangeInputSchema("30d")),
       _meta: uiMeta("goal-funnel"),
       outputSchema: {
@@ -990,9 +990,13 @@ function registerGoalTools(server, client) {
               import_zod6.z.object({
                 componentId: import_zod6.z.string(),
                 variantId: import_zod6.z.string(),
-                completionRate: import_zod6.z.number().describe("Completion rate per assigned session (0-1)")
+                completionRate: import_zod6.z.number().describe(
+                  "ALL-TIME completion rate per assigned session (0-1). Not windowed: unaffected by `range`/`from`/`to`, and bounded only by plan retention."
+                )
               })
-            ).describe("Per-variant breakdown")
+            ).describe(
+              "Per-variant breakdown. ALL-TIME, not windowed \u2014 do not compare these against the windowed hits/conversionRate above, and expect retired components here."
+            )
           })
         ).describe("Configured goals (empty if none)"),
         window: windowOutputSchema
@@ -1041,11 +1045,18 @@ function registerGoalTools(server, client) {
         var _a2;
         return [
           `${untrusted(g.goalName)}: ${g.hits} hits, ${g.uniqueSessions} unique sessions, ${(g.pct * 100).toFixed(1)}% conversion` + (g.revenue != null ? `, ${g.revenue.toFixed(2)} ${currency} revenue (${((_a2 = g.avgOrderValue) != null ? _a2 : 0).toFixed(2)} avg order)` : ""),
-          ...g.variants.map((v) => `  ${untrusted(v.componentId)}/${untrusted(v.variantId)}: ${(v.completionRate * 100).toFixed(1)}% per assigned session`),
+          // The per-variant rates come from an all-time query (analytics.ts
+          // query 2, deliberately unwindowed so the denominator is the full
+          // assignment history). The dashboard labels them; this text had not,
+          // so a narrowed `range` returned identical variant rates next to a
+          // windowed headline and read as a windowed comparison.
+          ...g.variants.map((v) => `  ${untrusted(v.componentId)}/${untrusted(v.variantId)}: ${(v.completionRate * 100).toFixed(1)}% per assigned session (all-time)`),
           ""
         ];
       });
-      const text = (win ? [win, "", ...lines] : lines).join("\n").trim();
+      const hasVariants = data.goals.some((g) => g.variants.length > 0);
+      const caveat = hasVariants ? ["", "Note: goal hits/conversion respect the window above; per-variant rates marked (all-time) do not."] : [];
+      const text = (win ? [win, "", ...lines, ...caveat] : [...lines, ...caveat]).join("\n").trim();
       return { content: [{ type: "text", text }], structuredContent, _meta: uiMeta("goal-funnel") };
     })
   );
@@ -1277,8 +1288,11 @@ function registerGuardrailTools(server, client) {
     "list_guardrail_events",
     {
       title: "List guardrail events",
-      description: "List variants currently paused by the guardrail in the last 24 hours." + UNTRUSTED_FIELDS_NOTE,
-      inputSchema: { projectId: projectIdSchema },
+      description: "List every variant currently paused by a guardrail (a paused variant stops serving until unpaused, however long ago the pause fired). Pass `days` to narrow to pauses fired within the last N days." + UNTRUSTED_FIELDS_NOTE,
+      inputSchema: {
+        projectId: projectIdSchema,
+        days: import_zod8.z.number().int().min(1).max(365).optional().describe("Only pauses fired within the last N days. Omit for every still-paused variant.")
+      },
       outputSchema: {
         events: import_zod8.z.array(
           import_zod8.z.object({
@@ -1287,7 +1301,7 @@ function registerGuardrailTools(server, client) {
             pausedAt: import_zod8.z.string().nullable().describe("ISO timestamp the pause fired, or null"),
             funnelId: import_zod8.z.string().nullable().describe("Set when the pause came from a funnel guardrail")
           })
-        ).describe("Guardrail events in the last 24h (empty if none)")
+        ).describe("Currently paused variants (empty if none)")
       },
       annotations: {
         readOnlyHint: true,
@@ -1295,9 +1309,10 @@ function registerGuardrailTools(server, client) {
         openWorldHint: false
       }
     },
-    withApiErrorGuidance(async ({ projectId }) => {
+    withApiErrorGuidance(async ({ projectId, days }) => {
       const id = encodeURIComponent(projectId);
-      const data = await client.get(`/projects/${id}/guardrail-events`);
+      const query = days != null ? `?days=${days}` : "";
+      const data = await client.get(`/projects/${id}/guardrail-events${query}`);
       const structuredContent = {
         events: data.guardrailEvents.map((e) => {
           var _a;
@@ -1310,8 +1325,9 @@ function registerGuardrailTools(server, client) {
         })
       };
       if (!data.guardrailEvents.length) {
+        const scope = days != null ? `paused by a guardrail in the last ${days} days` : "currently paused by a guardrail";
         return {
-          content: [{ type: "text", text: "No active guardrail events in the last 24 hours." }],
+          content: [{ type: "text", text: `No variants ${scope}.` }],
           structuredContent
         };
       }
@@ -2033,7 +2049,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.17.5" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.17.6" : "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-H763K2O3.js";
+} from "./chunk-FBRHD7R7.js";
 export {
   ApiClient,
   ApiError,

package/package.json

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