@foresthubai/workflow-builder 0.4.4 → 0.4.5

package/src/graph/CustomEdge.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { Tooltip, TooltipContent, TooltipTrigger } from "../components/ui/tooltip";
 import { BaseEdge, EdgeLabelRenderer, getBezierPath, Position, useEdges } from "@xyflow/react";
 import { AlertTriangle } from "lucide-react";
@@ -6,7 +10,7 @@ import { useEffect, useMemo } from "react";
 import { useAvailableVariables } from "../hooks/useAvailableVariables";
 import { useDiagnosticsStore } from "../stores/diagnosticsStore";
 import { useEditorStore } from "../stores/editorStore";
-import { isReadOnly } from "../WorkflowBuilder";
+import { isReadOnly } from "../mode";
 import { computeEdgeDiagnostics } from "@foresthubai/workflow-core/diagnostics";
 
 const EDGE_BASE_COLOR = "hsl(var(--edge-default))";

package/src/graph/CustomNode.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { NodeData, NodeRegistry } from "@foresthubai/workflow-core/node";
 import { NodeProps } from "@xyflow/react";
 import { memo, useMemo } from "react";

package/src/graph/FunctionCallNode.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { FunctionCallNode as DomainFunctionCallNode } from "@foresthubai/workflow-core/node";
 import { NodeProps } from "@xyflow/react";
 import { memo, useMemo } from "react";

package/src/graph/PortHandle.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import React from "react";
 import { Handle, Position } from "@xyflow/react";
 import { Plus } from "lucide-react";

package/src/graph/reactFlowRegistry.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 // ReactFlow node/edge type registries
 // Maps ReactFlow type strings to the React components that render them.
 // Shared between CanvasArea (editor) and VersionPreviewCanvas (read-only preview).

package/src/hooks/use-toast.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 // Standard shadcn toast hook + dispatcher
 import * as React from "react";
 

package/src/hooks/useAvailableVariables.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useMemo } from "react";
 import { getOrCreateCanvasStore, MAIN_CANVAS_ID } from "../stores/canvasStore";
 import { computeAvailableVariables } from "@foresthubai/workflow-core/variable";

package/src/hooks/useCanvasHistory.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { getOrCreateCanvasStore, MAIN_CANVAS_ID } from "../stores/canvasStore";
 
 /**

package/src/hooks/useCanvasTabs.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useState, useCallback, useEffect } from "react";
 import { MAIN_CANVAS_ID } from "../stores/canvasStore";
 import { useEditorStore } from "../stores/editorStore";

package/src/hooks/useFunctionDiagnosticsSync.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useEffect } from "react";
 import { validateFunction } from "@foresthubai/workflow-core/diagnostics";
 import { computeAvailableVariables } from "@foresthubai/workflow-core/variable";

package/src/hooks/useFunctionRegistry.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useCallback, useMemo } from "react";
 import { useEditorStore } from "../stores/editorStore";
 import type { FunctionDeclaration } from "@foresthubai/workflow-core/function";

package/src/hooks/useFunctions.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useCallback } from "react";
 import { useEditorStore } from "../stores/editorStore";
 import { getOrCreateCanvasStore } from "../stores/canvasStore";

package/src/hooks/useGraph.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { NodeDefinition, NodeData } from "@foresthubai/workflow-core/node";
 import { Connection, Edge, Node } from "@xyflow/react";
 import type { EdgeData } from "@foresthubai/workflow-core/edge";

package/src/hooks/useNodeDefinitions.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useMemo, useCallback } from "react";
 import i18n from "../i18n";
 import { NodeCategory, NodeRegistry, NodeDefinition, NodeData } from "@foresthubai/workflow-core/node";

package/src/hooks/useParamErrors.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useMemo } from "react";
 import type { Diagnostic } from "@foresthubai/workflow-core/diagnostics";
 

package/src/hooks/useResolvedTheme.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useEffect, useState } from "react";
 
 /**

package/src/hooks/useResourceDiagnosticsSync.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useEffect } from "react";
 import { useEditorStore } from "../stores/editorStore";
 import { useDiagnosticsStore } from "../stores/diagnosticsStore";

package/src/hooks/useSuppressThemeTransition.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useEffect, useLayoutEffect } from "react";
 
 import { useResolvedTheme } from "./useResolvedTheme";

package/src/hooks/useWorkflowSerialization.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useCallback } from "react";
 import { serialize, deserialize, type ApiWorkflow, type Workflow, type Canvas } from "@foresthubai/workflow-core/workflow";
 import { migrate } from "@foresthubai/workflow-core/migration";

package/src/i18n/index.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import i18next, { type i18n as I18n } from "i18next";
 
 import de from "./locales/de.json";

package/src/index.ts

@@ -1,9 +1,13 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 // Main component + its contract
 export { WorkflowBuilder } from "./WorkflowBuilder";
 export type { WorkflowBuilderProps, WorkflowBuilderHandle } from "./WorkflowBuilder";
 
 // Editor mode the embedder constructs and passes via setMode / initialMode
-export type { BuilderMode } from "./WorkflowBuilder";
+export type { BuilderMode } from "./mode";
 
 // Debug phase the embedder pushes from the engine via setDebugPhase
 export type { DebugSessionPhase } from "./stores/debugStore";

package/src/inputs/ExpressionInput.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useState, useRef, useEffect, useCallback, useMemo } from "react";
 import { useTranslation } from "react-i18next";
 import { NodeRegistry } from "@foresthubai/workflow-core/node";

package/src/inputs/ParameterEditor.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { Input } from "../components/ui/input";
 import { Textarea } from "../components/ui/textarea";
 import { Label } from "../components/ui/label";

package/src/inputs/PortSection.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import type { ReactNode } from "react";
 import { Button } from "../components/ui/button";
 import { Input } from "../components/ui/input";

package/src/mode.ts

@@ -0,0 +1,15 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
+// Leaf module on purpose: BuilderMode is consumed across the whole tree
+// (panels, graph, stores), so it must not live in WorkflowBuilder.tsx —
+// importing it from there creates module cycles back through the root.
+
+/** BuilderMode steers the overall behavior of the workflow builder. */
+export type BuilderMode = { type: "edit" } | { type: "preview" } | { type: "debug" };
+
+/** True when canvas mutations should be blocked (preview or debug). */
+export function isReadOnly(mode: BuilderMode): boolean {
+  return mode.type !== "edit";
+}

