@chendpoc/pi-memory 0.1.12 → 0.1.13

package/dist/session/activeBranch.js

@@ -0,0 +1,251 @@
+import path from "node:path";
+function asString(value) {
+    if (typeof value === "string") {
+        const text = value.trim();
+        return text.length > 0 ? text : undefined;
+    }
+    return undefined;
+}
+function getStringField(obj, names) {
+    for (const name of names) {
+        const found = asString(obj[name]);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+function getBooleanField(obj, names) {
+    for (const name of names) {
+        if (typeof obj[name] === "boolean")
+            return obj[name];
+    }
+    return undefined;
+}
+function messageText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    const parts = [];
+    for (const block of content) {
+        if (typeof block === "string") {
+            parts.push(block);
+            continue;
+        }
+        if (block && typeof block === "object") {
+            const b = block;
+            if (typeof b.text === "string")
+                parts.push(b.text);
+            else if (typeof b.content === "string")
+                parts.push(b.content);
+        }
+    }
+    return parts.join("\n");
+}
+function extractMessage(line) {
+    if (line.message?.role && line.message.content !== undefined) {
+        return { role: line.message.role, content: line.message.content };
+    }
+    if (line.role && line.content !== undefined) {
+        return { role: line.role, content: line.content };
+    }
+    return null;
+}
+function pickActiveLeafHint(obj) {
+    const explicitByName = getStringField(obj, [
+        "activeSessionId",
+        "active_session_id",
+        "activeSession",
+        "active_session",
+        "activeLeafId",
+        "active_leaf_id",
+        "activeLeafSessionId",
+        "active_leaf_session_id",
+        "currentSessionId",
+        "current_session_id",
+        "leafSessionId",
+        "leaf_session_id",
+    ]);
+    if (explicitByName)
+        return explicitByName;
+    if (getBooleanField(obj, ["active", "is_active", "isActive", "activeLeaf"])
+        && typeof obj.id === "string") {
+        return obj.id;
+    }
+    return undefined;
+}
+function parseSessionIdFromPath(filePath) {
+    const normalized = asString(filePath);
+    if (!normalized)
+        return undefined;
+    const base = path.basename(normalized, path.extname(normalized));
+    const underscore = base.lastIndexOf("_");
+    if (underscore >= 0 && underscore < base.length - 1) {
+        return base.slice(underscore + 1);
+    }
+    return base || undefined;
+}
+export function parseJsonlSession(raw, filePath) {
+    const lines = raw.split("\n").filter((line) => line.trim());
+    if (lines.length === 0)
+        return null;
+    const parsedLines = [];
+    const nodes = new Map();
+    let headerSessionId;
+    let headerTitle = "";
+    let headerCreatedAt = "";
+    let lastNodeId;
+    let explicitLeafHint;
+    let fallbackParentSessionId;
+    let fallbackParentSessionFile;
+    for (const rawLine of lines) {
+        let obj;
+        try {
+            obj = JSON.parse(rawLine);
+        }
+        catch {
+            continue;
+        }
+        const id = getStringField(obj, ["id", "entryId", "entry_id"]);
+        const parentId = getStringField(obj, ["parentId", "parent_id"]);
+        const parentSessionId = getStringField(obj, [
+            "parentSessionId",
+            "parent_session_id",
+        ]);
+        const parentSessionFile = getStringField(obj, [
+            "parentSessionFile",
+            "parent_session_file",
+            "parentSessionPath",
+            "parent_session_path",
+            "parentSession",
+            "parent_session",
+        ]);
+        const type = asString(obj.type);
+        const message = obj.message;
+        const line = {
+            id,
+            parentId,
+            parentSessionId,
+            parentSessionFile,
+            message,
+            role: asString(obj.role),
+            content: obj.content,
+            timestamp: asString(obj.timestamp),
+            createdAt: asString(obj.createdAt),
+        };
+        const explicitLeafId = pickActiveLeafHint(obj);
+        if (explicitLeafId)
+            explicitLeafHint = explicitLeafId;
+        if (type === "session") {
+            headerSessionId = asString(obj.id) ?? headerSessionId;
+            headerTitle = asString(obj.title) ?? headerTitle;
+            headerCreatedAt = asString(obj.timestamp) ?? asString(obj.created_at) ?? asString(obj.createdAt) ?? headerCreatedAt;
+            if (!fallbackParentSessionId) {
+                fallbackParentSessionId = getStringField(obj, ["parentSessionId", "parent_session_id"]);
+            }
+            if (!fallbackParentSessionFile) {
+                fallbackParentSessionFile = getStringField(obj, [
+                    "parentSessionFile",
+                    "parent_session_file",
+                    "parentSessionPath",
+                    "parent_session_path",
+                    "parentSession",
+                    "parent_session",
+                ]);
+            }
+            if (!fallbackParentSessionId && fallbackParentSessionFile) {
+                fallbackParentSessionId = parseSessionIdFromPath(fallbackParentSessionFile);
+            }
+        }
+        if (id && type !== "session") {
+            nodes.set(id, {
+                parentId,
+                parentSessionId,
+                parentSessionFile,
+            });
+            lastNodeId = id;
+        }
+        parsedLines.push(line);
+    }
+    if (parsedLines.length === 0)
+        return null;
+    const hasBranchNodes = nodes.size > 0;
+    let activeLeafId = explicitLeafHint ?? lastNodeId;
+    if (activeLeafId && explicitLeafHint && explicitLeafHint !== lastNodeId && !nodes.has(activeLeafId)) {
+        activeLeafId = lastNodeId;
+    }
+    const activeSessionId = activeLeafId ?? headerSessionId ?? path.basename(filePath, path.extname(filePath));
+    let parentSessionId = fallbackParentSessionId;
+    let parentSessionFile = fallbackParentSessionFile;
+    const activeNodeIds = new Set();
+    if (hasBranchNodes && activeLeafId) {
+        let cursor = activeLeafId;
+        const leafNode = nodes.get(activeLeafId);
+        if (leafNode) {
+            if (leafNode.parentSessionId) {
+                parentSessionId = leafNode.parentSessionId;
+            }
+            if (leafNode.parentSessionFile) {
+                parentSessionFile = leafNode.parentSessionFile;
+            }
+            if (!parentSessionId && parentSessionFile) {
+                parentSessionId = parseSessionIdFromPath(parentSessionFile);
+            }
+        }
+        for (let i = 0; i < nodes.size + 5; i++) {
+            if (!cursor || activeNodeIds.has(cursor))
+                break;
+            activeNodeIds.add(cursor);
+            const node = nodes.get(cursor);
+            if (!node)
+                break;
+            if (!node.parentId)
+                break;
+            cursor = node.parentId;
+            if (!nodes.has(cursor))
+                break;
+        }
+    }
+    const includeLine = (line) => {
+        if (!hasBranchNodes || !activeLeafId)
+            return true;
+        if (!line.id && !line.parentId)
+            return false;
+        if (line.id)
+            return activeNodeIds.has(line.id);
+        if (line.parentId)
+            return activeNodeIds.has(line.parentId);
+        return false;
+    };
+    const turns = [];
+    let turnIndex = 0;
+    for (const line of parsedLines) {
+        if (!includeLine(line))
+            continue;
+        const messageObj = extractMessage(line);
+        if (!messageObj?.role || !messageObj.content)
+            continue;
+        if (messageObj.role !== "user" && messageObj.role !== "assistant")
+            continue;
+        const text = messageText(messageObj.content);
+        if (!text.trim())
+            continue;
+        turns.push({
+            role: messageObj.role,
+            content: text,
+            turnIndex: turnIndex++,
+        });
+    }
+    if (turns.length === 0)
+        return null;
+    return {
+        id: activeSessionId,
+        title: headerTitle,
+        createdAt: headerCreatedAt,
+        turns,
+        parentSessionId,
+        parentSessionFile,
+    };
+}
+export { messageText };
+//# sourceMappingURL=activeBranch.js.map

package/dist/session/activeBranch.js.map

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

package/dist/settings.d.ts

@@ -1,4 +1,4 @@
-import { defaultMemoryConfig, type ExtractorType, type MemoryConfig, type MemoryProvider, type TrainerConfig } from "./config.js";
+import { defaultMemoryConfig, type ExtractorType, type ConsolidationConfig, type MemoryConfig, type MemoryProvider, type TrainerConfig } from "./config.js";
 import type { OllamaConfig } from "./adapters/ollamaClient.js";
 import type { OpenAICompatConfig } from "./adapters/openaiCompatClient.js";
 export interface MemorySettingsFile {
@@ -18,6 +18,7 @@ export interface MemorySettingsFile {
     /** OpenAI-compatible endpoint config (vLLM, SGLang, LM Studio, etc.) */
     vllm?: Partial<OpenAICompatConfig>;
     trainer?: Partial<TrainerConfig>;
+    consolidation?: Partial<ConsolidationConfig>;
 }
 export interface LoadedMemorySettings {
     config: MemoryConfig;
@@ -33,6 +34,8 @@ export declare function loadMemorySettings(overrides?: Partial<MemoryConfig>, co
 /** Convenience alias when only MemoryConfig is needed. */
 export declare function loadMemoryConfig(overrides?: Partial<MemoryConfig>, configPath?: string): MemoryConfig;
 export declare function resolveHelperModelSpec(flagValue: string | boolean | undefined, settingsHelperModel: string | undefined): string | undefined;
+/** Write memory settings back to disk (preserves unknown fields). */
+export declare function saveMemorySettings(updates: Partial<MemorySettingsFile>, configPath?: string): void;
 export { defaultMemoryConfig };
-export type { ExtractorType, MemoryProvider, TrainerConfig };
+export type { ConsolidationConfig, ExtractorType, MemoryProvider, TrainerConfig, };
 //# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,mBAAmB,EAEnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,4CAA4C;AAC5C,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAoBD,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAChC,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,EACrC,UAAU,SAA4B,GACrC,oBAAoB,CAkCtB;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAC9B,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,EACrC,UAAU,SAA4B,GACrC,YAAY,CAEd;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,EACvC,mBAAmB,EAAE,MAAM,GAAG,SAAS,GACtC,MAAM,GAAG,SAAS,CAKpB;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAC/B,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,mBAAmB,EAEnB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,4CAA4C;AAC5C,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAoBD,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAChC,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,EACrC,UAAU,SAA4B,GACrC,oBAAoB,CA0CtB;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAC9B,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,EACrC,UAAU,SAA4B,GACrC,YAAY,CAEd;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,EACvC,mBAAmB,EAAE,MAAM,GAAG,SAAS,GACtC,MAAM,GAAG,SAAS,CAKpB;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,EACpC,UAAU,SAA4B,GACrC,IAAI,CAcN;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAC/B,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,aAAa,GACd,CAAC"}

package/dist/settings.js

@@ -25,10 +25,11 @@ function readMemorySettingsFile(configPath = defaultMemoryConfigPath()) {
 /** Load pi-memory config from ~/.pi/agent/memory.json. */
 export function loadMemorySettings(overrides = {}, configPath = defaultMemoryConfigPath()) {
     const fileSettings = readMemorySettingsFile(configPath);
-    const { helperModel, ollama, vllm, trainer, ...configFields } = fileSettings;
+    const { helperModel, ollama, vllm, trainer, consolidation, ...configFields } = fileSettings;
     const config = normalizeMemoryConfig({
         ...configFields,
         ...(trainer ? { trainer } : {}),
+        ...(consolidation ? { consolidation } : {}),
         ...overrides,
     });
     let resolvedOllama = null;
@@ -64,5 +65,21 @@ export function resolveHelperModelSpec(flagValue, settingsHelperModel) {
     }
     return settingsHelperModel;
 }
+/** Write memory settings back to disk (preserves unknown fields). */
+export function saveMemorySettings(updates, configPath = defaultMemoryConfigPath()) {
+    let existing = {};
+    try {
+        const raw = fs.readFileSync(configPath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            existing = parsed;
+        }
+    }
+    catch { /* start fresh */ }
+    const merged = { ...existing, ...updates };
+    const dir = path.dirname(configPath);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(configPath, JSON.stringify(merged, null, 2) + "\n", "utf8");
+}
 export { defaultMemoryConfig };
 //# sourceMappingURL=settings.js.map

package/dist/settings.js.map

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

package/dist/tools/memoryAppend.d.ts

@@ -1,8 +1,9 @@
+import type { MemoryScope } from "../consolidation/scope.js";
 import type { ToolResult } from "../types.js";
 export declare const MEMORY_APPEND_NAME = "memory_append";
 export declare const MEMORY_APPEND_DESCRIPTION: string;
-export declare const MEMORY_APPEND_PROMPT_SNIPPET = "Append durable notes to MEMORY.md";
-export declare const MEMORY_APPEND_PROMPT_GUIDELINES: readonly ["Use memory_append to persist user preferences or facts the user explicitly asked to remember — not for transient task state."];
+export declare const MEMORY_APPEND_PROMPT_SNIPPET = "Persist explicit user memory";
+export declare const MEMORY_APPEND_PROMPT_GUIDELINES: readonly ["Use memory_append only when the user explicitly asks to remember a preference or durable fact — not for transient task state."];
 export declare const MEMORY_APPEND_PARAMETERS: {
     readonly type: "object";
     readonly properties: {
@@ -14,9 +15,18 @@ export declare const MEMORY_APPEND_PARAMETERS: {
     readonly required: readonly ["content"];
 };
 export declare function appendToMemoryMd(memoryMdPath: string, content: string): Promise<void>;
+export interface Stage1AppendOptions {
+    dbPath: string;
+    sessionId?: string;
+    sessionFile?: string;
+    scope?: MemoryScope;
+    now?: string;
+}
+export declare function appendToStage1(content: string, opts: Stage1AppendOptions): Promise<string>;
 export declare class MemoryAppendTool {
     private readonly memoryMdPath;
-    constructor(memoryMdPath: string);
+    private readonly stage1?;
+    constructor(memoryMdPath: string, stage1?: Stage1AppendOptions | undefined);
     info(): {
         name: string;
         description: string;
@@ -33,5 +43,5 @@ export declare class MemoryAppendTool {
     };
     run(argsJson: string): Promise<ToolResult>;
 }
-export declare function createMemoryAppendTool(memoryMdPath: string): MemoryAppendTool;
+export declare function createMemoryAppendTool(memoryMdPath: string, stage1?: Stage1AppendOptions): MemoryAppendTool;
 //# sourceMappingURL=memoryAppend.d.ts.map

package/dist/tools/memoryAppend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memoryAppend.d.ts","sourceRoot":"","sources":["../../src/tools/memoryAppend.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,eAAO,MAAM,yBAAyB,QAEoC,CAAC;AAE3E,eAAO,MAAM,4BAA4B,sCAAsC,CAAC;AAEhF,eAAO,MAAM,+BAA+B,2IAElC,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;;;;CAU3B,CAAC;AA6BX,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,MAAM;IAEjD,IAAI;;;;;;;;;;;;;;IAQE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAwBjD;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAE7E"}
+{"version":3,"file":"memoryAppend.d.ts","sourceRoot":"","sources":["../../src/tools/memoryAppend.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,eAAO,MAAM,yBAAyB,QAE+D,CAAC;AAEtG,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAE3E,eAAO,MAAM,+BAA+B,4IAElC,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;;;;CAU3B,CAAC;AA6BX,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBADP,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,mBAAmB,YAAA;IAG/C,IAAI;;;;;;;;;;;;;;IAQE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CA4BjD;AAED,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,mBAAmB,GAC3B,gBAAgB,CAElB"}

package/dist/tools/memoryAppend.js

@@ -1,12 +1,13 @@
 import fs from "node:fs/promises";
 import { open } from "node:fs/promises";
 import path from "node:path";
+import { openConsolidationStore } from "../consolidation/stage1/store.js";
 export const MEMORY_APPEND_NAME = "memory_append";
-export const MEMORY_APPEND_DESCRIPTION = "Append new entries to MEMORY.md. Use this instead of file_write or file_edit for memory updates. " +
-    "Writes are append-only with a simple lock to avoid concurrent clobber.";
-export const MEMORY_APPEND_PROMPT_SNIPPET = "Append durable notes to MEMORY.md";
+export const MEMORY_APPEND_DESCRIPTION = "Persist durable memory only when the user explicitly asks to remember something. " +
+    "Writes go through the pi-memory consolidation stage instead of direct file edits when configured.";
+export const MEMORY_APPEND_PROMPT_SNIPPET = "Persist explicit user memory";
 export const MEMORY_APPEND_PROMPT_GUIDELINES = [
-    "Use memory_append to persist user preferences or facts the user explicitly asked to remember — not for transient task state.",
+    "Use memory_append only when the user explicitly asks to remember a preference or durable fact — not for transient task state.",
 ];
 export const MEMORY_APPEND_PARAMETERS = {
     type: "object",
@@ -54,10 +55,44 @@ export async function appendToMemoryMd(memoryMdPath, content) {
         await fs.appendFile(memoryMdPath, block, { encoding: "utf8", mode: 0o600 });
     });
 }
+export async function appendToStage1(content, opts) {
+    const trimmed = content.trim();
+    if (!trimmed)
+        throw new Error("content must not be empty");
+    const store = openConsolidationStore(opts.dbPath);
+    if (!store)
+        throw new Error("could not open consolidation store");
+    const now = opts.now ?? new Date().toISOString();
+    const sessionId = opts.sessionId
+        ? `manual_${opts.sessionId}_${Date.now()}`
+        : `manual_${Date.now()}`;
+    try {
+        store.upsertStage1Output({
+            session_id: sessionId,
+            session_file: opts.sessionFile ?? "manual-memory-append",
+            source_mtime_ms: Date.now(),
+            generated_at: now,
+            raw_memory: trimmed,
+            rollout_summary: trimmed,
+            scope: opts.scope ?? "global",
+            status: "done",
+            selected_for_phase2: false,
+            usage_count: 0,
+            last_usage: now,
+            error_message: null,
+        });
+        return sessionId;
+    }
+    finally {
+        store.close();
+    }
+}
 export class MemoryAppendTool {
     memoryMdPath;
-    constructor(memoryMdPath) {
+    stage1;
+    constructor(memoryMdPath, stage1) {
         this.memoryMdPath = memoryMdPath;
+        this.stage1 = stage1;
     }
     info() {
         return {
@@ -82,6 +117,10 @@ export class MemoryAppendTool {
             return { content: "content must not be empty", isError: true };
         }
         try {
+            if (this.stage1) {
+                const id = await appendToStage1(content, this.stage1);
+                return { content: `queued memory for consolidation: ${id}` };
+            }
             await appendToMemoryMd(this.memoryMdPath, content);
             return { content: `appended to ${this.memoryMdPath}` };
         }
@@ -93,7 +132,7 @@ export class MemoryAppendTool {
         }
     }
 }
-export function createMemoryAppendTool(memoryMdPath) {
-    return new MemoryAppendTool(memoryMdPath);
+export function createMemoryAppendTool(memoryMdPath, stage1) {
+    return new MemoryAppendTool(memoryMdPath, stage1);
 }
 //# sourceMappingURL=memoryAppend.js.map

package/dist/tools/memoryAppend.js.map

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

package/dist/tools/memoryRecall.d.ts

@@ -102,8 +102,8 @@ export declare class MemoryRecallTool {
             readonly required: readonly ["anchor_mentions"];
         };
     };
-    run(argsJson: string, signal?: AbortSignal): Promise<ToolResult>;
-    runIntent(intent: QueryIntent, signal?: AbortSignal): Promise<ToolResult>;
+    run(argsJson: string, signal?: AbortSignal, onProgress?: (msg: string) => void): Promise<ToolResult>;
+    runIntent(intent: QueryIntent, signal?: AbortSignal, onProgress?: (msg: string) => void): Promise<ToolResult>;
     private fallbackResult;
 }
 /** @deprecated Use createFallbackQuery — kept for backward-compatible imports. */

package/dist/tools/memoryRecall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memoryRecall.d.ts","sourceRoot":"","sources":["../../src/tools/memoryRecall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAiB,KAAK,aAAa,EAAqB,MAAM,0BAA0B,CAAC;AAEhG,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAoB,WAAW,EAA+B,UAAU,EAAE,MAAM,aAAa,CAAC;AAExI,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,eAAO,MAAM,yBAAyB,QAM8E,CAAC;AAErH,eAAO,MAAM,4BAA4B,0DACgB,CAAC;AAE1D,eAAO,MAAM,+BAA+B,yPAGlC,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiB3B,CAAC;AAEX,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAFV,OAAO,EAAE,aAAa,EACtB,QAAQ,GAAE,aAAa,GAAG,IAAW,EACrC,UAAU,GAAE,aAAa,GAAG,IAAW;IAG1D,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAehE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;YA6BjE,cAAc;CAmF7B;AAmKD,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EAAE,EACvB,WAAW,SAAK,GACf,aAAa,CAEf;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,aAAa,GAAG,IAAI,EAC9B,UAAU,CAAC,EAAE,aAAa,GAAG,IAAI,GAChC,gBAAgB,CAElB"}
+{"version":3,"file":"memoryRecall.d.ts","sourceRoot":"","sources":["../../src/tools/memoryRecall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAiB,KAAK,aAAa,EAAqB,MAAM,0BAA0B,CAAC;AAEhG,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAoB,WAAW,EAA+B,UAAU,EAAE,MAAM,aAAa,CAAC;AAExI,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,eAAO,MAAM,yBAAyB,QAM8E,CAAC;AAErH,eAAO,MAAM,4BAA4B,0DACgB,CAAC;AAE1D,eAAO,MAAM,+BAA+B,yPAGlC,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiB3B,CAAC;AAEX,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAFV,OAAO,EAAE,aAAa,EACtB,QAAQ,GAAE,aAAa,GAAG,IAAW,EACrC,UAAU,GAAE,aAAa,GAAG,IAAW;IAG1D,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAepG,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;YAqDrG,cAAc;CAmF7B;AAmKD,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EAAE,EACvB,WAAW,SAAK,GACf,aAAa,CAEf;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,aAAa,GAAG,IAAI,EAC9B,UAAU,CAAC,EAAE,aAAa,GAAG,IAAI,GAChC,gBAAgB,CAElB"}

package/dist/tools/memoryRecall.js

@@ -46,7 +46,7 @@ export class MemoryRecallTool {
             parameters: MEMORY_RECALL_PARAMETERS,
         };
     }
-    async run(argsJson, signal) {
+    async run(argsJson, signal, onProgress) {
         const args = parseArgs(argsJson);
         if ("error" in args) {
             return { content: args.error, isError: true };
@@ -56,24 +56,50 @@ export class MemoryRecallTool {
         if (validation) {
             return { content: validation, isError: true };
         }
-        return this.runIntent(intent, signal);
+        return this.runIntent(intent, signal, onProgress);
     }
-    async runIntent(intent, signal) {
+    async runIntent(intent, signal, onProgress) {
         if (this.service.status() !== "ready") {
             return this.fallbackResult(intent, "service_unavailable", "fallback");
         }
-        let result = await this.service.query(intent, signal);
+        // Emit a progress message if the sidecar takes longer than 500 ms.
+        let progressTimer = null;
+        if (onProgress) {
+            progressTimer = setTimeout(() => {
+                onProgress("Querying episodic memory…");
+            }, 500);
+        }
+        let result;
+        try {
+            result = await this.service.query(intent, signal);
+        }
+        finally {
+            if (progressTimer != null)
+                clearTimeout(progressTimer);
+        }
         if (result.transportError || result.errorClass === "unavailable") {
             return this.fallbackResult(intent, "service_unavailable", "fallback");
         }
         if (result.errorClass === "retryable") {
-            await sleep(500, signal);
-            result = await this.service.query(intent, signal);
-            if (result.transportError ||
-                result.errorClass === "unavailable" ||
-                result.errorClass === "retryable") {
+            let retryTimer = null;
+            if (onProgress) {
+                retryTimer = setTimeout(() => onProgress("Retrying memory query…"), 500);
+            }
+            let retryResult;
+            try {
+                await sleep(500, signal);
+                retryResult = await this.service.query(intent, signal);
+            }
+            finally {
+                if (retryTimer != null)
+                    clearTimeout(retryTimer);
+            }
+            if (retryResult.transportError ||
+                retryResult.errorClass === "unavailable" ||
+                retryResult.errorClass === "retryable") {
                 return this.fallbackResult(intent, "retryable_failed", "fallback_after_retry");
             }
+            result = retryResult;
         }
         if (result.errorClass === "permanent") {
             return permanentResult(result.env);