@runcore-sh/runcore 0.1.2

package/dist/cache/llm-cache.d.ts

@@ -0,0 +1,70 @@
+/**
+ * High-level LLM response cache orchestrator.
+ *
+ * Configures file-backed persistence in .core/cache/, records hit/miss
+ * metrics, and provides cache-warming utilities. Call `initLLMCache()`
+ * once at boot (after settings are loaded) and `shutdownLLMCache()`
+ * during graceful shutdown.
+ */
+import type { MetricsStore } from "../metrics/store.js";
+import type { CompleteChatOptions } from "../llm/complete.js";
+export interface LLMCacheOptions {
+    /** Project root directory (for resolving .core/cache/). */
+    projectRoot?: string;
+    /** Memory cache TTL in ms. Default: 1 hour. */
+    memoryTTLMs?: number;
+    /** File cache TTL in ms. Default: 1 hour. */
+    fileTTLMs?: number;
+    /** Max in-memory entries. Default: 512. */
+    memoryMaxSize?: number;
+    /** Max file-backed entries. Default: 2048. */
+    fileMaxSize?: number;
+    /** Debounce interval for file writes in ms. Default: 3000. */
+    writeDebounceMs?: number;
+    /** MetricsStore instance for recording cache metrics. */
+    metrics?: MetricsStore;
+}
+/**
+ * Configure and initialize the LLM response cache with file persistence.
+ * Call once during boot, after settings are loaded.
+ */
+export declare function initLLMCache(options?: LLMCacheOptions): Promise<void>;
+/**
+ * Flush pending writes and stop metrics timer. Call during graceful shutdown.
+ */
+export declare function shutdownLLMCache(): Promise<void>;
+export interface WarmEntry {
+    /** The CompleteChatOptions that would generate this cache key. */
+    options: CompleteChatOptions;
+    /** The known-good response to pre-populate. */
+    response: string;
+    /** Optional TTL override in ms. */
+    ttlMs?: number;
+}
+/**
+ * Pre-populate the cache with known prompt/response pairs.
+ * Useful for common system prompts or frequently-used templates.
+ */
+export declare function warmCache(entries: WarmEntry[]): number;
+export interface CacheDiagnostics {
+    enabled: boolean;
+    memoryEntries: number;
+    memoryMaxSize: number;
+    hits: number;
+    misses: number;
+    evictions: number;
+    hitRate: string;
+}
+/** Return a snapshot of cache health for dashboards or /api/health. */
+export declare function getCacheDiagnostics(): CacheDiagnostics;
+/**
+ * Invalidate all cached entries. Resets statistics.
+ * Use sparingly — prefer natural TTL expiry.
+ */
+export { clearCache as invalidateAll } from "../llm/cache.js";
+/**
+ * Invalidate a specific cache entry by its options.
+ * Returns true if the entry existed and was removed.
+ */
+export declare function invalidateEntry(options: CompleteChatOptions): boolean;
+//# sourceMappingURL=llm-cache.d.ts.map

package/dist/cache/llm-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-cache.d.ts","sourceRoot":"","sources":["../../src/cache/llm-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAsB9D,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAID;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC/E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQtD;AA0DD,MAAM,WAAW,SAAS;IACxB,kEAAkE;IAClE,OAAO,EAAE,mBAAmB,CAAC;IAC7B,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CActD;AAID,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,IAAI,gBAAgB,CAYtD;AAED;;;GAGG;AACH,OAAO,EAAE,UAAU,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAGrE"}

package/dist/cache/llm-cache.js