package/src/panels/BuilderSidebar.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { Button } from "../components/ui/button";
 import { ScrollArea } from "../components/ui/scroll-area";
 import { Tooltip, TooltipContent, TooltipTrigger } from "../components/ui/tooltip";

package/src/panels/ChannelConfigPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useTranslation } from "react-i18next";
 import { CHANNEL_DEFINITION, type Channel, type ChannelType } from "@foresthubai/workflow-core/channel";
 import { isParameterActive, type Parameter } from "@foresthubai/workflow-core/parameter";

package/src/panels/ChannelsPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useTranslation } from "react-i18next";
 import { Cpu, Plus } from "lucide-react";
 import { useDiagnosticsStore } from "../stores/diagnosticsStore";

package/src/panels/DebugConsolePanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { Button } from "../components/ui/button";
 import { ScrollArea } from "../components/ui/scroll-area";
 import { Trash2 } from "lucide-react";

package/src/panels/DebugContextPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { Input } from "../components/ui/input";
 import { Label } from "../components/ui/label";
 import { Switch } from "../components/ui/switch";

package/src/panels/DebugExternalIOPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { Button } from "../components/ui/button";
 import { Input } from "../components/ui/input";
 import { Label } from "../components/ui/label";

package/src/panels/DiagnosticsPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useState } from "react";
 import { useTranslation } from "react-i18next";
 import { Badge } from "../components/ui/badge";

package/src/panels/EdgeConfigPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useCallback } from "react";
 import { useTranslation } from "react-i18next";
 import { Button } from "../components/ui/button";
@@ -7,7 +11,7 @@ import { getEdgeDefinition } from "@foresthubai/workflow-core/edge";
 import type { EdgeData, EdgeType } from "@foresthubai/workflow-core/edge";
 import ParameterEditor from "../inputs/ParameterEditor";
 import { useEditorStore } from "../stores/editorStore";
-import { isReadOnly } from "../WorkflowBuilder";
+import { isReadOnly } from "../mode";
 import { useDiagnosticsStore } from "../stores/diagnosticsStore";
 import { useParamErrors } from "../hooks/useParamErrors";
 import { ReadOnlyBanner } from "../components/ui/readonly-banner";

package/src/panels/FunctionConfigPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useEffect, useMemo, useState } from "react";
 import { useTranslation } from "react-i18next";
 import { Button } from "../components/ui/button";
@@ -16,7 +20,7 @@ import { ChevronRight } from "lucide-react";
 import type { FunctionDeclaration } from "@foresthubai/workflow-core/function";
 import { useEditorStore } from "../stores/editorStore";
 import { useDiagnosticsStore } from "../stores/diagnosticsStore";
-import { isReadOnly } from "../WorkflowBuilder";
+import { isReadOnly } from "../mode";
 import { ReadOnlyBanner } from "../components/ui/readonly-banner";
 import { DeleteButton } from "../components/ui/delete-button";
 import { PortSection } from "../inputs/PortSection";

package/src/panels/FunctionListPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useTranslation } from "react-i18next";
 import { FunctionSquare, Plus } from "lucide-react";
 import { useDiagnosticsStore } from "../stores/diagnosticsStore";

