@burdenoff/fluidgrids-fe-sdk 2026.1105.1 → 2026.1105.3

package/README.md

@@ -229,6 +229,36 @@ const register = (spec: FgPageControlsSpec) => registerWithMyAssistant(spec);
   / `TabsSpec` (fe-libs >= 2026.1004.6 `appControls`), so a host can pass them
   straight to `enumFilter` / `tabsOf`.
 
+## Read-only workflow preview (optional)
+
+`WorkflowPreviewCanvas` draws a stored workflow definition with the builder's own
+node cards, read-only, and animates it as a workflow is built live (the AI
+assistant's live preview). It needs no `FluidGridsProvider`, config, Apollo client
+or node registry, and makes no request of its own.
+
+```tsx
+import { WorkflowPreviewCanvas, previewCanvasFromDefinition, previewRevealOrder } from "@burdenoff/fluidgrids-fe-sdk/workflow-preview";
+
+<div style={{ height: 520 }}>
+  <WorkflowPreviewCanvas
+    definition={workflow.definitionJson} // object or JSON string
+    visibleNodeIds={shown}               // omit to show every node
+    freshNodeIds={justAdded}             // highlighted with a ring
+    running={assistantIsWriting}         // flow along edges, newest node pulses
+  />
+</div>
+```
+
+- The host drives the reveal: `previewRevealOrder(previewCanvasFromDefinition(def).nodes)`
+  gives the along-the-flow order. A node that becomes visible pops in, an edge
+  draws in once both ends are visible, and the camera eases to keep every
+  visible node in view (max zoom 1.5).
+- `resolveNodeMeta(nodeType)` (optional, keep it stable) supplies registry names
+  and icons; without it a card uses the node's saved manifest, then a name and
+  icon derived from its type.
+- Nodes cannot be dragged, connected, selected or deleted; pan and zoom work.
+- `prefers-reduced-motion: reduce` turns every animation off.
+
 ## Styling
 
 The SDK uses Tailwind CSS for styling. Make sure you have Tailwind configured in your project, or import the pre-built styles:

package/dist/ExecutionDetailPage-JXGPSLS3.js

@@ -0,0 +1,30 @@
+export { ExecutionDetailPage } from './chunk-3ZYRLGDF.js';
+import './chunk-2WUVF4EQ.js';
+import './chunk-MA6I4KY5.js';
+import './chunk-VESQH55Q.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-YGOGJDN4.js';
+import './chunk-PJAWNFJV.js';
+import './chunk-H4ERTSMX.js';
+import './chunk-ZBPRNWKY.js';
+import './chunk-5375NUIO.js';
+import './chunk-JL7CASN5.js';
+import './chunk-SDZEAIIE.js';
+import './chunk-5DVP2UYH.js';
+import './chunk-Y7FKJJMF.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-EV725VG5.js → ExecutionsListPage-U3TC5JUI.js}

@@ -1,20 +1,23 @@
-export { WorkflowsList } from './chunk-DANOMJ5I.js';
-import './chunk-HLAUK5GM.js';
-import './chunk-AG3VC7Y2.js';
+export { ExecutionsListPage } from './chunk-NZFPCTIS.js';
+import './chunk-MA6I4KY5.js';
+import './chunk-VESQH55Q.js';
+import './chunk-WZ3EJVS6.js';
 import './chunk-5ERAJC2I.js';
-import './chunk-O2EB7UT2.js';
+import './chunk-IL343FKX.js';
 import './chunk-FNZZ5JJL.js';
-import './chunk-HOTVUVZG.js';
+import './chunk-YGOGJDN4.js';
 import './chunk-PJAWNFJV.js';
 import './chunk-H4ERTSMX.js';
 import './chunk-4VJ3MDOV.js';
-import './chunk-C26QAWCT.js';
+import './chunk-ZBPRNWKY.js';
 import './chunk-5375NUIO.js';
 import './chunk-JL7CASN5.js';
-import './chunk-OCJTTHTS.js';
+import './chunk-SDZEAIIE.js';
+import './chunk-5DVP2UYH.js';
+import './chunk-Y7FKJJMF.js';
 import './chunk-AU7LACOY.js';
 import './chunk-G77IGC3Y.js';
-import './chunk-AVHBWJRY.js';
+import './chunk-Z3ABLERJ.js';
 import './chunk-UULVIT25.js';
 import './chunk-3IXU7WUC.js';
 import './chunk-US5QSLPV.js';

package/dist/{WorkflowBuilder-CRR5WP4V.js → WorkflowBuilder-6DOD6WWH.js}

@@ -1,31 +1,34 @@
-export { WorkflowBuilder } from './chunk-MQN6YDX4.js';
-import './chunk-HLAUK5GM.js';
+export { WorkflowBuilder } from './chunk-TLHX4DK4.js';
+import './chunk-FVWRGL7S.js';
 import './chunk-PIKYQE7P.js';
-import './chunk-I3QPAEL6.js';
+import './chunk-NMQENSPW.js';
+import './chunk-3MZOYJ5I.js';
 import './chunk-GEMNVFPK.js';
 import './chunk-B6CCE2RW.js';
 import './chunk-IEVSFCFS.js';
 import './chunk-YXMFRQYV.js';
 import './chunk-BQXVT32O.js';
-import './chunk-FJSXXO5W.js';
-import './chunk-GVIYGJQG.js';
-import './chunk-O2EB7UT2.js';
-import './chunk-6P7DOBVN.js';
+import './chunk-MY7SEUXM.js';
+import './chunk-KAWRHIJZ.js';
+import './chunk-EYQ7GJRW.js';
 import './chunk-JDLQ6QIB.js';
-import './chunk-EC2AN74G.js';
+import './chunk-IL343FKX.js';
 import './chunk-Y53CVZVV.js';
-import './chunk-4QB6S7YW.js';
-import './chunk-HOTVUVZG.js';
+import './chunk-TJAG2DQT.js';
+import './chunk-JYYN3CLL.js';
+import './chunk-YGOGJDN4.js';
 import './chunk-GLYINMOR.js';
 import './chunk-H4ERTSMX.js';
 import './chunk-4VJ3MDOV.js';
-import './chunk-C26QAWCT.js';
+import './chunk-ZBPRNWKY.js';
 import './chunk-5375NUIO.js';
 import './chunk-JL7CASN5.js';
-import './chunk-OCJTTHTS.js';
+import './chunk-SDZEAIIE.js';
+import './chunk-5DVP2UYH.js';
+import './chunk-Y7FKJJMF.js';
 import './chunk-AU7LACOY.js';
 import './chunk-G77IGC3Y.js';
-import './chunk-AVHBWJRY.js';
+import './chunk-Z3ABLERJ.js';
 import './chunk-UULVIT25.js';
 import './chunk-3IXU7WUC.js';
 import './chunk-US5QSLPV.js';

package/dist/{ExecutionsListPage-NQIQXMTY.js → WorkflowsList-XOWRQNST.js}

@@ -1,20 +1,22 @@
-export { ExecutionsListPage } from './chunk-6EZJ5J3B.js';
-import './chunk-MSQAULLG.js';
-import './chunk-AG3VC7Y2.js';
+export { WorkflowsList } from './chunk-IJ7UIDCW.js';
+import './chunk-FVWRGL7S.js';
+import './chunk-VESQH55Q.js';
 import './chunk-5ERAJC2I.js';
-import './chunk-EC2AN74G.js';
+import './chunk-KAWRHIJZ.js';
 import './chunk-FNZZ5JJL.js';
-import './chunk-HOTVUVZG.js';
+import './chunk-YGOGJDN4.js';
 import './chunk-PJAWNFJV.js';
 import './chunk-H4ERTSMX.js';
 import './chunk-4VJ3MDOV.js';
-import './chunk-C26QAWCT.js';
+import './chunk-ZBPRNWKY.js';
 import './chunk-5375NUIO.js';
 import './chunk-JL7CASN5.js';
-import './chunk-OCJTTHTS.js';
+import './chunk-SDZEAIIE.js';
+import './chunk-5DVP2UYH.js';
+import './chunk-Y7FKJJMF.js';
 import './chunk-AU7LACOY.js';
 import './chunk-G77IGC3Y.js';
-import './chunk-AVHBWJRY.js';
+import './chunk-Z3ABLERJ.js';
 import './chunk-UULVIT25.js';
 import './chunk-3IXU7WUC.js';
 import './chunk-US5QSLPV.js';

package/dist/{agentTools-PN4W7QZH.js → agentTools-YQBN33WG.js}

@@ -1,12 +1,14 @@
-import { nodeTitle, selectedOperationOf, paramsFromOperation, fixedParameterState } from './chunk-2QOAJF7V.js';
-import { computeAttachPosition } from './chunk-GVIYGJQG.js';
-import { NODE_CONFIGS, createConfiguredNode, resolveOutputHandles, resolveInputHandles, isNodeConfigsInitialized, useFlowStore, useSaveStatusStore, autosaveAllowedFor, isFlowComplete, isNodeTypeHiddenFromPalette } from './chunk-C26QAWCT.js';
+import { nodeTitle, selectedOperationOf, paramsFromOperation, fixedParameterState } from './chunk-ZLBTUCC2.js';
+import { computeAttachPosition } from './chunk-3MZOYJ5I.js';
+import { NODE_CONFIGS, createConfiguredNode, isNodeConfigsInitialized, useSaveStatusStore, autosaveAllowedFor, isFlowComplete, isNodeTypeHiddenFromPalette } from './chunk-ZBPRNWKY.js';
 import './chunk-5375NUIO.js';
 import './chunk-JL7CASN5.js';
-import './chunk-OCJTTHTS.js';
+import './chunk-SDZEAIIE.js';
+import { resolveOutputHandles, resolveInputHandles, useFlowStore } from './chunk-5DVP2UYH.js';
+import './chunk-Y7FKJJMF.js';
 import './chunk-AU7LACOY.js';
 import './chunk-G77IGC3Y.js';
-import './chunk-AVHBWJRY.js';
+import './chunk-Z3ABLERJ.js';
 import './chunk-UULVIT25.js';
 import './chunk-3IXU7WUC.js';
 import './chunk-US5QSLPV.js';

package/dist/{chunk-VFVN7D3A.js → chunk-22U3TUKZ.js}

@@ -1,4 +1,5 @@
-import { useAgentDefinitions, useAgentDefinitionList, useConnections } from './chunk-C26QAWCT.js';
+import { emptyAgentForm, agentToForm, describeRule, formToInput, AgentFormError, DEFAULT_GRANT_DAYS, MAX_GRANT_DAYS, grantDays } from './chunk-WZ3EJVS6.js';
+import { useAgentDefinitions, useAgentDefinitionList, useConnections } from './chunk-ZBPRNWKY.js';
 import { useTr } from './chunk-UULVIT25.js';
 import { describeOperationError } from './chunk-US5QSLPV.js';
 import { useState, useCallback, useEffect } from 'react';
@@ -8,97 +9,6 @@ import { Badge, Select, SelectTrigger, SelectValue, SelectContent, SelectItem, L
 import { toast } from 'sonner';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 
-// src/modules/agent-definitions/utils/agent-form.ts
-var DEFAULT_GRANT_DAYS = 30;
-var MAX_GRANT_DAYS = 365;
-var MAX_TOOL_RULES = 100;
-var MAX_CONNECTIONS = 100;
-var AgentFormError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "AgentFormError";
-  }
-};
-function emptyAgentForm() {
-  return {
-    name: "",
-    description: "",
-    tools: [{ nodeType: "", operations: "" }],
-    connectionScope: [],
-    requireToolApproval: false,
-    status: "ACTIVE"
-  };
-}
-function agentToForm(agent) {
-  return {
-    name: agent.name,
-    description: agent.description ?? "",
-    tools: agent.toolAllowlist.length > 0 ? agent.toolAllowlist.map((rule) => ({
-      nodeType: rule.nodeType,
-      operations: rule.operations.join(", ")
-    })) : [{ nodeType: "", operations: "" }],
-    connectionScope: [...agent.connectionScope],
-    requireToolApproval: agent.requireToolApproval,
-    status: agent.status
-  };
-}
-function splitOperations(value) {
-  return [
-    ...new Set(
-      value.split(",").map((operation) => operation.trim()).filter(Boolean)
-    )
-  ];
-}
-function formToInput(form) {
-  const name = form.name.trim();
-  if (name.length === 0 || name.length > 200) {
-    throw new AgentFormError("Give the agent a name of 1 to 200 characters.");
-  }
-  const description = form.description.trim();
-  if (description.length > 2e3) {
-    throw new AgentFormError(
-      "The description must be at most 2000 characters."
-    );
-  }
-  const rules = form.tools.map((row) => ({
-    nodeType: row.nodeType.trim(),
-    operations: splitOperations(row.operations)
-  })).filter((rule) => rule.nodeType.length > 0 || rule.operations.length > 0);
-  if (rules.some((rule) => rule.nodeType.length === 0)) {
-    throw new AgentFormError("Every tool rule needs a node type.");
-  }
-  if (rules.length > MAX_TOOL_RULES) {
-    throw new AgentFormError(`At most ${MAX_TOOL_RULES} tool rules.`);
-  }
-  const connectionScope = [...new Set(form.connectionScope.filter(Boolean))];
-  if (connectionScope.length > MAX_CONNECTIONS) {
-    throw new AgentFormError(`At most ${MAX_CONNECTIONS} connections.`);
-  }
-  return {
-    name,
-    description: description || null,
-    toolAllowlist: rules,
-    connectionScope,
-    requireToolApproval: form.requireToolApproval,
-    status: form.status
-  };
-}
-function grantDays(value) {
-  const days = Number(value);
-  if (!Number.isInteger(days) || days < 1 || days > MAX_GRANT_DAYS) {
-    throw new AgentFormError(
-      `A grant lasts between 1 and ${MAX_GRANT_DAYS} days.`
-    );
-  }
-  return days;
-}
-function describeRule(rule) {
-  return rule.operations.length > 0 ? `${rule.nodeType}: ${rule.operations.join(", ")}` : `${rule.nodeType}: any operation`;
-}
-function isAgentNodeType(nodeType) {
-  if (!nodeType) return false;
-  return nodeType === "store/ai-agent" || nodeType.includes("store/ai-agent");
-}
 function errorMessage(err) {
   if (err instanceof AgentFormError) return err.message;
   return describeOperationError(err);
@@ -588,4 +498,4 @@ function AgentDefinitionSelectField({
   );
 }
 
-export { AgentDefinitionSelectField, AgentsTab, isAgentNodeType };
+export { AgentDefinitionSelectField, AgentsTab };

package/dist/{chunk-XLI75E3D.js → chunk-2WUVF4EQ.js}

@@ -1,5 +1,5 @@
-import { signalPayloadCard, components_default, payloadFromCardValues, parseRawSignalPayload } from './chunk-C26QAWCT.js';
-import { TerminateWorkflowRunDocument, WorkflowRunHistoryDocument, RunEventAppendedDocument, DurableRunFieldsDocument, WorkflowRunDeterminismStatusDocument, WorkflowRunStackTraceDocument, SignalWorkflowRunDocument } from './chunk-AVHBWJRY.js';
+import { signalPayloadCard, components_default, payloadFromCardValues, parseRawSignalPayload } from './chunk-ZBPRNWKY.js';
+import { TerminateWorkflowRunDocument, WorkflowRunHistoryDocument, RunEventAppendedDocument, DurableRunFieldsDocument, WorkflowRunDeterminismStatusDocument, WorkflowRunStackTraceDocument, SignalWorkflowRunDocument } from './chunk-Z3ABLERJ.js';
 import { useTr } from './chunk-UULVIT25.js';
 import { getFluidGridsClient, getFluidGridsClientSafe } from './chunk-3IXU7WUC.js';
 import { throwIfResultError, describeOperationError } from './chunk-US5QSLPV.js';

package/dist/{chunk-GVIYGJQG.js → chunk-3MZOYJ5I.js}

@@ -1,4 +1,4 @@
-import { resolveInputHandles } from './chunk-C26QAWCT.js';
+import { resolveInputHandles } from './chunk-5DVP2UYH.js';
 
 // src/builder/hooks/attach-node-helpers.ts
 var ATTACH_GAP_X = 120;