@burdenoff/fluidgrids-fe-sdk 2026.1112.1 → 2026.1112.2

package/dist/{agentTools-CvPvDlPV.js → agentTools-EVdEThES.js}

@@ -1,8 +1,8 @@
 "use client";
-import { B as createConfiguredNode, Nt as useSaveStatusStore, Q as selectedOperationOf, R as SENSITIVE_PARAM, Y as nodeTitle, Z as paramsFromOperation, _ as registryNodeData, f as isNodeConfigsInitialized, gt as autosaveAllowedFor, o as NODE_CONFIGS, q as fixedParameterState, wt as isFlowComplete } from "./FluidGridsProvider-BuZERrTA.js";
-import { E as resolveOutputHandles, H as useFlowStore, T as resolveInputHandles } from "./node-operation-selection--oy-yEq_.js";
-import { j as isNodeTypeHiddenFromPalette } from "./TemplateCard-D800haiE.js";
-import { g as computeAttachPosition } from "./flow-builder-CDIUMBSO.js";
+import { B as createConfiguredNode, Nt as useSaveStatusStore, Q as selectedOperationOf, R as SENSITIVE_PARAM, Y as nodeTitle, Z as paramsFromOperation, _ as registryNodeData, f as isNodeConfigsInitialized, gt as autosaveAllowedFor, o as NODE_CONFIGS, q as fixedParameterState, wt as isFlowComplete } from "./FluidGridsProvider-BFfTxl9m.js";
+import { E as resolveOutputHandles, H as useFlowStore, T as resolveInputHandles } from "./node-operation-selection-icAhaNza.js";
+import { j as isNodeTypeHiddenFromPalette } from "./TemplateCard-DYDVNYo6.js";
+import { g as computeAttachPosition } from "./flow-builder-Dn4PCWuf.js";
 import { AgentToolError, defineAgentTool } from "@burdenoff/fe-libs/shared/agent-tools";
 import { z } from "zod";
 

package/dist/{canvasNoteTools-OaF81_4T.js → canvasNoteTools-C5Vf0pxu.js}

@@ -1,8 +1,8 @@
 "use client";
 import { n as useAgentMarksStore, r as toPlainText } from "./marksStore-DGCXjTmZ.js";
-import { Q as selectedOperationOf, Y as nodeTitle, Z as paramsFromOperation } from "./FluidGridsProvider-BuZERrTA.js";
-import { H as useFlowStore } from "./node-operation-selection--oy-yEq_.js";
-import { p as notesKeyOf } from "./flow-builder-CDIUMBSO.js";
+import { Q as selectedOperationOf, Y as nodeTitle, Z as paramsFromOperation } from "./FluidGridsProvider-BFfTxl9m.js";
+import { H as useFlowStore } from "./node-operation-selection-icAhaNza.js";
+import { p as notesKeyOf } from "./flow-builder-Dn4PCWuf.js";
 import { AgentToolError, defineAgentTool } from "@burdenoff/fe-libs/shared/agent-tools";
 import { z } from "zod";
 

package/dist/{code-editor-field-Dg2U8mk1.js → code-editor-field-o7qp9eTq.js}

@@ -1,7 +1,7 @@
 "use client";
 import { t as __exportAll } from "./rolldown-runtime-hDbaFkMy.js";
-import { g as toCodeMirrorDiagnostics } from "./node-operation-selection--oy-yEq_.js";
-import { Bn as useBuilderReadOnly } from "./FluidGridsProvider-BuZERrTA.js";
+import { g as toCodeMirrorDiagnostics } from "./node-operation-selection-icAhaNza.js";
+import { Hn as useBuilderReadOnly } from "./FluidGridsProvider-BFfTxl9m.js";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { cn } from "@burdenoff/fe-libs/utils";
 import { jsx } from "react/jsx-runtime";

package/dist/{definition-canvas--3MPHoP-.js → definition-canvas-F8DGty5m.js}

@@ -1,5 +1,5 @@
 "use client";
