@knowledge-stack/ksapi 3.18.2 → 3.19.0

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@3.18.2
+# @knowledge-stack/ksapi@3.19.0
 
 A TypeScript SDK client for the localhost API.
 
@@ -776,7 +776,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `3.18.2`
+- Package version: `3.19.0`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/SystemJobsApi.d.ts

@@ -83,7 +83,7 @@ export interface SystemJobsApiInterface {
      */
     cancelTemporalWorkflowRequestOpts(requestParameters: CancelTemporalWorkflowRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * @summary Cancel Temporal Workflow Handler
      * @param {string} workflowId
      * @param {*} [options] Override http request option.
@@ -92,7 +92,7 @@ export interface SystemJobsApiInterface {
      */
     cancelTemporalWorkflowRaw(requestParameters: CancelTemporalWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowCancelResponse>>;
     /**
-     * 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * Cancel Temporal Workflow Handler
      */
     cancelTemporalWorkflow(requestParameters: CancelTemporalWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowCancelResponse>;
@@ -270,12 +270,12 @@ export declare class SystemJobsApi extends runtime.BaseAPI implements SystemJobs
      */
     cancelTemporalWorkflowRequestOpts(requestParameters: CancelTemporalWorkflowRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * Cancel Temporal Workflow Handler
      */
     cancelTemporalWorkflowRaw(requestParameters: CancelTemporalWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowCancelResponse>>;
     /**
-     * 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * Cancel Temporal Workflow Handler
      */
     cancelTemporalWorkflow(requestParameters: CancelTemporalWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowCancelResponse>;

package/dist/apis/SystemJobsApi.js

@@ -139,7 +139,7 @@ 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. 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * Cancel Temporal Workflow Handler
      */
     cancelTemporalWorkflowRaw(requestParameters, initOverrides) {
@@ -150,7 +150,7 @@ 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. 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * Cancel Temporal Workflow Handler
      */
     cancelTemporalWorkflow(requestParameters, initOverrides) {

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

@@ -83,7 +83,7 @@ export interface SystemJobsApiInterface {
      */
     cancelTemporalWorkflowRequestOpts(requestParameters: CancelTemporalWorkflowRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * @summary Cancel Temporal Workflow Handler
      * @param {string} workflowId
      * @param {*} [options] Override http request option.
@@ -92,7 +92,7 @@ export interface SystemJobsApiInterface {
      */
     cancelTemporalWorkflowRaw(requestParameters: CancelTemporalWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowCancelResponse>>;
     /**
-     * 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * Cancel Temporal Workflow Handler
      */
     cancelTemporalWorkflow(requestParameters: CancelTemporalWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowCancelResponse>;
@@ -270,12 +270,12 @@ export declare class SystemJobsApi extends runtime.BaseAPI implements SystemJobs
      */
     cancelTemporalWorkflowRequestOpts(requestParameters: CancelTemporalWorkflowRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * Cancel Temporal Workflow Handler
      */
     cancelTemporalWorkflowRaw(requestParameters: CancelTemporalWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowCancelResponse>>;
     /**
-     * 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * Cancel Temporal Workflow Handler
      */
     cancelTemporalWorkflow(requestParameters: CancelTemporalWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowCancelResponse>;

package/dist/esm/apis/SystemJobsApi.js

@@ -103,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. 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * Cancel Temporal Workflow Handler
      */
     cancelTemporalWorkflowRaw(requestParameters, initOverrides) {
@@ -114,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. 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * Cancel Temporal Workflow Handler
      */
     cancelTemporalWorkflow(requestParameters, initOverrides) {

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

@@ -19,6 +19,12 @@ import type { ChunkType } from './ChunkType';
  * @interface PipelineState
  */
 export interface PipelineState {
+    /**
+     * Zero-based retry count for the current stage; maximum across fan-out activities. Managed by ingestion.
+     * @type {number}
+     * @memberof PipelineState
+     */
+    readonly lastStageRetryAttempt?: number;
     /**
      *
      * @type {PipelineStatus}
@@ -38,13 +44,13 @@ export interface PipelineState {
      */
     lastStateUpdateTimestamp?: Date | null;
     /**
-     * Name of the last activity that executed (e.g., 'pdf_preparation_activity')
+     * Current ingestion stage, recorded before its activity starts
      * @type {string}
      * @memberof PipelineState
      */
     lastActivity?: string | null;
     /**
-     * Error message if pipeline failed
+     * Latest stage failure; retained during retries and cleared on the next stage or success
      * @type {string}
      * @memberof PipelineState
      */
@@ -108,4 +114,4 @@ export declare function instanceOfPipelineState(value: object): value is Pipelin
 export declare function PipelineStateFromJSON(json: any): PipelineState;
 export declare function PipelineStateFromJSONTyped(json: any, ignoreDiscriminator: boolean): PipelineState;
 export declare function PipelineStateToJSON(json: any): PipelineState;
-export declare function PipelineStateToJSONTyped(value?: PipelineState | null, ignoreDiscriminator?: boolean): any;
+export declare function PipelineStateToJSONTyped(value?: Omit<PipelineState, 'last_stage_retry_attempt'> | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/PipelineState.js

@@ -15,7 +15,12 @@ import { PipelineStatusFromJSON, PipelineStatusToJSON, } from './PipelineStatus'
 import { ImageTaxonomyFromJSON, ImageTaxonomyToJSON, } from './ImageTaxonomy';
 import { IngestionModeFromJSON, IngestionModeToJSON, } from './IngestionMode';
 import { ChunkTypeFromJSON, ChunkTypeToJSON, } from './ChunkType';
-export const PipelineStatePropertyValidationAttributesMap = {};
+export const PipelineStatePropertyValidationAttributesMap = {
+    lastStageRetryAttempt: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+};
 /**
  * Check if a given object implements the PipelineState interface.
  */
@@ -32,6 +37,7 @@ export function PipelineStateFromJSONTyped(json, ignoreDiscriminator) {
         return json;
     }
     return {
+        'lastStageRetryAttempt': json['last_stage_retry_attempt'] == null ? undefined : json['last_stage_retry_attempt'],
         'status': PipelineStatusFromJSON(json['status']),
         'lastRunTimestamp': json['last_run_timestamp'] == null ? undefined : (new Date(json['last_run_timestamp'])),
         'lastStateUpdateTimestamp': json['last_state_update_timestamp'] == null ? undefined : (new Date(json['last_state_update_timestamp'])),

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

@@ -71,6 +71,12 @@ export interface WorkflowDetailResponse {
      * @memberof WorkflowDetailResponse
      */
     lastActivity?: string | null;
+    /**
+     *
+     * @type {number}
+     * @memberof WorkflowDetailResponse
+     */
+    lastStageRetryAttempt?: number;
     /**
      *
      * @type {string}

package/dist/esm/models/WorkflowDetailResponse.js

@@ -13,7 +13,12 @@
  */
 import { PipelineStatusFromJSON, PipelineStatusToJSON, } from './PipelineStatus';
 import { UserInfoFromJSON, UserInfoToJSON, } from './UserInfo';
-export const WorkflowDetailResponsePropertyValidationAttributesMap = {};
+export const WorkflowDetailResponsePropertyValidationAttributesMap = {
+    lastStageRetryAttempt: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+};
 /**
  * Check if a given object implements the WorkflowDetailResponse interface.
  */
@@ -67,6 +72,7 @@ export function WorkflowDetailResponseFromJSONTyped(json, ignoreDiscriminator) {
         'uploader': UserInfoFromJSON(json['uploader']),
         'status': PipelineStatusFromJSON(json['status']),
         'lastActivity': json['last_activity'] == null ? undefined : json['last_activity'],
+        'lastStageRetryAttempt': json['last_stage_retry_attempt'] == null ? undefined : json['last_stage_retry_attempt'],
         'error': json['error'] == null ? undefined : json['error'],
         'lastRunTimestamp': (new Date(json['last_run_timestamp'])),
         'lastStateUpdateTimestamp': json['last_state_update_timestamp'] == null ? undefined : (new Date(json['last_state_update_timestamp'])),
@@ -97,6 +103,7 @@ export function WorkflowDetailResponseToJSONTyped(value, ignoreDiscriminator = f
         'uploader': UserInfoToJSON(value['uploader']),
         'status': PipelineStatusToJSON(value['status']),
         'last_activity': value['lastActivity'],
+        'last_stage_retry_attempt': value['lastStageRetryAttempt'],
         'error': value['error'],
         'last_run_timestamp': value['lastRunTimestamp'].toISOString(),
         'last_state_update_timestamp': value['lastStateUpdateTimestamp'] == null ? value['lastStateUpdateTimestamp'] : value['lastStateUpdateTimestamp'].toISOString(),

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

@@ -71,6 +71,12 @@ export interface WorkflowSummaryResponse {
      * @memberof WorkflowSummaryResponse
      */
     lastActivity?: string | null;
+    /**
+     *
+     * @type {number}
+     * @memberof WorkflowSummaryResponse
+     */
+    lastStageRetryAttempt?: number;
     /**
      *
      * @type {string}

package/dist/esm/models/WorkflowSummaryResponse.js

@@ -13,7 +13,12 @@
  */
 import { PipelineStatusFromJSON, PipelineStatusToJSON, } from './PipelineStatus';
 import { UserInfoFromJSON, UserInfoToJSON, } from './UserInfo';
-export const WorkflowSummaryResponsePropertyValidationAttributesMap = {};
+export const WorkflowSummaryResponsePropertyValidationAttributesMap = {
+    lastStageRetryAttempt: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+};
 /**
  * Check if a given object implements the WorkflowSummaryResponse interface.
  */
@@ -57,6 +62,7 @@ export function WorkflowSummaryResponseFromJSONTyped(json, ignoreDiscriminator)
         'uploader': UserInfoFromJSON(json['uploader']),
         'status': PipelineStatusFromJSON(json['status']),
         'lastActivity': json['last_activity'] == null ? undefined : json['last_activity'],
+        'lastStageRetryAttempt': json['last_stage_retry_attempt'] == null ? undefined : json['last_stage_retry_attempt'],
         'error': json['error'] == null ? undefined : json['error'],
         'lastRunTimestamp': (new Date(json['last_run_timestamp'])),
         'lastStateUpdateTimestamp': json['last_state_update_timestamp'] == null ? undefined : (new Date(json['last_state_update_timestamp'])),
@@ -80,6 +86,7 @@ export function WorkflowSummaryResponseToJSONTyped(value, ignoreDiscriminator =
         'uploader': UserInfoToJSON(value['uploader']),
         'status': PipelineStatusToJSON(value['status']),
         'last_activity': value['lastActivity'],
+        'last_stage_retry_attempt': value['lastStageRetryAttempt'],
         'error': value['error'],
         'last_run_timestamp': value['lastRunTimestamp'].toISOString(),
         'last_state_update_timestamp': value['lastStateUpdateTimestamp'] == null ? value['lastStateUpdateTimestamp'] : value['lastStateUpdateTimestamp'].toISOString(),

package/dist/models/PipelineState.d.ts

@@ -19,6 +19,12 @@ import type { ChunkType } from './ChunkType';
  * @interface PipelineState
  */
 export interface PipelineState {
+    /**
+     * Zero-based retry count for the current stage; maximum across fan-out activities. Managed by ingestion.
+     * @type {number}
+     * @memberof PipelineState
+     */
+    readonly lastStageRetryAttempt?: number;
     /**
      *
      * @type {PipelineStatus}
@@ -38,13 +44,13 @@ export interface PipelineState {
      */
     lastStateUpdateTimestamp?: Date | null;
     /**
-     * Name of the last activity that executed (e.g., 'pdf_preparation_activity')
+     * Current ingestion stage, recorded before its activity starts
      * @type {string}
      * @memberof PipelineState
      */
     lastActivity?: string | null;
     /**
-     * Error message if pipeline failed
+     * Latest stage failure; retained during retries and cleared on the next stage or success
      * @type {string}
      * @memberof PipelineState
      */
@@ -108,4 +114,4 @@ export declare function instanceOfPipelineState(value: object): value is Pipelin
 export declare function PipelineStateFromJSON(json: any): PipelineState;
 export declare function PipelineStateFromJSONTyped(json: any, ignoreDiscriminator: boolean): PipelineState;
 export declare function PipelineStateToJSON(json: any): PipelineState;
-export declare function PipelineStateToJSONTyped(value?: PipelineState | null, ignoreDiscriminator?: boolean): any;
+export declare function PipelineStateToJSONTyped(value?: Omit<PipelineState, 'last_stage_retry_attempt'> | null, ignoreDiscriminator?: boolean): any;

package/dist/models/PipelineState.js

@@ -23,7 +23,12 @@ const PipelineStatus_1 = require("./PipelineStatus");
 const ImageTaxonomy_1 = require("./ImageTaxonomy");
 const IngestionMode_1 = require("./IngestionMode");
 const ChunkType_1 = require("./ChunkType");
-exports.PipelineStatePropertyValidationAttributesMap = {};
+exports.PipelineStatePropertyValidationAttributesMap = {
+    lastStageRetryAttempt: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+};
 /**
  * Check if a given object implements the PipelineState interface.
  */
@@ -40,6 +45,7 @@ function PipelineStateFromJSONTyped(json, ignoreDiscriminator) {
         return json;
     }
     return {
+        'lastStageRetryAttempt': json['last_stage_retry_attempt'] == null ? undefined : json['last_stage_retry_attempt'],
         'status': (0, PipelineStatus_1.PipelineStatusFromJSON)(json['status']),
         'lastRunTimestamp': json['last_run_timestamp'] == null ? undefined : (new Date(json['last_run_timestamp'])),
         'lastStateUpdateTimestamp': json['last_state_update_timestamp'] == null ? undefined : (new Date(json['last_state_update_timestamp'])),

package/dist/models/WorkflowDetailResponse.d.ts

@@ -71,6 +71,12 @@ export interface WorkflowDetailResponse {
      * @memberof WorkflowDetailResponse
      */
     lastActivity?: string | null;
+    /**
+     *
+     * @type {number}
+     * @memberof WorkflowDetailResponse
+     */
+    lastStageRetryAttempt?: number;
     /**
      *
      * @type {string}

package/dist/models/WorkflowDetailResponse.js

@@ -21,7 +21,12 @@ exports.WorkflowDetailResponseToJSON = WorkflowDetailResponseToJSON;
 exports.WorkflowDetailResponseToJSONTyped = WorkflowDetailResponseToJSONTyped;
 const PipelineStatus_1 = require("./PipelineStatus");
 const UserInfo_1 = require("./UserInfo");
-exports.WorkflowDetailResponsePropertyValidationAttributesMap = {};
+exports.WorkflowDetailResponsePropertyValidationAttributesMap = {
+    lastStageRetryAttempt: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+};
 /**
  * Check if a given object implements the WorkflowDetailResponse interface.
  */
@@ -75,6 +80,7 @@ function WorkflowDetailResponseFromJSONTyped(json, ignoreDiscriminator) {
         'uploader': (0, UserInfo_1.UserInfoFromJSON)(json['uploader']),
         'status': (0, PipelineStatus_1.PipelineStatusFromJSON)(json['status']),
         'lastActivity': json['last_activity'] == null ? undefined : json['last_activity'],
+        'lastStageRetryAttempt': json['last_stage_retry_attempt'] == null ? undefined : json['last_stage_retry_attempt'],
         'error': json['error'] == null ? undefined : json['error'],
         'lastRunTimestamp': (new Date(json['last_run_timestamp'])),
         'lastStateUpdateTimestamp': json['last_state_update_timestamp'] == null ? undefined : (new Date(json['last_state_update_timestamp'])),
@@ -105,6 +111,7 @@ function WorkflowDetailResponseToJSONTyped(value, ignoreDiscriminator = false) {
         'uploader': (0, UserInfo_1.UserInfoToJSON)(value['uploader']),
         'status': (0, PipelineStatus_1.PipelineStatusToJSON)(value['status']),
         'last_activity': value['lastActivity'],
+        'last_stage_retry_attempt': value['lastStageRetryAttempt'],
         'error': value['error'],
         'last_run_timestamp': value['lastRunTimestamp'].toISOString(),
         'last_state_update_timestamp': value['lastStateUpdateTimestamp'] == null ? value['lastStateUpdateTimestamp'] : value['lastStateUpdateTimestamp'].toISOString(),

package/dist/models/WorkflowSummaryResponse.d.ts

@@ -71,6 +71,12 @@ export interface WorkflowSummaryResponse {
      * @memberof WorkflowSummaryResponse
      */
     lastActivity?: string | null;
+    /**
+     *
+     * @type {number}
+     * @memberof WorkflowSummaryResponse
+     */
+    lastStageRetryAttempt?: number;
     /**
      *
      * @type {string}

package/dist/models/WorkflowSummaryResponse.js

@@ -21,7 +21,12 @@ exports.WorkflowSummaryResponseToJSON = WorkflowSummaryResponseToJSON;
 exports.WorkflowSummaryResponseToJSONTyped = WorkflowSummaryResponseToJSONTyped;
 const PipelineStatus_1 = require("./PipelineStatus");
 const UserInfo_1 = require("./UserInfo");
-exports.WorkflowSummaryResponsePropertyValidationAttributesMap = {};
+exports.WorkflowSummaryResponsePropertyValidationAttributesMap = {
+    lastStageRetryAttempt: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+};
 /**
  * Check if a given object implements the WorkflowSummaryResponse interface.
  */
@@ -65,6 +70,7 @@ function WorkflowSummaryResponseFromJSONTyped(json, ignoreDiscriminator) {
         'uploader': (0, UserInfo_1.UserInfoFromJSON)(json['uploader']),
         'status': (0, PipelineStatus_1.PipelineStatusFromJSON)(json['status']),
         'lastActivity': json['last_activity'] == null ? undefined : json['last_activity'],
+        'lastStageRetryAttempt': json['last_stage_retry_attempt'] == null ? undefined : json['last_stage_retry_attempt'],
         'error': json['error'] == null ? undefined : json['error'],
         'lastRunTimestamp': (new Date(json['last_run_timestamp'])),
         'lastStateUpdateTimestamp': json['last_state_update_timestamp'] == null ? undefined : (new Date(json['last_state_update_timestamp'])),
@@ -88,6 +94,7 @@ function WorkflowSummaryResponseToJSONTyped(value, ignoreDiscriminator = false)
         'uploader': (0, UserInfo_1.UserInfoToJSON)(value['uploader']),
         'status': (0, PipelineStatus_1.PipelineStatusToJSON)(value['status']),
         'last_activity': value['lastActivity'],
+        'last_stage_retry_attempt': value['lastStageRetryAttempt'],
         'error': value['error'],
         'last_run_timestamp': value['lastRunTimestamp'].toISOString(),
         'last_state_update_timestamp': value['lastStateUpdateTimestamp'] == null ? value['lastStateUpdateTimestamp'] : value['lastStateUpdateTimestamp'].toISOString(),

package/docs/PipelineState.md

@@ -7,6 +7,7 @@ Pipeline execution state tracking.
 
 Name | Type
 ------------ | -------------
+`lastStageRetryAttempt` | number
 `status` | [PipelineStatus](PipelineStatus.md)
 `lastRunTimestamp` | Date
 `lastStateUpdateTimestamp` | Date
@@ -26,6 +27,7 @@ import type { PipelineState } from '@knowledge-stack/ksapi'
 
 // TODO: Update the object below with actual values
 const example = {
+  "lastStageRetryAttempt": null,
   "status": null,
   "lastRunTimestamp": null,
   "lastStateUpdateTimestamp": null,

package/docs/SystemJobsApi.md

@@ -96,7 +96,7 @@ example().catch(console.error);
 
 Cancel Temporal Workflow Handler
 
-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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
 
 ### Example
 

package/docs/WorkflowDetailResponse.md

@@ -16,6 +16,7 @@ Name | Type
 `uploader` | [UserInfo](UserInfo.md)
 `status` | [PipelineStatus](PipelineStatus.md)
 `lastActivity` | string
+`lastStageRetryAttempt` | number
 `error` | string
 `lastRunTimestamp` | Date
 `lastStateUpdateTimestamp` | Date
@@ -44,6 +45,7 @@ const example = {
   "uploader": null,
   "status": null,
   "lastActivity": null,
+  "lastStageRetryAttempt": null,
   "error": null,
   "lastRunTimestamp": null,
   "lastStateUpdateTimestamp": null,

package/docs/WorkflowSummaryResponse.md

@@ -16,6 +16,7 @@ Name | Type
 `uploader` | [UserInfo](UserInfo.md)
 `status` | [PipelineStatus](PipelineStatus.md)
 `lastActivity` | string
+`lastStageRetryAttempt` | number
 `error` | string
 `lastRunTimestamp` | Date
 `lastStateUpdateTimestamp` | Date
@@ -37,6 +38,7 @@ const example = {
   "uploader": null,
   "status": null,
   "lastActivity": null,
+  "lastStageRetryAttempt": null,
   "error": null,
   "lastRunTimestamp": null,
   "lastStateUpdateTimestamp": null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowledge-stack/ksapi",
-  "version": "3.18.2",
+  "version": "3.19.0",
   "description": "OpenAPI client for @knowledge-stack/ksapi",
   "author": "OpenAPI-Generator",
   "repository": {

package/src/apis/SystemJobsApi.ts

@@ -142,7 +142,7 @@ export interface SystemJobsApiInterface {
     cancelTemporalWorkflowRequestOpts(requestParameters: CancelTemporalWorkflowRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * @summary Cancel Temporal Workflow Handler
      * @param {string} workflowId 
      * @param {*} [options] Override http request option.
@@ -152,7 +152,7 @@ export interface SystemJobsApiInterface {
     cancelTemporalWorkflowRaw(requestParameters: CancelTemporalWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowCancelResponse>>;
 
     /**
-     * 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * Cancel Temporal Workflow Handler
      */
     cancelTemporalWorkflow(requestParameters: CancelTemporalWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowCancelResponse>;
@@ -425,7 +425,7 @@ export class SystemJobsApi extends runtime.BaseAPI implements SystemJobsApiInter
     }
 
     /**
-     * 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * Cancel Temporal Workflow Handler
      */
     async cancelTemporalWorkflowRaw(requestParameters: CancelTemporalWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowCancelResponse>> {
@@ -436,7 +436,7 @@ export class SystemJobsApi extends runtime.BaseAPI implements SystemJobsApiInter
     }
 
     /**
-     * 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 a tenant workflow; tracked ingestion also requires document write access.  Tracked attempts are settled before cancelling their matching Temporal run, including attempts not yet dispatched. Unstarted executions are terminated because cancellation needs a worker. Temporal operations pin the described run so a concurrent rerun is left alone.
      * Cancel Temporal Workflow Handler
      */
     async cancelTemporalWorkflow(requestParameters: CancelTemporalWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowCancelResponse> {

package/src/models/PipelineState.ts

@@ -48,6 +48,12 @@ import {
  * @interface PipelineState
  */
 export interface PipelineState {
+    /**
+     * Zero-based retry count for the current stage; maximum across fan-out activities. Managed by ingestion.
+     * @type {number}
+     * @memberof PipelineState
+     */
+    readonly lastStageRetryAttempt?: number;
     /**
      * 
      * @type {PipelineStatus}
@@ -67,13 +73,13 @@ export interface PipelineState {
      */
     lastStateUpdateTimestamp?: Date | null;
     /**
-     * Name of the last activity that executed (e.g., 'pdf_preparation_activity')
+     * Current ingestion stage, recorded before its activity starts
      * @type {string}
      * @memberof PipelineState
      */
     lastActivity?: string | null;
     /**
-     * Error message if pipeline failed
+     * Latest stage failure; retained during retries and cleared on the next stage or success
      * @type {string}
      * @memberof PipelineState
      */
@@ -132,6 +138,10 @@ export const PipelineStatePropertyValidationAttributesMap: {
         uniqueItems?: boolean
     }
 } = {
+    lastStageRetryAttempt: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
 }
 
 
@@ -153,6 +163,7 @@ export function PipelineStateFromJSONTyped(json: any, ignoreDiscriminator: boole
     }
     return {
         
+        'lastStageRetryAttempt': json['last_stage_retry_attempt'] == null ? undefined : json['last_stage_retry_attempt'],
         'status': PipelineStatusFromJSON(json['status']),
         'lastRunTimestamp': json['last_run_timestamp'] == null ? undefined : (new Date(json['last_run_timestamp'])),
         'lastStateUpdateTimestamp': json['last_state_update_timestamp'] == null ? undefined : (new Date(json['last_state_update_timestamp'])),
@@ -171,7 +182,7 @@ export function PipelineStateToJSON(json: any): PipelineState {
     return PipelineStateToJSONTyped(json, false);
 }
 
-export function PipelineStateToJSONTyped(value?: PipelineState | null, ignoreDiscriminator: boolean = false): any {
+export function PipelineStateToJSONTyped(value?: Omit<PipelineState, 'last_stage_retry_attempt'> | null, ignoreDiscriminator: boolean = false): any {
     if (value == null) {
         return value;
     }

package/src/models/WorkflowDetailResponse.ts

@@ -88,6 +88,12 @@ export interface WorkflowDetailResponse {
      * @memberof WorkflowDetailResponse
      */
     lastActivity?: string | null;
+    /**
+     * 
+     * @type {number}
+     * @memberof WorkflowDetailResponse
+     */
+    lastStageRetryAttempt?: number;
     /**
      * 
      * @type {string}
@@ -172,6 +178,10 @@ export const WorkflowDetailResponsePropertyValidationAttributesMap: {
         uniqueItems?: boolean
     }
 } = {
+    lastStageRetryAttempt: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
 }
 
 
@@ -216,6 +226,7 @@ export function WorkflowDetailResponseFromJSONTyped(json: any, ignoreDiscriminat
         'uploader': UserInfoFromJSON(json['uploader']),
         'status': PipelineStatusFromJSON(json['status']),
         'lastActivity': json['last_activity'] == null ? undefined : json['last_activity'],
+        'lastStageRetryAttempt': json['last_stage_retry_attempt'] == null ? undefined : json['last_stage_retry_attempt'],
         'error': json['error'] == null ? undefined : json['error'],
         'lastRunTimestamp': (new Date(json['last_run_timestamp'])),
         'lastStateUpdateTimestamp': json['last_state_update_timestamp'] == null ? undefined : (new Date(json['last_state_update_timestamp'])),
@@ -250,6 +261,7 @@ export function WorkflowDetailResponseToJSONTyped(value?: WorkflowDetailResponse
         'uploader': UserInfoToJSON(value['uploader']),
         'status': PipelineStatusToJSON(value['status']),
         'last_activity': value['lastActivity'],
+        'last_stage_retry_attempt': value['lastStageRetryAttempt'],
         'error': value['error'],
         'last_run_timestamp': value['lastRunTimestamp'].toISOString(),
         'last_state_update_timestamp': value['lastStateUpdateTimestamp'] == null ? value['lastStateUpdateTimestamp'] : value['lastStateUpdateTimestamp'].toISOString(),

package/src/models/WorkflowSummaryResponse.ts

@@ -88,6 +88,12 @@ export interface WorkflowSummaryResponse {
      * @memberof WorkflowSummaryResponse
      */
     lastActivity?: string | null;
+    /**
+     * 
+     * @type {number}
+     * @memberof WorkflowSummaryResponse
+     */
+    lastStageRetryAttempt?: number;
     /**
      * 
      * @type {string}
@@ -130,6 +136,10 @@ export const WorkflowSummaryResponsePropertyValidationAttributesMap: {
         uniqueItems?: boolean
     }
 } = {
+    lastStageRetryAttempt: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
 }
 
 
@@ -169,6 +179,7 @@ export function WorkflowSummaryResponseFromJSONTyped(json: any, ignoreDiscrimina
         'uploader': UserInfoFromJSON(json['uploader']),
         'status': PipelineStatusFromJSON(json['status']),
         'lastActivity': json['last_activity'] == null ? undefined : json['last_activity'],
+        'lastStageRetryAttempt': json['last_stage_retry_attempt'] == null ? undefined : json['last_stage_retry_attempt'],
         'error': json['error'] == null ? undefined : json['error'],
         'lastRunTimestamp': (new Date(json['last_run_timestamp'])),
         'lastStateUpdateTimestamp': json['last_state_update_timestamp'] == null ? undefined : (new Date(json['last_state_update_timestamp'])),
@@ -196,6 +207,7 @@ export function WorkflowSummaryResponseToJSONTyped(value?: WorkflowSummaryRespon
         'uploader': UserInfoToJSON(value['uploader']),
         'status': PipelineStatusToJSON(value['status']),
         'last_activity': value['lastActivity'],
+        'last_stage_retry_attempt': value['lastStageRetryAttempt'],
         'error': value['error'],
         'last_run_timestamp': value['lastRunTimestamp'].toISOString(),
         'last_state_update_timestamp': value['lastStateUpdateTimestamp'] == null ? value['lastStateUpdateTimestamp'] : value['lastStateUpdateTimestamp'].toISOString(),