@memberjunction/ai 6.1.4 → 6.2.0-edge.1

package/dist/generic/classify.types.d.ts

@@ -2,14 +2,25 @@ import { BaseResult } from "./baseModel.js";
 import { ChatParams } from "./chat.types.js";
 /**
  * Defined in order to have this type available for future use with additional properties beyond the BaseParams type.
+ *
+ * @deprecated Used only by the deprecated `BaseLLM.ClassifyText`. Will be removed in the next
+ * major version.
  */
 export declare class ClassifyParams extends ChatParams {
 }
+/**
+ * @deprecated Used only by the deprecated `BaseLLM.ClassifyText`. Will be removed in the next
+ * major version.
+ */
 export declare class ClassifyTag {
     constructor(tag: string, confidence: number);
     tag: string;
     confidence: number;
 }
+/**
+ * @deprecated Used only by the deprecated `BaseLLM.ClassifyText`. Will be removed in the next
+ * major version.
+ */
 export declare class ClassifyResult extends BaseResult {
     inputText: string;
     tags: ClassifyTag[];

package/dist/generic/classify.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"classify.types.d.ts","sourceRoot":"","sources":["../../src/generic/classify.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAc,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;CAC7C;AAED,qBAAa,WAAW;gBACR,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAI3C,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;CACrB;AAED,qBAAa,cAAe,SAAQ,UAAU;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,WAAW,EAAE,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;CACxB"}
+{"version":3,"file":"classify.types.d.ts","sourceRoot":"","sources":["../../src/generic/classify.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAc,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,UAAU;CAC7C;AAED;;;GAGG;AACH,qBAAa,WAAW;gBACR,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAI3C,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,WAAW,EAAE,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;CACxB"}

package/dist/generic/classify.types.js

@@ -2,15 +2,26 @@ import { BaseResult } from "./baseModel.js";
 import { ChatParams } from "./chat.types.js";
 /**
  * Defined in order to have this type available for future use with additional properties beyond the BaseParams type.
+ *
+ * @deprecated Used only by the deprecated `BaseLLM.ClassifyText`. Will be removed in the next
+ * major version.
  */
 export class ClassifyParams extends ChatParams {
 }
+/**
+ * @deprecated Used only by the deprecated `BaseLLM.ClassifyText`. Will be removed in the next
+ * major version.
+ */
 export class ClassifyTag {
     constructor(tag, confidence) {
         this.tag = tag;
         this.confidence = confidence;
     }
 }
+/**
+ * @deprecated Used only by the deprecated `BaseLLM.ClassifyText`. Will be removed in the next
+ * major version.
+ */
 export class ClassifyResult extends BaseResult {
 }
 //# sourceMappingURL=classify.types.js.map

package/dist/generic/classify.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"classify.types.js","sourceRoot":"","sources":["../../src/generic/classify.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAc,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;CAC7C;AAED,MAAM,OAAO,WAAW;IACpB,YAAY,GAAW,EAAE,UAAkB;QACvC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;CAGJ;AAED,MAAM,OAAO,cAAe,SAAQ,UAAU;CAI7C"}
+{"version":3,"file":"classify.types.js","sourceRoot":"","sources":["../../src/generic/classify.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAc,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;CAC7C;AAED;;;GAGG;AACH,MAAM,OAAO,WAAW;IACpB,YAAY,GAAW,EAAE,UAAkB;QACvC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;CAGJ;AAED;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;CAI7C"}

package/dist/generic/decision.types.d.ts

@@ -0,0 +1,201 @@
+/**
+ * @fileoverview Core type definitions for the MemberJunction AI Decision system.
+ *
+ * These types define the contract for typed decision operations across all providers
+ * (LLM-based, purpose-built decision models, etc.) and are used by the BaseDecision abstract class.
+ *
+ * @module @memberjunction/ai
+ */
+import { BaseResult, ModelUsage } from './baseModel.js';
+/**
+ * A decision question with a yes/no outcome, asking whether a statement is true.
+ * Returns a LikelihoodAnswer with a single probability in [0, 1].
+ * The probability is the confidence; there is no separate confidence field.
+ */
+export interface LikelihoodQuestion {
+    /**
+     * Discriminator identifying this as a likelihood question.
+     */
+    Kind: 'Likelihood';
+    /**
+     * Instructions describing what statement is being evaluated.
+     * Question keys are identifiers for code, not instructions to the model.
+     */
+    Instructions: string;
+}
+/**
+ * An individual option for a ChoiceQuestion.
+ */
+export interface ChoiceOption {
+    /**
+     * Identifier value for code. Option values are identifiers for code
+     * and carry no meaning to the model.
+     */
+    Value: string;
+    /**
+     * Description read by the model explaining what this option represents.
+     */
+    Description: string;
+}
+/**
+ * A decision question selecting one label from an enumerated set of options.
+ * Requires at least 2 options with unique, non-empty values and non-empty descriptions.
+ */
+export interface ChoiceQuestion {
+    /**
+     * Discriminator identifying this as a choice question.
+     */
+    Kind: 'Choice';
+    /**
+     * Instructions describing the selection criteria.
+     * Question keys are identifiers for code, not instructions to the model.
+     */
+    Instructions: string;
+    /**
+     * Candidate options to choose from (minimum 2).
+     */
+    Options: ChoiceOption[];
+}
+/**
+ * A decision question placing the state on an ordered rubric scale.
+ * Requires at least 2 levels ordered from lowest to highest.
+ */
+export interface ScoreQuestion {
+    /**
+     * Discriminator identifying this as a score question.
+     */
+    Kind: 'Score';
+    /**
+     * Instructions describing the scoring rubric.
+     * Question keys are identifiers for code, not instructions to the model.
+     */
+    Instructions: string;
+    /**
+     * Ordered rubric levels from lowest to highest (minimum 2).
+     */
+    Levels: string[];
+}
+/**
+ * Union of all supported decision question types.
+ */
+export type DecisionQuestion = LikelihoodQuestion | ChoiceQuestion | ScoreQuestion;
+/**
+ * Discriminator kind for decision questions ('Likelihood' | 'Choice' | 'Score').
+ */
+export type DecisionQuestionKind = DecisionQuestion['Kind'];
+/**
+ * Parameters for a decision operation.
+ */
+export interface DecisionParams {
+    /**
+     * Provider API name (AIModelVendor.APIName) passed to the driver.
+     */
+    Model: string;
+    /**
+     * The state the questions are asked about. Keep it narrow to avoid state projection degradation.
+     * Can be a non-empty string or an object with at least one key.
+     */
+    State: string | Record<string, unknown>;
+    /**
+     * Named questions, answered in one call.
+     * Question keys identify answers in code and are NOT instructions to the model.
+     */
+    Questions: Record<string, DecisionQuestion>;
+    /**
+     * Optional signal for cancelling the request. The driver is responsible for honoring it:
+     * `BaseDecision.Decide()` does not check it and calls the driver even when it is already
+     * aborted, as `BaseLLM` does with `ChatParams.cancellationToken`. A driver that stops because
+     * the signal fired either returns a failed result or throws; in both cases `Decide()`
+     * resolves with `success: false` and empty `Answers`.
+     */
+    CancellationToken?: AbortSignal;
+}
+/**
+ * Answer to a LikelihoodQuestion.
+ */
+export interface LikelihoodAnswer {
+    /**
+     * Discriminator identifying this as a likelihood answer.
+     */
+    Kind: 'Likelihood';
+    /**
+     * Probability that the statement is true, in [0, 1].
+     * The probability is the confidence; there is no separate confidence field.
+     */
+    Probability: number;
+}
+/**
+ * Answer to a ChoiceQuestion.
+ */
+export interface ChoiceAnswer {
+    /**
+     * Discriminator identifying this as a choice answer.
+     */
+    Kind: 'Choice';
+    /**
+     * The selected option value (matches one of the ChoiceOption.Value identifiers).
+     */
+    Value: string;
+    /**
+     * Probability distribution keyed by option Value.
+     * Probabilities must sum to 1 within +-0.01.
+     */
+    Probabilities: Record<string, number>;
+    /**
+     * Confidence score in [0, 1] for the choice.
+     */
+    Confidence: number;
+}
+/**
+ * Answer to a ScoreQuestion.
+ */
+export interface ScoreAnswer {
+    /**
+     * Discriminator identifying this as a score answer.
+     */
+    Kind: 'Score';
+    /**
+     * Continuous position from 0 (the first level) to Levels.length - 1 (the last level).
+     * Drivers map any vendor scale onto this.
+     */
+    Value: number;
+    /**
+     * Probability distribution keyed by level name.
+     * Probabilities must sum to 1 within +-0.01.
+     */
+    Probabilities: Record<string, number>;
+    /**
+     * Confidence score in [0, 1] for the score.
+     */
+    Confidence: number;
+}
+/**
+ * Union of all supported decision answer types.
+ */
+export type DecisionAnswer = LikelihoodAnswer | ChoiceAnswer | ScoreAnswer;
+/**
+ * Result of a decision operation, extending BaseResult with decision answers and telemetry.
+ */
+export declare class DecisionResult extends BaseResult {
+    /**
+     * Map of answers matching the input Questions by key.
+     * Empty on failure so consumers never act on partial or malformed answers.
+     */
+    Answers: Record<string, DecisionAnswer>;
+    /**
+     * Optional token or unit usage details for cost tracking.
+     */
+    Usage?: ModelUsage;
+    /**
+     * The vendor's dated or concrete model identifier when the request used an alias.
+     */
+    ResolvedModel?: string;
+    /**
+     * Creates a new DecisionResult instance.
+     * @param success Whether the decision operation was successful.
+     * @param startTime Execution start timestamp.
+     * @param endTime Execution end timestamp.
+     */
+    constructor(success: boolean, startTime: Date, endTime: Date);
+}
+//# sourceMappingURL=decision.types.d.ts.map

package/dist/generic/decision.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.types.d.ts","sourceRoot":"","sources":["../../src/generic/decision.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IAEnB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,cAAc,GAAG,aAAa,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAExC;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAE5C;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,WAAW,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IAEnB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,YAAY,GAAG,WAAW,CAAC;AAE3E;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC1C;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAM;IAE7C;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;gBACS,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI;CAG/D"}

package/dist/generic/decision.types.js

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Core type definitions for the MemberJunction AI Decision system.
+ *
+ * These types define the contract for typed decision operations across all providers
+ * (LLM-based, purpose-built decision models, etc.) and are used by the BaseDecision abstract class.
+ *
+ * @module @memberjunction/ai
+ */
+import { BaseResult } from './baseModel.js';
+/**
+ * Result of a decision operation, extending BaseResult with decision answers and telemetry.
+ */
+export class DecisionResult extends BaseResult {
+    /**
+     * Creates a new DecisionResult instance.
+     * @param success Whether the decision operation was successful.
+     * @param startTime Execution start timestamp.
+     * @param endTime Execution end timestamp.
+     */
+    constructor(success, startTime, endTime) {
+        super(success, startTime, endTime);
+        /**
+         * Map of answers matching the input Questions by key.
+         * Empty on failure so consumers never act on partial or malformed answers.
+         */
+        this.Answers = {};
+    }
+}
+//# sourceMappingURL=decision.types.js.map

package/dist/generic/decision.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.types.js","sourceRoot":"","sources":["../../src/generic/decision.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAc,MAAM,aAAa,CAAC;AAmMrD;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;IAiB1C;;;;;OAKG;IACH,YAAY,OAAgB,EAAE,SAAe,EAAE,OAAa;QACxD,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAvBvC;;;WAGG;QACH,YAAO,GAAmC,EAAE,CAAC;IAoB7C,CAAC;CACJ"}

package/dist/generic/errorAnalyzer.d.ts

@@ -36,6 +36,8 @@ export declare class ErrorAnalyzer {
      * console.log(`Can retry: ${errorInfo.severity !== 'Fatal'}`);
      * ```
      */
+    static AnalyzeError(error: any, providerName?: string): AIErrorInfo;
+    /** @deprecated Use {@link AnalyzeError}. */
     static analyzeError(error: any, providerName?: string): AIErrorInfo;
     /**
      * Extracts HTTP status code from various error object structures.

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

@@ -1 +1 @@
-{"version":3,"file":"errorAnalyzer.d.ts","sourceRoot":"","sources":["../../src/generic/errorAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA8B,MAAM,iBAAiB,CAAC;AAE1E;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IACtB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW;IAqDnE;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAUpC;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA0IjC;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IA0BhC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAyBlC;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IA4BhC;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;CA6B1C"}
+{"version":3,"file":"errorAnalyzer.d.ts","sourceRoot":"","sources":["../../src/generic/errorAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA8B,MAAM,iBAAiB,CAAC;AAG1E;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IACtB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW;IAqDnE,4CAA4C;IAC5C,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW;IAInE;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAUpC;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA6IjC;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IA0BhC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAyBlC;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IA4BhC;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;CA8B1C"}

package/dist/generic/errorAnalyzer.js

@@ -1,3 +1,4 @@
+import { ContainsInOrderOnOneLine, FirstBraceSpanOnOneLine } from './linearTextScan.js';
 /**
  * Utility class for analyzing errors from various AI providers and mapping them to standardized error information.
  * This class provides a consistent way to interpret errors across different provider SDKs.
@@ -35,7 +36,7 @@ export class ErrorAnalyzer {
      * console.log(`Can retry: ${errorInfo.severity !== 'Fatal'}`);
      * ```
      */
-    static analyzeError(error, providerName) {
+    static AnalyzeError(error, providerName) {
         // Extract HTTP status code if available
         const httpStatusCode = this.extractHttpStatusCode(error);
         // Determine error type based on status code and error properties
@@ -80,6 +81,10 @@ export class ErrorAnalyzer {
             }
         };
     }
+    /** @deprecated Use {@link AnalyzeError}. */
+    static analyzeError(error, providerName) {
+        return this.AnalyzeError(error, providerName);
+    }
     /**
      * Extracts HTTP status code from various error object structures.
      * Different provider SDKs store status codes in different locations.
@@ -131,6 +136,7 @@ export class ErrorAnalyzer {
             errorString.includes('payment') || // Payment required errors
             errorString.includes('insufficient funds') ||
             errorString.includes('quota exceeded') ||
+            errorString.includes('usage limits') || // Anthropic spend cap — sent as a 400 invalid_request_error, which the status fallback would misread as a malformed request
             errorString.includes('balance') || // Account balance issues
             errorString.includes('no funds')) {
             return 'NoCredit';
@@ -178,9 +184,11 @@ export class ErrorAnalyzer {
         if (errorString.includes('required') ||
             errorString.includes('validation') ||
             errorString.includes('schema') ||
-            /\w+\s+is\s+required/.test(errorString) || // Matches "X is required"
-            /missing.*(?:field|property)/.test(errorString) || // Matches "missing field/property X"
-            /(?:field|property).*missing/.test(errorString) || // Matches "field/property X missing"
+            // "X is required" is already covered by includes('required') above.
+            // Linear scans rather than /missing.*(?:field|property)/ and its reverse, which are polynomial
+            // on provider-controlled text (CodeQL js/polynomial-redos).
+            ContainsInOrderOnOneLine(errorString, ['missing'], ['field', 'property']) || // "missing field/property X"
+            ContainsInOrderOnOneLine(errorString, ['field', 'property'], ['missing']) || // "field/property X missing"
             /must\s+(?:be|have|contain)/.test(errorString)) { // Matches "X must be/have/contain Y"
             return 'VendorValidationError';
         }
@@ -352,10 +360,11 @@ export class ErrorAnalyzer {
         const errorMessage = error?.message || error?.errorMessage || '';
         if (errorMessage.includes('{') && errorMessage.includes('}')) {
             try {
-                // Extract JSON from error message
-                const jsonMatch = errorMessage.match(/\{.*\}/);
-                if (jsonMatch) {
-                    const parsed = JSON.parse(jsonMatch[0]);
+                // Extract JSON from error message: a linear scan rather than /\{.*\}/, which is polynomial
+                // on provider-controlled text (CodeQL js/polynomial-redos).
+                const jsonSpan = FirstBraceSpanOnOneLine(errorMessage);
+                if (jsonSpan) {
+                    const parsed = JSON.parse(jsonSpan);
                     return parsed?.error?.code || parsed?.code || undefined;
                 }
             }

package/dist/generic/errorAnalyzer.js.map

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

package/dist/generic/linearTextScan.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Linear-time replacements for regular expressions that CodeQL flags as polynomial
+ * (`js/polynomial-redos`) because they run over provider error text we don't control.
+ *
+ * Each function keeps the exact semantics of the expression it replaces, including that
+ * `.` in a JavaScript regex never crosses a line terminator (`\n`, `\r`, `\u2028`, `\u2029`).
+ */
+/**
+ * True when some line of `text` contains one of `befores` followed, later on the same line,
+ * by one of `afters`. Equivalent to `/(?:b1|b2).*(?:a1|a2)/.test(text)`.
+ */
+export declare function ContainsInOrderOnOneLine(text: string, befores: readonly string[], afters: readonly string[]): boolean;
+/**
+ * The first `{…}` span on one line: from the leftmost `{` that has a `}` after it on the same
+ * line, through the last `}` on that line. Equivalent to `text.match(/\{.*\}/)?.[0] ?? null`.
+ */
+export declare function FirstBraceSpanOnOneLine(text: string): string | null;
+//# sourceMappingURL=linearTextScan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linearTextScan.d.ts","sourceRoot":"","sources":["../../src/generic/linearTextScan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAoBrH;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBnE"}

package/dist/generic/linearTextScan.js

@@ -0,0 +1,70 @@
+/**
+ * Linear-time replacements for regular expressions that CodeQL flags as polynomial
+ * (`js/polynomial-redos`) because they run over provider error text we don't control.
+ *
+ * Each function keeps the exact semantics of the expression it replaces, including that
+ * `.` in a JavaScript regex never crosses a line terminator (`\n`, `\r`, `\u2028`, `\u2029`).
+ */
+/** True for the four characters a regex `.` refuses to match. */
+function isLineTerminator(ch) {
+    return ch === '\n' || ch === '\r' || ch === '\u2028' || ch === '\u2029';
+}
+/** Index of the next line terminator at or after `from`, or `text.length` when there is none. */
+function lineEndFrom(text, from) {
+    for (let i = from; i < text.length; i++) {
+        if (isLineTerminator(text[i])) {
+            return i;
+        }
+    }
+    return text.length;
+}
+/**
+ * True when some line of `text` contains one of `befores` followed, later on the same line,
+ * by one of `afters`. Equivalent to `/(?:b1|b2).*(?:a1|a2)/.test(text)`.
+ */
+export function ContainsInOrderOnOneLine(text, befores, afters) {
+    let lineStart = 0;
+    while (lineStart <= text.length) {
+        const lineEnd = lineEndFrom(text, lineStart);
+        const line = text.slice(lineStart, lineEnd);
+        for (const before of befores) {
+            // The earliest occurrence leaves the most room for an `after`, so it is the only one to check.
+            const at = line.indexOf(before);
+            if (at < 0) {
+                continue;
+            }
+            for (const after of afters) {
+                if (line.indexOf(after, at + before.length) >= 0) {
+                    return true;
+                }
+            }
+        }
+        lineStart = lineEnd + 1;
+    }
+    return false;
+}
+/**
+ * The first `{…}` span on one line: from the leftmost `{` that has a `}` after it on the same
+ * line, through the last `}` on that line. Equivalent to `text.match(/\{.*\}/)?.[0] ?? null`.
+ */
+export function FirstBraceSpanOnOneLine(text) {
+    let searchFrom = 0;
+    while (searchFrom < text.length) {
+        const open = text.indexOf('{', searchFrom);
+        if (open < 0) {
+            return null;
+        }
+        const lineEnd = lineEndFrom(text, open);
+        // Search only this line. An unbounded lastIndexOf would scan back through every earlier
+        // line on each line with a `{` but no `}`, which is quadratic on multi-line input.
+        const line = text.slice(open, lineEnd);
+        const close = line.lastIndexOf('}');
+        if (close > 0) {
+            return line.slice(0, close + 1);
+        }
+        // No `}` after this `{` on its line, so none after any later `{` on that line either.
+        searchFrom = lineEnd + 1;
+    }
+    return null;
+}
+//# sourceMappingURL=linearTextScan.js.map

package/dist/generic/linearTextScan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linearTextScan.js","sourceRoot":"","sources":["../../src/generic/linearTextScan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iEAAiE;AACjE,SAAS,gBAAgB,CAAC,EAAU;IAChC,OAAO,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,QAAQ,CAAC;AAC5E,CAAC;AAED,iGAAiG;AACjG,SAAS,WAAW,CAAC,IAAY,EAAE,IAAY;IAC3C,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,CAAC;QACb,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,OAA0B,EAAE,MAAyB;IACxG,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,OAAO,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC3B,+FAA+F;YAC/F,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;gBACT,SAAS;YACb,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC/C,OAAO,IAAI,CAAC;gBAChB,CAAC;YACL,CAAC;QACL,CAAC;QACD,SAAS,GAAG,OAAO,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAChD,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,OAAO,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC3C,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxC,wFAAwF;QACxF,mFAAmF;QACnF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACpC,CAAC;QACD,sFAAsF;QACtF,UAAU,GAAG,OAAO,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/generic/modelConfiguration.d.ts

@@ -1,13 +1,14 @@
 /**
  * The canonical AI configuration shapes + the pure cascade resolvers.
  *
- * The AI stack carries `nvarchar(max)` JSONType configuration bags at five levels, in two cascades.
+ * The AI stack carries `nvarchar(max)` JSONType configuration bags at six levels, in two cascades.
  * The MODEL CATALOG cascade describes the model:
  *
  * ```
  * MJ: AI Model Types . ModelConfiguration     (type-wide default — e.g. every Realtime model)
  *   < MJ: AI Models . ModelConfiguration      (per-model)
- *     < MJ: AI Model Vendors . ModelConfiguration   (per model-on-this-provider — the winner)
+ *     < MJ: AI Vendors . Configuration.ModelDefaults   (host-wide default for every model this vendor serves)
+ *       < MJ: AI Model Vendors . ModelConfiguration   (per model-on-this-provider — the tie-breaker, wins)
  * ```
  *
  * The PROMPT cascade describes what a given prompt asks for, and layers on top of the catalog:
@@ -246,6 +247,25 @@ export interface LLMConfigurationSettings {
      * only when the gate resolves native.
      */
     NativeToolResults?: boolean | null;
+    /**
+     * **Catalog layers only.** Whether this serving path's prompt cache is an exact BYTE-PREFIX match:
+     * it reuses a prior request only when that request's entire prompt is a prefix of the new one
+     * (OpenAI's automatic cache, xAI). Per-iteration framework state must then be appended, never
+     * replaced, or the reusable prefix ends at the system prompt. Absent or `false` means a block or
+     * segment cache (Anthropic's explicit breakpoints, Gemini's implicit cache, Cerebras's sliding
+     * cache), where a trailing per-iteration message can be replaced in place — the safe default,
+     * since replace-in-place costs a block-cache provider nothing whereas append-only only grows the
+     * context.
+     *
+     * Set `true` under `Configuration.ModelDefaults` on the VENDOR row of a prefix-cache provider so
+     * every model it serves inherits it (the vendor default beats the model's own bag); a MODEL-VENDOR
+     * row overrides it, so a host that serves many models (Fireworks, Cerebras, Azure, Bedrock) can
+     * carry a per-model answer that differs from the vendor default.
+     *
+     * Consumed by the loop agent's trailing runtime-state layout: see `TrailingStateMode` in
+     * `@memberjunction/ai-agents`.
+     */
+    PrefixPromptCache?: boolean | null;
 }
 /** Vision knobs. Reserved — no consumers yet. */
 export interface VisionConfigurationSettings {
@@ -255,6 +275,24 @@ export interface VisionConfigurationSettings {
 export interface AudioConfigurationSettings {
     [key: string]: unknown;
 }
+/**
+ * Typed-decision knobs, consumed at call time by the decision runner. They declare what a decision
+ * model accepts, so an oversized request can be refused with a clear message before the call,
+ * instead of being truncated or rejected by the provider. Each is a limit of the model itself: set
+ * it on the catalog layers (`MJ: AI Models`, `MJ: AI Model Vendors`). Absent means no limit is
+ * declared. A decision always needs at least two Choice options or Score levels; that minimum
+ * belongs to `BaseDecision`, not to this bag.
+ */
+export interface DecisionConfigurationSettings {
+    /** The most questions one call may carry. */
+    MaxQuestionsPerCall?: number | null;
+    /** The most options one Choice question may list. */
+    MaxChoiceOptions?: number | null;
+    /** The most levels one Score question may list. */
+    MaxScoreLevels?: number | null;
+    /** The largest state the model reads, in tokens. */
+    MaxStateTokens?: number | null;
+}
 /**
  * The per-modality bag common to every AI configuration column. Sections are optional and
  * per-modality so one row can configure everything the thing it describes does.
@@ -268,6 +306,8 @@ export interface AIConfigurationSections {
     Vision?: VisionConfigurationSettings | null;
     /** Audio (TTS/STT) knobs. Reserved. */
     Audio?: AudioConfigurationSettings | null;
+    /** Typed-decision limits. Honored at the catalog layers. */
+    Decision?: DecisionConfigurationSettings | null;
 }
 /**
  * The `ModelConfiguration` column on `MJ: AI Model Types`, `MJ: AI Models` and
@@ -297,9 +337,27 @@ export type LLMModelConfigurationSection = LLMConfigurationSettings;
  * @returns The parsed configuration, or `null` when the layer contributes nothing.
  */
 export declare function ParseModelConfiguration(json: string | null | undefined): AIModelConfiguration | null;
+/**
+ * `MJ: AI Vendors . Configuration` — the vendor's own configuration bag (lockstep with
+ * `IAIVendorConfiguration` in the metadata interface). General-purpose; its first key,
+ * {@link AIVendorConfiguration.ModelDefaults}, is the vendor layer of the model-configuration cascade.
+ */
+export interface AIVendorConfiguration {
+    /**
+     * The default model configuration for every model this vendor serves. Resolved ABOVE the
+     * model's own bag and BELOW the model-vendor row (the tie-breaker); merged per key, so it only
+     * touches the keys it sets.
+     */
+    ModelDefaults?: AIModelConfiguration | null;
+}
+/**
+ * Tolerant parse of one `AIVendor.Configuration` column value — the same contract as
+ * {@link ParseModelConfiguration}: absent, blank, malformed or non-object JSON contributes nothing.
+ */
+export declare function ParseVendorConfiguration(json: string | null | undefined): AIVendorConfiguration | null;
 /**
  * Resolves the EFFECTIVE model configuration by deep-merging the catalog layers, base first —
- * type default < model < model-vendor. Merge semantics are identical to the realtime config
+ * type default < model < vendor default < model-vendor. Merge semantics are identical to the realtime config
  * cascade (`DeepMergeConfigs` in `@memberjunction/ai-agents` — duplicated here because package
  * layering runs the other way):
  *
@@ -312,4 +370,11 @@ export declare function ParseModelConfiguration(json: string | null | undefined)
  * @returns The merged configuration, or `null` when every layer is absent/empty.
  */
 export declare function ResolveEffectiveModelConfiguration(...layers: Array<AIModelConfiguration | null | undefined>): AIModelConfiguration | null;
+/**
+ * Whether an effective model configuration declares a byte-prefix prompt cache
+ * (`LLM.PrefixPromptCache === true`). Absent, `null` or `false` all mean a block cache. Read through
+ * {@link ResolveEffectiveModelConfiguration} (or `AIEngineBase.GetEffectiveModelConfiguration`) so
+ * the most specific layer's answer wins.
+ */
+export declare function IsPrefixPromptCache(config: AIModelConfiguration | null | undefined): boolean;
 //# sourceMappingURL=modelConfiguration.d.ts.map