@crewx/workflow 0.3.22-rc.192 → 0.3.22-rc.194

package/dist/src/card-state.d.ts

@@ -17,4 +17,4 @@ export interface WorkflowApprovalState {
     } | null;
 }
 export declare function buildWorkflowApprovalState(run: RunExecution, spec: WorkflowSpec): WorkflowApprovalState;
-//# sourceMappingURL=card-state.d.ts.map
+                                        

package/dist/src/card-state.js

@@ -1,121 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildWorkflowApprovalState = buildWorkflowApprovalState;
-const DEFAULT_APPROVAL_QUESTION = 'Approval required.';
-function getStateValue(state, path) {
-    const parts = path.split('.').map((part) => part.trim()).filter(Boolean);
-    let value = state;
-    for (const part of parts) {
-        if (!value || typeof value !== 'object' || !(part in value))
-            return undefined;
-        value = value[part];
-    }
-    return value;
-}
-function formatStateValue(value) {
-    if (value === undefined || value === null)
-        return '';
-    if (typeof value === 'string')
-        return value;
-    if (typeof value === 'number' || typeof value === 'boolean')
-        return String(value);
-    if (Array.isArray(value)) {
-        return value.map((item) => formatStateListItem(item)).filter(Boolean).join(', ');
-    }
-    if (typeof value === 'object')
-        return formatStateObject(value);
-    return String(value);
-}
-function formatStateListItem(item) {
-    if (!item || typeof item !== 'object' || Array.isArray(item)) {
-        return formatStateValue(item);
-    }
-    const record = item;
-    const name = typeof record.name === 'string' ? record.name : undefined;
-    const version = typeof record.version === 'string' ? record.version : undefined;
-    const action = typeof record.action === 'string' ? record.action : undefined;
-    const reason = typeof record.reason === 'string' ? record.reason : undefined;
-    const path = typeof record.path === 'string' ? record.path : undefined;
-    if (name || path) {
-        const label = [name ?? path, version].filter(Boolean).join('@');
-        const details = [action, reason].filter(Boolean).join('; ');
-        return details ? `${label} (${details})` : label;
-    }
-    return formatStateObject(record);
-}
-function formatStateObject(record) {
-    const preferredKeys = [
-        'status',
-        'should_publish',
-        'next_version',
-        'version',
-        'action',
-        'reason',
-        'message',
-    ];
-    const entries = preferredKeys
-        .filter((key) => key in record)
-        .map((key) => `${key}=${formatStateValue(record[key])}`);
-    return entries.length > 0 ? entries.join(', ') : JSON.stringify(record);
-}
-function interpolateStateTemplate(template, state) {
-    return template.replace(/\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g, (_match, key) => formatStateValue(getStateValue(state, key)));
-}
-function safeApprovalQuestion(value) {
-    if (typeof value !== 'string' || !value.trim())
-        return DEFAULT_APPROVAL_QUESTION;
-    if (/<\/?[A-Za-z][^>]*>/.test(value)
-        || /^(?:https?|file|ftp|ws|wss):\/\//i.test(value)
-        || /^(?:[A-Za-z]:[\\/]|\\\\|~[\\/]|\/)/.test(value)) {
-        return DEFAULT_APPROVAL_QUESTION;
-    }
-    return value;
-}
-function toNodeState(id, node) {
-    return node ? { id, type: node.type } : null;
-}
-function isTerminalStatus(status) {
-    return status === 'completed' || status === 'failed' || status === 'cancelled';
-}
-function buildPhase(run, currentNode) {
-    const status = run.status;
-    if (isTerminalStatus(status))
-        return status;
-    if (currentNode?.type === 'approval')
-        return 'waiting_approval';
-    if (status === 'retrying')
-        return 'retrying';
-    if (status === 'pending' || (!run.current_node && status === undefined))
-        return 'not_started';
-    if (currentNode?.type === 'parallel')
-        return 'paused';
-    return 'running';
-}
-function buildWorkflowApprovalState(run, spec) {
-    const nodes = spec.nodes ?? {};
-    const currentNodeSpec = run.current_node ? nodes[run.current_node] : undefined;
-    const currentNode = toNodeState(run.current_node, currentNodeSpec);
-    let approval = null;
-    if (currentNodeSpec?.type === 'approval') {
-        const question = typeof currentNodeSpec.description === 'string'
-            ? currentNodeSpec.description.trim()
-            : 'Approving this request will run the next workflow node.';
-        const approveNodeId = typeof currentNodeSpec.on_approve === 'string'
-            ? currentNodeSpec.on_approve
-            : undefined;
-        approval = {
-            question: safeApprovalQuestion(interpolateStateTemplate(question, run.state)),
-            approveNode: approveNodeId ? toNodeState(approveNodeId, nodes[approveNodeId]) : null,
-        };
-    }
-    return {
-        phase: buildPhase(run, currentNodeSpec),
-        status: run.status ?? null,
-        workflowId: run.workflow_id,
-        completedCount: run.completed_nodes?.length ?? 0,
-        totalNodes: Object.keys(nodes).length,
-        currentNode,
-        approval,
-    };
-}
-//# sourceMappingURL=card-state.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.buildWorkflowApprovalState=h;const u="Approval required.";function l(t,e){const r=e.split(".").map(o=>o.trim()).filter(Boolean);let n=t;for(const o of r){if(!n||typeof n!=="object"||!(o in n))return void 0;n=n[o]}return n}function p(t){if(t===void 0||t===null)return"";if(typeof t==="string")return t;if(typeof t==="number"||typeof t==="boolean")return String(t);if(Array.isArray(t)){return t.map(e=>y(e)).filter(Boolean).join(", ")}if(typeof t==="object")return c(t);return String(t)}function y(t){if(!t||typeof t!=="object"||Array.isArray(t)){return p(t)}const e=t;const r=typeof e.name==="string"?e.name:void 0;const n=typeof e.version==="string"?e.version:void 0;const o=typeof e.action==="string"?e.action:void 0;const s=typeof e.reason==="string"?e.reason:void 0;const f=typeof e.path==="string"?e.path:void 0;if(r||f){const i=[r??f,n].filter(Boolean).join("@");const a=[o,s].filter(Boolean).join("; ");return a?`${i} (${a})`:i}return c(e)}function c(t){const e=["status","should_publish","next_version","version","action","reason","message"];const r=e.filter(n=>n in t).map(n=>`${n}=${p(t[n])}`);return r.length>0?r.join(", "):JSON.stringify(t)}function g(t,e){return t.replace(/\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g,(r,n)=>p(l(e,n)))}function _(t){if(typeof t!=="string"||!t.trim())return u;if(/<\/?[A-Za-z][^>]*>/.test(t)||/^(?:https?|file|ftp|ws|wss):\/\//i.test(t)||/^(?:[A-Za-z]:[\\/]|\\\\|~[\\/]|\/)/.test(t)){return u}return t}function d(t,e){return e?{id:t,type:e.type}:null}function m(t){return t==="completed"||t==="failed"||t==="cancelled"}function A(t,e){const r=t.status;if(m(r))return r;if(e?.type==="approval")return"waiting_approval";if(r==="retrying")return"retrying";if(r==="pending"||!t.current_node&&r===void 0)return"not_started";if(e?.type==="parallel")return"paused";return"running"}function h(t,e){const r=e.nodes??{};const n=t.current_node?r[t.current_node]:void 0;const o=d(t.current_node,n);let s=null;if(n?.type==="approval"){const f=typeof n.description==="string"?n.description.trim():"Approving this request will run the next workflow node.";const i=typeof n.on_approve==="string"?n.on_approve:void 0;s={question:_(g(f,t.state)),approveNode:i?d(i,r[i]):null}}return{phase:A(t,n),status:t.status??null,workflowId:t.workflow_id,completedCount:t.completed_nodes?.length??0,totalNodes:Object.keys(r).length,currentNode:o,approval:s}}

