@memberjunction/ai 6.2.0-edge.0 → 6.2.0-edge.2

package/dist/generic/apiKeyDictionary.d.ts

@@ -36,4 +36,37 @@ export declare class AIAPIKeys {
  */
 export declare function GetAIAPIKey(AIDriverName: string, apiKeys?: AIAPIKey[], verbose?: boolean): string;
 export declare function GetAIAPIKeyGlobal(AIDriverName: string): string;
+/**
+ * Resolves the API key to use for ONE AI driver class.
+ *
+ * A shape for handing a *scoped* key-resolution capability to code that spends an AI key without
+ * handing over the key list itself. A holder can ask for the one driver class it needs; it cannot
+ * enumerate the run's credentials, and whoever built the resolver decides whether to answer.
+ * Realtime uses it. `@memberjunction/actions-base` declares the same signature separately as
+ * `RuntimeAPIKeyResolver` (it does not depend on this package), and the prompt runner still takes
+ * the key list (`AIPromptParams.apiKeys`).
+ *
+ * `undefined` means "no key for that driver class" — which is also how a deliberate refusal reads,
+ * so a caller treats both the same way: fall back to the platform key, or skip that vendor.
+ *
+ * Build one with {@link MakeAIAPIKeyResolver}.
+ */
+export type AIAPIKeyResolver = (driverClass: string) => string | undefined;
+/**
+ * Builds an {@link AIAPIKeyResolver} over a runtime key list: the list's key for the driver class
+ * first, then the platform (environment) key — the same precedence as `GetAIAPIKey`. For prompts
+ * that is only the legacy tier: `AIPromptRunner` tries MJ Credentials first (a per-request
+ * `credentialId`, then `AICredentialBinding`s, then the vendor's default credential) and reaches
+ * this order only when none of them resolves. This resolver never consults credentials.
+ *
+ * Pass the run's `apiKeys` and the resolver honours a customer's own credentials; pass nothing and
+ * it is exactly the platform lookup, so a caller never has to special-case "this run has no keys".
+ *
+ * A caller with its own platform-key seam should layer run keys over that seam rather than use this
+ * resolver, whose environment fallback would answer first and bypass the seam.
+ *
+ * @param apiKeys The runtime keys for a run, if any (`ExecuteAgentParams.apiKeys`).
+ * @param verbose Log which source answered — never the key itself.
+ */
+export declare function MakeAIAPIKeyResolver(apiKeys?: AIAPIKey[], verbose?: boolean): AIAPIKeyResolver;
 //# sourceMappingURL=apiKeyDictionary.d.ts.map

package/dist/generic/apiKeyDictionary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apiKeyDictionary.d.ts","sourceRoot":"","sources":["../../src/generic/apiKeyDictionary.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAyB;IAG9D,SAAS,CAAC,MAAM,CAAC,cAAc,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAM;IAChE,SAAS,CAAC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAKvD,SAAS,CAAC,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAKtD,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IA0B9C,SAAS,CAAC,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAK5E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAmBjG;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAM9D"}
+{"version":3,"file":"apiKeyDictionary.d.ts","sourceRoot":"","sources":["../../src/generic/apiKeyDictionary.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAyB;IAG9D,SAAS,CAAC,MAAM,CAAC,cAAc,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAM;IAChE,SAAS,CAAC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAKvD,SAAS,CAAC,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAKtD,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IA0B9C,SAAS,CAAC,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAK5E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAmBjG;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAM9D;AACD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAE3E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAE9F"}

package/dist/generic/apiKeyDictionary.js

@@ -82,4 +82,23 @@ export function GetAIAPIKeyGlobal(AIDriverName) {
     else
         throw new Error('Could not instantiate AIAPIKeys class');
 }
+/**
+ * Builds an {@link AIAPIKeyResolver} over a runtime key list: the list's key for the driver class
+ * first, then the platform (environment) key — the same precedence as `GetAIAPIKey`. For prompts
+ * that is only the legacy tier: `AIPromptRunner` tries MJ Credentials first (a per-request
+ * `credentialId`, then `AICredentialBinding`s, then the vendor's default credential) and reaches
+ * this order only when none of them resolves. This resolver never consults credentials.
+ *
+ * Pass the run's `apiKeys` and the resolver honours a customer's own credentials; pass nothing and
+ * it is exactly the platform lookup, so a caller never has to special-case "this run has no keys".
+ *
+ * A caller with its own platform-key seam should layer run keys over that seam rather than use this
+ * resolver, whose environment fallback would answer first and bypass the seam.
+ *
+ * @param apiKeys The runtime keys for a run, if any (`ExecuteAgentParams.apiKeys`).
+ * @param verbose Log which source answered — never the key itself.
+ */
+export function MakeAIAPIKeyResolver(apiKeys, verbose) {
+    return (driverClass) => GetAIAPIKey(driverClass, apiKeys, verbose) || undefined;
+}
 //# sourceMappingURL=apiKeyDictionary.js.map

package/dist/generic/apiKeyDictionary.js.map

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

package/dist/generic/baseAudio.d.ts

@@ -1,4 +1,7 @@
 import { BaseModel, BaseParams, ModelUsage } from "./baseModel.js";
+import type { AIErrorInfo } from "./errorTypes.js";
+import type { BaseSpeechToText } from "./baseSpeechToText.js";
+import type { BaseTextToSpeech } from "./baseTextToSpeech.js";
 /**
  * One piece of a transcription: the text, plus the audio duration the provider reported for it.
  *
@@ -11,11 +14,24 @@ export type TranscriptionPiece = {
     durationSeconds?: number;
 };
 /**
- * Base class for all audio generation models. Each AI model will have a sub-class implementing the abstract methods in this base class. Not all
- * sub-classes will support all methods. If a method is not supported an exception will be thrown, use the GetSupportedMethods method to determine
- * what methods are supported by a specific sub-class.
+ * Base class for audio models that carries both text-to-speech and speech-to-text. Not all
+ * sub-classes support all methods: an unsupported method throws, and `GetSupportedMethods` names
+ * the ones a sub-class implements.
+ *
+ * It spans two model types (`TTS` and `Speech to Text`), so it has been split. It stays, and keeps
+ * working, for drivers and callers that already use it: it implements both halves, so any of its
+ * drivers can be used where either new base class is expected. The drivers MemberJunction ships
+ * still extend it and are also registered against the new class or classes they implement, under
+ * the same keys.
+ *
+ * @deprecated Use {@link BaseTextToSpeech} for text-to-speech and {@link BaseSpeechToText} for
+ * speech-to-text. An application that overrides a shipped audio driver must also register the
+ * override against the new class or classes that driver implements, under the same key, for example
+ * `@RegisterClass(BaseTextToSpeech, 'OpenAIAudioGenerator')`. The ClassFactory keeps registrations
+ * per base class, and the text-to-speech and speech-to-text runners resolve drivers through the new
+ * classes, so an override registered only against `BaseAudioGenerator` is not used by them.
  */
-export declare abstract class BaseAudioGenerator extends BaseModel {
+export declare abstract class BaseAudioGenerator extends BaseModel implements BaseTextToSpeech, BaseSpeechToText {
     abstract CreateSpeech(params: TextToSpeechParams): Promise<SpeechResult>;
     abstract SpeechToText(params: SpeechToTextParams): Promise<SpeechResult>;
     abstract GetVoices(): Promise<VoiceInfo[]>;
@@ -23,16 +39,8 @@ export declare abstract class BaseAudioGenerator extends BaseModel {
     abstract GetPronounciationDictionaries(): Promise<PronounciationDictionary[]>;
     abstract GetSupportedMethods(): Promise<string[]>;
     /**
-     * Transcribes audio that may exceed the provider's upload ceiling, splitting it first when
-     * it does, and joins the pieces back into one transcript and one duration.
-     *
-     * Pieces are transcribed **sequentially**, not in parallel: transcription providers rate limit
-     * by audio-seconds per minute, so firing an hour of audio at once buys nothing but 429s, and a
-     * partial failure mid-way would leave a transcript with an unmarked hole in it.
-     *
-     * The returned `durationSeconds` is the sum across pieces — which is what the provider bills —
-     * and is left undefined if ANY piece failed to report one, since a partial sum would understate
-     * the bill while looking like a complete answer.
+     * Transcribes audio that may exceed the provider's upload ceiling, splitting it first when it
+     * does. See {@link TranscribeAudioWithSplitting}, which this calls, for the behavior.
      *
      * @param audio The full audio to transcribe
      * @param maxUploadBytes The provider's hard upload ceiling
@@ -70,6 +78,15 @@ export declare class SpeechResult {
      * cost calculation declines rather than billing the request as free.
      */
     usage?: ModelUsage;
+    /**
+     * How a failure is classified, when the request failed: `ErrorAnalyzer`'s reading of the error
+     * the provider's SDK threw, which keeps its HTTP status. A caller deciding whether to try another
+     * vendor reads this, as the failover loop reads `BaseResult.errorInfo`: a rate limit or an outage
+     * is worth another vendor, and a request the vendor rejected as invalid is not. The message alone
+     * cannot tell them apart. Undefined on success, and from a driver that reports only
+     * `errorMessage`.
+     */
+    errorInfo?: AIErrorInfo;
 }
 export declare class SpeechToTextParams extends BaseParams {
     /**

package/dist/generic/baseAudio.d.ts.map

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

package/dist/generic/baseAudio.js

@@ -1,21 +1,27 @@
 import { BaseModel, BaseParams } from "./baseModel.js";
+import { TranscribeAudioWithSplitting } from "./baseSpeechToText.js";
 /**
- * Base class for all audio generation models. Each AI model will have a sub-class implementing the abstract methods in this base class. Not all
- * sub-classes will support all methods. If a method is not supported an exception will be thrown, use the GetSupportedMethods method to determine
- * what methods are supported by a specific sub-class.
+ * Base class for audio models that carries both text-to-speech and speech-to-text. Not all
+ * sub-classes support all methods: an unsupported method throws, and `GetSupportedMethods` names
+ * the ones a sub-class implements.
+ *
+ * It spans two model types (`TTS` and `Speech to Text`), so it has been split. It stays, and keeps
+ * working, for drivers and callers that already use it: it implements both halves, so any of its
+ * drivers can be used where either new base class is expected. The drivers MemberJunction ships
+ * still extend it and are also registered against the new class or classes they implement, under
+ * the same keys.
+ *
+ * @deprecated Use {@link BaseTextToSpeech} for text-to-speech and {@link BaseSpeechToText} for
+ * speech-to-text. An application that overrides a shipped audio driver must also register the
+ * override against the new class or classes that driver implements, under the same key, for example
+ * `@RegisterClass(BaseTextToSpeech, 'OpenAIAudioGenerator')`. The ClassFactory keeps registrations
+ * per base class, and the text-to-speech and speech-to-text runners resolve drivers through the new
+ * classes, so an override registered only against `BaseAudioGenerator` is not used by them.
  */
 export class BaseAudioGenerator extends BaseModel {
     /**
-     * Transcribes audio that may exceed the provider's upload ceiling, splitting it first when
-     * it does, and joins the pieces back into one transcript and one duration.
-     *
-     * Pieces are transcribed **sequentially**, not in parallel: transcription providers rate limit
-     * by audio-seconds per minute, so firing an hour of audio at once buys nothing but 429s, and a
-     * partial failure mid-way would leave a transcript with an unmarked hole in it.
-     *
-     * The returned `durationSeconds` is the sum across pieces — which is what the provider bills —
-     * and is left undefined if ANY piece failed to report one, since a partial sum would understate
-     * the bill while looking like a complete answer.
+     * Transcribes audio that may exceed the provider's upload ceiling, splitting it first when it
+     * does. See {@link TranscribeAudioWithSplitting}, which this calls, for the behavior.
      *
      * @param audio The full audio to transcribe
      * @param maxUploadBytes The provider's hard upload ceiling
@@ -25,42 +31,7 @@ export class BaseAudioGenerator extends BaseModel {
      * @param transcribeOne Transcribes a single piece already known to be within the ceiling
      */
     async TranscribeWithSplitting(audio, maxUploadBytes, splitTargetBytes, splitter, providerLabel, transcribeOne) {
-        const limitMB = (maxUploadBytes / (1024 * 1024)).toFixed(0);
-        if (audio.byteLength <= maxUploadBytes) {
-            return await transcribeOne(audio);
-        }
-        if (!splitter) {
-            throw new Error(`Audio is ${(audio.byteLength / (1024 * 1024)).toFixed(1)}MB, above ${providerLabel}'s ${limitMB}MB ` +
-                `transcription limit. Assign an AudioSplitter to the Splitter property to transcribe ` +
-                `audio this size.`);
-        }
-        const pieces = await splitter.Split(audio, splitTargetBytes);
-        if (pieces.length === 0) {
-            throw new Error('The configured AudioSplitter returned no pieces');
-        }
-        const transcripts = [];
-        let totalDurationSeconds = 0;
-        let everyPieceReportedDuration = true;
-        for (const piece of pieces) {
-            // A piece the splitter left oversized would fail at the API with a size error naming
-            // neither the splitter nor which piece; say so here instead.
-            if (piece.byteLength > maxUploadBytes) {
-                throw new Error(`The configured AudioSplitter produced a ${(piece.byteLength / (1024 * 1024)).toFixed(1)}MB ` +
-                    `piece, above ${providerLabel}'s ${limitMB}MB limit`);
-            }
-            const transcribed = await transcribeOne(piece);
-            transcripts.push(transcribed.text);
-            if (transcribed.durationSeconds == null) {
-                everyPieceReportedDuration = false;
-            }
-            else {
-                totalDurationSeconds += transcribed.durationSeconds;
-            }
-        }
-        return {
-            text: transcripts.filter((t) => t.length > 0).join(' '),
-            durationSeconds: everyPieceReportedDuration ? totalDurationSeconds : undefined,
-        };
+        return TranscribeAudioWithSplitting(audio, maxUploadBytes, splitTargetBytes, splitter, providerLabel, transcribeOne);
     }
 }
 /**

package/dist/generic/baseAudio.js.map

@@ -1 +1 @@
-{"version":3,"file":"baseAudio.js","sourceRoot":"","sources":["../../src/generic/baseAudio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAc,MAAM,aAAa,CAAC;AAehE;;;;GAIG;AACH,MAAM,OAAgB,kBAAmB,SAAQ,SAAS;IAQtD;;;;;;;;;;;;;;;;;;OAkBG;IACO,KAAK,CAAC,uBAAuB,CACnC,KAAa,EACb,cAAsB,EACtB,gBAAwB,EACxB,QAA8B,EAC9B,aAAqB,EACrB,aAA6D;QAE7D,MAAM,OAAO,GAAG,CAAC,cAAc,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE5D,IAAI,KAAK,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC;YACrC,OAAO,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACX,YAAY,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,aAAa,MAAM,OAAO,KAAK;gBACjG,sFAAsF;gBACtF,kBAAkB,CACzB,CAAC;QACN,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,IAAI,oBAAoB,GAAG,CAAC,CAAC;QAC7B,IAAI,0BAA0B,GAAG,IAAI,CAAC;QAEtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,qFAAqF;YACrF,6DAA6D;YAC7D,IAAI,KAAK,CAAC,UAAU,GAAG,cAAc,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CACX,2CAA2C,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;oBACzF,gBAAgB,aAAa,MAAM,OAAO,UAAU,CAC3D,CAAC;YACN,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;YAC/C,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,WAAW,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC;gBACtC,0BAA0B,GAAG,KAAK,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACJ,oBAAoB,IAAI,WAAW,CAAC,eAAe,CAAC;YACxD,CAAC;QACL,CAAC;QAED,OAAO;YACH,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YACvD,eAAe,EAAE,0BAA0B,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,SAAS;SACjF,CAAC;IACN,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;CAyBxB;AAED,MAAM,OAAO,kBAAmB,SAAQ,UAAU;CAmCjD;AAyED;;GAEG;AACH,MAAM,OAAO,SAAS;CAwCrB;AAED;;GAEG;AACH,MAAM,OAAO,WAAW;CAMvB;AAED,MAAM,OAAO,UAAU;CAmCtB;AAED,MAAM,OAAO,aAAa;CASzB;AAED;;GAEG;AACH,MAAM,OAAO,wBAAwB;CAOpC"}
+{"version":3,"file":"baseAudio.js","sourceRoot":"","sources":["../../src/generic/baseAudio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAc,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAgBlE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAgB,kBAAmB,SAAQ,SAAS;IAQtD;;;;;;;;;;OAUG;IACO,KAAK,CAAC,uBAAuB,CACnC,KAAa,EACb,cAAsB,EACtB,gBAAwB,EACxB,QAA8B,EAC9B,aAAqB,EACrB,aAA6D;QAE7D,OAAO,4BAA4B,CAAC,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IACzH,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;CAmCxB;AAED,MAAM,OAAO,kBAAmB,SAAQ,UAAU;CAmCjD;AAyED;;GAEG;AACH,MAAM,OAAO,SAAS;CAwCrB;AAED;;GAEG;AACH,MAAM,OAAO,WAAW;CAMvB;AAED,MAAM,OAAO,UAAU;CAmCtB;AAED,MAAM,OAAO,aAAa;CASzB;AAED;;GAEG;AACH,MAAM,OAAO,wBAAwB;CAOpC"}

package/dist/generic/baseDecision.d.ts

@@ -0,0 +1,125 @@
+/**
+ * @fileoverview Base class for MemberJunction AI Decision providers.
+ *
+ * This abstract class defines the contract for typed decision models that return
+ * enumerated answers with probabilities instead of free text.
+ *
+ * @module @memberjunction/ai
+ */
+import { BaseModel } from './baseModel.js';
+import { DecisionParams, DecisionResult } from './decision.types.js';
+/**
+ * Abstract base class for typed decision model implementations.
+ * Subclasses wrap provider APIs to produce structured Likelihood, Choice, and Score answers.
+ *
+ * Implementations should:
+ * 1. Register with `@RegisterClass(BaseDecision, 'ProviderName')`
+ * 2. Implement the protected `DoDecide()` method
+ * 3. Honor `params.CancellationToken`, which the base does not check
+ *
+ * `Decide()` validates the request before calling `DoDecide()` and the answers after it,
+ * so a driver does not repeat those checks.
+ *
+ * Example:
+ * ```typescript
+ * @RegisterClass(BaseDecision, 'ExampleDecision')
+ * export class ExampleDecision extends BaseDecision {
+ *     protected async DoDecide(params: DecisionParams): Promise<DecisionResult> {
+ *         // Call the provider and map its output onto DecisionAnswer shapes
+ *     }
+ * }
+ *
+ * const decider = MJGlobal.Instance.ClassFactory.CreateInstance<BaseDecision>(BaseDecision, 'ExampleDecision', apiKey);
+ * const result = await decider.Decide(params);
+ * ```
+ */
+export declare abstract class BaseDecision extends BaseModel {
+    /**
+     * Creates an instance of BaseDecision.
+     * @param apiKey The API key for the decision service provider.
+     */
+    constructor(apiKey: string);
+    /**
+     * Executes a typed decision request across one or more questions about a given state.
+     * This method wraps driver execution with input validation, output verification,
+     * execution timing, and structured error handling. It never throws.
+     *
+     * @param params Decision request parameters including state, questions, and model.
+     * @returns A Promise resolving to a DecisionResult.
+     */
+    Decide(params: DecisionParams): Promise<DecisionResult>;
+    /**
+     * Driver-specific implementation of the decision logic.
+     * Must be implemented by concrete provider subclasses.
+     * Returned probabilities must already be normalised, in range, and keyed correctly.
+     *
+     * The driver owns cancellation: `Decide()` passes `params.CancellationToken` through
+     * unchecked, so the driver should check it before calling the provider and hand it to
+     * the provider's HTTP client.
+     *
+     * @param params Decision parameters to evaluate.
+     * @returns A Promise resolving to a DecisionResult.
+     */
+    protected abstract DoDecide(params: DecisionParams): Promise<DecisionResult>;
+    /**
+     * Validates input DecisionParams against the decision contract.
+     *
+     * @param params Parameters to validate.
+     * @returns An array of error descriptions, empty if valid.
+     */
+    protected ValidateParams(params: DecisionParams): string[];
+    /**
+     * Validates that State is a non-empty string once trimmed, or an object with at least one key.
+     */
+    private validateState;
+    /**
+     * Validates the Questions map.
+     */
+    private validateQuestions;
+    /**
+     * Validates a single question definition.
+     */
+    private validateSingleQuestion;
+    /**
+     * Validates a ChoiceQuestion's options (>= 2 options, unique non-empty Values, non-empty Descriptions).
+     */
+    private validateChoiceQuestion;
+    /**
+     * Validates a ScoreQuestion's levels (>= 2 levels, unique non-empty levels).
+     */
+    private validateScoreQuestion;
+    /**
+     * Validates driver output DecisionResult against the requested questions.
+     *
+     * @param params Original decision request parameters.
+     * @param result Result returned by the driver.
+     * @returns An array of error descriptions, empty if valid.
+     */
+    protected ValidateAnswers(params: DecisionParams, result: DecisionResult): string[];
+    /**
+     * Validates a single answer against its corresponding question.
+     */
+    private validateSingleAnswer;
+    /**
+     * Validates a LikelihoodAnswer (Probability in [0, 1]).
+     */
+    private validateLikelihoodAnswer;
+    /**
+     * Validates a ChoiceAnswer (Value in options, Confidence in [0, 1], Probabilities match options and sum to 1 +-0.01).
+     */
+    private validateChoiceAnswer;
+    /**
+     * Validates a ScoreAnswer (Value in [0, Levels.length - 1], Confidence in [0, 1], Probabilities match levels and sum to 1 +-0.01).
+     */
+    private validateScoreAnswer;
+    /**
+     * Validates that a probability distribution exactly matches the expected keys,
+     * has valid numbers in [0, 1], and sums to 1 within +-0.01 tolerance.
+     */
+    private validateProbabilityDistribution;
+    /**
+     * Checks if a value is a finite number in [0, 1].
+     */
+    private isProbabilityInUnitInterval;
+}
+//# sourceMappingURL=baseDecision.d.ts.map

package/dist/generic/baseDecision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseDecision.d.ts","sourceRoot":"","sources":["../../src/generic/baseDecision.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAIH,cAAc,EAEd,cAAc,EAIjB,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,8BAAsB,YAAa,SAAQ,SAAS;IAChD;;;OAGG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;;;OAOG;IACU,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAsDpE;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAE5E;;;;;OAKG;IACH,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE;IAW1D;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE;IAyCnF;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAQhC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;OAGG;IACH,OAAO,CAAC,+BAA+B;IAgDvC;;OAEG;IACH,OAAO,CAAC,2BAA2B;CAGtC"}