@knowledge-stack/ksapi 1.81.0 → 1.83.0

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

@@ -0,0 +1,111 @@
+/**
+ * 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 { PathPartApprovalDecision } from './PathPartApprovalDecision';
+/**
+ * Approval audit-history row over any path_part (file or folder).
+ *
+ * ``run_id`` is optional — None when the path_part was approved directly
+ * without a workflow-run context.
+ * @export
+ * @interface PathPartApprovalResponse
+ */
+export interface PathPartApprovalResponse {
+    /**
+     *
+     * @type {string}
+     * @memberof PathPartApprovalResponse
+     */
+    id: string;
+    /**
+     *
+     * @type {string}
+     * @memberof PathPartApprovalResponse
+     */
+    runId: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof PathPartApprovalResponse
+     */
+    pathPartId: string;
+    /**
+     *
+     * @type {PathPartApprovalDecision}
+     * @memberof PathPartApprovalResponse
+     */
+    status: PathPartApprovalDecision;
+    /**
+     *
+     * @type {string}
+     * @memberof PathPartApprovalResponse
+     */
+    reviewerId: string | null;
+    /**
+     *
+     * @type {Date}
+     * @memberof PathPartApprovalResponse
+     */
+    reviewedAt: Date | null;
+    /**
+     *
+     * @type {string}
+     * @memberof PathPartApprovalResponse
+     */
+    rejectionReason: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof PathPartApprovalResponse
+     */
+    unapprovedBy: string | null;
+    /**
+     *
+     * @type {Date}
+     * @memberof PathPartApprovalResponse
+     */
+    unapprovedAt: Date | null;
+    /**
+     *
+     * @type {Date}
+     * @memberof PathPartApprovalResponse
+     */
+    createdAt: Date;
+    /**
+     *
+     * @type {Date}
+     * @memberof PathPartApprovalResponse
+     */
+    updatedAt: Date;
+}
+export declare const PathPartApprovalResponsePropertyValidationAttributesMap: {
+    [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 PathPartApprovalResponse interface.
+ */
+export declare function instanceOfPathPartApprovalResponse(value: object): value is PathPartApprovalResponse;
+export declare function PathPartApprovalResponseFromJSON(json: any): PathPartApprovalResponse;
+export declare function PathPartApprovalResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): PathPartApprovalResponse;
+export declare function PathPartApprovalResponseToJSON(json: any): PathPartApprovalResponse;
+export declare function PathPartApprovalResponseToJSONTyped(value?: PathPartApprovalResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/PathPartApprovalResponse.js

@@ -0,0 +1,85 @@
+/* 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 { PathPartApprovalDecisionFromJSON, PathPartApprovalDecisionToJSON, } from './PathPartApprovalDecision';
+export const PathPartApprovalResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the PathPartApprovalResponse interface.
+ */
+export function instanceOfPathPartApprovalResponse(value) {
+    if (!('id' in value) || value['id'] === undefined)
+        return false;
+    if (!('runId' in value) || value['runId'] === undefined)
+        return false;
+    if (!('pathPartId' in value) || value['pathPartId'] === undefined)
+        return false;
+    if (!('status' in value) || value['status'] === undefined)
+        return false;
+    if (!('reviewerId' in value) || value['reviewerId'] === undefined)
+        return false;
+    if (!('reviewedAt' in value) || value['reviewedAt'] === undefined)
+        return false;
+    if (!('rejectionReason' in value) || value['rejectionReason'] === undefined)
+        return false;
+    if (!('unapprovedBy' in value) || value['unapprovedBy'] === undefined)
+        return false;
+    if (!('unapprovedAt' in value) || value['unapprovedAt'] === undefined)
+        return false;
+    if (!('createdAt' in value) || value['createdAt'] === undefined)
+        return false;
+    if (!('updatedAt' in value) || value['updatedAt'] === undefined)
+        return false;
+    return true;
+}
+export function PathPartApprovalResponseFromJSON(json) {
+    return PathPartApprovalResponseFromJSONTyped(json, false);
+}
+export function PathPartApprovalResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'id': json['id'],
+        'runId': json['run_id'],
+        'pathPartId': json['path_part_id'],
+        'status': PathPartApprovalDecisionFromJSON(json['status']),
+        'reviewerId': json['reviewer_id'],
+        'reviewedAt': (json['reviewed_at'] == null ? null : new Date(json['reviewed_at'])),
+        'rejectionReason': json['rejection_reason'],
+        'unapprovedBy': json['unapproved_by'],
+        'unapprovedAt': (json['unapproved_at'] == null ? null : new Date(json['unapproved_at'])),
+        'createdAt': (new Date(json['created_at'])),
+        'updatedAt': (new Date(json['updated_at'])),
+    };
+}
+export function PathPartApprovalResponseToJSON(json) {
+    return PathPartApprovalResponseToJSONTyped(json, false);
+}
+export function PathPartApprovalResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'id': value['id'],
+        'run_id': value['runId'],
+        'path_part_id': value['pathPartId'],
+        'status': PathPartApprovalDecisionToJSON(value['status']),
+        'reviewer_id': value['reviewerId'],
+        'reviewed_at': value['reviewedAt'] == null ? value['reviewedAt'] : value['reviewedAt'].toISOString(),
+        'rejection_reason': value['rejectionReason'],
+        'unapproved_by': value['unapprovedBy'],
+        'unapproved_at': value['unapprovedAt'] == null ? value['unapprovedAt'] : value['unapprovedAt'].toISOString(),
+        'created_at': value['createdAt'].toISOString(),
+        'updated_at': value['updatedAt'].toISOString(),
+    };
+}

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

