agent-knowledge 1.0.0

package/dist/sessions/indexer.js

@@ -0,0 +1,182 @@
+import { getEmbeddingProvider } from '../embeddings/index.js';
+import { VectorStore, chunkKnowledge, chunkSession } from '../vectorstore/index.js';
+import { listEntries, readEntry } from '../knowledge/store.js';
+import { getProjectDirs, getSessionFiles, parseSessionFile, extractMessages, getSessionMeta, } from './parser.js';
+import { getConfig } from '../types.js';
+import { distillSessions } from '../knowledge/distill.js';
+let _vectorStore = null;
+function getVectorStore() {
+    if (!_vectorStore) {
+        _vectorStore = new VectorStore();
+    }
+    return _vectorStore;
+}
+/**
+ * Index a single knowledge entry into the vector store.
+ */
+export async function indexKnowledgeEntry(path, content) {
+    const provider = await getEmbeddingProvider();
+    if (!provider)
+        return;
+    const store = getVectorStore();
+    const chunks = chunkKnowledge(content);
+    if (chunks.length === 0)
+        return;
+    const texts = chunks.map((c) => c.text);
+    const embeddings = await provider.embed(texts);
+    const entries = chunks.map((chunk, i) => ({
+        id: `knowledge:${path}:${chunk.index}`,
+        source: 'knowledge',
+        sourceId: path,
+        chunkIndex: chunk.index,
+        chunkText: chunk.text,
+        provider: provider.name,
+        dimensions: provider.dimensions,
+        embedding: embeddings[i],
+        metadata: chunk.metadata,
+    }));
+    store.upsert(entries);
+}
+/**
+ * Index session messages into the vector store.
+ */
+export async function indexSessionMessages(sessionId, messages) {
+    const provider = await getEmbeddingProvider();
+    if (!provider)
+        return;
+    const store = getVectorStore();
+    const chunks = chunkSession(messages);
+    if (chunks.length === 0)
+        return;
+    const texts = chunks.map((c) => c.text);
+    const embeddings = await provider.embed(texts);
+    const entries = chunks.map((chunk, i) => ({
+        id: `session:${sessionId}:${chunk.index}`,
+        source: 'session',
+        sourceId: sessionId,
+        chunkIndex: chunk.index,
+        chunkText: chunk.text,
+        provider: provider.name,
+        dimensions: provider.dimensions,
+        embedding: embeddings[i],
+        metadata: chunk.metadata,
+    }));
+    store.upsert(entries);
+}
+/**
+ * Background indexer that embeds all unindexed knowledge entries and session
+ * messages. Runs non-blocking after server startup.
+ */
+export async function backgroundIndex() {
+    const provider = await getEmbeddingProvider();
+    if (!provider) {
+        console.error('[knowledge] No embedding provider available, skipping background index');
+        return;
+    }
+    const store = getVectorStore();
+    const wiped = store.setProvider(provider.name, provider.dimensions);
+    if (wiped) {
+        console.error('[knowledge] Embedding provider changed, wiped existing vectors');
+    }
+    const config = getConfig();
+    // ── Index knowledge entries ─────────────────────────────────────────────
+    try {
+        const entries = listEntries(config.memoryDir);
+        let indexed = 0;
+        const total = entries.length;
+        for (const entry of entries) {
+            try {
+                if (store.hasEmbeddings(entry.path)) {
+                    indexed++;
+                    continue;
+                }
+                const { content } = readEntry(config.memoryDir, entry.path);
+                await indexKnowledgeEntry(entry.path, content);
+                indexed++;
+                if (indexed % 10 === 0 || indexed === total) {
+                    console.error(`[knowledge] Indexed ${indexed}/${total} knowledge entries...`);
+                }
+                await new Promise((r) => setTimeout(r, 100));
+            }
+            catch (err) {
+                console.error(`[knowledge] Failed to index knowledge entry ${entry.path}: ${err}`);
+            }
+        }
+        if (total > 0) {
+            console.error(`[knowledge] Knowledge indexing complete: ${indexed}/${total}`);
+        }
+    }
+    catch (err) {
+        console.error(`[knowledge] Knowledge indexing failed: ${err}`);
+    }
+    // ── Index session messages ──────────────────────────────────────────────
+    try {
+        const projects = getProjectDirs();
+        let totalSessions = 0;
+        let indexedSessions = 0;
+        for (const proj of projects) {
+            const sessions = getSessionFiles(proj.path);
+            totalSessions += sessions.length;
+        }
+        for (const proj of projects) {
+            const sessions = getSessionFiles(proj.path);
+            for (const sess of sessions) {
+                try {
+                    if (store.hasEmbeddings(sess.id)) {
+                        indexedSessions++;
+                        continue;
+                    }
+                    const entries = parseSessionFile(sess.file);
+                    if (entries.length === 0) {
+                        indexedSessions++;
+                        continue;
+                    }
+                    const meta = getSessionMeta(entries);
+                    const messages = extractMessages(entries);
+                    const sessionMessages = messages.map((m) => ({
+                        role: m.role,
+                        text: m.content,
+                        timestamp: m.timestamp ?? meta.startTime,
+                        sessionId: sess.id,
+                    }));
+                    await indexSessionMessages(sess.id, sessionMessages);
+                    indexedSessions++;
+                    if (indexedSessions % 20 === 0 || indexedSessions === totalSessions) {
+                        console.error(`[knowledge] Indexed ${indexedSessions}/${totalSessions} sessions...`);
+                    }
+                    await new Promise((r) => setTimeout(r, 100));
+                }
+                catch (err) {
+                    console.error(`[knowledge] Failed to index session ${sess.id}: ${err}`);
+                    indexedSessions++;
+                }
+            }
+        }
+        if (totalSessions > 0) {
+            console.error(`[knowledge] Session indexing complete: ${indexedSessions}/${totalSessions}`);
+        }
+    }
+    catch (err) {
+        console.error(`[knowledge] Session indexing failed: ${err}`);
+    }
+    console.error('[knowledge] Background indexing complete');
+    // ── Auto-distill session insights into knowledge base ───────────────────
+    const config2 = getConfig();
+    if (config2.autoDistill) {
+        try {
+            console.error('[knowledge] Starting auto-distillation...');
+            const result = await distillSessions();
+            const total = result.updated.length + result.created.length;
+            if (total > 0) {
+                console.error(`[knowledge] Distilled ${total} project(s): ${result.updated.length} updated, ${result.created.length} created`);
+            }
+            else {
+                console.error('[knowledge] No new sessions to distill');
+            }
+        }
+        catch (err) {
+            console.error(`[knowledge] Auto-distillation failed: ${err}`);
+        }
+    }
+}
+//# sourceMappingURL=indexer.js.map

