@rubytech/create-maxy-code 0.1.603 → 0.1.605

package/payload/platform/plugins/outlook/mcp/dist/__tests__/sampler-cursor.test.js

@@ -0,0 +1,102 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { mkdtempSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { readCursor, writeCursor } from "../sampler/cursor.js";
+function tmp() {
+    return mkdtempSync(join(tmpdir(), "outlook-cursor-"));
+}
+function pathFor(dir, accountId) {
+    return join(dir, accountId, "secrets", "outlook", "sampler-cursors.json");
+}
+test("a mailbox with no cursor reads null", () => {
+    assert.equal(readCursor(tmp(), "acct-1", "a@example.com"), null);
+});
+test("a written cursor reads back for that mailbox only", () => {
+    const dir = tmp();
+    writeCursor(dir, "acct-1", "a@example.com", {
+        newestReceivedAt: "2026-08-13T09:00:00Z",
+        idsAtNewest: ["id-1"],
+    });
+    assert.deepEqual(readCursor(dir, "acct-1", "a@example.com"), {
+        newestReceivedAt: "2026-08-13T09:00:00Z",
+        idsAtNewest: ["id-1"],
+    });
+    assert.equal(readCursor(dir, "acct-1", "b@example.com"), null);
+});
+test("a second mailbox's write preserves the first", () => {
+    const dir = tmp();
+    writeCursor(dir, "acct-1", "a@example.com", {
+        newestReceivedAt: "2026-08-13T09:00:00Z",
+        idsAtNewest: ["id-1"],
+    });
+    writeCursor(dir, "acct-1", "b@example.com", {
+        newestReceivedAt: "2026-08-13T10:00:00Z",
+        idsAtNewest: ["id-2"],
+    });
+    assert.equal(readCursor(dir, "acct-1", "a@example.com")?.newestReceivedAt, "2026-08-13T09:00:00Z");
+    assert.equal(readCursor(dir, "acct-1", "b@example.com")?.newestReceivedAt, "2026-08-13T10:00:00Z");
+});
+test("a second account's cursors are a separate file", () => {
+    const dir = tmp();
+    writeCursor(dir, "acct-1", "a@example.com", {
+        newestReceivedAt: "2026-08-13T09:00:00Z",
+        idsAtNewest: [],
+    });
+    assert.equal(readCursor(dir, "acct-2", "a@example.com"), null);
+});
+test("the mailbox key is case- and whitespace-insensitive", () => {
+    const dir = tmp();
+    writeCursor(dir, "acct-1", " A@Example.com ", {
+        newestReceivedAt: "2026-08-13T09:00:00Z",
+        idsAtNewest: [],
+    });
+    assert.ok(readCursor(dir, "acct-1", "a@example.com"));
+});
+test("the cursor file is written 0600 and holds the mailbox key", () => {
+    const dir = tmp();
+    writeCursor(dir, "acct-1", "a@example.com", {
+        newestReceivedAt: "2026-08-13T09:00:00Z",
+        idsAtNewest: [],
+    });
+    const path = pathFor(dir, "acct-1");
+    assert.equal(statSync(path).mode & 0o777, 0o600);
+    assert.ok(Object.hasOwn(JSON.parse(readFileSync(path, "utf-8")), "a@example.com"));
+});
+test("an unparseable cursor file reads as no cursor rather than throwing", () => {
+    const dir = tmp();
+    writeCursor(dir, "acct-1", "a@example.com", {
+        newestReceivedAt: "2026-08-13T09:00:00Z",
+        idsAtNewest: [],
+    });
+    writeFileSync(pathFor(dir, "acct-1"), "{not json");
+    assert.equal(readCursor(dir, "acct-1", "a@example.com"), null);
+});
+test("an entry with no instant reads as no cursor", () => {
+    const dir = tmp();
+    writeCursor(dir, "acct-1", "a@example.com", {
+        newestReceivedAt: "2026-08-13T09:00:00Z",
+        idsAtNewest: [],
+    });
+    writeFileSync(pathFor(dir, "acct-1"), JSON.stringify({ "a@example.com": { idsAtNewest: [] } }));
+    assert.equal(readCursor(dir, "acct-1", "a@example.com"), null);
+});
+test("an entry with no id list reads as an empty exclusion set", () => {
+    const dir = tmp();
+    writeCursor(dir, "acct-1", "a@example.com", {
+        newestReceivedAt: "2026-08-13T09:00:00Z",
+        idsAtNewest: [],
+    });
+    writeFileSync(pathFor(dir, "acct-1"), JSON.stringify({ "a@example.com": { newestReceivedAt: "2026-08-13T09:00:00Z" } }));
+    assert.deepEqual(readCursor(dir, "acct-1", "a@example.com")?.idsAtNewest, []);
+});
+test("an inherited property name is not read as a stored cursor", () => {
+    const dir = tmp();
+    writeCursor(dir, "acct-1", "a@example.com", {
+        newestReceivedAt: "2026-08-13T09:00:00Z",
+        idsAtNewest: [],
+    });
+    assert.equal(readCursor(dir, "acct-1", "constructor"), null);
+});
+//# sourceMappingURL=sampler-cursor.test.js.map

package/payload/platform/plugins/outlook/mcp/dist/__tests__/sampler-cursor.test.js.map

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

package/payload/platform/plugins/outlook/mcp/dist/__tests__/sampler-enumerate.test.d.ts

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

package/payload/platform/plugins/outlook/mcp/dist/__tests__/sampler-enumerate.test.d.ts.map

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

package/payload/platform/plugins/outlook/mcp/dist/__tests__/sampler-enumerate.test.js

@@ -0,0 +1,125 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { TokenStore } from "../auth/token-store.js";
+import { DelegatedStore } from "../auth/delegated-store.js";
+import { censusLine, enumerateSampleableMailboxes } from "../sampler/enumerate.js";
+const ACCT = "11111111-2222-3333-4444-555555555555";
+const ACCT_B = "99999999-8888-7777-6666-555555555555";
+function tmp() {
+    return mkdtempSync(join(tmpdir(), "outlook-enum-"));
+}
+/** A provisioned account is a UUID directory holding a parseable account.json. */
+function provision(dir, accountId) {
+    mkdirSync(join(dir, accountId), { recursive: true });
+    writeFileSync(join(dir, accountId, "account.json"), JSON.stringify({ accountId }));
+}
+function connect(dir, accountId, graphUserId, mail) {
+    new TokenStore(accountId, dir, graphUserId).store("access", "refresh", 3600, {
+        graphUserId,
+        mail,
+        scopes: ["Mail.Read"],
+    });
+}
+test("an absent accounts dir enumerates nothing", () => {
+    const dir = join(tmp(), "absent");
+    assert.deepEqual(enumerateSampleableMailboxes(dir), { sampleable: [], skipped: [], accounts: 0 });
+});
+test("a signed-in mailbox is sampleable with the /me prefix", () => {
+    const dir = tmp();
+    provision(dir, ACCT);
+    connect(dir, ACCT, "guid-1", "a@example.com");
+    const { sampleable, skipped } = enumerateSampleableMailboxes(dir);
+    assert.deepEqual(skipped, []);
+    assert.deepEqual(sampleable, [
+        {
+            accountId: ACCT,
+            mailbox: "a@example.com",
+            mailboxKey: "guid-1",
+            pathPrefix: "/me",
+            via: null,
+        },
+    ]);
+});
+test("a directory with no account.json is not a provisioned account", () => {
+    const dir = tmp();
+    connect(dir, ACCT, "guid-1", "a@example.com");
+    assert.deepEqual(enumerateSampleableMailboxes(dir).sampleable, []);
+});
+test("a non-UUID directory name is not a provisioned account", () => {
+    const dir = tmp();
+    provision(dir, "not-a-uuid");
+    connect(dir, "not-a-uuid", "guid-1", "a@example.com");
+    assert.deepEqual(enumerateSampleableMailboxes(dir).sampleable, []);
+});
+test("every provisioned account is enumerated", () => {
+    const dir = tmp();
+    provision(dir, ACCT);
+    provision(dir, ACCT_B);
+    connect(dir, ACCT, "guid-1", "a@example.com");
+    connect(dir, ACCT_B, "guid-2", "b@example.com");
+    const boxes = enumerateSampleableMailboxes(dir).sampleable.map((m) => m.mailbox).sort();
+    assert.deepEqual(boxes, ["a@example.com", "b@example.com"]);
+});
+test("a delegated mailbox is sampleable through its delegator's prefix", () => {
+    const dir = tmp();
+    provision(dir, ACCT);
+    connect(dir, ACCT, "guid-1", "a@example.com");
+    new DelegatedStore(ACCT, dir).add("shared@example.com", "guid-1", 1);
+    const { sampleable } = enumerateSampleableMailboxes(dir);
+    const shared = sampleable.find((m) => m.mailbox === "shared@example.com");
+    assert.deepEqual(shared, {
+        accountId: ACCT,
+        mailbox: "shared@example.com",
+        mailboxKey: "guid-1",
+        pathPrefix: `/users/${encodeURIComponent("shared@example.com")}`,
+        via: "a@example.com",
+    });
+});
+test("a delegated record whose delegator is gone is skipped with a reason", () => {
+    const dir = tmp();
+    provision(dir, ACCT);
+    new DelegatedStore(ACCT, dir).add("shared@example.com", "guid-missing", 1);
+    const { sampleable, skipped } = enumerateSampleableMailboxes(dir);
+    assert.deepEqual(sampleable, []);
+    assert.equal(skipped.length, 1);
+    assert.equal(skipped[0].mailbox, "shared@example.com");
+    assert.match(skipped[0].reason, /delegator-missing/);
+});
+test("a mailbox with a blank email is skipped, never sampled", () => {
+    const dir = tmp();
+    provision(dir, ACCT);
+    connect(dir, ACCT, "guid-2", null);
+    const { sampleable, skipped } = enumerateSampleableMailboxes(dir);
+    assert.deepEqual(sampleable, []);
+    assert.equal(skipped.length, 1);
+    assert.match(skipped[0].reason, /blank-email/);
+});
+test("an account with no outlook mailboxes contributes nothing", () => {
+    const dir = tmp();
+    provision(dir, ACCT);
+    // The account IS walked; it simply holds no mailbox. `accounts: 1` is what
+    // separates that from an accountsDir that resolved nowhere.
+    assert.deepEqual(enumerateSampleableMailboxes(dir), { sampleable: [], skipped: [], accounts: 1 });
+});
+test("the census is emitted with zeros when nothing is connected", () => {
+    const dir = tmp();
+    provision(dir, ACCT);
+    // The guarantee: an install with no Outlook mailbox still says so. Silence
+    // here would be indistinguishable from the arm never running.
+    assert.equal(censusLine(enumerateSampleableMailboxes(dir)), "op=sample-census provider=outlook accounts=1 mailboxes=0 delegated=0 skipped=0");
+});
+test("the census counts an absent accounts dir as zero accounts", () => {
+    assert.equal(censusLine(enumerateSampleableMailboxes(join(tmp(), "absent"))), "op=sample-census provider=outlook accounts=0 mailboxes=0 delegated=0 skipped=0");
+});
+test("the census separates delegated mailboxes from signed-in ones", () => {
+    const dir = tmp();
+    provision(dir, ACCT);
+    connect(dir, ACCT, "guid-1", "a@example.com");
+    new DelegatedStore(ACCT, dir).add("shared@example.com", "guid-1", 1);
+    new DelegatedStore(ACCT, dir).add("orphan@example.com", "guid-missing", 1);
+    assert.equal(censusLine(enumerateSampleableMailboxes(dir)), "op=sample-census provider=outlook accounts=1 mailboxes=2 delegated=1 skipped=1");
+});
+//# sourceMappingURL=sampler-enumerate.test.js.map

package/payload/platform/plugins/outlook/mcp/dist/__tests__/sampler-enumerate.test.js.map

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

package/payload/platform/plugins/outlook/mcp/dist/sampler/arm.d.ts

@@ -0,0 +1,2 @@
+export declare function runOutlookArm(log: (line: string) => void): Promise<void>;
+//# sourceMappingURL=arm.d.ts.map

package/payload/platform/plugins/outlook/mcp/dist/sampler/arm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arm.d.ts","sourceRoot":"","sources":["../../src/sampler/arm.ts"],"names":[],"mappings":"AA8DA,wBAAsB,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAmE9E"}

package/payload/platform/plugins/outlook/mcp/dist/sampler/arm.js

@@ -0,0 +1,109 @@
+/**
+ * The Outlook arm of the email sampler (Task 2683).
+ *
+ * One exported function, called once per sampler cycle by the email plugin's
+ * `sampler/main.ts`. It lives here rather than in the email plugin because every
+ * reuse target — the mailbox registry, the token store, the Graph client, the
+ * list and body tools, the archive dispatcher — is a sibling of this file. The
+ * email sampler reaches it by resolving this module's compiled path against
+ * PLATFORM_ROOT, the same way `scheduling`'s `check-due-events` reaches
+ * `plugins/outlook/mcp/dist/scripts/draft-reconcile.js`.
+ *
+ * Both arms write to one log, because Task 2683's verification names
+ * `logs-read.sh --tail email-sampler` filtered on `provider=outlook`.
+ */
+import { resolve } from "node:path";
+import { MailboxRegistry } from "../auth/mailbox-registry.js";
+import { dispatchOutlookMessagesToConversationArchive } from "../lib/conversation-archive-dispatch.js";
+import { runMailFetchBody } from "../tools/mail-fetch-body.js";
+import { runMailList } from "../tools/mail-list.js";
+import { readCursor, writeCursor } from "./cursor.js";
+import { censusLine, enumerateSampleableMailboxes, } from "./enumerate.js";
+import { sampleOutlookMailbox } from "./sample-outlook-mailbox.js";
+/** One page per list call; the sampler pages to exhaustion. 100 keeps the common
+ *  case to a single call and stays well inside mail-list's 250 clamp. */
+const PAGE_SIZE = 100;
+/** Same derivation the MCP server's index.ts uses, so the arm and the tools
+ *  address one accounts directory. */
+function accountsDirFrom(platformRoot) {
+    return resolve(platformRoot, "..", "data/accounts");
+}
+/**
+ * A Graph config addressing exactly one mailbox. The tokenStore is always a
+ * signed-in mailbox's; a delegated mailbox has no sign-in of its own and is
+ * reached by `mailboxPathPrefix`, which `callGraph` substitutes for the `/me`
+ * segment the tools request.
+ */
+function configFor(target, accountsDir, clientId, tenantId) {
+    const registry = new MailboxRegistry(target.accountId, accountsDir);
+    return {
+        clientId,
+        tenantId,
+        accountId: target.accountId,
+        tokenStore: registry.storeFor(target.mailboxKey),
+        mailboxAddress: target.mailbox,
+        mailboxPathPrefix: target.pathPrefix,
+    };
+}
+export async function runOutlookArm(log) {
+    const clientId = process.env.OUTLOOK_CLIENT_ID ?? "";
+    const tenantId = process.env.OUTLOOK_TENANT_ID ?? "common";
+    if (!clientId) {
+        // A brand with no Azure app cannot mint or refresh a token. Saying so once
+        // per cycle beats one auth error per mailbox per cycle for ever.
+        log("op=sample-skip provider=outlook detail=no-client-id");
+        return;
+    }
+    const platformRoot = process.env.PLATFORM_ROOT;
+    if (!platformRoot) {
+        log("op=sample-error mailbox=<enumeration> provider=outlook detail=PLATFORM_ROOT-unset");
+        return;
+    }
+    const accountsDir = accountsDirFrom(platformRoot);
+    const enumerated = enumerateSampleableMailboxes(accountsDir);
+    const { sampleable, skipped } = enumerated;
+    // One census per cycle, before the per-mailbox lines and emitted even when
+    // every count is zero. Without it an install with no Outlook mailbox produces
+    // no output at all, which is indistinguishable from the arm never running,
+    // and those two have different remedies.
+    log(censusLine(enumerated));
+    for (const s of skipped) {
+        log(`op=sample-error mailbox=${s.mailbox} provider=outlook detail=${s.reason}`);
+    }
+    for (const target of sampleable) {
+        const config = configFor(target, accountsDir, clientId, tenantId);
+        const deps = {
+            list: (_t, since, cursor) => runMailList(config, { folder: "Inbox", top: PAGE_SIZE, since, cursor }),
+            fetchBody: async (_t, messageId) => {
+                const b = await runMailFetchBody(config, { messageId });
+                return {
+                    id: b.id,
+                    subject: b.subject,
+                    from: b.from,
+                    fromName: b.fromName,
+                    to: b.to,
+                    cc: b.cc,
+                    conversationId: b.conversationId,
+                    body: b.body,
+                    receivedDateTime: b.receivedDateTime,
+                };
+            },
+            write: (m) => dispatchOutlookMessagesToConversationArchive(m),
+            readCursor: (t) => readCursor(accountsDir, t.accountId, t.mailbox),
+            writeCursor: (t, c) => writeCursor(accountsDir, t.accountId, t.mailbox, c),
+            log,
+            now: () => Date.now(),
+        };
+        try {
+            await sampleOutlookMailbox(deps, target);
+        }
+        catch (e) {
+            // sampleOutlookMailbox handles its own fetch and write failures; this
+            // catches anything thrown outside them (a cursor write, a token-store
+            // read) so one mailbox never ends the cycle for the rest.
+            log(`op=sample-error mailbox=${target.mailbox} provider=outlook ` +
+                `detail=${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+}
+//# sourceMappingURL=arm.js.map

package/payload/platform/plugins/outlook/mcp/dist/sampler/arm.js.map

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

package/payload/platform/plugins/outlook/mcp/dist/sampler/cursor.d.ts

@@ -0,0 +1,25 @@
+export interface OutlookSamplerCursor {
+    /** Raw `receivedDateTime` of the newest message written, as Graph returned it.
+     *  Raw so nothing here can shift an instant by reformatting it. */
+    newestReceivedAt: string;
+    /** Ids already written that carry exactly `newestReceivedAt`. */
+    idsAtNewest: string[];
+}
+export type OutlookSamplerCursors = Record<string, OutlookSamplerCursor>;
+/**
+ * Every cursor for one account. A missing or unparseable file reads as an empty
+ * map rather than throwing: the sampler runs unattended, so a corrupt file must
+ * degrade to a re-backfill of that account, never stop the cycle.
+ */
+export declare function readCursors(accountsDir: string, accountId: string): OutlookSamplerCursors;
+/** One mailbox's cursor, or null when it has never been sampled. An entry whose
+ *  instant is not a string is treated as absent — a half-written record must
+ *  read as "start again", never as a position. */
+export declare function readCursor(accountsDir: string, accountId: string, mailbox: string): OutlookSamplerCursor | null;
+/**
+ * Replace one mailbox's cursor, preserving every other mailbox's on the account.
+ * Atomic via temp + rename, so a crash mid-write leaves the previous file whole;
+ * a torn file would re-backfill every mailbox on the account.
+ */
+export declare function writeCursor(accountsDir: string, accountId: string, mailbox: string, cursor: OutlookSamplerCursor): void;
+//# sourceMappingURL=cursor.d.ts.map

package/payload/platform/plugins/outlook/mcp/dist/sampler/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/sampler/cursor.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,oBAAoB;IACnC;uEACmE;IACnE,gBAAgB,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAezE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,qBAAqB,CAUzF;AAED;;kDAEkD;AAClD,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,oBAAoB,GAAG,IAAI,CAW7B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,oBAAoB,GAC3B,IAAI,CAqBN"}

package/payload/platform/plugins/outlook/mcp/dist/sampler/cursor.js

@@ -0,0 +1,94 @@
+/**
+ * The Outlook sampler's own cursor store (Task 2683).
+ *
+ * Outlook mailboxes have no `:EmailAccount` node, so there is no graph property
+ * to hold a cursor the way the IMAP arm holds `samplerCursorUid`. One JSON file
+ * per account, keyed by the mailbox's SMTP address, covers signed-in and
+ * delegated mailboxes with one shape. It holds no secret, which is the same
+ * position `delegated.json` already occupies in the same 0700 directory.
+ *
+ * The cursor is an instant plus the ids seen at that instant. A timestamp alone
+ * cannot be both lossless and duplicate-free: `receivedDateTime gt cursor` drops
+ * a second message that arrived at the identical instant, and `ge cursor`
+ * re-ingests the boundary message on every cycle for ever. Querying `ge` and
+ * excluding the ids already written at that exact instant loses nothing and
+ * repeats nothing.
+ *
+ * Written only by the sampler, which is a single process, so no lock is needed.
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
+import { randomBytes } from "node:crypto";
+import { join } from "node:path";
+/** The one address form used as a key, matching `delegated-store.ts`. */
+function key(mailbox) {
+    return mailbox.trim().toLowerCase();
+}
+function secretsDir(accountsDir, accountId) {
+    return join(accountsDir, accountId, "secrets", "outlook");
+}
+function cursorsPath(accountsDir, accountId) {
+    return join(secretsDir(accountsDir, accountId), "sampler-cursors.json");
+}
+/**
+ * Every cursor for one account. A missing or unparseable file reads as an empty
+ * map rather than throwing: the sampler runs unattended, so a corrupt file must
+ * degrade to a re-backfill of that account, never stop the cycle.
+ */
+export function readCursors(accountsDir, accountId) {
+    try {
+        const parsed = JSON.parse(readFileSync(cursorsPath(accountsDir, accountId), "utf-8"));
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            return {};
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+/** One mailbox's cursor, or null when it has never been sampled. An entry whose
+ *  instant is not a string is treated as absent — a half-written record must
+ *  read as "start again", never as a position. */
+export function readCursor(accountsDir, accountId, mailbox) {
+    const all = readCursors(accountsDir, accountId);
+    const k = key(mailbox);
+    // Own-property check, not a bare index: a plain object answers "constructor"
+    // with an inherited function, which would read as a stored cursor.
+    const entry = Object.hasOwn(all, k) ? all[k] : undefined;
+    if (!entry || typeof entry.newestReceivedAt !== "string")
+        return null;
+    return {
+        newestReceivedAt: entry.newestReceivedAt,
+        idsAtNewest: Array.isArray(entry.idsAtNewest) ? entry.idsAtNewest : [],
+    };
+}
+/**
+ * Replace one mailbox's cursor, preserving every other mailbox's on the account.
+ * Atomic via temp + rename, so a crash mid-write leaves the previous file whole;
+ * a torn file would re-backfill every mailbox on the account.
+ */
+export function writeCursor(accountsDir, accountId, mailbox, cursor) {
+    const path = cursorsPath(accountsDir, accountId);
+    const next = {
+        ...readCursors(accountsDir, accountId),
+        [key(mailbox)]: cursor,
+    };
+    mkdirSync(secretsDir(accountsDir, accountId), { recursive: true, mode: 0o700 });
+    const temp = `${path}.${process.pid}.${randomBytes(6).toString("hex")}.tmp`;
+    try {
+        writeFileSync(temp, JSON.stringify(next, null, 2), { mode: 0o600 });
+        renameSync(temp, path);
+    }
+    catch (err) {
+        // Unique temp names are never reused, so a failed write or rename would
+        // otherwise leave a file nothing ever cleans up.
+        try {
+            if (existsSync(temp))
+                unlinkSync(temp);
+        }
+        catch {
+            /* best effort — the original error is what matters */
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=cursor.js.map

package/payload/platform/plugins/outlook/mcp/dist/sampler/cursor.js.map

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

package/payload/platform/plugins/outlook/mcp/dist/sampler/enumerate.d.ts

@@ -0,0 +1,41 @@
+export interface SampleableMailbox {
+    accountId: string;
+    /** SMTP address. The cursor key and the `mailbox=` log field. */
+    mailbox: string;
+    /** The TokenStore key whose tokens perform the read. On a delegated mailbox
+     *  this is the DELEGATOR's key — a shared mailbox never signs in. */
+    mailboxKey: string;
+    /** "/me" for a signed-in mailbox, "/users/<encoded address>" for a delegated one. */
+    pathPrefix: string;
+    /** The delegator's address on a delegated mailbox, else null. */
+    via: string | null;
+}
+export interface SkippedMailbox {
+    accountId: string;
+    mailbox: string;
+    reason: string;
+}
+/**
+ * Account directories that are provisioned: a UUID name holding a parseable
+ * `account.json`. A present-but-unparseable file excludes the directory, the
+ * same corruption discipline `account-enumeration` applies.
+ */
+export declare function listProvisionedAccountIds(accountsDir: string): string[];
+export interface EnumerationResult {
+    sampleable: SampleableMailbox[];
+    skipped: SkippedMailbox[];
+    /** Provisioned accounts walked. Carried out so the census reports it without
+     *  a second directory read, and so `accounts=0` is distinguishable from an
+     *  accountsDir that resolved somewhere that does not exist. */
+    accounts: number;
+}
+/**
+ * The per-cycle census line, emitted even when every count is zero.
+ *
+ * Pure, so the "never silent" guarantee is testable without a directory. An arm
+ * that emits nothing on an install with no Outlook mailbox is indistinguishable
+ * from an arm that never ran, and those two have different remedies.
+ */
+export declare function censusLine(result: EnumerationResult): string;
+export declare function enumerateSampleableMailboxes(accountsDir: string): EnumerationResult;
+//# sourceMappingURL=enumerate.d.ts.map

package/payload/platform/plugins/outlook/mcp/dist/sampler/enumerate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enumerate.d.ts","sourceRoot":"","sources":["../../src/sampler/enumerate.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB;yEACqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBvE;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B;;mEAE+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAM5D;AAED,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,CA6DnF"}