@secondlayer/sentinel 0.2.0 → 0.3.0

package/dist/cli.js

@@ -176,16 +176,15 @@ function ruleSummary(rule, units) {
     }
   }
 }
+function assetClause(a) {
+  const symbol = subjectName({ kind: "asset", asset: a.asset }, a.units);
+  const amount = a.threshold.amount;
+  if (amount === null)
+    return `${symbol} every outflow`;
+  return `${symbol} over ${a.units ? toUnits(amount, a.units.decimals) : `${group(amount)} base units`}`;
+}
 function intentLine(i) {
-  const t = i.threshold;
-  if (i.kind !== "money_out" || !t)
-    return i.summary;
-  const units = i.units ?? null;
-  if (t.amount === null) {
-    const sug = t.suggested ? ` (suggested ${amountText(t.suggested.amount, units)}, ${t.suggested.basis})` : "";
-    return `no threshold yet: every outflow alerts${sug}`;
-  }
-  return `${amountText(t.amount, units)} or more in one tx · ${t.basis}`;
+  return i.kind === "money_out" && i.assets?.length ? i.assets.map(assetClause).join(" · ") : i.summary;
 }
 var isMutableRule = (rule) => rule.kind !== "signature" && rule.kind !== "audit";
 function mutedUntilOf(w, now = Date.now()) {

package/dist/index.js

@@ -185,16 +185,15 @@ function kindTag(rule) {
       return rule.triggerClass === "governance.proposal_submitted" ? "governance" : "upgrade";
   }
 }
+function assetClause(a) {
+  const symbol = subjectName({ kind: "asset", asset: a.asset }, a.units);
+  const amount = a.threshold.amount;
+  if (amount === null)
+    return `${symbol} every outflow`;
+  return `${symbol} over ${a.units ? toUnits(amount, a.units.decimals) : `${group(amount)} base units`}`;
+}
 function intentLine(i) {
-  const t = i.threshold;
-  if (i.kind !== "money_out" || !t)
-    return i.summary;
-  const units = i.units ?? null;
-  if (t.amount === null) {
-    const sug = t.suggested ? ` (suggested ${amountText(t.suggested.amount, units)}, ${t.suggested.basis})` : "";
-    return `no threshold yet: every outflow alerts${sug}`;
-  }
-  return `${amountText(t.amount, units)} or more in one tx · ${t.basis}`;
+  return i.kind === "money_out" && i.assets?.length ? i.assets.map(assetClause).join(" · ") : i.summary;
 }
 function subjectStatus(ws) {
   const st = ws.map((w) => w.status);
@@ -295,6 +294,7 @@ export {
   NOT_LOGGED_IN,
   SentinelError,
   SubjectError,
+  assetClause,
   clearSession,
   clearTokenFile,
   createClient,

package/dist/mcp.js

@@ -12750,16 +12750,15 @@ function ruleSummary(rule, units) {
     }
   }
 }
