@kortexya/reasoninglayer 4.2.0 → 4.2.1

package/dist/index.js

@@ -5,7 +5,7 @@ var __export = (target, all) => {
 };
 
 // src/config.ts
-var SDK_VERSION = "4.2.0";
+var SDK_VERSION = "4.2.1";
 function resolveConfig(config) {
   if (!config.baseUrl) {
     throw new Error("ClientConfig.baseUrl is required");
@@ -12426,7 +12426,7 @@ var Conformal = class {
     this.http = http;
   }
   /**
-   * @description Compute a split-conformal non-conformity threshold from a labeled calibration set.  Returns the threshold `τ` and a coverage certificate. The returned `threshold` should be passed verbatim to `POST /api/v1/conformal/predict`.
+   * @description Compute a split-conformal non-conformity threshold from a labeled calibration set. Returns `τ` and an in-sample coverage check. The returned `threshold` should be passed verbatim to `POST /api/v1/conformal/predict`.
    *
    * @tags conformal
    * @name CalibrateConformal
@@ -12442,7 +12442,7 @@ var Conformal = class {
     ...params
   });
   /**
-   * @description Apply a pre-computed conformal threshold to unlabeled test inputs and return prediction sets with coverage certificates. A class `y` is included in an input's prediction set iff `1 − class_scores[y] ≤ threshold` (equivalently, `class_scores[y] ≥ 1 − threshold`). When no class meets this criterion the prediction set is empty and `abstains = true` is set on that input's result.
+   * @description Apply a pre-computed conformal threshold to unlabeled test inputs and return prediction sets with explicitly unverified supplied parameters. A class `y` is included in an input's prediction set iff `1 − class_scores[y] ≤ threshold`, evaluated in that score space. When no class meets this criterion the prediction set is empty and `abstains = true` is set on that input's result.
    *
    * @tags conformal
    * @name Predict
@@ -17601,6 +17601,7 @@ var RESPONSE_COMPONENTS = {
       algorithm: [1, 0],
       alpha: [1, 0],
       empirical_coverage: [1, 0],
+      informative: [1, 0],
       meets_target_coverage: [1, 0],
       n_samples: [1, 0],
       quantile_rank: [1, 0],
@@ -17609,7 +17610,7 @@ var RESPONSE_COMPONENTS = {
   },
   ConformalPredictResponse: {
     object: {
-      coverage_certificate: [1, "CoverageCertificate"],
+      calibration_parameters: [1, "SuppliedCalibrationParameters"],
       predictions: [1, { array: "ConformalPrediction" }]
     }
   },
@@ -17846,15 +17847,6 @@ var RESPONSE_COMPONENTS = {
     }
   },
   CounterfactualTraceDto: { object: { abduction: [1, 0], action: [1, 0], prediction: [1, 0] } },
-  CoverageCertificate: {
-    object: {
-      algorithm: [1, 0],
-      alpha: [1, 0],
-      n_calibration_samples: [1, 0],
-      nominal_coverage: [1, 0],
-      threshold: [1, 0]
-    }
-  },
   CoverageDetailDto: {
     object: {
       class_coverage: [1, 0],
@@ -22751,6 +22743,17 @@ var RESPONSE_COMPONENTS = {
       supervisor_active: [1, 0]
     }
   },
+  SuppliedCalibrationParameters: {
+    object: {
+      algorithm: [1, 0],
+      alpha: [1, 0],
+      informative: [1, 0],
+      n_calibration_samples: [1, 0],
+      requested_coverage: [1, 0],
+      threshold: [1, 0],
+      verification: [1, 0]
+    }
+  },
   SuspendedQueryDto: {
     object: {
       confidence: [1, 0],
@@ -61499,6 +61502,7 @@ function ConformalCalibrateResponseFromApiToFront(dto) {
     algorithm: dto.algorithm,
     alpha: dto.alpha,
     empiricalCoverage: dto.empirical_coverage,
+    informative: dto.informative,
     meetsTargetCoverage: dto.meets_target_coverage,
     nSamples: dto.n_samples,
     quantileRank: dto.quantile_rank,
@@ -61513,13 +61517,15 @@ function ConformalPredictRequestFromFrontToApi(model) {
     threshold: model.threshold
   };
 }
-function CoverageCertificateFromApiToFront(dto) {
+function SuppliedCalibrationParametersFromApiToFront(dto) {
   return {
     algorithm: dto.algorithm,
     alpha: dto.alpha,
+    informative: dto.informative,
     nCalibrationSamples: dto.n_calibration_samples,
-    nominalCoverage: dto.nominal_coverage,
-    threshold: dto.threshold
+    requestedCoverage: dto.requested_coverage,
+    threshold: dto.threshold,
+    verification: dto.verification
   };
 }
 function ConformalPredictionFromApiToFront(dto) {
@@ -61533,7 +61539,7 @@ function ConformalPredictionFromApiToFront(dto) {
 }
 function ConformalPredictResponseFromApiToFront(dto) {
   return {
-    coverageCertificate: CoverageCertificateFromApiToFront(dto.coverage_certificate),
+    calibrationParameters: SuppliedCalibrationParametersFromApiToFront(dto.calibration_parameters),
     predictions: dto.predictions.map(ConformalPredictionFromApiToFront)
   };
 }
@@ -61552,11 +61558,22 @@ var ConformalClient = class {
    *
    * @param request - The calibration set (samples + target miscoverage
    *   `α`).
-   * @returns The computed threshold `τ` plus a coverage certificate and
-   *   sanity-check coverage stats.
+   * @param requestOptions - Per-request transport options.
+   * @returns The computed threshold `τ`, whether it is informative, and
+   *   in-sample coverage statistics.
    *
    * @throws {ApiError} `400` if `alpha` is outside `(0, 1)` or the
-   *   calibration set is empty.
+   *   calibration set is empty or contains invalid scores.
+   * @remarks The request maps schema keys to snake_case and preserves class labels.
+   *   An unobserved rank returns threshold 1 and `informative: false`.
+   * @example
+   * ```ts
+   * const calibration = await client.conformal.calibrate({
+   *   alpha: 0.05,
+   *   samples: labeledSamples,
+   * });
+   * console.log(calibration.informative, calibration.quantileRank);
+   * ```
    */
   async calibrate(request, requestOptions) {
     const response = await this.api.calibrateConformal(
@@ -61567,15 +61584,30 @@ var ConformalClient = class {
   }
   /**
    * Apply a pre-computed conformal threshold to unlabeled test inputs
-   * and return prediction sets with coverage certificates.
+   * and return prediction sets with unverified calibration parameters.
    *
    * @param request - The threshold `τ`, calibration `α` and sample count
    *   (from a prior `calibrate` call), and the test inputs to predict
    *   for.
-   * @returns Per-input conformal prediction results plus a coverage
-   *   certificate, in request order.
-   *
-   * @throws {ApiError} `400` if the test-input count exceeds 10 000.
+   * @param requestOptions - Per-request transport options.
+   * @returns Per-input prediction results in request order and the applied
+   *   parameters with `verification: 'unverified'`.
+   *
+   * @throws {ApiError} `400` for invalid scores, parameters, rank consistency,
+   *   or an empty or oversized test-input batch.
+   * @remarks The request maps schema keys to snake_case and preserves class labels.
+   *   A nonempty prediction set can still be uninformative. Parameter consistency
+   *   does not establish calibration provenance or prediction correctness.
+   * @example
+   * ```ts
+   * const result = await client.conformal.predict({
+   *   threshold: calibration.threshold,
+   *   alpha: calibration.alpha,
+   *   nCalibrationSamples: calibration.nSamples,
+   *   testInputs,
+   * });
+   * console.log(result.calibrationParameters.verification);
+   * ```
    */
   async predict(request, requestOptions) {
     const response = await this.api.predict(