-import { F as mergeStickyNotes } from "./node-operation-selection--oy-yEq_.js";
+import { F as mergeStickyNotes } from "./node-operation-selection-icAhaNza.js";
 
 // src/builder/live/definition-canvas.ts
 function isRecord(value) {

package/dist/executions.js

@@ -1,5 +1,5 @@
 "use client";
-import { t as ExecutionsListPage } from "./ExecutionsListPage-DeqJnEO7.js";
-import { t as ExecutionDetailPage } from "./ExecutionDetailPage-Dtpn7Xnl.js";
+import { t as ExecutionsListPage } from "./ExecutionsListPage-BgeqwVr2.js";
+import { t as ExecutionDetailPage } from "./ExecutionDetailPage-Cw4zyaIG.js";
 
 export { ExecutionDetailPage, ExecutionsListPage };

package/dist/{flow-builder-CDIUMBSO.js → flow-builder-Dn4PCWuf.js}

@@ -1,10 +1,10 @@
 "use client";
-import { B as NODE_TYPE_DRAG_DATA_FORMAT, G as isTriggerOperation, H as useFlowStore, M as isImageIcon, T as resolveInputHandles, U as useIsValidConnection, V as STICKY_NOTE_TYPE, j as NodeTypeIcon, r as CODE_WORKFLOW_NODE_TYPE, z as NODE_OPERATION_DRAG_DATA_FORMAT } from "./node-operation-selection--oy-yEq_.js";
-import { $t as canAutosave, Bn as useBuilderReadOnly, Bt as phaseAfterAcquire, Ct as watchLeavingLosesChanges, D as InstallWorkflowNodeDocument, E as InstallPurchasedNodeDocument, Et as useSaveWorkflow, F as getNodeMetadata, Fn as getNodeDetail, Ft as useEditLeaseStore, Gt as EDIT_SESSION_ID, H as MissingParametersDialog, Ht as releasesOnClose, In as buildStickyNode, It as bannerOf, Jt as sessionBeforeReload, Kt as forgetSessionForReload, Ln as loadMarkdown, Lt as isLocked, M as UninstallOrganizationPrivateNodeDocument, Mt as saveIndicatorOf, N as UninstallWorkflowNodeDocument, Nt as useSaveStatusStore, Pt as useEditLeaseLocked, Qt as AUTOSAVE_RETRY_DELAYS_MS, Rn as useMarkdownRenderer, Rt as leaseCallQueue, S as CreateStoreOrderDocument, St as touchesSavedFields, T as InstallOrganizationPrivateNodeDocument, Tt as useFlowValidator, U as useRunGuard, Ut as shouldReleaseForIdle, V as useInsertNode, Vt as phaseAfterTakeOver, W as workflowParameterIssues, Wt as tickAction, Xt as rememberRevision, Yt as rememberOwnStatusChange, Zt as AUTOSAVE_DEBOUNCE_MS, _t as departingSave, a as NODES_METADATA, an as workflowFingerprint, b as BrowseWorkflowNodesDocument, bt as leavingLosesChanges, f as isNodeConfigsInitialized, g as registerWorkflowNodeTypes, gt as autosaveAllowedFor, ht as useManualSave, i as AVAILABLE_NODES, in as saveFailureActionOf, jt as refusalOfQuota, k as OrganizationPrivateNodesDocument, l as ensureNodeConfigsLoaded, m as refetchStoreNodes, mt as useGuardedNavigate, nn as inAppLeaveTarget, o as NODE_CONFIGS, on as useNodeExecution, p as onNodeTypesUpdate, qt as rememberSessionForReload, rn as resettledBaseline, s as NODE_TYPES, t as FluidGridsContext, v as scheduleNodePaletteLoad, vn as useCanvasEdges, vt as editStateFor, w as GetNodeInstallableVersionsDocument, wt as isFlowComplete, xn as loadDefinitionJson, xt as savedEverythingBeforeLeaving, yn as useNodeRegistryRevision, yt as editingLeaseLocked, z as buildOperationSeed, zn as BuilderReadOnlyProvider, zt as leaseCallSequence } from "./FluidGridsProvider-BuZERrTA.js";
+import { B as NODE_TYPE_DRAG_DATA_FORMAT, G as isTriggerOperation, H as useFlowStore, M as isImageIcon, T as resolveInputHandles, U as useIsValidConnection, V as STICKY_NOTE_TYPE, j as NodeTypeIcon, r as CODE_WORKFLOW_NODE_TYPE, z as NODE_OPERATION_DRAG_DATA_FORMAT } from "./node-operation-selection-icAhaNza.js";
+import { $t as AUTOSAVE_DEBOUNCE_MS, Bn as useMarkdownRenderer, Bt as leaseCallSequence, Cn as loadDefinitionJson, Ct as watchLeavingLosesChanges, D as InstallWorkflowNodeDocument, E as InstallPurchasedNodeDocument, Et as useSaveWorkflow, F as getNodeMetadata, Ft as useEditLeaseLocked, Gt as tickAction, H as MissingParametersDialog, Hn as useBuilderReadOnly, Ht as phaseAfterTakeOver, It as useEditLeaseStore, Jt as rememberSessionForReload, Kt as EDIT_SESSION_ID, Ln as getNodeDetail, Lt as bannerOf, M as UninstallOrganizationPrivateNodeDocument, Mt as saveIndicatorOf, N as UninstallWorkflowNodeDocument, Nt as useSaveStatusStore, Pt as workflowSaveQueue, Qt as revisionOf, Rn as buildStickyNode, Rt as isLocked, S as CreateStoreOrderDocument, St as touchesSavedFields, T as InstallOrganizationPrivateNodeDocument, Tt as useFlowValidator, U as useRunGuard, Ut as releasesOnClose, V as useInsertNode, Vn as BuilderReadOnlyProvider, Vt as phaseAfterAcquire, W as workflowParameterIssues, Wt as shouldReleaseForIdle, Xt as rememberOwnStatusChange, Yt as sessionBeforeReload, Zt as rememberRevision, _t as departingSave, a as NODES_METADATA, an as resettledBaseline, b as BrowseWorkflowNodesDocument, bn as useCanvasEdges, bt as leavingLosesChanges, cn as useNodeExecution, en as AUTOSAVE_RETRY_DELAYS_MS, f as isNodeConfigsInitialized, g as registerWorkflowNodeTypes, gt as autosaveAllowedFor, ht as useManualSave, i as AVAILABLE_NODES, in as inAppLeaveTarget, jt as refusalOfQuota, k as OrganizationPrivateNodesDocument, l as ensureNodeConfigsLoaded, m as refetchStoreNodes, mt as useGuardedNavigate, o as NODE_CONFIGS, on as saveFailureActionOf, p as onNodeTypesUpdate, qt as forgetSessionForReload, s as NODE_TYPES, sn as workflowFingerprint, t as FluidGridsContext, tn as canAutosave, v as scheduleNodePaletteLoad, vt as editStateFor, w as GetNodeInstallableVersionsDocument, wt as isFlowComplete, xn as useNodeRegistryRevision, xt as savedEverythingBeforeLeaving, yt as editingLeaseLocked, z as buildOperationSeed, zn as loadMarkdown, zt as leaseCallQueue } from "./FluidGridsProvider-BFfTxl9m.js";
 import { r as useTr } from "./TranslationBridge-Da-TPgQm.js";
 import { n as preloadableLazy } from "./preloadable-lazy-Pp47mqQ9.js";
 import { a as DialogFooter$1, d as Input$1, i as DialogDescription$1, l as DialogTitle$1, o as DialogHeader$1, r as DialogContent$1, t as Dialog$1 } from "./dialog-Cjb4lB4D.js";
-import { _ as storeNodeInstallVersion, a as useTemplateImportFlow, d as filterStoreNodesForPalette, f as getStoreNodeAvailability, g as storeNodeDisplayVersion, h as isStoreNodeUpdateAvailable, k as filterPaletteNodes, m as getStoreNodeType, p as getStoreNodeIcon, t as TemplateCard, u as useWorkflowTemplates, v as useInstalledNodes, y as useGlobalStoreClient } from "./TemplateCard-D800haiE.js";
+import { _ as storeNodeInstallVersion, a as useTemplateImportFlow, d as filterStoreNodesForPalette, f as getStoreNodeAvailability, g as storeNodeDisplayVersion, h as isStoreNodeUpdateAvailable, k as filterPaletteNodes, m as getStoreNodeType, p as getStoreNodeIcon, t as TemplateCard, u as useWorkflowTemplates, v as useInstalledNodes, y as useGlobalStoreClient } from "./TemplateCard-DYDVNYo6.js";
 import { _ as throwIfResultError, d as emitFluidGridsEvent, m as describeOperationError, n as getFluidGridsClient, s as waitForFluidGridsClient, x as getFluidGridsConfig } from "./client-C9XSzSXr.js";
 import { c as useDurableParityEnabled, d as usePaletteGates, l as useFluidGridsFlag, m as useWorkflowTestsEnabled, s as useDurableFunctionNodesEnabled, t as FLUIDGRIDS_FLAGS } from "./feature-flags-DM5myWaD.js";
 import { t as Button$2 } from "./button-DG7y_FVJ.js";
@@ -12,14 +12,14 @@ import { t as PublishCustomNodeAction } from "./PublishCustomNodeAction-5XXnSA3H
 import { o as emitUpgradeClicked, t as emitNodeInstalled } from "./fluidgridsEvents-Dm5CaHtr.js";
 import { $t as RemoveNodeFromWorkflowsDocument, Br as WorkflowGitPushesDocument, Ci as WorkflowVersioningDocument, Ft as NodeUsageStatusDocument, Gr as WorkflowPromotionRequestsDocument, Hn as TakeOverWorkflowEditLeaseDocument, Lr as WorkflowGenerationTemplatesDocument, Mn as SetWorkflowRolloutDocument, Mr as WorkflowEditLeaseDocument, Nt as NodeSchemaIntrospectionDocument, Or as WorkflowDefinitionDocument, Pr as WorkflowEnvironmentsDocument, Q as DeployWorkflowVersionToDevDocument, Qt as ReleaseWorkflowEditLeaseDocument, Rr as WorkflowGitCommitsDocument, S as CancelWorkflowPromotionDocument, Si as WorkflowVersionDrainageDocument, Vr as WorkflowGitRepositoryDocument, Xt as RejectWorkflowPromotionDocument, Y as DeleteWorkflowRolloutDocument, Zn as UnlinkWorkflowGitRepositoryDocument, br as WorkflowAuthoringDocument, l as ApproveWorkflowPromotionDocument, lr as UpdateWorkflowEnvironmentPolicyDocument, qt as PushWorkflowToGitDocument, r as ActivateWorkflowVersionCheckedDocument, rn as RequestWorkflowPromotionDocument, sn as RestoreWorkflowFromGitDocument, t as AcquireWorkflowEditLeaseDocument, wt as LinkWorkflowGitRepositoryDocument, zr as WorkflowGitDiffDocument } from "./graphql-operation-types-BdU65FNm.js";
 import { n as useAgentMarksStore } from "./marksStore-DGCXjTmZ.js";
-import { T as CreateWorkflowRefusalDialog, _ as lineOfNode, f as fileBaseName, g as isLossyFidelityItem, h as isLosslessReport, r as useWorkflowCodeExport, t as downloadWorkflowCodeExport, v as orderedExportFiles, x as sortFidelityItems } from "./useWorkflowCodeExport-L-5NIRiH.js";
+import { A as CreateWorkflowRefusalDialog, C as orderedExportFiles, E as sortFidelityItems, S as lineOfNode, _ as fileBaseName, b as isLosslessReport, c as saveWorkflowDescription, l as visibleWorkflowDescription, o as commitWorkflowDescription, r as useWorkflowCodeExport, s as normalizeWorkflowDescription, t as downloadWorkflowCodeExport, u as workflowDescriptionCharactersLeft, x as isLossyFidelityItem } from "./useWorkflowCodeExport-CV3SZeKm.js";
 import { r as RUNS_QUOTA_NAME, t as BILLING_PLANS_PATH } from "./quota-Cdt8yz7N.js";
 import { t as EntityTagPicker } from "./EntityTagPicker-Dk3CufFt.js";
 import { t as FluidGridsDocsLink } from "./FluidGridsDocsLink-JxkBpOeb.js";
 import { n as runsQuotaLevel, t as readRunsQuota } from "./runsQuota-DvXR6mRN.js";
 import { a as SdkPermissionGate, i as SdkPermissionButton, s as useFluidGridsPermission, t as FLUIDGRIDS_PERMISSIONS } from "./constants-B2lhWNoN.js";
-import { a as useDeactivateWorkflow, d as useRestoreWorkflowVersion, o as useDeleteWorkflow, t as useActivateWorkflow, v as useWorkflowVersions } from "./useWorkflows-D9BlhpWH.js";
-import { n as VersionLifecycleBar, r as countLifecycle, t as VersionDiffDialog } from "./VersionDiffDialog-B00qeGiE.js";
+import { a as useDeactivateWorkflow, d as useRestoreWorkflowVersion, o as useDeleteWorkflow, t as useActivateWorkflow, v as useWorkflowVersions } from "./useWorkflows-CVb5zXKt.js";
+import { n as VersionLifecycleBar, r as countLifecycle, t as VersionDiffDialog } from "./VersionDiffDialog-Cp2doV3f.js";
 import { $P as VersioningBehavior, Eu as DrainageStatus, MI as WorkflowTestExpectedStatus, jo as CodeReplaceStatus, nI as WorkflowEnvironment, rI as WorkflowExportFormat } from "./graphql-types-v6CTGwA0.js";
 import { n as useConnections } from "./useConnections-Cs7LCWEM.js";
 import { t as buildNodeDisplayMap } from "./run-display-BycKYSU0.js";
@@ -40,7 +40,7 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { toast } from "sonner";
 import { edgeColor, nodeCategoryColor } from "@burdenoff/fe-libs/shared/utils";
 import { shallow, useShallow } from "zustand/shallow";
-import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, Badge, Button, Card, CardContent, CardDescription, CardHeader, CardTitle, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, Input, Label, Popover, PopoverContent, PopoverTrigger, ScrollArea, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Sheet, SheetContent, SheetDescription, SheetHeader, SheetTitle, SheetTrigger, Switch, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toaster as Toaster$1, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@burdenoff/fe-libs/ui";
+import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, Badge, Button, Card, CardContent, CardDescription, CardHeader, CardTitle, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, Input, Label, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, ScrollArea, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Sheet, SheetContent, SheetDescription, SheetHeader, SheetTitle, SheetTrigger, Switch, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toaster as Toaster$1, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@burdenoff/fe-libs/ui";
 import { useEventBus } from "@burdenoff/fe-libs/shared/events";
 import { Button as Button$1 } from "@burdenoff/fe-libs/button";
 import { ThemeProvider } from "@burdenoff/fe-libs/shared/providers/shell";
@@ -260,9 +260,9 @@ function IntroductionPropertyPanel() {
 * waiting for its chunk and React's Suspense throttle (about 0.5 s on first
 * open even with the chunk cached).
 */
-const NodeDetailViewOverlay = preloadableLazy(() => import("./node-detail-view-nirlvqEK.js").then((m) => m.NodeDetailView), "NodeDetailView");
-const QuickConfigPanelOverlay = preloadableLazy(() => import("./quick-config-panel-B-zC__4A.js").then((m) => m.QuickConfigPanel), "QuickConfigPanel");
-const SidebarNodeEditorOverlay = preloadableLazy(() => import("./sidebar-node-editor-C9drL1rk.js").then((m) => m.SidebarNodeEditor), "SidebarNodeEditor");
+const NodeDetailViewOverlay = preloadableLazy(() => import("./node-detail-view-kWiwJEKr.js").then((m) => m.NodeDetailView), "NodeDetailView");
+const QuickConfigPanelOverlay = preloadableLazy(() => import("./quick-config-panel-C84vsDYD.js").then((m) => m.QuickConfigPanel), "QuickConfigPanel");
+const SidebarNodeEditorOverlay = preloadableLazy(() => import("./sidebar-node-editor-D-2lPHwq.js").then((m) => m.SidebarNodeEditor), "SidebarNodeEditor");
 const WorkflowShareDialogOverlay = preloadableLazy(() => import("./WorkflowShareDialog-Dv46nAyh.js").then((n) => n.n).then((m) => m.WorkflowShareDialog), "WorkflowShareDialog");
 const ConnectionFormDialogOverlay = preloadableLazy(() => import("./ConnectionFormDialog-Bg9_OdHX.js").then((n) => n.n).then((m) => m.ConnectionFormDialog), "ConnectionFormDialog");
 /**
@@ -2624,7 +2624,7 @@ function TemplatesGrid({ templates, loading, hasMore, onLoadMore, onTemplateClic
 }
 
 // src/builder/components/flow-builder/components/templates/TemplatesModal.tsx
-const LazyTemplateDetailPanel = lazy(() => import("./TemplateDetailPanel-CKhCQlyo.js").then((m) => ({ default: m.TemplateDetailPanel })));
+const LazyTemplateDetailPanel = lazy(() => import("./TemplateDetailPanel-s4EqQhra.js").then((m) => ({ default: m.TemplateDetailPanel })));
 /**
 * Modal for browsing and selecting workflow templates
 * Features:
@@ -16495,7 +16495,7 @@ function FidelityReportList({ fidelity, source, hasNode, onShowNode }) {
 * Behind the `fluidgrids.code-first` flag (default off); with the flag off
 * the panel renders nothing and the header is exactly as before.
 */
-const LazyCodeEditorField = lazy(() => import("./code-editor-field-Dg2U8mk1.js").then((n) => n.n).then((m) => ({ default: m.CodeEditorField })));
+const LazyCodeEditorField = lazy(() => import("./code-editor-field-o7qp9eTq.js").then((n) => n.n).then((m) => ({ default: m.CodeEditorField })));
 /** Read-only lifted-code editor with a sized placeholder while its chunk loads. */
 function CodeViewEditor({ content, path, label }) {
 	return /* @__PURE__ */ jsx(Suspense, {
@@ -16798,11 +16798,185 @@ function ShareWorkflowButton({ compact = false, className }) {
 	});
 }
 
+// src/builder/lib/workflow-description-save.ts
+/**
+* Saving the open workflow's description from the builder header (BOFF-9743).
+*
+* The description is written on its own, in place, through
+* `updateWorkflowDefinition`; the canvas save never writes it. The store shows
+* the new text at once and gets the old one back when the service refuses.
+*
+* A description change raises the version's revision (BOFF-9725), so the save
+* goes through the editor's save queue, never alongside a canvas save that
+* carries the same revision, and sends that revision itself. Its answer is the
+* page's new revision: without it the person's next canvas save would be
+* refused as stale over their own edit.
+*/
+/** Numbers each save, so the queue never folds one description save into another. */
+let saveSequence = 0;
+/**
+* Save `description` on the open version. Resolves (never rejects) with what
+* happened; a refusal carries the service's message for the caller's toast.
+*/
+async function saveOpenWorkflowDescription(description) {
+	const flow = useFlowStore.getState();
+	const dbId = flow.workflow.dbId;
+	if (!dbId) return {
+		saved: false,
+		message: "Save the workflow first"
+	};
+	const generation = flow.loadGeneration;
+	const previous = flow.workflow.description ?? "";
+	const next = normalizeWorkflowDescription(description);
+	const { setWorkflow } = flow.actions;
+	const showsThisSave = () => {
+		const state = useFlowStore.getState();
+		return state.loadGeneration === generation && state.workflow.dbId === dbId && (state.workflow.description ?? "") === next;
+	};
+	setWorkflow({ description: next });
+	let result = {
+		saved: false,
+		message: "The description was not saved"
+	};
+	await workflowSaveQueue.run(async () => {
+		const expectedRevision = revisionOf(dbId);
+		try {
+			const saved = await saveWorkflowDescription(getFluidGridsClient(), dbId, next, {
+				expectedRevision,
+				editSessionId: EDIT_SESSION_ID
+			});
+			if (expectedRevision !== void 0) rememberRevision(saved.id, saved.revision);
+			else rememberOwnStatusChange(saved.id, saved.revision);
+			if (showsThisSave() && saved.description !== next) setWorkflow({ description: saved.description });
+			result = {
+				saved: true,
+				description: saved.description
+			};
+			return true;
+		} catch (error) {
+			if (showsThisSave()) setWorkflow({ description: previous });
+			result = {
+				saved: false,
+				message: describeOperationError(error)
+			};
+			return false;
+		}
+	}, `description:${++saveSequence}`);
+	return result;
+}
+
+// src/builder/components/flow-builder/components/ui/workflow-description-field.tsx
+/**
+* The workflow's description in the builder header (BOFF-9743), n8n-style:
+* the text itself is the edit affordance. Clicking it opens a small editor;
+* Ctrl/Cmd+Enter or leaving the editor saves, Escape cancels.
+*
+* The header only renders while this page may change the workflow (not a
+* read-only view, and not while someone else holds the edit lease, BOFF-9725);
+* without the update permission the description is shown, not offered for
+* editing. The service still refuses a save it does not allow (a viewer of a
+* shared workflow, BOFF-9726), and the old text comes back with a toast.
+*/
+function WorkflowDescriptionField({ className }) {
+	const tr = useTr();
+	const [description, name, dbId] = useFlowStore(useShallow((s) => [
+		s.workflow.description,
+		s.workflow.name,
+		s.workflow.dbId
+	]));
+	const { allowed: canEdit } = useFluidGridsPermission(FLUIDGRIDS_PERMISSIONS.WORKFLOW_UPDATE);
+	const [draft, setDraftState] = useState(null);
+	const draftRef = useRef(null);
+	const setDraft = (next) => {
+		draftRef.current = next;
+		setDraftState(next);
+	};
+	const shown = visibleWorkflowDescription(description, name);
+	if (!dbId) return null;
+	if (!canEdit) {
+		if (!shown) return null;
+		return /* @__PURE__ */ jsx("span", {
+			"data-testid": "fluidgrids-workflow-description",
+			title: shown,
+			className: cn("min-w-0 shrink-[6] truncate text-xs text-muted-foreground", className),
+			children: shown
+		});
+	}
+	const editing = draft !== null;
+	const commit = () => {
+		const current = draftRef.current;
+		if (current === null) return;
+		const decision = commitWorkflowDescription(shown, current);
+		setDraft(null);
+		if (decision.kind !== "save") return;
+		saveOpenWorkflowDescription(decision.description).then((result) => {
+			if (result.saved) return;
+			toast.error(tr("fluidgrids.builder.workflowDescription.saveFailed", "The description couldn't be saved"), { description: result.message });
+		});
+	};
+	const placeholder = tr("fluidgrids.builder.workflowDescription.add", "Add description");
+	const left = editing ? workflowDescriptionCharactersLeft(draft) : 0;
+	return /* @__PURE__ */ jsxs(Popover, {
+		open: editing,
+		onOpenChange: (open) => {
+			if (!open) commit();
+		},
+		children: [/* @__PURE__ */ jsx(PopoverAnchor, {
+			asChild: true,
+			children: /* @__PURE__ */ jsx("button", {
+				type: "button",
+				"data-testid": "fluidgrids-workflow-description",
+				title: shown || placeholder,
+				"aria-label": tr("fluidgrids.builder.workflowDescription.label", "Workflow description"),
+				className: cn("-mx-1 min-w-0 shrink-[6] cursor-text truncate rounded px-1 text-left text-xs transition-colors hover:bg-card-foreground/10", shown ? "text-card-foreground/80" : "italic text-muted-foreground", className),
+				onClick: () => setDraft(shown),
+				children: shown || placeholder
+			})
+		}), /* @__PURE__ */ jsxs(PopoverContent, {
+			align: "start",
+			className: "flex w-80 flex-col gap-1.5 p-2",
+			onEscapeKeyDown: (event) => {
+				event.preventDefault();
+				setDraft(null);
+			},
+			children: [/* @__PURE__ */ jsx(Textarea, {
+				autoFocus: true,
+				"data-testid": "fluidgrids-workflow-description-input",
+				"aria-label": tr("fluidgrids.builder.workflowDescription.label", "Workflow description"),
+				placeholder: tr("fluidgrids.builder.workflowDescription.placeholder", "What does this workflow do?"),
+				rows: 3,
+				maxLength: 500,
+				value: draft ?? "",
+				onChange: (event) => setDraft(event.target.value),
+				onKeyDown: (event) => {
+					if (event.key === "Enter" && (event.ctrlKey || event.metaKey)) {
+						event.preventDefault();
+						commit();
+					}
+				},
+				className: "min-h-20 resize-none text-sm"
+			}), /* @__PURE__ */ jsxs("div", {
+				className: "flex items-center justify-between gap-2 text-[11px] text-muted-foreground",
+				children: [/* @__PURE__ */ jsx("span", { children: tr("fluidgrids.builder.workflowDescription.hint", "Ctrl+Enter to save, Esc to cancel") }), /* @__PURE__ */ jsxs("span", {
+					"data-testid": "fluidgrids-workflow-description-counter",
+					className: cn("tabular-nums", left < 0 && "text-destructive"),
+					children: [
+						500 - left,
+						"/",
+						500
+					]
+				})]
+			})]
+		})]
+	});
+}
+
 // src/builder/components/flow-builder/components/ui/builder-header.tsx
 /**
-* The workflow editor's header (BOFF-9773): back, the workflow's name and
-* version alias, tags and save state on the left; the actions on the right,
-* laid out by `BuilderHeaderLayout` for the header's own width.
+* The workflow editor's header (BOFF-9773): back, the workflow's name,
+* version alias, description (BOFF-9743), tags and save state on the left;
+* the actions on the right, laid out by `BuilderHeaderLayout` for the
+* header's own width.
 */
 /** Run button with an attached chevron opening a small menu (currently just "View Runs"). */
 function RunWithViewRuns({ onViewRuns, canViewRuns, className, runButtonClassName }) {
@@ -16906,7 +17080,7 @@ function VersionAliasChip({ value, onChange, iconOnly }) {
 		children: label
 	});
 }
-/** Back, name, alias, tags and save state. */
+/** Back, name, description, alias, tags and save state. */
 function HeaderIdentity({ tier }) {
 	const tr = useTr();
 	const { id } = useParams();
@@ -16955,6 +17129,7 @@ function HeaderIdentity({ tier }) {
 				});
 			}
 		}),