@@ -0,0 +1,165 @@
+/**
+ * High-level LLM response cache orchestrator.
+ *
+ * Configures file-backed persistence in .core/cache/, records hit/miss
+ * metrics, and provides cache-warming utilities. Call `initLLMCache()`
+ * once at boot (after settings are loaded) and `shutdownLLMCache()`
+ * during graceful shutdown.
+ */
+import { join } from "node:path";
+import { configureCache, initCache, getCacheInstance, getCacheStats } from "../llm/cache.js";
+import { createLogger } from "../utils/logger.js";
+import { generateCacheKey, cacheGet, cacheSet } from "../llm/cache.js";
+const log = createLogger("llm-cache");
+// ── Defaults ──────────────────────────────────────────────────────────────────
+const DEFAULT_MEMORY_TTL_MS = 60 * 60 * 1000; // 1 hour
+const DEFAULT_FILE_TTL_MS = 60 * 60 * 1000; // 1 hour
+const DEFAULT_MEMORY_MAX_SIZE = 512;
+const DEFAULT_FILE_MAX_SIZE = 2048;
+const DEFAULT_WRITE_DEBOUNCE_MS = 3000;
+const METRICS_FLUSH_INTERVAL_MS = 60 * 1000; // Log metrics every 60s
+// ── State ─────────────────────────────────────────────────────────────────────
+let metricsStore = null;
+let metricsTimer = null;
+let lastStats = { hits: 0, misses: 0, evictions: 0 };
+// ── Lifecycle ─────────────────────────────────────────────────────────────────
+/**
+ * Configure and initialize the LLM response cache with file persistence.
+ * Call once during boot, after settings are loaded.
+ */
+export async function initLLMCache(options = {}) {
+    const projectRoot = options.projectRoot ?? process.cwd();
+    const cacheFilePath = join(projectRoot, ".core", "cache", "llm-responses.json");
+    configureCache({
+        enabled: true,
+        memory: {
+            maxSize: options.memoryMaxSize ?? DEFAULT_MEMORY_MAX_SIZE,
+            defaultTTLMs: options.memoryTTLMs ?? DEFAULT_MEMORY_TTL_MS,
+        },
+        file: {
+            filePath: cacheFilePath,
+            maxSize: options.fileMaxSize ?? DEFAULT_FILE_MAX_SIZE,
+            defaultTTLMs: options.fileTTLMs ?? DEFAULT_FILE_TTL_MS,
+            writeDebounceMs: options.writeDebounceMs ?? DEFAULT_WRITE_DEBOUNCE_MS,
+        },
+    });
+    await initCache();
+    // Set up metrics recording
+    if (options.metrics) {
+        metricsStore = options.metrics;
+        startMetricsFlush();
+    }
+    const stats = getCacheStats();
+    log.info("LLM cache initialized", {
+        cacheFile: cacheFilePath,
+        memoryMaxSize: options.memoryMaxSize ?? DEFAULT_MEMORY_MAX_SIZE,
+        fileMaxSize: options.fileMaxSize ?? DEFAULT_FILE_MAX_SIZE,
+        ttlMs: options.memoryTTLMs ?? DEFAULT_MEMORY_TTL_MS,
+        existingEntries: stats.size,
+    });
+}
+/**
+ * Flush pending writes and stop metrics timer. Call during graceful shutdown.
+ */
+export async function shutdownLLMCache() {
+    stopMetricsFlush();
+    // Flush any final metrics
+    await flushMetrics();
+    const cache = getCacheInstance();
+    await cache.dispose();
+    log.info("LLM cache shut down");
+}
+// ── Metrics ───────────────────────────────────────────────────────────────────
+/**
+ * Record cache hit/miss/eviction deltas to the MetricsStore.
+ * Called periodically by the flush timer.
+ */
+async function flushMetrics() {
+    if (!metricsStore)
+        return;
+    const stats = getCacheStats();
+    const now = new Date().toISOString();
+    const deltaHits = stats.hits - lastStats.hits;
+    const deltaMisses = stats.misses - lastStats.misses;
+    const deltaEvictions = stats.evictions - lastStats.evictions;
+    // Only record if there's been activity
+    if (deltaHits > 0 || deltaMisses > 0 || deltaEvictions > 0) {
+        await metricsStore.recordBatch([
+            { timestamp: now, name: "llm.cache.hits", value: deltaHits, unit: "count", tags: { layer: "memory" } },
+            { timestamp: now, name: "llm.cache.misses", value: deltaMisses, unit: "count", tags: { layer: "memory" } },
+            { timestamp: now, name: "llm.cache.evictions", value: deltaEvictions, unit: "count", tags: { layer: "memory" } },
+            { timestamp: now, name: "llm.cache.size", value: stats.size, unit: "count" },
+            { timestamp: now, name: "llm.cache.hit_rate", value: Math.round(stats.hitRate * 100), unit: "%" },
+        ]);
+        log.debug("cache metrics flushed", {
+            hits: deltaHits,
+            misses: deltaMisses,
+            evictions: deltaEvictions,
+            size: stats.size,
+            hitRate: `${Math.round(stats.hitRate * 100)}%`,
+        });
+    }
+    lastStats = { hits: stats.hits, misses: stats.misses, evictions: stats.evictions };
+}
+function startMetricsFlush() {
+    if (metricsTimer)
+        return;
+    metricsTimer = setInterval(() => {
+        flushMetrics().catch((err) => {
+            log.error("metrics flush failed", { error: String(err) });
+        });
+    }, METRICS_FLUSH_INTERVAL_MS);
+}
+function stopMetricsFlush() {
+    if (metricsTimer) {
+        clearInterval(metricsTimer);
+        metricsTimer = null;
+    }
+}
+/**
+ * Pre-populate the cache with known prompt/response pairs.
+ * Useful for common system prompts or frequently-used templates.
+ */
+export function warmCache(entries) {
+    let warmed = 0;
+    for (const entry of entries) {
+        const key = generateCacheKey(entry.options);
+        // Only warm if not already cached (don't overwrite fresher entries)
+        if (cacheGet(key) === undefined) {
+            cacheSet(key, entry.response, entry.ttlMs);
+            warmed++;
+        }
+    }
+    if (warmed > 0) {
+        log.info("cache warmed", { requested: entries.length, added: warmed });
+    }
+    return warmed;
+}
+/** Return a snapshot of cache health for dashboards or /api/health. */
+export function getCacheDiagnostics() {
+    const cache = getCacheInstance();
+    const stats = getCacheStats();
+    return {
+        enabled: cache.enabled,
+        memoryEntries: stats.size,
+        memoryMaxSize: stats.maxSize,
+        hits: stats.hits,
+        misses: stats.misses,
+        evictions: stats.evictions,
+        hitRate: `${Math.round(stats.hitRate * 100)}%`,
+    };
+}
+/**
+ * Invalidate all cached entries. Resets statistics.
+ * Use sparingly — prefer natural TTL expiry.
+ */
+export { clearCache as invalidateAll } from "../llm/cache.js";
+/**
+ * Invalidate a specific cache entry by its options.
+ * Returns true if the entry existed and was removed.
+ */
+export function invalidateEntry(options) {
+    const key = generateCacheKey(options);
+    return getCacheInstance().delete(key);
+}
+//# sourceMappingURL=llm-cache.js.map

