@particle-academy/fancy-flow 0.77.0 → 0.78.0

package/dist/index.d.cts

@@ -3,23 +3,23 @@ import { ReactNode, CSSProperties, ComponentProps, ComponentType } from 'react';
 import { ReactFlowProps, Edge, BackgroundVariant, Connection, NodeProps, NodeTypes } from '@xyflow/react';
 import { ConnectionValidatorOptions } from './registry/index.cjs';
 export { ANY_PORT_TYPE, BUILTIN_KINDS, PortCompatibility, RegistryNode, RichInputAdapter, RichInputPreview, buildNodeTypes, createConnectionValidator, defaultPortCompatibility, getRichInputAdapter, isRichInputEnabled, onRichInputAdapterChanged, registerBuiltinKinds, registerRichInputAdapter, resolveNodePorts, resolvePortSpec } from './registry/index.cjs';
-import { a as FlowNode, F as FlowGraph, h as NodeRunStatus, E as ExecutorRegistry } from './types-B-Syk9-M.cjs';
-export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, e as FlowEdge, f as FlowNodeData, g as FlowNodeKind, N as NodeExecutor, i as NoteNodeData, O as OutputNodeData, P as PortDescriptor, R as RunEvent, S as SubgraphNodeData, j as TriggerNodeData } from './types-B-Syk9-M.cjs';
-import { a as NodeCategory, N as NodeKindDefinition, C as ConfigField } from './types-BdkXxjFh.cjs';
-export { A as AvailableVariable, D as DocumentConfigField, E as EmitsRelation, t as ExpressionForm, u as ExpressionGrammarHelp, K as KeyValueConfigField, O as OutputField, h as OutputShape, P as PortSpec, R as RenderBodyContext, n as RepeaterConfigField, o as RepeaterRowField, w as availableVariables, x as baseVariables, y as describeExpressionGrammar, z as outputFieldsFor } from './types-BdkXxjFh.cjs';
-import { C as ConfigFieldRenderFn, H as HumanFieldRenderers } from './HumanPrompt-xYPCL2jO.cjs';
-export { a as ConfigFieldRenderContext, b as ConfigFieldRenderer, c as ConfigFieldRendererProps } from './HumanPrompt-xYPCL2jO.cjs';
+import { a as FlowNode, F as FlowGraph, h as NodeRunStatus, E as ExecutorRegistry } from './types-E48Dpesq.cjs';
+export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, e as FlowEdge, f as FlowNodeData, g as FlowNodeKind, N as NodeExecutor, i as NoteNodeData, O as OutputNodeData, P as PortDescriptor, R as RunEvent, S as SubgraphNodeData, j as TriggerNodeData } from './types-E48Dpesq.cjs';
+import { a as NodeCategory, N as NodeKindDefinition, C as ConfigField } from './types-B1jftRa9.cjs';
+export { A as AvailableVariable, D as DocumentConfigField, E as EmitsRelation, t as ExpressionForm, u as ExpressionGrammarHelp, K as KeyValueConfigField, O as OutputField, h as OutputShape, P as PortSpec, R as RenderBodyContext, n as RepeaterConfigField, o as RepeaterRowField, w as availableVariables, x as baseVariables, y as describeExpressionGrammar, z as outputFieldsFor } from './types-B1jftRa9.cjs';
+import { C as ConfigFieldRenderFn, H as HumanFieldRenderers } from './HumanPrompt-Sl1wD9Bx.cjs';
+export { a as ConfigFieldRenderContext, b as ConfigFieldRenderer, c as ConfigFieldRendererProps } from './HumanPrompt-Sl1wD9Bx.cjs';
 import { WorkflowSchema, WorkflowMetadata } from './schema/index.cjs';
 export { ImportIssue, ImportOptions, ImportResult, WORKFLOW_SCHEMA_URL, WORKFLOW_SCHEMA_VERSION, WorkflowSchemaEdge, WorkflowSchemaNode, exportWorkflow, importWorkflow, migrateSchema, workflowToBlob } from './schema/index.cjs';
 import { AutoLayoutOptions } from './layout/index.cjs';
 export { AutoLayoutDirection } from './layout/index.cjs';
