@d34dman/flowdrop 0.0.61 → 0.0.63

package/dist/mocks/app-navigation.js

@@ -3,10 +3,12 @@
  * Provides minimal implementations for SvelteKit navigation in library context
  */
 
+import { logger } from '../utils/logger.js';
+
 // Mock goto function
 export const goto = async () => {
 	// No-op for library context
-	console.warn('Navigation not available in library context');
+	logger.warn('Navigation not available in library context');
 };
 
 // Mock invalidate function

package/dist/mocks/app-stores.d.ts

@@ -2,13 +2,13 @@ export const page: import("svelte/store").Writable<{
     url: URL;
     params: {};
     route: {
-        id: any;
+        id: null;
     };
     status: number;
-    error: any;
+    error: null;
     data: {};
-    form: any;
+    form: null;
 }>;
-export const navigating: import("svelte/store").Writable<any>;
+export const navigating: import("svelte/store").Writable<null>;
 export const updated: import("svelte/store").Writable<boolean>;
 export function preloadData(): Promise<{}>;

package/dist/playground/index.d.ts

@@ -120,11 +120,12 @@ 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, createPollingCallback, getCurrentSessionId, isSessionSelected, getMessagesSnapshot, getLatestMessageTimestamp } from '../stores/playgroundStore.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';
 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, 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 type { InterruptType, InterruptStatus, Interrupt, InterruptChoice, InterruptConfig, ConfirmationConfig, ChoiceConfig, TextConfig, FormConfig, ReviewConfig, ReviewChange, ReviewFieldDecision, ReviewResolution, 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';
+export { getInterruptsMap, getPendingInterruptIds, getPendingInterrupts, getPendingInterruptCount, getResolvedInterrupts, getIsAnySubmitting, interruptActions, getInterrupt, isInterruptPending, isInterruptSubmitting, getInterruptError, getInterruptByMessageId, interruptHasError } from '../stores/interruptStore.svelte.js';
+export type { InterruptWithState } from '../stores/interruptStore.svelte.js';
 export { mountPlayground, unmountPlayground, type PlaygroundMountOptions, type MountedPlayground } from './mount.js';
 export { createEndpointConfig, defaultEndpointConfig, buildEndpointUrl, type EndpointConfig } from '../config/endpoints.js';

package/dist/playground/index.js

@@ -136,30 +136,32 @@ export { InterruptService, interruptService } from '../services/interruptService
 // Playground Store
 // ============================================================================
 export { 
-// Core stores
-currentSession, sessions, messages, isExecuting, isLoading, error as playgroundError, currentWorkflow, lastPollTimestamp, 
-// Derived stores
-sessionStatus, messageCount, chatMessages, logMessages, latestMessage, inputFields, hasChatInput, sessionCount, 
+// Core state getters
+getCurrentSession, getSessions, getMessages, getIsExecuting, getIsLoading, getError as getPlaygroundError, getCurrentWorkflow, getLastPollTimestamp, 
+// Derived getters
+getSessionStatus, getMessageCount, getChatMessages, getLogMessages, getLatestMessage, getInputFields, getHasChatInput, getSessionCount, 
 // Actions
 playgroundActions, 
 // Polling callback factory
 createPollingCallback, 
+// Subscription utility
+subscribeToSessionStatus, 
 // Utilities
-getCurrentSessionId, isSessionSelected, getMessagesSnapshot, getLatestMessageTimestamp } from '../stores/playgroundStore.js';
+getCurrentSessionId, isSessionSelected, getMessagesSnapshot, getLatestMessageTimestamp } from '../stores/playgroundStore.svelte.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)
 // ============================================================================
 export { 
-// Core stores
-interrupts, 
-// Derived stores
-pendingInterruptIds, pendingInterrupts, pendingInterruptCount, resolvedInterrupts, isAnySubmitting, 
+// Core state accessor
+getInterruptsMap, 
+// Getter functions (replace derived stores)
+getPendingInterruptIds, getPendingInterrupts, getPendingInterruptCount, getResolvedInterrupts, getIsAnySubmitting, 
 // Actions
 interruptActions, 
 // Utilities
-getInterrupt, isInterruptPending, isInterruptSubmitting, getInterruptError, getInterruptByMessageId } from '../stores/interruptStore.js';
+getInterrupt, isInterruptPending, isInterruptSubmitting, getInterruptError, getInterruptByMessageId, interruptHasError } from '../stores/interruptStore.svelte.js';
 // ============================================================================
 // Playground Mount Functions (for vanilla JS / Drupal / IIFE integration)
 // ============================================================================

