@knowledge-stack/ksapi 2.4.3 → 2.6.0

package/dist/models/AcceptTenantInvitationResponse.js

@@ -0,0 +1,60 @@
+"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.AcceptTenantInvitationResponsePropertyValidationAttributesMap = void 0;
+exports.instanceOfAcceptTenantInvitationResponse = instanceOfAcceptTenantInvitationResponse;
+exports.AcceptTenantInvitationResponseFromJSON = AcceptTenantInvitationResponseFromJSON;
+exports.AcceptTenantInvitationResponseFromJSONTyped = AcceptTenantInvitationResponseFromJSONTyped;
+exports.AcceptTenantInvitationResponseToJSON = AcceptTenantInvitationResponseToJSON;
+exports.AcceptTenantInvitationResponseToJSONTyped = AcceptTenantInvitationResponseToJSONTyped;
+exports.AcceptTenantInvitationResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the AcceptTenantInvitationResponse interface.
+ */
+function instanceOfAcceptTenantInvitationResponse(value) {
+    if (!('tenantId' in value) || value['tenantId'] === undefined)
+        return false;
+    if (!('tenantName' in value) || value['tenantName'] === undefined)
+        return false;
+    if (!('userId' in value) || value['userId'] === undefined)
+        return false;
+    return true;
+}
+function AcceptTenantInvitationResponseFromJSON(json) {
+    return AcceptTenantInvitationResponseFromJSONTyped(json, false);
+}
+function AcceptTenantInvitationResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'tenantId': json['tenant_id'],
+        'tenantName': json['tenant_name'],
+        'userId': json['user_id'],
+    };
+}
+function AcceptTenantInvitationResponseToJSON(json) {
+    return AcceptTenantInvitationResponseToJSONTyped(json, false);
+}
+function AcceptTenantInvitationResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'tenant_id': value['tenantId'],
+        'tenant_name': value['tenantName'],
+        'user_id': value['userId'],
+    };
+}

package/dist/models/ChunkMetadata.d.ts

@@ -66,6 +66,18 @@ export interface ChunkMetadata {
      * @memberof ChunkMetadata
      */
     endMs?: number | null;
+    /**
+     * Every speaker label appearing in this chunk's segments, sorted. Lets a citation say which turn it came from. None when the provider does not diarize.
+     * @type {Array<number>}
+     * @memberof ChunkMetadata
+     */
+    speakers?: Array<number> | null;
+    /**
+     * Every language the ASR recognised across this chunk's segments, sorted. A meeting routinely code-switches, so a chunk can hold more than one; the document-level language is only the majority label and misreports a bilingual recording. None for non-media chunks and for media ingested before this field existed.
+     * @type {Array<string>}
+     * @memberof ChunkMetadata
+     */
+    languages?: Array<string> | null;
     /**
      * Per-ASR-segment spans inside this media chunk, in order, each carrying its char offset in the chunk content. Lets citation resolution narrow a chunk-level timeframe to the enclosing segment. None for non-media chunks and media ingested before this field existed.
      * @type {Array<SegmentSpan>}

package/dist/models/ChunkMetadata.js

@@ -45,6 +45,8 @@ function ChunkMetadataFromJSONTyped(json, ignoreDiscriminator) {
         'secondaryTaxonomy': json['secondary_taxonomy'] == null ? undefined : (0, ImageTaxonomy_1.ImageTaxonomyFromJSON)(json['secondary_taxonomy']),
         'startMs': json['start_ms'] == null ? undefined : json['start_ms'],
         'endMs': json['end_ms'] == null ? undefined : json['end_ms'],
+        'speakers': json['speakers'] == null ? undefined : json['speakers'],
+        'languages': json['languages'] == null ? undefined : json['languages'],
         'segments': json['segments'] == null ? undefined : (json['segments'].map(SegmentSpan_1.SegmentSpanFromJSON)),
         'sheetName': json['sheet_name'] == null ? undefined : json['sheet_name'],
         'blockType': json['block_type'] == null ? undefined : json['block_type'],
@@ -73,6 +75,8 @@ function ChunkMetadataToJSONTyped(value, ignoreDiscriminator = false) {
         'secondary_taxonomy': (0, ImageTaxonomy_1.ImageTaxonomyToJSON)(value['secondaryTaxonomy']),
         'start_ms': value['startMs'],
         'end_ms': value['endMs'],
+        'speakers': value['speakers'],
+        'languages': value['languages'],
         'segments': value['segments'] == null ? undefined : (value['segments'].map(SegmentSpan_1.SegmentSpanToJSON)),
         'sheet_name': value['sheetName'],
         'block_type': value['blockType'],

package/dist/models/CreateUploadRequest.d.ts

@@ -45,6 +45,24 @@ export interface CreateUploadRequest {
      * @memberof CreateUploadRequest
      */
     tagIds?: Array<string>;
+    /**
+     * Workflow run this upload belongs to; attributes the resulting document to the run in the audit log. Must be sent together with workflow_definition_id, and only by an assumed identity.
+     * @type {string}
+     * @memberof CreateUploadRequest
+     */
+    workflowRunId?: string | null;
+    /**
+     * Workflow definition for workflow_run_id.
+     * @type {string}
+     * @memberof CreateUploadRequest
+     */
+    workflowDefinitionId?: string | null;
+    /**
+     * Replay key for callers that retry (e.g. the ZIP fan-out); completing twice with the same key replays the existing document instead of creating a duplicate.
+     * @type {string}
+     * @memberof CreateUploadRequest
+     */
+    idempotencyKey?: string | null;
 }
 export declare const CreateUploadRequestPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/models/CreateUploadRequest.js

