@chendpoc/pi-memory 0.1.13 → 0.2.0

package/dist/config/index.js

@@ -0,0 +1,7 @@
+export { KNOWN_EMBED_DIMS, readPiMemoryEnv, resolveEmbedDim } from "./env.js";
+export { readRetrievalConfig } from "./retrieval.js";
+export { readChunkingConfig } from "./chunking.js";
+export { resolvePreflightBudget } from "./preflightBudget.js";
+export { resolveAgentDirFromEnv, resolveMemoryAgentDir } from "./agentDir.js";
+export { loadEnv } from "./loadEnv.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAA2C,MAAM,UAAU,CAAC;AACvH,OAAO,EAAE,mBAAmB,EAAwB,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAuB,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAwB,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAqC,MAAM,eAAe,CAAC;AACjH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/config/loadEnv.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Load pi-memory env into process.env (does not override existing vars).
+ *
+ * Search order:
+ * 1. PI_MEMORY_ENV_FILE (explicit override)
+ * 2. cwd `.env` / `.env.local` (project-local dev)
+ * 3. ~/.pi/agent/pi-memory.env (recommended)
+ */
+export declare function loadEnv(cwd?: string): void;
+//# sourceMappingURL=loadEnv.d.ts.map

package/dist/config/loadEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadEnv.d.ts","sourceRoot":"","sources":["../../src/config/loadEnv.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,GAAG,SAAgB,GAAG,IAAI,CAWjD"}

package/dist/config/loadEnv.js

@@ -0,0 +1,25 @@
+import { config } from "dotenv";
+import { defaultPiMemoryEnvFile } from "../utils/paths.js";
+import { joinPath, pathExists } from "../utils/fs.js";
+import { readPiMemoryEnv } from "./env.js";
+/**
+ * Load pi-memory env into process.env (does not override existing vars).
+ *
+ * Search order:
+ * 1. PI_MEMORY_ENV_FILE (explicit override)
+ * 2. cwd `.env` / `.env.local` (project-local dev)
+ * 3. ~/.pi/agent/pi-memory.env (recommended)
+ */
+export function loadEnv(cwd = process.cwd()) {
+    const paths = [];
+    const explicit = readPiMemoryEnv(process.env).envFile;
+    if (explicit)
+        paths.push(explicit);
+    paths.push(joinPath(cwd, ".env"), joinPath(cwd, ".env.local"), defaultPiMemoryEnvFile());
+    for (const path of paths) {
+        if (!path || !pathExists(path))
+            continue;
+        config({ path, override: false, quiet: true });
+    }
+}
+//# sourceMappingURL=loadEnv.js.map

package/dist/config/loadEnv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadEnv.js","sourceRoot":"","sources":["../../src/config/loadEnv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;IACtD,IAAI,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEnC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,sBAAsB,EAAE,CAAC,CAAC;IAEzF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QACzC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/config/preflightBudget.d.ts

@@ -0,0 +1,9 @@
+export type PreflightBudget = {
+    totalMs: number;
+    intentMs: number;
+    sidecarMs: number;
+};
+/** Split shared preflight deadline between QueryIntent LLM and sidecar query. */
+export declare function resolvePreflightBudget(totalMs?: number): PreflightBudget;
+export { DEFAULT_PREFLIGHT_BUDGET_MS } from "../constants/timing.js";
+//# sourceMappingURL=preflightBudget.d.ts.map

package/dist/config/preflightBudget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflightBudget.d.ts","sourceRoot":"","sources":["../../src/config/preflightBudget.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAMF,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,OAAO,SAA8B,GAAG,eAAe,CAY7F;AAED,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/config/preflightBudget.js

@@ -0,0 +1,16 @@
+import { DEFAULT_PREFLIGHT_BUDGET_MS, MAX_PREFLIGHT_BUDGET_MS, MIN_PREFLIGHT_BUDGET_MS, MIN_PREFLIGHT_SIDECAR_RESERVE_MS, } from "../constants/timing.js";
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+/** Split shared preflight deadline between QueryIntent LLM and sidecar query. */
+export function resolvePreflightBudget(totalMs = DEFAULT_PREFLIGHT_BUDGET_MS) {
+    const total = clamp(totalMs, MIN_PREFLIGHT_BUDGET_MS, MAX_PREFLIGHT_BUDGET_MS);
+    const intentMs = clamp(Math.floor(total * 0.3), 100, total - MIN_PREFLIGHT_SIDECAR_RESERVE_MS);
+    return {
+        totalMs: total,
+        intentMs,
+        sidecarMs: total - intentMs,
+    };
+}
+export { DEFAULT_PREFLIGHT_BUDGET_MS } from "../constants/timing.js";
+//# sourceMappingURL=preflightBudget.js.map

