@memberjunction/ai-agents 6.2.0-edge.1 → 6.2.0-edge.2

package/dist/PayloadFeedbackManager.js

@@ -9,19 +9,53 @@
  * @since 3.1.0
  */
 import { LogStatus, LogError } from '@memberjunction/core';
-import { AIEngine } from '@memberjunction/aiengine';
-import { AIPromptRunner } from '@memberjunction/ai-prompts';
-import { AIPromptParams } from '@memberjunction/ai-core-plus';
+import { PayloadWarningType } from './PayloadChangeAnalyzer.js';
+import { AgentDecisionService } from './AgentDecisionService.js';
+/** The probability at or above which a change is judged intended, unless configured. */
+const DEFAULT_INTENDED_THRESHOLD = 0.5;
+/** The questions one decision call carries, unless `maxQuestionsPerBatch` says otherwise. */
+const DEFAULT_MAX_QUESTIONS_PER_CALL = 10;
+/** The most characters of each reasoning or message field the decision state carries. */
+const MAX_CONTEXT_TEXT = 4000;
+/** The most removed key names listed for one change. */
+const MAX_LISTED_KEYS = 10;
 /**
  * Manages feedback collection for suspicious payload changes
  */
 export class PayloadFeedbackManager {
-    constructor(config) {
+    /**
+     * The longest the decision call may take. Past it the call is aborted and every change is
+     * accepted, as on any other failure. The same bound as the catalog narrowing decision.
+     */
+    static { this.DECISION_TIMEOUT_MS = 30000; }
+    /**
+     * @param config - Feedback settings. See {@link PayloadFeedbackConfig}.
+     * @param decisionService - Answers the questions in {@link QueryAgent}. Defaults to a new
+     *   {@link AgentDecisionService}.
+     */
+    constructor(config, decisionService) {
         this.config = {
-            maxQuestionsPerBatch: 10,
+            maxQuestionsPerBatch: DEFAULT_MAX_QUESTIONS_PER_CALL,
             temperature: 0.1,
+            intendedThreshold: DEFAULT_INTENDED_THRESHOLD,
             ...config
         };
+        this.decisionService = decisionService ?? new AgentDecisionService();
+    }
+    /**
+     * The probability at or above which a change is judged intended: `intendedThreshold`, or 0.5
+     * when that is not a number from 0 to 1.
+     */
+    get IntendedThreshold() {
+        const threshold = this.config.intendedThreshold;
+        return typeof threshold === 'number' && threshold >= 0 && threshold <= 1 ? threshold : DEFAULT_INTENDED_THRESHOLD;
+    }
+    /**
+     * The result of the most recent decision call {@link QueryAgent} made, so the caller can link
+     * its prompt run to a run step and count its cost. Undefined until a call is made.
+     */
+    get LastDecisionResult() {
+        return this._lastDecisionResult;
     }
     /**
      * Generate feedback questions from warnings
@@ -76,108 +110,214 @@ export class PayloadFeedbackManager {
         };
     }
     /**
-     * Query the AI agent about suspicious changes using MemberJunction AI Prompts system.
+     * Asks whether each suspicious payload change was intended: one Likelihood per question, all
+     * in one decision call. The state is the agent's reasoning and message for the step plus a
+     * compact list of the changes (paths, and sizes or types), never the payload itself.
+     *
+     * A change is `intended` when its probability is at or above {@link IntendedThreshold}, and
+     * its explanation carries the probability. When no decision answers a change (no context user,
+     * a failed, throwing, cancelled or timed-out call, a missing answer, or more questions than one
+     * call carries), the change is accepted, as it always was, and its explanation says why. Never
+     * throws.
      *
-     * @param questions - Array of feedback questions to ask about payload changes
-     * @param conversationContext - Context from the conversation (for reference)
-     * @param contextUser - User context for the prompt execution
-     * @returns Array of responses indicating whether each change was intended
+     * @param questions - The questions from {@link GenerateQuestions}
+     * @param context - The agent's reasoning and message for the step, and the call's options
+     * @param contextUser - The user the decision runs as
+     * @returns One response per question, in the same order
      */
-    async QueryAgent(questions, conversationContext, contextUser) {
+    async QueryAgent(questions, context, contextUser) {
         if (questions.length === 0) {
             return [];
         }
-        // Find the payload feedback prompt
-        const promptName = 'Payload Change Feedback Query';
-        const prompt = AIEngine.Instance.Prompts.find(p => p.Name.trim().toLowerCase() === promptName.toLowerCase() &&
-            p.Category?.trim().toLowerCase() === 'mj: system');
-        if (!prompt) {
-            // Fallback: accept all changes if prompt not configured
-            LogStatus(`PayloadFeedbackManager: Prompt "${promptName}" not found in MJ: System category. Accepting all changes by default.`);
-            return questions.map(q => ({
-                questionId: q.id,
-                intended: true,
-                explanation: 'Accepted by default (feedback prompt not configured)'
-            }));
-        }
-        try {
-            // Build template parameters
-            const templateData = this.buildFeedbackTemplateParams(questions);
-            // Execute the prompt
-            const runner = new AIPromptRunner();
-            const promptParams = new AIPromptParams();
-            promptParams.prompt = prompt;
-            promptParams.data = templateData;
-            if (contextUser) {
-                promptParams.contextUser = contextUser;
-            }
-            const result = await runner.ExecutePrompt(promptParams);
-            if (!result.success || !result.result?.responses) {
-                LogError('PayloadFeedbackManager: Failed to get valid response from feedback prompt', undefined, result.errorMessage);
-                // Fallback to accepting all changes
-                return questions.map(q => ({
-                    questionId: q.id,
-                    intended: true,
-                    explanation: 'Accepted by default (prompt execution failed)'
-                }));
-            }
-            // Map LLM responses back to our format
-            return this.mapLLMResponsesToFeedback(questions, result.result.responses);
+        if (!contextUser) {
+            return questions.map(q => this.acceptedByDefault(q, 'no context user for the decision call'));
         }
-        catch (error) {
-            LogError('PayloadFeedbackManager: Error querying agent for feedback', undefined, error);
-            // Fallback to accepting all changes
-            return questions.map(q => ({
-                questionId: q.id,
-                intended: true,
-                explanation: 'Accepted by default (error during feedback query)'
-            }));
+        const asked = questions.slice(0, this.maxQuestionsPerCall());
+        const result = await this.askDecisions(asked, context ?? {}, contextUser);
+        this._lastDecisionResult = result;
+        if (!result.success) {
+            const reason = result.errorMessage || 'no error message';
+            LogError(`PayloadFeedbackManager: the payload change decisions failed, so every change is accepted: ${reason}`);
+            return questions.map(q => this.acceptedByDefault(q, `the decision call failed: ${reason}`));
         }
+        return questions.map((question, i) => i < asked.length
+            ? this.mapAnswerToFeedback(question, result.Answers[this.questionKey(i)])
+            : this.acceptedByDefault(question, `over the limit of ${asked.length} questions per decision call`));
     }
     /** @deprecated Use {@link QueryAgent}. */
-    async queryAgent(questions, conversationContext, contextUser) {
-        return this.QueryAgent(questions, conversationContext, contextUser);
+    async queryAgent(questions, context, contextUser) {
+        return this.QueryAgent(questions, context, contextUser);
     }
     /**
-     * Map LLM responses back to PayloadFeedbackResponse format
+     * Describes one flagged change in a line: what the analyzer saw, where, and the names of any
+     * removed keys. The analyzer's message carries the sizes or types, never payload content.
      */
-    mapLLMResponsesToFeedback(questions, llmResponses) {
-        return questions.map((q, index) => {
-            const questionNumber = index + 1;
-            const llmResponse = llmResponses.find(r => r.questionNumber === questionNumber);
-            if (llmResponse) {
-                return {
-                    questionId: q.id,
-                    intended: llmResponse.intended,
-                    explanation: llmResponse.explanation
-                };
+    DescribeChange(warning) {
+        const where = warning.path ? `"${warning.path}"` : 'the payload root';
+        const keys = this.removedKeyNames(warning);
+        const removed = keys.length > 0 ? ` (removed: ${keys.join(', ')})` : '';
+        return `${warning.message} at ${where}${removed}`;
+    }
+    /**
+     * The message that lists the changes judged unintended and asks the agent to confirm them or put
+     * them back, or `undefined` when every change was judged intended. It reverts nothing itself, and
+     * it never carries the original values, so it tells the agent how to rebuild them.
+     */
+    BuildUnintendedChangesMessage(questions, responses) {
+        const lines = [];
+        const unintended = [];
+        for (const response of responses) {
+            const question = questions.find(q => q.id === response.questionId);
+            if (question && !response.intended) {
+                const probability = typeof response.probability === 'number'
+                    ? ` (probability it was intended: ${response.probability.toFixed(2)})`
+                    : '';
+                lines.push(`- ${this.DescribeChange(question.warning)}${probability}`);
+                unintended.push(question.warning);
             }
-            // Default to intended if no matching response found
-            return {
-                questionId: q.id,
-                intended: true,
-                explanation: 'No explicit response from LLM - assuming intended'
-            };
-        });
+        }
+        if (lines.length === 0) {
+            return undefined;
+        }
+        return [
+            'Payload change check: these changes to the payload may not have been intended.',
+            ...lines,
+            'Nothing was reverted. If you meant a change, confirm it in your reasoning and carry on.',
+            this.restoreInstructions(unintended)
+        ].join('\n');
     }
     /**
-     * Build template parameters for the feedback prompt
-     *
-     * @todo This should prepare the data structure to pass to the stored prompt template
+     * How the agent puts the listed changes back: a removed key is added again under `newElements`,
+     * and any other change is set again under `updateElements`. The message has no original values,
+     * so the agent rebuilds them from their source, or says what was lost.
+     */
+    restoreInstructions(warnings) {
+        const steps = [];
+        if (warnings.some(w => w.type === PayloadWarningType.KeyRemoval)) {
+            steps.push('add each removed key back under newElements');
+        }
+        if (warnings.some(w => w.type !== PayloadWarningType.KeyRemoval)) {
+            steps.push('set each shortened or changed value again under updateElements');
+        }
+        return `If not, put the data back with a payloadChangeRequest: ${steps.join(', and ')}. `
+            + 'The original values are not shown here, so rebuild each one from where it came from '
+            + '(an action result, a sub-agent result or the conversation). If you cannot, say in your message what was lost.';
+    }
+    /**
+     * Asks the questions in one call. Never throws, and never waits longer than
+     * {@link PayloadFeedbackManager.DECISION_TIMEOUT_MS} or past the run's cancellation: a throw, a
+     * timeout and a cancelled run each come back as a failed result, so the caller accepts every
+     * change. Stopping also aborts the call.
      */
-    buildFeedbackTemplateParams(questions) {
+    async askDecisions(questions, context, contextUser) {
+        const runToken = context.CancellationToken;
+        if (runToken?.aborted) {
+            return this.failedResult('the run was cancelled');
+        }
+        const controller = new AbortController();
+        let stop = () => undefined;
+        const stopped = new Promise(resolve => {
+            stop = (reason) => {
+                controller.abort(reason);
+                resolve(this.failedResult(reason));
+            };
+        });
+        const relayRunAbort = () => stop('the run was cancelled');
+        runToken?.addEventListener('abort', relayRunAbort, { once: true });
+        const timeoutMS = PayloadFeedbackManager.DECISION_TIMEOUT_MS;
+        const timer = setTimeout(() => stop(`timed out after ${timeoutMS} ms`), timeoutMS);
+        try {
+            const ask = this.decisionService.Ask({
+                State: this.buildDecisionState(questions, context),
+                Questions: this.buildDecisionQuestions(questions),
+                ContextUser: contextUser,
+                AgentID: context.AgentID,
+                PromptName: this.config.decisionPromptName,
+                CancellationToken: controller.signal
+            });
+            return await Promise.race([ask, stopped]);
+        }
+        catch (error) {
+            return this.failedResult(error instanceof Error ? error.message : String(error));
+        }
+        finally {
+            clearTimeout(timer);
+            runToken?.removeEventListener('abort', relayRunAbort);
+        }
+    }
+    /** A decision result that answered nothing, and why. */
+    failedResult(errorMessage) {
+        return { success: false, errorMessage, Answers: {} };
+    }
+    /** One Likelihood per question: "Given the agent's stated reasoning, this change was intended: ...". */
+    buildDecisionQuestions(questions) {
+        const result = {};
+        questions.forEach((question, i) => {
+            result[this.questionKey(i)] = {
+                Kind: 'Likelihood',
+                Instructions: `Given the agent's stated reasoning, this change was intended: ${this.DescribeChange(question.warning)}`
+            };
+        });
+        return result;
+    }
+    /** The agent's reasoning and message, then the numbered changes. Never the payload. */
+    buildDecisionState(questions, context) {
+        const sections = [
+            this.contextSection("The agent's reasoning for this step", context.Reasoning),
+            this.contextSection("The agent's reasoning for the payload change", context.ChangeReasoning),
+            this.contextSection("The agent's message", context.Message)
+        ].filter((section) => section !== undefined);
+        if (sections.length === 0) {
+            sections.push('The agent gave no reasoning or message for this step.');
+        }
+        const changes = questions.map((q, i) => `${i + 1}. ${this.DescribeChange(q.warning)}`);
+        sections.push(`The payload changes in question (paths, and sizes or types):\n${changes.join('\n')}`);
+        return sections.join('\n\n');
+    }
+    /** A labelled, capped block of the agent's text, or `undefined` when there is none. */
+    contextSection(label, text) {
+        const trimmed = typeof text === 'string' ? text.trim() : '';
+        return trimmed ? `${label}:\n${trimmed.slice(0, MAX_CONTEXT_TEXT)}` : undefined;
+    }
+    /** The key names a key-removal warning recorded, if any. */
+    removedKeyNames(warning) {
+        const details = warning.details;
+        if (typeof details !== 'object' || details === null || !('removedKeys' in details) || !Array.isArray(details.removedKeys)) {
+            return [];
+        }
+        const keys = details.removedKeys;
+        return keys.filter((key) => typeof key === 'string').slice(0, MAX_LISTED_KEYS);
+    }
+    /** Maps one answer to the feedback shape. Anything but a numeric Likelihood is accepted by default. */
+    mapAnswerToFeedback(question, answer) {
+        if (answer?.Kind !== 'Likelihood' || !Number.isFinite(answer.Probability)) {
+            return this.acceptedByDefault(question, 'no usable answer for this change');
+        }
+        const threshold = this.IntendedThreshold;
         return {
-            questions: questions.map((q, i) => ({
-                number: i + 1,
-                text: q.question,
-                context: q.context,
-                warningType: q.warning.type,
-                severity: q.warning.severity
-            })),
-            totalQuestions: questions.length,
-            timestamp: new Date().toISOString()
+            questionId: question.id,
+            intended: answer.Probability >= threshold,
+            probability: answer.Probability,
+            explanation: `Probability the change was intended: ${answer.Probability.toFixed(2)} (threshold ${threshold})`
         };
     }
+    /** Accepts the change, as it always was, and says why. */
+    acceptedByDefault(question, reason) {
+        return {
+            questionId: question.id,
+            intended: true,
+            explanation: `Accepted by default (${reason})`
+        };
+    }
+    /** The question key for position `index`. Keys are labels for code; the model reads the instructions. */
+    questionKey(index) {
+        return `change_${index + 1}`;
+    }
+    /** `maxQuestionsPerBatch`, or 10 when that is not a positive whole number. */
+    maxQuestionsPerCall() {
+        const max = this.config.maxQuestionsPerBatch;
+        return typeof max === 'number' && Number.isInteger(max) && max > 0 ? max : DEFAULT_MAX_QUESTIONS_PER_CALL;
+    }
     /**
      * Process feedback responses and determine final result
      */

package/dist/PayloadFeedbackManager.js.map

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

package/dist/agent-context-injector.d.ts

@@ -1,9 +1,11 @@
 import { UserInfo } from "@memberjunction/core";
 import { MJAIAgentNoteEntity, MJAIAgentExampleEntity } from "@memberjunction/core-entities";
 import { SecondaryScopeConfig, SecondaryScopeValue } from "@memberjunction/ai-core-plus";
+import type { MJAIAgentRunStepEntityExtended } from "@memberjunction/ai-core-plus";
 import { RerankerConfiguration } from "@memberjunction/ai-reranker";
 /**
- * Options for observability integration when retrieving notes.
+ * Options for observability integration when retrieving notes or examples: the rerank step's run,
+ * parent and number.
  */
 export interface NotesObservabilityOptions {
     /**
@@ -18,6 +20,11 @@ export interface NotesObservabilityOptions {
      * Step sequence number for the rerank step
      */
     stepNumber?: number;
+    /**
+     * Receives the rerank step as soon as it is created, so the agent run can count it. See
+     * `RerankObservabilityOptions.OnStepCreated`.
+     */
+    OnStepCreated?: (step: MJAIAgentRunStepEntityExtended) => void;
 }
 /**
  * Parameters for retrieving notes in a specific context
@@ -72,6 +79,15 @@ export interface GetExamplesParams {
      * Defines per-dimension inheritance modes and validation rules.
      */
     secondaryScopeConfig?: SecondaryScopeConfig | null;
+    /**
+     * Optional reranker configuration. Examples are reranked only when it is enabled and its
+     * `rerankExamples` flag is true.
+     */
+    rerankerConfig?: RerankerConfiguration | null;
+    /**
+     * Optional observability context for tracing the examples rerank, as for notes.
+     */
+    observability?: NotesObservabilityOptions;
 }
 /**
  * Central service for retrieving and formatting notes/examples for injection into agent context.
@@ -95,7 +111,8 @@ export declare class AgentContextInjector {
      * When reranking is enabled:
      * 1. Fetch N * retrievalMultiplier candidates via vector search
      * 2. Rerank candidates using configured reranker
-     * 3. Return top N reranked results
+     * 3. Return top N reranked results, or the top N vector search results when no candidate reached
+     *    the rerank threshold
      *
      * Fallback behavior (controlled by config.fallbackOnError):
      * - If true: On reranking failure, gracefully falls back to vector search results
@@ -103,9 +120,36 @@ export declare class AgentContextInjector {
      */
     private getNotesViaSemanticSearch;
     /**
-     * Get examples using semantic search via AIEngine
+     * Get examples using semantic search via AIEngine.
+     * Supports an optional reranking stage, off unless the reranker configuration sets `rerankExamples`.
+     *
+     * When example reranking is on:
+     * 1. Fetch N * retrievalMultiplier candidates via vector search
+     * 2. Rerank candidates with the same reranker and threshold as notes
+     * 3. Return top N reranked results, falling back as config.fallbackOnError says, or the top N
+     *    vector search results when no candidate reached the rerank threshold
      */
     private getExamplesViaSemanticSearch;
+    /**
+     * Logs a rerank that kept nothing. Its caller then keeps the vector search order, as if reranking
+     * were off: rerank scores need not be calibrated (a DecisionReranker's are uncalibrated
+     * probabilities), so a threshold that drops every candidate is not evidence that none is relevant.
+     * This is not a failure, so it does not depend on fallbackOnError.
+     */
+    private logEmptyRerank;
+    /** The observability options a rerank runs under, from the caller's, or none. */
+    private rerankObservability;
+    /**
+     * The reranker configuration for examples: the agent's configuration when it is enabled and sets
+     * `rerankExamples` to true, otherwise null.
+     */
+    private exampleRerankerConfig;
+    /**
+     * Stage 2 for examples: reranks the vector search candidates and returns the top N. On failure, falls
+     * back to the vector search results when config.fallbackOnError is true, and throws otherwise. When no
+     * candidate reaches the threshold, returns the top N vector search results.
+     */
+    private rerankExamples;
     /**
      * Build a pre-filter callback for vector search that enforces secondary scope rules.
      * Returns undefined when no scope params are provided (no filtering needed).

package/dist/agent-context-injector.d.ts.map

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

package/dist/agent-context-injector.js

@@ -39,7 +39,8 @@ export class AgentContextInjector {
      * When reranking is enabled:
      * 1. Fetch N * retrievalMultiplier candidates via vector search
      * 2. Rerank candidates using configured reranker
-     * 3. Return top N reranked results
+     * 3. Return top N reranked results, or the top N vector search results when no candidate reached
+     *    the rerank threshold
      *
      * Fallback behavior (controlled by config.fallbackOnError):
      * - If true: On reranking failure, gracefully falls back to vector search results
@@ -65,11 +66,11 @@ export class AgentContextInjector {
         LogStatus(`AgentContextInjector: Reranking ${matches.length} candidates to top ${params.maxNotes}`);
         const rerankerService = RerankerService.Instance;
         try {
-            const rerankResult = await rerankerService.rerankNotes(matches, params.currentInput, config, params.contextUser, params.observability ? {
-                agentRunID: params.observability.agentRunID,
-                parentStepID: params.observability.parentStepID,
-                stepNumber: params.observability.stepNumber
-            } : undefined);
+            const rerankResult = await rerankerService.rerankNotes(matches, params.currentInput, config, params.contextUser, this.rerankObservability(params.observability));
+            if (rerankResult.notes.length === 0) {
+                this.logEmptyRerank('note', config);
+                return matches.slice(0, params.maxNotes).map(m => m.note);
+            }
             // Return top N reranked notes
             const result = rerankResult.notes.slice(0, params.maxNotes).map(m => m.note);
             LogStatus(`AgentContextInjector: Returning ${result.length} notes after reranking`);
@@ -89,14 +90,80 @@ export class AgentContextInjector {
         }
     }
     /**
-     * Get examples using semantic search via AIEngine
+     * Get examples using semantic search via AIEngine.
+     * Supports an optional reranking stage, off unless the reranker configuration sets `rerankExamples`.
+     *
+     * When example reranking is on:
+     * 1. Fetch N * retrievalMultiplier candidates via vector search
+     * 2. Rerank candidates with the same reranker and threshold as notes
+     * 3. Return top N reranked results, falling back as config.fallbackOnError says, or the top N
+     *    vector search results when no candidate reached the rerank threshold
      */
     async getExamplesViaSemanticSearch(params) {
+        const config = this.exampleRerankerConfig(params);
+        // Calculate candidates to fetch (more if reranking examples)
+        const fetchCount = config
+            ? params.maxExamples * config.retrievalMultiplier
+            : params.maxExamples;
         // Build scope pre-filter so FindNearest only returns scope-valid candidates
         const scopePreFilter = this.buildScopePreFilter(params, m => m.exampleEntity);
-        const matches = await AIEngine.Instance.FindSimilarAgentExamples(params.currentInput, params.agentId, params.userId, params.companyId, params.maxExamples, 0.5, scopePreFilter);
-        // Return entities directly from vector service (no database round-trip)
-        return matches.map(m => m.example);
+        const matches = await AIEngine.Instance.FindSimilarAgentExamples(params.currentInput, params.agentId, params.userId, params.companyId, fetchCount, 0.5, scopePreFilter);
+        if (!config) {
+            // Return entities directly from vector service (no database round-trip)
+            return matches.map(m => m.example);
+        }
+        return this.rerankExamples(matches, params, config);
+    }
+    /**
+     * Logs a rerank that kept nothing. Its caller then keeps the vector search order, as if reranking
+     * were off: rerank scores need not be calibrated (a DecisionReranker's are uncalibrated
+     * probabilities), so a threshold that drops every candidate is not evidence that none is relevant.
+     * This is not a failure, so it does not depend on fallbackOnError.
+     */
+    logEmptyRerank(kind, config) {
+        LogStatus(`AgentContextInjector: No ${kind} reached the rerank threshold (${config.minRelevanceThreshold}), keeping the vector search results`);
+    }
+    /** The observability options a rerank runs under, from the caller's, or none. */
+    rerankObservability(observability) {
+        return observability ? {
+            agentRunID: observability.agentRunID,
+            parentStepID: observability.parentStepID,
+            stepNumber: observability.stepNumber,
+            OnStepCreated: observability.OnStepCreated
+        } : undefined;
+    }
+    /**
+     * The reranker configuration for examples: the agent's configuration when it is enabled and sets
+     * `rerankExamples` to true, otherwise null.
+     */
+    exampleRerankerConfig(params) {
+        const config = params.rerankerConfig;
+        return config?.enabled && config.rerankExamples === true ? config : null;
+    }
+    /**
+     * Stage 2 for examples: reranks the vector search candidates and returns the top N. On failure, falls
+     * back to the vector search results when config.fallbackOnError is true, and throws otherwise. When no
+     * candidate reaches the threshold, returns the top N vector search results.
+     */
+    async rerankExamples(matches, params, config) {
+        LogStatus(`AgentContextInjector: Reranking ${matches.length} example candidates to top ${params.maxExamples}`);
+        try {
+            const reranked = await RerankerService.Instance.RerankExamples(matches, params.currentInput, config, params.contextUser, this.rerankObservability(params.observability));
+            if (reranked.length === 0) {
+                this.logEmptyRerank('example', config);
+                return matches.slice(0, params.maxExamples).map(m => m.example);
+            }
+            return reranked.slice(0, params.maxExamples).map(m => m.example);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (config.fallbackOnError) {
+                LogStatus(`AgentContextInjector: Example reranking failed (${message}), falling back to vector search results`);
+                return matches.slice(0, params.maxExamples).map(m => m.example);
+            }
+            LogError(`AgentContextInjector: Example reranking failed and fallbackOnError is false: ${message}`);
+            throw error;
+        }
     }
     /**
      * Build a pre-filter callback for vector search that enforces secondary scope rules.