@agntk/core 0.1.0

package/dist/memory/engine.js

@@ -0,0 +1,227 @@
+/**
+ * @agntk/core - Unified Memory Engine
+ *
+ * Single write path: remember() → LLM extraction → parallel writes to Vectra + Graph.
+ * Implements Mem0 ADD/UPDATE/DELETE/NOOP pattern with Hindsight 4-network taxonomy.
+ *
+ * Architecture:
+ * - VectorStore: Semantic similarity search (Vectra)
+ * - GraphStore: Structural relationships (Graphology via QueryPort)
+ * - ExtractionModel: LLM-powered fact extraction
+ * - ContradictionDetector: Write-time conflict detection
+ */
+import { createLogger } from '@agntk/logger';
+import { extractFacts, } from './extraction.js';
+const log = createLogger('@agntk/core:memory-engine');
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Create a unified memory engine.
+ *
+ * @example
+ * ```typescript
+ * const engine = createMemoryEngine({
+ *   vectorStore: await createMemoryStore({ path: './.memory' }),
+ *   graphStore: new GraphologyAdapter(),
+ *   extractionModel: openai('gpt-4o-mini'),
+ * });
+ *
+ * // Single remember() does extraction + parallel writes
+ * const result = await engine.remember('TypeScript 5.3 supports import attributes');
+ * ```
+ */
+export function createMemoryEngine(config) {
+    const { vectorStore, graphStore, extractionModel, contradictionDetector, defaultTopK = 5, defaultThreshold = 0.7, } = config;
+    return {
+        async remember(text, metadata) {
+            const writeId = generateWriteId();
+            const timestamp = new Date().toISOString();
+            log.debug('remember() — unified write path', { writeId, textLength: text.length });
+            // Step 1: Extract facts via LLM (if model provided)
+            let facts = [];
+            if (extractionModel) {
+                try {
+                    const done = log.time('extraction');
+                    const result = await extractFacts(text, { model: extractionModel });
+                    facts = result.facts;
+                    done();
+                    log.info('Extraction complete', { factCount: facts.length });
+                }
+                catch (error) {
+                    log.warn('Extraction failed, continuing with raw text', { error: String(error) });
+                }
+            }
+            // Step 2: Check for contradictions against existing memories
+            let contradictionResult;
+            if (contradictionDetector && facts.length > 0) {
+                try {
+                    contradictionResult = await detectContradictions(facts, vectorStore, contradictionDetector, graphStore, defaultTopK, defaultThreshold);
+                }
+                catch (error) {
+                    log.warn('Contradiction detection failed, continuing', { error: String(error) });
+                }
+            }
+            // Step 3: Determine operation type
+            const operation = contradictionResult ? 'UPDATE' : 'ADD';
+            // Step 4: Parallel writes to vector store + graph store
+            const writePromises = [];
+            let vectorStoreId;
+            let graphStoreId;
+            // Vector store: store the raw text + extracted facts as metadata
+            writePromises.push(vectorStore.remember(text, {
+                ...metadata,
+                writeId,
+                timestamp,
+                operation,
+                networks: facts.map((f) => f.network),
+                factCount: facts.length,
+                facts: facts.map((f) => f.fact),
+            }).then((id) => { vectorStoreId = id; }));
+            // Graph store: create episode + link entities
+            if (graphStore && facts.length > 0) {
+                const episodeType = classifyEpisodeType(facts);
+                const entityNames = [...new Set(facts.flatMap((f) => f.entities.map((e) => e.name)))];
+                const relationshipStrings = facts.flatMap((f) => f.relationships.map((r) => `${r.from}-[${r.type}]->${r.to}`));
+                writePromises.push((async () => {
+                    await graphStore.upsertEpisode({
+                        id: writeId,
+                        timestamp,
+                        type: episodeType,
+                        summary: facts.map((f) => f.fact).join('; '),
+                        content: text,
+                        entities: entityNames,
+                        relationships: relationshipStrings,
+                    });
+                    graphStoreId = writeId;
+                    // Link entities to the episode
+                    for (const entityName of entityNames) {
+                        await graphStore.linkEpisodeEntity(writeId, entityName);
+                    }
+                })());
+            }
+            await Promise.all(writePromises);
+            log.info('Unified write complete', {
+                writeId,
+                operation,
+                factCount: facts.length,
+                vectorStoreId,
+                graphStoreId,
+                hasContradiction: !!contradictionResult,
+            });
+            return {
+                id: writeId,
+                operation,
+                facts,
+                vectorStoreId,
+                graphStoreId,
+                contradiction: contradictionResult,
+            };
+        },
+        async recall(query, options) {
+            return vectorStore.recall(query, {
+                topK: options?.topK ?? defaultTopK,
+                threshold: options?.threshold ?? defaultThreshold,
+            });
+        },
+        async queryKnowledge(query, limit = 10) {
+            if (!graphStore) {
+                log.debug('queryKnowledge called without graph store — returning empty');
+                return [];
+            }
+            const episodes = await graphStore.getEpisodesByQuery(query, limit);
+            return episodes.map((ep) => ({
+                id: ep.id ?? ep.properties?.id,
+                summary: ep.summary ?? ep.properties?.summary,
+                content: ep.content ?? ep.properties?.content,
+                timestamp: ep.timestamp ?? ep.properties?.timestamp,
+                type: ep.type ?? ep.properties?.type,
+            }));
+        },
+        async forget(id) {
+            return vectorStore.forget(id);
+        },
+        async count() {
+            return vectorStore.count();
+        },
+        async close() {
+            await vectorStore.close();
+        },
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function generateWriteId() {
+    return `mem_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
+/**
+ * Classify the episode type based on the dominant memory network.
+ */
+function classifyEpisodeType(facts) {
+    const counts = {
+        world_fact: 0,
+        experience: 0,
+        entity_summary: 0,
+        belief: 0,
+    };
+    for (const fact of facts) {
+        counts[fact.network]++;
+    }
+    // Map network types to episode types
+    if (counts.experience > 0)
+        return 'action';
+    if (counts.belief > 0)
+        return 'decision';
+    if (counts.entity_summary > counts.world_fact)
+        return 'observation';
+    return 'learning';
+}
+/**
+ * Check new facts against existing memories for contradictions.
+ */
+async function detectContradictions(newFacts, vectorStore, detector, graphStore, topK, threshold) {
+    // For each new world_fact or belief, check against similar existing memories
+    const checkableFacts = newFacts.filter((f) => f.network === 'world_fact' || f.network === 'belief');
+    for (const newFact of checkableFacts) {
+        const existing = await vectorStore.recall(newFact.fact, { topK, threshold });
+        for (const match of existing) {
+            const contradiction = detector.detect(match.item.text, newFact.fact, { id: match.item.id, source: 'memory', timestamp: match.item.timestamp.toISOString() }, { id: 'new', source: 'input', timestamp: new Date().toISOString() });
+            if (contradiction) {
+                log.info('Contradiction detected', {
+                    existing: match.item.text.slice(0, 80),
+                    new: newFact.fact.slice(0, 80),
+                });
+                // Store the contradiction in graph store if available
+                if (graphStore) {
+                    try {
+                        await graphStore.upsertContradiction({
+                            id: contradiction.id,
+                            detectedAt: contradiction.detectedAt,
+                            resolution_winner: null,
+                            resolution_reasoning: null,
+                            factA_id: match.item.id,
+                            factA_statement: match.item.text,
+                            factA_source: 'memory',
+                            factA_timestamp: match.item.timestamp.toISOString(),
+                            factB_id: 'new',
+                            factB_statement: newFact.fact,
+                            factB_source: 'input',
+                            factB_timestamp: new Date().toISOString(),
+                        });
+                    }
+                    catch (error) {
+                        log.warn('Failed to store contradiction in graph', { error: String(error) });
+                    }
+                }
+                return {
+                    id: contradiction.id,
+                    existingFact: match.item.text,
+                    newFact: newFact.fact,
+                };
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=engine.js.map

package/dist/memory/engine.js.map

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

package/dist/memory/extraction.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @agntk/core - Memory Extraction Pipeline
+ *
+ * LLM-powered extraction for the markdown-based memory system.
+ * The LLM receives current memory.md + new input and returns updated memory.md.
+ * No vector store, no embeddings — the LLM handles curation, dedup, and contradiction detection.
+ */
+import { type LanguageModel } from 'ai';
+/** Hindsight 4-network memory taxonomy (used as section headers in memory.md) */
+export type MemoryNetworkType = 'world_fact' | 'experience' | 'entity_summary' | 'belief';
+export declare const EMPTY_MEMORY_MD = "# Memory\n\n## World Facts\n\n## Decisions\n\n## Entity Knowledge\n\n## Preferences & Patterns\n";
+/**
+ * Send current memory + new input to LLM, get back updated memory.md content.
+ */
+export declare function extractAndUpdateMemory(currentMemory: string | null, input: string, model: LanguageModel): Promise<string>;
+/**
+ * Send current memory + fact to forget to LLM, get back updated memory.md content.
+ */
+export declare function forgetFromMemory(currentMemory: string | null, factToForget: string, model: LanguageModel): Promise<string>;
+/**
+ * Generate a formatted decision log entry from a decision description.
+ */
+export declare function generateDecisionEntry(input: string, model: LanguageModel): Promise<string>;
+//# sourceMappingURL=extraction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.d.ts","sourceRoot":"","sources":["../../src/memory/extraction.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AAStD,iFAAiF;AACjF,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,YAAY,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAsD1F,eAAO,MAAM,eAAe,qGAS3B,CAAC;AAMF;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,MAAM,CAAC,CAcjB"}

package/dist/memory/extraction.js

@@ -0,0 +1,130 @@
+/**
+ * @agntk/core - Memory Extraction Pipeline
+ *
+ * LLM-powered extraction for the markdown-based memory system.
+ * The LLM receives current memory.md + new input and returns updated memory.md.
+ * No vector store, no embeddings — the LLM handles curation, dedup, and contradiction detection.
+ */
+import { generateText } from 'ai';
+import { createLogger } from '@agntk/logger';
+const log = createLogger('@agntk/core:extraction');
+// ============================================================================
+// Prompts
+// ============================================================================
+const MEMORY_UPDATE_PROMPT = `You are a memory manager. Given the input and the current contents of memory.md, determine what to update.
+
+CURRENT MEMORY.MD:
+{CURRENT_MEMORY}
+
+INPUT TO PROCESS:
+"{INPUT}"
+
+Respond with the updated memory.md contents. Rules:
+- Add new facts under the appropriate section (World Facts, Decisions, Entity Knowledge, Preferences & Patterns)
+- If a new fact contradicts an existing one, REPLACE the old fact
+- If the fact is already captured, skip it
+- Keep each section concise — facts as bullet points, one line each
+- Remove facts that are no longer true
+- Maximum ~200 lines total
+- Always include all 4 section headers, even if a section is empty
+
+Respond ONLY with the updated memory.md content. No explanations.`;
+const MEMORY_FORGET_PROMPT = `You are a memory manager. Remove the specified fact from the current memory.md contents.
+
+CURRENT MEMORY.MD:
+{CURRENT_MEMORY}
+
+FACT TO REMOVE:
+"{INPUT}"
+
+Remove the fact (or the closest matching fact) from memory.md. If the fact is not found, return the contents unchanged.
+
+Respond ONLY with the updated memory.md content. No explanations.`;
+const DECISION_ENTRY_PROMPT = `You are a decision logger. A decision was just made. Write a concise log entry in this exact format:
+
+## {DATE} — [Decision Title]
+**Context:** [Why this came up]
+**Decision:** [What was decided]
+**Rationale:** [Why this choice]
+**Alternatives considered:** [What else was considered, if any]
+
+The decision:
+"{INPUT}"
+
+Respond ONLY with the formatted decision entry. No explanations.`;
+// ============================================================================
+// Empty memory template
+// ============================================================================
+export const EMPTY_MEMORY_MD = `# Memory
+
+## World Facts
+
+## Decisions
+
+## Entity Knowledge
+
+## Preferences & Patterns
+`;
+// ============================================================================
+// Extraction Functions
+// ============================================================================
+/**
+ * Send current memory + new input to LLM, get back updated memory.md content.
+ */
+export async function extractAndUpdateMemory(currentMemory, input, model) {
+    const memory = currentMemory?.trim() || EMPTY_MEMORY_MD;
+    const prompt = MEMORY_UPDATE_PROMPT
+        .replace('{CURRENT_MEMORY}', memory)
+        .replace('{INPUT}', input.replace(/"/g, '\\"'));
+    log.debug('Extracting memory update', { inputLength: input.length, memoryLength: memory.length });
+    try {
+        const { text } = await generateText({ model, prompt, temperature: 0.1 });
+        const result = text.trim();
+        if (!result) {
+            log.warn('Empty extraction result, returning current memory');
+            return memory;
+        }
+        log.debug('Memory updated', { oldLength: memory.length, newLength: result.length });
+        return result;
+    }
+    catch (error) {
+        log.error('Memory extraction failed', { error: error instanceof Error ? error.message : String(error) });
+        return memory;
+    }
+}
+/**
+ * Send current memory + fact to forget to LLM, get back updated memory.md content.
+ */
+export async function forgetFromMemory(currentMemory, factToForget, model) {
+    const memory = currentMemory?.trim() || EMPTY_MEMORY_MD;
+    const prompt = MEMORY_FORGET_PROMPT
+        .replace('{CURRENT_MEMORY}', memory)
+        .replace('{INPUT}', factToForget.replace(/"/g, '\\"'));
+    try {
+        const { text } = await generateText({ model, prompt, temperature: 0.1 });
+        return text.trim() || memory;
+    }
+    catch (error) {
+        log.error('Memory forget failed', { error: error instanceof Error ? error.message : String(error) });
+        return memory;
+    }
+}
+/**
+ * Generate a formatted decision log entry from a decision description.
+ */
+export async function generateDecisionEntry(input, model) {
+    const date = new Date().toISOString().split('T')[0];
+    const prompt = DECISION_ENTRY_PROMPT
+        .replace('{DATE}', date)
+        .replace('{INPUT}', input.replace(/"/g, '\\"'));
+    try {
+        const { text } = await generateText({ model, prompt, temperature: 0.2 });
+        return text.trim();
+    }
+    catch (error) {
+        log.error('Decision entry generation failed', { error: error instanceof Error ? error.message : String(error) });
+        // Fallback: simple entry
+        return `## ${date} — Decision\n**Decision:** ${input}`;
+    }
+}
+//# sourceMappingURL=extraction.js.map

package/dist/memory/extraction.js.map

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

package/dist/memory/loader.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @agntk/core - Memory Loader
+ *
+ * Loads memory files from a MemoryStore and formats them as a string
+ * for injection into the agent's system prompt.
+ *
+ * Load order (from PLAN.md):
+ *   1. ~/.agntk/identity.md
+ *   2. ~/.agntk/preferences.md
+ *   3. .agntk/project.md (or CLAUDE.md / AGENTS.md)
+ *   4. .agntk/memory.md
+ *   5. .agntk/context.md
+ */
+import type { MemoryStore } from './types.js';
+/**
+ * Load all always-on memory files and format as a system prompt section.
+ * Missing files are silently skipped.
+ */
+export declare function loadMemoryContext(store: MemoryStore): Promise<string>;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/memory/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAQ3C;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAwD3E"}

package/dist/memory/loader.js

@@ -0,0 +1,73 @@
+/**
+ * @agntk/core - Memory Loader
+ *
+ * Loads memory files from a MemoryStore and formats them as a string
+ * for injection into the agent's system prompt.
+ *
+ * Load order (from PLAN.md):
+ *   1. ~/.agntk/identity.md
+ *   2. ~/.agntk/preferences.md
+ *   3. .agntk/project.md (or CLAUDE.md / AGENTS.md)
+ *   4. .agntk/memory.md
+ *   5. .agntk/context.md
+ */
+import { createLogger } from '@agntk/logger';
+const log = createLogger('@agntk/core:memory-loader');
+/** Rough token estimate: ~4 chars per token */
+const CHARS_PER_TOKEN = 4;
+const TOKEN_WARNING_THRESHOLD = 2000;
+/**
+ * Load all always-on memory files and format as a system prompt section.
+ * Missing files are silently skipped.
+ */
+export async function loadMemoryContext(store) {
+    const sections = [];
+    // 1. Identity (global, human-authored)
+    const identity = await store.loadIdentity();
+    if (identity) {
+        sections.push(formatSection('Identity', identity));
+    }
+    // 2. Preferences (global, agent-curated)
+    const preferences = await store.loadPreferences();
+    if (preferences) {
+        sections.push(formatSection('Preferences', preferences));
+    }
+    // 3. Project (local, human-authored — falls back to CLAUDE.md / AGENTS.md)
+    const project = await store.loadProject();
+    if (project) {
+        sections.push(formatSection('Project', project));
+    }
+    // 4. Memory (local, agent-curated facts)
+    const memory = await store.loadMemory();
+    if (memory) {
+        sections.push(formatSection('Memory', memory));
+    }
+    // 5. Context (local, agent-rewritten each session)
+    const context = await store.loadContext();
+    if (context) {
+        sections.push(formatSection('Current Context', context));
+    }
+    if (sections.length === 0) {
+        return '';
+    }
+    const result = '# Persistent Memory\n\n' + sections.join('\n\n');
+    // Warn if memory context is large
+    const estimatedTokens = Math.ceil(result.length / CHARS_PER_TOKEN);
+    if (estimatedTokens > TOKEN_WARNING_THRESHOLD) {
+        log.warn('Memory context is large', {
+            estimatedTokens,
+            threshold: TOKEN_WARNING_THRESHOLD,
+            chars: result.length,
+        });
+    }
+    log.debug('Memory context loaded', {
+        sections: sections.length,
+        chars: result.length,
+        estimatedTokens,
+    });
+    return result;
+}
+function formatSection(title, content) {
+    return `## ${title}\n\n${content}`;
+}
+//# sourceMappingURL=loader.js.map

package/dist/memory/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/memory/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,GAAG,GAAG,YAAY,CAAC,2BAA2B,CAAC,CAAC;AAEtD,+CAA+C;AAC/C,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAErC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAkB;IACxD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,uCAAuC;IACvC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;IAC5C,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,yCAAyC;IACzC,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;IAClD,IAAI,WAAW,EAAE,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,2EAA2E;IAC3E,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,yCAAyC;IACzC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;IACxC,IAAI,MAAM,EAAE,CAAC;QACX,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,mDAAmD;IACnD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,yBAAyB,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjE,kCAAkC;IAClC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;IACnE,IAAI,eAAe,GAAG,uBAAuB,EAAE,CAAC;QAC9C,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE;YAClC,eAAe;YACf,SAAS,EAAE,uBAAuB;YAClC,KAAK,EAAE,MAAM,CAAC,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE;QACjC,QAAQ,EAAE,QAAQ,CAAC,MAAM;QACzB,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,eAAe;KAChB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,OAAe;IACnD,OAAO,MAAM,KAAK,OAAO,OAAO,EAAE,CAAC;AACrC,CAAC"}

package/dist/memory/store.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @agntk/core - MarkdownMemoryStore
+ *
+ * File-based MemoryStore implementation that reads/writes .agntk/ markdown files.
+ * Zero dependencies beyond Node.js built-ins.
+ */
+import type { MemoryStore } from './types.js';
+export interface MarkdownMemoryStoreOptions {
+    /** Project-local memory directory. Default: '.agntk' (relative to workspaceRoot) */
+    projectDir?: string;
+    /** Global memory directory. Default: '~/.agntk' */
+    globalDir?: string;
+    /** Workspace root for resolving project directory. Default: process.cwd() */
+    workspaceRoot?: string;
+}
+/**
+ * Reads/writes markdown memory files from .agntk/ and ~/.agntk/ directories.
+ */
+export declare class MarkdownMemoryStore implements MemoryStore {
+    private readonly projectPath;
+    private readonly globalPath;
+    private readonly workspaceRoot;
+    constructor(options?: MarkdownMemoryStoreOptions);
+    loadIdentity(): Promise<string | null>;
+    loadPreferences(): Promise<string | null>;
+    loadProject(): Promise<string | null>;
+    loadMemory(): Promise<string | null>;
+    loadContext(): Promise<string | null>;
+    loadDecisions(): Promise<string | null>;
+    saveContext(content: string): Promise<void>;
+    saveMemory(content: string): Promise<void>;
+    savePreferences(content: string): Promise<void>;
+    appendDecision(entry: string): Promise<void>;
+    /** Get the resolved project directory path */
+    getProjectPath(): string;
+    /** Get the resolved global directory path */
+    getGlobalPath(): string;
+    private readFileOrNull;
+    private writeFileSafe;
+    private ensureDir;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA2B3C,MAAM,WAAW,0BAA0B;IACzC,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,OAAO,GAAE,0BAA+B;IAQ9C,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAItC,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzC,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiBrC,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIpC,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIrC,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMvC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlD,8CAA8C;IAC9C,cAAc,IAAI,MAAM;IAIxB,6CAA6C;IAC7C,aAAa,IAAI,MAAM;YAMT,cAAc;YASd,aAAa;YAOb,SAAS;CAMxB"}