@knowledge-stack/ksapi 3.13.0 → 3.14.0

package/dist/esm/apis/SystemJobsApi.js

@@ -21,11 +21,60 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { PaginatedResponseWorkflowSummaryResponseFromJSON, TemporalWorkflowStatusResponseFromJSON, WorkflowActionResponseFromJSON, WorkflowCancelResponseFromJSON, WorkflowDetailResponseFromJSON, ZipIngestionStatusResponseFromJSON, } from '../models/index';
+import { BulkOperationResponseFromJSON, BulkRerunRequestToJSON, PaginatedResponseUserInfoFromJSON, PaginatedResponseWorkflowSummaryResponseFromJSON, TemporalWorkflowStatusResponseFromJSON, WorkflowActionResponseFromJSON, WorkflowCancelResponseFromJSON, WorkflowDetailResponseFromJSON, ZipIngestionStatusResponseFromJSON, } from '../models/index';
 /**
  *
  */
 export class SystemJobsApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for bulkRerunDvWorkflows without sending the request
+     */
+    bulkRerunDvWorkflowsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['bulkRerunRequest'] == null) {
+                throw new runtime.RequiredError('bulkRerunRequest', 'Required parameter "bulkRerunRequest" was null or undefined when calling bulkRerunDvWorkflows().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/v1/system-jobs/document_versions/bulk-rerun`;
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: BulkRerunRequestToJSON(requestParameters['bulkRerunRequest']),
+            };
+        });
+    }
+    /**
+     * Re-run ingestion for the selected document versions, reporting per item.  ``not_found``: missing, trashed, never ingested or without its stored source; ``forbidden``: no ``can_write``; ``in_progress_workflow``: still pending/processing; ``already_ingested``: completed; ``unsupported_document_type``: a type that is no longer ingested; ``superseded``: a newer version of the document exists. More than 200 ids is a 400 before any re-run.
+     * Bulk Rerun Dv Workflows Handler
+     */
+    bulkRerunDvWorkflowsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.bulkRerunDvWorkflowsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => BulkOperationResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Re-run ingestion for the selected document versions, reporting per item.  ``not_found``: missing, trashed, never ingested or without its stored source; ``forbidden``: no ``can_write``; ``in_progress_workflow``: still pending/processing; ``already_ingested``: completed; ``unsupported_document_type``: a type that is no longer ingested; ``superseded``: a newer version of the document exists. More than 200 ids is a 400 before any re-run.
+     * Bulk Rerun Dv Workflows Handler
+     */
+    bulkRerunDvWorkflows(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.bulkRerunDvWorkflowsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for cancelTemporalWorkflow without sending the request
      */
@@ -54,7 +103,7 @@ export class SystemJobsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Cancel any Temporal workflow owned by the caller\'s tenant.  No status guard — this is a thin Temporal wrapper. Cancelling an already-terminal workflow is a no-op on the Temporal side.
+     * Cancel any Temporal workflow owned by the caller\'s tenant.  No status guard — this is a thin Temporal wrapper. Cancelling an already-terminal workflow is a no-op on the Temporal side. A run no worker ever picked up is terminated instead, since a cancel request is itself a workflow task nobody would process. When Temporal no longer has the run, or it was terminated here, a document version still showing it running is settled as cancelled (needs ``can_write``) so it can be re-run.
      * Cancel Temporal Workflow Handler
      */
     cancelTemporalWorkflowRaw(requestParameters, initOverrides) {
@@ -65,7 +114,7 @@ export class SystemJobsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Cancel any Temporal workflow owned by the caller\'s tenant.  No status guard — this is a thin Temporal wrapper. Cancelling an already-terminal workflow is a no-op on the Temporal side.
+     * Cancel any Temporal workflow owned by the caller\'s tenant.  No status guard — this is a thin Temporal wrapper. Cancelling an already-terminal workflow is a no-op on the Temporal side. A run no worker ever picked up is terminated instead, since a cancel request is itself a workflow task nobody would process. When Temporal no longer has the run, or it was terminated here, a document version still showing it running is settled as cancelled (needs ``can_write``) so it can be re-run.
      * Cancel Temporal Workflow Handler
      */
     cancelTemporalWorkflow(requestParameters, initOverrides) {
@@ -102,7 +151,7 @@ export class SystemJobsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Rerun a workflow. USER role requires ``can_write`` on the document path.  ``s3_client`` is injected because ``DocumentIngestionService.__init__`` requires it, even though the re-ingestion path reuses the existing S3 source.
+     * Rerun a workflow. USER role requires ``can_write`` on the document path.  A version that a newer live version supersedes is refused with 409. ``s3_client`` is injected because ``DocumentIngestionService.__init__`` requires it, even though the re-ingestion path reuses the existing S3 source.
      * Dv Workflow Rerun Handler
      */
     dvWorkflowRerunRaw(requestParameters, initOverrides) {
@@ -113,7 +162,7 @@ export class SystemJobsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Rerun a workflow. USER role requires ``can_write`` on the document path.  ``s3_client`` is injected because ``DocumentIngestionService.__init__`` requires it, even though the re-ingestion path reuses the existing S3 source.
+     * Rerun a workflow. USER role requires ``can_write`` on the document path.  A version that a newer live version supersedes is refused with 409. ``s3_client`` is injected because ``DocumentIngestionService.__init__`` requires it, even though the re-ingestion path reuses the existing S3 source.
      * Dv Workflow Rerun Handler
      */
     dvWorkflowRerun(requestParameters, initOverrides) {
@@ -246,7 +295,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 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. Any other workflow type has no ``results`` query and is a 404, not a 500.
      * Get Zip Ingestion Status Handler
      */
     getZipIngestionStatusRaw(requestParameters, initOverrides) {
@@ -257,7 +306,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 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. Any other workflow type has no ``results`` query and is a 404, not a 500.
      * Get Zip Ingestion Status Handler
      */
     getZipIngestionStatus(requestParameters, initOverrides) {
@@ -266,6 +315,59 @@ export class SystemJobsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for listDvWorkflowUploaders without sending the request
+     */
+    listDvWorkflowUploadersRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryParameters = {};
+            if (requestParameters['usernameLike'] != null) {
+                queryParameters['username_like'] = requestParameters['usernameLike'];
+            }
+            if (requestParameters['limit'] != null) {
+                queryParameters['limit'] = requestParameters['limit'];
+            }
+            if (requestParameters['offset'] != null) {
+                queryParameters['offset'] = requestParameters['offset'];
+            }
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/v1/system-jobs/document_versions/uploaders`;
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * People who uploaded a version the caller can list, for the uploader filter.  Scoped like ``list_dv_workflows``: USER only counts versions under readable paths.
+     * List Dv Workflow Uploaders Handler
+     */
+    listDvWorkflowUploadersRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.listDvWorkflowUploadersRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseUserInfoFromJSON(jsonValue));
+        });
+    }
+    /**
+     * People who uploaded a version the caller can list, for the uploader filter.  Scoped like ``list_dv_workflows``: USER only counts versions under readable paths.
+     * List Dv Workflow Uploaders Handler
+     */
+    listDvWorkflowUploaders() {
+        return __awaiter(this, arguments, void 0, function* (requestParameters = {}, initOverrides) {
+            const response = yield this.listDvWorkflowUploadersRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for listDvWorkflows without sending the request
      */
@@ -278,6 +380,33 @@ export class SystemJobsApi extends runtime.BaseAPI {
             if (requestParameters['offset'] != null) {
                 queryParameters['offset'] = requestParameters['offset'];
             }
+            if (requestParameters['sortDir'] != null) {
+                queryParameters['sort_dir'] = requestParameters['sortDir'];
+            }
+            if (requestParameters['status'] != null) {
+                queryParameters['status'] = requestParameters['status'];
+            }
+            if (requestParameters['nameLike'] != null) {
+                queryParameters['name_like'] = requestParameters['nameLike'];
+            }
+            if (requestParameters['latestVersionOnly'] != null) {
+                queryParameters['latest_version_only'] = requestParameters['latestVersionOnly'];
+            }
+            if (requestParameters['uploaderUserId'] != null) {
+                queryParameters['uploader_user_id'] = requestParameters['uploaderUserId'];
+            }
+            if (requestParameters['createdAfter'] != null) {
+                queryParameters['created_after'] = requestParameters['createdAfter'].toISOString();
+            }
+            if (requestParameters['createdBefore'] != null) {
+                queryParameters['created_before'] = requestParameters['createdBefore'].toISOString();
+            }
+            if (requestParameters['updatedAfter'] != null) {
+                queryParameters['updated_after'] = requestParameters['updatedAfter'].toISOString();
+            }
+            if (requestParameters['updatedBefore'] != null) {
+                queryParameters['updated_before'] = requestParameters['updatedBefore'].toISOString();
+            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
@@ -296,7 +425,7 @@ export class SystemJobsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List all workflows for the current tenant (paginated, DB-backed).  ADMIN/OWNER see all workflows; USER sees only those under permitted paths.
+     * List ingestions of live documents in the current tenant, newest upload first.  ADMIN/OWNER see every version; USER only versions under readable paths. ``sort_dir=ASC`` lists the oldest upload first.
      * List Dv Workflows Handler
      */
     listDvWorkflowsRaw(requestParameters, initOverrides) {
@@ -307,7 +436,7 @@ export class SystemJobsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List all workflows for the current tenant (paginated, DB-backed).  ADMIN/OWNER see all workflows; USER sees only those under permitted paths.
+     * List ingestions of live documents in the current tenant, newest upload first.  ADMIN/OWNER see every version; USER only versions under readable paths. ``sort_dir=ASC`` lists the oldest upload first.
      * List Dv Workflows Handler
      */
     listDvWorkflows() {

package/dist/esm/models/BulkFailureReason.d.ts

@@ -28,6 +28,9 @@ export declare const BulkFailureReason: {
     readonly NameConflict: 'name_conflict';
     readonly InProgressWorkflow: 'in_progress_workflow';
     readonly PermissionLimit: 'permission_limit';
+    readonly AlreadyIngested: 'already_ingested';
+    readonly UnsupportedDocumentType: 'unsupported_document_type';
+    readonly Superseded: 'superseded';
 };
 export type BulkFailureReason = typeof BulkFailureReason[keyof typeof BulkFailureReason];
 export declare function instanceOfBulkFailureReason(value: any): boolean;

package/dist/esm/models/BulkFailureReason.js

@@ -29,7 +29,10 @@ export const BulkFailureReason = {
     CheckedOut: 'checked_out',
     NameConflict: 'name_conflict',
     InProgressWorkflow: 'in_progress_workflow',
-    PermissionLimit: 'permission_limit'
+    PermissionLimit: 'permission_limit',
+    AlreadyIngested: 'already_ingested',
+    UnsupportedDocumentType: 'unsupported_document_type',
+    Superseded: 'superseded'
 };
 export function instanceOfBulkFailureReason(value) {
     for (const key in BulkFailureReason) {

package/dist/esm/models/BulkRerunRequest.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 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.
+ */
+/**
+ * Re-run ingestion for the selected document versions.
+ * @export
+ * @interface BulkRerunRequest
+ */
+export interface BulkRerunRequest {
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof BulkRerunRequest
+     */
+    documentVersionIds?: Array<string>;
+}
+export declare const BulkRerunRequestPropertyValidationAttributesMap: {
+    [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 BulkRerunRequest interface.
+ */
+export declare function instanceOfBulkRerunRequest(value: object): value is BulkRerunRequest;
+export declare function BulkRerunRequestFromJSON(json: any): BulkRerunRequest;
+export declare function BulkRerunRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): BulkRerunRequest;
+export declare function BulkRerunRequestToJSON(json: any): BulkRerunRequest;
+export declare function BulkRerunRequestToJSONTyped(value?: BulkRerunRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/BulkRerunRequest.js

@@ -0,0 +1,42 @@
+/* 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.
+ */
+export const BulkRerunRequestPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the BulkRerunRequest interface.
+ */
+export function instanceOfBulkRerunRequest(value) {
+    return true;
+}
+export function BulkRerunRequestFromJSON(json) {
+    return BulkRerunRequestFromJSONTyped(json, false);
+}
+export function BulkRerunRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'documentVersionIds': json['document_version_ids'] == null ? undefined : json['document_version_ids'],
+    };
+}
+export function BulkRerunRequestToJSON(json) {
+    return BulkRerunRequestToJSONTyped(json, false);
+}
+export function BulkRerunRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'document_version_ids': value['documentVersionIds'],
+    };
+}

package/dist/esm/models/PaginatedResponseUserInfo.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 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 { UserInfo } from './UserInfo';
+/**
+ *
+ * @export
+ * @interface PaginatedResponseUserInfo
+ */
+export interface PaginatedResponseUserInfo {
+    /**
+     * List of items
+     * @type {Array<UserInfo>}
+     * @memberof PaginatedResponseUserInfo
+     */
+    items: Array<UserInfo>;
+    /**
+     * Total number of items
+     * @type {number}
+     * @memberof PaginatedResponseUserInfo
+     */
+    total: number;
+    /**
+     * Number of items per page
+     * @type {number}
+     * @memberof PaginatedResponseUserInfo
+     */
+    limit: number;
+    /**
+     * Number of items to skip
+     * @type {number}
+     * @memberof PaginatedResponseUserInfo
+     */
+    offset: number;
+}
+export declare const PaginatedResponseUserInfoPropertyValidationAttributesMap: {
+    [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 PaginatedResponseUserInfo interface.
+ */
+export declare function instanceOfPaginatedResponseUserInfo(value: object): value is PaginatedResponseUserInfo;
+export declare function PaginatedResponseUserInfoFromJSON(json: any): PaginatedResponseUserInfo;
+export declare function PaginatedResponseUserInfoFromJSONTyped(json: any, ignoreDiscriminator: boolean): PaginatedResponseUserInfo;
+export declare function PaginatedResponseUserInfoToJSON(json: any): PaginatedResponseUserInfo;
+export declare function PaginatedResponseUserInfoToJSONTyped(value?: PaginatedResponseUserInfo | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/PaginatedResponseUserInfo.js

@@ -0,0 +1,70 @@
+/* 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.
+ */
+import { UserInfoFromJSON, UserInfoToJSON, } from './UserInfo';
+export const PaginatedResponseUserInfoPropertyValidationAttributesMap = {
+    total: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+    limit: {
+        minimum: 1,
+        exclusiveMinimum: false,
+    },
+    offset: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+};
+/**
+ * Check if a given object implements the PaginatedResponseUserInfo interface.
+ */
+export function instanceOfPaginatedResponseUserInfo(value) {
+    if (!('items' in value) || value['items'] === undefined)
+        return false;
+    if (!('total' in value) || value['total'] === undefined)
+        return false;
+    if (!('limit' in value) || value['limit'] === undefined)
+        return false;
+    if (!('offset' in value) || value['offset'] === undefined)
+        return false;
+    return true;
+}
+export function PaginatedResponseUserInfoFromJSON(json) {
+    return PaginatedResponseUserInfoFromJSONTyped(json, false);
+}
+export function PaginatedResponseUserInfoFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'items': (json['items'].map(UserInfoFromJSON)),
+        'total': json['total'],
+        'limit': json['limit'],
+        'offset': json['offset'],
+    };
+}
+export function PaginatedResponseUserInfoToJSON(json) {
+    return PaginatedResponseUserInfoToJSONTyped(json, false);
+}
+export function PaginatedResponseUserInfoToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'items': (value['items'].map(UserInfoToJSON)),
+        'total': value['total'],
+        'limit': value['limit'],
+        'offset': value['offset'],
+    };
+}

package/dist/esm/models/WorkflowDetailResponse.d.ts

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import type { PipelineStatus } from './PipelineStatus';
+import type { UserInfo } from './UserInfo';
 /**
  * Single item - adds live Temporal fields.
  * @export
@@ -28,12 +29,36 @@ export interface WorkflowDetailResponse {
      * @memberof WorkflowDetailResponse
      */
     documentId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof WorkflowDetailResponse
+     */
+    documentName: string;
+    /**
+     * The document's path
+     * @type {string}
+     * @memberof WorkflowDetailResponse
+     */
+    materializedPath: string;
     /**
      *
      * @type {string}
      * @memberof WorkflowDetailResponse
      */
     documentVersionId: string;
+    /**
+     * Whether this version is the document's active one; false for an unfinished newer upload and for a superseded older version
+     * @type {boolean}
+     * @memberof WorkflowDetailResponse
+     */
+    isActiveVersion: boolean;
+    /**
+     *
+     * @type {UserInfo}
+     * @memberof WorkflowDetailResponse
+     */
+    uploader: UserInfo;
     /**
      *
      * @type {PipelineStatus}
@@ -53,7 +78,7 @@ export interface WorkflowDetailResponse {
      */
     error?: string | null;
     /**
-     *
+     * When the last run started; the upload time until a run has started
      * @type {Date}
      * @memberof WorkflowDetailResponse
      */

package/dist/esm/models/WorkflowDetailResponse.js

@@ -12,6 +12,7 @@
  * Do not edit the class manually.
  */
 import { PipelineStatusFromJSON, PipelineStatusToJSON, } from './PipelineStatus';
+import { UserInfoFromJSON, UserInfoToJSON, } from './UserInfo';
 export const WorkflowDetailResponsePropertyValidationAttributesMap = {};
 /**
  * Check if a given object implements the WorkflowDetailResponse interface.
@@ -21,8 +22,16 @@ export function instanceOfWorkflowDetailResponse(value) {
         return false;
     if (!('documentId' in value) || value['documentId'] === undefined)
         return false;
+    if (!('documentName' in value) || value['documentName'] === undefined)
+        return false;
+    if (!('materializedPath' in value) || value['materializedPath'] === undefined)
+        return false;
     if (!('documentVersionId' in value) || value['documentVersionId'] === undefined)
         return false;
+    if (!('isActiveVersion' in value) || value['isActiveVersion'] === undefined)
+        return false;
+    if (!('uploader' in value) || value['uploader'] === undefined)
+        return false;
     if (!('status' in value) || value['status'] === undefined)
         return false;
     if (!('lastRunTimestamp' in value) || value['lastRunTimestamp'] === undefined)
@@ -51,7 +60,11 @@ export function WorkflowDetailResponseFromJSONTyped(json, ignoreDiscriminator) {
     return {
         'workflowId': json['workflow_id'],
         'documentId': json['document_id'],
+        'documentName': json['document_name'],
+        'materializedPath': json['materialized_path'],
         'documentVersionId': json['document_version_id'],
+        'isActiveVersion': json['is_active_version'],
+        'uploader': UserInfoFromJSON(json['uploader']),
         'status': PipelineStatusFromJSON(json['status']),
         'lastActivity': json['last_activity'] == null ? undefined : json['last_activity'],
         'error': json['error'] == null ? undefined : json['error'],
@@ -77,7 +90,11 @@ export function WorkflowDetailResponseToJSONTyped(value, ignoreDiscriminator = f
     return {
         'workflow_id': value['workflowId'],
         'document_id': value['documentId'],
+        'document_name': value['documentName'],
+        'materialized_path': value['materializedPath'],
         'document_version_id': value['documentVersionId'],
+        'is_active_version': value['isActiveVersion'],
+        'uploader': UserInfoToJSON(value['uploader']),
         'status': PipelineStatusToJSON(value['status']),
         'last_activity': value['lastActivity'],
         'error': value['error'],

package/dist/esm/models/WorkflowSummaryResponse.d.ts

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import type { PipelineStatus } from './PipelineStatus';
+import type { UserInfo } from './UserInfo';
 /**
  * List item - DB-only fields, no Temporal call per item.
  * @export
@@ -28,12 +29,36 @@ export interface WorkflowSummaryResponse {
      * @memberof WorkflowSummaryResponse
      */
     documentId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof WorkflowSummaryResponse
+     */
+    documentName: string;
+    /**
+     * The document's path
+     * @type {string}
+     * @memberof WorkflowSummaryResponse
+     */
+    materializedPath: string;
     /**
      *
      * @type {string}
      * @memberof WorkflowSummaryResponse
      */
     documentVersionId: string;
+    /**
+     * Whether this version is the document's active one; false for an unfinished newer upload and for a superseded older version
+     * @type {boolean}
+     * @memberof WorkflowSummaryResponse
+     */
+    isActiveVersion: boolean;
+    /**
+     *
+     * @type {UserInfo}
+     * @memberof WorkflowSummaryResponse
+     */
+    uploader: UserInfo;
     /**
      *
      * @type {PipelineStatus}
@@ -53,7 +78,7 @@ export interface WorkflowSummaryResponse {
      */
     error?: string | null;
     /**
-     *
+     * When the last run started; the upload time until a run has started
      * @type {Date}
      * @memberof WorkflowSummaryResponse
      */