@burdenoff/fluidgrids-fe-sdk 2026.1028.13 → 2026.1028.14

package/dist/{ExecutionDetailPage-7MGOMYP6.js → ExecutionDetailPage-DBUUJRDA.js}

@@ -1,11 +1,12 @@
-export { ExecutionDetailPage } from './chunk-REDNZ462.js';
+export { ExecutionDetailPage } from './chunk-5GTYHWI5.js';
 import './chunk-BMX4T263.js';
 import './chunk-5PSRTFKK.js';
 import './chunk-37HLOFQ3.js';
 import './chunk-2PC6JUR6.js';
 import './chunk-5ERAJC2I.js';
-import './chunk-7SPZBRP2.js';
+import './chunk-S3GSHZAT.js';
 import './chunk-6T5EBO7G.js';
+import './chunk-Y53CVZVV.js';
 import './chunk-D3UWK7GY.js';
 import './chunk-PJAWNFJV.js';
 import './chunk-DOPSPCO3.js';

package/dist/{WorkflowBuilder-TZ2Y3SYJ.js → WorkflowBuilder-SY4UJ6C2.js}

@@ -1,13 +1,14 @@
-export { WorkflowBuilder } from './chunk-CCMDFFBC.js';
+export { WorkflowBuilder } from './chunk-6EOFGYLJ.js';
 import './chunk-TWRWHIMY.js';
-import './chunk-EA4EIU6Y.js';
+import './chunk-MXIFE266.js';
 import './chunk-GEMNVFPK.js';
 import './chunk-IEVSFCFS.js';
 import './chunk-YXMFRQYV.js';
 import './chunk-BQXVT32O.js';
 import './chunk-QLBQDRQZ.js';
-import './chunk-7SPZBRP2.js';
+import './chunk-S3GSHZAT.js';
 import './chunk-6T5EBO7G.js';
+import './chunk-Y53CVZVV.js';
 import './chunk-U5BSQBUC.js';
 import './chunk-DOPSPCO3.js';
 import './chunk-HKNZ7MVM.js';

package/dist/assistant.d.ts

@@ -1,87 +1,50 @@
-import { FC, ReactNode } from 'react';
+export { F as FgEnumFilterSpec, a as FgFilterOption, b as FgPageControlsSpec, c as FgRegisterPageControls, d as FgTabsSpec, e as FluidGridsAssistantBridge, f as FluidGridsAssistantBridgeProps, u as useFluidGridsPageControls } from './pageControlsBridge-D6y36qi5.js';
+import { FC, ComponentType, ReactNode } from 'react';
 
 /**
- * Assistant page-controls bridge (BOFF-8679 / BOFF-8988, P3).
+ * AI-credit balance bridge (BOFF-3732).
  *
- * The pages in this SDK can tell a host's assistant which controls they show
- * right now (tabs, filters, search), so a typed or spoken "show failed runs"
- * does exactly what a click on the page's own Status dropdown does.
+ * AI Studio surfaces (the builder's "Generate with AI" panel and the run
+ * detail's AI assistant) show the workspace's remaining FluidGrids AI credits
+ * before an action, and tell the host when an action may have spent some.
  *
- * The SDK deliberately does NOT import `@burdenoff/fe-libs/shared/assistant/*`:
- * many consumers pin an older fe-libs, and a runtime import would raise their
- * floor. Instead the host mounts {@link FluidGridsAssistantBridge} with a
- * `register` function (the host maps a spec onto its own assistant), and the
- * pages call {@link useFluidGridsPageControls}. The types below are structural
- * mirrors of the fe-libs `TabsSpec` / `EnumFilterSpec`, so a host can pass a
- * spec straight into `tabsOf` / `enumFilter` with no conversion.
+ * Like the page-controls bridge, the SDK does NOT import
+ * `@burdenoff/fe-libs/shared/assistant`: many consumers pin an older fe-libs,
+ * and embedders have no shell to read a balance from. Instead:
+ * - the host mounts {@link FluidGridsAiCreditsBridge} with a `Balance`
+ *   component (the fluidgrids-app passes the shared fe-libs `AiCreditBalance`
+ *   bound to `fluidgrids`), and the SDK renders it where an AI action starts;
+ * - after an AI action settles the SDK dispatches the shared
+ *   `fluidgrids:ai-credits-updated` window event (the same name fe-libs'
+ *   `notifyAiCreditsUpdated("fluidgrids")` uses), so every balance on screen,
+ *   the assistant panel's included, reads again.
  *
- * Contract:
- * - No provider mounted: every hook call is a no-op (the SDK works unchanged).
- * - A spec describes ONLY what the page shows on screen at this moment; a page
- *   passes `null` while it shows no toolbar.
- * - Every `set` is the page's own state setter (the one its dropdown calls).
- *   There is no submit, save, create, delete, run or retry in a spec.
- * - Pass a memoised spec; a new object every render re-registers every render.
+ * No provider mounted: the slot renders nothing and the SDK works unchanged.
  */
 
