@rubytech/create-maxy 1.0.762 → 1.0.764

package/payload/platform/plugins/outlook/mcp/dist/tools/calendar-event.js

@@ -0,0 +1,32 @@
+import { callGraph } from "../lib/graph-client.js";
+import { log, trunc } from "../lib/log.js";
+import { shapeEvent } from "./calendar-list.js";
+const FIELDS = "id,subject,start,end,location,attendees,isAllDay,organizer,bodyPreview,body,webLink";
+export async function runCalendarEvent(config, args) {
+    const eventId = args.eventId.trim();
+    if (!eventId) {
+        throw new Error("calendar-event: eventId is required.");
+    }
+    const startMs = Date.now();
+    const raw = await callGraph(config, async (client) => {
+        return (await client
+            .api(`/me/events/${encodeURIComponent(eventId)}`)
+            .select(FIELDS)
+            .get());
+    }, { tool: "calendar-event" });
+    const base = shapeEvent(raw);
+    const detail = {
+        ...base,
+        bodyPreview: (raw.bodyPreview ?? "").slice(0, 1024),
+        body: (raw.body?.content ?? "").slice(0, 16384),
+        webLink: raw.webLink ?? null,
+    };
+    log({
+        event: "calendar-event",
+        account: config.accountId,
+        eventId: trunc(eventId, 12),
+        elapsedMs: Date.now() - startMs,
+    });
+    return detail;
+}
+//# sourceMappingURL=calendar-event.js.map

package/payload/platform/plugins/outlook/mcp/dist/tools/calendar-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-event.js","sourceRoot":"","sources":["../../src/tools/calendar-event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,UAAU,EAA0B,MAAM,oBAAoB,CAAC;AA6BxE,MAAM,MAAM,GAAG,qFAAqF,CAAC;AAErG,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAyB,EACzB,IAAuB;IAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,MAAM,GAAG,GAAG,MAAM,SAAS,CACzB,MAAM,EACN,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,OAAO,CAAC,MAAM,MAAM;aACjB,GAAG,CAAC,cAAc,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;aAChD,MAAM,CAAC,MAAM,CAAC;aACd,GAAG,EAAE,CAAmB,CAAC;IAC9B,CAAC,EACD,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAC3B,CAAC;IAEF,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAwB;QAClC,GAAG,IAAI;QACP,WAAW,EAAE,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;QACnD,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;QAC/C,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;KAC7B,CAAC;IAEF,GAAG,CAAC;QACF,KAAK,EAAE,gBAAgB;QACvB,OAAO,EAAE,MAAM,CAAC,SAAS;QACzB,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;KAChC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/payload/platform/plugins/outlook/mcp/dist/tools/calendar-list.d.ts

@@ -0,0 +1,59 @@
+import type { GraphClientConfig } from "../lib/graph-client.js";
+export interface CalendarListArgs {
+    rangeDays?: number;
+    top?: number;
+}
+export interface CalendarEventItem {
+    id: string;
+    subject: string | null;
+    start: {
+        dateTime: string;
+        timeZone: string;
+    };
+    end: {
+        dateTime: string;
+        timeZone: string;
+    };
+    location: string | null;
+    attendees: Array<{
+        email: string;
+        name: string | null;
+        response: string;
+    }>;
+    isAllDay: boolean;
+    organizer: string | null;
+}
+interface RawEvent {
+    id: string;
+    subject?: string | null;
+    start: {
+        dateTime: string;
+        timeZone: string;
+    };
+    end: {
+        dateTime: string;
+        timeZone: string;
+    };
+    location?: {
+        displayName?: string;
+    } | null;
+    attendees?: Array<{
+        emailAddress: {
+            address: string;
+            name?: string;
+        };
+        status?: {
+            response?: string;
+        };
+    }>;
+    isAllDay?: boolean;
+    organizer?: {
+        emailAddress?: {
+            address?: string;
+        };
+    };
+}
+export declare function runCalendarList(config: GraphClientConfig, args: CalendarListArgs): Promise<CalendarEventItem[]>;
+export declare function shapeEvent(ev: RawEvent): CalendarEventItem;
+export {};
+//# sourceMappingURL=calendar-list.d.ts.map

package/payload/platform/plugins/outlook/mcp/dist/tools/calendar-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-list.d.ts","sourceRoot":"","sources":["../../src/tools/calendar-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAIhE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3C,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,YAAY,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACjD,MAAM,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAChC,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACrD;AAQD,wBAAsB,eAAe,CACnC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA+B9B;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,GAAG,iBAAiB,CAgB1D"}

