flowneer 0.9.2 → 0.9.5

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

@@ -1,3 +1,17 @@
+/**
+ * Extendable shared-state interface augmented by each plugin via declaration
+ * merging. Extend your state type with this to get all plugin-provided keys
+ * typed and documented automatically — no manual `__*` declarations needed.
+ *
+ * @example
+ * import type { AugmentedState } from "flowneer";
+ * interface MyState extends AugmentedState {
+ *   topic: string;
+ *   results: string[];
+ * }
+ */
+interface AugmentedState {
+}
 /**
  * Generic validator interface — structurally compatible with Zod, ArkType,
  * Valibot, or any custom implementation that exposes `.parse(input)`.
@@ -72,6 +86,11 @@ interface StepMeta {
  *   Entries are exact matches unless they contain `*`, which acts as a
  *   wildcard matching any substring (glob-style).
  *   e.g. `["llm:*"]` matches `"llm:summarise"`, `"llm:embed"`, etc.
+ * - **Negation** — prefix an entry with `!` to exclude matching steps.
+ *   Negation veto always wins over a positive match in the same array.
+ *   A negation-only array matches all labelled steps that are not excluded.
+ *   e.g. `["!human:*"]` fires on every step _except_ `human:*` steps.
+ *   e.g. `["!human:*", "llm:*"]` fires on `llm:*` steps only, never `human:*`.
  * - **Predicate** — full control; return `true` to match.
  *
  * Unmatched `wrapStep`/`wrapParallelFn` hooks still call `next()` automatically
@@ -84,6 +103,12 @@ interface StepMeta {
  * // Wildcard — any step whose label starts with "llm:"
  * flow.withRateLimit({ intervalMs: 1000 }, ["llm:*"]);
  *
+ * // Negation-only — apply everywhere except human-in-loop steps
+ * flow.withRateLimit({ intervalMs: 1000 }, ["!human:*"]);
+ *
+ * // Mixed — apply to llm steps, but never human steps
+ * flow.withRateLimit({ intervalMs: 1000 }, ["!human:*", "llm:*"]);
+ *
  * // Custom predicate
  * flow.addHooks({ beforeStep: log }, (meta) => meta.type === "fn");
  */
@@ -105,8 +130,18 @@ interface FlowHooks<S = any, P extends Record<string, unknown> = Record<string,
      * `fnIndex` is the position within the fns array.
      */
     wrapParallelFn?: (meta: StepMeta, fnIndex: number, next: () => Promise<void>, shared: S, params: P) => Promise<void>;
-    onError?: (meta: StepMeta, error: unknown, shared: S, params: P) => void;
+    onError?: (meta: StepMeta, error: unknown, shared: S, params: P) => void | Promise<void>;
     afterFlow?: (shared: S, params: P) => void | Promise<void>;
+    /**
+     * Fires after each loop iteration completes. `iteration` is zero-based.
+     * Only fires for `.loop()` steps, not `.batch()` or `.parallel()`.
+     */
+    onLoopIteration?: (meta: StepMeta, iteration: number, shared: S, params: P) => void | Promise<void>;
+    /**
+     * Fires when a goto jump resolves to an anchor (i.e. a step returned `"#anchorName"`).
+     * `anchorName` is the anchor label without the `#` prefix.
+     */
+    onAnchorHit?: (anchorName: string, shared: S, params: P) => void | Promise<void>;
 }
 /**
  * A plugin is an object whose keys become methods on a `FlowBuilder.extend()` subclass prototype.
@@ -120,6 +155,17 @@ interface FlowHooks<S = any, P extends Record<string, unknown> = Record<string,
  * ```
  */
 type FlowneerPlugin = Record<string, (this: FlowBuilder<any, any>, ...args: any[]) => any>;