@@ -0,0 +1,47 @@
+/**
+ * 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.
+ */
+/**
+ * Body for ``POST /workflow-runs/{run}/files/{file}/reject``.
+ * @export
+ * @interface RejectFileRequest
+ */
+export interface RejectFileRequest {
+    /**
+     *
+     * @type {string}
+     * @memberof RejectFileRequest
+     */
+    reason: string;
+}
+export declare const RejectFileRequestPropertyValidationAttributesMap: {
+    [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 RejectFileRequest interface.
+ */
+export declare function instanceOfRejectFileRequest(value: object): value is RejectFileRequest;
+export declare function RejectFileRequestFromJSON(json: any): RejectFileRequest;
+export declare function RejectFileRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): RejectFileRequest;
+export declare function RejectFileRequestToJSON(json: any): RejectFileRequest;
+export declare function RejectFileRequestToJSONTyped(value?: RejectFileRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/RejectFileRequest.js

@@ -0,0 +1,49 @@
+/* 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 RejectFileRequestPropertyValidationAttributesMap = {
+    reason: {
+        maxLength: 2048,
+        minLength: 1,
+    },
+};
+/**
+ * Check if a given object implements the RejectFileRequest interface.
+ */
+export function instanceOfRejectFileRequest(value) {
+    if (!('reason' in value) || value['reason'] === undefined)
+        return false;
+    return true;
+}
+export function RejectFileRequestFromJSON(json) {
+    return RejectFileRequestFromJSONTyped(json, false);
+}
+export function RejectFileRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'reason': json['reason'],
+    };
+}
+export function RejectFileRequestToJSON(json) {
+    return RejectFileRequestToJSONTyped(json, false);
+}
+export function RejectFileRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'reason': value['reason'],
+    };
+}

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

@@ -0,0 +1,59 @@
+/**
+ * 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.
+ */
+/**
+ * Reviewer-lock state on a workflow run.
+ * @export
+ * @interface RunLockResponse
+ */
+export interface RunLockResponse {
+    /**
+     *
+     * @type {string}
+     * @memberof RunLockResponse
+     */
+    runId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof RunLockResponse
+     */
+    lockUserId: string | null;
+    /**
+     *
+     * @type {Date}
+     * @memberof RunLockResponse
+     */
+    lockAcquiredAt: Date | null;
+}
+export declare const RunLockResponsePropertyValidationAttributesMap: {
+    [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 RunLockResponse interface.
+ */
+export declare function instanceOfRunLockResponse(value: object): value is RunLockResponse;
+export declare function RunLockResponseFromJSON(json: any): RunLockResponse;
+export declare function RunLockResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): RunLockResponse;
+export declare function RunLockResponseToJSON(json: any): RunLockResponse;
+export declare function RunLockResponseToJSONTyped(value?: RunLockResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/RunLockResponse.js

@@ -0,0 +1,52 @@
+/* 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 RunLockResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the RunLockResponse interface.
+ */
+export function instanceOfRunLockResponse(value) {
+    if (!('runId' in value) || value['runId'] === undefined)
+        return false;
+    if (!('lockUserId' in value) || value['lockUserId'] === undefined)
+        return false;
+    if (!('lockAcquiredAt' in value) || value['lockAcquiredAt'] === undefined)
+        return false;
+    return true;
+}
+export function RunLockResponseFromJSON(json) {
+    return RunLockResponseFromJSONTyped(json, false);
+}
+export function RunLockResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'runId': json['run_id'],
+        'lockUserId': json['lock_user_id'],
+        'lockAcquiredAt': (json['lock_acquired_at'] == null ? null : new Date(json['lock_acquired_at'])),
+    };
+}
+export function RunLockResponseToJSON(json) {
+    return RunLockResponseToJSONTyped(json, false);
+}
+export function RunLockResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'run_id': value['runId'],
+        'lock_user_id': value['lockUserId'],
+        'lock_acquired_at': value['lockAcquiredAt'] == null ? value['lockAcquiredAt'] : value['lockAcquiredAt'].toISOString(),
+    };
+}

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