@@ -47,6 +47,9 @@ function CreateUploadRequestFromJSONTyped(json, ignoreDiscriminator) {
         'filename': json['filename'],
         'sizeBytes': json['size_bytes'],
         'tagIds': json['tag_ids'] == null ? undefined : json['tag_ids'],
+        'workflowRunId': json['workflow_run_id'] == null ? undefined : json['workflow_run_id'],
+        'workflowDefinitionId': json['workflow_definition_id'] == null ? undefined : json['workflow_definition_id'],
+        'idempotencyKey': json['idempotency_key'] == null ? undefined : json['idempotency_key'],
     };
 }
 function CreateUploadRequestToJSON(json) {
@@ -62,5 +65,8 @@ function CreateUploadRequestToJSONTyped(value, ignoreDiscriminator = false) {
         'filename': value['filename'],
         'size_bytes': value['sizeBytes'],
         'tag_ids': value['tagIds'],
+        'workflow_run_id': value['workflowRunId'],
+        'workflow_definition_id': value['workflowDefinitionId'],
+        'idempotency_key': value['idempotencyKey'],
     };
 }

package/dist/models/DocumentVersionMetadata.d.ts

@@ -12,6 +12,7 @@
 import type { PipelineState } from './PipelineState';
 import type { XlsxCellAnchorOutputOrDocxParagraphAnchorOutput } from './XlsxCellAnchorOutputOrDocxParagraphAnchorOutput';
 import type { InformationStatistics } from './InformationStatistics';
+import type { EmailMetadata } from './EmailMetadata';
 /**
  * Schema for document_version.system_metadata JSONB field.
  *
@@ -111,6 +112,12 @@ export interface DocumentVersionMetadata {
      * @memberof DocumentVersionMetadata
      */
     segmentCount?: number | null;
