@flowdrop/flowdrop 1.12.0 → 1.14.0

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>;
@@ -118,6 +131,65 @@ export interface PlaygroundMessageMetadata {
     /** Allow additional properties */
     [key: string]: unknown;
 }
+/**
+ * A node on the contextual tree the server attaches to a message
+ * (e.g. workflow > sub-workflow > iteration). Display-only — this is not a
+ * navigation breadcrumb; `href` is intentionally not part of the schema.
+ */
+export interface MessageHierarchyItem {
+    /** Stable identifier (for keying) */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Optional iconify icon id (e.g. 'mdi:graph') */
+    icon?: string;
+}
+/**
+ * Semantic color hooks for a tag. Map to design tokens in the theme.
+ */
+export type MessageTagColor = 'muted' | 'primary' | 'success' | 'warning' | 'error' | 'info';
+/**
+ * Visual emphasis for a tag.
+ */
+export type MessageTagVariant = 'solid' | 'outline' | 'subtle';
+/**
+ * A server-emitted classification chip rendered alongside a message.
+ * Tags are unordered and replace any UI-side defaults.
+ */
+export interface MessageTag {
+    /** Stable identifier (for keying) */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Optional iconify icon id */
+    icon?: string;
+    /** Semantic color hook; defaults to 'muted' if omitted */
+    color?: MessageTagColor;
+    /** Visual style; defaults to 'subtle' if omitted */
+    variant?: MessageTagVariant;
+    /** Free-form classifier the server may use for future grouping/filtering */
+    type?: string;
+}
+/**
+ * Rendering hint the server may set to choose a layout regardless of role.
+ *
+ * - `bubble`: chat bubble shape (default for user/assistant)
+ * - `log`: dense one-liner (default for log role)
+ * - `notice`: compact centered notice (default for system role with
+ *   compactSystemMessages enabled)
+ * - `card`: vertical layout — breadcrumb (top), body (middle), tags (bottom)
+ *
+ * When omitted, the client falls back to the role-based default above.
+ */
+export type PlaygroundMessageDisplay = 'bubble' | 'log' | 'notice' | 'card';
+/**
+ * Resolve the effective layout for a message. Server-supplied `display` wins;
+ * otherwise we fall back to a role-based default. Pure function so the
+ * dispatcher and tests can share it.
+ */
+export declare function resolveMessageDisplay(message: Pick<PlaygroundMessage, 'role' | 'display'>, options?: {
+    compactSystemMessages?: boolean;
+}): PlaygroundMessageDisplay;
 /**
  * Message in a playground session
  *
@@ -157,8 +229,38 @@ 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;
+    /**
+     * Ordered hierarchy path (e.g. workflow > sub-workflow > iteration).
+     * Rendered as a chevron-separated trail. Server-controlled — no
+     * client-side derivation.
+     */
+    hierarchy?: MessageHierarchyItem[];
+    /**
+     * Server-emitted classification chips rendered with the message.
+     * Replace any client-side defaults entirely (no merge).
+     */
+    tags?: MessageTag[];
+    /**
+     * Layout hint. When omitted, the client picks a default from the role:
+     * - log → 'log', system (when compactSystemMessages) → 'notice',
+     *   user/assistant → 'bubble'.
+     */
+    display?: PlaygroundMessageDisplay;
     /** Additional message metadata */
     metadata?: PlaygroundMessageMetadata;
 }
@@ -225,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) */
@@ -357,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/types/playground.js

@@ -42,6 +42,20 @@ export function defaultShouldStopPolling(status) {
 export function defaultIsTerminalStatus(status) {
     return DEFAULT_TERMINAL_STATUSES.includes(status);
 }
+/**
+ * Resolve the effective layout for a message. Server-supplied `display` wins;
+ * otherwise we fall back to a role-based default. Pure function so the
+ * dispatcher and tests can share it.
+ */
+export function resolveMessageDisplay(message, options = {}) {
+    if (message.display)
+        return message.display;
+    if (message.role === 'system' && options.compactSystemMessages !== false)
+        return 'notice';
+    if (message.role === 'log')
+        return 'log';
+    return 'bubble';
+}
 /**
  * Metadata field to control Run button state from backend.
  * When a message contains this field set to true, the Run button becomes enabled.

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.12.0",
+  "version": "1.14.0",
   "author": "Shibin Das (D34dMan)",
   "bugs": {
     "url": "https://github.com/flowdrop-io/flowdrop/issues"
@@ -83,6 +83,11 @@
       "svelte": "./dist/form/code.js",
       "default": "./dist/form/code.js"
     },
+    "./form/autocomplete": {
+      "types": "./dist/form/autocomplete.d.ts",
+      "svelte": "./dist/form/autocomplete.js",
+      "default": "./dist/form/autocomplete.js"
+    },
     "./form/markdown": {
       "types": "./dist/form/markdown.d.ts",
       "svelte": "./dist/form/markdown.js",
@@ -120,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": {