@kortexya/reasoninglayer 1.19.0 → 1.21.0

package/dist/index.cjs

@@ -7,7 +7,7 @@ var __export = (target, all) => {
 };
 
 // src/config.ts
-var SDK_VERSION = "1.19.0";
+var SDK_VERSION = "1.21.0";
 function resolveConfig(config) {
   if (!config.baseUrl) {
     throw new Error("ClientConfig.baseUrl is required");
@@ -3882,7 +3882,7 @@ var Communities = class {
     ...params
   });
   /**
-   * @description `GET /api/v1/graph/export?tenant_id=…&format=graphml|gexf|csv-nodes|csv-edges|dot` Read-only: returns the serialized graph as raw text with the matching content type. The graph is the same `Value::Reference` projection the analytics use, labelled by each term's `name` feature.
+   * @description `GET /api/v1/graph/export?format=graphml|gexf|csv-nodes|csv-edges|dot` Read-only: returns the serialized graph as raw text with the matching content type. The graph is the same `Value::Reference` projection the analytics use, labelled by each term's `name` feature.
    *
    * @tags communities
    * @name ExportGraph
@@ -3890,9 +3890,10 @@ var Communities = class {
    * @request GET:/api/v1/graph/export
    * @secure
    */
-  exportGraph = (params = {}) => this.http.request({
+  exportGraph = (query, params = {}) => this.http.request({
     path: `/api/v1/graph/export`,
     method: "GET",
+    query,
     secure: true,
     ...params
   });
@@ -5302,9 +5303,10 @@ var Reviews = class {
    * @request GET:/api/v1/reviews/pending
    * @secure
    */
-  listPendingReviews = (params = {}) => this.http.request({
+  listPendingReviews = (query, params = {}) => this.http.request({
     path: `/api/v1/reviews/pending`,
     method: "GET",
+    query,
     secure: true,
     format: "json",
     ...params
@@ -5853,9 +5855,10 @@ var ActionReviews = class {
    * @request GET:/api/v1/action-reviews/pending
    * @secure
    */
-  listPendingActionReviews = (params = {}) => this.http.request({
+  listPendingActionReviews = (query, params = {}) => this.http.request({
     path: `/api/v1/action-reviews/pending`,
     method: "GET",
+    query,
     secure: true,
     format: "json",
     ...params
@@ -12254,7 +12257,9 @@ function SortDtoFromApiToFront(dto) {
     description: dto.description ?? void 0,
     origin: dto.origin ? SortOriginDtoFromApiToFront(dto.origin) : void 0,
     status: dto.status ? SortStatusDtoFromApiToFront(dto.status) : void 0,
-    needsReview: dto.needs_review
+    needsReview: dto.needs_review,
+    pluginId: dto.plugin_id ?? void 0,
+    pluginLocalName: dto.plugin_local_name ?? void 0
   };
 }
 function SortInfoDtoFromApiToFront(dto) {
@@ -13385,8 +13390,9 @@ var TermsClient = class {
     return BulkAddTermsResponseFromApiToFront(response.data);
   }
   /**
-   * List all terms for the authenticated tenant.
+   * List terms for the authenticated tenant.
    *
+   * @param query - Optional paging and sort filter. Omit for every term.
    * @returns The list of terms with total count.
    * @throws {ApiError} If the request fails.
    *
@@ -13395,17 +13401,24 @@ var TermsClient = class {
    * Requires X-Tenant-Id header (set via client configuration).
    * Uses the tagged {@link ValueDto} serialization format.
    *
+   * `sortName` filters on the sort's committed name. For a plugin-contributed
+   * sort that is the namespaced form (`plugin:<plugin-name>:<local>`), which
+   * {@link SortDto.name} carries and {@link SortDto.pluginLocalName} maps back
+   * to the name its author wrote.
+   *
    * @example
    * ```typescript
    * const result = await client.terms.listTerms();
    * console.log(`Found ${result.count} terms`);
-   * for (const term of result.terms) {
-   *   console.log(term.id, term.sortName);
-   * }
+   *
+   * // Only the first page of one sort's terms.
+   * const page = await client.terms.listTerms({ sortName: 'person', limit: 50 });
    * ```
    */
-  async listTerms() {
-    const response = await this.api.listTerms();
+  async listTerms(query) {
+    const response = await this.api.listTerms(
+      query ? { limit: query.limit, offset: query.offset, sort_name: query.sortName } : void 0
+    );
     return TermListResponseFromApiToFront(response.data);
   }
   /**
@@ -20719,23 +20732,44 @@ var ReviewsClient = class {
     return response.data;
   }
   /**
-   * List all pending reviews for the authenticated tenant.
+   * List pending reviews for the authenticated tenant.
    *
+   * @param options - Optional filters and pagination. Omit to list the first
+   *   page of every pending review.
    * @returns List of pending review entries.
    * @throws {ApiError} If the request fails.
    *
    * @remarks
-   * `GET /api/v1/reviews/pending` no longer accepts a `tenant_id` query parameter:
-   * the tenant is taken from the authenticated principal (the `X-Tenant-Id` header the
-   * SDK already sends on every request), never from the caller.
+   * The tenant is taken from the authenticated principal (the `X-Tenant-Id`
+   * header the SDK sends on every request), never from the caller. The route
+   * still accepts a `tenant_id` query parameter for wire-compatibility but
+   * ignores it, so {@link ListPendingReviewsOptions} does not expose one.
    *
-   * @example
+   * Filters are sent as query parameters in wire `snake_case`; any option left
+   * `undefined` is omitted from the query string entirely, letting the backend
+   * apply its own default.
+   *
+   * @example List everything pending
    * ```typescript
    * const pending = await client.reviews.listPending();
    * ```
+   *
+   * @example Second page of low-confidence reviews
+   * ```typescript
+   * const page = await client.reviews.listPending({
+   *   reason: 'low_confidence',
+   *   page: 1,
+   *   pageSize: 25,
+   * });
+   * ```
    */
-  async listPending() {
-    const response = await this.api.listPendingReviews();
+  async listPending(options = {}) {
+    const response = await this.api.listPendingReviews({
+      sort: options.sort,
+      reason: options.reason,
+      page: options.page,
+      page_size: options.pageSize
+    });
     return response.data;
   }
   /**
@@ -23186,6 +23220,41 @@ var CommunitiesClient = class {
     const response = await this.api.predictLinks(LinkPredictionRequestFromFrontToApi(request));
     return LinkPredictionResponseFromApiToFront(response.data);
   }
+  /**
+   * Export the tenant's reference graph to a graph-interchange format.
+   *
+   * @param format - The interchange format to serialize to.
+   * @returns The serialized graph as raw text.
+   * @throws {ApiError} If the format is unknown (the backend answers 400).
+   *
+   * @remarks
+   * `format` is mandatory on the wire — a request without it is rejected with
+   * 400. Only the tenant of the authenticated principal is exported; the route
+   * accepts a `tenant_id` query parameter for wire-compatibility but ignores
+   * it, because trusting it allowed one tenant to export another's graph.
+   *
+   * The response is raw text, not JSON, and its content type varies by format
+   * (XML for `graphml` and `gexf`, CSV for the `csv-*` pair, Graphviz source
+   * for `dot`). The generated route class declares `void` because the OpenAPI
+   * spec omits the response schema, so this calls `http.request` directly with
+   * `format: 'text'` to read the body.
+   *
+   * @example
+   * ```typescript
+   * const dot = await client.communities.exportGraph('dot');
+   * const graphml = await client.communities.exportGraph('graphml');
+   * ```
+   */
+  async exportGraph(format) {
+    const response = await this.api.http.request({
+      path: "/api/v1/graph/export",
+      method: "GET",
+      query: { format },
+      secure: true,
+      format: "text"
+    });
+    return response.data;
+  }
 };
 
 // src/normalizers/utilities.ts
@@ -23943,10 +24012,35 @@ var ActionReviewsClient = class {
   /**
    * List pending action reviews.
    *
+   * @param options - Optional filters and pagination. Omit to list the first
+   *   page of pending action reviews.
    * @returns Paginated list of pending reviews.
+   * @throws {ApiError} If the request fails.
+   *
+   * @remarks
+   * The tenant is taken from the authenticated principal (the `X-Tenant-Id`
+   * header), never from the caller, so {@link ListActionReviewsOptions} exposes
+   * no `tenantId`. Filters are sent as query parameters in wire `snake_case`;
+   * any option left `undefined` is omitted, letting the backend default apply
+   * (`pendingOnly` defaults to `true`, `pageSize` to 50).
+   *
+   * @example Highest-risk actions awaiting a decision
+   * ```typescript
+   * const pending = await client.actionReviews.listPending({
+   *   reason: 'high_risk',
+   *   pageSize: 20,
+   * });
+   * ```
    */
-  async listPending() {
-    const response = await this.api.listPendingActionReviews();
+  async listPending(options = {}) {
+    const response = await this.api.listPendingActionReviews({
+      agent_id: options.agentId,
+      action_sort: options.actionSort,
+      reason: options.reason,
+      pending_only: options.pendingOnly,
+      page: options.page,
+      page_size: options.pageSize
+    });
     return ListActionReviewsResponseFromApiToFront(response.data);
   }
   /**
@@ -26943,7 +27037,8 @@ function ClearTenantResponseFromApiToFront(dto) {
     fingerprintsDeleted: dto.fingerprints_deleted,
     sortsDeleted: dto.sorts_deleted,
     inferenceStateCleared: dto.inference_state_cleared,
-    cacheInvalidated: dto.cache_invalidated
+    cacheInvalidated: dto.cache_invalidated,
+    pluginInstallsDeleted: dto.plugin_installs_deleted
   };
 }
 function TenantInfoFromApiToFront(dto) {
@@ -32325,13 +32420,17 @@ function InstallPluginResponseFromApiToFront(dto) {
     installId: dto.install_id,
     sortsAdded: dto.sorts_added,
     rulesAdded: dto.rules_added,
-    state: dto.state
+    state: dto.state,
+    degraded: dto.degraded,
+    degradation: dto.degradation ?? void 0
   };
 }
 function InstallStateFromApiToFront(dto) {
   return {
     installId: dto.install_id,
-    state: dto.state
+    state: dto.state,
+    degraded: dto.degraded,
+    degradation: dto.degradation ?? void 0
   };
 }
 function UpgradeInstallRequestFromFrontToApi(model) {
@@ -32355,7 +32454,9 @@ function InstallSummaryFromApiToFront(dto) {
     pluginId: dto.plugin_id,
     version: dto.version,
     state: dto.state,
-    systemWide: dto.system_wide
+    systemWide: dto.system_wide,
+    degraded: dto.degraded,
+    degradation: dto.degradation ?? void 0
   };
 }
 function InstallListFromApiToFront(dto) {