agentic-qe 3.5.4 → 3.6.0

package/v3/dist/kernel/anti-drift-middleware.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Agentic QE v3 - Semantic Anti-Drift Middleware (ADR-060)
+ *
+ * AISP 5.1 Anti-Drift Protocol: for-all s in Sigma: Mean(s) === Mean_0(s).
+ * Attaches a semantic fingerprint (embedding vector) to each domain event at
+ * emission time, verifies cosine similarity at each receiving boundary.
+ * Falls back to deterministic hash-based pseudo-embeddings when the transformer
+ * model is unavailable (test/lightweight environments).
+ */
+import type { DomainEvent, Result } from '../shared/types/index.js';
+/** Signature of a single tool call for loop detection. */
+export interface ToolCallSignature {
+    readonly hash: string;
+    readonly toolName: string;
+    readonly argsFingerprint: string;
+    readonly timestamp: number;
+}
+/** Configuration for the loop detection system. */
+export interface LoopDetectionConfig {
+    readonly maxIdenticalCalls: number;
+    readonly windowMs: number;
+    readonly steeringMessage: string;
+    readonly enableFleetLearning: boolean;
+}
+/** Result of a loop detection check. */
+export interface LoopDetectionResult {
+    readonly isLoop: boolean;
+    readonly callCount: number;
+    readonly signature: ToolCallSignature;
+    readonly action: 'allow' | 'warn' | 'steer';
+    readonly steeringMessage?: string;
+}
+/** Metrics from the loop detection tracker. */
+export interface LoopDetectionMetrics {
+    readonly totalCallsTracked: number;
+    readonly loopsDetected: number;
+}
+/**
+ * ToolCallSignatureTracker - ADR-062 Loop Detection
+ *
+ * Maintains a sliding window of recent tool calls per agent and detects
+ * repetitive loops using a 3-strike rule:
+ * - Strike 1: allow (logged internally)
+ * - Strike 2: warn
+ * - Strike 3+: steer (inject steering message)
+ *
+ * Feature flag: `process.env.AQE_LOOP_DETECTION_ENABLED !== 'false'`
+ */
+export declare class ToolCallSignatureTracker {
+    private readonly config;
+    private readonly callHistory;
+    private totalCallsTracked;
+    private loopsDetected;
+    constructor(config?: Partial<LoopDetectionConfig>);
+    /**
+     * Track a tool call and check for loops.
+     *
+     * @param agentId - The agent making the call
+     * @param toolName - Name of the tool being called
+     * @param args - Arguments to the tool call
+     * @returns Loop detection result with action recommendation
+     */
+    trackCall(agentId: string, toolName: string, args: unknown): LoopDetectionResult;
+    /**
+     * Get metrics about loop detection activity.
+     */
+    getMetrics(): LoopDetectionMetrics;
+    /**
+     * Clear all tracking state.
+     */
+    clear(): void;
+    /**
+     * Create a ToolCallSignature from tool name and arguments.
+     */
+    private createSignature;
+}
+/** Generic middleware contract for the EventBus pipeline. */
+export interface EventMiddleware {
+    readonly name: string;
+    readonly priority: number;
+    /** Called before an event is published. May augment the event. */
+    onEmit?(event: DomainEvent): Promise<DomainEvent>;
+    /** Called on receive. Returning null drops the event. */
+    onReceive?(event: DomainEvent): Promise<DomainEvent | null>;
+}
+/** Configuration for the anti-drift middleware. */
+export interface AntiDriftConfig {
+    /** Per-category cosine-distance thresholds (1 - similarity). */
+    readonly thresholds: Record<string, number>;
+    /** Identifier of the agent that owns this middleware instance. */
+    readonly agentId: string;
+    /** Maximum drift-check results to retain. */
+    readonly maxHistorySize: number;
+    /** Embedding vector dimensionality for the hash-based fallback. */
+    readonly fallbackDimension: number;
+    /** Optional callback invoked when drift is detected. */
+    readonly onDriftDetected?: (event: DomainEvent) => Promise<void>;
+}
+/** Outcome of a single drift check performed by `onReceive`. */
+export interface DriftCheckResult {
+    readonly drifted: boolean;
+    readonly cosineSimilarity: number;
+    readonly threshold: number;
+    readonly eventType: string;
+    readonly hopCount: number;
+    readonly checkedAt: number;
+}
+/** Aggregated statistics about middleware activity. */
+export interface AntiDriftStats {
+    readonly totalChecked: number;
+    readonly driftCount: number;
+    readonly averageSimilarity: number;
+}
+/**
+ * Middleware enforcing semantic stability of domain events across agent-hop
+ * boundaries. `onEmit` computes an embedding and attaches a SemanticFingerprint;
+ * `onReceive` re-embeds and checks cosine distance, dropping drifted events.
+ */
+export declare class SemanticAntiDriftMiddleware implements EventMiddleware {
+    readonly name = "semantic-anti-drift";
+    readonly priority = 10;
+    private readonly config;
+    private readonly history;
+    private totalChecked;
+    private driftCount;
+    private similaritySum;
+    constructor(config?: Partial<AntiDriftConfig>);
+    /**
+     * Compute the semantic embedding of the event payload and attach a
+     * {@link SemanticFingerprint} before publication.
+     * @param event - The domain event about to be published.
+     * @returns The event augmented with a `semanticFingerprint` field.
+     */
+    onEmit(event: DomainEvent): Promise<DomainEvent>;
+    /**
+     * Re-embed the payload and compare with the original fingerprint.
+     * If drift exceeds threshold the event is dropped (returns null) and a
+     * SemanticDriftDetectedEvent is emitted. Events without a fingerprint
+     * pass through unchanged.
+     * @param event - The incoming domain event.
+     * @returns The event with incremented hopCount, or null if drifted.
+     */
+    onReceive(event: DomainEvent): Promise<DomainEvent | null>;
+    /** Returns recent drift check results (bounded by maxHistorySize). */
+    getDriftHistory(): readonly DriftCheckResult[];
+    /** Aggregated statistics about drift checks performed so far. */
+    getStats(): AntiDriftStats;
+    /**
+     * Validate the middleware configuration.
+     * @returns ok(void) if valid, err(Error) otherwise.
+     */
+    validateConfig(): Result<void, Error>;
+    /** Compute embedding, preferring transformer pipeline with hash fallback. */
+    private embed;
+    /** Map event type to threshold category via substring matching. */
+    private resolveCategory;
+    /** Fire a SemanticDriftDetectedEvent via the configured callback. */
+    private emitDriftEvent;
+}
+//# sourceMappingURL=anti-drift-middleware.d.ts.map

