@remit/mcp-server 0.5.2 → 0.7.0

package/dist/deps.d.ts

@@ -20,7 +20,7 @@ export interface McpDeps {
     message: Pick<IMessageRepository, "get" | "describe">;
     threadMessage: Pick<IThreadMessageRepository, "listByMailbox" | "listByThread" | "searchByDate">;
     filter: Pick<IFilterRepository, "listPageByAccountConfig" | "refreshExpiry" | "create" | "get" | "update">;
-    organizeJobRequest: Pick<IOrganizeJobRequestRepository, "create">;
+    organizeJobRequest: Pick<IOrganizeJobRequestRepository, "create" | "get">;
     storage: Pick<StorageService, "retrieveBodyPart">;
     bodySync: BodyPartMaterializer;
     bodySyncQueue: BodySyncCue;

package/dist/filter-tools.js

@@ -1,10 +1,10 @@
-import { FILTER_NO_ACTION } from "@remit/data-ports";
+import { FILTER_NO_ACTION, } 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";
-import { createFilter, listFilters, queueOrganizeJob, refuse, updateFilter, } from "@remit/mailbox-service";
+import { accept, createFilter, listFilters, ownedAccount, queueOrganizeJob, refuse, updateFilter, } from "@remit/mailbox-service";
 import { z } from "zod";
-import { asJson, refused } from "./tool-result.js";
+import { asJson, refused, toolError } from "./tool-result.js";
 const FILTER_WRITE = {
     readOnlyHint: false,
     destructiveHint: false,
@@ -26,6 +26,22 @@ const toFilter = (item) => ({
     createdAt: item.createdAt,
     updatedAt: item.updatedAt,
 });
+const toOrganizeJob = (job) => ({
+    organizeJobId: job.organizeJobId,
+    state: job.state,
+    filterId: job.filterId,
+    matchedCount: job.matchedCount,
+    appliedCount: job.appliedCount,
+    failedCount: job.failedCount,
+    errorMessage: job.errorMessage,
+    createdAt: job.createdAt,
+    updatedAt: job.updatedAt,
+});
+const absentJob = (error) => {
+    if (!isNotFoundError(error))
+        throw error;
+    return null;
+};
 const notFound = (error) => {
     if (!isNotFoundError(error))
         throw error;
@@ -152,4 +168,49 @@ export const registerFilterTools = (server, deps, userId) => {
         });
         return asJson({ filter, organizeJobId: job.organizeJobId });
     });
+    server.registerTool("get_organize_job", {
+        description: "Read an organize job that applies a filter to existing mail: its state (Pending, Running, Complete, Failed), how many messages it matched, applied and failed, and the error when it failed.",
+        inputSchema: {
+            organizeJobId: z
+                .string()
+                .min(1)
+                .describe("organizeJobId from create_filter or update_filter"),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ organizeJobId }) => {
+        const job = await deps.organizeJobRequest
+            .get(organizeJobId)
+            .catch(absentJob);
+        if (!job || job.accountConfigId !== accountConfigId) {
+            return toolError(`Organize job not found: ${organizeJobId}. Use the organizeJobId create_filter or update_filter returned.`);
+        }
+        return asJson(toOrganizeJob(job));
+    });
+    server.registerTool("apply_filter", {
+        description: "Apply a filter to existing mail now, without changing the filter. Queues the same job create_filter queues and returns its organizeJobId.",
+        inputSchema: {
+            accountId,
+            filterId: z.string().min(1).describe("Filter from list_filters"),
+        },
+        annotations: FILTER_WRITE,
+    }, async ({ accountId, filterId }) => {
+        const owned = await deps.account
+            .get(accountId)
+            .then((account) => ownedAccount(account, accountConfigId, "act"))
+            .catch(notFound);
+        if (!owned.ok)
+            return refused(owned.refusal);
+        const filter = await deps.filter
+            .get(accountConfigId, filterId)
+            .then(accept)
+            .catch(notFound);
+        if (!filter.ok)
+            return refused(filter.refusal);
+        const job = await queueOrganizeJob(organizeDeps, {
+            accountConfigId,
+            userId,
+            filterId,
+        });
+        return asJson({ organizeJobId: job.organizeJobId, state: job.state });
+    });
 };

package/package.json

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