@framers/agentos 0.1.120 → 0.1.122

package/dist/query-router/QueryClassifier.js.map

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

package/dist/query-router/QueryDispatcher.d.ts

@@ -4,12 +4,22 @@
  * @module @framers/agentos/query-router/QueryDispatcher
  *
  * The dispatcher is the second stage of the QueryRouter pipeline, invoked
- * after the QueryClassifier has assigned a complexity tier. It orchestrates
- * vector search, knowledge-graph expansion, reranking, and deep research
- * by delegating to injected callback functions — it has no direct coupling
- * to EmbeddingManager, VectorStoreManager, or any concrete service.
+ * after the QueryClassifier has assigned a complexity tier **and** a
+ * retrieval strategy. It orchestrates vector search, HyDE (Hypothetical
+ * Document Embedding) search, knowledge-graph expansion, reranking, deep
+ * research, and query decomposition by delegating to injected callback
+ * functions — it has no direct coupling to EmbeddingManager,
+ * VectorStoreManager, HydeRetriever, or any concrete service.
  *
- * **Tier behaviour:**
+ * **Strategy behaviour (new):**
+ * - `none`:     Skip retrieval entirely, return empty.
+ * - `simple`:   Direct vector search only (topK=5). No HyDE overhead.
+ * - `moderate`: HyDE-powered search — generate hypothesis, embed, search.
+ *               Falls back to direct vector search if HyDE unavailable.
+ * - `complex`:  Decompose the query into sub-queries, run HyDE per
+ *               sub-query, merge/dedup/rank the combined results.
+ *
+ * **Tier behaviour (legacy, still supported):**
  * - T0: Trivial — no retrieval, returns empty immediately
  * - T1: Simple lookup — vector search only (topK=5)
  * - T2: Multi-source — vector(15) + graph expand + merge/dedup + rerank(5)
@@ -20,7 +30,7 @@
  * gracefully rather than crashing the pipeline. A `retrieve:fallback` event
  * is emitted for each degradation so consumers have full observability.
  */
-import type { QueryTier, RetrievedChunk, RetrievalResult, QueryRouterEventUnion } from './types.js';
+import type { QueryTier, RetrievalStrategy, RetrievedChunk, RetrievalResult, QueryRouterEventUnion } from './types.js';
 /**
  * Callback dependencies injected into the QueryDispatcher.
  *
@@ -30,11 +40,40 @@ import type { QueryTier, RetrievedChunk, RetrievalResult, QueryRouterEventUnion
  */
 export interface QueryDispatcherDeps {
     /**
-     * Dense vector similarity search.
+     * Dense vector similarity search (direct embedding of the raw query).
      * @param query - The user query string.
      * @param topK  - Maximum number of chunks to return.
      */
     vectorSearch: (query: string, topK: number) => Promise<RetrievedChunk[]>;
+    /**
+     * HyDE-powered vector search.
+     *
+     * Generates a hypothetical answer via LLM, embeds *that* answer, then
+     * searches the vector store. Bridges vocabulary gaps between questions
+     * and stored documents. (Gao et al. 2023)
+     *
+     * When `undefined`, the dispatcher falls back to `vectorSearch` for
+     * moderate/complex strategies.
+     *
+     * @param query - The user query string.
+     * @param topK  - Maximum number of chunks to return.
+     * @returns Retrieved chunks with relevance scores.
+     */
+    hydeSearch?: (query: string, topK: number) => Promise<RetrievedChunk[]>;
+    /**
+     * Decompose a complex query into independent sub-queries.
+     *
+     * Used by the `complex` strategy to split multi-part questions before
+     * running HyDE per sub-query.
+     *
+     * When `undefined`, the dispatcher runs the full query through HyDE
+     * as a single pass (equivalent to `moderate`).
+     *
+     * @param query        - The original multi-part user query.
+     * @param maxSubQueries - Maximum number of sub-queries to generate.
+     * @returns Array of decomposed sub-query strings.
+     */
+    decompose?: (query: string, maxSubQueries: number) => Promise<string[]>;
     /**
      * Knowledge-graph expansion starting from seed chunks.
      * Returns additional related chunks discovered via graph traversal.
@@ -66,14 +105,26 @@ export interface QueryDispatcherDeps {
     graphEnabled: boolean;
     /** Whether deep research is available / enabled. */
     deepResearchEnabled: boolean;
+    /**
+     * Maximum number of sub-queries for decomposition.
+     * Only relevant for the `complex` strategy.
+     * @default 5
+     */
+    maxSubQueries?: number;
 }
 /**
- * Routes classified queries to the tier-appropriate retrieval pipeline.
+ * Routes classified queries to the strategy-appropriate retrieval pipeline.
+ *
+ * Supports both the new strategy-based dispatch ({@link dispatchByStrategy})
+ * and the legacy tier-based dispatch ({@link dispatch}) for backward
+ * compatibility.
  *
  * @example
  * ```typescript
  * const dispatcher = new QueryDispatcher({
  *   vectorSearch: async (q, k) => vectorStore.search(q, k),
+ *   hydeSearch:   async (q, k) => hydeRetriever.search(q, k),
+ *   decompose:    async (q, max) => decomposer.decompose(q, max),
  *   graphExpand:  async (seeds) => graphRag.expand(seeds),
  *   rerank:       async (q, chunks, n) => reranker.rerank(q, chunks, n),
  *   deepResearch: async (q, srcs) => researcher.research(q, srcs),
@@ -82,6 +133,10 @@ export interface QueryDispatcherDeps {
  *   deepResearchEnabled: true,
  * });
  *
+ * // Strategy-based (preferred):
+ * const result = await dispatcher.dispatchByStrategy('How does auth work?', 'moderate');
+ *
+ * // Tier-based (legacy):
  * const result = await dispatcher.dispatch('How does auth work?', 2);
  * ```
  */
