@easbot/memory 0.3.28 → 0.3.32
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 +1 -1
- package/README.md +21 -1
- package/dist/chunks/cache-IGJVAUPS.cjs +1 -0
- package/dist/chunks/cache-U5YYUDWO.mjs +1 -0
- package/dist/chunks/chunk-6H5PTRZL.cjs +1 -0
- package/dist/chunks/chunk-7C2J2PDC.cjs +77 -0
- package/dist/chunks/chunk-AEAMQDNV.mjs +67 -0
- package/dist/chunks/chunk-AJDMZTCQ.mjs +1 -0
- package/dist/chunks/chunk-AVECFV5K.cjs +1 -0
- package/dist/chunks/{chunk-P45OBSAC.cjs → chunk-DYD3SEPC.cjs} +19 -19
- package/dist/chunks/chunk-EKSLNNMF.cjs +1 -0
- package/dist/chunks/{chunk-I5YSX4DQ.mjs → chunk-FZ3RTYIJ.mjs} +19 -19
- package/dist/chunks/chunk-GCVKM3RJ.cjs +1 -0
- package/dist/chunks/chunk-HH7EA2UE.mjs +1 -0
- package/dist/chunks/chunk-HX3TV7FD.mjs +1 -0
- package/dist/chunks/chunk-KFESJR3T.cjs +1 -0
- package/dist/chunks/chunk-NHRRIJFK.cjs +1 -0
- package/dist/chunks/chunk-S4DPVKMV.mjs +1 -0
- package/dist/chunks/chunk-SE3F5YQE.mjs +1 -0
- package/dist/chunks/chunk-YAF6HMAE.cjs +67 -0
- package/dist/chunks/chunk-YJLHS7JB.mjs +77 -0
- package/dist/chunks/chunk-YUWHNHAY.mjs +1 -0
- package/dist/chunks/cli-handler-IXFJAQFB.cjs +1 -0
- package/dist/chunks/cli-handler-JHSDGJHK.mjs +1 -0
- package/dist/chunks/{config-2SQJYVTO.mjs → config-5P7O45FH.mjs} +1 -1
- package/dist/chunks/{config-I2I6U4XM.cjs → config-KFPQDFJR.cjs} +1 -1
- package/dist/chunks/consolidate-KZAYROKJ.cjs +2 -0
- package/dist/chunks/consolidate-OOAMW7XW.mjs +2 -0
- package/dist/chunks/doctor-OAWL5FMH.cjs +1 -0
- package/dist/chunks/doctor-ZGHICE2Q.mjs +1 -0
- package/dist/chunks/extract-AJY2ETKE.mjs +2 -0
- package/dist/chunks/extract-BS6HOLXU.cjs +2 -0
- package/dist/chunks/forget-NIBBY6FG.mjs +3 -0
- package/dist/chunks/forget-Q6UN6GSW.cjs +3 -0
- package/dist/chunks/graph-4K56ZAVL.mjs +3 -0
- package/dist/chunks/graph-4KBXGMOL.cjs +3 -0
- package/dist/chunks/init-EBA3ZGC6.cjs +1 -0
- package/dist/chunks/init-HWR4SD6N.mjs +1 -0
- package/dist/chunks/{interfaces-LPJU4KS3.mjs → interfaces-OFM2XGSG.mjs} +1 -1
- package/dist/chunks/interfaces-TGSOKRFI.cjs +1 -0
- package/dist/chunks/llm-BRSMYENV.mjs +1 -0
- package/dist/chunks/llm-TQXCNG4J.cjs +1 -0
- package/dist/chunks/mcp-PH3CLOYP.cjs +1 -0
- package/dist/chunks/mcp-ZWZYH52C.mjs +1 -0
- package/dist/chunks/{recall-UQSG6ECA.mjs → recall-BRXHJPR4.mjs} +2 -2
- package/dist/chunks/recall-SBUTMJPU.cjs +2 -0
- package/dist/chunks/remember-3XSYCWKK.mjs +2 -0
- package/dist/chunks/remember-FXMXYHLK.cjs +2 -0
- package/dist/chunks/status-H4UKSZAH.cjs +1 -0
- package/dist/chunks/status-SW5BUHJ3.mjs +1 -0
- package/dist/chunks/stdio-server-3A3H4YJ7.mjs +1 -0
- package/dist/chunks/stdio-server-CWA2HGXA.cjs +1 -0
- package/dist/chunks/sync-EE4ZD3WB.mjs +2 -0
- package/dist/chunks/sync-FTZT6MWJ.cjs +2 -0
- package/dist/cli.cjs +1 -1
- package/dist/cli.mjs +1 -1
- package/dist/index.cjs +1 -6
- package/dist/index.d.cts +50 -78
- package/dist/index.d.ts +50 -78
- package/dist/index.mjs +1 -6
- package/package.json +9 -10
- package/dist/chunks/chunk-4YADRVIU.mjs +0 -1
- package/dist/chunks/chunk-6CQMBEIQ.mjs +0 -1
- package/dist/chunks/chunk-CPRDIUQ4.cjs +0 -1
- package/dist/chunks/chunk-DW3CJUBO.cjs +0 -1
- package/dist/chunks/chunk-FY4ILCIM.mjs +0 -77
- package/dist/chunks/chunk-HQBRVVXS.mjs +0 -1
- package/dist/chunks/chunk-HY2LFKG7.cjs +0 -67
- package/dist/chunks/chunk-J5XF2W4Z.cjs +0 -1
- package/dist/chunks/chunk-LYBUZDJK.cjs +0 -77
- package/dist/chunks/chunk-M2YU5LAI.cjs +0 -1
- package/dist/chunks/chunk-WDVDYZ25.mjs +0 -1
- package/dist/chunks/chunk-X7P7ZFZF.mjs +0 -67
- package/dist/chunks/cli-handler-ETHJPZPG.mjs +0 -1
- package/dist/chunks/cli-handler-PG4IBTY2.cjs +0 -1
- package/dist/chunks/consolidate-7GFUFPLX.cjs +0 -2
- package/dist/chunks/consolidate-BGMXJUQX.mjs +0 -2
- package/dist/chunks/doctor-C2FWFUDO.mjs +0 -1
- package/dist/chunks/doctor-SCXUJRSG.cjs +0 -1
- package/dist/chunks/extract-O4IOL6BZ.cjs +0 -2
- package/dist/chunks/extract-RBBSVK2S.mjs +0 -2
- package/dist/chunks/forget-JTACRG7Y.mjs +0 -3
- package/dist/chunks/forget-M4I6GVWI.cjs +0 -3
- package/dist/chunks/graph-AOMDJ6YA.cjs +0 -3
- package/dist/chunks/graph-VBVVRV6V.mjs +0 -3
- package/dist/chunks/init-2SBK7ZWO.mjs +0 -1
- package/dist/chunks/init-VTPJR56L.cjs +0 -1
- package/dist/chunks/interfaces-Q5OGU5EK.cjs +0 -1
- package/dist/chunks/llm-7LQGYSUE.cjs +0 -1
- package/dist/chunks/llm-UHTBU2HA.mjs +0 -1
- package/dist/chunks/mcp-VIOHPDO5.cjs +0 -1
- package/dist/chunks/mcp-ZQCLVZIR.mjs +0 -1
- package/dist/chunks/recall-JSTQDGGZ.cjs +0 -2
- package/dist/chunks/remember-GVQJ5G7Z.mjs +0 -2
- package/dist/chunks/remember-Z4UJJN62.cjs +0 -2
- package/dist/chunks/status-DH33MQZV.cjs +0 -1
- package/dist/chunks/status-VZ5EBAOY.mjs +0 -1
- package/dist/chunks/stdio-server-JC53PUET.mjs +0 -1
- package/dist/chunks/stdio-server-OUZAN4IM.cjs +0 -1
- package/dist/chunks/sync-6I2ZJUH6.cjs +0 -2
- package/dist/chunks/sync-UT4D32ML.mjs +0 -2
package/README.en.md
CHANGED
|
@@ -6,7 +6,7 @@ Long-term memory library for the EASBOT ecosystem, providing per-agent fact stor
|
|
|
6
6
|
|
|
7
7
|
## Version
|
|
8
8
|
|
|
9
|
-
v0.3.
|
|
9
|
+
v0.3.32
|
|
10
10
|
## Features (v0.4.0)
|
|
11
11
|
|
|
12
12
|
- **9 op unified entry** — `recall / remember / forget / extract / consolidate / graph_query / status / doctor / init`; MCP / CLI / Agent Tool share the same `executeOp(name, args, ctx)`.
|
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@ EASBOT 生态系统的长期记忆管理库(v0.4.0)。提供分层记忆、K
|
|
|
6
6
|
|
|
7
7
|
## 版本
|
|
8
8
|
|
|
9
|
-
v0.3.
|
|
9
|
+
v0.3.32
|
|
10
10
|
## 特性(v0.4.0)
|
|
11
11
|
|
|
12
12
|
- **10 op 统一入口**(ADR 0069 +1 sync):`recall / remember / forget / extract / consolidate / sync / graph_query / status / doctor / init`,MCP / CLI / Agent Tool 三端共享。
|
|
@@ -160,6 +160,26 @@ const md = await renderOperationMarkdown('recall', recallResult, { toolName: 'me
|
|
|
160
160
|
- `status` 不传 agentId → 跨 agent 聚合统计(不再是单一 agent 视图)
|
|
161
161
|
- `doctor` / `init` 不传 agentId → 全局默认 agent = `'default'`,与 status / graph_query 口径一致
|
|
162
162
|
|
|
163
|
+
### `recall` 的 `snippet` 裁剪(2026-10-13)
|
|
164
|
+
|
|
165
|
+
`snippet` 是给预览用的**裁剪副本**,完整正文见 `hit.content`(决策 0086 v2)。历史上 `SUBSTR(mf.content, 1, 200)` 把长度写死在 SQL 字面量里;现统一到 `@easbot/database` 的真值源,并**收回为内部参数**:
|
|
166
|
+
|
|
167
|
+
| 层 | 归属 | 默认值 | 语义 |
|
|
168
|
+
| --------------- | -------------------------------------- | ------------------------------- | -------------------------------------------------------- |
|
|
169
|
+
| service 层 | 内部(`RecallParams.snippetMaxChars`) | `2000`(=`SQL_TEXT_LIMIT_MAX`) | **防御上限** —— 防单条 fact 撑爆结果集 |
|
|
170
|
+
| op schema | **不暴露** | — | LLM 不该决定服务端裁剪多长,`.strict()` 会直接拒掉该字段 |
|
|
171
|
+
| format / 渲染层 | 各 renderer 自行 `slice` | 场景决定 | **展示决策** —— 终端 / CLI 预览通常远小于上限 |
|
|
172
|
+
|
|
173
|
+
```typescript
|
|
174
|
+
// 服务内部 / 程序化调用可以传(仍会被 clamp)
|
|
175
|
+
await recall(ctx, { query: '...', maxResults: 10, snippetMaxChars: 800 });
|
|
176
|
+
|
|
177
|
+
// LLM / MCP / agent tool 传入则直接报错(schema 外字段)
|
|
178
|
+
await executeOp('recall', { query: '...', snippetMaxChars: 800 }, ctx); // ❌ throws
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
**约束**:无论传什么都会过 `resolveSqlTextLimit` 收敛到 `[1, SQL_TEXT_LIMIT_MAX]` —— **无法绕过防御**。默认值从硬编码 200 提升到 2000:200 字符在中文语境仅 ≈ 133 token,信息量不足以支撑摘要(摘要链路见 `@easbot/llm` 的 `SummaryProvider`)。
|
|
182
|
+
|
|
163
183
|
## API 分类
|
|
164
184
|
|
|
165
185
|
### services(9 op 业务层)
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
'use strict';var chunkNHRRIJFK_cjs=require('./chunk-NHRRIJFK.cjs');require('./chunk-GCVKM3RJ.cjs'),require('./chunk-KFESJR3T.cjs');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}});
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export{c as MEMORY_JSON_REL_PATH,d as MemoryCache}from'./chunk-SE3F5YQE.mjs';import'./chunk-HX3TV7FD.mjs';import'./chunk-S4DPVKMV.mjs';
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
'use strict';var chunkGCVKM3RJ_cjs=require('./chunk-GCVKM3RJ.cjs'),utils=require('@easbot/utils'),terminal=require('@easbot/terminal');var w=utils.Log.create({service:"memory.cli"}),v=[{i18nKey:"cli.cmd.init.description",name:"init",description:"Initialize memory workspace (.easbot/memory.db)",group:"lifecycle"},{i18nKey:"cli.cmd.status.description",name:"status",description:"Show memory state / db stats / facts by category",group:"lifecycle"},{i18nKey:"cli.cmd.doctor.description",name:"doctor",description:"Run health checks (backend, FTS, schema, lock)",group:"lifecycle"},{i18nKey:"cli.cmd.recall.description",name:"recall",description:"Hybrid search (FTS + vector) over memory facts",group:"memory"},{i18nKey:"cli.cmd.remember.description",name:"remember",description:"Persist a new memory fact (with dedup + KG extraction)",group:"memory"},{i18nKey:"cli.cmd.forget.description",name:"forget",description:"Delete memory facts (factId / category / timeRange / dryRun)",group:"memory"},{i18nKey:"cli.cmd.sync.description",name:"sync",description:"Sync facts to .md files (idempotent) and archive expired active files (default 30 days)",group:"memory"},{i18nKey:"cli.cmd.extract.description",name:"extract",description:"Extract facts from a session (sessionId + lastN)",group:"session"},{i18nKey:"cli.cmd.consolidate.description",name:"consolidate",description:"Run consolidation pipeline (extract \u2192 dedup \u2192 archive)",group:"session"},{i18nKey:"cli.cmd.graph.description",name:"graph",description:"KG query (nodes / edges / neighbors with scope \u4E09\u6863)",group:"graph"},{i18nKey:"cli.cmd.config.description",name:"config",description:"Show / validate memory configuration (dry-read)",group:"external"},{i18nKey:"cli.cmd.mcp.description",name:"mcp",description:"Start stdio MCP server (exposes 10 memory tools)",group:"external"}];function g(l,t){let e=v.filter(s=>s.group===l);return terminal.renderLines({title:t,flat:e.map(s=>`$ easbot-memory ${s.name.padEnd(14)} ${s.description}`)})}function j(){let l=[terminal.renderLines({title:"easbot-memory \xB7 Memory & Knowledge Module for EASBot",flat:["Usage: easbot-memory <command> [options]"]}),"",g("lifecycle","Commands (lifecycle):"),"",g("memory","Commands (memory):"),"",g("session","Commands (session):"),"",g("graph","Commands (graph query):"),"",g("external","External:")];terminal.printHuman(l);}function C(){j(),terminal.printHuman(["",terminal.renderLines({title:"Global flags & invocation",flat:["--cwd <dir> --config <path> --log-level <L> --print-logs --debug","Standalone CLI: easbot-memory <command>","Agent CLI: easbot memory <command>"]})]);}async function M(){try{let{Llm:l}=await import('./llm-TQXCNG4J.cjs'),{MemoryCache:t}=await import('./cache-IGJVAUPS.cjs'),e=await t.getMemoryJson();l.init({models:{embedding:e?.embedding_model??void 0,graph:e?.graph_model??void 0}});}catch(l){w.warn("Llm init failed; Llm-related features will be disabled",{error:utils.errorMeta(l)});}}async function P(l,t){let [e,...s]=l;t?.cwd??process.cwd();let c=t?.agentId??"default";if(!e)return C(),{code:0,handled:true,command:null};await M();let m=s.includes("--json");try{switch(e){case "init":{let{parseInitOptions:i,runInit:a}=await import('./init-EBA3ZGC6.cjs'),n=i(s);if(n.help)return console.log("Usage: easbot-memory init [--force] [--json]"),{code:0,handled:!0,command:e};let o=await a({...n,agentId:c});if(n.json)terminal.emitJsonOk(o,{command:e});else {let r=o;terminal.printHuman([terminal.formatKnowledgeInit({packageName:"memory",configPath:r.configPath??r.dbPath,backend:"better-sqlite3",schemaVersion:r.schemaVersion,extras:{dbPath:r.dbPath,migrationsApplied:r.migrationsApplied,tablesCreated:r.tablesCreated,durationMs:`${r.durationMs}ms`}})],{title:"init memory workspace",boxed:!0});}return {code:0,handled:!0,command:e}}case "recall":{let{parseRecallOptions:i,runRecall:a,formatRecallText:n}=await import('./recall-SBUTMJPU.cjs'),o=i(s);if(o.help)return console.log("Usage: easbot-memory recall --query <q> [--limit <n>] [--category <c>] [--min-importance <n>] [--json]"),{code:0,handled:!0,command:e};let r=await a({...o,agentId:c});return o.json?terminal.emitJsonOk(r,{command:e}):terminal.printHuman([n(r)],{title:`recall (agentId=${c??"default"})`}),{code:0,handled:!0,command:e}}case "remember":{let{parseRememberOptions:i,runRemember:a,formatRememberText:n}=await import('./remember-FXMXYHLK.cjs'),o=i(s);if(o.help)return console.log("Usage: easbot-memory remember --content <text> --category <c> --importance <1-10> [--tag <t>] [--session <s>] [--json]"),{code:0,handled:!0,command:e};let r=await a({...o,agentId:c});return o.json?terminal.emitJsonOk(r,{command:e}):terminal.printHuman([n(r)],{title:"remember (persist fact)"}),{code:0,handled:!0,command:e}}case "forget":{let{parseForgetOptions:i,runForget:a,formatForgetText:n}=await import('./forget-Q6UN6GSW.cjs'),o=i(s);if(o.help)return console.log("Usage: easbot-memory forget (--fact-id <id> | --category <c> | --from <ISO> --to <ISO>) [--max-delete <n>] [--dry-run] [--json]"),{code:0,handled:!0,command:e};let r=await a({...o,agentId:c});return o.json?terminal.emitJsonOk(r,{command:e}):terminal.printHuman([n(r)],{title:"forget (delete facts)"}),{code:0,handled:!0,command:e}}case "extract":{let{parseExtractOptions:i,runExtract:a,formatExtractText:n}=await import('./extract-BS6HOLXU.cjs'),o=i(s);if(o.help)return console.log("Usage: easbot-memory extract --session <sessionId> [--last-n <n>] [--from-msg <id>] [--json]"),{code:0,handled:!0,command:e};let r=await a({...o,agentId:c});return o.json?terminal.emitJsonOk(r,{command:e}):terminal.printHuman([n(r)],{title:"extract (from session)"}),{code:0,handled:!0,command:e}}case "consolidate":{let{parseConsolidateOptions:i,runConsolidate:a,formatConsolidateText:n}=await import('./consolidate-KZAYROKJ.cjs'),o=i(s);if(o.help)return console.log("Usage: easbot-memory consolidate [--window-days <n>] [--json]"),{code:0,handled:!0,command:e};let r=await a({...o,agentId:c});return o.json?terminal.emitJsonOk(r,{command:e}):terminal.printHuman([n(r)],{title:"consolidate (pipeline)"}),{code:0,handled:!0,command:e}}case "sync":{let{parseSyncOptions:i,runSync:a,formatSyncText:n}=await import('./sync-FTZT6MWJ.cjs'),o=i(s);if(o.help)return console.log("Usage: easbot-memory sync [--window-days <n>] [--dry-run] [--json]"),console.log("Two-stage pipeline: (A) db \u2192 .md (idempotent skip on existing), (B) archive active/ files older than windowDays."),{code:0,handled:!0,command:e};let r=await a({...o,agentId:c});return o.json?terminal.emitJsonOk(r,{command:e}):terminal.printHuman([n(r)],{title:"sync (db \u2192 .md + archive)"}),{code:0,handled:!0,command:e}}case "graph":{let{parseGraphOptions:i,runGraph:a,formatGraphText:n}=await import('./graph-4KBXGMOL.cjs'),o=i(s);if(o.help)return console.log("Usage: easbot-memory graph [--query <q>] [--node-id <id>] [--max-depth <n>] [--max-nodes <n>] [--max-edges-per-node <n>] [--json]\n (note: `--depth` is an alias for `--max-depth`; old `--kind` / `--start-node` / `--scope` flags removed since service schema is strict)"),{code:0,handled:!0,command:e};let r=await a({...o,agentId:c});return o.json?terminal.emitJsonOk(r,{command:e}):terminal.printHuman([n(r)],{title:"graph_query"}),{code:0,handled:!0,command:e}}case "status":{let{parseStatusOptions:i,runStatus:a}=await import('./status-H4UKSZAH.cjs'),n=i(s);if(n.help)return console.log("Usage: easbot-memory status [--json]"),{code:0,handled:!0,command:e};let o=await a({...n,agentId:c});return n.json?terminal.emitJsonOk(o,{command:e}):terminal.printHuman([terminal.formatKnowledgeStatus(K(o))],{title:"memory status",boxed:!0}),{code:0,handled:!0,command:e}}case "doctor":{let{parseDoctorOptions:i,runDoctor:a}=await import('./doctor-OAWL5FMH.cjs'),n=i(s);if(n.help)return console.log("Usage: easbot-memory doctor [--repair] [--json]"),{code:0,handled:!0,command:e};let o=await a({...n});return n.json?terminal.emitJsonOk(o,{command:e}):terminal.printHuman([terminal.formatKnowledgeDoctor(R(o))],{title:"memory doctor",boxed:!0}),{code:0,handled:!0,command:e}}case "config":{let{parseConfigOptions:i,runConfig:a,formatConfigText:n}=await import('./config-KFPQDFJR.cjs'),o=i(s);if(o.help)return console.log("Usage: easbot-memory config [--json]"),{code:0,handled:!0,command:e};let r=a(o);return o.json?terminal.emitJsonOk(r,{command:e}):terminal.printHuman([n(r)],{title:"memory config"}),{code:0,handled:!0,command:e}}case "mcp":{let{parseMcpOptions:i,runMcp:a}=await import('./mcp-PH3CLOYP.cjs'),n=i(s);if(n.help)return console.log("Usage: easbot-memory mcp [start]"),console.log("Start a stdio MCP server exposing 10 memory tools:"),console.log(" recall / remember / forget / extract / consolidate"),console.log(" graph_query / status / doctor / init / sync"),{code:0,handled:!0,command:e};let o=await a(n);return n.json?terminal.emitJsonOk(o,{command:e}):terminal.printHuman([`memory mcp started (tools: ${o.tools.length})`],{title:"memory mcp server"}),{code:0,handled:!0,command:e}}default:return m?terminal.emitJsonError(e??"__unknown__",`Unknown command: ${e}`):(console.error(`Unknown command: ${e}`),console.error("Run `easbot-memory --help` for available commands.")),{code:2,handled:!1,command:null}}}catch(i){let a=utils.errorMeta(i);w.error("memory CLI command failed",{command:e,error:a});let n=t?.cwd??chunkGCVKM3RJ_cjs.f().worktree;return m?terminal.emitJsonError(e??"__unknown__",a.message):console.error(`[memory] ${n} :: ${e} failed: ${a.message}`),{code:1,handled:true,command:e}}}function K(l){let t=l;return {packageName:"memory",rootDir:t.workspaceDir??"",configPath:t.configPath??"",configExists:typeof t.configExists=="boolean"?t.configExists:true,dbPath:t.dbPath??"",dbExists:typeof t.dbExists=="boolean"?t.dbExists:true,dbSize:typeof t.dbSize=="number"?t.dbSize:void 0,indexState:t.indexState,schemaVersion:typeof t.schemaVersion=="number"?t.schemaVersion:void 0,extractionVersion:typeof t.extractionVersion=="number"?t.extractionVersion:void 0,lastSyncAt:t.lastSyncAt,vectorEnabled:typeof t.vectorEnabled=="boolean"?t.vectorEnabled:void 0,embeddingDims:typeof t.embeddingDims=="number"?t.embeddingDims:void 0,llm:t.llm??{initialized:false,capabilities:{}},backend:t.backend,healthy:typeof t.healthy=="boolean"?t.healthy:true,recommendation:t.recommendation,dbStats:(()=>{let e=t.dbStats;if(e&&typeof e=="object"&&Object.keys(e).length>0)return {...e};let s=t.integrityStats;if(s&&typeof s=="object"&&Object.keys(s).length>0)return {...s}})(),extras:(()=>{let e={};if(typeof t.agentId=="string"&&(e.agent_id=t.agentId),typeof t.ftsAvailable=="boolean"&&(e.fts_available=t.ftsAvailable?"yes":"no"),t.factsByCategory&&typeof t.factsByCategory=="object"){let s=t.factsByCategory;for(let[u,c]of Object.entries(s))typeof c=="number"&&c>0&&(e[`facts/${u}`]=c);}if(t.meta&&typeof t.meta=="object")for(let[s,u]of Object.entries(t.meta))e[`meta/${s}`]=u===void 0?"\u2205":u;return Object.keys(e).length>0?e:void 0})()}}function R(l){let t=l,e=Array.isArray(t.checks)?t.checks:[],s=t.integrityStats,u=t.backendAvailable,c=s?{...s}:void 0;return {packageName:"memory",healthy:typeof t.healthy=="boolean"?t.healthy:false,durationMs:typeof t.durationMs=="number"?t.durationMs:0,checks:e.map(m=>({code:typeof m.code=="string"?m.code:"",severity:m.severity??"info",name:typeof m.name=="string"?m.name:"",message:typeof m.message=="string"?m.message:"",durationMs:typeof m.durationMs=="number"?m.durationMs:void 0,details:m.details})),dbStats:c,backendAvailable:u}}exports.a=v;exports.b=j;exports.c=C;exports.d=P;exports.e=R;
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
'use strict';var chunkAVECFV5K_cjs=require('./chunk-AVECFV5K.cjs'),chunkKFESJR3T_cjs=require('./chunk-KFESJR3T.cjs'),utils=require('@easbot/utils'),database=require('@easbot/database');var l=utils.Log.create({service:"memory.database.migrations"}),g=1,O=[{id:1,description:"v1 baseline: memory_facts / memory_vectors / embedding_cache / memory_facts_fts / nodes / edges / meta\uFF08\u4E0E v0.3.x createTables \u8F93\u51FA\u5BF9\u9F50\uFF0C\u8001 db \u8DD1\u8BE5\u8FC1\u79FB\u4E0D\u7834\u574F\u73B0\u6709\u8868\uFF09",up:[`CREATE TABLE IF NOT EXISTS memory_facts (
|
|
2
|
+
id TEXT PRIMARY KEY,
|
|
3
|
+
agent_id TEXT NOT NULL,
|
|
4
|
+
session_id TEXT,
|
|
5
|
+
msg_id TEXT,
|
|
6
|
+
parent_msg_id TEXT,
|
|
7
|
+
content TEXT NOT NULL,
|
|
8
|
+
category TEXT NOT NULL,
|
|
9
|
+
importance INTEGER NOT NULL CHECK(importance >= 1 AND importance <= 10),
|
|
10
|
+
source TEXT NOT NULL CHECK(source IN ('session_self_write', 'historical')),
|
|
11
|
+
tags TEXT,
|
|
12
|
+
file_path TEXT,
|
|
13
|
+
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
|
14
|
+
updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
|
|
15
|
+
)`,"CREATE INDEX IF NOT EXISTS idx_memory_facts_agent_id ON memory_facts(agent_id)","CREATE INDEX IF NOT EXISTS idx_memory_facts_agent_category ON memory_facts(agent_id, category)","CREATE INDEX IF NOT EXISTS idx_memory_facts_agent_importance ON memory_facts(agent_id, importance DESC)","CREATE INDEX IF NOT EXISTS idx_memory_facts_created_at ON memory_facts(created_at)",`CREATE UNIQUE INDEX IF NOT EXISTS idx_memory_facts_session_msg_partial
|
|
16
|
+
ON memory_facts(session_id, msg_id)
|
|
17
|
+
WHERE msg_id IS NOT NULL`,`CREATE TABLE IF NOT EXISTS memory_vectors (
|
|
18
|
+
fact_id TEXT PRIMARY KEY,
|
|
19
|
+
embedding BLOB NOT NULL,
|
|
20
|
+
FOREIGN KEY (fact_id) REFERENCES memory_facts(id) ON DELETE CASCADE
|
|
21
|
+
)`,`CREATE TABLE IF NOT EXISTS embedding_cache (
|
|
22
|
+
content_hash TEXT PRIMARY KEY,
|
|
23
|
+
embedding BLOB NOT NULL,
|
|
24
|
+
created_at DATETIME DEFAULT CURRENT_TIMESTAMP
|
|
25
|
+
)`,`CREATE VIRTUAL TABLE IF NOT EXISTS memory_facts_fts USING fts5(
|
|
26
|
+
fact_id UNINDEXED,
|
|
27
|
+
agent_id UNINDEXED,
|
|
28
|
+
content,
|
|
29
|
+
tags,
|
|
30
|
+
tokenize='porter unicode61'
|
|
31
|
+
)`,`CREATE TABLE IF NOT EXISTS nodes (
|
|
32
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
33
|
+
name TEXT NOT NULL,
|
|
34
|
+
type TEXT NOT NULL,
|
|
35
|
+
properties TEXT,
|
|
36
|
+
embedding BLOB,
|
|
37
|
+
createdAt DATETIME DEFAULT CURRENT_TIMESTAMP,
|
|
38
|
+
updatedAt DATETIME DEFAULT CURRENT_TIMESTAMP
|
|
39
|
+
)`,"CREATE INDEX IF NOT EXISTS idx_nodes_name ON nodes(name)","CREATE INDEX IF NOT EXISTS idx_nodes_type ON nodes(type)","CREATE INDEX IF NOT EXISTS idx_nodes_embedding ON nodes(embedding) WHERE embedding IS NOT NULL","CREATE UNIQUE INDEX IF NOT EXISTS idx_nodes_name_type ON nodes(name, type)",`CREATE TABLE IF NOT EXISTS fact_nodes (
|
|
40
|
+
fact_id TEXT NOT NULL,
|
|
41
|
+
node_id INTEGER NOT NULL,
|
|
42
|
+
source TEXT NOT NULL DEFAULT 'kg_extract',
|
|
43
|
+
score REAL NOT NULL DEFAULT 1.0,
|
|
44
|
+
createdAt DATETIME DEFAULT CURRENT_TIMESTAMP,
|
|
45
|
+
PRIMARY KEY (fact_id, node_id, source),
|
|
46
|
+
FOREIGN KEY (fact_id) REFERENCES memory_facts(id) ON DELETE CASCADE,
|
|
47
|
+
FOREIGN KEY (node_id) REFERENCES nodes(id) ON DELETE CASCADE
|
|
48
|
+
)`,"CREATE INDEX IF NOT EXISTS idx_fact_nodes_node ON fact_nodes(node_id)","CREATE INDEX IF NOT EXISTS idx_fact_nodes_fact ON fact_nodes(fact_id)","CREATE INDEX IF NOT EXISTS idx_fact_nodes_source ON fact_nodes(source)",`CREATE TABLE IF NOT EXISTS edges (
|
|
49
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
50
|
+
source INTEGER NOT NULL,
|
|
51
|
+
target INTEGER NOT NULL,
|
|
52
|
+
relation TEXT NOT NULL,
|
|
53
|
+
properties TEXT,
|
|
54
|
+
createdAt DATETIME DEFAULT CURRENT_TIMESTAMP,
|
|
55
|
+
FOREIGN KEY (source) REFERENCES nodes(id) ON DELETE CASCADE,
|
|
56
|
+
FOREIGN KEY (target) REFERENCES nodes(id) ON DELETE CASCADE
|
|
57
|
+
)`,"CREATE INDEX IF NOT EXISTS idx_edges_source ON edges(source)","CREATE INDEX IF NOT EXISTS idx_edges_target ON edges(target)","CREATE INDEX IF NOT EXISTS idx_edges_relation ON edges(relation)","CREATE UNIQUE INDEX IF NOT EXISTS idx_edges_unique ON edges(source, target, relation)",`CREATE TABLE IF NOT EXISTS meta (
|
|
58
|
+
key TEXT PRIMARY KEY,
|
|
59
|
+
value TEXT
|
|
60
|
+
)`,"ALTER TABLE nodes ADD COLUMN embedding BLOB","CREATE INDEX IF NOT EXISTS idx_nodes_embedding ON nodes(embedding) WHERE embedding IS NOT NULL"]}];function p(s,e=g,i={}){s.exec(`CREATE TABLE IF NOT EXISTS schema_migrations (
|
|
61
|
+
id INTEGER PRIMARY KEY,
|
|
62
|
+
applied_at DATETIME DEFAULT CURRENT_TIMESTAMP
|
|
63
|
+
)`);let t=s.prepare("SELECT id FROM schema_migrations").all(),n=new Set(t.map(r=>r.id)),o={applied:[],pending:[],errors:[],currentVersion:t.length===0?0:Math.max(...t.map(r=>r.id)),targetVersion:e};for(let r of O){if(r.id>e)break;if(n.has(r.id)){o.pending.push(r.id);continue}if(i.dryRun){o.applied.push(r.id);continue}try{C(s,r.up),s.prepare("INSERT INTO schema_migrations (id) VALUES (?)").run(r.id),n.add(r.id),o.applied.push(r.id),l.debug("migration applied",{id:r.id,description:r.description});}catch(c){let d=utils.errorMeta(c),m=r.up[0]??"";o.errors.push({migrationId:r.id,sql:m,error:d.message}),l.warn("migration step failed",{id:r.id,error:d,sqlCount:r.up.length});}}return o}function C(s,e){for(let i of e)try{s.exec(i);}catch(t){let n=utils.errorMeta(t).message;if(b(n)){l.debug("migration: column already exists, skipping",{sql:i.slice(0,80)});continue}throw t}}function b(s){return /duplicate column name/i.test(s)}function _(s){try{let e=s.prepare("SELECT id FROM schema_migrations").all();return e.length===0?0:Math.max(...e.map(i=>i.id))}catch{return 0}}var N=utils.Log.create({service:"memory.database"}),I=class{constructor(e){chunkKFESJR3T_cjs.a(this,"db",null);chunkKFESJR3T_cjs.a(this,"storagePath");chunkKFESJR3T_cjs.a(this,"backend","better-sqlite3");chunkKFESJR3T_cjs.a(this,"initialized",false);chunkKFESJR3T_cjs.a(this,"initPromise",null);this.storagePath=e===":memory:"?e:utils.Filesystem.normalize(e);}async initialize(){if(!this.initialized){if(this.initPromise){await this.initPromise;return}this.initPromise=this.doInitialize();try{await this.initPromise,this.initialized=!0;}catch(e){try{this.db&&this.db.close();}catch{}throw this.db=null,this.initPromise=null,e}}}async doInitialize(){try{let e=this.openConnection();e.initialize(),this.db=e,this.applyPragmas(),this.runAllMigrations();}catch(e){throw N.error("Database initialization failed",{error:utils.errorMeta(e)}),e}}openConnection(){return database.createSyncSqliteConnection({path:this.storagePath,backend:this.backend,walMode:true,foreignKeys:true,busyTimeoutMs:5e3})}applyPragmas(){if(this.db)try{this.db.pragma("synchronous = NORMAL"),this.db.pragma("cache_size = -64000"),this.db.pragma("temp_store = MEMORY"),this.db.pragma("foreign_keys = ON");}catch(e){N.warn("Failed to apply memory PRAGMAs",{error:utils.errorMeta(e)});}}runAllMigrations(){if(!this.db)throw new chunkAVECFV5K_cjs.a.DatabaseNotInitializedError({message:"Database not initialized",method:"runAllMigrations"});let e=p(this.db,g);if(e.errors.length>0){let i=e.errors.map(t=>`migration ${t.migrationId}: ${t.error}`).join("; ");throw new chunkAVECFV5K_cjs.a.MigrationFailedError({message:`Some migrations failed: ${i}`,errSummary:i})}}query(e,i){if(!this.db)throw new chunkAVECFV5K_cjs.a.DatabaseNotInitializedError({message:"Database not initialized. Call initialize() first.",method:"query"});try{let t=this.db.prepare(e);return i?t.all(...i):t.all()}catch(t){throw new chunkAVECFV5K_cjs.a.DatabaseOperationFailedError({message:`Query failed: ${utils.errorMeta(t).message}`,operation:"query"},{cause:t})}}agentFilter(e){return typeof e=="string"&&e.trim().length>0?{where:"WHERE agent_id = ?",params:[e.trim()]}:{where:"",params:[]}}run(e,i){if(!this.db)throw new chunkAVECFV5K_cjs.a.DatabaseNotInitializedError({message:"Database not initialized. Call initialize() first.",method:"run"});try{let t=this.db.prepare(e),n=i?t.run(...i):t.run();return {lastID:Number(n.lastInsertRowid),changes:n.changes}}catch(t){throw new chunkAVECFV5K_cjs.a.DatabaseOperationFailedError({message:`Write failed: ${utils.errorMeta(t).message}`,operation:"write"},{cause:t})}}transaction(e){if(!this.db)throw new chunkAVECFV5K_cjs.a.DatabaseNotInitializedError({message:"Database not initialized. Call initialize() first.",method:"transaction"});return this.db.transaction(e)()}prepare(e){if(!this.db)throw new chunkAVECFV5K_cjs.a.DatabaseNotInitializedError({message:"Database not initialized. Call initialize() first.",method:"prepare"});return this.db.prepare(e)}exec(e){if(!this.db)throw new chunkAVECFV5K_cjs.a.DatabaseNotInitializedError({message:"Database not initialized. Call initialize() first.",method:"exec"});this.db.exec(e);}getDb(){if(!this.db)throw new chunkAVECFV5K_cjs.a.DatabaseNotInitializedError({message:"Database not initialized. Call initialize() first.",method:"getDb"});return this.db}getPath(){return this.storagePath}getSchemaVersion(){if(!this.db)throw new chunkAVECFV5K_cjs.a.DatabaseNotInitializedError({message:"Database not initialized. Call initialize() first.",method:"getSchemaVersion"});return _(this.db)}close(){if(this.db){try{this.db.close();}catch(e){N.warn("Failed to close memory database",{error:utils.errorMeta(e)});}this.db=null,this.initialized=false,this.initPromise=null;}}healthCheck(){try{return this.db?(this.db.exec("SELECT 1"),!0):!1}catch{return false}}checkIntegrity(){if(!this.db)throw new chunkAVECFV5K_cjs.a.DatabaseNotInitializedError({message:"Database not initialized. Call initialize() first.",method:"checkIntegrity"});let e=S=>this.db.prepare(S).get().c,i={memory_facts:e("SELECT COUNT(*) as c FROM memory_facts"),memory_vectors:e("SELECT COUNT(*) as c FROM memory_vectors"),embedding_cache:e("SELECT COUNT(*) as c FROM embedding_cache"),memory_facts_fts:e("SELECT COUNT(*) as c FROM memory_facts_fts"),nodes:e("SELECT COUNT(*) as c FROM nodes"),edges:e("SELECT COUNT(*) as c FROM edges"),fact_nodes:e("SELECT COUNT(*) as c FROM fact_nodes"),meta:e("SELECT COUNT(*) as c FROM meta"),schema_migrations:e("SELECT COUNT(*) as c FROM schema_migrations")},t=[],n=e(`
|
|
64
|
+
SELECT COUNT(*) as c FROM fact_nodes fn
|
|
65
|
+
LEFT JOIN nodes n ON n.id = fn.node_id
|
|
66
|
+
WHERE n.id IS NULL
|
|
67
|
+
`);n>0&&t.push({severity:"error",message:`orphan node references (fact_nodes): ${n}`});let o=e(`
|
|
68
|
+
SELECT COUNT(*) as c FROM edges e WHERE NOT EXISTS (SELECT 1 FROM nodes n WHERE n.id = e.source)
|
|
69
|
+
`);o>0&&t.push({severity:"error",message:`orphan edges (source): ${o}`});let r=e(`
|
|
70
|
+
SELECT COUNT(*) as c FROM edges e WHERE NOT EXISTS (SELECT 1 FROM nodes n WHERE n.id = e.target)
|
|
71
|
+
`);r>0&&t.push({severity:"error",message:`orphan edges (target): ${r}`});let c=e("SELECT COUNT(*) as c FROM edges WHERE source = target");c>0&&t.push({severity:"warn",message:`self-loop edges: ${c}`});let d=e(`
|
|
72
|
+
SELECT COUNT(*) as c FROM (
|
|
73
|
+
SELECT fact_id FROM memory_facts_fts
|
|
74
|
+
EXCEPT
|
|
75
|
+
SELECT id FROM memory_facts
|
|
76
|
+
)
|
|
77
|
+
`);d>0&&t.push({severity:"warn",message:`FTS out of sync (orphan entries): ${d}`});let m=e("SELECT COUNT(*) as c FROM (SELECT id, COUNT(*) as c FROM memory_facts GROUP BY id HAVING c > 1)");m>0&&t.push({severity:"error",message:`duplicate fact ids: ${m}`});let u=e("SELECT COUNT(*) as c FROM memory_facts WHERE content IS NULL OR content = ''");return u>0&&t.push({severity:"error",message:`memory_facts with null/empty content: ${u}`}),{issues:t,stats:i}}getMeta(e){if(!this.db)throw new chunkAVECFV5K_cjs.a.DatabaseNotInitializedError({message:"Database not initialized",method:"getMeta"});return this.db.prepare("SELECT value FROM meta WHERE key = ?").get(e)?.value??null}setMeta(e,i){if(!this.db)throw new chunkAVECFV5K_cjs.a.DatabaseNotInitializedError({message:"Database not initialized",method:"setMeta"});this.db.prepare("INSERT OR REPLACE INTO meta (key, value) VALUES (?, ?)").run(e,i);}};exports.a=g;exports.b=O;exports.c=p;exports.d=_;exports.e=I;
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import {e,a as a$2}from'./chunk-YJLHS7JB.mjs';import {a as a$1}from'./chunk-HH7EA2UE.mjs';import {a as a$3,b as b$1}from'./chunk-AJDMZTCQ.mjs';import {d}from'./chunk-SE3F5YQE.mjs';import {j as j$1}from'./chunk-HX3TV7FD.mjs';import {a,b,c}from'./chunk-S4DPVKMV.mjs';import {Log,ServiceError,errorMeta,NameErrors,Locale,formatLocalISO,ServiceErrorBus}from'@easbot/utils';import {SQL_TEXT_LIMIT_MAX,resolveSqlTextLimit,SQL_TEXT_LIMIT_DEFAULT}from'@easbot/database';import {z as z$1}from'zod';import {randomBytes,createHash}from'crypto';import ae from'fs/promises';import Ee from'path';import {existsSync}from'fs';import {syncMeta}from'@easbot/llm';import {createRequire}from'module';import {EMBEDDING_DIMS_CONSISTENCY_CHECK,DEFAULT_SEARCH_CONFIG}from'@easbot/types';var Re=Log.create({service:"memory.graph-store"}),ce=class{constructor(e){a(this,"db");this.db=e;}async upsertNode(e,a,r,n){let s=Date.now(),i=JSON.stringify(r??{}),d=this.db.prepare("SELECT id FROM nodes WHERE name = ? AND type = ? LIMIT 1").get(e,a);if(d)return this.db.prepare("UPDATE nodes SET properties = ?, updatedAt = ? WHERE id = ?").run(i,s,d.id),d.id;let b=this.db.prepare("INSERT INTO nodes (name, type, properties, createdAt, updatedAt) VALUES (?, ?, ?, ?, ?)").run(e,a,i,s,s);return Number(b.lastInsertRowid)}async deleteNode(e){this.db.prepare("DELETE FROM nodes WHERE id = ?").run(e);}async upsertEdge(e,a,r,n){let s=this.db.prepare("INSERT OR REPLACE INTO edges (source, target, relation, properties, createdAt) VALUES (?, ?, ?, ?, ?)").run(e,a,r,JSON.stringify(n??{}),Date.now());return Number(s.lastInsertRowid)}async queryNodes(e={}){let a="SELECT id, name, type, properties, createdAt, updatedAt FROM nodes",r=[],n=[];if(e.ids&&e.ids.length>0){let i=e.ids.map(d=>typeof d=="string"?parseInt(d,10):d).filter(d=>!Number.isNaN(d));n.push(`id IN (${i.map(()=>"?").join(", ")})`),r.push(...i);}e.name&&(n.push("name LIKE ?"),r.push(`%${e.name}%`)),e.type&&(n.push("type = ?"),r.push(e.type)),n.length>0&&(a+=` WHERE ${n.join(" AND ")}`),a+=" ORDER BY id",e.limit&&(a+=" LIMIT ?",r.push(e.limit)),Re.debug("queryNodes",{sql:a,params:r,filter:e});let s=this.db.prepare(a).all(...r);return Re.debug("queryNodes result",{count:s.length}),s.map(i=>({id:i.id,name:i.name,type:i.type,properties:i.properties?JSON.parse(i.properties):void 0,createdAt:i.createdAt,updatedAt:i.updatedAt}))}async queryEdges(e={}){let a="SELECT e.id, e.source, e.target, e.relation, e.properties, e.createdAt FROM edges e",r=[],n=[];if(e.ids&&e.ids.length>0&&(n.push(`e.id IN (${e.ids.map(()=>"?").join(", ")})`),r.push(...e.ids)),e.source!==void 0&&(n.push("e.source = ?"),r.push(e.source)),e.target!==void 0&&(n.push("e.target = ?"),r.push(e.target)),e.sourceOrTarget&&e.sourceOrTarget.length>0){let y=e.sourceOrTarget.map(R=>typeof R=="string"?parseInt(R,10):R).filter(R=>!Number.isNaN(R));n.push(`(e.source IN (${y.map(()=>"?").join(", ")}) OR e.target IN (${y.map(()=>"?").join(", ")}))`),r.push(...y,...y);}e.relation&&(n.push("e.relation = ?"),r.push(e.relation)),n.length>0&&(a+=` WHERE ${n.join(" AND ")}`),a+=" ORDER BY e.id",e.limit&&(a+=" LIMIT ?",r.push(e.limit)),Re.debug("queryEdges",{sql:a,params:r,filter:e});let s=this.db.prepare(a).all(...r);Re.debug("queryEdges result",{count:s.length});let i=[...new Set(s.map(y=>y.target))],d=i.length>0?await this.queryNodes({ids:i,limit:i.length}):[],b=new Map(d.map(y=>[y.id,y]));return s.map(y=>{let R={id:y.id,source:y.source,target:y.target,relation:y.relation,properties:y.properties?JSON.parse(y.properties):void 0,createdAt:y.createdAt},h=b.get(y.target);return h&&(R.targetNode=h),R})}async queryNeighbors(e,a=1,r){let n=r?.maxEdgesPerNode??50,s=new Map,i=[e];for(let d=0;d<=a&&i.length>0;d++){let b=await this.queryNodes({ids:i,limit:i.length}),y=await this.queryEdges({sourceOrTarget:i,limit:n*i.length}),R=new Map;for(let u of y){if(i.includes(u.source)){let g=R.get(u.source)??[];g.push(u),R.set(u.source,g);}if(i.includes(u.target)){let g=R.get(u.target)??[];g.push(u),R.set(u.target,g);}}let h=[];for(let u of b){if(s.has(u.id))continue;let g=(R.get(u.id)??[]).slice(0,n);if(s.set(u.id,{...u,edges:g}),d<a)for(let f of g){let O=f.source===u.id?f.target:f.source;!s.has(O)&&!h.includes(O)&&h.push(O);}}i=h;}return [...s.values()]}};function j(t){if(typeof t.agentId!="string"||t.agentId.trim().length===0)throw new ServiceError({code:"AGENT_ID_REQUIRED",message:"ctx.agentId is required for memory service (ADR 0055 per-agent isolation)"})}function ee(t,e){if(t.remote!==false)throw new ServiceError({code:"TRUST_DENIED",message:`Trust denied for operation "${e}": requires trusted local caller (CLI / agent tool / MCP with remote=false)`,details:{operation:e,reason:"requires trusted local caller"}})}function me(t){if(!t.dbPath||t.dbPath.trim().length===0)throw new ServiceError({code:"INTERNAL",message:"service ctx.dbPath is required (MemoryKnowledgeConfigWithModels.database.path)"})}var re=Log.create({service:"memory.service.recall"}),Gt=SQL_TEXT_LIMIT_DEFAULT;async function ft(t,e$1){var y=[];try{let a=Date.now();let r=b(y,re.time("memoryRecall",{level:"DEBUG",agentId:t.agentId}));j(t);me(t);if(!e$1.query||e$1.query.trim().length===0)throw new ServiceError({code:"CONTENT_REQUIRED",message:"recall requires non-empty `query`"});let n=e$1.includeShared?"both":"agent_only";e$1.includeGraph&&void 0;re.debug("recall invoked",{agentId:t.agentId,query:Log.truncateValue(e$1.query),category:e$1.category,maxResults:e$1.maxResults,includeGraph:e$1.includeGraph,scope:n});let s=e$1.maxResults??10;let i=e$1.minScore??0;let d=[];let b$1=new e(t.dbPath);try{await b$1.initialize();let g=a$1.isInitialized()&&a$1.capabilities().embedding===!0,f=await Bt(b$1,t.agentId,e$1.query,{category:e$1.category,minImportance:e$1.minImportance,fromTime:e$1.fromTime,toTime:e$1.toTime,limit:s,minScore:i,hasEmbedding:g,snippetMaxChars:e$1.snippetMaxChars}),O;if(e$1.includeGraph&&f.length>0)try{let D=new ce(b$1.getDb()),N=e$1.maxDepth??1,C=f.flatMap(S=>(S.nodes??[]).map(_=>_.id)).slice(0,5),p=new Set,I=new Map,w=e$1.maxEdgesPerNode??10;for(let S of C){let _=await D.queryNeighbors(S,N,{agentId:t.agentId,scope:n,maxEdgesPerNode:w});for(let $ of _)p.add($.id),I.set($.id,$.edges??[]);}let E=p.size>0?b$1.query(`SELECT id, name, type FROM nodes WHERE id IN (${Array.from(p).map(()=>"?").join(",")})`,Array.from(p)):[],c=Array.from(I.values()).flat();O={nodes:E.map(S=>({id:S.id,name:S.name,type:S.type,createdAt:"",updatedAt:""})),edges:c};}catch(D){let N=errorMeta(D);re.warn("recall: KG neighbor query failed",{error:N}),d.push(`kg_neighbor_query_failed: ${N.message}`),O={nodes:[],edges:[]};}let M=Date.now()-a;return {hits:f,total:f.length,truncated:f.length>=s,durationMs:M,graph:O,...d.length>0?{warnings:d}:{}}}catch(g){throw ServiceError.isInstance(g)?g:new ServiceError({code:"INTERNAL",message:`recall failed: ${errorMeta(g).message}`,details:{cause:errorMeta(g).message}})}finally{b$1.close();}}catch(R){var h=R,u=true;}finally{c(y,h,u);}}async function Bt(t,e,a,r){let n=["mf.agent_id = ?"],s=[e];r.category&&(n.push("mf.category = ?"),s.push(r.category)),r.minImportance!==void 0&&(n.push("mf.importance >= ?"),s.push(r.minImportance)),r.fromTime&&(n.push("mf.created_at >= ?"),s.push(r.fromTime)),r.toTime&&(n.push("mf.created_at <= ?"),s.push(r.toTime));let i=n.join(" AND "),d=null;if(r.hasEmbedding)try{d=await a$1.embedText(a);}catch(c){re.warn("recall: query embedding failed, falling back to FTS-only",{error:errorMeta(c)}),d=null;}let b=Math.max(r.limit*100,1e3),[y,R]=await Promise.all([d?zt(t,d,i,s,b):Promise.resolve([]),Qt(t,a,i,s,r.limit)]),h=d?.7:0,u=d?.3:1,g=h+u,f=h/g,O=u/g,M=new Map;for(let c of y)M.set(c.id,c.score*f);for(let c of R)M.set(c.id,(M.get(c.id)??0)+c.score*O);let D=Array.from(M.entries()).sort((c,S)=>S[1]-c[1]).map(([c])=>c).slice(0,r.limit);if(D.length===0)return [];let N=D.map(()=>"?").join(","),C=resolveSqlTextLimit(r.snippetMaxChars??Gt),p=t.query(`SELECT
|
|
2
|
+
mf.id,
|
|
3
|
+
mf.category,
|
|
4
|
+
mf.importance,
|
|
5
|
+
mf.agent_id as agentId,
|
|
6
|
+
mf.content as content,
|
|
7
|
+
SUBSTR(mf.content, 1, ?) as snippet,
|
|
8
|
+
mf.created_at as createdAt,
|
|
9
|
+
mf.updated_at as updatedAt,
|
|
10
|
+
mf.source,
|
|
11
|
+
mf.file_path as filePath,
|
|
12
|
+
mf.tags,
|
|
13
|
+
mf.session_id as sessionId,
|
|
14
|
+
mf.msg_id as msgId,
|
|
15
|
+
mf.parent_msg_id as parentMsgId
|
|
16
|
+
FROM memory_facts mf
|
|
17
|
+
WHERE mf.id IN (${N})`,[C,...D]),I=jt(t,p.map(c=>c.id)),w=Date.now();return p.map(c=>{let S=M.get(c.id)??0,_=(w-new Date(c.createdAt).getTime())/864e5,$=Math.exp(-0.05*_),T=(c.importance-1)/9,U=.4*S+.3*$+.3*T,l;if(c.tags)try{let m=JSON.parse(c.tags);Array.isArray(m)&&(l=m.filter(v=>typeof v=="string"));}catch{}return {memoryId:c.id,category:c.category,importance:c.importance,agentId:c.agentId,content:c.content,snippet:c.snippet,score:U,createdAt:c.createdAt,updatedAt:c.updatedAt,source:c.source,filePath:c.filePath??void 0,tags:l,sessionId:c.sessionId??void 0,msgId:c.msgId??void 0,parentMsgId:c.parentMsgId??void 0,nodes:I.get(c.id)??[]}}).filter(c=>c.score>=r.minScore).sort((c,S)=>S.score-c.score)}function jt(t,e){let a=new Map;if(e.length===0)return a;try{let r=e.map(()=>"?").join(","),n=t.query(`SELECT fn.fact_id as fact_id, n.id, n.name, n.type
|
|
18
|
+
FROM fact_nodes fn
|
|
19
|
+
JOIN nodes n ON fn.node_id = n.id
|
|
20
|
+
WHERE fn.fact_id IN (${r})
|
|
21
|
+
ORDER BY fn.fact_id, fn.score DESC, n.id`,e);for(let s of n){let i=a.get(s.fact_id);i||(i=[],a.set(s.fact_id,i)),i.push({id:s.id,name:s.name,type:s.type});}}catch(r){re.warn("recall: loadFactNodes failed (KG associations unavailable for this recall)",{error:errorMeta(r)});}return a}function zt(t,e,a,r,n){try{return t.query(`SELECT mf.id, mv.embedding
|
|
22
|
+
FROM memory_facts mf
|
|
23
|
+
JOIN memory_vectors mv ON mf.id = mv.fact_id
|
|
24
|
+
WHERE ${a}
|
|
25
|
+
LIMIT ?`,[...r,n]).map(i=>{let d=new Float32Array(i.embedding.buffer,i.embedding.byteOffset,i.embedding.byteLength/4);return {id:i.id,score:Kt(e,d)}}).sort((i,d)=>d.score-i.score)}catch(s){if(ServiceError.isInstance(s))throw s;return re.warn("vector search failed, falling back to FTS-only",{error:errorMeta(s)}),[]}}function Qt(t,e,a,r,n){try{let s=t.query(`SELECT mf.id as id, bm25(memory_facts_fts) as score
|
|
26
|
+
FROM memory_facts_fts fts
|
|
27
|
+
JOIN memory_facts mf ON mf.id = fts.fact_id
|
|
28
|
+
WHERE ${a} AND memory_facts_fts MATCH ?
|
|
29
|
+
ORDER BY score DESC
|
|
30
|
+
LIMIT ?`,[...r,Vt(e),n]);if(s.length===0)return [];let i=Math.max(...s.map(d=>Math.abs(d.score)),1);return s.map(d=>({id:d.id,score:1-Math.abs(d.score)/i})).filter(d=>d.score>=0)}catch(s){if(ServiceError.isInstance(s))throw s;return re.warn("FTS search failed, returning empty result",{error:errorMeta(s)}),[]}}function Kt(t,e){if(t.length!==e.length||t.length===0)return 0;let a=0,r=0,n=0;for(let i=0;i<t.length;i++){let d=t[i]??0,b=e[i]??0;a+=d*b,r+=d*d,n+=b*b;}let s=Math.sqrt(r)*Math.sqrt(n);return s===0?0:Math.max(0,a/s)}function Vt(t){return t.trim().split(/\s+/).filter(e=>e.length>0).map(e=>`"${e.replace(/"/g,'""')}"`).join(" ")}var Ne=z$1.object({query:z$1.string().min(1).max(2e3),category:z$1.string().optional(),minImportance:z$1.number().min(1).max(10).optional(),fromTime:z$1.string().datetime().optional(),toTime:z$1.string().datetime().optional(),maxResults:z$1.number().int().min(1).max(100).optional(),minScore:z$1.number().min(0).max(1).optional(),includeGraph:z$1.boolean().optional(),maxDepth:z$1.number().int().min(1).max(5).optional(),includeShared:z$1.boolean().optional(),maxEdgesPerNode:z$1.number().int().min(1).max(100).optional(),snippetMaxChars:z$1.number().int().min(1).max(SQL_TEXT_LIMIT_MAX).optional()}).strict();z$1.object({hits:z$1.array(z$1.unknown()),total:z$1.number(),truncated:z$1.boolean(),durationMs:z$1.number(),graph:z$1.object({nodes:z$1.array(z$1.unknown()),edges:z$1.array(z$1.unknown())}).optional()});var Oe=z$1.object({content:z$1.string().min(1).max(1e4),category:z$1.string().min(1),importance:z$1.number().int().min(1).max(10).optional(),tags:z$1.array(z$1.string()).optional(),sessionId:z$1.string().optional(),msgId:z$1.string().optional(),parentMsgId:z$1.string().optional(),skipDedup:z$1.boolean().optional(),extractGraph:z$1.boolean().optional()}).strict();z$1.object({fact:z$1.object({id:z$1.string(),agentId:z$1.string(),content:z$1.string(),category:z$1.string(),importance:z$1.number(),createdAt:z$1.string(),updatedAt:z$1.string()}),filePath:z$1.string(),deduplicated:z$1.boolean(),nodeIds:z$1.array(z$1.number()).optional()});var Te=z$1.object({factId:z$1.string().min(1).describe("Target fact id (must belong to ctx.agentId)"),content:z$1.string().min(1).max(1e4).optional().describe("New content (triggers embedding rewrite + FTS reindex)"),category:z$1.string().min(1).optional().describe("New category (one of MemoryCategory enum)"),importance:z$1.number().int().min(1).max(10).optional().describe("New importance 1-10"),tags:z$1.array(z$1.string()).optional().describe("New tags array (empty array clears tags)")}).strict().refine(t=>t.content!==void 0||t.category!==void 0||t.importance!==void 0||t.tags!==void 0,{message:"at least one of `content`, `category`, `importance`, `tags` is required"});z$1.object({fact:z$1.object({id:z$1.string(),agentId:z$1.string(),content:z$1.string(),category:z$1.string(),importance:z$1.number(),createdAt:z$1.string(),updatedAt:z$1.string()}),contentChanged:z$1.boolean(),fieldsUpdated:z$1.array(z$1.string()),durationMs:z$1.number()});var Pe=z$1.object({factId:z$1.string().optional(),category:z$1.string().optional(),fromTime:z$1.string().datetime().optional(),toTime:z$1.string().datetime().optional(),maxDelete:z$1.number().int().min(1).max(1e4).optional(),dryRun:z$1.boolean().optional(),force:z$1.boolean().optional()}).strict().refine(t=>t.factId!==void 0&&t.factId.length>0||t.category!==void 0&&t.category.length>0||t.fromTime!==void 0||t.toTime!==void 0,{message:"one of `factId`, `category`, `fromTime`, or `toTime` is required"});z$1.object({deletedCount:z$1.number(),deletedIds:z$1.array(z$1.string()),dryRun:z$1.boolean(),truncatedCount:z$1.number()});var Ae=z$1.object({sessionId:z$1.string().min(1),lastN:z$1.number().int().min(1).max(500).optional(),fromMessageId:z$1.string().optional(),writeToDisk:z$1.boolean().optional()}).strict();z$1.object({extractedCount:z$1.number(),factIds:z$1.array(z$1.string()),entities:z$1.array(z$1.object({id:z$1.number(),name:z$1.string(),type:z$1.string()})),relations:z$1.array(z$1.object({source:z$1.string(),target:z$1.string(),relation:z$1.string()})),messageRange:z$1.object({fromMessageId:z$1.string(),toMessageId:z$1.string()}),durationMs:z$1.number()});var ke=z$1.object({windowDays:z$1.number().int().min(1).max(365).optional(),dryRun:z$1.boolean().optional(),fromTime:z$1.string().datetime().optional()}).strict();z$1.object({totalFacts:z$1.number(),dedupedCount:z$1.number(),compressedCount:z$1.number(),archivedCount:z$1.number(),skippedCount:z$1.number(),durationMs:z$1.number()});var xe=z$1.object({query:z$1.string().min(1).optional(),nodeId:z$1.number().int().positive().optional(),type:z$1.string().optional(),maxDepth:z$1.number().int().min(1).max(5).optional(),maxNodes:z$1.number().int().min(1).max(500).optional(),scope:z$1.enum(["agent_only","shared_only","both"]).optional(),relation:z$1.string().optional(),maxEdgesPerNode:z$1.number().int().min(1).max(100).optional()}).strict();z$1.object({root:z$1.unknown().nullable(),nodes:z$1.array(z$1.unknown()),edges:z$1.array(z$1.unknown()),truncated:z$1.boolean(),totalNodes:z$1.number(),totalEdges:z$1.number(),scope:z$1.enum(["agent_only","shared_only","both"]),durationMs:z$1.number()});var Fe=z$1.object({agentId:z$1.string().optional()}).loose().optional();z$1.object({dbPath:z$1.string(),workspaceDir:z$1.string(),factsCount:z$1.number(),nodesCount:z$1.number(),edgesCount:z$1.number(),factsByCategory:z$1.record(z$1.string(),z$1.number()),ftsAvailable:z$1.boolean(),vectorEnabled:z$1.boolean(),healthy:z$1.boolean(),meta:z$1.record(z$1.string(),z$1.string())});var Le=z$1.object({repair:z$1.boolean().optional(),agentId:z$1.string().optional()}).loose().optional();z$1.object({healthy:z$1.boolean(),checks:z$1.array(z$1.object({name:z$1.string(),passed:z$1.boolean(),message:z$1.string(),details:z$1.record(z$1.string(),z$1.unknown()).optional()}))});var qe=z$1.object({workspaceDir:z$1.string().optional(),dbPath:z$1.string().optional(),archiveDays:z$1.number().int().min(1).max(3650).optional(),force:z$1.boolean().optional()}).strict();z$1.object({initialized:z$1.boolean(),dbPath:z$1.string(),workspaceDir:z$1.string(),tablesCreated:z$1.number(),migrationsApplied:z$1.number(),durationMs:z$1.number()});var $e=z$1.object({windowDays:z$1.number().int().min(1).max(3650).optional(),dryRun:z$1.boolean().optional()}).loose();z$1.object({generatedCount:z$1.number(),skippedCount:z$1.number(),failedGenerateCount:z$1.number(),archivedCount:z$1.number(),failedArchivePaths:z$1.array(z$1.string()),archiveThreshold:z$1.string(),archivedRecords:z$1.array(z$1.object({source:z$1.string(),target:z$1.string(),firstCreatedAt:z$1.string(),firstFactId:z$1.string()})),windowDays:z$1.number(),dryRun:z$1.boolean(),durationMs:z$1.number()});var be=Log.create({service:"memory.fact-file-sync"}),Zt=".easbot/memory/active";function we(t,e){let a=e.replace(/\\/g,"/").replace(/\/+$/,""),r=t.category||"uncategorized",n=t.createdAt?new Date(t.createdAt).getTime():Date.now(),s=Number.isNaN(n)?new Date:new Date(n),i=s.getFullYear(),d=String(s.getMonth()+1).padStart(2,"0"),b=String(s.getDate()).padStart(2,"0"),y=`${i}-${d}-${b}`;return `${a}/${Zt}/${r}/${y}.md`}function yt(t){let e=t.tags&&t.tags.length>0?t.tags:[],a=t.importance??5,r=t.source??"session_self_write",n=t.createdAt?formatLocalISO(new Date(t.createdAt)):formatLocalISO(new Date),s=t.updatedAt?formatLocalISO(new Date(t.updatedAt)):n,i=["---",`id: ${t.id}`,`agent_id: ${t.agentId}`,`category: ${t.category}`,`importance: ${a}`,`created_at: ${n}`,`updated_at: ${s}`,`source: ${r}`,e.length>0?`tags: [${e.join(", ")}]`:"tags: []"];return t.sessionId&&i.push(`session_id: ${t.sessionId}`),t.msgId&&i.push(`msg_id: ${t.msgId}`),t.parentMsgId&&i.push(`parent_msg_id: ${t.parentMsgId}`),i.push("---"),`${i.join(`
|
|
31
|
+
`)}
|
|
32
|
+
${t.content.trim()}`}function le(t,e){let a=t.replace(/\\/g,"/"),r=e.replace(/\\/g,"/").replace(/\/+$/,"");return a.startsWith(`${r}/`)?a.slice(r.length+1):a}async function er(t,e){let a=we(t,e),r=le(a,e);try{let n=yt(t);await ae.mkdir(Ee.dirname(a),{recursive:!0});let s="";try{s=await ae.readFile(a,"utf-8");}catch(d){if(d.code!=="ENOENT")throw d}let i=s.length>0&&!s.endsWith(`
|
|
33
|
+
`)?`
|
|
34
|
+
`:"";return await ae.writeFile(a,`${s}${i}${n}
|
|
35
|
+
`,"utf-8"),be.debug("Fact file synced (append)",{id:t.id,relPath:r}),{ok:!0,absPath:a,relPath:r}}catch(n){let s=errorMeta(n).message;return be.warn("Failed to write fact file (best-effort, non-blocking)",{id:t.id,absPath:a,error:errorMeta(n)}),{ok:false,absPath:a,relPath:r,error:s}}}async function tr(t,e){let a;t.filePath?a=`${e.replace(/\\/g,"/").replace(/\/+$/,"")}/${t.filePath.replace(/^\/+/,"")}`:a=we({id:t.id,category:t.category,createdAt:t.createdAt,updatedAt:t.createdAt},e);let r=le(a,e);try{return await ae.unlink(a),be.debug("Fact file deleted",{id:t.id,relPath:r}),{ok:!0,absPath:a,relPath:r}}catch(n){if(n.code==="ENOENT")return be.debug("Fact file not found (already deleted)",{id:t.id,relPath:r}),{ok:true,absPath:a,relPath:r};let i=errorMeta(n).message;return be.warn("Failed to delete fact file (best-effort, non-blocking)",{id:t.id,absPath:a,error:errorMeta(n)}),{ok:false,absPath:a,relPath:r,error:i}}}var ge={resolvePath:we,renderMarkdown:yt,toRelPath:le,write:er,delete:tr};var pe=Log.create({service:"memory.service.remember"});async function ht(t,e$1){if(j(t),me(t),!e$1.content||e$1.content.trim().length===0)throw new ServiceError({code:"CONTENT_REQUIRED",message:"remember requires non-empty `content`"});if(!e$1.category)throw new ServiceError({code:"CATEGORY_REQUIRED",message:"remember requires `category`"});pe.debug("remember invoked",{agentId:t.agentId,category:e$1.category,importance:e$1.importance??5,contentLength:e$1.content.length,skipDedup:e$1.skipDedup,extractGraph:e$1.extractGraph??true});let a=new e(t.dbPath);try{await a.initialize();let r=new Date().toISOString(),n=ar(),s=e$1.importance??5,i={entities:[],relations:[]},b=e$1.extractGraph!==!1&&a$1.isInitialized()&&a$1.capabilities().graph?a$1.getGraph():void 0;if(b)try{i=await ir(b,e$1.content);}catch(p){pe.warn("LLM KG extraction failed (continuing without KG)",{agentId:t.agentId,error:errorMeta(p)});}let y=a$1.isInitialized()&&a$1.capabilities().embedding===!0,R=y?await sr(a.getDb(),e$1.content):null,h=R?R.length:null,u=i.entities,g=i.relations,f=[],O=0,M=[];if(a.transaction(()=>{let p=new Map;for(let w of u){let E=a.query("SELECT id FROM nodes WHERE name = ? AND type = ? LIMIT 1",[w.name,w.type])[0];if(E){p.set(w.name,E.id);continue}let c=null;try{let $=We(w.name),T=a.query("SELECT embedding FROM embedding_cache WHERE content_hash = ?",[$])[0];T?.embedding&&(c=T.embedding);}catch{}let _=a.run("INSERT INTO nodes (name, type, properties, embedding, createdAt, updatedAt) VALUES (?, ?, ?, ?, ?, ?)",[w.name,w.type,JSON.stringify({source:"llm_extracted",...w.properties??{}}),c,r,r]).lastID;_>0&&(p.set(w.name,_),c===null&&M.push({name:w.name,nodeId:_}));}for(let w of g){let E=p.get(w.source),c=p.get(w.target);!E||!c||E===c||a.run("INSERT OR REPLACE INTO edges (source, target, relation, properties, createdAt) VALUES (?, ?, ?, ?, ?)",[E,c,w.relation,JSON.stringify({}),r]);}a.run(`INSERT INTO memory_facts
|
|
36
|
+
(id, agent_id, session_id, msg_id, parent_msg_id, content, category, importance,
|
|
37
|
+
source, tags, file_path, created_at, updated_at)
|
|
38
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,[n,t.agentId,e$1.sessionId??null,e$1.msgId??null,e$1.parentMsgId??null,e$1.content,e$1.category,s,"session_self_write",e$1.tags?JSON.stringify(e$1.tags):null,null,r,r]);let I=Array.from(p.values());if(I.length>0)try{for(let w of I)a.run("INSERT OR IGNORE INTO fact_nodes (fact_id, node_id, source, score, createdAt) VALUES (?, ?, ?, ?, ?)",[n,w,"kg_extract",1,r]);}catch(w){pe.warn("fact_nodes write failed (non-fatal)",{factId:n,nodeCount:I.length,error:errorMeta(w)});}if(R&&h){let w=Ue(R);a.run("INSERT OR REPLACE INTO memory_vectors (fact_id, embedding) VALUES (?, ?)",[n,w]),O=1,a.query("SELECT value FROM meta WHERE key = ?",["vectorDims"])[0]||a.run("INSERT OR REPLACE INTO meta (key, value) VALUES (?, ?)",["vectorDims",String(h)]);}a.run("DELETE FROM memory_facts_fts WHERE fact_id = ?",[n]),a.run("INSERT INTO memory_facts_fts (fact_id, agent_id, content, tags) VALUES (?, ?, ?, ?)",[n,t.agentId,e$1.content,e$1.tags?e$1.tags.join(" "):""]),f.push(...Array.from(p.values()));}),M.length>0&&a$1.isInitialized()&&a$1.capabilities().embedding)try{let p=M.map(E=>E.name),I=await a$1.embedMany(p),w=new Date().toISOString();for(let E=0;E<M.length;E++){let c=M[E],S=I[E];if(!c||!S||S.length===0)continue;let _=Ue(new Float32Array(S));a.run("INSERT OR REPLACE INTO embedding_cache (content_hash, embedding) VALUES (?, ?)",[We(c.name),_]),a.run("UPDATE nodes SET embedding = ?, updatedAt = ? WHERE id = ?",[_,w,c.nodeId]);}}catch(p){pe.warn("memory entity name batch embed failed (non-fatal)",{pendingCount:M.length,error:errorMeta(p)});}pe.debug("Memory stored",{id:n,category:e$1.category,agentId:t.agentId,nodeCount:f.length,vectorsWritten:O,vectorDims:h??0,embeddingMode:y?"enabled":"fts_only",entitiesExtracted:u.length,relationsExtracted:g.length});let D={id:n,agentId:t.agentId,sessionId:e$1.sessionId,msgId:e$1.msgId,parentMsgId:e$1.parentMsgId,content:e$1.content,category:e$1.category,importance:s,source:"session_self_write",tags:e$1.tags,nodeIds:f.length>0?f:void 0,filePath:void 0,createdAt:r,updatedAt:r},N="",C=await ge.write(D,t.workspaceDir);if(C.ok){N=C.relPath,D.filePath=C.relPath;try{a.run("UPDATE memory_facts SET file_path = ? WHERE id = ?",[C.relPath,n]);}catch(p){pe.warn("Failed to update file_path column after sync",{id:n,error:errorMeta(p)});}}return {fact:D,filePath:N,deduplicated:!1,nodeIds:f,vectorsWritten:O,vectorDims:h??0,entitiesExtracted:u.length,relationsExtracted:g.length}}catch(r){throw ServiceError.isInstance(r)?r:new ServiceError({code:"INTERNAL",message:`remember failed: ${errorMeta(r).message}`,details:{cause:errorMeta(r).message}})}finally{a.close();}}function ar(){let t=Date.now(),e=randomBytes(3).toString("hex");return `mem_${t}_${e}`}function Ue(t){return Buffer.from(t.buffer,t.byteOffset,t.byteLength)}function We(t){return createHash("sha256").update(t).digest("hex")}async function sr(t,e){let a=We(e),r=t.prepare("SELECT embedding FROM embedding_cache WHERE content_hash = ?").get(a);if(r?.embedding)return new Float32Array(r.embedding.buffer,r.embedding.byteOffset,r.embedding.byteLength/4);let n=await a$1.embedText(e);if(!n||n.length===0)return null;let s=Ue(n);return t.prepare("INSERT OR REPLACE INTO embedding_cache (content_hash, embedding) VALUES (?, ?)").run(a,s),n}async function ir(t,e){let a=await a$1.generateGraph([e],{graphLlm:t});return {entities:a.entities,relations:a.relations}}var _e=Log.create({service:"memory.service.update"});function mr(t){if(t.content===void 0&&t.category===void 0&&t.importance===void 0&&t.tags===void 0)throw new ServiceError({code:"CONTENT_REQUIRED",message:"update requires at least one of: `content`, `category`, `importance`, `tags`"});if(t.content!==void 0&&t.content.trim().length===0)throw new ServiceError({code:"CONTENT_REQUIRED",message:"update: `content` cannot be empty (use `forget` to delete)"});if(t.importance!==void 0&&(t.importance<1||t.importance>10))throw new ServiceError({code:"IMPORTANCE_REQUIRED",message:`update: \`importance\` must be 1-10, got ${t.importance}`})}async function bt(t,e$1){var b$1=[];try{let a=Date.now();let r=b(b$1,_e.time("memoryUpdate",{level:"DEBUG",agentId:t.agentId}));j(t);me(t);mr(e$1);_e.debug("update invoked",{agentId:t.agentId,factId:e$1.factId,fields:{content:e$1.content!==void 0,category:e$1.category!==void 0,importance:e$1.importance!==void 0,tags:e$1.tags!==void 0}});let n=e$1.content!==void 0;let s=n&&a$1.isInitialized()&&a$1.capabilities().embedding===!0;let i=null;if(s&&e$1.content)try{i=await a$1.embedText(e$1.content);}catch(u){_e.warn("update: embedding rewrite failed (continuing without vector update)",{factId:e$1.factId,error:errorMeta(u)});}let d=new e(t.dbPath);try{await d.initialize();let u=new Date().toISOString(),g=[];d.transaction(()=>{let D=d.query("SELECT id, content, category, importance, tags FROM memory_facts WHERE id = ? AND agent_id = ?",[e$1.factId,t.agentId])[0];if(!D)throw new ServiceError({code:"NOT_FOUND",message:`Memory not found: ${e$1.factId}`,details:{memoryId:e$1.factId}});let N=["updated_at = ?"],C=[u];if(e$1.content!==void 0&&e$1.content!==D.content&&(N.push("content = ?"),C.push(e$1.content),g.push("content")),e$1.category!==void 0&&e$1.category!==D.category&&(N.push("category = ?"),C.push(e$1.category),g.push("category")),e$1.importance!==void 0&&e$1.importance!==D.importance&&(N.push("importance = ?"),C.push(e$1.importance),g.push("importance")),e$1.tags!==void 0){let p=e$1.tags.length>0?JSON.stringify(e$1.tags):null;p!==D.tags&&(N.push("tags = ?"),C.push(p),g.push("tags"));}if(g.length>0&&d.run(`UPDATE memory_facts SET ${N.join(", ")} WHERE id = ? AND agent_id = ?`,[...C,e$1.factId,t.agentId]),g.includes("content")||g.includes("tags")){let p=e$1.content??D.content,I=g.includes("tags")?e$1.tags&&e$1.tags.length>0?JSON.stringify(e$1.tags):null:D.tags,w=I?(()=>{try{let E=JSON.parse(I);return Array.isArray(E)?E.filter(c=>typeof c=="string"):[]}catch{return []}})():[];d.run("DELETE FROM memory_facts_fts WHERE fact_id = ?",[e$1.factId]),d.run("INSERT INTO memory_facts_fts (fact_id, agent_id, content, tags) VALUES (?, ?, ?, ?)",[e$1.factId,t.agentId,p,w.join(" ")]);}if(g.includes("content")&&i){let p=lr(i);d.run("INSERT OR REPLACE INTO memory_vectors (fact_id, embedding) VALUES (?, ?)",[e$1.factId,p]);try{let I=gr(e$1.content);d.run("INSERT OR REPLACE INTO embedding_cache (content_hash, embedding) VALUES (?, ?)",[I,p]);}catch{}}}),(g.includes("content")||g.includes("tags"))&&d.run("INSERT INTO memory_facts_fts(memory_facts_fts) VALUES('optimize')");let f=d.query("SELECT id, agent_id, session_id, msg_id, parent_msg_id, content, category, importance, source, tags, file_path, created_at, updated_at FROM memory_facts WHERE id = ? AND agent_id = ?",[e$1.factId,t.agentId])[0];if(!f)throw new ServiceError({code:"INTERNAL",message:`update: failed to read back updated fact ${e$1.factId}`});let O;if(f.tags)try{let D=JSON.parse(f.tags);Array.isArray(D)&&(O=D.filter(N=>typeof N=="string"));}catch{}let M={id:f.id,agentId:f.agent_id,sessionId:f.session_id??void 0,msgId:f.msg_id??void 0,parentMsgId:f.parent_msg_id??void 0,content:f.content,category:f.category,importance:f.importance,source:f.source,tags:O,filePath:f.file_path??void 0,createdAt:f.created_at,updatedAt:f.updated_at};return _e.debug("Memory updated",{agentId:t.agentId,factId:e$1.factId,fieldsUpdated:g,contentChanged:n,durationMs:Date.now()-a}),{fact:M,contentChanged:n,fieldsUpdated:g,durationMs:Date.now()-a}}catch(u){throw ServiceError.isInstance(u)?u:new ServiceError({code:"INTERNAL",message:`update failed: ${errorMeta(u).message}`,details:{cause:errorMeta(u).message}})}finally{d.close();}}catch(y){var R=y,h=true;}finally{c(b$1,R,h);}}function lr(t){return Buffer.from(t.buffer,t.byteOffset,t.byteLength)}function gr(t){return createHash("sha256").update(t).digest("hex")}var je=Log.create({service:"memory.service.forget"}),pr=1e3;function fr(t){let e=[];if(t.factId&&t.factId.trim().length>0&&e.push("factId"),t.category&&t.category.trim().length>0&&e.push("category"),(t.fromTime||t.toTime)&&e.push("timeRange"),e.length===0)throw new ServiceError({code:"CONTENT_REQUIRED",message:"forget requires one of: `factId`, `category`, or `fromTime`/`toTime`"});if(e.length>1)throw new ServiceError({code:"CONTENT_REQUIRED",message:`mutually exclusive: forget requires exactly one of factId/category/timeRange, got [${e.join(", ")}]`});return e[0]}function yr(t,e,a){let r=[a];switch(t){case "factId":return {where:"agent_id = ? AND id = ?",args:[...r,e.factId]};case "category":return {where:"agent_id = ? AND category = ?",args:[...r,e.category]};case "timeRange":{let n=["agent_id = ?"];return e.fromTime&&(n.push("created_at >= ?"),r.push(e.fromTime)),e.toTime&&(n.push("created_at <= ?"),r.push(e.toTime)),{where:n.join(" AND "),args:r}}}}function hr(t,e,a,r){return t.query(`SELECT id FROM memory_facts WHERE ${e} LIMIT ?`,[...a,r+1]).map(s=>s.id)}function br(t,e,a,r){if(a.length===0)return 0;let n=a.map(()=>"?").join(",");return t.query(`SELECT COUNT(DISTINCT fn.fact_id) as count
|
|
39
|
+
FROM fact_nodes fn
|
|
40
|
+
JOIN memory_facts mf ON fn.fact_id = mf.id
|
|
41
|
+
WHERE mf.agent_id = ? AND fn.fact_id != ? AND fn.node_id IN (${n})`,[r,e,...a])[0]?.count??0}function wr(t,e,a){let r,n,s="";return t.transaction(()=>{let i=t.query("SELECT content, file_path, category, created_at FROM memory_facts WHERE id = ? AND agent_id = ?",[e,a])[0],b=t.query("SELECT node_id FROM fact_nodes WHERE fact_id = ?",[e]).map(y=>y.node_id).filter(y=>typeof y=="number");if(r=i?.file_path??void 0,n=i?.category,s=i?.created_at??"",t.run("DELETE FROM memory_facts_fts WHERE fact_id = ?",[e]),t.run("DELETE FROM memory_facts WHERE id = ? AND agent_id = ?",[e,a]),b.length>0){let y=b.map(()=>"?").join(",");t.run(`DELETE FROM nodes WHERE id IN (${y}) AND NOT EXISTS (
|
|
42
|
+
SELECT 1 FROM fact_nodes fn WHERE fn.node_id = nodes.id
|
|
43
|
+
)`,b);}}),t.run("INSERT INTO memory_facts_fts(memory_facts_fts) VALUES('optimize')"),{filePath:r,category:n,createdAt:s}}async function wt(t,e$1){j(t),ee(t,"forget");let a=fr(e$1),r=e$1.maxDelete??pr,n=e$1.dryRun??false,s=e$1.force??false;je.debug("forget invoked",{agentId:t.agentId,mode:a,maxDelete:r,dryRun:n,force:s});let i=new e(t.dbPath);try{await i.initialize();let{where:d,args:b}=yr(a,e$1,t.agentId),y=hr(i,d,b,r),R=y.length>r;if(R&&!s)throw new ServiceError({code:"MAX_DELETE_EXCEEDED",message:`Matched ${y.length} memories exceeds maxDelete=${r}`,details:{matched:y.length,maxDelete:r}});let h=R?y.slice(0,r):y;if(n)throw new ServiceError({code:"DRY_RUN_NO_DELETE",message:`dryRun mode: ${h.length} memories matched but not deleted`,details:{matchedCount:h.length}});let u=[],g=[];for(let f of h){if(!s){let C=i.query("SELECT node_id FROM fact_nodes WHERE fact_id = ? AND node_id IS NOT NULL",[f]).map(I=>I.node_id).filter(I=>typeof I=="number"),p=br(i,f,C,t.agentId);if(p>0)throw new ServiceError({code:"HAS_REFERENCES",message:`Memory ${f} has ${p} references (force=false)`,details:{memoryId:f,referenceCount:p}})}let{filePath:O,category:M,createdAt:D}=wr(i,f,t.agentId);O&&M&&g.push({id:f,filePath:O,category:M,createdAt:D}),u.push(f);}je.debug("forget complete",{agentId:t.agentId,mode:a,deletedCount:u.length,force:s,dryRun:n});for(let{id:f,filePath:O,category:M,createdAt:D}of g)await ge.delete({id:f,filePath:O,category:M,createdAt:D},t.workspaceDir).catch(N=>{je.warn("Fact file delete failed (best-effort)",{id:f,filePath:O,error:errorMeta(N)});});return {deletedCount:u.length,deletedIds:u,dryRun:n,truncatedCount:R?y.length-r:0}}catch(d){throw ServiceError.isInstance(d)?d:new ServiceError({code:"INTERNAL",message:`forget failed: ${errorMeta(d).message}`,details:{cause:errorMeta(d).message}})}finally{i.close();}}var ze=Log.create({service:"memory.service.extract"}),Ir=50,Qe=500;async function It(t,e$1){var b$1=[];try{j(t);if(!e$1.sessionId||e$1.sessionId.trim().length===0)throw new ServiceError({code:"SESSION_ID_REQUIRED",message:"extract requires non-empty `sessionId`"});let a=e$1.lastN??Ir;if(a>Qe)throw new ServiceError({code:"CONTENT_REQUIRED",message:`extract lastN=${a} exceeds max=${Qe}`,details:{lastN:a,maxLastN:Qe}});let r=e$1.sessionId;let n=e$1.fromMessageId;ze.debug("extract invoked",{agentId:t.agentId,sessionId:r,lastN:a,fromMessageId:n,writeToDisk:e$1.writeToDisk??!0});let s=Date.now();let i=b(b$1,ze.time("memoryExtract",{level:"DEBUG",agentId:t.agentId}));let d=new e(t.dbPath);try{await d.initialize();let u=d.query(`SELECT id, content, category, importance, 1.0 as score, created_at
|
|
44
|
+
FROM memory_facts
|
|
45
|
+
WHERE agent_id = ? AND session_id = ?
|
|
46
|
+
ORDER BY created_at ASC
|
|
47
|
+
LIMIT ?`,[t.agentId,r,a]),g=n?u.filter(I=>I.id>n):u,f=g.map(I=>I.id),O=f.length>0?d.query(`SELECT node_id FROM fact_nodes WHERE fact_id IN (${f.map(()=>"?").join(",")})`,f):[],M=new Set;for(let I of O)typeof I.node_id=="number"&&I.node_id>0&&M.add(I.node_id);let D=Array.from(M),N=[],C=[];if(D.length>0){let I=D.map(()=>"?").join(","),w=d.query(`SELECT id, name, type FROM nodes WHERE id IN (${I})`,D),E=new Map;for(let _ of w)E.set(_.id,_.name);N=w.map(_=>({id:_.id,name:_.name,type:_.type}));let c=d.query(`SELECT source, target, relation FROM edges WHERE source IN (${I}) OR target IN (${I})`,[...D,...D]),S=new Set;C=[];for(let _ of c){let $=E.get(_.source),T=E.get(_.target);if(!$||!T)continue;let U=`${$}\0${_.relation}\0${T}`;S.has(U)||(S.add(U),C.push({source:$,target:T,relation:_.relation}));}}let p=Date.now()-s;return ze.debug("extract complete",{agentId:t.agentId,sessionId:r,factCount:g.length,nodeCount:N.length,relationCount:C.length,durationMs:p}),{extractedCount:g.length,factIds:g.map(I=>I.id),entities:N,relations:C,messageRange:{fromMessageId:g[0]?.id??"",toMessageId:g[g.length-1]?.id??""},durationMs:p}}catch(u){throw ServiceError.isInstance(u)?u:new ServiceError({code:"INTERNAL",message:`extract failed: ${errorMeta(u).message}`,details:{cause:errorMeta(u).message}})}finally{d.close();}}catch(y){var R=y,h=true;}finally{c(b$1,R,h);}}var ve=Log.create({service:"memory.service.consolidate"}),Mr=30;async function Sr(t){let{createHash:e}=await import('crypto');return e("sha256").update(t).digest("hex")}async function Rt(t,e$1={}){var b$1=[];try{let a=Date.now();j(t);ee(t,"consolidate");let r=e$1.windowDays??Mr;let n=e$1.dryRun??!1;let s=b(b$1,ve.time("memoryConsolidate",{level:"DEBUG",agentId:t.agentId,dryRun:n}));let i=e$1.fromTime;ve.debug("consolidate invoked",{agentId:t.agentId,windowDays:r,dryRun:n,fromTime:i});let d=new e(t.dbPath);try{await d.initialize();let u=d.query(`SELECT id, content, category, importance, created_at FROM memory_facts
|
|
48
|
+
WHERE agent_id = ?${i?" AND created_at >= ?":""}
|
|
49
|
+
ORDER BY created_at DESC`,i?[t.agentId,i]:[t.agentId]),g=new Map;for(let w of u){let E=await Sr(w.content);g.has(E)||g.set(E,[]),g.get(E)?.push(w);}let f=0,O=[];for(let[,w]of g){if(w.length<=1)continue;let E=[...w].sort((_,$)=>_.importance!==$.importance?$.importance-_.importance:$.created_at.localeCompare(_.created_at)),c=E[0];if(!c)continue;let S=E.slice(1).map(_=>_.id);f+=S.length,O.push({keep:c,removeIds:S});}let M=new Date(Date.now()-r*24*60*60*1e3).toISOString(),D=d.query(`SELECT id, content, category, importance, created_at FROM memory_facts
|
|
50
|
+
WHERE agent_id = ? AND created_at < ?
|
|
51
|
+
ORDER BY created_at ASC`,[t.agentId,M]),N=0;if(n)N=0;else {let w=Ee.join(t.workspaceDir,"archive");await ae.mkdir(w,{recursive:!0});for(let{removeIds:E}of O)E.length!==0&&d.transaction(()=>{for(let c of E)d.run("DELETE FROM memory_facts WHERE id = ? AND agent_id = ?",[c,t.agentId]);});for(let E of D){let c=E.created_at.slice(0,7),S=Ee.join(w,c,E.category);await ae.mkdir(S,{recursive:!0});let _=Ee.join(S,`${E.id}.md`);try{await ae.writeFile(_,[`# ${E.id}`,"",`category: ${E.category}`,`importance: ${E.importance}`,`createdAt: ${E.created_at}`,"",E.content,""].join(`
|
|
52
|
+
`),"utf-8"),d.run("DELETE FROM memory_facts WHERE id = ? AND agent_id = ?",[E.id,t.agentId]),N++;}catch($){ve.warn("consolidate: archive write failed",{factId:E.id,error:errorMeta($)});}}}let C=u.length,p=0,I=0;return ve.debug("consolidate complete",{agentId:t.agentId,totalFacts:C,dedupedCount:f,compressedCount:p,archivedCount:N,skippedCount:I,dryRun:n,durationMs:Date.now()-a}),{totalFacts:C,dedupedCount:f,compressedCount:p,archivedCount:N,skippedCount:I,durationMs:Date.now()-a}}catch(u){throw ServiceError.isInstance(u)?u:new ServiceError({code:"INTERNAL",message:`consolidate failed: ${errorMeta(u).message}`,details:{cause:errorMeta(u).message}})}finally{d.close();}}catch(y){var R=y,h=true;}finally{c(b$1,R,h);}}var z=Log.create({service:"memory.service.sync"}),Cr=30,Dr=".easbot/memory/active",Mt=".easbot/memory/archive";function Nr(t,e){let r=t.query("SELECT node_id FROM fact_nodes WHERE fact_id = ?",[e.id]).map(n=>n.node_id).filter(n=>typeof n=="number");return {id:e.id,agentId:e.agent_id,sessionId:e.session_id??void 0,msgId:e.msg_id??void 0,parentMsgId:e.parent_msg_id??void 0,content:e.content,category:e.category,importance:e.importance,source:e.source,tags:e.tags?JSON.parse(e.tags):void 0,nodeIds:r.length>0?r:void 0,filePath:e.file_path??void 0,createdAt:e.created_at,updatedAt:e.updated_at}}async function Or(t,e){let a=0,r=0,n=0,{where:s,params:i}=t.agentFilter(e.agentId),d=t.query(`SELECT id, agent_id, session_id, msg_id, parent_msg_id, content, category, importance,
|
|
53
|
+
source, tags, file_path, created_at, updated_at
|
|
54
|
+
FROM memory_facts ${s}
|
|
55
|
+
ORDER BY created_at ASC`,i);for(let b of d){let y=Nr(t,b);if(b.file_path?.startsWith(`${Mt}/`)){r++;continue}let R=we(y,e.workspaceDir);try{await ae.access(R),r++;continue}catch(u){let g=u;if(g.code!=="ENOENT"){z.warn("sync generate: fs.access failed (non-ENOENT)",{factId:y.id,absPath:R,error:errorMeta(g)}),n++;continue}}let h=await ge.write(y,e.workspaceDir);h.ok?a++:(n++,z.warn("sync generate: factFileSync.write failed",{factId:y.id,absPath:R,error:h.error}));}return z.debug("sync stage A complete",{agentId:e.agentId,generatedCount:a,skippedCount:r,failedGenerateCount:n}),{generatedCount:a,skippedCount:r,failedGenerateCount:n}}async function Tr(t,e,a,r){let n=a*24*60*60*1e3,s=Date.now(),i=formatLocalISO(new Date(s-n)),d=[],b=[],y=Ee.join(e.workspaceDir,Dr),R=await Pr(y);z.debug("sync stage B: scan active dir",{activeDir:y,fileCount:R.length,windowDays:a,threshold:i,dryRun:r});for(let h of R){let u=await Ar(h);if(!u){z.warn("sync stage B: skip unparseable file",{absPath:h});continue}let{firstCreatedAt:g,firstFactId:f}=u,O=new Date(g).getTime();if(Number.isNaN(O)){z.warn("sync stage B: skip invalid createdAt",{absPath:h,firstCreatedAt:g});continue}if(s-O<=n)continue;let M=kr(h);if(!M){z.warn("sync stage B: cannot infer category from path",{absPath:h});continue}let D=g.slice(0,7),N=Ee.join(e.workspaceDir,Mt,D,M),C=Ee.basename(h),p=Ee.join(N,C);if(r){d.push({source:h,target:p,firstCreatedAt:g,firstFactId:f});continue}try{await ae.mkdir(N,{recursive:!0});try{await ae.rename(h,p);}catch(E){let c=E;z.warn("sync stage B: fs.rename failed, falling back to copy+unlink",{absPath:h,targetPath:p,error:errorMeta(c)}),await ae.copyFile(h,p),await ae.unlink(h);}let I=le(h,e.workspaceDir),w=le(p,e.workspaceDir);t.run(`UPDATE memory_facts SET file_path = ?
|
|
56
|
+
WHERE agent_id = ? AND file_path = ?`,[w,e.agentId??"",I]),d.push({source:h,target:p,firstCreatedAt:g,firstFactId:f});}catch(I){z.warn("sync stage B: archive failed",{absPath:h,targetPath:p,error:errorMeta(I)}),b.push(h);}}return z.debug("sync stage B complete",{agentId:e.agentId,archivedCount:d.length,failedArchiveCount:b.length,dryRun:r}),{archivedCount:d.length,archiveThreshold:i,archivedRecords:d,failedArchivePaths:b}}async function Pr(t){let e=[];try{await St(t,e);}catch(a){let r=a;if(r.code==="ENOENT")return e;throw z.warn("sync: listActiveMdFiles failed",{activeDir:t,error:errorMeta(r)}),new ServiceError({code:"INTERNAL",message:`sync: listActiveMdFiles failed: ${r.message}`,details:{cause:r.message}})}return e}async function St(t,e){let a=await ae.readdir(t,{withFileTypes:true});for(let r of a){let n=Ee.join(t,r.name);r.isDirectory()?await St(n,e):r.isFile()&&r.name.endsWith(".md")&&e.push(n);}}async function Ar(t){let e;try{e=await ae.readFile(t,"utf-8");}catch(i){if(i.code==="ENOENT")return null;throw i}if(!e.startsWith(`---
|
|
57
|
+
`))return null;let a=e.indexOf(`
|
|
58
|
+
---
|
|
59
|
+
`,4);if(a===-1)return null;let r=e.slice(4,a),n,s;for(let i of r.split(`
|
|
60
|
+
`)){let d=i.trim();if(d.startsWith("created_at:")?n=d.slice(11).trim().replace(/^["']|["']$/g,""):d.startsWith("id:")&&(s=d.slice(3).trim().replace(/^["']|["']$/g,"")),n&&s)break}return !n||!s?null:{firstCreatedAt:n,firstFactId:s}}function kr(t){let e=t.replace(/\\/g,"/").split("/"),a=e.findIndex(s=>s==="active");if(a===-1)return null;let r=e.slice(a+1);return r.length!==2||!r[1].endsWith(".md")?null:r[0]??null}async function _t(t,e$1={}){var d=[];try{let a=Date.now();let r=b(d,z.time("memorySync",{level:"DEBUG",agentId:t.agentId}));j(t);ee(t,"sync");let n=e$1.windowDays??t.config?.archiveDays??Cr;let s=e$1.dryRun??!1;z.debug("sync invoked",{agentId:t.agentId,windowDays:n,dryRun:s,workspaceDir:t.workspaceDir});let i=new e(t.dbPath);try{await i.initialize();let h=await Or(i,t),u=await Tr(i,t,n,s),g={generatedCount:h.generatedCount,skippedCount:h.skippedCount,failedGenerateCount:h.failedGenerateCount,archivedCount:u.archivedCount,failedArchivePaths:u.failedArchivePaths,archiveThreshold:u.archiveThreshold,archivedRecords:u.archivedRecords,windowDays:n,dryRun:s,durationMs:Date.now()-a};if(z.debug("sync complete",{agentId:t.agentId,...g}),g.failedArchivePaths.length>0)throw new ServiceError({code:"INGEST_FAILED",message:`sync: ${g.failedArchivePaths.length} archive(s) failed: ${g.failedArchivePaths.join(", ")}`,details:{failedArchivePaths:g.failedArchivePaths,archivedCount:g.archivedCount}});return g}catch(h){throw ServiceError.isInstance(h)?h:new ServiceError({code:"INTERNAL",message:`sync failed: ${errorMeta(h).message}`,details:{cause:errorMeta(h).message}})}finally{i.close();}}catch(b){var y=b,R=true;}finally{c(d,y,R);}}var Ye=Log.create({service:"memory.service.graph-query"});async function Ct(t,e$1){var O=[];try{let a=Date.now();let r=b(O,Ye.time("memoryGraphQuery",{level:"DEBUG",agentId:t.agentId}));let n=(t.agentId??"").trim()||"default";let s=e$1.scope??"agent_only";let i=typeof e$1.nodeId=="number"&&e$1.nodeId>0;let d=typeof e$1.query=="string"&&e$1.query.trim().length>0;if(!i&&!d)throw new ServiceError({code:"CONTENT_REQUIRED",message:"graphQuery requires either `nodeId` (numeric) or `query` (name fragment for CLI)"});let b$1=s==="both"||s==="shared_only"?3:1;let y=e$1.maxDepth??b$1;let R=e$1.maxNodes??100;let h=e$1.maxEdgesPerNode??10;let u=e$1.type;let g=e$1.relation;Ye.debug("graphQuery invoked",{agentId:n,nodeId:e$1.nodeId,query:e$1.query,type:u,maxDepth:y,maxNodes:R,scope:s,remote:t.remote});let f=new e(t.dbPath);try{await f.initialize();let C=new ce(f.getDb()),p=null;if(i)p=(await C.queryNodes({ids:[e$1.nodeId],agentId:n,scope:s}))[0]??null;else {let T=e$1.query,U=T.includes("*")||T.includes("%")?T:`%${T}%`,l=await C.queryNodes({name:U,...u?{type:u}:{},agentId:n,scope:s,limit:R});p=(T.includes("*")||T.includes("%")?l:l.filter(v=>v.name.toLowerCase().includes(T.toLowerCase())))[0]??null;}if(!p)return {root:null,nodes:[],edges:[],truncated:!1,totalNodes:0,totalEdges:0,scope:s,durationMs:Date.now()-a};let I=await C.queryNeighbors(p.id,y,{agentId:n,scope:s,maxEdgesPerNode:h}),w=new Map;w.set(p.id,p);for(let T of I)w.set(T.id,{id:T.id,name:T.name,type:T.type,createdAt:T.createdAt,updatedAt:T.updatedAt});let E=[];for(let T of I)if(T.edges)for(let U of T.edges)g&&U.relation!==g||E.push(U);let c=Array.from(new Map(E.map(T=>[T.id,T])).values());for(let T of c){if(!w.has(T.source)){let U=await C.queryNodes({ids:[T.source],agentId:n,scope:s});U[0]&&w.set(U[0].id,U[0]);}if(!w.has(T.target)){let U=await C.queryNodes({ids:[T.target],agentId:n,scope:s});U[0]&&w.set(U[0].id,U[0]);}}let S=Array.from(w.values()),_=S.length>R,$=_?S.slice(0,R):S;return Ye.debug("graphQuery complete",{agentId:n,rootId:p.id,nodeCount:$.length,edgeCount:c.length,truncated:_,durationMs:Date.now()-a}),{root:p,nodes:$,edges:c,truncated:_,totalNodes:S.length,totalEdges:c.length,scope:s,durationMs:Date.now()-a}}catch(C){throw ServiceError.isInstance(C)?C:new ServiceError({code:"INTERNAL",message:`graphQuery failed: ${errorMeta(C).message}`,details:{cause:errorMeta(C).message}})}finally{f.close();}}catch(M){var D=M,N=true;}finally{c(O,D,N);}}var ye=Log.create({service:"memory.service.status"}),qr=["user_preference","task_context","technical_fact","decision","relationship","reminder","error_pattern","workflow","exploration_finding","experience_summary","tool_usage","skill_creation","test","other"],$r={};async function Nt(t,e$1={},a=$r){let r=t.agentId&&t.agentId.trim().length>0?t.agentId:void 0;if(ye.debug("status invoked",{agentId:r??"<global>"}),!t.dbPath||t.dbPath.length===0)throw new ServiceError({code:"INTERNAL",message:"`ctx.dbPath` is required"});let n={initialized:false,capabilities:{embedding:false,evaluation:false}},s={},i=0,d$1=0,b=0,y,R,h,u=false,g,f="uninitialized",O=false,M=false,D,N=qr.reduce((c,S)=>(c[S]=0,c),{}),C=new e(t.dbPath);try{await C.initialize(),i=C.query("SELECT COUNT(*) as c FROM memory_facts WHERE agent_id IS NOT NULL",[])[0]?.c??0,d$1=C.query("SELECT COUNT(*) as c FROM nodes",[])[0]?.c??0,b=C.query("SELECT COUNT(*) as c FROM edges")[0]?.c??0;let $=C.query("SELECT category, COUNT(*) as c FROM memory_facts WHERE agent_id IS NOT NULL GROUP BY category",[]);for(let v of $){let P=v.category;P in N&&(N[P]=v.c);}try{O=C.query("SELECT name FROM sqlite_master WHERE type = ? AND name = ?",["table","memory_facts_fts"]).length>0;}catch(v){ye.errorDegradable("status: fts probe failed",{error:errorMeta(v)});}M=C.healthCheck();try{let v=C.query("SELECT key, value FROM meta");for(let P of v)s[P.key]=P.value;}catch(v){ye.errorDegradable("status: meta read failed",{error:errorMeta(v)});}let T=s.schema_version,U=s.extraction_version,l=s.lastSyncAt??s.lastSync,m=s.embeddingDims;y=T&&Number.parseInt(T,10)||void 0,R=U&&Number.parseInt(U,10)||void 0,h=l,g=m&&Number.parseInt(m,10)||void 0,u=g!==void 0||s.vector_enabled==="true"||n.capabilities.embedding===!0,i>0&&(s.index_state==="failed"?f="failed":h?u&&!g?f="partial":f="complete":f="stale");try{D=C.query("SELECT value FROM meta WHERE key = ?",["backend"])[0]?.value??"better-sqlite3";}catch{D="better-sqlite3";}}catch(c){if(ServiceError.isInstance(c))throw c;ye.warn("status: db phase failed; returning partial result",{dbPath:t.dbPath,error:errorMeta(c)}),D="unknown",M=false;}finally{C.close();}let p,I;if(existsSync(t.dbPath)){try{let{statSync:S}=await import('fs');I=S(t.dbPath).size;}catch{}let c=null;try{c=new e(t.dbPath),await c.initialize();let{stats:S}=c.checkIntegrity();p=S;}catch(S){ye.errorDegradable("status: checkIntegrity failed; dbStats segment omitted",{dbPath:t.dbPath,error:errorMeta(S)});}finally{c&&c.close();}}if(!a.skipLlm&&a$1.isInitialized()){let S=a$1.capabilities();n.initialized=true,n.capabilities={embedding:S.embedding===true,evaluation:S.graph===true},n.embeddingModel=n.capabilities.embedding?"configured":void 0,n.evaluationModel=n.capabilities.evaluation?"configured":void 0;}if(!a.skipEmbeddingProbe&&!a.skipLlm&&n.initialized&&n.capabilities.embedding)try{let c=await a$1.probeEmbeddingDims({timeoutMs:5e3});if(typeof c=="number"){g=c,s.embeddingDims=String(c);try{let S=new e(t.dbPath);try{await S.initialize();let _=S.getDb();syncMeta(_,[["embeddingDims",String(c)]]);}finally{S.close();}}catch{}}}catch{}let w=f??"uninitialized",E;return M?f==="uninitialized"?E="Run `easbot memory remember <content>` to add the first fact.":w==="stale"&&(E="Index is stale (factsCount > 0 \u4F46\u7F3A lastSyncAt) \u2014 run `easbot memory sync` to refresh file snapshots."):E="Run `easbot memory init` to initialize the database.",M&&w==="failed"&&(M=false),ye.debug("status complete",{dbPath:t.dbPath,agentId:r??"<global>",factsCount:i,nodesCount:d$1,edgesCount:b,healthy:M}),{package:"memory",workspaceDir:t.workspaceDir,agentId:r,dbPath:t.dbPath,dbSize:I,configPath:await d.getConfigPath(),configExists:await d.exists(),dbStats:p,schemaVersion:y,extractionVersion:R,lastSyncAt:h,indexState:f,vectorEnabled:u,embeddingDims:g,llm:n,backend:D,meta:s,recommendation:E,healthy:M,factsByCategory:N,dbExists:existsSync(t.dbPath),factsCount:i,nodesCount:d$1,edgesCount:b,ftsAvailable:O,integrityStats:p}}var Br=Log.create({service:"memory.service.doctor"}),Ze=100*1024*1024,Ot=100*1024*1024,jr={};function k(t,e,a,r,n){return {code:t.toUpperCase().replace(/[^A-Z0-9]+/g,"_"),severity:e,name:t,message:a,details:n,durationMs:r,passed:e!=="error"}}async function Tt(t,e$1={},a=jr){if(Br.debug("doctor invoked",{agentId:t.agentId}),!t.dbPath||t.dbPath.length===0)throw new NameErrors.MissingFieldError({field:"dbPath",message:"`ctx.dbPath` is required"});let r=[],n=[],s=Date.now(),i=null,d=false,b=Date.now();try{i=new e(t.dbPath),await i.initialize(),d=!0;let l=i.healthCheck(),m=k("database",l?"ok":"error",l?"database connected and writable":"database unhealthy",Date.now()-b,{dbPath:t.dbPath});r.push(m),n.push({name:m.name,passed:m.severity!=="error",message:m.message,details:m.details,severity:m.severity});}catch(l){let m=k("database","error",`database connection failed: ${errorMeta(l).message}`,Date.now()-b,{dbPath:t.dbPath});r.push(m),n.push({name:m.name,passed:false,message:m.message,details:m.details,severity:"error"});}let y=Date.now();if(d&&i)try{let l=i.query("SELECT name FROM sqlite_master WHERE type = ? AND name = ?",["table","memory_facts_fts"]),m=l.length>0,v=k("fts",m?"ok":"warn",m?"FTS5 index available":"FTS5 index not found",Date.now()-y,m?{table:l[0]?.name}:void 0);r.push(v),n.push({name:v.name,passed:v.severity!=="error",message:v.message,details:v.details,severity:v.severity});}catch(l){let m=k("fts","error",`fts probe failed: ${errorMeta(l).message}`,Date.now()-y);r.push(m),n.push({name:m.name,passed:false,message:m.message,details:m.details,severity:"error"});}else {let l=k("fts","info","skipped (db not initialized)",0);r.push(l),n.push({name:l.name,passed:true,message:l.message,severity:"info"});}let R=Date.now(),h=!!t.config?.embeddingLlm,u=k("vector","ok",h?"embedding model available":"no embedding model configured (FTS-only mode, recall still functional)",Date.now()-R,{mode:h?"hybrid":"fts_only",model:h?"configured":"missing"});r.push(u),n.push({name:u.name,passed:true,message:u.message,details:u.details,severity:"ok"});let g=Date.now();if(d&&i)try{let l=["memory_facts","nodes","edges","meta"],m=i.query("SELECT name FROM sqlite_master WHERE type = ?",["table"]),v=new Set(m.map(W=>W.name)),P=l.filter(W=>!v.has(W)),x=k("schema",P.length===0?"ok":"error",P.length===0?`schema complete (${l.length} tables)`:`missing tables: ${P.join(", ")}`,Date.now()-g,{required:l,existing:Array.from(v)});r.push(x),n.push({name:x.name,passed:x.severity!=="error",message:x.message,details:x.details,severity:x.severity});}catch(l){let m=k("schema","error",`schema probe failed: ${errorMeta(l).message}`,Date.now()-g);r.push(m),n.push({name:m.name,passed:false,message:m.message,details:m.details,severity:"error"});}else {let l=k("schema","info","skipped (db not initialized)",0);r.push(l),n.push({name:l.name,passed:true,message:l.message,severity:"info"});}let f=Date.now();try{let l=`${t.dbPath}-wal`,m=`${t.dbPath}-shm`,v=0,P=0;try{v=(await ae.stat(l)).size;}catch{v=0;}try{P=(await ae.stat(m)).size;}catch{P=0;}let x=v+P,W=x<=Ot,Q=k("lock",W?"ok":"warn",W?`no lock contention (wal+shm ${(x/1024).toFixed(1)} KB)`:`WAL/SHM files unusually large (${(x/1024/1024).toFixed(1)} MB > ${(Ot/1024/1024).toFixed(0)} MB threshold)`,Date.now()-f,{walBytes:v,shmBytes:P});r.push(Q),n.push({name:Q.name,passed:Q.severity!=="error",message:Q.message,details:Q.details,severity:Q.severity});}catch(l){let m=k("lock","error",`lock probe failed: ${errorMeta(l).message}`,Date.now()-f);r.push(m),n.push({name:m.name,passed:false,message:m.message,details:m.details,severity:"error"});}let O=Date.now();try{let l=Ee.dirname(t.dbPath),m=await ae.statfs(l),v=typeof m.bsize=="bigint"?Number(m.bsize)*m.bavail:m.bsize*m.bavail,P=v>=Ze,x=k("disk_space",P?"ok":"error",P?`sufficient disk space (${(v/1024/1024).toFixed(1)} MB available)`:`low disk space (${(v/1024/1024).toFixed(1)} MB < ${(Ze/1024/1024).toFixed(0)} MB threshold)`,Date.now()-O,{availableBytes:v,threshold:Ze});r.push(x),n.push({name:x.name,passed:x.severity!=="error",message:x.message,details:x.details,severity:x.severity});}catch(l){let m=k("disk_space","error",`disk_space probe failed: ${errorMeta(l).message}`,Date.now()-O);r.push(m),n.push({name:m.name,passed:false,message:m.message,details:m.details,severity:"error"});}let M=Date.now();if(d&&i)try{let l=i.agentFilter(t.agentId),v=i.query(`SELECT COUNT(*) as c FROM memory_facts ${l.where}`,l.params)[0]?.c??0;if(v===0){let P=k("fact_node_consistency","info","no facts in db \u2014 nothing to check",Date.now()-M);r.push(P),n.push({name:P.name,passed:!0,message:P.message,severity:"info"});}else {let x=i.query(`SELECT COUNT(DISTINCT fn.fact_id) as c
|
|
61
|
+
FROM fact_nodes fn
|
|
62
|
+
INNER JOIN memory_facts mf ON mf.id = fn.fact_id
|
|
63
|
+
${l.where}`,l.params)[0]?.c??0,W=v>0?x/v*100:0,Q=W>=50?"ok":W>=30?"info":"warn",K=W>=50?`${W.toFixed(1)}% facts linked to KG nodes`:W>=30?`${W.toFixed(1)}% facts linked to KG nodes \u2014 run \`easbot memory remember\` to improve`:`${W.toFixed(1)}% facts linked to KG nodes \u2014 KG extraction may be disabled`,ie=k("fact_node_consistency",Q,K,Date.now()-M,{facts:v,linked:x,pct:W});r.push(ie),n.push({name:ie.name,passed:ie.severity!=="error",message:ie.message,details:ie.details,severity:ie.severity});}}catch(l){let m=k("fact_node_consistency","warn",`fact_node_consistency probe failed: ${errorMeta(l).message}`,Date.now()-M);r.push(m),n.push({name:m.name,passed:false,message:m.message,details:m.details,severity:"warn"});}else {let l=k("fact_node_consistency","info","skipped (db not initialized)",0);r.push(l),n.push({name:l.name,passed:true,message:l.message,severity:"info"});}let D=Date.now();if(d&&i)try{let m=i.query("SELECT COUNT(*) as c FROM nodes",[])[0]?.c??0;if(m===0){let v=k("node_embedding_coverage","info","no nodes in KG \u2014 nothing to check",Date.now()-D);r.push(v),n.push({name:v.name,passed:!0,message:v.message,severity:"info"});}else {let P=i.query("SELECT COUNT(*) as c FROM nodes WHERE embedding IS NOT NULL",[])[0]?.c??0,x=m>0?P/m*100:0,W=x>=50?"ok":x>=30?"info":"warn",Q=x>=50?`${x.toFixed(1)}% nodes have embedding (${P}/${m})`:x>=30?`${x.toFixed(1)}% nodes have embedding (${P}/${m}) \u2014 GraphRAG entity vector partial`:`${x.toFixed(1)}% nodes have embedding (${P}/${m}) \u2014 GraphRAG entity vector disabled`,K=k("node_embedding_coverage",W,Q,Date.now()-D,{total:m,withEmbedding:P,pct:x});r.push(K),n.push({name:K.name,passed:K.severity!=="error",message:K.message,details:K.details,severity:K.severity});}}catch(l){let m=k("node_embedding_coverage","warn",`node_embedding_coverage probe failed: ${errorMeta(l).message}`,Date.now()-D);r.push(m),n.push({name:m.name,passed:false,message:m.message,details:m.details,severity:"warn"});}else {let l=k("node_embedding_coverage","info","skipped (db not initialized)",0);r.push(l),n.push({name:l.name,passed:true,message:l.message,severity:"info"});}let N=Date.now();if(d&&i)try{let m=i.query(`SELECT fn.fact_id, fn.node_id
|
|
64
|
+
FROM fact_nodes fn
|
|
65
|
+
LEFT JOIN nodes n ON fn.node_id = n.id
|
|
66
|
+
WHERE n.id IS NULL
|
|
67
|
+
LIMIT 100`).map(P=>`${P.fact_id}->${P.node_id}`),v=k("orphan",m.length===0?"ok":"warn",m.length===0?"no orphan KG references (fact_nodes all resolved)":`${m.length} orphan fact_nodes references: ${m.slice(0,5).join(", ")}${m.length>5?", ...":""}`,Date.now()-N,{count:m.length});r.push(v),n.push({name:v.name,passed:v.severity!=="error",message:v.message,details:v.details,severity:v.severity});}catch(l){let m=k("orphan","warn",`orphan probe failed: ${errorMeta(l).message}`,Date.now()-N);r.push(m),n.push({name:m.name,passed:false,message:m.message,details:m.details,severity:"warn"});}else {let l=k("orphan","info","skipped (db not initialized)",0);r.push(l),n.push({name:l.name,passed:true,message:l.message,severity:"info"});}let C=Date.now(),p={"better-sqlite3":false,"node:sqlite":false,"@tursodatabase/database":false};try{let l=createRequire(import.meta.url);try{l.resolve("better-sqlite3"),p["better-sqlite3"]=!0;}catch{}p["node:sqlite"]=typeof process.versions.sqlite=="string";try{l.resolve("@tursodatabase/database"),p["@tursodatabase/database"]=!0;}catch{}}catch{}let I=p["better-sqlite3"]||p["node:sqlite"],w=k("backend",I?"ok":"error",I?`SQLite backend available (better-sqlite3: ${p["better-sqlite3"]}, node:sqlite: ${p["node:sqlite"]})`:"no SQLite backend available (install better-sqlite3 or use Node 22.5+)",Date.now()-C,p);r.push(w),n.push({name:w.name,passed:w.severity!=="error",message:w.message,details:w.details,severity:w.severity});let E=Date.now();if(d&&i)try{let l=i.query("SELECT COUNT(*) as c FROM embedding_cache")[0],m=i.agentFilter(t.agentId),v=i.query(`SELECT COUNT(*) as c FROM memory_facts ${m.where}`,m.params)[0],P=l?.c??0,x=v?.c??0,W=Math.max(0,P-x),Q=W>0,K=k("embedding_cache_unused","info",Q?`by design: ${W} embedding_cache rows remain after fact deletion (cache is global content-hash dedup; forget intentionally doesn't cascade clear cache to preserve same-content hit rate)`:"embedding_cache in sync with memory_facts (no unused rows)",Date.now()-E,{cacheCount:P,factsCount:x,unused:W,policy:"global_content_hash_dedup"});r.push(K),n.push({name:K.name,passed:!Q,message:K.message,details:K.details,severity:"info"});}catch(l){let m=k("embedding_cache_unused","info",`embedding_cache_unused probe failed: ${errorMeta(l).message}`,Date.now()-E);r.push(m),n.push({name:m.name,passed:true,message:m.message,severity:"info"});}else {let l=k("embedding_cache_unused","info","skipped (db not initialized)",0);r.push(l),n.push({name:l.name,passed:true,message:l.message,severity:"info"});}let c=Date.now(),S;if(d&&i)try{let l=i.query("SELECT value FROM meta WHERE key = ?",["embeddingDims"]);S=l[0]?.value&&Number.parseInt(l[0].value,10)||void 0;}catch{}let _;if(a.skipLlm||!a$1.isInitialized()||!a$1.capabilities().embedding)_=k(EMBEDDING_DIMS_CONSISTENCY_CHECK,"info","llm not initialized; probe skipped",Date.now()-c);else if(a.skipEmbeddingProbe)_=k(EMBEDDING_DIMS_CONSISTENCY_CHECK,"info","probe skipped (--skip-embedding-probe)",Date.now()-c);else try{let l=await a$1.probeEmbeddingDims({timeoutMs:5e3});typeof l!="number"?_=k(EMBEDDING_DIMS_CONSISTENCY_CHECK,"info","probe failed (network / model error)",Date.now()-c):S===void 0?_=k(EMBEDDING_DIMS_CONSISTENCY_CHECK,"info",`probe=${l}, meta missing \u2014 next status will sync`,Date.now()-c):l!==S?_=k(EMBEDDING_DIMS_CONSISTENCY_CHECK,"warn",`probe=${l}, meta=${S} \u2014 mismatch`,Date.now()-c,{probe:l,meta:S}):_=k(EMBEDDING_DIMS_CONSISTENCY_CHECK,"ok",`probe=${l}, meta=${S} \u2014 consistent`,Date.now()-c);}catch(l){_=k(EMBEDDING_DIMS_CONSISTENCY_CHECK,"info",`probe threw: ${errorMeta(l).message}`,Date.now()-c);}r.push({..._,details:_.details??void 0,passed:_.severity!=="error"}),n.push({name:_.name,passed:_.severity!=="error",message:_.message,details:_.details??void 0,severity:_.severity});let $;if(d&&i){let l=Date.now();try{let{issues:m,stats:v}=i.checkIntegrity();$=v;for(let P of m)r.push(k("integrity_stats",P.severity,P.message,0,{source:"database.checkIntegrity"}));}catch(m){r.push(k("integrity_stats","warn",`db integrity check failed: ${errorMeta(m).message}`,Date.now()-l));}}let T=!r.some(l=>l.severity==="error");i&&i.close();let U=Date.now()-s;return {healthy:T,checks:r,legacyChecks:n,durationMs:U,integrityStats:$,backendAvailable:p}}var Y=Log.create({service:"memory.service.init"}),Pt=false;async function Kr(){Pt||(await ServiceErrorBus.init(),await b$1(),Pt=true);}async function Vr(t){try{let{Config:e}=await import('@easbot/llm'),a=await e.get(),r=n=>typeof n=="string"&&n.length>0?n:void 0;return {embeddingModel:r(a.embedding_model),graphModel:r(a.graph_model)}}catch{return {}}}async function At(t,e$1={}){var u=[];try{let a=Date.now();let r=b(u,Y.time("memoryInit",{level:"DEBUG",agentId:t.agentId}));await Kr();ee(t,"init");let n=t.workspaceDir;let s=e$1.dbPath??t.dbPath;if(!n||n.trim().length===0)throw new ServiceError({code:"CONTENT_REQUIRED",message:"init requires non-empty `workspaceDir` (ctx.workspaceDir or params.workspaceDir)"});if(!s||s.trim().length===0)throw new ServiceError({code:"CONTENT_REQUIRED",message:"init requires non-empty `dbPath` (ctx.dbPath or params.dbPath)"});let i=t.agentId?.trim()??"";let d$1=e$1.force??!1;Y.debug("init invoked",{agentId:i,workspaceDir:n,dbPath:s,force:d$1});let b$1=await d.getConfigPath();if(!d$1&&await d.exists())return Y.info("init: idempotent skip (memory.json exists, no --force)",{workspaceDir:n,configPath:b$1}),{initialized:!1,dbPath:s,configPath:b$1,configCreated:!1,schemaVersion:a$2,workspaceDir:n,tablesCreated:0,migrationsApplied:0,durationMs:0};try{await ae.mkdir(Ee.dirname(s),{recursive:!0}),await ae.mkdir(Ee.join(n,".easbot","memory","active"),{recursive:!0}),await ae.mkdir(Ee.join(n,"archive"),{recursive:!0}),await ae.mkdir(Ee.join(n,".easbot"),{recursive:!0});}catch(M){throw new ServiceError({code:"INTERNAL",message:`init: failed to create directories: ${errorMeta(M).message}`,details:{cause:errorMeta(M).message}})}if(d$1)for(let M of [s,`${s}-wal`,`${s}-shm`])try{await ae.rm(M,{force:!0});}catch(D){Y.warn("init: force rm failed (may not exist)",{path:M,error:errorMeta(D)});}let y=await Vr(n);let R=!1;try{!await d.exists()||d$1?(await d.writeMemoryJson({version:1,schema_version:a$2,backend:"better-sqlite3",created_at:new Date().toISOString(),embedding_model:y.embeddingModel??null,graph_model:y.graphModel??null,archive_days:t.config?.archiveDays??30,short_term_max_rounds:t.config?.shortTermMaxRounds??20}),R=!0,Y.info("init: memory.json written",{configPath:b$1,force:d$1,configCreated:R})):Y.debug("init: memory.json already exists, skipping write",{configPath:b$1});}catch(M){Y.warn("init: memory.json write failed (non-fatal)",{configPath:b$1,error:errorMeta(M)});}let h=new e(s);try{let M=await ae.stat(s).then(()=>!0).catch(()=>!1);await h.initialize();let D=new Date().toISOString(),N=[["version","1.0.0"],["schemaVersion",String(a$2)],["createdAt",D],["defaultAgentId",i]];for(let[I,w]of N)try{h.run("INSERT OR IGNORE INTO meta (key, value) VALUES (?, ?)",[I,w]);}catch(E){Y.warn("init: meta insert failed",{key:I,error:errorMeta(E)});}let C=0;try{C=h.prepare("SELECT COUNT(*) as n FROM sqlite_master WHERE type IN ('table', 'index', 'trigger', 'view')").get()?.n??0;}catch(I){Y.warn("init: tablesCreated count failed",{error:errorMeta(I)});}let p=0;try{p=h.prepare("SELECT id FROM schema_migrations").all().length;}catch(I){Y.warn("init: migrationsApplied count failed",{error:errorMeta(I)});}return Y.debug("init complete",{agentId:i,workspaceDir:n,dbPath:s,configPath:b$1,configCreated:R,schemaVersion:a$2,durationMs:Date.now()-a}),{initialized:!0,dbPath:s,configPath:b$1,configCreated:R,schemaVersion:a$2,workspaceDir:n,tablesCreated:C,migrationsApplied:p,durationMs:Date.now()-a}}catch(M){throw new ServiceError({code:"INTERNAL",message:`init failed: ${errorMeta(M).message}`,details:{cause:errorMeta(M).message}})}finally{h.close();}}catch(g){var f=g,O=true;}finally{c(u,f,O);}}var et={name:"recall",scope:"read",schema:Ne,annotations:{localOnly:false,requiresAgentId:true,defaultDescription:"Query memory via hybrid search (FTS + vector); returns ranked facts.",readOnlyHint:true,destructiveHint:false,idempotentHint:true},handler:async(t,e)=>{let r=Ne.parse(t);if(!e.agentId?.trim())throw new NameErrors.MissingFieldError({field:"agentId",message:"recall: agentId is required"});return ft({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:e.remote??false,config:e.config,agentId:e.agentId},r)}};var tt={name:"remember",scope:"write",schema:Oe,annotations:{localOnly:false,requiresAgentId:true,defaultDescription:"Persist a new self-memory fact; auto-extract entities into KG.",readOnlyHint:false,destructiveHint:false,idempotentHint:false},handler:async(t,e)=>{let r=Oe.parse(t);if(!e.agentId?.trim())throw new NameErrors.MissingFieldError({field:"agentId",message:"remember: agentId is required"});return ht({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:e.remote??false,config:e.config,agentId:e.agentId},r)}};var rt={name:"update",scope:"write",schema:Te,annotations:{localOnly:false,requiresAgentId:true,defaultDescription:"Update an existing memory fact (atomic; preserves factId + KG associations).",readOnlyHint:false,destructiveHint:false,idempotentHint:true},handler:async(t,e)=>{let r=Te.parse(t);if(!e.agentId?.trim())throw new NameErrors.MissingFieldError({field:"agentId",message:"update: agentId is required"});return bt({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:e.remote??false,config:e.config,agentId:e.agentId},r)}};var nt={name:"forget",scope:"write",schema:Pe,annotations:{localOnly:false,requiresAgentId:true,defaultDescription:"Delete memory facts by id / category / time range; supports dryRun.",readOnlyHint:false,destructiveHint:true,idempotentHint:true},handler:async(t,e)=>{let r=Pe.parse(t);if(!e.agentId?.trim())throw new NameErrors.MissingFieldError({field:"agentId",message:"forget: agentId is required"});return wt({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:e.remote??false,config:e.config,agentId:e.agentId},r)}};var ot={name:"extract",scope:"write",schema:Ae,annotations:{localOnly:false,requiresAgentId:true,defaultDescription:"Extract facts from a session (server-side pulls messages by lastN).",readOnlyHint:false,destructiveHint:false,idempotentHint:true},handler:async(t,e)=>{let r=Ae.parse(t);if(!e.agentId?.trim())throw new NameErrors.MissingFieldError({field:"agentId",message:"extract: agentId is required"});return It({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:e.remote??false,config:e.config,agentId:e.agentId},r)}};var at={name:"consolidate",scope:"admin",schema:ke,annotations:{localOnly:true,requiresAgentId:true,defaultDescription:"Run consolidation pipeline: dedup \u2192 archive.",readOnlyHint:false,destructiveHint:true,idempotentHint:true},handler:async(t,e)=>{let r=ke.parse(t);if(!e.isTrustedLocal)throw new a$3.TrustedLocalOnlyError({message:"consolidate: only trusted local process can invoke this op",op:"consolidate"});if(!e.agentId?.trim())throw new NameErrors.MissingFieldError({field:"agentId",message:"consolidate: agentId is required"});return Rt({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:false,config:e.config,agentId:e.agentId},r)}};var st={name:"sync",scope:"admin",schema:$e,annotations:{localOnly:true,requiresAgentId:true,defaultDescription:"Sync memory facts to .md files (idempotent skip on existing) and archive expired active files (default 30 days)",readOnlyHint:false,destructiveHint:true,idempotentHint:true},handler:async(t,e)=>{let r=$e.parse(t);if(!e.isTrustedLocal)throw new a$3.TrustedLocalOnlyError({message:"sync: only trusted local process can invoke this op",op:"sync"});if(!e.agentId?.trim())throw new NameErrors.MissingFieldError({field:"agentId",message:"sync: agentId is required"});return _t({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:false,config:e.config,agentId:e.agentId},r)}};var it={name:"graph_query",scope:"read",schema:xe,annotations:{localOnly:false,requiresAgentId:true,defaultDescription:"BFS KG neighbor walk from nodeId (default depth=2, maxNodes=100, maxEdgesPerNode=10/100); CLI may also use name fragment via `query`.",readOnlyHint:true,destructiveHint:false,idempotentHint:true},handler:async(t,e)=>{let r=xe.parse(t),n=e.agentId?.trim()||"default";return Ct({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:e.remote??false,config:e.config,agentId:n},r)}};var dt={name:"status",scope:"read",schema:Fe,annotations:{localOnly:false,requiresAgentId:false,defaultDescription:"Memory system status (factsCount / nodesCount / edgesCount / fts / vector).",readOnlyHint:true,destructiveHint:false,idempotentHint:true},handler:async(t,e)=>{let r=Fe.parse(t??{})??{}??{};return Nt({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:e.remote??false,config:e.config,agentId:e.agentId},r)}};var ct={name:"doctor",scope:"admin",schema:Le,annotations:{localOnly:true,requiresAgentId:false,defaultDescription:"Run 7 health checks (database / fts / vector / schema / lock / disk_space / orphan).",readOnlyHint:true,destructiveHint:false,idempotentHint:true},handler:async(t,e)=>{let r=Le.parse(t??{})??{}??{};if(!e.isTrustedLocal)throw new a$3.TrustedLocalOnlyError({message:"doctor: only trusted local process can invoke this op",op:"doctor"});return Tt({workspaceDir:e.workspaceDir??"",rootDir:e.workspaceDir??"",dbPath:e.dbPath??"",locale:e.locale??"en-US",remote:false,config:e.config,agentId:e.agentId},r)}};var mt={name:"init",scope:"admin",schema:qe,annotations:{localOnly:true,requiresAgentId:false,defaultDescription:"Initialize memory workspace (dirs + db schema + meta).",readOnlyHint:false,destructiveHint:false,idempotentHint:true},handler:async(t,e)=>{if(!e.isTrustedLocal)throw new a$3.TrustedLocalOnlyError({message:"init: only trusted local process can invoke this op",op:"init"});let r=qe.parse(t??{})??{}??{},n=e.workspaceDir??"";return At({workspaceDir:n,rootDir:n,dbPath:r.dbPath??e.dbPath??"",locale:e.locale??"en-US",remote:false,config:e.config,agentId:e.agentId??""},r)}};var xt={[et.name]:et,[tt.name]:tt,[rt.name]:rt,[nt.name]:nt,[ot.name]:ot,[at.name]:at,[st.name]:st,[it.name]:it,[dt.name]:dt,[ct.name]:ct,[mt.name]:mt},kt=Object.values(xt);function on(t,e,a){if(t.annotations.localOnly&&!e.isTrustedLocal)throw new a$3.TrustedLocalOnlyError({message:`MEMORY:executeOp: op "${a}" is localOnly; non-trusted caller rejected`,op:a});if(t.annotations.requiresAgentId){let r=e.agentId?.trim()??"";if(r.length===0)throw new NameErrors.MissingFieldError({field:"agentId",message:`MEMORY:executeOp: op "${a}" requires agentId`});e.agentId=r;}}async function Gs(t,e,a){let r=xt[t];if(!r)throw new a$3.UnknownOperationError({message:`executeOp: unknown op "${t}"; available: ${kt.map(s=>s.name).join(", ")}`,name:t,available:kt.map(s=>s.name).join(", ")});return on(r,a,t),await r.handler(e,a)}function dn(t){let e=t.dbPath??"";return {workspaceDir:t.workspaceDir??"",database:{path:e},embeddingLlm:a$1.getEmbedding(),graphLlm:a$1.getGraph(),search:DEFAULT_SEARCH_CONFIG,indexer:{batchSize:20,ignorePatterns:[],incremental:true},archiveDays:30,shortTermMaxRounds:20}}function Xs(t,e,a={}){let r=j$1(e),n=Locale.resolveLocaleLang(a.locale);return {agentId:t,dbPath:r,workspaceDir:e,rootDir:e,config:dn({dbPath:r,workspaceDir:e}),isTrustedLocal:true,locale:n,remote:false,...a}}export{dn as A,Xs as B,ce as a,ft as b,Ne as c,Oe as d,Te as e,Pe as f,Ae as g,ke as h,xe as i,Fe as j,Le as k,qe as l,$e as m,ht as n,bt as o,wt as p,It as q,Rt as r,_t as s,Ct as t,Nt as u,Tt as v,At as w,xt as x,kt as y,Gs as z};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import e from'zod';import {NamedError,ServiceErrorBus}from'@easbot/utils';var o;(r=>(r.DatabaseNotInitializedError=NamedError.create("MemoryDatabaseNotInitializedError",e.object({message:e.string(),method:e.string().optional()})),r.MigrationFailedError=NamedError.create("MemoryMigrationFailedError",e.object({message:e.string(),errSummary:e.string().optional()})),r.DatabaseOperationFailedError=NamedError.create("MemoryDatabaseOperationFailedError",e.object({message:e.string(),operation:e.string()})),r.EmbeddingModelNotConfiguredError=NamedError.create("MemoryEmbeddingModelNotConfiguredError",e.object({message:e.string()})),r.EmbeddingGenerationFailedError=NamedError.create("MemoryEmbeddingGenerationFailedError",e.object({message:e.string()})),r.InvalidEmbeddingResultError=NamedError.create("MemoryInvalidEmbeddingResultError",e.object({message:e.string()})),r.LlmNotInitializedError=NamedError.create("MemoryLlmNotInitializedError",e.object({message:e.string()})),r.TokenizerNotInitializedError=NamedError.create("MemoryTokenizerNotInitializedError",e.object({message:e.string()})),r.UnsupportedOperationError=NamedError.create("MemoryUnsupportedOperationError",e.object({message:e.string(),opName:e.string(),renderer:e.string().optional()})),r.TrustedLocalOnlyError=NamedError.create("MemoryTrustedLocalOnlyError",e.object({message:e.string(),op:e.string().optional()})),r.MissingMcpHandlerError=NamedError.create("MemoryMissingMcpHandlerError",e.object({message:e.string(),toolName:e.string()})),r.UnknownOperationError=NamedError.create("MemoryUnknownOperationError",e.object({message:e.string(),name:e.string(),available:e.string().optional()})),r.NotFoundError=NamedError.create("NotFoundError",e.object({message:e.string(),memoryId:e.string().optional(),candidates:e.array(e.unknown()).optional()})),r.AmbiguousError=NamedError.create("AmbiguousError",e.object({message:e.string(),query:e.string().optional(),candidates:e.array(e.unknown())})),r.AgentIdRequiredError=NamedError.create("AgentIdRequiredError",e.object({message:e.string()})),r.TrustDeniedError=NamedError.create("TrustDeniedError",e.object({message:e.string(),operation:e.string().optional(),reason:e.string().optional()})),r.HasReferencesError=NamedError.create("HasReferencesError",e.object({message:e.string(),memoryId:e.string().optional(),referenceCount:e.number().optional()})),r.DryRunNoDeleteError=NamedError.create("DryRunNoDeleteError",e.object({message:e.string(),matchedCount:e.number().optional()})),r.MaxDeleteExceededError=NamedError.create("MaxDeleteExceededError",e.object({message:e.string(),matched:e.number().optional(),maxDelete:e.number().optional()}))))(o||(o={}));var a=new Set(["AGENT_ID_REQUIRED","SESSION_ID_REQUIRED","CONTENT_REQUIRED","INTERNAL","NOT_FOUND","AMBIGUOUS","NOT_INDEXED","OPTIONAL_DEP_MISSING","TRUST_DENIED","PATH_TRAVERSAL","CATEGORY_REQUIRED","IMPORTANCE_REQUIRED","TIMERANGE_REQUIRED","INGEST_FAILED","UNSUPPORTED_FORMAT","HAS_REFERENCES","DRY_RUN_NO_DELETE","MAX_DELETE_EXCEEDED","JOB_NOT_FOUND","JOB_TIMEOUT","JOB_FAILED"]),s={DRY_RUN_NO_DELETE:"dryRun preview only; call again with force=false to actually delete (or accept the preview)",HAS_REFERENCES:"memory has KG references; call again with force=true to delete ignoring references",MAX_DELETE_EXCEEDED:"too many candidates match the query; narrow query (smaller timeRange / category) or raise maxDelete",AGENT_ID_REQUIRED:"memory operations require ctx.agentId; pass agentId via MemoryServiceContext",SESSION_ID_REQUIRED:"extract requires sessionId; pass the conversation session id",CATEGORY_REQUIRED:"remember op requires category (task_context / user_preference / etc.)",IMPORTANCE_REQUIRED:"importance must be an integer in [1, 10]"};async function f(){await ServiceErrorBus.register("memory",a,s);}export{o as a,f as b};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
'use strict';var e=require('zod'),utils=require('@easbot/utils');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var e__default=/*#__PURE__*/_interopDefault(e);exports.a=void 0;(r=>(r.DatabaseNotInitializedError=utils.NamedError.create("MemoryDatabaseNotInitializedError",e__default.default.object({message:e__default.default.string(),method:e__default.default.string().optional()})),r.MigrationFailedError=utils.NamedError.create("MemoryMigrationFailedError",e__default.default.object({message:e__default.default.string(),errSummary:e__default.default.string().optional()})),r.DatabaseOperationFailedError=utils.NamedError.create("MemoryDatabaseOperationFailedError",e__default.default.object({message:e__default.default.string(),operation:e__default.default.string()})),r.EmbeddingModelNotConfiguredError=utils.NamedError.create("MemoryEmbeddingModelNotConfiguredError",e__default.default.object({message:e__default.default.string()})),r.EmbeddingGenerationFailedError=utils.NamedError.create("MemoryEmbeddingGenerationFailedError",e__default.default.object({message:e__default.default.string()})),r.InvalidEmbeddingResultError=utils.NamedError.create("MemoryInvalidEmbeddingResultError",e__default.default.object({message:e__default.default.string()})),r.LlmNotInitializedError=utils.NamedError.create("MemoryLlmNotInitializedError",e__default.default.object({message:e__default.default.string()})),r.TokenizerNotInitializedError=utils.NamedError.create("MemoryTokenizerNotInitializedError",e__default.default.object({message:e__default.default.string()})),r.UnsupportedOperationError=utils.NamedError.create("MemoryUnsupportedOperationError",e__default.default.object({message:e__default.default.string(),opName:e__default.default.string(),renderer:e__default.default.string().optional()})),r.TrustedLocalOnlyError=utils.NamedError.create("MemoryTrustedLocalOnlyError",e__default.default.object({message:e__default.default.string(),op:e__default.default.string().optional()})),r.MissingMcpHandlerError=utils.NamedError.create("MemoryMissingMcpHandlerError",e__default.default.object({message:e__default.default.string(),toolName:e__default.default.string()})),r.UnknownOperationError=utils.NamedError.create("MemoryUnknownOperationError",e__default.default.object({message:e__default.default.string(),name:e__default.default.string(),available:e__default.default.string().optional()})),r.NotFoundError=utils.NamedError.create("NotFoundError",e__default.default.object({message:e__default.default.string(),memoryId:e__default.default.string().optional(),candidates:e__default.default.array(e__default.default.unknown()).optional()})),r.AmbiguousError=utils.NamedError.create("AmbiguousError",e__default.default.object({message:e__default.default.string(),query:e__default.default.string().optional(),candidates:e__default.default.array(e__default.default.unknown())})),r.AgentIdRequiredError=utils.NamedError.create("AgentIdRequiredError",e__default.default.object({message:e__default.default.string()})),r.TrustDeniedError=utils.NamedError.create("TrustDeniedError",e__default.default.object({message:e__default.default.string(),operation:e__default.default.string().optional(),reason:e__default.default.string().optional()})),r.HasReferencesError=utils.NamedError.create("HasReferencesError",e__default.default.object({message:e__default.default.string(),memoryId:e__default.default.string().optional(),referenceCount:e__default.default.number().optional()})),r.DryRunNoDeleteError=utils.NamedError.create("DryRunNoDeleteError",e__default.default.object({message:e__default.default.string(),matchedCount:e__default.default.number().optional()})),r.MaxDeleteExceededError=utils.NamedError.create("MaxDeleteExceededError",e__default.default.object({message:e__default.default.string(),matched:e__default.default.number().optional(),maxDelete:e__default.default.number().optional()}))))(exports.a||(exports.a={}));var a=new Set(["AGENT_ID_REQUIRED","SESSION_ID_REQUIRED","CONTENT_REQUIRED","INTERNAL","NOT_FOUND","AMBIGUOUS","NOT_INDEXED","OPTIONAL_DEP_MISSING","TRUST_DENIED","PATH_TRAVERSAL","CATEGORY_REQUIRED","IMPORTANCE_REQUIRED","TIMERANGE_REQUIRED","INGEST_FAILED","UNSUPPORTED_FORMAT","HAS_REFERENCES","DRY_RUN_NO_DELETE","MAX_DELETE_EXCEEDED","JOB_NOT_FOUND","JOB_TIMEOUT","JOB_FAILED"]),s={DRY_RUN_NO_DELETE:"dryRun preview only; call again with force=false to actually delete (or accept the preview)",HAS_REFERENCES:"memory has KG references; call again with force=true to delete ignoring references",MAX_DELETE_EXCEEDED:"too many candidates match the query; narrow query (smaller timeRange / category) or raise maxDelete",AGENT_ID_REQUIRED:"memory operations require ctx.agentId; pass agentId via MemoryServiceContext",SESSION_ID_REQUIRED:"extract requires sessionId; pass the conversation session id",CATEGORY_REQUIRED:"remember op requires category (task_context / user_preference / etc.)",IMPORTANCE_REQUIRED:"importance must be an integer in [1, 10]"};async function M(){await utils.ServiceErrorBus.register("memory",a,s);}exports.b=M;
|