wotann 0.5.0 → 0.5.39

package/dist/middleware/loop-detection.js

@@ -1,12 +1,33 @@
 /**
- * LoopDetector — Crush loop_detection.go port.
+ * LoopDetector — Crush loop_detection.go port + deer-flow multiset upgrade.
  *
- * Tracks the last-N tool calls per session with a hash of (tool_name,
- * canonical args). When the same hash appears ≥ threshold times within
- * the sliding window, emits a "stuck" nudge prompt:
+ * ── Layer 1 (existing, unchanged): LoopDetector ──────────────────
+ *   Per-session sliding-window hash repetition. Catches "same tool +
+ *   same args" repeated ≥ threshold times. Wired at order 24.5.
  *
- *   "You appear to be in a loop. The last N actions were the same.
- *    Reconsider your plan."
+ * ── Layer 2 (new, additive): MultisetLoopDetector ───────────────
+ *   Three orthogonal axes from
+ *     research/deer-flow/.../loop_detection_middleware.py
+ *
+ *   1. **Multiset hash** — sort canonical (name, key) signatures of the
+ *      last N calls and hash. ABC and BCA hash identically. Catches
+ *      agents that reorder the same wasteful calls.
+ *
+ *   2. **Per-tool frequency cap** — independent of args. WARN @ 30,
+ *      HARD-STOP @ 50. Catches `read_file × 80` on 80 different paths,
+ *      which the multiset hash would miss because each path hashes
+ *      distinctly.
+ *
+ *   3. **read_file line-range bucketing** — start/end lines collapsed
+ *      to 200-line buckets so re-reading lines 1-50, 1-60, 1-80 of the
+ *      same file collapses into one signature (false-positive killer).
+ *      write_file / str_replace stay content-sensitive: full args
+ *      hashed (false-negative killer).
+ *
+ *   LRU thread table: bounded at 100 entries by default. Oldest by
+ *   last-access timestamp evicted on overflow (Quality Bar #7 keeps
+ *   sessions isolated; LRU keeps memory bounded under many concurrent
+ *   sessions).
  *
  * DESIGN NOTES:
  * - Per-session state: `Map<sessionId, RecentCallWindow>` (Quality Bar #7).
@@ -22,6 +43,10 @@
  * Crush reference: charmbracelet/crush `internal/llm/agent/loop_detection.go`
  * (not cloned locally — pattern described in
  *  docs/internal/RESEARCH_TERMINALBENCH_HARNESSES_DEEP.md §P1-B6).
+ *
+ * deer-flow reference (multiset upgrade):
+ *   research/deer-flow/backend/packages/harness/deerflow/agents/middlewares/
+ *     loop_detection_middleware.py
  */
 import { createHash } from "node:crypto";
 export const DEFAULT_LOOP_CONFIG = {
@@ -165,4 +190,314 @@ export function createLoopDetectionMiddleware(instance) {
         },
     };
 }
