@burdenoff/fluidgrids-fe-sdk 2026.1029.6 → 2026.1029.8

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

@@ -1,4 +1,4 @@
-import { NodeEndpointConfigsDocument, NodeEndpointConfigDocument, NodeManifestDocument, fetchAllNodeEndpointConfigs } from './chunk-7PP6CRXS.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-57RS7DXZ.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-4TGUNOQQ.js';
-import { useExecutionsStore } from './chunk-CY6KX4RG.js';
-import { ExecutionsListDocument, ExecutionDetailDocument, ExecutionStatsDocument, PauseExecutionDocument, ResumeExecutionDocument, CancelExecutionDocument, RetryNodeDocument, TriggerWorkflowDocument, TerminateExecutionDocument } from './chunk-7PP6CRXS.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-GQTEHWWY.js';
 import { useTr } from './chunk-UULVIT25.js';
 import { getFluidGridsClient } from './chunk-NTWG3CJX.js';
 import { useState, useRef, useCallback, useEffect, useMemo } from 'react';
@@ -75,6 +75,107 @@ function dateRangeToInput(start, end) {
   return input;
 }
 
+// src/modules/executions/utils/run-parity.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function text(value) {
+  return typeof value === "string" && value.trim() ? value : void 0;
+}
+function runChainLinks(run) {
+  const candidates = [
+    ["previous", run.continuedFromRunId],
+    ["next", run.continuedToRunId],
+    ["first", run.firstRunId],
+    ["root", run.rootRunId === run.parentRunId ? null : run.rootRunId]
+  ];
+  const seen = /* @__PURE__ */ new Set([run.id]);
+  const links = [];
+  for (const [kind, runId] of candidates) {
+    if (!runId || seen.has(runId)) continue;
+    seen.add(runId);
+    links.push({ kind, runId });
+  }
+  return links;
+}
+function shortRunId(runId, length = 12) {
+  return runId.length > length ? `${runId.slice(0, length)}\u2026` : runId;
+}
+function handlersOf(value) {
+  const entries = Array.isArray(value) ? value.map((entry) => [void 0, entry]) : isRecord(value) ? Object.entries(value) : [];
+  const handlers = [];
+  for (const [key, entry] of entries) {
+    if (typeof entry === "string") {
+      handlers.push({ name: entry });
+      continue;
+    }
+    if (!isRecord(entry)) continue;
+    const name = text(entry.name) ?? key;
+    if (!name) continue;
+    const description = text(entry.description);
+    handlers.push(description ? { name, description } : { name });
+  }
+  return handlers;
+}
+function parseMetadataDefinition(definition) {
+  const value = isRecord(definition) ? definition : {};
+  return {
+    name: text(value.name),
+    signals: handlersOf(value.signals),
+    queries: handlersOf(value.queries),
+    updates: handlersOf(value.updates)
+  };
+}
+var WORKFLOW_ID_MAX_LENGTH = 256;
+function withWorkflowIdFilter(input, workflowId, parityEnabled) {
+  const value = workflowId.trim();
+  if (!parityEnabled || !value) return input;
+  return { ...input, businessId: value.slice(0, WORKFLOW_ID_MAX_LENGTH) };
+}
+function statusCountFilter(input) {
+  const rest = { ...input };
+  delete rest.limit;
+  delete rest.offset;
+  delete rest.status;
+  return rest;
+}
+var STATUS_COUNT_GROUP_BY = ["STATUS" /* Status */];
+function statusCountsOf(groups) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const group of groups) {
+    const status = group.values[0] ?? group.key;
+    if (!status) continue;
+    counts.set(status, (counts.get(status) ?? 0) + group.count);
+  }
+  return [...counts.entries()].map(([status, count]) => ({ status, count })).sort((a, b) => b.count - a.count || a.status.localeCompare(b.status));
+}
+function overrideRequestOf(choice, version) {
+  if (choice === "remove") return { ok: true, override: null };
+  if (choice === "autoUpgrade")
+    return {
+      ok: true,
+      override: { behavior: "AUTO_UPGRADE" /* AutoUpgrade */ }
+    };
+  const pinned = version.trim();
+  if (!pinned) return { ok: false, reason: "versionRequired" };
+  return {
+    ok: true,
+    override: { behavior: "PINNED" /* Pinned */, version: pinned }
+  };
+}
+function callbackTone(status) {
+  switch (status) {
+    case "DELIVERED":
+      return "success";
+    case "FAILED":
+      return "error";
+    case "DELIVERING":
+      return "info";
+    default:
+      return "neutral";
+  }
+}
+
 // src/modules/executions/utils/retry.ts
 var NON_REPLAYABLE_CONTEXT_KEYS = ["isScheduled", "workspaceId"];
 function buildRetryTriggerInput(run) {
@@ -443,7 +544,9 @@ function useExecutionActions() {
   };
 }
 var EXECUTIONS_SEARCH_DEBOUNCE_MS = 350;