package/src/panels/MemoryConfigPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useTranslation } from "react-i18next";
 import { MemoryRegistry, type Memory } from "@foresthubai/workflow-core/memory";
 import { useEditorStore } from "../stores/editorStore";

package/src/panels/MemoryPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useTranslation } from "react-i18next";
 import { Database, FileText } from "lucide-react";
 import type { MemoryType } from "@foresthubai/workflow-core/memory";

package/src/panels/ModelConfigPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useTranslation } from "react-i18next";
 import { ModelRegistry, type Model } from "@foresthubai/workflow-core/model";
 import { useDiagnosticsStore } from "../stores/diagnosticsStore";

package/src/panels/ModelsPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useTranslation } from "react-i18next";
 import { BrainCircuit, Plus } from "lucide-react";
 import { useDiagnosticsStore } from "../stores/diagnosticsStore";

package/src/panels/NodeConfigPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { Button } from "../components/ui/button";
 import { AddButton } from "../components/ui/add-button";
 import { ReadOnlyBanner } from "../components/ui/readonly-banner";
@@ -33,7 +37,7 @@ import { useFunctionRegistry } from "../hooks/useFunctionRegistry";
 import { useParamErrors } from "../hooks/useParamErrors";
 import { buildFunctionNodeDef } from "../hooks/useNodeDefinitions";
 import { useEditorStore } from "../stores/editorStore";
-import { isReadOnly } from "../WorkflowBuilder";
+import { isReadOnly } from "../mode";
 import { migrateFunctionCallNodes } from "../utils/migrateFunctionNodes";
 import { getNodeDescription } from "../utils/translation";
 import { useAvailableVariables } from "../hooks/useAvailableVariables";

package/src/panels/NodeLibrary.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { Badge } from "../components/ui/badge";
 import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "../components/ui/collapsible";
 import { Input } from "../components/ui/input";
@@ -13,7 +17,7 @@ import { useTranslation } from "react-i18next";
 import { NodeDefinition } from "@foresthubai/workflow-core/node";
 import { categoryIcons, categoryColors } from "../utils/categoryConstants";
 import { useEditorStore } from "../stores/editorStore";
-import { isReadOnly } from "../WorkflowBuilder";
+import { isReadOnly } from "../mode";
 import { FunctionNodeDefinition } from "@foresthubai/workflow-core/node";
 import { Parameter } from "@foresthubai/workflow-core/parameter";
 import { getNodeDescription } from "../utils/translation";

package/src/panels/ResourceConfigPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useEffect, useState, type ReactNode } from "react";
 import { Button } from "../components/ui/button";
 import { Separator } from "../components/ui/separator";
@@ -7,7 +11,7 @@ import type { Diagnostic } from "@foresthubai/workflow-core/diagnostics";
 import ParameterEditor from "../inputs/ParameterEditor";
 import { MAIN_CANVAS_ID } from "../stores/canvasStore";
 import { useEditorStore } from "../stores/editorStore";
-import { isReadOnly } from "../WorkflowBuilder";
+import { isReadOnly } from "../mode";
 import { useParamErrors } from "../hooks/useParamErrors";
 import { ReadOnlyBanner } from "../components/ui/readonly-banner";
 import { DeleteButton } from "../components/ui/delete-button";

package/src/panels/ResourceListPanel.tsx

@@ -1,8 +1,12 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { AlertTriangle, type LucideIcon } from "lucide-react";
 import { AddButton } from "../components/ui/add-button";
 import { cn } from "../cn";
 import { useEditorStore } from "../stores/editorStore";
