@knowsuchagency/fulcrum 3.2.1 → 3.4.0

package/bin/fulcrum.js

@@ -1710,6 +1710,14 @@ class FulcrumClient {
       params.set("conversationProvider", input.conversationProvider);
     if (input.conversationProjectId)
       params.set("conversationProjectId", input.conversationProjectId);
+    if (input.gmailFrom)
+      params.set("gmailFrom", input.gmailFrom);
+    if (input.gmailTo)
+      params.set("gmailTo", input.gmailTo);
+    if (input.gmailAfter)
+      params.set("gmailAfter", input.gmailAfter);
+    if (input.gmailBefore)
+      params.set("gmailBefore", input.gmailBefore);
     return this.fetch(`/api/search?${params.toString()}`);
   }
 }
@@ -44343,6 +44351,27 @@ var init_registry = __esm(() => {
       keywords: ["memory", "store", "save", "remember", "knowledge", "persist", "fact"],
       defer_loading: false
     },
+    {
+      name: "memory_search",
+      description: "Search persistent memories using full-text search (FTS5)",
+      category: "memory",
+      keywords: ["memory", "search", "find", "query", "fts", "recall", "knowledge"],
+      defer_loading: false
+    },
+    {
+      name: "memory_list",
+      description: "List persistent memories with optional tag filter",
+      category: "memory",
+      keywords: ["memory", "list", "browse", "tags", "filter", "all"],
+      defer_loading: false
+    },
+    {
+      name: "memory_delete",
+      description: "Delete a persistent memory by ID",
+      category: "memory",
+      keywords: ["memory", "delete", "remove", "clean", "resolved", "outdated"],
+      defer_loading: false
+    },
     {
       name: "memory_file_read",
       description: "Read the master memory file (MEMORY.md)",
@@ -44359,9 +44388,9 @@ var init_registry = __esm(() => {
     },
     {
       name: "search",
-      description: "Search across all Fulcrum entities (tasks, projects, messages, events, memories) using full-text search",
+      description: "Search across all Fulcrum entities (tasks, projects, messages, events, memories, gmail) using full-text search",
       category: "core",
-      keywords: ["search", "find", "query", "fts", "full-text", "task", "project", "message", "event", "memory", "recall", "knowledge"],
+      keywords: ["search", "find", "query", "fts", "full-text", "task", "project", "message", "event", "memory", "recall", "knowledge", "gmail", "email", "google"],
       defer_loading: false
     },
     {
@@ -44456,7 +44485,7 @@ function getTodayInTimezone(timezone) {
 
 // cli/src/mcp/tools/tasks.ts
 import { basename as basename2 } from "path";
-var registerTaskTools = (server, client) => {
+function registerListTasks(server, client) {
   server.tool("list_tasks", "List all Fulcrum tasks with flexible filtering. Supports text search across title/tags/project, multi-tag filtering (OR logic), multi-status filtering, date range, and overdue detection.", {
     status: exports_external.optional(TaskStatusSchema2).describe("Filter by single task status (use statuses for multiple)"),
     statuses: exports_external.optional(exports_external.array(TaskStatusSchema2)).describe("Filter by multiple statuses (OR logic)"),
@@ -44548,20 +44577,8 @@ var registerTaskTools = (server, client) => {
       return handleToolError(err);
     }
   });
-  server.tool("get_task", "Get details of a specific task by ID, including dependencies and attachments", {
-    id: exports_external.string().describe("Task ID (UUID)")
-  }, async ({ id }) => {
-    try {
-      const [task, dependencies, attachments] = await Promise.all([
-        client.getTask(id),
-        client.getTaskDependencies(id),
-        client.listTaskAttachments(id)
-      ]);
-      return formatSuccess({ ...task, dependencies, attachments });
-    } catch (err) {
-      return handleToolError(err);
-    }
-  });
+}
+function registerCreateTask(server, client) {
   server.tool("create_task", "Create a new task. For worktree tasks, provide repoPath to create a git worktree. For non-worktree tasks, omit repoPath. When tags are provided, returns all existing tags for reference.", {
     title: exports_external.string().describe("Task title"),
     repoPath: exports_external.optional(exports_external.string()).describe("Absolute path to the git repository (optional for non-worktree tasks)"),
@@ -44622,6 +44639,8 @@ var registerTaskTools = (server, client) => {
       return handleToolError(err);
     }
   });
+}
+function registerUpdateTask(server, client) {
   server.tool("update_task", "Update task metadata (title or description)", {
     id: exports_external.string().describe("Task ID"),
     title: exports_external.optional(exports_external.string()).describe("New title"),
@@ -44639,6 +44658,82 @@ var registerTaskTools = (server, client) => {
       return handleToolError(err);
     }
   });
+}
+function registerAddTaskLink(server, client) {
+  server.tool("add_task_link", "Add a URL link to a task (for documentation, related PRs, design files, etc.)", {
+    taskId: exports_external.string().describe("Task ID"),
+    url: exports_external.string().url().describe("URL to add"),
+    label: exports_external.optional(exports_external.string()).describe("Display label (auto-detected if not provided)")
+  }, async ({ taskId, url: url2, label }) => {
+    try {
+      const link = await client.addTaskLink(taskId, url2, label);
+      return formatSuccess(link);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+}
+function registerAddTaskTag(server, client) {
+  server.tool("add_task_tag", "Add a tag to a task for categorization. Returns similar existing tags to help catch typos.", {
+    taskId: exports_external.string().describe("Task ID"),
+    tag: exports_external.string().describe("Tag to add")
+  }, async ({ taskId, tag }) => {
+    try {
+      const result = await client.addTaskTag(taskId, tag);
+      const allTasks = await client.listTasks();
+      const existingTags = new Set;
+      for (const t2 of allTasks) {
+        if (t2.tags) {
+          for (const tg of t2.tags) {
+            existingTags.add(tg);
+          }
+        }
+      }
+      const tagLower = tag.toLowerCase();
+      const similarTags = Array.from(existingTags).filter((tg) => tg !== tag && (tg.toLowerCase().includes(tagLower) || tagLower.includes(tg.toLowerCase())));
+      return formatSuccess({
+        ...result,
+        similarTags: similarTags.length > 0 ? similarTags : undefined
+      });
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+}
+function registerSetTaskDueDate(server, client) {
+  server.tool("set_task_due_date", "Set or clear the due date for a task", {
+    taskId: exports_external.string().describe("Task ID"),
+    dueDate: exports_external.nullable(exports_external.string()).describe("Due date in YYYY-MM-DD format, or null to clear")
+  }, async ({ taskId, dueDate }) => {
+    try {
+      const result = await client.setTaskDueDate(taskId, dueDate);
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+}
+var registerTaskTools = (server, client) => {
+  registerListTasks(server, client);
+  registerCreateTask(server, client);
+  registerUpdateTask(server, client);
+  registerAddTaskLink(server, client);
+  registerAddTaskTag(server, client);
+  registerSetTaskDueDate(server, client);
+  server.tool("get_task", "Get details of a specific task by ID, including dependencies and attachments", {
+    id: exports_external.string().describe("Task ID (UUID)")
+  }, async ({ id }) => {
+    try {
+      const [task, dependencies, attachments] = await Promise.all([
+        client.getTask(id),
+        client.getTaskDependencies(id),
+        client.listTaskAttachments(id)
+      ]);
+      return formatSuccess({ ...task, dependencies, attachments });
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
   server.tool("delete_task", "Delete a task and optionally its linked git worktree", {
     id: exports_external.string().describe("Task ID"),
     deleteWorktree: exports_external.optional(exports_external.boolean()).describe("Also delete the linked git worktree (default: false)")
@@ -44663,18 +44758,6 @@ var registerTaskTools = (server, client) => {
       return handleToolError(err);
     }
   });
-  server.tool("add_task_link", "Add a URL link to a task (for documentation, related PRs, design files, etc.)", {
-    taskId: exports_external.string().describe("Task ID"),
-    url: exports_external.string().url().describe("URL to add"),
-    label: exports_external.optional(exports_external.string()).describe("Display label (auto-detected if not provided)")
-  }, async ({ taskId, url: url2, label }) => {
-    try {
-      const link = await client.addTaskLink(taskId, url2, label);
-      return formatSuccess(link);
-    } catch (err) {
-      return handleToolError(err);
-    }
-  });
   server.tool("remove_task_link", "Remove a URL link from a task", {
     taskId: exports_external.string().describe("Task ID"),
     linkId: exports_external.string().describe("Link ID to remove")
@@ -44696,31 +44779,6 @@ var registerTaskTools = (server, client) => {
       return handleToolError(err);
     }
   });
-  server.tool("add_task_tag", "Add a tag to a task for categorization. Returns similar existing tags to help catch typos.", {
-    taskId: exports_external.string().describe("Task ID"),
-    tag: exports_external.string().describe("Tag to add")
-  }, async ({ taskId, tag }) => {
-    try {
-      const result = await client.addTaskTag(taskId, tag);
-      const allTasks = await client.listTasks();
-      const existingTags = new Set;
-      for (const t2 of allTasks) {
-        if (t2.tags) {
-          for (const tg of t2.tags) {
-            existingTags.add(tg);
-          }
-        }
-      }
-      const tagLower = tag.toLowerCase();
-      const similarTags = Array.from(existingTags).filter((tg) => tg !== tag && (tg.toLowerCase().includes(tagLower) || tagLower.includes(tg.toLowerCase())));
-      return formatSuccess({
-        ...result,
-        similarTags: similarTags.length > 0 ? similarTags : undefined
-      });
-    } catch (err) {
-      return handleToolError(err);
-    }
-  });
   server.tool("remove_task_tag", "Remove a tag from a task", {
     taskId: exports_external.string().describe("Task ID"),
     tag: exports_external.string().describe("Tag to remove")
@@ -44732,17 +44790,6 @@ var registerTaskTools = (server, client) => {
       return handleToolError(err);
     }
   });
-  server.tool("set_task_due_date", "Set or clear the due date for a task", {
-    taskId: exports_external.string().describe("Task ID"),
-    dueDate: exports_external.nullable(exports_external.string()).describe("Due date in YYYY-MM-DD format, or null to clear")
-  }, async ({ taskId, dueDate }) => {
-    try {
-      const result = await client.setTaskDueDate(taskId, dueDate);
-      return formatSuccess(result);
-    } catch (err) {
-      return handleToolError(err);
-    }
-  });
   server.tool("get_task_dependencies", "Get the dependencies and dependents of a task, and whether it is blocked", {
     taskId: exports_external.string().describe("Task ID")
   }, async ({ taskId }) => {
@@ -45833,8 +45880,9 @@ var ChannelSchema, registerAssistantTools = (server, client) => {
     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."),
+    filePath: exports_external.optional(exports_external.string()).describe("Absolute path to a local file to upload alongside the message (Slack only). Use for sending images, documents, etc."),
     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 }) => {
+  }, async ({ channel, body, subject, replyToMessageId, slack_blocks, filePath, googleAccountId }) => {
     try {
       if (channel === "gmail") {
         let accountId = googleAccountId;
@@ -45857,7 +45905,8 @@ var ChannelSchema, registerAssistantTools = (server, client) => {
         body,
         subject,
         replyToMessageId,
-        slackBlocks: slack_blocks
+        slackBlocks: slack_blocks,
+        filePath
       });
       return formatSuccess(result);
     } catch (err) {
@@ -46144,7 +46193,7 @@ var init_types5 = __esm(() => {
 });
 
 // cli/src/mcp/tools/memory.ts
-var registerMemoryTools = (server, client) => {
+function registerMemoryStoreTool(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"])'),
@@ -46157,6 +46206,52 @@ var registerMemoryTools = (server, client) => {
       return handleToolError(err);
     }
   });
+}
+function registerMemorySearchTool(server, client) {
+  server.tool("memory_search", 'Search persistent memories using full-text search (FTS5). Supports boolean operators (AND, OR, NOT), phrase matching ("quoted"), and prefix matching (term*).', {
+    query: exports_external.string().describe('Search query. Supports FTS5 syntax: AND, OR, NOT, "phrases", prefix*'),
+    tags: exports_external.optional(exports_external.array(exports_external.string())).describe('Filter by tags (e.g., ["actionable", "preference"])'),
+    limit: exports_external.optional(exports_external.number()).describe("Max results to return (default: 20)")
+  }, async ({ query, tags, limit }) => {
+    try {
+      const result = await client.searchMemories({ query, tags, limit });
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+}
+function registerMemoryListTool(server, client) {
+  server.tool("memory_list", "List all persistent memories, optionally filtered by tags. Returns memories sorted by creation date (newest first).", {
+    tags: exports_external.optional(exports_external.array(exports_external.string())).describe('Filter by tags (e.g., ["actionable"])'),
+    limit: exports_external.optional(exports_external.number()).describe("Max results to return (default: 50)"),
+    offset: exports_external.optional(exports_external.number()).describe("Offset for pagination")
+  }, async ({ tags, limit, offset }) => {
+    try {
+      const result = await client.listMemories({ tags, limit, offset });
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+}
+function registerMemoryDeleteTool(server, client) {
+  server.tool("memory_delete", "Delete a persistent memory by ID. Use this to clean up resolved or outdated memories.", {
+    id: exports_external.string().describe("The ID of the memory to delete")
+  }, async ({ id }) => {
+    try {
+      const result = await client.deleteMemory(id);
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+}
+var registerMemoryTools = (server, client) => {
+  registerMemoryStoreTool(server, client);
+  registerMemorySearchTool(server, client);
+  registerMemoryListTool(server, client);
+  registerMemoryDeleteTool(server, client);
 };
 var init_memory = __esm(() => {
   init_zod2();
@@ -46165,7 +46260,7 @@ var init_memory = __esm(() => {
 });
 
 // cli/src/mcp/tools/memory-file.ts
-var registerMemoryFileTools = (server, client) => {
+var registerMemoryFileReadTool = (server, client) => {
   server.tool("memory_file_read", "Read the master memory file (MEMORY.md). This file contains persistent knowledge, user preferences, and instructions that are included in every conversation.", {}, async () => {
     try {
       const result = await client.readMemoryFile();
@@ -46174,6 +46269,8 @@ var registerMemoryFileTools = (server, client) => {
       return handleToolError(err);
     }
   });
+}, registerMemoryFileTools = (server, client) => {
+  registerMemoryFileReadTool(server, client);
   server.tool("memory_file_update", "Update the master memory file. Provide full content to replace the entire file, or specify a section heading to update just that section. The memory file is included in every conversation, so keep it organized and concise.", {
     content: exports_external.string().describe("The content to write. If section is specified, this replaces only that section body."),
     section: exports_external.optional(exports_external.string()).describe('Optional markdown heading (e.g., "## Preferences") to update a specific section. If omitted, replaces the entire file.')
@@ -46215,7 +46312,7 @@ var init_messaging = __esm(() => {
 
 // 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.', {
+  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. Gmail search is opt-in: include "gmail" in entities to search Gmail via API (not included in default searches).', {
     query: exports_external.string().describe('FTS5 search query. Supports: AND, OR, NOT operators, "quoted phrases", prefix* matching. Example: "kubernetes deployment" OR k8s'),
     entities: exports_external.optional(exports_external.array(EntityTypeSchema)).describe("Entity types to search. Defaults to all: tasks, projects, messages, events, memories, conversations"),
     limit: exports_external.optional(exports_external.number()).describe("Maximum results per entity type (default: 10)"),
@@ -46228,8 +46325,12 @@ var EntityTypeSchema, registerSearchTools = (server, client) => {
     memoryTags: exports_external.optional(exports_external.array(exports_external.string())).describe("Filter memories by tags"),
     conversationRole: exports_external.optional(exports_external.string()).describe('Filter conversations by role (e.g., "user", "assistant")'),
     conversationProvider: exports_external.optional(exports_external.string()).describe('Filter conversations by provider (e.g., "claude", "opencode")'),
-    conversationProjectId: exports_external.optional(exports_external.string()).describe("Filter conversations by project ID")
-  }, async ({ query, entities, limit, taskStatus, projectStatus, messageChannel, messageDirection, eventFrom, eventTo, memoryTags, conversationRole, conversationProvider, conversationProjectId }) => {
+    conversationProjectId: exports_external.optional(exports_external.string()).describe("Filter conversations by project ID"),
+    gmailFrom: exports_external.optional(exports_external.string()).describe('Filter Gmail results by sender (e.g., "user@example.com")'),
+    gmailTo: exports_external.optional(exports_external.string()).describe('Filter Gmail results by recipient (e.g., "user@example.com")'),
+    gmailAfter: exports_external.optional(exports_external.string()).describe("Filter Gmail results after this date (YYYY/MM/DD format)"),
+    gmailBefore: exports_external.optional(exports_external.string()).describe("Filter Gmail results before this date (YYYY/MM/DD format)")
+  }, async ({ query, entities, limit, taskStatus, projectStatus, messageChannel, messageDirection, eventFrom, eventTo, memoryTags, conversationRole, conversationProvider, conversationProjectId, gmailFrom, gmailTo, gmailAfter, gmailBefore }) => {
     try {
       const results = await client.search({
         query,
@@ -46244,7 +46345,11 @@ var EntityTypeSchema, registerSearchTools = (server, client) => {
         memoryTags,
         conversationRole,
         conversationProvider,
-        conversationProjectId
+        conversationProjectId,
+        gmailFrom,
+        gmailTo,
+        gmailAfter,
+        gmailBefore
       });
       return formatSuccess(results);
     } catch (err) {
@@ -46255,7 +46360,7 @@ var EntityTypeSchema, registerSearchTools = (server, client) => {
 var init_search = __esm(() => {
   init_zod2();
   init_utils();
-  EntityTypeSchema = exports_external.enum(["tasks", "projects", "messages", "events", "memories", "conversations"]);
+  EntityTypeSchema = exports_external.enum(["tasks", "projects", "messages", "events", "memories", "conversations", "gmail"]);
 });
 
 // cli/src/mcp/tools/index.ts
@@ -46316,7 +46421,7 @@ async function runMcpServer(urlOverride, portOverride) {
   const client = new FulcrumClient(urlOverride, portOverride);
   const server = new McpServer({
     name: "fulcrum",
-    version: "3.2.1"
+    version: "3.4.0"
   });
   registerTools(server, client);
   const transport = new StdioServerTransport;
@@ -48665,7 +48770,7 @@ var marketplace_default = `{
       "name": "fulcrum",
       "source": "./",
       "description": "Task orchestration for Claude Code",
-      "version": "3.2.1",
+      "version": "3.4.0",
       "skills": [
         "./skills/fulcrum"
       ],
@@ -49869,7 +49974,7 @@ function compareVersions(v1, v2) {
 var package_default = {
   name: "@knowsuchagency/fulcrum",
   private: true,
-  version: "3.2.1",
+  version: "3.4.0",
   description: "Harness Attention. Orchestrate Agents. Ship.",
   license: "PolyForm-Perimeter-1.0.0",
   type: "module",
@@ -49885,7 +49990,7 @@ var package_default = {
     "db:studio": "drizzle-kit studio"
   },
   dependencies: {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.34",
+    "@anthropic-ai/claude-agent-sdk": "^0.2.37",
     "@atlaskit/pragmatic-drag-and-drop": "^1.7.7",
     "@atlaskit/pragmatic-drag-and-drop-hitbox": "^1.1.0",
     "@azurity/pure-nerd-font": "^3.0.5",