Class AgentMemoryContextBuilder

Shared helper that orchestrates context-memory and pre-execution RAG injection for an agent.

Stateless: every method receives all required inputs as parameters and returns the data the caller needs to persist (matching the original return shapes of the BaseAgent methods). The system-message side effects are applied to the supplied conversationMessages array, exactly as before.

Index

Constructors

constructor

Methods

InjectContextMemory InjectPreExecutionRAG

Constructors

constructor

new AgentMemoryContextBuilder(): AgentMemoryContextBuilder
Returns AgentMemoryContextBuilder

Methods

InjectContextMemory

InjectContextMemory(
    input: string,
    agent: MJAIAgentEntityExtended,
    userId?: string,
    companyId?: string,
    contextUser?: UserInfo,
    conversationMessages?: ChatMessage[],
    primaryScopeEntityId?: string,
    primaryScopeRecordId?: string,
    secondaryScopes?: Record<string, SecondaryScopeValue>,
    secondaryScopeConfig?: SecondaryScopeConfig,
    observability?: AgentMemoryObservability,
    logStatus?: AgentMemoryStatusLogger,
): Promise<
    { examples: MJAIAgentExampleEntity[]; notes: MJAIAgentNoteEntity[] },
>
Inject notes and examples into agent context memory. Injects memory context directly into the supplied conversation messages array.
Parameters
- input: string
  The user input text for semantic search
- agent: MJAIAgentEntityExtended
  The agent configuration entity
- OptionaluserId: string
  Optional user ID for scoping
- OptionalcompanyId: string
  Optional company ID for scoping
- OptionalcontextUser: UserInfo
  User context
- OptionalconversationMessages: ChatMessage[]
  The conversation messages array to inject into
- OptionalprimaryScopeEntityId: string
  Optional primary scope entity ID for multi-tenant filtering
- OptionalprimaryScopeRecordId: string
  Optional primary scope record ID for multi-tenant filtering
- OptionalsecondaryScopes: Record<string, SecondaryScopeValue>
  Optional secondary scope dimensions for multi-tenant filtering
- OptionalsecondaryScopeConfig: SecondaryScopeConfig
  Optional agent-level scope config for per-dimension inheritance
- Optionalobservability: AgentMemoryObservability
  Optional observability context for run-step tracking
- OptionallogStatus: AgentMemoryStatusLogger
  Optional verbose-aware status logger
Returns Promise<{ examples: MJAIAgentExampleEntity[]; notes: MJAIAgentNoteEntity[] }>
Object containing injected notes and examples
- Defined in AI/Agents/src/agent-memory-context-builder.ts:76

InjectPreExecutionRAG

InjectPreExecutionRAG(
    lastUserMessage: string,
    agent: MJAIAgentEntityExtended,
    contextUser: UserInfo,
    conversationMessages: ChatMessage[],
    originalMessages: ChatMessage[],
    primaryScopeEntityId?: string,
    primaryScopeRecordId?: string,
    secondaryScopes?: Record<string, SecondaryScopeValue>,
    payload?: unknown,
    logStatus?: AgentMemoryStatusLogger,
    logError?: AgentMemoryErrorLogger,
): Promise<AgentPreExecutionRAGResult>
Inject pre-execution RAG context for this agent using scoped search.

Loads the agent's AIAgentSearchScope rows (Phase IN 'PreExecution'|'Both'), renders any per-scope query templates, calls SearchEngine.Search() per scope, cross-scope RRF fuses the results when multiple scopes contributed, and unshifts a <retrieved_context> system message onto conversationMessages.

When the agent has no active pre-execution scopes (or all scopes returned zero results), this method is a no-op — no system message is injected and null is returned.

See plans/search-scopes-rag-plus.md §4 (Agent Integration — Pre-Execution RAG).
Parameters
- lastUserMessage: string
  The most recent user message text.
- agent: MJAIAgentEntityExtended
  The agent being executed.
- contextUser: UserInfo
  Calling user (threaded to SearchEngine + Metadata).
- conversationMessages: ChatMessage[]
  The mutated message array that flows to the LLM (system msg is unshifted here).
- originalMessages: ChatMessage[]
  The unmodified messages array (for template recentMessages).
- OptionalprimaryScopeEntityId: string
  Multi-tenant primary scope entity ID.
- OptionalprimaryScopeRecordId: string
  Multi-tenant primary scope record ID.
- OptionalsecondaryScopes: Record<string, SecondaryScopeValue>
  Multi-tenant secondary scope dimensions.
- Optionalpayload: unknown
  The agent's current payload (for template rendering).
- OptionallogStatus: AgentMemoryStatusLogger
  Optional verbose-aware status logger.
- OptionallogError: AgentMemoryErrorLogger
  Optional error logger (used when RAG injection fails non-fatally).
Returns Promise<AgentPreExecutionRAGResult>
The structured RAG result, or null if no scopes produced results.
- Defined in AI/Agents/src/agent-memory-context-builder.ts:192

Class AgentMemoryContextBuilder

Index

Constructors

Methods

Constructors

constructor

Returns AgentMemoryContextBuilder

Methods

InjectContextMemory

Parameters

Returns Promise<{ examples: MJAIAgentExampleEntity[]; notes: MJAIAgentNoteEntity[] }>

InjectPreExecutionRAG

Parameters

Returns Promise<AgentPreExecutionRAGResult>

Settings

On This Page