@knowsuchagency/fulcrum 2.17.2 → 3.0.0

package/README.md

@@ -179,7 +179,9 @@ Chat with the AI assistant from anywhere via your favorite messaging platform.
 | **Discord** | Bot token from Developer Portal |
 | **Telegram** | Bot token from @BotFather |
 | **Slack** | Bot + App tokens with Socket Mode |
+| **Gmail** | OAuth2, sends emails to your own address |
 
+- **User-only messaging** — Outbound messages restricted to user's own accounts (no third-party messaging)
 - **Persistent sessions** — Conversation context maintained across messages
 - **Email threading** — Each email thread is a separate conversation
 - **Observe-first** — Email and WhatsApp collect all messages but only respond to authorized senders
@@ -250,14 +252,14 @@ Both plugins include an MCP server with 60+ tools:
 | **Apps** | Deploy, stop, and monitor Docker Compose applications |
 | **Filesystem** | Browse directories, read/write files on the Fulcrum server |
 | **Execution** | Run shell commands with persistent session support |
-| **Notifications** | Send notifications to enabled channels |
+| **Notifications** | Send notifications to enabled channels (Slack, Discord, Pushover, WhatsApp, Telegram, Gmail) |
 | **Backup & Restore** | Snapshot database and settings; auto-safety-backup on restore |
 | **Settings** | View and update configuration; manage notification channels |
 | **Search** | Unified full-text search across tasks, projects, messages, events, memories, and conversations |
 | **Memory** | Read/update master memory file; store ephemeral knowledge with tags |
 | **Calendar** | Manage CalDAV accounts, sync calendars, configure event copy rules |
-| **Gmail** | List Google accounts, manage Gmail drafts (create, update, delete) |
-| **Assistant** | Send messages via channels; query sweep history |
+| **Gmail** | List Google accounts, manage Gmail drafts, send emails |
+| **Assistant** | Send messages via channels (WhatsApp, Discord, Telegram, Slack, Gmail); query sweep history |
 
 Use `search_tools` to discover available tools by keyword or category.
 
@@ -317,7 +319,7 @@ Settings are stored in `.fulcrum/settings.json`. The fulcrum directory is resolv
 | integrations.githubPat | `GITHUB_PAT` | null |
 | appearance.language | — | null (auto-detect) |
 
-Notification settings (sound, Slack, Discord, Pushover) are configured via Settings UI or CLI.
+Notification settings (sound, Slack, Discord, Pushover, WhatsApp, Telegram, Gmail) are configured via Settings UI or CLI.
 
 ### Linear Integration
 

package/bin/fulcrum.js

