@easbot/memory 0.3.40 → 0.3.41

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/README.en.md CHANGED
@@ -6,7 +6,8 @@ Long-term memory library for the EASBOT ecosystem (v0.4.0). Provides layered mem
6
6
 
7
7
  ## Version
8
8
 
9
- v0.3.40
9
+ v0.3.41
10
+
10
11
  ## Features (v0.4.0)
11
12
 
12
13
  - **10 op unified entry** (ADR 0069 +1 `sync`) — `recall / remember / forget / extract / consolidate / sync / graph_query / status / doctor / init`; MCP / CLI / Agent Tool share the same `executeOp(name, args, ctx)`.
@@ -255,7 +256,8 @@ import {
255
256
 
256
257
  #### Tool parameter contract (aligned with the host built-in tool)
257
258
 
258
- The plugin tool `args` match the host built-in `packages/agent/src/tool/memory.ts`
259
+ The plugin tool `args` match the host built-in implementation
260
+ (the former `packages/agent/src/tool/memory.ts`, removed together with the pluginisation)
259
261
  field by field, and now share its **shape** as well: a discriminated union
260
262
  `z.discriminatedUnion('operation', [...])` with one branch per op. Each branch
261
263
  declares only that op's parameters and is `.strict()` (undeclared fields are
package/README.md CHANGED
@@ -6,7 +6,8 @@ EASBOT 生态系统的长期记忆管理库(v0.4.0)。提供分层记忆、K
6
6
 
7
7
  ## 版本
8
8
 
9
- v0.3.40
9
+ v0.3.41
10
+
10
11
  ## 特性(v0.4.0)
11
12
 
12
13
  - **10 op 统一入口**(ADR 0069 +1 sync):`recall / remember / forget / extract / consolidate / sync / graph_query / status / doctor / init`,MCP / CLI / Agent Tool 三端共享。
@@ -241,7 +242,7 @@ import {
241
242
 
242
243
  #### 工具参数契约(对齐宿主内置工具)
243
244
 
244
- 插件工具的 `args` 与宿主内置 `packages/agent/src/tool/memory.ts` **逐字段一致**,
245
+ 插件工具的 `args` 与宿主内置实现(原 `packages/agent/src/tool/memory.ts`,已随插件化移除)**逐字段一致**,
245
246
  且**形态同为判别联合**:`z.discriminatedUnion('operation', [...])`,每个 op 一个分支,
246
247
  分支内只声明该 op 的参数(`.strict()` 拒绝未声明字段)。宿主
247
248
  `packages/agent/src/plugin/plugin.ts` 对**完整 zod schema 原样下发**(不再压平成扁平
package/dist/index.cjs CHANGED
@@ -1,38 +1,42 @@
1
- 'use strict';var chunk4CMSRWL3_cjs=require('./chunks/chunk-4CMSRWL3.cjs');require('./chunks/chunk-URADAZYW.cjs');var chunkBHGAFQCX_cjs=require('./chunks/chunk-BHGAFQCX.cjs'),chunk77ERAHDK_cjs=require('./chunks/chunk-77ERAHDK.cjs'),chunkIP7VEKQY_cjs=require('./chunks/chunk-IP7VEKQY.cjs'),chunkEKSLNNMF_cjs=require('./chunks/chunk-EKSLNNMF.cjs'),chunkAVECFV5K_cjs=require('./chunks/chunk-AVECFV5K.cjs'),chunkNHRRIJFK_cjs=require('./chunks/chunk-NHRRIJFK.cjs'),chunkGCVKM3RJ_cjs=require('./chunks/chunk-GCVKM3RJ.cjs'),chunkR32346OA_cjs=require('./chunks/chunk-R32346OA.cjs'),types=require('@easbot/types'),k=require('jieba-wasm'),utils=require('@easbot/utils'),plugin=require('@easbot/plugin'),crypto=require('crypto'),llm=require('@easbot/llm'),ai=require('ai'),fs=require('fs'),terminal=require('@easbot/terminal'),zod=require('zod');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 k__namespace=/*#__PURE__*/_interopNamespace(k);var nr=["user_preference","task_context","technical_fact","decision","relationship","reminder","error_pattern","workflow","exploration_finding","experience_summary","tool_usage","skill_creation","test","other"];var f=utils.Log.create({service:"memory.tokenizer"}),I=false,gt=utils.loadTextFile("./assets/jieba_dict.txt",chunkR32346OA_cjs.d);async function ur(e){if(!I)try{f.debug("Initializing jieba tokenizer");let r=gt();if(k__namespace.with_dict(r),f.debug("Built-in dictionary loaded"),e?.dictPath&&e.dictPath.length>0)for(let t of e.dictPath)await ft(t);I=!0,f.debug("Jieba tokenizer initialized successfully");}catch(r){f.error("Failed to initialize jieba tokenizer",{error:utils.errorMeta(r)}),f.warn("Using fallback tokenization (space-based)");}}async function ft(e){if(!I)throw new chunkAVECFV5K_cjs.a.TokenizerNotInitializedError({message:"Tokenizer not initialized"});try{let r=await utils.Filesystem.readText(e);f.debug("Loading custom dictionary",{dictPath:e}),k__namespace.with_dict(r),f.debug("Custom dictionary loaded successfully",{dictPath:e});}catch(r){f.warn("Failed to load custom dictionary",{dictPath:e,error:utils.errorMeta(r)});}}function yt(e){if(!I)return e.split(/\s+/).filter(Boolean);try{return k__namespace.cut(e)}catch(r){return f.warn("Tokenization failed, using fallback",{error:utils.errorMeta(r)}),e.split(/\s+/).filter(Boolean)}}function Mt(e){if(!I)return e.split(/\s+/).filter(Boolean);try{return k__namespace.cut_for_search(e)}catch(r){return f.warn("Tokenization for search failed, using fallback",{error:utils.errorMeta(r)}),e.split(/\s+/).filter(Boolean)}}function gr(e,r,t){if(I)try{k__namespace.add_word(e,r,t),f.debug("Word added to dictionary",{word:e,freq:r,tag:t});}catch(o){f.warn("Failed to add word",{word:e,error:utils.errorMeta(o)});}}function fr(){return I}async function yr(){I=false,f.debug("Tokenizer closed");}function Mr(e){if(!I)return e.split(/\s+/).filter(Boolean).join(" ");try{return yt(e).join(" ")}catch(r){return f.warn("Tokenization failed, using fallback",{error:utils.errorMeta(r)}),e.split(/\s+/).filter(Boolean).join(" ")}}function xr(e){if(!I)return e.split(/\s+/).filter(Boolean).join(" ");try{return Mt(e).join(" ")}catch(r){return f.warn("Tokenization for search failed, using fallback",{error:utils.errorMeta(r)}),e.split(/\s+/).filter(Boolean).join(" ")}}var Q="memory",J="0.3.39",$={name:Q,version:J,description:"EASBot memory plugin: lifecycle hooks and memory tool",entry:"./index.mjs",capabilities:["hooks","tools"]};async function h(){return chunkNHRRIJFK_cjs.d.exists()}function y(e,r){if(typeof e!="object"||e===null)return;let t=e;for(let o of r){let n=t[o];if(typeof n=="string"&&n.length>0)return n}}function ke(e){if(typeof e!="object"||e===null)return {};let r=e.extras;return typeof r=="object"&&r!==null&&!Array.isArray(r)?r:{}}function he(e){if(typeof e!="object"||e===null)return;let r=e.protocolMetadata;if(typeof r!="object"||r===null)return;let t=r.agentId;return typeof t=="string"&&t.length>0?t:void 0}function S(e,r){let t={...ke(e),...ke(r)};return {agentId:y(r,["agentId"])??he(e)??he(r)??y(e,["agentId"])??y(r,["agent"])??y(e,["agent"])??"",sessionId:y(r,["sessionId"])??y(e,["sessionId"]),toolName:y(e,["toolName","tool","name"])??y(r,["toolName"]),error:y(e,["error","message"])??y(r,["error"]),messagePreview:y(e,["messagePreview"])??y(r,["messagePreview"]),contextPreview:y(e,["contextPreview","text","prompt"])??y(r,["contextPreview"]),extras:t}}function H(e){let r=chunkGCVKM3RJ_cjs.f().worktree,t=chunkGCVKM3RJ_cjs.j(r),o=e.trim()||"memory-plugin";return {agentId:o,isTrustedLocal:true,remote:false,locale:"en-US",dbPath:t,workspaceDir:r,rootDir:r,config:chunk77ERAHDK_cjs.A({agentId:o,dbPath:t,workspaceDir:r})}}function M(e,r){return {modified:false,input:e,output:{...r}}}function _e(e,r){return y(e,[r])}var X=utils.Log.create({service:"memory.plugin.hook"}),we=1200;function kt(e,r){let t=e;for(let n of [t?.query,r.query])if(typeof n=="string"&&n.trim().length>0)return n;return _e(e,"userMessage")??""}var G=async(e,r)=>{let t=plugin.HookEvent.ContextCollect,o=S(e,r);if(!o.agentId.trim())return {modified:false,input:e,output:{hook:t,ok:false,error:"context collect: agentId is required",fragments:[]}};if(!await h())return X.debug("context.collect: memory not configured, skip recall"),{modified:false,input:e,output:{hook:t,ok:true,fragments:[],logLine:"memory not configured"}};let n=typeof o.extras.topK=="number"?o.extras.topK:5,d=kt(e,o.extras);if(d.trim().length===0)return X.debug("context.collect: empty query, skip recall"),{modified:false,input:e,output:{hook:t,ok:true,fragments:[],logLine:"context collect: empty query"}};try{let c=await chunk77ERAHDK_cjs.z("recall",{query:d,maxResults:n},H(o.agentId));if(c.hits.length===0)return {modified:!1,input:e,output:{hook:t,ok:!0,fragments:[],logLine:"context collect: no facts found"}};let m=c.hits.map(i=>`- [${i.category}/imp=${i.importance}] ${i.snippet}`).join(`
2
- `),s=await utils.TruncateContent.truncate(m,{maxChars:Math.min(we*4,utils.TruncateContent.DEFAULT_MAX_CHARS),label:"memory recall fragments"}),a={id:"memory:recall",title:"Relevant Memory",content:s.content,source:"memory",order:10,markers:["<memory-recall>","</memory-recall>"]};return {modified:!1,input:e,output:{hook:t,ok:!0,fragments:[a],logLine:`context collect: contributed ${c.hits.length} facts${s.truncated?" (truncated; full content saved for agent read-back)":""}`}}}catch(c){let m=utils.errorMeta(c);return X.warn("memory context collect hook failed",{error:m}),{modified:false,input:e,output:{hook:t,ok:false,error:m.message,fragments:[]}}}};var Re=utils.Log.create({service:"memory.plugin.hook"}),wt=200,Y=async(e,r)=>{let t=plugin.HookEvent.SessionCompacting,o=S(e,r);if(!o.agentId.trim())return M(e,{hook:t,ok:false,error:"pre compact: agentId is required"});if(!await h())return Re.debug("pre-compact: memory not configured, skip recall"),M(e,{hook:t,ok:true,context:[],logLine:"memory not configured"});let d=(o.contextPreview??o.messagePreview??"").slice(0,wt).replace(/\s+/g," ").trim(),c=typeof o.extras.topK=="number"?o.extras.topK:3;if(!d)return M(e,{hook:t,ok:true,context:[],logLine:"pre compact: empty context preview; skipping recall injection"});try{let m=await chunk77ERAHDK_cjs.z("recall",{query:d,maxResults:c,minImportance:5},H(o.agentId));if(m.hits.length===0)return M(e,{hook:t,ok:!0,context:[],logLine:"pre compact: no facts matched query"});let s=m.hits.map(i=>`- [${i.category}/imp=${i.importance}] ${i.snippet.slice(0,150)}`),a=`[memory:pre-compact recall top-${m.hits.length} (imp>=5)]
1
+ 'use strict';var chunk4CMSRWL3_cjs=require('./chunks/chunk-4CMSRWL3.cjs');require('./chunks/chunk-URADAZYW.cjs');var chunkBHGAFQCX_cjs=require('./chunks/chunk-BHGAFQCX.cjs'),chunk77ERAHDK_cjs=require('./chunks/chunk-77ERAHDK.cjs'),chunkIP7VEKQY_cjs=require('./chunks/chunk-IP7VEKQY.cjs'),chunkEKSLNNMF_cjs=require('./chunks/chunk-EKSLNNMF.cjs'),chunkAVECFV5K_cjs=require('./chunks/chunk-AVECFV5K.cjs'),chunkNHRRIJFK_cjs=require('./chunks/chunk-NHRRIJFK.cjs'),chunkGCVKM3RJ_cjs=require('./chunks/chunk-GCVKM3RJ.cjs'),chunkR32346OA_cjs=require('./chunks/chunk-R32346OA.cjs'),types=require('@easbot/types'),_=require('jieba-wasm'),utils=require('@easbot/utils'),plugin=require('@easbot/plugin'),crypto=require('crypto'),llm=require('@easbot/llm'),fs=require('fs'),terminal=require('@easbot/terminal'),zod=require('zod');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 ___namespace=/*#__PURE__*/_interopNamespace(_);var pr=["user_preference","task_context","technical_fact","decision","relationship","reminder","error_pattern","workflow","exploration_finding","experience_summary","tool_usage","skill_creation","test","other"];var M=utils.Log.create({service:"memory.tokenizer"}),h=false,bt=utils.loadTextFile("./assets/jieba_dict.txt",chunkR32346OA_cjs.d);async function kr(e){if(!h)try{M.debug("Initializing jieba tokenizer");let r=bt();if(___namespace.with_dict(r),M.debug("Built-in dictionary loaded"),e?.dictPath&&e.dictPath.length>0)for(let t of e.dictPath)await It(t);h=!0,M.debug("Jieba tokenizer initialized successfully");}catch(r){M.error("Failed to initialize jieba tokenizer",{error:utils.errorMeta(r)}),M.warn("Using fallback tokenization (space-based)");}}async function It(e){if(!h)throw new chunkAVECFV5K_cjs.a.TokenizerNotInitializedError({message:"Tokenizer not initialized"});try{let r=await utils.Filesystem.readText(e);M.debug("Loading custom dictionary",{dictPath:e}),___namespace.with_dict(r),M.debug("Custom dictionary loaded successfully",{dictPath:e});}catch(r){M.warn("Failed to load custom dictionary",{dictPath:e,error:utils.errorMeta(r)});}}function kt(e){if(!h)return e.split(/\s+/).filter(Boolean);try{return ___namespace.cut(e)}catch(r){return M.warn("Tokenization failed, using fallback",{error:utils.errorMeta(r)}),e.split(/\s+/).filter(Boolean)}}function ht(e){if(!h)return e.split(/\s+/).filter(Boolean);try{return ___namespace.cut_for_search(e)}catch(r){return M.warn("Tokenization for search failed, using fallback",{error:utils.errorMeta(r)}),e.split(/\s+/).filter(Boolean)}}function hr(e,r,t){if(h)try{___namespace.add_word(e,r,t),M.debug("Word added to dictionary",{word:e,freq:r,tag:t});}catch(o){M.warn("Failed to add word",{word:e,error:utils.errorMeta(o)});}}function _r(){return h}async function Er(){h=false,M.debug("Tokenizer closed");}function wr(e){if(!h)return e.split(/\s+/).filter(Boolean).join(" ");try{return kt(e).join(" ")}catch(r){return M.warn("Tokenization failed, using fallback",{error:utils.errorMeta(r)}),e.split(/\s+/).filter(Boolean).join(" ")}}function Rr(e){if(!h)return e.split(/\s+/).filter(Boolean).join(" ");try{return ht(e).join(" ")}catch(r){return M.warn("Tokenization for search failed, using fallback",{error:utils.errorMeta(r)}),e.split(/\s+/).filter(Boolean).join(" ")}}var ee="memory",te="0.3.40",Y={name:ee,version:te,description:"EASBot memory plugin: lifecycle hooks and memory tool",entry:"./index.mjs",capabilities:["hooks","tools"]};async function E(){return chunkNHRRIJFK_cjs.d.exists()}function x(e,r){if(typeof e!="object"||e===null)return;let t=e;for(let o of r){let n=t[o];if(typeof n=="string"&&n.length>0)return n}}function _e(e){if(typeof e!="object"||e===null)return {};let r=e.extras;return typeof r=="object"&&r!==null&&!Array.isArray(r)?r:{}}function Ee(e){if(typeof e!="object"||e===null)return;let r=e.protocolMetadata;if(typeof r!="object"||r===null)return;let t=r.agentId;return typeof t=="string"&&t.length>0?t:void 0}function S(e,r){let t={..._e(e),..._e(r)};return {agentId:x(r,["agentId"])??Ee(e)??Ee(r)??x(e,["agentId"])??x(r,["agent"])??x(e,["agent"])??"",sessionId:x(r,["sessionId"])??x(e,["sessionId"]),toolName:x(e,["toolName","tool","name"])??x(r,["toolName"]),error:x(e,["error","message"])??x(r,["error"]),messagePreview:x(e,["messagePreview"])??x(r,["messagePreview"]),contextPreview:x(e,["contextPreview","text","prompt"])??x(r,["contextPreview"]),extras:t}}function H(e){let r=chunkGCVKM3RJ_cjs.f().worktree,t=chunkGCVKM3RJ_cjs.j(r),o=e.trim()||"memory-plugin";return {agentId:o,isTrustedLocal:true,remote:false,locale:"en-US",dbPath:t,workspaceDir:r,rootDir:r,config:chunk77ERAHDK_cjs.A({agentId:o,dbPath:t,workspaceDir:r})}}function b(e,r){return {modified:false,input:e,output:{...r}}}function we(e,r){return x(e,[r])}var re=utils.Log.create({service:"memory.plugin.hook"}),Oe=1200;function Rt(e,r){let t=e;for(let n of [t?.query,r.query])if(typeof n=="string"&&n.trim().length>0)return n;return we(e,"userMessage")??""}var K=async(e,r)=>{let t=plugin.HookEvent.ContextCollect,o=S(e,r);if(!o.agentId.trim())return {modified:false,input:e,output:{hook:t,ok:false,error:"context collect: agentId is required",fragments:[]}};if(!await E())return re.debug("context.collect: memory not configured, skip recall"),{modified:false,input:e,output:{hook:t,ok:true,fragments:[],logLine:"memory not configured"}};let n=typeof o.extras.topK=="number"?o.extras.topK:5,d=Rt(e,o.extras);if(d.trim().length===0)return re.debug("context.collect: empty query, skip recall"),{modified:false,input:e,output:{hook:t,ok:true,fragments:[],logLine:"context collect: empty query"}};try{let p=await chunk77ERAHDK_cjs.z("recall",{query:d,maxResults:n},H(o.agentId));if(p.hits.length===0)return {modified:!1,input:e,output:{hook:t,ok:!0,fragments:[],logLine:"context collect: no facts found"}};let i=p.hits.map(u=>`- [${u.category}/imp=${u.importance}] ${u.snippet}`).join(`
2
+ `),s=await utils.TruncateContent.truncate(i,{maxChars:Math.min(Oe*4,utils.TruncateContent.DEFAULT_MAX_CHARS),label:"memory recall fragments"}),a={id:"memory:recall",title:"Relevant Memory",content:s.content,source:"memory",order:10,markers:["<memory-recall>","</memory-recall>"]};return {modified:!1,input:e,output:{hook:t,ok:!0,fragments:[a],logLine:`context collect: contributed ${p.hits.length} facts${s.truncated?" (truncated; full content saved for agent read-back)":""}`}}}catch(p){let i=utils.errorMeta(p);return re.warn("memory context collect hook failed",{error:i}),{modified:false,input:e,output:{hook:t,ok:false,error:i.message,fragments:[]}}}};var Pe=utils.Log.create({service:"memory.plugin.hook"}),Ht=200,j=async(e,r)=>{let t=plugin.HookEvent.SessionCompacting,o=S(e,r);if(!o.agentId.trim())return b(e,{hook:t,ok:false,error:"pre compact: agentId is required"});if(!await E())return Pe.debug("pre-compact: memory not configured, skip recall"),b(e,{hook:t,ok:true,context:[],logLine:"memory not configured"});let d=(o.contextPreview??o.messagePreview??"").slice(0,Ht).replace(/\s+/g," ").trim(),p=typeof o.extras.topK=="number"?o.extras.topK:3;if(!d)return b(e,{hook:t,ok:true,context:[],logLine:"pre compact: empty context preview; skipping recall injection"});try{let i=await chunk77ERAHDK_cjs.z("recall",{query:d,maxResults:p,minImportance:5},H(o.agentId));if(i.hits.length===0)return b(e,{hook:t,ok:!0,context:[],logLine:"pre compact: no facts matched query"});let s=i.hits.map(u=>`- [${u.category}/imp=${u.importance}] ${u.snippet.slice(0,150)}`),a=`[memory:pre-compact recall top-${i.hits.length} (imp>=5)]
3
3
  ${s.join(`
4
- `)}`;return M(e,{hook:t,ok:!0,context:[a],logLine:`pre compact: injected ${m.hits.length} facts before compaction`})}catch(m){let s=utils.errorMeta(m);return Re.warn("memory pre compact hook failed",{error:s}),M(e,{hook:t,ok:false,error:s.message})}};var Oe=utils.Log.create({service:"memory.plugin.hook"}),Pt=8,j=async(e,r)=>{let t=plugin.HookEvent.ToolFailure,o=S(e,r);if(!o.agentId.trim())return M(e,{hook:t,ok:false,error:"tool failure: agentId is required"});if(!o.toolName?.trim()||!o.error?.trim())return M(e,{hook:t,ok:false,error:"tool failure: toolName and error are required"});if(!await h())return Oe.debug("tool.failure: memory not configured, skip remember"),M(e,{hook:t,ok:true,logLine:"memory not configured"});let n=crypto.createHash("sha256").update(`${o.toolName}:${o.error}`).digest("hex").slice(0,Pt),d=o.messagePreview?o.messagePreview.slice(0,200).replace(/\s+/g," ").trim():"",c=[`[error_pattern] tool=${o.toolName}`,`[error] ${o.error}`,d?`[preview] ${d}`:"",`[errHash] ${n}`].filter(Boolean).join(`
5
- `);try{let m=await chunk77ERAHDK_cjs.z("remember",{content:c,category:"error_pattern",importance:6,tags:["post-tool-failure",`tool:${o.toolName}`,`err:${n}`],sessionId:o.sessionId,msgId:typeof o.extras.msgId=="string"?o.extras.msgId:void 0},H(o.agentId));return M(e,{hook:t,ok:!0,logLine:`tool failure: wrote error_pattern fact ${m.fact.id} (tool=${o.toolName}, errHash=${n})`})}catch(m){let s=utils.errorMeta(m);return Oe.warn("memory tool failure hook failed",{error:s}),M(e,{hook:t,ok:false,error:s.message})}};var b=utils.Log.create({service:"memory.plugin.extract"}),Se=2e3,Dt=4096,He="memory",Pe=["memory","read","glob","grep"];function Ft(e){return (e??[]).filter(r=>r.type==="text"&&!r.synthetic&&!r.ignored).map(r=>r.text??"").join("")}async function $t(e,r){let t=[];for(let n of await e.messagesByParent(r)){if(n.role!=="assistant")continue;let d=n.parts.filter(c=>c.type==="text").map(c=>c.text??"").join("");d&&t.push({role:"assistant",content:d});}let o=await e.message(r);if(o&&o.role==="user"){let n=Ft(o.parts);n&&t.push({role:"user",content:n});}return t}async function Gt(e){if(e.length===0)return "";let r=`### Our Conversation
4
+ `)}`;return b(e,{hook:t,ok:!0,context:[a],logLine:`pre compact: injected ${i.hits.length} facts before compaction`})}catch(i){let s=utils.errorMeta(i);return Pe.warn("memory pre compact hook failed",{error:s}),b(e,{hook:t,ok:false,error:s.message})}};var Se=utils.Log.create({service:"memory.plugin.hook"}),At=8,q=async(e,r)=>{let t=plugin.HookEvent.ToolFailure,o=S(e,r);if(!o.agentId.trim())return b(e,{hook:t,ok:false,error:"tool failure: agentId is required"});if(!o.toolName?.trim()||!o.error?.trim())return b(e,{hook:t,ok:false,error:"tool failure: toolName and error are required"});if(!await E())return Se.debug("tool.failure: memory not configured, skip remember"),b(e,{hook:t,ok:true,logLine:"memory not configured"});let n=crypto.createHash("sha256").update(`${o.toolName}:${o.error}`).digest("hex").slice(0,At),d=o.messagePreview?o.messagePreview.slice(0,200).replace(/\s+/g," ").trim():"",p=[`[error_pattern] tool=${o.toolName}`,`[error] ${o.error}`,d?`[preview] ${d}`:"",`[errHash] ${n}`].filter(Boolean).join(`
5
+ `);try{let i=await chunk77ERAHDK_cjs.z("remember",{content:p,category:"error_pattern",importance:6,tags:["post-tool-failure",`tool:${o.toolName}`,`err:${n}`],sessionId:o.sessionId,msgId:typeof o.extras.msgId=="string"?o.extras.msgId:void 0},H(o.agentId));return b(e,{hook:t,ok:!0,logLine:`tool failure: wrote error_pattern fact ${i.fact.id} (tool=${o.toolName}, errHash=${n})`})}catch(i){let s=utils.errorMeta(i);return Se.warn("memory tool failure hook failed",{error:s}),b(e,{hook:t,ok:false,error:s.message})}};var k=utils.Log.create({service:"memory.plugin.extract"}),He=2e3,Yt=4096,Kt=6e4,jt=5,Te="memory",ve=["memory","read","glob","grep"];function qt(e){return (e??[]).filter(r=>r.type==="text"&&!r.synthetic&&!r.ignored).map(r=>r.text??"").join("")}async function Bt(e,r){let t=[];for(let n of await e.messagesByParent(r)){if(n.role!=="assistant")continue;let d=n.parts.filter(p=>p.type==="text").map(p=>p.text??"").join("");d&&t.push({role:"assistant",content:d});}let o=await e.message(r);if(o&&o.role==="user"){let n=qt(o.parts);n&&t.push({role:"user",content:n});}return t}async function Ut(e){if(e.length===0)return "";let r=`### Our Conversation
6
6
 
7
- `;for(let t of e){let o=utils.Token.estimate(t.content),n=t.content,d=false;if(o>Se){n=t.content.slice(-8e3),d=true;}d?r+=`**${t.role==="user"?"User":"Me"}**: ${n}
7
+ `;for(let t of e){let o=utils.Token.estimate(t.content),n=t.content,d=false;if(o>He){n=t.content.slice(-8e3),d=true;}d?r+=`**${t.role==="user"?"User":"Me"}**: ${n}
8
8
 
9
9
  [Content truncated from ${o} tokens]
10
10
 
11
11
  `:r+=`**${t.role==="user"?"User":"Me"}**: ${n||"(empty)"}
12
12
 
13
- `;}return r}async function Yt(){let r=(await llm.Agent.get(He))?.prompt?.trim();if(!r)throw new Error(`memory extract: agent "${He}" has no prompt (\u8BB0\u5FC6\u89C4\u8303\u7F3A\u5931)`);return r}async function jt(e,r,t,o,n){let d=o.agent||await llm.Agent.defaultAgent(),c=d?await llm.Agent.get(d):void 0;if(!c)throw new Error(`memory extract: agent not found (${d})`);let m=o.model??await llm.Provider.defaultModel(),s=typeof m=="string"?llm.Provider.parseModel(m):m,a=await llm.Provider.getModel(s.providerId,s.modelId),i=await t.get();if(!i)throw new Error(`memory extract: session not found (${e.sessionId})`);let p=r.identity?.();if(!p)throw new Error("memory extract: identity capability unavailable");let{metadata:v,initialized:_}=await p.protocol(),se=i.contextMode??types.DefaultContextMode,De=await Yt(),Fe=await p.staticPrompt({agent:c,model:{providerId:a.providerId,modelId:a.api?.id??a.id},workspaceDir:i.directory,mode:se}),$e=await p.environment({agent:c,model:{providerId:a.providerId,modelId:a.api?.id??a.id},mode:se}),Ge=[utils.Markdown.replaceVariables(De,v),...Fe.map(z=>z.content),...$e],Ye=await t.tools({agent:c.name,model:{providerId:a.providerId,modelId:a.api?.id??a.id},toolFilter:z=>Pe.includes(z)}),je=`Review the conversation below and decide what is worth remembering. Store it with the \`memory\` tool.
13
+ `;}return r}async function zt(){let r=(await llm.Agent.get(Te))?.prompt?.trim();if(!r)throw new Error(`memory extract: agent "${Te}" has no prompt (\u8BB0\u5FC6\u89C4\u8303\u7F3A\u5931)`);return r}async function Vt(e,r,t,o,n){let d=o.agent||await llm.Agent.defaultAgent(),p=d?await llm.Agent.get(d):void 0;if(!p)throw new Error(`memory extract: agent not found (${d})`);let i=o.model??await llm.Provider.defaultModel(),s=typeof i=="string"?llm.Provider.parseModel(i):i,a=await llm.Provider.getModel(s.providerId,s.modelId),u=await t.get();if(!u)throw new Error(`memory extract: session not found (${e.sessionId})`);let l=r.identity?.();if(!l)throw new Error("memory extract: identity capability unavailable");let{metadata:y,initialized:m}=await l.protocol(),$=u.contextMode??types.DefaultContextMode,je=await zt(),qe=await l.staticPrompt({agent:p,model:{providerId:a.providerId,modelId:a.api?.id??a.id},workspaceDir:u.directory,mode:$}),Be=await l.environment({agent:p,model:{providerId:a.providerId,modelId:a.api?.id??a.id},mode:$}),Ue=[utils.Markdown.replaceVariables(je,y),...qe.map(Q=>Q.content),...Be],ze=await t.tools({agent:p.name,model:{providerId:a.providerId,modelId:a.api?.id??a.id},toolFilter:Q=>ve.includes(Q)}),Ve=`Review the conversation below and decide what is worth remembering. Store it with the \`memory\` tool.
14
14
 
15
- ${await Gt(n)}`,ie=await llm.LanguageProvider.generate({user:{id:utils.Identifier.ascending("message"),sessionId:e.sessionId,model:o.model??{providerId:a.providerId,modelId:a.api?.id??a.id}},sessionId:e.sessionId,agent:c,system:Ge,model:a,temperature:llm.Provider.LIMITS.TEMPERATURE.SUMMARY,maxOutputTokens:Dt,messages:[{role:"user",content:[{type:"text",text:je}]}],tools:Ye,activeTools:Pe,stopWhen:ai.stepCountIs(5),abort:new AbortController().signal});return b.debug("memory extract finished",{sessionId:e.sessionId,outputLength:ie.text.length}),ie.text}async function Z(e,r,t,o,n){try{await e.updatePart({...t,messageId:r,status:n.status,time:{start:o,end:Date.now()},...n.result!==void 0?{result:n.result}:{},...n.error!==void 0?{error:n.error}:{},...n.reason!==void 0?{reason:n.reason}:{}});}catch(d){b.error("memory part status update failed",{error:utils.errorMeta(d),status:n.status});}}async function Te(e,r){let t=e;if(!t.userMessageId)return b.debug("loop.end: no userMessageId, skip"),{modified:false,input:e};if(!await h())return b.debug("loop.end: memory not configured, skip extract"),{modified:false,input:e};let o=`${t.sessionId}:${t.userMessageId}`;if(b.debug("loop.end: memory extract started",{loopKey:o,step:t.step,result:t.result}),r.agent&&await llm.Agent.isSubagent(r.agent))return b.debug("loop.end: skip memory extract, subagent",{loopKey:o}),{modified:false,input:e};let n=r.session?.(t.sessionId);if(!n)return b.debug("loop.end: skip memory extract, session capability unavailable",{loopKey:o}),{modified:false,input:e};let d=await n.message(t.userMessageId);if(!d)return b.debug("loop.end: user message not found, skip",{loopKey:o}),{modified:false,input:e};if(d.parts.some(p=>p.type==="memory"))return b.debug("loop.end: skip memory extract, already processed"),{modified:false,input:e};let c=utils.Identifier.ascending("part"),m=Date.now(),s={id:c,type:"memory",status:"in_progress",time:{start:m}};await n.updatePart({...s,messageId:t.userMessageId});let a=await $t(n,t.userMessageId);return a.some(p=>p.role==="assistant"&&p.content)?(jt(t,r,n,d,a).then(p=>Z(n,t.userMessageId,s,m,{status:"completed",result:p})).catch(p=>(b.error("memory extract failed",{error:utils.errorMeta(p)}),Z(n,t.userMessageId,s,m,{status:"failed",error:utils.errorMeta(p).message}))),{modified:false,input:e}):(b.debug("loop.end: skip memory extract, no assistant text content",{loopKey:o}),await Z(n,t.userMessageId,s,m,{status:"skipped",reason:"No assistant text content"}),{modified:false,input:e})}var w=[{event:plugin.HookEvent.ContextCollect,handler:G},{event:plugin.HookEvent.SessionCompacting,handler:Y},{event:plugin.HookEvent.ToolFailure,handler:j},{event:plugin.HookEvent.LoopEnd,handler:Te}];function N(){return w.map(({event:e,handler:r})=>({event:e,hooks:[{type:"function",handler:r}]}))}var A=utils.Log.create({service:"memory.plugin.tool"}),oe="memory",ne=["recall","remember","update","forget","extract","graph_query","status"],Jt=500,Ce="Access EASBot long-term memory via `operation` (recall / remember / update / forget / extract / graph_query / status).",te=zod.z.enum(["user_preference","task_context","technical_fact","decision","relationship","reminder","error_pattern","workflow","exploration_finding","experience_summary","tool_usage","skill_creation","test","other"]),Ne=zod.z.discriminatedUnion("operation",[zod.z.object({operation:zod.z.literal("recall"),query:zod.z.string().describe("Search query text"),limit:utils.Schema.positiveInt.optional().default(10).describe("Max results (default 10)"),category:te.optional().describe("Filter by memory category"),minImportance:utils.Schema.positiveInt.optional().refine(e=>e===void 0||e>=1&&e<=10,{message:"minImportance must be in [1, 10] (inclusive); the service uses `WHERE importance >= ?` SQL"}).describe("INCLUSIVE `>=` filter on 1-10 importance scale; e.g. `5` keeps importance 5"),minScore:zod.z.number().min(0).max(1).optional().describe("Minimum relevance score filter (default 0; range [0, 1])"),maxEdgesPerNode:utils.Schema.positiveInt.optional().default(10).refine(e=>e===void 0||e>=1&&e<=100,{message:"maxEdgesPerNode must be in [1, 100]"}).describe("Max edges per KG neighbor node returned by recall (default 10; range [1, 100])"),includeGraph:zod.z.boolean().optional().default(false).describe("Include KG neighbor subgraph (default false; pass true to get BFS neighbors alongside hits)"),includeShared:zod.z.boolean().optional().default(false).describe("Include shared KG nodes from other agents (requires trusted local; default false)")}).strict(),zod.z.object({operation:zod.z.literal("remember"),content:zod.z.string().describe("Memory content"),category:te.describe("Memory category"),importance:utils.Schema.positiveInt.describe("Importance 1-10 (service layer enforces range)"),tags:utils.Schema.stringArray.optional().describe("Optional tags (string[])")}).strict(),zod.z.object({operation:zod.z.literal("update"),factId:zod.z.string().describe("Target fact id (must belong to ctx.agentId)"),content:zod.z.string().optional().describe("New content (triggers embedding rewrite + FTS reindex)"),category:te.optional().describe("New category"),importance:utils.Schema.positiveInt.optional().describe("New importance 1-10"),tags:utils.Schema.stringArray.optional().describe("New tags (string[]; empty array clears tags)")}).strict().refine(e=>e.content!==void 0||e.category!==void 0||e.importance!==void 0||e.tags!==void 0,{message:"update requires at least one of: `content`, `category`, `importance`, `tags`"}),zod.z.object({operation:zod.z.literal("forget"),factId:zod.z.string().describe("Target fact id to delete (required; must belong to ctx.agentId)"),dryRun:zod.z.boolean().optional().default(false).describe("Preview without deleting (returns matched count, never deletes)"),force:zod.z.boolean().optional().default(false).describe("Skip KG reference check and delete anyway (required when fact is referenced by other facts; use after dryRun confirms the match)")}).strict(),zod.z.object({operation:zod.z.literal("extract"),lastN:utils.Schema.positiveInt.optional().default(10).describe("Recent messages (default 10)"),fromMessageId:zod.z.string().optional().describe("Process messages after this id")}).strict(),zod.z.object({operation:zod.z.literal("graph_query"),nodeId:utils.Schema.positiveInt.describe("KG node ID to start BFS from; get it from a recall hit or a prior graph_query result"),maxDepth:utils.Schema.positiveInt.optional().default(2).describe("BFS depth for neighbor expansion (default 2; service range [1, 5])"),maxNodes:utils.Schema.nonNegativeInt.optional().default(100).describe("Max nodes returned after BFS (default 100; service max 500)"),maxEdgesPerNode:utils.Schema.positiveInt.optional().default(10).refine(e=>e===void 0||e>=1&&e<=100,{message:"maxEdgesPerNode must be in [1, 100]"}).describe("Max edges per BFS neighbor node (default 10; range [1, 100])"),relation:zod.z.string().optional().describe('Edge relation filter (e.g. "uses"; single-value exact match; differs from note.graph_query relationTypes[])'),type:zod.z.string().optional().describe('Node type filter for root node (e.g. "decision"; only affects CLI query path; nodeId path bypasses)')}).strict(),zod.z.object({operation:zod.z.literal("status")}).strict()]),ae=Ne;function Xt(){try{let e=utils.loadTextFile("./memory.txt",chunkR32346OA_cjs.d)();return e.trim().length>0?e:Ce}catch(e){return A.warn("memory tool description unavailable, using fallback",{error:utils.errorMeta(e)}),Ce}}function Zt(e){let r=e.agent?.trim();if(!r)throw new utils.NameErrors.MissingFieldError({message:"memory tool: agentId is required (ctx.agent must be set)",field:"agentId"});return r}function er(e){if(e?.sessionId?.trim())return e.sessionId;throw new utils.NameErrors.MissingFieldError({message:"memory tool: sessionId is required (ctx.sessionId must be set)",field:"sessionId"})}async function tr(e,r){let t=chunkGCVKM3RJ_cjs.j(e);if(!fs.existsSync(t)){A.debug("memory db not found, auto-initializing",{dbPath:t,workspaceDir:e});try{await chunk77ERAHDK_cjs.z("init",{workspaceDir:e,force:!1},r);}catch(o){throw new utils.NameErrors.OperationFailedError({message:`memory tool: auto-init failed (${utils.errorMeta(o).message}). Try running \`easbot memory init\` manually.`,operation:"memory-auto-init"})}}}async function rr(){if(!(chunkEKSLNNMF_cjs.a.isInitialized()&&chunkEKSLNNMF_cjs.a.capabilities().graph))try{let e=await chunkNHRRIJFK_cjs.d.getMemoryJson();chunkEKSLNNMF_cjs.a.init({models:{embedding:e?.embedding_model??void 0,graph:e?.graph_model??void 0}});}catch(e){A.warn("memory Llm init failed; KG extraction will be skipped",{error:utils.errorMeta(e)});}}var L=plugin.createTool({description:Xt(),args:Ne,isEnabled:()=>chunkNHRRIJFK_cjs.d.exists(),execute:async(e,r)=>{let t=e,o=t.operation;try{await r.ask({permission:"memory",patterns:o==="recall"?[t.query]:["*"],always:["*"],metadata:{operation:o}});let n=Zt(r),d=r.worktree||r.directory||process.cwd(),c=chunkGCVKM3RJ_cjs.j(d),m={agentId:n,isTrustedLocal:!0,remote:!1,locale:utils.Locale.resolveLocaleLang(),dbPath:c,workspaceDir:d,rootDir:d,config:chunk77ERAHDK_cjs.A({agentId:n,dbPath:c,workspaceDir:d}),signal:r.abort};switch(await rr(),await tr(d,m),o){case "recall":{let s=await chunk77ERAHDK_cjs.z("recall",{query:t.query,maxResults:t.limit,category:t.category,minImportance:t.minImportance,minScore:t.minScore,maxEdgesPerNode:t.maxEdgesPerNode,includeGraph:t.includeGraph??!1,includeShared:t.includeShared??!1,snippetMaxChars:Jt},m);return {output:await chunk4CMSRWL3_cjs.a("recall",{kind:"recall",query:t.query,agentId:m.agentId,scope:"agent_only",totalCount:s.total,truncated:s.truncated,hits:s.hits.map(i=>({fact:{id:i.memoryId,agentId:i.agentId,category:i.category,content:i.content,importance:i.importance,tags:i.tags??null,source:i.source,sessionId:i.sessionId??null,msgId:i.msgId??null,parentMsgId:i.parentMsgId??null,filePath:i.filePath??null,createdAt:i.createdAt,updatedAt:i.updatedAt??i.createdAt,truncated:i.content.length>200},score:i.score,source:"hybrid",snippet:i.snippet,nodeIds:i.nodes?.map(p=>p.id)??[],nodes:i.nodes}))},{toolName:"memory_recall"}),title:`Memory: recall (${t.query})`,metadata:{operation:"recall",enabled:!0,agentId:n,query:t.query}}}case "remember":{let s=await chunk77ERAHDK_cjs.z("remember",{content:t.content,category:t.category,importance:t.importance,tags:t.tags,sessionId:r.sessionId},m);return {output:`<memory_result>
15
+ ${await Ut(n)}`,v=await llm.Loop.run({user:{id:utils.Identifier.ascending("message"),sessionId:e.sessionId,model:o.model??{providerId:a.providerId,modelId:a.api?.id??a.id}},sessionId:e.sessionId,agent:p,system:Ue,model:a,temperature:llm.Provider.LIMITS.TEMPERATURE.SUMMARY,maxOutputTokens:Yt,messages:[{role:"user",content:[{type:"text",text:Ve}]}],tools:ze,activeTools:ve,maxSteps:jt,abort:AbortSignal.timeout(Kt)});return k.debug("memory extract finished",{sessionId:e.sessionId,outputLength:v.text.length,steps:v.steps,toolCalls:v.toolCalls.length,cost:v.cost}),v.text}async function oe(e,r,t,o,n){try{await e.updatePart({...t,messageId:r,status:n.status,time:{start:o,end:Date.now()},...n.result!==void 0?{result:n.result}:{},...n.error!==void 0?{error:n.error}:{},...n.reason!==void 0?{reason:n.reason}:{}});}catch(d){k.error("memory part status update failed",{error:utils.errorMeta(d),status:n.status});}}async function Ne(e,r){let t=e;if(!t.userMessageId)return k.debug("loop.end: no userMessageId, skip"),{modified:false,input:e};if(!await E())return k.debug("loop.end: memory not configured, skip extract"),{modified:false,input:e};let o=`${t.sessionId}:${t.userMessageId}`;if(k.debug("loop.end: memory extract started",{loopKey:o,step:t.step,result:t.result}),r.agent&&await llm.Agent.isSubagent(r.agent))return k.debug("loop.end: skip memory extract, subagent",{loopKey:o}),{modified:false,input:e};let n=r.session?.(t.sessionId);if(!n)return k.debug("loop.end: skip memory extract, session capability unavailable",{loopKey:o}),{modified:false,input:e};let d=await n.message(t.userMessageId);if(!d)return k.debug("loop.end: user message not found, skip",{loopKey:o}),{modified:false,input:e};if(d.parts.some(l=>l.type==="memory"))return k.debug("loop.end: skip memory extract, already processed"),{modified:false,input:e};let p=utils.Identifier.ascending("part"),i=Date.now(),s={id:p,type:"memory",status:"in_progress",time:{start:i}};await n.updatePart({...s,messageId:t.userMessageId});let a=await Bt(n,t.userMessageId);return a.some(l=>l.role==="assistant"&&l.content)?(Vt(t,r,n,d,a).then(l=>oe(n,t.userMessageId,s,i,{status:"completed",result:l})).catch(l=>(k.error("memory extract failed",{error:utils.errorMeta(l)}),oe(n,t.userMessageId,s,i,{status:"failed",error:utils.errorMeta(l).message}))),{modified:false,input:e}):(k.debug("loop.end: skip memory extract, no assistant text content",{loopKey:o}),await oe(n,t.userMessageId,s,i,{status:"skipped",reason:"No assistant text content"}),{modified:false,input:e})}var R=[{event:plugin.HookEvent.ContextCollect,handler:K},{event:plugin.HookEvent.SessionCompacting,handler:j},{event:plugin.HookEvent.ToolFailure,handler:q},{event:plugin.HookEvent.LoopEnd,handler:Ne}];function A(){return R.map(({event:e,handler:r})=>({event:e,hooks:[{type:"function",handler:r}]}))}async function Ae(e,r){return utils.trimKnowledgeResult(e,{...r,dataDir:r.dataDir??chunkGCVKM3RJ_cjs.h()})}var Le={listPaths:["hits","hits.*.nodes","hits.*.nodes.*.edges","nodes","edges","factIds","entities","relations"],fieldPaths:["hits.*.content","hits.*.fact.content","hits.*.snippet"]};var L=utils.Log.create({service:"memory.plugin.tool"}),ie="memory",me=["recall","remember","update","forget","extract","graph_query","status"],ar=500,$e="Access EASBot long-term memory via `operation` (recall / remember / update / forget / extract / graph_query / status).",ae=zod.z.enum(["user_preference","task_context","technical_fact","decision","relationship","reminder","error_pattern","workflow","exploration_finding","experience_summary","tool_usage","skill_creation","test","other"]),Ge=zod.z.discriminatedUnion("operation",[zod.z.object({operation:zod.z.literal("recall"),query:zod.z.string().describe("Search query text"),limit:utils.Schema.positiveInt.optional().default(10).describe("Max results (default 10)"),category:ae.optional().describe("Filter by memory category"),minImportance:utils.Schema.positiveInt.optional().refine(e=>e===void 0||e>=1&&e<=10,{message:"minImportance must be in [1, 10] (inclusive); the service uses `WHERE importance >= ?` SQL"}).describe("INCLUSIVE `>=` filter on 1-10 importance scale; e.g. `5` keeps importance 5"),minScore:zod.z.number().min(0).max(1).optional().describe("Minimum relevance score filter (default 0; range [0, 1])"),maxEdgesPerNode:utils.Schema.positiveInt.optional().default(10).refine(e=>e===void 0||e>=1&&e<=100,{message:"maxEdgesPerNode must be in [1, 100]"}).describe("Max edges per KG neighbor node returned by recall (default 10; range [1, 100])"),includeGraph:zod.z.boolean().optional().default(false).describe("Include KG neighbor subgraph (default false; pass true to get BFS neighbors alongside hits)"),includeShared:zod.z.boolean().optional().default(false).describe("Include shared KG nodes from other agents (requires trusted local; default false)")}).strict(),zod.z.object({operation:zod.z.literal("remember"),content:zod.z.string().describe("Memory content"),category:ae.describe("Memory category"),importance:utils.Schema.positiveInt.describe("Importance 1-10 (service layer enforces range)"),tags:utils.Schema.stringArray.optional().describe("Optional tags (string[])")}).strict(),zod.z.object({operation:zod.z.literal("update"),factId:zod.z.string().describe("Target fact id (must belong to ctx.agentId)"),content:zod.z.string().optional().describe("New content (triggers embedding rewrite + FTS reindex)"),category:ae.optional().describe("New category"),importance:utils.Schema.positiveInt.optional().describe("New importance 1-10"),tags:utils.Schema.stringArray.optional().describe("New tags (string[]; empty array clears tags)")}).strict().refine(e=>e.content!==void 0||e.category!==void 0||e.importance!==void 0||e.tags!==void 0,{message:"update requires at least one of: `content`, `category`, `importance`, `tags`"}),zod.z.object({operation:zod.z.literal("forget"),factId:zod.z.string().describe("Target fact id to delete (required; must belong to ctx.agentId)"),dryRun:zod.z.boolean().optional().default(false).describe("Preview without deleting (returns matched count, never deletes)"),force:zod.z.boolean().optional().default(false).describe("Skip KG reference check and delete anyway (required when fact is referenced by other facts; use after dryRun confirms the match)")}).strict(),zod.z.object({operation:zod.z.literal("extract"),lastN:utils.Schema.positiveInt.optional().default(10).describe("Recent messages (default 10)"),fromMessageId:zod.z.string().optional().describe("Process messages after this id")}).strict(),zod.z.object({operation:zod.z.literal("graph_query"),nodeId:utils.Schema.positiveInt.describe("KG node ID to start BFS from; get it from a recall hit or a prior graph_query result"),maxDepth:utils.Schema.positiveInt.optional().default(2).describe("BFS depth for neighbor expansion (default 2; service range [1, 5])"),maxNodes:utils.Schema.nonNegativeInt.optional().default(100).describe("Max nodes returned after BFS (default 100; service max 500)"),maxEdgesPerNode:utils.Schema.positiveInt.optional().default(10).refine(e=>e===void 0||e>=1&&e<=100,{message:"maxEdgesPerNode must be in [1, 100]"}).describe("Max edges per BFS neighbor node (default 10; range [1, 100])"),relation:zod.z.string().optional().describe('Edge relation filter (e.g. "uses"; single-value exact match; differs from note.graph_query relationTypes[])'),type:zod.z.string().optional().describe('Node type filter for root node (e.g. "decision"; only affects CLI query path; nodeId path bypasses)')}).strict(),zod.z.object({operation:zod.z.literal("status")}).strict()]),de=Ge;function sr(){try{let e=utils.loadTextFile("./memory.txt",chunkR32346OA_cjs.d)();return e.trim().length>0?e:$e}catch(e){return L.warn("memory tool description unavailable, using fallback",{error:utils.errorMeta(e)}),$e}}function ir(e){let r=e.protocolMetadata?.agentId?.trim()||e.agent?.trim();if(!r)throw new utils.NameErrors.MissingFieldError({message:"memory tool: agentId is required (ctx.protocolMetadata.agentId or ctx.agent must be set)",field:"agentId"});return r}function mr(e){if(e?.sessionId?.trim())return e.sessionId;throw new utils.NameErrors.MissingFieldError({message:"memory tool: sessionId is required (ctx.sessionId must be set)",field:"sessionId"})}async function dr(e,r){let t=chunkGCVKM3RJ_cjs.j(e);if(!fs.existsSync(t)){L.debug("memory db not found, auto-initializing",{dbPath:t,workspaceDir:e});try{await chunk77ERAHDK_cjs.z("init",{workspaceDir:e,force:!1},r);}catch(o){throw new utils.NameErrors.OperationFailedError({message:`memory tool: auto-init failed (${utils.errorMeta(o).message}). Try running \`easbot memory init\` manually.`,operation:"memory-auto-init"})}}}async function lr(){if(!(chunkEKSLNNMF_cjs.a.isInitialized()&&chunkEKSLNNMF_cjs.a.capabilities().graph))try{let e=await chunkNHRRIJFK_cjs.d.getMemoryJson();chunkEKSLNNMF_cjs.a.init({models:{embedding:e?.embedding_model??void 0,graph:e?.graph_model??void 0}});}catch(e){L.warn("memory Llm init failed; KG extraction will be skipped",{error:utils.errorMeta(e)});}}async function V(e,r,t){let o=`memory_${e}`,n=await Ae(r,{toolName:o,paths:Le}),d=utils.trimEdgesForLLM(n.result),p=await t(d),i=await llm.Truncate.output(p,{contentType:"output",toolName:o}),s=utils.formatKnowledgeTruncationHint(n,o);return i.truncated?{output:`${i.content}
16
+
17
+ [Full output truncated: ${i.outputPath}]`,truncated:true,outputPath:i.outputPath}:{output:s?`${i.content}
18
+
19
+ ${s}`:i.content,truncated:false}}var D=plugin.createTool({description:sr(),args:Ge,isEnabled:()=>chunkNHRRIJFK_cjs.d.exists(),execute:async(e,r)=>{let t=e,o=t.operation;try{await r.ask({permission:"memory",patterns:o==="recall"?[t.query]:["*"],always:["*"],metadata:{operation:o}});let n=ir(r),d=r.worktree||r.directory||process.cwd(),p=chunkGCVKM3RJ_cjs.j(d),i={agentId:n,isTrustedLocal:!0,remote:!1,locale:utils.Locale.resolveLocaleLang(),dbPath:p,workspaceDir:d,rootDir:d,config:chunk77ERAHDK_cjs.A({agentId:n,dbPath:p,workspaceDir:d}),signal:r.abort};switch(await lr(),await dr(d,i),o){case "recall":{let s=await chunk77ERAHDK_cjs.z("recall",{query:t.query,maxResults:t.limit,category:t.category,minImportance:t.minImportance,minScore:t.minScore,maxEdgesPerNode:t.maxEdgesPerNode,includeGraph:t.includeGraph??!1,includeShared:t.includeShared??!1,snippetMaxChars:ar},i),a={kind:"recall",query:t.query,agentId:i.agentId,scope:"agent_only",totalCount:s.total,truncated:s.truncated,hits:s.hits.map(m=>({fact:{id:m.memoryId,agentId:m.agentId,category:m.category,content:m.content,importance:m.importance,tags:m.tags??null,source:m.source,sessionId:m.sessionId??null,msgId:m.msgId??null,parentMsgId:m.parentMsgId??null,filePath:m.filePath??null,createdAt:m.createdAt,updatedAt:m.updatedAt??m.createdAt,truncated:m.content.length>200},score:m.score,source:"hybrid",snippet:m.snippet,nodeIds:m.nodes?.map($=>$.id)??[],nodes:m.nodes}))},{output:u,truncated:l,outputPath:y}=await V("recall",a,m=>chunk4CMSRWL3_cjs.a("recall",m,{toolName:"memory_recall"}));return {output:u,title:`Memory: recall (${t.query})`,metadata:{operation:"recall",enabled:!0,agentId:n,query:t.query,truncated:l,...l&&y?{outputPath:y}:{}}}}case "remember":{let s=await chunk77ERAHDK_cjs.z("remember",{content:t.content,category:t.category,importance:t.importance,tags:t.tags,sessionId:r.sessionId},i);return {output:`<memory_result>
16
20
  Memory saved.
17
21
  id: ${s.fact.id}
18
22
  category: ${s.fact.category}
19
23
  importance: ${t.importance}
20
24
  linked nodes: ${s.nodeIds?.length??0}
21
- </memory_result>`,title:"Memory saved",metadata:{operation:"remember",enabled:!0,agentId:n,memoryId:s.fact.id,category:s.fact.category,importance:t.importance}}}case "update":{let s=await chunk77ERAHDK_cjs.z("update",{factId:t.factId,content:t.content,category:t.category,importance:t.importance,tags:t.tags},m),a=s.fieldsUpdated.length>0?s.fieldsUpdated.join(", "):"(no-op)",i=s.contentChanged?" (embedding rewritten)":"";return {output:`<memory_result>
25
+ </memory_result>`,title:"Memory saved",metadata:{operation:"remember",enabled:!0,agentId:n,memoryId:s.fact.id,category:s.fact.category,importance:t.importance}}}case "update":{let s=await chunk77ERAHDK_cjs.z("update",{factId:t.factId,content:t.content,category:t.category,importance:t.importance,tags:t.tags},i),a=s.fieldsUpdated.length>0?s.fieldsUpdated.join(", "):"(no-op)",u=s.contentChanged?" (embedding rewritten)":"";return {output:`<memory_result>
22
26
  Memory updated.
23
27
  id: ${s.fact.id}
24
28
  category: ${s.fact.category}
25
29
  importance: ${s.fact.importance}
26
- fields updated: ${a}${i}
30
+ fields updated: ${a}${u}
27
31
  updated_at: ${s.fact.updatedAt}
28
- </memory_result>`,title:"Memory updated",metadata:{operation:"update",enabled:!0,agentId:n,memoryId:s.fact.id,category:s.fact.category,importance:s.fact.importance}}}case "forget":{let s=await chunk77ERAHDK_cjs.z("forget",{factId:t.factId,dryRun:t.dryRun,force:t.force},m);return {output:await chunk4CMSRWL3_cjs.a("forget",s,{toolName:"memory_forget"}),title:"Memory: forget",metadata:{operation:"forget",enabled:!0,agentId:n}}}case "extract":{let s=er(r),a=await chunk77ERAHDK_cjs.z("extract",{sessionId:s,lastN:t.lastN,fromMessageId:t.fromMessageId},m);return {output:`<memory_result>
32
+ </memory_result>`,title:"Memory updated",metadata:{operation:"update",enabled:!0,agentId:n,memoryId:s.fact.id,category:s.fact.category,importance:s.fact.importance}}}case "forget":{let s=await chunk77ERAHDK_cjs.z("forget",{factId:t.factId,dryRun:t.dryRun,force:t.force},i),{output:a,truncated:u,outputPath:l}=await V("forget",s,y=>chunk4CMSRWL3_cjs.a("forget",y,{toolName:"memory_forget"}));return {output:a,title:"Memory: forget",metadata:{operation:"forget",enabled:!0,agentId:n,truncated:u,...u&&l?{outputPath:l}:{}}}}case "extract":{let s=mr(r),a=await chunk77ERAHDK_cjs.z("extract",{sessionId:s,lastN:t.lastN,fromMessageId:t.fromMessageId},i),{output:u,truncated:l,outputPath:y}=await V("extract",a,async m=>`<memory_result>
29
33
  Extract completed.
30
34
  sessionId: ${s}
31
- extractedCount: ${a.extractedCount}
32
- factIds: ${a.factIds.length>0?a.factIds.join(", "):"(none)"}
33
- messageRange: ${a.messageRange.fromMessageId} -> ${a.messageRange.toMessageId}
34
- </memory_result>`,title:"memory: extract",metadata:{operation:"extract",enabled:!0,agentId:n,total:a.extractedCount}}}case "graph_query":{let s=await chunk77ERAHDK_cjs.z("graph_query",{nodeId:t.nodeId,maxDepth:t.maxDepth,maxNodes:t.maxNodes,maxEdgesPerNode:t.maxEdgesPerNode,...t.relation!==void 0?{relation:t.relation}:{},...t.type!==void 0?{type:t.type}:{}},m);return {output:await chunk4CMSRWL3_cjs.a("graph_query",s,{toolName:"memory_graph_query"}),title:"Memory: graph_query",metadata:{operation:"graph_query",enabled:!0,agentId:n}}}case "status":{let a=await chunk77ERAHDK_cjs.z("status",{},m);return {output:terminal.renderKnowledgeStatus({packageName:"memory",rootDir:a.workspaceDir??"",configPath:a.configPath??"",configExists:typeof a.configExists=="boolean"?a.configExists:!0,dbPath:a.dbPath,dbExists:typeof a.dbExists=="boolean"?a.dbExists:!0,dbSize:a.dbSize,indexState:a.indexState,schemaVersion:a.schemaVersion,extractionVersion:a.extractionVersion,lastSyncAt:a.lastSyncAt,vectorEnabled:a.vectorEnabled,embeddingDims:a.embeddingDims,llm:a.llm??{initialized:!1,capabilities:{}},backend:a.backend,healthy:a.healthy,recommendation:a.recommendation,dbStats:a.dbStats??a.integrityStats,extras:(()=>{let p={};if(typeof a.agentId=="string"&&(p.agent_id=a.agentId),typeof a.ftsAvailable=="boolean"&&(p.fts_available=a.ftsAvailable?"yes":"no"),a.factsByCategory&&typeof a.factsByCategory=="object")for(let[v,_]of Object.entries(a.factsByCategory))typeof _=="number"&&_>0&&(p[`facts/${v}`]=_);if(a.meta&&typeof a.meta=="object")for(let[v,_]of Object.entries(a.meta))_!==void 0&&(p[`meta/${v}`]=_);return Object.keys(p).length>0?p:void 0})()}),title:"Memory: status",metadata:{operation:"status",enabled:!0,agentId:n}}}}}catch(n){if(utils.ServiceError.isInstance(n))try{return {output:utils.ServiceErrorBus.toMarkdown(n,{tool:"memory",operation:o,resultTag:"<memory_result>",pack:"memory"}),title:`Memory: ${o} (${n.data.code})`,metadata:{operation:o,enabled:!0,businessErrorCode:n.data.code}}}catch(d){return A.error("memory tool ServiceErrorBus formatting failed",{error:utils.errorMeta(d)}),{output:`<memory_result>
35
+ extractedCount: ${m.extractedCount}
36
+ factIds: ${m.factIds.length>0?m.factIds.join(", "):"(none)"}
37
+ messageRange: ${m.messageRange.fromMessageId} -> ${m.messageRange.toMessageId}
38
+ </memory_result>`);return {output:u,title:"memory: extract",metadata:{operation:"extract",enabled:!0,agentId:n,truncated:l,...l&&y?{outputPath:y}:{},total:a.extractedCount}}}case "graph_query":{let s=await chunk77ERAHDK_cjs.z("graph_query",{nodeId:t.nodeId,maxDepth:t.maxDepth,maxNodes:t.maxNodes,maxEdgesPerNode:t.maxEdgesPerNode,...t.relation!==void 0?{relation:t.relation}:{},...t.type!==void 0?{type:t.type}:{}},i),{output:a,truncated:u,outputPath:l}=await V("graph_query",s,y=>chunk4CMSRWL3_cjs.a("graph_query",y,{toolName:"memory_graph_query"}));return {output:a,title:"Memory: graph_query",metadata:{operation:"graph_query",enabled:!0,agentId:n,truncated:u,...u&&l?{outputPath:l}:{}}}}case "status":{let a=await chunk77ERAHDK_cjs.z("status",{},i);return {output:terminal.renderKnowledgeStatus({packageName:"memory",rootDir:a.workspaceDir??"",configPath:a.configPath??"",configExists:typeof a.configExists=="boolean"?a.configExists:!0,dbPath:a.dbPath,dbExists:typeof a.dbExists=="boolean"?a.dbExists:!0,dbSize:a.dbSize,indexState:a.indexState,schemaVersion:a.schemaVersion,extractionVersion:a.extractionVersion,lastSyncAt:a.lastSyncAt,vectorEnabled:a.vectorEnabled,embeddingDims:a.embeddingDims,llm:a.llm??{initialized:!1,capabilities:{}},backend:a.backend,healthy:a.healthy,recommendation:a.recommendation,dbStats:a.dbStats??a.integrityStats,extras:(()=>{let l={};if(typeof a.agentId=="string"&&(l.agent_id=a.agentId),typeof a.ftsAvailable=="boolean"&&(l.fts_available=a.ftsAvailable?"yes":"no"),a.factsByCategory&&typeof a.factsByCategory=="object")for(let[y,m]of Object.entries(a.factsByCategory))typeof m=="number"&&m>0&&(l[`facts/${y}`]=m);if(a.meta&&typeof a.meta=="object")for(let[y,m]of Object.entries(a.meta))m!==void 0&&(l[`meta/${y}`]=m);return Object.keys(l).length>0?l:void 0})()}),title:"Memory: status",metadata:{operation:"status",enabled:!0,agentId:n}}}}}catch(n){if(utils.ServiceError.isInstance(n))try{return {output:utils.ServiceErrorBus.toMarkdown(n,{tool:"memory",operation:o,resultTag:"<memory_result>",pack:"memory"}),title:`Memory: ${o} (${n.data.code})`,metadata:{operation:o,enabled:!0,businessErrorCode:n.data.code}}}catch(d){return L.error("memory tool ServiceErrorBus formatting failed",{error:utils.errorMeta(d)}),{output:`<memory_result>
35
39
  Error: ${n.data.message}
36
- </memory_result>`,title:`Memory: ${o} (${n.data.code})`,metadata:{operation:o,enabled:true,businessErrorCode:n.data.code}}}return A.error("memory tool execution failed",{operation:o,error:utils.errorMeta(n)}),{output:`<memory_result>
40
+ </memory_result>`,title:`Memory: ${o} (${n.data.code})`,metadata:{operation:o,enabled:true,businessErrorCode:n.data.code}}}return L.error("memory tool execution failed",{operation:o,error:utils.errorMeta(n)}),{output:`<memory_result>
37
41
  Error: ${utils.errorMeta(n).message}
38
- </memory_result>`,title:`Memory: ${o} (error)`,metadata:{operation:o,enabled:true}}}}});var D=async e=>({hooks:N(),tools:{[$.name]:L}});var Ae=[plugin.HookEvent.ContextCollect,plugin.HookEvent.SessionCompacting,plugin.HookEvent.ToolFailure,plugin.HookEvent.LoopEnd];var Le={name:"memory.plugin",async init(){return {isEnabled:()=>true,handlers:w.map(({event:e,handler:r})=>({name:e,handler:r}))}}};Object.defineProperty(exports,"MemoryStdioServer",{enumerable:true,get:function(){return chunk4CMSRWL3_cjs.b}});Object.defineProperty(exports,"renderOperationMarkdown",{enumerable:true,get:function(){return chunk4CMSRWL3_cjs.a}});Object.defineProperty(exports,"COMMANDS_HELP",{enumerable:true,get:function(){return chunkBHGAFQCX_cjs.a}});Object.defineProperty(exports,"handleMemoryCli",{enumerable:true,get:function(){return chunkBHGAFQCX_cjs.d}});Object.defineProperty(exports,"renderBanner",{enumerable:true,get:function(){return chunkBHGAFQCX_cjs.b}});Object.defineProperty(exports,"renderHelp",{enumerable:true,get:function(){return chunkBHGAFQCX_cjs.c}});Object.defineProperty(exports,"ALL_OPS",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.y}});Object.defineProperty(exports,"GraphStore",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.a}});Object.defineProperty(exports,"OP_REGISTRY",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.x}});Object.defineProperty(exports,"consolidate",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.r}});Object.defineProperty(exports,"doctor",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.v}});Object.defineProperty(exports,"executeOp",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.z}});Object.defineProperty(exports,"extract",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.q}});Object.defineProperty(exports,"forget",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.p}});Object.defineProperty(exports,"graphQuery",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.t}});Object.defineProperty(exports,"init",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.w}});Object.defineProperty(exports,"recall",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.b}});Object.defineProperty(exports,"remember",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.n}});Object.defineProperty(exports,"status",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.u}});Object.defineProperty(exports,"sync",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.s}});Object.defineProperty(exports,"update",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.o}});Object.defineProperty(exports,"LATEST_SCHEMA_VERSION",{enumerable:true,get:function(){return chunkIP7VEKQY_cjs.a}});Object.defineProperty(exports,"MIGRATIONS",{enumerable:true,get:function(){return chunkIP7VEKQY_cjs.b}});Object.defineProperty(exports,"MemoryDatabaseManager",{enumerable:true,get:function(){return chunkIP7VEKQY_cjs.e}});Object.defineProperty(exports,"readCurrentSchemaVersion",{enumerable:true,get:function(){return chunkIP7VEKQY_cjs.d}});Object.defineProperty(exports,"runMigrations",{enumerable:true,get:function(){return chunkIP7VEKQY_cjs.c}});Object.defineProperty(exports,"Llm",{enumerable:true,get:function(){return chunkEKSLNNMF_cjs.a}});Object.defineProperty(exports,"DEFAULT_MEMORY_JSON",{enumerable:true,get:function(){return chunkNHRRIJFK_cjs.b}});Object.defineProperty(exports,"MEMORY_JSON_REL_PATH",{enumerable:true,get:function(){return chunkNHRRIJFK_cjs.c}});Object.defineProperty(exports,"MemoryCache",{enumerable:true,get:function(){return chunkNHRRIJFK_cjs.d}});Object.defineProperty(exports,"MemoryJsonSchema",{enumerable:true,get:function(){return chunkNHRRIJFK_cjs.a}});Object.defineProperty(exports,"getGlobal",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.c}});Object.defineProperty(exports,"getHomeDir",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.g}});Object.defineProperty(exports,"getInstance",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.f}});Object.defineProperty(exports,"getMemoryDbPath",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.j}});Object.defineProperty(exports,"getMemoryDir",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.i}});Object.defineProperty(exports,"getXdgData",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.h}});Object.defineProperty(exports,"resetGlobalAdapter",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.b}});Object.defineProperty(exports,"resetInstanceAdapter",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.e}});Object.defineProperty(exports,"setGlobalAdapter",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.a}});Object.defineProperty(exports,"setInstanceAdapter",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.d}});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=nr;exports.MEMORY_HOOK_BINDINGS=w;exports.MEMORY_HOOK_EVENTS=Ae;exports.MEMORY_PLUGIN_ID=Q;exports.MEMORY_PLUGIN_MANIFEST=$;exports.MEMORY_PLUGIN_VERSION=J;exports.MEMORY_TOOL_ARGS=ae;exports.MEMORY_TOOL_ID=oe;exports.MEMORY_TOOL_OPS=ne;exports.MemoryPlugin=D;exports.MemoryPluginEntry=D;exports.MemoryPluginHook=Le;exports.MemoryTool=L;exports.addWord=gr;exports.closeTokenizer=yr;exports.createMemoryHookMatchers=N;exports.initTokenizer=ur;exports.isInitialized=fr;exports.loadCustomDict=ft;exports.toFtsTokens=Mr;exports.toFtsTokensForSearch=xr;exports.tokenize=yt;exports.tokenizeForSearch=Mt;
42
+ </memory_result>`,title:`Memory: ${o} (error)`,metadata:{operation:o,enabled:true}}}}});var F=async e=>({hooks:A(),tools:{[Y.name]:D}});var Ye=[plugin.HookEvent.ContextCollect,plugin.HookEvent.SessionCompacting,plugin.HookEvent.ToolFailure,plugin.HookEvent.LoopEnd];var Ke={name:"memory.plugin",async init(){return {isEnabled:()=>true,handlers:R.map(({event:e,handler:r})=>({name:e,handler:r}))}}};Object.defineProperty(exports,"MemoryStdioServer",{enumerable:true,get:function(){return chunk4CMSRWL3_cjs.b}});Object.defineProperty(exports,"renderOperationMarkdown",{enumerable:true,get:function(){return chunk4CMSRWL3_cjs.a}});Object.defineProperty(exports,"COMMANDS_HELP",{enumerable:true,get:function(){return chunkBHGAFQCX_cjs.a}});Object.defineProperty(exports,"handleMemoryCli",{enumerable:true,get:function(){return chunkBHGAFQCX_cjs.d}});Object.defineProperty(exports,"renderBanner",{enumerable:true,get:function(){return chunkBHGAFQCX_cjs.b}});Object.defineProperty(exports,"renderHelp",{enumerable:true,get:function(){return chunkBHGAFQCX_cjs.c}});Object.defineProperty(exports,"ALL_OPS",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.y}});Object.defineProperty(exports,"GraphStore",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.a}});Object.defineProperty(exports,"OP_REGISTRY",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.x}});Object.defineProperty(exports,"consolidate",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.r}});Object.defineProperty(exports,"doctor",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.v}});Object.defineProperty(exports,"executeOp",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.z}});Object.defineProperty(exports,"extract",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.q}});Object.defineProperty(exports,"forget",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.p}});Object.defineProperty(exports,"graphQuery",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.t}});Object.defineProperty(exports,"init",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.w}});Object.defineProperty(exports,"recall",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.b}});Object.defineProperty(exports,"remember",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.n}});Object.defineProperty(exports,"status",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.u}});Object.defineProperty(exports,"sync",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.s}});Object.defineProperty(exports,"update",{enumerable:true,get:function(){return chunk77ERAHDK_cjs.o}});Object.defineProperty(exports,"LATEST_SCHEMA_VERSION",{enumerable:true,get:function(){return chunkIP7VEKQY_cjs.a}});Object.defineProperty(exports,"MIGRATIONS",{enumerable:true,get:function(){return chunkIP7VEKQY_cjs.b}});Object.defineProperty(exports,"MemoryDatabaseManager",{enumerable:true,get:function(){return chunkIP7VEKQY_cjs.e}});Object.defineProperty(exports,"readCurrentSchemaVersion",{enumerable:true,get:function(){return chunkIP7VEKQY_cjs.d}});Object.defineProperty(exports,"runMigrations",{enumerable:true,get:function(){return chunkIP7VEKQY_cjs.c}});Object.defineProperty(exports,"Llm",{enumerable:true,get:function(){return chunkEKSLNNMF_cjs.a}});Object.defineProperty(exports,"DEFAULT_MEMORY_JSON",{enumerable:true,get:function(){return chunkNHRRIJFK_cjs.b}});Object.defineProperty(exports,"MEMORY_JSON_REL_PATH",{enumerable:true,get:function(){return chunkNHRRIJFK_cjs.c}});Object.defineProperty(exports,"MemoryCache",{enumerable:true,get:function(){return chunkNHRRIJFK_cjs.d}});Object.defineProperty(exports,"MemoryJsonSchema",{enumerable:true,get:function(){return chunkNHRRIJFK_cjs.a}});Object.defineProperty(exports,"getGlobal",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.c}});Object.defineProperty(exports,"getHomeDir",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.g}});Object.defineProperty(exports,"getInstance",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.f}});Object.defineProperty(exports,"getMemoryDbPath",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.j}});Object.defineProperty(exports,"getMemoryDir",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.i}});Object.defineProperty(exports,"getXdgData",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.h}});Object.defineProperty(exports,"resetGlobalAdapter",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.b}});Object.defineProperty(exports,"resetInstanceAdapter",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.e}});Object.defineProperty(exports,"setGlobalAdapter",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.a}});Object.defineProperty(exports,"setInstanceAdapter",{enumerable:true,get:function(){return chunkGCVKM3RJ_cjs.d}});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=pr;exports.MEMORY_HOOK_BINDINGS=R;exports.MEMORY_HOOK_EVENTS=Ye;exports.MEMORY_PLUGIN_ID=ee;exports.MEMORY_PLUGIN_MANIFEST=Y;exports.MEMORY_PLUGIN_VERSION=te;exports.MEMORY_TOOL_ARGS=de;exports.MEMORY_TOOL_ID=ie;exports.MEMORY_TOOL_OPS=me;exports.MemoryPlugin=F;exports.MemoryPluginEntry=F;exports.MemoryPluginHook=Ke;exports.MemoryTool=D;exports.addWord=hr;exports.closeTokenizer=Er;exports.createMemoryHookMatchers=A;exports.initTokenizer=kr;exports.isInitialized=_r;exports.loadCustomDict=It;exports.toFtsTokens=wr;exports.toFtsTokensForSearch=Rr;exports.tokenize=kt;exports.tokenizeForSearch=ht;
package/dist/index.d.cts CHANGED
@@ -638,7 +638,7 @@ declare namespace MemoryCache {
638
638
  declare const MemoryPlugin: Plugin;
639
639
 
640
640
  declare const MEMORY_PLUGIN_ID = "memory";
641
- declare const MEMORY_PLUGIN_VERSION = "0.3.39";
641
+ declare const MEMORY_PLUGIN_VERSION = "0.3.40";
642
642
  declare const MEMORY_PLUGIN_MANIFEST: PluginManifest;
643
643
 
644
644
  declare function createMemoryHookMatchers(): HookMatcher[];
package/dist/index.d.ts CHANGED
@@ -638,7 +638,7 @@ declare namespace MemoryCache {
638
638
  declare const MemoryPlugin: Plugin;
639
639
 
640
640
  declare const MEMORY_PLUGIN_ID = "memory";
641
- declare const MEMORY_PLUGIN_VERSION = "0.3.39";
641
+ declare const MEMORY_PLUGIN_VERSION = "0.3.40";
642
642
  declare const MEMORY_PLUGIN_MANIFEST: PluginManifest;
643
643
 
644
644
  declare function createMemoryHookMatchers(): HookMatcher[];
package/dist/index.mjs CHANGED
@@ -1,38 +1,42 @@
1
- import {a}from'./chunks/chunk-LM6WT4CO.mjs';export{b as MemoryStdioServer,a as renderOperationMarkdown}from'./chunks/chunk-LM6WT4CO.mjs';import'./chunks/chunk-QF5S5MG7.mjs';export{a as COMMANDS_HELP,d as handleMemoryCli,b as renderBanner,c as renderHelp}from'./chunks/chunk-NBPDJQIR.mjs';import {A as A$1,z as z$1}from'./chunks/chunk-LQ4OZPZI.mjs';export{y as ALL_OPS,a as GraphStore,x as OP_REGISTRY,r as consolidate,v as doctor,z as executeOp,q as extract,p as forget,t as graphQuery,w as init,b as recall,n as remember,u as status,s as sync,o as update}from'./chunks/chunk-LQ4OZPZI.mjs';export{a as LATEST_SCHEMA_VERSION,b as MIGRATIONS,e as MemoryDatabaseManager,d as readCurrentSchemaVersion,c as runMigrations}from'./chunks/chunk-YJLHS7JB.mjs';import {a as a$1}from'./chunks/chunk-HH7EA2UE.mjs';export{a as Llm}from'./chunks/chunk-HH7EA2UE.mjs';import {a as a$2}from'./chunks/chunk-AJDMZTCQ.mjs';import {d}from'./chunks/chunk-SE3F5YQE.mjs';export{b as DEFAULT_MEMORY_JSON,c as MEMORY_JSON_REL_PATH,d as MemoryCache,a as MemoryJsonSchema}from'./chunks/chunk-SE3F5YQE.mjs';import {j as j$1,f}from'./chunks/chunk-HX3TV7FD.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-HX3TV7FD.mjs';import'./chunks/chunk-S4DPVKMV.mjs';import {DefaultContextMode}from'@easbot/types';export{GRAPH_ENTITY_TYPE_DEFINITIONS,GRAPH_RELATION_TYPE_DEFINITIONS}from'@easbot/types';import*as h from'jieba-wasm';import {Log,loadTextFile,Schema,Locale,ServiceError,ServiceErrorBus,errorMeta,TruncateContent,Identifier,NameErrors,Markdown,Token,Filesystem}from'@easbot/utils';import {HookEvent,createTool}from'@easbot/plugin';import {createHash}from'crypto';import {Agent,Provider,LanguageProvider}from'@easbot/llm';import {stepCountIs}from'ai';import {existsSync}from'fs';import {renderKnowledgeStatus}from'@easbot/terminal';import {z}from'zod';var ar=["user_preference","task_context","technical_fact","decision","relationship","reminder","error_pattern","workflow","exploration_finding","experience_summary","tool_usage","skill_creation","test","other"];var y=Log.create({service:"memory.tokenizer"}),k=false,ft=loadTextFile("./assets/jieba_dict.txt",import.meta.url);async function gr(e){if(!k)try{y.debug("Initializing jieba tokenizer");let r=ft();if(h.with_dict(r),y.debug("Built-in dictionary loaded"),e?.dictPath&&e.dictPath.length>0)for(let t of e.dictPath)await yt(t);k=!0,y.debug("Jieba tokenizer initialized successfully");}catch(r){y.error("Failed to initialize jieba tokenizer",{error:errorMeta(r)}),y.warn("Using fallback tokenization (space-based)");}}async function yt(e){if(!k)throw new a$2.TokenizerNotInitializedError({message:"Tokenizer not initialized"});try{let r=await Filesystem.readText(e);y.debug("Loading custom dictionary",{dictPath:e}),h.with_dict(r),y.debug("Custom dictionary loaded successfully",{dictPath:e});}catch(r){y.warn("Failed to load custom dictionary",{dictPath:e,error:errorMeta(r)});}}function Mt(e){if(!k)return e.split(/\s+/).filter(Boolean);try{return h.cut(e)}catch(r){return y.warn("Tokenization failed, using fallback",{error:errorMeta(r)}),e.split(/\s+/).filter(Boolean)}}function xt(e){if(!k)return e.split(/\s+/).filter(Boolean);try{return h.cut_for_search(e)}catch(r){return y.warn("Tokenization for search failed, using fallback",{error:errorMeta(r)}),e.split(/\s+/).filter(Boolean)}}function fr(e,r,t){if(k)try{h.add_word(e,r,t),y.debug("Word added to dictionary",{word:e,freq:r,tag:t});}catch(o){y.warn("Failed to add word",{word:e,error:errorMeta(o)});}}function yr(){return k}async function Mr(){k=false,y.debug("Tokenizer closed");}function xr(e){if(!k)return e.split(/\s+/).filter(Boolean).join(" ");try{return Mt(e).join(" ")}catch(r){return y.warn("Tokenization failed, using fallback",{error:errorMeta(r)}),e.split(/\s+/).filter(Boolean).join(" ")}}function br(e){if(!k)return e.split(/\s+/).filter(Boolean).join(" ");try{return xt(e).join(" ")}catch(r){return y.warn("Tokenization for search failed, using fallback",{error:errorMeta(r)}),e.split(/\s+/).filter(Boolean).join(" ")}}var J="memory",X="0.3.39",G={name:J,version:X,description:"EASBot memory plugin: lifecycle hooks and memory tool",entry:"./index.mjs",capabilities:["hooks","tools"]};async function _(){return d.exists()}function M(e,r){if(typeof e!="object"||e===null)return;let t=e;for(let o of r){let n=t[o];if(typeof n=="string"&&n.length>0)return n}}function he(e){if(typeof e!="object"||e===null)return {};let r=e.extras;return typeof r=="object"&&r!==null&&!Array.isArray(r)?r:{}}function _e(e){if(typeof e!="object"||e===null)return;let r=e.protocolMetadata;if(typeof r!="object"||r===null)return;let t=r.agentId;return typeof t=="string"&&t.length>0?t:void 0}function H(e,r){let t={...he(e),...he(r)};return {agentId:M(r,["agentId"])??_e(e)??_e(r)??M(e,["agentId"])??M(r,["agent"])??M(e,["agent"])??"",sessionId:M(r,["sessionId"])??M(e,["sessionId"]),toolName:M(e,["toolName","tool","name"])??M(r,["toolName"]),error:M(e,["error","message"])??M(r,["error"]),messagePreview:M(e,["messagePreview"])??M(r,["messagePreview"]),contextPreview:M(e,["contextPreview","text","prompt"])??M(r,["contextPreview"]),extras:t}}function P(e){let r=f().worktree,t=j$1(r),o=e.trim()||"memory-plugin";return {agentId:o,isTrustedLocal:true,remote:false,locale:"en-US",dbPath:t,workspaceDir:r,rootDir:r,config:A$1({agentId:o,dbPath:t,workspaceDir:r})}}function x(e,r){return {modified:false,input:e,output:{...r}}}function Ee(e,r){return M(e,[r])}var Z=Log.create({service:"memory.plugin.hook"}),Re=1200;function ht(e,r){let t=e;for(let n of [t?.query,r.query])if(typeof n=="string"&&n.trim().length>0)return n;return Ee(e,"userMessage")??""}var Y=async(e,r)=>{let t=HookEvent.ContextCollect,o=H(e,r);if(!o.agentId.trim())return {modified:false,input:e,output:{hook:t,ok:false,error:"context collect: agentId is required",fragments:[]}};if(!await _())return Z.debug("context.collect: memory not configured, skip recall"),{modified:false,input:e,output:{hook:t,ok:true,fragments:[],logLine:"memory not configured"}};let n=typeof o.extras.topK=="number"?o.extras.topK:5,d=ht(e,o.extras);if(d.trim().length===0)return Z.debug("context.collect: empty query, skip recall"),{modified:false,input:e,output:{hook:t,ok:true,fragments:[],logLine:"context collect: empty query"}};try{let c=await z$1("recall",{query:d,maxResults:n},P(o.agentId));if(c.hits.length===0)return {modified:!1,input:e,output:{hook:t,ok:!0,fragments:[],logLine:"context collect: no facts found"}};let m=c.hits.map(i=>`- [${i.category}/imp=${i.importance}] ${i.snippet}`).join(`
2
- `),s=await TruncateContent.truncate(m,{maxChars:Math.min(Re*4,TruncateContent.DEFAULT_MAX_CHARS),label:"memory recall fragments"}),a={id:"memory:recall",title:"Relevant Memory",content:s.content,source:"memory",order:10,markers:["<memory-recall>","</memory-recall>"]};return {modified:!1,input:e,output:{hook:t,ok:!0,fragments:[a],logLine:`context collect: contributed ${c.hits.length} facts${s.truncated?" (truncated; full content saved for agent read-back)":""}`}}}catch(c){let m=errorMeta(c);return Z.warn("memory context collect hook failed",{error:m}),{modified:false,input:e,output:{hook:t,ok:false,error:m.message,fragments:[]}}}};var Oe=Log.create({service:"memory.plugin.hook"}),Rt=200,j=async(e,r)=>{let t=HookEvent.SessionCompacting,o=H(e,r);if(!o.agentId.trim())return x(e,{hook:t,ok:false,error:"pre compact: agentId is required"});if(!await _())return Oe.debug("pre-compact: memory not configured, skip recall"),x(e,{hook:t,ok:true,context:[],logLine:"memory not configured"});let d=(o.contextPreview??o.messagePreview??"").slice(0,Rt).replace(/\s+/g," ").trim(),c=typeof o.extras.topK=="number"?o.extras.topK:3;if(!d)return x(e,{hook:t,ok:true,context:[],logLine:"pre compact: empty context preview; skipping recall injection"});try{let m=await z$1("recall",{query:d,maxResults:c,minImportance:5},P(o.agentId));if(m.hits.length===0)return x(e,{hook:t,ok:!0,context:[],logLine:"pre compact: no facts matched query"});let s=m.hits.map(i=>`- [${i.category}/imp=${i.importance}] ${i.snippet.slice(0,150)}`),a=`[memory:pre-compact recall top-${m.hits.length} (imp>=5)]
1
+ import {a}from'./chunks/chunk-LM6WT4CO.mjs';export{b as MemoryStdioServer,a as renderOperationMarkdown}from'./chunks/chunk-LM6WT4CO.mjs';import'./chunks/chunk-QF5S5MG7.mjs';export{a as COMMANDS_HELP,d as handleMemoryCli,b as renderBanner,c as renderHelp}from'./chunks/chunk-NBPDJQIR.mjs';import {A,z as z$1}from'./chunks/chunk-LQ4OZPZI.mjs';export{y as ALL_OPS,a as GraphStore,x as OP_REGISTRY,r as consolidate,v as doctor,z as executeOp,q as extract,p as forget,t as graphQuery,w as init,b as recall,n as remember,u as status,s as sync,o as update}from'./chunks/chunk-LQ4OZPZI.mjs';export{a as LATEST_SCHEMA_VERSION,b as MIGRATIONS,e as MemoryDatabaseManager,d as readCurrentSchemaVersion,c as runMigrations}from'./chunks/chunk-YJLHS7JB.mjs';import {a as a$1}from'./chunks/chunk-HH7EA2UE.mjs';export{a as Llm}from'./chunks/chunk-HH7EA2UE.mjs';import {a as a$2}from'./chunks/chunk-AJDMZTCQ.mjs';import {d}from'./chunks/chunk-SE3F5YQE.mjs';export{b as DEFAULT_MEMORY_JSON,c as MEMORY_JSON_REL_PATH,d as MemoryCache,a as MemoryJsonSchema}from'./chunks/chunk-SE3F5YQE.mjs';import {j as j$1,f,h as h$1}from'./chunks/chunk-HX3TV7FD.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-HX3TV7FD.mjs';import'./chunks/chunk-S4DPVKMV.mjs';import {DefaultContextMode}from'@easbot/types';export{GRAPH_ENTITY_TYPE_DEFINITIONS,GRAPH_RELATION_TYPE_DEFINITIONS}from'@easbot/types';import*as E from'jieba-wasm';import {Log,loadTextFile,Schema,Locale,ServiceError,ServiceErrorBus,errorMeta,TruncateContent,Identifier,NameErrors,trimEdgesForLLM,formatKnowledgeTruncationHint,Markdown,trimKnowledgeResult,Token,Filesystem}from'@easbot/utils';import {HookEvent,createTool}from'@easbot/plugin';import {createHash}from'crypto';import {Agent,Truncate,Provider,Loop}from'@easbot/llm';import {existsSync}from'fs';import {renderKnowledgeStatus}from'@easbot/terminal';import {z}from'zod';var ur=["user_preference","task_context","technical_fact","decision","relationship","reminder","error_pattern","workflow","exploration_finding","experience_summary","tool_usage","skill_creation","test","other"];var x=Log.create({service:"memory.tokenizer"}),_=false,It=loadTextFile("./assets/jieba_dict.txt",import.meta.url);async function hr(e){if(!_)try{x.debug("Initializing jieba tokenizer");let r=It();if(E.with_dict(r),x.debug("Built-in dictionary loaded"),e?.dictPath&&e.dictPath.length>0)for(let t of e.dictPath)await kt(t);_=!0,x.debug("Jieba tokenizer initialized successfully");}catch(r){x.error("Failed to initialize jieba tokenizer",{error:errorMeta(r)}),x.warn("Using fallback tokenization (space-based)");}}async function kt(e){if(!_)throw new a$2.TokenizerNotInitializedError({message:"Tokenizer not initialized"});try{let r=await Filesystem.readText(e);x.debug("Loading custom dictionary",{dictPath:e}),E.with_dict(r),x.debug("Custom dictionary loaded successfully",{dictPath:e});}catch(r){x.warn("Failed to load custom dictionary",{dictPath:e,error:errorMeta(r)});}}function ht(e){if(!_)return e.split(/\s+/).filter(Boolean);try{return E.cut(e)}catch(r){return x.warn("Tokenization failed, using fallback",{error:errorMeta(r)}),e.split(/\s+/).filter(Boolean)}}function _t(e){if(!_)return e.split(/\s+/).filter(Boolean);try{return E.cut_for_search(e)}catch(r){return x.warn("Tokenization for search failed, using fallback",{error:errorMeta(r)}),e.split(/\s+/).filter(Boolean)}}function _r(e,r,t){if(_)try{E.add_word(e,r,t),x.debug("Word added to dictionary",{word:e,freq:r,tag:t});}catch(o){x.warn("Failed to add word",{word:e,error:errorMeta(o)});}}function Er(){return _}async function wr(){_=false,x.debug("Tokenizer closed");}function Rr(e){if(!_)return e.split(/\s+/).filter(Boolean).join(" ");try{return ht(e).join(" ")}catch(r){return x.warn("Tokenization failed, using fallback",{error:errorMeta(r)}),e.split(/\s+/).filter(Boolean).join(" ")}}function Or(e){if(!_)return e.split(/\s+/).filter(Boolean).join(" ");try{return _t(e).join(" ")}catch(r){return x.warn("Tokenization for search failed, using fallback",{error:errorMeta(r)}),e.split(/\s+/).filter(Boolean).join(" ")}}var te="memory",re="0.3.40",K={name:te,version:re,description:"EASBot memory plugin: lifecycle hooks and memory tool",entry:"./index.mjs",capabilities:["hooks","tools"]};async function w(){return d.exists()}function b(e,r){if(typeof e!="object"||e===null)return;let t=e;for(let o of r){let n=t[o];if(typeof n=="string"&&n.length>0)return n}}function Ee(e){if(typeof e!="object"||e===null)return {};let r=e.extras;return typeof r=="object"&&r!==null&&!Array.isArray(r)?r:{}}function we(e){if(typeof e!="object"||e===null)return;let r=e.protocolMetadata;if(typeof r!="object"||r===null)return;let t=r.agentId;return typeof t=="string"&&t.length>0?t:void 0}function H(e,r){let t={...Ee(e),...Ee(r)};return {agentId:b(r,["agentId"])??we(e)??we(r)??b(e,["agentId"])??b(r,["agent"])??b(e,["agent"])??"",sessionId:b(r,["sessionId"])??b(e,["sessionId"]),toolName:b(e,["toolName","tool","name"])??b(r,["toolName"]),error:b(e,["error","message"])??b(r,["error"]),messagePreview:b(e,["messagePreview"])??b(r,["messagePreview"]),contextPreview:b(e,["contextPreview","text","prompt"])??b(r,["contextPreview"]),extras:t}}function T(e){let r=f().worktree,t=j$1(r),o=e.trim()||"memory-plugin";return {agentId:o,isTrustedLocal:true,remote:false,locale:"en-US",dbPath:t,workspaceDir:r,rootDir:r,config:A({agentId:o,dbPath:t,workspaceDir:r})}}function I(e,r){return {modified:false,input:e,output:{...r}}}function Re(e,r){return b(e,[r])}var oe=Log.create({service:"memory.plugin.hook"}),Pe=1200;function Ot(e,r){let t=e;for(let n of [t?.query,r.query])if(typeof n=="string"&&n.trim().length>0)return n;return Re(e,"userMessage")??""}var j=async(e,r)=>{let t=HookEvent.ContextCollect,o=H(e,r);if(!o.agentId.trim())return {modified:false,input:e,output:{hook:t,ok:false,error:"context collect: agentId is required",fragments:[]}};if(!await w())return oe.debug("context.collect: memory not configured, skip recall"),{modified:false,input:e,output:{hook:t,ok:true,fragments:[],logLine:"memory not configured"}};let n=typeof o.extras.topK=="number"?o.extras.topK:5,l=Ot(e,o.extras);if(l.trim().length===0)return oe.debug("context.collect: empty query, skip recall"),{modified:false,input:e,output:{hook:t,ok:true,fragments:[],logLine:"context collect: empty query"}};try{let p=await z$1("recall",{query:l,maxResults:n},T(o.agentId));if(p.hits.length===0)return {modified:!1,input:e,output:{hook:t,ok:!0,fragments:[],logLine:"context collect: no facts found"}};let i=p.hits.map(u=>`- [${u.category}/imp=${u.importance}] ${u.snippet}`).join(`
2
+ `),s=await TruncateContent.truncate(i,{maxChars:Math.min(Pe*4,TruncateContent.DEFAULT_MAX_CHARS),label:"memory recall fragments"}),a={id:"memory:recall",title:"Relevant Memory",content:s.content,source:"memory",order:10,markers:["<memory-recall>","</memory-recall>"]};return {modified:!1,input:e,output:{hook:t,ok:!0,fragments:[a],logLine:`context collect: contributed ${p.hits.length} facts${s.truncated?" (truncated; full content saved for agent read-back)":""}`}}}catch(p){let i=errorMeta(p);return oe.warn("memory context collect hook failed",{error:i}),{modified:false,input:e,output:{hook:t,ok:false,error:i.message,fragments:[]}}}};var Se=Log.create({service:"memory.plugin.hook"}),Tt=200,q=async(e,r)=>{let t=HookEvent.SessionCompacting,o=H(e,r);if(!o.agentId.trim())return I(e,{hook:t,ok:false,error:"pre compact: agentId is required"});if(!await w())return Se.debug("pre-compact: memory not configured, skip recall"),I(e,{hook:t,ok:true,context:[],logLine:"memory not configured"});let l=(o.contextPreview??o.messagePreview??"").slice(0,Tt).replace(/\s+/g," ").trim(),p=typeof o.extras.topK=="number"?o.extras.topK:3;if(!l)return I(e,{hook:t,ok:true,context:[],logLine:"pre compact: empty context preview; skipping recall injection"});try{let i=await z$1("recall",{query:l,maxResults:p,minImportance:5},T(o.agentId));if(i.hits.length===0)return I(e,{hook:t,ok:!0,context:[],logLine:"pre compact: no facts matched query"});let s=i.hits.map(u=>`- [${u.category}/imp=${u.importance}] ${u.snippet.slice(0,150)}`),a=`[memory:pre-compact recall top-${i.hits.length} (imp>=5)]
3
3
  ${s.join(`
4
- `)}`;return x(e,{hook:t,ok:!0,context:[a],logLine:`pre compact: injected ${m.hits.length} facts before compaction`})}catch(m){let s=errorMeta(m);return Oe.warn("memory pre compact hook failed",{error:s}),x(e,{hook:t,ok:false,error:s.message})}};var Se=Log.create({service:"memory.plugin.hook"}),vt=8,q=async(e,r)=>{let t=HookEvent.ToolFailure,o=H(e,r);if(!o.agentId.trim())return x(e,{hook:t,ok:false,error:"tool failure: agentId is required"});if(!o.toolName?.trim()||!o.error?.trim())return x(e,{hook:t,ok:false,error:"tool failure: toolName and error are required"});if(!await _())return Se.debug("tool.failure: memory not configured, skip remember"),x(e,{hook:t,ok:true,logLine:"memory not configured"});let n=createHash("sha256").update(`${o.toolName}:${o.error}`).digest("hex").slice(0,vt),d=o.messagePreview?o.messagePreview.slice(0,200).replace(/\s+/g," ").trim():"",c=[`[error_pattern] tool=${o.toolName}`,`[error] ${o.error}`,d?`[preview] ${d}`:"",`[errHash] ${n}`].filter(Boolean).join(`
5
- `);try{let m=await z$1("remember",{content:c,category:"error_pattern",importance:6,tags:["post-tool-failure",`tool:${o.toolName}`,`err:${n}`],sessionId:o.sessionId,msgId:typeof o.extras.msgId=="string"?o.extras.msgId:void 0},P(o.agentId));return x(e,{hook:t,ok:!0,logLine:`tool failure: wrote error_pattern fact ${m.fact.id} (tool=${o.toolName}, errHash=${n})`})}catch(m){let s=errorMeta(m);return Se.warn("memory tool failure hook failed",{error:s}),x(e,{hook:t,ok:false,error:s.message})}};var I=Log.create({service:"memory.plugin.extract"}),He=2e3,Ft=4096,Pe="memory",ve=["memory","read","glob","grep"];function $t(e){return (e??[]).filter(r=>r.type==="text"&&!r.synthetic&&!r.ignored).map(r=>r.text??"").join("")}async function Gt(e,r){let t=[];for(let n of await e.messagesByParent(r)){if(n.role!=="assistant")continue;let d=n.parts.filter(c=>c.type==="text").map(c=>c.text??"").join("");d&&t.push({role:"assistant",content:d});}let o=await e.message(r);if(o&&o.role==="user"){let n=$t(o.parts);n&&t.push({role:"user",content:n});}return t}async function Yt(e){if(e.length===0)return "";let r=`### Our Conversation
4
+ `)}`;return I(e,{hook:t,ok:!0,context:[a],logLine:`pre compact: injected ${i.hits.length} facts before compaction`})}catch(i){let s=errorMeta(i);return Se.warn("memory pre compact hook failed",{error:s}),I(e,{hook:t,ok:false,error:s.message})}};var He=Log.create({service:"memory.plugin.hook"}),Lt=8,B=async(e,r)=>{let t=HookEvent.ToolFailure,o=H(e,r);if(!o.agentId.trim())return I(e,{hook:t,ok:false,error:"tool failure: agentId is required"});if(!o.toolName?.trim()||!o.error?.trim())return I(e,{hook:t,ok:false,error:"tool failure: toolName and error are required"});if(!await w())return He.debug("tool.failure: memory not configured, skip remember"),I(e,{hook:t,ok:true,logLine:"memory not configured"});let n=createHash("sha256").update(`${o.toolName}:${o.error}`).digest("hex").slice(0,Lt),l=o.messagePreview?o.messagePreview.slice(0,200).replace(/\s+/g," ").trim():"",p=[`[error_pattern] tool=${o.toolName}`,`[error] ${o.error}`,l?`[preview] ${l}`:"",`[errHash] ${n}`].filter(Boolean).join(`
5
+ `);try{let i=await z$1("remember",{content:p,category:"error_pattern",importance:6,tags:["post-tool-failure",`tool:${o.toolName}`,`err:${n}`],sessionId:o.sessionId,msgId:typeof o.extras.msgId=="string"?o.extras.msgId:void 0},T(o.agentId));return I(e,{hook:t,ok:!0,logLine:`tool failure: wrote error_pattern fact ${i.fact.id} (tool=${o.toolName}, errHash=${n})`})}catch(i){let s=errorMeta(i);return He.warn("memory tool failure hook failed",{error:s}),I(e,{hook:t,ok:false,error:s.message})}};var h=Log.create({service:"memory.plugin.extract"}),Te=2e3,Kt=4096,jt=6e4,qt=5,ve="memory",Ce=["memory","read","glob","grep"];function Bt(e){return (e??[]).filter(r=>r.type==="text"&&!r.synthetic&&!r.ignored).map(r=>r.text??"").join("")}async function Ut(e,r){let t=[];for(let n of await e.messagesByParent(r)){if(n.role!=="assistant")continue;let l=n.parts.filter(p=>p.type==="text").map(p=>p.text??"").join("");l&&t.push({role:"assistant",content:l});}let o=await e.message(r);if(o&&o.role==="user"){let n=Bt(o.parts);n&&t.push({role:"user",content:n});}return t}async function zt(e){if(e.length===0)return "";let r=`### Our Conversation
6
6
 
