@d34dman/flowdrop 0.0.59 → 0.0.61

package/dist/components/App.svelte

@@ -6,7 +6,6 @@
 
 <script lang="ts">
 	import { onMount, tick } from 'svelte';
-	import { page } from '$app/stores';
 	import MainLayout from './layouts/MainLayout.svelte';
 	import WorkflowEditor from './WorkflowEditor.svelte';
 	import NodeSidebar from './NodeSidebar.svelte';
@@ -617,7 +616,7 @@
 
 			await fetchNodeTypes();
 
-			// Initialize the workflow store if we have an initial workflow
+			// Initialize the workflow store
 			if (initialWorkflow) {
 				workflowActions.initialize(initialWorkflow);
 
@@ -625,6 +624,22 @@
 				if (eventHandlers?.onWorkflowLoad) {
 					eventHandlers.onWorkflowLoad(initialWorkflow);
 				}
+			} else {
+				// Initialize with a default empty workflow so the editor is functional
+				// (e.g., drag-and-drop requires a non-null workflow in the store)
+				const defaultWorkflow: Workflow = {
+					id: '',
+					name: 'Untitled Workflow',
+					nodes: [],
+					edges: [],
+					metadata: {
+						version: '1.0.0',
+						format: DEFAULT_WORKFLOW_FORMAT,
+						createdAt: new Date().toISOString(),
+						updatedAt: new Date().toISOString()
+					}
+				};
+				workflowActions.initialize(defaultWorkflow);
 			}
 		})();
 
@@ -684,7 +699,7 @@
 
 <!-- MainLayout wrapper for workflow editor -->
 <MainLayout
-	showHeader={showNavbar && !$page.url.pathname.includes('/edit')}
+	showHeader={showNavbar}
 	showLeftSidebar={!disableSidebar}
 	showRightSidebar={showRightPanel}
 	showBottomPanel={false}

package/dist/components/playground/Playground.svelte

@@ -15,8 +15,7 @@
 	import type { EndpointConfig } from '../../config/endpoints.js';
 	import type {
 		PlaygroundMode,
-		PlaygroundConfig,
-		PlaygroundMessagesApiResponse
+		PlaygroundConfig
 	} from '../../types/playground.js';
 	import { playgroundService } from '../../services/playgroundService.js';
 	import { interruptService } from '../../services/interruptService.js';
@@ -29,7 +28,8 @@
 		isLoading,
 		error,
 		playgroundActions,
-		inputFields
+		inputFields,
+		createPollingCallback
 	} from '../../stores/playgroundStore.js';
 	import { interruptActions } from '../../stores/interruptStore.js';
 	import { get } from 'svelte/store';
@@ -408,6 +408,9 @@
 		}
 	}
 
+	/** Shared polling callback created from config lifecycle hooks */
+	const pollingCallback = createPollingCallback(config.isTerminalStatus);
+
 	/**
 	 * Start polling for messages
 	 */
@@ -416,28 +419,9 @@
 
 		playgroundService.startPolling(
 			sessionId,
-			(response: PlaygroundMessagesApiResponse) => {
-				// Add new messages
-				if (response.data && response.data.length > 0) {
-					playgroundActions.addMessages(response.data);
-				}
-
-				// 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
+			pollingCallback,
+			pollingInterval,
+			config.shouldStopPolling
 		);
 	}
 
@@ -451,25 +435,7 @@
 
 		try {
 			const response = await playgroundService.getMessages(sessionId);
-
-			// Add new messages (deduplicates automatically)
-			if (response.data && response.data.length > 0) {
-				playgroundActions.addMessages(response.data);
-			}
-
-			// Update session status
-			if (response.sessionStatus) {
-				playgroundActions.updateSessionStatus(response.sessionStatus);
-
-				// Update executing state based on session status
-				if (
-					response.sessionStatus === 'idle' ||
-					response.sessionStatus === 'completed' ||
-					response.sessionStatus === 'failed'
-				) {
-					playgroundActions.setExecuting(false);
-				}
-			}
+			pollingCallback(response);
 		} catch (err) {
 			console.error('[Playground] Failed to refresh messages after interrupt:', err);
 		}

