@runcore-sh/runcore 0.1.2

package/dist/services/morningBriefing.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Daily morning briefing — aggregates calendar, email, and board status.
+ * Follows src/services/backlogReview.ts pattern: module-level state, idempotent start/stop.
+ *
+ * Data sources:
+ * - Google Calendar: today's events via getTodaySchedule()
+ * - Gmail: inbox summary via getInboxSummary()
+ * - Queue: board status digest via QueueStore.list()
+ *
+ * Delivery: SMS, email (Gmail), and WhatsApp via existing channel modules.
+ *
+ * DASH-44
+ */
+import type { CalendarEvent } from "../google/calendar.js";
+import type { InboxSummary } from "../google/gmail.js";
+import { QueueStore } from "../queue/store.js";
+import type { ActivityEntry } from "../activity/log.js";
+/**
+ * Load briefing channel config from brain/operations/briefing-channels.json.
+ * Returns empty config if file is missing or malformed.
+ */
+export declare function loadBriefingChannelsFile(): BriefingConfig;
+export interface MorningBriefing {
+    generatedAt: string;
+    calendar: {
+        available: boolean;
+        eventCount: number;
+        events: CalendarEvent[];
+        formatted: string;
+    };
+    email: {
+        available: boolean;
+        unreadCount: number;
+        highPriorityCount: number;
+        summary: InboxSummary | null;
+        formatted: string;
+    };
+    board: {
+        totalActive: number;
+        byState: Record<string, number>;
+        inProgress: BoardTaskSummary[];
+        todoPending: BoardTaskSummary[];
+        recentlyDone: BoardTaskSummary[];
+    };
+    agentActivity: AgentActivitySummary;
+    urgentItems: UrgentItemsSummary;
+}
+export interface AgentActivitySummary {
+    recentCount: number;
+    entries: ActivityEntry[];
+}
+export interface UrgentItemsSummary {
+    count: number;
+    items: BoardTaskSummary[];
+}
+export interface BoardTaskSummary {
+    identifier: string;
+    title: string;
+    state: string;
+    priority: number;
+    assignee: string | null;
+}
+export interface BriefingDeliveryResult {
+    sms: boolean | null;
+    email: boolean | null;
+    whatsapp: boolean | null;
+}
+export interface BriefingConfig {
+    /** SMS recipients (phone numbers). Empty = skip SMS. */
+    smsTo?: string[];
+    /** Email recipients. Empty = skip email. */
+    emailTo?: string[];
+    /** WhatsApp recipients (phone numbers). Empty = skip WhatsApp. */
+    whatsappTo?: string[];
+    /** Hour of day to send briefing (0–23). Default: 7. */
+    briefingHour?: number;
+}
+/**
+ * Generate a morning briefing by aggregating all data sources.
+ */
+export declare function generateBriefing(store: QueueStore): Promise<MorningBriefing>;
+/**
+ * Format briefing as plain text (for SMS / WhatsApp).
+ * Compact format, max ~1500 chars for SMS/WhatsApp limits.
+ */
+export declare function formatBriefingText(briefing: MorningBriefing): string;
+/**
+ * Format briefing as HTML (for email delivery).
+ */
+export declare function formatBriefingHtml(briefing: MorningBriefing): string;
+/**
+ * Deliver a briefing through configured channels (SMS, email, WhatsApp).
+ * Returns null if no channels are configured (skips delivery entirely).
+ */
+export declare function deliverBriefing(briefing: MorningBriefing, config: BriefingConfig): Promise<BriefingDeliveryResult | null>;
+/**
+ * Start the morning briefing timer. Idempotent.
+ * Checks every 15 minutes whether it's time to send.
+ *
+ * Config resolution: explicit config arg → env vars → briefing-channels.json.
+ * At least one delivery channel must be configured or the timer is a no-op.
+ */
+export declare function startBriefingTimer(store: QueueStore, config?: BriefingConfig, intervalMs?: number): void;
+/** Stop the morning briefing timer. */
+export declare function stopBriefingTimer(): void;
+/** Check if the briefing timer is running. */
+export declare function isBriefingTimerRunning(): boolean;
+/** Get the last generated briefing, if any. */
+export declare function getLastBriefing(): MorningBriefing | null;
+/** Get the last delivery result, if any. */
+export declare function getLastDeliveryResult(): BriefingDeliveryResult | null;
+/**
+ * Update briefing configuration at runtime (e.g. recipients, hour).
+ */
+export declare function updateBriefingConfig(config: Partial<BriefingConfig>): void;
+/**
+ * Force an immediate briefing (e.g. from API endpoint or chat command).
+ * Ignores the time-of-day and daily dedup checks.
+ * Returns null if the timer isn't started or no channels are configured.
+ */
+export declare function triggerBriefing(): Promise<{
+    briefing: MorningBriefing;
+    delivery: BriefingDeliveryResult | null;
+} | null>;
+//# sourceMappingURL=morningBriefing.d.ts.map

package/dist/services/morningBriefing.d.ts.map

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