@livechat/platform-workflows 0.1.8 → 0.44.0-beta.v1

package/dist/domain.d.mts

@@ -0,0 +1,298 @@
+import { Workflow, WorkflowCore, WorkflowTask, WorkflowTriggerDto, WorkflowElement, WorkflowIntrospection, WorkflowTrigger, WorkflowExecutionTriggerData, WorkflowExecutionTaskData, WorkflowTaskIntrospection, WorkflowExecution, CredentialDto, DeepPartial, WorkflowDto, ProductDto } from '@livechat/developer-studio-api';
+export { AccountDto, DeepPartial, IntegrationNames, ProductDto } from '@livechat/developer-studio-api';
+import { S as Specification, g as WorkflowItemConfig, A as WorkflowItemConfigBase, k as WorkflowItemCustomization, f as WorkflowItemSpecificationRef, a as WorkflowDomain, i as WorkflowItemSpecification, d as WorkflowReferenceDefinition } from './types-BSdHiBvO.mjs';
+import { FieldErrors } from '@rjsf/utils';
+import { ErrorObject } from 'ajv';
+import { JSONSchema7 } from 'json-schema';
+export * from '@livechat/developer-studio-api/workflow-contracts';
+
+interface BuildWorkflowResult {
+    workflow: Workflow;
+    errors: string[];
+}
+declare function buildWorkflowFromLight(input: WorkflowCore, spec?: Specification): BuildWorkflowResult;
+
+declare enum WorkflowElementActionType {
+    AddTrigger = "add_trigger",
+    SwitchTrigger = "switch_trigger",
+    AddToTrigger = "add_to_trigger"
+}
+interface WorkflowElementAction {
+    type: WorkflowElementActionType;
+    referenceName?: string;
+}
+type WorkflowElementActions = Record<string, WorkflowElementAction>;
+
+type WorkflowConfigs = Record<string, WorkflowItemConfig>;
+type WorkflowElementSpecification<TData> = WorkflowItemConfigBase<TData>['specifications']['versions'][string];
+type WorkflowElementCustomization = WorkflowItemCustomization & {
+    providerDisplay: string;
+    productDisplay?: string;
+};
+type WorkflowElementConfig<TData> = Omit<WorkflowItemConfigBase<TData>, 'specifications' | 'customization'> & {
+    customization: WorkflowElementCustomization;
+    specification: WorkflowElementSpecification<TData>;
+};
+
+interface WorkflowElementSuggestion {
+    value: string;
+    isNotConfirmed?: boolean;
+    contextMatch?: boolean;
+}
+type WorkflowElementSuggestions = Record<string, WorkflowElementSuggestion[]>;
+
+type FieldErrorObject = ErrorObject & {
+    severity?: 'error' | 'warning';
+};
+type FieldErrorsExtended = FieldErrors & {
+    __errorsExtended?: FieldErrorObject[];
+    __errorsByKeyword?: Record<string, FieldErrorObject>;
+};
+type ErrorSchema<T = unknown> = FieldErrorsExtended & {
+    [key in keyof T]?: T[key] extends (infer U)[] ? Record<string, ErrorSchema<U>> & FieldErrorsExtended : ErrorSchema<T[key]>;
+};
+type ErrorSchemaExtended<T = unknown> = ErrorSchema<T> & {
+    __allErrors?: FieldErrorObject[];
+};
+
+interface WorkflowElementAssetReference {
+    taskName: string;
+    ref: WorkflowItemSpecificationRef<string>;
+}
+interface WorkflowElementAsset {
+    reference: WorkflowElementAssetReference;
+    resource?: WorkflowElementAssetReference;
+    isNotConfirmed?: boolean;
+    subject?: WorkflowDomain;
+}
+type WorkflowElementAssets = Record<string, WorkflowElementAsset[]>;
+
+declare function mergeAssets(prevAssets: WorkflowElementAssets, newAssets: WorkflowElementAssets): WorkflowElementAssets;
+declare const getTriggerAssets: (trigger: WorkflowTriggerDto, specification: WorkflowItemSpecification) => WorkflowElementAssets;
+declare const getTaskAssets: (task: WorkflowTask, specification: WorkflowItemSpecification, prevAssets: WorkflowElementAssets) => WorkflowElementAssets;
+
+interface ObjectMeta {
+    properties: Record<string, JSONSchema7 | null>;
+}
+type ObjectWithMeta = object & {
+    __meta: ObjectMeta;
+};
+
+type WorkflowFrameMeta = ObjectMeta & {
+    index: number;
+    basePath: string;
+    credentialId?: string;
+    contentBasePath: string | null;
+    config: {
+        stale: boolean;
+        specification: WorkflowItemSpecification;
+        customization: WorkflowItemCustomization;
+    };
+};
+type WorkflowElementFrame<TContent = unknown> = TContent & {
+    __meta: WorkflowFrameMeta;
+};
+type WorkflowInputFrame = WorkflowElementFrame<Record<string, string> | {
+    body?: ObjectWithMeta;
+}>;
+type WorkflowTaskFrame = WorkflowElementFrame<{
+    output?: ObjectWithMeta;
+}>;
+interface WorkflowFrames {
+    input?: WorkflowInputFrame;
+}
+type WorkflowFrame = WorkflowInputFrame | WorkflowTaskFrame;
+interface WorkflowFrameReference {
+    value: string;
+    targetValue: string;
+    path?: string | null;
+    relativePath?: string | null;
+    name: string;
+    displayName: string;
+    type: string;
+    displayType: string | string[];
+    example?: string | number | boolean | object;
+    description?: string;
+    outcome?: unknown;
+    schema: JSONSchema7 | undefined;
+    reference: WorkflowReferenceDefinition | undefined;
+    invalid?: boolean;
+    invalidReason?: string;
+    invalidLevel?: 'error' | 'warning';
+    source: {
+        index?: number;
+        reference?: string;
+        credentialId?: string;
+        customization?: WorkflowItemCustomization;
+    };
+}
+type WorkflowElementEnvironment = {
+    workflow: WorkflowFrames;
+} & Record<string, WorkflowTaskFrame | undefined>;
+
+declare function getWorkflowElementConfig<TElement extends WorkflowElement>(elementData: TElement, workflowIntrospection: WorkflowIntrospection, specification: Specification, environment?: WorkflowElementEnvironment): WorkflowElementConfig<TElement>;
+
+interface WorkflowElementExecution<TTaskData, TTaskExecutionData = unknown> {
+    isSuccess: boolean;
+    timestamp: string | undefined;
+    data: NonNullable<TTaskExecutionData>;
+    runtimeData: TTaskData | undefined;
+}
+
+declare function createFrameReferenceByContext(path: string, context: WorkflowElementContext | undefined): WorkflowFrameReference;
+declare function createFrameReferenceByEnvironment(path: string, environment: WorkflowElementEnvironment | undefined): WorkflowFrameReference;
+declare const createFrameReference: (path: string, frame: WorkflowTaskFrame | WorkflowInputFrame | undefined, options?: {
+    supportAdditionalItems?: boolean;
+}) => WorkflowFrameReference;
+
+interface ElementState<TElementData, TElementExecutionData = unknown> {
+    definition: TElementData;
+    execution: TElementExecutionData | undefined;
+}
+type WorkflowTriggerState = ElementState<WorkflowTrigger, WorkflowExecutionTriggerData>;
+type WorkflowTaskState<TTask extends WorkflowTask = WorkflowTask> = ElementState<TTask, Extract<WorkflowExecutionTaskData, {
+    taskType: TTask['type'];
+}>>;
+type WorkflowElementState = WorkflowTriggerState | WorkflowTaskState;
+type WorkflowExecutionElement = WorkflowElementExecution<WorkflowElementState['definition'], WorkflowElementState['execution']>;
+interface WorkflowElementContextBase<TElement extends WorkflowElementState> {
+    index: number;
+    data: TElement['definition'];
+    config: WorkflowElementConfig<TElement['definition']>;
+    execution?: WorkflowElementExecution<TElement['definition'], TElement['execution']>;
+    frame?: WorkflowElementFrame;
+    environment: WorkflowElementEnvironment;
+    assets?: WorkflowElementAssets;
+    suggestions?: WorkflowElementSuggestions;
+    actions?: WorkflowElementActions;
+    errors?: ErrorSchemaExtended<TElement['definition']>;
+}
+type WorkflowTriggerContext = WorkflowElementContextBase<WorkflowTriggerState> & {
+    frame?: WorkflowInputFrame;
+};
+type WorkflowTaskContext<TTask extends WorkflowTask = WorkflowTask> = WorkflowElementContextBase<WorkflowTaskState<TTask>> & {
+    introspection: WorkflowTaskIntrospection | undefined;
+    frame: WorkflowTaskFrame;
+};
+type WorkflowElementContext = WorkflowTriggerContext | WorkflowTaskContext;
+interface WorkflowContexts {
+    trigger?: WorkflowTriggerContext;
+    tasks: Record<string, WorkflowTaskContext>;
+    global: WorkflowTaskContext;
+}
+
+declare const getWorkflowTaskActions: (config: WorkflowElementConfig<WorkflowTask>, suggestions: WorkflowElementSuggestions, trigger: WorkflowTriggerContext | undefined) => WorkflowElementActions;
+
+declare const getWorkflowContexts: (workflow: Workflow, sources?: {
+    introspection?: WorkflowIntrospection;
+    execution?: WorkflowExecution;
+}, dependencies?: {
+    specification?: Specification;
+}) => WorkflowContexts;
+
+type WorkflowCredential = CredentialDto & {
+    isInternal: boolean;
+};
+
+declare const getWorkflowCredentials: (credentials: CredentialDto[]) => WorkflowCredential[];
+declare const getWorkflowElementDefaultCredentialId: (elementProvider: string, credentials: WorkflowCredential[]) => string | undefined;
+
+/**
+ * Merges a partial change into the workflow and normalizes `join` tasks'
+ * `joinOn` to point at the last task of each matching `forkJoin` branch.
+ *
+ * Assumes the caller owns `workflow` (the editor and `prefillWorkflow` clone at
+ * their boundary); `mergeDeep` writes into the first argument.
+ */
+declare function applyChange<TWorkflow extends Workflow>(workflow: TWorkflow, change: DeepPartial<TWorkflow>): TWorkflow;
+/**
+ * Assigns default credentials to the trigger and every (possibly nested) task.
+ * Assumes the caller owns `workflow` (mutates element credential slots in place).
+ */
+declare function applyDefaultCredentials<TWorkflow extends Workflow>(workflow: TWorkflow, context: {
+    specification: Specification;
+    introspection: WorkflowIntrospection;
+    credentials: WorkflowCredential[];
+}): TWorkflow;
+/**
+ * Re-points / auto-fills the resource-kind input references of the workflow's
+ * tasks against the assets reachable from upstream tasks and the trigger:
+ *
+ * - an empty resource input with exactly one candidate asset is auto-filled,
+ * - a stale tag whose previously-bound asset moved is re-pointed to the
+ *   equivalent current asset (using `previousContexts`),
+ * - a tag whose asset no longer exists is cleared.
+ *
+ * This is the same engine the editor runs on every `updateWorkflow`; pass the
+ * contexts of the pre-change workflow as `previousContexts`. Assumes the caller
+ * owns `workflow` (task input slots are mutated in place).
+ */
+declare function applyWorkflowAssetBindings<TWorkflow extends Workflow>(workflow: TWorkflow, context: {
+    specification: Specification;
+    introspection: WorkflowIntrospection;
+}, previousContexts: WorkflowContexts): TWorkflow;
+/**
+ * Runs the full prefill over a workflow, headless (no React):
+ *
+ *   1. structural normalization (`applyChange`),
+ *   2. default credentials per element (`applyDefaultCredentials`),
+ *   3. automatching of resource references (`applyWorkflowAssetBindings`),
+ *      reproducing the effect the editor applies on every update.
+ *
+ * Pure: clones the input, so the passed workflow is never mutated. Returns the
+ * level it was given — a stored `WorkflowDto` stays a `WorkflowDto`.
+ */
+declare function prefillWorkflow<TWorkflow extends Workflow>(workflow: TWorkflow, sources: {
+    introspection?: WorkflowIntrospection;
+}, dependencies: {
+    credentials: WorkflowCredential[];
+    specification?: Specification;
+}): TWorkflow;
+
+/**
+ * Transforms the (multiply-nested) task tree into a new task tree. The reducer
+ * is called for every task; returning a value REPLACES the default handling of
+ * that task (and skips recursion into its children), returning `undefined`
+ * keeps the task and recurses into `switch` / `forkJoin` / `doWhile` children.
+ * The return type is intrinsically `WorkflowTask[]` because the
+ * default branches rebuild the typed nested fields (`decisionCases`,
+ * `forkTasks`, `loopOver`). Use `reduceTasksRecursively` to fold into `T`.
+ */
+declare function recursiveTaskReducer(tasks: WorkflowTask[], reducer: (result: WorkflowTask[], task: WorkflowTask, taskIndex: number, allTasks: WorkflowTask[], level: number) => WorkflowTask[] | undefined, level?: number): WorkflowTask[];
+/**
+ * Generic depth-first fold over the (multiply-nested) task tree. Unlike
+ * `recursiveTaskReducer` it does NOT rebuild the tree — it threads an
+ * accumulator of arbitrary type `T` through every task at every nesting level
+ * (descending into `switch`, `forkJoin` and `doWhile` children) and returns
+ * whatever the reducer accumulates. Use this for collecting/aggregating;
+ * use `recursiveTaskReducer` when you need to transform the tree itself.
+ */
+declare function reduceTasksRecursively<T>(tasks: WorkflowTask[], reducer: (accumulator: T, task: WorkflowTask, taskIndex: number, allTasks: WorkflowTask[], level: number) => T, initialValue: T, level?: number): T;
+
+declare enum WorkflowValidationErrorType {
+    Schema = "schema",
+    Resolver = "resolver",
+    Connection = "connection",
+    Activation = "activation",
+    Execution = "execution",
+    Stale = "stale"
+}
+interface WorkflowValidation {
+    isValid: boolean;
+    raw: ErrorSchema<WorkflowDto>;
+    errors: {
+        trigger?: ErrorSchemaExtended<WorkflowTriggerDto>;
+        tasks: Record<string, ErrorSchemaExtended<WorkflowTask>>;
+        all: Record<string, ErrorSchemaExtended | undefined>;
+    };
+}
+
+declare function validateWorkflow(workflow: Workflow, sources: {
+    introspection?: WorkflowIntrospection;
+}, dependencies: {
+    credentials: CredentialDto[];
+    products: ProductDto[];
+    specification?: Specification;
+}): WorkflowValidation;
+
+export { type BuildWorkflowResult, type WorkflowConfigs, type WorkflowContexts, type WorkflowCredential, type WorkflowElementAction, WorkflowElementActionType, type WorkflowElementActions, type WorkflowElementAsset, type WorkflowElementAssetReference, type WorkflowElementAssets, type WorkflowElementConfig, type WorkflowElementContext, type WorkflowElementContextBase, type WorkflowElementCustomization, type WorkflowElementEnvironment, type WorkflowElementExecution, type WorkflowElementFrame, type WorkflowElementSpecification, type WorkflowElementState, type WorkflowElementSuggestion, type WorkflowElementSuggestions, type WorkflowExecutionElement, type WorkflowFrame, type WorkflowFrameReference, type WorkflowFrames, type WorkflowInputFrame, type WorkflowTaskContext, type WorkflowTaskFrame, type WorkflowTaskState, type WorkflowTriggerContext, type WorkflowTriggerState, type WorkflowValidation, WorkflowValidationErrorType, applyChange, applyDefaultCredentials, applyWorkflowAssetBindings, buildWorkflowFromLight, createFrameReference, createFrameReferenceByContext, createFrameReferenceByEnvironment, getTaskAssets, getTriggerAssets, getWorkflowContexts, getWorkflowCredentials, getWorkflowElementConfig, getWorkflowElementDefaultCredentialId, getWorkflowTaskActions, mergeAssets, prefillWorkflow, recursiveTaskReducer, reduceTasksRecursively, validateWorkflow };

