@d34dman/flowdrop 0.0.57 → 0.0.58

package/dist/adapters/agentspec/{nodeTypeRegistry.js → defaultNodeTypes.js}

@@ -1,30 +1,24 @@
 /**
- * Agent Spec Node Type Registry
+ * Agent Spec Default Node Types
  *
- * Maps Agent Spec component types to FlowDrop NodeMetadata definitions.
- * Each Agent Spec node type gets a full NodeMetadata with visual type,
- * category, default ports, config schema, and icon.
+ * Provides optional starter node type definitions for the Agent Spec format.
+ * These are full NodeMetadata objects with visual type, category, default ports,
+ * config schema, and icon — suitable for populating the sidebar.
+ *
+ * These definitions are NOT required by the adapter — the adapter uses
+ * componentTypeDefaults.ts for import/export infrastructure.
+ * Users can provide their own node definitions instead.
+ *
+ * @example
+ * ```typescript
+ * import { getDefaultAgentSpecNodeTypes } from '@d34dman/flowdrop/core';
+ *
+ * mountFlowDropApp(container, {
+ *   nodes: getDefaultAgentSpecNodeTypes(), // or your own definitions
+ * });
+ * ```
  */
-/** Namespace prefix for Agent Spec node type IDs */
-const AGENTSPEC_NS = 'agentspec';
-/** Standard trigger input port shared by most nodes */
-const TRIGGER_INPUT = {
-    id: 'trigger',
-    name: 'Trigger',
-    type: 'input',
-    dataType: 'trigger',
-    required: false,
-    description: 'Control flow input'
-};
-/** Standard trigger output port shared by most nodes */
-const TRIGGER_OUTPUT = {
-    id: 'trigger',
-    name: 'Trigger',
-    type: 'output',
-    dataType: 'trigger',
-    required: false,
-    description: 'Control flow output'
-};
+import { AGENTSPEC_NAMESPACE as AGENTSPEC_NS, TRIGGER_INPUT, TRIGGER_OUTPUT } from './componentTypeDefaults.js';
 /**
  * Build the full registry of Agent Spec node types.
  */
@@ -51,6 +45,7 @@ function buildRegistry() {
                 type: 'object',
                 properties: {}
             },
+            formats: ['agentspec'],
             extensions: { 'agentspec:component_type': 'start_node' }
         }
     });
@@ -75,6 +70,7 @@ function buildRegistry() {
                 type: 'object',
                 properties: {}
             },
+            formats: ['agentspec'],
             extensions: { 'agentspec:component_type': 'end_node' }
         }
     });
@@ -139,6 +135,7 @@ function buildRegistry() {
                     }
                 }
             },
+            formats: ['agentspec'],
             extensions: { 'agentspec:component_type': 'llm_node' }
         }
     });
@@ -206,6 +203,7 @@ function buildRegistry() {
                     }
                 }
             },
+            formats: ['agentspec'],
             extensions: { 'agentspec:component_type': 'branching_node' }
         }
     });
@@ -263,6 +261,7 @@ function buildRegistry() {
                     }
                 }
             },
+            formats: ['agentspec'],
             extensions: { 'agentspec:component_type': 'tool_node' }
         }
     });
@@ -333,6 +332,7 @@ function buildRegistry() {
                     }
                 }
             },
+            formats: ['agentspec'],
             extensions: { 'agentspec:component_type': 'api_node' }
         }
     });
@@ -390,6 +390,7 @@ function buildRegistry() {
                     }
                 }
             },
+            formats: ['agentspec'],
             extensions: { 'agentspec:component_type': 'agent_node' }
         }
     });
@@ -440,6 +441,7 @@ function buildRegistry() {
                     }
                 }
             },
+            formats: ['agentspec'],
             extensions: { 'agentspec:component_type': 'flow_node' }
         }
     });
@@ -502,6 +504,7 @@ function buildRegistry() {
                     }
                 }
             },
+            formats: ['agentspec'],
             extensions: { 'agentspec:component_type': 'map_node' }
         }
     });