@@ -1660,6 +1660,12 @@ class FulcrumClient {
   async deleteGmailDraft(accountId, draftId) {
     return this.fetch(`/api/google/accounts/${accountId}/drafts/${draftId}`, { method: "DELETE" });
   }
+  async sendGmailMessage(accountId, body, subject) {
+    return this.fetch(`/api/google/accounts/${accountId}/send`, {
+      method: "POST",
+      body: JSON.stringify({ body, subject })
+    });
+  }
   async readMemoryFile() {
     return this.fetch("/api/memory-file");
   }
@@ -23838,7 +23844,7 @@ var require_formats = __commonJS((exports) => {
   }
   var TIME = /^(\d\d):(\d\d):(\d\d(?:\.\d+)?)(z|([+-])(\d\d)(?::?(\d\d))?)?$/i;
   function getTime(strictTimeZone) {
-    return function time(str) {
+    return function time3(str) {
       const matches = TIME.exec(str);
       if (!matches)
         return false;
@@ -43680,7 +43686,7 @@ var init_registry = __esm(() => {
       name: "send_notification",
       description: "Send a notification to all enabled channels",
       category: "notifications",
-      keywords: ["notify", "alert", "message", "slack", "discord"],
+      keywords: ["notify", "alert", "message", "slack", "discord", "gmail"],
       defer_loading: false
     },
     {
@@ -44107,14 +44113,14 @@ var init_registry = __esm(() => {
       name: "get_notification_settings",
       description: "Get notification channel settings",
       category: "settings",
-      keywords: ["settings", "notifications", "slack", "discord", "pushover", "sound", "alert"],
+      keywords: ["settings", "notifications", "slack", "discord", "pushover", "gmail", "sound", "alert"],
       defer_loading: false
     },
     {
       name: "update_notification_settings",
       description: "Update notification channel settings",
       category: "settings",
-      keywords: ["settings", "notifications", "slack", "discord", "pushover", "sound", "update", "enable", "disable"],
+      keywords: ["settings", "notifications", "slack", "discord", "pushover", "whatsapp", "telegram", "gmail", "sound", "update", "enable", "disable"],
       defer_loading: false
     },
     {
@@ -44203,9 +44209,9 @@ var init_registry = __esm(() => {
     },
     {
       name: "message",
-      description: "Send a message to a messaging channel (WhatsApp, Discord, Telegram, Slack)",
+      description: "Send a message to a messaging channel (WhatsApp, Discord, Telegram, Slack, Gmail)",
       category: "assistant",
-      keywords: ["message", "send", "reply", "whatsapp", "communicate", "respond"],
+      keywords: ["message", "send", "reply", "whatsapp", "gmail", "email", "communicate", "respond"],
       defer_loading: false
     },
     {
@@ -45596,18 +45602,30 @@ var SENSITIVE_SETTINGS, registerSettingsTools = (server, client) => {
     })).describe("Sound notification settings"),
     slack: exports_external.optional(exports_external.object({
       enabled: exports_external.boolean().describe("Enable or disable Slack notifications"),
-      webhookUrl: exports_external.optional(exports_external.string()).describe("Slack webhook URL")
+      webhookUrl: exports_external.optional(exports_external.string()).describe("Slack webhook URL"),
+      useMessagingChannel: exports_external.optional(exports_external.boolean()).describe("Send via messaging channel instead of webhook")
     })).describe("Slack notification settings"),
     discord: exports_external.optional(exports_external.object({
       enabled: exports_external.boolean().describe("Enable or disable Discord notifications"),
-      webhookUrl: exports_external.optional(exports_external.string()).describe("Discord webhook URL")
+      webhookUrl: exports_external.optional(exports_external.string()).describe("Discord webhook URL"),
+      useMessagingChannel: exports_external.optional(exports_external.boolean()).describe("Send via messaging channel instead of webhook")
     })).describe("Discord notification settings"),
     pushover: exports_external.optional(exports_external.object({
       enabled: exports_external.boolean().describe("Enable or disable Pushover notifications"),
       appToken: exports_external.optional(exports_external.string()).describe("Pushover app token"),
       userKey: exports_external.optional(exports_external.string()).describe("Pushover user key")
-    })).describe("Pushover notification settings")
-  }, async ({ enabled, toast, desktop, sound, slack, discord, pushover }) => {
+    })).describe("Pushover notification settings"),
+    whatsapp: exports_external.optional(exports_external.object({
+      enabled: exports_external.boolean().describe("Enable or disable WhatsApp notifications (requires connected messaging channel)")
+    })).describe("WhatsApp notification settings (uses messaging channel)"),
+    telegram: exports_external.optional(exports_external.object({
+      enabled: exports_external.boolean().describe("Enable or disable Telegram notifications (requires connected messaging channel)")
+    })).describe("Telegram notification settings (uses messaging channel)"),
+    gmail: exports_external.optional(exports_external.object({
+      enabled: exports_external.boolean().describe("Enable or disable Gmail notifications (sends email to your own Gmail address)"),
+      googleAccountId: exports_external.optional(exports_external.string()).describe("Google account ID to send notifications from")
+    })).describe("Gmail notification settings (sends email via Gmail API)")
+  }, async ({ enabled, toast, desktop, sound, slack, discord, pushover, whatsapp, telegram, gmail }) => {
     try {
       const updates = {};
       if (enabled !== undefined)
@@ -45624,6 +45642,12 @@ var SENSITIVE_SETTINGS, registerSettingsTools = (server, client) => {
         updates.discord = discord;
       if (pushover !== undefined)
         updates.pushover = pushover;
+      if (whatsapp !== undefined)
+        updates.whatsapp = whatsapp;
+      if (telegram !== undefined)
+        updates.telegram = telegram;
+      if (gmail !== undefined)
+        updates.gmail = gmail;
       const result = await client.updateNotifications(updates);
       return formatSuccess({
         ...result,
@@ -45794,17 +45818,32 @@ var init_email = __esm(() => {
 // cli/src/mcp/tools/assistant.ts
 var ChannelSchema, registerAssistantTools = (server, client) => {
   server.tool("message", "Send a message to a messaging channel (WhatsApp, Discord, Telegram, Slack). Use this to reply to messages or send proactive communications. For email, use create_gmail_draft instead.", {
-    channel: ChannelSchema.describe("Target channel: whatsapp, discord, telegram, slack, or all"),
-    to: exports_external.optional(exports_external.string()).describe("Recipient identifier. Optional \u2014 if omitted, auto-resolves to the channel's primary user."),
+    channel: ChannelSchema.describe("Target channel: whatsapp, discord, telegram, slack, or gmail"),
     body: exports_external.string().describe("Message content"),
-    subject: exports_external.optional(exports_external.string()).describe("Email subject (for email channel only)"),
+    subject: exports_external.optional(exports_external.string()).describe("Email subject (for Gmail channel only)"),
     replyToMessageId: exports_external.optional(exports_external.string()).describe("Message ID to reply to (for threading)"),
-    slack_blocks: exports_external.optional(exports_external.array(exports_external.record(exports_external.string(), exports_external.any()))).describe("Slack Block Kit blocks for rich formatting (Slack channel only). Array of block objects.")
-  }, async ({ channel, to, body, subject, replyToMessageId, slack_blocks }) => {
+    slack_blocks: exports_external.optional(exports_external.array(exports_external.record(exports_external.string(), exports_external.any()))).describe("Slack Block Kit blocks for rich formatting (Slack channel only). Array of block objects."),
+    googleAccountId: exports_external.optional(exports_external.string()).describe("Google account ID for Gmail channel. If omitted, auto-resolves when exactly one Gmail-enabled account exists.")
+  }, async ({ channel, body, subject, replyToMessageId, slack_blocks, googleAccountId }) => {
     try {
+      if (channel === "gmail") {
+        let accountId = googleAccountId;
+        if (!accountId) {
+          const accounts = await client.listGoogleAccounts();
+          const gmailAccounts = accounts.filter((a2) => a2.gmailEnabled);
+          if (gmailAccounts.length === 0) {
+            return handleToolError(new Error("No Gmail-enabled Google accounts configured"));
+          }
+          if (gmailAccounts.length > 1) {
+            return handleToolError(new Error(`Multiple Gmail-enabled accounts found. Specify googleAccountId. Accounts: ${gmailAccounts.map((a2) => `${a2.id} (${a2.email})`).join(", ")}`));
+          }
+          accountId = gmailAccounts[0].id;
+        }
+        const result2 = await client.sendGmailMessage(accountId, body, subject);
+        return formatSuccess(result2);
+      }
       const result = await client.sendMessage({
         channel,
-        to,
         body,
         subject,
         replyToMessageId,
@@ -45829,7 +45868,7 @@ var ChannelSchema, registerAssistantTools = (server, client) => {
 var init_assistant = __esm(() => {
   init_zod2();
   init_utils();
-  ChannelSchema = exports_external.enum(["whatsapp", "discord", "telegram", "slack", "all"]);
+  ChannelSchema = exports_external.enum(["whatsapp", "discord", "telegram", "slack", "gmail"]);
 });
 
 // cli/src/mcp/tools/caldav.ts
@@ -46247,7 +46286,7 @@ async function runMcpServer(urlOverride, portOverride) {
   const client = new FulcrumClient(urlOverride, portOverride);
   const server = new McpServer({
     name: "fulcrum",
-    version: "2.17.2"
+    version: "3.0.0"
   });
   registerTools(server, client);
   const transport = new StdioServerTransport;
@@ -48596,7 +48635,7 @@ var marketplace_default = `{
       "name": "fulcrum",
       "source": "./",
       "description": "Task orchestration for Claude Code",
-      "version": "2.17.2",
+      "version": "3.0.0",
       "skills": [
         "./skills/fulcrum"
       ],
@@ -49224,8 +49263,33 @@ var claudeCommand = defineCommand({
 // cli/src/commands/notifications.ts
 init_client();
 init_errors();
-var VALID_CHANNELS = ["sound", "slack", "discord", "pushover"];
+var VALID_CHANNELS = ["sound", "slack", "discord", "pushover", "whatsapp", "telegram", "gmail"];
 async function handleNotificationsCommand(action, positional, flags) {
+  if (action === "test") {
+    const [channel] = positional;
+    if (!channel) {
+      throw new CliError("MISSING_CHANNEL", `Channel is required. Valid: ${VALID_CHANNELS.join(", ")}`, ExitCodes.INVALID_ARGS);
+    }
+    if (!VALID_CHANNELS.includes(channel)) {
+      throw new CliError("INVALID_CHANNEL", `Invalid channel: ${channel}. Valid: ${VALID_CHANNELS.join(", ")}`, ExitCodes.INVALID_ARGS);
+    }
+  } else if (action === "set") {
+    const [channel, key, value] = positional;
+    if (!channel) {
+      throw new CliError("MISSING_CHANNEL", `Channel is required. Valid: ${VALID_CHANNELS.join(", ")}`, ExitCodes.INVALID_ARGS);
+    }
+    if (!VALID_CHANNELS.includes(channel)) {
+      throw new CliError("INVALID_CHANNEL", `Invalid channel: ${channel}. Valid: ${VALID_CHANNELS.join(", ")}`, ExitCodes.INVALID_ARGS);
+    }
+    if (!key) {
+      throw new CliError("MISSING_KEY", "Setting key is required", ExitCodes.INVALID_ARGS);
+    }
+    if (value === undefined) {
+      throw new CliError("MISSING_VALUE", "Setting value is required", ExitCodes.INVALID_ARGS);
+    }
+  } else if (action !== "status" && action !== "enable" && action !== "disable" && action !== undefined) {
+    throw new CliError("UNKNOWN_ACTION", `Unknown action: ${action}. Valid: status, enable, disable, test, set`, ExitCodes.INVALID_ARGS);
+  }
   const client = new FulcrumClient(flags.url, flags.port);
   switch (action) {
     case "status":
@@ -49249,6 +49313,17 @@ Channels:`);
         if (settings.pushover) {
           console.log(`  pushover: ${settings.pushover.enabled ? "enabled" : "disabled"}`);
         }
+        if (settings.whatsapp) {
+          console.log(`  whatsapp: ${settings.whatsapp.enabled ? "enabled" : "disabled"} (messaging channel)`);
+        }
+        if (settings.telegram) {
+          console.log(`  telegram: ${settings.telegram.enabled ? "enabled" : "disabled"} (messaging channel)`);
+        }
+        if (settings.gmail) {
+          const gmail = settings.gmail;
+          const accountInfo = gmail.googleAccountId ? ` (account: ${gmail.googleAccountId})` : " (auto-resolve)";
+          console.log(`  gmail: ${gmail.enabled ? "enabled" : "disabled"}${gmail.enabled ? accountInfo : ""}`);
+        }
       }
       break;
     }
@@ -49272,12 +49347,6 @@ Channels:`);
     }
     case "test": {
       const [channel] = positional;
-      if (!channel) {
-        throw new CliError("MISSING_CHANNEL", `Channel is required. Valid: ${VALID_CHANNELS.join(", ")}`, ExitCodes.INVALID_ARGS);
-      }
-      if (!VALID_CHANNELS.includes(channel)) {
-        throw new CliError("INVALID_CHANNEL", `Invalid channel: ${channel}. Valid: ${VALID_CHANNELS.join(", ")}`, ExitCodes.INVALID_ARGS);
-      }
       const result = await client.testNotification(channel);
       if (isJsonOutput()) {
         output(result);
@@ -49292,18 +49361,6 @@ Channels:`);
     }
     case "set": {
       const [channel, key, value] = positional;
-      if (!channel) {
-        throw new CliError("MISSING_CHANNEL", `Channel is required. Valid: ${VALID_CHANNELS.join(", ")}`, ExitCodes.INVALID_ARGS);
-      }
-      if (!VALID_CHANNELS.includes(channel)) {
-        throw new CliError("INVALID_CHANNEL", `Invalid channel: ${channel}. Valid: ${VALID_CHANNELS.join(", ")}`, ExitCodes.INVALID_ARGS);
-      }
-      if (!key) {
-        throw new CliError("MISSING_KEY", "Setting key is required", ExitCodes.INVALID_ARGS);
-      }
-      if (value === undefined) {
-        throw new CliError("MISSING_VALUE", "Setting value is required", ExitCodes.INVALID_ARGS);
-      }
       const update = buildChannelUpdate(channel, key, value);
       const updated = await client.updateNotifications(update);
       if (isJsonOutput()) {
@@ -49313,8 +49370,6 @@ Channels:`);
       }
       break;
     }
-    default:
-      throw new CliError("UNKNOWN_ACTION", `Unknown action: ${action}. Valid: status, enable, disable, test, set`, ExitCodes.INVALID_ARGS);
   }
 }
 function buildChannelUpdate(channel, key, value) {
@@ -49350,7 +49405,7 @@ var notificationsTestCommand = defineCommand({
   meta: { name: "test", description: "Test a notification channel" },
   args: {
     ...globalArgs,
-    channel: { type: "positional", description: "Channel to test (sound, slack, discord, pushover)", required: true }
+    channel: { type: "positional", description: "Channel to test (sound, slack, discord, pushover, whatsapp, telegram)", required: true }
   },
   async run({ args }) {
     setupJsonOutput(args);
@@ -49361,7 +49416,7 @@ var notificationsSetCommand = defineCommand({
   meta: { name: "set", description: "Set a notification channel config" },
   args: {
     ...globalArgs,
-    channel: { type: "positional", description: "Channel (sound, slack, discord, pushover)", required: true },
+    channel: { type: "positional", description: "Channel (sound, slack, discord, pushover, whatsapp, telegram)", required: true },
     key: { type: "positional", description: "Config key", required: true },
     value: { type: "positional", description: "Config value", required: true }
   },
@@ -49390,12 +49445,12 @@ var notificationsCommand = defineCommand({
 init_client();
 init_errors();
 async function handleNotifyCommand(positional, flags) {
-  const client = new FulcrumClient(flags.url, flags.port);
   const title = flags.title || positional[0];
   const message = flags.message || positional.slice(1).join(" ") || positional[0];
   if (!title) {
     throw new CliError("MISSING_TITLE", "Title is required. Usage: fulcrum notify <title> [message] or --title=<title> --message=<message>", ExitCodes.INVALID_ARGS);
   }
+  const client = new FulcrumClient(flags.url, flags.port);
   const result = await client.sendNotification(title, message || title);
   if (isJsonOutput()) {
     output(result);
@@ -49784,7 +49839,7 @@ function compareVersions(v1, v2) {
 var package_default = {
   name: "@knowsuchagency/fulcrum",
   private: true,
-  version: "2.17.2",
+  version: "3.0.0",
   description: "Harness Attention. Orchestrate Agents. Ship.",
   license: "PolyForm-Perimeter-1.0.0",
   type: "module",