@crewx/memory 0.1.23-rc.18 → 0.1.23-rc.180

package/dist/cli.d.ts

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 export declare function main(inputArgs?: string[]): Promise<void>;
-//# sourceMappingURL=cli.d.ts.map
+                                 

package/dist/cli.js

@@ -1,83 +1,6 @@
 #!/usr/bin/env node
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.main = main;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const engine_1 = require("./src/engine");
-const types_1 = require("./src/types");
-const mindmap_1 = require("./src/mindmap");
-let PKG_VERSION = 'unknown';
-try {
-    const _pkgPath = fs.existsSync(path.join(__dirname, 'package.json'))
-        ? path.join(__dirname, 'package.json')
-        : path.join(__dirname, '..', 'package.json');
-    const _pkg = JSON.parse(fs.readFileSync(_pkgPath, 'utf-8'));
-    if (_pkg?.version)
-        PKG_VERSION = String(_pkg.version);
-}
-catch { }
-function readStdin() {
-    return new Promise((resolve, reject) => {
-        const chunks = [];
-        process.stdin.on('data', (chunk) => chunks.push(chunk));
-        process.stdin.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8').trim()));
-        process.stdin.on('error', reject);
-    });
-}
-async function loadTracer() {
-    try {
-        return await Promise.resolve().then(() => __importStar(require('@crewx/shared/skill-tracer')));
-    }
-    catch {
-        return null;
-    }
-}
-function showDetailedUsage() {
-    const skillMd = path.join(__dirname, '..', 'SKILL.md');
-    if (fs.existsSync(skillMd)) {
-        process.stdout.write(fs.readFileSync(skillMd, 'utf-8'));
-    }
-    else {
-        console.log('No SKILL.md found. Use --help for usage.');
-    }
-}
-function printUsage() {
-    console.log(`
-@crewx/memory@${PKG_VERSION} - Markdown-based long-term memory for AI agents
+"use strict";var w=exports&&exports.__createBinding||(Object.create?(function(s,r,i,e){if(e===void 0)e=i;var t=Object.getOwnPropertyDescriptor(r,i);if(!t||("get"in t?!r.__esModule:t.writable||t.configurable)){t={enumerable:true,get:function(){return r[i]}}}Object.defineProperty(s,e,t)}):(function(s,r,i,e){if(e===void 0)e=i;s[e]=r[i]}));var v=exports&&exports.__setModuleDefault||(Object.create?(function(s,r){Object.defineProperty(s,"default",{enumerable:true,value:r})}):function(s,r){s["default"]=r});var y=exports&&exports.__importStar||(function(){var s=function(r){s=Object.getOwnPropertyNames||function(i){var e=[];for(var t in i)if(Object.prototype.hasOwnProperty.call(i,t))e[e.length]=t;return e};return s(r)};return function(r){if(r&&r.__esModule)return r;var i={};if(r!=null){for(var e=s(r),t=0;t<e.length;t++)if(e[t]!=="default")w(i,r,e[t])}v(i,r);return i}})();Object.defineProperty(exports,"__esModule",{value:true});exports.main=b;const p=y(require("fs"));const f=y(require("path"));const k=require("./src/engine");const x=require("./src/types");const S=require("./src/mindmap");let _="unknown";try{const s=p.existsSync(f.join(__dirname,"package.json"))?f.join(__dirname,"package.json"):f.join(__dirname,"..","package.json");const r=JSON.parse(p.readFileSync(s,"utf-8"));if(r?.version)_=String(r.version)}catch{}function q(){const s=[];let r;let i;const e=new Promise((a,l)=>{r=a;i=l});const t=a=>s.push(a);const n=()=>r(Buffer.concat(s).toString("utf-8").trim());const o=a=>i(a);process.stdin.on("data",t);process.stdin.on("end",n);process.stdin.on("error",o);const g=()=>{process.stdin.off("data",t);process.stdin.off("end",n);process.stdin.off("error",o);process.stdin.pause();if(typeof process.stdin.unref==="function")process.stdin.unref()};return{body:e,release:g}}async function E(){try{return await Promise.resolve().then(()=>y(require("@crewx/shared/skill-tracer")))}catch{return null}}function O(){const s=f.join(__dirname,"..","SKILL.md");if(p.existsSync(s)){process.stdout.write(p.readFileSync(s,"utf-8"))}else{console.log("No SKILL.md found. Use --help for usage.")}}function h(){console.log(`
+@crewx/memory@${_} - Markdown-based long-term memory for AI agents
 
 Usage:
   memory <command> <agent_id> [args]
@@ -110,264 +33,4 @@ Examples:
   memory get myagent PWN3qt
 
 For detailed usage guide: memory usage
-`);
-}
-const ALIASES = {
-    read: 'get',
-    rm: 'delete',
-    ls: 'recent',
-};
-const BOOLEAN_FLAGS = new Set([
-    'help', 'force', 'verbose', 'full', 'important', 'no-important', 'json', 'all', 'version',
-]);
-function parseArgs(args) {
-    const result = { positional: [], options: {} };
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (arg === '-h') {
-            result.options['help'] = true;
-        }
-        else if (arg.startsWith('--')) {
-            const eqIdx = arg.indexOf('=');
-            if (eqIdx !== -1) {
-                const key = arg.slice(2, eqIdx);
-                const value = arg.slice(eqIdx + 1);
-                result.options[key] = value;
-            }
-            else {
-                const key = arg.slice(2);
-                if (!BOOLEAN_FLAGS.has(key)) {
-                    const nextArg = args[i + 1];
-                    if (nextArg !== undefined && !nextArg.startsWith('--') && nextArg !== '-h') {
-                        result.options[key] = nextArg;
-                        i++;
-                    }
-                    else {
-                        result.options[key] = true;
-                    }
-                }
-                else {
-                    result.options[key] = true;
-                }
-            }
-        }
-        else {
-            result.positional.push(arg);
-        }
-    }
-    return result;
-}
-async function main(inputArgs) {
-    const args = inputArgs ?? process.argv.slice(2);
-    const { positional, options } = parseArgs(args);
-    const [command, agentId, ...rest] = positional;
-    if (options.version) {
-        console.log(PKG_VERSION);
-        return;
-    }
-    if (options.help) {
-        printUsage();
-        return;
-    }
-    if (command === 'usage') {
-        showDetailedUsage();
-        return;
-    }
-    if (command === 'help') {
-        printUsage();
-        return;
-    }
-    if (!command) {
-        printUsage();
-        return;
-    }
-    const resolvedCommand = ALIASES[command] ?? command;
-    if (resolvedCommand === 'mindmap') {
-        const dataDir = process.env['MEMORY_DATA_DIR'] ?? path.resolve(process.cwd(), 'memory');
-        const mindmap = new mindmap_1.MindmapEngine(dataDir);
-        const subcommand = agentId;
-        const mAgentId = rest[0];
-        const mRest = rest.slice(1);
-        if (!subcommand) {
-            console.log('Usage: npx memory mindmap <subcommand> [agent_id] [args]');
-            console.log('');
-            console.log('Subcommands:');
-            console.log('  build <agent_id>                                        - 그래프 빌드');
-            console.log('  show <agent_id> [--period=stm|mtm|ltm] [--format=mermaid|text] - 그래프 요약');
-            console.log('  related <agent_id> <memory_id>                          - 연결된 기억 조회');
-            console.log('  add <agent_id> <from_id> <to_id> [type]                - 수동 연결 추가');
-            console.log('  remove <agent_id> <from_id> <to_id>                    - 연결 제거');
-            console.log('  html                                                    - 공용 HTML 생성');
-            console.log('  open [agent_id]                                         - 브라우저에서 열기');
-            process.exit(1);
-        }
-        switch (subcommand) {
-            case 'build':
-                if (!mAgentId) {
-                    console.log('Error: agent_id is required');
-                    process.exit(1);
-                }
-                mindmap.build(mAgentId, options);
-                break;
-            case 'show':
-                if (!mAgentId) {
-                    console.log('Error: agent_id is required');
-                    process.exit(1);
-                }
-                mindmap.show(mAgentId, { period: options.period, format: options.format });
-                break;
-            case 'related':
-                if (!mAgentId || !mRest?.[0]) {
-                    console.log('Error: agent_id and memory_id are required');
-                    process.exit(1);
-                }
-                mindmap.related(mAgentId, mRest[0]);
-                break;
-            case 'add':
-                if (!mAgentId || !mRest?.[0] || !mRest?.[1]) {
-                    console.log('Error: agent_id, from_id and to_id are required');
-                    process.exit(1);
-                }
-                mindmap.add(mAgentId, mRest[0], mRest[1], mRest[2]);
-                break;
-            case 'remove':
-                if (!mAgentId || !mRest?.[0] || !mRest?.[1]) {
-                    console.log('Error: agent_id, from_id and to_id are required');
-                    process.exit(1);
-                }
-                mindmap.remove(mAgentId, mRest[0], mRest[1]);
-                break;
-            case 'html':
-                mindmap.html();
-                break;
-            case 'open':
-                mindmap.open(mAgentId);
-                break;
-            default:
-                console.log(`Unknown mindmap subcommand: ${subcommand}`);
-                process.exit(1);
-        }
-        return;
-    }
-    const engine = new engine_1.MemoryEngine();
-    if (resolvedCommand === 'summarize-dirty') {
-        engine.summarizeDirty();
-        return;
-    }
-    if (!agentId) {
-        console.log('Error: agent_id is required');
-        process.exit(1);
-    }
-    switch (resolvedCommand) {
-        case 'save': {
-            const summary = rest[0];
-            if (!summary) {
-                console.log('Error: summary is required');
-                process.exit(1);
-            }
-            let category;
-            if (rest[1] && types_1.CATEGORIES.includes(rest[1])) {
-                category = rest[1];
-            }
-            else {
-                category = 'general';
-                if (rest[1] && !options.tags) {
-                    options.tags = rest[1];
-                }
-            }
-            if (rest[2] && !options.body) {
-                options.body = rest[2];
-            }
-            if (!options.body && !process.stdin.isTTY) {
-                const stdinBody = await Promise.race([
-                    readStdin(),
-                    new Promise((resolve) => setTimeout(() => resolve(''), 100)),
-                ]);
-                if (stdinBody) {
-                    options.body = stdinBody;
-                }
-            }
-            engine.save(agentId, summary, category, options);
-            break;
-        }
-        case 'index':
-            engine.index(agentId, options);
-            break;
-        case 'list':
-            engine.list(agentId, options);
-            break;
-        case 'stats':
-            engine.stats(agentId);
-            break;
-        case 'tags':
-            if (rest[0]) {
-                engine.topic(agentId, rest[0]);
-            }
-            else {
-                engine.tags(agentId);
-            }
-            break;
-        case 'recent':
-            engine.recent(agentId, parseInt(rest[0] ?? '', 10) || 30);
-            break;
-        case 'find':
-            if (!rest[0]) {
-                console.log('Error: keyword is required');
-                process.exit(1);
-            }
-            engine.find(agentId, rest[0]);
-            break;
-        case 'get':
-            if (!rest[0]) {
-                console.log('Error: memory_id is required');
-                process.exit(1);
-            }
-            engine.get(agentId, rest[0]);
-            break;
-        case 'search':
-            if (!rest[0]) {
-                console.log('Error: query is required');
-                process.exit(1);
-            }
-            engine.search(agentId, rest.join(' '));
-            break;
-        case 'update':
-            if (!rest[0]) {
-                console.log('Error: memory_id is required');
-                process.exit(1);
-            }
-            engine.update(agentId, rest[0], options);
-            break;
-        case 'delete':
-            if (!rest[0]) {
-                console.log('Error: memory_id is required');
-                process.exit(1);
-            }
-            engine.delete(agentId, rest[0], options);
-            break;
-        case 'merge':
-            if (!rest[0] || !rest[1]) {
-                console.log('Error: two memory_ids are required');
-                console.log('Usage: node cli.ts merge <agent_id> <id1> <id2> [--summary="병합 요약"]');
-                process.exit(1);
-            }
-            engine.merge(agentId, rest[0], rest[1], options);
-            break;
-        case 'summarize':
-            engine.summarize(agentId, options);
-            break;
-        default:
-            console.log(`Unknown command: ${command}`);
-            process.exit(1);
-    }
-}
-if (require.main === module) {
-    loadTracer().then(tracer => {
-        const opts = tracer ? { skillVersion: tracer.getOwnSkillVersion(__dirname) } : {};
-        return tracer ? tracer.run('crewx/memory', () => main(), opts) : main();
-    }).catch((e) => {
-        console.error(e.message);
-        process.exit(1);
-    });
-}
-//# sourceMappingURL=cli.js.map
+`)}const j={read:"get",rm:"delete",ls:"recent"};const A=new Set(["help","force","verbose","full","important","no-important","json","all","version"]);function M(s){const r={positional:[],options:{}};for(let i=0;i<s.length;i++){const e=s[i];if(e==="-h"){r.options["help"]=true}else if(e.startsWith("--")){const t=e.indexOf("=");if(t!==-1){const n=e.slice(2,t);const o=e.slice(t+1);r.options[n]=o}else{const n=e.slice(2);if(!A.has(n)){const o=s[i+1];if(o!==void 0&&!o.startsWith("--")&&o!=="-h"){r.options[n]=o;i++}else{r.options[n]=true}}else{r.options[n]=true}}}else{r.positional.push(e)}}return r}async function b(s){const r=s??process.argv.slice(2);const{positional:i,options:e}=M(r);const[t,n,...o]=i;if(e.version){console.log(_);return}if(e.help){h();return}if(t==="usage"){O();return}if(t==="help"){h();return}if(!t){h();return}const g=j[t]??t;if(g==="mindmap"){const l=process.env["MEMORY_DATA_DIR"]??f.resolve(process.cwd(),"memory");const m=new S.MindmapEngine(l);const u=n;const c=o[0];const d=o.slice(1);if(!u){console.log("Usage: npx memory mindmap <subcommand> [agent_id] [args]");console.log("");console.log("Subcommands:");console.log("  build <agent_id>                                        - Build graph");console.log("  show <agent_id> [--period=stm|mtm|ltm] [--format=mermaid|text] - Graph summary");console.log("  related <agent_id> <memory_id>                          - View related memories");console.log("  add <agent_id> <from_id> <to_id> [type]                - Add manual relation");console.log("  remove <agent_id> <from_id> <to_id>                    - Remove relation");console.log("  html                                                    - Generate shared HTML");console.log("  open [agent_id]                                         - Open in browser");process.exit(1)}switch(u){case"build":if(!c){console.log("Error: agent_id is required");process.exit(1)}m.build(c,e);break;case"show":if(!c){console.log("Error: agent_id is required");process.exit(1)}m.show(c,{period:e.period,format:e.format});break;case"related":if(!c||!d?.[0]){console.log("Error: agent_id and memory_id are required");process.exit(1)}m.related(c,d[0]);break;case"add":if(!c||!d?.[0]||!d?.[1]){console.log("Error: agent_id, from_id and to_id are required");process.exit(1)}m.add(c,d[0],d[1],d[2]);break;case"remove":if(!c||!d?.[0]||!d?.[1]){console.log("Error: agent_id, from_id and to_id are required");process.exit(1)}m.remove(c,d[0],d[1]);break;case"html":m.html();break;case"open":m.open(c);break;default:console.log(`Unknown mindmap subcommand: ${u}`);process.exit(1)}return}const a=new k.MemoryEngine;if(g==="summarize-dirty"){a.summarizeDirty();return}if(!n){console.log("Error: agent_id is required");process.exit(1)}switch(g){case"save":{const l=o[0];if(!l){console.log("Error: summary is required");process.exit(1)}let m;if(o[1]&&x.CATEGORIES.includes(o[1])){m=o[1]}else{m="general";if(o[1]&&!e.tags){e.tags=o[1]}}if(o[2]&&!e.body){e.body=o[2]}if(!e.body&&!process.stdin.isTTY){const u=q();let c;try{c=await Promise.race([u.body,new Promise(d=>setTimeout(()=>d(""),100))])}finally{u.release()}if(c){e.body=c}}a.save(n,l,m,e);break}case"index":a.index(n,e);break;case"list":a.list(n,e);break;case"stats":a.stats(n);break;case"tags":if(o[0]){a.topic(n,o[0])}else{a.tags(n)}break;case"recent":a.recent(n,parseInt(o[0]??"",10)||30);break;case"find":if(!o[0]){console.log("Error: keyword is required");process.exit(1)}a.find(n,o[0]);break;case"get":if(!o[0]){console.log("Error: memory_id is required");process.exit(1)}a.get(n,o[0]);break;case"search":if(!o[0]){console.log("Error: query is required");process.exit(1)}a.search(n,o.join(" "));break;case"update":if(!o[0]){console.log("Error: memory_id is required");process.exit(1)}a.update(n,o[0],e);break;case"delete":if(!o[0]){console.log("Error: memory_id is required");process.exit(1)}a.delete(n,o[0],e);break;case"merge":if(!o[0]||!o[1]){console.log("Error: two memory_ids are required");console.log('Usage: node cli.ts merge <agent_id> <id1> <id2> [--summary="merge summary"]');process.exit(1)}a.merge(n,o[0],o[1],e);break;case"summarize":a.summarize(n,e);break;default:console.log(`Unknown command: ${t}`);process.exit(1)}}if(require.main===module){E().then(s=>{const r=s?{skillVersion:s.getOwnSkillVersion(__dirname)}:{};return s?s.run("crewx/memory",()=>b(),r):b()}).catch(s=>{console.error(s.message);process.exit(1)})}