+function assetClause(a) {
+  const symbol = subjectName({ kind: "asset", asset: a.asset }, a.units);
+  const amount = a.threshold.amount;
+  if (amount === null)
+    return `${symbol} every outflow`;
+  return `${symbol} over ${a.units ? toUnits(amount, a.units.decimals) : `${group(amount)} base units`}`;
+}
 function intentLine(i) {
-  const t = i.threshold;
-  if (i.kind !== "money_out" || !t)
-    return i.summary;
-  const units = i.units ?? null;
-  if (t.amount === null) {
-    const sug = t.suggested ? ` (suggested ${amountText(t.suggested.amount, units)}, ${t.suggested.basis})` : "";
-    return `no threshold yet: every outflow alerts${sug}`;
-  }
-  return `${amountText(t.amount, units)} or more in one tx · ${t.basis}`;
+  return i.kind === "money_out" && i.assets?.length ? i.assets.map(assetClause).join(" · ") : i.summary;
 }
 function subjectStatus(ws) {
   const st = ws.map((w) => w.status);
@@ -20646,8 +20645,17 @@ function intentView(i) {
     kind: i.kind,
     on: i.on,
     alertLevel: i.alertLevel,
+    coverage: i.coverage,
     summary: intentLine(i),
+    ...i.assets ? {
+      assets: i.assets.map((a) => ({
+        subject: subjectName({ kind: "asset", asset: a.asset }, a.units),
+        limit: assetClause(a),
+        watchIds: a.watchIds
+      }))
+    } : {},
     members: i.members,
+    ...i.alsoChecks ? { alsoChecks: i.alsoChecks } : {},
     status: subjectStatus(i.rows),
     mutedUntil: i.rows.map((w) => mutedUntilOf(w)).find(Boolean) ?? null,
     rules: i.rows.map((w) => ({
@@ -20857,7 +20865,7 @@ function buildTools(client) {
       run: async (a) => a.confirm === true ? client.testsFromRepo(a.planId) : paidRun("Run the Clarinet suite from this pre-launch plan's repo in the airgapped sandbox.")
     },
     list_watches: {
-      description: "What a plan watches, as intent watches (Money out per token, Control changes, one per finding, the fns you added): on or off, the threshold or summary, the fns covered, each rule in token units, any mute, and the subject name the other watch tools take.",
+      description: "What a plan watches, as intent watches (Money out once per contract with a limit per token, Control changes, one per finding, the fns you added): on or off, the threshold or summary, the fns covered, what it can see (coverage: direct-calls means a call made from another contract isn't visible yet), each rule in token units, any mute, and the subject name the other watch tools take.",
       input: { planId },
       run: async (a) => {
         const ctx = await watchContext(client, a.planId);
@@ -21041,7 +21049,7 @@ async function runTool(tool, args) {
   }
 }
 function buildServer(client) {
-  const server = new McpServer({ name: "sentinel", version: "0.2.0" });
+  const server = new McpServer({ name: "sentinel", version: "0.3.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

@@ -170,8 +170,29 @@ export type StoredWatch = {
     units: Units | null;
 };
 export type IntentKind = "money_out" | "control" | "finding" | "owner_fn";
+/** A Money out limit: null amount means every outflow alerts until one is set. */
+export type Threshold = {
+    amount: string | null;
+    basis: string;
+    confirmed: boolean;
+    suggested: {
+        amount: string;
+        basis: string;
+    } | null;
+};
+/** One asset inside Money out: its own limit, the rows behind it and its last 7 UTC days (oldest first). */
+export type AssetWatch = {
+    asset: string;
+    units: Units | null;
+    threshold: Threshold;
+    watchIds: string[];
+    stats7d: {
+        events: number[];
+        alerts: number[];
+    };
+};
 /**
- * One intent watch: what a team sees (Money out per asset, Control changes, one per finding, a fn the team
+ * One intent watch: what a team sees (Money out holding every asset, Control changes, one per finding, a fn the team
  * added). `rows` are the stored watches behind it: what a rule edit, a switch or a mute acts on.
  */
 export type IntentWatch<R = StoredWatch & {
@@ -184,28 +205,26 @@ export type IntentWatch<R = StoredWatch & {
     summary: string;
     on: boolean;
     alertLevel: "urgent" | "normal";
+    /** What it can see: `direct-calls` (a call another contract makes isn't visible yet) or `all-calls`. */
+    coverage: "direct-calls" | "all-calls";
     watchIds: string[];
     rows: R[];
     members: {
         group: string;
         fns: string[];
     }[];
-    /** Money out: the asset, its token units and its threshold (null amount: every outflow alerts). */
-    asset?: string;
-    units?: Units | null;
-    threshold?: {
-        amount: string | null;
-        basis: string;
-        confirmed: boolean;
-        suggested: {
-            amount: string;
-            basis: string;
-        } | null;
-    };
+    /** Money out: every asset the contract sends, STX first then by symbol, each with its own limit. */
+    assets?: AssetWatch[];
     findingRef?: {
         title: string;
         index: number | null;
     };
+    /** Control changes: the state only its members write, read every `everyMinutes` between calls. */
+    alsoChecks?: {
+        vars: string[];
+        maps: string[];
+        everyMinutes: number;
+    };
 };
 /** The stored rows behind a list of intent watches, in order. */
 export declare const rowsOf: <R>(intents: {
@@ -305,8 +324,10 @@ export declare function ruleSummary(rule: WatchRule, units: Units | null): strin
 export type WatchKindTag = "finding" | "outflow" | "who-acts" | "governance" | "upgrade";
 /** The plain tag a rule is listed under. */
 export declare function kindTag(rule: WatchRule): WatchKindTag;
-/** An intent watch's one line: a Money out threshold in token units (or its fail-safe), else its summary. */
-export declare function intentLine(i: Pick<IntentWatch<unknown>, "kind" | "summary" | "threshold" | "units">): string;
+/** One Money out clause: `STX over 500` or `MIA every outflow`, in token units where they are known. */
+export declare function assetClause(a: Pick<AssetWatch, "asset" | "units" | "threshold">): string;
+/** An intent watch's one line: a Money out clause per asset, else its summary. */
+export declare function intentLine(i: Pick<IntentWatch<unknown>, "kind" | "summary" | "assets">): string;
 /** A subject's status from its rules: live if any is, else paused if all are, else suggested. */
 export declare function subjectStatus(ws: {
     status: WatchStatus;

package/package.json

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