@stigmer/react 1.0.4 → 2.0.0

package/workflow/useWorkflowExecutionActions.js

@@ -1,7 +1,7 @@
 "use client";
 import { useCallback, useRef, useState } from "react";
 import { create } from "@bufbuild/protobuf";
-import { CancelWorkflowExecutionInputSchema, TerminateWorkflowExecutionInputSchema, PauseWorkflowExecutionInputSchema, ResumeWorkflowExecutionInputSchema, RecoverWorkflowExecutionInputSchema, SubmitWorkflowApprovalInputSchema, } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+import { CancelWorkflowExecutionInputSchema, TerminateWorkflowExecutionInputSchema, PauseWorkflowExecutionInputSchema, ResumeWorkflowExecutionInputSchema, RecoverWorkflowExecutionInputSchema, SubmitWorkflowApprovalInputSchema, SubmitWorkflowTaskApprovalInputSchema, } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
 import { useStigmer } from "../hooks";
 import { toError } from "../internal/toError";
 /**
@@ -15,14 +15,16 @@ import { toError } from "../internal/toError";
  *
  * @example
  * ```tsx
- * const actions = useWorkflowExecutionActions(executionId);
+ * const actions = useWorkflowExecutionActions(executionId, {
+ *   onSuccess: () => refetchExecution(),
+ * });
  *
  * <button onClick={() => actions.cancel("No longer needed")} disabled={actions.isSubmitting}>
  *   Cancel
  * </button>
  * ```
  */
-export function useWorkflowExecutionActions(executionId) {
+export function useWorkflowExecutionActions(executionId, options) {
     const stigmer = useStigmer();
     const [isSubmitting, setIsSubmitting] = useState(false);
     const [error, setError] = useState(null);
@@ -30,13 +32,18 @@ export function useWorkflowExecutionActions(executionId) {
     executionIdRef.current = executionId;
     const stigmerRef = useRef(stigmer);
     stigmerRef.current = stigmer;
-    const wrap = useCallback(async (fn) => {
+    const onSuccessRef = useRef(options?.onSuccess);
+    onSuccessRef.current = options?.onSuccess;
+    const clearError = useCallback(() => setError(null), []);
+    const wrap = useCallback(async (fn, fireOnSuccess = true) => {
         if (!executionIdRef.current)
             return null;
         setIsSubmitting(true);
         setError(null);
         try {
             const result = await fn();
+            if (fireOnSuccess)
+                onSuccessRef.current?.(result);
             return result;
         }
         catch (err) {
@@ -71,7 +78,15 @@ export function useWorkflowExecutionActions(executionId) {
         toolCallId,
         action,
         comment: comment ?? "",
-    }))), [wrap]);
+    })), false), [wrap]);
+    const submitTaskApproval = useCallback((taskName, outcome, formData, comment) => wrap(() => stigmerRef.current.workflowExecution.submitWorkflowTaskApproval(create(SubmitWorkflowTaskApprovalInputSchema, {
+        executionId: executionIdRef.current,
+        taskName,
+        outcome,
+        formData: formData,
+        reviewer: "",
+        comment: comment ?? "",
+    })), false), [wrap]);
     return {
         cancel,
         terminate,
@@ -79,8 +94,10 @@ export function useWorkflowExecutionActions(executionId) {
         resume,
         recover,
         submitApproval,
+        submitTaskApproval,
         isSubmitting,
         error,
+        clearError,
     };
 }
 //# sourceMappingURL=useWorkflowExecutionActions.js.map

package/workflow/useWorkflowExecutionActions.js.map

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

package/workflow/useWorkflowExecutionEventStream.d.ts

@@ -40,6 +40,17 @@ export interface UseWorkflowExecutionEventStreamReturn {
     /** Re-establish the stream subscription. */
     readonly reconnect: () => void;
 }
