@lossless-claude/lcm 0.2.0

package/dist/src/mcp/tools/lcm-expand.d.ts

@@ -0,0 +1,18 @@
+export declare const lcmExpandTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            nodeId: {
+                type: string;
+                description: string;
+            };
+            depth: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};

package/dist/src/mcp/tools/lcm-expand.js

@@ -0,0 +1,13 @@
+export const lcmExpandTool = {
+    name: "lcm_expand",
+    description: "Decompress a summary node into its full source content by traversing the DAG. Use when a summary references something that needs more detail.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            nodeId: { type: "string", description: "Summary node ID to expand" },
+            depth: { type: "number", description: "How many levels of the DAG to traverse (default: 1)" },
+        },
+        required: ["nodeId"],
+    },
+};
+//# sourceMappingURL=lcm-expand.js.map

package/dist/src/mcp/tools/lcm-expand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lcm-expand.js","sourceRoot":"","sources":["../../../../src/mcp/tools/lcm-expand.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,+IAA+I;IAC5J,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YACpE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qDAAqD,EAAE;SAC9F;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;CACF,CAAC"}

package/dist/src/mcp/tools/lcm-grep.d.ts

@@ -0,0 +1,27 @@
+export declare const lcmGrepTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            scope: {
+                type: string;
+                enum: string[];
+                default: string;
+            };
+            sessionId: {
+                type: string;
+                description: string;
+            };
+            since: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};

package/dist/src/mcp/tools/lcm-grep.js

@@ -0,0 +1,15 @@
+export const lcmGrepTool = {
+    name: "lcm_grep",
+    description: "Search conversation history by keyword or regex across raw messages and summaries. Use when recalling what was said, decided, or done in a past session.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "Keyword, phrase, or regex to search" },
+            scope: { type: "string", enum: ["messages", "summaries", "all"], default: "all" },
+            sessionId: { type: "string", description: "Filter to a specific session" },
+            since: { type: "string", description: "ISO datetime lower bound" },
+        },
+        required: ["query"],
+    },
+};
+//# sourceMappingURL=lcm-grep.js.map

package/dist/src/mcp/tools/lcm-grep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lcm-grep.js","sourceRoot":"","sources":["../../../../src/mcp/tools/lcm-grep.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,0JAA0J;IACvK,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;YAC7E,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE;YACjF,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;YAC1E,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;SACnE;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACF,CAAC"}

package/dist/src/mcp/tools/lcm-search.d.ts

@@ -0,0 +1,33 @@
+export declare const lcmSearchTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            layers: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                description: string;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};

package/dist/src/mcp/tools/lcm-search.js

@@ -0,0 +1,15 @@
+export const lcmSearchTool = {
+    name: "lcm_search",
+    description: "Hybrid search across both episodic memory (SQLite FTS5) and semantic memory (Qdrant). Returns two separate ranked lists — episodic and semantic. Use when looking for project knowledge spanning multiple sessions.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "Natural language search query" },
+            limit: { type: "number", description: "Max results per layer (default: 5)" },
+            layers: { type: "array", items: { type: "string", enum: ["episodic", "semantic"] }, description: "Which memory layers to search (default: both)" },
+            tags: { type: "array", items: { type: "string" }, description: "Filter results to entries that include all specified tags (e.g. ['reasoning'], ['decision', 'architecture'])" },
+        },
+        required: ["query"],
+    },
+};
+//# sourceMappingURL=lcm-search.js.map

package/dist/src/mcp/tools/lcm-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lcm-search.js","sourceRoot":"","sources":["../../../../src/mcp/tools/lcm-search.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,qNAAqN;IAClO,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;YACvE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;YAC5E,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,EAAE,WAAW,EAAE,+CAA+C,EAAE;YAClJ,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,8GAA8G,EAAE;SAChL;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACF,CAAC"}

package/dist/src/mcp/tools/lcm-stats.d.ts

@@ -0,0 +1,14 @@
+export declare const lcmStatsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            verbose: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+    };
+};

package/dist/src/mcp/tools/lcm-stats.js

@@ -0,0 +1,11 @@
+export const lcmStatsTool = {
+    name: "lcm_stats",
+    description: "Show token savings, compression ratios, and usage statistics across all lossless-claude projects. Use to check how much context is being saved.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            verbose: { type: "boolean", description: "Include per-conversation breakdown", default: false },
+        },
+    },
+};
+//# sourceMappingURL=lcm-stats.js.map