package/payload/platform/plugins/outlook/mcp/dist/tools/calendar-list.js

@@ -0,0 +1,54 @@
+import { callGraph } from "../lib/graph-client.js";
+import { log } from "../lib/log.js";
+const FIELDS = "id,subject,start,end,location,attendees,isAllDay,organizer";
+export async function runCalendarList(config, args) {
+    const rangeDays = clamp(args.rangeDays ?? 7, 1, 365);
+    const top = clamp(args.top ?? 100, 1, 500);
+    const startMs = Date.now();
+    const startISO = new Date().toISOString();
+    const endISO = new Date(Date.now() + rangeDays * 24 * 60 * 60 * 1000).toISOString();
+    const result = await callGraph(config, async (client) => {
+        return (await client
+            .api("/me/calendarView")
+            .query({ startDateTime: startISO, endDateTime: endISO })
+            .top(top)
+            .orderby("start/dateTime ASC")
+            .select(FIELDS)
+            .get());
+    }, { tool: "calendar-list" });
+    const events = result.value.map(shapeEvent);
+    log({
+        event: "calendar-list",
+        account: config.accountId,
+        rangeDays,
+        count: events.length,
+        elapsedMs: Date.now() - startMs,
+    });
+    return events;
+}
+export function shapeEvent(ev) {
+    return {
+        id: ev.id,
+        subject: ev.subject ?? null,
+        start: ev.start,
+        end: ev.end,
+        location: ev.location?.displayName ?? null,
+        attendees: ev.attendees?.map((a) => ({
+            email: a.emailAddress.address,
+            name: a.emailAddress.name ?? null,
+            response: a.status?.response ?? "none",
+        })) ?? [],
+        isAllDay: ev.isAllDay ?? false,
+        organizer: ev.organizer?.emailAddress?.address ?? null,
+    };
+}
+function clamp(input, lo, hi) {
+    if (!Number.isFinite(input))
+        return lo;
+    if (input < lo)
+        return lo;
+    if (input > hi)
+        return hi;
+    return Math.floor(input);
+}
+//# sourceMappingURL=calendar-list.js.map

package/payload/platform/plugins/outlook/mcp/dist/tools/calendar-list.js.map

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

package/payload/platform/plugins/outlook/mcp/dist/tools/contacts-list.d.ts

@@ -0,0 +1,14 @@
+import type { GraphClientConfig } from "../lib/graph-client.js";
+export interface ContactsListArgs {
+    top?: number;
+}
+export interface ContactItem {
+    id: string;
+    displayName: string | null;
+    emailAddresses: string[];
+    phones: string[];
+    jobTitle: string | null;
+    companyName: string | null;
+}
+export declare function runContactsList(config: GraphClientConfig, args: ContactsListArgs): Promise<ContactItem[]>;
+//# sourceMappingURL=contacts-list.d.ts.map

package/payload/platform/plugins/outlook/mcp/dist/tools/contacts-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts-list.d.ts","sourceRoot":"","sources":["../../src/tools/contacts-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAIhE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAmBD,wBAAsB,eAAe,CACnC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,WAAW,EAAE,CAAC,CAsCxB"}

package/payload/platform/plugins/outlook/mcp/dist/tools/contacts-list.js

@@ -0,0 +1,45 @@
+import { callGraph } from "../lib/graph-client.js";
+import { log } from "../lib/log.js";
+const FIELDS = "id,displayName,emailAddresses,businessPhones,homePhones,mobilePhone,jobTitle,companyName";
+export async function runContactsList(config, args) {
+    const top = clamp(args.top ?? 50, 1, 250);
+    const startMs = Date.now();
+    const result = await callGraph(config, async (client) => {
+        return (await client
+            .api("/me/contacts")
+            .top(top)
+            .select(FIELDS)
+            .get());
+    }, { tool: "contacts-list" });
+    const items = result.value.map((c) => ({
+        id: c.id,
+        displayName: c.displayName ?? null,
+        emailAddresses: (c.emailAddresses ?? [])
+            .map((e) => e.address)
+            .filter((a) => typeof a === "string"),
+        phones: [
+            ...(c.businessPhones ?? []),
+            ...(c.homePhones ?? []),
+            ...(c.mobilePhone ? [c.mobilePhone] : []),
+        ],
+        jobTitle: c.jobTitle ?? null,
+        companyName: c.companyName ?? null,
+    }));
+    log({
+        event: "contacts-list",
+        account: config.accountId,
+        count: items.length,
+        elapsedMs: Date.now() - startMs,
+    });
+    return items;
+}
+function clamp(input, lo, hi) {
+    if (!Number.isFinite(input))
+        return lo;
+    if (input < lo)
+        return lo;
+    if (input > hi)
+        return hi;
+    return Math.floor(input);
+}
+//# sourceMappingURL=contacts-list.js.map

