@stackmemoryai/stackmemory 1.12.0 → 1.14.0

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 (162) hide show
  1. package/LICENSE +131 -64
  2. package/README.md +3 -1
  3. package/bin/claude-sm +16 -1
  4. package/bin/claude-smd +16 -1
  5. package/bin/codex-smd +16 -1
  6. package/bin/gemini-sm +16 -1
  7. package/bin/hermes-sm +21 -0
  8. package/bin/hermes-smd +21 -0
  9. package/bin/opencode-sm +16 -1
  10. package/dist/src/cli/codex-sm.js +51 -11
  11. package/dist/src/cli/commands/brain.js +206 -0
  12. package/dist/src/cli/commands/company-os.js +184 -0
  13. package/dist/src/cli/commands/context.js +5 -0
  14. package/dist/src/cli/commands/operator.js +127 -0
  15. package/dist/src/cli/commands/orchestrate.js +2 -0
  16. package/dist/src/cli/commands/orchestrator.js +3 -2
  17. package/dist/src/cli/commands/patterns.js +254 -0
  18. package/dist/src/cli/commands/portal.js +161 -0
  19. package/dist/src/cli/commands/scaffold.js +92 -0
  20. package/dist/src/cli/commands/setup.js +1 -4
  21. package/dist/src/cli/commands/sync.js +253 -0
  22. package/dist/src/cli/commands/tasks.js +130 -1
  23. package/dist/src/cli/commands/vision.js +221 -0
  24. package/dist/src/cli/hermes-sm.js +224 -0
  25. package/dist/src/cli/index.js +15 -10
  26. package/dist/src/cli/utils/real-cli-bin.js +72 -0
  27. package/dist/src/core/brain/brain-store.js +187 -0
  28. package/dist/src/core/brain/brain-sync.js +193 -0
  29. package/dist/src/core/brain/index.js +78 -0
  30. package/dist/src/core/brain/types.js +10 -0
  31. package/dist/src/core/cache/token-estimator.js +24 -1
  32. package/dist/src/core/config/feature-flags.js +2 -6
  33. package/dist/src/core/context/frame-database.js +44 -0
  34. package/dist/src/core/context/recursive-context-manager.js +1 -1
  35. package/dist/src/core/context/rehydration.js +2 -1
  36. package/dist/src/core/database/sqlite-adapter.js +14 -1
  37. package/dist/src/core/models/model-router.js +33 -1
  38. package/dist/src/core/models/provider-pricing.js +58 -4
  39. package/dist/src/core/patterns/index.js +22 -0
  40. package/dist/src/core/patterns/pattern-applier.js +39 -0
  41. package/dist/src/core/patterns/pattern-observer.js +157 -0
  42. package/dist/src/core/patterns/pattern-store.js +259 -0
  43. package/dist/src/core/patterns/types.js +19 -0
  44. package/dist/src/core/retrieval/llm-context-retrieval.js +5 -4
  45. package/dist/src/core/retrieval/unified-context-assembler.js +11 -66
  46. package/dist/src/core/skill-packs/types.js +14 -1
  47. package/dist/src/core/storage/cloud-sync-manager.js +116 -0
  48. package/dist/src/core/storage/cloud-sync.js +574 -0
  49. package/dist/src/core/storage/two-tier-storage.js +5 -1
  50. package/dist/src/core/tasks/master-tasks-template.js +43 -0
  51. package/dist/src/core/tasks/md-task-parser.js +138 -0
  52. package/dist/src/core/vision/index.js +27 -0
  53. package/dist/src/core/vision/signals.js +79 -0
  54. package/dist/src/core/vision/types.js +22 -0
  55. package/dist/src/core/vision/vision-file.js +146 -0
  56. package/dist/src/core/vision/vision-loop.js +220 -0
  57. package/dist/src/core/wiki/wiki-compiler.js +103 -1
  58. package/dist/src/daemon/daemon-config.js +45 -0
  59. package/dist/src/daemon/services/desire-path-service.js +566 -0
  60. package/dist/src/daemon/services/research-stream-service.js +320 -0
  61. package/dist/src/daemon/services/telemetry-service.js +192 -0
  62. package/dist/src/daemon/unified-daemon.js +28 -1
  63. package/dist/src/features/browser/cli-browser-agent.js +417 -0
  64. package/dist/src/features/browser/stagehand-workflows.js +578 -0
  65. package/dist/src/features/operator/adapter-factory.js +62 -0
  66. package/dist/src/features/operator/browser-adapter.js +109 -0
  67. package/dist/src/features/operator/desktop-adapter.js +125 -0
  68. package/dist/src/features/operator/index.js +39 -0
  69. package/dist/src/features/operator/llm-decision.js +137 -0
  70. package/dist/src/features/operator/operator-logger.js +92 -0
  71. package/dist/src/features/operator/overnight-runner.js +327 -0
  72. package/dist/src/features/operator/screen-adapter.js +91 -0
  73. package/dist/src/features/operator/session-manager.js +127 -0
  74. package/dist/src/features/operator/state-machine.js +227 -0
  75. package/dist/src/features/operator/task-queue.js +81 -0
  76. package/dist/src/features/portal/index.js +26 -0
  77. package/dist/src/features/portal/server.js +240 -0
  78. package/dist/src/features/portal/types.js +14 -0
  79. package/dist/src/features/portal/ui.js +195 -0
  80. package/dist/src/features/tasks/task-aware-context.js +2 -1
  81. package/dist/src/features/tui/simple-monitor.js +0 -23
  82. package/dist/src/features/tui/swarm-monitor.js +8 -66
  83. package/dist/src/{integrations/diffmem/index.js → features/web/client/hooks/use-socket.js} +6 -5
  84. package/dist/src/features/web/client/lib/utils.js +12 -0
  85. package/dist/src/features/web/client/stores/session-store.js +12 -0
  86. package/dist/src/features/web/server/gcp-billing.js +76 -0
  87. package/dist/src/features/web/server/index.js +10 -0
  88. package/dist/src/features/web/server/spend-calculator.js +228 -0
  89. package/dist/src/hooks/schemas.js +4 -1
  90. package/dist/src/integrations/anthropic/client.js +3 -2
  91. package/dist/src/integrations/claude-code/agent-bridge.js +0 -3
  92. package/dist/src/integrations/claude-code/subagent-client.js +218 -11
  93. package/dist/src/integrations/claude-code/task-coordinator.js +2 -1
  94. package/dist/src/integrations/linear/webhook-retry.js +196 -0
  95. package/dist/src/integrations/linear/webhook-server.js +18 -22
  96. package/dist/src/integrations/mcp/handlers/cloud-sync-handlers.js +101 -0
  97. package/dist/src/integrations/mcp/handlers/index.js +27 -52
  98. package/dist/src/integrations/mcp/server.js +122 -335
  99. package/dist/src/integrations/mcp/tool-alias-registry.js +0 -73
  100. package/dist/src/integrations/mcp/tool-definitions.js +111 -510
  101. package/dist/src/mcp/stackmemory-mcp-server.js +404 -379
  102. package/dist/src/orchestrators/multimodal/determinism.js +2 -1
  103. package/dist/src/orchestrators/multimodal/harness.js +2 -1
  104. package/dist/src/skills/recursive-agent-orchestrator.js +2 -4
  105. package/dist/src/utils/process-cleanup.js +1 -7
  106. package/docs/README.md +42 -0
  107. package/docs/guides/README_INSTALL.md +208 -0
  108. package/package.json +18 -9
  109. package/scripts/claude-code-wrapper.sh +11 -0
  110. package/scripts/claude-sm-setup.sh +12 -1
  111. package/scripts/codex-wrapper.sh +11 -0
  112. package/scripts/git-hooks/branch-context-manager.sh +11 -0
  113. package/scripts/git-hooks/post-checkout-stackmemory.sh +11 -0
  114. package/scripts/git-hooks/post-commit-stackmemory.sh +11 -0
  115. package/scripts/git-hooks/pre-commit-stackmemory.sh +11 -0
  116. package/scripts/hooks/cleanup-shell.sh +12 -1
  117. package/scripts/hooks/task-complete.sh +12 -1
  118. package/scripts/install-code-execution-hooks.sh +12 -1
  119. package/scripts/install-sweep-hook.sh +12 -0
  120. package/scripts/install.sh +11 -0
  121. package/scripts/opencode-wrapper.sh +11 -0
  122. package/scripts/portal/cloud-init.yaml +69 -0
  123. package/scripts/portal/setup.sh +69 -0
  124. package/scripts/portal/stackmemory-portal.service +34 -0
  125. package/scripts/setup-claude-integration.sh +12 -1
  126. package/scripts/smoke-init-db.sh +23 -0
  127. package/scripts/stackmemory-daemon.sh +11 -0
  128. package/scripts/verify-dist.cjs +11 -4
  129. package/dist/src/cli/commands/ralph.js +0 -1053
  130. package/dist/src/hooks/diffmem-hooks.js +0 -376
  131. package/dist/src/integrations/diffmem/client.js +0 -208
  132. package/dist/src/integrations/diffmem/config.js +0 -14
  133. package/dist/src/integrations/greptile/client.js +0 -101
  134. package/dist/src/integrations/greptile/config.js +0 -14
  135. package/dist/src/integrations/greptile/index.js +0 -11
  136. package/dist/src/integrations/mcp/handlers/cross-search-handlers.js +0 -188
  137. package/dist/src/integrations/mcp/handlers/diffmem-handlers.js +0 -455
  138. package/dist/src/integrations/mcp/handlers/greptile-handlers.js +0 -456
  139. package/dist/src/integrations/mcp/handlers/provider-handlers.js +0 -227
  140. package/dist/src/integrations/ralph/bridge/ralph-stackmemory-bridge.js +0 -863
  141. package/dist/src/integrations/ralph/context/context-budget-manager.js +0 -308
  142. package/dist/src/integrations/ralph/context/stackmemory-context-loader.js +0 -354
  143. package/dist/src/integrations/ralph/index.js +0 -17
  144. package/dist/src/integrations/ralph/learning/pattern-learner.js +0 -416
  145. package/dist/src/integrations/ralph/lifecycle/iteration-lifecycle.js +0 -448
  146. package/dist/src/integrations/ralph/loopmax.js +0 -488
  147. package/dist/src/integrations/ralph/monitoring/swarm-dashboard.js +0 -293
  148. package/dist/src/integrations/ralph/monitoring/swarm-registry.js +0 -107
  149. package/dist/src/integrations/ralph/orchestration/multi-loop-orchestrator.js +0 -508
  150. package/dist/src/integrations/ralph/patterns/compounding-engineering-pattern.js +0 -407
  151. package/dist/src/integrations/ralph/patterns/extended-coherence-sessions.js +0 -495
  152. package/dist/src/integrations/ralph/patterns/oracle-worker-pattern.js +0 -387
  153. package/dist/src/integrations/ralph/performance/performance-optimizer.js +0 -357
  154. package/dist/src/integrations/ralph/recovery/crash-recovery.js +0 -461
  155. package/dist/src/integrations/ralph/state/state-reconciler.js +0 -420
  156. package/dist/src/integrations/ralph/swarm/git-workflow-manager.js +0 -444
  157. package/dist/src/integrations/ralph/swarm/swarm-coordinator.js +0 -1005
  158. package/dist/src/integrations/ralph/visualization/ralph-debugger.js +0 -635
  159. package/scripts/ralph-loop-implementation.js +0 -404
  160. /package/dist/src/{integrations/diffmem/types.js → core/storage/cloud-sync-types.js} +0 -0
  161. /package/dist/src/{integrations/greptile → features/operator}/types.js +0 -0
  162. /package/dist/src/{integrations/ralph/types.js → features/web/client/next-env.d.js} +0 -0
