@kortexya/reasoninglayer 7.0.0 → 7.2.0

package/dist/index.cjs

@@ -7,7 +7,7 @@ var __export = (target, all) => {
 };
 
 // src/config.ts
-var SDK_VERSION = "7.0.0";
+var SDK_VERSION = "7.2.0";
 function resolveConfig(config) {
   if (!config.baseUrl) {
     throw new Error("ClientConfig.baseUrl is required");
@@ -9490,6 +9490,21 @@ var Namespaces = class {
     format: "json",
     ...params
   });
+  /**
+   * No description
+   *
+   * @tags namespaces
+   * @name GetNamespaceAnswerCacheSavings
+   * @request GET:/api/v1/namespaces/{id}/answer-cache-savings
+   * @secure
+   */
+  getNamespaceAnswerCacheSavings = (id, params = {}) => this.http.request({
+    path: `/api/v1/namespaces/${id}/answer-cache-savings`,
+    method: "GET",
+    secure: true,
+    format: "json",
+    ...params
+  });
   /**
    * No description
    *
@@ -16821,7 +16836,7 @@ var Vocabulary = class {
    *
    * @tags vocabulary
    * @name GetVocabularyCollection
-   * @summary `GET /api/v1/vocabulary/collections/{collection_id}` — one collection with its labels, its member occurrences and its nested collections.
+   * @summary `GET /api/v1/vocabulary/collections/{collection_id}` — one collection with its labels, its member occurrences, its nested collections and its documentation notes.
    * @request GET:/api/v1/vocabulary/collections/{collection_id}
    * @secure
    */
@@ -16924,7 +16939,7 @@ var Vocabulary = class {
    *
    * @tags vocabulary
    * @name ListSchemes
-   * @summary `GET /api/v1/vocabulary/schemes` — the schemes of a view.
+   * @summary `GET /api/v1/vocabulary/schemes` — the schemes of a view, each with its languages and its documentation notes.
    * @request GET:/api/v1/vocabulary/schemes
    * @secure
    */
@@ -17877,7 +17892,8 @@ function FeatureDescriptorDtoFromApiToFront(dto) {
     minCount: dto.min_count ?? void 0,
     maxCount: dto.max_count ?? void 0,
     cardinalityOrigin: dto.cardinality_origin ?? void 0,
-    annotations: definedRecord2(dto.annotations)
+    annotations: definedRecord2(dto.annotations),
+    rangeConjunction: dto.range_conjunction
   };
 }
 function FeatureDescriptorDtoFromFrontToApi(model) {
@@ -20056,6 +20072,7 @@ var RESPONSE_COMPONENTS = {
     object: {
       collection: [1, "CollectionRecordDto"],
       context: [2, "ContextRefDto"],
+      documentation: [1, { array: "DocumentationRecordDto" }],
       labels: [1, { array: "CollectionLabelViewDto" }],
       members: [1, { array: "CollectionMemberViewDto" }],
       nested_collections: [1, { array: 0 }],
@@ -20248,14 +20265,16 @@ var RESPONSE_COMPONENTS = {
       term_versions: [1, { array: "TermVersionEntryDto" }]
     }
   },
-  ConceptMappingRecordDto: {
+  ConceptMappingViewDto: {
     object: {
       change_reason: [1, 0],
       mapping_kind: [1, 0],
       record_id: [1, 0],
       revision: [1, 0],
       status: [1, 0],
-      subject: [1, 0]
+      subject: [1, 0],
+      target_display_label: [2, "DisplayLabelDto"],
+      target_external_concept: [2, "ExternalConceptRecordDto"]
     }
   },
   ConceptMatchDto: {
@@ -20370,12 +20389,12 @@ var RESPONSE_COMPONENTS = {
       evidence: [1, { array: "EvidenceViewDto" }],
       identity_decisions: [1, { array: "IdentityDecisionRecordDto" }],
       labels: [1, { array: "LabelUseViewDto" }],
-      mappings: [1, { array: "ConceptMappingRecordDto" }],
+      mappings: [1, { array: "ConceptMappingViewDto" }],
       memberships: [1, { array: "MembershipViewDto" }],
       notations: [1, { array: "NotationRecordDto" }],
       relations: [1, { array: "ConceptRelationRecordDto" }],
       source_associations: [1, { array: "SourceAssociationRecordDto" }],
-      xl_labels: [1, { array: "XlLabelRecordDto" }]
+      xl_labels: [1, { array: "XlLabelViewDto" }]
     }
   },
   ConditionalIndependenceResponse: { object: { explanation: [1, 0], independent: [1, 0] } },
@@ -21429,7 +21448,8 @@ var RESPONSE_COMPONENTS = {
       relations_integrated: [1, 0],
       sort_names: [1, { array: 0 }],
       term_ids: [1, { array: 0 }],
-      total_tokens: [1, 0]
+      total_tokens: [1, 0],
+      work_cache: [2, "IngestionWorkCacheDto"]
     }
   },
   DocumentStatusCounts: {
@@ -21918,6 +21938,17 @@ var RESPONSE_COMPONENTS = {
       webhook_url: [1, 0]
     }
   },
+  ExternalConceptRecordDto: {
+    object: {
+      authority: [1, 0],
+      change_reason: [1, 0],
+      dataset_version: [1, 0],
+      iri: [1, 0],
+      record_id: [1, 0],
+      resolution: [1, 0],
+      revision: [1, 0]
+    }
+  },
   ExternalMatchDto: { object: { match_type: [1, 0], ontology_id: [1, 0], source: [1, 0] } },
   ExternalMatchProposalDto: {
     object: {
@@ -22042,6 +22073,7 @@ var RESPONSE_COMPONENTS = {
     object: {
       annotations: [0, { object: {} }],
       name: [1, 0],
+      range_conjunction: [0, { array: 0 }],
       declared_by: [1, { array: 0 }],
       signature: [1, 0]
     }
@@ -22149,7 +22181,13 @@ var RESPONSE_COMPONENTS = {
   },
   FeatureBindingDto: { object: { name: [1, 0], value: [1, 0] } },
   FeatureChangeDto: { object: { feature: [1, 0] } },
-  FeatureDescriptorDto: { object: { annotations: [0, { object: {} }], name: [1, 0] } },
+  FeatureDescriptorDto: {
+    object: {
+      annotations: [0, { object: {} }],
+      name: [1, 0],
+      range_conjunction: [0, { array: 0 }]
+    }
+  },
   FeatureDiff: { object: { change: [1, 0], feature: [1, 0] } },
   FeatureFilterDto: { object: { name: [1, 0], value: [1, 0] } },
   FeatureMismatchDto: {
@@ -23080,7 +23118,16 @@ var RESPONSE_COMPONENTS = {
       sorts_reused: [1, 0],
       sota_extraction_gate: [0, "SotaExtractionGateStatsDto"],
       term_ids: [1, { array: 0 }],
-      token_usage: [0, "TokenUsageDto"]
+      token_usage: [0, "TokenUsageDto"],
+      work_cache: [0, "IngestionWorkCacheDto"]
+    }
+  },
+  IngestionWorkCacheDto: {
+    object: {
+      model_calls: [1, 0],
+      reused_model_calls: [1, 0],
+      reused_recorded_token_usage: [1, "TokenUsageDto"],
+      unkeyed_model_calls: [1, 0]
     }
   },
   InheritedFeatureChangeDto: {
@@ -23272,6 +23319,15 @@ var RESPONSE_COMPONENTS = {
       wake_trigger: [1, 0]
     }
   },
+  LabelRelationViewDto: {
+    object: {
+      object: [1, 0],
+      record_id: [1, 0],
+      relation: [1, 0],
+      subject: [1, 0],
+      other_xl_label_id: [1, 0]
+    }
+  },
   LabelSearchHitDto: {
     object: {
       concept_id: [1, 0],
@@ -24201,6 +24257,18 @@ var RESPONSE_COMPONENTS = {
   NamespaceAnswerCachePolicyDto: {
     object: { enabled: [1, 0], revision: [1, 0], ttl_seconds: [1, 0] }
   },
+  NamespaceAnswerCacheSavingsDto: {
+    object: {
+      bypassed: [1, 0],
+      counted_since: [1, 0],
+      disabled: [1, 0],
+      fresh_model_calls: [1, 0],
+      reused_model_calls: [1, 0],
+      token_usage_measured: [1, 0],
+      unavailable: [1, 0],
+      unqualified: [1, 0]
+    }
+  },
   NamespaceDto: {
     object: { id: [1, 0], name: [1, 0], path: [1, 0], tags: [1, { array: 0 }], visibility: [1, 0] }
   },
@@ -25985,6 +26053,7 @@ var RESPONSE_COMPONENTS = {
   SchemeViewDto: {
     object: {
       display_name: [1, 0],
+      documentation: [1, { array: "DocumentationRecordDto" }],
       languages: [1, { array: "SchemeLanguageViewDto" }],
       purpose: [1, 0],
       revision: [1, 0],
@@ -27642,7 +27711,7 @@ var RESPONSE_COMPONENTS = {
     }
   },
   WorldModelTransitionDto: { object: { probability: [1, 0] } },
-  XlLabelRecordDto: {
+  XlLabelViewDto: {
     object: {
       change_reason: [1, 0],
       concept: [1, 0],
@@ -27651,7 +27720,9 @@ var RESPONSE_COMPONENTS = {
       resource_key: [1, 0],
       revision: [1, 0],
       role: [1, 0],
-      scheme: [1, 0]
+      scheme: [1, 0],
+      incoming_relations: [1, { array: "LabelRelationViewDto" }],
+      outgoing_relations: [1, { array: "LabelRelationViewDto" }]
     }
   },
   YankResponse: { object: { plugin_id: [1, 0], yanked: [1, 0] } }
@@ -29552,6 +29623,11 @@ var RESPONSE_OPERATIONS = {
     path: "/api/v1/namespaces/{id}/answer-cache-policy",
     responses: { 200: "NamespaceAnswerCachePolicyDto" }
   },
+  getNamespaceAnswerCacheSavings: {
+    method: "GET",
+    path: "/api/v1/namespaces/{id}/answer-cache-savings",
+    responses: { 200: "NamespaceAnswerCacheSavingsDto" }
+  },
   getNamespaceByPath: {
     method: "GET",
     path: "/api/v1/namespaces/path/{tenant_id}/{path}",
@@ -39123,6 +39199,18 @@ function NamespaceListResponseFromApiToFront(dto) {
 function UpdateNamespaceAnswerCachePolicyRequestFromFrontToApi(model) {
   return { enabled: model.enabled, ttl_seconds: model.ttlSeconds };
 }
+function NamespaceAnswerCacheSavingsDtoFromApiToFront(dto) {
+  return {
+    countedSince: dto.counted_since,
+    freshModelCalls: dto.fresh_model_calls,
+    reusedModelCalls: dto.reused_model_calls,
+    bypassed: dto.bypassed,
+    disabled: dto.disabled,
+    unavailable: dto.unavailable,
+    unqualified: dto.unqualified,
+    tokenUsageMeasured: dto.token_usage_measured
+  };
+}
 function NamespaceAnswerCachePolicyDtoFromApiToFront(dto) {
   return {
     enabled: dto.enabled,
@@ -39191,6 +39279,34 @@ var NamespacesClient = class {
     );
     return decodeResponse(response, NamespaceAnswerCachePolicyDtoFromApiToFront);
   }
+  /**
+   * Read the answer-cache outcomes the engine counted for a namespace.
+   *
+   * @param namespaceId - Namespace UUID.
+   * @param requestOptions - Per-call options (timeout, retries, signal, headers).
+   * @returns The counters of this engine process since `countedSince`.
+   * @throws {ForbiddenError} 403 without a native `manage_answer_cache` grant.
+   * @throws {NotFoundError} 404 for a namespace not in this tenant.
+   * @throws {ServiceUnavailableError} 503 when the namespace state or authority is unavailable.
+   *
+   * @remarks
+   * `GET /api/v1/namespaces/{id}/answer-cache-savings`. The counters are
+   * process-local and not durable; token savings are not measured
+   * (`tokenUsageMeasured: false`). Response mapped from snake_case.
+   *
+   * @example
+   * ```typescript
+   * const savings = await client.namespaces.getAnswerCacheSavings(namespaceId);
+   * console.log(savings.reusedModelCalls, 'of', savings.freshModelCalls + savings.reusedModelCalls);
+   * ```
+   */
+  async getAnswerCacheSavings(namespaceId, requestOptions) {
+    const response = await this.api.getNamespaceAnswerCacheSavings(
+      namespaceId,
+      toRequestParams(requestOptions)
+    );
+    return decodeResponse(response, NamespaceAnswerCacheSavingsDtoFromApiToFront);
+  }
   /** Save settings in OSFKB; policy validation and cache admission stay in the engine. */
   async updateAnswerCachePolicy(namespaceId, request, requestOptions) {
     const response = await this.api.updateNamespaceAnswerCachePolicy(
@@ -42105,6 +42221,14 @@ function TokenUsageDtoFromApiToFront(dto) {
     totalTokens: dto.total_tokens
   };
 }
+function IngestionWorkCacheDtoFromApiToFront(dto) {
+  return {
+    modelCalls: dto.model_calls,
+    reusedModelCalls: dto.reused_model_calls,
+    unkeyedModelCalls: dto.unkeyed_model_calls,
+    reusedRecordedTokenUsage: TokenUsageDtoFromApiToFront(dto.reused_recorded_token_usage)
+  };
+}
 function AlignmentStatsDtoFromApiToFront(dto) {
   return {
     avgFuzzyRatio: dto.avg_fuzzy_ratio,
@@ -42202,6 +42326,7 @@ function IngestionStatsDtoFromApiToFront(dto) {
     sotaExtractionGate: dto.sota_extraction_gate ? SotaExtractionGateStatsDtoFromApiToFront(dto.sota_extraction_gate) : void 0,
     termIds: dto.term_ids,
     tokenUsage: dto.token_usage ? TokenUsageDtoFromApiToFront(dto.token_usage) : void 0,
+    workCache: dto.work_cache ? IngestionWorkCacheDtoFromApiToFront(dto.work_cache) : void 0,
     fcaDiscovery: dto.fca_discovery ? FcaIngestionReportFromApiToFront(dto.fca_discovery) : void 0
   };
 }
@@ -42614,7 +42739,8 @@ function DocumentStatsDtoFromApiToFront(dto) {
     sortNames: dto.sort_names,
     termIds: dto.term_ids,
     totalTokens: dto.total_tokens,
-    fcaDiscovery: dto.fca_discovery ? FcaIngestionReportFromApiToFront(dto.fca_discovery) : void 0
+    fcaDiscovery: dto.fca_discovery ? FcaIngestionReportFromApiToFront(dto.fca_discovery) : void 0,
+    workCache: dto.work_cache ? IngestionWorkCacheDtoFromApiToFront(dto.work_cache) : void 0
   };
 }
 function SessionStatsResponseFromApiToFront(dto) {
@@ -51139,8 +51265,7 @@ var AnalysisClient = class {
    *   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
+   * @throws {BadRequestError} 400 for an unknown sort name, native-predicate
    *   semantics, or a scaled interpretation that is not complete.
    *
    * @remarks
@@ -51275,8 +51400,8 @@ var AnalysisClient = class {
    *
    * @param sessionId - Exploration session ID.
    * @param request - The bounds of this search step (`maxWork`,
-   *   `maxCandidates`, `searchTimeoutMs`); each omitted bound takes the
-   *   engine default.
+   *   `maxCandidates`, `searchTimeoutMs`); an omitted or `null` bound is
+   *   unbounded.
    * @param requestOptions - Per-call request options.
    * @returns The next question (absent when the search stopped again or was
    *   exhausted), the progress, and the search report.
@@ -71406,7 +71531,8 @@ function SchemeViewFromApiToFront(dto) {
     revision: dto.revision,
     displayName: dto.display_name,
     purpose: dto.purpose,
-    languages: dto.languages.map(SchemeLanguageViewFromApiToFront)
+    languages: dto.languages.map(SchemeLanguageViewFromApiToFront),
+    documentation: dto.documentation.map(VocabularyDocumentationRecordFromApiToFront)
   };
   if (present(dto.scope_note)) out.scopeNote = dto.scope_note;
   if (present(dto.exclusions)) out.exclusions = dto.exclusions;
@@ -71491,6 +71617,38 @@ function DefinitionGuidanceFromApiToFront(dto) {
     parentEdgeCreated: dto.parent_edge_created
   };
 }
+function LabelRelationViewFromApiToFront(dto) {
+  const out = {
+    ...VocabularyLabelRelationRecordFromApiToFront(dto),
+    otherXlLabelId: dto.other_xl_label_id
+  };
+  if (present(dto.other_resource_key)) out.otherResourceKey = dto.other_resource_key;
+  if (present(dto.other_text)) out.otherText = dto.other_text;
+  if (present(dto.other_language)) out.otherLanguage = dto.other_language;
+  return out;
+}
+function XlLabelViewFromApiToFront(dto) {
+  const out = {
+    ...VocabularyXlLabelRecordFromApiToFront(dto),
+    outgoingRelations: dto.outgoing_relations.map(LabelRelationViewFromApiToFront),
+    incomingRelations: dto.incoming_relations.map(LabelRelationViewFromApiToFront)
+  };
+  if (present(dto.text)) out.text = dto.text;
+  if (present(dto.language)) out.language = dto.language;
+  return out;
+}
+function ConceptMappingViewFromApiToFront(dto) {
+  const out = VocabularyConceptMappingRecordFromApiToFront(dto);
+  if (present(dto.target_external_concept)) {
+    out.targetExternalConcept = VocabularyExternalConceptRecordFromApiToFront(
+      dto.target_external_concept
+    );
+  }
+  if (present(dto.target_display_label)) {
+    out.targetDisplayLabel = VocabularyDisplayLabelFromApiToFront(dto.target_display_label);
+  }
+  return out;
+}
 function ConceptViewFromApiToFront(dto) {
   const out = {
     concept: VocabularyConceptRecordFromApiToFront(dto.concept),
@@ -71505,10 +71663,10 @@ function ConceptViewFromApiToFront(dto) {
     ),
     aboutness: dto.aboutness.map(VocabularyAboutnessRecordFromApiToFront),
     relations: dto.relations.map(VocabularyConceptRelationRecordFromApiToFront),
-    mappings: dto.mappings.map(VocabularyConceptMappingRecordFromApiToFront),
+    mappings: dto.mappings.map(ConceptMappingViewFromApiToFront),
     documentation: dto.documentation.map(VocabularyDocumentationRecordFromApiToFront),
     notations: dto.notations.map(VocabularyNotationRecordFromApiToFront),
-    xlLabels: dto.xl_labels.map(VocabularyXlLabelRecordFromApiToFront),
+    xlLabels: dto.xl_labels.map(XlLabelViewFromApiToFront),
     collections: dto.collections,
     sourceAssociations: dto.source_associations.map(
       VocabularySourceAssociationRecordFromApiToFront
@@ -72115,7 +72273,8 @@ function VocabularyCollectionDetailFromApiToFront(dto) {
     collection: VocabularyCollectionRecordFromApiToFront(dto.collection),
     labels: dto.labels.map(CollectionLabelViewFromApiToFront),
     members: dto.members.map(CollectionMemberViewFromApiToFront),
-    nestedCollections: dto.nested_collections
+    nestedCollections: dto.nested_collections,
+    documentation: dto.documentation.map(VocabularyDocumentationRecordFromApiToFront)
   };
   if (present(dto.context)) out.context = VocabularyContextRefFromApiToFront(dto.context);
   return out;