@knowledge-stack/ksapi 1.88.1 → 1.89.0

package/dist/esm/apis/WorkflowRunsApi.js

@@ -21,56 +21,57 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { PathPartApprovalResponseFromJSON, RejectFileRequestToJSON, WorkflowCallbackResponseFromJSON, WorkflowRunCallbackRequestToJSON, WorkflowRunResponseFromJSON, } from '../models/index';
+import { CloneWorkflowRunRequestToJSON, SetWorkflowRunApprovalRequestToJSON, UpdateWorkflowRunRequestToJSON, WorkflowCallbackResponseFromJSON, WorkflowRunCallbackRequestToJSON, WorkflowRunResponseFromJSON, } from '../models/index';
 /**
  *
  */
 export class WorkflowRunsApi extends runtime.BaseAPI {
     /**
-     * Creates request options for approveWorkflowRunFile without sending the request
+     * Creates request options for cloneWorkflowRun without sending the request
      */
-    approveWorkflowRunFileRequestOpts(requestParameters) {
+    cloneWorkflowRunRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['runId'] == null) {
-                throw new runtime.RequiredError('runId', 'Required parameter "runId" was null or undefined when calling approveWorkflowRunFile().');
+                throw new runtime.RequiredError('runId', 'Required parameter "runId" was null or undefined when calling cloneWorkflowRun().');
             }
-            if (requestParameters['pathPartId'] == null) {
-                throw new runtime.RequiredError('pathPartId', 'Required parameter "pathPartId" was null or undefined when calling approveWorkflowRunFile().');
+            if (requestParameters['cloneWorkflowRunRequest'] == null) {
+                throw new runtime.RequiredError('cloneWorkflowRunRequest', 'Required parameter "cloneWorkflowRunRequest" was null or undefined when calling cloneWorkflowRun().');
             }
             const queryParameters = {};
             const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
             if (requestParameters['authorization'] != null) {
                 headerParameters['authorization'] = String(requestParameters['authorization']);
             }
-            let urlPath = `/v1/workflow-runs/{run_id}/files/{path_part_id}/approve`;
+            let urlPath = `/v1/workflow-runs/{run_id}/clone`;
             urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
-            urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
             return {
                 path: urlPath,
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
+                body: CloneWorkflowRunRequestToJSON(requestParameters['cloneWorkflowRunRequest']),
             };
         });
     }
     /**
-     * Approve a generated file or the run folder itself.  Open to any user with ``can_write`` on the run path — both individual child files and the run folder (the final verdict that flips the run to APPROVED). Folder approval still requires no descendants in ``pending`` or ``rejected`` state.
-     * Approve Workflow Run File Handler
+     * Clone a started run into a new NOT_STARTED draft.  ``include_inputs=True`` pins the source\'s snapshotted inputs onto the new run; uploads stay in the source\'s ``inputs/`` and are referenced by path_part_id. No S3 copy. A NOT_STARTED source has no snapshot to pin → 409. The clone is born NOT_STARTED so the user can edit it (PATCH) before pressing Start.
+     * Clone Workflow Run Handler
      */
-    approveWorkflowRunFileRaw(requestParameters, initOverrides) {
+    cloneWorkflowRunRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const requestOptions = yield this.approveWorkflowRunFileRequestOpts(requestParameters);
+            const requestOptions = yield this.cloneWorkflowRunRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => PathPartApprovalResponseFromJSON(jsonValue));
+            return new runtime.JSONApiResponse(response, (jsonValue) => WorkflowRunResponseFromJSON(jsonValue));
         });
     }
     /**
-     * Approve a generated file or the run folder itself.  Open to any user with ``can_write`` on the run path — both individual child files and the run folder (the final verdict that flips the run to APPROVED). Folder approval still requires no descendants in ``pending`` or ``rejected`` state.
-     * Approve Workflow Run File Handler
+     * Clone a started run into a new NOT_STARTED draft.  ``include_inputs=True`` pins the source\'s snapshotted inputs onto the new run; uploads stay in the source\'s ``inputs/`` and are referenced by path_part_id. No S3 copy. A NOT_STARTED source has no snapshot to pin → 409. The clone is born NOT_STARTED so the user can edit it (PATCH) before pressing Start.
+     * Clone Workflow Run Handler
      */
