@kortexya/reasoninglayer 6.0.0 → 6.1.0

package/dist/index.cjs

@@ -7,7 +7,7 @@ var __export = (target, all) => {
 };
 
 // src/config.ts
-var SDK_VERSION = "6.0.0";
+var SDK_VERSION = "6.1.0";
 function resolveConfig(config) {
   if (!config.baseUrl) {
     throw new Error("ClientConfig.baseUrl is required");
@@ -49704,6 +49704,7 @@ function StartExplorationRequestFromFrontToApi(model) {
     min_intent_size: model.minIntentSize,
     max_terms: model.maxTerms,
     ...model.sortNames !== void 0 ? { sort_names: model.sortNames } : {},
+    ...model.semantics !== void 0 ? { semantics: DiscoverySemanticsFromFrontToApi(model.semantics) } : {},
     ...explorationSearchBoundsFromFrontToApi(model)
   };
 }
@@ -49738,6 +49739,7 @@ function RefuteRequestFromFrontToApi(model) {
     question_id: model.questionId,
     label: model.label,
     features: model.features,
+    ...model.values !== void 0 ? { values: featuresFromFrontToApi(model.values) } : {},
     ...explorationSearchBoundsFromFrontToApi(model)
   };
 }
@@ -49848,13 +49850,39 @@ var AnalysisClient = class {
   /**
    * Start an interactive attribute exploration session.
    *
-   * @param request - Exploration parameters.
-   * @returns Session ID and first question.
+   * @param request - Exploration parameters: the sort scope (`sortNames`),
+   *   the attribute `semantics`, and the search bounds.
+   * @param requestOptions - Per-call request options.
+   * @returns Session ID, the formal context's attribute and object counts,
+   *   the first question, and the search report.
+   * @throws {ForbiddenError} 403 with code `exploration_actor_required` when
+   *   the request carries no gateway human actor (`authenticatedUser`).
+   * @throws {BadRequestError} 400 for an unknown sort name, a refused
+   *   population bound (`exploration_population_limit`), native-predicate
+   *   semantics, or a scaled interpretation that is not complete.
+   *
+   * @remarks
+   * The converted body is sent verbatim (no further key conversion): the
+   * feature names that key a `scaled` semantics' `schemes` reach the engine
+   * exactly as written. A missing `question` does not mean the basis is
+   * complete: read `search.stop`.
+   *
+   * @example
+   * ```typescript
+   * const started = await client.analysis.startExploration({
+   *   sortNames: ['member'],
+   *   semantics: {
+   *     kind: 'scaled',
+   *     schemes: { age: { kind: 'interordinal', thresholds: [65] } },
+   *   },
+   * });
+   * console.log(started.attributeCount, started.objectCount, started.search.stop);
+   * ```
    */
   async startExploration(request, requestOptions) {
     const response = await this.api.startExploration(
       StartExplorationRequestFromFrontToApi(request),
-      toRequestParams(requestOptions)
+      mergeRequestParams({ headers: { [RAW_BODY_HEADER]: "1" } }, requestOptions)
     );
     return decodeResponse(response, StartExplorationResponseFromApiToFront);
   }
@@ -49923,7 +49951,13 @@ var AnalysisClient = class {
    * @throws {NotFoundError} 404 when the session does not exist.
    *
    * @remarks
-   * Body `{ question_id, label, features }`; `questionId` is required.
+   * Body `{ question_id, label, features, values? }`; `questionId` is
+   * required. A presence session takes the counterexample's feature names in
+   * `features`. A scaled session takes `features: []` and the counterexample
+   * as a record of tagged values in `values`, which the session's scales
+   * project into attributes; the engine refuses a label list or an
+   * unreadable value there with `400`, and refuses `values` in a presence
+   * session.
    *
    * The exploration continues after an answered question and poses one
    * question for each pseudo-intent, so a session asks every implication of
@@ -49936,6 +49970,13 @@ var AnalysisClient = class {
    *   label: 'penguin',
    *   features: ['bird'],
    * });
+   * // In a scaled session:
+   * await client.analysis.refuteImplication(sessionId, {
+   *   questionId: question.questionId,
+   *   label: 'young cardholder',
+   *   features: [],
+   *   values: toTaggedFeatures({ age: 30, senior_card: true }),
+   * });
    * ```
    */
   async refuteImplication(sessionId, request, requestOptions) {