@runcore-sh/runcore 0.1.2

package/dist/google/gmail-timer.js

@@ -0,0 +1,223 @@
+/**
+ * Background inbox polling timer.
+ * Checks for new messages every 5 minutes.
+ * Pushes notifications for new unread messages.
+ * Emails with the instance name in the subject are processed as chat and replied to automatically.
+ * Follows src/goals/timer.ts pattern: module-level state, idempotent start/stop.
+ */
+import { getRecentMessages, getMessage, isGmailAvailable } from "./gmail.js";
+import { pushNotification } from "../goals/notifications.js";
+import { logActivity } from "../activity/log.js";
+import { createLogger } from "../utils/logger.js";
+import { getInstanceName, getInstanceNameLower } from "../instance.js";
+const log = createLogger("gmail");
+const DEFAULT_INTERVAL_MS = parseInt(process.env.GMAIL_POLL_INTERVAL_MS ?? "", 10) || 5 * 60 * 1000; // default 5 min, override with GMAIL_POLL_INTERVAL_MS
+let timer = null;
+const seenMessageIds = new Set(); // Track seen messages to avoid duplicates
+let initialized = false;
+let dashEmailHandler = null;
+/** The subject-line pattern that triggers instance email processing. */
+const DASH_SUBJECT_PATTERN = new RegExp(`\\b${getInstanceNameLower()}\\b`, "i");
+/**
+ * Register a handler for instance-addressed emails.
+ * When the timer finds new unread emails with the instance name in the subject,
+ * it fetches the full body and calls this handler.
+ */
+export function onDashEmail(handler) {
+    dashEmailHandler = handler;
+}
+/** Alias for onDashEmail — preferred name for generic instances. */
+export const onInstanceEmail = onDashEmail;
+/**
+ * Start the Gmail polling timer. Idempotent.
+ */
+export function startGmailTimer(intervalMs) {
+    if (timer)
+        return;
+    const interval = intervalMs ?? DEFAULT_INTERVAL_MS;
+    // Run an initial check to seed the seen set (don't notify on first run)
+    (async () => {
+        if (!isGmailAvailable())
+            return;
+        try {
+            const result = await getRecentMessages(1);
+            if (result.ok && result.messages) {
+                for (const msg of result.messages) {
+                    seenMessageIds.add(msg.id);
+                }
+            }
+            initialized = true;
+        }
+        catch {
+            initialized = true; // Continue even if initial seed fails
+        }
+    })();
+    timer = setInterval(async () => {
+        if (!isGmailAvailable() || !initialized)
+            return;
+        try {
+            const result = await getRecentMessages(1); // Last hour
+            if (!result.ok || !result.messages)
+                return;
+            const newMessages = result.messages.filter((m) => m.isUnread && !seenMessageIds.has(m.id));
+            // Track all seen IDs
+            for (const msg of result.messages) {
+                seenMessageIds.add(msg.id);
+            }
+            if (newMessages.length > 0) {
+                // Separate instance-addressed emails from regular notifications
+                const dashEmails = [];
+                const regularEmails = [];
+                for (const m of newMessages) {
+                    if (DASH_SUBJECT_PATTERN.test(m.subject)) {
+                        dashEmails.push(m);
+                    }
+                    else {
+                        regularEmails.push(m);
+                    }
+                }
+                // Process instance-addressed emails (fetch body, run through AI, reply)
+                if (dashEmails.length > 0 && dashEmailHandler) {
+                    for (const m of dashEmails) {
+                        processDashEmail(m).catch((err) => {
+                            const errMsg = err instanceof Error ? err.message : String(err);
+                            log.error(`Failed to process ${getInstanceName()} email`, { messageId: m.id, error: errMsg });
+                            logActivity({ source: "gmail", summary: `Failed to process ${getInstanceName()} email from ${m.from}: ${errMsg}` });
+                        });
+                    }
+                }
+                // Fetch full body for regular emails and push rich notifications
+                if (regularEmails.length > 0) {
+                    for (const m of regularEmails) {
+                        fetchAndNotify(m).catch((err) => {
+                            const errMsg = err instanceof Error ? err.message : String(err);
+                            log.warn("Failed to fetch email body for notification", { messageId: m.id, error: errMsg });
+                            // Fall back to snippet-only notification
+                            pushNotification({
+                                timestamp: new Date().toISOString(),
+                                source: "gmail",
+                                message: `New email from ${m.from}: "${m.subject}"\n${m.snippet}`,
+                            });
+                        });
+                    }
+                    logActivity({
+                        source: "gmail",
+                        summary: `${regularEmails.length} new unread email(s)`,
+                    });
+                }
+                // Separate log for instance-addressed emails
+                if (dashEmails.length > 0) {
+                    logActivity({
+                        source: "gmail",
+                        summary: `${dashEmails.length} ${getInstanceName()}-addressed email(s) detected — processing`,
+                    });
+                }
+            }
+            // Prune old seen IDs (keep max 500)
+            if (seenMessageIds.size > 500) {
+                const arr = [...seenMessageIds];
+                const toRemove = arr.slice(0, arr.length - 500);
+                for (const id of toRemove)
+                    seenMessageIds.delete(id);
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logActivity({ source: "gmail", summary: `Poll error: ${msg}` });
+        }
+    }, interval);
+    const mins = Math.round(interval / 60_000);
+    log.info(`Gmail poll: every ${mins} min`);
+}
+/**
+ * Fetch full email body and push a rich notification so the instance can reason about it in chat.
+ * Truncates body to keep notification size reasonable.
+ */
+async function fetchAndNotify(m) {
+    const full = await getMessage(m.id);
+    const body = full.ok && full.message?.body?.trim()
+        ? full.message.body.trim()
+        : m.snippet;
+    // Truncate body to ~500 chars for notification context
+    const truncated = body.length > 500 ? body.slice(0, 500) + "..." : body;
+    const senderName = m.from.split("<")[0].trim();
+    pushNotification({
+        timestamp: new Date().toISOString(),
+        source: "gmail",
+        message: [
+            `New email from ${senderName}: "${m.subject}" [threadId: ${m.threadId}]`,
+            truncated,
+        ].join("\n"),
+    });
+}
+/**
+ * Fetch full email body and run through the instance email handler.
+ */
+async function processDashEmail(m) {
+    if (!dashEmailHandler)
+        return;
+    // Fetch full message with body
+    const full = await getMessage(m.id);
+    if (!full.ok || !full.message) {
+        log.error(`Failed to fetch full ${getInstanceName()} email`, { messageId: m.id });
+        return;
+    }
+    const emailBody = full.message.body?.trim();
+    if (!emailBody) {
+        log.warn(`${getInstanceName()} email has no body`, { messageId: m.id, subject: m.subject });
+        return;
+    }
+    log.info(`Processing ${getInstanceName()} email`, { from: m.from, subject: m.subject, bodyLength: emailBody.length });
+    const reply = await dashEmailHandler(full.message);
+    if (!reply) {
+        log.warn(`${getInstanceName()} email handler returned no reply`, { messageId: m.id });
+        return;
+    }
+    // Send reply via sendEmail (imported dynamically to avoid circular deps)
+    const { sendEmail } = await import("./gmail-send.js");
+    const senderEmail = extractEmail(m.from);
+    const subject = m.subject.startsWith("Re:") ? m.subject : `Re: ${m.subject}`;
+    const result = await sendEmail({
+        to: senderEmail,
+        subject,
+        body: reply,
+        threadId: m.threadId,
+        inReplyTo: m.rfc822MessageId,
+    });
+    if (result.ok) {
+        log.info(`Replied to ${getInstanceName()} email`, { to: senderEmail, subject });
+        logActivity({ source: "gmail", summary: `${getInstanceName()} replied to email from ${senderEmail}: "${m.subject}"`, actionLabel: "AUTONOMOUS", reason: `${getInstanceName()}-addressed email auto-reply` });
+        pushNotification({
+            timestamp: new Date().toISOString(),
+            source: "gmail",
+            message: `Replied to email from **${m.from.split("<")[0].trim()}**: "${m.subject}"`,
+        });
+    }
+    else {
+        log.error(`Failed to reply to ${getInstanceName()} email`, { to: senderEmail, error: result.message });
+        logActivity({ source: "gmail", summary: `Failed to reply to ${getInstanceName()} email: ${result.message}`, actionLabel: "AUTONOMOUS", reason: `${getInstanceName()}-addressed email auto-reply failed` });
+    }
+}
+/** Extract email address from "Name <email>" format. */
+function extractEmail(from) {
+    const match = from.match(/<(.+?)>/);
+    return match ? match[1] : from.trim();
+}
+/**
+ * Stop the Gmail polling timer.
+ */
+export function stopGmailTimer() {
+    if (timer) {
+        clearInterval(timer);
+        timer = null;
+    }
+    seenMessageIds.clear();
+    initialized = false;
+}
+/**
+ * Check if the Gmail timer is running.
+ */
+export function isGmailTimerRunning() {
+    return timer !== null;
+}
+//# sourceMappingURL=gmail-timer.js.map

package/dist/google/gmail-timer.js.map

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

package/dist/google/gmail.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Gmail API client.
+ * Raw fetch via googleGet/googlePost — no SDK.
+ * All functions return { ok, data?, message } — never throw.
+ */
+export interface GmailMessage {
+    id: string;
+    threadId: string;
+    subject: string;
+    from: string;
+    to: string;
+    date: string;
+    snippet: string;
+    body?: string;
+    labels: string[];
+    isUnread: boolean;
+    /** RFC 822 Message-ID header, used for inReplyTo when replying */
+    rfc822MessageId?: string;
+}
+export interface GmailThread {
+    id: string;
+    messages: GmailMessage[];
+    subject: string;
+}
+export type SenderCategory = "direct" | "notification" | "newsletter" | "social" | "promotion" | "forum" | "update" | "unknown";
+export interface CategorizedMessage extends GmailMessage {
+    priority: "high" | "normal" | "low";
+    senderCategory: SenderCategory;
+}
+export interface InboxSummary {
+    unreadCount: number;
+    recentMessages: CategorizedMessage[];
+    byCategory: Record<SenderCategory, number>;
+    highPriority: CategorizedMessage[];
+}
+/**
+ * Check if Gmail is ready (Google authenticated).
+ */
+export declare function isGmailAvailable(): boolean;
+/**
+ * Get recent messages from the last N hours (headers + snippet, no body).
+ */
+export declare function getRecentMessages(hours?: number): Promise<{
+    ok: boolean;
+    messages?: GmailMessage[];
+    message: string;
+}>;
+/**
+ * Get a single message with full body.
+ */
+export declare function getMessage(id: string): Promise<{
+    ok: boolean;
+    message?: GmailMessage;
+    status: string;
+}>;
+/**
+ * Get a full conversation thread.
+ */
+export declare function getThread(threadId: string): Promise<{
+    ok: boolean;
+    thread?: GmailThread;
+    message: string;
+}>;
+/**
+ * Search messages using Gmail search syntax.
+ */
+export declare function searchMessages(query: string, maxResults?: number): Promise<{
+    ok: boolean;
+    messages?: GmailMessage[];
+    message: string;
+}>;
+/**
+ * Get unread message count.
+ */
+export declare function getUnreadCount(): Promise<{
+    ok: boolean;
+    count?: number;
+    message: string;
+}>;
+/**
+ * Format messages as a readable text block for LLM context injection.
+ */
+export declare function formatMessagesForContext(messages: GmailMessage[]): string;
+/**
+ * Mark a message as read (remove UNREAD label).
+ */
+export declare function markAsRead(messageId: string): Promise<{
+    ok: boolean;
+    message: string;
+}>;
+/**
+ * Mark a message as unread (add UNREAD label).
+ */
+export declare function markAsUnread(messageId: string): Promise<{
+    ok: boolean;
+    message: string;
+}>;
+/**
+ * Batch mark multiple messages as read.
+ */
+export declare function batchMarkAsRead(messageIds: string[]): Promise<{
+    ok: boolean;
+    succeeded: number;
+    failed: number;
+    message: string;
+}>;
+/**
+ * Batch mark multiple messages as unread.
+ */
+export declare function batchMarkAsUnread(messageIds: string[]): Promise<{
+    ok: boolean;
+    succeeded: number;
+    failed: number;
+    message: string;
+}>;
+/**
+ * Categorize a sender based on email address and Gmail labels.
+ */
+export declare function categorizeSender(from: string, labels: string[]): SenderCategory;
+/**
+ * Detect message priority from Gmail labels and headers.
+ * High: IMPORTANT label or STARRED.
+ * Low:  promotions, social, forums.
+ * Normal: everything else.
+ */
+export declare function detectPriority(labels: string[], senderCategory: SenderCategory): "high" | "normal" | "low";
+/**
+ * Enrich a GmailMessage with priority and sender category.
+ */
+export declare function categorizeMessage(msg: GmailMessage): CategorizedMessage;
+/**
+ * Categorize an array of messages by sender type.
+ * Returns messages grouped by category, sorted with direct first.
+ */
+export declare function categorizeMessages(hours?: number): Promise<{
+    ok: boolean;
+    categorized?: CategorizedMessage[];
+    byCategory?: Record<SenderCategory, CategorizedMessage[]>;
+    message: string;
+}>;
+/**
+ * Return messages scored and sorted by priority (high → normal → low).
+ * Within each tier, messages are in reverse-chronological order.
+ */
+export declare function prioritizeInbox(hours?: number): Promise<{
+    ok: boolean;
+    messages?: CategorizedMessage[];
+    counts?: {
+        high: number;
+        normal: number;
+        low: number;
+    };
+    message: string;
+}>;
+/**
+ * Alias for fetchInboxSummary — provides complete triage overview.
+ */
+export declare const getInboxSummary: typeof fetchInboxSummary;
+/**
+ * Fetch a triage-ready inbox summary: unread count, categorized recent messages,
+ * category breakdown, and high-priority items.
+ */
+export declare function fetchInboxSummary(hours?: number): Promise<{
+    ok: boolean;
+    summary?: InboxSummary;
+    message: string;
+}>;
+/**
+ * Format an inbox summary as a readable text block for LLM context injection.
+ */
+export declare function formatInboxSummaryForContext(summary: InboxSummary): string;
+//# sourceMappingURL=gmail.d.ts.map

package/dist/google/gmail.d.ts.map

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