agentic-qe 1.0.0 → 1.0.1

package/dist/core/coordination/ConsensusGating.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsensusGating = void 0;
+const events_1 = require("events");
+/**
+ * ConsensusGating - Implements consensus-based decision making for agent swarms
+ *
+ * Features:
+ * - Quorum-based voting
+ * - Proposal and voting lifecycle
+ * - Event-driven consensus notifications
+ * - Persistent state management
+ */
+class ConsensusGating extends events_1.EventEmitter {
+    constructor(memory) {
+        super();
+        this.memory = memory;
+    }
+    /**
+     * Propose a decision for consensus
+     * Returns proposal ID for voting
+     */
+    async propose(proposal) {
+        const agentId = proposal.proposer || 'system';
+        const state = {
+            decision: proposal.decision,
+            proposer: agentId,
+            votes: [agentId], // Proposer automatically votes for their proposal
+            quorum: proposal.quorum,
+            status: 'pending',
+            createdAt: Date.now()
+        };
+        await this.memory.store(`consensus:${proposal.id}`, state, {
+            partition: 'consensus_state',
+            ttl: 604800 // 7 days
+        });
+        this.emit('consensus:proposed', { ...proposal, proposer: agentId });
+        return proposal.id;
+    }
+    /**
+     * Vote on a proposal
+     * Returns true if consensus is reached
+     */
+    async vote(proposalId, agentId) {
+        const state = await this.memory.retrieve(`consensus:${proposalId}`, {
+            partition: 'consensus_state'
+        });
+        if (!state) {
+            throw new Error(`Proposal ${proposalId} not found`);
+        }
+        if (state.status !== 'pending') {
+            throw new Error(`Proposal ${proposalId} is already ${state.status}`);
+        }
+        // Prevent duplicate votes
+        if (state.votes.includes(agentId)) {
+            return state.status === 'approved';
+        }
+        state.votes.push(agentId);
+        // Check if quorum is reached (+1 for proposer)
+        if (state.votes.length >= state.quorum + 1) {
+            state.status = 'approved';
+            await this.memory.store(`consensus:${proposalId}`, state, {
+                partition: 'consensus_state'
+            });
+            this.emit('consensus:reached', state);
+            return true;
+        }
+        await this.memory.store(`consensus:${proposalId}`, state, {
+            partition: 'consensus_state'
+        });
+        this.emit('consensus:vote-cast', { proposalId, agentId, votesCount: state.votes.length });
+        return false;
+    }
+    /**
+     * Get current state of a proposal
+     */
+    async getProposalState(proposalId) {
+        return await this.memory.retrieve(`consensus:${proposalId}`, {
+            partition: 'consensus_state'
+        });
+    }
+    /**
+     * Reject a proposal (requires proposer or admin privileges)
+     */
+    async reject(proposalId, agentId) {
+        const state = await this.memory.retrieve(`consensus:${proposalId}`, {
+            partition: 'consensus_state'
+        });
+        if (!state) {
+            throw new Error(`Proposal ${proposalId} not found`);
+        }
+        // Only proposer can reject their own proposal
+        if (state.proposer !== agentId && agentId !== 'admin') {
+            throw new Error(`Only proposer or admin can reject proposal`);
+        }
+        state.status = 'rejected';
+        await this.memory.store(`consensus:${proposalId}`, state, {
+            partition: 'consensus_state'
+        });
+        this.emit('consensus:rejected', { proposalId, rejectedBy: agentId });
+    }
+    /**
+     * Wait for consensus on a proposal
+     */
+    async waitForConsensus(proposalId, timeout = 60000) {
+        const state = await this.getProposalState(proposalId);
+        if (!state) {
+            throw new Error(`Proposal ${proposalId} not found`);
+        }
+        if (state.status === 'approved') {
+            return true;
+        }
+        if (state.status === 'rejected') {
+            return false;
+        }
+        // Wait for consensus event
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.removeListener('consensus:reached', listener);
+                this.removeListener('consensus:rejected', listener);
+                resolve(false);
+            }, timeout);
+            const listener = (eventState) => {
+                if (eventState.decision === state.decision) {
+                    clearTimeout(timer);
+                    this.removeListener('consensus:reached', listener);
+                    this.removeListener('consensus:rejected', listener);
+                    resolve(eventState.status === 'approved');
+                }
+            };
+            this.on('consensus:reached', listener);
+            this.on('consensus:rejected', listener);
+        });
+    }
+}
+exports.ConsensusGating = ConsensusGating;
+//# sourceMappingURL=ConsensusGating.js.map

