@agntk/core 0.1.0

package/dist/memory/store.js

@@ -0,0 +1,120 @@
+/**
+ * @agntk/core - MarkdownMemoryStore
+ *
+ * File-based MemoryStore implementation that reads/writes .agntk/ markdown files.
+ * Zero dependencies beyond Node.js built-ins.
+ */
+import { readFile, writeFile, appendFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { createLogger } from '@agntk/logger';
+const log = createLogger('@agntk/core:memory-store');
+// ============================================================================
+// Constants
+// ============================================================================
+const PROJECT_DIR_DEFAULT = '.agntk';
+const GLOBAL_DIR_DEFAULT = '.agntk';
+const FILES = {
+    identity: 'identity.md',
+    preferences: 'preferences.md',
+    project: 'project.md',
+    memory: 'memory.md',
+    context: 'context.md',
+    decisions: 'decisions.md',
+};
+/** Fallback project context files (checked in order) */
+const PROJECT_FALLBACKS = ['CLAUDE.md', 'AGENTS.md'];
+/**
+ * Reads/writes markdown memory files from .agntk/ and ~/.agntk/ directories.
+ */
+export class MarkdownMemoryStore {
+    projectPath;
+    globalPath;
+    workspaceRoot;
+    constructor(options = {}) {
+        this.workspaceRoot = options.workspaceRoot ?? process.cwd();
+        this.projectPath = resolve(this.workspaceRoot, options.projectDir ?? PROJECT_DIR_DEFAULT);
+        this.globalPath = resolve(homedir(), options.globalDir ?? GLOBAL_DIR_DEFAULT);
+    }
+    // ── Load methods ─────────────────────────────────────────────────────
+    async loadIdentity() {
+        return this.readFileOrNull(join(this.globalPath, FILES.identity));
+    }
+    async loadPreferences() {
+        return this.readFileOrNull(join(this.globalPath, FILES.preferences));
+    }
+    async loadProject() {
+        // Try .agntk/project.md first
+        const projectFile = await this.readFileOrNull(join(this.projectPath, FILES.project));
+        if (projectFile)
+            return projectFile;
+        // Fall back to CLAUDE.md or AGENTS.md in workspace root
+        for (const fallback of PROJECT_FALLBACKS) {
+            const content = await this.readFileOrNull(join(this.workspaceRoot, fallback));
+            if (content) {
+                log.debug('Using fallback project file', { file: fallback });
+                return content;
+            }
+        }
+        return null;
+    }
+    async loadMemory() {
+        return this.readFileOrNull(join(this.projectPath, FILES.memory));
+    }
+    async loadContext() {
+        return this.readFileOrNull(join(this.projectPath, FILES.context));
+    }
+    async loadDecisions() {
+        return this.readFileOrNull(join(this.projectPath, FILES.decisions));
+    }
+    // ── Save methods ─────────────────────────────────────────────────────
+    async saveContext(content) {
+        await this.writeFileSafe(join(this.projectPath, FILES.context), content);
+    }
+    async saveMemory(content) {
+        await this.writeFileSafe(join(this.projectPath, FILES.memory), content);
+    }
+    async savePreferences(content) {
+        await this.writeFileSafe(join(this.globalPath, FILES.preferences), content);
+    }
+    async appendDecision(entry) {
+        const filePath = join(this.projectPath, FILES.decisions);
+        await this.ensureDir(this.projectPath);
+        const separator = existsSync(filePath) ? '\n\n' : '';
+        await appendFile(filePath, separator + entry, 'utf-8');
+        log.debug('Decision appended', { path: filePath });
+    }
+    // ── Utilities ────────────────────────────────────────────────────────
+    /** Get the resolved project directory path */
+    getProjectPath() {
+        return this.projectPath;
+    }
+    /** Get the resolved global directory path */
+    getGlobalPath() {
+        return this.globalPath;
+    }
+    // ── Private helpers ──────────────────────────────────────────────────
+    async readFileOrNull(filePath) {
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            return content.trim() || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async writeFileSafe(filePath, content) {
+        const dir = filePath.substring(0, filePath.lastIndexOf('/'));
+        await this.ensureDir(dir);
+        await writeFile(filePath, content, 'utf-8');
+        log.debug('File written', { path: filePath, length: content.length });
+    }
+    async ensureDir(dir) {
+        if (!existsSync(dir)) {
+            await mkdir(dir, { recursive: true });
+            log.debug('Directory created', { path: dir });
+        }
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/memory/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,GAAG,GAAG,YAAY,CAAC,0BAA0B,CAAC,CAAC;AAErD,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,mBAAmB,GAAG,QAAQ,CAAC;AACrC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAEpC,MAAM,KAAK,GAAG;IACZ,QAAQ,EAAE,aAAa;IACvB,WAAW,EAAE,gBAAgB;IAC7B,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,SAAS,EAAE,cAAc;CACjB,CAAC;AAEX,wDAAwD;AACxD,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,WAAW,CAAU,CAAC;AAe9D;;GAEG;AACH,MAAM,OAAO,mBAAmB;IACb,WAAW,CAAS;IACpB,UAAU,CAAS;IACnB,aAAa,CAAS;IAEvC,YAAY,UAAsC,EAAE;QAClD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC5D,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC,CAAC;QAC1F,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC,CAAC;IAChF,CAAC;IAED,wEAAwE;IAExE,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,WAAW;QACf,8BAA8B;QAC9B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACrF,IAAI,WAAW;YAAE,OAAO,WAAW,CAAC;QAEpC,wDAAwD;QACxD,KAAK,MAAM,QAAQ,IAAI,iBAAiB,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;YAC9E,IAAI,OAAO,EAAE,CAAC;gBACZ,GAAG,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC7D,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,wEAAwE;IAExE,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe;QAC9B,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAe;QACnC,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAAa;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACzD,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,UAAU,CAAC,QAAQ,EAAE,SAAS,GAAG,KAAK,EAAE,OAAO,CAAC,CAAC;QACvD,GAAG,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,wEAAwE;IAExE,8CAA8C;IAC9C,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,6CAA6C;IAC7C,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,wEAAwE;IAEhE,KAAK,CAAC,cAAc,CAAC,QAAgB;QAC3C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClD,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,OAAe;QAC3D,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,GAAG,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,GAAW;QACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,GAAG,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF"}

package/dist/memory/tools.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @agntk/core - Memory Tools
+ *
+ * Four markdown-based memory tools: remember, recall, update_context, forget.
+ * Uses MemoryStore for persistence and LLM for extraction/curation.
+ */
+import { type LanguageModel } from 'ai';
+import type { MemoryStore } from './types.js';
+export interface MemoryToolsOptions {
+    /** MemoryStore instance for reading/writing files */
+    store: MemoryStore;
+    /** LanguageModel for extraction (required for remember/forget) */
+    model?: LanguageModel;
+}
+/**
+ * Create the 4 memory tools for an agent.
+ *
+ * @example
+ * ```typescript
+ * const store = new MarkdownMemoryStore({ workspaceRoot: '/my/project' });
+ * const tools = createMemoryTools({ store, model });
+ * ```
+ */
+export declare function createMemoryTools(options: MemoryToolsOptions): {
+    remember: import("ai").Tool<{
+        text: string;
+        isDecision?: boolean | undefined;
+    }, string>;
+    recall: import("ai").Tool<{
+        query: string;
+    }, string>;
+    update_context: import("ai").Tool<{
+        summary: string;
+    }, string>;
+    forget: import("ai").Tool<{
+        fact: string;
+    }, string>;
+};
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/memory/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AAG9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAS3C,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,KAAK,EAAE,WAAW,CAAC;IAEnB,kEAAkE;IAClE,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB;;;;;;;;;;;;;;EAqL5D"}

package/dist/memory/tools.js

@@ -0,0 +1,225 @@
+/**
+ * @agntk/core - Memory Tools
+ *
+ * Four markdown-based memory tools: remember, recall, update_context, forget.
+ * Uses MemoryStore for persistence and LLM for extraction/curation.
+ */
+import { tool } from 'ai';
+import { z } from 'zod';
+import { createLogger } from '@agntk/logger';
+import { extractAndUpdateMemory, forgetFromMemory, generateDecisionEntry } from './extraction.js';
+const log = createLogger('@agntk/core:memory-tools');
+// ============================================================================
+// Tool Factory
+// ============================================================================
+/**
+ * Create the 4 memory tools for an agent.
+ *
+ * @example
+ * ```typescript
+ * const store = new MarkdownMemoryStore({ workspaceRoot: '/my/project' });
+ * const tools = createMemoryTools({ store, model });
+ * ```
+ */
+export function createMemoryTools(options) {
+    const { store, model } = options;
+    const remember = tool({
+        description: 'Store information in persistent memory. Extracts facts and updates memory.md. ' +
+            'Use this when the user says "remember this" or when you learn something worth preserving across sessions. ' +
+            'Also logs decisions to decisions.md when the input describes a decision.',
+        inputSchema: z.object({
+            text: z
+                .string()
+                .min(1)
+                .max(10000)
+                .describe('Information to remember'),
+            isDecision: z
+                .boolean()
+                .optional()
+                .describe('Set to true if this is a decision that should be logged to decisions.md'),
+        }),
+        execute: async ({ text, isDecision }) => {
+            log.debug('remember() called', { textLength: text.length, isDecision });
+            if (!model) {
+                // Without a model, store text directly as a bullet point in memory.md
+                const current = await store.loadMemory();
+                const updated = (current ?? '# Memory\n') + `\n- ${text}`;
+                await store.saveMemory(updated);
+                return JSON.stringify({ success: true, message: 'Stored (no extraction — no model available)' });
+            }
+            try {
+                // Extract and update memory.md via LLM
+                const currentMemory = await store.loadMemory();
+                const updatedMemory = await extractAndUpdateMemory(currentMemory, text, model);
+                await store.saveMemory(updatedMemory);
+                // Also log to decisions.md if flagged
+                if (isDecision) {
+                    const entry = await generateDecisionEntry(text, model);
+                    await store.appendDecision(entry);
+                    log.info('Decision logged', { entryLength: entry.length });
+                }
+                log.info('Memory updated via extraction', { inputLength: text.length });
+                return JSON.stringify({ success: true, message: 'Memory updated' });
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                log.error('remember() failed', { error: msg });
+                return JSON.stringify({ success: false, error: msg });
+            }
+        },
+    });
+    const recall = tool({
+        description: 'Search persistent memory for relevant information. ' +
+            'Reads memory.md (curated facts) and decisions.md (decision log) and returns matching content. ' +
+            'Use this when you need to check what was previously remembered or decided.',
+        inputSchema: z.object({
+            query: z
+                .string()
+                .min(1)
+                .max(1000)
+                .describe('What to search for in memory'),
+        }),
+        execute: async ({ query }) => {
+            log.debug('recall() called', { query: query.slice(0, 50) });
+            try {
+                const results = [];
+                // Search memory.md
+                const memory = await store.loadMemory();
+                if (memory) {
+                    const memoryMatches = searchContent(memory, query);
+                    if (memoryMatches.length > 0) {
+                        results.push({ source: 'memory.md', content: memoryMatches.join('\n') });
+                    }
+                }
+                // Search decisions.md
+                const decisions = await store.loadDecisions();
+                if (decisions) {
+                    const decisionMatches = searchContent(decisions, query);
+                    if (decisionMatches.length > 0) {
+                        results.push({ source: 'decisions.md', content: decisionMatches.join('\n') });
+                    }
+                }
+                // Search context.md
+                const context = await store.loadContext();
+                if (context) {
+                    const contextMatches = searchContent(context, query);
+                    if (contextMatches.length > 0) {
+                        results.push({ source: 'context.md', content: contextMatches.join('\n') });
+                    }
+                }
+                log.info('recall() completed', { query: query.slice(0, 30), resultCount: results.length });
+                if (results.length === 0) {
+                    return JSON.stringify({
+                        success: true,
+                        message: 'No matching memories found.',
+                        results: [],
+                    });
+                }
+                return JSON.stringify({ success: true, results });
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                log.error('recall() failed', { error: msg });
+                return JSON.stringify({ success: false, error: msg });
+            }
+        },
+    });
+    const update_context = tool({
+        description: 'Rewrite the session context file (context.md) with a summary of current work. ' +
+            'Call this at the end of a session or when the focus of work changes significantly. ' +
+            'The previous context.md is completely overwritten.',
+        inputSchema: z.object({
+            summary: z
+                .string()
+                .min(1)
+                .max(5000)
+                .describe('Summary of current session state: active work, recent changes, open questions, next steps'),
+        }),
+        execute: async ({ summary }) => {
+            log.debug('update_context() called', { summaryLength: summary.length });
+            try {
+                const timestamp = new Date().toISOString().replace('T', ' ').split('.')[0];
+                const content = `# Current Context\n*Last updated: ${timestamp}*\n\n${summary}`;
+                await store.saveContext(content);
+                log.info('Context updated', { length: content.length });
+                return JSON.stringify({ success: true, message: 'Context updated' });
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                log.error('update_context() failed', { error: msg });
+                return JSON.stringify({ success: false, error: msg });
+            }
+        },
+    });
+    const forget = tool({
+        description: 'Remove a specific fact from persistent memory (memory.md). ' +
+            'Use this when information is no longer true or relevant.',
+        inputSchema: z.object({
+            fact: z
+                .string()
+                .min(1)
+                .max(1000)
+                .describe('The fact to remove from memory'),
+        }),
+        execute: async ({ fact }) => {
+            log.debug('forget() called', { fact: fact.slice(0, 50) });
+            if (!model) {
+                return JSON.stringify({ success: false, error: 'Cannot forget without a language model' });
+            }
+            try {
+                const currentMemory = await store.loadMemory();
+                const updatedMemory = await forgetFromMemory(currentMemory, fact, model);
+                await store.saveMemory(updatedMemory);
+                log.info('Fact forgotten', { factLength: fact.length });
+                return JSON.stringify({ success: true, message: 'Fact removed from memory' });
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                log.error('forget() failed', { error: msg });
+                return JSON.stringify({ success: false, error: msg });
+            }
+        },
+    });
+    return { remember, recall, update_context, forget };
+}
+// ============================================================================
+// Search Helpers
+// ============================================================================
+/**
+ * Simple keyword search across lines of content.
+ * Returns lines that match any word in the query.
+ */
+function searchContent(content, query) {
+    const queryWords = query.toLowerCase().split(/\s+/).filter(w => w.length > 2);
+    if (queryWords.length === 0)
+        return [];
+    const lines = content.split('\n');
+    const matches = [];
+    // Search by paragraph (groups of consecutive non-empty lines)
+    let currentParagraph = [];
+    for (const line of lines) {
+        if (line.trim() === '') {
+            if (currentParagraph.length > 0) {
+                const paragraph = currentParagraph.join('\n');
+                const lower = paragraph.toLowerCase();
+                if (queryWords.some(w => lower.includes(w))) {
+                    matches.push(paragraph);
+                }
+                currentParagraph = [];
+            }
+        }
+        else {
+            currentParagraph.push(line);
+        }
+    }
+    // Don't forget the last paragraph
+    if (currentParagraph.length > 0) {
+        const paragraph = currentParagraph.join('\n');
+        const lower = paragraph.toLowerCase();
+        if (queryWords.some(w => lower.includes(w))) {
+            matches.push(paragraph);
+        }
+    }
+    return matches;
+}
+//# sourceMappingURL=tools.js.map

package/dist/memory/tools.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @agntk/core - Memory Types
+ *
+ * Defines the MemoryStore interface and configuration types
+ * for the markdown-based memory system.
+ */
+/**
+ * Interface for reading/writing agent memory files.
+ *
+ * The default implementation (MarkdownMemoryStore) reads/writes .agntk/
+ * markdown files. Custom implementations can back memory with any storage.
+ */
+export interface MemoryStore {
+    /** Load ~/.agntk/identity.md (human-authored, optional) */
+    loadIdentity(): Promise<string | null>;
+    /** Load ~/.agntk/preferences.md (agent-curated, cross-project) */
+    loadPreferences(): Promise<string | null>;
+    /** Load .agntk/project.md (human-authored). Falls back to CLAUDE.md / AGENTS.md */
+    loadProject(): Promise<string | null>;
+    /** Load .agntk/memory.md (agent-curated facts) */
+    loadMemory(): Promise<string | null>;
+    /** Load .agntk/context.md (agent-rewritten each session) */
+    loadContext(): Promise<string | null>;
+    /** Load .agntk/decisions.md (append-only decision log) */
+    loadDecisions(): Promise<string | null>;
+    /** Overwrite .agntk/context.md entirely */
+    saveContext(content: string): Promise<void>;
+    /** Overwrite .agntk/memory.md entirely (after LLM curation) */
+    saveMemory(content: string): Promise<void>;
+    /** Overwrite ~/.agntk/preferences.md */
+    savePreferences(content: string): Promise<void>;
+    /** Append an entry to .agntk/decisions.md */
+    appendDecision(entry: string): Promise<void>;
+}
+/**
+ * Configuration for the memory system.
+ */
+export interface MemoryConfig {
+    /** Directory for project-local memory files. Default: '.agntk' */
+    projectDir?: string;
+    /** Directory for global (cross-project) memory files. Default: '~/.agntk' */
+    globalDir?: string;
+    /** Custom MemoryStore implementation. Overrides file-based defaults. */
+    store?: MemoryStore;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAG1B,2DAA2D;IAC3D,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEvC,kEAAkE;IAClE,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE1C,mFAAmF;IACnF,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEtC,kDAAkD;IAClD,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAErC,4DAA4D;IAC5D,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAItC,0DAA0D;IAC1D,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAIxC,2CAA2C;IAC3C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C,+DAA+D;IAC/D,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C,wCAAwC;IACxC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,6CAA6C;IAC7C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wEAAwE;IACxE,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB"}

package/dist/memory/types.js

@@ -0,0 +1,8 @@
+/**
+ * @agntk/core - Memory Types
+ *
+ * Defines the MemoryStore interface and configuration types
+ * for the markdown-based memory system.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/memory/vectra-store.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @agntk/core - Vectra Memory Store
+ *
+ * Portable in-memory vector database using Vectra.
+ * Zero native dependencies, file-based persistence.
+ */
+import type { MemoryOptions } from '../types/agent.js';
+export interface MemoryItem {
+    id: string;
+    text: string;
+    metadata?: Record<string, unknown>;
+    timestamp: Date;
+}
+export interface MemorySearchResult {
+    item: MemoryItem;
+    score: number;
+}
+export interface MemoryStore {
+    remember: (text: string, metadata?: Record<string, unknown>) => Promise<string>;
+    recall: (query: string, options?: {
+        topK?: number;
+        threshold?: number;
+    }) => Promise<MemorySearchResult[]>;
+    forget: (id: string) => Promise<boolean>;
+    forgetAll: (filter?: (item: MemoryItem) => boolean) => Promise<number>;
+    count: () => Promise<number>;
+    close: () => Promise<void>;
+}
+export declare function createMemoryStore(options?: MemoryOptions): Promise<MemoryStore>;
+export type { MemoryOptions };
+//# sourceMappingURL=vectra-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vectra-store.d.ts","sourceRoot":"","sources":["../../src/memory/vectra-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAQpD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAChF,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC1G,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAqCD,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkGzF;AAMD,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/memory/vectra-store.js

@@ -0,0 +1,122 @@
+/**
+ * @agntk/core - Vectra Memory Store
+ *
+ * Portable in-memory vector database using Vectra.
+ * Zero native dependencies, file-based persistence.
+ */
+import { LocalIndex } from 'vectra';
+import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+import { createLogger } from '@agntk/logger';
+import { getConfig } from '../config/index.js';
+import { DEFAULT_EMBEDDING_URL, DEFAULT_EMBEDDING_MODEL, DEFAULT_MEMORY_PATH, DEFAULT_MEMORY_TOP_K, DEFAULT_MEMORY_SIMILARITY_THRESHOLD, } from '../constants.js';
+const log = createLogger('@agntk/core:memory');
+// ============================================================================
+// Embedding - Using OpenAI directly
+// ============================================================================
+async function getEmbedding(text, modelName, embeddingUrl) {
+    const apiKey = process.env['OPENAI_API_KEY'];
+    if (!apiKey) {
+        throw new Error('OPENAI_API_KEY required for memory embeddings');
+    }
+    const url = embeddingUrl ?? DEFAULT_EMBEDDING_URL;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+            model: modelName ?? DEFAULT_EMBEDDING_MODEL,
+            input: text,
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`Embedding failed: ${response.statusText}`);
+    }
+    const data = await response.json();
+    return data.data[0].embedding;
+}
+// ============================================================================
+// Memory Store Implementation
+// ============================================================================
+export async function createMemoryStore(options = {}) {
+    // Merge with config values
+    const config = getConfig();
+    const memoryConfig = (config.memory ?? {});
+    const { path: storagePath = memoryConfig.path ?? DEFAULT_MEMORY_PATH, embedModel = memoryConfig.embedModel ?? DEFAULT_EMBEDDING_MODEL, topK = memoryConfig.topK ?? DEFAULT_MEMORY_TOP_K, similarityThreshold = memoryConfig.similarityThreshold ?? DEFAULT_MEMORY_SIMILARITY_THRESHOLD, } = options;
+    log.info('Creating memory store', { path: storagePath, embedModel, topK });
+    const absolutePath = path.resolve(storagePath);
+    await fs.mkdir(absolutePath, { recursive: true });
+    const index = new LocalIndex(absolutePath);
+    if (!await index.isIndexCreated()) {
+        await index.createIndex();
+    }
+    const store = {
+        async remember(text, metadata) {
+            const id = generateId();
+            const vector = await getEmbedding(text, embedModel);
+            await index.insertItem({
+                id,
+                vector,
+                metadata: { text, timestamp: new Date().toISOString(), ...metadata },
+            });
+            return id;
+        },
+        async recall(query, opts) {
+            const queryVector = await getEmbedding(query, embedModel);
+            const k = opts?.topK ?? topK;
+            const threshold = opts?.threshold ?? similarityThreshold;
+            const results = await index.queryItems(queryVector, k);
+            return results
+                .filter(r => r.score >= threshold)
+                .map(r => ({
+                item: {
+                    id: r.item.id,
+                    text: r.item.metadata?.text ?? '',
+                    metadata: r.item.metadata,
+                    timestamp: new Date(r.item.metadata?.timestamp ?? Date.now()),
+                },
+                score: r.score,
+            }));
+        },
+        async forget(id) {
+            try {
+                await index.deleteItem(id);
+                return true;
+            }
+            catch (_e) {
+                return false;
+            }
+        },
+        async forgetAll(filter) {
+            const items = await index.listItems();
+            let deleted = 0;
+            for (const item of items) {
+                const memoryItem = {
+                    id: item.id,
+                    text: item.metadata?.text ?? '',
+                    metadata: item.metadata,
+                    timestamp: new Date(item.metadata?.timestamp ?? Date.now()),
+                };
+                if (!filter || filter(memoryItem)) {
+                    await index.deleteItem(item.id);
+                    deleted++;
+                }
+            }
+            return deleted;
+        },
+        async count() {
+            const items = await index.listItems();
+            return items.length;
+        },
+        async close() {
+            // Vectra auto-persists
+        },
+    };
+    return store;
+}
+function generateId() {
+    return `mem_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
+//# sourceMappingURL=vectra-store.js.map

package/dist/memory/vectra-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectra-store.js","sourceRoot":"","sources":["../../src/memory/vectra-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,mCAAmC,GACpC,MAAM,cAAc,CAAC;AAGtB,MAAM,GAAG,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;AA2B/C,+EAA+E;AAC/E,oCAAoC;AACpC,+EAA+E;AAE/E,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,SAAkB,EAAE,YAAqB;IACjF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,IAAI,qBAAqB,CAAC;IAClD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,eAAe,EAAE,UAAU,MAAM,EAAE;SACpC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE,SAAS,IAAI,uBAAuB;YAC3C,KAAK,EAAE,IAAI;SACZ,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAyC,CAAC;IAC1E,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAChC,CAAC;AAED,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAAyB,EAAE;IACjE,2BAA2B;IAC3B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAA4B,CAAC;IAEtE,MAAM,EACJ,IAAI,EAAE,WAAW,GAAI,YAAY,CAAC,IAAe,IAAI,mBAAmB,EACxE,UAAU,GAAI,YAAY,CAAC,UAAqB,IAAI,uBAAuB,EAC3E,IAAI,GAAI,YAAY,CAAC,IAAe,IAAI,oBAAoB,EAC5D,mBAAmB,GAAI,YAAY,CAAC,mBAA8B,IAAI,mCAAmC,GAC1G,GAAG,OAAO,CAAC;IAEZ,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3E,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;IAE3C,IAAI,CAAC,MAAM,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;QAClC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,KAAK,GAAgB;QACzB,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,QAAkC;YAC7D,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAEpD,MAAM,KAAK,CAAC,UAAU,CAAC;gBACrB,EAAE;gBACF,MAAM;gBACN,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,QAAQ,EAAE;aACrE,CAAC,CAAC;YAEH,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,IAA4C;YACtE,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YAC1D,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;YAC7B,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,mBAAmB,CAAC;YAEzD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAEvD,OAAO,OAAO;iBACX,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,SAAS,CAAC;iBACjC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACT,IAAI,EAAE;oBACJ,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE;oBACb,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAc,IAAI,EAAE;oBAC3C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,QAAmC;oBACpD,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAmB,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;iBACxE;gBACD,KAAK,EAAE,CAAC,CAAC,KAAK;aACf,CAAC,CAAC,CAAC;QACR,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAU;YACrB,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;gBAC3B,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,EAAW,EAAE,CAAC;gBACrB,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,MAAsC;YACpD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,OAAO,GAAG,CAAC,CAAC;YAEhB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,UAAU,GAAe;oBAC7B,EAAE,EAAE,IAAI,CAAC,EAAE;oBACX,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAc,IAAI,EAAE;oBACzC,QAAQ,EAAE,IAAI,CAAC,QAAmC;oBAClD,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAmB,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;iBACtE,CAAC;gBAEF,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;oBAClC,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAChC,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,KAAK;YACT,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC,MAAM,CAAC;QACtB,CAAC;QAED,KAAK,CAAC,KAAK;YACT,uBAAuB;QACzB,CAAC;KACF,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACxE,CAAC"}