@pixelbyte-software/pixcode 1.42.1 → 1.42.2

package/dist/index.html

@@ -35,7 +35,7 @@
     
     <!-- Prevent zoom on iOS -->
     <meta name="format-detection" content="telephone=no" />
-    <script type="module" crossorigin src="/assets/index-C97kIvXz.js"></script>
+    <script type="module" crossorigin src="/assets/index-CMeiCqQf.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/vendor-react-D7WwDXvu.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-codemirror-CzYAOTxS.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-xterm-CJZjLICi.js">

package/dist-server/server/modules/orchestration/workflows/workflow-fallback-policy.js

@@ -0,0 +1,114 @@
+export const PIXCODE_FALLBACK_POLICY_PROTOCOL = 'pixcode.fallback-policy.v1';
+const DEFAULT_TRIGGERS = [
+    'provider_failure',
+    'timeout',
+    'tool_failure',
+    'invalid_output',
+];
+export const DEFAULT_WORKFLOW_FALLBACK_POLICY = {
+    protocol: PIXCODE_FALLBACK_POLICY_PROTOCOL,
+    enabled: true,
+    triggers: DEFAULT_TRIGGERS,
+    maxFallbacksPerRun: 3,
+    requireDifferentAgent: true,
+};
+function readRecord(value) {
+    return value && typeof value === 'object' ? value : undefined;
+}
+function readBoolean(value) {
+    return typeof value === 'boolean' ? value : undefined;
+}
+function readNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function isWorkflowFallbackTrigger(value) {
+    return value === 'provider_failure'
+        || value === 'timeout'
+        || value === 'tool_failure'
+        || value === 'invalid_output';
+}
+function readFallbackTriggers(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const triggers = value.filter(isWorkflowFallbackTrigger);
+    return triggers.length > 0 ? [...new Set(triggers)] : undefined;
+}
+export function readWorkflowFallbackPolicy(metadata) {
+    const settings = readRecord(metadata?.settings) ?? {};
+    const configured = readRecord(settings.fallbackPolicy) ?? {};
+    const maxFallbacksPerRun = readNumber(configured.maxFallbacksPerRun);
+    return {
+        protocol: PIXCODE_FALLBACK_POLICY_PROTOCOL,
+        enabled: readBoolean(configured.enabled) ?? DEFAULT_WORKFLOW_FALLBACK_POLICY.enabled,
+        triggers: readFallbackTriggers(configured.triggers) ?? DEFAULT_WORKFLOW_FALLBACK_POLICY.triggers,
+        maxFallbacksPerRun: maxFallbacksPerRun === undefined
+            ? DEFAULT_WORKFLOW_FALLBACK_POLICY.maxFallbacksPerRun
+            : Math.max(0, Math.min(8, Math.round(maxFallbacksPerRun))),
+        requireDifferentAgent: readBoolean(configured.requireDifferentAgent)
+            ?? DEFAULT_WORKFLOW_FALLBACK_POLICY.requireDifferentAgent,
+    };
+}
+export function classifyWorkflowFailure(reason, explicitTrigger) {
+    if (explicitTrigger)
+        return explicitTrigger;
+    const text = reason.toLocaleLowerCase('en');
+    if (/timed out|timeout|deadline/u.test(text))
+        return 'timeout';
+    if (/invalid (handoff|output|artifact|json|schema)|parse|protocol/u.test(text))
+        return 'invalid_output';
+    if (/tool|command|shell|exit code|permission|file write|write failed|network|fetch|curl|wget|gh |npm |git /u
+        .test(text)) {
+        return 'tool_failure';
+    }
+    return 'provider_failure';
+}
+function fallbackEventCount(run) {
+    return Array.isArray(run.metadata?.fallbackEvents) ? run.metadata.fallbackEvents.length : 0;
+}
+export function resolveWorkflowFallbackDecision({ run, node, reason, trigger, fallbackAgentInstanceId, }) {
+    const fallbackTrigger = classifyWorkflowFailure(reason, trigger);
+    const policy = readWorkflowFallbackPolicy(run.metadata);
+    if (!policy.enabled) {
+        return {
+            shouldFallback: false,
+            trigger: fallbackTrigger,
+            reason,
+            policy,
+            skippedReason: 'Fallback policy is disabled.',
+        };
+    }
+    if (!policy.triggers.includes(fallbackTrigger)) {
+        return {
+            shouldFallback: false,
+            trigger: fallbackTrigger,
+            reason,
+            policy,
+            skippedReason: `Fallback trigger ${fallbackTrigger} is not enabled.`,
+        };
+    }
+    if (fallbackEventCount(run) >= policy.maxFallbacksPerRun) {
+        return {
+            shouldFallback: false,
+            trigger: fallbackTrigger,
+            reason,
+            policy,
+            skippedReason: `Fallback limit ${policy.maxFallbacksPerRun} reached.`,
+        };
+    }
+    if (policy.requireDifferentAgent && fallbackAgentInstanceId && fallbackAgentInstanceId === node.agentInstanceId) {
+        return {
+            shouldFallback: false,
+            trigger: fallbackTrigger,
+            reason,
+            policy,
+            skippedReason: 'Fallback agent must be different from the failed agent.',
+        };
+    }
+    return {
+        shouldFallback: true,
+        trigger: fallbackTrigger,
+        reason,
+        policy,
+    };
+}
+//# sourceMappingURL=workflow-fallback-policy.js.map

package/dist-server/server/modules/orchestration/workflows/workflow-fallback-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-fallback-policy.js","sourceRoot":"","sources":["../../../../../server/modules/orchestration/workflows/workflow-fallback-policy.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gCAAgC,GAAG,4BAA4B,CAAC;AAoB7E,MAAM,gBAAgB,GAA8B;IAClD,kBAAkB;IAClB,SAAS;IACT,cAAc;IACd,gBAAgB;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAA2B;IACtE,QAAQ,EAAE,gCAAgC;IAC1C,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,gBAAgB;IAC1B,kBAAkB,EAAE,CAAC;IACrB,qBAAqB,EAAE,IAAI;CAC5B,CAAC;AAEF,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3F,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc;IAC/C,OAAO,KAAK,KAAK,kBAAkB;WAC9B,KAAK,KAAK,SAAS;WACnB,KAAK,KAAK,cAAc;WACxB,KAAK,KAAK,gBAAgB,CAAC;AAClC,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;IACzD,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAkC;IAC3E,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAC7D,MAAM,kBAAkB,GAAG,UAAU,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAErE,OAAO;QACL,QAAQ,EAAE,gCAAgC;QAC1C,OAAO,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,gCAAgC,CAAC,OAAO;QACpF,QAAQ,EAAE,oBAAoB,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,gCAAgC,CAAC,QAAQ;QAChG,kBAAkB,EAAE,kBAAkB,KAAK,SAAS;YAClD,CAAC,CAAC,gCAAgC,CAAC,kBAAkB;YACrD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAC5D,qBAAqB,EAAE,WAAW,CAAC,UAAU,CAAC,qBAAqB,CAAC;eAC/D,gCAAgC,CAAC,qBAAqB;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,MAAc,EACd,eAAyC;IAEzC,IAAI,eAAe;QAAE,OAAO,eAAe,CAAC;IAE5C,MAAM,IAAI,GAAG,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/D,IAAI,+DAA+D,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,gBAAgB,CAAC;IACxG,IACE,wGAAwG;SACrG,IAAI,CAAC,IAAI,CAAC,EACb,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAgB;IAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,EAC9C,GAAG,EACH,IAAI,EACJ,MAAM,EACN,OAAO,EACP,uBAAuB,GAOxB;IACC,MAAM,eAAe,GAAG,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,0BAA0B,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAExD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,cAAc,EAAE,KAAK;YACrB,OAAO,EAAE,eAAe;YACxB,MAAM;YACN,MAAM;YACN,aAAa,EAAE,8BAA8B;SAC9C,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAC/C,OAAO;YACL,cAAc,EAAE,KAAK;YACrB,OAAO,EAAE,eAAe;YACxB,MAAM;YACN,MAAM;YACN,aAAa,EAAE,oBAAoB,eAAe,kBAAkB;SACrE,CAAC;IACJ,CAAC;IACD,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;QACzD,OAAO;YACL,cAAc,EAAE,KAAK;YACrB,OAAO,EAAE,eAAe;YACxB,MAAM;YACN,MAAM;YACN,aAAa,EAAE,kBAAkB,MAAM,CAAC,kBAAkB,WAAW;SACtE,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,qBAAqB,IAAI,uBAAuB,IAAI,uBAAuB,KAAK,IAAI,CAAC,eAAe,EAAE,CAAC;QAChH,OAAO;YACL,cAAc,EAAE,KAAK;YACrB,OAAO,EAAE,eAAe;YACxB,MAAM;YACN,MAAM;YACN,aAAa,EAAE,yDAAyD;SACzE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,cAAc,EAAE,IAAI;QACpB,OAAO,EAAE,eAAe;QACxB,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist-server/server/modules/orchestration/workflows/workflow-replay.js

@@ -0,0 +1,177 @@
+import { redactTraceText } from '../../../modules/orchestration/workflows/workflow-trace.js';
+export const PIXCODE_REPLAY_PROTOCOL = 'pixcode.workflow-replay.v1';
+function safeNodeId(value) {
+    return value.replace(/[^a-zA-Z0-9_]+/g, '_').slice(0, 48) || 'node';
+}
+function readRecord(value) {
+    return value && typeof value === 'object' ? value : undefined;
+}
+function visibleNodes(run) {
+    return run.nodeRuns.filter((node) => !node.internal);
+}
+function defaultReplayNode(run) {
+    return visibleNodes(run).find((node) => node.status === 'failed')
+        ?? [...visibleNodes(run)].reverse().find((node) => node.status !== 'skipped')
+        ?? visibleNodes(run)[0];
+}
+function selectReplayNodes(run, scope, fromNodeId) {
+    const nodes = visibleNodes(run);
+    if (scope === 'run')
+        return nodes;
+    const requested = fromNodeId
+        ? nodes.find((node) => node.nodeId === fromNodeId)
+        : defaultReplayNode(run);
+    return requested ? [requested] : [];
+}
+function compact(value, run, maxLength = 1_200) {
+    return redactTraceText(value, run, maxLength);
+}
+function nodeTraceSummary(run, node) {
+    const artifactTypes = (node.artifacts ?? []).map((artifact) => artifact.type).filter(Boolean);
+    return [
+        `Step: ${node.agentLabel || node.nodeId}`,
+        `Node id: ${node.nodeId}`,
+        `Status: ${node.status}`,
+        node.stage ? `Stage: ${node.stage}` : undefined,
+        node.adapterId ? `Adapter: ${node.adapterId}` : undefined,
+        node.model ? `Model: ${node.model}` : undefined,
+        node.error ? `Error: ${compact(node.error, run, 800)}` : undefined,
+        artifactTypes.length > 0 ? `Artifacts: ${artifactTypes.join(', ')}` : undefined,
+        node.outputText ? `Output excerpt:\n${compact(node.outputText, run)}` : undefined,
+    ].filter(Boolean).join('\n');
+}
+function replayTraceSummary(run, nodes) {
+    return nodes.map((node) => nodeTraceSummary(run, node)).join('\n\n---\n\n');
+}
+function pushOperation(operations, kind, nodeId, summary) {
+    if (operations.some((operation) => operation.kind === kind && operation.nodeId === nodeId && operation.summary === summary)) {
+        return;
+    }
+    operations.push({ kind, nodeId, summary });
+}
+function detectReplayOperations(run, nodes) {
+    const operations = [];
+    for (const node of nodes) {
+        for (const artifact of node.artifacts ?? []) {
+            if (artifact.type === 'file-diff') {
+                pushOperation(operations, 'file-write', node.nodeId, 'Prior step produced a file diff artifact.');
+            }
+            if (artifact.type === 'command-output') {
+                pushOperation(operations, 'shell', node.nodeId, 'Prior step produced command output.');
+            }
+            const text = [artifact.text, artifact.data ? JSON.stringify(artifact.data) : undefined]
+                .filter(Boolean)
+                .join('\n')
+                .toLocaleLowerCase('en');
+            if (/https?:\/\/|curl |wget |gh |npm publish|npm install|git push|ssh /u.test(text)) {
+                pushOperation(operations, 'network', node.nodeId, 'Prior artifact references a network-capable operation.');
+            }
+        }
+        const text = [node.outputText, node.error, node.promptPreview].filter(Boolean).join('\n').toLocaleLowerCase('en');
+        if (/apply_patch|write file|file write|modified files|changed files/u.test(text)) {
+            pushOperation(operations, 'file-write', node.nodeId, 'Prior step text references file-write activity.');
+        }
+        if (/shell|command|terminal|npm run|node |python |php |go test|cargo |make |exit code/u.test(text)) {
+            pushOperation(operations, 'shell', node.nodeId, 'Prior step text references shell execution.');
+        }
+        if (/https?:\/\/|curl |wget |gh |npm publish|npm install|git push|ssh |network/u.test(text)) {
+            pushOperation(operations, 'network', node.nodeId, 'Prior step text references a network-capable operation.');
+        }
+    }
+    return operations;
+}
+function replayNodeFromRunNode(node, index, previousReplayNodeId, traceSummary, limitations, requiresApproval) {
+    const replayNodeId = `replay_${index + 1}_${safeNodeId(node.nodeId)}`;
+    return {
+        id: replayNodeId,
+        adapterId: node.adapterId || 'claude-code',
+        agentInstanceId: node.agentInstanceId,
+        agentLabel: node.agentLabel ? `${node.agentLabel} Replay` : 'Replay agent',
+        assignment: node.assignment ? `Replay: ${node.assignment}` : `Replay source node ${node.nodeId}`,
+        stage: node.stage ? `replay_${node.stage}` : 'replay',
+        model: node.model,
+        permissionMode: node.permissionMode === 'bypassPermissions' ? 'default' : node.permissionMode,
+        timeoutMs: node.timeoutMs,
+        inputs: previousReplayNodeId ? [previousReplayNodeId] : [],
+        output: 'both',
+        onFail: 'abort',
+        prompt: [
+            'This is a Pixcode workflow replay run.',
+            `Replay protocol: ${PIXCODE_REPLAY_PROTOCOL}`,
+            `Source node: ${node.nodeId}`,
+            requiresApproval
+                ? 'Replay safety review found prior shell, network, or file-write activity. Do not repeat any such action unless the current CLI permission flow asks for and receives user approval.'
+                : 'Replay safety review did not find prior shell, network, or file-write artifacts, but still avoid destructive actions unless they are required and approved.',
+            'Use the trace summary to continue from the failure or inspect the run. Do not expose secrets, local-only paths, raw tool protocol, or irrelevant logs.',
+            `Known limitations:\n- ${limitations.join('\n- ')}`,
+            `Trace summary:\n${traceSummary}`,
+            `Original step prompt:\n${node.promptPreview || '(No source prompt was stored.)'}`,
+        ].join('\n\n'),
+    };
+}
+export function buildWorkflowReplayPlan(run, options = {}) {
+    const scope = options.scope ?? 'node';
+    const nodes = selectReplayNodes(run, scope, options.fromNodeId);
+    if (nodes.length === 0) {
+        throw new Error('No replayable workflow steps were found.');
+    }
+    const limitations = [
+        'Replay uses stored run traces, prompt previews, messages, and artifacts; it cannot reproduce hidden provider state.',
+        'Replay reconstructs selected steps as a new workflow run instead of mutating the source run.',
+        'Shell, network, and file-write actions stay under the current CLI permission flow and require explicit replay approval when detected.',
+    ];
+    const destructiveOperations = detectReplayOperations(run, nodes);
+    const requiresApproval = destructiveOperations.length > 0;
+    const traceSummary = replayTraceSummary(run, nodes);
+    const replayNodes = nodes.reduce((accumulator, node, index) => {
+        const previousReplayNodeId = accumulator[accumulator.length - 1]?.id;
+        accumulator.push(replayNodeFromRunNode(node, index, scope === 'run' ? previousReplayNodeId : undefined, traceSummary, limitations, requiresApproval));
+        return accumulator;
+    }, []);
+    const settings = readRecord(run.metadata?.settings) ?? {};
+    const replayMetadata = {
+        protocol: PIXCODE_REPLAY_PROTOCOL,
+        sourceRunId: run.id,
+        sourceWorkflowId: run.workflowId,
+        scope,
+        fromNodeId: options.fromNodeId,
+        selectedNodeIds: nodes.map((node) => node.nodeId),
+        requiresApproval,
+        destructiveOperations,
+        limitations,
+        createdAt: Date.now(),
+    };
+    return {
+        protocol: PIXCODE_REPLAY_PROTOCOL,
+        sourceRunId: run.id,
+        sourceWorkflowId: run.workflowId,
+        scope,
+        fromNodeId: options.fromNodeId,
+        selectedNodeIds: nodes.map((node) => node.nodeId),
+        requiresApproval,
+        approvalReasons: destructiveOperations.map((operation) => `${operation.kind}${operation.nodeId ? ` in ${operation.nodeId}` : ''}: ${operation.summary}`),
+        destructiveOperations,
+        limitations,
+        input: [
+            `Replay ${scope === 'run' ? 'full workflow run' : 'workflow step'} from source run ${run.id}.`,
+            run.input ? `Original request:\n${compact(run.input, run, 2_000)}` : undefined,
+        ].filter(Boolean).join('\n\n'),
+        workflow: {
+            id: `${run.workflowId}_replay`,
+            name: `Replay ${run.workflowId}`,
+            description: 'Replay generated from stored Pixcode workflow trace data.',
+            trigger: 'manual',
+            nodes: replayNodes,
+        },
+        metadata: {
+            ...run.metadata,
+            workflowName: `Replay: ${String(run.metadata?.workflowName ?? run.workflowId)}`,
+            replay: replayMetadata,
+            settings: {
+                ...settings,
+                replayMode: true,
+            },
+        },
+    };
+}
+//# sourceMappingURL=workflow-replay.js.map

package/dist-server/server/modules/orchestration/workflows/workflow-replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-replay.js","sourceRoot":"","sources":["../../../../../server/modules/orchestration/workflows/workflow-replay.ts"],"names":[],"mappings":"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"}

package/dist-server/server/modules/orchestration/workflows/workflow-runner.js

@@ -1,6 +1,7 @@
 import crypto from 'node:crypto';
 import { PIXCODE_HANDOFF_PROTOCOL, formatHandoffArtifactForContext, handoffArtifactToWorkflowArtifact, parseHandoffArtifact, } from '../../../modules/orchestration/workflows/handoff-artifact.js';
 import { buildWorkflowContextPacket, formatContextPacketForPrompt, } from '../../../modules/orchestration/workflows/context-packet.js';
+import { classifyWorkflowFailure, resolveWorkflowFallbackDecision, } from '../../../modules/orchestration/workflows/workflow-fallback-policy.js';
 import { resolveWorkflowWorkspace, workspaceContextPrompt, workspaceTargetMetadata, } from '../../../modules/orchestration/workflows/workspace-target.js';
 import { workflowStore } from '../../../modules/orchestration/workflows/workflow-store.js';
 // @ts-ignore — plain-JS service
@@ -925,6 +926,8 @@ function nodeRunFromNode(node) {
         timeoutMs: node.timeoutMs,
         stage: node.stage,
         internal: node.internal,
+        fallbackTrigger: node.fallbackTrigger,
+        fallbackSourceNodeId: node.fallbackSourceNodeId,
         status: 'queued',
     };
 }
