@memberjunction/ai-agents 5.33.0 → 5.34.0

package/dist/agent-pre-execution-rag.d.ts

@@ -0,0 +1,149 @@
+/**
+ * @fileoverview Agent pre-execution RAG — Phase 1C of plans/search-scopes-rag-plus.md.
+ *
+ * Runs in parallel with the rest of `BaseAgent.Execute()` Phase 2 to retrieve and inject
+ * scoped search context before the agent's first LLM call. Follows the same pattern as
+ * `AgentContextInjector` (notes/examples) so the two subsystems coexist cleanly:
+ *
+ *   1. Load the agent's active `AIAgentSearchScope` rows where Phase IN ('PreExecution','Both')
+ *      and the row is within its Status + StartAt/EndAt window.
+ *   2. For each active scope, render the `QueryTemplateID` via MJ TemplateEngineServer
+ *      (or fall back to `lastUserMessage`).
+ *   3. Call `SearchEngine.Search()` with `ScopeIDs: [scopeId]`, honoring per-agent overrides
+ *      (MaxResults, MinScore, FusionWeightsOverride) and the agent's multi-tenant context
+ *      (PrimaryScopeRecordID, SecondaryScopes).
+ *   4. Cross-scope RRF when multiple scopes produced results.
+ *   5. Format results as a `<retrieved_context>` system message and return.
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { UserInfo } from '@memberjunction/core';
+import { MJAIAgentEntity, MJAIAgentSearchScopeEntity } from '@memberjunction/core-entities';
+import { SearchResultItem, SearchContext } from '@memberjunction/search-engine';
+import { ChatMessage } from '@memberjunction/ai';
+import { SecondaryScopeValue } from '@memberjunction/ai-core-plus';
+/**
+ * Parameters for executing pre-execution RAG for an agent.
+ */
+export interface AgentPreExecutionRAGParams {
+    /** The agent currently being executed. */
+    agent: MJAIAgentEntity;
+    /** The most recent user message — used as the default query when no template is configured. */
+    lastUserMessage: string;
+    /** Optional recent messages (role + content) for template rendering. */
+    recentMessages?: ChatMessage[];
+    /** Optional conversation summary. */
+    conversationSummary?: string;
+    /** Agent's current payload state. Available to templates under `payload`. */
+    payload?: unknown;
+    /** Multi-tenant primary scope record ID (flows into `SearchContext.PrimaryScopeRecordID`). */
+    primaryScopeRecordId?: string;
+    /** Multi-tenant primary scope entity ID. */
+    primaryScopeEntityId?: string;
+    /** Multi-tenant secondary scope dimensions. */
+    secondaryScopes?: Record<string, SecondaryScopeValue>;
+    /** Calling user — threaded through to SearchEngine + Metadata. */
+    contextUser: UserInfo;
+    /**
+     * Phase 2C: when true, consume SearchEngine.streamSearch() instead of
+     * the synchronous Search() per scope. The final aggregate is identical
+     * — what changes is that intermediate provider traces are written to
+     * `streamingTrace` (when supplied) so the agent's pre-execution
+     * scratchpad can show "while you wait" progress. Default false.
+     */
+    streamingEnabled?: boolean;
+    /**
+     * Optional sink for streamingEnabled traces. Caller pushes nothing
+     * itself — the RAG hook appends one markdown line per provider event
+     * per scope. Caller decides what to do with the lines (typically
+     * concat into the agent's pre-prompt scratchpad).
+     */
+    streamingTrace?: string[];
+}
+/** Structured result of a single scope's search, used for formatting + artifact persistence. */
+export interface ScopeSearchResult {
+    scopeID: string;
+    scopeName: string;
+    scopeDescription: string | null;
+    scopeIcon: string | null;
+    query: string;
+    results: SearchResultItem[];
+    minScore: number;
+}
+/** Final aggregate result of `AgentPreExecutionRAG.Execute()`. */
+export interface AgentPreExecutionRAGResult {
+    /** Formatted `<retrieved_context>` system-message content ready for `unshift()`. */
+    formattedSystemMessage: string;
+    /** Per-scope result detail (for observability + artifact persistence). */
+    perScopeResults: ScopeSearchResult[];
+    /** Cross-scope fused result list (deduped, truncated). */
+    combinedResults: SearchResultItem[];
+    /** Combined search context passed into the engine. */
+    searchContext?: SearchContext;
+    /** Scope IDs actually queried (inactive/expired ones dropped). */
+    queriedScopeIDs: string[];
+    /** Raw agent-scope rows used (for debugging). */
+    agentScopeRows: MJAIAgentSearchScopeEntity[];
+}
+/**
+ * Orchestrator for agent pre-execution RAG. Stateless — create a fresh instance per call.
+ */
+export declare class AgentPreExecutionRAG {
+    /**
+     * Main entry point. Returns a filled-in `AgentPreExecutionRAGResult` when the agent
+     * has any active PreExecution/Both scopes; otherwise returns `null` so callers can
+     * skip injection entirely.
+     */
+    Execute(params: AgentPreExecutionRAGParams): Promise<AgentPreExecutionRAGResult | null>;
+    /**
+     * Load active PreExecution/Both AIAgentSearchScope rows for the agent,
+     * sorted by Priority ascending (lower number = higher priority).
+     */
+    private loadActiveAgentScopeRows;
+    /**
+     * Resolve + render the query for one agent-scope row, run the search
+     * (sync or streaming), and shape the per-scope result. Returns null when
+     * the row is unusable (inactive scope, empty query, search failure, or
+     * empty result set) — the caller decides whether to keep iterating.
+     */
+    private searchOneAgentScope;
+    /**
+     * Phase 2C streaming-mode helper — consume `SearchEngine.streamSearch()`
+     * and shape the events back into a `SearchResult` so the rest of the
+     * pipeline doesn't need to know about streaming. Per-provider trace
+     * lines are appended to `params.streamingTrace` (markdown over JSON,
+     * per RAG_plan §2.2) so the agent's pre-prompt scratchpad can show
+     * "while you wait" progress.
+     */
+    private streamSearchOneScope;
+    /**
+     * Cross-scope reciprocal rank fusion — when 2+ scopes contributed, run
+     * RRF + dedup so the merged list reflects each scope's contribution.
+     * Single-scope cases skip fusion and return the only result list directly.
+     */
+    private combineAcrossScopes;
+    /**
+     * Shape the result into a Data-Snapshot-compatible payload so `ProcessAgentArtifacts`
+     * can persist it as a `Search Result Set` artifact. See Section 6.3 of the plan.
+     * Returns `undefined` when there is nothing to persist.
+     */
+    BuildArtifactPayload(result: AgentPreExecutionRAGResult): Record<string, unknown> | undefined;
+    /**
+     * Resolve the search query for one scope. If the agent-scope row has a QueryTemplateID,
+     * render it via `TemplateEngineServer`. Otherwise fall back to `lastUserMessage`.
+     */
+    private resolveQuery;
+    /**
+     * Load a Template entity + its highest-priority content row.
+     * Uses the cached `TemplateEngineServer.FindTemplate` when available; falls back to a
+     * direct RunView when not.
+     */
+    private loadTemplate;
+    private parseFusionWeights;
+    /**
+     * Format the per-scope results into a `<retrieved_context>` system-message block.
+     * Matches the shape documented in Section 4.2 of the plan.
+     */
+    private formatAsSystemMessage;
+}
+//# sourceMappingURL=agent-pre-execution-rag.d.ts.map

