@burdenoff/fluidgrids-fe-sdk 2026.1029.7 → 2026.1029.8

package/dist/{chunk-TYYSYSAL.js → chunk-H4AZBUWM.js}

@@ -1,4 +1,4 @@
-import { NodeEndpointConfigsDocument, NodeEndpointConfigDocument, NodeManifestDocument, fetchAllNodeEndpointConfigs } from './chunk-YTUIGIVP.js';
+import { NodeEndpointConfigsDocument, NodeEndpointConfigDocument, NodeManifestDocument, fetchAllNodeEndpointConfigs } from './chunk-GQTEHWWY.js';
 import { useTr } from './chunk-UULVIT25.js';
 import { getFluidGridsClient } from './chunk-NTWG3CJX.js';
 import { useMemo, useState, useCallback, useEffect } from 'react';

package/dist/{chunk-AXMEATLG.js → chunk-HWEKWYXQ.js}

@@ -1,7 +1,7 @@
 import { REPLAY_WORKFLOW_RUN, RETRY_WORKFLOW_RUNS } from './chunk-5ERAJC2I.js';
-import { useFluidGridsAnalytics, throwIfResultError, emitRunStarted, openRunQuotaUpgradePrompt } from './chunk-K4BF7PAW.js';
+import { useFluidGridsAnalytics, throwIfResultError, emitRunStarted, openRunQuotaUpgradePrompt } from './chunk-NAYPOEYM.js';
 import { useExecutionsStore } from './chunk-6AMNEX2Y.js';
-import { ExecutionsListDocument, ExecutionDetailDocument, ExecutionStatsDocument, PauseExecutionDocument, ResumeExecutionDocument, CancelExecutionDocument, RetryNodeDocument, TriggerWorkflowDocument, TerminateExecutionDocument } from './chunk-YTUIGIVP.js';
+import { ExecutionsListDocument, ExecutionDetailDocument, ExecutionStatsDocument, PauseExecutionDocument, ResumeExecutionDocument, CancelExecutionDocument, RetryNodeDocument, TriggerWorkflowDocument, TerminateExecutionDocument } from './chunk-GQTEHWWY.js';
 import { useTr } from './chunk-UULVIT25.js';
 import { getFluidGridsClient } from './chunk-NTWG3CJX.js';
 import { useState, useRef, useCallback, useEffect, useMemo } from 'react';

package/dist/{chunk-RZR3BDDZ.js → chunk-LJGC7RAL.js}

@@ -1,18 +1,18 @@
-import { isGuidedTourIntent, pickGuidedTour, withoutGuidedTourIntent, isCreateIntent, CreateWorkflowRefusalDialog, decideMissingWorkflow } from './chunk-FFOZ5VUJ.js';
+import { isGuidedTourIntent, pickGuidedTour, withoutGuidedTourIntent, isCreateIntent, CreateWorkflowRefusalDialog, decideMissingWorkflow } from './chunk-2NG5VZWI.js';
 import { registerLiveCanvasHandler } from './chunk-PIKYQE7P.js';
-import { useInstalledNodes, buildNodeCheck, FlowBuilderPage, buildRequiredNodeTypes } from './chunk-EGIEFGOV.js';
-import { useLazyWorkflowDefinition, useCreateWorkflow } from './chunk-OJPJ2QXD.js';
-import { useFlowStore, refetchStoreNodes, BILLING_PLANS_PATH, codeBuildIdOf, mergeStickyNotes, blankWorkflowCreateInput, classifyCreateRefusal, useSaveStatusStore, workflowFingerprint, registerWorkflowNodeTypes, throwIfResultError } from './chunk-K4BF7PAW.js';
+import { useWorkflowReloadStore, releaseLeaseKeptForReload, useInstalledNodes, buildNodeCheck, FlowBuilderPage, buildRequiredNodeTypes } from './chunk-X2J4ZXKD.js';
+import { useLazyWorkflowDefinition, useCreateWorkflow } from './chunk-G3KZOX52.js';
+import { useFlowStore, refetchStoreNodes, BILLING_PLANS_PATH, codeBuildIdOf, mergeStickyNotes, rememberRevision, blankWorkflowCreateInput, classifyCreateRefusal, useSaveStatusStore, workflowFingerprint, registerWorkflowNodeTypes, throwIfResultError } from './chunk-NAYPOEYM.js';
 import { getFluidGridsConfig } from './chunk-6AMNEX2Y.js';
