@burdenoff/fluidgrids-fe-sdk 2026.1022.1 → 2026.1022.2

package/dist/{ExecutionDetailPage-6UKPMPL2.js → ExecutionDetailPage-NFZVCUCA.js}

@@ -1,12 +1,12 @@
-export { ExecutionDetailPage } from './chunk-QL7CDZ7B.js';
-import './chunk-GU233T6U.js';
+export { ExecutionDetailPage } from './chunk-6LMWVUD7.js';
+import './chunk-3XEIMQNT.js';
 import './chunk-QBFAJNUC.js';
 import './chunk-ONVGFVNH.js';
 import './chunk-JL7CASN5.js';
 import './chunk-D3UWK7GY.js';
 import './chunk-UZG3ZIQM.js';
 import './chunk-PJAWNFJV.js';
-import './chunk-L2UWPFJM.js';
-import './chunk-CFCUM4CN.js';
+import './chunk-SAZVBFMO.js';
+import './chunk-4UAWCWS7.js';
 import './chunk-UULVIT25.js';
 import './chunk-NTWG3CJX.js';

package/dist/{ExecutionsListPage-3IFRZU6A.js → ExecutionsListPage-KSOHJU4T.js}

@@ -1,11 +1,11 @@
-export { ExecutionsListPage } from './chunk-YB6WGQTY.js';
-import './chunk-GU233T6U.js';
+export { ExecutionsListPage } from './chunk-YPF7LVUZ.js';
+import './chunk-3XEIMQNT.js';
 import './chunk-QBFAJNUC.js';
-import './chunk-O6E247J6.js';
+import './chunk-HP3A6BPK.js';
 import './chunk-D3UWK7GY.js';
 import './chunk-UZG3ZIQM.js';
 import './chunk-PJAWNFJV.js';
-import './chunk-L2UWPFJM.js';
-import './chunk-CFCUM4CN.js';
+import './chunk-SAZVBFMO.js';
+import './chunk-4UAWCWS7.js';
 import './chunk-UULVIT25.js';
 import './chunk-NTWG3CJX.js';

package/dist/{WorkflowBuilder-PYJ5T23Q.js → WorkflowBuilder-FR3TUJ33.js}

@@ -1,20 +1,20 @@
-export { WorkflowBuilder } from './chunk-RFG3PJX3.js';
+export { WorkflowBuilder } from './chunk-EU5ANGO4.js';
 import './chunk-6N27YGMB.js';
-import './chunk-2CDLVDSU.js';
+import './chunk-2HUSQTUK.js';
 import './chunk-GEMNVFPK.js';
 import './chunk-IEVSFCFS.js';
 import './chunk-7LSGGJ7D.js';
 import './chunk-GDAFKRQO.js';
-import './chunk-SQFFJUAT.js';
+import './chunk-SYVLFHWV.js';
 import './chunk-PXIFUMLA.js';
 import './chunk-WBH2XEWO.js';
 import './chunk-ONVGFVNH.js';
 import './chunk-JL7CASN5.js';
-import './chunk-O6E247J6.js';
+import './chunk-HP3A6BPK.js';
 import './chunk-UZG3ZIQM.js';
-import './chunk-XGFADY55.js';
+import './chunk-5TW5JP5R.js';
 import './chunk-EGYJKHAL.js';
-import './chunk-L2UWPFJM.js';
-import './chunk-CFCUM4CN.js';
+import './chunk-SAZVBFMO.js';
+import './chunk-4UAWCWS7.js';
 import './chunk-UULVIT25.js';
 import './chunk-NTWG3CJX.js';

package/dist/{WorkflowsList-3ZDCAB4D.js → WorkflowsList-BAYEP7TU.js}

@@ -1,14 +1,14 @@
-export { WorkflowsList } from './chunk-3RIZZY32.js';
+export { WorkflowsList } from './chunk-FJHERSHE.js';
 import './chunk-6N27YGMB.js';
-import './chunk-SQFFJUAT.js';
+import './chunk-SYVLFHWV.js';
 import './chunk-ONVGFVNH.js';
 import './chunk-JL7CASN5.js';
-import './chunk-O6E247J6.js';
+import './chunk-HP3A6BPK.js';
 import './chunk-D3UWK7GY.js';
 import './chunk-UZG3ZIQM.js';
 import './chunk-PJAWNFJV.js';
 import './chunk-EGYJKHAL.js';
