@remit/mcp-server 0.8.0 → 0.9.0

package/dist/filter-tools.js

@@ -1,4 +1,4 @@
-import { FILTER_NO_ACTION, } from "@remit/data-ports";
+import { FILTER_NO_ACTION, FilterRuleV1Schema, filterClausesFromRule, MAX_FILTER_RULE_DEPTH, MAX_FILTER_RULE_LEAVES, } from "@remit/data-ports";
 import { isNotFoundError } from "@remit/data-ports/errors";
 import { deriveAccountConfigId } from "@remit/data-ports/id";
 import { FilterClauseField, FilterMatchOperator, FilterScope, FilterState, } from "@remit/domain-enums";
@@ -18,8 +18,10 @@ const toFilter = (item) => ({
     expiresAt: item.expiresAt,
     state: item.state,
     disabledReason: item.disabledReason,
-    matchOperator: item.matchOperator,
-    literalClauses: item.literalClauses,
+    ...filterClausesFromRule(item.rule),
+    rule: item.rule,
+    priority: item.priority,
+    stop: item.stop,
     actionLabelId: item.actionLabelId,
     actionMailboxId: item.actionMailboxId,
     ruleChangedAt: item.ruleChangedAt,
@@ -59,7 +61,15 @@ const literalClauses = z
         .describe("Message attribute the clause matches"),
     value: z.string().min(1).max(256).describe("Literal text to match"),
 }))
-    .min(1);
+    .min(1)
+    .describe("Literal clauses combined by matchOperator. Send these or rule.");
+const rule = FilterRuleV1Schema.describe(`A Sieve-like test tree. Send this or literalClauses, never both. At most ${MAX_FILTER_RULE_LEAVES} header, address or hasWords tests and ${MAX_FILTER_RULE_DEPTH} levels, counting the top test. Example: {"version":1,"test":{"test":"allof","tests":[{"test":"address","match":"Is","part":"RegistrableDomain","key":"github.com"},{"test":"not","operand":{"test":"header","match":"Contains","header":"Subject","key":"security"}}]}}`);
+const priority = z
+    .int()
+    .describe("Evaluation order: lower runs first; ties go to the most recently changed filter. The first matching filter with a folder decides the move, and labels add up");
+const stop = z
+    .boolean()
+    .describe("When true, a message this filter matches is not evaluated against any later filter");
 const scope = z
     .enum(FilterScope)
     .describe("Standing runs until changed; Temporary stops at expiresAt");
@@ -85,7 +95,7 @@ export const registerFilterTools = (server, deps, userId) => {
         logger: deps.filters.logger,
     };
     server.registerTool("list_filters", {
-        description: "List the user's mail filters: what each matches, where it moves or labels mail, and whether it is on. A page at a time.",
+        description: "List the user's mail filters: what each matches (rule, plus literalClauses when the rule is a flat list), its priority and stop, where it moves or labels mail, and whether it is on. A page at a time.",
         inputSchema: {
             accountId,
             continuationToken: z
@@ -107,14 +117,17 @@ export const registerFilterTools = (server, deps, userId) => {
         });
     });
     server.registerTool("create_filter", {
-        description: "Create a filter that sorts new mail, and queue a job that applies it to existing mail. Returns the filter and the organizeJobId of that job. A target folder must be confirmed by the mail server first.",
+        description: "Create a filter that sorts new mail, and queue a job that applies it to existing mail. Match with literalClauses for a flat list, or with rule for not, nesting and exact matches. Returns the filter and the organizeJobId of that job. A target folder must be confirmed by the mail server first.",
         inputSchema: {
             accountId,
             name: z.string().min(1).max(256).describe("Name for the filter"),
             scope: scope.default(FilterScope.Standing),
             expiresAt: expiresAt.optional(),
             matchOperator: matchOperator.default(FilterMatchOperator.And),
-            literalClauses,
+            literalClauses: literalClauses.optional(),
+            rule: rule.optional(),
+            priority: priority.default(0),
+            stop: stop.default(false),
             actionMailboxId: actionMailboxId.default(FILTER_NO_ACTION),
             actionLabelId: actionLabelId.default(FILTER_NO_ACTION),
         },
@@ -129,7 +142,7 @@ export const registerFilterTools = (server, deps, userId) => {
         });
     });
     server.registerTool("update_filter", {
-        description: "Change a filter: its name, clauses, target folder or label, scope, expiry, or turn it on or off. Only the fields given change. Set applyToExisting to also queue a job that applies the filter to existing mail; its organizeJobId is returned.",
+        description: "Change a filter: its name, clauses or rule, priority, stop, target folder or label, scope, expiry, or turn it on or off. Only the fields given change. A filter whose rule has no clause form (literalClauses is empty in list_filters) changes only through rule. Set applyToExisting to also queue a job that applies the filter to existing mail; its organizeJobId is returned.",
         inputSchema: {
             accountId,
             filterId: z.string().min(1).describe("Filter from list_filters"),
@@ -138,6 +151,9 @@ export const registerFilterTools = (server, deps, userId) => {
             expiresAt: expiresAt.optional(),
             matchOperator: matchOperator.optional(),
             literalClauses: literalClauses.optional(),
+            rule: rule.optional(),
+            priority: priority.optional(),
+            stop: stop.optional(),
             actionMailboxId: actionMailboxId.optional(),
             actionLabelId: actionLabelId.optional(),
             state: z

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@remit/mcp-server",
-	"version": "0.8.0",
+	"version": "0.9.0",
 	"description": "The remit MCP server: mail tools over streamable HTTP and the OAuth authorization server that guards them.",
 	"type": "module",
 	"exports": {