@memberjunction/ai-agents 3.3.0 → 4.0.0

package/dist/index.d.ts

@@ -1,15 +1,25 @@
-export * from './agent-types/base-agent-type';
-export * from './agent-types/loop-agent-response-type';
-export * from './agent-types/loop-agent-prompt-params';
-export * from './base-agent';
-export * from './agent-types';
-export * from './AgentRunner';
-export * from './PayloadManager';
-export * from './PayloadChangeAnalyzer';
-export * from './PayloadFeedbackManager';
-export * from './types/payload-operations';
-export * from './AgentDataPreloader';
-export * from './agent-context-injector';
-export * from './memory-manager-agent';
-export { RerankerService, RerankerConfiguration, parseRerankerConfiguration, RerankServiceResult, RerankObservabilityOptions, LLMReranker, LoadLLMReranker } from '@memberjunction/ai-reranker';
+/**
+ * @fileoverview Main export module for the MemberJunction AI Agent framework.
+ *
+ * This module exports all public APIs for the AI Agent system, including
+ * base classes, type definitions, and utility functions.
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ * @since 2.49.0
+ */
+export * from './agent-types/base-agent-type.js';
+export * from './agent-types/loop-agent-response-type.js';
+export * from './agent-types/loop-agent-prompt-params.js';
+export * from './base-agent.js';
+export * from './agent-types/index.js';
+export * from './AgentRunner.js';
+export * from './PayloadManager.js';
+export * from './PayloadChangeAnalyzer.js';
+export * from './PayloadFeedbackManager.js';
+export * from './types/payload-operations.js';
+export * from './AgentDataPreloader.js';
+export * from './agent-context-injector.js';
+export * from './memory-manager-agent.js';
+export { RerankerService, RerankerConfiguration, parseRerankerConfiguration, RerankServiceResult, RerankObservabilityOptions, LLMReranker } from '@memberjunction/ai-reranker';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AAGvC,OAAO,EACH,eAAe,EACf,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,WAAW,EACX,eAAe,EAClB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AAGvC,OAAO,EACH,eAAe,EACf,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,WAAW,EACd,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -1,36 +1,26 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LoadLLMReranker = exports.LLMReranker = exports.parseRerankerConfiguration = exports.RerankerService = void 0;
-__exportStar(require("./agent-types/base-agent-type"), exports);
-__exportStar(require("./agent-types/loop-agent-response-type"), exports);
-__exportStar(require("./agent-types/loop-agent-prompt-params"), exports);
-__exportStar(require("./base-agent"), exports);
-__exportStar(require("./agent-types"), exports);
-__exportStar(require("./AgentRunner"), exports);
-__exportStar(require("./PayloadManager"), exports);
-__exportStar(require("./PayloadChangeAnalyzer"), exports);
-__exportStar(require("./PayloadFeedbackManager"), exports);
-__exportStar(require("./types/payload-operations"), exports);
-__exportStar(require("./AgentDataPreloader"), exports);
-__exportStar(require("./agent-context-injector"), exports);
-__exportStar(require("./memory-manager-agent"), exports);
-var ai_reranker_1 = require("@memberjunction/ai-reranker");
-Object.defineProperty(exports, "RerankerService", { enumerable: true, get: function () { return ai_reranker_1.RerankerService; } });
-Object.defineProperty(exports, "parseRerankerConfiguration", { enumerable: true, get: function () { return ai_reranker_1.parseRerankerConfiguration; } });
-Object.defineProperty(exports, "LLMReranker", { enumerable: true, get: function () { return ai_reranker_1.LLMReranker; } });
-Object.defineProperty(exports, "LoadLLMReranker", { enumerable: true, get: function () { return ai_reranker_1.LoadLLMReranker; } });
+/**
+ * @fileoverview Main export module for the MemberJunction AI Agent framework.
+ *
+ * This module exports all public APIs for the AI Agent system, including
+ * base classes, type definitions, and utility functions.
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ * @since 2.49.0
+ */
+export * from './agent-types/base-agent-type.js';
+export * from './agent-types/loop-agent-response-type.js';
+export * from './agent-types/loop-agent-prompt-params.js';
+export * from './base-agent.js';
+export * from './agent-types/index.js';
+export * from './AgentRunner.js';
+export * from './PayloadManager.js';
+export * from './PayloadChangeAnalyzer.js';
+export * from './PayloadFeedbackManager.js';
+export * from './types/payload-operations.js';
+export * from './AgentDataPreloader.js';
+export * from './agent-context-injector.js';
+export * from './memory-manager-agent.js';
+// Re-export from ai-reranker for backward compatibility
+export { RerankerService, parseRerankerConfiguration, LLMReranker } from '@memberjunction/ai-reranker';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAWA,gEAA8C;AAC9C,yEAAuD;AACvD,yEAAuD;AACvD,+CAA6B;AAC7B,gDAA8B;AAC9B,gDAA8B;AAC9B,mDAAiC;AACjC,0DAAwC;AACxC,2DAAyC;AACzC,6DAA2C;AAC3C,uDAAqC;AACrC,2DAAyC;AACzC,yDAAuC;AAGvC,2DAQqC;AAPjC,8GAAA,eAAe,OAAA;AAEf,yHAAA,0BAA0B,OAAA;AAG1B,0GAAA,WAAW,OAAA;AACX,8GAAA,eAAe,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AAEvC,wDAAwD;AACxD,OAAO,EACH,eAAe,EAEf,0BAA0B,EAG1B,WAAW,EACd,MAAM,6BAA6B,CAAC"}

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