@@ -528,12 +531,12 @@ export function getAgentSpecNodeMetadata(componentType) {
     return registry.get(componentType)?.metadata;
 }
 /**
- * Get all Agent Spec node types as FlowDrop NodeMetadata.
- * Useful for populating the node sidebar with Agent Spec node types.
+ * Get all default Agent Spec node types as FlowDrop NodeMetadata.
+ * These are starter templates — users can provide their own node types instead.
  *
- * @returns Array of NodeMetadata for all 9 Agent Spec node types
+ * @returns Array of NodeMetadata for all 9 default Agent Spec node types
  */
-export function getAllAgentSpecNodeTypes() {
+export function getDefaultAgentSpecNodeTypes() {
     return Array.from(registry.values()).map((entry) => entry.metadata);
 }
 /**
@@ -556,34 +559,3 @@ export function createAgentSpecNodeMetadata(componentType, inputs, outputs) {
         outputs: outputs ?? base.outputs
     };
 }
-/**
- * Check if a FlowDrop node ID belongs to an Agent Spec node type.
- *
- * @example
- * ```typescript
- * isAgentSpecNodeId('agentspec.llm_node') // true
- * isAgentSpecNodeId('calculator') // false
- * ```
- */
-export function isAgentSpecNodeId(nodeId) {
-    return nodeId.startsWith(`${AGENTSPEC_NS}.`);
-}
-/**
- * Extract the Agent Spec component_type from a FlowDrop node type ID.
- *
- * @example
- * ```typescript
- * extractComponentType('agentspec.llm_node') // 'llm_node'
- * extractComponentType('calculator') // undefined
- * ```
- */
-export function extractComponentType(nodeTypeId) {
-    if (!isAgentSpecNodeId(nodeTypeId))
-        return undefined;
-    const componentType = nodeTypeId.slice(AGENTSPEC_NS.length + 1);
-    return registry.has(componentType)
-        ? componentType
-        : undefined;
-}
-/** The namespace prefix used for Agent Spec node type IDs */
-export const AGENTSPEC_NAMESPACE = AGENTSPEC_NS;

package/dist/adapters/agentspec/index.d.ts

@@ -28,7 +28,9 @@
 export { AgentSpecAdapter } from './AgentSpecAdapter.js';
 export { AgentSpecAgentAdapter } from './agentAdapter.js';
 export type { AgentConfig, AgentSpecImportResult } from './agentAdapter.js';
-export { getAgentSpecNodeMetadata, getAllAgentSpecNodeTypes, createAgentSpecNodeMetadata, isAgentSpecNodeId, extractComponentType, AGENTSPEC_NAMESPACE } from './nodeTypeRegistry.js';
+export { getAgentSpecNodeMetadata, getDefaultAgentSpecNodeTypes, createAgentSpecNodeMetadata } from './defaultNodeTypes.js';
+export { getComponentTypeDefaults, extractComponentType, isAgentSpecNodeId, AGENTSPEC_NAMESPACE } from './componentTypeDefaults.js';
+export type { ComponentTypeDefaults } from './componentTypeDefaults.js';
 export { validateForAgentSpecExport, validateAgentSpecFlow } from './validator.js';
 export type { AgentSpecValidationResult } from './validator.js';
 export { computeAutoLayout } from './autoLayout.js';

package/dist/adapters/agentspec/index.js

@@ -29,8 +29,10 @@
 export { AgentSpecAdapter } from './AgentSpecAdapter.js';
 // Agent-level adapter (wraps flow with agent/tools/LLM config)
 export { AgentSpecAgentAdapter } from './agentAdapter.js';
-// Node type registry
-export { getAgentSpecNodeMetadata, getAllAgentSpecNodeTypes, createAgentSpecNodeMetadata, isAgentSpecNodeId, extractComponentType, AGENTSPEC_NAMESPACE } from './nodeTypeRegistry.js';
+// Default node types (optional starter templates — users can provide their own)
+export { getAgentSpecNodeMetadata, getDefaultAgentSpecNodeTypes, createAgentSpecNodeMetadata } from './defaultNodeTypes.js';
+// Component type defaults (adapter infrastructure)
+export { getComponentTypeDefaults, extractComponentType, isAgentSpecNodeId, AGENTSPEC_NAMESPACE } from './componentTypeDefaults.js';
 // Validation
 export { validateForAgentSpecExport, validateAgentSpecFlow } from './validator.js';
 // Auto-layout

package/dist/components/App.svelte

@@ -22,6 +22,7 @@
 		ConfigSchema,
 		NodeUIExtensions
 	} from '../types/index.js';
