@knowsuchagency/fulcrum 2.7.1 → 2.8.2

package/README.md

@@ -19,6 +19,7 @@ Fulcrum doesn't replace your tools—it gives you leverage over them. You config
 - **Work From Anywhere** — Run Fulcrum on a remote server. Close your laptop, agents keep working.
 - **Project Management** — Tasks with dependencies, due dates, labels, and attachments. Visual kanban boards.
 - **Production Deployment** — Docker Compose with automatic Traefik routing and Cloudflare DNS/tunnels.
+- **Agent Memory** — Persistent knowledge store with full-text search. Agents remember across sessions.
 - **MCP-First Architecture** — 60+ tools exposed via Model Context Protocol. Agents discover what they need.
 
 ## MCP-First Architecture
@@ -183,6 +184,16 @@ Chat with the AI assistant from anywhere via your favorite messaging platform.
 
 Enable in Settings → Messaging and follow the setup instructions for each platform.
 
+### Agent Memory
+
+Agents can store and recall knowledge across conversations using a persistent memory system backed by SQLite FTS5 full-text search.
+
+- **Persistent** — Memories survive across sessions and agent restarts
+- **Searchable** — Full-text search with boolean operators, phrase matching, and prefix queries
+- **Tagged** — Categorize memories with tags (preferences, decisions, architecture, etc.)
+- **Browsable** — View, search, edit, and delete memories from the Monitoring > Memory tab
+- **MCP tools** — `memory_store` and `memory_search` available to all connected agents
+
 ### System Monitoring
 
 Track CPU, memory, and disk usage while your agents work. The Jobs tab manages systemd (Linux) or launchd (macOS) timers. The Messages tab shows all channel messages (WhatsApp, Discord, Telegram, Slack, Email) with filtering by channel and direction.
@@ -235,6 +246,7 @@ Both plugins include an MCP server with 60+ tools:
 | **Notifications** | Send notifications to enabled channels |
 | **Backup & Restore** | Snapshot database and settings; auto-safety-backup on restore |
 | **Settings** | View and update configuration; manage notification channels |
+| **Memory** | Store and search persistent knowledge with FTS5 full-text search |
 | **Assistant Events** | Track actionable events; query decision history |
 
 Use `search_tools` to discover available tools by keyword or category.

package/bin/fulcrum.js

@@ -1583,6 +1583,34 @@ class FulcrumClient {
       method: "DELETE"
     });
   }
+  async storeMemory(input) {
+    return this.fetch("/api/memory", {
+      method: "POST",
+      body: JSON.stringify(input)
+    });
+  }
+  async searchMemories(input) {
+    const params = new URLSearchParams({ q: input.query });
+    if (input.tags?.length)
+      params.set("tags", input.tags.join(","));
+    if (input.limit)
+      params.set("limit", String(input.limit));
+    return this.fetch(`/api/memory/search?${params.toString()}`);
+  }
+  async listMemories(input) {
+    const params = new URLSearchParams;
+    if (input?.tags?.length)
+      params.set("tags", input.tags.join(","));
+    if (input?.limit)
+      params.set("limit", String(input.limit));
+    if (input?.offset)
+      params.set("offset", String(input.offset));
+    const query = params.toString();
+    return this.fetch(`/api/memory${query ? `?${query}` : ""}`);
+  }
+  async deleteMemory(id) {
+    return this.fetch(`/api/memory/${id}`, { method: "DELETE" });
+  }
   async getAssistantStats() {
     return this.fetch("/api/assistant/stats");
   }
@@ -43421,7 +43449,8 @@ var init_types4 = __esm(() => {
     "email",
     "messaging",
     "assistant",
-    "caldav"
+    "caldav",
+    "memory"
   ]);
   AgentTypeSchema = exports_external.enum(["claude", "opencode"]);
 });