+    /**
+     * Structured email headers; null for non-email documents
+     * @type {EmailMetadata}
+     * @memberof DocumentVersionMetadata
+     */
+    email?: EmailMetadata | null;
     /**
      * Total formula cells in the workbook (XLSX only)
      * @type {number}

package/dist/models/DocumentVersionMetadata.js

@@ -22,6 +22,7 @@ exports.DocumentVersionMetadataToJSONTyped = DocumentVersionMetadataToJSONTyped;
 const PipelineState_1 = require("./PipelineState");
 const XlsxCellAnchorOutputOrDocxParagraphAnchorOutput_1 = require("./XlsxCellAnchorOutputOrDocxParagraphAnchorOutput");
 const InformationStatistics_1 = require("./InformationStatistics");
+const EmailMetadata_1 = require("./EmailMetadata");
 exports.DocumentVersionMetadataPropertyValidationAttributesMap = {};
 /**
  * Check if a given object implements the DocumentVersionMetadata interface.
@@ -51,6 +52,7 @@ function DocumentVersionMetadataFromJSONTyped(json, ignoreDiscriminator) {
         'durationMs': json['duration_ms'] == null ? undefined : json['duration_ms'],
         'language': json['language'] == null ? undefined : json['language'],
         'segmentCount': json['segment_count'] == null ? undefined : json['segment_count'],
+        'email': json['email'] == null ? undefined : (0, EmailMetadata_1.EmailMetadataFromJSON)(json['email']),
         'totalFormulas': json['total_formulas'] == null ? undefined : json['total_formulas'],
         'xlsxParseResultS3': json['xlsx_parse_result_s3'] == null ? undefined : json['xlsx_parse_result_s3'],
         'xlsxNamedRanges': json['xlsx_named_ranges'] == null ? undefined : json['xlsx_named_ranges'],
@@ -87,6 +89,7 @@ function DocumentVersionMetadataToJSONTyped(value, ignoreDiscriminator = false)
         'duration_ms': value['durationMs'],
         'language': value['language'],
         'segment_count': value['segmentCount'],
+        'email': (0, EmailMetadata_1.EmailMetadataToJSON)(value['email']),
         'total_formulas': value['totalFormulas'],
         'xlsx_parse_result_s3': value['xlsxParseResultS3'],
         'xlsx_named_ranges': value['xlsxNamedRanges'],

package/dist/models/DocumentVersionMetadataUpdate.d.ts

@@ -12,6 +12,7 @@
 import type { PipelineState } from './PipelineState';
 import type { XlsxCellAnchorInputOrDocxParagraphAnchorInput } from './XlsxCellAnchorInputOrDocxParagraphAnchorInput';
 import type { InformationStatistics } from './InformationStatistics';
+import type { EmailMetadata } from './EmailMetadata';
 /**
  * Partial update schema for document version metadata.
  *
@@ -123,6 +124,12 @@ export interface DocumentVersionMetadataUpdate {
      * @memberof DocumentVersionMetadataUpdate
      */
     segmentCount?: number | null;
