agent-inbox 0.2.4 → 0.2.5

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.
Files changed (138) hide show
  1. package/CLAUDE.md +1 -92
  2. package/README.md +6 -73
  3. package/dist/federation/connection-manager.d.ts +0 -8
  4. package/dist/federation/connection-manager.d.ts.map +1 -1
  5. package/dist/federation/connection-manager.js +0 -12
  6. package/dist/federation/connection-manager.js.map +1 -1
  7. package/dist/federation/delivery-queue.d.ts +3 -11
  8. package/dist/federation/delivery-queue.d.ts.map +1 -1
  9. package/dist/federation/delivery-queue.js +8 -38
  10. package/dist/federation/delivery-queue.js.map +1 -1
  11. package/dist/index.d.ts +0 -17
  12. package/dist/index.d.ts.map +1 -1
  13. package/dist/index.js +0 -98
  14. package/dist/index.js.map +1 -1
  15. package/dist/jsonrpc/mail-push-types.d.ts +22 -2
  16. package/dist/jsonrpc/mail-push-types.d.ts.map +1 -1
  17. package/dist/jsonrpc/mail-push-types.js +18 -1
  18. package/dist/jsonrpc/mail-push-types.js.map +1 -1
  19. package/dist/jsonrpc/mail-push.d.ts +12 -1
  20. package/dist/jsonrpc/mail-push.d.ts.map +1 -1
  21. package/dist/jsonrpc/mail-push.js +13 -2
  22. package/dist/jsonrpc/mail-push.js.map +1 -1
  23. package/dist/jsonrpc/mail-server.d.ts.map +1 -1
  24. package/dist/jsonrpc/mail-server.js +42 -18
  25. package/dist/jsonrpc/mail-server.js.map +1 -1
  26. package/dist/router/message-router.d.ts +0 -15
  27. package/dist/router/message-router.d.ts.map +1 -1
  28. package/dist/router/message-router.js +3 -25
  29. package/dist/router/message-router.js.map +1 -1
  30. package/dist/storage/interface.d.ts +2 -9
  31. package/dist/storage/interface.d.ts.map +1 -1
  32. package/dist/storage/memory.d.ts +1 -4
  33. package/dist/storage/memory.d.ts.map +1 -1
  34. package/dist/storage/memory.js +6 -12
  35. package/dist/storage/memory.js.map +1 -1
  36. package/dist/storage/sqlite.d.ts +1 -6
  37. package/dist/storage/sqlite.d.ts.map +1 -1
  38. package/dist/storage/sqlite.js +6 -28
  39. package/dist/storage/sqlite.js.map +1 -1
  40. package/dist/types.d.ts +0 -79
  41. package/dist/types.d.ts.map +1 -1
  42. package/docs/DESIGN.md +0 -15
  43. package/package.json +3 -28
  44. package/rules/agent-inbox.md +0 -1
  45. package/src/federation/connection-manager.ts +0 -12
  46. package/src/federation/delivery-queue.ts +8 -38
  47. package/src/index.ts +0 -148
  48. package/src/jsonrpc/mail-push-types.ts +43 -2
  49. package/src/jsonrpc/mail-push.ts +34 -3
  50. package/src/jsonrpc/mail-server.ts +45 -26
  51. package/src/router/message-router.ts +4 -41
  52. package/src/storage/interface.ts +2 -11
  53. package/src/storage/memory.ts +8 -15
  54. package/src/storage/sqlite.ts +9 -36
  55. package/src/types.ts +0 -73
  56. package/test/load.test.ts +1 -1
  57. package/test/mail-push.test.ts +101 -1
  58. package/test/mail-server.test.ts +108 -0
  59. package/AGENTS.md +0 -18
  60. package/dist/federation/queue-store.d.ts +0 -42
  61. package/dist/federation/queue-store.d.ts.map +0 -1
  62. package/dist/federation/queue-store.js +0 -87
  63. package/dist/federation/queue-store.js.map +0 -1
  64. package/dist/index.d.mts +0 -2
  65. package/dist/index.mjs +0 -1
  66. package/dist/index.mjs.map +0 -1
  67. package/dist/mail/address-book.d.ts +0 -43
  68. package/dist/mail/address-book.d.ts.map +0 -1
  69. package/dist/mail/address-book.js +0 -95
  70. package/dist/mail/address-book.js.map +0 -1
  71. package/dist/mail/attachment-store.d.ts +0 -31
  72. package/dist/mail/attachment-store.d.ts.map +0 -1
  73. package/dist/mail/attachment-store.js +0 -74
  74. package/dist/mail/attachment-store.js.map +0 -1
  75. package/dist/mail/email-mapper.d.ts +0 -41
  76. package/dist/mail/email-mapper.d.ts.map +0 -1
  77. package/dist/mail/email-mapper.js +0 -216
  78. package/dist/mail/email-mapper.js.map +0 -1
  79. package/dist/mail/fs-attachment-store.d.ts +0 -38
  80. package/dist/mail/fs-attachment-store.d.ts.map +0 -1
  81. package/dist/mail/fs-attachment-store.js +0 -165
  82. package/dist/mail/fs-attachment-store.js.map +0 -1
  83. package/dist/mail/mail-gateway.d.ts +0 -114
  84. package/dist/mail/mail-gateway.d.ts.map +0 -1
  85. package/dist/mail/mail-gateway.js +0 -402
  86. package/dist/mail/mail-gateway.js.map +0 -1
  87. package/dist/mail/provider-transport.d.ts +0 -138
  88. package/dist/mail/provider-transport.d.ts.map +0 -1
  89. package/dist/mail/provider-transport.js +0 -434
  90. package/dist/mail/provider-transport.js.map +0 -1
  91. package/dist/mail/rate-limiter.d.ts +0 -20
  92. package/dist/mail/rate-limiter.d.ts.map +0 -1
  93. package/dist/mail/rate-limiter.js +0 -56
  94. package/dist/mail/rate-limiter.js.map +0 -1
  95. package/dist/mail/smtp-transport.d.ts +0 -141
  96. package/dist/mail/smtp-transport.d.ts.map +0 -1
  97. package/dist/mail/smtp-transport.js +0 -415
  98. package/dist/mail/smtp-transport.js.map +0 -1
  99. package/dist/mail/types.d.ts +0 -177
  100. package/dist/mail/types.d.ts.map +0 -1
  101. package/dist/mail/types.js +0 -11
  102. package/dist/mail/types.js.map +0 -1
  103. package/dist/router/destination.d.ts +0 -69
  104. package/dist/router/destination.d.ts.map +0 -1
  105. package/dist/router/destination.js +0 -106
  106. package/dist/router/destination.js.map +0 -1
  107. package/docs/MAIL-INTEROP-PLAN.md +0 -660
  108. package/renovate.json5 +0 -6
  109. package/src/federation/queue-store.ts +0 -124
  110. package/src/mail/address-book.ts +0 -111
  111. package/src/mail/attachment-store.ts +0 -90
  112. package/src/mail/email-mapper.ts +0 -288
  113. package/src/mail/fs-attachment-store.ts +0 -163
  114. package/src/mail/mail-gateway.ts +0 -505
  115. package/src/mail/provider-transport.ts +0 -577
  116. package/src/mail/rate-limiter.ts +0 -51
  117. package/src/mail/smtp-transport.ts +0 -589
  118. package/src/mail/types.ts +0 -221
  119. package/src/router/destination.ts +0 -140
  120. package/test/federation/delivery-queue-sqlite.test.ts +0 -158
  121. package/test/mail/address-book.test.ts +0 -111
  122. package/test/mail/attachment-store-contract.test.ts +0 -92
  123. package/test/mail/attachment-store.test.ts +0 -69
  124. package/test/mail/destination.test.ts +0 -115
  125. package/test/mail/dsn-parse.test.ts +0 -239
  126. package/test/mail/email-mapper.test.ts +0 -341
  127. package/test/mail/external-id.test.ts +0 -43
  128. package/test/mail/fs-attachment-store.test.ts +0 -134
  129. package/test/mail/full-flow-e2e.test.ts +0 -200
  130. package/test/mail/mail-gateway.test.ts +0 -419
  131. package/test/mail/mail-transport-contract.test.ts +0 -134
  132. package/test/mail/mock-mail.ts +0 -161
  133. package/test/mail/mock-postmark.ts +0 -66
  134. package/test/mail/provider-transport.test.ts +0 -381
  135. package/test/mail/rate-limiter.test.ts +0 -48
  136. package/test/mail/router-mail-integration.test.ts +0 -138
  137. package/test/mail/smtp-e2e.test.ts +0 -98
  138. package/test/mail/smtp-transport.test.ts +0 -138