package/payload/platform/plugins/outlook/mcp/dist/tools/contacts-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts-list.js","sourceRoot":"","sources":["../../src/tools/contacts-list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AA8BpC,MAAM,MAAM,GAAG,0FAA0F,CAAC;AAE1G,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAyB,EACzB,IAAsB;IAEtB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,MAAM,MAAM,GAAG,MAAM,SAAS,CAC5B,MAAM,EACN,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,OAAO,CAAC,MAAM,MAAM;aACjB,GAAG,CAAC,cAAc,CAAC;aACnB,GAAG,CAAC,GAAG,CAAC;aACR,MAAM,CAAC,MAAM,CAAC;aACd,GAAG,EAAE,CAA8B,CAAC;IACzC,CAAC,EACD,EAAE,IAAI,EAAE,eAAe,EAAE,CAC1B,CAAC;IAEF,MAAM,KAAK,GAAkB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI;QAClC,cAAc,EAAE,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC;aACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;aACrB,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;QACpD,MAAM,EAAE;YACN,GAAG,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC;YAC3B,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;YACvB,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C;QACD,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;QAC5B,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI;KACnC,CAAC,CAAC,CAAC;IAEJ,GAAG,CAAC;QACF,KAAK,EAAE,eAAe;QACtB,OAAO,EAAE,MAAM,CAAC,SAAS;QACzB,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;KAChC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,EAAU,EAAE,EAAU;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,EAAE,CAAC;IAC1B,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,EAAE,CAAC;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/payload/platform/plugins/outlook/mcp/dist/tools/mail-list.d.ts

@@ -0,0 +1,15 @@
+import type { GraphClientConfig } from "../lib/graph-client.js";
+export interface MailListArgs {
+    top?: number;
+    folder?: string;
+}
+export interface MailListItem {
+    id: string;
+    subject: string | null;
+    from: string | null;
+    receivedDateTime: string;
+    bodyPreview: string;
+    isRead: boolean;
+}
+export declare function runMailList(config: GraphClientConfig, args: MailListArgs): Promise<MailListItem[]>;
+//# sourceMappingURL=mail-list.d.ts.map

package/payload/platform/plugins/outlook/mcp/dist/tools/mail-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-list.d.ts","sourceRoot":"","sources":["../../src/tools/mail-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAIhE,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB;AAiBD,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CA+BzB"}

package/payload/platform/plugins/outlook/mcp/dist/tools/mail-list.js

@@ -0,0 +1,48 @@
+import { callGraph } from "../lib/graph-client.js";
+import { log } from "../lib/log.js";
+const FIELDS = "id,subject,from,receivedDateTime,bodyPreview,isRead";
+export async function runMailList(config, args) {
+    const top = clampTop(args.top, 25);
+    const folder = args.folder ?? "Inbox";
+    const startMs = Date.now();
+    const result = await callGraph(config, async (client) => {
+        const path = folder.toLowerCase() === "inbox" || folder === ""
+            ? "/me/mailFolders/Inbox/messages"
+            : `/me/mailFolders/${encodeURIComponent(folder)}/messages`;
+        return (await client
+            .api(path)
+            .top(top)
+            .orderby("receivedDateTime DESC")
+            .select(FIELDS)
+            .get());
+    }, { tool: "mail-list" });
+    const items = result.value.map(shapeMessage);
+    log({
+        event: "mail-list",
+        account: config.accountId,
+        folder,
+        count: items.length,
+        elapsedMs: Date.now() - startMs,
+    });
+    return items;
+}
+function shapeMessage(msg) {
+    return {
+        id: msg.id,
+        subject: msg.subject ?? null,
+        from: msg.from?.emailAddress?.address ?? null,
+        receivedDateTime: msg.receivedDateTime,
+        bodyPreview: (msg.bodyPreview ?? "").slice(0, 1024),
+        isRead: msg.isRead ?? false,
+    };
+}
+function clampTop(input, fallback) {
+    if (typeof input !== "number" || !Number.isFinite(input))
+        return fallback;
+    if (input < 1)
+        return 1;
+    if (input > 250)
+        return 250;
+    return Math.floor(input);
+}
+//# sourceMappingURL=mail-list.js.map

