@memberjunction/ai-prompts 5.41.0 → 5.42.0

package/dist/AIPromptRunner.d.ts

@@ -3,61 +3,8 @@ import { AIModelRunner } from './AIModelRunner.js';
 import { AIPromptRunResult } from '@memberjunction/ai-core-plus';
 import { IMetadataProvider } from '@memberjunction/core';
 import { MJAIModelEntityExtended, MJAIPromptEntityExtended, MJAIPromptRunEntityExtended } from "@memberjunction/ai-core-plus";
+import { type IParallelExecutionCoordinator } from './ParallelExecution.js';
 import { TemplateMessageRole, AIPromptParams } from '@memberjunction/ai-core-plus';
-/**
- * Advanced AI Prompt execution engine with comprehensive template support, hierarchical template composition,
- * sophisticated model selection, parallelization, output validation, and execution tracking.
- *
- * ## Core Features
- * - **Template-based prompt generation** using MJ Templates system
- * - **Hierarchical template composition** with depth-first rendering and parallel template processing
- * - **Advanced model selection** strategies (Default, Specific, ByPower)
- * - **Parallel execution** with multiple models and execution groups
- * - **Structured output validation** and type conversion with retry logic
- * - **Comprehensive execution tracking** with agent run linking
- * - **Configuration-driven behavior** with caching and performance optimization
- * - **Real-time progress updates** and streaming response support
- *
- * ## Hierarchical Template Composition
- * When `childPrompts` array is provided in {@link AIPromptParams}:
- * 1. Renders child prompt templates in depth-first manner (children before parents)
- * 2. At each level, renders sibling templates in parallel for optimal performance
- * 3. Recursively handles grandchild templates (unlimited nesting depth)
- * 4. Substitutes rendered child templates into corresponding placeholders in parent template
- * 5. Executes the final composed prompt as a single operation
- *
- * This enables complex prompt composition patterns where templates can be built from reusable
- * sub-templates, creating sophisticated prompts through hierarchical template inheritance.
- *
- * ## Agent Integration
- * - Links executions to agent runs via `agentRunId` parameter
- * - Supports agent decision-making workflows with structured JSON responses
- * - Enables hierarchical template patterns in AI agents
- *
- * @example Basic Usage
- * ```typescript
- * const runner = new AIPromptRunner();
- * const params = new AIPromptParams();
- * params.prompt = aiPrompt;
- * params.data = { key: 'value' };
- * const result = await runner.ExecutePrompt(params);
- * ```
- *
- * @example Hierarchical Template Composition
- * ```typescript
- * const params = new AIPromptParams();
- * params.prompt = parentPrompt;
- * params.childPrompts = [
- *   new ChildPromptParam(analysisPrompt, 'analysis'),
- *   new ChildPromptParam(summaryPrompt, 'summary'),
- *   new ChildPromptParam(complexChild, 'complex') // This can have its own child templates
- * ];
- * params.data = { userInput: 'complex data to process' };
- * const result = await runner.ExecutePrompt(params);
- * // Child templates render first, then parent template uses {{ analysis }}, {{ summary }}, {{ complex }}
- * // Final composed prompt is executed once
- * ```
- */
 /**
  * Represents a model-vendor pair candidate for execution
  */
