@d34dman/flowdrop 0.0.57 → 0.0.58

package/README.md

@@ -224,10 +224,10 @@ Runtime configuration means you build once and deploy to staging, production, or
 ## Development
 
 ```bash
-npm install          # Install dependencies
-npm run dev          # Start dev server
-npm run build        # Build library
-npm test             # Run all tests
+pnpm install         # Install dependencies
+pnpm dev             # Start dev server
+pnpm build           # Build library
+pnpm test            # Run all tests
 ```
 
 ## Contributing

package/dist/adapters/WorkflowAdapter.d.ts

@@ -13,7 +13,7 @@
  * - External applications that want to integrate with FlowDrop
  * - Systems that need to generate or modify workflows programmatically
  */
-import type { Workflow, NodeMetadata } from '../types/index.js';
+import type { Workflow, NodeMetadata, WorkflowFormat } from '../types/index.js';
 /**
  * Standard workflow node interface (SvelteFlow-agnostic)
  */
@@ -55,6 +55,7 @@ export interface StandardWorkflow {
         updatedAt: string;
         author?: string;
         tags?: string[];
+        format?: WorkflowFormat;
     };
 }
 /**

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

@@ -59,6 +59,10 @@ export declare class AgentSpecAdapter {
     private resolveComponentType;
     /**
      * Convert an Agent Spec node to a FlowDrop StandardNode.
+     *
+     * Uses lightweight component type defaults for trigger ports and visual styling.
+     * Does NOT depend on the full node type registry — works with any component_type,
+     * including custom/unknown types (falls back to sensible defaults).
      */
     private convertNodeFromAgentSpec;
     /**

package/dist/adapters/agentspec/AgentSpecAdapter.js

@@ -9,7 +9,7 @@
  *
  * @see https://github.com/oracle/agent-spec
  */
-import { getAgentSpecNodeMetadata, createAgentSpecNodeMetadata, extractComponentType, AGENTSPEC_NAMESPACE } from './nodeTypeRegistry.js';
+import { getComponentTypeDefaults, extractComponentType, AGENTSPEC_NAMESPACE } from './componentTypeDefaults.js';
 import { computeAutoLayout } from './autoLayout.js';
 import { v4 as uuidv4 } from 'uuid';
 // ============================================================================
