@crewx/workflow 0.3.22-rc.15 → 0.3.22-rc.150

package/dist/src/workflow-persistence.d.ts

@@ -0,0 +1,48 @@
+import type { JsonObject, UiAuditSnapshotInput, UiInstance } from '@crewx/sdk';
+import { type WorkflowApprovalState } from './card-state.js';
+import { type WorkflowParentLifecycleChange, type WorkflowParentPersistTaskRepository, type WorkflowParentTaskKind } from './parent-task-sync.js';
+import type { RunExecution, WorkflowSpec } from './types.js';
+export interface WorkflowAuditSnapshotStore {
+    get(instanceId: string): UiInstance | null;
+    updateAuditSnapshot(input: UiAuditSnapshotInput): UiInstance | null;
+}
+export interface WorkflowPersistenceProjectionResult {
+    runId: string;
+    changedParentTaskIds: string[];
+    projectedAuditInstanceIds: string[];
+    errors: string[];
+}
+export interface WorkflowAuditSnapshotChange {
+    instanceId: string;
+    before: JsonObject;
+    after: WorkflowApprovalState;
+}
+export interface WorkflowPersistenceProjectionPreview {
+    runId: string;
+    runStatus: NonNullable<RunExecution['status']>;
+    parentChanges: WorkflowParentLifecycleChange[];
+    auditSnapshotChanges: WorkflowAuditSnapshotChange[];
+    errors: string[];
+}
+export interface WorkflowPersistenceProjectionPreviewOptions {
+    taskRepo: Pick<WorkflowParentPersistTaskRepository, 'findWorkflowParentTask'>;
+    workspaceId: string;
+    resolveWorkflowSpec: (run: RunExecution) => WorkflowSpec | null | undefined;
+    uiInstanceStore?: Pick<WorkflowAuditSnapshotStore, 'get'>;
+    getUiInstanceStore?: () => Pick<WorkflowAuditSnapshotStore, 'get'>;
+    parentKinds?: readonly WorkflowParentTaskKind[];
+}
+export interface WorkflowPersistenceProjectionOptions {
+    taskRepo: WorkflowParentPersistTaskRepository;
+    workspaceId: string;
+    resolveWorkflowSpec: (run: RunExecution) => WorkflowSpec | null | undefined;
+    uiInstanceStore?: WorkflowAuditSnapshotStore;
+    getUiInstanceStore?: () => WorkflowAuditSnapshotStore;
+    parentKinds?: readonly WorkflowParentTaskKind[];
+    onChanged?: (result: WorkflowPersistenceProjectionResult) => void;
+    warn?: (message: string) => void;
+}
+export type WorkflowPersistenceProjection = (run: RunExecution) => WorkflowPersistenceProjectionResult;
+export declare function createWorkflowPersistenceProjection(options: WorkflowPersistenceProjectionOptions): WorkflowPersistenceProjection;
+export declare function previewWorkflowPersistenceProjection(options: WorkflowPersistenceProjectionPreviewOptions, run: RunExecution): WorkflowPersistenceProjectionPreview;
+//# sourceMappingURL=workflow-persistence.d.ts.map

package/dist/src/workflow-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-persistence.d.ts","sourceRoot":"","sources":["../../src/workflow-persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,UAAU,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAA8B,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAGL,KAAK,6BAA6B,EAGlC,KAAK,mCAAmC,EACxC,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG7D,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAC3C,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,UAAU,GAAG,IAAI,CAAC;CACrE;AAED,MAAM,WAAW,mCAAmC;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED,MAAM,WAAW,oCAAoC;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,aAAa,EAAE,6BAA6B,EAAE,CAAC;IAC/C,oBAAoB,EAAE,2BAA2B,EAAE,CAAC;IACpD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,2CAA2C;IAC1D,QAAQ,EAAE,IAAI,CAAC,mCAAmC,EAAE,wBAAwB,CAAC,CAAC;IAC9E,WAAW,EAAE,MAAM,CAAC;IAEpB,mBAAmB,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC;IAE5E,eAAe,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;IAE1D,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;IACnE,WAAW,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,EAAE,mCAAmC,CAAC;IAC9C,WAAW,EAAE,MAAM,CAAC;IAEpB,mBAAmB,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC;IAE5E,eAAe,CAAC,EAAE,0BAA0B,CAAC;IAE7C,kBAAkB,CAAC,EAAE,MAAM,0BAA0B,CAAC;IACtD,WAAW,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAEhD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,mCAAmC,KAAK,IAAI,CAAC;IAElE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,MAAM,6BAA6B,GACvC,CAAC,GAAG,EAAE,YAAY,KAAK,mCAAmC,CAAC;AA2D7D,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,oCAAoC,GAC5C,6BAA6B,CA4G/B;AAOD,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,2CAA2C,EACpD,GAAG,EAAE,YAAY,GAChB,oCAAoC,CA+EtC"}

