context-mem 0.1.0

package/dist/core/budget.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BudgetManager = void 0;
+class BudgetManager {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    configure(config) {
+        const current = this.getConfig();
+        const updated = { ...current, ...config };
+        this.storage.exec('INSERT OR REPLACE INTO budget_settings (id, session_limit, overflow_strategy, agent_limits) VALUES (?, ?, ?, ?)', [
+            1,
+            updated.session_limit,
+            updated.overflow_strategy,
+            updated.agent_limits ? JSON.stringify(updated.agent_limits) : null,
+        ]);
+    }
+    check(sessionId) {
+        const config = this.getConfig();
+        const row = this.storage
+            .prepare('SELECT COALESCE(SUM(tokens_in), 0) AS used FROM token_stats WHERE session_id = ?')
+            .get(sessionId);
+        const used = row?.used ?? 0;
+        const percentage = config.session_limit > 0 ? (used / config.session_limit) * 100 : 0;
+        return {
+            used,
+            limit: config.session_limit,
+            percentage,
+            strategy: config.overflow_strategy,
+            throttled: percentage >= 80,
+            blocked: percentage >= 100,
+        };
+    }
+    record(_sessionId, _bytes) {
+        // Budget tracking is handled via token_stats table.
+        // This method exists as a hook for additional budget-specific metrics.
+    }
+    getStatus(sessionId) {
+        return this.check(sessionId);
+    }
+    getConfig() {
+        const row = this.storage
+            .prepare('SELECT session_limit, overflow_strategy, agent_limits FROM budget_settings WHERE id = 1')
+            .get();
+        if (!row) {
+            return {
+                session_limit: 128_000,
+                overflow_strategy: 'warn',
+            };
+        }
+        return {
+            session_limit: row.session_limit,
+            overflow_strategy: row.overflow_strategy,
+            agent_limits: row.agent_limits ? JSON.parse(row.agent_limits) : undefined,
+        };
+    }
+}
+exports.BudgetManager = BudgetManager;
+//# sourceMappingURL=budget.js.map

package/dist/core/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/core/budget.ts"],"names":[],"mappings":";;;AAEA,MAAa,aAAa;IACJ;IAApB,YAAoB,OAAsB;QAAtB,YAAO,GAAP,OAAO,CAAe;IAAG,CAAC;IAE9C,SAAS,CAAC,MAA6B;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,OAAO,GAAiB,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;QAExD,IAAI,CAAC,OAAO,CAAC,IAAI,CACf,iHAAiH,EACjH;YACE,CAAC;YACD,OAAO,CAAC,aAAa;YACrB,OAAO,CAAC,iBAAiB;YACzB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;SACnE,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAiB;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAEhC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO;aACrB,OAAO,CAAC,kFAAkF,CAAC;aAC3F,GAAG,CAAC,SAAS,CAAiC,CAAC;QAElD,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,IAAI,CAAC,CAAC;QAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtF,OAAO;YACL,IAAI;YACJ,KAAK,EAAE,MAAM,CAAC,aAAa;YAC3B,UAAU;YACV,QAAQ,EAAE,MAAM,CAAC,iBAAiB;YAClC,SAAS,EAAE,UAAU,IAAI,EAAE;YAC3B,OAAO,EAAE,UAAU,IAAI,GAAG;SAC3B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,UAAkB,EAAE,MAAc;QACvC,oDAAoD;QACpD,uEAAuE;IACzE,CAAC;IAED,SAAS,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAED,SAAS;QACP,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO;aACrB,OAAO,CAAC,yFAAyF,CAAC;aAClG,GAAG,EAA6G,CAAC;QAEpH,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO;gBACL,aAAa,EAAE,OAAO;gBACtB,iBAAiB,EAAE,MAAM;aAC1B,CAAC;QACJ,CAAC;QAED,OAAO;YACL,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;YACxC,YAAY,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAA4B,CAAC,CAAC,CAAC,SAAS;SACtG,CAAC;IACJ,CAAC;CACF;AAjED,sCAiEC"}

package/dist/core/config.d.ts

@@ -0,0 +1,4 @@
+import { type ContextMemConfig } from './types.js';
+export declare function mergeConfig(partial: Record<string, unknown>): ContextMemConfig;
+export declare function loadConfig(projectDir: string): ContextMemConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnE,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAG9E;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAS/D"}