-import { WorkflowDefinitionDocument } from './chunk-YTUIGIVP.js';
+import { WorkflowDefinitionDocument } from './chunk-GQTEHWWY.js';
 import { useTr } from './chunk-UULVIT25.js';
 import { getFluidGridsClient } from './chunk-NTWG3CJX.js';
 import { useLocation, useNavigate, useParams } from 'react-router';
 import { toast } from 'sonner';
 import { Icon } from '@iconify/react';
 import { lazy, useRef, useEffect, useState, useCallback, useMemo, Suspense } from 'react';
-import { useSafeToursContext, usePlayTour } from '@burdenoff/fe-libs/shared/tours';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import { useSafeToursContext, usePlayTour } from '@burdenoff/fe-libs/shared/tours';
 import { ErrorBoundary } from '@burdenoff/fe-libs/shared/components';
 import '@xyflow/react/dist/style.css';
 
@@ -653,7 +653,11 @@ function AssistantLiveCanvasHost() {
       fetchDefinition,
       registerNodeTypes: registerWorkflowNodeTypes,
       notify,
-      workspaceId: () => getFluidGridsConfig().workspaceId || null
+      workspaceId: () => getFluidGridsConfig().workspaceId || null,
+      // The merged canvas now holds the stored version, assistant write
+      // included, so the next save is based on its revision (BOFF-9725)
+      // rather than refused as stale over a change already on screen.
+      onSynced: (remote) => rememberRevision(remote.id, remote.revision)
     });
     const stopWatching = watchCanvasBase();
     const unregister = registerLiveCanvasHandler(sync.handle);
@@ -664,6 +668,48 @@ function AssistantLiveCanvasHost() {
   }, []);
   return null;
 }