package/dist/cache/llm-cache.js.map

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

package/dist/cache/memory.d.ts

@@ -0,0 +1,53 @@
+/**
+ * In-memory TTL cache with configurable size limits and LRU eviction.
+ * Generic over value type. No external dependencies.
+ */
+export interface MemoryCacheConfig {
+    /** Maximum number of cached entries. Default: 256. */
+    maxSize?: number;
+    /** Default TTL in milliseconds. Default: 5 minutes. */
+    defaultTTLMs?: number;
+    /** Set false to disable the cache (get always returns undefined, set is a no-op). */
+    enabled?: boolean;
+}
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    evictions: number;
+    size: number;
+    maxSize: number;
+    /** Hit rate as a fraction (0–1). 0 when no lookups have occurred. */
+    hitRate: number;
+}
+/**
+ * In-memory TTL cache.
+ *
+ * - Entries expire after their TTL.
+ * - When the cache is full, the oldest entry (by creation time) is evicted.
+ * - Stats track hits, misses, and evictions for observability.
+ */
+export declare class MemoryCache<T = string> {
+    private cache;
+    private _stats;
+    private readonly maxSize;
+    private readonly defaultTTLMs;
+    private readonly enabled;
+    constructor(config?: MemoryCacheConfig);
+    /** Retrieve a value by key. Returns undefined on miss or expiry. */
+    get(key: string): T | undefined;
+    /** Store a value. Evicts the oldest entry when at capacity. */
+    set(key: string, value: T, ttlMs?: number): void;
+    /** Remove a specific key. Returns true if the key existed. */
+    delete(key: string): boolean;
+    /** Check if a non-expired entry exists for the key. */
+    has(key: string): boolean;
+    /** Remove all entries and reset statistics. */
+    clear(): void;
+    /** Current number of entries (including expired but not yet reaped). */
+    get size(): number;
+    /** Return a snapshot of cache statistics. */
+    stats(): CacheStats;
+    /** Evict the oldest entry by creation time. */
+    private evictOldest;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/cache/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/cache/memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;CACjB;AAWD;;;;;;GAMG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,MAAM;IACjC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,MAAM,GAAE,iBAAsB;IAM1C,oEAAoE;IACpE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAmB/B,+DAA+D;IAC/D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAchD,8DAA8D;IAC9D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,uDAAuD;IACvD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAWzB,+CAA+C;IAC/C,KAAK,IAAI,IAAI;IAMb,wEAAwE;IACxE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,6CAA6C;IAC7C,KAAK,IAAI,UAAU;IAUnB,+CAA+C;IAC/C,OAAO,CAAC,WAAW;CAepB"}

package/dist/cache/memory.js

@@ -0,0 +1,114 @@
+/**
+ * In-memory TTL cache with configurable size limits and LRU eviction.
+ * Generic over value type. No external dependencies.
+ */
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("cache.memory");
+const DEFAULT_MAX_SIZE = 256;
+const DEFAULT_TTL_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * In-memory TTL cache.
+ *
+ * - Entries expire after their TTL.
+ * - When the cache is full, the oldest entry (by creation time) is evicted.
+ * - Stats track hits, misses, and evictions for observability.
+ */
+export class MemoryCache {
+    cache = new Map();
+    _stats = { hits: 0, misses: 0, evictions: 0 };
+    maxSize;
+    defaultTTLMs;
+    enabled;
+    constructor(config = {}) {
+        this.maxSize = config.maxSize ?? DEFAULT_MAX_SIZE;
+        this.defaultTTLMs = config.defaultTTLMs ?? DEFAULT_TTL_MS;
+        this.enabled = config.enabled ?? true;
+    }
+    /** Retrieve a value by key. Returns undefined on miss or expiry. */
+    get(key) {
+        if (!this.enabled)
+            return undefined;
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this._stats.misses++;
+            return undefined;
+        }
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            this._stats.misses++;
+            log.debug("expired", { key: key.slice(0, 12) });
+            return undefined;
+        }
+        this._stats.hits++;
+        log.debug("hit", { key: key.slice(0, 12) });
+        return entry.value;
+    }
+    /** Store a value. Evicts the oldest entry when at capacity. */
+    set(key, value, ttlMs) {
+        if (!this.enabled)
+            return;
+        // Evict if at capacity and this is a new key
+        if (!this.cache.has(key) && this.cache.size >= this.maxSize) {
+            this.evictOldest();
+        }
+        this.cache.set(key, {
+            value,
+            expiresAt: Date.now() + (ttlMs ?? this.defaultTTLMs),
+            createdAt: Date.now(),
+        });
+    }
+    /** Remove a specific key. Returns true if the key existed. */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /** Check if a non-expired entry exists for the key. */
+    has(key) {
+        if (!this.enabled)
+            return false;
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /** Remove all entries and reset statistics. */
+    clear() {
+        this.cache.clear();
+        this._stats = { hits: 0, misses: 0, evictions: 0 };
+        log.debug("cleared");
+    }
+    /** Current number of entries (including expired but not yet reaped). */
+    get size() {
+        return this.cache.size;
+    }
+    /** Return a snapshot of cache statistics. */
+    stats() {
+        const total = this._stats.hits + this._stats.misses;
+        return {
+            ...this._stats,
+            size: this.cache.size,
+            maxSize: this.maxSize,
+            hitRate: total > 0 ? this._stats.hits / total : 0,
+        };
+    }
+    /** Evict the oldest entry by creation time. */
+    evictOldest() {
+        let oldestKey;
+        let oldestTime = Infinity;
+        for (const [k, v] of this.cache) {
+            if (v.createdAt < oldestTime) {
+                oldestTime = v.createdAt;
+                oldestKey = k;
+            }
+        }
+        if (oldestKey) {
+            this.cache.delete(oldestKey);
+            this._stats.evictions++;
+            log.debug("evicted", { key: oldestKey.slice(0, 12) });
+        }
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/cache/memory.js.map

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

package/dist/calendar/google-adapter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Google Calendar adapter — wraps existing src/google/calendar.ts.
+ * Maps Google's nested format to the native CalendarEvent schema.
+ * Bidirectional sync: pull from Google → local store, push local → Google.
+ */
+import type { CalendarEvent, CalendarAdapter, SyncResult } from "./types.js";
+export declare class GoogleCalendarAdapter implements CalendarAdapter {
+    id: "google";
+    name: string;
+    isAvailable(): boolean;
+    sync(since?: string): Promise<SyncResult>;
+    push(event: CalendarEvent): Promise<void>;
+    remove(externalId: string): Promise<void>;
+}
+export declare function getGoogleCalendarAdapter(): GoogleCalendarAdapter;
+//# sourceMappingURL=google-adapter.d.ts.map

package/dist/calendar/google-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-adapter.d.ts","sourceRoot":"","sources":["../../src/calendar/google-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAqC7E,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,EAAE,EAAG,QAAQ,CAAU;IACvB,IAAI,SAAqB;IAEzB,WAAW,IAAI,OAAO;IAIhB,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAyEzC,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CzC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQhD;AAMD,wBAAgB,wBAAwB,IAAI,qBAAqB,CAGhE"}

package/dist/calendar/google-adapter.js

@@ -0,0 +1,163 @@
+/**
+ * Google Calendar adapter — wraps existing src/google/calendar.ts.
+ * Maps Google's nested format to the native CalendarEvent schema.
+ * Bidirectional sync: pull from Google → local store, push local → Google.
+ */
+import { createLogger } from "../utils/logger.js";
+import { isCalendarAvailable, listEvents as googleListEvents, createEvent as googleCreateEvent, updateEvent as googleUpdateEvent, deleteEvent as googleDeleteEvent, } from "../google/calendar.js";
+import { getCalendarStore } from "./store.js";
+const log = createLogger("calendar.google-adapter");
+/** Map a Google Calendar API event to native CalendarEvent fields for upsert. */
+function googleEventToNative(gEvent) {
+    const allDay = !gEvent.start.includes("T");
+    return {
+        title: gEvent.summary,
+        description: gEvent.description,
+        start: gEvent.start,
+        end: gEvent.end,
+        allDay,
+        location: gEvent.location,
+        attendees: gEvent.attendees.map((a) => ({
+            email: a,
+            name: undefined,
+            role: "required",
+            status: "needs-action",
+        })),
+        status: (gEvent.status === "cancelled" ? "cancelled" : "confirmed"),
+        externalIds: { google: gEvent.id },
+        metadata: gEvent.htmlLink ? { htmlLink: gEvent.htmlLink } : undefined,
+    };
+}
+export class GoogleCalendarAdapter {
+    id = "google";
+    name = "Google Calendar";
+    isAvailable() {
+        return isCalendarAvailable();
+    }
+    async sync(since) {
+        const store = getCalendarStore();
+        if (!store)
+            return { created: 0, updated: 0, deleted: 0, errors: ["Calendar store not initialized"], syncedAt: new Date().toISOString() };
+        if (!this.isAvailable())
+            return { created: 0, updated: 0, deleted: 0, errors: ["Google not authenticated"], syncedAt: new Date().toISOString() };
+        let created = 0;
+        let updated = 0;
+        let deleted = 0;
+        const errors = [];
+        try {
+            // Pull events from Google — default to 30 days back / 90 days forward
+            const now = new Date();
+            const timeMin = since ?? new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000).toISOString();
+            const timeMax = new Date(now.getTime() + 90 * 24 * 60 * 60 * 1000).toISOString();
+            const result = await googleListEvents({
+                timeMin,
+                timeMax,
+                maxResults: 250,
+                showDeleted: true,
+            });
+            if (!result.ok || !result.events) {
+                errors.push(result.message);
+                return { created, updated, deleted, errors, syncedAt: new Date().toISOString() };
+            }
+            for (const gEvent of result.events) {
+                try {
+                    const existing = await store.getByExternalId("google", gEvent.id);
+                    if (gEvent.status === "cancelled") {
+                        if (existing && existing.status !== "cancelled") {
+                            await store.cancel(existing.id, "Cancelled in Google Calendar");
+                            deleted++;
+                        }
+                        continue;
+                    }
+                    const native = googleEventToNative(gEvent);
+                    if (existing) {
+                        // Update existing — Google is authoritative for Google-sourced events
+                        await store.update(existing.id, native);
+                        updated++;
+                    }
+                    else {
+                        // Create new local event
+                        await store.create({
+                            ...native,
+                            timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+                            source: "google",
+                            uid: `google-${gEvent.id}@dash`,
+                            externalIds: { google: gEvent.id },
+                        });
+                        created++;
+                    }
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    errors.push(`Event ${gEvent.id}: ${msg}`);
+                }
+            }
+            log.info(`Google sync complete: ${created} created, ${updated} updated, ${deleted} deleted`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            errors.push(`Sync failed: ${msg}`);
+            log.error("Google sync failed", { error: msg });
+        }
+        return { created, updated, deleted, errors, syncedAt: new Date().toISOString() };
+    }
+    async push(event) {
+        if (!this.isAvailable()) {
+            log.warn("Cannot push to Google — not authenticated");
+            return;
+        }
+        const store = getCalendarStore();
+        const googleId = event.externalIds.google;
+        if (googleId) {
+            // Update existing Google event
+            const result = await googleUpdateEvent(googleId, {
+                title: event.title,
+                start: event.start,
+                end: event.end,
+                description: event.description,
+                location: event.location,
+                attendees: event.attendees.map((a) => a.email),
+                recurrence: event.recurrence,
+                timeZone: event.timezone,
+            });
+            if (!result.ok) {
+                log.error("Failed to push update to Google", { eventId: event.id, googleId, error: result.message });
+            }
+        }
+        else {
+            // Create new Google event
+            const result = await googleCreateEvent(event.title, event.start, event.end, {
+                description: event.description,
+                location: event.location,
+                attendees: event.attendees.map((a) => a.email),
+                recurrence: event.recurrence,
+                timeZone: event.timezone,
+            });
+            if (result.ok && result.event && store) {
+                // Store the Google ID back on the local event
+                await store.update(event.id, {
+                    externalIds: { ...event.externalIds, google: result.event.id },
+                });
+            }
+            else if (!result.ok) {
+                log.error("Failed to push new event to Google", { eventId: event.id, error: result.message });
+            }
+        }
+    }
+    async remove(externalId) {
+        if (!this.isAvailable())
+            return;
+        const result = await googleDeleteEvent(externalId);
+        if (!result.ok) {
+            log.error("Failed to remove event from Google", { externalId, error: result.message });
+        }
+    }
+}
+// ── Singleton ──────────────────────────────────────────────────────────────
+let _adapter = null;
+export function getGoogleCalendarAdapter() {
+    if (!_adapter)
+        _adapter = new GoogleCalendarAdapter();
+    return _adapter;
+}
+//# sourceMappingURL=google-adapter.js.map

package/dist/calendar/google-adapter.js.map

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

package/dist/calendar/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Calendar module — native calendar primitive with adapter-based sync.
+ */
+export { CalendarStore, createCalendarStore, getCalendarStore } from "./store.js";
+export { GoogleCalendarAdapter, getGoogleCalendarAdapter } from "./google-adapter.js";
+export { calendarRoutes } from "./routes.js";
+export type { CalendarEvent, Calendar, CalendarSource, CalendarAdapter, SyncResult, EventFilter, FreeBusySlot, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/calendar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/calendar/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,eAAe,EACf,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/calendar/index.js

@@ -0,0 +1,7 @@
+/**
+ * Calendar module — native calendar primitive with adapter-based sync.
+ */
+export { CalendarStore, createCalendarStore, getCalendarStore } from "./store.js";
+export { GoogleCalendarAdapter, getGoogleCalendarAdapter } from "./google-adapter.js";
+export { calendarRoutes } from "./routes.js";
+//# sourceMappingURL=index.js.map

package/dist/calendar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/calendar/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}