@knowledge-stack/ksapi 2.12.0 → 2.12.1

package/.openapi-generator/FILES

@@ -293,6 +293,7 @@ docs/RunTimeseriesResponse.md
 docs/SSOInitiateResponse.md
 docs/ScheduleCadence.md
 docs/ScoredChunkResponse.md
+docs/SearchItemsResponse.md
 docs/SearchSkillsRequest.md
 docs/SearchSkillsResponse.md
 docs/SearchSortOrder.md
@@ -748,6 +749,7 @@ src/models/RunTimeseriesResponse.ts
 src/models/SSOInitiateResponse.ts
 src/models/ScheduleCadence.ts
 src/models/ScoredChunkResponse.ts
+src/models/SearchItemsResponse.ts
 src/models/SearchSkillsRequest.ts
 src/models/SearchSkillsResponse.ts
 src/models/SearchSortOrder.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@2.12.0
+# @knowledge-stack/ksapi@2.12.1
 
 A TypeScript SDK client for the localhost API.
 
@@ -570,6 +570,7 @@ All URIs are relative to *http://localhost:8000*
 - [SSOInitiateResponse](docs/SSOInitiateResponse.md)
 - [ScheduleCadence](docs/ScheduleCadence.md)
 - [ScoredChunkResponse](docs/ScoredChunkResponse.md)
+- [SearchItemsResponse](docs/SearchItemsResponse.md)
 - [SearchSkillsRequest](docs/SearchSkillsRequest.md)
 - [SearchSkillsResponse](docs/SearchSkillsResponse.md)
 - [SearchSortOrder](docs/SearchSortOrder.md)
@@ -724,7 +725,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `2.12.0`
+- Package version: `2.12.1`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/FoldersApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { ContentsSortOrder, CreateFolderRequest, FolderAction, FolderActionResponse, FolderResponse, PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat, PaginatedResponseFolderResponse, PathOrder, PathPartApprovalState, SearchSortOrder, SearchablePartType, SortDirection, UpdateFolderRequest } from '../models/index';
+import type { ContentsSortOrder, CreateFolderRequest, FolderAction, FolderActionResponse, FolderResponse, PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat, PaginatedResponseFolderResponse, PathOrder, PathPartApprovalState, SearchItemsResponse, SearchSortOrder, SearchablePartType, SortDirection, UpdateFolderRequest } from '../models/index';
 export interface CreateFolderOperationRequest {
     createFolderRequest: CreateFolderRequest;
 }