-export { F as FlowNodeStatus, a as FlowViewer, b as FlowViewerClassNames, c as FlowViewerProps } from './FlowViewer-Ak8kbY0e.cjs';
+export { F as FlowNodeStatus, a as FlowViewer, b as FlowViewerClassNames, c as FlowViewerProps } from './FlowViewer-BqYQl2vS.cjs';
 import { FlowRunFeedEntry } from './runtime/index.cjs';
 export { HistoryController, UseFlowHistoryReturn, UseFlowRunOptions, UseFlowRunReturn, UseFlowStateReturn, applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './runtime/index.cjs';
-export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-pW0PllaZ.cjs';
-export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from './run-cohort-DNpPa0mq.cjs';
+export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-Bdrn4lQV.cjs';
+export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from './run-cohort-DRJvUWO9.cjs';
 export { E as EvaluateOptions, a as ExprContext, b as ExprValue, R as Resolution, U as UnresolvedPathError, c as UnresolvedPolicy, e as evaluateConfig, d as evaluateExpression, r as resolvePath, t as text, f as truthy, g as tryResolvePath } from './expr-BfXDrs4H.cjs';
-export { K as KindSchemaOverlay, a as KindSchemaOverlayResult, N as NodeKindPresentation, b as applyKindSchemaOverlay, f as categoryAccent, c as clearKindSchemaOverlays, h as clearNodeKindOverrides, d as defaultConfigFor, i as ensureBuiltinKinds, g as getNodeKind, l as listNodeKinds, o as onNodeKindsChanged, j as overrideNodeKind, r as registerNodeKind, u as unregisterNodeKind, v as validateConfig } from './registry-B6SiTaLZ.cjs';
+export { K as KindSchemaOverlay, a as KindSchemaOverlayResult, N as NodeKindPresentation, b as applyKindSchemaOverlay, f as categoryAccent, c as clearKindSchemaOverlays, h as clearNodeKindOverrides, d as defaultConfigFor, i as ensureBuiltinKinds, g as getNodeKind, l as listNodeKinds, o as onNodeKindsChanged, j as overrideNodeKind, r as registerNodeKind, u as unregisterNodeKind, v as validateConfig } from './registry-DWIY3bMP.cjs';
 export { L as LEGACY_PAUSE_PREFIXES, a as PAUSE_PREFIX, P as PauseAwaiting, b as PauseSignal, d as decodePause, e as encodePause, i as isPause, p as pauseForHuman } from './pause-9iT4tCEV.cjs';
 
 type FlowCanvasProps = Omit<ReactFlowProps<FlowNode, Edge>, "nodes" | "edges" | "height"> & {

package/dist/index.d.ts

@@ -3,23 +3,23 @@ import { ReactNode, CSSProperties, ComponentProps, ComponentType } from 'react';
 import { ReactFlowProps, Edge, BackgroundVariant, Connection, NodeProps, NodeTypes } from '@xyflow/react';
 import { ConnectionValidatorOptions } from './registry/index.js';
 export { ANY_PORT_TYPE, BUILTIN_KINDS, PortCompatibility, RegistryNode, RichInputAdapter, RichInputPreview, buildNodeTypes, createConnectionValidator, defaultPortCompatibility, getRichInputAdapter, isRichInputEnabled, onRichInputAdapterChanged, registerBuiltinKinds, registerRichInputAdapter, resolveNodePorts, resolvePortSpec } from './registry/index.js';
-import { a as FlowNode, F as FlowGraph, h as NodeRunStatus, E as ExecutorRegistry } from './types-B-Syk9-M.js';
-export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, e as FlowEdge, f as FlowNodeData, g as FlowNodeKind, N as NodeExecutor, i as NoteNodeData, O as OutputNodeData, P as PortDescriptor, R as RunEvent, S as SubgraphNodeData, j as TriggerNodeData } from './types-B-Syk9-M.js';
-import { a as NodeCategory, N as NodeKindDefinition, C as ConfigField } from './types-CbekKMMO.js';
-export { A as AvailableVariable, D as DocumentConfigField, E as EmitsRelation, t as ExpressionForm, u as ExpressionGrammarHelp, K as KeyValueConfigField, O as OutputField, h as OutputShape, P as PortSpec, R as RenderBodyContext, n as RepeaterConfigField, o as RepeaterRowField, w as availableVariables, x as baseVariables, y as describeExpressionGrammar, z as outputFieldsFor } from './types-CbekKMMO.js';
-import { C as ConfigFieldRenderFn, H as HumanFieldRenderers } from './HumanPrompt-Ge_ccCgS.js';
-export { a as ConfigFieldRenderContext, b as ConfigFieldRenderer, c as ConfigFieldRendererProps } from './HumanPrompt-Ge_ccCgS.js';
+import { a as FlowNode, F as FlowGraph, h as NodeRunStatus, E as ExecutorRegistry } from './types-E48Dpesq.js';
+export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, e as FlowEdge, f as FlowNodeData, g as FlowNodeKind, N as NodeExecutor, i as NoteNodeData, O as OutputNodeData, P as PortDescriptor, R as RunEvent, S as SubgraphNodeData, j as TriggerNodeData } from './types-E48Dpesq.js';
+import { a as NodeCategory, N as NodeKindDefinition, C as ConfigField } from './types-D5SBBpbe.js';
+export { A as AvailableVariable, D as DocumentConfigField, E as EmitsRelation, t as ExpressionForm, u as ExpressionGrammarHelp, K as KeyValueConfigField, O as OutputField, h as OutputShape, P as PortSpec, R as RenderBodyContext, n as RepeaterConfigField, o as RepeaterRowField, w as availableVariables, x as baseVariables, y as describeExpressionGrammar, z as outputFieldsFor } from './types-D5SBBpbe.js';
+import { C as ConfigFieldRenderFn, H as HumanFieldRenderers } from './HumanPrompt-_SKIdSpx.js';
+export { a as ConfigFieldRenderContext, b as ConfigFieldRenderer, c as ConfigFieldRendererProps } from './HumanPrompt-_SKIdSpx.js';
 import { WorkflowSchema, WorkflowMetadata } from './schema/index.js';
 export { ImportIssue, ImportOptions, ImportResult, WORKFLOW_SCHEMA_URL, WORKFLOW_SCHEMA_VERSION, WorkflowSchemaEdge, WorkflowSchemaNode, exportWorkflow, importWorkflow, migrateSchema, workflowToBlob } from './schema/index.js';
 import { AutoLayoutOptions } from './layout/index.js';
 export { AutoLayoutDirection } from './layout/index.js';
