@burdenoff/fluidgrids-fe-sdk 2026.1029.6 → 2026.1029.8

package/dist/{chunk-4TGUNOQQ.js → chunk-NAYPOEYM.js}

@@ -1,19 +1,19 @@
 import { cn as cn$1 } from './chunk-JL7CASN5.js';
 import { getGlobalStoreClient, createGlobalStoreClient, setGlobalStoreClient, resetGlobalStoreClient } from './chunk-PXIFUMLA.js';
-import { getFluidGridsConfig, validateTrustedOrigin, resetFluidGridsExecutionState, setFluidGridsConfig, resetFluidGridsConfig } from './chunk-CY6KX4RG.js';
+import { getFluidGridsConfig, validateTrustedOrigin, resetFluidGridsExecutionState, setFluidGridsConfig, resetFluidGridsConfig } from './chunk-6AMNEX2Y.js';
 import { GetMyNodeInstallationsDocument } from './chunk-JUUYPCFY.js';
-import { fetchAllNodeEndpointConfigs, NodeManifestDocument, UpdateWorkflowDefinitionDocument, CreateWorkflowDefinitionDocument, CreateWorkflowVersionDocument, ExecuteStepDocument, TriggerWorkflowDocument, RunFromNodeDocument, ExecutionDetailDocument, WorkflowDefinitionDocument, WorkflowRunDocument } from './chunk-7PP6CRXS.js';
+import { fetchAllNodeEndpointConfigs, NodeManifestDocument, UpdateWorkflowDefinitionDocument, CreateWorkflowDefinitionDocument, CreateWorkflowVersionDocument, ExecuteStepDocument, TriggerWorkflowDocument, RunFromNodeDocument, ExecutionDetailDocument, WorkflowDefinitionDocument, WorkflowRunDocument } from './chunk-GQTEHWWY.js';
 import { useTr, ENGLISH_FALLBACK_TRANSLATOR, FluidGridsTranslationProvider } from './chunk-UULVIT25.js';
 import { waitForFluidGridsClient, getFluidGridsClient, getFluidGridsClientSafe, createFluidGridsClient, setFluidGridsClient, resetFluidGridsClient } from './chunk-NTWG3CJX.js';
+import * as React2 from 'react';
+import { forwardRef, useState, useImperativeHandle, useRef, useEffect, useMemo, createContext, memo, useCallback, useContext, useSyncExternalStore, cloneElement } from 'react';
+import { useOptionalFeatureFlags } from '@burdenoff/fe-libs/shared/feature-flags';
 import { CombinedGraphQLErrors, ServerError } from '@apollo/client/errors';
 import { dispatchUpgradePrompt } from '@burdenoff/fe-libs/shared/components';
 import { nanoid } from 'nanoid/non-secure';
 import { addEdge, applyEdgeChanges, applyNodeChanges, useReactFlow, NodeResizer, getConnectedEdges, useStore, Handle, Position, useUpdateNodeInternals, useNodeId } from '@xyflow/react';
 import { create } from 'zustand';
 import { produce } from 'immer';
-import * as React2 from 'react';
-import { forwardRef, useState, useImperativeHandle, useRef, useEffect, useMemo, createContext, memo, useCallback, useSyncExternalStore, useContext, cloneElement } from 'react';
-import { useOptionalFeatureFlags } from '@burdenoff/fe-libs/shared/feature-flags';
 import { Textarea, Input, Button, Card, Dialog, DialogTrigger, DialogContent, DialogHeader, DialogTitle, DialogDescription, DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuLabel, DropdownMenuItem, DropdownMenuSeparator } from '@burdenoff/fe-libs/ui';
 import { cn } from '@burdenoff/fe-libs/utils';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
@@ -34,6 +34,104 @@ import { useParams, useNavigate } from 'react-router';
 import { useShallow } from 'zustand/shallow';
 import { InfoCircledIcon } from '@radix-ui/react-icons';
 
