@burdenoff/fluidgrids-fe-sdk 2026.1111.13 → 2026.1111.15

package/README.md

@@ -270,6 +270,47 @@ import {
 - Nodes cannot be dragged, connected, selected or deleted; pan and zoom work.
 - `prefers-reduced-motion: reduce` turns every animation off.
 
+## Starting the builder's data early (optional)
+
+On a cold load of a builder address the builder's own code takes a while to
+arrive. A host can start the builder's read as soon as it knows the route and the
+person's workspace token, and the builder takes the answer when it opens instead
+of asking again. `./workflow-route` imports nothing else from the SDK, so it can
+sit on the host's entry.
+
+```ts
+import {
+  matchWorkflowBuilderRoute,
+  prefetchWorkflowForBuilder,
+} from "@burdenoff/fluidgrids-fe-sdk/workflow-route";
+
+const route = matchWorkflowBuilderRoute(location.pathname, "/workflows");
+if (route && workspaceId && workspaceToken) {
+  prefetchWorkflowForBuilder({
+    ...route,
+    workspaceId, // the builder takes the read only for the same workspace
+    // The host's own GraphQL fetch with the person's tokens. Send it on its own
+    // request: a batch window would give back what starting early gains.
+    request: ({ operationName, query, variables }) =>
+      hostGraphqlFetch({ operationName, query, variables, batch: false }),
+  });
+}
+```
+
+- A read is handed to the builder once, for the same workspace, workflow key and
+  version, and only within 15 seconds of its start (`PREFETCHED_WORKFLOW_TTL_MS`).
+- A read that fails, answers with errors or answers for another workflow is not
+  used: the builder sends its own read and reports the problem as before.
+- Without a started read the builder sends its read itself, on its own request
+  (`context: { sendUnbatched: true }`), so a batching host client does not hold it.
+
+## Agent tools (optional)
+
+`./agent-tools` carries FluidGrids' AI agent tools (`createFluidGridsAgentTools`)
+and the assistant's point-at tools and callouts (`createUiMarkTools`,
+`AgentCalloutOverlay`) without the rest of the SDK, for a shell that mounts them on
+every page. The main entry still exports them.
+
 ## 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-CDkJeeu2.js → ExecutionDetailPage-DO38vZ_F.js}

@@ -1,10 +1,10 @@
 "use client";
 import { $r as WorkflowRunMetadataDocument, A as CreateWorkerTokenDocument, An as SetWorkerTokenConnectionAllowlistDocument, Bi as describeOperationError, Gn as TaskQueuesDocument, Mn as SetWorkflowRunVersioningOverrideDocument, Oi as getFluidGridsClient, Sn as RunLogsDocument, Sr as WorkflowBatchOperationUpdatedDocument, U as DeleteTaskQueueDocument, Ui as throwIfResultError, W as DeleteWorkerTokenDocument, Wn as TaskQueueStatsDocument, Xr as WorkflowRunHierarchyDocument, aa as useExecutionsStore, bn as RunLogAppendedDocument, c as AgentTraceDocument, dn as RotateWorkerTokenDocument, dt as ExplainRunDocument, ei as WorkflowRunPendingDocument, fn as RunAiUsageDocument, hr as WorkerTokensDocument, ia as DEFAULT_EXECUTIONS_FILTER, k as CreateTaskQueueDocument, ki as getFluidGridsClientSafe, nt as DurableParityRunFieldsDocument, oa as __exportAll, or as UpdateTaskQueueDocument, qi as getFluidGridsConfig, ri as WorkflowRunsCountDocument, s as AgentStepUpdatedDocument, wi as WorkflowWorkersDocument } from "./node-endpoint-configs-DHFGA5MQ.js";
-import { $n as useWorkflowTestsEnabled, Fn as durableInterfaceOf, Kn as useDurableFunctionNodesEnabled, Nn as canSignalRun, Rn as runSignalTargets, Zn as usePhaseCFlags, en as formatElapsedMs, nn as runDurationMs, qn as useDurableParityEnabled, tn as nodeStateDurationMs } from "./FluidGridsProvider-CDZjKmfD.js";
+import { Ln as usePhaseCFlags, Mn as useDurableFunctionNodesEnabled, Nn as useDurableParityEnabled, an as runDurationMs, in as nodeStateDurationMs, rn as formatElapsedMs, wn as runSignalTargets, xn as durableInterfaceOf, yn as canSignalRun, zn as useWorkflowTestsEnabled } from "./FluidGridsProvider-B9RR_CI_.js";
 import { r as useTr } from "./TranslationBridge-Da-TPgQm.js";
