@burdenoff/fluidgrids-fe-sdk 2026.1022.4 → 2026.1022.6

package/dist/{chunk-6CVZQJKW.js → chunk-OHUNYBJ6.js}

@@ -388,121 +388,149 @@ function NodesPage() {
     return counts;
   }, [categorizedNodes]);
   return /* @__PURE__ */ jsxs("div", { className: "p-4 sm:p-6 bg-background-primary min-h-screen", children: [
-    /* @__PURE__ */ jsxs("div", { className: "flex flex-col sm:flex-row sm:items-center sm:justify-between gap-4 mb-6", children: [
-      /* @__PURE__ */ jsxs("div", { children: [
-        /* @__PURE__ */ jsx("h1", { className: "text-2xl sm:text-3xl font-bold text-text-primary", children: tr("fluidgrids.nodes.nodesPage.title", "Node Catalog") }),
-        /* @__PURE__ */ jsx("p", { className: "text-text-secondary mt-1", children: tr(
-          "fluidgrids.nodes.nodesPage.subtitle",
-          "Browse and manage available workflow nodes"
-        ) })
-      ] }),
-      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3", children: [
-        /* @__PURE__ */ jsxs(Button, { variant: "outline", onClick: () => refetch(), children: [
-          /* @__PURE__ */ jsx(Icon, { icon: "mdi:refresh", className: "mr-2", width: 16 }),
-          tr("fluidgrids.nodes.nodesPage.refreshButton", "Refresh")
-        ] }),
-        /* @__PURE__ */ jsxs(Button, { variant: "outline", onClick: () => navigate("../list"), children: [
-          /* @__PURE__ */ jsx(Icon, { icon: "mdi:arrow-left", className: "mr-2", width: 16 }),
-          tr(
-            "fluidgrids.nodes.nodesPage.backToWorkflowsButton",
-            "Back to Workflows"
-          )
-        ] })
-      ] })
-    ] }),
-    /* @__PURE__ */ jsxs("div", { className: "grid grid-cols-3 gap-3 mb-6", children: [
-      /* @__PURE__ */ jsxs("div", { className: "p-3 rounded-lg bg-background-secondary border border-border-secondary", children: [
-        /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
+    /* @__PURE__ */ jsxs(
+      "div",
+      {
+        className: "flex flex-col sm:flex-row sm:items-center sm:justify-between gap-4 mb-6",
+        "data-tour": "fluidgrids-nodes-header",
+        children: [
+          /* @__PURE__ */ jsxs("div", { children: [
+            /* @__PURE__ */ jsx("h1", { className: "text-2xl sm:text-3xl font-bold text-text-primary", children: tr("fluidgrids.nodes.nodesPage.title", "Node Catalog") }),
+            /* @__PURE__ */ jsx("p", { className: "text-text-secondary mt-1", children: tr(
+              "fluidgrids.nodes.nodesPage.subtitle",
+              "Browse and manage available workflow nodes"
+            ) })
+          ] }),
+          /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [
+            /* @__PURE__ */ jsxs(Button, { variant: "outline", onClick: () => refetch(), children: [
+              /* @__PURE__ */ jsx(Icon, { icon: "mdi:refresh", className: "mr-2", width: 16 }),
+              tr("fluidgrids.nodes.nodesPage.refreshButton", "Refresh")
+            ] }),
+            /* @__PURE__ */ jsxs(Button, { variant: "outline", onClick: () => navigate("../list"), children: [
+              /* @__PURE__ */ jsx(Icon, { icon: "mdi:arrow-left", className: "mr-2", width: 16 }),
+              tr(
+                "fluidgrids.nodes.nodesPage.backToWorkflowsButton",
+                "Back to Workflows"
+              )
+            ] })
+          ] })
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsxs(
+      "div",
+      {
+        className: "grid grid-cols-3 gap-3 mb-6",
+        "data-tour": "fluidgrids-nodes-stats",
+        children: [
+          /* @__PURE__ */ jsxs("div", { className: "p-3 rounded-lg bg-background-secondary border border-border-secondary", children: [
+            /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
+              /* @__PURE__ */ jsx(
+                Icon,
+                {
+                  icon: "mdi:puzzle",
+                  width: 18,
+                  className: "text-text-secondary"
+                }
+              ),
+              /* @__PURE__ */ jsx("p", { className: "text-xs text-text-secondary", children: tr("fluidgrids.nodes.nodesPage.statTotal", "Total Nodes") })
+            ] }),
+            /* @__PURE__ */ jsx("p", { className: "text-xl font-bold text-text-primary mt-1", children: loading ? "\u2014" : stats.total })
+          ] }),
+          /* @__PURE__ */ jsxs("div", { className: "p-3 rounded-lg bg-background-secondary border border-border-secondary", children: [
+            /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
+              /* @__PURE__ */ jsx(
+                Icon,
+                {
+                  icon: "mdi:check-circle",
+                  width: 18,
+                  className: "text-status-success-text"
+                }
+              ),
+              /* @__PURE__ */ jsx("p", { className: "text-xs text-text-secondary", children: tr("fluidgrids.nodes.nodesPage.statActive", "Active") })
+            ] }),
+            /* @__PURE__ */ jsx("p", { className: "text-xl font-bold text-status-success-text mt-1", children: loading ? "\u2014" : stats.active })
+          ] }),
+          /* @__PURE__ */ jsxs("div", { className: "p-3 rounded-lg bg-background-secondary border border-border-secondary", children: [
+            /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
+              /* @__PURE__ */ jsx(
+                Icon,
+                {
+                  icon: "mdi:alert",
+                  width: 18,
+                  className: "text-status-warning-text"
+                }
+              ),
+              /* @__PURE__ */ jsx("p", { className: "text-xs text-text-secondary", children: tr("fluidgrids.nodes.nodesPage.statDeprecated", "Deprecated") })
+            ] }),
+            /* @__PURE__ */ jsx("p", { className: "text-xl font-bold text-status-warning-text mt-1", children: loading ? "\u2014" : stats.deprecated })
+          ] })
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsxs(
+      "div",
+      {
+        className: "relative max-w-md mb-6",
+        "data-tour": "fluidgrids-nodes-search",
+        children: [
           /* @__PURE__ */ jsx(
             Icon,
             {
-              icon: "mdi:puzzle",
+              icon: "mdi:magnify",
               width: 18,
-              className: "text-text-secondary"
+              className: "absolute left-3 top-1/2 -translate-y-1/2 text-text-secondary"
             }
           ),
-          /* @__PURE__ */ jsx("p", { className: "text-xs text-text-secondary", children: tr("fluidgrids.nodes.nodesPage.statTotal", "Total Nodes") })
-        ] }),
-        /* @__PURE__ */ jsx("p", { className: "text-xl font-bold text-text-primary mt-1", children: loading ? "\u2014" : stats.total })
-      ] }),
-      /* @__PURE__ */ jsxs("div", { className: "p-3 rounded-lg bg-background-secondary border border-border-secondary", children: [
-        /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
           /* @__PURE__ */ jsx(
-            Icon,
+            Input,
             {
-              icon: "mdi:check-circle",
-              width: 18,
-              className: "text-status-success-text"
+              placeholder: tr(
+                "fluidgrids.nodes.nodesPage.searchPlaceholder",
+                "Search nodes by name, type, or keyword..."
+              ),
+              value: search,
+              onChange: (e) => setSearch(e.target.value),
+              className: "pl-10 bg-background-secondary border-border-secondary"
             }
-          ),
-          /* @__PURE__ */ jsx("p", { className: "text-xs text-text-secondary", children: tr("fluidgrids.nodes.nodesPage.statActive", "Active") })
-        ] }),
-        /* @__PURE__ */ jsx("p", { className: "text-xl font-bold text-status-success-text mt-1", children: loading ? "\u2014" : stats.active })
-      ] }),
-      /* @__PURE__ */ jsxs("div", { className: "p-3 rounded-lg bg-background-secondary border border-border-secondary", children: [
-        /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
-          /* @__PURE__ */ jsx(
-            Icon,
+          )
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: "flex flex-wrap gap-2 mb-6",
+        "data-tour": "fluidgrids-nodes-categories",
+        children: NODE_CATEGORIES.map((cat) => {
+          const count = categoryCounts[cat.value] ?? 0;
+          const isActive = activeCategory === cat.value;
+          return /* @__PURE__ */ jsxs(
+            "button",
             {
-              icon: "mdi:alert",
-              width: 18,
-              className: "text-status-warning-text"
-            }
-          ),
-          /* @__PURE__ */ jsx("p", { className: "text-xs text-text-secondary", children: tr("fluidgrids.nodes.nodesPage.statDeprecated", "Deprecated") })
-        ] }),
-        /* @__PURE__ */ jsx("p", { className: "text-xl font-bold text-status-warning-text mt-1", children: loading ? "\u2014" : stats.deprecated })
-      ] })
-    ] }),
-    /* @__PURE__ */ jsxs("div", { className: "relative max-w-md mb-6", children: [
-      /* @__PURE__ */ jsx(
-        Icon,
-        {
-          icon: "mdi:magnify",
-          width: 18,
-          className: "absolute left-3 top-1/2 -translate-y-1/2 text-text-secondary"
-        }
-      ),
-      /* @__PURE__ */ jsx(
-        Input,
-        {
-          placeholder: tr(
-            "fluidgrids.nodes.nodesPage.searchPlaceholder",
-            "Search nodes by name, type, or keyword..."
-          ),
-          value: search,
-          onChange: (e) => setSearch(e.target.value),
-          className: "pl-10 bg-background-secondary border-border-secondary"
-        }
-      )
-    ] }),
-    /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-2 mb-6", children: NODE_CATEGORIES.map((cat) => {
-      const count = categoryCounts[cat.value] ?? 0;
-      const isActive = activeCategory === cat.value;
-      return /* @__PURE__ */ jsxs(
-        "button",
-        {
-          onClick: () => setActiveCategory(cat.value),
-          className: `inline-flex items-center gap-1.5 px-3 py-1.5 rounded-lg text-sm font-medium transition-colors ${isActive ? "bg-background-tertiary text-text-primary border border-border-primary" : "bg-background-secondary text-text-secondary border border-border-secondary hover:text-text-primary hover:border-border-primary"}`,
-          children: [
-            /* @__PURE__ */ jsx(Icon, { icon: cat.icon, width: 16 }),
-            cat.label,
-            /* @__PURE__ */ jsxs(
-              "span",
-              {
-                className: `ml-0.5 text-xs ${isActive ? "text-text-primary" : "text-text-secondary"}`,
-                children: [
-                  "(",
-                  count,
-                  ")"
-                ]
-              }
-            )
-          ]
-        },
-        cat.value
-      );
-    }) }),
+              onClick: () => setActiveCategory(cat.value),
+              className: `inline-flex items-center gap-1.5 px-3 py-1.5 rounded-lg text-sm font-medium transition-colors ${isActive ? "bg-background-tertiary text-text-primary border border-border-primary" : "bg-background-secondary text-text-secondary border border-border-secondary hover:text-text-primary hover:border-border-primary"}`,
+              children: [
+                /* @__PURE__ */ jsx(Icon, { icon: cat.icon, width: 16 }),
+                cat.label,
+                /* @__PURE__ */ jsxs(
+                  "span",
+                  {
+                    className: `ml-0.5 text-xs ${isActive ? "text-text-primary" : "text-text-secondary"}`,
+                    children: [
+                      "(",
+                      count,
+                      ")"
+                    ]
+                  }
+                )
+              ]
+            },
+            cat.value
+          );
+        })
+      }
+    ),
     error && /* @__PURE__ */ jsx("div", { className: "mb-6", children: /* @__PURE__ */ jsx(ErrorState, { message: error.message, onRetry: refetch }) }),
     loading ? /* @__PURE__ */ jsx(NodesSkeleton, {}) : filtered.length === 0 ? /* @__PURE__ */ jsx(
       EmptyState,

package/dist/{chunk-5QUAOGY7.js → chunk-QMZGUJI3.js}

@@ -1,4 +1,5 @@
-import { useExecutionsWithStore, useExecutionStats, useExecutionActions, useAutoRefresh, ExecutionStats, ExecutionFilters, ExecutionTable, ExecutionCards, ExecutionTimeline, Pagination } from './chunk-HIXQIM22.js';
+import { ExecutionStats, ExecutionFilters, ExecutionTable, ExecutionCards, ExecutionTimeline, Pagination } from './chunk-CV56O5R4.js';
+import { useExecutionsWithStore, useExecutionStats, useExecutionActions, useAutoRefresh } from './chunk-VGIH3SOT.js';
 import { useWorkflowDefinitions } from './chunk-HP3A6BPK.js';
 import { useExecutionsStore } from './chunk-UZG3ZIQM.js';
 import { useTr } from './chunk-UULVIT25.js';
@@ -184,7 +185,7 @@ function ExecutionsListPage() {
               "Monitor and manage your workflow runs"
             ) })
           ] }),