package/dist/playground/mount.js

@@ -48,8 +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, sessionStatus, playgroundActions, createPollingCallback } from '../stores/playgroundStore.js';
-import { get } from 'svelte/store';
+import { getCurrentSession, getSessions, getMessages, playgroundActions, createPollingCallback, subscribeToSessionStatus } from '../stores/playgroundStore.svelte.js';
 /**
  * Mount the Playground component in a container
  *
@@ -169,13 +168,7 @@ export async function mountPlayground(container, options) {
     // 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;
-            }
-        });
+        unsubscribeStatus = subscribeToSessionStatus(onSessionStatusChange);
     }
     // Create the mounted playground interface
     const mountedPlayground = {
@@ -190,13 +183,13 @@ export async function mountPlayground(container, options) {
             unmount(state.svelteApp);
         },
         getCurrentSession: () => {
-            return get(currentSession);
+            return getCurrentSession();
         },
         getSessions: () => {
-            return get(sessions);
+            return getSessions();
         },
         getMessageCount: () => {
-            return get(messages).length;
+            return getMessages().length;
         },
         isExecuting: () => {
             return playgroundService.isPolling();
@@ -205,7 +198,7 @@ export async function mountPlayground(container, options) {
             playgroundService.stopPolling();
         },
         startPolling: () => {
-            const session = get(currentSession);
+            const session = getCurrentSession();
             if (session) {
                 playgroundService.startPolling(session.id, pollingCallback, pollingInterval, config.shouldStopPolling);
             }

package/dist/services/agentSpecExecutionService.js

@@ -8,6 +8,7 @@
  */
 import { buildAgentSpecUrl, getAgentSpecAuthHeaders } from '../config/agentSpecEndpoints.js';
 import { AgentSpecAdapter } from '../adapters/agentspec/AgentSpecAdapter.js';
+import { logger } from '../utils/logger.js';
 /**
  * Service for executing FlowDrop workflows on Agent Spec runtimes.
  *
@@ -271,7 +272,7 @@ export class AgentSpecExecutionService {
             }
             catch (error) {
                 // Don't stop polling on transient errors — let it retry
-                console.error('[AgentSpecExecution] Polling error:', error);
+                logger.error('[AgentSpecExecution] Polling error:', error);
             }
         };
         // Initial poll immediately, then at interval

package/dist/services/api.js

@@ -142,16 +142,13 @@ export const workflowApi = {
         if (!endpointConfig) {
             throw new Error('Endpoint configuration not set');
         }
-        // Transform workflow data for Drupal backend compatibility
-        // Drupal expects "label" instead of "name"
-        const drupalWorkflow = {
-            ...workflow,
-            label: workflow.name, // Map name to label for Drupal
-            name: workflow.name // Keep name as well for compatibility
-        };
+        // Apply the consumer-provided payload transform (e.g. Drupal's label mapping).
+        // The default is the identity function — no CMS-specific logic in the core library.
+        const transform = endpointConfig.transformWorkflowPayload ?? ((w) => w);
+        const body = transform(workflow);
         const response = await apiRequest('workflows.create', endpointConfig.endpoints.workflows.create, undefined, {
             method: 'POST',
-            body: JSON.stringify(drupalWorkflow)
+            body: JSON.stringify(body)
         });
         if (!response.data) {
             throw new Error('Failed to create workflow');
@@ -165,18 +162,13 @@ export const workflowApi = {
         if (!endpointConfig) {
             throw new Error('Endpoint configuration not set');
         }
-        // Transform workflow data for Drupal backend compatibility
-        // Drupal expects "label" instead of "name"
-        const drupalWorkflow = workflow.name
-            ? {
-                ...workflow,
-                label: workflow.name, // Map name to label for Drupal
-                name: workflow.name // Keep name as well for compatibility
-            }
-            : workflow;
+        // Apply the consumer-provided payload transform (e.g. Drupal's label mapping).
+        // The default is the identity function — no CMS-specific logic in the core library.
+        const transform = endpointConfig.transformWorkflowPayload ?? ((w) => w);
+        const body = transform(workflow);
         const response = await apiRequest('workflows.update', endpointConfig.endpoints.workflows.update, { id }, {
             method: 'PUT',
-            body: JSON.stringify(drupalWorkflow)
+            body: JSON.stringify(body)
         });
         if (!response.data) {
             throw new Error('Failed to update workflow');

package/dist/services/apiVariableService.js

@@ -6,6 +6,7 @@
  * @module services/apiVariableService
  */
 import { getEndpointConfig } from './api.js';