-    approveWorkflowRunFile(requestParameters, initOverrides) {
+    cloneWorkflowRun(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.approveWorkflowRunFileRaw(requestParameters, initOverrides);
+            const response = yield this.cloneWorkflowRunRaw(requestParameters, initOverrides);
             return yield response.value();
         });
     }
@@ -158,18 +159,15 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Creates request options for rejectWorkflowRunFile without sending the request
+     * Creates request options for setWorkflowRunApproval without sending the request
      */
-    rejectWorkflowRunFileRequestOpts(requestParameters) {
+    setWorkflowRunApprovalRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['runId'] == null) {
-                throw new runtime.RequiredError('runId', 'Required parameter "runId" was null or undefined when calling rejectWorkflowRunFile().');
-            }
-            if (requestParameters['pathPartId'] == null) {
-                throw new runtime.RequiredError('pathPartId', 'Required parameter "pathPartId" was null or undefined when calling rejectWorkflowRunFile().');
+                throw new runtime.RequiredError('runId', 'Required parameter "runId" was null or undefined when calling setWorkflowRunApproval().');
             }
-            if (requestParameters['rejectFileRequest'] == null) {
-                throw new runtime.RequiredError('rejectFileRequest', 'Required parameter "rejectFileRequest" was null or undefined when calling rejectWorkflowRunFile().');
+            if (requestParameters['setWorkflowRunApprovalRequest'] == null) {
+                throw new runtime.RequiredError('setWorkflowRunApprovalRequest', 'Required parameter "setWorkflowRunApprovalRequest" was null or undefined when calling setWorkflowRunApproval().');
             }
             const queryParameters = {};
             const headerParameters = {};
@@ -177,58 +175,53 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
             if (requestParameters['authorization'] != null) {
                 headerParameters['authorization'] = String(requestParameters['authorization']);
             }
-            let urlPath = `/v1/workflow-runs/{run_id}/files/{path_part_id}/reject`;
+            let urlPath = `/v1/workflow-runs/{run_id}/approval`;
             urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
-            urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
             return {
                 path: urlPath,
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: RejectFileRequestToJSON(requestParameters['rejectFileRequest']),
+                body: SetWorkflowRunApprovalRequestToJSON(requestParameters['setWorkflowRunApprovalRequest']),
             };
         });
     }
     /**
-     * Reject a generated file or the run folder itself with a reason.  Open to any user with ``can_write`` on the run path — both individual child files and the run folder (the final verdict that flips the run to REJECTED).
-     * Reject Workflow Run File Handler
+     * Approve an entire completed run in one call.  Approves every output document under ``outputs/`` then the run folder. The run must be ``COMPLETED`` and its definition must have required approval. Requires write access to the run folder. ``run_id`` is the WorkflowRun id.
+     * Set Workflow Run Approval Handler
      */
-    rejectWorkflowRunFileRaw(requestParameters, initOverrides) {
+    setWorkflowRunApprovalRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const requestOptions = yield this.rejectWorkflowRunFileRequestOpts(requestParameters);
+            const requestOptions = yield this.setWorkflowRunApprovalRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => PathPartApprovalResponseFromJSON(jsonValue));
+            return new runtime.JSONApiResponse(response, (jsonValue) => WorkflowRunResponseFromJSON(jsonValue));
         });
     }
     /**
-     * Reject a generated file or the run folder itself with a reason.  Open to any user with ``can_write`` on the run path — both individual child files and the run folder (the final verdict that flips the run to REJECTED).
-     * Reject Workflow Run File Handler
+     * Approve an entire completed run in one call.  Approves every output document under ``outputs/`` then the run folder. The run must be ``COMPLETED`` and its definition must have required approval. Requires write access to the run folder. ``run_id`` is the WorkflowRun id.
+     * Set Workflow Run Approval Handler
      */
-    rejectWorkflowRunFile(requestParameters, initOverrides) {
+    setWorkflowRunApproval(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.rejectWorkflowRunFileRaw(requestParameters, initOverrides);
+            const response = yield this.setWorkflowRunApprovalRaw(requestParameters, initOverrides);
             return yield response.value();
         });
     }
     /**
-     * Creates request options for unapproveWorkflowRunFile without sending the request
+     * Creates request options for startWorkflowRun without sending the request
      */
