ksapi 3.6.2__tar.gz → 3.8.0__tar.gz

{ksapi-3.6.2 → ksapi-3.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ksapi
-Version: 3.6.2
+Version: 3.8.0
 Summary: Knowledge Stack API
 Home-page: 
 Author: OpenAPI Generator community
@@ -90,6 +90,9 @@ answer = AgentApi(client).agent_ask(AskRequest(prompt="What are the renewal term
 print(answer.text)
 ```
 
+The answer is written in the tenant's configured language. Pass
+`output_language="en"` or `"zh"` to choose it for one request.
+
 Citation-grounded, multi-turn chat runs through **threads**; each assistant
 message exposes `content.citations`. Stream those tokens live below.
 

{ksapi-3.6.2 → ksapi-3.8.0}/README.md

@@ -73,6 +73,9 @@ answer = AgentApi(client).agent_ask(AskRequest(prompt="What are the renewal term
 print(answer.text)
 ```
 
+The answer is written in the tenant's configured language. Pass
+`output_language="en"` or `"zh"` to choose it for one request.
+
 Citation-grounded, multi-turn chat runs through **threads**; each assistant
 message exposes `content.citations`. Stream those tokens live below.
 

{ksapi-3.6.2 → ksapi-3.8.0}/ksapi/__init__.py

@@ -14,7 +14,7 @@
 """  # noqa: E501
 
 
-__version__ = "3.6.2"
+__version__ = "3.8.0"
 
 # Define package exports
 __all__ = [
@@ -204,8 +204,6 @@ __all__ = [
     "DocxParagraphAnchorOutput",
     "DownloadArtifact",
     "EditMemoryChunkRequest",
-    "EmailMetadata",
-    "EmailParty",
     "EmailSentResponse",
     "EmailVerificationRequest",
     "EnrichedCitation",
@@ -670,8 +668,6 @@ from ksapi.models.docx_paragraph_anchor_input import DocxParagraphAnchorInput as
 from ksapi.models.docx_paragraph_anchor_output import DocxParagraphAnchorOutput as DocxParagraphAnchorOutput
 from ksapi.models.download_artifact import DownloadArtifact as DownloadArtifact
 from ksapi.models.edit_memory_chunk_request import EditMemoryChunkRequest as EditMemoryChunkRequest
-from ksapi.models.email_metadata import EmailMetadata as EmailMetadata
-from ksapi.models.email_party import EmailParty as EmailParty
 from ksapi.models.email_sent_response import EmailSentResponse as EmailSentResponse
 from ksapi.models.email_verification_request import EmailVerificationRequest as EmailVerificationRequest
 from ksapi.models.enriched_citation import EnrichedCitation as EnrichedCitation

{ksapi-3.6.2 → ksapi-3.8.0}/ksapi/api/documents_api.py

@@ -2256,7 +2256,6 @@ class DocumentsApi:
         name: Annotated[Optional[StrictStr], Field(description="Document name (defaults to filename)")] = None,
         tag_ids: Annotated[Optional[List[UUID]], Field(description="Tag IDs applied to the created document.")] = None,
         idempotency_key: Annotated[Optional[StrictStr], Field(description="Opt-in key: a repeat with the same key at the same (parent, name) replays the existing document instead of a 409.")] = None,
-        email_nesting_depth: Annotated[Optional[Annotated[int, Field(le=10, strict=True, ge=0)]], Field(description="Internal: set by the email member fan-out when a nested email re-enters this endpoint. Leave at 0 for direct uploads.")] = None,
         ingestion_mode: Optional[IngestionMode] = None,
         chunk_type: Optional[ChunkType] = None,
         secondary_taxonomy: Optional[ImageTaxonomy] = None,
@@ -2290,8 +2289,6 @@ class DocumentsApi:
         :type tag_ids: List[UUID]
         :param idempotency_key: Opt-in key: a repeat with the same key at the same (parent, name) replays the existing document instead of a 409.
         :type idempotency_key: str
-        :param email_nesting_depth: Internal: set by the email member fan-out when a nested email re-enters this endpoint. Leave at 0 for direct uploads.
-        :type email_nesting_depth: int
         :param ingestion_mode:
         :type ingestion_mode: IngestionMode
         :param chunk_type:
@@ -2332,7 +2329,6 @@ class DocumentsApi:
             name=name,
             tag_ids=tag_ids,
             idempotency_key=idempotency_key,
-            email_nesting_depth=email_nesting_depth,
             ingestion_mode=ingestion_mode,
             chunk_type=chunk_type,
             secondary_taxonomy=secondary_taxonomy,
@@ -2368,7 +2364,6 @@ class DocumentsApi:
         name: Annotated[Optional[StrictStr], Field(description="Document name (defaults to filename)")] = None,
         tag_ids: Annotated[Optional[List[UUID]], Field(description="Tag IDs applied to the created document.")] = None,
         idempotency_key: Annotated[Optional[StrictStr], Field(description="Opt-in key: a repeat with the same key at the same (parent, name) replays the existing document instead of a 409.")] = None,
-        email_nesting_depth: Annotated[Optional[Annotated[int, Field(le=10, strict=True, ge=0)]], Field(description="Internal: set by the email member fan-out when a nested email re-enters this endpoint. Leave at 0 for direct uploads.")] = None,
         ingestion_mode: Optional[IngestionMode] = None,
         chunk_type: Optional[ChunkType] = None,
         secondary_taxonomy: Optional[ImageTaxonomy] = None,
@@ -2402,8 +2397,6 @@ class DocumentsApi:
         :type tag_ids: List[UUID]
         :param idempotency_key: Opt-in key: a repeat with the same key at the same (parent, name) replays the existing document instead of a 409.
         :type idempotency_key: str
-        :param email_nesting_depth: Internal: set by the email member fan-out when a nested email re-enters this endpoint. Leave at 0 for direct uploads.
-        :type email_nesting_depth: int
         :param ingestion_mode:
         :type ingestion_mode: IngestionMode
         :param chunk_type:
@@ -2444,7 +2437,6 @@ class DocumentsApi:
             name=name,
             tag_ids=tag_ids,
             idempotency_key=idempotency_key,
-            email_nesting_depth=email_nesting_depth,
             ingestion_mode=ingestion_mode,
             chunk_type=chunk_type,
             secondary_taxonomy=secondary_taxonomy,
@@ -2480,7 +2472,6 @@ class DocumentsApi:
         name: Annotated[Optional[StrictStr], Field(description="Document name (defaults to filename)")] = None,
         tag_ids: Annotated[Optional[List[UUID]], Field(description="Tag IDs applied to the created document.")] = None,
         idempotency_key: Annotated[Optional[StrictStr], Field(description="Opt-in key: a repeat with the same key at the same (parent, name) replays the existing document instead of a 409.")] = None,
-        email_nesting_depth: Annotated[Optional[Annotated[int, Field(le=10, strict=True, ge=0)]], Field(description="Internal: set by the email member fan-out when a nested email re-enters this endpoint. Leave at 0 for direct uploads.")] = None,
         ingestion_mode: Optional[IngestionMode] = None,
         chunk_type: Optional[ChunkType] = None,
         secondary_taxonomy: Optional[ImageTaxonomy] = None,
@@ -2514,8 +2505,6 @@ class DocumentsApi:
         :type tag_ids: List[UUID]
         :param idempotency_key: Opt-in key: a repeat with the same key at the same (parent, name) replays the existing document instead of a 409.
         :type idempotency_key: str
-        :param email_nesting_depth: Internal: set by the email member fan-out when a nested email re-enters this endpoint. Leave at 0 for direct uploads.
-        :type email_nesting_depth: int
         :param ingestion_mode:
         :type ingestion_mode: IngestionMode
         :param chunk_type:
@@ -2556,7 +2545,6 @@ class DocumentsApi:
             name=name,
             tag_ids=tag_ids,
             idempotency_key=idempotency_key,
-            email_nesting_depth=email_nesting_depth,
             ingestion_mode=ingestion_mode,
             chunk_type=chunk_type,
             secondary_taxonomy=secondary_taxonomy,
@@ -2587,7 +2575,6 @@ class DocumentsApi:
         name,
         tag_ids,
         idempotency_key,
-        email_nesting_depth,
         ingestion_mode,
         chunk_type,
         secondary_taxonomy,
@@ -2629,8 +2616,6 @@ class DocumentsApi:
             _form_params.append(('tag_ids', tag_ids))
         if idempotency_key is not None:
             _form_params.append(('idempotency_key', idempotency_key))
-        if email_nesting_depth is not None:
-            _form_params.append(('email_nesting_depth', email_nesting_depth))
         if ingestion_mode is not None:
             _form_params.append(('ingestion_mode', ingestion_mode))
         if chunk_type is not None:
@@ -2718,7 +2703,7 @@ class DocumentsApi:
     ) -> IngestDocumentResponse:
         """Ingest Document Version Handler
 
-        Upload a new file for an existing document, creating a new version and triggering ingestion.  Requires an active document checkout held by the caller. Acquire one via ``POST /v1/documents/{id}/checkout`` first and release it after; otherwise this returns 409 Conflict (\"A document checkout is required to edit this document.\").  Creates a new document version (incrementing the highest version number), uploads the file to S3, and starts the ingestion workflow. Upon successful ingestion, the new version is automatically activated (set as the document's active_version) and the old version's Qdrant points are deactivated.  Returns 201 immediately with the Temporal ``workflow_id``. Ingestion runs in the background — poll ``GET /v1/system-jobs/document_versions/{workflow_id}`` (also given in the ``Location`` header) until ``status`` is terminal.
+        Upload a new file for an existing document, creating a new version and triggering ingestion.  Requires an active document checkout held by the caller. Acquire one via ``POST /v1/documents/{id}/checkout`` first and release it after; otherwise this returns 409 Conflict (\"A document checkout is required to edit this document.\").  The file must be the document's type (a PDF document takes only PDF versions; ``.md`` and ``.txt`` are both PLAINTEXT); any other type is a 400.  Creates a new document version (incrementing the highest version number), uploads the file to S3, and starts the ingestion workflow. Upon successful ingestion, the new version is automatically activated (set as the document's active_version) and the old version's Qdrant points are deactivated.  Returns 201 immediately with the Temporal ``workflow_id``. Ingestion runs in the background — poll ``GET /v1/system-jobs/document_versions/{workflow_id}`` (also given in the ``Location`` header) until ``status`` is terminal.
 
         :param document_id: Document ID (required)
         :type document_id: UUID
@@ -2814,7 +2799,7 @@ class DocumentsApi:
     ) -> ApiResponse[IngestDocumentResponse]:
         """Ingest Document Version Handler
 
-        Upload a new file for an existing document, creating a new version and triggering ingestion.  Requires an active document checkout held by the caller. Acquire one via ``POST /v1/documents/{id}/checkout`` first and release it after; otherwise this returns 409 Conflict (\"A document checkout is required to edit this document.\").  Creates a new document version (incrementing the highest version number), uploads the file to S3, and starts the ingestion workflow. Upon successful ingestion, the new version is automatically activated (set as the document's active_version) and the old version's Qdrant points are deactivated.  Returns 201 immediately with the Temporal ``workflow_id``. Ingestion runs in the background — poll ``GET /v1/system-jobs/document_versions/{workflow_id}`` (also given in the ``Location`` header) until ``status`` is terminal.
+        Upload a new file for an existing document, creating a new version and triggering ingestion.  Requires an active document checkout held by the caller. Acquire one via ``POST /v1/documents/{id}/checkout`` first and release it after; otherwise this returns 409 Conflict (\"A document checkout is required to edit this document.\").  The file must be the document's type (a PDF document takes only PDF versions; ``.md`` and ``.txt`` are both PLAINTEXT); any other type is a 400.  Creates a new document version (incrementing the highest version number), uploads the file to S3, and starts the ingestion workflow. Upon successful ingestion, the new version is automatically activated (set as the document's active_version) and the old version's Qdrant points are deactivated.  Returns 201 immediately with the Temporal ``workflow_id``. Ingestion runs in the background — poll ``GET /v1/system-jobs/document_versions/{workflow_id}`` (also given in the ``Location`` header) until ``status`` is terminal.
 
         :param document_id: Document ID (required)
         :type document_id: UUID
@@ -2910,7 +2895,7 @@ class DocumentsApi:
     ) -> RESTResponseType:
         """Ingest Document Version Handler
 
-        Upload a new file for an existing document, creating a new version and triggering ingestion.  Requires an active document checkout held by the caller. Acquire one via ``POST /v1/documents/{id}/checkout`` first and release it after; otherwise this returns 409 Conflict (\"A document checkout is required to edit this document.\").  Creates a new document version (incrementing the highest version number), uploads the file to S3, and starts the ingestion workflow. Upon successful ingestion, the new version is automatically activated (set as the document's active_version) and the old version's Qdrant points are deactivated.  Returns 201 immediately with the Temporal ``workflow_id``. Ingestion runs in the background — poll ``GET /v1/system-jobs/document_versions/{workflow_id}`` (also given in the ``Location`` header) until ``status`` is terminal.
+        Upload a new file for an existing document, creating a new version and triggering ingestion.  Requires an active document checkout held by the caller. Acquire one via ``POST /v1/documents/{id}/checkout`` first and release it after; otherwise this returns 409 Conflict (\"A document checkout is required to edit this document.\").  The file must be the document's type (a PDF document takes only PDF versions; ``.md`` and ``.txt`` are both PLAINTEXT); any other type is a 400.  Creates a new document version (incrementing the highest version number), uploads the file to S3, and starts the ingestion workflow. Upon successful ingestion, the new version is automatically activated (set as the document's active_version) and the old version's Qdrant points are deactivated.  Returns 201 immediately with the Temporal ``workflow_id``. Ingestion runs in the background — poll ``GET /v1/system-jobs/document_versions/{workflow_id}`` (also given in the ``Location`` header) until ``status`` is terminal.
 
         :param document_id: Document ID (required)
         :type document_id: UUID

{ksapi-3.6.2 → ksapi-3.8.0}/ksapi/api/system_jobs_api.py

@@ -1122,7 +1122,7 @@ class SystemJobsApi:
     ) -> ZipIngestionStatusResponse:
         """Get Zip Ingestion Status Handler
 
-        Get a fan-out's live status + per-member outcomes.  Serves both container fan-outs: a ZIP archive's members and an email's attachments. Both expose the same ``results`` query, so one endpoint covers them rather than duplicating the tenant check and hydration.  Tenant-scoped via the TenantId search attribute (no per-path can_read check — intentionally consistent with the sibling generic Temporal endpoints below; the opaque workflow_id is only handed to the uploader, who had can_write on the target). The per-member results come from the workflow's ``results`` query (served from retained history), so once Temporal retention expires this 404s.
+        Get a ZIP fan-out's live status + per-member outcomes.  Tenant-scoped via the TenantId search attribute (no per-path can_read check — intentionally consistent with the sibling generic Temporal endpoints below; the opaque workflow_id is only handed to the uploader, who had can_write on the target). The per-member results come from the workflow's ``results`` query (served from retained history), so once Temporal retention expires this 404s.
 
         :param workflow_id: (required)
         :type workflow_id: str
@@ -1190,7 +1190,7 @@ class SystemJobsApi:
     ) -> ApiResponse[ZipIngestionStatusResponse]:
         """Get Zip Ingestion Status Handler
 
-        Get a fan-out's live status + per-member outcomes.  Serves both container fan-outs: a ZIP archive's members and an email's attachments. Both expose the same ``results`` query, so one endpoint covers them rather than duplicating the tenant check and hydration.  Tenant-scoped via the TenantId search attribute (no per-path can_read check — intentionally consistent with the sibling generic Temporal endpoints below; the opaque workflow_id is only handed to the uploader, who had can_write on the target). The per-member results come from the workflow's ``results`` query (served from retained history), so once Temporal retention expires this 404s.
+        Get a ZIP fan-out's live status + per-member outcomes.  Tenant-scoped via the TenantId search attribute (no per-path can_read check — intentionally consistent with the sibling generic Temporal endpoints below; the opaque workflow_id is only handed to the uploader, who had can_write on the target). The per-member results come from the workflow's ``results`` query (served from retained history), so once Temporal retention expires this 404s.
 
         :param workflow_id: (required)
         :type workflow_id: str
@@ -1258,7 +1258,7 @@ class SystemJobsApi:
     ) -> RESTResponseType:
         """Get Zip Ingestion Status Handler
 
-        Get a fan-out's live status + per-member outcomes.  Serves both container fan-outs: a ZIP archive's members and an email's attachments. Both expose the same ``results`` query, so one endpoint covers them rather than duplicating the tenant check and hydration.  Tenant-scoped via the TenantId search attribute (no per-path can_read check — intentionally consistent with the sibling generic Temporal endpoints below; the opaque workflow_id is only handed to the uploader, who had can_write on the target). The per-member results come from the workflow's ``results`` query (served from retained history), so once Temporal retention expires this 404s.
+        Get a ZIP fan-out's live status + per-member outcomes.  Tenant-scoped via the TenantId search attribute (no per-path can_read check — intentionally consistent with the sibling generic Temporal endpoints below; the opaque workflow_id is only handed to the uploader, who had can_write on the target). The per-member results come from the workflow's ``results`` query (served from retained history), so once Temporal retention expires this 404s.
 
         :param workflow_id: (required)
         :type workflow_id: str

{ksapi-3.6.2 → ksapi-3.8.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/3.6.2/python'
+        self.user_agent = 'OpenAPI-Generator/3.8.0/python'
         self.client_side_validation = configuration.client_side_validation
 
     def __enter__(self):

{ksapi-3.6.2 → ksapi-3.8.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: 3.6.2".\
+               "SDK Package Version: 3.8.0".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]:

{ksapi-3.6.2 → ksapi-3.8.0}/ksapi/models/__init__.py

@@ -147,8 +147,6 @@ from ksapi.models.docx_paragraph_anchor_input import DocxParagraphAnchorInput
 from ksapi.models.docx_paragraph_anchor_output import DocxParagraphAnchorOutput
 from ksapi.models.download_artifact import DownloadArtifact
 from ksapi.models.edit_memory_chunk_request import EditMemoryChunkRequest
-from ksapi.models.email_metadata import EmailMetadata
-from ksapi.models.email_party import EmailParty
 from ksapi.models.email_sent_response import EmailSentResponse
 from ksapi.models.email_verification_request import EmailVerificationRequest
 from ksapi.models.enriched_citation import EnrichedCitation

{ksapi-3.6.2 → ksapi-3.8.0}/ksapi/models/ask_request.py

@@ -18,7 +18,8 @@ import re  # noqa: F401
 import json
 
 from pydantic import BaseModel, ConfigDict, Field, StrictStr
-from typing import Any, ClassVar, Dict
+from typing import Any, ClassVar, Dict, Optional
+from ksapi.models.supported_language import SupportedLanguage
 from typing import Optional, Set
 from typing_extensions import Self
 from pydantic_core import to_jsonable_python
@@ -28,7 +29,8 @@ class AskRequest(BaseModel):
     Request body for POST /v1/agent/ask.
     """ # noqa: E501
     prompt: StrictStr = Field(description="User prompt passed directly to the agent")
-    __properties: ClassVar[List[str]] = ["prompt"]
+    output_language: Optional[SupportedLanguage] = None
+    __properties: ClassVar[List[str]] = ["prompt", "output_language"]
 
     model_config = ConfigDict(
         validate_by_name=True,
@@ -81,7 +83,8 @@ class AskRequest(BaseModel):
             return cls.model_validate(obj)
 
         _obj = cls.model_validate({
-            "prompt": obj.get("prompt")
+            "prompt": obj.get("prompt"),
+            "output_language": obj.get("output_language")
         })
         return _obj
 

{ksapi-3.6.2 → ksapi-3.8.0}/ksapi/models/document_version_metadata.py

@@ -19,7 +19,6 @@ import json
 
 from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictInt, StrictStr
 from typing import Any, ClassVar, Dict, List, Optional
-from ksapi.models.email_metadata import EmailMetadata
 from ksapi.models.information_statistics import InformationStatistics
 from ksapi.models.pipeline_state import PipelineState
 from ksapi.models.xlsx_cell_anchor_output_or_docx_paragraph_anchor_output import XlsxCellAnchorOutputOrDocxParagraphAnchorOutput
@@ -45,7 +44,6 @@ class DocumentVersionMetadata(BaseModel):
     duration_ms: Optional[StrictInt] = Field(default=None, description="Media (audio/video) duration in milliseconds; null for non-media")
     language: Optional[StrictStr] = Field(default=None, description="ASR-detected language of the media transcript, as returned by the ASR provider; null for non-media or when the provider omits it")
     segment_count: Optional[StrictInt] = Field(default=None, description="Number of transcript segments produced by ASR; null for non-media")
-    email: Optional[EmailMetadata] = Field(default=None, description="Structured email headers; null for non-email documents")
     total_formulas: Optional[StrictInt] = Field(default=None, description="Total formula cells in the workbook (XLSX only)")
     xlsx_parse_result_s3: Optional[StrictStr] = Field(default=None, description="S3 URI to the full XLSX parse result JSON containing dependency graph, named ranges, and KPI catalog")
     xlsx_named_ranges: Optional[List[Dict[str, Any]]] = Field(default=None, description="Named ranges defined in the workbook (name, ref_string, scope)")
@@ -59,7 +57,7 @@ class DocumentVersionMetadata(BaseModel):
     file_md5: Optional[StrictStr] = Field(default='UNSET', description="MD5 of source bytes; 'UNSET' for pre-Phase-2 docs, real hex digest after first prep run")
     idempotency_key: Optional[StrictStr] = Field(default=None, description="Opt-in create key. A repeat ingest with the same key at the same (parent, name) replays this document instead of colliding — makes a ZIP fan-out member retry idempotent.")
     additional_properties: Dict[str, Any] = {}
-    __properties: ClassVar[List[str]] = ["source_s3", "cleaned_source_s3", "preconversion_source_s3", "cited_source_s3", "fast_plaintext_s3", "transcript_s3", "hash", "pipeline_state", "total_pages", "total_sections", "total_chunks", "duration_ms", "language", "segment_count", "email", "total_formulas", "xlsx_parse_result_s3", "xlsx_named_ranges", "xlsx_kpi_catalog", "citation_anchors", "information_statistics", "quota_charged", "quota_page_count", "quota_media_minutes", "quota_idempotency_key", "file_md5", "idempotency_key"]
+    __properties: ClassVar[List[str]] = ["source_s3", "cleaned_source_s3", "preconversion_source_s3", "cited_source_s3", "fast_plaintext_s3", "transcript_s3", "hash", "pipeline_state", "total_pages", "total_sections", "total_chunks", "duration_ms", "language", "segment_count", "total_formulas", "xlsx_parse_result_s3", "xlsx_named_ranges", "xlsx_kpi_catalog", "citation_anchors", "information_statistics", "quota_charged", "quota_page_count", "quota_media_minutes", "quota_idempotency_key", "file_md5", "idempotency_key"]
 
     model_config = ConfigDict(
         validate_by_name=True,
@@ -105,9 +103,6 @@ class DocumentVersionMetadata(BaseModel):
         # override the default output from pydantic by calling `to_dict()` of pipeline_state
         if self.pipeline_state:
             _dict['pipeline_state'] = self.pipeline_state.to_dict()
-        # override the default output from pydantic by calling `to_dict()` of email
-        if self.email:
-            _dict['email'] = self.email.to_dict()
         # override the default output from pydantic by calling `to_dict()` of each item in citation_anchors (list)
         _items = []
         if self.citation_anchors:
@@ -193,11 +188,6 @@ class DocumentVersionMetadata(BaseModel):
         if self.segment_count is None and "segment_count" in self.model_fields_set:
             _dict['segment_count'] = None
 
-        # set to None if email (nullable) is None
-        # and model_fields_set contains the field
-        if self.email is None and "email" in self.model_fields_set:
-            _dict['email'] = None
-
         # set to None if total_formulas (nullable) is None
         # and model_fields_set contains the field
         if self.total_formulas is None and "total_formulas" in self.model_fields_set:
@@ -259,7 +249,6 @@ class DocumentVersionMetadata(BaseModel):
             "duration_ms": obj.get("duration_ms"),
             "language": obj.get("language"),
             "segment_count": obj.get("segment_count"),
-            "email": EmailMetadata.from_dict(obj["email"]) if obj.get("email") is not None else None,
             "total_formulas": obj.get("total_formulas"),
             "xlsx_parse_result_s3": obj.get("xlsx_parse_result_s3"),
             "xlsx_named_ranges": obj.get("xlsx_named_ranges"),

{ksapi-3.6.2 → ksapi-3.8.0}/ksapi/models/document_version_metadata_update.py

@@ -19,7 +19,6 @@ import json
 
 from pydantic import BaseModel, ConfigDict, StrictBool, StrictInt, StrictStr
 from typing import Any, ClassVar, Dict, List, Optional
-from ksapi.models.email_metadata import EmailMetadata
 from ksapi.models.information_statistics import InformationStatistics
 from ksapi.models.pipeline_state import PipelineState
 from ksapi.models.xlsx_cell_anchor_input_or_docx_paragraph_anchor_input import XlsxCellAnchorInputOrDocxParagraphAnchorInput
@@ -48,7 +47,6 @@ class DocumentVersionMetadataUpdate(BaseModel):
     duration_ms: Optional[StrictInt] = None
     language: Optional[StrictStr] = None
     segment_count: Optional[StrictInt] = None
-    email: Optional[EmailMetadata] = None
     total_formulas: Optional[StrictInt] = None
     xlsx_parse_result_s3: Optional[StrictStr] = None
     xlsx_named_ranges: Optional[List[Dict[str, Any]]] = None
@@ -60,7 +58,7 @@ class DocumentVersionMetadataUpdate(BaseModel):
     quota_media_minutes: Optional[StrictInt] = None
     quota_idempotency_key: Optional[StrictStr] = None
     file_md5: Optional[StrictStr] = None
-    __properties: ClassVar[List[str]] = ["source_s3", "cleaned_source_s3", "preconversion_source_s3", "cited_source_s3", "standard_pipeline_json_s3", "fast_plaintext_s3", "transcript_s3", "high_accuracy_content_list_s3", "high_accuracy_middle_s3", "hash", "pipeline_state", "total_pages", "total_sections", "total_chunks", "duration_ms", "language", "segment_count", "email", "total_formulas", "xlsx_parse_result_s3", "xlsx_named_ranges", "xlsx_kpi_catalog", "citation_anchors", "information_statistics", "quota_charged", "quota_page_count", "quota_media_minutes", "quota_idempotency_key", "file_md5"]
+    __properties: ClassVar[List[str]] = ["source_s3", "cleaned_source_s3", "preconversion_source_s3", "cited_source_s3", "standard_pipeline_json_s3", "fast_plaintext_s3", "transcript_s3", "high_accuracy_content_list_s3", "high_accuracy_middle_s3", "hash", "pipeline_state", "total_pages", "total_sections", "total_chunks", "duration_ms", "language", "segment_count", "total_formulas", "xlsx_parse_result_s3", "xlsx_named_ranges", "xlsx_kpi_catalog", "citation_anchors", "information_statistics", "quota_charged", "quota_page_count", "quota_media_minutes", "quota_idempotency_key", "file_md5"]
 
     model_config = ConfigDict(
         validate_by_name=True,
@@ -104,9 +102,6 @@ class DocumentVersionMetadataUpdate(BaseModel):
         # override the default output from pydantic by calling `to_dict()` of pipeline_state
         if self.pipeline_state:
             _dict['pipeline_state'] = self.pipeline_state.to_dict()
-        # override the default output from pydantic by calling `to_dict()` of email
-        if self.email:
-            _dict['email'] = self.email.to_dict()
         # override the default output from pydantic by calling `to_dict()` of each item in citation_anchors (list)
         _items = []
         if self.citation_anchors:
@@ -202,11 +197,6 @@ class DocumentVersionMetadataUpdate(BaseModel):
         if self.segment_count is None and "segment_count" in self.model_fields_set:
             _dict['segment_count'] = None
 
-        # set to None if email (nullable) is None
-        # and model_fields_set contains the field
-        if self.email is None and "email" in self.model_fields_set:
-            _dict['email'] = None
-
         # set to None if total_formulas (nullable) is None
         # and model_fields_set contains the field
         if self.total_formulas is None and "total_formulas" in self.model_fields_set:
@@ -291,7 +281,6 @@ class DocumentVersionMetadataUpdate(BaseModel):
             "duration_ms": obj.get("duration_ms"),
             "language": obj.get("language"),
             "segment_count": obj.get("segment_count"),
-            "email": EmailMetadata.from_dict(obj["email"]) if obj.get("email") is not None else None,
             "total_formulas": obj.get("total_formulas"),
             "xlsx_parse_result_s3": obj.get("xlsx_parse_result_s3"),
             "xlsx_named_ranges": obj.get("xlsx_named_ranges"),

ksapi-3.8.0/ksapi/models/ingest_document_response.py

@@ -0,0 +1,93 @@
+# 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, StrictStr
+from typing import Any, ClassVar, Dict
+from uuid import UUID
+from typing import Optional, Set
+from typing_extensions import Self
+from pydantic_core import to_jsonable_python
+
+class IngestDocumentResponse(BaseModel):
+    """
+    Response with workflow execution details.
+    """ # noqa: E501
+    workflow_id: StrictStr = Field(description="Temporal workflow ID")
+    document_id: UUID
+    document_version_id: UUID
+    __properties: ClassVar[List[str]] = ["workflow_id", "document_id", "document_version_id"]
+
+    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 IngestDocumentResponse 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,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of IngestDocumentResponse from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "workflow_id": obj.get("workflow_id"),
+            "document_id": obj.get("document_id"),
+            "document_version_id": obj.get("document_version_id")
+        })
+        return _obj
+
+

{ksapi-3.6.2 → ksapi-3.8.0}/ksapi/models/pipeline_state.py

@@ -21,6 +21,7 @@ from datetime import datetime
 from pydantic import BaseModel, ConfigDict, Field, StrictInt, StrictStr
 from typing import Any, ClassVar, Dict, List, Optional
 from ksapi.models.chunk_type import ChunkType
+from ksapi.models.image_taxonomy import ImageTaxonomy
 from ksapi.models.ingestion_mode import IngestionMode
 from ksapi.models.pipeline_status import PipelineStatus
 from typing import Optional, Set
@@ -34,15 +35,16 @@ class PipelineState(BaseModel):
     status: PipelineStatus
     last_run_timestamp: Optional[datetime] = Field(default=None, description="Timestamp of the last pipeline execution attempt (set once when a run starts)")
     last_state_update_timestamp: Optional[datetime] = Field(default=None, description="Timestamp of the last pipeline state change (set by activities)")
-    last_activity: Optional[StrictStr] = Field(default=None, description="Name of the last activity that executed (e.g., 'document_preparation')")
+    last_activity: Optional[StrictStr] = Field(default=None, description="Name of the last activity that executed (e.g., 'pdf_preparation_activity')")
     error: Optional[StrictStr] = Field(default=None, description="Error message if pipeline failed")
     temporal_workflow_id: Optional[StrictStr] = Field(default=None, description="Temporal workflow ID for tracking the ingestion run")
     chunks_processed: Optional[StrictInt] = Field(default=None, description="Number of chunks processed (for progress tracking)")
     page_dpi: Optional[StrictInt] = Field(default=None, description="DPI used for PDF page screenshots during ingestion")
     ingestion_mode: Optional[IngestionMode] = None
     chunk_type: Optional[ChunkType] = None
+    secondary_taxonomy: Optional[ImageTaxonomy] = None
     additional_properties: Dict[str, Any] = {}
-    __properties: ClassVar[List[str]] = ["status", "last_run_timestamp", "last_state_update_timestamp", "last_activity", "error", "temporal_workflow_id", "chunks_processed", "page_dpi", "ingestion_mode", "chunk_type"]
+    __properties: ClassVar[List[str]] = ["status", "last_run_timestamp", "last_state_update_timestamp", "last_activity", "error", "temporal_workflow_id", "chunks_processed", "page_dpi", "ingestion_mode", "chunk_type", "secondary_taxonomy"]
 
     model_config = ConfigDict(
         validate_by_name=True,
@@ -146,7 +148,8 @@ class PipelineState(BaseModel):
             "chunks_processed": obj.get("chunks_processed"),
             "page_dpi": obj.get("page_dpi"),
             "ingestion_mode": obj.get("ingestion_mode"),
-            "chunk_type": obj.get("chunk_type")
+            "chunk_type": obj.get("chunk_type"),
+            "secondary_taxonomy": obj.get("secondary_taxonomy")
         })
         # store additional fields in additional_properties
         for _key in obj.keys():

{ksapi-3.6.2 → ksapi-3.8.0}/ksapi/models/upload_format.py

@@ -17,7 +17,7 @@ import pprint
 import re  # noqa: F401
 import json
 
-from pydantic import BaseModel, ConfigDict, StrictStr
+from pydantic import BaseModel, ConfigDict, Field, StrictInt, StrictStr
 from typing import Any, ClassVar, Dict
 from typing import Optional, Set
 from typing_extensions import Self
@@ -29,7 +29,8 @@ class UploadFormat(BaseModel):
     """ # noqa: E501
     extension: StrictStr
     content_type: StrictStr
-    __properties: ClassVar[List[str]] = ["extension", "content_type"]
+    max_bytes: StrictInt = Field(description="Largest file of this format the buffered uploads accept (new document, new version, ZIP member, workflow-run file). A new audio/video document uses the resumable upload, capped at upload.max_media_bytes")
+    __properties: ClassVar[List[str]] = ["extension", "content_type", "max_bytes"]
 
     model_config = ConfigDict(
         validate_by_name=True,
@@ -83,7 +84,8 @@ class UploadFormat(BaseModel):
 
         _obj = cls.model_validate({
             "extension": obj.get("extension"),
-            "content_type": obj.get("content_type")
+            "content_type": obj.get("content_type"),
+            "max_bytes": obj.get("max_bytes")
         })
         return _obj
 

{ksapi-3.6.2 → ksapi-3.8.0}/ksapi/models/user_message_request.py

@@ -19,6 +19,7 @@ import json
 
 from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictStr
 from typing import Any, ClassVar, Dict, Optional
+from ksapi.models.supported_language import SupportedLanguage
 from typing import Optional, Set
 from typing_extensions import Self
 from pydantic_core import to_jsonable_python
@@ -29,7 +30,8 @@ class UserMessageRequest(BaseModel):
     """ # noqa: E501
     input_text: Optional[StrictStr] = Field(default='', description="User input text. Mock agent dev controls may be embedded here (e.g. /mock duration=5 wps=3 scenario=tool_call_once).")
     fast_mode: Optional[StrictBool] = Field(default=None, description="Answer with the faster, lower-cost chat profile. Omit to use the tenant's default_fast_mode; true/false overrides it for this message. Ignored when the tenant pins a chat profile and on workflow-run threads.")
-    __properties: ClassVar[List[str]] = ["input_text", "fast_mode"]
+    output_language: Optional[SupportedLanguage] = None
+    __properties: ClassVar[List[str]] = ["input_text", "fast_mode", "output_language"]
 
     model_config = ConfigDict(
         validate_by_name=True,
@@ -88,7 +90,8 @@ class UserMessageRequest(BaseModel):
 
         _obj = cls.model_validate({
             "input_text": obj.get("input_text") if obj.get("input_text") is not None else '',
-            "fast_mode": obj.get("fast_mode")
+            "fast_mode": obj.get("fast_mode"),
+            "output_language": obj.get("output_language")
         })
         return _obj
 

{ksapi-3.6.2 → ksapi-3.8.0}/ksapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ksapi
-Version: 3.6.2
+Version: 3.8.0
 Summary: Knowledge Stack API
 Home-page: 
 Author: OpenAPI Generator community
@@ -90,6 +90,9 @@ answer = AgentApi(client).agent_ask(AskRequest(prompt="What are the renewal term
 print(answer.text)
 ```
 
+The answer is written in the tenant's configured language. Pass
+`output_language="en"` or `"zh"` to choose it for one request.
+
 Citation-grounded, multi-turn chat runs through **threads**; each assistant
 message exposes `content.citations`. Stream those tokens live below.
 

{ksapi-3.6.2 → ksapi-3.8.0}/ksapi.egg-info/SOURCES.txt

@@ -193,8 +193,6 @@ ksapi/models/docx_paragraph_anchor_input.py
 ksapi/models/docx_paragraph_anchor_output.py
 ksapi/models/download_artifact.py
 ksapi/models/edit_memory_chunk_request.py
-ksapi/models/email_metadata.py
-ksapi/models/email_party.py
 ksapi/models/email_sent_response.py
 ksapi/models/email_verification_request.py
 ksapi/models/enriched_citation.py
@@ -619,8 +617,6 @@ test/test_docx_paragraph_anchor_input.py
 test/test_docx_paragraph_anchor_output.py
 test/test_download_artifact.py
 test/test_edit_memory_chunk_request.py
-test/test_email_metadata.py
-test/test_email_party.py
 test/test_email_sent_response.py
 test/test_email_verification_request.py
 test/test_enriched_citation.py

{ksapi-3.6.2 → ksapi-3.8.0}/pyproject.toml

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

{ksapi-3.6.2 → ksapi-3.8.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 = "3.6.2"
+VERSION = "3.8.0"
 PYTHON_REQUIRES = ">= 3.9"
 REQUIRES = [
     "urllib3 >= 2.1.0, < 3.0.0",