+/**
+ * Pure function that detects a terminal-to-active phase transition —
+ * the signal that a recovery has begun and the event store should be
+ * reset to clear stale events from the previous run.
+ *
+ * Returns `false` when either phase is `undefined` (initial load or
+ * unresolved execution), preventing false resets on first render.
+ *
+ * Extracted for testability (DD-003).
+ */
+export declare function isRecoveryTransition(prevPhase: ExecutionPhase | undefined, nextPhase: ExecutionPhase | undefined): boolean;
 /**
  * Behavior hook that manages a live event stream subscription for a
  * workflow execution, or batch-loads events for completed executions.
@@ -55,6 +66,16 @@ export interface UseWorkflowExecutionEventStreamReturn {
  * For terminal executions: loads the full event log via paginated
  * `getEventLog` calls.
  *
+ * On recovery (terminal → active phase transition for the same
+ * execution), the store is reset so stale events from the failed run
+ * are cleared before the new subscription begins.
+ *
+ * When `executionId` changes to a different execution, the store is
+ * reset before subscribing — mirroring `useFetch`'s identity-change
+ * reset — so the previous run's append-only events neither render as
+ * stale progress nor cause the live subscription to resume from the
+ * wrong `afterSequence`.
+ *
  * Pass `null` for `executionId` to skip (stable no-op).
  */
 export declare function useWorkflowExecutionEventStream(executionId: string | null, options?: UseWorkflowExecutionEventStreamOptions): UseWorkflowExecutionEventStreamReturn;

package/workflow/useWorkflowExecutionEventStream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWorkflowExecutionEventStream.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionEventStream.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kEAAkE,CAAC;AAC/G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kEAAkE,CAAC;AAM1G,OAAO,EAAE,cAAc,EAAE,MAAM,iEAAiE,CAAC;AAGjG,OAAO,EACL,2BAA2B,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAE3B,2DAA2D;AAC3D,MAAM,WAAW,sCAAsC;IACrD,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,2BAA2B,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAED,+DAA+D;AAC/D,MAAM,WAAW,qCAAqC;IACpD,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACnD,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC3D,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,8BAA8B;IAC9B,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;IAC/C,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;CAChC;AASD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,OAAO,CAAC,EAAE,sCAAsC,GAC/C,qCAAqC,CAqJvC"}
+{"version":3,"file":"useWorkflowExecutionEventStream.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionEventStream.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kEAAkE,CAAC;AAC/G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kEAAkE,CAAC;AAM1G,OAAO,EAAE,cAAc,EAAE,MAAM,iEAAiE,CAAC;AAGjG,OAAO,EACL,2BAA2B,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAE3B,2DAA2D;AAC3D,MAAM,WAAW,sCAAsC;IACrD,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,2BAA2B,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAED,+DAA+D;AAC/D,MAAM,WAAW,qCAAqC;IACpD,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACnD,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC3D,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,8BAA8B;IAC9B,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;IAC/C,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;CAChC;AASD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,cAAc,GAAG,SAAS,EACrC,SAAS,EAAE,cAAc,GAAG,SAAS,GACpC,OAAO,CAGT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,OAAO,CAAC,EAAE,sCAAsC,GAC/C,qCAAqC,CAmMvC"}

package/workflow/useWorkflowExecutionEventStream.js

@@ -12,6 +12,21 @@ const TERMINAL_PHASES = new Set([
     ExecutionPhase.EXECUTION_CANCELLED,
     ExecutionPhase.EXECUTION_TERMINATED,
 ]);
