@rubytech/create-maxy-code 0.1.599 → 0.1.601

package/payload/platform/plugins/email/mcp/dist/sampler/__tests__/sample-mailbox.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample-mailbox.test.js","sourceRoot":"","sources":["../../../src/sampler/__tests__/sample-mailbox.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,aAAa,EAAyC,MAAM,sBAAsB,CAAC;AAE5F,MAAM,MAAM,GAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AACtE,MAAM,OAAO,GAAmB,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC/E,MAAM,KAAK,GAAG,CAAC,GAAW,EAAO,EAAE,CAAC,CAAC;IACnC,GAAG;IACH,SAAS,EAAE,KAAK,GAAG,KAAK;IACxB,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,CAAC,WAAW,CAAC;IAC1B,WAAW,EAAE,EAAE;IACf,WAAW,EAAE,SAAS;IACtB,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,IAAI,GAAG,EAAE;IAClB,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,GAAG;IAChB,WAAW,EAAE,EAAE;CAChB,CAAC,CAAC;AAEH,SAAS,IAAI,CAAC,OAA6B,EAAE;IAC3C,OAAO;QACL,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5E,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YACxB,iBAAiB,EAAE,CAAC;YACpB,cAAc,EAAE,CAAC;YACjB,mBAAmB,EAAE,EAAE;YACvB,mBAAmB,EAAE,CAAC;YACtB,iBAAiB,EAAE,CAAC;SACrB,CAAC,CAAC;QACH,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC;QACnC,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;QACpC,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC;QAC/B,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE;QACZ,GAAG,IAAI;KACR,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;YACpE,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;SAClG,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,CAAC,CAAC,KAAY,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,CAAE,CAAC,CAAC,KAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC,CAAC,aAAoB,CAAC,CAAC,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QACnF,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;YACpE,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YACtF,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;gBACtB,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;YAChC,CAAC,CAAC;SACH,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,CAAC,CAAC,aAAoB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACtD,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACxC,MAAM,CAAE,CAAC,CAAC,GAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5G,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;YACpE,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;SAC7E,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,CAAC,CAAC,KAAY,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC9C,MAAM,CAAC,CAAC,CAAC,aAAoB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACtD,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,IAAI,MAAM,GAA6D,IAAI,CAAC;QAC5E,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC;YACrC,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;gBAC5C,MAAM,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;YAC9C,CAAC,CAAC;YACF,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,CAC3C,QAAQ,GAAG,EAAE;gBACX,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;gBAClE,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAChD;SACF,CAAC,CAAC;QACH,MAAM,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,KAAY,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;YACtE,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;SACrF,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,CAAC,CAAC,KAAY,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC9C,MAAM,CAAC,CAAC,CAAC,aAAoB,CAAC,CAAC,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAClF,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/payload/platform/plugins/email/mcp/dist/sampler/main.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=main.d.ts.map

package/payload/platform/plugins/email/mcp/dist/sampler/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/sampler/main.ts"],"names":[],"mappings":""}

package/payload/platform/plugins/email/mcp/dist/sampler/main.js