@@ -12,7 +12,12 @@
 import type { SelfHostedRunnerConfig } from './SelfHostedRunnerConfig';
 import type { WorkflowRunnerType } from './WorkflowRunnerType';
 /**
- * Full replacement (PUT semantics). All fields are required.
+ * 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
  */
@@ -77,6 +82,12 @@ export interface UpdateWorkflowDefinitionRequest {
      * @memberof UpdateWorkflowDefinitionRequest
      */
     isActive?: boolean;
+    /**
+     *
+     * @type {boolean}
+     * @memberof UpdateWorkflowDefinitionRequest
+     */
+    approvalRequired?: boolean;
 }
 export declare const UpdateWorkflowDefinitionRequestPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/esm/models/UpdateWorkflowDefinitionRequest.js

@@ -73,6 +73,7 @@ export function UpdateWorkflowDefinitionRequestFromJSONTyped(json, ignoreDiscrim
         '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'],
     };
 }
 export function UpdateWorkflowDefinitionRequestToJSON(json) {
@@ -93,5 +94,6 @@ export function UpdateWorkflowDefinitionRequestToJSONTyped(value, ignoreDiscrimi
         'output_path_part_ids': value['outputPathPartIds'],
         'template_path_part_id': value['templatePathPartId'],
         'is_active': value['isActive'],
+        'approval_required': value['approvalRequired'],
     };
 }

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