-    unapproveWorkflowRunFileRequestOpts(requestParameters) {
+    startWorkflowRunRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['runId'] == null) {
-                throw new runtime.RequiredError('runId', 'Required parameter "runId" was null or undefined when calling unapproveWorkflowRunFile().');
-            }
-            if (requestParameters['pathPartId'] == null) {
-                throw new runtime.RequiredError('pathPartId', 'Required parameter "pathPartId" was null or undefined when calling unapproveWorkflowRunFile().');
+                throw new runtime.RequiredError('runId', 'Required parameter "runId" was null or undefined when calling startWorkflowRun().');
             }
             const queryParameters = {};
             const headerParameters = {};
             if (requestParameters['authorization'] != null) {
                 headerParameters['authorization'] = String(requestParameters['authorization']);
             }
-            let urlPath = `/v1/workflow-runs/{run_id}/files/{path_part_id}/unapprove`;
+            let urlPath = `/v1/workflow-runs/{run_id}/start`;
             urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
-            urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
             return {
                 path: urlPath,
                 method: 'POST',
@@ -238,23 +231,72 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Revert an approved or rejected file to ``pending``.  Open to any user with ``can_write`` on the run path. Cannot unapprove a leaf whose ancestor is currently ``approved`` — unapprove the ancestor first.
-     * Unapprove Workflow Run File Handler
+     * Flip a NOT_STARTED run to IN_PROGRESS and dispatch its agent run.  Idempotent on IN_PROGRESS (returns the row). Terminal states → 409. Inputs still ingesting or in a failed terminal state → 409. The snapshot is built at this point (KB DOCUMENTs resolve to active versions, uploaded DVs are walked from inputs/, KB FOLDERs stay live).
+     * Start Workflow Run Handler
      */
-    unapproveWorkflowRunFileRaw(requestParameters, initOverrides) {
+    startWorkflowRunRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const requestOptions = yield this.unapproveWorkflowRunFileRequestOpts(requestParameters);
+            const requestOptions = yield this.startWorkflowRunRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => PathPartApprovalResponseFromJSON(jsonValue));
+            return new runtime.JSONApiResponse(response, (jsonValue) => WorkflowRunResponseFromJSON(jsonValue));
         });
     }
     /**
-     * Revert an approved or rejected file to ``pending``.  Open to any user with ``can_write`` on the run path. Cannot unapprove a leaf whose ancestor is currently ``approved`` — unapprove the ancestor first.
-     * Unapprove Workflow Run File Handler
+     * Flip a NOT_STARTED run to IN_PROGRESS and dispatch its agent run.  Idempotent on IN_PROGRESS (returns the row). Terminal states → 409. Inputs still ingesting or in a failed terminal state → 409. The snapshot is built at this point (KB DOCUMENTs resolve to active versions, uploaded DVs are walked from inputs/, KB FOLDERs stay live).
+     * Start Workflow Run Handler
      */
-    unapproveWorkflowRunFile(requestParameters, initOverrides) {
+    startWorkflowRun(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.unapproveWorkflowRunFileRaw(requestParameters, initOverrides);
+            const response = yield this.startWorkflowRunRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for updateWorkflowRun without sending the request
+     */
+    updateWorkflowRunRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['runId'] == null) {
+                throw new runtime.RequiredError('runId', 'Required parameter "runId" was null or undefined when calling updateWorkflowRun().');
+            }
+            if (requestParameters['updateWorkflowRunRequest'] == null) {
+                throw new runtime.RequiredError('updateWorkflowRunRequest', 'Required parameter "updateWorkflowRunRequest" was null or undefined when calling updateWorkflowRun().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['authorization'] != null) {
+                headerParameters['authorization'] = String(requestParameters['authorization']);
+            }
+            let urlPath = `/v1/workflow-runs/{run_id}`;
+            urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
+            return {
+                path: urlPath,
+                method: 'PATCH',
+                headers: headerParameters,
+                query: queryParameters,
+                body: UpdateWorkflowRunRequestToJSON(requestParameters['updateWorkflowRunRequest']),
+            };
+        });
+    }
+    /**
+     * Edit a NOT_STARTED run\'s KB scope and / or display name.  Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation.
+     * Update Workflow Run Handler
+     */
+    updateWorkflowRunRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.updateWorkflowRunRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => WorkflowRunResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Edit a NOT_STARTED run\'s KB scope and / or display name.  Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation.
+     * Update Workflow Run Handler
+     */
+    updateWorkflowRun(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.updateWorkflowRunRaw(requestParameters, initOverrides);
             return yield response.value();
         });
     }
