memo-grafter 0.1.0 → 0.2.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 (136) hide show
  1. package/.env.example +5 -3
  2. package/README.md +187 -182
  3. package/USER_GUIDE.md +932 -702
  4. package/dist/MemoGrafter.d.ts +1 -1
  5. package/dist/MemoGrafter.d.ts.map +1 -1
  6. package/dist/MemoGrafter.js +16 -5
  7. package/dist/MemoGrafter.js.map +1 -1
  8. package/dist/MemoGrafterAgent.d.ts +7 -1
  9. package/dist/MemoGrafterAgent.d.ts.map +1 -1
  10. package/dist/MemoGrafterAgent.js +45 -8
  11. package/dist/MemoGrafterAgent.js.map +1 -1
  12. package/dist/adapters/AnthropicAdapter.d.ts +9 -0
  13. package/dist/adapters/AnthropicAdapter.d.ts.map +1 -0
  14. package/dist/adapters/AnthropicAdapter.js +33 -0
  15. package/dist/adapters/AnthropicAdapter.js.map +1 -0
  16. package/dist/adapters/GeminiAdapter.d.ts +15 -0
  17. package/dist/adapters/GeminiAdapter.d.ts.map +1 -0
  18. package/dist/adapters/GeminiAdapter.js +48 -0
  19. package/dist/adapters/GeminiAdapter.js.map +1 -0
  20. package/dist/fleet/FleetStore.d.ts +1 -1
  21. package/dist/fleet/FleetStore.d.ts.map +1 -1
  22. package/dist/index.d.ts +5 -1
  23. package/dist/index.d.ts.map +1 -1
  24. package/dist/index.js +3 -0
  25. package/dist/index.js.map +1 -1
  26. package/dist/pipeline/GrafterPipeline.d.ts +1 -3
  27. package/dist/pipeline/GrafterPipeline.d.ts.map +1 -1
  28. package/dist/pipeline/GrafterPipeline.js +6 -19
  29. package/dist/pipeline/GrafterPipeline.js.map +1 -1
  30. package/dist/pipeline/IngestPipeline.d.ts +7 -3
  31. package/dist/pipeline/IngestPipeline.d.ts.map +1 -1
  32. package/dist/pipeline/IngestPipeline.js +31 -5
  33. package/dist/pipeline/IngestPipeline.js.map +1 -1
  34. package/dist/pipeline/RetrieverPipeline.d.ts +11 -0
  35. package/dist/pipeline/RetrieverPipeline.d.ts.map +1 -0
  36. package/dist/pipeline/RetrieverPipeline.js +73 -0
  37. package/dist/pipeline/RetrieverPipeline.js.map +1 -0
  38. package/dist/pipeline/SegmentProcessor.d.ts +3 -2
  39. package/dist/pipeline/SegmentProcessor.d.ts.map +1 -1
  40. package/dist/pipeline/SegmentProcessor.js +52 -40
  41. package/dist/pipeline/SegmentProcessor.js.map +1 -1
  42. package/dist/pipeline/TopicDriftDetector.d.ts +21 -3
  43. package/dist/pipeline/TopicDriftDetector.d.ts.map +1 -1
  44. package/dist/pipeline/TopicDriftDetector.js +143 -17
  45. package/dist/pipeline/TopicDriftDetector.js.map +1 -1
  46. package/dist/prompts/factRetrievalPrompt.d.ts +4 -0
  47. package/dist/prompts/factRetrievalPrompt.d.ts.map +1 -0
  48. package/dist/prompts/factRetrievalPrompt.js +25 -0
  49. package/dist/prompts/factRetrievalPrompt.js.map +1 -0
  50. package/dist/prompts/historyCompressionPrompt.d.ts +3 -0
  51. package/dist/prompts/historyCompressionPrompt.d.ts.map +1 -0
  52. package/dist/prompts/historyCompressionPrompt.js +4 -0
  53. package/dist/prompts/historyCompressionPrompt.js.map +1 -0
  54. package/dist/prompts/intentShiftPrompt.d.ts +3 -0
  55. package/dist/prompts/intentShiftPrompt.d.ts.map +1 -0
  56. package/dist/prompts/intentShiftPrompt.js +11 -0
  57. package/dist/prompts/intentShiftPrompt.js.map +1 -0
  58. package/dist/prompts/memoryInjectionPrompt.d.ts +4 -0
  59. package/dist/prompts/memoryInjectionPrompt.d.ts.map +1 -0
  60. package/dist/prompts/memoryInjectionPrompt.js +16 -0
  61. package/dist/prompts/memoryInjectionPrompt.js.map +1 -0
  62. package/dist/prompts/segmentExtractionPrompt.d.ts +3 -0
  63. package/dist/prompts/segmentExtractionPrompt.d.ts.map +1 -0
  64. package/dist/prompts/segmentExtractionPrompt.js +81 -0
  65. package/dist/prompts/segmentExtractionPrompt.js.map +1 -0
  66. package/dist/store/GraphStore.d.ts +16 -19
  67. package/dist/store/GraphStore.d.ts.map +1 -1
  68. package/dist/store/GraphStore.js +1 -576
  69. package/dist/store/GraphStore.js.map +1 -1
  70. package/dist/store/index.d.ts +3 -0
  71. package/dist/store/index.d.ts.map +1 -0
  72. package/dist/store/index.js +2 -0
  73. package/dist/store/index.js.map +1 -0
  74. package/dist/store/postgres-pgvector/GraphStore.d.ts +75 -0
  75. package/dist/store/postgres-pgvector/GraphStore.d.ts.map +1 -0
  76. package/dist/store/postgres-pgvector/GraphStore.js +782 -0
  77. package/dist/store/postgres-pgvector/GraphStore.js.map +1 -0
  78. package/dist/types.d.ts +69 -1
  79. package/dist/types.d.ts.map +1 -1
  80. package/dist/utils/drift/driftMarkers.d.ts +4 -0
  81. package/dist/utils/drift/driftMarkers.d.ts.map +1 -0
  82. package/dist/utils/drift/driftMarkers.js +31 -0
  83. package/dist/utils/drift/driftMarkers.js.map +1 -0
  84. package/dist/utils/drift/driftScore.d.ts +3 -0
  85. package/dist/utils/drift/driftScore.d.ts.map +1 -0
  86. package/dist/utils/drift/driftScore.js +11 -0
  87. package/dist/utils/drift/driftScore.js.map +1 -0
  88. package/dist/utils/drift/driftThreshold.d.ts +7 -0
  89. package/dist/utils/drift/driftThreshold.d.ts.map +1 -0
  90. package/dist/utils/drift/driftThreshold.js +21 -0
  91. package/dist/utils/drift/driftThreshold.js.map +1 -0
  92. package/dist/utils/drift/reentryMatch.d.ts +3 -0
  93. package/dist/utils/drift/reentryMatch.d.ts.map +1 -0
  94. package/dist/utils/drift/reentryMatch.js +10 -0
  95. package/dist/utils/drift/reentryMatch.js.map +1 -0
  96. package/dist/utils/extraction/segmentExtraction.d.ts +5 -0
  97. package/dist/utils/extraction/segmentExtraction.d.ts.map +1 -0
  98. package/dist/utils/extraction/segmentExtraction.js +82 -0
  99. package/dist/utils/extraction/segmentExtraction.js.map +1 -0
  100. package/dist/utils/reentry/reentryCues.d.ts +3 -0
  101. package/dist/utils/reentry/reentryCues.d.ts.map +1 -0
  102. package/dist/utils/reentry/reentryCues.js +14 -0
  103. package/dist/utils/reentry/reentryCues.js.map +1 -0
  104. package/dist/utils/reentry/reentryEdges.d.ts +16 -0
  105. package/dist/utils/reentry/reentryEdges.d.ts.map +1 -0
  106. package/dist/utils/reentry/reentryEdges.js +80 -0
  107. package/dist/utils/reentry/reentryEdges.js.map +1 -0
  108. package/dist/utils/reentry/reentrySimilarity.d.ts +5 -0
  109. package/dist/utils/reentry/reentrySimilarity.d.ts.map +1 -0
  110. package/dist/utils/reentry/reentrySimilarity.js +26 -0
  111. package/dist/utils/reentry/reentrySimilarity.js.map +1 -0
  112. package/dist/utils/reentry/reentryText.d.ts +6 -0
  113. package/dist/utils/reentry/reentryText.d.ts.map +1 -0
  114. package/dist/utils/reentry/reentryText.js +29 -0
  115. package/dist/utils/reentry/reentryText.js.map +1 -0
  116. package/dist/utils/reentry/types.d.ts +6 -0
  117. package/dist/utils/reentry/types.d.ts.map +1 -0
  118. package/dist/utils/reentry/types.js +2 -0
  119. package/dist/utils/reentry/types.js.map +1 -0
  120. package/dist/utils/text/normalizeText.d.ts +2 -0
  121. package/dist/utils/text/normalizeText.d.ts.map +1 -0
  122. package/dist/utils/text/normalizeText.js +5 -0
  123. package/dist/utils/text/normalizeText.js.map +1 -0
  124. package/dist/utils/text/terms.d.ts +3 -0
  125. package/dist/utils/text/terms.d.ts.map +1 -0
  126. package/dist/utils/text/terms.js +51 -0
  127. package/dist/utils/text/terms.js.map +1 -0
  128. package/dist/utils/text/tokenCount.d.ts +2 -0
  129. package/dist/utils/text/tokenCount.d.ts.map +1 -0
  130. package/dist/utils/text/tokenCount.js +4 -0
  131. package/dist/utils/text/tokenCount.js.map +1 -0
  132. package/dist/utils/vector/vectorLiteral.d.ts +3 -0
  133. package/dist/utils/vector/vectorLiteral.d.ts.map +1 -0
  134. package/dist/utils/vector/vectorLiteral.js +19 -0
  135. package/dist/utils/vector/vectorLiteral.js.map +1 -0
  136. package/package.json +84 -55
