@sentientui/mcp 0.21.0 → 0.22.0

package/dist/{chunk-K7JN3LOH.js → chunk-A7LJWTYQ.js}

@@ -1627,7 +1627,7 @@ function registerGuardrailTools(server, client) {
     "list_guardrail_events",
     {
       title: "List guardrail events",
-      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,
+      description: "List every variant currently paused (a paused variant stops serving until unpaused, however long ago the pause fired). `source` says who paused it: 'guardrail' = automatically, for converting clearly worse; 'manual' = a teammate paused it by hand (do not suggest resuming those without asking who paused them). 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.")
@@ -1636,9 +1636,10 @@ function registerGuardrailTools(server, client) {
         events: z8.array(
           z8.object({
             componentId: z8.string(),
-            variantIds: z8.array(z8.string()).describe("Variants paused by the guardrail"),
+            variantIds: z8.array(z8.string()).describe("Variants paused together"),
             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")
+            funnelId: z8.string().nullable().describe("Set when the pause came from a funnel guardrail"),
+            source: z8.enum(["guardrail", "manual"]).describe("'guardrail' = paused automatically; 'manual' = paused by a teammate")
           })
         ).describe("Currently paused variants (empty if none)")
       },
@@ -1654,24 +1655,25 @@ function registerGuardrailTools(server, client) {
       const data = await client.get(`/projects/${id}/guardrail-events${query}`);
       const structuredContent = {
         events: data.guardrailEvents.map((e) => {
-          var _a;
+          var _a, _b;
           return {
             componentId: e.componentId,
             variantIds: e.variantIds,
             pausedAt: e.pausedAt,
-            funnelId: (_a = e.funnelId) != null ? _a : null
+            funnelId: (_a = e.funnelId) != null ? _a : null,
+            source: (_b = e.source) != null ? _b : "guardrail"
           };
         })
       };
       if (!data.guardrailEvents.length) {
-        const scope = days != null ? `paused by a guardrail in the last ${days} days` : "currently paused by a guardrail";
+        const scope = days != null ? `paused in the last ${days} days` : "currently paused";
         return {
           content: [{ type: "text", text: `No variants ${scope}.` }],
           structuredContent
         };
       }
-      const lines = data.guardrailEvents.map(
-        (e) => `- ${untrusted(e.componentId)}: variants [${e.variantIds.map((v) => untrusted(v)).join(", ")}] paused${e.pausedAt ? ` at ${e.pausedAt}` : ""}${e.funnelId ? ` (protecting the ${untrusted(e.funnelId)} funnel)` : ""}`
+      const lines = structuredContent.events.map(
+        (e) => `- ${untrusted(e.componentId)}: variants [${e.variantIds.map((v) => untrusted(v)).join(", ")}] ${e.source === "manual" ? "paused by a teammate" : "paused automatically by a guardrail"}${e.pausedAt ? ` at ${e.pausedAt}` : ""}${e.funnelId ? ` (protecting the ${untrusted(e.funnelId)} funnel)` : ""}`
       );
       return { content: [{ type: "text", text: lines.join("\n") }], structuredContent };
     })
@@ -2936,7 +2938,8 @@ function registerCellTools(server, client) {
             refinedFrom: z15.string().nullable().describe("Live version this one would replace; that version keeps serving until approval"),
             updatedAt: z15.string()
           })
-        )
+        ),
+        total: z15.number().int().describe("How many versions are waiting in all. The list holds at most the oldest 200; decide those to see the rest.")
       },
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
@@ -2957,10 +2960,11 @@ function registerCellTools(server, client) {
           updatedAt: String(r.updatedAt)
         };
       });
+      const total = typeof data.total === "number" ? data.total : reviews.length;
       if (reviews.length === 0) {
         return {
           content: [{ type: "text", text: "No generated versions are waiting for review." }],
-          structuredContent: { reviews }
+          structuredContent: { reviews, total }
         };
       }
       const lines = reviews.map(
@@ -2971,8 +2975,11 @@ function registerCellTools(server, client) {
           r.refinedFrom ? `  Would replace ${untrusted(r.refinedFrom, 64)}, which keeps serving until approval.` : null
         ].filter((l) => l !== null).join("\n")
       );
+      if (total > reviews.length) {
+        lines.unshift(`Showing the ${reviews.length} oldest of ${total} versions waiting. Decide on these to see the rest.`, "");
+      }
       lines.push("", "Approve or reject each with review_cell (slotId + persona) once the user has decided.");