+	import { DEFAULT_WORKFLOW_FORMAT } from '../types/index.js';
 	import { createEndpointConfig } from '../config/endpoints.js';
 	import type { EndpointConfig } from '../config/endpoints.js';
 	import type { AuthProvider } from '../types/auth.js';
@@ -31,6 +32,7 @@
 		workflowStore,
 		workflowActions,
 		workflowName,
+		workflowFormat,
 		markAsSaved
 	} from '../stores/workflowStore.js';
 	import { apiToasts, dismissToast } from '../services/toastService.js';
@@ -38,6 +40,7 @@
 	import { uiSettings } from '../stores/settingsStore.js';
 	import { initializePortCompatibility } from '../utils/connections.js';
 	import { DEFAULT_PORT_CONFIG } from '../config/defaultPortConfig.js';
+	import { workflowFormatRegistry } from '../registry/workflowFormatRegistry.js';
 
 	/**
 	 * Configuration props for runtime customization
@@ -143,9 +146,9 @@
 	// Workflow settings sidebar state
 	let isWorkflowSettingsOpen = $state(false);
 
-	// Workflow configuration schema
-	const workflowConfigSchema: ConfigSchema = {
-		type: 'object',
+	// Workflow configuration schema (derived to pick up dynamic format options)
+	let workflowConfigSchema: ConfigSchema = $derived({
+		type: 'object' as const,
 		properties: {
 			name: {
 				type: 'string',
@@ -159,15 +162,23 @@
 				description: 'A description of the workflow',
 				format: 'multiline',
 				default: ''
+			},
+			format: {
+				type: 'string',
+				title: 'Workflow Format',
+				description: 'The specification format for this workflow',
+				oneOf: workflowFormatRegistry.getOneOfOptions(),
+				default: 'flowdrop'
 			}
 		},
 		required: ['name']
-	};
+	});
 
 	// Workflow configuration values
 	let workflowConfigValues = $derived({
 		name: $workflowName || '',
-		description: $workflowStore?.description || ''
+		description: $workflowStore?.description || '',
+		format: $workflowStore?.metadata?.format || 'flowdrop'
 	});
 
 	// Get the current node from the workflow store
@@ -188,7 +199,11 @@
 	async function fetchNodeTypes(): Promise<void> {
 		// If nodes were provided as props, use them directly (skip API fetch)
 		if (propNodes && propNodes.length > 0) {
-			nodes = propNodes;
+			// Merge format-provided nodes with prop nodes (deduplicate by ID, props take priority)
+			const formatNodes = workflowFormatRegistry.getAllFormatNodes();
+			const existingIds = new Set(propNodes.map((n) => n.id));
+			const uniqueFormatNodes = formatNodes.filter((n) => !existingIds.has(n.id));
+			nodes = [...propNodes, ...uniqueFormatNodes];
 			return;
 		}
 
@@ -205,7 +220,11 @@
 				fetchedNodes = await api.nodes.getNodes();
 			}
 
-			nodes = fetchedNodes;
+			// Merge format-provided nodes with API nodes (deduplicate by ID, API takes priority)
+			const formatNodes = workflowFormatRegistry.getAllFormatNodes();
+			const existingIds = new Set(fetchedNodes.map((n) => n.id));
+			const uniqueFormatNodes = formatNodes.filter((n) => !existingIds.has(n.id));
+			nodes = [...fetchedNodes, ...uniqueFormatNodes];
 			error = null;
 
 			// Dismiss loading toast
@@ -430,7 +449,7 @@
 				workflowId = uuidv4();
 			}
 
-			// Create workflow object for saving
+			// Create workflow object for saving (spread existing metadata to preserve format, tags, etc.)
 			const finalWorkflow: Workflow = {
 				id: workflowId,
 				name: workflowToSave.name || 'Untitled Workflow',
@@ -438,7 +457,9 @@
 				nodes: workflowToSave.nodes || [],
 				edges: workflowToSave.edges || [],
 				metadata: {
-					version: '1.0.0',
+					...workflowToSave.metadata,
+					version: workflowToSave.metadata?.version || '1.0.0',
+					format: workflowToSave.metadata?.format || DEFAULT_WORKFLOW_FORMAT,
 					createdAt: workflowToSave.metadata?.createdAt || new Date().toISOString(),
 					updatedAt: new Date().toISOString()
 				}
@@ -538,14 +559,16 @@
 				return;
 			}
 
-			// Create workflow object for export
+			// Create workflow object for export (spread existing metadata to preserve format, tags, etc.)
 			const finalWorkflow = {
 				id: workflowToExport.id || 'untitled-workflow',
 				name: workflowToExport.name || 'Untitled Workflow',
 				nodes: workflowToExport.nodes || [],
 				edges: workflowToExport.edges || [],
 				metadata: {
-					version: '1.0.0',
+					...workflowToExport.metadata,
+					version: workflowToExport.metadata?.version || '1.0.0',
+					format: workflowToExport.metadata?.format || DEFAULT_WORKFLOW_FORMAT,
 					createdAt: workflowToExport.metadata?.createdAt || new Date().toISOString(),
 					updatedAt: new Date().toISOString()
 				}
@@ -722,7 +745,7 @@
 
 	<!-- Left Sidebar: Node Components -->
 	{#snippet leftSidebar()}
-		<NodeSidebar {nodes} />
+		<NodeSidebar {nodes} activeFormat={$workflowFormat} />
 	{/snippet}
 
 	<!-- Right Sidebar: Configuration or Workflow Settings -->
@@ -746,9 +769,30 @@
 					onChange={(config) => {
 						// Sync workflow settings changes immediately on field blur
 						if ($workflowStore) {
+							const newFormat = (config.format as string) || DEFAULT_WORKFLOW_FORMAT;
+							const currentFormat = $workflowStore.metadata?.format || DEFAULT_WORKFLOW_FORMAT;
+
+							// Warn about incompatible nodes when format changes
+							if (newFormat !== currentFormat) {
+								const incompatibleNodes = $workflowStore.nodes?.filter((node) => {
+									const formats = node.data?.metadata?.formats;
+									return formats && formats.length > 0 && !formats.includes(newFormat);
+								});
+								if (incompatibleNodes && incompatibleNodes.length > 0) {
+									console.warn(
+										`Format changed to '${newFormat}'. ${incompatibleNodes.length} node(s) are not compatible with this format and may not export correctly:`,
+										incompatibleNodes.map((n) => n.data?.label || n.type)
+									);
+								}
+							}
+
 							workflowActions.batchUpdate({
 								name: config.name as string,
-								description: config.description as string | undefined
+								description: config.description as string | undefined,
+								metadata: {
+									...$workflowStore.metadata,
+									format: newFormat
+								}
 							});
 						}
 					}}

package/dist/components/NodeSidebar.svelte

@@ -5,7 +5,7 @@
 -->
 
 <script lang="ts">
-	import type { NodeMetadata, NodeCategory } from '../types/index.js';
+	import type { NodeMetadata, NodeCategory, WorkflowFormat } from '../types/index.js';
 	import LoadingSpinner from './LoadingSpinner.svelte';
 	import Icon from '@iconify/svelte';
 	import { getNodeIcon, getCategoryIcon } from '../utils/icons.js';
@@ -17,6 +17,7 @@
 	interface Props {
 		nodes: NodeMetadata[];
 		selectedCategory?: NodeCategory;
+		activeFormat?: WorkflowFormat;
 	}
 
 	let props: Props = $props();
@@ -31,6 +32,19 @@
 		updateSettings({ ui: { sidebarCollapsed: !$uiSettings.sidebarCollapsed } });
 	}
 
+	/**
+	 * Check if a node is compatible with the active workflow format.
+	 * Nodes without formats are universal (compatible with all formats).
+	 */
+	function isNodeCompatibleWithFormat(node: NodeMetadata): boolean {
+		if (!props.activeFormat) return true;
+		if (!node.formats || node.formats.length === 0) return true;
+		return node.formats.includes(props.activeFormat);
+	}
+
+	/** Nodes filtered by format compatibility */
+	let formatCompatibleNodes = $derived((props.nodes || []).filter(isNodeCompatibleWithFormat));
+
 	let filteredNodes = $derived(getFilteredNodes());
 	let categories = $derived(getCategories());
 
