flowneer 0.9.1 → 0.9.2

package/dist/{FlowBuilder-CqWK42bA.d.ts → FlowBuilder-G67AbbRt.d.ts}

@@ -62,7 +62,7 @@ interface RunOptions {
 /** Metadata exposed to hooks — intentionally minimal to avoid coupling. */
 interface StepMeta {
     index: number;
-    type: "fn" | "branch" | "loop" | "batch" | "parallel" | "anchor";
+    type: "fn" | "branch" | "loop" | "batch" | "parallel" | "anchor" | "dag";
     label?: string;
 }
 /**
@@ -166,7 +166,35 @@ interface AnchorStep {
     /** Maximum number of times a goto may jump to this anchor per run. */
     maxVisits?: number;
 }
-type Step<S, P extends Record<string, unknown>> = FnStep<S, P> | BranchStep<S, P> | LoopStep<S, P> | BatchStep<S, P> | ParallelStep<S, P> | AnchorStep;
+/**
+ * A compiled DAG step. Produced by the graph plugin's `.compile()` and
+ * executed by the registered "dag" step handler, which traverses nodes
+ * in topological order and fires per-node lifecycle hooks natively.
+ */
+interface DagStep<S, P extends Record<string, unknown>> {
+    type: "dag";
+    nodes: Map<string, {
+        name: string;
+        fn: NodeFn<S, P>;
+        options?: NodeOptions<S, P>;
+    }>;
+    /** Topologically sorted node names. */
+    order: string[];
+    /** Conditional edges that point backwards (cycles). Always have a condition. */
+    backEdges: Array<{
+        from: string;
+        to: string;
+        condition: (shared: S, params: P) => boolean | Promise<boolean>;
+    }>;
+    /** Conditional edges that skip forward (not back-edges). Always have a condition. */
+    conditionalForward: Array<{
+        from: string;
+        to: string;
+        condition: (shared: S, params: P) => boolean | Promise<boolean>;
+    }>;
+    label?: string;
+}
+type Step<S, P extends Record<string, unknown>> = FnStep<S, P> | BranchStep<S, P> | LoopStep<S, P> | BatchStep<S, P> | ParallelStep<S, P> | AnchorStep | DagStep<S, P>;
 
 type ResolvedHooks<S, P extends Record<string, unknown>> = {
     beforeFlow: NonNullable<FlowHooks<S, P>["beforeFlow"]>[];
@@ -212,17 +240,30 @@ declare class CoreFlowBuilder<S = any, P extends Record<string, unknown> = Recor
     private _hooksList;
     private _hooksCache;
     private static _stepHandlers;
+    /**
+     * Step types registered with `{ transparent: true }` are invoked directly
+     * by `_execute` without wrapping in the outer beforeStep/wrapStep/afterStep
+     * lifecycle. Use this for step types that manage per-item lifecycle
+     * internally (e.g. a DAG handler that fires hooks once per graph node).
+     */
+    private static _transparentSteps;
     /**
      * Register a handler for a custom step type.
      * Called once at module load time from each step plugin.
      *
+     * Pass `{ transparent: true }` when the handler manages its own per-item
+     * lifecycle hooks internally and should not be wrapped by the outer
+     * beforeStep / wrapStep / afterStep guards.
+     *
      * @example
      * CoreFlowBuilder.registerStepType("myStep", async (step, ctx) => {
      *   await doWork(ctx.shared);
      *   return undefined;
      * });
      */
-    static registerStepType(type: string, handler: StepHandler): void;
+    static registerStepType(type: string, handler: StepHandler, options?: {
+        transparent?: boolean;
+    }): void;
     private _hooks;
     /**
      * Register lifecycle hooks (called by plugin methods, not by consumers).
@@ -354,4 +395,4 @@ declare class FlowBuilder<S = any, P extends Record<string, unknown> = Record<st
     private _addFn;
 }
 
-export { type AnchorStep as A, type BatchStep as B, CoreFlowBuilder as C, FlowBuilder as F, type LoopStep as L, type NodeFn as N, type ParallelStep as P, type ResolvedHooks as R, type StepFilter as S, type Validator as V, type FlowneerPlugin as a, type NodeOptions as b, type FlowHooks as c, type StepMeta as d, type BranchStep as e, type FnStep as f, type NumberOrFn as g, type RunOptions as h, type Step as i, type StepContext as j, type StepHandler as k, type StreamEvent as l };
+export { type AnchorStep as A, type BatchStep as B, CoreFlowBuilder as C, type DagStep as D, FlowBuilder as F, type LoopStep as L, type NodeFn as N, type ParallelStep as P, type ResolvedHooks as R, type StepFilter as S, type Validator as V, type FlowneerPlugin as a, type NodeOptions as b, type FlowHooks as c, type StepMeta as d, type BranchStep as e, type FnStep as f, type NumberOrFn as g, type RunOptions as h, type Step as i, type StepContext as j, type StepHandler as k, type StreamEvent as l };

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { F as FlowBuilder, c as FlowHooks, a as FlowneerPlugin, N as NodeFn, b as NodeOptions, g as NumberOrFn, h as RunOptions, d as StepMeta, l as StreamEvent, V as Validator } from './FlowBuilder-CqWK42bA.js';
+export { F as FlowBuilder, c as FlowHooks, a as FlowneerPlugin, N as NodeFn, b as NodeOptions, g as NumberOrFn, h as RunOptions, d as StepMeta, l as StreamEvent, V as Validator } from './FlowBuilder-G67AbbRt.js';
 export { Fragment, fragment } from './src/index.js';
 export { F as FlowError, I as InterruptError } from './errors-u-hq7p5N.js';

package/dist/index.js

@@ -122,18 +122,30 @@ var CoreFlowBuilder = class _CoreFlowBuilder {
   // Step-type registry (static — shared across all instances)
   // -------------------------------------------------------------------------
   static _stepHandlers = /* @__PURE__ */ new Map();
+  /**
+   * Step types registered with `{ transparent: true }` are invoked directly
+   * by `_execute` without wrapping in the outer beforeStep/wrapStep/afterStep
+   * lifecycle. Use this for step types that manage per-item lifecycle
+   * internally (e.g. a DAG handler that fires hooks once per graph node).
+   */
+  static _transparentSteps = /* @__PURE__ */ new Set();
   /**
    * Register a handler for a custom step type.
    * Called once at module load time from each step plugin.
    *
+   * Pass `{ transparent: true }` when the handler manages its own per-item
+   * lifecycle hooks internally and should not be wrapped by the outer
+   * beforeStep / wrapStep / afterStep guards.
+   *
    * @example
    * CoreFlowBuilder.registerStepType("myStep", async (step, ctx) => {
    *   await doWork(ctx.shared);
    *   return undefined;
    * });
    */
-  static registerStepType(type, handler) {
+  static registerStepType(type, handler, options) {
     _CoreFlowBuilder._stepHandlers.set(type, handler);
+    if (options?.transparent) _CoreFlowBuilder._transparentSteps.add(type);
   }
   // -------------------------------------------------------------------------
   // Hooks & plugins
@@ -263,6 +275,25 @@ var CoreFlowBuilder = class _CoreFlowBuilder {
       signal?.throwIfAborted();
       const step = this.steps[i];
       if (step.type === "anchor") continue;
+      if (_CoreFlowBuilder._transparentSteps.has(step.type)) {
+        const handler = _CoreFlowBuilder._stepHandlers.get(step.type);
+        if (handler) {
+          const meta2 = {
+            index: i,
+            type: step.type,
+            label: step.label
+          };
+          await handler(step, {
+            shared,
+            params,
+            signal,
+            hooks,
+            meta: meta2,
+            builder: this
+          });
+        }
+        continue;
+      }
       const stepLabel = step.label;
       const meta = {
         index: i,

package/dist/plugins/agent/index.d.ts

@@ -1,4 +1,4 @@
-import { F as FlowBuilder, a as FlowneerPlugin } from '../../FlowBuilder-CqWK42bA.js';
+import { F as FlowBuilder, a as FlowneerPlugin } from '../../FlowBuilder-G67AbbRt.js';
 
 interface HumanNodeOptions<S = any, P extends Record<string, unknown> = Record<string, unknown>> {
     /**

package/dist/plugins/dev/index.d.ts

@@ -1,4 +1,4 @@
-import { a as FlowneerPlugin, N as NodeFn, b as NodeOptions, S as StepFilter } from '../../FlowBuilder-CqWK42bA.js';
+import { a as FlowneerPlugin, N as NodeFn, b as NodeOptions, S as StepFilter } from '../../FlowBuilder-G67AbbRt.js';
 
 declare module "../../Flowneer" {
     interface FlowBuilder<S, P> {

package/dist/plugins/eval/index.d.ts

@@ -1,4 +1,4 @@
-import { F as FlowBuilder } from '../../FlowBuilder-CqWK42bA.js';
+import { F as FlowBuilder } from '../../FlowBuilder-G67AbbRt.js';
 
 /** Case-insensitive exact match. Returns 1.0 or 0.0. */
 declare function exactMatch(predicted: string, expected: string): number;

package/dist/plugins/graph/index.d.ts

@@ -1,4 +1,4 @@
-import { a as FlowneerPlugin, N as NodeFn, b as NodeOptions } from '../../FlowBuilder-CqWK42bA.js';
+import { a as FlowneerPlugin, N as NodeFn, b as NodeOptions } from '../../FlowBuilder-G67AbbRt.js';
 
 /** A single node entry in the exported graph. */
 interface GraphNodeExport {