-/** One option of an enum filter, in the page's own words. */
-interface FgFilterOption {
-    value: string;
-    label: string;
+/** Props the SDK passes to the host's balance component. */
+interface FgAiCreditBalanceProps {
+    /** Layout classes from the mount point. */
+    className?: string;
+    /** Distinguishes the mounts in tests and in Playwright checks. */
+    testId?: string;
 }
-/** A single-choice filter (a dropdown or a chip group). */
-interface FgEnumFilterSpec {
-    id: string;
-    /** The filter's own name on the page ("Status"). */
-    label: string;
-    /**
-     * The options the page offers. The NEUTRAL one ("All") must be included so
-     * the host can clear the filter; the host does not list it as a choice.
-     */
-    options: readonly FgFilterOption[];
-    /** The value that means "no filter". */
-    neutral: string;
-    /** The value applied now. */
-    value: string;
-    /** The page's own setter. */
-    set(value: string): void;
-}
-interface FgTabsSpec {
-    items: readonly {
-        id: string;
-        label: string;
-    }[];
-    /** The tab shown now. */
-    value: string;
-    /** The page's own setter. */
-    set(id: string): void;
-}
-interface FgPageControlsSpec {
-    /** The page's title in the product's words ("Workflows"). */
-    page: string;
-    tabs?: FgTabsSpec;
-    filters?: readonly FgEnumFilterSpec[];
-    /** The page's own search setter; `""` clears the search. */
-    search?(query: string): void;
-}
-/** Registers a page's controls; the returned function removes exactly that registration. */
-type FgRegisterPageControls = (spec: FgPageControlsSpec) => () => void;
-interface FluidGridsAssistantBridgeProps {
-    /**
-     * The host's registration function. Give it a STABLE identity (a module
-     * constant or `useCallback`): a new function every render re-registers the
-     * mounted page every render.
-     */
-    register: FgRegisterPageControls;
+/** The product key FluidGrids AI credits are charged under. */
+declare const FLUIDGRIDS_AI_PRODUCT_KEY = "fluidgrids";
+/** Window event a balance listens to; mirrors fe-libs `aiCreditsUpdatedEventName`. */
+declare const FLUIDGRIDS_AI_CREDITS_UPDATED_EVENT = "fluidgrids:ai-credits-updated";
+interface FluidGridsAiCreditsBridgeProps {
+    /** Renders the remaining balance; renders nothing when it is unknown. */
+    Balance: ComponentType<FgAiCreditBalanceProps>;
     children: ReactNode;
 }
-/** Context provider a host mounts around the FluidGrids routes. */
-declare const FluidGridsAssistantBridge: FC<FluidGridsAssistantBridgeProps>;
+declare const FluidGridsAiCreditsBridge: FC<FluidGridsAiCreditsBridgeProps>;
+/** Where an AI action starts: the host's balance, or nothing without a bridge. */
+declare const AiCreditBalanceSlot: FC<FgAiCreditBalanceProps>;
 /**
- * Register a page's controls for as long as the calling component is mounted
- * (and `spec` is non-null). With no {@link FluidGridsAssistantBridge} above,
- * this does nothing.
+ * Tell every balance on screen that an AI action settled and may have spent
+ * credits. Safe outside a browser and without a bridge (nothing listens).
  */
-declare function useFluidGridsPageControls(spec: FgPageControlsSpec | null): void;
+declare function notifyFluidGridsAiCreditsUpdated(): void;
 
-export { type FgEnumFilterSpec, type FgFilterOption, type FgPageControlsSpec, type FgRegisterPageControls, type FgTabsSpec, FluidGridsAssistantBridge, type FluidGridsAssistantBridgeProps, useFluidGridsPageControls };
+export { AiCreditBalanceSlot, FLUIDGRIDS_AI_CREDITS_UPDATED_EVENT, FLUIDGRIDS_AI_PRODUCT_KEY, type FgAiCreditBalanceProps, FluidGridsAiCreditsBridge, type FluidGridsAiCreditsBridgeProps, notifyFluidGridsAiCreditsUpdated };

package/dist/assistant.js

@@ -1,2 +1,3 @@
+export { AiCreditBalanceSlot, FLUIDGRIDS_AI_CREDITS_UPDATED_EVENT, FLUIDGRIDS_AI_PRODUCT_KEY, FluidGridsAiCreditsBridge, notifyFluidGridsAiCreditsUpdated } from './chunk-Y53CVZVV.js';
 export { FluidGridsAssistantBridge, useFluidGridsPageControls } from './chunk-PJAWNFJV.js';
 import './chunk-62GWEYJ5.js';

package/dist/{chunk-REDNZ462.js → chunk-5GTYHWI5.js}

@@ -2,7 +2,8 @@ import { buildNodeDisplayMap, ExecutionStatusBadge, formatRunVersion, NodeTimeli
 import { useExecution, useExecutionActions, useAutoRefresh } from './chunk-5PSRTFKK.js';
 import { fetchRunFailureClusters, OPEN_STATUSES, dismissRunFailureCluster, BUCKET_LABELS } from './chunk-37HLOFQ3.js';
 import { useRunPolicyDecisions, RunPolicyDecisions } from './chunk-2PC6JUR6.js';
-import { EntityTagPicker, useWorkflowProposal, WorkflowProposalCard } from './chunk-7SPZBRP2.js';
+import { EntityTagPicker, useWorkflowProposal, WorkflowProposalCard } from './chunk-S3GSHZAT.js';
+import { AiCreditBalanceSlot } from './chunk-Y53CVZVV.js';
 import { throwIfResultError, useFluidGridsPermission, FLUIDGRIDS_PERMISSIONS } from './chunk-DV7N3UXU.js';
 import { getFluidGridsConfig } from './chunk-CY6KX4RG.js';
 import { RunLogsDocument, RunLogAppendedDocument, ExplainRunDocument } from './chunk-7PBOU7JC.js';
@@ -898,6 +899,9 @@ function RunAiAssistPanel({
             )
           ] })
         ] }),