package/v3/dist/kernel/anti-drift-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anti-drift-middleware.d.ts","sourceRoot":"","sources":["../../src/kernel/anti-drift-middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAQzF,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACvC;AAED,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAC5C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AA0BD;;;;;;;;;;GAUG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+C;IAC3E,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,aAAa,CAAK;gBAEd,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAIjD;;;;;;;OAOG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,mBAAmB;IAmEhF;;OAEG;IACH,UAAU,IAAI,oBAAoB;IAOlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,OAAO,CAAC,eAAe;CAaxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,MAAM,CAAC,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAClD,yDAAyD;IACzD,SAAS,CAAC,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC7D;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,mEAAmE;IACnE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,wDAAwD;IACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AA2ED;;;;GAIG;AACH,qBAAa,2BAA4B,YAAW,eAAe;IACjE,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,QAAQ,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;gBAEd,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAQ7C;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAetD;;;;;;;OAOG;IACG,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAkChE,sEAAsE;IACtE,eAAe,IAAI,SAAS,gBAAgB,EAAE;IAI9C,iEAAiE;IACjE,QAAQ,IAAI,cAAc;IAQ1B;;;OAGG;IACH,cAAc,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;IAWrC,6EAA6E;YAC/D,KAAK;IAMnB,mEAAmE;IACnE,OAAO,CAAC,eAAe;IAQvB,qEAAqE;YACvD,cAAc;CAuB7B"}

package/v3/dist/kernel/anti-drift-middleware.js

