@knowledge-stack/ksapi 2.5.0 → 2.7.0

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/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'],
     };
 }

package/dist/models/SegmentSpan.d.ts

@@ -12,8 +12,9 @@
 /**
  * One ASR segment's span inside a media chunk (media chunks only).
  *
- * Field names are deliberately compact — a media document stores hundreds
- * of chunks x up to ~15 spans each in ``chunk_metadata`` JSONB.
+ * Field names are deliberately compact — a media document stores hundreds of
+ * chunks x tens of spans each in ``chunk_metadata`` JSONB. Measured worst
+ * case is a 4-hour Mandarin recording: 175 chunks x ~33 spans, ~190 KB total.
  * @export
  * @interface SegmentSpan
  */
@@ -36,6 +37,12 @@ export interface SegmentSpan {
      * @memberof SegmentSpan
      */
     c: number;
+    /**
+     * Speaker label for this segment, 0-indexed within the recording. It identifies turns, not people — there is no voiceprint enrollment, so label 0 in one meeting is unrelated to label 0 in another. None when the ASR provider does not diarize.
+     * @type {number}
+     * @memberof SegmentSpan
+     */
+    k?: number | null;
 }
 export declare const SegmentSpanPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/models/SegmentSpan.js

@@ -43,6 +43,7 @@ function SegmentSpanFromJSONTyped(json, ignoreDiscriminator) {
         's': json['s'],
         'e': json['e'],
         'c': json['c'],
+        'k': json['k'] == null ? undefined : json['k'],
     };
 }
 function SegmentSpanToJSON(json) {
@@ -56,5 +57,6 @@ function SegmentSpanToJSONTyped(value, ignoreDiscriminator = false) {
         's': value['s'],
         'e': value['e'],
         'c': value['c'],
+        'k': value['k'],
     };
 }

package/dist/models/index.d.ts

@@ -127,6 +127,8 @@ export * from './DocxParagraphAnchorInput';
 export * from './DocxParagraphAnchorOutput';
 export * from './DownloadArtifact';
 export * from './EditMemoryChunkRequest';
+export * from './EmailMetadata';
+export * from './EmailParty';
 export * from './EmailSentResponse';
 export * from './EmailVerificationRequest';
 export * from './EnrichedCitation';

package/dist/models/index.js

@@ -145,6 +145,8 @@ __exportStar(require("./DocxParagraphAnchorInput"), exports);
 __exportStar(require("./DocxParagraphAnchorOutput"), exports);
 __exportStar(require("./DownloadArtifact"), exports);
 __exportStar(require("./EditMemoryChunkRequest"), exports);
+__exportStar(require("./EmailMetadata"), exports);
+__exportStar(require("./EmailParty"), exports);
 __exportStar(require("./EmailSentResponse"), exports);
 __exportStar(require("./EmailVerificationRequest"), exports);
 __exportStar(require("./EnrichedCitation"), exports);

package/docs/ChunkMetadata.md

@@ -15,6 +15,8 @@ Name | Type
 `secondaryTaxonomy` | [ImageTaxonomy](ImageTaxonomy.md)
 `startMs` | number
 `endMs` | number
+`speakers` | Array<number>
+`languages` | Array<string>
 `segments` | [Array<SegmentSpan>](SegmentSpan.md)
 `sheetName` | string
 `blockType` | string
