@particle-academy/fancy-flow 0.45.0 → 0.47.0

package/dist/registry.js

@@ -1,10 +1,7 @@
-export { ANY_PORT_TYPE, BUILTIN_KINDS, DEFAULT_MAX_DEPTH, RegistryNode, buildNodeTypes, createConnectionValidator, declaredRoutes, defaultPortCompatibility, llmRouterExecutor as llmBranchExecutor, llmRouterExecutor, registerBuiltinKinds, resolveFallbackPort, subflowExecutor, subflowMode, subflowPorts } from './chunk-WBXGZVLB.js';
-import './chunk-OWENS2H5.js';
+export { ANY_PORT_TYPE, RegistryNode, buildNodeTypes, createConnectionValidator, defaultPortCompatibility } from './chunk-DR3GWVDG.js';
 export { LEGACY_PAUSE_PREFIXES, PAUSE_PREFIX, decodePause, encodePause, isPause, pauseForHuman } from './chunk-UEOE6B52.js';
-export { capabilityStatus, getLlmClient, getWorkflowResolver, isResolutionFailure, registerLlmClient, registerWorkflowResolver } from './chunk-USL4FMFU.js';
-import './chunk-VLATLVGH.js';
-export { nodeConfig, resolveNodePorts, resolvePortSpec } from './chunk-TITD5W4Y.js';
-export { categoryAccent, clearNodeKindOverrides, defaultConfigFor, getNodeKind, kindIds, listNodeKinds, onNodeKindsChanged, overrideNodeKind, registerNodeKind, resolveKindId, validateConfig } from './chunk-PVROYW7C.js';
+export { BUILTIN_KINDS, DEFAULT_MAX_DEPTH, categoryAccent, clearNodeKindOverrides, declaredRoutes, defaultConfigFor, ensureBuiltinKinds, getNodeKind, kindIds, listNodeKinds, llmRouterExecutor as llmBranchExecutor, llmRouterExecutor, nodeConfig, onNodeKindsChanged, overrideNodeKind, registerBuiltinKinds, registerNodeKind, resolveFallbackPort, resolveKindId, resolveNodePorts, resolvePortSpec, subflowExecutor, subflowMode, subflowPorts, validateConfig } from './chunk-NDEX655E.js';
 export { RichInputPreview, getRichInputAdapter, isRichInputEnabled, onRichInputAdapterChanged, registerRichInputAdapter } from './chunk-F5RPRB7A.js';
+export { capabilityStatus, getLlmClient, getWorkflowResolver, isResolutionFailure, registerLlmClient, registerWorkflowResolver } from './chunk-USL4FMFU.js';
 //# sourceMappingURL=registry.js.map
 //# sourceMappingURL=registry.js.map

package/dist/{run-cohort-CV7EcwGG.d.ts → run-cohort-Cyeny2Uu.d.ts}