+/**
+ * Pure function that detects a terminal-to-active phase transition —
+ * the signal that a recovery has begun and the event store should be
+ * reset to clear stale events from the previous run.
+ *
+ * Returns `false` when either phase is `undefined` (initial load or
+ * unresolved execution), preventing false resets on first render.
+ *
+ * Extracted for testability (DD-003).
+ */
+export function isRecoveryTransition(prevPhase, nextPhase) {
+    if (prevPhase === undefined || nextPhase === undefined)
+        return false;
+    return TERMINAL_PHASES.has(prevPhase) && !TERMINAL_PHASES.has(nextPhase);
+}
 /**
  * Behavior hook that manages a live event stream subscription for a
  * workflow execution, or batch-loads events for completed executions.
@@ -27,6 +42,16 @@ const TERMINAL_PHASES = new Set([
  * For terminal executions: loads the full event log via paginated
  * `getEventLog` calls.
  *
+ * On recovery (terminal → active phase transition for the same
+ * execution), the store is reset so stale events from the failed run
+ * are cleared before the new subscription begins.
+ *
+ * When `executionId` changes to a different execution, the store is
+ * reset before subscribing — mirroring `useFetch`'s identity-change
+ * reset — so the previous run's append-only events neither render as
+ * stale progress nor cause the live subscription to resume from the
+ * wrong `afterSequence`.
+ *
  * Pass `null` for `executionId` to skip (stable no-op).
  */
 export function useWorkflowExecutionEventStream(executionId, options) {
@@ -45,14 +70,55 @@ export function useWorkflowExecutionEventStream(executionId, options) {
     // Stable ref for values that should not trigger re-subscription
     const storeRef = useRef(store);
     storeRef.current = store;
+    // Track previous phase to detect recovery (terminal → active).
+    // useRef (not useState) because the transition drives an effect-time
+    // side effect (store reset + gRPC subscription), not a rendered value.
+    const prevPhaseRef = useRef(undefined);
+    // Track the execution the store is currently populated for, so we can
+    // detect a switch to a different execution (vs. a reconnect or phase
+    // change for the same one). Same role as useFetch's prevIdentityDepsRef.
+    const prevExecutionIdRef = useRef(null);
     useEffect(() => {
         if (!executionId) {
             store.reset();
+            prevPhaseRef.current = undefined;
+            prevExecutionIdRef.current = null;
             return;
         }
         const abortController = new AbortController();
         const currentStore = storeRef.current;
         const isTerminal = executionPhase !== undefined && TERMINAL_PHASES.has(executionPhase);
+        // Execution switch (A → B): the store is append-only and holds the
+        // previous run's events. Clear it before subscribing so we neither
+        // render B with A's progress nor resume B's live stream from A's
+        // afterSequence (which would silently drop B's earlier events).
+        // This is distinct from reconnect (connectKey) and recovery (phase
+        // transition), both of which must preserve/replay events for the
+        // SAME execution. Resetting prevPhaseRef here prevents the A→B phase
+        // delta from being misread as a recovery transition below.
+        const isExecutionSwitch = prevExecutionIdRef.current !== null &&
+            prevExecutionIdRef.current !== executionId;
+        if (isExecutionSwitch) {
+            currentStore.reset();
+            prevPhaseRef.current = undefined;
+        }
+        prevExecutionIdRef.current = executionId;
+        // When an execution transitions from a terminal phase back to an
+        // active phase (recovery), clear the store so stale events from the
+        // failed run don't produce contradictory UI (header says "running"
+        // while task badges still show "failed"). After reset,
+        // getLatestSequence() returns 0 and the subscription replays the
+        // full event history — including task_skipped events from the
+        // recovery engine that correctly represent the new run's state.
+        //
+        // Note: unlike useExecutionStream, this hook does NOT reset in the
+        // cleanup function. connectKey (reconnect) is in the deps array —
+        // resetting on cleanup would destroy events on reconnect. The store
+        // is only reset here (recovery) and when executionId becomes null.
+        if (isRecoveryTransition(prevPhaseRef.current, executionPhase)) {
+            currentStore.reset();
+        }
+        prevPhaseRef.current = executionPhase;
         if (isTerminal) {
             // Batch-load all events for completed executions
             currentStore.setStreamState({ stage: "connecting", executionId });

package/workflow/useWorkflowExecutionEventStream.js.map

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

package/workflow/useWorkflowExecutionGraph.d.ts

@@ -0,0 +1,82 @@
+import type { Node, Edge } from "@xyflow/react";
+import type { WorkflowExecution } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+import type { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+import type { DerivedTaskState } from "../internal/store/workflow-execution-event-store";
+/** Options for {@link useWorkflowExecutionGraph}. */
+export interface UseWorkflowExecutionGraphOptions {
+    /** ID of the workflow execution to visualize. */
+    readonly executionId: string;
+    /**
+     * Pre-fetched execution from the parent. When provided, the hook
+     * skips its own `useWorkflowExecution` call — eliminating the
+     * duplicate fetch.
+     */
+    readonly execution?: WorkflowExecution | null;
+    /**
+     * Externally-derived task states from a shared event store. When
+     * provided, the hook skips its own `useWorkflowExecutionEventStream`
+     * call — eliminating the duplicate gRPC subscription.
+     */
+    readonly taskStates?: ReadonlyMap<string, DerivedTaskState>;
+    /**
+     * Callback invoked once when the hook auto-selects a failed task
+     * on a terminal execution. The parent can wire this to its own
+     * `setSelectedTaskName` to keep the inspector in sync.
+     *
+     * Without this, auto-selection only affects the hook's internal
+     * `selectedTaskName` state and is invisible to sibling components.
+     */
+    readonly onAutoSelectTask?: (taskName: string) => void;
+    /**
+     * When `true`, non-sentinel nodes are marked `draggable: true` so
+     * the parent component can allow ephemeral drag repositioning.
+     * Sentinel nodes (Start/End) remain non-draggable regardless.
+     * @default false
+     */
+    readonly nodesDraggable?: boolean;
+}
+/** Return value of {@link useWorkflowExecutionGraph}. */
+export interface UseWorkflowExecutionGraphReturn {
+    /** React Flow nodes with execution state merged into data. */
+    readonly nodes: Node[];
+    /** React Flow edges. */
+    readonly edges: Edge[];
+    /** Current execution lifecycle phase. */
+    readonly executionPhase: ExecutionPhase | undefined;
+    /** Currently selected task name in the graph. */
+    readonly selectedTaskName: string | null;
+    /** Set the selected task in the graph. */
+    readonly setSelectedTaskName: (name: string | null) => void;
+    /** `true` while the graph model is being loaded (workflow fetch + parse). */
+    readonly isLoading: boolean;
+    /** Error from workflow fetch or graph building. */
+    readonly error: string | null;
+    /**
+     * When the workflow has been modified since this execution ran,
+     * indicates the mismatch. `null` when no mismatch detected.
+     */
+    readonly versionMismatch: string | null;
+    /**
+     * `true` when the execution has a pinned version hash but the version
+     * lookup failed (NOT_FOUND, network error, empty YAML). The graph shows
+     * the current definition as a fallback but this is an imprecise view.
+     */
+    readonly versionResolutionFailed: boolean;
+    /** Task states from the event stream (for the inspector). */
+    readonly taskStates: ReadonlyMap<string, DerivedTaskState>;
+}
+/**
+ * Behavior hook that builds a complete read-only execution graph by:
+ * 1. Resolving the workflow definition (always fetched — it's the graph source)
+ * 2. Serializing to YAML and parsing into a graph model
+ * 3. Computing dagre layout
+ * 4. Converting to React Flow elements
+ * 5. Merging live execution state into node data
+ *
+ * When `execution` and `taskStates` are provided externally (from a
+ * parent that already subscribes), the hook skips its own duplicate
+ * subscriptions. When omitted, it falls back to independent fetching
+ * for standalone `<WorkflowExecutionGraph executionId="..." />` usage.
+ */
+export declare function useWorkflowExecutionGraph(options: UseWorkflowExecutionGraphOptions): UseWorkflowExecutionGraphReturn;
+//# sourceMappingURL=useWorkflowExecutionGraph.d.ts.map

package/workflow/useWorkflowExecutionGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowExecutionGraph.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionGraph.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gEAAgE,CAAC;AACxG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iEAAiE,CAAC;AAetG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAIzF,qDAAqD;AACrD,MAAM,WAAW,gCAAgC;IAC/C,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE9C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAE5D;;;;;;;OAOG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAEvD;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,yDAAyD;AACzD,MAAM,WAAW,+BAA+B;IAC9C,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IACvB,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,cAAc,EAAE,cAAc,GAAG,SAAS,CAAC;IACpD,iDAAiD;IACjD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,0CAA0C;IAC1C,QAAQ,CAAC,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5D,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC5D;AAyBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,+BAA+B,CAuRjC"}

package/workflow/useWorkflowExecutionGraph.js

@@ -0,0 +1,256 @@
+"use client";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { isNotFound } from "@stigmer/sdk";
+import { GetWorkflowVersionInputSchema } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/version_pb";
+import { useStigmer } from "../hooks";
+import { useFetch } from "../internal/useFetch";
+import { useWorkflowExecution } from "./useWorkflowExecution";
+import { useWorkflowExecutionEventStream } from "./useWorkflowExecutionEventStream";
+import { serializeWorkflowYaml } from "./serialize-workflow-yaml";
+import { WorkflowTaskKind } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/enum_pb";
+import { yamlToGraph, toReactFlowElements } from "./workflow-graph-conversions";
+import { cncfYamlToGraph, isCncfWorkflowYaml } from "./cncf-yaml-to-graph";
+import { applyDagreLayout } from "./layout";
+import { EXECUTION_DAGRE_CONFIG } from "./canvas-constants";
+import { deriveEdgeExecutionStates, deriveForkProgress } from "./execution";
+const EMPTY_TASK_STATES = new Map();
+const TERMINAL_PHASES = new Set([3, 4, 5, 6]);
+async function fetchLiveWorkflowFallback(stigmer, workflowId, versionFetchFailed) {
+    try {
+        const wf = await stigmer.workflow.get(workflowId);
+        return { yaml: serializeWorkflowYaml(wf), isVersionPinned: false, versionFetchFailed };
+    }
+    catch (err) {
+        if (isNotFound(err))
+            return null;
+        throw err;
+    }
+}
+/**
+ * Behavior hook that builds a complete read-only execution graph by:
+ * 1. Resolving the workflow definition (always fetched — it's the graph source)
+ * 2. Serializing to YAML and parsing into a graph model
+ * 3. Computing dagre layout
+ * 4. Converting to React Flow elements
+ * 5. Merging live execution state into node data
+ *
+ * When `execution` and `taskStates` are provided externally (from a
+ * parent that already subscribes), the hook skips its own duplicate
+ * subscriptions. When omitted, it falls back to independent fetching
+ * for standalone `<WorkflowExecutionGraph executionId="..." />` usage.
+ */
+export function useWorkflowExecutionGraph(options) {
+    const { executionId, onAutoSelectTask, nodesDraggable = false } = options;
+    const stigmer = useStigmer();
+    const [selectedTaskName, setSelectedTaskName] = useState(null);
+    // ── Execution data: use external or fetch own ────────────────────
+    const ownExecution = useWorkflowExecution(options.execution !== undefined ? null : executionId);
+    const execution = options.execution !== undefined
+        ? options.execution
+        : ownExecution.execution;
+    const isLoadingExecution = options.execution !== undefined
+        ? false
+        : ownExecution.isLoading;
+    const executionError = options.execution !== undefined
+        ? null
+        : ownExecution.error;
+    const phase = execution?.status?.phase;
+    // ── Workflow definition fetch (version-aware for graph building) ──
+    const workflowId = execution?.spec?.workflowId || null;
+    const workflowInstanceId = execution?.spec?.workflowInstanceId || null;
+    const versionHash = execution?.status?.workflowVersionHash || null;
+    const instanceFetchFn = !workflowId && workflowInstanceId
+        ? async () => {
+            try {
+                const instance = await stigmer.workflowInstance.get(workflowInstanceId);
+                return instance.spec?.workflowId ?? null;
+            }
+            catch {
+                return null;
+            }
+        }
+        : null;
+    const { data: resolvedWorkflowId } = useFetch(instanceFetchFn, [workflowInstanceId, stigmer], null);
+    const effectiveWorkflowId = workflowId || resolvedWorkflowId;
+    // Fetch workflow definition — use pinned version if available, otherwise live
+    const workflowFetchFn = effectiveWorkflowId
+        ? async () => {
+            // Path 1: Versioned execution — fetch the specific version entry
+            if (versionHash) {
+                try {
+                    const versionEntry = await stigmer.workflow.getVersion(create(GetWorkflowVersionInputSchema, { workflowId: effectiveWorkflowId, versionHash }));
+                    if (versionEntry?.validatedYaml) {
+                        return { yaml: versionEntry.validatedYaml, isVersionPinned: true, versionFetchFailed: false };
+                    }
+                    // Version entry exists but YAML is empty — treat as degraded
+                    return await fetchLiveWorkflowFallback(stigmer, effectiveWorkflowId, true);
+                }
+                catch {
+                    // Version lookup failed — explicit fallback with signal
+                    return await fetchLiveWorkflowFallback(stigmer, effectiveWorkflowId, true);
+                }
+            }
+            // Path 2: Legacy execution or no hash — use live workflow
+            return await fetchLiveWorkflowFallback(stigmer, effectiveWorkflowId, false);
+        }
+        : null;
+    const { data: workflowData, isLoading: isLoadingWorkflow, error: workflowError, } = useFetch(workflowFetchFn, [effectiveWorkflowId, versionHash, stigmer], null);
+    // ── Build graph model ────────────────────────────────────────────
+    const isVersionPinned = workflowData?.isVersionPinned ?? false;
+    const graphBuild = useMemo(() => {
+        if (!workflowData?.yaml)
+            return null;
+        try {
+            const graph = isCncfWorkflowYaml(workflowData.yaml)
+                ? cncfYamlToGraph(workflowData.yaml)
+                : yamlToGraph(workflowData.yaml);
+            const laidOut = applyDagreLayout(graph, EXECUTION_DAGRE_CONFIG);
+            return { elements: toReactFlowElements(laidOut), graphModel: laidOut };
+        }
+        catch {
+            return null;
+        }
+    }, [workflowData]);
+    const baseElements = graphBuild?.elements ?? null;
+    const graphModel = graphBuild?.graphModel ?? null;
+    // ── Task states: use external or subscribe own ───────────────────
+    const ownStream = useWorkflowExecutionEventStream(options.taskStates !== undefined ? null : executionId, { executionPhase: phase });
+    const taskStates = options.taskStates !== undefined
+        ? options.taskStates
+        : ownStream.taskStates;
+    // ── Merge execution state into nodes (T04) + fork progress (T06) + agent activity ──
+    const pendingApprovals = execution?.status?.pendingApprovals;
+    const nodesWithExecution = useMemo(() => {
+        if (!baseElements)
+            return [];
+        return baseElements.nodes.map((node) => {
+            const nodeData = node.data;
+            if (nodeData.isSentinel) {
+                return nodesDraggable ? { ...node, draggable: false } : node;
+            }
+            const taskState = taskStates.get(nodeData.taskName);
+            const executionState = taskState
+                ? {
+                    status: taskState.status,
+                    durationMs: taskState.durationMs,
+                    costMicros: taskState.costMicros,
+                    attemptNumber: taskState.attemptNumber,
+                    error: taskState.error || undefined,
+                }
+                : { status: "not_reached" };
+            // T06: Derive fork progress for fork nodes.
+            const forkProgress = nodeData.kind === WorkflowTaskKind.fork && nodeData.config
+                ? deriveForkProgress(nodeData.config, taskStates)
+                : null;
+            // Agent activity for running agent_call nodes.
+            const agentActivity = taskState?.status === "running" &&
+                taskState.agentSlug &&
+                (taskState.currentToolName || taskState.messagesCount > 0)
+                ? {
+                    agentSlug: taskState.agentSlug,
+                    currentToolName: taskState.currentToolName,
+                    messagesCount: taskState.messagesCount,
+                    toolCallsCount: taskState.toolCallsCount,
+                }
+                : undefined;
+            // Approval tool name from pending approvals matched by childExecutionId.
+            let approvalToolName;
+            if (taskState?.status === "waiting_approval" && taskState.childExecutionId && pendingApprovals) {
+                const match = pendingApprovals.find((pa) => pa.childAgentExecutionId === taskState.childExecutionId);
+                if (match?.approval?.toolName) {
+                    approvalToolName = match.approval.toolName;
+                }
+            }
+            return {
+                ...node,
+                data: {
+                    ...nodeData,
+                    executionState,
+                    ...(forkProgress && { forkProgress }),
+                    ...(agentActivity && { agentActivity }),
+                    ...(approvalToolName && { approvalToolName }),
+                },
+                draggable: nodesDraggable,
+                connectable: false,
+                deletable: false,
+            };
+        });
+    }, [baseElements, taskStates, pendingApprovals, nodesDraggable]);
+    // ── Merge execution state into edges (T06) ──────────────────────
+    const edgesWithExecution = useMemo(() => {
+        if (!baseElements || !graphModel)
+            return [];
+        const edgeStates = deriveEdgeExecutionStates(graphModel.edges, graphModel.nodes, taskStates);
+        return baseElements.edges.map((edge) => {
+            const execState = edgeStates.get(edge.id);
+            if (!execState || execState === "not_reached")
+                return edge;
+            return {
+                ...edge,
+                data: { ...edge.data, executionState: execState },
+            };
+        });
+    }, [baseElements, graphModel, taskStates]);
+    // ── Version mismatch detection ───────────────────────────────────
+    const versionFetchFailed = workflowData?.versionFetchFailed ?? false;
+    const versionMismatch = useMemo(() => {
+        // When the graph is rendered from the pinned version, no mismatch is possible.
+        if (isVersionPinned)
+            return null;
+        // When a pinned hash exists but version lookup failed, show a specific message.
+        if (versionFetchFailed && versionHash) {
+            return "Unable to load the pinned workflow version. Showing the current definition as a fallback.";
+        }
+        // Legacy path: no version hash on execution, using live workflow.
+        if (!execution?.status?.tasks || !baseElements)
+            return null;
+        const executionTaskNames = new Set(execution.status.tasks.map((t) => t.taskName).filter(Boolean));
+        const graphTaskNames = new Set(baseElements.nodes
+            .map((n) => n.data.taskName)
+            .filter((name) => name !== "Start" && name !== "End"));
+        const inExecutionNotGraph = [...executionTaskNames].filter((n) => !graphTaskNames.has(n));
+        const inGraphNotExecution = [...graphTaskNames].filter((n) => !executionTaskNames.has(n));
+        if (inExecutionNotGraph.length > 0 || inGraphNotExecution.length > 0) {
+            return "This execution predates version tracking. The workflow has since been modified.";
+        }
+        return null;
+    }, [execution?.status?.tasks, baseElements, isVersionPinned, versionFetchFailed, versionHash]);
+    // ── Loading / error aggregation ──────────────────────────────────
+    const isLoading = isLoadingExecution || isLoadingWorkflow;
+    const error = executionError?.message
+        ?? workflowError?.message
+        ?? (!isLoading && !baseElements && effectiveWorkflowId ? "Unable to build workflow graph" : null)
+        ?? null;
+    // ── Auto-select failed task (fires once on terminal phase) ───────
+    const didAutoSelectRef = useRef(false);
+    useEffect(() => {
+        if (didAutoSelectRef.current)
+            return;
+        if (!phase || !TERMINAL_PHASES.has(phase))
+            return;
+        if (selectedTaskName)
+            return;
+        for (const [name, state] of taskStates) {
+            if (state.status === "failed") {
+                didAutoSelectRef.current = true;
+                setSelectedTaskName(name);
+                onAutoSelectTask?.(name);
+                return;
+            }
+        }
+    }, [phase, taskStates, selectedTaskName, onAutoSelectTask]);
+    return {
+        nodes: nodesWithExecution,
+        edges: edgesWithExecution,
+        executionPhase: phase,
+        selectedTaskName,
+        setSelectedTaskName,
+        isLoading,
+        error,
+        versionMismatch,
+        versionResolutionFailed: versionFetchFailed,
+        taskStates,
+    };
+}
+//# sourceMappingURL=useWorkflowExecutionGraph.js.map

package/workflow/useWorkflowExecutionGraph.js.map

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