@@ -58,8 +58,8 @@ export interface ListFoldersRequest {
 }
 export interface SearchItemsRequest {
     nameLike: string;
+    partType?: Array<SearchablePartType>;
     sortOrder?: SearchSortOrder;
-    partType?: SearchablePartType;
     withTags?: boolean;
     parentPathPartId?: string | null;
     limit?: number;
@@ -258,8 +258,8 @@ export interface FoldersApiInterface {
     /**
      * Creates request options for searchItems without sending the request
      * @param {string} nameLike Case-insensitive partial name search
-     * @param {SearchSortOrder} [sortOrder] Sort order for results (default: NAME)
-     * @param {SearchablePartType} [partType] Filter by item type (default: all searchable types)
+     * @param {Array<SearchablePartType>} [partType] Filter by item type; repeat the parameter to select several (default: all searchable types)
+     * @param {SearchSortOrder} [sortOrder] Sort order for results (default: RELEVANCE)
      * @param {boolean} [withTags] Include tags in the response (default: false)
      * @param {string} [parentPathPartId] Scope search to descendants of this folder\&#39;s path part
      * @param {number} [limit] Number of items per page
@@ -272,8 +272,8 @@ export interface FoldersApiInterface {
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * @summary Search Items Handler
      * @param {string} nameLike Case-insensitive partial name search
-     * @param {SearchSortOrder} [sortOrder] Sort order for results (default: NAME)
-     * @param {SearchablePartType} [partType] Filter by item type (default: all searchable types)
+     * @param {Array<SearchablePartType>} [partType] Filter by item type; repeat the parameter to select several (default: all searchable types)
+     * @param {SearchSortOrder} [sortOrder] Sort order for results (default: RELEVANCE)
      * @param {boolean} [withTags] Include tags in the response (default: false)
      * @param {string} [parentPathPartId] Scope search to descendants of this folder\&#39;s path part
      * @param {number} [limit] Number of items per page
@@ -282,12 +282,12 @@ export interface FoldersApiInterface {
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
      */
-    searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat>>;
+    searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SearchItemsResponse>>;
     /**
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat>;
+    searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SearchItemsResponse>;
     /**
      * Creates request options for updateFolder without sending the request
      * @param {string} folderId
@@ -406,12 +406,12 @@ export declare class FoldersApi extends runtime.BaseAPI implements FoldersApiInt
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat>>;
+    searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SearchItemsResponse>>;
     /**
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat>;
+    searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SearchItemsResponse>;
     /**
      * Creates request options for updateFolder without sending the request
      */

package/dist/apis/FoldersApi.js

@@ -443,12 +443,12 @@ class FoldersApi extends runtime.BaseAPI {
             if (requestParameters['nameLike'] != null) {
                 queryParameters['name_like'] = requestParameters['nameLike'];
             }
-            if (requestParameters['sortOrder'] != null) {
-                queryParameters['sort_order'] = requestParameters['sortOrder'];
-            }
             if (requestParameters['partType'] != null) {
                 queryParameters['part_type'] = requestParameters['partType'];
             }
+            if (requestParameters['sortOrder'] != null) {
+                queryParameters['sort_order'] = requestParameters['sortOrder'];
+            }
             if (requestParameters['withTags'] != null) {
                 queryParameters['with_tags'] = requestParameters['withTags'];
             }
@@ -486,7 +486,7 @@ class FoldersApi extends runtime.BaseAPI {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.searchItemsRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDatFromJSON)(jsonValue));
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.SearchItemsResponseFromJSON)(jsonValue));
         });
     }
     /**

package/dist/esm/apis/FoldersApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { ContentsSortOrder, CreateFolderRequest, FolderAction, FolderActionResponse, FolderResponse, PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat, PaginatedResponseFolderResponse, PathOrder, PathPartApprovalState, SearchSortOrder, SearchablePartType, SortDirection, UpdateFolderRequest } from '../models/index';
+import type { ContentsSortOrder, CreateFolderRequest, FolderAction, FolderActionResponse, FolderResponse, PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat, PaginatedResponseFolderResponse, PathOrder, PathPartApprovalState, SearchItemsResponse, SearchSortOrder, SearchablePartType, SortDirection, UpdateFolderRequest } from '../models/index';
 export interface CreateFolderOperationRequest {
     createFolderRequest: CreateFolderRequest;
 }
@@ -58,8 +58,8 @@ export interface ListFoldersRequest {
 }
 export interface SearchItemsRequest {
     nameLike: string;
+    partType?: Array<SearchablePartType>;
     sortOrder?: SearchSortOrder;
-    partType?: SearchablePartType;
     withTags?: boolean;
     parentPathPartId?: string | null;
     limit?: number;
@@ -258,8 +258,8 @@ export interface FoldersApiInterface {
     /**
      * Creates request options for searchItems without sending the request
      * @param {string} nameLike Case-insensitive partial name search
-     * @param {SearchSortOrder} [sortOrder] Sort order for results (default: NAME)
-     * @param {SearchablePartType} [partType] Filter by item type (default: all searchable types)
+     * @param {Array<SearchablePartType>} [partType] Filter by item type; repeat the parameter to select several (default: all searchable types)
+     * @param {SearchSortOrder} [sortOrder] Sort order for results (default: RELEVANCE)
      * @param {boolean} [withTags] Include tags in the response (default: false)
      * @param {string} [parentPathPartId] Scope search to descendants of this folder\&#39;s path part
      * @param {number} [limit] Number of items per page
@@ -272,8 +272,8 @@ export interface FoldersApiInterface {
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * @summary Search Items Handler
      * @param {string} nameLike Case-insensitive partial name search
-     * @param {SearchSortOrder} [sortOrder] Sort order for results (default: NAME)
-     * @param {SearchablePartType} [partType] Filter by item type (default: all searchable types)
+     * @param {Array<SearchablePartType>} [partType] Filter by item type; repeat the parameter to select several (default: all searchable types)
+     * @param {SearchSortOrder} [sortOrder] Sort order for results (default: RELEVANCE)
      * @param {boolean} [withTags] Include tags in the response (default: false)
      * @param {string} [parentPathPartId] Scope search to descendants of this folder\&#39;s path part
      * @param {number} [limit] Number of items per page
@@ -282,12 +282,12 @@ export interface FoldersApiInterface {
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
      */
-    searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat>>;
+    searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SearchItemsResponse>>;
     /**
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat>;
+    searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SearchItemsResponse>;
     /**
      * Creates request options for updateFolder without sending the request
      * @param {string} folderId
@@ -406,12 +406,12 @@ export declare class FoldersApi extends runtime.BaseAPI implements FoldersApiInt
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat>>;
+    searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SearchItemsResponse>>;
     /**
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat>;
+    searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SearchItemsResponse>;
     /**
      * Creates request options for updateFolder without sending the request
      */

package/dist/esm/apis/FoldersApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { CreateFolderRequestToJSON, FolderActionResponseFromJSON, FolderResponseFromJSON, PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDatFromJSON, PaginatedResponseFolderResponseFromJSON, UpdateFolderRequestToJSON, } from '../models/index';
+import { CreateFolderRequestToJSON, FolderActionResponseFromJSON, FolderResponseFromJSON, PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDatFromJSON, PaginatedResponseFolderResponseFromJSON, SearchItemsResponseFromJSON, UpdateFolderRequestToJSON, } from '../models/index';
 /**
  *
  */
@@ -407,12 +407,12 @@ export class FoldersApi extends runtime.BaseAPI {
             if (requestParameters['nameLike'] != null) {
                 queryParameters['name_like'] = requestParameters['nameLike'];
             }
-            if (requestParameters['sortOrder'] != null) {
-                queryParameters['sort_order'] = requestParameters['sortOrder'];
-            }
             if (requestParameters['partType'] != null) {
                 queryParameters['part_type'] = requestParameters['partType'];
             }
+            if (requestParameters['sortOrder'] != null) {
+                queryParameters['sort_order'] = requestParameters['sortOrder'];
+            }
             if (requestParameters['withTags'] != null) {
                 queryParameters['with_tags'] = requestParameters['withTags'];
             }
@@ -450,7 +450,7 @@ export class FoldersApi extends runtime.BaseAPI {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.searchItemsRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDatFromJSON(jsonValue));
+            return new runtime.JSONApiResponse(response, (jsonValue) => SearchItemsResponseFromJSON(jsonValue));
         });
     }
     /**

package/dist/esm/models/SearchItemsResponse.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR } from './FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR';
+/**
+ * A search page plus how many items of each type the query matched.
+ *
+ * ``counts_by_type`` ignores any ``part_type`` filter so the filter chips can
+ * keep showing every type's count while one of them is selected.
+ * @export
+ * @interface SearchItemsResponse
+ */
+export interface SearchItemsResponse {
+    /**
+     * List of items
+     * @type {Array<FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR>}
+     * @memberof SearchItemsResponse
+     */
+    items: Array<FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR>;
+    /**
+     * Total number of items
+     * @type {number}
+     * @memberof SearchItemsResponse
+     */
+    total: number;
+    /**
+     * Number of items per page
+     * @type {number}
+     * @memberof SearchItemsResponse
+     */
+    limit: number;
+    /**
+     * Number of items to skip
+     * @type {number}
+     * @memberof SearchItemsResponse
+     */
+    offset: number;
+    /**
+     * Matches per item type, keyed by SearchablePartType and unaffected by the part_type filter
+     * @type {{ [key: string]: number; }}
+     * @memberof SearchItemsResponse
+     */
+    countsByType?: {
+        [key: string]: number;
+    };
+}
+export declare const SearchItemsResponsePropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};
+/**
+ * Check if a given object implements the SearchItemsResponse interface.
+ */
+export declare function instanceOfSearchItemsResponse(value: object): value is SearchItemsResponse;
+export declare function SearchItemsResponseFromJSON(json: any): SearchItemsResponse;
+export declare function SearchItemsResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): SearchItemsResponse;
+export declare function SearchItemsResponseToJSON(json: any): SearchItemsResponse;
+export declare function SearchItemsResponseToJSONTyped(value?: SearchItemsResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/SearchItemsResponse.js

@@ -0,0 +1,72 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import { FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSON, FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSON, } from './FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR';
+export const SearchItemsResponsePropertyValidationAttributesMap = {
+    total: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+    limit: {
+        minimum: 1,
+        exclusiveMinimum: false,
+    },
+    offset: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+};
+/**
+ * Check if a given object implements the SearchItemsResponse interface.
+ */
+export function instanceOfSearchItemsResponse(value) {
+    if (!('items' in value) || value['items'] === undefined)
+        return false;
+    if (!('total' in value) || value['total'] === undefined)
+        return false;
+    if (!('limit' in value) || value['limit'] === undefined)
+        return false;
+    if (!('offset' in value) || value['offset'] === undefined)
+        return false;
+    return true;
+}
+export function SearchItemsResponseFromJSON(json) {
+    return SearchItemsResponseFromJSONTyped(json, false);
+}
+export function SearchItemsResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'items': (json['items'].map(FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSON)),
+        'total': json['total'],
+        'limit': json['limit'],
+        'offset': json['offset'],
+        'countsByType': json['counts_by_type'] == null ? undefined : json['counts_by_type'],
+    };
+}
+export function SearchItemsResponseToJSON(json) {
+    return SearchItemsResponseToJSONTyped(json, false);
+}
+export function SearchItemsResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'items': (value['items'].map(FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSON)),
+        'total': value['total'],
+        'limit': value['limit'],
+        'offset': value['offset'],
+        'counts_by_type': value['countsByType'],
+    };
+}