@@ -83,6 +83,12 @@ export interface WorkflowDefinitionResponse {
      * @memberof WorkflowDefinitionResponse
      */
     isActive: boolean;
+    /**
+     *
+     * @type {boolean}
+     * @memberof WorkflowDefinitionResponse
+     */
+    approvalRequired: boolean;
     /**
      *
      * @type {Date}

package/dist/esm/models/WorkflowDefinitionResponse.js

@@ -40,6 +40,8 @@ export function instanceOfWorkflowDefinitionResponse(value) {
         return false;
     if (!('isActive' in value) || value['isActive'] === undefined)
         return false;
+    if (!('approvalRequired' in value) || value['approvalRequired'] === undefined)
+        return false;
     if (!('createdAt' in value) || value['createdAt'] === undefined)
         return false;
     if (!('updatedAt' in value) || value['updatedAt'] === undefined)
@@ -65,6 +67,7 @@ export function WorkflowDefinitionResponseFromJSONTyped(json, ignoreDiscriminato
         'outputPathPartIds': json['output_path_part_ids'],
         'templatePathPartId': json['template_path_part_id'],
         'isActive': json['is_active'],
+        'approvalRequired': json['approval_required'],
         'createdAt': (new Date(json['created_at'])),
         'updatedAt': (new Date(json['updated_at'])),
     };
@@ -88,6 +91,7 @@ export function WorkflowDefinitionResponseToJSONTyped(value, ignoreDiscriminator
         'output_path_part_ids': value['outputPathPartIds'],
         'template_path_part_id': value['templatePathPartId'],
         'is_active': value['isActive'],
+        'approval_required': value['approvalRequired'],
         'created_at': value['createdAt'].toISOString(),
         'updated_at': value['updatedAt'].toISOString(),
     };

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

@@ -14,6 +14,11 @@ import type { WorkflowRunStatus } from './WorkflowRunStatus';
 import type { WorkflowRunnerType } from './WorkflowRunnerType';
 /**
  * Workflow run response.
+ *
+ * Note: ``run_token_jti`` is intentionally NOT exposed. It's an
+ * internal token identifier persisted on the run row for callback
+ * auth — clients should treat run dispatch state as observable via
+ * ``status`` (RUNNING => dispatched), not via JTI presence.
  * @export
  * @interface WorkflowRunResponse
  */
@@ -72,6 +77,18 @@ export interface WorkflowRunResponse {
      * @memberof WorkflowRunResponse
      */
     error: string | null;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof WorkflowRunResponse
+     */
+    inputPathPartIds: Array<string>;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof WorkflowRunResponse
+     */
+    inputVersionIds: Array<string>;
     /**
      *
      * @type {Date}

package/dist/esm/models/WorkflowRunResponse.js

@@ -37,6 +37,10 @@ export function instanceOfWorkflowRunResponse(value) {
         return false;
     if (!('error' in value) || value['error'] === undefined)
         return false;
+    if (!('inputPathPartIds' in value) || value['inputPathPartIds'] === undefined)
+        return false;
+    if (!('inputVersionIds' in value) || value['inputVersionIds'] === undefined)
+        return false;
     if (!('createdAt' in value) || value['createdAt'] === undefined)
         return false;
     if (!('updatedAt' in value) || value['updatedAt'] === undefined)
@@ -60,6 +64,8 @@ export function WorkflowRunResponseFromJSONTyped(json, ignoreDiscriminator) {
         'completedAt': (json['completed_at'] == null ? null : new Date(json['completed_at'])),
         'runSnapshot': WorkflowRunSnapshotFromJSON(json['run_snapshot']),
         'error': json['error'],
+        'inputPathPartIds': json['input_path_part_ids'],
+        'inputVersionIds': json['input_version_ids'],
         'createdAt': (new Date(json['created_at'])),
         'updatedAt': (new Date(json['updated_at'])),
     };
@@ -81,6 +87,8 @@ export function WorkflowRunResponseToJSONTyped(value, ignoreDiscriminator = fals
         'completed_at': value['completedAt'] == null ? value['completedAt'] : value['completedAt'].toISOString(),
         'run_snapshot': WorkflowRunSnapshotToJSON(value['runSnapshot']),
         'error': value['error'],
+        'input_path_part_ids': value['inputPathPartIds'],
+        'input_version_ids': value['inputVersionIds'],
         'created_at': value['createdAt'].toISOString(),
         'updated_at': value['updatedAt'].toISOString(),
     };

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

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import type { ABCDPathSnapshot } from './ABCDPathSnapshot';
+import type { InstructionSnapshot } from './InstructionSnapshot';
 import type { WorkflowRunnerType } from './WorkflowRunnerType';
 /**
  * Frozen ABCD configuration captured at workflow trigger time.
@@ -55,10 +56,10 @@ export interface WorkflowRunSnapshot {
     sources: Array<ABCDPathSnapshot>;
     /**
      *
-     * @type {Array<ABCDPathSnapshot>}
+     * @type {Array<InstructionSnapshot>}
      * @memberof WorkflowRunSnapshot
      */
-    instructions: Array<ABCDPathSnapshot>;
+    instructions: Array<InstructionSnapshot>;
     /**
      *
      * @type {Array<ABCDPathSnapshot>}

package/dist/esm/models/WorkflowRunSnapshot.js

@@ -12,6 +12,7 @@
  * Do not edit the class manually.
  */
 import { ABCDPathSnapshotFromJSON, ABCDPathSnapshotToJSON, } from './ABCDPathSnapshot';
+import { InstructionSnapshotFromJSON, InstructionSnapshotToJSON, } from './InstructionSnapshot';
 import { WorkflowRunnerTypeFromJSON, WorkflowRunnerTypeToJSON, } from './WorkflowRunnerType';
 export const WorkflowRunSnapshotPropertyValidationAttributesMap = {};
 /**
@@ -52,7 +53,7 @@ export function WorkflowRunSnapshotFromJSONTyped(json, ignoreDiscriminator) {
         'userId': json['user_id'],
         'maxRunDurationSeconds': json['max_run_duration_seconds'],
         'sources': (json['sources'].map(ABCDPathSnapshotFromJSON)),
-        'instructions': (json['instructions'].map(ABCDPathSnapshotFromJSON)),
+        'instructions': (json['instructions'].map(InstructionSnapshotFromJSON)),
         'outputs': (json['outputs'].map(ABCDPathSnapshotFromJSON)),
         'template': ABCDPathSnapshotFromJSON(json['template']),
     };
@@ -71,7 +72,7 @@ export function WorkflowRunSnapshotToJSONTyped(value, ignoreDiscriminator = fals
         'user_id': value['userId'],
         'max_run_duration_seconds': value['maxRunDurationSeconds'],
         'sources': (value['sources'].map(ABCDPathSnapshotToJSON)),
-        'instructions': (value['instructions'].map(ABCDPathSnapshotToJSON)),
+        'instructions': (value['instructions'].map(InstructionSnapshotToJSON)),
         'outputs': (value['outputs'].map(ABCDPathSnapshotToJSON)),
         'template': ABCDPathSnapshotToJSON(value['template']),
     };

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

@@ -10,13 +10,31 @@
  * Do not edit the class manually.
  */
 /**
- * Lifecycle status of a workflow run.
+ * Combined lifecycle + approval-rollup status of a workflow run.
+ *
+ * Absorbs the prior split between ``status`` (PENDING/RUNNING/COMPLETED/
+ * FAILED) and ``approval_state`` (in_progress/awaiting_review/approved/
+ * rejected/failed). One state field per run.
+ *
+ * Allowed transitions::
+ *
+ *     PENDING        -> IN_PROGRESS              (agent dispatched)
+ *     IN_PROGRESS    -> COMPLETED                (workflow.approval_required=FALSE)
+ *     IN_PROGRESS    -> NEEDS_APPROVAL           (workflow.approval_required=TRUE, agent done)
+ *     NEEDS_APPROVAL -> APPROVED                 (run folder approved by reviewer)
+ *     NEEDS_APPROVAL -> REJECTED                 (run folder or any child rejected)
+ *     APPROVED       -> NEEDS_APPROVAL           (run folder unapproved)
+ *     REJECTED       -> NEEDS_APPROVAL           (rejection reversed; mutable)
+ *     any non-terminal -> FAILED                 (agent error)
  * @export
  */
 export declare const WorkflowRunStatus: {
     readonly Pending: "PENDING";
-    readonly Running: "RUNNING";
+    readonly InProgress: "IN_PROGRESS";
     readonly Completed: "COMPLETED";
+    readonly NeedsApproval: "NEEDS_APPROVAL";
+    readonly Approved: "APPROVED";
+    readonly Rejected: "REJECTED";
     readonly Failed: "FAILED";
 };
 export type WorkflowRunStatus = typeof WorkflowRunStatus[keyof typeof WorkflowRunStatus];

package/dist/esm/models/WorkflowRunStatus.js

@@ -12,13 +12,31 @@
  * Do not edit the class manually.
  */
 /**
- * Lifecycle status of a workflow run.
+ * Combined lifecycle + approval-rollup status of a workflow run.
+ *
+ * Absorbs the prior split between ``status`` (PENDING/RUNNING/COMPLETED/
+ * FAILED) and ``approval_state`` (in_progress/awaiting_review/approved/
+ * rejected/failed). One state field per run.
+ *
+ * Allowed transitions::
+ *
+ *     PENDING        -> IN_PROGRESS              (agent dispatched)
+ *     IN_PROGRESS    -> COMPLETED                (workflow.approval_required=FALSE)
+ *     IN_PROGRESS    -> NEEDS_APPROVAL           (workflow.approval_required=TRUE, agent done)
+ *     NEEDS_APPROVAL -> APPROVED                 (run folder approved by reviewer)
+ *     NEEDS_APPROVAL -> REJECTED                 (run folder or any child rejected)
+ *     APPROVED       -> NEEDS_APPROVAL           (run folder unapproved)
+ *     REJECTED       -> NEEDS_APPROVAL           (rejection reversed; mutable)
+ *     any non-terminal -> FAILED                 (agent error)
  * @export
  */
 export const WorkflowRunStatus = {
     Pending: 'PENDING',
-    Running: 'RUNNING',
+    InProgress: 'IN_PROGRESS',
     Completed: 'COMPLETED',
+    NeedsApproval: 'NEEDS_APPROVAL',
+    Approved: 'APPROVED',
+    Rejected: 'REJECTED',
     Failed: 'FAILED'
 };
 export function instanceOfWorkflowRunStatus(value) {

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

@@ -15,6 +15,7 @@
  */
 export declare const WorkflowRunnerType: {
     readonly SelfHosted: "SELF_HOSTED";
+    readonly KsInternal: "KS_INTERNAL";
 };
 export type WorkflowRunnerType = typeof WorkflowRunnerType[keyof typeof WorkflowRunnerType];
 export declare function instanceOfWorkflowRunnerType(value: any): boolean;