@@ -1,36 +1,5 @@
-import { F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-CMSrWVYM.js';
-
-type RunOptions = {
-    /** Stop the run after this many ms. Default: no timeout. */
-    timeoutMs?: number;
-    /** Abort signal — host can cancel the run. */
-    signal?: AbortSignal;
-    /** Initial inputs supplied to entry-point nodes (no incoming edges). */
-    initialInputs?: Record<string, Record<string, unknown>>;
-    /** Nesting depth — set by `subflow` when it runs a child graph. */
-    depth?: number;
-};
-type RunResult = {
-    ok: boolean;
-    /** Outputs collected per node, keyed by node id. */
-    outputs: Record<string, unknown>;
-    /** Error captured if any node threw. */
-    error?: string;
-};
-/**
- * runFlow — topological execution of a FlowGraph against an ExecutorRegistry.
- *
- * Each node runs once, when all upstream nodes have produced outputs on the
- * connected ports. Decision nodes (or any executor that returns `{ branch:
- * 'true' }`) can short-circuit specific output ports — only edges leaving
- * an "active" port propagate to downstream nodes.
- *
- * Cycles are detected and abort the run with an error.
- *
- * The `onEvent` callback receives a stream of `RunEvent`s — wire it to a
- * status feed, log panel, or store.
- */
-declare function runFlow(graph: FlowGraph, executors: ExecutorRegistry, onEvent?: (event: RunEvent) => void, options?: RunOptions): Promise<RunResult>;
+import { F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-Jx1TwehV.js';
+import { R as RunOptions, a as RunResult } from './run-flow-CQvTDBYk.js';
 
 /**
  * How the flows one trigger fired should treat each other.
@@ -108,4 +77,4 @@ type CohortResult = RunResult & {
  */
 declare function runCohort(flows: FlowGraph[], executors: ExecutorRegistry, onEvent?: (event: RunEvent, index: number) => void, options?: CohortOptions): Promise<CohortResult[]>;
 
-export { type CohortGuard as C, type RunOptions as R, type CohortOptions as a, type CohortPolicy as b, type CohortResult as c, type RunResult as d, runFlow as e, runCohort as r };
+export { type CohortGuard as C, type CohortOptions as a, type CohortPolicy as b, type CohortResult as c, runCohort as r };

package/dist/{run-cohort-DitsaYgS.d.cts → run-cohort-DdPPowJ3.d.cts}

@@ -1,36 +1,5 @@
-import { F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-CMSrWVYM.cjs';
-
-type RunOptions = {
-    /** Stop the run after this many ms. Default: no timeout. */
-    timeoutMs?: number;
-    /** Abort signal — host can cancel the run. */
-    signal?: AbortSignal;
-    /** Initial inputs supplied to entry-point nodes (no incoming edges). */
-    initialInputs?: Record<string, Record<string, unknown>>;
-    /** Nesting depth — set by `subflow` when it runs a child graph. */
-    depth?: number;
-};
-type RunResult = {
-    ok: boolean;
-    /** Outputs collected per node, keyed by node id. */
-    outputs: Record<string, unknown>;
-    /** Error captured if any node threw. */
-    error?: string;
-};
-/**
- * runFlow — topological execution of a FlowGraph against an ExecutorRegistry.
- *
- * Each node runs once, when all upstream nodes have produced outputs on the
- * connected ports. Decision nodes (or any executor that returns `{ branch:
- * 'true' }`) can short-circuit specific output ports — only edges leaving
- * an "active" port propagate to downstream nodes.
- *
- * Cycles are detected and abort the run with an error.
- *
- * The `onEvent` callback receives a stream of `RunEvent`s — wire it to a
- * status feed, log panel, or store.
- */
-declare function runFlow(graph: FlowGraph, executors: ExecutorRegistry, onEvent?: (event: RunEvent) => void, options?: RunOptions): Promise<RunResult>;
+import { F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-Jx1TwehV.cjs';
+import { R as RunOptions, a as RunResult } from './run-flow-1KiXhy59.cjs';
 
 /**
  * How the flows one trigger fired should treat each other.
@@ -108,4 +77,4 @@ type CohortResult = RunResult & {
  */
 declare function runCohort(flows: FlowGraph[], executors: ExecutorRegistry, onEvent?: (event: RunEvent, index: number) => void, options?: CohortOptions): Promise<CohortResult[]>;
 
-export { type CohortGuard as C, type RunOptions as R, type CohortOptions as a, type CohortPolicy as b, type CohortResult as c, type RunResult as d, runFlow as e, runCohort as r };
+export { type CohortGuard as C, type CohortOptions as a, type CohortPolicy as b, type CohortResult as c, runCohort as r };

package/dist/run-flow-1KiXhy59.d.cts

@@ -0,0 +1,55 @@
+import { b as RunIdentity, c as RunIdentityJson, F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-Jx1TwehV.cjs';
+
+type RunOptions = {
+    /** Stop the run after this many ms. Default: no timeout. */
+    timeoutMs?: number;
+    /** Abort signal — host can cancel the run. */
+    signal?: AbortSignal;
+    /** Initial inputs supplied to entry-point nodes (no incoming edges). */
+    initialInputs?: Record<string, Record<string, unknown>>;
+    /** Nesting depth — set by `subflow` when it runs a child graph. */
+    depth?: number;
+    /**
+     * Who is running, so a writing node can derive a stable idempotency key.
+     *
+     * A bare string is taken as the run key. **Deliberately not defaulted:** a
+     * minted-per-call key would change on every whole-run retry, which is exactly
+     * the failure an idempotency key exists to prevent — so a host that has not
+     * supplied one gets `ctx.run === undefined` and a connector that declines to
+     * write blind, rather than a plausible-looking key that double-charges.
+     */
+    run?: RunIdentity | RunIdentityJson | string;
+    /**
+     * Outputs already checkpointed for this run, keyed by node id.
+     *
+     * A node present here is **republished, not re-executed** — its stored value
+     * goes back onto the same ports, so downstream routing reproduces exactly
+     * what it did the first time. This is what makes a per-node durable driver
+     * possible without a second copy of the routing rules, and it is how the PHP
+     * and Python runtimes have always resumed.
+     */
+    resumeOutputs?: Record<string, unknown>;
+};
+type RunResult = {
+    ok: boolean;
+    /** Outputs collected per node, keyed by node id. */
+    outputs: Record<string, unknown>;
+    /** Error captured if any node threw. */
+    error?: string;
+};
+/**
+ * runFlow — topological execution of a FlowGraph against an ExecutorRegistry.
+ *
+ * Each node runs once, when all upstream nodes have produced outputs on the
+ * connected ports. Decision nodes (or any executor that returns `{ branch:
+ * 'true' }`) can short-circuit specific output ports — only edges leaving
+ * an "active" port propagate to downstream nodes.
+ *
+ * Cycles are detected and abort the run with an error.
+ *
+ * The `onEvent` callback receives a stream of `RunEvent`s — wire it to a
+ * status feed, log panel, or store.
+ */
+declare function runFlow(graph: FlowGraph, executors: ExecutorRegistry, onEvent?: (event: RunEvent) => void, options?: RunOptions): Promise<RunResult>;
+
+export { type RunOptions as R, type RunResult as a, runFlow as r };

package/dist/run-flow-CQvTDBYk.d.ts

@@ -0,0 +1,55 @@
+import { b as RunIdentity, c as RunIdentityJson, F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-Jx1TwehV.js';
+
+type RunOptions = {
+    /** Stop the run after this many ms. Default: no timeout. */
+    timeoutMs?: number;
+    /** Abort signal — host can cancel the run. */
+    signal?: AbortSignal;
+    /** Initial inputs supplied to entry-point nodes (no incoming edges). */
+    initialInputs?: Record<string, Record<string, unknown>>;
+    /** Nesting depth — set by `subflow` when it runs a child graph. */
+    depth?: number;
+    /**
+     * Who is running, so a writing node can derive a stable idempotency key.
+     *
+     * A bare string is taken as the run key. **Deliberately not defaulted:** a
+     * minted-per-call key would change on every whole-run retry, which is exactly
+     * the failure an idempotency key exists to prevent — so a host that has not
+     * supplied one gets `ctx.run === undefined` and a connector that declines to
+     * write blind, rather than a plausible-looking key that double-charges.
+     */
+    run?: RunIdentity | RunIdentityJson | string;
+    /**
+     * Outputs already checkpointed for this run, keyed by node id.
+     *
+     * A node present here is **republished, not re-executed** — its stored value
+     * goes back onto the same ports, so downstream routing reproduces exactly
+     * what it did the first time. This is what makes a per-node durable driver
+     * possible without a second copy of the routing rules, and it is how the PHP
+     * and Python runtimes have always resumed.
+     */
+    resumeOutputs?: Record<string, unknown>;
+};
+type RunResult = {
+    ok: boolean;
+    /** Outputs collected per node, keyed by node id. */
+    outputs: Record<string, unknown>;
+    /** Error captured if any node threw. */
+    error?: string;
+};
+/**
+ * runFlow — topological execution of a FlowGraph against an ExecutorRegistry.
+ *
+ * Each node runs once, when all upstream nodes have produced outputs on the
+ * connected ports. Decision nodes (or any executor that returns `{ branch:
+ * 'true' }`) can short-circuit specific output ports — only edges leaving
+ * an "active" port propagate to downstream nodes.
+ *
+ * Cycles are detected and abort the run with an error.
+ *
+ * The `onEvent` callback receives a stream of `RunEvent`s — wire it to a
+ * status feed, log panel, or store.
+ */
+declare function runFlow(graph: FlowGraph, executors: ExecutorRegistry, onEvent?: (event: RunEvent) => void, options?: RunOptions): Promise<RunResult>;
+
+export { type RunOptions as R, type RunResult as a, runFlow as r };

package/dist/runtime/index.d.cts

@@ -1,6 +1,8 @@
-import { d as RunResult, R as RunOptions } from '../run-cohort-DitsaYgS.cjs';
-export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort, e as runFlow } from '../run-cohort-DitsaYgS.cjs';
-import { e as NodeRunStatus, F as FlowGraph, E as ExecutorRegistry, a as FlowNode, b as FlowEdge } from '../types-CMSrWVYM.cjs';
+import { a as RunResult, R as RunOptions } from '../run-flow-1KiXhy59.cjs';
+export { r as runFlow } from '../run-flow-1KiXhy59.cjs';
+import { g as NodeRunStatus, F as FlowGraph, E as ExecutorRegistry, a as FlowNode, d as FlowEdge } from '../types-Jx1TwehV.cjs';
+export { b as RunIdentity, c as RunIdentityJson, i as escapeSegment } from '../types-Jx1TwehV.cjs';
+export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from '../run-cohort-DdPPowJ3.cjs';
 import { NodeChange, EdgeChange, Connection } from '@xyflow/react';
 
 type FlowRunFeedEntry = {

package/dist/runtime/index.d.ts

@@ -1,6 +1,8 @@
-import { d as RunResult, R as RunOptions } from '../run-cohort-CV7EcwGG.js';
-export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort, e as runFlow } from '../run-cohort-CV7EcwGG.js';
-import { e as NodeRunStatus, F as FlowGraph, E as ExecutorRegistry, a as FlowNode, b as FlowEdge } from '../types-CMSrWVYM.js';
+import { a as RunResult, R as RunOptions } from '../run-flow-CQvTDBYk.js';
+export { r as runFlow } from '../run-flow-CQvTDBYk.js';
+import { g as NodeRunStatus, F as FlowGraph, E as ExecutorRegistry, a as FlowNode, d as FlowEdge } from '../types-Jx1TwehV.js';
+export { b as RunIdentity, c as RunIdentityJson, i as escapeSegment } from '../types-Jx1TwehV.js';
+export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from '../run-cohort-Cyeny2Uu.js';
 import { NodeChange, EdgeChange, Connection } from '@xyflow/react';
 
 type FlowRunFeedEntry = {