@alexandrgreen/anchorclaw 0.0.3

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.
Files changed (247) hide show
  1. package/LICENSE +21 -0
  2. package/NOTICE +9 -0
  3. package/README.md +252 -0
  4. package/dist/api.d.ts +3 -0
  5. package/dist/api.d.ts.map +1 -0
  6. package/dist/api.js +3 -0
  7. package/dist/api.js.map +1 -0
  8. package/dist/config.d.ts +46 -0
  9. package/dist/config.d.ts.map +1 -0
  10. package/dist/config.js +309 -0
  11. package/dist/config.js.map +1 -0
  12. package/dist/config.test.d.ts +2 -0
  13. package/dist/config.test.d.ts.map +1 -0
  14. package/dist/config.test.js +100 -0
  15. package/dist/config.test.js.map +1 -0
  16. package/dist/identity-policy.d.ts +3 -0
  17. package/dist/identity-policy.d.ts.map +1 -0
  18. package/dist/identity-policy.js +7 -0
  19. package/dist/identity-policy.js.map +1 -0
  20. package/dist/identity-policy.test.d.ts +2 -0
  21. package/dist/identity-policy.test.d.ts.map +1 -0
  22. package/dist/identity-policy.test.js +23 -0
  23. package/dist/identity-policy.test.js.map +1 -0
  24. package/dist/identity.d.ts +22 -0
  25. package/dist/identity.d.ts.map +1 -0
  26. package/dist/identity.js +113 -0
  27. package/dist/identity.js.map +1 -0
  28. package/dist/identity.test.d.ts +2 -0
  29. package/dist/identity.test.d.ts.map +1 -0
  30. package/dist/identity.test.js +22 -0
  31. package/dist/identity.test.js.map +1 -0
  32. package/dist/importer.d.ts +12 -0
  33. package/dist/importer.d.ts.map +1 -0
  34. package/dist/importer.js +297 -0
  35. package/dist/importer.js.map +1 -0
  36. package/dist/index.d.ts +3 -0
  37. package/dist/index.d.ts.map +1 -0
  38. package/dist/index.js +92 -0
  39. package/dist/index.js.map +1 -0
  40. package/dist/index.test.d.ts +2 -0
  41. package/dist/index.test.d.ts.map +1 -0
  42. package/dist/index.test.js +770 -0
  43. package/dist/index.test.js.map +1 -0
  44. package/dist/memory/forget.d.ts +22 -0
  45. package/dist/memory/forget.d.ts.map +1 -0
  46. package/dist/memory/forget.js +84 -0
  47. package/dist/memory/forget.js.map +1 -0
  48. package/dist/memory/get.d.ts +36 -0
  49. package/dist/memory/get.d.ts.map +1 -0
  50. package/dist/memory/get.js +282 -0
  51. package/dist/memory/get.js.map +1 -0
  52. package/dist/memory/get.test.d.ts +2 -0
  53. package/dist/memory/get.test.d.ts.map +1 -0
  54. package/dist/memory/get.test.js +180 -0
  55. package/dist/memory/get.test.js.map +1 -0
  56. package/dist/memory/limits.d.ts +10 -0
  57. package/dist/memory/limits.d.ts.map +1 -0
  58. package/dist/memory/limits.js +18 -0
  59. package/dist/memory/limits.js.map +1 -0
  60. package/dist/memory/manager.d.ts +93 -0
  61. package/dist/memory/manager.d.ts.map +1 -0
  62. package/dist/memory/manager.js +344 -0
  63. package/dist/memory/manager.js.map +1 -0
  64. package/dist/memory/manager.test.d.ts +2 -0
  65. package/dist/memory/manager.test.d.ts.map +1 -0
  66. package/dist/memory/manager.test.js +201 -0
  67. package/dist/memory/manager.test.js.map +1 -0
  68. package/dist/memory/paths.d.ts +12 -0
  69. package/dist/memory/paths.d.ts.map +1 -0
  70. package/dist/memory/paths.js +31 -0
  71. package/dist/memory/paths.js.map +1 -0
  72. package/dist/memory/paths.test.d.ts +2 -0
  73. package/dist/memory/paths.test.d.ts.map +1 -0
  74. package/dist/memory/paths.test.js +35 -0
  75. package/dist/memory/paths.test.js.map +1 -0
  76. package/dist/memory/prompt.d.ts +37 -0
  77. package/dist/memory/prompt.d.ts.map +1 -0
  78. package/dist/memory/prompt.js +152 -0
  79. package/dist/memory/prompt.js.map +1 -0
  80. package/dist/memory/prompt.test.d.ts +2 -0
  81. package/dist/memory/prompt.test.d.ts.map +1 -0
  82. package/dist/memory/prompt.test.js +47 -0
  83. package/dist/memory/prompt.test.js.map +1 -0
  84. package/dist/memory/read-file-shared.d.ts +17 -0
  85. package/dist/memory/read-file-shared.d.ts.map +1 -0
  86. package/dist/memory/read-file-shared.js +53 -0
  87. package/dist/memory/read-file-shared.js.map +1 -0
  88. package/dist/memory/read-file-shared.test.d.ts +2 -0
  89. package/dist/memory/read-file-shared.test.d.ts.map +1 -0
  90. package/dist/memory/read-file-shared.test.js +82 -0
  91. package/dist/memory/read-file-shared.test.js.map +1 -0
  92. package/dist/memory/recall.d.ts +22 -0
  93. package/dist/memory/recall.d.ts.map +1 -0
  94. package/dist/memory/recall.js +58 -0
  95. package/dist/memory/recall.js.map +1 -0
  96. package/dist/memory/search.d.ts +30 -0
  97. package/dist/memory/search.d.ts.map +1 -0
  98. package/dist/memory/search.js +110 -0
  99. package/dist/memory/search.js.map +1 -0
  100. package/dist/memory/search.test.d.ts +2 -0
  101. package/dist/memory/search.test.d.ts.map +1 -0
  102. package/dist/memory/search.test.js +103 -0
  103. package/dist/memory/search.test.js.map +1 -0
  104. package/dist/memory/sessions-index-sync.d.ts +28 -0
  105. package/dist/memory/sessions-index-sync.d.ts.map +1 -0
  106. package/dist/memory/sessions-index-sync.js +253 -0
  107. package/dist/memory/sessions-index-sync.js.map +1 -0
  108. package/dist/memory/sessions-index-sync.test.d.ts +2 -0
  109. package/dist/memory/sessions-index-sync.test.d.ts.map +1 -0
  110. package/dist/memory/sessions-index-sync.test.js +280 -0
  111. package/dist/memory/sessions-index-sync.test.js.map +1 -0
  112. package/dist/memory/sessions-index.d.ts +30 -0
  113. package/dist/memory/sessions-index.d.ts.map +1 -0
  114. package/dist/memory/sessions-index.js +238 -0
  115. package/dist/memory/sessions-index.js.map +1 -0
  116. package/dist/memory/sessions-index.test.d.ts +2 -0
  117. package/dist/memory/sessions-index.test.d.ts.map +1 -0
  118. package/dist/memory/sessions-index.test.js +266 -0
  119. package/dist/memory/sessions-index.test.js.map +1 -0
  120. package/dist/memory/sessions-visibility.d.ts +18 -0
  121. package/dist/memory/sessions-visibility.d.ts.map +1 -0
  122. package/dist/memory/sessions-visibility.js +110 -0
  123. package/dist/memory/sessions-visibility.js.map +1 -0
  124. package/dist/memory/sessions-visibility.test.d.ts +2 -0
  125. package/dist/memory/sessions-visibility.test.d.ts.map +1 -0
  126. package/dist/memory/sessions-visibility.test.js +137 -0
  127. package/dist/memory/sessions-visibility.test.js.map +1 -0
  128. package/dist/memory/sessions.d.ts +26 -0
  129. package/dist/memory/sessions.d.ts.map +1 -0
  130. package/dist/memory/sessions.js +250 -0
  131. package/dist/memory/sessions.js.map +1 -0
  132. package/dist/memory/sessions.test.d.ts +2 -0
  133. package/dist/memory/sessions.test.d.ts.map +1 -0
  134. package/dist/memory/sessions.test.js +257 -0
  135. package/dist/memory/sessions.test.js.map +1 -0
  136. package/dist/memory/store.d.ts +25 -0
  137. package/dist/memory/store.d.ts.map +1 -0
  138. package/dist/memory/store.js +176 -0
  139. package/dist/memory/store.js.map +1 -0
  140. package/dist/migrations-fs.d.ts +5 -0
  141. package/dist/migrations-fs.d.ts.map +1 -0
  142. package/dist/migrations-fs.js +19 -0
  143. package/dist/migrations-fs.js.map +1 -0
  144. package/dist/migrations.d.ts +17 -0
  145. package/dist/migrations.d.ts.map +1 -0
  146. package/dist/migrations.js +44 -0
  147. package/dist/migrations.js.map +1 -0
  148. package/dist/migrations.test.d.ts +2 -0
  149. package/dist/migrations.test.d.ts.map +1 -0
  150. package/dist/migrations.test.js +66 -0
  151. package/dist/migrations.test.js.map +1 -0
  152. package/dist/plugin/capability.d.ts +7 -0
  153. package/dist/plugin/capability.d.ts.map +1 -0
  154. package/dist/plugin/capability.js +92 -0
  155. package/dist/plugin/capability.js.map +1 -0
  156. package/dist/plugin/capability.test.d.ts +2 -0
  157. package/dist/plugin/capability.test.d.ts.map +1 -0
  158. package/dist/plugin/capability.test.js +75 -0
  159. package/dist/plugin/capability.test.js.map +1 -0
  160. package/dist/plugin/lifecycle.d.ts +6 -0
  161. package/dist/plugin/lifecycle.d.ts.map +1 -0
  162. package/dist/plugin/lifecycle.js +31 -0
  163. package/dist/plugin/lifecycle.js.map +1 -0
  164. package/dist/plugin/prompt-cache.d.ts +10 -0
  165. package/dist/plugin/prompt-cache.d.ts.map +1 -0
  166. package/dist/plugin/prompt-cache.js +58 -0
  167. package/dist/plugin/prompt-cache.js.map +1 -0
  168. package/dist/plugin/runtime-context.d.ts +27 -0
  169. package/dist/plugin/runtime-context.d.ts.map +1 -0
  170. package/dist/plugin/runtime-context.js +91 -0
  171. package/dist/plugin/runtime-context.js.map +1 -0
  172. package/dist/plugin/runtime-helpers.d.ts +3 -0
  173. package/dist/plugin/runtime-helpers.d.ts.map +1 -0
  174. package/dist/plugin/runtime-helpers.js +12 -0
  175. package/dist/plugin/runtime-helpers.js.map +1 -0
  176. package/dist/plugin/session-delta-helpers.d.ts +11 -0
  177. package/dist/plugin/session-delta-helpers.d.ts.map +1 -0
  178. package/dist/plugin/session-delta-helpers.js +62 -0
  179. package/dist/plugin/session-delta-helpers.js.map +1 -0
  180. package/dist/plugin/session-delta.d.ts +12 -0
  181. package/dist/plugin/session-delta.d.ts.map +1 -0
  182. package/dist/plugin/session-delta.js +307 -0
  183. package/dist/plugin/session-delta.js.map +1 -0
  184. package/dist/plugin/tools/common.d.ts +7 -0
  185. package/dist/plugin/tools/common.d.ts.map +1 -0
  186. package/dist/plugin/tools/common.js +2 -0
  187. package/dist/plugin/tools/common.js.map +1 -0
  188. package/dist/plugin/tools/index.d.ts +3 -0
  189. package/dist/plugin/tools/index.d.ts.map +1 -0
  190. package/dist/plugin/tools/index.js +16 -0
  191. package/dist/plugin/tools/index.js.map +1 -0
  192. package/dist/plugin/tools/memory-forget.d.ts +3 -0
  193. package/dist/plugin/tools/memory-forget.d.ts.map +1 -0
  194. package/dist/plugin/tools/memory-forget.js +80 -0
  195. package/dist/plugin/tools/memory-forget.js.map +1 -0
  196. package/dist/plugin/tools/memory-forget.test.d.ts +2 -0
  197. package/dist/plugin/tools/memory-forget.test.d.ts.map +1 -0
  198. package/dist/plugin/tools/memory-forget.test.js +58 -0
  199. package/dist/plugin/tools/memory-forget.test.js.map +1 -0
  200. package/dist/plugin/tools/memory-get.d.ts +3 -0
  201. package/dist/plugin/tools/memory-get.d.ts.map +1 -0
  202. package/dist/plugin/tools/memory-get.js +136 -0
  203. package/dist/plugin/tools/memory-get.js.map +1 -0
  204. package/dist/plugin/tools/memory-recall.d.ts +3 -0
  205. package/dist/plugin/tools/memory-recall.d.ts.map +1 -0
  206. package/dist/plugin/tools/memory-recall.js +176 -0
  207. package/dist/plugin/tools/memory-recall.js.map +1 -0
  208. package/dist/plugin/tools/memory-recall.test.d.ts +2 -0
  209. package/dist/plugin/tools/memory-recall.test.d.ts.map +1 -0
  210. package/dist/plugin/tools/memory-recall.test.js +169 -0
  211. package/dist/plugin/tools/memory-recall.test.js.map +1 -0
  212. package/dist/plugin/tools/memory-search.d.ts +3 -0
  213. package/dist/plugin/tools/memory-search.d.ts.map +1 -0
  214. package/dist/plugin/tools/memory-search.js +332 -0
  215. package/dist/plugin/tools/memory-search.js.map +1 -0
  216. package/dist/plugin/tools/memory-search.test.d.ts +2 -0
  217. package/dist/plugin/tools/memory-search.test.d.ts.map +1 -0
  218. package/dist/plugin/tools/memory-search.test.js +205 -0
  219. package/dist/plugin/tools/memory-search.test.js.map +1 -0
  220. package/dist/plugin/tools/memory-status.d.ts +3 -0
  221. package/dist/plugin/tools/memory-status.d.ts.map +1 -0
  222. package/dist/plugin/tools/memory-status.js +134 -0
  223. package/dist/plugin/tools/memory-status.js.map +1 -0
  224. package/dist/plugin/tools/memory-store.d.ts +3 -0
  225. package/dist/plugin/tools/memory-store.d.ts.map +1 -0
  226. package/dist/plugin/tools/memory-store.js +88 -0
  227. package/dist/plugin/tools/memory-store.js.map +1 -0
  228. package/dist/plugin/tools/memory-store.test.d.ts +2 -0
  229. package/dist/plugin/tools/memory-store.test.d.ts.map +1 -0
  230. package/dist/plugin/tools/memory-store.test.js +64 -0
  231. package/dist/plugin/tools/memory-store.test.js.map +1 -0
  232. package/dist/plugin/tools/memory-visible-output.d.ts +20 -0
  233. package/dist/plugin/tools/memory-visible-output.d.ts.map +1 -0
  234. package/dist/plugin/tools/memory-visible-output.js +61 -0
  235. package/dist/plugin/tools/memory-visible-output.js.map +1 -0
  236. package/dist/plugin/types.d.ts +61 -0
  237. package/dist/plugin/types.d.ts.map +1 -0
  238. package/dist/plugin/types.js +2 -0
  239. package/dist/plugin/types.js.map +1 -0
  240. package/dist/postgres.d.ts +7 -0
  241. package/dist/postgres.d.ts.map +1 -0
  242. package/dist/postgres.js +55 -0
  243. package/dist/postgres.js.map +1 -0
  244. package/migrations/0001_init.sql +228 -0
  245. package/migrations/0002_session_index.sql +71 -0
  246. package/openclaw.plugin.json +314 -0
  247. package/package.json +63 -0