+    /**
+     *
+     * @type {EmailMetadata}
+     * @memberof DocumentVersionMetadataUpdate
+     */
+    email?: EmailMetadata | null;
     /**
      *
      * @type {number}

package/dist/models/DocumentVersionMetadataUpdate.js

@@ -22,6 +22,7 @@ exports.DocumentVersionMetadataUpdateToJSONTyped = DocumentVersionMetadataUpdate
 const PipelineState_1 = require("./PipelineState");
 const XlsxCellAnchorInputOrDocxParagraphAnchorInput_1 = require("./XlsxCellAnchorInputOrDocxParagraphAnchorInput");
 const InformationStatistics_1 = require("./InformationStatistics");
+const EmailMetadata_1 = require("./EmailMetadata");
 exports.DocumentVersionMetadataUpdatePropertyValidationAttributesMap = {};
 /**
  * Check if a given object implements the DocumentVersionMetadataUpdate interface.
@@ -54,6 +55,7 @@ function DocumentVersionMetadataUpdateFromJSONTyped(json, ignoreDiscriminator) {
         'durationMs': json['duration_ms'] == null ? undefined : json['duration_ms'],
         'language': json['language'] == null ? undefined : json['language'],
         'segmentCount': json['segment_count'] == null ? undefined : json['segment_count'],
+        'email': json['email'] == null ? undefined : (0, EmailMetadata_1.EmailMetadataFromJSON)(json['email']),
         'totalFormulas': json['total_formulas'] == null ? undefined : json['total_formulas'],
         'xlsxParseResultS3': json['xlsx_parse_result_s3'] == null ? undefined : json['xlsx_parse_result_s3'],
         'xlsxNamedRanges': json['xlsx_named_ranges'] == null ? undefined : json['xlsx_named_ranges'],
@@ -92,6 +94,7 @@ function DocumentVersionMetadataUpdateToJSONTyped(value, ignoreDiscriminator = f
         'duration_ms': value['durationMs'],
         'language': value['language'],
         'segment_count': value['segmentCount'],
+        'email': (0, EmailMetadata_1.EmailMetadataToJSON)(value['email']),
         'total_formulas': value['totalFormulas'],
         'xlsx_parse_result_s3': value['xlsxParseResultS3'],
         'xlsx_named_ranges': value['xlsxNamedRanges'],

package/dist/models/EmailMetadata.d.ts

@@ -0,0 +1,119 @@
+/**
+ * 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 { EmailParty } from './EmailParty';
+/**
+ * Structured headers of an ingested email (EMAIL document type only).
+ *
+ * Populated by ``document_preparation_activity`` from the same parse that
+ * renders the message body, so the stored metadata and the rendered document
+ * cannot disagree. Null on a multi-message archive: its messages are ingested
+ * as their own documents, and each carries its own block.
+ * @export
+ * @interface EmailMetadata
+ */
+export interface EmailMetadata {
+    /**
+     * Message subject
+     * @type {string}
+     * @memberof EmailMetadata
+     */
+    subject?: string;
+    /**
+     * Sender; null if unparseable
+     * @type {EmailParty}
+     * @memberof EmailMetadata
+     */
+    sender?: EmailParty | null;
+    /**
+     * To recipients
+     * @type {Array<EmailParty>}
+     * @memberof EmailMetadata
+     */
+    to?: Array<EmailParty>;
+    /**
+     * Cc recipients
+     * @type {Array<EmailParty>}
+     * @memberof EmailMetadata
+     */
+    cc?: Array<EmailParty>;
+    /**
+     * Bcc recipients. Present only when the source file carries them — a sending MTA strips Bcc, so it survives in the sender's own copy (a .msg exported from Sent Items) but never in a received .eml.
+     * @type {Array<EmailParty>}
+     * @memberof EmailMetadata
+     */
+    bcc?: Array<EmailParty>;
+    /**
+     * Date header, as written
+     * @type {string}
+     * @memberof EmailMetadata
+     */
+    sentAt?: string;
+    /**
+     * RFC 5322 Message-ID
+     * @type {string}
+     * @memberof EmailMetadata
+     */
+    messageId?: string;
+    /**
+     * Message-ID being replied to
+     * @type {string}
+     * @memberof EmailMetadata
+     */
+    inReplyTo?: string;
+    /**
+     * Reply chain, oldest first
+     * @type {Array<string>}
+     * @memberof EmailMetadata
+     */
+    references?: Array<string>;
+    /**
+     * Outlook PidTagConversationTopic (.msg only)
+     * @type {string}
+     * @memberof EmailMetadata
+     */
+    conversationTopic?: string;
+    /**
+     * Message-ID that started the thread — the first References entry, or this message's own id. Group by this to reconstruct a thread.
+     * @type {string}
+     * @memberof EmailMetadata
+     */
+    threadRootId?: string;
+    /**
+     * The verbatim header block, so a header this schema does not model stays recoverable without re-reading the source file.
+     * @type {string}
+     * @memberof EmailMetadata
+     */
+    rawHeaders?: string;
+}
+export declare const EmailMetadataPropertyValidationAttributesMap: {
+    [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 EmailMetadata interface.
+ */
+export declare function instanceOfEmailMetadata(value: object): value is EmailMetadata;
+export declare function EmailMetadataFromJSON(json: any): EmailMetadata;
+export declare function EmailMetadataFromJSONTyped(json: any, ignoreDiscriminator: boolean): EmailMetadata;
+export declare function EmailMetadataToJSON(json: any): EmailMetadata;
+export declare function EmailMetadataToJSONTyped(value?: EmailMetadata | null, ignoreDiscriminator?: boolean): any;

package/dist/models/EmailMetadata.js

@@ -0,0 +1,73 @@
+"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.EmailMetadataPropertyValidationAttributesMap = void 0;
+exports.instanceOfEmailMetadata = instanceOfEmailMetadata;
+exports.EmailMetadataFromJSON = EmailMetadataFromJSON;
+exports.EmailMetadataFromJSONTyped = EmailMetadataFromJSONTyped;
+exports.EmailMetadataToJSON = EmailMetadataToJSON;
+exports.EmailMetadataToJSONTyped = EmailMetadataToJSONTyped;
+const EmailParty_1 = require("./EmailParty");
+exports.EmailMetadataPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the EmailMetadata interface.
+ */
+function instanceOfEmailMetadata(value) {
+    return true;
+}
+function EmailMetadataFromJSON(json) {
+    return EmailMetadataFromJSONTyped(json, false);
+}
+function EmailMetadataFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'subject': json['subject'] == null ? undefined : json['subject'],
+        'sender': json['sender'] == null ? undefined : (0, EmailParty_1.EmailPartyFromJSON)(json['sender']),
+        'to': json['to'] == null ? undefined : (json['to'].map(EmailParty_1.EmailPartyFromJSON)),
+        'cc': json['cc'] == null ? undefined : (json['cc'].map(EmailParty_1.EmailPartyFromJSON)),
+        'bcc': json['bcc'] == null ? undefined : (json['bcc'].map(EmailParty_1.EmailPartyFromJSON)),
+        'sentAt': json['sent_at'] == null ? undefined : json['sent_at'],
+        'messageId': json['message_id'] == null ? undefined : json['message_id'],
+        'inReplyTo': json['in_reply_to'] == null ? undefined : json['in_reply_to'],
+        'references': json['references'] == null ? undefined : json['references'],
+        'conversationTopic': json['conversation_topic'] == null ? undefined : json['conversation_topic'],
+        'threadRootId': json['thread_root_id'] == null ? undefined : json['thread_root_id'],
+        'rawHeaders': json['raw_headers'] == null ? undefined : json['raw_headers'],
+    };
+}
+function EmailMetadataToJSON(json) {
+    return EmailMetadataToJSONTyped(json, false);
+}
+function EmailMetadataToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'subject': value['subject'],
+        'sender': (0, EmailParty_1.EmailPartyToJSON)(value['sender']),
+        'to': value['to'] == null ? undefined : (value['to'].map(EmailParty_1.EmailPartyToJSON)),
+        'cc': value['cc'] == null ? undefined : (value['cc'].map(EmailParty_1.EmailPartyToJSON)),
+        'bcc': value['bcc'] == null ? undefined : (value['bcc'].map(EmailParty_1.EmailPartyToJSON)),
+        'sent_at': value['sentAt'],
+        'message_id': value['messageId'],
+        'in_reply_to': value['inReplyTo'],
+        'references': value['references'],
+        'conversation_topic': value['conversationTopic'],
+        'thread_root_id': value['threadRootId'],
+        'raw_headers': value['rawHeaders'],
+    };
+}

