@easbot/memory 0.3.21 → 0.3.22
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/chunks/{chunk-TIZCWDJ7.mjs → chunk-5DCNLEAC.mjs} +1 -1
- package/dist/chunks/{chunk-AYGZUNFR.cjs → chunk-ECTHWVFQ.cjs} +1 -1
- package/dist/chunks/{chunk-EGWJG65Q.cjs → chunk-EK34SXJ7.cjs} +24 -17
- package/dist/chunks/{chunk-JDPZ5U53.mjs → chunk-PJGILQSZ.mjs} +24 -17
- package/dist/chunks/{chunk-N5YRDTEH.mjs → chunk-WDGBZHIS.mjs} +33 -27
- package/dist/chunks/chunk-YAKGP77O.cjs +65 -0
- package/dist/chunks/{chunk-S6S35LDL.cjs → chunk-YYCHHBMU.cjs} +36 -30
- package/dist/chunks/chunk-ZIFDM4GO.mjs +65 -0
- package/dist/chunks/cli-handler-T3G2REK3.mjs +1 -0
- package/dist/chunks/cli-handler-YQEIJ6L2.cjs +1 -0
- package/dist/chunks/{config-RPPQ73HK.cjs → config-I2I6U4XM.cjs} +1 -1
- package/dist/chunks/consolidate-FWRCKNBO.mjs +2 -0
- package/dist/chunks/{consolidate-G4YJV756.cjs → consolidate-GQ5KCVWW.cjs} +1 -1
- package/dist/chunks/doctor-SYBFGZAM.cjs +1 -0
- package/dist/chunks/{doctor-GKMREWZN.mjs → doctor-Z4MRWUSA.mjs} +1 -1
- package/dist/chunks/{extract-YKDPZ7GA.cjs → extract-HBIYSJRI.cjs} +1 -1
- package/dist/chunks/extract-LUBUHISD.mjs +2 -0
- package/dist/chunks/{forget-GNIJL2DU.cjs → forget-C7DNK4TJ.cjs} +1 -1
- package/dist/chunks/{forget-VQB5DUJ3.mjs → forget-MSXKORPW.mjs} +1 -1
- package/dist/chunks/{graph-4W63TU2D.mjs → graph-HKBJTVVV.mjs} +1 -1
- package/dist/chunks/{graph-GTYUNUJE.cjs → graph-ONZARVEF.cjs} +1 -1
- package/dist/chunks/{init-DGMGRNCG.cjs → init-AL4IZIBJ.cjs} +1 -1
- package/dist/chunks/init-GVYXEMZ3.mjs +1 -0
- package/dist/chunks/{interfaces-XWE45ENK.cjs → interfaces-Q5OGU5EK.cjs} +1 -1
- package/dist/chunks/{llm-RMPVWEVP.cjs → llm-7LQGYSUE.cjs} +1 -1
- package/dist/chunks/{mcp-EHUKGJRB.cjs → mcp-NAE5FPNQ.cjs} +1 -1
- package/dist/chunks/{mcp-QQBHEZFY.mjs → mcp-OZFKMFEM.mjs} +1 -1
- package/dist/chunks/{recall-ZENMAOMJ.cjs → recall-V7XEE6MG.cjs} +1 -1
- package/dist/chunks/recall-W4WBZG5W.mjs +2 -0
- package/dist/chunks/{remember-3ZY66RJQ.cjs → remember-5H5A6O5I.cjs} +1 -1
- package/dist/chunks/{remember-P3G7WWYB.mjs → remember-XBPCHY4Q.mjs} +1 -1
- package/dist/chunks/{status-JYI52QKB.mjs → status-SKO36F6J.mjs} +1 -1
- package/dist/chunks/status-ZX25EAH7.cjs +1 -0
- package/dist/chunks/stdio-server-EORG6GVP.mjs +1 -0
- package/dist/chunks/stdio-server-NHPVPW5A.cjs +1 -0
- package/dist/chunks/{sync-64JINCSC.cjs → sync-3L57TMXR.cjs} +1 -1
- package/dist/chunks/{sync-ZPRCA4MO.mjs → sync-L5XS442K.mjs} +1 -1
- package/dist/cli.cjs +1 -1
- package/dist/cli.mjs +1 -1
- package/dist/index.cjs +4 -4
- package/dist/index.d.cts +24 -1
- package/dist/index.d.ts +24 -1
- package/dist/index.mjs +4 -4
- package/package.json +10 -10
- package/dist/chunks/chunk-UF2Y2Q4L.mjs +0 -50
- package/dist/chunks/chunk-Z5E4HBGK.cjs +0 -50
- package/dist/chunks/cli-handler-2IPBL45N.cjs +0 -1
- package/dist/chunks/cli-handler-5YNHYDSM.mjs +0 -1
- package/dist/chunks/consolidate-MSPLH3T6.mjs +0 -2
- package/dist/chunks/doctor-YTUQCHFJ.cjs +0 -1
- package/dist/chunks/extract-3C4QFS7E.mjs +0 -2
- package/dist/chunks/init-G2WTR477.mjs +0 -1
- package/dist/chunks/recall-SGA2DITO.mjs +0 -2
- package/dist/chunks/status-UEKBJVCI.cjs +0 -1
- package/dist/chunks/stdio-server-2PWTBTDJ.mjs +0 -1
- package/dist/chunks/stdio-server-JL4XNUHH.cjs +0 -1
- /package/dist/chunks/{chunk-NVGACA7W.cjs → chunk-M2YU5LAI.cjs} +0 -0
package/dist/index.cjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
'use strict';require('./chunks/chunk-URADAZYW.cjs');var
|
|
1
|
+
'use strict';require('./chunks/chunk-URADAZYW.cjs');var chunkECTHWVFQ_cjs=require('./chunks/chunk-ECTHWVFQ.cjs'),chunkYYCHHBMU_cjs=require('./chunks/chunk-YYCHHBMU.cjs'),chunkYAKGP77O_cjs=require('./chunks/chunk-YAKGP77O.cjs'),chunkEK34SXJ7_cjs=require('./chunks/chunk-EK34SXJ7.cjs'),chunkCPRDIUQ4_cjs=require('./chunks/chunk-CPRDIUQ4.cjs'),chunkJ5XF2W4Z_cjs=require('./chunks/chunk-J5XF2W4Z.cjs'),chunkM2YU5LAI_cjs=require('./chunks/chunk-M2YU5LAI.cjs'),types=require('@easbot/types'),d=require('jieba-wasm'),utils=require('@easbot/utils'),crypto=require('crypto');function _interopNamespace(e){if(e&&e.__esModule)return e;var n=Object.create(null);if(e){Object.keys(e).forEach(function(k){if(k!=='default'){var d=Object.getOwnPropertyDescriptor(e,k);Object.defineProperty(n,k,d.get?d:{enumerable:true,get:function(){return e[k]}});}})}n.default=e;return Object.freeze(n)}var d__namespace=/*#__PURE__*/_interopNamespace(d);var Se=["user_preference","task_context","technical_fact","decision","relationship","reminder","error_pattern","workflow","exploration_finding","experience_summary","tool_usage","skill_creation","test","other"],p=class extends Error{constructor(t,o,n){super(t,{cause:n});chunkM2YU5LAI_cjs.a(this,"code",o);chunkM2YU5LAI_cjs.a(this,"cause",n);this.name="MemoryError";}},N=class extends p{constructor(r,t){super(r,"MEMORY_VALIDATION_ERROR",t),this.name="MemoryValidationError";}},D=class extends p{constructor(r){super(`Memory not found: ${r}`,"MEMORY_NOT_FOUND"),this.name="MemoryNotFoundError";}},T=class extends p{constructor(r){super(r,"MEMORY_PERMISSION_ERROR"),this.name="MemoryPermissionError";}},v=class extends p{constructor(r,t){super(r,"MEMORY_DATABASE_ERROR",t),this.name="MemoryDatabaseError";}},F=class extends p{constructor(r,t){super(r,"MEMORY_FILE_ERROR",t),this.name="MemoryFileError";}},L=class extends p{constructor(r,t){super(r,"MEMORY_SEARCH_ERROR",t),this.name="MemorySearchError";}},$=class extends p{constructor(r,t){super(r,"MEMORY_EMBEDDING_ERROR",t),this.name="MemoryEmbeddingError";}},ue=(a=>(a.VALIDATION_ERROR="MEMORY_VALIDATION_ERROR",a.NOT_FOUND="MEMORY_NOT_FOUND",a.PERMISSION_ERROR="MEMORY_PERMISSION_ERROR",a.DATABASE_ERROR="MEMORY_DATABASE_ERROR",a.FILE_ERROR="MEMORY_FILE_ERROR",a.SEARCH_ERROR="MEMORY_SEARCH_ERROR",a.EMBEDDING_ERROR="MEMORY_EMBEDDING_ERROR",a))(ue||{});var s=utils.Log.create({service:"memory.tokenizer"}),l=false,Re=utils.loadTextFile("./assets/jieba_dict.txt",chunkM2YU5LAI_cjs.b);async function Fe(e){if(!l)try{s.debug("Initializing jieba tokenizer");let r=Re();if(d__namespace.with_dict(r),s.debug("Built-in dictionary loaded"),e?.dictPath&&e.dictPath.length>0)for(let t of e.dictPath)await ke(t);l=!0,s.debug("Jieba tokenizer initialized successfully");}catch(r){s.error("Failed to initialize jieba tokenizer",{error:String(r)}),s.warn("Using fallback tokenization (space-based)");}}async function ke(e){if(!l)throw new Error("Tokenizer not initialized");try{let r=await utils.Filesystem.readText(e);s.debug("Loading custom dictionary",{dictPath:e}),d__namespace.with_dict(r),s.debug("Custom dictionary loaded successfully",{dictPath:e});}catch(r){s.warn("Failed to load custom dictionary",{dictPath:e,error:String(r)});}}function xe(e){if(!l)return e.split(/\s+/).filter(Boolean);try{return d__namespace.cut(e)}catch(r){return s.warn("Tokenization failed, using fallback",{error:String(r)}),e.split(/\s+/).filter(Boolean)}}function He(e){if(!l)return e.split(/\s+/).filter(Boolean);try{return d__namespace.cut_for_search(e)}catch(r){return s.warn("Tokenization for search failed, using fallback",{error:String(r)}),e.split(/\s+/).filter(Boolean)}}function Le(e,r,t){if(l)try{d__namespace.add_word(e,r,t),s.debug("Word added to dictionary",{word:e,freq:r,tag:t});}catch(o){s.warn("Failed to add word",{word:e,error:String(o)});}}function $e(){return l}async function je(){l=false,s.debug("Tokenizer closed");}function ze(e){if(!l)return e.split(/\s+/).filter(Boolean).join(" ");try{return xe(e).join(" ")}catch(r){return s.warn("Tokenization failed, using fallback",{error:String(r)}),e.split(/\s+/).filter(Boolean).join(" ")}}function Ye(e){if(!l)return e.split(/\s+/).filter(Boolean).join(" ");try{return He(e).join(" ")}catch(r){return s.warn("Tokenization for search failed, using fallback",{error:String(r)}),e.split(/\s+/).filter(Boolean).join(" ")}}function m(e){let r=chunkCPRDIUQ4_cjs.f().worktree,t=chunkCPRDIUQ4_cjs.j(r);return {agentId:e,isTrustedLocal:true,remote:false,locale:"en-US",dbPath:t,workspaceDir:r,rootDir:r,config:chunkYAKGP77O_cjs.x({agentId:e,dbPath:t,workspaceDir:r})}}var j=async e=>{if(!e.agentId?.trim())return {ok:false,error:"session-start: agentId is required in ctx"};let r=e.extras?.topK??5,t=e.extras?.query??"";try{let o=await chunkYAKGP77O_cjs.w("recall",{query:t,maxResults:r},m(e.agentId));if(o.hits.length===0)return {ok:!0,injected:"",logLine:"session-start: no facts found for agent; skipping context injection"};let n=o.hits.map(y=>`- [${y.category}/imp=${y.importance}] ${y.snippet.slice(0,200)}`);return {ok:!0,injected:`[memory:session-start recall top-${o.hits.length}]
|
|
2
2
|
${n.join(`
|
|
3
|
-
`)}`,logLine:`session-start: injected ${o.hits.length} facts into context (agent=${e.agentId})`}}catch(o){return {ok:false,error:o instanceof Error?o.message:String(o)}}};var
|
|
3
|
+
`)}`,logLine:`session-start: injected ${o.hits.length} facts into context (agent=${e.agentId})`}}catch(o){return {ok:false,error:o instanceof Error?o.message:String(o)}}};var z=async e=>{if(!e.agentId?.trim())return {ok:false,error:"session-end: agentId is required in ctx"};let r=e.extras?.windowDays??1;try{let t=await chunkYAKGP77O_cjs.w("consolidate",{windowDays:r},m(e.agentId));return {ok:!0,logLine:`session-end: total=${t.totalFacts}, deduped=${t.dedupedCount}, archived=${t.archivedCount}, skipped=${t.skippedCount}`}}catch(t){return {ok:false,error:t instanceof Error?t.message:String(t)}}};var Y=async e=>{if(!e.agentId?.trim())return {ok:false,error:"pre-compact: agentId is required in ctx"};let t=(e.contextPreview??e.messagePreview??"").slice(0,200).replace(/\s+/g," ").trim(),o=e.extras?.topK??3;if(!t)return {ok:true,injected:"",logLine:"pre-compact: empty contextPreview; skipping recall injection"};try{let n=await chunkYAKGP77O_cjs.w("recall",{query:t,maxResults:o,minImportance:5},m(e.agentId));if(n.hits.length===0)return {ok:!0,injected:"",logLine:`pre-compact: no facts matched query for agent=${e.agentId}`};let H=n.hits.map(a=>`- [${a.category}/imp=${a.importance}] ${a.snippet.slice(0,150)}`);return {ok:!0,injected:`[memory:pre-compact recall top-${n.hits.length} (imp>=5)]
|
|
4
4
|
${H.join(`
|
|
5
|
-
`)}`,logLine:`pre-compact: injected ${n.hits.length} facts before compaction`}}catch(n){return {ok:false,error:n instanceof Error?n.message:String(n)}}};var
|
|
6
|
-
`);try{return {ok:!0,logLine:`post-tool-failure: wrote error_pattern fact ${(await
|
|
5
|
+
`)}`,logLine:`pre-compact: injected ${n.hits.length} facts before compaction`}}catch(n){return {ok:false,error:n instanceof Error?n.message:String(n)}}};var G=async e=>{if(!e.agentId?.trim())return {ok:false,error:"post-tool-failure: agentId is required in ctx"};if(!e.toolName?.trim()||!e.error?.trim())return {ok:false,error:"post-tool-failure: toolName and error are required in ctx"};let r=crypto.createHash("sha256").update(`${e.toolName}:${e.error}`).digest("hex").slice(0,8),t=e.messagePreview?e.messagePreview.slice(0,200).replace(/\s+/g," ").trim():"",o=[`[error_pattern] tool=${e.toolName}`,`[error] ${e.error}`,t?`[preview] ${t}`:"",`[errHash] ${r}`].filter(Boolean).join(`
|
|
6
|
+
`);try{return {ok:!0,logLine:`post-tool-failure: wrote error_pattern fact ${(await chunkYAKGP77O_cjs.w("remember",{content:o,category:"error_pattern",importance:6,tags:["post-tool-failure",`tool:${e.toolName}`,`err:${r}`],sessionId:e.sessionId,msgId:e.extras?.msgId},m(e.agentId))).fact.id} (tool=${e.toolName}, errHash=${r})`}}catch(n){return {ok:false,error:n instanceof Error?n.message:String(n)}}};var u=utils.Log.create({service:"memory.hooks"}),g=new Map;function f(e,r){let t={name:e,handler:r,registeredAt:new Date().toISOString()},o=g.get(e);g.set(e,t),o?u.info("Hook overwritten",{name:e,prevRegisteredAt:o.registeredAt,newRegisteredAt:t.registeredAt}):u.info("Hook registered",{name:e,registeredAt:t.registeredAt});}function Ie(e){return g.delete(e)}function be(){return Array.from(g.values()).map(e=>({name:e.name,handler:e.handler,registeredAt:e.registeredAt}))}function Me(){f("session-start",j),f("session-end",z),f("pre-compact",Y),f("post-tool-failure",G);}function _e(){g.clear(),u.debug("All hooks cleared");}async function Oe(e,r){let t=g.get(e);if(!t)return u.debug("dispatchHook: no handler registered; noop",{name:e}),{ok:true,logLine:`hook ${e} not registered; noop`};try{let o=await t.handler(r);return o.ok?o.logLine&&u.debug("dispatchHook: ok",{name:e,logLine:o.logLine}):u.warn("dispatchHook: handler returned failure",{name:e,agentId:r.agentId,error:o.error}),o}catch(o){let n=o instanceof Error?o.message:String(o);return u.warn("dispatchHook: handler threw, caught and converted to failure result",{name:e,agentId:r.agentId,error:n}),{ok:false,error:n}}}Object.defineProperty(exports,"COMMANDS_HELP",{enumerable:true,get:function(){return chunkECTHWVFQ_cjs.a}});Object.defineProperty(exports,"handleMemoryCli",{enumerable:true,get:function(){return chunkECTHWVFQ_cjs.d}});Object.defineProperty(exports,"renderBanner",{enumerable:true,get:function(){return chunkECTHWVFQ_cjs.b}});Object.defineProperty(exports,"renderHelp",{enumerable:true,get:function(){return chunkECTHWVFQ_cjs.c}});Object.defineProperty(exports,"MemoryStdioServer",{enumerable:true,get:function(){return chunkYYCHHBMU_cjs.b}});Object.defineProperty(exports,"renderOperationMarkdown",{enumerable:true,get:function(){return chunkYYCHHBMU_cjs.a}});Object.defineProperty(exports,"ALL_OPS",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.v}});Object.defineProperty(exports,"GraphStore",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.a}});Object.defineProperty(exports,"OP_REGISTRY",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.u}});Object.defineProperty(exports,"consolidate",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.o}});Object.defineProperty(exports,"doctor",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.t}});Object.defineProperty(exports,"executeOp",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.w}});Object.defineProperty(exports,"extract",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.n}});Object.defineProperty(exports,"forget",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.m}});Object.defineProperty(exports,"graphQuery",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.q}});Object.defineProperty(exports,"init",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.r}});Object.defineProperty(exports,"recall",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.b}});Object.defineProperty(exports,"remember",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.k}});Object.defineProperty(exports,"status",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.s}});Object.defineProperty(exports,"sync",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.p}});Object.defineProperty(exports,"update",{enumerable:true,get:function(){return chunkYAKGP77O_cjs.l}});Object.defineProperty(exports,"LATEST_SCHEMA_VERSION",{enumerable:true,get:function(){return chunkEK34SXJ7_cjs.a}});Object.defineProperty(exports,"MIGRATIONS",{enumerable:true,get:function(){return chunkEK34SXJ7_cjs.b}});Object.defineProperty(exports,"MemoryDatabaseManager",{enumerable:true,get:function(){return chunkEK34SXJ7_cjs.e}});Object.defineProperty(exports,"readCurrentSchemaVersion",{enumerable:true,get:function(){return chunkEK34SXJ7_cjs.d}});Object.defineProperty(exports,"runMigrations",{enumerable:true,get:function(){return chunkEK34SXJ7_cjs.c}});Object.defineProperty(exports,"getGlobal",{enumerable:true,get:function(){return chunkCPRDIUQ4_cjs.c}});Object.defineProperty(exports,"getHomeDir",{enumerable:true,get:function(){return chunkCPRDIUQ4_cjs.g}});Object.defineProperty(exports,"getInstance",{enumerable:true,get:function(){return chunkCPRDIUQ4_cjs.f}});Object.defineProperty(exports,"getMemoryDbPath",{enumerable:true,get:function(){return chunkCPRDIUQ4_cjs.j}});Object.defineProperty(exports,"getMemoryDir",{enumerable:true,get:function(){return chunkCPRDIUQ4_cjs.i}});Object.defineProperty(exports,"getXdgData",{enumerable:true,get:function(){return chunkCPRDIUQ4_cjs.h}});Object.defineProperty(exports,"resetGlobalAdapter",{enumerable:true,get:function(){return chunkCPRDIUQ4_cjs.b}});Object.defineProperty(exports,"resetInstanceAdapter",{enumerable:true,get:function(){return chunkCPRDIUQ4_cjs.e}});Object.defineProperty(exports,"setGlobalAdapter",{enumerable:true,get:function(){return chunkCPRDIUQ4_cjs.a}});Object.defineProperty(exports,"setInstanceAdapter",{enumerable:true,get:function(){return chunkCPRDIUQ4_cjs.d}});Object.defineProperty(exports,"Llm",{enumerable:true,get:function(){return chunkJ5XF2W4Z_cjs.a}});Object.defineProperty(exports,"GRAPH_ENTITY_TYPE_DEFINITIONS",{enumerable:true,get:function(){return types.GRAPH_ENTITY_TYPE_DEFINITIONS}});Object.defineProperty(exports,"GRAPH_RELATION_TYPE_DEFINITIONS",{enumerable:true,get:function(){return types.GRAPH_RELATION_TYPE_DEFINITIONS}});exports.MEMORY_CATEGORIES=Se;exports.MemoryDatabaseError=v;exports.MemoryEmbeddingError=$;exports.MemoryError=p;exports.MemoryErrorCode=ue;exports.MemoryFileError=F;exports.MemoryNotFoundError=D;exports.MemoryPermissionError=T;exports.MemorySearchError=L;exports.MemoryValidationError=N;exports.addWord=Le;exports.clearAllHooks=_e;exports.closeTokenizer=je;exports.dispatchHook=Oe;exports.initTokenizer=Fe;exports.isInitialized=$e;exports.listHooks=be;exports.loadCustomDict=ke;exports.registerAllDefaultHooks=Me;exports.registerHook=f;exports.toFtsTokens=ze;exports.toFtsTokensForSearch=Ye;exports.tokenize=xe;exports.tokenizeForSearch=He;exports.unregisterHook=Ie;
|
package/dist/index.d.cts
CHANGED
|
@@ -45,6 +45,7 @@ interface MemoryRecallResult {
|
|
|
45
45
|
category: MemoryCategory;
|
|
46
46
|
importance: number;
|
|
47
47
|
agentId: string;
|
|
48
|
+
content: string;
|
|
48
49
|
snippet: string;
|
|
49
50
|
score: number;
|
|
50
51
|
createdAt: string;
|
|
@@ -58,6 +59,11 @@ interface MemoryRecallResult {
|
|
|
58
59
|
direction?: 'in' | 'out';
|
|
59
60
|
}>;
|
|
60
61
|
}>;
|
|
62
|
+
tags?: string[];
|
|
63
|
+
sessionId?: string;
|
|
64
|
+
msgId?: string;
|
|
65
|
+
parentMsgId?: string;
|
|
66
|
+
updatedAt?: string;
|
|
61
67
|
}
|
|
62
68
|
type MemorySystemConfig = MemoryKnowledgeConfigWithModels;
|
|
63
69
|
declare class MemoryError extends Error {
|
|
@@ -253,6 +259,19 @@ interface ForgetResult {
|
|
|
253
259
|
dryRun: boolean;
|
|
254
260
|
truncatedCount: number;
|
|
255
261
|
}
|
|
262
|
+
interface UpdateParams {
|
|
263
|
+
factId: string;
|
|
264
|
+
content?: string;
|
|
265
|
+
category?: MemoryCategory;
|
|
266
|
+
importance?: number;
|
|
267
|
+
tags?: string[];
|
|
268
|
+
}
|
|
269
|
+
interface UpdateResult {
|
|
270
|
+
fact: MemoryFact;
|
|
271
|
+
contentChanged: boolean;
|
|
272
|
+
fieldsUpdated: string[];
|
|
273
|
+
durationMs: number;
|
|
274
|
+
}
|
|
256
275
|
interface ExtractParams {
|
|
257
276
|
sessionId: string;
|
|
258
277
|
lastN?: number;
|
|
@@ -332,6 +351,7 @@ interface DoctorResult extends KnowledgeDoctorResult {
|
|
|
332
351
|
memory_facts_fts: number;
|
|
333
352
|
nodes: number;
|
|
334
353
|
edges: number;
|
|
354
|
+
fact_nodes: number;
|
|
335
355
|
meta: number;
|
|
336
356
|
schema_migrations: number;
|
|
337
357
|
};
|
|
@@ -383,6 +403,8 @@ declare function recall(ctx: MemoryServiceContext, params: RecallParams): Promis
|
|
|
383
403
|
|
|
384
404
|
declare function remember(ctx: MemoryServiceContext, params: RememberParams): Promise<RememberResult>;
|
|
385
405
|
|
|
406
|
+
declare function update(ctx: MemoryServiceContext, params: UpdateParams): Promise<UpdateResult>;
|
|
407
|
+
|
|
386
408
|
declare function forget(ctx: MemoryServiceContext, params: ForgetParams): Promise<ForgetResult>;
|
|
387
409
|
|
|
388
410
|
declare function extract(ctx: MemoryServiceContext, params: ExtractParams): Promise<ExtractResult>;
|
|
@@ -577,6 +599,7 @@ declare class MemoryDatabaseManager {
|
|
|
577
599
|
memory_facts_fts: number;
|
|
578
600
|
nodes: number;
|
|
579
601
|
edges: number;
|
|
602
|
+
fact_nodes: number;
|
|
580
603
|
meta: number;
|
|
581
604
|
schema_migrations: number;
|
|
582
605
|
};
|
|
@@ -630,4 +653,4 @@ declare function registerAllDefaultHooks(): void;
|
|
|
630
653
|
declare function clearAllHooks(): void;
|
|
631
654
|
declare function dispatchHook(name: HookName, ctx: HookContext): Promise<HookResult>;
|
|
632
655
|
|
|
633
|
-
export { ALL_OPS, type ArchiveRecord, type ArchiveResult, COMMANDS_HELP, type CommandHelp, type ConsolidateParams, type ConsolidateResult, type DoctorResult, type EdgeQueryFilter, type ErrorCode, type ExtractParams, type ExtractResult, type ForgetParams, type ForgetResult, type GraphQueryParams, type GraphQueryResult, GraphStore, type HookContext, type HookHandler, type HookName, type HookResult, type InitParams, type InitResult, type KGScope, LATEST_SCHEMA_VERSION, Llm, type LlmInitConfig, type LlmModels, MEMORY_CATEGORIES, MIGRATIONS, type MemoryCategory, type MemoryCliDeps, type MemoryCliResult, MemoryDatabaseError, MemoryDatabaseManager, type MemoryEdge, MemoryEmbeddingError, MemoryError, MemoryErrorCode, type MemoryFact, MemoryFileError, type MemoryNode, type MemoryNodeWithEdges, MemoryNotFoundError, type MemoryOp, MemoryPermissionError, type MemoryQuery, type MemoryRecallResult, MemorySearchError, type MemorySource, MemoryStdioServer, type MemorySystemConfig, MemoryValidationError, type MemoryVector, type NodeQueryFilter, OP_REGISTRY, type OpAnnotations, type OpHandlerContext, type OpScope, type RecallParams, type RecallResult, type RegisteredHook, type RememberParams, type RememberResult, type StatusResult, type SyncParams, type SyncResult, addWord, clearAllHooks, closeTokenizer, consolidate, dispatchHook, doctor, executeOp, extract, forget, getGlobal, getHomeDir, getInstance, getMemoryDbPath, getMemoryDir, getXdgData, graphQuery, handleMemoryCli, init, initTokenizer, isInitialized, listHooks, loadCustomDict, readCurrentSchemaVersion, recall, registerAllDefaultHooks, registerHook, remember, renderBanner, renderHelp, renderOperationMarkdown, resetGlobalAdapter, resetInstanceAdapter, runMigrations, setGlobalAdapter, setInstanceAdapter, status, sync, toFtsTokens, toFtsTokensForSearch, tokenize, tokenizeForSearch, unregisterHook };
|
|
656
|
+
export { ALL_OPS, type ArchiveRecord, type ArchiveResult, COMMANDS_HELP, type CommandHelp, type ConsolidateParams, type ConsolidateResult, type DoctorResult, type EdgeQueryFilter, type ErrorCode, type ExtractParams, type ExtractResult, type ForgetParams, type ForgetResult, type GraphQueryParams, type GraphQueryResult, GraphStore, type HookContext, type HookHandler, type HookName, type HookResult, type InitParams, type InitResult, type KGScope, LATEST_SCHEMA_VERSION, Llm, type LlmInitConfig, type LlmModels, MEMORY_CATEGORIES, MIGRATIONS, type MemoryCategory, type MemoryCliDeps, type MemoryCliResult, MemoryDatabaseError, MemoryDatabaseManager, type MemoryEdge, MemoryEmbeddingError, MemoryError, MemoryErrorCode, type MemoryFact, MemoryFileError, type MemoryNode, type MemoryNodeWithEdges, MemoryNotFoundError, type MemoryOp, MemoryPermissionError, type MemoryQuery, type MemoryRecallResult, MemorySearchError, type MemorySource, MemoryStdioServer, type MemorySystemConfig, MemoryValidationError, type MemoryVector, type NodeQueryFilter, OP_REGISTRY, type OpAnnotations, type OpHandlerContext, type OpScope, type RecallParams, type RecallResult, type RegisteredHook, type RememberParams, type RememberResult, type StatusResult, type SyncParams, type SyncResult, type UpdateParams, type UpdateResult, addWord, clearAllHooks, closeTokenizer, consolidate, dispatchHook, doctor, executeOp, extract, forget, getGlobal, getHomeDir, getInstance, getMemoryDbPath, getMemoryDir, getXdgData, graphQuery, handleMemoryCli, init, initTokenizer, isInitialized, listHooks, loadCustomDict, readCurrentSchemaVersion, recall, registerAllDefaultHooks, registerHook, remember, renderBanner, renderHelp, renderOperationMarkdown, resetGlobalAdapter, resetInstanceAdapter, runMigrations, setGlobalAdapter, setInstanceAdapter, status, sync, toFtsTokens, toFtsTokensForSearch, tokenize, tokenizeForSearch, unregisterHook, update };
|
package/dist/index.d.ts
CHANGED
|
@@ -45,6 +45,7 @@ interface MemoryRecallResult {
|
|
|
45
45
|
category: MemoryCategory;
|
|
46
46
|
importance: number;
|
|
47
47
|
agentId: string;
|
|
48
|
+
content: string;
|
|
48
49
|
snippet: string;
|
|
49
50
|
score: number;
|
|
50
51
|
createdAt: string;
|
|
@@ -58,6 +59,11 @@ interface MemoryRecallResult {
|
|
|
58
59
|
direction?: 'in' | 'out';
|
|
59
60
|
}>;
|
|
60
61
|
}>;
|
|
62
|
+
tags?: string[];
|
|
63
|
+
sessionId?: string;
|
|
64
|
+
msgId?: string;
|
|
65
|
+
parentMsgId?: string;
|
|
66
|
+
updatedAt?: string;
|
|
61
67
|
}
|
|
62
68
|
type MemorySystemConfig = MemoryKnowledgeConfigWithModels;
|
|
63
69
|
declare class MemoryError extends Error {
|
|
@@ -253,6 +259,19 @@ interface ForgetResult {
|
|
|
253
259
|
dryRun: boolean;
|
|
254
260
|
truncatedCount: number;
|
|
255
261
|
}
|
|
262
|
+
interface UpdateParams {
|
|
263
|
+
factId: string;
|
|
264
|
+
content?: string;
|
|
265
|
+
category?: MemoryCategory;
|
|
266
|
+
importance?: number;
|
|
267
|
+
tags?: string[];
|
|
268
|
+
}
|
|
269
|
+
interface UpdateResult {
|
|
270
|
+
fact: MemoryFact;
|
|
271
|
+
contentChanged: boolean;
|
|
272
|
+
fieldsUpdated: string[];
|
|
273
|
+
durationMs: number;
|
|
274
|
+
}
|
|
256
275
|
interface ExtractParams {
|
|
257
276
|
sessionId: string;
|
|
258
277
|
lastN?: number;
|
|
@@ -332,6 +351,7 @@ interface DoctorResult extends KnowledgeDoctorResult {
|
|
|
332
351
|
memory_facts_fts: number;
|
|
333
352
|
nodes: number;
|
|
334
353
|
edges: number;
|
|
354
|
+
fact_nodes: number;
|
|
335
355
|
meta: number;
|
|
336
356
|
schema_migrations: number;
|
|
337
357
|
};
|
|
@@ -383,6 +403,8 @@ declare function recall(ctx: MemoryServiceContext, params: RecallParams): Promis
|
|
|
383
403
|
|
|
384
404
|
declare function remember(ctx: MemoryServiceContext, params: RememberParams): Promise<RememberResult>;
|
|
385
405
|
|
|
406
|
+
declare function update(ctx: MemoryServiceContext, params: UpdateParams): Promise<UpdateResult>;
|
|
407
|
+
|
|
386
408
|
declare function forget(ctx: MemoryServiceContext, params: ForgetParams): Promise<ForgetResult>;
|
|
387
409
|
|
|
388
410
|
declare function extract(ctx: MemoryServiceContext, params: ExtractParams): Promise<ExtractResult>;
|
|
@@ -577,6 +599,7 @@ declare class MemoryDatabaseManager {
|
|
|
577
599
|
memory_facts_fts: number;
|
|
578
600
|
nodes: number;
|
|
579
601
|
edges: number;
|
|
602
|
+
fact_nodes: number;
|
|
580
603
|
meta: number;
|
|
581
604
|
schema_migrations: number;
|
|
582
605
|
};
|
|
@@ -630,4 +653,4 @@ declare function registerAllDefaultHooks(): void;
|
|
|
630
653
|
declare function clearAllHooks(): void;
|
|
631
654
|
declare function dispatchHook(name: HookName, ctx: HookContext): Promise<HookResult>;
|
|
632
655
|
|
|
633
|
-
export { ALL_OPS, type ArchiveRecord, type ArchiveResult, COMMANDS_HELP, type CommandHelp, type ConsolidateParams, type ConsolidateResult, type DoctorResult, type EdgeQueryFilter, type ErrorCode, type ExtractParams, type ExtractResult, type ForgetParams, type ForgetResult, type GraphQueryParams, type GraphQueryResult, GraphStore, type HookContext, type HookHandler, type HookName, type HookResult, type InitParams, type InitResult, type KGScope, LATEST_SCHEMA_VERSION, Llm, type LlmInitConfig, type LlmModels, MEMORY_CATEGORIES, MIGRATIONS, type MemoryCategory, type MemoryCliDeps, type MemoryCliResult, MemoryDatabaseError, MemoryDatabaseManager, type MemoryEdge, MemoryEmbeddingError, MemoryError, MemoryErrorCode, type MemoryFact, MemoryFileError, type MemoryNode, type MemoryNodeWithEdges, MemoryNotFoundError, type MemoryOp, MemoryPermissionError, type MemoryQuery, type MemoryRecallResult, MemorySearchError, type MemorySource, MemoryStdioServer, type MemorySystemConfig, MemoryValidationError, type MemoryVector, type NodeQueryFilter, OP_REGISTRY, type OpAnnotations, type OpHandlerContext, type OpScope, type RecallParams, type RecallResult, type RegisteredHook, type RememberParams, type RememberResult, type StatusResult, type SyncParams, type SyncResult, addWord, clearAllHooks, closeTokenizer, consolidate, dispatchHook, doctor, executeOp, extract, forget, getGlobal, getHomeDir, getInstance, getMemoryDbPath, getMemoryDir, getXdgData, graphQuery, handleMemoryCli, init, initTokenizer, isInitialized, listHooks, loadCustomDict, readCurrentSchemaVersion, recall, registerAllDefaultHooks, registerHook, remember, renderBanner, renderHelp, renderOperationMarkdown, resetGlobalAdapter, resetInstanceAdapter, runMigrations, setGlobalAdapter, setInstanceAdapter, status, sync, toFtsTokens, toFtsTokensForSearch, tokenize, tokenizeForSearch, unregisterHook };
|
|
656
|
+
export { ALL_OPS, type ArchiveRecord, type ArchiveResult, COMMANDS_HELP, type CommandHelp, type ConsolidateParams, type ConsolidateResult, type DoctorResult, type EdgeQueryFilter, type ErrorCode, type ExtractParams, type ExtractResult, type ForgetParams, type ForgetResult, type GraphQueryParams, type GraphQueryResult, GraphStore, type HookContext, type HookHandler, type HookName, type HookResult, type InitParams, type InitResult, type KGScope, LATEST_SCHEMA_VERSION, Llm, type LlmInitConfig, type LlmModels, MEMORY_CATEGORIES, MIGRATIONS, type MemoryCategory, type MemoryCliDeps, type MemoryCliResult, MemoryDatabaseError, MemoryDatabaseManager, type MemoryEdge, MemoryEmbeddingError, MemoryError, MemoryErrorCode, type MemoryFact, MemoryFileError, type MemoryNode, type MemoryNodeWithEdges, MemoryNotFoundError, type MemoryOp, MemoryPermissionError, type MemoryQuery, type MemoryRecallResult, MemorySearchError, type MemorySource, MemoryStdioServer, type MemorySystemConfig, MemoryValidationError, type MemoryVector, type NodeQueryFilter, OP_REGISTRY, type OpAnnotations, type OpHandlerContext, type OpScope, type RecallParams, type RecallResult, type RegisteredHook, type RememberParams, type RememberResult, type StatusResult, type SyncParams, type SyncResult, type UpdateParams, type UpdateResult, addWord, clearAllHooks, closeTokenizer, consolidate, dispatchHook, doctor, executeOp, extract, forget, getGlobal, getHomeDir, getInstance, getMemoryDbPath, getMemoryDir, getXdgData, graphQuery, handleMemoryCli, init, initTokenizer, isInitialized, listHooks, loadCustomDict, readCurrentSchemaVersion, recall, registerAllDefaultHooks, registerHook, remember, renderBanner, renderHelp, renderOperationMarkdown, resetGlobalAdapter, resetInstanceAdapter, runMigrations, setGlobalAdapter, setInstanceAdapter, status, sync, toFtsTokens, toFtsTokensForSearch, tokenize, tokenizeForSearch, unregisterHook, update };
|
package/dist/index.mjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import'./chunks/chunk-QF5S5MG7.mjs';export{a as COMMANDS_HELP,d as handleMemoryCli,b as renderBanner,c as renderHelp}from'./chunks/chunk-
|
|
1
|
+
import'./chunks/chunk-QF5S5MG7.mjs';export{a as COMMANDS_HELP,d as handleMemoryCli,b as renderBanner,c as renderHelp}from'./chunks/chunk-5DCNLEAC.mjs';export{b as MemoryStdioServer,a as renderOperationMarkdown}from'./chunks/chunk-WDGBZHIS.mjs';import {w,x}from'./chunks/chunk-ZIFDM4GO.mjs';export{v as ALL_OPS,a as GraphStore,u as OP_REGISTRY,o as consolidate,t as doctor,w as executeOp,n as extract,m as forget,q as graphQuery,r as init,b as recall,k as remember,s as status,p as sync,l as update}from'./chunks/chunk-ZIFDM4GO.mjs';export{a as LATEST_SCHEMA_VERSION,b as MIGRATIONS,e as MemoryDatabaseManager,d as readCurrentSchemaVersion,c as runMigrations}from'./chunks/chunk-PJGILQSZ.mjs';import {f as f$1,j as j$1}from'./chunks/chunk-WDVDYZ25.mjs';export{c as getGlobal,g as getHomeDir,f as getInstance,j as getMemoryDbPath,i as getMemoryDir,h as getXdgData,b as resetGlobalAdapter,e as resetInstanceAdapter,a as setGlobalAdapter,d as setInstanceAdapter}from'./chunks/chunk-WDVDYZ25.mjs';export{a as Llm}from'./chunks/chunk-6CQMBEIQ.mjs';import {a}from'./chunks/chunk-HQBRVVXS.mjs';export{GRAPH_ENTITY_TYPE_DEFINITIONS,GRAPH_RELATION_TYPE_DEFINITIONS}from'@easbot/types';import*as m from'jieba-wasm';import {Log,loadTextFile,Filesystem}from'@easbot/utils';import {createHash}from'crypto';var Ae=["user_preference","task_context","technical_fact","decision","relationship","reminder","error_pattern","workflow","exploration_finding","experience_summary","tool_usage","skill_creation","test","other"],d=class extends Error{constructor(t,o,n){super(t,{cause:n});a(this,"code",o);a(this,"cause",n);this.name="MemoryError";}},D=class extends d{constructor(r,t){super(r,"MEMORY_VALIDATION_ERROR",t),this.name="MemoryValidationError";}},T=class extends d{constructor(r){super(`Memory not found: ${r}`,"MEMORY_NOT_FOUND"),this.name="MemoryNotFoundError";}},v=class extends d{constructor(r){super(r,"MEMORY_PERMISSION_ERROR"),this.name="MemoryPermissionError";}},F=class extends d{constructor(r,t){super(r,"MEMORY_DATABASE_ERROR",t),this.name="MemoryDatabaseError";}},L=class extends d{constructor(r,t){super(r,"MEMORY_FILE_ERROR",t),this.name="MemoryFileError";}},$=class extends d{constructor(r,t){super(r,"MEMORY_SEARCH_ERROR",t),this.name="MemorySearchError";}},j=class extends d{constructor(r,t){super(r,"MEMORY_EMBEDDING_ERROR",t),this.name="MemoryEmbeddingError";}},ge=(i=>(i.VALIDATION_ERROR="MEMORY_VALIDATION_ERROR",i.NOT_FOUND="MEMORY_NOT_FOUND",i.PERMISSION_ERROR="MEMORY_PERMISSION_ERROR",i.DATABASE_ERROR="MEMORY_DATABASE_ERROR",i.FILE_ERROR="MEMORY_FILE_ERROR",i.SEARCH_ERROR="MEMORY_SEARCH_ERROR",i.EMBEDDING_ERROR="MEMORY_EMBEDDING_ERROR",i))(ge||{});var s=Log.create({service:"memory.tokenizer"}),c=false,ke=loadTextFile("./assets/jieba_dict.txt",import.meta.url);async function Le(e){if(!c)try{s.debug("Initializing jieba tokenizer");let r=ke();if(m.with_dict(r),s.debug("Built-in dictionary loaded"),e?.dictPath&&e.dictPath.length>0)for(let t of e.dictPath)await xe(t);c=!0,s.debug("Jieba tokenizer initialized successfully");}catch(r){s.error("Failed to initialize jieba tokenizer",{error:String(r)}),s.warn("Using fallback tokenization (space-based)");}}async function xe(e){if(!c)throw new Error("Tokenizer not initialized");try{let r=await Filesystem.readText(e);s.debug("Loading custom dictionary",{dictPath:e}),m.with_dict(r),s.debug("Custom dictionary loaded successfully",{dictPath:e});}catch(r){s.warn("Failed to load custom dictionary",{dictPath:e,error:String(r)});}}function He(e){if(!c)return e.split(/\s+/).filter(Boolean);try{return m.cut(e)}catch(r){return s.warn("Tokenization failed, using fallback",{error:String(r)}),e.split(/\s+/).filter(Boolean)}}function he(e){if(!c)return e.split(/\s+/).filter(Boolean);try{return m.cut_for_search(e)}catch(r){return s.warn("Tokenization for search failed, using fallback",{error:String(r)}),e.split(/\s+/).filter(Boolean)}}function $e(e,r,t){if(c)try{m.add_word(e,r,t),s.debug("Word added to dictionary",{word:e,freq:r,tag:t});}catch(o){s.warn("Failed to add word",{word:e,error:String(o)});}}function je(){return c}async function ze(){c=false,s.debug("Tokenizer closed");}function Ye(e){if(!c)return e.split(/\s+/).filter(Boolean).join(" ");try{return He(e).join(" ")}catch(r){return s.warn("Tokenization failed, using fallback",{error:String(r)}),e.split(/\s+/).filter(Boolean).join(" ")}}function Ge(e){if(!c)return e.split(/\s+/).filter(Boolean).join(" ");try{return he(e).join(" ")}catch(r){return s.warn("Tokenization for search failed, using fallback",{error:String(r)}),e.split(/\s+/).filter(Boolean).join(" ")}}function u(e){let r=f$1().worktree,t=j$1(r);return {agentId:e,isTrustedLocal:true,remote:false,locale:"en-US",dbPath:t,workspaceDir:r,rootDir:r,config:x({agentId:e,dbPath:t,workspaceDir:r})}}var z=async e=>{if(!e.agentId?.trim())return {ok:false,error:"session-start: agentId is required in ctx"};let r=e.extras?.topK??5,t=e.extras?.query??"";try{let o=await w("recall",{query:t,maxResults:r},u(e.agentId));if(o.hits.length===0)return {ok:!0,injected:"",logLine:"session-start: no facts found for agent; skipping context injection"};let n=o.hits.map(R=>`- [${R.category}/imp=${R.importance}] ${R.snippet.slice(0,200)}`);return {ok:!0,injected:`[memory:session-start recall top-${o.hits.length}]
|
|
2
2
|
${n.join(`
|
|
3
|
-
`)}`,logLine:`session-start: injected ${o.hits.length} facts into context (agent=${e.agentId})`}}catch(o){return {ok:false,error:o instanceof Error?o.message:String(o)}}};var
|
|
3
|
+
`)}`,logLine:`session-start: injected ${o.hits.length} facts into context (agent=${e.agentId})`}}catch(o){return {ok:false,error:o instanceof Error?o.message:String(o)}}};var Y=async e=>{if(!e.agentId?.trim())return {ok:false,error:"session-end: agentId is required in ctx"};let r=e.extras?.windowDays??1;try{let t=await w("consolidate",{windowDays:r},u(e.agentId));return {ok:!0,logLine:`session-end: total=${t.totalFacts}, deduped=${t.dedupedCount}, archived=${t.archivedCount}, skipped=${t.skippedCount}`}}catch(t){return {ok:false,error:t instanceof Error?t.message:String(t)}}};var G=async e=>{if(!e.agentId?.trim())return {ok:false,error:"pre-compact: agentId is required in ctx"};let t=(e.contextPreview??e.messagePreview??"").slice(0,200).replace(/\s+/g," ").trim(),o=e.extras?.topK??3;if(!t)return {ok:true,injected:"",logLine:"pre-compact: empty contextPreview; skipping recall injection"};try{let n=await w("recall",{query:t,maxResults:o,minImportance:5},u(e.agentId));if(n.hits.length===0)return {ok:!0,injected:"",logLine:`pre-compact: no facts matched query for agent=${e.agentId}`};let h=n.hits.map(i=>`- [${i.category}/imp=${i.importance}] ${i.snippet.slice(0,150)}`);return {ok:!0,injected:`[memory:pre-compact recall top-${n.hits.length} (imp>=5)]
|
|
4
4
|
${h.join(`
|
|
5
|
-
`)}`,logLine:`pre-compact: injected ${n.hits.length} facts before compaction`}}catch(n){return {ok:false,error:n instanceof Error?n.message:String(n)}}};var
|
|
6
|
-
`);try{return {ok:!0,logLine:`post-tool-failure: wrote error_pattern fact ${(await
|
|
5
|
+
`)}`,logLine:`pre-compact: injected ${n.hits.length} facts before compaction`}}catch(n){return {ok:false,error:n instanceof Error?n.message:String(n)}}};var B=async e=>{if(!e.agentId?.trim())return {ok:false,error:"post-tool-failure: agentId is required in ctx"};if(!e.toolName?.trim()||!e.error?.trim())return {ok:false,error:"post-tool-failure: toolName and error are required in ctx"};let r=createHash("sha256").update(`${e.toolName}:${e.error}`).digest("hex").slice(0,8),t=e.messagePreview?e.messagePreview.slice(0,200).replace(/\s+/g," ").trim():"",o=[`[error_pattern] tool=${e.toolName}`,`[error] ${e.error}`,t?`[preview] ${t}`:"",`[errHash] ${r}`].filter(Boolean).join(`
|
|
6
|
+
`);try{return {ok:!0,logLine:`post-tool-failure: wrote error_pattern fact ${(await w("remember",{content:o,category:"error_pattern",importance:6,tags:["post-tool-failure",`tool:${e.toolName}`,`err:${r}`],sessionId:e.sessionId,msgId:e.extras?.msgId},u(e.agentId))).fact.id} (tool=${e.toolName}, errHash=${r})`}}catch(n){return {ok:false,error:n instanceof Error?n.message:String(n)}}};var g=Log.create({service:"memory.hooks"}),f=new Map;function y(e,r){let t={name:e,handler:r,registeredAt:new Date().toISOString()},o=f.get(e);f.set(e,t),o?g.info("Hook overwritten",{name:e,prevRegisteredAt:o.registeredAt,newRegisteredAt:t.registeredAt}):g.info("Hook registered",{name:e,registeredAt:t.registeredAt});}function be(e){return f.delete(e)}function Me(){return Array.from(f.values()).map(e=>({name:e.name,handler:e.handler,registeredAt:e.registeredAt}))}function _e(){y("session-start",z),y("session-end",Y),y("pre-compact",G),y("post-tool-failure",B);}function Oe(){f.clear(),g.debug("All hooks cleared");}async function Se(e,r){let t=f.get(e);if(!t)return g.debug("dispatchHook: no handler registered; noop",{name:e}),{ok:true,logLine:`hook ${e} not registered; noop`};try{let o=await t.handler(r);return o.ok?o.logLine&&g.debug("dispatchHook: ok",{name:e,logLine:o.logLine}):g.warn("dispatchHook: handler returned failure",{name:e,agentId:r.agentId,error:o.error}),o}catch(o){let n=o instanceof Error?o.message:String(o);return g.warn("dispatchHook: handler threw, caught and converted to failure result",{name:e,agentId:r.agentId,error:n}),{ok:false,error:n}}}export{Ae as MEMORY_CATEGORIES,F as MemoryDatabaseError,j as MemoryEmbeddingError,d as MemoryError,ge as MemoryErrorCode,L as MemoryFileError,T as MemoryNotFoundError,v as MemoryPermissionError,$ as MemorySearchError,D as MemoryValidationError,$e as addWord,Oe as clearAllHooks,ze as closeTokenizer,Se as dispatchHook,Le as initTokenizer,je as isInitialized,Me as listHooks,xe as loadCustomDict,_e as registerAllDefaultHooks,y as registerHook,Ye as toFtsTokens,Ge as toFtsTokensForSearch,He as tokenize,he as tokenizeForSearch,be as unregisterHook};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@easbot/memory",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.22",
|
|
4
4
|
"description": "Memory management library for EASBOT ecosystem - 智能记忆管理库,支持混合搜索、中英文分词、增量索引",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.cjs",
|
|
@@ -54,14 +54,14 @@
|
|
|
54
54
|
"better-sqlite3": "^13.0.3",
|
|
55
55
|
"jieba-wasm": "^2.4.0",
|
|
56
56
|
"xdg-basedir": "^5.1.0",
|
|
57
|
-
"@easbot/database": "0.3.
|
|
58
|
-
"@easbot/mcp": "0.3.
|
|
59
|
-
"@easbot/types": "0.3.
|
|
60
|
-
"@easbot/
|
|
61
|
-
"@easbot/
|
|
62
|
-
"@easbot/
|
|
63
|
-
"@easbot/
|
|
64
|
-
"@easbot/
|
|
57
|
+
"@easbot/database": "0.3.22",
|
|
58
|
+
"@easbot/mcp": "0.3.22",
|
|
59
|
+
"@easbot/types": "0.3.22",
|
|
60
|
+
"@easbot/local-model-sdk": "0.3.22",
|
|
61
|
+
"@easbot/terminal": "0.3.22",
|
|
62
|
+
"@easbot/utils": "0.3.22",
|
|
63
|
+
"@easbot/ollama-sdk": "0.3.22",
|
|
64
|
+
"@easbot/llm": "0.3.22"
|
|
65
65
|
},
|
|
66
66
|
"devDependencies": {
|
|
67
67
|
"@types/node": "^25.9.5",
|
|
@@ -89,7 +89,7 @@
|
|
|
89
89
|
"format": "biome format .",
|
|
90
90
|
"format:fix": "biome format --write .",
|
|
91
91
|
"type-check": "tsc --noEmit",
|
|
92
|
-
"clean": "
|
|
92
|
+
"clean": "rimraf dist node_modules",
|
|
93
93
|
"publish:npm": "bash scripts/publish.sh",
|
|
94
94
|
"publish:npm:win": "powershell -ExecutionPolicy Bypass -File scripts/publish.ps1"
|
|
95
95
|
}
|
|
@@ -1,50 +0,0 @@
|
|
|
1
|
-
import {e,a as a$2}from'./chunk-JDPZ5U53.mjs';import {j}from'./chunk-WDVDYZ25.mjs';import {a as a$1}from'./chunk-6CQMBEIQ.mjs';import {a}from'./chunk-HQBRVVXS.mjs';import {Log,Locale,formatLocalISO}from'@easbot/utils';import {z}from'zod';import {randomBytes,createHash}from'crypto';import {GraphProvider,probeEmbeddingDims,syncMeta}from'@easbot/llm';import z$1 from'fs/promises';import de from'path';import {writeFileSync}from'fs';import {createRequire}from'module';import {EMBEDDING_DIMS_CONSISTENCY_CHECK,DEFAULT_SEARCH_CONFIG}from'@easbot/types';var le=Log.create({service:"memory.graph-store"}),V=class{constructor(e){a(this,"db");this.db=e;}async upsertNode(e,n,r,o){let c=Date.now(),s=JSON.stringify(r??{}),i=this.db.prepare("SELECT id FROM nodes WHERE name = ? AND type = ? LIMIT 1").get(e,n);if(i)return this.db.prepare("UPDATE nodes SET properties = ?, updatedAt = ? WHERE id = ?").run(s,c,i.id),i.id;let p=this.db.prepare("INSERT INTO nodes (name, type, properties, owner_agent_id, createdAt, updatedAt) VALUES (?, ?, ?, ?, ?, ?)").run(e,n,s,o??null,c,c);return Number(p.lastInsertRowid)}async deleteNode(e){this.db.prepare("DELETE FROM nodes WHERE id = ?").run(e);}async upsertEdge(e,n,r,o){let c=this.db.prepare("INSERT OR REPLACE INTO edges (source, target, relation, properties, createdAt) VALUES (?, ?, ?, ?, ?)").run(e,n,r,JSON.stringify(o??{}),Date.now());return Number(c.lastInsertRowid)}async queryNodes(e={}){let n="SELECT id, name, type, properties, owner_agent_id, createdAt, updatedAt FROM nodes",r=[],o=[];if(e.ids&&e.ids.length>0){let s=e.ids.map(i=>typeof i=="string"?parseInt(i,10):i).filter(i=>!Number.isNaN(i));o.push(`id IN (${s.map(()=>"?").join(", ")})`),r.push(...s);}e.name&&(o.push("name LIKE ?"),r.push(`%${e.name}%`)),e.type&&(o.push("type = ?"),r.push(e.type)),gt(o,r,e.agentId,e.scope??"agent_only"),o.length>0&&(n+=` WHERE ${o.join(" AND ")}`),n+=" ORDER BY id",e.limit&&(n+=" LIMIT ?",r.push(e.limit)),le.debug("queryNodes",{sql:n,params:r,filter:e});let c=this.db.prepare(n).all(...r);return le.debug("queryNodes result",{count:c.length}),c.map(s=>({id:s.id,name:s.name,type:s.type,properties:s.properties?JSON.parse(s.properties):void 0,createdAt:s.createdAt,updatedAt:s.updatedAt,ownerAgentId:s.owner_agent_id}))}async queryEdges(e={}){let n="SELECT e.id, e.source, e.target, e.relation, e.properties, e.createdAt FROM edges e",r=[],o=[];if(e.ids&&e.ids.length>0&&(o.push(`e.id IN (${e.ids.map(()=>"?").join(", ")})`),r.push(...e.ids)),e.source!==void 0&&(o.push("e.source = ?"),r.push(e.source)),e.target!==void 0&&(o.push("e.target = ?"),r.push(e.target)),e.sourceOrTarget&&e.sourceOrTarget.length>0){let f=e.sourceOrTarget.map(m=>typeof m=="string"?parseInt(m,10):m).filter(m=>!Number.isNaN(m));o.push(`(e.source IN (${f.map(()=>"?").join(", ")}) OR e.target IN (${f.map(()=>"?").join(", ")}))`),r.push(...f,...f);}e.relation&&(o.push("e.relation = ?"),r.push(e.relation)),o.length>0&&(n+=` WHERE ${o.join(" AND ")}`),n+=" ORDER BY e.id",e.limit&&(n+=" LIMIT ?",r.push(e.limit)),le.debug("queryEdges",{sql:n,params:r,filter:e});let c=this.db.prepare(n).all(...r);le.debug("queryEdges result",{count:c.length});let s=[...new Set(c.map(f=>f.target))],i=s.length>0?await this.queryNodes({ids:s,limit:s.length}):[],p=new Map(i.map(f=>[f.id,f]));return c.map(f=>{let m={id:f.id,source:f.source,target:f.target,relation:f.relation,properties:f.properties?JSON.parse(f.properties):void 0,createdAt:f.createdAt},u=p.get(f.target);return u&&(m.targetNode=u),m})}async queryNeighbors(e,n=1,r){let o=r?.agentId,c=r?.scope??"agent_only",s=new Set,i=[{id:e,level:0}],p=[],f=r?.maxEdgesPerNode??50;for(;i.length>0;){let m=i.shift();if(!m)break;if(s.has(m.id)||m.level>n)continue;s.add(m.id);let I=(await this.queryNodes({ids:[m.id],limit:1,agentId:o,scope:c}))[0];if(!I)continue;let v=await this.queryEdges({sourceOrTarget:[m.id],limit:f}),S=o?await ut(this,v,o,c):v;if(p.push({...I,edges:S}),m.level<n)for(let w of S){let h=w.source===m.id?w.target:w.source;s.has(h)||i.push({id:h,level:m.level+1});}}return p}};async function ut(t,e,n,r){if(e.length===0)return e;let o=new Set;for(let i of e)o.add(i.source),o.add(i.target);let c=await t.queryNodes({ids:Array.from(o),agentId:n,scope:r,limit:o.size}),s=new Set(c.map(i=>i.id));return e.filter(i=>s.has(i.source)&&s.has(i.target))}function gt(t,e,n,r){if(n)switch(r){case "agent_only":t.push("owner_agent_id = ?"),e.push(n);break;case "shared_only":t.push("owner_agent_id IS NULL");break;case "both":t.push("(owner_agent_id = ? OR owner_agent_id IS NULL)"),e.push(n);break}}var M=class extends Error{constructor(n,r,o){super(n);a(this,"code",r);a(this,"details",o);this.name="ServiceError";}};var ue=class extends M{constructor(){super("ctx.agentId is required for memory service (ADR 0055 per-agent isolation)","AGENT_ID_REQUIRED");}},re=class extends M{constructor(e,n){super(`Trust denied for operation "${e}": ${n}`,"TRUST_DENIED",{operation:e,reason:n});}},ne=class extends M{constructor(e,n){super(`Memory ${e} has ${n} references (force=false)`,"HAS_REFERENCES",{memoryId:e,referenceCount:n});}},oe=class extends M{constructor(e){super(`dryRun mode: ${e} memories matched but not deleted`,"DRY_RUN_NO_DELETE",{matchedCount:e});}},ae=class extends M{constructor(e,n){super(`Matched ${e} memories exceeds maxDelete=${n}`,"MAX_DELETE_EXCEEDED",{matched:e,maxDelete:n});}};function U(t){if(typeof t.agentId!="string"||t.agentId.trim().length===0)throw new ue}function G(t,e){if(t.remote!==false)throw new re(e,"requires trusted local caller (CLI / agent tool / MCP with remote=false)")}function ge(t,e,n){if(e!=="agent_only"&&t.remote!==false)throw new re(n,`scope="${e}" requires trusted local caller (cross-agent access denied)`)}function pe(t){if(!t.dbPath||t.dbPath.trim().length===0)throw new M("service ctx.dbPath is required (MemoryKnowledgeConfigWithModels.database.path)","INTERNAL")}var se=Log.create({service:"memory.service.recall"});async function qe(t,e$1){let n=Date.now();if(U(t),pe(t),!e$1.query||e$1.query.trim().length===0)throw new M("recall requires non-empty `query`","CONTENT_REQUIRED");let r=e$1.includeShared?"both":"agent_only";e$1.includeGraph&&ge(t,r,"recall"),se.debug("recall invoked",{agentId:t.agentId,query:e$1.query,category:e$1.category,maxResults:e$1.maxResults,includeGraph:e$1.includeGraph,scope:r});let o=e$1.maxResults??10,c=e$1.minScore??0,s=[],i=new e(t.dbPath);try{await i.initialize();let p=a$1.isInitialized()&&a$1.capabilities().embedding===!0,f=await ft(i,t.agentId,e$1.query,{category:e$1.category,minImportance:e$1.minImportance,fromTime:e$1.fromTime,toTime:e$1.toTime,limit:o,minScore:c,hasEmbedding:p}),m;if(e$1.includeGraph&&f.length>0)try{let I=new V(i.getDb()),v=e$1.depth??1,S=f.flatMap(y=>(y.nodes??[]).map(E=>E.id)).slice(0,5),w=new Set,h=new Map;for(let y of S){let E=await I.queryNeighbors(y,v,{agentId:t.agentId,scope:r,maxEdgesPerNode:10});for(let _ of E)w.add(_.id),h.set(_.id,_.edges??[]);}let b=w.size>0?i.query(`SELECT id, name, type FROM nodes WHERE id IN (${Array.from(w).map(()=>"?").join(",")})`,Array.from(w)):[],R=Array.from(h.values()).flat();m={nodes:b.map(y=>({id:y.id,name:y.name,type:y.type,createdAt:"",updatedAt:""})),edges:R};}catch(I){let v=I instanceof Error?I.message:String(I);se.warn("recall: KG neighbor query failed",{error:v}),s.push(`kg_neighbor_query_failed: ${v}`),m={nodes:[],edges:[]};}let u=Date.now()-n;return {hits:f,total:f.length,truncated:f.length>=o,durationMs:u,graph:m,...s.length>0?{warnings:s}:{}}}catch(p){throw p instanceof M?p:new M(`recall failed: ${p instanceof Error?p.message:String(p)}`,"INTERNAL",{cause:p instanceof Error?p.message:String(p)})}finally{i.close();}}async function ft(t,e,n,r){let o=["mf.agent_id = ?"],c=[e];r.category&&(o.push("mf.category = ?"),c.push(r.category)),r.minImportance!==void 0&&(o.push("mf.importance >= ?"),c.push(r.minImportance)),r.fromTime&&(o.push("mf.created_at >= ?"),c.push(r.fromTime)),r.toTime&&(o.push("mf.created_at <= ?"),c.push(r.toTime));let s=o.join(" AND "),i=null;if(r.hasEmbedding)try{i=await a$1.embedText(n);}catch(g){se.warn("recall: query embedding failed, falling back to FTS-only",{error:g instanceof Error?g.message:String(g)}),i=null;}let p=Math.max(r.limit*100,1e3),[f,m]=await Promise.all([i?yt(t,i,s,c,p):Promise.resolve([]),ht(t,n,s,c,r.limit)]),u=i?.7:0,I=i?.3:1,v=u+I,S=u/v,w=I/v,h=new Map;for(let g of f)h.set(g.id,g.score*S);for(let g of m)h.set(g.id,(h.get(g.id)??0)+g.score*w);let b=Array.from(h.entries()).sort((g,A)=>A[1]-g[1]).map(([g])=>g).slice(0,r.limit);if(b.length===0)return [];let R=b.map(()=>"?").join(","),y=t.query(`SELECT
|
|
2
|
-
mf.id,
|
|
3
|
-
mf.category,
|
|
4
|
-
mf.importance,
|
|
5
|
-
mf.agent_id as agentId,
|
|
6
|
-
SUBSTR(mf.content, 1, 200) as snippet,
|
|
7
|
-
mf.created_at as createdAt,
|
|
8
|
-
mf.source,
|
|
9
|
-
mf.file_path as filePath,
|
|
10
|
-
mf.node_ids as nodeIds
|
|
11
|
-
FROM memory_facts mf
|
|
12
|
-
WHERE mf.id IN (${R})`,b),E=Date.now();return y.map(g=>{let A=h.get(g.id)??0,O=(E-new Date(g.createdAt).getTime())/864e5,q=Math.exp(-0.05*O),j=(g.importance-1)/9,Q=.4*A+.3*q+.3*j;return {memoryId:g.id,category:g.category,importance:g.importance,agentId:g.agentId,snippet:g.snippet,score:Q,createdAt:g.createdAt,source:g.source,filePath:g.filePath??void 0,nodes:void 0}}).filter(g=>g.score>=r.minScore).sort((g,A)=>A.score-g.score)}function yt(t,e,n,r,o){try{return t.query(`SELECT mf.id, mv.embedding
|
|
13
|
-
FROM memory_facts mf
|
|
14
|
-
JOIN memory_vectors mv ON mf.id = mv.fact_id
|
|
15
|
-
WHERE ${n}
|
|
16
|
-
LIMIT ?`,[...r,o]).map(s=>{let i=new Float32Array(s.embedding.buffer,s.embedding.byteOffset,s.embedding.byteLength/4);return {id:s.id,score:bt(e,i)}}).sort((s,i)=>i.score-s.score)}catch(c){if(c instanceof M)throw c;return se.warn("vector search failed, falling back to FTS-only",{error:c instanceof Error?c.message:String(c)}),[]}}function ht(t,e,n,r,o){try{let c=t.query(`SELECT mf.id as id, bm25(memory_facts_fts) as score
|
|
17
|
-
FROM memory_facts_fts fts
|
|
18
|
-
JOIN memory_facts mf ON mf.id = fts.fact_id
|
|
19
|
-
WHERE ${n} AND memory_facts_fts MATCH ?
|
|
20
|
-
ORDER BY score DESC
|
|
21
|
-
LIMIT ?`,[...r,Et(e),o]);if(c.length===0)return [];let s=Math.max(...c.map(i=>Math.abs(i.score)),1);return c.map(i=>({id:i.id,score:1-Math.abs(i.score)/s})).filter(i=>i.score>=0)}catch(c){if(c instanceof M)throw c;return se.warn("FTS search failed, returning empty result",{err:c instanceof Error?c.message:String(c)}),[]}}function bt(t,e){if(t.length!==e.length||t.length===0)return 0;let n=0,r=0,o=0;for(let s=0;s<t.length;s++){let i=t[s]??0,p=e[s]??0;n+=i*p,r+=i*i,o+=p*p;}let c=Math.sqrt(r)*Math.sqrt(o);return c===0?0:Math.max(0,n/c)}function Et(t){return t.trim().split(/\s+/).filter(e=>e.length>0).map(e=>`"${e.replace(/"/g,'""')}"`).join(" ")}var $e=z.object({query:z.string().min(1).max(500),category:z.string().optional(),minImportance:z.number().min(1).max(10).optional(),fromTime:z.string().datetime().optional(),toTime:z.string().datetime().optional(),maxResults:z.number().int().min(1).max(100).optional().default(10),minScore:z.number().min(0).max(1).optional(),includeGraph:z.boolean().optional().default(false),depth:z.number().int().min(1).max(5).optional().default(1),includeShared:z.boolean().optional().default(false)});z.object({hits:z.array(z.unknown()),total:z.number(),truncated:z.boolean(),durationMs:z.number(),graph:z.object({nodes:z.array(z.unknown()),edges:z.array(z.unknown())}).optional()});var He=z.object({content:z.string().min(1).max(1e4),category:z.string().min(1),importance:z.number().int().min(1).max(10).optional().default(5),tags:z.array(z.string()).optional(),sessionId:z.string().optional(),msgId:z.string().optional(),parentMsgId:z.string().optional(),skipDedup:z.boolean().optional().default(false),extractGraph:z.boolean().optional().default(true)});z.object({fact:z.object({id:z.string(),agentId:z.string(),content:z.string(),category:z.string(),importance:z.number(),createdAt:z.string(),updatedAt:z.string()}),filePath:z.string(),deduplicated:z.boolean(),nodeIds:z.array(z.number()).optional()});var Ue=z.object({factId:z.string().optional(),category:z.string().optional(),fromTime:z.string().datetime().optional(),toTime:z.string().datetime().optional(),maxDelete:z.number().int().min(1).max(1e4).optional().default(1e3),dryRun:z.boolean().optional().default(false),force:z.boolean().optional().default(false)}).refine(t=>t.factId!==void 0&&t.factId.length>0||t.category!==void 0&&t.category.length>0||t.fromTime!==void 0||t.toTime!==void 0,{message:"one of `factId`, `category`, `fromTime`, or `toTime` is required"});z.object({deletedCount:z.number(),deletedIds:z.array(z.string()),dryRun:z.boolean(),truncatedCount:z.number()});var We=z.object({sessionId:z.string().min(1),lastN:z.number().int().min(1).max(500).optional().default(50),fromMessageId:z.string().optional(),writeToDisk:z.boolean().optional().default(true)});z.object({extractedCount:z.number(),factIds:z.array(z.string()),entities:z.array(z.object({id:z.number(),name:z.string(),type:z.string()})),relations:z.array(z.object({source:z.string(),target:z.string(),relation:z.string()})),messageRange:z.object({fromMessageId:z.string(),toMessageId:z.string()}),durationMs:z.number()});var je=z.object({windowDays:z.number().int().min(1).max(365).optional().default(30),dryRun:z.boolean().optional().default(false)});z.object({totalFacts:z.number(),dedupedCount:z.number(),compressedCount:z.number(),archivedCount:z.number(),skippedCount:z.number(),durationMs:z.number()});var Ge=z.object({query:z.string().min(1),type:z.string().optional(),depth:z.number().int().min(1).max(5).optional().default(2),maxNodes:z.number().int().min(1).max(500).optional().default(100),scope:z.enum(["agent_only","shared_only","both"]).optional().default("agent_only"),relation:z.string().optional()});z.object({root:z.unknown().nullable(),nodes:z.array(z.unknown()),edges:z.array(z.unknown()),truncated:z.boolean(),totalNodes:z.number(),totalEdges:z.number(),scope:z.enum(["agent_only","shared_only","both"]),durationMs:z.number()});var ze=z.object({}).optional();z.object({dbPath:z.string(),workspaceDir:z.string(),factsCount:z.number(),nodesCount:z.number(),edgesCount:z.number(),factsByCategory:z.record(z.string(),z.number()),ftsAvailable:z.boolean(),vectorEnabled:z.boolean(),kgScopeEnabled:z.boolean(),healthy:z.boolean(),meta:z.record(z.string(),z.string())});var Be=z.object({}).optional();z.object({healthy:z.boolean(),checks:z.array(z.object({name:z.string(),passed:z.boolean(),message:z.string(),details:z.record(z.string(),z.unknown()).optional()}))});var Qe=z.object({workspaceDir:z.string().optional(),dbPath:z.string().optional(),archiveDays:z.number().int().min(1).max(3650).optional().default(30),force:z.boolean().optional().default(false)});z.object({initialized:z.boolean(),dbPath:z.string(),workspaceDir:z.string(),tablesCreated:z.number(),migrationsApplied:z.number(),durationMs:z.number()});var Ke=z.object({windowDays:z.number().int().min(1).max(3650).optional(),dryRun:z.boolean().optional().default(false)});z.object({generatedCount:z.number(),skippedCount:z.number(),failedGenerateCount:z.number(),archivedCount:z.number(),archiveThreshold:z.string(),archivedRecords:z.array(z.object({source:z.string(),target:z.string(),firstCreatedAt:z.string(),firstFactId:z.string()})),windowDays:z.number(),dryRun:z.boolean(),durationMs:z.number()});var ie=Log.create({service:"memory.fact-file-sync"}),St=".easbot/memory/active";function ce(t,e){let n=e.replace(/\\/g,"/").replace(/\/+$/,""),r=t.category||"uncategorized",o=t.createdAt?new Date(t.createdAt).getTime():Date.now(),c=Number.isNaN(o)?new Date:new Date(o),s=c.getFullYear(),i=String(c.getMonth()+1).padStart(2,"0"),p=String(c.getDate()).padStart(2,"0"),f=`${s}-${i}-${p}`;return `${n}/${St}/${r}/${f}.md`}function Je(t){let e=t.tags&&t.tags.length>0?t.tags:[],n=t.importance??5,r=t.source??"session_self_write",o=t.createdAt?formatLocalISO(new Date(t.createdAt)):formatLocalISO(new Date),c=t.updatedAt?formatLocalISO(new Date(t.updatedAt)):o,s=["---",`id: ${t.id}`,`agent_id: ${t.agentId}`,`category: ${t.category}`,`importance: ${n}`,`created_at: ${o}`,`updated_at: ${c}`,`source: ${r}`,e.length>0?`tags: [${e.join(", ")}]`:"tags: []"];return t.sessionId&&s.push(`session_id: ${t.sessionId}`),t.msgId&&s.push(`msg_id: ${t.msgId}`),t.parentMsgId&&s.push(`parent_msg_id: ${t.parentMsgId}`),t.nodeIds&&t.nodeIds.length>0&&s.push(`node_ids: [${t.nodeIds.join(", ")}]`),s.push("---"),`${s.join(`
|
|
22
|
-
`)}
|
|
23
|
-
${t.content.trim()}`}function Y(t,e){let n=t.replace(/\\/g,"/"),r=e.replace(/\\/g,"/").replace(/\/+$/,"");return n.startsWith(`${r}/`)?n.slice(r.length+1):n}async function It(t,e){let n=ce(t,e),r=Y(n,e);try{let o=Je(t);await z$1.mkdir(de.dirname(n),{recursive:!0});let c="";try{c=await z$1.readFile(n,"utf-8");}catch(i){if(i.code!=="ENOENT")throw i}let s=c.length>0&&!c.endsWith(`
|
|
24
|
-
`)?`
|
|
25
|
-
`:"";return await z$1.writeFile(n,`${c}${s}${o}
|
|
26
|
-
`,"utf-8"),ie.debug("Fact file synced (append)",{id:t.id,relPath:r}),{ok:!0,absPath:n,relPath:r}}catch(o){let c=o instanceof Error?o.message:String(o);return ie.warn("Failed to write fact file (best-effort, non-blocking)",{id:t.id,absPath:n,error:c}),{ok:false,absPath:n,relPath:r,error:c}}}async function Mt(t,e){let n;t.filePath?n=`${e.replace(/\\/g,"/").replace(/\/+$/,"")}/${t.filePath.replace(/^\/+/,"")}`:n=ce({id:t.id,category:t.category,createdAt:t.createdAt,updatedAt:t.createdAt},e);let r=Y(n,e);try{return await z$1.unlink(n),ie.debug("Fact file deleted",{id:t.id,relPath:r}),{ok:!0,absPath:n,relPath:r}}catch(o){if(o.code==="ENOENT")return ie.debug("Fact file not found (already deleted)",{id:t.id,relPath:r}),{ok:true,absPath:n,relPath:r};let s=o instanceof Error?o.message:String(o);return ie.warn("Failed to delete fact file (best-effort, non-blocking)",{id:t.id,absPath:n,error:s}),{ok:false,absPath:n,relPath:r,error:s}}}var X={resolvePath:ce,renderMarkdown:Je,toRelPath:Y,write:It,delete:Mt};var ye=Log.create({service:"memory.service.remember"});async function Ve(t,e$1){if(U(t),pe(t),!e$1.content||e$1.content.trim().length===0)throw new M("remember requires non-empty `content`","CONTENT_REQUIRED");if(!e$1.category)throw new M("remember requires `category`","CATEGORY_REQUIRED");ye.debug("remember invoked",{agentId:t.agentId,category:e$1.category,importance:e$1.importance??5,contentLength:e$1.content.length,skipDedup:e$1.skipDedup,extractGraph:e$1.extractGraph??true});let n=new e(t.dbPath);try{await n.initialize();let r=new Date().toISOString(),o=Ot(),c=e$1.importance??5,s={entities:[],relations:[]},p=e$1.extractGraph!==!1&&a$1.isInitialized()&&a$1.capabilities().graphLlm?a$1.getGraphLlm():void 0;if(p)try{s=await Pt(p,e$1.content);}catch(y){ye.warn("LLM KG extraction failed (continuing without KG)",{agentId:t.agentId,error:y instanceof Error?y.message:String(y)});}let f=a$1.isInitialized()&&a$1.capabilities().embedding===!0,m=f?await Tt(n.getDb(),e$1.content):null,u=m?m.length:null,I=s.entities,v=s.relations,S=[],w=0;n.transaction(()=>{let y=new Map;for(let E of I){let _=n.query("SELECT id FROM nodes WHERE name = ? AND type = ? AND owner_agent_id = ? LIMIT 1",[E.name,E.type,t.agentId])[0];if(_){y.set(E.name,_.id);continue}let g=n.run("INSERT INTO nodes (name, type, properties, owner_agent_id, createdAt, updatedAt) VALUES (?, ?, ?, ?, ?, ?)",[E.name,E.type,JSON.stringify({source:"llm_extracted",...E.properties??{}}),t.agentId,r,r]);g.lastID>0&&y.set(E.name,g.lastID);}for(let E of v){let _=y.get(E.source),g=y.get(E.target);!_||!g||_===g||n.run("INSERT OR REPLACE INTO edges (source, target, relation, properties, createdAt) VALUES (?, ?, ?, ?, ?)",[_,g,E.relation,JSON.stringify({}),r]);}if(n.run(`INSERT INTO memory_facts
|
|
27
|
-
(id, agent_id, session_id, msg_id, parent_msg_id, content, category, importance,
|
|
28
|
-
source, tags, node_ids, file_path, created_at, updated_at)
|
|
29
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[o,t.agentId,e$1.sessionId??null,e$1.msgId??null,e$1.parentMsgId??null,e$1.content,e$1.category,c,"session_self_write",e$1.tags?JSON.stringify(e$1.tags):null,JSON.stringify(Array.from(y.values())),null,r,r]),m&&u){let E=Ye(m);n.run("INSERT OR REPLACE INTO memory_vectors (fact_id, embedding) VALUES (?, ?)",[o,E]),w=1,n.query("SELECT value FROM meta WHERE key = ?",["vectorDims"])[0]||n.run("INSERT OR REPLACE INTO meta (key, value) VALUES (?, ?)",["vectorDims",String(u)]);}n.run("DELETE FROM memory_facts_fts WHERE fact_id = ?",[o]),n.run("INSERT INTO memory_facts_fts (fact_id, agent_id, content, tags) VALUES (?, ?, ?, ?)",[o,t.agentId,e$1.content,e$1.tags?e$1.tags.join(" "):""]),S.push(...Array.from(y.values()));}),ye.info("Memory stored",{id:o,category:e$1.category,agentId:t.agentId,nodeCount:S.length,vectorsWritten:w,vectorDims:u??0,embeddingMode:f?"enabled":"fts_only",entitiesExtracted:I.length,relationsExtracted:v.length});let h={id:o,agentId:t.agentId,sessionId:e$1.sessionId,msgId:e$1.msgId,parentMsgId:e$1.parentMsgId,content:e$1.content,category:e$1.category,importance:c,source:"session_self_write",tags:e$1.tags,nodeIds:S.length>0?S:void 0,filePath:void 0,createdAt:r,updatedAt:r},b="",R=await X.write(h,t.workspaceDir);if(R.ok){b=R.relPath,h.filePath=R.relPath;try{n.run("UPDATE memory_facts SET file_path = ? WHERE id = ?",[R.relPath,o]);}catch(y){ye.warn("Failed to update file_path column after sync",{id:o,error:y instanceof Error?y.message:String(y)});}}return {fact:h,filePath:b,deduplicated:!1,nodeIds:S,vectorsWritten:w,vectorDims:u??0,entitiesExtracted:I.length,relationsExtracted:v.length}}catch(r){throw r instanceof M?r:new M(`remember failed: ${r instanceof Error?r.message:String(r)}`,"INTERNAL",{cause:r instanceof Error?r.message:String(r)})}finally{n.close();}}function Ot(){let t=Date.now(),e=randomBytes(3).toString("hex");return `mem_${t}_${e}`}function Ye(t){return Buffer.from(t.buffer,t.byteOffset,t.byteLength)}function Nt(t){return createHash("sha256").update(t).digest("hex")}async function Tt(t,e){let n=Nt(e),r=t.prepare("SELECT embedding FROM embedding_cache WHERE content_hash = ?").get(n);if(r?.embedding)return new Float32Array(r.embedding.buffer,r.embedding.byteOffset,r.embedding.byteLength/4);let o=await a$1.embedText(e);if(!o||o.length===0)return null;let c=Ye(o);return t.prepare("INSERT OR REPLACE INTO embedding_cache (content_hash, embedding) VALUES (?, ?)").run(n,c),o}async function Pt(t,e){let n=await GraphProvider.generateGraph({chunks:[e],model:t,includeRules:false});return {entities:n.entities,relations:n.relations}}var be=Log.create({service:"memory.service.forget"}),At=1e3;function xt(t){let e=[];if(t.factId&&t.factId.trim().length>0&&e.push("factId"),t.category&&t.category.trim().length>0&&e.push("category"),(t.fromTime||t.toTime)&&e.push("timeRange"),e.length===0)throw new M("CONTENT_REQUIRED: forget requires one of: `factId`, `category`, or `fromTime`/`toTime`","CONTENT_REQUIRED");if(e.length>1)throw new M(`mutually exclusive: forget requires exactly one of factId/category/timeRange, got [${e.join(", ")}]`,"CONTENT_REQUIRED");return e[0]}function Lt(t,e,n){let r=[n];switch(t){case "factId":return {where:"agent_id = ? AND id = ?",args:[...r,e.factId]};case "category":return {where:"agent_id = ? AND category = ?",args:[...r,e.category]};case "timeRange":{let o=["agent_id = ?"];return e.fromTime&&(o.push("created_at >= ?"),r.push(e.fromTime)),e.toTime&&(o.push("created_at <= ?"),r.push(e.toTime)),{where:o.join(" AND "),args:r}}}}function Ft(t,e,n,r){return t.query(`SELECT id, node_ids FROM memory_facts WHERE ${e} LIMIT ?`,[...n,r+1]).map(c=>c.id)}function qt(t,e,n,r){if(n.length===0)return 0;let o=n.map(()=>"?").join(",");return t.query(`SELECT COUNT(*) as count FROM memory_facts WHERE agent_id = ? AND id != ? AND node_ids IS NOT NULL AND EXISTS (
|
|
30
|
-
SELECT 1 FROM json_each(node_ids) AS je WHERE je.value IN (${o})
|
|
31
|
-
)`,[r,e,...n])[0]?.count??0}function $t(t,e,n){let r,o,c="";return t.transaction(()=>{let s=t.query("SELECT node_ids, content, file_path, category, created_at FROM memory_facts WHERE id = ? AND agent_id = ?",[e,n])[0],i=[];if(s?.node_ids)try{i=JSON.parse(s.node_ids),Array.isArray(i)||(i=[]);}catch{i=[];}if(r=s?.file_path??void 0,o=s?.category,c=s?.created_at??"",t.run("DELETE FROM memory_facts_fts WHERE fact_id = ?",[e]),t.run("DELETE FROM memory_facts WHERE id = ? AND agent_id = ?",[e,n]),i.length>0){let p=i.map(()=>"?").join(",");t.run(`DELETE FROM nodes WHERE id IN (${p}) AND NOT EXISTS (
|
|
32
|
-
SELECT 1 FROM memory_facts WHERE node_ids IS NOT NULL AND EXISTS (
|
|
33
|
-
SELECT 1 FROM json_each(node_ids) AS je WHERE je.value = nodes.id
|
|
34
|
-
)
|
|
35
|
-
)`,i);}}),{filePath:r,category:o,createdAt:c}}async function Xe(t,e$1){U(t),G(t,"forget");let n=xt(e$1),r=e$1.maxDelete??At,o=e$1.dryRun??false,c=e$1.force??false;be.debug("forget invoked",{agentId:t.agentId,mode:n,maxDelete:r,dryRun:o,force:c});let s=new e(t.dbPath);try{await s.initialize();let{where:i,args:p}=Lt(n,e$1,t.agentId),f=Ft(s,i,p,r),m=f.length>r;if(m&&!c)throw new ae(f.length,r);let u=m?f.slice(0,r):f;if(o)throw new oe(u.length);let I=[],v=[];for(let S of u){if(!c){let R=s.query("SELECT node_ids FROM memory_facts WHERE id = ? AND agent_id = ?",[S,t.agentId])[0],y=R?.node_ids?(()=>{try{let _=JSON.parse(R.node_ids);if(Array.isArray(_))return _.filter(g=>typeof g=="number")}catch{}return []})():[],E=qt(s,S,y,t.agentId);if(E>0)throw new ne(S,E)}let{filePath:w,category:h,createdAt:b}=$t(s,S,t.agentId);w&&h&&v.push({id:S,filePath:w,category:h,createdAt:b}),I.push(S);}be.info("forget complete",{agentId:t.agentId,mode:n,deletedCount:I.length,force:c,dryRun:o});for(let{id:S,filePath:w,category:h,createdAt:b}of v)await X.delete({id:S,filePath:w,category:h,createdAt:b},t.workspaceDir).catch(R=>{be.warn("Fact file delete failed (best-effort)",{id:S,filePath:w,error:R instanceof Error?R.message:String(R)});});return {deletedCount:I.length,deletedIds:I,dryRun:o,truncatedCount:m?f.length-r:0}}catch(i){throw i instanceof M?i:new M(`forget failed: ${i instanceof Error?i.message:String(i)}`,"INTERNAL",{cause:i instanceof Error?i.message:String(i)})}finally{s.close();}}var Ee=Log.create({service:"memory.service.extract"}),Ut=50,we=500;async function Ze(t,e$1){if(U(t),!e$1.sessionId||e$1.sessionId.trim().length===0)throw new M("extract requires non-empty `sessionId`","SESSION_ID_REQUIRED");let n=e$1.lastN??Ut;if(n>we)throw new M(`extract lastN=${n} exceeds max=${we}`,"CONTENT_REQUIRED",{lastN:n,maxLastN:we});let r=e$1.sessionId,o=e$1.fromMessageId;Ee.debug("extract invoked",{agentId:t.agentId,sessionId:r,lastN:n,fromMessageId:o,writeToDisk:e$1.writeToDisk??true});let c=Date.now(),s=new e(t.dbPath);try{await s.initialize();let i=s.query(`SELECT id, content, category, importance, 1.0 as score, created_at, node_ids
|
|
36
|
-
FROM memory_facts
|
|
37
|
-
WHERE agent_id = ? AND session_id = ?
|
|
38
|
-
ORDER BY created_at ASC
|
|
39
|
-
LIMIT ?`,[t.agentId,r,n]),p=o?i.filter(S=>S.id>o):i,f=new Set;for(let S of p)if(S.node_ids)try{let w=JSON.parse(S.node_ids);if(Array.isArray(w))for(let h of w)typeof h=="number"&&h>0&&f.add(h);}catch(w){Ee.warn("extract: invalid node_ids JSON",{factId:S.id,error:w instanceof Error?w.message:String(w)});}let m=Array.from(f),u=[],I=[];if(m.length>0){let S=m.map(()=>"?").join(","),w=s.query(`SELECT id, name, type FROM nodes WHERE id IN (${S})`,m),h=new Map;for(let y of w)h.set(y.id,y.name);u=w.map(y=>({id:y.id,name:y.name,type:y.type}));let b=s.query(`SELECT source, target, relation FROM edges WHERE source IN (${S}) OR target IN (${S})`,[...m,...m]),R=new Set;I=[];for(let y of b){let E=h.get(y.source),_=h.get(y.target);if(!E||!_)continue;let g=`${E}\0${y.relation}\0${_}`;R.has(g)||(R.add(g),I.push({source:E,target:_,relation:y.relation}));}}let v=Date.now()-c;return Ee.info("extract complete",{agentId:t.agentId,sessionId:r,factCount:p.length,nodeCount:u.length,relationCount:I.length,durationMs:v}),{extractedCount:p.length,factIds:p.map(S=>S.id),entities:u,relations:I,messageRange:{fromMessageId:p[0]?.id??"",toMessageId:p[p.length-1]?.id??""},durationMs:v}}catch(i){throw i instanceof M?i:new M(`extract failed: ${i instanceof Error?i.message:String(i)}`,"INTERNAL",{cause:i instanceof Error?i.message:String(i)})}finally{s.close();}}var Ie=Log.create({service:"memory.service.consolidate"}),jt=30;async function Gt(t){let{createHash:e}=await import('crypto');return e("sha256").update(t).digest("hex")}async function et(t,e$1={}){let n=Date.now();U(t),G(t,"consolidate");let r=e$1.windowDays??jt,o=e$1.dryRun??false;Ie.debug("consolidate invoked",{agentId:t.agentId,windowDays:r,dryRun:o});let c=new e(t.dbPath);try{await c.initialize();let s=c.query("SELECT id, content, category, importance, created_at FROM memory_facts WHERE agent_id = ? ORDER BY created_at DESC",[t.agentId]),i=new Map;for(let h of s){let b=await Gt(h.content);i.has(b)||i.set(b,[]),i.get(b)?.push(h);}let p=0,f=[];for(let[,h]of i){if(h.length<=1)continue;let b=[...h].sort((E,_)=>E.importance!==_.importance?_.importance-E.importance:_.created_at.localeCompare(E.created_at)),R=b[0];if(!R)continue;let y=b.slice(1).map(E=>E.id);p+=y.length,f.push({keep:R,removeIds:y});}let m=new Date(Date.now()-r*24*60*60*1e3).toISOString(),u=c.query(`SELECT id, content, category, importance, created_at FROM memory_facts
|
|
40
|
-
WHERE agent_id = ? AND created_at < ?
|
|
41
|
-
ORDER BY created_at ASC`,[t.agentId,m]),I=0,v=0;if(o)I=0,v=p;else {let h=de.join(t.workspaceDir,"archive");await z$1.mkdir(h,{recursive:!0});for(let{removeIds:b}of f){if(b.length===0)continue;let R=b.map(()=>"?").join(",");c.transaction(()=>{for(let y of b)c.run("DELETE FROM memory_facts WHERE id = ? AND agent_id = ?",[y,t.agentId]);}),v+=b.length;}for(let b of u){let R=b.created_at.slice(0,7),y=de.join(h,R,b.category);await z$1.mkdir(y,{recursive:!0});let E=de.join(y,`${b.id}.md`);try{await z$1.writeFile(E,[`# ${b.id}`,"",`category: ${b.category}`,`importance: ${b.importance}`,`createdAt: ${b.created_at}`,"",b.content,""].join(`
|
|
42
|
-
`),"utf-8"),c.run("DELETE FROM memory_facts WHERE id = ? AND agent_id = ?",[b.id,t.agentId]),I++;}catch(_){Ie.warn("consolidate: archive write failed",{factId:b.id,error:_ instanceof Error?_.message:String(_)});}}}let S=s.length,w=0;return Ie.info("consolidate complete",{agentId:t.agentId,totalFacts:S,dedupedCount:p,compressedCount:w,archivedCount:I,skippedCount:v,dryRun:o,durationMs:Date.now()-n}),{totalFacts:S,dedupedCount:p,compressedCount:w,archivedCount:I,skippedCount:v,durationMs:Date.now()-n}}catch(s){throw s instanceof M?s:new M(`consolidate failed: ${s instanceof Error?s.message:String(s)}`,"INTERNAL",{cause:s instanceof Error?s.message:String(s)})}finally{c.close();}}var H=Log.create({service:"memory.service.sync"}),Qt=30,Kt=".easbot/memory/active",tt=".easbot/memory/archive";function Jt(t){return {id:t.id,agentId:t.agent_id,sessionId:t.session_id??void 0,msgId:t.msg_id??void 0,parentMsgId:t.parent_msg_id??void 0,content:t.content,category:t.category,importance:t.importance,source:t.source,tags:t.tags?JSON.parse(t.tags):void 0,nodeIds:t.node_ids?JSON.parse(t.node_ids):void 0,filePath:t.file_path??void 0,createdAt:t.created_at,updatedAt:t.updated_at}}async function Vt(t,e){let n=0,r=0,o=0,{where:c,params:s}=t.agentFilter(e.agentId),i=t.query(`SELECT id, agent_id, session_id, msg_id, parent_msg_id, content, category, importance,
|
|
43
|
-
source, tags, node_ids, file_path, created_at, updated_at
|
|
44
|
-
FROM memory_facts ${c}
|
|
45
|
-
ORDER BY created_at ASC`,s);for(let p of i){let f=Jt(p);if(p.file_path?.startsWith(`${tt}/`)){r++;continue}let m=ce(f,e.workspaceDir);try{await z$1.access(m),r++;continue}catch(I){let v=I;if(v.code!=="ENOENT"){H.warn("sync generate: fs.access failed (non-ENOENT)",{factId:f.id,absPath:m,error:v.message}),o++;continue}}let u=await X.write(f,e.workspaceDir);u.ok?n++:(o++,H.warn("sync generate: factFileSync.write failed",{factId:f.id,absPath:m,error:u.error}));}return H.debug("sync stage A complete",{agentId:e.agentId,generatedCount:n,skippedCount:r,failedGenerateCount:o}),{generatedCount:n,skippedCount:r,failedGenerateCount:o}}async function Yt(t,e,n,r){let o=n*24*60*60*1e3,c=Date.now(),s=formatLocalISO(new Date(c-o)),i=[],p=de.join(e.workspaceDir,Kt),f=await Xt(p);H.debug("sync stage B: scan active dir",{activeDir:p,fileCount:f.length,windowDays:n,threshold:s,dryRun:r});for(let m of f){let u=await Zt(m);if(!u){H.warn("sync stage B: skip unparseable file",{absPath:m});continue}let{firstCreatedAt:I,firstFactId:v}=u,S=new Date(I).getTime();if(Number.isNaN(S)){H.warn("sync stage B: skip invalid createdAt",{absPath:m,firstCreatedAt:I});continue}if(c-S<=o)continue;let w=er(m);if(!w){H.warn("sync stage B: cannot infer category from path",{absPath:m});continue}let h=I.slice(0,7),b=de.join(e.workspaceDir,tt,h,w),R=de.basename(m),y=de.join(b,R);if(r){i.push({source:m,target:y,firstCreatedAt:I,firstFactId:v});continue}try{await z$1.mkdir(b,{recursive:!0});try{await z$1.rename(m,y);}catch(g){let A=g;H.warn("sync stage B: fs.rename failed, falling back to copy+unlink",{absPath:m,targetPath:y,error:A.message}),await z$1.copyFile(m,y),await z$1.unlink(m);}let E=Y(m,e.workspaceDir),_=Y(y,e.workspaceDir);t.run(`UPDATE memory_facts SET file_path = ?
|
|
46
|
-
WHERE agent_id = ? AND file_path = ?`,[_,e.agentId??"",E]),i.push({source:m,target:y,firstCreatedAt:I,firstFactId:v});}catch(E){H.warn("sync stage B: archive failed",{absPath:m,targetPath:y,error:E instanceof Error?E.message:String(E)});}}return H.debug("sync stage B complete",{agentId:e.agentId,archivedCount:i.length,dryRun:r}),{archivedCount:i.length,archiveThreshold:s,archivedRecords:i}}async function Xt(t){let e=[];try{await rt(t,e);}catch(n){let r=n;if(r.code==="ENOENT")return e;throw H.warn("sync: listActiveMdFiles failed",{activeDir:t,error:r.message}),new M(`sync: listActiveMdFiles failed: ${r.message}`,"INTERNAL",{cause:r.message})}return e}async function rt(t,e){let n=await z$1.readdir(t,{withFileTypes:true});for(let r of n){let o=de.join(t,r.name);r.isDirectory()?await rt(o,e):r.isFile()&&r.name.endsWith(".md")&&e.push(o);}}async function Zt(t){let e;try{e=await z$1.readFile(t,"utf-8");}catch(s){if(s.code==="ENOENT")return null;throw s}if(!e.startsWith(`---
|
|
47
|
-
`))return null;let n=e.indexOf(`
|
|
48
|
-
---
|
|
49
|
-
`,4);if(n===-1)return null;let r=e.slice(4,n),o,c;for(let s of r.split(`
|
|
50
|
-
`)){let i=s.trim();if(i.startsWith("created_at:")?o=i.slice(11).trim().replace(/^["']|["']$/g,""):i.startsWith("id:")&&(c=i.slice(3).trim().replace(/^["']|["']$/g,"")),o&&c)break}return !o||!c?null:{firstCreatedAt:o,firstFactId:c}}function er(t){let e=t.replace(/\\/g,"/").split("/"),n=e.findIndex(c=>c==="active");if(n===-1)return null;let r=e.slice(n+1);return r.length!==2||!r[1].endsWith(".md")?null:r[0]??null}async function nt(t,e$1={}){let n=Date.now();U(t),G(t,"sync");let r=e$1.windowDays??t.config?.archiveDays??Qt,o=e$1.dryRun??false;H.info("sync invoked",{agentId:t.agentId,windowDays:r,dryRun:o,workspaceDir:t.workspaceDir});let c=new e(t.dbPath);try{await c.initialize();let s=await Vt(c,t),i=await Yt(c,t,r,o),p={generatedCount:s.generatedCount,skippedCount:s.skippedCount,failedGenerateCount:s.failedGenerateCount,archivedCount:i.archivedCount,archiveThreshold:i.archiveThreshold,archivedRecords:i.archivedRecords,windowDays:r,dryRun:o,durationMs:Date.now()-n};return H.info("sync complete",{agentId:t.agentId,...p}),p}catch(s){throw s instanceof M?s:new M(`sync failed: ${s instanceof Error?s.message:String(s)}`,"INTERNAL",{cause:s instanceof Error?s.message:String(s)})}finally{c.close();}}var ot=Log.create({service:"memory.service.graph-query"});async function at(t,e$1){let n=Date.now(),r=(t.agentId??"").trim()||"default",o=e$1.scope??"agent_only";if(!e$1.query||e$1.query.trim().length===0)throw new M("CONTENT_REQUIRED: graphQuery requires non-empty `query`","CONTENT_REQUIRED");ge(t,o,"graph_query");let c=e$1.depth??2,s=e$1.maxNodes??100,i=e$1.query,p=e$1.type,f=e$1.relation;ot.debug("graphQuery invoked",{agentId:r,query:i,type:p,depth:c,maxNodes:s,scope:o,remote:t.remote});let m=new e(t.dbPath);try{await m.initialize();let u=new V(m.getDb()),I=i.includes("*")||i.includes("%")?i:`%${i}%`,v=await u.queryNodes({name:I,...p?{type:p}:{},agentId:r,scope:o,limit:s}),w=(i.includes("*")||i.includes("%")?v:v.filter(g=>g.name.toLowerCase().includes(i.toLowerCase())))[0]??null;if(!w)return {root:null,nodes:[],edges:[],truncated:!1,totalNodes:0,totalEdges:0,scope:o,durationMs:Date.now()-n};let h=await u.queryNeighbors(w.id,c,{agentId:r,scope:o,maxEdgesPerNode:20}),b=new Map;b.set(w.id,w);for(let g of h)b.set(g.id,{id:g.id,name:g.name,type:g.type,createdAt:g.createdAt,updatedAt:g.updatedAt});let R=[];for(let g of h)if(g.edges)for(let A of g.edges)f&&A.relation!==f||R.push(A);for(let g of R){if(!b.has(g.source)){let A=await u.queryNodes({ids:[g.source],agentId:r,scope:o});A[0]&&b.set(A[0].id,A[0]);}if(!b.has(g.target)){let A=await u.queryNodes({ids:[g.target],agentId:r,scope:o});A[0]&&b.set(A[0].id,A[0]);}}let y=Array.from(b.values()),E=y.length>s,_=E?y.slice(0,s):y;return ot.info("graphQuery complete",{agentId:r,rootId:w.id,nodeCount:_.length,edgeCount:R.length,truncated:E,durationMs:Date.now()-n}),{root:w,nodes:_,edges:R,truncated:E,totalNodes:y.length,totalEdges:R.length,scope:o,durationMs:Date.now()-n}}catch(u){throw u instanceof M?u:new M(`graphQuery failed: ${u instanceof Error?u.message:String(u)}`,"INTERNAL",{cause:u instanceof Error?u.message:String(u)})}finally{m.close();}}var W=Log.create({service:"memory.service.init"});function Me(t){return de.join(t,".easbot","memory.json")}async function or(t){try{let{Config:e}=await import('@easbot/llm'),n=await e.get(),r=o=>typeof o=="string"&&o.length>0?o:void 0;return {embeddingModel:r(n.embedding_model),graphModel:r(n.graph_model)}}catch{return {}}}function ar(t,e={}){let n={version:1,schema_version:a$2,backend:"better-sqlite3",created_at:new Date().toISOString(),embedding_model:e.embeddingModel??null,graph_model:e.graphModel??null,entity_extraction_prompt:e.entityExtractionPrompt??null,relation_extraction_prompt:e.relationExtractionPrompt??null,archiveDays:e.archiveDays??30,shortTermMaxRounds:e.shortTermMaxRounds??20};writeFileSync(t,JSON.stringify(n,null,2),"utf-8");}async function st(t,e$1={}){let n=Date.now();G(t,"init");let r=e$1.workspaceDir??t.workspaceDir,o=e$1.dbPath??t.dbPath;if(!r||r.trim().length===0)throw new M("init requires non-empty `workspaceDir` (ctx.workspaceDir or params.workspaceDir)","CONTENT_REQUIRED");if(!o||o.trim().length===0)throw new M("init requires non-empty `dbPath` (ctx.dbPath or params.dbPath)","CONTENT_REQUIRED");let c=t.agentId?.trim()??"",s=e$1.force??false;W.debug("init invoked",{agentId:c,workspaceDir:r,dbPath:o,force:s});let i=Me(r);if(!s)try{if(await z$1.stat(i).then(()=>!0).catch(()=>!1))return W.info("init: idempotent skip (memory.json exists, no --force)",{workspaceDir:r,configPath:i}),{initialized:!1,dbPath:o,configPath:i,configCreated:!1,schemaVersion:a$2,workspaceDir:r,tablesCreated:0,migrationsApplied:0,durationMs:0}}catch{}try{await z$1.mkdir(de.dirname(o),{recursive:!0}),await z$1.mkdir(de.join(r,".easbot","memory","active"),{recursive:!0}),await z$1.mkdir(de.join(r,"archive"),{recursive:!0}),await z$1.mkdir(de.join(r,".easbot"),{recursive:!0});}catch(u){throw new M(`init: failed to create directories: ${u instanceof Error?u.message:String(u)}`,"INTERNAL",{cause:u instanceof Error?u.message:String(u)})}if(s)try{await z$1.rm(o,{force:!0});}catch(u){W.warn("init: force rm db failed (may not exist)",{dbPath:o,error:u instanceof Error?u.message:String(u)});}let p=await or(),f=false;try{!await z$1.stat(i).then(()=>!0).catch(()=>!1)||s?(ar(i,{embeddingModel:p.embeddingModel,graphModel:p.graphModel,archiveDays:t.config?.archiveDays,shortTermMaxRounds:t.config?.shortTermMaxRounds}),f=!0,W.info("init: memory.json written",{configPath:i,force:s,configCreated:f})):W.debug("init: memory.json already exists, skipping write",{configPath:i});}catch(u){W.warn("init: memory.json write failed (non-fatal)",{configPath:i,error:u instanceof Error?u.message:String(u)});}let m=new e(o);try{let u=await z$1.stat(o).then(()=>!0).catch(()=>!1);await m.initialize();let I=new Date().toISOString(),v=[["version","1.0.0"],["schemaVersion",String(a$2)],["createdAt",I],["defaultAgentId",c]];for(let[h,b]of v)try{m.run("INSERT OR IGNORE INTO meta (key, value) VALUES (?, ?)",[h,b]);}catch(R){W.warn("init: meta insert failed",{key:h,error:R instanceof Error?R.message:String(R)});}let S=0;try{S=m.prepare("SELECT COUNT(*) as n FROM sqlite_master WHERE type IN ('table', 'index', 'trigger', 'view')").get()?.n??0;}catch(h){W.warn("init: tablesCreated count failed",{error:h instanceof Error?h.message:String(h)});}let w=0;try{w=m.prepare("SELECT id FROM schema_migrations").all().length;}catch(h){W.warn("init: migrationsApplied count failed",{error:h instanceof Error?h.message:String(h)});}return W.info("init complete",{agentId:c,workspaceDir:r,dbPath:o,configPath:i,configCreated:f,schemaVersion:a$2,durationMs:Date.now()-n}),{initialized:!0,dbPath:o,configPath:i,configCreated:f,schemaVersion:a$2,workspaceDir:r,tablesCreated:S,migrationsApplied:w,durationMs:Date.now()-n}}catch(u){throw new M(`init failed: ${u instanceof Error?u.message:String(u)}`,"INTERNAL",{cause:u instanceof Error?u.message:String(u)})}finally{m.close();}}var Z=Log.create({service:"memory.service.status"}),dr=["user_preference","task_context","technical_fact","decision","relationship","reminder","error_pattern","workflow","exploration_finding","experience_summary","tool_usage","skill_creation","test","other"],mr={};async function it(t,e$1={},n=mr){let r=t.agentId&&t.agentId.trim().length>0?t.agentId:void 0;if(Z.debug("status invoked",{agentId:r??"<global>"}),!t.dbPath||t.dbPath.length===0)throw new M("`ctx.dbPath` is required","INTERNAL");let o={initialized:false,capabilities:{embedding:false,graphLlm:false}},c={},s={},i=0,p=0,f=0,m,u,I,v=false,S,w="uninitialized",h=false,b=false,R=false,y,E=dr.reduce((O,q)=>(O[q]=0,O),{}),_=new e(t.dbPath);try{await _.initialize(),i=_.query(r!==void 0?"SELECT COUNT(*) as c FROM memory_facts WHERE agent_id = ?":"SELECT COUNT(*) as c FROM memory_facts WHERE agent_id IS NOT NULL",r!==void 0?[r]:[])[0]?.c??0,p=_.query(r!==void 0?"SELECT COUNT(*) AS c FROM nodes WHERE owner_agent_id = ? OR owner_agent_id IS NULL":"SELECT COUNT(*) AS c FROM nodes",r!==void 0?[r]:[])[0]?.c??0,f=_.query("SELECT COUNT(*) as c FROM edges")[0]?.c??0;let Q=_.query(r!==void 0?"SELECT category, COUNT(*) as c FROM memory_facts WHERE agent_id = ? GROUP BY category":"SELECT category, COUNT(*) as c FROM memory_facts WHERE agent_id IS NOT NULL GROUP BY category",r!==void 0?[r]:[]);for(let D of Q){let F=D.category;F in E&&(E[F]=D.c);}c.facts=i,c.nodes=p,c.edges=f;try{b=_.query("SELECT name FROM sqlite_master WHERE type = ? AND name = ?",["table","memory_facts_fts"]).length>0;}catch(D){Z.debug("status: fts probe failed",{error:D instanceof Error?D.message:String(D)});}v=!!t.config?.embeddingLlm;try{h=_.query("SELECT name FROM pragma_table_info('nodes') WHERE name = ?",["owner_agent_id"]).length>0;}catch(D){Z.debug("status: kg scope probe failed",{error:D instanceof Error?D.message:String(D)});}R=_.healthCheck();try{let D=_.query("SELECT key, value FROM meta");for(let F of D)s[F.key]=F.value;}catch(D){Z.debug("status: meta read failed",{error:D instanceof Error?D.message:String(D)});}let d=s.schema_version,l=s.extraction_version,C=s.lastSyncAt??s.lastSync,T=s.embeddingDims;m=d&&Number.parseInt(d,10)||void 0,u=l&&Number.parseInt(l,10)||void 0,I=C,S=T&&Number.parseInt(T,10)||void 0,i>0&&(w="complete");try{y=_.query("SELECT value FROM meta WHERE key = ?",["backend"])[0]?.value??"better-sqlite3";}catch{y="better-sqlite3";}}catch(O){if(O instanceof M)throw O;Z.warn("status: db phase failed; returning partial result",{dbPath:t.dbPath,error:O instanceof Error?O.message:String(O)}),y="unknown",R=false;}finally{_.close();}if(!n.skipLlm&&a$1.isInitialized()){let q=a$1.capabilities();o.initialized=true,o.capabilities={embedding:q.embedding===true,graphLlm:q.graphLlm===true},o.embeddingModel=o.capabilities.embedding?"configured":void 0,o.graphModel=o.capabilities.graphLlm?"configured":void 0;}if(!n.skipEmbeddingProbe&&!n.skipLlm&&o.initialized&&o.capabilities.embedding)try{let O=a$1.getEmbeddingLlm?.();if(O){let q=await probeEmbeddingDims(O,{timeoutMs:5e3});if(typeof q=="number"){S=q,s.embeddingDims=String(q);try{let j=new e(t.dbPath);try{await j.initialize();let Q=j.getDb();syncMeta(Q,[["embeddingDims",String(q)]]);}finally{j.close();}}catch{}}}}catch{}let g;return R?w==="uninitialized"&&(g="Run `easbot memory remember <content>` to add the first fact."):g="Run `easbot memory init` to initialize the database.",R&&(w??"uninitialized")==="failed"&&(R=false),Z.info("status complete",{dbPath:t.dbPath,agentId:r??"<global>",factsCount:i,nodesCount:p,edgesCount:f,healthy:R}),{package:"memory",agentId:r,dbPath:t.dbPath,configPath:Me(t.workspaceDir),configExists:true,schemaVersion:m,extractionVersion:u,lastSyncAt:I,indexState:w,vectorEnabled:v,embeddingDims:S,llm:o,backend:y,counts:c,meta:s,recommendation:g,healthy:R,factsByCategory:E,kgScopeEnabled:h,factsCount:i,nodesCount:p,edgesCount:f,ftsAvailable:b}}var fr=Log.create({service:"memory.service.doctor"}),De=100*1024*1024,ct=100*1024*1024,yr={};function N(t,e,n,r,o){return {code:t.toUpperCase().replace(/[^A-Z0-9]+/g,"_"),severity:e,name:t,message:n,details:o,durationMs:r,passed:e!=="error"}}async function dt(t,e$1={},n=yr){if(fr.debug("doctor invoked",{agentId:t.agentId}),!t.dbPath||t.dbPath.length===0)throw new Error("`ctx.dbPath` is required");let r=[],o=[],c=Date.now(),s=null,i=false,p=Date.now();try{s=new e(t.dbPath),await s.initialize(),i=!0;let d=s.healthCheck(),l=N("database",d?"ok":"error",d?"database connected and writable":"database unhealthy",Date.now()-p,{dbPath:t.dbPath});r.push(l),o.push({name:l.name,passed:l.severity!=="error",message:l.message,details:l.details,severity:l.severity});}catch(d){let l=N("database","error",`database connection failed: ${d instanceof Error?d.message:String(d)}`,Date.now()-p,{dbPath:t.dbPath});r.push(l),o.push({name:l.name,passed:false,message:l.message,details:l.details,severity:"error"});}let f=Date.now();if(i&&s)try{let d=s.query("SELECT name FROM sqlite_master WHERE type = ? AND name = ?",["table","memory_facts_fts"]),l=d.length>0,C=N("fts",l?"ok":"warn",l?"FTS5 index available":"FTS5 index not found",Date.now()-f,l?{table:d[0]?.name}:void 0);r.push(C),o.push({name:C.name,passed:C.severity!=="error",message:C.message,details:C.details,severity:C.severity});}catch(d){let l=N("fts","error",`fts probe failed: ${d instanceof Error?d.message:String(d)}`,Date.now()-f);r.push(l),o.push({name:l.name,passed:false,message:l.message,details:l.details,severity:"error"});}else {let d=N("fts","info","skipped (db not initialized)",0);r.push(d),o.push({name:d.name,passed:true,message:d.message,severity:"info"});}let m=Date.now(),u=!!t.config?.embeddingLlm,I=N("vector","ok",u?"embedding model available":"no embedding model configured (FTS-only mode, recall still functional)",Date.now()-m,{mode:u?"hybrid":"fts_only",model:u?"configured":"missing"});r.push(I),o.push({name:I.name,passed:true,message:I.message,details:I.details,severity:"ok"});let v=Date.now();if(i&&s)try{let d=["memory_facts","nodes","edges","meta"],l=s.query("SELECT name FROM sqlite_master WHERE type = ?",["table"]),C=new Set(l.map(F=>F.name)),T=d.filter(F=>!C.has(F)),D=N("schema",T.length===0?"ok":"error",T.length===0?`schema complete (${d.length} tables)`:`missing tables: ${T.join(", ")}`,Date.now()-v,{required:d,existing:Array.from(C)});r.push(D),o.push({name:D.name,passed:D.severity!=="error",message:D.message,details:D.details,severity:D.severity});}catch(d){let l=N("schema","error",`schema probe failed: ${d instanceof Error?d.message:String(d)}`,Date.now()-v);r.push(l),o.push({name:l.name,passed:false,message:l.message,details:l.details,severity:"error"});}else {let d=N("schema","info","skipped (db not initialized)",0);r.push(d),o.push({name:d.name,passed:true,message:d.message,severity:"info"});}let S=Date.now();try{let d=`${t.dbPath}-wal`,l=`${t.dbPath}-shm`,C=0,T=0;try{C=(await z$1.stat(d)).size;}catch{C=0;}try{T=(await z$1.stat(l)).size;}catch{T=0;}let D=C+T,F=D<=ct,$=N("lock",F?"ok":"warn",F?`no lock contention (wal+shm ${(D/1024).toFixed(1)} KB)`:`WAL/SHM files unusually large (${(D/1024/1024).toFixed(1)} MB > ${(ct/1024/1024).toFixed(0)} MB threshold)`,Date.now()-S,{walBytes:C,shmBytes:T});r.push($),o.push({name:$.name,passed:$.severity!=="error",message:$.message,details:$.details,severity:$.severity});}catch(d){let l=N("lock","error",`lock probe failed: ${d instanceof Error?d.message:String(d)}`,Date.now()-S);r.push(l),o.push({name:l.name,passed:false,message:l.message,details:l.details,severity:"error"});}let w=Date.now();try{let d=de.dirname(t.dbPath),l=await z$1.statfs(d),C=typeof l.bsize=="bigint"?Number(l.bsize)*l.bavail:l.bsize*l.bavail,T=C>=De,D=N("disk_space",T?"ok":"error",T?`sufficient disk space (${(C/1024/1024).toFixed(1)} MB available)`:`low disk space (${(C/1024/1024).toFixed(1)} MB < ${(De/1024/1024).toFixed(0)} MB threshold)`,Date.now()-w,{availableBytes:C,threshold:De});r.push(D),o.push({name:D.name,passed:D.severity!=="error",message:D.message,details:D.details,severity:D.severity});}catch(d){let l=N("disk_space","error",`disk_space probe failed: ${d instanceof Error?d.message:String(d)}`,Date.now()-w);r.push(l),o.push({name:l.name,passed:false,message:l.message,details:l.details,severity:"error"});}let h=Date.now();if(i&&s)try{let d=s.agentFilter(t.agentId),l=s.query(`SELECT id, node_ids FROM memory_facts ${d.where} ${d.where?"AND":"WHERE"} node_ids IS NOT NULL`,d.params),C=[];for(let D of l)try{let F=JSON.parse(D.node_ids);if(!Array.isArray(F))continue;for(let $ of F){if(typeof $!="number")continue;if((s.query("SELECT COUNT(*) as c FROM nodes WHERE id = ?",[$])[0]?.c??0)===0){C.push(`${D.id}->${$}`);break}}}catch{}let T=N("orphan",C.length===0?"ok":"warn",C.length===0?"no orphan KG references":`${C.length} orphan references: ${C.slice(0,5).join(", ")}${C.length>5?", ...":""}`,Date.now()-h,{count:C.length});r.push(T),o.push({name:T.name,passed:T.severity!=="error",message:T.message,details:T.details,severity:T.severity});}catch(d){let l=N("orphan","warn",`orphan probe failed: ${d instanceof Error?d.message:String(d)}`,Date.now()-h);r.push(l),o.push({name:l.name,passed:false,message:l.message,details:l.details,severity:"warn"});}else {let d=N("orphan","info","skipped (db not initialized)",0);r.push(d),o.push({name:d.name,passed:true,message:d.message,severity:"info"});}let b=Date.now(),R={"better-sqlite3":false,"node:sqlite":false,"@tursodatabase/database":false};try{let d=createRequire(import.meta.url);try{d.resolve("better-sqlite3"),R["better-sqlite3"]=!0;}catch{}R["node:sqlite"]=typeof process.versions.sqlite=="string";try{d.resolve("@tursodatabase/database"),R["@tursodatabase/database"]=!0;}catch{}}catch{}let y=R["better-sqlite3"]||R["node:sqlite"],E=N("backend",y?"ok":"error",y?`SQLite backend available (better-sqlite3: ${R["better-sqlite3"]}, node:sqlite: ${R["node:sqlite"]})`:"no SQLite backend available (install better-sqlite3 or use Node 22.5+)",Date.now()-b,R);r.push(E),o.push({name:E.name,passed:E.severity!=="error",message:E.message,details:E.details,severity:E.severity});let _=Date.now();if(i&&s)try{let d=s.query("SELECT COUNT(*) as c FROM embedding_cache")[0],l=s.agentFilter(t.agentId),C=s.query(`SELECT COUNT(*) as c FROM memory_facts ${l.where}`,l.params)[0],T=d?.c??0,D=C?.c??0,F=Math.max(0,T-D),$=F>0,ee=N("embedding_cache_unused","info",$?`by design: ${F} embedding_cache rows remain after fact deletion (cache is global content-hash dedup; forget intentionally doesn't cascade clear cache to preserve same-content hit rate)`:"embedding_cache in sync with memory_facts (no unused rows)",Date.now()-_,{cacheCount:T,factsCount:D,unused:F,policy:"global_content_hash_dedup"});r.push(ee),o.push({name:ee.name,passed:!$,message:ee.message,details:ee.details,severity:"info"});}catch(d){let l=N("embedding_cache_unused","info",`embedding_cache_unused probe failed: ${d instanceof Error?d.message:String(d)}`,Date.now()-_);r.push(l),o.push({name:l.name,passed:true,message:l.message,severity:"info"});}else {let d=N("embedding_cache_unused","info","skipped (db not initialized)",0);r.push(d),o.push({name:d.name,passed:true,message:d.message,severity:"info"});}let g=Date.now(),A;if(i&&s)try{let d=s.query("SELECT value FROM meta WHERE key = ?",["embeddingDims"]);A=d[0]?.value&&Number.parseInt(d[0].value,10)||void 0;}catch{}let O;if(n.skipLlm||!a$1.isInitialized()||!a$1.capabilities().embedding)O=N(EMBEDDING_DIMS_CONSISTENCY_CHECK,"info","llm not initialized; probe skipped",Date.now()-g);else if(n.skipEmbeddingProbe)O=N(EMBEDDING_DIMS_CONSISTENCY_CHECK,"info","probe skipped (--skip-embedding-probe)",Date.now()-g);else try{let d=a$1.getEmbeddingLlm?.();if(!d)O=N(EMBEDDING_DIMS_CONSISTENCY_CHECK,"info","embedding llm not exposed; probe skipped",Date.now()-g);else {let l=await probeEmbeddingDims(d,{timeoutMs:5e3});typeof l!="number"?O=N(EMBEDDING_DIMS_CONSISTENCY_CHECK,"info","probe failed (network / model error)",Date.now()-g):A===void 0?O=N(EMBEDDING_DIMS_CONSISTENCY_CHECK,"info",`probe=${l}, meta missing \u2014 next status will sync`,Date.now()-g):l!==A?O=N(EMBEDDING_DIMS_CONSISTENCY_CHECK,"warn",`probe=${l}, meta=${A} \u2014 mismatch`,Date.now()-g,{probe:l,meta:A}):O=N(EMBEDDING_DIMS_CONSISTENCY_CHECK,"ok",`probe=${l}, meta=${A} \u2014 consistent`,Date.now()-g);}}catch(d){O=N(EMBEDDING_DIMS_CONSISTENCY_CHECK,"info",`probe threw: ${d instanceof Error?d.message:String(d)}`,Date.now()-g);}r.push({...O,details:O.details??void 0,passed:O.severity!=="error"}),o.push({name:O.name,passed:O.severity!=="error",message:O.message,details:O.details??void 0,severity:O.severity});let q;if(i&&s){let d=Date.now();try{let{issues:l,stats:C}=s.checkIntegrity();q=C;for(let T of l)r.push(N("integrity_stats",T.severity,T.message,0,{source:"database.checkIntegrity"}));}catch(l){r.push(N("integrity_stats","warn",`db integrity check failed: ${l instanceof Error?l.message:String(l)}`,Date.now()-d));}}let j=!r.some(d=>d.severity==="error");s&&s.close();let Q=Date.now()-c;return {healthy:j,checks:r,legacyChecks:o,durationMs:Q,integrityStats:q,backendAvailable:R}}var ve={name:"recall",scope:"read",schema:$e,annotations:{localOnly:false,requiresAgentId:true,defaultDescription:"Query memory via hybrid search (FTS + vector); returns ranked facts.",readOnlyHint:true,destructiveHint:false,idempotentHint:true},handler:async(t,e)=>{let n=t;if(!e.agentId?.trim())throw new Error("recall: agentId is required");return qe({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:e.remote??false,config:e.config,agentId:e.agentId},n)}};var Ce={name:"remember",scope:"write",schema:He,annotations:{localOnly:false,requiresAgentId:true,defaultDescription:"Persist a new self-memory fact; auto-extract entities into KG.",readOnlyHint:false,destructiveHint:false,idempotentHint:false},handler:async(t,e)=>{let n=t;if(!e.agentId?.trim())throw new Error("remember: agentId is required");return Ve({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:e.remote??false,config:e.config,agentId:e.agentId},n)}};var Oe={name:"forget",scope:"write",schema:Ue,annotations:{localOnly:false,requiresAgentId:true,defaultDescription:"Delete memory facts by id / category / time range; supports dryRun.",readOnlyHint:false,destructiveHint:true,idempotentHint:true},handler:async(t,e)=>{let n=t;if(!e.agentId?.trim())throw new Error("forget: agentId is required");return Xe({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:e.remote??false,config:e.config,agentId:e.agentId},n)}};var Ne={name:"extract",scope:"write",schema:We,annotations:{localOnly:false,requiresAgentId:true,defaultDescription:"Extract facts from a session (server-side pulls messages by lastN).",readOnlyHint:false,destructiveHint:false,idempotentHint:true},handler:async(t,e)=>{let n=t;if(!e.agentId?.trim())throw new Error("extract: agentId is required");return Ze({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:e.remote??false,config:e.config,agentId:e.agentId},n)}};var Te={name:"consolidate",scope:"admin",schema:je,annotations:{localOnly:true,requiresAgentId:true,defaultDescription:"Run consolidation pipeline: dedup \u2192 archive.",readOnlyHint:false,destructiveHint:true,idempotentHint:true},handler:async(t,e)=>{let n=t;if(!e.isTrustedLocal)throw new Error("consolidate: only trusted local process can invoke this op");if(!e.agentId?.trim())throw new Error("consolidate: agentId is required");return et({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:false,config:e.config,agentId:e.agentId},n)}};var Pe={name:"sync",scope:"admin",schema:Ke,annotations:{localOnly:true,requiresAgentId:true,defaultDescription:"Sync memory facts to .md files (idempotent skip on existing) and archive expired active files (default 30 days)",readOnlyHint:false,destructiveHint:true,idempotentHint:true},handler:async(t,e)=>{let n=t;if(!e.isTrustedLocal)throw new Error("sync: only trusted local process can invoke this op");if(!e.agentId?.trim())throw new Error("sync: agentId is required");return nt({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:false,config:e.config,agentId:e.agentId},n)}};var ke={name:"graph_query",scope:"read",schema:Ge,annotations:{localOnly:false,requiresAgentId:true,defaultDescription:"Query KG nodes / edges / neighbors with scope filtering.",readOnlyHint:true,destructiveHint:false,idempotentHint:true},handler:async(t,e)=>{let n=t,r=e.agentId?.trim()||"default";return at({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:e.remote??false,config:e.config,agentId:r},n)}};var Ae={name:"status",scope:"read",schema:ze,annotations:{localOnly:false,requiresAgentId:false,defaultDescription:"Memory system status (factsCount / nodesCount / edgesCount / fts / vector).",readOnlyHint:true,destructiveHint:false,idempotentHint:true},handler:async(t,e)=>{let n=t??{};return it({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:e.remote??false,config:e.config,agentId:e.agentId},n)}};var xe={name:"doctor",scope:"admin",schema:Be,annotations:{localOnly:true,requiresAgentId:false,defaultDescription:"Run 7 health checks (database / fts / vector / schema / lock / disk_space / orphan).",readOnlyHint:true,destructiveHint:false,idempotentHint:true},handler:async(t,e)=>{let n=t??{};if(!e.isTrustedLocal)throw new Error("doctor: only trusted local process can invoke this op");return dt({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:false,config:e.config,agentId:e.agentId},n)}};var Le={name:"init",scope:"admin",schema:Qe,annotations:{localOnly:true,requiresAgentId:false,defaultDescription:"Initialize memory workspace (dirs + db schema + meta).",readOnlyHint:false,destructiveHint:false,idempotentHint:true},handler:async(t,e)=>{if(!e.isTrustedLocal)throw new Error("init: only trusted local process can invoke this op");let n=t??{};return st({workspaceDir:n.workspaceDir??e.workspaceDir??"",rootDir:n.workspaceDir??e.workspaceDir??"",dbPath:n.dbPath??e.dbPath??"",locale:e.locale??"en-US",remote:false,config:e.config,agentId:e.agentId??""},n)}};var mt={[ve.name]:ve,[Ce.name]:Ce,[Oe.name]:Oe,[Ne.name]:Ne,[Te.name]:Te,[Pe.name]:Pe,[ke.name]:ke,[Ae.name]:Ae,[xe.name]:xe,[Le.name]:Le},hr=Object.values(mt);function br(t,e,n){if(t.annotations.localOnly&&!e.isTrustedLocal)throw new Error(`MEMORY:executeOp: op "${n}" is localOnly; non-trusted caller rejected`);if(t.annotations.requiresAgentId){let r=e.agentId?.trim()??"";if(r.length===0)throw new Error(`MEMORY:executeOp: op "${n}" requires agentId`);e.agentId=r;}}async function Sa(t,e,n){let r=mt[t];if(!r)throw new Error(`executeOp: unknown op "${t}"; available: ${hr.map(c=>c.name).join(", ")}`);return br(r,n,t),await r.handler(e,n)}function Rr(t){let e=t.dbPath??"";return {workspaceDir:t.workspaceDir??"",database:{path:e},embeddingLlm:a$1.getEmbeddingLlm(),graphLlm:a$1.getGraphLlm(),search:DEFAULT_SEARCH_CONFIG,indexer:{batchSize:20,ignorePatterns:[],incremental:true},archiveDays:30,shortTermMaxRounds:20}}function Ta(t,e,n={}){let r=j(e),o=Locale.resolveLocaleLang(n.locale);return {agentId:t,dbPath:r,workspaceDir:e,rootDir:e,config:Rr({dbPath:r,workspaceDir:e}),isTrustedLocal:true,locale:o,remote:false,...n}}export{V as a,qe as b,$e as c,He as d,Ue as e,We as f,je as g,Ge as h,Qe as i,Ke as j,Ve as k,Xe as l,Ze as m,et as n,nt as o,at as p,st as q,it as r,dt as s,mt as t,hr as u,Sa as v,Rr as w,Ta as x};
|