@sentientui/mcp 0.14.1 → 0.15.0

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

@@ -65,196 +65,6 @@ var ApiClient = class {
   }
 };
 
-// src/server.ts
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-
-// src/tools/projects.ts
-import { z as z2 } from "zod";
-
-// src/tools/common.ts
-import { z } from "zod";
-var projectIdSchema = z.string().uuid().describe("The project UUID");
-function apiErrorGuidance(err, extra) {
-  if (extra && Object.prototype.hasOwnProperty.call(extra, err.message)) {
-    return extra[err.message];
-  }
-  switch (err.message) {
-    case "insufficient_scope":
-      return "This action needs an account login. Connect via the hosted MCP URL (https://api.sentient-ui.com/mcp) and sign in \u2014 a project-scoped server key (sk_\u2026) or anonymous demo token cannot do this.";
-    case "demo_read_only":
-      return "Demo mode is read-only. Create a SentientUI account and sign in (or use a project server key) to make changes.";
-    case "insufficient_role":
-      return "Your account role does not permit this action \u2014 it needs the account owner or an admin.";
-    default:
-      break;
-  }
-  if (err.status === 402) {
-    return `This feature requires a higher plan (${err.message}). Upgrade your SentientUI plan, then try again.`;
-  }
-  if (err.status === 403) {
-    return `Access denied (${err.message}). Check that your key or login has access to this project.`;
-  }
-  return null;
-}
-function withApiErrorGuidance(fn, extra) {
-  return async (args) => {
-    try {
-      return await fn(args);
-    } catch (err) {
-      if (err instanceof ApiError) {
-        const guidance = apiErrorGuidance(err, extra);
-        if (guidance) {
-          return { content: [{ type: "text", text: guidance }], isError: true };
-        }
-      }
-      throw err;
-    }
-  };
-}
-
-// src/tools/projects.ts
-var CREATE_PROJECT_GUIDANCE = {
-  project_limit_reached: "You've reached your plan's project limit. Upgrade your plan or remove an existing project, then try again.",
-  name_required: "A project name is required to create a project."
-};
-function registerProjectTools(server, client) {
-  server.registerTool(
-    "create_project",
-    {
-      title: "Create project",
-      description: "Create a NEW SentientUI project (onboarding). Returns the project id and its pk_ public key for the SDK. Requires an account login: this works when connected via OAuth (the hosted MCP URL) but NOT with a project-scoped sk_ server key or an anonymous demo token. After it succeeds, call get_integration_guide and help the user install @sentientui/react with the returned key.",
-      inputSchema: {
-        name: z2.string().min(1).describe("Human-readable project name"),
-        contextType: z2.enum(["saas", "ecommerce", "marketing", "landing", "internal"]).optional().describe("What kind of product this is; defaults to saas"),
-        framework: z2.enum(["next", "react", "core"]).optional().describe("How the site is built \u2014 next, react, or core (website builder/CMS); defaults to next"),
-        websiteUrl: z2.string().optional().describe("Production site origin to allow-list so the SDK's events aren't origin-blocked on day one")
-      },
-      outputSchema: {
-        projectId: z2.string().describe("The new project UUID"),
-        publicKey: z2.string().describe("The pk_ public key to configure the SDK with"),
-        name: z2.string().describe("The project name"),
-        contextType: z2.string().describe("The resolved context type")
-      },
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: false,
-        idempotentHint: false,
-        openWorldHint: false
-      }
-    },
-    withApiErrorGuidance(async ({ name, contextType, framework, websiteUrl }) => {
-      const created = await client.post("/projects", {
-        name,
-        contextType,
-        framework,
-        origin: websiteUrl
-      });
-      const resolvedContextType = contextType != null ? contextType : "saas";
-      return {
-        content: [{
-          type: "text",
-          text: [
-            `Created project "${name}" (id: ${created.id}, type: ${resolvedContextType}).`,
-            `Public key: ${created.apiKey}`,
-            `Next: install @sentientui/react with this key. Ask me to pull the setup guide (get_integration_guide) and I'll wrap your first component.`
-          ].join("\n")
-        }],
-        structuredContent: {
-          projectId: created.id,
-          publicKey: created.apiKey,
-          name,
-          contextType: resolvedContextType
-        }
-      };
-    }, CREATE_PROJECT_GUIDANCE)
-  );
-  server.registerTool(
-    "list_projects",
-    {
-      title: "List projects",
-      description: "List all SentientUI projects for the authenticated account.",
-      inputSchema: {},
-      outputSchema: {
-        projects: z2.array(
-          z2.object({
-            id: z2.string().describe("Project UUID"),
-            name: z2.string(),
-            contextType: z2.string(),
-            createdAt: z2.string().describe("ISO date (YYYY-MM-DD)")
-          })
-        ).describe("All projects for the account (empty if none)")
-      },
-      annotations: {
-        readOnlyHint: true,
-        idempotentHint: true,
-        openWorldHint: false
-      }
-    },
-    withApiErrorGuidance(async () => {
-      const projects = await client.get("/projects");
-      const text = projects.length === 0 ? "No projects found." : projects.map(
-        (p) => `- ${p.name} (id: ${p.id}, type: ${p.context_type}, created: ${p.created_at.slice(0, 10)})`
-      ).join("\n");
-      return {
-        content: [{ type: "text", text }],
-        structuredContent: {
-          projects: projects.map((p) => ({
-            id: p.id,
-            name: p.name,
-            contextType: p.context_type,
-            createdAt: p.created_at.slice(0, 10)
-          }))
-        }
-      };
-    })
-  );
-  server.registerTool(
-    "get_project_stats",
-    {
-      title: "Project health stats",
-      description: "Get health stats for a project: event volume, session count, agent calls, and status.",
-      inputSchema: { projectId: projectIdSchema },
-      outputSchema: {
-        status: z2.string().describe("Overall project health status"),
-        events24h: z2.number().describe("Events in the last 24 hours"),
-        sessions24h: z2.number().describe("Sessions in the last 24 hours"),
-        agentCalls: z2.number().describe("Total agent (MCP/API) calls"),
-        lastEventAt: z2.string().nullable().describe("ISO timestamp of the last event, or null")
-      },
-      annotations: {
-        readOnlyHint: true,
-        idempotentHint: true,
-        openWorldHint: false
-      }
-    },
-    withApiErrorGuidance(async ({ projectId }) => {
-      var _a;
-      const id = encodeURIComponent(projectId);
-      const stats = await client.get(`/projects/${id}/health`);
-      const text = [
-        `Status: ${stats.status}`,
-        `Events (24h): ${stats.events24h}`,
-        `Sessions (24h): ${stats.sessions24h}`,
-        `Agent calls (total): ${stats.agentCalls}`,
-        `Last event: ${(_a = stats.lastEventAt) != null ? _a : "never"}`
-      ].join("\n");
-      return {
-        content: [{ type: "text", text }],
-        structuredContent: {
-          status: stats.status,
-          events24h: stats.events24h,
-          sessions24h: stats.sessions24h,
-          agentCalls: stats.agentCalls,
-          lastEventAt: stats.lastEventAt
-        }
-      };
-    })
-  );
-}
-
-// src/tools/components.ts
-import { z as z3 } from "zod";
-
 // src/ui/templates.ts
 var VIZ_TITLES = {
   "persona-breakdown": "Persona breakdown",
@@ -488,6 +298,7 @@ function uiMeta(id) {
     "openai/outputTemplate": uri
   };
 }
