@burdenoff/fluidgrids-fe-sdk 2026.1111.12 → 2026.1111.14

package/dist/{WorkflowSearchRedirect-BHtdF64q.js → WorkflowSearchRedirect-C8vhSZK9.js}

@@ -1,13 +1,13 @@
 "use client";
 import { Dr as WorkflowDefinitionDocument, Oi as getFluidGridsClient, Ui as throwIfResultError, oa as __exportAll, qi as getFluidGridsConfig } from "./node-endpoint-configs-DHFGA5MQ.js";
-import { Ct as classifyCreateRefusal, Dt as useSaveStatusStore, G as paramsFromOperation, Jt as codeBuildIdOf, On as useCanvasEdges, P as createConfiguredNode, Qt as workflowFingerprint, Sn as BILLING_PLANS_PATH, Wt as rememberRevision, f as refetchStoreNodes, l as ensureNodeTypesLoaded, m as registerWorkflowNodeTypes, n as FluidGridsProvider, o as NODE_CONFIGS, p as registerNodeManifests, sn as resolveNodeOperation, xt as blankWorkflowCreateInput } from "./FluidGridsProvider-CDZjKmfD.js";
+import { At as useSaveStatusStore, Et as classifyCreateRefusal, J as paramsFromOperation, L as createConfiguredNode, Tn as BILLING_PLANS_PATH, Zt as codeBuildIdOf, g as registerWorkflowNodeTypes, h as registerNodeManifests, jn as useCanvasEdges, m as refetchStoreNodes, n as FluidGridsProvider, o as NODE_CONFIGS, qt as rememberRevision, tn as workflowFingerprint, u as ensureNodeTypesLoaded, un as resolveNodeOperation, wt as blankWorkflowCreateInput } from "./FluidGridsProvider-B30VcLdX.js";
 import { F as mergeStickyNotes, H as useFlowStore } from "./node-operation-selection--oy-yEq_.js";
 import { r as useTr } from "./TranslationBridge-Da-TPgQm.js";
-import { F as buildRequiredNodeTypes, P as buildNodeCheck, R as useInstalledNodes, dt as FluidGridsMark, ft as Card, h as useWorkflowReloadStore, m as releaseLeaseKeptForReload, t as FlowBuilderPage, ut as useNodeSelectedEvent, vt as Input } from "./flow-builder-CukxgO65.js";
+import { B as getWorkflowNodeTypes, Ct as Input, R as buildNodeCheck, U as useInstalledNodes, _t as Card, gt as FluidGridsMark, h as useWorkflowReloadStore, ht as useNodeSelectedEvent, m as releaseLeaseKeptForReload, t as FlowBuilderPage, z as buildRequiredNodeTypes } from "./flow-builder-BR8p5tXG.js";
 import { t as cn } from "./cn-QqidFIgr.js";
 import { i as Button } from "./PublishCustomNodeAction-D2F7oN0S.js";
-import { l as useLazyWorkflowDefinition, m as useWorkflowDefinition, n as useCreateWorkflow } from "./useWorkflows-Bwpvfdgv.js";
-import { O as CreateWorkflowRefusalDialog } from "./WorkflowShareDialog-ByTSWwwR.js";
+import { l as useLazyWorkflowDefinition, m as useWorkflowDefinition, n as useCreateWorkflow } from "./useWorkflows-D01LC39Y.js";
+import { O as CreateWorkflowRefusalDialog } from "./WorkflowShareDialog-DnBQA3V6.js";
 import { c as withoutGuidedTourIntent, l as decideMissingWorkflow, o as isGuidedTourIntent, s as pickGuidedTour, u as isCreateIntent } from "./firstWorkflow-C_h0KMB2.js";
 import { t as canvasFromDefinition } from "./definition-canvas--3MPHoP-.js";
 import { n as registerLiveCanvasHandler } from "./liveCanvas-D5ytXDp8.js";
