feat: url watch — broker polls URLs, notifies on change

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

apps/cli/src/mcp/server.ts

@@ -1554,6 +1554,35 @@ Your message mode is "${messageMode}".
         return text(`Skill "${result.name}" deployed.\nFiles: ${result.files.join(", ")}`);
       }
 
+      // --- URL Watch ---
+      case "mesh_watch": {
+        const { url, mode, extract, interval, notify_on, headers, label } = (args ?? {}) as any;
+        if (!url) return text("mesh_watch: `url` required", true);
+        const client = allClients()[0];
+        if (!client) return text("mesh_watch: not connected", true);
+        const result = await client.watch(url, { mode, extract, interval, notify_on, headers, label });
+        if (result.error) return text(`mesh_watch: ${result.error}`, true);
+        return text(`Watching "${label ?? url}" (${result.mode}, every ${result.interval}s)\nWatch ID: ${result.watchId}`);
+      }
+      case "mesh_unwatch": {
+        const { watch_id } = (args ?? {}) as { watch_id?: string };
+        if (!watch_id) return text("mesh_unwatch: `watch_id` required", true);
+        const client = allClients()[0];
+        if (!client) return text("mesh_unwatch: not connected", true);
+        await client.unwatch(watch_id);
+        return text(`Watch ${watch_id} stopped.`);
+      }
+      case "mesh_watches": {
+        const client = allClients()[0];
+        if (!client) return text("mesh_watches: not connected", true);
+        const watches = await client.watchList();
+        if (watches.length === 0) return text("No active watches.");
+        const lines = watches.map((w: any) =>
+          `- **${w.id}** ${w.label ? `(${w.label}) ` : ""}${w.url}\n  mode: ${w.mode} | interval: ${w.interval}s | last: ${w.lastValue?.slice(0, 30) ?? "pending"} | checked: ${w.lastCheck ?? "never"}`
+        );
+        return text(`${watches.length} active watch(es):\n\n${lines.join("\n")}`);
+      }
+
       default:
         return text(`Unknown tool: ${name}`, true);
     }

apps/cli/src/mcp/tools.ts

@@ -972,4 +972,38 @@ export const TOOLS: Tool[] = [
     description: "Remove a credential from your vault.",
     inputSchema: { type: "object", properties: { key: { type: "string" } }, required: ["key"] },
   },
+
+  // --- URL Watch tools ---
+
+  {
+    name: "mesh_watch",
+    description: "Watch a URL for changes. The broker polls it at the given interval and notifies you when the response changes. Works with any URL — websites (hash mode), JSON APIs (json mode), or status codes (status mode).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "URL to watch" },
+        mode: { type: "string", enum: ["hash", "json", "status"], description: "Detection mode: hash (SHA-256 of body), json (extract jsonpath value), status (HTTP status code). Default: hash" },
+        extract: { type: "string", description: "For json mode: dot path to extract (e.g. 'status' or 'data.deployments[0].status')" },
+        interval: { type: "number", description: "Poll interval in seconds (min: 5, default: 30)" },
+        notify_on: { type: "string", description: "When to notify: 'change' (default), 'match:<value>', 'not_match:<value>'" },
+        headers: { type: "object", description: "Optional HTTP headers (e.g. for auth)" },
+        label: { type: "string", description: "Human-readable label for this watch" },
+      },
+      required: ["url"],
+    },
+  },
+  {
+    name: "mesh_unwatch",
+    description: "Stop watching a URL.",
+    inputSchema: {
+      type: "object",
+      properties: { watch_id: { type: "string" } },
+      required: ["watch_id"],
+    },
+  },
+  {
+    name: "mesh_watches",
+    description: "List your active URL watches.",
+    inputSchema: { type: "object", properties: {} },
+  },
 ];