cloison-runtime 0.1.0

package/dist/memory/file-indexer.js

@@ -0,0 +1,260 @@
+// Ported from OpenClaw extensions/memory-core/src/memory/manager-sync-ops.ts
+// ensureWatcher logic, IGNORED_MEMORY_WATCH_DIR_NAMES, shouldIgnoreMemoryWatchPath,
+// syncMemoryFiles with hash comparison and stale cleanup
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { createSubsystemLogger } from "../logging/subsystem.js";
+import { chunkMarkdown, hashText } from "./internal.js";
+const log = createSubsystemLogger("memory/file-indexer");
+const MAX_FILE_SIZE = 1024 * 1024;
+// From OpenClaw: exact list of ignored directory names
+const IGNORED_MEMORY_WATCH_DIR_NAMES = new Set([
+    ".git",
+    "node_modules",
+    ".pnpm-store",
+    ".venv",
+    "venv",
+    ".tox",
+    "__pycache__",
+]);
+// From OpenClaw
+function shouldIgnoreMemoryWatchPath(watchPath) {
+    const normalized = path.normalize(watchPath);
+    const parts = normalized.split(path.sep).map((segment) => segment.trim().toLowerCase());
+    return parts.some((segment) => IGNORED_MEMORY_WATCH_DIR_NAMES.has(segment));
+}
+export function createFileIndexer(options) {
+    const { workspaceDir, memory, debounceMs = 2000, chunking = { tokens: 500, overlap: 50 }, } = options;
+    const watchers = [];
+    let watching = false;
+    let watchTimer = null;
+    let dirty = false;
+    let syncLock = null;
+    const indexedFiles = new Map();
+    function resolveWatchPaths() {
+        const paths = new Set();
+        const memoryMd = path.join(workspaceDir, "MEMORY.md");
+        if (fs.existsSync(memoryMd))
+            paths.add(memoryMd);
+        const memoryMdLower = path.join(workspaceDir, "memory.md");
+        if (memoryMdLower !== memoryMd && fs.existsSync(memoryMdLower))
+            paths.add(memoryMdLower);
+        const memoryDir = path.join(workspaceDir, "memory");
+        if (fs.existsSync(memoryDir) && fs.statSync(memoryDir).isDirectory())
+            paths.add(memoryDir);
+        for (const p of [...(options.watchPaths ?? []), ...(options.extraPaths ?? [])]) {
+            const resolved = path.isAbsolute(p) ? p : path.join(workspaceDir, p);
+            try {
+                const stat = fs.lstatSync(resolved);
+                if (stat.isSymbolicLink())
+                    continue;
+                if (stat.isFile() || stat.isDirectory())
+                    paths.add(resolved);
+            }
+            catch { /* skip missing */ }
+        }
+        return Array.from(paths);
+    }
+    function collectMarkdownFiles(dir) {
+        const files = [];
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const full = path.join(dir, entry.name);
+                if (shouldIgnoreMemoryWatchPath(full))
+                    continue;
+                if (entry.isDirectory()) {
+                    files.push(...collectMarkdownFiles(full));
+                }
+                else if (entry.isFile() && (entry.name.endsWith(".md") || entry.name.endsWith(".txt"))) {
+                    files.push(full);
+                }
+            }
+        }
+        catch { /* directory not readable */ }
+        return files;
+    }
+    function collectAllFiles() {
+        const files = [];
+        const memoryMd = path.join(workspaceDir, "MEMORY.md");
+        if (fs.existsSync(memoryMd))
+            files.push(memoryMd);
+        const memoryMdLower = path.join(workspaceDir, "memory.md");
+        if (memoryMdLower !== memoryMd && fs.existsSync(memoryMdLower))
+            files.push(memoryMdLower);
+        const memoryDir = path.join(workspaceDir, "memory");
+        if (fs.existsSync(memoryDir) && fs.statSync(memoryDir).isDirectory()) {
+            files.push(...collectMarkdownFiles(memoryDir));
+        }
+        for (const p of [...(options.watchPaths ?? []), ...(options.extraPaths ?? [])]) {
+            const resolved = path.isAbsolute(p) ? p : path.join(workspaceDir, p);
+            try {
+                const stat = fs.lstatSync(resolved);
+                if (stat.isSymbolicLink())
+                    continue;
+                if (stat.isFile())
+                    files.push(resolved);
+                else if (stat.isDirectory())
+                    files.push(...collectMarkdownFiles(resolved));
+            }
+            catch { /* skip */ }
+        }
+        return [...new Set(files)];
+    }
+    function scheduleWatchSync() {
+        dirty = true;
+        if (watchTimer)
+            clearTimeout(watchTimer);
+        watchTimer = setTimeout(() => {
+            watchTimer = null;
+            sync().catch((err) => log.warn(`memory sync failed (watch): ${String(err)}`));
+        }, debounceMs);
+    }
+    async function sync() {
+        if (syncLock) {
+            return syncLock;
+        }
+        syncLock = syncImpl();
+        try {
+            return await syncLock;
+        }
+        finally {
+            syncLock = null;
+        }
+    }
+    async function syncImpl() {
+        dirty = false;
+        const result = {
+            filesProcessed: 0, chunksStored: 0, chunksRemoved: 0, errors: 0,
+        };
+        const currentFiles = collectAllFiles();
+        const currentPaths = new Set(currentFiles);
+        // Remove chunks for deleted files
+        for (const [filePath, state] of indexedFiles) {
+            if (!currentPaths.has(filePath)) {
+                for (const chunkId of state.chunkIds) {
+                    try {
+                        await memory.delete(chunkId);
+                        result.chunksRemoved++;
+                    }
+                    catch {
+                        result.errors++;
+                    }
+                }
+                indexedFiles.delete(filePath);
+            }
+        }
+        // Index new/changed files
+        for (const filePath of currentFiles) {
+            try {
+                const stat = fs.statSync(filePath);
+                if (stat.size > MAX_FILE_SIZE) {
+                    log.warn(`skipping large file: ${filePath} (${stat.size} bytes)`);
+                    continue;
+                }
+                const content = fs.readFileSync(filePath, "utf-8");
+                const hash = hashText(content);
+                const existing = indexedFiles.get(filePath);
+                // Skip unchanged files (OpenClaw's hash comparison)
+                if (existing && existing.hash === hash) {
+                    result.filesProcessed++;
+                    continue;
+                }
+                // Remove old chunks for changed files
+                if (existing) {
+                    for (const chunkId of existing.chunkIds) {
+                        try {
+                            await memory.delete(chunkId);
+                            result.chunksRemoved++;
+                        }
+                        catch {
+                            result.errors++;
+                        }
+                    }
+                }
+                const relPath = path.relative(workspaceDir, filePath);
+                const chunks = chunkMarkdown(content, chunking);
+                const newChunkIds = [];
+                for (const chunk of chunks) {
+                    if (!chunk.text.trim())
+                        continue;
+                    try {
+                        const id = await memory.store(chunk.text, {
+                            source: "file",
+                            path: relPath,
+                            startLine: chunk.startLine,
+                            endLine: chunk.endLine,
+                        });
+                        newChunkIds.push(id);
+                        result.chunksStored++;
+                    }
+                    catch {
+                        result.errors++;
+                    }
+                }
+                indexedFiles.set(filePath, { hash, chunkIds: newChunkIds });
+                result.filesProcessed++;
+            }
+            catch (err) {
+                log.error(`failed to index ${filePath}`, { error: String(err) });
+                result.errors++;
+            }
+        }
+        log.info("sync complete", {
+            files: result.filesProcessed, stored: result.chunksStored,
+            removed: result.chunksRemoved, errors: result.errors,
+        });
+        return result;
+    }
+    return {
+        get watching() { return watching; },
+        start() {
+            if (watching)
+                return;
+            watching = true;
+            const paths = resolveWatchPaths();
+            if (paths.length === 0) {
+                log.debug("no watch paths found");
+                return;
+            }
+            for (const watchPath of paths) {
+                try {
+                    const isDir = fs.statSync(watchPath).isDirectory();
+                    const watcher = fs.watch(watchPath, { recursive: isDir, persistent: false }, (_eventType, filename) => {
+                        if (!filename)
+                            return;
+                        if (shouldIgnoreMemoryWatchPath(filename))
+                            return;
+                        const ext = path.extname(filename);
+                        if (ext === ".md" || ext === ".txt" || filename === "MEMORY.md") {
+                            log.debug(`file change detected: ${filename}`);
+                            scheduleWatchSync();
+                        }
+                    });
+                    watchers.push(watcher);
+                }
+                catch (err) {
+                    log.warn(`cannot watch ${watchPath}: ${err}`);
+                }
+            }
+            log.info(`watching ${paths.length} paths for changes`);
+            sync().catch((err) => log.error("initial sync failed", { error: String(err) }));
+        },
+        stop() {
+            watching = false;
+            if (watchTimer) {
+                clearTimeout(watchTimer);
+                watchTimer = null;
+            }
+            for (const w of watchers) {
+                try {
+                    w.close();
+                }
+                catch { /* best effort */ }
+            }
+            watchers.length = 0;
+        },
+        sync,
+    };
+}
+//# sourceMappingURL=file-indexer.js.map