+		/* @__PURE__ */ jsx(WorkflowDescriptionField, { className: tier === "full" ? "max-w-[20rem]" : "max-w-[12rem]" }),
 		/* @__PURE__ */ jsx(CurrentVersionAiBadge, { iconOnly: tier === "mid" }),
 		id && /* @__PURE__ */ jsx(EntityTagPicker, {
 			entityType: "FLUIDGRIDS_WORKFLOW",
@@ -17443,7 +17618,7 @@ const FlowBuilder = ({ readOnly = false }) => {
 		paletteGatesRef.current = paletteGates;
 	}, [paletteGates]);
 	useWarmBuilderOverlays();
-	useLazyAgentTools(() => import("./agentTools-CvPvDlPV.js").then(({ createBuilderAgentTools }) => createBuilderAgentTools({ durableFunctionsEnabled: () => paletteGatesRef.current })), !editingBlocked, "Agent tools");
+	useLazyAgentTools(() => import("./agentTools-EVdEThES.js").then(({ createBuilderAgentTools }) => createBuilderAgentTools({ durableFunctionsEnabled: () => paletteGatesRef.current })), !editingBlocked, "Agent tools");
 	const [nodes, edges, onNodesChange, onEdgesChange, onConnect] = useFlowStore(useShallow((s) => {
 		return [
 			s.workflow.nodes,
@@ -17485,7 +17660,7 @@ const FlowBuilder = ({ readOnly = false }) => {
 	useEffect(() => {
 		fitViewRef.current = fitView;
 	}, [fitView]);
-	useLazyAgentTools(() => import("./canvasNoteTools-OaF81_4T.js").then(({ createCanvasNoteTools }) => createCanvasNoteTools({ focusNode: (nodeId) => fitViewRef.current({
+	useLazyAgentTools(() => import("./canvasNoteTools-C5Vf0pxu.js").then(({ createCanvasNoteTools }) => createCanvasNoteTools({ focusNode: (nodeId) => fitViewRef.current({
 		nodes: [{ id: nodeId }],
 		duration: 400,
 		padding: .6,

package/dist/history.js

@@ -1,4 +1,4 @@
 "use client";
-import { t as HistoryPage } from "./HistoryPage-BC7ld-oQ.js";
+import { t as HistoryPage } from "./HistoryPage-BdijEOHp.js";
 
 export { HistoryPage };

package/dist/{index-T8fJI6Ys.d.ts → index-DbTgk7dK.d.ts}

@@ -1,6 +1,6 @@
 
 import { f as FluidGridsTheme, r as FluidGridsRefreshedTokens } from "./index-72XFgvbn.js";
-import { R as FluidGridsProviderProps, w as WorkflowData } from "./index-DjiFgEQl.js";
+import { R as FluidGridsProviderProps, w as WorkflowData } from "./index-f_Nl7Ons.js";
 import { j as Translator } from "./constants-XdvUxeWK.js";
 import { t as RunsQuota } from "./runsQuota-DsniKiSg.js";
 import * as React$2 from "react";

package/dist/{index-DjiFgEQl.d.ts → index-f_Nl7Ons.d.ts}

@@ -528,6 +528,7 @@ interface IFlowState {
     name: string;
     version: string;
     alias?: string;
+    description?: string;
     dbId?: string;
     status?: string;
     codeBuildId?: string;