@runcore-sh/runcore 0.1.2

package/dist/contacts/store.js

@@ -0,0 +1,278 @@
+/**
+ * Contacts store — append-only JSONL persistence for entities and edges.
+ * Follows src/queue/store.ts pattern.
+ * All data encrypted at rest via brain-io.
+ *
+ * Files: brain/contacts/entities.jsonl, brain/contacts/edges.jsonl
+ * Update strategy: append full updated record. On load, last occurrence per id wins.
+ */
+import { join } from "node:path";
+import { stat } from "node:fs/promises";
+import { createLogger } from "../utils/logger.js";
+import { readBrainLines, appendBrainLine, ensureBrainJsonl } from "../lib/brain-io.js";
+const log = createLogger("contacts.store");
+const ENTITY_SCHEMA = JSON.stringify({ _schema: "contact-entities", _version: "1.0" });
+const EDGE_SCHEMA = JSON.stringify({ _schema: "contact-edges", _version: "1.0" });
+function generateEntityId() {
+    const hex = Math.random().toString(16).slice(2, 10).padEnd(8, "0");
+    return `ent_${hex}`;
+}
+function generateEdgeId() {
+    const hex = Math.random().toString(16).slice(2, 10).padEnd(8, "0");
+    return `edg_${hex}`;
+}
+export class ContactStore {
+    entitiesPath;
+    edgesPath;
+    entityCache = null;
+    edgeCache = null;
+    entityMtime = 0;
+    edgeMtime = 0;
+    lastStaleCheckMs = 0;
+    constructor(brainDir) {
+        this.entitiesPath = join(brainDir, "contacts", "entities.jsonl");
+        this.edgesPath = join(brainDir, "contacts", "edges.jsonl");
+    }
+    // ── File management ──────────────────────────────────────────────────────
+    async ensureFiles() {
+        await ensureBrainJsonl(this.entitiesPath, ENTITY_SCHEMA);
+        await ensureBrainJsonl(this.edgesPath, EDGE_SCHEMA);
+    }
+    async checkStale() {
+        const now = Date.now();
+        if (now - this.lastStaleCheckMs < 5000)
+            return;
+        this.lastStaleCheckMs = now;
+        try {
+            if (this.entityCache) {
+                const s = await stat(this.entitiesPath);
+                if (s.mtimeMs > this.entityMtime)
+                    this.entityCache = null;
+            }
+            if (this.edgeCache) {
+                const s = await stat(this.edgesPath);
+                if (s.mtimeMs > this.edgeMtime)
+                    this.edgeCache = null;
+            }
+        }
+        catch {
+            // Files may not exist yet
+        }
+    }
+    // ── Load ──────────────────────────────────────────────────────────────────
+    async loadEntities() {
+        await this.checkStale();
+        if (this.entityCache)
+            return this.entityCache;
+        await this.ensureFiles();
+        const lines = await readBrainLines(this.entitiesPath);
+        const map = new Map();
+        for (const line of lines) {
+            try {
+                const obj = JSON.parse(line);
+                if (obj._schema)
+                    continue;
+                if (!obj.id)
+                    continue;
+                map.set(obj.id, obj);
+            }
+            catch {
+                continue;
+            }
+        }
+        this.entityCache = map;
+        try {
+            const s = await stat(this.entitiesPath);
+            this.entityMtime = s.mtimeMs;
+        }
+        catch { /* ok */ }
+        return map;
+    }
+    async loadEdges() {
+        await this.checkStale();
+        if (this.edgeCache)
+            return this.edgeCache;
+        await this.ensureFiles();
+        const lines = await readBrainLines(this.edgesPath);
+        const map = new Map();
+        for (const line of lines) {
+            try {
+                const obj = JSON.parse(line);
+                if (obj._schema)
+                    continue;
+                if (!obj.id)
+                    continue;
+                map.set(obj.id, obj);
+            }
+            catch {
+                continue;
+            }
+        }
+        this.edgeCache = map;
+        try {
+            const s = await stat(this.edgesPath);
+            this.edgeMtime = s.mtimeMs;
+        }
+        catch { /* ok */ }
+        return map;
+    }
+    invalidateEntities() { this.entityCache = null; }
+    invalidateEdges() { this.edgeCache = null; }
+    // ── Entity CRUD ──────────────────────────────────────────────────────────
+    async listEntities(filter) {
+        const map = await this.loadEntities();
+        let entities = Array.from(map.values());
+        if (filter?.type) {
+            entities = entities.filter((e) => e.type === filter.type);
+        }
+        if (filter?.status) {
+            entities = entities.filter((e) => e.status === filter.status);
+        }
+        else {
+            // Default: only active
+            entities = entities.filter((e) => e.status !== "archived");
+        }
+        entities.sort((a, b) => a.name.localeCompare(b.name));
+        return entities;
+    }
+    async getEntity(id) {
+        const map = await this.loadEntities();
+        return map.get(id) ?? null;
+    }
+    async createEntity(opts) {
+        const now = new Date().toISOString();
+        const entity = {
+            id: generateEntityId(),
+            type: opts.type,
+            name: opts.name,
+            aliases: opts.aliases,
+            channels: opts.channels,
+            meta: opts.meta,
+            notes: opts.notes,
+            tags: opts.tags,
+            status: "active",
+            createdAt: now,
+            updatedAt: now,
+        };
+        await appendBrainLine(this.entitiesPath, JSON.stringify(entity));
+        this.invalidateEntities();
+        log.info(`Created entity ${entity.id}: ${entity.name} (${entity.type})`);
+        return entity;
+    }
+    async updateEntity(id, changes) {
+        const existing = await this.getEntity(id);
+        if (!existing)
+            return null;
+        const updated = {
+            ...existing,
+            ...changes,
+            updatedAt: new Date().toISOString(),
+        };
+        await appendBrainLine(this.entitiesPath, JSON.stringify(updated));
+        this.invalidateEntities();
+        log.info(`Updated entity ${id}: ${updated.name}`);
+        return updated;
+    }
+    // ── Edge CRUD ────────────────────────────────────────────────────────────
+    async listEdges(filter) {
+        const map = await this.loadEdges();
+        let edges = Array.from(map.values());
+        if (filter?.type) {
+            edges = edges.filter((e) => e.type === filter.type);
+        }
+        if (filter?.entityId) {
+            edges = edges.filter((e) => e.from === filter.entityId || e.to === filter.entityId);
+        }
+        if (filter?.status) {
+            edges = edges.filter((e) => e.status === filter.status);
+        }
+        else {
+            edges = edges.filter((e) => e.status !== "archived");
+        }
+        return edges;
+    }
+    async getEdge(id) {
+        const map = await this.loadEdges();
+        return map.get(id) ?? null;
+    }
+    async createEdge(opts) {
+        const now = new Date().toISOString();
+        const edge = {
+            id: generateEdgeId(),
+            from: opts.from,
+            to: opts.to,
+            type: opts.type,
+            label: opts.label,
+            since: opts.since,
+            notes: opts.notes,
+            status: "active",
+            createdAt: now,
+            updatedAt: now,
+        };
+        await appendBrainLine(this.edgesPath, JSON.stringify(edge));
+        this.invalidateEdges();
+        log.info(`Created edge ${edge.id}: ${edge.from} -[${edge.type}]-> ${edge.to}`);
+        return edge;
+    }
+    async updateEdge(id, changes) {
+        const existing = await this.getEdge(id);
+        if (!existing)
+            return null;
+        const updated = {
+            ...existing,
+            ...changes,
+            updatedAt: new Date().toISOString(),
+        };
+        await appendBrainLine(this.edgesPath, JSON.stringify(updated));
+        this.invalidateEdges();
+        log.info(`Updated edge ${id}`);
+        return updated;
+    }
+    // ── Graph queries ────────────────────────────────────────────────────────
+    /** Get all edges where entity is from or to. */
+    async getRelationships(entityId) {
+        return this.listEdges({ entityId });
+    }
+    /** BFS traversal from entity to N hops. Returns entities and edges in the subgraph. */
+    async getGraph(entityId, depth = 1) {
+        const visited = new Set();
+        const resultEntities = [];
+        const resultEdges = [];
+        let frontier = [entityId];
+        for (let d = 0; d <= depth && frontier.length > 0; d++) {
+            const nextFrontier = [];
+            for (const id of frontier) {
+                if (visited.has(id))
+                    continue;
+                visited.add(id);
+                const entity = await this.getEntity(id);
+                if (entity)
+                    resultEntities.push(entity);
+                if (d < depth) {
+                    const edges = await this.getRelationships(id);
+                    for (const edge of edges) {
+                        resultEdges.push(edge);
+                        const neighbor = edge.from === id ? edge.to : edge.from;
+                        if (!visited.has(neighbor)) {
+                            nextFrontier.push(neighbor);
+                        }
+                    }
+                }
+            }
+            frontier = nextFrontier;
+        }
+        return { entities: resultEntities, edges: resultEdges };
+    }
+}
+// ── Singleton ──────────────────────────────────────────────────────────────
+let _store = null;
+export function createContactStore(brainDir) {
+    if (_store)
+        return _store;
+    _store = new ContactStore(brainDir);
+    return _store;
+}
+export function getContactStore() {
+    return _store;
+}
+//# sourceMappingURL=store.js.map