@@ -1,25 +1,77 @@
-import { BaseAgent } from './base-agent';
+import { BaseAgent } from './base-agent.js';
 import { ExecuteAgentParams, AgentConfiguration, BaseAgentNextStep } from '@memberjunction/ai-core-plus';
+/**
+ * Memory Cleanup Agent - archives stale notes and examples based on retention policies.
+ *
+ * This agent runs on a daily schedule and:
+ * 1. Archives notes not accessed within NoteRetentionDays (per agent config, default 90)
+ * 2. Archives examples with SuccessScore < 50 after ExampleRetentionDays (default 180)
+ * 3. Archives any items past their ExpiresAt timestamp
+ *
+ * Only processes auto-generated items (IsAutoGenerated = true) to preserve manual entries.
+ */
 export declare class MemoryCleanupAgent extends BaseAgent {
     private readonly DEFAULT_NOTE_RETENTION_DAYS;
     private readonly DEFAULT_EXAMPLE_RETENTION_DAYS;
     private readonly LOW_SUCCESS_SCORE_THRESHOLD;
+    /**
+     * Main entry point for the cleanup agent
+     */
     protected executeAgentInternal<P = any>(params: ExecuteAgentParams, config: AgentConfiguration): Promise<{
         finalStep: BaseAgentNextStep<P>;
         stepCount: number;
     }>;
+    /**
+     * Archive items that have passed their ExpiresAt timestamp
+     */
     private archiveExpiredItems;
+    /**
+     * Archive items based on per-agent retention policies
+     */
     private archiveStaleItems;
+    /**
+     * Query for notes past their ExpiresAt timestamp
+     */
     private queryExpiredNotes;
+    /**
+     * Query for examples past their ExpiresAt timestamp
+     */
     private queryExpiredExamples;
+    /**
+     * Query for stale auto-generated notes (not accessed within retention period)
+     */
     private queryStaleNotes;
+    /**
+     * Query for stale auto-generated examples with low success scores
+     */
     private queryStaleExamples;
+    /**
+     * Archive a note by setting its status to 'Archived'
+     */
     private archiveNote;
+    /**
+     * Archive an example by setting its status to 'Archived'
+     */
     private archiveExample;
+    /**
+     * Get note retention days for an agent (uses agent config or default)
+     */
     private getNoteRetentionDays;
+    /**
+     * Get example retention days for an agent (uses agent config or default)
+     */
     private getExampleRetentionDays;
+    /**
+     * Check if auto-archive is enabled for an agent
+     */
     private getAutoArchiveEnabled;
+    /**
+     * Calculate cutoff date (now - retentionDays)
+     */
     private getCutoffDate;
+    /**
+     * Build summary message for cleanup results
+     */
     private buildSummary;
 }
 //# sourceMappingURL=memory-cleanup-agent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"memory-cleanup-agent.d.ts","sourceRoot":"","sources":["../src/memory-cleanup-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,kBAAkB,EAAyB,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAwBhI,qBAAa,kBAAmB,SAAQ,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAM;IAClD,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAAO;IACtD,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAM;cAKzB,oBAAoB,CAAC,CAAC,GAAG,GAAG,EACjD,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;YA4ClD,mBAAmB;YA6BnB,iBAAiB;YAsCjB,iBAAiB;YAejB,oBAAoB;YAepB,eAAe;YAkCf,kBAAkB;YAoClB,WAAW;YAuBX,cAAc;IAuB5B,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,YAAY;CA0BvB"}