+type ResolvedHooks<S, P extends Record<string, unknown>> = {
+    beforeFlow: NonNullable<FlowHooks<S, P>["beforeFlow"]>[];
+    beforeStep: NonNullable<FlowHooks<S, P>["beforeStep"]>[];
+    wrapStep: NonNullable<FlowHooks<S, P>["wrapStep"]>[];
+    afterStep: NonNullable<FlowHooks<S, P>["afterStep"]>[];
+    wrapParallelFn: NonNullable<FlowHooks<S, P>["wrapParallelFn"]>[];
+    onError: NonNullable<FlowHooks<S, P>["onError"]>[];
+    afterFlow: NonNullable<FlowHooks<S, P>["afterFlow"]>[];
+    onLoopIteration: NonNullable<FlowHooks<S, P>["onLoopIteration"]>[];
+    onAnchorHit: NonNullable<FlowHooks<S, P>["onAnchorHit"]>[];
+};
 
 interface FnStep<S, P extends Record<string, unknown>> {
     type: "fn";
@@ -196,15 +242,6 @@ interface DagStep<S, P extends Record<string, unknown>> {
 }
 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"]>[];
-    beforeStep: NonNullable<FlowHooks<S, P>["beforeStep"]>[];
-    wrapStep: NonNullable<FlowHooks<S, P>["wrapStep"]>[];
-    afterStep: NonNullable<FlowHooks<S, P>["afterStep"]>[];
-    wrapParallelFn: NonNullable<FlowHooks<S, P>["wrapParallelFn"]>[];
-    onError: NonNullable<FlowHooks<S, P>["onError"]>[];
-    afterFlow: NonNullable<FlowHooks<S, P>["afterFlow"]>[];
-};
 /**
  * Runtime context passed to every registered step handler.
  * Full access to the builder so handlers can run sub-flows etc.
@@ -395,4 +432,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, 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 };
+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 AugmentedState as e, type BranchStep as f, type FnStep as g, type NumberOrFn as h, type RunOptions as i, type Step as j, type StepContext as k, type StepHandler as l, type StreamEvent as m };

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-G67AbbRt.js';
+export { F as FlowBuilder, c as FlowHooks, a as FlowneerPlugin, N as NodeFn, b as NodeOptions, h as NumberOrFn, i as RunOptions, d as StepMeta, m as StreamEvent, V as Validator } from './FlowBuilder-Bvf_nDeb.js';
 export { Fragment, fragment } from './src/index.js';
 export { F as FlowError, I as InterruptError } from './errors-u-hq7p5N.js';

package/dist/index.js

@@ -21,15 +21,21 @@ var InterruptError = class extends Error {
 };
 
 // src/core/utils.ts
+function matchesPattern(pattern, label) {
+  return pattern.includes("*") ? new RegExp(
+    "^" + pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*") + "$"
+  ).test(label) : pattern === label;
+}
 function matchesFilter(filter, meta) {
   if (!Array.isArray(filter)) return filter(meta);
+  const negations = filter.filter((p) => p.startsWith("!"));
+  const positives = filter.filter((p) => !p.startsWith("!"));
   const label = meta.label;
-  if (label === void 0) return false;
-  return filter.some(
-    (p) => p.includes("*") ? new RegExp(
-      "^" + p.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*") + "$"
-    ).test(label) : p === label
-  );
+  if (label !== void 0 && negations.some((p) => matchesPattern(p.slice(1), label)))
+    return false;
+  if (positives.length > 0)
+    return label !== void 0 && positives.some((p) => matchesPattern(p, label));
+  return true;
 }
 function resolveNumber(val, fallback, shared, params) {
   if (val === void 0) return fallback;
@@ -97,6 +103,7 @@ function applyStepFilter(hooks, filter) {
   wrap("onError");
   wrap("wrapStep", (_m, next) => next());
   wrap("wrapParallelFn", (_m, _fi, next) => next());
+  wrap("onLoopIteration");
   return hooks;
 }
 function buildHookCache(list) {
@@ -108,7 +115,9 @@ function buildHookCache(list) {
     afterStep: pick("afterStep"),
     wrapParallelFn: pick("wrapParallelFn"),
     onError: pick("onError"),
-    afterFlow: pick("afterFlow")
+    afterFlow: pick("afterFlow"),
+    onLoopIteration: pick("onLoopIteration"),
+    onAnchorHit: pick("onAnchorHit")
   };
 }
 var CoreFlowBuilder = class _CoreFlowBuilder {
@@ -325,10 +334,12 @@ var CoreFlowBuilder = class _CoreFlowBuilder {
               );
           }
           i = target;
+          for (const h of hooks.onAnchorHit)
+            await h(gotoTarget, shared, params);
         }
       } catch (err) {
         if (err instanceof InterruptError) throw err;
-        for (const h of hooks.onError) h(meta, err, shared, params);
+        for (const h of hooks.onError) await h(meta, err, shared, params);
         if (err instanceof FlowError) throw err;
         const labelPart = stepLabel ? `"${stepLabel}" ` : "";
         const label = step.type === "fn" ? `${labelPart}step ${i}` : `${labelPart}${step.type} (step ${i})`;
@@ -416,12 +427,16 @@ var branchHandler = async (step, { shared, params }) => {
 };
 
 // src/core/steps/loop.ts
-var loopHandler = async (step, { shared, params, signal, meta, builder }) => {
-  while (await step.condition(shared, params))
+var loopHandler = async (step, { shared, params, signal, meta, hooks, builder }) => {
+  let iteration = 0;
+  while (await step.condition(shared, params)) {
     await builder._runSub(
       `loop (step ${meta.index})`,
       () => step.body._execute(shared, params, signal)
     );
+    for (const h of hooks.onLoopIteration)
+      await h(meta, iteration++, shared, params);
+  }
   return void 0;
 };
 

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

@@ -1,4 +1,4 @@
-import { F as FlowBuilder, a as FlowneerPlugin } from '../../FlowBuilder-G67AbbRt.js';
+import { F as FlowBuilder, a as FlowneerPlugin } from '../../FlowBuilder-Bvf_nDeb.js';
 
 interface HumanNodeOptions<S = any, P extends Record<string, unknown> = Record<string, unknown>> {
     /**
@@ -45,6 +45,12 @@ declare module "../../Flowneer" {
          */
         humanNode(options?: HumanNodeOptions<S, P>): this;
     }
