@flowdrop/flowdrop 1.14.0 → 2.0.0-beta.1

package/dist/registry/workflowFormatRegistry.js

@@ -11,15 +11,17 @@
  *
  * Extends BaseRegistry for shared mechanics (subscribe, onClear, etc.).
  */
-import { BaseRegistry } from './BaseRegistry.js';
+import { BaseRegistry } from './BaseRegistry.svelte.js';
 /**
- * Central registry for workflow format adapters.
- * Singleton — extends BaseRegistry for shared mechanics.
+ * Per-instance registry for workflow format adapters.
+ * Extends BaseRegistry for shared mechanics; seeded with the built-in
+ * adapters at construction (see `createFlowDropInstance`). Reach it via
+ * `fd.formats`, or supply adapters through the `formatAdapters` mount option.
  *
  * @example
  * ```typescript
  * // Register a custom format
- * workflowFormatRegistry.register({
+ * fd.formats.register({
  *   id: 'n8n',
  *   name: 'n8n Workflow',
  *   export: (workflow) => JSON.stringify(convertToN8n(workflow)),
@@ -27,10 +29,23 @@ import { BaseRegistry } from './BaseRegistry.js';
  * });
  *
  * // Get an adapter
- * const adapter = workflowFormatRegistry.get('n8n');
+ * const adapter = fd.formats.get('n8n');
  * ```
  */