package/dist/agent-pre-execution-rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-pre-execution-rag.d.ts","sourceRoot":"","sources":["../src/agent-pre-execution-rag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAgC,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EACH,eAAe,EACf,0BAA0B,EAK7B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEH,gBAAgB,EAChB,aAAa,EAGhB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,0CAA0C;IAC1C,KAAK,EAAE,eAAe,CAAC;IACvB,+FAA+F;IAC/F,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,cAAc,CAAC,EAAE,WAAW,EAAE,CAAC;IAC/B,qCAAqC;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8FAA8F;IAC9F,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4CAA4C;IAC5C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACtD,kEAAkE;IAClE,WAAW,EAAE,QAAQ,CAAC;IACtB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,kEAAkE;AAClE,MAAM,WAAW,0BAA0B;IACvC,oFAAoF;IACpF,sBAAsB,EAAE,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,eAAe,EAAE,iBAAiB,EAAE,CAAC;IACrC,0DAA0D;IAC1D,eAAe,EAAE,gBAAgB,EAAE,CAAC;IACpC,sDAAsD;IACtD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,kEAAkE;IAClE,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iDAAiD;IACjD,cAAc,EAAE,0BAA0B,EAAE,CAAC;CAChD;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC7B;;;;OAIG;IACU,OAAO,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAuCpG;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAKhC;;;;;OAKG;YACW,mBAAmB;IA0DjC;;;;;;;OAOG;YACW,oBAAoB;IA+ClC;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;;OAIG;IACI,oBAAoB,CACvB,MAAM,EAAE,0BAA0B,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAuDtC;;;OAGG;YACW,YAAY;IAsC1B;;;;OAIG;YACW,YAAY;IAoC1B,OAAO,CAAC,kBAAkB;IAe1B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;CA2BhC"}