package/dist/sessions/indexer.js.map

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

package/dist/sessions/parser.d.ts

@@ -0,0 +1,58 @@
+export interface SessionEntry {
+    type: string;
+    timestamp?: string;
+    sessionId?: string;
+    cwd?: string;
+    gitBranch?: string;
+    message?: {
+        role?: string;
+        content: unknown;
+    };
+    content?: string;
+}
+export interface SessionMessage {
+    role: 'user' | 'assistant' | 'tool_use' | 'tool_result';
+    content: string;
+    timestamp: string | null;
+}
+export interface SessionMeta {
+    startTime: string;
+    endTime: string;
+    cwd: string;
+    branch: string;
+    messageCount: number;
+    userMessageCount: number;
+    preview: string;
+}
+/**
+ * Parse a JSONL session file into an array of entries.
+ * Malformed lines are silently skipped.
+ */
+export declare function parseSessionFile(filePath: string): SessionEntry[];
+/**
+ * Extract structured messages from raw session entries.
+ *
+ * - User messages: entry.message.content (string or stringified)
+ * - Assistant messages: text parts from content array
+ * - Tool use / result: content truncated to 500 chars
+ */
+export declare function extractMessages(entries: SessionEntry[]): SessionMessage[];
+/**
+ * Extract metadata from session entries (first/last entry, counts, preview).
+ */
+export declare function getSessionMeta(entries: SessionEntry[]): SessionMeta;
+/**
+ * Discover all project directories under ~/.claude/projects/
+ */
+export declare function getProjectDirs(): Array<{
+    name: string;
+    path: string;
+}>;
+/**
+ * List all .jsonl session files in a given project directory.
+ */
+export declare function getSessionFiles(projectPath: string): Array<{
+    id: string;
+    file: string;
+}>;
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/sessions/parser.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,CAAC;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAoBjE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,cAAc,EAAE,CAuDzE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,WAAW,CA2BnE;AAID;;GAEG;AACH,wBAAgB,cAAc,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAWtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAUxF"}