@@ -44173,6 +44202,20 @@ var init_registry = __esm(() => {
       category: "caldav",
       keywords: ["calendar", "event", "delete", "remove", "cancel"],
       defer_loading: true
+    },
+    {
+      name: "memory_store",
+      description: "Store a piece of knowledge in persistent memory",
+      category: "memory",
+      keywords: ["memory", "store", "save", "remember", "knowledge", "persist", "fact"],
+      defer_loading: false
+    },
+    {
+      name: "memory_search",
+      description: "Search persistent memory using full-text search",
+      category: "memory",
+      keywords: ["memory", "search", "find", "recall", "knowledge", "retrieve", "remember"],
+      defer_loading: false
     }
   ];
 });
@@ -45782,6 +45825,52 @@ var init_caldav = __esm(() => {
   init_utils();
 });
 
+// shared/types.ts
+var MEMORY_SOURCES;
+var init_types5 = __esm(() => {
+  MEMORY_SOURCES = [
+    "channel:whatsapp",
+    "channel:slack",
+    "channel:discord",
+    "channel:telegram",
+    "channel:email",
+    "conversation:assistant"
+  ];
+});
+
+// cli/src/mcp/tools/memory.ts
+var registerMemoryTools = (server, client) => {
+  server.tool("memory_store", "Store a piece of knowledge in persistent memory. Use this to remember facts, preferences, decisions, patterns, or any information that should persist across conversations.", {
+    content: exports_external.string().describe("The memory content to store. Be specific and self-contained."),
+    tags: exports_external.optional(exports_external.array(exports_external.string())).describe('Optional tags for categorization (e.g., ["preference", "architecture", "decision"])'),
+    source: exports_external.optional(exports_external.enum(MEMORY_SOURCES)).describe('Where this memory originated (e.g., "channel:whatsapp", "conversation:assistant")')
+  }, async ({ content, tags, source }) => {
+    try {
+      const result = await client.storeMemory({ content, tags, source });
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("memory_search", 'Search persistent memory using full-text search. Supports boolean operators (AND, OR, NOT), phrase matching ("quoted phrases"), and prefix matching (term*). Try different search terms or synonyms if initial results are insufficient.', {
+    query: exports_external.string().describe('FTS5 search query. Supports: AND, OR, NOT operators, "quoted phrases", prefix* matching. Example: "user preference" OR settings'),
+    tags: exports_external.optional(exports_external.array(exports_external.string())).describe("Optional tag filter - only return memories with at least one of these tags"),
+    limit: exports_external.optional(exports_external.number()).describe("Maximum results to return (default: 20)")
+  }, async ({ query, tags, limit }) => {
+    try {
+      const results = await client.searchMemories({ query, tags, limit });
+      return formatSuccess(results);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+};
+var init_memory = __esm(() => {
+  init_zod2();
+  init_utils();
+  init_types5();
+});
+
 // cli/src/mcp/tools/index.ts
 function registerTools(server, client) {
   registerCoreTools(server, client);
@@ -45797,6 +45886,7 @@ function registerTools(server, client) {
   registerEmailTools(server, client);
   registerAssistantEventTools(server, client);
   registerCaldavTools(server, client);
+  registerMemoryTools(server, client);
 }
 var init_tools = __esm(() => {
   init_core5();
@@ -45812,6 +45902,7 @@ var init_tools = __esm(() => {
   init_email();
   init_assistant_events();
   init_caldav();
+  init_memory();
   init_types4();
 });
 
@@ -45830,7 +45921,7 @@ async function runMcpServer(urlOverride, portOverride) {
   const client = new FulcrumClient(urlOverride, portOverride);
   const server = new McpServer({
     name: "fulcrum",
-    version: "2.7.1"
+    version: "2.8.2"
   });
   registerTools(server, client);
   const transport = new StdioServerTransport;
@@ -48179,7 +48270,7 @@ var marketplace_default = `{
       "name": "fulcrum",
       "source": "./",
       "description": "Task orchestration for Claude Code",
-      "version": "2.7.1",
+      "version": "2.8.2",
       "skills": [
         "./skills/fulcrum"
       ],
@@ -49367,7 +49458,7 @@ function compareVersions(v1, v2) {
 var package_default = {
   name: "@knowsuchagency/fulcrum",
   private: true,
-  version: "2.7.1",
+  version: "2.8.2",
   description: "Harness Attention. Orchestrate Agents. Ship.",
   license: "PolyForm-Perimeter-1.0.0",
   type: "module",