+function LoadProblem({
+  title,
+  description,
+  retryLabel,
+  onRetry,
+  backLabel,
+  onBack,
+  testId
+}) {
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      role: "alert",
+      "data-testid": testId,
+      className: "flex h-full min-h-[60vh] w-full flex-col items-center justify-center gap-3 p-6 text-center",
+      children: [
+        /* @__PURE__ */ jsx("p", { className: "text-base font-medium text-foreground", children: title }),
+        /* @__PURE__ */ jsx("p", { className: "max-w-md text-sm text-foreground/60", children: description }),
+        /* @__PURE__ */ jsxs("div", { className: "flex gap-2", children: [
+          /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              className: "rounded-md bg-primary px-4 py-2 text-sm font-medium text-primary-foreground",
+              onClick: onRetry,
+              children: retryLabel
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              className: "rounded-md border px-4 py-2 text-sm font-medium text-foreground",
+              onClick: onBack,
+              children: backLabel
+            }
+          )
+        ] })
+      ]
+    }
+  );
+}
 var START_DELAY_MS = 800;
 function StartGuidedTour() {
   const location = useLocation();
@@ -736,11 +782,17 @@ function WorkflowItem({
   const [createRefusal, setCreateRefusal] = useState(null);
   const upgradingRef = useRef(false);
   const resetWorkflow = useFlowStore((s) => s.actions.resetWorkflow);
+  const reloadNonce = useWorkflowReloadStore((s) => s.nonce);
+  useEffect(() => () => releaseLeaseKeptForReload(), [id, version]);
+  const seenReloadNonceRef = useRef(reloadNonce);
+  const pendingReloadRef = useRef(null);
+  const [reloadFailed, setReloadFailed] = useState(false);
   const { getWorkflow } = useLazyWorkflowDefinition();
   const { createWorkflow } = useCreateWorkflow();
   const creatingRef = useRef(false);
   const fromSharedLoadedRef = useRef(false);
   const fetchedWorkflowRef = useRef(null);
+  const loadSeqRef = useRef(0);
   const { installedAppIds } = useInstalledNodes();
   const [pendingWorkflow, setPendingWorkflow] = useState(null);
   const [nodeCheck, setNodeCheck] = useState(
@@ -843,11 +895,27 @@ function WorkflowItem({
   );
   useEffect(() => {
     let mounted = true;
+    const target = `${id ?? ""}@${version ?? ""}`;
+    loadSeqRef.current += 1;
+    const loadSeq = loadSeqRef.current;
+    if (reloadNonce !== seenReloadNonceRef.current) {
+      seenReloadNonceRef.current = reloadNonce;
+      pendingReloadRef.current = target;
+    }
+    const reloadPending = () => pendingReloadRef.current === target;
+    const fetchedCopy = () => fetchedWorkflowRef.current?.target === target ? fetchedWorkflowRef.current.workflow : null;
+    const recordFetched = (workflow2) => {
+      if (loadSeqRef.current !== loadSeq) return false;
+      fetchedWorkflowRef.current = { target, workflow: workflow2 };
+      if (pendingReloadRef.current === target) pendingReloadRef.current = null;
+      return true;
+    };
     const loadWorkflow = async () => {
       try {
         resetWorkflow();
         if (mounted) setNotFound(false);
         if (mounted) setLoadError(null);
+        if (mounted) setReloadFailed(false);
         if (version && mounted) {
           setIsLoading(true);
         }
@@ -904,7 +972,7 @@ function WorkflowItem({
           }
           return;
         }
-        const freshCreate = createIntentRef.current && !creatingRef.current && !fetchedWorkflowRef.current && !loadRunId;
+        const freshCreate = createIntentRef.current && !creatingRef.current && !fetchedCopy() && !loadRunId;
         const result = freshCreate ? null : await getWorkflow(id, void 0, version);
         const definitionJson = result?.definitionJson;
         const defData = definitionJson?.data ?? (definitionJson?.nodes ? definitionJson : void 0);
@@ -925,7 +993,9 @@ function WorkflowItem({
             // new version (spec code-first 06 §1).
             codeBuildId: codeBuildIdOf(result?.definitionJson)
           };
-          fetchedWorkflowRef.current = workflowState;
+          if (recordFetched(workflowState)) {
+            rememberRevision(result?.id, result?.revision);
+          }
           let requiredNodeTypes = [];
           try {
             requiredNodeTypes = await buildRequiredNodeTypes(
@@ -949,8 +1019,14 @@ function WorkflowItem({
           return;
         }
         if (mounted) {
-          if (fetchedWorkflowRef.current) {
-            setWorkflow(fetchedWorkflowRef.current);
+          if (reloadPending()) {
+            setReloadFailed(true);
+            releaseLeaseKeptForReload();
+            return;
+          }
+          const earlier = fetchedCopy();
+          if (earlier) {
+            setWorkflow(earlier);
             return;
           }
           if (loadRunId) {
@@ -999,16 +1075,18 @@ function WorkflowItem({
               if (mounted) setCreateRefusal(classifyCreateRefusal(reported));
               return;
             }
-            if (mounted) {
-              setWorkflow({
-                ...newWorkflow,
-                id: created.workflowKey,
-                workflowKey: created.workflowKey,
-                version: created.version,
-                dbId: created.id,
-                status: created.status ?? "DRAFT"
-              });
+            const createdWorkflow = {
+              ...newWorkflow,
+              id: created.workflowKey,
+              workflowKey: created.workflowKey,
+              version: created.version,
+              dbId: created.id,
+              status: created.status ?? "DRAFT"
+            };
+            if (recordFetched(createdWorkflow)) {
+              rememberRevision(created.id, created.revision);
             }
+            if (mounted) setWorkflow(createdWorkflow);
           }
         }
       } catch (error) {
@@ -1018,8 +1096,11 @@ function WorkflowItem({
             setLoadError(
               "The workflow version for this TEST run could not be loaded."
             );
+          } else if (reloadPending()) {
+            setReloadFailed(true);
+            releaseLeaseKeptForReload();
           } else {
-            setWorkflow(fetchedWorkflowRef.current ?? newWorkflow);
+            setWorkflow(fetchedCopy() ?? newWorkflow);
           }
         }
       } finally {
@@ -1042,7 +1123,8 @@ function WorkflowItem({
     resetWorkflow,
     navigate,
     loadRunId,
-    retryNonce
+    retryNonce,
+    reloadNonce
     // doNodeCheckRef is intentionally omitted — it's a ref (stable by definition)
     // and including doNodeCheck here caused infinite re-runs because installedAppIds
     // produces a new Set reference on every render.
@@ -1083,89 +1165,70 @@ function WorkflowItem({
         /* @__PURE__ */ jsx("span", { className: "text-sm text-foreground/60", children: "Loading workflow..." })
       ] }) })
     );
+  const retryLabel = tr(
+    "fluidgrids.builder.workflowNotFound.retry",
+    "Try again"
+  );
+  const backLabel = tr(
+    "fluidgrids.builder.workflowNotFound.back",
+    "Back to Workflows"
+  );
   if (createRefusal?.kind === "failed")
-    return /* @__PURE__ */ jsxs(
-      "div",
+    return /* @__PURE__ */ jsx(
+      LoadProblem,
       {
-        role: "alert",
-        className: "flex h-full min-h-[60vh] w-full flex-col items-center justify-center gap-3 p-6 text-center",
-        children: [
-          /* @__PURE__ */ jsx("p", { className: "text-base font-medium text-foreground", children: tr(
-            "fluidgrids.builder.workflowNotCreated.title",
-            "Workflow not created"
-          ) }),
-          /* @__PURE__ */ jsx("p", { className: "max-w-md text-sm text-foreground/60", children: tr(
-            "fluidgrids.builder.workflowNotCreated.description",
-            "The new workflow could not be created, so there is nothing to edit yet."
-          ) }),
-          /* @__PURE__ */ jsxs("div", { className: "flex gap-2", children: [
-            /* @__PURE__ */ jsx(
-              "button",
-              {
-                type: "button",
-                className: "rounded-md bg-primary px-4 py-2 text-sm font-medium text-primary-foreground",
-                onClick: () => {
-                  setCreateRefusal(null);
-                  setRetryNonce((n) => n + 1);
-                },
-                children: tr("fluidgrids.builder.workflowNotFound.retry", "Try again")
-              }
-            ),
-            /* @__PURE__ */ jsx(
-              "button",
-              {
-                type: "button",
-                className: "rounded-md border px-4 py-2 text-sm font-medium text-foreground",
-                onClick: () => navigate("../list", { replace: true }),
-                children: tr(
-                  "fluidgrids.builder.workflowNotFound.back",
-                  "Back to Workflows"
-                )
-              }
-            )
-          ] })
-        ]
+        title: tr(
+          "fluidgrids.builder.workflowNotCreated.title",
+          "Workflow not created"
+        ),
+        description: tr(
+          "fluidgrids.builder.workflowNotCreated.description",
+          "The new workflow could not be created, so there is nothing to edit yet."
+        ),
+        retryLabel,
+        onRetry: () => {
+          setCreateRefusal(null);
+          setRetryNonce((n) => n + 1);
+        },
+        backLabel,
+        onBack: () => navigate("../list", { replace: true })
       }
     );
   if (notFound)
-    return /* @__PURE__ */ jsxs(
-      "div",
+    return /* @__PURE__ */ jsx(
+      LoadProblem,
       {
-        role: "alert",
-        className: "flex h-full min-h-[60vh] w-full flex-col items-center justify-center gap-3 p-6 text-center",
-        children: [
-          /* @__PURE__ */ jsx("p", { className: "text-base font-medium text-foreground", children: tr(
-            "fluidgrids.builder.workflowNotFound.title",
-            "Workflow not found"
-          ) }),
-          /* @__PURE__ */ jsx("p", { className: "max-w-md text-sm text-foreground/60", children: tr(
-            "fluidgrids.builder.workflowNotFound.description",
-            "No workflow with this key exists in this workspace, or it could not be loaded. Nothing was created."
-          ) }),
-          /* @__PURE__ */ jsxs("div", { className: "flex gap-2", children: [
-            /* @__PURE__ */ jsx(
-              "button",
-              {
-                type: "button",
-                className: "rounded-md bg-primary px-4 py-2 text-sm font-medium text-primary-foreground",
-                onClick: () => setRetryNonce((n) => n + 1),
-                children: tr("fluidgrids.builder.workflowNotFound.retry", "Try again")
-              }
-            ),
-            /* @__PURE__ */ jsx(
-              "button",
-              {
-                type: "button",
-                className: "rounded-md border px-4 py-2 text-sm font-medium text-foreground",
-                onClick: () => navigate("../list"),
-                children: tr(
-                  "fluidgrids.builder.workflowNotFound.back",
-                  "Back to Workflows"
-                )
-              }
-            )
-          ] })
-        ]
+        title: tr(
+          "fluidgrids.builder.workflowNotFound.title",
+          "Workflow not found"
+        ),
+        description: tr(
+          "fluidgrids.builder.workflowNotFound.description",
+          "No workflow with this key exists in this workspace, or it could not be loaded. Nothing was created."
+        ),
+        retryLabel,
+        onRetry: () => setRetryNonce((n) => n + 1),
+        backLabel,
+        onBack: () => navigate("../list")
+      }
+    );
+  if (reloadFailed)
+    return /* @__PURE__ */ jsx(
+      LoadProblem,
+      {
+        testId: "fluidgrids-builder-reload-failed",
+        title: tr(
+          "fluidgrids.builder.reloadFailed.title",
+          "The latest version did not load"
+        ),
+        description: tr(
+          "fluidgrids.builder.reloadFailed.description",
+          "The latest saved version of this workflow could not be loaded, so nothing older is shown in its place. Check your connection and try again."
+        ),
+        retryLabel,
+        onRetry: () => setRetryNonce((n) => n + 1),
+        backLabel,
+        onBack: () => navigate("../list")
       }
     );
   return /* @__PURE__ */ jsxs(Fragment, { children: [