package/dist/models/EmailParty.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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.
+ */
+/**
+ * One email participant.
+ * @export
+ * @interface EmailParty
+ */
+export interface EmailParty {
+    /**
+     * Display name; empty if unnamed
+     * @type {string}
+     * @memberof EmailParty
+     */
+    name?: string;
+    /**
+     * Email address
+     * @type {string}
+     * @memberof EmailParty
+     */
+    address: string;
+}
+export declare const EmailPartyPropertyValidationAttributesMap: {
+    [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 EmailParty interface.
+ */
+export declare function instanceOfEmailParty(value: object): value is EmailParty;
+export declare function EmailPartyFromJSON(json: any): EmailParty;
+export declare function EmailPartyFromJSONTyped(json: any, ignoreDiscriminator: boolean): EmailParty;
+export declare function EmailPartyToJSON(json: any): EmailParty;
+export declare function EmailPartyToJSONTyped(value?: EmailParty | null, ignoreDiscriminator?: boolean): any;

package/dist/models/EmailParty.js

@@ -0,0 +1,54 @@
+"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.EmailPartyPropertyValidationAttributesMap = void 0;
+exports.instanceOfEmailParty = instanceOfEmailParty;
+exports.EmailPartyFromJSON = EmailPartyFromJSON;
+exports.EmailPartyFromJSONTyped = EmailPartyFromJSONTyped;
+exports.EmailPartyToJSON = EmailPartyToJSON;
+exports.EmailPartyToJSONTyped = EmailPartyToJSONTyped;
+exports.EmailPartyPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the EmailParty interface.
+ */
+function instanceOfEmailParty(value) {
+    if (!('address' in value) || value['address'] === undefined)
+        return false;
+    return true;
+}
+function EmailPartyFromJSON(json) {
+    return EmailPartyFromJSONTyped(json, false);
+}
+function EmailPartyFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'name': json['name'] == null ? undefined : json['name'],
+        'address': json['address'],
+    };
+}
+function EmailPartyToJSON(json) {
+    return EmailPartyToJSONTyped(json, false);
+}
+function EmailPartyToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'name': value['name'],
+        'address': value['address'],
+    };
+}

package/dist/models/EventResponse.d.ts

