@particle-academy/fancy-flow 0.53.0 → 0.55.0

package/dist/registry.js

@@ -1,6 +1,6 @@
-export { ANY_PORT_TYPE, RegistryNode, buildNodeTypes, createConnectionValidator, defaultPortCompatibility } from './chunk-VWANLNL5.js';
+export { ANY_PORT_TYPE, RegistryNode, buildNodeTypes, createConnectionValidator, defaultPortCompatibility } from './chunk-E3AGYTHP.js';
 export { LEGACY_PAUSE_PREFIXES, PAUSE_PREFIX, decodePause, encodePause, isPause, pauseForHuman } from './chunk-UEOE6B52.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-CIBW5ATA.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-22OJOD4X.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

package/dist/{run-cohort-BPIOpE8A.d.ts → run-cohort-C1nRh_mi.d.ts}

@@ -1,5 +1,5 @@
 import { F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-JFYjPJAG.js';
-import { R as RunOptions, a as RunResult } from './run-flow-DJ7KYT6E.js';
+import { R as RunOptions, a as RunResult } from './run-flow-D7AOCcfE.js';
 
 /**
  * How the flows one trigger fired should treat each other.

package/dist/{run-cohort-r-L8dMED.d.cts → run-cohort-CBRAUj-z.d.cts}

@@ -1,5 +1,5 @@
 import { F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-JFYjPJAG.cjs';
-import { R as RunOptions, a as RunResult } from './run-flow-COdAOFg2.cjs';
+import { R as RunOptions, a as RunResult } from './run-flow-2XsHBwpd.cjs';
 
 /**
  * How the flows one trigger fired should treat each other.

package/dist/{run-flow-COdAOFg2.d.cts → run-flow-2XsHBwpd.d.cts}

@@ -16,6 +16,37 @@ type RunOptions = {
      * `graph.inputs`, so a misspelling fails the run instead of sitting unread.
      */
     props?: Record<string, unknown>;
+    /**
+     * Which ENTRY POINTS are live — the ids of nodes with NO incoming edges this
+     * run should start from. Omit it and every entry point runs, exactly as
+     * before the option existed.
+     *
+     * A graph may hold more than one trigger — a `manual_trigger` for
+     * hand-testing beside the event trigger that runs it for real — and a trigger
+     * has no inbound edges, which IS the readiness rule. So without this, every
+     * trigger's branch runs on every run, whichever one fired. The triggers
+     * themselves are harmless; everything DOWNSTREAM of the ones that did not
+     * fire is not. A `user_input` stranded on the manual branch parks an
+     * event-driven run to ask a person for data the event already supplied,
+     * which from outside looks like the event trigger being ignored.
+     *
+     * Naming the live entry points makes the others INACTIVE, and the existing
+     * "at least one active inbound edge" rule then skips everything reachable
+     * only from them. No new routing logic.
+     *
+     * Three edges, each pinned by `flow/entry-points` in
+     * `@particle-academy/fancy-conformance`:
+     *  - `undefined` is NOT `[]`. Unset runs every entry point; an empty array
+     *    says none is live and runs nothing.
+     *  - A node reachable from SEVERAL entry points still runs when any one of
+     *    them fires — one active inbound edge is enough, as always.
+     *  - Naming a node that HAS inbound edges names no entry point, so every real
+     *    entry is inactive and nothing runs. That falls out of the rule rather
+     *    than being special-cased; validate your ids if you want a typo to be
+     *    loud, because the runtime cannot tell one from a deliberate empty
+     *    selection.
+     */
+    entryNodes?: string[];
     /** Nesting depth — set by `subflow` when it runs a child graph. */
     depth?: number;
     /**

package/dist/{run-flow-DJ7KYT6E.d.ts → run-flow-D7AOCcfE.d.ts}

@@ -16,6 +16,37 @@ type RunOptions = {
      * `graph.inputs`, so a misspelling fails the run instead of sitting unread.
      */
     props?: Record<string, unknown>;
+    /**
+     * Which ENTRY POINTS are live — the ids of nodes with NO incoming edges this
+     * run should start from. Omit it and every entry point runs, exactly as
+     * before the option existed.
+     *
+     * A graph may hold more than one trigger — a `manual_trigger` for
+     * hand-testing beside the event trigger that runs it for real — and a trigger
+     * has no inbound edges, which IS the readiness rule. So without this, every
+     * trigger's branch runs on every run, whichever one fired. The triggers
+     * themselves are harmless; everything DOWNSTREAM of the ones that did not
+     * fire is not. A `user_input` stranded on the manual branch parks an
+     * event-driven run to ask a person for data the event already supplied,
+     * which from outside looks like the event trigger being ignored.
+     *
+     * Naming the live entry points makes the others INACTIVE, and the existing
+     * "at least one active inbound edge" rule then skips everything reachable
+     * only from them. No new routing logic.
+     *
+     * Three edges, each pinned by `flow/entry-points` in
+     * `@particle-academy/fancy-conformance`:
+     *  - `undefined` is NOT `[]`. Unset runs every entry point; an empty array
+     *    says none is live and runs nothing.
+     *  - A node reachable from SEVERAL entry points still runs when any one of
+     *    them fires — one active inbound edge is enough, as always.
+     *  - Naming a node that HAS inbound edges names no entry point, so every real
+     *    entry is inactive and nothing runs. That falls out of the rule rather
+     *    than being special-cased; validate your ids if you want a typo to be
+     *    loud, because the runtime cannot tell one from a deliberate empty
+     *    selection.
+     */
+    entryNodes?: string[];
     /** Nesting depth — set by `subflow` when it runs a child graph. */
     depth?: number;
     /**

package/dist/runtime/index.d.cts

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

package/dist/runtime/index.d.ts

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

package/dist/runtime.cjs

@@ -10383,7 +10383,7 @@ function resolveWorkflowProps(declared, passed) {
 // src/runtime/run-flow.ts
 async function runFlow(graph, executors, onEvent = () => {
 }, options = {}) {
-  const { signal, initialInputs = {}, timeoutMs, depth = 0, resumeOutputs = {} } = options;
+  const { signal, initialInputs = {}, timeoutMs, depth = 0, resumeOutputs = {}, entryNodes } = options;
   const run = options.run === void 0 ? void 0 : RunIdentity.from(options.run);
   const outputs = {};
   const portValues = /* @__PURE__ */ new Map();
@@ -10422,6 +10422,10 @@ async function runFlow(graph, executors, onEvent = () => {
         continue;
       }
       const incoming = incomingByNode.get(node.id) ?? [];
+      if (incoming.length === 0 && entryNodes !== void 0 && !entryNodes.includes(node.id)) {
+        onEvent({ type: "node-status", nodeId: node.id, status: "idle", text: "skipped" });
+        continue;
+      }
       if (incoming.length > 0) {
         const anyActive = incoming.some((e) => portValues.has(`${e.source}:${e.sourceHandle ?? "out"}`));
         if (!anyActive) {