package/dist/src/mcp/tools/lcm-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lcm-stats.js","sourceRoot":"","sources":["../../../../src/mcp/tools/lcm-stats.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,iJAAiJ;IAC9J,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,oCAAoC,EAAE,OAAO,EAAE,KAAK,EAAE;SAChG;KACF;CACF,CAAC"}

package/dist/src/mcp/tools/lcm-store.d.ts

@@ -0,0 +1,26 @@
+export declare const lcmStoreTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            text: {
+                type: string;
+                description: string;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            metadata: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+            };
+        };
+        required: string[];
+    };
+};

package/dist/src/mcp/tools/lcm-store.js

@@ -0,0 +1,22 @@
+export const lcmStoreTool = {
+    name: "lcm_store",
+    description: "Store a memory into lossless-claude's semantic layer. Use to persist decisions, findings, reasoning outcomes, or any knowledge worth retrieving in future sessions. Stored memories are searchable via lcm_search.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            text: { type: "string", description: "The content to store" },
+            tags: {
+                type: "array",
+                items: { type: "string" },
+                description: "Categorical tags (e.g. ['decision', 'architecture', 'bug-fix'])",
+            },
+            metadata: {
+                type: "object",
+                description: "Optional key/value metadata (e.g. projectId, sessionId, source)",
+                additionalProperties: true,
+            },
+        },
+        required: ["text"],
+    },
+};
+//# sourceMappingURL=lcm-store.js.map

package/dist/src/mcp/tools/lcm-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lcm-store.js","sourceRoot":"","sources":["../../../../src/mcp/tools/lcm-store.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,oNAAoN;IACjO,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;YAC7D,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,iEAAiE;aAC/E;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;gBAC9E,oBAAoB,EAAE,IAAI;aAC3B;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAC"}

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

@@ -0,0 +1,22 @@
+import { DaemonClient } from "../daemon/client.js";
+export type SearchResult = {
+    episodic: any[];
+    semantic: any[];
+};
+export type MemoryApi = {
+    store: (text: string, tags: string[], metadata?: Record<string, unknown>) => Promise<void>;
+    search: (query: string, options?: {
+        limit?: number;
+        threshold?: number;
+        projectId?: string;
+        layers?: ("episodic" | "semantic")[];
+    }) => Promise<SearchResult>;
+    compact: (sessionId: string, transcriptPath: string) => Promise<{
+        summary: string;
+    }>;
+    recent: (projectId: string, limit?: number) => Promise<{
+        summaries: any[];
+    }>;
+};
+export declare function createMemoryApi(client: DaemonClient): MemoryApi;
+export declare const memory: MemoryApi;

package/dist/src/memory/index.js

@@ -0,0 +1,21 @@
+import { DaemonClient } from "../daemon/client.js";
+export function createMemoryApi(client) {
+    return {
+        async store(text, tags, metadata) {
+            await client.post("/store", { text, tags, metadata });
+        },
+        async search(query, options) {
+            return client.post("/search", { query, ...options });
+        },
+        async compact(sessionId, transcriptPath) {
+            return client.post("/compact", { session_id: sessionId, transcript_path: transcriptPath });
+        },
+        async recent(projectId, limit = 5) {
+            return client.post("/recent", { projectId, limit });
+        },
+    };
+}
+// Convenience singleton with default daemon address
+const defaultClient = new DaemonClient("http://127.0.0.1:3737");
+export const memory = createMemoryApi(defaultClient);
+//# sourceMappingURL=index.js.map

package/dist/src/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAWnD,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ;YAC9B,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO;YACzB,OAAO,MAAM,CAAC,IAAI,CAAe,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc;YACrC,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,GAAG,CAAC;YAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,oDAAoD;AACpD,MAAM,aAAa,GAAG,IAAI,YAAY,CAAC,uBAAuB,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,MAAM,GAAc,eAAe,CAAC,aAAa,CAAC,CAAC"}

package/dist/src/promotion/dedup.d.ts

@@ -0,0 +1,19 @@
+import type { PromotedStore } from "../db/promoted.js";
+type DedupThresholds = {
+    dedupBm25Threshold: number;
+    mergeMaxEntries: number;
+    confidenceDecayRate: number;
+};
+type DedupParams = {
+    store: PromotedStore;
+    content: string;
+    tags: string[];
+    projectId: string;
+    sessionId?: string;
+    depth: number;
+    confidence: number;
+    summarize: (text: string) => Promise<string>;
+    thresholds: DedupThresholds;
+};
+export declare function deduplicateAndInsert(params: DedupParams): Promise<string>;
+export {};

package/dist/src/promotion/dedup.js

