@kortexya/reasoninglayer 8.0.0 → 8.1.0

package/dist/index.cjs

@@ -7,7 +7,7 @@ var __export = (target, all) => {
 };
 
 // src/config.ts
-var SDK_VERSION = "8.0.0";
+var SDK_VERSION = "8.1.0";
 function resolveConfig(config) {
   if (!config.baseUrl) {
     throw new Error("ClientConfig.baseUrl is required");
@@ -16968,6 +16968,23 @@ var Vocabulary = class {
     format: "json",
     ...params
   });
+  /**
+   * No description
+   *
+   * @tags vocabulary
+   * @name LookupRecords
+   * @summary `GET /api/v1/vocabulary/records` — the records of one view with the ids asked (#632). A client names the few records a finding, a conflict or a list cites without reading a whole release or change set; the view is the cached release or candidate view, so a lookup costs the ids asked.
+   * @request GET:/api/v1/vocabulary/records
+   * @secure
+   */
+  lookupRecords = (query, params = {}) => this.http.request({
+    path: `/api/v1/vocabulary/records`,
+    method: "GET",
+    query,
+    secure: true,
+    format: "json",
+    ...params
+  });
   /**
    * No description
    *
@@ -17111,7 +17128,7 @@ var Vocabulary = class {
    *
    * @tags vocabulary
    * @name RevisionRecords
-   * @summary `GET /api/v1/vocabulary/revisions/{revision_id}/records` — the records the revision's cumulative change set inserts or replaces, by id, optionally of one kind (#628). The revision answer counts them; this read pages them.
+   * @summary `GET /api/v1/vocabulary/revisions/{revision_id}/records` — the records the revision's cumulative change set inserts or replaces, by id, optionally of one kind (#628). The revision answer counts them; this read pages them from the cached candidate view, so a page costs a page once the revision is indexed (#630).
    * @request GET:/api/v1/vocabulary/revisions/{revision_id}/records
    * @secure
    */
@@ -19590,6 +19607,7 @@ var RESPONSE_COMPONENTS = {
       created_by: [1, 0],
       minted_ids: [1, { object: {} }],
       outcome: [1, 0],
+      proposal_counts: [1, { object: {} }],
       record_counts: [1, { object: {} }],
       removals: [1, { array: 0 }],
       replayed: [1, 0],
@@ -25353,6 +25371,14 @@ var RESPONSE_COMPONENTS = {
   },
   RecordEpisodeResponse: { object: { episode_id: [1, 0], message: [1, 0] } },
   RecordFeatureChangeDto: { object: { feature: [1, 0] } },
+  RecordLookupResponse: {
+    object: {
+      context: [2, "ContextRefDto"],
+      items: [1, { array: 0 }],
+      missing: [1, { array: 0 }],
+      view: [1, "ViewRefDto"]
+    }
+  },
   RecordPageResponse: { object: { items: [1, { array: 0 }], release_id: [1, 0] } },
   RecordSafeHarborStatus: {
     object: {
@@ -30580,6 +30606,11 @@ var RESPONSE_OPERATIONS = {
     path: "/api/v1/workflows",
     responses: { 200: "WorkflowListResponse" }
   },
+  lookupRecords: {
+    method: "GET",
+    path: "/api/v1/vocabulary/records",
+    responses: { 200: "RecordLookupResponse" }
+  },
   markChoicePoint: {
     method: "POST",
     path: "/api/v1/execution/sessions/{session_id}/mark",
@@ -39307,14 +39338,16 @@ var NamespacesClient = class {
    *
    * @param namespaceId - Namespace UUID.
    * @param requestOptions - Per-call options (timeout, retries, signal, headers).
-   * @returns The counters of this engine process since `countedSince`.
+   * @returns The engine's durable counters for the namespace 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.
+   * @throws {ServiceUnavailableError} 503 when the namespace state, authority or savings storage is unavailable.
    *
    * @remarks
    * `GET /api/v1/namespaces/{id}/answer-cache-savings`. The counters are
-   * process-local and not durable; token savings are not measured
+   * durable and summed across engine processes and restarts; another
+   * process's counts arrive within its five-second write interval. Token
+   * savings are not measured
    * (`tokenUsageMeasured: false`). Response mapped from snake_case.
    *
    * @example
@@ -71821,6 +71854,7 @@ function VocabularyCandidateRevisionFromApiToFront(dto) {
     createdAt: dto.created_at,
     changeReason: dto.change_reason,
     recordCounts: dataMap(dto.record_counts),
+    proposalCounts: dataMap(dto.proposal_counts),
     removals: dto.removals,
     mintedIds: dataMap(dto.minted_ids),
     advisoryFindings: dto.advisory_findings.map(VocabularyFindingFromApiToFront),
@@ -72009,6 +72043,15 @@ function VocabularyRevisionRecordPageFromApiToFront(dto) {
   if (present(dto.next_cursor)) out.nextCursor = dto.next_cursor;
   return out;
 }
+function VocabularyRecordLookupFromApiToFront(dto) {
+  const out = {
+    view: ViewRefFromApiToFront(dto.view),
+    items: dto.items.map(VocabularyRecordViewFromApiToFront),
+    missing: dto.missing
+  };
+  if (present(dto.context)) out.context = VocabularyContextRefFromApiToFront(dto.context);
+  return out;
+}
 function VocabularyActivationResultFromApiToFront(dto) {
   const out = {
     releaseId: dto.release_id,
@@ -73145,13 +73188,16 @@ var VocabularyClient = class {
    *
    * @remarks
    * `GET /api/v1/vocabulary/revisions/{revision_id}`. The answer counts the
-   * records by kind (`recordCounts`); read the records with
-   * {@link VocabularyClient.listRevisionRecords}.
+   * records by kind (`recordCounts`) and the proposals among them
+   * (`proposalCounts`); read the records with
+   * {@link VocabularyClient.listRevisionRecords} or
+   * {@link VocabularyClient.lookupRecords}.
    *
    * @example
    * ```typescript
    * const revision = await client.vocabulary.getRevision(revisionId);
    * const conceptCount = revision.recordCounts['concept'] ?? 0;
+   * const toAccept = Object.values(revision.proposalCounts).reduce((n, c) => n + c, 0);
    * ```
    */
   async getRevision(revisionId, requestOptions) {
@@ -73185,6 +73231,40 @@ var VocabularyClient = class {
     const response = await this.api.revisionRecords(revisionId, wire, toRequestParams(requestOptions)).catch(rethrowVocabularyRefusal);
     return decodeResponse(response, VocabularyRevisionRecordPageFromApiToFront);
   }
+  /**
+   * The records of one view with the ids asked: what a client needs to name
+   * or open the few records a finding, a rebase conflict or a list cites,
+   * without reading a whole release or change set.
+   *
+   * @param ids - The record ids (UUIDs): 1 to 500 distinct ids.
+   * @param query - The view.
+   * @param requestOptions - Per-call options (timeout, retries, signal, headers).
+   * @returns The records the view holds, in the order asked and each once,
+   *   and the ids it does not hold.
+   * @throws {@link NotFoundError} 404 for an unknown release or revision.
+   * @throws {@link VocabularyRefusedError} 400 `invalid_request` (an id that is
+   *   not a UUID, no id, or more than 500); 409 `vocabulary_plugin_unavailable`.
+   *
+   * @remarks
+   * `GET /api/v1/vocabulary/records?ids&view&release_id&revision_id`. An id
+   * the candidate removes is `missing` in its candidate view. Duplicate ids
+   * are answered once.
+   *
+   * @example
+   * ```typescript
+   * const { items, missing } = await client.vocabulary.lookupRecords(finding.subjects, {
+   *   view: { view: 'candidate', revisionId },
+   * });
+   * ```
+   */
+  async lookupRecords(ids, query, requestOptions) {
+    const wire = {
+      ...viewQuery(query?.view),
+      ids: ids.join(",")
+    };
+    const response = await this.api.lookupRecords(wire, toRequestParams(requestOptions)).catch(rethrowVocabularyRefusal);
+    return decodeResponse(response, VocabularyRecordLookupFromApiToFront);
+  }
   /**
    * A revision against its baseline: records added, changed (with per-feature
    * before/after values) and removed.