@@ -1,11 +0,0 @@
1
- import { fileURLToPath as __fileURLToPath } from 'url';
2
- import { dirname as __pathDirname } from 'path';
3
- const __filename = __fileURLToPath(import.meta.url);
4
- const __dirname = __pathDirname(__filename);
5
- import { DEFAULT_GREPTILE_CONFIG } from "./config.js";
6
- import { GreptileClient, GreptileClientError } from "./client.js";
7
- export {
8
- DEFAULT_GREPTILE_CONFIG,
9
- GreptileClient,
10
- GreptileClientError
11
- };
@@ -1,188 +0,0 @@
1
- import { fileURLToPath as __fileURLToPath } from 'url';
2
- import { dirname as __pathDirname } from 'path';
3
- const __filename = __fileURLToPath(import.meta.url);
4
- const __dirname = __pathDirname(__filename);
5
- import {
6
- CrossProjectSearch
7
- } from "../../../core/cross-search/cross-project-search.js";
8
- import { logger } from "../../../core/monitoring/logger.js";
9
- class CrossSearchHandlers {
10
- crossSearch;
11
- constructor(deps) {
12
- this.crossSearch = deps.crossSearch || new CrossProjectSearch();
13
- }
14
- /**
15
- * sm_cross_search: Search across all registered project databases.
16
- */
17
- async handleCrossSearch(args) {
18
- try {
19
- const { query, limit = 20, exclude_current = false } = args;
20
- if (!query) {
21
- throw new Error("query is required");
22
- }
23
- const projects = this.crossSearch.listProjects();
24
- if (projects.length === 0) {
25
- return {
26
- content: [
27
- {
28
- type: "text",
29
- text: "No projects registered. Use sm_cross_discover to scan for project databases, or sm_cross_register to add one manually."
30
- }
31
- ]
32
- };
33
- }
34
- const excludeProject = exclude_current ? this.getCurrentProjectName() : void 0;
35
- const start = Date.now();
36
- const results = await this.crossSearch.search({
37
- query,
38
- limit,
39
- excludeProject
40
- });
41
- const elapsed = Date.now() - start;
42
- if (results.length === 0) {
43
- return {
44
- content: [
45
- {
46
- type: "text",
47
- text: `No results found for "${query}" across ${projects.length} project databases (${elapsed}ms).`
48
- }
49
- ]
50
- };
51
- }
52
- const text = this.formatResults(results, query, projects.length, elapsed);
53
- return {
54
- content: [{ type: "text", text }],
55
- metadata: {
56
- results: results.map((r) => ({
57
- project: r.projectName,
58
- frameId: r.frameId,
59
- name: r.name,
60
- score: r.score
61
- })),
62
- total: results.length,
63
- projectsSearched: projects.length,
64
- elapsedMs: elapsed
65
- }
66
- };
67
- } catch (error) {
68
- logger.error(
69
- "Cross-project search failed",
70
- error instanceof Error ? error : new Error(String(error))
71
- );
72
- throw error;
73
- }
74
- }
75
- /**
76
- * sm_cross_discover: Auto-discover project databases.
77
- */
78
- async handleCrossDiscover(args) {
79
- try {
80
- const paths = args.paths;
81
- const discovered = this.crossSearch.discoverProjects(paths);
82
- const all = this.crossSearch.listProjects();
83
- return {
84
- content: [
85
- {
86
- type: "text",
87
- text: `Discovered ${discovered.length} project database(s).
88
- Total registered: ${all.length}
89
-
90
- ` + all.map((p) => ` ${p.name}: ${p.path}
91
- db: ${p.dbPath}`).join("\n")
92
- }
93
- ],
94
- metadata: { discovered: discovered.length, total: all.length }
95
- };
96
- } catch (error) {
97
- logger.error(
98
- "Cross-project discover failed",
99
- error instanceof Error ? error : new Error(String(error))
100
- );
101
- throw error;
102
- }
103
- }
104
- /**
105
- * sm_cross_register: Register a project database manually.
106
- */
107
- async handleCrossRegister(args) {
108
- try {
109
- const { name, path, db_path } = args;
110
- if (!name || !path || !db_path) {
111
- throw new Error("name, path, and db_path are required");
112
- }
113
- this.crossSearch.registerProject({
114
- name,
115
- path,
116
- dbPath: db_path,
117
- lastAccessed: Date.now()
118
- });
119
- return {
120
- content: [
121
- {
122
- type: "text",
123
- text: `Registered project "${name}" at ${path} (db: ${db_path})`
124
- }
125
- ]
126
- };
127
- } catch (error) {
128
- logger.error(
129
- "Cross-project register failed",
130
- error instanceof Error ? error : new Error(String(error))
131
- );
132
- throw error;
133
- }
134
- }
135
- /**
136
- * sm_cross_list: List all registered project databases.
137
- */
138
- async handleCrossList() {
139
- try {
140
- const projects = this.crossSearch.listProjects();
141
- if (projects.length === 0) {
142
- return {
143
- content: [
144
- {
145
- type: "text",
146
- text: "No projects registered. Use sm_cross_discover to scan for project databases."
147
- }
148
- ]
149
- };
150
- }
151
- const text = `Registered projects (${projects.length}):
152
-
153
- ` + projects.map(
154
- (p) => ` ${p.name}
155
- path: ${p.path}
156
- db: ${p.dbPath}
157
- last: ${new Date(p.lastAccessed).toLocaleDateString()}`
158
- ).join("\n");
159
- return {
160
- content: [{ type: "text", text }],
161
- metadata: { projects }
162
- };
163
- } catch (error) {
164
- logger.error(
165
- "Cross-project list failed",
166
- error instanceof Error ? error : new Error(String(error))
167
- );
168
- throw error;
169
- }
170
- }
171
- formatResults(results, query, projectCount, elapsed) {
172
- const header = `Cross-project search: ${results.length} results for "${query}" across ${projectCount} databases (${elapsed}ms):
173
-
174
- `;
175
- const body = results.map(
176
- (r) => `[${r.projectName}] ${r.name} (${r.type}, score: ${r.score.toFixed(3)})` + (r.digestText ? `
177
- ${r.digestText.slice(0, 120)}` : "")
178
- ).join("\n");
179
- return header + body;
180
- }
181
- getCurrentProjectName() {
182
- const cwd = process.cwd();
183
- return cwd.split("/").pop();
184
- }
185
- }
186
- export {
187
- CrossSearchHandlers
188
- };
@@ -1,455 +0,0 @@
1
- import { fileURLToPath as __fileURLToPath } from 'url';
2
- import { dirname as __pathDirname } from 'path';
3
- const __filename = __fileURLToPath(import.meta.url);
4
- const __dirname = __pathDirname(__filename);
5
- import {
6
- DEFAULT_DIFFMEM_CONFIG
7
- } from "../../diffmem/config.js";
8
- import { logger } from "../../../core/monitoring/logger.js";
9
- class DiffMemHandlers {
10
- config;
11
- cache = /* @__PURE__ */ new Map();
12
- cacheTTL = 5 * 60 * 1e3;
13
- // 5 minutes
14
- constructor(deps) {
15
- this.config = { ...DEFAULT_DIFFMEM_CONFIG, ...deps?.config };
16
- }
17
- /**
18
- * Get tool definitions for DiffMem tools
19
- */
20
- getToolDefinitions() {
21
- return [
22
- {
23
- name: "diffmem_get_user_context",
24
- description: "Fetch user knowledge and preferences from memory. Use to personalize responses based on learned user patterns.",
25
- inputSchema: {
26
- type: "object",
27
- properties: {
28
- categories: {
29
- type: "array",
30
- items: {
31
- type: "string",
32
- enum: [
33
- "preference",
34
- "expertise",
35
- "project_knowledge",
36
- "pattern",
37
- "correction"
38
- ]
39
- },
40
- description: "Filter by memory categories"
41
- },
42
- limit: {
43
- type: "number",
44
- default: 10,
45
- description: "Maximum memories to return"
46
- }
47
- }
48
- }
49
- },
50
- {
51
- name: "diffmem_store_learning",
52
- description: "Store a new insight about the user (preference, expertise, pattern, or correction)",
53
- inputSchema: {
54
- type: "object",
55
- properties: {
56
- content: {
57
- type: "string",
58
- description: "The insight to store"
59
- },
60
- category: {
61
- type: "string",
62
- enum: [
63
- "preference",
64
- "expertise",
65
- "project_knowledge",
66
- "pattern",
67
- "correction"
68
- ],
69
- description: "Category of the insight"
70
- },
71
- confidence: {
72
- type: "number",
73
- minimum: 0,
74
- maximum: 1,
75
- default: 0.7,
76
- description: "Confidence level (0-1)"
77
- },
78
- context: {
79
- type: "object",
80
- description: "Additional context for the insight"
81
- }
82
- },
83
- required: ["content", "category"]
84
- }
85
- },
86
- {
87
- name: "diffmem_search",
88
- description: "Semantic search across user memories. Find relevant past insights and preferences.",
89
- inputSchema: {
90
- type: "object",
91
- properties: {
92
- query: {
93
- type: "string",
94
- description: "Search query"
95
- },
96
- timeRange: {
97
- type: "string",
98
- enum: ["day", "week", "month", "all"],
99
- default: "all",
100
- description: "Time range filter"
101
- },
102
- minConfidence: {
103
- type: "number",
104
- minimum: 0,
105
- maximum: 1,
106
- default: 0.5,
107
- description: "Minimum confidence threshold"
108
- },
109
- limit: {
110
- type: "number",
111
- default: 10,
112
- description: "Maximum results"
113
- }
114
- },
115
- required: ["query"]
116
- }
117
- },
118
- {
119
- name: "diffmem_status",
120
- description: "Check DiffMem connection status and memory statistics",
121
- inputSchema: {
122
- type: "object",
123
- properties: {}
124
- }
125
- }
126
- ];
127
- }
128
- /**
129
- * Fetch user context/memories with optional category filter
130
- */
131
- async handleGetUserContext(args) {
132
- const { categories, limit = 10 } = args;
133
- try {
134
- const cacheKey = `context:${JSON.stringify(categories)}:${limit}`;
135
- const cached = this.getFromCache(cacheKey);
136
- if (cached) {
137
- logger.debug("DiffMem cache hit", { cacheKey });
138
- return this.formatMemoriesResponse(cached, true);
139
- }
140
- const query = { limit };
141
- if (categories?.length) {
142
- query.categories = categories;
143
- }
144
- const memories = await this.fetchMemories(query);
145
- this.setCache(cacheKey, memories);
146
- return this.formatMemoriesResponse(memories, false);
147
- } catch (error) {
148
- return this.handleError("getUserContext", error);
149
- }
150
- }
151
- /**
152
- * Store a new learning/insight
153
- */
154
- async handleStoreLearning(args) {
155
- const { content, category, confidence = 0.7, context } = args;
156
- if (!content) {
157
- return {
158
- content: [{ type: "text", text: "Error: content is required" }],
159
- metadata: { error: true }
160
- };
161
- }
162
- if (!category) {
163
- return {
164
- content: [{ type: "text", text: "Error: category is required" }],
165
- metadata: { error: true }
166
- };
167
- }
168
- try {
169
- const insight = {
170
- content,
171
- category,
172
- confidence,
173
- source: "stackmemory",
174
- timestamp: Date.now(),
175
- context
176
- };
177
- await this.storeInsight(insight);
178
- this.invalidateCacheByPrefix("context:");
179
- logger.info("Stored DiffMem insight", { category, confidence });
180
- return {
181
- content: [
182
- {
183
- type: "text",
184
- text: `Stored ${category} insight: "${content.substring(0, 50)}${content.length > 50 ? "..." : ""}"`
185
- }
186
- ],
187
- metadata: {
188
- stored: true,
189
- category,
190
- confidence
191
- }
192
- };
193
- } catch (error) {
194
- return this.handleError("storeLearning", error);
195
- }
196
- }
197
- /**
198
- * Semantic search across memories
199
- */
200
- async handleSearch(args) {
201
- const { query, timeRange = "all", minConfidence = 0.5, limit = 10 } = args;
202
- if (!query) {
203
- return {
204
- content: [{ type: "text", text: "Error: query is required" }],
205
- metadata: { error: true }
206
- };
207
- }
208
- try {
209
- const searchQuery = {
210
- query,
211
- timeRange,
212
- minConfidence,
213
- limit
214
- };
215
- const results = await this.searchMemories(searchQuery);
216
- if (results.length === 0) {
217
- return {
218
- content: [
219
- {
220
- type: "text",
221
- text: `No memories found matching "${query}"`
222
- }
223
- ],
224
- metadata: {
225
- query,
226
- resultCount: 0
227
- }
228
- };
229
- }
230
- const formattedResults = results.map(
231
- (m, i) => `${i + 1}. [${m.category}] ${m.content} (confidence: ${(m.confidence * 100).toFixed(0)}%)`
232
- ).join("\n");
233
- return {
234
- content: [
235
- {
236
- type: "text",
237
- text: `Search results for "${query}":
238
- ${formattedResults}`
239
- }
240
- ],
241
- metadata: {
242
- query,
243
- resultCount: results.length,
244
- results: results.map((m) => ({
245
- id: m.id,
246
- category: m.category,
247
- confidence: m.confidence
248
- }))
249
- }
250
- };
251
- } catch (error) {
252
- return this.handleError("search", error);
253
- }
254
- }
255
- /**
256
- * Get DiffMem connection status
257
- */
258
- async handleStatus() {
259
- try {
260
- const status = await this.getStatus();
261
- const statusText = status.connected ? `DiffMem Status:
262
- - Connected: Yes
263
- - Memories: ${status.memoryCount}
264
- - Last sync: ${status.lastSync ? new Date(status.lastSync).toISOString() : "Never"}
265
- - Version: ${status.version || "Unknown"}` : `DiffMem Status:
266
- - Connected: No
267
- - Endpoint: ${this.config.endpoint}
268
- - Enabled: ${this.config.enabled}`;
269
- return {
270
- content: [{ type: "text", text: statusText }],
271
- metadata: status
272
- };
273
- } catch (error) {
274
- return this.handleError("status", error);
275
- }
276
- }
277
- // Private helper methods
278
- formatMemoriesResponse(memories, fromCache) {
279
- if (memories.length === 0) {
280
- return {
281
- content: [
282
- {
283
- type: "text",
284
- text: "No user context memories found."
285
- }
286
- ],
287
- metadata: { fromCache, count: 0 }
288
- };
289
- }
290
- const byCategory = memories.reduce(
291
- (acc, m) => {
292
- if (!acc[m.category]) {
293
- acc[m.category] = [];
294
- }
295
- acc[m.category].push(m);
296
- return acc;
297
- },
298
- {}
299
- );
300
- const sections = Object.entries(byCategory).map(([category, mems]) => {
301
- const items = mems.map(
302
- (m) => ` - ${m.content} (${(m.confidence * 100).toFixed(0)}% confidence)`
303
- ).join("\n");
304
- return `${category.toUpperCase()}:
305
- ${items}`;
306
- }).join("\n\n");
307
- return {
308
- content: [
309
- {
310
- type: "text",
311
- text: `User Context:
312
-
313
- ${sections}`
314
- }
315
- ],
316
- metadata: {
317
- fromCache,
318
- count: memories.length,
319
- categories: Object.keys(byCategory)
320
- }
321
- };
322
- }
323
- handleError(operation, error) {
324
- const errorMessage = error instanceof Error ? error.message : String(error);
325
- const isConnectionError = errorMessage.includes("ECONNREFUSED") || errorMessage.includes("fetch failed") || errorMessage.includes("network");
326
- logger.warn(`DiffMem ${operation} failed`, { error: errorMessage });
327
- if (isConnectionError) {
328
- return {
329
- content: [
330
- {
331
- type: "text",
332
- text: `DiffMem unavailable (${operation}). Session continues without user memory.`
333
- }
334
- ],
335
- metadata: {
336
- error: true,
337
- unavailable: true,
338
- operation
339
- }
340
- };
341
- }
342
- return {
343
- content: [
344
- {
345
- type: "text",
346
- text: `DiffMem ${operation} error: ${errorMessage}`
347
- }
348
- ],
349
- metadata: {
350
- error: true,
351
- operation,
352
- message: errorMessage
353
- }
354
- };
355
- }
356
- getFromCache(key) {
357
- const entry = this.cache.get(key);
358
- if (!entry) return void 0;
359
- if (Date.now() - entry.timestamp > this.cacheTTL) {
360
- this.cache.delete(key);
361
- return void 0;
362
- }
363
- return entry.data;
364
- }
365
- setCache(key, data) {
366
- this.cache.set(key, { data, timestamp: Date.now() });
367
- }
368
- invalidateCacheByPrefix(prefix) {
369
- for (const key of this.cache.keys()) {
370
- if (key.startsWith(prefix)) {
371
- this.cache.delete(key);
372
- }
373
- }
374
- }
375
- // API interaction methods (with graceful degradation)
376
- async fetchMemories(query) {
377
- if (!this.config.enabled) {
378
- return [];
379
- }
380
- const response = await fetch(`${this.config.endpoint}/memories`, {
381
- method: "POST",
382
- headers: { "Content-Type": "application/json" },
383
- body: JSON.stringify(query),
384
- signal: AbortSignal.timeout(this.config.timeout)
385
- });
386
- if (!response.ok) {
387
- throw new Error(`DiffMem API error: ${response.status}`);
388
- }
389
- const data = await response.json();
390
- return data.memories || [];
391
- }
392
- async searchMemories(query) {
393
- if (!this.config.enabled) {
394
- return [];
395
- }
396
- const response = await fetch(`${this.config.endpoint}/search`, {
397
- method: "POST",
398
- headers: { "Content-Type": "application/json" },
399
- body: JSON.stringify(query),
400
- signal: AbortSignal.timeout(this.config.timeout)
401
- });
402
- if (!response.ok) {
403
- throw new Error(`DiffMem API error: ${response.status}`);
404
- }
405
- const data = await response.json();
406
- return data.results || [];
407
- }
408
- async storeInsight(insight) {
409
- if (!this.config.enabled) {
410
- logger.debug("DiffMem disabled, skipping store");
411
- return;
412
- }
413
- const response = await fetch(`${this.config.endpoint}/insights`, {
414
- method: "POST",
415
- headers: { "Content-Type": "application/json" },
416
- body: JSON.stringify(insight),
417
- signal: AbortSignal.timeout(this.config.timeout)
418
- });
419
- if (!response.ok) {
420
- throw new Error(`DiffMem API error: ${response.status}`);
421
- }
422
- }
423
- async getStatus() {
424
- if (!this.config.enabled) {
425
- return {
426
- connected: false,
427
- memoryCount: 0,
428
- lastSync: null
429
- };
430
- }
431
- try {
432
- const response = await fetch(`${this.config.endpoint}/status`, {
433
- method: "GET",
434
- signal: AbortSignal.timeout(this.config.timeout)
435
- });
436
- if (!response.ok) {
437
- return {
438
- connected: false,
439
- memoryCount: 0,
440
- lastSync: null
441
- };
442
- }
443
- return await response.json();
444
- } catch {
445
- return {
446
- connected: false,
447
- memoryCount: 0,
448
- lastSync: null
449
- };
450
- }
451
- }
452
- }
453
- export {
454
- DiffMemHandlers
455
- };