agentic-qe 3.3.4 → 3.4.0

package/v3/dist/memory/crdt/types.d.ts

@@ -0,0 +1,397 @@
+/**
+ * CRDT Type Definitions
+ *
+ * Conflict-free Replicated Data Types for eventually consistent
+ * distributed state across agents.
+ *
+ * @module memory/crdt/types
+ * @see ADR-054: A2A Protocol Integration (distributed state)
+ * @see Implementation Plan Task 4.2
+ */
+/**
+ * Supported CRDT types in the store
+ */
+export type CRDTType = 'lww-register' | 'g-counter' | 'pn-counter' | 'or-set';
+/**
+ * Base state for all CRDTs - includes version for delta tracking
+ */
+export interface CRDTBaseState {
+    /** Version counter for delta replication */
+    version: number;
+    /** Timestamp of last update */
+    lastUpdated: number;
+}
+/**
+ * Last-Write-Wins Register state
+ */
+export interface LWWRegisterState<T> extends CRDTBaseState {
+    /** Current value (undefined if never set) */
+    value: T | undefined;
+    /** Timestamp when value was set */
+    timestamp: number;
+    /** Node ID that set the value */
+    nodeId: string;
+}
+/**
+ * LWW-Register interface for storing single values with timestamp-based conflict resolution
+ */
+export interface LWWRegister<T> {
+    /** Get current value */
+    get(): T | undefined;
+    /** Set value with optional timestamp (defaults to Date.now()) */
+    set(value: T, timestamp?: number): void;
+    /** Merge with another register (commutative operation) */
+    merge(other: LWWRegister<T>): void;
+    /** Get state for replication */
+    getState(): LWWRegisterState<T>;
+    /** Apply state from another replica */
+    applyState(state: LWWRegisterState<T>): void;
+    /** Get node ID */
+    getNodeId(): string;
+    /** Get timestamp of current value */
+    getTimestamp(): number;
+}
+/**
+ * Grow-only Counter state (per-node counts)
+ */
+export interface GCounterState extends CRDTBaseState {
+    /** Map of node ID to count */
+    counts: Record<string, number>;
+}
+/**
+ * G-Counter interface - only supports increment operations
+ */
+export interface GCounter {
+    /** Get current total count */
+    get(): number;
+    /** Increment by n (default 1) */
+    increment(n?: number): void;
+    /** Merge with another counter (commutative operation) */
+    merge(other: GCounter): void;
+    /** Get state for replication */
+    getState(): GCounterState;
+    /** Apply state from another replica */
+    applyState(state: GCounterState): void;
+    /** Get node ID */
+    getNodeId(): string;
+    /** Get local count for this node */
+    getLocalCount(): number;
+}
+/**
+ * Positive-Negative Counter state (two G-Counters)
+ */
+export interface PNCounterState extends CRDTBaseState {
+    /** Positive counter state */
+    positive: GCounterState;
+    /** Negative counter state */
+    negative: GCounterState;
+}
+/**
+ * PN-Counter interface - supports both increment and decrement
+ */
+export interface PNCounter {
+    /** Get current count (positive - negative) */
+    get(): number;
+    /** Increment by n (default 1) */
+    increment(n?: number): void;
+    /** Decrement by n (default 1) */
+    decrement(n?: number): void;
+    /** Merge with another counter (commutative operation) */
+    merge(other: PNCounter): void;
+    /** Get state for replication */
+    getState(): PNCounterState;
+    /** Apply state from another replica */
+    applyState(state: PNCounterState): void;
+    /** Get node ID */
+    getNodeId(): string;
+}
+/**
+ * Element with unique tags for OR-Set
+ */
+export interface ORSetElement<T> {
+    /** Element value */
+    value: T;
+    /** Unique tags associated with this element */
+    tags: Set<string>;
+}
+/**
+ * Observed-Remove Set state
+ */
+export interface ORSetState<T> extends CRDTBaseState {
+    /**
+     * Map of serialized elements to their unique tags
+     * Tags are unique identifiers (nodeId:timestamp:counter)
+     */
+    elements: Record<string, string[]>;
+    /**
+     * Map of serialized elements to tombstone tags (removed tags)
+     */
+    tombstones: Record<string, string[]>;
+}
+/**
+ * OR-Set interface - set with add-wins semantics on concurrent add/remove
+ */
+export interface ORSet<T> {
+    /** Check if element exists */
+    has(element: T): boolean;
+    /** Get all elements as array */
+    values(): T[];
+    /** Get size of set */
+    size(): number;
+    /** Add element to set */
+    add(element: T): void;
+    /** Remove element from set */
+    remove(element: T): void;
+    /** Merge with another set (commutative operation) */
+    merge(other: ORSet<T>): void;
+    /** Get state for replication */
+    getState(): ORSetState<T>;
+    /** Apply state from another replica */
+    applyState(state: ORSetState<T>): void;
+    /** Get node ID */
+    getNodeId(): string;
+    /** Clear all elements (removes all with tombstones) */
+    clear(): void;
+}
+/**
+ * Change event emitted by CRDT store
+ */
+export interface CRDTChangeEvent {
+    /** Key that changed */
+    key: string;
+    /** Type of CRDT */
+    type: CRDTType;
+    /** Operation that triggered change */
+    operation: 'set' | 'increment' | 'decrement' | 'add' | 'remove' | 'merge';
+    /** Timestamp of change */
+    timestamp: number;
+    /** Node that made the change */
+    nodeId: string;
+}
+/**
+ * Full store state for replication
+ */
+export interface CRDTStoreState {
+    /** Version of store state */
+    version: number;
+    /** Timestamp of state */
+    timestamp: number;
+    /** Node ID */
+    nodeId: string;
+    /** LWW Registers */
+    registers: Record<string, LWWRegisterState<unknown>>;
+    /** G-Counters */
+    gCounters: Record<string, GCounterState>;
+    /** PN-Counters */
+    pnCounters: Record<string, PNCounterState>;
+    /** OR-Sets */
+    sets: Record<string, ORSetState<unknown>>;
+}
+/**
+ * Delta state for efficient incremental replication
+ */
+export interface CRDTStoreDelta {
+    /** Version range this delta covers (from exclusive, to inclusive) */
+    fromVersion: number;
+    toVersion: number;
+    /** Timestamp when delta was generated */
+    timestamp: number;
+    /** Node ID that generated delta */
+    nodeId: string;
+    /** Changed registers */
+    registers?: Record<string, LWWRegisterState<unknown>>;
+    /** Changed G-Counters */
+    gCounters?: Record<string, GCounterState>;
+    /** Changed PN-Counters */
+    pnCounters?: Record<string, PNCounterState>;
+    /** Changed OR-Sets */
+    sets?: Record<string, ORSetState<unknown>>;
+}
+/**
+ * CRDT Store configuration
+ */
+export interface CRDTStoreConfig {
+    /** Unique node ID for this store instance */
+    nodeId: string;
+    /** Enable delta tracking for efficient replication */
+    enableDeltaTracking?: boolean;
+    /** Maximum deltas to keep in history */
+    maxDeltaHistory?: number;
+}
+/**
+ * Event listener callback type
+ */
+export type CRDTChangeListener = (event: CRDTChangeEvent) => void;
+/**
+ * Unified CRDT Store interface
+ */
+export interface CRDTStore {
+    /** Get a LWW register by key (creates if not exists) */
+    getRegister<T>(key: string): LWWRegister<T>;
+    /** Set a register value directly */
+    setRegister<T>(key: string, value: T): void;
+    /** Check if register exists */
+    hasRegister(key: string): boolean;
+    /** Delete a register */
+    deleteRegister(key: string): boolean;
+    /** Get a G-Counter by key (creates if not exists) */
+    getGCounter(key: string): GCounter;
+    /** Increment a G-Counter directly */
+    incrementGCounter(key: string, n?: number): void;
+    /** Check if G-Counter exists */
+    hasGCounter(key: string): boolean;
+    /** Delete a G-Counter */
+    deleteGCounter(key: string): boolean;
+    /** Get a PN-Counter by key (creates if not exists) */
+    getCounter(key: string): PNCounter;
+    /** Increment a PN-Counter directly */
+    incrementCounter(key: string, n?: number): void;
+    /** Decrement a PN-Counter directly */
+    decrementCounter(key: string, n?: number): void;
+    /** Check if PN-Counter exists */
+    hasCounter(key: string): boolean;
+    /** Delete a PN-Counter */
+    deleteCounter(key: string): boolean;
+    /** Get an OR-Set by key (creates if not exists) */
+    getSet<T>(key: string): ORSet<T>;
+    /** Add element to set directly */
+    addToSet<T>(key: string, element: T): void;
+    /** Remove element from set directly */
+    removeFromSet<T>(key: string, element: T): void;
+    /** Check if OR-Set exists */
+    hasSet(key: string): boolean;
+    /** Delete an OR-Set */
+    deleteSet(key: string): boolean;
+    /** Merge entire store with another store */
+    merge(other: CRDTStore): void;
+    /** Get full store state for replication */
+    getState(): CRDTStoreState;
+    /** Apply full state from another replica */
+    applyState(state: CRDTStoreState): void;
+    /** Get delta since version (for efficient sync) */
+    getDelta(sinceVersion: number): CRDTStoreDelta | null;
+    /** Apply delta from another replica */
+    applyDelta(delta: CRDTStoreDelta): void;
+    /** Get current version */
+    getVersion(): number;
+    /** Get node ID */
+    getNodeId(): string;
+    /** Subscribe to change events */
+    on(event: 'change', callback: CRDTChangeListener): () => void;
+    /** Remove all listeners */
+    removeAllListeners(): void;
+    /** Get all keys by type */
+    keys(type?: CRDTType): string[];
+    /** Clear all data */
+    clear(): void;
+    /** Get statistics */
+    getStats(): CRDTStoreStats;
+}
+/**
+ * Store statistics
+ */
+export interface CRDTStoreStats {
+    /** Total number of CRDTs */
+    total: number;
+    /** Number of registers */
+    registers: number;
+    /** Number of G-Counters */
+    gCounters: number;
+    /** Number of PN-Counters */
+    pnCounters: number;
+    /** Number of OR-Sets */
+    sets: number;
+    /** Current version */
+    version: number;
+    /** Node ID */
+    nodeId: string;
+    /** Deltas in history */
+    deltaHistorySize: number;
+}
+/**
+ * Node state snapshot for convergence tracking
+ */
+export interface NodeStateSnapshot {
+    /** Node ID */
+    nodeId: string;
+    /** State version */
+    version: number;
+    /** Timestamp when recorded */
+    timestamp: number;
+    /** Hash of state (for quick comparison) */
+    stateHash: string;
+}
+/**
+ * Convergence status
+ */
+export interface ConvergenceStatus {
+    /** Whether all tracked nodes have converged */
+    converged: boolean;
+    /** Total number of tracked nodes */
+    nodeCount: number;
+    /** Number of nodes that are synced */
+    syncedNodes: number;
+    /** List of node IDs that are behind */
+    laggingNodes: string[];
+    /** Timestamp of last convergence (null if never converged) */
+    lastConvergenceTime: number | null;
+    /** Maximum version across all nodes */
+    maxVersion: number;
+    /** Minimum version across all nodes */
+    minVersion: number;
+}
+/**
+ * Convergence tracker configuration
+ */
+export interface ConvergenceTrackerConfig {
+    /** How long to keep node state history (ms) */
+    historyRetentionMs?: number;
+    /** Consider node stale after this time (ms) */
+    staleThresholdMs?: number;
+}
+/**
+ * Convergence tracker interface
+ */
+export interface ConvergenceTracker {
+    /** Record node state */
+    recordNodeState(nodeId: string, state: CRDTStoreState): void;
+    /** Check if all tracked nodes have converged */
+    hasConverged(): boolean;
+    /** Get detailed convergence status */
+    getStatus(): ConvergenceStatus;
+    /** Get list of lagging nodes */
+    getLaggingNodes(): string[];
+    /** Get time since last convergence (ms, null if never converged) */
+    getTimeSinceConvergence(): number | null;
+    /** Remove node from tracking */
+    removeNode(nodeId: string): void;
+    /** Clear all tracked state */
+    clear(): void;
+    /** Get all tracked node IDs */
+    getTrackedNodes(): string[];
+    /** Check if a node is being tracked */
+    isTracking(nodeId: string): boolean;
+    /** Get node's last recorded version */
+    getNodeVersion(nodeId: string): number | null;
+}
+/**
+ * Serialization options for CRDT state
+ */
+export interface SerializationOptions {
+    /** Include timestamps in output */
+    includeTimestamps?: boolean;
+    /** Pretty print JSON */
+    prettyPrint?: boolean;
+}
+/**
+ * Result of a merge operation
+ */
+export interface MergeResult {
+    /** Whether the merge changed local state */
+    changed: boolean;
+    /** Number of CRDTs affected */
+    affected: number;
+    /** Keys that were updated */
+    updatedKeys: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/v3/dist/memory/crdt/types.d.ts.map

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

package/v3/dist/memory/crdt/types.js

@@ -0,0 +1,12 @@
+/**
+ * CRDT Type Definitions
+ *
+ * Conflict-free Replicated Data Types for eventually consistent
+ * distributed state across agents.
+ *
+ * @module memory/crdt/types
+ * @see ADR-054: A2A Protocol Integration (distributed state)
+ * @see Implementation Plan Task 4.2
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/v3/dist/memory/crdt/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/memory/crdt/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/v3/dist/memory/index.d.ts

@@ -1,9 +1,12 @@
 /**
- * Memory Index
+ * Memory Module
  *
- * Re-exports all memory services.
+ * Re-exports all memory services including:
+ * - Cross-phase memory for QCSD feedback loops
+ * - CRDT-based distributed memory for multi-agent state
  *
  * @module memory
  */
 export * from './cross-phase-memory.js';
+export * from './crdt/index.js';
 //# sourceMappingURL=index.d.ts.map

package/v3/dist/memory/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC"}

package/v3/dist/memory/index.js

@@ -1,9 +1,12 @@
 /**
- * Memory Index
+ * Memory Module
  *
- * Re-exports all memory services.
+ * Re-exports all memory services including:
+ * - Cross-phase memory for QCSD feedback loops
+ * - CRDT-based distributed memory for multi-agent state
  *
  * @module memory
  */
 export * from './cross-phase-memory.js';
+export * from './crdt/index.js';
 //# sourceMappingURL=index.js.map

package/v3/dist/memory/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC"}

package/v3/dist/performance/benchmarks.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Agentic QE v3 - Performance Benchmark Suite
+ * Comprehensive benchmarks for AG-UI, A2A, and A2UI protocols
+ *
+ * Issue #177 Targets:
+ * - AG-UI streaming: <100ms p95
+ * - A2A task submission: <200ms p95
+ * - A2UI surface generation: <150ms p95
+ */
+/**
+ * Performance targets from Issue #177
+ */
+export declare const PERFORMANCE_TARGETS: {
+    readonly aguiEventEmission: {
+        readonly p95: 10;
+    };
+    readonly aguiStateSync: {
+        readonly p95: 50;
+    };
+    readonly aguiSSEStreaming: {
+        readonly p95: 100;
+    };
+    readonly a2aTaskSubmission: {
+        readonly p95: 200;
+    };
+    readonly a2aAgentDiscovery: {
+        readonly p95: 100;
+    };
+    readonly a2aJSONRPCParsing: {
+        readonly p95: 5;
+    };
+    readonly a2uiSurfaceGeneration: {
+        readonly p95: 150;
+    };
+    readonly a2uiDataBinding: {
+        readonly p95: 20;
+    };
+    readonly a2uiComponentValidation: {
+        readonly p95: 10;
+    };
+    readonly memoryPeak: number;
+    readonly throughput: 1000;
+};
+/**
+ * Individual benchmark result
+ */
+export interface BenchmarkResult {
+    /** Benchmark name */
+    readonly name: string;
+    /** Number of iterations performed */
+    readonly iterations: number;
+    /** Operations per second */
+    readonly opsPerSecond: number;
+    /** Average time in milliseconds */
+    readonly avgTime: number;
+    /** P50 (median) in milliseconds */
+    readonly p50: number;
+    /** P95 in milliseconds */
+    readonly p95: number;
+    /** P99 in milliseconds */
+    readonly p99: number;
+    /** Maximum time in milliseconds */
+    readonly maxTime: number;
+    /** Minimum time in milliseconds */
+    readonly minTime: number;
+    /** Memory delta in bytes */
+    readonly memoryDelta: number;
+    /** Whether target was met */
+    readonly passed: boolean;
+    /** Target time in ms (if applicable) */
+    readonly target?: number;
+    /** Timestamp */
+    readonly timestamp: number;
+    /** Additional metadata */
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Complete benchmark results
+ */
+export interface BenchmarkResults {
+    /** All benchmark results */
+    readonly results: BenchmarkResult[];
+    /** Overall pass/fail */
+    readonly allPassed: boolean;
+    /** Total duration in milliseconds */
+    readonly totalDuration: number;
+    /** Start timestamp */
+    readonly startedAt: number;
+    /** End timestamp */
+    readonly endedAt: number;
+    /** System info */
+    readonly system: {
+        readonly nodeVersion: string;
+        readonly platform: string;
+        readonly arch: string;
+        readonly cpus: number;
+        readonly memory: number;
+    };
+}
+/**
+ * Benchmark configuration
+ */
+export interface BenchmarkConfig {
+    /** Number of iterations per benchmark */
+    readonly iterations: number;
+    /** Warmup iterations (not counted) */
+    readonly warmupIterations: number;
+    /** Timeout per benchmark in milliseconds */
+    readonly timeout: number;
+    /** Whether to run GC between benchmarks */
+    readonly forceGC: boolean;
+    /** Whether to track memory */
+    readonly trackMemory: boolean;
+    /** Profiler configuration */
+    readonly profilerConfig?: Record<string, unknown>;
+}
+/**
+ * Benchmark function type
+ */
+export type BenchmarkFn = () => void | Promise<void>;
+/**
+ * BenchmarkSuite - Comprehensive performance benchmark runner
+ *
+ * Features:
+ * - Configurable iterations and warmup
+ * - Memory tracking
+ * - P50/P95/P99 percentile calculations
+ * - Target validation
+ * - System info collection
+ */
+export declare class BenchmarkSuite {
+    private readonly config;
+    private readonly profiler;
+    private readonly results;
+    constructor(config?: Partial<BenchmarkConfig>);
+    /**
+     * Run all defined benchmarks
+     */
+    runAll(): Promise<BenchmarkResults>;
+    /**
+     * Run a specific benchmark by name
+     */
+    run(name: string): Promise<BenchmarkResult>;
+    /**
+     * Benchmark AG-UI event emission
+     */
+    benchmarkAGUIEventEmission(): Promise<BenchmarkResult>;
+    /**
+     * Benchmark AG-UI state synchronization
+     */
+    benchmarkAGUIStateSync(): Promise<BenchmarkResult>;
+    /**
+     * Benchmark AG-UI SSE streaming
+     */
+    benchmarkAGUISSEStreaming(): Promise<BenchmarkResult>;
+    /**
+     * Benchmark A2A task submission
+     */
+    benchmarkA2ATaskSubmission(): Promise<BenchmarkResult>;
+    /**
+     * Benchmark A2A agent discovery
+     */
+    benchmarkA2AAgentDiscovery(): Promise<BenchmarkResult>;
+    /**
+     * Benchmark A2A JSON-RPC parsing
+     */
+    benchmarkA2AJSONRPCParsing(): Promise<BenchmarkResult>;
+    /**
+     * Benchmark A2UI surface generation
+     */
+    benchmarkA2UISurfaceGeneration(): Promise<BenchmarkResult>;
+    /**
+     * Benchmark A2UI data binding
+     */
+    benchmarkA2UIDataBinding(): Promise<BenchmarkResult>;
+    /**
+     * Benchmark A2UI component validation
+     */
+    benchmarkA2UIComponentValidation(): Promise<BenchmarkResult>;
+    /**
+     * Benchmark end-to-end flow across all protocols
+     */
+    benchmarkEndToEndFlow(): Promise<BenchmarkResult>;
+    /**
+     * Benchmark memory under load
+     */
+    benchmarkMemoryUnderLoad(): Promise<BenchmarkResult>;
+    /**
+     * Run a single benchmark function
+     */
+    private runBenchmark;
+    private percentile;
+    private getSystemInfo;
+    /**
+     * Get all benchmark results
+     */
+    getResults(): BenchmarkResult[];
+    /**
+     * Get result by name
+     */
+    getResult(name: string): BenchmarkResult | undefined;
+    /**
+     * Clear all results
+     */
+    clearResults(): void;
+    /**
+     * Destroy the benchmark suite
+     */
+    destroy(): void;
+}
+/**
+ * Create a new BenchmarkSuite instance
+ */
+export declare function createBenchmarkSuite(config?: Partial<BenchmarkConfig>): BenchmarkSuite;
+//# sourceMappingURL=benchmarks.d.ts.map

package/v3/dist/performance/benchmarks.d.ts.map

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