@auxiora/ambient 1.0.0

package/dist/notification.js

@@ -0,0 +1,87 @@
+import * as crypto from 'node:crypto';
+/** Priority ordering for queue sorting. */
+const PRIORITY_ORDER = {
+    alert: 3,
+    nudge: 2,
+    whisper: 1,
+};
+/**
+ * Priority-based queue for quiet notifications.
+ */
+export class QuietNotificationManager {
+    notifications = new Map();
+    /** Create and queue a notification. */
+    notify(priority, message, options) {
+        const notification = {
+            id: crypto.randomUUID(),
+            priority,
+            message,
+            detail: options?.detail,
+            createdAt: Date.now(),
+            dismissed: false,
+            source: options?.source ?? 'ambient',
+        };
+        this.notifications.set(notification.id, notification);
+        return notification;
+    }
+    /** Get all pending notifications, sorted by priority (highest first). */
+    getQueue() {
+        return Array.from(this.notifications.values())
+            .filter(n => !n.dismissed)
+            .sort((a, b) => PRIORITY_ORDER[b.priority] - PRIORITY_ORDER[a.priority]);
+    }
+    /** Get notifications filtered by priority. */
+    getByPriority(priority) {
+        return Array.from(this.notifications.values())
+            .filter(n => !n.dismissed && n.priority === priority);
+    }
+    /** Dismiss a notification. */
+    dismiss(id) {
+        const n = this.notifications.get(id);
+        if (!n)
+            return false;
+        n.dismissed = true;
+        return true;
+    }
+    /** Dismiss all notifications. */
+    dismissAll() {
+        let count = 0;
+        for (const n of this.notifications.values()) {
+            if (!n.dismissed) {
+                n.dismissed = true;
+                count++;
+            }
+        }
+        return count;
+    }
+    /** Get a notification by ID. */
+    get(id) {
+        return this.notifications.get(id);
+    }
+    /** Get count of pending notifications. */
+    getPendingCount() {
+        let count = 0;
+        for (const n of this.notifications.values()) {
+            if (!n.dismissed)
+                count++;
+        }
+        return count;
+    }
+    /** Remove old dismissed notifications. */
+    prune(maxAge = 24 * 60 * 60 * 1000) {
+        const cutoff = Date.now() - maxAge;
+        let pruned = 0;
+        for (const [id, n] of this.notifications) {
+            if (n.dismissed && n.createdAt < cutoff) {
+                this.notifications.delete(id);
+                pruned++;
+            }
+        }
+        return pruned;
+    }
+    /** Clear all notifications. */
+    clear() {
+        this.notifications.clear();
+    }
+}
+//# sourceMappingURL=notification.js.map

package/dist/notification.js.map

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

package/dist/orchestrator.d.ts