-import './chunk-L2UWPFJM.js';
-import './chunk-CFCUM4CN.js';
+import './chunk-SAZVBFMO.js';
+import './chunk-4UAWCWS7.js';
 import './chunk-UULVIT25.js';
 import './chunk-NTWG3CJX.js';

package/dist/{chunk-2CDLVDSU.js → chunk-2HUSQTUK.js}

@@ -2,17 +2,17 @@ import { deepClone, applyTemplateInputs } from './chunk-GEMNVFPK.js';
 import { Input as Input$1 } from './chunk-IEVSFCFS.js';
 import { Dialog as Dialog$1, DialogContent as DialogContent$1, DialogHeader as DialogHeader$1, DialogTitle as DialogTitle$1, DialogDescription as DialogDescription$1, DialogFooter } from './chunk-7LSGGJ7D.js';
 import { Badge as Badge$1, Button as Button$1 } from './chunk-GDAFKRQO.js';
-import { QuotaExhaustedDialog } from './chunk-SQFFJUAT.js';
+import { QuotaExhaustedDialog } from './chunk-SYVLFHWV.js';
 import { getGlobalStoreClient, createGlobalStoreClient, setGlobalStoreClient, resetGlobalStoreClient } from './chunk-PXIFUMLA.js';
 import { GetMyNodeInstallationsDocument, BrowseWorkflowTemplatesDocument, InstallWorkflowNodeDocument, InstallPurchasedNodeDocument, BrowseWorkflowNodesDocument, UninstallWorkflowNodeDocument, CreateStoreOrderDocument, GetNodeInstallableVersionsDocument } from './chunk-WBH2XEWO.js';
 import { SdkPermissionGate, FLUIDGRIDS_PERMISSIONS, SdkPermissionButton } from './chunk-ONVGFVNH.js';
 import { cn as cn$1 } from './chunk-JL7CASN5.js';
-import { useWorkflowVersions, useRestoreWorkflowVersion, useActivateWorkflow, useDeleteWorkflow, useLazyWorkflowDefinition, useDeactivateWorkflow } from './chunk-O6E247J6.js';
+import { useWorkflowVersions, useRestoreWorkflowVersion, useActivateWorkflow, useDeleteWorkflow, useLazyWorkflowDefinition, useDeactivateWorkflow } from './chunk-HP3A6BPK.js';
 import { config, getFluidGridsConfig, validateTrustedOrigin, resetFluidGridsExecutionState, setFluidGridsConfig, resetFluidGridsConfig } from './chunk-UZG3ZIQM.js';
-import { fetchAllNodeEndpointConfigs } from './chunk-XGFADY55.js';
+import { fetchAllNodeEndpointConfigs } from './chunk-5TW5JP5R.js';
 import { useFlowStore, isNodeTrigger, useIsValidConnection, isTriggerOperation } from './chunk-EGYJKHAL.js';
-import { NodeManifestDocument, UpdateWorkflowDefinitionDocument, CreateWorkflowDefinitionDocument, CreateWorkflowVersionDocument, ExecuteStepDocument, TriggerWorkflowDocument, RunFromNodeDocument, ExecutionDetailDocument, WorkflowRunDocument, FluidgridsEntityTagsDocument, AvailableFluidgridsTagsDocument, SearchFluidgridsTagsDocument, TagFluidgridsEntityDocument, UntagFluidgridsEntityDocument, ReplaceFluidgridsEntityTagsDocument, CreateFluidgridsTagDocument, NodeSchemaIntrospectionDocument, useWorkflowPinnedDataQuery, usePinNodeDataMutation, useUnpinNodeDataMutation, useRunFromNodeEligibilityQuery, EventRegistrationsDocument, WebhookTestListenerDocument, StopWebhookTestListenerDocument, ListenForWebhookTestEventDocument, NodeUsageStatusDocument, RemoveNodeFromWorkflowsDocument } from './chunk-L2UWPFJM.js';
-import { throwIfResultError, describeOperationError } from './chunk-CFCUM4CN.js';
+import { NodeManifestDocument, UpdateWorkflowDefinitionDocument, CreateWorkflowDefinitionDocument, CreateWorkflowVersionDocument, ExecuteStepDocument, TriggerWorkflowDocument, RunFromNodeDocument, ExecutionDetailDocument, WorkflowRunDocument, FluidgridsEntityTagsDocument, AvailableFluidgridsTagsDocument, SearchFluidgridsTagsDocument, TagFluidgridsEntityDocument, UntagFluidgridsEntityDocument, ReplaceFluidgridsEntityTagsDocument, CreateFluidgridsTagDocument, WorkspaceRunsQuotaDocument, NodeSchemaIntrospectionDocument, useWorkflowPinnedDataQuery, usePinNodeDataMutation, useUnpinNodeDataMutation, useRunFromNodeEligibilityQuery, EventRegistrationsDocument, WebhookTestListenerDocument, StopWebhookTestListenerDocument, ListenForWebhookTestEventDocument, NodeUsageStatusDocument, RemoveNodeFromWorkflowsDocument } from './chunk-SAZVBFMO.js';
+import { throwIfResultError, isQuotaExhaustedFailure, describeOperationError, openRunQuotaUpgradePrompt, RUNS_QUOTA_NAME, BILLING_PLANS_PATH } from './chunk-4UAWCWS7.js';
 import { useTr, FluidGridsTranslationProvider, ENGLISH_FALLBACK_TRANSLATOR } from './chunk-UULVIT25.js';
 import { waitForFluidGridsClient, getFluidGridsClient, getFluidGridsClientSafe, createFluidGridsClient, setFluidGridsClient, resetFluidGridsClient } from './chunk-NTWG3CJX.js';
 import * as React2 from 'react';
