@memberjunction/ai-agents 5.41.0 → 5.43.0

package/dist/index.d.ts

@@ -43,6 +43,9 @@ export * from './MJAIAgentRequestEntityServer.js';
 export * from './KnowledgeAgent.js';
 export * from './ClientToolRequestManager.js';
 export * from './realtime/realtime-session-runner.js';
+export * from './realtime/bridge-realtime-session-factory.js';
+export * from './realtime/bridge-room-transcript-sink.js';
+export * from './realtime/realtime-turn-moderator.js';
 export { RealtimeToolBroker, RealtimeToolBrokerDeps, ExecutedToolCall, DelegatedRunArtifact } from './realtime/realtime-tool-broker.js';
 export * from './realtime/realtime-client-session-service.js';
 export * from './realtime/realtime-coagent-config.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"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,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AAKnD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACrI,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAG3D,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,WAAW,GACZ,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,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,oCAAoC,CAAC;AAKnD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACrI,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAG3D,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,WAAW,GACZ,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -43,6 +43,9 @@ export * from './MJAIAgentRequestEntityServer.js';
 export * from './KnowledgeAgent.js';
 export * from './ClientToolRequestManager.js';
 export * from './realtime/realtime-session-runner.js';
+export * from './realtime/bridge-realtime-session-factory.js';
+export * from './realtime/bridge-room-transcript-sink.js';
+export * from './realtime/realtime-turn-moderator.js';
 // Broker-unique exports. The shared tool-execution contract (INVOKE_TARGET_AGENT_TOOL_NAME,
 // DelegateToTargetRequest, DelegatedResult, ToolExecutionResult, loggers) is surfaced via the
 // runner's `export *` above, so only the broker-specific symbols are named here to avoid a

package/dist/index.js.map

@@ -1 +1 @@
-{"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,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,4FAA4F;AAC5F,8FAA8F;AAC9F,2FAA2F;AAC3F,8BAA8B;AAC9B,OAAO,EAAE,kBAAkB,EAAkE,MAAM,iCAAiC,CAAC;AACrI,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAE3D,wDAAwD;AACxD,OAAO,EACL,eAAe,EAEf,0BAA0B,EAG1B,WAAW,GACZ,MAAM,6BAA6B,CAAC"}
+{"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,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,oCAAoC,CAAC;AACnD,4FAA4F;AAC5F,8FAA8F;AAC9F,2FAA2F;AAC3F,8BAA8B;AAC9B,OAAO,EAAE,kBAAkB,EAAkE,MAAM,iCAAiC,CAAC;AACrI,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAE3D,wDAAwD;AACxD,OAAO,EACL,eAAe,EAEf,0BAA0B,EAG1B,WAAW,GACZ,MAAM,6BAA6B,CAAC"}

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

