@knowledge-stack/ksapi 1.88.1 → 1.89.0

package/src/models/SectionContentItem.ts

@@ -13,6 +13,14 @@
  */
 
 import { mapValues } from '../runtime';
+import type { PathPartApprovalState } from './PathPartApprovalState';
+import {
+    PathPartApprovalStateFromJSON,
+    PathPartApprovalStateFromJSONTyped,
+    PathPartApprovalStateToJSON,
+    PathPartApprovalStateToJSONTyped,
+} from './PathPartApprovalState';
+
 /**
  * Response model for a section item in document version contents.
  * @export
@@ -73,6 +81,12 @@ export interface SectionContentItem {
      * @memberof SectionContentItem
      */
     systemManaged: boolean;
+    /**
+     * 
+     * @type {PathPartApprovalState}
+     * @memberof SectionContentItem
+     */
+    approvalState: PathPartApprovalState;
     /**
      * Creation timestamp
      * @type {Date}
@@ -126,6 +140,7 @@ export function instanceOfSectionContentItem(value: object): value is SectionCon
     if (!('depth' in value) || value['depth'] === undefined) return false;
     if (!('materializedPath' in value) || value['materializedPath'] === undefined) 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) return false;
     return true;
@@ -150,6 +165,7 @@ export function SectionContentItemFromJSONTyped(json: any, ignoreDiscriminator:
         'pageNumber': json['page_number'] == null ? undefined : json['page_number'],
         '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'])),
     };
@@ -175,6 +191,7 @@ export function SectionContentItemToJSONTyped(value?: SectionContentItem | null,
         'page_number': value['pageNumber'],
         'materialized_path': value['materializedPath'],
         'system_managed': value['systemManaged'],
+        'approval_state': PathPartApprovalStateToJSON(value['approvalState']),
         'created_at': value['createdAt'].toISOString(),
         'updated_at': value['updatedAt'].toISOString(),
     };

package/src/models/SetApprovalStateRequest.ts

@@ -0,0 +1,113 @@
+/* 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 { mapValues } from '../runtime';
+/**
+ * Body for ``POST /v1/path-parts/{path_part_id}/approval``.
+ * 
+ * Single endpoint covers every transition in the state machine:
+ * 
+ * * ``{state: "pending"}`` — request approval (from ``not_required``) OR
+ *   unapprove (from ``approved``). Server dispatches on current state.
+ * * ``{state: "approved", reason?}`` — approve. For folders, fails 409
+ *   if any descendant is still ``pending``. ``reason`` is an optional
+ *   reviewer note persisted on the audit row.
+ * @export
+ * @interface SetApprovalStateRequest
+ */
+export interface SetApprovalStateRequest {
+    /**
+     * Target approval state. ``pending`` means 'request approval' (from not_required) or 'unapprove' (from approved) — server dispatches on current state.
+     * @type {SetApprovalStateRequestStateEnum}
+     * @memberof SetApprovalStateRequest
+     */
+    state: SetApprovalStateRequestStateEnum;
+    /**
+     * Optional reviewer note attached to the decision.
+     * @type {string}
+     * @memberof SetApprovalStateRequest
+     */
+    reason?: string | null;
+}
+
+
+/**
+ * @export
+ */
+export const SetApprovalStateRequestStateEnum = {
+    Pending: 'pending',
+    Approved: 'approved'
+} as const;
+export type SetApprovalStateRequestStateEnum = typeof SetApprovalStateRequestStateEnum[keyof typeof SetApprovalStateRequestStateEnum];
+
+export const SetApprovalStateRequestPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number,
+        minLength?: number,
+        pattern?: string,
+        maximum?: number,
+        exclusiveMaximum?: boolean,
+        minimum?: number,
+        exclusiveMinimum?: boolean,
+        multipleOf?: number,
+        maxItems?: number,
+        minItems?: number,
+        uniqueItems?: boolean
+    }
+} = {
+    reason: {
+        maxLength: 2048,
+    },
+}
+
+
+/**
+ * Check if a given object implements the SetApprovalStateRequest interface.
+ */
+export function instanceOfSetApprovalStateRequest(value: object): value is SetApprovalStateRequest {
+    if (!('state' in value) || value['state'] === undefined) return false;
+    return true;
+}
+
+export function SetApprovalStateRequestFromJSON(json: any): SetApprovalStateRequest {
+    return SetApprovalStateRequestFromJSONTyped(json, false);
+}
+
+export function SetApprovalStateRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): SetApprovalStateRequest {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'state': json['state'],
+        'reason': json['reason'] == null ? undefined : json['reason'],
+    };
+}
+
+export function SetApprovalStateRequestToJSON(json: any): SetApprovalStateRequest {
+    return SetApprovalStateRequestToJSONTyped(json, false);
+}
+
+export function SetApprovalStateRequestToJSONTyped(value?: SetApprovalStateRequest | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'state': value['state'],
+        'reason': value['reason'],
+    };
+}
+