package/dist/core/coordination/ConsensusGating.js.map

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

package/dist/core/coordination/GOAPCoordination.d.ts

@@ -0,0 +1,79 @@
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { SwarmMemoryManager } from '../memory/SwarmMemoryManager';
+export interface WorldState {
+    [key: string]: any;
+}
+export interface Goal {
+    id: string;
+    conditions: WorldState;
+    priority: number;
+}
+export interface Action {
+    id: string;
+    cost: number;
+    preconditions: WorldState;
+    effects: WorldState;
+    execute: () => Promise<void>;
+}
+export interface Plan {
+    goal: Goal;
+    actions: Action[];
+    totalCost: number;
+    state: 'pending' | 'executing' | 'completed' | 'failed';
+}
+/**
+ * GOAPCoordination - Goal-Oriented Action Planning for agent task coordination
+ *
+ * Uses A* pathfinding to find optimal action sequences to achieve goals
+ *
+ * Features:
+ * - Dynamic goal prioritization
+ * - Cost-based action planning
+ * - World state management
+ * - Plan execution tracking
+ */
+export declare class GOAPCoordination extends EventEmitter {
+    private memory;
+    private actions;
+    private currentWorldState;
+    constructor(memory: SwarmMemoryManager);
+    /**
+     * Register an action that can be used in planning
+     */
+    registerAction(action: Action): void;
+    /**
+     * Update the current world state
+     */
+    updateWorldState(updates: Partial<WorldState>): Promise<void>;
+    /**
+     * Get current world state
+     */
+    getWorldState(): WorldState;
+    /**
+     * Plan actions to achieve a goal using A* algorithm
+     */
+    planForGoal(goal: Goal): Promise<Plan | null>;
+    /**
+     * Execute a plan
+     */
+    executePlan(planId: string): Promise<boolean>;
+    /**
+     * A* pathfinding to find optimal action sequence
+     */
+    private findPlanAStar;
+    /**
+     * Check if current state meets required conditions
+     */
+    private checkConditions;
+    /**
+     * Calculate heuristic (estimated cost to goal)
+     * Simple implementation: count of unmet conditions
+     */
+    private calculateHeuristic;
+    /**
+     * Get all registered actions
+     */
+    getActions(): Action[];
+}
+//# sourceMappingURL=GOAPCoordination.d.ts.map

package/dist/core/coordination/GOAPCoordination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GOAPCoordination.d.ts","sourceRoot":"","sources":["../../../src/core/coordination/GOAPCoordination.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,UAAU,CAAC;IAC1B,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;CACzD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAIpC,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,iBAAiB,CAAkB;gBAEvB,MAAM,EAAE,kBAAkB;IAI9C;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnE;;OAEG;IACH,aAAa,IAAI,UAAU;IAI3B;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IA0BnD;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmDnD;;OAEG;IACH,OAAO,CAAC,aAAa;IA6DrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;CAGvB"}

