@crewx/workflow 0.3.22-rc.2 → 0.3.22-rc.200

package/dist/src/types.d.ts

@@ -2,29 +2,37 @@ export interface WorkflowMeta {
     name: string;
     description?: string;
     version?: string;
+    shell_task_allowed?: boolean;
 }
 export interface RetryConfig {
     max: number;
     delay: 'exponential' | 'fixed';
     max_delay?: number;
-    on?: string[];
+    on?: WorkflowFailureCode[];
 }
 export interface OnError {
     handler?: string;
     fallback_node?: string;
 }
-export type NodeType = 'agent_task' | 'parallel' | 'join' | 'branch' | 'approval' | 'expression' | 'end';
+export type NodeType = 'agent_task' | 'skill_task' | 'shell_task' | 'parallel' | 'join' | 'branch' | 'approval' | 'expression' | 'end' | 'error';
 export type JsonSchema = Record<string, unknown>;
 export interface WorkflowNode {
     type: NodeType;
     agent?: string;
     mode?: 'query' | 'execute';
     input?: string;
+    skill?: string;
+    args?: string[];
+    command?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    stdin?: string;
     output?: string;
     output_format?: 'json';
     output_schema?: JsonSchema;
     output_retry?: number;
     output_strict?: boolean;
+    fail_when?: string;
     next?: string;
     hooks?: string[];
     retry?: RetryConfig;
@@ -42,6 +50,7 @@ export interface WorkflowNode {
     on_reject?: string;
     on_error?: OnError;
     set?: Record<string, string>;
+    message?: string;
 }
 export interface WorkflowSpec {
     metadata?: WorkflowMeta;
@@ -68,6 +77,45 @@ export interface ValidationResult {
     valid: boolean;
     errors: ValidationError[];
 }
+export interface AuditEntry {
+    exec_id: string;
+    node_id: string;
+    type: NodeType | 'retry' | string;
+    summary: string;
+    started_at: string;
+    ended_at: string;
+    duration_ms: number;
+    exit_code: number | null;
+    error?: string;
+    trigger: 'manual' | 'auto';
+}
+export interface WorkflowAutoRunLease {
+    pid: number;
+    token: string;
+    node_id: string;
+    started_at: string;
+}
+export interface WorkflowManualResume {
+    node_id: string;
+    requested_at: string;
+}
+export type WorkflowFailureCode = 'CLI_UNRESOLVABLE' | 'SPAWN_FAILED' | 'NODE_TIMEOUT' | 'NODE_EXIT_NONZERO' | 'OUTPUT_INVALID' | 'RATE_LIMITED' | 'CONFIG_INVALID' | 'INTERRUPTED' | 'CANCELLED' | 'UNKNOWN';
+export interface RetryPolicy {
+    max: number;
+    delay: 'exponential' | 'fixed';
+    max_delay: number;
+    on: WorkflowFailureCode[];
+}
+export declare const NEVER_RETRYABLE: readonly WorkflowFailureCode[];
+export interface WorkflowNodeFailure {
+    failedNode: string;
+    attempt: number;
+    causeCode: WorkflowFailureCode;
+    causeMessage: string;
+    exitCode: number | null;
+    evidencePreview: string | null;
+    occurredAt: string;
+}
 export interface RunExecution {
     id: string;
     workflow_id: string;
@@ -78,7 +126,20 @@ export interface RunExecution {
     completed_nodes: string[];
     state: Record<string, unknown>;
     initial_state: Record<string, unknown>;
-    status?: 'running' | 'completed' | 'failed';
+    status?: 'pending' | 'running' | 'retrying' | 'completed' | 'failed' | 'cancelled';
     tasks?: Record<string, string>;
+    error?: string;
+    last_failure?: WorkflowNodeFailure;
+    audit?: AuditEntry[];
+    retry_count?: number;
+    node_attempts?: Record<string, number>;
+    auto_run?: WorkflowAutoRunLease;
+    manual_resume?: WorkflowManualResume;
+}
+export interface AutoRunResult {
+    run: RunExecution;
+    outcome: 'completed' | 'failed' | 'cancelled' | 'paused';
+    reason?: string;
+    executed: string[];
 }
-//# sourceMappingURL=types.d.ts.map
+                                   

package/dist/src/types.js

@@ -1,3 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.NEVER_RETRYABLE=void 0;exports.NEVER_RETRYABLE=["CANCELLED","CONFIG_INVALID"];

package/dist/src/utils/output-format.d.ts

@@ -1,6 +1,18 @@
 import type { JsonSchema } from '../types';
+export interface WorkflowPreambleContext {
+    workflowId: string;
+    nodeId: string;
+    execId: string;
+}
+export declare const WORKFLOW_SIGNAL_KEY = "workflow_signal";
+export interface WorkflowSignal {
+    signal: 'fail';
+    reason?: string;
+}
+export declare function buildWorkflowPreamble(ctx: WorkflowPreambleContext): string;
+export declare function detectWorkflowSignal(output: string): WorkflowSignal | null;
 export declare function buildJsonOutputSuffix(schema?: JsonSchema, strict?: boolean): string;
 export declare function extractJson(text: string): string;
 export declare function validateJsonSchema(value: unknown, schema: JsonSchema): Promise<void>;
 export declare function toOpenAIStrictSchema(schema: JsonSchema): JsonSchema;
-//# sourceMappingURL=output-format.d.ts.map
+                                           

package/dist/src/utils/output-format.js

@@ -1,125 +1,29 @@
-"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.buildJsonOutputSuffix = buildJsonOutputSuffix;
-exports.extractJson = extractJson;
-exports.validateJsonSchema = validateJsonSchema;
-exports.toOpenAIStrictSchema = toOpenAIStrictSchema;
-const node_crypto_1 = require("node:crypto");
-function buildJsonOutputSuffix(schema, strict = false) {
-    const finalSchema = strict && schema ? toOpenAIStrictSchema(schema) : schema;
-    const schemaStr = finalSchema ? `JSON Schema:\n${JSON.stringify(finalSchema, null, 2)}\n` : '';
-    return `\n\n<crewx.workflow>
-## ⚠️ Output Format (read first — drives branch evaluation)
+"use strict";var y=exports&&exports.__createBinding||(Object.create?(function(n,e,r,t){if(t===void 0)t=r;var o=Object.getOwnPropertyDescriptor(e,r);if(!o||("get"in o?!e.__esModule:o.writable||o.configurable)){o={enumerable:true,get:function(){return e[r]}}}Object.defineProperty(n,t,o)}):(function(n,e,r,t){if(t===void 0)t=r;n[t]=e[r]}));var _=exports&&exports.__setModuleDefault||(Object.create?(function(n,e){Object.defineProperty(n,"default",{enumerable:true,value:e})}):function(n,e){n["default"]=e});var v=exports&&exports.__importStar||(function(){var n=function(e){n=Object.getOwnPropertyNames||function(r){var t=[];for(var o in r)if(Object.prototype.hasOwnProperty.call(r,o))t[t.length]=o;return t};return n(e)};return function(e){if(e&&e.__esModule)return e;var r={};if(e!=null){for(var t=n(e),o=0;o<t.length;o++)if(t[o]!=="default")y(r,e,t[o])}_(r,e);return r}})();Object.defineProperty(exports,"__esModule",{value:true});exports.WORKFLOW_SIGNAL_KEY=void 0;exports.buildWorkflowPreamble=j;exports.detectWorkflowSignal=E;exports.buildJsonOutputSuffix=P;exports.extractJson=O;exports.validateJsonSchema=W;exports.toOpenAIStrictSchema=S;const N=require("node:crypto");exports.WORKFLOW_SIGNAL_KEY="workflow_signal";function j(n){return`<crewx.workflow>
+## Execution Context
+You are running headless as node "${n.nodeId}" of workflow "${n.workflowId}" (run ${n.execId}).
+- No human is watching this session. NEVER ask clarifying questions or wait for
+  confirmation \u2014 state your assumptions and proceed, or report failure.
+- Your output is consumed verbatim by downstream nodes. Output the result only;
+  skip greetings, progress notes, and meta commentary.
+- If the task cannot be completed (broken precondition, missing data, failed
+  verification), do NOT pretend success or return a partial answer as if it
+  succeeded. Instead output exactly one JSON object and nothing else:
+  {"${exports.WORKFLOW_SIGNAL_KEY}": "fail", "reason": "<one-line cause>"}
+  The engine will halt the workflow at this node and record the reason.
+</crewx.workflow>
+
+`}function E(n){if(!n.includes(`"${exports.WORKFLOW_SIGNAL_KEY}"`))return null;const e=t=>{if(typeof t==="object"&&t!==null&&!Array.isArray(t)&&t[exports.WORKFLOW_SIGNAL_KEY]==="fail"){const o=t["reason"];return{signal:"fail",...typeof o==="string"&&o?{reason:o}:{}}}return null};try{const t=e(JSON.parse(O(n)));if(t)return t}catch{}const r=n.match(new RegExp(`\\{[^{}]*"${exports.WORKFLOW_SIGNAL_KEY}"\\s*:\\s*"fail"[^{}]*\\}`));if(r){try{return e(JSON.parse(r[0]))}catch{return{signal:"fail"}}}return null}function P(n,e=false){const r=e&&n?S(n):n;const t=r?`JSON Schema:
+${JSON.stringify(r,null,2)}
+`:"";return`
+
+<crewx.workflow>
+## \u26A0\uFE0F Output Format (read first \u2014 drives branch evaluation)
 
 **The first character of your output MUST be \`{\`. The last character MUST be \`}\`.**
 No other text is permitted (no explanations, greetings, progress notes, or analysis remarks).
 **NEVER use markdown code fences (\`\`\`json ... \`\`\`).** Do not output even a single backtick.
-Branch evaluation calls \`JSON.parse(state.<output>)\` directly —
+Branch evaluation calls \`JSON.parse(state.<output>)\` directly \u2014
 even one non-JSON character at start or end will halt the workflow.
 
-${schemaStr}Execute the task, then output **exactly one JSON object** matching the schema above. Nothing else.
-</crewx.workflow>`;
-}
-function extractJson(text) {
-    let trimmed = text.trim();
-    const fenceMatch = trimmed.match(/^```(?:json|JSON)?\s*\n?([\s\S]*?)\n?```\s*$/);
-    if (fenceMatch && fenceMatch[1] !== undefined) {
-        trimmed = fenceMatch[1].trim();
-    }
-    const objMatch = trimmed.match(/\{[\s\S]*\}/);
-    const arrMatch = trimmed.match(/\[[\s\S]*\]/);
-    if (objMatch && arrMatch) {
-        return objMatch.index < arrMatch.index ? objMatch[0] : arrMatch[0];
-    }
-    return objMatch?.[0] ?? arrMatch?.[0] ?? trimmed;
-}
-async function validateJsonSchema(value, schema) {
-    const { registerSchema, validate } = await Promise.resolve().then(() => __importStar(require('@hyperjump/json-schema/draft-2020-12')));
-    const uri = `urn:crewx:schema:${(0, node_crypto_1.randomUUID)()}`;
-    registerSchema({ $schema: 'https://json-schema.org/draft/2020-12/schema', ...schema }, uri);
-    const result = await validate(uri, value);
-    if (!result.valid) {
-        const errors = (result.errors ?? [])
-            .map((e) => e.instanceLocation)
-            .join('; ');
-        throw new Error(`Schema validation failed: ${errors || 'unknown error'}`);
-    }
-}
-function toOpenAIStrictSchema(schema) {
-    return transformStrict(schema);
-}
-const OPENAI_UNSUPPORTED_KEYWORDS = new Set([
-    'default', 'format', 'pattern', 'minLength', 'maxLength',
-    'minimum', 'maximum', 'not',
-]);
-function transformStrict(schema) {
-    const result = {};
-    for (const [key, value] of Object.entries(schema)) {
-        if (OPENAI_UNSUPPORTED_KEYWORDS.has(key))
-            continue;
-        if (key === 'properties' && isRecord(value)) {
-            const transformed = {};
-            for (const [propKey, propVal] of Object.entries(value)) {
-                transformed[propKey] = transformStrict(propVal);
-            }
-            result['properties'] = transformed;
-            result['required'] = Object.keys(transformed);
-            result['additionalProperties'] = false;
-        }
-        else if (key === 'items' && isRecord(value)) {
-            result['items'] = transformStrict(value);
-        }
-        else if (key === 'required') {
-            if (!('properties' in schema)) {
-                result['required'] = value;
-            }
-        }
-        else if (key === 'additionalProperties') {
-            result['additionalProperties'] = false;
-        }
-        else {
-            result[key] = value;
-        }
-    }
-    if (result['type'] === 'object' && !('additionalProperties' in result)) {
-        result['additionalProperties'] = false;
-    }
-    return result;
-}
-function isRecord(val) {
-    return typeof val === 'object' && val !== null && !Array.isArray(val);
-}
-//# sourceMappingURL=output-format.js.map
+${t}Execute the task, then output **exactly one JSON object** matching the schema above. Nothing else.
+</crewx.workflow>`}function O(n){let e=n.trim();const r=e.match(/^```(?:json|JSON)?\s*\n?([\s\S]*?)\n?```\s*$/);if(r&&r[1]!==void 0){e=r[1].trim()}const t=(i,d,b)=>{const w=[];let h=false;let p=false;let l=0;let u=-1;for(let s=0;s<i.length;s++){const f=i[s];if(p){p=false;continue}if(h){if(f==="\\"){p=true;continue}if(f==='"'){h=false}continue}if(f==='"'){h=true;continue}if(f===d){if(l===0)u=s;l++}else if(f===b){if(l>0){l--;if(l===0&&u!==-1){w.push({text:i.slice(u,s+1),start:u,end:s});u=-1}}}}return w};const o=t(e,"{","}");const a=t(e,"[","]");const c=[...o,...a].sort((i,d)=>d.end-i.end);for(const i of c){try{JSON.parse(i.text);return i.text}catch{}}return e}async function W(n,e){const{registerSchema:r,validate:t}=await Promise.resolve().then(()=>v(require("@hyperjump/json-schema/draft-2020-12")));const o=`urn:crewx:schema:${(0,N.randomUUID)()}`;r({$schema:"https://json-schema.org/draft/2020-12/schema",...e},o);const a=await t(o,n);if(!a.valid){const c=(a.errors??[]).map(i=>i.instanceLocation).join("; ");throw new Error(`Schema validation failed: ${c||"unknown error"}`)}}function S(n){return m(n)}const J=new Set(["default","format","pattern","minLength","maxLength","minimum","maximum","not"]);function m(n){const e={};for(const[r,t]of Object.entries(n)){if(J.has(r))continue;if(r==="properties"&&g(t)){const o={};for(const[a,c]of Object.entries(t)){o[a]=m(c)}e["properties"]=o;e["required"]=Object.keys(o);e["additionalProperties"]=false}else if(r==="items"&&g(t)){e["items"]=m(t)}else if(r==="required"){if(!("properties"in n)){e["required"]=t}}else if(r==="additionalProperties"){e["additionalProperties"]=false}else{e[r]=t}}if(e["type"]==="object"&&!("additionalProperties"in e)){e["additionalProperties"]=false}return e}function g(n){return typeof n==="object"&&n!==null&&!Array.isArray(n)}

package/dist/src/utils/shell-security.d.ts

@@ -0,0 +1,18 @@
+export declare const SKILL_NAME_RE: RegExp;
+export declare const SHELL_DENYLIST: Set<string>;
+export declare const INLINE_CODE_INTERPRETERS: Set<string>;
+export declare const DANGEROUS_ENV_KEYS: Set<string>;
+export interface CommandCheck {
+    ok: boolean;
+    error?: string;
+}
+export declare function validateShellCommand(command: unknown): CommandCheck;
+export declare function validateEnvKeys(env: Record<string, string> | undefined): CommandCheck;
+export interface CwdCheck {
+    ok: boolean;
+    resolved?: string;
+    error?: string;
+}
+export declare function normalizeCwd(cwd: string | undefined, projectRoot: string): CwdCheck;
+export declare function buildShellEnv(nodeEnv: Record<string, string> | undefined, parentEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+                                            

package/dist/src/utils/shell-security.js

@@ -0,0 +1 @@
+"use strict";var u=exports&&exports.__createBinding||(Object.create?(function(e,r,n,s){if(s===void 0)s=n;var t=Object.getOwnPropertyDescriptor(r,n);if(!t||("get"in t?!r.__esModule:t.writable||t.configurable)){t={enumerable:true,get:function(){return r[n]}}}Object.defineProperty(e,s,t)}):(function(e,r,n,s){if(s===void 0)s=n;e[s]=r[n]}));var f=exports&&exports.__setModuleDefault||(Object.create?(function(e,r){Object.defineProperty(e,"default",{enumerable:true,value:r})}):function(e,r){e["default"]=r});var l=exports&&exports.__importStar||(function(){var e=function(r){e=Object.getOwnPropertyNames||function(n){var s=[];for(var t in n)if(Object.prototype.hasOwnProperty.call(n,t))s[s.length]=t;return s};return e(r)};return function(r){if(r&&r.__esModule)return r;var n={};if(r!=null){for(var s=e(r),t=0;t<s.length;t++)if(s[t]!=="default")u(n,r,s[t])}f(n,r);return n}})();Object.defineProperty(exports,"__esModule",{value:true});exports.DANGEROUS_ENV_KEYS=exports.INLINE_CODE_INTERPRETERS=exports.SHELL_DENYLIST=exports.SKILL_NAME_RE=void 0;exports.validateShellCommand=E;exports.validateEnvKeys=h;exports.normalizeCwd=d;exports.buildShellEnv=S;const a=l(require("path"));const i=l(require("fs"));exports.SKILL_NAME_RE=/^[a-z0-9][a-z0-9-]*$/;exports.SHELL_DENYLIST=new Set(["bash","sh","zsh","dash","fish","cmd","cmd.exe","powershell","powershell.exe","pwsh","pwsh.exe"]);exports.INLINE_CODE_INTERPRETERS=new Set(["python","python3","node","nodejs","deno","perl","ruby","php"]);const c=new Set(["-c","-e","--eval","--exec"]);exports.DANGEROUS_ENV_KEYS=new Set(["LD_PRELOAD","LD_LIBRARY_PATH","LD_AUDIT","DYLD_INSERT_LIBRARIES","DYLD_LIBRARY_PATH","DYLD_FRAMEWORK_PATH","NODE_OPTIONS"]);function _(e){return a.basename(e).toLowerCase()}function E(e){if(!Array.isArray(e)){return{ok:false,error:"shell_task.command must be an array of strings (argv), not a string"}}if(e.length===0){return{ok:false,error:"shell_task.command must not be empty"}}if(!e.every(s=>typeof s==="string")){return{ok:false,error:"shell_task.command must contain only strings"}}const r=_(e[0]);const n=r.replace(/\.exe$/,"");if(exports.SHELL_DENYLIST.has(r)||exports.SHELL_DENYLIST.has(n)){return{ok:false,error:`shell_task.command[0] "${e[0]}" is a blocked shell interpreter`}}if(exports.INLINE_CODE_INTERPRETERS.has(n)){const s=e.slice(1).some(t=>c.has(String(t)));if(s){return{ok:false,error:`shell_task.command "${n} ${e[1]}" uses an inline-code flag (escape vector blocked)`}}}return{ok:true}}function h(e){if(!e)return{ok:true};for(const r of Object.keys(e)){if(exports.DANGEROUS_ENV_KEYS.has(r)){return{ok:false,error:`shell_task.env key "${r}" is not allowed`}}}return{ok:true}}function d(e,r){let n;try{n=i.realpathSync(r)}catch(o){return{ok:false,error:`project root "${r}" is not accessible: ${o.message}`}}if(e===void 0||e===""){return{ok:true,resolved:n}}const s=a.resolve(n,e);let t;try{t=i.realpathSync(s)}catch(o){return{ok:false,error:`cwd "${e}" is not accessible: ${o.message}`}}if(t!==n&&!t.startsWith(n+a.sep)){return{ok:false,error:`cwd "${e}" resolves outside the project root`}}return{ok:true,resolved:t}}function S(e,r=process.env){const n=process.platform==="win32"?["PATH","Path","SystemRoot","COMSPEC","TEMP","TMP"]:["PATH","HOME","LANG","TMPDIR"];const s={};for(const t of n){if(r[t]!==void 0)s[t]=r[t]}if(e){for(const[t,o]of Object.entries(e)){s[t]=o}}return s}

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;
+                                                  

package/dist/src/workflow-persistence.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.createWorkflowPersistenceProjection=b;exports.previewWorkflowPersistenceProjection=m;const g=require("./card-state.js");const S=require("./parent-task-sync.js");function h(e){return e instanceof Error?e.message:String(e)}function _(e){return e}function w(e){if(Array.isArray(e))return`[${e.map(r=>w(r)).join(",")}]`;if(e!==null&&typeof e==="object"){const r=e;return`{${Object.keys(r).sort().map(i=>`${JSON.stringify(i)}:${w(r[i])}`).join(",")}}`}return JSON.stringify(e)??"null"}function A(e,r){return w(e)===w(r)}function P(e,r){return{runId:e,changedParentTaskIds:[...r.changedParentTaskIds],projectedAuditInstanceIds:[],errors:[]}}function b(e){const r={taskRepo:e.taskRepo,workspaceId:e.workspaceId,...e.parentKinds?{parentKinds:e.parentKinds}:{}};const i=(0,S.createWorkflowParentPersistSink)(r);const o=e.warn??(n=>console.warn(n));return n=>{let u;try{u=i(n)}catch(s){const t=`workflow persistence parent projection failed for ${n.id}: ${h(s)}`;o(t);return{runId:n.id,changedParentTaskIds:[],projectedAuditInstanceIds:[],errors:[t]}}const c=P(n.id,u);const d=(s,t)=>{const a=`workflow persistence ${s} failed for ${n.id}: ${h(t)}`;c.errors.push(a);o(a)};const p=[...new Set(u.linkedAuditInstanceIds)];if(p.length>0){let s;try{s=e.resolveWorkflowSpec(n);if(!s)throw new Error(`workflow spec not found for ${n.workflow_id}`)}catch(t){d("spec resolution",t)}if(s){let t=null;try{t=(0,g.buildWorkflowApprovalState)(n,s)}catch(a){d("audit state build",a)}if(t){const a=Date.parse(n.updated_at);if(!Number.isSafeInteger(a)||a<0){d("audit snapshot",new Error(`invalid run updated_at: ${n.updated_at}`))}else{let I=e.uiInstanceStore;if(!I&&e.getUiInstanceStore){try{I=e.getUiInstanceStore()}catch(l){d("audit store creation",l)}}if(!I){d("audit snapshot",new Error("no UiInstanceStore was provided"))}else{for(const l of p){try{const f=I.get(l);const $=f?.domainRef?.workflowRunId;if(!f||f.workspaceId!==e.workspaceId||$!==n.id){continue}const j=w(f.state);const y=f.updatedAt;const k=I.updateAuditSnapshot({instanceId:l,workspaceId:e.workspaceId,updatedAt:a,state:_(t)});if(k&&(w(k.state)!==j||k.updatedAt!==y)){c.projectedAuditInstanceIds.push(l)}}catch(f){d(`audit snapshot ${l}`,f)}}}}}}}if((c.changedParentTaskIds.length>0||c.projectedAuditInstanceIds.length>0)&&e.onChanged){try{e.onChanged(c)}catch(s){d("change callback",s)}}return c}}function m(e,r){const i=(0,S.previewWorkflowParentRepair)({taskRepo:e.taskRepo,run:r,workspaceId:e.workspaceId,...e.parentKinds?{parentKinds:e.parentKinds}:{}});const o={runId:r.id,runStatus:i.runStatus,parentChanges:[...i.changes],auditSnapshotChanges:[],errors:[]};const n=(t,a)=>{o.errors.push(`workflow persistence preview ${t} failed for ${r.id}: ${h(a)}`)};const u=[...new Set(i.linkedAuditInstanceIds)];if(u.length===0)return o;let c;try{c=e.resolveWorkflowSpec(r);if(!c)throw new Error(`workflow spec not found for ${r.workflow_id}`)}catch(t){n("spec resolution",t)}if(!c)return o;let d;try{d=(0,g.buildWorkflowApprovalState)(r,c)}catch(t){n("audit state build",t);return o}const p=Date.parse(r.updated_at);if(!Number.isSafeInteger(p)||p<0){n("audit snapshot",new Error(`invalid run updated_at: ${r.updated_at}`));return o}let s=e.uiInstanceStore;if(!s&&e.getUiInstanceStore){try{s=e.getUiInstanceStore()}catch(t){n("audit store creation",t)}}if(!s){n("audit snapshot",new Error("no UiInstanceStore was provided"));return o}for(const t of u){try{const a=s.get(t);if(!a||a.workspaceId!==e.workspaceId||a.domainRef.workflowRunId!==r.id){continue}if(!A(a.state,d)){o.auditSnapshotChanges.push({instanceId:t,before:a.state,after:d})}}catch(a){n(`audit snapshot ${t}`,a)}}void p;return o}

package/dist/workflow-schema.json

@@ -43,6 +43,10 @@
         },
         "version": {
           "type": "string"
+        },
+        "shell_task_allowed": {
+          "type": "boolean",
+          "description": "Opt-in gate (2nd factor) required to execute shell_task nodes. Combined with env CREWX_WORKFLOW_SHELL=1."
         }
       }
     },
@@ -52,11 +56,44 @@
       "properties": {
         "type": {
           "type": "string",
-          "enum": ["agent_task", "parallel", "join", "branch", "approval", "expression", "end"]
+          "enum": ["agent_task", "skill_task", "shell_task", "parallel", "join", "branch", "approval", "expression", "end", "error"]
         },
         "agent": {
           "type": "string"
         },
+        "skill": {
+          "type": "string",
+          "description": "skill_task: built-in/registered skill name. Must match ^[a-z0-9][a-z0-9-]*$ (no path traversal)."
+        },
+        "args": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "skill_task: extra CLI args appended after the skill name. Supports {{template}} interpolation."
+        },
+        "command": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "shell_task: argv array (never a plain string). command[0] is the program. Interpolated."
+        },
+        "cwd": {
+          "type": "string",
+          "description": "agent_task/skill_task/shell_task: working directory, normalized and constrained under the project root."
+        },
+        "env": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "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"]
@@ -76,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"
         },
@@ -125,6 +166,10 @@
         "comment": {
           "type": "string"
         },
+        "message": {
+          "type": "string",
+          "description": "error: failure message recorded in run.error. Supports {{template}} interpolation."
+        },
         "on_approve": {
           "type": "string"
         },
@@ -177,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.2",
+  "version": "0.3.22-rc.200",
   "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",
@@ -12,10 +25,28 @@
       "require": "./dist/src/engine.js",
       "default": "./dist/src/engine.js"
     },
+    "./run-manager": {
+      "types": "./dist/src/run-manager.d.ts",
+      "import": "./dist/src/run-manager.js",
+      "require": "./dist/src/run-manager.js",
+      "default": "./dist/src/run-manager.js"
+    },
+    "./types": {
+      "types": "./dist/src/types.d.ts",
+      "import": "./dist/src/types.js",
+      "require": "./dist/src/types.js",
+      "default": "./dist/src/types.js"
+    },
     "./cli": {
       "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": {
@@ -36,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.22"
+    "@crewx/knowledge-core": "0.1.17-rc.164",
+    "@crewx/shared": "0.0.6-rc.69",
+    "@crewx/sdk": "0.9.0-rc.154"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",