@@ -0,0 +1,376 @@
+/**
+ * Agentic QE v3 - Semantic Anti-Drift Middleware (ADR-060)
+ *
+ * AISP 5.1 Anti-Drift Protocol: for-all s in Sigma: Mean(s) === Mean_0(s).
+ * Attaches a semantic fingerprint (embedding vector) to each domain event at
+ * emission time, verifies cosine similarity at each receiving boundary.
+ * Falls back to deterministic hash-based pseudo-embeddings when the transformer
+ * model is unavailable (test/lightweight environments).
+ */
+import { ok, err } from '../shared/types/index.js';
+import { cosineSimilarity } from '../shared/utils/vector-math.js';
+/** Default loop detection configuration. */
+const DEFAULT_LOOP_DETECTION_CONFIG = {
+    maxIdenticalCalls: 3,
+    windowMs: 30000,
+    steeringMessage: 'Loop detected: the same tool call has been repeated multiple times. Consider an alternative approach or different parameters.',
+    enableFleetLearning: false,
+};
+/**
+ * FNV-1a hash implementation for tool call signature hashing.
+ * Produces a deterministic 32-bit hash as a hex string.
+ *
+ * @param input - The string to hash
+ * @returns Hex string representation of the FNV-1a hash
+ */
+function fnv1aHash(input) {
+    let hash = 0x811c9dc5; // FNV offset basis
+    for (let i = 0; i < input.length; i++) {
+        hash ^= input.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193); // FNV prime
+    }
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+/**
+ * ToolCallSignatureTracker - ADR-062 Loop Detection
+ *
+ * Maintains a sliding window of recent tool calls per agent and detects
+ * repetitive loops using a 3-strike rule:
+ * - Strike 1: allow (logged internally)
+ * - Strike 2: warn
+ * - Strike 3+: steer (inject steering message)
+ *
+ * Feature flag: `process.env.AQE_LOOP_DETECTION_ENABLED !== 'false'`
+ */
+export class ToolCallSignatureTracker {
+    config;
+    callHistory = new Map();
+    totalCallsTracked = 0;
+    loopsDetected = 0;
+    constructor(config) {
+        this.config = { ...DEFAULT_LOOP_DETECTION_CONFIG, ...config };
+    }
+    /**
+     * Track a tool call and check for loops.
+     *
+     * @param agentId - The agent making the call
+     * @param toolName - Name of the tool being called
+     * @param args - Arguments to the tool call
+     * @returns Loop detection result with action recommendation
+     */
+    trackCall(agentId, toolName, args) {
+        // Feature flag check
+        if (process.env.AQE_LOOP_DETECTION_ENABLED === 'false') {
+            const signature = this.createSignature(toolName, args);
+            return {
+                isLoop: false,
+                callCount: 1,
+                signature,
+                action: 'allow',
+            };
+        }
+        const signature = this.createSignature(toolName, args);
+        this.totalCallsTracked++;
+        // Get or create history for this agent
+        if (!this.callHistory.has(agentId)) {
+            this.callHistory.set(agentId, []);
+        }
+        const history = this.callHistory.get(agentId);
+        // Add current call to history
+        history.push(signature);
+        // Prune calls outside the sliding window
+        const cutoff = Date.now() - this.config.windowMs;
+        const pruneIndex = history.findIndex(s => s.timestamp >= cutoff);
+        if (pruneIndex > 0) {
+            history.splice(0, pruneIndex);
+        }
+        else if (pruneIndex === -1) {
+            // All entries are expired
+            history.length = 0;
+            history.push(signature);
+        }
+        // Count identical calls within the window
+        const identicalCount = history.filter(s => s.hash === signature.hash).length;
+        // Determine action based on strike count
+        if (identicalCount >= this.config.maxIdenticalCalls) {
+            this.loopsDetected++;
+            return {
+                isLoop: true,
+                callCount: identicalCount,
+                signature,
+                action: 'steer',
+                steeringMessage: this.config.steeringMessage,
+            };
+        }
+        if (identicalCount === this.config.maxIdenticalCalls - 1) {
+            return {
+                isLoop: false,
+                callCount: identicalCount,
+                signature,
+                action: 'warn',
+            };
+        }
+        return {
+            isLoop: false,
+            callCount: identicalCount,
+            signature,
+            action: 'allow',
+        };
+    }
+    /**
+     * Get metrics about loop detection activity.
+     */
+    getMetrics() {
+        return {
+            totalCallsTracked: this.totalCallsTracked,
+            loopsDetected: this.loopsDetected,
+        };
+    }
+    /**
+     * Clear all tracking state.
+     */
+    clear() {
+        this.callHistory.clear();
+        this.totalCallsTracked = 0;
+        this.loopsDetected = 0;
+    }
+    /**
+     * Create a ToolCallSignature from tool name and arguments.
+     */
+    createSignature(toolName, args) {
+        const serializedArgs = JSON.stringify(args ?? '');
+        const argsFingerprint = fnv1aHash(serializedArgs);
+        const combinedInput = `${toolName}:${serializedArgs}`;
+        const hash = fnv1aHash(combinedInput);
+        return {
+            hash,
+            toolName,
+            argsFingerprint,
+            timestamp: Date.now(),
+        };
+    }
+}
+/** Default cosine-distance thresholds per event category. */
+const DEFAULT_THRESHOLDS = {
+    'quality-gate': 0.05, // tight
+    'coverage': 0.10, // moderate
+    'test-generation': 0.15, // relaxed
+    'learning': 0.20, // most relaxed
+    'default': 0.12,
+};
+const DEFAULT_CONFIG = {
+    thresholds: DEFAULT_THRESHOLDS,
+    agentId: 'unknown',
+    maxHistorySize: 200,
+    fallbackDimension: 64,
+};
+/**
+ * Deterministic pseudo-embedding via FNV-1a-inspired hash spread.
+ * Not semantically meaningful but sufficient for detecting payload mutations.
+ * @param text - Input text to embed.
+ * @param dim  - Desired vector dimensionality.
+ * @returns A normalised float vector of length `dim`.
+ */
+function hashBasedEmbedding(text, dim) {
+    const vec = new Float64Array(dim);
+    let h1 = 0x811c9dc5;
+    let h2 = 0x01000193;
+    for (let i = 0; i < text.length; i++) {
+        const c = text.charCodeAt(i);
+        h1 ^= c;
+        h1 = Math.imul(h1, 0x01000193);
+        h2 ^= c;
+        h2 = Math.imul(h2, 0x811c9dc5);
+        const idx = (h1 >>> 0) % dim;
+        vec[idx] += ((h2 >>> 0) / 0xffffffff) * 2 - 1;
+    }
+    let norm = 0;
+    for (let i = 0; i < dim; i++)
+        norm += vec[i] * vec[i];
+    norm = Math.sqrt(norm);
+    const result = new Array(dim);
+    for (let i = 0; i < dim; i++)
+        result[i] = norm === 0 ? 0 : vec[i] / norm;
+    return result;
+}
+// Transformer availability probe (lazy, cached)
+let _transformerProbed = false;
+let _transformerAvailable = false;
+let _computeRealEmbedding = null;
+/** Lazily probe whether the transformer pipeline is usable. */
+async function probeTransformer() {
+    if (_transformerProbed)
+        return _transformerAvailable;
+    _transformerProbed = true;
+    try {
+        const mod = await import('../learning/real-embeddings.js');
+        if (typeof mod.isTransformerAvailable === 'function' && mod.isTransformerAvailable()) {
+            _computeRealEmbedding = mod.computeRealEmbedding;
+            _transformerAvailable = true;
+        }
+        else {
+            try {
+                await mod.computeRealEmbedding('probe');
+                _computeRealEmbedding = mod.computeRealEmbedding;
+                _transformerAvailable = true;
+            }
+            catch {
+                _transformerAvailable = false;
+            }
+        }
+    }
+    catch {
+        _transformerAvailable = false;
+    }
+    return _transformerAvailable;
+}
+/**
+ * Middleware enforcing semantic stability of domain events across agent-hop
+ * boundaries. `onEmit` computes an embedding and attaches a SemanticFingerprint;
+ * `onReceive` re-embeds and checks cosine distance, dropping drifted events.
+ */
+export class SemanticAntiDriftMiddleware {
+    name = 'semantic-anti-drift';
+    priority = 10;
+    config;
+    history = [];
+    totalChecked = 0;
+    driftCount = 0;
+    similaritySum = 0;
+    constructor(config) {
+        this.config = {
+            ...DEFAULT_CONFIG,
+            ...config,
+            thresholds: { ...DEFAULT_THRESHOLDS, ...config?.thresholds },
+        };
+    }
+    /**
+     * Compute the semantic embedding of the event payload and attach a
+     * {@link SemanticFingerprint} before publication.
+     * @param event - The domain event about to be published.
+     * @returns The event augmented with a `semanticFingerprint` field.
+     */
+    async onEmit(event) {
+        const payloadText = JSON.stringify(event.payload);
+        const embedding = await this.embed(payloadText);
+        const category = this.resolveCategory(event.type);
+        const threshold = this.config.thresholds[category] ?? this.config.thresholds['default'];
+        const fingerprint = {
+            embedding,
+            driftThreshold: threshold,
+            sourceAgentId: this.config.agentId,
+            hopCount: 0,
+            emittedAt: Date.now(),
+        };
+        return { ...event, semanticFingerprint: fingerprint };
+    }
+    /**
+     * Re-embed the payload and compare with the original fingerprint.
+     * If drift exceeds threshold the event is dropped (returns null) and a
+     * SemanticDriftDetectedEvent is emitted. Events without a fingerprint
+     * pass through unchanged.
+     * @param event - The incoming domain event.
+     * @returns The event with incremented hopCount, or null if drifted.
+     */
+    async onReceive(event) {
+        const fp = event.semanticFingerprint;
+        if (!fp)
+            return event;
+        const payloadText = JSON.stringify(event.payload);
+        const currentEmbedding = await this.embed(payloadText);
+        const similarity = cosineSimilarity(currentEmbedding, fp.embedding);
+        const distance = 1 - similarity;
+        const drifted = distance > fp.driftThreshold;
+        this.totalChecked++;
+        this.similaritySum += similarity;
+        const checkResult = {
+            drifted,
+            cosineSimilarity: similarity,
+            threshold: fp.driftThreshold,
+            eventType: event.type,
+            hopCount: fp.hopCount + 1,
+            checkedAt: Date.now(),
+        };
+        this.history.push(checkResult);
+        if (this.history.length > this.config.maxHistorySize)
+            this.history.shift();
+        if (drifted) {
+            this.driftCount++;
+            await this.emitDriftEvent(event, checkResult);
+            return null;
+        }
+        const updatedFingerprint = { ...fp, hopCount: fp.hopCount + 1 };
+        return { ...event, semanticFingerprint: updatedFingerprint };
+    }
+    /** Returns recent drift check results (bounded by maxHistorySize). */
+    getDriftHistory() {
+        return this.history;
+    }
+    /** Aggregated statistics about drift checks performed so far. */
+    getStats() {
+        return {
+            totalChecked: this.totalChecked,
+            driftCount: this.driftCount,
+            averageSimilarity: this.totalChecked > 0 ? this.similaritySum / this.totalChecked : 0,
+        };
+    }
+    /**
+     * Validate the middleware configuration.
+     * @returns ok(void) if valid, err(Error) otherwise.
+     */
+    validateConfig() {
+        for (const [key, value] of Object.entries(this.config.thresholds)) {
+            if (typeof value !== 'number' || value < 0 || value > 1) {
+                return err(new Error(`Invalid threshold for "${key}": must be between 0 and 1, got ${value}`));
+            }
+        }
+        if (this.config.maxHistorySize <= 0)
+            return err(new Error('maxHistorySize must be positive'));
+        if (this.config.fallbackDimension <= 0)
+            return err(new Error('fallbackDimension must be positive'));
+        return ok(undefined);
+    }
+    /** Compute embedding, preferring transformer pipeline with hash fallback. */
+    async embed(text) {
+        const hasTransformer = await probeTransformer();
+        if (hasTransformer && _computeRealEmbedding)
+            return _computeRealEmbedding(text);
+        return hashBasedEmbedding(text, this.config.fallbackDimension);
+    }
+    /** Map event type to threshold category via substring matching. */
+    resolveCategory(eventType) {
+        const lower = eventType.toLowerCase();
+        for (const category of Object.keys(this.config.thresholds)) {
+            if (category !== 'default' && lower.includes(category))
+                return category;
+        }
+        return 'default';
+    }
+    /** Fire a SemanticDriftDetectedEvent via the configured callback. */
+    async emitDriftEvent(originalEvent, check) {
+        if (!this.config.onDriftDetected)
+            return;
+        const driftEvent = {
+            id: `drift-${originalEvent.id}-${Date.now()}`,
+            type: 'SemanticDriftDetected',
+            timestamp: new Date(),
+            source: originalEvent.source,
+            correlationId: originalEvent.correlationId,
+            payload: {
+                originalEventId: originalEvent.id,
+                originalEventType: originalEvent.type,
+                cosineSimilarity: check.cosineSimilarity,
+                threshold: check.threshold,
+                hopCount: check.hopCount,
+                agentId: this.config.agentId,
+            },
+        };
+        try {
+            await this.config.onDriftDetected(driftEvent);
+        }
+        catch {
+            // Swallow callback errors to avoid disrupting the pipeline.
+        }
+    }
+}
+//# sourceMappingURL=anti-drift-middleware.js.map