-class WorkflowFormatRegistry extends BaseRegistry {
+export class WorkflowFormatRegistry extends BaseRegistry {
+    /**
+     * @param seed - Optional initial format adapters. When omitted the registry
+     *   starts empty; instances created via `createFlowDropInstance` pass the
+     *   built-in flowdrop + agentspec adapters (see `builtinFormats.ts`).
+     */
+    constructor(seed) {
+        super();
+        if (seed) {
+            for (const adapter of seed) {
+                this.register(adapter, true);
+            }
+        }
+    }
     /**
      * Register a workflow format adapter.
      *
@@ -44,6 +59,7 @@ class WorkflowFormatRegistry extends BaseRegistry {
                 `Use overwrite: true to replace it.`);
         }
         this.items.set(adapter.id, adapter);
+        this.touch();
         this.notifyListeners();
     }
     /**
@@ -61,6 +77,7 @@ class WorkflowFormatRegistry extends BaseRegistry {
      * @returns Array of NodeMetadata from all format adapters
      */
     getAllFormatNodes() {
+        this.trackVersion(); // reactive dependency (reads items directly)
         const allNodes = [];
         for (const adapter of this.items.values()) {
             if (adapter.nodes && adapter.nodes.length > 0) {
@@ -76,6 +93,7 @@ class WorkflowFormatRegistry extends BaseRegistry {
      * @returns Array of NodeMetadata for the format, or empty array
      */
     getFormatNodes(formatId) {
+        this.trackVersion(); // reactive dependency (reads items directly)
         const adapter = this.items.get(formatId);
         return adapter?.nodes ?? [];
     }
@@ -92,5 +110,3 @@ class WorkflowFormatRegistry extends BaseRegistry {
         }));
     }
 }
-/** Singleton instance of the workflow format registry */
-export const workflowFormatRegistry = new WorkflowFormatRegistry();

package/dist/{schema → schemas}/index.d.ts

@@ -15,9 +15,9 @@
  * const valid = validate(myWorkflow);
  * ```
  *
- * @module schema
+ * @module schemas
  */
-import workflowSchema from '../schemas/v1/workflow.schema.json';
+import workflowSchema from './v1/workflow.schema.json';
 /** Current workflow schema format version */
 export declare const WORKFLOW_SCHEMA_VERSION = "1.0.0";
 export { workflowSchema };

package/dist/{schema → schemas}/index.js

@@ -15,9 +15,9 @@
  * const valid = validate(myWorkflow);
  * ```
  *
- * @module schema
+ * @module schemas
  */
-import workflowSchema from '../schemas/v1/workflow.schema.json';
+import workflowSchema from './v1/workflow.schema.json';
 /** Current workflow schema format version */
 export const WORKFLOW_SCHEMA_VERSION = '1.0.0';
 export { workflowSchema };

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

@@ -51,6 +51,46 @@
     "metadata"
   ],
   "$defs": {
+    "AtomUIConfig": {
+      "type": "object",
+      "description": "Display/behaviour settings for minimalist `atom` nodes (e.g. Constant, Cast).\nLives under `extensions.ui.atom`. The atom renderer reads these to decide what\nto show, and `valueTypeKey` drives the bound output port's `dataType` from\nconfig so connection validation matches the type the user picked.\n\nAll fields are optional — an empty object renders a label-only pill using the\nnode's `label`.\n",
+      "properties": {
+        "valueKey": {
+          "type": "string",
+          "description": "Config key whose value becomes the node body text.\nFalls back to the node `label` when unset or empty.\n"
+        },
+        "valueTypeKey": {
+          "type": "string",
+          "description": "Config key holding the selected value's type (a port dataType id).\nThe bound output port adopts this dataType.\n"
+        },
+        "outputPortId": {
+          "type": "string",
+          "description": "Output port id driven by `valueTypeKey`.\nDefaults to the first output port when unset.\n"
+        },
+        "shape": {
+          "type": "string",
+          "enum": [
+            "pill",
+            "rectangle"
+          ],
+          "default": "pill",
+          "description": "Body shape. `pill` (default) is fully rounded; `rectangle` is lightly rounded.\n"
+        },
+        "prefix": {
+          "type": "string",
+          "description": "Dimmed affordance rendered before the body (e.g. `\"→ \"` to mark a transform).\nStays visible while the body value ellipsizes. Hidden in the empty state.\n"
+        },
+        "placeholder": {
+          "type": "string",
+          "description": "Text shown (dimmed) when the resolved body value is empty/unset."
+        },
+        "maxWidth": {
+          "type": "integer",
+          "description": "Max body width in px before the label ellipsizes."
+        }
+      },
+      "additionalProperties": false
+    },
     "AutocompleteConfig": {
       "type": "object",
       "description": "Configuration for autocomplete fields that fetch suggestions from a callback URL.\nUsed when format is \"autocomplete\".\n",
@@ -414,15 +454,17 @@
         },
         "nodeType": {
           "type": "string",
-          "description": "Changes how the node is visually rendered. This allows a single node definition\nto support multiple visual representations.\n\nAvailable built-in types:\n- `default`: Standard workflow node with full details\n- `simple`: Compact layout with minimal chrome\n- `square`: Geometric square layout (icon-only)\n- `tool`: Specialized style for agent tools\n- `gateway`: Branching control flow visualization\n- `terminal`: Start/end/exit node styling\n- `note`: Sticky note style for annotations\n\nThe node's `metadata.supportedTypes` defines which types are allowed.\nIf invalid or missing, falls back to `metadata.type` or \"default\".\n",
+          "description": "Changes how the node is visually rendered. This allows a single node definition\nto support multiple visual representations.\n\nAvailable built-in types:\n- `default`: Standard workflow node with full details\n- `simple`: Compact layout with minimal chrome\n- `square`: Geometric square layout (icon-only)\n- `atom`: Minimal label-only pill/rectangle (uses extensions.ui.atom)\n- `tool`: Specialized style for agent tools\n- `gateway`: Branching control flow visualization\n- `terminal`: Start/end/exit node styling\n- `note`: Sticky note style for annotations\n- `idea`: Conceptual idea node for BPMN-like flow diagrams\n\nThe node's `metadata.supportedTypes` defines which types are allowed.\nIf invalid or missing, falls back to `metadata.type` or \"default\".\n",
           "enum": [
             "default",
             "simple",
             "square",
+            "atom",
             "tool",
             "gateway",
             "terminal",
-            "note"
+            "note",
+            "idea"
           ]
         },
         "dynamicInputs": {
@@ -677,12 +719,14 @@
         "note",
         "simple",
         "square",
+        "atom",
         "tool",
         "gateway",
         "terminal",
+        "idea",
         "default"
       ],
-      "description": "Visual rendering type for the node.\n\nBuilt-in types:\n- `note` - Sticky note with markdown support\n- `simple` - Compact layout with header and description\n- `square` - Minimal square node with centered icon\n- `tool` - Specialized node for agent tools\n- `gateway` - Branching control flow with dynamic branches (uses config.branches)\n- `terminal` - Circular node for workflow start/end/exit points\n- `default` - Full-featured workflow node with dynamic port support\n\n## Dynamic Port Support\n\nThe `default` and `gateway` node types support dynamic ports:\n\n- **default**: Supports `config.dynamicInputs` and `config.dynamicOutputs`\n  for user-defined input/output handles\n- **gateway**: Supports `config.branches` for conditional branching paths\n\n## UI Extensions\n\nAll node types support `extensions.ui.hideUnconnectedHandles` to control\nvisibility of unconnected ports.\n"
+      "description": "Visual rendering type for the node.\n\nBuilt-in types:\n- `note` - Sticky note with markdown support\n- `simple` - Compact layout with header and description\n- `square` - Minimal square node with centered icon\n- `atom` - Minimal label-only pill/rectangle for value/transform nodes (uses extensions.ui.atom)\n- `tool` - Specialized node for agent tools\n- `gateway` - Branching control flow with dynamic branches (uses config.branches)\n- `terminal` - Circular node for workflow start/end/exit points\n- `idea` - Conceptual idea node for BPMN-like flow diagrams\n- `default` - Full-featured workflow node with dynamic port support\n\n## Dynamic Port Support\n\nThe `default` and `gateway` node types support dynamic ports:\n\n- **default**: Supports `config.dynamicInputs` and `config.dynamicOutputs`\n  for user-defined input/output handles\n- **gateway**: Supports `config.branches` for conditional branching paths\n\n## UI Extensions\n\nAll node types support `extensions.ui.hideUnconnectedHandles` to control\nvisibility of unconnected ports.\n"
     },
     "NodeUIExtensions": {
       "type": "object",
@@ -692,6 +736,9 @@
           "type": "boolean",
           "description": "Show/hide unconnected handles (ports) to reduce visual noise.\nWhen true, only ports with active connections are displayed.\nUseful for nodes with many optional ports.\n"
         },
+        "atom": {
+          "$ref": "#/$defs/AtomUIConfig"
+        },
         "style": {
           "type": "object",
           "additionalProperties": true,
@@ -1006,9 +1053,9 @@
     "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."
         },
         "createdAt": {
           "type": "string",
@@ -1046,7 +1093,7 @@
         }
       },
       "required": [
-        "version",
+        "schemaVersion",
         "createdAt",
         "updatedAt"
       ]