@@ -379,7 +379,20 @@ export declare class MemoryManagerAgent extends BaseAgent {
      */
     private pruneStaleReferences;
     /**
-     * Load auto-generated, non-immutable Active notes that are candidates for orphan pruning.
+     * Collect auto-generated, non-immutable `Active` notes that are candidates for orphan
+     * pruning, oldest first.
+     *
+     * Served from the `AIEngine` cache rather than a `RunView`: `AIEngine.Instance.AgentNotes`
+     * holds the full note pool, loaded unfiltered as entity objects and kept current via
+     * `BaseEntity` save/delete events, so an equivalent in-memory filter/sort/cap avoids both a
+     * DB round-trip and the "Entity Already in Engine" redundancy-telemetry warning each cycle.
+     * Note `.filter()` returns a fresh array, so the subsequent `.sort()` never reorders the
+     * engine's cached array. The result is projected to plain {@link PruneCandidateNote} rows —
+     * we never hand a cached `BaseEntity` instance to a mutating caller; `pruneStaleReferences`
+     * re-`Load()`s a fresh, owned entity before archiving.
+     *
+     * @param maxRows Hard cap on candidates returned this cycle (oldest-`__mj_CreatedAt` first).
+     * @returns Lightweight projection rows for orphan-reference evaluation.
      */
     private loadPruneCandidateNotes;
     /**
@@ -426,6 +439,25 @@ export declare class MemoryManagerAgent extends BaseAgent {
     private summarizeDecayFactors;
     /** Archive notes and examples past their explicit ExpiresAt timestamp, regardless of decay score. */
     private archiveExpiredItems;
+    /**
+     * Find notes and examples whose explicit `ExpiresAt` timestamp has passed, so the
+     * archival pass can expire them regardless of decay score.
+     *
+     * Served from the `AIEngine` caches (`AgentNotes` / `AgentExamples`) instead of a batched
+     * `RunViews`: both pools are loaded unfiltered as entity objects and kept current via
+     * `BaseEntity` events, so an in-memory filter/cap reproduces the former queries while
+     * removing two DB round-trips and the pair of "Entity Already in Engine" redundancy
+     * warnings they emitted. Rows are projected to plain shapes; `archiveExpiredNote` /
+     * `archiveExpiredExample` re-`Load()` a fresh, owned entity before mutating.
+     *
+     * Notes include `Provisional` (via {@link IsInjectableNoteStatus} — the same Active+Provisional
+     * predicate used by the read-path injection queries) so the TTL safety net on in-flight
+     * agent writes is enforced: a provisional note the hardening pass never reaches must still
+     * expire.
+     *
+     * @param nowISO Current time as an ISO string; items with `ExpiresAt` strictly before this are expired.
+     * @returns A `[expiredNotes, expiredExamples]` tuple of projection rows (each capped at 200).
+     */
     private loadExpiredItems;
     private archiveExpiredNote;
     private archiveExpiredExample;
@@ -440,7 +472,17 @@ export declare class MemoryManagerAgent extends BaseAgent {
      */
     private applyProportionalDecay;
     /**
-     * Fetch notes and examples in parallel — they're independent.
+     * Fetch decay-candidate notes and examples from the AIEngine caches.
+     *
+     * Served from `AIEngine.Instance.AgentNotes` / `AgentExamples` (loaded unfiltered as
+     * entity objects and kept current via BaseEntity events), filtered/capped in-memory to
+     * mirror the former RunViews — avoids two "Entity Already in Engine" redundancy warnings
+     * and a DB round-trip per maintenance cycle. We project to plain candidate rows; the
+     * actual decay/archival re-Loads fresh entities.
+     *
+     * @returns A `[activeNotes, activeExamples]` tuple of decay-candidate projection rows
+     *          (auto-generated `Active` notes capped at 1000; auto-generated `Active` examples
+     *          scoring below 50, capped at 500).
      */
     private loadDecayCandidates;
     /**

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

package/dist/memory-manager-agent.js

@@ -7,8 +7,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var MemoryManagerAgent_1;
 import { BaseAgent } from './base-agent.js';
 import { RegisterClass, CleanAndParseJSON } from '@memberjunction/global';
-import { RunView, RunQuery, LogError, LogStatus } from '@memberjunction/core';
-import { InjectableNoteStatusSQLList } from '@memberjunction/core-entities';
+import { RunView, RunQuery, LogError, LogStatus, LogStatusEx } from '@memberjunction/core';
+import { IsInjectableNoteStatus } from '@memberjunction/core-entities';
 import { AIPromptRunner } from '@memberjunction/ai-prompts';
 import { AIPromptParams } from '@memberjunction/ai-core-plus';
 import { AIEngine } from '@memberjunction/aiengine';
@@ -307,7 +307,9 @@ let MemoryManagerAgent = MemoryManagerAgent_1 = class MemoryManagerAgent extends
             MaxRows: 1000 // Limit to 1000 conversations per run
         }, contextUser);
         if (!result.Success || !result.Results || result.Results.length === 0) {
-            LogStatus('Memory Manager: No conversations with new activity found');
+            // Verbose-only: the common no-op outcome. The engine's "✅ Completed (Nms)" line already
+            // signals the run finished with no work; surfacing "why" is a verbose diagnostic detail.
+            LogStatusEx({ message: 'Memory Manager: No conversations with new activity found', verboseOnly: true });
             return [];
         }
         // Parse the query results into ConversationWithRatings objects
@@ -1266,20 +1268,26 @@ let MemoryManagerAgent = MemoryManagerAgent_1 = class MemoryManagerAgent extends
         // Event-driven trigger: consolidate when at least `noteCountTrigger` new notes
         // have been added system-wide since the last Memory Manager run.
         //
-        // NOTE: this query intentionally does NOT filter by AgentID. The `agentId` parameter
+        // NOTE: this count intentionally does NOT filter by AgentID. The `agentId` parameter
         // here is the Memory Manager's own ID (passed from `params.agent.ID` at the call
         // site), not the agent that owns the notes. Filtering the count by MM's own agent
         // ID would never match anything because MM doesn't own notes — it processes notes
         // belonging to other (memory-enabled) agents.
-        const rv = new RunView();
-        const newNoteResult = await rv.RunView({
-            EntityName: 'MJ: AI Agent Notes',
-            ExtraFilter: `IsAutoGenerated=1 AND Status='Active' AND __mj_CreatedAt > '${lastRun.toISOString()}'`,
-            ResultType: 'count_only'
-        }, contextUser);
-        if (newNoteResult.Success && (newNoteResult.TotalRowCount || 0) >= CONSOLIDATION_CONFIG.noteCountTrigger) {
+        //
+        // AIEngineBase caches `MJ: AI Agent Notes` unfiltered as full entity objects
+        // (`AIEngine.Instance.AgentNotes`) and keeps that cache current via BaseEntity
+        // save/delete events, so we count in-memory instead of a `count_only` RunView. This
+        // avoids the "Entity Already in Engine" redundancy telemetry warning and a DB
+        // round-trip on every maintenance cycle. Mirrors the cached-note filtering used
+        // elsewhere in this class (e.g. buildMaintenanceSummary).
+        const lastRunMs = lastRun.getTime();
+        const newNoteCount = AIEngine.Instance.AgentNotes.filter(n => n.IsAutoGenerated &&
+            n.Status === 'Active' &&
+            n.__mj_CreatedAt != null &&
+            new Date(n.__mj_CreatedAt).getTime() > lastRunMs).length;
+        if (newNoteCount >= CONSOLIDATION_CONFIG.noteCountTrigger) {
             if (this._verbose) {
-                LogStatus(`Memory Manager: Event-driven consolidation trigger fired (${newNoteResult.TotalRowCount} new notes >= ${CONSOLIDATION_CONFIG.noteCountTrigger} threshold since last MM run)`);
+                LogStatus(`Memory Manager: Event-driven consolidation trigger fired (${newNoteCount} new notes >= ${CONSOLIDATION_CONFIG.noteCountTrigger} threshold since last MM run)`);
             }
             return { shouldRun: true, triggerType: 'event' };
         }
@@ -1988,7 +1996,7 @@ let MemoryManagerAgent = MemoryManagerAgent_1 = class MemoryManagerAgent extends
     async pruneStaleReferences(contextUser) {
         const maxPerCycle = STALE_PRUNING_CONFIG.maxNotesPerRun;
         const result = { notesArchived: 0, orphanedAgents: 0, orphanedUsers: 0, orphanedCompanies: 0, orphanedConversations: 0 };
-        const notes = await this.loadPruneCandidateNotes(contextUser, maxPerCycle * 2);
+        const notes = this.loadPruneCandidateNotes(maxPerCycle * 2);
         if (notes.length === 0) {
             return result;
         }
@@ -2005,22 +2013,33 @@ let MemoryManagerAgent = MemoryManagerAgent_1 = class MemoryManagerAgent extends
         return result;
     }
     /**
-     * Load auto-generated, non-immutable Active notes that are candidates for orphan pruning.
-     */
-    async loadPruneCandidateNotes(contextUser, maxRows) {
-        const rv = new RunView();
-        const notesResult = await rv.RunView({
-            EntityName: 'MJ: AI Agent Notes',
-            ExtraFilter: `IsAutoGenerated = 1 AND Status = 'Active' AND ProtectionTier != 'Immutable'`,
-            Fields: ['ID', 'AgentID', 'UserID', 'CompanyID', 'SourceConversationID'],
-            OrderBy: '__mj_CreatedAt ASC',
-            MaxRows: maxRows,
-            ResultType: 'simple'
-        }, contextUser);
-        if (!notesResult.Success || !notesResult.Results?.length) {
-            return [];
-        }
-        return notesResult.Results;
+     * Collect auto-generated, non-immutable `Active` notes that are candidates for orphan
+     * pruning, oldest first.
+     *
+     * Served from the `AIEngine` cache rather than a `RunView`: `AIEngine.Instance.AgentNotes`
+     * holds the full note pool, loaded unfiltered as entity objects and kept current via
+     * `BaseEntity` save/delete events, so an equivalent in-memory filter/sort/cap avoids both a
+     * DB round-trip and the "Entity Already in Engine" redundancy-telemetry warning each cycle.
+     * Note `.filter()` returns a fresh array, so the subsequent `.sort()` never reorders the
+     * engine's cached array. The result is projected to plain {@link PruneCandidateNote} rows —
+     * we never hand a cached `BaseEntity` instance to a mutating caller; `pruneStaleReferences`
+     * re-`Load()`s a fresh, owned entity before archiving.
+     *
+     * @param maxRows Hard cap on candidates returned this cycle (oldest-`__mj_CreatedAt` first).
+     * @returns Lightweight projection rows for orphan-reference evaluation.
+     */
+    loadPruneCandidateNotes(maxRows) {
+        return AIEngine.Instance.AgentNotes
+            .filter(n => n.IsAutoGenerated && n.Status === 'Active' && (n.ProtectionTier || 'Standard') !== 'Immutable')
+            .sort((a, b) => new Date(a.__mj_CreatedAt).getTime() - new Date(b.__mj_CreatedAt).getTime())
+            .slice(0, maxRows)
+            .map(n => ({
+            ID: n.ID,
+            AgentID: n.AgentID,
+            UserID: n.UserID,
+            CompanyID: n.CompanyID,
+            SourceConversationID: n.SourceConversationID
+        }));
     }
     /**
      * Build in-memory lookup caches of which referenced users/companies/conversations still
@@ -2199,7 +2218,7 @@ let MemoryManagerAgent = MemoryManagerAgent_1 = class MemoryManagerAgent extends
         const result = { notesExpired: 0, examplesExpired: 0 };
         const md = this.ProviderToUse;
         const nowISO = new Date().toISOString();
-        const [expiredNotes, expiredExamples] = await this.loadExpiredItems(contextUser, nowISO);
+        const [expiredNotes, expiredExamples] = this.loadExpiredItems(nowISO);
         for (const note of expiredNotes) {
             if ((note.ProtectionTier || 'Standard') === 'Immutable')
                 continue;
@@ -2212,31 +2231,36 @@ let MemoryManagerAgent = MemoryManagerAgent_1 = class MemoryManagerAgent extends
         }
         return result;
     }
-    async loadExpiredItems(contextUser, nowISO) {
-        const rv = new RunView();
-        const [notesResult, examplesResult] = await rv.RunViews([
-            {
-                EntityName: 'MJ: AI Agent Notes',
-                // Includes Provisional so the TTL safety net on in-flight agent writes is
-                // actually enforced — a provisional note the hardening pass never reaches
-                // must still expire.
-                ExtraFilter: `Status IN (${InjectableNoteStatusSQLList()}) AND ExpiresAt IS NOT NULL AND ExpiresAt < '${nowISO}'`,
-                Fields: ['ID', 'ExpiresAt', 'ProtectionTier'],
-                MaxRows: 200,
-            },
-            {
-                EntityName: 'MJ: AI Agent Examples',
-                ExtraFilter: `Status = 'Active' AND ExpiresAt IS NOT NULL AND ExpiresAt < '${nowISO}'`,
-                Fields: ['ID', 'ExpiresAt'],
-                MaxRows: 200,
-            }
-        ], contextUser);
-        return [
-            notesResult.Success && notesResult.Results
-                ? notesResult.Results.filter((r) => 'ProtectionTier' in r)
-                : [],
-            examplesResult.Success && examplesResult.Results ? examplesResult.Results : []
-        ];
+    /**
+     * Find notes and examples whose explicit `ExpiresAt` timestamp has passed, so the
+     * archival pass can expire them regardless of decay score.
+     *
+     * Served from the `AIEngine` caches (`AgentNotes` / `AgentExamples`) instead of a batched
+     * `RunViews`: both pools are loaded unfiltered as entity objects and kept current via
+     * `BaseEntity` events, so an in-memory filter/cap reproduces the former queries while
+     * removing two DB round-trips and the pair of "Entity Already in Engine" redundancy
+     * warnings they emitted. Rows are projected to plain shapes; `archiveExpiredNote` /
+     * `archiveExpiredExample` re-`Load()` a fresh, owned entity before mutating.
+     *
+     * Notes include `Provisional` (via {@link IsInjectableNoteStatus} — the same Active+Provisional
+     * predicate used by the read-path injection queries) so the TTL safety net on in-flight
+     * agent writes is enforced: a provisional note the hardening pass never reaches must still
+     * expire.
+     *
+     * @param nowISO Current time as an ISO string; items with `ExpiresAt` strictly before this are expired.
+     * @returns A `[expiredNotes, expiredExamples]` tuple of projection rows (each capped at 200).
+     */
+    loadExpiredItems(nowISO) {
+        const nowMs = new Date(nowISO).getTime();
+        const expiredNotes = AIEngine.Instance.AgentNotes
+            .filter(n => IsInjectableNoteStatus(n.Status) && n.ExpiresAt != null && new Date(n.ExpiresAt).getTime() < nowMs)
+            .slice(0, 200)
+            .map(n => ({ ID: n.ID, ExpiresAt: n.ExpiresAt, ProtectionTier: n.ProtectionTier || 'Standard' }));
+        const expiredExamples = AIEngine.Instance.AgentExamples
+            .filter(e => e.Status === 'Active' && e.ExpiresAt != null && new Date(e.ExpiresAt).getTime() < nowMs)
+            .slice(0, 200)
+            .map(e => ({ ID: e.ID, ExpiresAt: e.ExpiresAt }));
+        return [expiredNotes, expiredExamples];
     }
     async archiveExpiredNote(note, md, contextUser) {
         const noteToArchive = await md.GetEntityObject('MJ: AI Agent Notes', contextUser);
@@ -2267,7 +2291,7 @@ let MemoryManagerAgent = MemoryManagerAgent_1 = class MemoryManagerAgent extends
         const result = { notesDecayed: 0, notesArchived: 0, examplesDecayed: 0, examplesArchived: 0 };
         const stats = { decayFactors: [], protectedPreserved: 0, ephemeralAccelerated: 0 };
         const md = this.ProviderToUse;
-        const [activeNotes, activeExamples] = await this.loadDecayCandidates(contextUser);
+        const [activeNotes, activeExamples] = this.loadDecayCandidates();
         for (const note of activeNotes) {
             await this.decayOneNote(note, archiveEnabledAgentIds, md, contextUser, result, stats);
         }
@@ -2277,36 +2301,43 @@ let MemoryManagerAgent = MemoryManagerAgent_1 = class MemoryManagerAgent extends
         return { ...result, stats };
     }
     /**
-     * Fetch notes and examples in parallel — they're independent.
-     */
-    async loadDecayCandidates(contextUser) {
-        // Batch into one RunViews round-trip — see loadExpiredItems for the rationale on why
-        // two parallel RunView calls are flagged sequential by the redundancy telemetry. The
-        // two projections differ, so the batch is typed with their union and narrowed by
-        // position (notes carry ProtectionTier, examples carry SuccessScore).
-        const rv = new RunView();
-        const [activeNotesResult, activeExamplesResult] = await rv.RunViews([
-            {
-                EntityName: 'MJ: AI Agent Notes',
-                ExtraFilter: `IsAutoGenerated = 1 AND Status = 'Active'`,
-                Fields: ['ID', 'ImportanceScore', 'ProtectionTier', 'LastAccessedAt', '__mj_CreatedAt', 'AccessCount', 'AgentID'],
-                MaxRows: 1000,
-            },
-            {
-                EntityName: 'MJ: AI Agent Examples',
-                ExtraFilter: `IsAutoGenerated = 1 AND Status = 'Active' AND SuccessScore < 50`,
-                Fields: ['ID', 'SuccessScore', 'LastAccessedAt', '__mj_CreatedAt', 'AccessCount', 'AgentID'],
-                MaxRows: 500,
-            }
-        ], contextUser);
-        return [
-            activeNotesResult.Success && activeNotesResult.Results
-                ? activeNotesResult.Results.filter((r) => 'ProtectionTier' in r)
-                : [],
-            activeExamplesResult.Success && activeExamplesResult.Results
-                ? activeExamplesResult.Results.filter((r) => 'SuccessScore' in r)
-                : []
-        ];
+     * Fetch decay-candidate notes and examples from the AIEngine caches.
+     *
+     * Served from `AIEngine.Instance.AgentNotes` / `AgentExamples` (loaded unfiltered as
+     * entity objects and kept current via BaseEntity events), filtered/capped in-memory to
+     * mirror the former RunViews — avoids two "Entity Already in Engine" redundancy warnings
+     * and a DB round-trip per maintenance cycle. We project to plain candidate rows; the
+     * actual decay/archival re-Loads fresh entities.
+     *
+     * @returns A `[activeNotes, activeExamples]` tuple of decay-candidate projection rows
+     *          (auto-generated `Active` notes capped at 1000; auto-generated `Active` examples
+     *          scoring below 50, capped at 500).
+     */
+    loadDecayCandidates() {
+        const activeNotes = AIEngine.Instance.AgentNotes
+            .filter(n => n.IsAutoGenerated && n.Status === 'Active')
+            .slice(0, 1000)
+            .map(n => ({
+            ID: n.ID,
+            ImportanceScore: n.ImportanceScore,
+            ProtectionTier: n.ProtectionTier || 'Standard',
+            LastAccessedAt: n.LastAccessedAt,
+            __mj_CreatedAt: n.__mj_CreatedAt,
+            AccessCount: n.AccessCount,
+            AgentID: n.AgentID
+        }));
+        const activeExamples = AIEngine.Instance.AgentExamples
+            .filter(e => e.IsAutoGenerated && e.Status === 'Active' && (e.SuccessScore ?? 0) < 50)
+            .slice(0, 500)
+            .map(e => ({
+            ID: e.ID,
+            SuccessScore: e.SuccessScore,
+            LastAccessedAt: e.LastAccessedAt,
+            __mj_CreatedAt: e.__mj_CreatedAt,
+            AccessCount: e.AccessCount,
+            AgentID: e.AgentID
+        }));
+        return [activeNotes, activeExamples];
     }
     /**
      * Apply proportional decay to a single note. Archives if the decayed score drops below
@@ -2396,19 +2427,19 @@ let MemoryManagerAgent = MemoryManagerAgent_1 = class MemoryManagerAgent extends
             maxNotesPerRun: HARDENING_CONFIG.maxNotesPerRun
         });
         try {
-            const rv = new RunView();
-            const result = await rv.RunView({
-                EntityName: 'MJ: AI Agent Notes',
-                ExtraFilter: `Status = 'Provisional' AND AuthorType = 'Agent'`,
-                OrderBy: '__mj_CreatedAt ASC',
-                MaxRows: HARDENING_CONFIG.maxNotesPerRun,
-                ResultType: 'entity_object'
-            }, contextUser);
-            if (!result.Success) {
-                await this.FinalizeRunStep(step, false, counters, undefined, `Failed to load provisional notes: ${result.ErrorMessage}`);
-                return counters;
-            }
-            const provisionalNotes = result.Results || [];
+            // Served from AIEngine.Instance.AgentNotes (loaded unfiltered as entity
+            // objects and kept current via BaseEntity + remote-invalidate events),
+            // filtered/ordered/capped in-memory to mirror the former RunView. This
+            // avoids the "Entity Already in Engine" redundancy warning and a DB
+            // round-trip every MM cycle, matching loadDecayCandidates/loadExpiredItems.
+            // Provisional agent notes are in-flight writes already reflected in the
+            // cache, and hardenSingleNote mutates+saves these entities directly —
+            // consistent with the dedupe path, which already saves cached note
+            // instances returned by FindSimilarAgentNotes.
+            const provisionalNotes = AIEngine.Instance.AgentNotes
+                .filter(n => n.Status === 'Provisional' && n.AuthorType === 'Agent')
+                .sort((a, b) => new Date(a.__mj_CreatedAt).getTime() - new Date(b.__mj_CreatedAt).getTime())
+                .slice(0, HARDENING_CONFIG.maxNotesPerRun);
             if (provisionalNotes.length === 0) {
                 await this.FinalizeRunStep(step, true, { ...counters, provisionalCount: 0 });
                 return counters;
@@ -2766,7 +2797,9 @@ let MemoryManagerAgent = MemoryManagerAgent_1 = class MemoryManagerAgent extends
             this._agentRunID = this.AgentRun?.ID || null;
             this._stepCounter = 0;
             this._contextUser = params.contextUser || null;
-            LogStatus('Memory Manager: Starting analysis cycle');
+            // Verbose-only: the scheduling engine's always-on "▶️ Starting / ✅ Completed" lines already
+            // mark that this run began/ended. On routine no-op runs this internal trace is just noise.
+            LogStatusEx({ message: 'Memory Manager: Starting analysis cycle', verboseOnly: true });
             // Phase 1: the last-run-time and the memory-enabled agent set are independent — load in
             // parallel (avoids two back-to-back sequential RunViews flagged by the parallelization telemetry).
             const [lastRunTime, agentsUsingMemory] = await Promise.all([