@@ -0,0 +1,62 @@
1
+ import { DEFAULT_SESSION_DELTA_BYTES, DEFAULT_SESSION_DELTA_MESSAGES, } from "../config.js";
2
+ import { isSessionArchiveArtifactName, isUsageCountedSessionTranscriptFileName, } from "openclaw/plugin-sdk/memory-core-host-engine-qmd";
3
+ import fs, {} from "node:fs/promises";
4
+ const SESSION_DELTA_READ_CHUNK_BYTES = 64 * 1024;
5
+ export function isSessionArchiveArtifactPath(sessionFile) {
6
+ const fileName = sessionFile.replaceAll("\\", "/").split("/").pop() ?? "";
7
+ return (isSessionArchiveArtifactName(fileName) &&
8
+ isUsageCountedSessionTranscriptFileName(fileName));
9
+ }
10
+ export function countNewlinesFromChunk(chunk) {
11
+ let count = 0;
12
+ for (let i = 0; i < chunk.length; i += 1) {
13
+ if (chunk.charCodeAt(i) === 10) {
14
+ count += 1;
15
+ }
16
+ }
17
+ return count;
18
+ }
19
+ export async function countNewlinesInRange(params) {
20
+ if (params.end <= params.start) {
21
+ return 0;
22
+ }
23
+ let handle = null;
24
+ try {
25
+ handle = await fs.open(params.filePath, "r");
26
+ const buffer = Buffer.alloc(SESSION_DELTA_READ_CHUNK_BYTES);
27
+ let offset = params.start;
28
+ let count = 0;
29
+ while (offset < params.end) {
30
+ const toRead = Math.min(buffer.length, params.end - offset);
31
+ const { bytesRead } = await handle.read(buffer, 0, toRead, offset);
32
+ if (bytesRead <= 0) {
33
+ break;
34
+ }
35
+ const textChunk = buffer.toString("utf8", 0, bytesRead);
36
+ count += countNewlinesFromChunk(textChunk);
37
+ offset += bytesRead;
38
+ }
39
+ return count;
40
+ }
41
+ catch {
42
+ return 0;
43
+ }
44
+ finally {
45
+ if (handle) {
46
+ await handle.close().catch(() => { });
47
+ }
48
+ }
49
+ }
50
+ export function resolveSessionDeltaThresholds(cfg) {
51
+ const deltaBytes = cfg?.sessions?.sync?.deltaBytes;
52
+ const deltaMessages = cfg?.sessions?.sync?.deltaMessages;
53
+ return {
54
+ deltaBytes: typeof deltaBytes === "number" && Number.isInteger(deltaBytes) && deltaBytes >= 0
55
+ ? deltaBytes
56
+ : DEFAULT_SESSION_DELTA_BYTES,
57
+ deltaMessages: typeof deltaMessages === "number" && Number.isInteger(deltaMessages) && deltaMessages >= 0
58
+ ? deltaMessages
59
+ : DEFAULT_SESSION_DELTA_MESSAGES,
60
+ };
61
+ }
62
+ //# sourceMappingURL=session-delta-helpers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session-delta-helpers.js","sourceRoot":"","sources":["../../src/plugin/session-delta-helpers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { OpenClawPluginApi } from "../api.js";
2
+ import type { PluginRuntimeContext } from "./runtime-context.js";
3
+ export type SessionDeltaRuntime = {
4
+ ensureSessionsIndexBootstrapped: () => Promise<void>;
5
+ ensureSessionDeltaListener: () => void;
6
+ cleanupSessionDelta: () => void;
7
+ };
8
+ export declare function createSessionDeltaRuntime(params: {
9
+ api: OpenClawPluginApi;
10
+ ctx: PluginRuntimeContext;
11
+ }): SessionDeltaRuntime;
12
+ //# sourceMappingURL=session-delta.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session-delta.d.ts","sourceRoot":"","sources":["../../src/plugin/session-delta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAUnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAMjE,MAAM,MAAM,mBAAmB,GAAG;IAChC,+BAA+B,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,0BAA0B,EAAE,MAAM,IAAI,CAAC;IACvC,mBAAmB,EAAE,MAAM,IAAI,CAAC;CACjC,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,GAAG,EAAE,iBAAiB,CAAC;IACvB,GAAG,EAAE,oBAAoB,CAAC;CAC3B,GAAG,mBAAmB,CAgUtB"}
@@ -0,0 +1,307 @@
1
+ import { resolveUserAndWorkspaceScope } from "../identity.js";
2
+ import { isSessionFileForAgent, isSessionFileForAnyKnownAgent } from "../memory/sessions.js";
3
+ import { normalizeSessionLookupPath } from "../memory/sessions-index.js";
4
+ import { syncSessionsIndexDb, syncVisibleSessionsIndexDb } from "../memory/sessions-index-sync.js";
5
+ import { countNewlinesInRange, isSessionArchiveArtifactPath, resolveSessionDeltaThresholds, } from "./session-delta-helpers.js";
6
+ import { sessionPathForFile } from "openclaw/plugin-sdk/memory-core-host-engine-qmd";
7
+ import fs from "node:fs/promises";
8
+ const SESSION_DELTA_DEBOUNCE_MS = 5_000;
9
+ export function createSessionDeltaRuntime(params) {
10
+ const { api, ctx } = params;
11
+ const ensureSessionsIndexBootstrapped = async () => {
12
+ if (!ctx.cfg) {
13
+ return;
14
+ }
15
+ if ((ctx.cfg?.sessions?.visibility ?? "current") === "off") {
16
+ return;
17
+ }
18
+ if (ctx.sessionsIndex.bootstrapped) {
19
+ return;
20
+ }
21
+ if (ctx.sessionsIndex.bootstrapPromise) {
22
+ await ctx.sessionsIndex.bootstrapPromise;
23
+ return;
24
+ }
25
+ ctx.sessionsIndex.bootstrapPromise = (async () => {
26
+ try {
27
+ await ctx.ensureReady();
28
+ const scope = await resolveUserAndWorkspaceScope({
29
+ api,
30
+ pool: ctx.getPool(),
31
+ agentId: api?.runtime?.agentId,
32
+ sessionKey: api?.runtime?.sessionKey,
33
+ configuredExternalId: ctx.cfg?.identity?.externalId,
34
+ });
35
+ const currentAgentId = String(api?.runtime?.agentId ?? "main");
36
+ if ((ctx.cfg?.sessions?.visibility ?? "current") === "visible") {
37
+ const visibleAgentIds = await ctx.listVisibleAgentIds();
38
+ await syncVisibleSessionsIndexDb({
39
+ pool: ctx.getPool(),
40
+ userId: scope.userId,
41
+ workspaceId: scope.workspaceId,
42
+ agentId: currentAgentId,
43
+ otherAgentIds: visibleAgentIds.filter((agentId) => agentId !== currentAgentId),
44
+ });
45
+ }
46
+ else {
47
+ await syncSessionsIndexDb({
48
+ pool: ctx.getPool(),
49
+ userId: scope.userId,
50
+ workspaceId: scope.workspaceId,
51
+ agentId: currentAgentId,
52
+ });
53
+ }
54
+ ctx.sessionsIndex.bootstrapped = true;
55
+ }
56
+ catch (error) {
57
+ api.logger.warn(`anchorclaw: sessions index bootstrap failed (${error instanceof Error ? error.message : String(error)})`);
58
+ }
59
+ finally {
60
+ ctx.sessionsIndex.bootstrapPromise = null;
61
+ }
62
+ })();
63
+ await ctx.sessionsIndex.bootstrapPromise;
64
+ };
65
+ const flushSessionDeltaSync = async () => {
66
+ if (ctx.sessionDelta.closed) {
67
+ ctx.sessionDelta.pendingFiles.clear();
68
+ return;
69
+ }
70
+ if (!ctx.cfg) {
71
+ ctx.sessionDelta.pendingFiles.clear();
72
+ return;
73
+ }
74
+ if ((ctx.cfg?.sessions?.visibility ?? "current") === "off") {
75
+ ctx.sessionDelta.pendingFiles.clear();
76
+ return;
77
+ }
78
+ if (ctx.sessionDelta.pendingFiles.size === 0) {
79
+ return;
80
+ }
81
+ if (ctx.sessionDelta.syncInFlight) {
82
+ return;
83
+ }
84
+ const batch = Array.from(ctx.sessionDelta.pendingFiles);
85
+ const sessionDeltaThresholds = resolveSessionDeltaThresholds(ctx.cfg);
86
+ ctx.sessionDelta.pendingFiles.clear();
87
+ const dirtyFiles = [];
88
+ for (const sessionFile of batch) {
89
+ if (isSessionArchiveArtifactPath(sessionFile)) {
90
+ dirtyFiles.push(sessionFile);
91
+ continue;
92
+ }
93
+ let statSize = null;
94
+ try {
95
+ const stat = await fs.stat(sessionFile);
96
+ statSize = typeof stat.size === "number" ? stat.size : null;
97
+ }
98
+ catch {
99
+ // If stat is unavailable, keep previous behavior and allow targeted sync.
100
+ dirtyFiles.push(sessionFile);
101
+ }
102
+ if (statSize === null) {
103
+ continue;
104
+ }
105
+ const prev = ctx.sessionDelta.stateByPath.get(sessionFile) ?? {
106
+ lastSize: 0,
107
+ pendingBytes: 0,
108
+ pendingMessages: 0,
109
+ };
110
+ const sizeReduced = statSize < prev.lastSize;
111
+ const deltaBytes = sizeReduced ? statSize : Math.max(0, statSize - prev.lastSize);
112
+ const pendingBytes = prev.pendingBytes + Math.max(0, deltaBytes);
113
+ const shouldCountMessages = sessionDeltaThresholds.deltaMessages > 0 &&
114
+ (sessionDeltaThresholds.deltaBytes <= 0 || pendingBytes < sessionDeltaThresholds.deltaBytes);
115
+ const messageSpanStart = sizeReduced ? 0 : prev.lastSize;
116
+ const deltaMessages = shouldCountMessages
117
+ ? await countNewlinesInRange({
118
+ filePath: sessionFile,
119
+ start: messageSpanStart,
120
+ end: statSize,
121
+ })
122
+ : 0;
123
+ const pendingMessages = prev.pendingMessages + Math.max(0, deltaMessages);
124
+ ctx.sessionDelta.stateByPath.set(sessionFile, {
125
+ lastSize: statSize,
126
+ pendingBytes,
127
+ pendingMessages,
128
+ });
129
+ const bytesHit = sessionDeltaThresholds.deltaBytes <= 0
130
+ ? pendingBytes > 0
131
+ : pendingBytes >= sessionDeltaThresholds.deltaBytes;
132
+ const messagesHit = sessionDeltaThresholds.deltaMessages > 0 &&
133
+ pendingMessages >= sessionDeltaThresholds.deltaMessages;
134
+ if (bytesHit || messagesHit) {
135
+ dirtyFiles.push(sessionFile);
136
+ }
137
+ }
138
+ if (dirtyFiles.length === 0) {
139
+ return;
140
+ }
141
+ ctx.sessionDelta.syncInFlight = (async () => {
142
+ try {
143
+ api.logger.info(`anchorclaw: sessions delta flush start (batch=${batch.length}, dirty=${dirtyFiles.length}, visibility=${ctx.cfg?.sessions?.visibility ?? "current"})`);
144
+ await ctx.ensureReady();
145
+ const scope = await resolveUserAndWorkspaceScope({
146
+ api,
147
+ pool: ctx.getPool(),
148
+ agentId: api?.runtime?.agentId,
149
+ sessionKey: api?.runtime?.sessionKey,
150
+ configuredExternalId: ctx.cfg?.identity?.externalId,
151
+ });
152
+ const currentAgentId = String(api?.runtime?.agentId ?? "main");
153
+ await syncSessionsIndexDb({
154
+ pool: ctx.getPool(),
155
+ userId: scope.userId,
156
+ workspaceId: scope.workspaceId,
157
+ agentId: currentAgentId,
158
+ sessionFiles: dirtyFiles,
159
+ });
160
+ for (const sessionFile of dirtyFiles) {
161
+ const state = ctx.sessionDelta.stateByPath.get(sessionFile);
162
+ if (!state) {
163
+ continue;
164
+ }
165
+ ctx.sessionDelta.stateByPath.set(sessionFile, {
166
+ lastSize: state.lastSize,
167
+ pendingBytes: sessionDeltaThresholds.deltaBytes > 0
168
+ ? Math.max(0, state.pendingBytes - sessionDeltaThresholds.deltaBytes)
169
+ : 0,
170
+ pendingMessages: sessionDeltaThresholds.deltaMessages > 0
171
+ ? Math.max(0, state.pendingMessages - sessionDeltaThresholds.deltaMessages)
172
+ : 0,
173
+ });
174
+ }
175
+ api.logger.info(`anchorclaw: sessions delta flush done (batch=${batch.length}, dirty=${dirtyFiles.length}, agent=${currentAgentId})`);
176
+ }
177
+ catch (error) {
178
+ api.logger.warn(`anchorclaw: sessions delta sync failed (${error instanceof Error ? error.message : String(error)})`);
179
+ }
180
+ finally {
181
+ ctx.sessionDelta.syncInFlight = null;
182
+ if (ctx.sessionDelta.pendingFiles.size > 0 && !ctx.sessionDelta.closed && !ctx.sessionDelta.timer) {
183
+ ctx.sessionDelta.timer = setTimeout(() => {
184
+ ctx.sessionDelta.timer = null;
185
+ void flushSessionDeltaSync();
186
+ }, SESSION_DELTA_DEBOUNCE_MS);
187
+ }
188
+ }
189
+ })();
190
+ await ctx.sessionDelta.syncInFlight;
191
+ };
192
+ const scheduleSessionDeltaSync = (sessionFile) => {
193
+ const filePath = sessionFile.trim();
194
+ if (!filePath || ctx.sessionDelta.closed) {
195
+ return;
196
+ }
197
+ ctx.sessionDelta.pendingFiles.add(filePath);
198
+ if (ctx.sessionDelta.timer) {
199
+ return;
200
+ }
201
+ ctx.sessionDelta.timer = setTimeout(() => {
202
+ ctx.sessionDelta.timer = null;
203
+ void flushSessionDeltaSync();
204
+ }, SESSION_DELTA_DEBOUNCE_MS);
205
+ };
206
+ const ensureSessionDeltaListener = () => {
207
+ if (!ctx.cfg || ctx.sessionDelta.closed || ctx.sessionDelta.unsubscribe) {
208
+ return;
209
+ }
210
+ if ((ctx.cfg?.sessions?.visibility ?? "current") === "off") {
211
+ return;
212
+ }
213
+ const subscribe = api?.runtime?.events?.onSessionTranscriptUpdate;
214
+ if (typeof subscribe !== "function") {
215
+ api.logger.warn("anchorclaw: runtime.events.onSessionTranscriptUpdate unavailable; sessions delta sync disabled");
216
+ return;
217
+ }
218
+ const currentAgentId = String(api?.runtime?.agentId ?? "main");
219
+ const isRelevantSessionDeltaPath = async (sessionFile) => {
220
+ if ((ctx.cfg?.sessions?.visibility ?? "current") === "visible") {
221
+ const knownAgentTranscript = await isSessionFileForAnyKnownAgent(sessionFile);
222
+ if (!knownAgentTranscript) {
223
+ const next = (ctx.sessionDelta.ignoredPathCounts.get(sessionFile) ?? 0) + 1;
224
+ ctx.sessionDelta.ignoredPathCounts.set(sessionFile, next);
225
+ if (next === 1 || next === 5 || next % 20 === 0) {
226
+ api.logger.warn(`anchorclaw: ignored session delta update due to unrecognized path (${sessionFile}) [count=${next}]`);
227
+ }
228
+ return false;
229
+ }
230
+ const lookup = normalizeSessionLookupPath(sessionPathForFile(sessionFile));
231
+ if (!lookup) {
232
+ const next = (ctx.sessionDelta.ignoredPathCounts.get(sessionFile) ?? 0) + 1;
233
+ ctx.sessionDelta.ignoredPathCounts.set(sessionFile, next);
234
+ if (next === 1 || next === 5 || next % 20 === 0) {
235
+ api.logger.warn(`anchorclaw: ignored session delta update due to unrecognized path (${sessionFile}) [count=${next}]`);
236
+ }
237
+ return false;
238
+ }
239
+ return true;
240
+ }
241
+ const inCurrentAgentDir = await isSessionFileForAgent({
242
+ sessionFile,
243
+ agentId: currentAgentId,
244
+ });
245
+ if (!inCurrentAgentDir) {
246
+ const lookup = normalizeSessionLookupPath(sessionPathForFile(sessionFile));
247
+ const logKey = lookup || sessionFile;
248
+ const next = (ctx.sessionDelta.ignoredPathCounts.get(logKey) ?? 0) + 1;
249
+ ctx.sessionDelta.ignoredPathCounts.set(logKey, next);
250
+ if (next === 1 || next === 5 || next % 20 === 0) {
251
+ api.logger.warn(`anchorclaw: ignored session delta update outside current visibility (${logKey}) [count=${next}]`);
252
+ }
253
+ return false;
254
+ }
255
+ const lookup = normalizeSessionLookupPath(sessionPathForFile(sessionFile));
256
+ if (!lookup) {
257
+ const next = (ctx.sessionDelta.ignoredPathCounts.get(sessionFile) ?? 0) + 1;
258
+ ctx.sessionDelta.ignoredPathCounts.set(sessionFile, next);
259
+ if (next === 1 || next === 5 || next % 20 === 0) {
260
+ api.logger.warn(`anchorclaw: ignored session delta update due to unrecognized path (${sessionFile}) [count=${next}]`);
261
+ }
262
+ return false;
263
+ }
264
+ return true;
265
+ };
266
+ ctx.sessionDelta.unsubscribe = subscribe((update) => {
267
+ if (ctx.sessionDelta.closed) {
268
+ return;
269
+ }
270
+ const sessionFile = typeof update?.sessionFile === "string" ? update.sessionFile : "";
271
+ if (!sessionFile) {
272
+ return;
273
+ }
274
+ api.logger.info(`anchorclaw: transcript update event received (${sessionFile})`);
275
+ void (async () => {
276
+ if (!(await isRelevantSessionDeltaPath(sessionFile))) {
277
+ return;
278
+ }
279
+ api.logger.info(`anchorclaw: transcript update accepted for delta sync (${sessionFile})`);
280
+ scheduleSessionDeltaSync(sessionFile);
281
+ })();
282
+ });
283
+ };
284
+ const cleanupSessionDelta = () => {
285
+ ctx.sessionDelta.closed = true;
286
+ if (ctx.sessionDelta.timer) {
287
+ clearTimeout(ctx.sessionDelta.timer);
288
+ ctx.sessionDelta.timer = null;
289
+ }
290
+ ctx.sessionDelta.pendingFiles.clear();
291
+ ctx.sessionDelta.stateByPath.clear();
292
+ if (ctx.sessionDelta.unsubscribe) {
293
+ try {
294
+ ctx.sessionDelta.unsubscribe();
295
+ }
296
+ finally {
297
+ ctx.sessionDelta.unsubscribe = null;
298
+ }
299
+ }
300
+ };
301
+ return {
302
+ ensureSessionsIndexBootstrapped,
303
+ ensureSessionDeltaListener,
304
+ cleanupSessionDelta,
305
+ };
306
+ }
307
+ //# sourceMappingURL=session-delta.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session-delta.js","sourceRoot":"","sources":["../../src/plugin/session-delta.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import type { PluginRuntimeContext } from "../runtime-context.js";
2
+ export type ToolRegistrationParams = {
3
+ ctx: PluginRuntimeContext;
4
+ refreshPromptCache: () => void;
5
+ ensureSessionsIndexBootstrapped: () => Promise<void>;
6
+ };
7
+ //# sourceMappingURL=common.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,EAAE,oBAAoB,CAAC;IAC1B,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,+BAA+B,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=common.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/plugin/tools/common.ts"],"names":[],"mappings":""}
@@ -0,0 +1,3 @@
1
+ import type { ToolRegistrationParams } from "./common.js";
2
+ export declare function registerAnchorClawTools(params: ToolRegistrationParams): void;
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,sBAAsB,QAQrE"}
@@ -0,0 +1,16 @@
1
+ import { registerMemoryForgetTool } from "./memory-forget.js";
2
+ import { registerMemoryGetTool } from "./memory-get.js";
3
+ import { registerMemoryRecallTool } from "./memory-recall.js";
4
+ import { registerMemorySearchTool } from "./memory-search.js";
5
+ import { registerMemoryStatusTool } from "./memory-status.js";
6
+ import { registerMemoryStoreTool } from "./memory-store.js";
7
+ export function registerAnchorClawTools(params) {
8
+ registerMemorySearchTool(params);
9
+ registerMemoryGetTool(params);
10
+ registerMemoryStoreTool(params);
11
+ registerMemoryRecallTool(params);
12
+ registerMemoryForgetTool(params);
13
+ // Keep diagnostics tool last so retrieval flows prioritize search/get/recall tools.
14
+ registerMemoryStatusTool(params);
15
+ }
16
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugin/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,MAAM,UAAU,uBAAuB,CAAC,MAA8B;IACpE,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,oFAAoF;IACpF,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { ToolRegistrationParams } from "./common.js";
2
+ export declare function registerMemoryForgetTool({ ctx, refreshPromptCache }: ToolRegistrationParams): void;
3
+ //# sourceMappingURL=memory-forget.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-forget.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/memory-forget.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,wBAAgB,wBAAwB,CAAC,EAAE,GAAG,EAAE,kBAAkB,EAAE,EAAE,sBAAsB,QAqF3F"}
@@ -0,0 +1,80 @@
1
+ import { resolveUserAndWorkspaceScope } from "../../identity.js";
2
+ import { memoryForgetDb } from "../../memory/forget.js";
3
+ export function registerMemoryForgetTool({ ctx, refreshPromptCache }) {
4
+ const api = ctx.api;
5
+ api.registerTool({
6
+ name: "memory_forget",
7
+ label: "Memory Forget",
8
+ description: "Soft-delete a durable memory item stored in AnchorClaw/Postgres.\n\nMVP rules:\n- Prefer passing lookup=db-memory/items/<uuid>.md (from memory_search or memory_store).\n- Alternatively pass id=<uuid>.",
9
+ parameters: {
10
+ type: "object",
11
+ additionalProperties: false,
12
+ properties: {
13
+ lookup: {
14
+ type: "string",
15
+ description: "Synthetic DB memory path, e.g. db-memory/items/<uuid>.md (preferred).",
16
+ },
17
+ path: {
18
+ type: "string",
19
+ description: "Alias for lookup (OpenClaw-style).",
20
+ },
21
+ id: { type: "string", description: "Memory item UUID (alternative to lookup)." },
22
+ },
23
+ },
24
+ async execute(_toolCallId, params) {
25
+ if (ctx.disabledReason) {
26
+ return {
27
+ content: [{ type: "text", text: `anchorclaw: disabled until configured (${ctx.disabledReason})` }],
28
+ details: { disabled: true, error: ctx.disabledReason },
29
+ };
30
+ }
31
+ await ctx.ensureReady();
32
+ const scope = await resolveUserAndWorkspaceScope({
33
+ api,
34
+ pool: ctx.getPool(),
35
+ agentId: api?.runtime?.agentId,
36
+ sessionKey: api?.runtime?.sessionKey,
37
+ configuredExternalId: ctx.cfg?.identity?.externalId,
38
+ });
39
+ const record = (params ?? {});
40
+ const lookup = typeof record.lookup === "string" && record.lookup.trim()
41
+ ? String(record.lookup)
42
+ : typeof record.path === "string" && record.path.trim()
43
+ ? String(record.path)
44
+ : undefined;
45
+ const id = typeof record.id === "string" && record.id.trim() ? String(record.id) : undefined;
46
+ if (!lookup && !id) {
47
+ return {
48
+ content: [{ type: "text", text: "anchorclaw: memory_forget requires lookup/path or id" }],
49
+ details: { disabled: true, error: "lookup or id required" },
50
+ };
51
+ }
52
+ const forgot = await memoryForgetDb({
53
+ pool: ctx.getPool(),
54
+ userId: scope.userId,
55
+ workspaceId: scope.workspaceId,
56
+ actor: ctx.resolveActor(),
57
+ logger: api.logger,
58
+ input: { ...(lookup ? { lookup } : {}), ...(id ? { id } : {}) },
59
+ });
60
+ if (!forgot.ok) {
61
+ return {
62
+ content: [{ type: "text", text: `anchorclaw: memory_forget failed (${forgot.error})` }],
63
+ details: forgot,
64
+ };
65
+ }
66
+ refreshPromptCache();
67
+ const visible = {
68
+ ok: true,
69
+ deleted: forgot.deleted,
70
+ lookup: lookup ?? null,
71
+ id: id ?? null,
72
+ };
73
+ return {
74
+ content: [{ type: "text", text: JSON.stringify(visible, null, 2) }],
75
+ details: forgot,
76
+ };
77
+ },
78
+ });
79
+ }
80
+ //# sourceMappingURL=memory-forget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-forget.js","sourceRoot":"","sources":["../../../src/plugin/tools/memory-forget.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=memory-forget.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-forget.test.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/memory-forget.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,58 @@
1
+ import { beforeEach, describe, expect, it, vi } from "vitest";
2
+ import { registerMemoryForgetTool } from "./memory-forget.js";
3
+ const { resolveScopeMock, memoryForgetDbMock } = vi.hoisted(() => ({
4
+ resolveScopeMock: vi.fn(async () => ({ userId: "u1", workspaceId: "w1" })),
5
+ memoryForgetDbMock: vi.fn(),
6
+ }));
7
+ vi.mock("../../identity.js", () => ({
8
+ resolveUserAndWorkspaceScope: resolveScopeMock,
9
+ }));
10
+ vi.mock("../../memory/forget.js", () => ({
11
+ memoryForgetDb: memoryForgetDbMock,
12
+ }));
13
+ function buildCtx() {
14
+ const registerTool = vi.fn();
15
+ return {
16
+ ctx: {
17
+ api: {
18
+ registerTool,
19
+ logger: { info: vi.fn(), warn: vi.fn(), error: vi.fn() },
20
+ runtime: { agentId: "main", sessionKey: "agent:main:main" },
21
+ },
22
+ disabledReason: null,
23
+ ensureReady: vi.fn(async () => undefined),
24
+ getPool: vi.fn(() => ({ query: vi.fn() })),
25
+ cfg: {},
26
+ resolveActor: vi.fn(() => "tester"),
27
+ },
28
+ registerTool,
29
+ };
30
+ }
31
+ describe("memory_forget visible output", () => {
32
+ beforeEach(() => {
33
+ vi.clearAllMocks();
34
+ });
35
+ it("returns compact JSON envelope in content on success", async () => {
36
+ memoryForgetDbMock.mockResolvedValueOnce({
37
+ ok: true,
38
+ deleted: 1,
39
+ });
40
+ const { ctx, registerTool } = buildCtx();
41
+ registerMemoryForgetTool({
42
+ ctx,
43
+ refreshPromptCache: vi.fn(),
44
+ });
45
+ const def = registerTool.mock.calls[0]?.[0];
46
+ const result = await def.execute("toolcall-1", {
47
+ lookup: "db-memory/items/11111111-1111-1111-1111-111111111111.md",
48
+ });
49
+ const visible = JSON.parse(result.content[0].text);
50
+ expect(visible).toMatchObject({
51
+ ok: true,
52
+ deleted: 1,
53
+ lookup: "db-memory/items/11111111-1111-1111-1111-111111111111.md",
54
+ id: null,
55
+ });
56
+ });
57
+ });
58
+ //# sourceMappingURL=memory-forget.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-forget.test.js","sourceRoot":"","sources":["../../../src/plugin/tools/memory-forget.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { ToolRegistrationParams } from "./common.js";
2
+ export declare function registerMemoryGetTool({ ctx }: ToolRegistrationParams): void;
3
+ //# sourceMappingURL=memory-get.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-get.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/memory-get.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,wBAAgB,qBAAqB,CAAC,EAAE,GAAG,EAAE,EAAE,sBAAsB,QAoIpE"}