@runcore-sh/runcore 0.1.2

package/dist/google/docs.js

@@ -0,0 +1,309 @@
+/**
+ * Google Docs & Sheets client.
+ * Raw fetch via googlePost/googleGet — no SDK.
+ * Follows same pattern as gmail.ts and calendar.ts.
+ *
+ * Uses drive.file scope — can only access files this app creates.
+ */
+import { googlePost, googleGet, isGoogleAuthenticated } from "./auth.js";
+import { createLogger } from "../utils/logger.js";
+import { getInstanceName } from "../instance.js";
+const log = createLogger("google.docs");
+const DOCS_API = "https://docs.googleapis.com/v1/documents";
+const SHEETS_API = "https://sheets.googleapis.com/v4/spreadsheets";
+/**
+ * Check if Docs/Sheets creation is available.
+ */
+export function isDocsAvailable() {
+    return isGoogleAuthenticated();
+}
+/**
+ * Create a new Google Doc with the given title.
+ * Returns the document ID and URL.
+ */
+export async function createDocument(title) {
+    log.debug("Creating Google Doc", { title });
+    const res = await googlePost(DOCS_API, { title });
+    if (!res.ok || !res.data) {
+        log.error("Failed to create Google Doc", { title, error: res.message });
+        return { ok: false, message: res.message };
+    }
+    log.info("Google Doc created", { title, documentId: res.data.documentId });
+    return {
+        ok: true,
+        data: {
+            documentId: res.data.documentId,
+            title: res.data.title,
+            documentUrl: `https://docs.google.com/document/d/${res.data.documentId}/edit`,
+        },
+        message: "Document created",
+    };
+}
+/**
+ * Batch-update a document with structured content requests.
+ * Uses the Google Docs batchUpdate API.
+ * Requests are applied in order — insert from bottom-up to avoid index shifting.
+ */
+export async function batchUpdateDocument(documentId, requests) {
+    log.debug("Batch-updating document", { documentId, requestCount: requests.length });
+    const res = await googlePost(`${DOCS_API}/${documentId}:batchUpdate`, { requests });
+    if (!res.ok) {
+        log.error("Document batch update failed", { documentId, error: res.message });
+        return { ok: false, message: res.message };
+    }
+    log.debug("Document batch update complete", { documentId });
+    return { ok: true, message: "Document updated" };
+}
+/**
+ * Insert plain text at a given index in the document.
+ */
+function insertTextRequest(text, index) {
+    return {
+        insertText: {
+            text,
+            location: { index },
+        },
+    };
+}
+/**
+ * Apply paragraph style (heading, normal) to a range.
+ */
+function paragraphStyleRequest(startIndex, endIndex, namedStyleType) {
+    return {
+        updateParagraphStyle: {
+            range: { startIndex, endIndex },
+            paragraphStyle: { namedStyleType },
+            fields: "namedStyleType",
+        },
+    };
+}
+/**
+ * Apply bold/italic text style to a range.
+ */
+function textStyleRequest(startIndex, endIndex, style) {
+    const fields = Object.keys(style).join(",");
+    return {
+        updateTextStyle: {
+            range: { startIndex, endIndex },
+            textStyle: style,
+            fields,
+        },
+    };
+}
+const PRIORITY_LABELS = {
+    0: "No priority",
+    1: "Urgent",
+    2: "High",
+    3: "Medium",
+    4: "Low",
+};
+/**
+ * Create a Google Doc populated with a backlog review.
+ * Returns the document URL.
+ */
+export async function createBacklogReviewDoc(items) {
+    // 1. Create the document
+    log.info("Creating backlog review document", { itemCount: items.length });
+    const doc = await createDocument(`${getInstanceName()}'s Notes`);
+    if (!doc.ok || !doc.data)
+        return { ok: false, message: doc.message };
+    // 2. Build document content as text + formatting requests
+    // Google Docs starts with index 1 (the body content start)
+    const requests = [];
+    let idx = 1;
+    // Helper: append text and track index
+    function appendText(text) {
+        requests.push(insertTextRequest(text, idx));
+        const start = idx;
+        idx += text.length;
+        return { start, end: idx };
+    }
+    // Helper: append a heading
+    function appendHeading(text, level) {
+        const range = appendText(text + "\n");
+        requests.push(paragraphStyleRequest(range.start, range.end, level));
+        return range;
+    }
+    // Helper: append normal paragraph
+    function appendParagraph(text) {
+        const range = appendText(text + "\n");
+        requests.push(paragraphStyleRequest(range.start, range.end, "NORMAL_TEXT"));
+        return range;
+    }
+    // Helper: append bold text within a paragraph
+    function appendBoldText(text) {
+        const range = appendText(text);
+        requests.push(textStyleRequest(range.start, range.end, { bold: true }));
+        return range;
+    }
+    // --- Document content ---
+    // Title is already set by createDocument, but we add an intro section
+    const today = new Date().toLocaleDateString("en-US", {
+        weekday: "long",
+        year: "numeric",
+        month: "long",
+        day: "numeric",
+    });
+    appendHeading("Backlog Review", "HEADING_1");
+    appendParagraph(`Prepared by ${getInstanceName()} on ${today}. This document summarizes all active backlog items for review. Items are grouped by current state and sorted by priority.`);
+    appendText("\n");
+    // Group items by state
+    const groups = {};
+    for (const item of items) {
+        const state = item.state;
+        if (!groups[state])
+            groups[state] = [];
+        groups[state].push(item);
+    }
+    // Sort each group by priority (1=urgent first)
+    for (const g of Object.values(groups)) {
+        g.sort((a, b) => a.priority - b.priority);
+    }
+    // Render order: in_progress, todo, backlog, done, cancelled
+    const stateOrder = ["in_progress", "todo", "backlog", "done", "cancelled"];
+    const stateLabels = {
+        in_progress: "In Progress",
+        todo: "To Do",
+        backlog: "Backlog",
+        done: "Completed",
+        cancelled: "Cancelled",
+    };
+    for (const state of stateOrder) {
+        const groupItems = groups[state];
+        if (!groupItems || groupItems.length === 0)
+            continue;
+        appendHeading(`${stateLabels[state] ?? state} (${groupItems.length})`, "HEADING_2");
+        for (const item of groupItems) {
+            // Item title line
+            appendHeading(`${item.identifier}: ${item.title}`, "HEADING_3");
+            // Priority & assignee
+            const priority = PRIORITY_LABELS[item.priority] ?? `P${item.priority}`;
+            let meta = `Priority: ${priority}`;
+            if (item.assignee)
+                meta += ` | Assignee: ${item.assignee}`;
+            appendParagraph(meta);
+            // Description
+            if (item.description) {
+                appendParagraph(item.description);
+            }
+            // Notes from exchanges
+            if (item.exchanges.length > 0) {
+                appendBoldText("Notes: ");
+                appendText(item.exchanges.map((e) => e.body).join("; ") + "\n");
+            }
+            appendText("\n");
+        }
+    }
+    // Summary section
+    appendHeading("Summary", "HEADING_1");
+    const counts = stateOrder
+        .filter((s) => groups[s]?.length)
+        .map((s) => `${stateLabels[s]}: ${groups[s].length}`)
+        .join(" | ");
+    appendParagraph(counts);
+    appendParagraph(`Total active items: ${items.length}`);
+    // 3. Apply all requests
+    const update = await batchUpdateDocument(doc.data.documentId, requests);
+    if (!update.ok) {
+        return {
+            ok: false,
+            message: `Document created but content failed: ${update.message}. Doc URL: ${doc.data.documentUrl}`,
+        };
+    }
+    log.info("Backlog review document complete", { url: doc.data.documentUrl, itemCount: items.length });
+    return { ok: true, url: doc.data.documentUrl, message: "Backlog review doc created" };
+}
+/**
+ * Create a new Google Sheet with optional data.
+ * Data is an array of rows, each row an array of cell values.
+ */
+export async function createSpreadsheet(title, data, sheetName) {
+    const body = {
+        properties: { title },
+    };
+    if (sheetName) {
+        body.sheets = [{ properties: { title: sheetName } }];
+    }
+    log.debug("Creating spreadsheet", { title, sheetName });
+    const res = await googlePost(SHEETS_API, body);
+    if (!res.ok || !res.data?.spreadsheetId) {
+        log.error("Failed to create spreadsheet", { title, error: res.message });
+        return { ok: false, message: res.message };
+    }
+    const sheetId = res.data.spreadsheetId;
+    const url = res.data.spreadsheetUrl ?? `https://docs.google.com/spreadsheets/d/${sheetId}/edit`;
+    // Write data if provided
+    if (data && data.length > 0) {
+        const range = `${sheetName ?? "Sheet1"}!A1`;
+        const writeResult = await googlePost(`${SHEETS_API}/${sheetId}/values/${encodeURIComponent(range)}:append?valueInputOption=USER_ENTERED&insertDataOption=INSERT_ROWS`, { values: data });
+        if (!writeResult.ok) {
+            return {
+                ok: true,
+                data: { spreadsheetId: sheetId, title, spreadsheetUrl: url },
+                message: `Sheet created but data write failed: ${writeResult.message}`,
+            };
+        }
+    }
+    log.info("Spreadsheet created", { title, spreadsheetId: sheetId });
+    return {
+        ok: true,
+        data: { spreadsheetId: sheetId, title, spreadsheetUrl: url },
+        message: "Spreadsheet created",
+    };
+}
+/**
+ * Read data from a Google Sheet.
+ */
+export async function readSpreadsheet(spreadsheetId, range) {
+    const r = range ?? "Sheet1";
+    log.debug("Reading spreadsheet", { spreadsheetId, range: r });
+    const res = await googleGet(`${SHEETS_API}/${spreadsheetId}/values/${encodeURIComponent(r)}`);
+    if (!res.ok) {
+        log.error("Failed to read spreadsheet", { spreadsheetId, error: res.message });
+        return { ok: false, message: res.message };
+    }
+    const rows = res.data?.values ?? [];
+    log.debug("Spreadsheet read complete", { spreadsheetId, rowCount: rows.length });
+    return {
+        ok: true,
+        data: rows,
+        message: `${rows.length} rows`,
+    };
+}
+/**
+ * Create a Google Doc with markdown-ish content in one call.
+ * Convenience wrapper: creates doc + inserts formatted content.
+ */
+export async function createDocWithContent(title, content) {
+    log.debug("Creating doc with content", { title });
+    const doc = await createDocument(title);
+    if (!doc.ok || !doc.data)
+        return { ok: false, message: doc.message };
+    if (content.trim()) {
+        const requests = [];
+        const lines = content.trim().split("\n");
+        let idx = 1;
+        for (const line of lines) {
+            const headingMatch = line.match(/^(#{1,3})\s+(.+)$/);
+            const text = (headingMatch ? headingMatch[2] : line) + "\n";
+            requests.push(insertTextRequest(text, idx));
+            if (headingMatch) {
+                const level = headingMatch[1].length;
+                const style = level === 1 ? "HEADING_1" : level === 2 ? "HEADING_2" : "HEADING_3";
+                requests.push(paragraphStyleRequest(idx, idx + text.length, style));
+            }
+            idx += text.length;
+        }
+        const update = await batchUpdateDocument(doc.data.documentId, requests);
+        if (!update.ok) {
+            return {
+                ok: true,
+                url: doc.data.documentUrl,
+                message: `Doc created but content failed: ${update.message}`,
+            };
+        }
+    }
+    log.info("Doc with content created", { title, url: doc.data.documentUrl });
+    return { ok: true, url: doc.data.documentUrl, message: `Created: ${title}` };
+}
+//# sourceMappingURL=docs.js.map

package/dist/google/docs.js.map

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

package/dist/google/gmail-send.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Gmail send client.
+ * Composes RFC 2822 messages and sends via Gmail API.
+ * Raw fetch via googlePost — no SDK.
+ * All functions return { ok, data?, message } — never throw.
+ */
+export interface EmailAttachment {
+    /** File name shown to recipient (e.g. "report.pdf") */
+    filename: string;
+    /** MIME type (e.g. "application/pdf", "image/png") */
+    mimeType: string;
+    /** Raw file content as a Buffer */
+    content: Buffer;
+}
+export interface SendEmailOptions {
+    to: string | string[];
+    cc?: string | string[];
+    bcc?: string | string[];
+    subject: string;
+    body: string;
+    htmlBody?: string;
+    from?: string;
+    attachments?: EmailAttachment[];
+    /** Thread ID for replies — keeps the email in the same conversation */
+    threadId?: string;
+    /** Message-ID header of the email being replied to */
+    inReplyTo?: string;
+    /** References header chain for threading */
+    references?: string;
+}
+export interface SendEmailResult {
+    ok: boolean;
+    data?: {
+        id: string;
+        threadId: string;
+        labelIds: string[];
+    };
+    message: string;
+}
+/**
+ * Check if Gmail sending is ready (Google authenticated).
+ */
+export declare function isGmailSendAvailable(): boolean;
+/**
+ * Send an email via Gmail API.
+ * Builds an RFC 2822 message, base64url-encodes it, and POSTs to the send endpoint.
+ */
+export declare function sendEmail(options: SendEmailOptions): Promise<SendEmailResult>;
+/**
+ * Load a file from disk and return it as an EmailAttachment.
+ * Infers MIME type from extension.
+ */
+export declare function attachmentFromFile(filePath: string): Promise<{
+    ok: boolean;
+    attachment?: EmailAttachment;
+    message: string;
+}>;
+//# sourceMappingURL=gmail-send.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gmail-send.d.ts","sourceRoot":"","sources":["../../src/google/gmail-send.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAQD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5D,OAAO,EAAE,MAAM,CAAC;CACjB;AA0GD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA2DnF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAClE,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAiBD"}

package/dist/google/gmail-send.js

@@ -0,0 +1,219 @@
+/**
+ * Gmail send client.
+ * Composes RFC 2822 messages and sends via Gmail API.
+ * Raw fetch via googlePost — no SDK.
+ * All functions return { ok, data?, message } — never throw.
+ */
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { getAccessToken, isGoogleAuthenticated } from "./auth.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("google.gmail-send");
+const GMAIL_API = "https://www.googleapis.com/gmail/v1/users/me";
+const DEFAULT_FROM = process.env.GMAIL_FROM ?? "noreply@example.com";
+// --- Helpers ---
+/**
+ * Encode a Buffer to URL-safe base64 (Gmail's required format).
+ */
+function toBase64Url(buf) {
+    return buf.toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+/**
+ * Join an address list into a comma-separated string.
+ */
+function joinAddresses(addr) {
+    return Array.isArray(addr) ? addr.join(", ") : addr;
+}
+/**
+ * Generate a MIME boundary string.
+ */
+function generateBoundary() {
+    return `----=_Part_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+}
+/**
+ * Build a complete RFC 2822 message as a string.
+ * Supports plain text, HTML alternative, and file attachments.
+ */
+function buildRfc2822(options) {
+    const from = options.from ?? DEFAULT_FROM;
+    const to = joinAddresses(options.to);
+    const headers = [
+        `From: ${from}`,
+        `To: ${to}`,
+        `Subject: ${options.subject}`,
+        `MIME-Version: 1.0`,
+        `Date: ${new Date().toUTCString()}`,
+    ];
+    if (options.cc)
+        headers.push(`Cc: ${joinAddresses(options.cc)}`);
+    if (options.bcc)
+        headers.push(`Bcc: ${joinAddresses(options.bcc)}`);
+    if (options.inReplyTo)
+        headers.push(`In-Reply-To: ${options.inReplyTo}`);
+    if (options.references)
+        headers.push(`References: ${options.references}`);
+    const hasAttachments = options.attachments && options.attachments.length > 0;
+    const hasHtml = !!options.htmlBody;
+    // Simple plain text — no MIME parts needed
+    if (!hasAttachments && !hasHtml) {
+        headers.push(`Content-Type: text/plain; charset="UTF-8"`);
+        headers.push(`Content-Transfer-Encoding: 7bit`);
+        return headers.join("\r\n") + "\r\n\r\n" + options.body;
+    }
+    // With HTML but no attachments — multipart/alternative
+    if (!hasAttachments && hasHtml) {
+        const altBoundary = generateBoundary();
+        headers.push(`Content-Type: multipart/alternative; boundary="${altBoundary}"`);
+        const parts = [
+            `--${altBoundary}\r\nContent-Type: text/plain; charset="UTF-8"\r\nContent-Transfer-Encoding: 7bit\r\n\r\n${options.body}`,
+            `--${altBoundary}\r\nContent-Type: text/html; charset="UTF-8"\r\nContent-Transfer-Encoding: 7bit\r\n\r\n${options.htmlBody}`,
+            `--${altBoundary}--`,
+        ];
+        return headers.join("\r\n") + "\r\n\r\n" + parts.join("\r\n");
+    }
+    // With attachments — multipart/mixed
+    const mixedBoundary = generateBoundary();
+    headers.push(`Content-Type: multipart/mixed; boundary="${mixedBoundary}"`);
+    const parts = [];
+    // Text body (or alternative text+html)
+    if (hasHtml) {
+        const altBoundary = generateBoundary();
+        parts.push(`--${mixedBoundary}\r\nContent-Type: multipart/alternative; boundary="${altBoundary}"\r\n\r\n` +
+            `--${altBoundary}\r\nContent-Type: text/plain; charset="UTF-8"\r\nContent-Transfer-Encoding: 7bit\r\n\r\n${options.body}\r\n` +
+            `--${altBoundary}\r\nContent-Type: text/html; charset="UTF-8"\r\nContent-Transfer-Encoding: 7bit\r\n\r\n${options.htmlBody}\r\n` +
+            `--${altBoundary}--`);
+    }
+    else {
+        parts.push(`--${mixedBoundary}\r\nContent-Type: text/plain; charset="UTF-8"\r\nContent-Transfer-Encoding: 7bit\r\n\r\n${options.body}`);
+    }
+    // Attachments
+    for (const att of options.attachments) {
+        const encoded = att.content.toString("base64");
+        parts.push(`--${mixedBoundary}\r\n` +
+            `Content-Type: ${att.mimeType}; name="${att.filename}"\r\n` +
+            `Content-Disposition: attachment; filename="${att.filename}"\r\n` +
+            `Content-Transfer-Encoding: base64\r\n\r\n` +
+            encoded);
+    }
+    parts.push(`--${mixedBoundary}--`);
+    return headers.join("\r\n") + "\r\n\r\n" + parts.join("\r\n");
+}
+// --- Public API ---
+/**
+ * Check if Gmail sending is ready (Google authenticated).
+ */
+export function isGmailSendAvailable() {
+    return isGoogleAuthenticated();
+}
+/**
+ * Send an email via Gmail API.
+ * Builds an RFC 2822 message, base64url-encodes it, and POSTs to the send endpoint.
+ */
+export async function sendEmail(options) {
+    if (!isGoogleAuthenticated()) {
+        log.warn("Send attempted without authentication");
+        return { ok: false, message: "Google not authenticated — connect Google first" };
+    }
+    // Validate required fields
+    if (!options.to || (Array.isArray(options.to) && options.to.length === 0)) {
+        return { ok: false, message: "No recipient specified" };
+    }
+    if (!options.subject) {
+        return { ok: false, message: "No subject specified" };
+    }
+    if (!options.body) {
+        return { ok: false, message: "No body specified" };
+    }
+    const toStr = joinAddresses(options.to);
+    log.info("Sending email", { to: toStr, subject: options.subject, hasAttachments: !!(options.attachments?.length), threadId: options.threadId });
+    try {
+        const raw = buildRfc2822(options);
+        const encoded = toBase64Url(Buffer.from(raw, "utf-8"));
+        const payload = { raw: encoded };
+        if (options.threadId)
+            payload.threadId = options.threadId;
+        // Use raw fetch instead of googlePost because the Gmail send endpoint
+        // returns the created message directly and we need tight control
+        const auth = await getAccessToken();
+        if (!auth.ok)
+            return { ok: false, message: auth.message };
+        const res = await fetch(`${GMAIL_API}/messages/send`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${auth.token}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(30_000), // Longer timeout for attachments
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            log.error("Email send failed", { to: toStr, status: res.status, error: text });
+            return { ok: false, message: `Gmail send error (${res.status}): ${text}` };
+        }
+        const data = (await res.json());
+        log.info("Email sent successfully", { to: toStr, messageId: data.id, threadId: data.threadId });
+        return {
+            ok: true,
+            data: { id: data.id, threadId: data.threadId, labelIds: data.labelIds },
+            message: `Email sent to ${toStr} — ID: ${data.id}`,
+        };
+    }
+    catch (err) {
+        log.error("Email send exception", { to: toStr, error: err.message });
+        return { ok: false, message: `Gmail send failed: ${err.message}` };
+    }
+}
+/**
+ * Load a file from disk and return it as an EmailAttachment.
+ * Infers MIME type from extension.
+ */
+export async function attachmentFromFile(filePath) {
+    try {
+        log.debug("Loading attachment from file", { filePath });
+        const content = await readFile(filePath);
+        const filename = basename(filePath);
+        const mimeType = inferMimeType(filename);
+        log.debug("Attachment loaded", { filename, mimeType, sizeBytes: content.length });
+        return {
+            ok: true,
+            attachment: { filename, mimeType, content },
+            message: `Loaded ${filename} (${content.length} bytes)`,
+        };
+    }
+    catch (err) {
+        log.error("Failed to read attachment", { filePath, error: err.message });
+        return { ok: false, message: `Failed to read attachment: ${err.message}` };
+    }
+}
+/**
+ * Infer MIME type from file extension.
+ */
+function inferMimeType(filename) {
+    const ext = filename.split(".").pop()?.toLowerCase() ?? "";
+    const types = {
+        pdf: "application/pdf",
+        doc: "application/msword",
+        docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+        xls: "application/vnd.ms-excel",
+        xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        ppt: "application/vnd.ms-powerpoint",
+        pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+        png: "image/png",
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        gif: "image/gif",
+        svg: "image/svg+xml",
+        webp: "image/webp",
+        txt: "text/plain",
+        csv: "text/csv",
+        html: "text/html",
+        json: "application/json",
+        zip: "application/zip",
+        mp3: "audio/mpeg",
+        mp4: "video/mp4",
+        wav: "audio/wav",
+    };
+    return types[ext] ?? "application/octet-stream";
+}
+//# sourceMappingURL=gmail-send.js.map

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

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

package/dist/google/gmail-timer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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 type { GmailMessage } from "./gmail.js";
+/**
+ * Callback for processing emails addressed to this instance.
+ * Receives the full message (with body) and should return the reply text.
+ */
+export type DashEmailHandler = (message: GmailMessage) => Promise<string | null>;
+/**
+ * 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 declare function onDashEmail(handler: DashEmailHandler): void;
+/** Alias for onDashEmail — preferred name for generic instances. */
+export declare const onInstanceEmail: typeof onDashEmail;
+/**
+ * Start the Gmail polling timer. Idempotent.
+ */
+export declare function startGmailTimer(intervalMs?: number): void;
+/**
+ * Stop the Gmail polling timer.
+ */
+export declare function stopGmailTimer(): void;
+/**
+ * Check if the Gmail timer is running.
+ */
+export declare function isGmailTimerRunning(): boolean;
+//# sourceMappingURL=gmail-timer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gmail-timer.d.ts","sourceRoot":"","sources":["../../src/google/gmail-timer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAc/C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAOjF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAE3D;AAED,oEAAoE;AACpE,eAAO,MAAM,eAAe,oBAAc,CAAC;AAE3C;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAyGzD;AAsFD;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAOrC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C"}