package/payload/platform/plugins/outlook/mcp/dist/tools/mail-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-list.js","sourceRoot":"","sources":["../../src/tools/mail-list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AA6BpC,MAAM,MAAM,GAAG,qDAAqD,CAAC;AAErE,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAyB,EACzB,IAAkB;IAElB,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,MAAM,MAAM,GAAG,MAAM,SAAS,CAC5B,MAAM,EACN,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,IAAI,GACR,MAAM,CAAC,WAAW,EAAE,KAAK,OAAO,IAAI,MAAM,KAAK,EAAE;YAC/C,CAAC,CAAC,gCAAgC;YAClC,CAAC,CAAC,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC;QAC/D,OAAO,CAAC,MAAM,MAAM;aACjB,GAAG,CAAC,IAAI,CAAC;aACT,GAAG,CAAC,GAAG,CAAC;aACR,OAAO,CAAC,uBAAuB,CAAC;aAChC,MAAM,CAAC,MAAM,CAAC;aACd,GAAG,EAAE,CAA8B,CAAC;IACzC,CAAC,EACD,EAAE,IAAI,EAAE,WAAW,EAAE,CACtB,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7C,GAAG,CAAC;QACF,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,MAAM,CAAC,SAAS;QACzB,MAAM;QACN,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;KAChC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,GAAe;IACnC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;QAC5B,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,IAAI,IAAI;QAC7C,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;QACtC,WAAW,EAAE,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;QACnD,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,KAAK;KAC5B,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAyB,EAAE,QAAgB;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1E,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACxB,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,GAAG,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/payload/platform/plugins/outlook/mcp/dist/tools/mail-search.d.ts

@@ -0,0 +1,8 @@
+import type { GraphClientConfig } from "../lib/graph-client.js";
+import type { MailListItem } from "./mail-list.js";
+export interface MailSearchArgs {
+    query: string;
+    top?: number;
+}
+export declare function runMailSearch(config: GraphClientConfig, args: MailSearchArgs): Promise<MailListItem[]>;
+//# sourceMappingURL=mail-search.d.ts.map

package/payload/platform/plugins/outlook/mcp/dist/tools/mail-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-search.d.ts","sourceRoot":"","sources":["../../src/tools/mail-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAiBD,wBAAsB,aAAa,CACjC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC,CA0CzB"}

package/payload/platform/plugins/outlook/mcp/dist/tools/mail-search.js

@@ -0,0 +1,49 @@
+import { callGraph } from "../lib/graph-client.js";
+import { log, trunc } from "../lib/log.js";
+const FIELDS = "id,subject,from,receivedDateTime,bodyPreview,isRead";
+export async function runMailSearch(config, args) {
+    const top = clampTop(args.top, 25);
+    const query = args.query.trim();
+    if (!query) {
+        throw new Error("mail-search: query is required and must be non-empty.");
+    }
+    const startMs = Date.now();
+    const result = await callGraph(config, async (client) => {
+        // Graph requires the $search value to be enclosed in quotes.
+        return (await client
+            .api("/me/messages")
+            .search(`"${query.replace(/"/g, '\\"')}"`)
+            .top(top)
+            .select(FIELDS)
+            // ConsistencyLevel header is required for $search. Older SDK shapes
+            // accept .header; newer shapes expose it via .request().
+            .header("ConsistencyLevel", "eventual")
+            .get());
+    }, { tool: "mail-search" });
+    const items = result.value.map((msg) => ({
+        id: msg.id,
+        subject: msg.subject ?? null,
+        from: msg.from?.emailAddress?.address ?? null,
+        receivedDateTime: msg.receivedDateTime,
+        bodyPreview: (msg.bodyPreview ?? "").slice(0, 1024),
+        isRead: msg.isRead ?? false,
+    }));
+    log({
+        event: "mail-search",
+        account: config.accountId,
+        query: trunc(query, 32),
+        count: items.length,
+        elapsedMs: Date.now() - startMs,
+    });
+    return items;
+}
+function clampTop(input, fallback) {
+    if (typeof input !== "number" || !Number.isFinite(input))
+        return fallback;
+    if (input < 1)
+        return 1;
+    if (input > 250)
+        return 250;
+    return Math.floor(input);
+}
+//# sourceMappingURL=mail-search.js.map