package/dist/core/coordination/GOAPCoordination.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GOAPCoordination = void 0;
+const events_1 = require("events");
+/**
+ * GOAPCoordination - Goal-Oriented Action Planning for agent task coordination
+ *
+ * Uses A* pathfinding to find optimal action sequences to achieve goals
+ *
+ * Features:
+ * - Dynamic goal prioritization
+ * - Cost-based action planning
+ * - World state management
+ * - Plan execution tracking
+ */
+class GOAPCoordination extends events_1.EventEmitter {
+    constructor(memory) {
+        super();
+        this.memory = memory;
+        this.actions = new Map();
+        this.currentWorldState = {};
+    }
+    /**
+     * Register an action that can be used in planning
+     */
+    registerAction(action) {
+        this.actions.set(action.id, action);
+    }
+    /**
+     * Update the current world state
+     */
+    async updateWorldState(updates) {
+        this.currentWorldState = { ...this.currentWorldState, ...updates };
+        await this.memory.store('goap:world-state', this.currentWorldState, {
+            partition: 'goap_state'
+        });
+        this.emit('goap:world-state-updated', this.currentWorldState);
+    }
+    /**
+     * Get current world state
+     */
+    getWorldState() {
+        return { ...this.currentWorldState };
+    }
+    /**
+     * Plan actions to achieve a goal using A* algorithm
+     */
+    async planForGoal(goal) {
+        const startState = { ...this.currentWorldState };
+        const plan = this.findPlanAStar(startState, goal.conditions);
+        if (!plan) {
+            this.emit('goap:planning-failed', { goal, reason: 'No valid plan found' });
+            return null;
+        }
+        const planObj = {
+            goal,
+            actions: plan.actions,
+            totalCost: plan.cost,
+            state: 'pending'
+        };
+        await this.memory.store(`goap:plan:${goal.id}`, planObj, {
+            partition: 'goap_plans',
+            ttl: 3600 // 1 hour
+        });
+        this.emit('goap:plan-created', planObj);
+        return planObj;
+    }
+    /**
+     * Execute a plan
+     */
+    async executePlan(planId) {
+        const plan = await this.memory.retrieve(`goap:plan:${planId}`, {
+            partition: 'goap_plans'
+        });
+        if (!plan) {
+            throw new Error(`Plan ${planId} not found`);
+        }
+        plan.state = 'executing';
+        await this.memory.store(`goap:plan:${planId}`, plan, {
+            partition: 'goap_plans'
+        });
+        this.emit('goap:plan-executing', plan);
+        try {
+            for (const action of plan.actions) {
+                // Verify preconditions
+                if (!this.checkConditions(this.currentWorldState, action.preconditions)) {
+                    throw new Error(`Preconditions not met for action ${action.id}`);
+                }
+                // Execute action
+                await action.execute();
+                // Apply effects to world state
+                await this.updateWorldState(action.effects);
+                this.emit('goap:action-completed', { plan, action });
+            }
+            plan.state = 'completed';
+            await this.memory.store(`goap:plan:${planId}`, plan, {
+                partition: 'goap_plans'
+            });
+            this.emit('goap:plan-completed', plan);
+            return true;
+        }
+        catch (error) {
+            plan.state = 'failed';
+            await this.memory.store(`goap:plan:${planId}`, plan, {
+                partition: 'goap_plans'
+            });
+            this.emit('goap:plan-failed', { plan, error });
+            return false;
+        }
+    }
+    /**
+     * A* pathfinding to find optimal action sequence
+     */
+    findPlanAStar(startState, goalConditions) {
+        const openSet = [{
+                state: startState,
+                actions: [],
+                cost: 0,
+                heuristic: this.calculateHeuristic(startState, goalConditions)
+            }];
+        const closedSet = new Set();
+        while (openSet.length > 0) {
+            // Sort by f(n) = g(n) + h(n)
+            openSet.sort((a, b) => (a.cost + a.heuristic) - (b.cost + b.heuristic));
+            const current = openSet.shift();
+            const stateKey = JSON.stringify(current.state);
+            if (closedSet.has(stateKey)) {
+                continue;
+            }
+            closedSet.add(stateKey);
+            // Check if goal is reached
+            if (this.checkConditions(current.state, goalConditions)) {
+                return {
+                    actions: current.actions,
+                    cost: current.cost
+                };
+            }
+            // Explore neighbors (applicable actions)
+            for (const action of this.actions.values()) {
+                if (this.checkConditions(current.state, action.preconditions)) {
+                    const newState = { ...current.state, ...action.effects };
+                    const newActions = [...current.actions, action];
+                    const newCost = current.cost + action.cost;
+                    openSet.push({
+                        state: newState,
+                        actions: newActions,
+                        cost: newCost,
+                        heuristic: this.calculateHeuristic(newState, goalConditions)
+                    });
+                }
+            }
+        }
+        return null; // No plan found
+    }
+    /**
+     * Check if current state meets required conditions
+     */
+    checkConditions(state, conditions) {
+        return Object.entries(conditions).every(([key, value]) => {
+            return state[key] === value;
+        });
+    }
+    /**
+     * Calculate heuristic (estimated cost to goal)
+     * Simple implementation: count of unmet conditions
+     */
+    calculateHeuristic(state, goal) {
+        return Object.entries(goal).filter(([key, value]) => state[key] !== value).length;
+    }
+    /**
+     * Get all registered actions
+     */
+    getActions() {
+        return Array.from(this.actions.values());
+    }
+}
+exports.GOAPCoordination = GOAPCoordination;
+//# sourceMappingURL=GOAPCoordination.js.map