package/dist/sessions/parser.js

@@ -0,0 +1,142 @@
+import fs from 'fs';
+import path from 'path';
+import { getConfig } from '../types.js';
+// ── Parsing ─────────────────────────────────────────────────────────────────
+/**
+ * Parse a JSONL session file into an array of entries.
+ * Malformed lines are silently skipped.
+ */
+export function parseSessionFile(filePath) {
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const lines = raw.split('\n').filter((l) => l.trim());
+    const entries = [];
+    for (const line of lines) {
+        try {
+            entries.push(JSON.parse(line));
+        }
+        catch {
+            // skip malformed lines gracefully
+        }
+    }
+    return entries;
+}
+/**
+ * Extract structured messages from raw session entries.
+ *
+ * - User messages: entry.message.content (string or stringified)
+ * - Assistant messages: text parts from content array
+ * - Tool use / result: content truncated to 500 chars
+ */
+export function extractMessages(entries) {
+    const messages = [];
+    for (const entry of entries) {
+        const ts = entry.timestamp ?? null;
+        if (entry.type === 'user' && entry.message?.content) {
+            const content = typeof entry.message.content === 'string'
+                ? entry.message.content
+                : JSON.stringify(entry.message.content);
+            messages.push({ role: 'user', content, timestamp: ts });
+        }
+        else if (entry.type === 'assistant' && entry.message?.content) {
+            const parts = Array.isArray(entry.message.content)
+                ? entry.message.content
+                : [entry.message.content];
+            const textParts = parts
+                .filter((p) => typeof p === 'string' ||
+                (typeof p === 'object' &&
+                    p !== null &&
+                    'type' in p &&
+                    p.type === 'text'))
+                .map((p) => (typeof p === 'string' ? p : p.text))
+                .filter(Boolean);
+            if (textParts.length > 0) {
+                messages.push({
+                    role: 'assistant',
+                    content: textParts.join('\n'),
+                    timestamp: ts,
+                });
+            }
+        }
+        else if (entry.type === 'tool_use' || entry.type === 'tool_result') {
+            const content = typeof entry.content === 'string'
+                ? entry.content
+                : typeof entry.message?.content === 'string'
+                    ? entry.message.content
+                    : null;
+            if (content) {
+                messages.push({
+                    role: entry.type,
+                    content: content.substring(0, 500),
+                    timestamp: ts,
+                });
+            }
+        }
+    }
+    return messages;
+}
+/**
+ * Extract metadata from session entries (first/last entry, counts, preview).
+ */
+export function getSessionMeta(entries) {
+    if (entries.length === 0) {
+        return {
+            startTime: 'unknown',
+            endTime: 'unknown',
+            cwd: 'unknown',
+            branch: 'unknown',
+            messageCount: 0,
+            userMessageCount: 0,
+            preview: 'N/A',
+        };
+    }
+    const first = entries[0];
+    const last = entries[entries.length - 1];
+    const userMessages = entries.filter((e) => e.type === 'user');
+    const firstUserMsg = userMessages[0]?.message?.content;
+    return {
+        startTime: first?.timestamp ?? 'unknown',
+        endTime: last?.timestamp ?? 'unknown',
+        cwd: first?.cwd ?? 'unknown',
+        branch: first?.gitBranch ?? 'unknown',
+        messageCount: entries.length,
+        userMessageCount: userMessages.length,
+        preview: typeof firstUserMsg === 'string' ? firstUserMsg.substring(0, 200) : 'N/A',
+    };
+}
+// ── Discovery ───────────────────────────────────────────────────────────────
+/**
+ * Discover all project directories under ~/.claude/projects/
+ */
+export function getProjectDirs() {
+    const { projectsDir } = getConfig();
+    if (!fs.existsSync(projectsDir))
+        return [];
+    return fs
+        .readdirSync(projectsDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .map((d) => ({
+        name: d.name,
+        path: path.join(projectsDir, d.name),
+    }));
+}
+/**
+ * List all .jsonl session files in a given project directory.
+ */
+export function getSessionFiles(projectPath) {
+    if (!fs.existsSync(projectPath))
+        return [];
+    return fs
+        .readdirSync(projectPath)
+        .filter((f) => f.endsWith('.jsonl'))
+        .map((f) => ({
+        id: f.replace('.jsonl', ''),
+        file: path.join(projectPath, f),
+    }));
+}
+//# sourceMappingURL=parser.js.map

package/dist/sessions/parser.js.map

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

package/dist/sessions/scopes.d.ts

@@ -0,0 +1,16 @@
+import type { SearchResult } from '../search/types.js';
+export type SearchScope = 'errors' | 'plans' | 'configs' | 'tools' | 'files' | 'decisions' | 'all';
+export interface ScopedSearchOptions {
+    project?: string;
+    maxResults?: number;
+    semantic?: boolean;
+}
+/**
+ * Perform a search scoped to a specific category of content.
+ *
+ * Each scope pre-filters messages by role/content patterns, then applies TF-IDF
+ * ranking with the user query on the remaining messages. When semantic search
+ * is available, blends vector similarity with TF-IDF scores.
+ */
+export declare function scopedSearch(scope: SearchScope, query: string, options?: ScopedSearchOptions): Promise<SearchResult[]>;
+//# sourceMappingURL=scopes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scopes.d.ts","sourceRoot":"","sources":["../../src/sessions/scopes.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOvD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,KAAK,CAAC;AAEnG,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA8BD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,YAAY,EAAE,CAAC,CAuIzB"}

package/dist/sessions/scopes.js

@@ -0,0 +1,153 @@
+import { getProjectDirs, getSessionFiles, parseSessionFile, extractMessages, getSessionMeta, } from './parser.js';
+import { TfIdfIndex, recencyDecay } from '../search/tfidf.js';
+import { buildExcerpt } from '../search/excerpt.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;
+}
+// ── Scope pattern definitions ───────────────────────────────────────────────
+const SCOPE_PATTERNS = {
+    errors: /\b(error|exception|failed|failure|crash|stack\s*trace|ENOENT|EACCES|EPERM|ECONNREFUSED|TypeError|ReferenceError|SyntaxError|FATAL|panic|segfault|abort|unhandled|rejected)\b/i,
+    plans: /\b(plan|step\s+\d|phase|approach|strategy|TODO|FIXME|architecture|roadmap|milestone|objective|next\s+steps|action\s+items)\b/i,
+    configs: /\b(config|settings|\.env|\.json|\.yaml|\.yml|\.toml|tsconfig|package\.json|webpack|vite|eslint|prettier|docker|compose|nginx)\b/i,
+    files: /(?:src\/|lib\/|dist\/|\.ts\b|\.js\b|\.py\b|\.rs\b|\.go\b|\.java\b|\.vue\b|\.tsx\b|\.jsx\b|\/[\w.-]+\/|created|modified|deleted|renamed|moved)\b/i,
+    decisions: /\b(decided|chose|chosen|because|tradeoff|trade-off|instead\s+of|going\s+with|opted\s+for|rationale|reasoning|prefer|alternative|pros\s+and\s+cons|conclusion)\b/i,
+};
+// ── Scoped search ───────────────────────────────────────────────────────────
+/**
+ * Perform a search scoped to a specific category of content.
+ *
+ * Each scope pre-filters messages by role/content patterns, then applies TF-IDF
+ * ranking with the user query on the remaining messages. When semantic search
+ * is available, blends vector similarity with TF-IDF scores.
+ */
+export async function scopedSearch(scope, query, options = {}) {
+    const { project, maxResults = 20, semantic = true } = options;
+    const projects = getProjectDirs().filter((p) => !project || p.name.toLowerCase().includes(project.toLowerCase()));
+    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);
+                const filtered = filterByScope(scope, messages);
+                for (const msg of filtered) {
+                    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);
+    const tfidfResults = 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: {
+                scope,
+                sessionDate: doc.sessionDate,
+                relevanceScore: score,
+                recencyMultiplier: Math.round(decay * 100) / 100,
+            },
+        };
+    })
+        .filter((r) => r !== null);
+    tfidfResults.sort((a, b) => b.score - a.score);
+    const trimmedTfidf = tfidfResults.slice(0, maxResults);
+    if (!semantic) {
+        return trimmedTfidf;
+    }
+    try {
+        const provider = await getEmbeddingProvider();
+        if (!provider)
+            return trimmedTfidf;
+        const queryVector = await provider.embedOne(query);
+        const store = getVectorStore();
+        const vectorResults = store.searchBySource(queryVector, 'session', maxResults * 2);
+        if (vectorResults.length === 0)
+            return trimmedTfidf;
+        const config = getConfig();
+        const alpha = config.embeddingAlpha;
+        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);
+            }
+        }
+        const maxTfidf = trimmedTfidf.length > 0 ? Math.max(...trimmedTfidf.map((r) => r.score)) : 1;
+        const normFactor = maxTfidf > 0 ? maxTfidf : 1;
+        const results = trimmedTfidf.map((result) => {
+            const normalizedTfidf = result.score / normFactor;
+            const semanticScore = semanticScores.get(result.id) ?? 0;
+            const blended = alpha * normalizedTfidf + (1 - alpha) * semanticScore;
+            const ts = result.timestamp ?? result.metadata?.sessionDate;
+            const decay = ts ? recencyDecay(ts) : 1;
+            const finalScore = blended * decay;
+            return {
+                ...result,
+                score: finalScore,
+                metadata: {
+                    ...result.metadata,
+                    tfidfScore: normalizedTfidf,
+                    semanticScore,
+                    blendAlpha: alpha,
+                },
+            };
+        });
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, maxResults);
+    }
+    catch {
+        return trimmedTfidf;
+    }
+}
+// ── Scope filters ───────────────────────────────────────────────────────────
+function filterByScope(scope, messages) {
+    if (scope === 'all') {
+        return messages;
+    }
+    if (scope === 'tools') {
+        return messages.filter((m) => m.role === 'tool_use' || m.role === 'tool_result');
+    }
+    const pattern = SCOPE_PATTERNS[scope];
+    return messages.filter((m) => pattern.test(m.content));
+}
+//# sourceMappingURL=scopes.js.map

package/dist/sessions/scopes.js.map

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

package/dist/sessions/search.d.ts

@@ -0,0 +1,26 @@
+import type { SearchResult } from '../search/types.js';
+export interface SearchSessionOptions {
+    project?: string;
+    role?: 'user' | 'assistant' | 'all';
+    caseSensitive?: boolean;
+    maxResults?: number;
+    /** When true (default), use TF-IDF ranking. When false, use regex matching. */
+    ranked?: boolean;
+    /** When true (default when embeddings available), blend semantic similarity with TF-IDF. */
+    semantic?: boolean;
+}
+/**
+ * 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 declare function searchSessions(query: string, options?: SearchSessionOptions): Promise<SearchResult[]>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/sessions/search.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,KAAK,CAAC;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,YAAY,EAAE,CAAC,CAoCzB"}