+    interface AugmentedState {
+        /** Prompt/question for the human reviewer. Written by `.humanNode()` before interrupting. */
+        __humanPrompt?: string;
+        /** Human-provided response. Write this onto the saved shared state before calling `resumeFlow()`. */
+        __humanFeedback?: string;
+    }
 }
 declare const withHumanNode: FlowneerPlugin;
 /**

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-G67AbbRt.js';
+import { a as FlowneerPlugin, N as NodeFn, b as NodeOptions, S as StepFilter } from '../../FlowBuilder-Bvf_nDeb.js';
 
 declare module "../../Flowneer" {
     interface FlowBuilder<S, P> {
@@ -130,39 +130,118 @@ declare module "../../Flowneer" {
 }
 declare const withFlowAnalyzer: FlowneerPlugin;
 
-interface DebuggerHooks {
-    /** Pause before a step runs. Default: `true`. */
-    beforeStep?: boolean;
-    /** Pause after a step completes. Default: `false`. */
-    afterStep?: boolean;
-    /** Pause when a step throws. Default: `false`. */
-    onError?: boolean;
-    /** Pause once before the step body and once after (inside the wrapper). Default: `false`. */
-    wrapStep?: boolean;
+/** Per-step performance snapshot recorded by `.withPerfAnalyzer()`. */
+interface StepPerfStats {
+    /** Step index (0-based). */
+    index: number;
+    /** Step type: "fn" | "branch" | "loop" | "batch" | "parallel" | "dag". */
+    type: string;
+    /** Step label if set via `NodeOptions.label`. */
+    label?: string;
+    /** Wall-clock duration in ms (high-res via `performance.now()`). */
+    durationMs: number;
+    /** User-space CPU time consumed during this step (ms). 0 on non-Node runtimes. */
+    cpuUserMs: number;
+    /** Kernel CPU time consumed during this step (ms). 0 on non-Node runtimes. */
+    cpuSystemMs: number;
+    /** V8 heap used at step start (bytes). */
+    heapUsedBefore: number;
+    /** V8 heap used at step end (bytes). */
+    heapUsedAfter: number;
+    /**
+     * Net change in V8 heap usage (bytes, positive = allocated, negative = freed
+     * due to a GC cycle that completed during the step).
+     */
+    heapDeltaBytes: number;
+    /** Net change in Resident Set Size (bytes). */
+    rssDeltaBytes: number;
+    /** Net change in external (C++ / Buffer) memory bound to V8 (bytes). */
+    externalDeltaBytes: number;
+    /**
+     * Number of GC events accumulated since last step end. Best-effort; see
+     * module note regarding async PerformanceObserver delivery.
+     */
+    gcCount: number;
+    /** Total GC pause duration attributed to this step (ms). Best-effort. */
+    gcDurationMs: number;
+    /** `true` if the step threw an error (stats still recorded via finally). */
+    threw: boolean;
+}
+/** Flow-level performance summary written to `shared.__perfReport`. */
+interface PerfReport {
+    /** Sum of all step `durationMs` (includes parallel overlap). */
+    totalDurationMs: number;
+    /** Sum of all step `cpuUserMs`. */
+    totalCpuUserMs: number;
+    /** Sum of all step `cpuSystemMs`. */
+    totalCpuSystemMs: number;
+    /** Sum of all GC pause durations across the flow (ms). */
+    totalGcDurationMs: number;
+    /** Total GC event count during the flow. */
+    totalGcCount: number;
+    /** Highest `heapUsedAfter` seen across all steps (bytes). */
+    peakHeapUsedBytes: number;
+    /** All per-step stats in execution order. */
+    steps: StepPerfStats[];
+    /** The step with the longest wall-clock duration, or `null` if no steps ran. */
+    slowest: StepPerfStats | null;
+    /** The step with the largest heap delta, or `null` if no steps ran. */
+    heaviest: StepPerfStats | null;
+}
+interface PerfAnalyzerOptions {
+    /**
+     * Track GC pause events via `PerformanceObserver`. Requires Node.js.
+     * @default true
+     */
+    trackGc?: boolean;
+    /**
+     * Called with the final `PerfReport` in `afterFlow`.
+     * Use this to log, persist, or ship metrics — formatting is left to the caller.
+     */
+    onReport?: (report: PerfReport) => void;
 }
 declare module "../../Flowneer" {
     interface FlowBuilder<S, P> {
         /**
-         * Drops a `debugger` statement at the selected lifecycle points.
-         * Attach DevTools / `--inspect` breakpoints and step through live flow state.
+         * Profiles each step using Node.js built-in performance APIs — no external
+         * dependencies.
          *
-         * @param filter  Limit to specific steps by label or predicate (optional).
-         * @param hooks   Which lifecycle points to pause at. Defaults to `{ beforeStep: true }`.
+         * Per step, records:
+         * - Wall-clock duration (`performance.now()`)
+         * - CPU user + system time (`process.cpuUsage()`)
+         * - Heap used delta (`process.memoryUsage().heapUsed`)
+         * - RSS and external memory delta
+         * - GC pause count + duration (`PerformanceObserver`, best-effort)
+         *
+         * Results are written to `shared.__perfStats` (array, in execution order)
+         * and `shared.__perfReport` (flow summary) when the flow completes.
          *
          * @example
-         * // Pause before every step
-         * new AppFlow().withDebugger().then(myStep).run(shared);
+         * const flow = new AppFlow<State>()
+         *   .withPerfAnalyzer({
+         *     onReport: (r) => console.log(JSON.stringify(r, null, 2)),
+         *   })
+         *   .then(fetchData, { label: "fetch" })
+         *   .then(callLlm,   { label: "llm:generate" })
+         *   .then(save,      { label: "save" });
+         *
+         * await flow.run(shared);
+         * // shared.__perfReport.slowest → { label: "llm:generate", durationMs: ... }
+         * // shared.__perfStats[0]       → { heapDeltaBytes: 2621440, cpuUserMs: 12 … }
          *
          * @example
-         * // Pause only on "llm:*" steps, before and after
-         * new AppFlow()
-         *   .withDebugger(["llm:*"], { beforeStep: true, afterStep: true })
-         *   .then(callLlm)
-         *   .run(shared);
+         * // Profile only LLM steps
+         * flow.withPerfAnalyzer({}, ["llm:*"])
          */
-        withDebugger(filter?: StepFilter, hooks?: DebuggerHooks): this;
+        withPerfAnalyzer(options?: PerfAnalyzerOptions, filter?: StepFilter): this;
+    }
+    interface AugmentedState {
+        /** Per-step perf stats written by `.withPerfAnalyzer()`. In execution order. */
+        __perfStats?: StepPerfStats[];
+        /** Flow-level perf summary written by `.withPerfAnalyzer()` on flow completion. */
+        __perfReport?: PerfReport;
     }
 }