+var PUBLIC_UI_RESOURCE_URIS = Object.values(UI_TOOL_VIZ).map(uiResourceUri);
 function registerUiResources(server) {
   for (const id of Object.values(UI_TOOL_VIZ)) {
     server.registerResource(
@@ -511,7 +322,195 @@ function registerUiResources(server) {
   }
 }
 
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+// src/tools/projects.ts
+import { z as z2 } from "zod";
+
+// src/tools/common.ts
+import { z } from "zod";
+var projectIdSchema = z.string().uuid().describe("The project UUID");
+function apiErrorGuidance(err, extra) {
+  if (extra && Object.prototype.hasOwnProperty.call(extra, err.message)) {
+    return extra[err.message];
+  }
+  switch (err.message) {
+    case "insufficient_scope":
+      return "This action needs an account login. Connect via the hosted MCP URL (https://api.sentient-ui.com/mcp) and sign in \u2014 a project-scoped server key (sk_\u2026) or anonymous demo token cannot do this.";
+    case "demo_read_only":
+      return "Demo mode is read-only. Create a SentientUI account and sign in (or use a project server key) to make changes.";
+    case "insufficient_role":
+      return "Your account role does not permit this action \u2014 it needs the account owner or an admin.";
+    default:
+      break;
+  }
+  if (err.status === 402) {
+    return `This feature requires a higher plan (${err.message}). Upgrade your SentientUI plan, then try again.`;
+  }
+  if (err.status === 403) {
+    return `Access denied (${err.message}). Check that your key or login has access to this project.`;
+  }
+  return null;
+}
+function withApiErrorGuidance(fn, extra) {
+  return async (args) => {
+    try {
+      return await fn(args);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        const guidance = apiErrorGuidance(err, extra);
+        if (guidance) {
+          return { content: [{ type: "text", text: guidance }], isError: true };
+        }
+      }
+      throw err;
+    }
+  };
+}
+
+// src/tools/projects.ts
+var CREATE_PROJECT_GUIDANCE = {
+  project_limit_reached: "You've reached your plan's project limit. Upgrade your plan or remove an existing project, then try again.",
+  name_required: "A project name is required to create a project."
+};
+function registerProjectTools(server, client) {
+  server.registerTool(
+    "create_project",
+    {
+      title: "Create project",
+      description: "Create a NEW SentientUI project (onboarding). Returns the project id and its pk_ public key for the SDK. Requires an account login: this works when connected via OAuth (the hosted MCP URL) but NOT with a project-scoped sk_ server key or an anonymous demo token. After it succeeds, call get_integration_guide and help the user install @sentientui/react with the returned key.",
+      inputSchema: {
+        name: z2.string().min(1).describe("Human-readable project name"),
+        contextType: z2.enum(["saas", "ecommerce", "marketing", "landing", "internal"]).optional().describe("What kind of product this is; defaults to saas"),
+        framework: z2.enum(["next", "react", "core"]).optional().describe("How the site is built \u2014 next, react, or core (website builder/CMS); defaults to next"),
+        websiteUrl: z2.string().optional().describe("Production site origin to allow-list so the SDK's events aren't origin-blocked on day one")
+      },
+      outputSchema: {
+        projectId: z2.string().describe("The new project UUID"),
+        publicKey: z2.string().describe("The pk_ public key to configure the SDK with"),
+        name: z2.string().describe("The project name"),
+        contextType: z2.string().describe("The resolved context type")
+      },
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false
+      }
+    },
+    withApiErrorGuidance(async ({ name, contextType, framework, websiteUrl }) => {
+      const created = await client.post("/projects", {
+        name,
+        contextType,
+        framework,
+        origin: websiteUrl
+      });
+      const resolvedContextType = contextType != null ? contextType : "saas";
+      return {
+        content: [{
+          type: "text",
+          text: [
+            `Created project "${name}" (id: ${created.id}, type: ${resolvedContextType}).`,
+            `Public key: ${created.apiKey}`,
+            `Next: install @sentientui/react with this key. Ask me to pull the setup guide (get_integration_guide) and I'll wrap your first component.`
+          ].join("\n")
+        }],
+        structuredContent: {
+          projectId: created.id,
+          publicKey: created.apiKey,
+          name,
+          contextType: resolvedContextType
+        }
+      };
+    }, CREATE_PROJECT_GUIDANCE)
+  );
+  server.registerTool(
+    "list_projects",
+    {
+      title: "List projects",
+      description: "List all SentientUI projects for the authenticated account.",
+      inputSchema: {},
+      outputSchema: {
+        projects: z2.array(
+          z2.object({
+            id: z2.string().describe("Project UUID"),
+            name: z2.string(),
+            contextType: z2.string(),
+            createdAt: z2.string().describe("ISO date (YYYY-MM-DD)")
+          })
+        ).describe("All projects for the account (empty if none)")
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    withApiErrorGuidance(async () => {
+      const projects = await client.get("/projects");
+      const text = projects.length === 0 ? "No projects found." : projects.map(
+        (p) => `- ${p.name} (id: ${p.id}, type: ${p.context_type}, created: ${p.created_at.slice(0, 10)})`
+      ).join("\n");
+      return {
+        content: [{ type: "text", text }],
+        structuredContent: {
+          projects: projects.map((p) => ({
+            id: p.id,
+            name: p.name,
+            contextType: p.context_type,
+            createdAt: p.created_at.slice(0, 10)
+          }))
+        }
+      };
+    })
+  );
+  server.registerTool(
+    "get_project_stats",
+    {
+      title: "Project health stats",
+      description: "Get health stats for a project: event volume, session count, agent calls, and status.",
+      inputSchema: { projectId: projectIdSchema },
+      outputSchema: {
+        status: z2.string().describe("Overall project health status"),
+        events24h: z2.number().describe("Events in the last 24 hours"),
+        sessions24h: z2.number().describe("Sessions in the last 24 hours"),
+        agentCalls: z2.number().describe("Total agent (MCP/API) calls"),
+        lastEventAt: z2.string().nullable().describe("ISO timestamp of the last event, or null")
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    withApiErrorGuidance(async ({ projectId }) => {
+      var _a;
+      const id = encodeURIComponent(projectId);
+      const stats = await client.get(`/projects/${id}/health`);
+      const text = [
+        `Status: ${stats.status}`,
+        `Events (24h): ${stats.events24h}`,
+        `Sessions (24h): ${stats.sessions24h}`,
+        `Agent calls (total): ${stats.agentCalls}`,
+        `Last event: ${(_a = stats.lastEventAt) != null ? _a : "never"}`
+      ].join("\n");
+      return {
+        content: [{ type: "text", text }],
+        structuredContent: {
+          status: stats.status,
+          events24h: stats.events24h,
+          sessions24h: stats.sessions24h,
+          agentCalls: stats.agentCalls,
+          lastEventAt: stats.lastEventAt
+        }
+      };
+    })
+  );
+}
+
 // src/tools/components.ts
+import { z as z3 } from "zod";
 function registerComponentTools(server, client) {
   server.registerTool(
     "list_components",
@@ -619,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,
@@ -640,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
         }
       };
     })
@@ -1772,7 +1802,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.14.1" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.15.0" : "0.0.0-dev";
 function createMcpServer(client) {
   const server = new McpServer(
     {
@@ -1813,5 +1843,6 @@ function createMcpServer(client) {
 export {
   ApiError,
   ApiClient,
+  PUBLIC_UI_RESOURCE_URIS,
   createMcpServer
 };

package/dist/index.cjs

@@ -492,6 +492,7 @@ function uiMeta(id) {
     "openai/outputTemplate": uri
   };
 }
+var PUBLIC_UI_RESOURCE_URIS = Object.values(UI_TOOL_VIZ).map(uiResourceUri);
 function registerUiResources(server) {
   for (const id of Object.values(UI_TOOL_VIZ)) {
     server.registerResource(
@@ -623,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,
@@ -644,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
         }
       };
     })
@@ -1776,7 +1808,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.14.1" : "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-O335LMWF.js";
+} from "./chunk-3RJUYHO7.js";
 
 // src/index.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/lib.cjs

@@ -40,6 +40,7 @@ var lib_exports = {};
 __export(lib_exports, {
   ApiClient: () => ApiClient,
   ApiError: () => ApiError,
+  PUBLIC_UI_RESOURCE_URIS: () => PUBLIC_UI_RESOURCE_URIS,
   createMcpServer: () => createMcpServer
 });
 module.exports = __toCommonJS(lib_exports);
@@ -515,6 +516,7 @@ function uiMeta(id) {
     "openai/outputTemplate": uri
   };
 }
+var PUBLIC_UI_RESOURCE_URIS = Object.values(UI_TOOL_VIZ).map(uiResourceUri);
 function registerUiResources(server) {
   for (const id of Object.values(UI_TOOL_VIZ)) {
     server.registerResource(
@@ -646,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,
@@ -667,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
         }
       };
     })
@@ -1799,7 +1832,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.14.1" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.15.0" : "0.0.0-dev";
 function createMcpServer(client) {
   const server = new import_mcp.McpServer(
     {
@@ -1840,5 +1873,6 @@ function createMcpServer(client) {
 0 && (module.exports = {
   ApiClient,
   ApiError,
+  PUBLIC_UI_RESOURCE_URIS,
   createMcpServer
 });

package/dist/lib.d.cts

@@ -17,4 +17,15 @@ declare class ApiClient {
 
 declare function createMcpServer(client: ApiClient): McpServer;
 
-export { ApiClient, ApiError, createMcpServer };
+/**
+ * Every `ui://` resource this server registers. These templates are static HTML
+ * — no project data, no API call — so a host may read them before the user has
+ * authenticated. The remote /mcp endpoint uses this set to allow an
+ * unauthenticated `resources/read` for exactly these URIs (see
+ * apps/api/src/routes/mcp.ts): without it, `resources/list` advertised four
+ * resources that every reader got a 401 for, which reads to an agent as a
+ * server whose resources are all broken.
+ */
+declare const PUBLIC_UI_RESOURCE_URIS: readonly string[];
+
+export { ApiClient, ApiError, PUBLIC_UI_RESOURCE_URIS, createMcpServer };

package/dist/lib.d.ts

@@ -17,4 +17,15 @@ declare class ApiClient {
 
 declare function createMcpServer(client: ApiClient): McpServer;
 
-export { ApiClient, ApiError, createMcpServer };
+/**
+ * Every `ui://` resource this server registers. These templates are static HTML
+ * — no project data, no API call — so a host may read them before the user has
+ * authenticated. The remote /mcp endpoint uses this set to allow an
+ * unauthenticated `resources/read` for exactly these URIs (see
+ * apps/api/src/routes/mcp.ts): without it, `resources/list` advertised four
+ * resources that every reader got a 401 for, which reads to an agent as a
+ * server whose resources are all broken.
+ */
+declare const PUBLIC_UI_RESOURCE_URIS: readonly string[];
+
+export { ApiClient, ApiError, PUBLIC_UI_RESOURCE_URIS, createMcpServer };

package/dist/lib.js

@@ -2,10 +2,12 @@
 import {
   ApiClient,
   ApiError,
+  PUBLIC_UI_RESOURCE_URIS,
   createMcpServer
-} from "./chunk-O335LMWF.js";
+} from "./chunk-3RJUYHO7.js";
 export {
   ApiClient,
   ApiError,
+  PUBLIC_UI_RESOURCE_URIS,
   createMcpServer
 };

package/package.json

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