@flowdrop/flowdrop 1.15.0 → 2.0.0-beta.2

package/dist/helpers/workflowEditorHelper.js

@@ -3,9 +3,8 @@
  * Contains business logic for workflow operations
  */
 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';
+import { getDefaultInstance } from '../stores/instanceContainer.svelte.js';
 import { nodeExecutionService } from '../services/nodeExecutionService.js';
 import { WorkflowAdapter } from '../adapters/WorkflowAdapter.js';
 import { AgentSpecAdapter } from '../adapters/agentspec/AgentSpecAdapter.js';
@@ -49,14 +48,14 @@ export class NodeOperationsHelper {
     /**
      * Load nodes from API
      */
-    static async loadNodesFromApi(providedNodes) {
+    static async loadNodesFromApi(api, providedNodes) {
         // If nodes are provided via props, use them
         if (providedNodes && providedNodes.length > 0) {
             return providedNodes;
         }
         // Otherwise, load from API
         try {
-            const fetchedNodes = await nodeApi.getNodes();
+            const fetchedNodes = await api.client.getAvailableNodes();
             return fetchedNodes;
         }
         catch (error) {
@@ -89,7 +88,7 @@ export class NodeOperationsHelper {
     /**
      * Load node execution information for all nodes in the workflow
      */
-    static async loadNodeExecutionInfo(workflow, pipelineId) {
+    static async loadNodeExecutionInfo(api, workflow, pipelineId) {
         if (!workflow?.nodes)
             return {};
         // Only load execution info if we have a pipelineId (for pipeline status mode)
@@ -97,7 +96,7 @@ export class NodeOperationsHelper {
             return {};
         try {
             const nodeIds = workflow.nodes.map((node) => node.id);
-            const executionInfo = await nodeExecutionService.getMultipleNodeExecutionInfo(nodeIds, pipelineId);
+            const executionInfo = await nodeExecutionService.getMultipleNodeExecutionInfo(api.config, nodeIds, pipelineId);
             return executionInfo;
         }
         catch (error) {
@@ -160,7 +159,7 @@ export class WorkflowOperationsHelper {
     static generateMetadata(existingMetadata) {
         const now = new Date().toISOString();
         return {
-            version: '1.0.0',
+            schemaVersion: '1.0.0',
             createdAt: now,
             ...(existingMetadata ?? {}),
             updatedAt: now,
@@ -217,38 +216,41 @@ export class WorkflowOperationsHelper {
     }
     /**
      * Save workflow to backend
+     *
+     * @param api - The instance's API context (endpoints + client)
+     * @param workflow - The workflow to save
+     * @param instance - The FlowDrop instance whose store should be synced when
+     *   the server assigns a new ID; defaults to the page-default instance
      */
-    static async saveWorkflow(workflow) {
+    static async saveWorkflow(api, workflow, instance) {
         if (!workflow) {
             logger.warn('No workflow data available to save');
             return null;
         }
         try {
-            // Determine the workflow ID based on whether we have an existing workflow
-            let workflowId;
-            if (workflow.id) {
-                // Use the existing workflow ID
-                workflowId = workflow.id;
-            }
-            else {
-                // Generate a new UUID for a new workflow
-                workflowId = uuidv4();
-            }
+            // Determine new vs existing BEFORE the uuidv4() fallback: a present id (any
+            // format) means the workflow came from a backend and must be updated. Only
+            // a missing id means "truly new".
+            const isExistingWorkflow = !!workflow.id;
+            const workflowId = workflow.id || uuidv4();
             const workflowToSave = {
                 id: workflowId,
                 name: workflow.name || 'Untitled Workflow',
                 nodes: workflow.nodes || [],
                 edges: workflow.edges || [],
                 metadata: {
-                    version: '1.0.0',
+                    schemaVersion: workflow.metadata?.schemaVersion || '1.0.0',
                     createdAt: workflow.metadata?.createdAt || new Date().toISOString(),
                     updatedAt: new Date().toISOString()
                 }
             };
-            const savedWorkflow = await workflowApi.saveWorkflow(workflowToSave);
+            const savedWorkflow = isExistingWorkflow
+                ? await api.client.updateWorkflow(workflowToSave.id, workflowToSave)
+                : await api.client.saveWorkflow(workflowToSave);
             // Update the workflow ID if it changed (new workflow)
             if (savedWorkflow.id && savedWorkflow.id !== workflowToSave.id) {
-                workflowActions.batchUpdate({
+                const fd = instance ?? getDefaultInstance();
+                fd.workflow.batchUpdate({
                     nodes: workflowToSave.nodes,
                     edges: workflowToSave.edges,
                     name: workflowToSave.name,
@@ -281,7 +283,7 @@ export class WorkflowOperationsHelper {
             nodes: workflow.nodes || [],
             edges: workflow.edges || [],
             metadata: {
-                version: '1.0.0',
+                schemaVersion: workflow.metadata?.schemaVersion || '1.0.0',
                 createdAt: workflow.metadata?.createdAt || new Date().toISOString(),
                 updatedAt: new Date().toISOString()
             }
@@ -380,9 +382,10 @@ export class WorkflowOperationsHelper {
  */
 export class ConfigurationHelper {
     /**
-     * Configure API endpoints
+     * Configure API endpoints (and optionally the auth provider) on the given
+     * instance's API context.
      */
-    static configureEndpoints(config) {
-        setEndpointConfig(config);
+    static configureEndpoints(api, config, authProvider) {
+        api.configure(config, authProvider);
     }
 }

package/dist/index.d.ts

@@ -1,37 +1,41 @@
 /**
  * FlowDrop - Visual Workflow Editor Library
  *
- * A Svelte 5 component library built on @xyflow/svelte for creating node-based workflow editors.
+ * A Svelte 5 component library built on @xyflow/svelte for creating node-based
+ * workflow editors.
  *
- * ## Module Structure (Tree-Shakable)
+ * ## The main entry is a minimal front door
  *
- * For optimal bundle size, import from specific sub-modules:
+ * This entry point intentionally exposes only the small surface most apps need
+ * to get started: the `App` component, the `mountFlowDropApp` / `unmountFlowDropApp`
+ * mount helpers, instance plumbing (`createFlowDropInstance` / `getInstance` /
+ * `provideInstance`), endpoint + auth helpers, and the core public types. It does
+ * NOT re-export the entire library.
  *
- * - `@flowdrop/flowdrop/core` - Types and utilities only (no heavy deps)
- * - `@flowdrop/flowdrop/editor` - WorkflowEditor with @xyflow/svelte
+ * Everything else lives in focused sub-modules — import from the one you need:
+ *
+ * - `@flowdrop/flowdrop/core` - Types, utilities, theme/skin, messages helpers (no heavy deps)
+ * - `@flowdrop/flowdrop/editor` - WorkflowEditor, registries, stores, services (adds @xyflow/svelte)
  * - `@flowdrop/flowdrop/form` - SchemaForm with basic fields
- * - `@flowdrop/flowdrop/form/code` - Code editor support (adds CodeMirror)
- * - `@flowdrop/flowdrop/form/markdown` - Markdown editor support (CodeMirror 6)
+ * - `@flowdrop/flowdrop/form/code` - Code editor field (adds CodeMirror)
+ * - `@flowdrop/flowdrop/form/markdown` - Markdown editor field (CodeMirror 6)
  * - `@flowdrop/flowdrop/display` - MarkdownDisplay (adds marked)
  * - `@flowdrop/flowdrop/playground` - Playground for interactive workflow testing
+ * - `@flowdrop/flowdrop/settings` - Settings stores, services, components
  * - `@flowdrop/flowdrop/styles` - CSS styles
  *
- * ## Legacy Import (Full Bundle)
- *
- * Importing from the main entry point includes everything:
- *
- * ```typescript
- * import { WorkflowEditor, SchemaForm } from "@flowdrop/flowdrop";
- * ```
- *
- * **Note**: This will bundle ALL dependencies including @xyflow/svelte,
- * CodeMirror and marked. For smaller bundles, use sub-modules.
- *
  * @module flowdrop
  */
-export * from './core/index.js';
-export * from './form/index.js';
-export * from './display/index.js';
-export * from './playground/index.js';
-export * from './editor/index.js';
-export * from './settings/index.js';
+export { default as App } from './components/App.svelte';
+export { mountFlowDropApp, unmountFlowDropApp } from './svelte-app.js';
+export { createFlowDropInstance } from './stores/instanceContainer.svelte.js';
+export { getInstance, provideInstance } from './stores/getInstance.svelte.js';
+export { createEndpointConfig, defaultEndpointConfig } from './config/endpoints.js';
+export { NoAuthProvider, StaticAuthProvider, CallbackAuthProvider } from './types/auth.js';
+export type { Workflow, WorkflowNode, WorkflowEdge, NodeMetadata, ConfigSchema } from './types/index.js';
+export type { EndpointConfig } from './config/endpoints.js';
+export type { AuthProvider } from './types/auth.js';
+export type { FlowDropInstance } from './stores/instanceContainer.svelte.js';
+export type { FlowDropMountOptions, MountedFlowDropApp } from './svelte-app.js';
+export type { FlowDropEventHandlers } from './types/events.js';
+export type { Messages, MessagesOverride } from './messages/index.js';

package/dist/index.js

@@ -1,64 +1,41 @@
 /**
  * FlowDrop - Visual Workflow Editor Library
  *
- * A Svelte 5 component library built on @xyflow/svelte for creating node-based workflow editors.
+ * A Svelte 5 component library built on @xyflow/svelte for creating node-based
+ * workflow editors.
  *
- * ## Module Structure (Tree-Shakable)
+ * ## The main entry is a minimal front door
  *
- * For optimal bundle size, import from specific sub-modules:
+ * This entry point intentionally exposes only the small surface most apps need
+ * to get started: the `App` component, the `mountFlowDropApp` / `unmountFlowDropApp`
+ * mount helpers, instance plumbing (`createFlowDropInstance` / `getInstance` /
+ * `provideInstance`), endpoint + auth helpers, and the core public types. It does
+ * NOT re-export the entire library.
  *
- * - `@flowdrop/flowdrop/core` - Types and utilities only (no heavy deps)
- * - `@flowdrop/flowdrop/editor` - WorkflowEditor with @xyflow/svelte
+ * Everything else lives in focused sub-modules — import from the one you need:
+ *
+ * - `@flowdrop/flowdrop/core` - Types, utilities, theme/skin, messages helpers (no heavy deps)
+ * - `@flowdrop/flowdrop/editor` - WorkflowEditor, registries, stores, services (adds @xyflow/svelte)
  * - `@flowdrop/flowdrop/form` - SchemaForm with basic fields
- * - `@flowdrop/flowdrop/form/code` - Code editor support (adds CodeMirror)
- * - `@flowdrop/flowdrop/form/markdown` - Markdown editor support (CodeMirror 6)
+ * - `@flowdrop/flowdrop/form/code` - Code editor field (adds CodeMirror)
+ * - `@flowdrop/flowdrop/form/markdown` - Markdown editor field (CodeMirror 6)
  * - `@flowdrop/flowdrop/display` - MarkdownDisplay (adds marked)
  * - `@flowdrop/flowdrop/playground` - Playground for interactive workflow testing
+ * - `@flowdrop/flowdrop/settings` - Settings stores, services, components
  * - `@flowdrop/flowdrop/styles` - CSS styles
  *
- * ## Legacy Import (Full Bundle)
- *
- * Importing from the main entry point includes everything:
- *
- * ```typescript
- * import { WorkflowEditor, SchemaForm } from "@flowdrop/flowdrop";
- * ```
- *
- * **Note**: This will bundle ALL dependencies including @xyflow/svelte,
- * CodeMirror and marked. For smaller bundles, use sub-modules.
- *
  * @module flowdrop
  */
 // ============================================================================
-// IMPORTANT: This module re-exports from sub-modules for backward compatibility.
-// New code should import directly from sub-modules for better tree-shaking.
-//
-// The wildcard re-exports below are intentional: each sub-module barrel uses
-// explicit named exports, so the public API surface is fully controlled there.
-// ============================================================================
-// ============================================================================
-// Core Exports (Types & Utilities - No Heavy Dependencies)
-// ============================================================================
-export * from './core/index.js';
-// ============================================================================
-// Form Exports
-// ============================================================================
-export * from './form/index.js';
-// Note: Heavy form fields (code, markdown) are NOT auto-registered.
-// Users must import from form/code or form/markdown and register explicitly.
-// ============================================================================
-// Display Exports
-// ============================================================================
-export * from './display/index.js';
-// ============================================================================
-// Playground Exports
-// ============================================================================
-export * from './playground/index.js';
-// ============================================================================
-// Editor Exports (includes @xyflow/svelte and auto-registers builtin nodes)
-// ============================================================================
-export * from './editor/index.js';
-// ============================================================================
-// Settings Exports (stores, services, components, types)
-// ============================================================================
-export * from './settings/index.js';
+// Values
+// ============================================================================
+// App component + vanilla-JS mount lifecycle.
+export { default as App } from './components/App.svelte';
+export { mountFlowDropApp, unmountFlowDropApp } from './svelte-app.js';
+// Instance plumbing — per-instance state container + Svelte context helpers.
+export { createFlowDropInstance } from './stores/instanceContainer.svelte.js';
+export { getInstance, provideInstance } from './stores/getInstance.svelte.js';
+// Endpoint configuration helpers.
+export { createEndpointConfig, defaultEndpointConfig } from './config/endpoints.js';
+// Authentication providers.
+export { NoAuthProvider, StaticAuthProvider, CallbackAuthProvider } from './types/auth.js';

package/dist/messages/defaults.d.ts

@@ -279,12 +279,8 @@ export declare const defaultMessages: {
             readonly predefinedRun: "Run workflow";
         };
         readonly states: {
-            readonly viewOnlyTitle: "View only";
-            readonly viewOnlyText: "This playground is in view-only mode. No inputs are available.";
             readonly newSessionTitle: "New session";
             readonly newSessionText: "Test your flow with a prompt";
-            readonly readyTitle: "Ready to run";
-            readonly readyText: "Click Run to execute your workflow";
             readonly processing: "Processing...";
             readonly viewOnlyHelp: "View-only mode. Workflow execution is controlled externally.";
         };
@@ -342,7 +338,7 @@ export declare const defaultMessages: {
             readonly newSession: "New session";
         };
         readonly controlPanel: {
-            readonly sessionsLabel: "Sessions";
+            readonly sessionsLabel: "Session";
             readonly noSession: "No session";
             readonly switchSession: "Switch session";
             readonly newSession: "New session";
@@ -420,6 +416,7 @@ export declare const defaultMessages: {
             readonly lastRunLabel: "Last Run:";
             readonly durationLabel: "Duration:";
             readonly errorLabel: "Error:";
+            readonly historyLabel: "Runs:";
         };
     };
 };

package/dist/messages/defaults.js

@@ -258,12 +258,8 @@ export const defaultMessages = {
             predefinedRun: 'Run workflow'
         },
         states: {
-            viewOnlyTitle: 'View only',
-            viewOnlyText: 'This playground is in view-only mode. No inputs are available.',
             newSessionTitle: 'New session',
             newSessionText: 'Test your flow with a prompt',
-            readyTitle: 'Ready to run',
-            readyText: 'Click Run to execute your workflow',
             processing: 'Processing...',
             viewOnlyHelp: 'View-only mode. Workflow execution is controlled externally.'
         },
@@ -316,7 +312,7 @@ export const defaultMessages = {
             newSession: 'New session'
         },
         controlPanel: {
-            sessionsLabel: 'Sessions',
+            sessionsLabel: 'Session',
             noSession: 'No session',
             switchSession: 'Switch session',
             newSession: 'New session',
@@ -380,7 +376,8 @@ export const defaultMessages = {
             executionsLabel: 'Executions:',
             lastRunLabel: 'Last Run:',
             durationLabel: 'Duration:',
-            errorLabel: 'Error:'
+            errorLabel: 'Error:',
+            historyLabel: 'Runs:'
         }
     }
 };

package/dist/messages/index.d.ts

@@ -7,5 +7,4 @@
 export { defaultMessages } from './defaults.js';
 export { mergeMessages } from './merge.js';
 export { setMessages, getMessages, m } from './context.js';
-export { warnDeprecatedProp, __resetDeprecationWarningsForTests } from './deprecation.js';
 export type { Messages, MessagesOverride, DeepPartial } from './types.js';

package/dist/messages/index.js

@@ -7,4 +7,3 @@
 export { defaultMessages } from './defaults.js';
 export { mergeMessages } from './merge.js';
 export { setMessages, getMessages, m } from './context.js';
-export { warnDeprecatedProp, __resetDeprecationWarningsForTests } from './deprecation.js';

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

@@ -1,2 +1,6 @@
-export function enhance(form: any, options?: {}): (event: any) => void;
-export function applyAction(action: any): any;
+export function enhance(_form: HTMLFormElement, options?: {
+    onResult?: (result: {
+        type: string;
+    }) => void;
+}): (event: SubmitEvent) => void;
+export function applyAction(action: unknown): unknown;

package/dist/mocks/app-forms.js

@@ -1,11 +1,15 @@
-// @ts-nocheck
 /**
  * Mock for $app/forms
  * Provides minimal implementations for SvelteKit forms in library context
  */
 
-// Mock enhance function
-export const enhance = (form, options = {}) => {
+/**
+ * Mock enhance function
+ * @param {HTMLFormElement} _form
+ * @param {{ onResult?: (result: { type: string }) => void }} [options]
+ */
+export const enhance = (_form, options = {}) => {
+  /** @param {SubmitEvent} event */
   return (event) => {
     event.preventDefault();
     // Basic form handling for library context
@@ -15,7 +19,10 @@ export const enhance = (form, options = {}) => {
   };
 };
 
-// Mock applyAction function
+/**
+ * Mock applyAction function
+ * @param {unknown} action
+ */
 export const applyAction = (action) => {
   // No-op for library context
   return action;

package/dist/openapi/v1/openapi.yaml

@@ -3923,9 +3923,9 @@ components:
     WorkflowMetadata:
       type: object
       properties:
-        version:
+        schemaVersion:
           type: string
-          description: Workflow version
+          description: Workflow schema format version — identifies the document format, not the workflow's own revision.
           example: 1.0.0
         createdAt:
           type: string
@@ -3963,7 +3963,7 @@ components:
           example: flowdrop
           default: flowdrop
       required:
-        - version
+        - schemaVersion
         - createdAt
         - updatedAt
     Workflow:

package/dist/playground/index.d.ts

@@ -126,15 +126,14 @@ export { default as InputCollector } from '../components/playground/InputCollect
 export { default as ExecutionLogs } from '../components/playground/ExecutionLogs.svelte';
 export { default as MessageBubble } from '../components/playground/MessageBubble.svelte';
 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, getCanSendMessage, getIsLoading, getError as getPlaygroundError, getCurrentWorkflow, getLastPollSequenceNumber, getSessionStatus, getMessageCount, getChatMessages, getLogMessages, getLatestMessage, getInputFields, getHasChatInput, getSessionCount, getActiveExecutionId, getPinnedExecutionId, getLatestExecutionId, getShowLogs, playgroundActions, applyServerResponse, subscribeToSessionStatus, getCurrentSessionId, isSessionSelected, getMessagesSnapshot, getLatestSequenceNumber } from '../stores/playgroundStore.svelte.js';
-export { getPipelinePanelOpen, pipelinePanelActions } from '../stores/pipelinePanelStore.svelte.js';
+export { PlaygroundService } from '../services/playgroundService.js';
+export { InterruptService } from '../services/interruptService.js';
+export { PlaygroundStore } from '../stores/playgroundStore.svelte.js';
 export type { PlaygroundSession, PlaygroundMessage, PlaygroundInputField, PlaygroundMessageRequest, PlaygroundMessagesResult, PlaygroundConfig, PlaygroundMode, PlaygroundSessionStatus, PlaygroundMessageRole, PlaygroundMessageLevel, PlaygroundMessageMetadata, PlaygroundApiResponse, PlaygroundSessionsResponse, PlaygroundSessionResponse, PlaygroundMessageResponse, PlaygroundMessagesApiResponse, PlaygroundExecution } 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, ReviewConfig, ReviewChange, ReviewFieldDecision, ReviewResolution, InterruptResolution, InterruptApiResponse, InterruptListResponse, InterruptResponse, InterruptMessageMetadata, InterruptPollingConfig } from '../types/interrupt.js';
 export { isInterruptMetadata, extractInterruptMetadata, metadataToInterrupt, defaultInterruptPollingConfig } from '../types/interrupt.js';
-export { getInterruptsMap, getPendingInterruptIds, getPendingInterrupts, getPendingInterruptCount, getResolvedInterrupts, getIsAnySubmitting, interruptActions, getInterrupt, isInterruptPending, isInterruptSubmitting, getInterruptError, getInterruptByMessageId, interruptHasError } from '../stores/interruptStore.svelte.js';
+export { InterruptStore } from '../stores/interruptStore.svelte.js';
 export type { InterruptWithState } from '../stores/interruptStore.svelte.js';
 export { mountPlayground, unmountPlayground, mountPlaygroundStudio, mountPlaygroundApp, type PlaygroundMountOptions, type PlaygroundStudioMountOptions, type PlaygroundAppMountOptions, type MountedPlayground } from './mount.js';
 export type { PipelineViewDef, PipelineViewProps } from '../types/index.js';

package/dist/playground/index.js

@@ -135,49 +135,21 @@ export { InterruptBubble, ConfirmationPrompt, ChoicePrompt, TextInputPrompt, For
 // ============================================================================
 // Playground Service
 // ============================================================================
-export { PlaygroundService, playgroundService } from '../services/playgroundService.js';
+export { PlaygroundService } from '../services/playgroundService.js';
 // ============================================================================
 // Interrupt Service (Human-in-the-Loop)
 // ============================================================================
-export { InterruptService, interruptService } from '../services/interruptService.js';
+export { InterruptService } from '../services/interruptService.js';
 // ============================================================================
 // Playground Store
 // ============================================================================
-export { 
-// Core state getters
-getCurrentSession, getSessions, getMessages, getIsExecuting, getCanSendMessage, getIsLoading, getError as getPlaygroundError, getCurrentWorkflow, getLastPollSequenceNumber, 
-// Derived getters
-getSessionStatus, getMessageCount, getChatMessages, getLogMessages, getLatestMessage, getInputFields, getHasChatInput, getSessionCount, 
-// Execution getters (used with PipelinePanel / PlaygroundSplit)
-getActiveExecutionId, getPinnedExecutionId, getLatestExecutionId, 
-// UI state
-getShowLogs, 
-// Actions
-playgroundActions, 
-// Server response application (single update path)
-applyServerResponse, 
-// Subscription utility
-subscribeToSessionStatus, 
-// Utilities
-getCurrentSessionId, isSessionSelected, getMessagesSnapshot, getLatestSequenceNumber } from '../stores/playgroundStore.svelte.js';
-// ============================================================================
-// Pipeline Panel Store (open/close state, persisted to localStorage)
-// ============================================================================
-export { getPipelinePanelOpen, pipelinePanelActions } from '../stores/pipelinePanelStore.svelte.js';
+export { PlaygroundStore } 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 state accessor
-getInterruptsMap, 
-// Getter functions (replace derived stores)
-getPendingInterruptIds, getPendingInterrupts, getPendingInterruptCount, getResolvedInterrupts, getIsAnySubmitting, 
-// Actions
-interruptActions, 
-// Utilities
-getInterrupt, isInterruptPending, isInterruptSubmitting, getInterruptError, getInterruptByMessageId, interruptHasError } from '../stores/interruptStore.svelte.js';
+export { InterruptStore } from '../stores/interruptStore.svelte.js';
 // ============================================================================
 // Playground Mount Functions (for vanilla JS / Drupal / IIFE integration)
 // ============================================================================

package/dist/playground/mount.d.ts

@@ -45,6 +45,7 @@
  */
 import type { Workflow } from '../types/index.js';
 import type { EndpointConfig } from '../config/endpoints.js';
+import type { AuthProvider } from '../types/auth.js';
 import type { PlaygroundMode, PlaygroundConfig, PlaygroundSession, PlaygroundMessagesApiResponse, PlaygroundSessionStatus } from '../types/playground.js';
 import type { PartialSettings, SettingsCategory } from '../types/settings.js';
 import type { NavbarAction } from '../types/navbar.js';
@@ -81,6 +82,15 @@ export interface PlaygroundMountOptions {
      * Use createEndpointConfig() to create this
      */
     endpointConfig?: EndpointConfig;
+    /**
+     * Authentication provider for API requests.
+     *
+     * Applied to this instance via `fd.api.configure()` so every request the
+     * playground makes (sessions, messages, polling, interrupts) carries the
+     * provider's headers — e.g. an `Authorization` bearer token or an
+     * `X-CSRF-Token`. Omit for unauthenticated backends.
+     */
+    authProvider?: AuthProvider;
     /**
      * Playground-specific configuration options
      */
@@ -114,6 +124,21 @@ export interface PlaygroundMountOptions {
      * `settings` option.
      */
     settings?: PartialSettings;
+    /**
+     * Identifier for this playground's FlowDrop instance.
+     *
+     * When omitted, the playground uses the page-default instance — matching
+     * the legacy behavior where all playground mounts (and the editor's
+     * built-in playground) shared one session/message store. Pass an explicit
+     * id to isolate this playground's session/message *state* from other
+     * FlowDrop instances on the page.
+     *
+     * Note: live polling is NOT isolated — `playgroundService` keeps one
+     * page-global polling timer, so only one playground can actively poll at
+     * a time regardless of instance. Use `pushMessages()` with your own
+     * transport if two playgrounds need concurrent live updates.
+     */
+    instanceId?: string;
 }
 /**
  * Return type for mounted Playground instance