@flowdrop/flowdrop 2.0.0-beta.1 → 2.0.0-beta.11
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.
- package/CHANGELOG.md +210 -0
- package/MIGRATION-2.0.md +173 -3
- package/README.md +5 -5
- package/dist/adapters/WorkflowAdapter.js +4 -5
- package/dist/adapters/agentspec/AgentSpecAdapter.js +3 -3
- package/dist/adapters/agentspec/defaultNodeTypes.js +9 -9
- package/dist/api/enhanced-client.js +6 -11
- package/dist/chat/batchFeedback.js +1 -1
- package/dist/chat/commandClassifier.d.ts +11 -0
- package/dist/chat/commandClassifier.js +20 -0
- package/dist/chat/historyBuilder.d.ts +39 -0
- package/dist/chat/historyBuilder.js +82 -0
- package/dist/chat/index.d.ts +2 -1
- package/dist/chat/index.js +2 -1
- package/dist/chat/responseParser.js +16 -12
- package/dist/commands/executor.js +51 -26
- package/dist/commands/parser.d.ts +12 -0
- package/dist/commands/parser.js +33 -6
- package/dist/commands/storeIntegration.svelte.js +11 -1
- package/dist/commands/types.js +5 -5
- package/dist/components/App.svelte +547 -386
- package/dist/components/App.svelte.d.ts +16 -8
- package/dist/components/Button.stories.svelte +65 -0
- package/dist/components/Button.stories.svelte.d.ts +19 -0
- package/dist/components/Button.svelte +62 -0
- package/dist/components/Button.svelte.d.ts +24 -0
- package/dist/components/CanvasIconButton.svelte +76 -0
- package/dist/components/CanvasIconButton.svelte.d.ts +18 -0
- package/dist/components/ConfigForm.svelte +194 -565
- package/dist/components/ConfigForm.svelte.d.ts +24 -7
- package/dist/components/ConfigModal.svelte +9 -1
- package/dist/components/ConfigPanel.svelte +234 -15
- package/dist/components/ConfigPanel.svelte.d.ts +6 -0
- package/dist/components/EditorStatusBar.stories.svelte +44 -0
- package/dist/components/EditorStatusBar.stories.svelte.d.ts +27 -0
- package/dist/components/EditorStatusBar.svelte +99 -0
- package/dist/components/EditorStatusBar.svelte.d.ts +15 -0
- package/dist/components/IconButton.svelte +80 -0
- package/dist/components/IconButton.svelte.d.ts +30 -0
- package/dist/components/Input.svelte +74 -0
- package/dist/components/Input.svelte.d.ts +17 -0
- package/dist/components/LogoWordmark.svelte +113 -0
- package/dist/components/LogoWordmark.svelte.d.ts +26 -0
- package/dist/components/Navbar.svelte +17 -63
- package/dist/components/Navbar.svelte.d.ts +3 -0
- package/dist/components/NodeSidebar.svelte +21 -126
- package/dist/components/NodeSwapPicker.svelte +12 -30
- package/dist/components/PipelineStatus.svelte +6 -1
- package/dist/components/PipelineStatus.svelte.d.ts +3 -0
- package/dist/components/PortMappingRow.svelte +0 -2
- package/dist/components/SchemaForm.svelte +4 -14
- package/dist/components/Select.svelte +53 -0
- package/dist/components/Select.svelte.d.ts +15 -0
- package/dist/components/SettingsModal.svelte +0 -5
- package/dist/components/SettingsPanel.svelte +33 -6
- package/dist/components/Textarea.svelte +39 -0
- package/dist/components/Textarea.svelte.d.ts +12 -0
- package/dist/components/ThemeToggle.svelte +15 -94
- package/dist/components/UniversalNode.svelte +36 -4
- package/dist/components/UniversalNode.svelte.d.ts +1 -1
- package/dist/components/WorkflowEditor.svelte +71 -54
- package/dist/components/WorkflowEditor.svelte.d.ts +21 -0
- package/dist/components/chat/AIChatPanel.svelte +49 -8
- package/dist/components/chat/CommandPreview.svelte +10 -1
- package/dist/components/console/ConsoleAutocomplete.svelte +1 -1
- package/dist/components/console/ConsoleInput.svelte +3 -3
- package/dist/components/console/ConsoleOutput.svelte +2 -2
- package/dist/components/form/FormArray.svelte +37 -173
- package/dist/components/form/FormAutocomplete.svelte +18 -15
- package/dist/components/form/FormCheckboxGroup.svelte +1 -5
- package/dist/components/form/FormCodeEditor.svelte +9 -7
- package/dist/components/form/FormField.svelte +18 -42
- package/dist/components/form/FormFieldLight.svelte +52 -48
- package/dist/components/form/FormFieldLight.svelte.d.ts +12 -0
- package/dist/components/form/FormFieldset.svelte +45 -11
- package/dist/components/form/FormMarkdownEditor.svelte +8 -5
- package/dist/components/form/FormNumberField.svelte +4 -36
- package/dist/components/form/FormPorts.svelte +280 -0
- package/dist/components/form/FormPorts.svelte.d.ts +13 -0
- package/dist/components/form/FormRangeField.svelte +63 -30
- package/dist/components/form/FormSelect.svelte +13 -75
- package/dist/components/form/FormTemplateEditor.svelte +6 -4
- package/dist/components/form/FormTextField.svelte +3 -35
- package/dist/components/form/FormTextarea.svelte +4 -39
- package/dist/components/form/FormToggle.svelte +27 -6
- package/dist/components/form/FormToggle.svelte.d.ts +5 -0
- package/dist/components/form/FormUISchemaRenderer.svelte +3 -1
- package/dist/components/form/resolveFieldType.d.ts +24 -0
- package/dist/components/form/resolveFieldType.js +55 -0
- package/dist/components/icons/CloseIcon.svelte +6 -0
- package/dist/components/icons/CloseIcon.svelte.d.ts +26 -0
- package/dist/components/icons/CommandLineIcon.svelte +15 -0
- package/dist/components/icons/CommandLineIcon.svelte.d.ts +26 -0
- package/dist/components/icons/MenuIcon.svelte +4 -0
- package/dist/components/icons/MenuIcon.svelte.d.ts +26 -0
- package/dist/components/icons/MenuOpenIcon.svelte +6 -0
- package/dist/components/icons/MenuOpenIcon.svelte.d.ts +26 -0
- package/dist/components/interrupt/ChoicePrompt.svelte +0 -10
- package/dist/components/interrupt/ConfirmationPrompt.svelte +0 -5
- package/dist/components/interrupt/InterruptBubble.svelte +11 -12
- package/dist/components/interrupt/ReviewPrompt.svelte +0 -20
- package/dist/components/interrupt/TextInputPrompt.svelte +0 -6
- package/dist/components/layouts/MainLayout.svelte +4 -5
- package/dist/components/nodes/AtomNode.svelte +62 -76
- package/dist/components/nodes/AtomNode.svelte.d.ts +1 -1
- package/dist/components/nodes/GatewayNode.svelte +117 -164
- package/dist/components/nodes/GatewayNode.svelte.d.ts +1 -1
- package/dist/components/nodes/IdeaNode.svelte +72 -98
- package/dist/components/nodes/IdeaNode.svelte.d.ts +8 -4
- package/dist/components/nodes/NodeConfigButton.svelte +86 -0
- package/dist/components/nodes/NodeConfigButton.svelte.d.ts +15 -0
- package/dist/components/nodes/NotesNode.svelte +76 -85
- package/dist/components/nodes/NotesNode.svelte.d.ts +8 -4
- package/dist/components/nodes/SimpleNode.svelte +59 -133
- package/dist/components/nodes/SimpleNode.svelte.d.ts +4 -4
- package/dist/components/nodes/SquareNode.svelte +110 -164
- package/dist/components/nodes/SquareNode.svelte.d.ts +4 -4
- package/dist/components/nodes/TerminalNode.svelte +62 -124
- package/dist/components/nodes/TerminalNode.svelte.d.ts +4 -4
- package/dist/components/nodes/ToolNode.svelte +92 -103
- package/dist/components/nodes/ToolNode.svelte.d.ts +6 -6
- package/dist/components/nodes/WorkflowNode.svelte +132 -191
- package/dist/components/nodes/WorkflowNode.svelte.d.ts +1 -1
- package/dist/components/playground/ChatInput.svelte +316 -27
- package/dist/components/playground/ChatInput.svelte.d.ts +31 -1
- package/dist/components/playground/ControlPanel.svelte +22 -0
- package/dist/components/playground/ControlPanel.svelte.d.ts +13 -0
- package/dist/components/playground/InputCollector.svelte +11 -48
- package/dist/components/playground/PipelineKanbanView.svelte +6 -4
- package/dist/components/playground/PipelineKanbanView.svelte.d.ts +2 -0
- package/dist/components/playground/PipelinePanel.svelte +20 -3
- package/dist/components/playground/PipelinePanel.svelte.d.ts +2 -0
- package/dist/components/playground/PipelineTableView.svelte +6 -4
- package/dist/components/playground/PipelineTableView.svelte.d.ts +2 -0
- package/dist/components/playground/Playground.svelte +292 -28
- package/dist/components/playground/Playground.svelte.d.ts +3 -0
- package/dist/components/playground/PlaygroundApp.svelte +6 -1
- package/dist/components/playground/PlaygroundApp.svelte.d.ts +3 -0
- package/dist/components/playground/PlaygroundModal.svelte +5 -0
- package/dist/components/playground/PlaygroundModal.svelte.d.ts +3 -0
- package/dist/components/playground/PlaygroundStudio.svelte +7 -6
- package/dist/components/playground/PlaygroundStudio.svelte.d.ts +3 -0
- package/dist/components/playground/pipelineViewUtils.svelte.d.ts +2 -1
- package/dist/components/playground/pipelineViewUtils.svelte.js +2 -2
- package/dist/components/surfaces/SurfaceOverlay.svelte +153 -0
- package/dist/components/surfaces/SurfaceOverlay.svelte.d.ts +14 -0
- package/dist/components/surfaces/TabbedSurface.svelte +133 -0
- package/dist/components/surfaces/TabbedSurface.svelte.d.ts +27 -0
- package/dist/config/endpoints.d.ts +71 -1
- package/dist/config/endpoints.js +46 -5
- package/dist/core/index.d.ts +2 -3
- package/dist/core/index.js +2 -6
- package/dist/display/index.d.ts +6 -1
- package/dist/display/index.js +9 -1
- package/dist/editor/index.d.ts +1 -1
- package/dist/editor/index.js +1 -1
- package/dist/form/full.d.ts +2 -1
- package/dist/form/full.js +4 -1
- package/dist/form/index.d.ts +0 -1
- package/dist/form/index.js +3 -2
- package/dist/helpers/workflowEditorHelper.d.ts +4 -2
- package/dist/helpers/workflowEditorHelper.js +8 -8
- package/dist/messages/defaults.d.ts +98 -0
- package/dist/messages/defaults.js +58 -1
- package/dist/messages/index.d.ts +1 -1
- package/dist/messages/index.js +1 -1
- package/dist/openapi/v1/openapi.yaml +35 -23
- package/dist/playground/commands/args.d.ts +32 -0
- package/dist/playground/commands/args.js +50 -0
- package/dist/playground/commands/dispatch.d.ts +143 -0
- package/dist/playground/commands/dispatch.js +162 -0
- package/dist/playground/commands/index.d.ts +14 -0
- package/dist/playground/commands/index.js +10 -0
- package/dist/playground/commands/parser.d.ts +38 -0
- package/dist/playground/commands/parser.js +163 -0
- package/dist/playground/commands/registry.d.ts +42 -0
- package/dist/playground/commands/registry.js +122 -0
- package/dist/playground/commands/suggest.d.ts +37 -0
- package/dist/playground/commands/suggest.js +46 -0
- package/dist/playground/commands/types.d.ts +111 -0
- package/dist/playground/commands/types.js +15 -0
- package/dist/playground/index.d.ts +21 -2
- package/dist/playground/index.js +27 -2
- package/dist/playground/mount.d.ts +19 -5
- package/dist/playground/mount.js +16 -8
- package/dist/playground/runAction.d.ts +48 -0
- package/dist/playground/runAction.js +31 -0
- package/dist/registry/builtinNodeTypes.d.ts +53 -0
- package/dist/registry/builtinNodeTypes.js +67 -0
- package/dist/registry/builtinNodes.d.ts +2 -39
- package/dist/registry/builtinNodes.js +6 -53
- package/dist/registry/nodeComponentRegistry.d.ts +2 -1
- package/dist/schemas/v1/workflow.schema.json +16 -14
- package/dist/services/agentSpecExecutionService.d.ts +0 -2
- package/dist/services/agentSpecExecutionService.js +0 -2
- package/dist/services/apiVariableService.js +12 -26
- package/dist/services/categoriesApi.js +3 -6
- package/dist/services/chatService.d.ts +4 -3
- package/dist/services/chatService.js +13 -18
- package/dist/services/dynamicSchemaService.d.ts +31 -4
- package/dist/services/dynamicSchemaService.js +62 -33
- package/dist/services/historyService.d.ts +30 -8
- package/dist/services/historyService.js +51 -15
- package/dist/services/interruptService.d.ts +7 -6
- package/dist/services/interruptService.js +19 -21
- package/dist/services/pipelineSignalService.d.ts +97 -0
- package/dist/services/pipelineSignalService.js +94 -0
- package/dist/services/playgroundService.d.ts +21 -8
- package/dist/services/playgroundService.js +45 -25
- package/dist/services/portConfigApi.js +3 -6
- package/dist/services/settingsService.d.ts +9 -4
- package/dist/services/settingsService.js +23 -12
- package/dist/services/workflowLaunchService.d.ts +74 -0
- package/dist/services/workflowLaunchService.js +74 -0
- package/dist/skins/drafter.d.ts +30 -0
- package/dist/skins/drafter.js +198 -0
- package/dist/skins/index.d.ts +2 -1
- package/dist/skins/index.js +4 -2
- package/dist/stores/apiContext.d.ts +11 -0
- package/dist/stores/apiContext.js +15 -0
- package/dist/stores/categoriesStore.svelte.js +0 -1
- package/dist/stores/historyStore.svelte.d.ts +17 -3
- package/dist/stores/historyStore.svelte.js +30 -3
- package/dist/stores/instanceContainer.svelte.js +5 -0
- package/dist/stores/playgroundStore.svelte.js +1 -3
- package/dist/stores/settingsStore.svelte.d.ts +13 -0
- package/dist/stores/settingsStore.svelte.js +32 -0
- package/dist/stores/workflowStore.svelte.d.ts +42 -5
- package/dist/stores/workflowStore.svelte.js +109 -32
- package/dist/styles/base.css +285 -14
- package/dist/styles/tokens.css +60 -2
- package/dist/svelte-app.d.ts +18 -1
- package/dist/svelte-app.js +75 -110
- package/dist/themes/drafter.d.ts +2 -0
- package/dist/themes/drafter.js +15 -0
- package/dist/themes/index.d.ts +2 -1
- package/dist/themes/index.js +8 -2
- package/dist/types/auth.d.ts +9 -51
- package/dist/types/auth.js +4 -54
- package/dist/types/chat.d.ts +5 -1
- package/dist/types/events.d.ts +18 -0
- package/dist/types/events.js +2 -1
- package/dist/types/index.d.ts +84 -29
- package/dist/types/index.js +0 -1
- package/dist/types/settings.d.ts +28 -1
- package/dist/types/settings.js +6 -3
- package/dist/types/skin.d.ts +1 -1
- package/dist/types/theme.d.ts +16 -2
- package/dist/types/uischema.d.ts +5 -0
- package/dist/utils/canvasSelection.d.ts +25 -0
- package/dist/utils/canvasSelection.js +37 -0
- package/dist/utils/colors.d.ts +27 -0
- package/dist/utils/colors.js +23 -0
- package/dist/utils/connections.js +20 -56
- package/dist/utils/edgeStyling.js +9 -5
- package/dist/utils/fetchWithAuth.d.ts +36 -15
- package/dist/utils/fetchWithAuth.js +53 -23
- package/dist/utils/nodeFormSchema.d.ts +51 -0
- package/dist/utils/nodeFormSchema.js +87 -0
- package/dist/utils/nodeIds.d.ts +1 -1
- package/dist/utils/nodeIds.js +1 -1
- package/dist/utils/nodeSwap.js +3 -6
- package/dist/utils/nodeTypes.js +1 -1
- package/dist/utils/portUtils.d.ts +47 -11
- package/dist/utils/portUtils.js +67 -14
- package/dist/utils/portal.d.ts +18 -0
- package/dist/utils/portal.js +34 -0
- package/dist/utils/schemaMerge.d.ts +25 -0
- package/dist/utils/schemaMerge.js +61 -0
- package/package.json +2 -1
|
@@ -45,6 +45,7 @@
|
|
|
45
45
|
*/
|
|
46
46
|
import type { Workflow } from '../types/index.js';
|
|
47
47
|
import type { EndpointConfig } from '../config/endpoints.js';
|
|
48
|
+
import type { AuthProvider } from '../types/auth.js';
|
|
48
49
|
import type { PlaygroundMode, PlaygroundConfig, PlaygroundSession, PlaygroundMessagesApiResponse, PlaygroundSessionStatus } from '../types/playground.js';
|
|
49
50
|
import type { PartialSettings, SettingsCategory } from '../types/settings.js';
|
|
50
51
|
import type { NavbarAction } from '../types/navbar.js';
|
|
@@ -81,6 +82,15 @@ export interface PlaygroundMountOptions {
|
|
|
81
82
|
* Use createEndpointConfig() to create this
|
|
82
83
|
*/
|
|
83
84
|
endpointConfig?: EndpointConfig;
|
|
85
|
+
/**
|
|
86
|
+
* Authentication provider for API requests.
|
|
87
|
+
*
|
|
88
|
+
* Applied to this instance via `fd.api.configure()` so every request the
|
|
89
|
+
* playground makes (sessions, messages, polling, interrupts) carries the
|
|
90
|
+
* provider's headers — e.g. an `Authorization` bearer token or an
|
|
91
|
+
* `X-CSRF-Token`. Omit for unauthenticated backends.
|
|
92
|
+
*/
|
|
93
|
+
authProvider?: AuthProvider;
|
|
84
94
|
/**
|
|
85
95
|
* Playground-specific configuration options
|
|
86
96
|
*/
|
|
@@ -242,7 +252,7 @@ export interface PlaygroundAppMountOptions extends Omit<PlaygroundStudioMountOpt
|
|
|
242
252
|
* @default "standalone"
|
|
243
253
|
*/
|
|
244
254
|
mode?: 'standalone' | 'embedded';
|
|
245
|
-
/** Render the FlowDrop Navbar above the playground (default:
|
|
255
|
+
/** Render the FlowDrop Navbar above the playground (default: false). */
|
|
246
256
|
showNavbar?: boolean;
|
|
247
257
|
/** Title shown in the navbar. Falls back to the workflow name, then "Playground". */
|
|
248
258
|
navbarTitle?: string;
|
|
@@ -258,17 +268,21 @@ export interface PlaygroundAppMountOptions extends Omit<PlaygroundStudioMountOpt
|
|
|
258
268
|
showSettingsResetButton?: boolean;
|
|
259
269
|
}
|
|
260
270
|
/**
|
|
261
|
-
* Mount the full-page PlaygroundApp (
|
|
271
|
+
* Mount the full-page PlaygroundApp (PlaygroundStudio, optionally wrapped in the
|
|
272
|
+
* FlowDrop Navbar) into a container.
|
|
262
273
|
*
|
|
263
|
-
*
|
|
264
|
-
*
|
|
265
|
-
*
|
|
274
|
+
* The navbar is opt-in (`showNavbar: true`) — matching the editor mount, so
|
|
275
|
+
* embedding into a page that already has its own header never double-stacks a
|
|
276
|
+
* header. Pass `showNavbar: true` when FlowDrop owns the whole page and you want
|
|
277
|
+
* its chrome (logo, branding, settings modal). For a leaner embeddable
|
|
278
|
+
* split-pane, mountPlaygroundStudio() omits the navbar wrapper entirely.
|
|
266
279
|
*
|
|
267
280
|
* @example
|
|
268
281
|
* ```typescript
|
|
269
282
|
* const app = await mountPlaygroundApp(container, {
|
|
270
283
|
* workflowId: 'wf-123',
|
|
271
284
|
* endpointConfig: createEndpointConfig('/api/flowdrop'),
|
|
285
|
+
* showNavbar: true,
|
|
272
286
|
* navbarTitle: 'My Workflow',
|
|
273
287
|
* primaryActions: [
|
|
274
288
|
* { label: 'Edit', href: '/workflows/wf-123/edit', icon: 'mdi:pencil-outline', variant: 'secondary' },
|
package/dist/playground/mount.js
CHANGED
|
@@ -125,7 +125,7 @@ function buildMountedPlayground(svelteApp, workflowId, config, fd, ownsInstance,
|
|
|
125
125
|
startPolling: () => {
|
|
126
126
|
const session = fd.playground.currentSession;
|
|
127
127
|
if (session) {
|
|
128
|
-
playgroundService.startPolling(fd.api.config, session.id, (response) => fd.playground.applyServerResponse(response, session.id), pollingInterval, config.shouldStopPolling, playgroundService.getLastSequenceNumber());
|
|
128
|
+
playgroundService.startPolling(fd.api.config, session.id, (response) => fd.playground.applyServerResponse(response, session.id), pollingInterval, config.shouldStopPolling, playgroundService.getLastSequenceNumber(), fd.api.authProvider);
|
|
129
129
|
}
|
|
130
130
|
},
|
|
131
131
|
pushMessages: (response) => fd.playground.applyServerResponse(response, null),
|
|
@@ -165,7 +165,7 @@ function buildMountedPlayground(svelteApp, workflowId, config, fd, ownsInstance,
|
|
|
165
165
|
* ```
|
|
166
166
|
*/
|
|
167
167
|
export async function mountPlayground(container, options) {
|
|
168
|
-
const { workflowId, workflow, mode = 'standalone', initialSessionId, endpointConfig, config = {}, height, width, settings: initialSettings, onClose, onSessionStatusChange, instanceId } = options;
|
|
168
|
+
const { workflowId, workflow, mode = 'standalone', initialSessionId, endpointConfig, authProvider, config = {}, height, width, settings: initialSettings, onClose, onSessionStatusChange, instanceId } = options;
|
|
169
169
|
// Validate required parameters
|
|
170
170
|
if (!workflowId) {
|
|
171
171
|
throw new Error('workflowId is required for mountPlayground()');
|
|
@@ -200,6 +200,7 @@ export async function mountPlayground(container, options) {
|
|
|
200
200
|
workflow,
|
|
201
201
|
initialSessionId,
|
|
202
202
|
endpointConfig: finalEndpointConfig,
|
|
203
|
+
authProvider,
|
|
203
204
|
config,
|
|
204
205
|
onClose: () => {
|
|
205
206
|
if (onClose) {
|
|
@@ -219,6 +220,7 @@ export async function mountPlayground(container, options) {
|
|
|
219
220
|
mode,
|
|
220
221
|
initialSessionId,
|
|
221
222
|
endpointConfig: finalEndpointConfig,
|
|
223
|
+
authProvider,
|
|
222
224
|
config,
|
|
223
225
|
onClose
|
|
224
226
|
}
|
|
@@ -247,7 +249,7 @@ export function unmountPlayground(app) {
|
|
|
247
249
|
}
|
|
248
250
|
}
|
|
249
251
|
export async function mountPlaygroundStudio(container, options) {
|
|
250
|
-
const { workflowId, workflow, mode = 'standalone', initialSessionId, endpointConfig, config = {}, height, width, initialPipelineOpen, minChatWidth, initialPipelineWidth, settings: initialSettings, onClose, onSessionNavigate, onSessionStatusChange, pipelineViews, instanceId } = options;
|
|
252
|
+
const { workflowId, workflow, mode = 'standalone', initialSessionId, endpointConfig, authProvider, config = {}, height, width, initialPipelineOpen, minChatWidth, initialPipelineWidth, settings: initialSettings, onClose, onSessionNavigate, onSessionStatusChange, pipelineViews, instanceId } = options;
|
|
251
253
|
if (!workflowId) {
|
|
252
254
|
throw new Error('workflowId is required for mountPlaygroundStudio()');
|
|
253
255
|
}
|
|
@@ -272,6 +274,7 @@ export async function mountPlaygroundStudio(container, options) {
|
|
|
272
274
|
mode,
|
|
273
275
|
initialSessionId,
|
|
274
276
|
endpointConfig: finalEndpointConfig,
|
|
277
|
+
authProvider,
|
|
275
278
|
config,
|
|
276
279
|
onClose,
|
|
277
280
|
onSessionNavigate,
|
|
@@ -284,17 +287,21 @@ export async function mountPlaygroundStudio(container, options) {
|
|
|
284
287
|
return buildMountedPlayground(svelteApp, workflowId, config, fd, ownsInstance, onSessionStatusChange);
|
|
285
288
|
}
|
|
286
289
|
/**
|
|
287
|
-
* Mount the full-page PlaygroundApp (
|
|
290
|
+
* Mount the full-page PlaygroundApp (PlaygroundStudio, optionally wrapped in the
|
|
291
|
+
* FlowDrop Navbar) into a container.
|
|
288
292
|
*
|
|
289
|
-
*
|
|
290
|
-
*
|
|
291
|
-
*
|
|
293
|
+
* The navbar is opt-in (`showNavbar: true`) — matching the editor mount, so
|
|
294
|
+
* embedding into a page that already has its own header never double-stacks a
|
|
295
|
+
* header. Pass `showNavbar: true` when FlowDrop owns the whole page and you want
|
|
296
|
+
* its chrome (logo, branding, settings modal). For a leaner embeddable
|
|
297
|
+
* split-pane, mountPlaygroundStudio() omits the navbar wrapper entirely.
|
|
292
298
|
*
|
|
293
299
|
* @example
|
|
294
300
|
* ```typescript
|
|
295
301
|
* const app = await mountPlaygroundApp(container, {
|
|
296
302
|
* workflowId: 'wf-123',
|
|
297
303
|
* endpointConfig: createEndpointConfig('/api/flowdrop'),
|
|
304
|
+
* showNavbar: true,
|
|
298
305
|
* navbarTitle: 'My Workflow',
|
|
299
306
|
* primaryActions: [
|
|
300
307
|
* { label: 'Edit', href: '/workflows/wf-123/edit', icon: 'mdi:pencil-outline', variant: 'secondary' },
|
|
@@ -304,7 +311,7 @@ export async function mountPlaygroundStudio(container, options) {
|
|
|
304
311
|
* ```
|
|
305
312
|
*/
|
|
306
313
|
export async function mountPlaygroundApp(container, options) {
|
|
307
|
-
const { workflowId, workflow, mode = 'standalone', initialSessionId, endpointConfig, config = {}, height, width, showNavbar =
|
|
314
|
+
const { workflowId, workflow, mode = 'standalone', initialSessionId, endpointConfig, authProvider, config = {}, height, width, showNavbar = false, navbarTitle, primaryActions, showSettings = true, settingsCategories, showSettingsSyncButton, showSettingsResetButton, initialPipelineOpen, minChatWidth, initialPipelineWidth, settings: initialSettings, onClose, onSessionNavigate, onSessionStatusChange, instanceId } = options;
|
|
308
315
|
if (!workflowId) {
|
|
309
316
|
throw new Error('workflowId is required for mountPlaygroundApp()');
|
|
310
317
|
}
|
|
@@ -332,6 +339,7 @@ export async function mountPlaygroundApp(container, options) {
|
|
|
332
339
|
mode,
|
|
333
340
|
initialSessionId,
|
|
334
341
|
endpointConfig: finalEndpointConfig,
|
|
342
|
+
authProvider,
|
|
335
343
|
config,
|
|
336
344
|
showNavbar,
|
|
337
345
|
navbarTitle,
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Run Action Resolution
|
|
3
|
+
*
|
|
4
|
+
* Decides what pressing Run should actually do.
|
|
5
|
+
*
|
|
6
|
+
* Starting a run by posting a chat message fabricates a user turn: the text
|
|
7
|
+
* enters the conversation, is fed to the chat input as though typed, and is
|
|
8
|
+
* replayed as history on the following turn — indistinguishable downstream from
|
|
9
|
+
* something a person wrote. Launching avoids all of that.
|
|
10
|
+
*
|
|
11
|
+
* But a message is still the correct action twice over:
|
|
12
|
+
*
|
|
13
|
+
* 1. **The host asked for one.** An explicitly configured `predefinedMessage`
|
|
14
|
+
* is a deliberate choice to open the run with a specific turn, and honouring
|
|
15
|
+
* it keeps that configuration meaningful.
|
|
16
|
+
* 2. **Nothing else is possible.** Against a backend with no launch verb, a
|
|
17
|
+
* message is the only way to start a run at all, so the fabricated turn is
|
|
18
|
+
* the lesser evil.
|
|
19
|
+
*
|
|
20
|
+
* Both callers — the Run button and auto-run — route through here so the rule
|
|
21
|
+
* is stated once instead of drifting between them.
|
|
22
|
+
*
|
|
23
|
+
* @module playground/runAction
|
|
24
|
+
*/
|
|
25
|
+
/** What Run should do in the current configuration. */
|
|
26
|
+
export type RunAction =
|
|
27
|
+
/** Start a run with no inputs and no chat message. */
|
|
28
|
+
{
|
|
29
|
+
kind: 'launch';
|
|
30
|
+
}
|
|
31
|
+
/** Post this message, which starts a run as a side effect. */
|
|
32
|
+
| {
|
|
33
|
+
kind: 'message';
|
|
34
|
+
content: string;
|
|
35
|
+
};
|
|
36
|
+
export interface ResolveRunActionOptions {
|
|
37
|
+
/** Whether launching is possible — a handler is wired and the backend supports it. */
|
|
38
|
+
canLaunch: boolean;
|
|
39
|
+
/**
|
|
40
|
+
* Host-configured opening message. Its *presence* is the signal, so an
|
|
41
|
+
* explicit empty string still counts as "the host wants a message".
|
|
42
|
+
*/
|
|
43
|
+
predefinedMessage?: string;
|
|
44
|
+
/** Message used when falling back without a configured one. */
|
|
45
|
+
defaultMessage: string;
|
|
46
|
+
}
|
|
47
|
+
/** Resolve what Run should do. Pure; see the module docblock for the rules. */
|
|
48
|
+
export declare function resolveRunAction({ canLaunch, predefinedMessage, defaultMessage }: ResolveRunActionOptions): RunAction;
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Run Action Resolution
|
|
3
|
+
*
|
|
4
|
+
* Decides what pressing Run should actually do.
|
|
5
|
+
*
|
|
6
|
+
* Starting a run by posting a chat message fabricates a user turn: the text
|
|
7
|
+
* enters the conversation, is fed to the chat input as though typed, and is
|
|
8
|
+
* replayed as history on the following turn — indistinguishable downstream from
|
|
9
|
+
* something a person wrote. Launching avoids all of that.
|
|
10
|
+
*
|
|
11
|
+
* But a message is still the correct action twice over:
|
|
12
|
+
*
|
|
13
|
+
* 1. **The host asked for one.** An explicitly configured `predefinedMessage`
|
|
14
|
+
* is a deliberate choice to open the run with a specific turn, and honouring
|
|
15
|
+
* it keeps that configuration meaningful.
|
|
16
|
+
* 2. **Nothing else is possible.** Against a backend with no launch verb, a
|
|
17
|
+
* message is the only way to start a run at all, so the fabricated turn is
|
|
18
|
+
* the lesser evil.
|
|
19
|
+
*
|
|
20
|
+
* Both callers — the Run button and auto-run — route through here so the rule
|
|
21
|
+
* is stated once instead of drifting between them.
|
|
22
|
+
*
|
|
23
|
+
* @module playground/runAction
|
|
24
|
+
*/
|
|
25
|
+
/** Resolve what Run should do. Pure; see the module docblock for the rules. */
|
|
26
|
+
export function resolveRunAction({ canLaunch, predefinedMessage, defaultMessage }) {
|
|
27
|
+
if (canLaunch && predefinedMessage === undefined) {
|
|
28
|
+
return { kind: 'launch' };
|
|
29
|
+
}
|
|
30
|
+
return { kind: 'message', content: predefinedMessage ?? defaultMessage };
|
|
31
|
+
}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Built-in Node Type Metadata (pure — no component imports)
|
|
3
|
+
*
|
|
4
|
+
* The type identifiers, aliases, and resolution helpers for FlowDrop's built-in
|
|
5
|
+
* node types, with ZERO dependency on the Svelte node components. Utilities that
|
|
6
|
+
* only need to reason about type strings (e.g. `utils/nodeTypes.ts`, reachable
|
|
7
|
+
* from `@flowdrop/flowdrop/core`) import from here, so the lightweight `core`
|
|
8
|
+
* entry never statically pulls in node components, marked, or DOMPurify.
|
|
9
|
+
*
|
|
10
|
+
* The component registrations themselves live in `./builtinNodes.ts`, which
|
|
11
|
+
* re-exports everything here for backward compatibility.
|
|
12
|
+
*
|
|
13
|
+
* @module registry/builtinNodeTypes
|
|
14
|
+
*/
|
|
15
|
+
/**
|
|
16
|
+
* Source identifier for built-in FlowDrop components.
|
|
17
|
+
*/
|
|
18
|
+
export declare const FLOWDROP_SOURCE = "flowdrop";
|
|
19
|
+
/**
|
|
20
|
+
* Type for built-in node types.
|
|
21
|
+
* Use this when you specifically need a built-in type.
|
|
22
|
+
*/
|
|
23
|
+
export type BuiltinNodeType = 'workflowNode' | 'simple' | 'square' | 'atom' | 'tool' | 'gateway' | 'note' | 'terminal' | 'idea';
|
|
24
|
+
/**
|
|
25
|
+
* Array of built-in type strings for runtime validation.
|
|
26
|
+
*/
|
|
27
|
+
export declare const BUILTIN_NODE_TYPES: BuiltinNodeType[];
|
|
28
|
+
/**
|
|
29
|
+
* Alias mapping for type resolution.
|
|
30
|
+
* Maps alternative type names to their canonical registration.
|
|
31
|
+
*/
|
|
32
|
+
export declare const BUILTIN_TYPE_ALIASES: Record<string, string>;
|
|
33
|
+
/**
|
|
34
|
+
* Get the canonical type for a given type string.
|
|
35
|
+
* Handles aliases like "default" -> "workflowNode".
|
|
36
|
+
*
|
|
37
|
+
* @param type - The type string to resolve
|
|
38
|
+
* @returns The canonical type string
|
|
39
|
+
*/
|
|
40
|
+
export declare function resolveBuiltinAlias(type: string): string;
|
|
41
|
+
/**
|
|
42
|
+
* Check if a type is a built-in FlowDrop type.
|
|
43
|
+
*
|
|
44
|
+
* @param type - The type to check
|
|
45
|
+
* @returns true if this is a built-in type
|
|
46
|
+
*/
|
|
47
|
+
export declare function isBuiltinType(type: string): boolean;
|
|
48
|
+
/**
|
|
49
|
+
* Get all built-in type identifiers.
|
|
50
|
+
*
|
|
51
|
+
* @returns Array of built-in type strings
|
|
52
|
+
*/
|
|
53
|
+
export declare function getBuiltinTypes(): string[];
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Built-in Node Type Metadata (pure — no component imports)
|
|
3
|
+
*
|
|
4
|
+
* The type identifiers, aliases, and resolution helpers for FlowDrop's built-in
|
|
5
|
+
* node types, with ZERO dependency on the Svelte node components. Utilities that
|
|
6
|
+
* only need to reason about type strings (e.g. `utils/nodeTypes.ts`, reachable
|
|
7
|
+
* from `@flowdrop/flowdrop/core`) import from here, so the lightweight `core`
|
|
8
|
+
* entry never statically pulls in node components, marked, or DOMPurify.
|
|
9
|
+
*
|
|
10
|
+
* The component registrations themselves live in `./builtinNodes.ts`, which
|
|
11
|
+
* re-exports everything here for backward compatibility.
|
|
12
|
+
*
|
|
13
|
+
* @module registry/builtinNodeTypes
|
|
14
|
+
*/
|
|
15
|
+
/**
|
|
16
|
+
* Source identifier for built-in FlowDrop components.
|
|
17
|
+
*/
|
|
18
|
+
export const FLOWDROP_SOURCE = 'flowdrop';
|
|
19
|
+
/**
|
|
20
|
+
* Array of built-in type strings for runtime validation.
|
|
21
|
+
*/
|
|
22
|
+
export const BUILTIN_NODE_TYPES = [
|
|
23
|
+
'workflowNode',
|
|
24
|
+
'simple',
|
|
25
|
+
'square',
|
|
26
|
+
'atom',
|
|
27
|
+
'tool',
|
|
28
|
+
'gateway',
|
|
29
|
+
'note',
|
|
30
|
+
'terminal',
|
|
31
|
+
'idea'
|
|
32
|
+
];
|
|
33
|
+
/**
|
|
34
|
+
* Alias mapping for type resolution.
|
|
35
|
+
* Maps alternative type names to their canonical registration.
|
|
36
|
+
*/
|
|
37
|
+
export const BUILTIN_TYPE_ALIASES = {
|
|
38
|
+
default: 'workflowNode'
|
|
39
|
+
};
|
|
40
|
+
/**
|
|
41
|
+
* Get the canonical type for a given type string.
|
|
42
|
+
* Handles aliases like "default" -> "workflowNode".
|
|
43
|
+
*
|
|
44
|
+
* @param type - The type string to resolve
|
|
45
|
+
* @returns The canonical type string
|
|
46
|
+
*/
|
|
47
|
+
export function resolveBuiltinAlias(type) {
|
|
48
|
+
return BUILTIN_TYPE_ALIASES[type] ?? type;
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Check if a type is a built-in FlowDrop type.
|
|
52
|
+
*
|
|
53
|
+
* @param type - The type to check
|
|
54
|
+
* @returns true if this is a built-in type
|
|
55
|
+
*/
|
|
56
|
+
export function isBuiltinType(type) {
|
|
57
|
+
const canonicalType = resolveBuiltinAlias(type);
|
|
58
|
+
return BUILTIN_NODE_TYPES.includes(canonicalType);
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* Get all built-in type identifiers.
|
|
62
|
+
*
|
|
63
|
+
* @returns Array of built-in type strings
|
|
64
|
+
*/
|
|
65
|
+
export function getBuiltinTypes() {
|
|
66
|
+
return [...BUILTIN_NODE_TYPES];
|
|
67
|
+
}
|
|
@@ -6,47 +6,10 @@
|
|
|
6
6
|
* ensuring all built-in node types are available without user action.
|
|
7
7
|
*/
|
|
8
8
|
import { type NodeComponentRegistration } from './nodeComponentRegistry.js';
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
*/
|
|
12
|
-
export declare const FLOWDROP_SOURCE = "flowdrop";
|
|
9
|
+
export { FLOWDROP_SOURCE, BUILTIN_TYPE_ALIASES, BUILTIN_NODE_TYPES, resolveBuiltinAlias, isBuiltinType, getBuiltinTypes } from './builtinNodeTypes.js';
|
|
10
|
+
export type { BuiltinNodeType } from './builtinNodeTypes.js';
|
|
13
11
|
/**
|
|
14
12
|
* Built-in FlowDrop node component registrations.
|
|
15
13
|
* These are the default node types that ship with FlowDrop.
|
|
16
14
|
*/
|
|
17
15
|
export declare const BUILTIN_NODE_COMPONENTS: NodeComponentRegistration[];
|
|
18
|
-
/**
|
|
19
|
-
* Alias mapping for type resolution.
|
|
20
|
-
* Maps alternative type names to their canonical registration.
|
|
21
|
-
*/
|
|
22
|
-
export declare const BUILTIN_TYPE_ALIASES: Record<string, string>;
|
|
23
|
-
/**
|
|
24
|
-
* Get the canonical type for a given type string.
|
|
25
|
-
* Handles aliases like "default" -> "workflowNode".
|
|
26
|
-
*
|
|
27
|
-
* @param type - The type string to resolve
|
|
28
|
-
* @returns The canonical type string
|
|
29
|
-
*/
|
|
30
|
-
export declare function resolveBuiltinAlias(type: string): string;
|
|
31
|
-
/**
|
|
32
|
-
* Check if a type is a built-in FlowDrop type.
|
|
33
|
-
*
|
|
34
|
-
* @param type - The type to check
|
|
35
|
-
* @returns true if this is a built-in type
|
|
36
|
-
*/
|
|
37
|
-
export declare function isBuiltinType(type: string): boolean;
|
|
38
|
-
/**
|
|
39
|
-
* Get all built-in type identifiers.
|
|
40
|
-
*
|
|
41
|
-
* @returns Array of built-in type strings
|
|
42
|
-
*/
|
|
43
|
-
export declare function getBuiltinTypes(): string[];
|
|
44
|
-
/**
|
|
45
|
-
* Type for built-in node types.
|
|
46
|
-
* Use this when you specifically need a built-in type.
|
|
47
|
-
*/
|
|
48
|
-
export type BuiltinNodeType = 'workflowNode' | 'simple' | 'square' | 'atom' | 'tool' | 'gateway' | 'note' | 'terminal' | 'idea';
|
|
49
|
-
/**
|
|
50
|
-
* Array of built-in type strings for runtime validation.
|
|
51
|
-
*/
|
|
52
|
-
export declare const BUILTIN_NODE_TYPES: BuiltinNodeType[];
|
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
* ensuring all built-in node types are available without user action.
|
|
7
7
|
*/
|
|
8
8
|
import {} from './nodeComponentRegistry.js';
|
|
9
|
+
import { FLOWDROP_SOURCE } from './builtinNodeTypes.js';
|
|
9
10
|
import WorkflowNode from '../components/nodes/WorkflowNode.svelte';
|
|
10
11
|
import SimpleNode from '../components/nodes/SimpleNode.svelte';
|
|
11
12
|
import SquareNode from '../components/nodes/SquareNode.svelte';
|
|
@@ -15,10 +16,11 @@ import GatewayNode from '../components/nodes/GatewayNode.svelte';
|
|
|
15
16
|
import NotesNode from '../components/nodes/NotesNode.svelte';
|
|
16
17
|
import TerminalNode from '../components/nodes/TerminalNode.svelte';
|
|
17
18
|
import IdeaNode from '../components/nodes/IdeaNode.svelte';
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
19
|
+
// Pure type metadata + resolution helpers are re-exported for backward
|
|
20
|
+
// compatibility — they now live in a component-free module so that
|
|
21
|
+
// type-only consumers (e.g. utils/nodeTypes.ts, reachable from `core`) do
|
|
22
|
+
// not statically pull in the node components below.
|
|
23
|
+
export { FLOWDROP_SOURCE, BUILTIN_TYPE_ALIASES, BUILTIN_NODE_TYPES, resolveBuiltinAlias, isBuiltinType, getBuiltinTypes } from './builtinNodeTypes.js';
|
|
22
24
|
/**
|
|
23
25
|
* Built-in FlowDrop node component registrations.
|
|
24
26
|
* These are the default node types that ship with FlowDrop.
|
|
@@ -124,52 +126,3 @@ export const BUILTIN_NODE_COMPONENTS = [
|
|
|
124
126
|
statusSize: 'sm'
|
|
125
127
|
}
|
|
126
128
|
];
|
|
127
|
-
/**
|
|
128
|
-
* Alias mapping for type resolution.
|
|
129
|
-
* Maps alternative type names to their canonical registration.
|
|
130
|
-
*/
|
|
131
|
-
export const BUILTIN_TYPE_ALIASES = {
|
|
132
|
-
default: 'workflowNode'
|
|
133
|
-
};
|
|
134
|
-
/**
|
|
135
|
-
* Get the canonical type for a given type string.
|
|
136
|
-
* Handles aliases like "default" -> "workflowNode".
|
|
137
|
-
*
|
|
138
|
-
* @param type - The type string to resolve
|
|
139
|
-
* @returns The canonical type string
|
|
140
|
-
*/
|
|
141
|
-
export function resolveBuiltinAlias(type) {
|
|
142
|
-
return BUILTIN_TYPE_ALIASES[type] ?? type;
|
|
143
|
-
}
|
|
144
|
-
/**
|
|
145
|
-
* Check if a type is a built-in FlowDrop type.
|
|
146
|
-
*
|
|
147
|
-
* @param type - The type to check
|
|
148
|
-
* @returns true if this is a built-in type
|
|
149
|
-
*/
|
|
150
|
-
export function isBuiltinType(type) {
|
|
151
|
-
const canonicalType = resolveBuiltinAlias(type);
|
|
152
|
-
return BUILTIN_NODE_COMPONENTS.some((reg) => reg.type === canonicalType);
|
|
153
|
-
}
|
|
154
|
-
/**
|
|
155
|
-
* Get all built-in type identifiers.
|
|
156
|
-
*
|
|
157
|
-
* @returns Array of built-in type strings
|
|
158
|
-
*/
|
|
159
|
-
export function getBuiltinTypes() {
|
|
160
|
-
return BUILTIN_NODE_COMPONENTS.map((reg) => reg.type);
|
|
161
|
-
}
|
|
162
|
-
/**
|
|
163
|
-
* Array of built-in type strings for runtime validation.
|
|
164
|
-
*/
|
|
165
|
-
export const BUILTIN_NODE_TYPES = [
|
|
166
|
-
'workflowNode',
|
|
167
|
-
'simple',
|
|
168
|
-
'square',
|
|
169
|
-
'atom',
|
|
170
|
-
'tool',
|
|
171
|
-
'gateway',
|
|
172
|
-
'note',
|
|
173
|
-
'terminal',
|
|
174
|
-
'idea'
|
|
175
|
-
];
|
|
@@ -16,9 +16,10 @@ import { BaseRegistry } from './BaseRegistry.svelte.js';
|
|
|
16
16
|
* Any component registered in the registry must be compatible with these props.
|
|
17
17
|
*/
|
|
18
18
|
export interface NodeComponentProps {
|
|
19
|
+
/** The SvelteFlow node id */
|
|
20
|
+
id: string;
|
|
19
21
|
/** Node data containing label, config, metadata, executionInfo */
|
|
20
22
|
data: WorkflowNode['data'] & {
|
|
21
|
-
nodeId?: string;
|
|
22
23
|
onConfigOpen?: (node: {
|
|
23
24
|
id: string;
|
|
24
25
|
type: string;
|
|
@@ -560,9 +560,9 @@
|
|
|
560
560
|
},
|
|
561
561
|
"NodeMetadata": {
|
|
562
562
|
"type": "object",
|
|
563
|
-
"description": "Complete metadata for a node type including ports, configuration schema, and extensions.\n\n## Dynamic Port Support\n\nNodes can support user-defined dynamic ports through their configSchema:\n- Add `dynamicInputs` array property to allow custom input handles\n- Add `dynamicOutputs` array property to allow custom output handles\n- Add `branches` array property for gateway nodes with conditional paths\n\n## Extensions Support\n\nThe `extensions` property allows storing UI settings and 3rd party data:\n- Use `extensions.ui.
|
|
563
|
+
"description": "Complete metadata for a node type including ports, configuration schema, and extensions.\n\n## Dynamic Port Support\n\nNodes can support user-defined dynamic ports through their configSchema:\n- Add `dynamicInputs` array property to allow custom input handles\n- Add `dynamicOutputs` array property to allow custom output handles\n- Add `branches` array property for gateway nodes with conditional paths\n\n## Extensions Support\n\nThe `extensions` property allows storing UI settings and 3rd party data:\n- Use `extensions.ui.style` for custom per-node styling\n- Use namespaced keys for custom integrations (e.g., \"myapp:settings\")\n(Port order + exposure live in `config.ports`, not here.)\n",
|
|
564
564
|
"properties": {
|
|
565
|
-
"
|
|
565
|
+
"node_type_id": {
|
|
566
566
|
"type": "string",
|
|
567
567
|
"description": "Node type unique identifier"
|
|
568
568
|
},
|
|
@@ -650,7 +650,7 @@
|
|
|
650
650
|
}
|
|
651
651
|
},
|
|
652
652
|
"required": [
|
|
653
|
-
"
|
|
653
|
+
"node_type_id",
|
|
654
654
|
"name",
|
|
655
655
|
"description",
|
|
656
656
|
"category",
|
|
@@ -695,6 +695,16 @@
|
|
|
695
695
|
"defaultValue": {
|
|
696
696
|
"description": "Default value used when no connection provides data"
|
|
697
697
|
},
|
|
698
|
+
"exposedByDefault": {
|
|
699
|
+
"type": "boolean",
|
|
700
|
+
"default": true,
|
|
701
|
+
"description": "Whether the port is exposed when the instance sets no explicit exposure\nfor it (in `data.config.ports`). Defaults to true — a missing override\nreads as exposed. Reserved ports that ship hidden until an author opts in\n(e.g. the `error` output) carry false. In v2 exposure is semantic: a\nnot-exposed port is hidden on the canvas, not wireable, and not\nruntime-overridable.\n"
|
|
702
|
+
},
|
|
703
|
+
"displayOrder": {
|
|
704
|
+
"type": "integer",
|
|
705
|
+
"default": 0,
|
|
706
|
+
"description": "Default sort weight for the port's render position, ascending; ties\nbreak on declaration order. Author-declared ports default to 0. Reserved\nports (the `error` output and `trigger`/`tool` control ports) need no\nvalue — the renderer sinks them to the bottom automatically; set this\nonly to override that. Cosmetic only. The instance's `config.ports`\norder overrides this when present.\n"
|
|
707
|
+
},
|
|
698
708
|
"schema": {
|
|
699
709
|
"allOf": [
|
|
700
710
|
{
|
|
@@ -726,16 +736,12 @@
|
|
|
726
736
|
"idea",
|
|
727
737
|
"default"
|
|
728
738
|
],
|
|
729
|
-
"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##
|
|
739
|
+
"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## Port order + exposure\n\nRender order and exposure are controlled per instance via `config.ports`\n(a per-direction ordered list of `{id, exposed?}`), over each port's metadata\n`displayOrder` / `exposedByDefault` defaults. Order is cosmetic; a not-exposed\nport is hidden, not wireable, and not runtime-overridable.\n"
|
|
730
740
|
},
|
|
731
741
|
"NodeUIExtensions": {
|
|
732
742
|
"type": "object",
|
|
733
743
|
"description": "UI-related extension settings for nodes.\nUsed to control visual behavior in the workflow editor.\n\nThese settings can be defined at two levels:\n1. **Node Type Level** (`metadata.extensions.ui`): Default settings for all instances\n2. **Instance Level** (`data.extensions.ui`): Override for specific node instances\n\nInstance-level settings take precedence over type-level defaults.\n",
|
|
734
744
|
"properties": {
|
|
735
|
-
"hideUnconnectedHandles": {
|
|
736
|
-
"type": "boolean",
|
|
737
|
-
"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"
|
|
738
|
-
},
|
|
739
745
|
"atom": {
|
|
740
746
|
"$ref": "#/$defs/AtomUIConfig"
|
|
741
747
|
},
|
|
@@ -1109,7 +1115,7 @@
|
|
|
1109
1115
|
},
|
|
1110
1116
|
"type": {
|
|
1111
1117
|
"type": "string",
|
|
1112
|
-
"description": "Node type ID (references NodeMetadata.
|
|
1118
|
+
"description": "Node type ID (references NodeMetadata.node_type_id)"
|
|
1113
1119
|
},
|
|
1114
1120
|
"position": {
|
|
1115
1121
|
"$ref": "#/$defs/Position"
|
|
@@ -1139,10 +1145,6 @@
|
|
|
1139
1145
|
"type": "string",
|
|
1140
1146
|
"description": "Error message if node execution failed"
|
|
1141
1147
|
},
|
|
1142
|
-
"nodeId": {
|
|
1143
|
-
"type": "string",
|
|
1144
|
-
"description": "Alternative node ID"
|
|
1145
|
-
},
|
|
1146
1148
|
"executionInfo": {
|
|
1147
1149
|
"$ref": "#/$defs/NodeExecutionInfo"
|
|
1148
1150
|
},
|
|
@@ -1152,7 +1154,7 @@
|
|
|
1152
1154
|
"$ref": "#/$defs/NodeExtensions"
|
|
1153
1155
|
},
|
|
1154
1156
|
{
|
|
1155
|
-
"description": "Per-instance extension properties for 3rd party integrations.\nOverrides or extends the node type extensions defined in metadata.extensions.\nUse for instance-specific UI states or custom data.\n\nCommon use cases:\n- `extensions.ui.
|
|
1157
|
+
"description": "Per-instance extension properties for 3rd party integrations.\nOverrides or extends the node type extensions defined in metadata.extensions.\nUse for instance-specific UI states or custom data.\n\nCommon use cases:\n- `extensions.ui.style`: Custom styling for this node instance\n(Port order + exposure live in `config.ports`, not here.)\n"
|
|
1156
1158
|
}
|
|
1157
1159
|
]
|
|
1158
1160
|
}
|