@@ -52,6 +52,12 @@ export interface EventResponse {
      * @memberof EventResponse
      */
     actorUserId: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof EventResponse
+     */
+    actorOnBehalfOf?: string | null;
     /**
      *
      * @type {{ [key: string]: any; }}

package/dist/models/EventResponse.js

@@ -54,6 +54,7 @@ function EventResponseFromJSONTyped(json, ignoreDiscriminator) {
         'kind': json['kind'],
         'ts': (new Date(json['ts'])),
         'actorUserId': json['actor_user_id'],
+        'actorOnBehalfOf': json['actor_on_behalf_of'] == null ? undefined : json['actor_on_behalf_of'],
         'payload': json['payload'],
         'actor': json['actor'] == null ? undefined : (0, UserInfo_1.UserInfoFromJSON)(json['actor']),
         'subjectName': json['subject_name'] == null ? undefined : json['subject_name'],
@@ -76,6 +77,7 @@ function EventResponseToJSONTyped(value, ignoreDiscriminator = false) {
         'kind': value['kind'],
         'ts': value['ts'].toISOString(),
         'actor_user_id': value['actorUserId'],
+        'actor_on_behalf_of': value['actorOnBehalfOf'],
         'payload': value['payload'],
         'actor': (0, UserInfo_1.UserInfoToJSON)(value['actor']),
         'subject_name': value['subjectName'],

package/dist/models/ImageTaxonomy.d.ts

@@ -15,6 +15,7 @@
  */
 export declare const ImageTaxonomy: {
     readonly Picture: 'picture';
+    readonly Slide: 'slide';
     readonly Flowchart: 'flowchart';
 };
 export type ImageTaxonomy = typeof ImageTaxonomy[keyof typeof ImageTaxonomy];

package/dist/models/ImageTaxonomy.js

@@ -25,6 +25,7 @@ exports.ImageTaxonomyToJSONTyped = ImageTaxonomyToJSONTyped;
  */
 exports.ImageTaxonomy = {
     Picture: 'picture',
+    Slide: 'slide',
     Flowchart: 'flowchart'
 };
 function instanceOfImageTaxonomy(value) {

package/dist/models/IngestDocumentResponse.d.ts

@@ -33,6 +33,24 @@ export interface IngestDocumentResponse {
      * @memberof IngestDocumentResponse
      */
     documentVersionId: string;
+    /**
+     * Folder created to hold this upload and its members. Set for email uploads, which always nest inside their own folder; null for every other type, which ingest directly into path_part_id.
+     * @type {string}
+     * @memberof IngestDocumentResponse
+     */
+    folderId?: string | null;
+    /**
+     * Members found on an email upload, each becoming its own document beside the email: the attachments of a single message, or the messages of an .mbox archive (whose own attachments are then expanded one level deeper). Always 0 for non-email uploads. Null for a .pst, whose members are enumerated only by the worker fan-out — poll attachment_workflow_id for per-member outcomes.
+     * @type {number}
+     * @memberof IngestDocumentResponse
+     */
+    attachmentCount?: number | null;
+    /**
+     * Fan-out workflow ingesting the members. Poll GET /v1/system-jobs/zip-ingestions/{id} for per-member outcomes. Null when the upload had no ingestible members.
+     * @type {string}
+     * @memberof IngestDocumentResponse
+     */
+    attachmentWorkflowId?: string | null;
 }
 export declare const IngestDocumentResponsePropertyValidationAttributesMap: {
     [property: string]: {

package/dist/models/IngestDocumentResponse.js

@@ -43,6 +43,9 @@ function IngestDocumentResponseFromJSONTyped(json, ignoreDiscriminator) {
         'workflowId': json['workflow_id'],
         'documentId': json['document_id'],
         'documentVersionId': json['document_version_id'],
+        'folderId': json['folder_id'] == null ? undefined : json['folder_id'],
+        'attachmentCount': json['attachment_count'] == null ? undefined : json['attachment_count'],
+        'attachmentWorkflowId': json['attachment_workflow_id'] == null ? undefined : json['attachment_workflow_id'],
     };
 }
 function IngestDocumentResponseToJSON(json) {
@@ -56,5 +59,8 @@ function IngestDocumentResponseToJSONTyped(value, ignoreDiscriminator = false) {
         'workflow_id': value['workflowId'],
         'document_id': value['documentId'],
         'document_version_id': value['documentVersionId'],
+        'folder_id': value['folderId'],
+        'attachment_count': value['attachmentCount'],
+        'attachment_workflow_id': value['attachmentWorkflowId'],
     };
 }