@memberjunction/ai-agents 4.2.0 → 4.3.1

package/dist/memory-manager-agent.d.ts

@@ -1,4 +1,5 @@
 import { BaseAgent } from './base-agent.js';
+import { UserInfo } from '@memberjunction/core';
 import { ExecuteAgentParams, AgentConfiguration, BaseAgentNextStep } from '@memberjunction/ai-core-plus';
 /**
  * Memory Manager Agent - automatically extracts notes and examples from conversations.
@@ -69,6 +70,52 @@ export declare class MemoryManagerAgent extends BaseAgent {
      * Inherits scope from source agent run and applies scopeLevel to determine scope specificity.
      */
     private CreateNoteRecords;
+    /**
+     * Collapse merge candidates with identical content into a single candidate
+     * carrying all merge target IDs. This prevents duplicate active notes when
+     * a contradiction invalidates multiple existing notes (e.g., "I hate pizza"
+     * replacing both a pepperoni note and a mushrooms note).
+     */
+    private collapseMergeCandidates;
+    /**
+     * Determine whether consolidation should run based on CONSOLIDATION_CONFIG.frequency.
+     * Uses AIAgentRun history instead of static in-memory state so that timing
+     * survives process restarts and works correctly across clustered instances.
+     *
+     * Supports:
+     * - 'every-run': Always run
+     * - 'hourly': Run if 1+ hour since last completed MM run
+     * - 'daily': Run if 24+ hours since last completed MM run
+     * - number: Run every N completed MM runs
+     */
+    private shouldRunConsolidation;
+    /**
+     * Consolidate related notes into single, comprehensive notes.
+     * This method finds clusters of similar notes and synthesizes them.
+     *
+     * @param agentId Optional - consolidate notes for a specific agent only
+     * @param contextUser The context user for database operations
+     * @returns Number of notes consolidated (archived)
+     */
+    consolidateRelatedNotes(agentId: string | null, contextUser: UserInfo): Promise<{
+        consolidated: number;
+        archived: number;
+    }>;
+    /**
+     * Find clusters of semantically similar notes suitable for consolidation.
+     * Each cluster contains notes that exceed the similarity threshold and meet the minimum cluster size.
+     */
+    private findConsolidationClusters;
+    /**
+     * Process a single consolidation cluster: run the LLM prompt, create the consolidated note,
+     * and revoke source notes.
+     */
+    private processConsolidationCluster;
+    /**
+     * Apply scope fields to a consolidated note based on the LLM's scope recommendation.
+     * Mirrors the scoping logic in CreateNoteRecords.
+     */
+    private applyScopeToConsolidatedNote;
     /**
      * Create example records from extracted data.
      * Inherits scope from source agent run and applies scopeLevel to determine scope specificity.

package/dist/memory-manager-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-manager-agent.d.ts","sourceRoot":"","sources":["../src/memory-manager-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAYzC,OAAO,EAAkB,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAyB,MAAM,8BAA8B,CAAC;AAmHhJ;;;;GAIG;AACH,qBACa,kBAAmB,SAAQ,SAAS;IAC7C,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAkB;IAClC,0CAA0C;IAC1C,OAAO,CAAC,WAAW,CAAuB;IAC1C,iDAAiD;IACjD,OAAO,CAAC,YAAY,CAAa;IACjC,uCAAuC;IACvC,OAAO,CAAC,YAAY,CAAyB;IAE7C;;;OAGG;YACW,aAAa;IAyC3B;;OAEG;YACW,eAAe;IAoC7B;;;OAGG;YACW,cAAc;IAoB5B;;;OAGG;YACW,qBAAqB;IA0BnC;;;;OAIG;YACW,gCAAgC;IA8E9C;;;OAGG;YACW,sBAAsB;IAuCpC;;;;OAIG;YACW,6BAA6B;IA4C3C;;;OAGG;YACW,qBAAqB;IA6QnC;;;OAGG;YACW,eAAe;IAgJ7B;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;;OAGG;YACW,iBAAiB;IAkI/B;;;OAGG;YACW,oBAAoB;IAoGlC;;OAEG;cACa,oBAAoB,CAAC,CAAC,GAAG,GAAG,EACxC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,GAC3B,OAAO,CAAC;QAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAC;CAgLnE"}
+{"version":3,"file":"memory-manager-agent.d.ts","sourceRoot":"","sources":["../src/memory-manager-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAoD,MAAM,sBAAsB,CAAC;AAUlG,OAAO,EAAqC,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAiD,MAAM,8BAA8B,CAAC;AAuI3L;;;;GAIG;AACH,qBACa,kBAAmB,SAAQ,SAAS;IAC7C,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAkB;IAClC,0CAA0C;IAC1C,OAAO,CAAC,WAAW,CAAuB;IAC1C,iDAAiD;IACjD,OAAO,CAAC,YAAY,CAAa;IACjC,uCAAuC;IACvC,OAAO,CAAC,YAAY,CAAyB;IAE7C;;;OAGG;YACW,aAAa;IAyC3B;;OAEG;YACW,eAAe;IAoC7B;;;OAGG;YACW,cAAc;IAoB5B;;;OAGG;YACW,qBAAqB;IA0BnC;;;;OAIG;YACW,gCAAgC;IA8E9C;;;OAGG;YACW,sBAAsB;IAuCpC;;;;OAIG;YACW,6BAA6B;IA4C3C;;;OAGG;YACW,qBAAqB;IA+SnC;;;OAGG;YACW,eAAe;IAmJ7B;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;;OAGG;YACW,iBAAiB;IA8I/B;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;;;;;;;;;OAUG;YACW,sBAAsB;IAqCpC;;;;;;;OAOG;IACU,uBAAuB,CAChC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,WAAW,EAAE,QAAQ,GACtB,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAsEtD;;;OAGG;YACW,yBAAyB;IAoCvC;;;OAGG;YACW,2BAA2B;IAiHzC;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAuBpC;;;OAGG;YACW,oBAAoB;IAoGlC;;OAEG;cACa,oBAAoB,CAAC,CAAC,GAAG,GAAG,EACxC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,GAC3B,OAAO,CAAC;QAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAC;CAkMnE"}