omni-notify-mcp 1.3.1 → 1.3.3

package/dist/channels/ntfy.js

@@ -3,9 +3,10 @@ export async function sendNtfy(config, message, priority = "normal", title = "Cl
     if (!config.enabled)
         return;
     const base = (config.serverUrl ?? "https://ntfy.sh").replace(/\/$/, "");
+    const safeTitle = encodeURIComponent(title);
     const headers = {
-        "Content-Type": "text/plain",
-        "Title": title,
+        "Content-Type": "text/plain; charset=utf-8",
+        "Title": safeTitle,
         "Priority": String(PRIORITY_MAP[priority] ?? 3),
         "Tags": priority === "high" ? "rotating_light" : "bell",
     };

package/dist/index.js

@@ -181,7 +181,10 @@ const server = new McpServer({ name: "notify-mcp", version: "1.2.0" }, {
         "ALWAYS echo the COMPLETE, UNTRUNCATED message in your chat output — never " +
         "shorten it with '…' or a summary. NEVER mention delivery channels (Telegram, " +
         "SMS, desktop, etc.) or echo 'Sent via: …' — those are server internals. " +
-        "Say 'notif' or 'notification' if you need to refer to the act of notifying.",
+        "Say 'notif' or 'notification' if you need to refer to the act of notifying.\n\n" +
+        "When the user asks you to remember a behavioral rule or change how you should act, " +
+        "call `update_instructions` with the full updated rules block. This writes to CLAUDE.md " +
+        "so the instructions persist across sessions and context compaction.",
 });
 // Thin proxy: forward a tool call to the HTTP server and return its content
 // block array verbatim. Error shape matches what the SDK expects from tool
@@ -213,6 +216,13 @@ server.tool("wait_for_inbox", "Block until an unsolicited user message arrives o
 server.tool("get_idle_seconds", "Seconds since user's last keyboard/mouse input. Drains inbox as a side-effect.", {}, async () => proxyToolCall("get_idle_seconds", {}));
 server.tool("get_idle_config", "Server's idle gating policy. Drains inbox as a side-effect.", {}, async () => proxyToolCall("get_idle_config", {}));
 server.tool("get_dnd_status", "Current DND state. Drains inbox as a side-effect.", {}, async () => proxyToolCall("get_dnd_status", {}));
+server.tool("update_instructions", "Persist behavioral instructions for this client into CLAUDE.md so they survive " +
+    "session restarts and context compaction. Call when the user asks you to remember " +
+    "a rule or change how you should behave. Pass the full desired block; it replaces " +
+    "the previous one atomically.", {
+    instructions: z.string().max(4000),
+    target: z.enum(["global", "project"]).default("global"),
+}, async (args) => proxyToolCall("update_instructions", args));
 // `reply` is the Channels return-path: Claude Code invokes it when the agent
 // has produced a response to a channel-delivered user message. We just funnel
 // it straight through `notify` so it flows to whatever channel the user is

package/dist/ui/server.js

@@ -1664,6 +1664,63 @@ function createMcpServer(clientId, sessionTag) {
             content: [{ type: "text", text: appendInbox(JSON.stringify({ active, reason }), sessionTag, clientId) }],
         };
     });