package/dist/services/agentSpecExecutionService.js

@@ -227,7 +227,6 @@ export class AgentSpecExecutionService {
     /** Get the config, throwing if not configured */
     getConfig() {
         this.ensureConfigured();
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
         return this.config;
     }
     startPolling(executionId, nameToNodeId, onNodeUpdate, onComplete, onError, intervalMs = 2000) {

package/dist/services/apiVariableService.d.ts

@@ -6,6 +6,7 @@
  * @module services/apiVariableService
  */
 import type { VariableSchema, ApiVariablesConfig, AuthProvider } from '../types/index.js';
+import type { EndpointConfig } from '../config/endpoints.js';
 /**
  * Context for variable API requests
  */
@@ -71,7 +72,7 @@ export declare function resolveEndpointUrl(template: string, context: VariableCo
  * }
  * ```
  */
-export declare function fetchVariableSchema(workflowId: string | undefined, nodeId: string, config: ApiVariablesConfig, authProvider?: AuthProvider): Promise<ApiVariableResult>;
+export declare function fetchVariableSchema(endpointConfig: EndpointConfig | null, workflowId: string | undefined, nodeId: string, config: ApiVariablesConfig, authProvider?: AuthProvider): Promise<ApiVariableResult>;
 /**
  * Clears the variable schema cache.
  * Can optionally clear only entries matching a specific pattern.

package/dist/services/apiVariableService.js

@@ -5,7 +5,6 @@
  *
  * @module services/apiVariableService
  */
-import { getEndpointConfig } from './api.js';
 import { logger } from '../utils/logger.js';
 import { DEFAULT_CACHE_TTL_MS } from '../config/constants.js';
 /**
@@ -116,7 +115,7 @@ function resolveBodyTemplates(body, context) {
  * }
  * ```
  */
-export async function fetchVariableSchema(workflowId, nodeId, config, authProvider) {
+export async function fetchVariableSchema(endpointConfig, workflowId, nodeId, config, authProvider) {
     const endpoint = config.endpoint;
     const context = { workflowId, nodeId };
     // Generate cache key
@@ -136,12 +135,9 @@ export async function fetchVariableSchema(workflowId, nodeId, config, authProvid
     // Resolve the URL with template variables
     let url = resolveEndpointUrl(endpoint.url, context);
     // If URL is relative, prepend base URL from endpoint config
-    if (url.startsWith('/')) {
-        const currentConfig = getEndpointConfig();
-        if (currentConfig?.baseUrl) {
-            const baseUrl = currentConfig.baseUrl.replace(/\/$/, '');
-            url = `${baseUrl}${url}`;
-        }
+    if (url.startsWith('/') && endpointConfig?.baseUrl) {
+        const baseUrl = endpointConfig.baseUrl.replace(/\/$/, '');
+        url = `${baseUrl}${url}`;
     }
     // Prepare request options
     const method = endpoint.method ?? 'GET';
@@ -161,19 +157,6 @@ export async function fetchVariableSchema(workflowId, nodeId, config, authProvid
             logger.warn('Failed to get auth headers:', error);
         }
     }
-    // Add auth headers from endpoint config as fallback
-    const currentConfig = getEndpointConfig();
-    if (currentConfig?.auth) {
-        if (currentConfig.auth.type === 'bearer' && currentConfig.auth.token) {
-            headers['Authorization'] = headers['Authorization'] ?? `Bearer ${currentConfig.auth.token}`;
-        }
-        else if (currentConfig.auth.type === 'api_key' && currentConfig.auth.apiKey) {
-            headers['X-API-Key'] = headers['X-API-Key'] ?? currentConfig.auth.apiKey;
-        }
-        else if (currentConfig.auth.type === 'custom' && currentConfig.auth.headers) {
-            Object.assign(headers, currentConfig.auth.headers);
-        }
-    }
     // Prepare fetch options
     const fetchOptions = {
         method,
@@ -202,7 +185,7 @@ export async function fetchVariableSchema(workflowId, nodeId, config, authProvid
                     const refreshed = await authProvider.onUnauthorized();
                     if (refreshed) {
                         // Retry with refreshed auth
-                        return fetchVariableSchema(workflowId, nodeId, config, authProvider);
+                        return fetchVariableSchema(endpointConfig, workflowId, nodeId, config, authProvider);
                     }
                 }
                 return {

package/dist/services/autoSaveService.d.ts

@@ -23,6 +23,12 @@ interface AutoSaveOptions {
      * Optional callback for successful saves
      */
     onSuccess?: () => void;
+    /**
+     * Dirty-state probe for the owning FlowDrop instance, e.g.
+     * `() => fd.workflow.isDirty`. Defaults to the page-default
+     * instance's dirty state when omitted.
+     */
+    isDirty?: () => boolean;
 }
 /**
  * Initialize auto-save functionality based on user settings
@@ -68,6 +74,7 @@ export declare class AutoSaveManager {
     private onSave;
     private onError?;
     private onSuccess?;
+    private isDirtyProbe;
     /**
      * Create a new AutoSaveManager
      *

package/dist/services/autoSaveService.js

@@ -7,7 +7,7 @@
  * @module services/autoSaveService
  */
 import { getBehaviorSettings, onSettingsChange } from '../stores/settingsStore.svelte.js';
-import { isDirty } from '../stores/workflowStore.svelte.js';
+import { getDefaultInstance } from '../stores/instanceContainer.svelte.js';
 import { logger } from '../utils/logger.js';
 /**
  * Initialize auto-save functionality based on user settings
@@ -40,7 +40,7 @@ import { logger } from '../utils/logger.js';
  * ```
  */
 export function initAutoSave(options) {
-    const { onSave, onError, onSuccess } = options;
+    const { onSave, onError, onSuccess, isDirty: isDirtyProbe = () => getDefaultInstance().workflow.isDirty } = options;
     const state = {
         intervalId: null,
         isSaving: false,
@@ -52,7 +52,7 @@ export function initAutoSave(options) {
      */
     async function performAutoSave() {
         // Skip if already saving or not dirty
-        if (state.isSaving || !isDirty()) {
+        if (state.isSaving || !isDirtyProbe()) {
             return;
         }
         state.isSaving = true;
@@ -127,6 +127,7 @@ export class AutoSaveManager {
     onSave;
     onError;
     onSuccess;
+    isDirtyProbe;
     /**
      * Create a new AutoSaveManager
      *
@@ -136,6 +137,7 @@ export class AutoSaveManager {
         this.onSave = options.onSave;
         this.onError = options.onError;
         this.onSuccess = options.onSuccess;
+        this.isDirtyProbe = options.isDirty ?? (() => getDefaultInstance().workflow.isDirty);
     }
     /**
      * Start the auto-save manager
@@ -207,7 +209,7 @@ export class AutoSaveManager {
      * Perform the save operation
      */
     async performSave() {
-        if (this.isSaving || !isDirty()) {
+        if (this.isSaving || !this.isDirtyProbe()) {
             return;
         }
         this.isSaving = true;

package/dist/services/chatService.d.ts

@@ -7,6 +7,7 @@
  * @module services/chatService
  */
 import type { ChatRequest, ChatResponse, ChatHistoryMessage } from '../types/chat.js';
+import type { EndpointConfig } from '../config/endpoints.js';
 /**
  * Chat Service class
  *
@@ -23,7 +24,9 @@ export declare class ChatService {
      */
     static getInstance(): ChatService;
     /**
-     * Get the endpoint configuration
+     * Validate and return the caller-supplied endpoint configuration.
+     *
+     * Callers thread the config from `getInstance().api.config`.
      *
      * @throws Error if endpoint configuration is not set
      * @returns The endpoint configuration
@@ -32,6 +35,7 @@ export declare class ChatService {
     /**
      * Generic API request helper
      *
+     * @param config - The endpoint configuration
      * @param url - The URL to fetch
      * @param options - Fetch options
      * @returns The parsed JSON response
@@ -44,20 +48,20 @@ export declare class ChatService {
      * @param request - The chat request payload
      * @returns The chat response from the LLM
      */
-    sendMessage(workflowId: string, request: ChatRequest): Promise<ChatResponse>;
+    sendMessage(endpointConfig: EndpointConfig | null, workflowId: string, request: ChatRequest): Promise<ChatResponse>;
     /**
      * Get conversation history for a workflow
      *
      * @param workflowId - The workflow ID
      * @returns Array of chat history messages
      */
-    getHistory(workflowId: string): Promise<ChatHistoryMessage[]>;
+    getHistory(endpointConfig: EndpointConfig | null, workflowId: string): Promise<ChatHistoryMessage[]>;
     /**
      * Clear conversation history for a workflow
      *
      * @param workflowId - The workflow ID
      */
-    clearHistory(workflowId: string): Promise<void>;
+    clearHistory(endpointConfig: EndpointConfig | null, workflowId: string): Promise<void>;
 }
 /**
  * Pre-instantiated ChatService singleton

package/dist/services/chatService.js

@@ -7,7 +7,6 @@
  * @module services/chatService
  */
 import { buildEndpointUrl, getEndpointHeaders } from '../config/endpoints.js';
-import { getEndpointConfig } from './api.js';
 import { logger } from '../utils/logger.js';
 /**
  * Chat Service class
@@ -30,27 +29,28 @@ export class ChatService {
         return ChatService.instance;
     }
     /**
-     * Get the endpoint configuration
+     * Validate and return the caller-supplied endpoint configuration.
+     *
+     * Callers thread the config from `getInstance().api.config`.
      *
      * @throws Error if endpoint configuration is not set
      * @returns The endpoint configuration
      */
-    getConfig() {
-        const config = getEndpointConfig();
+    getConfig(config) {
         if (!config) {
-            throw new Error('Endpoint configuration not set. Call setEndpointConfig() first.');
+            throw new Error('Endpoint configuration not set. Configure the instance via fd.api.configure().');
         }
         return config;
     }
     /**
      * Generic API request helper
      *
+     * @param config - The endpoint configuration
      * @param url - The URL to fetch
      * @param options - Fetch options
      * @returns The parsed JSON response
      */
-    async request(url, options = {}) {
-        const config = this.getConfig();
+    async request(config, url, options = {}) {
         const headers = getEndpointHeaders(config, 'chat');
         const response = await fetch(url, {
             ...options,
@@ -83,13 +83,13 @@ export class ChatService {
      * @param request - The chat request payload
      * @returns The chat response from the LLM
      */
-    async sendMessage(workflowId, request) {
-        const config = this.getConfig();
+    async sendMessage(endpointConfig, workflowId, request) {
+        const config = this.getConfig(endpointConfig);
         const url = buildEndpointUrl(config, config.endpoints.chat.sendMessage, {
             id: workflowId
         });
         logger.debug('[ChatService] Sending message to', url);
-        return this.request(url, {
+        return this.request(config, url, {
             method: 'POST',
             body: JSON.stringify(request)
         });
@@ -100,21 +100,21 @@ export class ChatService {
      * @param workflowId - The workflow ID
      * @returns Array of chat history messages
      */
-    async getHistory(workflowId) {
-        const config = this.getConfig();
+    async getHistory(endpointConfig, workflowId) {
+        const config = this.getConfig(endpointConfig);
         const url = buildEndpointUrl(config, config.endpoints.chat.getHistory, {
             id: workflowId
         });
         logger.debug('[ChatService] Getting history from', url);
-        return this.request(url);
+        return this.request(config, url);
     }
     /**
      * Clear conversation history for a workflow
      *
      * @param workflowId - The workflow ID
      */
-    async clearHistory(workflowId) {
-        const config = this.getConfig();
+    async clearHistory(endpointConfig, workflowId) {
+        const config = this.getConfig(endpointConfig);
         const url = buildEndpointUrl(config, config.endpoints.chat.clearHistory, {
             id: workflowId
         });