package/dist/memory/file-indexer.js.map

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

package/dist/memory/fs-utils.d.ts

@@ -0,0 +1,12 @@
+import type { Stats } from "node:fs";
+export type RegularFileStatResult = {
+    missing: true;
+} | {
+    missing: false;
+    stat: Stats;
+};
+export declare function isFileMissingError(err: unknown): err is NodeJS.ErrnoException & {
+    code: "ENOENT";
+};
+export declare function statRegularFile(absPath: string): Promise<RegularFileStatResult>;
+//# sourceMappingURL=fs-utils.d.ts.map

package/dist/memory/fs-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.d.ts","sourceRoot":"","sources":["../../src/memory/fs-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC,MAAM,MAAM,qBAAqB,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAExF,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,GACX,GAAG,IAAI,MAAM,CAAC,cAAc,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAOnD;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAcrF"}

package/dist/memory/fs-utils.js

@@ -0,0 +1,24 @@
+import fs from "node:fs/promises";
+export function isFileMissingError(err) {
+    return Boolean(err &&
+        typeof err === "object" &&
+        "code" in err &&
+        err.code === "ENOENT");
+}
+export async function statRegularFile(absPath) {
+    let stat;
+    try {
+        stat = await fs.lstat(absPath);
+    }
+    catch (err) {
+        if (isFileMissingError(err)) {
+            return { missing: true };
+        }
+        throw err;
+    }
+    if (stat.isSymbolicLink() || !stat.isFile()) {
+        throw new Error("path required");
+    }
+    return { missing: false, stat };
+}
+//# sourceMappingURL=fs-utils.js.map

