@kortexya/reasoninglayer 7.0.0 → 7.1.0

package/dist/index.js

@@ -5,7 +5,7 @@ var __export = (target, all) => {
 };
 
 // src/config.ts
-var SDK_VERSION = "7.0.0";
+var SDK_VERSION = "7.1.0";
 function resolveConfig(config) {
   if (!config.baseUrl) {
     throw new Error("ClientConfig.baseUrl is required");
@@ -9488,6 +9488,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
    *
@@ -16819,7 +16834,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
    */
@@ -16922,7 +16937,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
    */
@@ -20054,6 +20069,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 }],
@@ -20246,14 +20262,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: {
@@ -20368,12 +20386,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] } },
@@ -21916,6 +21934,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: {
@@ -23078,7 +23107,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: {
@@ -23270,6 +23308,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],
@@ -24199,6 +24246,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] }
   },
@@ -25983,6 +26042,7 @@ var RESPONSE_COMPONENTS = {
   SchemeViewDto: {
     object: {
       display_name: [1, 0],
+      documentation: [1, { array: "DocumentationRecordDto" }],
       languages: [1, { array: "SchemeLanguageViewDto" }],
       purpose: [1, 0],
       revision: [1, 0],
@@ -27640,7 +27700,7 @@ var RESPONSE_COMPONENTS = {
     }
   },
   WorldModelTransitionDto: { object: { probability: [1, 0] } },
-  XlLabelRecordDto: {
+  XlLabelViewDto: {
     object: {
       change_reason: [1, 0],
       concept: [1, 0],
@@ -27649,7 +27709,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] } }
@@ -29550,6 +29612,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}",
@@ -39121,6 +39188,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,
@@ -39189,6 +39268,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(
@@ -42103,6 +42210,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,
@@ -42200,6 +42315,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
   };
 }
@@ -71404,7 +71520,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;
@@ -71489,6 +71606,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),
@@ -71503,10 +71652,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
@@ -72113,7 +72262,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;