@runcore-sh/runcore 0.1.2

package/dist/goals/notifications.js

@@ -0,0 +1,101 @@
+/**
+ * FIFO notification queue for goal loop → chat turn communication.
+ * Background goal checks push messages here; the next chat turn drains them.
+ * Persisted to encrypted JSONL so notifications survive server restarts.
+ */
+import { join } from "node:path";
+import { randomBytes } from "node:crypto";
+import { createLogger } from "../utils/logger.js";
+import { readBrainLinesSync, appendBrainLine, appendBrainLineSync, ensureBrainFileSync, writeBrainLines, } from "../lib/brain-io.js";
+const log = createLogger("notifications");
+// ─── File path ───────────────────────────────────────────────────────────────
+const OPS_DIR = join(process.cwd(), "brain", "operations");
+const NOTIF_FILE = join(OPS_DIR, "notifications.jsonl");
+const SCHEMA_LINE = JSON.stringify({ _schema: "notifications", _version: "1.0" });
+// ─── State ───────────────────────────────────────────────────────────────────
+const queue = [];
+let hydrated = false;
+// ─── Persistence ─────────────────────────────────────────────────────────────
+/** Load existing notifications from disk. Called once, lazily. */
+function hydrate() {
+    if (hydrated)
+        return;
+    hydrated = true;
+    try {
+        ensureBrainFileSync(NOTIF_FILE, SCHEMA_LINE);
+        const lines = readBrainLinesSync(NOTIF_FILE);
+        for (const line of lines) {
+            try {
+                const obj = JSON.parse(line);
+                if (obj._schema)
+                    continue; // skip schema header
+                if (obj.timestamp && obj.source && obj.message) {
+                    queue.push(obj);
+                }
+            }
+            catch {
+                // skip malformed lines
+            }
+        }
+        if (queue.length > 0) {
+            log.info(`Hydrated ${queue.length} pending notification(s) from disk`);
+        }
+    }
+    catch (err) {
+        log.warn(`Failed to hydrate notifications: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Persist a single notification to disk. Fire-and-forget.
+ * Uses async I/O with sync fallback, matching activity/log.ts pattern.
+ */
+function persistEntry(entry) {
+    try {
+        ensureBrainFileSync(NOTIF_FILE, SCHEMA_LINE);
+        const json = JSON.stringify(entry);
+        appendBrainLine(NOTIF_FILE, json).catch((err) => {
+            try {
+                appendBrainLineSync(NOTIF_FILE, json);
+            }
+            catch {
+                log.warn(`Failed to persist notification: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        });
+    }
+    catch (err) {
+        log.warn(`Failed to persist notification: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/** Add a notification for the user's next chat turn. */
+export function pushNotification(notification) {
+    hydrate();
+    const entry = {
+        ...notification,
+        id: notification.id ?? randomBytes(4).toString("hex"),
+    };
+    queue.push(entry);
+    persistEntry(entry);
+}
+/** Return and clear all pending notifications, compacting the file. */
+export async function drainNotifications() {
+    hydrate();
+    const drained = queue.splice(0, queue.length);
+    if (drained.length > 0) {
+        // Compact: rewrite file with just the schema line (queue is empty)
+        writeBrainLines(NOTIF_FILE, [SCHEMA_LINE]).catch((err) => {
+            log.warn(`Failed to compact notifications file: ${err instanceof Error ? err.message : String(err)}`);
+        });
+    }
+    return drained;
+}
+/** Check if there are pending notifications without consuming them. */
+export function hasPendingNotifications() {
+    return queue.length > 0;
+}
+/** Pre-warm: hydrate from disk during server startup. Returns count of loaded notifications. */
+export async function initNotifications() {
+    hydrate();
+    return queue.length;
+}
+//# sourceMappingURL=notifications.js.map

package/dist/goals/notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../src/goals/notifications.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAE1C,gFAAgF;AAEhF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;AAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;AACxD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AAWlF,gFAAgF;AAEhF,MAAM,KAAK,GAAuB,EAAE,CAAC;AACrC,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,gFAAgF;AAEhF,kEAAkE;AAClE,SAAS,OAAO;IACd,IAAI,QAAQ;QAAE,OAAO;IACrB,QAAQ,GAAG,IAAI,CAAC;IAEhB,IAAI,CAAC;QACH,mBAAmB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAE7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7B,IAAI,GAAG,CAAC,OAAO;oBAAE,SAAS,CAAC,qBAAqB;gBAChD,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;oBAC/C,KAAK,CAAC,IAAI,CAAC,GAAuB,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,MAAM,oCAAoC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,oCAAoC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnG,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,KAAuB;IAC3C,IAAI,CAAC;QACH,mBAAmB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YAC9C,IAAI,CAAC;gBACH,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,CAAC,IAAI,CAAC,mCAAmC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClG,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,mCAAmC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF,wDAAwD;AACxD,MAAM,UAAU,gBAAgB,CAAC,YAA8B;IAC7D,OAAO,EAAE,CAAC;IACV,MAAM,KAAK,GAAqB;QAC9B,GAAG,YAAY;QACf,EAAE,EAAE,YAAY,CAAC,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;KACtD,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,YAAY,CAAC,KAAK,CAAC,CAAC;AACtB,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,OAAO,EAAE,CAAC;IACV,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE9C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,mEAAmE;QACnE,eAAe,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACvD,GAAG,CAAC,IAAI,CAAC,yCAAyC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxG,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,uBAAuB;IACrC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,OAAO,EAAE,CAAC;IACV,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC"}

package/dist/goals/timer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Background goal-check timer lifecycle.
+ * Follows sidecar.ts pattern: module-level state, idempotent start/stop.
+ */
+import type { Brain } from "../brain.js";
+interface TimerConfig {
+    brain: Brain;
+    humanName: string;
+    intervalMs?: number;
+}
+/**
+ * Start the background goal timer. Idempotent — calling twice is a no-op.
+ * First check fires after one full interval (not immediately).
+ */
+export declare function startGoalTimer(opts: TimerConfig): void;
+/** Stop the background goal timer. */
+export declare function stopGoalTimer(): void;
+/** Check if the goal timer is currently running. */
+export declare function isGoalTimerRunning(): boolean;
+export {};
+//# sourceMappingURL=timer.d.ts.map

package/dist/goals/timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../src/goals/timer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAWzC,UAAU,WAAW;IACnB,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CA6BtD;AAED,sCAAsC;AACtC,wBAAgB,aAAa,IAAI,IAAI,CAMpC;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C"}

package/dist/goals/timer.js

@@ -0,0 +1,60 @@
+/**
+ * Background goal-check timer lifecycle.
+ * Follows sidecar.ts pattern: module-level state, idempotent start/stop.
+ */
+import { runGoalCheck } from "./loop.js";
+import { logActivity } from "../activity/log.js";
+import { resolveProvider, resolveUtilityModel } from "../settings.js";
+import { resolveEnv } from "../instance.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("goals");
+const DEFAULT_INTERVAL_MS = 30 * 60 * 1000; // 30 minutes
+let timer = null;
+let config = null;
+/**
+ * Start the background goal timer. Idempotent — calling twice is a no-op.
+ * First check fires after one full interval (not immediately).
+ */
+export function startGoalTimer(opts) {
+    if (timer)
+        return; // Already running
+    config = opts;
+    const interval = opts.intervalMs ?? (parseInt(resolveEnv("GOAL_INTERVAL_MS") ?? "", 10) || DEFAULT_INTERVAL_MS);
+    timer = setInterval(async () => {
+        if (!config)
+            return;
+        try {
+            const result = await runGoalCheck({
+                brain: config.brain,
+                provider: resolveProvider(),
+                model: resolveUtilityModel(),
+                humanName: config.humanName,
+            });
+            if (result.action !== "nothing") {
+                logActivity({ source: "goal-loop", summary: `${result.action}: ${result.reasoning ?? ""}`, actionLabel: "AUTONOMOUS", reason: "goal-loop timer tick" });
+            }
+            if (result.error) {
+                logActivity({ source: "goal-loop", summary: `Error: ${result.error}`, actionLabel: "AUTONOMOUS", reason: "goal-loop timer tick" });
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logActivity({ source: "goal-loop", summary: `Unhandled error: ${msg}`, actionLabel: "AUTONOMOUS", reason: "goal-loop timer tick" });
+        }
+    }, interval);
+    const mins = Math.round(interval / 60_000);
+    log.info(`Goal loop: every ${mins} min`);
+}
+/** Stop the background goal timer. */
+export function stopGoalTimer() {
+    if (timer) {
+        clearInterval(timer);
+        timer = null;
+    }
+    config = null;
+}
+/** Check if the goal timer is currently running. */
+export function isGoalTimerRunning() {
+    return timer !== null;
+}
+//# sourceMappingURL=timer.js.map

package/dist/goals/timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../src/goals/timer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;AAElC,MAAM,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAQzD,IAAI,KAAK,GAA0C,IAAI,CAAC;AACxD,IAAI,MAAM,GAAuB,IAAI,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,IAAI,KAAK;QAAE,OAAO,CAAC,kBAAkB;IAErC,MAAM,GAAG,IAAI,CAAC;IACd,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,mBAAmB,CAAC,CAAC;IAEhH,KAAK,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAC7B,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;gBAChC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ,EAAE,eAAe,EAAE;gBAC3B,KAAK,EAAE,mBAAmB,EAAE;gBAC5B,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,WAAW,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;YAC1J,CAAC;YACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,WAAW,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;YACrI,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,WAAW,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,GAAG,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;QACtI,CAAC;IACH,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEb,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAC;IAC3C,GAAG,CAAC,IAAI,CAAC,oBAAoB,IAAI,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,aAAa;IAC3B,IAAI,KAAK,EAAE,CAAC;QACV,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,KAAK,GAAG,IAAI,CAAC;IACf,CAAC;IACD,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,kBAAkB;IAChC,OAAO,KAAK,KAAK,IAAI,CAAC;AACxB,CAAC"}

package/dist/google/auth.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Google OAuth2 token management.
+ * Raw fetch — no SDK. Credentials from vault (process.env).
+ * Follows src/twilio/call.ts pattern: never throws, returns { ok, message }.
+ *
+ * Stores refresh token in vault as GOOGLE_REFRESH_TOKEN.
+ * Access tokens are cached in memory and auto-refreshed (they expire hourly).
+ */
+/** All scopes requested upfront to avoid re-consent. */
+export declare const GOOGLE_SCOPES: string[];
+/**
+ * Check if Google OAuth is configured (client ID + secret in vault).
+ */
+export declare function isGoogleConfigured(): boolean;
+/**
+ * Check if Google OAuth is authenticated (refresh token exists).
+ */
+export declare function isGoogleAuthenticated(): boolean;
+/**
+ * Build the Google authorization URL for the consent screen.
+ * Redirects to localhost callback after user approves.
+ */
+export declare function getAuthUrl(redirectUri: string): {
+    ok: boolean;
+    url?: string;
+    message: string;
+};
+/**
+ * Exchange an authorization code for access + refresh tokens.
+ * Returns the refresh token to be stored in vault.
+ */
+export declare function exchangeCode(code: string, redirectUri: string): Promise<{
+    ok: boolean;
+    refreshToken?: string;
+    accessToken?: string;
+    message: string;
+}>;
+/**
+ * Get a valid access token, auto-refreshing if expired.
+ * Never throws — returns { ok, token?, message }.
+ */
+export declare function getAccessToken(): Promise<{
+    ok: boolean;
+    token?: string;
+    message: string;
+}>;
+/**
+ * Make an authenticated GET request to a Google API.
+ * Auto-refreshes token. Returns parsed JSON or error.
+ */
+export declare function googleGet<T = any>(url: string, params?: Record<string, string | string[]>): Promise<{
+    ok: boolean;
+    data?: T;
+    message: string;
+}>;
+/**
+ * Make an authenticated POST request to a Google API.
+ * Auto-refreshes token. Returns parsed JSON or error.
+ */
+export declare function googlePost<T = any>(url: string, body: Record<string, any>): Promise<{
+    ok: boolean;
+    data?: T;
+    message: string;
+}>;
+/**
+ * Make an authenticated PATCH request to a Google API.
+ */
+export declare function googlePatch<T = any>(url: string, body: Record<string, any>): Promise<{
+    ok: boolean;
+    data?: T;
+    message: string;
+}>;
+/**
+ * Make an authenticated DELETE request to a Google API.
+ */
+export declare function googleDelete(url: string): Promise<{
+    ok: boolean;
+    message: string;
+}>;
+/**
+ * Clear the cached access token (e.g., when vault keys change).
+ */
+export declare function clearTokenCache(): void;
+//# sourceMappingURL=auth.d.ts.map

package/dist/google/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/google/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,wDAAwD;AACxD,eAAO,MAAM,aAAa,UAKzB,CAAC;AAYF;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAyB9F;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAuDxF;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA8DhG;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,CAAC,GAAG,GAAG,EACrC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GACzC,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAyDrD;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,GAAG,EACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BrD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,GAAG,EACvC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BrD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB3C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC"}

package/dist/google/auth.js

@@ -0,0 +1,323 @@
+/**
+ * Google OAuth2 token management.
+ * Raw fetch — no SDK. Credentials from vault (process.env).
+ * Follows src/twilio/call.ts pattern: never throws, returns { ok, message }.
+ *
+ * Stores refresh token in vault as GOOGLE_REFRESH_TOKEN.
+ * Access tokens are cached in memory and auto-refreshed (they expire hourly).
+ */
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("google.auth");
+const GOOGLE_AUTH_URL = "https://accounts.google.com/o/oauth2/v2/auth";
+const GOOGLE_TOKEN_URL = "https://oauth2.googleapis.com/token";
+/** All scopes requested upfront to avoid re-consent. */
+export const GOOGLE_SCOPES = [
+    "https://www.googleapis.com/auth/gmail.modify",
+    "https://www.googleapis.com/auth/calendar.events",
+    "https://www.googleapis.com/auth/drive.file",
+    "https://www.googleapis.com/auth/tasks",
+];
+const REQUIRED_VARS = [
+    "GOOGLE_CLIENT_ID",
+    "GOOGLE_CLIENT_SECRET",
+];
+// --- In-memory access token cache ---
+let cachedAccessToken = null;
+let tokenExpiresAt = 0; // epoch ms
+/**
+ * Check if Google OAuth is configured (client ID + secret in vault).
+ */
+export function isGoogleConfigured() {
+    return !!process.env.GOOGLE_CLIENT_ID && !!process.env.GOOGLE_CLIENT_SECRET;
+}
+/**
+ * Check if Google OAuth is authenticated (refresh token exists).
+ */
+export function isGoogleAuthenticated() {
+    return isGoogleConfigured() && !!process.env.GOOGLE_REFRESH_TOKEN;
+}
+/**
+ * Build the Google authorization URL for the consent screen.
+ * Redirects to localhost callback after user approves.
+ */
+export function getAuthUrl(redirectUri) {
+    const missing = REQUIRED_VARS.filter((v) => !process.env[v]);
+    if (missing.length > 0) {
+        log.warn("OAuth config incomplete — missing vault keys", { missing });
+        return {
+            ok: false,
+            message: `Missing vault keys: ${missing.join(", ")}. Add GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET in vault settings.`,
+        };
+    }
+    const params = new URLSearchParams({
+        client_id: process.env.GOOGLE_CLIENT_ID,
+        redirect_uri: redirectUri,
+        response_type: "code",
+        scope: GOOGLE_SCOPES.join(" "),
+        access_type: "offline",
+        prompt: "consent", // Force consent to always get refresh token
+    });
+    log.debug("Generated OAuth authorization URL", { redirectUri });
+    return {
+        ok: true,
+        url: `${GOOGLE_AUTH_URL}?${params.toString()}`,
+        message: "Authorization URL generated",
+    };
+}
+/**
+ * Exchange an authorization code for access + refresh tokens.
+ * Returns the refresh token to be stored in vault.
+ */
+export async function exchangeCode(code, redirectUri) {
+    const missing = REQUIRED_VARS.filter((v) => !process.env[v]);
+    if (missing.length > 0) {
+        return { ok: false, message: `Missing vault keys: ${missing.join(", ")}` };
+    }
+    try {
+        log.debug("Exchanging authorization code for tokens");
+        const params = new URLSearchParams({
+            code,
+            client_id: process.env.GOOGLE_CLIENT_ID,
+            client_secret: process.env.GOOGLE_CLIENT_SECRET,
+            redirect_uri: redirectUri,
+            grant_type: "authorization_code",
+        });
+        const res = await fetch(GOOGLE_TOKEN_URL, {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body: params.toString(),
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            log.error("Token exchange HTTP error", { status: res.status, body });
+            return { ok: false, message: `Google token error (${res.status}): ${body}` };
+        }
+        const data = (await res.json());
+        if (!data.refresh_token) {
+            log.warn("No refresh token in exchange response — user may need to re-consent");
+            return { ok: false, message: "No refresh token returned — try revoking app access in Google settings and re-authorizing" };
+        }
+        // Cache access token
+        cachedAccessToken = data.access_token ?? null;
+        tokenExpiresAt = Date.now() + ((data.expires_in ?? 3600) - 60) * 1000; // 60s buffer
+        log.info("OAuth tokens exchanged successfully", { expiresIn: data.expires_in });
+        return {
+            ok: true,
+            refreshToken: data.refresh_token,
+            accessToken: data.access_token,
+            message: "Tokens exchanged successfully",
+        };
+    }
+    catch (err) {
+        log.error("Token exchange failed", { error: err.message });
+        return { ok: false, message: `Token exchange failed: ${err.message}` };
+    }
+}
+/**
+ * Get a valid access token, auto-refreshing if expired.
+ * Never throws — returns { ok, token?, message }.
+ */
+export async function getAccessToken() {
+    // Return cached token if still valid
+    if (cachedAccessToken && Date.now() < tokenExpiresAt) {
+        log.debug("Using cached access token", { expiresIn: Math.round((tokenExpiresAt - Date.now()) / 1000) });
+        return { ok: true, token: cachedAccessToken, message: "Cached token" };
+    }
+    const refreshToken = process.env.GOOGLE_REFRESH_TOKEN;
+    if (!refreshToken) {
+        log.warn("No GOOGLE_REFRESH_TOKEN in vault — not authenticated");
+        return { ok: false, message: "Not authenticated — no GOOGLE_REFRESH_TOKEN in vault" };
+    }
+    const missing = REQUIRED_VARS.filter((v) => !process.env[v]);
+    if (missing.length > 0) {
+        return { ok: false, message: `Missing vault keys: ${missing.join(", ")}` };
+    }
+    try {
+        log.debug("Refreshing access token");
+        const params = new URLSearchParams({
+            client_id: process.env.GOOGLE_CLIENT_ID,
+            client_secret: process.env.GOOGLE_CLIENT_SECRET,
+            refresh_token: refreshToken,
+            grant_type: "refresh_token",
+        });
+        const res = await fetch(GOOGLE_TOKEN_URL, {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body: params.toString(),
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            // Clear cached token on auth failure
+            cachedAccessToken = null;
+            tokenExpiresAt = 0;
+            log.error("Token refresh HTTP error — cache cleared", { status: res.status, body });
+            return { ok: false, message: `Token refresh failed (${res.status}): ${body}` };
+        }
+        const data = (await res.json());
+        if (!data.access_token) {
+            log.error("No access token in refresh response");
+            return { ok: false, message: "No access token in refresh response" };
+        }
+        cachedAccessToken = data.access_token;
+        tokenExpiresAt = Date.now() + ((data.expires_in ?? 3600) - 60) * 1000;
+        log.info("Access token refreshed successfully", { expiresIn: data.expires_in });
+        return { ok: true, token: cachedAccessToken, message: "Token refreshed" };
+    }
+    catch (err) {
+        log.error("Token refresh failed", { error: err.message });
+        return { ok: false, message: `Token refresh failed: ${err.message}` };
+    }
+}
+/**
+ * Make an authenticated GET request to a Google API.
+ * Auto-refreshes token. Returns parsed JSON or error.
+ */
+export async function googleGet(url, params) {
+    const auth = await getAccessToken();
+    if (!auth.ok)
+        return { ok: false, message: auth.message };
+    try {
+        let fullUrl = url;
+        if (params) {
+            const qs = new URLSearchParams();
+            for (const [key, val] of Object.entries(params)) {
+                if (Array.isArray(val)) {
+                    for (const v of val)
+                        qs.append(key, v);
+                }
+                else {
+                    qs.append(key, val);
+                }
+            }
+            fullUrl = `${url}?${qs.toString()}`;
+        }
+        const res = await fetch(fullUrl, {
+            headers: { Authorization: `Bearer ${auth.token}` },
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (res.status === 401) {
+            // Token might have been revoked — clear cache and retry once
+            log.warn("GET received 401 — clearing token cache and retrying", { url });
+            cachedAccessToken = null;
+            tokenExpiresAt = 0;
+            const retry = await getAccessToken();
+            if (!retry.ok)
+                return { ok: false, message: `Auth failed: ${retry.message}` };
+            const retryRes = await fetch(fullUrl, {
+                headers: { Authorization: `Bearer ${retry.token}` },
+                signal: AbortSignal.timeout(15_000),
+            });
+            if (!retryRes.ok) {
+                const body = await retryRes.text();
+                log.error("GET retry failed", { url, status: retryRes.status });
+                return { ok: false, message: `Google API error (${retryRes.status}): ${body}` };
+            }
+            log.debug("GET succeeded on retry", { url });
+            return { ok: true, data: (await retryRes.json()), message: "OK (retry)" };
+        }
+        if (!res.ok) {
+            const body = await res.text();
+            log.error("GET failed", { url, status: res.status });
+            return { ok: false, message: `Google API error (${res.status}): ${body}` };
+        }
+        return { ok: true, data: (await res.json()), message: "OK" };
+    }
+    catch (err) {
+        log.error("GET request exception", { url, error: err.message });
+        return { ok: false, message: `Google API request failed: ${err.message}` };
+    }
+}
+/**
+ * Make an authenticated POST request to a Google API.
+ * Auto-refreshes token. Returns parsed JSON or error.
+ */
+export async function googlePost(url, body) {
+    const auth = await getAccessToken();
+    if (!auth.ok)
+        return { ok: false, message: auth.message };
+    try {
+        const res = await fetch(url, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${auth.token}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            log.error("POST failed", { url, status: res.status });
+            return { ok: false, message: `Google API error (${res.status}): ${text}` };
+        }
+        return { ok: true, data: (await res.json()), message: "OK" };
+    }
+    catch (err) {
+        log.error("POST request exception", { url, error: err.message });
+        return { ok: false, message: `Google API request failed: ${err.message}` };
+    }
+}
+/**
+ * Make an authenticated PATCH request to a Google API.
+ */
+export async function googlePatch(url, body) {
+    const auth = await getAccessToken();
+    if (!auth.ok)
+        return { ok: false, message: auth.message };
+    try {
+        const res = await fetch(url, {
+            method: "PATCH",
+            headers: {
+                Authorization: `Bearer ${auth.token}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            log.error("PATCH failed", { url, status: res.status });
+            return { ok: false, message: `Google API error (${res.status}): ${text}` };
+        }
+        return { ok: true, data: (await res.json()), message: "OK" };
+    }
+    catch (err) {
+        log.error("PATCH request exception", { url, error: err.message });
+        return { ok: false, message: `Google API request failed: ${err.message}` };
+    }
+}
+/**
+ * Make an authenticated DELETE request to a Google API.
+ */
+export async function googleDelete(url) {
+    const auth = await getAccessToken();
+    if (!auth.ok)
+        return { ok: false, message: auth.message };
+    try {
+        const res = await fetch(url, {
+            method: "DELETE",
+            headers: { Authorization: `Bearer ${auth.token}` },
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            log.error("DELETE failed", { url, status: res.status });
+            return { ok: false, message: `Google API error (${res.status}): ${text}` };
+        }
+        return { ok: true, message: "Deleted" };
+    }
+    catch (err) {
+        log.error("DELETE request exception", { url, error: err.message });
+        return { ok: false, message: `Google API request failed: ${err.message}` };
+    }
+}
+/**
+ * Clear the cached access token (e.g., when vault keys change).
+ */
+export function clearTokenCache() {
+    cachedAccessToken = null;
+    tokenExpiresAt = 0;
+}
+//# sourceMappingURL=auth.js.map

package/dist/google/auth.js.map

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

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

@@ -0,0 +1,20 @@
+/**
+ * Background calendar polling timer.
+ * Checks for upcoming events every 5 minutes from the local CalendarStore.
+ * When an event is < 30 min away, pushes a notification.
+ * Also triggers Google sync on each tick (if available).
+ * Follows src/goals/timer.ts pattern: module-level state, idempotent start/stop.
+ */
+/**
+ * Start the calendar polling timer. Idempotent.
+ */
+export declare function startCalendarTimer(intervalMs?: number): void;
+/**
+ * Stop the calendar polling timer.
+ */
+export declare function stopCalendarTimer(): void;
+/**
+ * Check if the calendar timer is running.
+ */
+export declare function isCalendarTimerRunning(): boolean;
+//# sourceMappingURL=calendar-timer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-timer.d.ts","sourceRoot":"","sources":["../../src/google/calendar-timer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CA6D5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD"}