+import { logger } from '../utils/logger.js';
 /**
  * Variable schema cache with TTL support
  * Key format: `variables:{workflowId}:{nodeId}`
@@ -158,7 +159,7 @@ export async function fetchVariableSchema(workflowId, nodeId, config, authProvid
             Object.assign(headers, authHeaders);
         }
         catch (error) {
-            console.warn('Failed to get auth headers:', error);
+            logger.warn('Failed to get auth headers:', error);
         }
     }
     // Add auth headers from endpoint config as fallback

package/dist/services/autoSaveService.d.ts

@@ -28,8 +28,8 @@ interface AutoSaveOptions {
  * Initialize auto-save functionality based on user settings
  *
  * Creates an interval-based auto-save mechanism that:
- * - Subscribes to behaviorSettings for auto-save configuration
- * - Monitors the isDirtyStore to check for unsaved changes
+ * - Listens to behaviorSettings changes for auto-save configuration
+ * - Monitors the isDirty state to check for unsaved changes
  * - Calls the provided save callback when dirty and auto-save is enabled
  *
  * @param options - Auto-save configuration options
@@ -77,7 +77,7 @@ export declare class AutoSaveManager {
     /**
      * Start the auto-save manager
      *
-     * Subscribes to settings changes and starts the auto-save interval.
+     * Listens for settings changes and starts the auto-save interval.
      */
     start(): void;
     /**

package/dist/services/autoSaveService.js

@@ -6,15 +6,15 @@
  *
  * @module services/autoSaveService
  */
