@secondlayer/sentinel 0.5.0 → 0.6.0

package/dist/cli.js

@@ -198,10 +198,30 @@ function mutedUntilOf(w, now = Date.now()) {
   const at = w.delivery.mutedUntil;
   return at && Date.parse(at) > now ? at : null;
 }
+function changeText(c) {
+  const name = c.subject.kind === "asset" ? subjectName(c.subject, c.units) : c.watch.title;
+  const rule = (r) => ruleSummary(r, c.units);
+  switch (c.action) {
+    case "on":
+      return `${c.watch.title} turned on`;
+    case "off":
+      return `${c.watch.title} turned off`;
+    case "muted":
+    case "cooldown":
+      return `${c.watch.title}: ${c.action === "muted" ? "mute" : "cooldown"} ${c.note ?? ""}`.trim();
+    case "applied":
+      if (c.prevRule && c.rule)
+        return `${name} rule changed: ${rule(c.prevRule)} → ${rule(c.rule)}`;
+      return c.rule ? `${name} rule set: ${rule(c.rule)}` : `${name} rule set`;
+  }
+}
 function createClient(opts) {
   const baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
   const doFetch = opts.fetch ?? globalThis.fetch;
-  const authHeader = () => ({ authorization: `Bearer ${opts.token}` });
+  const authHeader = () => ({
+    authorization: `Bearer ${opts.token}`,
+    ...opts.client ? { "x-sentinel-client": opts.client } : {}
+  });
   async function call(method, path, body) {
     const res = await doFetch(`${baseUrl}${path}`, {
       method,
@@ -304,7 +324,8 @@ function createClient(opts) {
     setProjectDestinations: (projectId, dest) => call("POST", `${appProject(projectId)}/destinations`, dest),
     setProjectMonitoring: (projectId, on) => call("POST", `${appProject(projectId)}/monitoring`, { on }),
     projectWatches: (projectId) => call("GET", `${appProject(projectId)}/watches`),
-    projectActivity: (projectId, intentId, opts = {}) => call("GET", `${appProject(projectId)}/watches/${encodeURIComponent(intentId)}/activity${query(opts)}`)
+    projectActivity: (projectId, intentId, opts = {}) => call("GET", `${appProject(projectId)}/watches/${encodeURIComponent(intentId)}/activity${query(opts)}`),
+    projectChanges: (projectId, opts = {}) => call("GET", `${appProject(projectId)}/changes${query(opts)}`)
   };
 }
 function query(params) {
@@ -873,6 +894,7 @@ projects (the contracts of one protocol; a write only happens with --yes):
   projects remove <project> --confirm "<name>" [--yes]   every contract you added in it, and the project
   projects watches <project> [--json]                the project's watches as one list
   projects activity <project> <watch> [--contract <id>] [--window 7|90] [--json]
+  projects changes <project> [--watch <watch>] [--mutes] [--limit N] [--cursor C] [--json]   who turned watches on/off or changed rules
   projects destinations <project> [--email on|off] [--webhook URL] [--slack URL] [--yes]   a URL left out is cleared
   projects monitoring <project> on|off [--yes]
 
@@ -917,7 +939,10 @@ var VALUE_FLAGS = new Set([
   "--commit",
   "--into",
   "--window",
-  "--example"
+  "--example",
+  "--watch",
+  "--limit",
+  "--cursor"
 ]);
 var cell2 = (v, empty = "—") => v === null || v === undefined || v === "" ? empty : String(v);
 var table = (rows) => {
@@ -1844,6 +1869,7 @@ async function projects(pos, flags, values, io, usage) {
     "remove",
     "watches",
     "activity",
+    "changes",
     "destinations",
     "monitoring"
   ];
@@ -1998,6 +2024,30 @@ async function projects(pos, flags, values, io, usage) {
         printActivity(io, intent.title, a);
       return 0;
     }
+    case "changes": {
+      const limit = values["--limit"] === undefined ? undefined : Number(values["--limit"]);
+      if (limit !== undefined && !(Number.isInteger(limit) && limit > 0))
+        return usage("--limit takes a whole number above 0");
+      const watchName = values["--watch"];
+      const watch = watchName ? pickIntent((await io.client.projectWatches(id)).intents, watchName).id : undefined;
+      const r = await io.client.projectChanges(id, {
+        limit,
+        cursor: values["--cursor"],
+        watch,
+        ...flags.includes("--mutes") ? { filter: "mutes" } : {}
+      });
+      if (json) {
+        io.out(JSON.stringify(r, null, 2));
+        return 0;
+      }
+      if (!r.events.length)
+        io.out("No changes yet.");
+      for (const c of r.events)
+        io.out([c.at, changeText(c), c.source ?? ""].join("  ").trimEnd());
+      if (r.next)
+        io.out(`More: --cursor ${r.next}`);
+      return 0;
+    }
     case "destinations": {
       const email = values["--email"];
       if (email !== undefined && onOff(email) === null)
@@ -2075,7 +2125,7 @@ async function main() {
     return 2;
   }
   const baseUrl = process.env.SENTINEL_API_URL;
-  const clientFor = (token) => createClient({ token, baseUrl });
+  const clientFor = (token) => createClient({ token, baseUrl, client: "cli" });
   return run(argv, {
     client: clientFor(credential?.token ?? ""),
     out: console.log,

package/dist/index.js

@@ -213,10 +213,30 @@ function mutedUntilOf(w, now = Date.now()) {
   const at = w.delivery.mutedUntil;
   return at && Date.parse(at) > now ? at : null;
 }
+function changeText(c) {
+  const name = c.subject.kind === "asset" ? subjectName(c.subject, c.units) : c.watch.title;
+  const rule = (r) => ruleSummary(r, c.units);
+  switch (c.action) {
+    case "on":
+      return `${c.watch.title} turned on`;
+    case "off":
+      return `${c.watch.title} turned off`;
+    case "muted":
+    case "cooldown":
+      return `${c.watch.title}: ${c.action === "muted" ? "mute" : "cooldown"} ${c.note ?? ""}`.trim();
+    case "applied":
+      if (c.prevRule && c.rule)
+        return `${name} rule changed: ${rule(c.prevRule)} → ${rule(c.rule)}`;
+      return c.rule ? `${name} rule set: ${rule(c.rule)}` : `${name} rule set`;
+  }
+}
 function createClient(opts) {
   const baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
   const doFetch = opts.fetch ?? globalThis.fetch;
-  const authHeader = () => ({ authorization: `Bearer ${opts.token}` });
+  const authHeader = () => ({
+    authorization: `Bearer ${opts.token}`,
+    ...opts.client ? { "x-sentinel-client": opts.client } : {}
+  });
   async function call(method, path, body) {
     const res = await doFetch(`${baseUrl}${path}`, {
       method,
@@ -319,7 +339,8 @@ function createClient(opts) {
     setProjectDestinations: (projectId, dest) => call("POST", `${appProject(projectId)}/destinations`, dest),
     setProjectMonitoring: (projectId, on) => call("POST", `${appProject(projectId)}/monitoring`, { on }),
     projectWatches: (projectId) => call("GET", `${appProject(projectId)}/watches`),
-    projectActivity: (projectId, intentId, opts = {}) => call("GET", `${appProject(projectId)}/watches/${encodeURIComponent(intentId)}/activity${query(opts)}`)
+    projectActivity: (projectId, intentId, opts = {}) => call("GET", `${appProject(projectId)}/watches/${encodeURIComponent(intentId)}/activity${query(opts)}`),
+    projectChanges: (projectId, opts = {}) => call("GET", `${appProject(projectId)}/changes${query(opts)}`)
   };
 }
 function query(params) {
@@ -365,6 +386,7 @@ export {
   SentinelError,
   SubjectError,
   assetClause,
+  changeText,
   clearSession,
   clearTokenFile,
   createClient,

package/dist/mcp.js

@@ -12781,7 +12781,10 @@ function mutedUntilOf(w, now = Date.now()) {
 function createClient(opts) {
   const baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
   const doFetch = opts.fetch ?? globalThis.fetch;
-  const authHeader = () => ({ authorization: `Bearer ${opts.token}` });
+  const authHeader = () => ({
+    authorization: `Bearer ${opts.token}`,
+    ...opts.client ? { "x-sentinel-client": opts.client } : {}
+  });
   async function call(method, path, body) {
     const res = await doFetch(`${baseUrl}${path}`, {
       method,
@@ -12884,7 +12887,8 @@ function createClient(opts) {
     setProjectDestinations: (projectId, dest) => call("POST", `${appProject(projectId)}/destinations`, dest),
     setProjectMonitoring: (projectId, on) => call("POST", `${appProject(projectId)}/monitoring`, { on }),
     projectWatches: (projectId) => call("GET", `${appProject(projectId)}/watches`),
-    projectActivity: (projectId, intentId, opts = {}) => call("GET", `${appProject(projectId)}/watches/${encodeURIComponent(intentId)}/activity${query(opts)}`)
+    projectActivity: (projectId, intentId, opts = {}) => call("GET", `${appProject(projectId)}/watches/${encodeURIComponent(intentId)}/activity${query(opts)}`),
+    projectChanges: (projectId, opts = {}) => call("GET", `${appProject(projectId)}/changes${query(opts)}`)
   };
 }
 function query(params) {
@@ -21577,6 +21581,22 @@ function buildTools(client) {
         window: a.window
       })
     },
+    list_project_changes: {
+      description: 'The account\'s changes to what Sentinel watches across a project, newest first: each watch turned on or off, rule edits (rule and prevRule, the one it replaced), mutes and cooldowns, with how each was made (source) and when. `watch` keeps one watch (an id from list_project_watches); filter "mutes" keeps mutes and cooldowns; pass `next` back as cursor for older ones.',
+      input: {
+        projectId,
+        watch: string2().optional(),
+        filter: literal("mutes").optional(),
+        limit: number2().int().min(1).max(200).optional(),
+        cursor: string2().optional()
+      },
+      run: async (a) => client.projectChanges(a.projectId, {
+        watch: a.watch,
+        filter: a.filter,
+        limit: a.limit,
+        cursor: a.cursor
+      })
+    },
     set_project_destinations: {
       description: "Where a project's alerts go, set on each contract you added in it: email on or off, a webhook URL, a Slack URL. A URL left out is cleared. Without confirm it only describes.",
       input: {
@@ -21622,7 +21642,7 @@ async function runTool(tool, args) {
   }
 }
 function buildServer(client) {
-  const server = new McpServer({ name: "sentinel", version: "0.5.0" });
+  const server = new McpServer({ name: "sentinel", version: "0.6.0" });
   for (const [name, tool] of Object.entries(buildTools(client))) {
     server.registerTool(name, { description: tool.description, inputSchema: tool.input }, (args) => runTool(tool, args));
   }
@@ -21637,6 +21657,7 @@ if (!credential) {
 }
 var client = createClient({
   token: credential.token,
-  baseUrl: process.env.SENTINEL_API_URL
+  baseUrl: process.env.SENTINEL_API_URL,
+  client: "mcp"
 });
 await buildServer(client).connect(new StdioServerTransport);

package/dist/sentinel-client.d.ts

@@ -542,6 +542,35 @@ 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. */
+export type WatchChange = {
+    id: string;
+    at: string;
+    action: "applied" | "on" | "off" | "muted" | "cooldown";
+    contractId: string;
+    watch: {
+        id: string;
+        title: string;
+    };
+    subject: WatchSubject;
+    units: Units | null;
+    rule: WatchRule | null;
+    prevRule: WatchRule | null;
+    note: string | null;
+    by: "you";
+    source: string | null;
+};
+export type ChangesOptions = {
+    limit?: number;
+    cursor?: string | null;
+    /** One intent watch's id (from projectWatches). */
+    watch?: string;
+    /** `mutes`: only mutes and cooldowns. */
+    filter?: "mutes";
+};
+/** One change as a line: `Money out turned on`, `sBTC rule changed: ≥ 5 → ≥ 2`. */
+export declare function changeText(c: WatchChange): string;
 /** One intent watch's activity, as the web app draws it: points, the history page, counts. */
 export type WatchActivity = {
     window: 7 | 90;
@@ -633,6 +662,8 @@ export type ClientOptions = {
     baseUrl?: string;
     token: string;
     fetch?: typeof globalThis.fetch;
+    /** Which tool is calling (sent as `x-sentinel-client`), so a change's history can say "sentinel CLI" or "MCP". */
+    client?: "cli" | "mcp";
 };
 export declare function createClient(opts: ClientOptions): {
     me: () => Promise<Record<string, unknown>>;
@@ -890,6 +921,11 @@ export declare function createClient(opts: ClientOptions): {
         contract?: string;
         fn?: string;
     }) => Promise<WatchActivity>;
+    /** The account's changes to what Sentinel watches across the project, newest first; `next` pages back. */
+    projectChanges: (projectId: string, opts?: ChangesOptions) => Promise<{
+        events: WatchChange[];
+        next: string | null;
+    }>;
 };
 export type SentinelClient = ReturnType<typeof createClient>;
 /** A mute end `hours` out, a minute inside the 7-day limit so clock skew can't tip it over. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@secondlayer/sentinel",
-  "version": "0.5.0",
+  "version": "0.6.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",