@d34dman/flowdrop 0.0.32 → 0.0.34

package/dist/components/WorkflowEditor.svelte

@@ -620,4 +620,26 @@
 		stroke: var(--flowdrop-edge-data-color-selected);
 		stroke-width: 2;
 	}
+
+	/* Loopback Edge: Dashed gray line for loop iteration connections */
+	:global(.flowdrop--edge--loopback path.svelte-flow__edge-path) {
+		stroke: var(--flowdrop-edge-loopback-color);
+		stroke-width: var(--flowdrop-edge-loopback-width);
+		stroke-dasharray: var(--flowdrop-edge-loopback-dasharray);
+		opacity: var(--flowdrop-edge-loopback-opacity);
+	}
+
+	:global(.flowdrop--edge--loopback:hover path.svelte-flow__edge-path) {
+		stroke: var(--flowdrop-edge-loopback-color-hover);
+		stroke-width: var(--flowdrop-edge-loopback-width-hover);
+		opacity: 1;
+	}
+
+	:global(.flowdrop--edge--loopback.selected path.svelte-flow__edge-path) {
+		stroke: var(--flowdrop-edge-loopback-color-selected);
+		stroke-width: var(--flowdrop-edge-loopback-width-hover);
+		stroke-dasharray: var(--flowdrop-edge-loopback-dasharray);
+		filter: drop-shadow(0 0 3px rgba(139, 92, 246, 0.4));
+		opacity: 1;
+	}
 </style>

package/dist/components/playground/ChatPanel.svelte

@@ -35,6 +35,8 @@
 		onStopExecution?: () => void;
 		/** Whether to show log messages inline (false = hide them) */
 		showLogsInline?: boolean;
+		/** Whether to enable markdown rendering in messages */
+		enableMarkdown?: boolean;
 	}
 
 	let {
@@ -43,7 +45,8 @@
 		placeholder = 'Type your message...',
 		onSendMessage,
 		onStopExecution,
-		showLogsInline = false
+		showLogsInline = false,
+		enableMarkdown = true
 	}: Props = $props();
 
 	/** Input field value */
@@ -206,6 +209,7 @@
 					{message}
 					showTimestamp={showTimestamps}
 					isLast={index === displayMessages.length - 1}
+					{enableMarkdown}
 				/>
 			{/each}
 

package/dist/components/playground/ChatPanel.svelte.d.ts

@@ -14,6 +14,8 @@ interface Props {
     onStopExecution?: () => void;
     /** Whether to show log messages inline (false = hide them) */
     showLogsInline?: boolean;
+    /** Whether to enable markdown rendering in messages */
+    enableMarkdown?: boolean;
 }
 declare const ChatPanel: import("svelte").Component<Props, {}, "">;
 type ChatPanel = ReturnType<typeof ChatPanel>;

package/dist/components/playground/MessageBubble.svelte

@@ -3,11 +3,13 @@
   
   Renders individual messages in the playground chat interface.
   Supports different message roles with distinct styling.
+  Supports markdown rendering for message content.
   Styled with BEM syntax.
 -->
 
 <script lang="ts">
 	import Icon from '@iconify/svelte';
+	import { marked } from 'marked';
 	import type { PlaygroundMessage, PlaygroundMessageRole } from '../../types/playground.js';
 
 	/**
@@ -20,9 +22,20 @@
 		showTimestamp?: boolean;
 		/** Whether this is the last message (affects styling) */
 		isLast?: boolean;
+		/** Whether to render markdown content */
+		enableMarkdown?: boolean;
 	}
 
