@knowledge-stack/ksapi 1.119.0 → 1.120.0

package/.openapi-generator/FILES

@@ -57,6 +57,7 @@ docs/ClearVersionContentsResponse.md
 docs/CloneWorkflowRunRequest.md
 docs/ColumnConfig.md
 docs/ColumnReference.md
+docs/CommonFileExclusionReason.md
 docs/ConnectionConfig.md
 docs/CreateApiConnectionRequest.md
 docs/CreateApiKeyRequest.md
@@ -123,6 +124,7 @@ docs/EnrichedCitation.md
 docs/EnrichedThreadMessageContent.md
 docs/ErrorResponse.md
 docs/EventResponse.md
+docs/ExcludedCommonFile.md
 docs/ExtractRequest.md
 docs/ExtractResponse.md
 docs/FeaturesApi.md
@@ -151,6 +153,7 @@ docs/ImageTaxonomy.md
 docs/InformationStatistics.md
 docs/IngestDocumentResponse.md
 docs/IngestionMode.md
+docs/InputOrigin.md
 docs/InputSnapshot.md
 docs/InstantiateWorkflowTemplateRequest.md
 docs/InstructionSnapshot.md
@@ -436,6 +439,7 @@ src/models/ClearVersionContentsResponse.ts
 src/models/CloneWorkflowRunRequest.ts
 src/models/ColumnConfig.ts
 src/models/ColumnReference.ts
+src/models/CommonFileExclusionReason.ts
 src/models/ConnectionConfig.ts
 src/models/CreateApiConnectionRequest.ts
 src/models/CreateApiKeyRequest.ts
@@ -497,6 +501,7 @@ src/models/EnrichedCitation.ts
 src/models/EnrichedThreadMessageContent.ts
 src/models/ErrorResponse.ts
 src/models/EventResponse.ts
+src/models/ExcludedCommonFile.ts
 src/models/ExtractRequest.ts
 src/models/ExtractResponse.ts
 src/models/FeaturesResponse.ts
@@ -522,6 +527,7 @@ src/models/ImageTaxonomy.ts
 src/models/InformationStatistics.ts
 src/models/IngestDocumentResponse.ts
 src/models/IngestionMode.ts
+src/models/InputOrigin.ts
 src/models/InputSnapshot.ts
 src/models/InstantiateWorkflowTemplateRequest.ts
 src/models/InstructionSnapshot.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@1.119.0
+# @knowledge-stack/ksapi@1.120.0
 
 A TypeScript SDK client for the localhost API.
 
@@ -314,6 +314,7 @@ All URIs are relative to *http://localhost:8000*
 - [CloneWorkflowRunRequest](docs/CloneWorkflowRunRequest.md)
 - [ColumnConfig](docs/ColumnConfig.md)
 - [ColumnReference](docs/ColumnReference.md)
+- [CommonFileExclusionReason](docs/CommonFileExclusionReason.md)
 - [ConnectionConfig](docs/ConnectionConfig.md)
 - [CreateApiConnectionRequest](docs/CreateApiConnectionRequest.md)
 - [CreateApiKeyRequest](docs/CreateApiKeyRequest.md)
@@ -375,6 +376,7 @@ All URIs are relative to *http://localhost:8000*
 - [EnrichedThreadMessageContent](docs/EnrichedThreadMessageContent.md)
 - [ErrorResponse](docs/ErrorResponse.md)
 - [EventResponse](docs/EventResponse.md)
+- [ExcludedCommonFile](docs/ExcludedCommonFile.md)
 - [ExtractRequest](docs/ExtractRequest.md)
 - [ExtractResponse](docs/ExtractResponse.md)
 - [FeaturesResponse](docs/FeaturesResponse.md)
@@ -400,6 +402,7 @@ All URIs are relative to *http://localhost:8000*
 - [InformationStatistics](docs/InformationStatistics.md)
 - [IngestDocumentResponse](docs/IngestDocumentResponse.md)
 - [IngestionMode](docs/IngestionMode.md)
