@flowdrop/flowdrop 1.13.0 → 1.15.0

package/dist/types/index.d.ts

@@ -202,7 +202,7 @@ export declare function dynamicPortToNodePort(port: DynamicPort, portType: 'inpu
  * Built-in node types for explicit component rendering.
  * These are the node types that ship with FlowDrop.
  */
-export type BuiltinNodeType = 'note' | 'simple' | 'square' | 'tool' | 'gateway' | 'terminal' | 'default';
+export type BuiltinNodeType = 'note' | 'simple' | 'square' | 'atom' | 'tool' | 'gateway' | 'terminal' | 'default';
 /**
  * Node type for component rendering.
  * Includes built-in types and allows custom registered types.
@@ -306,8 +306,13 @@ export interface AutocompleteConfig {
      * If the "account" field currently holds "my-jira", the URL becomes:
      * /api/jira/issue-types?account=my-jira&q=...
      *
-     * When any dependency field changes, the autocomplete clears its
-     * current value and invalidates the suggestion cache.
+     * When a dependency field changes, the component invalidates its cached
+     * suggestions and aborts any in-flight fetch. The dependent field's own
+     * value is cleared by the parent form (`ConfigForm` / `SchemaForm`) on
+     * user-driven edits only — undo/redo, programmatic value replacement, and
+     * collaborative edits flow in via props and preserve dependent values.
+     * Standalone consumers of `FormAutocomplete` outside a FlowDrop form
+     * therefore need to clear dependents themselves.
      */
     params?: Record<string, string>;
 }