-import { h as useWorkflowDefinitions, v as useWorkflowVersions } from "./useWorkflows-Bwpvfdgv.js";
+import { h as useWorkflowDefinitions, v as useWorkflowVersions } from "./useWorkflows-DyhtoVwp.js";
 import { $u as ErrorType, L as AgentStepKind, LF as WorkflowQueryRejectCondition, RF as WorkflowResetType, bF as WorkflowBatchOperationType, hI as FLUIDGRIDS_PERMISSIONS, tI as WorkflowUpdateWaitFor, vI as SdkPermissionButton, xI as useFluidGridsPermission, yP as VersioningBehavior } from "./graphql-types-XcDLtFwU.js";
-import { _ as statusCountFilter, c as OPERATORS_BY_TYPE, d as STATUS_COUNT_GROUP_BY, f as callbackTone, g as shortRunId, h as runChainLinks, i as useExecutionStats, l as buildSearchAttributeFilter, m as parseMetadataDefinition, n as useExecution, o as useExecutionsWithStore, p as overrideRequestOf, r as useExecutionActions, s as EMPTY_SEARCH_FILTER, t as useAutoRefresh, u as searchFilterConflicts, v as statusCountsOf, y as validateDateRange } from "./useExecutions-BqoD7XWi.js";
+import { _ as statusCountFilter, c as OPERATORS_BY_TYPE, d as STATUS_COUNT_GROUP_BY, f as callbackTone, g as shortRunId, h as runChainLinks, i as useExecutionStats, l as buildSearchAttributeFilter, m as parseMetadataDefinition, n as useExecution, o as useExecutionsWithStore, p as overrideRequestOf, r as useExecutionActions, s as EMPTY_SEARCH_FILTER, t as useAutoRefresh, u as searchFilterConflicts, v as statusCountsOf, y as validateDateRange } from "./useExecutions-DkS0FTfw.js";
 import { n as useFluidGridsPageControls } from "./pageControlsBridge-0pX9s-3k.js";
 import { t as executionsControls } from "./pageControlSpecs-DZJ9K37m.js";
 import { t as FluidGridsDocsLink } from "./FluidGridsDocsLink-JxkBpOeb.js";
@@ -13,7 +13,7 @@ import { C as useAvailableTags, _ as buildNodeDisplayMap, b as EntityTagPicker,
 import { t as AiCreditBalanceSlot } from "./aiCreditsBridge-BuE92tKo.js";
 import { a as fetchRunFailureClusters, i as dismissRunFailureCluster, o as runListFilterFromSearch, r as OPEN_STATUSES, s as runListLinkKey, t as BUCKET_LABELS } from "./FailureTriagePanel-BHiduL7A.js";
 import { a as encodedPayloadBytes, f as EffectBadge, h as useRunPolicyDecisions, i as decodePayloads, l as formatBudgetUsd, n as checkCodecServerUrl, o as isEncodedPayload, r as containsEncodedPayload, t as CodecServerError } from "./codec-client-DstqyzTN.js";
-import { a as useDurableRunFields, i as useDeterminismStatus, n as SignalRunDialog, o as useRunStackTrace, r as terminateDurableRun, s as RunHistoryView, t as useRunHistory } from "./useRunHistory-CEL-CIz-.js";
+import { a as useDurableRunFields, i as useDeterminismStatus, n as SignalRunDialog, o as useRunStackTrace, r as terminateDurableRun, s as RunHistoryView, t as useRunHistory } from "./useRunHistory-DHehG09Z.js";
 import { a as formatTokens, d as formatMicroUsd, o as modelLabel, r as aiCost } from "./ai-usage-D5p7ZeRR.js";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Link, useNavigate, useParams, useSearchParams } from "react-router";