agent-knowledge 1.0.0

package/dist/sessions/search.js

@@ -0,0 +1,256 @@
+import { TfIdfIndex, recencyDecay } from '../search/tfidf.js';
+import { buildExcerpt } from '../search/excerpt.js';
+import { getProjectDirs, getSessionFiles, parseSessionFile, extractMessages, getSessionMeta, } from './parser.js';
+import { getEmbeddingProvider } from '../embeddings/index.js';
+import { VectorStore } from '../vectorstore/index.js';
+import { getConfig } from '../types.js';
+// ── Lazy VectorStore singleton ──────────────────────────────────────────────
+let _vectorStore = null;
+function getVectorStore() {
+    if (!_vectorStore) {
+        _vectorStore = new VectorStore();
+    }
+    return _vectorStore;
+}
+/**
+ * Search across all session transcripts.
+ *
+ * Supports three modes:
+ * - **hybrid** (default when embeddings available): blends TF-IDF ranking
+ *   with semantic vector similarity using configurable alpha weighting.
+ * - **ranked** (default fallback): builds a TF-IDF index over all messages,
+ *   returns results ordered by relevance score.
+ * - **legacy** (`ranked: false`): regex-based matching, faster for exact
+ *   phrases and pattern searches.
+ *
+ * Returns results with excerpts (100 chars before + 100 chars after match).
+ */
+export async function searchSessions(query, options = {}) {
+    const { project, role = 'all', caseSensitive = false, maxResults = 20, ranked = true, semantic = true, } = options;
+    const projects = getProjectDirs().filter((p) => !project || p.name.toLowerCase().includes(project.toLowerCase()));
+    if (!ranked) {
+        return regexSearch(query, projects, role, caseSensitive, maxResults);
+    }
+    const tfidfResults = rankedSearch(query, projects, role, maxResults);
+    if (semantic) {
+        try {
+            const config = getConfig();
+            const hybridResults = await hybridSearch(query, tfidfResults, maxResults, config.embeddingAlpha);
+            return hybridResults;
+        }
+        catch {
+            // Semantic failed silently — fall back to pure TF-IDF
+        }
+    }
+    return tfidfResults;
+}
+// ── Hybrid search (TF-IDF + semantic) ───────────────────────────────────────
+async function hybridSearch(query, tfidfResults, maxResults, alpha) {
+    const provider = await getEmbeddingProvider();
+    if (!provider) {
+        return tfidfResults;
+    }
+    let queryVector;
+    try {
+        queryVector = await provider.embedOne(query);
+    }
+    catch {
+        return tfidfResults;
+    }
+    const store = getVectorStore();
+    let vectorResults;
+    try {
+        vectorResults = store.searchBySource(queryVector, 'session', maxResults * 2);
+    }
+    catch {
+        return tfidfResults;
+    }
+    if (vectorResults.length === 0) {
+        return tfidfResults;
+    }
+    // Build a map of semantic scores keyed by sessionId
+    // Multiple chunks may match for the same session — take the max score
+    const semanticScores = new Map();
+    for (const vr of vectorResults) {
+        const existing = semanticScores.get(vr.sourceId) ?? 0;
+        if (vr.score > existing) {
+            semanticScores.set(vr.sourceId, vr.score);
+        }
+    }
+    // Normalize TF-IDF scores to 0-1 range
+    const maxTfidf = tfidfResults.length > 0 ? Math.max(...tfidfResults.map((r) => r.score)) : 1;
+    const normFactor = maxTfidf > 0 ? maxTfidf : 1;
+    // Merge: start with TF-IDF results, blend in semantic scores
+    const merged = new Map();
+    for (const result of tfidfResults) {
+        const key = `${result.id}:${result.timestamp ?? ''}`;
+        const normalizedTfidf = result.score / normFactor;
+        const semanticScore = semanticScores.get(result.id) ?? 0;
+        const blended = alpha * normalizedTfidf + (1 - alpha) * semanticScore;
+        // Apply recency decay on top of blended score
+        const ts = result.timestamp ?? result.metadata?.sessionDate;
+        const decay = ts ? recencyDecay(ts) : 1;
+        const finalScore = blended * decay;
+        merged.set(key, {
+            ...result,
+            score: finalScore,
+            metadata: {
+                ...result.metadata,
+                tfidfScore: normalizedTfidf,
+                semanticScore,
+                blendAlpha: alpha,
+            },
+        });
+    }
+    for (const vr of vectorResults) {
+        const alreadyPresent = Array.from(merged.values()).some((r) => r.id === vr.sourceId);
+        if (!alreadyPresent) {
+            const semanticScore = vr.score;
+            const blended = (1 - alpha) * semanticScore;
+            // Use chunkText metadata for excerpt
+            const excerpt = vr.chunkText.length > 200 ? vr.chunkText.slice(0, 200) + '...' : vr.chunkText;
+            const timestamp = vr.metadata?.timestamp ?? undefined;
+            const decay = timestamp ? recencyDecay(timestamp) : 0.5;
+            const finalScore = blended * decay;
+            const key = `${vr.sourceId}:${timestamp ?? ''}`;
+            if (!merged.has(key)) {
+                merged.set(key, {
+                    source: 'session',
+                    id: vr.sourceId,
+                    role: vr.metadata?.role ?? 'unknown',
+                    timestamp,
+                    excerpt,
+                    score: finalScore,
+                    metadata: {
+                        tfidfScore: 0,
+                        semanticScore,
+                        blendAlpha: alpha,
+                    },
+                });
+            }
+        }
+    }
+    const results = Array.from(merged.values());
+    results.sort((a, b) => b.score - a.score);
+    return results.slice(0, maxResults);
+}
+function rankedSearch(query, projects, role, maxResults) {
+    const index = new TfIdfIndex();
+    const docMap = new Map();
+    let docCounter = 0;
+    for (const proj of projects) {
+        const sessions = getSessionFiles(proj.path);
+        for (const sess of sessions) {
+            try {
+                const entries = parseSessionFile(sess.file);
+                if (entries.length === 0)
+                    continue;
+                const meta = getSessionMeta(entries);
+                const messages = extractMessages(entries);
+                for (const msg of messages) {
+                    if (role !== 'all' && msg.role !== role)
+                        continue;
+                    const docId = `doc_${docCounter++}`;
+                    index.addDocument(docId, msg.content);
+                    docMap.set(docId, {
+                        project: proj.name,
+                        sessionId: sess.id,
+                        role: msg.role,
+                        timestamp: msg.timestamp,
+                        content: msg.content,
+                        sessionDate: meta.startTime,
+                    });
+                }
+            }
+            catch {
+                // skip broken files
+            }
+        }
+    }
+    const ranked = index.search(query, maxResults * 2); // over-fetch before decay reranking
+    const results = ranked
+        .map(({ id, score }) => {
+        const doc = docMap.get(id);
+        if (!doc)
+            return null;
+        const excerpt = buildExcerpt(doc.content, query);
+        const ts = doc.timestamp ?? doc.sessionDate;
+        const decay = recencyDecay(ts);
+        const adjustedScore = score * decay;
+        return {
+            source: 'session',
+            id: doc.sessionId,
+            project: doc.project,
+            role: doc.role,
+            timestamp: ts,
+            excerpt,
+            score: adjustedScore,
+            metadata: {
+                sessionDate: doc.sessionDate,
+                relevanceScore: score,
+                recencyMultiplier: Math.round(decay * 100) / 100,
+            },
+        };
+    })
+        .filter((r) => r !== null);
+    // Re-sort by adjusted score and trim
+    results.sort((a, b) => b.score - a.score);
+    return results.slice(0, maxResults);
+}
+// ── Regex-based search (legacy mode) ────────────────────────────────────────
+function regexSearch(query, projects, role, caseSensitive, maxResults) {
+    const flags = caseSensitive ? 'g' : 'gi';
+    let regex;
+    try {
+        regex = new RegExp(query, flags);
+    }
+    catch {
+        regex = new RegExp(query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), flags);
+    }
+    const matches = [];
+    for (const proj of projects) {
+        const sessions = getSessionFiles(proj.path);
+        for (const sess of sessions) {
+            try {
+                const entries = parseSessionFile(sess.file);
+                if (entries.length === 0)
+                    continue;
+                const meta = getSessionMeta(entries);
+                const messages = extractMessages(entries);
+                for (const msg of messages) {
+                    if (role !== 'all' && msg.role !== role)
+                        continue;
+                    // Reset lastIndex before test() — global regex is stateful
+                    regex.lastIndex = 0;
+                    if (!regex.test(msg.content))
+                        continue;
+                    const excerpt = buildExcerpt(msg.content, query, { caseSensitive });
+                    matches.push({
+                        source: 'session',
+                        id: sess.id,
+                        project: proj.name,
+                        role: msg.role,
+                        timestamp: msg.timestamp ?? meta.startTime,
+                        excerpt,
+                        score: 1, // no ranking in regex mode
+                        metadata: {
+                            sessionDate: meta.startTime,
+                        },
+                    });
+                    if (matches.length >= maxResults)
+                        break;
+                }
+            }
+            catch {
+                // skip
+            }
+            if (matches.length >= maxResults)
+                break;
+        }
+        if (matches.length >= maxResults)
+            break;
+    }
+    return matches;
+}
+// buildExcerpt imported from ../search/excerpt.js
+//# sourceMappingURL=search.js.map

