@riligar/agents-memories 1.3.0 → 1.4.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 (2) hide show
  1. package/package.json +1 -1
  2. package/src/server/mcp-server.js +18 -17
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@riligar/agents-memories",
3
- "version": "1.3.0",
3
+ "version": "1.4.0",
4
4
  "description": "RiLiGar Agents Memories - A self-improving relational memory system for AI agents.",
5
5
  "module": "src/index.js",
6
6
  "main": "src/index.js",
package/src/server/mcp-server.js CHANGED
@@ -21,64 +21,65 @@ export function createMcpServer(memorySystem) {
21
21
  tools: [
22
22
  {
23
23
  name: 'save',
24
- description: 'Saves info with Resonance and Auto-Bridging. SIP Note: Capture the Rationale (the "Why") to enable Pattern Mining.',
24
+ description: 'Primary "CAPTURE" tool for the RiLiGar Self-Improvement Protocol (SIP). Saves information into the Relational Knowledge Graph using Resonance Intelligence and Auto-Bridging. IMPORTANT: Always include the "Rationale" (the "Why") within the content to enable future Pattern Mining. Supports batch saving via arrays.',
25
25
  inputSchema: {
26
26
  type: 'object',
27
27
  properties: {
28
28
  content: {
29
+ description: 'The information to persist. For architectural decisions, include the technical Rationale.',
29
30
  oneOf: [
30
31
  { type: 'string' },
31
32
  { type: 'array', items: { anyOf: [
32
33
  { type: 'string' },
33
34
  { type: 'object', properties: {
34
- content: { type: 'string' },
35
- path: { type: 'string' },
36
- owner_id: { type: 'string' },
37
- priority: { type: 'integer' }
35
+ content: { type: 'string', description: 'The main data/lesson/decision text.' },
36
+ path: { type: 'string', description: 'Dot-notation path (e.g., Project.Architecture.Storage).' },
37
+ owner_id: { type: 'string', description: 'Agent/User identity for ownership.' },
38
+ priority: { type: 'integer', description: 'Base priority (0-10) for Resonance rippling.' }
38
39
  }, required: ['content'] }
39
40
  ] } }
40
41
  ],
41
42
  },
42
- path: { type: 'string' },
43
- owner_id: { type: 'string' },
44
- priority: { type: 'integer' },
43
+ path: { type: 'string', description: 'Hierarchical path (e.g., Self.Ethics.Protocol or Patterns.SOTA.Elysia).' },
44
+ owner_id: { type: 'string', description: 'Identity string of the memory owner.' },
45
+ priority: { type: 'integer', description: 'Initial importance; triggers priority adjustment in semantic neighbors.' },
45
46
  },
46
47
  required: ['content'],
47
48
  },
48
49
  },
49
50
  {
50
51
  name: 'bridge',
51
- description: 'Manually connects two memory paths.',
52
+ description: 'Establish explicit "Relational Intelligence" by connecting two disparate memory paths. Use this to document logical dependencies (depends_on), hierarchies (part_of), or implementation requirements that semantic similarity might not immediately detect.',
52
53
  inputSchema: {
53
54
  type: 'object',
54
55
  properties: {
55
- source_path: { type: 'string' },
56
- target_path: { type: 'string' },
57
- relation: { type: 'string', default: 'related_to' },
56
+ source_path: { type: 'string', description: 'The origin path of the relationship.' },
57
+ target_path: { type: 'string', description: 'The destination path of the relationship.' },
58
+ relation: { type: 'string', default: 'related_to', description: 'The type of connection: depends_on, part_of, implements, conflicts_with, etc.' },
58
59
  },
59
60
  required: ['source_path', 'target_path'],
60
61
  },
61
62
  },
62
63
  {
63
64
  name: 'search',
64
- description: 'Semantic search with Relational Awareness. Use for Pattern Mining and Error Avoidance (SIP).',
65
+ description: 'Execute "Reflexive Cognition". Performs a Relational Semantic Search across memories. Agents MUST use this proactively before complex tasks to find past "Lessons Learned", "Rationales", or "Errors" related to the current context. Results are ranked by Similarity (60%) and Recency (40%).',
65
66
  inputSchema: {
66
67
  type: 'object',
67
68
  properties: {
68
- query: { type: 'string' },
69
- path_filter: { type: 'string' },
69
+ query: { type: 'string', description: 'Semantic search query (e.g., "how we optimized sidebar storage").' },
70
+ path_filter: { type: 'string', description: 'Filter by path prefix (e.g., "Project.Architecture").' },
70
71
  },
71
72
  required: ['query'],
72
73
  },
73
74
  },
74
75
  {
75
76
  name: 'inspect',
76
- description: 'Visualizes the Knowledge Graph in Mermaid.js syntax. Use for Architecture Audit (SIP).',
77
+ description: 'Visualize the Relational Knowledge Graph in Mermaid.js syntax. Critical for the "Self-Critique" phase of SIP. Use it to audit system architecture, browse cognitive connections, and ensure no architectural drift has occurred.',
77
78
  inputSchema: { type: 'object', properties: {} },
78
79
  },
79
80
  {
80
81
  name: 'list',
81
- description: 'Lists all memory paths.',
82
+ description: 'List all unique memory paths (namespace discovery). Use this to explore the hierarchy and understand the available knowledge domains before performing targeted searches or saves.',
82
83
  inputSchema: { type: 'object', properties: {} },
83
84
  },
84
85
  ],