@@ -272,6 +314,9 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['authorization'] != null) {
+                headerParameters['authorization'] = String(requestParameters['authorization']);
+            }
             let urlPath = `/v1/workflow-runs/{run_id}/callback`;
             urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
             return {
@@ -284,6 +329,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
         });
     }
     /**
+     * Terminal-state write seam for the in-process agent runner.  The gating Temporal activities ``mark_run_completed_activity`` and ``mark_run_failed_activity`` authenticate as the triggering user (via ``assume_user``) and POST here. Only the user who triggered the run (or OWNER/ADMIN) may write its terminal state. The handler is idempotent: a callback against an already-terminal row returns ``already_terminal`` and the activity-level retry treats it as a no-op.
      * Workflow Run Callback Handler
      */
     workflowRunCallbackRaw(requestParameters, initOverrides) {
@@ -294,6 +340,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
         });
     }
     /**
+     * Terminal-state write seam for the in-process agent runner.  The gating Temporal activities ``mark_run_completed_activity`` and ``mark_run_failed_activity`` authenticate as the triggering user (via ``assume_user``) and POST here. Only the user who triggered the run (or OWNER/ADMIN) may write its terminal state. The handler is idempotent: a callback against an already-terminal row returns ``already_terminal`` and the activity-level retry treats it as a no-op.
      * Workflow Run Callback Handler
      */
     workflowRunCallback(requestParameters, initOverrides) {

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

@@ -11,6 +11,7 @@ export * from './FeaturesApi';
 export * from './FeedbackApi';
 export * from './FoldersApi';
 export * from './InvitesApi';
+export * from './PathPartApprovalsApi';
 export * from './PathPartsApi';
 export * from './PublicApi';
 export * from './SectionsApi';

package/dist/esm/apis/index.js

@@ -13,6 +13,7 @@ export * from './FeaturesApi';
 export * from './FeedbackApi';
 export * from './FoldersApi';
 export * from './InvitesApi';
+export * from './PathPartApprovalsApi';
 export * from './PathPartsApi';
 export * from './PublicApi';
 export * from './SectionsApi';

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

@@ -11,6 +11,7 @@
  */
 import type { ChunkMetadata } from './ChunkMetadata';
 import type { ChunkType } from './ChunkType';
+import type { PathPartApprovalState } from './PathPartApprovalState';
 /**
  * Response model for a chunk item in document version contents.
  * @export
@@ -83,6 +84,12 @@ export interface ChunkContentItem {
      * @memberof ChunkContentItem
      */
     systemManaged: boolean;
+    /**
+     *
+     * @type {PathPartApprovalState}
+     * @memberof ChunkContentItem
+     */
+    approvalState: PathPartApprovalState;
     /**
      * Creation timestamp
      * @type {Date}

package/dist/esm/models/ChunkContentItem.js

@@ -13,6 +13,7 @@
  */
 import { ChunkMetadataFromJSON, ChunkMetadataToJSON, } from './ChunkMetadata';
 import { ChunkTypeFromJSON, ChunkTypeToJSON, } from './ChunkType';
+import { PathPartApprovalStateFromJSON, PathPartApprovalStateToJSON, } from './PathPartApprovalState';
 /**
  * @export
  */
@@ -40,6 +41,8 @@ export function instanceOfChunkContentItem(value) {
         return false;
     if (!('systemManaged' in value) || value['systemManaged'] === undefined)
         return false;
+    if (!('approvalState' in value) || value['approvalState'] === undefined)
+        return false;
     if (!('createdAt' in value) || value['createdAt'] === undefined)
         return false;
     if (!('updatedAt' in value) || value['updatedAt'] === undefined)
@@ -65,6 +68,7 @@ export function ChunkContentItemFromJSONTyped(json, ignoreDiscriminator) {
         'chunkMetadata': json['chunk_metadata'] == null ? undefined : ChunkMetadataFromJSON(json['chunk_metadata']),
         'materializedPath': json['materialized_path'],
         'systemManaged': json['system_managed'],
+        'approvalState': PathPartApprovalStateFromJSON(json['approval_state']),
         'createdAt': (new Date(json['created_at'])),
         'updatedAt': (new Date(json['updated_at'])),
     };
@@ -88,6 +92,7 @@ export function ChunkContentItemToJSONTyped(value, ignoreDiscriminator = false)
         'chunk_metadata': ChunkMetadataToJSON(value['chunkMetadata']),
         'materialized_path': value['materializedPath'],
         'system_managed': value['systemManaged'],
+        'approval_state': PathPartApprovalStateToJSON(value['approvalState']),
         'created_at': value['createdAt'].toISOString(),
         'updated_at': value['updatedAt'].toISOString(),
     };

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

@@ -0,0 +1,86 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * 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 { DocumentType } from './DocumentType';
+/**
+ * One cited chunk with the source document context for FE rendering.
+ *
+ * ``chunk_id`` is the load-bearing field — every reader can use it via
+ * ``/v1/chunks/bulk``. The document fields are populated by
+ * ``save_document`` when it resolves each chunk through the KS API at
+ * save time; they stay ``None`` only when the chunk could not be resolved
+ * (e.g. the agent cited an id that no longer exists, or the resolve call
+ * failed). The doc-info snapshot is captured at save time; later renames
+ * or replacements of the source document do not update it.
+ * @export
+ * @interface CitedChunk
+ */
+export interface CitedChunk {
+    /**
+     *
+     * @type {string}
+     * @memberof CitedChunk
+     */
+    chunkId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof CitedChunk
+     */
+    documentId?: string | null;
+    /**
+     * Source document name as of save time. May be stale if the document was later renamed or replaced.
+     * @type {string}
+     * @memberof CitedChunk
+     */
+    documentName?: string | null;
+    /**
+     *
+     * @type {DocumentType}
+     * @memberof CitedChunk
+     */
+    documentType?: DocumentType;
+    /**
+     *
+     * @type {string}
+     * @memberof CitedChunk
+     */
+    documentVersionId?: string | null;
+    /**
+     *
+     * @type {number}
+     * @memberof CitedChunk
+     */
+    versionNumber?: number | null;
+}
+export declare const CitedChunkPropertyValidationAttributesMap: {
+    [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 CitedChunk interface.
+ */
+export declare function instanceOfCitedChunk(value: object): value is CitedChunk;
+export declare function CitedChunkFromJSON(json: any): CitedChunk;
+export declare function CitedChunkFromJSONTyped(json: any, ignoreDiscriminator: boolean): CitedChunk;
+export declare function CitedChunkToJSON(json: any): CitedChunk;
+export declare function CitedChunkToJSONTyped(value?: CitedChunk | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/CitedChunk.js

@@ -0,0 +1,55 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * 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 { DocumentTypeFromJSON, DocumentTypeToJSON, } from './DocumentType';
+export const CitedChunkPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the CitedChunk interface.
+ */
+export function instanceOfCitedChunk(value) {
+    if (!('chunkId' in value) || value['chunkId'] === undefined)
+        return false;
+    return true;
+}
+export function CitedChunkFromJSON(json) {
+    return CitedChunkFromJSONTyped(json, false);
+}
+export function CitedChunkFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'chunkId': json['chunk_id'],
+        'documentId': json['document_id'] == null ? undefined : json['document_id'],
+        'documentName': json['document_name'] == null ? undefined : json['document_name'],
+        'documentType': json['document_type'] == null ? undefined : DocumentTypeFromJSON(json['document_type']),
+        'documentVersionId': json['document_version_id'] == null ? undefined : json['document_version_id'],
+        'versionNumber': json['version_number'] == null ? undefined : json['version_number'],
+    };
+}
+export function CitedChunkToJSON(json) {
+    return CitedChunkToJSONTyped(json, false);
+}
+export function CitedChunkToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'chunk_id': value['chunkId'],
+        'document_id': value['documentId'],
+        'document_name': value['documentName'],
+        'document_type': DocumentTypeToJSON(value['documentType']),
+        'document_version_id': value['documentVersionId'],
+        'version_number': value['versionNumber'],
+    };
+}

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