@@ -30,9 +30,8 @@ import { Handle, Position, getBezierPath, MarkerType, useReactFlow, NodeResizer,
 import { nanoid } from 'nanoid';
 import ReactMarkdown from 'react-markdown';
 import { toast } from 'sonner';
-import { useParams, useNavigate } from 'react-router';
+import { useParams, useNavigate, Link } from 'react-router';
 import { useShallow, shallow } from 'zustand/shallow';
-import { isQuotaExhaustedError } from '@burdenoff/fe-libs/shared/utils';
 import { InfoCircledIcon } from '@radix-ui/react-icons';
 import { ApolloProvider, useQuery, useMutation } from '@apollo/client/react';
 import { TagBadge, TagsWidget } from '@burdenoff/fe-libs/tag';
@@ -4178,7 +4177,7 @@ function useSaveWorkflow() {
       const message = error instanceof Error ? error.message : "Unknown error";
       console.error("Error saving workflow:", message);
       const cause = error instanceof Error ? error.cause : void 0;
-      if (isQuotaExhaustedError(cause) || isQuotaExhaustedError(error)) {
+      if (isQuotaExhaustedFailure(cause) || isQuotaExhaustedFailure(error)) {
         setQuotaExhausted(true);
       } else {
         toast.error("Failed to save workflow", {
@@ -5906,6 +5905,7 @@ function calculateItemCount(output) {
   return 1;
 }
 function useNodeExecution() {
+  const tr = useTr();
   const pollTimerRef = useRef(null);
   const pollStartRef = useRef(0);
   const activeRunIdRef = useRef(null);
@@ -6253,6 +6253,7 @@ function useNodeExecution() {
         return { success: false, error: "No result from trigger" };
       } catch (error) {
         console.error("[useNodeExecution] Error triggering workflow:", error);
+        openRunQuotaUpgradePrompt(error, tr);
         const errorMessage = describeOperationError(error);
         const errorRunId = nanoid$1();
         const errorLog = {
@@ -6285,7 +6286,8 @@ function useNodeExecution() {
       addLog,
       setNodeStatus,
       pollRunUpdates,
-      completeExecution
+      completeExecution,
+      tr
     ]
   );
   const followRun = useCallback(
@@ -6348,6 +6350,7 @@ function useNodeExecution() {
         return { success: false, error: "No result from runFromNode" };
       } catch (error) {
         console.error("[useNodeExecution] Error running from node:", error);
+        openRunQuotaUpgradePrompt(error, tr);
         const errorMessage = describeOperationError(error);
         setNodeStatus(nodeId, "error");
         completeExecution();
@@ -6360,7 +6363,8 @@ function useNodeExecution() {
       setNodeStatus,
       startExecution,
       pollRunUpdates,
-      completeExecution
+      completeExecution,
+      tr
     ]
   );
   const loadExecution = useCallback(
@@ -7209,6 +7213,159 @@ function EntityTagPicker({
     }
   );
 }
+
+// src/billing/runsQuota.ts
+var MAX_ASSIGNMENTS_PER_QUOTA = 100;
+var RUNS_QUOTA_WARNING_RATIO = 0.8;
+var createdAtMs = (row) => {
+  const ms = Date.parse(row.createdAt);
+  return Number.isNaN(ms) ? Number.POSITIVE_INFINITY : ms;
+};
+function summarizeRunsQuota(rows, quotaName = RUNS_QUOTA_NAME) {
+  const assignments = rows.filter((row) => row.isActive && row.quotaName === quotaName).sort((a, b) => createdAtMs(a) - createdAtMs(b)).slice(0, MAX_ASSIGNMENTS_PER_QUOTA);
+  if (assignments.length === 0) return null;
+  const used = assignments.reduce((sum, row) => sum + row.used, 0);
+  if (assignments.some((row) => row.noLimit || row.limit == null)) {
+    return { used, limit: null, noLimit: true };
+  }
+  const limit = assignments.reduce((sum, row) => sum + (row.limit ?? 0), 0);
+  return { used, limit, noLimit: false };
+}
+function runsQuotaLevel(quota) {
+  if (quota.noLimit || quota.limit === null) return "ok";
+  if (quota.limit <= 0 || quota.used >= quota.limit) return "exhausted";
+  return quota.used / quota.limit >= RUNS_QUOTA_WARNING_RATIO ? "warning" : "ok";
+}
+async function readRunsQuota(client, workspaceId) {
+  if (!workspaceId) return null;
+  try {
+    const result = await client.query({
+      query: WorkspaceRunsQuotaDocument,
+      variables: { workspaceId },
+      fetchPolicy: "network-only",
+      errorPolicy: "all"
+    });
+    if (result.error) return null;
+    const rows = result.data?.workspaceQuotaAssignments;
+    return rows ? summarizeRunsQuota(rows) : null;
+  } catch {
+    return null;
+  }
+}
+function useRunsQuota() {
+  const [quota, setQuota] = useState(null);
+  const isExecuting = useFlowStore((s) => s.execution.isExecuting);
+  const request = useRef(0);
+  const refresh = useCallback(async () => {
+    const client = getFluidGridsClientSafe();
+    const { workspaceId } = getFluidGridsConfig();
+    const id = ++request.current;
+    const next = client ? await readRunsQuota(client, workspaceId) : null;
+    if (id === request.current) setQuota(next);
+  }, []);
+  useEffect(() => {
+    if (!isExecuting) void refresh();
+  }, [isExecuting, refresh]);
+  useEffect(
+    () => () => {
+      request.current += 1;
+    },
+    []
+  );
+  return quota;
+}
+var BAR_CLASS = {
+  ok: "bg-primary",
+  warning: "bg-status-warning-bg",
+  exhausted: "bg-status-error-bg"
+};
+var TEXT_CLASS = {
+  ok: "text-muted-foreground",
+  warning: "text-status-warning-text",
+  exhausted: "text-status-error-text"
+};
+function RunsUsageMeterView({
+  quota,
+  className
+}) {
+  const tr = useTr();
+  const level = runsQuotaLevel(quota);
+  const used = quota.used.toLocaleString();
+  if (quota.noLimit || quota.limit === null) {
+    return /* @__PURE__ */ jsx(
+      "span",
+      {
+        "data-testid": "fluidgrids-runs-meter",
+        "data-level": level,
+        className: cn("text-xs text-muted-foreground", className),
+        children: tr(
+          "fluidgrids.billing.runsMeter.unlimited",
+          "{{used}} runs this month",
+          { used }
+        )
+      }
+    );
+  }
+  const limit = quota.limit.toLocaleString();
+  const percent = quota.limit > 0 ? Math.min(100, Math.round(quota.used / quota.limit * 100)) : 100;
+  const label = tr(
+    "fluidgrids.billing.runsMeter.label",
+    "{{used}} of {{limit}} runs used this month",
+    { used, limit }
+  );
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      "data-testid": "fluidgrids-runs-meter",
+      "data-level": level,
+      className: cn("flex items-center gap-2 text-xs", className),
+      children: [
+        /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: "flex flex-col gap-1",
+            title: label,
+            role: "meter",
+            "aria-label": label,
+            "aria-valuemin": 0,
+            "aria-valuemax": quota.limit,
+            "aria-valuenow": Math.min(quota.used, quota.limit),
+            children: [
+              /* @__PURE__ */ jsx("span", { className: cn("whitespace-nowrap", TEXT_CLASS[level]), children: tr(
+                "fluidgrids.billing.runsMeter.short",
+                "Runs {{used}} / {{limit}}",
+                {
+                  used,
+                  limit
+                }
+              ) }),
+              /* @__PURE__ */ jsx("span", { className: "block h-1 w-24 overflow-hidden rounded-full bg-muted", children: /* @__PURE__ */ jsx(
+                "span",
+                {
+                  className: cn("block h-full rounded-full", BAR_CLASS[level]),
+                  style: { width: `${percent}%` }
+                }
+              ) })
+            ]
+          }
+        ),
+        level !== "ok" && /* @__PURE__ */ jsx(
+          Link,
+          {
+            to: BILLING_PLANS_PATH,
+            className: "whitespace-nowrap font-medium text-primary hover:underline",
+            children: tr("fluidgrids.billing.runsMeter.upgrade", "Upgrade")
+          }
+        )
+      ]
+    }
+  );
+}
+function RunsUsageMeter({ className }) {
+  const quota = useRunsQuota();
+  if (!quota) return null;
+  return /* @__PURE__ */ jsx(RunsUsageMeterView, { quota, className });
+}
 function useGlobalStoreClient() {
   const context = useContext(FluidGridsContext);
   if (context?.globalClient) {
@@ -20089,7 +20246,7 @@ var SaveFlowButton = ({ className }) => {
         },
         onUpgrade: () => {
           dismissQuotaExhausted();
-          navigate("/billing");
+          navigate(BILLING_PLANS_PATH);
         }
       }
     )
@@ -21748,6 +21905,7 @@ function useWebhookTestListener(target, onReceived) {
   );
   const [busy, setBusy] = useState(false);
   const [error, setError] = useState(null);
+  const tr = useTr();
   const pollTimer = useRef(null);
   const openId = useRef(null);
   const generation = useRef(0);
@@ -21822,10 +21980,12 @@ function useWebhookTestListener(target, onReceived) {
     setBusy(true);
     setError(null);
     try {
-      const result = await client.mutate({
-        mutation: ListenForWebhookTestEventDocument,
-        variables: { input: { workflowKey, version, triggerNodeId } }
-      });
+      const result = throwIfResultError(
+        await client.mutate({
+          mutation: ListenForWebhookTestEventDocument,
+          variables: { input: { workflowKey, version, triggerNodeId } }
+        })
+      );
       const armed = result.data?.listenForWebhookTestEvent;
       if (!armed) throw new Error("The test listener could not be started");
       if (generation.current !== armedFor) {
@@ -21843,8 +22003,10 @@ function useWebhookTestListener(target, onReceived) {
       });
       poll(armed.id);
     } catch (err) {
-      if (generation.current === armedFor)
+      if (generation.current === armedFor) {
+        openRunQuotaUpgradePrompt(err, tr);
         setError(describeOperationError(err));
+      }
     } finally {
       if (generation.current === armedFor) setBusy(false);
     }
@@ -21854,7 +22016,8 @@ function useWebhookTestListener(target, onReceived) {
     triggerNodeId,
     poll,
     stopOpenListener,
-    stopAbandoned
+    stopAbandoned,
+    tr
   ]);
   const stop = useCallback(async () => {
     const id = openId.current;
@@ -26722,6 +26885,7 @@ var FlowBuilder = ({ readOnly = false }) => {
       ] }),
       name !== "" && /* @__PURE__ */ jsxs(Fragment, { children: [
         /* @__PURE__ */ jsxs("div", { className: "hidden shrink-0 lg:inline-flex items-center gap-2", children: [
+          /* @__PURE__ */ jsx(RunsUsageMeter, { className: "mr-1" }),
           /* @__PURE__ */ jsx(VersionHistoryPanel, {}),
           /* @__PURE__ */ jsx(SaveFlowButton, {}),
           /* @__PURE__ */ jsx(ActivateWorkflowButton, {}),
@@ -26992,4 +27156,4 @@ var FlowBuilderPage = ({
   ] });
 };
 
-export { Card2 as Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, ConnectionFormDialog, ConnectionSelector, EntityTagPicker, FLUIDGRIDS_ENTITY_TYPES, FlowBuilderPage, FluidGridsMark, FluidGridsProvider, RUNNER_INSTALL_SCRIPT_URL, RunOnSection, RunnerStatusPill, TemplateCard, buildNodeCheck, buildRequiredNodeTypes, listCustomBlocks, mergeStickyNotes, refetchStoreNodes, registerCustomBlock, resolveUiSpec, runnerInstallCommand, stripSubmitActions, tagLabel, useAvailableTags, useConnection, useConnections, useConnectionsByProvider, useCreateConnection, useCreateTag, useDraftEntityTags, useEntityTags, useFluidGridsContext, useImportWorkflowTemplate, useInitiateOAuth, useInstalledNodes, useNodeExecution, useProviders, useReplaceEntityTags, useRunnerActions, useRunners, useSearchTags, useTagEntity, useUntagEntity, useWorkflowTemplates };
+export { Card2 as Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, ConnectionFormDialog, ConnectionSelector, EntityTagPicker, FLUIDGRIDS_ENTITY_TYPES, FlowBuilderPage, FluidGridsMark, FluidGridsProvider, RUNNER_INSTALL_SCRIPT_URL, RunOnSection, RunnerStatusPill, RunsUsageMeter, RunsUsageMeterView, TemplateCard, buildNodeCheck, buildRequiredNodeTypes, listCustomBlocks, mergeStickyNotes, readRunsQuota, refetchStoreNodes, registerCustomBlock, resolveUiSpec, runnerInstallCommand, runsQuotaLevel, stripSubmitActions, summarizeRunsQuota, tagLabel, useAvailableTags, useConnection, useConnections, useConnectionsByProvider, useCreateConnection, useCreateTag, useDraftEntityTags, useEntityTags, useFluidGridsContext, useImportWorkflowTemplate, useInitiateOAuth, useInstalledNodes, useNodeExecution, useProviders, useReplaceEntityTags, useRunnerActions, useRunners, useRunsQuota, useSearchTags, useTagEntity, useUntagEntity, useWorkflowTemplates };

package/dist/{chunk-GU233T6U.js → chunk-3XEIMQNT.js}

@@ -2,8 +2,8 @@ import { REPLAY_WORKFLOW_RUN, RETRY_WORKFLOW_RUNS } from './chunk-QBFAJNUC.js';
 import { executionsControls } from './chunk-D3UWK7GY.js';
 import { useExecutionsStore } from './chunk-UZG3ZIQM.js';
 import { useFluidGridsPageControls } from './chunk-PJAWNFJV.js';
-import { ExecutionDetailDocument, ExecutionStatsDocument, PauseExecutionDocument, ResumeExecutionDocument, CancelExecutionDocument, RetryNodeDocument, TriggerWorkflowDocument, TerminateExecutionDocument, ExecutionsListDocument } from './chunk-L2UWPFJM.js';
-import { throwIfResultError } from './chunk-CFCUM4CN.js';
+import { ExecutionDetailDocument, ExecutionStatsDocument, PauseExecutionDocument, ResumeExecutionDocument, CancelExecutionDocument, RetryNodeDocument, TriggerWorkflowDocument, TerminateExecutionDocument, ExecutionsListDocument } from './chunk-SAZVBFMO.js';
+import { throwIfResultError, openRunQuotaUpgradePrompt } from './chunk-4UAWCWS7.js';
 import { useTr } from './chunk-UULVIT25.js';
 import { getFluidGridsClient } from './chunk-NTWG3CJX.js';
 import { Icon } from '@iconify/react';
@@ -2885,6 +2885,7 @@ function useExecutionStats(options = {}) {
   };
 }
 function useExecutionActions() {
+  const tr = useTr();
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState(null);
   const pauseExecution = useCallback(async (id) => {
@@ -2991,51 +2992,60 @@ function useExecutionActions() {
       } catch (err) {
         const error2 = err;
         setError(error2);
+        openRunQuotaUpgradePrompt(err, tr);
         return { ok: false, message: error2.message };
       } finally {
         setLoading(false);
       }
     },
-    []
+    [tr]
+  );
+  const replayExecution = useCallback(
+    async (runId) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const client = getFluidGridsClient();
+        const result = throwIfResultError(
+          await client.mutate({
+            mutation: REPLAY_WORKFLOW_RUN,
+            variables: { runId }
+          })
+        );
+        return result.data?.replayWorkflowRun ?? null;
+      } catch (err) {
+        setError(err);
+        openRunQuotaUpgradePrompt(err, tr);
+        return null;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [tr]
+  );
+  const retryExecutions = useCallback(
+    async (runIds) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const client = getFluidGridsClient();
+        const result = throwIfResultError(
+          await client.mutate({
+            mutation: RETRY_WORKFLOW_RUNS,
+            variables: { runIds }
+          })
+        );
+        return result.data?.retryWorkflowRuns ?? [];
+      } catch (err) {
+        setError(err);
+        openRunQuotaUpgradePrompt(err, tr);
+        return [];
+      } finally {
+        setLoading(false);
+      }
+    },
+    [tr]
   );
-  const replayExecution = useCallback(async (runId) => {
-    setLoading(true);
-    setError(null);
-    try {
-      const client = getFluidGridsClient();
-      const result = throwIfResultError(
-        await client.mutate({
-          mutation: REPLAY_WORKFLOW_RUN,
-          variables: { runId }
-        })
-      );
-      return result.data?.replayWorkflowRun ?? null;
-    } catch (err) {
-      setError(err);
-      return null;
-    } finally {
-      setLoading(false);
-    }
-  }, []);
-  const retryExecutions = useCallback(async (runIds) => {
-    setLoading(true);
-    setError(null);
-    try {
-      const client = getFluidGridsClient();
-      const result = throwIfResultError(
-        await client.mutate({
-          mutation: RETRY_WORKFLOW_RUNS,
-          variables: { runIds }
-        })
-      );
-      return result.data?.retryWorkflowRuns ?? [];
-    } catch (err) {
-      setError(err);
-      return [];
-    } finally {
-      setLoading(false);
-    }
-  }, []);
   const terminateExecution = useCallback(
     async (runId, reason) => {
       setLoading(true);

package/dist/chunk-4UAWCWS7.js

@@ -0,0 +1,162 @@
+import { ENGLISH_FALLBACK_TRANSLATOR } from './chunk-UULVIT25.js';
+import { CombinedGraphQLErrors, ServerError } from '@apollo/client/errors';
+import { dispatchUpgradePrompt } from '@burdenoff/fe-libs/shared/components';
+
+function describeGraphQLError(error) {
+  const code = typeof error.extensions?.code === "string" ? error.extensions.code : void 0;
+  switch (code) {
+    case "QUOTA_EXHAUSTED": {
+      const quota = /Quota exhausted for (\S+)/.exec(error.message)?.[1];
+      const allowance = quota ? `"${quota}" quota` : "usage quota";
+      return `Quota exhausted \u2014 your workspace has used up its ${allowance}. Upgrade your plan or wait for the quota to reset.`;
+    }
+    case "QUOTA_NOT_PROVISIONED":
+      return "This workspace's plan does not include this usage allowance yet. Contact your workspace admin or support to have it provisioned.";
+    case "UNAUTHENTICATED":
+      return "Your session has expired. Please sign in again.";
+    case "FORBIDDEN":
+      return error.message || "You don't have permission to perform this action.";
+    default:
+      return error.message || "Unknown error";
+  }
+}
+function firstGraphQLErrorInBody(bodyText) {
+  try {
+    const parsed = JSON.parse(bodyText);
+    if (typeof parsed !== "object" || parsed === null) return null;
+    const errors = parsed.errors;
+    if (!Array.isArray(errors) || errors.length === 0) return null;
+    const first = errors[0];
+    if (typeof first !== "object" || first === null) return null;
+    const message = first.message;
+    if (typeof message !== "string") return null;
+    return first;
+  } catch {
+    return null;
+  }
+}
+function describeOperationError(error, fallback = "Unknown error") {
+  if (CombinedGraphQLErrors.is(error)) {
+    const first = error.errors[0];
+    return first ? describeGraphQLError(first) : error.message || fallback;
+  }
+  if (ServerError.is(error)) {
+    const first = firstGraphQLErrorInBody(error.bodyText);
+    if (first) return describeGraphQLError(first);
+  }
+  if (error instanceof Error) {
+    return error.message || fallback;
+  }
+  if (typeof error === "string" && error.length > 0) {
+    return error;
+  }
+  return fallback;
+}
+function throwIfResultError(result) {
+  if (result.error) {
+    throw new Error(describeOperationError(result.error), {
+      cause: result.error
+    });
+  }
+  return result;
+}
+
+// src/billing/quota.ts
+var RUNS_QUOTA_NAME = "fluidgrids.runs.monthly";
+var WORKFLOWS_QUOTA_NAME = "fluidgrids.workflows.count";
+var BILLING_PLANS_PATH = "/billing/plans";
+var QUOTA_EXHAUSTED_CODE = "QUOTA_EXHAUSTED";
+var QUOTA_NOT_PROVISIONED_CODE = "QUOTA_NOT_PROVISIONED";
+function asRecord(value) {
+  return typeof value === "object" && value !== null ? value : null;
+}
+function extensionsOfList(list) {
+  if (!Array.isArray(list)) return [];
+  const found = [];
+  for (const entry of list) {
+    const extensions = asRecord(asRecord(entry)?.extensions);
+    if (extensions) found.push(extensions);
+  }
+  return found;
+}
+function extensionsOfBody(bodyText) {
+  if (typeof bodyText !== "string" || !bodyText.includes("errors")) return [];
+  try {
+    const parsed = JSON.parse(bodyText);
+    return extensionsOfList(asRecord(parsed)?.errors);
+  } catch {
+    return [];
+  }
+}
+var MAX_CAUSE_DEPTH = 5;
+function collectExtensions(error) {
+  const found = [];
+  const seen = /* @__PURE__ */ new Set();
+  let current = error;
+  for (let depth = 0; depth < MAX_CAUSE_DEPTH; depth += 1) {
+    const host = asRecord(current);
+    if (!host || seen.has(host)) break;
+    seen.add(host);
+    const direct = asRecord(host.extensions);
+    if (direct) found.push(direct);
+    found.push(...extensionsOfList(host.errors));
+    found.push(...extensionsOfList(host.graphQLErrors));
+    const networkError = asRecord(host.networkError);
+    found.push(...extensionsOfList(asRecord(networkError?.result)?.errors));
+    found.push(...extensionsOfBody(networkError?.bodyText));
+    found.push(...extensionsOfList(asRecord(host.result)?.errors));
+    found.push(...extensionsOfBody(host.bodyText));
+    current = host.cause;
+  }
+  return found;
+}
+function stringField(extensions, key) {
+  const value = extensions[key];
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function findQuotaRefusal(error) {
+  const all = collectExtensions(error);
+  const notProvisioned = all.find(
+    (ext) => ext.code === QUOTA_NOT_PROVISIONED_CODE
+  );
+  if (notProvisioned) {
+    return {
+      kind: "not-provisioned",
+      quotaName: stringField(notProvisioned, "quotaName"),
+      limitLeft: null
+    };
+  }
+  const exhausted = all.find((ext) => ext.code === QUOTA_EXHAUSTED_CODE);
+  if (exhausted) {
+    const limitLeft = exhausted.limitLeft;
+    return {
+      kind: "exhausted",
+      quotaName: stringField(exhausted, "quotaName"),
+      limitLeft: typeof limitLeft === "number" ? limitLeft : null
+    };
+  }
+  return null;
+}
+function isQuotaExhaustedFailure(error) {
+  return findQuotaRefusal(error)?.kind === "exhausted";
+}
+function openRunQuotaUpgradePrompt(error, tr = ENGLISH_FALLBACK_TRANSLATOR) {
+  const refusal = findQuotaRefusal(error);
+  if (refusal?.kind !== "exhausted") return false;
+  dispatchUpgradePrompt({
+    extensions: {
+      code: QUOTA_EXHAUSTED_CODE,
+      quotaName: refusal.quotaName ?? RUNS_QUOTA_NAME,
+      resource: tr("fluidgrids.billing.runQuota.resource", "workflow runs"),
+      ...refusal.limitLeft !== null ? { limitLeft: refusal.limitLeft } : {}
+    },
+    title: tr("fluidgrids.billing.runQuota.title", "Monthly run limit reached"),
+    description: tr(
+      "fluidgrids.billing.runQuota.description",
+      "Your workspace has used all the workflow runs included in its plan this month. Upgrade your plan to keep running workflows, or wait for the monthly reset."
+    )
+  });
+  return true;
+}
+
+export { BILLING_PLANS_PATH, RUNS_QUOTA_NAME, WORKFLOWS_QUOTA_NAME, describeOperationError, findQuotaRefusal, isQuotaExhaustedFailure, openRunQuotaUpgradePrompt, throwIfResultError };