@flowdrop/flowdrop 1.4.0 → 1.5.0

package/dist/helpers/workflowEditorHelper.js

@@ -2,8 +2,7 @@
  * Workflow Editor Helper
  * Contains business logic for workflow operations
  */
-import { MarkerType } from "@xyflow/svelte";
-import { hasCycles, hasInvalidCycles, isLoopbackEdge, } from "../utils/connections.js";
+import { hasCycles, hasInvalidCycles, } from "../utils/connections.js";
 import { workflowApi, nodeApi, setEndpointConfig } from "../services/api.js";
 import { v4 as uuidv4 } from "uuid";
 import { workflowActions } from "../stores/workflowStore.svelte.js";
@@ -12,231 +11,35 @@ import { WorkflowAdapter } from "../adapters/WorkflowAdapter.js";
 import { AgentSpecAdapter } from "../adapters/agentspec/AgentSpecAdapter.js";
 import { validateForAgentSpecExport } from "../adapters/agentspec/validator.js";
 import { extractPortId } from "../utils/handleIds.js";
-import { EDGE_MARKER_SIZES } from "../config/constants.js";
 import { logger } from "../utils/logger.js";
+import { generateNodeId, extractConfigDefaults } from "../utils/nodeIds.js";
+import { applyConnectionStyling as applyConnectionStylingUtil, updateEdgeStyles as updateEdgeStylesUtil, isGatewayBranch as isGatewayBranchUtil, getPortDataType as getPortDataTypeUtil, getEdgeCategory as getEdgeCategoryUtil, getEdgeCategoryWithLoopback as getEdgeCategoryWithLoopbackUtil, } from "../utils/edgeStyling.js";
+export { generateNodeId, extractConfigDefaults } from "../utils/nodeIds.js";
 /**
- * Generate a unique node ID based on node type and existing nodes
- * Format: <node_type>.<number>
- * Example: boolean_gateway.1, calculator.2
- */
-export function generateNodeId(nodeTypeId, existingNodes) {
-    // Count how many nodes of this type already exist
-    const existingNodeIds = existingNodes
-        .filter((node) => node.data?.metadata?.id === nodeTypeId)
-        .map((node) => node.id);
-    // Extract the numbers from existing IDs with the same prefix
-    const existingNumbers = existingNodeIds
-        .map((id) => {
-        const match = id.match(new RegExp(`^${nodeTypeId}\\.(\\d+)$`));
-        return match ? parseInt(match[1], 10) : 0;
-    })
-        .filter((num) => num > 0);
-    // Find the next available number (highest + 1)
-    const nextNumber = existingNumbers.length > 0 ? Math.max(...existingNumbers) + 1 : 1;
-    return `${nodeTypeId}.${nextNumber}`;
-}
-/**
- * Edge styling configuration based on source port data type
+ * Edge styling configuration based on source port data type.
+ * Delegates to standalone functions in utils/edgeStyling.ts.
  */
 export class EdgeStylingHelper {
-    /**
-     * Extract the port ID from a handle ID
-     * @param handleId - The handle ID string (e.g., "sample-node.1-output-trigger" or "trigger")
-     * @returns The port ID (e.g., "trigger") or the handleId itself for short format
-     */
     static extractPortIdFromHandle(handleId) {
         return extractPortId(handleId);
     }
-    /**
-     * Check if a port ID matches a dynamic branch in a Gateway node
-     * Gateway nodes store branches in config.branches array
-     * @param node - The workflow node to check
-     * @param portId - The port ID to look up
-     * @returns true if the portId matches a gateway branch
-     */
     static isGatewayBranch(node, portId) {
-        // Check if this is a gateway node with dynamic branches
-        const nodeType = node.data?.metadata?.type || node.type;
-        if (nodeType !== "gateway") {
-            return false;
-        }
-        // Check if the portId matches a branch name in config.branches
-        const branches = node.data?.config?.branches;
-        if (!branches || !Array.isArray(branches)) {
-            return false;
-        }
-        return branches.some((branch) => branch.name === portId);
+        return isGatewayBranchUtil(node, portId);
     }
-    /**
-     * Get the data type of a port from a node's metadata
-     * Also handles dynamic ports like Gateway branches
-     * @param node - The workflow node containing the port
-     * @param portId - The port ID to look up
-     * @param portType - Whether to look in "inputs" or "outputs"
-     * @returns The port's dataType or null if not found
-     */
     static getPortDataType(node, portId, portType) {
-        // First, check static ports in metadata
-        const ports = portType === "output"
-            ? node.data?.metadata?.outputs
-            : node.data?.metadata?.inputs;
-        if (ports && Array.isArray(ports)) {
-            const port = ports.find((p) => p.id === portId);
-            if (port?.dataType) {
-                return port.dataType;
-            }
-        }
-        // Check dynamic ports from config (dynamicInputs/dynamicOutputs)
-        const dynamicKey = portType === "output" ? "dynamicOutputs" : "dynamicInputs";
-        const dynamicPorts = node.data?.config?.[dynamicKey];
-        if (dynamicPorts && Array.isArray(dynamicPorts)) {
-            const dynamicPort = dynamicPorts.find((p) => p.name === portId);
-            if (dynamicPort?.dataType) {
-                return dynamicPort.dataType;
-            }
-        }
-        // For output ports, also check dynamic Gateway branches
-        // Gateway branches are always trigger type (control flow)
-        if (portType === "output" && this.isGatewayBranch(node, portId)) {
-            return "trigger";
-        }
-        return null;
+        return getPortDataTypeUtil(node, portId, portType);
     }
-    /**
-     * Determine the edge category based on source port data type
-     * Note: This method does not check for loopback edges.
-     * Use getEdgeCategoryWithLoopback() for full edge categorization.
-     *
-     * @param sourcePortDataType - The data type of the source output port
-     * @returns The edge category for styling
-     */
     static getEdgeCategory(sourcePortDataType) {
-        if (sourcePortDataType === "trigger") {
-            return "trigger";
-        }
-        if (sourcePortDataType === "tool") {
-            return "tool";
-        }
-        // All other data types (string, number, boolean, array, etc.) are "data" edges
-        return "data";
+        return getEdgeCategoryUtil(sourcePortDataType);
     }
-    /**
-     * Determine the full edge category including loopback detection
-     * Loopback edges take precedence over source port data type
-     *
-     * @param edge - The edge to categorize
-     * @param sourcePortDataType - The data type of the source output port
-     * @returns The edge category for styling
-     */
     static getEdgeCategoryWithLoopback(edge, sourcePortDataType) {
-        // Loopback edges are identified by their target handle
-        // Check this first as it takes precedence
-        if (isLoopbackEdge(edge)) {
-            return "loopback";
-        }
-        // Fall back to source port data type categorization
-        return this.getEdgeCategory(sourcePortDataType);
+        return getEdgeCategoryWithLoopbackUtil(edge, sourcePortDataType);
     }
-    /**
-     * Apply custom styling to connection edges based on edge type:
-     * - Loopback: Dashed gray line for loop iteration (targets loop_back port)
-     * - Trigger ports: Solid black line with arrow
-     * - Tool ports: Dashed amber line with arrow
-     * - Data ports: Normal gray line with arrow
-     */
     static applyConnectionStyling(edge, sourceNode, targetNode) {
-        // Extract port ID from sourceHandle
-        const sourcePortId = this.extractPortIdFromHandle(edge.sourceHandle);
-        // Get the source port's data type
-        const sourcePortDataType = sourcePortId
-            ? this.getPortDataType(sourceNode, sourcePortId, "output")
-            : null;
-        // Determine edge category (loopback takes precedence)
-        const edgeCategory = this.getEdgeCategoryWithLoopback(edge, sourcePortDataType);
-        // Apply styling based on edge category
-        // Marker colors use CSS custom properties so they respond to theme changes automatically
-        switch (edgeCategory) {
-            case "loopback":
-                // Loopback edges: dashed gray line for loop iteration
-                edge.style =
-                    "stroke: var(--fd-edge-loopback); stroke-dasharray: var(--fd-edge-loopback-dasharray); stroke-width: var(--fd-edge-loopback-width); opacity: var(--fd-edge-loopback-opacity);";
-                edge.class = "flowdrop--edge--loopback";
-                edge.markerEnd = {
-                    type: MarkerType.ArrowClosed,
-                    ...EDGE_MARKER_SIZES.loopback,
-                    color: "var(--fd-edge-loopback)",
-                };
-                break;
-            case "trigger":
-                // Trigger edges: solid dark line for control flow
-                edge.style =
-                    "stroke: var(--fd-edge-trigger); stroke-width: var(--fd-edge-trigger-width);";
-                edge.class = "flowdrop--edge--trigger";
-                edge.markerEnd = {
-                    type: MarkerType.ArrowClosed,
-                    ...EDGE_MARKER_SIZES.trigger,
-                    color: "var(--fd-edge-trigger)",
-                };
-                break;
-            case "tool":
-                // Tool edges: dashed amber line
-                edge.style = "stroke: var(--fd-edge-tool); stroke-dasharray: 5 3;";
-                edge.class = "flowdrop--edge--tool";
-                edge.markerEnd = {
-                    type: MarkerType.ArrowClosed,
-                    ...EDGE_MARKER_SIZES.tool,
-                    color: "var(--fd-edge-tool)",
-                };
-                break;
-            case "data":
-            default:
-                // Data edges: normal gray line
-                edge.style = "stroke: var(--fd-edge-data);";
-                edge.class = "flowdrop--edge--data";
-                edge.markerEnd = {
-                    type: MarkerType.ArrowClosed,
-                    ...EDGE_MARKER_SIZES.data,
-                    color: "var(--fd-edge-data)",
-                };
-                break;
-        }
-        // Store metadata in edge data for API and persistence
-        edge.data = {
-            ...edge.data,
-            metadata: {
-                ...(edge.data?.metadata || {}),
-                edgeType: edgeCategory,
-                sourcePortDataType: sourcePortDataType ?? undefined,
-            },
-            targetNodeType: targetNode.type,
-            targetCategory: targetNode.data.metadata.category,
-        };
+        applyConnectionStylingUtil(edge, sourceNode, targetNode);
     }
-    /**
-     * Update existing edges with custom styling rules
-     */
     static updateEdgeStyles(edges, nodes) {
-        return edges.map((edge) => {
-            // Find source and target nodes
-            const sourceNode = nodes.find((node) => node.id === edge.source);
-            const targetNode = nodes.find((node) => node.id === edge.target);
-            // Create a copy of the edge
-            const updatedEdge = { ...edge };
-            if (!sourceNode || !targetNode) {
-                // Set default edgeType even when nodes are not found
-                updatedEdge.data = {
-                    ...updatedEdge.data,
-                    metadata: {
-                        ...(updatedEdge.data?.metadata || {}),
-                        edgeType: "data",
-                    },
-                };
-                return updatedEdge;
-            }
-            // Apply full styling when nodes are available
-            this.applyConnectionStyling(updatedEdge, sourceNode, targetNode);
-            return updatedEdge;
-        });
+        return updateEdgeStylesUtil(edges, nodes);
     }
 }
 /**
@@ -323,27 +126,9 @@ export class NodeOperationsHelper {
             else {
                 // New format (direct NodeMetadata)
                 nodeType = parsedData;
-                // Extract initial config from configSchema
-                let initialConfig = {};
-                if (nodeType.configSchema &&
-                    typeof nodeType.configSchema === "object") {
-                    // If configSchema is a JSON Schema, extract default values
-                    if (nodeType.configSchema.properties) {
-                        // JSON Schema format - extract defaults
-                        Object.entries(nodeType.configSchema.properties).forEach(([key, prop]) => {
-                            if (prop && typeof prop === "object" && "default" in prop) {
-                                initialConfig[key] = prop.default;
-                            }
-                        });
-                    }
-                    else {
-                        // Simple object format - use as is
-                        initialConfig = { ...nodeType.configSchema };
-                    }
-                }
                 nodeData = {
                     label: nodeType.name,
-                    config: initialConfig,
+                    config: extractConfigDefaults(nodeType.configSchema),
                     metadata: nodeType,
                 };
             }

package/dist/playground/index.d.ts

@@ -117,7 +117,7 @@ export { default as SessionManager } from "../components/playground/SessionManag
 export { default as InputCollector } from "../components/playground/InputCollector.svelte";
 export { default as ExecutionLogs } from "../components/playground/ExecutionLogs.svelte";
 export { default as MessageBubble } from "../components/playground/MessageBubble.svelte";
-export { InterruptBubble, ConfirmationPrompt, ChoicePrompt, TextInputPrompt, FormPrompt, } from "../components/interrupt/index.js";
+export { InterruptBubble, ConfirmationPrompt, ChoicePrompt, TextInputPrompt, FormPrompt, ReviewPrompt, } from "../components/interrupt/index.js";
 export { PlaygroundService, playgroundService, } from "../services/playgroundService.js";
 export { InterruptService, interruptService, } from "../services/interruptService.js";
 export { getCurrentSession, getSessions, getMessages, getIsExecuting, getIsLoading, getError as getPlaygroundError, getCurrentWorkflow, getLastPollTimestamp, getSessionStatus, getMessageCount, getChatMessages, getLogMessages, getLatestMessage, getInputFields, getHasChatInput, getSessionCount, playgroundActions, createPollingCallback, subscribeToSessionStatus, getCurrentSessionId, isSessionSelected, getMessagesSnapshot, getLatestMessageTimestamp, } from "../stores/playgroundStore.svelte.js";

package/dist/playground/index.js

@@ -123,7 +123,7 @@ export { default as MessageBubble } from "../components/playground/MessageBubble
 // ============================================================================
 // Interrupt Components (Human-in-the-Loop)
 // ============================================================================
-export { InterruptBubble, ConfirmationPrompt, ChoicePrompt, TextInputPrompt, FormPrompt, } from "../components/interrupt/index.js";
+export { InterruptBubble, ConfirmationPrompt, ChoicePrompt, TextInputPrompt, FormPrompt, ReviewPrompt, } from "../components/interrupt/index.js";
 // ============================================================================
 // Playground Service
 // ============================================================================

package/dist/schemas/v1/workflow.schema.json

@@ -38,7 +38,13 @@
       "$ref": "#/$defs/WorkflowMetadata"
     }
   },
-  "required": ["id", "name", "nodes", "edges", "metadata"],
+  "required": [
+    "id",
+    "name",
+    "nodes",
+    "edges",
+    "metadata"
+  ],
   "$defs": {
     "AutocompleteConfig": {
       "type": "object",
@@ -89,7 +95,9 @@
           "description": "Whether to allow multiple selections.\nWhen true, users can select multiple values displayed as tags.\n"
         }
       },
-      "required": ["url"]
+      "required": [
+        "url"
+      ]
     },
     "Branch": {
       "type": "object",
@@ -117,7 +125,10 @@
           "description": "Whether this is the default/fallback branch"
         }
       },
-      "required": ["name", "label"]
+      "required": [
+        "name",
+        "label"
+      ]
     },
     "ConfigProperty": {
       "type": "object",
@@ -125,7 +136,14 @@
       "properties": {
         "type": {
           "type": "string",
-          "enum": ["string", "number", "boolean", "array", "object", "integer"],
+          "enum": [
+            "string",
+            "number",
+            "boolean",
+            "array",
+            "object",
+            "integer"
+          ],
           "description": "JSON Schema type"
         },
         "title": {
@@ -251,14 +269,18 @@
           ]
         }
       },
-      "required": ["type"]
+      "required": [
+        "type"
+      ]
     },
     "ConfigSchema": {
       "type": "object",
       "properties": {
         "type": {
           "type": "string",
-          "enum": ["object"]
+          "enum": [
+            "object"
+          ]
         },
         "properties": {
           "type": "object",
@@ -279,7 +301,10 @@
           "default": false
         }
       },
-      "required": ["type", "properties"]
+      "required": [
+        "type",
+        "properties"
+      ]
     },
     "DynamicPort": {
       "type": "object",
@@ -313,7 +338,11 @@
           "description": "Whether this port is required for execution"
         }
       },
-      "required": ["name", "label", "dataType"]
+      "required": [
+        "name",
+        "label",
+        "dataType"
+      ]
     },
     "NodeCategory": {
       "type": "string",
@@ -404,7 +433,11 @@
           "description": "Whether the node is currently being executed"
         }
       },
-      "required": ["status", "executionCount", "isExecuting"]
+      "required": [
+        "status",
+        "executionCount",
+        "isExecuting"
+      ]
     },
     "NodeExecutionStatus": {
       "type": "string",
@@ -548,7 +581,11 @@
         },
         "type": {
           "type": "string",
-          "enum": ["input", "output", "metadata"],
+          "enum": [
+            "input",
+            "output",
+            "metadata"
+          ],
           "description": "Port direction (input receives data, output sends data)"
         },
         "dataType": {
@@ -577,7 +614,12 @@
           ]
         }
       },
-      "required": ["id", "name", "type", "dataType"]
+      "required": [
+        "id",
+        "name",
+        "type",
+        "dataType"
+      ]
     },
     "NodeType": {
       "type": "string",
@@ -635,7 +677,9 @@
           "description": "Optional description for this option"
         }
       },
-      "required": ["const"]
+      "required": [
+        "const"
+      ]
     },
     "PortDataSchema": {
       "type": "object",
@@ -643,7 +687,14 @@
       "properties": {
         "type": {
           "type": "string",
-          "enum": ["object", "array", "string", "number", "integer", "boolean"],
+          "enum": [
+            "object",
+            "array",
+            "string",
+            "number",
+            "integer",
+            "boolean"
+          ],
           "description": "The JSON Schema type. Use `object` for nested properties,\n`array` for lists with `items` schema.\n"
         },
         "title": {
@@ -692,7 +743,10 @@
           "description": "Y coordinate"
         }
       },
-      "required": ["x", "y"]
+      "required": [
+        "x",
+        "y"
+      ]
     },
     "TemplateVariable": {
       "type": "object",
@@ -750,7 +804,10 @@
           "description": "Source node ID"
         }
       },
-      "required": ["name", "type"]
+      "required": [
+        "name",
+        "type"
+      ]
     },
     "TemplateVariablesConfig": {
       "type": "object",
@@ -797,7 +854,9 @@
           "description": "Map of available variables keyed by variable name"
         }
       },
-      "required": ["variables"]
+      "required": [
+        "variables"
+      ]
     },
     "WorkflowEdge": {
       "type": "object",
@@ -828,7 +887,12 @@
         "type": {
           "type": "string",
           "description": "Connection line type",
-          "enum": ["default", "straight", "step", "smoothstep"]
+          "enum": [
+            "default",
+            "straight",
+            "step",
+            "smoothstep"
+          ]
         },
         "selectable": {
           "type": "boolean",
@@ -855,7 +919,11 @@
               "properties": {
                 "edgeType": {
                   "type": "string",
-                  "enum": ["trigger", "tool", "data"],
+                  "enum": [
+                    "trigger",
+                    "tool",
+                    "data"
+                  ],
                   "description": "Edge type for visual styling"
                 },
                 "sourcePortDataType": {
@@ -879,7 +947,11 @@
           }
         }
       },
-      "required": ["id", "source", "target"]
+      "required": [
+        "id",
+        "source",
+        "target"
+      ]
     },
     "WorkflowMetadata": {
       "type": "object",
@@ -923,7 +995,11 @@
           "default": "flowdrop"
         }
       },
-      "required": ["version", "createdAt", "updatedAt"]
+      "required": [
+        "version",
+        "createdAt",
+        "updatedAt"
+      ]
     },
     "WorkflowNode": {
       "type": "object",
@@ -984,10 +1060,19 @@
               ]
             }
           },
-          "required": ["label", "config", "metadata"]
+          "required": [
+            "label",
+            "config",
+            "metadata"
+          ]
         }
       },
-      "required": ["id", "type", "position", "data"]
+      "required": [
+        "id",
+        "type",
+        "position",
+        "data"
+      ]
     }
   }
 }

package/dist/services/chatService.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Chat Service
+ *
+ * Handles API interactions for the LLM Chat feature including
+ * sending messages, retrieving history, and clearing history.
+ *
+ * @module services/chatService
+ */
+import type { ChatRequest, ChatResponse, ChatHistoryMessage } from "../types/chat.js";
+/**
+ * Chat Service class
+ *
+ * Provides methods to interact with the chat API endpoints
+ * for LLM-powered workflow building assistance.
+ */
+export declare class ChatService {
+    private static instance;
+    private constructor();
+    /**
+     * Get the singleton instance of ChatService
+     *
+     * @returns The ChatService singleton instance
+     */
+    static getInstance(): ChatService;
+    /**
+     * Get the endpoint configuration
+     *
+     * @throws Error if endpoint configuration is not set
+     * @returns The endpoint configuration
+     */
+    private getConfig;
+    /**
+     * Generic API request helper
+     *
+     * @param url - The URL to fetch
+     * @param options - Fetch options
+     * @returns The parsed JSON response
+     */
+    private request;
+    /**
+     * Send a message to the chat endpoint
+     *
+     * @param workflowId - The workflow ID
+     * @param request - The chat request payload
+     * @returns The chat response from the LLM
+     */
+    sendMessage(workflowId: string, request: ChatRequest): Promise<ChatResponse>;
+    /**
+     * Get conversation history for a workflow
+     *
+     * @param workflowId - The workflow ID
+     * @returns Array of chat history messages
+     */
+    getHistory(workflowId: string): Promise<ChatHistoryMessage[]>;
+    /**
+     * Clear conversation history for a workflow
+     *
+     * @param workflowId - The workflow ID
+     */
+    clearHistory(workflowId: string): Promise<void>;
+}
+/**
+ * Pre-instantiated ChatService singleton
+ */
+export declare const chatService: ChatService;