@@ -89,9 +144,26 @@ export declare class QueryDispatcher {
     /** Injected retrieval dependencies. */
     private readonly deps;
     constructor(deps: QueryDispatcherDeps);
+    /**
+     * Dispatch a query using the recommended retrieval strategy.
+     *
+     * This is the preferred entry point for the HyDE-aware routing pipeline.
+     * The strategy is typically produced by the QueryClassifier's LLM-as-judge
+     * or heuristic classifier.
+     *
+     * @param query    - The user's natural-language query.
+     * @param strategy - Retrieval strategy (`none`, `simple`, `moderate`, `complex`).
+     * @param suggestedSources - Optional source hints for deep research (complex).
+     * @returns Aggregated retrieval result with chunks, optional synthesis,
+     *          and timing metadata.
+     */
+    dispatchByStrategy(query: string, strategy: RetrievalStrategy, suggestedSources?: string[]): Promise<RetrievalResult>;
     /**
      * Dispatch a classified query to the tier-appropriate retrieval pipeline.
      *
+     * This is the legacy entry point. For HyDE-aware routing, prefer
+     * {@link dispatchByStrategy}.
+     *
      * @param query            - The user's natural-language query.
      * @param tier             - Complexity tier assigned by the QueryClassifier.
      * @param suggestedSources - Optional source hints for deep research (T3).
@@ -100,6 +172,32 @@ export declare class QueryDispatcher {
      *          and timing metadata.
      */
     dispatch(query: string, tier: QueryTier, suggestedSources?: string[]): Promise<RetrievalResult>;
+    /**
+     * Simple strategy pipeline: direct vector search only, topK=5.
+     *
+     * No HyDE hypothesis generation, no graph traversal, no reranking.
+     * Best for concrete queries with vocabulary that matches stored docs.
+     */
+    private dispatchSimple;
+    /**
+     * Moderate strategy pipeline: HyDE-powered search + optional graph + rerank.
+     *
+     * Generates a hypothetical answer, embeds *that* for vector search, then
+     * optionally expands via graph traversal and reranks. Falls back to direct
+     * vector search if HyDE is unavailable.
+     */
+    private dispatchModerate;
+    /**
+     * Complex strategy pipeline: decompose → HyDE per sub-query → merge → rank.
+     *
+     * For multi-part queries, decomposes into independent sub-queries, runs
+     * HyDE search per sub-query, deduplicates and ranks the combined results.
+     * Falls back to moderate (single HyDE pass) if decomposition fails.
+     *
+     * When deep research is enabled, a research synthesis pass runs after the
+     * merged retrieval stage (inheriting from the T3 pipeline).
+     */
+    private dispatchComplex;
     /**
      * Tier 1 pipeline: vector search only, topK=5.
      * No graph traversal, no reranking, no research.

package/dist/query-router/QueryDispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueryDispatcher.d.ts","sourceRoot":"","sources":["../../src/query-router/QueryDispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,eAAe,EACf,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAMpB;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEzE;;;;OAIG;IACH,WAAW,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE7F;;;;OAIG;IACH,YAAY,EAAE,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,KACd,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IAE/D;;;OAGG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAE7C,4DAA4D;IAC5D,YAAY,EAAE,OAAO,CAAC;IAEtB,oDAAoD;IACpD,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAe;IAC1B,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;gBAE/B,IAAI,EAAE,mBAAmB;IAQrC;;;;;;;;;OASG;IACG,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,EACf,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC,eAAe,CAAC;IAgC3B;;;OAGG;YACW,aAAa;IA0B3B;;;;;;OAMG;YACW,aAAa;IAI3B;;;;OAIG;YACW,qBAAqB;IA0FnC;;;;;OAKG;YACW,aAAa;IAiF3B;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;CAsBtB"}
+{"version":3,"file":"QueryDispatcher.d.ts","sourceRoot":"","sources":["../../src/query-router/QueryDispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAMpB;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEzE;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAExE;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAExE;;;;OAIG;IACH,WAAW,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE7F;;;;OAIG;IACH,YAAY,EAAE,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,KACd,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IAE/D;;;OAGG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAE7C,4DAA4D;IAC5D,YAAY,EAAE,OAAO,CAAC;IAEtB,oDAAoD;IACpD,mBAAmB,EAAE,OAAO,CAAC;IAE7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,eAAe;IAC1B,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;gBAE/B,IAAI,EAAE,mBAAmB;IAQrC;;;;;;;;;;;;OAYG;IACG,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,iBAAiB,EAC3B,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC,eAAe,CAAC;IAqC3B;;;;;;;;;;;;OAYG;IACG,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,EACf,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC,eAAe,CAAC;IAgC3B;;;;;OAKG;YACW,cAAc;IA0B5B;;;;;;OAMG;YACW,gBAAgB;IA4G9B;;;;;;;;;OASG;YACW,eAAe;IAmM7B;;;OAGG;YACW,aAAa;IA0B3B;;;;;;OAMG;YACW,aAAa;IAI3B;;;;OAIG;YACW,qBAAqB;IA0FnC;;;;;OAKG;YACW,aAAa;IAiF3B;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;CAsBtB"}

package/dist/query-router/QueryDispatcher.js

@@ -4,12 +4,22 @@
  * @module @framers/agentos/query-router/QueryDispatcher
  *
  * The dispatcher is the second stage of the QueryRouter pipeline, invoked
- * after the QueryClassifier has assigned a complexity tier. It orchestrates
- * vector search, knowledge-graph expansion, reranking, and deep research
- * by delegating to injected callback functions — it has no direct coupling
- * to EmbeddingManager, VectorStoreManager, or any concrete service.
+ * after the QueryClassifier has assigned a complexity tier **and** a
+ * retrieval strategy. It orchestrates vector search, HyDE (Hypothetical
+ * Document Embedding) search, knowledge-graph expansion, reranking, deep
+ * research, and query decomposition by delegating to injected callback
+ * functions — it has no direct coupling to EmbeddingManager,
+ * VectorStoreManager, HydeRetriever, or any concrete service.
  *
- * **Tier behaviour:**
+ * **Strategy behaviour (new):**
+ * - `none`:     Skip retrieval entirely, return empty.
+ * - `simple`:   Direct vector search only (topK=5). No HyDE overhead.
+ * - `moderate`: HyDE-powered search — generate hypothesis, embed, search.
+ *               Falls back to direct vector search if HyDE unavailable.
+ * - `complex`:  Decompose the query into sub-queries, run HyDE per
+ *               sub-query, merge/dedup/rank the combined results.
+ *
+ * **Tier behaviour (legacy, still supported):**
  * - T0: Trivial — no retrieval, returns empty immediately
  * - T1: Simple lookup — vector search only (topK=5)
  * - T2: Multi-source — vector(15) + graph expand + merge/dedup + rerank(5)
@@ -20,16 +30,23 @@
  * gracefully rather than crashing the pipeline. A `retrieve:fallback` event
  * is emitted for each degradation so consumers have full observability.
  */
+import { STRATEGY_TO_TIER, } from './types.js';
 // ============================================================================
 // QUERY DISPATCHER
 // ============================================================================
 /**
- * Routes classified queries to the tier-appropriate retrieval pipeline.
+ * Routes classified queries to the strategy-appropriate retrieval pipeline.
+ *
+ * Supports both the new strategy-based dispatch ({@link dispatchByStrategy})
+ * and the legacy tier-based dispatch ({@link dispatch}) for backward
+ * compatibility.
  *
  * @example
  * ```typescript
  * const dispatcher = new QueryDispatcher({
  *   vectorSearch: async (q, k) => vectorStore.search(q, k),
+ *   hydeSearch:   async (q, k) => hydeRetriever.search(q, k),
+ *   decompose:    async (q, max) => decomposer.decompose(q, max),
  *   graphExpand:  async (seeds) => graphRag.expand(seeds),
  *   rerank:       async (q, chunks, n) => reranker.rerank(q, chunks, n),
  *   deepResearch: async (q, srcs) => researcher.research(q, srcs),
@@ -38,6 +55,10 @@
  *   deepResearchEnabled: true,
  * });
  *
+ * // Strategy-based (preferred):
+ * const result = await dispatcher.dispatchByStrategy('How does auth work?', 'moderate');
+ *
+ * // Tier-based (legacy):
  * const result = await dispatcher.dispatch('How does auth work?', 2);
  * ```
  */
@@ -46,11 +67,55 @@ export class QueryDispatcher {
         this.deps = deps;
     }
     // --------------------------------------------------------------------------
-    // PUBLIC API
+    // PUBLIC API — Strategy-based dispatch (new)
+    // --------------------------------------------------------------------------
+    /**
+     * Dispatch a query using the recommended retrieval strategy.
+     *
+     * This is the preferred entry point for the HyDE-aware routing pipeline.
+     * The strategy is typically produced by the QueryClassifier's LLM-as-judge
+     * or heuristic classifier.
+     *
+     * @param query    - The user's natural-language query.
+     * @param strategy - Retrieval strategy (`none`, `simple`, `moderate`, `complex`).
+     * @param suggestedSources - Optional source hints for deep research (complex).
+     * @returns Aggregated retrieval result with chunks, optional synthesis,
+     *          and timing metadata.
+     */
+    async dispatchByStrategy(query, strategy, suggestedSources) {
+        // Map strategy to tier for event emission
+        const tier = STRATEGY_TO_TIER[strategy];
+        // none → skip retrieval entirely
+        if (strategy === 'none') {
+            return { chunks: [], durationMs: 0 };
+        }
+        const start = Date.now();
+        this.deps.emit({
+            type: 'retrieve:start',
+            tier,
+            timestamp: Date.now(),
+        });
+        switch (strategy) {
+            case 'simple':
+                return this.dispatchSimple(query, start);
+            case 'moderate':
+                return this.dispatchModerate(query, start);
+            case 'complex':
+                return this.dispatchComplex(query, suggestedSources ?? ['web'], start);
+            default:
+                // Unreachable for valid RetrievalStrategy, but TypeScript exhaustiveness
+                return this.dispatchSimple(query, start);
+        }
+    }
+    // --------------------------------------------------------------------------
+    // PUBLIC API — Tier-based dispatch (legacy)
     // --------------------------------------------------------------------------
     /**
      * Dispatch a classified query to the tier-appropriate retrieval pipeline.
      *
+     * This is the legacy entry point. For HyDE-aware routing, prefer
+     * {@link dispatchByStrategy}.
+     *
      * @param query            - The user's natural-language query.
      * @param tier             - Complexity tier assigned by the QueryClassifier.
      * @param suggestedSources - Optional source hints for deep research (T3).
@@ -81,7 +146,321 @@ export class QueryDispatcher {
         return this.dispatchTier3(query, suggestedSources ?? ['web'], start);
     }
     // --------------------------------------------------------------------------
-    // TIER PIPELINES
+    // STRATEGY PIPELINES (new — HyDE-aware)
+    // --------------------------------------------------------------------------
+    /**
+     * Simple strategy pipeline: direct vector search only, topK=5.
+     *
+     * No HyDE hypothesis generation, no graph traversal, no reranking.
+     * Best for concrete queries with vocabulary that matches stored docs.
+     */
+    async dispatchSimple(query, start) {
+        const vectorStart = Date.now();
+        const chunks = await this.deps.vectorSearch(query, 5);
+        const vectorDuration = Date.now() - vectorStart;
+        this.deps.emit({
+            type: 'retrieve:vector',
+            chunkCount: chunks.length,
+            durationMs: vectorDuration,
+            timestamp: Date.now(),
+        });
+        const result = {
+            chunks,
+            durationMs: Date.now() - start,
+        };
+        this.deps.emit({
+            type: 'retrieve:complete',
+            result,
+            timestamp: Date.now(),
+        });
+        return result;
+    }
+    /**
+     * Moderate strategy pipeline: HyDE-powered search + optional graph + rerank.
+     *
+     * Generates a hypothetical answer, embeds *that* for vector search, then
+     * optionally expands via graph traversal and reranks. Falls back to direct
+     * vector search if HyDE is unavailable.
+     */
+    async dispatchModerate(query, start) {
+        // --- HyDE search (topK=15 for graph+rerank pipeline) ---
+        const hydeStart = Date.now();
+        let hydeChunks;
+        if (this.deps.hydeSearch) {
+            try {
+                hydeChunks = await this.deps.hydeSearch(query, 15);
+            }
+            catch (err) {
+                // HyDE failed — fall back to direct vector search
+                this.deps.emit({
+                    type: 'retrieve:fallback',
+                    strategy: 'hyde-to-vector',
+                    reason: `HyDE search failed: ${err.message}`,
+                    timestamp: Date.now(),
+                });
+                hydeChunks = await this.deps.vectorSearch(query, 15);
+            }
+        }
+        else {
+            // HyDE not available — use direct vector search
+            this.deps.emit({
+                type: 'retrieve:fallback',
+                strategy: 'hyde-unavailable',
+                reason: 'HyDE search not configured; using direct vector search',
+                timestamp: Date.now(),
+            });
+            hydeChunks = await this.deps.vectorSearch(query, 15);
+        }
+        const hydeDuration = Date.now() - hydeStart;
+        this.deps.emit({
+            type: 'retrieve:vector',
+            chunkCount: hydeChunks.length,
+            durationMs: hydeDuration,
+            timestamp: Date.now(),
+        });
+        // --- Graph expansion (fallback-safe) ---
+        let graphChunks = [];
+        if (this.deps.graphEnabled) {
+            const graphStart = Date.now();
+            try {
+                graphChunks = await this.deps.graphExpand(hydeChunks);
+                const graphDuration = Date.now() - graphStart;
+                this.deps.emit({
+                    type: 'retrieve:graph',
+                    entityCount: graphChunks.length,
+                    durationMs: graphDuration,
+                    timestamp: Date.now(),
+                });
+            }
+            catch (err) {
+                this.deps.emit({
+                    type: 'retrieve:fallback',
+                    strategy: 'graph-skip',
+                    reason: `Graph expansion failed: ${err.message}`,
+                    timestamp: Date.now(),
+                });
+            }
+        }
+        // --- Merge + deduplicate ---
+        const merged = this.mergeAndDedup(hydeChunks, graphChunks);
+        // --- Rerank (fallback-safe) ---
+        let finalChunks;
+        const rerankStart = Date.now();
+        try {
+            finalChunks = await this.deps.rerank(query, merged, 5);
+            const rerankDuration = Date.now() - rerankStart;
+            this.deps.emit({
+                type: 'retrieve:rerank',
+                inputCount: merged.length,
+                outputCount: finalChunks.length,
+                durationMs: rerankDuration,
+                timestamp: Date.now(),
+            });
+        }
+        catch (err) {
+            finalChunks = [...merged]
+                .sort((a, b) => b.relevanceScore - a.relevanceScore)
+                .slice(0, 5);
+            this.deps.emit({
+                type: 'retrieve:fallback',
+                strategy: 'rerank-skip',
+                reason: `Rerank failed: ${err.message}`,
+                timestamp: Date.now(),
+            });
+        }
+        const result = {
+            chunks: finalChunks,
+            durationMs: Date.now() - start,
+        };
+        this.deps.emit({
+            type: 'retrieve:complete',
+            result,
+            timestamp: Date.now(),
+        });
+        return result;
+    }
+    /**
+     * Complex strategy pipeline: decompose → HyDE per sub-query → merge → rank.
+     *
+     * For multi-part queries, decomposes into independent sub-queries, runs
+     * HyDE search per sub-query, deduplicates and ranks the combined results.
+     * Falls back to moderate (single HyDE pass) if decomposition fails.
+     *
+     * When deep research is enabled, a research synthesis pass runs after the
+     * merged retrieval stage (inheriting from the T3 pipeline).
+     */
+    async dispatchComplex(query, suggestedSources, start) {
+        const maxSubQueries = this.deps.maxSubQueries ?? 5;
+        // --- Step 1: Decompose the query into sub-queries ---
+        let subQueries;
+        const decomposeStart = Date.now();
+        if (this.deps.decompose) {
+            try {
+                subQueries = await this.deps.decompose(query, maxSubQueries);
+                this.deps.emit({
+                    type: 'strategy:decompose',
+                    originalQuery: query,
+                    subQueries,
+                    durationMs: Date.now() - decomposeStart,
+                    timestamp: Date.now(),
+                });
+            }
+            catch (err) {
+                // Decomposition failed — fall through to single-pass HyDE
+                this.deps.emit({
+                    type: 'retrieve:fallback',
+                    strategy: 'decompose-skip',
+                    reason: `Query decomposition failed: ${err.message}`,
+                    timestamp: Date.now(),
+                });
+                subQueries = [query];
+            }
+        }
+        else {
+            // No decomposer available — use the original query as-is
+            subQueries = [query];
+        }
+        // --- Step 2: HyDE search per sub-query ---
+        const allChunks = [];
+        const searchFn = this.deps.hydeSearch ?? this.deps.vectorSearch;
+        for (const subQuery of subQueries) {
+            const subStart = Date.now();
+            try {
+                const chunks = await searchFn(subQuery, 10);
+                allChunks.push(...chunks);
+                this.deps.emit({
+                    type: 'retrieve:vector',
+                    chunkCount: chunks.length,
+                    durationMs: Date.now() - subStart,
+                    timestamp: Date.now(),
+                });
+            }
+            catch (err) {
+                // Sub-query search failed — try direct vector search as fallback
+                this.deps.emit({
+                    type: 'retrieve:fallback',
+                    strategy: 'sub-query-fallback',
+                    reason: `Sub-query search failed for "${subQuery.slice(0, 60)}": ${err.message}`,
+                    timestamp: Date.now(),
+                });
+                try {
+                    const fallbackChunks = await this.deps.vectorSearch(subQuery, 10);
+                    allChunks.push(...fallbackChunks);
+                }
+                catch {
+                    // Both failed — skip this sub-query
+                }
+            }
+        }
+        // --- Step 2b: Optional graph expansion (same as moderate pipeline) ---
+        let graphChunks = [];
+        if (this.deps.graphEnabled) {
+            try {
+                graphChunks = await this.deps.graphExpand(allChunks);
+                this.deps.emit({
+                    type: 'retrieve:graph',
+                    entityCount: graphChunks.length,
+                    durationMs: 0,
+                    timestamp: Date.now(),
+                });
+            }
+            catch (err) {
+                this.deps.emit({
+                    type: 'retrieve:fallback',
+                    strategy: 'graph-skip',
+                    reason: `Graph expansion failed in complex pipeline: ${err.message}`,
+                    timestamp: Date.now(),
+                });
+            }
+        }
+        // --- Step 3: Deduplicate and rank ---
+        const deduped = this.mergeAndDedup(allChunks, graphChunks);
+        let finalChunks;
+        // Rerank the merged results against the original query
+        const rerankStart = Date.now();
+        try {
+            finalChunks = await this.deps.rerank(query, deduped, 10);
+            const rerankDuration = Date.now() - rerankStart;
+            this.deps.emit({
+                type: 'retrieve:rerank',
+                inputCount: deduped.length,
+                outputCount: finalChunks.length,
+                durationMs: rerankDuration,
+                timestamp: Date.now(),
+            });
+        }
+        catch (err) {
+            finalChunks = [...deduped]
+                .sort((a, b) => b.relevanceScore - a.relevanceScore)
+                .slice(0, 10);
+            this.deps.emit({
+                type: 'retrieve:fallback',
+                strategy: 'rerank-skip',
+                reason: `Rerank failed: ${err.message}`,
+                timestamp: Date.now(),
+            });
+        }
+        // --- Step 4: Optional deep research synthesis ---
+        if (this.deps.deepResearchEnabled) {
+            this.deps.emit({
+                type: 'research:start',
+                query,
+                maxIterations: 3,
+                timestamp: Date.now(),
+            });
+            try {
+                const researchResult = await this.deps.deepResearch(query, suggestedSources);
+                this.deps.emit({
+                    type: 'research:phase',
+                    iteration: 1,
+                    totalIterations: 1,
+                    newChunksFound: researchResult.sources.length,
+                    timestamp: Date.now(),
+                });
+                this.deps.emit({
+                    type: 'research:complete',
+                    iterationsUsed: 1,
+                    totalChunks: researchResult.sources.length,
+                    durationMs: Date.now() - start,
+                    timestamp: Date.now(),
+                });
+                // Merge research chunks with HyDE-gathered chunks
+                const withResearch = this.mergeAndDedup(finalChunks, researchResult.sources);
+                const result = {
+                    chunks: withResearch,
+                    researchSynthesis: researchResult.synthesis,
+                    durationMs: Date.now() - start,
+                };
+                this.deps.emit({
+                    type: 'retrieve:complete',
+                    result,
+                    timestamp: Date.now(),
+                });
+                return result;
+            }
+            catch (err) {
+                this.deps.emit({
+                    type: 'retrieve:fallback',
+                    strategy: 'research-skip',
+                    reason: `Deep research failed: ${err.message}`,
+                    timestamp: Date.now(),
+                });
+            }
+        }
+        // Return merged HyDE results without research
+        const result = {
+            chunks: finalChunks,
+            durationMs: Date.now() - start,
+        };
+        this.deps.emit({
+            type: 'retrieve:complete',
+            result,
+            timestamp: Date.now(),
+        });
+        return result;
+    }
+    // --------------------------------------------------------------------------
+    // TIER PIPELINES (legacy)
     // --------------------------------------------------------------------------
     /**
      * Tier 1 pipeline: vector search only, topK=5.