package/dist/memory/fs-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../../src/memory/fs-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIlC,MAAM,UAAU,kBAAkB,CAChC,GAAY;IAEZ,OAAO,OAAO,CACZ,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,MAAM,IAAI,GAAG;QACZ,GAAsC,CAAC,IAAI,KAAK,QAAQ,CAC1D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,IAAI,IAAW,CAAC;IAChB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/dist/memory/hybrid.d.ts

@@ -0,0 +1,46 @@
+import { type MMRConfig, DEFAULT_MMR_CONFIG } from "./mmr.js";
+import { type TemporalDecayConfig, DEFAULT_TEMPORAL_DECAY_CONFIG } from "./temporal-decay.js";
+export type HybridSource = string;
+export { type MMRConfig, DEFAULT_MMR_CONFIG };
+export { type TemporalDecayConfig, DEFAULT_TEMPORAL_DECAY_CONFIG };
+export type HybridVectorResult = {
+    id: string;
+    path: string;
+    startLine: number;
+    endLine: number;
+    source: HybridSource;
+    snippet: string;
+    vectorScore: number;
+};
+export type HybridKeywordResult = {
+    id: string;
+    path: string;
+    startLine: number;
+    endLine: number;
+    source: HybridSource;
+    snippet: string;
+    textScore: number;
+};
+export declare function buildFtsQuery(raw: string): string | null;
+export declare function bm25RankToScore(rank: number): number;
+export declare function mergeHybridResults(params: {
+    vector: HybridVectorResult[];
+    keyword: HybridKeywordResult[];
+    vectorWeight: number;
+    textWeight: number;
+    workspaceDir?: string;
+    /** MMR configuration for diversity-aware re-ranking */
+    mmr?: Partial<MMRConfig>;
+    /** Temporal decay configuration for recency-aware scoring */
+    temporalDecay?: Partial<TemporalDecayConfig>;
+    /** Test seam for deterministic time-dependent behavior */
+    nowMs?: number;
+}): Promise<Array<{
+    path: string;
+    startLine: number;
+    endLine: number;
+    score: number;
+    snippet: string;
+    source: HybridSource;
+}>>;
+//# sourceMappingURL=hybrid.d.ts.map

package/dist/memory/hybrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid.d.ts","sourceRoot":"","sources":["../../src/memory/hybrid.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,SAAS,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACvF,OAAO,EAEL,KAAK,mBAAmB,EACxB,6BAA6B,EAC9B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,OAAO,EAAE,KAAK,SAAS,EAAE,kBAAkB,EAAE,CAAC;AAC9C,OAAO,EAAE,KAAK,mBAAmB,EAAE,6BAA6B,EAAE,CAAC;AAEnE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWxD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,GAAG,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACzB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7C,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CACT,KAAK,CAAC;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC,CACH,CA6EA"}

package/dist/memory/hybrid.js