package/dist/config/preflightBudget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflightBudget.js","sourceRoot":"","sources":["../../src/config/preflightBudget.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAQhC,SAAS,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,sBAAsB,CAAC,OAAO,GAAG,2BAA2B;IAC1E,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,CAAC,CAAC;IAC/E,MAAM,QAAQ,GAAG,KAAK,CACpB,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,EACvB,GAAG,EACH,KAAK,GAAG,gCAAgC,CACzC,CAAC;IACF,OAAO;QACL,OAAO,EAAE,KAAK;QACd,QAAQ;QACR,SAAS,EAAE,KAAK,GAAG,QAAQ;KAC5B,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/config/retrieval.d.ts

@@ -0,0 +1,10 @@
+export type RetrievalConfig = {
+    topK: number;
+    mmrLambda: number;
+    minRelevance: number;
+    candidatePoolMultiplier: number;
+};
+/** Vector retrieval tuning (sidecar query path). */
+export declare function readRetrievalConfig(env?: NodeJS.ProcessEnv): RetrievalConfig;
+export { DEFAULT_MIN_RELEVANCE, DEFAULT_TOP_K, MMR_LAMBDA } from "../constants/retrieval.js";
+//# sourceMappingURL=retrieval.d.ts.map

package/dist/config/retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../src/config/retrieval.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC;AAkBF,oDAAoD;AACpD,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,eAAe,CAWzF;AAED,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/config/retrieval.js

@@ -0,0 +1,31 @@
+import { CANDIDATE_POOL_MULTIPLIER, DEFAULT_MIN_RELEVANCE, DEFAULT_TOP_K, MAX_MMR_LAMBDA, MAX_TOP_K, MIN_MMR_LAMBDA, MIN_TOP_K, MMR_LAMBDA, } from "../constants/retrieval.js";
+import { ENV_KEYS } from "../constants/env.js";
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+function parseOptionalFloat(raw) {
+    if (!raw?.trim())
+        return undefined;
+    const value = Number.parseFloat(raw);
+    return Number.isFinite(value) ? value : undefined;
+}
+function parseOptionalInt(raw) {
+    if (!raw?.trim())
+        return undefined;
+    const value = Number.parseInt(raw, 10);
+    return Number.isFinite(value) ? value : undefined;
+}
+/** Vector retrieval tuning (sidecar query path). */
+export function readRetrievalConfig(env = process.env) {
+    const topKRaw = parseOptionalInt(env[ENV_KEYS.TOP_K]);
+    const mmrRaw = parseOptionalFloat(env[ENV_KEYS.MMR_LAMBDA]);
+    const minRelRaw = parseOptionalFloat(env[ENV_KEYS.MIN_RELEVANCE]);
+    return {
+        topK: clamp(topKRaw ?? DEFAULT_TOP_K, MIN_TOP_K, MAX_TOP_K),
+        mmrLambda: clamp(mmrRaw ?? MMR_LAMBDA, MIN_MMR_LAMBDA, MAX_MMR_LAMBDA),
+        minRelevance: clamp(minRelRaw ?? DEFAULT_MIN_RELEVANCE, 0, 1),
+        candidatePoolMultiplier: CANDIDATE_POOL_MULTIPLIER,
+    };
+}
+export { DEFAULT_MIN_RELEVANCE, DEFAULT_TOP_K, MMR_LAMBDA } from "../constants/retrieval.js";
+//# sourceMappingURL=retrieval.js.map

package/dist/config/retrieval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.js","sourceRoot":"","sources":["../../src/config/retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,SAAS,EACT,cAAc,EACd,SAAS,EACT,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAS/C,SAAS,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAuB;IACjD,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAuB;IAC/C,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,mBAAmB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACtE,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IAElE,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,OAAO,IAAI,aAAa,EAAE,SAAS,EAAE,SAAS,CAAC;QAC3D,SAAS,EAAE,KAAK,CAAC,MAAM,IAAI,UAAU,EAAE,cAAc,EAAE,cAAc,CAAC;QACtE,YAAY,EAAE,KAAK,CAAC,SAAS,IAAI,qBAAqB,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7D,uBAAuB,EAAE,yBAAyB;KACnD,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/consolidate/entryKey.d.ts

@@ -0,0 +1,6 @@
+/** Stable dedupe key for memory entries (section + trimmed content). */
+export declare function entryDedupeKey(entry: {
+    section: string;
+    content: string;
+}): string;
+//# sourceMappingURL=entryKey.d.ts.map

package/dist/consolidate/entryKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entryKey.d.ts","sourceRoot":"","sources":["../../src/consolidate/entryKey.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAElF"}

package/dist/consolidate/entryKey.js

@@ -0,0 +1,5 @@
+/** Stable dedupe key for memory entries (section + trimmed content). */
+export function entryDedupeKey(entry) {
+    return `${entry.section}\0${entry.content.trim()}`;
+}
+//# sourceMappingURL=entryKey.js.map

package/dist/consolidate/entryKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entryKey.js","sourceRoot":"","sources":["../../src/consolidate/entryKey.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAAC,KAA2C;IACxE,OAAO,GAAG,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;AACrD,CAAC"}