package/src/models/SetWorkflowRunApprovalRequest.ts

@@ -0,0 +1,108 @@
+/* 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 { mapValues } from '../runtime';
+/**
+ * Body for ``POST /v1/workflow-runs/{run_id}/approval``.
+ * 
+ * Approves an entire completed run in one call — every output document
+ * under ``outputs/`` plus the run folder itself. ``reason`` is an
+ * optional reviewer note persisted on each approval audit row.
+ * @export
+ * @interface SetWorkflowRunApprovalRequest
+ */
+export interface SetWorkflowRunApprovalRequest {
+    /**
+     * 
+     * @type {SetWorkflowRunApprovalRequestStateEnum}
+     * @memberof SetWorkflowRunApprovalRequest
+     */
+    state: SetWorkflowRunApprovalRequestStateEnum;
+    /**
+     * Optional reviewer note attached to the decision.
+     * @type {string}
+     * @memberof SetWorkflowRunApprovalRequest
+     */
+    reason?: string | null;
+}
+
+
+/**
+ * @export
+ */
+export const SetWorkflowRunApprovalRequestStateEnum = {
+    Approved: 'approved'
+} as const;
+export type SetWorkflowRunApprovalRequestStateEnum = typeof SetWorkflowRunApprovalRequestStateEnum[keyof typeof SetWorkflowRunApprovalRequestStateEnum];
+
+export const SetWorkflowRunApprovalRequestPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number,
+        minLength?: number,
+        pattern?: string,
+        maximum?: number,
+        exclusiveMaximum?: boolean,
+        minimum?: number,
+        exclusiveMinimum?: boolean,
+        multipleOf?: number,
+        maxItems?: number,
+        minItems?: number,
+        uniqueItems?: boolean
+    }
+} = {
+    reason: {
+        maxLength: 2048,
+    },
+}
+
+
+/**
+ * Check if a given object implements the SetWorkflowRunApprovalRequest interface.
+ */
+export function instanceOfSetWorkflowRunApprovalRequest(value: object): value is SetWorkflowRunApprovalRequest {
+    if (!('state' in value) || value['state'] === undefined) return false;
+    return true;
+}
+
+export function SetWorkflowRunApprovalRequestFromJSON(json: any): SetWorkflowRunApprovalRequest {
+    return SetWorkflowRunApprovalRequestFromJSONTyped(json, false);
+}
+
+export function SetWorkflowRunApprovalRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): SetWorkflowRunApprovalRequest {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'state': json['state'],
+        'reason': json['reason'] == null ? undefined : json['reason'],
+    };
+}
+
+export function SetWorkflowRunApprovalRequestToJSON(json: any): SetWorkflowRunApprovalRequest {
+    return SetWorkflowRunApprovalRequestToJSONTyped(json, false);
+}
+
+export function SetWorkflowRunApprovalRequestToJSONTyped(value?: SetWorkflowRunApprovalRequest | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'state': value['state'],
+        'reason': value['reason'],
+    };
+}
+

package/src/models/ThreadMessageResponse.ts

@@ -36,7 +36,7 @@ import {
 } from './ThreadMessageDetailsOutput';
 
 /**
- * Thread message response model.
+ * 
  * @export
  * @interface ThreadMessageResponse
  */