+- [InputOrigin](docs/InputOrigin.md)
 - [InputSnapshot](docs/InputSnapshot.md)
 - [InstantiateWorkflowTemplateRequest](docs/InstantiateWorkflowTemplateRequest.md)
 - [InstructionSnapshot](docs/InstructionSnapshot.md)
@@ -606,7 +609,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `1.119.0`
+- Package version: `1.120.0`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

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

@@ -0,0 +1,29 @@
+/**
+ * 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 declare const CommonFileExclusionReason: {
+    readonly NotFound: "NOT_FOUND";
+    readonly NoAccess: "NO_ACCESS";
+    readonly Unresolvable: "UNRESOLVABLE";
+};
+export type CommonFileExclusionReason = typeof CommonFileExclusionReason[keyof typeof CommonFileExclusionReason];
+export declare function instanceOfCommonFileExclusionReason(value: any): boolean;
+export declare function CommonFileExclusionReasonFromJSON(json: any): CommonFileExclusionReason;
+export declare function CommonFileExclusionReasonFromJSONTyped(json: any, ignoreDiscriminator: boolean): CommonFileExclusionReason;
+export declare function CommonFileExclusionReasonToJSON(value?: CommonFileExclusionReason | null): any;
+export declare function CommonFileExclusionReasonToJSONTyped(value: any, ignoreDiscriminator: boolean): CommonFileExclusionReason;

package/dist/esm/models/CommonFileExclusionReason.js

@@ -0,0 +1,47 @@
+/* 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'
+};
+export function instanceOfCommonFileExclusionReason(value) {
+    for (const key in CommonFileExclusionReason) {
+        if (Object.prototype.hasOwnProperty.call(CommonFileExclusionReason, key)) {
+            if (CommonFileExclusionReason[key] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+export function CommonFileExclusionReasonFromJSON(json) {
+    return CommonFileExclusionReasonFromJSONTyped(json, false);
+}
+export function CommonFileExclusionReasonFromJSONTyped(json, ignoreDiscriminator) {
+    return json;
+}
+export function CommonFileExclusionReasonToJSON(value) {
+    return value;
+}
+export function CommonFileExclusionReasonToJSONTyped(value, ignoreDiscriminator) {
+    return value;
+}

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

@@ -61,6 +61,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 declare const CreateWorkflowDefinitionRequestPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/esm/models/CreateWorkflowDefinitionRequest.js

@@ -21,6 +21,10 @@ export const CreateWorkflowDefinitionRequestPropertyValidationAttributesMap = {
         minimum: 60,
         exclusiveMinimum: false,
     },
+    commonFilePathPartIds: {
+        maxItems: 20,
+        uniqueItems: false,
+    },
 };
 /**
  * Check if a given object implements the CreateWorkflowDefinitionRequest interface.
@@ -49,6 +53,7 @@ export function CreateWorkflowDefinitionRequestFromJSONTyped(json, ignoreDiscrim
         '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'],
     };
 }
 export function CreateWorkflowDefinitionRequestToJSON(json) {
@@ -66,5 +71,6 @@ export function CreateWorkflowDefinitionRequestToJSONTyped(value, ignoreDiscrimi
         'instruction_path_part_id': value['instructionPathPartId'],
         'approval_required': value['approvalRequired'],
         'is_template': value['isTemplate'],
+        'common_file_path_part_ids': value['commonFilePathPartIds'],
     };
 }

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

@@ -0,0 +1,58 @@
+/**
+ * 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 { CommonFileExclusionReason } 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 declare 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 declare function instanceOfExcludedCommonFile(value: object): value is ExcludedCommonFile;
+export declare function ExcludedCommonFileFromJSON(json: any): ExcludedCommonFile;
+export declare function ExcludedCommonFileFromJSONTyped(json: any, ignoreDiscriminator: boolean): ExcludedCommonFile;
+export declare function ExcludedCommonFileToJSON(json: any): ExcludedCommonFile;
+export declare function ExcludedCommonFileToJSONTyped(value?: ExcludedCommonFile | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/ExcludedCommonFile.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.
+ */
+import { CommonFileExclusionReasonFromJSON, CommonFileExclusionReasonToJSON, } from './CommonFileExclusionReason';
+export const ExcludedCommonFilePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the ExcludedCommonFile interface.
+ */
+export function instanceOfExcludedCommonFile(value) {
+    if (!('pathPartId' in value) || value['pathPartId'] === undefined)
+        return false;
+    if (!('reason' in value) || value['reason'] === undefined)
+        return false;
+    return true;
+}
+export function ExcludedCommonFileFromJSON(json) {
+    return ExcludedCommonFileFromJSONTyped(json, false);
+}
+export function ExcludedCommonFileFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'pathPartId': json['path_part_id'],
+        'reason': CommonFileExclusionReasonFromJSON(json['reason']),
+    };
+}
+export function ExcludedCommonFileToJSON(json) {
+    return ExcludedCommonFileToJSONTyped(json, false);
+}
+export function ExcludedCommonFileToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'path_part_id': value['pathPartId'],
+        'reason': CommonFileExclusionReasonToJSON(value['reason']),
+    };
+}

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