@@ -99,7 +46,7 @@ export declare class AIPromptRunner {
     private _metadata;
     private _templateEngine;
     private _executionPlanner;
-    private _parallelCoordinator;
+    private _parallelCoordinator?;
     private _jsonValidator;
     private _modelRunner;
     private _provider;
@@ -136,6 +83,21 @@ export declare class AIPromptRunner {
     get Provider(): IMetadataProvider;
     set Provider(value: IMetadataProvider | null);
     constructor();
+    /** ClassFactory key the parallel coordinator self-registers under (see {@link ParallelCoordinator}). */
+    private static readonly PARALLEL_COORDINATOR_KEY;
+    /**
+     * Lazily resolves the parallel execution coordinator.
+     *
+     * The coordinator is a SUBCLASS of AIPromptRunner — it inherits {@link executeModel} and the rest
+     * of the battle-tested execution path so there is a single source of truth for credential / driver
+     * / ChatParams / streaming resolution. That subclass relationship means the base cannot statically
+     * `new` it without a hard circular import, so we resolve it through the ClassFactory instead (the
+     * coordinator self-registers via `@RegisterClass(AIPromptRunner, PARALLEL_COORDINATOR_KEY)`).
+     * Created once per runner and reused; the runner's Provider override is propagated. Throws a clear
+     * error if the coordinator class was never loaded/registered — otherwise ClassFactory would silently
+     * fall back to a plain AIPromptRunner that lacks the parallel methods.
+     */
+    protected get ParallelCoordinator(): IParallelExecutionCoordinator;
     /**
      * Access the underlying AIModelRunner for embedding and other non-LLM model calls.
      * Use this when you need tracked embedding execution with AIPromptRun record creation.
@@ -438,14 +400,6 @@ export declare class AIPromptRunner {
      * TypeScript requires instantiating the class to get the getValidCandidates() method.
      */
     private createSelectionInfo;
-    /**
-     * Converts model selection info into ModelVendorCandidate array for retry logic.
-     * Extracts only the valid candidates (those with available API keys) from the selection info.
-     *
-     * @param selectionInfo - Model selection information containing considered models
-     * @returns Array of valid model-vendor candidates sorted by priority
-     */
-    private buildCandidatesFromSelectionInfo;
     /**
      * Enhanced version of selectModelWithAPIKey that tracks all considered models
      * for model selection reporting. Uses the hierarchical credential resolution
@@ -514,7 +468,7 @@ export declare class AIPromptRunner {
      * - updatePromptRunWithFailoverFailure: Records failed failover metadata
      * - createFailoverErrorResult: Creates standardized error response
      */
-    protected executeModelWithFailover(model: MJAIModelEntityExtended, renderedPrompt: string, prompt: MJAIPromptEntityExtended, params: AIPromptParams, vendorId: string | null, conversationMessages?: ChatMessage[], templateMessageRole?: TemplateMessageRole, cancellationToken?: AbortSignal, allCandidates?: ModelVendorCandidate[], promptRun?: MJAIPromptRunEntityExtended, vendorDriverClass?: string, vendorApiName?: string, vendorSupportsEffortLevel?: boolean, modelEffortLevel?: number): Promise<ChatResult>;
+    protected executeModelWithFailover(model: MJAIModelEntityExtended, renderedPrompt: string, prompt: MJAIPromptEntityExtended, params: AIPromptParams, vendorId: string | null, conversationMessages?: ChatMessage[], templateMessageRole?: TemplateMessageRole, cancellationToken?: AbortSignal, allCandidates?: ModelVendorCandidate[], promptRun?: MJAIPromptRunEntityExtended, vendorDriverClass?: string, vendorApiName?: string, vendorSupportsEffortLevel?: boolean, modelEffortLevel?: number, credentialAvailability?: Map<string, boolean>): Promise<ChatResult>;
     /**
      * Builds failover candidates for a prompt based on available models and type restrictions
      */
@@ -536,9 +490,13 @@ export declare class AIPromptRunner {
      */
     private createFailoverErrorResult;
     /**
-     * Executes the AI model with the rendered prompt
+     * Executes the AI model with the rendered prompt.
+     *
+     * `protected` so the parallel coordinator subclass reuses this exact code path — credential
+     * resolution, driver selection, ChatParams construction, prefill, media handling, and streaming
+     * all live here ONCE. Do not duplicate this logic elsewhere.
      */
-    private executeModel;
+    protected executeModel(model: MJAIModelEntityExtended, renderedPrompt: string, prompt: MJAIPromptEntityExtended, params: AIPromptParams, vendorId: string | null, conversationMessages?: ChatMessage[], templateMessageRole?: TemplateMessageRole, cancellationToken?: AbortSignal, vendorDriverClass?: string, vendorApiName?: string, vendorSupportsEffortLevel?: boolean, modelEffortLevel?: number): Promise<ChatResult>;
     /**
      * Walks every message in chatParams and rewrites media content blocks
      * (image_url / audio_url / video_url / file_url) into visible text markers

package/dist/AIPromptRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AIPromptRunner.d.ts","sourceRoot":"","sources":["../src/AIPromptRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,UAAU,EAAmB,WAAW,EAAqE,MAAM,oBAAoB,CAAC;AACtK,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAqB,iBAAiB,EAAwB,MAAM,8BAA8B,CAAC;AAC1G,OAAO,EAAmF,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG1I,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAU9H,OAAO,EACH,mBAAmB,EAEnB,cAAc,EACjB,MAAM,8BAA8B,CAAC;AAoBtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH;;GAEG;AACH,UAAU,oBAAoB;IAC5B,KAAK,EAAE,uBAAuB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,cAAc,GAAG,YAAY,GAAG,YAAY,GAAG,sBAAsB,CAAC;CAC5F;AAGD;;GAEG;AACH,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,0BAA0B,GAAG,eAAe,GAAG,WAAW,GAAG,MAAM,CAAC;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,iBAAiB,GAAG,sBAAsB,GAAG,kBAAkB,CAAC;IAChF,UAAU,CAAC,EAAE,KAAK,GAAG,aAAa,GAAG,eAAe,GAAG,kBAAkB,CAAC;CAC3E;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;CACjB;AAqBD,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,oBAAoB,CAA+B;IAC3D,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,SAAS,CAAkC;IAEnD;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB,CAA4D;IACxF,2GAA2G;IAC3G,OAAO,CAAC,sBAAsB,CAA0B;IAExD;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAA2D;IAEtG;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAgI;IAE5K;;;;OAIG;IACH,IAAW,QAAQ,IAAI,iBAAiB,CAEvC;IACD,IAAW,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,EAElD;;IAWD;;;OAGG;IACH,IAAW,WAAW,IAAI,aAAa,CAEtC;IAED;;;OAGG;IACH,OAAO,CAAC,aAAa;IAUrB;;;;;OAKG;IACH,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI;IAYjG;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE;QAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/B,MAAM,CAAC,EAAE,wBAAwB,CAAC;QAClC,KAAK,CAAC,EAAE,uBAAuB,CAAC;QAChC,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;QAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI;IAmCR;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;;;;;;;;;;;;;;;;;;;OAoBG;YACW,6BAA6B;IAqE3C;;;OAGG;YACW,iCAAiC;IAiC/C;;OAEG;YACW,oBAAoB;IA4DlC;;;OAGG;YACW,qBAAqB;IA0BnC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAUnC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,uBAAuB;IAuD/B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACU,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IA6M9F;;;;;;;;OAQG;YACW,mBAAmB;IA4IjC;;;;;;;;OAQG;YACW,uBAAuB;IA8QrC;;OAEG;YACW,YAAY;IAkB1B;;;;;;;;OAQG;IACH,OAAO,CAAC,4BAA4B;IAoBpC;;;;;;;OAOG;YACW,0BAA0B;IA8LxC;;;;;;;OAOG;YACW,8BAA8B;IAmE5C;;;;OAIG;YACW,WAAW;IA0LzB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,0BAA0B;IAsBlC;;;OAGG;IACH,OAAO,CAAC,+BAA+B;IAoBvC;;;;;OAKG;IACH,OAAO,CAAC,kCAAkC;IAkD1C;;;;;;;;OAQG;IACH,OAAO,CAAC,oCAAoC;IA6C5C;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;;OAGG;IACH,OAAO,CAAC,kCAAkC;IAiC1C;;;OAGG;IACH,OAAO,CAAC,iCAAiC;IAoBzC;;;;OAIG;IACH,OAAO,CAAC,mCAAmC;IA2B3C;;;OAGG;IACH,OAAO,CAAC,+BAA+B;IA4BvC;;OAEG;IACH,OAAO,CAAC,gCAAgC;IA6BxC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IA2CrC;;;;OAIG;IACH,OAAO,CAAC,+BAA+B;IAiCvC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAoBnC;;;OAGG;IACH,OAAO,CAAC,kCAAkC;IAiE1C;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAgBlC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwEhC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;;;;OAMG;IACH,OAAO,CAAC,gCAAgC;IAyBxC;;;;;;;;;OASG;YACW,4BAA4B;IA0H1C;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAwBhC;;OAEG;IACH;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IAoBpC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;;;OAIG;IACU,4BAA4B,IAAI,OAAO,CAAC,IAAI,CAAC;YAI5C,eAAe;IAmN7B;;OAEG;YACW,oBAAoB;IAsDlC;;;;;;;;;;;;;;OAcG;cACa,wBAAwB,CACtC,KAAK,EAAE,uBAAuB,EAC9B,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,wBAAwB,EAChC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,oBAAoB,CAAC,EAAE,WAAW,EAAE,EACpC,mBAAmB,GAAE,mBAA8B,EACnD,iBAAiB,CAAC,EAAE,WAAW,EAC/B,aAAa,CAAC,EAAE,oBAAoB,EAAE,EACtC,SAAS,CAAC,EAAE,2BAA2B,EACvC,iBAAiB,CAAC,EAAE,MAAM,EAC1B,aAAa,CAAC,EAAE,MAAM,EACtB,yBAAyB,CAAC,EAAE,OAAO,EACnC,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,UAAU,CAAC;IA+ItB;;OAEG;cACa,uBAAuB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA2B1G;;OAEG;IACH,SAAS,CAAC,0BAA0B,CAAC,MAAM,EAAE,uBAAuB,EAAE,GAAG,oBAAoB,EAAE;IAuC/F;;OAEG;IACH,SAAS,CAAC,kCAAkC,CAC1C,SAAS,EAAE,2BAA2B,EACtC,gBAAgB,EAAE,eAAe,EAAE,EACnC,YAAY,EAAE,uBAAuB,EACrC,eAAe,EAAE,MAAM,GAAG,IAAI,GAC7B,IAAI;IAoBP;;OAEG;IACH,OAAO,CAAC,kCAAkC;IAe1C;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAiCjC;;OAEG;YACW,YAAY;IAsM1B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,2BAA2B;IA0DnC;;;;;;OAMG;IACH,OAAO,CAAC,mCAAmC;IA0C3C;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAc9B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IA+C9B,OAAO,CAAC,iBAAiB;IAqCzB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAoJ;IAEpM;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAsB;IAEtE;;;;;;;;;;;;;;;OAeG;IACH;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,wBAAwB;IAchC,OAAO,CAAC,sBAAsB;IA0B9B;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IA0BlC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA4C7B;;OAEG;YACW,4BAA4B;IA4L1C;;OAEG;IACH;;;OAGG;IACH,OAAO,CAAC,mBAAmB;YA8Bb,eAAe;IAO7B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IA6C9B;;;OAGG;YACW,oBAAoB;IAmDlC;;;;;OAKG;YACW,oBAAoB;IAsFlC;;;OAGG;YACW,yBAAyB;IAoDvC;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAuBxC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA2CjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAoBjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA+B9B;;;;;;;;;OASG;YACW,8BAA8B;IAmI5C;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAcvB;;;;;;;;;;;OAWG;YACW,iBAAiB;IAsC/B;;;;;;;;OAQG;YACW,iBAAiB;IA8G/B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;OAEG;YACW,qBAAqB;IAkGnC;;OAEG;YACW,eAAe;IA6O7B;;;;;;;OAOG;IAIH;;;;;;;;;;OAUG;IACH,SAAS,CAAC,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,qBAAqB;IAU3F;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,qBAAqB,CAC7B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,qBAAqB,EAC7B,aAAa,EAAE,MAAM,GACpB,OAAO;IA6BV;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAczB;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,sBAAsB,CAC9B,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,GACvB,MAAM;IAaT;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,CAAC,wBAAwB,CAChC,YAAY,EAAE,uBAAuB,EACrC,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,EAC3C,aAAa,EAAE,qBAAqB,CAAC,eAAe,CAAC,EACrD,aAAa,EAAE,oBAAoB,EAAE,EACrC,cAAc,EAAE,eAAe,EAAE,GAChC,oBAAoB,EAAE;IAgIzB;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,kBAAkB,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,OAAO,GACjB,IAAI;CA6BR"}
+{"version":3,"file":"AIPromptRunner.d.ts","sourceRoot":"","sources":["../src/AIPromptRunner.ts"],"names":[],"mappings":"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"}

package/dist/AIPromptRunner.js

@@ -6,7 +6,6 @@ import { CleanJSON, MJGlobal, JSONValidator, ValidationResult, ValidationErrorIn
 import { CredentialEngine } from '@memberjunction/credentials';
 import { TemplateEngineServer } from '@memberjunction/templates';
 import { ExecutionPlanner } from './ExecutionPlanner.js';
-import { ParallelExecutionCoordinator } from './ParallelExecutionCoordinator.js';
 import { AIEngine } from '@memberjunction/aiengine';
 import { AIEngineBase } from '@memberjunction/ai-engine-base';
 import { SystemPlaceholderManager } from '@memberjunction/ai-core-plus';
@@ -67,10 +66,36 @@ export class AIPromptRunner {
         this._metadata = this._provider ?? new Metadata();
         this._templateEngine = TemplateEngineServer.Instance;
         this._executionPlanner = new ExecutionPlanner();
-        this._parallelCoordinator = new ParallelExecutionCoordinator();
         this._jsonValidator = new JSONValidator();
         this._modelRunner = new AIModelRunner();
     }
+    /** ClassFactory key the parallel coordinator self-registers under (see {@link ParallelCoordinator}). */
+    static { this.PARALLEL_COORDINATOR_KEY = 'ParallelExecutionCoordinator'; }
+    /**
+     * Lazily resolves the parallel execution coordinator.
+     *
+     * The coordinator is a SUBCLASS of AIPromptRunner — it inherits {@link executeModel} and the rest
+     * of the battle-tested execution path so there is a single source of truth for credential / driver
+     * / ChatParams / streaming resolution. That subclass relationship means the base cannot statically
+     * `new` it without a hard circular import, so we resolve it through the ClassFactory instead (the
+     * coordinator self-registers via `@RegisterClass(AIPromptRunner, PARALLEL_COORDINATOR_KEY)`).
+     * Created once per runner and reused; the runner's Provider override is propagated. Throws a clear
+     * error if the coordinator class was never loaded/registered — otherwise ClassFactory would silently
+     * fall back to a plain AIPromptRunner that lacks the parallel methods.
+     */
+    get ParallelCoordinator() {
+        if (!this._parallelCoordinator) {
+            const instance = MJGlobal.Instance.ClassFactory.CreateInstance(AIPromptRunner, AIPromptRunner.PARALLEL_COORDINATOR_KEY);
+            if (!instance || typeof instance.executeTasksInParallel !== 'function') {
+                throw new Error(`ParallelExecutionCoordinator is not registered with the ClassFactory. Ensure ` +
+                    `'@memberjunction/ai-prompts' is fully loaded (it is exported from the package index and ` +
+                    `picked up by the class-registration manifest).`);
+            }
+            instance.Provider = this.Provider;
+            this._parallelCoordinator = instance;
+        }
+        return this._parallelCoordinator;
+    }
     /**
      * Access the underlying AIModelRunner for embedding and other non-LLM model calls.
      * Use this when you need tracked embedding execution with AIPromptRun record creation.
@@ -457,25 +482,20 @@ export class AIPromptRunner {
             let renderedPromptText = '';
             // For hierarchical prompts, we need to create the parent prompt run first to get its ID
             let parentPromptRun;
-            let selectedModel;
             let childTemplateRenderingResult;
-            let modelSelectionInfo;
+            let selection;
             // Handle different prompt execution modes
             if (params.childPrompts && params.childPrompts.length > 0) {
                 // Hierarchical template composition mode - render child templates first, then compose
-                //this.logStatus(`🌳 Composing prompt with ${params.childPrompts.length} child templates in hierarchical mode`, true, params);
                 // Determine which prompt to use for model selection
                 let modelSelectionPrompt = prompt;
                 if (params.modelSelectionPrompt) {
                     modelSelectionPrompt = params.modelSelectionPrompt;
-                    //this.logStatus(`🎯 Using prompt "${modelSelectionPrompt.Name}" for model selection instead of parent prompt`, true, params);
                 }
-                // Select model using the appropriate prompt
-                const modelResult = await this.selectModel(modelSelectionPrompt, params.override?.modelId, params.contextUser, params.configurationId, params.override?.vendorId, params);
-                selectedModel = modelResult.model;
-                modelSelectionInfo = modelResult.selectionInfo;
-                if (!selectedModel) {
-                    throw new Error(this.buildNoModelFoundMessage(modelSelectionPrompt.Name, modelSelectionInfo));
+                // Select model using the appropriate prompt — capture the FULL result
+                selection = await this.selectModel(modelSelectionPrompt, params.override?.modelId, params.contextUser, params.configurationId, params.override?.vendorId, params);
+                if (!selection.model) {
+                    throw new Error(this.buildNoModelFoundMessage(modelSelectionPrompt.Name, selection.selectionInfo));
                 }
                 // Check if we have a system prompt override
                 if (params.systemPromptOverride) {
@@ -490,7 +510,7 @@ export class AIPromptRunner {
                     renderedPromptText = await this.renderPromptWithChildTemplates(prompt, params, childTemplateRenderingResult.renderedTemplates);
                 }
                 // Create parent prompt run for the final composed prompt execution
-                parentPromptRun = await this.createPromptRun(prompt, selectedModel, params, renderedPromptText, startTime, params.override?.vendorId, modelSelectionInfo);
+                parentPromptRun = await this.createPromptRun(prompt, selection.model, params, renderedPromptText, startTime, params.override?.vendorId, selection.selectionInfo);
             }
             else if (prompt.TemplateID && (!params.conversationMessages || params.templateMessageRole !== 'none')) {
                 // Check if we have a system prompt override
@@ -520,30 +540,28 @@ export class AIPromptRunner {
             if (params.cancellationToken?.aborted) {
                 throw new Error('Prompt execution was cancelled during template rendering');
             }
-            // If no model was selected yet (no template case), select one now
-            if (!selectedModel) {
+            // If no model was selected yet (non-hierarchical case), select one now — capture the FULL result
+            if (!selection?.model) {
                 let modelSelectionPrompt = prompt;
                 if (params.modelSelectionPrompt) {
                     modelSelectionPrompt = params.modelSelectionPrompt;
                     this.logStatus(`🎯 Using prompt "${modelSelectionPrompt.Name}" for model selection instead of main prompt`, true, params);
                 }
-                const modelResult = await this.selectModel(modelSelectionPrompt, params.override?.modelId, params.contextUser, params.configurationId, params.override?.vendorId, params);
-                selectedModel = modelResult.model;
-                modelSelectionInfo = modelResult.selectionInfo;
-                if (!selectedModel) {
-                    throw new Error(this.buildNoModelFoundMessage(modelSelectionPrompt.Name, modelSelectionInfo));
+                selection = await this.selectModel(modelSelectionPrompt, params.override?.modelId, params.contextUser, params.configurationId, params.override?.vendorId, params);
+                if (!selection.model) {
+                    throw new Error(this.buildNoModelFoundMessage(modelSelectionPrompt.Name, selection.selectionInfo));
                 }
             }
             // Check if we need parallel execution based on ParallelizationMode
             const shouldUseParallelExecution = prompt.ParallelizationMode && prompt.ParallelizationMode !== 'None';
             let result;
             if (shouldUseParallelExecution) {
-                // Use parallel execution path
-                result = await this.executePromptInParallel(prompt, renderedPromptText, params, startTime, parentPromptRun, selectedModel, modelSelectionInfo);
+                // Use parallel execution path — pass full selection through
+                result = await this.executePromptInParallel(prompt, renderedPromptText, params, startTime, parentPromptRun, selection);
             }
             else {
-                // Use traditional single execution path
-                result = await this.executeSinglePrompt(prompt, renderedPromptText, params, startTime, parentPromptRun, selectedModel, modelSelectionInfo);
+                // Use traditional single execution path — pass full selection through
+                result = await this.executeSinglePrompt(prompt, renderedPromptText, params, startTime, parentPromptRun, selection);
             }
             // Note: With template composition, we only execute once so no rollup calculations needed
             // The final composed prompt is executed as a single operation
@@ -613,33 +631,22 @@ export class AIPromptRunner {
      * @param startTime - Execution start time
      * @returns Promise<AIPromptRunResult<T>> - The execution result
      */
-    async executeSinglePrompt(prompt, renderedPromptText, params, startTime, existingPromptRun, existingModel, existingModelSelectionInfo) {
+    async executeSinglePrompt(prompt, renderedPromptText, params, startTime, existingPromptRun, existingSelection) {
         // Check for cancellation before model selection
         if (params.cancellationToken?.aborted) {
             throw new Error('Prompt execution was cancelled before model selection');
         }
-        // Use existing model if provided (hierarchical case) or select one
-        let selectedModel = existingModel;
-        let modelSelectionInfo = existingModelSelectionInfo;
-        let vendorDriverClass;
-        let vendorApiName;
-        let vendorSupportsEffortLevel;
-        let modelEffortLevel;
-        let allCandidates = [];
-        if (modelSelectionInfo) {
-            // we received model selection info, need to lookup vendor driver class and api name from there
-            const vendorID = modelSelectionInfo.vendorSelected?.ID;
-            const modelID = modelSelectionInfo.modelSelected.ID;
-            const modelVendor = AIEngine.Instance.ModelVendorsByModelID.get(NormalizeUUID(modelID))
-                ?.find(mv => UUIDsEqual(mv.VendorID, vendorID));
-            if (modelVendor) {
-                vendorDriverClass = modelVendor.DriverClass;
-                vendorApiName = modelVendor.APIName;
-                vendorSupportsEffortLevel = modelVendor.SupportsEffortLevel;
-            }
-            // Extract valid candidates from selection info for retry logic
-            allCandidates = this.buildCandidatesFromSelectionInfo(modelSelectionInfo);
-        }
+        // Use existing selection if provided (hierarchical case) or select now
+        let selectedModel = existingSelection?.model ?? undefined;
+        let modelSelectionInfo = existingSelection?.selectionInfo;
+        let vendorDriverClass = existingSelection?.vendorDriverClass;
+        let vendorApiName = existingSelection?.vendorApiName;
+        let vendorSupportsEffortLevel = existingSelection?.vendorSupportsEffortLevel;
+        let modelEffortLevel = existingSelection?.modelEffortLevel;
+        let allCandidates = existingSelection?.allCandidates ?? [];
+        // Credential probes already done during selection — reused by failover so it doesn't
+        // recompute hasCredentialsAvailable for the prefix it walks before the selected candidate.
+        let credentialAvailability = existingSelection?.credentialAvailability;
         if (!selectedModel) {
             // Determine which prompt to use for model selection
             let modelSelectionPrompt = prompt;
@@ -655,6 +662,7 @@ export class AIPromptRunner {
             modelEffortLevel = modelResult.modelEffortLevel;
             modelSelectionInfo = modelResult.selectionInfo;
             allCandidates = modelResult.allCandidates || [];
+            credentialAvailability = modelResult.credentialAvailability;
             if (!selectedModel) {
                 throw new Error(this.buildNoModelFoundMessage(modelSelectionPrompt.Name, modelSelectionInfo));
             }
@@ -670,7 +678,8 @@ export class AIPromptRunner {
             throw new Error('Prompt execution was cancelled before model execution');
         }
         // Execute with retry logic for validation failures
-        const { modelResult, parsedResult, validationAttempts, cumulativeTokens } = await this.executeWithValidationRetries(selectedModel, renderedPromptText, prompt, params, promptRun, allCandidates, vendorDriverClass, vendorApiName, vendorSupportsEffortLevel, modelEffortLevel // Pass model-specific effort level
+        const { modelResult, parsedResult, validationAttempts, cumulativeTokens } = await this.executeWithValidationRetries(selectedModel, renderedPromptText, prompt, params, promptRun, allCandidates, vendorDriverClass, vendorApiName, vendorSupportsEffortLevel, modelEffortLevel, // Pass model-specific effort level
+        credentialAvailability // Reuse credential probes from selection
         );
         // Calculate execution metrics
         const endTime = new Date();
@@ -730,7 +739,7 @@ export class AIPromptRunner {
      * @param startTime - Execution start time
      * @returns Promise<AIPromptRunResult<T>> - The aggregated execution result
      */
-    async executePromptInParallel(prompt, renderedPromptText, params, startTime, existingPromptRun, existingModel, existingModelSelectionInfo) {
+    async executePromptInParallel(prompt, renderedPromptText, params, startTime, existingPromptRun, existingSelection) {
         // Check for cancellation before starting parallel execution
         if (params.cancellationToken?.aborted) {
             throw new Error('Parallel execution was cancelled before starting');
@@ -738,21 +747,21 @@ export class AIPromptRunner {
         // Load AI Engine to get models and prompt models
         await AIEngine.Instance.Config(false, params.contextUser);
         let executionTasks;
-        // If a model is already selected (from hierarchical template composition), 
+        // If a model is already selected (from hierarchical template composition),
         // create a single task with that model instead of using the planner
-        if (existingModel) {
+        if (existingSelection?.model) {
             // Create a single execution task with the pre-selected model
             executionTasks = [{
                     taskId: 'pre-selected',
-                    model: existingModel,
-                    vendorDriverClass: undefined, // Would need to look up vendor entity for this
-                    vendorApiName: existingModel.Vendor, // Vendor is already the name string
+                    model: existingSelection.model,
+                    vendorDriverClass: existingSelection.vendorDriverClass,
+                    vendorApiName: existingSelection.vendorApiName,
                     messages: params.conversationMessages || [],
                     promptText: renderedPromptText,
                     templateMessageRole: params.templateMessageRole || 'system',
                     contextUser: params.contextUser
                 }];
-            this.logStatus(`   Using pre-selected model "${existingModel.Name}" for parallel execution`, true, params);
+            this.logStatus(`   Using pre-selected model "${existingSelection.model.Name}" for parallel execution`, true, params);
         }
         else {
             // Normal parallel execution path - let the planner decide
@@ -777,7 +786,7 @@ export class AIPromptRunner {
             throw new Error('Parallel execution was cancelled before task execution');
         }
         // Execute tasks in parallel
-        const parallelResult = await this._parallelCoordinator.executeTasksInParallel(params, executionTasks, undefined, undefined, params.cancellationToken, undefined, params.agentRunId);
+        const parallelResult = await this.ParallelCoordinator.executeTasksInParallel(params, executionTasks, undefined, undefined, params.cancellationToken, undefined, params.agentRunId);
         if (!parallelResult.success) {
             throw new Error(`Parallel execution failed: ${parallelResult.errors.join(', ')}`);
         }
@@ -793,7 +802,7 @@ export class AIPromptRunner {
                 method: 'PromptSelector',
                 selectorPromptId: prompt.ResultSelectorPromptID,
             };
-            const aiSelectedResult = await this._parallelCoordinator.selectBestResult(successfulResults, selectionConfig, undefined, params.cancellationToken);
+            const aiSelectedResult = await this.ParallelCoordinator.selectBestResult(successfulResults, selectionConfig, undefined, params.cancellationToken);
             if (aiSelectedResult) {
                 selectedResult = aiSelectedResult;
             }
@@ -822,7 +831,7 @@ export class AIPromptRunner {
         }
         // Use existing prompt run if provided (hierarchical case) or create new one
         // Use the model selection info if provided (from hierarchical execution)
-        const consolidatedPromptRun = existingPromptRun || await this.createPromptRun(prompt, selectedResult.task.model, params, renderedPromptText, startTime, params.override?.vendorId, existingModelSelectionInfo);
+        const consolidatedPromptRun = existingPromptRun || await this.createPromptRun(prompt, selectedResult.task.model, params, renderedPromptText, startTime, params.override?.vendorId, existingSelection?.selectionInfo);
         // Update with parallel execution metadata
         const endTime = new Date();
         consolidatedPromptRun.CompletedAt = endTime;
@@ -944,11 +953,11 @@ export class AIPromptRunner {
             modelInfo: {
                 modelId: selectedResult.task.model.ID,
                 modelName: selectedResult.task.model.Name,
-                vendorId: existingModelSelectionInfo?.vendorSelected?.ID, // VendorID not directly available on AIModel
+                vendorId: existingSelection?.selectionInfo?.vendorSelected?.ID, // VendorID not directly available on AIModel
                 vendorName: selectedResult.task.model.Vendor,
             },
             judgeMetadata: selectedResult.judgeMetadata,
-            modelSelectionInfo: existingModelSelectionInfo, // Include model selection info if provided
+            modelSelectionInfo: existingSelection?.selectionInfo, // Include model selection info if provided
         };
     }
     /**
@@ -1275,7 +1284,7 @@ export class AIPromptRunner {
             //   });
             // }
             // Select the first candidate with available credentials and track all attempts
-            const { selected, consideredModels } = await this.selectModelWithAPIKeyTracked(candidates, prompt.ID, params);
+            const { selected, consideredModels, credentialAvailability } = await this.selectModelWithAPIKeyTracked(candidates, prompt.ID, params);
             // Merge considered models into our tracking
             modelsConsidered.push(...consideredModels);
             if (!selected) {
@@ -1287,6 +1296,7 @@ export class AIPromptRunner {
                     vendorSupportsEffortLevel: undefined,
                     modelEffortLevel: undefined,
                     allCandidates: candidates,
+                    credentialAvailability,
                     selectionInfo: this.createSelectionInfo({
                         aiConfiguration: configuration,
                         modelsConsidered,
@@ -1331,6 +1341,7 @@ export class AIPromptRunner {
                 vendorSupportsEffortLevel: selected.supportsEffortLevel,
                 modelEffortLevel: selected.effortLevel, // Pass through model-specific effort level
                 allCandidates: candidates,
+                credentialAvailability,
                 selectionInfo: this.createSelectionInfo({
                     aiConfiguration: configuration,
                     modelsConsidered,
@@ -1879,33 +1890,6 @@ export class AIPromptRunner {
         Object.assign(info, data);
         return info;
     }
-    /**
-     * Converts model selection info into ModelVendorCandidate array for retry logic.
-     * Extracts only the valid candidates (those with available API keys) from the selection info.
-     *
-     * @param selectionInfo - Model selection information containing considered models
-     * @returns Array of valid model-vendor candidates sorted by priority
-     */
-    buildCandidatesFromSelectionInfo(selectionInfo) {
-        const validModels = selectionInfo.extractValidCandidates();
-        return validModels.map(considered => {
-            // Find matching model vendor for driver and API info
-            const modelVendor = considered.vendor
-                ? considered.model.ModelVendors.find(mv => UUIDsEqual(mv.VendorID, considered.vendor.ID))
-                : undefined;
-            return {
-                model: considered.model,
-                vendorId: considered.vendor?.ID,
-                vendorName: considered.vendor?.Name,
-                driverClass: modelVendor?.DriverClass || considered.model.DriverClass,
-                apiName: modelVendor?.APIName || considered.model.APIName,
-                supportsEffortLevel: modelVendor?.SupportsEffortLevel ?? considered.model.SupportsEffortLevel ?? false,
-                isPreferredVendor: false, // Can't determine from selection info alone
-                priority: considered.priority,
-                source: (selectionInfo.selectionStrategy === 'ByPower' ? 'power-rank' : 'model-type')
-            };
-        }).sort((a, b) => b.priority - a.priority); // Sort by priority descending
-    }
     /**
      * Enhanced version of selectModelWithAPIKey that tracks all considered models
      * for model selection reporting. Uses the hierarchical credential resolution
@@ -1997,7 +1981,7 @@ export class AIPromptRunner {
                 maxErrorLength: params?.maxErrorLength
             });
         }
-        return { selected: selectedCandidate, consideredModels };
+        return { selected: selectedCandidate, consideredModels, credentialAvailability: credentialCache };
     }
     /**
      * Builds a descriptive error message when no model could be selected for a prompt.
@@ -2110,7 +2094,7 @@ export class AIPromptRunner {
             promptRun.Status = 'Running';
             promptRun.Cancelled = false;
             promptRun.CacheHit = false;
-            promptRun.StreamingEnabled = false;
+            promptRun.StreamingEnabled = !!params.onStreaming;
             promptRun.WasSelectedResult = false;
             // Set model selection tracking fields
             if (modelSelectionInfo) {
@@ -2353,7 +2337,7 @@ export class AIPromptRunner {
      * - updatePromptRunWithFailoverFailure: Records failed failover metadata
      * - createFailoverErrorResult: Creates standardized error response
      */
-    async executeModelWithFailover(model, renderedPrompt, prompt, params, vendorId, conversationMessages, templateMessageRole = 'system', cancellationToken, allCandidates, promptRun, vendorDriverClass, vendorApiName, vendorSupportsEffortLevel, modelEffortLevel) {
+    async executeModelWithFailover(model, renderedPrompt, prompt, params, vendorId, conversationMessages, templateMessageRole = 'system', cancellationToken, allCandidates, promptRun, vendorDriverClass, vendorApiName, vendorSupportsEffortLevel, modelEffortLevel, credentialAvailability) {
         // Get failover configuration (used for errorScope filtering)
         const failoverConfig = this.getFailoverConfiguration(prompt);
         // If no candidates provided or failover disabled, execute normally with first model
@@ -2363,10 +2347,45 @@ export class AIPromptRunner {
         // Track failover attempts
         const failoverAttempts = [];
         let lastError = null;
+        // Cache credential availability per driver:model:vendor for the duration of this failover
+        // scan so we don't repeat env-var / binding lookups while walking the candidate list.
+        //
+        // PERF: seed it with the probes model SELECTION already performed (same key format). Selection
+        // walks the priority list until it finds the first credentialed candidate, so this map holds
+        // the prefix it rejected (known false) PLUS the selected candidate (known true) — which is
+        // exactly the segment failover re-walks on the happy path. Reusing those results means the
+        // common case (and any caller looping failover) does ZERO redundant hasCredentialsAvailable
+        // calls. The not-evaluated tail is intentionally absent, so failover still lazily probes it
+        // only if a real failure forces it to walk down there.
+        const failoverCredentialCache = credentialAvailability
+            ? new Map(credentialAvailability)
+            : new Map();
+        const candidateHasCredentials = (c) => {
+            const key = `${c.driverClass}:${c.model.ID}:${c.vendorId || 'default'}`;
+            let has = failoverCredentialCache.get(key);
+            if (has === undefined) {
+                has = this.hasCredentialsAvailable(c.driverClass, prompt.ID, c.model.ID, c.vendorId, params);
+                failoverCredentialCache.set(key, has);
+            }
+            return has;
+        };
+        let skippedForCredentials = 0;
         // Iterate through all candidates in priority order with instant failover
         for (let i = 0; i < allCandidates.length; i++) {
             const candidate = allCandidates[i];
             const attemptStartTime = Date.now();
+            // Skip candidates with no credentials configured. `allCandidates` is intentionally the
+            // FULL priority-ordered list (see the DECISION note in selectModelWithAPIKeyTracked),
+            // so it can include vendors that have no API key in this environment. Firing a live
+            // request at one of those produces a misleading "401 invalid API key" — and because an
+            // Authentication error is treated as fatal, it would halt failover before any
+            // credentialed candidate is ever reached. Skipping here makes failover land on the
+            // first candidate that can actually authenticate (mirroring model selection's own
+            // highest-priority-with-credentials rule).
+            if (!candidateHasCredentials(candidate)) {
+                skippedForCredentials++;
+                continue;
+            }
             try {
                 // Log the attempt if not the first one
                 if (i > 0) {
@@ -2435,6 +2454,11 @@ export class AIPromptRunner {
         if (promptRun && failoverAttempts.length > 0) {
             this.updatePromptRunWithFailoverFailure(promptRun, failoverAttempts);
         }
+        // If every candidate was skipped for missing credentials we never attempted a call and
+        // have no underlying error to report — surface an actionable message instead of null.
+        if (!lastError && failoverAttempts.length === 0 && skippedForCredentials > 0) {
+            lastError = new Error(`No API credentials configured for any of the ${skippedForCredentials} candidate model-vendor combination(s) for prompt "${prompt.Name}".`);
+        }
         return this.createFailoverErrorResult(lastError, failoverAttempts);
     }
     /**
@@ -2570,7 +2594,11 @@ export class AIPromptRunner {
         };
     }
     /**
-     * Executes the AI model with the rendered prompt
+     * Executes the AI model with the rendered prompt.
+     *
+     * `protected` so the parallel coordinator subclass reuses this exact code path — credential
+     * resolution, driver selection, ChatParams construction, prefill, media handling, and streaming
+     * all live here ONCE. Do not duplicate this logic elsewhere.
      */
     async executeModel(model, renderedPrompt, prompt, params, vendorId, conversationMessages, templateMessageRole = 'system', cancellationToken, vendorDriverClass, vendorApiName, vendorSupportsEffortLevel, modelEffortLevel) {
         // define these variables here to ensure they're available in the catch block
@@ -2712,6 +2740,17 @@ export class AIPromptRunner {
             this.stripUnsupportedMediaBlocks(llm, chatParams, model, verbose, params);
             // Apply assistant prefill (native or fallback) based on prompt config and provider support
             this.applyAssistantPrefill(chatParams, prompt, model, vendorId, llm);
+            // Streaming: wire the prompt-level onStreaming callback into the LLM call. This is the SINGLE
+            // place streaming is configured for prompt execution, so the single-model path and the parallel
+            // path (which bridges its per-task callbacks into params.onStreaming) stream through identical
+            // code — no second streaming implementation that can drift.
+            if (params.onStreaming) {
+                const onStreaming = params.onStreaming;
+                chatParams.streaming = true;
+                chatParams.streamingCallbacks = {
+                    OnContent: (chunk, isComplete) => onStreaming({ content: chunk, isComplete, modelName: model.Name }),
+                };
+            }
             // Execute the model with cancellation support
             if (cancellationToken) {
                 // If cancellation token is provided, wrap the execution to handle cancellation
@@ -3091,7 +3130,7 @@ export class AIPromptRunner {
     /**
      * Executes the model with retry logic for validation failures
      */
-    async executeWithValidationRetries(selectedModel, renderedPromptText, prompt, params, promptRun, allCandidates, vendorDriverClass, vendorApiName, vendorSupportsEffortLevel, modelEffortLevel) {
+    async executeWithValidationRetries(selectedModel, renderedPromptText, prompt, params, promptRun, allCandidates, vendorDriverClass, vendorApiName, vendorSupportsEffortLevel, modelEffortLevel, credentialAvailability) {
         const validationAttempts = [];
         const maxRetries = Math.max(0, prompt.MaxRetries || 0);
         let lastError = null;
@@ -3111,7 +3150,8 @@ export class AIPromptRunner {
                 }
                 // Execute the AI model with failover support
                 const modelResult = await this.executeModelWithFailover(selectedModel, renderedPromptText, prompt, params, promptRun.VendorID, params.conversationMessages, params.templateMessageRole || 'system', params.cancellationToken, allCandidates, // Pass the candidates from initial selection
-                promptRun, vendorDriverClass, vendorApiName, vendorSupportsEffortLevel, modelEffortLevel);
+                promptRun, vendorDriverClass, vendorApiName, vendorSupportsEffortLevel, modelEffortLevel, credentialAvailability // Reuse credential probes from selection
+                );
                 // Check for fatal errors - don't attempt validation/retry on these
                 // Fatal errors (like ContextLengthExceeded when all models exhausted) cannot be resolved by retrying
                 if (!modelResult.success && modelResult.errorInfo?.severity === 'Fatal') {
@@ -3983,6 +4023,12 @@ export class AIPromptRunner {
      */
     async updatePromptRun(promptRun, prompt, modelResult, parsedResult, endTime, executionTimeMS, validationAttempts, cumulativeTokens) {
         try {
+            // Ensure the initial 'Running' INSERT (and its BaseEntity.finalizeSave post-save reload, which does
+            // init() + SetMany(insertedRow)) has fully landed BEFORE we mutate the final state. Mutating while the
+            // INSERT is still in flight lets the reload revert these values, and the chained UPDATE then persists
+            // the stale 'Running' row (the same race fixed in the agent-run-step queue and action-execution-log).
+            // The model call between create and update almost always covers this; a fast-failing prompt could not.
+            await this._promptRunSaveChains.get(promptRun);
             promptRun.CompletedAt = endTime;
             promptRun.ExecutionTimeMS = executionTimeMS;
             // Determine what to save as the result