feat: scheduled messages — schedule_reminder, send_later, list_scheduled, cancel_scheduled

- Broker: schedule/list_scheduled/cancel_scheduled WS message types + in-memory delivery
- Client: scheduleMessage(), listScheduled(), cancelScheduled() with resolver Map pattern
- MCP: schedule_reminder, send_later, list_scheduled, cancel_scheduled tools
- CLI: claudemesh remind <msg> --in 2h | --at 15:00 | list | cancel <id>
- Types: WSScheduleMessage, WSScheduledAckMessage, WSScheduledListMessage, WSCancelScheduledAckMessage

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

apps/cli/src/mcp/server.ts

@@ -444,6 +444,68 @@ Your message mode is "${messageMode}".
         return text(`Forgotten: ${id}`);
       }
 
+      // --- Scheduled messages ---
+      case "schedule_reminder":
+      case "send_later": {
+        const sArgs = (args ?? {}) as {
+          message?: string;
+          to?: string;
+          deliver_at?: number;
+          in_seconds?: number;
+        };
+        if (!sArgs.message) return text(`${name}: \`message\` required`, true);
+        const to = name === "schedule_reminder" ? "self" : (sArgs.to ?? "");
+        if (name === "send_later" && !to) return text("send_later: `to` required", true);
+
+        let deliverAt: number;
+        if (sArgs.deliver_at) {
+          deliverAt = Number(sArgs.deliver_at);
+        } else if (sArgs.in_seconds) {
+          deliverAt = Date.now() + Number(sArgs.in_seconds) * 1_000;
+        } else {
+          return text(`${name}: provide \`deliver_at\` (ms timestamp) or \`in_seconds\``, true);
+        }
+
+        // For send_later, resolve display name → pubkey if needed
+        let targetSpec = to;
+        if (name === "send_later" && !to.startsWith("@") && to !== "*" && !/^[0-9a-f]{64}$/i.test(to) && to !== "self") {
+          const peers = await client.listPeers();
+          const match = peers.find((p) => p.displayName.toLowerCase() === to.toLowerCase());
+          if (!match) {
+            const names = peers.map((p) => p.displayName).join(", ");
+            return text(`send_later: peer "${to}" not found. Online: ${names || "(none)"}`, true);
+          }
+          targetSpec = match.pubkey;
+        }
+        if (name === "schedule_reminder") {
+          // Self-reminder: use own session pubkey
+          targetSpec = client.getSessionPubkey() ?? "*";
+        }
+
+        const result = await client.scheduleMessage(targetSpec, sArgs.message, deliverAt);
+        if (!result) return text(`${name}: broker did not acknowledge — check connection`, true);
+        const when = new Date(result.deliverAt).toISOString();
+        return text(
+          name === "schedule_reminder"
+            ? `Reminder scheduled (${result.scheduledId.slice(0, 8)}): "${sArgs.message.slice(0, 60)}" at ${when}`
+            : `Message to "${to}" scheduled (${result.scheduledId.slice(0, 8)}) for ${when}`,
+        );
+      }
+      case "list_scheduled": {
+        const scheduled = await client.listScheduled();
+        if (scheduled.length === 0) return text("No pending scheduled messages.");
+        const lines = scheduled.map((m) =>
+          `- [${m.id.slice(0, 8)}] → ${m.to === client.getSessionPubkey() ? "self (reminder)" : m.to} at ${new Date(m.deliverAt).toISOString()}: "${m.message.slice(0, 60)}${m.message.length > 60 ? "…" : ""}"`,
+        );
+        return text(`${scheduled.length} scheduled:\n${lines.join("\n")}`);
+      }
+      case "cancel_scheduled": {
+        const { id: schedId } = (args ?? {}) as { id?: string };
+        if (!schedId) return text("cancel_scheduled: `id` required", true);
+        const ok = await client.cancelScheduled(schedId);
+        return text(ok ? `Cancelled: ${schedId}` : `Not found or already fired: ${schedId}`, !ok);
+      }
+
       // --- Files ---
       case "share_file": {
         const { path: filePath, name: fileName, tags, to: fileTo } = (args ?? {}) as { path?: string; name?: string; tags?: string[]; to?: string };

apps/cli/src/mcp/tools.ts

@@ -564,6 +564,53 @@ export const TOOLS: Tool[] = [
     },
   },
 
+  // --- Scheduled messages ---
+  {
+    name: "schedule_reminder",
+    description:
+      "Schedule a reminder message delivered back to yourself at a future time. The broker fires it as a push when the time arrives. Use to prompt yourself to check on something later.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        message: { type: "string", description: "Reminder text" },
+        deliver_at: { type: "number", description: "Unix timestamp (ms) when to deliver" },
+        in_seconds: { type: "number", description: "Alternative to deliver_at: fire after N seconds" },
+      },
+      required: ["message"],
+    },
+  },
+  {
+    name: "send_later",
+    description:
+      "Send a message to a peer, @group, or broadcast (*) at a future time. The broker holds it and delivers when the time arrives.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        to: { type: "string", description: "Recipient: display name, pubkey hex, @group, or *" },
+        message: { type: "string", description: "Message text" },
+        deliver_at: { type: "number", description: "Unix timestamp (ms) when to deliver" },
+        in_seconds: { type: "number", description: "Alternative to deliver_at: fire after N seconds" },
+      },
+      required: ["to", "message"],
+    },
+  },
+  {
+    name: "list_scheduled",
+    description: "List all your pending scheduled messages: id, recipient, preview, and delivery time.",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "cancel_scheduled",
+    description: "Cancel a pending scheduled message before it fires.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: "Scheduled message ID" },
+      },
+      required: ["id"],
+    },
+  },
+
   // --- Mesh info ---
   {
     name: "mesh_info",