@burdenoff/fluidgrids-fe-sdk 2026.1104.3 → 2026.1105.2

package/README.md

@@ -237,6 +237,44 @@ The SDK uses Tailwind CSS for styling. Make sure you have Tailwind configured in
 import '@burdenoff/fluidgrids-fe-sdk/styles.css';
 ```
 
+## Embedding: theme, token refresh and events (BOFF-9961)
+
+`FluidGridsProvider`, `FluidGridsRoot` and `WorkflowBuilder` take three
+embedding props (also settable with `setFluidGridsConfig`):
+
+```tsx
+<FluidGridsProvider
+  workspaceId={workspaceId}
+  apiGatewayUrl={workspaceGraphqlUrl}
+  authToken={token}
+  theme={{ mode: 'light', colors: { primary: '#2563eb' }, radius: { base: '10px' } }}
+  auth={{ onTokenExpired: () => session.refresh() }}
+  onEvent={(name, payload) => {
+    if (name === 'run:completed') console.log(payload.runId, payload.status);
+  }}
+>
+  {children}
+</FluidGridsProvider>
+```
+
+- **`theme`** — `"light"`, `"dark"` or `{ mode?, colors?, radius?, font? }`.
+  Each token maps to fe-libs semantic CSS variables (`FLUIDGRIDS_THEME_TOKEN_MAP`);
+  values are validated (`themeToCssVariables`) and applied document-wide as
+  inline properties on `<html>`, restored on unmount (`applyFluidGridsTheme`,
+  `useFluidGridsTheme`). The public embed viewer also reads `accent`, `radius`
+  and `font` query parameters next to `theme`.
+- **`auth.onTokenExpired`** — called once per expired-session failure (401,
+  `UNAUTHENTICATED`, expired/revoked credential); concurrent failures share one
+  call; the request is retried once with the new token; on rejection the SDK
+  emits `auth:failed` and surfaces the original error. Host-injected Apollo
+  clients add `createFluidGridsTokenRefreshLink()` before their auth link.
+- **`onEvent`** — typed `FluidGridsEventMap`: `workflow:saved`,
+  `workflow:activated`, `run:started`, `run:completed`, `node:selected`,
+  `error`, `auth:failed`. Contract version `FLUIDGRIDS_EVENTS_VERSION` (semver:
+  additive = minor, payload break = major).
+
+Full guide: [docs.fluidgrids.ai/developers/embedding](https://docs.fluidgrids.ai/developers/embedding).
+
 ## Branding
 
 Every workflow canvas the SDK renders — `WorkflowBuilder`, `WorkflowBuilderCore`,

package/dist/ExecutionDetailPage-HQB2SWBP.js

@@ -0,0 +1,28 @@
+export { ExecutionDetailPage } from './chunk-3XUWPDKJ.js';
+import './chunk-QFC6E3WD.js';
+import './chunk-CNKTQ5MG.js';
+import './chunk-J3YQCEP3.js';
+import './chunk-TCIBTMJI.js';
+import './chunk-NZAYYUQ4.js';
+import './chunk-AMXJLVZN.js';
+import './chunk-WZ3EJVS6.js';
+import './chunk-5ERAJC2I.js';
+import './chunk-EYQ7GJRW.js';
+import './chunk-JDLQ6QIB.js';
+import './chunk-IL343FKX.js';
+import './chunk-Y53CVZVV.js';
+import './chunk-FNZZ5JJL.js';
+import './chunk-QFGZXWTM.js';
+import './chunk-PJAWNFJV.js';
+import './chunk-H4ERTSMX.js';
+import './chunk-3QCRKKTI.js';
+import './chunk-5375NUIO.js';
+import './chunk-JL7CASN5.js';
+import './chunk-OCJTTHTS.js';
+import './chunk-AU7LACOY.js';
+import './chunk-G77IGC3Y.js';
+import './chunk-Z3ABLERJ.js';
+import './chunk-UULVIT25.js';
+import './chunk-3IXU7WUC.js';
+import './chunk-US5QSLPV.js';
+import './chunk-UEG2WC3G.js';

package/dist/ExecutionsListPage-RSLL634L.js

@@ -0,0 +1,22 @@
+export { ExecutionsListPage } from './chunk-HK76ZUAK.js';
+import './chunk-CNKTQ5MG.js';
+import './chunk-J3YQCEP3.js';
+import './chunk-WZ3EJVS6.js';
+import './chunk-5ERAJC2I.js';
+import './chunk-IL343FKX.js';
+import './chunk-FNZZ5JJL.js';
+import './chunk-QFGZXWTM.js';
+import './chunk-PJAWNFJV.js';
+import './chunk-H4ERTSMX.js';
+import './chunk-4VJ3MDOV.js';
+import './chunk-3QCRKKTI.js';
+import './chunk-5375NUIO.js';
+import './chunk-JL7CASN5.js';
+import './chunk-OCJTTHTS.js';
+import './chunk-AU7LACOY.js';
+import './chunk-G77IGC3Y.js';
+import './chunk-Z3ABLERJ.js';
+import './chunk-UULVIT25.js';
+import './chunk-3IXU7WUC.js';
+import './chunk-US5QSLPV.js';
+import './chunk-UEG2WC3G.js';

package/dist/WorkflowBuilder-E3PNZX74.js

@@ -0,0 +1,32 @@
+export { WorkflowBuilder } from './chunk-TNFBRXU7.js';
+import './chunk-Y6M7K4UG.js';
+import './chunk-PIKYQE7P.js';
+import './chunk-62CCBMDC.js';
+import './chunk-GEMNVFPK.js';
+import './chunk-B6CCE2RW.js';
+import './chunk-IEVSFCFS.js';
+import './chunk-YXMFRQYV.js';
+import './chunk-BQXVT32O.js';
+import './chunk-6ZK4MRVA.js';
+import './chunk-W5WML3OO.js';
+import './chunk-GKFMK7FF.js';
+import './chunk-EYQ7GJRW.js';
+import './chunk-JDLQ6QIB.js';
+import './chunk-IL343FKX.js';
+import './chunk-Y53CVZVV.js';
+import './chunk-64JN2TVX.js';
+import './chunk-QFGZXWTM.js';
+import './chunk-GLYINMOR.js';
+import './chunk-H4ERTSMX.js';
+import './chunk-4VJ3MDOV.js';
+import './chunk-3QCRKKTI.js';
+import './chunk-5375NUIO.js';
+import './chunk-JL7CASN5.js';
+import './chunk-OCJTTHTS.js';
+import './chunk-AU7LACOY.js';
+import './chunk-G77IGC3Y.js';
+import './chunk-Z3ABLERJ.js';
+import './chunk-UULVIT25.js';
+import './chunk-3IXU7WUC.js';
+import './chunk-US5QSLPV.js';
+import './chunk-UEG2WC3G.js';

package/dist/WorkflowsList-473FRRP2.js

@@ -0,0 +1,21 @@
+export { WorkflowsList } from './chunk-5CFCFA6O.js';
+import './chunk-Y6M7K4UG.js';
+import './chunk-J3YQCEP3.js';
+import './chunk-5ERAJC2I.js';
+import './chunk-GKFMK7FF.js';
+import './chunk-FNZZ5JJL.js';
+import './chunk-QFGZXWTM.js';
+import './chunk-PJAWNFJV.js';
+import './chunk-H4ERTSMX.js';
+import './chunk-4VJ3MDOV.js';
+import './chunk-3QCRKKTI.js';
+import './chunk-5375NUIO.js';
+import './chunk-JL7CASN5.js';
+import './chunk-OCJTTHTS.js';
+import './chunk-AU7LACOY.js';
+import './chunk-G77IGC3Y.js';
+import './chunk-Z3ABLERJ.js';
+import './chunk-UULVIT25.js';
+import './chunk-3IXU7WUC.js';
+import './chunk-US5QSLPV.js';
+import './chunk-UEG2WC3G.js';

package/dist/{agentTools-SZZN6TP3.js → agentTools-5N3ZEZDW.js}

@@ -1,15 +1,16 @@
-import { nodeTitle, selectedOperationOf, paramsFromOperation, fixedParameterState } from './chunk-4YCMMBSK.js';
-import { computeAttachPosition } from './chunk-5UHAB75U.js';
-import { NODE_CONFIGS, createConfiguredNode, resolveOutputHandles, resolveInputHandles, isNodeConfigsInitialized, useFlowStore, useSaveStatusStore, autosaveAllowedFor, isFlowComplete, isNodeTypeHiddenFromPalette } from './chunk-AAIZ6S6E.js';
+import { nodeTitle, selectedOperationOf, paramsFromOperation, fixedParameterState } from './chunk-AJVU5YW6.js';
+import { computeAttachPosition } from './chunk-W5WML3OO.js';
+import { NODE_CONFIGS, createConfiguredNode, resolveOutputHandles, resolveInputHandles, isNodeConfigsInitialized, useFlowStore, useSaveStatusStore, autosaveAllowedFor, isFlowComplete, isNodeTypeHiddenFromPalette } from './chunk-3QCRKKTI.js';
 import './chunk-5375NUIO.js';
 import './chunk-JL7CASN5.js';
 import './chunk-OCJTTHTS.js';
-import './chunk-PXIFUMLA.js';
-import './chunk-6AMNEX2Y.js';
+import './chunk-AU7LACOY.js';
 import './chunk-G77IGC3Y.js';
-import './chunk-AVHBWJRY.js';
+import './chunk-Z3ABLERJ.js';
 import './chunk-UULVIT25.js';
-import './chunk-NTWG3CJX.js';
+import './chunk-3IXU7WUC.js';
+import './chunk-US5QSLPV.js';
+import './chunk-UEG2WC3G.js';
 import { defineAgentTool, AgentToolError } from '@burdenoff/fe-libs/shared/agent-tools';
 import { z } from 'zod';
 

package/dist/{chunk-NIY6R42C.js → chunk-2KUZBEWW.js}

@@ -1,13 +1,15 @@
 import { CodeEditorField, normalizeCodeLanguage } from './chunk-AASHQI77.js';
-import { asRecord, ConditionTreeBuilder, SwitchRulesEditor, casesFromRules, isStringOptionList, optionText, coerceNumber, paramsFromOperation, resolveLoadOptionsSpec, optionListValues, parseMappingValue, optionListText } from './chunk-4YCMMBSK.js';
+import { asRecord, ConditionTreeBuilder, SwitchRulesEditor, casesFromRules, isStringOptionList, optionText, coerceNumber, paramsFromOperation, resolveLoadOptionsSpec, optionListValues, parseMappingValue, optionListText } from './chunk-AJVU5YW6.js';
 import { Popover, PopoverTrigger, PopoverContent } from './chunk-GTEBQQ7J.js';
-import { isAgentNodeType, AgentDefinitionSelectField } from './chunk-VDJFTZ2H.js';
+import { AgentDefinitionSelectField } from './chunk-XFH6SLDK.js';
+import { isAgentNodeType } from './chunk-WZ3EJVS6.js';
 import { readAssertRulesSetting, rowsFromRules, normaliseAssertRules, ruleFromRow, describeAssertRuleProblem, operatorSpec, ASSERT_OPERATORS, emptyAssertRuleRow } from './chunk-JDLQ6QIB.js';
-import { useFlowStore, isParamVisible, ConnectionSelector, structuredParameterType, useRunGuard, FluidGridsContext, ExpressionEditor, formatParameterValue, parseParameterValue, useFluidGridsAnalytics, throwIfResultError, openRunQuotaUpgradePrompt, describeOperationError } from './chunk-AAIZ6S6E.js';
+import { useFlowStore, isParamVisible, ConnectionSelector, structuredParameterType, useRunGuard, FluidGridsContext, ExpressionEditor, formatParameterValue, parseParameterValue, useFluidGridsAnalytics, openRunQuotaUpgradePrompt } from './chunk-3QCRKKTI.js';
 import { useBuilderReadOnly } from './chunk-OCJTTHTS.js';
-import { useRunFromNodeEligibilityQuery, PreviewScheduleDocument, WebhookTestListenerDocument, StopWebhookTestListenerDocument, ListenForWebhookTestEventDocument } from './chunk-AVHBWJRY.js';
+import { useRunFromNodeEligibilityQuery, PreviewScheduleDocument, WebhookTestListenerDocument, StopWebhookTestListenerDocument, ListenForWebhookTestEventDocument } from './chunk-Z3ABLERJ.js';
 import { useTr } from './chunk-UULVIT25.js';
-import { getFluidGridsClientSafe, getFluidGridsClient } from './chunk-NTWG3CJX.js';
+import { getFluidGridsClientSafe, getFluidGridsClient } from './chunk-3IXU7WUC.js';
+import { throwIfResultError, describeOperationError } from './chunk-US5QSLPV.js';
 import { useId, useState, useMemo, useRef, useEffect, useContext, useCallback } from 'react';
 import { Icon } from '@iconify/react';
 import { cn } from '@burdenoff/fe-libs/utils';

package/dist/{chunk-NTWG3CJX.js → chunk-3IXU7WUC.js}

@@ -1,3 +1,4 @@
+import { createLiveTokenReader, createFluidGridsTokenRefreshLink } from './chunk-US5QSLPV.js';
 import { createHttpLink, split, ApolloClient, InMemoryCache } from '@apollo/client/core';
 import { setContext } from '@apollo/client/link/context';
 import { getMainDefinition } from '@apollo/client/utilities';
@@ -8,33 +9,43 @@ var clientInstance = null;
 function createFluidGridsClient(config) {
   const graphqlUrl = getGraphQLUrl(config.apiGatewayUrl);
   const wsUrl = graphqlUrl.replace(/^http/, "ws");
+  const readTokens = createLiveTokenReader({
+    authToken: config.authToken,
+    workspaceToken: config.workspaceToken
+  });
   const httpLink = createHttpLink({
     uri: graphqlUrl
   });
-  const authLink = setContext((_, { headers }) => ({
-    headers: {
-      ...headers,
-      ...config.authToken && { authorization: `Bearer ${config.authToken}` },
-      ...config.workspaceToken && {
-        "x-workspace-authorization": `Bearer ${config.workspaceToken}`
-      },
-      "x-workspace-id": config.workspaceId,
-      ...config.tenantId && { "x-tenant-id": config.tenantId },
-      ...config.productId && { "x-product-id": config.productId }
-    }
-  }));
-  const wsLink = new GraphQLWsLink(
-    createClient({
-      url: wsUrl,
-      connectionParams: () => ({
-        authorization: config.authToken ? `Bearer ${config.authToken}` : "",
-        ...config.workspaceToken && {
-          "x-workspace-authorization": `Bearer ${config.workspaceToken}`
+  const authLink = setContext((_, { headers }) => {
+    const { authToken, workspaceToken } = readTokens();
+    return {
+      headers: {
+        ...headers,
+        ...authToken && { authorization: `Bearer ${authToken}` },
+        ...workspaceToken && {
+          "x-workspace-authorization": `Bearer ${workspaceToken}`
         },
         "x-workspace-id": config.workspaceId,
         ...config.tenantId && { "x-tenant-id": config.tenantId },
         ...config.productId && { "x-product-id": config.productId }
-      })
+      }
+    };
+  });
+  const wsLink = new GraphQLWsLink(
+    createClient({
+      url: wsUrl,
+      connectionParams: () => {
+        const { authToken, workspaceToken } = readTokens();
+        return {
+          authorization: authToken ? `Bearer ${authToken}` : "",
+          ...workspaceToken && {
+            "x-workspace-authorization": `Bearer ${workspaceToken}`
+          },
+          "x-workspace-id": config.workspaceId,
+          ...config.tenantId && { "x-tenant-id": config.tenantId },
+          ...config.productId && { "x-product-id": config.productId }
+        };
+      }
     })
   );
   const splitLink = split(
@@ -43,7 +54,7 @@ function createFluidGridsClient(config) {
       return definition.kind === "OperationDefinition" && definition.operation === "subscription";
     },
     wsLink,
-    authLink.concat(httpLink)
+    createFluidGridsTokenRefreshLink().concat(authLink).concat(httpLink)
   );
   return new ApolloClient({
     link: splitLink,

package/dist/{chunk-AAIZ6S6E.js → chunk-3QCRKKTI.js}

@@ -1,15 +1,15 @@
 import { SdkPermissionGate, FLUIDGRIDS_PERMISSIONS } from './chunk-5375NUIO.js';
 import { useBuilderReadOnly, editorSeverity } from './chunk-OCJTTHTS.js';
-import { getGlobalStoreClient, createGlobalStoreClient, setGlobalStoreClient, resetGlobalStoreClient } from './chunk-PXIFUMLA.js';
-import { getFluidGridsConfig, validateTrustedOrigin, resetFluidGridsExecutionState, setFluidGridsConfig, resetFluidGridsConfig } from './chunk-6AMNEX2Y.js';
+import { getGlobalStoreClient, createGlobalStoreClient, setGlobalStoreClient, resetGlobalStoreClient } from './chunk-AU7LACOY.js';
 import { GetMyNodeInstallationsDocument } from './chunk-G77IGC3Y.js';
-import { fetchAllNodeEndpointConfigs, NodeManifestDocument, UpdateWorkflowDefinitionDocument, CreateWorkflowDefinitionDocument, CreateWorkflowVersionDocument, ExecuteStepDocument, TriggerWorkflowDocument, RunFromNodeDocument, ExecutionDetailDocument, WorkflowDefinitionDocument, WorkflowRunDocument } from './chunk-AVHBWJRY.js';
+import { fetchAllNodeEndpointConfigs, NodeManifestDocument, UpdateWorkflowDefinitionDocument, CreateWorkflowDefinitionDocument, CreateWorkflowVersionDocument, ExecuteStepDocument, TriggerWorkflowDocument, RunFromNodeDocument, ExecutionDetailDocument, WorkflowDefinitionDocument, WorkflowRunDocument } from './chunk-Z3ABLERJ.js';
 import { useTr, ENGLISH_FALLBACK_TRANSLATOR, FluidGridsTranslationProvider } from './chunk-UULVIT25.js';
-import { waitForFluidGridsClient, getFluidGridsClient, getFluidGridsClientSafe, createFluidGridsClient, setFluidGridsClient, resetFluidGridsClient } from './chunk-NTWG3CJX.js';
+import { waitForFluidGridsClient, getFluidGridsClient, getFluidGridsClientSafe, createFluidGridsClient, setFluidGridsClient, resetFluidGridsClient } from './chunk-3IXU7WUC.js';
+import { throwIfResultError, emitFluidGridsEvent, emitOperationErrorEvent, describeOperationError, emitRunCompletedOnce } from './chunk-US5QSLPV.js';
+import { getFluidGridsConfig, validateTrustedOrigin, resetFluidGridsExecutionState, resetFluidGridsConfig, setFluidGridsConfig } from './chunk-UEG2WC3G.js';
 import * as React from 'react';
 import { memo, forwardRef, useState, useImperativeHandle, useRef, useEffect, useMemo, createContext, useCallback, useSyncExternalStore, useContext } 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';
@@ -275,81 +275,6 @@ function usePaletteGates() {
   const context = useOptionalFeatureFlags();
   return useMemo(() => resolvePaletteGates(context), [context]);
 }
-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;
-}
-function hasForbiddenCode(errors) {
-  return (errors ?? []).some((error) => error.extensions?.code === "FORBIDDEN");
-}
-function isForbiddenError(error) {
-  if (CombinedGraphQLErrors.is(error)) {
-    return hasForbiddenCode(error.errors);
-  }
-  if (ServerError.is(error)) {
-    if (error.statusCode === 403) return true;
-    const first = firstGraphQLErrorInBody(error.bodyText);
-    return first ? hasForbiddenCode([first]) : false;
-  }
-  if (error instanceof Error && error.cause !== void 0) {
-    return isForbiddenError(error.cause);
-  }
-  return false;
-}
 
 // src/billing/quota.ts
 var RUNS_QUOTA_NAME = "fluidgrids.runs.monthly";
@@ -6358,6 +6283,9 @@ function FluidGridsProvider({
   tenantId,
   organizationId,
   t,
+  theme,
+  auth,
+  onEvent,
   workspaceClient: externalWorkspaceClient,
   globalClient: externalGlobalClient,
   apolloClient: legacyClient,
@@ -6476,21 +6404,44 @@ function FluidGridsProvider({
       resetGlobalStoreClient();
     };
   }, [globalClient]);
+  const appliedTokens = useRef(null);
+  const ownedHostHooks = useRef(/* @__PURE__ */ new Set());
+  useEffect(
+    () => () => {
+      appliedTokens.current = null;
+      ownedHostHooks.current.clear();
+      resetFluidGridsConfig();
+    },
+    []
+  );
   useEffect(() => {
-    setFluidGridsConfig({
+    const patch = {
       apiGatewayUrl,
       globalApiUrl,
-      authToken,
-      workspaceToken,
       workspaceId,
       productId: resolvedProductId,
       trustedOrigins,
       tenantId,
       organizationId
-    });
-    return () => {
-      resetFluidGridsConfig();
     };
+    const applied = appliedTokens.current;
+    if (!applied || applied.authToken !== authToken || applied.workspaceToken !== workspaceToken) {
+      patch.authToken = authToken;
+      patch.workspaceToken = workspaceToken;
+      appliedTokens.current = { authToken, workspaceToken };
+    }
+    const owned = ownedHostHooks.current;
+    const writes = (key, value) => {
+      if (value !== void 0) {
+        owned.add(key);
+        return true;
+      }
+      return owned.delete(key);
+    };
+    if (writes("theme", theme)) patch.theme = theme;
+    if (writes("auth", auth)) patch.auth = auth;
+    if (writes("onEvent", onEvent)) patch.onEvent = onEvent;
+    setFluidGridsConfig(patch);
   }, [
     apiGatewayUrl,
     globalApiUrl,
@@ -6500,7 +6451,10 @@ function FluidGridsProvider({
     resolvedProductId,
     trustedOrigins,
     tenantId,
-    organizationId
+    organizationId,
+    theme,
+    auth,
+    onEvent
   ]);
   const contextValue = useMemo(() => {
     return {
@@ -7389,6 +7343,11 @@ function useSaveWorkflow() {
         }
         if (savedDbId) {
           notifyWorkflowSaved(workflowKey);
+          emitFluidGridsEvent("workflow:saved", {
+            workflowKey,
+            version: savedVersion || void 0,
+            id: savedDbId
+          });
           const config = getFluidGridsConfig();
           if (config.onWorkflowSaved) {
             try {
@@ -7412,6 +7371,7 @@ function useSaveWorkflow() {
       } catch (error) {
         const message = error instanceof Error ? error.message : "Unknown error";
         console.error("Error saving workflow:", message);
+        emitOperationErrorEvent("workflow:save", error);
         const cause = error instanceof Error ? error.cause : void 0;
         const quotaExhausted2 = isQuotaExhaustedFailure(cause) || isQuotaExhaustedFailure(error);
         const conflict = findSaveConflict(error);
@@ -8240,6 +8200,11 @@ function useNodeExecution() {
             processNodeStates(runId, run.nodeStates);
           }
           if (TERMINAL_STATUSES.has(run.status)) {
+            emitRunCompletedOnce({
+              runId,
+              status: run.status,
+              workflowKey: run.workflowKey ?? void 0
+            });
             if (analyticsTrigger && run.status === "FAILED") {
               emitRunFailed(bus, {
                 workspaceId,
@@ -8438,6 +8403,11 @@ function useNodeExecution() {
             executionId: backendRunId,
             trigger: "test"
           });
+          emitFluidGridsEvent("run:started", {
+            runId: backendRunId,
+            workflowKey: triggerResult.workflowKey,
+            mode: "TEST"
+          });
           pollRunUpdates(backendRunId, "test");
           return { success: true, runId: backendRunId };
         }
@@ -8446,6 +8416,7 @@ function useNodeExecution() {
         return { success: false, error: "No result from trigger" };
       } catch (error) {
         console.error("[useNodeExecution] Error triggering workflow:", error);
+        emitOperationErrorEvent("run:start", error);
         const quotaExhausted = openRunQuotaUpgradePrompt(error, tr, {
           bus,
           workspaceId,
@@ -8504,6 +8475,11 @@ function useNodeExecution() {
         executionId: runId,
         trigger: "webhook"
       });
+      emitFluidGridsEvent("run:started", {
+        runId,
+        workflowKey: workflow.workflowKey || workflow.id,
+        mode: "TEST"
+      });
       pollRunUpdates(runId, "webhook");
     },
     [
@@ -8553,6 +8529,11 @@ function useNodeExecution() {
             executionId: backendRunId,
             trigger: "test"
           });
+          emitFluidGridsEvent("run:started", {
+            runId: backendRunId,
+            workflowKey: runFromNodeResult.workflowKey,
+            mode: "TEST"
+          });
           pollRunUpdates(backendRunId, "test");
           return { success: true, runId: backendRunId };
         }
@@ -8561,6 +8542,7 @@ function useNodeExecution() {
         return { success: false, error: "No result from runFromNode" };
       } catch (error) {
         console.error("[useNodeExecution] Error running from node:", error);
+        emitOperationErrorEvent("run:start", error);
         const quotaExhausted = openRunQuotaUpgradePrompt(error, tr, {
           bus,
           workspaceId,
@@ -10137,4 +10119,4 @@ function createNodeWithDefaultData(type, data) {
   return Object.assign(createNodeData(type, defaultData), data);
 }
 
-export { AUTOSAVE_DEBOUNCE_MS, AUTOSAVE_RETRY_DELAYS_MS, AVAILABLE_NODES, BILLING_PLANS_PATH, CODE_WORKFLOW_NODE_TYPE, ConnectionFormDialog, ConnectionSelector, DURABLE_FUNCTION_NODE_TYPES, EDIT_SESSION_ID, ExpressionEditor, FLUIDGRIDS_FLAGS, FLUIDGRIDS_FLAG_DEFAULTS, FluidGridsContext, FluidGridsProvider, NODES, NODES_METADATA, NODE_CONFIGS, NODE_OPERATION_DRAG_DATA_FORMAT, NODE_TYPES, NODE_TYPE_DRAG_DATA_FORMAT, NodePropertyPanel, NodeTypeIcon, PHASE_C_FLAGS_OFF, RUNS_QUOTA_NAME, RUN_CONTROL_NODE_TYPES, STICKY_NOTE_TYPE, WORKFLOWS_QUOTA_NAME, WORKFLOW_TEST_NODE_TYPES, autosaveAllowedFor, bannerOf, blankWorkflowCreateInput, buildOperationSeed, buildStickyNode, builderPathOf, canAutosave, canRenderOperationPanel, canSignalRun, changedSourceFiles, childRunIdOf, classifyCreateRefusal, clearCodeWorkflowDefinitionCache, codeBuildIdOf, components_default, createConfiguredNode, createThenOpen, declaredOutputFields, declaredSignals, defaultSourcePath, departingSave, describeOperationError, diagnosticsByPath, editStateFor, editingLeaseLocked, emitNodeInstalled, emitRunFailed, emitRunLimitHit, emitRunStarted, emitTemplateUsed, emitUpgradeClicked, emitWorkflowCreated, emitWorkflowLimitHit, emitWorkflowPublished, ensureNodeConfigsLoaded, fieldsFromIO, fieldsFromValue, filterPaletteNodes, findQuotaRefusal, findSaveConflict, forgetSessionForReload, formatParameterValue, getNodeDetail, getNodeMetadata, inAppLeaveTarget, interfaceFields, interfaceHandlers, isDurableFunctionNodeType, isEditableSourcePath, isFlowComplete, isForbiddenError, isImageIcon, isLocked, isNodeConfigsInitialized, isNodeTypeHiddenFromPalette, isParamVisible, isQuotaExhaustedFailure, isRunControlNodeType, isTriggerOperation, leaseCallQueue, leavingLosesChanges, 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, resolvePhaseCFlags, resolveUiSpec, runSignalTargets, runTriggerFromMode, saveIndicatorOf, savedEverythingBeforeLeaving, sessionBeforeReload, shouldReleaseForIdle, signalPayloadCard, sourceLanguageOf, stripSubmitActions, structuredParameterType, subscribeWorkflowSaved, synchronizeOperationUpdate, throwIfResultError, tickAction, touchesSavedFields, useAgentDefinitionList, useAgentDefinitions, useCodeWorkflowInterface, useConnection, useConnections, useConnectionsByProvider, useContinuousOptimisationEnabled, useCreateConnection, useDurableFunctionNodesEnabled, useDurableParityEnabled, useEditLeaseLocked, useEditLeaseStore, useFlowStore, useFlowValidator, useFluidGridsAnalytics, useFluidGridsContext, useFluidGridsFlag, useGuardedNavigate, useInitiateOAuth, useInsertNode, useIsValidConnection, useManualSave, useNodeExecution, useNodeRegistryRevision, usePaletteGates, usePhaseCFlags, useProviders, useRunGuard, useSaveStatusStore, useSaveWorkflow, useSelfHostedWorkersEnabled, useWorkflowTestsEnabled, watchLeavingLosesChanges, workflowFingerprint };
+export { AUTOSAVE_DEBOUNCE_MS, AUTOSAVE_RETRY_DELAYS_MS, AVAILABLE_NODES, BILLING_PLANS_PATH, CODE_WORKFLOW_NODE_TYPE, ConnectionFormDialog, ConnectionSelector, DURABLE_FUNCTION_NODE_TYPES, EDIT_SESSION_ID, ExpressionEditor, FLUIDGRIDS_FLAGS, FLUIDGRIDS_FLAG_DEFAULTS, FluidGridsContext, FluidGridsProvider, NODES, NODES_METADATA, NODE_CONFIGS, NODE_OPERATION_DRAG_DATA_FORMAT, NODE_TYPES, NODE_TYPE_DRAG_DATA_FORMAT, NodePropertyPanel, NodeTypeIcon, PHASE_C_FLAGS_OFF, RUNS_QUOTA_NAME, RUN_CONTROL_NODE_TYPES, STICKY_NOTE_TYPE, WORKFLOWS_QUOTA_NAME, WORKFLOW_TEST_NODE_TYPES, autosaveAllowedFor, bannerOf, blankWorkflowCreateInput, buildOperationSeed, buildStickyNode, builderPathOf, canAutosave, canRenderOperationPanel, canSignalRun, changedSourceFiles, childRunIdOf, classifyCreateRefusal, clearCodeWorkflowDefinitionCache, codeBuildIdOf, components_default, createConfiguredNode, createThenOpen, declaredOutputFields, declaredSignals, defaultSourcePath, departingSave, diagnosticsByPath, editStateFor, editingLeaseLocked, emitNodeInstalled, emitRunFailed, emitRunLimitHit, emitRunStarted, emitTemplateUsed, emitUpgradeClicked, emitWorkflowCreated, emitWorkflowLimitHit, emitWorkflowPublished, ensureNodeConfigsLoaded, fieldsFromIO, fieldsFromValue, filterPaletteNodes, findQuotaRefusal, findSaveConflict, forgetSessionForReload, formatParameterValue, getNodeDetail, getNodeMetadata, inAppLeaveTarget, interfaceFields, interfaceHandlers, isDurableFunctionNodeType, isEditableSourcePath, isFlowComplete, isImageIcon, isLocked, isNodeConfigsInitialized, isNodeTypeHiddenFromPalette, isParamVisible, isQuotaExhaustedFailure, isRunControlNodeType, isTriggerOperation, leaseCallQueue, leavingLosesChanges, 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, resolvePhaseCFlags, resolveUiSpec, runSignalTargets, runTriggerFromMode, saveIndicatorOf, savedEverythingBeforeLeaving, sessionBeforeReload, shouldReleaseForIdle, signalPayloadCard, sourceLanguageOf, stripSubmitActions, structuredParameterType, subscribeWorkflowSaved, synchronizeOperationUpdate, tickAction, touchesSavedFields, useAgentDefinitionList, useAgentDefinitions, useCodeWorkflowInterface, useConnection, useConnections, useConnectionsByProvider, useContinuousOptimisationEnabled, useCreateConnection, useDurableFunctionNodesEnabled, useDurableParityEnabled, useEditLeaseLocked, useEditLeaseStore, useFlowStore, useFlowValidator, useFluidGridsAnalytics, useFluidGridsContext, useFluidGridsFlag, useGuardedNavigate, useInitiateOAuth, useInsertNode, useIsValidConnection, useManualSave, useNodeExecution, useNodeRegistryRevision, usePaletteGates, usePhaseCFlags, useProviders, useRunGuard, useSaveStatusStore, useSaveWorkflow, useSelfHostedWorkersEnabled, useWorkflowTestsEnabled, watchLeavingLosesChanges, workflowFingerprint };