@@ -0,0 +1,85 @@
+import { applyMMRToHybridResults, DEFAULT_MMR_CONFIG } from "./mmr.js";
+import { applyTemporalDecayToHybridResults, DEFAULT_TEMPORAL_DECAY_CONFIG, } from "./temporal-decay.js";
+export { DEFAULT_MMR_CONFIG };
+export { DEFAULT_TEMPORAL_DECAY_CONFIG };
+export function buildFtsQuery(raw) {
+    const tokens = raw
+        .match(/[\p{L}\p{N}_]+/gu)
+        ?.map((t) => t.trim())
+        .filter(Boolean) ?? [];
+    if (tokens.length === 0) {
+        return null;
+    }
+    const quoted = tokens.map((t) => `"${t.replaceAll('"', "")}"`);
+    return quoted.join(" AND ");
+}
+export function bm25RankToScore(rank) {
+    if (!Number.isFinite(rank))
+        return 0;
+    // bm25() returns values <= 0 where more negative = more relevant.
+    // Negate to get a positive relevance value, then normalize to [0, 1).
+    const positive = Math.max(0, -rank);
+    return positive / (1 + positive);
+}
+export async function mergeHybridResults(params) {
+    const byId = new Map();
+    for (const r of params.vector) {
+        byId.set(r.id, {
+            id: r.id,
+            path: r.path,
+            startLine: r.startLine,
+            endLine: r.endLine,
+            source: r.source,
+            snippet: r.snippet,
+            vectorScore: r.vectorScore,
+            textScore: 0,
+        });
+    }
+    for (const r of params.keyword) {
+        const existing = byId.get(r.id);
+        if (existing) {
+            existing.textScore = r.textScore;
+            if (r.snippet && r.snippet.length > 0) {
+                existing.snippet = r.snippet;
+            }
+        }
+        else {
+            byId.set(r.id, {
+                id: r.id,
+                path: r.path,
+                startLine: r.startLine,
+                endLine: r.endLine,
+                source: r.source,
+                snippet: r.snippet,
+                vectorScore: 0,
+                textScore: r.textScore,
+            });
+        }
+    }
+    const merged = Array.from(byId.values()).map((entry) => {
+        const score = params.vectorWeight * entry.vectorScore + params.textWeight * entry.textScore;
+        return {
+            path: entry.path,
+            startLine: entry.startLine,
+            endLine: entry.endLine,
+            score,
+            snippet: entry.snippet,
+            source: entry.source,
+        };
+    });
+    const temporalDecayConfig = { ...DEFAULT_TEMPORAL_DECAY_CONFIG, ...params.temporalDecay };
+    const decayed = await applyTemporalDecayToHybridResults({
+        results: merged,
+        temporalDecay: temporalDecayConfig,
+        workspaceDir: params.workspaceDir,
+        nowMs: params.nowMs,
+    });
+    const sorted = decayed.toSorted((a, b) => b.score - a.score);
+    // Apply MMR re-ranking if enabled
+    const mmrConfig = { ...DEFAULT_MMR_CONFIG, ...params.mmr };
+    if (mmrConfig.enabled) {
+        return applyMMRToHybridResults(sorted, mmrConfig);
+    }
+    return sorted;
+}
+//# sourceMappingURL=hybrid.js.map