@@ -0,0 +1,40 @@
+import type { TriggerEvent } from '@auxiora/connectors';
+import type { NotificationHub, DoNotDisturbManager, NotificationPriority } from '@auxiora/notification-hub';
+/** Configuration for the NotificationOrchestrator. */
+export interface OrchestratorConfig {
+    /** Calendar alert window in ms (default 15 minutes). */
+    calendarAlertWindowMs?: number;
+}
+/** A pending orchestrator notification. */
+export interface OrchestratorNotification {
+    id: string;
+    source: string;
+    priority: NotificationPriority;
+    message: string;
+    createdAt: number;
+    delivered: boolean;
+}
+/** Function that delivers a notification to the user. */
+export type DeliveryChannelFn = (notification: OrchestratorNotification) => void;
+export declare class NotificationOrchestrator {
+    private hub;
+    private dnd;
+    private deliveryChannel;
+    private pending;
+    private calendarAlertWindowMs;
+    constructor(hub: NotificationHub, dnd: DoNotDisturbManager, deliveryChannel: DeliveryChannelFn, config?: OrchestratorConfig);
+    /** Map trigger events to notifications and deliver or queue them. */
+    processTriggerEvents(events: TriggerEvent[]): OrchestratorNotification[];
+    /** Check calendar events and create notifications for those starting soon. */
+    processCalendarCheck(events: Array<{
+        title: string;
+        startTime: number;
+    }>, now?: number): OrchestratorNotification[];
+    /** Get all pending (undelivered or queued) notifications. */
+    getPending(): OrchestratorNotification[];
+    /** Dismiss a pending notification by ID. Returns true if found and removed. */
+    dismiss(id: string): boolean;
+    private mapTriggerEvent;
+    private routeNotification;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAE5G,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,2CAA2C;AAC3C,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,yDAAyD;AACzD,MAAM,MAAM,iBAAiB,GAAG,CAAC,YAAY,EAAE,wBAAwB,KAAK,IAAI,CAAC;AAMjF,qBAAa,wBAAwB;IACnC,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,qBAAqB,CAAS;gBAGpC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,mBAAmB,EACxB,eAAe,EAAE,iBAAiB,EAClC,MAAM,CAAC,EAAE,kBAAkB;IAQ7B,qEAAqE;IACrE,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,wBAAwB,EAAE;IA6BxE,8EAA8E;IAC9E,oBAAoB,CAClB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,EACnD,GAAG,CAAC,EAAE,MAAM,GACX,wBAAwB,EAAE;IAkC7B,6DAA6D;IAC7D,UAAU,IAAI,wBAAwB,EAAE;IAIxC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAO5B,OAAO,CAAC,eAAe;IA+CvB,OAAO,CAAC,iBAAiB;CAc1B"}

package/dist/orchestrator.js

@@ -0,0 +1,130 @@
+const URGENCY_KEYWORDS = ['urgent', 'asap', 'important', 'action required', 'deadline'];
+const DEFAULT_CALENDAR_ALERT_WINDOW_MS = 15 * 60 * 1000; // 15 minutes
+export class NotificationOrchestrator {
+    hub;
+    dnd;
+    deliveryChannel;
+    pending = [];
+    calendarAlertWindowMs;
+    constructor(hub, dnd, deliveryChannel, config) {
+        this.hub = hub;
+        this.dnd = dnd;
+        this.deliveryChannel = deliveryChannel;
+        this.calendarAlertWindowMs = config?.calendarAlertWindowMs ?? DEFAULT_CALENDAR_ALERT_WINDOW_MS;
+    }
+    /** Map trigger events to notifications and deliver or queue them. */
+    processTriggerEvents(events) {
+        const results = [];
+        for (const event of events) {
+            const { priority, message, source } = this.mapTriggerEvent(event);
+            const notification = {
+                id: crypto.randomUUID(),
+                source,
+                priority,
+                message,
+                createdAt: Date.now(),
+                delivered: false,
+            };
+            this.hub.send({
+                source: source,
+                priority,
+                title: event.triggerId,
+                body: message,
+            });
+            this.routeNotification(notification);
+            results.push(notification);
+        }
+        return results;
+    }
+    /** Check calendar events and create notifications for those starting soon. */
+    processCalendarCheck(events, now) {
+        const currentTime = now ?? Date.now();
+        const results = [];
+        for (const event of events) {
+            const timeUntilStart = event.startTime - currentTime;
+            if (timeUntilStart > 0 && timeUntilStart <= this.calendarAlertWindowMs) {
+                const minutesUntil = Math.round(timeUntilStart / 60_000);
+                const message = `"${event.title}" starts in ${minutesUntil} minute${minutesUntil === 1 ? '' : 's'}`;
+                const notification = {
+                    id: crypto.randomUUID(),
+                    source: 'calendar',
+                    priority: 'important',
+                    message,
+                    createdAt: currentTime,
+                    delivered: false,
+                };
+                this.hub.send({
+                    source: 'calendar',
+                    priority: 'important',
+                    title: event.title,
+                    body: message,
+                });
+                this.routeNotification(notification);
+                results.push(notification);
+            }
+        }
+        return results;
+    }
+    /** Get all pending (undelivered or queued) notifications. */
+    getPending() {
+        return this.pending.filter((n) => !n.delivered);
+    }
+    /** Dismiss a pending notification by ID. Returns true if found and removed. */
+    dismiss(id) {
+        const index = this.pending.findIndex((n) => n.id === id);
+        if (index === -1)
+            return false;
+        this.pending.splice(index, 1);
+        return true;
+    }
+    mapTriggerEvent(event) {
+        switch (event.triggerId) {
+            case 'new-email': {
+                const subject = String(event.data['subject'] ?? '');
+                const from = String(event.data['from'] ?? 'unknown sender');
+                const isUrgent = URGENCY_KEYWORDS.some((kw) => subject.toLowerCase().includes(kw));
+                return {
+                    priority: isUrgent ? 'urgent' : 'important',
+                    message: `New email from ${from}: ${subject}`,
+                    source: 'email',
+                };
+            }
+            case 'event-starting-soon': {
+                const title = String(event.data['title'] ?? 'Untitled event');
+                return {
+                    priority: 'important',
+                    message: `Event starting soon: ${title}`,
+                    source: 'calendar',
+                };
+            }
+            case 'file-shared': {
+                const fileName = String(event.data['fileName'] ?? 'a file');
+                const sharedBy = String(event.data['sharedBy'] ?? 'someone');
+                return {
+                    priority: 'low',
+                    message: `${sharedBy} shared ${fileName} with you`,
+                    source: 'system',
+                };
+            }
+            default:
+                return {
+                    priority: 'low',
+                    message: `Notification from ${event.connectorId}: ${event.triggerId}`,
+                    source: 'system',
+                };
+        }
+    }
+    routeNotification(notification) {
+        const dndActive = this.dnd.isActive();
+        if (dndActive && notification.priority !== 'urgent') {
+            // Queue silently — do not deliver
+            notification.delivered = false;
+            this.pending.push(notification);
+            return;
+        }
+        // Deliver immediately
+        notification.delivered = true;
+        this.deliveryChannel(notification);
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator.js.map

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

package/dist/pattern-engine.d.ts

@@ -0,0 +1,27 @@
+import type { AmbientPattern, ObservedEvent } from './types.js';
+/**
+ * Ambient pattern engine — observes events and detects behavioral patterns
+ * using sliding window frequency analysis.
+ */
+export declare class AmbientPatternEngine {
+    private events;
+    private patterns;
+    private windowSize;
+    constructor(windowSize?: number);
+    /** Observe a new event. */
+    observe(event: ObservedEvent): void;
+    /** Run pattern detection on observed events. */
+    detectPatterns(): AmbientPattern[];
+    /** Get all detected patterns above minimum confidence. */
+    getPatterns(): AmbientPattern[];
+    /** Get a pattern by ID. */
+    getPattern(id: string): AmbientPattern | undefined;
+    /** Get the number of observed events in the window. */
+    getEventCount(): number;
+    /** Clear all events and patterns. */
+    reset(): void;
+    private detectSchedulePattern;
+    private detectFrequencyPattern;
+    private detectCorrelations;
+}
+//# sourceMappingURL=pattern-engine.d.ts.map

package/dist/pattern-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-engine.d.ts","sourceRoot":"","sources":["../src/pattern-engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAsB,aAAa,EAAE,MAAM,YAAY,CAAC;AASpF;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,CAAC,EAAE,MAAM;IAI/B,2BAA2B;IAC3B,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAOnC,gDAAgD;IAChD,cAAc,IAAI,cAAc,EAAE;IAyClC,0DAA0D;IAC1D,WAAW,IAAI,cAAc,EAAE;IAM/B,2BAA2B;IAC3B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIlD,uDAAuD;IACvD,aAAa,IAAI,MAAM;IAIvB,qCAAqC;IACrC,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,qBAAqB;IAkC7B,OAAO,CAAC,sBAAsB;IAsC9B,OAAO,CAAC,kBAAkB;CA2C3B"}

package/dist/pattern-engine.js

@@ -0,0 +1,187 @@
+import * as crypto from 'node:crypto';
+/** Sliding window size for frequency analysis. */
+const DEFAULT_WINDOW_SIZE = 7 * 24 * 60 * 60 * 1000; // 7 days
+/** Minimum occurrences to consider something a pattern. */
+const MIN_OCCURRENCES = 3;
+/** Minimum confidence to emit a pattern. */
+const MIN_CONFIDENCE = 0.3;
+/**
+ * Ambient pattern engine — observes events and detects behavioral patterns
+ * using sliding window frequency analysis.
+ */
+export class AmbientPatternEngine {
+    events = [];
+    patterns = new Map();
+    windowSize;
+    constructor(windowSize) {
+        this.windowSize = windowSize ?? DEFAULT_WINDOW_SIZE;
+    }
+    /** Observe a new event. */
+    observe(event) {
+        this.events.push(event);
+        // Prune events outside the window
+        const cutoff = Date.now() - this.windowSize;
+        this.events = this.events.filter(e => e.timestamp >= cutoff);
+    }
+    /** Run pattern detection on observed events. */
+    detectPatterns() {
+        const detected = [];
+        // Group events by type
+        const byType = new Map();
+        for (const event of this.events) {
+            const existing = byType.get(event.type) ?? [];
+            existing.push(event);
+            byType.set(event.type, existing);
+        }
+        // Detect schedule patterns (recurring events at similar times)
+        for (const [type, events] of byType) {
+            if (events.length >= MIN_OCCURRENCES) {
+                const schedulePattern = this.detectSchedulePattern(type, events);
+                if (schedulePattern)
+                    detected.push(schedulePattern);
+                const frequencyPattern = this.detectFrequencyPattern(type, events);
+                if (frequencyPattern)
+                    detected.push(frequencyPattern);
+            }
+        }
+        // Detect correlations between event types
+        const correlations = this.detectCorrelations(byType);
+        detected.push(...correlations);
+        // Update stored patterns
+        for (const pattern of detected) {
+            const existing = this.patterns.get(pattern.id);
+            if (existing) {
+                existing.lastConfirmedAt = Date.now();
+                existing.occurrences++;
+                existing.confidence = Math.min(1, existing.confidence + 0.05);
+            }
+            else {
+                this.patterns.set(pattern.id, pattern);
+            }
+        }
+        return detected;
+    }
+    /** Get all detected patterns above minimum confidence. */
+    getPatterns() {
+        return Array.from(this.patterns.values())
+            .filter(p => p.confidence >= MIN_CONFIDENCE)
+            .sort((a, b) => b.confidence - a.confidence);
+    }
+    /** Get a pattern by ID. */
+    getPattern(id) {
+        return this.patterns.get(id);
+    }
+    /** Get the number of observed events in the window. */
+    getEventCount() {
+        return this.events.length;
+    }
+    /** Clear all events and patterns. */
+    reset() {
+        this.events = [];
+        this.patterns.clear();
+    }
+    detectSchedulePattern(type, events) {
+        // Check if events happen at similar hours of the day
+        const hours = events.map(e => new Date(e.timestamp).getHours());
+        const hourCounts = new Map();
+        for (const h of hours) {
+            hourCounts.set(h, (hourCounts.get(h) ?? 0) + 1);
+        }
+        // Find the most common hour
+        let maxHour = 0;
+        let maxCount = 0;
+        for (const [hour, count] of hourCounts) {
+            if (count > maxCount) {
+                maxHour = hour;
+                maxCount = count;
+            }
+        }
+        const ratio = maxCount / events.length;
+        if (ratio < 0.5 || maxCount < MIN_OCCURRENCES)
+            return null;
+        const id = crypto.randomUUID();
+        return {
+            id,
+            type: 'schedule',
+            description: `"${type}" events frequently occur around ${maxHour}:00`,
+            confidence: Math.min(1, ratio * 0.8 + (maxCount / 10) * 0.2),
+            evidence: events.slice(-3).map(e => `${type} at ${new Date(e.timestamp).toISOString()}`),
+            detectedAt: Date.now(),
+            lastConfirmedAt: Date.now(),
+            occurrences: maxCount,
+        };
+    }
+    detectFrequencyPattern(type, events) {
+        if (events.length < MIN_OCCURRENCES)
+            return null;
+        // Calculate average interval between events
+        const sorted = [...events].sort((a, b) => a.timestamp - b.timestamp);
+        const intervals = [];
+        for (let i = 1; i < sorted.length; i++) {
+            intervals.push(sorted[i].timestamp - sorted[i - 1].timestamp);
+        }
+        if (intervals.length === 0)
+            return null;
+        const avgInterval = intervals.reduce((a, b) => a + b, 0) / intervals.length;
+        const stdDev = Math.sqrt(intervals.reduce((sum, iv) => sum + (iv - avgInterval) ** 2, 0) / intervals.length);
+        // Low variance means regular frequency
+        const cv = avgInterval > 0 ? stdDev / avgInterval : Infinity;
+        if (cv > 0.5)
+            return null; // Too irregular
+        const confidence = Math.min(1, 1 - cv);
+        if (confidence < MIN_CONFIDENCE)
+            return null;
+        const hours = Math.round(avgInterval / (60 * 60 * 1000) * 10) / 10;
+        const id = crypto.randomUUID();
+        return {
+            id,
+            type: 'preference',
+            description: `"${type}" occurs roughly every ${hours} hours`,
+            confidence,
+            evidence: [`${events.length} occurrences over window`, `Average interval: ${hours}h`],
+            detectedAt: Date.now(),
+            lastConfirmedAt: Date.now(),
+            occurrences: events.length,
+        };
+    }
+    detectCorrelations(byType) {
+        const patterns = [];
+        const types = Array.from(byType.keys());
+        // Check pairs of event types for temporal correlation
+        for (let i = 0; i < types.length; i++) {
+            for (let j = i + 1; j < types.length; j++) {
+                const eventsA = byType.get(types[i]);
+                const eventsB = byType.get(types[j]);
+                if (eventsA.length < 2 || eventsB.length < 2)
+                    continue;
+                // Count how often B follows A within 5 minutes
+                const followWindow = 5 * 60 * 1000;
+                let follows = 0;
+                for (const a of eventsA) {
+                    for (const b of eventsB) {
+                        if (b.timestamp > a.timestamp && b.timestamp - a.timestamp <= followWindow) {
+                            follows++;
+                            break;
+                        }
+                    }
+                }
+                const followRatio = follows / eventsA.length;
+                if (followRatio >= 0.5 && follows >= 2) {
+                    const id = crypto.randomUUID();
+                    patterns.push({
+                        id,
+                        type: 'correlation',
+                        description: `"${types[j]}" often follows "${types[i]}" within 5 minutes`,
+                        confidence: Math.min(1, followRatio * 0.9),
+                        evidence: [`${follows} of ${eventsA.length} "${types[i]}" events followed by "${types[j]}"`],
+                        detectedAt: Date.now(),
+                        lastConfirmedAt: Date.now(),
+                        occurrences: follows,
+                    });
+                }
+            }
+        }
+        return patterns;
+    }
+}
+//# sourceMappingURL=pattern-engine.js.map

package/dist/pattern-engine.js.map

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

package/dist/scheduler.d.ts

@@ -0,0 +1,88 @@
+import type { Scheduler } from '@auxiora/behaviors';
+import type { ConnectorRegistry, TriggerManager } from '@auxiora/connectors';
+import type { BriefingGenerator } from './briefing.js';
+import type { NotificationOrchestrator } from './orchestrator.js';
+/** Configuration for the ambient scheduler. */
+export interface AmbientSchedulerConfig {
+    /** Cron expression for morning briefing. */
+    morningCron: string;
+    /** Cron expression for evening summary. */
+    eveningCron: string;
+    /** Cron expression for email polling. */
+    emailPollCron: string;
+    /** Cron expression for calendar polling. */
+    calendarPollCron: string;
+    /** Cron expression for notification polling. */
+    notificationPollCron: string;
+    /** Calendar alert window in minutes. */
+    calendarAlertMinutes: number;
+    /** Whether the scheduler is enabled. */
+    enabled: boolean;
+    /** Categories to include in briefings. */
+    categories: string[];
+}
+export declare const DEFAULT_AMBIENT_SCHEDULER_CONFIG: AmbientSchedulerConfig;
+/** Dependencies for the ambient scheduler. */
+export interface AmbientSchedulerDeps {
+    scheduler: Scheduler;
+    connectorRegistry: ConnectorRegistry;
+    triggerManager: TriggerManager;
+    briefingGenerator: BriefingGenerator;
+    emailIntelligence?: {
+        triage?: {
+            getTriageSummary(opts: {
+                maxResults: number;
+            }): Promise<{
+                items: Array<{
+                    subject: string;
+                    priority: string;
+                }>;
+            }>;
+        };
+    };
+    calendarIntelligence?: {
+        analyzeDay(date: string): Promise<{
+            events: Array<{
+                title: string;
+                time: string;
+            }>;
+        }>;
+    };
+    notificationOrchestrator?: NotificationOrchestrator;
+    deliveryChannel: (message: string) => Promise<void>;
+    userId: string;
+    config?: Partial<AmbientSchedulerConfig>;
+}
+/**
+ * Schedules ambient polling and briefing generation using cron jobs.
+ */
+export declare class AmbientScheduler {
+    private readonly scheduler;
+    private readonly connectorRegistry;
+    private readonly triggerManager;
+    private readonly briefingGenerator;
+    private readonly emailIntelligence;
+    private readonly calendarIntelligence;
+    private readonly notificationOrchestrator;
+    private readonly deliveryChannel;
+    private readonly userId;
+    private readonly config;
+    private running;
+    constructor(deps: AmbientSchedulerDeps);
+    /** Start all scheduled cron jobs. */
+    start(): void;
+    /** Stop all scheduled cron jobs. */
+    stop(): void;
+    /** Whether the scheduler is currently running. */
+    isRunning(): boolean;
+    /** Get the current configuration. */
+    getConfig(): AmbientSchedulerConfig;
+    /** Generate and deliver a briefing for the specified time of day. */
+    generateAndDeliverBriefing(time: 'morning' | 'evening'): Promise<void>;
+    private pollAndNotify;
+    private parseTimeToTimestamp;
+    private pollCalendar;
+    private fetchCalendarEvents;
+    private fetchEmailSummary;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

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