package/payload/platform/plugins/outlook/mcp/dist/tools/mail-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-search.js","sourceRoot":"","sources":["../../src/tools/mail-search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAqB3C,MAAM,MAAM,GAAG,qDAAqD,CAAC;AAErE,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAyB,EACzB,IAAoB;IAEpB,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,MAAM,MAAM,GAAG,MAAM,SAAS,CAC5B,MAAM,EACN,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,6DAA6D;QAC7D,OAAO,CAAC,MAAM,MAAM;aACjB,GAAG,CAAC,cAAc,CAAC;aACnB,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;aACzC,GAAG,CAAC,GAAG,CAAC;aACR,MAAM,CAAC,MAAM,CAAC;YACf,oEAAoE;YACpE,yDAAyD;aACxD,MAAM,CAAC,kBAAkB,EAAE,UAAU,CAAC;aACtC,GAAG,EAAE,CAA8B,CAAC;IACzC,CAAC,EACD,EAAE,IAAI,EAAE,aAAa,EAAE,CACxB,CAAC;IAEF,MAAM,KAAK,GAAmB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACvD,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;QAC5B,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,IAAI,IAAI;QAC7C,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;QACtC,WAAW,EAAE,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;QACnD,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,KAAK;KAC5B,CAAC,CAAC,CAAC;IAEJ,GAAG,CAAC;QACF,KAAK,EAAE,aAAa;QACpB,OAAO,EAAE,MAAM,CAAC,SAAS;QACzB,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QACvB,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;KAChC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,KAAyB,EAAE,QAAgB;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1E,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACxB,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,GAAG,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/payload/platform/plugins/outlook/mcp/dist/tools/mailbox-info.d.ts

@@ -0,0 +1,19 @@
+import type { GraphClientConfig } from "../lib/graph-client.js";
+export interface MailboxInfoArgs {
+}
+export interface MailboxInfo {
+    registered: boolean;
+    graphUserId: string | null;
+    scopes: string[];
+    tokenExpSec: number | null;
+    refreshTokenExpSec: number | null;
+    tokenWithinRefreshWindow: boolean;
+    folderCount: number | null;
+}
+/**
+ * Health probe: answers "did account X auth?" + "is the token in the
+ * refresh window?" without grepping logs. If the account isn't registered,
+ * returns `registered: false` rather than throwing.
+ */
+export declare function runMailboxInfo(config: GraphClientConfig): Promise<MailboxInfo>;
+//# sourceMappingURL=mailbox-info.d.ts.map

package/payload/platform/plugins/outlook/mcp/dist/tools/mailbox-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-info.d.ts","sourceRoot":"","sources":["../../src/tools/mailbox-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAIhE,MAAM,WAAW,eAAe;CAE/B;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,wBAAwB,EAAE,OAAO,CAAC;IAClC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAWD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAwDpF"}

package/payload/platform/plugins/outlook/mcp/dist/tools/mailbox-info.js

@@ -0,0 +1,58 @@
+import { callGraph } from "../lib/graph-client.js";
+import { log } from "../lib/log.js";
+/**
+ * Health probe: answers "did account X auth?" + "is the token in the
+ * refresh window?" without grepping logs. If the account isn't registered,
+ * returns `registered: false` rather than throwing.
+ */
+export async function runMailboxInfo(config) {
+    const blob = config.tokenStore.read();
+    const startMs = Date.now();
+    if (!blob) {
+        log({
+            event: "mailbox-info",
+            account: config.accountId,
+            tokenWithinRefreshWindow: false,
+            folderCount: 0,
+        });
+        return {
+            registered: false,
+            graphUserId: null,
+            scopes: [],
+            tokenExpSec: null,
+            refreshTokenExpSec: null,
+            tokenWithinRefreshWindow: false,
+            folderCount: null,
+        };
+    }
+    let folderCount = null;
+    try {
+        const result = await callGraph(config, async (client) => {
+            return (await client.api("/me/mailFolders").top(50).select("id").get());
+        }, { tool: "mailbox-info" });
+        folderCount = result.value.length;
+    }
+    catch {
+        // Don't throw — operator should still see the auth state even if Graph
+        // is unreachable. folderCount stays null.
+        folderCount = null;
+    }
+    const tokenWithinRefreshWindow = config.tokenStore.needsRefresh();
+    log({
+        event: "mailbox-info",
+        account: config.accountId,
+        tokenWithinRefreshWindow,
+        folderCount: folderCount ?? -1,
+        elapsedMs: Date.now() - startMs,
+    });
+    return {
+        registered: true,
+        graphUserId: blob.graphUserId,
+        scopes: blob.scopes,
+        tokenExpSec: Math.floor(blob.accessTokenExpiry / 1000),
+        refreshTokenExpSec: Math.floor(blob.refreshTokenExpiry / 1000),
+        tokenWithinRefreshWindow,
+        folderCount,
+    };
+}
+//# sourceMappingURL=mailbox-info.js.map