-      return { content: [{ type: "text", text: lines.join("\n") }], structuredContent: { reviews } };
+      return { content: [{ type: "text", text: lines.join("\n") }], structuredContent: { reviews, total } };
     })
   );
   server.registerTool(
@@ -3019,7 +3026,7 @@ function registerCellTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.21.0" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.22.0" : "0.0.0-dev";
 function createMcpServer(client) {
   const server = new McpServer(
     {

package/dist/index.cjs

@@ -1631,7 +1631,7 @@ function registerGuardrailTools(server, client) {
     "list_guardrail_events",
     {
       title: "List guardrail events",
-      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,
+      description: "List every variant currently paused (a paused variant stops serving until unpaused, however long ago the pause fired). `source` says who paused it: 'guardrail' = automatically, for converting clearly worse; 'manual' = a teammate paused it by hand (do not suggest resuming those without asking who paused them). 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.")
@@ -1640,9 +1640,10 @@ function registerGuardrailTools(server, client) {
         events: import_zod8.z.array(
           import_zod8.z.object({
             componentId: import_zod8.z.string(),
-            variantIds: import_zod8.z.array(import_zod8.z.string()).describe("Variants paused by the guardrail"),
+            variantIds: import_zod8.z.array(import_zod8.z.string()).describe("Variants paused together"),
             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")
+            funnelId: import_zod8.z.string().nullable().describe("Set when the pause came from a funnel guardrail"),
+            source: import_zod8.z.enum(["guardrail", "manual"]).describe("'guardrail' = paused automatically; 'manual' = paused by a teammate")
           })
         ).describe("Currently paused variants (empty if none)")
       },
@@ -1658,24 +1659,25 @@ function registerGuardrailTools(server, client) {
       const data = await client.get(`/projects/${id}/guardrail-events${query}`);
       const structuredContent = {
         events: data.guardrailEvents.map((e) => {
-          var _a2;
+          var _a2, _b;
           return {
             componentId: e.componentId,
             variantIds: e.variantIds,
             pausedAt: e.pausedAt,
-            funnelId: (_a2 = e.funnelId) != null ? _a2 : null
+            funnelId: (_a2 = e.funnelId) != null ? _a2 : null,
+            source: (_b = e.source) != null ? _b : "guardrail"
           };
         })
       };
       if (!data.guardrailEvents.length) {
-        const scope = days != null ? `paused by a guardrail in the last ${days} days` : "currently paused by a guardrail";
+        const scope = days != null ? `paused in the last ${days} days` : "currently paused";
         return {
           content: [{ type: "text", text: `No variants ${scope}.` }],
           structuredContent
         };
       }
-      const lines = data.guardrailEvents.map(
-        (e) => `- ${untrusted(e.componentId)}: variants [${e.variantIds.map((v) => untrusted(v)).join(", ")}] paused${e.pausedAt ? ` at ${e.pausedAt}` : ""}${e.funnelId ? ` (protecting the ${untrusted(e.funnelId)} funnel)` : ""}`
+      const lines = structuredContent.events.map(
+        (e) => `- ${untrusted(e.componentId)}: variants [${e.variantIds.map((v) => untrusted(v)).join(", ")}] ${e.source === "manual" ? "paused by a teammate" : "paused automatically by a guardrail"}${e.pausedAt ? ` at ${e.pausedAt}` : ""}${e.funnelId ? ` (protecting the ${untrusted(e.funnelId)} funnel)` : ""}`
       );
       return { content: [{ type: "text", text: lines.join("\n") }], structuredContent };
     })
@@ -2940,7 +2942,8 @@ function registerCellTools(server, client) {
             refinedFrom: import_zod15.z.string().nullable().describe("Live version this one would replace; that version keeps serving until approval"),
             updatedAt: import_zod15.z.string()
           })
-        )
+        ),
+        total: import_zod15.z.number().int().describe("How many versions are waiting in all. The list holds at most the oldest 200; decide those to see the rest.")
       },
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
@@ -2961,10 +2964,11 @@ function registerCellTools(server, client) {
           updatedAt: String(r.updatedAt)
         };
       });
+      const total = typeof data.total === "number" ? data.total : reviews.length;
       if (reviews.length === 0) {
         return {
           content: [{ type: "text", text: "No generated versions are waiting for review." }],
-          structuredContent: { reviews }
+          structuredContent: { reviews, total }
         };
       }
       const lines = reviews.map(
@@ -2975,8 +2979,11 @@ function registerCellTools(server, client) {
           r.refinedFrom ? `  Would replace ${untrusted(r.refinedFrom, 64)}, which keeps serving until approval.` : null
         ].filter((l) => l !== null).join("\n")
       );
+      if (total > reviews.length) {
+        lines.unshift(`Showing the ${reviews.length} oldest of ${total} versions waiting. Decide on these to see the rest.`, "");
+      }
       lines.push("", "Approve or reject each with review_cell (slotId + persona) once the user has decided.");
-      return { content: [{ type: "text", text: lines.join("\n") }], structuredContent: { reviews } };
+      return { content: [{ type: "text", text: lines.join("\n") }], structuredContent: { reviews, total } };
     })
   );
   server.registerTool(
@@ -3023,7 +3030,7 @@ function registerCellTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.21.0" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.22.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-K7JN3LOH.js";
+} from "./chunk-A7LJWTYQ.js";
 
 // src/index.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/lib.cjs

