@sentientui/mcp 0.14.2 → 0.15.0

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

@@ -618,19 +618,38 @@ function registerComponentTools(server, client) {
 
 // src/tools/insights.ts
 import { z as z4 } from "zod";
+var EMPTY_REASON_TEXT = {
+  no_events: "The snippet has not fired yet \u2014 nothing has reached us.",
+  no_traffic_yet: "Test traffic only so far; no genuine visitors yet.",
+  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."
+};
 function registerInsightTools(server, client) {
   server.registerTool(
     "get_insights",
     {
       title: "Get insights",
-      description: "Get the latest AI-generated insights: narrator observations and (Growth tier) advisor recommendations.",
+      description: "What is known about this project right now: ranked findings with the evidence behind each one, plus (Growth tier) advisor recommendations. Says why it is empty when it is.",
       inputSchema: { projectId: projectIdSchema },
       outputSchema: {
-        status: z4.enum(["ok", "empty"]).describe("Whether insights exist yet"),
-        observations: z4.array(z4.string()).describe("Narrator observations"),
-        recommendations: z4.array(z4.string()).describe("Advisor recommendations (Growth tier)"),
-        isStale: z4.boolean().describe("True when the insights are older than ~6h"),
-        generatedAt: z4.string().nullable().describe("ISO timestamp the insights were generated, or null")
+        status: z4.enum(["ok", "empty"]).describe("Whether any findings exist yet"),
+        reached: z4.string().describe("Highest confidence tier earned: observed | patterned | tested"),
+        findings: z4.array(z4.object({
+          tier: z4.string().describe("observed | patterned | tested"),
+          kind: z4.string(),
+          headline: z4.string(),
+          audience: z4.string().nullable(),
+          sample: z4.number().describe("How many the finding is based on"),
+          coverage: z4.number().nullable().describe("Fraction of traffic this finding describes, when applicable")
+        })).describe("Ranked findings, each with the evidence behind it"),
+        emptyReason: z4.string().nullable().describe("Why there is nothing to report, when there is nothing"),
+        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")
       },
       annotations: {
         readOnlyHint: true,
@@ -639,42 +658,54 @@ function registerInsightTools(server, client) {
       }
     },
     withApiErrorGuidance(async ({ projectId }) => {
-      var _a, _b, _c, _d;
+      var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
       const id = encodeURIComponent(projectId);
-      const data = await client.get(`/projects/${id}/insights`);
-      if (data.status === "empty") {
-        return {
-          content: [{ type: "text", text: "No insights generated yet. Use refresh_insights to generate." }],
-          structuredContent: {
-            status: "empty",
-            observations: [],
-            recommendations: [],
-            isStale: false,
-            generatedAt: null
-          }
-        };
-      }
-      const observations = (_a = data.narratorBullets) != null ? _a : [];
-      const recommendations = (_b = data.advisorBullets) != null ? _b : [];
+      const data = await client.get(`/projects/${id}/evidence-report`);
+      const findings = (_a = data.findings) != null ? _a : [];
+      const measured = findings.filter((f) => !f.interpreted);
+      const interpreted = findings.filter((f) => f.interpreted);
+      const observations = measured.map((f) => f.headline);
+      const recommendations = interpreted.map((f) => f.headline);
+      const isStale = (_c = (_b = data.freshness) == null ? void 0 : _b.isStale) != null ? _c : false;
+      const emptyReason = (_d = data.emptyReason) != null ? _d : null;
       const lines = [];
-      if (data.isStale) lines.push("\u26A0 Insights are stale (>6h old). Consider calling refresh_insights.");
+      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 ((_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()}`);
-      lines.push("");
-      lines.push("Observations:");
-      observations.forEach((b) => lines.push(`- ${b}`));
+      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` : "";
+          lines.push(`- [${f.tier}] ${f.headline} (${f.provenance.sample} ${f.provenance.denominatorLabel}${cov})`);
+        }
+      }
       if (recommendations.length) {
-        lines.push("");
-        lines.push("Recommendations:");
-        recommendations.forEach((b) => lines.push(`- ${b}`));
+        lines.push("", "Recommendations:");
+        for (const r of recommendations) lines.push(`- ${r}`);
       }
       return {
-        content: [{ type: "text", text: lines.join("\n") }],
+        content: [{ type: "text", text: lines.join("\n").trim() || "No findings yet." }],
         structuredContent: {
-          status: "ok",
+          status: findings.length ? "ok" : "empty",
+          reached: (_i = data.reached) != null ? _i : "observed",
+          findings: findings.map((f) => ({
+            tier: f.tier,
+            kind: f.kind,
+            headline: f.headline,
+            audience: f.audience,
+            sample: f.provenance.sample,
+            coverage: f.provenance.coverage
+          })),
+          emptyReason,
           observations,
           recommendations,
-          isStale: (_c = data.isStale) != null ? _c : false,
-          generatedAt: (_d = data.generatedAt) != null ? _d : null
+          isStale,
+          generatedAt: (_j = data.generatedAt) != null ? _j : null
         }
       };
     })
@@ -1771,7 +1802,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.14.2" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.15.0" : "0.0.0-dev";
 function createMcpServer(client) {
   const server = new McpServer(
     {

package/dist/index.cjs

@@ -624,19 +624,38 @@ function registerComponentTools(server, client) {
 
 // src/tools/insights.ts
 var import_zod4 = require("zod");
+var EMPTY_REASON_TEXT = {
+  no_events: "The snippet has not fired yet \u2014 nothing has reached us.",
+  no_traffic_yet: "Test traffic only so far; no genuine visitors yet.",
+  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."
+};
 function registerInsightTools(server, client) {
   server.registerTool(
     "get_insights",
     {
       title: "Get insights",
-      description: "Get the latest AI-generated insights: narrator observations and (Growth tier) advisor recommendations.",
+      description: "What is known about this project right now: ranked findings with the evidence behind each one, plus (Growth tier) advisor recommendations. Says why it is empty when it is.",
       inputSchema: { projectId: projectIdSchema },
       outputSchema: {
-        status: import_zod4.z.enum(["ok", "empty"]).describe("Whether insights exist yet"),
-        observations: import_zod4.z.array(import_zod4.z.string()).describe("Narrator observations"),
-        recommendations: import_zod4.z.array(import_zod4.z.string()).describe("Advisor recommendations (Growth tier)"),
-        isStale: import_zod4.z.boolean().describe("True when the insights are older than ~6h"),
-        generatedAt: import_zod4.z.string().nullable().describe("ISO timestamp the insights were generated, or null")
+        status: import_zod4.z.enum(["ok", "empty"]).describe("Whether any findings exist yet"),
+        reached: import_zod4.z.string().describe("Highest confidence tier earned: observed | patterned | tested"),
+        findings: import_zod4.z.array(import_zod4.z.object({
+          tier: import_zod4.z.string().describe("observed | patterned | tested"),
+          kind: import_zod4.z.string(),
+          headline: import_zod4.z.string(),
+          audience: import_zod4.z.string().nullable(),
+          sample: import_zod4.z.number().describe("How many the finding is based on"),
+          coverage: import_zod4.z.number().nullable().describe("Fraction of traffic this finding describes, when applicable")
+        })).describe("Ranked findings, each with the evidence behind it"),
+        emptyReason: import_zod4.z.string().nullable().describe("Why there is nothing to report, when there is nothing"),
+        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")
       },
       annotations: {
         readOnlyHint: true,
@@ -645,42 +664,54 @@ function registerInsightTools(server, client) {
       }
     },
     withApiErrorGuidance(async ({ projectId }) => {
-      var _a2, _b, _c, _d;
+      var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j;
       const id = encodeURIComponent(projectId);
-      const data = await client.get(`/projects/${id}/insights`);
-      if (data.status === "empty") {
-        return {
-          content: [{ type: "text", text: "No insights generated yet. Use refresh_insights to generate." }],
-          structuredContent: {
-            status: "empty",
-            observations: [],
-            recommendations: [],
-            isStale: false,
-            generatedAt: null
-          }
-        };
-      }
-      const observations = (_a2 = data.narratorBullets) != null ? _a2 : [];
-      const recommendations = (_b = data.advisorBullets) != null ? _b : [];
+      const data = await client.get(`/projects/${id}/evidence-report`);
+      const findings = (_a2 = data.findings) != null ? _a2 : [];
+      const measured = findings.filter((f) => !f.interpreted);
+      const interpreted = findings.filter((f) => f.interpreted);
+      const observations = measured.map((f) => f.headline);
+      const recommendations = interpreted.map((f) => f.headline);
+      const isStale = (_c = (_b = data.freshness) == null ? void 0 : _b.isStale) != null ? _c : false;
+      const emptyReason = (_d = data.emptyReason) != null ? _d : null;
       const lines = [];
-      if (data.isStale) lines.push("\u26A0 Insights are stale (>6h old). Consider calling refresh_insights.");
+      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 ((_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()}`);
-      lines.push("");
-      lines.push("Observations:");
-      observations.forEach((b) => lines.push(`- ${b}`));
+      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` : "";
+          lines.push(`- [${f.tier}] ${f.headline} (${f.provenance.sample} ${f.provenance.denominatorLabel}${cov})`);
+        }
+      }
       if (recommendations.length) {
-        lines.push("");
-        lines.push("Recommendations:");
-        recommendations.forEach((b) => lines.push(`- ${b}`));
+        lines.push("", "Recommendations:");
+        for (const r of recommendations) lines.push(`- ${r}`);
       }
       return {
-        content: [{ type: "text", text: lines.join("\n") }],
+        content: [{ type: "text", text: lines.join("\n").trim() || "No findings yet." }],
         structuredContent: {
-          status: "ok",
+          status: findings.length ? "ok" : "empty",
+          reached: (_i = data.reached) != null ? _i : "observed",
+          findings: findings.map((f) => ({
+            tier: f.tier,
+            kind: f.kind,
+            headline: f.headline,
+            audience: f.audience,
+            sample: f.provenance.sample,
+            coverage: f.provenance.coverage
+          })),
+          emptyReason,
           observations,
           recommendations,
-          isStale: (_c = data.isStale) != null ? _c : false,
-          generatedAt: (_d = data.generatedAt) != null ? _d : null
+          isStale,
+          generatedAt: (_j = data.generatedAt) != null ? _j : null
         }
       };
     })
@@ -1777,7 +1808,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.14.2" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.15.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-AWRVJ4HY.js";
+} from "./chunk-3RJUYHO7.js";
 
 // src/index.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/lib.cjs

@@ -648,19 +648,38 @@ function registerComponentTools(server, client) {
 
 // src/tools/insights.ts
 var import_zod4 = require("zod");
+var EMPTY_REASON_TEXT = {
+  no_events: "The snippet has not fired yet \u2014 nothing has reached us.",
+  no_traffic_yet: "Test traffic only so far; no genuine visitors yet.",
+  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."
+};
 function registerInsightTools(server, client) {
   server.registerTool(
     "get_insights",
     {
       title: "Get insights",
-      description: "Get the latest AI-generated insights: narrator observations and (Growth tier) advisor recommendations.",
+      description: "What is known about this project right now: ranked findings with the evidence behind each one, plus (Growth tier) advisor recommendations. Says why it is empty when it is.",
       inputSchema: { projectId: projectIdSchema },
       outputSchema: {
-        status: import_zod4.z.enum(["ok", "empty"]).describe("Whether insights exist yet"),
-        observations: import_zod4.z.array(import_zod4.z.string()).describe("Narrator observations"),
-        recommendations: import_zod4.z.array(import_zod4.z.string()).describe("Advisor recommendations (Growth tier)"),
-        isStale: import_zod4.z.boolean().describe("True when the insights are older than ~6h"),
-        generatedAt: import_zod4.z.string().nullable().describe("ISO timestamp the insights were generated, or null")
+        status: import_zod4.z.enum(["ok", "empty"]).describe("Whether any findings exist yet"),
+        reached: import_zod4.z.string().describe("Highest confidence tier earned: observed | patterned | tested"),
+        findings: import_zod4.z.array(import_zod4.z.object({
+          tier: import_zod4.z.string().describe("observed | patterned | tested"),
+          kind: import_zod4.z.string(),
+          headline: import_zod4.z.string(),
+          audience: import_zod4.z.string().nullable(),
+          sample: import_zod4.z.number().describe("How many the finding is based on"),
+          coverage: import_zod4.z.number().nullable().describe("Fraction of traffic this finding describes, when applicable")
+        })).describe("Ranked findings, each with the evidence behind it"),
+        emptyReason: import_zod4.z.string().nullable().describe("Why there is nothing to report, when there is nothing"),
+        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")
       },
       annotations: {
         readOnlyHint: true,
@@ -669,42 +688,54 @@ function registerInsightTools(server, client) {
       }
     },
     withApiErrorGuidance(async ({ projectId }) => {
-      var _a, _b, _c, _d;
+      var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
       const id = encodeURIComponent(projectId);
-      const data = await client.get(`/projects/${id}/insights`);
-      if (data.status === "empty") {
-        return {
-          content: [{ type: "text", text: "No insights generated yet. Use refresh_insights to generate." }],
-          structuredContent: {
-            status: "empty",
-            observations: [],
-            recommendations: [],
-            isStale: false,
-            generatedAt: null
-          }
-        };
-      }
-      const observations = (_a = data.narratorBullets) != null ? _a : [];
-      const recommendations = (_b = data.advisorBullets) != null ? _b : [];
+      const data = await client.get(`/projects/${id}/evidence-report`);
+      const findings = (_a = data.findings) != null ? _a : [];
+      const measured = findings.filter((f) => !f.interpreted);
+      const interpreted = findings.filter((f) => f.interpreted);
+      const observations = measured.map((f) => f.headline);
+      const recommendations = interpreted.map((f) => f.headline);
+      const isStale = (_c = (_b = data.freshness) == null ? void 0 : _b.isStale) != null ? _c : false;
+      const emptyReason = (_d = data.emptyReason) != null ? _d : null;
       const lines = [];
-      if (data.isStale) lines.push("\u26A0 Insights are stale (>6h old). Consider calling refresh_insights.");
+      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 ((_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()}`);
-      lines.push("");
-      lines.push("Observations:");
-      observations.forEach((b) => lines.push(`- ${b}`));
+      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` : "";
+          lines.push(`- [${f.tier}] ${f.headline} (${f.provenance.sample} ${f.provenance.denominatorLabel}${cov})`);
+        }
+      }
       if (recommendations.length) {
-        lines.push("");
-        lines.push("Recommendations:");
-        recommendations.forEach((b) => lines.push(`- ${b}`));
+        lines.push("", "Recommendations:");
+        for (const r of recommendations) lines.push(`- ${r}`);
       }
       return {
-        content: [{ type: "text", text: lines.join("\n") }],
+        content: [{ type: "text", text: lines.join("\n").trim() || "No findings yet." }],
         structuredContent: {
-          status: "ok",
+          status: findings.length ? "ok" : "empty",
+          reached: (_i = data.reached) != null ? _i : "observed",
+          findings: findings.map((f) => ({
+            tier: f.tier,
+            kind: f.kind,
+            headline: f.headline,
+            audience: f.audience,
+            sample: f.provenance.sample,
+            coverage: f.provenance.coverage
+          })),
+          emptyReason,
           observations,
           recommendations,
-          isStale: (_c = data.isStale) != null ? _c : false,
-          generatedAt: (_d = data.generatedAt) != null ? _d : null
+          isStale,
+          generatedAt: (_j = data.generatedAt) != null ? _j : null
         }
       };
     })
@@ -1801,7 +1832,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.14.2" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.15.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-AWRVJ4HY.js";
+} from "./chunk-3RJUYHO7.js";
 export {
   ApiClient,
   ApiError,

package/package.json

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