@@ -0,0 +1,30 @@
+/**
+ * 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 declare const InputOrigin: {
+    readonly DefinitionCommon: "DEFINITION_COMMON";
+    readonly RunReference: "RUN_REFERENCE";
+    readonly RunUpload: "RUN_UPLOAD";
+};
+export type InputOrigin = typeof InputOrigin[keyof typeof InputOrigin];
+export declare function instanceOfInputOrigin(value: any): boolean;
+export declare function InputOriginFromJSON(json: any): InputOrigin;
+export declare function InputOriginFromJSONTyped(json: any, ignoreDiscriminator: boolean): InputOrigin;
+export declare function InputOriginToJSON(value?: InputOrigin | null): any;
+export declare function InputOriginToJSONTyped(value: any, ignoreDiscriminator: boolean): InputOrigin;

package/dist/esm/models/InputOrigin.js

@@ -0,0 +1,48 @@
+/* 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'
+};
+export function instanceOfInputOrigin(value) {
+    for (const key in InputOrigin) {
+        if (Object.prototype.hasOwnProperty.call(InputOrigin, key)) {
+            if (InputOrigin[key] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+export function InputOriginFromJSON(json) {
+    return InputOriginFromJSONTyped(json, false);
+}
+export function InputOriginFromJSONTyped(json, ignoreDiscriminator) {
+    return json;
+}
+export function InputOriginToJSON(value) {
+    return value;
+}
+export function InputOriginToJSONTyped(value, ignoreDiscriminator) {
+    return value;
+}

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

@@ -9,6 +9,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import type { InputOrigin } from './InputOrigin';
 /**
  * One entry of a run's input scope, self-describing its pin semantics.
  *
@@ -52,6 +53,12 @@ export interface InputSnapshot {
      * @memberof InputSnapshot
      */
     partType: InputSnapshotPartTypeEnum;
+    /**
+     *
+     * @type {InputOrigin}
+     * @memberof InputSnapshot
+     */
+    origin?: InputOrigin;
 }
 /**
  * @export

package/dist/esm/models/InputSnapshot.js

@@ -11,6 +11,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import { InputOriginFromJSON, InputOriginToJSON, } from './InputOrigin';
 /**
  * @export
  */
@@ -44,6 +45,7 @@ export function InputSnapshotFromJSONTyped(json, ignoreDiscriminator) {
         'pathPartId': json['path_part_id'],
         'materializedPath': json['materialized_path'],
         'partType': json['part_type'],
+        'origin': json['origin'] == null ? undefined : InputOriginFromJSON(json['origin']),
     };
 }
 export function InputSnapshotToJSON(json) {
@@ -57,5 +59,6 @@ export function InputSnapshotToJSONTyped(value, ignoreDiscriminator = false) {
         'path_part_id': value['pathPartId'],
         'materialized_path': value['materializedPath'],
         'part_type': value['partType'],
+        'origin': InputOriginToJSON(value['origin']),
     };
 }

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