@@ -0,0 +1,42 @@
+import { renderTemplate } from "../prompts/loader.js";
+export async function deduplicateAndInsert(params) {
+    const { store, content, tags, projectId, sessionId, depth, confidence, summarize, thresholds } = params;
+    // Search for duplicates using FTS5
+    const candidates = store.search(content, thresholds.mergeMaxEntries);
+    // Filter to entries above BM25 threshold (rank is negative; more negative = better match)
+    const duplicates = candidates.filter((c) => c.rank <= -thresholds.dedupBm25Threshold);
+    if (duplicates.length === 0) {
+        return store.insert({ content, tags, projectId, sessionId, depth, confidence });
+    }
+    // Merge: combine all duplicate entries + new content
+    const allEntries = [...duplicates.map((d) => d.content), content];
+    const entriesText = allEntries.map((e, i) => `Entry ${i + 1}:\n${e}`).join("\n\n");
+    const mergePrompt = renderTemplate("promoted-merge", { entries: entriesText });
+    let mergedContent;
+    try {
+        mergedContent = await summarize(mergePrompt);
+    }
+    catch {
+        // Merge failed — insert as new entry rather than losing data
+        return store.insert({ content, tags, projectId, sessionId, depth, confidence });
+    }
+    if (!mergedContent.trim()) {
+        return store.insert({ content, tags, projectId, sessionId, depth, confidence });
+    }
+    // Calculate merged confidence
+    const maxConfidence = Math.max(confidence, ...duplicates.map((d) => d.confidence));
+    const mergedConfidence = Math.max(0, maxConfidence - thresholds.confidenceDecayRate);
+    // Delete old duplicates
+    for (const dup of duplicates) {
+        store.deleteById(dup.id);
+    }
+    // Archive if confidence too low — soft-delete, don't surface
+    if (mergedConfidence < 0.2) {
+        const id = store.insert({ content: mergedContent, tags, projectId, sessionId, depth, confidence: mergedConfidence });
+        store.archive(id);
+        return id;
+    }
+    // Insert merged entry
+    return store.insert({ content: mergedContent, tags, projectId, sessionId, depth, confidence: mergedConfidence });
+}
+//# sourceMappingURL=dedup.js.map

package/dist/src/promotion/dedup.js.map

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

package/dist/src/promotion/detector.d.ts

@@ -0,0 +1,15 @@
+import type { DaemonConfig } from "../daemon/config.js";
+type Thresholds = DaemonConfig["compaction"]["promotionThresholds"];
+export type PromotionInput = {
+    content: string;
+    depth: number;
+    tokenCount: number;
+    sourceMessageTokenCount: number;
+};
+export type PromotionResult = {
+    promote: boolean;
+    tags: string[];
+    confidence: number;
+};
+export declare function shouldPromote(input: PromotionInput, thresholds: Thresholds): PromotionResult;
+export {};

package/dist/src/promotion/detector.js

@@ -0,0 +1,31 @@
+export function shouldPromote(input, thresholds) {
+    const tags = [];
+    const { content, depth, tokenCount, sourceMessageTokenCount } = input;
+    const lower = content.toLowerCase();
+    // Keyword signals
+    for (const [category, keywords] of Object.entries(thresholds.keywords)) {
+        if (keywords.some((kw) => lower.includes(kw.toLowerCase())))
+            tags.push(category);
+    }
+    // Architecture pattern signals
+    for (const pattern of thresholds.architecturePatterns) {
+        if (new RegExp(pattern).test(content)) {
+            tags.push("architecture");
+            break;
+        }
+    }
+    // Depth signal
+    if (depth >= thresholds.minDepth)
+        tags.push("depth");
+    // Compression ratio signal
+    if (sourceMessageTokenCount > 0 && tokenCount / sourceMessageTokenCount < thresholds.compressionRatio) {
+        tags.push("compressed");
+    }
+    const signals = new Set(tags);
+    return {
+        promote: signals.size > 0,
+        tags: [...signals],
+        confidence: Math.min(signals.size / 4, 1),
+    };
+}
+//# sourceMappingURL=detector.js.map

package/dist/src/promotion/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../../src/promotion/detector.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,aAAa,CAAC,KAAqB,EAAE,UAAsB;IACzE,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,GAAG,KAAK,CAAC;IACtE,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEpC,kBAAkB;IAClB,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnF,CAAC;IAED,+BAA+B;IAC/B,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,oBAAoB,EAAE,CAAC;QACtD,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAAC,MAAM;QAAC,CAAC;IAC9E,CAAC;IAED,eAAe;IACf,IAAI,KAAK,IAAI,UAAU,CAAC,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAErD,2BAA2B;IAC3B,IAAI,uBAAuB,GAAG,CAAC,IAAI,UAAU,GAAG,uBAAuB,GAAG,UAAU,CAAC,gBAAgB,EAAE,CAAC;QACtG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,IAAI,GAAG,CAAC;QACzB,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;QAClB,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/src/prompts/condensed-d1.yaml