package/dist/contacts/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/contacts/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGvF,MAAM,GAAG,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAE3C,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACvF,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AAElF,SAAS,gBAAgB;IACvB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnE,OAAO,OAAO,GAAG,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnE,OAAO,OAAO,GAAG,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,OAAO,YAAY;IACN,YAAY,CAAS;IACrB,SAAS,CAAS;IAC3B,WAAW,GAA+B,IAAI,CAAC;IAC/C,SAAS,GAA6B,IAAI,CAAC;IAC3C,WAAW,GAAG,CAAC,CAAC;IAChB,SAAS,GAAG,CAAC,CAAC;IACd,gBAAgB,GAAG,CAAC,CAAC;IAE7B,YAAY,QAAgB;QAC1B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;QACjE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IAC7D,CAAC;IAED,4EAA4E;IAEpE,KAAK,CAAC,WAAW;QACvB,MAAM,gBAAgB,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QACzD,MAAM,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACtD,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,IAAI,CAAC,gBAAgB,GAAG,IAAI;YAAE,OAAO;QAC/C,IAAI,CAAC,gBAAgB,GAAG,GAAG,CAAC;QAE5B,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACxC,IAAI,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW;oBAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YAC5D,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACrC,IAAI,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS;oBAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACxD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;IACH,CAAC;IAED,6EAA6E;IAErE,KAAK,CAAC,YAAY;QACxB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,WAAW,CAAC;QAE9C,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;QAEtC,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;gBAC1B,IAAI,CAAC,GAAG,CAAC,EAAE;oBAAE,SAAS;gBACtB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAa,CAAC,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC;gBAAC,SAAS;YAAC,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACxC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,OAAO,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;QAEpB,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,KAAK,CAAC,SAAS;QACrB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QAE1C,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAgB,CAAC;QAEpC,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;gBAC1B,IAAI,CAAC,GAAG,CAAC,EAAE;oBAAE,SAAS;gBACtB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAW,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBAAC,SAAS;YAAC,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;QAEpB,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,kBAAkB,KAAW,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC;IACvD,eAAe,KAAW,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC;IAE1D,4EAA4E;IAE5E,KAAK,CAAC,YAAY,CAAC,MAAqB;QACtC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,IAAI,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAExC,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;YACjB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;YACnB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,uBAAuB;YACvB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;QAC7D,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EAAU;QACxB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAQlB;QACC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,MAAM,GAAW;YACrB,EAAE,EAAE,gBAAgB,EAAE;YACtB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC;QAEF,MAAM,eAAe,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;QACzE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,EAAU,EAAE,OAAsG;QACnI,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE3B,MAAM,OAAO,GAAW;YACtB,GAAG,QAAQ;YACX,GAAG,OAAO;YACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,MAAM,eAAe,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,4EAA4E;IAE5E,KAAK,CAAC,SAAS,CAAC,MAAmB;QACjC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACnC,IAAI,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAErC,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;YACjB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,MAAM,EAAE,QAAQ,EAAE,CAAC;YACrB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;YACnB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACnC,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAOhB;QACC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,GAAS;YACjB,EAAE,EAAE,cAAc,EAAE;YACpB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC;QAEF,MAAM,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU,EAAE,OAA6E;QACxG,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE3B,MAAM,OAAO,GAAS;YACpB,GAAG,QAAQ;YACX,GAAG,OAAO;YACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,MAAM,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,4EAA4E;IAE5E,gDAAgD;IAChD,KAAK,CAAC,gBAAgB,CAAC,QAAgB;QACrC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,uFAAuF;IACvF,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,QAAgB,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,cAAc,GAAa,EAAE,CAAC;QACpC,MAAM,WAAW,GAAW,EAAE,CAAC;QAC/B,IAAI,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACvD,MAAM,YAAY,GAAa,EAAE,CAAC;YAElC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,SAAS;gBAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAEhB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBACxC,IAAI,MAAM;oBAAE,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAExC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;oBACd,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;oBAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;wBACzB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;wBACxD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;4BAC3B,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;wBAC9B,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,QAAQ,GAAG,YAAY,CAAC;QAC1B,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAC1D,CAAC;CACF;AAED,8EAA8E;AAE9E,IAAI,MAAM,GAAwB,IAAI,CAAC;AAEvC,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/contacts/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Types for the contacts module — Core's entity relationship graph.
+ */
+export type EntityType = "human" | "ai" | "organization" | "service";
+export type EdgeType = "works_at" | "owns" | "introduced_by" | "collaborates_with" | "uses" | "built_by" | "reports_to";
+export interface EntityChannel {
+    type: "email" | "phone" | "slack" | "url" | "api";
+    value: string;
+}
+export interface Entity {
+    id: string;
+    type: EntityType;
+    name: string;
+    aliases?: string[];
+    channels?: EntityChannel[];
+    /** Freeform type-specific data (role, model name, API base URL, etc.). */
+    meta?: Record<string, unknown>;
+    notes?: string;
+    tags?: string[];
+    status: "active" | "archived";
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Edge {
+    id: string;
+    from: string;
+    to: string;
+    type: EdgeType;
+    /** Optional qualifier (e.g. "Founder", "API provider"). */
+    label?: string;
+    /** When the relationship started (ISO date or YYYY-MM). */
+    since?: string;
+    notes?: string;
+    status: "active" | "archived";
+    createdAt: string;
+    updatedAt: string;
+}
+export interface EntityFilter {
+    type?: EntityType;
+    status?: "active" | "archived";
+}
+export interface EdgeFilter {
+    type?: EdgeType;
+    entityId?: string;
+    status?: "active" | "archived";
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/contacts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/contacts/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,IAAI,GAAG,cAAc,GAAG,SAAS,CAAC;AAErE,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,MAAM,GACN,eAAe,GACf,mBAAmB,GACnB,MAAM,GACN,UAAU,GACV,YAAY,CAAC;AAEjB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC;IAClD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CAChC"}

package/dist/contacts/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for the contacts module — Core's entity relationship graph.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/contacts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/contacts/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/context/assembler.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Context assembly — dynamically build the prompt context (Context Engineering).
+ * Assembles: supporting content, instructions, examples, cues, primary content.
+ */
+import type { ContextMessage, ContextSections, GetContextOptions, WorkingMemory } from "../types.js";
+export interface ContextAssemblerConfig {
+    systemPrompt: string;
+    defaultInstructions?: string;
+    defaultCues?: string;
+    maxSupportingTokens?: number;
+}
+/**
+ * Build context sections from working memory, options, and config.
+ * Does not perform retrieval; caller injects already-retrieved working memory.
+ */
+export declare function assembleSections(workingMemory: WorkingMemory, options: GetContextOptions, config: ContextAssemblerConfig): ContextSections;
+/**
+ * Turn context sections into a single system message (one common pattern).
+ * Order: instructions first, then supporting content, then cues, then primary as user message.
+ */
+export declare function sectionsToMessages(sections: ContextSections, includeHistory?: ContextMessage[]): ContextMessage[];
+/**
+ * Rough token estimate (chars / 4). Use a real tokenizer if you need accuracy.
+ */
+export declare function estimateTokens(text: string): number;
+//# sourceMappingURL=assembler.d.ts.map

package/dist/context/assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.d.ts","sourceRoot":"","sources":["../../src/context/assembler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGrG,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,sBAAsB,GAC7B,eAAe,CA0BjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,EAAE,cAAc,GAAE,cAAc,EAAO,GAAG,cAAc,EAAE,CAmBrH;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/context/assembler.js

@@ -0,0 +1,65 @@
+/**
+ * Context assembly — dynamically build the prompt context (Context Engineering).
+ * Assembles: supporting content, instructions, examples, cues, primary content.
+ */
+import { formatWorkingMemoryForContext } from "../memory/working.js";
+/**
+ * Build context sections from working memory, options, and config.
+ * Does not perform retrieval; caller injects already-retrieved working memory.
+ */
+export function assembleSections(workingMemory, options, config) {
+    const memoryBlock = formatWorkingMemoryForContext(workingMemory);
+    let supportingContent = memoryBlock
+        ? `${memoryBlock}\n`
+        : "";
+    // Enforce token budget on supporting content
+    if (config.maxSupportingTokens && supportingContent) {
+        const tokens = estimateTokens(supportingContent);
+        if (tokens > config.maxSupportingTokens) {
+            const maxChars = config.maxSupportingTokens * 4;
+            supportingContent = supportingContent.slice(0, maxChars) + "\n...(truncated to fit token budget)";
+        }
+    }
+    const instructions = [config.defaultInstructions, config.systemPrompt].filter(Boolean).join("\n\n");
+    const cues = config.defaultCues ?? "";
+    const primaryContent = options.userInput;
+    return {
+        supportingContent: supportingContent.trim(),
+        instructions,
+        examples: "",
+        cues,
+        primaryContent,
+    };
+}
+/**
+ * Turn context sections into a single system message (one common pattern).
+ * Order: instructions first, then supporting content, then cues, then primary as user message.
+ */
+export function sectionsToMessages(sections, includeHistory = []) {
+    const systemParts = [];
+    if (sections.instructions)
+        systemParts.push(sections.instructions);
+    if (sections.supportingContent)
+        systemParts.push("\n---\nContext / memory\n---\n" + sections.supportingContent);
+    if (sections.examples)
+        systemParts.push("\n---\nExamples\n---\n" + sections.examples);
+    if (sections.cues)
+        systemParts.push("\n---\nOutput format\n---\n" + sections.cues);
+    const messages = [];
+    if (systemParts.length > 0) {
+        messages.push({ role: "system", content: systemParts.join("\n") });
+    }
+    // History: typically [assistant, user, assistant, user, ...] — add in order
+    for (const msg of includeHistory) {
+        messages.push(msg);
+    }
+    messages.push({ role: "user", content: sections.primaryContent });
+    return messages;
+}
+/**
+ * Rough token estimate (chars / 4). Use a real tokenizer if you need accuracy.
+ */
+export function estimateTokens(text) {
+    return Math.ceil((text || "").length / 4);
+}
+//# sourceMappingURL=assembler.js.map

package/dist/context/assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.js","sourceRoot":"","sources":["../../src/context/assembler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AASrE;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,aAA4B,EAC5B,OAA0B,EAC1B,MAA8B;IAE9B,MAAM,WAAW,GAAG,6BAA6B,CAAC,aAAa,CAAC,CAAC;IACjE,IAAI,iBAAiB,GAAG,WAAW;QACjC,CAAC,CAAC,GAAG,WAAW,IAAI;QACpB,CAAC,CAAC,EAAE,CAAC;IAEP,6CAA6C;IAC7C,IAAI,MAAM,CAAC,mBAAmB,IAAI,iBAAiB,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAC;QACjD,IAAI,MAAM,GAAG,MAAM,CAAC,mBAAmB,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,mBAAmB,GAAG,CAAC,CAAC;YAChD,iBAAiB,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,sCAAsC,CAAC;QACpG,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpG,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IACtC,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAEzC,OAAO;QACL,iBAAiB,EAAE,iBAAiB,CAAC,IAAI,EAAE;QAC3C,YAAY;QACZ,QAAQ,EAAE,EAAE;QACZ,IAAI;QACJ,cAAc;KACf,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAyB,EAAE,iBAAmC,EAAE;IACjG,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,QAAQ,CAAC,YAAY;QAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACnE,IAAI,QAAQ,CAAC,iBAAiB;QAAE,WAAW,CAAC,IAAI,CAAC,gCAAgC,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAChH,IAAI,QAAQ,CAAC,QAAQ;QAAE,WAAW,CAAC,IAAI,CAAC,wBAAwB,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACtF,IAAI,QAAQ,CAAC,IAAI;QAAE,WAAW,CAAC,IAAI,CAAC,6BAA6B,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEnF,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,4EAA4E;IAC5E,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;IAClE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/context/compaction.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Conversation history compaction.
+ * Summarizes older turns into a compact paragraph to reduce token usage,
+ * keeping recent turns verbatim for coherent conversation flow.
+ */
+import type { ContextMessage } from "../types.js";
+import type { ProviderName } from "../llm/providers/types.js";
+/** Number of messages that triggers compaction. */
+export declare const COMPACT_THRESHOLD = 20;
+/** Number of recent messages to always keep verbatim (3 turns). */
+export declare const KEEP_RECENT = 6;
+export interface CompactionResult {
+    /** New combined summary (existing + newly compacted). */
+    summary: string;
+    /** Messages to keep verbatim (the recent ones). */
+    trimmedHistory: ContextMessage[];
+    /** True if compaction actually ran. */
+    compacted: boolean;
+}
+/**
+ * Format messages into a readable transcript for the summarizer.
+ */
+export declare function formatMessagesForSummary(messages: ContextMessage[]): string;
+/**
+ * Compact conversation history by summarizing older messages.
+ *
+ * When history exceeds COMPACT_THRESHOLD, all messages except the most recent
+ * KEEP_RECENT are summarized into a paragraph via the utility model. The summary
+ * is appended to any existing summary (incremental — never re-summarizes).
+ *
+ * Never throws — returns compacted: false on any failure.
+ */
+export declare function compactHistory(history: ContextMessage[], existingSummary: string, provider: ProviderName, model?: string): Promise<CompactionResult>;
+//# sourceMappingURL=compaction.d.ts.map

package/dist/context/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/context/compaction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,mDAAmD;AACnD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,mEAAmE;AACnE,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,cAAc,EAAE,cAAc,EAAE,CAAC;IACjC,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CAc3E;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EAAE,EACzB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,YAAY,EACtB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC,CAiD3B"}

package/dist/context/compaction.js

@@ -0,0 +1,84 @@
+/**
+ * Conversation history compaction.
+ * Summarizes older turns into a compact paragraph to reduce token usage,
+ * keeping recent turns verbatim for coherent conversation flow.
+ */
+import { completeChat } from "../llm/complete.js";
+/** Number of messages that triggers compaction. */
+export const COMPACT_THRESHOLD = 20;
+/** Number of recent messages to always keep verbatim (3 turns). */
+export const KEEP_RECENT = 6;
+/**
+ * Format messages into a readable transcript for the summarizer.
+ */
+export function formatMessagesForSummary(messages) {
+    return messages
+        .filter((m) => m.role === "user" || m.role === "assistant")
+        .map((m) => {
+        const role = m.role === "user" ? "Human" : "Assistant";
+        const text = typeof m.content === "string"
+            ? m.content
+            : m.content
+                .filter((b) => b.type === "text" && typeof b.text === "string")
+                .map((b) => b.text)
+                .join(" ") || "[image]";
+        return `${role}: ${text}`;
+    })
+        .join("\n\n");
+}
+/**
+ * Compact conversation history by summarizing older messages.
+ *
+ * When history exceeds COMPACT_THRESHOLD, all messages except the most recent
+ * KEEP_RECENT are summarized into a paragraph via the utility model. The summary
+ * is appended to any existing summary (incremental — never re-summarizes).
+ *
+ * Never throws — returns compacted: false on any failure.
+ */
+export async function compactHistory(history, existingSummary, provider, model) {
+    // Not enough messages to compact
+    if (history.length < COMPACT_THRESHOLD) {
+        return { summary: existingSummary, trimmedHistory: history, compacted: false };
+    }
+    const toSummarize = history.slice(0, -KEEP_RECENT);
+    const toKeep = history.slice(-KEEP_RECENT);
+    const transcript = formatMessagesForSummary(toSummarize);
+    if (!transcript.trim()) {
+        return { summary: existingSummary, trimmedHistory: history, compacted: false };
+    }
+    try {
+        const prompt = [
+            `You are a conversation summarizer. Produce a concise paragraph (3-6 sentences) capturing:`,
+            `- Key topics discussed`,
+            `- Decisions made`,
+            `- Important facts or preferences shared`,
+            `- The user's current intent or mood`,
+            ``,
+            `Do NOT use verbatim quotes. Do NOT include filler. Be factual and dense.`,
+            ...(existingSummary
+                ? [``, `Previous summary of even earlier conversation:`, existingSummary, ``]
+                : []),
+            ``,
+            `Conversation to summarize:`,
+            transcript,
+        ].join("\n");
+        const summary = await completeChat({
+            messages: [
+                { role: "system", content: "You summarize conversations concisely. Output only the summary paragraph, nothing else." },
+                { role: "user", content: prompt },
+            ],
+            provider,
+            model,
+        });
+        return {
+            summary: summary.trim(),
+            trimmedHistory: toKeep,
+            compacted: true,
+        };
+    }
+    catch {
+        // On any failure, skip compaction — full history is sent as fallback
+        return { summary: existingSummary, trimmedHistory: history, compacted: false };
+    }
+}
+//# sourceMappingURL=compaction.js.map

package/dist/context/compaction.js.map

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

package/dist/context/index.d.ts

@@ -0,0 +1,3 @@
+export { assembleSections, sectionsToMessages, estimateTokens, } from "./assembler.js";
+export type { ContextAssemblerConfig } from "./assembler.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/context/index.js

@@ -0,0 +1,2 @@
+export { assembleSections, sectionsToMessages, estimateTokens, } from "./assembler.js";
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,gBAAgB,CAAC"}

package/dist/core/registry/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Template & Skill Sharing Registry — Public API.
+ */
+export type { RegistryItemType, RegistryItemStatus, TemplateCategory, RegistryEntry, RegistryVersion, PublishRequest, PublishResult, ValidationResult, RegistrySearchQuery, RegistrySearchResult, InstallRequest, InstallResult, } from "./types.js";
+export { STATUS_TRANSITIONS, RegistryStatusError } from "./types.js";
+export { RegistryStore } from "./store.js";
+export { publishEntry, validatePublishRequest, generateEntryId, computeChecksum, compareSemver, } from "./publisher.js";
+export { searchRegistry } from "./search.js";
+export type { VersionHistory, VersionSummary } from "./versions.js";
+export { getVersionHistory, getVersionContent, getLatestVersion, rollbackToVersion, isUpdateAvailable, getNewerVersions, verifyChecksum, hasVersion, } from "./versions.js";
+export { SharingRegistry, createSharingRegistry, getSharingRegistry, } from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/registry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,UAAU,GACX,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,eAAe,CAAC"}

package/dist/core/registry/index.js

@@ -0,0 +1,14 @@
+/**
+ * Template & Skill Sharing Registry — Public API.
+ */
+export { STATUS_TRANSITIONS, RegistryStatusError } from "./types.js";
+// Store
+export { RegistryStore } from "./store.js";
+// Publisher
+export { publishEntry, validatePublishRequest, generateEntryId, computeChecksum, compareSemver, } from "./publisher.js";
+// Search
+export { searchRegistry } from "./search.js";
+export { getVersionHistory, getVersionContent, getLatestVersion, rollbackToVersion, isUpdateAvailable, getNewerVersions, verifyChecksum, hasVersion, } from "./versions.js";
+// Registry (main service)
+export { SharingRegistry, createSharingRegistry, getSharingRegistry, } from "./registry.js";
+//# sourceMappingURL=index.js.map

package/dist/core/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/registry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,YAAY;AACZ,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,SAAS;AACT,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7C,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,0BAA0B;AAC1B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,eAAe,CAAC"}