package/dist/playground/index.d.ts

@@ -120,9 +120,9 @@ export { default as MessageBubble } from '../components/playground/MessageBubble
 export { InterruptBubble, ConfirmationPrompt, ChoicePrompt, TextInputPrompt, FormPrompt } from '../components/interrupt/index.js';
 export { PlaygroundService, playgroundService } from '../services/playgroundService.js';
 export { InterruptService, interruptService } from '../services/interruptService.js';
-export { currentSession, sessions, messages, isExecuting, isLoading, error as playgroundError, currentWorkflow, lastPollTimestamp, sessionStatus, messageCount, chatMessages, logMessages, latestMessage, inputFields, hasChatInput, sessionCount, playgroundActions, getCurrentSessionId, isSessionSelected, getMessagesSnapshot, getLatestMessageTimestamp } from '../stores/playgroundStore.js';
+export { currentSession, sessions, messages, isExecuting, isLoading, error as playgroundError, currentWorkflow, lastPollTimestamp, sessionStatus, messageCount, chatMessages, logMessages, latestMessage, inputFields, hasChatInput, sessionCount, playgroundActions, createPollingCallback, getCurrentSessionId, isSessionSelected, getMessagesSnapshot, getLatestMessageTimestamp } from '../stores/playgroundStore.js';
 export type { PlaygroundSession, PlaygroundMessage, PlaygroundInputField, PlaygroundMessageRequest, PlaygroundMessagesResult, PlaygroundConfig, PlaygroundMode, PlaygroundSessionStatus, PlaygroundMessageRole, PlaygroundMessageLevel, PlaygroundMessageMetadata, PlaygroundApiResponse, PlaygroundSessionsResponse, PlaygroundSessionResponse, PlaygroundMessageResponse, PlaygroundMessagesApiResponse } from '../types/playground.js';
-export { isChatInputNode, CHAT_INPUT_PATTERNS } from '../types/playground.js';
+export { isChatInputNode, CHAT_INPUT_PATTERNS, defaultShouldStopPolling, defaultIsTerminalStatus, DEFAULT_STOP_POLLING_STATUSES, DEFAULT_TERMINAL_STATUSES } from '../types/playground.js';
 export type { InterruptType, InterruptStatus, Interrupt, InterruptChoice, InterruptConfig, ConfirmationConfig, ChoiceConfig, TextConfig, FormConfig, InterruptResolution, InterruptApiResponse, InterruptListResponse, InterruptResponse, InterruptMessageMetadata, InterruptPollingConfig } from '../types/interrupt.js';
 export { isInterruptMetadata, extractInterruptMetadata, metadataToInterrupt, defaultInterruptPollingConfig } from '../types/interrupt.js';
 export { interrupts, pendingInterruptIds, pendingInterrupts, pendingInterruptCount, resolvedInterrupts, isAnySubmitting, interruptActions, getInterrupt, isInterruptPending, isInterruptSubmitting, getInterruptError, getInterruptByMessageId } from '../stores/interruptStore.js';

package/dist/playground/index.js

@@ -142,9 +142,11 @@ currentSession, sessions, messages, isExecuting, isLoading, error as playgroundE
 sessionStatus, messageCount, chatMessages, logMessages, latestMessage, inputFields, hasChatInput, sessionCount, 
 // Actions
 playgroundActions, 
+// Polling callback factory
+createPollingCallback, 
 // Utilities
 getCurrentSessionId, isSessionSelected, getMessagesSnapshot, getLatestMessageTimestamp } from '../stores/playgroundStore.js';
