@elizaos/agent 2.0.0-alpha.173 → 2.0.0-alpha.192

package/apps/app-lifeops/src/lifeops/discord-browser-scraper.js

@@ -0,0 +1,488 @@
+import { closeBrowserWorkspaceTab, evaluateBrowserWorkspaceTab, isBrowserWorkspaceBridgeConfigured, listBrowserWorkspaceTabs, navigateBrowserWorkspaceTab, openBrowserWorkspaceTab, showBrowserWorkspaceTab, } from "@elizaos/agent/services/browser-workspace";
+export const DISCORD_APP_URL = "https://discord.com/channels/@me";
+const DISCORD_APP_TITLE = "Discord";
+const DISCORD_DM_PREVIEW_LIMIT = 5;
+function normalizeDiscordText(value) {
+    if (typeof value !== "string")
+        return null;
+    const normalized = value.replace(/\s+/g, " ").trim();
+    return normalized.length > 0 ? normalized : null;
+}
+function isDiscordUrl(value) {
+    if (!value)
+        return false;
+    try {
+        const url = new URL(value, "https://discord.com");
+        return /(^|\.)discord\.com$/i.test(url.hostname);
+    }
+    catch {
+        return false;
+    }
+}
+function selectedDiscordDmChannelId(value) {
+    const normalized = normalizeDiscordText(value);
+    if (!normalized)
+        return null;
+    const match = normalized.match(/\/channels\/@me\/([^/?#]+)/);
+    return match?.[1] ?? null;
+}
+function isDiscordLoginPage(args) {
+    const url = normalizeDiscordText(args.url);
+    const title = normalizeDiscordText(args.title);
+    const mainText = normalizeDiscordText(args.mainText);
+    const formFields = (args.formFields ?? [])
+        .map((field) => normalizeDiscordText(field))
+        .filter((field) => field !== null)
+        .join(" ");
+    if (url?.includes("/login") || url?.includes("/register")) {
+        return true;
+    }
+    const combined = [title, mainText, formFields]
+        .filter((value) => value !== null)
+        .join(" ");
+    return /\b(log ?in|sign ?in|register)\b/i.test(combined) &&
+        /\bdiscord\b/i.test(combined)
+        ? true
+        : /\b(email|password)\b/i.test(formFields);
+}
+function discordAnchorTextParts(anchor) {
+    const values = new Set();
+    const push = (value) => {
+        if (!value)
+            return;
+        if (/^\d+$/.test(value))
+            return;
+        values.add(value);
+    };
+    for (const node of anchor.querySelectorAll("span, div")) {
+        push(normalizeDiscordText(node.textContent));
+    }
+    push(normalizeDiscordText(anchor.getAttribute("aria-label")));
+    if (values.size === 0) {
+        push(normalizeDiscordText(anchor.textContent));
+    }
+    return [...values];
+}
+function discordAnchorLabel(anchor) {
+    const ariaLabel = normalizeDiscordText(anchor.getAttribute("aria-label"));
+    if (ariaLabel) {
+        return ariaLabel
+            .split(",")
+            .map((part) => normalizeDiscordText(part))
+            .find((part) => part !== null && !/\bunread\b/i.test(part)) ?? ariaLabel;
+    }
+    const parts = discordAnchorTextParts(anchor);
+    return (parts.find((part) => !/\bunread\b/i.test(part) &&
+        !/^(active now|voice connected|mutual friends?)$/i.test(part)) ?? null);
+}
+function discordAnchorSnippet(anchor, label) {
+    const parts = discordAnchorTextParts(anchor);
+    return (parts.find((part) => part !== label &&
+        !/\bunread\b/i.test(part) &&
+        !/^(active now|voice connected|mutual friends?)$/i.test(part)) ?? null);
+}
+function extractDiscordDmPreviews(document, selectedChannelId) {
+    const previews = [];
+    const seen = new Set();
+    for (const anchor of document.querySelectorAll('a[href^="/channels/@me/"]')) {
+        const href = normalizeDiscordText(anchor.getAttribute("href"));
+        if (!href || href === "/channels/@me")
+            continue;
+        const channelId = selectedDiscordDmChannelId(href);
+        const dedupeKey = channelId ?? href;
+        if (seen.has(dedupeKey))
+            continue;
+        seen.add(dedupeKey);
+        const label = discordAnchorLabel(anchor) ?? channelId ?? "Direct message";
+        const unreadSignal = [
+            normalizeDiscordText(anchor.getAttribute("aria-label")),
+            normalizeDiscordText(anchor.textContent),
+        ]
+            .filter((value) => value !== null)
+            .join(" ");
+        previews.push({
+            channelId,
+            href,
+            label,
+            selected: (channelId !== null && channelId === selectedChannelId) ||
+                anchor.getAttribute("aria-current") === "page" ||
+                anchor.getAttribute("aria-selected") === "true",
+            unread: /\bunread\b|\bnew messages?\b/i.test(unreadSignal) ||
+                Boolean(anchor.querySelector('[aria-label*="unread" i], [class*="unread"]')),
+            snippet: discordAnchorSnippet(anchor, label),
+        });
+    }
+    return previews;
+}
+export function emptyDiscordDmInboxProbe() {
+    return {
+        visible: false,
+        count: 0,
+        selectedChannelId: null,
+        previews: [],
+    };
+}
+function emptyDiscordTabProbe(url = null) {
+    return {
+        loggedIn: false,
+        url,
+        identity: {
+            id: null,
+            username: null,
+            discriminator: null,
+        },
+        rawSnippet: null,
+        dmInbox: emptyDiscordDmInboxProbe(),
+    };
+}
+export function probeDiscordCapturedPage(page) {
+    const safeUrl = normalizeDiscordText(page.url);
+    if (!safeUrl || !isDiscordUrl(safeUrl)) {
+        return emptyDiscordTabProbe(safeUrl ?? null);
+    }
+    const formFields = (page.forms ?? []).flatMap((form) => form.fields ?? []);
+    if (isDiscordLoginPage({
+        url: safeUrl,
+        title: page.title ?? null,
+        mainText: page.mainText ?? null,
+        formFields,
+    })) {
+        return {
+            ...emptyDiscordTabProbe(safeUrl),
+            rawSnippet: normalizeDiscordText(page.mainText ?? null)?.slice(0, 160) ?? null,
+        };
+    }
+    const selectedChannelId = selectedDiscordDmChannelId(safeUrl);
+    const previews = [];
+    const seen = new Set();
+    for (const candidate of page.links ?? []) {
+        if (!isDiscordUrl(candidate.href))
+            continue;
+        const href = normalizeDiscordText(candidate.href);
+        if (!href || !href.includes("/channels/@me/"))
+            continue;
+        const channelId = selectedDiscordDmChannelId(href);
+        const dedupeKey = channelId ?? href;
+        if (seen.has(dedupeKey))
+            continue;
+        seen.add(dedupeKey);
+        previews.push({
+            channelId,
+            href,
+            label: normalizeDiscordText(candidate.text) ?? channelId ?? "Direct message",
+            selected: channelId !== null && channelId === selectedChannelId,
+            unread: false,
+            snippet: null,
+        });
+    }
+    return {
+        loggedIn: true,
+        url: safeUrl,
+        identity: {
+            id: null,
+            username: null,
+            discriminator: null,
+        },
+        rawSnippet: normalizeDiscordText(page.mainText ?? null)?.slice(0, 160) ?? null,
+        dmInbox: {
+            visible: previews.length > 0 || safeUrl.includes("/channels/@me"),
+            count: previews.length,
+            selectedChannelId,
+            previews: previews.slice(0, DISCORD_DM_PREVIEW_LIMIT),
+        },
+    };
+}
+export function probeDiscordDocumentState(document, url) {
+    try {
+        const safeUrl = normalizeDiscordText(url);
+        const atLogin = (safeUrl?.includes("/login") ?? false) ||
+            (safeUrl?.includes("/register") ?? false) ||
+            !!document.querySelector('input[name="email"], input[type="email"]');
+        if (atLogin) {
+            return emptyDiscordTabProbe(safeUrl ?? null);
+        }
+        const guildsNav = document.querySelector('[data-list-id="guildsnav"]');
+        const sidebar = guildsNav ||
+            document.querySelector('nav[aria-label*="Servers" i]') ||
+            document.querySelector('[class*="guilds-"]') ||
+            document.querySelector('a[href^="/channels/@me/"]');
+        if (!sidebar) {
+            return emptyDiscordTabProbe(safeUrl ?? null);
+        }
+        const panel = document.querySelector('section[aria-label*="User area" i]') ||
+            document.querySelector('[class*="panelTitleContainer"]') ||
+            document.querySelector('[class*="nameTag"]')?.parentElement ||
+            null;
+        const nameEl = panel?.querySelector('[class*="nameTag"] [class*="name-"]') ||
+            panel?.querySelector('[class*="name-"]') ||
+            document.querySelector('[class*="nameTag"] [class*="name-"]') ||
+            document.querySelector('[class*="nameTag"]');
+        const tagEl = panel?.querySelector('[class*="nameTag"] [class*="discrim"]') ||
+            document.querySelector('[class*="nameTag"] [class*="discrim"]');
+        const username = normalizeDiscordText(nameEl?.textContent ?? null);
+        const discriminator = normalizeDiscordText(tagEl?.textContent ?? null)?.replace(/^#/, "") ?? null;
+        const snippet = normalizeDiscordText(panel?.textContent ?? null)?.slice(0, 160) ?? null;
+        const selectedChannelId = selectedDiscordDmChannelId(safeUrl ?? null);
+        const previews = extractDiscordDmPreviews(document, selectedChannelId);
+        return {
+            loggedIn: true,
+            url: safeUrl ?? null,
+            identity: {
+                id: null,
+                username,
+                discriminator,
+            },
+            rawSnippet: snippet,
+            dmInbox: {
+                visible: previews.length > 0 || selectedChannelId !== null,
+                count: previews.length,
+                selectedChannelId,
+                previews: previews.slice(0, DISCORD_DM_PREVIEW_LIMIT),
+            },
+        };
+    }
+    catch (error) {
+        return {
+            ...emptyDiscordTabProbe(null),
+            rawSnippet: String(error),
+        };
+    }
+}
+function buildDiscordProbeScript() {
+    return `(() => {
+    const DISCORD_DM_PREVIEW_LIMIT = ${DISCORD_DM_PREVIEW_LIMIT};
+    const normalizeDiscordText = ${normalizeDiscordText.toString()};
+    const selectedDiscordDmChannelId = ${selectedDiscordDmChannelId.toString()};
+    const discordAnchorTextParts = ${discordAnchorTextParts.toString()};
+    const discordAnchorLabel = ${discordAnchorLabel.toString()};
+    const discordAnchorSnippet = ${discordAnchorSnippet.toString()};
+    const extractDiscordDmPreviews = ${extractDiscordDmPreviews.toString()};
+    const emptyDiscordDmInboxProbe = ${emptyDiscordDmInboxProbe.toString()};
+    const emptyDiscordTabProbe = ${emptyDiscordTabProbe.toString()};
+    const probeDiscordDocumentState = ${probeDiscordDocumentState.toString()};
+    return probeDiscordDocumentState(document, window.location.href || null);
+  })();`;
+}
+export function discordBrowserWorkspaceAvailable(env = process.env) {
+    return isBrowserWorkspaceBridgeConfigured(env);
+}
+export function discordPartitionFor(agentId, side) {
+    return `lifeops-discord-${agentId}-${side}`;
+}
+async function findTabByIdOrPartition(tabId, partition, env) {
+    const tabs = await listBrowserWorkspaceTabs(env);
+    if (tabId) {
+        const hit = tabs.find((tab) => tab.id === tabId);
+        if (hit)
+            return { id: hit.id, url: hit.url };
+    }
+    const byPartition = tabs.find((tab) => tab.partition === partition &&
+        typeof tab.url === "string" &&
+        tab.url.includes("discord.com"));
+    if (byPartition)
+        return { id: byPartition.id, url: byPartition.url };
+    return null;
+}
+export async function ensureDiscordTab(args) {
+    const env = args.env ?? process.env;
+    if (!discordBrowserWorkspaceAvailable(env)) {
+        throw new Error("Discord connector requires the Milady desktop app's browser workspace.");
+    }
+    const partition = discordPartitionFor(args.agentId, args.side);
+    const existing = await findTabByIdOrPartition(args.existingTabId ?? null, partition, env);
+    if (existing) {
+        if (args.show) {
+            await showBrowserWorkspaceTab(existing.id, env);
+        }
+        return { tabId: existing.id, url: existing.url };
+    }
+    const tab = await openBrowserWorkspaceTab({
+        url: DISCORD_APP_URL,
+        partition,
+        title: DISCORD_APP_TITLE,
+        show: args.show ?? true,
+    }, env);
+    return { tabId: tab.id, url: tab.url };
+}
+export async function navigateDiscordTabToHome(tabId, env = process.env) {
+    await navigateBrowserWorkspaceTab({ id: tabId, url: DISCORD_APP_URL }, env);
+}
+export async function closeDiscordTab(tabId, env = process.env) {
+    await closeBrowserWorkspaceTab(tabId, env);
+}
+/**
+ * Evaluate a probe inside the Discord tab to determine login state and
+ * extract the current user. Returns `loggedIn: false` when the tab is on
+ * the login screen, when the tab has not finished loading the app shell,
+ * or when the selectors fail — never throws.
+ */
+export async function probeDiscordTab(tabId, env = process.env) {
+    const result = (await evaluateBrowserWorkspaceTab({ id: tabId, script: buildDiscordProbeScript() }, env));
+    if (!result || typeof result !== "object") {
+        return emptyDiscordTabProbe(null);
+    }
+    return {
+        ...emptyDiscordTabProbe(null),
+        ...result,
+        identity: {
+            ...emptyDiscordTabProbe(null).identity,
+            ...(result.identity ?? {}),
+        },
+        dmInbox: result.dmInbox ?? emptyDiscordDmInboxProbe(),
+    };
+}
+/**
+ * DOM script injected into the Discord tab to read search results from the
+ * "Search Results" panel after Discord's own Ctrl+F / search UX has rendered.
+ *
+ * Discord renders search results inside `[class*="searchResultMessage"]` or
+ * the newer `[data-testid*="message-item"]` containers. We read what the DOM
+ * exposes — no regex on content, no heuristics.
+ */
+function buildDiscordSearchResultsScript() {
+    return `(() => {
+    const results = [];
+    const containers = Array.from(
+      document.querySelectorAll(
+        '[class*="searchResultMessage"], [class*="search-result-message"]'
+      )
+    );
+    for (const container of containers) {
+      const contentEl =
+        container.querySelector('[id^="message-content-"]') ||
+        container.querySelector('[class*="messageContent"]');
+      const content = contentEl ? (contentEl.textContent || "").trim() : "";
+
+      const authorEl =
+        container.querySelector('[class*="username-"]') ||
+        container.querySelector('[class*="author-"]');
+      const authorName = authorEl ? (authorEl.textContent || "").trim() : null;
+
+      const msgEl = container.closest('[data-list-item-id]') ||
+        container.querySelector('[id^="chat-messages-"]');
+      const rawId = msgEl
+        ? (msgEl.getAttribute('data-list-item-id') || msgEl.id || "")
+        : "";
+      const idMatch = rawId.match(/\\d{17,19}/);
+      const id = idMatch ? idMatch[0] : null;
+
+      const timestampEl = container.querySelector('time[datetime]');
+      const timestamp = timestampEl
+        ? timestampEl.getAttribute('datetime')
+        : null;
+
+      const href = window.location.href;
+      const channelMatch = href.match(/\\/channels\\/@me\\/([\\d]+)/);
+      const channelId = channelMatch ? channelMatch[1] : null;
+
+      results.push({ id, content, authorName, channelId, timestamp, deliveryStatus: "unknown" });
+    }
+    return results;
+  })();`;
+}
+/**
+ * Trigger Discord's native in-app search using the keyboard shortcut, wait
+ * for results to render, then scrape them via DOM eval.
+ *
+ * The search uses Discord's own full-text index — no client-side filtering.
+ * Results are scoped to the currently open DM or channel when a `channelId`
+ * scope is provided (by navigating to that channel first), or global when
+ * no scope is given.
+ *
+ * Because this relies on the browser workspace eval bridge, it requires a
+ * live Discord tab (`tabId`).
+ */
+export async function searchDiscordMessages(args) {
+    const env = args.env ?? process.env;
+    const query = args.query.trim();
+    if (query.length === 0) {
+        throw new Error("Discord search query must not be empty.");
+    }
+    if (args.channelId) {
+        const channelUrl = `https://discord.com/channels/@me/${args.channelId}`;
+        await navigateBrowserWorkspaceTab({ id: args.tabId, url: channelUrl }, env);
+        // Allow the navigation to settle before searching.
+        await new Promise((resolve) => setTimeout(resolve, 800));
+    }
+    // Build a script that uses the Discord search bar (Ctrl+K / Ctrl+F) via
+    // the internal store — the Discord web app exposes a Flux-like dispatcher
+    // that can be reached via `webpackChunkdiscord_app`.
+    const searchScript = `(() => {
+    const query = ${JSON.stringify(query)};
+    try {
+      // Walk webpack chunk to find the search action dispatcher.
+      const chunks = window.webpackChunkdiscord_app;
+      if (!chunks) return { injected: false };
+      let SearchActions;
+      for (const [, factories] of chunks) {
+        for (const factory of Object.values(factories)) {
+          try {
+            const mod = {};
+            factory({}, mod, { c: {}, d: (m, e) => { Object.assign(m, e); }, n: (m) => () => m });
+            if (mod.searchMessages) { SearchActions = mod; break; }
+          } catch { /* non-factory */ }
+        }
+        if (SearchActions) break;
+      }
+      if (!SearchActions?.searchMessages) return { injected: false };
+      SearchActions.searchMessages({ query });
+      return { injected: true };
+    } catch(e) {
+      return { injected: false, error: String(e) };
+    }
+  })();`;
+    await evaluateBrowserWorkspaceTab({ id: args.tabId, script: searchScript }, env);
+    // Wait for Discord's search results panel to render.
+    await new Promise((resolve) => setTimeout(resolve, 1200));
+    const raw = (await evaluateBrowserWorkspaceTab({ id: args.tabId, script: buildDiscordSearchResultsScript() }, env));
+    if (!Array.isArray(raw))
+        return [];
+    return raw.filter((item) => typeof item === "object" && item !== null);
+}
+// ---------------------------------------------------------------------------
+// Delivery status capture via DOM eval
+// ---------------------------------------------------------------------------
+/**
+ * Read the delivery status of recently sent messages visible in the currently
+ * open Discord channel. Discord renders delivery indicators in the DOM:
+ * - No indicator: delivered (server acknowledged).
+ * - `[class*="sending"]`: sending in progress.
+ * - `[class*="failed"]` / `[aria-label*="failed" i]`: send failed.
+ *
+ * This is inherently partial — only messages currently rendered in the
+ * viewport can be inspected.
+ */
+export async function captureDiscordDeliveryStatus(args) {
+    const env = args.env ?? process.env;
+    const script = `(() => {
+    const results = [];
+    const messages = Array.from(
+      document.querySelectorAll('[class*="message-"] [id^="message-content-"], [id^="chat-messages-"] li')
+    );
+    for (const el of messages) {
+      const contentEl = el.querySelector
+        ? el.querySelector('[id^="message-content-"]') || el
+        : el;
+      const content = (contentEl.textContent || "").trim();
+
+      const rawId = (el.getAttribute('data-list-item-id') || el.id || "");
+      const idMatch = rawId.match(/\\d{17,19}/);
+      const id = idMatch ? idMatch[0] : null;
+
+      const timestampEl = el.querySelector('time[datetime]');
+      const timestamp = timestampEl ? timestampEl.getAttribute('datetime') : null;
+
+      const isSending = !!el.querySelector('[class*="sending"]');
+      const isFailed = !!el.querySelector('[class*="failed"]') ||
+        !!el.querySelector('[aria-label*="failed" i]');
+      const deliveryStatus = isFailed ? 'failed' : isSending ? 'sending' : 'sent';
+
+      results.push({ id, content, authorName: null, channelId: null, timestamp, deliveryStatus });
+    }
+    return results;
+  })();`;
+    const raw = (await evaluateBrowserWorkspaceTab({ id: args.tabId, script }, env));
+    if (!Array.isArray(raw))
+        return [];
+    return raw.filter((item) => typeof item === "object" && item !== null);
+}

package/apps/app-lifeops/src/lifeops/enforcement-windows.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Enforcement windows for morning/night routines.
+ *
+ * A routine definition can opt into automatic enforcement during local
+ * time-of-day windows. When an occurrence remains pending/scheduled past
+ * its window start, the reminder pipeline escalates faster (and eventually
+ * to alarm-level channels like voice calls).
+ *
+ * Canonical source of truth for "are we currently in the morning/night
+ * enforcement window" — used by both the proactive worker (to decide
+ * whether to plan GM/GN nudges) and the reminder mixin (to apply
+ * escalation overrides).
+ */
+export type EnforcementWindowKind = "morning" | "night" | "none";
+export interface EnforcementWindow {
+    kind: EnforcementWindowKind;
+    /** Minute of day in local time, inclusive. 0..1439. */
+    startMinute: number;
+    /** Minute of day in local time, exclusive. 1..1440. */
+    endMinute: number;
+}
+export declare const DEFAULT_MORNING_WINDOW: EnforcementWindow;
+export declare const DEFAULT_NIGHT_WINDOW: EnforcementWindow;
+export declare function getCurrentEnforcementWindow(now: Date, timezone: string, windows?: EnforcementWindow[]): EnforcementWindow;
+export declare function isWithinEnforcementWindow(now: Date, timezone: string, window: EnforcementWindow): boolean;
+/**
+ * Minutes elapsed since the window's start, assuming `now` is inside the
+ * window. Returns 0 when outside the window (caller should guard).
+ *
+ * For wrapping windows (end < start), minutes are counted from the start
+ * across the day boundary.
+ */
+export declare function minutesPastWindowStart(now: Date, timezone: string, window: EnforcementWindow): number;
+//# sourceMappingURL=enforcement-windows.d.ts.map

package/apps/app-lifeops/src/lifeops/enforcement-windows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enforcement-windows.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/lifeops/enforcement-windows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,sBAAsB,EAAE,iBAIpC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,iBAIlC,CAAC;AAgDF,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,IAAI,EACT,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,iBAAiB,EAAE,GAC5B,iBAAiB,CAYnB;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,IAAI,EACT,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,IAAI,EACT,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,iBAAiB,GACxB,MAAM,CAYR"}

package/apps/app-lifeops/src/lifeops/enforcement-windows.js

@@ -0,0 +1,110 @@
+/**
+ * Enforcement windows for morning/night routines.
+ *
+ * A routine definition can opt into automatic enforcement during local
+ * time-of-day windows. When an occurrence remains pending/scheduled past
+ * its window start, the reminder pipeline escalates faster (and eventually
+ * to alarm-level channels like voice calls).
+ *
+ * Canonical source of truth for "are we currently in the morning/night
+ * enforcement window" — used by both the proactive worker (to decide
+ * whether to plan GM/GN nudges) and the reminder mixin (to apply
+ * escalation overrides).
+ */
+export const DEFAULT_MORNING_WINDOW = {
+    kind: "morning",
+    startMinute: 6 * 60,
+    endMinute: 10 * 60,
+};
+export const DEFAULT_NIGHT_WINDOW = {
+    kind: "night",
+    startMinute: 21 * 60,
+    endMinute: 24 * 60,
+};
+const NONE_WINDOW = {
+    kind: "none",
+    startMinute: 0,
+    endMinute: 0,
+};
+function safeGetLocalMinuteOfDay(now, timezone) {
+    let hour = 0;
+    let minute = 0;
+    try {
+        const fmt = new Intl.DateTimeFormat("en-US", {
+            timeZone: timezone,
+            hour12: false,
+            hour: "2-digit",
+            minute: "2-digit",
+        });
+        const parts = fmt.formatToParts(now);
+        for (const part of parts) {
+            if (part.type === "hour") {
+                const parsed = Number.parseInt(part.value, 10);
+                // Intl emits "24" for midnight under hour12:false in some runtimes.
+                hour = Number.isFinite(parsed) ? parsed % 24 : 0;
+            }
+            else if (part.type === "minute") {
+                const parsed = Number.parseInt(part.value, 10);
+                minute = Number.isFinite(parsed) ? parsed : 0;
+            }
+        }
+    }
+    catch {
+        // Invalid timezone — fall back to UTC.
+        hour = now.getUTCHours();
+        minute = now.getUTCMinutes();
+    }
+    return hour * 60 + minute;
+}
+function windowContains(window, minuteOfDay) {
+    if (window.kind === "none")
+        return false;
+    const { startMinute, endMinute } = window;
+    if (startMinute === endMinute)
+        return false;
+    // Wrapping window (e.g. 22:00 -> 02:00).
+    if (startMinute > endMinute) {
+        return minuteOfDay >= startMinute || minuteOfDay < endMinute;
+    }
+    return minuteOfDay >= startMinute && minuteOfDay < endMinute;
+}
+export function getCurrentEnforcementWindow(now, timezone, windows) {
+    const candidates = windows && windows.length > 0
+        ? windows
+        : [DEFAULT_MORNING_WINDOW, DEFAULT_NIGHT_WINDOW];
+    const minuteOfDay = safeGetLocalMinuteOfDay(now, timezone);
+    for (const window of candidates) {
+        if (windowContains(window, minuteOfDay)) {
+            return window;
+        }
+    }
+    return NONE_WINDOW;
+}
+export function isWithinEnforcementWindow(now, timezone, window) {
+    if (window.kind === "none")
+        return false;
+    const minuteOfDay = safeGetLocalMinuteOfDay(now, timezone);
+    return windowContains(window, minuteOfDay);
+}
+/**
+ * Minutes elapsed since the window's start, assuming `now` is inside the
+ * window. Returns 0 when outside the window (caller should guard).
+ *
+ * For wrapping windows (end < start), minutes are counted from the start
+ * across the day boundary.
+ */
+export function minutesPastWindowStart(now, timezone, window) {
+    if (window.kind === "none")
+        return 0;
+    if (!isWithinEnforcementWindow(now, timezone, window))
+        return 0;
+    const minuteOfDay = safeGetLocalMinuteOfDay(now, timezone);
+    if (window.startMinute > window.endMinute) {
+        // Wrapping window.
+        if (minuteOfDay >= window.startMinute) {
+            return minuteOfDay - window.startMinute;
+        }
+        return 1440 - window.startMinute + minuteOfDay;
+    }
+    return minuteOfDay - window.startMinute;
+}

package/apps/app-lifeops/src/lifeops/google-connector-gateway.d.ts

@@ -14,6 +14,19 @@ export declare function resolvePreferredGoogleGrant(args: {
     grants: readonly LifeOpsConnectorGrant[];
     requestedMode?: LifeOpsConnectorMode;
     requestedSide?: LifeOpsConnectorSide;
+    /** When set, resolve this specific grant by ID (multi-account). */
+    grantId?: string;
     defaultMode: LifeOpsConnectorMode;
 }): LifeOpsConnectorGrant | null;
+/**
+ * Resolve all Google grants matching the given filters, for multi-account aggregation.
+ * When `grantId` is set, returns at most one grant.
+ * When not set, returns all Google grants matching `side` (and optionally `mode`).
+ */
+export declare function resolveGoogleGrants(args: {
+    grants: readonly LifeOpsConnectorGrant[];
+    requestedMode?: LifeOpsConnectorMode;
+    requestedSide?: LifeOpsConnectorSide;
+    grantId?: string;
+}): LifeOpsConnectorGrant[];
 //# sourceMappingURL=google-connector-gateway.d.ts.map

package/apps/app-lifeops/src/lifeops/google-connector-gateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google-connector-gateway.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/lifeops/google-connector-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,+BAA+B,EAC/B,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,6BAA6B,EAC9B,MAAM,mCAAmC,CAAC;AAM3C,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,oBAAoB,CAAC;IAClC,cAAc,EAAE,oBAAoB,EAAE,CAAC;CACxC;AAQD,wBAAgB,4BAA4B,CAC1C,WAAW,EACP,IAAI,CAAC,qBAAqB,EAAE,iBAAiB,GAAG,MAAM,CAAC,GACvD,oBAAoB,GACvB,+BAA+B,CAWjC;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EACP,IAAI,CAAC,qBAAqB,EAAE,eAAe,GAAG,MAAM,CAAC,GACrD,oBAAoB,GACvB,6BAA6B,CAa/B;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,UAAU,EAAE,GAAG,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC3C,GAAG,sBAAsB,CAmBzB;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACzC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,WAAW,EAAE,oBAAoB,CAAC;CACnC,GAAG,qBAAqB,GAAG,IAAI,CAkC/B"}
+{"version":3,"file":"google-connector-gateway.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/lifeops/google-connector-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,+BAA+B,EAC/B,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,6BAA6B,EAC9B,MAAM,mCAAmC,CAAC;AAM3C,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,oBAAoB,CAAC;IAClC,cAAc,EAAE,oBAAoB,EAAE,CAAC;CACxC;AAQD,wBAAgB,4BAA4B,CAC1C,WAAW,EACP,IAAI,CAAC,qBAAqB,EAAE,iBAAiB,GAAG,MAAM,CAAC,GACvD,oBAAoB,GACvB,+BAA+B,CAWjC;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EACP,IAAI,CAAC,qBAAqB,EAAE,eAAe,GAAG,MAAM,CAAC,GACrD,oBAAoB,GACvB,6BAA6B,CAa/B;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,UAAU,EAAE,GAAG,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC3C,GAAG,sBAAsB,CAmBzB;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACzC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,oBAAoB,CAAC;CACnC,GAAG,qBAAqB,GAAG,IAAI,CAuC/B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACzC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,qBAAqB,EAAE,CAc1B"}