package/dist/esm/models/SearchSortOrder.d.ts

@@ -10,10 +10,15 @@
  * Do not edit the class manually.
  */
 /**
- * Sort order options for search results.
+ * Ordering for flat name search.
+ *
+ * RELEVANCE ranks an exact name match first, then names starting with the
+ * query, then by how closely the name matches, then shorter names, then
+ * alphabetically.
  * @export
  */
 export declare const SearchSortOrder: {
+    readonly Relevance: 'RELEVANCE';
     readonly Name: 'NAME';
     readonly UpdatedAt: 'UPDATED_AT';
     readonly CreatedAt: 'CREATED_AT';

package/dist/esm/models/SearchSortOrder.js

@@ -12,10 +12,15 @@
  * Do not edit the class manually.
  */
 /**
- * Sort order options for search results.
+ * Ordering for flat name search.
+ *
+ * RELEVANCE ranks an exact name match first, then names starting with the
+ * query, then by how closely the name matches, then shorter names, then
+ * alphabetically.
  * @export
  */
 export const SearchSortOrder = {
+    Relevance: 'RELEVANCE',
     Name: 'NAME',
     UpdatedAt: 'UPDATED_AT',
     CreatedAt: 'CREATED_AT'

package/dist/esm/models/SearchablePartType.d.ts

@@ -22,6 +22,7 @@ export declare const SearchablePartType: {
     readonly DataSourceSchema: 'DATA_SOURCE_SCHEMA';
     readonly DataSourceTable: 'DATA_SOURCE_TABLE';
     readonly ApiConnection: 'API_CONNECTION';
+    readonly Skill: 'SKILL';
 };
 export type SearchablePartType = typeof SearchablePartType[keyof typeof SearchablePartType];
 export declare function instanceOfSearchablePartType(value: any): boolean;

package/dist/esm/models/SearchablePartType.js

@@ -23,7 +23,8 @@ export const SearchablePartType = {
     DataSource: 'DATA_SOURCE',
     DataSourceSchema: 'DATA_SOURCE_SCHEMA',
     DataSourceTable: 'DATA_SOURCE_TABLE',
-    ApiConnection: 'API_CONNECTION'
+    ApiConnection: 'API_CONNECTION',
+    Skill: 'SKILL'
 };
 export function instanceOfSearchablePartType(value) {
     for (const key in SearchablePartType) {

package/dist/esm/models/index.d.ts

@@ -263,6 +263,7 @@ export * from './RunTimeseriesResponse';
 export * from './SSOInitiateResponse';
 export * from './ScheduleCadence';
 export * from './ScoredChunkResponse';
+export * from './SearchItemsResponse';
 export * from './SearchSkillsRequest';
 export * from './SearchSkillsResponse';
 export * from './SearchSortOrder';

package/dist/esm/models/index.js

@@ -265,6 +265,7 @@ export * from './RunTimeseriesResponse';
 export * from './SSOInitiateResponse';
 export * from './ScheduleCadence';
 export * from './ScoredChunkResponse';
+export * from './SearchItemsResponse';
 export * from './SearchSkillsRequest';
 export * from './SearchSkillsResponse';
 export * from './SearchSortOrder';

package/dist/models/SearchItemsResponse.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR } from './FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR';
+/**
+ * A search page plus how many items of each type the query matched.
+ *
+ * ``counts_by_type`` ignores any ``part_type`` filter so the filter chips can
+ * keep showing every type's count while one of them is selected.
+ * @export
+ * @interface SearchItemsResponse
+ */
+export interface SearchItemsResponse {
+    /**
+     * List of items
+     * @type {Array<FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR>}
+     * @memberof SearchItemsResponse
+     */
+    items: Array<FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR>;
+    /**
+     * Total number of items
+     * @type {number}
+     * @memberof SearchItemsResponse
+     */
+    total: number;
+    /**
+     * Number of items per page
+     * @type {number}
+     * @memberof SearchItemsResponse
+     */
+    limit: number;
+    /**
+     * Number of items to skip
+     * @type {number}
+     * @memberof SearchItemsResponse
+     */
+    offset: number;
+    /**
+     * Matches per item type, keyed by SearchablePartType and unaffected by the part_type filter
+     * @type {{ [key: string]: number; }}
+     * @memberof SearchItemsResponse
+     */
+    countsByType?: {
+        [key: string]: number;
+    };
+}
+export declare const SearchItemsResponsePropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};
+/**
+ * Check if a given object implements the SearchItemsResponse interface.
+ */
+export declare function instanceOfSearchItemsResponse(value: object): value is SearchItemsResponse;
+export declare function SearchItemsResponseFromJSON(json: any): SearchItemsResponse;
+export declare function SearchItemsResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): SearchItemsResponse;
+export declare function SearchItemsResponseToJSON(json: any): SearchItemsResponse;
+export declare function SearchItemsResponseToJSONTyped(value?: SearchItemsResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/models/SearchItemsResponse.js

@@ -0,0 +1,80 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchItemsResponsePropertyValidationAttributesMap = void 0;
+exports.instanceOfSearchItemsResponse = instanceOfSearchItemsResponse;
+exports.SearchItemsResponseFromJSON = SearchItemsResponseFromJSON;
+exports.SearchItemsResponseFromJSONTyped = SearchItemsResponseFromJSONTyped;
+exports.SearchItemsResponseToJSON = SearchItemsResponseToJSON;
+exports.SearchItemsResponseToJSONTyped = SearchItemsResponseToJSONTyped;
+const FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR_1 = require("./FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR");
+exports.SearchItemsResponsePropertyValidationAttributesMap = {
+    total: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+    limit: {
+        minimum: 1,
+        exclusiveMinimum: false,
+    },
+    offset: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+};
+/**
+ * Check if a given object implements the SearchItemsResponse interface.
+ */
+function instanceOfSearchItemsResponse(value) {
+    if (!('items' in value) || value['items'] === undefined)
+        return false;
+    if (!('total' in value) || value['total'] === undefined)
+        return false;
+    if (!('limit' in value) || value['limit'] === undefined)
+        return false;
+    if (!('offset' in value) || value['offset'] === undefined)
+        return false;
+    return true;
+}
+function SearchItemsResponseFromJSON(json) {
+    return SearchItemsResponseFromJSONTyped(json, false);
+}
+function SearchItemsResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'items': (json['items'].map(FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR_1.FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSON)),
+        'total': json['total'],
+        'limit': json['limit'],
+        'offset': json['offset'],
+        'countsByType': json['counts_by_type'] == null ? undefined : json['counts_by_type'],
+    };
+}
+function SearchItemsResponseToJSON(json) {
+    return SearchItemsResponseToJSONTyped(json, false);
+}
+function SearchItemsResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'items': (value['items'].map(FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR_1.FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSON)),
+        'total': value['total'],
+        'limit': value['limit'],
+        'offset': value['offset'],
+        'counts_by_type': value['countsByType'],
+    };
+}