package/dist/memory/hybrid.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,17 @@
+export type { MemorySource, MemorySearchResult, MemorySearchManager, MemoryEmbeddingProbeResult, MemorySyncProgressUpdate, MemoryProviderStatus, } from "./types.js";
+export type { EmbeddingProvider } from "./embeddings.js";
+export { cosineSimilarity, chunkMarkdown, listMemoryFiles, hashText, buildFileEntry, isMemoryPath, parseEmbedding, type MemoryFileEntry, type MemoryChunk, } from "./internal.js";
+export { searchVector, searchKeyword } from "./manager-search.js";
+export { mergeHybridResults } from "./hybrid.js";
+export { mmrRerank, applyMMRToHybridResults } from "./mmr.js";
+export { applyTemporalDecayToHybridResults, applyTemporalDecayToScore, calculateTemporalDecayMultiplier, } from "./temporal-decay.js";
+export { extractKeywords } from "./query-expansion.js";
+export { buildFtsQuery, bm25RankToScore } from "./hybrid.js";
+export { requireNodeSqlite } from "./sqlite.js";
+export { createSimpleMemoryManager, type SimpleMemoryManager } from "./simple-manager.js";
+export { createEmbeddingCache, hashContent, type EmbeddingCache, } from "./embedding-cache.js";
+export { embedBatchWithCacheAndRetry, embedQueryWithTimeout, runBatchWithFallback, createBatchFailureState, enforceEmbeddingMaxInputTokens, type BatchEmbeddingOptions, type BatchEmbeddingResult, type BatchFailureState, } from "./embedding-batch.js";
+export { createFileIndexer, type FileIndexer, type FileIndexerOptions, type FileIndexSyncResult, } from "./file-indexer.js";
+export { createSessionIndexer, type SessionIndexer, type SessionIndexerOptions, type SessionIndexResult, } from "./session-indexer.js";
+export { buildBaseUrlPolicy, validateUrl, fetchWithSsrfGuard, type SsrfPolicy, } from "./ssrf.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EACL,iCAAiC,EACjC,yBAAyB,EACzB,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,yBAAyB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1F,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,8BAA8B,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,15 @@
+export { cosineSimilarity, chunkMarkdown, listMemoryFiles, hashText, buildFileEntry, isMemoryPath, parseEmbedding, } from "./internal.js";
+export { searchVector, searchKeyword } from "./manager-search.js";
+export { mergeHybridResults } from "./hybrid.js";
+export { mmrRerank, applyMMRToHybridResults } from "./mmr.js";
+export { applyTemporalDecayToHybridResults, applyTemporalDecayToScore, calculateTemporalDecayMultiplier, } from "./temporal-decay.js";
+export { extractKeywords } from "./query-expansion.js";
+export { buildFtsQuery, bm25RankToScore } from "./hybrid.js";
+export { requireNodeSqlite } from "./sqlite.js";
+export { createSimpleMemoryManager } from "./simple-manager.js";
+export { createEmbeddingCache, hashContent, } from "./embedding-cache.js";
+export { embedBatchWithCacheAndRetry, embedQueryWithTimeout, runBatchWithFallback, createBatchFailureState, enforceEmbeddingMaxInputTokens, } from "./embedding-batch.js";
+export { createFileIndexer, } from "./file-indexer.js";
+export { createSessionIndexer, } from "./session-indexer.js";
+export { buildBaseUrlPolicy, validateUrl, fetchWithSsrfGuard, } from "./ssrf.js";
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,cAAc,GAGf,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EACL,iCAAiC,EACjC,yBAAyB,EACzB,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,yBAAyB,EAA4B,MAAM,qBAAqB,CAAC;AAE1F,OAAO,EACL,oBAAoB,EACpB,WAAW,GAEZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,8BAA8B,GAI/B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,GAIlB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,oBAAoB,GAIrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,kBAAkB,GAEnB,MAAM,WAAW,CAAC"}

package/dist/memory/internal.d.ts

@@ -0,0 +1,39 @@
+export type MemoryFileEntry = {
+    path: string;
+    absPath: string;
+    mtimeMs: number;
+    size: number;
+    hash: string;
+};
+export type MemoryChunk = {
+    startLine: number;
+    endLine: number;
+    text: string;
+    hash: string;
+};
+export declare function ensureDir(dir: string): string;
+export declare function normalizeRelPath(value: string): string;
+export declare function normalizeExtraMemoryPaths(workspaceDir: string, extraPaths?: string[]): string[];
+export declare function isMemoryPath(relPath: string): boolean;
+export declare function listMemoryFiles(workspaceDir: string, extraPaths?: string[]): Promise<string[]>;
+export declare function hashText(value: string): string;
+export declare function buildFileEntry(absPath: string, workspaceDir: string): Promise<MemoryFileEntry | null>;
+export declare function chunkMarkdown(content: string, chunking: {
+    tokens: number;
+    overlap: number;
+}): MemoryChunk[];
+/**
+ * Remap chunk startLine/endLine from content-relative positions to original
+ * source file positions using a lineMap.  Each entry in lineMap gives the
+ * 1-indexed source line for the corresponding 0-indexed content line.
+ *
+ * This is used for session JSONL files where buildSessionEntry() flattens
+ * messages into a plain-text string before chunking.  Without remapping the
+ * stored line numbers would reference positions in the flattened text rather
+ * than the original JSONL file.
+ */
+export declare function remapChunkLines(chunks: MemoryChunk[], lineMap: number[] | undefined): void;
+export declare function parseEmbedding(raw: string): number[];
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+export declare function runWithConcurrency<T>(tasks: Array<() => Promise<T>>, limit: number): Promise<T[]>;
+//# sourceMappingURL=internal.d.ts.map

package/dist/memory/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/memory/internal.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAW/F;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CASrD;AAuBD,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CA+DnB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA2BjC;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5C,WAAW,EAAE,CA8Ef;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,CAS1F;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAOpD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAmBjE;AAED,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,KAAK,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAC9B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,EAAE,CAAC,CAUd"}