-import { get } from 'svelte/store';
-import { behaviorSettings } from '../stores/settingsStore.js';
-import { isDirtyStore, isDirty } from '../stores/workflowStore.js';
+import { getBehaviorSettings, onSettingsChange } from '../stores/settingsStore.svelte.js';
+import { isDirty } from '../stores/workflowStore.svelte.js';
+import { logger } from '../utils/logger.js';
 /**
  * Initialize auto-save functionality based on user settings
  *
  * Creates an interval-based auto-save mechanism that:
- * - Subscribes to behaviorSettings for auto-save configuration
- * - Monitors the isDirtyStore to check for unsaved changes
+ * - Listens to behaviorSettings changes for auto-save configuration
+ * - Monitors the isDirty state to check for unsaved changes
  * - Calls the provided save callback when dirty and auto-save is enabled
  *
  * @param options - Auto-save configuration options
@@ -62,7 +62,7 @@ export function initAutoSave(options) {
         }
         catch (error) {
             const err = error instanceof Error ? error : new Error(String(error));
-            console.error('Auto-save failed:', err);
+            logger.error('Auto-save failed:', err);
             onError?.(err);
         }
         finally {
@@ -78,7 +78,7 @@ export function initAutoSave(options) {
             clearInterval(state.intervalId);
             state.intervalId = null;
         }
-        const settings = get(behaviorSettings);
+        const settings = getBehaviorSettings();
         // Start new interval if auto-save is enabled
         if (settings.autoSave) {
             state.intervalId = setInterval(() => {
@@ -86,9 +86,11 @@ export function initAutoSave(options) {
             }, settings.autoSaveInterval);
         }
     }
-    // Subscribe to settings changes to react to auto-save toggle/interval changes
-    state.settingsUnsubscriber = behaviorSettings.subscribe(() => {
-        updateAutoSaveInterval();
+    // Listen for settings changes to react to auto-save toggle/interval changes
+    state.settingsUnsubscriber = onSettingsChange((event) => {
+        if (event.category === 'behavior') {
+            updateAutoSaveInterval();
+        }
     });
     // Initial setup
     updateAutoSaveInterval();
@@ -101,7 +103,7 @@ export function initAutoSave(options) {
             clearInterval(state.intervalId);
             state.intervalId = null;
         }
-        // Unsubscribe from stores
+        // Unsubscribe from settings changes
         if (state.settingsUnsubscriber) {
             state.settingsUnsubscriber();
             state.settingsUnsubscriber = null;
@@ -138,14 +140,16 @@ export class AutoSaveManager {
     /**
      * Start the auto-save manager
      *
-     * Subscribes to settings changes and starts the auto-save interval.
+     * Listens for settings changes and starts the auto-save interval.
      */
     start() {
         if (this.settingsUnsubscriber) {
             return; // Already started
         }
-        this.settingsUnsubscriber = behaviorSettings.subscribe(() => {
-            this.updateInterval();
+        this.settingsUnsubscriber = onSettingsChange((event) => {
+            if (event.category === 'behavior') {
+                this.updateInterval();
+            }
         });
         this.updateInterval();
     }
@@ -176,7 +180,7 @@ export class AutoSaveManager {
      * Check if auto-save is currently enabled
      */
     isEnabled() {
-        return get(behaviorSettings).autoSave;
+        return getBehaviorSettings().autoSave;
     }
     /**
      * Check if auto-save is currently running
@@ -192,7 +196,7 @@ export class AutoSaveManager {
             clearInterval(this.intervalId);
             this.intervalId = null;
         }
-        const settings = get(behaviorSettings);
+        const settings = getBehaviorSettings();
         if (settings.autoSave) {
             this.intervalId = setInterval(() => {
                 this.performSave();
@@ -213,7 +217,7 @@ export class AutoSaveManager {
         }
         catch (error) {
             const err = error instanceof Error ? error : new Error(String(error));
-            console.error('Auto-save failed:', err);
+            logger.error('Auto-save failed:', err);
             this.onError?.(err);
         }
         finally {

package/dist/services/categoriesApi.js

@@ -2,23 +2,31 @@
  * Categories API Service
  * Handles fetching category definitions from the backend
  */
+import { buildEndpointUrl } from '../config/endpoints.js';
 import { DEFAULT_CATEGORIES } from '../config/defaultCategories.js';
-import { FlowDropApiClient } from '../api/client.js';
+import { logger } from '../utils/logger.js';
 /**
  * Fetch category definitions from API
  */
 export async function fetchCategories(endpointConfig) {
     try {
-        const client = new FlowDropApiClient(endpointConfig.baseUrl);
-        const categories = await client.getCategories();
+        const url = buildEndpointUrl(endpointConfig, endpointConfig.endpoints.categories);
+        const response = await fetch(url, {
+            headers: { 'Content-Type': 'application/json' }
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        const data = await response.json();
+        const categories = data.data ?? data;
         if (!categories || !Array.isArray(categories)) {
-            console.warn('Invalid categories received from API, using default');
+            logger.warn('Invalid categories received from API, using default');
             return DEFAULT_CATEGORIES;
         }
         return categories;
     }
     catch (error) {
-        console.error('Error fetching categories:', error);
+        logger.error('Error fetching categories:', error);
         return DEFAULT_CATEGORIES;
     }
 }

package/dist/services/draftStorage.js

@@ -6,6 +6,7 @@
  *
  * @module services/draftStorage
  */
+import { logger } from '../utils/logger.js';
 /**
  * Default storage key prefix
  */
@@ -51,7 +52,7 @@ export function saveDraft(workflow, storageKey) {
     }
     catch (error) {
         // localStorage might be full or disabled
-        console.warn('Failed to save draft to localStorage:', error);
+        logger.warn('Failed to save draft to localStorage:', error);
         return false;
     }
 }
@@ -70,13 +71,13 @@ export function loadDraft(storageKey) {
         const draft = JSON.parse(stored);
         // Validate the draft structure
         if (!draft.workflow || !draft.metadata) {
-            console.warn('Invalid draft structure in localStorage');
+            logger.warn('Invalid draft structure in localStorage');
             return null;
         }
         return draft;
     }
     catch (error) {
-        console.warn('Failed to load draft from localStorage:', error);
+        logger.warn('Failed to load draft from localStorage:', error);
         return null;
     }
 }
@@ -90,7 +91,7 @@ export function deleteDraft(storageKey) {
         localStorage.removeItem(storageKey);
     }
     catch (error) {
-        console.warn('Failed to delete draft from localStorage:', error);
+        logger.warn('Failed to delete draft from localStorage:', error);
     }
 }
 /**

package/dist/services/dynamicSchemaService.js

@@ -351,15 +351,15 @@ export function getEffectiveConfigEditOptions(node) {
         // Deep merge external edit link
         externalEditLink: (instanceConfig.externalEditLink ?? typeConfig.externalEditLink)
             ? {
-                ...typeConfig.externalEditLink,
-                ...instanceConfig.externalEditLink
+                ...(typeConfig.externalEditLink ?? {}),
+                ...(instanceConfig.externalEditLink ?? {})
             }
             : undefined,
         // Deep merge dynamic schema
         dynamicSchema: (instanceConfig.dynamicSchema ?? typeConfig.dynamicSchema)
             ? {
-                ...typeConfig.dynamicSchema,
-                ...instanceConfig.dynamicSchema
+                ...(typeConfig.dynamicSchema ?? {}),
+                ...(instanceConfig.dynamicSchema ?? {})
             }
             : undefined
     };

package/dist/services/globalSave.d.ts

@@ -1,20 +1,69 @@
 /**
  * Global Save Service
- * Provides save and export functionality that can be accessed from anywhere in the app
- * This allows the main navbar to save workflows without being tied to a specific component
+ * Provides save and export functionality that can be accessed from anywhere in the app.
+ * This is the single source of truth for save/export logic.
+ *
+ * App.svelte delegates to globalSaveWorkflow() / globalExportWorkflow() rather than
+ * reimplementing the logic, ensuring "blur active element" flushing and metadata
+ * construction happen in exactly one place.
  */
+import type { Workflow } from '../types/index.js';
+import type { FlowDropEventHandlers, FlowDropFeatures } from '../types/events.js';
 /**
- * Global save function that can be called from anywhere
- * Uses the current workflow from the global store
+ * Minimal interface for the enhanced API client used when an authProvider is present.
+ * Matches the surface of EnhancedFlowDropApiClient that save needs.
  */
-export declare function globalSaveWorkflow(): Promise<void>;
+export interface SaveApiClient {
+    saveWorkflow(workflow: Workflow): Promise<Workflow>;
+    updateWorkflow(id: string, workflow: Workflow): Promise<Workflow>;
+}
 /**
- * Global export function that can be called from anywhere
- * Uses the current workflow from the global store
+ * Options accepted by globalSaveWorkflow().
+ * All fields are optional — omitting them falls back to the basic behaviour
+ * (no event handlers, always show toasts, legacy workflowApi).
  */
-export declare function globalExportWorkflow(): Promise<void>;
+export interface GlobalSaveOptions {
+    /** Enhanced API client with authProvider support. Falls back to legacy workflowApi when absent. */
+    apiClient?: SaveApiClient | null;
+    /** Event handler hooks (onBeforeSave, onAfterSave, onSaveError, onApiError). */
+    eventHandlers?: FlowDropEventHandlers;
+    /** Feature flags (showToasts). Defaults to DEFAULT_FEATURES. */
+    features?: Partial<FlowDropFeatures>;
+    /**
+     * Callback invoked after a successful save to clear the dirty state.
+     * Pass workflowStore's markAsSaved here when calling from App.svelte.
+     */
+    onMarkAsSaved?: () => void;
+}
 /**
- * Initialize global save functions on window object for external access
- * This allows the functions to be called from anywhere in the application
+ * Options accepted by globalExportWorkflow().
  */
-export declare function initializeGlobalSave(): void;
+export interface GlobalExportOptions {
+    /** Feature flags (showToasts). Defaults to DEFAULT_FEATURES. */
+    features?: Partial<FlowDropFeatures>;
+}
+/**
+ * Save the current workflow to the backend.
+ *
+ * This is the single source of truth for save logic. App.svelte delegates
+ * to this function rather than reimplementing the steps.
+ *
+ * Steps performed:
+ *  1. Flush pending form changes (blur active element + tick)
+ *  2. Optionally call onBeforeSave — return false cancels the save
+ *  3. Build the canonical Workflow object (preserving metadata, format, etc.)
+ *  4. Persist via enhanced apiClient or legacy workflowApi
+ *  5. Update the store if the server assigned a new ID
+ *  6. Call onMarkAsSaved / onAfterSave hooks
+ *  7. Show toast notifications (respecting features.showToasts)
+ */
+export declare function globalSaveWorkflow(options?: GlobalSaveOptions): Promise<void>;
+/**
+ * Export the current workflow as a downloadable JSON file.
+ *
+ * This is the single source of truth for export logic. App.svelte delegates
+ * to this function rather than reimplementing the steps.
+ *
+ * Preserves all metadata fields (format, tags, etc.) consistently with save.
+ */
+export declare function globalExportWorkflow(options?: GlobalExportOptions): Promise<void>;