package/dist/agent-pre-execution-rag.js

@@ -0,0 +1,376 @@
+/**
+ * @fileoverview Agent pre-execution RAG — Phase 1C of plans/search-scopes-rag-plus.md.
+ *
+ * Runs in parallel with the rest of `BaseAgent.Execute()` Phase 2 to retrieve and inject
+ * scoped search context before the agent's first LLM call. Follows the same pattern as
+ * `AgentContextInjector` (notes/examples) so the two subsystems coexist cleanly:
+ *
+ *   1. Load the agent's active `AIAgentSearchScope` rows where Phase IN ('PreExecution','Both')
+ *      and the row is within its Status + StartAt/EndAt window.
+ *   2. For each active scope, render the `QueryTemplateID` via MJ TemplateEngineServer
+ *      (or fall back to `lastUserMessage`).
+ *   3. Call `SearchEngine.Search()` with `ScopeIDs: [scopeId]`, honoring per-agent overrides
+ *      (MaxResults, MinScore, FusionWeightsOverride) and the agent's multi-tenant context
+ *      (PrimaryScopeRecordID, SecondaryScopes).
+ *   4. Cross-scope RRF when multiple scopes produced results.
+ *   5. Format results as a `<retrieved_context>` system message and return.
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { LogError, LogStatus, RunView } from '@memberjunction/core';
+import { SearchEngineBase, } from '@memberjunction/core-entities';
+import { SearchEngine, SearchFusion, } from '@memberjunction/search-engine';
+import { TemplateEngineServer } from '@memberjunction/templates';
+/**
+ * Orchestrator for agent pre-execution RAG. Stateless — create a fresh instance per call.
+ */
+export class AgentPreExecutionRAG {
+    /**
+     * Main entry point. Returns a filled-in `AgentPreExecutionRAGResult` when the agent
+     * has any active PreExecution/Both scopes; otherwise returns `null` so callers can
+     * skip injection entirely.
+     */
+    async Execute(params) {
+        if (!params.agent?.ID)
+            return null;
+        await SearchEngineBase.Instance.Config(false, params.contextUser);
+        // 1. Load active PreExecution/Both scope rows for this agent (sorted by priority)
+        const agentScopeRows = this.loadActiveAgentScopeRows(params.agent.ID);
+        if (agentScopeRows.length === 0)
+            return null;
+        const searchContext = {
+            PrimaryScopeEntityID: params.primaryScopeEntityId,
+            PrimaryScopeRecordID: params.primaryScopeRecordId,
+            SecondaryScopes: params.secondaryScopes
+        };
+        const hasContext = !!(searchContext.PrimaryScopeRecordID || (searchContext.SecondaryScopes && Object.keys(searchContext.SecondaryScopes).length > 0));
+        // 2–3. For each agent-scope row, render the query and run scoped search.
+        const perScopeResults = [];
+        for (const row of agentScopeRows) {
+            const r = await this.searchOneAgentScope(row, params, searchContext, hasContext);
+            if (r)
+                perScopeResults.push(r);
+        }
+        if (perScopeResults.length === 0)
+            return null;
+        // 4. Cross-scope RRF when multiple scopes contributed
+        const combined = this.combineAcrossScopes(perScopeResults);
+        // 5. Format for system-message injection
+        const formatted = this.formatAsSystemMessage(perScopeResults);
+        return {
+            formattedSystemMessage: formatted,
+            perScopeResults,
+            combinedResults: combined,
+            searchContext: hasContext ? searchContext : undefined,
+            queriedScopeIDs: perScopeResults.map(s => s.scopeID),
+            agentScopeRows
+        };
+    }
+    /**
+     * Load active PreExecution/Both AIAgentSearchScope rows for the agent,
+     * sorted by Priority ascending (lower number = higher priority).
+     */
+    loadActiveAgentScopeRows(agentID) {
+        const rows = SearchEngineBase.Instance.GetAgentScopes(agentID, 'PreExecution');
+        return [...rows].sort((a, b) => a.Priority - b.Priority);
+    }
+    /**
+     * Resolve + render the query for one agent-scope row, run the search
+     * (sync or streaming), and shape the per-scope result. Returns null when
+     * the row is unusable (inactive scope, empty query, search failure, or
+     * empty result set) — the caller decides whether to keep iterating.
+     */
+    async searchOneAgentScope(row, params, searchContext, hasContext) {
+        const scope = SearchEngineBase.Instance.GetActiveScopeByID(row.SearchScopeID);
+        if (!scope) {
+            LogStatus(`AgentPreExecutionRAG: Scope "${row.SearchScopeID}" not active — skipping.`);
+            return null;
+        }
+        const query = await this.resolveQuery(row, scope, params);
+        if (!query || !query.trim())
+            return null;
+        const fusionWeights = this.parseFusionWeights(row.FusionWeightsOverride);
+        const minScore = row.MinScore ?? 0;
+        const maxResults = row.MaxResults ?? 10;
+        try {
+            const sr = params.streamingEnabled
+                ? await this.streamSearchOneScope({ scope, query, maxResults, minScore, fusionWeights, searchContext, hasContext, params })
+                : await SearchEngine.Instance.Search({
+                    Query: query,
+                    MaxResults: maxResults,
+                    MinScore: minScore,
+                    ScopeIDs: [scope.ID],
+                    SearchContext: hasContext ? searchContext : undefined,
+                    FusionWeightsOverride: fusionWeights,
+                    Mode: 'full',
+                    // P3.2 — thread AIAgentID so SearchExecutionLog rows
+                    // attribute pre-execution RAG searches to the calling
+                    // agent. Without this, the analytics dashboard's "top
+                    // searches by agent" view is blind to the RAG path.
+                    AIAgentID: params.agent.ID,
+                }, params.contextUser);
+            if (sr.Success && sr.Results.length > 0) {
+                return {
+                    scopeID: scope.ID,
+                    scopeName: scope.Name,
+                    scopeDescription: scope.Description,
+                    scopeIcon: scope.Icon,
+                    query,
+                    results: sr.Results,
+                    minScore,
+                };
+            }
+            if (!sr.Success) {
+                LogError(`AgentPreExecutionRAG: Search in scope "${scope.Name}" failed: ${sr.ErrorMessage}`);
+            }
+            return null;
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            LogError(`AgentPreExecutionRAG: Exception searching scope "${scope.Name}": ${msg}`);
+            return null;
+        }
+    }
+    /**
+     * Phase 2C streaming-mode helper — consume `SearchEngine.streamSearch()`
+     * and shape the events back into a `SearchResult` so the rest of the
+     * pipeline doesn't need to know about streaming. Per-provider trace
+     * lines are appended to `params.streamingTrace` (markdown over JSON,
+     * per RAG_plan §2.2) so the agent's pre-prompt scratchpad can show
+     * "while you wait" progress.
+     */
+    async streamSearchOneScope(input) {
+        let finalResults = [];
+        let sourceCounts = { Vector: 0, FullText: 0, Entity: 0, Storage: 0 };
+        let elapsedMs = 0;
+        let errorMsg;
+        const traces = [];
+        for await (const ev of SearchEngine.Instance.streamSearch({
+            Query: input.query,
+            MaxResults: input.maxResults,
+            MinScore: input.minScore,
+            ScopeIDs: [input.scope.ID],
+            SearchContext: input.hasContext ? input.searchContext : undefined,
+            FusionWeightsOverride: input.fusionWeights,
+            Mode: 'full',
+            AIAgentID: input.params.agent.ID,
+        }, input.params.contextUser)) {
+            if (ev.phase === 'provider') {
+                traces.push(`### Provider \`${ev.providerName}\` returned ${ev.results.length} rows in ${ev.durationMs}ms`);
+            }
+            else if (ev.phase === 'final') {
+                finalResults = ev.results;
+                sourceCounts = ev.sourceCounts;
+                elapsedMs = ev.elapsedMs;
+            }
+            else if (ev.phase === 'error') {
+                errorMsg = ev.error;
+            }
+        }
+        if (input.params.streamingTrace)
+            input.params.streamingTrace.push(...traces);
+        return {
+            Success: !errorMsg,
+            Results: finalResults,
+            TotalCount: finalResults.length,
+            ElapsedMs: elapsedMs,
+            SourceCounts: sourceCounts,
+            Providers: [],
+            ErrorMessage: errorMsg,
+        };
+    }
+    /**
+     * Cross-scope reciprocal rank fusion — when 2+ scopes contributed, run
+     * RRF + dedup so the merged list reflects each scope's contribution.
+     * Single-scope cases skip fusion and return the only result list directly.
+     */
+    combineAcrossScopes(perScopeResults) {
+        if (perScopeResults.length === 1)
+            return perScopeResults[0].results;
+        const fusion = new SearchFusion();
+        const map = new Map();
+        for (const s of perScopeResults)
+            map.set(s.scopeID, s.results);
+        const maxAcrossScopes = Math.max(...perScopeResults.map(s => s.results.length));
+        return fusion.Deduplicate(fusion.CrossScopeFusion(map, Math.max(10, maxAcrossScopes)));
+    }
+    /**
+     * Shape the result into a Data-Snapshot-compatible payload so `ProcessAgentArtifacts`
+     * can persist it as a `Search Result Set` artifact. See Section 6.3 of the plan.
+     * Returns `undefined` when there is nothing to persist.
+     */
+    BuildArtifactPayload(result) {
+        if (!result || result.combinedResults.length === 0)
+            return undefined;
+        const rows = result.combinedResults.map(r => ({
+            id: r.ID,
+            recordID: r.RecordID,
+            entity: r.EntityName,
+            title: r.Title,
+            snippet: r.Snippet,
+            score: r.Score,
+            source: r.SourceType,
+            tags: r.Tags,
+            matchedAt: r.MatchedAt?.toISOString?.() ?? null,
+            scopeID: r.ProviderId
+        }));
+        return {
+            title: `Pre-execution RAG (${result.queriedScopeIDs.length} scope(s))`,
+            tables: [
+                {
+                    name: 'results',
+                    description: 'Ranked search results after per-scope and cross-scope RRF fusion.',
+                    source: 'search',
+                    columns: [
+                        { field: 'id', displayName: 'ID', sqlBaseType: 'nvarchar' },
+                        { field: 'recordID', displayName: 'Record ID', sqlBaseType: 'uniqueidentifier' },
+                        { field: 'entity', displayName: 'Entity', sqlBaseType: 'nvarchar' },
+                        { field: 'title', displayName: 'Title', sqlBaseType: 'nvarchar' },
+                        { field: 'snippet', displayName: 'Snippet', sqlBaseType: 'nvarchar' },
+                        { field: 'score', displayName: 'Score', sqlBaseType: 'decimal', isSummary: true },
+                        { field: 'source', displayName: 'Source', sqlBaseType: 'nvarchar' },
+                        { field: 'tags', displayName: 'Tags', sqlBaseType: 'nvarchar' },
+                        { field: 'matchedAt', displayName: 'Matched At', sqlBaseType: 'datetimeoffset' },
+                        { field: 'scopeID', displayName: 'Scope', sqlBaseType: 'uniqueidentifier' }
+                    ],
+                    rows,
+                    sorting: [{ field: 'score', direction: 'desc' }],
+                    metadata: { rowCount: rows.length }
+                }
+            ],
+            computations: [
+                { name: 'Total Results', type: 'count', value: rows.length, formattedValue: String(rows.length) },
+                { name: 'Top Score', type: 'max', field: 'score', value: rows[0]?.score ?? 0 }
+            ],
+            interpretation: `Retrieved ${rows.length} result(s) across ${result.queriedScopeIDs.length} scope(s) during pre-execution RAG.`,
+            scopeIDs: result.queriedScopeIDs,
+            queries: result.perScopeResults.map(s => ({ scopeID: s.scopeID, scopeName: s.scopeName, query: s.query })),
+            searchContext: result.searchContext,
+            searchedAt: new Date().toISOString()
+        };
+    }
+    // ────────────────────────────────────────────────────────────────
+    // Query resolution
+    // ────────────────────────────────────────────────────────────────
+    /**
+     * Resolve the search query for one scope. If the agent-scope row has a QueryTemplateID,
+     * render it via `TemplateEngineServer`. Otherwise fall back to `lastUserMessage`.
+     */
+    async resolveQuery(row, scope, params) {
+        if (!row.QueryTemplateID)
+            return params.lastUserMessage;
+        try {
+            const tmpl = await this.loadTemplate(row.QueryTemplateID, params.contextUser);
+            if (!tmpl)
+                return params.lastUserMessage;
+            const content = tmpl.template.GetHighestPriorityContent?.() ?? tmpl.content;
+            if (!content)
+                return params.lastUserMessage;
+            const data = {
+                lastUserMessage: params.lastUserMessage,
+                recentMessages: params.recentMessages ?? [],
+                conversationSummary: params.conversationSummary ?? '',
+                payload: params.payload ?? {},
+                agentName: params.agent.Name,
+                agentDescription: params.agent.Description ?? '',
+                scopeName: scope.Name,
+                scopeDescription: scope.Description ?? ''
+            };
+            const rendered = await TemplateEngineServer.Instance.RenderTemplate(tmpl.template, content, data);
+            if (rendered?.Success && rendered.Output) {
+                return rendered.Output.trim();
+            }
+            LogError(`AgentPreExecutionRAG: Template "${row.QueryTemplateID}" render failed: ${rendered?.Message ?? 'unknown'}`);
+            return params.lastUserMessage;
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            LogError(`AgentPreExecutionRAG: Template "${row.QueryTemplateID}" exception: ${msg}`);
+            return params.lastUserMessage;
+        }
+    }
+    /**
+     * Load a Template entity + its highest-priority content row.
+     * Uses the cached `TemplateEngineServer.FindTemplate` when available; falls back to a
+     * direct RunView when not.
+     */
+    async loadTemplate(templateID, contextUser) {
+        try {
+            await TemplateEngineServer.Instance.Config(false, contextUser);
+            const t = TemplateEngineServer.Instance.FindTemplate?.(templateID);
+            if (t) {
+                const content = t.GetHighestPriorityContent?.() ?? null;
+                return { template: t, content };
+            }
+        }
+        catch {
+            // fall through to RunView
+        }
+        const rv = new RunView();
+        const tResult = await rv.RunView({
+            EntityName: 'Templates',
+            ExtraFilter: `ID='${templateID}'`,
+            ResultType: 'entity_object'
+        }, contextUser);
+        if (!tResult.Success || tResult.Results.length === 0)
+            return null;
+        const template = tResult.Results[0];
+        const cResult = await rv.RunView({
+            EntityName: 'Template Contents',
+            ExtraFilter: `TemplateID='${templateID}'`,
+            OrderBy: 'Priority DESC, __mj_CreatedAt ASC',
+            MaxRows: 1,
+            ResultType: 'entity_object'
+        }, contextUser);
+        const content = cResult.Success && cResult.Results.length > 0 ? cResult.Results[0] : null;
+        return { template, content };
+    }
+    parseFusionWeights(raw) {
+        if (!raw)
+            return undefined;
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed === 'object')
+                return parsed;
+        }
+        catch {
+            LogError(`AgentPreExecutionRAG: Invalid FusionWeightsOverride JSON — ignoring: ${raw.substring(0, 120)}`);
+        }
+        return undefined;
+    }
+    // ────────────────────────────────────────────────────────────────
+    // Output formatting
+    // ────────────────────────────────────────────────────────────────
+    /**
+     * Format the per-scope results into a `<retrieved_context>` system-message block.
+     * Matches the shape documented in Section 4.2 of the plan.
+     */
+    formatAsSystemMessage(perScope) {
+        const lines = [];
+        lines.push('<retrieved_context>');
+        lines.push('The following information was retrieved from your configured knowledge scopes based on the current conversation.');
+        lines.push('Use this context to inform your response. If the retrieved information conflicts with your training data, prefer the retrieved information — it may be more current or tenant-specific.');
+        lines.push('');
+        let globalIndex = 1;
+        for (const s of perScope) {
+            const header = `--- Results from "${s.scopeName}" (${s.results.length} result(s)${s.minScore > 0 ? `, min score ${s.minScore.toFixed(2)}` : ''}) ---`;
+            lines.push(header);
+            if (s.scopeDescription)
+                lines.push(`(${s.scopeDescription})`);
+            lines.push('');
+            for (const r of s.results) {
+                const titleLine = `${globalIndex}. [${r.Title || r.RecordID}] (score: ${r.Score.toFixed(2)}, source: ${r.SourceType}${r.EntityName ? `, entity: ${r.EntityName}` : ''})`;
+                lines.push(titleLine);
+                if (r.Snippet)
+                    lines.push(`   ${r.Snippet}`);
+                if (r.Tags && r.Tags.length)
+                    lines.push(`   tags: ${r.Tags.join(', ')}`);
+                lines.push('');
+                globalIndex++;
+            }
+        }
+        lines.push('</retrieved_context>');
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=agent-pre-execution-rag.js.map

package/dist/agent-pre-execution-rag.js.map

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

package/dist/artifact-tools/SearchResultSetToolLibrary.d.ts

@@ -0,0 +1,24 @@
+import { BaseArtifactToolLibrary, type ArtifactToolDefinition, type ArtifactToolResult } from '@memberjunction/ai-core-plus';
+/**
+ * Register the library so the ArtifactToolManager can resolve it by the
+ * artifact type's ToolLibraryClass column ('SearchResultSetToolLibrary').
+ */
+export declare class SearchResultSetToolLibrary extends BaseArtifactToolLibrary {
+    /**
+     * Tools provided in addition to whatever the parent chain (DataSnapshot
+     * → Data → ...) supplies. Naming and shape mirror the spec's mockup #5.
+     */
+    GetToolList(): ArtifactToolDefinition[];
+    InvokeTool(toolName: string, input: Record<string, unknown>, artifactContent: string | Buffer): Promise<ArtifactToolResult>;
+    private filterByScore;
+    private groupBySourceProvider;
+    private getMatchingChunks;
+    private followSourceLink;
+    private rerankInline;
+    /** Strip internal UUID before handing a row to the LLM. */
+    private toAgentRow;
+}
+/** Tree-shake-prevention hook. Call from consumer index to ensure the
+ * @RegisterClass side-effect runs. */
+export declare function LoadSearchResultSetToolLibrary(): void;
+//# sourceMappingURL=SearchResultSetToolLibrary.d.ts.map

package/dist/artifact-tools/SearchResultSetToolLibrary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchResultSetToolLibrary.d.ts","sourceRoot":"","sources":["../../src/artifact-tools/SearchResultSetToolLibrary.ts"],"names":[],"mappings":"AAqBA,OAAO,EACH,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EAC1B,MAAM,8BAA8B,CAAC;AAkJtC;;;GAGG;AACH,qBACa,0BAA2B,SAAQ,uBAAuB;IACnE;;;OAGG;IACH,WAAW,IAAI,sBAAsB,EAAE;IA0DjC,UAAU,CACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,eAAe,EAAE,MAAM,GAAG,MAAM,GACjC,OAAO,CAAC,kBAAkB,CAAC;IAqB9B,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,qBAAqB;IA4B7B,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,YAAY;IAsBpB,2DAA2D;IAC3D,OAAO,CAAC,UAAU;CAOrB;AAED;sCACsC;AACtC,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD"}