-export { F as FlowNodeStatus, a as FlowViewer, b as FlowViewerClassNames, c as FlowViewerProps } from './FlowViewer-BAV29Zpi.js';
+export { F as FlowNodeStatus, a as FlowViewer, b as FlowViewerClassNames, c as FlowViewerProps } from './FlowViewer-_Fq8AX9V.js';
 import { FlowRunFeedEntry } from './runtime/index.js';
 export { HistoryController, UseFlowHistoryReturn, UseFlowRunOptions, UseFlowRunReturn, UseFlowStateReturn, applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './runtime/index.js';
-export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-BLP9rXfO.js';
-export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from './run-cohort-rgT_FX3V.js';
+export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-D2iOjWsj.js';
+export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from './run-cohort-DAfhZm-p.js';
 export { E as EvaluateOptions, a as ExprContext, b as ExprValue, R as Resolution, U as UnresolvedPathError, c as UnresolvedPolicy, e as evaluateConfig, d as evaluateExpression, r as resolvePath, t as text, f as truthy, g as tryResolvePath } from './expr-BfXDrs4H.js';
-export { K as KindSchemaOverlay, a as KindSchemaOverlayResult, N as NodeKindPresentation, b as applyKindSchemaOverlay, f as categoryAccent, c as clearKindSchemaOverlays, h as clearNodeKindOverrides, d as defaultConfigFor, i as ensureBuiltinKinds, g as getNodeKind, l as listNodeKinds, o as onNodeKindsChanged, j as overrideNodeKind, r as registerNodeKind, u as unregisterNodeKind, v as validateConfig } from './registry-JUcN_xWK.js';
+export { K as KindSchemaOverlay, a as KindSchemaOverlayResult, N as NodeKindPresentation, b as applyKindSchemaOverlay, f as categoryAccent, c as clearKindSchemaOverlays, h as clearNodeKindOverrides, d as defaultConfigFor, i as ensureBuiltinKinds, g as getNodeKind, l as listNodeKinds, o as onNodeKindsChanged, j as overrideNodeKind, r as registerNodeKind, u as unregisterNodeKind, v as validateConfig } from './registry-C4GcH583.js';
 export { L as LEGACY_PAUSE_PREFIXES, a as PAUSE_PREFIX, P as PauseAwaiting, b as PauseSignal, d as decodePause, e as encodePause, i as isPause, p as pauseForHuman } from './pause-9iT4tCEV.js';
 
 type FlowCanvasProps = Omit<ReactFlowProps<FlowNode, Edge>, "nodes" | "edges" | "height"> & {

package/dist/index.js

@@ -1,18 +1,18 @@
-import { removeNodes, removeEdges, cloneSubgraph, alignNodes, distributeNodes, reconnectEdge, assignToLane, removeFromLane, duplicateNode, setEdgeLabel, FlowCanvas } from './chunk-44VXYZ4M.js';
-export { ActionNode, DecisionNode, FlowCanvas, FlowViewer, NodeShell, OutputNode, SubgraphNode, TriggerNode, alignNodes, cloneSubgraph, defaultNodeTypes, distributeNodes, reconnectEdge } from './chunk-44VXYZ4M.js';
-import { useFlowState, useFlowRun, useFlowHistory, applyOutputsToNodes, applyStatusesToNodes } from './chunk-X2UHP2S5.js';
-export { applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './chunk-X2UHP2S5.js';
-export { runCohort } from './chunk-KFC3BURT.js';
-import { buildNodeTypes, FlowEditorProvider, registerBuiltinKinds } from './chunk-66JAEWPP.js';
-export { ANY_PORT_TYPE, BUILTIN_KINDS, LaneNode, NoteNode, RegistryNode, buildNodeTypes, createConnectionValidator, defaultPortCompatibility, registerBuiltinKinds, useFlowEditor, useFlowEditorOptional } from './chunk-66JAEWPP.js';
+import { removeNodes, removeEdges, cloneSubgraph, alignNodes, distributeNodes, reconnectEdge, assignToLane, removeFromLane, duplicateNode, setEdgeLabel, FlowCanvas } from './chunk-BBFHGAEN.js';
+export { ActionNode, DecisionNode, FlowCanvas, FlowViewer, NodeShell, OutputNode, SubgraphNode, TriggerNode, alignNodes, cloneSubgraph, defaultNodeTypes, distributeNodes, reconnectEdge } from './chunk-BBFHGAEN.js';
+import { useFlowState, useFlowRun, useFlowHistory, applyOutputsToNodes, applyStatusesToNodes } from './chunk-S4MOUOG4.js';
+export { applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './chunk-S4MOUOG4.js';
+export { runCohort } from './chunk-4GNDRRJ3.js';
+import { buildNodeTypes, FlowEditorProvider, registerBuiltinKinds } from './chunk-XO4ODEY2.js';
+export { ANY_PORT_TYPE, BUILTIN_KINDS, LaneNode, NoteNode, RegistryNode, buildNodeTypes, createConnectionValidator, defaultPortCompatibility, registerBuiltinKinds, useFlowEditor, useFlowEditorOptional } from './chunk-XO4ODEY2.js';
 import { getRichInputAdapter } from './chunk-F5RPRB7A.js';
 export { RichInputPreview, getRichInputAdapter, isRichInputEnabled, onRichInputAdapterChanged, registerRichInputAdapter } from './chunk-F5RPRB7A.js';
 import { ReactFlowProvider, useReactFlow, addEdge, applyEdgeChanges, applyNodeChanges, Position, Handle } from './chunk-OWENS2H5.js';
-import { workflowToBlob, importWorkflow, exportWorkflow } from './chunk-OOQ2MMBE.js';
-export { WORKFLOW_SCHEMA_URL, WORKFLOW_SCHEMA_VERSION, exportWorkflow, importWorkflow, migrateSchema, workflowToBlob } from './chunk-OOQ2MMBE.js';
-import './chunk-MMCHYY6B.js';
-import { humanInputFields, onNodeKindsChanged, listNodeKinds, getNodeKind, defaultConfigFor, ensureBuiltinKinds, validateConfig, categoryAccent, availableVariables, baseVariables, describeExpressionGrammar } from './chunk-YNKOEQLI.js';
-export { LEGACY_PAUSE_PREFIXES, PAUSE_PREFIX, UnresolvedPathError, applyKindSchemaOverlay, availableVariables, baseVariables, categoryAccent, clearKindSchemaOverlays, clearNodeKindOverrides, decodePause, defaultConfigFor, describeExpressionGrammar, encodePause, ensureBuiltinKinds, evaluateConfig, evaluateExpression, getNodeKind, isPause, listNodeKinds, onNodeKindsChanged, outputFieldsFor, overrideNodeKind, pauseForHuman, registerNodeKind, resolveNodePorts, resolvePath, resolvePortSpec, runFlow, text, truthy, tryResolvePath, unregisterNodeKind, validateConfig } from './chunk-YNKOEQLI.js';
+import { workflowToBlob, importWorkflow, exportWorkflow } from './chunk-GPFIJR2K.js';
+export { WORKFLOW_SCHEMA_URL, WORKFLOW_SCHEMA_VERSION, exportWorkflow, importWorkflow, migrateSchema, workflowToBlob } from './chunk-GPFIJR2K.js';
+import './chunk-3EDB6ELL.js';
+import { humanInputFields, onNodeKindsChanged, listNodeKinds, getNodeKind, defaultConfigFor, ensureBuiltinKinds, validateConfig, categoryAccent, availableVariables, baseVariables, describeExpressionGrammar } from './chunk-J5YUYDMK.js';
+export { LEGACY_PAUSE_PREFIXES, PAUSE_PREFIX, UnresolvedPathError, applyKindSchemaOverlay, availableVariables, baseVariables, categoryAccent, clearKindSchemaOverlays, clearNodeKindOverrides, decodePause, defaultConfigFor, describeExpressionGrammar, encodePause, ensureBuiltinKinds, evaluateConfig, evaluateExpression, getNodeKind, isPause, listNodeKinds, onNodeKindsChanged, outputFieldsFor, overrideNodeKind, pauseForHuman, registerNodeKind, resolveNodePorts, resolvePath, resolvePortSpec, runFlow, text, truthy, tryResolvePath, unregisterNodeKind, validateConfig } from './chunk-J5YUYDMK.js';
 import './chunk-2QXKDLGT.js';
 import { forwardRef, useState, useMemo, useEffect, useCallback, useRef, useImperativeHandle, useId, memo } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';

package/dist/layout/index.d.cts

@@ -1,4 +1,4 @@
-import { F as FlowGraph, a as FlowNode } from '../types-B-Syk9-M.cjs';
+import { F as FlowGraph, a as FlowNode } from '../types-E48Dpesq.cjs';
 import '@xyflow/react';
 
 type AutoLayoutDirection = "LR" | "TB" | "RL" | "BT";

package/dist/layout/index.d.ts

@@ -1,4 +1,4 @@
-import { F as FlowGraph, a as FlowNode } from '../types-B-Syk9-M.js';
+import { F as FlowGraph, a as FlowNode } from '../types-E48Dpesq.js';
 import '@xyflow/react';
 
 type AutoLayoutDirection = "LR" | "TB" | "RL" | "BT";

package/dist/llm/prism.d.cts

@@ -1,4 +1,4 @@
-import { L as LlmClient } from '../types-B-Syk9-M.cjs';
+import { L as LlmClient } from '../types-E48Dpesq.cjs';
 import '@xyflow/react';
 
 /**

package/dist/llm/prism.d.ts

@@ -1,4 +1,4 @@
-import { L as LlmClient } from '../types-B-Syk9-M.js';
+import { L as LlmClient } from '../types-E48Dpesq.js';
 import '@xyflow/react';
 
 /**

package/dist/llm/vercel-ai.d.cts

@@ -1,5 +1,5 @@
 import { LanguageModel } from 'ai';
-import { b as LlmRouteRequest, L as LlmClient } from '../types-B-Syk9-M.cjs';
+import { b as LlmRouteRequest, L as LlmClient } from '../types-E48Dpesq.cjs';
 import '@xyflow/react';
 
 /**

package/dist/llm/vercel-ai.d.ts

@@ -1,5 +1,5 @@
 import { LanguageModel } from 'ai';
-import { b as LlmRouteRequest, L as LlmClient } from '../types-B-Syk9-M.js';
+import { b as LlmRouteRequest, L as LlmClient } from '../types-E48Dpesq.js';
 import '@xyflow/react';
 
 /**

package/dist/registry/index.d.cts

@@ -1,12 +1,12 @@
-import { N as NodeKindDefinition, P as PortSpec } from '../types-BdkXxjFh.cjs';
-export { C as ConfigField, k as CredentialConfigField, D as DocumentConfigField, E as EmitsRelation, l as ExpressionConfigField, J as JsonConfigField, K as KeyValueConfigField, a as NodeCategory, m as NumberConfigField, R as RenderBodyContext, n as RepeaterConfigField, o as RepeaterRowField, p as SelectConfigField, q as SwitchConfigField, T as TextConfigField, r as TextareaConfigField } from '../types-BdkXxjFh.cjs';
-import { P as PortDescriptor, a as FlowNode, N as NodeExecutor, l as LlmRoute } from '../types-B-Syk9-M.cjs';
-export { C as CapabilityId, L as LlmClient, m as LlmRouteChoice, b as LlmRouteRequest, n as TerminalExit, T as TerminalHost, o as TerminalSession, p as TerminalSessionSpec, q as WorkflowResolution, r as WorkflowResolutionFailure, W as WorkflowResolver, s as capabilityStatus, t as getLlmClient, u as getTerminalHost, v as getWorkflowResolver, w as isResolutionFailure, x as registerLlmClient, y as registerTerminalHost, z as registerWorkflowResolver } from '../types-B-Syk9-M.cjs';
+import { N as NodeKindDefinition, P as PortSpec } from '../types-B1jftRa9.cjs';
+export { C as ConfigField, k as CredentialConfigField, D as DocumentConfigField, E as EmitsRelation, l as ExpressionConfigField, J as JsonConfigField, K as KeyValueConfigField, a as NodeCategory, m as NumberConfigField, R as RenderBodyContext, n as RepeaterConfigField, o as RepeaterRowField, p as SelectConfigField, q as SwitchConfigField, T as TextConfigField, r as TextareaConfigField } from '../types-B1jftRa9.cjs';
+import { P as PortDescriptor, a as FlowNode, N as NodeExecutor, l as LlmRoute } from '../types-E48Dpesq.cjs';
+export { C as CapabilityId, L as LlmClient, m as LlmRouteChoice, b as LlmRouteRequest, n as TerminalExit, T as TerminalHost, o as TerminalSession, p as TerminalSessionSpec, q as WorkflowResolution, r as WorkflowResolutionFailure, W as WorkflowResolver, s as capabilityStatus, t as getLlmClient, u as getTerminalHost, v as getWorkflowResolver, w as isResolutionFailure, x as registerLlmClient, y as registerTerminalHost, z as registerWorkflowResolver } from '../types-E48Dpesq.cjs';
 import { Connection, Edge, NodeProps, NodeTypes } from '@xyflow/react';
 export { L as LEGACY_PAUSE_PREFIXES, a as PAUSE_PREFIX, P as PauseAwaiting, b as PauseSignal, d as decodePause, e as encodePause, i as isPause, p as pauseForHuman } from '../pause-9iT4tCEV.cjs';
 import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
-export { K as KindSchemaOverlay, a as KindSchemaOverlayResult, N as NodeKindPresentation, b as applyKindSchemaOverlay, f as categoryAccent, c as clearKindSchemaOverlays, h as clearNodeKindOverrides, d as defaultConfigFor, i as ensureBuiltinKinds, g as getNodeKind, k as kindIds, l as listNodeKinds, o as onNodeKindsChanged, j as overrideNodeKind, r as registerNodeKind, e as resolveKindId, u as unregisterNodeKind, v as validateConfig } from '../registry-B6SiTaLZ.cjs';
+export { K as KindSchemaOverlay, a as KindSchemaOverlayResult, N as NodeKindPresentation, b as applyKindSchemaOverlay, f as categoryAccent, c as clearKindSchemaOverlays, h as clearNodeKindOverrides, d as defaultConfigFor, i as ensureBuiltinKinds, g as getNodeKind, k as kindIds, l as listNodeKinds, o as onNodeKindsChanged, j as overrideNodeKind, r as registerNodeKind, e as resolveKindId, u as unregisterNodeKind, v as validateConfig } from '../registry-DWIY3bMP.cjs';
 
 /**
  * Connection validation — the single rule that decides whether an edge between

package/dist/registry/index.d.ts

@@ -1,12 +1,12 @@
-import { N as NodeKindDefinition, P as PortSpec } from '../types-CbekKMMO.js';
-export { C as ConfigField, k as CredentialConfigField, D as DocumentConfigField, E as EmitsRelation, l as ExpressionConfigField, J as JsonConfigField, K as KeyValueConfigField, a as NodeCategory, m as NumberConfigField, R as RenderBodyContext, n as RepeaterConfigField, o as RepeaterRowField, p as SelectConfigField, q as SwitchConfigField, T as TextConfigField, r as TextareaConfigField } from '../types-CbekKMMO.js';
-import { P as PortDescriptor, a as FlowNode, N as NodeExecutor, l as LlmRoute } from '../types-B-Syk9-M.js';
-export { C as CapabilityId, L as LlmClient, m as LlmRouteChoice, b as LlmRouteRequest, n as TerminalExit, T as TerminalHost, o as TerminalSession, p as TerminalSessionSpec, q as WorkflowResolution, r as WorkflowResolutionFailure, W as WorkflowResolver, s as capabilityStatus, t as getLlmClient, u as getTerminalHost, v as getWorkflowResolver, w as isResolutionFailure, x as registerLlmClient, y as registerTerminalHost, z as registerWorkflowResolver } from '../types-B-Syk9-M.js';
+import { N as NodeKindDefinition, P as PortSpec } from '../types-D5SBBpbe.js';
+export { C as ConfigField, k as CredentialConfigField, D as DocumentConfigField, E as EmitsRelation, l as ExpressionConfigField, J as JsonConfigField, K as KeyValueConfigField, a as NodeCategory, m as NumberConfigField, R as RenderBodyContext, n as RepeaterConfigField, o as RepeaterRowField, p as SelectConfigField, q as SwitchConfigField, T as TextConfigField, r as TextareaConfigField } from '../types-D5SBBpbe.js';
+import { P as PortDescriptor, a as FlowNode, N as NodeExecutor, l as LlmRoute } from '../types-E48Dpesq.js';
+export { C as CapabilityId, L as LlmClient, m as LlmRouteChoice, b as LlmRouteRequest, n as TerminalExit, T as TerminalHost, o as TerminalSession, p as TerminalSessionSpec, q as WorkflowResolution, r as WorkflowResolutionFailure, W as WorkflowResolver, s as capabilityStatus, t as getLlmClient, u as getTerminalHost, v as getWorkflowResolver, w as isResolutionFailure, x as registerLlmClient, y as registerTerminalHost, z as registerWorkflowResolver } from '../types-E48Dpesq.js';
 import { Connection, Edge, NodeProps, NodeTypes } from '@xyflow/react';
 export { L as LEGACY_PAUSE_PREFIXES, a as PAUSE_PREFIX, P as PauseAwaiting, b as PauseSignal, d as decodePause, e as encodePause, i as isPause, p as pauseForHuman } from '../pause-9iT4tCEV.js';
 import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
-export { K as KindSchemaOverlay, a as KindSchemaOverlayResult, N as NodeKindPresentation, b as applyKindSchemaOverlay, f as categoryAccent, c as clearKindSchemaOverlays, h as clearNodeKindOverrides, d as defaultConfigFor, i as ensureBuiltinKinds, g as getNodeKind, k as kindIds, l as listNodeKinds, o as onNodeKindsChanged, j as overrideNodeKind, r as registerNodeKind, e as resolveKindId, u as unregisterNodeKind, v as validateConfig } from '../registry-JUcN_xWK.js';
+export { K as KindSchemaOverlay, a as KindSchemaOverlayResult, N as NodeKindPresentation, b as applyKindSchemaOverlay, f as categoryAccent, c as clearKindSchemaOverlays, h as clearNodeKindOverrides, d as defaultConfigFor, i as ensureBuiltinKinds, g as getNodeKind, k as kindIds, l as listNodeKinds, o as onNodeKindsChanged, j as overrideNodeKind, r as registerNodeKind, e as resolveKindId, u as unregisterNodeKind, v as validateConfig } from '../registry-C4GcH583.js';
 
 /**
  * Connection validation — the single rule that decides whether an edge between

package/dist/{registry-JUcN_xWK.d.ts → registry-C4GcH583.d.ts}

@@ -1,4 +1,4 @@
-import { C as ConfigField, a as NodeCategory, N as NodeKindDefinition } from './types-CbekKMMO.js';
+import { C as ConfigField, a as NodeCategory, N as NodeKindDefinition } from './types-D5SBBpbe.js';
 
 /**
  * Put the builtin kit in the registry before anyone reads or writes it.

package/dist/{registry-B6SiTaLZ.d.cts → registry-DWIY3bMP.d.cts}

@@ -1,4 +1,4 @@
-import { C as ConfigField, a as NodeCategory, N as NodeKindDefinition } from './types-BdkXxjFh.cjs';
+import { C as ConfigField, a as NodeCategory, N as NodeKindDefinition } from './types-B1jftRa9.cjs';
 
 /**
  * Put the builtin kit in the registry before anyone reads or writes it.

package/dist/registry.cjs

@@ -784,6 +784,9 @@ async function runFlow(graph, executors, onEvent = () => {
             executors,
             depth,
             run,
+            // Structural executors derive a nested lane from the graph they are
+            // in; `for_each`'s `item` port cannot be implemented without it.
+            graph,
             terminal: terminalAccessorFor(node)
           })
         );
@@ -1282,14 +1285,102 @@ var mergeExecutor = (ctx) => {
   }
   return merged;
 };
-var forEachExecutor = (ctx) => {
-  const source = resolve(configOf(ctx.node).source, ctx.inputs);
+var FOR_EACH_DEFAULT_MAX_ITEMS = 1e3;
+var FOR_EACH_HARD_MAX_ITEMS = 1e4;
+function reachable(adjacency, starts) {
+  const seen = /* @__PURE__ */ new Set();
+  const queue = [...starts];
+  for (let cursor = 0; cursor < queue.length; cursor += 1) {
+    const id2 = queue[cursor];
+    if (seen.has(id2)) continue;
+    seen.add(id2);
+    for (const target of adjacency.get(id2) ?? []) queue.push(target);
+  }
+  return seen;
+}
+function forEachLane(graph, nodeId) {
+  const handleOf = (edge) => edge.sourceHandle ?? "out";
+  const itemEdges = graph.edges.filter((e) => e.source === nodeId && handleOf(e) === "item");
+  if (itemEdges.length === 0) return null;
+  const adjacency = /* @__PURE__ */ new Map();
+  for (const edge of graph.edges) {
+    const list = adjacency.get(edge.source) ?? [];
+    list.push(edge.target);
+    adjacency.set(edge.source, list);
+  }
+  const done = reachable(
+    adjacency,
+    graph.edges.filter((e) => e.source === nodeId && handleOf(e) === "done").map((e) => e.target)
+  );
+  const body = new Set(
+    [...reachable(adjacency, itemEdges.map((e) => e.target))].filter(
+      (id2) => !done.has(id2) && id2 !== nodeId
+    )
+  );
+  return {
+    graph: {
+      nodes: graph.nodes.filter((n) => body.has(n.id)),
+      edges: graph.edges.filter((e) => body.has(e.source) && body.has(e.target)),
+      ...graph.inputs === void 0 ? {} : { inputs: graph.inputs }
+    },
+    entries: itemEdges.filter((e) => body.has(e.target))
+  };
+}
+var forEachExecutor = async (ctx) => {
+  const config = configOf(ctx.node);
+  const source = resolve(config.source, ctx.inputs);
   let items;
   if (Array.isArray(source)) items = source;
   else if (source === null || source === void 0) items = [];
   else if (typeof source === "object") items = Object.values(source);
   else items = [source];
-  return { items, count: items.length };
+  const lane = ctx.graph ? forEachLane(ctx.graph, ctx.node.id) : null;
+  if (lane === null || config.mode === "collect") {
+    return { items, count: items.length };
+  }
+  if (lane.graph.nodes.length === 0) {
+    ctx.abort(`for_each "${ctx.node.id}" has an item edge but its derived lane is empty`);
+  }
+  const maxItems = Number(config.maxItems ?? FOR_EACH_DEFAULT_MAX_ITEMS);
+  if (!Number.isFinite(maxItems) || maxItems < 1 || maxItems > FOR_EACH_HARD_MAX_ITEMS) {
+    ctx.abort(`for_each "${ctx.node.id}" maxItems must be between 1 and ${FOR_EACH_HARD_MAX_ITEMS}`);
+  }
+  if (items.length > maxItems) {
+    ctx.abort(
+      `for_each "${ctx.node.id}" resolved ${items.length} items exceeds its maxItems cap of ${maxItems}`
+    );
+  }
+  const results = [];
+  const failures = [];
+  for (const [index2, item] of items.entries()) {
+    const initialInputs = {};
+    for (const edge of lane.entries) {
+      initialInputs[edge.target] = {
+        ...initialInputs[edge.target] ?? {},
+        [edge.targetHandle ?? "in"]: item
+      };
+    }
+    const nested = await runFlow(lane.graph, { ...ctx.executors ?? {} }, () => {
+    }, {
+      initialInputs,
+      depth: (ctx.depth ?? 0) + 1,
+      // The index rides on the identity, so a node in iteration 3 cannot share
+      // an idempotency key with the same node in iteration 4.
+      run: ctx.run?.descend(ctx.node.id, index2)
+    });
+    if (!nested.ok) {
+      const reason = nested.error ?? "unknown error";
+      if (decodePause(reason)) ctx.abort(reason);
+      results.push(null);
+      failures.push({ index: index2, item, error: reason });
+      continue;
+    }
+    results.push(nested.outputs);
+  }
+  return {
+    __port: "done",
+    value: { items, results, failures, count: items.length }
+  };
 };
 var manualTriggerExecutor = (ctx) => ctx.inputs;
 var outputExecutor = (ctx) => {
@@ -1846,6 +1937,15 @@ var KINDS = [
     name: "@particle-academy/for_each",
     outputShape: [
       { path: "items", type: "array" },
+      // `results` and `failures` are the WIRED shape -- what a lane produces
+      // when the `item` port is connected. Declared unconditionally because a
+      // declaration describes the kind, not one graph's use of it, and because
+      // the shared table requires them: fancy-conformance 0.30.0 added
+      // `results` and 0.31.0 added `failures`, both BREAKING, both so that a
+      // runtime which has not implemented iteration fails here rather than
+      // reporting surface parity it does not have.
+      { path: "results", type: "array" },
+      { path: "failures", type: "array" },
       { path: "count", type: "number" }
     ],
     aliases: ["for_each", "@fancy/for_each"],
@@ -1854,7 +1954,7 @@ var KINDS = [
     executor: forEachExecutor,
     category: "logic",
     label: "For Each",
-    description: "Iterate over a list, emitting each item on `item`.",
+    description: "Wire `item` to a lane and it runs once per item, aggregating `results` and `failures` on `done`. Leave `item` unwired (or set `mode: collect`) and it just publishes the list and its size -- one node, one checkpoint.",
     icon: "\u21BB",
     inputs: [{ id: "in" }],
     outputs: [{ id: "item", label: "item" }, { id: "done", label: "done" }],