package/dist/src/engine.d.ts

@@ -19,4 +19,4 @@ export type { WorkflowAuditSnapshotChange, WorkflowAuditSnapshotStore, WorkflowP
 export type { AutoRunResult, RunExecution, WorkflowAutoRunLease, WorkflowManualResume, WorkflowNode, WorkflowSpec, } from './types';
 export { buildWorkflowApprovalState } from './card-state';
 export type { WorkflowApprovalNodeState, WorkflowApprovalPhase, WorkflowApprovalState, } from './card-state';
-//# sourceMappingURL=engine.d.ts.map
+                                    

package/dist/src/engine.js

@@ -1,379 +1 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildWorkflowApprovalState = exports.previewWorkflowPersistenceProjection = exports.createWorkflowPersistenceProjection = exports.WORKFLOW_PARENT_TASK_KINDS = exports.WORKFLOW_PARENT_ORPHAN_GRACE_MS = exports.WORKFLOW_PARENT_ORPHAN_ERROR = exports.syncWorkflowParentTaskLifecycle = exports.reconcileWorkflowParentTasks = exports.reconcileWorkflowParentRunFiles = exports.previewWorkflowParentRepair = exports.deriveWorkflowParentLifecycleDecision = exports.deriveWorkflowParentLifecycleChange = exports.deriveWorkflowParentLifecycle = exports.createWorkflowParentPersistSink = exports.normalizeRunStatus = exports.WORKFLOW_RUN_LEGACY_RECOVERY_GRACE_MS = exports.WORKFLOW_RUN_INTERRUPTED_ERROR = exports.RunManager = exports.WorkflowEngine = void 0;
-const list_view_1 = require("./list-view");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const yaml = __importStar(require("js-yaml"));
-const mermaid_1 = require("./mermaid");
-const shell_security_1 = require("./utils/shell-security");
-const run_manager_1 = require("./run-manager");
-const retry_policy_1 = require("./retry-policy");
-const NODE_REQUIRED_FIELDS = {
-    agent_task: ['agent'],
-    skill_task: ['skill'],
-    shell_task: ['command'],
-    parallel: ['branches', 'join'],
-    join: [],
-    branch: ['condition', 'branches'],
-    approval: ['description', 'on_approve', 'on_reject'],
-    expression: ['set', 'next'],
-    end: [],
-    error: [],
-};
-function resolveRef(ref, root, depth) {
-    if (depth > 10)
-        return null;
-    const parts = ref.replace('#/', '').split('/');
-    let node = root;
-    for (const p of parts) {
-        node = node?.[p];
-        if (!node)
-            return null;
-    }
-    const schemaNode = node;
-    if (schemaNode.$ref)
-        return resolveRef(schemaNode.$ref, root, depth + 1);
-    return schemaNode;
-}
-function getJsonType(value) {
-    if (value === null || value === undefined)
-        return 'null';
-    if (Array.isArray(value))
-        return 'array';
-    return typeof value;
-}
-function validateSchema(value, schemaNode, root, jsonPath, errors, depth) {
-    if (depth > 20 || !schemaNode)
-        return;
-    if (schemaNode.$ref) {
-        const resolved = resolveRef(schemaNode.$ref, root, 0);
-        if (!resolved) {
-            errors.push({ path: jsonPath, message: `cannot resolve $ref "${schemaNode.$ref}"` });
-            return;
-        }
-        schemaNode = resolved;
-    }
-    if (schemaNode.type) {
-        const actualType = getJsonType(value);
-        const typeMatches = schemaNode.type === 'integer'
-            ? actualType === 'number' && Number.isInteger(value)
-            : schemaNode.type === actualType;
-        if (!typeMatches) {
-            errors.push({ path: jsonPath, message: `expected type "${schemaNode.type}", got "${actualType}"` });
-            return;
-        }
-    }
-    if (typeof value === 'number') {
-        if (schemaNode.minimum !== undefined && value < schemaNode.minimum) {
-            errors.push({ path: jsonPath, message: `number must be >= ${schemaNode.minimum}` });
-        }
-        if (schemaNode.maximum !== undefined && value > schemaNode.maximum) {
-            errors.push({ path: jsonPath, message: `number must be <= ${schemaNode.maximum}` });
-        }
-    }
-    if (schemaNode.enum) {
-        if (!schemaNode.enum.includes(value)) {
-            errors.push({ path: jsonPath, message: `value "${value}" not in enum [${schemaNode.enum.join(', ')}]` });
-        }
-    }
-    if (schemaNode.type === 'object' && typeof value === 'object' && value !== null && !Array.isArray(value)) {
-        const obj = value;
-        if (schemaNode.required) {
-            for (const req of schemaNode.required) {
-                if (!(req in obj)) {
-                    errors.push({ path: `${jsonPath}.${req}`, message: 'required field missing' });
-                }
-            }
-        }
-        if (schemaNode.properties) {
-            for (const [key, propSchema] of Object.entries(schemaNode.properties)) {
-                if (key in obj) {
-                    validateSchema(obj[key], propSchema, root, `${jsonPath}.${key}`, errors, depth + 1);
-                }
-            }
-        }
-        if (schemaNode.additionalProperties && typeof schemaNode.additionalProperties === 'object') {
-            const knownKeys = schemaNode.properties ? Object.keys(schemaNode.properties) : [];
-            for (const key of Object.keys(obj)) {
-                if (!knownKeys.includes(key)) {
-                    validateSchema(obj[key], schemaNode.additionalProperties, root, `${jsonPath}.${key}`, errors, depth + 1);
-                }
-            }
-        }
-    }
-    if (schemaNode.type === 'array' && Array.isArray(value)) {
-        if (schemaNode.items) {
-            value.forEach((item, i) => {
-                validateSchema(item, schemaNode.items, root, `${jsonPath}[${i}]`, errors, depth + 1);
-            });
-        }
-    }
-}
-function validateNodeTypeRequirements(nodeId, node, jsonPath, errors) {
-    const required = NODE_REQUIRED_FIELDS[node.type];
-    if (!required)
-        return;
-    for (const field of required) {
-        if (!(field in node)) {
-            errors.push({ path: `${jsonPath}.${field}`, message: `"${node.type}" node requires "${field}" field` });
-        }
-    }
-    if (node.type === 'parallel' && node.branches && !Array.isArray(node.branches)) {
-        errors.push({ path: `${jsonPath}.branches`, message: '"parallel" node branches must be an array of node IDs' });
-    }
-    if (node.type === 'branch' && node.branches && Array.isArray(node.branches)) {
-        errors.push({ path: `${jsonPath}.branches`, message: '"branch" node branches must be a Record (object), not an array' });
-    }
-    if (node.type === 'branch' && typeof node.condition === 'string') {
-        try {
-            (0, run_manager_1.validateSafeBranchCondition)(node.condition);
-        }
-        catch (error) {
-            errors.push({ path: `${jsonPath}.condition`, message: `unsafe branch condition: ${error.message}` });
-        }
-    }
-    if (typeof node.fail_when === 'string') {
-        const taskTypes = ['agent_task', 'skill_task', 'shell_task'];
-        if (!taskTypes.includes(node.type)) {
-            errors.push({
-                path: `${jsonPath}.fail_when`,
-                message: `"fail_when" is only supported on task nodes (${taskTypes.join(', ')}), not "${node.type}"`,
-            });
-        }
-        else {
-            try {
-                (0, run_manager_1.validateSafeBranchCondition)(node.fail_when);
-            }
-            catch (error) {
-                errors.push({ path: `${jsonPath}.fail_when`, message: `unsafe fail_when condition: ${error.message}` });
-            }
-        }
-    }
-    if (node.retry !== undefined) {
-        if (!retry_policy_1.RETRYABLE_NODE_TYPES.includes(node.type)) {
-            errors.push({
-                path: `${jsonPath}.retry`,
-                message: '"retry" is only supported on agent_task, skill_task, and shell_task nodes',
-            });
-        }
-        else {
-            const parsed = (0, retry_policy_1.parseRetryPolicy)(node);
-            if (!parsed.ok) {
-                const errorPath = `${jsonPath}.${parsed.path}`;
-                if (!errors.some((error) => error.path === errorPath)) {
-                    errors.push({ path: errorPath, message: parsed.reason });
-                }
-            }
-        }
-    }
-    if (node.type === 'skill_task' && node.skill !== undefined && !shell_security_1.SKILL_NAME_RE.test(node.skill)) {
-        errors.push({
-            path: `${jsonPath}.skill`,
-            message: `skill name "${node.skill}" is invalid (must match ^[a-z0-9][a-z0-9-]*$, no path traversal)`,
-        });
-    }
-    if (node.type === 'shell_task' && node.command !== undefined) {
-        const check = (0, shell_security_1.validateShellCommand)(node.command);
-        if (!check.ok) {
-            errors.push({ path: `${jsonPath}.command`, message: check.error });
-        }
-        const envCheck = (0, shell_security_1.validateEnvKeys)(node.env);
-        if (!envCheck.ok) {
-            errors.push({ path: `${jsonPath}.env`, message: envCheck.error });
-        }
-    }
-}
-function levenshtein(a, b) {
-    const m = a.length;
-    const n = b.length;
-    const dp = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0));
-    for (let i = 0; i <= m; i++)
-        dp[i][0] = i;
-    for (let j = 0; j <= n; j++)
-        dp[0][j] = j;
-    for (let i = 1; i <= m; i++) {
-        for (let j = 1; j <= n; j++) {
-            dp[i][j] = a[i - 1] === b[j - 1]
-                ? dp[i - 1][j - 1]
-                : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
-        }
-    }
-    return dp[m][n];
-}
-function findSimilar(target, candidates) {
-    let best = null;
-    let bestScore = Infinity;
-    for (const c of candidates) {
-        const score = levenshtein(target, c);
-        if (score < bestScore && score <= 3) {
-            bestScore = score;
-            best = c;
-        }
-    }
-    return best;
-}
-function validateReferences(wfName, spec, agents, errors) {
-    const nodes = spec.nodes;
-    const nodeIds = new Set(Object.keys(nodes));
-    const prefix = `workflows.${wfName}`;
-    for (const [nodeId, node] of Object.entries(nodes)) {
-        const np = `${prefix}.nodes.${nodeId}`;
-        if (node.next && !nodeIds.has(node.next)) {
-            errors.push({ path: `${np}.next`, message: `"${node.next}" node not found` });
-        }
-        if (node.agent && agents && !agents[node.agent]) {
-            errors.push({ path: `${np}.agent`, message: `agent "${node.agent}" not found in agents section` });
-        }
-        if (node.type === 'parallel' && Array.isArray(node.branches)) {
-            node.branches.forEach((branchId, i) => {
-                if (!nodeIds.has(branchId)) {
-                    errors.push({ path: `${np}.branches[${i}]`, message: `"${branchId}" node not found` });
-                }
-            });
-            if (node.join && !nodeIds.has(node.join)) {
-                errors.push({ path: `${np}.join`, message: `"${node.join}" node not found` });
-            }
-        }
-        if (node.type === 'branch' && node.branches && typeof node.branches === 'object' && !Array.isArray(node.branches)) {
-            for (const [condVal, targetId] of Object.entries(node.branches)) {
-                if (!nodeIds.has(targetId)) {
-                    const similar = findSimilar(targetId, nodeIds);
-                    let msg = `"${targetId}" node not found`;
-                    if (similar)
-                        msg += ` (did you mean "${similar}"?)`;
-                    errors.push({ path: `${np}.branches.${condVal}`, message: msg });
-                }
-            }
-        }
-        if (node.default && !nodeIds.has(node.default)) {
-            errors.push({ path: `${np}.default`, message: `"${node.default}" node not found` });
-        }
-        if (node.type === 'approval') {
-            if (node.on_approve && !nodeIds.has(node.on_approve)) {
-                errors.push({ path: `${np}.on_approve`, message: `"${node.on_approve}" node not found` });
-            }
-            if (node.on_reject && !nodeIds.has(node.on_reject)) {
-                errors.push({ path: `${np}.on_reject`, message: `"${node.on_reject}" node not found` });
-            }
-        }
-        if (node.on_error?.fallback_node && !nodeIds.has(node.on_error.fallback_node)) {
-            errors.push({ path: `${np}.on_error.fallback_node`, message: `"${node.on_error.fallback_node}" node not found` });
-        }
-    }
-}
-class WorkflowEngine {
-    constructor() {
-        let schemaPath = path.join(__dirname, '..', 'workflow-schema.json');
-        if (!fs.existsSync(schemaPath)) {
-            schemaPath = path.join(__dirname, '..', '..', 'workflow-schema.json');
-        }
-        this.schema = JSON.parse(fs.readFileSync(schemaPath, 'utf-8'));
-    }
-    loadWorkflows(dir) {
-        return (0, list_view_1.loadWorkflowDirectory)(dir);
-    }
-    validateFile(filePath) {
-        let content;
-        try {
-            content = fs.readFileSync(filePath, 'utf-8');
-        }
-        catch {
-            return { success: false, results: [], error: `File not found or unreadable: ${filePath}` };
-        }
-        let doc;
-        try {
-            doc = yaml.load(content);
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            return { success: false, results: [], error: `YAML parse error: ${message}` };
-        }
-        if (!doc || typeof doc !== 'object') {
-            return { success: false, results: [], error: 'Invalid YAML: document is empty or not an object' };
-        }
-        if (!doc.workflows || typeof doc.workflows !== 'object') {
-            return { success: true, results: [] };
-        }
-        const agents = doc.agents ?? null;
-        const results = [];
-        let hasErrors = false;
-        for (const [wfName, wfSpec] of Object.entries(doc.workflows)) {
-            const errors = [];
-            const basePath = `workflows.${wfName}`;
-            validateSchema(wfSpec, this.schema.definitions['WorkflowSpec'], this.schema, basePath, errors, 0);
-            if (wfSpec.nodes && typeof wfSpec.nodes === 'object') {
-                for (const [nodeId, node] of Object.entries(wfSpec.nodes)) {
-                    if (node && typeof node === 'object' && node.type) {
-                        validateNodeTypeRequirements(nodeId, node, `${basePath}.nodes.${nodeId}`, errors);
-                    }
-                }
-            }
-            validateReferences(wfName, wfSpec, agents, errors);
-            if (errors.length > 0)
-                hasErrors = true;
-            results.push({ name: wfName, valid: errors.length === 0, errors });
-        }
-        return { success: !hasErrors, results };
-    }
-    toMermaid(spec) {
-        return (0, mermaid_1.toMermaid)(spec);
-    }
-}
-exports.WorkflowEngine = WorkflowEngine;
-var run_manager_2 = require("./run-manager");
-Object.defineProperty(exports, "RunManager", { enumerable: true, get: function () { return run_manager_2.RunManager; } });
-Object.defineProperty(exports, "WORKFLOW_RUN_INTERRUPTED_ERROR", { enumerable: true, get: function () { return run_manager_2.WORKFLOW_RUN_INTERRUPTED_ERROR; } });
-Object.defineProperty(exports, "WORKFLOW_RUN_LEGACY_RECOVERY_GRACE_MS", { enumerable: true, get: function () { return run_manager_2.WORKFLOW_RUN_LEGACY_RECOVERY_GRACE_MS; } });
-Object.defineProperty(exports, "normalizeRunStatus", { enumerable: true, get: function () { return run_manager_2.normalizeRunStatus; } });
-var parent_task_sync_1 = require("./parent-task-sync");
-Object.defineProperty(exports, "createWorkflowParentPersistSink", { enumerable: true, get: function () { return parent_task_sync_1.createWorkflowParentPersistSink; } });
-Object.defineProperty(exports, "deriveWorkflowParentLifecycle", { enumerable: true, get: function () { return parent_task_sync_1.deriveWorkflowParentLifecycle; } });
-Object.defineProperty(exports, "deriveWorkflowParentLifecycleChange", { enumerable: true, get: function () { return parent_task_sync_1.deriveWorkflowParentLifecycleChange; } });
-Object.defineProperty(exports, "deriveWorkflowParentLifecycleDecision", { enumerable: true, get: function () { return parent_task_sync_1.deriveWorkflowParentLifecycleDecision; } });
-Object.defineProperty(exports, "previewWorkflowParentRepair", { enumerable: true, get: function () { return parent_task_sync_1.previewWorkflowParentRepair; } });
-Object.defineProperty(exports, "reconcileWorkflowParentRunFiles", { enumerable: true, get: function () { return parent_task_sync_1.reconcileWorkflowParentRunFiles; } });
-Object.defineProperty(exports, "reconcileWorkflowParentTasks", { enumerable: true, get: function () { return parent_task_sync_1.reconcileWorkflowParentTasks; } });
-Object.defineProperty(exports, "syncWorkflowParentTaskLifecycle", { enumerable: true, get: function () { return parent_task_sync_1.syncWorkflowParentTaskLifecycle; } });
-Object.defineProperty(exports, "WORKFLOW_PARENT_ORPHAN_ERROR", { enumerable: true, get: function () { return parent_task_sync_1.WORKFLOW_PARENT_ORPHAN_ERROR; } });
-Object.defineProperty(exports, "WORKFLOW_PARENT_ORPHAN_GRACE_MS", { enumerable: true, get: function () { return parent_task_sync_1.WORKFLOW_PARENT_ORPHAN_GRACE_MS; } });
-Object.defineProperty(exports, "WORKFLOW_PARENT_TASK_KINDS", { enumerable: true, get: function () { return parent_task_sync_1.WORKFLOW_PARENT_TASK_KINDS; } });
-var workflow_persistence_1 = require("./workflow-persistence");
-Object.defineProperty(exports, "createWorkflowPersistenceProjection", { enumerable: true, get: function () { return workflow_persistence_1.createWorkflowPersistenceProjection; } });
-Object.defineProperty(exports, "previewWorkflowPersistenceProjection", { enumerable: true, get: function () { return workflow_persistence_1.previewWorkflowPersistenceProjection; } });
-var card_state_1 = require("./card-state");
-Object.defineProperty(exports, "buildWorkflowApprovalState", { enumerable: true, get: function () { return card_state_1.buildWorkflowApprovalState; } });
-//# sourceMappingURL=engine.js.map
+"use strict";var P=exports&&exports.__createBinding||(Object.create?(function(a,e,i,t){if(t===void 0)t=i;var n=Object.getOwnPropertyDescriptor(e,i);if(!n||("get"in n?!e.__esModule:n.writable||n.configurable)){n={enumerable:true,get:function(){return e[i]}}}Object.defineProperty(a,t,n)}):(function(a,e,i,t){if(t===void 0)t=i;a[t]=e[i]}));var W=exports&&exports.__setModuleDefault||(Object.create?(function(a,e){Object.defineProperty(a,"default",{enumerable:true,value:e})}):function(a,e){a["default"]=e});var b=exports&&exports.__importStar||(function(){var a=function(e){a=Object.getOwnPropertyNames||function(i){var t=[];for(var n in i)if(Object.prototype.hasOwnProperty.call(i,n))t[t.length]=n;return t};return a(e)};return function(e){if(e&&e.__esModule)return e;var i={};if(e!=null){for(var t=a(e),n=0;n<t.length;n++)if(t[n]!=="default")P(i,e,t[n])}W(i,e);return i}})();Object.defineProperty(exports,"__esModule",{value:true});exports.buildWorkflowApprovalState=exports.previewWorkflowPersistenceProjection=exports.createWorkflowPersistenceProjection=exports.WORKFLOW_PARENT_TASK_KINDS=exports.WORKFLOW_PARENT_ORPHAN_GRACE_MS=exports.WORKFLOW_PARENT_ORPHAN_ERROR=exports.syncWorkflowParentTaskLifecycle=exports.reconcileWorkflowParentTasks=exports.reconcileWorkflowParentRunFiles=exports.previewWorkflowParentRepair=exports.deriveWorkflowParentLifecycleDecision=exports.deriveWorkflowParentLifecycleChange=exports.deriveWorkflowParentLifecycle=exports.createWorkflowParentPersistSink=exports.normalizeRunStatus=exports.WORKFLOW_RUN_LEGACY_RECOVERY_GRACE_MS=exports.WORKFLOW_RUN_INTERRUPTED_ERROR=exports.RunManager=exports.WorkflowEngine=void 0;const E=require("./list-view");const m=b(require("fs"));const R=b(require("path"));const j=b(require("js-yaml"));const A=require("./mermaid");const g=require("./utils/shell-security");const k=require("./run-manager");const O=require("./retry-policy");const v={agent_task:["agent"],skill_task:["skill"],shell_task:["command"],parallel:["branches","join"],join:[],branch:["condition","branches"],approval:["description","on_approve","on_reject"],expression:["set","next"],end:[],error:[]};function w(a,e,i){if(i>10)return null;const t=a.replace("#/","").split("/");let n=e;for(const s of t){n=n?.[s];if(!n)return null}const r=n;if(r.$ref)return w(r.$ref,e,i+1);return r}function S(a){if(a===null||a===void 0)return"null";if(Array.isArray(a))return"array";return typeof a}function y(a,e,i,t,n,r){if(r>20||!e)return;if(e.$ref){const s=w(e.$ref,i,0);if(!s){n.push({path:t,message:`cannot resolve $ref "${e.$ref}"`});return}e=s}if(e.type){const s=S(a);const f=e.type==="integer"?s==="number"&&Number.isInteger(a):e.type===s;if(!f){n.push({path:t,message:`expected type "${e.type}", got "${s}"`});return}}if(typeof a==="number"){if(e.minimum!==void 0&&a<e.minimum){n.push({path:t,message:`number must be >= ${e.minimum}`})}if(e.maximum!==void 0&&a>e.maximum){n.push({path:t,message:`number must be <= ${e.maximum}`})}}if(e.enum){if(!e.enum.includes(a)){n.push({path:t,message:`value "${a}" not in enum [${e.enum.join(", ")}]`})}}if(e.type==="object"&&typeof a==="object"&&a!==null&&!Array.isArray(a)){const s=a;if(e.required){for(const f of e.required){if(!(f in s)){n.push({path:`${t}.${f}`,message:"required field missing"})}}}if(e.properties){for(const[f,o]of Object.entries(e.properties)){if(f in s){y(s[f],o,i,`${t}.${f}`,n,r+1)}}}if(e.additionalProperties&&typeof e.additionalProperties==="object"){const f=e.properties?Object.keys(e.properties):[];for(const o of Object.keys(s)){if(!f.includes(o)){y(s[o],e.additionalProperties,i,`${t}.${o}`,n,r+1)}}}}if(e.type==="array"&&Array.isArray(a)){if(e.items){a.forEach((s,f)=>{y(s,e.items,i,`${t}[${f}]`,n,r+1)})}}}function L(a,e,i,t){const n=v[e.type];if(!n)return;for(const r of n){if(!(r in e)){t.push({path:`${i}.${r}`,message:`"${e.type}" node requires "${r}" field`})}}if(e.type==="parallel"&&e.branches&&!Array.isArray(e.branches)){t.push({path:`${i}.branches`,message:'"parallel" node branches must be an array of node IDs'})}if(e.type==="branch"&&e.branches&&Array.isArray(e.branches)){t.push({path:`${i}.branches`,message:'"branch" node branches must be a Record (object), not an array'})}if(e.type==="branch"&&typeof e.condition==="string"){try{(0,k.validateSafeBranchCondition)(e.condition)}catch(r){t.push({path:`${i}.condition`,message:`unsafe branch condition: ${r.message}`})}}if(typeof e.fail_when==="string"){const r=["agent_task","skill_task","shell_task"];if(!r.includes(e.type)){t.push({path:`${i}.fail_when`,message:`"fail_when" is only supported on task nodes (${r.join(", ")}), not "${e.type}"`})}else{try{(0,k.validateSafeBranchCondition)(e.fail_when)}catch(s){t.push({path:`${i}.fail_when`,message:`unsafe fail_when condition: ${s.message}`})}}}if(e.retry!==void 0){if(!O.RETRYABLE_NODE_TYPES.includes(e.type)){t.push({path:`${i}.retry`,message:'"retry" is only supported on agent_task, skill_task, and shell_task nodes'})}else{const r=(0,O.parseRetryPolicy)(e);if(!r.ok){const s=`${i}.${r.path}`;if(!t.some(f=>f.path===s)){t.push({path:s,message:r.reason})}}}}if(e.type==="skill_task"&&e.skill!==void 0&&!g.SKILL_NAME_RE.test(e.skill)){t.push({path:`${i}.skill`,message:`skill name "${e.skill}" is invalid (must match ^[a-z0-9][a-z0-9-]*$, no path traversal)`})}if(e.type==="shell_task"&&e.command!==void 0){const r=(0,g.validateShellCommand)(e.command);if(!r.ok){t.push({path:`${i}.command`,message:r.error})}const s=(0,g.validateEnvKeys)(e.env);if(!s.ok){t.push({path:`${i}.env`,message:s.error})}}}function T(a,e){const i=a.length;const t=e.length;const n=Array.from({length:i+1},()=>Array(t+1).fill(0));for(let r=0;r<=i;r++)n[r][0]=r;for(let r=0;r<=t;r++)n[0][r]=r;for(let r=1;r<=i;r++){for(let s=1;s<=t;s++){n[r][s]=a[r-1]===e[s-1]?n[r-1][s-1]:1+Math.min(n[r-1][s],n[r][s-1],n[r-1][s-1])}}return n[i][t]}function K(a,e){let i=null;let t=Infinity;for(const n of e){const r=T(a,n);if(r<t&&r<=3){t=r;i=n}}return i}function F(a,e,i,t){const n=e.nodes;const r=new Set(Object.keys(n));const s=`workflows.${a}`;for(const[f,o]of Object.entries(n)){const c=`${s}.nodes.${f}`;if(o.next&&!r.has(o.next)){t.push({path:`${c}.next`,message:`"${o.next}" node not found`})}if(o.agent&&i&&!i[o.agent]){t.push({path:`${c}.agent`,message:`agent "${o.agent}" not found in agents section`})}if(o.type==="parallel"&&Array.isArray(o.branches)){o.branches.forEach((p,l)=>{if(!r.has(p)){t.push({path:`${c}.branches[${l}]`,message:`"${p}" node not found`})}});if(o.join&&!r.has(o.join)){t.push({path:`${c}.join`,message:`"${o.join}" node not found`})}}if(o.type==="branch"&&o.branches&&typeof o.branches==="object"&&!Array.isArray(o.branches)){for(const[p,l]of Object.entries(o.branches)){if(!r.has(l)){const _=K(l,r);let h=`"${l}" node not found`;if(_)h+=` (did you mean "${_}"?)`;t.push({path:`${c}.branches.${p}`,message:h})}}}if(o.default&&!r.has(o.default)){t.push({path:`${c}.default`,message:`"${o.default}" node not found`})}if(o.type==="approval"){if(o.on_approve&&!r.has(o.on_approve)){t.push({path:`${c}.on_approve`,message:`"${o.on_approve}" node not found`})}if(o.on_reject&&!r.has(o.on_reject)){t.push({path:`${c}.on_reject`,message:`"${o.on_reject}" node not found`})}}if(o.on_error?.fallback_node&&!r.has(o.on_error.fallback_node)){t.push({path:`${c}.on_error.fallback_node`,message:`"${o.on_error.fallback_node}" node not found`})}}}class M{constructor(){let e=R.join(__dirname,"..","workflow-schema.json");if(!m.existsSync(e)){e=R.join(__dirname,"..","..","workflow-schema.json")}this.schema=JSON.parse(m.readFileSync(e,"utf-8"))}loadWorkflows(e){return(0,E.loadWorkflowDirectory)(e)}validateFile(e){let i;try{i=m.readFileSync(e,"utf-8")}catch{return{success:false,results:[],error:`File not found or unreadable: ${e}`}}let t;try{t=j.load(i)}catch(f){const o=f instanceof Error?f.message:String(f);return{success:false,results:[],error:`YAML parse error: ${o}`}}if(!t||typeof t!=="object"){return{success:false,results:[],error:"Invalid YAML: document is empty or not an object"}}if(!t.workflows||typeof t.workflows!=="object"){return{success:true,results:[]}}const n=t.agents??null;const r=[];let s=false;for(const[f,o]of Object.entries(t.workflows)){const c=[];const p=`workflows.${f}`;y(o,this.schema.definitions["WorkflowSpec"],this.schema,p,c,0);if(o.nodes&&typeof o.nodes==="object"){for(const[l,_]of Object.entries(o.nodes)){if(_&&typeof _==="object"&&_.type){L(l,_,`${p}.nodes.${l}`,c)}}}F(f,o,n,c);if(c.length>0)s=true;r.push({name:f,valid:c.length===0,errors:c})}return{success:!s,results:r}}toMermaid(e){return(0,A.toMermaid)(e)}}exports.WorkflowEngine=M;var d=require("./run-manager");Object.defineProperty(exports,"RunManager",{enumerable:true,get:function(){return d.RunManager}});Object.defineProperty(exports,"WORKFLOW_RUN_INTERRUPTED_ERROR",{enumerable:true,get:function(){return d.WORKFLOW_RUN_INTERRUPTED_ERROR}});Object.defineProperty(exports,"WORKFLOW_RUN_LEGACY_RECOVERY_GRACE_MS",{enumerable:true,get:function(){return d.WORKFLOW_RUN_LEGACY_RECOVERY_GRACE_MS}});Object.defineProperty(exports,"normalizeRunStatus",{enumerable:true,get:function(){return d.normalizeRunStatus}});var u=require("./parent-task-sync");Object.defineProperty(exports,"createWorkflowParentPersistSink",{enumerable:true,get:function(){return u.createWorkflowParentPersistSink}});Object.defineProperty(exports,"deriveWorkflowParentLifecycle",{enumerable:true,get:function(){return u.deriveWorkflowParentLifecycle}});Object.defineProperty(exports,"deriveWorkflowParentLifecycleChange",{enumerable:true,get:function(){return u.deriveWorkflowParentLifecycleChange}});Object.defineProperty(exports,"deriveWorkflowParentLifecycleDecision",{enumerable:true,get:function(){return u.deriveWorkflowParentLifecycleDecision}});Object.defineProperty(exports,"previewWorkflowParentRepair",{enumerable:true,get:function(){return u.previewWorkflowParentRepair}});Object.defineProperty(exports,"reconcileWorkflowParentRunFiles",{enumerable:true,get:function(){return u.reconcileWorkflowParentRunFiles}});Object.defineProperty(exports,"reconcileWorkflowParentTasks",{enumerable:true,get:function(){return u.reconcileWorkflowParentTasks}});Object.defineProperty(exports,"syncWorkflowParentTaskLifecycle",{enumerable:true,get:function(){return u.syncWorkflowParentTaskLifecycle}});Object.defineProperty(exports,"WORKFLOW_PARENT_ORPHAN_ERROR",{enumerable:true,get:function(){return u.WORKFLOW_PARENT_ORPHAN_ERROR}});Object.defineProperty(exports,"WORKFLOW_PARENT_ORPHAN_GRACE_MS",{enumerable:true,get:function(){return u.WORKFLOW_PARENT_ORPHAN_GRACE_MS}});Object.defineProperty(exports,"WORKFLOW_PARENT_TASK_KINDS",{enumerable:true,get:function(){return u.WORKFLOW_PARENT_TASK_KINDS}});var $=require("./workflow-persistence");Object.defineProperty(exports,"createWorkflowPersistenceProjection",{enumerable:true,get:function(){return $.createWorkflowPersistenceProjection}});Object.defineProperty(exports,"previewWorkflowPersistenceProjection",{enumerable:true,get:function(){return $.previewWorkflowPersistenceProjection}});var q=require("./card-state");Object.defineProperty(exports,"buildWorkflowApprovalState",{enumerable:true,get:function(){return q.buildWorkflowApprovalState}});

package/dist/src/failure.d.ts

@@ -38,4 +38,4 @@ export interface EvidenceInput {
 export declare function buildEvidencePreview(input: EvidenceInput): string | null;
 export declare function sanitizeLocalRunError(raw: unknown, fallback: string): string;
 export declare function readNodeAttempt(run: RunExecution, nodeId: string): number;
-//# sourceMappingURL=failure.d.ts.map
+