+        canPropose && // BOFF-3732: the AI-credit balance before "Propose a fix" (the
+        // explanation is a read with no model call, so it spends nothing).
+        /* @__PURE__ */ jsx(AiCreditBalanceSlot, { className: "mt-2", testId: "run-ai-credit-balance" }),
         explainError && /* @__PURE__ */ jsx("p", { className: "mt-3 text-sm text-[var(--color-status-error-text)]", children: explainError }),
         explanation && /* @__PURE__ */ jsxs("div", { className: "mt-3 space-y-2", "data-testid": "run-ai-explanation", children: [
           /* @__PURE__ */ jsx("p", { className: "text-sm text-text-primary", children: explanation.cause }),

package/dist/{chunk-7SZLEQ5G.js → chunk-5KUVIH7Y.js}

@@ -1,4 +1,4 @@
-import { Card, FluidGridsMark } from './chunk-EA4EIU6Y.js';
+import { Card, FluidGridsMark } from './chunk-MXIFE266.js';
 import { Input } from './chunk-IEVSFCFS.js';
 import { Button } from './chunk-BQXVT32O.js';
 import { useWorkflowDefinition } from './chunk-U5BSQBUC.js';

package/dist/{chunk-CCMDFFBC.js → chunk-6EOFGYLJ.js}

@@ -1,5 +1,5 @@
 import { isGuidedTourIntent, pickGuidedTour, withoutGuidedTourIntent, isCreateIntent, CreateWorkflowRefusalDialog, decideMissingWorkflow } from './chunk-TWRWHIMY.js';
-import { useInstalledNodes, buildNodeCheck, FlowBuilderPage, buildRequiredNodeTypes } from './chunk-EA4EIU6Y.js';
+import { useInstalledNodes, buildNodeCheck, FlowBuilderPage, buildRequiredNodeTypes } from './chunk-MXIFE266.js';
 import { useLazyWorkflowDefinition, useCreateWorkflow } from './chunk-U5BSQBUC.js';
 import { useFlowStore, refetchStoreNodes, BILLING_PLANS_PATH, mergeStickyNotes, blankWorkflowCreateInput, classifyCreateRefusal } from './chunk-DV7N3UXU.js';
 import { useTr } from './chunk-UULVIT25.js';

package/dist/{chunk-KLAS43OH.js → chunk-7UHXZOZ3.js}

@@ -1,4 +1,4 @@
-import { useImportWorkflowTemplate, FlowBuilderPage, useWorkflowTemplates, TemplateCard } from './chunk-EA4EIU6Y.js';
+import { useImportWorkflowTemplate, FlowBuilderPage, useWorkflowTemplates, TemplateCard } from './chunk-MXIFE266.js';
 import { QuotaExhaustedDialog } from './chunk-QLBQDRQZ.js';
 import { useWorkflowDefinitions, useDuplicateWorkflow } from './chunk-U5BSQBUC.js';
 import { templatesControls } from './chunk-D3UWK7GY.js';

package/dist/{chunk-EA4EIU6Y.js → chunk-MXIFE266.js}

@@ -3,7 +3,8 @@ import { Input } 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-YXMFRQYV.js';
 import { Badge as Badge$1, Button } from './chunk-BQXVT32O.js';
 import { QuotaExhaustedDialog, useWorkflowCodeExport, orderedExportFiles, fileBaseName, downloadWorkflowCodeExport, isLosslessReport, sortFidelityItems, isLossyFidelityItem, lineOfNode } from './chunk-QLBQDRQZ.js';
-import { EntityTagPicker, useWorkflowProposal, WorkflowProposalCard } from './chunk-7SPZBRP2.js';
+import { EntityTagPicker, useWorkflowProposal, WorkflowProposalCard } from './chunk-S3GSHZAT.js';
+import { AiCreditBalanceSlot } from './chunk-Y53CVZVV.js';
 import { useRestoreWorkflowVersion, useWorkflowVersions, useActivateWorkflow, useDeleteWorkflow, useLazyWorkflowDefinition, useDeactivateWorkflow } from './chunk-U5BSQBUC.js';
 import { isAgentNodeType, AgentDefinitionSelectField } from './chunk-HKNZ7MVM.js';
 import { FluidGridsDocsLink } from './chunk-4VJ3MDOV.js';
@@ -45021,6 +45022,7 @@ function AiDraftPanel({
                   )
                 }
               ),
+              /* @__PURE__ */ jsx(AiCreditBalanceSlot, { testId: "ai-draft-credit-balance" }),
               /* @__PURE__ */ jsxs("div", { className: "flex gap-2", children: [
                 /* @__PURE__ */ jsxs(
                   Button$1,

package/dist/{chunk-7SPZBRP2.js → chunk-S3GSHZAT.js}

@@ -1,4 +1,5 @@
 import { useEntityTags, useTagEntity, useUntagEntity } from './chunk-6T5EBO7G.js';
+import { notifyFluidGridsAiCreditsUpdated } from './chunk-Y53CVZVV.js';
 import { throwIfResultError } from './chunk-DV7N3UXU.js';
 import { getFluidGridsConfig } from './chunk-CY6KX4RG.js';
 import { WorkflowProposalDocument, ProposeRunFixDocument, ProposeWorkflowChangeDocument, ApplyWorkflowProposalDocument, RejectWorkflowProposalDocument, CancelWorkflowProposalDocument } from './chunk-7PBOU7JC.js';
@@ -191,6 +192,8 @@ function useWorkflowProposal() {
             return;
           }
           setTimedOut(true);
+        } else {
+          notifyFluidGridsAiCreditsUpdated();
         }
         setIsWorking(false);
       } catch (pollError) {

package/dist/chunk-Y53CVZVV.js

@@ -0,0 +1,20 @@
+import { createContext, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+var FLUIDGRIDS_AI_PRODUCT_KEY = "fluidgrids";
+var FLUIDGRIDS_AI_CREDITS_UPDATED_EVENT = `${FLUIDGRIDS_AI_PRODUCT_KEY}:ai-credits-updated`;
+var BalanceContext = createContext(null);
+var FluidGridsAiCreditsBridge = ({
+  Balance,
+  children
+}) => /* @__PURE__ */ jsx(BalanceContext.Provider, { value: Balance, children });
+var AiCreditBalanceSlot = (props) => {
+  const Balance = useContext(BalanceContext);
+  return Balance ? /* @__PURE__ */ jsx(Balance, { ...props }) : null;
+};
+function notifyFluidGridsAiCreditsUpdated() {
+  if (typeof window === "undefined") return;
+  window.dispatchEvent(new CustomEvent(FLUIDGRIDS_AI_CREDITS_UPDATED_EVENT));
+}
+
+export { AiCreditBalanceSlot, FLUIDGRIDS_AI_CREDITS_UPDATED_EVENT, FLUIDGRIDS_AI_PRODUCT_KEY, FluidGridsAiCreditsBridge, notifyFluidGridsAiCreditsUpdated };

package/dist/executions.js

@@ -1,13 +1,14 @@
 import './chunk-AD3BXTJS.js';
 export { ExecutionsListPage } from './chunk-H2YOX3DI.js';
-export { ExecutionDetailPage } from './chunk-REDNZ462.js';
+export { ExecutionDetailPage } from './chunk-5GTYHWI5.js';
 import './chunk-BMX4T263.js';
 import './chunk-5PSRTFKK.js';
 import './chunk-37HLOFQ3.js';
 import './chunk-2PC6JUR6.js';
 import './chunk-5ERAJC2I.js';
-import './chunk-7SPZBRP2.js';
+import './chunk-S3GSHZAT.js';
 import './chunk-6T5EBO7G.js';
+import './chunk-Y53CVZVV.js';
 import './chunk-U5BSQBUC.js';
 import './chunk-D3UWK7GY.js';
 import './chunk-PJAWNFJV.js';

package/dist/index.d.ts

@@ -32,7 +32,7 @@ import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
 import * as SwitchPrimitives from '@radix-ui/react-switch';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
 import { ClassValue } from 'clsx';
-export { FgEnumFilterSpec, FgFilterOption, FgPageControlsSpec, FgRegisterPageControls, FgTabsSpec, FluidGridsAssistantBridge, FluidGridsAssistantBridgeProps, useFluidGridsPageControls } from './assistant.js';
+export { F as FgEnumFilterSpec, a as FgFilterOption, b as FgPageControlsSpec, c as FgRegisterPageControls, d as FgTabsSpec, e as FluidGridsAssistantBridge, f as FluidGridsAssistantBridgeProps, u as useFluidGridsPageControls } from './pageControlsBridge-D6y36qi5.js';
 import { AnyDefinedAgentTool } from '@burdenoff/fe-libs/shared/agent-tools';
 import 'zustand';
 

package/dist/index.js

@@ -1,12 +1,12 @@
 export { Label } from './chunk-VTQVPNUQ.js';
-export { WorkflowBuilder, WorkflowBuilderCore, WorkflowSearchRedirect } from './chunk-7SZLEQ5G.js';
-export { GuidedTourStarter, WorkflowBuilder as WorkflowBuilderPage } from './chunk-CCMDFFBC.js';
+export { WorkflowBuilder, WorkflowBuilderCore, WorkflowSearchRedirect } from './chunk-5KUVIH7Y.js';
+export { GuidedTourStarter, WorkflowBuilder as WorkflowBuilderPage } from './chunk-6EOFGYLJ.js';
 export { FirstWorkflowChecklist, FirstWorkflowChecklistView, WorkflowsList, useCreateWorkflowFirst } from './chunk-7UTDL7HD.js';
 export { CreateWorkflowRefusalDialog, GUIDED_FIRST_WORKFLOW_NAV, GUIDED_FIRST_WORKFLOW_STATE, GUIDED_TOUR_STATE, firstWorkflowProgress, isGuidedTourIntent, pickGuidedTour } from './chunk-TWRWHIMY.js';
 import './chunk-AD3BXTJS.js';
 export { ExecutionsListPage } from './chunk-H2YOX3DI.js';
-import { usePendingHumanRequests, HumanRequestCard } from './chunk-REDNZ462.js';
-export { ExecutionDetailPage, HumanRequestCard, RunHumanRequests, usePendingHumanRequests, useRespondToHumanRequest, useRunHumanRequests } from './chunk-REDNZ462.js';
+import { usePendingHumanRequests, HumanRequestCard } from './chunk-5GTYHWI5.js';
+export { ExecutionDetailPage, HumanRequestCard, RunHumanRequests, usePendingHumanRequests, useRespondToHumanRequest, useRunHumanRequests } from './chunk-5GTYHWI5.js';
 import { TagFilterSelect } from './chunk-BMX4T263.js';
 import './chunk-5PSRTFKK.js';
 export { HistoryPage } from './chunk-5BY2LZH3.js';
@@ -17,19 +17,20 @@ export { SettingsPage } from './chunk-KWWVBB43.js';
 import './chunk-2PC6JUR6.js';
 export { useDataSinkData, useDataSinks, useInsightsData, useLogStreamDestinationActions, useLogStreamDestinations, useRunReplayActions } from './chunk-TEMQVTTJ.js';
 import './chunk-5ERAJC2I.js';
-import { ThemeProvider, extractTemplateGraph } from './chunk-KLAS43OH.js';
-export { TemplatePreview, TemplatesPage } from './chunk-KLAS43OH.js';
-import { external_exports, FlowBuilderPage, FluidGridsMark, useRunners, useRunnerActions, RunnerStatusPill, runnerInstallCommand } from './chunk-EA4EIU6Y.js';
-export { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Popover, PopoverContent, PopoverTrigger, RUNNER_INSTALL_SCRIPT_URL, RunOnSection, RunnerStatusPill, RunsUsageMeter, RunsUsageMeterView, readRunsQuota, runnerInstallCommand, runsQuotaLevel, summarizeRunsQuota, useRunnerActions, useRunners, useRunsQuota } from './chunk-EA4EIU6Y.js';
+import { ThemeProvider, extractTemplateGraph } from './chunk-7UHXZOZ3.js';
+export { TemplatePreview, TemplatesPage } from './chunk-7UHXZOZ3.js';
+import { external_exports, FlowBuilderPage, FluidGridsMark, useRunners, useRunnerActions, RunnerStatusPill, runnerInstallCommand } from './chunk-MXIFE266.js';
+export { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Popover, PopoverContent, PopoverTrigger, RUNNER_INSTALL_SCRIPT_URL, RunOnSection, RunnerStatusPill, RunsUsageMeter, RunsUsageMeterView, readRunsQuota, runnerInstallCommand, runsQuotaLevel, summarizeRunsQuota, useRunnerActions, useRunners, useRunsQuota } from './chunk-MXIFE266.js';
 import './chunk-GEMNVFPK.js';
 export { Input } from './chunk-IEVSFCFS.js';
 export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger } from './chunk-YXMFRQYV.js';
 export { Badge, Button, badgeVariants, buttonVariants } from './chunk-BQXVT32O.js';
 import './chunk-QLBQDRQZ.js';
-import { EntityTagPicker } from './chunk-7SPZBRP2.js';
-export { EntityTagPicker } from './chunk-7SPZBRP2.js';
+import { EntityTagPicker } from './chunk-S3GSHZAT.js';
+export { EntityTagPicker } from './chunk-S3GSHZAT.js';
 import { useDataTableTagOverlay, tagLabel } from './chunk-6T5EBO7G.js';
 export { FLUIDGRIDS_ENTITY_TYPES, tagLabel, useAvailableTags, useCreateTag, useDraftEntityTags, useEntityTags, useReplaceEntityTags, useSearchTags, useTagEntity, useUntagEntity } from './chunk-6T5EBO7G.js';
+import './chunk-Y53CVZVV.js';
 export { useActivateWorkflow, useCreateWorkflow, useCreateWorkflowVersion, useDashboardSummary, useDeactivateWorkflow, useDeleteWorkflow, useDuplicateWorkflow, useImportWorkflow, useLazyWorkflowDefinition, useRestoreWorkflowVersion, useTriggerWorkflow, useUpdateWorkflow, useWorkflowDefinition, useWorkflowDefinitions, useWorkflowRun, useWorkflowRuns, useWorkflowVersions } from './chunk-U5BSQBUC.js';
 import './chunk-D3UWK7GY.js';
 export { FluidGridsAssistantBridge, useFluidGridsPageControls } from './chunk-PJAWNFJV.js';
@@ -77,7 +78,7 @@ var WorkflowsList2 = lazy(
   () => import('./WorkflowsList-GJF2HTSA.js').then((m) => ({ default: m.WorkflowsList }))
 );
 var WorkflowBuilder3 = lazy(
-  () => import('./WorkflowBuilder-TZ2Y3SYJ.js').then((m) => ({
+  () => import('./WorkflowBuilder-SY4UJ6C2.js').then((m) => ({
     default: m.WorkflowBuilder
   }))
 );
@@ -87,7 +88,7 @@ var ExecutionsListPage2 = lazy(
   }))
 );
 var ExecutionDetailPage2 = lazy(
-  () => import('./ExecutionDetailPage-7MGOMYP6.js').then((m) => ({
+  () => import('./ExecutionDetailPage-DBUUJRDA.js').then((m) => ({
     default: m.ExecutionDetailPage
   }))
 );

package/dist/pageControlsBridge-D6y36qi5.d.ts

@@ -0,0 +1,87 @@
+import { FC, ReactNode } from 'react';
+
+/**
+ * Assistant page-controls bridge (BOFF-8679 / BOFF-8988, P3).
+ *
+ * The pages in this SDK can tell a host's assistant which controls they show
+ * right now (tabs, filters, search), so a typed or spoken "show failed runs"
+ * does exactly what a click on the page's own Status dropdown does.
+ *
+ * The SDK deliberately does NOT import `@burdenoff/fe-libs/shared/assistant/*`:
+ * many consumers pin an older fe-libs, and a runtime import would raise their
+ * floor. Instead the host mounts {@link FluidGridsAssistantBridge} with a
+ * `register` function (the host maps a spec onto its own assistant), and the
+ * pages call {@link useFluidGridsPageControls}. The types below are structural
+ * mirrors of the fe-libs `TabsSpec` / `EnumFilterSpec`, so a host can pass a
+ * spec straight into `tabsOf` / `enumFilter` with no conversion.
+ *
+ * Contract:
+ * - No provider mounted: every hook call is a no-op (the SDK works unchanged).
+ * - A spec describes ONLY what the page shows on screen at this moment; a page
+ *   passes `null` while it shows no toolbar.
+ * - Every `set` is the page's own state setter (the one its dropdown calls).
+ *   There is no submit, save, create, delete, run or retry in a spec.
+ * - Pass a memoised spec; a new object every render re-registers every render.
+ */
+
+/** One option of an enum filter, in the page's own words. */
+interface FgFilterOption {
+    value: string;
+    label: string;
+}
+/** A single-choice filter (a dropdown or a chip group). */
+interface FgEnumFilterSpec {
+    id: string;
+    /** The filter's own name on the page ("Status"). */
+    label: string;
+    /**
+     * The options the page offers. The NEUTRAL one ("All") must be included so
+     * the host can clear the filter; the host does not list it as a choice.
+     */
+    options: readonly FgFilterOption[];
+    /** The value that means "no filter". */
+    neutral: string;
+    /** The value applied now. */
+    value: string;
+    /** The page's own setter. */
+    set(value: string): void;
+}
+interface FgTabsSpec {
+    items: readonly {
+        id: string;
+        label: string;
+    }[];
+    /** The tab shown now. */
+    value: string;
+    /** The page's own setter. */
+    set(id: string): void;
+}
+interface FgPageControlsSpec {
+    /** The page's title in the product's words ("Workflows"). */
+    page: string;
+    tabs?: FgTabsSpec;
+    filters?: readonly FgEnumFilterSpec[];
+    /** The page's own search setter; `""` clears the search. */
+    search?(query: string): void;
+}
+/** Registers a page's controls; the returned function removes exactly that registration. */
+type FgRegisterPageControls = (spec: FgPageControlsSpec) => () => void;
+interface FluidGridsAssistantBridgeProps {
+    /**
+     * The host's registration function. Give it a STABLE identity (a module
+     * constant or `useCallback`): a new function every render re-registers the
+     * mounted page every render.
+     */
+    register: FgRegisterPageControls;
+    children: ReactNode;
+}
+/** Context provider a host mounts around the FluidGrids routes. */
+declare const FluidGridsAssistantBridge: FC<FluidGridsAssistantBridgeProps>;
+/**
+ * Register a page's controls for as long as the calling component is mounted
+ * (and `spec` is non-null). With no {@link FluidGridsAssistantBridge} above,
+ * this does nothing.
+ */
+declare function useFluidGridsPageControls(spec: FgPageControlsSpec | null): void;
+
+export { type FgEnumFilterSpec as F, type FgFilterOption as a, type FgPageControlsSpec as b, type FgRegisterPageControls as c, type FgTabsSpec as d, FluidGridsAssistantBridge as e, type FluidGridsAssistantBridgeProps as f, useFluidGridsPageControls as u };

package/dist/templates.js

@@ -1,12 +1,13 @@
-export { TemplatePreview, TemplatesPage } from './chunk-KLAS43OH.js';
-import './chunk-EA4EIU6Y.js';
+export { TemplatePreview, TemplatesPage } from './chunk-7UHXZOZ3.js';
+import './chunk-MXIFE266.js';
 import './chunk-GEMNVFPK.js';
 import './chunk-IEVSFCFS.js';
 import './chunk-YXMFRQYV.js';
 import './chunk-BQXVT32O.js';
 import './chunk-QLBQDRQZ.js';
-import './chunk-7SPZBRP2.js';
+import './chunk-S3GSHZAT.js';
 import './chunk-6T5EBO7G.js';
+import './chunk-Y53CVZVV.js';
 import './chunk-U5BSQBUC.js';
 import './chunk-D3UWK7GY.js';
 import './chunk-PJAWNFJV.js';

package/dist/workflow-builder.js

@@ -1,14 +1,15 @@
-export { WorkflowBuilder, WorkflowBuilderCore, WorkflowSearchRedirect } from './chunk-7SZLEQ5G.js';
-export { WorkflowBuilder as WorkflowBuilderPage } from './chunk-CCMDFFBC.js';
+export { WorkflowBuilder, WorkflowBuilderCore, WorkflowSearchRedirect } from './chunk-5KUVIH7Y.js';
+export { WorkflowBuilder as WorkflowBuilderPage } from './chunk-6EOFGYLJ.js';
 import './chunk-TWRWHIMY.js';
-import './chunk-EA4EIU6Y.js';
+import './chunk-MXIFE266.js';
 import './chunk-GEMNVFPK.js';
 import './chunk-IEVSFCFS.js';
 import './chunk-YXMFRQYV.js';
 import './chunk-BQXVT32O.js';
 import './chunk-QLBQDRQZ.js';
-import './chunk-7SPZBRP2.js';
+import './chunk-S3GSHZAT.js';
 import './chunk-6T5EBO7G.js';
+import './chunk-Y53CVZVV.js';
 import './chunk-U5BSQBUC.js';
 import './chunk-DOPSPCO3.js';
 import './chunk-HKNZ7MVM.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/fluidgrids-fe-sdk",
-  "version": "2026.1028.13",
+  "version": "2026.1028.14",
   "description": "FluidGrids Workflow Builder SDK - Embeddable visual workflow automation",
   "type": "module",
   "imports": {