+// ─────────────────────────────────────────────────────────────────
+// ── Multiset Upgrade (deer-flow pattern) ─────────────────────────
+// ─────────────────────────────────────────────────────────────────
+/**
+ * Default constants for the multiset detector. Ported verbatim from
+ * deer-flow's `loop_detection_middleware.py` so behavior matches the
+ * bytedance variant on TerminalBench.
+ */
+export const DEFAULT_MULTISET_WINDOW = 10;
+export const DEFAULT_FREQ_WARN_AT = 30;
+export const DEFAULT_FREQ_HARD_STOP_AT = 50;
+export const DEFAULT_MAX_TRACKED_THREADS = 100;
+export const DEFAULT_READ_FILE_BUCKET_SIZE = 200;
+const DEFAULT_HASH_REPEAT_WARN = 3;
+const DEFAULT_HASH_REPEAT_HARD_STOP = 5;
+/**
+ * Coerce a value to a positive integer ≥ 1. Used to defensively
+ * normalize `start_line` / `end_line` which providers sometimes
+ * serialize as strings, floats, or null.
+ */
+function coerceLine(value, fallback) {
+    if (value === null || value === undefined)
+        return fallback;
+    const n = typeof value === "number" ? value : Number(value);
+    if (!Number.isFinite(n))
+        return fallback;
+    const truncated = Math.trunc(n);
+    return truncated >= 1 ? truncated : 1;
+}
+/**
+ * Bucket `read_file` args so re-reads of overlapping line ranges of
+ * the same file collapse to one signature.
+ *
+ * Behavior matches deer-flow's `_stable_tool_key` for `read_file`:
+ *   - Default bucket size: 200 lines.
+ *   - `start_line` defaults to 1 if absent/invalid.
+ *   - `end_line` defaults to `start_line` if absent/invalid.
+ *   - Bucket index = `Math.floor((line - 1) / bucketSize)`.
+ *   - Output: `"{path}:{startBucket}-{endBucket}"`.
+ *
+ * Examples (bucket size 200):
+ *   - lines 1-50  → `"/x:0-0"`
+ *   - lines 1-60  → `"/x:0-0"`  (same bucket — collapses)
+ *   - lines 1-80  → `"/x:0-0"`  (same bucket — collapses)
+ *   - lines 250-300 → `"/x:1-1"` (different bucket — distinct)
+ */
+export function bucketReadFileArgs(args, bucketSize = DEFAULT_READ_FILE_BUCKET_SIZE) {
+    const path = typeof args.path === "string" ? args.path : "";
+    const rawStart = coerceLine(args.start_line, 1);
+    const rawEnd = coerceLine(args.end_line, rawStart);
+    // Normalize so end >= start (deer-flow uses `sorted((start, end))`).
+    const startLine = Math.min(rawStart, rawEnd);
+    const endLine = Math.max(rawStart, rawEnd);
+    const bucketStart = Math.floor((Math.max(startLine, 1) - 1) / bucketSize);
+    const bucketEnd = Math.floor((Math.max(endLine, 1) - 1) / bucketSize);
+    return `${path}:${bucketStart}-${bucketEnd}`;
+}
+/**
+ * Derive a stable per-call key. Mirrors deer-flow's `_stable_tool_key`:
+ *   - `read_file` → bucketed line range (false-positive killer).
+ *   - `write_file` / `str_replace` → full canonical args hash
+ *     (content-sensitive; false-negative killer).
+ *   - everything else → JSON of salient fields (`path`, `url`, `query`,
+ *     `command`, `pattern`, `glob`, `cmd`), falling back to full args.
+ */
+function stableToolKey(name, rawArgs, bucketSize) {
+    const args = rawArgs !== null && typeof rawArgs === "object" && !Array.isArray(rawArgs)
+        ? rawArgs
+        : {};
+    if (name === "read_file") {
+        return bucketReadFileArgs(args, bucketSize);
+    }
+    if (name === "write_file" || name === "str_replace") {
+        // Full canonical hash — distinct payloads stay distinct.
+        return JSON.stringify(canonicalize(args));
+    }
+    const salient = ["path", "url", "query", "command", "pattern", "glob", "cmd"];
+    const stable = {};
+    for (const field of salient) {
+        const v = args[field];
+        if (v !== undefined && v !== null)
+            stable[field] = v;
+    }
+    if (Object.keys(stable).length > 0) {
+        return JSON.stringify(canonicalize(stable));
+    }
+    return JSON.stringify(canonicalize(args));
+}
+/**
+ * Hash a multiset of tool calls. Sorts the canonical `(name, key)`
+ * signatures so ABC and BCA hash identically.
+ */
+function hashMultiset(calls) {
+    const normalized = calls
+        .map((c) => `${c.name}:${c.key}`)
+        .slice()
+        .sort();
+    return createHash("md5").update(JSON.stringify(normalized)).digest("hex").slice(0, 12);
+}
+function makeFreshThread() {
+    return {
+        window: [],
+        toolFreq: new Map(),
+        warnedHashes: new Set(),
+        warnedTools: new Set(),
+        lastAccess: 0, // set on insert
+    };
+}
+/**
+ * MultisetLoopDetector — order-independent + per-tool frequency +
+ * read_file bucketing + bounded LRU thread table.
+ *
+ * Usage:
+ *   const det = new MultisetLoopDetector();
+ *   const r = det.observe({ name: "read_file", args: { path: "/x", start_line: 1, end_line: 50 } });
+ *   if (r.status === "hard-stop") forceFinalAnswer();
+ *   else if (r.status === "warn")  injectNudge(r.reason!);
+ *
+ * Each session is keyed by `sessionId` passed to `observe`. The third
+ * argument is optional — when omitted, `"default"` is used (matches
+ * deer-flow's `_get_thread_id` fallback).
+ */
+export class MultisetLoopDetector {
+    windowSize;
+    warnAt;
+    hardStopAt;
+    hashRepeatWarnAt;
+    hashRepeatHardStopAt;
+    maxTrackedThreads;
+    readFileBucketSize;
+    /**
+     * Per-session state. JS `Map` preserves insertion order, but we use
+     * an explicit `lastAccess` counter so LRU eviction is correct under
+     * any access pattern (touch on read AND write).
+     */
+    threads = new Map();
+    /** Monotonic counter for `lastAccess` timestamps. */
+    accessCounter = 0;
+    constructor(options = {}) {
+        this.windowSize = options.window ?? DEFAULT_MULTISET_WINDOW;
+        this.warnAt = options.warnAt ?? DEFAULT_FREQ_WARN_AT;
+        this.hardStopAt = options.hardStopAt ?? DEFAULT_FREQ_HARD_STOP_AT;
+        this.hashRepeatWarnAt = options.hashRepeatWarnAt ?? DEFAULT_HASH_REPEAT_WARN;
+        this.hashRepeatHardStopAt = options.hashRepeatHardStopAt ?? DEFAULT_HASH_REPEAT_HARD_STOP;
+        this.maxTrackedThreads = options.maxTrackedThreads ?? DEFAULT_MAX_TRACKED_THREADS;
+        this.readFileBucketSize = options.readFileBucketSize ?? DEFAULT_READ_FILE_BUCKET_SIZE;
+        if (this.windowSize < 1) {
+            throw new Error("MultisetLoopDetector: window must be >= 1");
+        }
+        if (this.hardStopAt < this.warnAt) {
+            throw new Error("MultisetLoopDetector: hardStopAt must be >= warnAt");
+        }
+        if (this.hashRepeatHardStopAt < this.hashRepeatWarnAt) {
+            throw new Error("MultisetLoopDetector: hashRepeatHardStopAt must be >= hashRepeatWarnAt");
+        }
+        if (this.maxTrackedThreads < 1) {
+            throw new Error("MultisetLoopDetector: maxTrackedThreads must be >= 1");
+        }
+    }
+    /**
+     * Touch (or create) the thread record. Bumps `lastAccess`. Evicts
+     * the LRU thread if the table would exceed `maxTrackedThreads` on
+     * insert.
+     */
+    touchThread(sessionId) {
+        const existing = this.threads.get(sessionId);
+        if (existing) {
+            existing.lastAccess = ++this.accessCounter;
+            return existing;
+        }
+        // Insert. Evict LRU first if at-or-over the cap so a fresh insert
+        // never blows past `maxTrackedThreads`.
+        if (this.threads.size >= this.maxTrackedThreads) {
+            this.evictOldest();
+        }
+        const fresh = makeFreshThread();
+        fresh.lastAccess = ++this.accessCounter;
+        this.threads.set(sessionId, fresh);
+        return fresh;
+    }
+    /**
+     * Evict the thread with the oldest `lastAccess`. Called from
+     * {@link touchThread} on overflow. O(N) — N is bounded by
+     * `maxTrackedThreads` (100 by default), so this stays cheap.
+     */
+    evictOldest() {
+        let oldestKey = null;
+        let oldestTs = Number.POSITIVE_INFINITY;
+        for (const [k, v] of this.threads) {
+            if (v.lastAccess < oldestTs) {
+                oldestTs = v.lastAccess;
+                oldestKey = k;
+            }
+        }
+        if (oldestKey !== null) {
+            this.threads.delete(oldestKey);
+        }
+    }
+    /**
+     * Observe a tool call for a session. Updates the multiset window
+     * and per-tool frequency, and returns the current status:
+     *
+     *   - `"ok"` — under all thresholds.
+     *   - `"warn"` — either the multiset hash has been seen
+     *     `hashRepeatWarnAt` times inside the window, OR the per-tool
+     *     frequency has crossed `warnAt`. Each unique hash / tool emits
+     *     `"warn"` exactly once per session (avoids spamming).
+     *   - `"hard-stop"` — multiset hash hit `hashRepeatHardStopAt` or
+     *     per-tool frequency hit `hardStopAt`. Caller should force a
+     *     final answer.
+     *
+     * Hash precedence: hash-based hard-stop > frequency hard-stop >
+     * hash-based warn > frequency warn > ok.
+     */
+    observe(call, sessionId = "default") {
+        const name = call.name;
+        const key = stableToolKey(name, call.args, this.readFileBucketSize);
+        const thread = this.touchThread(sessionId);
+        // Append + slide window.
+        thread.window.push({ name, key });
+        if (thread.window.length > this.windowSize) {
+            thread.window.splice(0, thread.window.length - this.windowSize);
+        }
+        // Current window's multiset hash (after appending).
+        const hash = hashMultiset(thread.window);
+        // Count occurrences of the *current* hash by re-hashing each
+        // length-1-or-more suffix? No — deer-flow tracks the hash history,
+        // not the multiset window. We mirror the same shape: count how
+        // many times this exact hash has appeared in a separate history
+        // log. Since this hash is derived from the current window, we
+        // store hashes in a parallel array.
+        //
+        // To stay memory-light we keep the count inside `toolFreq` under
+        // a reserved synthetic key `__hash:<hash>` for hash-occurrence
+        // counting. This is a per-session counter that increments every
+        // call where the window hash matches.
+        const hashKey = `__hash:${hash}`;
+        const hashCount = (thread.toolFreq.get(hashKey) ?? 0) + 1;
+        thread.toolFreq.set(hashKey, hashCount);
+        // Per-tool frequency (independent of args).
+        const toolCount = (thread.toolFreq.get(name) ?? 0) + 1;
+        thread.toolFreq.set(name, toolCount);
+        // ── Layer A: multiset hash thresholds (highest precedence) ──
+        if (hashCount >= this.hashRepeatHardStopAt) {
+            return {
+                hash,
+                status: "hard-stop",
+                reason: `multiset hash ${hash} repeated ${hashCount}× (≥${this.hashRepeatHardStopAt}) inside window`,
+            };
+        }
+        // ── Layer B: per-tool frequency hard-stop ─────────────────
+        if (toolCount >= this.hardStopAt) {
+            return {
+                hash,
+                status: "hard-stop",
+                reason: `tool '${name}' called ${toolCount}× (≥${this.hardStopAt})`,
+            };
+        }
+        // ── Layer C: multiset hash warn (once per hash) ───────────
+        if (hashCount >= this.hashRepeatWarnAt) {
+            if (!thread.warnedHashes.has(hash)) {
+                thread.warnedHashes.add(hash);
+                return {
+                    hash,
+                    status: "warn",
+                    reason: `multiset hash ${hash} repeated ${hashCount}× (≥${this.hashRepeatWarnAt}) inside window`,
+                };
+            }
+            // Already warned for this hash; fall through to layer D so a
+            // pending frequency warn can still surface.
+        }
+        // ── Layer D: per-tool frequency warn (once per tool) ──────
+        if (toolCount >= this.warnAt) {
+            if (!thread.warnedTools.has(name)) {
+                thread.warnedTools.add(name);
+                return {
+                    hash,
+                    status: "warn",
+                    reason: `tool '${name}' called ${toolCount}× (≥${this.warnAt})`,
+                };
+            }
+        }
+        return { hash, status: "ok" };
+    }
+    /** Clear state for one session. */
+    reset(sessionId) {
+        this.threads.delete(sessionId);
+    }
+    /** Clear state for ALL sessions. */
+    resetAll() {
+        this.threads.clear();
+        this.accessCounter = 0;
+    }
+    /** Number of currently-tracked sessions. Bounded by `maxTrackedThreads`. */
+    size() {
+        return this.threads.size;
+    }
+    /** Current per-tool count for diagnostics/tests. */
+    getToolCount(sessionId, toolName) {
+        return this.threads.get(sessionId)?.toolFreq.get(toolName) ?? 0;
+    }
+    /** Current window length for diagnostics/tests. */
+    getWindowLength(sessionId) {
+        return this.threads.get(sessionId)?.window.length ?? 0;
+    }
+    /** Whether a session is currently tracked (used by LRU tests). */
+    hasSession(sessionId) {
+        return this.threads.has(sessionId);
+    }
+}
 //# sourceMappingURL=loop-detection.js.map

