@auxiora/ambient 1.0.0

package/dist/scheduler.js

@@ -0,0 +1,172 @@
+import { formatBriefingAsText } from './briefing.js';
+export const DEFAULT_AMBIENT_SCHEDULER_CONFIG = {
+    morningCron: '0 7 * * *',
+    eveningCron: '0 18 * * *',
+    emailPollCron: '*/2 * * * *',
+    calendarPollCron: '*/5 * * * *',
+    notificationPollCron: '*/1 * * * *',
+    calendarAlertMinutes: 15,
+    enabled: true,
+    categories: ['calendar', 'email', 'tasks'],
+};
+const JOB_IDS = {
+    emailPoll: 'ambient:email-poll',
+    calendarPoll: 'ambient:calendar-poll',
+    morningBriefing: 'ambient:morning-briefing',
+    eveningSummary: 'ambient:evening-summary',
+    notificationPoll: 'ambient:notification-poll',
+};
+/**
+ * Schedules ambient polling and briefing generation using cron jobs.
+ */
+export class AmbientScheduler {
+    scheduler;
+    connectorRegistry;
+    triggerManager;
+    briefingGenerator;
+    emailIntelligence;
+    calendarIntelligence;
+    notificationOrchestrator;
+    deliveryChannel;
+    userId;
+    config;
+    running = false;
+    constructor(deps) {
+        this.scheduler = deps.scheduler;
+        this.connectorRegistry = deps.connectorRegistry;
+        this.triggerManager = deps.triggerManager;
+        this.briefingGenerator = deps.briefingGenerator;
+        this.emailIntelligence = deps.emailIntelligence;
+        this.calendarIntelligence = deps.calendarIntelligence;
+        this.notificationOrchestrator = deps.notificationOrchestrator;
+        this.deliveryChannel = deps.deliveryChannel;
+        this.userId = deps.userId;
+        this.config = { ...DEFAULT_AMBIENT_SCHEDULER_CONFIG, ...deps.config };
+    }
+    /** Start all scheduled cron jobs. */
+    start() {
+        if (!this.config.enabled || this.running)
+            return;
+        this.scheduler.schedule(JOB_IDS.emailPoll, this.config.emailPollCron, () => {
+            void this.triggerManager.pollAll();
+        });
+        this.scheduler.schedule(JOB_IDS.calendarPoll, this.config.calendarPollCron, () => {
+            void this.pollCalendar();
+        });
+        this.scheduler.schedule(JOB_IDS.morningBriefing, this.config.morningCron, () => {
+            void this.generateAndDeliverBriefing('morning');
+        });
+        this.scheduler.schedule(JOB_IDS.eveningSummary, this.config.eveningCron, () => {
+            void this.generateAndDeliverBriefing('evening');
+        });
+        this.scheduler.schedule(JOB_IDS.notificationPoll, this.config.notificationPollCron, () => {
+            void this.pollAndNotify();
+        });
+        this.running = true;
+    }
+    /** Stop all scheduled cron jobs. */
+    stop() {
+        this.scheduler.stop(JOB_IDS.emailPoll);
+        this.scheduler.stop(JOB_IDS.calendarPoll);
+        this.scheduler.stop(JOB_IDS.morningBriefing);
+        this.scheduler.stop(JOB_IDS.eveningSummary);
+        this.scheduler.stop(JOB_IDS.notificationPoll);
+        this.running = false;
+    }
+    /** Whether the scheduler is currently running. */
+    isRunning() {
+        return this.running;
+    }
+    /** Get the current configuration. */
+    getConfig() {
+        return { ...this.config };
+    }
+    /** Generate and deliver a briefing for the specified time of day. */
+    async generateAndDeliverBriefing(time) {
+        const calendarEvents = await this.fetchCalendarEvents(time);
+        const emailNotifications = await this.fetchEmailSummary();
+        const briefing = this.briefingGenerator.generateBriefing(this.userId, time, {
+            calendarEvents,
+            notifications: emailNotifications,
+        });
+        const formatted = formatBriefingAsText(briefing);
+        await this.deliveryChannel(formatted);
+    }
+    async pollAndNotify() {
+        if (!this.notificationOrchestrator)
+            return;
+        const events = await this.triggerManager.pollAll();
+        if (events.length > 0) {
+            this.notificationOrchestrator.processTriggerEvents(events);
+        }
+        // Check for upcoming calendar events
+        if (this.calendarIntelligence) {
+            try {
+                const today = new Date().toISOString().split('T')[0];
+                const result = await this.calendarIntelligence.analyzeDay(today);
+                const now = Date.now();
+                const alertWindowMs = this.config.calendarAlertMinutes * 60_000;
+                const upcomingEvents = (result.events ?? [])
+                    .map((e) => ({
+                    title: e.title,
+                    startTime: this.parseTimeToTimestamp(e.time),
+                }))
+                    .filter((e) => {
+                    const timeUntil = e.startTime - now;
+                    return timeUntil > 0 && timeUntil <= alertWindowMs;
+                });
+                if (upcomingEvents.length > 0) {
+                    this.notificationOrchestrator.processCalendarCheck(upcomingEvents, now);
+                }
+            }
+            catch {
+                // Calendar fetch errors are silently ignored
+            }
+        }
+    }
+    parseTimeToTimestamp(time) {
+        const [hours, minutes] = time.split(':').map(Number);
+        const d = new Date();
+        d.setHours(hours ?? 0, minutes ?? 0, 0, 0);
+        return d.getTime();
+    }
+    async pollCalendar() {
+        if (!this.calendarIntelligence)
+            return;
+        const today = new Date().toISOString().split('T')[0];
+        await this.calendarIntelligence.analyzeDay(today);
+    }
+    async fetchCalendarEvents(time) {
+        if (!this.calendarIntelligence)
+            return [];
+        const targetDate = time === 'evening'
+            ? new Date(Date.now() + 86_400_000).toISOString().split('T')[0]
+            : new Date().toISOString().split('T')[0];
+        try {
+            const result = await this.calendarIntelligence.analyzeDay(targetDate);
+            return result.events ?? [];
+        }
+        catch {
+            return [];
+        }
+    }
+    async fetchEmailSummary() {
+        if (!this.emailIntelligence?.triage)
+            return [];
+        try {
+            const result = await this.emailIntelligence.triage.getTriageSummary({ maxResults: 10 });
+            return (result.items ?? []).map((item, i) => ({
+                id: `email-${i}`,
+                priority: item.priority === 'urgent' ? 'alert' : 'nudge',
+                message: item.subject,
+                createdAt: Date.now(),
+                dismissed: false,
+                source: 'email',
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,73 @@
+/** Types of patterns the ambient engine can detect. */
+export type AmbientPatternType = 'schedule' | 'preference' | 'trigger' | 'correlation';
+/** Notification priority levels for quiet notifications. */
+export type NotificationPriority = 'whisper' | 'nudge' | 'alert';
+/** A detected ambient pattern from user behavior. */
+export interface AmbientPattern {
+    id: string;
+    /** Pattern type. */
+    type: AmbientPatternType;
+    /** Human-readable description. */
+    description: string;
+    /** Confidence score (0-1). */
+    confidence: number;
+    /** Evidence supporting this pattern. */
+    evidence: string[];
+    /** When the pattern was first detected. */
+    detectedAt: number;
+    /** When the pattern was last confirmed. */
+    lastConfirmedAt: number;
+    /** Number of times this pattern has been observed. */
+    occurrences: number;
+}
+/** An anticipated user need based on detected patterns. */
+export interface Anticipation {
+    id: string;
+    /** What the user might need. */
+    description: string;
+    /** When this need is expected. */
+    expectedAt: number;
+    /** Confidence that this anticipation is correct (0-1). */
+    confidence: number;
+    /** Patterns that led to this anticipation. */
+    sourcePatterns: string[];
+    /** Suggested action to fulfill the need. */
+    suggestedAction?: string;
+}
+/** A quiet notification queued for the user. */
+export interface QuietNotification {
+    id: string;
+    /** Priority level. */
+    priority: NotificationPriority;
+    /** Notification message. */
+    message: string;
+    /** Detailed content (optional). */
+    detail?: string;
+    /** When the notification was created. */
+    createdAt: number;
+    /** Whether the notification has been dismissed. */
+    dismissed: boolean;
+    /** Source of the notification. */
+    source: string;
+}
+/** Configuration for personalized briefings. */
+export interface BriefingConfig {
+    /** Whether briefings are enabled. */
+    enabled: boolean;
+    /** Time of day for morning briefing (HH:MM). */
+    morningTime: string;
+    /** Time of day for evening summary (HH:MM). */
+    eveningTime: string;
+    /** Categories to include in briefings. */
+    categories: string[];
+    /** Maximum number of items per section. */
+    maxItemsPerSection: number;
+}
+export declare const DEFAULT_BRIEFING_CONFIG: BriefingConfig;
+/** An observed event for the pattern engine. */
+export interface ObservedEvent {
+    type: string;
+    timestamp: number;
+    data?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,aAAa,CAAC;AAEvF,4DAA4D;AAC5D,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAEjE,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2CAA2C;IAC3C,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,uBAAuB,EAAE,cAMrC,CAAC;AAEF,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC"}

package/dist/types.js

@@ -0,0 +1,8 @@
+export const DEFAULT_BRIEFING_CONFIG = {
+    enabled: true,
+    morningTime: '08:00',
+    eveningTime: '20:00',
+    categories: ['calendar', 'tasks', 'weather', 'news', 'patterns'],
+    maxItemsPerSection: 5,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAuEA,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,OAAO;IACpB,WAAW,EAAE,OAAO;IACpB,UAAU,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC;IAChE,kBAAkB,EAAE,CAAC;CACtB,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@auxiora/ambient",
+  "version": "1.0.0",
+  "description": "Ambient pattern detection, anticipation, briefings, and quiet notifications",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@auxiora/memory": "1.0.0",
+    "@auxiora/behaviors": "1.0.0",
+    "@auxiora/personality": "1.0.0",
+    "@auxiora/notification-hub": "1.0.0",
+    "@auxiora/connectors": "1.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/anticipation.ts

@@ -0,0 +1,141 @@
+import * as crypto from 'node:crypto';
+import type { AmbientPattern, Anticipation } from './types.js';
+
+/**
+ * Anticipation engine — predicts user needs based on detected patterns.
+ */
+export class AnticipationEngine {
+  private anticipations: Map<string, Anticipation> = new Map();
+
+  /**
+   * Generate anticipations from detected patterns and current context.
+   * @param patterns - Currently detected patterns.
+   * @param context - Current context (time, active tasks, etc.).
+   */
+  generateAnticipations(
+    patterns: AmbientPattern[],
+    context?: { currentTime?: number; activeTaskCount?: number }
+  ): Anticipation[] {
+    const now = context?.currentTime ?? Date.now();
+    const generated: Anticipation[] = [];
+
+    for (const pattern of patterns) {
+      if (pattern.confidence < 0.4) continue;
+
+      switch (pattern.type) {
+        case 'schedule': {
+          const anticipation = this.anticipateSchedule(pattern, now);
+          if (anticipation) generated.push(anticipation);
+          break;
+        }
+        case 'preference': {
+          const anticipation = this.anticipatePreference(pattern, now);
+          if (anticipation) generated.push(anticipation);
+          break;
+        }
+        case 'correlation': {
+          const anticipation = this.anticipateCorrelation(pattern, now);
+          if (anticipation) generated.push(anticipation);
+          break;
+        }
+        case 'trigger': {
+          const anticipation = this.anticipateTrigger(pattern, now);
+          if (anticipation) generated.push(anticipation);
+          break;
+        }
+      }
+    }
+
+    // Store generated anticipations
+    for (const a of generated) {
+      this.anticipations.set(a.id, a);
+    }
+
+    return generated;
+  }
+
+  /** Get all current anticipations sorted by expected time. */
+  getAnticipations(): Anticipation[] {
+    return Array.from(this.anticipations.values())
+      .filter(a => a.expectedAt > Date.now())
+      .sort((a, b) => a.expectedAt - b.expectedAt);
+  }
+
+  /** Clear expired anticipations. */
+  prune(): number {
+    const now = Date.now();
+    let pruned = 0;
+    for (const [id, a] of this.anticipations) {
+      if (a.expectedAt < now) {
+        this.anticipations.delete(id);
+        pruned++;
+      }
+    }
+    return pruned;
+  }
+
+  /** Reset all anticipations. */
+  reset(): void {
+    this.anticipations.clear();
+  }
+
+  private anticipateSchedule(pattern: AmbientPattern, now: number): Anticipation | null {
+    // Extract hour from description like '... around 14:00'
+    const match = pattern.description.match(/around (\d+):00/);
+    if (!match) return null;
+
+    const hour = parseInt(match[1], 10);
+    const nextOccurrence = new Date(now);
+    nextOccurrence.setHours(hour, 0, 0, 0);
+    if (nextOccurrence.getTime() <= now) {
+      nextOccurrence.setDate(nextOccurrence.getDate() + 1);
+    }
+
+    return {
+      id: crypto.randomUUID(),
+      description: `Based on your pattern: ${pattern.description}`,
+      expectedAt: nextOccurrence.getTime(),
+      confidence: pattern.confidence * 0.8,
+      sourcePatterns: [pattern.id],
+      suggestedAction: `Prepare for upcoming "${pattern.description.split('"')[1]}" activity`,
+    };
+  }
+
+  private anticipatePreference(pattern: AmbientPattern, now: number): Anticipation | null {
+    // Extract interval from description like 'every 2.5 hours'
+    const match = pattern.description.match(/every ([\d.]+) hours/);
+    if (!match) return null;
+
+    const intervalHours = parseFloat(match[1]);
+    const expectedAt = now + intervalHours * 60 * 60 * 1000;
+
+    return {
+      id: crypto.randomUUID(),
+      description: `You typically do this every ${intervalHours} hours`,
+      expectedAt,
+      confidence: pattern.confidence * 0.7,
+      sourcePatterns: [pattern.id],
+    };
+  }
+
+  private anticipateCorrelation(pattern: AmbientPattern, now: number): Anticipation | null {
+    return {
+      id: crypto.randomUUID(),
+      description: `When this happens: ${pattern.description}`,
+      expectedAt: now + 5 * 60 * 1000, // 5 minutes from now
+      confidence: pattern.confidence * 0.6,
+      sourcePatterns: [pattern.id],
+      suggestedAction: `Proactively prepare the follow-up action`,
+    };
+  }
+
+  private anticipateTrigger(pattern: AmbientPattern, now: number): Anticipation | null {
+    return {
+      id: crypto.randomUUID(),
+      description: `Trigger detected: ${pattern.description}`,
+      expectedAt: now + 60 * 1000, // 1 minute
+      confidence: pattern.confidence * 0.9,
+      sourcePatterns: [pattern.id],
+    };
+  }
+}

package/src/briefing.ts

@@ -0,0 +1,152 @@
+import type { AmbientPattern, Anticipation, BriefingConfig, QuietNotification } from './types.js';
+import { DEFAULT_BRIEFING_CONFIG } from './types.js';
+
+/** A compiled briefing for the user. */
+export interface Briefing {
+  userId: string;
+  generatedAt: number;
+  timeOfDay: 'morning' | 'evening' | 'custom';
+  sections: BriefingSection[];
+}
+
+/** A section of a briefing. */
+export interface BriefingSection {
+  title: string;
+  items: string[];
+}
+
+/** Data sources for briefing generation. */
+export interface BriefingDataSources {
+  patterns?: AmbientPattern[];
+  anticipations?: Anticipation[];
+  notifications?: QuietNotification[];
+  calendarEvents?: Array<{ title: string; time: string }>;
+  tasks?: Array<{ title: string; status: string }>;
+}
+
+/**
+ * Generates personalized briefings/digests for users.
+ */
+export class BriefingGenerator {
+  private config: BriefingConfig;
+
+  constructor(config?: Partial<BriefingConfig>) {
+    this.config = { ...DEFAULT_BRIEFING_CONFIG, ...config };
+  }
+
+  /** Generate a briefing for the given user at the given time. */
+  generateBriefing(
+    userId: string,
+    time: 'morning' | 'evening' | 'custom',
+    sources: BriefingDataSources
+  ): Briefing {
+    const sections: BriefingSection[] = [];
+
+    // Notifications section
+    if (sources.notifications && sources.notifications.length > 0) {
+      const pending = sources.notifications.filter(n => !n.dismissed);
+      if (pending.length > 0) {
+        sections.push({
+          title: 'Notifications',
+          items: pending.slice(0, this.config.maxItemsPerSection).map(
+            n => `[${n.priority}] ${n.message}`
+          ),
+        });
+      }
+    }
+
+    // Calendar section
+    if (this.config.categories.includes('calendar') && sources.calendarEvents) {
+      const events = sources.calendarEvents.slice(0, this.config.maxItemsPerSection);
+      if (events.length > 0) {
+        sections.push({
+          title: time === 'morning' ? 'Today\'s Schedule' : 'Tomorrow\'s Schedule',
+          items: events.map(e => `${e.time} - ${e.title}`),
+        });
+      }
+    }
+
+    // Tasks section
+    if (this.config.categories.includes('tasks') && sources.tasks) {
+      const activeTasks = sources.tasks
+        .filter(t => t.status !== 'completed')
+        .slice(0, this.config.maxItemsPerSection);
+      if (activeTasks.length > 0) {
+        sections.push({
+          title: 'Active Tasks',
+          items: activeTasks.map(t => `${t.title} (${t.status})`),
+        });
+      }
+    }
+
+    // Patterns section
+    if (this.config.categories.includes('patterns') && sources.patterns) {
+      const topPatterns = sources.patterns
+        .filter(p => p.confidence >= 0.5)
+        .slice(0, this.config.maxItemsPerSection);
+      if (topPatterns.length > 0) {
+        sections.push({
+          title: 'Observed Patterns',
+          items: topPatterns.map(p => `${p.description} (${Math.round(p.confidence * 100)}% confidence)`),
+        });
+      }
+    }
+
+    // Anticipations section
+    if (sources.anticipations && sources.anticipations.length > 0) {
+      const upcoming = sources.anticipations
+        .filter(a => a.expectedAt > Date.now())
+        .slice(0, this.config.maxItemsPerSection);
+      if (upcoming.length > 0) {
+        sections.push({
+          title: 'Upcoming',
+          items: upcoming.map(a => {
+            const timeStr = new Date(a.expectedAt).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+            return `~${timeStr}: ${a.description}`;
+          }),
+        });
+      }
+    }
+
+    return {
+      userId,
+      generatedAt: Date.now(),
+      timeOfDay: time,
+      sections,
+    };
+  }
+
+  /** Check if it's time for a briefing. */
+  isBriefingTime(time: 'morning' | 'evening'): boolean {
+    if (!this.config.enabled) return false;
+    const now = new Date();
+    const currentTime = `${String(now.getHours()).padStart(2, '0')}:${String(now.getMinutes()).padStart(2, '0')}`;
+    const target = time === 'morning' ? this.config.morningTime : this.config.eveningTime;
+    return currentTime === target;
+  }
+
+  /** Get config. */
+  getConfig(): BriefingConfig {
+    return { ...this.config };
+  }
+}
+
+/** Format a briefing as human-readable text. */
+export function formatBriefingAsText(briefing: Briefing): string {
+  const greeting = briefing.timeOfDay === 'morning'
+    ? 'Good morning! Here\'s your day:'
+    : briefing.timeOfDay === 'evening'
+      ? 'Here\'s your evening summary:'
+      : 'Here\'s your briefing:';
+
+  if (briefing.sections.length === 0) {
+    return `${greeting}\n\nNo updates right now.`;
+  }
+
+  const sections = briefing.sections.map(s => {
+    const items = s.items.map(item => `  ${item}`).join('\n');
+    return `${s.title}\n${items}`;
+  }).join('\n\n');
+
+  return `${greeting}\n\n${sections}`;
+}

package/src/index.ts

@@ -0,0 +1,26 @@
+export type {
+  AmbientPattern,
+  AmbientPatternType,
+  Anticipation,
+  QuietNotification,
+  NotificationPriority,
+  BriefingConfig,
+  ObservedEvent,
+} from './types.js';
+export { DEFAULT_BRIEFING_CONFIG } from './types.js';
+export { AmbientPatternEngine } from './pattern-engine.js';
+export { AnticipationEngine } from './anticipation.js';
+export { BriefingGenerator, formatBriefingAsText, type Briefing, type BriefingSection, type BriefingDataSources } from './briefing.js';
+export { QuietNotificationManager } from './notification.js';
+export {
+  AmbientScheduler,
+  DEFAULT_AMBIENT_SCHEDULER_CONFIG,
+  type AmbientSchedulerConfig,
+  type AmbientSchedulerDeps,
+} from './scheduler.js';
+export {
+  NotificationOrchestrator,
+  type OrchestratorConfig,
+  type OrchestratorNotification,
+  type DeliveryChannelFn,
+} from './orchestrator.js';