agentic-qe 3.9.0 → 3.9.2

package/dist/init/find-package-root.js

@@ -0,0 +1,46 @@
+/**
+ * Shared utility: find the agentic-qe package root directory.
+ *
+ * When esbuild bundles the CLI with code-splitting, `import.meta.url`
+ * resolves to `dist/cli/chunks/chunk-XXX.js` (3+ levels deep) instead
+ * of the expected `dist/init/skills-installer.js` (2 levels deep).
+ * Fixed `../../` traversals land at `dist/` instead of the package root,
+ * so skills/agents/helpers can't be found.
+ *
+ * This module walks up from the caller's directory until it finds a
+ * `package.json` with `name === "agentic-qe"`, which works regardless
+ * of how deep the bundle puts the calling file.
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * Find the agentic-qe package root by walking up from `import.meta.url`.
+ *
+ * @param callerMetaUrl – pass `import.meta.url` from the calling module
+ * @param maxDepth      – how many parent directories to check (default 10)
+ * @returns absolute path to the package root, or null if not found
+ */
+export function findPackageRoot(callerMetaUrl, maxDepth = 10) {
+    let dir = dirname(fileURLToPath(callerMetaUrl));
+    for (let i = 0; i < maxDepth; i++) {
+        const pkgPath = join(dir, 'package.json');
+        if (existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+                if (pkg.name === 'agentic-qe') {
+                    return dir;
+                }
+            }
+            catch {
+                // Malformed JSON — keep walking
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break; // filesystem root
+        dir = parent;
+    }
+    return null;
+}
+//# sourceMappingURL=find-package-root.js.map

package/dist/init/n8n-installer.d.ts

@@ -42,11 +42,13 @@ export declare class N8nInstaller {
     private sourceSkillsDir;
     constructor(options: N8nInstallerOptions);
     /**
-     * Find the source n8n agents directory
+     * Find the source n8n agents directory.
+     * n8n agents live under .claude/agents/n8n/ in the package root.
      */
     private findSourceAgentsDir;
     /**
-     * Find the source skills directory
+     * Find the source skills directory.
+     * Skills are in assets/skills/ (canonical npm source).
      */
     private findSourceSkillsDir;
     /**

package/dist/init/n8n-installer.js

@@ -6,12 +6,9 @@
  * Copies agent definitions from .claude/agents/n8n/ and installs n8n-specific skills.
  */
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, copyFileSync, } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
+import { join } from 'path';
 import { toErrorMessage } from '../shared/error-utils.js';
-// ESM compatibility - __dirname is not available in ES modules
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
+import { findPackageRoot } from './find-package-root.js';
 // ============================================================================
 // N8n Agent Categories
 // ============================================================================
@@ -78,40 +75,43 @@ export class N8nInstaller {
     // Source Directory Detection
     // ==========================================================================
     /**
-     * Find the source n8n agents directory
+     * Find the source n8n agents directory.
+     * n8n agents live under .claude/agents/n8n/ in the package root.
      */
     findSourceAgentsDir() {
-        const possiblePaths = [
-            // Development: src/init/ or dist/init/ -> project root
-            join(__dirname, '../../.claude/agents/n8n'),
-            // From project root
-            join(process.cwd(), '.claude/agents/n8n'),
-            // NPM package location
-            join(__dirname, '../../assets/agents/n8n'),
-        ];
+        const pkgRoot = findPackageRoot(import.meta.url);
+        const possiblePaths = [];
+        if (pkgRoot) {
+            possiblePaths.push(join(pkgRoot, '.claude/agents/n8n'));
+        }
+        // Local install: in node_modules
+        possiblePaths.push(join(this.projectRoot, 'node_modules/agentic-qe/.claude/agents/n8n'));
         for (const path of possiblePaths) {
             if (existsSync(path)) {
                 return path;
             }
         }
-        // Default to project root location
-        return join(process.cwd(), '.claude/agents/n8n');
+        return possiblePaths[0];
     }
     /**
-     * Find the source skills directory
+     * Find the source skills directory.
+     * Skills are in assets/skills/ (canonical npm source).
      */
     findSourceSkillsDir() {
-        const possiblePaths = [
-            join(__dirname, '../../.claude/skills'),
-            join(process.cwd(), '.claude/skills'),
-            join(__dirname, '../../assets/skills'),
-        ];
+        const pkgRoot = findPackageRoot(import.meta.url);
+        const possiblePaths = [];
+        if (pkgRoot) {
+            possiblePaths.push(join(pkgRoot, 'assets/skills'));
+            possiblePaths.push(join(pkgRoot, '.claude/skills'));
+        }
+        // Local install: in node_modules
+        possiblePaths.push(join(this.projectRoot, 'node_modules/agentic-qe/assets/skills'));
         for (const path of possiblePaths) {
             if (existsSync(path)) {
                 return path;
             }
         }
-        return join(process.cwd(), '.claude/skills');
+        return possiblePaths[0];
     }
     // ==========================================================================
     // Installation

package/dist/init/opencode-installer.d.ts

@@ -37,11 +37,6 @@ export declare class OpenCodeInstaller {
      * globally-installed and bundled CLI paths all work correctly (#361).
      */
     private findSourceDir;
-    /**
-     * Try to find the package root via require.resolve on our own package.json,
-     * then return <root>/.opencode. Returns null if resolution fails.
-     */
-    private resolveViaPackageJson;
     /**
      * Check if a directory is a valid source for OpenCode assets
      * (must exist and contain at least an agents/ or skills/ subdirectory)

package/dist/init/opencode-installer.js

@@ -5,13 +5,10 @@
  * Installs OpenCode agents, skills, tools, and permissions to user projects
  * when --with-opencode flag is used. Follows the N8n installer pattern.
  */
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, copyFileSync, } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
+import { existsSync, mkdirSync, readdirSync, writeFileSync, copyFileSync, } from 'fs';
+import { join } from 'path';
 import { toErrorMessage } from '../shared/error-utils.js';
-// ESM compatibility
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
+import { findPackageRoot } from './find-package-root.js';
 // ============================================================================
 // OpenCode Installer Class
 // ============================================================================
@@ -40,14 +37,14 @@ export class OpenCodeInstaller {
      */
     findSourceDir() {
         const targetDir = join(this.projectRoot, '.opencode');
-        const possiblePaths = [
-            // From dist/init/ or src/init/ → package root .opencode/
-            join(__dirname, '../../.opencode'),
-            // From dist/cli/ (bundle) → package root .opencode/
-            join(__dirname, '../.opencode'),
-            // require.resolve fallback: find the package root via its package.json
-            this.resolveViaPackageJson(),
-        ].filter((p) => p !== null);
+        const pkgRoot = findPackageRoot(import.meta.url);
+        const possiblePaths = [];
+        if (pkgRoot) {
+            // OpenCode assets live at the package root .opencode/ directory
+            possiblePaths.push(join(pkgRoot, '.opencode'));
+        }
+        // Local install: in node_modules
+        possiblePaths.push(join(this.projectRoot, 'node_modules/agentic-qe/.opencode'));
         for (const path of possiblePaths) {
             // Never use the target directory as the source
             if (path === targetDir)
@@ -57,31 +54,7 @@ export class OpenCodeInstaller {
             }
         }
         // Return the first package path even if not found — install() will report the error
-        return possiblePaths[0] ?? join(__dirname, '../../.opencode');
-    }
-    /**
-     * Try to find the package root via require.resolve on our own package.json,
-     * then return <root>/.opencode. Returns null if resolution fails.
-     */
-    resolveViaPackageJson() {
-        try {
-            // Walk up from __dirname to find the nearest package.json with our name
-            let dir = __dirname;
-            for (let i = 0; i < 5; i++) {
-                const pkgPath = join(dir, 'package.json');
-                if (existsSync(pkgPath)) {
-                    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
-                    if (pkg.name === 'agentic-qe') {
-                        return join(dir, '.opencode');
-                    }
-                }
-                dir = dirname(dir);
-            }
-        }
-        catch {
-            // resolution failed
-        }
-        return null;
+        return possiblePaths[0] ?? join(this.projectRoot, 'node_modules/agentic-qe/.opencode');
     }
     /**
      * Check if a directory is a valid source for OpenCode assets

package/dist/init/skills-installer.d.ts

@@ -40,8 +40,11 @@ export declare class SkillsInstaller {
     private sourceSkillsDir;
     constructor(options: SkillsInstallerOptions);
     /**
-     * Find the source skills directory
-     * Looks in multiple locations to support different installation scenarios
+     * Find the source skills directory.
+     *
+     * Uses findPackageRoot() to reliably locate the package root regardless
+     * of esbuild bundle depth (dist/init/, dist/cli/, dist/cli/chunks/, etc.).
+     * Prioritises assets/skills/ (canonical npm source) over .claude/skills/.
      */
     private findSourceSkillsDir;
     /**

package/dist/init/skills-installer.js

@@ -6,9 +6,9 @@
  * Skills are copied from the bundled skills directory to the project's .claude/skills/.
  */
 import { existsSync, mkdirSync, readdirSync, statSync, readFileSync, writeFileSync, copyFileSync, unlinkSync, rmdirSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
+import { join } from 'path';
 import { toErrorMessage } from '../shared/error-utils.js';
+import { findPackageRoot } from './find-package-root.js';
 // ============================================================================
 // Skill Categories (QE Skills Only - Claude Flow skills are managed separately)
 // ============================================================================
@@ -135,44 +135,22 @@ export class SkillsInstaller {
         this.sourceSkillsDir = this.findSourceSkillsDir();
     }
     /**
-     * Find the source skills directory
-     * Looks in multiple locations to support different installation scenarios
+     * Find the source skills directory.
+     *
+     * Uses findPackageRoot() to reliably locate the package root regardless
+     * of esbuild bundle depth (dist/init/, dist/cli/, dist/cli/chunks/, etc.).
+     * Prioritises assets/skills/ (canonical npm source) over .claude/skills/.
      */
     findSourceSkillsDir() {
-        // Try relative to this module (development)
-        const moduleDir = dirname(fileURLToPath(import.meta.url));
-        // Possible locations for skills
-        const possiblePaths = [
-            // Development: relative to src/init/ or dist/init/ (2 levels up to project root)
-            join(moduleDir, '../../.claude/skills'),
-            // NPM package: assets directory at package root (dist/init -> dist -> package root)
-            join(moduleDir, '../../assets/skills'),
-            // Local install: in node_modules
-            join(this.projectRoot, 'node_modules/agentic-qe/assets/skills'),
-            join(this.projectRoot, 'node_modules/agentic-qe/assets/skills'),
-        ];
-        // For global npm installs, add common global node_modules paths
-        // Note: We use platform-based heuristics instead of npm prefix lookup
-        // to avoid dynamic require issues in ESM bundles
-        const homeDir = process.env.HOME || process.env.USERPROFILE || '';
-        const isWindows = process.platform === 'win32';
-        if (isWindows) {
-            // Windows: npm global is typically in AppData
-            const appData = process.env.APPDATA || join(homeDir, 'AppData', 'Roaming');
-            possiblePaths.push(join(appData, 'npm/node_modules/agentic-qe/assets/skills'), join(appData, 'npm/node_modules/agentic-qe/.claude/skills'));
-        }
-        else {
-            // Unix/Linux/macOS: common global prefixes
-            const globalPrefixes = [
-                '/usr/local',
-                '/usr',
-                join(homeDir, '.npm-global'),
-                join(homeDir, '.nvm/versions/node', process.version),
-            ];
-            for (const prefix of globalPrefixes) {
-                possiblePaths.push(join(prefix, 'lib/node_modules/agentic-qe/assets/skills'), join(prefix, 'lib/node_modules/agentic-qe/.claude/skills'), join(prefix, 'node_modules/agentic-qe/assets/skills'), join(prefix, 'node_modules/agentic-qe/.claude/skills'));
-            }
+        const pkgRoot = findPackageRoot(import.meta.url);
+        const possiblePaths = [];
+        if (pkgRoot) {
+            // Canonical npm source — assets/ is never a dotfile, always extracted
+            possiblePaths.push(join(pkgRoot, 'assets/skills'));
+            possiblePaths.push(join(pkgRoot, '.claude/skills'));
         }
+        // Local install: in node_modules
+        possiblePaths.push(join(this.projectRoot, 'node_modules/agentic-qe/assets/skills'));
         for (const skillsPath of possiblePaths) {
             if (existsSync(skillsPath)) {
                 return skillsPath;

package/dist/integrations/embeddings/index/HNSWIndex.d.ts

@@ -4,6 +4,9 @@
  * Shared HNSW indexing between QE and claude-flow per ADR-040.
  * Performance: 150x-12,500x faster than linear search
  *
+ * When useUnifiedHnsw feature flag is enabled (ADR-071), all namespaces
+ * are routed through the unified HnswAdapter backend instead of hnswlib-node.
+ *
  * @module integrations/embeddings/index/HNSWIndex
  */
 import type { IEmbedding, IHNSWConfig, EmbeddingNamespace, ISearchOptions } from '../base/types.js';
@@ -18,6 +21,8 @@ export declare class HNSWEmbeddingIndex {
     private config;
     private initialized;
     private nextId;
+    private unifiedAdapters;
+    private readonly useUnified;
     constructor(config?: Partial<IHNSWConfig>);
     /**
      * Initialize index for a namespace
@@ -51,11 +56,13 @@ export declare class HNSWEmbeddingIndex {
         metric: string;
     } | null;
     /**
-     * Save index to file
+     * Save index to file.
+     * Not supported when using unified backend (HnswAdapter manages persistence).
      */
     saveIndex(namespace: EmbeddingNamespace, path: string): Promise<void>;
     /**
-     * Load index from file
+     * Load index from file.
+     * Not supported when using unified backend (HnswAdapter manages persistence).
      */
     loadIndex(namespace: EmbeddingNamespace, path: string): Promise<void>;
     /**

package/dist/integrations/embeddings/index/HNSWIndex.js

@@ -4,12 +4,21 @@
  * Shared HNSW indexing between QE and claude-flow per ADR-040.
  * Performance: 150x-12,500x faster than linear search
  *
+ * When useUnifiedHnsw feature flag is enabled (ADR-071), all namespaces
+ * are routed through the unified HnswAdapter backend instead of hnswlib-node.
+ *
  * @module integrations/embeddings/index/HNSWIndex
  */
 // ESM/CJS interop: hnswlib-node is CommonJS, we import via default export
 // This pattern matches real-qe-reasoning-bank.ts for consistency
 import hnswlib from 'hnswlib-node';
 const { HierarchicalNSW } = hnswlib;
+// ADR-071 Phase 2C: Always use unified HnswAdapter backend.
+// The hnswlib-node legacy path below is retained as dead code for
+// emergency rollback only — production always takes the adapter path.
+function isUnifiedHnswActive() {
+    return true;
+}
 /**
  * HNSW index manager
  *
@@ -21,6 +30,9 @@ export class HNSWEmbeddingIndex {
     config;
     initialized;
     nextId;
+    // ADR-071: Unified backend adapters per namespace (when useUnifiedHnsw=true)
+    unifiedAdapters = null;
+    useUnified;
     constructor(config = {}) {
         this.config = {
             M: config.M || 16,
@@ -33,6 +45,10 @@ export class HNSWEmbeddingIndex {
         this.indexes = new Map();
         this.initialized = new Set();
         this.nextId = new Map();
+        this.useUnified = isUnifiedHnswActive();
+        if (this.useUnified) {
+            this.unifiedAdapters = new Map();
+        }
     }
     /**
      * Initialize index for a namespace
@@ -41,6 +57,28 @@ export class HNSWEmbeddingIndex {
         if (this.initialized.has(namespace)) {
             return;
         }
+        // ADR-071: Route through unified HnswAdapter when flag is enabled
+        if (this.useUnified && this.unifiedAdapters) {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const { HnswAdapter } = require('../../../kernel/hnsw-adapter.js');
+                const adapter = new HnswAdapter(`embedding-${namespace}`, {
+                    dimensions: this.config.dimension,
+                    M: this.config.M,
+                    efConstruction: this.config.efConstruction,
+                    efSearch: this.config.efSearch,
+                    metric: this.config.metric === 'dotproduct' ? 'cosine' : this.config.metric,
+                });
+                this.unifiedAdapters.set(namespace, adapter);
+                this.initialized.add(namespace);
+                this.nextId.set(namespace, 0);
+                return;
+            }
+            catch {
+                // Fall through to hnswlib-node
+            }
+        }
+        // Legacy path: hnswlib-node
         // Map our metric names to hnswlib-node space names
         const spaceMap = {
             'cosine': 'cosine',
@@ -66,14 +104,23 @@ export class HNSWEmbeddingIndex {
         if (!this.initialized.has(namespace)) {
             this.initializeIndex(namespace);
         }
-        const index = this.indexes.get(namespace);
-        // Convert vector to float array
-        const vector = this.toFloatArray(embedding.vector);
         // Use provided ID or auto-increment
         const actualId = id ?? this.nextId.get(namespace);
         if (id === undefined) {
             this.nextId.set(namespace, actualId + 1);
         }
+        // ADR-071: Route through unified backend
+        const adapter = this.unifiedAdapters?.get(namespace);
+        if (adapter) {
+            const vector = embedding.vector instanceof Float32Array
+                ? embedding.vector
+                : new Float32Array(this.toFloatArray(embedding.vector));
+            adapter.add(actualId, vector);
+            return actualId;
+        }
+        // Legacy path
+        const index = this.indexes.get(namespace);
+        const vector = this.toFloatArray(embedding.vector);
         index.addPoint(vector, actualId);
         return actualId;
     }
@@ -81,33 +128,8 @@ export class HNSWEmbeddingIndex {
      * Add multiple embeddings to index
      */
     addEmbeddingsBatch(embeddings) {
-        const ids = [];
-        // Group by namespace
-        const byNamespace = new Map();
-        for (const item of embeddings) {
-            const ns = item.embedding.namespace;
-            if (!byNamespace.has(ns)) {
-                byNamespace.set(ns, []);
-            }
-            byNamespace.get(ns).push(item);
-        }
-        // Add to each namespace's index
-        for (const [namespace, items] of byNamespace.entries()) {
-            if (!this.initialized.has(namespace)) {
-                this.initializeIndex(namespace);
-            }
-            const index = this.indexes.get(namespace);
-            for (const item of items) {
-                const vector = this.toFloatArray(item.embedding.vector);
-                const actualId = item.id ?? this.nextId.get(namespace);
-                if (item.id === undefined) {
-                    this.nextId.set(namespace, actualId + 1);
-                }
-                index.addPoint(vector, actualId);
-                ids.push(actualId);
-            }
-        }
-        return ids;
+        // ADR-071: Route each item through addEmbedding() which handles unified routing
+        return embeddings.map(item => this.addEmbedding(item.embedding, item.id));
     }
     /**
      * Search for similar embeddings
@@ -117,11 +139,22 @@ export class HNSWEmbeddingIndex {
         if (!this.initialized.has(namespace)) {
             return [];
         }
-        const index = this.indexes.get(namespace);
         const k = options.limit || 10;
-        // Convert query vector
+        // ADR-071: Route through unified backend
+        const adapter = this.unifiedAdapters?.get(namespace);
+        if (adapter) {
+            const queryVector = query.vector instanceof Float32Array
+                ? query.vector
+                : new Float32Array(this.toFloatArray(query.vector));
+            const results = adapter.search(queryVector, k);
+            return results.map(r => ({
+                id: r.id,
+                distance: 1 - r.score, // convert similarity to distance
+            }));
+        }
+        // Legacy path
+        const index = this.indexes.get(namespace);
         const queryVector = this.toFloatArray(query.vector);
-        // Search
         const result = index.searchKnn(queryVector, k);
         // Convert hnswlib-node result format to our format
         return result.neighbors.map((id, i) => ({
@@ -136,6 +169,16 @@ export class HNSWEmbeddingIndex {
         if (!this.initialized.has(namespace)) {
             return null;
         }
+        // ADR-071: Use unified adapter stats
+        const adapter = this.unifiedAdapters?.get(namespace);
+        if (adapter) {
+            return {
+                size: adapter.size(),
+                maxElements: 10000,
+                dimension: adapter.dimensions(),
+                metric: this.config.metric,
+            };
+        }
         const index = this.indexes.get(namespace);
         return {
             size: index.getCurrentCount(), // Note: This may not be available in all versions
@@ -145,19 +188,33 @@ export class HNSWEmbeddingIndex {
         };
     }
     /**
-     * Save index to file
+     * Save index to file.
+     * Not supported when using unified backend (HnswAdapter manages persistence).
      */
     async saveIndex(namespace, path) {
         if (!this.initialized.has(namespace)) {
             throw new Error(`Namespace ${namespace} not initialized`);
         }
+        // ADR-071: Unified backend manages its own persistence
+        if (this.unifiedAdapters?.has(namespace)) {
+            console.warn(`[HNSWEmbeddingIndex] saveIndex() is a no-op for namespace '${namespace}' — ` +
+                `unified HnswAdapter manages persistence internally.`);
+            return;
+        }
         const index = this.indexes.get(namespace);
         await index.writeIndex(path);
     }
     /**
-     * Load index from file
+     * Load index from file.
+     * Not supported when using unified backend (HnswAdapter manages persistence).
      */
     async loadIndex(namespace, path) {
+        // ADR-071: Unified backend manages its own persistence
+        if (this.useUnified) {
+            console.warn(`[HNSWEmbeddingIndex] loadIndex() is a no-op for namespace '${namespace}' — ` +
+                `unified HnswAdapter manages persistence internally. Initialize via initializeIndex() instead.`);
+            return;
+        }
         const spaceMap = {
             'cosine': 'cosine',
             'euclidean': 'l2',
@@ -174,6 +231,12 @@ export class HNSWEmbeddingIndex {
      */
     clearIndex(namespace) {
         if (this.initialized.has(namespace)) {
+            // ADR-071: Clear unified adapter if present
+            const adapter = this.unifiedAdapters?.get(namespace);
+            if (adapter) {
+                adapter.clear?.();
+                this.unifiedAdapters.delete(namespace);
+            }
             this.indexes.delete(namespace);
             this.initialized.delete(namespace);
             this.nextId.delete(namespace);
@@ -183,6 +246,13 @@ export class HNSWEmbeddingIndex {
      * Clear all indexes
      */
     clearAll() {
+        // ADR-071: Clear all unified adapters
+        if (this.unifiedAdapters) {
+            for (const adapter of this.unifiedAdapters.values()) {
+                adapter.clear?.();
+            }
+            this.unifiedAdapters.clear();
+        }
         this.indexes.clear();
         this.initialized.clear();
         this.nextId.clear();
@@ -263,6 +333,11 @@ export class HNSWEmbeddingIndex {
         if (!this.initialized.has(namespace)) {
             return 0;
         }
+        // ADR-071: Use unified adapter size when available
+        const adapter = this.unifiedAdapters?.get(namespace);
+        if (adapter) {
+            return adapter.size();
+        }
         return this.nextId.get(namespace) || 0;
     }
 }

package/dist/integrations/ruvector/cognitive-routing.d.ts

@@ -0,0 +1,67 @@
+export interface CognitiveRoutingConfig {
+    predictionWindowSize: number;
+    compressionThreshold: number;
+    maxConcurrentStreams: number;
+    oscillationFrequencyMs: number;
+}
+export interface RoutedMessage {
+    streamId: string;
+    senderId: string;
+    receiverId: string;
+    payload: unknown;
+    compressed: boolean;
+    originalSize: number;
+    compressedSize: number;
+    timestamp: number;
+}
+export interface RoutingStats {
+    totalMessages: number;
+    compressedMessages: number;
+    bandwidthSavedBytes: number;
+    bandwidthReductionPercent: number;
+    activeStreams: number;
+}
+/** Sliding-window predictor: predicts next payload as copy of last seen. */
+export declare class MessagePredictor {
+    private readonly windowSize;
+    private readonly windows;
+    constructor(windowSize: number);
+    predict(streamId: string): Record<string, unknown> | null;
+    record(streamId: string, payload: unknown): void;
+    removeStream(streamId: string): void;
+}
+/** Round-robin multiplexer for concurrent message streams. */
+export declare class OscillatoryRouter {
+    private readonly maxStreams;
+    readonly cycleMs: number;
+    private readonly streamIds;
+    private currentIndex;
+    constructor(maxStreams: number, cycleMs: number);
+    addStream(streamId: string): boolean;
+    removeStream(streamId: string): boolean;
+    nextStream(): string | null;
+    getActiveStreams(): string[];
+    get activeCount(): number;
+}
+/** Combines MessagePredictor + OscillatoryRouter for bandwidth-efficient routing. */
+export declare class CognitiveRouter {
+    private readonly config;
+    private readonly predictor;
+    private readonly router;
+    private readonly lastPayloads;
+    private totalMessages;
+    private compressedMessages;
+    private totalOriginalBytes;
+    private totalCompressedBytes;
+    constructor(config?: Partial<CognitiveRoutingConfig>);
+    send(streamId: string, senderId: string, receiverId: string, payload: unknown): RoutedMessage;
+    receive(message: RoutedMessage): unknown;
+    getStats(): RoutingStats;
+    addStream(streamId: string): void;
+    removeStream(streamId: string): void;
+}
+/** Create a CognitiveRouter if the feature flag is enabled, otherwise null. */
+export declare function createCognitiveRouter(config?: Partial<CognitiveRoutingConfig>): CognitiveRouter | null;
+/** Check if Cognitive Routing feature flag is enabled. */
+export declare function isCognitiveRoutingEnabled(): boolean;
+//# sourceMappingURL=cognitive-routing.d.ts.map