+    server.tool("update_instructions", "Persist a block of behavioral instructions for this client into its CLAUDE.md " +
+        "(or equivalent config file) so they survive session restarts and context compaction. " +
+        "Call this whenever the user asks you to remember a rule, change a behavior, or update " +
+        "how you should act — the instructions will be reloaded on every future session. " +
+        "Pass the full desired instructions block; it replaces the previous block atomically.", {
+        instructions: z.string().max(4000).describe("The full instructions block to persist"),
+        target: z.enum(["global", "project"]).default("global").describe("global = ~/.claude/CLAUDE.md (all projects); project = .claude/CLAUDE.md in cwd"),
+    }, async ({ instructions, target }) => {
+        try {
+            const MARKER_START = "<!-- omni-notify-mcp:instructions:start -->";
+            const MARKER_END = "<!-- omni-notify-mcp:instructions:end -->";
+            const block = `${MARKER_START}\n## omni-notify-mcp behavioral rules\n\n${instructions.trim()}\n${MARKER_END}`;
+            let claudeMdPath;
+            if (target === "global") {
+                const claudeDir = join(homedir(), ".claude");
+                if (!existsSync(claudeDir))
+                    mkdirSync(claudeDir, { recursive: true });
+                claudeMdPath = join(claudeDir, "CLAUDE.md");
+            }
+            else {
+                const projectClaudeDir = join(process.cwd(), ".claude");
+                if (!existsSync(projectClaudeDir))
+                    mkdirSync(projectClaudeDir, { recursive: true });
+                claudeMdPath = join(projectClaudeDir, "CLAUDE.md");
+            }
+            let existing = "";
+            if (existsSync(claudeMdPath)) {
+                existing = readFileSync(claudeMdPath, "utf8");
+            }
+            let updated;
+            if (existing.includes(MARKER_START)) {
+                // Replace existing block
+                const startIdx = existing.indexOf(MARKER_START);
+                const endIdx = existing.indexOf(MARKER_END);
+                if (endIdx !== -1) {
+                    updated = existing.slice(0, startIdx) + block + existing.slice(endIdx + MARKER_END.length);
+                }
+                else {
+                    updated = existing.slice(0, startIdx) + block;
+                }
+            }
+            else {
+                // Append
+                updated = existing + (existing.endsWith("\n") || existing === "" ? "" : "\n") + "\n" + block + "\n";
+            }
+            writeFileSync(claudeMdPath, updated, "utf8");
+            return {
+                content: [{ type: "text", text: `Instructions persisted to ${claudeMdPath}` }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Failed to persist instructions: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
     return server;
 }
 const httpTransports = {};
@@ -1845,8 +1902,35 @@ app.all("/mcp", async (req, res) => {
             clientVersion: initBody?.params?.clientInfo?.version,
             workspaceName,
         };
+        trackReconnect(clientId);
     }
 });
+// ── Reconnect tracker ─────────────────────────────────────────────────────────
+// After server restart, collect clients that reconnect within RECONNECT_WINDOW_MS
+// then send a single notify confirming they received updated instructions.
+const RECONNECT_WINDOW_MS = 20_000;
+const reconnectedClients = [];
+let reconnectNotifScheduled = false;
+const serverStartedAt = Date.now();
+function trackReconnect(clientId) {
+    if (Date.now() - serverStartedAt > RECONNECT_WINDOW_MS)
+        return;
+    if (reconnectedClients.includes(clientId))
+        return;
+    reconnectedClients.push(clientId);
+    if (!reconnectNotifScheduled) {
+        reconnectNotifScheduled = true;
+        setTimeout(async () => {
+            const list = reconnectedClients.join(", ");
+            const count = reconnectedClients.length;
+            const msg = `${count} client${count === 1 ? "" : "s"} reconnected and received updated instructions: ${list}`;
+            try {
+                await sendNotification(msg, "low", "omni-notify-mcp");
+            }
+            catch { /* best effort */ }
+        }, RECONNECT_WINDOW_MS);
+    }
+}
 // ── Start ─────────────────────────────────────────────────────────────────────
 const httpServer = app.listen(PORT, "0.0.0.0", () => {
     const ip = getLocalIp();

package/package.json

@@ -1,74 +1,74 @@
-{
-  "name": "omni-notify-mcp",
-  "version": "1.3.1",
-  "description": "An MCP server that lets AI agents (Claude, Cursor, etc.) reach you on any channel — desktop, Telegram, SMS, email — with two-way ask/reply, real-time inbox push, Do Not Disturb, idle gating, multi-session routing, and a one-page web UI for setup. Zero config code; configure once, agents call notify/ask.",
-  "main": "dist/index.js",
-  "type": "module",
-  "bin": {
-    "omni-notify-mcp": "dist/index.js",
-    "omni-notify-ui": "dist/ui/server.js"
-  },
-  "files": [
-    "dist/",
-    "ui/public/",
-    "assets/",
-    "config.example.json",
-    "LICENSE",
-    "README.md"
-  ],
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "notifications",
-    "ai-agent",
-    "claude",
-    "cursor",
-    "telegram",
-    "sms",
-    "email",
-    "desktop-notifications",
-    "do-not-disturb",
-    "idle-detection",
-    "human-in-the-loop",
-    "ask-tool",
-    "two-way",
-    "sse"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/menih/notify-mcp"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "build": "tsc && tsc -p ui/tsconfig.json",
-    "build:mcp": "tsc",
-    "build:ui": "tsc -p ui/tsconfig.json",
-    "start": "node dist/index.js",
-    "ui": "npm run build:ui && node dist/ui/server.js",
-    "test": "npm run build && node --test tests/*.test.mjs",
-    "prepublishOnly": "npm run build:mcp"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "express": "^4.19.2",
-    "googleapis": "^144.0.0",
-    "msedge-tts": "^2.0.5",
-    "node-notifier": "^10.0.1",
-    "nodemailer": "^6.9.9",
-    "open": "^10.1.0",
-    "twilio": "^5.3.0",
-    "zod": "^3.22.4"
-  },
-  "devDependencies": {
-    "@types/express": "^4.17.21",
-    "@types/node": "^20.0.0",
-    "@types/node-notifier": "^8.0.5",
-    "@types/nodemailer": "^6.4.14",
-    "playwright": "^1.59.1",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.4.0"
-  }
-}
+{
+  "name": "omni-notify-mcp",
+  "version": "1.3.3",
+  "description": "An MCP server that lets AI agents (Claude, Cursor, etc.) reach you on any channel — desktop, Telegram, SMS, email — with two-way ask/reply, real-time inbox push, Do Not Disturb, idle gating, multi-session routing, and a one-page web UI for setup. Zero config code; configure once, agents call notify/ask.",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "omni-notify-mcp": "dist/index.js",
+    "omni-notify-ui": "dist/ui/server.js"
+  },
+  "files": [
+    "dist/",
+    "ui/public/",
+    "assets/",
+    "config.example.json",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "notifications",
+    "ai-agent",
+    "claude",
+    "cursor",
+    "telegram",
+    "sms",
+    "email",
+    "desktop-notifications",
+    "do-not-disturb",
+    "idle-detection",
+    "human-in-the-loop",
+    "ask-tool",
+    "two-way",
+    "sse"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/menih/notify-mcp"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc && tsc -p ui/tsconfig.json",
+    "build:mcp": "tsc",
+    "build:ui": "tsc -p ui/tsconfig.json",
+    "start": "node dist/index.js",
+    "ui": "npm run build:ui && node dist/ui/server.js",
+    "test": "npm run build && node --test tests/*.test.mjs",
+    "prepublishOnly": "npm run build:mcp"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "express": "^4.19.2",
+    "googleapis": "^144.0.0",
+    "msedge-tts": "^2.0.5",
+    "node-notifier": "^10.0.1",
+    "nodemailer": "^6.9.9",
+    "open": "^10.1.0",
+    "twilio": "^5.3.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.0.0",
+    "@types/node-notifier": "^8.0.5",
+    "@types/nodemailer": "^6.4.14",
+    "playwright": "^1.59.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.4.0"
+  }
+}