@flowdrop/flowdrop 2.0.0-beta.4 → 2.0.0-beta.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/CHANGELOG.md +35 -0
  2. package/dist/adapters/WorkflowAdapter.js +4 -5
  3. package/dist/adapters/agentspec/AgentSpecAdapter.js +3 -3
  4. package/dist/adapters/agentspec/defaultNodeTypes.js +9 -9
  5. package/dist/commands/executor.js +5 -6
  6. package/dist/commands/types.js +5 -5
  7. package/dist/components/App.svelte +5 -14
  8. package/dist/components/ConfigForm.svelte +6 -505
  9. package/dist/components/ConfigForm.svelte.d.ts +4 -6
  10. package/dist/components/ConfigModal.svelte +0 -1
  11. package/dist/components/NodeSidebar.svelte +4 -4
  12. package/dist/components/NodeSwapPicker.svelte +2 -2
  13. package/dist/components/UniversalNode.svelte +5 -4
  14. package/dist/components/UniversalNode.svelte.d.ts +1 -1
  15. package/dist/components/console/ConsoleInput.svelte +3 -3
  16. package/dist/components/form/FormField.svelte +15 -0
  17. package/dist/components/form/FormFieldLight.svelte +14 -0
  18. package/dist/components/form/FormPorts.svelte +262 -0
  19. package/dist/components/form/FormPorts.svelte.d.ts +13 -0
  20. package/dist/components/nodes/AtomNode.svelte +16 -42
  21. package/dist/components/nodes/AtomNode.svelte.d.ts +1 -1
  22. package/dist/components/nodes/GatewayNode.svelte +26 -65
  23. package/dist/components/nodes/GatewayNode.svelte.d.ts +1 -1
  24. package/dist/components/nodes/IdeaNode.svelte +10 -8
  25. package/dist/components/nodes/IdeaNode.svelte.d.ts +8 -4
  26. package/dist/components/nodes/NotesNode.svelte +6 -4
  27. package/dist/components/nodes/NotesNode.svelte.d.ts +8 -4
  28. package/dist/components/nodes/SimpleNode.svelte +31 -55
  29. package/dist/components/nodes/SimpleNode.svelte.d.ts +4 -4
  30. package/dist/components/nodes/SquareNode.svelte +31 -55
  31. package/dist/components/nodes/SquareNode.svelte.d.ts +4 -4
  32. package/dist/components/nodes/TerminalNode.svelte +34 -38
  33. package/dist/components/nodes/TerminalNode.svelte.d.ts +4 -4
  34. package/dist/components/nodes/ToolNode.svelte +10 -8
  35. package/dist/components/nodes/ToolNode.svelte.d.ts +6 -6
  36. package/dist/components/nodes/WorkflowNode.svelte +43 -93
  37. package/dist/components/nodes/WorkflowNode.svelte.d.ts +1 -1
  38. package/dist/components/playground/PipelineKanbanView.svelte +2 -2
  39. package/dist/components/playground/PipelineTableView.svelte +2 -2
  40. package/dist/core/index.d.ts +1 -1
  41. package/dist/helpers/workflowEditorHelper.js +4 -5
  42. package/dist/openapi/v1/openapi.yaml +33 -21
  43. package/dist/registry/nodeComponentRegistry.d.ts +2 -1
  44. package/dist/schemas/v1/workflow.schema.json +16 -14
  45. package/dist/services/dynamicSchemaService.d.ts +2 -2
  46. package/dist/services/dynamicSchemaService.js +8 -8
  47. package/dist/stores/playgroundStore.svelte.js +1 -1
  48. package/dist/stores/workflowStore.svelte.d.ts +1 -1
  49. package/dist/stores/workflowStore.svelte.js +1 -19
  50. package/dist/types/index.d.ts +51 -27
  51. package/dist/utils/colors.d.ts +27 -0
  52. package/dist/utils/colors.js +23 -0
  53. package/dist/utils/connections.js +6 -6
  54. package/dist/utils/nodeIds.d.ts +1 -1
  55. package/dist/utils/nodeIds.js +1 -1
  56. package/dist/utils/nodeSwap.js +3 -6
  57. package/dist/utils/portUtils.d.ts +47 -11
  58. package/dist/utils/portUtils.js +67 -14
  59. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -7,6 +7,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [2.0.0-beta.6] - 2026-06-22
