@miguelarios/email-mcp 0.10.0 → 0.12.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.
@@ -0,0 +1,113 @@
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
+ calendarParts: v.optional(v.array(v.object({
40
+ partId: v.string(),
41
+ contentType: v.string(),
42
+ method: v.nullable(v.string()),
43
+ filename: v.nullable(v.string()),
44
+ size: v.number(),
45
+ content: v.optional(v.string()),
46
+ truncated: v.optional(v.boolean()),
47
+ }))),
48
+ });
49
+ export const searchResultSchema = v.object({
50
+ emails: v.array(emailSummarySchema),
51
+ count: v.number(),
52
+ });
53
+ export const folderListSchema = v.object({
54
+ folders: v.array(v.object({
55
+ path: v.string(),
56
+ specialUse: v.optional(v.string()),
57
+ delimiter: v.string(),
58
+ })),
59
+ });
60
+ export const folderStatusSchema = v.object({
61
+ total: v.number(),
62
+ unseen: v.number(),
63
+ });
64
+ export const sendResultSchema = v.variant("status", [
65
+ v.object({
66
+ status: v.literal("sent"),
67
+ messageId: v.string(),
68
+ folder: v.string(),
69
+ }),
70
+ v.object({
71
+ status: v.literal("draft"),
72
+ uid: v.number(),
73
+ folder: v.string(),
74
+ }),
75
+ ]);
76
+ export const moveResultSchema = v.object({
77
+ status: v.literal("moved"),
78
+ uids: v.array(v.number()),
79
+ destination: v.string(),
80
+ });
81
+ export const markResultSchema = v.object({
82
+ status: v.literal("updated"),
83
+ uids: v.array(v.number()),
84
+ flags: v.array(v.string()),
85
+ action: v.picklist(["add", "remove"]),
86
+ });
87
+ export const deleteResultSchema = v.object({
88
+ status: v.picklist(["permanently_deleted", "moved_to_trash"]),
89
+ uids: v.array(v.number()),
90
+ });
91
+ export const createFolderResultSchema = v.object({
92
+ status: v.literal("created"),
93
+ path: v.string(),
94
+ });
95
+ /**
96
+ * Metadata only — the bytes ride in the result's embedded binary resource
97
+ * block, so a large attachment is not duplicated in the payload.
98
+ */
99
+ export const attachmentSchema = v.object({
100
+ filename: v.string(),
101
+ contentType: v.string(),
102
+ size: v.number(),
103
+ });
104
+ /**
105
+ * Metadata only — the RFC 822 source itself rides in the result's embedded
106
+ * resource block, so a multi-megabyte .eml is not duplicated in the payload.
107
+ */
108
+ export const rawEmailSchema = v.object({
109
+ uid: v.number(),
110
+ folder: v.string(),
111
+ size: v.number(),
112
+ });
113
+ //# sourceMappingURL=emailSchemas.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"emailSchemas.js","sourceRoot":"","sources":["../../src/tools/emailSchemas.ts"],"names":[],"mappings":"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"}
@@ -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"}