-function useExecutionsWithStore() {
+function useExecutionsWithStore({
+  durableParity = false
+} = {}) {
   const { filter, pagination, setTotal } = useExecutionsStore();
   const [debouncedSearch, setDebouncedSearch] = useState(filter.search);
   useEffect(() => {
@@ -490,15 +593,21 @@ function useExecutionsWithStore() {
     if (filter.tagId) {
       baseInput.tagIds = [filter.tagId];
     }
-    return baseInput;
-  }, [filter, debouncedSearch, pagination.page, pagination.pageSize]);
+    return withWorkflowIdFilter(baseInput, filter.workflowId, durableParity);
+  }, [
+    filter,
+    debouncedSearch,
+    pagination.page,
+    pagination.pageSize,
+    durableParity
+  ]);
   const result = useExecutions(input);
   useEffect(() => {
     if (result.total !== pagination.total) {
       setTotal(result.total);
     }
   }, [result.total, pagination.total, setTotal]);
-  return result;
+  return { ...result, input };
 }
 function useAutoRefresh(refetchFn, enabled = true, interval = 5e3) {
   useEffect(() => {
@@ -510,4 +619,4 @@ function useAutoRefresh(refetchFn, enabled = true, interval = 5e3) {
   }, [enabled, interval, refetchFn]);
 }
 
-export { useAutoRefresh, useExecution, useExecutionActions, useExecutionStats, useExecutions, useExecutionsWithStore, validateDateRange };
+export { STATUS_COUNT_GROUP_BY, WORKFLOW_ID_MAX_LENGTH, callbackTone, overrideRequestOf, parseMetadataDefinition, runChainLinks, shortRunId, statusCountFilter, statusCountsOf, useAutoRefresh, useExecution, useExecutionActions, useExecutionStats, useExecutions, useExecutionsWithStore, validateDateRange };

package/dist/{chunk-7B2GRTUL.js → chunk-LJGC7RAL.js}

@@ -1,18 +1,18 @@
-import { isGuidedTourIntent, pickGuidedTour, withoutGuidedTourIntent, isCreateIntent, CreateWorkflowRefusalDialog, decideMissingWorkflow } from './chunk-MNY2UNQH.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-Z6EWB5ZG.js';
-import { useLazyWorkflowDefinition, useCreateWorkflow } from './chunk-LTVAUZ3M.js';
-import { useFlowStore, refetchStoreNodes, BILLING_PLANS_PATH, codeBuildIdOf, mergeStickyNotes, blankWorkflowCreateInput, classifyCreateRefusal, useSaveStatusStore, workflowFingerprint, registerWorkflowNodeTypes, throwIfResultError } from './chunk-4TGUNOQQ.js';
-import { getFluidGridsConfig } from './chunk-CY6KX4RG.js';
-import { WorkflowDefinitionDocument } from './chunk-7PP6CRXS.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-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(
@@ -770,7 +822,7 @@ function WorkflowItem({
       try {
         const { getGlobalStoreClient } = await import('./global-client-KLOVTVPP.js');
         const { InstallWorkflowNodeDocument } = await import('./global-operations-D2USVOPM.js');
-        const { getFluidGridsConfig: getFluidGridsConfig2 } = await import('./config-T7BQ7AO2.js');
+        const { getFluidGridsConfig: getFluidGridsConfig2 } = await import('./config-VM7FTHMZ.js');
         const storeClient = getGlobalStoreClient();
         const cfg = getFluidGridsConfig2();
         for (let i = 0; i < nodesToInstall.length; i++) {
@@ -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: [