@@ -57,6 +57,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 declare const UpdateWorkflowDefinitionRequestPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/esm/models/UpdateWorkflowDefinitionRequest.js

@@ -21,6 +21,10 @@ export const UpdateWorkflowDefinitionRequestPropertyValidationAttributesMap = {
         minimum: 60,
         exclusiveMinimum: false,
     },
+    commonFilePathPartIds: {
+        maxItems: 20,
+        uniqueItems: false,
+    },
 };
 /**
  * Check if a given object implements the UpdateWorkflowDefinitionRequest interface.
@@ -49,6 +53,7 @@ export function UpdateWorkflowDefinitionRequestFromJSONTyped(json, ignoreDiscrim
         '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'],
     };
 }
 export function UpdateWorkflowDefinitionRequestToJSON(json) {
@@ -66,5 +71,6 @@ export function UpdateWorkflowDefinitionRequestToJSONTyped(value, ignoreDiscrimi
         'parent_path_part_id': value['parentPathPartId'],
         'is_active': value['isActive'],
         'approval_required': value['approvalRequired'],
+        'common_file_path_part_ids': value['commonFilePathPartIds'],
     };
 }

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

@@ -102,6 +102,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}

package/dist/esm/models/WorkflowDefinitionResponse.js

@@ -80,6 +80,7 @@ export function WorkflowDefinitionResponseFromJSONTyped(json, ignoreDiscriminato
         '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']),
@@ -110,6 +111,7 @@ export function WorkflowDefinitionResponseToJSONTyped(value, ignoreDiscriminator
         '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/dist/esm/models/WorkflowRunResponse.d.ts

@@ -12,6 +12,7 @@
 import type { ItemPermissions } from './ItemPermissions';
 import type { WorkflowRunSnapshot } from './WorkflowRunSnapshot';
 import type { WorkflowExecutionState } from './WorkflowExecutionState';
+import type { ExcludedCommonFile } from './ExcludedCommonFile';
 import type { PathPartApprovalState } from './PathPartApprovalState';
 import type { UserInfo } from './UserInfo';
 /**
@@ -162,6 +163,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}

package/dist/esm/models/WorkflowRunResponse.js

@@ -14,6 +14,7 @@
 import { ItemPermissionsFromJSON, ItemPermissionsToJSON, } from './ItemPermissions';
 import { WorkflowRunSnapshotFromJSON, WorkflowRunSnapshotToJSON, } from './WorkflowRunSnapshot';
 import { WorkflowExecutionStateFromJSON, WorkflowExecutionStateToJSON, } from './WorkflowExecutionState';
+import { ExcludedCommonFileFromJSON, ExcludedCommonFileToJSON, } from './ExcludedCommonFile';
 import { PathPartApprovalStateFromJSON, PathPartApprovalStateToJSON, } from './PathPartApprovalState';
 import { UserInfoFromJSON, UserInfoToJSON, } from './UserInfo';
 /**
@@ -101,6 +102,7 @@ export function WorkflowRunResponseFromJSONTyped(json, 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'].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'])),
@@ -138,6 +140,7 @@ export function WorkflowRunResponseToJSONTyped(value, ignoreDiscriminator = fals
         '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'].map(ExcludedCommonFileToJSON)),
         'run_thread_id': value['runThreadId'],
         'owner': UserInfoToJSON(value['owner']),
         'created_at': value['createdAt'].toISOString(),

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

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import type { InputSnapshot } from './InputSnapshot';
+import type { ExcludedCommonFile } from './ExcludedCommonFile';
 import type { InstructionSnapshot } from './InstructionSnapshot';
 /**
  * Frozen workflow configuration captured at trigger time.
@@ -49,6 +50,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}

package/dist/esm/models/WorkflowRunSnapshot.js

@@ -12,6 +12,7 @@
  * Do not edit the class manually.
  */
 import { InputSnapshotFromJSON, InputSnapshotToJSON, } from './InputSnapshot';