-	let { message, showTimestamp = true, isLast = false }: Props = $props();
+	let { message, showTimestamp = true, isLast = false, enableMarkdown = true }: Props = $props();
+
+	/**
+	 * Render content as markdown or plain text
+	 */
+	const renderedContent = $derived(
+		enableMarkdown && message.role !== 'log'
+			? marked.parse(message.content || '')
+			: message.content
+	);
 
 	/**
 	 * Get the icon for the message role
@@ -144,7 +157,13 @@
 
 		<!-- Message Text -->
 		<div class="message-bubble__text">
-			{message.content}
+			{#if enableMarkdown && message.role !== 'log'}
+				<!-- Markdown content - marked.js sanitizes content by default -->
+				<!-- eslint-disable-next-line svelte/no-at-html-tags -->
+				{@html renderedContent}
+			{:else}
+				{message.content}
+			{/if}
 		</div>
 
 		<!-- Metadata Footer -->
@@ -188,32 +207,33 @@
 		}
 	}
 
-	/* Role-specific styling */
+	/* Role-specific styling - Neutral theme */
 	.message-bubble--user {
-		background: linear-gradient(135deg, #3b82f6 0%, #2563eb 100%);
-		color: #ffffff;
+		background-color: #f1f5f9;
+		border: 1px solid #e2e8f0;
+		color: #1e293b;
 		margin-left: 2rem;
 		flex-direction: row-reverse;
 	}
 
 	.message-bubble--assistant {
-		background-color: #f8fafc;
-		border: 1px solid #e2e8f0;
-		color: #1e293b;
+		background-color: #ffffff;
+		border: 1px solid #e5e7eb;
+		color: #1f2937;
 		margin-right: 2rem;
 	}
 
 	.message-bubble--system {
-		background-color: #fef3c7;
-		border: 1px solid #fcd34d;
-		color: #92400e;
+		background-color: #f9fafb;
+		border: 1px solid #e5e7eb;
+		color: #6b7280;
 		margin: 0 1rem;
 		font-size: 0.875rem;
 	}
 
 	.message-bubble--log {
-		background-color: #f1f5f9;
-		border: 1px solid #cbd5e1;
+		background-color: #f8fafc;
+		border: 1px solid #e2e8f0;
 		color: #475569;
 		margin: 0 1rem;
 		font-size: 0.8125rem;
@@ -249,18 +269,18 @@
 	}
 
 	.message-bubble--user .message-bubble__avatar {
-		background-color: rgba(255, 255, 255, 0.2);
-		color: #ffffff;
+		background-color: #e2e8f0;
+		color: #475569;
 	}
 
 	.message-bubble--assistant .message-bubble__avatar {
-		background-color: #dbeafe;
-		color: #2563eb;
+		background-color: #e5e7eb;
+		color: #374151;
 	}
 
 	.message-bubble--system .message-bubble__avatar {
-		background-color: #fde68a;
-		color: #92400e;
+		background-color: #f3f4f6;
+		color: #6b7280;
 	}
 
 	.message-bubble--log .message-bubble__avatar {
@@ -292,14 +312,15 @@
 	.message-bubble__role {
 		font-weight: 600;
 		font-size: 0.8125rem;
+		color: #374151;
 	}
 
 	.message-bubble--user .message-bubble__role {
-		color: rgba(255, 255, 255, 0.9);
+		color: #475569;
 	}
 
 	.message-bubble--assistant .message-bubble__role {
-		color: #3b82f6;
+		color: #374151;
 	}
 
 	.message-bubble--log .message-bubble__role {
@@ -319,8 +340,8 @@
 	}
 
 	.message-bubble__log-level--info {
-		background-color: #dbeafe;
-		color: #1d4ed8;
+		background-color: #e0f2fe;
+		color: #0369a1;
 	}
 
 	.message-bubble__log-level--warning {
@@ -340,24 +361,152 @@
 
 	.message-bubble__timestamp {
 		font-size: 0.6875rem;
-		opacity: 0.7;
+		color: #9ca3af;
 		font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
 	}
 
 	.message-bubble--user .message-bubble__timestamp {
-		color: rgba(255, 255, 255, 0.7);
+		color: #9ca3af;
 	}
 
 	/* Message text */
 	.message-bubble__text {
-		line-height: 1.5;
-		white-space: pre-wrap;
+		line-height: 1.6;
 		word-break: break-word;
 	}
 
 	.message-bubble--log .message-bubble__text {
 		font-size: 0.8125rem;
 		line-height: 1.4;
+		white-space: pre-wrap;
+	}
+
+	/* Markdown styling for message content */
+	.message-bubble__text :global(p) {
+		margin: 0 0 0.75rem 0;
+	}
+
+	.message-bubble__text :global(p:last-child) {
+		margin-bottom: 0;
+	}
+
+	.message-bubble__text :global(h1),
+	.message-bubble__text :global(h2),
+	.message-bubble__text :global(h3),
+	.message-bubble__text :global(h4),
+	.message-bubble__text :global(h5),
+	.message-bubble__text :global(h6) {
+		margin: 1rem 0 0.5rem 0;
+		font-weight: 600;
+		line-height: 1.3;
+	}
+
+	.message-bubble__text :global(h1:first-child),
+	.message-bubble__text :global(h2:first-child),
+	.message-bubble__text :global(h3:first-child),
+	.message-bubble__text :global(h4:first-child),
+	.message-bubble__text :global(h5:first-child),
+	.message-bubble__text :global(h6:first-child) {
+		margin-top: 0;
+	}
+
+	.message-bubble__text :global(h1) {
+		font-size: 1.25rem;
+	}
+
+	.message-bubble__text :global(h2) {
+		font-size: 1.125rem;
+	}
+
+	.message-bubble__text :global(h3) {
+		font-size: 1rem;
+	}
+
+	.message-bubble__text :global(ul),
+	.message-bubble__text :global(ol) {
+		margin: 0.5rem 0;
+		padding-left: 1.5rem;
+	}
+
+	.message-bubble__text :global(li) {
+		margin: 0.25rem 0;
+	}
+
+	.message-bubble__text :global(code) {
+		background-color: rgba(0, 0, 0, 0.06);
+		padding: 0.125rem 0.375rem;
+		border-radius: 0.25rem;
+		font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
+		font-size: 0.875em;
+	}
+
+	.message-bubble__text :global(pre) {
+		background-color: #1e293b;
+		color: #e2e8f0;
+		padding: 0.75rem 1rem;
+		border-radius: 0.5rem;
+		overflow-x: auto;
+		margin: 0.75rem 0;
+		font-size: 0.8125rem;
+		line-height: 1.5;
+	}
+
+	.message-bubble__text :global(pre code) {
+		background-color: transparent;
+		padding: 0;
+		border-radius: 0;
+		color: inherit;
+		font-size: inherit;
+	}
+
+	.message-bubble__text :global(blockquote) {
+		border-left: 3px solid #d1d5db;
+		padding-left: 1rem;
+		margin: 0.75rem 0;
+		color: #6b7280;
+		font-style: italic;
+	}
+
+	.message-bubble__text :global(a) {
+		color: #2563eb;
+		text-decoration: none;
+	}
+
+	.message-bubble__text :global(a:hover) {
+		text-decoration: underline;
+	}
+
+	.message-bubble__text :global(hr) {
+		border: none;
+		border-top: 1px solid #e5e7eb;
+		margin: 1rem 0;
+	}
+
+	.message-bubble__text :global(table) {
+		border-collapse: collapse;
+		width: 100%;
+		margin: 0.75rem 0;
+		font-size: 0.875rem;
+	}
+
+	.message-bubble__text :global(th),
+	.message-bubble__text :global(td) {
+		border: 1px solid #e5e7eb;
+		padding: 0.5rem 0.75rem;
+		text-align: left;
+	}
+
+	.message-bubble__text :global(th) {
+		background-color: #f9fafb;
+		font-weight: 600;
+	}
+
+	.message-bubble__text :global(strong) {
+		font-weight: 600;
+	}
+
+	.message-bubble__text :global(em) {
+		font-style: italic;
 	}
 
 	/* Footer */
@@ -367,7 +516,7 @@
 		gap: 0.75rem;
 		margin-top: 0.5rem;
 		font-size: 0.6875rem;
-		opacity: 0.7;
+		color: #9ca3af;
 	}
 
 	.message-bubble--user .message-bubble__footer {

package/dist/components/playground/MessageBubble.svelte.d.ts

@@ -9,6 +9,8 @@ interface Props {
     showTimestamp?: boolean;
     /** Whether this is the last message (affects styling) */
     isLast?: boolean;
+    /** Whether to render markdown content */
+    enableMarkdown?: boolean;
 }
 declare const MessageBubble: import("svelte").Component<Props, {}, "">;
 type MessageBubble = ReturnType<typeof MessageBubble>;

package/dist/components/playground/Playground.svelte

@@ -335,15 +335,20 @@
 					playgroundActions.addMessages(response.data);
 				}
 
-				// Update session status
-				if (response.sessionStatus) {
-					playgroundActions.updateSessionStatus(response.sessionStatus);
-
-					// Stop executing if completed or failed
-					if (response.sessionStatus === 'completed' || response.sessionStatus === 'failed') {
-						playgroundActions.setExecuting(false);
-					}
+			// Update session status
+			if (response.sessionStatus) {
+				playgroundActions.updateSessionStatus(response.sessionStatus);
+
+				// Stop executing if idle, completed, or failed
+				// "idle" means no processing is happening (execution finished)
+				if (
+					response.sessionStatus === 'idle' ||
+					response.sessionStatus === 'completed' ||
+					response.sessionStatus === 'failed'
+				) {
+					playgroundActions.setExecuting(false);
 				}
+			}
 			},
 			pollingInterval
 		);
@@ -513,6 +518,7 @@
 						showTimestamps={config.showTimestamps ?? true}
 						autoScroll={config.autoScroll ?? true}
 						showLogsInline={config.logDisplayMode === 'inline'}
+						enableMarkdown={config.enableMarkdown ?? true}
 						onSendMessage={handleSendMessage}
 						onStopExecution={handleStopExecution}
 					/>

package/dist/core/index.d.ts

@@ -14,7 +14,7 @@
  * import { getStatusColor, createDefaultExecutionInfo } from "@d34dman/flowdrop/core";
  * ```
  */
-export type { NodeCategory, NodeDataType, NodePort, DynamicPort, Branch, NodeMetadata, NodeExtensions, NodeUIExtensions, ConfigValues, WorkflowNode, WorkflowEdge, Workflow, ApiResponse, NodesResponse, WorkflowResponse, WorkflowsResponse, ExecutionStatus, ExecutionResult, FlowDropConfig, WorkflowEvents, BuiltinNodeType, PortConfig, PortCompatibilityRule, ConfigSchema, ConfigProperty, HttpMethod, DynamicSchemaEndpoint, ExternalEditLink, ConfigEditOptions } from '../types/index.js';
+export type { NodeCategory, NodeDataType, NodePort, DynamicPort, Branch, NodeMetadata, NodeExtensions, NodeUIExtensions, ConfigValues, WorkflowNode, WorkflowEdge, Workflow, ApiResponse, NodesResponse, WorkflowResponse, WorkflowsResponse, ExecutionStatus, ExecutionResult, FlowDropConfig, WorkflowEvents, BuiltinNodeType, PortConfig, PortCompatibilityRule, ConfigSchema, ConfigProperty, HttpMethod, DynamicSchemaEndpoint, ExternalEditLink, ConfigEditOptions, EdgeCategory } from '../types/index.js';
 export type { WorkflowEditorConfig, EditorFeatures, UIConfig, APIConfig, ExecutionConfig, StorageConfig } from '../types/config.js';
 export type { AuthProvider, StaticAuthConfig, CallbackAuthConfig } from '../types/auth.js';
 export type { WorkflowChangeType, FlowDropEventHandlers, FlowDropFeatures } from '../types/events.js';
@@ -35,6 +35,7 @@ export * from '../utils/colors.js';
 export * from '../utils/icons.js';
 export * from '../utils/config.js';
 export * from '../utils/nodeTypes.js';
+export { isLoopbackEdge, isValidLoopbackCycle, hasCycles, hasInvalidCycles } from '../utils/connections.js';
 export { isFieldOptionArray, normalizeOptions } from '../components/form/types.js';
 export { DEFAULT_PORT_CONFIG } from '../config/defaultPortConfig.js';
 export { defaultEndpointConfig, createEndpointConfig } from '../config/endpoints.js';

package/dist/core/index.js

@@ -38,6 +38,8 @@ export * from '../utils/icons.js';
 export * from '../utils/config.js';
 // Node type utilities
 export * from '../utils/nodeTypes.js';
+// Connection utilities (including loopback edge detection)
+export { isLoopbackEdge, isValidLoopbackCycle, hasCycles, hasInvalidCycles } from '../utils/connections.js';
 // Form type utilities
 export { isFieldOptionArray, normalizeOptions } from '../components/form/types.js';
 // ============================================================================

package/dist/helpers/workflowEditorHelper.d.ts

@@ -14,9 +14,10 @@ export declare function generateNodeId(nodeTypeId: string, existingNodes: Workfl
  * Edge category type for styling purposes
  * - trigger: For control flow connections (dataType: "trigger")
  * - tool: Dashed amber line for tool connections (dataType: "tool")
+ * - loopback: Dashed gray line for loop iteration connections (targets loop_back port)
  * - data: Normal gray line for all other data connections
  */
-export type EdgeCategory = 'trigger' | 'tool' | 'data';
+export type EdgeCategory = 'trigger' | 'tool' | 'loopback' | 'data';
 /**
  * Edge styling configuration based on source port data type
  */
@@ -49,12 +50,25 @@ export declare class EdgeStylingHelper {
     static getPortDataType(node: WorkflowNodeType, portId: string, portType: 'input' | 'output'): string | null;
     /**
      * 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: string | null): EdgeCategory;
     /**
-     * Apply custom styling to connection edges based on source port data type:
+     * 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: WorkflowEdge, sourcePortDataType: string | null): EdgeCategory;
+    /**
+     * 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
@@ -118,9 +132,24 @@ export declare class WorkflowOperationsHelper {
      */
     static exportWorkflow(workflow: Workflow | null): void;
     /**
-     * Check if workflow has cycles
+     * Check if workflow has invalid cycles (excludes valid loopback cycles)
+     * Valid loopback cycles are used for ForEach node iteration and should not
+     * trigger a warning.
+     *
+     * @param nodes - Array of workflow nodes
+     * @param edges - Array of workflow edges
+     * @returns True if there are invalid (non-loopback) cycles
      */
     static checkWorkflowCycles(nodes: WorkflowNodeType[], edges: WorkflowEdge[]): boolean;
+    /**
+     * Check if workflow has any cycles (including valid loopback cycles)
+     * Use this when you need to detect ALL cycles regardless of type.
+     *
+     * @param nodes - Array of workflow nodes
+     * @param edges - Array of workflow edges
+     * @returns True if any cycle exists
+     */
+    static checkWorkflowHasAnyCycles(nodes: WorkflowNodeType[], edges: WorkflowEdge[]): boolean;
 }
 /**
  * Configuration helper

package/dist/helpers/workflowEditorHelper.js

@@ -3,7 +3,7 @@
  * Contains business logic for workflow operations
  */
 import { MarkerType } from '@xyflow/svelte';
-import { hasCycles } from '../utils/connections.js';
+import { hasCycles, hasInvalidCycles, isLoopbackEdge } from '../utils/connections.js';
 import { workflowApi, nodeApi, setEndpointConfig } from '../services/api.js';
 import { v4 as uuidv4 } from 'uuid';
 import { workflowActions } from '../stores/workflowStore.js';
@@ -104,6 +104,9 @@ export class EdgeStylingHelper {
     }
     /**
      * 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
      */
@@ -118,7 +121,25 @@ export class EdgeStylingHelper {
         return 'data';
     }
     /**
-     * Apply custom styling to connection edges based on source port data type:
+     * 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);
+    }
+    /**
+     * 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
@@ -130,17 +151,30 @@ export class EdgeStylingHelper {
         const sourcePortDataType = sourcePortId
             ? this.getPortDataType(sourceNode, sourcePortId, 'output')
             : null;
-        // Determine edge category based on source port data type
-        const edgeCategory = this.getEdgeCategory(sourcePortDataType);
+        // Determine edge category (loopback takes precedence)
+        const edgeCategory = this.getEdgeCategoryWithLoopback(edge, sourcePortDataType);
         // Edge color constants (matching CSS tokens in base.css)
         const EDGE_COLORS = {
             trigger: '#111827', // --color-ref-gray-900
             tool: '#f59e0b', // --color-ref-amber-500
+            loopback: '#6b7280', // --color-ref-gray-500
             data: '#9ca3af' // --color-ref-gray-400
         };
         // Apply styling based on edge category
         // CSS classes handle styling via tokens; inline styles are fallback
         switch (edgeCategory) {
+            case 'loopback':
+                // Loopback edges: dashed gray line for loop iteration
+                edge.style =
+                    'stroke: var(--flowdrop-edge-loopback-color); stroke-dasharray: 5 5; stroke-width: var(--flowdrop-edge-loopback-width);';
+                edge.class = 'flowdrop--edge--loopback';
+                edge.markerEnd = {
+                    type: MarkerType.ArrowClosed,
+                    width: 14,
+                    height: 14,
+                    color: EDGE_COLORS.loopback
+                };
+                break;
             case 'trigger':
                 // Trigger edges: solid dark line for control flow
                 edge.style =
@@ -183,7 +217,7 @@ export class EdgeStylingHelper {
             metadata: {
                 ...(edge.data?.metadata || {}),
                 edgeType: edgeCategory,
-                sourcePortDataType: sourcePortDataType || undefined
+                sourcePortDataType: sourcePortDataType ?? undefined
             },
             targetNodeType: targetNode.type,
             targetCategory: targetNode.data.metadata.category
@@ -484,9 +518,26 @@ export class WorkflowOperationsHelper {
         URL.revokeObjectURL(url);
     }
     /**
-     * Check if workflow has cycles
+     * Check if workflow has invalid cycles (excludes valid loopback cycles)
+     * Valid loopback cycles are used for ForEach node iteration and should not
+     * trigger a warning.
+     *
+     * @param nodes - Array of workflow nodes
+     * @param edges - Array of workflow edges
+     * @returns True if there are invalid (non-loopback) cycles
      */
     static checkWorkflowCycles(nodes, edges) {
+        return hasInvalidCycles(nodes, edges);
+    }
+    /**
+     * Check if workflow has any cycles (including valid loopback cycles)
+     * Use this when you need to detect ALL cycles regardless of type.
+     *
+     * @param nodes - Array of workflow nodes
+     * @param edges - Array of workflow edges
+     * @returns True if any cycle exists
+     */
+    static checkWorkflowHasAnyCycles(nodes, edges) {
         return hasCycles(nodes, edges);
     }
 }

package/dist/services/playgroundService.js

@@ -263,8 +263,11 @@ export class PlaygroundService {
                 this.currentBackoff = interval;
                 // Call the callback with new messages
                 callback(response);
-                // Stop polling if session is completed or failed
-                if (response.sessionStatus === 'completed' || response.sessionStatus === 'failed') {
+                // Stop polling if session is idle, completed, or failed
+                // "idle" means no processing is happening (execution finished)
+                if (response.sessionStatus === 'idle' ||
+                    response.sessionStatus === 'completed' ||
+                    response.sessionStatus === 'failed') {
                     this.stopPolling();
                     return;
                 }

package/dist/styles/base.css

@@ -1157,6 +1157,15 @@
 	--flowdrop-edge-data-color-hover: var(--color-ref-gray-500);
 	--flowdrop-edge-data-color-selected: var(--color-ref-violet-600);
 
+	/* Loopback edge styling tokens */
+	--flowdrop-edge-loopback-color: var(--color-ref-gray-500);
+	--flowdrop-edge-loopback-color-hover: var(--color-ref-gray-600);
+	--flowdrop-edge-loopback-color-selected: var(--color-ref-violet-600);
+	--flowdrop-edge-loopback-width: 1.5px;
+	--flowdrop-edge-loopback-width-hover: 2.5px;
+	--flowdrop-edge-loopback-dasharray: 5 5;
+	--flowdrop-edge-loopback-opacity: 0.85;
+
 	/* Tool node theming tokens */
 	--flowdrop-tool-node-color: var(--color-ref-amber-500);
 	--flowdrop-tool-node-color-light: var(--color-ref-amber-50);

package/dist/types/index.d.ts

@@ -656,13 +656,14 @@ export interface WorkflowNode extends Node {
     };
 }
 /**
- * Edge category types based on source port data type
+ * Edge category types based on source port data type or target handle
  * Used for visual styling of edges on the canvas
  * - trigger: For control flow connections (dataType: "trigger")
  * - tool: Dashed amber line for tool connections (dataType: "tool")
+ * - loopback: Dashed gray line for loop iteration (targets loop_back port)
  * - data: Normal gray line for all other data connections
  */
-export type EdgeCategory = 'trigger' | 'tool' | 'data';
+export type EdgeCategory = 'trigger' | 'tool' | 'loopback' | 'data';
 /**
  * Extended edge type for workflows
  */

package/dist/types/playground.d.ts

@@ -178,6 +178,8 @@ export interface PlaygroundConfig {
     showTimestamps?: boolean;
     /** Show log messages inline or in collapsible section (default: "collapsible") */
     logDisplayMode?: 'inline' | 'collapsible';
+    /** Enable markdown rendering in messages (default: true) */
+    enableMarkdown?: boolean;
 }
 /**
  * Display mode for the Playground component

package/dist/utils/connections.d.ts

@@ -2,6 +2,29 @@
  * Connection validation utilities for FlowDrop
  */
 import type { NodeMetadata, NodePort, NodeDataType, WorkflowNode, WorkflowEdge, PortConfig, PortDataTypeConfig } from '../types/index.js';
+/**
+ * Determines if an edge is a loopback edge.
+ * Loopback edges target the special `loop_back` input port on ForEach nodes.
+ * These edges are used to trigger the next iteration in a loop construct.
+ *
+ * @param edge - The edge to check
+ * @returns True if the edge is a loopback edge
+ *
+ * @example
+ * ```typescript
+ * const edge = { targetHandle: "foreach.1-input-loop_back", ... };
+ * const isLoop = isLoopbackEdge(edge); // true
+ * ```
+ */
+export declare function isLoopbackEdge(edge: WorkflowEdge): boolean;
+/**
+ * Checks if a cycle consists entirely of loopback edges.
+ * A valid loopback cycle only contains edges that target loop_back ports.
+ *
+ * @param cycleEdges - Array of edges that form a cycle
+ * @returns True if all edges in the cycle are loopback edges
+ */
+export declare function isValidLoopbackCycle(cycleEdges: WorkflowEdge[]): boolean;
 /**
  * Configurable port compatibility checker
  */
@@ -71,8 +94,31 @@ export declare function getConnectionSuggestions(nodeId: string, nodes: Workflow
 }>;
 /**
  * Check if a workflow has any cycles (prevent infinite loops)
+ * Note: This function detects ALL cycles, including valid loopback cycles.
+ * Use `hasInvalidCycles` to check only for cycles that could cause infinite execution.
+ *
+ * @param nodes - Array of workflow nodes
+ * @param edges - Array of workflow edges
+ * @returns True if any cycle exists in the workflow
  */
 export declare function hasCycles(nodes: WorkflowNode[], edges: WorkflowEdge[]): boolean;
+/**
+ * Check if a workflow has any invalid cycles (non-loopback cycles).
+ * This excludes valid loopback cycles used for ForEach iteration.
+ * Only cycles that could cause infinite execution are detected.
+ *
+ * @param nodes - Array of workflow nodes
+ * @param edges - Array of workflow edges
+ * @returns True if any invalid (non-loopback) cycle exists
+ *
+ * @example
+ * ```typescript
+ * // A cycle through a loopback edge is valid (returns false)
+ * // A cycle through regular data edges is invalid (returns true)
+ * const hasInvalid = hasInvalidCycles(nodes, edges);
+ * ```
+ */
+export declare function hasInvalidCycles(nodes: WorkflowNode[], edges: WorkflowEdge[]): boolean;
 /**
  * Get the execution order for a workflow (topological sort)
  */

package/dist/utils/connections.js

@@ -1,6 +1,39 @@
 /**
  * Connection validation utilities for FlowDrop
  */
+/**
+ * Loopback port name constant
+ * This is the standard input port name used for loop iteration triggers
+ */
+const LOOPBACK_PORT_NAME = "loop_back";
+/**
+ * Determines if an edge is a loopback edge.
+ * Loopback edges target the special `loop_back` input port on ForEach nodes.
+ * These edges are used to trigger the next iteration in a loop construct.
+ *
+ * @param edge - The edge to check
+ * @returns True if the edge is a loopback edge
+ *
+ * @example
+ * ```typescript
+ * const edge = { targetHandle: "foreach.1-input-loop_back", ... };
+ * const isLoop = isLoopbackEdge(edge); // true
+ * ```
+ */
+export function isLoopbackEdge(edge) {
+    const targetHandle = edge.targetHandle ?? "";
+    return targetHandle.includes(`-input-${LOOPBACK_PORT_NAME}`);
+}
+/**
+ * Checks if a cycle consists entirely of loopback edges.
+ * A valid loopback cycle only contains edges that target loop_back ports.
+ *
+ * @param cycleEdges - Array of edges that form a cycle
+ * @returns True if all edges in the cycle are loopback edges
+ */
+export function isValidLoopbackCycle(cycleEdges) {
+    return cycleEdges.every((edge) => isLoopbackEdge(edge));
+}
 /**
  * Configurable port compatibility checker
  */
@@ -225,6 +258,12 @@ export function getConnectionSuggestions(nodeId, nodes, nodeTypes) {
 }
 /**
  * Check if a workflow has any cycles (prevent infinite loops)
+ * Note: This function detects ALL cycles, including valid loopback cycles.
+ * Use `hasInvalidCycles` to check only for cycles that could cause infinite execution.
+ *
+ * @param nodes - Array of workflow nodes
+ * @param edges - Array of workflow edges
+ * @returns True if any cycle exists in the workflow
  */
 export function hasCycles(nodes, edges) {
     const visited = new Set();
@@ -254,6 +293,58 @@ export function hasCycles(nodes, edges) {
     }
     return false;
 }
+/**
+ * Check if a workflow has any invalid cycles (non-loopback cycles).
+ * This excludes valid loopback cycles used for ForEach iteration.
+ * Only cycles that could cause infinite execution are detected.
+ *
+ * @param nodes - Array of workflow nodes
+ * @param edges - Array of workflow edges
+ * @returns True if any invalid (non-loopback) cycle exists
+ *
+ * @example
+ * ```typescript
+ * // A cycle through a loopback edge is valid (returns false)
+ * // A cycle through regular data edges is invalid (returns true)
+ * const hasInvalid = hasInvalidCycles(nodes, edges);
+ * ```
+ */
+export function hasInvalidCycles(nodes, edges) {
+    // Filter out loopback edges - these create valid cycles for loop iteration
+    const nonLoopbackEdges = edges.filter((edge) => !isLoopbackEdge(edge));
+    // Check for cycles using only non-loopback edges
+    const visited = new Set();
+    const recursionStack = new Set();
+    /**
+     * DFS utility to detect cycles in the graph
+     * @param nodeId - Current node being visited
+     * @returns True if a cycle is found from this node
+     */
+    function hasCycleUtil(nodeId) {
+        if (recursionStack.has(nodeId))
+            return true;
+        if (visited.has(nodeId))
+            return false;
+        visited.add(nodeId);
+        recursionStack.add(nodeId);
+        // Get all outgoing non-loopback edges from this node
+        const outgoingEdges = nonLoopbackEdges.filter((e) => e.source === nodeId);
+        for (const edge of outgoingEdges) {
+            if (hasCycleUtil(edge.target))
+                return true;
+        }
+        recursionStack.delete(nodeId);
+        return false;
+    }
+    // Check each node for cycles
+    for (const node of nodes) {
+        if (!visited.has(node.id)) {
+            if (hasCycleUtil(node.id))
+                return true;
+        }
+    }
+    return false;
+}
 /**
  * Get the execution order for a workflow (topological sort)
  */

package/package.json

@@ -2,7 +2,7 @@
 	"name": "@d34dman/flowdrop",
 	"license": "MIT",
 	"private": false,
-	"version": "0.0.32",
+	"version": "0.0.34",
 	"scripts": {
 		"dev": "vite dev",
 		"build": "vite build && npm run prepack",