11
+
12
+ Sixth 2.0 beta, published under the npm `beta` dist-tag (`npm install @flowdrop/flowdrop@beta`). `latest` remains 1.15.0 until 2.0.0 GA. This release unifies port **order** and **exposure** into a single per-instance `data.config.ports` value and makes exposure semantic — "what you see is what runs": a not-exposed port is hidden on the canvas, not wireable, and not runtime-overridable. The two older, separate mechanisms (`extensions.ui.portOrder` for order and `hideUnconnectedHandles` for visibility) are removed. A single combined "Ports" widget in the config panel now handles both reorder and expose/hide per port, and reserved ports (the `error` output and `trigger`/`tool` control ports) sort to the bottom automatically.
13
+
14
+ ### Breaking Changes
15
+
16
+ - **Port order + exposure unified into `data.config.ports`.** Order and exposure are now one per-direction ordered list of `{ id, exposed? }` entries (`PortsConfig`): array position encodes display order, and the optional `exposed` flag overrides the port's metadata `exposedByDefault` — stored only when it diverges. An untouched node persists no `ports` key. This replaces `extensions.ui.portOrder` (removed) and the interim `exposedPorts` map. Consumers that read or write either must migrate to `config.ports`; the OpenAPI/JSON schema (`PortsConfig`, `PortConfigEntry`, `NodePort.displayOrder`) was updated to match.
17
+ - **`hideUnconnectedHandles` removed end-to-end.** Visibility is no longer derived from connection state. A port renders iff it is exposed (`config.ports` override, else metadata `exposedByDefault`, which defaults to exposed). Dropped from `NodeUIExtensions`, every node renderer, the config form, fixtures, and the schema; `hiddenPorts` retired with it.
18
+
19
+ ### Added
20
+
21
+ - **Combined `FormPorts` widget.** A single "Ports" group in the config panel renders one row per port with reorder (up/down) and an expose/hide toggle, replacing the separate Port Order panel and the interim exposed-ports widget. Edits write the minimal `config.ports` value and collapse back to `undefined` on the default order with no exposure override.
22
+ - **`NodePort.displayOrder` + automatic reserved-port ordering.** A cosmetic default sort weight (ascending; ties on declaration order). Reserved ports — the `error` output and `trigger`/`tool` control ports — sink to the bottom of their direction automatically via `RESERVED_PORT_DISPLAY_ORDER`, with no value required from authors; an explicit `displayOrder` overrides. New `byDefaultOrder`, `orderPortsFor`, `isPortExposed`, and `isReservedPort` utilities.
23
+
24
+ ### Fixed
25
+
26
+ - **OpenAPI `NodeMetadata` aligned with the `node_type_id` rename.** Follow-up to beta.5: the spec's `NodeMetadata` now references `node_type_id` consistently (the bundled spec shipped in the package was regenerated).
27
+
28
+ ### Docs
29
+
30
+ - **`maxRetries` added to the reserved config-property table.**
31
+
32
+ ## [2.0.0-beta.5] - 2026-06-20
33
+
34
+ Fifth 2.0 beta, published under the npm `beta` dist-tag (`npm install @flowdrop/flowdrop@beta`). `latest` remains 1.15.0 until 2.0.0 GA. This release is a node-identity cleanup: node components now derive their instance id from the canonical `id` prop SvelteFlow already passes, dropping the duplicate `data.nodeId` copy and its load-time healing, and the node-_type_ entity id is renamed `metadata.id` → `metadata.node_type_id` to disambiguate it from the instance id. Six node components were also moved off the type-erasing `$props<T>()` onto a typed `interface Props`, which surfaced and fixed latent config-access errors in `ToolNode`.
35
+
36
+ ### Breaking Changes
37
+
38
+ - **Node-type entity id renamed `metadata.id` → `metadata.node_type_id`.** The node-type entity id collided conceptually with the node _instance_ id; it is now `metadata.node_type_id` to disambiguate the two. It is a server-owned wire field, so the library preserves the snake_case name as a non-opinionated passthrough — adapters, the command type-map, connection validation, and the dynamic-schema paths were all updated to match. Consumers reading `metadata.id` for the node type must read `metadata.node_type_id`. **Backend impact:** the `GET /nodes` response and `metadata` blocks in persisted workflows must now use `node_type_id`; the OpenAPI spec (`NodeMetadata`) and the bundled spec shipped in the package were updated accordingly.
39
+ - **Dropped the duplicate `data.nodeId` field.** Node components now derive their id from the canonical `id` prop that SvelteFlow already passes to every node, instead of a copy stored in `data.nodeId`. Handle ids, config-open callbacks, and status overlays read `id` directly. The field and its load-time "healing" are gone, so an intact graph can no longer look corrupted from a missing copy. `WorkflowNode.data.nodeId` was also removed from the OpenAPI spec.
40
+
41
+ ### Changed (internal — no API change)
42
+
43
+ - **Six node components typed properly.** The node components that used `$props<T>()` — which returns `any` and silently disabled type-checking — now declare an `interface Props` with `let props: Props = $props()`. This surfaced and fixed latent config-access errors in `ToolNode`.
44
+
10
45
  ## [2.0.0-beta.4] - 2026-06-13