-          /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3", children: [
+          /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [
             /* @__PURE__ */ jsxs("div", { className: "flex items-center bg-background-secondary rounded-lg border border-border-secondary p-1", children: [
               /* @__PURE__ */ jsx(
                 "button",

package/dist/{chunk-QP62LB3V.js → chunk-QN4HHTQP.js}

@@ -1,6 +1,7 @@
-import { NEW_WORKFLOW_NAV } from './chunk-6N27YGMB.js';
+import { NEW_WORKFLOW_NAV, firstWorkflowProgress, builderPathFor, GUIDED_FIRST_WORKFLOW_NAV } from './chunk-YGBDZ424.js';
+import { useExecutions } from './chunk-VGIH3SOT.js';
 import { QuotaExhaustedDialog } from './chunk-SYVLFHWV.js';
-import { SdkPermissionButton, FLUIDGRIDS_PERMISSIONS, SdkPermissionGate } from './chunk-ONVGFVNH.js';
+import { useFluidGridsPermission, FLUIDGRIDS_PERMISSIONS, SdkPermissionButton, SdkPermissionGate } from './chunk-ONVGFVNH.js';
 import { useWorkflowDefinitions, useLazyWorkflowDefinition, useImportWorkflow, useDuplicateWorkflow, useDeleteWorkflow } from './chunk-HP3A6BPK.js';
 import { workflowsListControls } from './chunk-D3UWK7GY.js';
 import { useFluidGridsPageControls } from './chunk-PJAWNFJV.js';
@@ -11,7 +12,7 @@ import { useState, useMemo } from 'react';
 import { useNavigate } from 'react-router';
 import { v4 } from 'uuid';
 import { Icon } from '@iconify/react';
-import { Button, Badge, Input, IllustratedEmptyState, Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, Label, Textarea, DialogFooter, Skeleton, TooltipProvider, Card, Tooltip, TooltipTrigger, TooltipContent, AlertDialog, AlertDialogContent, AlertDialogHeader, AlertDialogTitle, AlertDialogDescription, AlertDialogFooter, AlertDialogCancel, AlertDialogAction } from '@burdenoff/fe-libs/ui';
+import { NextSteps, Button, Badge, Input, IllustratedEmptyState, Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, Label, Textarea, DialogFooter, Skeleton, TooltipProvider, Card, Tooltip, TooltipTrigger, TooltipContent, AlertDialog, AlertDialogContent, AlertDialogHeader, AlertDialogTitle, AlertDialogDescription, AlertDialogFooter, AlertDialogCancel, AlertDialogAction } from '@burdenoff/fe-libs/ui';
 import { cn } from '@burdenoff/fe-libs/utils';
 import { TagBadge } from '@burdenoff/fe-libs/tag';
 import { toast } from 'sonner';
@@ -788,10 +789,19 @@ function WorkflowImportDialog({
         if (!nextOpen) reset();
       },
       children: [
-        /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "default", onClick: () => setOpen(true), children: [
-          /* @__PURE__ */ jsx(Icon, { icon: "mynaui:download", className: "size-4" }),
-          tr("fluidgrids.workflowsList.importButton", "Import")
-        ] }),
+        /* @__PURE__ */ jsxs(
+          Button,
+          {
+            variant: "outline",
+            size: "default",
+            onClick: () => setOpen(true),
+            "data-tour": "fluidgrids-list-import",
+            children: [
+              /* @__PURE__ */ jsx(Icon, { icon: "mynaui:download", className: "size-4" }),
+              tr("fluidgrids.workflowsList.importButton", "Import")
+            ]
+          }
+        ),
         /* @__PURE__ */ jsxs(DialogContent, { className: "max-h-[90vh] overflow-y-auto sm:max-w-2xl", children: [
           /* @__PURE__ */ jsxs(DialogHeader, { children: [
             /* @__PURE__ */ jsx(DialogTitle, { children: tr("fluidgrids.workflowsList.importTitle", "Import workflow JSON") }),
@@ -936,6 +946,165 @@ function WorkflowImportDialog({
     }
   );
 }
+function firstWorkflowSteps({
+  progress,
+  canCreate,
+  onCreate,
+  onOpen,
+  onTemplates,
+  tr
+}) {
+  const { runTarget, activateTarget } = progress;
+  return [
+    {
+      id: "create",
+      label: tr(
+        "fluidgrids.onboarding.createLabel",
+        "Build your first workflow, with a guided tour"
+      ),
+      description: tr(
+        "fluidgrids.onboarding.createDescription",
+        "Opens a new draft in the builder and walks you through adding a trigger, connecting nodes and saving."
+      ),
+      icon: /* @__PURE__ */ jsx(Icon, { icon: "mynaui:plus", className: "size-4", "aria-hidden": "true" }),
+      done: progress.created,
+      onClick: !progress.created && canCreate ? onCreate : void 0
+    },
+    {
+      id: "run",
+      label: tr("fluidgrids.onboarding.runLabel", "Run it once to test"),
+      description: tr(
+        "fluidgrids.onboarding.runDescription",
+        "Press Run in the builder. Every execution shows up in Runs with a step-by-step timeline and logs."
+      ),
+      icon: /* @__PURE__ */ jsx(
+        Icon,
+        {
+          icon: "mdi:play-circle-outline",
+          className: "size-4",
+          "aria-hidden": "true"
+        }
+      ),
+      done: progress.ran,
+      onClick: !progress.ran && runTarget ? () => onOpen(runTarget) : void 0
+    },
+    {
+      id: "activate",
+      label: tr(
+        "fluidgrids.onboarding.activateLabel",
+        "Activate it to go live"
+      ),
+      description: tr(
+        "fluidgrids.onboarding.activateDescription",
+        "An active workflow answers its webhooks, schedules and other automatic triggers."
+      ),
+      icon: /* @__PURE__ */ jsx(
+        Icon,
+        {
+          icon: "mdi:lightning-bolt-outline",
+          className: "size-4",
+          "aria-hidden": "true"
+        }
+      ),
+      done: progress.activated,
+      onClick: !progress.activated && activateTarget ? () => onOpen(activateTarget) : void 0
+    },
+    {
+      id: "templates",
+      label: tr(
+        "fluidgrids.onboarding.templatesLabel",
+        "Or start from a template"
+      ),
+      description: tr(
+        "fluidgrids.onboarding.templatesDescription",
+        "Pick a pre-built workflow and adapt it instead of starting from a blank canvas."
+      ),
+      icon: /* @__PURE__ */ jsx(
+        Icon,
+        {
+          icon: "mynaui:layers-three",
+          className: "size-4",
+          "aria-hidden": "true"
+        }
+      ),
+      // Optional, so it never holds the checklist open: it counts as done once
+      // the person has a workflow, however they made it.
+      done: progress.created,
+      onClick: progress.created ? void 0 : onTemplates
+    }
+  ];
+}
+function FirstWorkflowChecklistView(props) {
+  const { progress, tr } = props;
+  if (progress.complete) return null;
+  return /* @__PURE__ */ jsx("div", { "data-tour": "fluidgrids-list-onboarding", children: /* @__PURE__ */ jsx(
+    NextSteps,
+    {
+      storageKey: "fluidgrids-first-workflow",
+      title: tr(
+        "fluidgrids.onboarding.title",
+        "Get started with your first workflow"
+      ),
+      steps: firstWorkflowSteps(props)
+    }
+  ) });
+}
+function useChecklistHandlers() {
+  const navigate = useNavigate();
+  return useMemo(
+    () => ({
+      onCreate: () => navigate(`../workflow/${v4()}/v1`, GUIDED_FIRST_WORKFLOW_NAV),
+      onOpen: (workflow) => navigate(builderPathFor(workflow)),
+      onTemplates: () => navigate("../templates")
+    }),
+    [navigate]
+  );
+}
+function ChecklistWithRuns({
+  workflows,
+  canCreate
+}) {
+  const tr = useTr();
+  const handlers = useChecklistHandlers();
+  const { total, loading, error } = useExecutions({ limit: 1 });
+  const runsTotal = loading || error ? null : total;
+  const progress = useMemo(
+    () => firstWorkflowProgress(workflows, runsTotal),
+    [workflows, runsTotal]
+  );
+  return /* @__PURE__ */ jsx(
+    FirstWorkflowChecklistView,
+    {
+      progress,
+      canCreate,
+      tr,
+      ...handlers
+    }
+  );
+}
+function ChecklistWithoutWorkflows({ canCreate }) {
+  const tr = useTr();
+  const handlers = useChecklistHandlers();
+  const progress = useMemo(() => firstWorkflowProgress([], 0), []);
+  return /* @__PURE__ */ jsx(
+    FirstWorkflowChecklistView,
+    {
+      progress,
+      canCreate,
+      tr,
+      ...handlers
+    }
+  );
+}
+function FirstWorkflowChecklist({
+  workflows,
+  canCreate
+}) {
+  if (workflows.length === 0) {
+    return /* @__PURE__ */ jsx(ChecklistWithoutWorkflows, { canCreate });
+  }
+  return /* @__PURE__ */ jsx(ChecklistWithRuns, { workflows, canCreate });
+}
 function useStatusFilters() {
   const tr = useTr();
   return useMemo(
@@ -982,6 +1151,9 @@ function WorkflowsList() {
     latestOnly: true
   });
   const { getWorkflow } = useLazyWorkflowDefinition();
+  const { allowed: canCreate } = useFluidGridsPermission(
+    FLUIDGRIDS_PERMISSIONS.WORKFLOW_CREATE
+  );
   const [search, setSearch] = useState("");
   const [statusFilter, setStatusFilter] = useState(null);
   const [tagFilter, setTagFilter] = useState(null);
@@ -1108,6 +1280,7 @@ function WorkflowsList() {
               ]
             }
           ),
+          !loading && !error && /* @__PURE__ */ jsx(FirstWorkflowChecklist, { workflows, canCreate }),
           !loading && !error && workflows.length > 0 && /* @__PURE__ */ jsxs(
             "div",
             {
@@ -1289,4 +1462,4 @@ function WorkflowsList() {
   );
 }
 
-export { WorkflowsList };
+export { FirstWorkflowChecklist, FirstWorkflowChecklistView, WorkflowsList };

package/dist/{chunk-M7FOQBCR.js → chunk-RQ6TDVVL.js}

@@ -1,16 +1,58 @@
-import { isCreateIntent, decideMissingWorkflow } from './chunk-6N27YGMB.js';
-import { useInstalledNodes, buildNodeCheck, refetchStoreNodes, FlowBuilderPage, buildRequiredNodeTypes, mergeStickyNotes } from './chunk-T3UCFY7J.js';
+import { isGuidedTourIntent, pickGuidedTour, withoutGuidedTourIntent, isCreateIntent, decideMissingWorkflow } from './chunk-YGBDZ424.js';
+import { useInstalledNodes, buildNodeCheck, refetchStoreNodes, FlowBuilderPage, buildRequiredNodeTypes, mergeStickyNotes } from './chunk-36RTRUCM.js';
 import { useLazyWorkflowDefinition, useCreateWorkflow } from './chunk-HP3A6BPK.js';
 import { useFlowStore } from './chunk-VI2RFS65.js';
 import { useTr } from './chunk-UULVIT25.js';
-import { useNavigate, useParams, useLocation } from 'react-router';
+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 { ErrorBoundary } from '@burdenoff/fe-libs/shared/components';
 import '@xyflow/react/dist/style.css';
 
+var START_DELAY_MS = 800;
+function StartGuidedTour() {
+  const location = useLocation();
+  const navigate = useNavigate();
+  const { pageTours, pageId, loading } = useSafeToursContext();
+  const playTour = usePlayTour();
+  const startedForKey = useRef(null);
+  const tour = loading ? null : pickGuidedTour(pageTours, pageId);
+  useEffect(() => {
+    if (!tour || startedForKey.current === location.key) return void 0;
+    const timer = setTimeout(() => {
+      startedForKey.current = location.key;
+      playTour(tour);
+      void navigate(
+        {
+          pathname: location.pathname,
+          search: location.search,
+          hash: location.hash
+        },
+        { replace: true, state: withoutGuidedTourIntent(location.state) }
+      );
+    }, START_DELAY_MS);
+    return () => clearTimeout(timer);
+  }, [
+    tour,
+    playTour,
+    navigate,
+    location.key,
+    location.pathname,
+    location.search,
+    location.hash,
+    location.state
+  ]);
+  return null;
+}
+function GuidedTourStarter({ ready }) {
+  const location = useLocation();
+  const { productId } = useSafeToursContext();
+  if (!ready || !productId || !isGuidedTourIntent(location.state)) return null;
+  return /* @__PURE__ */ jsx(StartGuidedTour, {});
+}
 var LazyMissingNodesInstallModal = lazy(
   () => import('./MissingNodesInstallModal-OSAJLIBE.js').then(
     (m) => ({ default: m.MissingNodesInstallModal })
@@ -457,7 +499,8 @@ function WorkflowItem({
         installErrors
       }
     ) }),
-    workflow && !isLoading && /* @__PURE__ */ jsx(FlowBuilderPage, { workflow })
+    workflow && !isLoading && /* @__PURE__ */ jsx(FlowBuilderPage, { workflow }),
+    /* @__PURE__ */ jsx(GuidedTourStarter, { ready: Boolean(workflow && !isLoading) })
   ] });
 }
 function WorkflowBuilder() {
@@ -498,4 +541,4 @@ function WorkflowBuilder() {
   );
 }
 
-export { WorkflowBuilder };
+export { GuidedTourStarter, WorkflowBuilder };