package/v3/dist/kernel/anti-drift-middleware.js.map

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

package/v3/dist/kernel/event-bus.d.ts

@@ -7,7 +7,21 @@
  * - Subscription indexes for O(1) lookup (replaces O(n) filter)
  */
 import { DomainEvent, DomainName, EventHandler } from '../shared/types';
-import { EventBus, Subscription, EventFilter } from './interfaces';
+import { EventBus, Subscription, EventFilter, EventMiddleware } from './interfaces';
+/**
+ * Event type constants for loop detection (ADR-062).
+ *
+ * - `loop.warning`  - Emitted on strike 2 (second identical tool call in window)
+ * - `loop.detected` - Emitted on strike 3+ (loop confirmed, steering injected)
+ *
+ * Payload shape: LoopDetectionResult from anti-drift-middleware.ts
+ */
+export declare const LOOP_EVENT_TYPES: {
+    /** Emitted on strike 2: second identical tool call within the sliding window. */
+    LOOP_WARNING: "loop.warning";
+    /** Emitted on strike 3+: loop confirmed, steering message injected. */
+    LOOP_DETECTED: "loop.detected";
+};
 export declare class InMemoryEventBus implements EventBus {
     private subscriptions;
     private subscriptionsByEventType;
@@ -16,7 +30,21 @@ export declare class InMemoryEventBus implements EventBus {
     private eventHistory;
     private maxHistorySize;
     private subscriptionCounter;
+    private middlewares;
     constructor(maxHistorySize?: 10000);
+    /**
+     * ADR-060: Register an event middleware
+     * Middlewares are sorted by priority (lower runs first)
+     */
+    registerMiddleware(middleware: EventMiddleware): void;
+    /**
+     * ADR-060: Remove an event middleware by name
+     */
+    removeMiddleware(name: string): boolean;
+    /**
+     * ADR-060: Get registered middlewares
+     */
+    getMiddlewares(): readonly EventMiddleware[];
     publish<T>(event: DomainEvent<T>): Promise<void>;
     subscribe<T>(eventType: string, handler: EventHandler<T>): Subscription;
     subscribeToChannel(domain: DomainName, handler: EventHandler): Subscription;

package/v3/dist/kernel/event-bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/kernel/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,WAAW,EACX,UAAU,EACV,YAAY,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAYnE,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,OAAO,CAAC,aAAa,CAA6C;IAGlE,OAAO,CAAC,wBAAwB,CAAuC;IACvE,OAAO,CAAC,sBAAsB,CAA2C;IACzE,OAAO,CAAC,qBAAqB,CAA0B;IAGvD,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,cAAc,CAAwC;IAC9D,OAAO,CAAC,mBAAmB,CAAK;gBAEpB,cAAc,QAAuC;IAK3D,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDtD,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY;IAqCvE,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY;IA8BrE,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA4BxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAO/B"}
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/kernel/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,WAAW,EACX,UAAU,EACV,YAAY,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAQpF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB;IAC3B,iFAAiF;;IAEjF,uEAAuE;;CAExE,CAAC;AAUF,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,OAAO,CAAC,aAAa,CAA6C;IAGlE,OAAO,CAAC,wBAAwB,CAAuC;IACvE,OAAO,CAAC,sBAAsB,CAA2C;IACzE,OAAO,CAAC,qBAAqB,CAA0B;IAGvD,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,cAAc,CAAwC;IAC9D,OAAO,CAAC,mBAAmB,CAAK;IAGhC,OAAO,CAAC,WAAW,CAAyB;gBAEhC,cAAc,QAAuC;IAKjE;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAKrD;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IASvC;;OAEG;IACH,cAAc,IAAI,SAAS,eAAe,EAAE;IAItC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEtD,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY;IAqCvE,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY;IA8BrE,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA4BxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/B"}