@@ -495,9 +500,39 @@ export interface ConfigEditOptions {
  * UI-related extension settings for nodes
  * Used to control visual behavior in the workflow editor
  */
+/**
+ * Display/behavior config for minimalist "atom" nodes (Constant, Cast, …).
+ * Lives under `extensions.ui.atom`. The atom renderer reads it to decide what to
+ * show, and `getAllPorts` reads `valueTypeKey` to drive the bound output port's
+ * dataType from config so connection validation stays correct.
+ */
+export interface AtomUIConfig {
+    /** Config key whose value becomes the node body. Falls back to `data.label`. */
+    valueKey?: string;
+    /**
+     * Config key holding the selected value's type (a port dataType id).
+     * The bound output port adopts this dataType.
+     */
+    valueTypeKey?: string;
+    /** Output port id driven by `valueTypeKey`. Defaults to the first output port. */
+    outputPortId?: string;
+    /** Body shape. `'pill'` (default) is fully rounded; `'rectangle'` is lightly rounded. */
+    shape?: 'pill' | 'rectangle';
+    /**
+     * Dimmed affordance rendered before the body (e.g. `'→ '` to mark a transform).
+     * Stays visible while the body value ellipsizes. Hidden in the empty state.
+     */
+    prefix?: string;
+    /** Text shown (dimmed) when the resolved body value is empty/unset. */
+    placeholder?: string;
+    /** Max body width in px before the label ellipsizes. */
+    maxWidth?: number;
+}
 export interface NodeUIExtensions {
     /** Show/hide unconnected handles (ports) to reduce visual noise */
     hideUnconnectedHandles?: boolean;
+    /** Display/behavior config for minimalist atom nodes (Constant, Cast, …) */
+    atom?: AtomUIConfig;
     /**
      * Visual-only port display order (no effect on execution).
      * Arrays of port IDs in the desired render order.

package/dist/types/playground.d.ts

@@ -62,6 +62,14 @@ export interface PlaygroundExecution {
     id: string;
     startedAt: string;
     status: 'running' | 'completed' | 'failed';
+    /**
+     * Client-derived flag: true when this run is a nested sub-flow rather than a
+     * main pipeline run. Inferred from its messages' `parentPipelineId` (with a
+     * `hierarchy` depth ≥ 2 fallback for legacy runs predating that field). Used
+     * to keep the sidebar on the main pipeline and hide sub-flows from the
+     * run-switcher. Not part of the wire contract — the server never sets this.
+     */
+    isSubflow?: boolean;
 }
 /**
  * Playground session representing a test conversation
@@ -94,7 +102,12 @@ export interface PlaygroundSession {
     createdAt: string;
     /** Last activity timestamp (ISO 8601) */
     updatedAt: string;
-    /** Pipeline executions triggered within this session, ordered oldest-first */
+    /**
+     * Main pipeline runs triggered within this session, ordered oldest-first.
+     * Sub-flow (nested) runs are excluded — they're surfaced only on individual
+     * messages via `parentPipelineId`. The run-switcher relies on this being
+     * main-runs-only; runs added from messages are classified client-side.
+     */
     executions?: PlaygroundExecution[];
     /** Custom session metadata */
     metadata?: Record<string, unknown>;
@@ -216,6 +229,19 @@ export interface PlaygroundMessage {
     parentMessageId?: string;
     /** Pipeline/execution ID that generated this message */
     executionId?: string | null;
+    /**
+     * Execution ID of the parent pipeline when this message came from a nested
+     * sub-flow; `null`/absent for top-level (main pipeline) messages. Authoritative
+     * nesting signal (unlike the display-only `hierarchy`) — used to keep the main
+     * pipeline in focus and hide sub-flow runs from the run-switcher.
+     */
+    parentPipelineId?: string | null;
+    /**
+     * Execution ID of the top-level pipeline this message ultimately belongs to.
+     * Equals `executionId` for main-pipeline messages; for sub-flow messages it
+     * points to the main run that triggered the sub-flow.
+     */
+    rootPipelineId?: string | null;
     /** Associated node ID (for log/assistant messages) */
     nodeId?: string | null;
     /**
@@ -301,6 +327,12 @@ export interface PlaygroundConfig {
     pollingInterval?: number;
     /** Maximum number of messages to display (default: 500) */
     maxMessages?: number;
+    /**
+     * Number of messages to fetch per page (default: 50).
+     * The initial load fetches the most recent page; scrolling up loads
+     * older pages of this size on demand.
+     */
+    messagePageSize?: number;
     /** Auto-scroll to bottom on new messages (default: true) */
     autoScroll?: boolean;
     /** Show timestamps on messages (default: true) */
@@ -433,8 +465,10 @@ export type PlaygroundMessageResponse = PlaygroundApiResponse<PlaygroundMessage>
  * Type alias for messages list response with polling metadata
  */
 export interface PlaygroundMessagesApiResponse extends PlaygroundApiResponse<PlaygroundMessage[]> {
-    /** Whether there are more messages to fetch */
+    /** Whether more recent messages remain after this page (forward pagination via `since`) */
     hasMore?: boolean;
+    /** Whether older messages exist before the first message in this page (backward pagination via `latest`/`before`) */
+    hasOlder?: boolean;
     /** Current session status */
     sessionStatus?: PlaygroundSessionStatus;
 }

package/dist/utils/formMerge.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Form value merge — shared by `SchemaForm` and `ConfigForm`.
+ *
+ * Produces the view of form values that children read via context. Precedence
+ * per key:
+ *
+ *   1. `key in edits`            → use the user's local edit
+ *   2. `source[key] !== undefined` → use the prop value (including null/0/false/'')
+ *   3. otherwise                  → use the schema field's `default`
+ *
+ * Keeping this separate from the host components means the test pins the same
+ * function the components run, not a parallel implementation.
+ */
+export declare function mergeWithDefaults(schema: {
+    properties?: Record<string, unknown>;
+} | undefined, source: Record<string, unknown>, edits: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Compute the cascade-clear set when a single field changes — shared by
+ * `SchemaForm` and `ConfigForm`.
+ *
+ * When `changedKey` changes, any property whose `autocomplete.params` references
+ * `changedKey` (directly or transitively) should have its value cleared: the
+ * old dependent value was computed against the old parent value and is now
+ * stale.
+ *
+ * Returns a map of `{ dependentKey -> clearValue }` to apply on top of the
+ * caller's edits buffer. Single-value autocompletes clear to `''`; ones with
+ * `multiple: true` clear to `[]`.
+ *
+ * This logic lives in the parent form (not in `FormAutocomplete`) so it only
+ * runs on user-driven changes via `handleFieldChange`, not on undo/redo,
+ * programmatic resets, or collaborative edits (#33).
+ */
+export declare function cascadeClearAutocompleteDependents(schema: {
+    properties?: Record<string, unknown>;
+} | undefined, changedKey: string): Record<string, unknown>;

package/dist/utils/formMerge.js

@@ -0,0 +1,70 @@
+/**
+ * Form value merge — shared by `SchemaForm` and `ConfigForm`.
+ *
+ * Produces the view of form values that children read via context. Precedence
+ * per key:
+ *
+ *   1. `key in edits`            → use the user's local edit
+ *   2. `source[key] !== undefined` → use the prop value (including null/0/false/'')
+ *   3. otherwise                  → use the schema field's `default`
+ *
+ * Keeping this separate from the host components means the test pins the same
+ * function the components run, not a parallel implementation.
+ */
+export function mergeWithDefaults(schema, source, edits) {
+    if (!schema?.properties)
+        return {};
+    const merged = {};
+    for (const [key, field] of Object.entries(schema.properties)) {
+        if (key in edits) {
+            merged[key] = edits[key];
+        }
+        else {
+            const fieldConfig = field;
+            merged[key] = source[key] !== undefined ? source[key] : fieldConfig.default;
+        }
+    }
+    return merged;
+}
+/**
+ * Compute the cascade-clear set when a single field changes — shared by
+ * `SchemaForm` and `ConfigForm`.
+ *
+ * When `changedKey` changes, any property whose `autocomplete.params` references
+ * `changedKey` (directly or transitively) should have its value cleared: the
+ * old dependent value was computed against the old parent value and is now
+ * stale.
+ *
+ * Returns a map of `{ dependentKey -> clearValue }` to apply on top of the
+ * caller's edits buffer. Single-value autocompletes clear to `''`; ones with
+ * `multiple: true` clear to `[]`.
+ *
+ * This logic lives in the parent form (not in `FormAutocomplete`) so it only
+ * runs on user-driven changes via `handleFieldChange`, not on undo/redo,
+ * programmatic resets, or collaborative edits (#33).
+ */
+export function cascadeClearAutocompleteDependents(schema, changedKey) {
+    if (!schema?.properties)
+        return {};
+    const cleared = new Set([changedKey]);
+    const result = {};
+    let added = true;
+    while (added) {
+        added = false;
+        for (const [depKey, depField] of Object.entries(schema.properties)) {
+            if (cleared.has(depKey))
+                continue;
+            const field = depField;
+            const params = field.autocomplete?.params;
+            if (!params)
+                continue;
+            const dependsOnCleared = Object.values(params).some((fieldName) => cleared.has(fieldName));
+            if (dependsOnCleared) {
+                result[depKey] = field.autocomplete?.multiple ? [] : '';
+                cleared.add(depKey);
+                added = true;
+            }
+        }
+    }
+    return result;
+}

package/dist/utils/nodeTypes.js

@@ -18,6 +18,7 @@ const TYPE_DISPLAY_NAMES = {
     note: 'Note (sticky note style)',
     simple: 'Simple (compact layout)',
     square: 'Square (geometric layout)',
+    atom: 'Atom (minimal value/transform)',
     tool: 'Tool (specialized for agent tools)',
     gateway: 'Gateway (branching control flow)',
     terminal: 'Terminal (start/end/exit)',

package/package.json

@@ -3,7 +3,7 @@
   "description": "A drop-in visual workflow editor for any web application. You own the backend. You own the data. You own the orchestration.",
   "license": "MIT",
   "private": false,
-  "version": "1.13.0",
+  "version": "1.15.0",
   "author": "Shibin Das (D34dMan)",
   "bugs": {
     "url": "https://github.com/flowdrop-io/flowdrop/issues"
@@ -125,6 +125,12 @@
     },
     "./schema/v1": {
       "default": "./dist/schemas/v1/workflow.schema.json"
+    },
+    "./openapi": {
+      "default": "./dist/openapi/v1/openapi.yaml"
+    },
+    "./openapi/v1": {
+      "default": "./dist/openapi/v1/openapi.yaml"
     }
   },
   "peerDependencies": {