@@ -95,6 +95,12 @@ export interface ThreadMessageResponse {
      * @memberof ThreadMessageResponse
      */
     tenantId: string;
+    /**
+     * tenant_user.user_id of the sender for USER messages. NULL for ASSISTANT / SYSTEM rows and for legacy USER rows written before multi-user thread support landed.
+     * @type {string}
+     * @memberof ThreadMessageResponse
+     */
+    authorTenantUserId?: string | null;
     /**
      * Creation timestamp
      * @type {Date}
@@ -164,6 +170,7 @@ export function ThreadMessageResponseFromJSONTyped(json: any, ignoreDiscriminato
         'parentPathId': json['parent_path_id'],
         'materializedPath': json['materialized_path'],
         'tenantId': json['tenant_id'],
+        'authorTenantUserId': json['author_tenant_user_id'] == null ? undefined : json['author_tenant_user_id'],
         'createdAt': (new Date(json['created_at'])),
         'updatedAt': (new Date(json['updated_at'])),
     };
@@ -189,6 +196,7 @@ export function ThreadMessageResponseToJSONTyped(value?: ThreadMessageResponse |
         'parent_path_id': value['parentPathId'],
         'materialized_path': value['materializedPath'],
         'tenant_id': value['tenantId'],
+        'author_tenant_user_id': value['authorTenantUserId'],
         'created_at': value['createdAt'].toISOString(),
         'updated_at': value['updatedAt'].toISOString(),
     };

package/src/models/ThreadResponse.ts

@@ -14,7 +14,7 @@
 
 import { mapValues } from '../runtime';
 /**
- * Thread response model.
+ * 
  * @export
  * @interface ThreadResponse
  */

package/src/models/UpdateThreadRequest.ts

@@ -14,7 +14,7 @@
 
 import { mapValues } from '../runtime';
 /**
- * Request to update a thread.
+ * 
  * @export
  * @interface UpdateThreadRequest
  */

package/src/models/UpdateWorkflowDefinitionRequest.ts

@@ -13,28 +13,8 @@
  */
 
 import { mapValues } from '../runtime';
-import type { SelfHostedRunnerConfig } from './SelfHostedRunnerConfig';
-import {
-    SelfHostedRunnerConfigFromJSON,
-    SelfHostedRunnerConfigFromJSONTyped,
-    SelfHostedRunnerConfigToJSON,
-    SelfHostedRunnerConfigToJSONTyped,
-} from './SelfHostedRunnerConfig';
-import type { WorkflowRunnerType } from './WorkflowRunnerType';
-import {
-    WorkflowRunnerTypeFromJSON,
-    WorkflowRunnerTypeFromJSONTyped,
-    WorkflowRunnerTypeToJSON,
-    WorkflowRunnerTypeToJSONTyped,
-} from './WorkflowRunnerType';
-
 /**
  * Full replacement (PUT semantics).
- * 
- * ``instruction_path_part_ids``:
- * 
- * - ``KS_INTERNAL``: must remain ``len == 1`` (the auto-provisioned doc).
- * - ``SELF_HOSTED``: ``len ≥ 1``; callers may swap or add documents.
  * @export
  * @interface UpdateWorkflowDefinitionRequest
  */
@@ -51,18 +31,6 @@ export interface UpdateWorkflowDefinitionRequest {
      * @memberof UpdateWorkflowDefinitionRequest
      */
     description?: string | null;
-    /**
-     * 
-     * @type {WorkflowRunnerType}
-     * @memberof UpdateWorkflowDefinitionRequest
-     */
-    runnerType: WorkflowRunnerType;
-    /**
-     * 
-     * @type {SelfHostedRunnerConfig}
-     * @memberof UpdateWorkflowDefinitionRequest
-     */
-    runnerConfig?: SelfHostedRunnerConfig | null;
     /**
      * 
      * @type {number}
@@ -70,44 +38,24 @@ export interface UpdateWorkflowDefinitionRequest {
      */
     maxRunDurationSeconds?: number;
     /**
-     * 
-     * @type {Array<string>}
-     * @memberof UpdateWorkflowDefinitionRequest
-     */
-    sourcePathPartIds: Array<string>;
-    /**
-     * 
-     * @type {Array<string>}
-     * @memberof UpdateWorkflowDefinitionRequest
-     */
-    instructionPathPartIds: Array<string>;
-    /**
-     * 
-     * @type {Array<string>}
-     * @memberof UpdateWorkflowDefinitionRequest
-     */
-    outputPathPartIds: Array<string>;
-    /**
-     * 
+     * DOCUMENT path_part of the instruction document. Pass null (or omit) to retain the existing pinned instruction; pass a UUID to replace it. Never nulled out — the column is NOT NULL.
      * @type {string}
      * @memberof UpdateWorkflowDefinitionRequest
      */
-    templatePathPartId?: string | null;
+    instructionPathPartId?: string | null;
     /**
      * 
      * @type {boolean}
      * @memberof UpdateWorkflowDefinitionRequest
      */
-    isActive?: boolean;
+    isActive: boolean;
     /**
      * 
      * @type {boolean}
      * @memberof UpdateWorkflowDefinitionRequest
      */
-    approvalRequired?: boolean;
+    approvalRequired: boolean;
 }
-
-
 export const UpdateWorkflowDefinitionRequestPropertyValidationAttributesMap: {
     [property: string]: {
         maxLength?: number,
@@ -127,26 +75,11 @@ export const UpdateWorkflowDefinitionRequestPropertyValidationAttributesMap: {
         maxLength: 255,
     },
     maxRunDurationSeconds: {
-        maximum: 86400,
+        maximum: 7200,
         exclusiveMaximum: false,
         minimum: 60,
         exclusiveMinimum: false,
     },
-    sourcePathPartIds: {
-        maxItems: 20,
-        minItems: 1,
-        uniqueItems: false,
-    },
-    instructionPathPartIds: {
-        maxItems: 20,
-        minItems: 1,
-        uniqueItems: false,
-    },
-    outputPathPartIds: {
-        maxItems: 20,
-        minItems: 1,
-        uniqueItems: false,
-    },
 }
 
 
@@ -155,10 +88,8 @@ export const UpdateWorkflowDefinitionRequestPropertyValidationAttributesMap: {
  */
 export function instanceOfUpdateWorkflowDefinitionRequest(value: object): value is UpdateWorkflowDefinitionRequest {
     if (!('name' in value) || value['name'] === undefined) return false;
-    if (!('runnerType' in value) || value['runnerType'] === undefined) return false;
-    if (!('sourcePathPartIds' in value) || value['sourcePathPartIds'] === undefined) return false;
-    if (!('instructionPathPartIds' in value) || value['instructionPathPartIds'] === undefined) return false;
-    if (!('outputPathPartIds' in value) || value['outputPathPartIds'] === undefined) return false;
+    if (!('isActive' in value) || value['isActive'] === undefined) return false;
+    if (!('approvalRequired' in value) || value['approvalRequired'] === undefined) return false;
     return true;
 }
 
@@ -174,15 +105,10 @@ export function UpdateWorkflowDefinitionRequestFromJSONTyped(json: any, ignoreDi
         
         'name': json['name'],
         'description': json['description'] == null ? undefined : json['description'],
-        'runnerType': WorkflowRunnerTypeFromJSON(json['runner_type']),
-        'runnerConfig': json['runner_config'] == null ? undefined : SelfHostedRunnerConfigFromJSON(json['runner_config']),
         'maxRunDurationSeconds': json['max_run_duration_seconds'] == null ? undefined : json['max_run_duration_seconds'],
-        'sourcePathPartIds': json['source_path_part_ids'],
-        'instructionPathPartIds': json['instruction_path_part_ids'],
-        'outputPathPartIds': json['output_path_part_ids'],
-        'templatePathPartId': json['template_path_part_id'] == null ? undefined : json['template_path_part_id'],
-        'isActive': json['is_active'] == null ? undefined : json['is_active'],
-        'approvalRequired': json['approval_required'] == null ? undefined : json['approval_required'],
+        'instructionPathPartId': json['instruction_path_part_id'] == null ? undefined : json['instruction_path_part_id'],
+        'isActive': json['is_active'],
+        'approvalRequired': json['approval_required'],
     };
 }
 
@@ -199,13 +125,8 @@ export function UpdateWorkflowDefinitionRequestToJSONTyped(value?: UpdateWorkflo
         
         'name': value['name'],
         'description': value['description'],
-        'runner_type': WorkflowRunnerTypeToJSON(value['runnerType']),
-        'runner_config': SelfHostedRunnerConfigToJSON(value['runnerConfig']),
         'max_run_duration_seconds': value['maxRunDurationSeconds'],
-        'source_path_part_ids': value['sourcePathPartIds'],
-        'instruction_path_part_ids': value['instructionPathPartIds'],
-        'output_path_part_ids': value['outputPathPartIds'],
-        'template_path_part_id': value['templatePathPartId'],
+        'instruction_path_part_id': value['instructionPathPartId'],
         'is_active': value['isActive'],
         'approval_required': value['approvalRequired'],
     };

package/src/models/UpdateWorkflowRunRequest.ts

@@ -0,0 +1,103 @@
+/* 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 { mapValues } from '../runtime';
+/**
+ * PATCH body for ``/v1/workflow-runs/{id}`` — NOT_STARTED runs only.
+ * 
+ * Both fields are optional. A body with both ``None`` is rejected as 400
+ * (no-op PATCH). ``input_scope`` replaces the row's KB-ref list wholesale;
+ * ``name`` renames the run path_part (the trigger cascades
+ * ``materialized_path`` to every descendant).
+ * @export
+ * @interface UpdateWorkflowRunRequest
+ */
+export interface UpdateWorkflowRunRequest {
+    /**
+     * New KB-reference scope (DOCUMENT + FOLDER pp_ids). Replaces the row's ``input_path_part_ids`` wholesale. Uploaded files live in ``inputs/`` and are walked at Start; they are not part of this list.
+     * @type {Array<string>}
+     * @memberof UpdateWorkflowRunRequest
+     */
+    inputScope?: Array<string> | null;
+    /**
+     * New display name for the run (mirrors path_part.name).
+     * @type {string}
+     * @memberof UpdateWorkflowRunRequest
+     */
+    name?: string | null;
+}
+export const UpdateWorkflowRunRequestPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number,
+        minLength?: number,
+        pattern?: string,
+        maximum?: number,
+        exclusiveMaximum?: boolean,
+        minimum?: number,
+        exclusiveMinimum?: boolean,
+        multipleOf?: number,
+        maxItems?: number,
+        minItems?: number,
+        uniqueItems?: boolean
+    }
+} = {
+    inputScope: {
+        maxItems: 50,
+        uniqueItems: false,
+    },
+    name: {
+        maxLength: 255,
+        minLength: 1,
+    },
+}
+
+
+/**
+ * Check if a given object implements the UpdateWorkflowRunRequest interface.
+ */
+export function instanceOfUpdateWorkflowRunRequest(value: object): value is UpdateWorkflowRunRequest {
+    return true;
+}
+
+export function UpdateWorkflowRunRequestFromJSON(json: any): UpdateWorkflowRunRequest {
+    return UpdateWorkflowRunRequestFromJSONTyped(json, false);
+}
+
+export function UpdateWorkflowRunRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): UpdateWorkflowRunRequest {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'inputScope': json['input_scope'] == null ? undefined : json['input_scope'],
+        'name': json['name'] == null ? undefined : json['name'],
+    };
+}
+
+export function UpdateWorkflowRunRequestToJSON(json: any): UpdateWorkflowRunRequest {
+    return UpdateWorkflowRunRequestToJSONTyped(json, false);
+}
+
+export function UpdateWorkflowRunRequestToJSONTyped(value?: UpdateWorkflowRunRequest | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'input_scope': value['inputScope'],
+        'name': value['name'],
+    };
+}
+