@miguelarios/email-mcp 0.10.0 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,6 +2,13 @@
2
2
 
3
3
  MCP server for email via IMAP/SMTP — search, read, send, and manage emails and folders.
4
4
 
5
+ ## Protocol support
6
+
7
+ Speaks MCP revision **2026-07-28** over stdio, and still serves 2025-era clients from the same tool definitions.
8
+ Every tool declares a `title`, all four behaviour annotations, and an `outputSchema`, and returns validated `structuredContent`.
9
+
10
+ `send_email` (when sending, not when saving a draft), `send_draft`, and `delete_email` with `permanent: true` ask the user to confirm first. Set `PIM_MCP_CONFIRM=off` to skip confirmation in headless use.
11
+
5
12
  ## Usage
6
13
 
7
14
  ```bash
@@ -33,6 +40,32 @@ Add the server to your MCP client config (Claude Desktop, Claude Code, etc.). Cr
33
40
 
34
41
  Optional env vars: `IMAP_PORT` (default 993), `IMAP_SECURE` (default true), `SMTP_PORT` (default 465), `SMTP_SECURE` (default true), `SMTP_FROM_NAME`, `PIM_TIMEZONE`.
35
42
 
43
+ - `EMAIL_ATTACHMENT_DIR` — directory that gates `send_email` file attachments. Path-based attachments (`attachments[].path`) are rejected unless this is set, and only files resolving inside it are allowed. Use `attachments[].content` for inline content without setting this.
44
+ - `URL_RESOLVE_DISABLE` — set to `1`/`true` to skip network link-resolution when rendering email to markdown; links are left unresolved in the output.
45
+ - `SMTP_AUTO_SENT` — set to `true` if your provider auto-files sent mail, so the server skips the extra IMAP append to Sent.
46
+ - `SMTP_ALLOWED_FROM` — comma-separated allowlist of additional visible `From` addresses that `send_email` may use via its `from` parameter. Any address not in this list (and not `SMTP_USER`) is rejected. Read [Deliverability](#deliverability-spf-dkim-and-dmarc) before setting it.
47
+
48
+ ### Deliverability: SPF, DKIM and DMARC
49
+
50
+ `SMTP_ALLOWED_FROM` changes the **visible** `From:` header only. The SMTP envelope sender remains the authenticated
51
+ `SMTP_USER`, so the message is still submitted as your account.
52
+
53
+ Receiving servers check those two against each other. DMARC requires the visible `From:` domain to *align* with a
54
+ domain that passed SPF (evaluated against the envelope sender) or DKIM (evaluated against the signing domain).
55
+
56
+ | Configuration | Aligns? | Result |
57
+ |---|---|---|
58
+ | `SMTP_USER=alice@example.com`, allow `team@example.com` | yes | Delivers normally — the intended use |
59
+ | `SMTP_USER=alice@example.com`, allow `bob@example.org` | no | Likely spam-foldered or rejected if `example.org` publishes `p=quarantine`/`p=reject` |
60
+
61
+ Keep allowlisted addresses on a domain your SMTP account can authenticate for. To send as a genuinely different
62
+ domain, authorise it at the provider — add the domain to the account, publish an SPF record covering the provider,
63
+ and enable DKIM signing for it. This allowlist controls what the server *permits*; it cannot make a receiving
64
+ server trust you.
65
+
66
+ `SMTP_FROM_NAME` and the per-call `fromName` change only the display name, never the address, so they carry no
67
+ deliverability risk. Prefer them when you just want a distinct agent identity on a shared mailbox.
68
+
36
69
  ## Tools (12)
37
70
 
38
71
  See [docs/tools/email-mcp.md](../../docs/tools/email-mcp.md) for full parameter and output details.
@@ -41,7 +74,7 @@ See [docs/tools/email-mcp.md](../../docs/tools/email-mcp.md) for full parameter
41
74
  |------|-------------|
42
75
  | `search_emails` | Search and filter emails by folder, sender, subject, date, flags |
43
76
  | `get_email` | Fetch full email by UID — headers, body, attachment metadata |
44
- | `send_email` | Compose and send via SMTP, reply with threading, or save as draft |
77
+ | `send_email` | Compose and send via SMTP, reply with threading, save as draft, or use an allowed visible From address |
45
78
  | `send_draft` | Send an existing draft from the Drafts folder |
46
79
  | `move_email` | Move emails between folders |
47
80
  | `mark_email` | Set/unset flags (read, unread, flagged) |
package/dist/main.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { Server } from "@modelcontextprotocol/sdk/server/index.js";
2
- export declare function createServer(): Promise<Server>;
1
+ import { McpServer } from "@modelcontextprotocol/server";
2
+ export declare function createServer(): Promise<McpServer>;
3
3
  export declare function startServer(): Promise<void>;
4
4
  //# sourceMappingURL=main.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAWnE,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CA+BpD;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAKjD"}
1
+ {"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAUzD,wBAAsB,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC,CA2BvD;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAOjD"}
package/dist/main.js CHANGED
@@ -1,41 +1,40 @@
1
1
  import { createRequire } from "node:module";
2
2
  import { loadEmailConfig } from "@miguelarios/pim-core";
3
- import { Server } from "@modelcontextprotocol/sdk/server/index.js";
4
- import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
5
- import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
3
+ import { TOOL_LIST_CACHE_HINT, registerTools } from "@miguelarios/pim-core/mcp";
4
+ import { McpServer } from "@modelcontextprotocol/server";
5
+ import { serveStdio } from "@modelcontextprotocol/server/stdio";
6
6
  import { disposeUrlCleaner } from "./htmlToMarkdown.js";
7
7
  import { ImapService } from "./services/ImapService.js";
8
8
  import { SmtpService } from "./services/SmtpService.js";
9
- import { EMAIL_TOOLS, handleEmailTool } from "./tools/emailTools.js";
9
+ import { EMAIL_TOOLS } from "./tools/emailTools.js";
10
10
  const require = createRequire(import.meta.url);
11
11
  const { version } = require("../package.json");
12
12
  export async function createServer() {
13
13
  const config = loadEmailConfig();
14
- const imapService = new ImapService(config);
15
- const smtpService = new SmtpService(config);
16
- const server = new Server({ name: "@miguelarios/email-mcp", version }, { capabilities: { tools: {} } });
17
- server.setRequestHandler(ListToolsRequestSchema, () => ({
18
- tools: EMAIL_TOOLS,
19
- }));
20
- server.setRequestHandler(CallToolRequestSchema, async (request) => {
21
- const { name, arguments: args } = request.params;
22
- return handleEmailTool(name, (args ?? {}), imapService, smtpService);
14
+ const services = {
15
+ imap: new ImapService(config),
16
+ smtp: new SmtpService(config),
17
+ };
18
+ const server = new McpServer({ name: "@miguelarios/email-mcp", title: "IMAP/SMTP Email", version }, {
19
+ capabilities: { tools: { listChanged: false } },
20
+ instructions: "Read, search and send email over IMAP/SMTP. Folder paths are IMAP paths and default to INBOX — call list_folders to discover them. send_email, send_draft and permanent deletes ask the user to confirm first.",
21
+ cacheHints: { "tools/list": TOOL_LIST_CACHE_HINT },
23
22
  });
23
+ registerTools(server, EMAIL_TOOLS, services);
24
24
  const handleShutdown = async () => {
25
25
  await disposeUrlCleaner();
26
26
  process.exit(0);
27
27
  };
28
28
  process.on("SIGINT", handleShutdown);
29
29
  process.on("SIGTERM", handleShutdown);
30
- server.onerror = (error) => {
31
- console.error("[email-mcp] Server error:", error.message);
32
- };
33
30
  return server;
34
31
  }
35
32
  export async function startServer() {
36
- const server = await createServer();
37
- const transport = new StdioServerTransport();
38
- await server.connect(transport);
33
+ // `serveStdio` owns the era decision: a 2026-07-28 client gets the new
34
+ // protocol, and a 2025-era client is still served from the same factory.
35
+ serveStdio(() => createServer(), {
36
+ onerror: (error) => console.error("[email-mcp] Server error:", error.message),
37
+ });
39
38
  console.error("[email-mcp] Server started on stdio");
40
39
  }
41
40
  //# sourceMappingURL=main.js.map
package/dist/main.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,EAC3C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC;QACtD,KAAK,EAAE,WAAW;KACnB,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,OAAO,eAAe,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;QAChC,MAAM,iBAAiB,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAEtC,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE;QACzB,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC"}
1
+ {"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,IAAI,WAAW,CAAC,MAAM,CAAC;QAC7B,IAAI,EAAE,IAAI,WAAW,CAAC,MAAM,CAAC;KAC9B,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,EACrE;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE;QAC/C,YAAY,EACV,gNAAgN;QAClN,UAAU,EAAE,EAAE,YAAY,EAAE,oBAAoB,EAAE;KACnD,CACF,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAE7C,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;QAChC,MAAM,iBAAiB,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAEtC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,uEAAuE;IACvE,yEAAyE;IACzE,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,EAAE;QAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,OAAO,CAAC;KAC9E,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC"}
@@ -38,6 +38,9 @@ export interface ComposeOptions {
38
38
  export declare class SmtpService {
39
39
  readonly config: EmailConfig;
40
40
  constructor(config: EmailConfig);
41
+ private normalizedAllowedFromAddresses;
42
+ resolveFromAddress(requestedFrom?: string): string;
43
+ formatFromHeader(fromAddress: string, displayName?: string): string;
41
44
  private createTransporter;
42
45
  sendEmail(options: SendEmailOptions): Promise<SendResult>;
43
46
  composeRawMessage(options: ComposeOptions, opts?: {
@@ -1 +1 @@
1
- {"version":3,"file":"SmtpService.d.ts","sourceRoot":"","sources":["../../src/services/SmtpService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAc,MAAM,uBAAuB,CAAC;AAKrE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;gBAEjB,MAAM,EAAE,WAAW;IAI/B,OAAO,CAAC,iBAAiB;IAYnB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IA4BzD,iBAAiB,CACrB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAC/B,OAAO,CAAC,MAAM,CAAC;IA+BZ,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,EAAE,CAAA;KAAE,GACvC,OAAO,CAAC,UAAU,CAAC;CAiBvB"}
1
+ {"version":3,"file":"SmtpService.d.ts","sourceRoot":"","sources":["../../src/services/SmtpService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAc,MAAM,uBAAuB,CAAC;AAKrE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;gBAEjB,MAAM,EAAE,WAAW;IAI/B,OAAO,CAAC,8BAA8B;IAUtC,kBAAkB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM;IAkBlD,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM;IAKnE,OAAO,CAAC,iBAAiB;IAYnB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IA0BzD,iBAAiB,CACrB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAC/B,OAAO,CAAC,MAAM,CAAC;IA+BZ,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,EAAE,CAAA;KAAE,GACvC,OAAO,CAAC,UAAU,CAAC;CAiBvB"}
@@ -6,6 +6,27 @@ export class SmtpService {
6
6
  constructor(config) {
7
7
  this.config = config;
8
8
  }
9
+ normalizedAllowedFromAddresses() {
10
+ return Array.from(new Set([this.config.smtp.user, ...(this.config.allowedFrom || [])]
11
+ .map((value) => value.trim().toLowerCase())
12
+ .filter(Boolean)));
13
+ }
14
+ resolveFromAddress(requestedFrom) {
15
+ const fallback = this.config.smtp.user;
16
+ if (!requestedFrom)
17
+ return fallback;
18
+ const normalizedRequested = requestedFrom.trim().toLowerCase();
19
+ if (!normalizedRequested)
20
+ return fallback;
21
+ if (!this.normalizedAllowedFromAddresses().includes(normalizedRequested)) {
22
+ throw toPimError(new Error(`Requested from address is not allowed: ${requestedFrom}. Allowed addresses: ${this.normalizedAllowedFromAddresses().join(", ")}`));
23
+ }
24
+ return requestedFrom.trim();
25
+ }
26
+ formatFromHeader(fromAddress, displayName) {
27
+ const effectiveName = displayName?.trim() || this.config.fromName;
28
+ return effectiveName ? `"${effectiveName}" <${fromAddress}>` : fromAddress;
29
+ }
9
30
  createTransporter() {
10
31
  return nodemailer.createTransport({
11
32
  host: this.config.smtp.host,
@@ -20,9 +41,7 @@ export class SmtpService {
20
41
  async sendEmail(options) {
21
42
  const transporter = this.createTransporter();
22
43
  try {
23
- const from = this.config.fromName
24
- ? `"${this.config.fromName}" <${this.config.smtp.user}>`
25
- : this.config.smtp.user;
44
+ const from = this.formatFromHeader(this.resolveFromAddress());
26
45
  const info = await transporter.sendMail({
27
46
  from,
28
47
  to: options.to.join(", "),
@@ -1 +1 @@
1
- {"version":3,"file":"SmtpService.js","sourceRoot":"","sources":["../../src/services/SmtpService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,OAAO,YAAY,MAAM,uCAAuC,CAAC;AAyCjE,MAAM,OAAO,WAAW;IACb,MAAM,CAAc;IAE7B,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEO,iBAAiB;QACvB,OAAO,UAAU,CAAC,eAAe,CAAC;YAChC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;YAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM;YAC/B,IAAI,EAAE;gBACJ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;gBAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;aAC5B;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAyB;QACvC,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC/B,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG;gBACxD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YAE1B,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC;gBACtC,IAAI;gBACJ,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;gBACzB,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC;gBAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;gBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,WAAW,EAAE,OAAO,CAAC,WAAW;aACjC,CAAC,CAAC;YAEH,OAAO;gBACL,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,IAAI,CAAC,QAAoB;gBACnC,QAAQ,EAAE,IAAI,CAAC,QAAoB;aACpC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,OAAuB,EACvB,OAA8B,EAAE;QAEhC,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC;YAChC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;YACzB,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC;YAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC;SAC1C,CAAC,CAAC;QAEH,sEAAsE;QACtE,sEAAsE;QACtE,mEAAmE;QACnE,qDAAqD;QACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACzB,OAA2C,CAAC,OAAO,GAAG,IAAI,CAAC;QAC9D,CAAC;QAED,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;gBAC3B,IAAI,GAAG;oBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;oBAChB,OAAO,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,SAAiB,EACjB,QAAwC;QAExC,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC;gBACtC,QAAQ;gBACR,GAAG,EAAE,SAAS;aACf,CAAC,CAAC;YAEH,OAAO;gBACL,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,IAAI,CAAC,QAAoB;gBACnC,QAAQ,EAAE,IAAI,CAAC,QAAoB;aACpC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;CACF"}
1
+ {"version":3,"file":"SmtpService.js","sourceRoot":"","sources":["../../src/services/SmtpService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,OAAO,YAAY,MAAM,uCAAuC,CAAC;AAyCjE,MAAM,OAAO,WAAW;IACb,MAAM,CAAc;IAE7B,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEO,8BAA8B;QACpC,OAAO,KAAK,CAAC,IAAI,CACf,IAAI,GAAG,CACL,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;aACxD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;aAC1C,MAAM,CAAC,OAAO,CAAC,CACnB,CACF,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,aAAsB;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QACvC,IAAI,CAAC,aAAa;YAAE,OAAO,QAAQ,CAAC;QAEpC,MAAM,mBAAmB,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC/D,IAAI,CAAC,mBAAmB;YAAE,OAAO,QAAQ,CAAC;QAE1C,IAAI,CAAC,IAAI,CAAC,8BAA8B,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACzE,MAAM,UAAU,CACd,IAAI,KAAK,CACP,0CAA0C,aAAa,wBAAwB,IAAI,CAAC,8BAA8B,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClI,CACF,CAAC;QACJ,CAAC;QAED,OAAO,aAAa,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,gBAAgB,CAAC,WAAmB,EAAE,WAAoB;QACxD,MAAM,aAAa,GAAG,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QAClE,OAAO,aAAa,CAAC,CAAC,CAAC,IAAI,aAAa,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC;IAC7E,CAAC;IAEO,iBAAiB;QACvB,OAAO,UAAU,CAAC,eAAe,CAAC;YAChC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;YAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM;YAC/B,IAAI,EAAE;gBACJ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;gBAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;aAC5B;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAyB;QACvC,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;YAE9D,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC;gBACtC,IAAI;gBACJ,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;gBACzB,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC;gBAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;gBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,WAAW,EAAE,OAAO,CAAC,WAAW;aACjC,CAAC,CAAC;YAEH,OAAO;gBACL,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,IAAI,CAAC,QAAoB;gBACnC,QAAQ,EAAE,IAAI,CAAC,QAAoB;aACpC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,OAAuB,EACvB,OAA8B,EAAE;QAEhC,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC;YAChC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;YACzB,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC;YAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC;SAC1C,CAAC,CAAC;QAEH,sEAAsE;QACtE,sEAAsE;QACtE,mEAAmE;QACnE,qDAAqD;QACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACzB,OAA2C,CAAC,OAAO,GAAG,IAAI,CAAC;QAC9D,CAAC;QAED,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;gBAC3B,IAAI,GAAG;oBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;oBAChB,OAAO,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,SAAiB,EACjB,QAAwC;QAExC,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC;gBACtC,QAAQ;gBACR,GAAG,EAAE,SAAS;aACf,CAAC,CAAC;YAEH,OAAO;gBACL,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,IAAI,CAAC,QAAoB;gBACnC,QAAQ,EAAE,IAAI,CAAC,QAAoB;aACpC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;CACF"}
@@ -0,0 +1,134 @@
1
+ /**
2
+ * Valibot output schemas for the email tools. These drive the `outputSchema`
3
+ * advertised in `tools/list` and validate `structuredContent` before it leaves
4
+ * the server.
5
+ *
6
+ * They mirror `EmailSummary`, `EmailFull`, `FolderInfo` and `AttachmentData`
7
+ * from `../services/ImapService.js`.
8
+ */
9
+ import * as v from "valibot";
10
+ export declare const emailSummarySchema: v.ObjectSchema<{
11
+ readonly uid: v.NumberSchema<undefined>;
12
+ readonly messageId: v.StringSchema<undefined>;
13
+ readonly subject: v.StringSchema<undefined>;
14
+ readonly from: v.ObjectSchema<{
15
+ readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
16
+ readonly address: v.StringSchema<undefined>;
17
+ }, undefined>;
18
+ readonly to: v.ArraySchema<v.ObjectSchema<{
19
+ readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
20
+ readonly address: v.StringSchema<undefined>;
21
+ }, undefined>, undefined>;
22
+ readonly date: v.StringSchema<undefined>;
23
+ readonly flags: v.ArraySchema<v.StringSchema<undefined>, undefined>;
24
+ readonly hasAttachments: v.BooleanSchema<undefined>;
25
+ }, undefined>;
26
+ /** `get_email` drops whichever body fields the requested `format` excludes. */
27
+ export declare const emailFullSchema: v.ObjectSchema<{
28
+ readonly cc: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
29
+ readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
30
+ readonly address: v.StringSchema<undefined>;
31
+ }, undefined>, undefined>, undefined>;
32
+ readonly inReplyTo: v.NullableSchema<v.StringSchema<undefined>, undefined>;
33
+ readonly references: v.ArraySchema<v.StringSchema<undefined>, undefined>;
34
+ readonly textBody: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
35
+ readonly htmlBody: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
36
+ readonly markdownBody: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
37
+ readonly attachments: v.ArraySchema<v.ObjectSchema<{
38
+ readonly filename: v.StringSchema<undefined>;
39
+ readonly contentType: v.StringSchema<undefined>;
40
+ readonly size: v.NumberSchema<undefined>;
41
+ readonly partId: v.StringSchema<undefined>;
42
+ }, undefined>, undefined>;
43
+ readonly uid: v.NumberSchema<undefined>;
44
+ readonly messageId: v.StringSchema<undefined>;
45
+ readonly subject: v.StringSchema<undefined>;
46
+ readonly from: v.ObjectSchema<{
47
+ readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
48
+ readonly address: v.StringSchema<undefined>;
49
+ }, undefined>;
50
+ readonly to: v.ArraySchema<v.ObjectSchema<{
51
+ readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
52
+ readonly address: v.StringSchema<undefined>;
53
+ }, undefined>, undefined>;
54
+ readonly date: v.StringSchema<undefined>;
55
+ readonly flags: v.ArraySchema<v.StringSchema<undefined>, undefined>;
56
+ readonly hasAttachments: v.BooleanSchema<undefined>;
57
+ }, undefined>;
58
+ export declare const searchResultSchema: v.ObjectSchema<{
59
+ readonly emails: v.ArraySchema<v.ObjectSchema<{
60
+ readonly uid: v.NumberSchema<undefined>;
61
+ readonly messageId: v.StringSchema<undefined>;
62
+ readonly subject: v.StringSchema<undefined>;
63
+ readonly from: v.ObjectSchema<{
64
+ readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
65
+ readonly address: v.StringSchema<undefined>;
66
+ }, undefined>;
67
+ readonly to: v.ArraySchema<v.ObjectSchema<{
68
+ readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
69
+ readonly address: v.StringSchema<undefined>;
70
+ }, undefined>, undefined>;
71
+ readonly date: v.StringSchema<undefined>;
72
+ readonly flags: v.ArraySchema<v.StringSchema<undefined>, undefined>;
73
+ readonly hasAttachments: v.BooleanSchema<undefined>;
74
+ }, undefined>, undefined>;
75
+ readonly count: v.NumberSchema<undefined>;
76
+ }, undefined>;
77
+ export declare const folderListSchema: v.ObjectSchema<{
78
+ readonly folders: v.ArraySchema<v.ObjectSchema<{
79
+ readonly path: v.StringSchema<undefined>;
80
+ readonly specialUse: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
81
+ readonly delimiter: v.StringSchema<undefined>;
82
+ }, undefined>, undefined>;
83
+ }, undefined>;
84
+ export declare const folderStatusSchema: v.ObjectSchema<{
85
+ readonly total: v.NumberSchema<undefined>;
86
+ readonly unseen: v.NumberSchema<undefined>;
87
+ }, undefined>;
88
+ export declare const sendResultSchema: v.VariantSchema<"status", [v.ObjectSchema<{
89
+ readonly status: v.LiteralSchema<"sent", undefined>;
90
+ readonly messageId: v.StringSchema<undefined>;
91
+ readonly folder: v.StringSchema<undefined>;
92
+ }, undefined>, v.ObjectSchema<{
93
+ readonly status: v.LiteralSchema<"draft", undefined>;
94
+ readonly uid: v.NumberSchema<undefined>;
95
+ readonly folder: v.StringSchema<undefined>;
96
+ }, undefined>], undefined>;
97
+ export declare const moveResultSchema: v.ObjectSchema<{
98
+ readonly status: v.LiteralSchema<"moved", undefined>;
99
+ readonly uids: v.ArraySchema<v.NumberSchema<undefined>, undefined>;
100
+ readonly destination: v.StringSchema<undefined>;
101
+ }, undefined>;
102
+ export declare const markResultSchema: v.ObjectSchema<{
103
+ readonly status: v.LiteralSchema<"updated", undefined>;
104
+ readonly uids: v.ArraySchema<v.NumberSchema<undefined>, undefined>;
105
+ readonly flags: v.ArraySchema<v.StringSchema<undefined>, undefined>;
106
+ readonly action: v.PicklistSchema<["add", "remove"], undefined>;
107
+ }, undefined>;
108
+ export declare const deleteResultSchema: v.ObjectSchema<{
109
+ readonly status: v.PicklistSchema<["permanently_deleted", "moved_to_trash"], undefined>;
110
+ readonly uids: v.ArraySchema<v.NumberSchema<undefined>, undefined>;
111
+ }, undefined>;
112
+ export declare const createFolderResultSchema: v.ObjectSchema<{
113
+ readonly status: v.LiteralSchema<"created", undefined>;
114
+ readonly path: v.StringSchema<undefined>;
115
+ }, undefined>;
116
+ /**
117
+ * Metadata only — the bytes ride in the result's embedded binary resource
118
+ * block, so a large attachment is not duplicated in the payload.
119
+ */
120
+ export declare const attachmentSchema: v.ObjectSchema<{
121
+ readonly filename: v.StringSchema<undefined>;
122
+ readonly contentType: v.StringSchema<undefined>;
123
+ readonly size: v.NumberSchema<undefined>;
124
+ }, undefined>;
125
+ /**
126
+ * Metadata only — the RFC 822 source itself rides in the result's embedded
127
+ * resource block, so a multi-megabyte .eml is not duplicated in the payload.
128
+ */
129
+ export declare const rawEmailSchema: v.ObjectSchema<{
130
+ readonly uid: v.NumberSchema<undefined>;
131
+ readonly folder: v.StringSchema<undefined>;
132
+ readonly size: v.NumberSchema<undefined>;
133
+ }, undefined>;
134
+ //# sourceMappingURL=emailSchemas.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"emailSchemas.d.ts","sourceRoot":"","sources":["../../src/tools/emailSchemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAO7B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;aAS7B,CAAC;AAEH,+EAA+E;AAC/E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAgB1B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;aAG7B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;aAQ3B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;aAG7B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;0BAW3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;aAI3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;aAK3B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;aAG7B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;aAGnC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;aAI3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;aAIzB,CAAC"}
@@ -0,0 +1,104 @@
1
+ /**
2
+ * Valibot output schemas for the email tools. These drive the `outputSchema`
3
+ * advertised in `tools/list` and validate `structuredContent` before it leaves
4
+ * the server.
5
+ *
6
+ * They mirror `EmailSummary`, `EmailFull`, `FolderInfo` and `AttachmentData`
7
+ * from `../services/ImapService.js`.
8
+ */
9
+ import * as v from "valibot";
10
+ const address = v.object({
11
+ name: v.optional(v.string()),
12
+ address: v.string(),
13
+ });
14
+ export const emailSummarySchema = v.object({
15
+ uid: v.number(),
16
+ messageId: v.string(),
17
+ subject: v.string(),
18
+ from: address,
19
+ to: v.array(address),
20
+ date: v.string(),
21
+ flags: v.array(v.string()),
22
+ hasAttachments: v.boolean(),
23
+ });
24
+ /** `get_email` drops whichever body fields the requested `format` excludes. */
25
+ export const emailFullSchema = v.object({
26
+ ...emailSummarySchema.entries,
27
+ cc: v.optional(v.array(address)),
28
+ inReplyTo: v.nullable(v.string()),
29
+ references: v.array(v.string()),
30
+ textBody: v.optional(v.string()),
31
+ htmlBody: v.optional(v.string()),
32
+ markdownBody: v.optional(v.string()),
33
+ attachments: v.array(v.object({
34
+ filename: v.string(),
35
+ contentType: v.string(),
36
+ size: v.number(),
37
+ partId: v.string(),
38
+ })),
39
+ });
40
+ export const searchResultSchema = v.object({
41
+ emails: v.array(emailSummarySchema),
42
+ count: v.number(),
43
+ });
44
+ export const folderListSchema = v.object({
45
+ folders: v.array(v.object({
46
+ path: v.string(),
47
+ specialUse: v.optional(v.string()),
48
+ delimiter: v.string(),
49
+ })),
50
+ });
51
+ export const folderStatusSchema = v.object({
52
+ total: v.number(),
53
+ unseen: v.number(),
54
+ });
55
+ export const sendResultSchema = v.variant("status", [
56
+ v.object({
57
+ status: v.literal("sent"),
58
+ messageId: v.string(),
59
+ folder: v.string(),
60
+ }),
61
+ v.object({
62
+ status: v.literal("draft"),
63
+ uid: v.number(),
64
+ folder: v.string(),
65
+ }),
66
+ ]);
67
+ export const moveResultSchema = v.object({
68
+ status: v.literal("moved"),
69
+ uids: v.array(v.number()),
70
+ destination: v.string(),
71
+ });
72
+ export const markResultSchema = v.object({
73
+ status: v.literal("updated"),
74
+ uids: v.array(v.number()),
75
+ flags: v.array(v.string()),
76
+ action: v.picklist(["add", "remove"]),
77
+ });
78
+ export const deleteResultSchema = v.object({
79
+ status: v.picklist(["permanently_deleted", "moved_to_trash"]),
80
+ uids: v.array(v.number()),
81
+ });
82
+ export const createFolderResultSchema = v.object({
83
+ status: v.literal("created"),
84
+ path: v.string(),
85
+ });
86
+ /**
87
+ * Metadata only — the bytes ride in the result's embedded binary resource
88
+ * block, so a large attachment is not duplicated in the payload.
89
+ */
90
+ export const attachmentSchema = v.object({
91
+ filename: v.string(),
92
+ contentType: v.string(),
93
+ size: v.number(),
94
+ });
95
+ /**
96
+ * Metadata only — the RFC 822 source itself rides in the result's embedded
97
+ * resource block, so a multi-megabyte .eml is not duplicated in the payload.
98
+ */
99
+ export const rawEmailSchema = v.object({
100
+ uid: v.number(),
101
+ folder: v.string(),
102
+ size: v.number(),
103
+ });
104
+ //# sourceMappingURL=emailSchemas.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"emailSchemas.js","sourceRoot":"","sources":["../../src/tools/emailSchemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,OAAO;IACb,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE;CAC5B,CAAC,CAAC;AAEH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,GAAG,kBAAkB,CAAC,OAAO;IAC7B,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAChC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACpC,WAAW,EAAE,CAAC,CAAC,KAAK,CAClB,CAAC,CAAC,MAAM,CAAC;QACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC,CACH;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC,CACH;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE;IAClD,CAAC,CAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACzB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QAC1B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;CACtC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,CAAC;IAC7D,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC"}
@@ -1,12 +1,10 @@
1
- import type { Tool } from "@modelcontextprotocol/sdk/types.js";
1
+ import { type ToolDef } from "@miguelarios/pim-core/mcp";
2
2
  import type { ImapService } from "../services/ImapService.js";
3
3
  import type { SmtpService } from "../services/SmtpService.js";
4
- export declare const EMAIL_TOOLS: Tool[];
5
- export declare function handleEmailTool(name: string, args: Record<string, unknown>, imapService: ImapService, smtpService: SmtpService): Promise<{
6
- content: Array<{
7
- type: "text";
8
- text: string;
9
- }>;
10
- isError?: boolean;
11
- }>;
4
+ /** Both backing services, passed to every handler as one unit. */
5
+ export interface EmailServices {
6
+ imap: ImapService;
7
+ smtp: SmtpService;
8
+ }
9
+ export declare const EMAIL_TOOLS: ReadonlyArray<ToolDef<EmailServices>>;
12
10
  //# sourceMappingURL=emailTools.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"emailTools.d.ts","sourceRoot":"","sources":["../../src/tools/emailTools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAgB9D,eAAO,MAAM,WAAW,EAAE,IAAI,EAiX7B,CAAC;AAEF,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC;IACT,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAqTD"}
1
+ {"version":3,"file":"emailTools.d.ts","sourceRoot":"","sources":["../../src/tools/emailTools.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,OAAO,EAMb,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAe9D,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;CACnB;AA8CD,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,CA+rB7D,CAAC"}