ksapi 2.12.0__tar.gz → 2.13.0__tar.gz

{ksapi-2.12.0 → ksapi-2.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ksapi
-Version: 2.12.0
+Version: 2.13.0
 Summary: Knowledge Stack API
 Home-page: 
 Author: OpenAPI Generator community

{ksapi-2.12.0 → ksapi-2.13.0}/ksapi/__init__.py

@@ -14,7 +14,7 @@
 """  # noqa: E501
 
 
-__version__ = "2.12.0"
+__version__ = "2.13.0"
 
 # Define package exports
 __all__ = [
@@ -334,6 +334,7 @@ __all__ = [
     "SSOInitiateResponse",
     "ScheduleCadence",
     "ScoredChunkResponse",
+    "SearchItemsResponse",
     "SearchSkillsRequest",
     "SearchSkillsResponse",
     "SearchSortOrder",
@@ -786,6 +787,7 @@ from ksapi.models.run_timeseries_response import RunTimeseriesResponse as RunTim
 from ksapi.models.sso_initiate_response import SSOInitiateResponse as SSOInitiateResponse
 from ksapi.models.schedule_cadence import ScheduleCadence as ScheduleCadence
 from ksapi.models.scored_chunk_response import ScoredChunkResponse as ScoredChunkResponse
+from ksapi.models.search_items_response import SearchItemsResponse as SearchItemsResponse
 from ksapi.models.search_skills_request import SearchSkillsRequest as SearchSkillsRequest
 from ksapi.models.search_skills_response import SearchSkillsResponse as SearchSkillsResponse
 from ksapi.models.search_sort_order import SearchSortOrder as SearchSortOrder

{ksapi-2.12.0 → ksapi-2.13.0}/ksapi/api/folders_api.py

@@ -29,6 +29,7 @@ from ksapi.models.paginated_response_annotated_union_folder_response_document_re
 from ksapi.models.paginated_response_folder_response import PaginatedResponseFolderResponse
 from ksapi.models.path_order import PathOrder
 from ksapi.models.path_part_approval_state import PathPartApprovalState
+from ksapi.models.search_items_response import SearchItemsResponse
 from ksapi.models.search_sort_order import SearchSortOrder
 from ksapi.models.searchable_part_type import SearchablePartType
 from ksapi.models.sort_direction import SortDirection
@@ -2192,8 +2193,8 @@ class FoldersApi:
     def search_items(
         self,
         name_like: Annotated[str, Field(min_length=1, strict=True, max_length=255, description="Case-insensitive partial name search")],
-        sort_order: Annotated[Optional[SearchSortOrder], Field(description="Sort order for results (default: NAME)")] = None,
-        part_type: Annotated[Optional[SearchablePartType], Field(description="Filter by item type (default: all searchable types)")] = None,
+        part_type: Annotated[Optional[List[SearchablePartType]], Field(description="Filter by item type; repeat the parameter to select several (default: all searchable types)")] = None,
+        sort_order: Annotated[Optional[SearchSortOrder], Field(description="Sort order for results (default: RELEVANCE)")] = None,
         with_tags: Annotated[Optional[StrictBool], Field(description="Include tags in the response (default: false)")] = None,
         parent_path_part_id: Annotated[Optional[UUID], Field(description="Scope search to descendants of this folder's path part")] = None,
         limit: Annotated[Optional[Annotated[int, Field(le=100, strict=True, ge=1)]], Field(description="Number of items per page")] = None,
@@ -2210,17 +2211,17 @@ class FoldersApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat:
+    ) -> SearchItemsResponse:
         """Search Items Handler
 
         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.
 
         :param name_like: Case-insensitive partial name search (required)
         :type name_like: str
-        :param sort_order: Sort order for results (default: NAME)
+        :param part_type: Filter by item type; repeat the parameter to select several (default: all searchable types)
+        :type part_type: List[SearchablePartType]
+        :param sort_order: Sort order for results (default: RELEVANCE)
         :type sort_order: SearchSortOrder
-        :param part_type: Filter by item type (default: all searchable types)
-        :type part_type: SearchablePartType
         :param with_tags: Include tags in the response (default: false)
         :type with_tags: bool
         :param parent_path_part_id: Scope search to descendants of this folder's path part
@@ -2253,8 +2254,8 @@ class FoldersApi:
 
         _param = self._search_items_serialize(
             name_like=name_like,
-            sort_order=sort_order,
             part_type=part_type,
+            sort_order=sort_order,
             with_tags=with_tags,
             parent_path_part_id=parent_path_part_id,
             limit=limit,
@@ -2266,7 +2267,7 @@ class FoldersApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat",
+            '200': "SearchItemsResponse",
             '422': "HTTPValidationError",
         }
         response_data = self.api_client.call_api(
@@ -2284,8 +2285,8 @@ class FoldersApi:
     def search_items_with_http_info(
         self,
         name_like: Annotated[str, Field(min_length=1, strict=True, max_length=255, description="Case-insensitive partial name search")],
-        sort_order: Annotated[Optional[SearchSortOrder], Field(description="Sort order for results (default: NAME)")] = None,
-        part_type: Annotated[Optional[SearchablePartType], Field(description="Filter by item type (default: all searchable types)")] = None,
+        part_type: Annotated[Optional[List[SearchablePartType]], Field(description="Filter by item type; repeat the parameter to select several (default: all searchable types)")] = None,
+        sort_order: Annotated[Optional[SearchSortOrder], Field(description="Sort order for results (default: RELEVANCE)")] = None,
         with_tags: Annotated[Optional[StrictBool], Field(description="Include tags in the response (default: false)")] = None,
         parent_path_part_id: Annotated[Optional[UUID], Field(description="Scope search to descendants of this folder's path part")] = None,
         limit: Annotated[Optional[Annotated[int, Field(le=100, strict=True, ge=1)]], Field(description="Number of items per page")] = None,
@@ -2302,17 +2303,17 @@ class FoldersApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ApiResponse[PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat]:
+    ) -> ApiResponse[SearchItemsResponse]:
         """Search Items Handler
 
         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.
 
         :param name_like: Case-insensitive partial name search (required)
         :type name_like: str
-        :param sort_order: Sort order for results (default: NAME)
+        :param part_type: Filter by item type; repeat the parameter to select several (default: all searchable types)
+        :type part_type: List[SearchablePartType]
+        :param sort_order: Sort order for results (default: RELEVANCE)
         :type sort_order: SearchSortOrder
-        :param part_type: Filter by item type (default: all searchable types)
-        :type part_type: SearchablePartType
         :param with_tags: Include tags in the response (default: false)
         :type with_tags: bool
         :param parent_path_part_id: Scope search to descendants of this folder's path part
@@ -2345,8 +2346,8 @@ class FoldersApi:
 
         _param = self._search_items_serialize(
             name_like=name_like,
-            sort_order=sort_order,
             part_type=part_type,
+            sort_order=sort_order,
             with_tags=with_tags,
             parent_path_part_id=parent_path_part_id,
             limit=limit,
@@ -2358,7 +2359,7 @@ class FoldersApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat",
+            '200': "SearchItemsResponse",
             '422': "HTTPValidationError",
         }
         response_data = self.api_client.call_api(
@@ -2376,8 +2377,8 @@ class FoldersApi:
     def search_items_without_preload_content(
         self,
         name_like: Annotated[str, Field(min_length=1, strict=True, max_length=255, description="Case-insensitive partial name search")],
-        sort_order: Annotated[Optional[SearchSortOrder], Field(description="Sort order for results (default: NAME)")] = None,
-        part_type: Annotated[Optional[SearchablePartType], Field(description="Filter by item type (default: all searchable types)")] = None,
+        part_type: Annotated[Optional[List[SearchablePartType]], Field(description="Filter by item type; repeat the parameter to select several (default: all searchable types)")] = None,
+        sort_order: Annotated[Optional[SearchSortOrder], Field(description="Sort order for results (default: RELEVANCE)")] = None,
         with_tags: Annotated[Optional[StrictBool], Field(description="Include tags in the response (default: false)")] = None,
         parent_path_part_id: Annotated[Optional[UUID], Field(description="Scope search to descendants of this folder's path part")] = None,
         limit: Annotated[Optional[Annotated[int, Field(le=100, strict=True, ge=1)]], Field(description="Number of items per page")] = None,
@@ -2401,10 +2402,10 @@ class FoldersApi:
 
         :param name_like: Case-insensitive partial name search (required)
         :type name_like: str
-        :param sort_order: Sort order for results (default: NAME)
+        :param part_type: Filter by item type; repeat the parameter to select several (default: all searchable types)
+        :type part_type: List[SearchablePartType]
+        :param sort_order: Sort order for results (default: RELEVANCE)
         :type sort_order: SearchSortOrder
-        :param part_type: Filter by item type (default: all searchable types)
-        :type part_type: SearchablePartType
         :param with_tags: Include tags in the response (default: false)
         :type with_tags: bool
         :param parent_path_part_id: Scope search to descendants of this folder's path part
@@ -2437,8 +2438,8 @@ class FoldersApi:
 
         _param = self._search_items_serialize(
             name_like=name_like,
-            sort_order=sort_order,
             part_type=part_type,
+            sort_order=sort_order,
             with_tags=with_tags,
             parent_path_part_id=parent_path_part_id,
             limit=limit,
@@ -2450,7 +2451,7 @@ class FoldersApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat",
+            '200': "SearchItemsResponse",
             '422': "HTTPValidationError",
         }
         response_data = self.api_client.call_api(
@@ -2463,8 +2464,8 @@ class FoldersApi:
     def _search_items_serialize(
         self,
         name_like,
-        sort_order,
         part_type,
+        sort_order,
         with_tags,
         parent_path_part_id,
         limit,
@@ -2478,6 +2479,7 @@ class FoldersApi:
         _host = None
 
         _collection_formats: Dict[str, str] = {
+            'part_type': 'multi',
         }
 
         _path_params: Dict[str, str] = {}
@@ -2495,13 +2497,13 @@ class FoldersApi:
             
             _query_params.append(('name_like', name_like))
             
-        if sort_order is not None:
+        if part_type is not None:
             
-            _query_params.append(('sort_order', sort_order.value))
+            _query_params.append(('part_type', part_type))
             
-        if part_type is not None:
+        if sort_order is not None:
             
-            _query_params.append(('part_type', part_type.value))
+            _query_params.append(('sort_order', sort_order.value))
             
         if with_tags is not None:
             

{ksapi-2.12.0 → ksapi-2.13.0}/ksapi/api_client.py

@@ -91,7 +91,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/2.12.0/python'
+        self.user_agent = 'OpenAPI-Generator/2.13.0/python'
         self.client_side_validation = configuration.client_side_validation
 
     def __enter__(self):

{ksapi-2.12.0 → ksapi-2.13.0}/ksapi/configuration.py

@@ -562,7 +562,7 @@ conf = ksapi.Configuration(
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 0.1.0\n"\
-               "SDK Package Version: 2.12.0".\
+               "SDK Package Version: 2.13.0".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]:

{ksapi-2.12.0 → ksapi-2.13.0}/ksapi/models/__init__.py

@@ -278,6 +278,7 @@ from ksapi.models.run_timeseries_response import RunTimeseriesResponse
 from ksapi.models.sso_initiate_response import SSOInitiateResponse
 from ksapi.models.schedule_cadence import ScheduleCadence
 from ksapi.models.scored_chunk_response import ScoredChunkResponse
+from ksapi.models.search_items_response import SearchItemsResponse
 from ksapi.models.search_skills_request import SearchSkillsRequest
 from ksapi.models.search_skills_response import SearchSkillsResponse
 from ksapi.models.search_sort_order import SearchSortOrder

{ksapi-2.12.0 → ksapi-2.13.0}/ksapi/models/resolved_reference_input.py

@@ -20,6 +20,7 @@ import json
 from pydantic import BaseModel, ConfigDict, Field, StrictStr
 from typing import Any, ClassVar, Dict, List, Optional
 from uuid import UUID
+from ksapi.models.document_type import DocumentType
 from ksapi.models.reference_type import ReferenceType
 from typing import Optional, Set
 from typing_extensions import Self
@@ -33,8 +34,9 @@ class ResolvedReferenceInput(BaseModel):
     entity_id: UUID
     display_name: StrictStr = Field(description="Human-readable name for the entity")
     materialized_path: Optional[StrictStr] = Field(default=None, description="Full materialized path (None for entities without path parts, e.g. tags, users)")
+    document_type: Optional[DocumentType] = None
     additional_properties: Dict[str, Any] = {}
-    __properties: ClassVar[List[str]] = ["ref_type", "entity_id", "display_name", "materialized_path"]
+    __properties: ClassVar[List[str]] = ["ref_type", "entity_id", "display_name", "materialized_path", "document_type"]
 
     model_config = ConfigDict(
         validate_by_name=True,
@@ -102,7 +104,8 @@ class ResolvedReferenceInput(BaseModel):
             "ref_type": obj.get("ref_type"),
             "entity_id": obj.get("entity_id"),
             "display_name": obj.get("display_name"),
-            "materialized_path": obj.get("materialized_path")
+            "materialized_path": obj.get("materialized_path"),
+            "document_type": obj.get("document_type")
         })
         # store additional fields in additional_properties
         for _key in obj.keys():

{ksapi-2.12.0 → ksapi-2.13.0}/ksapi/models/resolved_reference_output.py

@@ -20,6 +20,7 @@ import json
 from pydantic import BaseModel, ConfigDict, Field, StrictStr
 from typing import Any, ClassVar, Dict, List, Optional
 from uuid import UUID
+from ksapi.models.document_type import DocumentType
 from typing import Optional, Set
 from typing_extensions import Self
 from pydantic_core import to_jsonable_python
@@ -32,8 +33,9 @@ class ResolvedReferenceOutput(BaseModel):
     entity_id: UUID
     display_name: StrictStr = Field(description="Human-readable name for the entity")
     materialized_path: Optional[StrictStr] = Field(default=None, description="Full materialized path (None for entities without path parts, e.g. tags, users)")
+    document_type: Optional[DocumentType] = None
     additional_properties: Dict[str, Any] = {}
-    __properties: ClassVar[List[str]] = ["ref_type", "entity_id", "display_name", "materialized_path"]
+    __properties: ClassVar[List[str]] = ["ref_type", "entity_id", "display_name", "materialized_path", "document_type"]
 
     model_config = ConfigDict(
         validate_by_name=True,
@@ -101,7 +103,8 @@ class ResolvedReferenceOutput(BaseModel):
             "ref_type": obj.get("ref_type"),
             "entity_id": obj.get("entity_id"),
             "display_name": obj.get("display_name"),
-            "materialized_path": obj.get("materialized_path")
+            "materialized_path": obj.get("materialized_path"),
+            "document_type": obj.get("document_type")
         })
         # store additional fields in additional_properties
         for _key in obj.keys():

ksapi-2.13.0/ksapi/models/search_items_response.py

@@ -0,0 +1,105 @@
+# coding: utf-8
+
+"""
+    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
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictInt
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from ksapi.models.folder_response_or_document_response_or_workflow_definition_response_or_workflow_run_response_or_data_source_response_or_data_source_schema_r import FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR
+from typing import Optional, Set
+from typing_extensions import Self
+from pydantic_core import to_jsonable_python
+
+class SearchItemsResponse(BaseModel):
+    """
+    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.
+    """ # noqa: E501
+    items: List[FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR] = Field(description="List of items")
+    total: Annotated[int, Field(strict=True, ge=0)] = Field(description="Total number of items")
+    limit: Annotated[int, Field(strict=True, ge=1)] = Field(description="Number of items per page")
+    offset: Annotated[int, Field(strict=True, ge=0)] = Field(description="Number of items to skip")
+    counts_by_type: Optional[Dict[str, StrictInt]] = Field(default=None, description="Matches per item type, keyed by SearchablePartType and unaffected by the part_type filter")
+    __properties: ClassVar[List[str]] = ["items", "total", "limit", "offset", "counts_by_type"]
+
+    model_config = ConfigDict(
+        validate_by_name=True,
+        validate_by_alias=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return json.dumps(to_jsonable_python(self.to_dict()))
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of SearchItemsResponse from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each item in items (list)
+        _items = []
+        if self.items:
+            for _item_items in self.items:
+                if _item_items:
+                    _items.append(_item_items.to_dict())
+            _dict['items'] = _items
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of SearchItemsResponse from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "items": [FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR.from_dict(_item) for _item in obj["items"]] if obj.get("items") is not None else None,
+            "total": obj.get("total"),
+            "limit": obj.get("limit"),
+            "offset": obj.get("offset"),
+            "counts_by_type": obj.get("counts_by_type")
+        })
+        return _obj
+
+

{ksapi-2.12.0 → ksapi-2.13.0}/ksapi/models/search_sort_order.py

@@ -20,12 +20,13 @@ from typing_extensions import Self
 
 class SearchSortOrder(str, Enum):
     """
-    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.
     """
 
     """
     allowed enum values
     """
+    RELEVANCE = 'RELEVANCE'
     NAME = 'NAME'
     UPDATED_AT = 'UPDATED_AT'
     CREATED_AT = 'CREATED_AT'

{ksapi-2.12.0 → ksapi-2.13.0}/ksapi/models/searchable_part_type.py

@@ -34,6 +34,7 @@ class SearchablePartType(str, Enum):
     DATA_SOURCE_SCHEMA = 'DATA_SOURCE_SCHEMA'
     DATA_SOURCE_TABLE = 'DATA_SOURCE_TABLE'
     API_CONNECTION = 'API_CONNECTION'
+    SKILL = 'SKILL'
 
     @classmethod
     def from_json(cls, json_str: str) -> Self:

{ksapi-2.12.0 → ksapi-2.13.0}/ksapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ksapi
-Version: 2.12.0
+Version: 2.13.0
 Summary: Knowledge Stack API
 Home-page: 
 Author: OpenAPI Generator community

{ksapi-2.12.0 → ksapi-2.13.0}/ksapi.egg-info/SOURCES.txt

@@ -322,6 +322,7 @@ ksapi/models/run_folder_ref.py
 ksapi/models/run_timeseries_response.py
 ksapi/models/schedule_cadence.py
 ksapi/models/scored_chunk_response.py
+ksapi/models/search_items_response.py
 ksapi/models/search_skills_request.py
 ksapi/models/search_skills_response.py
 ksapi/models/search_sort_order.py
@@ -742,6 +743,7 @@ test/test_run_folder_ref.py
 test/test_run_timeseries_response.py
 test/test_schedule_cadence.py
 test/test_scored_chunk_response.py
+test/test_search_items_response.py
 test/test_search_skills_request.py
 test/test_search_skills_response.py
 test/test_search_sort_order.py

{ksapi-2.12.0 → ksapi-2.13.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ksapi"
-version = "2.12.0"
+version = "2.13.0"
 description = "Knowledge Stack API"
 authors = [
   {name = "OpenAPI Generator Community",email = "team@openapitools.org"},

{ksapi-2.12.0 → ksapi-2.13.0}/setup.py

@@ -19,7 +19,7 @@ from setuptools import setup, find_packages  # noqa: H301
 # prerequisite: setuptools
 # http://pypi.python.org/pypi/setuptools
 NAME = "ksapi"
-VERSION = "2.12.0"
+VERSION = "2.13.0"
 PYTHON_REQUIRES = ">= 3.9"
 REQUIRES = [
     "urllib3 >= 2.1.0, < 3.0.0",

{ksapi-2.12.0 → ksapi-2.13.0}/test/test_create_thread_message_request.py

@@ -54,7 +54,8 @@ class TestCreateThreadMessageRequest(unittest.TestCase):
                             ref_type = 'FOLDER', 
                             entity_id = '', 
                             display_name = '', 
-                            materialized_path = '', )
+                            materialized_path = '', 
+                            document_type = 'PDF', )
                         ], ),
                 details = ksapi.models.thread_message_details.ThreadMessageDetails(
                     parts = [
@@ -94,7 +95,8 @@ class TestCreateThreadMessageRequest(unittest.TestCase):
                             ref_type = 'FOLDER', 
                             entity_id = '', 
                             display_name = '', 
-                            materialized_path = '', )
+                            materialized_path = '', 
+                            document_type = 'PDF', )
                         ], ),
         )
         """

{ksapi-2.12.0 → ksapi-2.13.0}/test/test_enriched_thread_message_content.py

@@ -57,7 +57,8 @@ class TestEnrichedThreadMessageContent(unittest.TestCase):
                         ref_type = '', 
                         entity_id = '', 
                         display_name = '', 
-                        materialized_path = '', )
+                        materialized_path = '', 
+                        document_type = 'PDF', )
                     ]
             )
         else:

{ksapi-2.12.0 → ksapi-2.13.0}/test/test_paginated_response_thread_message_response.py

@@ -64,7 +64,8 @@ class TestPaginatedResponseThreadMessageResponse(unittest.TestCase):
                                     ref_type = '', 
                                     entity_id = '', 
                                     display_name = '', 
-                                    materialized_path = '', )
+                                    materialized_path = '', 
+                                    document_type = 'PDF', )
                                 ], ), 
                         details = null, 
                         parent_path_id = '', 
@@ -109,7 +110,8 @@ class TestPaginatedResponseThreadMessageResponse(unittest.TestCase):
                                     ref_type = '', 
                                     entity_id = '', 
                                     display_name = '', 
-                                    materialized_path = '', )
+                                    materialized_path = '', 
+                                    document_type = 'PDF', )
                                 ], ), 
                         details = null, 
                         parent_path_id = '', 

{ksapi-2.12.0 → ksapi-2.13.0}/test/test_resolved_reference_input.py

@@ -38,7 +38,8 @@ class TestResolvedReferenceInput(unittest.TestCase):
                 ref_type = 'FOLDER',
                 entity_id = '',
                 display_name = '',
-                materialized_path = ''
+                materialized_path = '',
+                document_type = 'PDF'
             )
         else:
             return ResolvedReferenceInput(

{ksapi-2.12.0 → ksapi-2.13.0}/test/test_resolved_reference_output.py

@@ -38,7 +38,8 @@ class TestResolvedReferenceOutput(unittest.TestCase):
                 ref_type = '',
                 entity_id = '',
                 display_name = '',
-                materialized_path = ''
+                materialized_path = '',
+                document_type = 'PDF'
             )
         else:
             return ResolvedReferenceOutput(

ksapi-2.13.0/test/test_search_items_response.py

@@ -0,0 +1,65 @@
+# coding: utf-8
+
+"""
+    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
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+import unittest
+
+from ksapi.models.search_items_response import SearchItemsResponse
+
+class TestSearchItemsResponse(unittest.TestCase):
+    """SearchItemsResponse unit test stubs"""
+
+    def setUp(self):
+        pass
+
+    def tearDown(self):
+        pass
+
+    def make_instance(self, include_optional) -> SearchItemsResponse:
+        """Test SearchItemsResponse
+            include_optional is a boolean, when False only required
+            params are included, when True both required and
+            optional params are included """
+        # uncomment below to create an instance of `SearchItemsResponse`
+        """
+        model = SearchItemsResponse()
+        if include_optional:
+            return SearchItemsResponse(
+                items = [
+                    null
+                    ],
+                total = 0.0,
+                limit = 1.0,
+                offset = 0.0,
+                counts_by_type = {
+                    'key' : 56
+                    }
+            )
+        else:
+            return SearchItemsResponse(
+                items = [
+                    null
+                    ],
+                total = 0.0,
+                limit = 1.0,
+                offset = 0.0,
+        )
+        """
+
+    def testSearchItemsResponse(self):
+        """Test SearchItemsResponse"""
+        # inst_req_only = self.make_instance(include_optional=False)
+        # inst_req_and_optional = self.make_instance(include_optional=True)
+
+if __name__ == '__main__':
+    unittest.main()

{ksapi-2.12.0 → ksapi-2.13.0}/test/test_thread_message_content.py

@@ -51,7 +51,8 @@ class TestThreadMessageContent(unittest.TestCase):
                         ref_type = 'FOLDER', 
                         entity_id = '', 
                         display_name = '', 
-                        materialized_path = '', )
+                        materialized_path = '', 
+                        document_type = 'PDF', )
                     ]
             )
         else: