@xyne/workflow-ui 0.1.0

package/dist/hooks/use-execution-viewer.js

@@ -0,0 +1,380 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { useWorkflowClient } from './use-workflow-client.js';
+function mapStatus(rawStatus) {
+    switch (rawStatus) {
+        case 'COMPLETED': return 'completed';
+        case 'FAILED': return 'failed';
+        case 'CANCELLED': return 'cancelled';
+        case 'EXTERNAL_WAIT': return 'paused';
+        case 'RUNNING': return 'running';
+        default: return 'pending';
+    }
+}
+function mapStepStatus(rawStatus) {
+    switch (rawStatus) {
+        case 'COMPLETED': return 'completed';
+        case 'FAILED': return 'failed';
+        case 'RUNNING': return 'running';
+        case 'PAUSED':
+        case 'EXTERNAL_WAIT': return 'paused';
+        case 'SKIPPED': return 'skipped';
+        default: return 'pending';
+    }
+}
+/**
+ * Build step states map from execution detail's step rows.
+ *
+ * The API uses "step_0", "step_1" etc. as keys, but the layout engine
+ * uses the step's config ID (e.g. "agent_analysis"). We resolve
+ * step_N → config.steps[N].id so the layout can match.
+ *
+ * Nested steps (inside PARALLEL branches, LOOP bodies, etc.) don't get
+ * their own rows from the executor — their results are embedded in the
+ * parent step's output. We recursively walk the config tree and
+ * synthesize states for any missing nested steps based on the parent.
+ */
+function buildStepStates(detail) {
+    const map = new Map();
+    if (!detail.steps)
+        return map;
+    // Build step_N → config step ID mapping
+    const configSteps = detail.config?.steps;
+    const stepKeyMap = new Map();
+    if (configSteps) {
+        for (let i = 0; i < configSteps.length; i++) {
+            stepKeyMap.set(`step_${i}`, configSteps[i].id);
+        }
+    }
+    for (const step of detail.steps) {
+        let stepData;
+        if (step.data) {
+            try {
+                stepData = JSON.parse(step.data);
+            }
+            catch {
+                // Ignore parse errors
+            }
+        }
+        // Resolve step_N to the config's step ID for layout matching
+        const resolvedKey = stepKeyMap.get(step.stepName) ?? step.stepName;
+        const state = {
+            stepName: resolvedKey,
+            stepType: step.executorType,
+            status: mapStepStatus(step.status),
+        };
+        const input = stepData?.['input'];
+        if (input)
+            state.input = input;
+        const output = stepData?.['output'];
+        if (output)
+            state.output = output;
+        const err = stepData?.['error'];
+        if (err)
+            state.error = err;
+        const pauseStateRaw = stepData?.['pauseState'];
+        if (pauseStateRaw)
+            state.pauseState = pauseStateRaw;
+        map.set(resolvedKey, state);
+    }
+    // Synthesize states for nested steps (branch sub-steps, loop bodies, etc.)
+    if (configSteps) {
+        synthesizeNestedStates(configSteps, map);
+    }
+    return map;
+}
+/**
+ * Recursively walk config steps and synthesize execution states for
+ * nested steps that the executor doesn't emit as separate rows.
+ *
+ * Works at any depth: parallel → loop → parallel → … etc.
+ * If a parent step has a known state, its children inherit accordingly.
+ * For PARALLEL branches we also inspect the per-branch result to
+ * distinguish fulfilled vs rejected sub-steps and attach output to
+ * the last step in each branch.
+ */
+function synthesizeNestedStates(steps, map, inheritedStatus) {
+    for (const step of steps) {
+        const state = map.get(step.id);
+        const effectiveStatus = state?.status ?? inheritedStatus;
+        const cfg = step.config;
+        if (!cfg)
+            continue;
+        // ─── Multi-branch containers (PARALLEL, CONDITIONAL, etc.) ───
+        const branches = cfg['branches'];
+        if (branches && typeof branches === 'object' && !Array.isArray(branches)) {
+            // Per-branch results from the parent's output (allSettled shape)
+            const outputBranches = state?.output?.['branches'];
+            for (const [branchName, branchSteps] of Object.entries(branches)) {
+                if (!Array.isArray(branchSteps))
+                    continue;
+                const typed = branchSteps;
+                const branchResult = outputBranches?.[branchName];
+                for (let i = 0; i < typed.length; i++) {
+                    const sub = typed[i];
+                    if (!map.has(sub.id) && effectiveStatus) {
+                        const synth = effectiveStatus === 'completed'
+                            ? (branchResult?.status === 'rejected' ? 'failed' : 'completed')
+                            : effectiveStatus === 'running' ? 'running'
+                                : effectiveStatus === 'failed' ? 'failed'
+                                    : undefined;
+                        if (synth) {
+                            const subState = {
+                                stepName: sub.id,
+                                stepType: sub.type,
+                                status: synth,
+                            };
+                            // Attach branch value as the last step's output
+                            if (synth === 'completed' && i === typed.length - 1 && branchResult?.value) {
+                                subState.output = branchResult.value;
+                            }
+                            map.set(sub.id, subState);
+                        }
+                    }
+                }
+                // Recurse into branch steps for deeper nesting
+                synthesizeNestedStates(typed, map, effectiveStatus);
+            }
+        }
+        // ─── Single-branch containers (LOOP, etc.) ───
+        const body = cfg['body'];
+        if (Array.isArray(body)) {
+            const bodySteps = body;
+            for (const sub of bodySteps) {
+                if (!map.has(sub.id) && effectiveStatus) {
+                    const synth = effectiveStatus === 'completed' ? 'completed'
+                        : effectiveStatus === 'running' ? 'running'
+                            : effectiveStatus === 'failed' ? 'failed'
+                                : undefined;
+                    if (synth) {
+                        map.set(sub.id, {
+                            stepName: sub.id,
+                            stepType: sub.type,
+                            status: synth,
+                        });
+                    }
+                }
+            }
+            // Recurse into body steps for deeper nesting
+            synthesizeNestedStates(bodySteps, map, effectiveStatus);
+        }
+    }
+}
+export function useExecutionViewer(opts) {
+    const { executionId, pollingInterval = 3000 } = opts;
+    const client = useWorkflowClient();
+    const [execution, setExecution] = useState(undefined);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [selectedStepName, setSelectedStepName] = useState(null);
+    const [stepStates, setStepStates] = useState(new Map());
+    const [overrideStatus, setOverrideStatus] = useState(null);
+    const [refreshKey, setRefreshKey] = useState(0);
+    const sseActiveRef = useRef(false);
+    // Derive status from execution or override (SSE events update override)
+    const status = overrideStatus ?? (execution ? mapStatus(execution.status) : 'pending');
+    const isTerminal = status === 'completed' || status === 'failed' || status === 'cancelled';
+    // ─── SSE connection ───
+    useEffect(() => {
+        const sseUrl = `${client.baseUrl.replace(/\/+$/, '')}/executions/${executionId}/stream`;
+        let es = null;
+        try {
+            es = new EventSource(sseUrl);
+        }
+        catch {
+            // EventSource not available — fall back to polling
+            return;
+        }
+        let opened = false;
+        es.addEventListener('snapshot', (e) => {
+            opened = true;
+            sseActiveRef.current = true;
+            try {
+                const detail = JSON.parse(e.data);
+                setExecution(detail);
+                setStepStates(buildStepStates(detail));
+                setOverrideStatus(mapStatus(detail.status));
+                setIsLoading(false);
+                setError(null);
+            }
+            catch {
+                // ignore parse errors
+            }
+        });
+        es.addEventListener('step_started', (e) => {
+            try {
+                const data = JSON.parse(e.data);
+                setStepStates((prev) => {
+                    const next = new Map(prev);
+                    // Find the step_N key for this stepName (id)
+                    const key = findStepKey(prev, data.stepName) ?? data.stepName;
+                    next.set(key, {
+                        ...(prev.get(key) ?? { stepName: key, stepType: data.stepType, status: 'pending' }),
+                        status: 'running',
+                        stepType: data.stepType,
+                    });
+                    return next;
+                });
+                setOverrideStatus('running');
+            }
+            catch { /* ignore */ }
+        });
+        es.addEventListener('step_completed', (e) => {
+            try {
+                const data = JSON.parse(e.data);
+                setStepStates((prev) => {
+                    const next = new Map(prev);
+                    const key = findStepKey(prev, data.stepName) ?? data.stepName;
+                    next.set(key, {
+                        ...(prev.get(key) ?? { stepName: key, stepType: '', status: 'pending' }),
+                        status: 'completed',
+                        output: data.output,
+                    });
+                    return next;
+                });
+            }
+            catch { /* ignore */ }
+        });
+        es.addEventListener('step_failed', (e) => {
+            try {
+                const data = JSON.parse(e.data);
+                setStepStates((prev) => {
+                    const next = new Map(prev);
+                    const key = findStepKey(prev, data.stepName) ?? data.stepName;
+                    next.set(key, {
+                        ...(prev.get(key) ?? { stepName: key, stepType: '', status: 'pending' }),
+                        status: 'failed',
+                        error: data.error,
+                    });
+                    return next;
+                });
+            }
+            catch { /* ignore */ }
+        });
+        es.addEventListener('execution_paused', (e) => {
+            try {
+                const data = JSON.parse(e.data);
+                setStepStates((prev) => {
+                    const next = new Map(prev);
+                    const key = findStepKey(prev, data.stepName) ?? data.stepName;
+                    next.set(key, {
+                        ...(prev.get(key) ?? { stepName: key, stepType: '', status: 'pending' }),
+                        status: 'paused',
+                        pauseState: data.pauseState,
+                    });
+                    return next;
+                });
+                setOverrideStatus('paused');
+            }
+            catch { /* ignore */ }
+        });
+        es.addEventListener('execution_completed', () => {
+            setOverrideStatus('completed');
+            es?.close();
+        });
+        es.addEventListener('execution_failed', (e) => {
+            try {
+                const data = JSON.parse(e.data);
+                setError(new Error(data.error));
+            }
+            catch { /* ignore */ }
+            setOverrideStatus('failed');
+            es?.close();
+        });
+        es.addEventListener('execution_cancelled', () => {
+            setOverrideStatus('cancelled');
+            es?.close();
+        });
+        es.onerror = () => {
+            if (!opened) {
+                // SSE never connected — fall through to polling
+                sseActiveRef.current = false;
+                es?.close();
+            }
+            // If it connected before, EventSource will auto-reconnect
+        };
+        return () => {
+            sseActiveRef.current = false;
+            es?.close();
+        };
+    }, [client.baseUrl, executionId]);
+    // ─── Polling fallback (only when SSE is not active) ───
+    useEffect(() => {
+        if (sseActiveRef.current)
+            return;
+        let cancelled = false;
+        setIsLoading(true);
+        void (async () => {
+            try {
+                const detail = await client.executions.get(executionId);
+                if (!cancelled) {
+                    setExecution(detail);
+                    setStepStates(buildStepStates(detail));
+                    setError(null);
+                }
+            }
+            catch (err) {
+                if (!cancelled)
+                    setError(err instanceof Error ? err : new Error(String(err)));
+            }
+            finally {
+                if (!cancelled)
+                    setIsLoading(false);
+            }
+        })();
+        return () => { cancelled = true; };
+    }, [client, executionId, refreshKey]);
+    // Polling timer (only when SSE not active and execution is not terminal)
+    useEffect(() => {
+        if (sseActiveRef.current || isTerminal || isLoading)
+            return;
+        const timer = setInterval(() => {
+            setRefreshKey((k) => k + 1);
+        }, pollingInterval);
+        return () => clearInterval(timer);
+    }, [isTerminal, isLoading, pollingInterval]);
+    const activeStepName = useMemo(() => {
+        for (const [name, state] of stepStates) {
+            if (state.status === 'running' || state.status === 'paused')
+                return name;
+        }
+        return null;
+    }, [stepStates]);
+    const selectStep = useCallback((name) => {
+        setSelectedStepName(name);
+    }, []);
+    const refetch = useCallback(() => {
+        // Force a fresh fetch — useful after resume/cancel
+        setOverrideStatus(null);
+        setRefreshKey((k) => k + 1);
+    }, []);
+    const triggerData = execution?.triggerData;
+    return {
+        execution,
+        isLoading,
+        error,
+        stepStates,
+        triggerData,
+        activeStepName,
+        status,
+        selectedStepName,
+        selectStep,
+        refetch,
+    };
+}
+/**
+ * The executor emits events with step IDs (e.g. "agent_analysis") but
+ * stepStates keys use step_N format (e.g. "step_0"). This helper finds
+ * the matching key by checking the stepName stored in the state value.
+ */
+function findStepKey(states, stepId) {
+    // If there's a direct match, use it
+    if (states.has(stepId))
+        return stepId;
+    // Search by stepName field (which often stores the step_N key)
+    for (const [key, state] of states) {
+        if (state.stepName === stepId)
+            return key;
+    }
+    return undefined;
+}
+//# sourceMappingURL=use-execution-viewer.js.map