package/dist/sessions/search.js.map

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

package/dist/sessions/summary.d.ts

@@ -0,0 +1,28 @@
+import { type SessionMeta } from './parser.js';
+export interface SessionSummary {
+    meta: SessionMeta;
+    topicCount: number;
+    topics: Array<{
+        timestamp: string | null;
+        content: string;
+    }>;
+    toolsUsed: string[];
+    filesModified: string[];
+}
+/**
+ * Generate a structured summary of a session.
+ *
+ * - Extracts user messages as topics (first 300 chars each)
+ * - Collects unique tool names from tool_use entries
+ * - Extracts file paths mentioned in tool results
+ */
+export declare function getSessionSummary(sessionId: string, project?: string): SessionSummary | null;
+/**
+ * List all sessions with metadata, sorted by startTime descending.
+ * Optionally filter by project name (substring match).
+ */
+export declare function listSessions(project?: string): Array<{
+    project: string;
+    sessionId: string;
+} & SessionMeta>;
+//# sourceMappingURL=summary.d.ts.map

package/dist/sessions/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/sessions/summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAsCD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAiE5F;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,CAAC,EAAE,MAAM,GACf,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAAC,CAiC7D"}

package/dist/sessions/summary.js

@@ -0,0 +1,135 @@
+import { getProjectDirs, getSessionFiles, parseSessionFile, extractMessages, getSessionMeta, } from './parser.js';
+// ── File path extraction ────────────────────────────────────────────────────
+/**
+ * Regex to match common file paths in tool results.
+ * Captures paths like /src/foo.ts, ./bar.js, C:\path\file.py, etc.
+ */
+const FILE_PATH_RE = /(?:^|[\s"'`(])([./~]?(?:[\w.-]+\/)+[\w.-]+\.(?:ts|tsx|js|jsx|py|rs|go|java|vue|svelte|css|scss|html|json|yaml|yml|toml|md|txt|sh|sql|prisma|graphql|proto))\b/g;
+function extractFilePaths(text) {
+    const paths = new Set();
+    let match;
+    // Reset lastIndex
+    FILE_PATH_RE.lastIndex = 0;
+    while ((match = FILE_PATH_RE.exec(text)) !== null) {
+        paths.add(match[1]);
+    }
+    return Array.from(paths);
+}
+/**
+ * Extract tool names from tool_use entries.
+ * The tool name is typically the first word or a JSON "name" field.
+ */
+const TOOL_NAME_RE = /(?:"name"\s*:\s*"([^"]+)"|^(\w+(?:_\w+)*))/;
+function extractToolName(content) {
+    const match = content.match(TOOL_NAME_RE);
+    return match ? (match[1] ?? match[2] ?? null) : null;
+}
+// ── Session summary ─────────────────────────────────────────────────────────
+/**
+ * Generate a structured summary of a session.
+ *
+ * - Extracts user messages as topics (first 300 chars each)
+ * - Collects unique tool names from tool_use entries
+ * - Extracts file paths mentioned in tool results
+ */
+export function getSessionSummary(sessionId, project) {
+    const projects = getProjectDirs().filter((p) => !project || p.name.toLowerCase().includes(project.toLowerCase()));
+    for (const proj of projects) {
+        const sessions = getSessionFiles(proj.path);
+        const match = sessions.find((s) => s.id === sessionId);
+        if (!match)
+            continue;
+        const entries = parseSessionFile(match.file);
+        if (entries.length === 0)
+            return null;
+        const meta = getSessionMeta(entries);
+        const messages = extractMessages(entries);
+        // Topics: user messages truncated to 300 chars
+        // Filter out tool results, JSON blobs, base64 images, system reminders
+        const isHumanMessage = (text) => {
+            const t = text.trimStart();
+            if (t.startsWith('[{') || t.startsWith('{"'))
+                return false;
+            if (t.includes('tool_use_id') || t.includes('tool_result'))
+                return false;
+            if (t.includes('base64') || t.includes('media_type'))
+                return false;
+            if (t.includes('<system-reminder>'))
+                return false;
+            if (t.length < 3)
+                return false;
+            return true;
+        };
+        const topics = messages
+            .filter((m) => m.role === 'user')
+            .filter((m) => isHumanMessage(m.content))
+            .map((m) => ({
+            timestamp: m.timestamp,
+            content: m.content.length > 300 ? m.content.substring(0, 300) + '...' : m.content,
+        }));
+        // Tools: unique tool names from tool_use messages
+        const toolNames = new Set();
+        for (const msg of messages) {
+            if (msg.role === 'tool_use') {
+                const name = extractToolName(msg.content);
+                if (name)
+                    toolNames.add(name);
+            }
+        }
+        // Files: paths mentioned in tool_result messages
+        const allFiles = new Set();
+        for (const msg of messages) {
+            if (msg.role === 'tool_result') {
+                for (const fp of extractFilePaths(msg.content)) {
+                    allFiles.add(fp);
+                }
+            }
+        }
+        return {
+            meta,
+            topicCount: topics.length,
+            topics,
+            toolsUsed: Array.from(toolNames).sort(),
+            filesModified: Array.from(allFiles).sort(),
+        };
+    }
+    return null;
+}
+// ── List sessions ───────────────────────────────────────────────────────────
+/**
+ * List all sessions with metadata, sorted by startTime descending.
+ * Optionally filter by project name (substring match).
+ */
+export function listSessions(project) {
+    const projects = getProjectDirs().filter((p) => !project || p.name.toLowerCase().includes(project.toLowerCase()));
+    const results = [];
+    for (const proj of projects) {
+        const sessions = getSessionFiles(proj.path);
+        for (const sess of sessions) {
+            try {
+                const entries = parseSessionFile(sess.file);
+                if (entries.length === 0)
+                    continue;
+                const meta = getSessionMeta(entries);
+                results.push({
+                    project: proj.name,
+                    sessionId: sess.id,
+                    ...meta,
+                });
+            }
+            catch {
+                // skip broken files
+            }
+        }
+    }
+    // Sort by startTime descending (newest first)
+    results.sort((a, b) => {
+        if (a.startTime === 'unknown')
+            return 1;
+        if (b.startTime === 'unknown')
+            return -1;
+        return new Date(b.startTime).getTime() - new Date(a.startTime).getTime();
+    });
+    return results;
+}
+//# sourceMappingURL=summary.js.map

package/dist/sessions/summary.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,26 @@
+import type { ProviderName } from './embeddings/types.js';
+export interface KnowledgeConfig {
+    memoryDir: string;
+    claudeDir: string;
+    projectsDir: string;
+    embeddingProvider: ProviderName;
+    embeddingAlpha: number;
+    gitUrl: string | undefined;
+    autoDistill: boolean;
+}
+export interface PersistedConfig {
+    gitUrl?: string;
+    memoryDir?: string;
+    autoDistill?: boolean;
+    embeddingProvider?: string;
+    embeddingAlpha?: number;
+}
+export declare function getConfigLocation(): string;
+export declare function loadPersistedConfig(): PersistedConfig;
+export declare function savePersistedConfig(updates: Partial<PersistedConfig>): PersistedConfig;
+export declare function getConfig(): KnowledgeConfig;
+/**
+ * Read the version from package.json (cached after first call).
+ */
+export declare function getVersion(): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,YAAY,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;CACtB;AAID,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAaD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,mBAAmB,IAAI,eAAe,CAQrD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAgBtF;AAID,wBAAgB,SAAS,IAAI,eAAe,CAkC3C;AAID;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAyBnC"}

package/dist/types.js

@@ -0,0 +1,109 @@
+import { homedir } from 'os';
+import { join } from 'path';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+function getConfigDir() {
+    if (process.platform === 'win32') {
+        return join(process.env.APPDATA || join(homedir(), 'AppData', 'Roaming'), 'knowledge');
+    }
+    return join(process.env.XDG_CONFIG_HOME || join(homedir(), '.config'), 'knowledge');
+}
+function getConfigPath() {
+    return join(getConfigDir(), 'config.json');
+}
+export function getConfigLocation() {
+    return getConfigPath();
+}
+export function loadPersistedConfig() {
+    const configPath = getConfigPath();
+    if (!existsSync(configPath))
+        return {};
+    try {
+        return JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function savePersistedConfig(updates) {
+    const configDir = getConfigDir();
+    if (!existsSync(configDir)) {
+        mkdirSync(configDir, { recursive: true });
+    }
+    const existing = loadPersistedConfig();
+    const merged = { ...existing };
+    for (const [key, value] of Object.entries(updates)) {
+        if (value === undefined || value === null || value === '') {
+            delete merged[key];
+        }
+        else {
+            merged[key] = value;
+        }
+    }
+    writeFileSync(getConfigPath(), JSON.stringify(merged, null, 2) + '\n', 'utf-8');
+    return merged;
+}
+// ── Config resolution (env vars > persisted config > defaults) ──────────────
+export function getConfig() {
+    const home = homedir();
+    const claudeDir = process.env.CLAUDE_DIR || join(home, '.claude');
+    const persisted = loadPersistedConfig();
+    const memoryDir = process.env.KNOWLEDGE_MEMORY_DIR ||
+        process.env.CLAUDE_MEMORY_DIR ||
+        persisted.memoryDir ||
+        join(home, 'claude-memory');
+    const projectsDir = join(claudeDir, 'projects');
+    const embeddingProvider = process.env.KNOWLEDGE_EMBEDDING_PROVIDER ||
+        persisted.embeddingProvider ||
+        'local';
+    const embeddingAlpha = parseFloat(process.env.KNOWLEDGE_EMBEDDING_ALPHA || String(persisted.embeddingAlpha ?? 0.3));
+    const gitUrl = process.env.KNOWLEDGE_GIT_URL || persisted.gitUrl || undefined;
+    const autoDistillEnv = process.env.KNOWLEDGE_AUTO_DISTILL;
+    const autoDistill = autoDistillEnv !== undefined
+        ? autoDistillEnv.toLowerCase() !== 'false'
+        : (persisted.autoDistill ?? true);
+    return {
+        memoryDir,
+        claudeDir,
+        projectsDir,
+        embeddingProvider,
+        embeddingAlpha,
+        gitUrl,
+        autoDistill,
+    };
+}
+let _version = null;
+/**
+ * Read the version from package.json (cached after first call).
+ */
+export function getVersion() {
+    if (_version)
+        return _version;
+    try {
+        const thisFile = fileURLToPath(import.meta.url);
+        const thisDir = dirname(thisFile);
+        // Try src/../package.json then dist/../package.json
+        for (const rel of [
+            join(thisDir, '..', 'package.json'),
+            join(thisDir, '..', '..', 'package.json'),
+        ]) {
+            try {
+                const pkg = JSON.parse(readFileSync(rel, 'utf-8'));
+                if (pkg.version) {
+                    _version = String(pkg.version);
+                    return _version;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    catch {
+        // fallback
+    }
+    _version = '1.0.0';
+    return _version;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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