@secondlayer/sentinel 0.6.0 → 0.7.0

package/dist/cli.js

@@ -92,6 +92,7 @@ function runPhase(run) {
   const last = run.events.at(-1);
   return last ? [last.name ?? last.kind, last.state].filter(Boolean).join(" ") : "starting";
 }
+var WATCH_NOTE_MAX = 500;
 var rowsOf = (intents) => intents.flatMap((i) => i.rows);
 var subjectKey = (s) => s.kind === "fn" ? `fn:${s.fn}` : s.kind === "group" ? `group:${s.group}` : `asset:${s.asset}`;
 var CONTROL_NAME = "Control changes";
@@ -209,6 +210,8 @@ function changeText(c) {
     case "muted":
     case "cooldown":
       return `${c.watch.title}: ${c.action === "muted" ? "mute" : "cooldown"} ${c.note ?? ""}`.trim();
+    case "note":
+      return `${c.watch.title}: note ${c.note ?? "set"}`;
     case "applied":
       if (c.prevRule && c.rule)
         return `${name} rule changed: ${rule(c.prevRule)} → ${rule(c.rule)}`;
@@ -265,6 +268,7 @@ function createClient(opts) {
       on
     }),
     mute: (planId, watchId, mutedUntil) => call("POST", `${appPlan(planId)}/watches/${encodeURIComponent(watchId)}/delivery`, { mutedUntil }),
+    setWatchNote: (planId, watchId, note) => call("POST", `${appPlan(planId)}/watches/${encodeURIComponent(watchId)}/delivery`, { note }),
     muteAlert: (alertId, hours) => call("POST", `/alerts/${encodeURIComponent(alertId)}/mute`, { hours }),
     parseRule: (planId, subject, text) => call("POST", `${appPlan(planId)}/rules/parse`, { subject, text }),
     monitorSettings: (planId, settings) => call("POST", `${appPlan(planId)}/monitor`, settings),
@@ -906,6 +910,7 @@ monitoring (a write only happens with --yes; without it you see what would chang
   watches <plan> [--json]                        subjects, rules, status, mutes
   rule <plan> <subject> "<sentence>" [--yes]     read the sentence; --yes adds or edits the rules it found
   watch on|off <plan> <subject> [--yes]          on and off apply now
+  watch-note <plan> <subject> "<text>"|--clear [--yes]   the note sent with this watch's alerts (500 characters)
   mute <plan> <subject> [1h|24h|7d] [--yes]      default 24h
   unmute <plan> <subject> [--yes]
   mute-alert <alert> [1h|24h|7d] [--yes]         mute the watch behind an alert
@@ -1241,6 +1246,7 @@ No run command: no PoC is stored for this finding.`);
         return await monitoringMore(cmd, args.slice(1), flags, values, io, usage);
       case "watches":
       case "rule":
+      case "watch-note":
       case "mute":
       case "unmute":
       case "mute-alert":
@@ -1434,6 +1440,9 @@ async function monitoring(cmd, pos, on, flags, values, io, usage) {
       io.out([i.title, i.tag, i.on ? "on" : "off", intentLine(i), muted ? `muted until ${muted}` : ""].filter(Boolean).join("  "));
       for (const w of i.rows)
         io.out(`  ${w.status.padEnd(14)}${ruleSummary(w.rule, w.units)}`);
+      const note = i.rows.map((w) => w.delivery.note).find(Boolean);
+      if (note)
+        io.out(`  note: ${note}`);
     }
     return 0;
   }
@@ -1507,6 +1516,21 @@ async function monitoring(cmd, pos, on, flags, values, io, usage) {
     io.out(`${willDo} ${effect}`);
     return 0;
   }
+  if (cmd === "watch-note") {
+    const clear = flags.includes("--clear");
+    if (clear === (third !== undefined))
+      return usage("watch-note takes a note in quotes, or --clear");
+    const note = clear ? null : (third ?? "").trim();
+    if (note !== null && note.length > WATCH_NOTE_MAX)
+      return usage(`Keep the note under ${WATCH_NOTE_MAX} characters`);
+    const willDo = note ? `Send this note with ${g.name}'s alerts: ${note}` : `Clear the note on ${g.name}.`;
+    if (previewOnly(io, flags, willDo, "Takes effect now."))
+      return 0;
+    for (const w of g.watches)
+      await io.client.setWatchNote(planId, w.id, note);
+    io.out(note ? `Note set on ${g.name}.` : `Note cleared on ${g.name}.`);
+    return 0;
+  }
   const mute = cmd === "mute";
   const dur = third ?? "24h";
   if (mute && !(dur in DURATIONS))