package/dist/hooks/use-execution-viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-execution-viewer.js","sourceRoot":"","sources":["../../src/hooks/use-execution-viewer.ts"],"names":[],"mappings":"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"}

package/dist/hooks/use-pause-interaction.d.ts

@@ -0,0 +1,13 @@
+import type { PauseAction } from '@xyne/workflow-sdk';
+export interface UsePauseInteractionOptions {
+    executionId: string;
+    onResume?: (() => void) | undefined;
+}
+export interface UsePauseInteractionReturn {
+    /** Execute an action — sends form data for non-abort actions, aborts for abort actions. */
+    executeAction: (action: PauseAction, formValues?: Record<string, unknown>) => Promise<void>;
+    isSubmitting: boolean;
+    error: Error | null;
+}
+export declare function usePauseInteraction(opts: UsePauseInteractionOptions): UsePauseInteractionReturn;
+//# sourceMappingURL=use-pause-interaction.d.ts.map

package/dist/hooks/use-pause-interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-pause-interaction.d.ts","sourceRoot":"","sources":["../../src/hooks/use-pause-interaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQtD,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,yBAAyB;IACxC,2FAA2F;IAC3F,aAAa,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AA6CD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,0BAA0B,GAAG,yBAAyB,CAiC/F"}

package/dist/hooks/use-pause-interaction.js