-export { isChatInputNode, CHAT_INPUT_PATTERNS } from '../types/playground.js';
+export { isChatInputNode, CHAT_INPUT_PATTERNS, defaultShouldStopPolling, defaultIsTerminalStatus, DEFAULT_STOP_POLLING_STATUSES, DEFAULT_TERMINAL_STATUSES } from '../types/playground.js';
 export { isInterruptMetadata, extractInterruptMetadata, metadataToInterrupt, defaultInterruptPollingConfig } from '../types/interrupt.js';
 // ============================================================================
 // Interrupt Store (Human-in-the-Loop)

package/dist/playground/mount.d.ts

@@ -45,7 +45,7 @@
  */
 import type { Workflow } from '../types/index.js';
 import type { EndpointConfig } from '../config/endpoints.js';
-import type { PlaygroundMode, PlaygroundConfig, PlaygroundSession } from '../types/playground.js';
+import type { PlaygroundMode, PlaygroundConfig, PlaygroundSession, PlaygroundMessagesApiResponse, PlaygroundSessionStatus } from '../types/playground.js';
 /**
  * Mount options for Playground component
  */
@@ -96,6 +96,13 @@ export interface PlaygroundMountOptions {
      * Callback when playground is closed (required for embedded and modal modes)
      */
     onClose?: () => void;
+    /**
+     * Called when session status changes (from polling or actions)
+     *
+     * @param status - The new session status
+     * @param previousStatus - The previous session status
+     */
+    onSessionStatusChange?: (status: PlaygroundSessionStatus, previousStatus: PlaygroundSessionStatus) => void;
 }
 /**
  * Return type for mounted Playground instance
@@ -130,6 +137,18 @@ export interface MountedPlayground {
      * Stop any active polling
      */
     stopPolling: () => void;
