@remit/mcp-server 0.7.2 → 0.8.0

package/dist/deps.d.ts

@@ -1,5 +1,5 @@
 import type { RemitClient } from "@remit/backend/client";
-import type { IAccountRepository, IFilterRepository, IMailboxRepository, IMessageRepository, IOrganizeJobRequestRepository, IThreadMessageRepository, OrganizeJobEvent, QueueProducer } from "@remit/data-ports";
+import type { IAccountRepository, IAddressRepository, IFilterRepository, IMailboxRepository, IMessageRepository, IOrganizeJobRequestRepository, IThreadMessageRepository, OrganizeJobEvent, QueueProducer } from "@remit/data-ports";
 import type { BodyPartMaterializer, BodySyncCue, MailboxQueueService, MaterializeLogger, OrganizeJobLogger } from "@remit/mailbox-service";
 import type { StorageService } from "@remit/storage-service";
 export declare const FOLDER_SETTLE_TIMEOUT_MS = 20000;
@@ -17,7 +17,8 @@ export interface FilterToolDeps {
 export interface McpDeps {
     account: Pick<IAccountRepository, "get" | "listAllByAccountConfig">;
     mailbox: Pick<IMailboxRepository, "get" | "listAllByAccount" | "findByPath" | "resolveAccountId">;
-    message: Pick<IMessageRepository, "get" | "describe">;
+    address: Pick<IAddressRepository, "countCategoryOverridesSince">;
+    message: Pick<IMessageRepository, "get" | "describe" | "countClassifiedSince">;
     threadMessage: Pick<IThreadMessageRepository, "listByMailbox" | "listByThread" | "searchByDate">;
     filter: Pick<IFilterRepository, "listPageByAccountConfig" | "refreshExpiry" | "create" | "get" | "update">;
     organizeJobRequest: Pick<IOrganizeJobRequestRepository, "create" | "get">;

package/dist/deps.js

@@ -3,6 +3,7 @@ export const FOLDER_POLL_INTERVAL_MS = 500;
 export const mcpDepsOf = (client, { logger, settle }) => ({
     account: client.account,
     mailbox: client.mailbox,
+    address: client.address,
     message: client.message,
     threadMessage: client.threadMessage,
     filter: client.filter,

package/dist/read-tools.js

@@ -1,7 +1,8 @@
 import { NotFoundError } from "@remit/data-ports/errors";
 import { AddressRole, ContentDisposition, MediaType, } from "@remit/domain-enums";
-import { materializeBodyParts, ownedMessages } from "@remit/mailbox-service";
+import { materializeBodyParts, ownedMessages, readClassifierStats, } from "@remit/mailbox-service";
 import { z } from "zod";
+import { toolError } from "./tool-result.js";
 export const MAX_BODY_BYTES = 20 * 1024;
 const DEFAULT_PAGE_SIZE = 50;
 const MAX_PAGE_SIZE = 50;
@@ -21,7 +22,17 @@ const continuationToken = z
     .optional()
     .describe("Opaque cursor from a previous response's continuationToken");
 const order = z.enum(["asc", "desc"]).optional().describe("Sort order by date");
-const toThreadRow = (row) => ({
+const classificationOf = (message, detail) => ({
+    classificationState: message.classificationState,
+    category: message.category,
+    scores: detail === "All"
+        ? message.classifierScores
+        : message.classifierScores.filter((score) => score.confident),
+});
+const authOf = (message) => message.authResult === undefined
+    ? { state: "NotParsed" }
+    : { state: "Parsed", ...message.authResult };
+const toThreadRow = (row, message, detail) => ({
     threadId: row.threadId,
     messageId: row.messageId,
     mailboxId: row.mailboxId,
@@ -33,11 +44,26 @@ const toThreadRow = (row) => ({
     isRead: row.isRead,
     hasAttachment: row.hasAttachment,
     hasStars: row.hasStars,
+    classification: classificationOf(message, detail),
+    auth: authOf(message),
 });
-const toPage = (result) => ({
-    items: result.items.map(toThreadRow),
-    continuationToken: result.continuationToken,
-});
+const toPage = async (deps, result, detail) => {
+    const messages = new Map((await deps.message.get(result.items.map((row) => row.messageId))).map((message) => [message.messageId, message]));
+    const items = result.items.flatMap((row) => {
+        const message = messages.get(row.messageId);
+        return message === undefined ? [] : [toThreadRow(row, message, detail)];
+    });
+    if (items.length !== result.items.length) {
+        const missing = result.items
+            .map((row) => row.messageId)
+            .filter((messageId) => !messages.has(messageId));
+        throw new NotFoundError(`Message not found: ${missing.join(", ")}`);
+    }
+    return {
+        items,
+        continuationToken: result.continuationToken,
+    };
+};
 const addressesByRole = (addresses, role) => addresses
     .filter((address) => address.addressRole === role)
     .sort((left, right) => left.addressOrder - right.addressOrder)
@@ -98,12 +124,12 @@ export const registerReadTools = (server, deps, accountConfigId) => {
             order,
         },
         annotations: READ_ONLY,
-    }, async (args) => asJson(toPage(await deps.threadMessage.listByMailbox(accountConfigId, args.mailboxId, {
+    }, async (args) => asJson(await toPage(deps, await deps.threadMessage.listByMailbox(accountConfigId, args.mailboxId, {
         order: args.order ?? "desc",
         limit: args.limit ?? DEFAULT_PAGE_SIZE,
         continuationToken: args.continuationToken,
         excludeDeleted: true,
-    }))));
+    }), "Confident")));
     server.registerTool("search_threads", {
         description: "Search the user's mail by free text, with optional sender, subject and state filters; narrow to one folder with mailboxId.",
         inputSchema: {
@@ -122,7 +148,7 @@ export const registerReadTools = (server, deps, accountConfigId) => {
             order,
         },
         annotations: READ_ONLY,
-    }, async (args) => asJson(toPage(await deps.threadMessage.searchByDate(accountConfigId, {
+    }, async (args) => asJson(await toPage(deps, await deps.threadMessage.searchByDate(accountConfigId, {
         query: args.query,
         from: args.from,
         subject: args.subject,
@@ -137,7 +163,7 @@ export const registerReadTools = (server, deps, accountConfigId) => {
             ? new Set([args.mailboxId])
             : undefined,
         excludeDeleted: true,
-    }))));
+    }), "Confident")));
     server.registerTool("get_thread", {
         description: "Fetch the messages of one conversation, oldest first, at envelope level.",
         inputSchema: {
@@ -146,12 +172,27 @@ export const registerReadTools = (server, deps, accountConfigId) => {
             continuationToken,
         },
         annotations: READ_ONLY,
-    }, async (args) => asJson(toPage(await deps.threadMessage.listByThread(args.threadId, accountConfigId, {
+    }, async (args) => asJson(await toPage(deps, await deps.threadMessage.listByThread(args.threadId, accountConfigId, {
         order: "asc",
         limit: args.limit ?? DEFAULT_PAGE_SIZE,
         continuationToken: args.continuationToken,
         excludeDeleted: true,
-    }))));
+    }), "All")));
+    server.registerTool("classifier_stats", {
+        description: "Count what the classifier decided for mail that arrived on or after a date: messages examined, messages per category, confident scores per label, and how often the user corrected it.",
+        inputSchema: {
+            since: z
+                .string()
+                .min(1)
+                .describe("Start of the window, an ISO 8601 date-time with zone offset, such as 2026-11-01T00:00:00+01:00"),
+        },
+        annotations: READ_ONLY,
+    }, async (args) => {
+        const stats = await readClassifierStats(deps, accountConfigId, args.since);
+        if (!stats.ok)
+            return toolError(`${stats.message}.`);
+        return asJson(stats.value);
+    });
     server.registerTool("get_message", {
         description: `Read one message: envelope, flags, attachment metadata and its plain-text body, up to ${MAX_BODY_BYTES / 1024} KB.`,
         inputSchema: {

package/package.json

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