@knowledge-stack/ksapi 1.119.0 → 1.120.0

package/docs/ExcludedCommonFile.md

@@ -0,0 +1,37 @@
+
+# ExcludedCommonFile
+
+A definition common file that could not be applied to a run at Start.  Common files resolve resiliently (record-and-continue): one that is missing/deleted or unreadable by the run-starter is recorded here rather than failing the run, so the exclusion is auditable and visible to the FE.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`pathPartId` | string
+`reason` | [CommonFileExclusionReason](CommonFileExclusionReason.md)
+
+## Example
+
+```typescript
+import type { ExcludedCommonFile } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "pathPartId": null,
+  "reason": null,
+} satisfies ExcludedCommonFile
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ExcludedCommonFile
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponse.md

@@ -32,6 +32,7 @@ Name | Type
 `isActive` | boolean
 `approvalRequired` | boolean
 `isTemplate` | boolean
+`commonFilePathPartIds` | Array<string>
 `createdFromId` | string
 `copyCount` | number
 `workflowDefinitionId` | string
@@ -48,6 +49,7 @@ Name | Type
 `discussionsPathPartId` | string
 `inputPathPartIds` | Array<string>
 `outputsPathPartIds` | Array<string>
+`excludedCommonFiles` | [Array<ExcludedCommonFile>](ExcludedCommonFile.md)
 `runThreadId` | string
 `engine` | [DataSourceEngine](DataSourceEngine.md)
 `dataSourceId` | string
@@ -97,6 +99,7 @@ const example = {
   "isActive": null,
   "approvalRequired": null,
   "isTemplate": null,
+  "commonFilePathPartIds": null,
   "createdFromId": null,
   "copyCount": null,
   "workflowDefinitionId": null,
@@ -113,6 +116,7 @@ const example = {
   "discussionsPathPartId": null,
   "inputPathPartIds": null,
   "outputsPathPartIds": null,
+  "excludedCommonFiles": null,
   "runThreadId": null,
   "engine": null,
   "dataSourceId": null,

package/docs/InputOrigin.md

@@ -0,0 +1,33 @@
+
+# InputOrigin
+
+Where a run-snapshot input came from, for auditability.  A run\'s pinned inputs are merged from three sources at Start; this tags each so an auditor / the FE can tell a definition-mandated common file apart from a file the run\'s creator chose.
+
+## Properties
+
+Name | Type
+------------ | -------------
+
+## Example
+
+```typescript
+import type { InputOrigin } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+} satisfies InputOrigin
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as InputOrigin
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/InputSnapshot.md

@@ -10,6 +10,7 @@ Name | Type
 `pathPartId` | string
 `materializedPath` | string
 `partType` | string
+`origin` | [InputOrigin](InputOrigin.md)
 
 ## Example
 
@@ -21,6 +22,7 @@ const example = {
   "pathPartId": null,
   "materializedPath": null,
   "partType": null,
+  "origin": null,
 } satisfies InputSnapshot
 
 console.log(example)

package/docs/UpdateWorkflowDefinitionRequest.md

@@ -14,6 +14,7 @@ Name | Type
 `parentPathPartId` | string
 `isActive` | boolean
 `approvalRequired` | boolean
+`commonFilePathPartIds` | Array<string>
 
 ## Example
 
@@ -29,6 +30,7 @@ const example = {
   "parentPathPartId": null,
   "isActive": null,
   "approvalRequired": null,
+  "commonFilePathPartIds": null,
 } satisfies UpdateWorkflowDefinitionRequest
 
 console.log(example)

package/docs/WorkflowDefinitionResponse.md

@@ -20,6 +20,7 @@ Name | Type
 `isActive` | boolean
 `approvalRequired` | boolean
 `isTemplate` | boolean
+`commonFilePathPartIds` | Array<string>
 `createdFromId` | string
 `copyCount` | number
 `approvalState` | [PathPartApprovalState](PathPartApprovalState.md)