+import { ExcludedCommonFileFromJSON, ExcludedCommonFileToJSON, } from './ExcludedCommonFile';
 import { InstructionSnapshotFromJSON, InstructionSnapshotToJSON, } from './InstructionSnapshot';
 export const WorkflowRunSnapshotPropertyValidationAttributesMap = {
     userMessage: {
@@ -44,6 +45,7 @@ export function WorkflowRunSnapshotFromJSONTyped(json, ignoreDiscriminator) {
         'maxRunDurationSeconds': json['max_run_duration_seconds'],
         'instruction': InstructionSnapshotFromJSON(json['instruction']),
         'inputs': (json['inputs'].map(InputSnapshotFromJSON)),
+        'excludedCommonFiles': json['excluded_common_files'] == null ? undefined : (json['excluded_common_files'].map(ExcludedCommonFileFromJSON)),
         'userMessage': json['user_message'] == null ? undefined : json['user_message'],
     };
 }
@@ -59,6 +61,7 @@ export function WorkflowRunSnapshotToJSONTyped(value, ignoreDiscriminator = fals
         'max_run_duration_seconds': value['maxRunDurationSeconds'],
         'instruction': InstructionSnapshotToJSON(value['instruction']),
         'inputs': (value['inputs'].map(InputSnapshotToJSON)),
+        'excluded_common_files': value['excludedCommonFiles'] == null ? undefined : (value['excludedCommonFiles'].map(ExcludedCommonFileToJSON)),
         'user_message': value['userMessage'],
     };
 }

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

@@ -45,6 +45,7 @@ export * from './ClearVersionContentsResponse';
 export * from './CloneWorkflowRunRequest';
 export * from './ColumnConfig';
 export * from './ColumnReference';
+export * from './CommonFileExclusionReason';
 export * from './ConnectionConfig';
 export * from './CreateApiConnectionRequest';
 export * from './CreateApiKeyRequest';
@@ -106,6 +107,7 @@ export * from './EnrichedCitation';
 export * from './EnrichedThreadMessageContent';
 export * from './ErrorResponse';
 export * from './EventResponse';
+export * from './ExcludedCommonFile';
 export * from './ExtractRequest';
 export * from './ExtractResponse';
 export * from './FeaturesResponse';
@@ -131,6 +133,7 @@ export * from './ImageTaxonomy';
 export * from './InformationStatistics';
 export * from './IngestDocumentResponse';
 export * from './IngestionMode';
+export * from './InputOrigin';
 export * from './InputSnapshot';
 export * from './InstantiateWorkflowTemplateRequest';
 export * from './InstructionSnapshot';

package/dist/esm/models/index.js

@@ -47,6 +47,7 @@ export * from './ClearVersionContentsResponse';
 export * from './CloneWorkflowRunRequest';
 export * from './ColumnConfig';
 export * from './ColumnReference';
+export * from './CommonFileExclusionReason';
 export * from './ConnectionConfig';
 export * from './CreateApiConnectionRequest';
 export * from './CreateApiKeyRequest';
@@ -108,6 +109,7 @@ export * from './EnrichedCitation';
 export * from './EnrichedThreadMessageContent';
 export * from './ErrorResponse';
 export * from './EventResponse';
+export * from './ExcludedCommonFile';
 export * from './ExtractRequest';
 export * from './ExtractResponse';
 export * from './FeaturesResponse';
@@ -133,6 +135,7 @@ export * from './ImageTaxonomy';
 export * from './InformationStatistics';
 export * from './IngestDocumentResponse';
 export * from './IngestionMode';
+export * from './InputOrigin';
 export * from './InputSnapshot';
 export * from './InstantiateWorkflowTemplateRequest';
 export * from './InstructionSnapshot';