-import { isReadOnly } from "../WorkflowBuilder";
+import { isReadOnly } from "../mode";
 import type { Diagnostic } from "@foresthubai/workflow-core/diagnostics";
 
 interface ResourceListItem {

package/src/panels/VariableConfigPanel.tsx

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { useEffect, useState } from "react";
 import { useTranslation } from "react-i18next";
 import { Button } from "../components/ui/button";
@@ -8,7 +12,7 @@ import { ChevronRight } from "lucide-react";
 import type { DeclaredVariable } from "@foresthubai/workflow-core/variable";
 import type { DataType } from "@foresthubai/workflow-core";
 import { useEditorStore } from "../stores/editorStore";
-import { isReadOnly } from "../WorkflowBuilder";
+import { isReadOnly } from "../mode";
 import { ReadOnlyBanner } from "../components/ui/readonly-banner";
 import { DeleteButton } from "../components/ui/delete-button";
 import { deleteDeclaredVariable, setDeclaredVariableType, updateDeclaredVariable } from "../utils/variableOperations";

package/src/panels/VariablesPanel.tsx

@@ -1,10 +1,14 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import React from "react";
 import { useTranslation } from "react-i18next";
 import { AddButton } from "../components/ui/add-button";
 import { Variable as VariableIcon } from "lucide-react";
 import { cn } from "../cn";
 import { useEditorStore } from "../stores/editorStore";
-import { isReadOnly } from "../WorkflowBuilder";
+import { isReadOnly } from "../mode";
 import { useAvailableVariables } from "../hooks/useAvailableVariables";
 import { getOrCreateCanvasStore, MAIN_CANVAS_ID } from "../stores/canvasStore";
 import { type Variable, type DeclaredVariable } from "@foresthubai/workflow-core/variable";

package/src/stores/canvasStore.test.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { afterEach, describe, expect, it } from "vitest";
 import {
   clearAllCanvasStores,

package/src/stores/canvasStore.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { create, UseBoundStore, StoreApi } from "zustand";
 import { Node, Edge, Viewport } from "@xyflow/react";
 import { NodeCategory, type NodeData } from "@foresthubai/workflow-core/node";

package/src/stores/debugStore.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { create } from "zustand";
 
 // ---------------------------------------------------------------------------

package/src/stores/diagnosticsStore.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 /**
  * diagnosticsStore.ts
  *

package/src/stores/editorStore.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { create } from "zustand";
 import { getCanvasStore, getOrCreateCanvasStore, MAIN_CANVAS_ID } from "./canvasStore";
 import type { Channel } from "@foresthubai/workflow-core/channel";
@@ -5,7 +9,7 @@ import type { Memory } from "@foresthubai/workflow-core/memory";
 import type { Model, ModelInfo } from "@foresthubai/workflow-core/model";
 import type { FunctionDeclaration } from "@foresthubai/workflow-core/function";
 
-import type { BuilderMode } from "../WorkflowBuilder";
+import type { BuilderMode } from "../mode";
 // Type-only (erased) — the active left-sidebar tab lives here so non-sidebar code
 // (e.g. validation navigation) can open a specific panel. No runtime cycle.
 import type { SidebarTab } from "../panels/BuilderSidebar";

package/src/utils/categoryConstants.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 // Shared category icons and colors for node categories in the workflow builder.
 
 import { NodeCategory } from "@foresthubai/workflow-core/node";

package/src/utils/channelOperations.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 import { CHANNEL_DEFINITION, type ChannelType, type Channel } from "@foresthubai/workflow-core/channel";
 import { isParameterActive } from "@foresthubai/workflow-core/parameter";
 import { useEditorStore } from "../stores/editorStore";

package/src/utils/connectionRules.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
 // Editor connection rules — which ports may connect, which node types are
 // offered from a port, and whether a node can take another outgoing edge.
 //
@@ -33,24 +37,23 @@ function hasControlFlowEdge(nodeId: string, nodeData: NodeData, edges: Edge[]):
 /**
  * Check whether an output port can accept at least one more outgoing edge.
  * Used by the contextual "+" button on output ports.
+ * Takes the node's own data rather than the nodes array so per-node components
+ * (BaseNode) can call it without subscribing to all nodes.
  */
-export function canPortAcceptEdge(nodeId: string, handleId: string, nodes: Node<NodeData>[], edges: Edge[]): boolean {
-  const node = nodes.find((n) => n.id === nodeId);
-  if (!node) return false;
-
-  const ports = getPorts(node.data);
+export function canPortAcceptEdge(nodeData: NodeData, handleId: string, edges: Edge[]): boolean {
+  const ports = getPorts(nodeData);
   const port = ports.output.find((p) => p.id === handleId);
   if (!port) return false;
 
   // Tool output ports always accept multiple edges (an agent wires up many tools).
   // A control output port accepts a single edge unless the node can branch.
-  if (port.type === "control" && !NodeRegistry.getByType(node.data.type)?.canBranch) {
-    if (edges.some((e) => e.source === nodeId && e.sourceHandle === handleId)) return false;
+  if (port.type === "control" && !NodeRegistry.getByType(nodeData.type)?.canBranch) {
+    if (edges.some((e) => e.source === nodeData.id && e.sourceHandle === handleId)) return false;
   }
 
   // Mutual exclusion: control output blocked when node has tool-input edges
   // (Tool output is exempt — never blocked)
-  if (port.type === "control" && hasToolInputEdge(nodeId, node.data, edges)) return false;
+  if (port.type === "control" && hasToolInputEdge(nodeData.id, nodeData, edges)) return false;
 
   return true;
 }
@@ -107,7 +110,7 @@ export const isValidConnection = (
   if (!srcNode || !tgtNode) return false;
 
   // Source-side checks via canPortAcceptEdge (multiple-outgoing + mutual exclusion)
-  if (!canPortAcceptEdge(sourceId, sourceHandleId, nodes, edges)) return false;
+  if (!canPortAcceptEdge(srcNode.data, sourceHandleId, edges)) return false;
 
   // Get ports using centralized dispatcher
   const sourcePorts = getPorts(srcNode.data);