+// src/feature-flags/durable-nodes.ts
+var DURABLE_FUNCTION_NODE_TYPES = /* @__PURE__ */ new Set([
+  "internal:code-workflow",
+  "internal:wait-for-signal"
+]);
+function isDurableFunctionNodeType(nodeType) {
+  return !!nodeType && DURABLE_FUNCTION_NODE_TYPES.has(nodeType);
+}
+function isNodeTypeHiddenFromPalette(nodeType, durableFunctionsEnabled = false) {
+  return !durableFunctionsEnabled && isDurableFunctionNodeType(nodeType);
+}
+function filterPaletteNodes(nodes, durableFunctionsEnabled = false) {
+  if (durableFunctionsEnabled) return nodes;
+  if (!nodes.some((node) => isDurableFunctionNodeType(node.type))) return nodes;
+  return nodes.filter((node) => !isDurableFunctionNodeType(node.type));
+}
+var FLUIDGRIDS_FLAGS = {
+  /**
+   * Operational kill switch for log stream destinations (webhook, syslog,
+   * Sentry). Defaults on; an admin turning it off hides the Log streaming
+   * settings and the backend rejects destination writes with FEATURE_DISABLED.
+   */
+  logStreams: "fluidgrids.log-streams",
+  /**
+   * Code-first workflows (BOFF-9902): the builder's Code view, Export as
+   * TypeScript / Python and TypeScript import. A rollout gate, not a kill
+   * switch, so it defaults OFF: the controls stay hidden until tenant-svc
+   * evaluates the flag on for the workspace, including when the shell mounts
+   * no FeatureFlagProvider or the evaluation is still loading.
+   */
+  codeFirst: "fluidgrids.code-first",
+  /**
+   * Durable functions (BOFF-9905): the Code Workflow and Wait for Signal
+   * nodes, run history, signals and the source editor. A rollout gate like
+   * `codeFirst`, so it defaults OFF and fails closed. The durable nodes are
+   * shown in the palette only while both this flag and `codeFirst` are on.
+   */
+  durableFunctions: "fluidgrids.durable-functions",
+  /**
+   * Durable-function parity (BOFF-9905, spec code-first 11): workflow ids and
+   * run chains, run metadata, what a run is waiting on, run counts,
+   * completion callbacks, versioning (rollouts, drainage, per-run overrides)
+   * and the history caps. A rollout gate like `durableFunctions`, so it
+   * defaults OFF and fails closed; the parity surfaces show only while this
+   * flag, `durableFunctions` and `codeFirst` are all on.
+   */
+  durableParity: "fluidgrids.durable-parity"
+};
+var FLUIDGRIDS_FLAG_DEFAULTS = {
+  [FLUIDGRIDS_FLAGS.logStreams]: true,
+  [FLUIDGRIDS_FLAGS.codeFirst]: false,
+  [FLUIDGRIDS_FLAGS.durableFunctions]: false,
+  [FLUIDGRIDS_FLAGS.durableParity]: false
+};
+var settledEvaluations = /* @__PURE__ */ new WeakMap();
+function evaluationsUsable(context) {
+  const { evaluations } = context;
+  if (!evaluations) return !context.isLoading;
+  const workspace = context.workspaceId ?? null;
+  const settledFor = settledEvaluations.get(evaluations);
+  if (context.isLoading)
+    return settledFor !== void 0 && settledFor === workspace;
+  if (settledFor === void 0) {
+    settledEvaluations.set(evaluations, workspace);
+    return true;
+  }
+  return settledFor === workspace;
+}
+function resolveFluidGridsFlag(context, flag) {
+  const fallback = FLUIDGRIDS_FLAG_DEFAULTS[flag];
+  if (!context) return fallback;
+  if (fallback) {
+    if (context.isLoading) return fallback;
+    const evaluation2 = context.getEvaluation(flag);
+    return evaluation2 ? Boolean(evaluation2.value) : fallback;
+  }
+  if (context.error || !evaluationsUsable(context)) return false;
+  const evaluation = context.getEvaluation(flag);
+  return !!evaluation && !evaluation.errorCode && evaluation.value === true;
+}
+function useFluidGridsFlag(flag) {
+  const context = useOptionalFeatureFlags();
+  return useMemo(() => resolveFluidGridsFlag(context, flag), [context, flag]);
+}
+function useDurableFunctionNodesEnabled() {
+  const context = useOptionalFeatureFlags();
+  return useMemo(
+    () => resolveFluidGridsFlag(context, FLUIDGRIDS_FLAGS.codeFirst) && resolveFluidGridsFlag(context, FLUIDGRIDS_FLAGS.durableFunctions),
+    [context]
+  );
+}
+function resolveDurableParity(context) {
+  return resolveFluidGridsFlag(context, FLUIDGRIDS_FLAGS.codeFirst) && resolveFluidGridsFlag(context, FLUIDGRIDS_FLAGS.durableFunctions) && resolveFluidGridsFlag(context, FLUIDGRIDS_FLAGS.durableParity);
+}
+function useDurableParityEnabled() {
+  const context = useOptionalFeatureFlags();
+  return useMemo(() => resolveDurableParity(context), [context]);
+}
 function describeGraphQLError(error) {
   const code = typeof error.extensions?.code === "string" ? error.extensions.code : void 0;
   switch (code) {
@@ -1240,88 +1338,6 @@ if (typeof window !== "undefined" && import.meta.env?.DEV) {
   window.__fgFlowStore = useFlowStore;
 }
 
-// src/feature-flags/durable-nodes.ts
-var DURABLE_FUNCTION_NODE_TYPES = /* @__PURE__ */ new Set([
-  "internal:code-workflow",
-  "internal:wait-for-signal"
-]);
-function isDurableFunctionNodeType(nodeType) {
-  return !!nodeType && DURABLE_FUNCTION_NODE_TYPES.has(nodeType);
-}
-function isNodeTypeHiddenFromPalette(nodeType, durableFunctionsEnabled = false) {
-  return !durableFunctionsEnabled && isDurableFunctionNodeType(nodeType);
-}
-function filterPaletteNodes(nodes, durableFunctionsEnabled = false) {
-  if (durableFunctionsEnabled) return nodes;
-  if (!nodes.some((node) => isDurableFunctionNodeType(node.type))) return nodes;
-  return nodes.filter((node) => !isDurableFunctionNodeType(node.type));
-}
-var FLUIDGRIDS_FLAGS = {
-  /**
-   * Operational kill switch for log stream destinations (webhook, syslog,
-   * Sentry). Defaults on; an admin turning it off hides the Log streaming
-   * settings and the backend rejects destination writes with FEATURE_DISABLED.
-   */
-  logStreams: "fluidgrids.log-streams",
-  /**
-   * Code-first workflows (BOFF-9902): the builder's Code view, Export as
-   * TypeScript / Python and TypeScript import. A rollout gate, not a kill
-   * switch, so it defaults OFF: the controls stay hidden until tenant-svc
-   * evaluates the flag on for the workspace, including when the shell mounts
-   * no FeatureFlagProvider or the evaluation is still loading.
-   */
-  codeFirst: "fluidgrids.code-first",
-  /**
-   * Durable functions (BOFF-9905): the Code Workflow and Wait for Signal
-   * nodes, run history, signals and the source editor. A rollout gate like
-   * `codeFirst`, so it defaults OFF and fails closed. The durable nodes are
-   * shown in the palette only while both this flag and `codeFirst` are on.
-   */
-  durableFunctions: "fluidgrids.durable-functions"
-};
-var FLUIDGRIDS_FLAG_DEFAULTS = {
-  [FLUIDGRIDS_FLAGS.logStreams]: true,
-  [FLUIDGRIDS_FLAGS.codeFirst]: false,
-  [FLUIDGRIDS_FLAGS.durableFunctions]: false
-};
-var settledEvaluations = /* @__PURE__ */ new WeakMap();
-function evaluationsUsable(context) {
-  const { evaluations } = context;
-  if (!evaluations) return !context.isLoading;
-  const workspace = context.workspaceId ?? null;
-  const settledFor = settledEvaluations.get(evaluations);
-  if (context.isLoading)
-    return settledFor !== void 0 && settledFor === workspace;
-  if (settledFor === void 0) {
-    settledEvaluations.set(evaluations, workspace);
-    return true;
-  }
-  return settledFor === workspace;
-}
-function resolveFluidGridsFlag(context, flag) {
-  const fallback = FLUIDGRIDS_FLAG_DEFAULTS[flag];
-  if (!context) return fallback;
-  if (fallback) {
-    if (context.isLoading) return fallback;
-    const evaluation2 = context.getEvaluation(flag);
-    return evaluation2 ? Boolean(evaluation2.value) : fallback;
-  }
-  if (context.error || !evaluationsUsable(context)) return false;
-  const evaluation = context.getEvaluation(flag);
-  return !!evaluation && !evaluation.errorCode && evaluation.value === true;
-}
-function useFluidGridsFlag(flag) {
-  const context = useOptionalFeatureFlags();
-  return useMemo(() => resolveFluidGridsFlag(context, flag), [context, flag]);
-}
-function useDurableFunctionNodesEnabled() {
-  const context = useOptionalFeatureFlags();
-  return useMemo(
-    () => resolveFluidGridsFlag(context, FLUIDGRIDS_FLAGS.codeFirst) && resolveFluidGridsFlag(context, FLUIDGRIDS_FLAGS.durableFunctions),
-    [context]
-  );
-}
-
 // src/modules/executions/utils/signal-targets.ts
 function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -4540,6 +4556,11 @@ function useDeleteNode() {
     [deleteElements, getEdges, getNode, deleteNodes]
   );
 }
+var BuilderReadOnlyContext = createContext(false);
+var BuilderReadOnlyProvider = BuilderReadOnlyContext.Provider;
+function useBuilderReadOnly() {
+  return useContext(BuilderReadOnlyContext);
+}
 
 // src/builder/contants/symbols.ts
 var NODE_TYPE_DRAG_DATA_FORMAT = "application/flow-builder.node-type";
@@ -4589,6 +4610,7 @@ function StickyNoteNodeComponent({
   const { setNodes, getNode } = useReactFlow();
   const zustandSetNodes = useFlowStore((s) => s.actions.nodes.setNodes);
   const deleteNode = useDeleteNode();
+  const readOnly = useBuilderReadOnly();
   const [editing, setEditing] = useState(false);
   const [showPalette, setShowPalette] = useState(false);
   const [draft, setDraft] = useState(String(data.content ?? ""));
@@ -4664,7 +4686,7 @@ function StickyNoteNodeComponent({
       /* @__PURE__ */ jsx(
         NodeResizer,
         {
-          isVisible: !!selected,
+          isVisible: !!selected && !readOnly,
           minWidth: STICKY_MIN_SIZE.width,
           minHeight: STICKY_MIN_SIZE.height,
           lineStyle: { border: "none", zIndex: 20 },
@@ -4682,7 +4704,9 @@ function StickyNoteNodeComponent({
         {
           className: cn(
             "absolute right-1 z-30 flex items-center gap-0.5 rounded-lg border border-border bg-card p-0.5 shadow-md transition-all duration-150",
-            selected || showPalette ? "pointer-events-auto opacity-100" : "pointer-events-none opacity-0 group-hover:pointer-events-auto group-hover:opacity-100"
+            selected || showPalette ? "pointer-events-auto opacity-100" : "pointer-events-none opacity-0 group-hover:pointer-events-auto group-hover:opacity-100",
+            // Nothing to change on a read-only canvas (BOFF-9725).
+            readOnly && "hidden"
           ),
           style: { top: -15 },
           onDoubleClick: (e) => e.stopPropagation(),
@@ -4770,12 +4794,13 @@ function StickyNoteNodeComponent({
           },
           onDoubleClick: (e) => {
             e.stopPropagation();
-            startEditing();
+            if (!readOnly) startEditing();
           },
           children: editing ? /* @__PURE__ */ jsx(
             "textarea",
             {
               ref: textareaRef,
+              readOnly,
               value: draft,
               onChange: (e) => setDraft(e.target.value),
               onBlur: commitEdit,
@@ -6564,8 +6589,26 @@ var PERMANENT_ERROR_CODES = /* @__PURE__ */ new Set([
   "FAILED_PRECONDITION",
   "CONFLICT"
 ]);
+function textOf(value) {
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function findSaveConflict(error) {
+  const extensions = collectExtensions(error).find(
+    (ext) => ext.code === "CONFLICT" && (ext.reason === "STALE_REVISION" || ext.reason === "EDIT_LEASE_HELD")
+  );
+  if (!extensions) return null;
+  const revision = extensions.currentRevision;
+  return {
+    reason: extensions.reason,
+    currentRevision: typeof revision === "number" && Number.isFinite(revision) ? revision : null,
+    currentStatus: textOf(extensions.currentStatus),
+    updatedById: textOf(extensions.updatedById),
+    holderActorId: textOf(extensions.holderActorId)
+  };
+}
 function classifySaveFailure(error) {
   if (findQuotaRefusal(error)) return "quota";
+  if (findSaveConflict(error)) return "conflict";
   if (errorCodesOf(error).some((code) => PERMANENT_ERROR_CODES.has(code))) {
     return "permanent";
   }
@@ -6675,6 +6718,196 @@ function editStateOf(baseline, current, now) {
   return "dirty";
 }
 
+// src/builder/lib/workflow-revisions.ts
+var known = /* @__PURE__ */ new Map();
+function rememberRevision(dbId, revision) {
+  if (!dbId || typeof revision !== "number" || !Number.isFinite(revision)) {
+    return;
+  }
+  const current = known.get(dbId);
+  if (current === void 0 || revision > current) known.set(dbId, revision);
+}
+function rememberOwnStatusChange(dbId, revision) {
+  if (!dbId || typeof revision !== "number") return;
+  const current = known.get(dbId);
+  if (current !== void 0 && revision === current + 1) {
+    known.set(dbId, revision);
+  }
+}
+function revisionOf(dbId) {
+  return dbId ? known.get(dbId) : void 0;
+}
+
+// src/builder/lib/edit-session.ts
+var SESSION_ID_PATTERN = /^[A-Za-z0-9_-]{8,64}$/;
+function randomSessionId() {
+  const cryptoApi = globalThis.crypto;
+  if (cryptoApi?.randomUUID) return cryptoApi.randomUUID();
+  const bytes = new Uint8Array(16);
+  cryptoApi?.getRandomValues?.(bytes);
+  if (bytes.every((byte) => byte === 0)) {
+    for (let i = 0; i < bytes.length; i += 1) {
+      bytes[i] = Math.floor(Math.random() * 256);
+    }
+  }
+  return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join(
+    ""
+  );
+}
+var EDIT_SESSION_ID = randomSessionId();
+var storageKey = (workflowKey) => `fluidgrids.builder.editSession.${workflowKey}`;
+function rememberSessionForReload(storage, workflowKey, sessionId) {
+  try {
+    storage?.setItem(storageKey(workflowKey), sessionId);
+  } catch {
+  }
+}
+function sessionBeforeReload(storage, workflowKey, currentSessionId = EDIT_SESSION_ID) {
+  try {
+    const stored = storage?.getItem(storageKey(workflowKey)) ?? null;
+    if (!stored || stored === currentSessionId) return null;
+    return SESSION_ID_PATTERN.test(stored) ? stored : null;
+  } catch {
+    return null;
+  }
+}
+function forgetSessionForReload(storage, workflowKey) {
+  try {
+    storage?.removeItem(storageKey(workflowKey));
+  } catch {
+  }
+}
+
+// src/builder/lib/edit-lease.ts
+var LEASE_RENEW_MS = 2e4;
+var LEASE_VIEW_POLL_MS = 1e4;
+var LEASE_IDLE_RELEASE_MS = 15 * 6e4;
+function isLocked(phase) {
+  return phase === "viewing" || phase === "lost" || phase === "idle" || phase === "reloading";
+}
+function phaseAfterAcquire(previous, answer) {
+  if (!answer.available) {
+    return isLocked(previous) || previous === "holding" ? previous : "unavailable";
+  }
+  if (answer.heldBySelf) return "holding";
+  if (answer.held) return previous === "holding" ? "lost" : "viewing";
+  return previous;
+}
+function phaseAfterTakeOver(answer) {
+  if (!answer.available) return "unavailable";
+  return answer.heldBySelf ? "reloading" : "viewing";
+}
+function releasesOnClose(phase) {
+  return phase === "starting" || phase === "holding" || phase === "unavailable";
+}
+var LEASE_CALL_MAX_WAIT_MS = 15e3;
+function leaseCallQueue(maxWaitMs = LEASE_CALL_MAX_WAIT_MS) {
+  const tails = /* @__PURE__ */ new Map();
+  return {
+    run(workflowKey, call) {
+      const previous = tails.get(workflowKey) ?? Promise.resolve();
+      const result = previous.then(call);
+      const tail = previous.then(
+        () => new Promise((resolve) => {
+          const timer = setTimeout(resolve, maxWaitMs);
+          const done = () => {
+            clearTimeout(timer);
+            resolve();
+          };
+          result.then(done, done);
+        })
+      );
+      tails.set(workflowKey, tail);
+      void tail.then(() => {
+        if (tails.get(workflowKey) === tail) tails.delete(workflowKey);
+      });
+      return result;
+    }
+  };
+}
+function shouldReleaseForIdle(phase, lastInputAt, now) {
+  return phase === "holding" && now - lastInputAt >= LEASE_IDLE_RELEASE_MS;
+}
+function tickAction(phase, state, now) {
+  if (phase === "holding" || phase === "unavailable") {
+    return now - state.lastRenewAt >= LEASE_RENEW_MS ? "renew" : "none";
+  }
+  if (phase === "viewing" || phase === "lost" || phase === "idle") {
+    return state.visible && now - state.lastPeekAt >= LEASE_VIEW_POLL_MS ? "peek" : "none";
+  }
+  return "none";
+}
+function bannerOf(state) {
+  switch (state.phase) {
+    case "viewing":
+      return state.held ? {
+        kind: "editing",
+        actorId: state.holderActorId,
+        self: state.heldByCaller
+      } : { kind: "free" };
+    case "lost":
+      return {
+        kind: "taken",
+        actorId: state.takenBy,
+        self: state.takenByCaller
+      };
+    case "idle":
+      return { kind: "idle" };
+    case "reloading":
+      return { kind: "reloading" };
+    default:
+      return null;
+  }
+}
+var IDLE = {
+  workflowKey: null,
+  phase: "inactive",
+  held: false,
+  holderActorId: null,
+  heldByCaller: false,
+  takenBy: null,
+  takenByCaller: false
+};
+function commitFocusedEdit() {
+  if (typeof document === "undefined") return;
+  const focused = document.activeElement;
+  if (!focused || typeof focused.blur !== "function") return;
+  const editable = focused.isContentEditable || typeof focused.matches === "function" && focused.matches("input, textarea, select");
+  if (editable) focused.blur();
+}
+var useEditLeaseStore = create()((set, get) => ({
+  ...IDLE,
+  actions: {
+    begin: (workflowKey) => set(
+      (state) => (
+        // A reload of the same workflow keeps "reloading" (and its lock)
+        // until the lease is confirmed again.
+        state.workflowKey === workflowKey && state.phase === "reloading" ? state : { ...IDLE, workflowKey, phase: "starting" }
+      )
+    ),
+    record: (phase, answer) => {
+      if (isLocked(phase) && !isLocked(get().phase)) commitFocusedEdit();
+      set(() => {
+        if (!answer || !answer.available) return { phase };
+        const holderActorId = answer.held ? answer.holderActorId ?? null : null;
+        const heldByCaller = answer.held && !!answer.heldByCaller;
+        const taken = phase !== "lost" ? { takenBy: null, takenByCaller: false } : answer.held ? { takenBy: holderActorId, takenByCaller: heldByCaller } : {};
+        return {
+          phase,
+          held: answer.held,
+          holderActorId,
+          heldByCaller,
+          ...taken
+        };
+      });
+    },
+    reset: () => set({ ...IDLE })
+  }
+}));
+function useEditLeaseLocked() {
+  return useEditLeaseStore((s) => isLocked(s.phase));
+}
+
 // src/builder/lib/workflow-save-snapshot.ts
 function snapshotForSave(workflow, generation, route = {}) {
   const copy = {
@@ -6712,7 +6945,8 @@ var PRISTINE = {
   baseline: null,
   quotaExhausted: false,
   leaveRequest: null,
-  autosavePaused: false
+  autosavePaused: false,
+  conflictOpen: false
 };
 var useSaveStatusStore = create()((set) => ({
   ...PRISTINE,
@@ -6729,10 +6963,15 @@ var useSaveStatusStore = create()((set) => ({
         failure: null,
         incomplete: false,
         autosavePaused: false,
+        conflictOpen: false,
         lastSavedAt: at
       } : { saving: false }
     ),
-    saveFailed: (failure) => set({ saving: false, failure }),
+    saveFailed: (failure) => set({
+      saving: false,
+      failure,
+      conflictOpen: failure.conflict?.reason === "STALE_REVISION"
+    }),
     clearFailure: () => set({ failure: null }),
     setQuotaExhausted: (quotaExhausted) => set({ quotaExhausted }),
     setAutosaveEnabled: (autosaveEnabled) => {
@@ -6741,6 +6980,7 @@ var useSaveStatusStore = create()((set) => ({
     },
     requestLeave: (leaveRequest) => set({ leaveRequest }),
     setAutosavePaused: (autosavePaused) => set({ autosavePaused }),
+    setConflictOpen: (conflictOpen) => set({ conflictOpen }),
     reset: () => set({ ...PRISTINE })
   }
 }));
@@ -6859,13 +7099,15 @@ function useSaveWorkflow() {
   const { bus, workspaceId } = useFluidGridsAnalytics();
   const setWorkflow = useFlowStore((s) => s.actions.setWorkflow);
   const performSave = useCallback(
-    async (snapshot, silent) => {
+    async (snapshot, silent, asNewVersion) => {
       const stillOpen = () => useFlowStore.getState().loadGeneration === snapshot.generation;
       try {
         const { workflow } = snapshot;
         const mintedKey = snapshot.key ? null : v4();
         const workflowKey = snapshot.key || mintedKey || "";
-        const isDraft = !workflow.status || workflow.status === "DRAFT";
+        const forkRequested = asNewVersion && !!workflow.dbId;
+        const isDraft = !forkRequested && (!workflow.status || workflow.status === "DRAFT");
+        const expectedRevision = revisionOf(workflow.dbId);
         const client = getFluidGridsClient();
         const { preparedWorkflow, owned } = builderDefinition(
           snapshot,
@@ -6891,7 +7133,11 @@ function useSaveWorkflow() {
                   description: workflow.name || "Workflow update",
                   // null (not undefined) so an emptied alias field actually
                   // CLEARS the alias — undefined is dropped by the resolver.
-                  alias: workflow.alias?.trim() ? workflow.alias.trim() : null
+                  alias: workflow.alias?.trim() ? workflow.alias.trim() : null,
+                  // Refused instead of overwriting a change made elsewhere,
+                  // or a save from a page that no longer holds the edit lease.
+                  ...expectedRevision !== void 0 ? { expectedRevision } : {},
+                  editSessionId: EDIT_SESSION_ID
                 }
               }
             })
@@ -6901,6 +7147,7 @@ function useSaveWorkflow() {
           }
           savedVersion = data.updateWorkflowDefinition.version;
           savedDbId = data.updateWorkflowDefinition.id;
+          rememberRevision(savedDbId, data.updateWorkflowDefinition.revision);
           operation = "updated";
           if (!silent) {
             toast.success("Workflow saved", {
@@ -6928,6 +7175,7 @@ function useSaveWorkflow() {
           }
           savedVersion = data.createWorkflowDefinition.version;
           savedDbId = data.createWorkflowDefinition.id;
+          rememberRevision(savedDbId, data.createWorkflowDefinition.revision);
           operation = "created";
           emitWorkflowCreated(bus, {
             workspaceId,
@@ -6968,7 +7216,15 @@ function useSaveWorkflow() {
                   // pointer — the backend clears it from siblings). Included
                   // only when set so saves without an alias don't depend on the
                   // new schema field being deployed.
-                  ...workflow.alias?.trim() ? { alias: workflow.alias.trim() } : {}
+                  ...workflow.alias?.trim() ? { alias: workflow.alias.trim() } : {},
+                  // A save of an ACTIVE or ARCHIVED version claims it, so two
+                  // pages that loaded it never create rival drafts. Keeping
+                  // the canvas as a new version on purpose skips the claim.
+                  ...forkRequested ? {} : {
+                    baseVersion: workflow.version,
+                    ...expectedRevision !== void 0 ? { expectedRevision } : {},
+                    editSessionId: EDIT_SESSION_ID
+                  }
                 }
               }
             })
@@ -6981,6 +7237,7 @@ function useSaveWorkflow() {
           const newWorkflow = data.createWorkflowVersion.workflow;
           savedVersion = newWorkflow?.version ?? workflow.version;
           savedDbId = newWorkflow?.id ?? workflow.dbId;
+          rememberRevision(newWorkflow?.id, newWorkflow?.revision);
           operation = "versioned";
           if (stillOpen()) {
             setWorkflow({
@@ -7026,15 +7283,30 @@ function useSaveWorkflow() {
         console.error("Error saving workflow:", message);
         const cause = error instanceof Error ? error.cause : void 0;
         const quotaExhausted2 = isQuotaExhaustedFailure(cause) || isQuotaExhaustedFailure(error);
-        if (!quotaExhausted2 && !silent) {
+        const conflict = findSaveConflict(error);
+        if (!quotaExhausted2 && !conflict && !silent) {
           toast.error("Failed to save workflow", {
             description: message
           });
         }
+        if (conflict?.reason === "EDIT_LEASE_HELD" && stillOpen()) {
+          const lease = useEditLeaseStore.getState();
+          const answer = {
+            available: true,
+            held: true,
+            heldBySelf: false,
+            holderActorId: conflict.holderActorId
+          };
+          lease.actions.record(phaseAfterAcquire(lease.phase, answer), answer);
+        }
         return {
           saved: false,
           quotaExhausted: quotaExhausted2,
-          failure: { message, kind: classifySaveFailure(error) }
+          failure: {
+            message,
+            kind: classifySaveFailure(error),
+            ...conflict ? { conflict } : {}
+          }
         };
       }
     },
@@ -7050,7 +7322,11 @@ function useSaveWorkflow() {
           statusActions.beginSave();
           statusActions.setQuotaExhausted(false);
         }
-        const outcome = await performSave(snapshot, options.silent ?? false);
+        const outcome = await performSave(
+          snapshot,
+          options.silent ?? false,
+          options.asNewVersion ?? false
+        );
         recordSaveOutcome(outcome, {
           open: isOpen(),
           baseline: {
@@ -7824,6 +8100,7 @@ function AdapterPort({
   const onConnect = useFlowStore((s) => s.actions.edges.onConnect);
   const [pickerOpen, setPickerOpen] = useState(false);
   const candidates = useCompatibleSubNodes(adapter);
+  const readOnly = useBuilderReadOnly();
   const connectionCount = edges.filter(
     (e) => e.source === nodeId && e.sourceHandle === adapter.name
   ).length;
@@ -7877,7 +8154,7 @@ function AdapterPort({
           adapter?.required && /* @__PURE__ */ jsx("span", { className: "text-[var(--color-status-error-text)] absolute -right-2 top-[1px]", children: "*" })
         ] }) }),
         /* @__PURE__ */ jsxs("div", { className: "mt-16 flex flex-col items-center gap-1.5", children: [
-          !isAtMaxConnections && /* @__PURE__ */ jsx(
+          !isAtMaxConnections && !readOnly && /* @__PURE__ */ jsx(
             "button",
             {
               type: "button",
@@ -8008,6 +8285,7 @@ function SubNodeComponent({
 }) {
   const meta = useMemo(() => getNodeDetail(nodeType), [nodeType]);
   const deleteNode = useDeleteNode();
+  const readOnly = useBuilderReadOnly();
   const [showNodePropertiesOf] = useFlowStore(
     useShallow((s) => [s.actions.sidebar.showNodePropertiesOf])
   );
@@ -8053,7 +8331,7 @@ function SubNodeComponent({
         }
       ),
       /* @__PURE__ */ jsx("span", { className: "mt-1.5 text-xs text-[var(--color-text-secondary)] font-medium text-center max-w-24 leading-tight", children: data?.label || data?.args?.state?.operation || meta.title }),
-      /* @__PURE__ */ jsx(
+      !readOnly && /* @__PURE__ */ jsx(
         "button",
         {
           onClick: () => deleteNode(id),
@@ -8125,8 +8403,9 @@ var getNodeMetadata = (value) => {
         s.actions.nodes.endRename
       ])
     );
+    const readOnly = useBuilderReadOnly();
     useEffect(() => {
-      if (nodeType !== "integration/channel") return;
+      if (readOnly || nodeType !== "integration/channel") return;
       const nodeData = data;
       const explicitRole = nodeData?.args?.state?.role;
       const hasIncomingEdge = edges.some((e) => e.target === id);
@@ -8153,7 +8432,7 @@ var getNodeMetadata = (value) => {
         zustandSetNodes(updated);
         return updated;
       });
-    }, [nodeType, id, edges, data, setNodes, zustandSetNodes]);
+    }, [readOnly, nodeType, id, edges, data, setNodes, zustandSetNodes]);
     const { executeStep } = useNodeExecution();
     const deleteNode = useDeleteNode();
     const handleDeleteNode = () => {
@@ -8311,12 +8590,12 @@ var getNodeMetadata = (value) => {
             onDoubleClick: handleOpenNdv,
             onSettings: handleOpenNdv,
             onExecute: handleExecuteStep,
-            onDelete: handleDeleteNode,
+            onDelete: readOnly ? void 0 : handleDeleteNode,
             infoButton: /* @__PURE__ */ jsx(NodeInfoButtonWithModal, { metadata: nodeInfoMetadata }),
             disabled: isDisabled,
-            onToggleDisabled: handleToggleDisabled,
-            isRenaming: isRenamingThisNode,
-            onStartRename: handleStartRename,
+            onToggleDisabled: readOnly ? void 0 : handleToggleDisabled,
+            isRenaming: isRenamingThisNode && !readOnly,
+            onStartRename: readOnly ? void 0 : handleStartRename,
             onCommitRename: handleCommitRename,
             onCancelRename: handleCancelRename
           }
@@ -8345,10 +8624,10 @@ var getNodeMetadata = (value) => {
           isExecuting: isThisNodeExecuting,
           onSettings: handleOpenNdv,
           onExecute: handleExecuteStep,
-          onDelete: handleDeleteNode,
+          onDelete: readOnly ? void 0 : handleDeleteNode,
           infoButton: /* @__PURE__ */ jsx(NodeInfoButtonWithModal, { metadata: nodeInfoMetadata }),
           disabled: isDisabled,
-          onToggleDisabled: handleToggleDisabled,
+          onToggleDisabled: readOnly ? void 0 : handleToggleDisabled,
           children: [
             /* @__PURE__ */ jsx(
               NodeCardHeader,
@@ -8358,8 +8637,8 @@ var getNodeMetadata = (value) => {
                 accentKey: value?.type || meta.title,
                 missingCredentials,
                 label: nodeLabel,
-                isRenaming: isRenamingThisNode,
-                onStartRename: handleStartRename,
+                isRenaming: isRenamingThisNode && !readOnly,
+                onStartRename: readOnly ? void 0 : handleStartRename,
                 onCommitRename: handleCommitRename,
                 onCancelRename: handleCancelRename
               }
@@ -9569,4 +9848,4 @@ function useNodeExecution() {
   };
 }
 
-export { ALLOW_ALL_PERMISSIONS, AUTOSAVE_DEBOUNCE_MS, AUTOSAVE_RETRY_DELAYS_MS, AVAILABLE_NODES, BILLING_PLANS_PATH, CODE_WORKFLOW_NODE_TYPE, ConnectionFormDialog, ConnectionSelector, DURABLE_FUNCTION_NODE_TYPES, ExpressionEditor, FLUIDGRIDS_FLAGS, FLUIDGRIDS_FLAG_DEFAULTS, FLUIDGRIDS_PERMISSIONS, FluidGridsContext, FluidGridsPermissionsProvider, FluidGridsProvider, NODES, NODES_METADATA, NODE_CONFIGS, NODE_OPERATION_DRAG_DATA_FORMAT, NODE_TYPES, NODE_TYPE_DRAG_DATA_FORMAT, NodePropertyPanel, NodeTypeIcon, RUNS_QUOTA_NAME, STICKY_NOTE_TYPE, SdkPermissionButton, SdkPermissionGate, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, WORKFLOWS_QUOTA_NAME, blankWorkflowCreateInput, buildOperationSeed, buildStickyNode, canAutosave, canRenderOperationPanel, canSignalRun, changedSourceFiles, childRunIdOf, classifyCreateRefusal, clearCodeWorkflowDefinitionCache, codeBuildIdOf, components_default, createConfiguredNode, createThenOpen, declaredOutputFields, declaredSignals, defaultSourcePath, describeOperationError, diagnosticsByPath, editStateOf, emitNodeInstalled, emitRunFailed, emitRunLimitHit, emitRunStarted, emitTemplateUsed, emitUpgradeClicked, emitWorkflowCreated, emitWorkflowLimitHit, emitWorkflowPublished, ensureNodeConfigsLoaded, evaluatePermissionCheck, fieldsFromIO, fieldsFromValue, filterPaletteNodes, findQuotaRefusal, formatParameterValue, getNodeDetail, getNodeMetadata, inAppLeaveTarget, interfaceFields, interfaceHandlers, isDurableFunctionNodeType, isEditableSourcePath, isForbiddenError, isImageIcon, isNodeConfigsInitialized, isNodeTrigger, isNodeTypeHiddenFromPalette, isParamVisible, isQuotaExhaustedFailure, isTriggerOperation, leaveNeedsConfirmation, listCustomBlocks, liveInternalOperations, mergeStickyNotes, nodeAccent, nodesOf, onNodeTypesUpdate, openRunQuotaUpgradePrompt, parseParameterValue, parseRawSignalPayload, pathToExpression, payloadFromCardValues, projectLanguage, readCodeWorkflowState, readDisplayOptions, refetchStoreNodes, registerCustomBlock, registerWorkflowNodeTypes, resolveInputHandles, resolveNodeOperation, resolveOperationName, resolveOutputHandles, resolveUiSpec, runPreparationOf, runSignalTargets, runTriggerFromMode, saveIndicatorOf, savesInPlace, signalPayloadCard, snapshotForSave, sourceLanguageOf, stripSubmitActions, structuredParameterType, subscribeWorkflowSaved, synchronizeOperationUpdate, throwIfResultError, toCodeMirrorDiagnostics, useAgentDefinitionList, useAgentDefinitions, useCodeWorkflowInterface, useConnection, useConnections, useConnectionsByProvider, useCreateConnection, useDurableFunctionNodesEnabled, useFlowStore, useFluidGridsAnalytics, useFluidGridsContext, useFluidGridsFlag, useFluidGridsPermission, useInitiateOAuth, useInsertNode, useIsValidConnection, useNodeExecution, useNodeRegistryRevision, useProviders, useSaveStatusStore, useSaveWorkflow, workflowFingerprint };
+export { ALLOW_ALL_PERMISSIONS, AUTOSAVE_DEBOUNCE_MS, AUTOSAVE_RETRY_DELAYS_MS, AVAILABLE_NODES, BILLING_PLANS_PATH, BuilderReadOnlyProvider, CODE_WORKFLOW_NODE_TYPE, ConnectionFormDialog, ConnectionSelector, DURABLE_FUNCTION_NODE_TYPES, EDIT_SESSION_ID, ExpressionEditor, FLUIDGRIDS_FLAGS, FLUIDGRIDS_FLAG_DEFAULTS, FLUIDGRIDS_PERMISSIONS, FluidGridsContext, FluidGridsPermissionsProvider, FluidGridsProvider, NODES, NODES_METADATA, NODE_CONFIGS, NODE_OPERATION_DRAG_DATA_FORMAT, NODE_TYPES, NODE_TYPE_DRAG_DATA_FORMAT, NodePropertyPanel, NodeTypeIcon, RUNS_QUOTA_NAME, STICKY_NOTE_TYPE, SdkPermissionButton, SdkPermissionGate, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, WORKFLOWS_QUOTA_NAME, bannerOf, blankWorkflowCreateInput, buildOperationSeed, buildStickyNode, canAutosave, canRenderOperationPanel, canSignalRun, changedSourceFiles, childRunIdOf, classifyCreateRefusal, clearCodeWorkflowDefinitionCache, codeBuildIdOf, components_default, createConfiguredNode, createThenOpen, declaredOutputFields, declaredSignals, defaultSourcePath, describeOperationError, diagnosticsByPath, editStateOf, emitNodeInstalled, emitRunFailed, emitRunLimitHit, emitRunStarted, emitTemplateUsed, emitUpgradeClicked, emitWorkflowCreated, emitWorkflowLimitHit, emitWorkflowPublished, ensureNodeConfigsLoaded, evaluatePermissionCheck, fieldsFromIO, fieldsFromValue, filterPaletteNodes, findQuotaRefusal, findSaveConflict, forgetSessionForReload, formatParameterValue, getNodeDetail, getNodeMetadata, inAppLeaveTarget, interfaceFields, interfaceHandlers, isDurableFunctionNodeType, isEditableSourcePath, isForbiddenError, isImageIcon, isLocked, isNodeConfigsInitialized, isNodeTrigger, isNodeTypeHiddenFromPalette, isParamVisible, isQuotaExhaustedFailure, isTriggerOperation, leaseCallQueue, leaveNeedsConfirmation, listCustomBlocks, liveInternalOperations, loadDefinitionJson, mergeStickyNotes, nodeAccent, nodesOf, onNodeTypesUpdate, openRunQuotaUpgradePrompt, parseParameterValue, parseRawSignalPayload, pathToExpression, payloadFromCardValues, phaseAfterAcquire, phaseAfterTakeOver, projectLanguage, readCodeWorkflowState, readDisplayOptions, refetchStoreNodes, registerCustomBlock, registerWorkflowNodeTypes, releasesOnClose, rememberOwnStatusChange, rememberRevision, rememberSessionForReload, resolveInputHandles, resolveNodeOperation, resolveOperationName, resolveOutputHandles, resolveUiSpec, runPreparationOf, runSignalTargets, runTriggerFromMode, saveIndicatorOf, savesInPlace, sessionBeforeReload, shouldReleaseForIdle, signalPayloadCard, snapshotForSave, sourceLanguageOf, stripSubmitActions, structuredParameterType, subscribeWorkflowSaved, synchronizeOperationUpdate, throwIfResultError, tickAction, toCodeMirrorDiagnostics, useAgentDefinitionList, useAgentDefinitions, useBuilderReadOnly, useCodeWorkflowInterface, useConnection, useConnections, useConnectionsByProvider, useCreateConnection, useDurableFunctionNodesEnabled, useDurableParityEnabled, useEditLeaseLocked, useEditLeaseStore, useFlowStore, useFluidGridsAnalytics, useFluidGridsContext, useFluidGridsFlag, useFluidGridsPermission, useInitiateOAuth, useInsertNode, useIsValidConnection, useNodeExecution, useNodeRegistryRevision, useProviders, useSaveStatusStore, useSaveWorkflow, workflowFingerprint };