@jmtrin/opencode-kevin 0.1.1

package/dist/plugin/MemoryService.js

@@ -0,0 +1,228 @@
+import { uuidv7 } from "./uuid.js";
+const TYPE_PRIORITY = {
+    error: 0,
+    pattern: 1,
+    decision: 2,
+    context: 3,
+};
+const SESSION_DEFAULT_TTL_HOURS = 24;
+const RELEVANCE_BUMP = 0.05;
+const RELEVANCE_MAX = 1.0;
+function sqliteUtcNowPlusHours(hours) {
+    const d = new Date(Date.now() + hours * 3_600_000);
+    const pad = (n) => String(n).padStart(2, "0");
+    return `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())} ${pad(d.getUTCHours())}:${pad(d.getUTCMinutes())}:${pad(d.getUTCSeconds())}`;
+}
+function mapRow(row, score) {
+    const mem = {
+        id: row.id,
+        type: row.type,
+        content: row.content,
+        scope: row.scope,
+        relevanceScore: row.relevance_score,
+        sourceTool: row.source_tool,
+        sourceSession: row.source_session,
+        metadata: row.metadata
+            ? JSON.parse(row.metadata)
+            : null,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        expiresAt: row.expires_at,
+    };
+    if (score !== undefined) {
+        if (!mem.metadata)
+            mem.metadata = {};
+        mem.metadata.score = score;
+    }
+    return mem;
+}
+function sanitizeMatch(text) {
+    const tokens = stripUnbalancedQuotes(text.trim())
+        .split(/\s+/)
+        .filter((t) => t.length > 0)
+        .map((t) => `"${t.replace(/"/g, '""')}"`);
+    return tokens.join(" ");
+}
+function stripUnbalancedQuotes(s) {
+    const count = (s.match(/"/g) ?? []).length;
+    if (count % 2 === 0)
+        return s;
+    return s.replace(/"/g, "");
+}
+function isNotSearchable(mem) {
+    return (mem.metadata?.not_searchable === true);
+}
+export class MemoryService {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    save(input) {
+        const id = uuidv7();
+        const scope = input.scope ?? "project";
+        const relevanceScore = input.relevanceScore ?? 0.5;
+        const metadata = input.metadata ? JSON.stringify(input.metadata) : null;
+        let expiresAt = input.expiresAt ?? null;
+        if (scope === "session" && !input.expiresAt) {
+            expiresAt = sqliteUtcNowPlusHours(SESSION_DEFAULT_TTL_HOURS);
+        }
+        this.store
+            .prepare(`INSERT INTO memories
+             (id, type, content, scope, relevance_score, source_tool, source_session, metadata, expires_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(id, input.type, input.content, scope, relevanceScore, input.sourceTool ?? null, input.sourceSession ?? null, metadata, expiresAt);
+        return id;
+    }
+    getById(id) {
+        const row = this.store
+            .prepare(`SELECT id, type, content, scope, relevance_score, source_tool, source_session,
+                metadata, created_at, updated_at, expires_at
+         FROM memories WHERE id = ?`)
+            .get(id);
+        return row ? mapRow(row) : null;
+    }
+    update(id, fields) {
+        const cols = [];
+        const vals = [];
+        if (fields.content !== undefined) {
+            cols.push("content = ?");
+            vals.push(fields.content);
+        }
+        if (fields.relevanceScore !== undefined) {
+            cols.push("relevance_score = ?");
+            vals.push(fields.relevanceScore);
+        }
+        if (fields.scope !== undefined) {
+            cols.push("scope = ?");
+            vals.push(fields.scope);
+        }
+        if (fields.type !== undefined) {
+            cols.push("type = ?");
+            vals.push(fields.type);
+        }
+        if (fields.metadata !== undefined) {
+            cols.push("metadata = ?");
+            vals.push(fields.metadata ? JSON.stringify(fields.metadata) : null);
+        }
+        if (fields.expiresAt !== undefined) {
+            cols.push("expires_at = ?");
+            vals.push(fields.expiresAt);
+        }
+        if (cols.length === 0)
+            return;
+        cols.push("updated_at = datetime('now')");
+        vals.push(id);
+        this.store
+            .prepare(`UPDATE memories SET ${cols.join(", ")} WHERE id = ?`)
+            .run(...vals);
+    }
+    delete(id) {
+        this.store.prepare("DELETE FROM memories WHERE id = ?").run(id);
+    }
+    query(input) {
+        const match = sanitizeMatch(input.text);
+        if (!match)
+            return [];
+        const scope = input.scope ?? "all";
+        const limit = input.limit ?? 10;
+        let sql = `
+      SELECT m.id, m.type, m.content, m.scope, m.relevance_score,
+             m.source_tool, m.source_session, m.metadata,
+             m.created_at, m.updated_at, m.expires_at,
+             bm25(memories_fts) AS score
+      FROM memories_fts
+      JOIN memories m ON m.rowid = memories_fts.rowid
+      WHERE memories_fts MATCH ?
+        AND (m.expires_at IS NULL OR m.expires_at > datetime('now'))`;
+        const params = [match];
+        if (input.type) {
+            sql += " AND m.type = ?";
+            params.push(input.type);
+        }
+        if (scope !== "all") {
+            sql += " AND m.scope = ?";
+            params.push(scope);
+        }
+        sql += " ORDER BY bm25(memories_fts) LIMIT ?";
+        params.push(limit);
+        const rows = this.store.prepare(sql).all(...params);
+        return rows
+            .map((r) => mapRow(r, r.score))
+            .filter((m) => !isNotSearchable(m));
+    }
+    loadAll(scope) {
+        let sql = `
+      SELECT id, type, content, scope, relevance_score, source_tool, source_session,
+             metadata, created_at, updated_at, expires_at
+      FROM memories
+      WHERE (expires_at IS NULL OR expires_at > datetime('now'))`;
+        const params = [];
+        if (scope !== "all") {
+            sql += " AND scope = ?";
+            params.push(scope);
+        }
+        sql += " ORDER BY relevance_score DESC, created_at DESC";
+        return this.store.prepare(sql).all(...params);
+    }
+    queryRelevant(text, scope) {
+        const tokens = stripUnbalancedQuotes(text.trim())
+            .split(/\s+/)
+            .filter((t) => t.length > 0)
+            .map((t) => `"${t.replace(/"/g, '""')}"`);
+        if (tokens.length === 0)
+            return [];
+        const match = tokens.join(" OR ");
+        let sql = `
+      SELECT m.id, m.type, m.content, m.scope, m.relevance_score,
+             m.source_tool, m.source_session, m.metadata,
+             m.created_at, m.updated_at, m.expires_at,
+             bm25(memories_fts) AS score
+      FROM memories_fts
+      JOIN memories m ON m.rowid = memories_fts.rowid
+      WHERE memories_fts MATCH ?
+        AND (m.expires_at IS NULL OR m.expires_at > datetime('now'))`;
+        const params = [match];
+        if (scope !== "all") {
+            sql += " AND m.scope = ?";
+            params.push(scope);
+        }
+        sql += " ORDER BY bm25(memories_fts) LIMIT 100";
+        const rows = this.store.prepare(sql).all(...params);
+        return rows
+            .map((r) => mapRow(r, r.score))
+            .filter((m) => !isNotSearchable(m));
+    }
+    getRelevant(input) {
+        const maxTokens = input.maxTokens ?? 2000;
+        const charBudget = maxTokens * 4;
+        const scope = input.scope ?? "project";
+        let candidates;
+        if (input.query && input.query.trim().length > 0) {
+            candidates = this.queryRelevant(input.query, scope);
+        }
+        else {
+            candidates = this.loadAll(scope)
+                .map((r) => mapRow(r))
+                .filter((m) => !isNotSearchable(m));
+        }
+        candidates.sort((a, b) => TYPE_PRIORITY[a.type] - TYPE_PRIORITY[b.type]);
+        const result = [];
+        let used = 0;
+        for (const mem of candidates) {
+            const len = mem.content.length + 32;
+            if (used + len > charBudget && result.length > 0)
+                break;
+            result.push(mem);
+            used += len;
+        }
+        if (result.length > 0) {
+            const bump = this.store.prepare("UPDATE memories SET relevance_score = MIN(?, relevance_score + ?) WHERE id = ?");
+            this.store.transaction(() => {
+                for (const m of result)
+                    bump.run(RELEVANCE_MAX, RELEVANCE_BUMP, m.id);
+            });
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=MemoryService.js.map

package/dist/plugin/MemoryService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryService.js","sourceRoot":"","sources":["../../plugin/MemoryService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAyDnC,MAAM,aAAa,GAA+B;IACjD,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,CAAC;CACV,CAAC;AAEF,MAAM,yBAAyB,GAAG,EAAE,CAAC;AACrC,MAAM,cAAc,GAAG,IAAI,CAAC;AAC5B,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,SAAS,qBAAqB,CAAC,KAAa;IAC3C,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC,CAAC,cAAc,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAC9D,CAAC,CAAC,UAAU,EAAE,CACd,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,SAAS,MAAM,CAAC,GAAc,EAAE,KAAc;IAC7C,MAAM,GAAG,GAAW;QACnB,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,cAAc,EAAE,GAAG,CAAC,eAAe;QACnC,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACrB,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAA6B;YACvD,CAAC,CAAC,IAAI;QACP,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,UAAU;KACzB,CAAC;IACF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,QAAQ;YAAE,GAAG,CAAC,QAAQ,GAAG,EAAE,CAAC;QACpC,GAAG,CAAC,QAAoC,CAAC,KAAK,GAAG,KAAK,CAAC;IACzD,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IAClC,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC/C,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,qBAAqB,CAAC,CAAS;IACvC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IACnC,OAAO,CACL,GAAG,CAAC,QAA2C,EAAE,cAAc,KAAK,IAAI,CACzE,CAAC;AACH,CAAC;AAED,MAAM,OAAO,aAAa;IACL;IAApB,YAAoB,KAAY;QAAZ,UAAK,GAAL,KAAK,CAAO;IAAG,CAAC;IAEpC,IAAI,CAAC,KAAgB;QACpB,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC;QACvC,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,GAAG,CAAC;QACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAExE,IAAI,SAAS,GAAkB,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YAC7C,SAAS,GAAG,qBAAqB,CAAC,yBAAyB,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,CAAC,KAAK;aACR,OAAO,CACP;;8CAE0C,CAC1C;aACA,GAAG,CACH,EAAE,EACF,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,OAAO,EACb,KAAK,EACL,cAAc,EACd,KAAK,CAAC,UAAU,IAAI,IAAI,EACxB,KAAK,CAAC,aAAa,IAAI,IAAI,EAC3B,QAAQ,EACR,SAAS,CACT,CAAC;QAEH,OAAO,EAAE,CAAC;IACX,CAAC;IAED,OAAO,CAAC,EAAU;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK;aACpB,OAAO,CACP;;oCAEgC,CAChC;aACA,GAAG,CAAC,EAAE,CAA0B,CAAC;QACnC,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,MAAuB;QACzC,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAc,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACzC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC9B,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACd,IAAI,CAAC,KAAK;aACR,OAAO,CAAC,uBAAuB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC;aAC9D,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,EAAU;QAChB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,KAAiB;QACtB,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QAEhC,IAAI,GAAG,GAAG;;;;;;;;qEAQyD,CAAC;QACpE,MAAM,MAAM,GAAc,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAChB,GAAG,IAAI,iBAAiB,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YACrB,GAAG,IAAI,kBAAkB,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QACD,GAAG,IAAI,sCAAsC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAE9C,CAAC;QACL,OAAO,IAAI;aACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;aAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAEO,OAAO,CAAC,KAA0B;QACzC,IAAI,GAAG,GAAG;;;;iEAIqD,CAAC;QAChE,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YACrB,GAAG,IAAI,gBAAgB,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QACD,GAAG,IAAI,iDAAiD,CAAC;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAgB,CAAC;IAC9D,CAAC;IAEO,aAAa,CAAC,IAAY,EAAE,KAA0B;QAC7D,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC/C,KAAK,CAAC,KAAK,CAAC;aACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;aAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAElC,IAAI,GAAG,GAAG;;;;;;;;qEAQyD,CAAC;QACpE,MAAM,MAAM,GAAc,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YACrB,GAAG,IAAI,kBAAkB,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QACD,GAAG,IAAI,wCAAwC,CAAC;QAEhD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAE9C,CAAC;QACL,OAAO,IAAI;aACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;aAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,WAAW,CAAC,KAAuB;QAClC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC;QAC1C,MAAM,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC;QAEvC,IAAI,UAAoB,CAAC;QACzB,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACP,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;iBAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;iBACrB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAEzE,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC;YACpC,IAAI,IAAI,GAAG,GAAG,GAAG,UAAU,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM;YACxD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,IAAI,IAAI,GAAG,CAAC;QACb,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAC9B,gFAAgF,CAChF,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;gBAC3B,KAAK,MAAM,CAAC,IAAI,MAAM;oBAAE,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,cAAc,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACvE,CAAC,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;CACD"}

package/dist/plugin/Migrate.d.ts

@@ -0,0 +1,13 @@
+import type { Store } from "./Store.js";
+export interface MigrateResult {
+    from: string;
+    to: string;
+    applied: string[];
+}
+export declare class Migrate {
+    private store;
+    private migrationsDir;
+    constructor(store: Store, migrationsDir: string);
+    run(): Promise<MigrateResult>;
+    private listPending;
+}

package/dist/plugin/Migrate.js

@@ -0,0 +1,54 @@
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+export class Migrate {
+    store;
+    migrationsDir;
+    constructor(store, migrationsDir) {
+        this.store = store;
+        this.migrationsDir = migrationsDir;
+    }
+    async run() {
+        this.store.exec(`CREATE TABLE IF NOT EXISTS schema_version (
+         version TEXT PRIMARY KEY,
+         applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+       );`);
+        const currentRow = this.store
+            .prepare("SELECT version FROM schema_version ORDER BY version DESC LIMIT 1")
+            .get();
+        const from = currentRow?.version ?? "000";
+        const pending = this.listPending(from);
+        if (pending.length === 0) {
+            return { from, to: from, applied: [] };
+        }
+        const insertVersion = this.store.prepare("INSERT OR IGNORE INTO schema_version (version) VALUES (?)");
+        for (const migration of pending) {
+            const sql = readFileSync(join(this.migrationsDir, migration.file), "utf8");
+            this.store.transaction(() => {
+                this.store.exec(sql);
+                insertVersion.run(migration.version);
+            });
+        }
+        return {
+            from,
+            to: pending[pending.length - 1].version,
+            applied: pending.map((m) => m.version),
+        };
+    }
+    listPending(current) {
+        let files = [];
+        try {
+            files = readdirSync(this.migrationsDir).filter((f) => f.endsWith(".sql"));
+        }
+        catch {
+            return [];
+        }
+        files.sort();
+        return files
+            .map((file) => {
+            const match = file.match(/^(\w+?)_/);
+            return match ? { version: match[1], file } : null;
+        })
+            .filter((m) => m !== null && m.version > current);
+    }
+}
+//# sourceMappingURL=Migrate.js.map

package/dist/plugin/Migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migrate.js","sourceRoot":"","sources":["../../plugin/Migrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,OAAO,OAAO;IAEV;IACA;IAFT,YACS,KAAY,EACZ,aAAqB;QADrB,UAAK,GAAL,KAAK,CAAO;QACZ,kBAAa,GAAb,aAAa,CAAQ;IAC3B,CAAC;IAEJ,KAAK,CAAC,GAAG;QACR,IAAI,CAAC,KAAK,CAAC,IAAI,CACd;;;UAGO,CACP,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK;aAC3B,OAAO,CACP,kEAAkE,CAClE;aACA,GAAG,EAAqC,CAAC;QAE3C,MAAM,IAAI,GAAG,UAAU,EAAE,OAAO,IAAI,KAAK,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAEvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACxC,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CACvC,2DAA2D,CAC3D,CAAC;QAEF,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,YAAY,CACvB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,IAAI,CAAC,EACxC,MAAM,CACN,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;gBAC3B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrB,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACJ,CAAC;QAED,OAAO;YACN,IAAI;YACJ,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO;YACvC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;SACtC,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,OAAe;QAClC,IAAI,KAAK,GAAa,EAAE,CAAC;QACzB,IAAI,CAAC;YACJ,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3E,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,EAAE,CAAC;QACX,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,OAAO,KAAK;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACrC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,CAAC,CAAC;aACD,MAAM,CACN,CAAC,CAAC,EAA0C,EAAE,CAC7C,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,GAAG,OAAO,CAClC,CAAC;IACJ,CAAC;CACD"}

package/dist/plugin/Reflector.d.ts

@@ -0,0 +1,30 @@
+import type { MemoryService } from "./MemoryService.js";
+export interface ReflectionInput {
+    toolName: string;
+    argsSummary: string;
+    stderr: string;
+    stdout: string;
+    exitCode?: number;
+    errorType: string;
+    sessionId: string;
+}
+export interface ReflectorOptions {
+    throttleMs?: number;
+}
+export interface HeuristicLessonInput {
+    toolName: string;
+    errorType: string;
+    firstErrorLine: string;
+}
+export declare const ERROR_LINE_RE: RegExp;
+export declare class Reflector {
+    private memoryService;
+    private lastReflectionTs;
+    private throttleMs;
+    constructor(memoryService: MemoryService, options?: ReflectorOptions);
+    invoke(input: ReflectionInput): Promise<string | null>;
+    generateHeuristicLesson(input: HeuristicLessonInput): string;
+    redactPaths(text: string): string;
+    redactSecrets(text: string): string;
+    private extractFirstErrorLine;
+}

package/dist/plugin/Reflector.js

@@ -0,0 +1,117 @@
+import { redactPaths as redactPathsText } from "./redact.js";
+const DEFAULT_THROTTLE_MS = 60_000;
+const MAX_CONTENT_CHARS = 4096;
+const MAX_ERROR_LINE_CHARS = 500;
+const TRUNC_SUFFIX = "... [truncated]";
+const CONTEXT_PREFIX = "\n\nContext:\n";
+export const ERROR_LINE_RE = /\b(error|failed|fail|cannot find|cannot resolve|TS\d{4,}|exception|traceback|panic|fatal|referenceerror|typeerror|syntaxerror|command failed|non-zero exit)\b/i;
+const SUGGESTIONS = {
+    typecheck: "Verify types and imports before running.",
+    lint: "Run linter and fix warnings before committing.",
+    test: "Run tests and fix failures before proceeding.",
+    runtime: "Check error message and stack trace for root cause.",
+    timeout: "Check for infinite loops or long-running operations.",
+    unknown: "Review the error output for details.",
+};
+const SECRET_PATTERNS = [
+    /(API_KEY|SECRET|PASSWORD|TOKEN)\s*[=:]\s*\S+/gi,
+    /\bBearer\s+\S+/gi,
+    /\btoken\s+\S+/gi,
+];
+const SECRET_VALUE_PATTERN = /\s*=\s*\S+(.*)$/;
+const PATH_PATTERNS_DEPRECATED = null;
+export class Reflector {
+    memoryService;
+    lastReflectionTs = 0;
+    throttleMs;
+    constructor(memoryService, options) {
+        this.memoryService = memoryService;
+        this.throttleMs = options?.throttleMs ?? DEFAULT_THROTTLE_MS;
+    }
+    async invoke(input) {
+        const now = Date.now();
+        if (now - this.lastReflectionTs < this.throttleMs) {
+            return null;
+        }
+        this.lastReflectionTs = now;
+        const redactedStderr = this.redactSecrets(this.redactPaths(input.stderr));
+        const redactedStdout = this.redactSecrets(this.redactPaths(input.stdout));
+        const sourceOutput = redactedStderr.length > 0 ? redactedStderr : redactedStdout;
+        const firstErrorLine = this.extractFirstErrorLine(sourceOutput);
+        const lesson = this.generateHeuristicLesson({
+            toolName: input.toolName,
+            errorType: input.errorType,
+            firstErrorLine,
+        });
+        const metadata = {};
+        let finalContent;
+        if (sourceOutput.length > 0) {
+            const fullLen = lesson.length + CONTEXT_PREFIX.length + sourceOutput.length;
+            if (fullLen <= MAX_CONTENT_CHARS) {
+                finalContent = `${lesson}${CONTEXT_PREFIX}${sourceOutput}`;
+            }
+            else {
+                const budget = MAX_CONTENT_CHARS -
+                    lesson.length -
+                    CONTEXT_PREFIX.length -
+                    TRUNC_SUFFIX.length;
+                const truncated = sourceOutput.slice(0, Math.max(0, budget));
+                finalContent = `${lesson}${CONTEXT_PREFIX}${truncated}${TRUNC_SUFFIX}`;
+                metadata.truncated = true;
+            }
+        }
+        else {
+            finalContent = lesson;
+        }
+        const id = this.memoryService.save({
+            type: "error",
+            content: finalContent,
+            scope: "project",
+            sourceTool: input.toolName,
+            sourceSession: input.sessionId,
+            metadata,
+        });
+        return id;
+    }
+    generateHeuristicLesson(input) {
+        const suggestion = SUGGESTIONS[input.errorType] ?? SUGGESTIONS.unknown;
+        const line = input.firstErrorLine.length > MAX_ERROR_LINE_CHARS
+            ? `${input.firstErrorLine.slice(0, MAX_ERROR_LINE_CHARS)}...`
+            : input.firstErrorLine;
+        return `When ${input.toolName} fails with ${input.errorType}: ${line}\nSuggestion: ${suggestion}`;
+    }
+    redactPaths(text) {
+        return redactPathsText(text);
+    }
+    redactSecrets(text) {
+        let out = text;
+        for (const pat of SECRET_PATTERNS) {
+            out = out.replace(pat, (match) => {
+                const eq = match.match(SECRET_VALUE_PATTERN);
+                if (eq) {
+                    const label = match.split(/[=:]/)[0].trim();
+                    return `${label}=<redacted>`;
+                }
+                const parts = match.split(/\s+/);
+                return `${parts[0]} <redacted>`;
+            });
+        }
+        return out;
+    }
+    extractFirstErrorLine(text) {
+        const lines = text.split(/\r?\n/);
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.length > 0 && ERROR_LINE_RE.test(trimmed)) {
+                return trimmed;
+            }
+        }
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.length > 0)
+                return trimmed;
+        }
+        return "";
+    }
+}
+//# sourceMappingURL=Reflector.js.map

package/dist/plugin/Reflector.js.map

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

package/dist/plugin/Retrospective.d.ts

@@ -0,0 +1,13 @@
+import type { MemoryService } from "./MemoryService.js";
+import type { Store } from "./Store.js";
+export interface RetrospectiveOptions {
+    dir?: string;
+}
+export declare class Retrospective {
+    private store;
+    private memoryService;
+    private retrospectivesDir;
+    constructor(store: Store, memoryService: MemoryService, options?: RetrospectiveOptions);
+    generate(sessionId: string): Promise<string | null>;
+    private buildMarkdown;
+}

package/dist/plugin/Retrospective.js

@@ -0,0 +1,77 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { uuidv7 } from "./uuid.js";
+export class Retrospective {
+    store;
+    memoryService;
+    retrospectivesDir;
+    constructor(store, memoryService, options) {
+        this.store = store;
+        this.memoryService = memoryService;
+        this.retrospectivesDir = options?.dir ?? join(homedir(), ".opencode-kevin", "retrospectives");
+    }
+    async generate(sessionId) {
+        const existing = this.store
+            .prepare("SELECT file_path FROM retrospectives WHERE session_id = ?")
+            .get(sessionId);
+        if (existing?.file_path)
+            return existing.file_path;
+        const counts = this.store
+            .prepare(`SELECT
+					SUM(CASE WHEN success = 1 THEN 1 ELSE 0 END) AS success_count,
+					SUM(CASE WHEN success = 0 THEN 1 ELSE 0 END) AS failure_count,
+					COUNT(*) AS total
+				 FROM tool_calls WHERE session_id = ?`)
+            .get(sessionId);
+        const successCount = counts?.success_count ?? 0;
+        const failureCount = counts?.failure_count ?? 0;
+        const total = counts?.total ?? 0;
+        if (failureCount === 0)
+            return null;
+        const failedTools = this.store
+            .prepare(`SELECT tool, args_summary, error_type
+				 FROM tool_calls
+				 WHERE session_id = ? AND success = 0
+				 ORDER BY ts ASC`)
+            .all(sessionId);
+        const lessons = this.store
+            .prepare(`SELECT content FROM memories
+				 WHERE type = 'error' AND source_session = ?
+				 ORDER BY created_at ASC`)
+            .all(sessionId);
+        const md = this.buildMarkdown(sessionId, total, successCount, failureCount, failedTools, lessons);
+        mkdirSync(this.retrospectivesDir, { recursive: true });
+        const filePath = join(this.retrospectivesDir, `${sessionId}.md`);
+        writeFileSync(filePath, md, "utf8");
+        const id = uuidv7();
+        this.store
+            .prepare(`INSERT OR IGNORE INTO retrospectives
+				 (id, session_id, ts, failure_count, success_count, lessons_count, file_path, metadata)
+				 VALUES (?, ?, datetime('now'), ?, ?, ?, ?, ?)`)
+            .run(id, sessionId, failureCount, successCount, lessons.length, filePath, null);
+        return filePath;
+    }
+    buildMarkdown(sessionId, total, successCount, failureCount, failedTools, lessons) {
+        const lines = [];
+        lines.push(`# Retrospective — Session ${sessionId}`);
+        lines.push("");
+        lines.push("## Resumen");
+        lines.push(`- Tool calls: ${total} (${successCount} ok, ${failureCount} failed)`);
+        lines.push("");
+        lines.push("## Tools que fallaron");
+        for (const ft of failedTools) {
+            const et = ft.error_type ?? "unknown";
+            const summary = ft.args_summary ?? "";
+            lines.push(`- ${ft.tool} (${et}): ${summary}`);
+        }
+        lines.push("");
+        lines.push("## Lecciones generadas");
+        for (const lesson of lessons) {
+            lines.push(`- ${lesson.content}`);
+        }
+        lines.push("");
+        return lines.join("\n");
+    }
+}
+//# sourceMappingURL=Retrospective.js.map

package/dist/plugin/Retrospective.js.map

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

package/dist/plugin/Store.d.ts

@@ -0,0 +1,14 @@
+import { type SqliteAdapter } from "./sqlite-adapter.js";
+export interface StoreOptions {
+    path: string;
+}
+export declare class Store {
+    private db;
+    private closed;
+    constructor(options: StoreOptions);
+    prepare(sql: string): ReturnType<SqliteAdapter["prepare"]>;
+    transaction<T>(fn: () => T): T;
+    exec(sql: string): void;
+    close(): void;
+    get raw(): SqliteAdapter;
+}

package/dist/plugin/Store.js

@@ -0,0 +1,36 @@
+import { createDatabase } from "./sqlite-adapter.js";
+export class Store {
+    db;
+    closed = false;
+    constructor(options) {
+        this.db = createDatabase(options.path);
+        this.db.exec("PRAGMA journal_mode = WAL");
+        this.db.exec("PRAGMA foreign_keys = ON");
+    }
+    prepare(sql) {
+        if (this.closed)
+            throw new Error("Store is closed");
+        return this.db.prepare(sql);
+    }
+    transaction(fn) {
+        if (this.closed)
+            throw new Error("Store is closed");
+        const tx = this.db.transaction(fn);
+        return tx();
+    }
+    exec(sql) {
+        if (this.closed)
+            throw new Error("Store is closed");
+        this.db.exec(sql);
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.db.close();
+    }
+    get raw() {
+        return this.db;
+    }
+}
+//# sourceMappingURL=Store.js.map

package/dist/plugin/Store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Store.js","sourceRoot":"","sources":["../../plugin/Store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAsB,MAAM,qBAAqB,CAAC;AAMzE,MAAM,OAAO,KAAK;IACT,EAAE,CAAgB;IAClB,MAAM,GAAG,KAAK,CAAC;IAEvB,YAAY,OAAqB;QAChC,IAAI,CAAC,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC1C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,CAAC,GAAW;QAClB,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,WAAW,CAAI,EAAW;QACzB,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACpD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO,EAAE,EAAE,CAAC;IACb,CAAC;IAED,IAAI,CAAC,GAAW;QACf,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACpD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,KAAK;QACJ,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;IAED,IAAI,GAAG;QACN,OAAO,IAAI,CAAC,EAAE,CAAC;IAChB,CAAC;CACD"}

package/dist/plugin/ToolCallObserver.d.ts

@@ -0,0 +1,28 @@
+import type { Store } from "./Store.js";
+export interface ToolExecuteInput {
+    tool: string;
+    args?: Record<string, unknown>;
+    agent?: string;
+    sessionId?: string;
+    callID?: string;
+}
+export interface ToolExecuteOutput {
+    success?: boolean;
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number;
+}
+export declare class ToolCallObserver {
+    private store;
+    private startTs;
+    constructor(store: Store);
+    onBefore(input: ToolExecuteInput, _output: ToolExecuteOutput): void;
+    onAfter(input: ToolExecuteInput, output: ToolExecuteOutput): void;
+    redactSecrets(text: string): string;
+    summarizeArgs(args: Record<string, unknown>): string;
+    inferErrorType(stderr: string, stdout: string, exitCode?: number): string;
+    private key;
+    private looksSecret;
+    private redactArgs;
+    private redactValue;
+}