@@ -48,6 +49,7 @@ const example = {
   "isActive": null,
   "approvalRequired": null,
   "isTemplate": null,
+  "commonFilePathPartIds": null,
   "createdFromId": null,
   "copyCount": null,
   "approvalState": null,

package/docs/WorkflowRunResponse.md

@@ -29,6 +29,7 @@ Name | Type
 `discussionsPathPartId` | string
 `inputPathPartIds` | Array<string>
 `outputsPathPartIds` | Array<string>
+`excludedCommonFiles` | [Array<ExcludedCommonFile>](ExcludedCommonFile.md)
 `runThreadId` | string
 `owner` | [UserInfo](UserInfo.md)
 `createdAt` | Date
@@ -64,6 +65,7 @@ const example = {
   "discussionsPathPartId": null,
   "inputPathPartIds": null,
   "outputsPathPartIds": null,
+  "excludedCommonFiles": null,
   "runThreadId": null,
   "owner": null,
   "createdAt": null,

package/docs/WorkflowRunSnapshot.md

@@ -11,6 +11,7 @@ Name | Type
 `maxRunDurationSeconds` | number
 `instruction` | [InstructionSnapshot](InstructionSnapshot.md)
 `inputs` | [Array<InputSnapshot>](InputSnapshot.md)
+`excludedCommonFiles` | [Array<ExcludedCommonFile>](ExcludedCommonFile.md)
 `userMessage` | string
 
 ## Example
@@ -24,6 +25,7 @@ const example = {
   "maxRunDurationSeconds": null,
   "instruction": null,
   "inputs": null,
+  "excludedCommonFiles": null,
   "userMessage": null,
 } satisfies WorkflowRunSnapshot
 

package/package.json

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

package/src/models/CommonFileExclusionReason.ts

@@ -0,0 +1,57 @@
+/* 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.
+ */
+
+
+/**
+ * Why a definition common file was left out of a run at Start.
+ * 
+ * Common files resolve resiliently (record-and-continue): an unresolvable
+ * one is excluded with one of these reasons rather than failing the run.
+ * @export
+ */
+export const CommonFileExclusionReason = {
+    NotFound: 'NOT_FOUND',
+    NoAccess: 'NO_ACCESS',
+    Unresolvable: 'UNRESOLVABLE'
+} as const;
+export type CommonFileExclusionReason = typeof CommonFileExclusionReason[keyof typeof CommonFileExclusionReason];
+
+
+export function instanceOfCommonFileExclusionReason(value: any): boolean {
+    for (const key in CommonFileExclusionReason) {
+        if (Object.prototype.hasOwnProperty.call(CommonFileExclusionReason, key)) {
+            if (CommonFileExclusionReason[key as keyof typeof CommonFileExclusionReason] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+
+export function CommonFileExclusionReasonFromJSON(json: any): CommonFileExclusionReason {
+    return CommonFileExclusionReasonFromJSONTyped(json, false);
+}
+
+export function CommonFileExclusionReasonFromJSONTyped(json: any, ignoreDiscriminator: boolean): CommonFileExclusionReason {
+    return json as CommonFileExclusionReason;
+}
+
+export function CommonFileExclusionReasonToJSON(value?: CommonFileExclusionReason | null): any {
+    return value as any;
+}
+
+export function CommonFileExclusionReasonToJSONTyped(value: any, ignoreDiscriminator: boolean): CommonFileExclusionReason {
+    return value as CommonFileExclusionReason;
+}
+

package/src/models/CreateWorkflowDefinitionRequest.ts

@@ -65,6 +65,12 @@ export interface CreateWorkflowDefinitionRequest {
      * @memberof CreateWorkflowDefinitionRequest
      */
     isTemplate?: boolean;
+    /**
+     * Optional path_part ids of common files (DOCUMENT / FOLDER / DATA_SOURCE / API_CONNECTION) attached to every run of this workflow — e.g. an output template. Merged with each run's own inputs at Start. The caller must be able to read each one.
+     * @type {Array<string>}
+     * @memberof CreateWorkflowDefinitionRequest
+     */
+    commonFilePathPartIds?: Array<string>;
 }
 export const CreateWorkflowDefinitionRequestPropertyValidationAttributesMap: {
     [property: string]: {
@@ -90,6 +96,10 @@ export const CreateWorkflowDefinitionRequestPropertyValidationAttributesMap: {
         minimum: 60,
         exclusiveMinimum: false,
     },
+    commonFilePathPartIds: {
+        maxItems: 20,
+        uniqueItems: false,
+    },
 }
 
 
@@ -120,6 +130,7 @@ export function CreateWorkflowDefinitionRequestFromJSONTyped(json: any, ignoreDi
         'instructionPathPartId': json['instruction_path_part_id'] == null ? undefined : json['instruction_path_part_id'],
         'approvalRequired': json['approval_required'],
         'isTemplate': json['is_template'] == null ? undefined : json['is_template'],
+        'commonFilePathPartIds': json['common_file_path_part_ids'] == null ? undefined : json['common_file_path_part_ids'],
     };
 }
 
@@ -141,6 +152,7 @@ export function CreateWorkflowDefinitionRequestToJSONTyped(value?: CreateWorkflo
         'instruction_path_part_id': value['instructionPathPartId'],
         'approval_required': value['approvalRequired'],
         'is_template': value['isTemplate'],
+        'common_file_path_part_ids': value['commonFilePathPartIds'],
     };
 }
 

package/src/models/ExcludedCommonFile.ts

@@ -0,0 +1,106 @@
+/* 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';
+import type { CommonFileExclusionReason } from './CommonFileExclusionReason';
+import {
+    CommonFileExclusionReasonFromJSON,
+    CommonFileExclusionReasonFromJSONTyped,
+    CommonFileExclusionReasonToJSON,
+    CommonFileExclusionReasonToJSONTyped,
+} from './CommonFileExclusionReason';
+
+/**
+ * A definition common file that could not be applied to a run at Start.
+ * 
+ * Common files resolve resiliently (record-and-continue): one that is
+ * missing/deleted or unreadable by the run-starter is recorded here rather
+ * than failing the run, so the exclusion is auditable and visible to the FE.
+ * @export
+ * @interface ExcludedCommonFile
+ */
+export interface ExcludedCommonFile {
+    /**
+     * The common file's path_part id, as set on the definition
+     * @type {string}
+     * @memberof ExcludedCommonFile
+     */
+    pathPartId: string;
+    /**
+     * 
+     * @type {CommonFileExclusionReason}
+     * @memberof ExcludedCommonFile
+     */
+    reason: CommonFileExclusionReason;
+}
+
+
+export const ExcludedCommonFilePropertyValidationAttributesMap: {
+    [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 ExcludedCommonFile interface.
+ */
+export function instanceOfExcludedCommonFile(value: object): value is ExcludedCommonFile {
+    if (!('pathPartId' in value) || value['pathPartId'] === undefined) return false;
+    if (!('reason' in value) || value['reason'] === undefined) return false;
+    return true;
+}
+
+export function ExcludedCommonFileFromJSON(json: any): ExcludedCommonFile {
+    return ExcludedCommonFileFromJSONTyped(json, false);
+}
+
+export function ExcludedCommonFileFromJSONTyped(json: any, ignoreDiscriminator: boolean): ExcludedCommonFile {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'pathPartId': json['path_part_id'],
+        'reason': CommonFileExclusionReasonFromJSON(json['reason']),
+    };
+}
+
+export function ExcludedCommonFileToJSON(json: any): ExcludedCommonFile {
+    return ExcludedCommonFileToJSONTyped(json, false);
+}
+
+export function ExcludedCommonFileToJSONTyped(value?: ExcludedCommonFile | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'path_part_id': value['pathPartId'],
+        'reason': CommonFileExclusionReasonToJSON(value['reason']),
+    };
+}
+

package/src/models/InputOrigin.ts

@@ -0,0 +1,58 @@
+/* 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.
+ */
+
+
+/**
+ * Where a run-snapshot input came from, for auditability.
+ * 
+ * A run's pinned inputs are merged from three sources at Start; this tags
+ * each so an auditor / the FE can tell a definition-mandated common file
+ * apart from a file the run's creator chose.
+ * @export
+ */
+export const InputOrigin = {
+    DefinitionCommon: 'DEFINITION_COMMON',
+    RunReference: 'RUN_REFERENCE',
+    RunUpload: 'RUN_UPLOAD'
+} as const;
+export type InputOrigin = typeof InputOrigin[keyof typeof InputOrigin];
+
+
+export function instanceOfInputOrigin(value: any): boolean {
+    for (const key in InputOrigin) {
+        if (Object.prototype.hasOwnProperty.call(InputOrigin, key)) {
+            if (InputOrigin[key as keyof typeof InputOrigin] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+
+export function InputOriginFromJSON(json: any): InputOrigin {
+    return InputOriginFromJSONTyped(json, false);
+}
+
+export function InputOriginFromJSONTyped(json: any, ignoreDiscriminator: boolean): InputOrigin {
+    return json as InputOrigin;
+}
+
+export function InputOriginToJSON(value?: InputOrigin | null): any {
+    return value as any;
+}
+
+export function InputOriginToJSONTyped(value: any, ignoreDiscriminator: boolean): InputOrigin {
+    return value as InputOrigin;
+}
+

package/src/models/InputSnapshot.ts

@@ -13,6 +13,14 @@
  */
 
 import { mapValues } from '../runtime';
+import type { InputOrigin } from './InputOrigin';
+import {
+    InputOriginFromJSON,
+    InputOriginFromJSONTyped,
+    InputOriginToJSON,
+    InputOriginToJSONTyped,
+} from './InputOrigin';
+
 /**
  * One entry of a run's input scope, self-describing its pin semantics.
  * 
@@ -56,6 +64,12 @@ export interface InputSnapshot {
      * @memberof InputSnapshot
      */
     partType: InputSnapshotPartTypeEnum;
+    /**
+     * 
+     * @type {InputOrigin}
+     * @memberof InputSnapshot
+     */
+    origin?: InputOrigin;
 }
 
 
@@ -111,6 +125,7 @@ export function InputSnapshotFromJSONTyped(json: any, ignoreDiscriminator: boole
         'pathPartId': json['path_part_id'],
         'materializedPath': json['materialized_path'],
         'partType': json['part_type'],
+        'origin': json['origin'] == null ? undefined : InputOriginFromJSON(json['origin']),
     };
 }
 
@@ -128,6 +143,7 @@ export function InputSnapshotToJSONTyped(value?: InputSnapshot | null, ignoreDis
         'path_part_id': value['pathPartId'],
         'materialized_path': value['materializedPath'],
         'part_type': value['partType'],
+        'origin': InputOriginToJSON(value['origin']),
     };
 }
 

package/src/models/UpdateWorkflowDefinitionRequest.ts

@@ -61,6 +61,12 @@ export interface UpdateWorkflowDefinitionRequest {
      * @memberof UpdateWorkflowDefinitionRequest
      */
     approvalRequired: boolean;
+    /**
+     * Common files attached to every run (DOCUMENT / FOLDER / DATA_SOURCE / API_CONNECTION path_part ids). Like ``instruction_path_part_id``, this is the exception to PUT semantics: null (or omit) retains the stored list; pass [] to clear; pass a list to replace it wholesale. The caller must be able to read each one.
+     * @type {Array<string>}
+     * @memberof UpdateWorkflowDefinitionRequest
+     */
+    commonFilePathPartIds?: Array<string> | null;
 }
 export const UpdateWorkflowDefinitionRequestPropertyValidationAttributesMap: {
     [property: string]: {
@@ -86,6 +92,10 @@ export const UpdateWorkflowDefinitionRequestPropertyValidationAttributesMap: {
         minimum: 60,
         exclusiveMinimum: false,
     },
+    commonFilePathPartIds: {
+        maxItems: 20,
+        uniqueItems: false,
+    },
 }
 
 
@@ -116,6 +126,7 @@ export function UpdateWorkflowDefinitionRequestFromJSONTyped(json: any, ignoreDi
         'parentPathPartId': json['parent_path_part_id'] == null ? undefined : json['parent_path_part_id'],
         'isActive': json['is_active'],
         'approvalRequired': json['approval_required'],
+        'commonFilePathPartIds': json['common_file_path_part_ids'] == null ? undefined : json['common_file_path_part_ids'],
     };
 }
 
@@ -137,6 +148,7 @@ export function UpdateWorkflowDefinitionRequestToJSONTyped(value?: UpdateWorkflo
         'parent_path_part_id': value['parentPathPartId'],
         'is_active': value['isActive'],
         'approval_required': value['approvalRequired'],
+        'common_file_path_part_ids': value['commonFilePathPartIds'],
     };
 }
 

package/src/models/WorkflowDefinitionResponse.ts

@@ -125,6 +125,12 @@ export interface WorkflowDefinitionResponse {
      * @memberof WorkflowDefinitionResponse
      */
     isTemplate: boolean;
+    /**
+     * Common files attached to every run (path_part ids). The FE renders these as 'attached to every run' on the workflow page.
+     * @type {Array<string>}
+     * @memberof WorkflowDefinitionResponse
+     */
+    commonFilePathPartIds?: Array<string>;
     /**
      * Source definition this workflow was copied from (a template or any other workflow); null if hand-authored.
      * @type {string}
@@ -242,6 +248,7 @@ export function WorkflowDefinitionResponseFromJSONTyped(json: any, ignoreDiscrim
         'isActive': json['is_active'],
         'approvalRequired': json['approval_required'],
         'isTemplate': json['is_template'],
+        'commonFilePathPartIds': json['common_file_path_part_ids'] == null ? undefined : json['common_file_path_part_ids'],
         'createdFromId': json['created_from_id'],
         'copyCount': json['copy_count'] == null ? undefined : json['copy_count'],
         'approvalState': PathPartApprovalStateFromJSON(json['approval_state']),
@@ -276,6 +283,7 @@ export function WorkflowDefinitionResponseToJSONTyped(value?: WorkflowDefinition
         'is_active': value['isActive'],
         'approval_required': value['approvalRequired'],
         'is_template': value['isTemplate'],
+        'common_file_path_part_ids': value['commonFilePathPartIds'],
         'created_from_id': value['createdFromId'],
         'copy_count': value['copyCount'],
         'approval_state': PathPartApprovalStateToJSON(value['approvalState']),

package/src/models/WorkflowRunResponse.ts

@@ -34,6 +34,13 @@ import {
     WorkflowExecutionStateToJSON,
     WorkflowExecutionStateToJSONTyped,
 } from './WorkflowExecutionState';
+import type { ExcludedCommonFile } from './ExcludedCommonFile';
+import {
+    ExcludedCommonFileFromJSON,
+    ExcludedCommonFileFromJSONTyped,
+    ExcludedCommonFileToJSON,
+    ExcludedCommonFileToJSONTyped,
+} from './ExcludedCommonFile';
 import type { PathPartApprovalState } from './PathPartApprovalState';
 import {
     PathPartApprovalStateFromJSON,
@@ -197,6 +204,12 @@ export interface WorkflowRunResponse {
      * @memberof WorkflowRunResponse
      */
     outputsPathPartIds: Array<string>;
+    /**
+     * Definition common files that were excluded from this run at Start (deleted or unreadable by the starter). Empty until Start builds the snapshot, and empty for the common happy path.
+     * @type {Array<ExcludedCommonFile>}
+     * @memberof WorkflowRunResponse
+     */
+    excludedCommonFiles?: Array<ExcludedCommonFile>;
     /**
      * The run's primary chat thread (1:1). NULL while NOT_STARTED; set by Start. The FE opens the run by opening this thread.
      * @type {string}
@@ -316,6 +329,7 @@ export function WorkflowRunResponseFromJSONTyped(json: any, ignoreDiscriminator:
         'discussionsPathPartId': json['discussions_path_part_id'],
         'inputPathPartIds': json['input_path_part_ids'] == null ? undefined : json['input_path_part_ids'],
         'outputsPathPartIds': json['outputs_path_part_ids'],
+        'excludedCommonFiles': json['excluded_common_files'] == null ? undefined : ((json['excluded_common_files'] as Array<any>).map(ExcludedCommonFileFromJSON)),
         'runThreadId': json['run_thread_id'] == null ? undefined : json['run_thread_id'],
         'owner': json['owner'] == null ? undefined : UserInfoFromJSON(json['owner']),
         'createdAt': (new Date(json['created_at'])),
@@ -357,6 +371,7 @@ export function WorkflowRunResponseToJSONTyped(value?: WorkflowRunResponse | nul
         'discussions_path_part_id': value['discussionsPathPartId'],
         'input_path_part_ids': value['inputPathPartIds'],
         'outputs_path_part_ids': value['outputsPathPartIds'],
+        'excluded_common_files': value['excludedCommonFiles'] == null ? undefined : ((value['excludedCommonFiles'] as Array<any>).map(ExcludedCommonFileToJSON)),
         'run_thread_id': value['runThreadId'],
         'owner': UserInfoToJSON(value['owner']),
         'created_at': value['createdAt'].toISOString(),

package/src/models/WorkflowRunSnapshot.ts

@@ -20,6 +20,13 @@ import {
     InputSnapshotToJSON,
     InputSnapshotToJSONTyped,
 } from './InputSnapshot';
+import type { ExcludedCommonFile } from './ExcludedCommonFile';
+import {
+    ExcludedCommonFileFromJSON,
+    ExcludedCommonFileFromJSONTyped,
+    ExcludedCommonFileToJSON,
+    ExcludedCommonFileToJSONTyped,
+} from './ExcludedCommonFile';
 import type { InstructionSnapshot } from './InstructionSnapshot';
 import {
     InstructionSnapshotFromJSON,
@@ -66,6 +73,12 @@ export interface WorkflowRunSnapshot {
      * @memberof WorkflowRunSnapshot
      */
     inputs: Array<InputSnapshot>;
+    /**
+     * Definition common files left out of this run at Start (deleted or unreadable by the starter), each with its exclusion reason. Empty for the common happy path; pre-feature snapshots default to empty.
+     * @type {Array<ExcludedCommonFile>}
+     * @memberof WorkflowRunSnapshot
+     */
+    excludedCommonFiles?: Array<ExcludedCommonFile>;
     /**
      * Optional free-text message the caller supplied at Start. Pinned here so the runner injects it into the agent's first user turn and it survives retry, redrive, and workflow-thread follow-ups (all of which re-assemble the prompt from this snapshot).
      * @type {string}
@@ -119,6 +132,7 @@ export function WorkflowRunSnapshotFromJSONTyped(json: any, ignoreDiscriminator:
         'maxRunDurationSeconds': json['max_run_duration_seconds'],
         'instruction': InstructionSnapshotFromJSON(json['instruction']),
         'inputs': ((json['inputs'] as Array<any>).map(InputSnapshotFromJSON)),
+        'excludedCommonFiles': json['excluded_common_files'] == null ? undefined : ((json['excluded_common_files'] as Array<any>).map(ExcludedCommonFileFromJSON)),
         'userMessage': json['user_message'] == null ? undefined : json['user_message'],
     };
 }
@@ -138,6 +152,7 @@ export function WorkflowRunSnapshotToJSONTyped(value?: WorkflowRunSnapshot | nul
         'max_run_duration_seconds': value['maxRunDurationSeconds'],
         'instruction': InstructionSnapshotToJSON(value['instruction']),
         'inputs': ((value['inputs'] as Array<any>).map(InputSnapshotToJSON)),
+        'excluded_common_files': value['excludedCommonFiles'] == null ? undefined : ((value['excludedCommonFiles'] as Array<any>).map(ExcludedCommonFileToJSON)),
         'user_message': value['userMessage'],
     };
 }