+    /**
+     * Restart polling for the current session
+     * Useful after polling stops (e.g., on awaiting_input) and you want to resume
+     */
+    startPolling: () => void;
+    /**
+     * Push a poll response into the store pipeline.
+     * Use with custom transports (WebSocket/SSE) instead of built-in polling.
+     *
+     * @param response - A PlaygroundMessagesApiResponse to process
+     */
+    pushMessages: (response: PlaygroundMessagesApiResponse) => void;
     /**
      * Reset the playground state
      * Clears the current session and messages

package/dist/playground/mount.js

@@ -48,7 +48,7 @@ import Playground from '../components/playground/Playground.svelte';
 import PlaygroundModal from '../components/playground/PlaygroundModal.svelte';
 import { setEndpointConfig } from '../services/api.js';
 import { playgroundService } from '../services/playgroundService.js';
-import { currentSession, sessions, messages, playgroundActions } from '../stores/playgroundStore.js';
+import { currentSession, sessions, messages, sessionStatus, playgroundActions, createPollingCallback } from '../stores/playgroundStore.js';
 import { get } from 'svelte/store';
 /**
  * Mount the Playground component in a container
@@ -80,7 +80,7 @@ import { get } from 'svelte/store';
  * ```
  */
 export async function mountPlayground(container, options) {
-    const { workflowId, workflow, mode = 'standalone', initialSessionId, endpointConfig, config = {}, height = '100%', width = '100%', onClose } = options;
+    const { workflowId, workflow, mode = 'standalone', initialSessionId, endpointConfig, config = {}, height = '100%', width = '100%', onClose, onSessionStatusChange } = options;
     // Validate required parameters
     if (!workflowId) {
         throw new Error('workflowId is required for mountPlayground()');
@@ -163,9 +163,25 @@ export async function mountPlayground(container, options) {
         originalContainer: mode === 'modal' ? container : undefined,
         workflowId
     };
+    // Create shared polling callback using lifecycle hooks from config
+    const pollingCallback = createPollingCallback(config.isTerminalStatus);
+    const pollingInterval = config.pollingInterval ?? 1500;
+    // Subscribe to session status changes if callback provided
+    let unsubscribeStatus;
+    if (onSessionStatusChange) {
+        let previousStatus = get(sessionStatus);
+        unsubscribeStatus = sessionStatus.subscribe((status) => {
+            if (status !== previousStatus) {
+                onSessionStatusChange(status, previousStatus);
+                previousStatus = status;
+            }
+        });
+    }
     // Create the mounted playground interface
     const mountedPlayground = {
         destroy: () => {
+            // Unsubscribe from status changes
+            unsubscribeStatus?.();
             // Stop any active polling
             playgroundService.stopPolling();
             // Reset playground state
@@ -188,6 +204,15 @@ export async function mountPlayground(container, options) {
         stopPolling: () => {
             playgroundService.stopPolling();
         },
+        startPolling: () => {
+            const session = get(currentSession);
+            if (session) {
+                playgroundService.startPolling(session.id, pollingCallback, pollingInterval, config.shouldStopPolling);
+            }
+        },
+        pushMessages: (response) => {
+            pollingCallback(response);
+        },
         reset: () => {
             playgroundService.stopPolling();
             playgroundActions.reset();

package/dist/services/playgroundService.d.ts

@@ -6,7 +6,7 @@
  *
  * @module services/playgroundService
  */
-import type { PlaygroundSession, PlaygroundMessage, PlaygroundMessagesApiResponse } from '../types/playground.js';
+import type { PlaygroundSession, PlaygroundMessage, PlaygroundMessagesApiResponse, PlaygroundSessionStatus } from '../types/playground.js';
 /**
  * Playground Service class
  *
@@ -104,8 +104,9 @@ export declare class PlaygroundService {
      * @param sessionId - The session UUID to poll
      * @param callback - Callback function to handle new messages
      * @param interval - Polling interval in milliseconds (default: 1500)
+     * @param shouldStopPolling - Optional override for stop conditions (default: defaultShouldStopPolling)
      */
-    startPolling(sessionId: string, callback: (response: PlaygroundMessagesApiResponse) => void, interval?: number): void;
+    startPolling(sessionId: string, callback: (response: PlaygroundMessagesApiResponse) => void, interval?: number, shouldStopPolling?: (status: PlaygroundSessionStatus) => boolean): void;
     /**
      * Stop polling for messages
      */

package/dist/services/playgroundService.js

@@ -6,6 +6,7 @@
  *
  * @module services/playgroundService
  */
+import { defaultShouldStopPolling } from '../types/playground.js';
 import { buildEndpointUrl, getEndpointHeaders } from '../config/endpoints.js';
 import { getEndpointConfig } from './api.js';
 /**
@@ -241,13 +242,15 @@ export class PlaygroundService {
      * @param sessionId - The session UUID to poll
      * @param callback - Callback function to handle new messages
      * @param interval - Polling interval in milliseconds (default: 1500)
+     * @param shouldStopPolling - Optional override for stop conditions (default: defaultShouldStopPolling)
      */
-    startPolling(sessionId, callback, interval = DEFAULT_POLLING_INTERVAL) {
+    startPolling(sessionId, callback, interval = DEFAULT_POLLING_INTERVAL, shouldStopPolling) {
         // Stop any existing polling
         this.stopPolling();
         this.pollingSessionId = sessionId;
         this.currentBackoff = interval;
         this.lastMessageTimestamp = null;
+        const shouldStop = shouldStopPolling ?? defaultShouldStopPolling;
         const poll = async () => {
             if (this.pollingSessionId !== sessionId) {
                 return;
@@ -263,11 +266,8 @@ export class PlaygroundService {
                 this.currentBackoff = interval;
                 // Call the callback with new messages
                 callback(response);
-                // 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') {
+                // Stop polling if the status matches the stop condition
+                if (response.sessionStatus && shouldStop(response.sessionStatus)) {
                     this.stopPolling();
                     return;
                 }

package/dist/stores/playgroundStore.d.ts

@@ -175,6 +175,15 @@ export declare const playgroundActions: {
      */
     switchSession: (sessionId: string) => void;
 };
+/**
+ * Create a polling callback that processes poll responses.
+ * This is the single source of truth for how poll responses update stores.
+ * Used by mount.ts, Playground.svelte, and refreshSessionMessages.
+ *
+ * @param isTerminalStatus - Function to determine if a status clears isExecuting (default: defaultIsTerminalStatus)
+ * @returns A callback suitable for playgroundService.startPolling() or pushMessages()
+ */
+export declare function createPollingCallback(isTerminalStatus?: (status: PlaygroundSessionStatus) => boolean): (response: PlaygroundMessagesApiResponse) => void;
 /**
  * Get the current session ID
  *
@@ -207,6 +216,7 @@ export declare function getLatestMessageTimestamp(): string | null;
  * has stopped but new messages may exist on the server.
  *
  * @param fetchMessages - Async function to fetch messages from the API
+ * @param isTerminalStatus - Optional override for terminal status check
  * @returns Promise that resolves when messages are refreshed
  */
-export declare function refreshSessionMessages(fetchMessages: (sessionId: string) => Promise<PlaygroundMessagesApiResponse>): Promise<void>;
+export declare function refreshSessionMessages(fetchMessages: (sessionId: string) => Promise<PlaygroundMessagesApiResponse>, isTerminalStatus?: (status: PlaygroundSessionStatus) => boolean): Promise<void>;

package/dist/stores/playgroundStore.js

@@ -7,7 +7,7 @@
  * @module stores/playgroundStore
  */
 import { writable, derived, get } from 'svelte/store';
-import { isChatInputNode } from '../types/playground.js';
+import { isChatInputNode, defaultIsTerminalStatus } from '../types/playground.js';
 // =========================================================================
 // Core Stores
 // =========================================================================
@@ -348,6 +348,30 @@ export const playgroundActions = {
     }
 };
 // =========================================================================
+// Polling Callback Factory
+// =========================================================================
+/**
+ * Create a polling callback that processes poll responses.
+ * This is the single source of truth for how poll responses update stores.
+ * Used by mount.ts, Playground.svelte, and refreshSessionMessages.
+ *
+ * @param isTerminalStatus - Function to determine if a status clears isExecuting (default: defaultIsTerminalStatus)
+ * @returns A callback suitable for playgroundService.startPolling() or pushMessages()
+ */
+export function createPollingCallback(isTerminalStatus = defaultIsTerminalStatus) {
+    return (response) => {
+        if (response.data && response.data.length > 0) {
+            playgroundActions.addMessages(response.data);
+        }
+        if (response.sessionStatus) {
+            playgroundActions.updateSessionStatus(response.sessionStatus);
+            if (isTerminalStatus(response.sessionStatus)) {
+                playgroundActions.setExecuting(false);
+            }
+        }
+    };
+}
+// =========================================================================
 // Utilities
 // =========================================================================
 /**
@@ -393,28 +417,17 @@ export function getLatestMessageTimestamp() {
  * has stopped but new messages may exist on the server.
  *
  * @param fetchMessages - Async function to fetch messages from the API
+ * @param isTerminalStatus - Optional override for terminal status check
  * @returns Promise that resolves when messages are refreshed
  */
-export async function refreshSessionMessages(fetchMessages) {
+export async function refreshSessionMessages(fetchMessages, isTerminalStatus) {
     const session = get(currentSession);
     if (!session)
         return;
     try {
         const response = await fetchMessages(session.id);
-        // Add new messages (deduplicates automatically)
-        if (response.data && response.data.length > 0) {
-            playgroundActions.addMessages(response.data);
-        }
-        // Update session status
-        if (response.sessionStatus) {
-            playgroundActions.updateSessionStatus(response.sessionStatus);
-            // Update executing state based on session status
-            if (response.sessionStatus === 'idle' ||
-                response.sessionStatus === 'completed' ||
-                response.sessionStatus === 'failed') {
-                isExecuting.set(false);
-            }
-        }
+        const callback = createPollingCallback(isTerminalStatus);
+        callback(response);
     }
     catch (err) {
         console.error('[playgroundStore] Failed to refresh messages:', err);

package/dist/types/playground.d.ts

@@ -10,7 +10,31 @@ import type { ConfigProperty } from './index.js';
 /**
  * Status of a playground session
  */
-export type PlaygroundSessionStatus = 'idle' | 'running' | 'completed' | 'failed';
+export type PlaygroundSessionStatus = 'idle' | 'running' | 'awaiting_input' | 'completed' | 'failed';
+/**
+ * Statuses that stop polling by default (resource efficiency)
+ */
+export declare const DEFAULT_STOP_POLLING_STATUSES: PlaygroundSessionStatus[];
+/**
+ * Statuses that are considered terminal by default (clears isExecuting)
+ */
+export declare const DEFAULT_TERMINAL_STATUSES: PlaygroundSessionStatus[];
+/**
+ * Default implementation for determining if polling should stop.
+ * Consumers can override this via PlaygroundConfig.shouldStopPolling.
+ *
+ * @param status - The current session status
+ * @returns True if polling should stop
+ */
+export declare function defaultShouldStopPolling(status: PlaygroundSessionStatus): boolean;
+/**
+ * Default implementation for determining if a status is terminal (clears isExecuting).
+ * Consumers can override this via PlaygroundConfig.isTerminalStatus.
+ *
+ * @param status - The current session status
+ * @returns True if the status is terminal
+ */
+export declare function defaultIsTerminalStatus(status: PlaygroundSessionStatus): boolean;
 /**
  * Role of a message sender in the playground
  *
@@ -231,6 +255,18 @@ export interface PlaygroundConfig {
      * Typically used together with showSidebar: false for minimal UI.
      */
     showSessionHeader?: boolean;
+    /**
+     * Determines if polling should stop for a given session status.
+     * Override to customize which statuses pause polling.
+     * @default defaultShouldStopPolling (stops on idle, completed, failed, awaiting_input)
+     */
+    shouldStopPolling?: (status: PlaygroundSessionStatus) => boolean;
+    /**
+     * Determines if a session status is terminal (clears isExecuting).
+     * Override to customize which statuses end the executing state.
+     * @default defaultIsTerminalStatus (terminal on idle, completed, failed, awaiting_input)
+     */
+    isTerminalStatus?: (status: PlaygroundSessionStatus) => boolean;
 }
 /**
  * Metadata field to control Run button state from backend.

package/dist/types/playground.js

@@ -6,6 +6,44 @@
  *
  * @module types/playground
  */
+/**
+ * Statuses that stop polling by default (resource efficiency)
+ */
+export const DEFAULT_STOP_POLLING_STATUSES = [
+    'idle',
+    'completed',
+    'failed',
+    'awaiting_input'
+];
+/**
+ * Statuses that are considered terminal by default (clears isExecuting)
+ */
+export const DEFAULT_TERMINAL_STATUSES = [
+    'idle',
+    'completed',
+    'failed',
+    'awaiting_input'
+];
+/**
+ * Default implementation for determining if polling should stop.
+ * Consumers can override this via PlaygroundConfig.shouldStopPolling.
+ *
+ * @param status - The current session status
+ * @returns True if polling should stop
+ */
+export function defaultShouldStopPolling(status) {
+    return DEFAULT_STOP_POLLING_STATUSES.includes(status);
+}
+/**
+ * Default implementation for determining if a status is terminal (clears isExecuting).
+ * Consumers can override this via PlaygroundConfig.isTerminalStatus.
+ *
+ * @param status - The current session status
+ * @returns True if the status is terminal
+ */
+export function defaultIsTerminalStatus(status) {
+    return DEFAULT_TERMINAL_STATUSES.includes(status);
+}
 /**
  * Metadata field to control Run button state from backend.
  * When a message contains this field set to true, the Run button becomes enabled.

package/package.json

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