package/dist/index.js

@@ -86,6 +86,7 @@ function runPhase(run) {
   const last = run.events.at(-1);
   return last ? [last.name ?? last.kind, last.state].filter(Boolean).join(" ") : "starting";
 }
+var WATCH_NOTE_MAX = 500;
 var rowsOf = (intents) => intents.flatMap((i) => i.rows);
 var subjectKey = (s) => s.kind === "fn" ? `fn:${s.fn}` : s.kind === "group" ? `group:${s.group}` : `asset:${s.asset}`;
 var CONTROL_NAME = "Control changes";
@@ -224,6 +225,8 @@ function changeText(c) {
     case "muted":
     case "cooldown":
       return `${c.watch.title}: ${c.action === "muted" ? "mute" : "cooldown"} ${c.note ?? ""}`.trim();
+    case "note":
+      return `${c.watch.title}: note ${c.note ?? "set"}`;
     case "applied":
       if (c.prevRule && c.rule)
         return `${name} rule changed: ${rule(c.prevRule)} → ${rule(c.rule)}`;
@@ -280,6 +283,7 @@ function createClient(opts) {
       on
     }),
     mute: (planId, watchId, mutedUntil) => call("POST", `${appPlan(planId)}/watches/${encodeURIComponent(watchId)}/delivery`, { mutedUntil }),
+    setWatchNote: (planId, watchId, note) => call("POST", `${appPlan(planId)}/watches/${encodeURIComponent(watchId)}/delivery`, { note }),
     muteAlert: (alertId, hours) => call("POST", `/alerts/${encodeURIComponent(alertId)}/mute`, { hours }),
     parseRule: (planId, subject, text) => call("POST", `${appPlan(planId)}/rules/parse`, { subject, text }),
     monitorSettings: (planId, settings) => call("POST", `${appPlan(planId)}/monitor`, settings),
@@ -385,6 +389,7 @@ export {
   NOT_LOGGED_IN,
   SentinelError,
   SubjectError,
+  WATCH_NOTE_MAX,
   assetClause,
   changeText,
   clearSession,

package/dist/mcp.js

@@ -12666,6 +12666,7 @@ function runPhase(run) {
   const last = run.events.at(-1);
   return last ? [last.name ?? last.kind, last.state].filter(Boolean).join(" ") : "starting";
 }
+var WATCH_NOTE_MAX = 500;
 var rowsOf = (intents) => intents.flatMap((i) => i.rows);
 var subjectKey = (s) => s.kind === "fn" ? `fn:${s.fn}` : s.kind === "group" ? `group:${s.group}` : `asset:${s.asset}`;
 var CONTROL_NAME = "Control changes";
@@ -12828,6 +12829,7 @@ function createClient(opts) {
       on
     }),
     mute: (planId, watchId, mutedUntil) => call("POST", `${appPlan(planId)}/watches/${encodeURIComponent(watchId)}/delivery`, { mutedUntil }),
+    setWatchNote: (planId, watchId, note) => call("POST", `${appPlan(planId)}/watches/${encodeURIComponent(watchId)}/delivery`, { note }),
     muteAlert: (alertId, hours) => call("POST", `/alerts/${encodeURIComponent(alertId)}/mute`, { hours }),
     parseRule: (planId, subject, text) => call("POST", `${appPlan(planId)}/rules/parse`, { subject, text }),
     monitorSettings: (planId, settings) => call("POST", `${appPlan(planId)}/monitor`, settings),