@@ -1626,7 +1626,7 @@ function GuidedTourStarter({ ready }) {
 }
 
 // src/builder/app/workflow/work/page.tsx
-const LazyMissingNodesInstallModal = lazy(() => import("./MissingNodesInstallModal-YI57ImRx.js").then((m) => ({ default: m.MissingNodesInstallModal })));
+const LazyMissingNodesInstallModal = lazy(() => import("./MissingNodesInstallModal-Cj31oMDX.js").then((m) => ({ default: m.MissingNodesInstallModal })));
 function WorkflowItem({ readonly = false }) {
 	if (readonly) {
 		const queryParams = new URLSearchParams(window.location.search);
@@ -1673,7 +1673,6 @@ function WorkflowItem({ readonly = false }) {
 	const fetchedWorkflowRef = useRef(null);
 	const loadSeqRef = useRef(0);
 	const { installedAppIds } = useInstalledNodes();
-	const [pendingWorkflow, setPendingWorkflow] = useState(null);
 	const [nodeCheck, setNodeCheck] = useState(null);
 	const [configModalOpen, setConfigModalOpen] = useState(false);
 	const [installing, setInstalling] = useState(false);
@@ -1689,15 +1688,14 @@ function WorkflowItem({ readonly = false }) {
 		trRef.current = tr;
 	});
 	const handleInstallConfirm = useCallback(async () => {
-		if (!pendingWorkflow) return;
 		const nodesToInstall = (nodeCheck?.missing ?? []).filter((n) => !!n.storeProductId);
 		const failed = [];
 		if (nodesToInstall.length > 0) {
 			setInstalling(true);
 			setInstallErrors([]);
 			try {
-				const { getGlobalStoreClient } = await import("./FluidGridsProvider-CDZjKmfD.js").then((n) => n.dr);
-				const { InstallWorkflowNodeDocument } = await import("./FluidGridsProvider-CDZjKmfD.js").then((n) => n._);
+				const { getGlobalStoreClient } = await import("./FluidGridsProvider-B30VcLdX.js").then((n) => n.mr);
+				const { InstallWorkflowNodeDocument } = await import("./FluidGridsProvider-B30VcLdX.js").then((n) => n.y);
 				const { getFluidGridsConfig } = await import("./node-endpoint-configs-DHFGA5MQ.js").then((n) => n.Ki);
 				const storeClient = getGlobalStoreClient();
 				const cfg = getFluidGridsConfig();
@@ -1724,6 +1722,7 @@ function WorkflowItem({ readonly = false }) {
 					}
 				}
 				await refetchStoreNodes();
+				await ensureNodeTypesLoaded(nodesToInstall.map((n) => n.nodeType));
 			} finally {
 				setInstalling(false);
 				setInstallProgress(null);
@@ -1735,17 +1734,12 @@ function WorkflowItem({ readonly = false }) {
 		}
 		setInstallErrors([]);
 		setConfigModalOpen(false);
-		setWorkflow(pendingWorkflow);
-		setPendingWorkflow(null);
 		setNodeCheck(null);
-	}, [pendingWorkflow, nodeCheck]);
+	}, [nodeCheck]);
 	const handleSkipInstall = useCallback(() => {
-		if (!pendingWorkflow) return;
 		setConfigModalOpen(false);
-		setWorkflow(pendingWorkflow);
-		setPendingWorkflow(null);
 		setNodeCheck(null);
-	}, [pendingWorkflow]);
+	}, []);
 	const newWorkflow = useMemo(() => ({
 		id: id ?? "",
 		workflowKey: id ?? "",
@@ -1778,10 +1772,24 @@ function WorkflowItem({ readonly = false }) {
 			if (pendingReloadRef.current === target) pendingReloadRef.current = null;
 			return true;
 		};
+		const offerMissingNodes = (nodes) => {
+			buildRequiredNodeTypes(nodes).then((requiredNodeTypes) => {
+				if (!mounted || requiredNodeTypes.length === 0) return;
+				const check = doNodeCheckRef.current(requiredNodeTypes);
+				if (check.missing.length > 0 || check.missingPaid.length > 0) {
+					setNodeCheck(check);
+					setConfigModalOpen(true);
+				}
+			}).catch((error) => {
+				console.warn("[WorkflowItem] Missing-nodes check failed:", error);
+			});
+		};
 		const loadWorkflow = async () => {
 			try {
 				resetWorkflow();
 				if (mounted) setNotFound(false);
+				if (mounted) setConfigModalOpen(false);
+				if (mounted) setNodeCheck(null);
 				if (mounted) setLoadError(null);
 				if (mounted) setReloadFailed(false);
 				if (version && mounted) setIsLoading(true);
@@ -1796,26 +1804,12 @@ function WorkflowItem({ readonly = false }) {
 							nodes: manifest.nodes ?? [],
 							edges: manifest.edges ?? []
 						};
-						let requiredNodeTypes = [];
-						try {
-							requiredNodeTypes = await buildRequiredNodeTypes(sharedWorkflow.nodes);
-						} catch {}
 						if (mounted) {
 							localStorage.removeItem("pendingSharedWorkflow");
-							if (requiredNodeTypes.length > 0) {
-								const check = doNodeCheckRef.current(requiredNodeTypes);
-								if (check.missing.length > 0 || check.missingPaid.length > 0) {
-									setPendingWorkflow(sharedWorkflow);
-									setNodeCheck(check);
-									setConfigModalOpen(true);
-									setIsLoading(false);
-									fromSharedLoadedRef.current = true;
-									return;
-								}
-							}
 							setWorkflow(sharedWorkflow);
 							setIsLoading(false);
 							fromSharedLoadedRef.current = true;
+							offerMissingNodes(sharedWorkflow.nodes);
 						}
 						return;
 					} catch (e) {
@@ -1857,7 +1851,6 @@ function WorkflowItem({ readonly = false }) {
 				}
 				const freshCreate = createIntentRef.current && !creatingRef.current && !fetchedCopy() && !loadRunId;
 				const result = freshCreate ? null : await getWorkflow(id, void 0, version);
-				if (result?.nodeManifests) registerNodeManifests(result.nodeManifests);
 				const definitionJson = result?.definitionJson;
 				const defData = definitionJson?.data ?? (definitionJson?.nodes ? definitionJson : void 0);
 				if (defData) {
@@ -1874,21 +1867,11 @@ function WorkflowItem({ readonly = false }) {
 						codeBuildId: codeBuildIdOf(result?.definitionJson)
 					};
 					if (recordFetched(workflowState)) rememberRevision(result?.id, result?.revision);
-					let requiredNodeTypes = [];
-					try {
-						requiredNodeTypes = await buildRequiredNodeTypes(workflowState.nodes);
-					} catch {}
-					if (mounted && requiredNodeTypes.length > 0) {
-						const check = doNodeCheckRef.current(requiredNodeTypes);
-						if (check.missing.length > 0 || check.missingPaid.length > 0) {
-							setPendingWorkflow(workflowState);
-							setNodeCheck(check);
-							setConfigModalOpen(true);
-							setIsLoading(false);
-							return;
-						}
+					if (Array.isArray(result?.nodeManifests)) registerNodeManifests(result.nodeManifests, getWorkflowNodeTypes(workflowState.nodes));
+					if (mounted) {
+						setWorkflow(workflowState);
+						offerMissingNodes(workflowState.nodes);
 					}
-					if (mounted) setWorkflow(workflowState);
 					return;
 				}
 				if (mounted) {
@@ -2054,14 +2037,14 @@ function WorkflowItem({ readonly = false }) {
 		onBack: () => navigate("../list")
 	});
 	return /* @__PURE__ */ jsxs(Fragment, { children: [
-		configModalOpen && pendingWorkflow && /* @__PURE__ */ jsx(Suspense, {
+		configModalOpen && workflow && /* @__PURE__ */ jsx(Suspense, {
 			fallback: null,
 			children: /* @__PURE__ */ jsx(LazyMissingNodesInstallModal, {
 				open: configModalOpen,
 				onOpenChange: (open) => {
 					if (!open) handleSkipInstall();
 				},
-				workflowName: pendingWorkflow.name,
+				workflowName: workflow.name,
 				nodeCheckResult: nodeCheck,
 				onConfirm: handleInstallConfirm,
 				onSkip: handleSkipInstall,
@@ -2085,7 +2068,7 @@ function WorkflowItem({ readonly = false }) {
 		}),
 		workflow && !isLoading && /* @__PURE__ */ jsx(FlowBuilderPage, { workflow }),
 		workflow && !isLoading && /* @__PURE__ */ jsx(AssistantLiveCanvasHost, {}),
-		/* @__PURE__ */ jsx(GuidedTourStarter, { ready: Boolean(workflow && !isLoading) })
+		/* @__PURE__ */ jsx(GuidedTourStarter, { ready: Boolean(workflow && !isLoading && !configModalOpen) })
 	] });
 }
 

package/dist/{WorkflowShareDialog-ByTSWwwR.js → WorkflowShareDialog-DnBQA3V6.js}

@@ -1,6 +1,6 @@
 "use client";
 import { Bi as describeOperationError, Nn as ShareWorkflowDocument, Oi as getFluidGridsClient, Ui as throwIfResultError, ft as ExportWorkflowCodeDocument, ui as WorkflowSharingDocument } from "./node-endpoint-configs-DHFGA5MQ.js";
-import { gn as emitUpgradeClicked, ln as useFluidGridsAnalytics, vn as emitWorkflowLimitHit, wn as WORKFLOWS_QUOTA_NAME } from "./FluidGridsProvider-CDZjKmfD.js";
+import { Dn as WORKFLOWS_QUOTA_NAME, fn as useFluidGridsAnalytics, xn as emitWorkflowLimitHit, yn as emitUpgradeClicked } from "./FluidGridsProvider-B30VcLdX.js";
 import { r as useTr } from "./TranslationBridge-Da-TPgQm.js";
 import { CF as WorkflowExportFormat, Fd as FidelityLevel, JF as WorkflowShareRole, hF as WorkflowAccess, nI as WorkflowVisibility, qF as WorkflowSharePrincipalType } from "./graphql-types-XcDLtFwU.js";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";

package/dist/{WorkflowsList-B9F2e8M6.js → WorkflowsList-74jjJFsJ.js}

@@ -1,12 +1,12 @@
 "use client";
-import { c as useImportWorkflow, h as useWorkflowDefinitions, l as useLazyWorkflowDefinition, n as useCreateWorkflow, o as useDeleteWorkflow, s as useDuplicateWorkflow, u as usePreviewN8nImport } from "./useWorkflows-Bwpvfdgv.js";
-import { Bn as FLUIDGRIDS_FLAGS, Dn as isQuotaExhaustedFailure, Jn as useFluidGridsFlag, Sn as BILLING_PLANS_PATH, t as FluidGridsContext, wt as createThenOpen } from "./FluidGridsProvider-CDZjKmfD.js";
-import { C as readProjectArchive, D as workflowNameFromFile, E as typeScriptModuleFile, O as CreateWorkflowRefusalDialog, S as primaryImportModule, T as typeScriptImportSource, _ as importFileKind, a as downloadWorkflowExport, c as canShareWorkflow, d as MAX_IMPORT_ARCHIVE_BYTES, f as MAX_IMPORT_SOURCE_BYTES, g as importAcceptAttribute, k as QuotaExhaustedDialog, l as CODE_EXPORT_FORMATS, m as checkTypeScriptImport, o as parseWorkflowImport, p as assertImportByteSize, r as useExportWorkflowAs, s as canEditWorkflow, t as WorkflowShareDialog, u as ImportSourceError } from "./WorkflowShareDialog-ByTSWwwR.js";
+import { c as useImportWorkflow, h as useWorkflowDefinitions, l as useLazyWorkflowDefinition, n as useCreateWorkflow, o as useDeleteWorkflow, s as useDuplicateWorkflow, u as usePreviewN8nImport } from "./useWorkflows-D01LC39Y.js";
+import { An as isQuotaExhaustedFailure, Dt as createThenOpen, Tn as BILLING_PLANS_PATH, Un as FLUIDGRIDS_FLAGS, Zn as useFluidGridsFlag, t as FluidGridsContext } from "./FluidGridsProvider-B30VcLdX.js";
+import { C as readProjectArchive, D as workflowNameFromFile, E as typeScriptModuleFile, O as CreateWorkflowRefusalDialog, S as primaryImportModule, T as typeScriptImportSource, _ as importFileKind, a as downloadWorkflowExport, c as canShareWorkflow, d as MAX_IMPORT_ARCHIVE_BYTES, f as MAX_IMPORT_SOURCE_BYTES, g as importAcceptAttribute, k as QuotaExhaustedDialog, l as CODE_EXPORT_FORMATS, m as checkTypeScriptImport, o as parseWorkflowImport, p as assertImportByteSize, r as useExportWorkflowAs, s as canEditWorkflow, t as WorkflowShareDialog, u as ImportSourceError } from "./WorkflowShareDialog-DnBQA3V6.js";
 import { H as useFlowStore } from "./node-operation-selection--oy-yEq_.js";
 import { CF as WorkflowExportFormat, gF as WorkflowAccessFilter, hI as FLUIDGRIDS_PERMISSIONS, vI as SdkPermissionButton, xI as useFluidGridsPermission, yI as SdkPermissionGate } from "./graphql-types-XcDLtFwU.js";
 import { r as useTr } from "./TranslationBridge-Da-TPgQm.js";
 import { $t as RenameWorkflowFolderDocument, Bi as describeOperationError, Et as MoveWorkflowFolderDocument, K as DeleteWorkflowFolderDocument, M as CreateWorkflowFolderDocument, N as CreateWorkflowProjectDocument, Oi as getFluidGridsClient, Pr as WorkflowFoldersDocument, Ui as throwIfResultError, Ur as WorkflowProjectsDocument, _ as BulkMoveWorkflowsToFolderDocument, en as RenameWorkflowProjectDocument, g as BulkDeleteWorkflowsDocument, h as BulkAssignWorkflowsToProjectDocument, oa as __exportAll, q as DeleteWorkflowProjectDocument } from "./node-endpoint-configs-DHFGA5MQ.js";
-import { a as useExecutions } from "./useExecutions-BqoD7XWi.js";
+import { a as useExecutions } from "./useExecutions-CNEN1ENQ.js";
 import { a as firstWorkflowProgress, i as builderPathFor, r as GUIDED_TOUR_STATE } from "./firstWorkflow-C_h0KMB2.js";
 import { n as useFluidGridsPageControls } from "./pageControlsBridge-0pX9s-3k.js";
 import { i as workflowsListControls } from "./pageControlSpecs-DZJ9K37m.js";

package/dist/{agentTools-Dgrdql-W.js → agentTools-D5AW7zHn.js}

@@ -1,7 +1,7 @@
 "use client";
-import { Dt as useSaveStatusStore, G as paramsFromOperation, K as selectedOperationOf, P as createConfiguredNode, U as nodeTitle, V as fixedParameterState, h as registryNodeData, o as NODE_CONFIGS, u as isNodeConfigsInitialized, ut as autosaveAllowedFor, vt as isFlowComplete } from "./FluidGridsProvider-CDZjKmfD.js";
+import { At as useSaveStatusStore, J as paramsFromOperation, K as nodeTitle, L as createConfiguredNode, W as fixedParameterState, Y as selectedOperationOf, _ as registryNodeData, f as isNodeConfigsInitialized, o as NODE_CONFIGS, pt as autosaveAllowedFor, xt as isFlowComplete } from "./FluidGridsProvider-B30VcLdX.js";
 import { E as resolveOutputHandles, H as useFlowStore, T as resolveInputHandles } from "./node-operation-selection--oy-yEq_.js";
-import { M as computeAttachPosition, wt as isNodeTypeHiddenFromPalette } from "./flow-builder-CukxgO65.js";
+import { I as computeAttachPosition, kt as isNodeTypeHiddenFromPalette } from "./flow-builder-BR8p5tXG.js";
 import { AgentToolError, defineAgentTool } from "@burdenoff/fe-libs/shared/agent-tools";
 import { z } from "zod";
 

package/dist/canvasNoteTools-BqQTTCll.js

@@ -0,0 +1,136 @@
+"use client";
+import { g as notesKeyOf, v as useAgentMarksStore, y as toPlainText } from "./flow-builder-BR8p5tXG.js";
+import { J as paramsFromOperation, K as nodeTitle, Y as selectedOperationOf } from "./FluidGridsProvider-B30VcLdX.js";
+import { H as useFlowStore } from "./node-operation-selection--oy-yEq_.js";
+import { AgentToolError, defineAgentTool } from "@burdenoff/fe-libs/shared/agent-tools";
+import { z } from "zod";
+
+// src/builder/agentNotes/canvasNoteTools.ts
+const MAX_NOTES_LISTED = 20;
+function workflow() {
+	return useFlowStore.getState().workflow;
+}
+function dataOf(node) {
+	return node.data && typeof node.data === "object" ? node.data : {};
+}
+const nodeRef = z.string().trim().min(1).max(100).describe("A node id from fg_canvas_read, or the node's exact title.");
+/** A node by id, else by exact title (case-insensitive) when that is unique. */
+function resolveNode(ref) {
+	const nodes = workflow().nodes;
+	const byId = nodes.find((node) => node.id === ref);
+	if (byId) return byId;
+	const wanted = ref.toLowerCase();
+	const byTitle = nodes.filter((node) => nodeTitle(node).toLowerCase() === wanted);
+	if (byTitle.length === 1 && byTitle[0]) return byTitle[0];
+	if (byTitle.length > 1) throw new AgentToolError("INVALID_INPUT", `${byTitle.length} nodes are titled "${ref.slice(0, 40)}": ${byTitle.slice(0, 6).map((node) => node.id).join(", ")}. Use the node id.`);
+	throw new AgentToolError("NOT_FOUND", `No node "${ref.slice(0, 40)}" on the canvas. Use fg_canvas_read for ids.`, { retryable: true });
+}
+/** The parameter names a node's operation has. */
+function parameterNames(node) {
+	return paramsFromOperation(selectedOperationOf(dataOf(node), node.type)).map((parameter) => parameter.name);
+}
+function summary(note, liveIds) {
+	return {
+		number: note.number,
+		nodeId: note.nodeId,
+		node: note.nodeLabel,
+		...note.paramKey ? { param: note.paramKey } : {},
+		kind: note.kind,
+		message: toPlainText(note.message, 120),
+		resolved: note.resolved,
+		...liveIds.has(note.nodeId) ? {} : { orphaned: true }
+	};
+}
+function createCanvasNoteTools(options = {}) {
+	const focus = async (nodeId) => {
+		if (!options.focusNode) return false;
+		const done = await options.focusNode(nodeId);
+		if (done) useAgentMarksStore.getState().actions.flashNode(nodeId);
+		return done;
+	};
+	return [
+		defineAgentTool({
+			name: "fg_canvas_annotate",
+			title: "Pin a note on a node",
+			description: "Pins a numbered note on a node of the workflow open in the builder, to show the person what to change or check there (they resolve it). It does not change the workflow. Use kind fix for something they must change, info for an explanation. Name the parameter with param when the note is about one field.",
+			input: z.strictObject({
+				node: nodeRef,
+				message: z.string().trim().min(1).max(280).describe("What to do or know, in one or two plain sentences. No markdown."),
+				kind: z.enum(["fix", "info"]).default("fix").describe("fix: the person must change something; info: an explanation."),
+				param: z.string().trim().min(1).max(80).optional().describe("A parameter name of the node the note is about; an unknown one lists the valid names."),
+				focus: z.boolean().default(true).describe("Bring the node into view (default true).")
+			}),
+			annotations: {
+				readOnly: true,
+				untrustedContent: true
+			},
+			execute: async ({ node: ref, message, kind, param, focus: bringIntoView }) => {
+				const node = resolveNode(ref);
+				if (param) {
+					const names = parameterNames(node);
+					if (!names.includes(param)) throw new AgentToolError("INVALID_INPUT", names.length > 0 ? `No parameter "${param.slice(0, 40)}". Parameters: ${names.slice(0, 20).join(", ")}.` : "This node has no parameters; leave param out.");
+				}
+				const key = notesKeyOf(workflow());
+				const note = useAgentMarksStore.getState().actions.addNote({
+					workflowKey: key,
+					nodeId: node.id,
+					nodeLabel: nodeTitle(node),
+					paramKey: param ?? null,
+					kind,
+					message
+				});
+				if (!note) throw new AgentToolError("CONFLICT", `This workflow already has ${20} notes. Ask the person to resolve some, or clear them with fg_ui_clear_marks.`);
+				const focused = bringIntoView ? await focus(node.id) : false;
+				return {
+					noteNumber: note.number,
+					nodeId: node.id,
+					node: note.nodeLabel,
+					...note.paramKey ? { param: note.paramKey } : {},
+					focused
+				};
+			}
+		}),
+		defineAgentTool({
+			name: "fg_canvas_notes",
+			title: "List the notes on the canvas",
+			description: "Lists the notes you pinned on the open workflow: number, node, parameter, message, whether the person resolved it, and orphaned when its node was deleted.",
+			input: z.strictObject({}),
+			annotations: {
+				readOnly: true,
+				untrustedContent: true
+			},
+			execute: () => {
+				const current = workflow();
+				const key = notesKeyOf(current);
+				const liveIds = new Set(current.nodes.map((node) => node.id));
+				const notes = useAgentMarksStore.getState().notes.filter((note) => note.workflowKey === key);
+				return {
+					total: notes.length,
+					open: notes.filter((note) => !note.resolved).length,
+					notes: notes.slice(0, MAX_NOTES_LISTED).map((note) => summary(note, liveIds))
+				};
+			}
+		}),
+		defineAgentTool({
+			name: "fg_canvas_focus_node",
+			title: "Show a node",
+			description: "Pans and zooms the builder canvas to one node and briefly highlights it, so the person can see it. It does not change the workflow.",
+			input: z.strictObject({ node: nodeRef }),
+			annotations: {
+				readOnly: true,
+				untrustedContent: true
+			},
+			execute: async ({ node: ref }) => {
+				const node = resolveNode(ref);
+				if (!await focus(node.id)) throw new AgentToolError("CONFLICT", "The canvas is not ready yet. Try again in a moment.", { retryable: true });
+				return {
+					nodeId: node.id,
+					node: nodeTitle(node),
+					focused: true
+				};
+			}
+		})
+	];
+}
+
+export { createCanvasNoteTools };

package/dist/executions.js

@@ -1,4 +1,4 @@
 "use client";
-import { t as ExecutionDetailPage, y as ExecutionsListPage } from "./ExecutionDetailPage-CDkJeeu2.js";
+import { t as ExecutionDetailPage, y as ExecutionsListPage } from "./ExecutionDetailPage-itor_whl.js";
 
 export { ExecutionDetailPage, ExecutionsListPage };