package/dist/src/workflow-persistence.js

@@ -0,0 +1,224 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorkflowPersistenceProjection = createWorkflowPersistenceProjection;
+exports.previewWorkflowPersistenceProjection = previewWorkflowPersistenceProjection;
+const card_state_js_1 = require("./card-state.js");
+const parent_task_sync_js_1 = require("./parent-task-sync.js");
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function asJsonObject(state) {
+    return state;
+}
+function canonicalJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map((item) => canonicalJson(item)).join(',')}]`;
+    if (value !== null && typeof value === 'object') {
+        const record = value;
+        return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${canonicalJson(record[key])}`).join(',')}}`;
+    }
+    return JSON.stringify(value) ?? 'null';
+}
+function sameJson(left, right) {
+    return canonicalJson(left) === canonicalJson(right);
+}
+function buildResult(runId, parent) {
+    return {
+        runId,
+        changedParentTaskIds: [...parent.changedParentTaskIds],
+        projectedAuditInstanceIds: [],
+        errors: [],
+    };
+}
+function createWorkflowPersistenceProjection(options) {
+    const parentSinkOptions = {
+        taskRepo: options.taskRepo,
+        workspaceId: options.workspaceId,
+        ...(options.parentKinds ? { parentKinds: options.parentKinds } : {}),
+    };
+    const parentSink = (0, parent_task_sync_js_1.createWorkflowParentPersistSink)(parentSinkOptions);
+    const warn = options.warn ?? ((message) => console.warn(message));
+    return (run) => {
+        let parent;
+        try {
+            parent = parentSink(run);
+        }
+        catch (error) {
+            const message = `workflow persistence parent projection failed for ${run.id}: ${errorMessage(error)}`;
+            warn(message);
+            return {
+                runId: run.id,
+                changedParentTaskIds: [],
+                projectedAuditInstanceIds: [],
+                errors: [message],
+            };
+        }
+        const result = buildResult(run.id, parent);
+        const addError = (stage, error) => {
+            const message = `workflow persistence ${stage} failed for ${run.id}: ${errorMessage(error)}`;
+            result.errors.push(message);
+            warn(message);
+        };
+        const instanceIds = [...new Set(parent.linkedAuditInstanceIds)];
+        if (instanceIds.length > 0) {
+            let spec;
+            try {
+                spec = options.resolveWorkflowSpec(run);
+                if (!spec)
+                    throw new Error(`workflow spec not found for ${run.workflow_id}`);
+            }
+            catch (error) {
+                addError('spec resolution', error);
+            }
+            if (spec) {
+                let state = null;
+                try {
+                    state = (0, card_state_js_1.buildWorkflowApprovalState)(run, spec);
+                }
+                catch (error) {
+                    addError('audit state build', error);
+                }
+                if (state) {
+                    const updatedAt = Date.parse(run.updated_at);
+                    if (!Number.isSafeInteger(updatedAt) || updatedAt < 0) {
+                        addError('audit snapshot', new Error(`invalid run updated_at: ${run.updated_at}`));
+                    }
+                    else {
+                        let store = options.uiInstanceStore;
+                        if (!store && options.getUiInstanceStore) {
+                            try {
+                                store = options.getUiInstanceStore();
+                            }
+                            catch (error) {
+                                addError('audit store creation', error);
+                            }
+                        }
+                        if (!store) {
+                            addError('audit snapshot', new Error('no UiInstanceStore was provided'));
+                        }
+                        else {
+                            for (const instanceId of instanceIds) {
+                                try {
+                                    const instance = store.get(instanceId);
+                                    const domainRunId = instance?.domainRef?.workflowRunId;
+                                    if (!instance
+                                        || instance.workspaceId !== options.workspaceId
+                                        || domainRunId !== run.id) {
+                                        continue;
+                                    }
+                                    const beforeState = canonicalJson(instance.state);
+                                    const beforeUpdatedAt = instance.updatedAt;
+                                    const updatedInstance = store.updateAuditSnapshot({
+                                        instanceId,
+                                        workspaceId: options.workspaceId,
+                                        updatedAt,
+                                        state: asJsonObject(state),
+                                    });
+                                    if (updatedInstance
+                                        && (canonicalJson(updatedInstance.state) !== beforeState
+                                            || updatedInstance.updatedAt !== beforeUpdatedAt)) {
+                                        result.projectedAuditInstanceIds.push(instanceId);
+                                    }
+                                }
+                                catch (error) {
+                                    addError(`audit snapshot ${instanceId}`, error);
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        if ((result.changedParentTaskIds.length > 0 || result.projectedAuditInstanceIds.length > 0)
+            && options.onChanged) {
+            try {
+                options.onChanged(result);
+            }
+            catch (error) {
+                addError('change callback', error);
+            }
+        }
+        return result;
+    };
+}
+function previewWorkflowPersistenceProjection(options, run) {
+    const parent = (0, parent_task_sync_js_1.previewWorkflowParentRepair)({
+        taskRepo: options.taskRepo,
+        run,
+        workspaceId: options.workspaceId,
+        ...(options.parentKinds ? { parentKinds: options.parentKinds } : {}),
+    });
+    const result = {
+        runId: run.id,
+        runStatus: parent.runStatus,
+        parentChanges: [...parent.changes],
+        auditSnapshotChanges: [],
+        errors: [],
+    };
+    const addError = (stage, error) => {
+        result.errors.push(`workflow persistence preview ${stage} failed for ${run.id}: ${errorMessage(error)}`);
+    };
+    const instanceIds = [...new Set(parent.linkedAuditInstanceIds)];
+    if (instanceIds.length === 0)
+        return result;
+    let spec;
+    try {
+        spec = options.resolveWorkflowSpec(run);
+        if (!spec)
+            throw new Error(`workflow spec not found for ${run.workflow_id}`);
+    }
+    catch (error) {
+        addError('spec resolution', error);
+    }
+    if (!spec)
+        return result;
+    let state;
+    try {
+        state = (0, card_state_js_1.buildWorkflowApprovalState)(run, spec);
+    }
+    catch (error) {
+        addError('audit state build', error);
+        return result;
+    }
+    const updatedAt = Date.parse(run.updated_at);
+    if (!Number.isSafeInteger(updatedAt) || updatedAt < 0) {
+        addError('audit snapshot', new Error(`invalid run updated_at: ${run.updated_at}`));
+        return result;
+    }
+    let store = options.uiInstanceStore;
+    if (!store && options.getUiInstanceStore) {
+        try {
+            store = options.getUiInstanceStore();
+        }
+        catch (error) {
+            addError('audit store creation', error);
+        }
+    }
+    if (!store) {
+        addError('audit snapshot', new Error('no UiInstanceStore was provided'));
+        return result;
+    }
+    for (const instanceId of instanceIds) {
+        try {
+            const instance = store.get(instanceId);
+            if (!instance
+                || instance.workspaceId !== options.workspaceId
+                || instance.domainRef.workflowRunId !== run.id) {
+                continue;
+            }
+            if (!sameJson(instance.state, state)) {
+                result.auditSnapshotChanges.push({
+                    instanceId,
+                    before: instance.state,
+                    after: state,
+                });
+            }
+        }
+        catch (error) {
+            addError(`audit snapshot ${instanceId}`, error);
+        }
+    }
+    void updatedAt;
+    return result;
+}
+//# sourceMappingURL=workflow-persistence.js.map

package/dist/src/workflow-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-persistence.js","sourceRoot":"","sources":["../../src/workflow-persistence.ts"],"names":[],"mappings":";;AAoIA,kFA8GC;AAOD,oFAkFC;AAtUD,mDAAyF;AACzF,+DAQ+B;AA6D/B,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,YAAY,CAAC,KAA4B;IAChD,OAAO,KAA8B,CAAC;AACxC,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC3F,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC1H,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC;AACzC,CAAC;AAED,SAAS,QAAQ,CAAC,IAAa,EAAE,KAAc;IAC7C,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,WAAW,CAAC,KAAa,EAAE,MAAmC;IACrE,OAAO;QACL,KAAK;QACL,oBAAoB,EAAE,CAAC,GAAG,MAAM,CAAC,oBAAoB,CAAC;QACtD,yBAAyB,EAAE,EAAE;QAC7B,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AA6BD,SAAgB,mCAAmC,CACjD,OAA6C;IAE7C,MAAM,iBAAiB,GAAqC;QAC1D,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC;IACF,MAAM,UAAU,GAAG,IAAA,qDAA+B,EAAC,iBAAiB,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAE1E,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,IAAI,MAAmC,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,qDAAqD,GAAG,CAAC,EAAE,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACtG,IAAI,CAAC,OAAO,CAAC,CAAC;YACd,OAAO;gBACL,KAAK,EAAE,GAAG,CAAC,EAAE;gBACb,oBAAoB,EAAE,EAAE;gBACxB,yBAAyB,EAAE,EAAE;gBAC7B,MAAM,EAAE,CAAC,OAAO,CAAC;aAClB,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,KAAc,EAAQ,EAAE;YACvD,MAAM,OAAO,GAAG,wBAAwB,KAAK,eAAe,GAAG,CAAC,EAAE,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7F,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,CAAC;QAChB,CAAC,CAAC;QAEF,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAChE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,IAAqC,CAAC;YAC1C,IAAI,CAAC;gBACH,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;gBACxC,IAAI,CAAC,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YAC/E,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;YACrC,CAAC;YAED,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,KAAK,GAAiC,IAAI,CAAC;gBAC/C,IAAI,CAAC;oBACH,KAAK,GAAG,IAAA,0CAA0B,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBAChD,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACxB,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;gBACvC,CAAC;gBAED,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;oBAC7C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;wBACtD,QAAQ,CAAC,gBAAgB,EAAE,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;oBACrF,CAAC;yBAAM,CAAC;wBACN,IAAI,KAAK,GAA2C,OAAO,CAAC,eAAe,CAAC;wBAC5E,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;4BACzC,IAAI,CAAC;gCACH,KAAK,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;4BACvC,CAAC;4BAAC,OAAO,KAAc,EAAE,CAAC;gCACxB,QAAQ,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;4BAC1C,CAAC;wBACH,CAAC;wBACD,IAAI,CAAC,KAAK,EAAE,CAAC;4BACX,QAAQ,CAAC,gBAAgB,EAAE,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;wBAC3E,CAAC;6BAAM,CAAC;4BACN,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gCACrC,IAAI,CAAC;oCACH,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;oCACvC,MAAM,WAAW,GAAG,QAAQ,EAAE,SAAS,EAAE,aAAa,CAAC;oCACvD,IAAI,CAAC,QAAQ;2CACR,QAAQ,CAAC,WAAW,KAAK,OAAO,CAAC,WAAW;2CAC5C,WAAW,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC;wCAC5B,SAAS;oCACX,CAAC;oCAED,MAAM,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;oCAClD,MAAM,eAAe,GAAG,QAAQ,CAAC,SAAS,CAAC;oCAC3C,MAAM,eAAe,GAAG,KAAK,CAAC,mBAAmB,CAAC;wCAChD,UAAU;wCACV,WAAW,EAAE,OAAO,CAAC,WAAW;wCAChC,SAAS;wCACT,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC;qCAC3B,CAAC,CAAC;oCACH,IAAI,eAAe;2CACd,CAAC,aAAa,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,WAAW;+CACnD,eAAe,CAAC,SAAS,KAAK,eAAe,CAAC,EAAE,CAAC;wCACtD,MAAM,CAAC,yBAAyB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oCACpD,CAAC;gCACH,CAAC;gCAAC,OAAO,KAAc,EAAE,CAAC;oCACxB,QAAQ,CAAC,kBAAkB,UAAU,EAAE,EAAE,KAAK,CAAC,CAAC;gCAClD,CAAC;4BACH,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,yBAAyB,CAAC,MAAM,GAAG,CAAC,CAAC;eACtF,OAAO,CAAC,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAOD,SAAgB,oCAAoC,CAClD,OAAoD,EACpD,GAAiB;IAEjB,MAAM,MAAM,GAAG,IAAA,iDAA2B,EAAC;QACzC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG;QACH,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC,CAAC;IACH,MAAM,MAAM,GAAyC;QACnD,KAAK,EAAE,GAAG,CAAC,EAAE;QACb,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,aAAa,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;QAClC,oBAAoB,EAAE,EAAE;QACxB,MAAM,EAAE,EAAE;KACX,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,KAAc,EAAQ,EAAE;QACvD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,KAAK,eAAe,GAAG,CAAC,EAAE,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3G,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAChE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAE5C,IAAI,IAAqC,CAAC;IAC1C,IAAI,CAAC;QACH,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/E,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAEzB,IAAI,KAA4B,CAAC;IACjC,IAAI,CAAC;QACH,KAAK,GAAG,IAAA,0CAA0B,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QACtD,QAAQ,CAAC,gBAAgB,EAAE,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QACnF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,KAAK,GAAwD,OAAO,CAAC,eAAe,CAAC;IACzF,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,KAAK,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;QACvC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,QAAQ,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,QAAQ,CAAC,gBAAgB,EAAE,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;QACzE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACvC,IAAI,CAAC,QAAQ;mBACR,QAAQ,CAAC,WAAW,KAAK,OAAO,CAAC,WAAW;mBAC5C,QAAQ,CAAC,SAAS,CAAC,aAAa,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC;gBACjD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;gBACrC,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC;oBAC/B,UAAU;oBACV,MAAM,EAAE,QAAQ,CAAC,KAAK;oBACtB,KAAK,EAAE,KAAK;iBACb,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,QAAQ,CAAC,kBAAkB,UAAU,EAAE,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,KAAK,SAAS,CAAC;IACf,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/workflow-schema.json

@@ -56,7 +56,7 @@
       "properties": {
         "type": {
           "type": "string",
-          "enum": ["agent_task", "skill_task", "shell_task", "parallel", "join", "branch", "approval", "expression", "end"]
+          "enum": ["agent_task", "skill_task", "shell_task", "parallel", "join", "branch", "approval", "expression", "end", "error"]
         },
         "agent": {
           "type": "string"
@@ -81,7 +81,7 @@
         },
         "cwd": {
           "type": "string",
-          "description": "skill_task/shell_task: working directory, normalized and constrained under the project root."
+          "description": "agent_task/skill_task/shell_task: working directory, normalized and constrained under the project root."
         },
         "env": {
           "type": "object",
@@ -90,6 +90,10 @@
           },
           "description": "shell_task: explicit env pass-through. Dangerous keys (LD_PRELOAD, etc.) are rejected."
         },
+        "stdin": {
+          "type": "string",
+          "description": "skill_task/shell_task: optional stdin payload. Supports {{template}} interpolation."
+        },
         "mode": {
           "type": "string",
           "enum": ["query", "execute"]
@@ -109,6 +113,10 @@
         "retry": {
           "$ref": "#/definitions/RetryConfig"
         },
+        "fail_when": {
+          "type": "string",
+          "description": "Task nodes: semantic failure judgment. Safe expression evaluated against state after the node's output is stored (e.g. 'state.verify_result.status !== \"pass\"'). Truthy → node fails and the run halts."
+        },
         "condition": {
           "type": "string"
         },
@@ -158,6 +166,10 @@
         "comment": {
           "type": "string"
         },
+        "message": {
+          "type": "string",
+          "description": "error: failure message recorded in run.error. Supports {{template}} interpolation."
+        },
         "on_approve": {
           "type": "string"
         },
@@ -210,19 +222,36 @@
       "required": ["max", "delay"],
       "properties": {
         "max": {
-          "type": "number"
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 10,
+          "description": "Number of additional retries after the first attempt (0 disables retry)."
         },
         "delay": {
           "type": "string",
           "enum": ["exponential", "fixed"]
         },
         "max_delay": {
-          "type": "number"
+          "type": "integer",
+          "minimum": 0,
+          "description": "Maximum retry delay in milliseconds; runtime hard-caps this at 60000."
         },
         "on": {
           "type": "array",
           "items": {
-            "type": "string"
+            "type": "string",
+            "enum": [
+              "CLI_UNRESOLVABLE",
+              "SPAWN_FAILED",
+              "NODE_TIMEOUT",
+              "NODE_EXIT_NONZERO",
+              "OUTPUT_INVALID",
+              "RATE_LIMITED",
+              "CONFIG_INVALID",
+              "INTERRUPTED",
+              "CANCELLED",
+              "UNKNOWN"
+            ]
           }
         }
       }

package/package.json

@@ -1,10 +1,23 @@
 {
   "name": "@crewx/workflow",
-  "version": "0.3.22-rc.15",
+  "version": "0.3.22-rc.150",
   "description": "Workflow engine for CrewX - list, show, validate workflows with Mermaid visualization",
   "type": "commonjs",
   "main": "dist/src/engine.js",
   "types": "dist/src/engine.d.ts",
+  "typesVersions": {
+    "*": {
+      "run-manager": [
+        "dist/src/run-manager.d.ts"
+      ],
+      "types": [
+        "dist/src/types.d.ts"
+      ],
+      "list": [
+        "dist/src/list-view.d.ts"
+      ]
+    }
+  },
   "exports": {
     ".": {
       "types": "./dist/src/engine.d.ts",
@@ -28,6 +41,12 @@
       "import": "./dist/cli.js",
       "require": "./dist/cli.js",
       "default": "./dist/cli.js"
+    },
+    "./list": {
+      "types": "./dist/src/list-view.d.ts",
+      "import": "./dist/src/list-view.js",
+      "require": "./dist/src/list-view.js",
+      "default": "./dist/src/list-view.js"
     }
   },
   "bin": {
@@ -48,9 +67,9 @@
   "dependencies": {
     "@hyperjump/json-schema": "^1.9.4",
     "js-yaml": "^4.1.0",
-    "@crewx/knowledge-core": "0.1.17",
-    "@crewx/shared": "0.0.5",
-    "@crewx/sdk": "0.8.8-rc.35"
+    "@crewx/knowledge-core": "0.1.17-rc.114",
+    "@crewx/sdk": "0.9.0-rc.104",
+    "@crewx/shared": "0.0.6"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",

package/workflow-schema.json

@@ -56,7 +56,7 @@
       "properties": {
         "type": {
           "type": "string",
-          "enum": ["agent_task", "skill_task", "shell_task", "parallel", "join", "branch", "approval", "expression", "end"]
+          "enum": ["agent_task", "skill_task", "shell_task", "parallel", "join", "branch", "approval", "expression", "end", "error"]
         },
         "agent": {
           "type": "string"
@@ -81,7 +81,7 @@
         },
         "cwd": {
           "type": "string",
-          "description": "skill_task/shell_task: working directory, normalized and constrained under the project root."
+          "description": "agent_task/skill_task/shell_task: working directory, normalized and constrained under the project root."
         },
         "env": {
           "type": "object",
@@ -90,6 +90,10 @@
           },
           "description": "shell_task: explicit env pass-through. Dangerous keys (LD_PRELOAD, etc.) are rejected."
         },
+        "stdin": {
+          "type": "string",
+          "description": "skill_task/shell_task: optional stdin payload. Supports {{template}} interpolation."
+        },
         "mode": {
           "type": "string",
           "enum": ["query", "execute"]
@@ -109,6 +113,10 @@
         "retry": {
           "$ref": "#/definitions/RetryConfig"
         },
+        "fail_when": {
+          "type": "string",
+          "description": "Task nodes: semantic failure judgment. Safe expression evaluated against state after the node's output is stored (e.g. 'state.verify_result.status !== \"pass\"'). Truthy → node fails and the run halts."
+        },
         "condition": {
           "type": "string"
         },
@@ -158,6 +166,10 @@
         "comment": {
           "type": "string"
         },
+        "message": {
+          "type": "string",
+          "description": "error: failure message recorded in run.error. Supports {{template}} interpolation."
+        },
         "on_approve": {
           "type": "string"
         },
@@ -210,19 +222,36 @@
       "required": ["max", "delay"],
       "properties": {
         "max": {
-          "type": "number"
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 10,
+          "description": "Number of additional retries after the first attempt (0 disables retry)."
         },
         "delay": {
           "type": "string",
           "enum": ["exponential", "fixed"]
         },
         "max_delay": {
-          "type": "number"
+          "type": "integer",
+          "minimum": 0,
+          "description": "Maximum retry delay in milliseconds; runtime hard-caps this at 60000."
         },
         "on": {
           "type": "array",
           "items": {
-            "type": "string"
+            "type": "string",
+            "enum": [
+              "CLI_UNRESOLVABLE",
+              "SPAWN_FAILED",
+              "NODE_TIMEOUT",
+              "NODE_EXIT_NONZERO",
+              "OUTPUT_INVALID",
+              "RATE_LIMITED",
+              "CONFIG_INVALID",
+              "INTERRUPTED",
+              "CANCELLED",
+              "UNKNOWN"
+            ]
           }
         }
       }