@@ -1657,7 +1657,7 @@ function registerGuardrailTools(server, client) {
     "list_guardrail_events",
     {
       title: "List guardrail events",
-      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,
+      description: "List every variant currently paused (a paused variant stops serving until unpaused, however long ago the pause fired). `source` says who paused it: 'guardrail' = automatically, for converting clearly worse; 'manual' = a teammate paused it by hand (do not suggest resuming those without asking who paused them). 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.")
@@ -1666,9 +1666,10 @@ function registerGuardrailTools(server, client) {
         events: import_zod8.z.array(
           import_zod8.z.object({
             componentId: import_zod8.z.string(),
-            variantIds: import_zod8.z.array(import_zod8.z.string()).describe("Variants paused by the guardrail"),
+            variantIds: import_zod8.z.array(import_zod8.z.string()).describe("Variants paused together"),
             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")
+            funnelId: import_zod8.z.string().nullable().describe("Set when the pause came from a funnel guardrail"),
+            source: import_zod8.z.enum(["guardrail", "manual"]).describe("'guardrail' = paused automatically; 'manual' = paused by a teammate")
           })
         ).describe("Currently paused variants (empty if none)")
       },
@@ -1684,24 +1685,25 @@ function registerGuardrailTools(server, client) {
       const data = await client.get(`/projects/${id}/guardrail-events${query}`);
       const structuredContent = {
         events: data.guardrailEvents.map((e) => {
-          var _a;
+          var _a, _b;
           return {
             componentId: e.componentId,
             variantIds: e.variantIds,
             pausedAt: e.pausedAt,
-            funnelId: (_a = e.funnelId) != null ? _a : null
+            funnelId: (_a = e.funnelId) != null ? _a : null,
+            source: (_b = e.source) != null ? _b : "guardrail"
           };
         })
       };
       if (!data.guardrailEvents.length) {
-        const scope = days != null ? `paused by a guardrail in the last ${days} days` : "currently paused by a guardrail";
+        const scope = days != null ? `paused in the last ${days} days` : "currently paused";
         return {
           content: [{ type: "text", text: `No variants ${scope}.` }],
           structuredContent
         };
       }
-      const lines = data.guardrailEvents.map(
-        (e) => `- ${untrusted(e.componentId)}: variants [${e.variantIds.map((v) => untrusted(v)).join(", ")}] paused${e.pausedAt ? ` at ${e.pausedAt}` : ""}${e.funnelId ? ` (protecting the ${untrusted(e.funnelId)} funnel)` : ""}`
+      const lines = structuredContent.events.map(
+        (e) => `- ${untrusted(e.componentId)}: variants [${e.variantIds.map((v) => untrusted(v)).join(", ")}] ${e.source === "manual" ? "paused by a teammate" : "paused automatically by a guardrail"}${e.pausedAt ? ` at ${e.pausedAt}` : ""}${e.funnelId ? ` (protecting the ${untrusted(e.funnelId)} funnel)` : ""}`
       );
       return { content: [{ type: "text", text: lines.join("\n") }], structuredContent };
     })
@@ -2966,7 +2968,8 @@ function registerCellTools(server, client) {
             refinedFrom: import_zod15.z.string().nullable().describe("Live version this one would replace; that version keeps serving until approval"),
             updatedAt: import_zod15.z.string()
           })
-        )
+        ),
+        total: import_zod15.z.number().int().describe("How many versions are waiting in all. The list holds at most the oldest 200; decide those to see the rest.")
       },
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
@@ -2987,10 +2990,11 @@ function registerCellTools(server, client) {
           updatedAt: String(r.updatedAt)
         };
       });
+      const total = typeof data.total === "number" ? data.total : reviews.length;
       if (reviews.length === 0) {
         return {
           content: [{ type: "text", text: "No generated versions are waiting for review." }],
-          structuredContent: { reviews }
+          structuredContent: { reviews, total }
         };
       }
       const lines = reviews.map(
@@ -3001,8 +3005,11 @@ function registerCellTools(server, client) {
           r.refinedFrom ? `  Would replace ${untrusted(r.refinedFrom, 64)}, which keeps serving until approval.` : null
         ].filter((l) => l !== null).join("\n")
       );
+      if (total > reviews.length) {
+        lines.unshift(`Showing the ${reviews.length} oldest of ${total} versions waiting. Decide on these to see the rest.`, "");
+      }
       lines.push("", "Approve or reject each with review_cell (slotId + persona) once the user has decided.");
-      return { content: [{ type: "text", text: lines.join("\n") }], structuredContent: { reviews } };
+      return { content: [{ type: "text", text: lines.join("\n") }], structuredContent: { reviews, total } };
     })
   );
   server.registerTool(
@@ -3049,7 +3056,7 @@ function registerCellTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.21.0" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.22.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-K7JN3LOH.js";
+} from "./chunk-A7LJWTYQ.js";
 
 // src/tool-catalog.ts
 var TOOL_CATALOG = [

package/package.json

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