package/dist/consolidate/index.d.ts

@@ -0,0 +1,5 @@
+export { dedupeEntries } from "./mergeEntries.js";
+export { mergeEntriesWithLlm } from "./mergeWithLlm.js";
+export { runConsolidateJob, type RunConsolidateJobOptions, type RunConsolidateJobResult } from "./runJob.js";
+export { createConsolidateScheduler, startConsolidateInterval, type ConsolidateScheduler } from "./scheduler.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/consolidate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC7G,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/consolidate/index.js

@@ -0,0 +1,5 @@
+export { dedupeEntries } from "./mergeEntries.js";
+export { mergeEntriesWithLlm } from "./mergeWithLlm.js";
+export { runConsolidateJob } from "./runJob.js";
+export { createConsolidateScheduler, startConsolidateInterval } from "./scheduler.js";
+//# sourceMappingURL=index.js.map

package/dist/consolidate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/consolidate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAA+D,MAAM,aAAa,CAAC;AAC7G,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAA6B,MAAM,gBAAgB,CAAC"}

package/dist/consolidate/mergeEntries.d.ts

@@ -0,0 +1,4 @@
+import type { ParsedEntry } from "../store/types.js";
+/** Rule-based dedupe before optional LLM merge. Prefer user-authored on conflict. */
+export declare function dedupeEntries(entries: ParsedEntry[]): ParsedEntry[];
+//# sourceMappingURL=mergeEntries.d.ts.map

package/dist/consolidate/mergeEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeEntries.d.ts","sourceRoot":"","sources":["../../src/consolidate/mergeEntries.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAYnE"}

package/dist/consolidate/mergeEntries.js

@@ -0,0 +1,17 @@
+import orderBy from "lodash/orderBy.js";
+import { entryDedupeKey } from "./entryKey.js";
+import { MEMORY_SECTIONS } from "../store/types.js";
+const SECTION_RANK = new Map(MEMORY_SECTIONS.map((section, index) => [section, index]));
+/** Rule-based dedupe before optional LLM merge. Prefer user-authored on conflict. */
+export function dedupeEntries(entries) {
+    const byKey = new Map();
+    for (const entry of entries) {
+        const key = entryDedupeKey(entry);
+        const existing = byKey.get(key);
+        if (!existing || entry.userAuthored) {
+            byKey.set(key, entry);
+        }
+    }
+    return orderBy([...byKey.values()], [(entry) => SECTION_RANK.get(entry.section) ?? MEMORY_SECTIONS.length]);
+}
+//# sourceMappingURL=mergeEntries.js.map

package/dist/consolidate/mergeEntries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeEntries.js","sourceRoot":"","sources":["../../src/consolidate/mergeEntries.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,mBAAmB,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAExF,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,OAAsB;IAClD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE7C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACpC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9G,CAAC"}

package/dist/consolidate/mergePrompt.d.ts

@@ -0,0 +1,4 @@
+import type { ParsedEntry } from "../store/types.js";
+export declare function formatEntriesForConsolidation(entries: ParsedEntry[]): string;
+export declare function buildConsolidateMergePrompt(entriesMarkdown: string): string;
+//# sourceMappingURL=mergePrompt.d.ts.map

package/dist/consolidate/mergePrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergePrompt.d.ts","sourceRoot":"","sources":["../../src/consolidate/mergePrompt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAuB5E;AAED,wBAAgB,2BAA2B,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAc3E"}

package/dist/consolidate/mergePrompt.js