package/dist/core/config.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeConfig = mergeConfig;
+exports.loadConfig = loadConfig;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const types_js_1 = require("./types.js");
+function mergeConfig(partial) {
+    const base = structuredClone(types_js_1.DEFAULT_CONFIG);
+    return deepMerge(base, partial);
+}
+function loadConfig(projectDir) {
+    const configPath = node_path_1.default.join(projectDir, '.context-mem.json');
+    try {
+        const raw = node_fs_1.default.readFileSync(configPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        return mergeConfig(parsed);
+    }
+    catch {
+        return structuredClone(types_js_1.DEFAULT_CONFIG);
+    }
+}
+function deepMerge(target, source) {
+    for (const key of Object.keys(source)) {
+        if (key === '__proto__' || key === 'constructor' || key === 'prototype')
+            continue;
+        const tVal = target[key];
+        const sVal = source[key];
+        if (sVal && typeof sVal === 'object' && !Array.isArray(sVal) && tVal && typeof tVal === 'object' && !Array.isArray(tVal)) {
+            target[key] = deepMerge(tVal, sVal);
+        }
+        else {
+            target[key] = sVal;
+        }
+    }
+    return target;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":";;;;;AAIA,kCAGC;AAED,gCASC;AAlBD,sDAAyB;AACzB,0DAA6B;AAC7B,yCAAmE;AAEnE,SAAgB,WAAW,CAAC,OAAgC;IAC1D,MAAM,IAAI,GAAG,eAAe,CAAC,yBAAc,CAAuC,CAAC;IACnF,OAAO,SAAS,CAAC,IAAI,EAAE,OAAO,CAAgC,CAAC;AACjE,CAAC;AAED,SAAgB,UAAU,CAAC,UAAkB;IAC3C,MAAM,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,iBAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,eAAe,CAAC,yBAAc,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,MAA+B,EAAE,MAA+B;IACjF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,WAAW;YAAE,SAAS;QAClF,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACzH,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,IAA+B,EAAE,IAA+B,CAAC,CAAC;QAC5F,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/events.d.ts

@@ -0,0 +1,19 @@
+import type { StoragePlugin, ContextEvent, EventPriority } from './types.js';
+export declare class EventTracker {
+    private storage;
+    constructor(storage: StoragePlugin);
+    emit(sessionId: string, eventType: string, data?: Record<string, unknown>, agent?: string): ContextEvent;
+    query(sessionId: string, opts?: {
+        event_type?: string;
+        priority?: EventPriority;
+        limit?: number;
+        from?: number;
+        to?: number;
+    }): ContextEvent[];
+    detectErrorFix(sessionId: string): Array<{
+        error_event: string;
+        fix_event: string;
+        file: string;
+    }>;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/core/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAe7E,qBAAa,YAAY;IACX,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAE1C,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,KAAK,CAAC,EAAE,MAAM,GACb,YAAY;IA8Bf,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;QACJ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,aAAa,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;KACR,GACL,YAAY,EAAE;IAsCjB,cAAc,CACZ,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAuBnE"}

package/dist/core/events.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventTracker = void 0;
+const utils_js_1 = require("./utils.js");
+const EVENT_PRIORITIES = {
+    task_start: 1,
+    task_complete: 1,
+    error: 1,
+    file_modify: 2,
+    decision: 2,
+    dependency_change: 3,
+    knowledge_save: 3,
+    file_read: 4,
+    search: 4,
+};
+class EventTracker {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    emit(sessionId, eventType, data = {}, agent) {
+        const priority = EVENT_PRIORITIES[eventType] || 4;
+        const event = {
+            id: (0, utils_js_1.ulid)(),
+            session_id: sessionId,
+            event_type: eventType,
+            priority,
+            agent,
+            data,
+            context_bytes: Buffer.byteLength(JSON.stringify(data), 'utf8'),
+            timestamp: Date.now(),
+        };
+        this.storage.exec('INSERT INTO events (id, session_id, event_type, priority, agent, data, context_bytes, timestamp) VALUES (?, ?, ?, ?, ?, ?, ?, ?)', [
+            event.id,
+            event.session_id,
+            event.event_type,
+            event.priority,
+            event.agent || null,
+            JSON.stringify(event.data),
+            event.context_bytes,
+            event.timestamp,
+        ]);
+        return event;
+    }
+    query(sessionId, opts = {}) {
+        let sql = 'SELECT * FROM events WHERE session_id = ?';
+        const params = [sessionId];
+        if (opts.event_type) {
+            sql += ' AND event_type = ?';
+            params.push(opts.event_type);
+        }
+        if (opts.priority) {
+            sql += ' AND priority <= ?';
+            params.push(opts.priority);
+        }
+        if (opts.from !== undefined) {
+            sql += ' AND timestamp >= ?';
+            params.push(opts.from);
+        }
+        if (opts.to !== undefined) {
+            sql += ' AND timestamp <= ?';
+            params.push(opts.to);
+        }
+        sql += ' ORDER BY timestamp DESC, rowid DESC LIMIT ?';
+        params.push(opts.limit || 50);
+        const rows = this.storage.prepare(sql).all(...params);
+        return rows.map((r) => ({
+            id: r.id,
+            session_id: r.session_id,
+            event_type: r.event_type,
+            priority: r.priority,
+            agent: r.agent,
+            data: JSON.parse(r.data),
+            context_bytes: r.context_bytes,
+            timestamp: r.timestamp,
+        }));
+    }
+    detectErrorFix(sessionId) {
+        const events = this.query(sessionId, { limit: 100 });
+        const fixes = [];
+        // Walk events in chronological order (reverse since query returns DESC)
+        const chronological = [...events].reverse();
+        let lastError = null;
+        for (const evt of chronological) {
+            if (evt.event_type === 'error') {
+                lastError = evt;
+            }
+            else if (evt.event_type === 'file_modify' && lastError) {
+                fixes.push({
+                    error_event: lastError.id,
+                    fix_event: evt.id,
+                    file: evt.data.file || 'unknown',
+                });
+                lastError = null;
+            }
+        }
+        return fixes;
+    }
+}
+exports.EventTracker = EventTracker;
+//# sourceMappingURL=events.js.map

package/dist/core/events.js.map

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

package/dist/core/kernel.d.ts

@@ -0,0 +1,46 @@
+import { PluginRegistry } from './plugin-registry.js';
+import { Pipeline } from './pipeline.js';
+import { SearchFusion } from '../plugins/search/fusion.js';
+import { BetterSqlite3Storage } from '../plugins/storage/better-sqlite3.js';
+import { BudgetManager } from './budget.js';
+import { EventTracker } from './events.js';
+import { SessionManager } from './session.js';
+import { ContentStore } from '../plugins/storage/content-store.js';
+import { KnowledgeBase } from '../plugins/knowledge/knowledge-base.js';
+import type { SessionContext, ContextMemConfig, SearchResult, Observation, TokenEconomics, SearchOpts } from './types.js';
+export declare class Kernel {
+    readonly registry: PluginRegistry;
+    readonly session: SessionContext;
+    pipeline: Pipeline;
+    private config;
+    private projectDir;
+    private searchFusion;
+    private storage;
+    budgetManager: BudgetManager;
+    eventTracker: EventTracker;
+    sessionManager: SessionManager;
+    contentStore: ContentStore;
+    knowledgeBase: KnowledgeBase;
+    constructor(projectDir: string);
+    start(): Promise<void>;
+    private ensureStarted;
+    /** Safe accessors for ToolKernel adapter */
+    getConfig(): ContextMemConfig;
+    getStorage(): BetterSqlite3Storage;
+    getSearchFusion(): SearchFusion;
+    getBudgetManager(): BudgetManager;
+    getEventTracker(): EventTracker;
+    getSessionManager(): SessionManager;
+    getContentStore(): ContentStore;
+    getKnowledgeBase(): KnowledgeBase;
+    observe(content: string, type: Observation['type'], source: string, filePath?: string): Promise<Observation>;
+    search(query: string, opts?: SearchOpts): Promise<SearchResult[]>;
+    get(id: string): Promise<Observation | null>;
+    stats(): Promise<TokenEconomics>;
+    stop(): Promise<void>;
+    restoreSession(sessionId: string): Promise<{
+        snapshot: Record<string, unknown>;
+        condensed: boolean;
+    } | null>;
+}
+//# sourceMappingURL=kernel.d.ts.map

package/dist/core/kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/core/kernel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAsB5E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,qBAAa,MAAM;IACjB,QAAQ,CAAC,QAAQ,iBAAwB;IACzC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,EAAG,QAAQ,CAAC;IACpB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,OAAO,CAAwB;IACvC,aAAa,EAAG,aAAa,CAAC;IAC9B,YAAY,EAAG,YAAY,CAAC;IAC5B,cAAc,EAAG,cAAc,CAAC;IAChC,YAAY,EAAG,YAAY,CAAC;IAC5B,aAAa,EAAG,aAAa,CAAC;gBAElB,UAAU,EAAE,MAAM;IAUxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8D5B,OAAO,CAAC,aAAa;IAIrB,4CAA4C;IAC5C,SAAS,IAAI,gBAAgB;IAC7B,UAAU,IAAI,oBAAoB;IAClC,eAAe,IAAI,YAAY;IAC/B,gBAAgB,IAAI,aAAa;IACjC,eAAe,IAAI,YAAY;IAC/B,iBAAiB,IAAI,cAAc;IACnC,eAAe,IAAI,YAAY;IAC/B,gBAAgB,IAAI,aAAa;IAE3B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAY5G,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmBjE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA4B5C,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC;IA8BhC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBrB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAInH"}

package/dist/core/kernel.js

@@ -0,0 +1,228 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Kernel = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const plugin_registry_js_1 = require("./plugin-registry.js");
+const pipeline_js_1 = require("./pipeline.js");
+const config_js_1 = require("./config.js");
+const utils_js_1 = require("./utils.js");
+const fusion_js_1 = require("../plugins/search/fusion.js");
+const better_sqlite3_js_1 = require("../plugins/storage/better-sqlite3.js");
+const privacy_engine_js_1 = require("../plugins/privacy/privacy-engine.js");
+// Summarizers — registered in priority order
+const typescript_error_summarizer_js_1 = require("../plugins/summarizers/typescript-error-summarizer.js");
+const test_output_summarizer_js_1 = require("../plugins/summarizers/test-output-summarizer.js");
+const build_output_summarizer_js_1 = require("../plugins/summarizers/build-output-summarizer.js");
+const git_log_summarizer_js_1 = require("../plugins/summarizers/git-log-summarizer.js");
+const network_summarizer_js_1 = require("../plugins/summarizers/network-summarizer.js");
+const error_summarizer_js_1 = require("../plugins/summarizers/error-summarizer.js");
+const json_summarizer_js_1 = require("../plugins/summarizers/json-summarizer.js");
+const csv_summarizer_js_1 = require("../plugins/summarizers/csv-summarizer.js");
+const markdown_summarizer_js_1 = require("../plugins/summarizers/markdown-summarizer.js");
+const html_summarizer_js_1 = require("../plugins/summarizers/html-summarizer.js");
+const code_summarizer_js_1 = require("../plugins/summarizers/code-summarizer.js");
+const log_summarizer_js_1 = require("../plugins/summarizers/log-summarizer.js");
+const shell_summarizer_js_1 = require("../plugins/summarizers/shell-summarizer.js");
+const binary_summarizer_js_1 = require("../plugins/summarizers/binary-summarizer.js");
+// Search
+const bm25_js_1 = require("../plugins/search/bm25.js");
+const trigram_js_1 = require("../plugins/search/trigram.js");
+const levenshtein_js_1 = require("../plugins/search/levenshtein.js");
+// Core modules
+const budget_js_1 = require("./budget.js");
+const events_js_1 = require("./events.js");
+const session_js_1 = require("./session.js");
+const content_store_js_1 = require("../plugins/storage/content-store.js");
+const knowledge_base_js_1 = require("../plugins/knowledge/knowledge-base.js");
+const lifecycle_js_1 = require("./lifecycle.js");
+class Kernel {
+    registry = new plugin_registry_js_1.PluginRegistry();
+    session;
+    pipeline;
+    config;
+    projectDir;
+    searchFusion;
+    storage;
+    budgetManager;
+    eventTracker;
+    sessionManager;
+    contentStore;
+    knowledgeBase;
+    constructor(projectDir) {
+        this.projectDir = projectDir;
+        this.config = (0, config_js_1.loadConfig)(projectDir);
+        this.session = {
+            session_id: (0, utils_js_1.ulid)(),
+            platform: 'unknown',
+            started_at: Date.now(),
+        };
+    }
+    async start() {
+        // Resolve db_path relative to projectDir if not absolute
+        const dbPath = node_path_1.default.isAbsolute(this.config.db_path)
+            ? this.config.db_path
+            : node_path_1.default.join(this.projectDir, this.config.db_path);
+        // 1. Storage
+        this.storage = new better_sqlite3_js_1.BetterSqlite3Storage();
+        await this.storage.open(dbPath);
+        await this.registry.register(this.storage);
+        // 2. Privacy
+        const privacy = new privacy_engine_js_1.PrivacyEngine(this.config.privacy);
+        // 3. Core modules
+        this.budgetManager = new budget_js_1.BudgetManager(this.storage);
+        this.eventTracker = new events_js_1.EventTracker(this.storage);
+        this.sessionManager = new session_js_1.SessionManager(this.storage, this.eventTracker);
+        this.contentStore = new content_store_js_1.ContentStore(this.storage);
+        this.knowledgeBase = new knowledge_base_js_1.KnowledgeBase(this.storage);
+        // 4. Pipeline (with budget integration)
+        this.pipeline = new pipeline_js_1.Pipeline(this.registry, this.storage, privacy, this.session.session_id);
+        this.pipeline.setBudgetManager(this.budgetManager);
+        // 5. Summarizers — registered in priority order (most specific first)
+        const summarizers = [
+            new typescript_error_summarizer_js_1.TypescriptErrorSummarizer(), // Before generic Error
+            new test_output_summarizer_js_1.TestOutputSummarizer(), // Before Shell
+            new build_output_summarizer_js_1.BuildOutputSummarizer(), // Before Shell
+            new git_log_summarizer_js_1.GitLogSummarizer(),
+            new network_summarizer_js_1.NetworkSummarizer(),
+            new error_summarizer_js_1.ErrorSummarizer(),
+            new json_summarizer_js_1.JsonSummarizer(),
+            new csv_summarizer_js_1.CsvSummarizer(),
+            new markdown_summarizer_js_1.MarkdownSummarizer(),
+            new html_summarizer_js_1.HtmlSummarizer(),
+            new code_summarizer_js_1.CodeSummarizer(),
+            new log_summarizer_js_1.LogSummarizer(),
+            new shell_summarizer_js_1.ShellSummarizer(),
+            new binary_summarizer_js_1.BinarySummarizer(), // Always last (catches binary)
+        ];
+        for (const s of summarizers) {
+            await this.registry.register(s);
+        }
+        // 6. Search plugins (with Levenshtein fallback)
+        const bm25 = new bm25_js_1.BM25Search(this.storage);
+        const trigram = new trigram_js_1.TrigramSearch(this.storage);
+        const levenshtein = new levenshtein_js_1.LevenshteinSearch(this.storage);
+        await this.registry.register(bm25);
+        await this.registry.register(trigram);
+        await this.registry.register(levenshtein);
+        this.searchFusion = new fusion_js_1.SearchFusion([bm25, trigram, levenshtein]);
+        // 7. Lifecycle cleanup (on_startup)
+        if (this.config.lifecycle.cleanup_schedule === 'on_startup') {
+            const lifecycle = new lifecycle_js_1.LifecycleManager(this.storage, this.config.lifecycle);
+            await lifecycle.cleanup();
+        }
+    }
+    ensureStarted() {
+        if (!this.storage)
+            throw new Error('Kernel not started. Call start() first.');
+    }
+    /** Safe accessors for ToolKernel adapter */
+    getConfig() { this.ensureStarted(); return this.config; }
+    getStorage() { this.ensureStarted(); return this.storage; }
+    getSearchFusion() { this.ensureStarted(); return this.searchFusion; }
+    getBudgetManager() { this.ensureStarted(); return this.budgetManager; }
+    getEventTracker() { this.ensureStarted(); return this.eventTracker; }
+    getSessionManager() { this.ensureStarted(); return this.sessionManager; }
+    getContentStore() { this.ensureStarted(); return this.contentStore; }
+    getKnowledgeBase() { this.ensureStarted(); return this.knowledgeBase; }
+    async observe(content, type, source, filePath) {
+        const obs = await this.pipeline.observe(content, type, source, filePath);
+        // Auto-emit event
+        this.eventTracker.emit(this.session.session_id, type === 'error' ? 'error' : 'file_read', {
+            observation_id: obs.id,
+            type,
+            source,
+            file_path: filePath,
+        });
+        return obs;
+    }
+    async search(query, opts) {
+        this.ensureStarted();
+        const results = await this.searchFusion.execute(query, opts || {});
+        // Track discovery token economics
+        const discoveryTokens = results.reduce((sum, r) => sum + (0, utils_js_1.estimateTokens)(r.snippet), 0);
+        if (this.storage && results.length > 0) {
+            this.storage.exec('INSERT INTO token_stats (session_id, event_type, tokens_in, tokens_out, timestamp) VALUES (?, ?, ?, ?, ?)', [this.session.session_id, 'discovery', 0, discoveryTokens, Date.now()]);
+        }
+        // Auto-emit search event
+        this.eventTracker.emit(this.session.session_id, 'search', {
+            query,
+            results_count: results.length,
+        });
+        return results;
+    }
+    async get(id) {
+        this.ensureStarted();
+        const row = this.storage.prepare('SELECT * FROM observations WHERE id = ?').get(id);
+        if (!row)
+            return null;
+        // Track read token economics
+        this.storage.exec('INSERT INTO token_stats (session_id, event_type, tokens_in, tokens_out, timestamp) VALUES (?, ?, ?, ?, ?)', [this.session.session_id, 'read', 0, (0, utils_js_1.estimateTokens)(row.content), Date.now()]);
+        let metadata = {};
+        try {
+            metadata = JSON.parse(row.metadata);
+        }
+        catch {
+            // malformed metadata — leave empty
+        }
+        return {
+            id: row.id,
+            type: row.type,
+            content: row.content,
+            summary: (row.summary ?? undefined),
+            metadata: metadata,
+            indexed_at: row.indexed_at,
+        };
+    }
+    async stats() {
+        this.ensureStarted();
+        const sid = this.session.session_id;
+        const q = (sql) => {
+            const row = this.storage.prepare(sql).get(sid);
+            return row?.v ?? 0;
+        };
+        const storedV = q("SELECT COUNT(*) as v FROM token_stats WHERE session_id = ? AND event_type = 'store'");
+        const contentBytesV = q("SELECT COALESCE(SUM(tokens_in),0) as v FROM token_stats WHERE session_id = ? AND event_type = 'store'");
+        const summaryBytesV = q("SELECT COALESCE(SUM(tokens_out),0) as v FROM token_stats WHERE session_id = ? AND event_type = 'store'");
+        const searchesV = q("SELECT COUNT(*) as v FROM token_stats WHERE session_id = ? AND event_type = 'discovery'");
+        const discoveryV = q("SELECT COALESCE(SUM(tokens_out),0) as v FROM token_stats WHERE session_id = ? AND event_type = 'discovery'");
+        const readsV = q("SELECT COALESCE(SUM(tokens_out),0) as v FROM token_stats WHERE session_id = ? AND event_type = 'read'");
+        const saved = contentBytesV - (discoveryV + readsV);
+        return {
+            session_id: sid,
+            observations_stored: storedV,
+            total_content_bytes: contentBytesV,
+            total_summary_bytes: summaryBytesV,
+            searches_performed: searchesV,
+            discovery_tokens: discoveryV,
+            read_tokens: readsV,
+            tokens_saved: Math.max(0, saved),
+            savings_percentage: contentBytesV > 0 ? Math.round((saved / contentBytesV) * 100) : 0,
+        };
+    }
+    async stop() {
+        // Save session snapshot before shutdown
+        if (this.storage && this.sessionManager) {
+            try {
+                const tokenStats = await this.stats();
+                this.sessionManager.saveSnapshot(this.session.session_id, tokenStats);
+            }
+            catch {
+                // Snapshot save failed — non-critical
+            }
+        }
+        // Session-scoped private cleanup
+        if (this.storage) {
+            this.storage.exec(`DELETE FROM observations WHERE privacy_level = 'private' AND session_id = ?`, [this.session.session_id]);
+        }
+        await this.registry.shutdown();
+    }
+    async restoreSession(sessionId) {
+        this.ensureStarted();
+        return this.sessionManager.restoreSnapshot(sessionId);
+    }
+}
+exports.Kernel = Kernel;
+//# sourceMappingURL=kernel.js.map

package/dist/core/kernel.js.map

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

package/dist/core/lifecycle.d.ts

@@ -0,0 +1,19 @@
+import type { StoragePlugin, ObservationType } from './types.js';
+export interface LifecycleConfig {
+    ttl_days: number;
+    max_db_size_mb: number;
+    max_observations: number;
+    preserve_types: ObservationType[];
+}
+export declare class LifecycleManager {
+    private storage;
+    private config;
+    constructor(storage: StoragePlugin, config: LifecycleConfig);
+    cleanup(): Promise<{
+        deleted: number;
+    }>;
+    cleanupSession(sessionId: string): Promise<{
+        deleted: number;
+    }>;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/core/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/core/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,eAAe,EAAE,CAAC;CACnC;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;gBADN,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,eAAe;IAG3B,OAAO,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA0BvC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAMtE"}

package/dist/core/lifecycle.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LifecycleManager = void 0;
+class LifecycleManager {
+    storage;
+    config;
+    constructor(storage, config) {
+        this.storage = storage;
+        this.config = config;
+    }
+    async cleanup() {
+        let deleted = 0;
+        // 1. TTL — delete old observations (skip preserved types)
+        const cutoff = Date.now() - (this.config.ttl_days * 24 * 60 * 60 * 1000);
+        const preservePlaceholders = this.config.preserve_types.map(() => '?').join(',');
+        const ttlResult = this.storage.prepare(`DELETE FROM observations WHERE indexed_at < ? AND type NOT IN (${preservePlaceholders})`).run(cutoff, ...this.config.preserve_types);
+        deleted += ttlResult.changes;
+        // 2. Count cap — delete oldest if over max_observations (skip preserved types)
+        const countRow = this.storage.prepare('SELECT COUNT(*) as cnt FROM observations').get();
+        if (countRow.cnt > this.config.max_observations) {
+            const excess = countRow.cnt - this.config.max_observations;
+            const capResult = this.storage.prepare(`DELETE FROM observations WHERE id IN (
+          SELECT id FROM observations WHERE type NOT IN (${preservePlaceholders}) ORDER BY indexed_at ASC LIMIT ?
+        )`).run(...this.config.preserve_types, excess);
+            deleted += capResult.changes;
+        }
+        return { deleted };
+    }
+    async cleanupSession(sessionId) {
+        const result = this.storage.prepare(`DELETE FROM observations WHERE privacy_level = 'private' AND session_id = ?`).run(sessionId);
+        return { deleted: result.changes };
+    }
+}
+exports.LifecycleManager = LifecycleManager;
+//# sourceMappingURL=lifecycle.js.map

package/dist/core/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/core/lifecycle.ts"],"names":[],"mappings":";;;AASA,MAAa,gBAAgB;IAEjB;IACA;IAFV,YACU,OAAsB,EACtB,MAAuB;QADvB,YAAO,GAAP,OAAO,CAAe;QACtB,WAAM,GAAN,MAAM,CAAiB;IAC9B,CAAC;IAEJ,KAAK,CAAC,OAAO;QACX,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,0DAA0D;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QACzE,MAAM,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CACpC,kEAAkE,oBAAoB,GAAG,CAC1F,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAC7C,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC;QAE7B,+EAA+E;QAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC,GAAG,EAAqB,CAAC;QAC3G,IAAI,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;YAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CACpC;2DACmD,oBAAoB;UACrE,CACH,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;YAC7C,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC;QAC/B,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,SAAiB;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CACjC,6EAA6E,CAC9E,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC;CACF;AAtCD,4CAsCC"}

package/dist/core/observe-queue.d.ts

@@ -0,0 +1,18 @@
+import type { ObservationType } from './types.js';
+export interface QueueItem {
+    content: string;
+    type: ObservationType;
+    source: string;
+    filePath?: string;
+}
+export declare class ObserveQueue {
+    private queue;
+    private dedupMap;
+    private onFlush;
+    private flushing;
+    constructor(onFlush: (items: QueueItem[]) => Promise<void>);
+    enqueue(item: QueueItem): Promise<boolean>;
+    flush(): Promise<void>;
+    get size(): number;
+}
+//# sourceMappingURL=observe-queue.d.ts.map

package/dist/core/observe-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-queue.d.ts","sourceRoot":"","sources":["../../src/core/observe-queue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC;IAIpD,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IA+B1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,IAAI,IAAI,IAAI,MAAM,CAA8B;CACjD"}