@@ -0,0 +1,72 @@
+import { useCallback, useState } from 'react';
+import { useWorkflowClient } from './use-workflow-client.js';
+const VALID_ACTIONS = new Set([
+    'approve',
+    'retry',
+    'abort',
+]);
+/**
+ * Map a pause-action key onto a valid `ResumeAction`. Unknown keys fall back
+ * to `'approve'` — the safe "continue" default for mid-execution pauses.
+ */
+function resolveResumeAction(key) {
+    return VALID_ACTIONS.has(key) ? key : 'approve';
+}
+/**
+ * Split raw form values into the typed `ResumePayload` slots.
+ * Known fields (`feedback`, `attachments`) live on the payload root; everything
+ * else goes into `data` so step-specific fields survive the router's
+ * shape validation.
+ */
+function buildResumePayload(action, formValues) {
+    const payload = { action };
+    if (!formValues)
+        return payload;
+    const rest = {};
+    for (const [key, value] of Object.entries(formValues)) {
+        if (key === 'feedback') {
+            if (typeof value === 'string' && value.length > 0)
+                payload.feedback = value;
+        }
+        else if (key === 'attachments') {
+            if (Array.isArray(value) && value.length > 0) {
+                payload.attachments = value;
+            }
+        }
+        else {
+            rest[key] = value;
+        }
+    }
+    if (Object.keys(rest).length > 0)
+        payload.data = rest;
+    return payload;
+}
+export function usePauseInteraction(opts) {
+    const { executionId, onResume } = opts;
+    const client = useWorkflowClient();
+    const [isSubmitting, setIsSubmitting] = useState(false);
+    const [error, setError] = useState(null);
+    const executeAction = useCallback(async (action, formValues) => {
+        setIsSubmitting(true);
+        setError(null);
+        try {
+            if (action.abort) {
+                await client.executions.resume(executionId, { abort: true });
+            }
+            else {
+                const resumeAction = resolveResumeAction(action.key);
+                const data = buildResumePayload(resumeAction, action.submitsForm !== false ? formValues : undefined);
+                await client.executions.resume(executionId, { data });
+            }
+            onResume?.();
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setIsSubmitting(false);
+        }
+    }, [client, executionId, onResume]);
+    return { executeAction, isSubmitting, error };
+}
+//# sourceMappingURL=use-pause-interaction.js.map