7
- `;for(let t of e){let o=Token.estimate(t.content),n=t.content,d=false;if(o>He){n=t.content.slice(-8e3),d=true;}d?r+=`**${t.role==="user"?"User":"Me"}**: ${n}
7
+ `;for(let t of e){let o=Token.estimate(t.content),n=t.content,l=false;if(o>Te){n=t.content.slice(-8e3),l=true;}l?r+=`**${t.role==="user"?"User":"Me"}**: ${n}
8
8
 
9
9
  [Content truncated from ${o} tokens]
10
10
 
11
11
  `:r+=`**${t.role==="user"?"User":"Me"}**: ${n||"(empty)"}
12
12
 
13
- `;}return r}async function jt(){let r=(await Agent.get(Pe))?.prompt?.trim();if(!r)throw new Error(`memory extract: agent "${Pe}" has no prompt (\u8BB0\u5FC6\u89C4\u8303\u7F3A\u5931)`);return r}async function qt(e,r,t,o,n){let d=o.agent||await Agent.defaultAgent(),c=d?await Agent.get(d):void 0;if(!c)throw new Error(`memory extract: agent not found (${d})`);let m=o.model??await Provider.defaultModel(),s=typeof m=="string"?Provider.parseModel(m):m,a=await Provider.getModel(s.providerId,s.modelId),i=await t.get();if(!i)throw new Error(`memory extract: session not found (${e.sessionId})`);let p=r.identity?.();if(!p)throw new Error("memory extract: identity capability unavailable");let{metadata:T,initialized:E}=await p.protocol(),ie=i.contextMode??DefaultContextMode,Fe=await jt(),$e=await p.staticPrompt({agent:c,model:{providerId:a.providerId,modelId:a.api?.id??a.id},workspaceDir:i.directory,mode:ie}),Ge=await p.environment({agent:c,model:{providerId:a.providerId,modelId:a.api?.id??a.id},mode:ie}),Ye=[Markdown.replaceVariables(Fe,T),...$e.map(V=>V.content),...Ge],je=await t.tools({agent:c.name,model:{providerId:a.providerId,modelId:a.api?.id??a.id},toolFilter:V=>ve.includes(V)}),qe=`Review the conversation below and decide what is worth remembering. Store it with the \`memory\` tool.
13
+ `;}return r}async function Vt(){let r=(await Agent.get(ve))?.prompt?.trim();if(!r)throw new Error(`memory extract: agent "${ve}" has no prompt (\u8BB0\u5FC6\u89C4\u8303\u7F3A\u5931)`);return r}async function Wt(e,r,t,o,n){let l=o.agent||await Agent.defaultAgent(),p=l?await Agent.get(l):void 0;if(!p)throw new Error(`memory extract: agent not found (${l})`);let i=o.model??await Provider.defaultModel(),s=typeof i=="string"?Provider.parseModel(i):i,a=await Provider.getModel(s.providerId,s.modelId),u=await t.get();if(!u)throw new Error(`memory extract: session not found (${e.sessionId})`);let d=r.identity?.();if(!d)throw new Error("memory extract: identity capability unavailable");let{metadata:M,initialized:m}=await d.protocol(),G=u.contextMode??DefaultContextMode,qe=await Vt(),Be=await d.staticPrompt({agent:p,model:{providerId:a.providerId,modelId:a.api?.id??a.id},workspaceDir:u.directory,mode:G}),Ue=await d.environment({agent:p,model:{providerId:a.providerId,modelId:a.api?.id??a.id},mode:G}),ze=[Markdown.replaceVariables(qe,M),...Be.map(X=>X.content),...Ue],Ve=await t.tools({agent:p.name,model:{providerId:a.providerId,modelId:a.api?.id??a.id},toolFilter:X=>Ce.includes(X)}),We=`Review the conversation below and decide what is worth remembering. Store it with the \`memory\` tool.
14
14
 
15
- ${await Yt(n)}`,me=await LanguageProvider.generate({user:{id:Identifier.ascending("message"),sessionId:e.sessionId,model:o.model??{providerId:a.providerId,modelId:a.api?.id??a.id}},sessionId:e.sessionId,agent:c,system:Ye,model:a,temperature:Provider.LIMITS.TEMPERATURE.SUMMARY,maxOutputTokens:Ft,messages:[{role:"user",content:[{type:"text",text:qe}]}],tools:je,activeTools:ve,stopWhen:stepCountIs(5),abort:new AbortController().signal});return I.debug("memory extract finished",{sessionId:e.sessionId,outputLength:me.text.length}),me.text}async function ee(e,r,t,o,n){try{await e.updatePart({...t,messageId:r,status:n.status,time:{start:o,end:Date.now()},...n.result!==void 0?{result:n.result}:{},...n.error!==void 0?{error:n.error}:{},...n.reason!==void 0?{reason:n.reason}:{}});}catch(d){I.error("memory part status update failed",{error:errorMeta(d),status:n.status});}}async function Ce(e,r){let t=e;if(!t.userMessageId)return I.debug("loop.end: no userMessageId, skip"),{modified:false,input:e};if(!await _())return I.debug("loop.end: memory not configured, skip extract"),{modified:false,input:e};let o=`${t.sessionId}:${t.userMessageId}`;if(I.debug("loop.end: memory extract started",{loopKey:o,step:t.step,result:t.result}),r.agent&&await Agent.isSubagent(r.agent))return I.debug("loop.end: skip memory extract, subagent",{loopKey:o}),{modified:false,input:e};let n=r.session?.(t.sessionId);if(!n)return I.debug("loop.end: skip memory extract, session capability unavailable",{loopKey:o}),{modified:false,input:e};let d=await n.message(t.userMessageId);if(!d)return I.debug("loop.end: user message not found, skip",{loopKey:o}),{modified:false,input:e};if(d.parts.some(p=>p.type==="memory"))return I.debug("loop.end: skip memory extract, already processed"),{modified:false,input:e};let c=Identifier.ascending("part"),m=Date.now(),s={id:c,type:"memory",status:"in_progress",time:{start:m}};await n.updatePart({...s,messageId:t.userMessageId});let a=await Gt(n,t.userMessageId);return a.some(p=>p.role==="assistant"&&p.content)?(qt(t,r,n,d,a).then(p=>ee(n,t.userMessageId,s,m,{status:"completed",result:p})).catch(p=>(I.error("memory extract failed",{error:errorMeta(p)}),ee(n,t.userMessageId,s,m,{status:"failed",error:errorMeta(p).message}))),{modified:false,input:e}):(I.debug("loop.end: skip memory extract, no assistant text content",{loopKey:o}),await ee(n,t.userMessageId,s,m,{status:"skipped",reason:"No assistant text content"}),{modified:false,input:e})}var R=[{event:HookEvent.ContextCollect,handler:Y},{event:HookEvent.SessionCompacting,handler:j},{event:HookEvent.ToolFailure,handler:q},{event:HookEvent.LoopEnd,handler:Ce}];function A(){return R.map(({event:e,handler:r})=>({event:e,hooks:[{type:"function",handler:r}]}))}var L=Log.create({service:"memory.plugin.tool"}),ne="memory",ae=["recall","remember","update","forget","extract","graph_query","status"],Xt=500,Ne="Access EASBot long-term memory via `operation` (recall / remember / update / forget / extract / graph_query / status).",re=z.enum(["user_preference","task_context","technical_fact","decision","relationship","reminder","error_pattern","workflow","exploration_finding","experience_summary","tool_usage","skill_creation","test","other"]),Ae=z.discriminatedUnion("operation",[z.object({operation:z.literal("recall"),query:z.string().describe("Search query text"),limit:Schema.positiveInt.optional().default(10).describe("Max results (default 10)"),category:re.optional().describe("Filter by memory category"),minImportance:Schema.positiveInt.optional().refine(e=>e===void 0||e>=1&&e<=10,{message:"minImportance must be in [1, 10] (inclusive); the service uses `WHERE importance >= ?` SQL"}).describe("INCLUSIVE `>=` filter on 1-10 importance scale; e.g. `5` keeps importance 5"),minScore:z.number().min(0).max(1).optional().describe("Minimum relevance score filter (default 0; range [0, 1])"),maxEdgesPerNode:Schema.positiveInt.optional().default(10).refine(e=>e===void 0||e>=1&&e<=100,{message:"maxEdgesPerNode must be in [1, 100]"}).describe("Max edges per KG neighbor node returned by recall (default 10; range [1, 100])"),includeGraph:z.boolean().optional().default(false).describe("Include KG neighbor subgraph (default false; pass true to get BFS neighbors alongside hits)"),includeShared:z.boolean().optional().default(false).describe("Include shared KG nodes from other agents (requires trusted local; default false)")}).strict(),z.object({operation:z.literal("remember"),content:z.string().describe("Memory content"),category:re.describe("Memory category"),importance:Schema.positiveInt.describe("Importance 1-10 (service layer enforces range)"),tags:Schema.stringArray.optional().describe("Optional tags (string[])")}).strict(),z.object({operation:z.literal("update"),factId:z.string().describe("Target fact id (must belong to ctx.agentId)"),content:z.string().optional().describe("New content (triggers embedding rewrite + FTS reindex)"),category:re.optional().describe("New category"),importance:Schema.positiveInt.optional().describe("New importance 1-10"),tags:Schema.stringArray.optional().describe("New tags (string[]; empty array clears tags)")}).strict().refine(e=>e.content!==void 0||e.category!==void 0||e.importance!==void 0||e.tags!==void 0,{message:"update requires at least one of: `content`, `category`, `importance`, `tags`"}),z.object({operation:z.literal("forget"),factId:z.string().describe("Target fact id to delete (required; must belong to ctx.agentId)"),dryRun:z.boolean().optional().default(false).describe("Preview without deleting (returns matched count, never deletes)"),force:z.boolean().optional().default(false).describe("Skip KG reference check and delete anyway (required when fact is referenced by other facts; use after dryRun confirms the match)")}).strict(),z.object({operation:z.literal("extract"),lastN:Schema.positiveInt.optional().default(10).describe("Recent messages (default 10)"),fromMessageId:z.string().optional().describe("Process messages after this id")}).strict(),z.object({operation:z.literal("graph_query"),nodeId:Schema.positiveInt.describe("KG node ID to start BFS from; get it from a recall hit or a prior graph_query result"),maxDepth:Schema.positiveInt.optional().default(2).describe("BFS depth for neighbor expansion (default 2; service range [1, 5])"),maxNodes:Schema.nonNegativeInt.optional().default(100).describe("Max nodes returned after BFS (default 100; service max 500)"),maxEdgesPerNode:Schema.positiveInt.optional().default(10).refine(e=>e===void 0||e>=1&&e<=100,{message:"maxEdgesPerNode must be in [1, 100]"}).describe("Max edges per BFS neighbor node (default 10; range [1, 100])"),relation:z.string().optional().describe('Edge relation filter (e.g. "uses"; single-value exact match; differs from note.graph_query relationTypes[])'),type:z.string().optional().describe('Node type filter for root node (e.g. "decision"; only affects CLI query path; nodeId path bypasses)')}).strict(),z.object({operation:z.literal("status")}).strict()]),se=Ae;function Zt(){try{let e=loadTextFile("./memory.txt",import.meta.url)();return e.trim().length>0?e:Ne}catch(e){return L.warn("memory tool description unavailable, using fallback",{error:errorMeta(e)}),Ne}}function er(e){let r=e.agent?.trim();if(!r)throw new NameErrors.MissingFieldError({message:"memory tool: agentId is required (ctx.agent must be set)",field:"agentId"});return r}function tr(e){if(e?.sessionId?.trim())return e.sessionId;throw new NameErrors.MissingFieldError({message:"memory tool: sessionId is required (ctx.sessionId must be set)",field:"sessionId"})}async function rr(e,r){let t=j$1(e);if(!existsSync(t)){L.debug("memory db not found, auto-initializing",{dbPath:t,workspaceDir:e});try{await z$1("init",{workspaceDir:e,force:!1},r);}catch(o){throw new NameErrors.OperationFailedError({message:`memory tool: auto-init failed (${errorMeta(o).message}). Try running \`easbot memory init\` manually.`,operation:"memory-auto-init"})}}}async function or(){if(!(a$1.isInitialized()&&a$1.capabilities().graph))try{let e=await d.getMemoryJson();a$1.init({models:{embedding:e?.embedding_model??void 0,graph:e?.graph_model??void 0}});}catch(e){L.warn("memory Llm init failed; KG extraction will be skipped",{error:errorMeta(e)});}}var D=createTool({description:Zt(),args:Ae,isEnabled:()=>d.exists(),execute:async(e,r)=>{let t=e,o=t.operation;try{await r.ask({permission:"memory",patterns:o==="recall"?[t.query]:["*"],always:["*"],metadata:{operation:o}});let n=er(r),d=r.worktree||r.directory||process.cwd(),c=j$1(d),m={agentId:n,isTrustedLocal:!0,remote:!1,locale:Locale.resolveLocaleLang(),dbPath:c,workspaceDir:d,rootDir:d,config:A$1({agentId:n,dbPath:c,workspaceDir:d}),signal:r.abort};switch(await or(),await rr(d,m),o){case "recall":{let s=await z$1("recall",{query:t.query,maxResults:t.limit,category:t.category,minImportance:t.minImportance,minScore:t.minScore,maxEdgesPerNode:t.maxEdgesPerNode,includeGraph:t.includeGraph??!1,includeShared:t.includeShared??!1,snippetMaxChars:Xt},m);return {output:await a("recall",{kind:"recall",query:t.query,agentId:m.agentId,scope:"agent_only",totalCount:s.total,truncated:s.truncated,hits:s.hits.map(i=>({fact:{id:i.memoryId,agentId:i.agentId,category:i.category,content:i.content,importance:i.importance,tags:i.tags??null,source:i.source,sessionId:i.sessionId??null,msgId:i.msgId??null,parentMsgId:i.parentMsgId??null,filePath:i.filePath??null,createdAt:i.createdAt,updatedAt:i.updatedAt??i.createdAt,truncated:i.content.length>200},score:i.score,source:"hybrid",snippet:i.snippet,nodeIds:i.nodes?.map(p=>p.id)??[],nodes:i.nodes}))},{toolName:"memory_recall"}),title:`Memory: recall (${t.query})`,metadata:{operation:"recall",enabled:!0,agentId:n,query:t.query}}}case "remember":{let s=await z$1("remember",{content:t.content,category:t.category,importance:t.importance,tags:t.tags,sessionId:r.sessionId},m);return {output:`<memory_result>
15
+ ${await zt(n)}`,C=await Loop.run({user:{id:Identifier.ascending("message"),sessionId:e.sessionId,model:o.model??{providerId:a.providerId,modelId:a.api?.id??a.id}},sessionId:e.sessionId,agent:p,system:ze,model:a,temperature:Provider.LIMITS.TEMPERATURE.SUMMARY,maxOutputTokens:Kt,messages:[{role:"user",content:[{type:"text",text:We}]}],tools:Ve,activeTools:Ce,maxSteps:qt,abort:AbortSignal.timeout(jt)});return h.debug("memory extract finished",{sessionId:e.sessionId,outputLength:C.text.length,steps:C.steps,toolCalls:C.toolCalls.length,cost:C.cost}),C.text}async function ne(e,r,t,o,n){try{await e.updatePart({...t,messageId:r,status:n.status,time:{start:o,end:Date.now()},...n.result!==void 0?{result:n.result}:{},...n.error!==void 0?{error:n.error}:{},...n.reason!==void 0?{reason:n.reason}:{}});}catch(l){h.error("memory part status update failed",{error:errorMeta(l),status:n.status});}}async function Ae(e,r){let t=e;if(!t.userMessageId)return h.debug("loop.end: no userMessageId, skip"),{modified:false,input:e};if(!await w())return h.debug("loop.end: memory not configured, skip extract"),{modified:false,input:e};let o=`${t.sessionId}:${t.userMessageId}`;if(h.debug("loop.end: memory extract started",{loopKey:o,step:t.step,result:t.result}),r.agent&&await Agent.isSubagent(r.agent))return h.debug("loop.end: skip memory extract, subagent",{loopKey:o}),{modified:false,input:e};let n=r.session?.(t.sessionId);if(!n)return h.debug("loop.end: skip memory extract, session capability unavailable",{loopKey:o}),{modified:false,input:e};let l=await n.message(t.userMessageId);if(!l)return h.debug("loop.end: user message not found, skip",{loopKey:o}),{modified:false,input:e};if(l.parts.some(d=>d.type==="memory"))return h.debug("loop.end: skip memory extract, already processed"),{modified:false,input:e};let p=Identifier.ascending("part"),i=Date.now(),s={id:p,type:"memory",status:"in_progress",time:{start:i}};await n.updatePart({...s,messageId:t.userMessageId});let a=await Ut(n,t.userMessageId);return a.some(d=>d.role==="assistant"&&d.content)?(Wt(t,r,n,l,a).then(d=>ne(n,t.userMessageId,s,i,{status:"completed",result:d})).catch(d=>(h.error("memory extract failed",{error:errorMeta(d)}),ne(n,t.userMessageId,s,i,{status:"failed",error:errorMeta(d).message}))),{modified:false,input:e}):(h.debug("loop.end: skip memory extract, no assistant text content",{loopKey:o}),await ne(n,t.userMessageId,s,i,{status:"skipped",reason:"No assistant text content"}),{modified:false,input:e})}var O=[{event:HookEvent.ContextCollect,handler:j},{event:HookEvent.SessionCompacting,handler:q},{event:HookEvent.ToolFailure,handler:B},{event:HookEvent.LoopEnd,handler:Ae}];function L(){return O.map(({event:e,handler:r})=>({event:e,hooks:[{type:"function",handler:r}]}))}async function Le(e,r){return trimKnowledgeResult(e,{...r,dataDir:r.dataDir??h$1()})}var De={listPaths:["hits","hits.*.nodes","hits.*.nodes.*.edges","nodes","edges","factIds","entities","relations"],fieldPaths:["hits.*.content","hits.*.fact.content","hits.*.snippet"]};var D=Log.create({service:"memory.plugin.tool"}),me="memory",le=["recall","remember","update","forget","extract","graph_query","status"],sr=500,Ge="Access EASBot long-term memory via `operation` (recall / remember / update / forget / extract / graph_query / status).",se=z.enum(["user_preference","task_context","technical_fact","decision","relationship","reminder","error_pattern","workflow","exploration_finding","experience_summary","tool_usage","skill_creation","test","other"]),Ye=z.discriminatedUnion("operation",[z.object({operation:z.literal("recall"),query:z.string().describe("Search query text"),limit:Schema.positiveInt.optional().default(10).describe("Max results (default 10)"),category:se.optional().describe("Filter by memory category"),minImportance:Schema.positiveInt.optional().refine(e=>e===void 0||e>=1&&e<=10,{message:"minImportance must be in [1, 10] (inclusive); the service uses `WHERE importance >= ?` SQL"}).describe("INCLUSIVE `>=` filter on 1-10 importance scale; e.g. `5` keeps importance 5"),minScore:z.number().min(0).max(1).optional().describe("Minimum relevance score filter (default 0; range [0, 1])"),maxEdgesPerNode:Schema.positiveInt.optional().default(10).refine(e=>e===void 0||e>=1&&e<=100,{message:"maxEdgesPerNode must be in [1, 100]"}).describe("Max edges per KG neighbor node returned by recall (default 10; range [1, 100])"),includeGraph:z.boolean().optional().default(false).describe("Include KG neighbor subgraph (default false; pass true to get BFS neighbors alongside hits)"),includeShared:z.boolean().optional().default(false).describe("Include shared KG nodes from other agents (requires trusted local; default false)")}).strict(),z.object({operation:z.literal("remember"),content:z.string().describe("Memory content"),category:se.describe("Memory category"),importance:Schema.positiveInt.describe("Importance 1-10 (service layer enforces range)"),tags:Schema.stringArray.optional().describe("Optional tags (string[])")}).strict(),z.object({operation:z.literal("update"),factId:z.string().describe("Target fact id (must belong to ctx.agentId)"),content:z.string().optional().describe("New content (triggers embedding rewrite + FTS reindex)"),category:se.optional().describe("New category"),importance:Schema.positiveInt.optional().describe("New importance 1-10"),tags:Schema.stringArray.optional().describe("New tags (string[]; empty array clears tags)")}).strict().refine(e=>e.content!==void 0||e.category!==void 0||e.importance!==void 0||e.tags!==void 0,{message:"update requires at least one of: `content`, `category`, `importance`, `tags`"}),z.object({operation:z.literal("forget"),factId:z.string().describe("Target fact id to delete (required; must belong to ctx.agentId)"),dryRun:z.boolean().optional().default(false).describe("Preview without deleting (returns matched count, never deletes)"),force:z.boolean().optional().default(false).describe("Skip KG reference check and delete anyway (required when fact is referenced by other facts; use after dryRun confirms the match)")}).strict(),z.object({operation:z.literal("extract"),lastN:Schema.positiveInt.optional().default(10).describe("Recent messages (default 10)"),fromMessageId:z.string().optional().describe("Process messages after this id")}).strict(),z.object({operation:z.literal("graph_query"),nodeId:Schema.positiveInt.describe("KG node ID to start BFS from; get it from a recall hit or a prior graph_query result"),maxDepth:Schema.positiveInt.optional().default(2).describe("BFS depth for neighbor expansion (default 2; service range [1, 5])"),maxNodes:Schema.nonNegativeInt.optional().default(100).describe("Max nodes returned after BFS (default 100; service max 500)"),maxEdgesPerNode:Schema.positiveInt.optional().default(10).refine(e=>e===void 0||e>=1&&e<=100,{message:"maxEdgesPerNode must be in [1, 100]"}).describe("Max edges per BFS neighbor node (default 10; range [1, 100])"),relation:z.string().optional().describe('Edge relation filter (e.g. "uses"; single-value exact match; differs from note.graph_query relationTypes[])'),type:z.string().optional().describe('Node type filter for root node (e.g. "decision"; only affects CLI query path; nodeId path bypasses)')}).strict(),z.object({operation:z.literal("status")}).strict()]),de=Ye;function ir(){try{let e=loadTextFile("./memory.txt",import.meta.url)();return e.trim().length>0?e:Ge}catch(e){return D.warn("memory tool description unavailable, using fallback",{error:errorMeta(e)}),Ge}}function mr(e){let r=e.protocolMetadata?.agentId?.trim()||e.agent?.trim();if(!r)throw new NameErrors.MissingFieldError({message:"memory tool: agentId is required (ctx.protocolMetadata.agentId or ctx.agent must be set)",field:"agentId"});return r}function lr(e){if(e?.sessionId?.trim())return e.sessionId;throw new NameErrors.MissingFieldError({message:"memory tool: sessionId is required (ctx.sessionId must be set)",field:"sessionId"})}async function dr(e,r){let t=j$1(e);if(!existsSync(t)){D.debug("memory db not found, auto-initializing",{dbPath:t,workspaceDir:e});try{await z$1("init",{workspaceDir:e,force:!1},r);}catch(o){throw new NameErrors.OperationFailedError({message:`memory tool: auto-init failed (${errorMeta(o).message}). Try running \`easbot memory init\` manually.`,operation:"memory-auto-init"})}}}async function cr(){if(!(a$1.isInitialized()&&a$1.capabilities().graph))try{let e=await d.getMemoryJson();a$1.init({models:{embedding:e?.embedding_model??void 0,graph:e?.graph_model??void 0}});}catch(e){D.warn("memory Llm init failed; KG extraction will be skipped",{error:errorMeta(e)});}}async function W(e,r,t){let o=`memory_${e}`,n=await Le(r,{toolName:o,paths:De}),l=trimEdgesForLLM(n.result),p=await t(l),i=await Truncate.output(p,{contentType:"output",toolName:o}),s=formatKnowledgeTruncationHint(n,o);return i.truncated?{output:`${i.content}
16
+
17
+ [Full output truncated: ${i.outputPath}]`,truncated:true,outputPath:i.outputPath}:{output:s?`${i.content}
18
+
19
+ ${s}`:i.content,truncated:false}}var F=createTool({description:ir(),args:Ye,isEnabled:()=>d.exists(),execute:async(e,r)=>{let t=e,o=t.operation;try{await r.ask({permission:"memory",patterns:o==="recall"?[t.query]:["*"],always:["*"],metadata:{operation:o}});let n=mr(r),l=r.worktree||r.directory||process.cwd(),p=j$1(l),i={agentId:n,isTrustedLocal:!0,remote:!1,locale:Locale.resolveLocaleLang(),dbPath:p,workspaceDir:l,rootDir:l,config:A({agentId:n,dbPath:p,workspaceDir:l}),signal:r.abort};switch(await cr(),await dr(l,i),o){case "recall":{let s=await z$1("recall",{query:t.query,maxResults:t.limit,category:t.category,minImportance:t.minImportance,minScore:t.minScore,maxEdgesPerNode:t.maxEdgesPerNode,includeGraph:t.includeGraph??!1,includeShared:t.includeShared??!1,snippetMaxChars:sr},i),a$1={kind:"recall",query:t.query,agentId:i.agentId,scope:"agent_only",totalCount:s.total,truncated:s.truncated,hits:s.hits.map(m=>({fact:{id:m.memoryId,agentId:m.agentId,category:m.category,content:m.content,importance:m.importance,tags:m.tags??null,source:m.source,sessionId:m.sessionId??null,msgId:m.msgId??null,parentMsgId:m.parentMsgId??null,filePath:m.filePath??null,createdAt:m.createdAt,updatedAt:m.updatedAt??m.createdAt,truncated:m.content.length>200},score:m.score,source:"hybrid",snippet:m.snippet,nodeIds:m.nodes?.map(G=>G.id)??[],nodes:m.nodes}))},{output:u,truncated:d,outputPath:M}=await W("recall",a$1,m=>a("recall",m,{toolName:"memory_recall"}));return {output:u,title:`Memory: recall (${t.query})`,metadata:{operation:"recall",enabled:!0,agentId:n,query:t.query,truncated:d,...d&&M?{outputPath:M}:{}}}}case "remember":{let s=await z$1("remember",{content:t.content,category:t.category,importance:t.importance,tags:t.tags,sessionId:r.sessionId},i);return {output:`<memory_result>
16
20
  Memory saved.
17
21
  id: ${s.fact.id}
18
22
  category: ${s.fact.category}
19
23
  importance: ${t.importance}
20
24
  linked nodes: ${s.nodeIds?.length??0}
21
- </memory_result>`,title:"Memory saved",metadata:{operation:"remember",enabled:!0,agentId:n,memoryId:s.fact.id,category:s.fact.category,importance:t.importance}}}case "update":{let s=await z$1("update",{factId:t.factId,content:t.content,category:t.category,importance:t.importance,tags:t.tags},m),a=s.fieldsUpdated.length>0?s.fieldsUpdated.join(", "):"(no-op)",i=s.contentChanged?" (embedding rewritten)":"";return {output:`<memory_result>
25
+ </memory_result>`,title:"Memory saved",metadata:{operation:"remember",enabled:!0,agentId:n,memoryId:s.fact.id,category:s.fact.category,importance:t.importance}}}case "update":{let s=await z$1("update",{factId:t.factId,content:t.content,category:t.category,importance:t.importance,tags:t.tags},i),a=s.fieldsUpdated.length>0?s.fieldsUpdated.join(", "):"(no-op)",u=s.contentChanged?" (embedding rewritten)":"";return {output:`<memory_result>
22
26
  Memory updated.
23
27
  id: ${s.fact.id}
24
28
  category: ${s.fact.category}
25
29
  importance: ${s.fact.importance}
26
- fields updated: ${a}${i}
30
+ fields updated: ${a}${u}
27
31
  updated_at: ${s.fact.updatedAt}
28
- </memory_result>`,title:"Memory updated",metadata:{operation:"update",enabled:!0,agentId:n,memoryId:s.fact.id,category:s.fact.category,importance:s.fact.importance}}}case "forget":{let s=await z$1("forget",{factId:t.factId,dryRun:t.dryRun,force:t.force},m);return {output:await a("forget",s,{toolName:"memory_forget"}),title:"Memory: forget",metadata:{operation:"forget",enabled:!0,agentId:n}}}case "extract":{let s=tr(r),a=await z$1("extract",{sessionId:s,lastN:t.lastN,fromMessageId:t.fromMessageId},m);return {output:`<memory_result>
32
+ </memory_result>`,title:"Memory updated",metadata:{operation:"update",enabled:!0,agentId:n,memoryId:s.fact.id,category:s.fact.category,importance:s.fact.importance}}}case "forget":{let s=await z$1("forget",{factId:t.factId,dryRun:t.dryRun,force:t.force},i),{output:a$1,truncated:u,outputPath:d}=await W("forget",s,M=>a("forget",M,{toolName:"memory_forget"}));return {output:a$1,title:"Memory: forget",metadata:{operation:"forget",enabled:!0,agentId:n,truncated:u,...u&&d?{outputPath:d}:{}}}}case "extract":{let s=lr(r),a=await z$1("extract",{sessionId:s,lastN:t.lastN,fromMessageId:t.fromMessageId},i),{output:u,truncated:d,outputPath:M}=await W("extract",a,async m=>`<memory_result>
29
33
  Extract completed.
30
34
  sessionId: ${s}
31
- extractedCount: ${a.extractedCount}
32
- factIds: ${a.factIds.length>0?a.factIds.join(", "):"(none)"}
33
- messageRange: ${a.messageRange.fromMessageId} -> ${a.messageRange.toMessageId}
34
- </memory_result>`,title:"memory: extract",metadata:{operation:"extract",enabled:!0,agentId:n,total:a.extractedCount}}}case "graph_query":{let s=await z$1("graph_query",{nodeId:t.nodeId,maxDepth:t.maxDepth,maxNodes:t.maxNodes,maxEdgesPerNode:t.maxEdgesPerNode,...t.relation!==void 0?{relation:t.relation}:{},...t.type!==void 0?{type:t.type}:{}},m);return {output:await a("graph_query",s,{toolName:"memory_graph_query"}),title:"Memory: graph_query",metadata:{operation:"graph_query",enabled:!0,agentId:n}}}case "status":{let a=await z$1("status",{},m);return {output:renderKnowledgeStatus({packageName:"memory",rootDir:a.workspaceDir??"",configPath:a.configPath??"",configExists:typeof a.configExists=="boolean"?a.configExists:!0,dbPath:a.dbPath,dbExists:typeof a.dbExists=="boolean"?a.dbExists:!0,dbSize:a.dbSize,indexState:a.indexState,schemaVersion:a.schemaVersion,extractionVersion:a.extractionVersion,lastSyncAt:a.lastSyncAt,vectorEnabled:a.vectorEnabled,embeddingDims:a.embeddingDims,llm:a.llm??{initialized:!1,capabilities:{}},backend:a.backend,healthy:a.healthy,recommendation:a.recommendation,dbStats:a.dbStats??a.integrityStats,extras:(()=>{let p={};if(typeof a.agentId=="string"&&(p.agent_id=a.agentId),typeof a.ftsAvailable=="boolean"&&(p.fts_available=a.ftsAvailable?"yes":"no"),a.factsByCategory&&typeof a.factsByCategory=="object")for(let[T,E]of Object.entries(a.factsByCategory))typeof E=="number"&&E>0&&(p[`facts/${T}`]=E);if(a.meta&&typeof a.meta=="object")for(let[T,E]of Object.entries(a.meta))E!==void 0&&(p[`meta/${T}`]=E);return Object.keys(p).length>0?p:void 0})()}),title:"Memory: status",metadata:{operation:"status",enabled:!0,agentId:n}}}}}catch(n){if(ServiceError.isInstance(n))try{return {output:ServiceErrorBus.toMarkdown(n,{tool:"memory",operation:o,resultTag:"<memory_result>",pack:"memory"}),title:`Memory: ${o} (${n.data.code})`,metadata:{operation:o,enabled:!0,businessErrorCode:n.data.code}}}catch(d){return L.error("memory tool ServiceErrorBus formatting failed",{error:errorMeta(d)}),{output:`<memory_result>
35
+ extractedCount: ${m.extractedCount}
36
+ factIds: ${m.factIds.length>0?m.factIds.join(", "):"(none)"}
37
+ messageRange: ${m.messageRange.fromMessageId} -> ${m.messageRange.toMessageId}
38
+ </memory_result>`);return {output:u,title:"memory: extract",metadata:{operation:"extract",enabled:!0,agentId:n,truncated:d,...d&&M?{outputPath:M}:{},total:a.extractedCount}}}case "graph_query":{let s=await z$1("graph_query",{nodeId:t.nodeId,maxDepth:t.maxDepth,maxNodes:t.maxNodes,maxEdgesPerNode:t.maxEdgesPerNode,...t.relation!==void 0?{relation:t.relation}:{},...t.type!==void 0?{type:t.type}:{}},i),{output:a$1,truncated:u,outputPath:d}=await W("graph_query",s,M=>a("graph_query",M,{toolName:"memory_graph_query"}));return {output:a$1,title:"Memory: graph_query",metadata:{operation:"graph_query",enabled:!0,agentId:n,truncated:u,...u&&d?{outputPath:d}:{}}}}case "status":{let a=await z$1("status",{},i);return {output:renderKnowledgeStatus({packageName:"memory",rootDir:a.workspaceDir??"",configPath:a.configPath??"",configExists:typeof a.configExists=="boolean"?a.configExists:!0,dbPath:a.dbPath,dbExists:typeof a.dbExists=="boolean"?a.dbExists:!0,dbSize:a.dbSize,indexState:a.indexState,schemaVersion:a.schemaVersion,extractionVersion:a.extractionVersion,lastSyncAt:a.lastSyncAt,vectorEnabled:a.vectorEnabled,embeddingDims:a.embeddingDims,llm:a.llm??{initialized:!1,capabilities:{}},backend:a.backend,healthy:a.healthy,recommendation:a.recommendation,dbStats:a.dbStats??a.integrityStats,extras:(()=>{let d={};if(typeof a.agentId=="string"&&(d.agent_id=a.agentId),typeof a.ftsAvailable=="boolean"&&(d.fts_available=a.ftsAvailable?"yes":"no"),a.factsByCategory&&typeof a.factsByCategory=="object")for(let[M,m]of Object.entries(a.factsByCategory))typeof m=="number"&&m>0&&(d[`facts/${M}`]=m);if(a.meta&&typeof a.meta=="object")for(let[M,m]of Object.entries(a.meta))m!==void 0&&(d[`meta/${M}`]=m);return Object.keys(d).length>0?d:void 0})()}),title:"Memory: status",metadata:{operation:"status",enabled:!0,agentId:n}}}}}catch(n){if(ServiceError.isInstance(n))try{return {output:ServiceErrorBus.toMarkdown(n,{tool:"memory",operation:o,resultTag:"<memory_result>",pack:"memory"}),title:`Memory: ${o} (${n.data.code})`,metadata:{operation:o,enabled:!0,businessErrorCode:n.data.code}}}catch(l){return D.error("memory tool ServiceErrorBus formatting failed",{error:errorMeta(l)}),{output:`<memory_result>
35
39
  Error: ${n.data.message}
36
- </memory_result>`,title:`Memory: ${o} (${n.data.code})`,metadata:{operation:o,enabled:true,businessErrorCode:n.data.code}}}return L.error("memory tool execution failed",{operation:o,error:errorMeta(n)}),{output:`<memory_result>
40
+ </memory_result>`,title:`Memory: ${o} (${n.data.code})`,metadata:{operation:o,enabled:true,businessErrorCode:n.data.code}}}return D.error("memory tool execution failed",{operation:o,error:errorMeta(n)}),{output:`<memory_result>
37
41
  Error: ${errorMeta(n).message}
38
- </memory_result>`,title:`Memory: ${o} (error)`,metadata:{operation:o,enabled:true}}}}});var F=async e=>({hooks:A(),tools:{[G.name]:D}});var Le=[HookEvent.ContextCollect,HookEvent.SessionCompacting,HookEvent.ToolFailure,HookEvent.LoopEnd];var De={name:"memory.plugin",async init(){return {isEnabled:()=>true,handlers:R.map(({event:e,handler:r})=>({name:e,handler:r}))}}};export{ar as MEMORY_CATEGORIES,R as MEMORY_HOOK_BINDINGS,Le as MEMORY_HOOK_EVENTS,J as MEMORY_PLUGIN_ID,G as MEMORY_PLUGIN_MANIFEST,X as MEMORY_PLUGIN_VERSION,se as MEMORY_TOOL_ARGS,ne as MEMORY_TOOL_ID,ae as MEMORY_TOOL_OPS,F as MemoryPlugin,F as MemoryPluginEntry,De as MemoryPluginHook,D as MemoryTool,fr as addWord,Mr as closeTokenizer,A as createMemoryHookMatchers,gr as initTokenizer,yr as isInitialized,yt as loadCustomDict,xr as toFtsTokens,br as toFtsTokensForSearch,Mt as tokenize,xt as tokenizeForSearch};
42
+ </memory_result>`,title:`Memory: ${o} (error)`,metadata:{operation:o,enabled:true}}}}});var $=async e=>({hooks:L(),tools:{[K.name]:F}});var Ke=[HookEvent.ContextCollect,HookEvent.SessionCompacting,HookEvent.ToolFailure,HookEvent.LoopEnd];var je={name:"memory.plugin",async init(){return {isEnabled:()=>true,handlers:O.map(({event:e,handler:r})=>({name:e,handler:r}))}}};export{ur as MEMORY_CATEGORIES,O as MEMORY_HOOK_BINDINGS,Ke as MEMORY_HOOK_EVENTS,te as MEMORY_PLUGIN_ID,K as MEMORY_PLUGIN_MANIFEST,re as MEMORY_PLUGIN_VERSION,de as MEMORY_TOOL_ARGS,me as MEMORY_TOOL_ID,le as MEMORY_TOOL_OPS,$ as MemoryPlugin,$ as MemoryPluginEntry,je as MemoryPluginHook,F as MemoryTool,_r as addWord,wr as closeTokenizer,L as createMemoryHookMatchers,hr as initTokenizer,Er as isInitialized,kt as loadCustomDict,Rr as toFtsTokens,Or as toFtsTokensForSearch,ht as tokenize,_t as tokenizeForSearch};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@easbot/memory",
3
- "version": "0.3.40",
3
+ "version": "0.3.41",
4
4
  "description": "Memory management library for EASBOT ecosystem - 智能记忆管理库,支持混合搜索、中英文分词、增量索引",
5
5
  "type": "module",
6
6
  "main": "dist/index.cjs",
@@ -53,15 +53,15 @@
53
53
  "ai": "^6.0.253",
54
54
  "better-sqlite3": "^13.0.3",
55
55
  "jieba-wasm": "^2.4.0",
56
- "@easbot/database": "0.3.40",
57
- "@easbot/plugin": "0.3.40",
58
- "@easbot/types": "0.3.40",
59
- "@easbot/mcp": "0.3.40",
60
- "@easbot/utils": "0.3.40",
61
- "@easbot/terminal": "0.3.40",
62
- "@easbot/llm": "0.3.40",
63
- "@easbot/ollama-sdk": "0.3.40",
64
- "@easbot/local-model-sdk": "0.3.40"
56
+ "@easbot/database": "0.3.41",
57
+ "@easbot/plugin": "0.3.41",
58
+ "@easbot/terminal": "0.3.41",
59
+ "@easbot/mcp": "0.3.41",
60
+ "@easbot/types": "0.3.41",
61
+ "@easbot/utils": "0.3.41",
62
+ "@easbot/llm": "0.3.41",
63
+ "@easbot/local-model-sdk": "0.3.41",
64
+ "@easbot/ollama-sdk": "0.3.41"
65
65
  },
66
66
  "devDependencies": {
67
67
  "@types/node": "^25.9.5",