package/dist/middleware/loop-detection.js.map

@@ -1 +1 @@
-{"version":3,"file":"loop-detection.js","sourceRoot":"","sources":["../../src/middleware/loop-detection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"loop-detection.js","sourceRoot":"","sources":["../../src/middleware/loop-detection.ts"],"names":[],"mappings":"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"}

package/dist/middleware/pipeline.d.ts

@@ -16,7 +16,7 @@ import { VerificationEnforcementMiddleware } from "./verification-enforcement.js
 import { AutoInstallMiddleware } from "./auto-install.js";
 import { StaleDetectionMiddleware } from "./stale-detection.js";
 import { DoomLoopMiddleware } from "./doom-loop.js";
-import { LoopDetector } from "./loop-detection.js";
+import { LoopDetector, MultisetLoopDetector } from "./loop-detection.js";
 import { SkillRulesProvider } from "../orchestration/skill-rules-provider.js";
 import { OutputTruncationMiddleware } from "./output-truncation.js";
 import { ToolPairValidatorMiddleware } from "./tool-pair-validator.js";
@@ -67,6 +67,7 @@ export declare function createPipelineWithInstances(checklist: PreCompletionChec
     readonly staleDetection: StaleDetectionMiddleware;
     readonly doomLoop: DoomLoopMiddleware;
     readonly loopDetector: LoopDetector;
+    readonly multisetLoopDetector: MultisetLoopDetector;
     readonly outputTruncation: OutputTruncationMiddleware;
     readonly toolPairValidator: ToolPairValidatorMiddleware;
     readonly guardrailProvider: GuardrailProviderMiddleware;
@@ -113,6 +114,13 @@ export declare function getDefaultDoomLoop(): DoomLoopMiddleware;
  * Get the default shared LoopDetector instance (Crush port, per-session).
  */
 export declare function getDefaultLoopDetector(): LoopDetector;
+/**
+ * Get the default shared MultisetLoopDetector instance (deer-flow port —
+ * order-independent multiset + per-tool frequency cap + read_file
+ * bucketing). Wired at pipeline order 24.55, immediately after the legacy
+ * LoopDetector at 24.5. Audit finding #4 — zombie module resurrection.
+ */
+export declare function getDefaultMultisetLoopDetector(): MultisetLoopDetector;
 /**
  * Get the default shared OutputTruncationMiddleware instance.
  */

package/dist/middleware/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/middleware/pipeline.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/middleware/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/middleware/pipeline.js

@@ -17,7 +17,7 @@ import { VerificationEnforcementMiddleware, createVerificationEnforcementMiddlew
 import { AutoInstallMiddleware, createAutoInstallMiddleware } from "./auto-install.js";
 import { StaleDetectionMiddleware, createStaleDetectionMiddleware } from "./stale-detection.js";
 import { DoomLoopMiddleware, createDoomLoopMiddleware } from "./doom-loop.js";
-import { LoopDetector, createLoopDetectionMiddleware } from "./loop-detection.js";
+import { LoopDetector, MultisetLoopDetector, createLoopDetectionMiddleware, } from "./loop-detection.js";
 import { createToolFlowGateMiddleware } from "./tool-flow-gate.js";
 import { SkillRulesProvider } from "../orchestration/skill-rules-provider.js";
 import { OutputTruncationMiddleware, createOutputTruncationMiddleware, } from "./output-truncation.js";
@@ -46,6 +46,16 @@ const defaultAutoInstallInstance = new AutoInstallMiddleware();
 const defaultStaleDetectionInstance = new StaleDetectionMiddleware();
 const defaultDoomLoopInstance = new DoomLoopMiddleware();
 const defaultLoopDetectorInstance = new LoopDetector();
+// Audit finding #4 wire — MultisetLoopDetector chains AFTER the legacy
+// LoopDetector to catch loop classes the legacy hash-window misses:
+//   1. Order-independent multiset (catches ABC / BCA reordering)
+//   2. Per-tool frequency cap (catches `read_file × 50` on distinct paths)
+//   3. read_file line-range bucketing (catches re-reads of overlapping ranges)
+// Defaults match deer-flow (window=10, warn@30, hard-stop@50, hashRepeatWarn@3,
+// hashRepeatHardStop@5). The legacy detector keeps its existing nudge
+// untouched; multiset appends a SEPARATE nudge ONLY on warn / hard-stop so
+// backward-compatible consumers that grep for the legacy message still match.
+const defaultMultisetLoopDetectorInstance = new MultisetLoopDetector();
 const defaultOutputTruncationInstance = new OutputTruncationMiddleware();
 const defaultToolPairValidatorInstance = new ToolPairValidatorMiddleware();
 // Lane 2 deer-flow ports (6 new middleware — closes Lane 2 parity gap).
@@ -122,6 +132,98 @@ const defaultTrifectaContextProvider = (ctx) => {
     };
 };
 const defaultDenyApprovalHandler = async () => "deny";
+// ── Multiset Loop Detection Adapter ──────────────────────────
+//
+// Audit finding #4 — zombie module wire. MultisetLoopDetector ports
+// deer-flow's three-axis detector and lives at src/middleware/loop-detection.ts
+// alongside the legacy LoopDetector. Until this adapter, it had ZERO
+// production callers.
+//
+// Decision: AUGMENT (chain), not REPLACE.
+//   - The legacy LoopDetector ("LoopDetection" layer at order 24.5) keeps
+//     its existing surface untouched (backward-compatibility for anything
+//     watching for its specific nudge text).
+//   - This adapter wires the multiset detector immediately AFTER at order
+//     24.55. It fires ONLY when status is "warn" or "hard-stop", appending
+//     a distinct, clearly-labeled nudge to `result.followUp`.
+//   - APIs differ ({record + buildNudge} vs {observe}). The adapter
+//     translates the AgentResult into a `ToolCall` shape, calls observe,
+//     and converts non-"ok" statuses into a system_reminder block.
+//
+// Conservatism (per task constraint — DO NOT make the pipeline more
+// aggressive about looping):
+//   - Multiset defaults (warn@30, hard-stop@50, hashRepeatWarn@3,
+//     hashRepeatHardStop@5) come straight from deer-flow's published
+//     thresholds — a generous bar that catches genuine loops, not
+//     short-term repeats the legacy detector already handles.
+//   - Status "ok" → adapter is a no-op (returns result unchanged).
+//   - Status "warn" / "hard-stop" → APPEND to existing followUp (preserving
+//     any prior legacy or DoomLoop message), never replace.
+//   - Per-hash and per-tool warns fire AT MOST ONCE per session (the
+//     detector itself tracks `warnedHashes` / `warnedTools` to silence
+//     spam).
+function buildMultisetArgs(result) {
+    // Mirror the shape used by the legacy adapter so the args surface is
+    // consistent across both detectors. AgentResult is a coarse view —
+    // pendingToolInput is not yet threaded through, so we use what's
+    // available without inventing fields.
+    const args = {};
+    if (result.filePath)
+        args["path"] = result.filePath;
+    if (result.content)
+        args["content"] = result.content.slice(0, 500);
+    return args;
+}
+function buildMultisetNudge(observe, toolName) {
+    if (observe.status === "ok")
+        return null;
+    const severity = observe.status === "hard-stop" ? "STOP" : "warning";
+    return [
+        "<system_reminder>",
+        `Loop detector (multiset) raised a ${severity}: ${observe.reason ?? "repetition threshold crossed"}.`,
+        `Tool: ${toolName}. The current trajectory is not making progress —`,
+        "step back, reconsider, and try a fundamentally different strategy.",
+        "</system_reminder>",
+    ].join("\n");
+}
+/**
+ * Wire a {@link MultisetLoopDetector} into the middleware pipeline. Sits
+ * at order 24.55 — immediately after the legacy LoopDetection (24.5) so
+ * its append-only nudge concatenates onto any legacy / DoomLoop message
+ * rather than replacing it.
+ *
+ * The adapter is intentionally side-effect-only: it mutates nothing on
+ * `result` other than `followUp` (and only on detection). For "ok"
+ * outcomes — by far the common case — it returns the input result
+ * unchanged.
+ *
+ * Local to pipeline.ts (constraint: DO NOT modify loop-detection.ts).
+ */
+function createMultisetLoopDetectionMiddleware(instance) {
+    return {
+        name: "MultisetLoopDetection",
+        order: 24.55,
+        after(ctx, result) {
+            if (!result.toolName)
+                return result;
+            const call = {
+                name: result.toolName,
+                args: buildMultisetArgs(result),
+            };
+            const observe = instance.observe(call, ctx.sessionId);
+            const nudge = buildMultisetNudge(observe, result.toolName);
+            if (!nudge)
+                return result;
+            // APPEND, never replace — preserves legacy LoopDetection / DoomLoop
+            // follow-ups (backward-compatibility for any consumer watching for
+            // those specific texts).
+            return {
+                ...result,
+                followUp: result.followUp ? `${result.followUp}\n\n${nudge}` : nudge,
+            };
+        },
+    };
+}
 // ── Pipeline Definition (31 layers in order, 6 Lane 2 additions) ─
 const PIPELINE = [
     createToolPairValidatorMiddleware(defaultToolPairValidatorInstance), // 0. Tool use/result pair validation
@@ -164,6 +266,7 @@ const PIPELINE = [
     createStaleDetectionMiddleware(defaultStaleDetectionInstance), // 23. Stale-read detection
     createDoomLoopMiddleware(defaultDoomLoopInstance), // 24. Doom loop detection
     createLoopDetectionMiddleware(defaultLoopDetectorInstance), // 24.5. Loop detection (Crush port, per-session)
+    createMultisetLoopDetectionMiddleware(defaultMultisetLoopDetectorInstance), // 24.55. Loop detection (deer-flow multiset port — augments 24.5, append-only nudge)
     // Round 29 + Wave A3.2 — tool-flow-gate wired to a real
     // SkillRulesProvider. Until callers register rules per-session
     // via `addRulesFromSkill`, the provider returns [] for every
@@ -251,6 +354,7 @@ export function createPipelineWithInstances(checklist, notificationTracker) {
     const staleDetection = new StaleDetectionMiddleware();
     const doomLoop = new DoomLoopMiddleware();
     const loopDetector = new LoopDetector();
+    const multisetLoopDetector = new MultisetLoopDetector();
     const outputTruncation = new OutputTruncationMiddleware();
     const toolPairValidator = new ToolPairValidatorMiddleware();
     const guardrailProvider = new GuardrailProviderMiddleware(new AllowlistProvider({}));
@@ -297,6 +401,7 @@ export function createPipelineWithInstances(checklist, notificationTracker) {
         createStaleDetectionMiddleware(staleDetection),
         createDoomLoopMiddleware(doomLoop),
         createLoopDetectionMiddleware(loopDetector),
+        createMultisetLoopDetectionMiddleware(multisetLoopDetector),
         createToolFlowGateMiddleware({
             rulesProvider: skillRulesProvider.asProvider(),
         }),
@@ -313,6 +418,7 @@ export function createPipelineWithInstances(checklist, notificationTracker) {
         staleDetection,
         doomLoop,
         loopDetector,
+        multisetLoopDetector,
         outputTruncation,
         toolPairValidator,
         guardrailProvider,
@@ -378,6 +484,15 @@ export function getDefaultDoomLoop() {
 export function getDefaultLoopDetector() {
     return defaultLoopDetectorInstance;
 }
+/**
+ * Get the default shared MultisetLoopDetector instance (deer-flow port —
+ * order-independent multiset + per-tool frequency cap + read_file
+ * bucketing). Wired at pipeline order 24.55, immediately after the legacy
+ * LoopDetector at 24.5. Audit finding #4 — zombie module resurrection.
+ */
+export function getDefaultMultisetLoopDetector() {
+    return defaultMultisetLoopDetectorInstance;
+}
 /**
  * Get the default shared OutputTruncationMiddleware instance.
  */