@@ -1,165 +0,0 @@
1
- /**
2
- * Filesystem-backed AttachmentStore — opt-in for large/high-volume deployments.
3
- *
4
- * Keeps attachment bytes out of the SQLite DB (no WAL bloat, no synchronous
5
- * blob I/O blocking the event loop). Content-addressed by sha256, so identical
6
- * bytes dedup. Files live at `<dir>/<aa>/<sha256>` (sharded by the first byte
7
- * to avoid one enormous directory).
8
- *
9
- * Durability: writes go to a unique temp file, are fsync'd, then atomically
10
- * renamed into place. Because the caller stores the attachment (this `put`)
11
- * BEFORE committing the message row that references it, a crash can only ever
12
- * leave an orphan file (reclaimable by GC) — never a row pointing at missing
13
- * bytes. See docs/MAIL-INTEROP-PLAN.md §4c.
14
- */
15
- import { createHash } from "node:crypto";
16
- import * as fs from "node:fs/promises";
17
- import * as path from "node:path";
18
- const REF_RE = /^sha256:([0-9a-f]{64})$/;
19
- export class FsAttachmentStore {
20
- dir;
21
- constructor(dir) {
22
- this.dir = dir;
23
- }
24
- async put(bytes, _meta) {
25
- const hex = createHash("sha256").update(bytes).digest("hex");
26
- const ref = `sha256:${hex}`;
27
- const full = this.pathForHex(hex);
28
- // Content-addressed: if the bytes are already stored, we're done.
29
- if (await exists(full))
30
- return ref;
31
- await fs.mkdir(path.dirname(full), { recursive: true });
32
- // Atomic durable write: unique temp file → fsync → rename into place.
33
- const tmp = `${full}.tmp-${process.pid}-${Date.now()}-${Math.random()
34
- .toString(36)
35
- .slice(2)}`;
36
- let handle;
37
- try {
38
- handle = await fs.open(tmp, "wx");
39
- await handle.writeFile(bytes);
40
- await handle.sync();
41
- }
42
- finally {
43
- await handle?.close();
44
- }
45
- try {
46
- await fs.rename(tmp, full);
47
- }
48
- catch (err) {
49
- // A concurrent put of identical bytes may have won the race — that's fine
50
- // (same content). Clean up our temp file and return the ref.
51
- await fs.rm(tmp, { force: true });
52
- if (!(await exists(full)))
53
- throw err;
54
- }
55
- // Durability: fsync the containing directory so the rename survives a crash
56
- // (atomic rename alone is not crash-durable without a parent-dir fsync).
57
- await fsyncDir(path.dirname(full));
58
- return ref;
59
- }
60
- async get(ref) {
61
- const full = this.pathForRef(ref);
62
- try {
63
- return await fs.readFile(full);
64
- }
65
- catch (err) {
66
- if (err.code === "ENOENT") {
67
- throw new Error(`Attachment not found: ${ref}`);
68
- }
69
- throw err;
70
- }
71
- }
72
- async delete(ref) {
73
- await fs.rm(this.pathForRef(ref), { force: true });
74
- }
75
- /**
76
- * Garbage-collect orphan files: delete any stored attachment whose ref is not
77
- * in `liveRefs` AND that is older than `minAgeMs` (default 1h).
78
- *
79
- * The age guard prevents a TOCTOU race: an attachment is `put` (file lands on
80
- * disk) before the message row that references it is committed, so a just-
81
- * written file may legitimately not appear in a `liveRefs` snapshot yet.
82
- * Skipping recently-written files avoids deleting such in-flight attachments.
83
- */
84
- async gc(liveRefs, minAgeMs = 3_600_000) {
85
- let removed = 0;
86
- const cutoff = Date.now() - minAgeMs;
87
- let shards;
88
- try {
89
- shards = await fs.readdir(this.dir, { withFileTypes: true });
90
- }
91
- catch (err) {
92
- if (err.code === "ENOENT")
93
- return 0;
94
- throw err;
95
- }
96
- for (const shard of shards) {
97
- if (!shard.isDirectory())
98
- continue; // ignore stray files at the root
99
- const shardDir = path.join(this.dir, shard.name);
100
- let files;
101
- try {
102
- files = await fs.readdir(shardDir);
103
- }
104
- catch {
105
- continue;
106
- }
107
- for (const name of files) {
108
- if (name.includes(".tmp-"))
109
- continue; // leave in-flight temp files
110
- if (liveRefs.has(`sha256:${name}`))
111
- continue;
112
- const filePath = path.join(shardDir, name);
113
- try {
114
- const st = await fs.stat(filePath);
115
- if (st.mtimeMs > cutoff)
116
- continue; // too new — may be mid-ingestion
117
- }
118
- catch {
119
- continue;
120
- }
121
- await fs.rm(filePath, { force: true });
122
- removed++;
123
- }
124
- }
125
- return removed;
126
- }
127
- pathForHex(hex) {
128
- // Shard by the first byte of the hash to bound directory fan-out.
129
- return path.join(this.dir, hex.slice(0, 2), hex);
130
- }
131
- pathForRef(ref) {
132
- const m = REF_RE.exec(ref);
133
- if (!m) {
134
- // Strict validation prevents path traversal via a crafted ref (refs are
135
- // always sha256-of-content, never caller-chosen).
136
- throw new Error(`Invalid attachment ref: ${ref}`);
137
- }
138
- return this.pathForHex(m[1]);
139
- }
140
- }
141
- async function exists(p) {
142
- try {
143
- await fs.access(p);
144
- return true;
145
- }
146
- catch {
147
- return false;
148
- }
149
- }
150
- /** fsync a directory so a rename into it is durable. Best-effort across platforms. */
151
- async function fsyncDir(dir) {
152
- let handle;
153
- try {
154
- handle = await fs.open(dir, "r");
155
- await handle.sync();
156
- }
157
- catch {
158
- // Some platforms (e.g. Windows) don't permit fsync on a directory handle.
159
- // Atomic rename still holds; this only weakens the durability guarantee.
160
- }
161
- finally {
162
- await handle?.close().catch(() => { });
163
- }
164
- }
165
- //# sourceMappingURL=fs-attachment-store.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"fs-attachment-store.js","sourceRoot":"","sources":["../../src/mail/fs-attachment-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,MAAM,MAAM,GAAG,yBAAyB,CAAC;AAEzC,MAAM,OAAO,iBAAiB;IACR;IAApB,YAAoB,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAEnC,KAAK,CAAC,GAAG,CACP,KAAa,EACb,KAAiD;QAEjD,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,UAAU,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAElC,kEAAkE;QAClE,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO,GAAG,CAAC;QAEnC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAExD,sEAAsE;QACtE,MAAM,GAAG,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE;aAClE,QAAQ,CAAC,EAAE,CAAC;aACZ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACd,IAAI,MAAiC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAClC,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,0EAA0E;YAC1E,6DAA6D;YAC7D,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAClC,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;gBAAE,MAAM,GAAG,CAAC;QACvC,CAAC;QACD,4EAA4E;QAC5E,yEAAyE;QACzE,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACnC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;YAClD,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,CAAC,QAAqB,EAAE,WAAmB,SAAS;QAC1D,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;QACrC,IAAI,MAAuD,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,CAAC,CAAC;YAC/D,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS,CAAC,iCAAiC;YACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,KAAe,CAAC;YACpB,IAAI,CAAC;gBACH,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,SAAS,CAAC,6BAA6B;gBACnE,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;oBAAE,SAAS;gBAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC3C,IAAI,CAAC;oBACH,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACnC,IAAI,EAAE,CAAC,OAAO,GAAG,MAAM;wBAAE,SAAS,CAAC,iCAAiC;gBACtE,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;gBACD,MAAM,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvC,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,UAAU,CAAC,GAAW;QAC5B,kEAAkE;QAClE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC;IAEO,UAAU,CAAC,GAAW;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,wEAAwE;YACxE,kDAAkD;YAClD,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;CACF;AAED,KAAK,UAAU,MAAM,CAAC,CAAS;IAC7B,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,KAAK,UAAU,QAAQ,CAAC,GAAW;IACjC,IAAI,MAAiC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACjC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;QAC1E,yEAAyE;IAC3E,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}
@@ -1,114 +0,0 @@
1
- /**
2
- * MailGateway — the only mail-aware component the rest of the system touches.
3
- *
4
- * Ingress: transport.onReceive → policy (size / allow-list / DMARC) → dedup →
5
- * bounce-detect → map → commit via router.routeMessage (single ingestion path).
6
- * The transport ACKs only after this resolves (commit-before-ACK); a throw
7
- * NACKs so the sender retries.
8
- *
9
- * Egress: router calls send() for mail-class recipients. The message is rendered
10
- * and attempted; transient failures are queued durably and retried; permanent
11
- * failures (and inbound DSNs) converge on one config-gated bounce handler.
12
- *
13
- * See docs/MAIL-INTEROP-PLAN.md §7, §8.
14
- */
15
- import { EventEmitter } from "node:events";
16
- import type { Storage } from "../storage/interface.js";
17
- import type { MessageRouter, MailEgress } from "../router/message-router.js";
18
- import { DeliveryQueue } from "../federation/delivery-queue.js";
19
- import type { QueueStore } from "../federation/queue-store.js";
20
- import type { Message, MailIdentityConfig, DeliveryQueueConfig } from "../types.js";
21
- import type { MailTransport, InboundMail } from "./types.js";
22
- export interface MailGatewayConfig {
23
- identity: MailIdentityConfig;
24
- /** Domains we send to without erroring; combined with identity.localDomains. */
25
- routableDomains?: string[];
26
- /** Override the transport's maxMessageBytes for inbound rejection. */
27
- maxMessageBytes?: number;
28
- /** Inbound sender allow-list (domains). Empty/undefined = allow all. */
29
- allowedSenderDomains?: string[];
30
- /** Drop inbound mail whose DMARC verdict is "fail". */
31
- rejectDmarcFail?: boolean;
32
- /** Max attachments on an inbound message before it is rejected. */
33
- maxAttachments?: number;
34
- /**
35
- * Inbound rate limiting (abuse control). Over-limit inbound is NACKed
36
- * (transient) so legitimate senders back off and retry. Disabled if unset.
37
- */
38
- rateLimit?: {
39
- /** Sliding window, ms (default 60000). */
40
- windowMs?: number;
41
- /** Max inbound per sender domain per window. */
42
- perSenderDomain?: number;
43
- /** Max inbound across all senders per window. */
44
- global?: number;
45
- };
46
- /** Bounce behavior; both paths default on. */
47
- bounce?: {
48
- emitEvent?: boolean;
49
- synthesizeInboxMessage?: boolean;
50
- };
51
- /** Domain used to mint outbound Message-IDs (defaults to primary local domain). */
52
- messageIdDomain?: string;
53
- /** Default inbox scope for inbound mail without plus-addressing. */
54
- defaultScope?: string;
55
- /** Delivery queue config for outbound retries. */
56
- queue?: Partial<DeliveryQueueConfig>;
57
- }
58
- /** Thrown to NACK over-limit inbound so the sender backs off and retries. */
59
- export declare class RateLimitedError extends Error {
60
- readonly scope: string;
61
- constructor(scope: string);
62
- }
63
- export declare class MailGateway implements MailEgress {
64
- private transport;
65
- private storage;
66
- private router;
67
- private events;
68
- private config;
69
- private addressBook;
70
- private mailDomains;
71
- private senderLimiter;
72
- private globalLimiter;
73
- readonly queue: DeliveryQueue;
74
- private retryTimer?;
75
- private retrying;
76
- constructor(opts: {
77
- transport: MailTransport;
78
- storage: Storage;
79
- router: MessageRouter;
80
- events: EventEmitter;
81
- config: MailGatewayConfig;
82
- /** Durable queue store for outbound retries (sqlite). Memory if omitted. */
83
- queueStore?: QueueStore;
84
- });
85
- /** Start the underlying transport and the retry/TTL timers. */
86
- start(intervalMs?: number): Promise<void>;
87
- stop(): Promise<void>;
88
- /** True if this recipient's domain is one we route mail for. */
89
- ownsRecipient(agentId: string): boolean;
90
- /** Render and deliver the mail-class recipients of a message. */
91
- send(message: Message): Promise<void>;
92
- /**
93
- * Handle one inbound message. Resolves on ACK; throws on NACK (transient
94
- * failure the sender should retry). Policy rejections ACK-and-drop so the
95
- * sender does not retry forever.
96
- */
97
- handleInbound(mail: InboundMail): Promise<void>;
98
- /** Attempt delivery; classify the result and queue/bounce accordingly. */
99
- private attemptDelivery;
100
- /** Re-attempt all retryable queued mail. Call from a timer or deterministically. */
101
- processRetries(): Promise<void>;
102
- private markDelivered;
103
- private handleInboundBounce;
104
- private bounce;
105
- /** Inject a bounce notification into the original sender's inbox. */
106
- private synthesizeBounce;
107
- private reject;
108
- /** Throw RateLimitedError (→ NACK) when an inbound limiter is exceeded. */
109
- private enforceRateLimits;
110
- private senderAllowed;
111
- /** Dedup key: RFC Message-ID when present, else a synthetic content hash. */
112
- private externalIdFor;
113
- }
114
- //# sourceMappingURL=mail-gateway.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"mail-gateway.d.ts","sourceRoot":"","sources":["../../src/mail/mail-gateway.ts"],"names":[],"mappings":"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"}