package/dist/hooks/use-pause-interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-pause-interaction.js","sourceRoot":"","sources":["../../src/hooks/use-pause-interaction.ts"],"names":[],"mappings":"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"}

package/dist/hooks/use-runs-list.d.ts

@@ -0,0 +1,20 @@
+import type { ExecutionRecord } from '@xyne/workflow-sdk/client';
+export interface UseRunsListOptions {
+    workflowId?: string;
+    status?: string;
+    autoRefresh?: boolean;
+    autoRefreshInterval?: number;
+}
+export interface UseRunsListReturn {
+    executions: ExecutionRecord[];
+    isLoading: boolean;
+    error: Error | null;
+    hasMore: boolean;
+    loadMore: () => void;
+    refetch: () => void;
+    trigger: (workflowId: string, payload?: Record<string, unknown>) => Promise<{
+        executionId: string;
+    }>;
+}
+export declare function useRunsList(opts?: UseRunsListOptions): UseRunsListReturn;
+//# sourceMappingURL=use-runs-list.d.ts.map

package/dist/hooks/use-runs-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-runs-list.d.ts","sourceRoot":"","sources":["../../src/hooks/use-runs-list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtG;AAED,wBAAgB,WAAW,CAAC,IAAI,GAAE,kBAAuB,GAAG,iBAAiB,CA2F5E"}