@@ -0,0 +1,38 @@
+name: condensed-d1
+description: Condensed depth-1 summarization — compacts leaf-level summaries into a single session memory node
+variables:
+  - targetTokens
+  - text
+  - previousContextBlock
+  - instructionBlock
+template: |-
+  You are compacting leaf-level conversation summaries into a single condensed memory node.
+  You are preparing context for a fresh model instance that will continue this conversation.
+
+  {{instructionBlock}}
+
+  {{previousContextBlock}}
+
+  Preserve:
+  - Decisions made and their rationale when rationale matters going forward.
+  - Earlier decisions that were superseded, and what replaced them.
+  - Completed tasks/topics with outcomes.
+  - In-progress items with current state and what remains.
+  - Blockers, open questions, and unresolved tensions.
+  - Specific references (names, paths, URLs, identifiers) needed for continuation.
+
+  Drop low-value detail:
+  - Context that has not changed from previous_context.
+  - Intermediate dead ends where the conclusion is already known.
+  - Transient states that are already resolved.
+  - Tool-internal mechanics and process scaffolding.
+
+  Use plain text. No mandatory structure.
+  Include a timeline with timestamps (hour or half-hour) for significant events.
+  Present information chronologically and mark superseded decisions.
+  End with exactly: "Expand for details about: <comma-separated list of what was dropped or compressed>".
+  Target length: about {{targetTokens}} tokens.
+
+  <conversation_to_condense>
+  {{text}}
+  </conversation_to_condense>

package/dist/src/prompts/condensed-d2.yaml

@@ -0,0 +1,32 @@
+name: condensed-d2
+description: Condensed depth-2 summarization — condenses session-level summaries into a higher-level memory node
+variables:
+  - targetTokens
+  - text
+  - instructionBlock
+template: |-
+  You are condensing multiple session-level summaries into a higher-level memory node.
+  A future model should understand trajectory, not per-session minutiae.
+
+  {{instructionBlock}}
+
+  Preserve:
+  - Decisions still in effect and their rationale.
+  - Decisions that evolved: what changed and why.
+  - Completed work with outcomes.
+  - Active constraints, limitations, and known issues.
+  - Current state of in-progress work.
+
+  Drop:
+  - Session-local operational detail and process mechanics.
+  - Identifiers that are no longer relevant.
+  - Intermediate states superseded by later outcomes.
+
+  Use plain text. Brief headers are fine if useful.
+  Include a timeline with dates and approximate time of day for key milestones.
+  End with exactly: "Expand for details about: <comma-separated list of what was dropped or compressed>".
+  Target length: about {{targetTokens}} tokens.
+
+  <conversation_to_condense>
+  {{text}}
+  </conversation_to_condense>

package/dist/src/prompts/condensed-d3plus.yaml

@@ -0,0 +1,32 @@
+name: condensed-d3plus
+description: Condensed depth-3+ summarization — creates a high-level durable memory node from phase-level summaries
+variables:
+  - targetTokens
+  - text
+  - instructionBlock
+template: |-
+  You are creating a high-level memory node from multiple phase-level summaries.
+  This may persist for the rest of the conversation. Keep only durable context.
+
+  {{instructionBlock}}
+
+  Preserve:
+  - Key decisions and rationale.
+  - What was accomplished and current state.
+  - Active constraints and hard limitations.
+  - Important relationships between people, systems, or concepts.
+  - Durable lessons learned.
+
+  Drop:
+  - Operational and process detail.
+  - Method details unless the method itself was the decision.
+  - Specific references unless essential for continuation.
+
+  Use plain text. Be concise.
+  Include a brief timeline with dates (or date ranges) for major milestones.
+  End with exactly: "Expand for details about: <comma-separated list of what was dropped or compressed>".
+  Target length: about {{targetTokens}} tokens.
+
+  <conversation_to_condense>
+  {{text}}
+  </conversation_to_condense>

package/dist/src/prompts/leaf-aggressive.yaml

