@usejunior/email-core 0.3.2 → 0.3.4
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/dist/actions/attachments.d.ts +27 -1
- package/dist/actions/attachments.d.ts.map +1 -1
- package/dist/actions/attachments.js +153 -35
- package/dist/actions/attachments.js.map +1 -1
- package/dist/actions/compose-helpers.d.ts +61 -0
- package/dist/actions/compose-helpers.d.ts.map +1 -1
- package/dist/actions/compose-helpers.js +109 -21
- package/dist/actions/compose-helpers.js.map +1 -1
- package/dist/actions/draft.d.ts +3 -0
- package/dist/actions/draft.d.ts.map +1 -1
- package/dist/actions/draft.js +74 -14
- package/dist/actions/draft.js.map +1 -1
- package/dist/actions/registry.d.ts +10 -0
- package/dist/actions/registry.d.ts.map +1 -1
- package/dist/actions/registry.js +2 -1
- package/dist/actions/registry.js.map +1 -1
- package/dist/actions/reply.d.ts +1 -0
- package/dist/actions/reply.d.ts.map +1 -1
- package/dist/actions/reply.js +23 -2
- package/dist/actions/reply.js.map +1 -1
- package/dist/actions/send.d.ts +1 -0
- package/dist/actions/send.d.ts.map +1 -1
- package/dist/actions/send.js +60 -5
- package/dist/actions/send.js.map +1 -1
- package/dist/content/frontmatter.d.ts +1 -0
- package/dist/content/frontmatter.d.ts.map +1 -1
- package/dist/content/frontmatter.js +2 -2
- package/dist/content/frontmatter.js.map +1 -1
- package/dist/content/safe-path.d.ts +18 -0
- package/dist/content/safe-path.d.ts.map +1 -1
- package/dist/content/safe-path.js +4 -4
- package/dist/content/safe-path.js.map +1 -1
- package/dist/content/save-file.d.ts +32 -0
- package/dist/content/save-file.d.ts.map +1 -0
- package/dist/content/save-file.js +191 -0
- package/dist/content/save-file.js.map +1 -0
- package/dist/index.d.ts +5 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -2
- package/dist/index.js.map +1 -1
- package/dist/providers/provider.d.ts +12 -1
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +9 -0
- package/dist/providers/provider.js.map +1 -1
- package/dist/security/send-ledger.d.ts +209 -0
- package/dist/security/send-ledger.d.ts.map +1 -0
- package/dist/security/send-ledger.js +403 -0
- package/dist/security/send-ledger.js.map +1 -0
- package/dist/testing/mock-provider.d.ts +3 -0
- package/dist/testing/mock-provider.d.ts.map +1 -1
- package/dist/testing/mock-provider.js +19 -3
- package/dist/testing/mock-provider.js.map +1 -1
- package/package.json +1 -1
|
@@ -31,11 +31,14 @@ declare const ListAttachmentsOutput: z.ZodObject<{
|
|
|
31
31
|
}, z.core.$strip>>;
|
|
32
32
|
}, z.core.$strip>;
|
|
33
33
|
export declare const listAttachmentsAction: EmailAction<z.infer<typeof ListAttachmentsInput>, z.infer<typeof ListAttachmentsOutput>>;
|
|
34
|
+
export declare const MAX_SAVE_SIZE_MB = 150;
|
|
34
35
|
declare const DownloadAttachmentInput: z.ZodObject<{
|
|
35
36
|
message_id: z.ZodString;
|
|
36
37
|
attachment_id: z.ZodString;
|
|
37
38
|
mailbox: z.ZodOptional<z.ZodString>;
|
|
38
|
-
max_size_mb: z.
|
|
39
|
+
max_size_mb: z.ZodOptional<z.ZodNumber>;
|
|
40
|
+
save_to: z.ZodOptional<z.ZodString>;
|
|
41
|
+
filename: z.ZodOptional<z.ZodString>;
|
|
39
42
|
}, z.core.$strip>;
|
|
40
43
|
declare const DownloadAttachmentOutput: z.ZodObject<{
|
|
41
44
|
success: z.ZodBoolean;
|
|
@@ -44,6 +47,8 @@ declare const DownloadAttachmentOutput: z.ZodObject<{
|
|
|
44
47
|
mimeType: z.ZodOptional<z.ZodString>;
|
|
45
48
|
size: z.ZodOptional<z.ZodNumber>;
|
|
46
49
|
base64: z.ZodOptional<z.ZodString>;
|
|
50
|
+
path: z.ZodOptional<z.ZodString>;
|
|
51
|
+
sha256: z.ZodOptional<z.ZodString>;
|
|
47
52
|
error: z.ZodOptional<z.ZodObject<{
|
|
48
53
|
code: z.ZodString;
|
|
49
54
|
message: z.ZodString;
|
|
@@ -51,6 +56,27 @@ declare const DownloadAttachmentOutput: z.ZodObject<{
|
|
|
51
56
|
}, z.core.$strip>>;
|
|
52
57
|
}, z.core.$strip>;
|
|
53
58
|
export declare const downloadAttachmentAction: EmailAction<z.infer<typeof DownloadAttachmentInput>, z.infer<typeof DownloadAttachmentOutput>>;
|
|
59
|
+
declare const DownloadMessageInput: z.ZodObject<{
|
|
60
|
+
message_id: z.ZodString;
|
|
61
|
+
mailbox: z.ZodOptional<z.ZodString>;
|
|
62
|
+
save_to: z.ZodString;
|
|
63
|
+
filename: z.ZodOptional<z.ZodString>;
|
|
64
|
+
max_size_mb: z.ZodOptional<z.ZodNumber>;
|
|
65
|
+
}, z.core.$strip>;
|
|
66
|
+
declare const DownloadMessageOutput: z.ZodObject<{
|
|
67
|
+
success: z.ZodBoolean;
|
|
68
|
+
path: z.ZodOptional<z.ZodString>;
|
|
69
|
+
filename: z.ZodOptional<z.ZodString>;
|
|
70
|
+
mimeType: z.ZodOptional<z.ZodString>;
|
|
71
|
+
size: z.ZodOptional<z.ZodNumber>;
|
|
72
|
+
sha256: z.ZodOptional<z.ZodString>;
|
|
73
|
+
error: z.ZodOptional<z.ZodObject<{
|
|
74
|
+
code: z.ZodString;
|
|
75
|
+
message: z.ZodString;
|
|
76
|
+
recoverable: z.ZodBoolean;
|
|
77
|
+
}, z.core.$strip>>;
|
|
78
|
+
}, z.core.$strip>;
|
|
79
|
+
export declare const downloadMessageAction: EmailAction<z.infer<typeof DownloadMessageInput>, z.infer<typeof DownloadMessageOutput>>;
|
|
54
80
|
export declare function validateAttachment(content: Buffer, filename: string, declaredMimeType?: string): {
|
|
55
81
|
valid: boolean;
|
|
56
82
|
detectedMimeType: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../src/actions/attachments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../src/actions/attachments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAgBjD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAuBtD,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAchG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYzD;AAGD,QAAA,MAAM,oBAAoB;;;iBAGxB,CAAC;AAYH,QAAA,MAAM,qBAAqB;;;;;;;;;;iBAEzB,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAC7C,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,EACpC,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAsBtC,CAAC;AASF,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAWpC,QAAA,MAAM,uBAAuB;;;;;;;iBAS3B,CAAC;AAEH,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;iBAU5B,CAAC;AAQH,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAChD,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,EACvC,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CA4FzC,CAAC;AAMF,QAAA,MAAM,oBAAoB;;;;;;iBAQxB,CAAC;AAEH,QAAA,MAAM,qBAAqB;;;;;;;;;;;;iBAQzB,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAC7C,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,EACpC,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAsDtC,CAAC;AAGF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,GACxB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAY9D"}
|
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
// Attachment handling actions
|
|
2
2
|
import { z } from 'zod';
|
|
3
3
|
import { extname } from 'node:path';
|
|
4
|
-
import { AttachmentNotSupportedError, AttachmentNotFoundError } from '../providers/provider.js';
|
|
4
|
+
import { AttachmentNotSupportedError, AttachmentNotFoundError, MessageNotFoundError } from '../providers/provider.js';
|
|
5
5
|
import { MAX_ATTACHMENT_SIZE } from '../content/attachment-loader.js';
|
|
6
|
+
import { resolveSaveDir, toDiskFilename, writeFileExclusive } from '../content/save-file.js';
|
|
6
7
|
// Binary file magic bytes
|
|
7
8
|
const MAGIC_BYTES = [
|
|
8
9
|
[Buffer.from([0xff, 0xd8, 0xff]), 'image/jpeg'],
|
|
@@ -114,12 +115,29 @@ export const listAttachmentsAction = {
|
|
|
114
115
|
return { attachments };
|
|
115
116
|
},
|
|
116
117
|
};
|
|
117
|
-
// Download a single attachment
|
|
118
|
+
// Download a single attachment — inline base64 by default, or written to a
|
|
119
|
+
// sandboxed local directory with `save_to` (#169).
|
|
120
|
+
const DEFAULT_INLINE_SIZE_MB = 5;
|
|
121
|
+
const MAX_INLINE_SIZE_MB = 25;
|
|
122
|
+
// save_to keeps the bytes server-side, so the inline ceiling (which exists to
|
|
123
|
+
// protect the agent's context) does not apply. 150 MB is Outlook's largest
|
|
124
|
+
// attachment, uploaded via upload session.
|
|
125
|
+
export const MAX_SAVE_SIZE_MB = 150;
|
|
126
|
+
const SAVE_TO_DESCRIPTION = 'Directory to write the file into instead of returning base64. Sandboxed like body_file and attachment paths: relative paths resolve against the working directory only; directories in an AGENT_EMAIL_ALLOWED_DIRS root must be given as an ABSOLUTE path (a leading ~ is not expanded). Missing subdirectories are created. Existing files are never overwritten — a collision gets a numeric suffix (report.pdf, report-1.pdf, …).';
|
|
127
|
+
const ActionError = z.object({
|
|
128
|
+
code: z.string(),
|
|
129
|
+
message: z.string(),
|
|
130
|
+
recoverable: z.boolean(),
|
|
131
|
+
});
|
|
118
132
|
const DownloadAttachmentInput = z.object({
|
|
119
133
|
message_id: z.string(),
|
|
120
134
|
attachment_id: z.string(),
|
|
121
135
|
mailbox: z.string().optional(),
|
|
122
|
-
max_size_mb: z.number().int().positive().max(
|
|
136
|
+
max_size_mb: z.number().int().positive().max(MAX_SAVE_SIZE_MB).optional()
|
|
137
|
+
.describe(`Size cap in MB. Inline default ${DEFAULT_INLINE_SIZE_MB}, inline ceiling ${MAX_INLINE_SIZE_MB}; with save_to the default and ceiling are ${MAX_SAVE_SIZE_MB}.`),
|
|
138
|
+
save_to: z.string().optional().describe(SAVE_TO_DESCRIPTION),
|
|
139
|
+
filename: z.string().optional()
|
|
140
|
+
.describe('On-disk filename to use with save_to (sanitized). Defaults to the attachment\'s sanitized name.'),
|
|
123
141
|
});
|
|
124
142
|
const DownloadAttachmentOutput = z.object({
|
|
125
143
|
success: z.boolean(),
|
|
@@ -128,66 +146,166 @@ const DownloadAttachmentOutput = z.object({
|
|
|
128
146
|
mimeType: z.string().optional(),
|
|
129
147
|
size: z.number().optional(),
|
|
130
148
|
base64: z.string().optional(),
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
recoverable: z.boolean(),
|
|
135
|
-
}).optional(),
|
|
149
|
+
path: z.string().optional(),
|
|
150
|
+
sha256: z.string().optional(),
|
|
151
|
+
error: ActionError.optional(),
|
|
136
152
|
});
|
|
153
|
+
function failure(code, message, recoverable = false) {
|
|
154
|
+
return { success: false, error: { code, message, recoverable } };
|
|
155
|
+
}
|
|
137
156
|
export const downloadAttachmentAction = {
|
|
138
157
|
name: 'download_attachment',
|
|
139
|
-
description:
|
|
158
|
+
description: `Download a single attachment. By default returns inline base64 (max_size_mb default ${DEFAULT_INLINE_SIZE_MB}, ceiling ${MAX_INLINE_SIZE_MB}). Pass save_to to write the file to a sandboxed local directory instead and get back only {path, filename, mimeType, size, sha256} — use this for anything large (video, audio, big PDFs) or anything local tools need as a file. File attachments only — Microsoft item/reference attachments return NOT_SUPPORTED.`,
|
|
140
159
|
input: DownloadAttachmentInput,
|
|
141
160
|
output: DownloadAttachmentOutput,
|
|
161
|
+
// Writes only to the local sandbox, never to the mailbox.
|
|
142
162
|
annotations: { readOnlyHint: true, destructiveHint: false },
|
|
143
163
|
run: async (ctx, input) => {
|
|
144
164
|
if (typeof ctx.provider.downloadAttachment !== 'function') {
|
|
145
|
-
return
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
recoverable: false,
|
|
151
|
-
},
|
|
152
|
-
};
|
|
165
|
+
return failure('NOT_SUPPORTED', 'Provider does not support attachment download');
|
|
166
|
+
}
|
|
167
|
+
const saving = input.save_to !== undefined;
|
|
168
|
+
if (!saving && input.filename !== undefined) {
|
|
169
|
+
return failure('INVALID_ARGUMENT', 'filename is only valid together with save_to');
|
|
153
170
|
}
|
|
154
|
-
const
|
|
171
|
+
const maxMb = input.max_size_mb ?? (saving ? MAX_SAVE_SIZE_MB : DEFAULT_INLINE_SIZE_MB);
|
|
172
|
+
if (!saving && maxMb > MAX_INLINE_SIZE_MB) {
|
|
173
|
+
return failure('INVALID_ARGUMENT', `max_size_mb=${maxMb} exceeds the inline ceiling of ${MAX_INLINE_SIZE_MB}; pass save_to to write larger attachments to disk`);
|
|
174
|
+
}
|
|
175
|
+
// Resolve the destination before fetching any bytes, so a bad path fails
|
|
176
|
+
// fast instead of after a large download.
|
|
177
|
+
let saveDir;
|
|
178
|
+
if (saving) {
|
|
179
|
+
const resolved = await resolveSaveDir(input.save_to, { safeDir: ctx.safeDir, allowedDirs: ctx.allowedDirs });
|
|
180
|
+
if (resolved.error)
|
|
181
|
+
return { success: false, error: resolved.error };
|
|
182
|
+
saveDir = resolved.resolved;
|
|
183
|
+
}
|
|
184
|
+
const cap = maxMb * 1024 * 1024;
|
|
155
185
|
let downloaded;
|
|
156
186
|
try {
|
|
157
187
|
downloaded = await ctx.provider.downloadAttachment(input.message_id, input.attachment_id);
|
|
158
188
|
}
|
|
159
189
|
catch (err) {
|
|
160
190
|
if (err instanceof AttachmentNotSupportedError) {
|
|
161
|
-
return
|
|
162
|
-
success: false,
|
|
163
|
-
error: { code: 'NOT_SUPPORTED', message: err.message, recoverable: false },
|
|
164
|
-
};
|
|
191
|
+
return failure('NOT_SUPPORTED', err.message);
|
|
165
192
|
}
|
|
166
193
|
if (err instanceof AttachmentNotFoundError) {
|
|
167
|
-
return
|
|
168
|
-
success: false,
|
|
169
|
-
error: { code: 'ATTACHMENT_NOT_FOUND', message: err.message, recoverable: false },
|
|
170
|
-
};
|
|
194
|
+
return failure('ATTACHMENT_NOT_FOUND', err.message);
|
|
171
195
|
}
|
|
172
196
|
throw err;
|
|
173
197
|
}
|
|
198
|
+
// Provider-reported size is checked too: Graph's `size` can exceed the
|
|
199
|
+
// decoded length (it counts MIME framing), and an honest cap errs on the
|
|
200
|
+
// side of refusing.
|
|
174
201
|
if (downloaded.size > cap || downloaded.content.length > cap) {
|
|
202
|
+
const fitsOnDisk = downloaded.content.length <= MAX_SAVE_SIZE_MB * 1024 * 1024;
|
|
203
|
+
const hint = !saving && fitsOnDisk
|
|
204
|
+
? '. Pass save_to to write it to disk instead of returning base64'
|
|
205
|
+
: '';
|
|
206
|
+
return failure('ATTACHMENT_TOO_LARGE', `Attachment is ${downloaded.size} bytes; exceeds max_size_mb=${maxMb} (${cap} bytes)${hint}`, !saving && fitsOnDisk);
|
|
207
|
+
}
|
|
208
|
+
const displayName = sanitizeFilename(downloaded.filename);
|
|
209
|
+
if (saveDir === undefined) {
|
|
175
210
|
return {
|
|
176
|
-
success:
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
211
|
+
success: true,
|
|
212
|
+
filename: displayName,
|
|
213
|
+
original_filename: downloaded.filename,
|
|
214
|
+
mimeType: downloaded.mimeType,
|
|
215
|
+
size: downloaded.content.length,
|
|
216
|
+
base64: downloaded.content.toString('base64'),
|
|
182
217
|
};
|
|
183
218
|
}
|
|
219
|
+
const diskName = toDiskFilename(sanitizeFilename(input.filename ?? downloaded.filename), 'attachment');
|
|
220
|
+
let saved;
|
|
221
|
+
try {
|
|
222
|
+
saved = await writeFileExclusive(saveDir, diskName, downloaded.content);
|
|
223
|
+
}
|
|
224
|
+
catch (err) {
|
|
225
|
+
return failure('SAVE_FAILED', `Could not write attachment: ${err.message}`);
|
|
226
|
+
}
|
|
184
227
|
return {
|
|
185
228
|
success: true,
|
|
186
|
-
|
|
229
|
+
path: saved.path,
|
|
230
|
+
filename: saved.filename,
|
|
187
231
|
original_filename: downloaded.filename,
|
|
188
232
|
mimeType: downloaded.mimeType,
|
|
189
|
-
size:
|
|
190
|
-
|
|
233
|
+
size: saved.size,
|
|
234
|
+
sha256: saved.sha256,
|
|
235
|
+
};
|
|
236
|
+
},
|
|
237
|
+
};
|
|
238
|
+
// Export a whole message as the raw RFC 822 bytes the provider stores — the
|
|
239
|
+
// as-received `.eml` that record-keeping workflows bank next to attachments.
|
|
240
|
+
// Always written to disk: a raw message carries every attachment, base64
|
|
241
|
+
// encoded, so returning it inline would defeat the point (#169).
|
|
242
|
+
const DownloadMessageInput = z.object({
|
|
243
|
+
message_id: z.string(),
|
|
244
|
+
mailbox: z.string().optional(),
|
|
245
|
+
save_to: z.string().describe(SAVE_TO_DESCRIPTION),
|
|
246
|
+
filename: z.string().optional()
|
|
247
|
+
.describe('On-disk filename (sanitized; the extension is always .eml). Defaults to the message subject.'),
|
|
248
|
+
max_size_mb: z.number().int().positive().max(MAX_SAVE_SIZE_MB).optional()
|
|
249
|
+
.describe(`Size cap in MB. Default and ceiling ${MAX_SAVE_SIZE_MB}.`),
|
|
250
|
+
});
|
|
251
|
+
const DownloadMessageOutput = z.object({
|
|
252
|
+
success: z.boolean(),
|
|
253
|
+
path: z.string().optional(),
|
|
254
|
+
filename: z.string().optional(),
|
|
255
|
+
mimeType: z.string().optional(),
|
|
256
|
+
size: z.number().optional(),
|
|
257
|
+
sha256: z.string().optional(),
|
|
258
|
+
error: ActionError.optional(),
|
|
259
|
+
});
|
|
260
|
+
export const downloadMessageAction = {
|
|
261
|
+
name: 'download_message',
|
|
262
|
+
description: 'Save a whole message, as received, to a sandboxed local directory as a raw RFC 822 .eml file (Graph /$value, Gmail format=raw). Returns {path, filename, mimeType, size, sha256}, never the bytes. Use it to keep a record copy next to attachments saved with download_attachment save_to.',
|
|
263
|
+
input: DownloadMessageInput,
|
|
264
|
+
output: DownloadMessageOutput,
|
|
265
|
+
// Writes only to the local sandbox, never to the mailbox.
|
|
266
|
+
annotations: { readOnlyHint: true, destructiveHint: false },
|
|
267
|
+
run: async (ctx, input) => {
|
|
268
|
+
if (typeof ctx.provider.getRawMessage !== 'function') {
|
|
269
|
+
return failure('NOT_SUPPORTED', 'Provider does not support raw message export');
|
|
270
|
+
}
|
|
271
|
+
const resolved = await resolveSaveDir(input.save_to, { safeDir: ctx.safeDir, allowedDirs: ctx.allowedDirs });
|
|
272
|
+
if (resolved.error)
|
|
273
|
+
return { success: false, error: resolved.error };
|
|
274
|
+
let raw;
|
|
275
|
+
try {
|
|
276
|
+
raw = await ctx.provider.getRawMessage(input.message_id);
|
|
277
|
+
}
|
|
278
|
+
catch (err) {
|
|
279
|
+
if (err instanceof MessageNotFoundError) {
|
|
280
|
+
return failure('MESSAGE_NOT_FOUND', err.message);
|
|
281
|
+
}
|
|
282
|
+
throw err;
|
|
283
|
+
}
|
|
284
|
+
const maxMb = input.max_size_mb ?? MAX_SAVE_SIZE_MB;
|
|
285
|
+
if (raw.length > maxMb * 1024 * 1024) {
|
|
286
|
+
return failure('MESSAGE_TOO_LARGE', `Message is ${raw.length} bytes; exceeds max_size_mb=${maxMb}`);
|
|
287
|
+
}
|
|
288
|
+
let name = input.filename;
|
|
289
|
+
if (name === undefined) {
|
|
290
|
+
// Best-effort subject lookup for a readable default; a failed metadata
|
|
291
|
+
// read must not fail an export whose bytes are already in hand.
|
|
292
|
+
name = await ctx.provider.getMessage(input.message_id).then(m => m.subject, () => undefined) || 'message';
|
|
293
|
+
}
|
|
294
|
+
const diskName = toDiskFilename(sanitizeFilename(name), 'message', '.eml');
|
|
295
|
+
let saved;
|
|
296
|
+
try {
|
|
297
|
+
saved = await writeFileExclusive(resolved.resolved, diskName, raw);
|
|
298
|
+
}
|
|
299
|
+
catch (err) {
|
|
300
|
+
return failure('SAVE_FAILED', `Could not write message: ${err.message}`);
|
|
301
|
+
}
|
|
302
|
+
return {
|
|
303
|
+
success: true,
|
|
304
|
+
path: saved.path,
|
|
305
|
+
filename: saved.filename,
|
|
306
|
+
mimeType: 'message/rfc822',
|
|
307
|
+
size: saved.size,
|
|
308
|
+
sha256: saved.sha256,
|
|
191
309
|
};
|
|
192
310
|
},
|
|
193
311
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../src/actions/attachments.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../src/actions/attachments.ts"],"names":[],"mappings":"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"}
|
|
@@ -3,6 +3,7 @@ import type { RateLimiter, MailboxEntry, ActionContext } from './registry.js';
|
|
|
3
3
|
import type { EmailReader } from '../providers/provider.js';
|
|
4
4
|
import type { PathSandboxInput } from '../content/safe-path.js';
|
|
5
5
|
import type { BodyFormat } from '../content/body-renderer.js';
|
|
6
|
+
import type { SendClaim, SendFingerprintInput } from '../security/send-ledger.js';
|
|
6
7
|
import type { EmailAddress, OutboundAttachment } from '../types.js';
|
|
7
8
|
interface ActionError {
|
|
8
9
|
code: string;
|
|
@@ -21,6 +22,7 @@ export interface ComposeFields {
|
|
|
21
22
|
body: string;
|
|
22
23
|
to?: string | string[];
|
|
23
24
|
cc?: string[];
|
|
25
|
+
bcc?: string[];
|
|
24
26
|
subject?: string;
|
|
25
27
|
replyTo?: string;
|
|
26
28
|
draft?: boolean;
|
|
@@ -40,6 +42,7 @@ export declare function resolveComposeFields(input: {
|
|
|
40
42
|
body_file?: string;
|
|
41
43
|
to?: string | string[];
|
|
42
44
|
cc?: string[];
|
|
45
|
+
bcc?: string[];
|
|
43
46
|
subject?: string;
|
|
44
47
|
reply_to?: string;
|
|
45
48
|
draft?: boolean;
|
|
@@ -80,13 +83,33 @@ export declare function checkRateLimit(rateLimiter: RateLimiter | undefined, act
|
|
|
80
83
|
export type ParsedRecipients = {
|
|
81
84
|
to: EmailAddress[];
|
|
82
85
|
cc: EmailAddress[];
|
|
86
|
+
bcc: EmailAddress[];
|
|
83
87
|
} | {
|
|
84
88
|
error: ActionError;
|
|
85
89
|
};
|
|
86
90
|
export declare function parseRecipients(input: {
|
|
87
91
|
to?: string[];
|
|
88
92
|
cc?: string[];
|
|
93
|
+
bcc?: string[];
|
|
89
94
|
}): ParsedRecipients;
|
|
95
|
+
/**
|
|
96
|
+
* Reject a compose call that names the same address on Bcc and on To or Cc.
|
|
97
|
+
* Bcc exists to hide a recipient from the others; listing them visibly too
|
|
98
|
+
* defeats that silently, so the caller must pick one (issue #214).
|
|
99
|
+
*/
|
|
100
|
+
export declare function checkBccOverlap(recipients: {
|
|
101
|
+
to?: EmailAddress[];
|
|
102
|
+
cc?: EmailAddress[];
|
|
103
|
+
bcc?: EmailAddress[];
|
|
104
|
+
}): ActionError | null;
|
|
105
|
+
/**
|
|
106
|
+
* Warn when a persisted draft still shows a Bcc recipient on To or Cc — e.g.
|
|
107
|
+
* update_draft set bcc without restating the draft's existing To/Cc.
|
|
108
|
+
*/
|
|
109
|
+
export declare function bccVisibleWarning(preview: DraftPreview | undefined): {
|
|
110
|
+
code: string;
|
|
111
|
+
message: string;
|
|
112
|
+
} | undefined;
|
|
90
113
|
export declare const PREVIEW_BODY_LIMIT: number;
|
|
91
114
|
export declare const PREVIEW_RETRY_DELAY_MS = 500;
|
|
92
115
|
export declare const DraftPreviewSchema: z.ZodObject<{
|
|
@@ -166,5 +189,43 @@ export declare function handleProviderError(err: unknown, fallbackCode: string):
|
|
|
166
189
|
recoverable: boolean;
|
|
167
190
|
};
|
|
168
191
|
};
|
|
192
|
+
/**
|
|
193
|
+
* The deliberate-duplicate escape hatch, shared by every delivery action.
|
|
194
|
+
*
|
|
195
|
+
* Worded for the agent reading the tool schema: the guard exists because an
|
|
196
|
+
* agent replaying a lost turn is the common case, so the flag has to read as a
|
|
197
|
+
* human decision rather than a retry knob.
|
|
198
|
+
*/
|
|
199
|
+
export declare const AllowDuplicateSchema: z.ZodBoolean;
|
|
200
|
+
export type DeliveryClaim = {
|
|
201
|
+
claim: SendClaim;
|
|
202
|
+
} | {
|
|
203
|
+
duplicate: {
|
|
204
|
+
success: false;
|
|
205
|
+
messageId?: string;
|
|
206
|
+
error: ActionError;
|
|
207
|
+
};
|
|
208
|
+
};
|
|
209
|
+
/**
|
|
210
|
+
* Reserve this delivery in the send ledger before touching the provider.
|
|
211
|
+
*
|
|
212
|
+
* Call AFTER every pre-dispatch gate (mailbox, allowlist, rate limit) and
|
|
213
|
+
* IMMEDIATELY BEFORE the provider call, so the reserved window is exactly the
|
|
214
|
+
* window in which an acknowledgement can be lost.
|
|
215
|
+
*
|
|
216
|
+
* On a collision the prior attempt's `messageId` is surfaced at the top level
|
|
217
|
+
* even though `success` is false: the caller asked whether this message went
|
|
218
|
+
* out, and the honest answer includes which message it already is.
|
|
219
|
+
*/
|
|
220
|
+
export declare function claimDelivery(ctx: ActionContext, actionName: string, fingerprintInput: Omit<SendFingerprintInput, 'action' | 'mailbox'>, allowDuplicate: boolean | undefined): DeliveryClaim;
|
|
221
|
+
/**
|
|
222
|
+
* Settle a claim from a thrown provider error.
|
|
223
|
+
*
|
|
224
|
+
* Only a classified ProviderError carries a code we can reason about. An
|
|
225
|
+
* unclassified throw is settled with no code at all, which the ledger holds as
|
|
226
|
+
* unresolved — the fail-closed direction, because a throw after dispatch is
|
|
227
|
+
* exactly the case where we cannot prove the message did not go out.
|
|
228
|
+
*/
|
|
229
|
+
export declare function settleClaimFromThrow(claim: SendClaim, err: unknown): void;
|
|
169
230
|
export {};
|
|
170
231
|
//# sourceMappingURL=compose-helpers.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"compose-helpers.d.ts","sourceRoot":"","sources":["../../src/actions/compose-helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;
|
|
1
|
+
{"version":3,"file":"compose-helpers.d.ts","sourceRoot":"","sources":["../../src/actions/compose-helpers.ts"],"names":[],"mappings":"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"}
|
|
@@ -6,6 +6,7 @@ import { resolveBodyFile } from '../content/body-loader.js';
|
|
|
6
6
|
import { resolveAttachmentFile } from '../content/attachment-loader.js';
|
|
7
7
|
import { parseAddressList } from '../utils/address.js';
|
|
8
8
|
import { validateAttachment, sanitizeFilename } from './attachments.js';
|
|
9
|
+
import { computeSendFingerprint, duplicateSendError, getDefaultSendLedger, providerNamespace, } from '../security/send-ledger.js';
|
|
9
10
|
/**
|
|
10
11
|
* The filesystem sandbox for caller-supplied paths on this request: the safe
|
|
11
12
|
* base directory plus any operator-allowlisted extra roots.
|
|
@@ -38,6 +39,7 @@ export async function resolveComposeFields(input, sandbox, opts) {
|
|
|
38
39
|
let body;
|
|
39
40
|
let to = input.to;
|
|
40
41
|
let cc = input.cc;
|
|
42
|
+
let bcc = input.bcc;
|
|
41
43
|
let subject = input.subject;
|
|
42
44
|
let replyTo = input.reply_to;
|
|
43
45
|
let draft = input.draft;
|
|
@@ -56,6 +58,8 @@ export async function resolveComposeFields(input, sandbox, opts) {
|
|
|
56
58
|
to = fm.to;
|
|
57
59
|
if (fm.cc !== undefined)
|
|
58
60
|
cc = Array.isArray(fm.cc) ? fm.cc : [fm.cc];
|
|
61
|
+
if (fm.bcc !== undefined)
|
|
62
|
+
bcc = Array.isArray(fm.bcc) ? fm.bcc : [fm.bcc];
|
|
59
63
|
if (fm.subject !== undefined)
|
|
60
64
|
subject = fm.subject;
|
|
61
65
|
if (fm.reply_to !== undefined)
|
|
@@ -77,7 +81,7 @@ export async function resolveComposeFields(input, sandbox, opts) {
|
|
|
77
81
|
error: { code: 'MISSING_BODY', message: 'Either body or body_file is required', recoverable: false },
|
|
78
82
|
};
|
|
79
83
|
}
|
|
80
|
-
return { body: body ?? '', to, cc, subject, replyTo, draft, format, forceBlack };
|
|
84
|
+
return { body: body ?? '', to, cc, bcc, subject, replyTo, draft, format, forceBlack };
|
|
81
85
|
}
|
|
82
86
|
// --- Outbound attachments ---
|
|
83
87
|
// Strict standard-base64: zero or more full quartets, then an optional final
|
|
@@ -192,27 +196,54 @@ export function checkRateLimit(rateLimiter, actionName) {
|
|
|
192
196
|
return null;
|
|
193
197
|
}
|
|
194
198
|
export function parseRecipients(input) {
|
|
195
|
-
const
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
error: {
|
|
209
|
-
code: 'INVALID_ADDRESS',
|
|
210
|
-
message: `${ccResult.field}[${ccResult.index}] invalid address: "${ccResult.value}"`,
|
|
211
|
-
recoverable: false,
|
|
212
|
-
},
|
|
213
|
-
};
|
|
199
|
+
const lists = { to: [], cc: [], bcc: [] };
|
|
200
|
+
for (const field of ['to', 'cc', 'bcc']) {
|
|
201
|
+
const result = parseAddressList(input[field], field);
|
|
202
|
+
if (!result.ok) {
|
|
203
|
+
return {
|
|
204
|
+
error: {
|
|
205
|
+
code: 'INVALID_ADDRESS',
|
|
206
|
+
message: `${result.field}[${result.index}] invalid address: "${result.value}"`,
|
|
207
|
+
recoverable: false,
|
|
208
|
+
},
|
|
209
|
+
};
|
|
210
|
+
}
|
|
211
|
+
lists[field] = result.addresses;
|
|
214
212
|
}
|
|
215
|
-
return
|
|
213
|
+
return lists;
|
|
214
|
+
}
|
|
215
|
+
/** Bcc addresses that also appear on To or Cc, compared case-insensitively. */
|
|
216
|
+
function bccOverlap(recipients) {
|
|
217
|
+
const visible = new Set([...(recipients.to ?? []), ...(recipients.cc ?? [])].map(a => a.email.toLowerCase()));
|
|
218
|
+
return (recipients.bcc ?? []).filter(a => visible.has(a.email.toLowerCase())).map(a => a.email);
|
|
219
|
+
}
|
|
220
|
+
/**
|
|
221
|
+
* Reject a compose call that names the same address on Bcc and on To or Cc.
|
|
222
|
+
* Bcc exists to hide a recipient from the others; listing them visibly too
|
|
223
|
+
* defeats that silently, so the caller must pick one (issue #214).
|
|
224
|
+
*/
|
|
225
|
+
export function checkBccOverlap(recipients) {
|
|
226
|
+
const overlap = bccOverlap(recipients);
|
|
227
|
+
if (overlap.length === 0)
|
|
228
|
+
return null;
|
|
229
|
+
return {
|
|
230
|
+
code: 'BCC_RECIPIENT_CONFLICT',
|
|
231
|
+
message: `Listed on bcc and also on to/cc: ${overlap.join(', ')}. Name each recipient on one line only.`,
|
|
232
|
+
recoverable: true,
|
|
233
|
+
};
|
|
234
|
+
}
|
|
235
|
+
/**
|
|
236
|
+
* Warn when a persisted draft still shows a Bcc recipient on To or Cc — e.g.
|
|
237
|
+
* update_draft set bcc without restating the draft's existing To/Cc.
|
|
238
|
+
*/
|
|
239
|
+
export function bccVisibleWarning(preview) {
|
|
240
|
+
const overlap = preview ? bccOverlap(preview) : [];
|
|
241
|
+
if (overlap.length === 0)
|
|
242
|
+
return undefined;
|
|
243
|
+
return {
|
|
244
|
+
code: 'BCC_RECIPIENT_ALSO_VISIBLE',
|
|
245
|
+
message: `The draft lists ${overlap.join(', ')} on bcc and also on to/cc, so they are not hidden. Restate to/cc without them to keep the bcc hidden.`,
|
|
246
|
+
};
|
|
216
247
|
}
|
|
217
248
|
// --- Draft preview ---
|
|
218
249
|
// Per-field cap on body/bodyHtml in draft preview responses. The 3.5 MB
|
|
@@ -385,4 +416,61 @@ export function handleProviderError(err, fallbackCode) {
|
|
|
385
416
|
},
|
|
386
417
|
};
|
|
387
418
|
}
|
|
419
|
+
// --- claimDelivery ---
|
|
420
|
+
/**
|
|
421
|
+
* The deliberate-duplicate escape hatch, shared by every delivery action.
|
|
422
|
+
*
|
|
423
|
+
* Worded for the agent reading the tool schema: the guard exists because an
|
|
424
|
+
* agent replaying a lost turn is the common case, so the flag has to read as a
|
|
425
|
+
* human decision rather than a retry knob.
|
|
426
|
+
*/
|
|
427
|
+
export const AllowDuplicateSchema = z.boolean()
|
|
428
|
+
.describe('Bypass the duplicate-delivery guard for this request. The guard refuses an identical delivery repeated within the duplicate window (default 15 minutes) so a replayed tool call cannot send the same message twice. Set true ONLY when a person has decided to deliberately send the same message again — never as a way to retry a call that failed.');
|
|
429
|
+
/**
|
|
430
|
+
* Reserve this delivery in the send ledger before touching the provider.
|
|
431
|
+
*
|
|
432
|
+
* Call AFTER every pre-dispatch gate (mailbox, allowlist, rate limit) and
|
|
433
|
+
* IMMEDIATELY BEFORE the provider call, so the reserved window is exactly the
|
|
434
|
+
* window in which an acknowledgement can be lost.
|
|
435
|
+
*
|
|
436
|
+
* On a collision the prior attempt's `messageId` is surfaced at the top level
|
|
437
|
+
* even though `success` is false: the caller asked whether this message went
|
|
438
|
+
* out, and the honest answer includes which message it already is.
|
|
439
|
+
*/
|
|
440
|
+
export function claimDelivery(ctx, actionName, fingerprintInput, allowDuplicate) {
|
|
441
|
+
const ledger = ctx.sendLedger ?? getDefaultSendLedger();
|
|
442
|
+
// Namespace the fingerprint by mailbox. `mailboxName` is optional on
|
|
443
|
+
// ActionContext, and two mailboxes sharing the process default ledger under
|
|
444
|
+
// an empty key would collide — the second mailbox's first send refused, and
|
|
445
|
+
// handed the first mailbox's message id. Fall back to the provider instance.
|
|
446
|
+
const fingerprint = computeSendFingerprint({
|
|
447
|
+
...fingerprintInput,
|
|
448
|
+
action: actionName,
|
|
449
|
+
mailbox: ctx.mailboxName ?? providerNamespace(ctx.provider),
|
|
450
|
+
});
|
|
451
|
+
const result = ledger.claim(fingerprint, { force: allowDuplicate === true });
|
|
452
|
+
if (result.ok)
|
|
453
|
+
return { claim: result };
|
|
454
|
+
return {
|
|
455
|
+
duplicate: {
|
|
456
|
+
success: false,
|
|
457
|
+
...(result.prior.messageId !== undefined ? { messageId: result.prior.messageId } : {}),
|
|
458
|
+
error: duplicateSendError(result.prior, actionName),
|
|
459
|
+
},
|
|
460
|
+
};
|
|
461
|
+
}
|
|
462
|
+
/**
|
|
463
|
+
* Settle a claim from a thrown provider error.
|
|
464
|
+
*
|
|
465
|
+
* Only a classified ProviderError carries a code we can reason about. An
|
|
466
|
+
* unclassified throw is settled with no code at all, which the ledger holds as
|
|
467
|
+
* unresolved — the fail-closed direction, because a throw after dispatch is
|
|
468
|
+
* exactly the case where we cannot prove the message did not go out.
|
|
469
|
+
*/
|
|
470
|
+
export function settleClaimFromThrow(claim, err) {
|
|
471
|
+
claim.settle({
|
|
472
|
+
success: false,
|
|
473
|
+
...(isProviderError(err) ? { errorCode: err.code } : {}),
|
|
474
|
+
});
|
|
475
|
+
}
|
|
388
476
|
//# sourceMappingURL=compose-helpers.js.map
|