package/dist/core/coordination/GOAPCoordination.js.map

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

package/dist/core/coordination/OODACoordination.d.ts

@@ -0,0 +1,99 @@
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { SwarmMemoryManager } from '../memory/SwarmMemoryManager';
+export interface Observation {
+    id: string;
+    data: any;
+    timestamp: number;
+    source: string;
+}
+export interface Orientation {
+    id: string;
+    observations: string[];
+    analysis: any;
+    context: any;
+    timestamp: number;
+}
+export interface Decision {
+    id: string;
+    orientationId: string;
+    options: any[];
+    selected: any;
+    rationale: string;
+    timestamp: number;
+}
+export interface Action {
+    id: string;
+    decisionId: string;
+    type: string;
+    parameters: any;
+    status: 'pending' | 'executing' | 'completed' | 'failed';
+    result?: any;
+    timestamp: number;
+}
+export interface OODALoop {
+    id: string;
+    cycleNumber: number;
+    observations: Observation[];
+    orientation: Orientation | null;
+    decision: Decision | null;
+    action: Action | null;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+}
+/**
+ * OODACoordination - Observe-Orient-Decide-Act loop for agent decision making
+ *
+ * Implements the OODA loop pattern for rapid, adaptive decision cycles
+ *
+ * Features:
+ * - Continuous observation gathering
+ * - Context-aware orientation
+ * - Decision making with options analysis
+ * - Action execution and tracking
+ * - Cycle performance metrics
+ */
+export declare class OODACoordination extends EventEmitter {
+    private memory;
+    private currentLoop;
+    private cycleCount;
+    constructor(memory: SwarmMemoryManager);
+    /**
+     * Start a new OODA loop cycle
+     */
+    startCycle(): Promise<string>;
+    /**
+     * Observe - Gather raw data from environment
+     */
+    observe(observation: Omit<Observation, 'id' | 'timestamp'>): Promise<Observation>;
+    /**
+     * Orient - Analyze observations and build situational awareness
+     */
+    orient(analysis: any, context?: any): Promise<Orientation>;
+    /**
+     * Decide - Make decision based on orientation
+     */
+    decide(options: any[], selected: any, rationale: string): Promise<Decision>;
+    /**
+     * Act - Execute the decided action
+     */
+    act(type: string, parameters: any, executor: () => Promise<any>): Promise<Action>;
+    /**
+     * Complete current OODA cycle
+     */
+    completeCycle(): Promise<OODALoop>;
+    /**
+     * Get current active cycle
+     */
+    getCurrentCycle(): OODALoop | null;
+    /**
+     * Get cycle history
+     */
+    getCycleHistory(limit?: number): Promise<OODALoop[]>;
+    /**
+     * Get average cycle time
+     */
+    getAverageCycleTime(): Promise<number>;
+}
+//# sourceMappingURL=OODACoordination.d.ts.map

package/dist/core/coordination/OODACoordination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OODACoordination.d.ts","sourceRoot":"","sources":["../../../src/core/coordination/OODACoordination.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,GAAG,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,GAAG,CAAC;IACd,OAAO,EAAE,GAAG,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,GAAG,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IACzD,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAIpC,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,UAAU,CAAK;gBAEH,MAAM,EAAE,kBAAkB;IAI9C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAuBnC;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAsBvF;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;IA4BpE;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA6BjF;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAsDvF;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,QAAQ,CAAC;IAoBxC;;OAEG;IACH,eAAe,IAAI,QAAQ,GAAG,IAAI;IAIlC;;OAEG;IACG,eAAe,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAW9D;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;CAW7C"}