-declare const withDebugger: FlowneerPlugin;
+declare const withPerfAnalyzer: FlowneerPlugin;
 
-export { type DebuggerHooks, type PathMap, type PathNode, type TraceEvent, type TraceHandle, type TraceReport, withAtomicUpdates, withDebugger, withDryRun, withFlowAnalyzer, withMocks, withStepLimit };
+export { type PathMap, type PathNode, type PerfAnalyzerOptions, type PerfReport, type StepPerfStats, type TraceEvent, type TraceHandle, type TraceReport, withAtomicUpdates, withDryRun, withFlowAnalyzer, withMocks, withPerfAnalyzer, withStepLimit };

package/dist/plugins/dev/index.js

@@ -180,41 +180,131 @@ var withFlowAnalyzer = {
   }
 };
 
-// plugins/dev/withDebugger.ts
-var withDebugger = {
-  withDebugger(filter, hooks = { beforeStep: true }) {
-    const registered = {};
-    if (hooks.beforeStep) {
-      registered.beforeStep = (meta, shared, params) => {
-        debugger;
-      };
-    }
-    if (hooks.afterStep) {
-      registered.afterStep = (meta, shared, params) => {
-        debugger;
-      };
-    }
-    if (hooks.onError) {
-      registered.onError = (meta, error, shared, params) => {
-        debugger;
-      };
-    }
-    if (hooks.wrapStep) {
-      registered.wrapStep = async (meta, next, shared, params) => {
-        debugger;
-        await next();
-        debugger;
-      };
+// plugins/dev/withPerfAnalyzer.ts
+import { performance, PerformanceObserver } from "perf_hooks";
+function cpuUsage() {
+  return process.cpuUsage?.() ?? {
+    user: 0,
+    system: 0
+  };
+}
+function cpuUsageDelta(start) {
+  return process.cpuUsage?.(start) ?? { user: 0, system: 0 };
+}
+function memUsage() {
+  return process.memoryUsage?.() ?? {
+    rss: 0,
+    heapTotal: 0,
+    heapUsed: 0,
+    external: 0,
+    arrayBuffers: 0
+  };
+}
+var withPerfAnalyzer = {
+  withPerfAnalyzer(options = {}, filter) {
+    const { trackGc = true, onReport } = options;
+    const gcLog = [];
+    let gcObserver = null;
+    if (trackGc) {
+      try {
+        gcObserver = new PerformanceObserver((list) => {
+          for (const entry of list.getEntries()) {
+            gcLog.push({
+              startTime: entry.startTime,
+              duration: entry.duration
+            });
+          }
+        });
+        gcObserver.observe({ entryTypes: ["gc"] });
+      } catch {
+      }
     }
-    this._setHooks(registered, filter);
+    const snapshots = /* @__PURE__ */ new Map();
+    this._setHooks(
+      {
+        wrapStep: async (meta, next, shared) => {
+          const gcMsBefore = gcLog.reduce((a, e) => a + e.duration, 0);
+          const t0 = performance.now();
+          const cpu0 = cpuUsage();
+          const mem0 = memUsage();
+          snapshots.set(meta.index, {
+            t0,
+            cpu0,
+            mem0,
+            gcLenBefore: gcLog.length,
+            gcMsBefore
+          });
+          let threw = false;
+          try {
+            await next();
+          } catch (e) {
+            threw = true;
+            throw e;
+          } finally {
+            const durationMs = performance.now() - t0;
+            const cpuDelta = cpuUsageDelta(cpu0);
+            const mem1 = memUsage();
+            const snap = snapshots.get(meta.index);
+            snapshots.delete(meta.index);
+            const gcMsAfter = gcLog.reduce((a, e) => a + e.duration, 0);
+            const gcCountAfter = gcLog.length;
+            const gcLenBefore = snap?.gcLenBefore ?? gcLog.length;
+            const gcMsSnap = snap?.gcMsBefore ?? gcMsAfter;
+            const stat = {
+              index: meta.index,
+              type: meta.type,
+              label: meta.label,
+              durationMs,
+              cpuUserMs: cpuDelta.user / 1e3,
+              cpuSystemMs: cpuDelta.system / 1e3,
+              heapUsedBefore: mem0.heapUsed,
+              heapUsedAfter: mem1.heapUsed,
+              heapDeltaBytes: mem1.heapUsed - mem0.heapUsed,
+              rssDeltaBytes: mem1.rss - mem0.rss,
+              externalDeltaBytes: mem1.external - mem0.external,
+              gcCount: gcCountAfter - gcLenBefore,
+              gcDurationMs: gcMsAfter - gcMsSnap,
+              threw
+            };
+            if (!shared.__perfStats) shared.__perfStats = [];
+            shared.__perfStats.push(stat);
+          }
+        },
+        afterFlow: (shared) => {
+          gcObserver?.disconnect();
+          const stats = shared.__perfStats ?? [];
+          const totalGcDurationMs = gcLog.reduce((a, e) => a + e.duration, 0);
+          const totalGcCount = gcLog.length;
+          const report = {
+            totalDurationMs: stats.reduce((a, s) => a + s.durationMs, 0),
+            totalCpuUserMs: stats.reduce((a, s) => a + s.cpuUserMs, 0),
+            totalCpuSystemMs: stats.reduce((a, s) => a + s.cpuSystemMs, 0),
+            totalGcDurationMs,
+            totalGcCount,
+            peakHeapUsedBytes: stats.reduce(
+              (a, s) => Math.max(a, s.heapUsedAfter),
+              0
+            ),
+            steps: stats,
+            slowest: stats.length > 0 ? stats.reduce((a, s) => s.durationMs > a.durationMs ? s : a) : null,
+            heaviest: stats.length > 0 ? stats.reduce(
+              (a, s) => s.heapDeltaBytes > a.heapDeltaBytes ? s : a
+            ) : null
+          };
+          shared.__perfReport = report;
+          onReport?.(report);
+        }
+      },
+      filter
+    );
     return this;
   }
 };
 export {
   withAtomicUpdates,
-  withDebugger,
   withDryRun,
   withFlowAnalyzer,
   withMocks,
+  withPerfAnalyzer,
   withStepLimit
 };

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

@@ -1,4 +1,4 @@
-import { F as FlowBuilder } from '../../FlowBuilder-G67AbbRt.js';
+import { F as FlowBuilder } from '../../FlowBuilder-Bvf_nDeb.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-G67AbbRt.js';
+import { a as FlowneerPlugin, N as NodeFn, b as NodeOptions } from '../../FlowBuilder-Bvf_nDeb.js';
 
 /** A single node entry in the exported graph. */
 interface GraphNodeExport {

package/dist/plugins/graph/index.js

@@ -21,15 +21,21 @@ var InterruptError = class extends Error {
 };
 
 // src/core/utils.ts
+function matchesPattern(pattern, label) {
+  return pattern.includes("*") ? new RegExp(
+    "^" + pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*") + "$"
+  ).test(label) : pattern === label;
+}
 function matchesFilter(filter, meta) {
   if (!Array.isArray(filter)) return filter(meta);
+  const negations = filter.filter((p) => p.startsWith("!"));
+  const positives = filter.filter((p) => !p.startsWith("!"));
   const label = meta.label;
-  if (label === void 0) return false;
-  return filter.some(
-    (p) => p.includes("*") ? new RegExp(
-      "^" + p.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*") + "$"
-    ).test(label) : p === label
-  );
+  if (label !== void 0 && negations.some((p) => matchesPattern(p.slice(1), label)))
+    return false;
+  if (positives.length > 0)
+    return label !== void 0 && positives.some((p) => matchesPattern(p, label));
+  return true;
 }
 function resolveNumber(val, fallback, shared, params) {
   if (val === void 0) return fallback;
@@ -97,6 +103,7 @@ function applyStepFilter(hooks, filter) {
   wrap("onError");
   wrap("wrapStep", (_m, next) => next());
   wrap("wrapParallelFn", (_m, _fi, next) => next());
+  wrap("onLoopIteration");
   return hooks;
 }
 function buildHookCache(list) {
@@ -108,7 +115,9 @@ function buildHookCache(list) {
     afterStep: pick("afterStep"),
     wrapParallelFn: pick("wrapParallelFn"),
     onError: pick("onError"),
-    afterFlow: pick("afterFlow")
+    afterFlow: pick("afterFlow"),
+    onLoopIteration: pick("onLoopIteration"),
+    onAnchorHit: pick("onAnchorHit")
   };
 }
 var CoreFlowBuilder = class _CoreFlowBuilder {
@@ -325,10 +334,12 @@ var CoreFlowBuilder = class _CoreFlowBuilder {
               );
           }
           i = target;
+          for (const h of hooks.onAnchorHit)
+            await h(gotoTarget, shared, params);
         }
       } catch (err) {
         if (err instanceof InterruptError) throw err;
-        for (const h of hooks.onError) h(meta, err, shared, params);
+        for (const h of hooks.onError) await h(meta, err, shared, params);
         if (err instanceof FlowError) throw err;
         const labelPart = stepLabel ? `"${stepLabel}" ` : "";
         const label = step.type === "fn" ? `${labelPart}step ${i}` : `${labelPart}${step.type} (step ${i})`;

package/dist/plugins/index.d.ts

@@ -1,6 +1,6 @@
 export { withHistory, withInterrupts, withTiming, withVerbose } from './observability/index.js';
 export { CircuitBreakerOptions, withCircuitBreaker, withCycles, withFallback, withTimeout } from './resilience/index.js';
-export { AuditEntry, AuditLogStore, CheckpointStore, VersionedCheckpointEntry, VersionedCheckpointStore, withAuditLog, withCheckpoint, withReplay, withVersionedCheckpoint } from './persistence/index.js';
+export { AuditEntry, AuditLogStore, withAuditLog, withCheckpoint, withReplay } from './persistence/index.js';
 export { RateLimitOptions, withCostTracker, withRateLimit, withTokenBudget } from './llm/index.js';
 export { PathMap, PathNode, TraceEvent, TraceHandle, TraceReport, withAtomicUpdates, withDryRun, withFlowAnalyzer, withMocks, withStepLimit } from './dev/index.js';
 export { StreamSubscriber, emit, peekChannel, receiveFrom, sendTo, withChannels, withStream } from './messaging/index.js';
@@ -11,7 +11,7 @@ export { parseJsonOutput, parseListOutput, parseMarkdownTable, parseRegexOutput
 export { Span, TelemetryDaemon, TelemetryExporter, TelemetryOptions, consoleExporter, otlpExporter, withTelemetry } from './telemetry/index.js';
 export { EvalResult, EvalSummary, ScoreFn, answerRelevance, containsMatch, exactMatch, f1Score, retrievalPrecision, retrievalRecall, runEvalSuite } from './eval/index.js';
 export { GraphEdge, GraphNode, withGraph } from './graph/index.js';
-import { S as StepFilter, a as FlowneerPlugin, d as StepMeta, F as FlowBuilder } from '../FlowBuilder-G67AbbRt.js';
+import { S as StepFilter, a as FlowneerPlugin, d as StepMeta, F as FlowBuilder } from '../FlowBuilder-Bvf_nDeb.js';
 import { F as FlowError } from '../errors-u-hq7p5N.js';
 export { validate } from './config/index.js';
 export { F as FlowConfig, a as FnRegistry, S as StepConfig, V as ValidationError, b as ValidationResult } from '../schema-CIqQAXqY.js';