@knowledge-stack/ksapi 2.5.0 → 2.7.0

package/.openapi-generator/FILES

@@ -149,6 +149,8 @@ docs/DocxParagraphAnchorInput.md
 docs/DocxParagraphAnchorOutput.md
 docs/DownloadArtifact.md
 docs/EditMemoryChunkRequest.md
+docs/EmailMetadata.md
+docs/EmailParty.md
 docs/EmailSentResponse.md
 docs/EmailVerificationRequest.md
 docs/EnrichedCitation.md
@@ -607,6 +609,8 @@ src/models/DocxParagraphAnchorInput.ts
 src/models/DocxParagraphAnchorOutput.ts
 src/models/DownloadArtifact.ts
 src/models/EditMemoryChunkRequest.ts
+src/models/EmailMetadata.ts
+src/models/EmailParty.ts
 src/models/EmailSentResponse.ts
 src/models/EmailVerificationRequest.ts
 src/models/EnrichedCitation.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@2.5.0
+# @knowledge-stack/ksapi@2.7.0
 
 A TypeScript SDK client for the localhost API.
 
@@ -433,6 +433,8 @@ All URIs are relative to *http://localhost:8000*
 - [DocxParagraphAnchorOutput](docs/DocxParagraphAnchorOutput.md)
 - [DownloadArtifact](docs/DownloadArtifact.md)
 - [EditMemoryChunkRequest](docs/EditMemoryChunkRequest.md)
+- [EmailMetadata](docs/EmailMetadata.md)
+- [EmailParty](docs/EmailParty.md)
 - [EmailSentResponse](docs/EmailSentResponse.md)
 - [EmailVerificationRequest](docs/EmailVerificationRequest.md)
 - [EnrichedCitation](docs/EnrichedCitation.md)
@@ -720,7 +722,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `2.5.0`
+- Package version: `2.7.0`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/DocumentsApi.d.ts

