@d34dman/flowdrop 0.0.57 → 0.0.58

package/dist/registry/nodeComponentRegistry.js

@@ -8,10 +8,13 @@
  * - External libraries to contribute node types via plugins
  * - Runtime switching between different node visualizations
  */
+import { BaseRegistry } from './BaseRegistry.js';
 /**
  * Central registry for node component types.
  * Allows built-in and third-party components to be registered and resolved.
  *
+ * Extends BaseRegistry for shared mechanics (subscribe, onClear, etc.).
+ *
  * @example
  * ```typescript
  * // Register a custom node
@@ -27,13 +30,11 @@
  * const component = nodeComponentRegistry.getComponent("myCustomNode");
  * ```
  */
-class NodeComponentRegistry {
-    /** Map of type -> registration */
-    components = new Map();
+class NodeComponentRegistry extends BaseRegistry {
     /** Default type to use when requested type is not found */
     defaultType = 'workflowNode';
-    /** Listeners for registry changes */
-    listeners = new Set();
+    /** Initial default type, restored on clear() */
+    static INITIAL_DEFAULT_TYPE = 'workflowNode';
     /**
      * Register a node component type.
      *
@@ -51,12 +52,19 @@ class NodeComponentRegistry {
      * });
      * ```
      */
+    /**
+     * Clear all registrations and reset default type.
+     */
+    clear() {
+        super.clear();
+        this.defaultType = NodeComponentRegistry.INITIAL_DEFAULT_TYPE;
+    }
     register(registration, overwrite = false) {
-        if (this.components.has(registration.type) && !overwrite) {
+        if (this.items.has(registration.type) && !overwrite) {
             throw new Error(`Node type "${registration.type}" is already registered. ` +
                 `Use overwrite: true to replace it, or use a namespaced type like "mylib:${registration.type}".`);
         }
-        this.components.set(registration.type, registration);
+        this.items.set(registration.type, registration);
         this.notifyListeners();
     }
     /**
@@ -71,28 +79,6 @@ class NodeComponentRegistry {
             this.register(registration, overwrite);
         }
     }
-    /**
-     * Unregister a node component type.
-     *
-     * @param type - The type identifier to remove
-     * @returns true if the type was found and removed, false otherwise
-     */
-    unregister(type) {
-        const result = this.components.delete(type);
-        if (result) {
-            this.notifyListeners();
-        }
-        return result;
-    }
-    /**
-     * Get a registration by type.
-     *
-     * @param type - The type identifier to look up
-     * @returns The registration if found, undefined otherwise
-     */
-    get(type) {
-        return this.components.get(type);
-    }
     /**
      * Get the component for a type, with fallback to default.
      *
@@ -100,17 +86,21 @@ class NodeComponentRegistry {
      * @returns The component if found, or the default component
      */
     getComponent(type) {
-        const registration = this.components.get(type) ?? this.components.get(this.defaultType);
+        const registration = this.items.get(type) ?? this.items.get(this.defaultType);
         return registration?.component;
     }
     /**
-     * Check if a type is registered.
+     * Get framework-agnostic metadata for a type, without the Svelte component.
      *
-     * @param type - The type identifier to check
-     * @returns true if the type is registered
+     * @param type - The type identifier to look up
+     * @returns The metadata if found, undefined otherwise
      */
-    has(type) {
-        return this.components.has(type);
+    getMetadata(type) {
+        const reg = this.items.get(type);
+        if (!reg)
+            return undefined;
+        const { component: _, ...metadata } = reg;
+        return metadata;
     }
     /**
      * Get all registered type identifiers.
@@ -118,15 +108,7 @@ class NodeComponentRegistry {
      * @returns Array of registered type strings
      */
     getTypes() {
-        return Array.from(this.components.keys());
-    }
-    /**
-     * Get all registrations.
-     *
-     * @returns Array of all registered node component metadata
-     */
-    getAll() {
-        return Array.from(this.components.values());
+        return this.getKeys();
     }
     /**
      * Get registrations filtered by criteria.
@@ -182,7 +164,7 @@ class NodeComponentRegistry {
      * @throws Error if the type is not registered
      */
     setDefaultType(type) {
-        if (!this.components.has(type)) {
+        if (!this.items.has(type)) {
             throw new Error(`Cannot set default to unregistered type: ${type}`);
         }
         this.defaultType = type;
@@ -195,25 +177,6 @@ class NodeComponentRegistry {
     getDefaultType() {
         return this.defaultType;
     }
-    /**
-     * Subscribe to registry changes.
-     * Called whenever components are registered or unregistered.
-     *
-     * @param listener - Callback to invoke on changes
-     * @returns Unsubscribe function
-     */
-    subscribe(listener) {
-        this.listeners.add(listener);
-        return () => this.listeners.delete(listener);
-    }
-    /**
-     * Notify all listeners of a change.
-     */
-    notifyListeners() {
-        for (const listener of this.listeners) {
-            listener();
-        }
-    }
     /**
      * Get oneOf options for config forms.
      * Returns array suitable for JSON Schema oneOf with const/title.
@@ -241,7 +204,7 @@ class NodeComponentRegistry {
      * @returns The status position, or default "top-right"
      */
     getStatusPosition(type) {
-        return this.components.get(type)?.statusPosition ?? 'top-right';
+        return this.items.get(type)?.statusPosition ?? 'top-right';
     }
     /**
      * Get the status size for a node type.
@@ -250,23 +213,7 @@ class NodeComponentRegistry {
      * @returns The status size, or default "md"
      */
     getStatusSize(type) {
-        return this.components.get(type)?.statusSize ?? 'md';
-    }
-    /**
-     * Clear all registrations.
-     * Primarily useful for testing.
-     */
-    clear() {
-        this.components.clear();
-        this.notifyListeners();
-    }
-    /**
-     * Get the count of registered components.
-     *
-     * @returns Number of registered node types
-     */
-    get size() {
-        return this.components.size;
+        return this.items.get(type)?.statusSize ?? 'md';
     }
 }
 /** Singleton instance of the node component registry */

package/dist/registry/workflowFormatRegistry.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Workflow Format Registry
+ *
+ * Central registry for workflow format adapters that allows built-in and
+ * third-party formats to be registered and resolved at runtime.
+ *
+ * This enables:
+ * - Custom workflow formats (e.g., n8n, LangGraph) to be registered by users
+ * - Format adapters to bundle their own node types
+ * - Bidirectional conversion between FlowDrop's StandardWorkflow and external formats
+ *
+ * Extends BaseRegistry for shared mechanics (subscribe, onClear, etc.).
+ */
+import type { StandardWorkflow } from '../adapters/WorkflowAdapter.js';
+import type { NodeMetadata, WorkflowFormat } from '../types/index.js';
+import { BaseRegistry } from './BaseRegistry.js';
+/**
+ * Validation result returned by format adapters.
+ */
+export interface FormatValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Interface that all workflow format adapters must implement.
+ * Adapters handle bidirectional conversion between FlowDrop's StandardWorkflow
+ * and an external workflow format.
+ *
+ * @example
+ * ```typescript
+ * const myAdapter: WorkflowFormatAdapter = {
+ *   id: 'n8n',
+ *   name: 'n8n Workflow',
+ *   export: (workflow) => JSON.stringify(convertToN8n(workflow)),
+ *   import: (data) => convertFromN8n(JSON.parse(data)),
+ * };
+ * ```
+ */
+export interface WorkflowFormatAdapter {
+    /** Unique format identifier (e.g., 'agentspec', 'n8n') */
+    id: WorkflowFormat;
+    /** Display name for UI (e.g., 'Agent Spec (Oracle)') */
+    name: string;
+    /** Description */
+    description?: string;
+    /** Version */
+    version?: string;
+    /**
+     * Optional node types specific to this format.
+     * When provided, these nodes are merged into the sidebar
+     * and automatically tagged with this format.
+     */
+    nodes?: NodeMetadata[];
+    /** Convert a StandardWorkflow to this format's JSON string */
+    export(workflow: StandardWorkflow): string;
+    /** Parse this format's input and convert to StandardWorkflow */
+    import(data: string): StandardWorkflow;
+    /** Validate whether a workflow can be exported to this format */
+    validate?(workflow: StandardWorkflow): FormatValidationResult;
+}
+/**
+ * Central registry for workflow format adapters.
+ * Singleton — extends BaseRegistry for shared mechanics.
+ *
+ * @example
+ * ```typescript
+ * // Register a custom format
+ * workflowFormatRegistry.register({
+ *   id: 'n8n',
+ *   name: 'n8n Workflow',
+ *   export: (workflow) => JSON.stringify(convertToN8n(workflow)),
+ *   import: (data) => convertFromN8n(JSON.parse(data)),
+ * });
+ *
+ * // Get an adapter
+ * const adapter = workflowFormatRegistry.get('n8n');
+ * ```
+ */
+declare class WorkflowFormatRegistry extends BaseRegistry<string, WorkflowFormatAdapter> {
+    /**
+     * Register a workflow format adapter.
+     *
+     * @param adapter - The format adapter to register
+     * @param overwrite - If true, allows overwriting existing registrations
+     * @throws Error if format already registered and overwrite is false
+     */
+    register(adapter: WorkflowFormatAdapter, overwrite?: boolean): void;
+    /**
+     * Get all registered format identifiers.
+     *
+     * @returns Array of format id strings
+     */
+    getIds(): string[];
+    /**
+     * Get all node types provided by registered format adapters.
+     * Collects `adapter.nodes` from all adapters that provide them.
+     *
+     * @returns Array of NodeMetadata from all format adapters
+     */
+    getAllFormatNodes(): NodeMetadata[];
+    /**
+     * Get node types for a specific format.
+     *
+     * @param formatId - The format identifier
+     * @returns Array of NodeMetadata for the format, or empty array
+     */
+    getFormatNodes(formatId: WorkflowFormat): NodeMetadata[];
+    /**
+     * Get oneOf options for config forms.
+     * Returns array suitable for JSON Schema oneOf with const/title.
+     *
+     * @returns Array of oneOf items
+     */
+    getOneOfOptions(): Array<{
+        const: string;
+        title: string;
+    }>;
+}
+/** Singleton instance of the workflow format registry */
+export declare const workflowFormatRegistry: WorkflowFormatRegistry;
+export {};

package/dist/registry/workflowFormatRegistry.js

@@ -0,0 +1,96 @@
+/**
+ * Workflow Format Registry
+ *
+ * Central registry for workflow format adapters that allows built-in and
+ * third-party formats to be registered and resolved at runtime.
+ *
+ * This enables:
+ * - Custom workflow formats (e.g., n8n, LangGraph) to be registered by users
+ * - Format adapters to bundle their own node types
+ * - Bidirectional conversion between FlowDrop's StandardWorkflow and external formats
+ *
+ * Extends BaseRegistry for shared mechanics (subscribe, onClear, etc.).
+ */
+import { BaseRegistry } from './BaseRegistry.js';
+/**
+ * Central registry for workflow format adapters.
+ * Singleton — extends BaseRegistry for shared mechanics.
+ *
+ * @example
+ * ```typescript
+ * // Register a custom format
+ * workflowFormatRegistry.register({
+ *   id: 'n8n',
+ *   name: 'n8n Workflow',
+ *   export: (workflow) => JSON.stringify(convertToN8n(workflow)),
+ *   import: (data) => convertFromN8n(JSON.parse(data)),
+ * });
+ *
+ * // Get an adapter
+ * const adapter = workflowFormatRegistry.get('n8n');
+ * ```
+ */
+class WorkflowFormatRegistry extends BaseRegistry {
+    /**
+     * Register a workflow format adapter.
+     *
+     * @param adapter - The format adapter to register
+     * @param overwrite - If true, allows overwriting existing registrations
+     * @throws Error if format already registered and overwrite is false
+     */
+    register(adapter, overwrite = false) {
+        if (this.items.has(adapter.id) && !overwrite) {
+            throw new Error(`Workflow format "${adapter.id}" is already registered. ` +
+                `Use overwrite: true to replace it.`);
+        }
+        this.items.set(adapter.id, adapter);
+        this.notifyListeners();
+    }
+    /**
+     * Get all registered format identifiers.
+     *
+     * @returns Array of format id strings
+     */
+    getIds() {
+        return this.getKeys();
+    }
+    /**
+     * Get all node types provided by registered format adapters.
+     * Collects `adapter.nodes` from all adapters that provide them.
+     *
+     * @returns Array of NodeMetadata from all format adapters
+     */
+    getAllFormatNodes() {
+        const allNodes = [];
+        for (const adapter of this.items.values()) {
+            if (adapter.nodes && adapter.nodes.length > 0) {
+                allNodes.push(...adapter.nodes);
+            }
+        }
+        return allNodes;
+    }
+    /**
+     * Get node types for a specific format.
+     *
+     * @param formatId - The format identifier
+     * @returns Array of NodeMetadata for the format, or empty array
+     */
+    getFormatNodes(formatId) {
+        const adapter = this.items.get(formatId);
+        return adapter?.nodes ?? [];
+    }
+    /**
+     * Get oneOf options for config forms.
+     * Returns array suitable for JSON Schema oneOf with const/title.
+     *
+     * @returns Array of oneOf items
+     */
+    getOneOfOptions() {
+        return this.getAll().map((adapter) => ({
+            const: adapter.id,
+            title: adapter.name
+        }));
+    }
+}
+/** Singleton instance of the workflow format registry */
+export const workflowFormatRegistry = new WorkflowFormatRegistry();

package/dist/schema/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * FlowDrop Workflow JSON Schema
+ *
+ * Provides the versioned JSON Schema for the FlowDrop workflow document format.
+ * The schema is generated from the OpenAPI YAML definitions in `api/components/schemas/`.
+ *
+ * @example
+ * ```typescript
+ * import { workflowSchema, WORKFLOW_SCHEMA_VERSION } from '@d34dman/flowdrop/core';
+ *
+ * // Use with any JSON Schema validator (e.g., Ajv)
+ * import Ajv from 'ajv/dist/2020';
+ * const ajv = new Ajv();
+ * const validate = ajv.compile(workflowSchema);
+ * const valid = validate(myWorkflow);
+ * ```
+ *
+ * @module schema
+ */
+import workflowSchema from '../../../schemas/v1/workflow.schema.json';
+/** Current workflow schema format version */
+export declare const WORKFLOW_SCHEMA_VERSION = "1.0.0";
+export { workflowSchema };

package/dist/schema/index.js

@@ -0,0 +1,23 @@
+/**
+ * FlowDrop Workflow JSON Schema
+ *
+ * Provides the versioned JSON Schema for the FlowDrop workflow document format.
+ * The schema is generated from the OpenAPI YAML definitions in `api/components/schemas/`.
+ *
+ * @example
+ * ```typescript
+ * import { workflowSchema, WORKFLOW_SCHEMA_VERSION } from '@d34dman/flowdrop/core';
+ *
+ * // Use with any JSON Schema validator (e.g., Ajv)
+ * import Ajv from 'ajv/dist/2020';
+ * const ajv = new Ajv();
+ * const validate = ajv.compile(workflowSchema);
+ * const valid = validate(myWorkflow);
+ * ```
+ *
+ * @module schema
+ */
+import workflowSchema from '../../../schemas/v1/workflow.schema.json';
+/** Current workflow schema format version */
+export const WORKFLOW_SCHEMA_VERSION = '1.0.0';
+export { workflowSchema };

package/dist/stores/portCoordinateStore.js

@@ -65,10 +65,7 @@ function computeNodePortCoordinates(node, internalNode) {
     const posAbs = internalNode.internals.positionAbsolute;
     const dataTypeLookup = buildPortDataTypeLookup(node);
     const coordinates = [];
-    const allHandles = [
-        ...(handleBounds.source ?? []),
-        ...(handleBounds.target ?? [])
-    ];
+    const allHandles = [...(handleBounds.source ?? []), ...(handleBounds.target ?? [])];
     for (const handle of allHandles) {
         if (!handle.id)
             continue;

package/dist/stores/workflowStore.d.ts

@@ -86,7 +86,10 @@ export declare const workflowMetadata: import("svelte/store").Readable<{
     tags?: string[];
     versionId?: string;
     updateNumber?: number;
+    format?: import("../types").WorkflowFormat;
 }>;
+/** Derived store for the current workflow format */
+export declare const workflowFormat: import("svelte/store").Readable<import("../types").WorkflowFormat>;
 /**
  * Actions for updating the workflow
  *

package/dist/stores/workflowStore.js

@@ -7,6 +7,7 @@
  * @module stores/workflowStore
  */
 import { writable, derived, get } from 'svelte/store';
+import { DEFAULT_WORKFLOW_FORMAT } from '../types/index.js';
 import { historyService } from '../services/historyService.js';
 // =========================================================================
 // Core Workflow Store
@@ -220,6 +221,8 @@ export const workflowMetadata = derived(workflowStore, ($workflow) => $workflow?
     versionId: `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
     updateNumber: 0
 });
+/** Derived store for the current workflow format */
+export const workflowFormat = derived(workflowStore, ($workflow) => $workflow?.metadata?.format ?? DEFAULT_WORKFLOW_FORMAT);
 // =========================================================================
 // Helper Functions
 // =========================================================================

package/dist/svelte-app.d.ts

@@ -10,6 +10,8 @@ import type { Workflow, NodeMetadata, PortConfig, CategoryDefinition } from './t
 import type { EndpointConfig } from './config/endpoints.js';
 import type { AuthProvider } from './types/auth.js';
 import type { FlowDropEventHandlers, FlowDropFeatures } from './types/events.js';
+import type { WorkflowFormatAdapter } from './registry/workflowFormatRegistry.js';
+import './registry/builtinFormats.js';
 import type { PartialSettings } from './types/settings.js';
 declare global {
     interface Window {
@@ -73,6 +75,8 @@ export interface FlowDropMountOptions {
     settings?: PartialSettings;
     /** Custom storage key for localStorage drafts */
     draftStorageKey?: string;
+    /** Custom workflow format adapters to register */
+    formatAdapters?: WorkflowFormatAdapter[];
 }
 /**
  * Return type for mounted FlowDrop app

package/dist/svelte-app.js

@@ -9,6 +9,8 @@
 import { mount, unmount } from 'svelte';
 import WorkflowEditor from './components/WorkflowEditor.svelte';
 import App from './components/App.svelte';
+import { workflowFormatRegistry } from './registry/workflowFormatRegistry.js';
+import './registry/builtinFormats.js';
 import { initializePortCompatibility } from './utils/connections.js';
 import { DEFAULT_PORT_CONFIG } from './config/defaultPortConfig.js';
 import { fetchPortConfig } from './services/portConfigApi.js';
@@ -43,7 +45,13 @@ import { initializeSettings } from './stores/settingsStore.js';
  * ```
  */
 export async function mountFlowDropApp(container, options = {}) {
-    const { workflow, nodes, endpointConfig, portConfig, categories, height = '100vh', width = '100%', showNavbar = false, disableSidebar, lockWorkflow, readOnly, nodeStatuses, pipelineId, navbarTitle, navbarActions, showSettings, authProvider, eventHandlers, features: userFeatures, settings: initialSettings, draftStorageKey: customDraftKey } = options;
+    const { workflow, nodes, endpointConfig, portConfig, categories, height = '100vh', width = '100%', showNavbar = false, disableSidebar, lockWorkflow, readOnly, nodeStatuses, pipelineId, navbarTitle, navbarActions, showSettings, authProvider, eventHandlers, features: userFeatures, settings: initialSettings, draftStorageKey: customDraftKey, formatAdapters } = options;
+    // Register custom format adapters before mounting
+    if (formatAdapters) {
+        for (const adapter of formatAdapters) {
+            workflowFormatRegistry.register(adapter);
+        }
+    }
     // Merge features with defaults
     const features = mergeFeatures(userFeatures);
     // Apply initial settings overrides and initialize theme

package/dist/types/index.d.ts

@@ -24,6 +24,20 @@ export type BuiltinNodeCategory = 'triggers' | 'inputs' | 'outputs' | 'prompts'
  * ```
  */
 export type NodeCategory = BuiltinNodeCategory | (string & Record<never, never>);
+/**
+ * Built-in workflow format identifiers that ship with FlowDrop.
+ */
+export type BuiltinWorkflowFormat = 'flowdrop' | 'agentspec';
+/**
+ * Workflow format identifier.
+ * Determines sidebar node filtering and export behavior.
+ * Includes built-in formats plus any custom string for third-party adapters.
+ */
+export type WorkflowFormat = BuiltinWorkflowFormat | (string & Record<never, never>);
+/**
+ * Default workflow format used when none is specified.
+ */
+export declare const DEFAULT_WORKFLOW_FORMAT: WorkflowFormat;
 /**
  * Category definition with metadata for display and organization.
  * Fetched from the `/categories` API endpoint or provided as defaults.
@@ -550,6 +564,8 @@ export interface NodeMetadata {
     /** Default configuration values for this node type */
     config?: Record<string, unknown>;
     tags?: string[];
+    /** Workflow formats this node is compatible with. Omit = universal (all formats). */
+    formats?: WorkflowFormat[];
     /**
      * Admin/Edit configuration for nodes with dynamic or external configuration.
      * Used when the config schema cannot be determined at workflow load time
@@ -1106,6 +1122,8 @@ export interface Workflow {
         tags?: string[];
         versionId?: string;
         updateNumber?: number;
+        /** Workflow format. Determines sidebar filtering and export behavior. */
+        format?: WorkflowFormat;
     };
 }
 /**

package/dist/types/index.js

@@ -2,6 +2,10 @@
  * Core types for the Workflow Library
  */
 import { ConnectionLineType } from '@xyflow/svelte';
+/**
+ * Default workflow format used when none is specified.
+ */
+export const DEFAULT_WORKFLOW_FORMAT = 'flowdrop';
 /**
  * Convert a DynamicPort to a NodePort
  * @param port - The dynamic port configuration