package/dist/hooks/use-runs-list.js

@@ -0,0 +1,89 @@
+import { useCallback, useEffect, useState } from 'react';
+import { useWorkflowClient } from './use-workflow-client.js';
+export function useRunsList(opts = {}) {
+    const { workflowId, status, autoRefresh = false, autoRefreshInterval = 5000 } = opts;
+    const client = useWorkflowClient();
+    const [executions, setExecutions] = useState([]);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [nextCursor, setNextCursor] = useState(undefined);
+    const [refreshKey, setRefreshKey] = useState(0);
+    // Initial + refresh fetch
+    useEffect(() => {
+        let cancelled = false;
+        setIsLoading(true);
+        setError(null);
+        const params = {};
+        if (workflowId)
+            params['workflowId'] = workflowId;
+        if (status)
+            params['status'] = status;
+        void (async () => {
+            try {
+                const result = await client.executions.list(params);
+                if (!cancelled) {
+                    setExecutions(result.items);
+                    setNextCursor(result.nextCursor);
+                }
+            }
+            catch (err) {
+                if (!cancelled)
+                    setError(err instanceof Error ? err : new Error(String(err)));
+            }
+            finally {
+                if (!cancelled)
+                    setIsLoading(false);
+            }
+        })();
+        return () => { cancelled = true; };
+    }, [client, workflowId, status, refreshKey]);
+    // Auto-refresh polling
+    useEffect(() => {
+        if (!autoRefresh)
+            return;
+        const hasActive = executions.some((e) => e.status === 'PENDING' || e.status === 'RUNNING' || e.status === 'EXTERNAL_WAIT');
+        if (!hasActive)
+            return;
+        const timer = setInterval(() => {
+            setRefreshKey((k) => k + 1);
+        }, autoRefreshInterval);
+        return () => clearInterval(timer);
+    }, [autoRefresh, autoRefreshInterval, executions]);
+    const refetch = useCallback(() => {
+        setRefreshKey((k) => k + 1);
+    }, []);
+    const loadMore = useCallback(() => {
+        if (!nextCursor)
+            return;
+        void (async () => {
+            try {
+                const params = { cursor: nextCursor };
+                if (workflowId)
+                    params['workflowId'] = workflowId;
+                if (status)
+                    params['status'] = status;
+                const result = await client.executions.list(params);
+                setExecutions((prev) => [...prev, ...result.items]);
+                setNextCursor(result.nextCursor);
+            }
+            catch (err) {
+                setError(err instanceof Error ? err : new Error(String(err)));
+            }
+        })();
+    }, [client, nextCursor, workflowId, status]);
+    const triggerExec = useCallback(async (wfId, payload) => {
+        const result = await client.workflows.trigger(wfId, payload);
+        refetch();
+        return result;
+    }, [client, refetch]);
+    return {
+        executions,
+        isLoading,
+        error,
+        hasMore: nextCursor !== undefined,
+        loadMore,
+        refetch,
+        trigger: triggerExec,
+    };
+}
+//# sourceMappingURL=use-runs-list.js.map

package/dist/hooks/use-runs-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-runs-list.js","sourceRoot":"","sources":["../../src/hooks/use-runs-list.ts"],"names":[],"mappings":"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"}