@knowledge-stack/ksapi 1.149.1 → 1.151.0

package/dist/models/IngestZipResponse.d.ts

@@ -11,41 +11,28 @@
  */
 import type { ZipFileResult } from './ZipFileResult';
 /**
- * Aggregate response from a ZIP ingestion batch.
+ * Response from dispatching a ZIP archive to async ingestion.
+ *
+ * ``workflow_id`` is the fan-out workflow to poll at
+ * ``GET /v1/system-jobs/zip-ingestions/{workflow_id}`` for per-member outcomes;
+ * it is None when the archive held no ingestible members. ``skipped`` are the
+ * artifact/error entries resolved synchronously during classification.
  * @export
  * @interface IngestZipResponse
  */
 export interface IngestZipResponse {
     /**
      *
-     * @type {Array<ZipFileResult>}
-     * @memberof IngestZipResponse
-     */
-    files: Array<ZipFileResult>;
-    /**
-     *
-     * @type {number}
+     * @type {string}
      * @memberof IngestZipResponse
      */
-    totalFound: number;
+    workflowId: string | null;
     /**
      *
-     * @type {number}
-     * @memberof IngestZipResponse
-     */
-    succeeded: number;
-    /**
-     *
-     * @type {number}
-     * @memberof IngestZipResponse
-     */
-    skipped: number;
-    /**
-     *
-     * @type {number}
+     * @type {Array<ZipFileResult>}
      * @memberof IngestZipResponse
      */
-    failed: number;
+    skipped: Array<ZipFileResult>;
 }
 export declare const IngestZipResponsePropertyValidationAttributesMap: {
     [property: string]: {

package/dist/models/IngestZipResponse.js

@@ -25,16 +25,10 @@ exports.IngestZipResponsePropertyValidationAttributesMap = {};
  * Check if a given object implements the IngestZipResponse interface.
  */
 function instanceOfIngestZipResponse(value) {
-    if (!('files' in value) || value['files'] === undefined)
-        return false;
-    if (!('totalFound' in value) || value['totalFound'] === undefined)
-        return false;
-    if (!('succeeded' in value) || value['succeeded'] === undefined)
+    if (!('workflowId' in value) || value['workflowId'] === undefined)
         return false;
     if (!('skipped' in value) || value['skipped'] === undefined)
         return false;
-    if (!('failed' in value) || value['failed'] === undefined)
-        return false;
     return true;
 }
 function IngestZipResponseFromJSON(json) {
@@ -45,11 +39,8 @@ function IngestZipResponseFromJSONTyped(json, ignoreDiscriminator) {
         return json;
     }
     return {
-        'files': (json['files'].map(ZipFileResult_1.ZipFileResultFromJSON)),
-        'totalFound': json['total_found'],
-        'succeeded': json['succeeded'],
-        'skipped': json['skipped'],
-        'failed': json['failed'],
+        'workflowId': json['workflow_id'],
+        'skipped': (json['skipped'].map(ZipFileResult_1.ZipFileResultFromJSON)),
     };
 }
 function IngestZipResponseToJSON(json) {
@@ -60,10 +51,7 @@ function IngestZipResponseToJSONTyped(value, ignoreDiscriminator = false) {
         return value;
     }
     return {
-        'files': (value['files'].map(ZipFileResult_1.ZipFileResultToJSON)),
-        'total_found': value['totalFound'],
-        'succeeded': value['succeeded'],
-        'skipped': value['skipped'],
-        'failed': value['failed'],
+        'workflow_id': value['workflowId'],
+        'skipped': (value['skipped'].map(ZipFileResult_1.ZipFileResultToJSON)),
     };
 }

package/dist/models/ZipIngestionStatusResponse.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 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 { ZipMemberStatusResponse } from './ZipMemberStatusResponse';
+/**
+ * Status of a ZIP fan-out: live Temporal state + per-member outcomes.
+ *
+ * ``files`` reflects progress so far — members that have been dispatched
+ * (``workflow_id`` set), failed to dispatch (``error`` set), or were skipped as
+ * artifacts. Poll until ``temporal_status`` is terminal (e.g. ``COMPLETED``).
+ * @export
+ * @interface ZipIngestionStatusResponse
+ */
+export interface ZipIngestionStatusResponse {
+    /**
+     *
+     * @type {string}
+     * @memberof ZipIngestionStatusResponse
+     */
+    workflowId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof ZipIngestionStatusResponse
+     */
+    temporalStatus: string;
+    /**
+     *
+     * @type {Array<ZipMemberStatusResponse>}
+     * @memberof ZipIngestionStatusResponse
+     */
+    files: Array<ZipMemberStatusResponse>;
+}
+export declare const ZipIngestionStatusResponsePropertyValidationAttributesMap: {
+    [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 ZipIngestionStatusResponse interface.
+ */
+export declare function instanceOfZipIngestionStatusResponse(value: object): value is ZipIngestionStatusResponse;
+export declare function ZipIngestionStatusResponseFromJSON(json: any): ZipIngestionStatusResponse;
+export declare function ZipIngestionStatusResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): ZipIngestionStatusResponse;
+export declare function ZipIngestionStatusResponseToJSON(json: any): ZipIngestionStatusResponse;
+export declare function ZipIngestionStatusResponseToJSONTyped(value?: ZipIngestionStatusResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/models/{ProposedMemoryChunkResponse.js → ZipIngestionStatusResponse.js}

@@ -13,70 +13,49 @@
  * Do not edit the class manually.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProposedMemoryChunkResponsePropertyValidationAttributesMap = void 0;
-exports.instanceOfProposedMemoryChunkResponse = instanceOfProposedMemoryChunkResponse;
-exports.ProposedMemoryChunkResponseFromJSON = ProposedMemoryChunkResponseFromJSON;
-exports.ProposedMemoryChunkResponseFromJSONTyped = ProposedMemoryChunkResponseFromJSONTyped;
-exports.ProposedMemoryChunkResponseToJSON = ProposedMemoryChunkResponseToJSON;
-exports.ProposedMemoryChunkResponseToJSONTyped = ProposedMemoryChunkResponseToJSONTyped;
-const MemoryScope_1 = require("./MemoryScope");
-const MemoryKind_1 = require("./MemoryKind");
-exports.ProposedMemoryChunkResponsePropertyValidationAttributesMap = {};
+exports.ZipIngestionStatusResponsePropertyValidationAttributesMap = void 0;
+exports.instanceOfZipIngestionStatusResponse = instanceOfZipIngestionStatusResponse;
+exports.ZipIngestionStatusResponseFromJSON = ZipIngestionStatusResponseFromJSON;
+exports.ZipIngestionStatusResponseFromJSONTyped = ZipIngestionStatusResponseFromJSONTyped;
+exports.ZipIngestionStatusResponseToJSON = ZipIngestionStatusResponseToJSON;
+exports.ZipIngestionStatusResponseToJSONTyped = ZipIngestionStatusResponseToJSONTyped;
+const ZipMemberStatusResponse_1 = require("./ZipMemberStatusResponse");
+exports.ZipIngestionStatusResponsePropertyValidationAttributesMap = {};
 /**
- * Check if a given object implements the ProposedMemoryChunkResponse interface.
+ * Check if a given object implements the ZipIngestionStatusResponse interface.
  */
-function instanceOfProposedMemoryChunkResponse(value) {
-    if (!('chunkId' in value) || value['chunkId'] === undefined)
+function instanceOfZipIngestionStatusResponse(value) {
+    if (!('workflowId' in value) || value['workflowId'] === undefined)
         return false;
-    if (!('scope' in value) || value['scope'] === undefined)
+    if (!('temporalStatus' in value) || value['temporalStatus'] === undefined)
         return false;
-    if (!('ownerPathPartId' in value) || value['ownerPathPartId'] === undefined)
-        return false;
-    if (!('kind' in value) || value['kind'] === undefined)
-        return false;
-    if (!('rationale' in value) || value['rationale'] === undefined)
-        return false;
-    if (!('body' in value) || value['body'] === undefined)
-        return false;
-    if (!('proposerTenantUserId' in value) || value['proposerTenantUserId'] === undefined)
-        return false;
-    if (!('runId' in value) || value['runId'] === undefined)
+    if (!('files' in value) || value['files'] === undefined)
         return false;
     return true;
 }
-function ProposedMemoryChunkResponseFromJSON(json) {
-    return ProposedMemoryChunkResponseFromJSONTyped(json, false);
+function ZipIngestionStatusResponseFromJSON(json) {
+    return ZipIngestionStatusResponseFromJSONTyped(json, false);
 }
-function ProposedMemoryChunkResponseFromJSONTyped(json, ignoreDiscriminator) {
+function ZipIngestionStatusResponseFromJSONTyped(json, ignoreDiscriminator) {
     if (json == null) {
         return json;
     }
     return {
-        'chunkId': json['chunk_id'],
-        'scope': (0, MemoryScope_1.MemoryScopeFromJSON)(json['scope']),
-        'ownerPathPartId': json['owner_path_part_id'],
-        'kind': (0, MemoryKind_1.MemoryKindFromJSON)(json['kind']),
-        'rationale': json['rationale'],
-        'body': json['body'],
-        'proposerTenantUserId': json['proposer_tenant_user_id'],
-        'runId': json['run_id'],
+        'workflowId': json['workflow_id'],
+        'temporalStatus': json['temporal_status'],
+        'files': (json['files'].map(ZipMemberStatusResponse_1.ZipMemberStatusResponseFromJSON)),
     };
 }
-function ProposedMemoryChunkResponseToJSON(json) {
-    return ProposedMemoryChunkResponseToJSONTyped(json, false);
+function ZipIngestionStatusResponseToJSON(json) {
+    return ZipIngestionStatusResponseToJSONTyped(json, false);
 }
-function ProposedMemoryChunkResponseToJSONTyped(value, ignoreDiscriminator = false) {
+function ZipIngestionStatusResponseToJSONTyped(value, ignoreDiscriminator = false) {
     if (value == null) {
         return value;
     }
     return {
-        'chunk_id': value['chunkId'],
-        'scope': (0, MemoryScope_1.MemoryScopeToJSON)(value['scope']),
-        'owner_path_part_id': value['ownerPathPartId'],
-        'kind': (0, MemoryKind_1.MemoryKindToJSON)(value['kind']),
-        'rationale': value['rationale'],
-        'body': value['body'],
-        'proposer_tenant_user_id': value['proposerTenantUserId'],
-        'run_id': value['runId'],
+        'workflow_id': value['workflowId'],
+        'temporal_status': value['temporalStatus'],
+        'files': (value['files'].map(ZipMemberStatusResponse_1.ZipMemberStatusResponseToJSON)),
     };
 }

package/dist/models/{ProposedMemoryChunkResponse.d.ts → ZipMemberStatusResponse.d.ts}

@@ -9,64 +9,50 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
-import type { MemoryScope } from './MemoryScope';
-import type { MemoryKind } from './MemoryKind';
 /**
- *
+ * One member's outcome within a ZIP fan-out (from the workflow query).
  * @export
- * @interface ProposedMemoryChunkResponse
+ * @interface ZipMemberStatusResponse
  */
-export interface ProposedMemoryChunkResponse {
+export interface ZipMemberStatusResponse {
     /**
      *
      * @type {string}
-     * @memberof ProposedMemoryChunkResponse
-     */
-    chunkId: string;
-    /**
-     *
-     * @type {MemoryScope}
-     * @memberof ProposedMemoryChunkResponse
+     * @memberof ZipMemberStatusResponse
      */
-    scope: MemoryScope;
+    zipPath: string;
     /**
      *
      * @type {string}
-     * @memberof ProposedMemoryChunkResponse
+     * @memberof ZipMemberStatusResponse
      */
-    ownerPathPartId: string;
-    /**
-     *
-     * @type {MemoryKind}
-     * @memberof ProposedMemoryChunkResponse
-     */
-    kind: MemoryKind;
+    documentId?: string | null;
     /**
      *
      * @type {string}
-     * @memberof ProposedMemoryChunkResponse
+     * @memberof ZipMemberStatusResponse
      */
-    rationale: string;
+    documentVersionId?: string | null;
     /**
      *
      * @type {string}
-     * @memberof ProposedMemoryChunkResponse
+     * @memberof ZipMemberStatusResponse
      */
-    body: string;
+    workflowId?: string | null;
     /**
      *
      * @type {string}
-     * @memberof ProposedMemoryChunkResponse
+     * @memberof ZipMemberStatusResponse
      */
-    proposerTenantUserId: string;
+    error?: string | null;
     /**
      *
-     * @type {string}
-     * @memberof ProposedMemoryChunkResponse
+     * @type {boolean}
+     * @memberof ZipMemberStatusResponse
      */
-    runId: string | null;
+    skipped?: boolean;
 }
-export declare const ProposedMemoryChunkResponsePropertyValidationAttributesMap: {
+export declare const ZipMemberStatusResponsePropertyValidationAttributesMap: {
     [property: string]: {
         maxLength?: number;
         minLength?: number;
@@ -82,10 +68,10 @@ export declare const ProposedMemoryChunkResponsePropertyValidationAttributesMap:
     };
 };
 /**
- * Check if a given object implements the ProposedMemoryChunkResponse interface.
+ * Check if a given object implements the ZipMemberStatusResponse interface.
  */
-export declare function instanceOfProposedMemoryChunkResponse(value: object): value is ProposedMemoryChunkResponse;
-export declare function ProposedMemoryChunkResponseFromJSON(json: any): ProposedMemoryChunkResponse;
-export declare function ProposedMemoryChunkResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): ProposedMemoryChunkResponse;
-export declare function ProposedMemoryChunkResponseToJSON(json: any): ProposedMemoryChunkResponse;
-export declare function ProposedMemoryChunkResponseToJSONTyped(value?: ProposedMemoryChunkResponse | null, ignoreDiscriminator?: boolean): any;
+export declare function instanceOfZipMemberStatusResponse(value: object): value is ZipMemberStatusResponse;
+export declare function ZipMemberStatusResponseFromJSON(json: any): ZipMemberStatusResponse;
+export declare function ZipMemberStatusResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): ZipMemberStatusResponse;
+export declare function ZipMemberStatusResponseToJSON(json: any): ZipMemberStatusResponse;
+export declare function ZipMemberStatusResponseToJSONTyped(value?: ZipMemberStatusResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/models/ZipMemberStatusResponse.js

@@ -0,0 +1,62 @@
+"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.ZipMemberStatusResponsePropertyValidationAttributesMap = void 0;
+exports.instanceOfZipMemberStatusResponse = instanceOfZipMemberStatusResponse;
+exports.ZipMemberStatusResponseFromJSON = ZipMemberStatusResponseFromJSON;
+exports.ZipMemberStatusResponseFromJSONTyped = ZipMemberStatusResponseFromJSONTyped;
+exports.ZipMemberStatusResponseToJSON = ZipMemberStatusResponseToJSON;
+exports.ZipMemberStatusResponseToJSONTyped = ZipMemberStatusResponseToJSONTyped;
+exports.ZipMemberStatusResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the ZipMemberStatusResponse interface.
+ */
+function instanceOfZipMemberStatusResponse(value) {
+    if (!('zipPath' in value) || value['zipPath'] === undefined)
+        return false;
+    return true;
+}
+function ZipMemberStatusResponseFromJSON(json) {
+    return ZipMemberStatusResponseFromJSONTyped(json, false);
+}
+function ZipMemberStatusResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'zipPath': json['zip_path'],
+        'documentId': json['document_id'] == null ? undefined : json['document_id'],
+        'documentVersionId': json['document_version_id'] == null ? undefined : json['document_version_id'],
+        'workflowId': json['workflow_id'] == null ? undefined : json['workflow_id'],
+        'error': json['error'] == null ? undefined : json['error'],
+        'skipped': json['skipped'] == null ? undefined : json['skipped'],
+    };
+}
+function ZipMemberStatusResponseToJSON(json) {
+    return ZipMemberStatusResponseToJSONTyped(json, false);
+}
+function ZipMemberStatusResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'zip_path': value['zipPath'],
+        'document_id': value['documentId'],
+        'document_version_id': value['documentVersionId'],
+        'workflow_id': value['workflowId'],
+        'error': value['error'],
+        'skipped': value['skipped'],
+    };
+}

package/dist/models/index.d.ts

@@ -223,7 +223,6 @@ export * from './PixelRegion';
 export * from './Polygon';
 export * from './PolygonReference';
 export * from './ProposeMemoryChunkRequest';
-export * from './ProposedMemoryChunkResponse';
 export * from './ReasoningPart';
 export * from './ReferenceType';
 export * from './ReorderPathPartRequest';
@@ -361,3 +360,5 @@ export * from './XlsxCellAnchorInputOrDocxParagraphAnchorInput';
 export * from './XlsxCellAnchorOutput';
 export * from './XlsxCellAnchorOutputOrDocxParagraphAnchorOutput';
 export * from './ZipFileResult';
+export * from './ZipIngestionStatusResponse';
+export * from './ZipMemberStatusResponse';

package/dist/models/index.js

@@ -241,7 +241,6 @@ __exportStar(require("./PixelRegion"), exports);
 __exportStar(require("./Polygon"), exports);
 __exportStar(require("./PolygonReference"), exports);
 __exportStar(require("./ProposeMemoryChunkRequest"), exports);
-__exportStar(require("./ProposedMemoryChunkResponse"), exports);
 __exportStar(require("./ReasoningPart"), exports);
 __exportStar(require("./ReferenceType"), exports);
 __exportStar(require("./ReorderPathPartRequest"), exports);
@@ -379,3 +378,5 @@ __exportStar(require("./XlsxCellAnchorInputOrDocxParagraphAnchorInput"), exports
 __exportStar(require("./XlsxCellAnchorOutput"), exports);
 __exportStar(require("./XlsxCellAnchorOutputOrDocxParagraphAnchorOutput"), exports);
 __exportStar(require("./ZipFileResult"), exports);
+__exportStar(require("./ZipIngestionStatusResponse"), exports);
+__exportStar(require("./ZipMemberStatusResponse"), exports);

package/docs/DocumentVersionMetadata.md

@@ -27,6 +27,7 @@ Name | Type
 `quotaPageCount` | number
 `quotaIdempotencyKey` | string
 `fileMd5` | string
+`idempotencyKey` | string
 
 ## Example
 
@@ -55,6 +56,7 @@ const example = {
   "quotaPageCount": null,
   "quotaIdempotencyKey": null,
   "fileMd5": null,
+  "idempotencyKey": null,
 } satisfies DocumentVersionMetadata
 
 console.log(example)

package/docs/DocumentsApi.md

@@ -322,7 +322,7 @@ example().catch(console.error);
 
 ## ingestDocument
 
-> IngestDocumentResponse ingestDocument(file, pathPartId, name, ingestionMode, chunkType, secondaryTaxonomy, pageDpi, workflowRunId, workflowDefinitionId)
+> IngestDocumentResponse ingestDocument(file, pathPartId, name, ingestionMode, chunkType, secondaryTaxonomy, pageDpi, workflowRunId, tagIds, idempotencyKey, workflowDefinitionId)
 
 Ingest Document Handler
 
@@ -364,6 +364,10 @@ async function example() {
     pageDpi: 56,
     // string | Workflow run context for assumed agent uploads. (optional)
     workflowRunId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
+    // Array<string> | Tag IDs applied to the created document. (optional)
+    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,
     // string | Workflow definition context for assumed agent uploads. (optional)
     workflowDefinitionId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
   } satisfies IngestDocumentRequest;
@@ -393,6 +397,8 @@ example().catch(console.error);
 | **secondaryTaxonomy** | `ImageTaxonomy` |  | [Optional] [Defaults to `undefined`] [Enum: picture, 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`] |
+| **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`] |
 | **workflowDefinitionId** | `string` | Workflow definition context for assumed agent uploads. | [Optional] [Defaults to `undefined`] |
 
 ### Return type
@@ -517,11 +523,11 @@ example().catch(console.error);
 
 ## ingestZip
 
-> IngestZipResponse ingestZip(file, pathPartId, ingestionMode)
+> IngestZipResponse ingestZip(file, pathPartId, ingestionMode, tagIds)
 
 Ingest Zip Handler
 
-Upload a ZIP archive and ingest each member file individually.  Directory structure inside the ZIP is preserved as FOLDER PathParts under the target folder. Returns 202 with per-file outcomes — each file that ingests successfully has its own Temporal workflow ID to poll for status.  Whole-archive failures (not a ZIP, zip-bomb, &gt;500 files) return 400 before any DB writes. Per-file failures (unsupported type, oversized) are included in the response with &#x60;&#x60;error&#x60;&#x60; set; other files continue processing.
+Upload a ZIP archive; ingest each member asynchronously via a fan-out.  The whole archive nests under a single FOLDER named after the ZIP file (&#x60;&#x60;report.zip&#x60;&#x60; -&gt; &#x60;&#x60;report/&#x60;&#x60;), with the ZIP\&#39;s directory structure mirrored beneath it as FOLDER PathParts — all created synchronously. Returns 202 with the fan-out &#x60;&#x60;workflow_id&#x60;&#x60; (poll &#x60;&#x60;GET /v1/system-jobs/zip-ingestions/{workflow_id}&#x60;&#x60; for per-member outcomes) plus the artifacts &#x60;&#x60;skipped&#x60;&#x60; during classification.  Whole-archive failures (not a ZIP, zip-bomb, &gt;500 files) return 400 before any DB writes; a re-upload whose ZIP-named folder already exists returns 409. Per-member failures (unsupported type, oversized) surface in the polled workflow results, not in this response. Each member reuses the single-file ingest path, so run-enrollment and completion events fire per member there.
 
 ### Example
 
@@ -549,6 +555,8 @@ async function example() {
     pathPartId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
     // IngestionMode (optional)
     ingestionMode: ...,
+    // Array<string> | Tag IDs applied to every ingested member document. (optional)
+    tagIds: ...,
   } satisfies IngestZipRequest;
 
   try {
@@ -571,6 +579,7 @@ example().catch(console.error);
 | **file** | `Blob` |  | [Defaults to `undefined`] |
 | **pathPartId** | `string` | Parent path part ID (must be a FOLDER type) | [Defaults to `undefined`] |
 | **ingestionMode** | `IngestionMode` |  | [Optional] [Defaults to `undefined`] [Enum: high_accuracy, standard, single_chunk] |
+| **tagIds** | `Array<string>` | Tag IDs applied to every ingested member document. | [Optional] |
 
 ### Return type
 

package/docs/IngestZipResponse.md

@@ -1,17 +1,14 @@
 
 # IngestZipResponse
 
-Aggregate response from a ZIP ingestion batch.
+Response from dispatching a ZIP archive to async ingestion.  ``workflow_id`` is the fan-out workflow to poll at ``GET /v1/system-jobs/zip-ingestions/{workflow_id}`` for per-member outcomes; it is None when the archive held no ingestible members. ``skipped`` are the artifact/error entries resolved synchronously during classification.
 
 ## Properties
 
 Name | Type
 ------------ | -------------
-`files` | [Array<ZipFileResult>](ZipFileResult.md)
-`totalFound` | number
-`succeeded` | number
-`skipped` | number
-`failed` | number
+`workflowId` | string
+`skipped` | [Array<ZipFileResult>](ZipFileResult.md)
 
 ## Example
 
@@ -20,11 +17,8 @@ import type { IngestZipResponse } from '@knowledge-stack/ksapi'
 
 // TODO: Update the object below with actual values
 const example = {
-  "files": null,
-  "totalFound": null,
-  "succeeded": null,
+  "workflowId": null,
   "skipped": null,
-  "failed": null,
 } satisfies IngestZipResponse
 
 console.log(example)

package/docs/MemoryApi.md

@@ -239,7 +239,7 @@ example().catch(console.error);
 
 ## proposeMemoryChunk
 
-> ProposedMemoryChunkResponse proposeMemoryChunk(proposeMemoryChunkRequest)
+> PendingMemoryChunkResponse proposeMemoryChunk(proposeMemoryChunkRequest)
 
 Propose Memory Chunk Handler
 
@@ -288,7 +288,7 @@ example().catch(console.error);
 
 ### Return type
 
-[**ProposedMemoryChunkResponse**](ProposedMemoryChunkResponse.md)
+[**PendingMemoryChunkResponse**](PendingMemoryChunkResponse.md)
 
 ### Authorization