@knowsuchagency/fulcrum 3.1.1 → 3.2.1

package/bin/fulcrum.js

@@ -1482,6 +1482,9 @@ class FulcrumClient {
   async getEmail(id) {
     return this.fetch(`/api/messaging/email/emails/${id}`);
   }
+  async getMessage(id) {
+    return this.fetch(`/api/messaging/messages/${id}`);
+  }
   async searchEmails(criteria) {
     return this.fetch("/api/messaging/email/search", {
       method: "POST",
@@ -44207,6 +44210,13 @@ var init_registry = __esm(() => {
       keywords: ["email", "fetch", "download", "imap", "uid", "message", "mail"],
       defer_loading: false
     },
+    {
+      name: "get_message",
+      description: "Get details of a specific message by ID, including full content and metadata",
+      category: "messaging",
+      keywords: ["message", "get", "read", "channel", "whatsapp", "discord", "telegram", "slack", "chat"],
+      defer_loading: false
+    },
     {
       name: "message",
       description: "Send a message to a messaging channel (WhatsApp, Discord, Telegram, Slack, Gmail)",
@@ -44307,7 +44317,7 @@ var init_registry = __esm(() => {
     },
     {
       name: "create_calendar_event",
-      description: "Create a new calendar event on a CalDAV calendar",
+      description: "Create a new calendar event on a CalDAV or Google calendar.",
       category: "caldav",
       keywords: ["calendar", "event", "create", "new", "schedule", "appointment", "meeting"],
       defer_loading: true
@@ -46185,6 +46195,24 @@ var init_memory_file = __esm(() => {
   init_utils();
 });
 
+// cli/src/mcp/tools/messaging.ts
+var registerMessagingTools = (server, client) => {
+  server.tool("get_message", "Get details of a specific message by ID, including full content and metadata.", {
+    id: exports_external.string().describe("Message ID")
+  }, async ({ id }) => {
+    try {
+      const message = await client.getMessage(id);
+      return formatSuccess(message);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+};
+var init_messaging = __esm(() => {
+  init_zod2();
+  init_utils();
+});
+
 // cli/src/mcp/tools/search.ts
 var EntityTypeSchema, registerSearchTools = (server, client) => {
   server.tool("search", 'Search across all Fulcrum entities (tasks, projects, messages, calendar events, memories, conversations) using full-text search. Supports boolean operators (AND, OR, NOT), phrase matching ("quoted phrases"), and prefix matching (term*). Returns results ranked by relevance.', {
@@ -46243,6 +46271,7 @@ function registerTools(server, client) {
   registerSettingsTools(server, client);
   registerBackupTools(server, client);
   registerEmailTools(server, client);
+  registerMessagingTools(server, client);
   registerAssistantTools(server, client);
   registerCaldavTools(server, client);
   registerGmailTools(server, client);
@@ -46267,6 +46296,7 @@ var init_tools = __esm(() => {
   init_gmail();
   init_memory();
   init_memory_file();
+  init_messaging();
   init_search();
   init_types4();
 });
@@ -46286,7 +46316,7 @@ async function runMcpServer(urlOverride, portOverride) {
   const client = new FulcrumClient(urlOverride, portOverride);
   const server = new McpServer({
     name: "fulcrum",
-    version: "3.1.1"
+    version: "3.2.1"
   });
   registerTools(server, client);
   const transport = new StdioServerTransport;
@@ -48635,7 +48665,7 @@ var marketplace_default = `{
       "name": "fulcrum",
       "source": "./",
       "description": "Task orchestration for Claude Code",
-      "version": "3.1.1",
+      "version": "3.2.1",
       "skills": [
         "./skills/fulcrum"
       ],
@@ -49839,7 +49869,7 @@ function compareVersions(v1, v2) {
 var package_default = {
   name: "@knowsuchagency/fulcrum",
   private: true,
-  version: "3.1.1",
+  version: "3.2.1",
   description: "Harness Attention. Orchestrate Agents. Ship.",
   license: "PolyForm-Perimeter-1.0.0",
   type: "module",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowsuchagency/fulcrum",
-  "version": "3.1.1",
+  "version": "3.2.1",
   "description": "Harness Attention. Orchestrate Agents. Ship.",
   "license": "PolyForm-Perimeter-1.0.0",
   "repository": {

package/server/index.js

@@ -1135470,6 +1135470,9 @@ function getChannelMessages(options = {}) {
   const results = db2.select().from(channelMessages).where(whereClause).orderBy(desc(channelMessages.messageTimestamp)).limit(options.limit ?? 50).offset(options.offset ?? 0).all();
   return results;
 }
+function getChannelMessageById(id) {
+  return db2.select().from(channelMessages).where(eq(channelMessages.id, id)).get();
+}
 function getChannelMessageCounts() {
   const results = db2.select({
     channelType: channelMessages.channelType,
@@ -1148027,6 +1148030,7 @@ ${attachment.data}`);
         const resultMsg = message;
         if (resultMsg.subtype?.startsWith("error_")) {
           const errors2 = resultMsg.errors || ["Unknown error"];
+          state.claudeSessionId = undefined;
           yield { type: "error", data: { message: errors2.join(", ") } };
         }
         if (resultMsg.structured_output) {
@@ -1148039,18 +1148043,21 @@ ${attachment.data}`);
         });
       }
     }
-    addMessage(sessionId, {
-      role: "assistant",
-      content: currentText,
-      model: MODEL_MAP[effectiveModelId],
-      tokensIn,
-      tokensOut,
-      sessionId
-    });
+    if (currentText.trim()) {
+      addMessage(sessionId, {
+        role: "assistant",
+        content: currentText,
+        model: MODEL_MAP[effectiveModelId],
+        tokensIn,
+        tokensOut,
+        sessionId
+      });
+    }
     yield { type: "done", data: {} };
   } catch (err) {
     const errorMsg = err instanceof Error ? err.message : String(err);
     log2.assistant.error("Assistant stream error", { sessionId, error: errorMsg });
+    state.claudeSessionId = undefined;
     yield { type: "error", data: { message: errorMsg } };
   } finally {
     for (const tempPath of tempFiles) {
@@ -1150021,6 +1150028,38 @@ var init_opencode_channel_service = __esm(() => {
 });
 
 // server/services/channels/message-handler.ts
+function recordObserverFailure() {
+  OBSERVER_CIRCUIT_BREAKER.failureCount++;
+  if (OBSERVER_CIRCUIT_BREAKER.failureCount >= OBSERVER_CIRCUIT_BREAKER.failureThreshold) {
+    if (OBSERVER_CIRCUIT_BREAKER.state !== "open") {
+      log2.messaging.warn("Observer circuit breaker OPEN \u2014 pausing observe-only processing", {
+        failures: OBSERVER_CIRCUIT_BREAKER.failureCount,
+        cooldownMs: OBSERVER_CIRCUIT_BREAKER.cooldownMs
+      });
+    }
+    OBSERVER_CIRCUIT_BREAKER.state = "open";
+    OBSERVER_CIRCUIT_BREAKER.nextProbeAt = Date.now() + OBSERVER_CIRCUIT_BREAKER.cooldownMs;
+    OBSERVER_CIRCUIT_BREAKER.cooldownMs = Math.min(OBSERVER_CIRCUIT_BREAKER.cooldownMs * 2, OBSERVER_CIRCUIT_BREAKER.maxCooldownMs);
+  }
+}
+function recordObserverSuccess() {
+  if (OBSERVER_CIRCUIT_BREAKER.state === "open") {
+    log2.messaging.info("Observer circuit breaker CLOSED \u2014 resuming normal processing", {
+      previousFailures: OBSERVER_CIRCUIT_BREAKER.failureCount
+    });
+  }
+  OBSERVER_CIRCUIT_BREAKER.failureCount = 0;
+  OBSERVER_CIRCUIT_BREAKER.state = "closed";
+  OBSERVER_CIRCUIT_BREAKER.nextProbeAt = 0;
+  OBSERVER_CIRCUIT_BREAKER.cooldownMs = 60000;
+}
+function isObserverCircuitOpen() {
+  if (OBSERVER_CIRCUIT_BREAKER.state !== "open")
+    return false;
+  if (Date.now() >= OBSERVER_CIRCUIT_BREAKER.nextProbeAt)
+    return false;
+  return true;
+}
 async function handleIncomingMessage(msg) {
   const content = msg.content.trim();
   const isObserveOnly = msg.metadata?.observeOnly === true;
@@ -1150268,12 +1150307,16 @@ function splitMessage(content, maxLength) {
   return parts;
 }
 async function processObserveOnlyMessage(msg) {
+  if (isObserverCircuitOpen()) {
+    return;
+  }
   const observeSessionKey = `observe-${msg.connectionId}`;
   const { session: session3 } = getOrCreateSession(msg.connectionId, observeSessionKey, "Observer", undefined, msg.channelType);
   const settings = getSettings();
   const observerProvider = settings.assistant.observerProvider ?? settings.assistant.provider;
   if (observerProvider === "opencode") {
     try {
+      let hadError = false;
       const stream2 = _deps.streamOpencodeObserverMessage(session3.id, msg.content, {
         channelType: msg.channelType,
         senderId: msg.senderId,
@@ -1150281,15 +1150324,21 @@ async function processObserveOnlyMessage(msg) {
       });
       for await (const event of stream2) {
         if (event.type === "error") {
+          hadError = true;
           const errorMsg = event.data.message;
           log2.messaging.error("Error in OpenCode observe-only processing", { error: errorMsg });
         }
       }
+      if (hadError)
+        recordObserverFailure();
+      else
+        recordObserverSuccess();
     } catch (err) {
       log2.messaging.error("Error processing observe-only message via OpenCode", {
         connectionId: msg.connectionId,
         error: String(err)
       });
+      recordObserverFailure();
     }
     return;
   }
@@ -1150305,6 +1150354,7 @@ async function processObserveOnlyMessage(msg) {
   };
   const systemPrompt = getObserveOnlySystemPrompt(msg.channelType, context);
   try {
+    let hadError = false;
     const observerModelId = settings.assistant.observerModel;
     const stream2 = _deps.streamMessage(session3.id, msg.content, {
       systemPromptAdditions: systemPrompt,
@@ -1150313,18 +1150363,24 @@ async function processObserveOnlyMessage(msg) {
     });
     for await (const event of stream2) {
       if (event.type === "error") {
+        hadError = true;
         const errorMsg = event.data.message;
         log2.messaging.error("Error in observe-only message processing", { error: errorMsg });
       }
     }
+    if (hadError)
+      recordObserverFailure();
+    else
+      recordObserverSuccess();
   } catch (err) {
     log2.messaging.error("Error processing observe-only message", {
       connectionId: msg.connectionId,
       error: String(err)
     });
+    recordObserverFailure();
   }
 }
-var _deps, SLACK_RESPONSE_SCHEMA, COMMANDS;
+var _deps, SLACK_RESPONSE_SCHEMA, OBSERVER_CIRCUIT_BREAKER, COMMANDS;
 var init_message_handler = __esm(() => {
   init_logger3();
   init_channel_manager();
@@ -1150351,6 +1150407,14 @@ var init_message_handler = __esm(() => {
     },
     required: ["body"]
   };
+  OBSERVER_CIRCUIT_BREAKER = {
+    failureCount: 0,
+    failureThreshold: 3,
+    state: "closed",
+    nextProbeAt: 0,
+    cooldownMs: 60000,
+    maxCooldownMs: 600000
+  };
   COMMANDS = {
     RESET: ["/reset", "/new", "/clear"],
     HELP: ["/help", "/?"],
@@ -1251641,6 +1251705,13 @@ var toolRegistry = [
     keywords: ["email", "fetch", "download", "imap", "uid", "message", "mail"],
     defer_loading: false
   },
+  {
+    name: "get_message",
+    description: "Get details of a specific message by ID, including full content and metadata",
+    category: "messaging",
+    keywords: ["message", "get", "read", "channel", "whatsapp", "discord", "telegram", "slack", "chat"],
+    defer_loading: false
+  },
   {
     name: "message",
     description: "Send a message to a messaging channel (WhatsApp, Discord, Telegram, Slack, Gmail)",
@@ -1251741,7 +1251812,7 @@ var toolRegistry = [
   },
   {
     name: "create_calendar_event",
-    description: "Create a new calendar event on a CalDAV calendar",
+    description: "Create a new calendar event on a CalDAV or Google calendar.",
     category: "caldav",
     keywords: ["calendar", "event", "create", "new", "schedule", "appointment", "meeting"],
     defer_loading: true
@@ -1253559,6 +1253630,20 @@ var registerMemoryFileTools = (server2, client3) => {
   });
 };
 
+// cli/src/mcp/tools/messaging.ts
+var registerMessagingTools = (server2, client3) => {
+  server2.tool("get_message", "Get details of a specific message by ID, including full content and metadata.", {
+    id: exports_external.string().describe("Message ID")
+  }, async ({ id }) => {
+    try {
+      const message = await client3.getMessage(id);
+      return formatSuccess(message);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+};
+
 // cli/src/mcp/tools/search.ts
 var EntityTypeSchema = exports_external.enum(["tasks", "projects", "messages", "events", "memories", "conversations"]);
 var registerSearchTools = (server2, client3) => {
@@ -1253613,6 +1253698,7 @@ function registerTools(server2, client3) {
   registerSettingsTools(server2, client3);
   registerBackupTools(server2, client3);
   registerEmailTools(server2, client3);
+  registerMessagingTools(server2, client3);
   registerAssistantTools(server2, client3);
   registerCaldavTools(server2, client3);
   registerGmailTools(server2, client3);
@@ -1254202,6 +1254288,9 @@ class FulcrumClient {
   async getEmail(id) {
     return this.fetch(`/api/messaging/email/emails/${id}`);
   }
+  async getMessage(id) {
+    return this.fetch(`/api/messaging/messages/${id}`);
+  }
   async searchEmails(criteria) {
     return this.fetch("/api/messaging/email/search", {
       method: "POST",
@@ -1254442,7 +1254531,7 @@ mcpRoutes.all("/", async (c) => {
   });
   const server2 = new McpServer({
     name: "fulcrum",
-    version: "3.1.1"
+    version: "3.2.1"
   });
   const client3 = new FulcrumClient(`http://localhost:${port}`);
   registerTools(server2, client3);
@@ -1255107,6 +1255196,7 @@ var assistant_default = assistantRoutes;
 // server/routes/messaging.ts
 init_channels();
 init_email_storage();
+init_message_storage();
 init_logger3();
 var app23 = new Hono2;
 app23.get("/channels", (c) => {
@@ -1255504,6 +1255594,19 @@ app23.post("/email/fetch", async (c) => {
     return c.json({ error: String(err) }, 500);
   }
 });
+app23.get("/messages/:id", (c) => {
+  try {
+    const id = c.req.param("id");
+    const message = getChannelMessageById(id);
+    if (!message) {
+      return c.json({ error: "Message not found" }, 404);
+    }
+    return c.json(message);
+  } catch (err) {
+    log2.messaging.error("Failed to get message", { error: String(err) });
+    return c.json({ error: String(err) }, 500);
+  }
+});
 app23.post("/send", async (c) => {
   try {
     const body = await c.req.json();
@@ -1255751,6 +1255854,7 @@ init_settings();
 init_logger3();
 init_ical_helpers();
 init_caldav_account_manager();
+init_google_calendar_manager();
 var logger9 = createLogger("CalDAV");
 function migrateFromSettings() {
   const settings = getSettings();
@@ -1256056,6 +1256160,20 @@ async function createEvent(input) {
   if (!calendar2) {
     throw new Error(`Calendar not found: ${input.calendarId}`);
   }
+  if (calendar2.googleAccountId) {
+    await googleCalendarManager.createEvent(calendar2.id, {
+      summary: input.summary,
+      dtstart: input.dtstart,
+      dtend: input.dtend,
+      description: input.description,
+      location: input.location,
+      allDay: input.allDay
+    });
+    const created = db2.select().from(caldavEvents).where(eq(caldavEvents.calendarId, input.calendarId)).orderBy(desc(caldavEvents.createdAt)).limit(1).get();
+    if (!created)
+      throw new Error("Failed to retrieve created Google Calendar event");
+    return created;
+  }
   const client4 = calendar2.accountId ? accountManager.getClient(calendar2.accountId) : null;
   if (!client4) {
     throw new Error("CalDAV account not connected for this calendar");
@@ -1256112,6 +1256230,10 @@ async function updateEvent(id, updates) {
     throw new Error(`Event not found: ${id}`);
   }
   const calendar2 = db2.select().from(caldavCalendars).where(eq(caldavCalendars.id, event.calendarId)).get();
+  if (calendar2?.googleAccountId) {
+    await googleCalendarManager.updateEvent(id, updates);
+    return db2.select().from(caldavEvents).where(eq(caldavEvents.id, id)).get();
+  }
   const client4 = calendar2?.accountId ? accountManager.getClient(calendar2.accountId) : null;
   if (!client4) {
     throw new Error("CalDAV account not connected for this calendar");
@@ -1256158,6 +1256280,10 @@ async function deleteEvent(id) {
     throw new Error(`Event not found: ${id}`);
   }
   const calendar2 = db2.select().from(caldavCalendars).where(eq(caldavCalendars.id, event.calendarId)).get();
+  if (calendar2?.googleAccountId) {
+    await googleCalendarManager.deleteEvent(id);
+    return;
+  }
   const client4 = calendar2?.accountId ? accountManager.getClient(calendar2.accountId) : null;
   if (!client4) {
     throw new Error("CalDAV account not connected for this calendar");