@@ -39,12 +53,11 @@
 	 * Categories appear in the order their first node appears in the API response
 	 */
 	function getCategories(): NodeCategory[] {
-		const nodes = props.nodes || [];
-		if (nodes.length === 0) return [];
+		if (formatCompatibleNodes.length === 0) return [];
 		// Use a Set to track uniqueness while preserving insertion order
 		const seen = new SvelteSet<NodeCategory>();
 		const orderedCategories: NodeCategory[] = [];
-		for (const node of nodes) {
+		for (const node of formatCompatibleNodes) {
 			if (!seen.has(node.category)) {
 				seen.add(node.category);
 				orderedCategories.push(node.category);
@@ -58,8 +71,8 @@
 	 * Preserves the API order - no client-side sorting applied
 	 */
 	function getFilteredNodes(): NodeMetadata[] {
-		// Use actual node types from props
-		let filtered = props.nodes || [];
+		// Start with format-compatible nodes
+		let filtered = formatCompatibleNodes;
 
 		// Filter by category
 		if (selectedCategory !== 'all') {
@@ -155,8 +168,7 @@
 	 * Preserves the API order - no client-side sorting applied
 	 */
 	function getNodesForCategory(category: NodeCategory): NodeMetadata[] {
-		const nodes = props.nodes || [];
-		return nodes.filter((node) => node.category === category);
+		return formatCompatibleNodes.filter((node) => node.category === category);
 	}
 
 	/**

package/dist/components/NodeSidebar.svelte.d.ts

@@ -1,7 +1,8 @@
-import type { NodeMetadata, NodeCategory } from '../types/index.js';
+import type { NodeMetadata, NodeCategory, WorkflowFormat } from '../types/index.js';
 interface Props {
     nodes: NodeMetadata[];
     selectedCategory?: NodeCategory;
+    activeFormat?: WorkflowFormat;
 }
 declare const NodeSidebar: import("svelte").Component<Props, {}, "">;
 type NodeSidebar = ReturnType<typeof NodeSidebar>;

package/dist/components/WorkflowEditor.svelte

@@ -387,19 +387,20 @@
 
 		// Find the best compatible edge using port-to-port distance
 		const portCoordinates = getPortCoordinateSnapshot();
-		const candidates = portCoordinates.size > 0
-			? ProximityConnectHelper.findCompatibleEdgesByPortCoordinates(
-					targetNode.id,
-					portCoordinates,
-					baseEdges,
-					$editorSettings.proximityConnectDistance
-				)
-			: ProximityConnectHelper.findCompatibleEdges(
-					targetNode,
-					flowNodes,
-					baseEdges,
-					$editorSettings.proximityConnectDistance
-				);
+		const candidates =
+			portCoordinates.size > 0
+				? ProximityConnectHelper.findCompatibleEdgesByPortCoordinates(
+						targetNode.id,
+						portCoordinates,
+						baseEdges,
+						$editorSettings.proximityConnectDistance
+					)
+				: ProximityConnectHelper.findCompatibleEdges(
+						targetNode,
+						flowNodes,
+						baseEdges,
+						$editorSettings.proximityConnectDistance
+					);
 
 		// Create preview edges
 		const previews = ProximityConnectHelper.createPreviewEdges(candidates);