@@ -41,6 +43,8 @@ const example = {
   "secondaryTaxonomy": null,
   "startMs": null,
   "endMs": null,
+  "speakers": null,
+  "languages": null,
   "segments": null,
   "sheetName": null,
   "blockType": null,

package/docs/CreateUploadRequest.md

@@ -12,6 +12,9 @@ Name | Type
 `filename` | string
 `sizeBytes` | number
 `tagIds` | Array<string>
+`workflowRunId` | string
+`workflowDefinitionId` | string
+`idempotencyKey` | string
 
 ## Example
 
@@ -25,6 +28,9 @@ const example = {
   "filename": null,
   "sizeBytes": null,
   "tagIds": null,
+  "workflowRunId": null,
+  "workflowDefinitionId": null,
+  "idempotencyKey": null,
 } satisfies CreateUploadRequest
 
 console.log(example)

package/docs/DocumentVersionMetadata.md

@@ -21,6 +21,7 @@ Name | Type
 `durationMs` | number
 `language` | string
 `segmentCount` | number
+`email` | [EmailMetadata](EmailMetadata.md)
 `totalFormulas` | number
 `xlsxParseResultS3` | string
 `xlsxNamedRanges` | Array<{ [key: string]: any; }>
@@ -55,6 +56,7 @@ const example = {
   "durationMs": null,
   "language": null,
   "segmentCount": null,
+  "email": null,
   "totalFormulas": null,
   "xlsxParseResultS3": null,
   "xlsxNamedRanges": null,

package/docs/DocumentVersionMetadataUpdate.md

@@ -24,6 +24,7 @@ Name | Type
 `durationMs` | number
 `language` | string
 `segmentCount` | number
+`email` | [EmailMetadata](EmailMetadata.md)
 `totalFormulas` | number
 `xlsxParseResultS3` | string
 `xlsxNamedRanges` | Array<{ [key: string]: any; }>
@@ -60,6 +61,7 @@ const example = {
   "durationMs": null,
   "language": null,
   "segmentCount": null,
+  "email": null,
   "totalFormulas": null,
   "xlsxParseResultS3": null,
   "xlsxNamedRanges": null,

package/docs/DocumentsApi.md

@@ -627,7 +627,7 @@ example().catch(console.error);
 
 ## ingestDocument
 
-> IngestDocumentResponse ingestDocument(file, pathPartId, name, tagIds, idempotencyKey, ingestionMode, chunkType, secondaryTaxonomy, pageDpi, workflowRunId, workflowDefinitionId)
+> IngestDocumentResponse ingestDocument(file, pathPartId, name, tagIds, idempotencyKey, emailNestingDepth, ingestionMode, chunkType, secondaryTaxonomy, pageDpi, workflowRunId, workflowDefinitionId)
 
 Ingest Document Handler
 
@@ -663,6 +663,8 @@ async function example() {
     tagIds: ...,
     // string | Opt-in key: a repeat with the same key at the same (parent, name) replays the existing document instead of a 409. (optional)
     idempotencyKey: idempotencyKey_example,
+    // number | Internal: set by the email member fan-out when a nested email re-enters this endpoint. Leave at 0 for direct uploads. (optional)
+    emailNestingDepth: 56,
     // IngestionMode (optional)
     ingestionMode: ...,
     // ChunkType (optional)
@@ -699,9 +701,10 @@ example().catch(console.error);
 | **name** | `string` | Document name (defaults to filename) | [Optional] [Defaults to `undefined`] |
 | **tagIds** | `Array<string>` | Tag IDs applied to the created document. | [Optional] |
 | **idempotencyKey** | `string` | Opt-in key: a repeat with the same key at the same (parent, name) replays the existing document instead of a 409. | [Optional] [Defaults to `undefined`] |
+| **emailNestingDepth** | `number` | Internal: set by the email member fan-out when a nested email re-enters this endpoint. Leave at 0 for direct uploads. | [Optional] [Defaults to `0`] |
 | **ingestionMode** | `IngestionMode` |  | [Optional] [Defaults to `undefined`] [Enum: high_accuracy, standard, single_chunk, media] |
 | **chunkType** | `ChunkType` |  | [Optional] [Defaults to `undefined`] [Enum: TEXT, TABLE, IMAGE, HTML, UNKNOWN] |
-| **secondaryTaxonomy** | `ImageTaxonomy` |  | [Optional] [Defaults to `undefined`] [Enum: picture, flowchart] |
+| **secondaryTaxonomy** | `ImageTaxonomy` |  | [Optional] [Defaults to `undefined`] [Enum: picture, slide, flowchart] |
 | **pageDpi** | `number` | DPI for PDF page screenshots (default 72, min 36, max 216). | [Optional] [Defaults to `72`] |
 | **workflowRunId** | `string` | Workflow run context for assumed agent uploads. | [Optional] [Defaults to `undefined`] |
 | **workflowDefinitionId** | `string` | Workflow definition context for assumed agent uploads. | [Optional] [Defaults to `undefined`] |
@@ -797,7 +800,7 @@ example().catch(console.error);
 | **file** | `Blob` |  | [Defaults to `undefined`] |
 | **ingestionMode** | `IngestionMode` |  | [Optional] [Defaults to `undefined`] [Enum: high_accuracy, standard, single_chunk, media] |
 | **chunkType** | `ChunkType` |  | [Optional] [Defaults to `undefined`] [Enum: TEXT, TABLE, IMAGE, HTML, UNKNOWN] |
-| **secondaryTaxonomy** | `ImageTaxonomy` |  | [Optional] [Defaults to `undefined`] [Enum: picture, flowchart] |
+| **secondaryTaxonomy** | `ImageTaxonomy` |  | [Optional] [Defaults to `undefined`] [Enum: picture, slide, flowchart] |
 | **pageDpi** | `number` | DPI for PDF page screenshots (default 72, min 36, max 216). | [Optional] [Defaults to `72`] |
 | **workflowRunId** | `string` | Workflow run context for assumed agent uploads. | [Optional] [Defaults to `undefined`] |
 | **workflowDefinitionId** | `string` | Workflow definition context for assumed agent uploads. | [Optional] [Defaults to `undefined`] |
@@ -912,7 +915,7 @@ example().catch(console.error);
 
 ## listDocuments
 
-> PaginatedResponseDocumentResponse listDocuments(parentPathPartId, sortOrder, sortDir, ownerId, documentType, withTags, limit, offset, createdAfter, createdBefore, updatedAfter, updatedBefore)
+> PaginatedResponseDocumentResponse listDocuments(parentPathPartId, sortOrder, sortDir, ownerId, documentType, durationMinMs, durationMaxMs, withTags, limit, offset, createdAfter, createdBefore, updatedAfter, updatedBefore)
 
 List Documents Handler
 
@@ -948,6 +951,10 @@ async function example() {
     ownerId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
     // DocumentType | Filter to documents of this type (optional)
     documentType: ...,
+    // number | Only media whose active version is at least this long (milliseconds). Non-media documents have no duration and are excluded. (optional)
+    durationMinMs: 56,
+    // number | Only media whose active version is at most this long. (optional)
+    durationMaxMs: 56,
     // boolean | Include tags in the response (default: false) (optional)
     withTags: true,
     // number | Number of items per page (optional)
@@ -986,6 +993,8 @@ example().catch(console.error);
 | **sortDir** | `SortDirection` | Sort direction; overrides the column\&#39;s natural default | [Optional] [Defaults to `undefined`] [Enum: ASC, DESC] |
 | **ownerId** | `string` | Filter to documents owned by this user | [Optional] [Defaults to `undefined`] |
 | **documentType** | `DocumentType` | Filter to documents of this type | [Optional] [Defaults to `undefined`] [Enum: PDF, DOCX, PLAINTEXT, IMAGE, XLSX, CSV, PPTX, JSON, YAML, CODE, AUDIO, VIDEO, EMAIL, UNKNOWN] |
+| **durationMinMs** | `number` | Only media whose active version is at least this long (milliseconds). Non-media documents have no duration and are excluded. | [Optional] [Defaults to `undefined`] |
+| **durationMaxMs** | `number` | Only media whose active version is at most this long. | [Optional] [Defaults to `undefined`] |
 | **withTags** | `boolean` | Include tags in the response (default: false) | [Optional] [Defaults to `false`] |
 | **limit** | `number` | Number of items per page | [Optional] [Defaults to `20`] |
 | **offset** | `number` | Number of items to skip | [Optional] [Defaults to `0`] |

package/docs/EmailMetadata.md

@@ -0,0 +1,57 @@
+
+# EmailMetadata
+
+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.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`subject` | string
+`sender` | [EmailParty](EmailParty.md)
+`to` | [Array<EmailParty>](EmailParty.md)
+`cc` | [Array<EmailParty>](EmailParty.md)
+`bcc` | [Array<EmailParty>](EmailParty.md)
+`sentAt` | string
+`messageId` | string
+`inReplyTo` | string
+`references` | Array<string>
+`conversationTopic` | string
+`threadRootId` | string
+`rawHeaders` | string
+
+## Example
+
+```typescript
+import type { EmailMetadata } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "subject": null,
+  "sender": null,
+  "to": null,
+  "cc": null,
+  "bcc": null,
+  "sentAt": null,
+  "messageId": null,
+  "inReplyTo": null,
+  "references": null,
+  "conversationTopic": null,
+  "threadRootId": null,
+  "rawHeaders": null,
+} satisfies EmailMetadata
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as EmailMetadata
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/EmailParty.md

@@ -0,0 +1,37 @@
+
+# EmailParty
+
+One email participant.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`name` | string
+`address` | string
+
+## Example
+
+```typescript
+import type { EmailParty } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "name": null,
+  "address": null,
+} satisfies EmailParty
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as EmailParty
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/IngestDocumentResponse.md

@@ -10,6 +10,9 @@ Name | Type
 `workflowId` | string
 `documentId` | string
 `documentVersionId` | string
+`folderId` | string
+`attachmentCount` | number
+`attachmentWorkflowId` | string
 
 ## Example
 
@@ -21,6 +24,9 @@ const example = {
   "workflowId": null,
   "documentId": null,
   "documentVersionId": null,
+  "folderId": null,
+  "attachmentCount": null,
+  "attachmentWorkflowId": null,
 } satisfies IngestDocumentResponse
 
 console.log(example)

package/docs/SegmentSpan.md

@@ -1,7 +1,7 @@
 
 # SegmentSpan
 
-One ASR segment\'s span inside a media chunk (media chunks only).  Field names are deliberately compact — a media document stores hundreds of chunks x up to ~15 spans each in ``chunk_metadata`` JSONB.
+One ASR segment\'s span inside a media chunk (media chunks only).  Field names are deliberately compact — a media document stores hundreds of chunks x tens of spans each in ``chunk_metadata`` JSONB. Measured worst case is a 4-hour Mandarin recording: 175 chunks x ~33 spans, ~190 KB total.
 
 ## Properties
 
@@ -10,6 +10,7 @@ Name | Type
 `s` | number
 `e` | number
 `c` | number
+`k` | number
 
 ## Example
 
@@ -21,6 +22,7 @@ const example = {
   "s": null,
   "e": null,
   "c": null,
+  "k": null,
 } satisfies SegmentSpan
 
 console.log(example)

package/docs/SystemJobsApi.md

@@ -319,7 +319,7 @@ example().catch(console.error);
 
 Get Zip Ingestion Status Handler
 
-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.
 
 ### Example
 

package/package.json

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