package/payload/platform/plugins/outlook/mcp/dist/tools/mailbox-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-info.js","sourceRoot":"","sources":["../../src/tools/mailbox-info.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAyBpC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAyB;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,GAAG,CAAC;YACF,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,MAAM,CAAC,SAAS;YACzB,wBAAwB,EAAE,KAAK;YAC/B,WAAW,EAAE,CAAC;SACf,CAAC,CAAC;QACH,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,EAAE;YACV,WAAW,EAAE,IAAI;YACjB,kBAAkB,EAAE,IAAI;YACxB,wBAAwB,EAAE,KAAK;YAC/B,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,GAAkB,IAAI,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAC5B,MAAM,EACN,KAAK,EAAE,MAAM,EAAE,EAAE;YACf,OAAO,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAiC,CAAC;QAC1G,CAAC,EACD,EAAE,IAAI,EAAE,cAAc,EAAE,CACzB,CAAC;QACF,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,0CAA0C;QAC1C,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,MAAM,wBAAwB,GAAG,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;IAClE,GAAG,CAAC;QACF,KAAK,EAAE,cAAc;QACrB,OAAO,EAAE,MAAM,CAAC,SAAS;QACzB,wBAAwB;QACxB,WAAW,EAAE,WAAW,IAAI,CAAC,CAAC;QAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;KAChC,CAAC,CAAC;IAEH,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QACtD,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAC9D,wBAAwB;QACxB,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/outlook/mcp/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@maxy/outlook",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@microsoft/microsoft-graph-client": "^3.0.7",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}