@@ -0,0 +1,54 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * 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.
+ */
+/**
+ * POST body for ``/v1/workflow-runs/{id}/clone``.
+ *
+ * Creates a new NOT_STARTED run under the same definition. When
+ * ``include_inputs`` is True, the new run's ``input_path_part_ids``
+ * are pinned from the source's ``run_snapshot.inputs`` — uploaded DVs
+ * stay in the source's ``inputs/`` and are referenced by path_part_id
+ * (no S3 copy, no re-ingest). The source must have a snapshot to
+ * clone from, so cloning a NOT_STARTED source returns 409.
+ * @export
+ * @interface CloneWorkflowRunRequest
+ */
+export interface CloneWorkflowRunRequest {
+    /**
+     * When True, the new run's input_path_part_ids are pinned from the source run's snapshotted inputs (DOCUMENT_VERSION + FOLDER path_parts). When False, the new run is created with an empty input scope.
+     * @type {boolean}
+     * @memberof CloneWorkflowRunRequest
+     */
+    includeInputs: boolean;
+}
+export declare const CloneWorkflowRunRequestPropertyValidationAttributesMap: {
+    [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 CloneWorkflowRunRequest interface.
+ */
+export declare function instanceOfCloneWorkflowRunRequest(value: object): value is CloneWorkflowRunRequest;
+export declare function CloneWorkflowRunRequestFromJSON(json: any): CloneWorkflowRunRequest;
+export declare function CloneWorkflowRunRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): CloneWorkflowRunRequest;
+export declare function CloneWorkflowRunRequestToJSON(json: any): CloneWorkflowRunRequest;
+export declare function CloneWorkflowRunRequestToJSONTyped(value?: CloneWorkflowRunRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/CloneWorkflowRunRequest.js

@@ -0,0 +1,44 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * 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 CloneWorkflowRunRequestPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the CloneWorkflowRunRequest interface.
+ */
+export function instanceOfCloneWorkflowRunRequest(value) {
+    if (!('includeInputs' in value) || value['includeInputs'] === undefined)
+        return false;
+    return true;
+}
+export function CloneWorkflowRunRequestFromJSON(json) {
+    return CloneWorkflowRunRequestFromJSONTyped(json, false);
+}
+export function CloneWorkflowRunRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'includeInputs': json['include_inputs'],
+    };
+}
+export function CloneWorkflowRunRequestToJSON(json) {
+    return CloneWorkflowRunRequestToJSONTyped(json, false);
+}
+export function CloneWorkflowRunRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'include_inputs': value['includeInputs'],
+    };
+}

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

@@ -13,7 +13,7 @@ import type { MessageRole } from './MessageRole';
 import type { ThreadMessageDetailsInput } from './ThreadMessageDetailsInput';
 import type { ThreadMessageContent } from './ThreadMessageContent';
 /**
- * Request to create a new thread message.
+ *
  * @export
  * @interface CreateThreadMessageRequest
  */

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

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 /**
- * Request to create a new thread.
+ *
  * @export
  * @interface CreateThreadRequest
  */
@@ -33,6 +33,18 @@ export interface CreateThreadRequest {
      * @memberof CreateThreadRequest
      */
     messageForTitle?: string | null;
+    /**
+     * Override the thread path_part name. Defaults to the thread UUID. Used by the workflow runner to enforce one ``main`` thread per run via the structural sibling-name uniqueness index.
+     * @type {string}
+     * @memberof CreateThreadRequest
+     */
+    pathPartName?: string | null;
+    /**
+     * Mark the thread's path_part as system-managed (immutable from the public API). Used by the workflow runner.
+     * @type {boolean}
+     * @memberof CreateThreadRequest
+     */
+    systemManaged?: boolean;
 }
 export declare const CreateThreadRequestPropertyValidationAttributesMap: {
     [property: string]: {