@grc-claw/agent-collaboration 0.8.0

package/dist/index.d.ts

@@ -0,0 +1,151 @@
+/**
+ * AgentCollaboration - Multi-agent orchestration for complex GRC tasks
+ *
+ * Enables specialized agents (compliance, security, risk, audit) to collaborate
+ * on complex tasks that require domain expertise from multiple areas.
+ *
+ * Features:
+ * - Task decomposition and delegation
+ * - Inter-agent communication protocol
+ * - Consensus building for conflicting recommendations
+ * - Parallel execution with result aggregation
+ * - Conflict resolution strategies
+ * - Agent capability matching
+ */
+export interface Agent {
+    id: string;
+    name: string;
+    type: 'compliance' | 'security' | 'risk' | 'audit' | 'evidence' | 'remediation';
+    capabilities: string[];
+    status: 'idle' | 'busy' | 'offline';
+    currentTask?: string;
+    trustScore: number;
+    lastActive: Date;
+}
+export interface CollaborationTask {
+    id: string;
+    type: string;
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    requiredCapabilities: string[];
+    input: Record<string, unknown>;
+    deadline?: Date;
+    maxAgents?: number;
+    consensusRequired?: boolean;
+}
+export interface TaskResult {
+    taskId: string;
+    agentId: string;
+    status: 'completed' | 'failed' | 'partial';
+    output: Record<string, unknown>;
+    confidence: number;
+    recommendations: string[];
+    timestamp: Date;
+    executionTimeMs: number;
+}
+export interface CollaborationSession {
+    id: string;
+    task: CollaborationTask;
+    agents: string[];
+    results: TaskResult[];
+    consensus?: ConsensusResult;
+    status: 'pending' | 'in_progress' | 'completed' | 'failed';
+    startedAt: Date;
+    completedAt?: Date;
+}
+export interface ConsensusResult {
+    achieved: boolean;
+    agreementLevel: number;
+    finalRecommendation: string;
+    dissentingViews: string[];
+    resolutionStrategy: 'majority' | 'weighted' | 'expert' | 'compromise';
+}
+export interface AgentMessage {
+    id: string;
+    from: string;
+    to: string | 'broadcast';
+    type: 'request' | 'response' | 'update' | 'alert';
+    payload: Record<string, unknown>;
+    timestamp: Date;
+    requiresResponse: boolean;
+}
+export declare class AgentCollaboration {
+    private readonly options;
+    private agents;
+    private sessions;
+    private messageQueue;
+    private taskQueue;
+    constructor(options?: {
+        maxConcurrentSessions?: number;
+        defaultTimeoutMs?: number;
+        consensusThreshold?: number;
+    });
+    /**
+     * Register an agent
+     */
+    registerAgent(agent: Agent): void;
+    /**
+     * Update agent status
+     */
+    updateAgentStatus(id: string, status: Agent['status']): void;
+    /**
+     * Get available agents for a task
+     */
+    getAvailableAgents(requiredCapabilities: string[]): Agent[];
+    /**
+     * Submit a task for collaboration
+     */
+    submitTask(task: CollaborationTask): string;
+    /**
+     * Get session status
+     */
+    getSession(sessionId: string): CollaborationSession | undefined;
+    /**
+     * Get all active sessions
+     */
+    getActiveSessions(): CollaborationSession[];
+    /**
+     * Send a message between agents
+     */
+    sendMessage(message: AgentMessage): void;
+    /**
+     * Get message history for an agent
+     */
+    getAgentMessages(agentId: string): AgentMessage[];
+    /**
+     * Force consensus on a session
+     */
+    forceConsensus(sessionId: string): ConsensusResult | null;
+    /**
+     * Process task queue
+     */
+    private processTaskQueue;
+    /**
+     * Start a collaboration session
+     */
+    private startSession;
+    /**
+     * Delegate task to agents
+     */
+    private delegateTask;
+    /**
+     * Simulate agent response (for demo purposes)
+     */
+    private simulateAgentResponse;
+    /**
+     * Add result to session
+     */
+    private addResult;
+    /**
+     * Complete a session
+     */
+    private completeSession;
+    /**
+     * Build consensus from results
+     */
+    private buildConsensus;
+    /**
+     * Process incoming message
+     */
+    private processMessage;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,245 @@
+"use strict";
+/**
+ * AgentCollaboration - Multi-agent orchestration for complex GRC tasks
+ *
+ * Enables specialized agents (compliance, security, risk, audit) to collaborate
+ * on complex tasks that require domain expertise from multiple areas.
+ *
+ * Features:
+ * - Task decomposition and delegation
+ * - Inter-agent communication protocol
+ * - Consensus building for conflicting recommendations
+ * - Parallel execution with result aggregation
+ * - Conflict resolution strategies
+ * - Agent capability matching
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentCollaboration = void 0;
+class AgentCollaboration {
+    options;
+    agents = new Map();
+    sessions = new Map();
+    messageQueue = [];
+    taskQueue = [];
+    constructor(options = {}) {
+        this.options = options;
+        this.options = {
+            maxConcurrentSessions: 10,
+            defaultTimeoutMs: 300000, // 5 minutes
+            consensusThreshold: 0.7,
+            ...options
+        };
+    }
+    /**
+     * Register an agent
+     */
+    registerAgent(agent) {
+        this.agents.set(agent.id, agent);
+    }
+    /**
+     * Update agent status
+     */
+    updateAgentStatus(id, status) {
+        const agent = this.agents.get(id);
+        if (agent) {
+            agent.status = status;
+            agent.lastActive = new Date();
+        }
+    }
+    /**
+     * Get available agents for a task
+     */
+    getAvailableAgents(requiredCapabilities) {
+        return Array.from(this.agents.values()).filter(agent => agent.status === 'idle' &&
+            requiredCapabilities.every(cap => agent.capabilities.includes(cap)));
+    }
+    /**
+     * Submit a task for collaboration
+     */
+    submitTask(task) {
+        this.taskQueue.push(task);
+        this.processTaskQueue();
+        return task.id;
+    }
+    /**
+     * Get session status
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Get all active sessions
+     */
+    getActiveSessions() {
+        return Array.from(this.sessions.values()).filter(s => s.status === 'in_progress' || s.status === 'pending');
+    }
+    /**
+     * Send a message between agents
+     */
+    sendMessage(message) {
+        this.messageQueue.push(message);
+        this.processMessage(message);
+    }
+    /**
+     * Get message history for an agent
+     */
+    getAgentMessages(agentId) {
+        return this.messageQueue.filter(m => m.from === agentId || m.to === agentId || m.to === 'broadcast');
+    }
+    /**
+     * Force consensus on a session
+     */
+    forceConsensus(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session || session.results.length === 0)
+            return null;
+        return this.buildConsensus(session);
+    }
+    /**
+     * Process task queue
+     */
+    processTaskQueue() {
+        const activeSessions = this.getActiveSessions().length;
+        if (activeSessions >= this.options.maxConcurrentSessions)
+            return;
+        const pendingTasks = this.taskQueue.filter(t => !Array.from(this.sessions.values()).some(s => s.task.id === t.id));
+        for (const task of pendingTasks) {
+            if (activeSessions >= this.options.maxConcurrentSessions)
+                break;
+            const availableAgents = this.getAvailableAgents(task.requiredCapabilities);
+            if (availableAgents.length === 0)
+                continue;
+            const selectedAgents = availableAgents.slice(0, task.maxAgents || availableAgents.length);
+            this.startSession(task, selectedAgents.map(a => a.id));
+        }
+    }
+    /**
+     * Start a collaboration session
+     */
+    startSession(task, agentIds) {
+        const session = {
+            id: `session-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+            task,
+            agents: agentIds,
+            results: [],
+            status: 'in_progress',
+            startedAt: new Date()
+        };
+        this.sessions.set(session.id, session);
+        // Mark agents as busy
+        agentIds.forEach(id => this.updateAgentStatus(id, 'busy'));
+        // Delegate task to agents
+        this.delegateTask(session);
+    }
+    /**
+     * Delegate task to agents
+     */
+    delegateTask(session) {
+        // In a real implementation, this would send messages to agents
+        // For now, we'll simulate agent responses
+        for (const agentId of session.agents) {
+            this.simulateAgentResponse(session, agentId);
+        }
+    }
+    /**
+     * Simulate agent response (for demo purposes)
+     */
+    simulateAgentResponse(session, agentId) {
+        const agent = this.agents.get(agentId);
+        if (!agent)
+            return;
+        // Simulate processing time
+        setTimeout(() => {
+            const result = {
+                taskId: session.task.id,
+                agentId,
+                status: 'completed',
+                output: {
+                    analysis: `${agent.type} analysis complete`,
+                    findings: [],
+                    recommendations: [`${agent.type} recommendation`]
+                },
+                confidence: 0.8 + Math.random() * 0.2,
+                recommendations: [`Action from ${agent.name}`],
+                timestamp: new Date(),
+                executionTimeMs: Math.floor(Math.random() * 5000)
+            };
+            this.addResult(session.id, result);
+        }, Math.random() * 2000);
+    }
+    /**
+     * Add result to session
+     */
+    addResult(sessionId, result) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        session.results.push(result);
+        // Check if all agents have responded
+        if (session.results.length === session.agents.length) {
+            this.completeSession(session);
+        }
+    }
+    /**
+     * Complete a session
+     */
+    completeSession(session) {
+        // Build consensus if required
+        if (session.task.consensusRequired) {
+            session.consensus = this.buildConsensus(session);
+        }
+        session.status = 'completed';
+        session.completedAt = new Date();
+        // Mark agents as idle
+        session.agents.forEach(id => this.updateAgentStatus(id, 'idle'));
+        // Process next task in queue
+        this.processTaskQueue();
+    }
+    /**
+     * Build consensus from results
+     */
+    buildConsensus(session) {
+        const results = session.results;
+        // Simple majority voting for recommendations
+        const recommendationCounts = new Map();
+        results.forEach(r => {
+            r.recommendations.forEach(rec => {
+                recommendationCounts.set(rec, (recommendationCounts.get(rec) || 0) + 1);
+            });
+        });
+        const sortedRecommendations = Array.from(recommendationCounts.entries())
+            .sort((a, b) => b[1] - a[1]);
+        const totalVotes = results.length;
+        const topRecommendation = sortedRecommendations[0];
+        const agreementLevel = topRecommendation ? topRecommendation[1] / totalVotes : 0;
+        return {
+            achieved: agreementLevel >= this.options.consensusThreshold,
+            agreementLevel,
+            finalRecommendation: topRecommendation ? topRecommendation[0] : 'No consensus',
+            dissentingViews: sortedRecommendations.slice(1).map(r => r[0]),
+            resolutionStrategy: 'majority'
+        };
+    }
+    /**
+     * Process incoming message
+     */
+    processMessage(message) {
+        if (message.to === 'broadcast') {
+            // Broadcast to all agents except sender
+            this.agents.forEach((agent, id) => {
+                if (id !== message.from) {
+                    // In real implementation, would deliver to agent
+                }
+            });
+        }
+        else {
+            // Direct message to specific agent
+            const agent = this.agents.get(message.to);
+            if (agent) {
+                // In real implementation, would deliver to agent
+            }
+        }
+    }
+}
+exports.AgentCollaboration = AgentCollaboration;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@grc-claw/agent-collaboration",
+  "version": "0.8.0",
+  "description": "Multi-agent orchestration for complex GRC tasks",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test dist/**/*.test.js"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,345 @@
+/**
+ * AgentCollaboration - Multi-agent orchestration for complex GRC tasks
+ * 
+ * Enables specialized agents (compliance, security, risk, audit) to collaborate
+ * on complex tasks that require domain expertise from multiple areas.
+ * 
+ * Features:
+ * - Task decomposition and delegation
+ * - Inter-agent communication protocol
+ * - Consensus building for conflicting recommendations
+ * - Parallel execution with result aggregation
+ * - Conflict resolution strategies
+ * - Agent capability matching
+ */
+
+export interface Agent {
+  id: string;
+  name: string;
+  type: 'compliance' | 'security' | 'risk' | 'audit' | 'evidence' | 'remediation';
+  capabilities: string[];
+  status: 'idle' | 'busy' | 'offline';
+  currentTask?: string;
+  trustScore: number;
+  lastActive: Date;
+}
+
+export interface CollaborationTask {
+  id: string;
+  type: string;
+  priority: 'critical' | 'high' | 'medium' | 'low';
+  requiredCapabilities: string[];
+  input: Record<string, unknown>;
+  deadline?: Date;
+  maxAgents?: number;
+  consensusRequired?: boolean;
+}
+
+export interface TaskResult {
+  taskId: string;
+  agentId: string;
+  status: 'completed' | 'failed' | 'partial';
+  output: Record<string, unknown>;
+  confidence: number; // 0-1
+  recommendations: string[];
+  timestamp: Date;
+  executionTimeMs: number;
+}
+
+export interface CollaborationSession {
+  id: string;
+  task: CollaborationTask;
+  agents: string[];
+  results: TaskResult[];
+  consensus?: ConsensusResult;
+  status: 'pending' | 'in_progress' | 'completed' | 'failed';
+  startedAt: Date;
+  completedAt?: Date;
+}
+
+export interface ConsensusResult {
+  achieved: boolean;
+  agreementLevel: number; // 0-1
+  finalRecommendation: string;
+  dissentingViews: string[];
+  resolutionStrategy: 'majority' | 'weighted' | 'expert' | 'compromise';
+}
+
+export interface AgentMessage {
+  id: string;
+  from: string;
+  to: string | 'broadcast';
+  type: 'request' | 'response' | 'update' | 'alert';
+  payload: Record<string, unknown>;
+  timestamp: Date;
+  requiresResponse: boolean;
+}
+
+export class AgentCollaboration {
+  private agents: Map<string, Agent> = new Map();
+  private sessions: Map<string, CollaborationSession> = new Map();
+  private messageQueue: AgentMessage[] = [];
+  private taskQueue: CollaborationTask[] = [];
+
+  constructor(
+    private readonly options: {
+      maxConcurrentSessions?: number;
+      defaultTimeoutMs?: number;
+      consensusThreshold?: number;
+    } = {}
+  ) {
+    this.options = {
+      maxConcurrentSessions: 10,
+      defaultTimeoutMs: 300000, // 5 minutes
+      consensusThreshold: 0.7,
+      ...options
+    };
+  }
+
+  /**
+   * Register an agent
+   */
+  registerAgent(agent: Agent): void {
+    this.agents.set(agent.id, agent);
+  }
+
+  /**
+   * Update agent status
+   */
+  updateAgentStatus(id: string, status: Agent['status']): void {
+    const agent = this.agents.get(id);
+    if (agent) {
+      agent.status = status;
+      agent.lastActive = new Date();
+    }
+  }
+
+  /**
+   * Get available agents for a task
+   */
+  getAvailableAgents(requiredCapabilities: string[]): Agent[] {
+    return Array.from(this.agents.values()).filter(agent => 
+      agent.status === 'idle' &&
+      requiredCapabilities.every(cap => agent.capabilities.includes(cap))
+    );
+  }
+
+  /**
+   * Submit a task for collaboration
+   */
+  submitTask(task: CollaborationTask): string {
+    this.taskQueue.push(task);
+    this.processTaskQueue();
+    return task.id;
+  }
+
+  /**
+   * Get session status
+   */
+  getSession(sessionId: string): CollaborationSession | undefined {
+    return this.sessions.get(sessionId);
+  }
+
+  /**
+   * Get all active sessions
+   */
+  getActiveSessions(): CollaborationSession[] {
+    return Array.from(this.sessions.values()).filter(s => 
+      s.status === 'in_progress' || s.status === 'pending'
+    );
+  }
+
+  /**
+   * Send a message between agents
+   */
+  sendMessage(message: AgentMessage): void {
+    this.messageQueue.push(message);
+    this.processMessage(message);
+  }
+
+  /**
+   * Get message history for an agent
+   */
+  getAgentMessages(agentId: string): AgentMessage[] {
+    return this.messageQueue.filter(m => 
+      m.from === agentId || m.to === agentId || m.to === 'broadcast'
+    );
+  }
+
+  /**
+   * Force consensus on a session
+   */
+  forceConsensus(sessionId: string): ConsensusResult | null {
+    const session = this.sessions.get(sessionId);
+    if (!session || session.results.length === 0) return null;
+
+    return this.buildConsensus(session);
+  }
+
+  /**
+   * Process task queue
+   */
+  private processTaskQueue(): void {
+    const activeSessions = this.getActiveSessions().length;
+    if (activeSessions >= this.options.maxConcurrentSessions!) return;
+
+    const pendingTasks = this.taskQueue.filter(t => 
+      !Array.from(this.sessions.values()).some(s => s.task.id === t.id)
+    );
+
+    for (const task of pendingTasks) {
+      if (activeSessions >= this.options.maxConcurrentSessions!) break;
+
+      const availableAgents = this.getAvailableAgents(task.requiredCapabilities);
+      if (availableAgents.length === 0) continue;
+
+      const selectedAgents = availableAgents.slice(0, task.maxAgents || availableAgents.length);
+      this.startSession(task, selectedAgents.map(a => a.id));
+    }
+  }
+
+  /**
+   * Start a collaboration session
+   */
+  private startSession(task: CollaborationTask, agentIds: string[]): void {
+    const session: CollaborationSession = {
+      id: `session-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+      task,
+      agents: agentIds,
+      results: [],
+      status: 'in_progress',
+      startedAt: new Date()
+    };
+
+    this.sessions.set(session.id, session);
+
+    // Mark agents as busy
+    agentIds.forEach(id => this.updateAgentStatus(id, 'busy'));
+
+    // Delegate task to agents
+    this.delegateTask(session);
+  }
+
+  /**
+   * Delegate task to agents
+   */
+  private delegateTask(session: CollaborationSession): void {
+    // In a real implementation, this would send messages to agents
+    // For now, we'll simulate agent responses
+    for (const agentId of session.agents) {
+      this.simulateAgentResponse(session, agentId);
+    }
+  }
+
+  /**
+   * Simulate agent response (for demo purposes)
+   */
+  private simulateAgentResponse(session: CollaborationSession, agentId: string): void {
+    const agent = this.agents.get(agentId);
+    if (!agent) return;
+
+    // Simulate processing time
+    setTimeout(() => {
+      const result: TaskResult = {
+        taskId: session.task.id,
+        agentId,
+        status: 'completed',
+        output: {
+          analysis: `${agent.type} analysis complete`,
+          findings: [],
+          recommendations: [`${agent.type} recommendation`]
+        },
+        confidence: 0.8 + Math.random() * 0.2,
+        recommendations: [`Action from ${agent.name}`],
+        timestamp: new Date(),
+        executionTimeMs: Math.floor(Math.random() * 5000)
+      };
+
+      this.addResult(session.id, result);
+    }, Math.random() * 2000);
+  }
+
+  /**
+   * Add result to session
+   */
+  private addResult(sessionId: string, result: TaskResult): void {
+    const session = this.sessions.get(sessionId);
+    if (!session) return;
+
+    session.results.push(result);
+
+    // Check if all agents have responded
+    if (session.results.length === session.agents.length) {
+      this.completeSession(session);
+    }
+  }
+
+  /**
+   * Complete a session
+   */
+  private completeSession(session: CollaborationSession): void {
+    // Build consensus if required
+    if (session.task.consensusRequired) {
+      session.consensus = this.buildConsensus(session);
+    }
+
+    session.status = 'completed';
+    session.completedAt = new Date();
+
+    // Mark agents as idle
+    session.agents.forEach(id => this.updateAgentStatus(id, 'idle'));
+
+    // Process next task in queue
+    this.processTaskQueue();
+  }
+
+  /**
+   * Build consensus from results
+   */
+  private buildConsensus(session: CollaborationSession): ConsensusResult {
+    const results = session.results;
+    
+    // Simple majority voting for recommendations
+    const recommendationCounts = new Map<string, number>();
+    results.forEach(r => {
+      r.recommendations.forEach(rec => {
+        recommendationCounts.set(rec, (recommendationCounts.get(rec) || 0) + 1);
+      });
+    });
+
+    const sortedRecommendations = Array.from(recommendationCounts.entries())
+      .sort((a, b) => b[1] - a[1]);
+
+    const totalVotes = results.length;
+    const topRecommendation = sortedRecommendations[0];
+    const agreementLevel = topRecommendation ? topRecommendation[1] / totalVotes : 0;
+
+    return {
+      achieved: agreementLevel >= this.options.consensusThreshold!,
+      agreementLevel,
+      finalRecommendation: topRecommendation ? topRecommendation[0] : 'No consensus',
+      dissentingViews: sortedRecommendations.slice(1).map(r => r[0]),
+      resolutionStrategy: 'majority'
+    };
+  }
+
+  /**
+   * Process incoming message
+   */
+  private processMessage(message: AgentMessage): void {
+    if (message.to === 'broadcast') {
+      // Broadcast to all agents except sender
+      this.agents.forEach((agent, id) => {
+        if (id !== message.from) {
+          // In real implementation, would deliver to agent
+        }
+      });
+    } else {
+      // Direct message to specific agent
+      const agent = this.agents.get(message.to);
+      if (agent) {
+        // In real implementation, would deliver to agent
+      }
+    }
+  }
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist",
+    "composite": true
+  },
+  "include": ["src/**/*"]
+}