@@ -43,6 +43,7 @@ export interface IngestDocumentRequest {
     name?: string | null;
     tagIds?: Array<string>;
     idempotencyKey?: string | null;
+    emailNestingDepth?: number;
     ingestionMode?: IngestionMode;
     chunkType?: ChunkType;
     secondaryTaxonomy?: ImageTaxonomy;
@@ -72,6 +73,8 @@ export interface ListDocumentsRequest {
     sortDir?: SortDirection;
     ownerId?: string | null;
     documentType?: DocumentType;
+    durationMinMs?: number | null;
+    durationMaxMs?: number | null;
     withTags?: boolean;
     limit?: number;
     offset?: number;
@@ -274,6 +277,7 @@ export interface DocumentsApiInterface {
      * @param {string} [name] Document name (defaults to filename)
      * @param {Array<string>} [tagIds] Tag IDs applied to the created document.
      * @param {string} [idempotencyKey] Opt-in key: a repeat with the same key at the same (parent, name) replays the existing document instead of a 409.
+     * @param {number} [emailNestingDepth] Internal: set by the email member fan-out when a nested email re-enters this endpoint. Leave at 0 for direct uploads.
      * @param {IngestionMode} [ingestionMode]
      * @param {ChunkType} [chunkType]
      * @param {ImageTaxonomy} [secondaryTaxonomy]
@@ -292,6 +296,7 @@ export interface DocumentsApiInterface {
      * @param {string} [name] Document name (defaults to filename)
      * @param {Array<string>} [tagIds] Tag IDs applied to the created document.
      * @param {string} [idempotencyKey] Opt-in key: a repeat with the same key at the same (parent, name) replays the existing document instead of a 409.
+     * @param {number} [emailNestingDepth] Internal: set by the email member fan-out when a nested email re-enters this endpoint. Leave at 0 for direct uploads.
      * @param {IngestionMode} [ingestionMode]
      * @param {ChunkType} [chunkType]
      * @param {ImageTaxonomy} [secondaryTaxonomy]
@@ -377,6 +382,8 @@ export interface DocumentsApiInterface {
      * @param {SortDirection} [sortDir] Sort direction; overrides the column\&#39;s natural default
      * @param {string} [ownerId] Filter to documents owned by this user
      * @param {DocumentType} [documentType] Filter to documents of this type
+     * @param {number} [durationMinMs] Only media whose active version is at least this long (milliseconds). Non-media documents have no duration and are excluded.
+     * @param {number} [durationMaxMs] Only media whose active version is at most this long.
      * @param {boolean} [withTags] Include tags in the response (default: false)
      * @param {number} [limit] Number of items per page
      * @param {number} [offset] Number of items to skip
@@ -396,6 +403,8 @@ export interface DocumentsApiInterface {
      * @param {SortDirection} [sortDir] Sort direction; overrides the column\&#39;s natural default
      * @param {string} [ownerId] Filter to documents owned by this user
      * @param {DocumentType} [documentType] Filter to documents of this type
+     * @param {number} [durationMinMs] Only media whose active version is at least this long (milliseconds). Non-media documents have no duration and are excluded.
+     * @param {number} [durationMaxMs] Only media whose active version is at most this long.
      * @param {boolean} [withTags] Include tags in the response (default: false)
      * @param {number} [limit] Number of items per page
      * @param {number} [offset] Number of items to skip

package/dist/apis/DocumentsApi.js

@@ -505,6 +505,9 @@ class DocumentsApi extends runtime.BaseAPI {
             if (requestParameters['idempotencyKey'] != null) {
                 formParams.append('idempotency_key', requestParameters['idempotencyKey']);
             }
+            if (requestParameters['emailNestingDepth'] != null) {
+                formParams.append('email_nesting_depth', requestParameters['emailNestingDepth']);
+            }
             if (requestParameters['ingestionMode'] != null) {
                 formParams.append('ingestion_mode', requestParameters['ingestionMode']);
             }
@@ -741,6 +744,12 @@ class DocumentsApi extends runtime.BaseAPI {
             if (requestParameters['documentType'] != null) {
                 queryParameters['document_type'] = requestParameters['documentType'];
             }
+            if (requestParameters['durationMinMs'] != null) {
+                queryParameters['duration_min_ms'] = requestParameters['durationMinMs'];
+            }
+            if (requestParameters['durationMaxMs'] != null) {
+                queryParameters['duration_max_ms'] = requestParameters['durationMaxMs'];
+            }
             if (requestParameters['withTags'] != null) {
                 queryParameters['with_tags'] = requestParameters['withTags'];
             }

package/dist/apis/SystemJobsApi.d.ts

@@ -129,7 +129,7 @@ export interface SystemJobsApiInterface {
      */
     getZipIngestionStatusRequestOpts(requestParameters: GetZipIngestionStatusRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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.
+     * 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.
      * @summary Get Zip Ingestion Status Handler
      * @param {string} workflowId
      * @param {*} [options] Override http request option.
@@ -138,7 +138,7 @@ export interface SystemJobsApiInterface {
      */
     getZipIngestionStatusRaw(requestParameters: GetZipIngestionStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ZipIngestionStatusResponse>>;
     /**
-     * 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.
+     * 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 Zip Ingestion Status Handler
      */
     getZipIngestionStatus(requestParameters: GetZipIngestionStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ZipIngestionStatusResponse>;
@@ -231,12 +231,12 @@ export declare class SystemJobsApi extends runtime.BaseAPI implements SystemJobs
      */
     getZipIngestionStatusRequestOpts(requestParameters: GetZipIngestionStatusRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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.
+     * 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 Zip Ingestion Status Handler
      */
     getZipIngestionStatusRaw(requestParameters: GetZipIngestionStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ZipIngestionStatusResponse>>;
     /**
-     * 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.
+     * 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 Zip Ingestion Status Handler
      */
     getZipIngestionStatus(requestParameters: GetZipIngestionStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ZipIngestionStatusResponse>;

package/dist/apis/SystemJobsApi.js

@@ -282,7 +282,7 @@ class SystemJobsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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.
+     * 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 Zip Ingestion Status Handler
      */
     getZipIngestionStatusRaw(requestParameters, initOverrides) {
@@ -293,7 +293,7 @@ class SystemJobsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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.
+     * 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 Zip Ingestion Status Handler
      */
     getZipIngestionStatus(requestParameters, initOverrides) {

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

@@ -43,6 +43,7 @@ export interface IngestDocumentRequest {
     name?: string | null;
     tagIds?: Array<string>;
     idempotencyKey?: string | null;
+    emailNestingDepth?: number;
     ingestionMode?: IngestionMode;
     chunkType?: ChunkType;
     secondaryTaxonomy?: ImageTaxonomy;
@@ -72,6 +73,8 @@ export interface ListDocumentsRequest {
     sortDir?: SortDirection;
     ownerId?: string | null;
     documentType?: DocumentType;
+    durationMinMs?: number | null;
+    durationMaxMs?: number | null;
     withTags?: boolean;
     limit?: number;
     offset?: number;
@@ -274,6 +277,7 @@ export interface DocumentsApiInterface {
      * @param {string} [name] Document name (defaults to filename)
      * @param {Array<string>} [tagIds] Tag IDs applied to the created document.
      * @param {string} [idempotencyKey] Opt-in key: a repeat with the same key at the same (parent, name) replays the existing document instead of a 409.
+     * @param {number} [emailNestingDepth] Internal: set by the email member fan-out when a nested email re-enters this endpoint. Leave at 0 for direct uploads.
      * @param {IngestionMode} [ingestionMode]
      * @param {ChunkType} [chunkType]
      * @param {ImageTaxonomy} [secondaryTaxonomy]
@@ -292,6 +296,7 @@ export interface DocumentsApiInterface {
      * @param {string} [name] Document name (defaults to filename)
      * @param {Array<string>} [tagIds] Tag IDs applied to the created document.
      * @param {string} [idempotencyKey] Opt-in key: a repeat with the same key at the same (parent, name) replays the existing document instead of a 409.
+     * @param {number} [emailNestingDepth] Internal: set by the email member fan-out when a nested email re-enters this endpoint. Leave at 0 for direct uploads.
      * @param {IngestionMode} [ingestionMode]
      * @param {ChunkType} [chunkType]
      * @param {ImageTaxonomy} [secondaryTaxonomy]
@@ -377,6 +382,8 @@ export interface DocumentsApiInterface {
      * @param {SortDirection} [sortDir] Sort direction; overrides the column\&#39;s natural default
      * @param {string} [ownerId] Filter to documents owned by this user
      * @param {DocumentType} [documentType] Filter to documents of this type
+     * @param {number} [durationMinMs] Only media whose active version is at least this long (milliseconds). Non-media documents have no duration and are excluded.
+     * @param {number} [durationMaxMs] Only media whose active version is at most this long.
      * @param {boolean} [withTags] Include tags in the response (default: false)
      * @param {number} [limit] Number of items per page
      * @param {number} [offset] Number of items to skip
@@ -396,6 +403,8 @@ export interface DocumentsApiInterface {
      * @param {SortDirection} [sortDir] Sort direction; overrides the column\&#39;s natural default
      * @param {string} [ownerId] Filter to documents owned by this user
      * @param {DocumentType} [documentType] Filter to documents of this type
+     * @param {number} [durationMinMs] Only media whose active version is at least this long (milliseconds). Non-media documents have no duration and are excluded.
+     * @param {number} [durationMaxMs] Only media whose active version is at most this long.
      * @param {boolean} [withTags] Include tags in the response (default: false)
      * @param {number} [limit] Number of items per page
      * @param {number} [offset] Number of items to skip

package/dist/esm/apis/DocumentsApi.js

@@ -469,6 +469,9 @@ export class DocumentsApi extends runtime.BaseAPI {
             if (requestParameters['idempotencyKey'] != null) {
                 formParams.append('idempotency_key', requestParameters['idempotencyKey']);
             }
+            if (requestParameters['emailNestingDepth'] != null) {
+                formParams.append('email_nesting_depth', requestParameters['emailNestingDepth']);
+            }
             if (requestParameters['ingestionMode'] != null) {
                 formParams.append('ingestion_mode', requestParameters['ingestionMode']);
             }
@@ -705,6 +708,12 @@ export class DocumentsApi extends runtime.BaseAPI {
             if (requestParameters['documentType'] != null) {
                 queryParameters['document_type'] = requestParameters['documentType'];
             }
+            if (requestParameters['durationMinMs'] != null) {
+                queryParameters['duration_min_ms'] = requestParameters['durationMinMs'];
+            }
+            if (requestParameters['durationMaxMs'] != null) {
+                queryParameters['duration_max_ms'] = requestParameters['durationMaxMs'];
+            }
             if (requestParameters['withTags'] != null) {
                 queryParameters['with_tags'] = requestParameters['withTags'];
             }

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

@@ -129,7 +129,7 @@ export interface SystemJobsApiInterface {
      */
     getZipIngestionStatusRequestOpts(requestParameters: GetZipIngestionStatusRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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.
+     * 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.
      * @summary Get Zip Ingestion Status Handler
      * @param {string} workflowId
      * @param {*} [options] Override http request option.
@@ -138,7 +138,7 @@ export interface SystemJobsApiInterface {
      */
     getZipIngestionStatusRaw(requestParameters: GetZipIngestionStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ZipIngestionStatusResponse>>;
     /**
-     * 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.
+     * 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 Zip Ingestion Status Handler
      */
     getZipIngestionStatus(requestParameters: GetZipIngestionStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ZipIngestionStatusResponse>;
@@ -231,12 +231,12 @@ export declare class SystemJobsApi extends runtime.BaseAPI implements SystemJobs
      */
     getZipIngestionStatusRequestOpts(requestParameters: GetZipIngestionStatusRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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.
+     * 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 Zip Ingestion Status Handler
      */
     getZipIngestionStatusRaw(requestParameters: GetZipIngestionStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ZipIngestionStatusResponse>>;
     /**
-     * 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.
+     * 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 Zip Ingestion Status Handler
      */
     getZipIngestionStatus(requestParameters: GetZipIngestionStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ZipIngestionStatusResponse>;

package/dist/esm/apis/SystemJobsApi.js

@@ -246,7 +246,7 @@ export class SystemJobsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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.
+     * 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 Zip Ingestion Status Handler
      */
     getZipIngestionStatusRaw(requestParameters, initOverrides) {
@@ -257,7 +257,7 @@ export class SystemJobsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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.
+     * 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 Zip Ingestion Status Handler
      */
     getZipIngestionStatus(requestParameters, initOverrides) {

package/dist/esm/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/esm/models/ChunkMetadata.js

@@ -37,6 +37,8 @@ export function ChunkMetadataFromJSONTyped(json, ignoreDiscriminator) {
         'secondaryTaxonomy': json['secondary_taxonomy'] == null ? undefined : 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(SegmentSpanFromJSON)),
         'sheetName': json['sheet_name'] == null ? undefined : json['sheet_name'],
         'blockType': json['block_type'] == null ? undefined : json['block_type'],
@@ -65,6 +67,8 @@ export function ChunkMetadataToJSONTyped(value, ignoreDiscriminator = false) {
         'secondary_taxonomy': 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(SegmentSpanToJSON)),
         'sheet_name': value['sheetName'],
         'block_type': value['blockType'],

package/dist/esm/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/esm/models/CreateUploadRequest.js

@@ -39,6 +39,9 @@ export 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'],
     };
 }
 export function CreateUploadRequestToJSON(json) {
@@ -54,5 +57,8 @@ export function CreateUploadRequestToJSONTyped(value, ignoreDiscriminator = fals
         '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/esm/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/esm/models/DocumentVersionMetadata.js

@@ -14,6 +14,7 @@
 import { PipelineStateFromJSON, PipelineStateToJSON, } from './PipelineState';
 import { XlsxCellAnchorOutputOrDocxParagraphAnchorOutputFromJSON, XlsxCellAnchorOutputOrDocxParagraphAnchorOutputToJSON, } from './XlsxCellAnchorOutputOrDocxParagraphAnchorOutput';
 import { InformationStatisticsFromJSON, InformationStatisticsToJSON, } from './InformationStatistics';
+import { EmailMetadataFromJSON, EmailMetadataToJSON, } from './EmailMetadata';
 export const DocumentVersionMetadataPropertyValidationAttributesMap = {};
 /**
  * Check if a given object implements the DocumentVersionMetadata interface.
@@ -43,6 +44,7 @@ export 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 : 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'],
@@ -79,6 +81,7 @@ export function DocumentVersionMetadataToJSONTyped(value, ignoreDiscriminator =
         'duration_ms': value['durationMs'],
         'language': value['language'],
         'segment_count': value['segmentCount'],
+        'email': EmailMetadataToJSON(value['email']),
         'total_formulas': value['totalFormulas'],
         'xlsx_parse_result_s3': value['xlsxParseResultS3'],
         'xlsx_named_ranges': value['xlsxNamedRanges'],

package/dist/esm/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/esm/models/DocumentVersionMetadataUpdate.js

@@ -14,6 +14,7 @@
 import { PipelineStateFromJSON, PipelineStateToJSON, } from './PipelineState';
 import { XlsxCellAnchorInputOrDocxParagraphAnchorInputFromJSON, XlsxCellAnchorInputOrDocxParagraphAnchorInputToJSON, } from './XlsxCellAnchorInputOrDocxParagraphAnchorInput';
 import { InformationStatisticsFromJSON, InformationStatisticsToJSON, } from './InformationStatistics';
+import { EmailMetadataFromJSON, EmailMetadataToJSON, } from './EmailMetadata';
 export const DocumentVersionMetadataUpdatePropertyValidationAttributesMap = {};
 /**
  * Check if a given object implements the DocumentVersionMetadataUpdate interface.
@@ -46,6 +47,7 @@ export function DocumentVersionMetadataUpdateFromJSONTyped(json, ignoreDiscrimin
         '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 : 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'],
@@ -84,6 +86,7 @@ export function DocumentVersionMetadataUpdateToJSONTyped(value, ignoreDiscrimina
         'duration_ms': value['durationMs'],
         'language': value['language'],
         'segment_count': value['segmentCount'],
+        'email': EmailMetadataToJSON(value['email']),
         'total_formulas': value['totalFormulas'],
         'xlsx_parse_result_s3': value['xlsxParseResultS3'],
         'xlsx_named_ranges': value['xlsxNamedRanges'],

package/dist/esm/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;