package/payload/platform/plugins/outlook/mcp/scripts/verify-doc-impl.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+# verify-doc-impl.sh
+#
+# Doc-impl alignment grep, promoted from Task 811's manual verification step
+# to a permanent gate. Run from anywhere; resolves to the plugin tree itself.
+#
+# Verifies:
+#   1. Every `outlook-*` tool name in `platform/plugins/docs/references/outlook-guide.md`
+#      resolves to a `server.tool("outlook-...", ...)` registration in mcp/src/index.ts.
+#   2. Every `[outlook-mcp]` log-line shape in outlook-guide.md matches a
+#      log({event:"..."}) literal in mcp/src/.
+#   3. Every tool name in `PLUGIN.md` frontmatter matches a registration in mcp/src/index.ts.
+#   4. Public-agent isolation: `outlook` does not appear in public-agent assembly files.
+#   5. Bearer-token redaction: log.ts contains the redaction regex pair.
+#
+# Exit non-zero on any mismatch. Print the first diverging item.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+REPO_ROOT="$(cd "$PLUGIN_DIR/../../../.." && pwd)"
+GUIDE="$REPO_ROOT/platform/plugins/docs/references/outlook-guide.md"
+PLUGIN_MD="$REPO_ROOT/platform/plugins/outlook/PLUGIN.md"
+INDEX_TS="$PLUGIN_DIR/src/index.ts"
+SRC_DIR="$PLUGIN_DIR/src"
+
+fail() {
+  echo "[verify-doc-impl] FAIL: $1" >&2
+  exit 1
+}
+
+[ -f "$GUIDE" ] || fail "operator guide missing: $GUIDE"
+[ -f "$PLUGIN_MD" ] || fail "PLUGIN.md missing: $PLUGIN_MD"
+[ -f "$INDEX_TS" ] || fail "index.ts missing: $INDEX_TS"
+
+# Tool names registered in src/index.ts. The MCP-SDK call shape is:
+#   server.tool(
+#     "outlook-XYZ",
+#     ...
+# so the tool name appears on its own line as `  "outlook-XYZ",`.
+TOOLS_REGISTERED=$(grep -oE '"outlook-[a-z\-]+",' "$INDEX_TS" \
+  | sed -E 's/^"|",$//g' | sort -u)
+
+# Tool names referenced in outlook-guide.md (backtick-wrapped)
+TOOLS_IN_GUIDE=$(grep -oE '`outlook-[a-z\-]+`' "$GUIDE" | tr -d '`' | sort -u)
+
+# Tool names in PLUGIN.md frontmatter (lines starting with "  - outlook-")
+TOOLS_IN_PLUGIN_MD=$(grep -E '^\s+- outlook-' "$PLUGIN_MD" | sed -E 's/^[[:space:]]*-[[:space:]]+//' | sort -u)
+
+# Set 1: every tool in guide must be registered
+while IFS= read -r tool; do
+  [ -z "$tool" ] && continue
+  if ! echo "$TOOLS_REGISTERED" | grep -qx "$tool"; then
+    fail "tool '$tool' referenced in outlook-guide.md but not registered in mcp/src/index.ts"
+  fi
+done <<< "$TOOLS_IN_GUIDE"
+
+# Set 2: every tool in PLUGIN.md frontmatter must be registered
+while IFS= read -r tool; do
+  [ -z "$tool" ] && continue
+  if ! echo "$TOOLS_REGISTERED" | grep -qx "$tool"; then
+    fail "tool '$tool' declared in PLUGIN.md frontmatter but not registered in mcp/src/index.ts"
+  fi
+done <<< "$TOOLS_IN_PLUGIN_MD"
+
+# Set 3: every registered tool must appear in PLUGIN.md frontmatter
+while IFS= read -r tool; do
+  [ -z "$tool" ] && continue
+  if ! echo "$TOOLS_IN_PLUGIN_MD" | grep -qx "$tool"; then
+    fail "tool '$tool' registered in mcp/src/index.ts but missing from PLUGIN.md frontmatter"
+  fi
+done <<< "$TOOLS_REGISTERED"
+
+# Log-shape alignment: every event tag in outlook-guide.md must have a matching
+# log({ event: "..." }) literal in mcp/src/. Event tags appear in the table as:
+#   | Auth init | `auth-init account=<id> codeChallenge=...` |
+# We pull the first word inside backticks on each table row that contains "account=".
+EVENTS_IN_GUIDE=$(grep -E '`[a-z\-]+ account=' "$GUIDE" \
+  | sed -E 's/.*`([a-z\-]+) account=.*/\1/' | sort -u)
+EVENTS_IN_SRC=$(grep -rh -oE 'event:[[:space:]]*"[a-z\-]+"' "$SRC_DIR" \
+  | sed -E 's/^event:[[:space:]]*"|"$//g' | sort -u)
+
+while IFS= read -r ev; do
+  [ -z "$ev" ] && continue
+  if ! echo "$EVENTS_IN_SRC" | grep -qx "$ev"; then
+    fail "log event '$ev' documented in outlook-guide.md but no log({event:\"$ev\"}) literal in mcp/src/"
+  fi
+done <<< "$EVENTS_IN_GUIDE"
+
+# Public-agent isolation: outlook must not appear in public-agent assembly files.
+ISOLATION_HITS=$( (cd "$REPO_ROOT" && grep -rE 'outlook' \
+  platform/ui/app/lib/claude-agent/public-agent.ts \
+  platform/ui/app/lib/claude-agent/system-prompt-assembly.ts \
+  platform/templates/agents/public/ 2>/dev/null) || true)
+if [ -n "$ISOLATION_HITS" ]; then
+  echo "$ISOLATION_HITS" >&2
+  fail "isolation breach: 'outlook' string appears in public-agent assembly path"
+fi
+
+# Bearer redaction guard: lib/log.ts must contain both regex literals.
+if ! grep -q 'Bearer\\s+\[A-Za-z0-9' "$SRC_DIR/lib/log.ts"; then
+  fail "Bearer redaction regex missing in lib/log.ts"
+fi
+if ! grep -q 'access_token=\[A-Za-z0-9' "$SRC_DIR/lib/log.ts"; then
+  fail "access_token redaction regex missing in lib/log.ts"
+fi
+
+echo "[verify-doc-impl] OK — $(echo "$TOOLS_REGISTERED" | wc -l | tr -d ' ') tools, $(echo "$EVENTS_IN_GUIDE" | wc -l | tr -d ' ') events, isolation, redaction all aligned"