@@ -0,0 +1,75 @@
+import { appendFileSync, statSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { fetchSinceUid, resolveDefaultRecipients } from "../lib/imap.js";
+import { dispatchEmailMessagesToConversationArchive } from "../lib/conversation-archive-dispatch.js";
+import { listAllImapAccounts, readSamplerCursor, advanceSamplerCursor } from "../lib/credentials.js";
+import { sampleMailbox } from "./sample-mailbox.js";
+// The standing email-sampler (Task 2682): a per-brand systemd user unit that
+// each cycle enumerates every IMAP mailbox on the install and writes new
+// inbound messages to the graph via the plugin's own dispatch, independent of
+// any agent turn. The cursor is the only state; it advances only on a
+// successful write, so the loop is restart-safe by construction.
+const LOG_PATH = process.env.EMAIL_SAMPLER_LOG_PATH ?? "/tmp/email-sampler.log";
+const INTERVAL_MS = (Number(process.env.EMAIL_SAMPLER_INTERVAL_SEC ?? "60") || 60) * 1000;
+const LOG_MAX = Number(process.env.EMAIL_SAMPLER_LOG_MAX_BYTES ?? "10485760") || 10485760;
+/** Append one structured line, capping the file at LOG_MAX by keeping the tail
+ *  (mirrors rss-sampler's self-cap). Logging must never kill the loop. */
+function logLine(line) {
+    const stamped = `${new Date().toISOString()} [email-sampler] ${line}\n`;
+    try {
+        mkdirSync(dirname(LOG_PATH), { recursive: true });
+        appendFileSync(LOG_PATH, stamped);
+        if (statSync(LOG_PATH).size > LOG_MAX) {
+            const buf = readFileSync(LOG_PATH);
+            // Keep roughly the last half, but start at the next line boundary so the
+            // first retained line is whole, not a mid-line fragment a tail reader
+            // would show as garbage.
+            const approx = buf.length - Math.floor(LOG_MAX / 2);
+            const nl = buf.indexOf(0x0a, approx);
+            const start = nl === -1 ? approx : nl + 1;
+            writeFileSync(LOG_PATH, buf.subarray(start));
+        }
+    }
+    catch {
+        /* a logging failure is never fatal to ingest */
+    }
+}
+const deps = {
+    fetchSince: fetchSinceUid,
+    write: (m) => dispatchEmailMessagesToConversationArchive(m),
+    readCursor: readSamplerCursor,
+    advanceCursor: advanceSamplerCursor,
+    recipients: (c) => resolveDefaultRecipients(c),
+    log: logLine,
+};
+async function cycle() {
+    let accounts;
+    try {
+        accounts = await listAllImapAccounts();
+    }
+    catch (e) {
+        logLine(`op=sample-error mailbox=<enumeration> detail=${e instanceof Error ? e.message : String(e)}`);
+        return;
+    }
+    for (const account of accounts) {
+        try {
+            await sampleMailbox(deps, account);
+        }
+        catch (e) {
+            logLine(`op=sample-error mailbox=${account.config.email} detail=${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+}
+async function main() {
+    logLine(`boot interval_sec=${INTERVAL_MS / 1000} log=${LOG_PATH}`);
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        await cycle();
+        await new Promise((r) => setTimeout(r, INTERVAL_MS));
+    }
+}
+main().catch((e) => {
+    logLine(`op=sample-error mailbox=<fatal> detail=${e instanceof Error ? e.message : String(e)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/payload/platform/plugins/email/mcp/dist/sampler/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/sampler/main.ts"],"names":[],"mappings":"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"}

package/payload/platform/plugins/email/mcp/dist/sampler/sample-mailbox.d.ts

@@ -0,0 +1,48 @@
+import type { EmailConfig, SamplerCursor } from "../lib/credentials.js";
+import type { FetchedEmail } from "../lib/imap.js";
+import type { EmailData } from "../lib/graph.js";
+import type { DispatchResult } from "../lib/conversation-archive-dispatch.js";
+/**
+ * The email-sampler's single ingest step, isolated as a pure function with
+ * injected fetch / writer / cursor so the loop and the systemd unit stay thin
+ * and every branch is testable without IMAP, Neo4j, or a clock (Task 2682).
+ */
+export interface SamplerDeps {
+    fetchSince: (config: EmailConfig, password: string, sinceUid: number, recipients: string[] | undefined) => Promise<{
+        uidValidity: number;
+        emails: FetchedEmail[];
+        maxUid: number;
+    }>;
+    write: (messages: EmailData[]) => Promise<DispatchResult>;
+    readCursor: (accountId: string, email: string) => Promise<SamplerCursor | null>;
+    advanceCursor: (accountId: string, email: string, cursorUid: number, uidValidity: number) => Promise<void>;
+    recipients: (config: EmailConfig) => string[] | undefined;
+    log: (line: string) => void;
+}
+export interface SamplerAccount {
+    accountId: string;
+    config: EmailConfig;
+    password: string;
+}
+export interface SampleResult {
+    mailbox: string;
+    fetched: number;
+    cursor: number;
+    error?: string;
+}
+/**
+ * Sample one mailbox: fetch inbound UIDs above the sampler's own cursor, write
+ * them to the graph, and advance the cursor — but only after a successful write.
+ *
+ * Cases, in order:
+ *  - fetch throws → log op=sample-error, cursor unchanged, retried next cycle.
+ *  - the mailbox's live uidValidity differs from the stored one → the stored UID
+ *    is void (the server renumbered), so reset the cursor to 0 for the new
+ *    uidValidity and let the next cycle backfill cleanly. This cycle writes
+ *    nothing, because `UID > oldCursor` against a new sequence is unreliable.
+ *  - no messages above the cursor → no-op, cursor unchanged.
+ *  - write throws → log op=sample-error, cursor unchanged, retried next cycle.
+ *  - otherwise → advance the cursor to the fetched maxUid.
+ */
+export declare function sampleMailbox(deps: SamplerDeps, account: SamplerAccount): Promise<SampleResult>;
+//# sourceMappingURL=sample-mailbox.d.ts.map

package/payload/platform/plugins/email/mcp/dist/sampler/sample-mailbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample-mailbox.d.ts","sourceRoot":"","sources":["../../src/sampler/sample-mailbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAE9E;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,CACV,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,KAC7B,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1D,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAChF,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3G,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM,EAAE,GAAG,SAAS,CAAC;IAC1D,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgCD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAoCrG"}

package/payload/platform/plugins/email/mcp/dist/sampler/sample-mailbox.js

@@ -0,0 +1,77 @@
+function msg(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+/** Map a fetched IMAP message to the archive-writer's record shape. The mapping
+ *  matches what email-ingest builds, EXCEPT the screening label: email-ingest
+ *  stamps "clean" because an operator approved the message, whereas the sampler
+ *  runs no screen and has no operator, so it stamps "unscreened" — the honest
+ *  value a later gate needs to tell auto-sampled mail from operator-vetted mail. */
+function toEmailData(e, accountId, config, uidValidity) {
+    return {
+        messageId: e.messageId,
+        inReplyTo: e.inReplyTo,
+        toAddresses: e.toAddresses,
+        ccAddresses: e.ccAddresses,
+        uid: e.uid,
+        uidValidity,
+        mailbox: "INBOX",
+        recipientAddress: config.email,
+        fromAddress: e.fromAddress,
+        fromName: e.fromName,
+        subject: e.subject,
+        bodyPreview: e.bodyPreview,
+        receivedAt: e.date,
+        accountId,
+        screening: "unscreened",
+        screeningReason: "sampler-ingest",
+    };
+}
+/**
+ * Sample one mailbox: fetch inbound UIDs above the sampler's own cursor, write
+ * them to the graph, and advance the cursor — but only after a successful write.
+ *
+ * Cases, in order:
+ *  - fetch throws → log op=sample-error, cursor unchanged, retried next cycle.
+ *  - the mailbox's live uidValidity differs from the stored one → the stored UID
+ *    is void (the server renumbered), so reset the cursor to 0 for the new
+ *    uidValidity and let the next cycle backfill cleanly. This cycle writes
+ *    nothing, because `UID > oldCursor` against a new sequence is unreliable.
+ *  - no messages above the cursor → no-op, cursor unchanged.
+ *  - write throws → log op=sample-error, cursor unchanged, retried next cycle.
+ *  - otherwise → advance the cursor to the fetched maxUid.
+ */
+export async function sampleMailbox(deps, account) {
+    const { accountId, config, password } = account;
+    const box = config.email;
+    const stored = await deps.readCursor(accountId, box);
+    const sinceUid = stored?.cursorUid ?? 0;
+    let result;
+    try {
+        result = await deps.fetchSince(config, password, sinceUid, deps.recipients(config));
+    }
+    catch (e) {
+        deps.log(`op=sample-error mailbox=${box} detail=${msg(e)}`);
+        return { mailbox: box, fetched: 0, cursor: sinceUid, error: msg(e) };
+    }
+    if (stored?.uidValidity != null && stored.uidValidity !== result.uidValidity) {
+        await deps.advanceCursor(accountId, box, 0, result.uidValidity);
+        deps.log(`op=sample mailbox=${box} fetched=0 cursor=0 note=uidvalidity-reset`);
+        return { mailbox: box, fetched: 0, cursor: 0 };
+    }
+    if (result.emails.length === 0) {
+        deps.log(`op=sample mailbox=${box} fetched=0 cursor=${sinceUid}`);
+        return { mailbox: box, fetched: 0, cursor: sinceUid };
+    }
+    const messages = result.emails.map((e) => toEmailData(e, accountId, config, result.uidValidity));
+    try {
+        await deps.write(messages);
+    }
+    catch (e) {
+        deps.log(`op=sample-error mailbox=${box} detail=${msg(e)}`);
+        return { mailbox: box, fetched: messages.length, cursor: sinceUid, error: msg(e) };
+    }
+    await deps.advanceCursor(accountId, box, result.maxUid, result.uidValidity);
+    deps.log(`op=sample mailbox=${box} fetched=${messages.length} cursor=${result.maxUid}`);
+    return { mailbox: box, fetched: messages.length, cursor: result.maxUid };
+}
+//# sourceMappingURL=sample-mailbox.js.map

package/payload/platform/plugins/email/mcp/dist/sampler/sample-mailbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample-mailbox.js","sourceRoot":"","sources":["../../src/sampler/sample-mailbox.ts"],"names":[],"mappings":"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"}

package/payload/platform/plugins/scheduling/mcp/dist/tools/__tests__/scheduling-gate.test.js

@@ -17,7 +17,7 @@ vi.mock("../../lib/neo4j.js", () => ({
         close: vi.fn(async () => { }),
     }),
 }));
-import { runSchedulingGate, advanceGateMark, watermarkPath, readWatermarks, readWatermarksChecked, foldMailWatermarks, parseD1Count, digestBusy, } from "../scheduling-gate.js";
+import { runSchedulingGate, advanceGateMark, watermarkPath, readWatermarks, readWatermarksChecked, foldMailWatermarks, parseD1Count, digestBusy, slotKey, slotPosition, slotsIn, promoteSlot, } from "../scheduling-gate.js";
 const ACCOUNT = "20028fb5-0000-4000-8000-000000000000";
 const EVENT = "65ef758c-0000-4000-8000-000000000000";
 let platformRoot;
@@ -34,6 +34,9 @@ function quietSources(over = {}) {
         telegramInbound: async () => ({ newestInboundAt: null }),
         // Task 2657 — "quiet" for the Outlook arm is a folder holding no message.
         mailOutlook: async () => ({ newestReceivedAt: null }),
+        // Task 2681 — "quiet" for the graph arm is an account whose graph holds no
+        // appointment activity at all.
+        graphActivity: async () => ({ newestActivityAt: null }),
         ...over,
     };
 }
@@ -959,7 +962,7 @@ describe("unrecognised check type", () => {
             errored: [
                 {
                     kind: "nonsense",
-                    detail: 'unknown check type "nonsense" — accepted: mail, d1, whatsapp, calendar, telegram',
+                    detail: 'unknown check type "nonsense" — accepted: mail, d1, whatsapp, calendar, telegram, graph',
                 },
             ],
         });
@@ -983,7 +986,7 @@ describe("unrecognised check type", () => {
             errored: [
                 {
                     kind: "nonsense",
-                    detail: 'unknown check type "nonsense" — accepted: mail, d1, whatsapp, calendar, telegram',
+                    detail: 'unknown check type "nonsense" — accepted: mail, d1, whatsapp, calendar, telegram, graph',
                 },
             ],
         });
@@ -1282,4 +1285,79 @@ describe("observed positions (Task 2663)", () => {
         expect(result.observed).toEqual({});
     });
 });
+// Task 2681 — the graph activity check: appointment activity in the account's
+// own graph, newest timestamp against a stored watermark, mirroring telegram.
+describe("graph check", () => {
+    const GRAPH = { type: "graph", scope: "appointments" };
+    const graphAt = (iso) => ({
+        graphActivity: async () => ({ newestActivityAt: iso }),
+    });
+    it("is false on an empty graph (null newest), and records no position", async () => {
+        expect(await run([GRAPH], quietSources(graphAt(null)))).toMatchObject({
+            hasWork: false,
+            reasons: [],
+            errored: [],
+        });
+    });
+    it("is true when activity is newer than the watermark", async () => {
+        seedWatermarks({ graph: { updatedAt: "2026-08-13T06:00:00.000Z" } });
+        expect(await run([GRAPH], quietSources(graphAt("2026-08-13T07:00:00.000Z")))).toMatchObject({
+            hasWork: true,
+            reasons: ["graph"],
+            errored: [],
+        });
+    });
+    it("is false when activity equals the watermark (>, never >=)", async () => {
+        seedWatermarks({ graph: { updatedAt: "2026-08-13T07:00:00.000Z" } });
+        expect(await run([GRAPH], quietSources(graphAt("2026-08-13T07:00:00.000Z")))).toMatchObject({
+            hasWork: false,
+        });
+    });
+    it("is true on a first run (no watermark) when the graph has any activity", async () => {
+        expect(await run([GRAPH], quietSources(graphAt("2026-08-13T07:00:00.000Z")))).toMatchObject({
+            hasWork: true,
+            reasons: ["graph"],
+        });
+    });
+    it("fails open when the graph source throws, never a silent mute", async () => {
+        const result = await run([GRAPH], quietSources({ graphActivity: async () => { throw new Error("neo4j down"); } }));
+        expect(result.hasWork).toBe(true);
+        expect(result.errored.map((e) => e.kind)).toContain("graph");
+    });
+});
+describe("graph slot plumbing", () => {
+    it("round-trips through slotKey, slotPosition, slotsIn and promoteSlot", () => {
+        const marks = { graph: { updatedAt: "2026-08-13T07:00:00.000Z" } };
+        expect(slotKey({ kind: "graph" })).toBe("graph");
+        expect(slotPosition({ kind: "graph" }, marks)).toBe("2026-08-13T07:00:00.000Z");
+        expect(slotsIn(marks)).toContainEqual({ kind: "graph" });
+        const into = {};
+        expect(promoteSlot({ kind: "graph" }, marks, into)).toBe(true);
+        expect(into.graph?.updatedAt).toBe("2026-08-13T07:00:00.000Z");
+    });
+    it("promoteSlot returns false when the source holds no graph position", () => {
+        expect(promoteSlot({ kind: "graph" }, {}, {})).toBe(false);
+    });
+});
+describe("REAL_SOURCES.graphActivity", () => {
+    it("returns the newest ISO string the graph holds", async () => {
+        neo4jRecords = [{ get: (k) => (k === "newest" ? "2026-08-13T07:00:00.000Z" : null) }];
+        const { REAL_SOURCES: S } = await import("../scheduling-gate.js");
+        expect(await S.graphActivity(ACCOUNT, "appointments")).toEqual({
+            newestActivityAt: "2026-08-13T07:00:00.000Z",
+        });
+    });
+    it("returns null when the graph holds no such node (max over no rows)", async () => {
+        neo4jRecords = [{ get: () => null }];
+        const { REAL_SOURCES: S } = await import("../scheduling-gate.js");
+        expect(await S.graphActivity(ACCOUNT, "appointments")).toEqual({ newestActivityAt: null });
+    });
+    it("throws on a non-string timestamp, so the probe fails open rather than muting", async () => {
+        // A :Meeting written by a path storing a neo4j datetime/Integer, not an ISO
+        // string. Coercing to null would answer "quiet" about a graph never read.
+        neo4jRecords = [{ get: (k) => (k === "newest" ? 1723531200000 : null) }];
+        const { REAL_SOURCES: S } = await import("../scheduling-gate.js");
+        await expect(S.graphActivity(ACCOUNT, "appointments")).rejects.toThrow(/expected an ISO string/);
+    });
+});
 //# sourceMappingURL=scheduling-gate.test.js.map