@@ -1060,7 +1063,7 @@ class WorkflowRunner {
         }
         return readAgentAssignments(run.metadata).find((agent) => agent.instanceId === fallbackAgentInstanceId);
     }
-    createFallbackNode(node, fallbackAgent, reason) {
+    createFallbackNode(node, fallbackAgent, reason, fallbackTrigger) {
         const fallbackSuffix = safeNodeId(fallbackAgent.instanceId, 'fallback');
         return {
             ...node,
@@ -1073,9 +1076,12 @@ class WorkflowRunner {
             model: fallbackAgent.model,
             permissionMode: fallbackAgent.permissionMode,
             toolsSettings: fallbackAgent.toolsSettings,
+            fallbackTrigger,
+            fallbackSourceNodeId: node.id,
             prompt: [
                 'The previous CLI agent failed on this orchestration step.',
                 `Failed step: ${node.agentLabel || node.id}`,
+                `Fallback trigger: ${fallbackTrigger}`,
                 `Failure: ${reason}`,
                 'Take over the same assignment as the backup CLI. Use the original goal and upstream context.',
                 'Do not repeat unrelated work; complete the failed step and report what you did.',
@@ -1084,9 +1090,41 @@ class WorkflowRunner {
             onFail: 'continue',
         };
     }
-    async runFallbackAfterFailure(node, workflow, run, outputs, started, completed, reason) {
+    recordFallbackSkipped(run, node, reason, fallbackTrigger, skippedReason) {
+        const fallbackSkippedEvents = Array.isArray(run.metadata?.fallbackSkippedEvents)
+            ? run.metadata.fallbackSkippedEvents
+            : [];
+        run.metadata = {
+            ...run.metadata,
+            fallbackSkippedEvents: [
+                ...fallbackSkippedEvents,
+                {
+                    nodeId: node.id,
+                    trigger: fallbackTrigger,
+                    reason,
+                    skippedReason,
+                    createdAt: Date.now(),
+                },
+            ],
+        };
+        workflowStore.setRun(run);
+    }
+    async runFallbackAfterFailure(node, workflow, run, outputs, started, completed, reason, trigger) {
+        const fallbackTrigger = classifyWorkflowFailure(reason, trigger);
         const fallbackAgent = this.fallbackAgentFor(run, node);
         if (!fallbackAgent) {
+            this.recordFallbackSkipped(run, node, reason, fallbackTrigger, 'No fallback agent is configured for this run.');
+            return false;
+        }
+        const decision = resolveWorkflowFallbackDecision({
+            run,
+            node,
+            reason,
+            trigger: fallbackTrigger,
+            fallbackAgentInstanceId: fallbackAgent.instanceId,
+        });
+        if (!decision.shouldFallback) {
+            this.recordFallbackSkipped(run, node, reason, decision.trigger, decision.skippedReason ?? 'Fallback policy skipped this failure.');
             return false;
         }
         if (workflow.nodes.length + 1 > 64) {
@@ -1097,7 +1135,7 @@ class WorkflowRunner {
             workflowStore.setRun(run);
             return false;
         }
-        let fallbackNode = this.createFallbackNode(node, fallbackAgent, reason);
+        let fallbackNode = this.createFallbackNode(node, fallbackAgent, reason, decision.trigger);
         let collision = 1;
         while (workflow.nodes.some((candidate) => candidate.id === fallbackNode.id)) {
             collision += 1;
@@ -1131,6 +1169,8 @@ class WorkflowRunner {
                     nodeId: node.id,
                     fallbackNodeId: fallbackNode.id,
                     fallbackAgentInstanceId: fallbackAgent.instanceId,
+                    trigger: decision.trigger,
+                    policy: decision.policy,
                     reason,
                     startedAt: Date.now(),
                 },
@@ -1412,7 +1452,7 @@ class WorkflowRunner {
                 workflowStore.setRun(run);
                 return;
             }
-            if (await this.runFallbackAfterFailure(node, workflow, run, outputs, started, completed, nodeRun.error)) {
+            if (await this.runFallbackAfterFailure(node, workflow, run, outputs, started, completed, nodeRun.error, 'provider_failure')) {
                 return;
             }
             if (node.onFail === 'continue') {
@@ -1457,7 +1497,7 @@ class WorkflowRunner {
                 workflowStore.setRun(run);
                 return;
             }
-            if (await this.runFallbackAfterFailure(node, workflow, run, outputs, started, completed, nodeRun.error)) {
+            if (await this.runFallbackAfterFailure(node, workflow, run, outputs, started, completed, nodeRun.error, 'timeout')) {
                 return;
             }
             if (node.onFail === 'continue') {
@@ -1491,7 +1531,7 @@ class WorkflowRunner {
                     nodeRun.status = 'failed';
                     nodeRun.error = visibleHandoffError;
                     workflowStore.setRun(run);
-                    if (await this.runFallbackAfterFailure(node, workflow, run, outputs, started, completed, visibleHandoffError)) {
+                    if (await this.runFallbackAfterFailure(node, workflow, run, outputs, started, completed, visibleHandoffError, 'invalid_output')) {
                         return;
                     }
                     if (node.onFail === 'continue') {
@@ -1527,7 +1567,7 @@ class WorkflowRunner {
             workflowStore.setRun(run);
             return;
         }
-        if (await this.runFallbackAfterFailure(node, workflow, run, outputs, started, completed, nodeRun.error)) {
+        if (await this.runFallbackAfterFailure(node, workflow, run, outputs, started, completed, nodeRun.error, classifyWorkflowFailure(`${nodeRun.error}\n${nodeRun.outputText ?? ''}`))) {
             return;
         }
         if (node.onFail === 'continue') {