@@ -0,0 +1,75 @@
1
+ import type { FleetAgentRecord, GraphStore } from "../GraphStore.js";
2
+ import type { MemoryNode, MemoryNodeInsert, Message, TopicEdge, TopicNode, TopicSegment } from "../../types.js";
3
+ interface AbsorbOptions {
4
+ agentColor?: string | null;
5
+ fleetId?: string | null;
6
+ agentId?: string | null;
7
+ }
8
+ export declare class PostgresGraphStore implements GraphStore {
9
+ private readonly sql;
10
+ constructor(connectionString: string);
11
+ initialize(): Promise<void>;
12
+ saveMessages(sessionId: string, messages: Message[]): Promise<void>;
13
+ saveMessagesAt(sessionId: string, startIndex: number, messages: Message[]): Promise<void>;
14
+ saveSegment(segment: TopicSegment): Promise<TopicSegment>;
15
+ saveNode(node: TopicNode): Promise<void>;
16
+ saveEdge(edge: TopicEdge): Promise<void>;
17
+ getEdgesByType(sessionId: string, type: string): Promise<TopicEdge[]>;
18
+ clearSession(sessionId: string): Promise<void>;
19
+ clearSessionGraph(sessionId: string): Promise<void>;
20
+ getTopicNode(topicNodeId: string, sessionId?: string): Promise<TopicNode | null>;
21
+ getNodeBySegment(segmentId: string): Promise<TopicNode | null>;
22
+ getNodesBySession(sessionId: string): Promise<TopicNode[]>;
23
+ getSegmentsBySession(sessionId: string): Promise<TopicSegment[]>;
24
+ insertMemories(nodes: MemoryNodeInsert[]): Promise<void>;
25
+ getMemoriesBySegment(segmentId: string): Promise<MemoryNode[]>;
26
+ getMemoriesByTopic(topicNodeId: string): Promise<MemoryNode[]>;
27
+ searchMemories(embedding: number[], sessionId: string, limit: number, minSimilarity: number): Promise<(MemoryNode & {
28
+ similarity: number;
29
+ })[]>;
30
+ buildMemoryEdges(topicNodeId: string, sessionId: string, threshold: number): Promise<void>;
31
+ getTopKSimilar(nodeId: string, embedding: number[], sessionId: string, k: number): Promise<TopicNode[]>;
32
+ getSimilarNodes(embedding: number[], sessionId: string, options?: {
33
+ k?: number;
34
+ excludeNodeId?: string;
35
+ minSimilarity?: number;
36
+ }): Promise<TopicNode[]>;
37
+ getSimilarNodesAcrossFleet(fleetId: string, embedding: number[], options?: {
38
+ k?: number;
39
+ excludeNodeId?: string;
40
+ minSimilarity?: number;
41
+ agentColor?: string;
42
+ }): Promise<TopicNode[]>;
43
+ getNodesByColor(fleetId: string, agentColor: string): Promise<TopicNode[]>;
44
+ saveFleet(fleetId: string, name?: string): Promise<void>;
45
+ saveFleetAgent(agent: {
46
+ id: string;
47
+ fleetId: string;
48
+ sessionId: string;
49
+ agentColor: string;
50
+ }): Promise<void>;
51
+ getFleetAgents(fleetId: string): Promise<FleetAgentRecord[]>;
52
+ tagSessionNodes(sessionId: string, metadata: {
53
+ fleetId: string | null;
54
+ agentId: string | null;
55
+ agentColor: string | null;
56
+ }): Promise<void>;
57
+ getPreviousNode(sessionId: string, topicOrder: number): Promise<TopicNode | null>;
58
+ nodeSimilarity(nodeAId: string, nodeBId: string): Promise<number>;
59
+ getNeighbours(nodeIds: string[], hopDepth: number, sessionId?: string): Promise<TopicNode[]>;
60
+ getBufferMessages(sessionId: string, start: number, end: number, maxChars?: number): Promise<Message[]>;
61
+ absorbNodes(nodes: TopicNode[], targetSessionId: string, options?: AbsorbOptions): Promise<TopicNode[]>;
62
+ rebuildEdgesForSession(sessionId: string, semanticTopK?: number, semanticThreshold?: number): Promise<void>;
63
+ close(): Promise<void>;
64
+ private migrateExistingNodeTable;
65
+ private createIndexes;
66
+ private cleanAssistantMessage;
67
+ private getNextMessageIndex;
68
+ private getNextTopicOrder;
69
+ private formatGraftedMemoryMessage;
70
+ private rowToNode;
71
+ private rowToMemoryNode;
72
+ private rowToSegment;
73
+ }
74
+ export {};
75
+ //# sourceMappingURL=GraphStore.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GraphStore.d.ts","sourceRoot":"","sources":["../../../src/store/postgres-pgvector/GraphStore.ts"],"names":[],"mappings":"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"}