package/dist/src/engine.d.ts

@@ -1,3 +1,5 @@
+export declare const SUMMARIZER_FAILURE_THRESHOLD = 3;
+export declare const SUMMARIZE_LOCK_STALE_MS: number;
 import { MemoryEntry, SaveOptions, IndexOptions, ListOptions, UpdateOptions, DeleteOptions, MergeOptions, SummarizeOptions, SummaryResult, MemoryEngineConfig } from './types';
 export declare function getMemoryConfig(): Record<string, unknown>;
 export declare class MemoryEngine {
@@ -9,11 +11,18 @@ export declare class MemoryEngine {
     private readonly searcherAgent;
     private readonly summarizerTimeout;
     private readonly searcherTimeout;
+    private readonly searchIndexCache;
     constructor(config?: MemoryEngineConfig);
     private getAgentDir;
     private getEntriesDir;
+    private getEntryFilesFingerprint;
+    private buildSearchIndex;
+    private getSearchIndex;
+    private invalidateSearchIndex;
+    private createFindActionContext;
     private getSummaryPath;
     private getDirtySummaryPath;
+    private getSummarizeLockPath;
     private ensureDir;
     private generateId;
     private getToday;
@@ -21,6 +30,12 @@ export declare class MemoryEngine {
     private getPrimaryTag;
     private toEntryTimestamp;
     private markSummaryDirty;
+    private getSummarizerHealthPath;
+    private readSummarizerHealth;
+    private writeSummarizerHealth;
+    private recordSummarizerFailure;
+    private recordSummarizerSuccess;
+    private notifySummarizerDegraded;
     loadAllEntries(agentId: string): MemoryEntry[];
     private findEntryById;
     save(agentId: string, summary: string, category?: string, options?: SaveOptions): void;
@@ -28,6 +43,12 @@ export declare class MemoryEngine {
     private generateIndexContent;
     topic(agentId: string, topicName: string): void;
     recent(agentId: string, days?: number): void;
+    getRecentEntries(agentId: string, days?: number, opts?: {
+        includeBody?: boolean;
+    }): MemoryEntry[];
+    private resolveRecentDate;
+    private toDateString;
+    private readEntryBody;
     find(agentId: string, keyword: string): void;
     list(agentId: string, options?: ListOptions): void;
     stats(agentId: string): void;
@@ -40,9 +61,12 @@ export declare class MemoryEngine {
     private callSummarizer;
     generateSummary(agentId: string, options?: SummarizeOptions): SummaryResult;
     summarize(agentId: string, options?: SummarizeOptions): void;
+    private isSummarizeLockStale;
+    private acquireSummarizeLock;
+    private releaseSummarizeLock;
     summarizeDirty(): void;
     search(agentId: string, query: string): void;
 }
 export declare function createMemoryEngine(config?: MemoryEngineConfig): MemoryEngine;
 export { CATEGORIES, MemoryCategory } from './types';
-//# sourceMappingURL=engine.d.ts.map
+