@sentientui/mcp 0.15.0 → 0.16.0

package/dist/{chunk-3RJUYHO7.js → chunk-SUMKFRQP.js}

@@ -624,8 +624,11 @@ var EMPTY_REASON_TEXT = {
   awaiting_profiles: "Still building visitor profiles before visitors can be grouped.",
   no_variants: "Nothing to compare yet \u2014 no adaptive component is running.",
   nothing_moved: "Enough data, and nothing moved this period. That is a result.",
-  job_never_ran: "The analysis job has not run yet.",
-  job_stale: "These numbers are out of date \u2014 the analysis job has not run recently."
+  // 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.",
+  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."
 };
 function registerInsightTools(server, client) {
   server.registerTool(
@@ -649,7 +652,14 @@ function registerInsightTools(server, client) {
         observations: z4.array(z4.string()).describe("Headlines of measured findings"),
         recommendations: z4.array(z4.string()).describe("Headlines of interpreted findings (Growth tier)"),
         isStale: z4.boolean().describe("True when the analysis has not run recently"),
-        generatedAt: z4.string().nullable().describe("ISO timestamp, or null")
+        generatedAt: z4.string().nullable().describe("ISO timestamp, or null"),
+        nextUnlock: z4.object({
+          tier: z4.string(),
+          needs: z4.string(),
+          have: z4.number(),
+          need: z4.number(),
+          surface: z4.string().nullable()
+        }).nullable().describe("The nearest gap that would raise the confidence tier, when there is one")
       },
       annotations: {
         readOnlyHint: true,
@@ -658,7 +668,7 @@ function registerInsightTools(server, client) {
       }
     },
     withApiErrorGuidance(async ({ projectId }) => {
-      var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+      var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
       const id = encodeURIComponent(projectId);
       const data = await client.get(`/projects/${id}/evidence-report`);
       const findings = (_a = data.findings) != null ? _a : [];
@@ -670,17 +680,23 @@ function registerInsightTools(server, client) {
       const emptyReason = (_d = data.emptyReason) != null ? _d : null;
       const lines = [];
       if (emptyReason) lines.push((_e = EMPTY_REASON_TEXT[emptyReason]) != null ? _e : emptyReason);
-      if (isStale) lines.push("\u26A0 The analysis job has not run recently, so these numbers may have moved.");
+      if (isStale) lines.push("\u26A0 The analysis job has not run recently, so these numbers may have moved. Call refresh_insights to regenerate them.");
       if ((_f = data.interpretation) == null ? void 0 : _f.locked) {
         lines.push(`${data.interpretation.count || "Some"} recommendations are available on the Growth plan.`);
       } else if (((_g = data.interpretation) == null ? void 0 : _g.emptyReason) && !emptyReason) {
         lines.push(`Recommendations: ${(_h = EMPTY_REASON_TEXT[data.interpretation.emptyReason]) != null ? _h : data.interpretation.emptyReason}`);
       }
       if (data.generatedAt) lines.push(`Generated: ${new Date(data.generatedAt).toUTCString()}`);
+      const nextUnlock = (_i = data.nextUnlock) != null ? _i : null;
+      if (nextUnlock) {
+        const remaining = nextUnlock.need - nextUnlock.have;
+        const where = nextUnlock.surface ? `On ${nextUnlock.surface}: ` : "";
+        lines.push(`${where}${remaining} more ${nextUnlock.needs} would unlock the next confidence level (${nextUnlock.tier}).`);
+      }
       if (measured.length) {
         lines.push("", "Findings:");
         for (const f of measured) {
-          const cov = f.provenance.coverage !== null && f.provenance.coverage < 0.999 ? `, covering ${Math.round(f.provenance.coverage * 100)}% of visitors` : "";
+          const cov = f.provenance.coverage !== null && f.provenance.coverage < 0.999 ? `, covering ${f.provenance.coverage < 5e-3 ? "under 1%" : `${Math.round(f.provenance.coverage * 100)}%`} of visitors` : "";
           lines.push(`- [${f.tier}] ${f.headline} (${f.provenance.sample} ${f.provenance.denominatorLabel}${cov})`);
         }
       }
@@ -692,7 +708,7 @@ function registerInsightTools(server, client) {
         content: [{ type: "text", text: lines.join("\n").trim() || "No findings yet." }],
         structuredContent: {
           status: findings.length ? "ok" : "empty",
-          reached: (_i = data.reached) != null ? _i : "observed",
+          reached: (_j = data.reached) != null ? _j : "observed",
           findings: findings.map((f) => ({
             tier: f.tier,
             kind: f.kind,
@@ -705,7 +721,8 @@ function registerInsightTools(server, client) {
           observations,
           recommendations,
           isStale,
-          generatedAt: (_j = data.generatedAt) != null ? _j : null
+          generatedAt: (_k = data.generatedAt) != null ? _k : null,
+          nextUnlock
         }
       };
     })
@@ -1802,7 +1819,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.15.0" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.16.0" : "0.0.0-dev";
 function createMcpServer(client) {
   const server = new McpServer(
     {

package/dist/index.cjs

@@ -630,8 +630,11 @@ var EMPTY_REASON_TEXT = {
   awaiting_profiles: "Still building visitor profiles before visitors can be grouped.",
   no_variants: "Nothing to compare yet \u2014 no adaptive component is running.",
   nothing_moved: "Enough data, and nothing moved this period. That is a result.",
-  job_never_ran: "The analysis job has not run yet.",
-  job_stale: "These numbers are out of date \u2014 the analysis job has not run recently."
+  // 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.",
+  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."
 };
 function registerInsightTools(server, client) {
   server.registerTool(
@@ -655,7 +658,14 @@ function registerInsightTools(server, client) {
         observations: import_zod4.z.array(import_zod4.z.string()).describe("Headlines of measured findings"),
         recommendations: import_zod4.z.array(import_zod4.z.string()).describe("Headlines of interpreted findings (Growth tier)"),
         isStale: import_zod4.z.boolean().describe("True when the analysis has not run recently"),
-        generatedAt: import_zod4.z.string().nullable().describe("ISO timestamp, or null")
+        generatedAt: import_zod4.z.string().nullable().describe("ISO timestamp, or null"),
+        nextUnlock: import_zod4.z.object({
+          tier: import_zod4.z.string(),
+          needs: import_zod4.z.string(),
+          have: import_zod4.z.number(),
+          need: import_zod4.z.number(),
+          surface: import_zod4.z.string().nullable()
+        }).nullable().describe("The nearest gap that would raise the confidence tier, when there is one")
       },
       annotations: {
         readOnlyHint: true,
@@ -664,7 +674,7 @@ function registerInsightTools(server, client) {
       }
     },
     withApiErrorGuidance(async ({ projectId }) => {
-      var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+      var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
       const id = encodeURIComponent(projectId);
       const data = await client.get(`/projects/${id}/evidence-report`);
       const findings = (_a2 = data.findings) != null ? _a2 : [];
@@ -676,17 +686,23 @@ function registerInsightTools(server, client) {
       const emptyReason = (_d = data.emptyReason) != null ? _d : null;
       const lines = [];
       if (emptyReason) lines.push((_e = EMPTY_REASON_TEXT[emptyReason]) != null ? _e : emptyReason);
-      if (isStale) lines.push("\u26A0 The analysis job has not run recently, so these numbers may have moved.");
+      if (isStale) lines.push("\u26A0 The analysis job has not run recently, so these numbers may have moved. Call refresh_insights to regenerate them.");
       if ((_f = data.interpretation) == null ? void 0 : _f.locked) {
         lines.push(`${data.interpretation.count || "Some"} recommendations are available on the Growth plan.`);
       } else if (((_g = data.interpretation) == null ? void 0 : _g.emptyReason) && !emptyReason) {
         lines.push(`Recommendations: ${(_h = EMPTY_REASON_TEXT[data.interpretation.emptyReason]) != null ? _h : data.interpretation.emptyReason}`);
       }
       if (data.generatedAt) lines.push(`Generated: ${new Date(data.generatedAt).toUTCString()}`);
+      const nextUnlock = (_i = data.nextUnlock) != null ? _i : null;
+      if (nextUnlock) {
+        const remaining = nextUnlock.need - nextUnlock.have;
+        const where = nextUnlock.surface ? `On ${nextUnlock.surface}: ` : "";
+        lines.push(`${where}${remaining} more ${nextUnlock.needs} would unlock the next confidence level (${nextUnlock.tier}).`);
+      }
       if (measured.length) {
         lines.push("", "Findings:");
         for (const f of measured) {
-          const cov = f.provenance.coverage !== null && f.provenance.coverage < 0.999 ? `, covering ${Math.round(f.provenance.coverage * 100)}% of visitors` : "";
+          const cov = f.provenance.coverage !== null && f.provenance.coverage < 0.999 ? `, covering ${f.provenance.coverage < 5e-3 ? "under 1%" : `${Math.round(f.provenance.coverage * 100)}%`} of visitors` : "";
           lines.push(`- [${f.tier}] ${f.headline} (${f.provenance.sample} ${f.provenance.denominatorLabel}${cov})`);
         }
       }
@@ -698,7 +714,7 @@ function registerInsightTools(server, client) {
         content: [{ type: "text", text: lines.join("\n").trim() || "No findings yet." }],
         structuredContent: {
           status: findings.length ? "ok" : "empty",
-          reached: (_i = data.reached) != null ? _i : "observed",
+          reached: (_j = data.reached) != null ? _j : "observed",
           findings: findings.map((f) => ({
             tier: f.tier,
             kind: f.kind,
@@ -711,7 +727,8 @@ function registerInsightTools(server, client) {
           observations,
           recommendations,
           isStale,
-          generatedAt: (_j = data.generatedAt) != null ? _j : null
+          generatedAt: (_k = data.generatedAt) != null ? _k : null,
+          nextUnlock
         }
       };
     })
@@ -1808,7 +1825,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.15.0" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.16.0" : "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-3RJUYHO7.js";
+} from "./chunk-SUMKFRQP.js";
 
 // src/index.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/lib.cjs

@@ -654,8 +654,11 @@ var EMPTY_REASON_TEXT = {
   awaiting_profiles: "Still building visitor profiles before visitors can be grouped.",
   no_variants: "Nothing to compare yet \u2014 no adaptive component is running.",
   nothing_moved: "Enough data, and nothing moved this period. That is a result.",
-  job_never_ran: "The analysis job has not run yet.",
-  job_stale: "These numbers are out of date \u2014 the analysis job has not run recently."
+  // 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.",
+  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."
 };
 function registerInsightTools(server, client) {
   server.registerTool(
@@ -679,7 +682,14 @@ function registerInsightTools(server, client) {
         observations: import_zod4.z.array(import_zod4.z.string()).describe("Headlines of measured findings"),
         recommendations: import_zod4.z.array(import_zod4.z.string()).describe("Headlines of interpreted findings (Growth tier)"),
         isStale: import_zod4.z.boolean().describe("True when the analysis has not run recently"),
-        generatedAt: import_zod4.z.string().nullable().describe("ISO timestamp, or null")
+        generatedAt: import_zod4.z.string().nullable().describe("ISO timestamp, or null"),
+        nextUnlock: import_zod4.z.object({
+          tier: import_zod4.z.string(),
+          needs: import_zod4.z.string(),
+          have: import_zod4.z.number(),
+          need: import_zod4.z.number(),
+          surface: import_zod4.z.string().nullable()
+        }).nullable().describe("The nearest gap that would raise the confidence tier, when there is one")
       },
       annotations: {
         readOnlyHint: true,
@@ -688,7 +698,7 @@ function registerInsightTools(server, client) {
       }
     },
     withApiErrorGuidance(async ({ projectId }) => {
-      var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+      var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
       const id = encodeURIComponent(projectId);
       const data = await client.get(`/projects/${id}/evidence-report`);
       const findings = (_a = data.findings) != null ? _a : [];
@@ -700,17 +710,23 @@ function registerInsightTools(server, client) {
       const emptyReason = (_d = data.emptyReason) != null ? _d : null;
       const lines = [];
       if (emptyReason) lines.push((_e = EMPTY_REASON_TEXT[emptyReason]) != null ? _e : emptyReason);
-      if (isStale) lines.push("\u26A0 The analysis job has not run recently, so these numbers may have moved.");
+      if (isStale) lines.push("\u26A0 The analysis job has not run recently, so these numbers may have moved. Call refresh_insights to regenerate them.");
       if ((_f = data.interpretation) == null ? void 0 : _f.locked) {
         lines.push(`${data.interpretation.count || "Some"} recommendations are available on the Growth plan.`);
       } else if (((_g = data.interpretation) == null ? void 0 : _g.emptyReason) && !emptyReason) {
         lines.push(`Recommendations: ${(_h = EMPTY_REASON_TEXT[data.interpretation.emptyReason]) != null ? _h : data.interpretation.emptyReason}`);
       }
       if (data.generatedAt) lines.push(`Generated: ${new Date(data.generatedAt).toUTCString()}`);
+      const nextUnlock = (_i = data.nextUnlock) != null ? _i : null;
+      if (nextUnlock) {
+        const remaining = nextUnlock.need - nextUnlock.have;
+        const where = nextUnlock.surface ? `On ${nextUnlock.surface}: ` : "";
+        lines.push(`${where}${remaining} more ${nextUnlock.needs} would unlock the next confidence level (${nextUnlock.tier}).`);
+      }
       if (measured.length) {
         lines.push("", "Findings:");
         for (const f of measured) {
-          const cov = f.provenance.coverage !== null && f.provenance.coverage < 0.999 ? `, covering ${Math.round(f.provenance.coverage * 100)}% of visitors` : "";
+          const cov = f.provenance.coverage !== null && f.provenance.coverage < 0.999 ? `, covering ${f.provenance.coverage < 5e-3 ? "under 1%" : `${Math.round(f.provenance.coverage * 100)}%`} of visitors` : "";
           lines.push(`- [${f.tier}] ${f.headline} (${f.provenance.sample} ${f.provenance.denominatorLabel}${cov})`);
         }
       }
@@ -722,7 +738,7 @@ function registerInsightTools(server, client) {
         content: [{ type: "text", text: lines.join("\n").trim() || "No findings yet." }],
         structuredContent: {
           status: findings.length ? "ok" : "empty",
-          reached: (_i = data.reached) != null ? _i : "observed",
+          reached: (_j = data.reached) != null ? _j : "observed",
           findings: findings.map((f) => ({
             tier: f.tier,
             kind: f.kind,
@@ -735,7 +751,8 @@ function registerInsightTools(server, client) {
           observations,
           recommendations,
           isStale,
-          generatedAt: (_j = data.generatedAt) != null ? _j : null
+          generatedAt: (_k = data.generatedAt) != null ? _k : null,
+          nextUnlock
         }
       };
     })
@@ -1832,7 +1849,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.15.0" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.16.0" : "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-3RJUYHO7.js";
+} from "./chunk-SUMKFRQP.js";
 export {
   ApiClient,
   ApiError,

package/package.json

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