+{"version":3,"file":"memory-cleanup-agent.d.ts","sourceRoot":"","sources":["../src/memory-cleanup-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,kBAAkB,EAAyB,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAchI;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAM;IAClD,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAAO;IACtD,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAM;IAElD;;OAEG;cACsB,oBAAoB,CAAC,CAAC,GAAG,GAAG,EACjD,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;IAyChE;;OAEG;YACW,mBAAmB;IA0BjC;;OAEG;YACW,iBAAiB;IAmC/B;;OAEG;YACW,iBAAiB;IAY/B;;OAEG;YACW,oBAAoB;IAYlC;;OAEG;YACW,eAAe;IA+B7B;;OAEG;YACW,kBAAkB;IAiChC;;OAEG;YACW,WAAW;IAoBzB;;OAEG;YACW,cAAc;IAoB5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAS/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,YAAY;CA0BvB"}

package/dist/memory-cleanup-agent.js

@@ -1,18 +1,28 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MemoryCleanupAgent = void 0;
-const base_agent_1 = require("./base-agent");
-const core_1 = require("@memberjunction/core");
-const aiengine_1 = require("@memberjunction/aiengine");
-class MemoryCleanupAgent extends base_agent_1.BaseAgent {
+import { BaseAgent } from './base-agent.js';
+import { RunView, LogError, LogStatus } from '@memberjunction/core';
+import { AIEngine } from '@memberjunction/aiengine';
+/**
+ * Memory Cleanup Agent - archives stale notes and examples based on retention policies.
+ *
+ * This agent runs on a daily schedule and:
+ * 1. Archives notes not accessed within NoteRetentionDays (per agent config, default 90)
+ * 2. Archives examples with SuccessScore < 50 after ExampleRetentionDays (default 180)
+ * 3. Archives any items past their ExpiresAt timestamp
+ *
+ * Only processes auto-generated items (IsAutoGenerated = true) to preserve manual entries.
+ */
+export class MemoryCleanupAgent extends BaseAgent {
     constructor() {
         super(...arguments);
         this.DEFAULT_NOTE_RETENTION_DAYS = 90;
         this.DEFAULT_EXAMPLE_RETENTION_DAYS = 180;
         this.LOW_SUCCESS_SCORE_THRESHOLD = 50;
     }
+    /**
+     * Main entry point for the cleanup agent
+     */
     async executeAgentInternal(params, config) {
-        (0, core_1.LogStatus)('MemoryCleanupAgent: Starting cleanup process');
+        LogStatus('MemoryCleanupAgent: Starting cleanup process');
         const contextUser = params.contextUser;
         const result = {
             notesArchived: 0,
@@ -22,10 +32,12 @@ class MemoryCleanupAgent extends base_agent_1.BaseAgent {
             errors: []
         };
         try {
+            // Process expired items first (these have explicit ExpiresAt timestamps)
             await this.archiveExpiredItems(result, contextUser);
+            // Then process stale items based on retention policies
             await this.archiveStaleItems(result, contextUser);
             const summary = this.buildSummary(result);
-            (0, core_1.LogStatus)(`MemoryCleanupAgent: Cleanup completed - ${summary}`);
+            LogStatus(`MemoryCleanupAgent: Cleanup completed - ${summary}`);
             const finalStep = {
                 terminate: true,
                 step: 'Success',
@@ -35,7 +47,7 @@ class MemoryCleanupAgent extends base_agent_1.BaseAgent {
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            (0, core_1.LogError)('MemoryCleanupAgent: Cleanup failed', undefined, error);
+            LogError('MemoryCleanupAgent: Cleanup failed', undefined, error);
             const finalStep = {
                 terminate: true,
                 step: 'Failed',
@@ -44,8 +56,12 @@ class MemoryCleanupAgent extends base_agent_1.BaseAgent {
             return { finalStep, stepCount: 1 };
         }
     }
+    /**
+     * Archive items that have passed their ExpiresAt timestamp
+     */
     async archiveExpiredItems(result, contextUser) {
         const now = new Date().toISOString();
+        // Archive expired notes
         const expiredNotes = await this.queryExpiredNotes(now, contextUser);
         for (const note of expiredNotes) {
             const archived = await this.archiveNote(note, 'Expired', contextUser);
@@ -56,6 +72,7 @@ class MemoryCleanupAgent extends base_agent_1.BaseAgent {
                 result.errors.push(`Failed to archive expired note ${note.ID}`);
             }
         }
+        // Archive expired examples
         const expiredExamples = await this.queryExpiredExamples(now, contextUser);
         for (const example of expiredExamples) {
             const archived = await this.archiveExample(example, 'Expired', contextUser);
@@ -67,12 +84,17 @@ class MemoryCleanupAgent extends base_agent_1.BaseAgent {
             }
         }
     }
+    /**
+     * Archive items based on per-agent retention policies
+     */
     async archiveStaleItems(result, contextUser) {
-        const agents = aiengine_1.AIEngine.Instance.Agents.filter(a => a.Status === 'Active' &&
+        // Get all agents with auto-archive enabled
+        const agents = AIEngine.Instance.Agents.filter(a => a.Status === 'Active' &&
             this.getAutoArchiveEnabled(a));
         for (const agent of agents) {
             const noteRetentionDays = this.getNoteRetentionDays(agent);
             const exampleRetentionDays = this.getExampleRetentionDays(agent);
+            // Archive stale notes for this agent
             const staleNotes = await this.queryStaleNotes(agent.ID, noteRetentionDays, contextUser);
             for (const note of staleNotes) {
                 const archived = await this.archiveNote(note, `Stale (${noteRetentionDays} days)`, contextUser);
@@ -83,6 +105,7 @@ class MemoryCleanupAgent extends base_agent_1.BaseAgent {
                     result.errors.push(`Failed to archive stale note ${note.ID}`);
                 }
             }
+            // Archive stale low-scoring examples for this agent
             const staleExamples = await this.queryStaleExamples(agent.ID, exampleRetentionDays, contextUser);
             for (const example of staleExamples) {
                 const archived = await this.archiveExample(example, `Stale low-score (${exampleRetentionDays} days)`, contextUser);
@@ -95,8 +118,11 @@ class MemoryCleanupAgent extends base_agent_1.BaseAgent {
             }
         }
     }
+    /**
+     * Query for notes past their ExpiresAt timestamp
+     */
     async queryExpiredNotes(now, contextUser) {
-        const rv = new core_1.RunView();
+        const rv = new RunView();
         const result = await rv.RunView({
             EntityName: 'AI Agent Notes',
             ExtraFilter: `Status = 'Active' AND ExpiresAt IS NOT NULL AND ExpiresAt < '${now}'`,
@@ -105,8 +131,11 @@ class MemoryCleanupAgent extends base_agent_1.BaseAgent {
         }, contextUser);
         return result.Success ? result.Results : [];
     }
+    /**
+     * Query for examples past their ExpiresAt timestamp
+     */
     async queryExpiredExamples(now, contextUser) {
-        const rv = new core_1.RunView();
+        const rv = new RunView();
         const result = await rv.RunView({
             EntityName: 'AI Agent Examples',
             ExtraFilter: `Status = 'Active' AND ExpiresAt IS NOT NULL AND ExpiresAt < '${now}'`,
@@ -115,9 +144,17 @@ class MemoryCleanupAgent extends base_agent_1.BaseAgent {
         }, contextUser);
         return result.Success ? result.Results : [];
     }
+    /**
+     * Query for stale auto-generated notes (not accessed within retention period)
+     */
     async queryStaleNotes(agentId, retentionDays, contextUser) {
         const cutoffDate = this.getCutoffDate(retentionDays);
-        const rv = new core_1.RunView();
+        const rv = new RunView();
+        // Query notes that are:
+        // - For this agent
+        // - Auto-generated (don't archive manual notes)
+        // - Active status
+        // - Last accessed before cutoff (or never accessed and created before cutoff)
         const result = await rv.RunView({
             EntityName: 'AI Agent Notes',
             ExtraFilter: `
@@ -134,9 +171,18 @@ class MemoryCleanupAgent extends base_agent_1.BaseAgent {
         }, contextUser);
         return result.Success ? result.Results : [];
     }
+    /**
+     * Query for stale auto-generated examples with low success scores
+     */
     async queryStaleExamples(agentId, retentionDays, contextUser) {
         const cutoffDate = this.getCutoffDate(retentionDays);
-        const rv = new core_1.RunView();
+        const rv = new RunView();
+        // Query examples that are:
+        // - For this agent
+        // - Auto-generated
+        // - Active status
+        // - Low success score (< 50)
+        // - Last accessed before cutoff (or never accessed and created before cutoff)
         const result = await rv.RunView({
             EntityName: 'AI Agent Examples',
             ExtraFilter: `
@@ -154,37 +200,47 @@ class MemoryCleanupAgent extends base_agent_1.BaseAgent {
         }, contextUser);
         return result.Success ? result.Results : [];
     }
+    /**
+     * Archive a note by setting its status to 'Archived'
+     */
     async archiveNote(note, reason, contextUser) {
         try {
-            note.Status = 'Archived';
+            note.Status = 'Archived'; // TypeScript doesn't know about new status yet
             note.Comments = `${note.Comments ? note.Comments + '\n' : ''}[Archived by Memory Cleanup Agent: ${reason} on ${new Date().toISOString()}]`;
             const saved = await note.Save();
             if (saved) {
-                (0, core_1.LogStatus)(`MemoryCleanupAgent: Archived note ${note.ID} - ${reason}`);
+                LogStatus(`MemoryCleanupAgent: Archived note ${note.ID} - ${reason}`);
             }
             return saved;
         }
         catch (error) {
-            (0, core_1.LogError)(`MemoryCleanupAgent: Failed to archive note ${note.ID}`, undefined, error);
+            LogError(`MemoryCleanupAgent: Failed to archive note ${note.ID}`, undefined, error);
             return false;
         }
     }
+    /**
+     * Archive an example by setting its status to 'Archived'
+     */
     async archiveExample(example, reason, contextUser) {
         try {
             example.Status = 'Archived';
             example.Comments = `${example.Comments ? example.Comments + '\n' : ''}[Archived by Memory Cleanup Agent: ${reason} on ${new Date().toISOString()}]`;
             const saved = await example.Save();
             if (saved) {
-                (0, core_1.LogStatus)(`MemoryCleanupAgent: Archived example ${example.ID} - ${reason}`);
+                LogStatus(`MemoryCleanupAgent: Archived example ${example.ID} - ${reason}`);
             }
             return saved;
         }
         catch (error) {
-            (0, core_1.LogError)(`MemoryCleanupAgent: Failed to archive example ${example.ID}`, undefined, error);
+            LogError(`MemoryCleanupAgent: Failed to archive example ${example.ID}`, undefined, error);
             return false;
         }
     }
+    /**
+     * Get note retention days for an agent (uses agent config or default)
+     */
     getNoteRetentionDays(agent) {
+        // Check if agent has NoteRetentionDays property using GetAll() for plain object access
         const agentData = agent.GetAll();
         const retention = agentData['NoteRetentionDays'];
         if (typeof retention === 'number' && retention > 0) {
@@ -192,6 +248,9 @@ class MemoryCleanupAgent extends base_agent_1.BaseAgent {
         }
         return this.DEFAULT_NOTE_RETENTION_DAYS;
     }
+    /**
+     * Get example retention days for an agent (uses agent config or default)
+     */
     getExampleRetentionDays(agent) {
         const agentData = agent.GetAll();
         const retention = agentData['ExampleRetentionDays'];
@@ -200,16 +259,26 @@ class MemoryCleanupAgent extends base_agent_1.BaseAgent {
         }
         return this.DEFAULT_EXAMPLE_RETENTION_DAYS;
     }
+    /**
+     * Check if auto-archive is enabled for an agent
+     */
     getAutoArchiveEnabled(agent) {
         const agentData = agent.GetAll();
         const enabled = agentData['AutoArchiveEnabled'];
+        // Default to true if not explicitly set to false
         return enabled !== false;
     }
+    /**
+     * Calculate cutoff date (now - retentionDays)
+     */
     getCutoffDate(retentionDays) {
         const cutoff = new Date();
         cutoff.setDate(cutoff.getDate() - retentionDays);
         return cutoff.toISOString();
     }
+    /**
+     * Build summary message for cleanup results
+     */
     buildSummary(result) {
         const parts = [];
         if (result.notesArchived > 0) {
@@ -233,5 +302,4 @@ class MemoryCleanupAgent extends base_agent_1.BaseAgent {
         return parts.join(', ');
     }
 }
-exports.MemoryCleanupAgent = MemoryCleanupAgent;
 //# sourceMappingURL=memory-cleanup-agent.js.map

package/dist/memory-cleanup-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-cleanup-agent.js","sourceRoot":"","sources":["../src/memory-cleanup-agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-cleanup-agent.js","sourceRoot":"","sources":["../src/memory-cleanup-agent.ts"],"names":[],"mappings":"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"}

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

@@ -1,22 +1,82 @@
-import { BaseAgent } from './base-agent';
+import { BaseAgent } from './base-agent.js';
 import { ExecuteAgentParams, AgentConfiguration, BaseAgentNextStep } from '@memberjunction/ai-core-plus';
+/**
+ * Memory Manager Agent - automatically extracts notes and examples from conversations.
+ * This agent runs on a schedule (every 15 minutes) and analyzes high-quality conversations
+ * and agent runs to extract learnings and example interactions.
+ */
 export declare class MemoryManagerAgent extends BaseAgent {
+    /** Verbose logging flag from params.verbose */
     private _verbose;
+    /** Agent run ID for creating run steps */
     private _agentRunID;
+    /** Step counter for sequential step numbering */
     private _stepCounter;
+    /** Context user for step operations */
     private _contextUser;
+    /**
+     * Create an agent run step record for observability.
+     * Returns null if agentRunID is not set (defensive check).
+     */
     private CreateRunStep;
+    /**
+     * Finalize an agent run step with success/failure status and output data.
+     */
     private FinalizeRunStep;
+    /**
+     * Get the last run timestamp for this agent to determine what to process.
+     * For first run, returns null to process all history (limited by MaxRows).
+     */
     private GetLastRunTime;
+    /**
+     * Load agents that have note or example injection enabled.
+     * Only extract notes/examples for agents that actually use these features.
+     */
     private LoadAgentsUsingMemory;
+    /**
+     * Load conversations with new activity since last run, including rating data.
+     * Uses a single optimized RunQuery that replaces 4 separate database queries.
+     * Returns conversations with their details, ratings, and agent run IDs for scope inheritance.
+     */
     private LoadConversationsWithNewActivity;
+    /**
+     * Load agent runs with high-usage artifacts since last run.
+     * Links through: ArtifactUse -> ArtifactVersion -> ConversationDetailArtifact -> ConversationDetail -> Conversation -> AIAgentRun
+     */
     private LoadHighValueAgentRuns;
+    /**
+     * Extract notes from conversations with rating data using AI analysis.
+     * This is the primary method that handles rated, unrated, positive, and negative feedback.
+     * Uses LLM-based deduplication and applies sparsity controls.
+     */
     private ExtractNotesFromConversations;
+    /**
+     * Common extraction logic for note extraction.
+     * Applies sparsity controls and deduplication.
+     */
     private executeNoteExtraction;
+    /**
+     * Extract examples from conversation details with high ratings.
+     * Uses LLM-based deduplication to avoid adding redundant examples.
+     */
     private ExtractExamples;
+    /**
+     * Check if a string is a valid UUID format.
+     */
     private isValidUUID;
+    /**
+     * Create note records from extracted data.
+     * Inherits scope from source agent run and applies scopeLevel to determine scope specificity.
+     */
     private CreateNoteRecords;
+    /**
+     * Create example records from extracted data.
+     * Inherits scope from source agent run and applies scopeLevel to determine scope specificity.
+     */
     private CreateExampleRecords;
+    /**
+     * Main execution method called by scheduler
+     */
     protected executeAgentInternal<P = any>(params: ExecuteAgentParams, config: AgentConfiguration): Promise<{
         finalStep: BaseAgentNextStep<P>;
         stepCount: number;

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;AAwHhJ,qBACa,kBAAmB,SAAQ,SAAS;IAE7C,OAAO,CAAC,QAAQ,CAAkB;IAElC,OAAO,CAAC,WAAW,CAAuB;IAE1C,OAAO,CAAC,YAAY,CAAa;IAEjC,OAAO,CAAC,YAAY,CAAyB;YAM/B,aAAa;YA4Cb,eAAe;YAwCf,cAAc;YAwBd,qBAAqB;YA+BrB,gCAAgC;YAkFhC,sBAAsB;YA4CtB,6BAA6B;YAgD7B,qBAAqB;YAiRrB,eAAe;IAmJ7B,OAAO,CAAC,WAAW;YASL,iBAAiB;YAsIjB,oBAAoB;cAuGlB,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;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"}