@@ -20729,6 +20731,7 @@ function intentView(i) {
     ...i.alsoChecks ? { alsoChecks: i.alsoChecks } : {},
     status: subjectStatus(i.rows),
     mutedUntil: i.rows.map((w) => mutedUntilOf(w)).find(Boolean) ?? null,
+    note: i.rows.map((w) => w.delivery.note).find(Boolean) ?? null,
     rules: i.rows.map((w) => ({
       watchId: w.id,
       kind: w.rule.kind,
@@ -20752,6 +20755,19 @@ async function muteSubject(client, a, hours) {
     await client.mute(ctx.planId, w.id, mutedUntil);
   return done(willDo, "Takes effect now.", { mutedUntil });
 }
+async function noteSubject(client, a) {
+  const text = typeof a.note === "string" ? a.note.trim() : "";
+  if (text.length > WATCH_NOTE_MAX)
+    throw new SentinelError(400, `Keep the note under ${WATCH_NOTE_MAX} characters`);
+  const ctx = await watchContext(client, a.planId);
+  const g = resolveSubject(ctx.watches, a.subject);
+  const willDo = text ? `Send this note with ${g.name}'s alerts: ${text}` : `Clear the note on ${g.name}.`;
+  if (a.confirm !== true)
+    return preview(willDo, "Takes effect now.");
+  for (const w of g.watches)
+    await client.setWatchNote(ctx.planId, w.id, text || null);
+  return done(willDo, "Takes effect now.");
+}
 function buildTools(client) {
   const planId = string2().describe("Plan id, from list_contracts");
   const subject = string2().describe("A watched subject: a function name or a token symbol, from list_watches");
@@ -21084,6 +21100,16 @@ function buildTools(client) {
       input: { planId, subject, hours: MUTE_HOURS, confirm },
       run: async (a) => muteSubject(client, a, a.hours)
     },
+    set_watch_note: {
+      description: "Set the note sent with a subject's alerts: your team's own words (who holds the key, where to post first), plain text, 500 characters at most. An empty note clears it. Sentinel adds nothing to it. Takes effect at once. Without confirm it only describes.",
+      input: {
+        planId,
+        subject,
+        note: string2().max(WATCH_NOTE_MAX).describe("The note; empty clears it"),
+        confirm
+      },
+      run: async (a) => noteSubject(client, a)
+    },
     unmute_watch: {
       description: "Clear a subject's mute. Takes effect at once. Without confirm it only describes.",
       input: { planId, subject, confirm },
@@ -21642,7 +21668,7 @@ async function runTool(tool, args) {
   }
 }
 function buildServer(client) {
-  const server = new McpServer({ name: "sentinel", version: "0.6.0" });
+  const server = new McpServer({ name: "sentinel", version: "0.7.0" });
   for (const [name, tool] of Object.entries(buildTools(client))) {
     server.registerTool(name, { description: tool.description, inputSchema: tool.input }, (args) => runTool(tool, args));
   }

package/dist/sentinel-client.d.ts

@@ -157,7 +157,11 @@ export type WatchDelivery = {
     routes: string[];
     cooldownBlocks: number;
     mutedUntil: string | null;
+    /** The team's own words, sent with every alert this watch fires. Absent from a server before notes. */
+    note?: string | null;
 };
+/** The longest watch note the server takes (monitoring/watch.ts `WATCH_NOTE_MAX`). */
+export declare const WATCH_NOTE_MAX = 500;
 /** One of the caller's own watches on a plan's contract, as `GET /plan/:id/watches` returns it. */
 export type StoredWatch = {
     id: string;
@@ -251,7 +255,7 @@ export type WatchesView = {
     events: {
         id: string;
         watchId: string;
-        action: "proposed" | "applied" | "rejected" | "muted" | "cooldown";
+        action: "proposed" | "applied" | "rejected" | "muted" | "cooldown" | "note";
         rule: WatchRule | null;
         note: string | null;
         createdAt: string;
@@ -542,12 +546,12 @@ export type ProjectWatchesView = {
     locked: number;
     [field: string]: unknown;
 };
-/** One change to what Sentinel watches: turned on or off, a rule edit (`prevRule` is what it replaced), a mute or
- *  a cooldown. `source` is how it was made (`web`, `key "<name>"`, …), null when not known. */
+/** One change to what Sentinel watches: turned on or off, a rule edit (`prevRule` is what it replaced), a mute, a
+ *  cooldown or a note set or cleared (never its text). `source` is how it was made (`web`, `key "<name>"`, …), null when not known. */
 export type WatchChange = {
     id: string;
     at: string;
-    action: "applied" | "on" | "off" | "muted" | "cooldown";
+    action: "applied" | "on" | "off" | "muted" | "cooldown" | "note";
     contractId: string;
     watch: {
         id: string;
@@ -716,6 +720,10 @@ export declare function createClient(opts: ClientOptions): {
     mute: (planId: string, watchId: string, mutedUntil: string | null) => Promise<{
         watch: StoredWatch;
     }>;
+    /** Set the team's note on a watch (shown with every alert it sends), or clear it with null. Plain text, 500 characters at most. */
+    setWatchNote: (planId: string, watchId: string, note: string | null) => Promise<{
+        watch: StoredWatch;
+    }>;
     /** Mute the watch behind an alert for 1, 24 or 168 hours; 0 clears. */
     muteAlert: (alertId: string, hours: 0 | 1 | 24 | 168) => Promise<{
         mutedUntil: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@secondlayer/sentinel",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Sentinel from a terminal or an agent: the CLI, an MCP server and a client for your Stacks contract monitoring.",
   "license": "MIT",
   "repository": "https://runsentinel.app/docs",