@easbot/memory 0.3.36 → 0.3.39
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 +207 -49
- package/README.md +86 -18
- package/dist/chunks/{chunk-YUWHNHAY.mjs → chunk-7RA6RQGC.mjs} +1 -1
- package/dist/chunks/{chunk-FZ3RTYIJ.mjs → chunk-HTBMVZF7.mjs} +11 -11
- package/dist/chunks/{chunk-AEAMQDNV.mjs → chunk-IPUFIEKC.mjs} +6 -6
- package/dist/chunks/{chunk-QAEIHJOF.cjs → chunk-KWSPFECY.cjs} +5 -5
- package/dist/chunks/{chunk-4G4FSAFY.cjs → chunk-SAGLLJTU.cjs} +1 -1
- package/dist/chunks/{chunk-ISYAE6B7.cjs → chunk-SEKBFDEC.cjs} +12 -12
- package/dist/chunks/cli-handler-HUTXCEXM.cjs +1 -0
- package/dist/chunks/cli-handler-TUILJT7W.mjs +1 -0
- package/dist/chunks/{consolidate-OOAMW7XW.mjs → consolidate-JMXYI3NF.mjs} +1 -1
- package/dist/chunks/{consolidate-IKQVVWIQ.cjs → consolidate-TYCVXZFF.cjs} +1 -1
- package/dist/chunks/{doctor-ZGHICE2Q.mjs → doctor-3W3MVUZF.mjs} +1 -1
- package/dist/chunks/{doctor-N6HHFR6Y.cjs → doctor-GRS3CZWD.cjs} +1 -1
- package/dist/chunks/{extract-7DQ6OV34.cjs → extract-IKAJ3GHK.cjs} +1 -1
- package/dist/chunks/{extract-AJY2ETKE.mjs → extract-XT6HBENH.mjs} +1 -1
- package/dist/chunks/{forget-NIBBY6FG.mjs → forget-2OAYPXCB.mjs} +1 -1
- package/dist/chunks/{forget-4KGLTQ5Q.cjs → forget-GXJPG4P4.cjs} +1 -1
- package/dist/chunks/{graph-4K56ZAVL.mjs → graph-2AL2R3KO.mjs} +1 -1
- package/dist/chunks/{graph-OG23VZZM.cjs → graph-LJYAUA3C.cjs} +1 -1
- package/dist/chunks/{init-HWR4SD6N.mjs → init-M5CEJUEY.mjs} +1 -1
- package/dist/chunks/{init-UQTPANNI.cjs → init-OFCTBJGM.cjs} +1 -1
- package/dist/chunks/{mcp-ONIMP7FB.cjs → mcp-OKBJHIXH.cjs} +1 -1
- package/dist/chunks/{mcp-ZWZYH52C.mjs → mcp-OWOAIP2Z.mjs} +1 -1
- package/dist/chunks/{recall-KZRYTTWA.cjs → recall-K3DU2S23.cjs} +1 -1
- package/dist/chunks/{recall-BRXHJPR4.mjs → recall-ZEDO4S5I.mjs} +1 -1
- package/dist/chunks/{remember-GLOJH457.cjs → remember-FR7JL2ZC.cjs} +1 -1
- package/dist/chunks/{remember-3XSYCWKK.mjs → remember-TEAHLG4E.mjs} +1 -1
- package/dist/chunks/{status-SW5BUHJ3.mjs → status-BGRJ224S.mjs} +1 -1
- package/dist/chunks/{status-POX2GWSQ.cjs → status-KLQSENQX.cjs} +1 -1
- package/dist/chunks/stdio-server-EEWPIACW.mjs +1 -0
- package/dist/chunks/{stdio-server-W52CMVJO.cjs → stdio-server-ME6A6STR.cjs} +1 -1
- package/dist/chunks/{sync-EE4ZD3WB.mjs → sync-2D3E4DPE.mjs} +1 -1
- package/dist/chunks/{sync-I423W5G7.cjs → sync-QZCZXNNN.cjs} +1 -1
- package/dist/cli.cjs +1 -1
- package/dist/cli.mjs +1 -1
- package/dist/index.cjs +38 -8
- package/dist/index.d.cts +179 -16
- package/dist/index.d.ts +179 -16
- package/dist/index.mjs +38 -8
- package/package.json +13 -11
- package/dist/assets/txt/src/plugin/tool/description.txt +0 -12
- package/dist/chunks/cli-handler-JHSDGJHK.mjs +0 -1
- package/dist/chunks/cli-handler-USK4CPAU.cjs +0 -1
- package/dist/chunks/stdio-server-3A3H4YJ7.mjs +0 -1
package/dist/index.cjs
CHANGED
|
@@ -1,8 +1,38 @@
|
|
|
1
|
-
'use strict';var
|
|
2
|
-
${
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
1
|
+
'use strict';var chunkSEKBFDEC_cjs=require('./chunks/chunk-SEKBFDEC.cjs');require('./chunks/chunk-URADAZYW.cjs');var chunkSAGLLJTU_cjs=require('./chunks/chunk-SAGLLJTU.cjs'),chunkKWSPFECY_cjs=require('./chunks/chunk-KWSPFECY.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'),I=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 I__namespace=/*#__PURE__*/_interopNamespace(I);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"}),k=false,gt=utils.loadTextFile("./assets/jieba_dict.txt",chunkR32346OA_cjs.d);async function ur(e){if(!k)try{f.debug("Initializing jieba tokenizer");let r=gt();if(I__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);k=!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(!k)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}),I__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(!k)return e.split(/\s+/).filter(Boolean);try{return I__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(!k)return e.split(/\s+/).filter(Boolean);try{return I__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(k)try{I__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 k}async function yr(){k=false,f.debug("Tokenizer closed");}function Mr(e){if(!k)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(!k)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 Ie(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 H(e,r){let t={...Ie(e),...Ie(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 P(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:chunkKWSPFECY_cjs.A({agentId:o,dbPath:t,workspaceDir:r})}}function M(e,r){return {modified:false,input:e,output:{...r}}}function Ee(e,r){return y(e,[r])}var X=utils.Log.create({service:"memory.plugin.hook"}),we=1200;function It(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 G=async(e,r)=>{let t=plugin.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 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,l=It(e,o.extras);if(l.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 chunkKWSPFECY_cjs.z("recall",{query:l,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 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=H(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 l=(o.contextPreview??o.messagePreview??"").slice(0,wt).replace(/\s+/g," ").trim(),c=typeof o.extras.topK=="number"?o.extras.topK:3;if(!l)return M(e,{hook:t,ok:true,context:[],logLine:"pre compact: empty context preview; skipping recall injection"});try{let m=await chunkKWSPFECY_cjs.z("recall",{query:l,maxResults:c,minImportance:5},P(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)]
|
|
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"}),St=8,j=async(e,r)=>{let t=plugin.HookEvent.ToolFailure,o=H(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,St),l=o.messagePreview?o.messagePreview.slice(0,200).replace(/\s+/g," ").trim():"",c=[`[error_pattern] tool=${o.toolName}`,`[error] ${o.error}`,l?`[preview] ${l}`:"",`[errHash] ${n}`].filter(Boolean).join(`
|
|
5
|
+
`);try{let m=await chunkKWSPFECY_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},P(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 x=utils.Log.create({service:"memory.plugin.extract"}),He=2e3,Ft=4096,Pe="memory",Se=["memory","read","glob","grep"];function Dt(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 l=n.parts.filter(c=>c.type==="text").map(c=>c.text??"").join("");l&&t.push({role:"assistant",content:l});}let o=await e.message(r);if(o&&o.role==="user"){let n=Dt(o.parts);n&&t.push({role:"user",content:n});}return t}async function Gt(e){if(e.length===0)return "";let r=`### Our Conversation
|
|
6
|
+
|
|
7
|
+
`;for(let t of e){let o=utils.Token.estimate(t.content),n=t.content,l=false;if(o>He){n=t.content.slice(-8e3),l=true;}l?r+=`**${t.role==="user"?"User":"Me"}**: ${n}
|
|
8
|
+
|
|
9
|
+
[Content truncated from ${o} tokens]
|
|
10
|
+
|
|
11
|
+
`:r+=`**${t.role==="user"?"User":"Me"}**: ${n||"(empty)"}
|
|
12
|
+
|
|
13
|
+
`;}return r}async function Yt(){let r=(await llm.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 jt(e,r,t,o,n){let l=o.agent||await llm.Agent.defaultAgent(),c=l?await llm.Agent.get(l):void 0;if(!c)throw new Error(`memory extract: agent not found (${l})`);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:E}=await p.protocol(),se=i.contextMode??types.DefaultContextMode,Fe=await Yt(),De=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(Fe,v),...De.map(z=>z.content),...$e],Ye=await t.tools({agent:c.name,model:{providerId:a.providerId,modelId:a.api?.id??a.id},toolFilter:z=>Se.includes(z)}),je=`Review the conversation below and decide what is worth remembering. Store it with the \`memory\` tool.
|
|
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:Ft,messages:[{role:"user",content:[{type:"text",text:je}]}],tools:Ye,activeTools:Se,stopWhen:ai.stepCountIs(5),abort:new AbortController().signal});return x.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(l){x.error("memory part status update failed",{error:utils.errorMeta(l),status:n.status});}}async function Te(e,r){let t=e;if(!t.userMessageId)return x.debug("loop.end: no userMessageId, skip"),{modified:false,input:e};if(!await h())return x.debug("loop.end: memory not configured, skip extract"),{modified:false,input:e};let o=`${t.sessionId}:${t.userMessageId}`;if(x.debug("loop.end: memory extract started",{loopKey:o,step:t.step,result:t.result}),r.agent&&await llm.Agent.isSubagent(r.agent))return x.debug("loop.end: skip memory extract, subagent",{loopKey:o}),{modified:false,input:e};let n=r.session?.(t.sessionId);if(!n)return x.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 x.debug("loop.end: user message not found, skip",{loopKey:o}),{modified:false,input:e};if(l.parts.some(p=>p.type==="memory"))return x.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,l,a).then(p=>Z(n,t.userMessageId,s,m,{status:"completed",result:p})).catch(p=>(x.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}):(x.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 C(){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,Ne="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"]),Ce=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"),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"),query:zod.z.string().min(1).describe('**Node name fragment** (NOT natural-language query): used to locate a single root node by case-insensitive `LIKE %name%` match against the `nodes.name` column. After matching, the service performs BFS neighbor expansion automatically. Pass only short identifiers \u2014 e.g. an entity name like "easbot" or "decision-0034" as it appears in `nodes.name`. Tags and relation types live on edges, not on node names, so searching for them here returns 0 nodes \u2014 `recall` is the right tool for natural-language fact search.'),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=Ce;function Xt(){try{let e=utils.loadTextFile("./memory.txt",chunkR32346OA_cjs.d)();return e.trim().length>0?e:Ne}catch(e){return A.warn("memory tool description unavailable, using fallback",{error:utils.errorMeta(e)}),Ne}}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 chunkKWSPFECY_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:Ce,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),l=r.worktree||r.directory||process.cwd(),c=chunkGCVKM3RJ_cjs.j(l),m={agentId:n,isTrustedLocal:!0,remote:!1,locale:utils.Locale.resolveLocaleLang(),dbPath:c,workspaceDir:l,rootDir:l,config:chunkKWSPFECY_cjs.A({agentId:n,dbPath:c,workspaceDir:l}),signal:r.abort};switch(await rr(),await tr(l,m),o){case "recall":{let s=await chunkKWSPFECY_cjs.z("recall",{query:t.query,maxResults:t.limit,category:t.category,minImportance:t.minImportance,maxEdgesPerNode:t.maxEdgesPerNode,includeGraph:t.includeGraph??!1,includeShared:t.includeShared??!1,snippetMaxChars:Jt},m);return {output:await chunkSEKBFDEC_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 chunkKWSPFECY_cjs.z("remember",{content:t.content,category:t.category,importance:t.importance,tags:t.tags,sessionId:r.sessionId},m);return {output:`<memory_result>
|
|
16
|
+
Memory saved.
|
|
17
|
+
id: ${s.fact.id}
|
|
18
|
+
category: ${s.fact.category}
|
|
19
|
+
importance: ${t.importance}
|
|
20
|
+
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 chunkKWSPFECY_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>
|
|
22
|
+
Memory updated.
|
|
23
|
+
id: ${s.fact.id}
|
|
24
|
+
category: ${s.fact.category}
|
|
25
|
+
importance: ${s.fact.importance}
|
|
26
|
+
fields updated: ${a}${i}
|
|
27
|
+
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 chunkKWSPFECY_cjs.z("forget",{factId:t.factId,dryRun:t.dryRun,force:t.force},m);return {output:await chunkSEKBFDEC_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 chunkKWSPFECY_cjs.z("extract",{sessionId:s,lastN:t.lastN,fromMessageId:t.fromMessageId},m);return {output:`<memory_result>
|
|
29
|
+
Extract completed.
|
|
30
|
+
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 chunkKWSPFECY_cjs.z("graph_query",{query:t.query,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 chunkSEKBFDEC_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 chunkKWSPFECY_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,E]of Object.entries(a.factsByCategory))typeof E=="number"&&E>0&&(p[`facts/${v}`]=E);if(a.meta&&typeof a.meta=="object")for(let[v,E]of Object.entries(a.meta))E!==void 0&&(p[`meta/${v}`]=E);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(l){return A.error("memory tool ServiceErrorBus formatting failed",{error:utils.errorMeta(l)}),{output:`<memory_result>
|
|
35
|
+
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>
|
|
37
|
+
Error: ${utils.errorMeta(n).message}
|
|
38
|
+
</memory_result>`,title:`Memory: ${o} (error)`,metadata:{operation:o,enabled:true}}}}});var F=async e=>({hooks:C(),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 chunkSEKBFDEC_cjs.b}});Object.defineProperty(exports,"renderOperationMarkdown",{enumerable:true,get:function(){return chunkSEKBFDEC_cjs.a}});Object.defineProperty(exports,"COMMANDS_HELP",{enumerable:true,get:function(){return chunkSAGLLJTU_cjs.a}});Object.defineProperty(exports,"handleMemoryCli",{enumerable:true,get:function(){return chunkSAGLLJTU_cjs.d}});Object.defineProperty(exports,"renderBanner",{enumerable:true,get:function(){return chunkSAGLLJTU_cjs.b}});Object.defineProperty(exports,"renderHelp",{enumerable:true,get:function(){return chunkSAGLLJTU_cjs.c}});Object.defineProperty(exports,"ALL_OPS",{enumerable:true,get:function(){return chunkKWSPFECY_cjs.y}});Object.defineProperty(exports,"GraphStore",{enumerable:true,get:function(){return chunkKWSPFECY_cjs.a}});Object.defineProperty(exports,"OP_REGISTRY",{enumerable:true,get:function(){return chunkKWSPFECY_cjs.x}});Object.defineProperty(exports,"consolidate",{enumerable:true,get:function(){return chunkKWSPFECY_cjs.r}});Object.defineProperty(exports,"doctor",{enumerable:true,get:function(){return chunkKWSPFECY_cjs.v}});Object.defineProperty(exports,"executeOp",{enumerable:true,get:function(){return chunkKWSPFECY_cjs.z}});Object.defineProperty(exports,"extract",{enumerable:true,get:function(){return chunkKWSPFECY_cjs.q}});Object.defineProperty(exports,"forget",{enumerable:true,get:function(){return chunkKWSPFECY_cjs.p}});Object.defineProperty(exports,"graphQuery",{enumerable:true,get:function(){return chunkKWSPFECY_cjs.t}});Object.defineProperty(exports,"init",{enumerable:true,get:function(){return chunkKWSPFECY_cjs.w}});Object.defineProperty(exports,"recall",{enumerable:true,get:function(){return chunkKWSPFECY_cjs.b}});Object.defineProperty(exports,"remember",{enumerable:true,get:function(){return chunkKWSPFECY_cjs.n}});Object.defineProperty(exports,"status",{enumerable:true,get:function(){return chunkKWSPFECY_cjs.u}});Object.defineProperty(exports,"sync",{enumerable:true,get:function(){return chunkKWSPFECY_cjs.s}});Object.defineProperty(exports,"update",{enumerable:true,get:function(){return chunkKWSPFECY_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=F;exports.MemoryPluginEntry=F;exports.MemoryPluginHook=Le;exports.MemoryTool=L;exports.addWord=gr;exports.closeTokenizer=yr;exports.createMemoryHookMatchers=C;exports.initTokenizer=ur;exports.isInitialized=fr;exports.loadCustomDict=ft;exports.toFtsTokens=Mr;exports.toFtsTokensForSearch=xr;exports.tokenize=yt;exports.tokenizeForSearch=Mt;
|
package/dist/index.d.cts
CHANGED
|
@@ -2,7 +2,7 @@ import * as _easbot_types from '@easbot/types';
|
|
|
2
2
|
import { KnowledgeSearchOptions, MemoryKnowledgeConfigWithModels, KnowledgeDoctorResult, MemoryStatus, IGlobal, IInstance } from '@easbot/types';
|
|
3
3
|
export { GRAPH_ENTITY_TYPE_DEFINITIONS, GRAPH_RELATION_TYPE_DEFINITIONS } from '@easbot/types';
|
|
4
4
|
import { ILLMInitConfig, ILLMCapabilities, EmbeddingModelRef, LanguageModelRef, ExtractedEntity, ExtractedRelation } from '@easbot/llm';
|
|
5
|
-
import
|
|
5
|
+
import { z, ZodType } from 'zod';
|
|
6
6
|
import { StdioServerConfig } from '@easbot/mcp';
|
|
7
7
|
import { SyncSqliteConnection } from '@easbot/database';
|
|
8
8
|
import { Plugin, PluginManifest, HookMatcher, HookHandler, HookInfo } from '@easbot/plugin';
|
|
@@ -446,7 +446,7 @@ interface OpHandlerContext {
|
|
|
446
446
|
remote?: boolean;
|
|
447
447
|
config?: unknown;
|
|
448
448
|
}
|
|
449
|
-
interface MemoryOp<TSchema extends
|
|
449
|
+
interface MemoryOp<TSchema extends ZodType | undefined = undefined, TResult = unknown> {
|
|
450
450
|
name: string;
|
|
451
451
|
scope: OpScope;
|
|
452
452
|
schema?: TSchema;
|
|
@@ -638,12 +638,12 @@ 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.
|
|
641
|
+
declare const MEMORY_PLUGIN_VERSION = "0.3.39";
|
|
642
642
|
declare const MEMORY_PLUGIN_MANIFEST: PluginManifest;
|
|
643
643
|
|
|
644
644
|
declare function createMemoryHookMatchers(): HookMatcher[];
|
|
645
645
|
|
|
646
|
-
declare const MEMORY_HOOK_EVENTS: readonly ["context.
|
|
646
|
+
declare const MEMORY_HOOK_EVENTS: readonly ["context.collect", "session.compacting", "tool.failure", "loop.end"];
|
|
647
647
|
type MemoryHookEvent = (typeof MEMORY_HOOK_EVENTS)[number];
|
|
648
648
|
type MemoryHookHandler = HookHandler<unknown>;
|
|
649
649
|
|
|
@@ -657,19 +657,182 @@ declare const MemoryPluginHook: HookInfo;
|
|
|
657
657
|
|
|
658
658
|
declare const MEMORY_TOOL_ID = "memory";
|
|
659
659
|
declare const MEMORY_TOOL_OPS: readonly ["recall", "remember", "update", "forget", "extract", "graph_query", "status"];
|
|
660
|
+
type MemoryToolOperation = (typeof MEMORY_TOOL_OPS)[number];
|
|
661
|
+
declare const MEMORY_TOOL_ARGS: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
662
|
+
operation: z.ZodLiteral<"recall">;
|
|
663
|
+
query: z.ZodString;
|
|
664
|
+
limit: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>>;
|
|
665
|
+
category: z.ZodOptional<z.ZodEnum<{
|
|
666
|
+
user_preference: "user_preference";
|
|
667
|
+
task_context: "task_context";
|
|
668
|
+
technical_fact: "technical_fact";
|
|
669
|
+
decision: "decision";
|
|
670
|
+
relationship: "relationship";
|
|
671
|
+
reminder: "reminder";
|
|
672
|
+
error_pattern: "error_pattern";
|
|
673
|
+
workflow: "workflow";
|
|
674
|
+
exploration_finding: "exploration_finding";
|
|
675
|
+
experience_summary: "experience_summary";
|
|
676
|
+
tool_usage: "tool_usage";
|
|
677
|
+
skill_creation: "skill_creation";
|
|
678
|
+
test: "test";
|
|
679
|
+
other: "other";
|
|
680
|
+
}>>;
|
|
681
|
+
minImportance: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
|
|
682
|
+
maxEdgesPerNode: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>>;
|
|
683
|
+
includeGraph: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
684
|
+
includeShared: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
685
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
686
|
+
operation: z.ZodLiteral<"remember">;
|
|
687
|
+
content: z.ZodString;
|
|
688
|
+
category: z.ZodEnum<{
|
|
689
|
+
user_preference: "user_preference";
|
|
690
|
+
task_context: "task_context";
|
|
691
|
+
technical_fact: "technical_fact";
|
|
692
|
+
decision: "decision";
|
|
693
|
+
relationship: "relationship";
|
|
694
|
+
reminder: "reminder";
|
|
695
|
+
error_pattern: "error_pattern";
|
|
696
|
+
workflow: "workflow";
|
|
697
|
+
exploration_finding: "exploration_finding";
|
|
698
|
+
experience_summary: "experience_summary";
|
|
699
|
+
tool_usage: "tool_usage";
|
|
700
|
+
skill_creation: "skill_creation";
|
|
701
|
+
test: "test";
|
|
702
|
+
other: "other";
|
|
703
|
+
}>;
|
|
704
|
+
importance: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>;
|
|
705
|
+
tags: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodString>>>;
|
|
706
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
707
|
+
operation: z.ZodLiteral<"update">;
|
|
708
|
+
factId: z.ZodString;
|
|
709
|
+
content: z.ZodOptional<z.ZodString>;
|
|
710
|
+
category: z.ZodOptional<z.ZodEnum<{
|
|
711
|
+
user_preference: "user_preference";
|
|
712
|
+
task_context: "task_context";
|
|
713
|
+
technical_fact: "technical_fact";
|
|
714
|
+
decision: "decision";
|
|
715
|
+
relationship: "relationship";
|
|
716
|
+
reminder: "reminder";
|
|
717
|
+
error_pattern: "error_pattern";
|
|
718
|
+
workflow: "workflow";
|
|
719
|
+
exploration_finding: "exploration_finding";
|
|
720
|
+
experience_summary: "experience_summary";
|
|
721
|
+
tool_usage: "tool_usage";
|
|
722
|
+
skill_creation: "skill_creation";
|
|
723
|
+
test: "test";
|
|
724
|
+
other: "other";
|
|
725
|
+
}>>;
|
|
726
|
+
importance: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
|
|
727
|
+
tags: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodString>>>;
|
|
728
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
729
|
+
operation: z.ZodLiteral<"forget">;
|
|
730
|
+
factId: z.ZodString;
|
|
731
|
+
dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
732
|
+
force: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
733
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
734
|
+
operation: z.ZodLiteral<"extract">;
|
|
735
|
+
lastN: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>>;
|
|
736
|
+
fromMessageId: z.ZodOptional<z.ZodString>;
|
|
737
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
738
|
+
operation: z.ZodLiteral<"graph_query">;
|
|
739
|
+
query: z.ZodString;
|
|
740
|
+
maxDepth: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>>;
|
|
741
|
+
maxNodes: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>>;
|
|
742
|
+
maxEdgesPerNode: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>>;
|
|
743
|
+
relation: z.ZodOptional<z.ZodString>;
|
|
744
|
+
type: z.ZodOptional<z.ZodString>;
|
|
745
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
746
|
+
operation: z.ZodLiteral<"status">;
|
|
747
|
+
}, z.core.$strict>], "operation">;
|
|
660
748
|
declare const MemoryTool: _easbot_types.ToolDefinition & {
|
|
661
|
-
args: {
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
|
|
668
|
-
|
|
669
|
-
|
|
749
|
+
args: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
750
|
+
operation: z.ZodLiteral<"recall">;
|
|
751
|
+
query: z.ZodString;
|
|
752
|
+
limit: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>>;
|
|
753
|
+
category: z.ZodOptional<z.ZodEnum<{
|
|
754
|
+
user_preference: "user_preference";
|
|
755
|
+
task_context: "task_context";
|
|
756
|
+
technical_fact: "technical_fact";
|
|
757
|
+
decision: "decision";
|
|
758
|
+
relationship: "relationship";
|
|
759
|
+
reminder: "reminder";
|
|
760
|
+
error_pattern: "error_pattern";
|
|
761
|
+
workflow: "workflow";
|
|
762
|
+
exploration_finding: "exploration_finding";
|
|
763
|
+
experience_summary: "experience_summary";
|
|
764
|
+
tool_usage: "tool_usage";
|
|
765
|
+
skill_creation: "skill_creation";
|
|
766
|
+
test: "test";
|
|
767
|
+
other: "other";
|
|
768
|
+
}>>;
|
|
769
|
+
minImportance: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
|
|
770
|
+
maxEdgesPerNode: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>>;
|
|
771
|
+
includeGraph: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
772
|
+
includeShared: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
773
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
774
|
+
operation: z.ZodLiteral<"remember">;
|
|
775
|
+
content: z.ZodString;
|
|
776
|
+
category: z.ZodEnum<{
|
|
777
|
+
user_preference: "user_preference";
|
|
778
|
+
task_context: "task_context";
|
|
779
|
+
technical_fact: "technical_fact";
|
|
780
|
+
decision: "decision";
|
|
781
|
+
relationship: "relationship";
|
|
782
|
+
reminder: "reminder";
|
|
783
|
+
error_pattern: "error_pattern";
|
|
784
|
+
workflow: "workflow";
|
|
785
|
+
exploration_finding: "exploration_finding";
|
|
786
|
+
experience_summary: "experience_summary";
|
|
787
|
+
tool_usage: "tool_usage";
|
|
788
|
+
skill_creation: "skill_creation";
|
|
789
|
+
test: "test";
|
|
790
|
+
other: "other";
|
|
670
791
|
}>;
|
|
671
|
-
|
|
672
|
-
|
|
792
|
+
importance: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>;
|
|
793
|
+
tags: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodString>>>;
|
|
794
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
795
|
+
operation: z.ZodLiteral<"update">;
|
|
796
|
+
factId: z.ZodString;
|
|
797
|
+
content: z.ZodOptional<z.ZodString>;
|
|
798
|
+
category: z.ZodOptional<z.ZodEnum<{
|
|
799
|
+
user_preference: "user_preference";
|
|
800
|
+
task_context: "task_context";
|
|
801
|
+
technical_fact: "technical_fact";
|
|
802
|
+
decision: "decision";
|
|
803
|
+
relationship: "relationship";
|
|
804
|
+
reminder: "reminder";
|
|
805
|
+
error_pattern: "error_pattern";
|
|
806
|
+
workflow: "workflow";
|
|
807
|
+
exploration_finding: "exploration_finding";
|
|
808
|
+
experience_summary: "experience_summary";
|
|
809
|
+
tool_usage: "tool_usage";
|
|
810
|
+
skill_creation: "skill_creation";
|
|
811
|
+
test: "test";
|
|
812
|
+
other: "other";
|
|
813
|
+
}>>;
|
|
814
|
+
importance: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
|
|
815
|
+
tags: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodString>>>;
|
|
816
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
817
|
+
operation: z.ZodLiteral<"forget">;
|
|
818
|
+
factId: z.ZodString;
|
|
819
|
+
dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
820
|
+
force: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
821
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
822
|
+
operation: z.ZodLiteral<"extract">;
|
|
823
|
+
lastN: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>>;
|
|
824
|
+
fromMessageId: z.ZodOptional<z.ZodString>;
|
|
825
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
826
|
+
operation: z.ZodLiteral<"graph_query">;
|
|
827
|
+
query: z.ZodString;
|
|
828
|
+
maxDepth: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>>;
|
|
829
|
+
maxNodes: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>>;
|
|
830
|
+
maxEdgesPerNode: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>>;
|
|
831
|
+
relation: z.ZodOptional<z.ZodString>;
|
|
832
|
+
type: z.ZodOptional<z.ZodString>;
|
|
833
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
834
|
+
operation: z.ZodLiteral<"status">;
|
|
835
|
+
}, z.core.$strict>], "operation">;
|
|
673
836
|
};
|
|
674
837
|
|
|
675
|
-
export { ALL_OPS, type ArchiveRecord, type ArchiveResult, COMMANDS_HELP, type CommandHelp, type ConsolidateParams, type ConsolidateResult, DEFAULT_MEMORY_JSON, type DoctorResult, type EdgeQueryFilter, type ExtractParams, type ExtractResult, type ForgetParams, type ForgetResult, type GraphQueryParams, type GraphQueryResult, GraphStore, type InitParams, type InitResult, type KGScope, LATEST_SCHEMA_VERSION, Llm, type LlmInitConfig, type LlmModels, MEMORY_CATEGORIES, MEMORY_HOOK_BINDINGS, MEMORY_HOOK_EVENTS, MEMORY_JSON_REL_PATH, MEMORY_PLUGIN_ID, MEMORY_PLUGIN_MANIFEST, MEMORY_PLUGIN_VERSION, MEMORY_TOOL_ID, MEMORY_TOOL_OPS, MIGRATIONS, MemoryCache, type MemoryCategory, type MemoryCliDeps, type MemoryCliResult, MemoryDatabaseManager, type MemoryEdge, type MemoryFact, type MemoryJson, MemoryJsonSchema, type MemoryNode, type MemoryNodeWithEdges, type MemoryOp, MemoryPlugin, MemoryPlugin as MemoryPluginEntry, MemoryPluginHook, type MemoryQuery, type MemoryRecallResult, type MemorySource, MemoryStdioServer, type MemorySystemConfig, MemoryTool, type MemoryVector, type NodeQueryFilter, OP_REGISTRY, type OpAnnotations, type OpHandlerContext, type OpScope, type RecallParams, type RecallResult, type RememberParams, type RememberResult, type StatusResult, type SyncParams, type SyncResult, type UpdateParams, type UpdateResult, addWord, closeTokenizer, consolidate, createMemoryHookMatchers, doctor, executeOp, extract, forget, getGlobal, getHomeDir, getInstance, getMemoryDbPath, getMemoryDir, getXdgData, graphQuery, handleMemoryCli, init, initTokenizer, isInitialized, loadCustomDict, readCurrentSchemaVersion, recall, remember, renderBanner, renderHelp, renderOperationMarkdown, resetGlobalAdapter, resetInstanceAdapter, runMigrations, setGlobalAdapter, setInstanceAdapter, status, sync, toFtsTokens, toFtsTokensForSearch, tokenize, tokenizeForSearch, update };
|
|
838
|
+
export { ALL_OPS, type ArchiveRecord, type ArchiveResult, COMMANDS_HELP, type CommandHelp, type ConsolidateParams, type ConsolidateResult, DEFAULT_MEMORY_JSON, type DoctorResult, type EdgeQueryFilter, type ExtractParams, type ExtractResult, type ForgetParams, type ForgetResult, type GraphQueryParams, type GraphQueryResult, GraphStore, type InitParams, type InitResult, type KGScope, LATEST_SCHEMA_VERSION, Llm, type LlmInitConfig, type LlmModels, MEMORY_CATEGORIES, MEMORY_HOOK_BINDINGS, MEMORY_HOOK_EVENTS, MEMORY_JSON_REL_PATH, MEMORY_PLUGIN_ID, MEMORY_PLUGIN_MANIFEST, MEMORY_PLUGIN_VERSION, MEMORY_TOOL_ARGS, MEMORY_TOOL_ID, MEMORY_TOOL_OPS, MIGRATIONS, MemoryCache, type MemoryCategory, type MemoryCliDeps, type MemoryCliResult, MemoryDatabaseManager, type MemoryEdge, type MemoryFact, type MemoryJson, MemoryJsonSchema, type MemoryNode, type MemoryNodeWithEdges, type MemoryOp, MemoryPlugin, MemoryPlugin as MemoryPluginEntry, MemoryPluginHook, type MemoryQuery, type MemoryRecallResult, type MemorySource, MemoryStdioServer, type MemorySystemConfig, MemoryTool, type MemoryToolOperation, type MemoryVector, type NodeQueryFilter, OP_REGISTRY, type OpAnnotations, type OpHandlerContext, type OpScope, type RecallParams, type RecallResult, type RememberParams, type RememberResult, type StatusResult, type SyncParams, type SyncResult, type UpdateParams, type UpdateResult, addWord, closeTokenizer, consolidate, createMemoryHookMatchers, doctor, executeOp, extract, forget, getGlobal, getHomeDir, getInstance, getMemoryDbPath, getMemoryDir, getXdgData, graphQuery, handleMemoryCli, init, initTokenizer, isInitialized, loadCustomDict, readCurrentSchemaVersion, recall, remember, renderBanner, renderHelp, renderOperationMarkdown, resetGlobalAdapter, resetInstanceAdapter, runMigrations, setGlobalAdapter, setInstanceAdapter, status, sync, toFtsTokens, toFtsTokensForSearch, tokenize, tokenizeForSearch, update };
|