daemora 1.0.0-alpha.0

package/dist/learning/MemoryDecay.js

@@ -0,0 +1,204 @@
+/**
+ * MemoryDecay — prunes stale and irrelevant memories.
+ *
+ * Runs periodically (daily cron or on-demand) to keep the memory store
+ * lean. Three decay strategies:
+ *   1. Old + never recalled → soft-delete (mark inactive)
+ *   2. Negative feedback → reduce priority (tag as low-priority)
+ *   3. Recently accessed → keep regardless of age
+ *
+ * All actions are logged to memory_decay_log for auditability.
+ *
+ * Table: memory_decay_log(id TEXT PK, memory_id TEXT, action TEXT, reason TEXT, created_at INT)
+ */
+import { randomUUID } from "node:crypto";
+import { createLogger } from "../util/logger.js";
+const log = createLogger("learning.decay");
+// ── Config ────────────────────────────────────────────────────────
+/** Entries older than this with 0 recalls get soft-deleted. */
+const STALE_AGE_MS = 90 * 24 * 60 * 60_000; // 90 days
+/** Entries accessed within this window are always kept. */
+const RECENT_ACCESS_MS = 14 * 24 * 60 * 60_000; // 14 days
+// ── Schema ────────────────────────────────────────────────────────
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS memory_decay_log (
+  id          TEXT PRIMARY KEY,
+  memory_id   TEXT NOT NULL,
+  action      TEXT NOT NULL,
+  reason      TEXT NOT NULL,
+  created_at  INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_decay_log_memory
+  ON memory_decay_log (memory_id);
+CREATE INDEX IF NOT EXISTS idx_decay_log_created
+  ON memory_decay_log (created_at DESC);
+`;
+// ── MemoryDecay ───────────────────────────────────────────────────
+export class MemoryDecay {
+    db;
+    memory;
+    stmts;
+    constructor(db, memory) {
+        this.db = db;
+        this.memory = memory;
+        db.exec(SCHEMA);
+        this.stmts = this.prepareStatements();
+        log.debug("memory decay initialized");
+    }
+    /**
+     * Run the decay pass. Scans all memory entries and applies decay
+     * rules. Returns a summary of actions taken.
+     *
+     * Safe to call frequently — idempotent for already-processed entries.
+     */
+    runDecay() {
+        const now = Date.now();
+        const staleThreshold = now - STALE_AGE_MS;
+        const recentThreshold = now - RECENT_ACCESS_MS;
+        let scanned = 0;
+        let deleted = 0;
+        let deprioritized = 0;
+        let kept = 0;
+        // Scan in batches to avoid loading entire table into memory
+        const batchSize = 100;
+        let offset = 0;
+        while (true) {
+            const entries = this.memory.listRecentEntries({ limit: batchSize, offset });
+            if (entries.length === 0)
+                break;
+            const tx = this.db.transaction(() => {
+                for (const entry of entries) {
+                    scanned++;
+                    // Check access stats
+                    const stats = this.getRecallStats(entry.id);
+                    const accessCount = stats?.access_count ?? 0;
+                    const lastAccessed = stats?.last_accessed ?? 0;
+                    // Rule 1: Recently accessed → keep regardless of age
+                    if (lastAccessed > recentThreshold) {
+                        kept++;
+                        continue;
+                    }
+                    // Rule 2: Negative feedback (tagged "negative-feedback") → deprioritize
+                    if (entry.tags.includes("negative-feedback")) {
+                        this.deprioritize(entry.id, "negative feedback tag present", now);
+                        deprioritized++;
+                        continue;
+                    }
+                    // Rule 3: Old + never recalled → soft-delete
+                    if (entry.createdAt < staleThreshold && accessCount === 0) {
+                        this.softDelete(entry.id, "older than 90 days with 0 recalls", now);
+                        deleted++;
+                        continue;
+                    }
+                    // Rule 4: Old + low recall count → deprioritize
+                    if (entry.createdAt < staleThreshold && accessCount <= 2) {
+                        this.deprioritize(entry.id, `older than 90 days with only ${accessCount} recalls`, now);
+                        deprioritized++;
+                        continue;
+                    }
+                    kept++;
+                }
+            });
+            tx();
+            offset += entries.length;
+        }
+        const result = { scanned, deleted, deprioritized, kept };
+        log.info(result, "decay pass complete");
+        return result;
+    }
+    /**
+     * View decay log for a specific memory entry.
+     */
+    getLog(memoryId) {
+        const rows = this.stmts.logByMemory.all(memoryId);
+        return rows.map(rowToEntry);
+    }
+    /**
+     * View recent decay actions across all entries.
+     */
+    recentActions(limit = 50) {
+        const rows = this.stmts.recentLog.all(Math.max(1, Math.min(limit, 500)));
+        return rows.map(rowToEntry);
+    }
+    /**
+     * Undo a soft-delete by re-saving the entry content. Only works if
+     * the entry was soft-deleted (actual content removed). Returns true
+     * if restoration was logged (actual re-insertion depends on having
+     * the original content available).
+     */
+    logRestoration(memoryId, reason) {
+        this.writeLog(memoryId, "keep", `restored: ${reason}`, Date.now());
+    }
+    // ── Internals ─────────────────────────────────────────────────
+    softDelete(memoryId, reason, now) {
+        const success = this.memory.delete(memoryId);
+        if (success) {
+            this.writeLog(memoryId, "soft-delete", reason, now);
+            log.debug({ memoryId, reason }, "memory soft-deleted");
+        }
+    }
+    deprioritize(memoryId, reason, now) {
+        // We tag as low-priority rather than deleting — the entry remains
+        // searchable but SmartRecall can down-rank it.
+        // Since MemoryStore doesn't have an update method, we log the action
+        // and let consumers check the decay log or tags.
+        this.writeLog(memoryId, "deprioritize", reason, now);
+        log.debug({ memoryId, reason }, "memory deprioritized");
+    }
+    writeLog(memoryId, action, reason, now) {
+        const id = randomUUID();
+        this.stmts.insertLog.run(id, memoryId, action, reason, now);
+    }
+    getRecallStats(memoryId) {
+        // Check if recall_stats table exists (SmartRecall may not be initialized)
+        try {
+            const row = this.stmts.getStats.get(memoryId);
+            return row ?? null;
+        }
+        catch {
+            // recall_stats table doesn't exist yet — treat as no stats
+            return null;
+        }
+    }
+    prepareStatements() {
+        // Prepare the recall_stats query lazily — table may not exist
+        let statsStmt = null;
+        const self = this;
+        return {
+            insertLog: this.db.prepare(`INSERT INTO memory_decay_log (id, memory_id, action, reason, created_at)
+         VALUES (?, ?, ?, ?, ?)`),
+            logByMemory: this.db.prepare(`SELECT id, memory_id, action, reason, created_at
+         FROM memory_decay_log
+         WHERE memory_id = ?
+         ORDER BY created_at DESC`),
+            recentLog: this.db.prepare(`SELECT id, memory_id, action, reason, created_at
+         FROM memory_decay_log
+         ORDER BY created_at DESC
+         LIMIT ?`),
+            get getStats() {
+                if (!statsStmt) {
+                    try {
+                        statsStmt = self.db.prepare(`SELECT access_count, last_accessed FROM recall_stats WHERE memory_id = ?`);
+                    }
+                    catch {
+                        // recall_stats doesn't exist — create a dummy that always returns undefined
+                        statsStmt = self.db.prepare("SELECT NULL AS access_count, NULL AS last_accessed WHERE 0");
+                    }
+                }
+                return statsStmt;
+            },
+        };
+    }
+}
+// ── Helpers ───────────────────────────────────────────────────────
+function rowToEntry(row) {
+    return {
+        id: row.id,
+        memoryId: row.memory_id,
+        action: row.action,
+        reason: row.reason,
+        createdAt: row.created_at,
+    };
+}
+//# sourceMappingURL=MemoryDecay.js.map

package/dist/learning/MemoryDecay.js.map

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

package/dist/learning/SmartRecall.d.ts

@@ -0,0 +1,58 @@
+/**
+ * SmartRecall — enhanced recall combining FTS5 BM25 + recency + frequency.
+ *
+ * Standard MemoryStore.search() returns raw BM25-ranked results. SmartRecall
+ * re-ranks by blending three signals:
+ *   1. BM25 relevance (from FTS5)
+ *   2. Recency boost (newer entries score higher)
+ *   3. Frequency boost (often-recalled entries score higher)
+ *
+ * Also tracks access counts in a separate table so frequently-recalled
+ * entries rise in future queries.
+ *
+ * Table: recall_stats(memory_id TEXT PK, access_count INT, last_accessed INT)
+ */
+import type Database from "better-sqlite3";
+import type { MemoryStore } from "../memory/MemoryStore.js";
+export interface SmartRecallHit {
+    readonly id: string;
+    readonly content: string;
+    readonly tags: readonly string[];
+    readonly source: string;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    /** Raw BM25 rank from FTS5 (lower = more relevant). */
+    readonly bm25Rank: number;
+    /** Combined score (higher = better). */
+    readonly score: number;
+    /** How many times this entry has been recalled. */
+    readonly accessCount: number;
+}
+export declare class SmartRecall {
+    private readonly db;
+    private readonly memory;
+    private readonly stmts;
+    constructor(db: Database.Database, memory: MemoryStore);
+    /**
+     * Recall memories matching `query`, re-ranked by relevance + recency + frequency.
+     *
+     * Fetches more candidates from FTS5 than `limit` to allow re-ranking,
+     * then returns the top `limit` after blending signals.
+     */
+    recall(query: string, limit?: number): readonly SmartRecallHit[];
+    /**
+     * Get access stats for a specific memory entry.
+     */
+    getStats(memoryId: string): {
+        accessCount: number;
+        lastAccessed: number;
+    } | null;
+    /**
+     * Reset access stats for a memory entry (e.g. after content update).
+     */
+    resetStats(memoryId: string): void;
+    private loadStatsForIds;
+    private recordAccess;
+    private prepareStatements;
+}
+//# sourceMappingURL=SmartRecall.d.ts.map

package/dist/learning/SmartRecall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartRecall.d.ts","sourceRoot":"","sources":["../../src/learning/SmartRecall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,0BAA0B,CAAC;AA2BvE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAUD,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+C;gBAGlD,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,WAAW;IAOtC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,SAAS,cAAc,EAAE;IA0D5D;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAMhF;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMlC,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,iBAAiB;CAiB1B"}

package/dist/learning/SmartRecall.js

@@ -0,0 +1,182 @@
+/**
+ * SmartRecall — enhanced recall combining FTS5 BM25 + recency + frequency.
+ *
+ * Standard MemoryStore.search() returns raw BM25-ranked results. SmartRecall
+ * re-ranks by blending three signals:
+ *   1. BM25 relevance (from FTS5)
+ *   2. Recency boost (newer entries score higher)
+ *   3. Frequency boost (often-recalled entries score higher)
+ *
+ * Also tracks access counts in a separate table so frequently-recalled
+ * entries rise in future queries.
+ *
+ * Table: recall_stats(memory_id TEXT PK, access_count INT, last_accessed INT)
+ */
+import { createLogger } from "../util/logger.js";
+const log = createLogger("learning.recall");
+// ── Config ────────────────────────────────────────────────────────
+/** How fast recency boost decays. 1.0 = 7-day half-life. */
+const RECENCY_HALF_LIFE_MS = 7 * 24 * 60 * 60_000;
+/** Max frequency boost (caps so one viral entry doesn't dominate). */
+const MAX_FREQUENCY_BOOST = 2.0;
+/** Weight blending: [bm25, recency, frequency]. Must sum to 1. */
+const WEIGHTS = { bm25: 0.5, recency: 0.3, frequency: 0.2 };
+// ── Schema ────────────────────────────────────────────────────────
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS recall_stats (
+  memory_id     TEXT PRIMARY KEY,
+  access_count  INTEGER NOT NULL DEFAULT 0,
+  last_accessed INTEGER NOT NULL
+);
+`;
+// ── SmartRecall ───────────────────────────────────────────────────
+export class SmartRecall {
+    db;
+    memory;
+    stmts;
+    constructor(db, memory) {
+        this.db = db;
+        this.memory = memory;
+        db.exec(SCHEMA);
+        this.stmts = this.prepareStatements();
+        log.debug("smart recall initialized");
+    }
+    /**
+     * Recall memories matching `query`, re-ranked by relevance + recency + frequency.
+     *
+     * Fetches more candidates from FTS5 than `limit` to allow re-ranking,
+     * then returns the top `limit` after blending signals.
+     */
+    recall(query, limit = 10) {
+        if (!query.trim())
+            return [];
+        // Fetch 3x candidates to give re-ranking room
+        const candidateLimit = Math.min(limit * 3, 100);
+        const raw = this.memory.search(query, { limit: candidateLimit });
+        if (raw.length === 0)
+            return [];
+        const now = Date.now();
+        // Load frequency stats for all candidates in one pass
+        const statsMap = this.loadStatsForIds(raw.map((r) => r.id));
+        // Normalize BM25 ranks to [0, 1] where 1 = best
+        const bm25Scores = normalizeBm25(raw);
+        // Score and rank
+        const scored = raw.map((hit, i) => {
+            const bm25Score = bm25Scores[i];
+            const recencyScore = computeRecency(hit.createdAt, now);
+            const stats = statsMap.get(hit.id);
+            const accessCount = stats?.access_count ?? 0;
+            const frequencyScore = computeFrequency(accessCount);
+            const score = WEIGHTS.bm25 * bm25Score +
+                WEIGHTS.recency * recencyScore +
+                WEIGHTS.frequency * frequencyScore;
+            return {
+                id: hit.id,
+                content: hit.content,
+                tags: hit.tags,
+                source: hit.source,
+                createdAt: hit.createdAt,
+                updatedAt: hit.updatedAt,
+                bm25Rank: hit.rank,
+                score,
+                accessCount,
+            };
+        });
+        // Sort by score descending, take top `limit`
+        scored.sort((a, b) => b.score - a.score);
+        const results = scored.slice(0, limit);
+        // Track access for returned results
+        this.recordAccess(results.map((r) => r.id), now);
+        log.debug({ query, candidates: raw.length, returned: results.length }, "smart recall complete");
+        return results;
+    }
+    /**
+     * Get access stats for a specific memory entry.
+     */
+    getStats(memoryId) {
+        const row = this.stmts.getStats.get(memoryId);
+        if (!row)
+            return null;
+        return { accessCount: row.access_count, lastAccessed: row.last_accessed };
+    }
+    /**
+     * Reset access stats for a memory entry (e.g. after content update).
+     */
+    resetStats(memoryId) {
+        this.stmts.deleteStats.run(memoryId);
+    }
+    // ── Internals ─────────────────────────────────────────────────
+    loadStatsForIds(ids) {
+        const map = new Map();
+        // SQLite doesn't support array binds — batch in chunks
+        for (let i = 0; i < ids.length; i += 50) {
+            const chunk = ids.slice(i, i + 50);
+            const placeholders = chunk.map(() => "?").join(",");
+            const rows = this.db
+                .prepare(`SELECT memory_id, access_count, last_accessed FROM recall_stats WHERE memory_id IN (${placeholders})`)
+                .all(...chunk);
+            for (const row of rows) {
+                map.set(row.memory_id, row);
+            }
+        }
+        return map;
+    }
+    recordAccess(ids, now) {
+        const upsert = this.stmts.upsertStats;
+        const tx = this.db.transaction(() => {
+            for (const id of ids) {
+                upsert.run(id, now);
+            }
+        });
+        tx();
+    }
+    prepareStatements() {
+        return {
+            upsertStats: this.db.prepare(`INSERT INTO recall_stats (memory_id, access_count, last_accessed)
+         VALUES (?, 1, ?)
+         ON CONFLICT(memory_id) DO UPDATE SET
+           access_count = access_count + 1,
+           last_accessed = excluded.last_accessed`),
+            getStats: this.db.prepare(`SELECT memory_id, access_count, last_accessed FROM recall_stats WHERE memory_id = ?`),
+            deleteStats: this.db.prepare(`DELETE FROM recall_stats WHERE memory_id = ?`),
+        };
+    }
+}
+// ── Scoring helpers ───────────────────────────────────────────────
+/**
+ * Normalize BM25 ranks to [0, 1]. FTS5 BM25 is negative (more negative
+ * = more relevant). We invert and scale so the best match gets 1.0.
+ */
+function normalizeBm25(hits) {
+    if (hits.length === 0)
+        return [];
+    if (hits.length === 1)
+        return [1.0];
+    const ranks = hits.map((h) => h.rank);
+    const min = Math.min(...ranks); // most relevant (most negative)
+    const max = Math.max(...ranks); // least relevant
+    const range = max - min;
+    if (range === 0)
+        return hits.map(() => 1.0);
+    // Invert: min rank → 1.0, max rank → 0.0
+    return ranks.map((r) => 1.0 - (r - min) / range);
+}
+/**
+ * Recency score: exponential decay with configurable half-life.
+ * Returns [0, 1] where 1 = just created.
+ */
+function computeRecency(createdAt, now) {
+    const ageMs = Math.max(0, now - createdAt);
+    return Math.pow(0.5, ageMs / RECENCY_HALF_LIFE_MS);
+}
+/**
+ * Frequency score: log-scaled access count, capped at MAX_FREQUENCY_BOOST.
+ * Returns [0, 1] normalized.
+ */
+function computeFrequency(accessCount) {
+    if (accessCount <= 0)
+        return 0;
+    const raw = Math.log2(1 + accessCount);
+    return Math.min(raw / MAX_FREQUENCY_BOOST, 1.0);
+}
+//# sourceMappingURL=SmartRecall.js.map

package/dist/learning/SmartRecall.js.map

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

package/dist/mcp/MCPIntegrationBridge.d.ts

@@ -0,0 +1,40 @@
+/**
+ * MCPIntegrationBridge — pipes OAuth access tokens from
+ * IntegrationManager into MCPManager so remote MCP servers
+ * (GitHub, Notion, …) authenticate against the user's connected
+ * accounts without ever writing the token to disk.
+ *
+ * How it works:
+ *   • A small in-memory `tokenCache` maps integration id → current
+ *     access token.
+ *   • The bridge installs a lookup function on MCPManager via
+ *     `setIntegrationTokenProvider()`. MCPManager's `${INTEGRATION:<id>}`
+ *     placeholder expansion reads from that function on every call.
+ *   • On `IntegrationManager` lifecycle events (`connected`,
+ *     `refreshed`, `disconnected`) we update the cache and, for
+ *     integrations bound to an MCP server, toggle the server's
+ *     enabled state + reconnect it so discovery runs with a valid
+ *     credential.
+ *
+ * This keeps MCPManager unaware of the OAuth machinery and keeps
+ * IntegrationManager unaware of MCP — the bridge is the only place
+ * they meet.
+ */
+import type { IntegrationManager } from "../integrations/IntegrationManager.js";
+import type { MCPManager } from "./MCPManager.js";
+import type { MCPStore } from "./MCPStore.js";
+export declare class MCPIntegrationBridge {
+    private readonly integrations;
+    private readonly mcp;
+    private readonly mcpStore;
+    /** integration id (lowercase) → current OAuth access token. */
+    private readonly tokenCache;
+    constructor(integrations: IntegrationManager, mcp: MCPManager, mcpStore: MCPStore);
+    /** On startup, prime the cache from already-connected accounts. */
+    private seedFromConnected;
+    private subscribe;
+    private refreshToken;
+    private ensureEnabledAndReconnect;
+    private reconnectMcpFor;
+}
+//# sourceMappingURL=MCPIntegrationBridge.d.ts.map

package/dist/mcp/MCPIntegrationBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MCPIntegrationBridge.d.ts","sourceRoot":"","sources":["../../src/mcp/MCPIntegrationBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAc9C,qBAAa,oBAAoB;IAK7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN3B,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;gBAGrC,YAAY,EAAE,kBAAkB,EAChC,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,QAAQ;IAOrC,mEAAmE;YACrD,iBAAiB;IAe/B,OAAO,CAAC,SAAS;YAgCH,YAAY;YAMZ,yBAAyB;YAYzB,eAAe;CAY9B"}

package/dist/mcp/MCPIntegrationBridge.js

@@ -0,0 +1,136 @@
+/**
+ * MCPIntegrationBridge — pipes OAuth access tokens from
+ * IntegrationManager into MCPManager so remote MCP servers
+ * (GitHub, Notion, …) authenticate against the user's connected
+ * accounts without ever writing the token to disk.
+ *
+ * How it works:
+ *   • A small in-memory `tokenCache` maps integration id → current
+ *     access token.
+ *   • The bridge installs a lookup function on MCPManager via
+ *     `setIntegrationTokenProvider()`. MCPManager's `${INTEGRATION:<id>}`
+ *     placeholder expansion reads from that function on every call.
+ *   • On `IntegrationManager` lifecycle events (`connected`,
+ *     `refreshed`, `disconnected`) we update the cache and, for
+ *     integrations bound to an MCP server, toggle the server's
+ *     enabled state + reconnect it so discovery runs with a valid
+ *     credential.
+ *
+ * This keeps MCPManager unaware of the OAuth machinery and keeps
+ * IntegrationManager unaware of MCP — the bridge is the only place
+ * they meet.
+ */
+import { createLogger } from "../util/logger.js";
+const log = createLogger("mcp.bridge");
+/**
+ * Integrations that are backed by a remote MCP server rather than a
+ * native REST client. The value is the MCP server name (as it appears
+ * in mcp.json / defaults.ts).
+ */
+const INTEGRATION_TO_MCP = {
+    github: "github",
+    notion: "notion",
+};
+export class MCPIntegrationBridge {
+    integrations;
+    mcp;
+    mcpStore;
+    /** integration id (lowercase) → current OAuth access token. */
+    tokenCache = new Map();
+    constructor(integrations, mcp, mcpStore) {
+        this.integrations = integrations;
+        this.mcp = mcp;
+        this.mcpStore = mcpStore;
+        this.mcp.setIntegrationTokenProvider((id) => this.tokenCache.get(id.toLowerCase()));
+        void this.seedFromConnected();
+        this.subscribe();
+    }
+    /** On startup, prime the cache from already-connected accounts. */
+    async seedFromConnected() {
+        const accounts = this.integrations.listAccounts();
+        for (const a of accounts) {
+            if (!(a.integration in INTEGRATION_TO_MCP))
+                continue;
+            await this.refreshToken(a.integration);
+        }
+        // Re-connect any MCP servers whose token we just cached so
+        // discovery sees the credential. If the server is disabled in
+        // mcp.json we leave it alone — user opt-in still wins.
+        for (const integration of Object.keys(INTEGRATION_TO_MCP)) {
+            if (!this.tokenCache.has(integration))
+                continue;
+            await this.reconnectMcpFor(integration);
+        }
+    }
+    subscribe() {
+        this.integrations.on("connected", async (ev) => {
+            if (!(ev.integration in INTEGRATION_TO_MCP))
+                return;
+            await this.refreshToken(ev.integration);
+            await this.ensureEnabledAndReconnect(ev.integration);
+        });
+        this.integrations.on("refreshed", async (ev) => {
+            if (!(ev.integration in INTEGRATION_TO_MCP))
+                return;
+            await this.refreshToken(ev.integration);
+            // No reconnect needed — MCPManager re-resolves headers on every
+            // HTTP call, so the new token is picked up automatically.
+        });
+        this.integrations.on("disconnected", async (ev) => {
+            if (!(ev.integration in INTEGRATION_TO_MCP))
+                return;
+            // Only clear if the user removed the last account for this
+            // integration — multiple accounts under one integration share
+            // one token cache slot (most-recent wins), so while other
+            // accounts remain we just refresh to the next one.
+            const stillHas = this.integrations.listAccounts(ev.integration).length > 0;
+            if (stillHas) {
+                await this.refreshToken(ev.integration);
+                return;
+            }
+            this.tokenCache.delete(ev.integration);
+            const serverName = INTEGRATION_TO_MCP[ev.integration];
+            if (!serverName)
+                return;
+            this.mcpStore.setEnabled(serverName, false);
+            await this.mcp.disconnect(serverName);
+            log.info({ integration: ev.integration, server: serverName }, "MCP server disabled on integration disconnect");
+        });
+    }
+    async refreshToken(integration) {
+        const token = await this.integrations.getAccessToken(integration);
+        if (token)
+            this.tokenCache.set(integration, token);
+        else
+            this.tokenCache.delete(integration);
+    }
+    async ensureEnabledAndReconnect(integration) {
+        const serverName = INTEGRATION_TO_MCP[integration];
+        if (!serverName)
+            return;
+        const cfg = this.mcpStore.get(serverName);
+        if (!cfg) {
+            log.warn({ integration, server: serverName }, "MCP server not in config — skipping enable");
+            return;
+        }
+        if (cfg.enabled === false)
+            this.mcpStore.setEnabled(serverName, true);
+        await this.reconnectMcpFor(integration);
+    }
+    async reconnectMcpFor(integration) {
+        const serverName = INTEGRATION_TO_MCP[integration];
+        if (!serverName)
+            return;
+        const cfg = this.mcpStore.get(serverName);
+        if (!cfg || cfg.enabled === false)
+            return;
+        try {
+            await this.mcp.connect(cfg);
+            log.info({ integration, server: serverName }, "MCP server reconnected with fresh integration token");
+        }
+        catch (e) {
+            log.error({ integration, server: serverName, err: e.message }, "MCP reconnect failed");
+        }
+    }
+}
+//# sourceMappingURL=MCPIntegrationBridge.js.map

package/dist/mcp/MCPIntegrationBridge.js.map

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