@@ -424,6 +424,10 @@ export class AgentSpecAdapter {
     }
     /**
      * Convert an Agent Spec node to a FlowDrop StandardNode.
+     *
+     * Uses lightweight component type defaults for trigger ports and visual styling.
+     * Does NOT depend on the full node type registry — works with any component_type,
+     * including custom/unknown types (falls back to sensible defaults).
      */
     convertNodeFromAgentSpec(asNode, nodeId, position) {
         // Restore position from metadata if available (round-trip)
@@ -432,22 +436,25 @@ export class AgentSpecAdapter {
         // Convert inputs/outputs to FlowDrop ports
         const dataInputs = (asNode.inputs || []).map((p) => agentSpecPropertyToNodePort(p, 'input'));
         const dataOutputs = (asNode.outputs || []).map((p) => agentSpecPropertyToNodePort(p, 'output'));
-        // Get base metadata from registry and merge with actual ports
-        const metadata = createAgentSpecNodeMetadata(asNode.component_type, undefined, // Let the method build from base
-        undefined);
-        if (!metadata) {
-            throw new Error(`Unknown Agent Spec component type: ${asNode.component_type}`);
-        }
-        // Merge data ports with the base trigger/tool ports from registry
-        const triggerInputs = metadata.inputs.filter((p) => p.dataType === 'trigger' || p.dataType === 'tool');
-        const triggerOutputs = metadata.outputs.filter((p) => p.dataType === 'trigger' || p.dataType === 'tool');
-        const finalMetadata = {
-            ...metadata,
-            description: asNode.description || metadata.description,
-            inputs: [...triggerInputs, ...dataInputs],
-            outputs: [...triggerOutputs, ...dataOutputs],
+        // Use lightweight adapter defaults (never throws on unknown types)
+        const defaults = getComponentTypeDefaults(asNode.component_type);
+        const nodeTypeId = asNode.metadata?.['flowdrop:node_type_id'] ||
+            `${AGENTSPEC_NAMESPACE}.${asNode.component_type}`;
+        const metadata = {
+            id: nodeTypeId,
+            name: defaults.defaultName,
+            type: defaults.visualType,
+            description: asNode.description || defaults.defaultDescription,
+            category: defaults.category,
+            version: '1.0.0',
+            icon: defaults.icon,
+            color: defaults.color,
+            badge: defaults.badge,
+            inputs: [...defaults.triggerInputs, ...dataInputs],
+            outputs: [...defaults.triggerOutputs, ...dataOutputs],
+            configSchema: { type: 'object', properties: {} },
+            formats: ['agentspec'],
             extensions: {
-                ...metadata.extensions,
                 'agentspec:component_type': asNode.component_type,
                 'agentspec:original_name': asNode.name
             }
@@ -456,12 +463,12 @@ export class AgentSpecAdapter {
         const config = this.extractConfigFromAgentSpec(asNode);
         return {
             id: nodeId,
-            type: asNode.metadata?.['flowdrop:node_type_id'] || metadata.id,
+            type: nodeTypeId,
             position: finalPosition,
             data: {
                 label: asNode.name,
                 config,
-                metadata: finalMetadata
+                metadata
             }
         };
     }
@@ -506,8 +513,7 @@ export class AgentSpecAdapter {
             case 'agent_node': {
                 const agent = asNode;
                 if (agent.agent) {
-                    config.agent_ref =
-                        typeof agent.agent === 'string' ? agent.agent : agent.agent.name;
+                    config.agent_ref = typeof agent.agent === 'string' ? agent.agent : agent.agent.name;
                 }
                 break;
             }
@@ -525,8 +531,7 @@ export class AgentSpecAdapter {
                 if (map.output_collection)
                     config.output_collection = map.output_collection;
                 if (map.map_flow) {
-                    config.map_flow_ref =
-                        typeof map.map_flow === 'string' ? map.map_flow : map.map_flow.name;
+                    config.map_flow_ref = typeof map.map_flow === 'string' ? map.map_flow : map.map_flow.name;
                 }
                 break;
             }

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

@@ -0,0 +1,73 @@
+/**
+ * Agent Spec Component Type Defaults
+ *
+ * Internal adapter infrastructure for import/export.
+ * Provides lightweight defaults per component_type (trigger ports, visual styling)
+ * WITHOUT prescribing full node type definitions (data ports, config schemas).
+ *
+ * Full node type definitions are user-provided via getDefaultAgentSpecNodeTypes()
+ * or custom node arrays passed to mountFlowDropApp().
+ */
+import type { NodePort } from '../../types/index.js';
+/** Namespace prefix for Agent Spec node type IDs */
+export declare const AGENTSPEC_NAMESPACE = "agentspec";
+/** Standard trigger input port — control flow into a node */
+export declare const TRIGGER_INPUT: NodePort;
+/** Standard trigger output port — control flow out of a node */
+export declare const TRIGGER_OUTPUT: NodePort;
+/**
+ * Lightweight defaults for a component_type.
+ * Used during import to construct minimal NodeMetadata from Agent Spec JSON.
+ * These are NOT full node type definitions — they only contain what the
+ * adapter needs to create valid FlowDrop nodes.
+ */
+export interface ComponentTypeDefaults {
+    /** FlowDrop visual node type (terminal, gateway, default, tool, simple) */
+    visualType: string;
+    /** Node category for sidebar grouping */
+    category: string;
+    /** Default display color */
+    color: string;
+    /** Default icon (MDI format) */
+    icon: string;
+    /** Badge text for node header */
+    badge: string;
+    /** Default node name when no name provided */
+    defaultName: string;
+    /** Default description */
+    defaultDescription: string;
+    /** Trigger/tool ports to prepend to data inputs during import */
+    triggerInputs: NodePort[];
+    /** Trigger/tool ports to prepend to data outputs during import */
+    triggerOutputs: NodePort[];
+}
+/**
+ * Get adapter defaults for a component type.
+ * Returns sensible fallbacks for unrecognized types (never throws).
+ *
+ * @param componentType - The Agent Spec component_type value
+ * @returns ComponentTypeDefaults for the type, or fallback for unknown types
+ */
+export declare function getComponentTypeDefaults(componentType: string): ComponentTypeDefaults;
+/**
+ * Check if a FlowDrop node ID belongs to an Agent Spec node type.
+ *
+ * @example
+ * ```typescript
+ * isAgentSpecNodeId('agentspec.llm_node') // true
+ * isAgentSpecNodeId('calculator') // false
+ * ```
+ */
+export declare function isAgentSpecNodeId(nodeId: string): boolean;
+/**
+ * Extract the component_type string from a FlowDrop node type ID.
+ * Does not validate against any registry — any string after the namespace prefix is returned.
+ *
+ * @example
+ * ```typescript
+ * extractComponentType('agentspec.llm_node') // 'llm_node'
+ * extractComponentType('agentspec.my_custom') // 'my_custom'
+ * extractComponentType('calculator') // undefined
+ * ```
+ */
+export declare function extractComponentType(nodeTypeId: string): string | undefined;

package/dist/adapters/agentspec/componentTypeDefaults.js

@@ -0,0 +1,238 @@
+/**
+ * Agent Spec Component Type Defaults
+ *
+ * Internal adapter infrastructure for import/export.
+ * Provides lightweight defaults per component_type (trigger ports, visual styling)
+ * WITHOUT prescribing full node type definitions (data ports, config schemas).
+ *
+ * Full node type definitions are user-provided via getDefaultAgentSpecNodeTypes()
+ * or custom node arrays passed to mountFlowDropApp().
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+/** Namespace prefix for Agent Spec node type IDs */
+export const AGENTSPEC_NAMESPACE = 'agentspec';
+// ============================================================================
+// Standard ports (adapter infrastructure)
+// ============================================================================
+/** Standard trigger input port — control flow into a node */
+export const TRIGGER_INPUT = {
+    id: 'trigger',
+    name: 'Trigger',
+    type: 'input',
+    dataType: 'trigger',
+    required: false,
+    description: 'Control flow input'
+};
+/** Standard trigger output port — control flow out of a node */
+export const TRIGGER_OUTPUT = {
+    id: 'trigger',
+    name: 'Trigger',
+    type: 'output',
+    dataType: 'trigger',
+    required: false,
+    description: 'Control flow output'
+};
+/** Tool input port for tool_node */
+const TOOL_INPUT = {
+    id: 'tool',
+    name: 'Tool',
+    type: 'input',
+    dataType: 'tool',
+    required: false,
+    description: 'Tool connection'
+};
+/** Tool output port for tool_node */
+const TOOL_OUTPUT = {
+    id: 'tool',
+    name: 'Tool',
+    type: 'output',
+    dataType: 'tool',
+    description: 'Tool passthrough'
+};
+// ============================================================================
+// Defaults mapping
+// ============================================================================
+const COMPONENT_TYPE_DEFAULTS = new Map([
+    [
+        'start_node',
+        {
+            visualType: 'terminal',
+            category: 'triggers',
+            color: '#22c55e',
+            icon: 'mdi:play-circle',
+            badge: 'START',
+            defaultName: 'Start',
+            defaultDescription: 'Flow entry point. Defines the initial inputs for the flow.',
+            triggerInputs: [],
+            triggerOutputs: [TRIGGER_OUTPUT]
+        }
+    ],
+    [
+        'end_node',
+        {
+            visualType: 'terminal',
+            category: 'outputs',
+            color: '#ef4444',
+            icon: 'mdi:stop-circle',
+            badge: 'END',
+            defaultName: 'End',
+            defaultDescription: 'Flow exit point. Defines the final outputs of the flow.',
+            triggerInputs: [TRIGGER_INPUT],
+            triggerOutputs: []
+        }
+    ],
+    [
+        'llm_node',
+        {
+            visualType: 'default',
+            category: 'ai',
+            color: '#8b5cf6',
+            icon: 'mdi:brain',
+            badge: 'LLM',
+            defaultName: 'LLM',
+            defaultDescription: 'Generate text using a large language model with configurable prompts.',
+            triggerInputs: [TRIGGER_INPUT],
+            triggerOutputs: [TRIGGER_OUTPUT]
+        }
+    ],
+    [
+        'branching_node',
+        {
+            visualType: 'gateway',
+            category: 'logic',
+            color: '#f59e0b',
+            icon: 'mdi:source-branch',
+            badge: 'BRANCH',
+            defaultName: 'Branch',
+            defaultDescription: 'Route execution to different paths based on conditions.',
+            triggerInputs: [TRIGGER_INPUT],
+            triggerOutputs: []
+        }
+    ],
+    [
+        'tool_node',
+        {
+            visualType: 'tool',
+            category: 'tools',
+            color: '#06b6d4',
+            icon: 'mdi:wrench',
+            badge: 'TOOL',
+            defaultName: 'Tool',
+            defaultDescription: 'Execute a tool function with inputs and receive outputs.',
+            triggerInputs: [TRIGGER_INPUT, TOOL_INPUT],
+            triggerOutputs: [TRIGGER_OUTPUT, TOOL_OUTPUT]
+        }
+    ],
+    [
+        'api_node',
+        {
+            visualType: 'default',
+            category: 'data',
+            color: '#3b82f6',
+            icon: 'mdi:api',
+            badge: 'API',
+            defaultName: 'API Call',
+            defaultDescription: 'Make an HTTP API call with configurable endpoint, method, and headers.',
+            triggerInputs: [TRIGGER_INPUT],
+            triggerOutputs: [TRIGGER_OUTPUT]
+        }
+    ],
+    [
+        'agent_node',
+        {
+            visualType: 'default',
+            category: 'agents',
+            color: '#ec4899',
+            icon: 'mdi:robot',
+            badge: 'AGENT',
+            defaultName: 'Agent',
+            defaultDescription: 'Run a multi-round agent conversation within the flow.',
+            triggerInputs: [TRIGGER_INPUT],
+            triggerOutputs: [TRIGGER_OUTPUT]
+        }
+    ],
+    [
+        'flow_node',
+        {
+            visualType: 'simple',
+            category: 'processing',
+            color: '#14b8a6',
+            icon: 'mdi:sitemap',
+            badge: 'FLOW',
+            defaultName: 'Sub-Flow',
+            defaultDescription: 'Execute another flow as a sub-routine within this flow.',
+            triggerInputs: [TRIGGER_INPUT],
+            triggerOutputs: [TRIGGER_OUTPUT]
+        }
+    ],
+    [
+        'map_node',
+        {
+            visualType: 'default',
+            category: 'processing',
+            color: '#f97316',
+            icon: 'mdi:map-marker-path',
+            badge: 'MAP',
+            defaultName: 'Map',
+            defaultDescription: 'Apply a flow or operation to each item in a collection (map-reduce).',
+            triggerInputs: [TRIGGER_INPUT],
+            triggerOutputs: [TRIGGER_OUTPUT]
+        }
+    ]
+]);
+/** Fallback defaults for unrecognized component types */
+const UNKNOWN_DEFAULTS = {
+    visualType: 'default',
+    category: 'processing',
+    color: '#6b7280',
+    icon: 'mdi:puzzle',
+    badge: '',
+    defaultName: 'Unknown',
+    defaultDescription: 'Agent Spec node',
+    triggerInputs: [TRIGGER_INPUT],
+    triggerOutputs: [TRIGGER_OUTPUT]
+};
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Get adapter defaults for a component type.
+ * Returns sensible fallbacks for unrecognized types (never throws).
+ *
+ * @param componentType - The Agent Spec component_type value
+ * @returns ComponentTypeDefaults for the type, or fallback for unknown types
+ */
+export function getComponentTypeDefaults(componentType) {
+    return COMPONENT_TYPE_DEFAULTS.get(componentType) ?? UNKNOWN_DEFAULTS;
+}
+/**
+ * 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_NAMESPACE}.`);
+}
+/**
+ * Extract the component_type string from a FlowDrop node type ID.
+ * Does not validate against any registry — any string after the namespace prefix is returned.
+ *
+ * @example
+ * ```typescript
+ * extractComponentType('agentspec.llm_node') // 'llm_node'
+ * extractComponentType('agentspec.my_custom') // 'my_custom'
+ * extractComponentType('calculator') // undefined
+ * ```
+ */
+export function extractComponentType(nodeTypeId) {
+    if (!isAgentSpecNodeId(nodeTypeId))
+        return undefined;
+    const componentType = nodeTypeId.slice(AGENTSPEC_NAMESPACE.length + 1);
+    return componentType || undefined;
+}

package/dist/adapters/agentspec/{nodeTypeRegistry.d.ts → defaultNodeTypes.d.ts}

@@ -1,9 +1,22 @@
 /**
- * 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
+ * });
+ * ```
  */
 import type { NodeMetadata, NodePort } from '../../types/index.js';
 import type { AgentSpecNodeComponentType } from '../../types/agentspec.js';
@@ -21,12 +34,12 @@ import type { AgentSpecNodeComponentType } from '../../types/agentspec.js';
  */
 export declare function getAgentSpecNodeMetadata(componentType: AgentSpecNodeComponentType): NodeMetadata | undefined;
 /**
- * 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 declare function getAllAgentSpecNodeTypes(): NodeMetadata[];
+export declare function getDefaultAgentSpecNodeTypes(): NodeMetadata[];
 /**
  * Get a copy of the NodeMetadata for a component type with custom inputs/outputs.
  * Used during import to create node metadata that matches the Agent Spec definition's
@@ -38,25 +51,3 @@ export declare function getAllAgentSpecNodeTypes(): NodeMetadata[];
  * @returns A new NodeMetadata with the custom ports merged in
  */
 export declare function createAgentSpecNodeMetadata(componentType: AgentSpecNodeComponentType, inputs?: NodePort[], outputs?: NodePort[]): NodeMetadata | undefined;
-/**
- * Check if a FlowDrop node ID belongs to an Agent Spec node type.
- *
- * @example
- * ```typescript
- * isAgentSpecNodeId('agentspec.llm_node') // true
- * isAgentSpecNodeId('calculator') // false
- * ```
- */
-export declare function isAgentSpecNodeId(nodeId: string): boolean;
-/**
- * Extract the Agent Spec component_type from a FlowDrop node type ID.
- *
- * @example
- * ```typescript
- * extractComponentType('agentspec.llm_node') // 'llm_node'
- * extractComponentType('calculator') // undefined
- * ```
- */
-export declare function extractComponentType(nodeTypeId: string): AgentSpecNodeComponentType | undefined;
-/** The namespace prefix used for Agent Spec node type IDs */
-export declare const AGENTSPEC_NAMESPACE = "agentspec";