package/dist/domain.d.ts

@@ -0,0 +1,298 @@
+import { Workflow, WorkflowCore, WorkflowTask, WorkflowTriggerDto, WorkflowElement, WorkflowIntrospection, WorkflowTrigger, WorkflowExecutionTriggerData, WorkflowExecutionTaskData, WorkflowTaskIntrospection, WorkflowExecution, CredentialDto, DeepPartial, WorkflowDto, ProductDto } from '@livechat/developer-studio-api';
+export { AccountDto, DeepPartial, IntegrationNames, ProductDto } from '@livechat/developer-studio-api';
+import { S as Specification, g as WorkflowItemConfig, A as WorkflowItemConfigBase, k as WorkflowItemCustomization, f as WorkflowItemSpecificationRef, a as WorkflowDomain, i as WorkflowItemSpecification, d as WorkflowReferenceDefinition } from './types-BSdHiBvO.js';
+import { FieldErrors } from '@rjsf/utils';
+import { ErrorObject } from 'ajv';
+import { JSONSchema7 } from 'json-schema';
+export * from '@livechat/developer-studio-api/workflow-contracts';
+
+interface BuildWorkflowResult {
+    workflow: Workflow;
+    errors: string[];
+}
+declare function buildWorkflowFromLight(input: WorkflowCore, spec?: Specification): BuildWorkflowResult;
+
+declare enum WorkflowElementActionType {
+    AddTrigger = "add_trigger",
+    SwitchTrigger = "switch_trigger",
+    AddToTrigger = "add_to_trigger"
+}
+interface WorkflowElementAction {
+    type: WorkflowElementActionType;
+    referenceName?: string;
+}
+type WorkflowElementActions = Record<string, WorkflowElementAction>;
+
+type WorkflowConfigs = Record<string, WorkflowItemConfig>;
+type WorkflowElementSpecification<TData> = WorkflowItemConfigBase<TData>['specifications']['versions'][string];
+type WorkflowElementCustomization = WorkflowItemCustomization & {
+    providerDisplay: string;
+    productDisplay?: string;
+};
+type WorkflowElementConfig<TData> = Omit<WorkflowItemConfigBase<TData>, 'specifications' | 'customization'> & {
+    customization: WorkflowElementCustomization;
+    specification: WorkflowElementSpecification<TData>;
+};
+
+interface WorkflowElementSuggestion {
+    value: string;
+    isNotConfirmed?: boolean;
+    contextMatch?: boolean;
+}
+type WorkflowElementSuggestions = Record<string, WorkflowElementSuggestion[]>;
+
+type FieldErrorObject = ErrorObject & {
+    severity?: 'error' | 'warning';
+};
+type FieldErrorsExtended = FieldErrors & {
+    __errorsExtended?: FieldErrorObject[];
+    __errorsByKeyword?: Record<string, FieldErrorObject>;
+};
+type ErrorSchema<T = unknown> = FieldErrorsExtended & {
+    [key in keyof T]?: T[key] extends (infer U)[] ? Record<string, ErrorSchema<U>> & FieldErrorsExtended : ErrorSchema<T[key]>;
+};
+type ErrorSchemaExtended<T = unknown> = ErrorSchema<T> & {
+    __allErrors?: FieldErrorObject[];
+};
+
+interface WorkflowElementAssetReference {
+    taskName: string;
+    ref: WorkflowItemSpecificationRef<string>;
+}
+interface WorkflowElementAsset {
+    reference: WorkflowElementAssetReference;
+    resource?: WorkflowElementAssetReference;
+    isNotConfirmed?: boolean;
+    subject?: WorkflowDomain;
+}
+type WorkflowElementAssets = Record<string, WorkflowElementAsset[]>;
+
+declare function mergeAssets(prevAssets: WorkflowElementAssets, newAssets: WorkflowElementAssets): WorkflowElementAssets;
+declare const getTriggerAssets: (trigger: WorkflowTriggerDto, specification: WorkflowItemSpecification) => WorkflowElementAssets;
+declare const getTaskAssets: (task: WorkflowTask, specification: WorkflowItemSpecification, prevAssets: WorkflowElementAssets) => WorkflowElementAssets;
+
+interface ObjectMeta {
+    properties: Record<string, JSONSchema7 | null>;
+}
+type ObjectWithMeta = object & {
+    __meta: ObjectMeta;
+};
+
+type WorkflowFrameMeta = ObjectMeta & {
+    index: number;
+    basePath: string;
+    credentialId?: string;
+    contentBasePath: string | null;
+    config: {
+        stale: boolean;
+        specification: WorkflowItemSpecification;
+        customization: WorkflowItemCustomization;
+    };
+};
+type WorkflowElementFrame<TContent = unknown> = TContent & {
+    __meta: WorkflowFrameMeta;
+};
+type WorkflowInputFrame = WorkflowElementFrame<Record<string, string> | {
+    body?: ObjectWithMeta;
+}>;
+type WorkflowTaskFrame = WorkflowElementFrame<{
+    output?: ObjectWithMeta;
+}>;
+interface WorkflowFrames {
+    input?: WorkflowInputFrame;
+}
+type WorkflowFrame = WorkflowInputFrame | WorkflowTaskFrame;
+interface WorkflowFrameReference {
+    value: string;
+    targetValue: string;
+    path?: string | null;
+    relativePath?: string | null;
+    name: string;
+    displayName: string;
+    type: string;
+    displayType: string | string[];
+    example?: string | number | boolean | object;
+    description?: string;
+    outcome?: unknown;
+    schema: JSONSchema7 | undefined;
+    reference: WorkflowReferenceDefinition | undefined;
+    invalid?: boolean;
+    invalidReason?: string;
+    invalidLevel?: 'error' | 'warning';
+    source: {
+        index?: number;
+        reference?: string;
+        credentialId?: string;
+        customization?: WorkflowItemCustomization;
+    };
+}
+type WorkflowElementEnvironment = {
+    workflow: WorkflowFrames;
+} & Record<string, WorkflowTaskFrame | undefined>;
+
+declare function getWorkflowElementConfig<TElement extends WorkflowElement>(elementData: TElement, workflowIntrospection: WorkflowIntrospection, specification: Specification, environment?: WorkflowElementEnvironment): WorkflowElementConfig<TElement>;
+
+interface WorkflowElementExecution<TTaskData, TTaskExecutionData = unknown> {
+    isSuccess: boolean;
+    timestamp: string | undefined;
+    data: NonNullable<TTaskExecutionData>;
+    runtimeData: TTaskData | undefined;
+}
+
+declare function createFrameReferenceByContext(path: string, context: WorkflowElementContext | undefined): WorkflowFrameReference;
+declare function createFrameReferenceByEnvironment(path: string, environment: WorkflowElementEnvironment | undefined): WorkflowFrameReference;
+declare const createFrameReference: (path: string, frame: WorkflowTaskFrame | WorkflowInputFrame | undefined, options?: {
+    supportAdditionalItems?: boolean;
+}) => WorkflowFrameReference;
+
+interface ElementState<TElementData, TElementExecutionData = unknown> {
+    definition: TElementData;
+    execution: TElementExecutionData | undefined;
+}
+type WorkflowTriggerState = ElementState<WorkflowTrigger, WorkflowExecutionTriggerData>;
+type WorkflowTaskState<TTask extends WorkflowTask = WorkflowTask> = ElementState<TTask, Extract<WorkflowExecutionTaskData, {
+    taskType: TTask['type'];
+}>>;
+type WorkflowElementState = WorkflowTriggerState | WorkflowTaskState;
+type WorkflowExecutionElement = WorkflowElementExecution<WorkflowElementState['definition'], WorkflowElementState['execution']>;
+interface WorkflowElementContextBase<TElement extends WorkflowElementState> {
+    index: number;
+    data: TElement['definition'];
+    config: WorkflowElementConfig<TElement['definition']>;
+    execution?: WorkflowElementExecution<TElement['definition'], TElement['execution']>;
+    frame?: WorkflowElementFrame;
+    environment: WorkflowElementEnvironment;
+    assets?: WorkflowElementAssets;
+    suggestions?: WorkflowElementSuggestions;
+    actions?: WorkflowElementActions;
+    errors?: ErrorSchemaExtended<TElement['definition']>;
+}
+type WorkflowTriggerContext = WorkflowElementContextBase<WorkflowTriggerState> & {
+    frame?: WorkflowInputFrame;
+};
+type WorkflowTaskContext<TTask extends WorkflowTask = WorkflowTask> = WorkflowElementContextBase<WorkflowTaskState<TTask>> & {
+    introspection: WorkflowTaskIntrospection | undefined;
+    frame: WorkflowTaskFrame;
+};
+type WorkflowElementContext = WorkflowTriggerContext | WorkflowTaskContext;
+interface WorkflowContexts {
+    trigger?: WorkflowTriggerContext;
+    tasks: Record<string, WorkflowTaskContext>;
+    global: WorkflowTaskContext;
+}
+
+declare const getWorkflowTaskActions: (config: WorkflowElementConfig<WorkflowTask>, suggestions: WorkflowElementSuggestions, trigger: WorkflowTriggerContext | undefined) => WorkflowElementActions;
+
+declare const getWorkflowContexts: (workflow: Workflow, sources?: {
+    introspection?: WorkflowIntrospection;
+    execution?: WorkflowExecution;
+}, dependencies?: {
+    specification?: Specification;
+}) => WorkflowContexts;
+
+type WorkflowCredential = CredentialDto & {
+    isInternal: boolean;
+};
+
+declare const getWorkflowCredentials: (credentials: CredentialDto[]) => WorkflowCredential[];
+declare const getWorkflowElementDefaultCredentialId: (elementProvider: string, credentials: WorkflowCredential[]) => string | undefined;
+
+/**
+ * Merges a partial change into the workflow and normalizes `join` tasks'
+ * `joinOn` to point at the last task of each matching `forkJoin` branch.
+ *
+ * Assumes the caller owns `workflow` (the editor and `prefillWorkflow` clone at
+ * their boundary); `mergeDeep` writes into the first argument.
+ */
+declare function applyChange<TWorkflow extends Workflow>(workflow: TWorkflow, change: DeepPartial<TWorkflow>): TWorkflow;
+/**
+ * Assigns default credentials to the trigger and every (possibly nested) task.
+ * Assumes the caller owns `workflow` (mutates element credential slots in place).
+ */
+declare function applyDefaultCredentials<TWorkflow extends Workflow>(workflow: TWorkflow, context: {
+    specification: Specification;
+    introspection: WorkflowIntrospection;
+    credentials: WorkflowCredential[];
+}): TWorkflow;
+/**
+ * Re-points / auto-fills the resource-kind input references of the workflow's
+ * tasks against the assets reachable from upstream tasks and the trigger:
+ *
+ * - an empty resource input with exactly one candidate asset is auto-filled,
+ * - a stale tag whose previously-bound asset moved is re-pointed to the
+ *   equivalent current asset (using `previousContexts`),
+ * - a tag whose asset no longer exists is cleared.
+ *
+ * This is the same engine the editor runs on every `updateWorkflow`; pass the
+ * contexts of the pre-change workflow as `previousContexts`. Assumes the caller
+ * owns `workflow` (task input slots are mutated in place).
+ */
+declare function applyWorkflowAssetBindings<TWorkflow extends Workflow>(workflow: TWorkflow, context: {
+    specification: Specification;
+    introspection: WorkflowIntrospection;
+}, previousContexts: WorkflowContexts): TWorkflow;
+/**
+ * Runs the full prefill over a workflow, headless (no React):
+ *
+ *   1. structural normalization (`applyChange`),
+ *   2. default credentials per element (`applyDefaultCredentials`),
+ *   3. automatching of resource references (`applyWorkflowAssetBindings`),
+ *      reproducing the effect the editor applies on every update.
+ *
+ * Pure: clones the input, so the passed workflow is never mutated. Returns the
+ * level it was given — a stored `WorkflowDto` stays a `WorkflowDto`.
+ */
+declare function prefillWorkflow<TWorkflow extends Workflow>(workflow: TWorkflow, sources: {
+    introspection?: WorkflowIntrospection;
+}, dependencies: {
+    credentials: WorkflowCredential[];
+    specification?: Specification;
+}): TWorkflow;
+
+/**
+ * Transforms the (multiply-nested) task tree into a new task tree. The reducer
+ * is called for every task; returning a value REPLACES the default handling of
+ * that task (and skips recursion into its children), returning `undefined`
+ * keeps the task and recurses into `switch` / `forkJoin` / `doWhile` children.
+ * The return type is intrinsically `WorkflowTask[]` because the
+ * default branches rebuild the typed nested fields (`decisionCases`,
+ * `forkTasks`, `loopOver`). Use `reduceTasksRecursively` to fold into `T`.
+ */
+declare function recursiveTaskReducer(tasks: WorkflowTask[], reducer: (result: WorkflowTask[], task: WorkflowTask, taskIndex: number, allTasks: WorkflowTask[], level: number) => WorkflowTask[] | undefined, level?: number): WorkflowTask[];
+/**
+ * Generic depth-first fold over the (multiply-nested) task tree. Unlike
+ * `recursiveTaskReducer` it does NOT rebuild the tree — it threads an
+ * accumulator of arbitrary type `T` through every task at every nesting level
+ * (descending into `switch`, `forkJoin` and `doWhile` children) and returns
+ * whatever the reducer accumulates. Use this for collecting/aggregating;
+ * use `recursiveTaskReducer` when you need to transform the tree itself.
+ */
+declare function reduceTasksRecursively<T>(tasks: WorkflowTask[], reducer: (accumulator: T, task: WorkflowTask, taskIndex: number, allTasks: WorkflowTask[], level: number) => T, initialValue: T, level?: number): T;
+
+declare enum WorkflowValidationErrorType {
+    Schema = "schema",
+    Resolver = "resolver",
+    Connection = "connection",
+    Activation = "activation",
+    Execution = "execution",
+    Stale = "stale"
+}
+interface WorkflowValidation {
+    isValid: boolean;
+    raw: ErrorSchema<WorkflowDto>;
+    errors: {
+        trigger?: ErrorSchemaExtended<WorkflowTriggerDto>;
+        tasks: Record<string, ErrorSchemaExtended<WorkflowTask>>;
+        all: Record<string, ErrorSchemaExtended | undefined>;
+    };
+}
+
+declare function validateWorkflow(workflow: Workflow, sources: {
+    introspection?: WorkflowIntrospection;
+}, dependencies: {
+    credentials: CredentialDto[];
+    products: ProductDto[];
+    specification?: Specification;
+}): WorkflowValidation;
+
+export { type BuildWorkflowResult, type WorkflowConfigs, type WorkflowContexts, type WorkflowCredential, type WorkflowElementAction, WorkflowElementActionType, type WorkflowElementActions, type WorkflowElementAsset, type WorkflowElementAssetReference, type WorkflowElementAssets, type WorkflowElementConfig, type WorkflowElementContext, type WorkflowElementContextBase, type WorkflowElementCustomization, type WorkflowElementEnvironment, type WorkflowElementExecution, type WorkflowElementFrame, type WorkflowElementSpecification, type WorkflowElementState, type WorkflowElementSuggestion, type WorkflowElementSuggestions, type WorkflowExecutionElement, type WorkflowFrame, type WorkflowFrameReference, type WorkflowFrames, type WorkflowInputFrame, type WorkflowTaskContext, type WorkflowTaskFrame, type WorkflowTaskState, type WorkflowTriggerContext, type WorkflowTriggerState, type WorkflowValidation, WorkflowValidationErrorType, applyChange, applyDefaultCredentials, applyWorkflowAssetBindings, buildWorkflowFromLight, createFrameReference, createFrameReferenceByContext, createFrameReferenceByEnvironment, getTaskAssets, getTriggerAssets, getWorkflowContexts, getWorkflowCredentials, getWorkflowElementConfig, getWorkflowElementDefaultCredentialId, getWorkflowTaskActions, mergeAssets, prefillWorkflow, recursiveTaskReducer, reduceTasksRecursively, validateWorkflow };