@@ -0,0 +1,40 @@
+import groupBy from "lodash/groupBy.js";
+import { formatEntryLine, formatSectionHeader } from "../store/markdown/format.js";
+import { MEMORY_SECTIONS } from "../store/types.js";
+export function formatEntriesForConsolidation(entries) {
+    const grouped = groupBy(entries, "section");
+    const lines = [];
+    for (const section of MEMORY_SECTIONS) {
+        const sectionEntries = grouped[section] ?? [];
+        if (sectionEntries.length === 0)
+            continue;
+        lines.push(formatSectionHeader(section), "");
+        for (const entry of sectionEntries) {
+            lines.push(formatEntryLine({
+                id: entry.id,
+                section: entry.section,
+                content: entry.content,
+                userAuthored: entry.userAuthored,
+                timestamp: entry.timestamp,
+            }));
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trim();
+}
+export function buildConsolidateMergePrompt(entriesMarkdown) {
+    return `You are consolidating a durable MEMORY.md note file for a coding agent.
+
+Merge the entries below:
+- Remove exact duplicates and near-duplicates (keep the clearer wording).
+- Remove completed or obsolete TODO items.
+- NEVER remove or rewrite lines marked [user] (user-authored).
+- Keep Preferences, Conventions, Findings, and Todos factual and concise.
+- Output ONLY valid markdown with sections: ## Preferences, ## Conventions, ## Findings, ## Todos
+- Each item is a bullet line using the same format as input (with <!-- id:... --> metadata when present).
+
+<memory>
+${entriesMarkdown}
+</memory>`;
+}
+//# sourceMappingURL=mergePrompt.js.map

package/dist/consolidate/mergePrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergePrompt.js","sourceRoot":"","sources":["../../src/consolidate/mergePrompt.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,mBAAmB,CAAC;AAGxC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,UAAU,6BAA6B,CAAC,OAAsB;IAClE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;QACtC,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAC1C,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7C,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CACR,eAAe,CAAC;gBACd,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CACH,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,eAAuB;IACjE,OAAO;;;;;;;;;;;EAWP,eAAe;UACP,CAAC;AACX,CAAC"}

package/dist/consolidate/mergeWithLlm.d.ts

@@ -0,0 +1,4 @@
+import type { LlmClient } from "../adapters/llm/types.js";
+import type { ParsedEntry } from "../store/types.js";
+export declare function mergeEntriesWithLlm(entries: ParsedEntry[], llm: LlmClient, signal?: AbortSignal): Promise<ParsedEntry[]>;
+//# sourceMappingURL=mergeWithLlm.d.ts.map

package/dist/consolidate/mergeWithLlm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeWithLlm.d.ts","sourceRoot":"","sources":["../../src/consolidate/mergeWithLlm.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAoBrD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,WAAW,EAAE,EACtB,GAAG,EAAE,SAAS,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC,CAUxB"}

package/dist/consolidate/mergeWithLlm.js

@@ -0,0 +1,27 @@
+import keyBy from "lodash/keyBy.js";
+import { parseMemoryMarkdown } from "../store/markdown/parse.js";
+import { entryDedupeKey } from "./entryKey.js";
+import { buildConsolidateMergePrompt, formatEntriesForConsolidation } from "./mergePrompt.js";
+import { dedupeEntries } from "./mergeEntries.js";
+function preserveUserAuthored(original, merged) {
+    const userByContent = keyBy(original.filter((entry) => entry.userAuthored), entryDedupeKey);
+    return merged.map((entry) => {
+        const user = userByContent[entryDedupeKey(entry)];
+        if (user) {
+            return { ...entry, id: user.id, userAuthored: true, timestamp: user.timestamp };
+        }
+        return entry;
+    });
+}
+export async function mergeEntriesWithLlm(entries, llm, signal) {
+    const deduped = dedupeEntries(entries);
+    if (deduped.length === 0)
+        return deduped;
+    const prompt = buildConsolidateMergePrompt(formatEntriesForConsolidation(deduped));
+    const raw = await llm.complete(prompt, signal);
+    const parsed = parseMemoryMarkdown(raw, "consolidate-llm");
+    if (parsed.length === 0)
+        return deduped;
+    return preserveUserAuthored(deduped, parsed);
+}
+//# sourceMappingURL=mergeWithLlm.js.map

package/dist/consolidate/mergeWithLlm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeWithLlm.js","sourceRoot":"","sources":["../../src/consolidate/mergeWithLlm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,iBAAiB,CAAC;AAGpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,SAAS,oBAAoB,CAAC,QAAuB,EAAE,MAAqB;IAC1E,MAAM,aAAa,GAAG,KAAK,CACzB,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,EAC9C,cAAc,CACf,CAAC;IAEF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;QAClD,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QAClF,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAsB,EACtB,GAAc,EACd,MAAoB;IAEpB,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAEzC,MAAM,MAAM,GAAG,2BAA2B,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC,CAAC;IACnF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAExC,OAAO,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC"}

package/dist/consolidate/runJob.d.ts

@@ -0,0 +1,29 @@
+import type { LlmClient } from "../adapters/llm/types.js";
+import type { MemoryStore } from "../store/memoryStore.js";
+export type ConsolidateJobStats = {
+    entriesBefore: number;
+    entriesAfter: number;
+    overflowBefore: number;
+    overflowAfter: number;
+    indexGeneration?: number;
+};
+export type RunConsolidateJobOptions = {
+    store: MemoryStore;
+    agentDir: string;
+    llm?: LlmClient | null;
+    cronFired?: boolean;
+    force?: boolean;
+    reindex?: boolean;
+};
+export type RunConsolidateJobResult = {
+    status: "skipped";
+    reason: "conditions_not_met" | "already_consolidating";
+} | {
+    status: "consolidated";
+    stats: ConsolidateJobStats;
+} | {
+    status: "failed";
+    error: Error;
+};
+export declare function runConsolidateJob(opts: RunConsolidateJobOptions): Promise<RunConsolidateJobResult>;
+//# sourceMappingURL=runJob.d.ts.map

package/dist/consolidate/runJob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runJob.d.ts","sourceRoot":"","sources":["../../src/consolidate/runJob.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAK1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAQ3D,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,oBAAoB,GAAG,uBAAuB,CAAA;CAAE,GAC7E;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GACtD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEvC,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAmClC"}

package/dist/consolidate/runJob.js

@@ -0,0 +1,48 @@
+import { sidecarQueryCache } from "../preflight/queryCache.js";
+import { ensureSidecarRunning } from "../sidecar/sidecarManager.js";
+import { reindex } from "../sidecar/client.js";
+import { resolveSidecarPaths } from "../sidecar/paths.js";
+const NOOP_LLM = {
+    async complete() {
+        throw new Error("LLM unavailable");
+    },
+};
+export async function runConsolidateJob(opts) {
+    const llm = opts.llm ?? NOOP_LLM;
+    if (!opts.force && !(await opts.store.shouldConsolidate(undefined, opts.cronFired))) {
+        return { status: "skipped", reason: "conditions_not_met" };
+    }
+    const before = await opts.store.getStats();
+    try {
+        await opts.store.consolidate(llm);
+        let indexGeneration;
+        if (opts.reindex !== false) {
+            indexGeneration = await syncSidecarIndex(opts.agentDir, opts.store);
+        }
+        const after = await opts.store.getStats();
+        return {
+            status: "consolidated",
+            stats: {
+                entriesBefore: before.entryCount,
+                entriesAfter: after.entryCount,
+                overflowBefore: before.overflowFileCount,
+                overflowAfter: after.overflowFileCount,
+                indexGeneration,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            status: "failed",
+            error: error instanceof Error ? error : new Error(String(error)),
+        };
+    }
+}
+async function syncSidecarIndex(agentDir, store) {
+    const sidecar = resolveSidecarPaths(agentDir);
+    await ensureSidecarRunning(sidecar);
+    const result = await reindex(sidecar.socketPath, await store.exportForIndex());
+    sidecarQueryCache.onReindexComplete(agentDir, result.index_generation);
+    return result.index_generation;
+}
+//# sourceMappingURL=runJob.js.map

package/dist/consolidate/runJob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runJob.js","sourceRoot":"","sources":["../../src/consolidate/runJob.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,MAAM,QAAQ,GAAc;IAC1B,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;CACF,CAAC;AAwBF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAA8B;IAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,QAAQ,CAAC;IAEjC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACpF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC7D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,eAAmC,CAAC;QACxC,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC3B,eAAe,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAE1C,OAAO;YACL,MAAM,EAAE,cAAc;YACtB,KAAK,EAAE;gBACL,aAAa,EAAE,MAAM,CAAC,UAAU;gBAChC,YAAY,EAAE,KAAK,CAAC,UAAU;gBAC9B,cAAc,EAAE,MAAM,CAAC,iBAAiB;gBACxC,aAAa,EAAE,KAAK,CAAC,iBAAiB;gBACtC,eAAe;aAChB;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SACjE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,QAAgB,EAAE,KAAkB;IAClE,MAAM,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC;IAC/E,iBAAiB,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACvE,OAAO,MAAM,CAAC,gBAAgB,CAAC;AACjC,CAAC"}

package/dist/consolidate/scheduler.d.ts

@@ -0,0 +1,18 @@
+import type { LlmClient } from "../adapters/llm/types.js";
+import type { MemoryStore } from "../store/memoryStore.js";
+export type ConsolidateScheduler = {
+    schedule(): void;
+    runNow(opts?: {
+        cronFired?: boolean;
+    }): Promise<void>;
+};
+export declare function createConsolidateScheduler(opts: {
+    getStore(): MemoryStore | null;
+    getAgentDir(): string | null;
+    getLlm(): LlmClient | null;
+    debounceMs?: number;
+    onComplete?(): void | Promise<void>;
+}): ConsolidateScheduler;
+/** Periodic check for the 7-day (and other time-based) consolidate conditions. */
+export declare function startConsolidateInterval(tick: () => void, intervalMs?: number): () => void;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/consolidate/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/consolidate/scheduler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,QAAQ,IAAI,WAAW,GAAG,IAAI,CAAC;IAC/B,WAAW,IAAI,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,IAAI,SAAS,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC,GAAG,oBAAoB,CAwBvB;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,IAAI,EAChB,UAAU,SAAwC,GACjD,MAAM,IAAI,CAIZ"}

package/dist/consolidate/scheduler.js

@@ -0,0 +1,32 @@
+import debounce from "lodash/debounce.js";
+import { DEFAULT_CONSOLIDATE_CHECK_INTERVAL_MS, DEFAULT_CONSOLIDATE_DEBOUNCE_MS } from "../constants/timing.js";
+import { runConsolidateJob } from "./runJob.js";
+export function createConsolidateScheduler(opts) {
+    const runNow = async (runOpts = {}) => {
+        const store = opts.getStore();
+        const agentDir = opts.getAgentDir();
+        if (!store || !agentDir)
+            return;
+        const result = await runConsolidateJob({
+            store,
+            agentDir,
+            llm: opts.getLlm(),
+            cronFired: runOpts.cronFired ?? false,
+            reindex: true,
+        });
+        if (result.status === "consolidated") {
+            await opts.onComplete?.();
+        }
+    };
+    const schedule = debounce(() => {
+        void runNow();
+    }, opts.debounceMs ?? DEFAULT_CONSOLIDATE_DEBOUNCE_MS);
+    return { schedule, runNow };
+}
+/** Periodic check for the 7-day (and other time-based) consolidate conditions. */
+export function startConsolidateInterval(tick, intervalMs = DEFAULT_CONSOLIDATE_CHECK_INTERVAL_MS) {
+    const timer = setInterval(tick, intervalMs);
+    timer.unref?.();
+    return () => clearInterval(timer);
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/consolidate/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../src/consolidate/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,oBAAoB,CAAC;AAE1C,OAAO,EAAE,qCAAqC,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAIhH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOhD,MAAM,UAAU,0BAA0B,CAAC,IAM1C;IACC,MAAM,MAAM,GAAG,KAAK,EAAE,UAAmC,EAAE,EAAiB,EAAE;QAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEhC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;YACrC,KAAK;YACL,QAAQ;YACR,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE;YAClB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;YACrC,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,EAAE;QAC7B,KAAK,MAAM,EAAE,CAAC;IAChB,CAAC,EAAE,IAAI,CAAC,UAAU,IAAI,+BAA+B,CAAC,CAAC;IAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,wBAAwB,CACtC,IAAgB,EAChB,UAAU,GAAG,qCAAqC;IAElD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5C,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAChB,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/constants/chunking.d.ts

@@ -0,0 +1,7 @@
+/** Max characters per vector chunk before splitting a Memory Entry. */
+export declare const DEFAULT_CHUNK_MAX_CHARS = 512;
+export declare const MIN_CHUNK_MAX_CHARS = 128;
+export declare const MAX_CHUNK_MAX_CHARS = 4000;
+/** Values <= 0 disable splitting (one chunk per entry, still section-prefixed). */
+export declare const CHUNKING_DISABLED_MAX_CHARS = 0;
+//# sourceMappingURL=chunking.d.ts.map

package/dist/constants/chunking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.d.ts","sourceRoot":"","sources":["../../src/constants/chunking.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,mBAAmB,OAAQ,CAAC;AAEzC,mFAAmF;AACnF,eAAO,MAAM,2BAA2B,IAAI,CAAC"}

package/dist/constants/chunking.js

@@ -0,0 +1,7 @@
+/** Max characters per vector chunk before splitting a Memory Entry. */
+export const DEFAULT_CHUNK_MAX_CHARS = 512;
+export const MIN_CHUNK_MAX_CHARS = 128;
+export const MAX_CHUNK_MAX_CHARS = 4_000;
+/** Values <= 0 disable splitting (one chunk per entry, still section-prefixed). */
+export const CHUNKING_DISABLED_MAX_CHARS = 0;
+//# sourceMappingURL=chunking.js.map

package/dist/constants/chunking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.js","sourceRoot":"","sources":["../../src/constants/chunking.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AACvC,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC,mFAAmF;AACnF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC"}

package/dist/constants/env.d.ts

@@ -0,0 +1,44 @@
+export type EmbedderProvider = "hash" | "openai" | "ollama";
+/** process.env keys (PI_MEMORY_*). */
+export declare const ENV_KEYS: {
+    readonly EMBEDDER: "PI_MEMORY_EMBEDDER";
+    readonly EMBED_DIM: "PI_MEMORY_EMBED_DIM";
+    readonly OPENAI_API_KEY: "PI_MEMORY_OPENAI_API_KEY";
+    readonly OPENAI_EMBED_MODEL: "PI_MEMORY_OPENAI_EMBED_MODEL";
+    readonly OLLAMA_BASE_URL: "PI_MEMORY_OLLAMA_BASE_URL";
+    readonly OLLAMA_EMBED_MODEL: "PI_MEMORY_OLLAMA_EMBED_MODEL";
+    readonly OLLAMA_LLM_BASE_URL: "PI_MEMORY_OLLAMA_LLM_BASE_URL";
+    readonly OLLAMA_LLM_MODEL: "PI_MEMORY_OLLAMA_LLM_MODEL";
+    readonly HELPER_MODEL: "PI_MEMORY_HELPER_MODEL";
+    readonly HELPER_API_KEY: "PI_MEMORY_HELPER_API_KEY";
+    readonly OPENAI_COMPAT_BASE_URL: "PI_MEMORY_OPENAI_COMPAT_BASE_URL";
+    readonly OPENAI_COMPAT_MODEL: "PI_MEMORY_OPENAI_COMPAT_MODEL";
+    readonly OPENAI_COMPAT_API_KEY: "PI_MEMORY_OPENAI_COMPAT_API_KEY";
+    readonly HTTP_TIMEOUT_MS: "PI_MEMORY_HTTP_TIMEOUT_MS";
+    readonly PREFLIGHT_BUDGET_MS: "PI_MEMORY_PREFLIGHT_BUDGET_MS";
+    /** @deprecated Use PI_MEMORY_PREFLIGHT_BUDGET_MS */
+    readonly PREFLIGHT_TIMEOUT_MS: "PI_MEMORY_PREFLIGHT_TIMEOUT_MS";
+    readonly REINDEX_DEBOUNCE_MS: "PI_MEMORY_REINDEX_DEBOUNCE_MS";
+    readonly CONSOLIDATE_DEBOUNCE_MS: "PI_MEMORY_CONSOLIDATE_DEBOUNCE_MS";
+    readonly TOP_K: "PI_MEMORY_TOP_K";
+    readonly MMR_LAMBDA: "PI_MEMORY_MMR_LAMBDA";
+    readonly MIN_RELEVANCE: "PI_MEMORY_MIN_RELEVANCE";
+    readonly CHUNK_MAX_CHARS: "PI_MEMORY_CHUNK_MAX_CHARS";
+    readonly AGENT_DIR: "PI_MEMORY_AGENT_DIR";
+    readonly ENV_FILE: "PI_MEMORY_ENV_FILE";
+    readonly DEBUG: "PI_MEMORY_DEBUG";
+};
+/** Fallback OPENAI_API_KEY when PI_MEMORY_OPENAI_API_KEY unset. */
+export declare const FALLBACK_OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
+export declare const DEFAULT_EMBEDDER: EmbedderProvider;
+export declare const DEFAULT_OPENAI_EMBED_MODEL = "text-embedding-3-small";
+export declare const DEFAULT_OLLAMA_BASE_URL = "http://127.0.0.1:11434";
+export declare const DEFAULT_OLLAMA_EMBED_MODEL = "nomic-embed-text";
+export declare const DEFAULT_HELPER_PROVIDER = "deepseek";
+export declare const DEFAULT_HELPER_MODEL = "deepseek-v4-flash";
+export declare const DEFAULT_HELPER_MODEL_SPEC = "deepseek/deepseek-v4-flash";
+export declare const DEFAULT_EMBED_DIM_FALLBACK = 1536;
+/** Known embedding dimensions; override with PI_MEMORY_EMBED_DIM if needed. */
+export declare const KNOWN_EMBED_DIMS: Record<string, number>;
+export declare const DEFAULT_HASH_EMBED_DIM = 768;
+//# sourceMappingURL=env.d.ts.map

package/dist/constants/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/constants/env.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,sCAAsC;AACtC,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;IAgBnB,oDAAoD;;;;;;;;;;;CAW5C,CAAC;AAEX,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,mBAAmB,CAAC;AAE5D,eAAO,MAAM,gBAAgB,EAAE,gBAAyB,CAAC;AACzD,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AACnE,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAChE,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAE7D,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAClD,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AACxD,eAAO,MAAM,yBAAyB,+BAAuD,CAAC;AAE9F,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMnD,CAAC;AAEF,eAAO,MAAM,sBAAsB,MAAM,CAAC"}

package/dist/constants/env.js

@@ -0,0 +1,49 @@
+/** process.env keys (PI_MEMORY_*). */
+export const ENV_KEYS = {
+    EMBEDDER: "PI_MEMORY_EMBEDDER",
+    EMBED_DIM: "PI_MEMORY_EMBED_DIM",
+    OPENAI_API_KEY: "PI_MEMORY_OPENAI_API_KEY",
+    OPENAI_EMBED_MODEL: "PI_MEMORY_OPENAI_EMBED_MODEL",
+    OLLAMA_BASE_URL: "PI_MEMORY_OLLAMA_BASE_URL",
+    OLLAMA_EMBED_MODEL: "PI_MEMORY_OLLAMA_EMBED_MODEL",
+    OLLAMA_LLM_BASE_URL: "PI_MEMORY_OLLAMA_LLM_BASE_URL",
+    OLLAMA_LLM_MODEL: "PI_MEMORY_OLLAMA_LLM_MODEL",
+    HELPER_MODEL: "PI_MEMORY_HELPER_MODEL",
+    HELPER_API_KEY: "PI_MEMORY_HELPER_API_KEY",
+    OPENAI_COMPAT_BASE_URL: "PI_MEMORY_OPENAI_COMPAT_BASE_URL",
+    OPENAI_COMPAT_MODEL: "PI_MEMORY_OPENAI_COMPAT_MODEL",
+    OPENAI_COMPAT_API_KEY: "PI_MEMORY_OPENAI_COMPAT_API_KEY",
+    HTTP_TIMEOUT_MS: "PI_MEMORY_HTTP_TIMEOUT_MS",
+    PREFLIGHT_BUDGET_MS: "PI_MEMORY_PREFLIGHT_BUDGET_MS",
+    /** @deprecated Use PI_MEMORY_PREFLIGHT_BUDGET_MS */
+    PREFLIGHT_TIMEOUT_MS: "PI_MEMORY_PREFLIGHT_TIMEOUT_MS",
+    REINDEX_DEBOUNCE_MS: "PI_MEMORY_REINDEX_DEBOUNCE_MS",
+    CONSOLIDATE_DEBOUNCE_MS: "PI_MEMORY_CONSOLIDATE_DEBOUNCE_MS",
+    TOP_K: "PI_MEMORY_TOP_K",
+    MMR_LAMBDA: "PI_MEMORY_MMR_LAMBDA",
+    MIN_RELEVANCE: "PI_MEMORY_MIN_RELEVANCE",
+    CHUNK_MAX_CHARS: "PI_MEMORY_CHUNK_MAX_CHARS",
+    AGENT_DIR: "PI_MEMORY_AGENT_DIR",
+    ENV_FILE: "PI_MEMORY_ENV_FILE",
+    DEBUG: "PI_MEMORY_DEBUG",
+};
+/** Fallback OPENAI_API_KEY when PI_MEMORY_OPENAI_API_KEY unset. */
+export const FALLBACK_OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
+export const DEFAULT_EMBEDDER = "hash";
+export const DEFAULT_OPENAI_EMBED_MODEL = "text-embedding-3-small";
+export const DEFAULT_OLLAMA_BASE_URL = "http://127.0.0.1:11434";
+export const DEFAULT_OLLAMA_EMBED_MODEL = "nomic-embed-text";
+export const DEFAULT_HELPER_PROVIDER = "deepseek";
+export const DEFAULT_HELPER_MODEL = "deepseek-v4-flash";
+export const DEFAULT_HELPER_MODEL_SPEC = `${DEFAULT_HELPER_PROVIDER}/${DEFAULT_HELPER_MODEL}`;
+export const DEFAULT_EMBED_DIM_FALLBACK = 1536;
+/** Known embedding dimensions; override with PI_MEMORY_EMBED_DIM if needed. */
+export const KNOWN_EMBED_DIMS = {
+    "text-embedding-3-small": 1536,
+    "text-embedding-3-large": 3072,
+    "nomic-embed-text": 768,
+    "mxbai-embed-large": 1024,
+    "all-minilm": 384,
+};
+export const DEFAULT_HASH_EMBED_DIM = 768;
+//# sourceMappingURL=env.js.map

package/dist/constants/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/constants/env.ts"],"names":[],"mappings":"AAEA,sCAAsC;AACtC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,QAAQ,EAAE,oBAAoB;IAC9B,SAAS,EAAE,qBAAqB;IAChC,cAAc,EAAE,0BAA0B;IAC1C,kBAAkB,EAAE,8BAA8B;IAClD,eAAe,EAAE,2BAA2B;IAC5C,kBAAkB,EAAE,8BAA8B;IAClD,mBAAmB,EAAE,+BAA+B;IACpD,gBAAgB,EAAE,4BAA4B;IAC9C,YAAY,EAAE,wBAAwB;IACtC,cAAc,EAAE,0BAA0B;IAC1C,sBAAsB,EAAE,kCAAkC;IAC1D,mBAAmB,EAAE,+BAA+B;IACpD,qBAAqB,EAAE,iCAAiC;IACxD,eAAe,EAAE,2BAA2B;IAC5C,mBAAmB,EAAE,+BAA+B;IACpD,oDAAoD;IACpD,oBAAoB,EAAE,gCAAgC;IACtD,mBAAmB,EAAE,+BAA+B;IACpD,uBAAuB,EAAE,mCAAmC;IAC5D,KAAK,EAAE,iBAAiB;IACxB,UAAU,EAAE,sBAAsB;IAClC,aAAa,EAAE,yBAAyB;IACxC,eAAe,EAAE,2BAA2B;IAC5C,SAAS,EAAE,qBAAqB;IAChC,QAAQ,EAAE,oBAAoB;IAC9B,KAAK,EAAE,iBAAiB;CAChB,CAAC;AAEX,mEAAmE;AACnE,MAAM,CAAC,MAAM,2BAA2B,GAAG,gBAAgB,CAAC;AAE5D,MAAM,CAAC,MAAM,gBAAgB,GAAqB,MAAM,CAAC;AACzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,wBAAwB,CAAC;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,wBAAwB,CAAC;AAChE,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC;AAE7D,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAClD,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AACxD,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,uBAAuB,IAAI,oBAAoB,EAAE,CAAC;AAE9F,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAE/C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,wBAAwB,EAAE,IAAI;IAC9B,wBAAwB,EAAE,IAAI;IAC9B,kBAAkB,EAAE,GAAG;IACvB,mBAAmB,EAAE,IAAI;IACzB,YAAY,EAAE,GAAG;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC"}