package/dist/models/SearchSortOrder.d.ts

@@ -10,10 +10,15 @@
  * Do not edit the class manually.
  */
 /**
- * Sort order options for search results.
+ * Ordering for flat name search.
+ *
+ * RELEVANCE ranks an exact name match first, then names starting with the
+ * query, then by how closely the name matches, then shorter names, then
+ * alphabetically.
  * @export
  */
 export declare const SearchSortOrder: {
+    readonly Relevance: 'RELEVANCE';
     readonly Name: 'NAME';
     readonly UpdatedAt: 'UPDATED_AT';
     readonly CreatedAt: 'CREATED_AT';

package/dist/models/SearchSortOrder.js

@@ -20,10 +20,15 @@ exports.SearchSortOrderFromJSONTyped = SearchSortOrderFromJSONTyped;
 exports.SearchSortOrderToJSON = SearchSortOrderToJSON;
 exports.SearchSortOrderToJSONTyped = SearchSortOrderToJSONTyped;
 /**
- * Sort order options for search results.
+ * Ordering for flat name search.
+ *
+ * RELEVANCE ranks an exact name match first, then names starting with the
+ * query, then by how closely the name matches, then shorter names, then
+ * alphabetically.
  * @export
  */
 exports.SearchSortOrder = {
+    Relevance: 'RELEVANCE',
     Name: 'NAME',
     UpdatedAt: 'UPDATED_AT',
     CreatedAt: 'CREATED_AT'

package/dist/models/SearchablePartType.d.ts

@@ -22,6 +22,7 @@ export declare const SearchablePartType: {
     readonly DataSourceSchema: 'DATA_SOURCE_SCHEMA';
     readonly DataSourceTable: 'DATA_SOURCE_TABLE';
     readonly ApiConnection: 'API_CONNECTION';
+    readonly Skill: 'SKILL';
 };
 export type SearchablePartType = typeof SearchablePartType[keyof typeof SearchablePartType];
 export declare function instanceOfSearchablePartType(value: any): boolean;

package/dist/models/SearchablePartType.js

@@ -31,7 +31,8 @@ exports.SearchablePartType = {
     DataSource: 'DATA_SOURCE',
     DataSourceSchema: 'DATA_SOURCE_SCHEMA',
     DataSourceTable: 'DATA_SOURCE_TABLE',
-    ApiConnection: 'API_CONNECTION'
+    ApiConnection: 'API_CONNECTION',
+    Skill: 'SKILL'
 };
 function instanceOfSearchablePartType(value) {
     for (const key in exports.SearchablePartType) {

package/dist/models/index.d.ts

@@ -263,6 +263,7 @@ export * from './RunTimeseriesResponse';
 export * from './SSOInitiateResponse';
 export * from './ScheduleCadence';
 export * from './ScoredChunkResponse';
+export * from './SearchItemsResponse';
 export * from './SearchSkillsRequest';
 export * from './SearchSkillsResponse';
 export * from './SearchSortOrder';

package/dist/models/index.js

@@ -281,6 +281,7 @@ __exportStar(require("./RunTimeseriesResponse"), exports);
 __exportStar(require("./SSOInitiateResponse"), exports);
 __exportStar(require("./ScheduleCadence"), exports);
 __exportStar(require("./ScoredChunkResponse"), exports);
+__exportStar(require("./SearchItemsResponse"), exports);
 __exportStar(require("./SearchSkillsRequest"), exports);
 __exportStar(require("./SearchSkillsResponse"), exports);
 __exportStar(require("./SearchSortOrder"), exports);

package/docs/FoldersApi.md

@@ -546,7 +546,7 @@ example().catch(console.error);
 
 ## searchItems
 
-> PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat searchItems(nameLike, sortOrder, partType, withTags, parentPathPartId, limit, offset)
+> SearchItemsResponse searchItems(nameLike, partType, sortOrder, withTags, parentPathPartId, limit, offset)
 
 Search Items Handler
 
@@ -574,10 +574,10 @@ async function example() {
   const body = {
     // string | Case-insensitive partial name search
     nameLike: nameLike_example,
-    // SearchSortOrder | Sort order for results (default: NAME) (optional)
-    sortOrder: ...,
-    // SearchablePartType | Filter by item type (default: all searchable types) (optional)
+    // Array<SearchablePartType> | Filter by item type; repeat the parameter to select several (default: all searchable types) (optional)
     partType: ...,
+    // SearchSortOrder | Sort order for results (default: RELEVANCE) (optional)
+    sortOrder: ...,
     // boolean | Include tags in the response (default: false) (optional)
     withTags: true,
     // string | Scope search to descendants of this folder\'s path part (optional)
@@ -606,8 +606,8 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **nameLike** | `string` | Case-insensitive partial name search | [Defaults to `undefined`] |
-| **sortOrder** | `SearchSortOrder` | Sort order for results (default: NAME) | [Optional] [Defaults to `undefined`] [Enum: NAME, UPDATED_AT, CREATED_AT] |
-| **partType** | `SearchablePartType` | Filter by item type (default: all searchable types) | [Optional] [Defaults to `undefined`] [Enum: FOLDER, DOCUMENT, WORKFLOW_DEFINITION, WORKFLOW_RUN, DATA_SOURCE, DATA_SOURCE_SCHEMA, DATA_SOURCE_TABLE, API_CONNECTION] |
+| **partType** | `Array<SearchablePartType>` | Filter by item type; repeat the parameter to select several (default: all searchable types) | [Optional] |
+| **sortOrder** | `SearchSortOrder` | Sort order for results (default: RELEVANCE) | [Optional] [Defaults to `undefined`] [Enum: RELEVANCE, NAME, UPDATED_AT, CREATED_AT] |
 | **withTags** | `boolean` | Include tags in the response (default: false) | [Optional] [Defaults to `false`] |
 | **parentPathPartId** | `string` | Scope search to descendants of this folder\&#39;s path part | [Optional] [Defaults to `undefined`] |
 | **limit** | `number` | Number of items per page | [Optional] [Defaults to `20`] |
@@ -615,7 +615,7 @@ example().catch(console.error);
 
 ### Return type
 
-[**PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat**](PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat.md)
+[**SearchItemsResponse**](SearchItemsResponse.md)
 
 ### Authorization
 

package/docs/SearchItemsResponse.md

@@ -0,0 +1,43 @@
+
+# SearchItemsResponse
+
+A search page plus how many items of each type the query matched.  ``counts_by_type`` ignores any ``part_type`` filter so the filter chips can keep showing every type\'s count while one of them is selected.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`items` | [Array<FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR>](FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR.md)
+`total` | number
+`limit` | number
+`offset` | number
+`countsByType` | { [key: string]: number; }
+
+## Example
+
+```typescript
+import type { SearchItemsResponse } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "items": null,
+  "total": null,
+  "limit": null,
+  "offset": null,
+  "countsByType": null,
+} satisfies SearchItemsResponse
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as SearchItemsResponse
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/SearchSortOrder.md

@@ -1,7 +1,7 @@
 
 # SearchSortOrder
 
-Sort order options for search results.
+Ordering for flat name search.  RELEVANCE ranks an exact name match first, then names starting with the query, then by how closely the name matches, then shorter names, then alphabetically.
 
 ## Properties
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowledge-stack/ksapi",
-  "version": "2.12.0",
+  "version": "2.12.1",
   "description": "OpenAPI client for @knowledge-stack/ksapi",
   "author": "OpenAPI-Generator",
   "repository": {

package/src/apis/FoldersApi.ts

@@ -26,6 +26,7 @@ import type {
   PaginatedResponseFolderResponse,
   PathOrder,
   PathPartApprovalState,
+  SearchItemsResponse,
   SearchSortOrder,
   SearchablePartType,
   SortDirection,
@@ -54,6 +55,8 @@ import {
     PathOrderToJSON,
     PathPartApprovalStateFromJSON,
     PathPartApprovalStateToJSON,
+    SearchItemsResponseFromJSON,
+    SearchItemsResponseToJSON,
     SearchSortOrderFromJSON,
     SearchSortOrderToJSON,
     SearchablePartTypeFromJSON,
@@ -117,8 +120,8 @@ export interface ListFoldersRequest {
 
 export interface SearchItemsRequest {
     nameLike: string;
+    partType?: Array<SearchablePartType>;
     sortOrder?: SearchSortOrder;
-    partType?: SearchablePartType;
     withTags?: boolean;
     parentPathPartId?: string | null;
     limit?: number;
@@ -337,8 +340,8 @@ export interface FoldersApiInterface {
     /**
      * Creates request options for searchItems without sending the request
      * @param {string} nameLike Case-insensitive partial name search
-     * @param {SearchSortOrder} [sortOrder] Sort order for results (default: NAME)
-     * @param {SearchablePartType} [partType] Filter by item type (default: all searchable types)
+     * @param {Array<SearchablePartType>} [partType] Filter by item type; repeat the parameter to select several (default: all searchable types)
+     * @param {SearchSortOrder} [sortOrder] Sort order for results (default: RELEVANCE)
      * @param {boolean} [withTags] Include tags in the response (default: false)
      * @param {string} [parentPathPartId] Scope search to descendants of this folder\&#39;s path part
      * @param {number} [limit] Number of items per page
@@ -352,8 +355,8 @@ export interface FoldersApiInterface {
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * @summary Search Items Handler
      * @param {string} nameLike Case-insensitive partial name search
-     * @param {SearchSortOrder} [sortOrder] Sort order for results (default: NAME)
-     * @param {SearchablePartType} [partType] Filter by item type (default: all searchable types)
+     * @param {Array<SearchablePartType>} [partType] Filter by item type; repeat the parameter to select several (default: all searchable types)
+     * @param {SearchSortOrder} [sortOrder] Sort order for results (default: RELEVANCE)
      * @param {boolean} [withTags] Include tags in the response (default: false)
      * @param {string} [parentPathPartId] Scope search to descendants of this folder\&#39;s path part
      * @param {number} [limit] Number of items per page
@@ -362,13 +365,13 @@ export interface FoldersApiInterface {
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
      */
-    searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat>>;
+    searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SearchItemsResponse>>;
 
     /**
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat>;
+    searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SearchItemsResponse>;
 
     /**
      * Creates request options for updateFolder without sending the request
@@ -860,14 +863,14 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
             queryParameters['name_like'] = requestParameters['nameLike'];
         }
 
-        if (requestParameters['sortOrder'] != null) {
-            queryParameters['sort_order'] = requestParameters['sortOrder'];
-        }
-
         if (requestParameters['partType'] != null) {
             queryParameters['part_type'] = requestParameters['partType'];
         }
 
+        if (requestParameters['sortOrder'] != null) {
+            queryParameters['sort_order'] = requestParameters['sortOrder'];
+        }
+
         if (requestParameters['withTags'] != null) {
             queryParameters['with_tags'] = requestParameters['withTags'];
         }
@@ -909,18 +912,18 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    async searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat>> {
+    async searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SearchItemsResponse>> {
         const requestOptions = await this.searchItemsRequestOpts(requestParameters);
         const response = await this.request(requestOptions, initOverrides);
 
-        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDatFromJSON(jsonValue));
+        return new runtime.JSONApiResponse(response, (jsonValue) => SearchItemsResponseFromJSON(jsonValue));
     }
 
     /**
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    async searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat> {
+    async searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SearchItemsResponse> {
         const response = await this.searchItemsRaw(requestParameters, initOverrides);
         return await response.value();
     }

package/src/models/SearchItemsResponse.ts

@@ -0,0 +1,141 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call. 
+ *
+ * The version of the OpenAPI document: 0.1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+import type { FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR } from './FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR';
+import {
+    FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSON,
+    FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSONTyped,
+    FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSON,
+    FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSONTyped,
+} from './FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR';
+
+/**
+ * A search page plus how many items of each type the query matched.
+ * 
+ * ``counts_by_type`` ignores any ``part_type`` filter so the filter chips can
+ * keep showing every type's count while one of them is selected.
+ * @export
+ * @interface SearchItemsResponse
+ */
+export interface SearchItemsResponse {
+    /**
+     * List of items
+     * @type {Array<FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR>}
+     * @memberof SearchItemsResponse
+     */
+    items: Array<FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR>;
+    /**
+     * Total number of items
+     * @type {number}
+     * @memberof SearchItemsResponse
+     */
+    total: number;
+    /**
+     * Number of items per page
+     * @type {number}
+     * @memberof SearchItemsResponse
+     */
+    limit: number;
+    /**
+     * Number of items to skip
+     * @type {number}
+     * @memberof SearchItemsResponse
+     */
+    offset: number;
+    /**
+     * Matches per item type, keyed by SearchablePartType and unaffected by the part_type filter
+     * @type {{ [key: string]: number; }}
+     * @memberof SearchItemsResponse
+     */
+    countsByType?: { [key: string]: number; };
+}
+export const SearchItemsResponsePropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number,
+        minLength?: number,
+        pattern?: string,
+        maximum?: number,
+        exclusiveMaximum?: boolean,
+        minimum?: number,
+        exclusiveMinimum?: boolean,
+        multipleOf?: number,
+        maxItems?: number,
+        minItems?: number,
+        uniqueItems?: boolean
+    }
+} = {
+    total: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+    limit: {
+        minimum: 1,
+        exclusiveMinimum: false,
+    },
+    offset: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+}
+
+
+/**
+ * Check if a given object implements the SearchItemsResponse interface.
+ */
+export function instanceOfSearchItemsResponse(value: object): value is SearchItemsResponse {
+    if (!('items' in value) || value['items'] === undefined) return false;
+    if (!('total' in value) || value['total'] === undefined) return false;
+    if (!('limit' in value) || value['limit'] === undefined) return false;
+    if (!('offset' in value) || value['offset'] === undefined) return false;
+    return true;
+}
+
+export function SearchItemsResponseFromJSON(json: any): SearchItemsResponse {
+    return SearchItemsResponseFromJSONTyped(json, false);
+}
+
+export function SearchItemsResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): SearchItemsResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'items': ((json['items'] as Array<any>).map(FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSON)),
+        'total': json['total'],
+        'limit': json['limit'],
+        'offset': json['offset'],
+        'countsByType': json['counts_by_type'] == null ? undefined : json['counts_by_type'],
+    };
+}
+
+export function SearchItemsResponseToJSON(json: any): SearchItemsResponse {
+    return SearchItemsResponseToJSONTyped(json, false);
+}
+
+export function SearchItemsResponseToJSONTyped(value?: SearchItemsResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'items': ((value['items'] as Array<any>).map(FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSON)),
+        'total': value['total'],
+        'limit': value['limit'],
+        'offset': value['offset'],
+        'counts_by_type': value['countsByType'],
+    };
+}
+

package/src/models/SearchSortOrder.ts

@@ -14,10 +14,15 @@
 
 
 /**
- * Sort order options for search results.
+ * Ordering for flat name search.
+ * 
+ * RELEVANCE ranks an exact name match first, then names starting with the
+ * query, then by how closely the name matches, then shorter names, then
+ * alphabetically.
  * @export
  */
 export const SearchSortOrder = {
+    Relevance: 'RELEVANCE',
     Name: 'NAME',
     UpdatedAt: 'UPDATED_AT',
     CreatedAt: 'CREATED_AT'

package/src/models/SearchablePartType.ts

@@ -25,7 +25,8 @@ export const SearchablePartType = {
     DataSource: 'DATA_SOURCE',
     DataSourceSchema: 'DATA_SOURCE_SCHEMA',
     DataSourceTable: 'DATA_SOURCE_TABLE',
-    ApiConnection: 'API_CONNECTION'
+    ApiConnection: 'API_CONNECTION',
+    Skill: 'SKILL'
 } as const;
 export type SearchablePartType = typeof SearchablePartType[keyof typeof SearchablePartType];
 

package/src/models/index.ts

@@ -265,6 +265,7 @@ export * from './RunTimeseriesResponse';
 export * from './SSOInitiateResponse';
 export * from './ScheduleCadence';
 export * from './ScoredChunkResponse';
+export * from './SearchItemsResponse';
 export * from './SearchSkillsRequest';
 export * from './SearchSkillsResponse';
 export * from './SearchSortOrder';