11
46
 
12
47
  Fourth 2.0 beta, published under the npm `beta` dist-tag (`npm install @flowdrop/flowdrop@beta`). `latest` remains 1.15.0 until 2.0.0 GA. This release is mostly an internal design-system consolidation pass — new shared `Button` / `IconButton` / `Input` / `Select` / `Textarea` primitives route every control through the `base.css` class system as the single source of truth, so themes (including Drafter) style fields and buttons consistently. User-visible changes are a navbar `end` snippet for embedding custom trailing controls, a new `--fd-control-radius` theming token, a range-slider fill fix, and opaque Drafter buttons. The archived Astro docs site is retired in favor of the Mintlify docs at `flowdrop.mintlify.app`.
@@ -46,7 +46,7 @@ export class WorkflowAdapter {
46
46
  * Add a node to a workflow
47
47
  */
48
48
  addNode(workflow, nodeType, position, config) {
49
- const metadata = this.nodeTypes.find((nt) => nt.id === nodeType);
49
+ const metadata = this.nodeTypes.find((nt) => nt.node_type_id === nodeType);
50
50
  if (!metadata) {
51
51
  throw new Error(`Node type '${nodeType}' not found`);
52
52
  }
@@ -248,7 +248,7 @@ export class WorkflowAdapter {
248
248
  description: svelteFlowWorkflow.description,
249
249
  nodes: svelteFlowWorkflow.nodes.map((node) => ({
250
250
  id: node.id,
251
- type: node.data.metadata.id,
251
+ type: node.data.metadata.node_type_id,
252
252
  position: node.position,
253
253
  data: {
254
254
  label: node.data.label,
@@ -282,8 +282,7 @@ export class WorkflowAdapter {
282
282
  data: {
283
283
  label: node.data.label,
284
284
  config: node.data.config,
285
- metadata: node.data.metadata,
286
- nodeId: node.id
285
+ metadata: node.data.metadata
287
286
  }
288
287
  })),
289
288
  edges: workflow.edges.map((edge) => ({
@@ -326,7 +325,7 @@ export class WorkflowAdapter {
326
325
  const nodeTypeCounts = new Map();
327
326
  cloned.nodes.forEach((node) => {
328
327
  const oldId = node.id;
329
- const nodeTypeId = node.data.metadata.id;
328
+ const nodeTypeId = node.data.metadata.node_type_id;
330
329
  // Get the current count for this node type
331
330
  const currentCount = nodeTypeCounts.get(nodeTypeId) || 0;
332
331
  const newCount = currentCount + 1;
@@ -266,7 +266,7 @@ export class AgentSpecAdapter {
266
266
  metadata: {
267
267
  'flowdrop:position': node.position,
268
268
  'flowdrop:node_id': node.id,
269
- 'flowdrop:node_type_id': node.data.metadata.id
269
+ 'flowdrop:node_type_id': node.data.metadata.node_type_id
270
270
  }
271
271
  };
272
272
  // Add type-specific attributes from config
@@ -362,7 +362,7 @@ export class AgentSpecAdapter {
362
362
  return ext;
363
363
  }
364
364
  // Infer from FlowDrop node type ID
365
- const fromId = extractComponentType(node.data.metadata.id);
365
+ const fromId = extractComponentType(node.data.metadata.node_type_id);
366
366
  if (fromId)
367
367
  return fromId;
368
368
  // Infer from FlowDrop visual type + category
@@ -404,7 +404,7 @@ export class AgentSpecAdapter {
404
404
  const nodeTypeId = asNode.metadata?.['flowdrop:node_type_id'] ||
405
405
  `${AGENTSPEC_NAMESPACE}.${asNode.component_type}`;
406
406
  const metadata = {
407
- id: nodeTypeId,
407
+ node_type_id: nodeTypeId,
408
408
  name: defaults.defaultName,
409
409
  type: defaults.visualType,
410
410
  description: asNode.description || defaults.defaultDescription,
@@ -30,7 +30,7 @@ function buildRegistry() {
30
30
  registry.set('start_node', {
31
31
  componentType: 'start_node',
32
32
  metadata: {
33
- id: `${AGENTSPEC_NS}.start_node`,
33
+ node_type_id: `${AGENTSPEC_NS}.start_node`,
34
34
  name: 'Start',
35
35
  type: 'terminal',
36
36
  description: 'Flow entry point. Defines the initial inputs for the flow.',
@@ -55,7 +55,7 @@ function buildRegistry() {
55
55
  registry.set('end_node', {
56
56
  componentType: 'end_node',
57
57
  metadata: {
58
- id: `${AGENTSPEC_NS}.end_node`,
58
+ node_type_id: `${AGENTSPEC_NS}.end_node`,
59
59
  name: 'End',
60
60
  type: 'terminal',
61
61
  description: 'Flow exit point. Defines the final outputs of the flow.',
@@ -80,7 +80,7 @@ function buildRegistry() {
80
80
  registry.set('llm_node', {
81
81
  componentType: 'llm_node',
82
82
  metadata: {
83
- id: `${AGENTSPEC_NS}.llm_node`,
83
+ node_type_id: `${AGENTSPEC_NS}.llm_node`,
84
84
  name: 'LLM',
85
85
  type: 'default',
86
86
  description: 'Generate text using a large language model with configurable prompts.',
@@ -145,7 +145,7 @@ function buildRegistry() {
145
145
  registry.set('branching_node', {
146
146
  componentType: 'branching_node',
147
147
  metadata: {
148
- id: `${AGENTSPEC_NS}.branching_node`,
148
+ node_type_id: `${AGENTSPEC_NS}.branching_node`,
149
149
  name: 'Branch',
150
150
  type: 'gateway',
151
151
  description: 'Route execution to different paths based on conditions.',
@@ -213,7 +213,7 @@ function buildRegistry() {
213
213
  registry.set('tool_node', {
214
214
  componentType: 'tool_node',
215
215
  metadata: {
216
- id: `${AGENTSPEC_NS}.tool_node`,
216
+ node_type_id: `${AGENTSPEC_NS}.tool_node`,
217
217
  name: 'Tool',
218
218
  type: 'tool',
219
219
  description: 'Execute a tool function with inputs and receive outputs.',
@@ -271,7 +271,7 @@ function buildRegistry() {
271
271
  registry.set('api_node', {
272
272
  componentType: 'api_node',
273
273
  metadata: {
274
- id: `${AGENTSPEC_NS}.api_node`,
274
+ node_type_id: `${AGENTSPEC_NS}.api_node`,
275
275
  name: 'API Call',
276
276
  type: 'default',
277
277
  description: 'Make an HTTP API call with configurable endpoint, method, and headers.',
@@ -342,7 +342,7 @@ function buildRegistry() {
342
342
  registry.set('agent_node', {
343
343
  componentType: 'agent_node',
344
344
  metadata: {
345
- id: `${AGENTSPEC_NS}.agent_node`,
345
+ node_type_id: `${AGENTSPEC_NS}.agent_node`,
346
346
  name: 'Agent',
347
347
  type: 'default',
348
348
  description: 'Run a multi-round agent conversation within the flow.',
@@ -400,7 +400,7 @@ function buildRegistry() {
400
400
  registry.set('flow_node', {
401
401
  componentType: 'flow_node',
402
402
  metadata: {
403
- id: `${AGENTSPEC_NS}.flow_node`,
403
+ node_type_id: `${AGENTSPEC_NS}.flow_node`,
404
404
  name: 'Sub-Flow',
405
405
  type: 'simple',
406
406
  description: 'Execute another flow as a sub-routine within this flow.',
@@ -451,7 +451,7 @@ function buildRegistry() {
451
451
  registry.set('map_node', {
452
452
  componentType: 'map_node',
453
453
  metadata: {
454
- id: `${AGENTSPEC_NS}.map_node`,
454
+ node_type_id: `${AGENTSPEC_NS}.map_node`,
455
455
  name: 'Map',
456
456
  type: 'default',
457
457
  description: 'Apply a flow or operation to each item in a collection (map-reduce).',
@@ -76,7 +76,7 @@ function executeAddNode(command, context) {
76
76
  };
77
77
  }
78
78
  const position = command.position ?? computeAutoPosition(workflow.nodes);
79
- const nodeId = generateNodeId(metadata.id, workflow.nodes);
79
+ const nodeId = generateNodeId(metadata.node_type_id, workflow.nodes);
80
80
  const config = extractConfigDefaults(metadata.configSchema);
81
81
  const node = {
82
82
  id: nodeId,
@@ -86,8 +86,7 @@ function executeAddNode(command, context) {
86
86
  data: {
87
87
  label: metadata.name,
88
88
  config,
89
- metadata,
90
- nodeId
89
+ metadata
91
90
  }
92
91
  };
93
92
  context.dispatch.addNode(node);
@@ -357,7 +356,7 @@ function executeInfo(command, context) {
357
356
  const resultData = {
358
357
  nodeId: shortId,
359
358
  label: node.data.label ?? metadata?.name ?? '',
360
- type: metadata?.id ? toShortTypeId(metadata.id) : '',
359
+ type: metadata?.node_type_id ? toShortTypeId(metadata.node_type_id) : '',
361
360
  position: node.position,
362
361
  config: node.data.config ?? {},
363
362
  inputs,
@@ -578,7 +577,7 @@ function executeListNodes(context) {
578
577
  const nodes = workflow.nodes.map((n) => ({
579
578
  nodeId: toShortId(n.id),
580
579
  label: n.data.label ?? n.data.metadata?.name ?? '',
581
- type: n.data.metadata?.id ? toShortTypeId(n.data.metadata.id) : ''
580
+ type: n.data.metadata?.node_type_id ? toShortTypeId(n.data.metadata.node_type_id) : ''
582
581
  }));
583
582
  const resultData = { nodes };
584
583
  return {
@@ -610,7 +609,7 @@ function executeListEdges(context) {
610
609
  }
611
610
  function executeListTypes(context) {
612
611
  const types = context.nodeTypes.map((m) => ({
613
- typeId: toShortTypeId(m.id),
612
+ typeId: toShortTypeId(m.node_type_id),
614
613
  name: m.name,
615
614
  category: m.category
616
615
  }));
@@ -24,18 +24,18 @@ export function buildTypeMap(nodeTypes) {
24
24
  const shortIdCounts = new Map();
25
25
  // First pass: register full IDs and count short ID occurrences
26
26
  for (const metadata of nodeTypes) {
27
- map.set(metadata.id, metadata);
28
- const dotIndex = metadata.id.indexOf('.');
27
+ map.set(metadata.node_type_id, metadata);
28
+ const dotIndex = metadata.node_type_id.indexOf('.');
29
29
  if (dotIndex !== -1) {
30
- const shortId = metadata.id.substring(dotIndex + 1);
30
+ const shortId = metadata.node_type_id.substring(dotIndex + 1);
31
31
  shortIdCounts.set(shortId, (shortIdCounts.get(shortId) ?? 0) + 1);
32
32
  }
33
33
  }
34
34
  // Second pass: register unique short IDs
35
35
  for (const metadata of nodeTypes) {
36
- const dotIndex = metadata.id.indexOf('.');
36
+ const dotIndex = metadata.node_type_id.indexOf('.');
37
37
  if (dotIndex !== -1) {
38
- const shortId = metadata.id.substring(dotIndex + 1);
38
+ const shortId = metadata.node_type_id.substring(dotIndex + 1);
39
39
  if (shortIdCounts.get(shortId) === 1) {
40
40
  map.set(shortId, metadata);
41
41
  }
@@ -412,8 +412,8 @@
412
412
  if (propNodes && propNodes.length > 0) {
413
413
  // Merge format-provided nodes with prop nodes (deduplicate by ID, props take priority)
414
414
  const formatNodes = fd.formats.getAllFormatNodes();
415
- const existingIds = new Set(propNodes.map((n) => n.id));
416
- const uniqueFormatNodes = formatNodes.filter((n) => !existingIds.has(n.id));
415
+ const existingIds = new Set(propNodes.map((n) => n.node_type_id));
416
+ const uniqueFormatNodes = formatNodes.filter((n) => !existingIds.has(n.node_type_id));
417
417
  nodes = [...propNodes, ...uniqueFormatNodes];
418
418
  nodeTypesLoading = false;
419
419
  return;
@@ -429,8 +429,8 @@
429
429
 
430
430
  // Merge format-provided nodes with API nodes (deduplicate by ID, API takes priority)
431
431
  const formatNodes = fd.formats.getAllFormatNodes();
432
- const existingIds = new Set(fetchedNodes.map((n) => n.id));
433
- const uniqueFormatNodes = formatNodes.filter((n) => !existingIds.has(n.id));
432
+ const existingIds = new Set(fetchedNodes.map((n) => n.node_type_id));
433
+ const uniqueFormatNodes = formatNodes.filter((n) => !existingIds.has(n.node_type_id));
434
434
  nodes = [...fetchedNodes, ...uniqueFormatNodes];
435
435
  error = null;
436
436
  nodeTypesLoading = false;
@@ -1069,7 +1069,6 @@
1069
1069
  {authProvider}
1070
1070
  schema={workflowConfigSchema}
1071
1071
  values={workflowConfigValues}
1072
- showUIExtensions={false}
1073
1072
  onChange={(config) => {
1074
1073
  // Sync workflow settings changes immediately on field blur
1075
1074
  const wf = fd.workflow.current;
@@ -1132,7 +1131,7 @@
1132
1131
  workflowId={fd.workflow.current?.id}
1133
1132
  workflowNodes={fd.workflow.current?.nodes}
1134
1133
  workflowEdges={fd.workflow.current?.edges}
1135
- onChange={async (updatedConfig, uiExtensions) => {
1134
+ onChange={async (updatedConfig) => {
1136
1135
  // Sync config changes to workflow immediately on field blur
1137
1136
  if (selectedNodeId && currentNode) {
1138
1137
  // Build the updated node data
@@ -1141,14 +1140,6 @@
1141
1140
  config: updatedConfig
1142
1141
  };
1143
1142
 
1144
- // Include UI extensions if provided
1145
- if (uiExtensions) {
1146
- updatedData.extensions = {
1147
- ...currentNode.data.extensions,
1148
- ui: uiExtensions
1149
- };
1150
- }
1151
-
1152
1143
  // Update the node in the workflow store
1153
1144
  const nodeUpdates: Record<string, unknown> = {
1154
1145
  data: updatedData