@@ -0,0 +1,34 @@
+name: leaf-aggressive
+description: Aggressive leaf segment summarization prompt — keeps only highest-value facts for fast compaction convergence
+variables:
+  - targetTokens
+  - text
+  - previousContext
+  - instructionBlock
+template: |-
+  You summarize a SEGMENT of a Claude Code conversation for future model turns.
+  Treat this as incremental memory compaction input, not a full-conversation summary.
+
+  Aggressive summary policy:
+  - Keep only durable facts and current task state.
+  - Remove examples, repetition, and low-value narrative details.
+  - Preserve explicit TODOs, blockers, decisions, and constraints.
+
+  {{instructionBlock}}
+
+  Output requirements:
+  - Plain text only.
+  - No preamble, headings, or markdown formatting.
+  - Keep it concise while preserving required details.
+  - Track file operations (created, modified, deleted, renamed) with file paths and current status.
+  - If no file operations appear, include exactly: "Files: none".
+  - End with exactly: "Expand for details about: <comma-separated list of what was dropped or compressed>".
+  - Target length: about {{targetTokens}} tokens or less.
+
+  <previous_context>
+  {{previousContext}}
+  </previous_context>
+
+  <conversation_segment>
+  {{text}}
+  </conversation_segment>

package/dist/src/prompts/leaf-normal.yaml

@@ -0,0 +1,34 @@
+name: leaf-normal
+description: Normal leaf segment summarization prompt — preserves details for incremental memory compaction
+variables:
+  - targetTokens
+  - text
+  - previousContext
+  - instructionBlock
+template: |-
+  You summarize a SEGMENT of a Claude Code conversation for future model turns.
+  Treat this as incremental memory compaction input, not a full-conversation summary.
+
+  Normal summary policy:
+  - Preserve key decisions, rationale, constraints, and active tasks.
+  - Keep essential technical details needed to continue work safely.
+  - Remove obvious repetition and conversational filler.
+
+  {{instructionBlock}}
+
+  Output requirements:
+  - Plain text only.
+  - No preamble, headings, or markdown formatting.
+  - Keep it concise while preserving required details.
+  - Track file operations (created, modified, deleted, renamed) with file paths and current status.
+  - If no file operations appear, include exactly: "Files: none".
+  - End with exactly: "Expand for details about: <comma-separated list of what was dropped or compressed>".
+  - Target length: about {{targetTokens}} tokens or less.
+
+  <previous_context>
+  {{previousContext}}
+  </previous_context>
+
+  <conversation_segment>
+  {{text}}
+  </conversation_segment>

package/dist/src/prompts/loader.d.ts

@@ -0,0 +1,9 @@
+export type PromptTemplate = {
+    name: string;
+    description: string;
+    variables: string[];
+    template: string;
+};
+export declare function loadTemplate(name: string): PromptTemplate;
+export declare function interpolate(template: string, vars: Record<string, string>): string;
+export declare function renderTemplate(name: string, vars: Record<string, string>): string;

package/dist/src/prompts/loader.js

@@ -0,0 +1,37 @@
+import { readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import yaml from "js-yaml";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const cache = new Map();
+export function loadTemplate(name) {
+    if (name.includes("/") || name.includes("..") || name.includes("\0")) {
+        throw new Error(`Invalid template name: ${name}`);
+    }
+    const cached = cache.get(name);
+    if (cached)
+        return cached;
+    const filePath = join(__dirname, `${name}.yaml`);
+    let raw;
+    try {
+        raw = readFileSync(filePath, "utf-8");
+    }
+    catch {
+        throw new Error(`Prompt template not found: ${name} (looked at ${filePath})`);
+    }
+    const parsed = yaml.load(raw);
+    if (!parsed || typeof parsed.template !== "string") {
+        throw new Error(`Invalid prompt template: ${name} — missing 'template' field`);
+    }
+    cache.set(name, parsed);
+    return parsed;
+}
+export function interpolate(template, vars) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_, key) => vars[key] ?? "");
+}
+export function renderTemplate(name, vars) {
+    const tpl = loadTemplate(name);
+    return interpolate(tpl.template, vars);
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/prompts/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/prompts/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAStC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEhD,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IACjD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,eAAe,QAAQ,GAAG,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAmB,CAAC;IAChD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,6BAA6B,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,IAA4B;IACxE,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAA4B;IACvE,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/src/prompts/promoted-merge.yaml

@@ -0,0 +1,18 @@
+name: promoted-merge
+description: Merge overlapping promoted memory entries into one
+variables:
+  - entries
+template: |-
+  You are merging overlapping memory entries from a coding agent's long-term memory.
+  Combine them into a single entry that:
+  - Removes duplicate information
+  - Keeps the most recent state of any decision that evolved
+  - Preserves all unique facts, file paths, and identifiers
+  - Uses plain text, no headings or formatting
+  - Is concise (aim for the length of the longest input entry)
+
+  Entries to merge:
+
+  {{entries}}
+
+  Output the merged entry as plain text. Nothing else.