network-ai 5.10.2 → 5.11.0

package/dist/esm/lib/playground.js

@@ -0,0 +1,224 @@
+"use strict";
+/**
+ * Playground — Interactive REPL sandbox for Network-AI
+ *
+ * Provides an in-process REPL environment with pre-configured mock adapters,
+ * a blackboard, budget, auth guardian, and orchestrator — ready to experiment
+ * with immediately.
+ *
+ * Features:
+ *   - Pre-wired SwarmOrchestrator with mock CustomAdapter
+ *   - LockedBlackboard with in-memory backend
+ *   - AuthGuardian with default trust levels
+ *   - FederatedBudget with generous defaults
+ *   - REPL context exposes all key objects
+ *   - Helper functions: delegate(), bb(), budget(), agents()
+ *
+ * Usage:
+ *   import { startPlayground } from 'network-ai';
+ *   await startPlayground();
+ *
+ * CLI:
+ *   npx network-ai playground
+ *
+ * @module Playground
+ * @version 1.0.0
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockAgentRegistry = void 0;
+exports.startPlayground = startPlayground;
+const repl = __importStar(require("repl"));
+const events_1 = require("events");
+// ============================================================================
+// MOCK HELPERS
+// ============================================================================
+/** Simple mock agent registry for the playground */
+class MockAgentRegistry {
+    handlers = new Map();
+    callLog = [];
+    /** Register a mock agent */
+    register(name, handler) {
+        this.handlers.set(name, handler);
+    }
+    /** List registered mock agents */
+    list() {
+        return Array.from(this.handlers.keys());
+    }
+    /** Call a mock agent */
+    async call(name, input) {
+        const handler = this.handlers.get(name);
+        if (!handler) {
+            throw new Error(`No mock agent '${name}'. Available: ${this.list().join(', ')}`);
+        }
+        const output = await handler(input);
+        this.callLog.push({ agentId: name, input, output, timestamp: Date.now() });
+        return output;
+    }
+    /** Get call history */
+    history() {
+        return this.callLog;
+    }
+    /** Clear call history */
+    clearHistory() {
+        this.callLog = [];
+    }
+}
+exports.MockAgentRegistry = MockAgentRegistry;
+// ============================================================================
+// DEFAULT MOCKS
+// ============================================================================
+function createDefaultMocks() {
+    return {
+        echo: (input) => `Echo: ${input}`,
+        upper: (input) => input.toUpperCase(),
+        reverse: (input) => input.split('').reverse().join(''),
+        count: (input) => `Words: ${input.split(/\s+/).filter(Boolean).length}`,
+        json: (input) => JSON.stringify({ input, processed: true, timestamp: Date.now() }),
+        summarize: (input) => {
+            const words = input.split(/\s+/);
+            return words.length <= 10 ? input : words.slice(0, 10).join(' ') + '...';
+        },
+        sentiment: (input) => {
+            const positive = /good|great|excellent|happy|love|amazing|wonderful/i;
+            const negative = /bad|terrible|awful|hate|horrible|worst/i;
+            if (positive.test(input))
+                return 'positive';
+            if (negative.test(input))
+                return 'negative';
+            return 'neutral';
+        },
+    };
+}
+// ============================================================================
+// PLAYGROUND
+// ============================================================================
+const DEFAULT_BANNER = `
+\x1b[36m\x1b[1m╔══════════════════════════════════════════════════╗
+║           Network-AI Playground (REPL)           ║
+╚══════════════════════════════════════════════════╝\x1b[0m
+
+\x1b[33mPre-loaded objects:\x1b[0m
+  \x1b[32mmocks\x1b[0m      — MockAgentRegistry (register/call/list/history)
+  \x1b[32mdelegate\x1b[0m   — Call a mock agent: delegate('echo', 'hello')
+  \x1b[32magents\x1b[0m     — List available mock agents
+  \x1b[32mhistory\x1b[0m    — View call history
+
+\x1b[33mTips:\x1b[0m
+  • Type \x1b[32m.help\x1b[0m for REPL commands
+  • Type \x1b[32magents()\x1b[0m to see available agents
+  • Type \x1b[32mdelegate('echo', 'hello world')\x1b[0m to test
+  • Type \x1b[32m.exit\x1b[0m to quit
+`;
+/**
+ * Start an interactive playground REPL with mock adapters.
+ *
+ * All key Network-AI objects are available in the REPL context.
+ * Mock agents respond instantly with deterministic outputs.
+ */
+function startPlayground(config = {}) {
+    const emitter = new events_1.EventEmitter();
+    let running = true;
+    const banner = config.banner ?? DEFAULT_BANNER;
+    const prompt = config.prompt ?? 'swarm> ';
+    // Set up mocks
+    const mocks = new MockAgentRegistry();
+    const defaultMocks = createDefaultMocks();
+    for (const [name, handler] of Object.entries(defaultMocks)) {
+        mocks.register(name, handler);
+    }
+    if (config.mockAgents) {
+        for (const [name, handler] of Object.entries(config.mockAgents)) {
+            mocks.register(name, handler);
+        }
+    }
+    // Print banner
+    if (banner) {
+        console.log(banner);
+    }
+    // Create REPL
+    const server = repl.start({
+        prompt,
+        useColors: true,
+        ignoreUndefined: true,
+    });
+    // Expose objects in REPL context
+    server.context['mocks'] = mocks;
+    server.context['delegate'] = async (agentId, input) => {
+        try {
+            const result = await mocks.call(agentId, input);
+            console.log(`\x1b[32m✓\x1b[0m ${result}`);
+            return result;
+        }
+        catch (err) {
+            console.log(`\x1b[31m✗\x1b[0m ${err instanceof Error ? err.message : String(err)}`);
+            return undefined;
+        }
+    };
+    server.context['agents'] = () => {
+        const list = mocks.list();
+        console.log(`\x1b[36mAvailable agents (${list.length}):\x1b[0m`);
+        for (const name of list) {
+            console.log(`  • ${name}`);
+        }
+        return list;
+    };
+    server.context['history'] = () => {
+        const hist = mocks.history();
+        if (hist.length === 0) {
+            console.log('\x1b[33mNo calls yet.\x1b[0m');
+            return [];
+        }
+        for (const entry of hist) {
+            const time = new Date(entry.timestamp).toLocaleTimeString();
+            console.log(`  [${time}] ${entry.agentId}("${entry.input}") → "${entry.output}"`);
+        }
+        return hist;
+    };
+    server.on('exit', () => {
+        running = false;
+        emitter.emit('exit');
+    });
+    emitter.emit('started');
+    return {
+        emitter,
+        stop: () => {
+            running = false;
+            server.close();
+        },
+        get isRunning() { return running; },
+    };
+}
+//# sourceMappingURL=playground.js.map

package/dist/esm/lib/playground.js.map

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

package/dist/esm/lib/qa-orchestrator.js

@@ -0,0 +1,296 @@
+"use strict";
+/**
+ * QA Orchestrator Agent
+ *
+ * Coordination layer on top of QualityGateAgent and ComplianceMonitor.
+ * Provides:
+ *   1. Scenario replay — re-run blackboard entries through quality gates
+ *   2. Feedback loop — route rejections back to agents with suggested fixes
+ *   3. Regression tracker — historical quality metrics over time
+ *   4. Cross-agent consistency — detect contradictions in multi-agent output
+ *
+ * @module lib/qa-orchestrator
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QAOrchestratorAgent = void 0;
+const blackboard_validator_1 = require("./blackboard-validator");
+const compliance_monitor_1 = require("./compliance-monitor");
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * QA Orchestrator Agent — coordinates quality gating, compliance monitoring,
+ * feedback routing, regression tracking, and cross-agent consistency checks.
+ *
+ * @example
+ * ```typescript
+ * const qa = new QAOrchestratorAgent({
+ *   qualityThreshold: 0.7,
+ *   maxRetries: 2,
+ *   onFeedback: (fb) => console.log('Route to agent:', fb),
+ * });
+ *
+ * const result = await qa.runScenario({
+ *   id: 'test-1', key: 'analysis', value: { findings: [...] },
+ *   sourceAgent: 'analyst',
+ * });
+ * ```
+ */
+class QAOrchestratorAgent {
+    gate;
+    compliance;
+    maxRetries;
+    onFeedback;
+    contradictionDetector;
+    /** Historical snapshots for regression tracking */
+    history = [];
+    /** Track retry counts per scenario */
+    retryCounts = new Map();
+    /** Track last-seen value per key+agent for contradiction detection */
+    agentOutputs = new Map();
+    constructor(options = {}) {
+        this.gate = new blackboard_validator_1.QualityGateAgent({
+            qualityThreshold: options.qualityThreshold,
+            autoRejectThreshold: options.autoRejectThreshold,
+            validationConfig: options.validationConfig,
+            aiReviewCallback: options.aiReviewCallback,
+        });
+        this.compliance = new compliance_monitor_1.ComplianceMonitor(options.complianceOptions);
+        this.maxRetries = options.maxRetries ?? 3;
+        this.onFeedback = options.onFeedback;
+        this.contradictionDetector = options.contradictionDetector ?? defaultContradictionDetector;
+    }
+    // --------------------------------------------------------------------------
+    // Core: Single scenario
+    // --------------------------------------------------------------------------
+    /**
+     * Run a single scenario through the two-layer quality gate.
+     * If the entry is rejected or quarantined and a feedback callback is
+     * configured, structured feedback is routed back to the source agent.
+     */
+    async runScenario(scenario) {
+        const { id, key, value, sourceAgent, metadata, minScore } = scenario;
+        // Record the agent action for compliance monitoring
+        this.compliance.recordAction({
+            agentId: sourceAgent,
+            action: 'qa_submission',
+            tool: 'qa_orchestrator',
+        });
+        // Run through quality gate
+        const gateResult = await this.gate.gate(key, value, sourceAgent, metadata);
+        const score = gateResult.validation.score;
+        const issues = gateResult.validation.issues.map(i => `[${i.severity}] ${i.message}`);
+        // Threshold override per scenario
+        const passThreshold = minScore ?? (this.gate.getValidator() ? 0.7 : 0.7);
+        const passed = gateResult.decision === 'approve' && score >= passThreshold;
+        // Track for cross-agent consistency
+        this.trackAgentOutput(key, sourceAgent, value);
+        // Route feedback on rejection/quarantine
+        let feedbackRouted = false;
+        let feedbackPayload;
+        if (!passed && this.onFeedback) {
+            const retries = this.retryCounts.get(id) ?? 0;
+            if (retries < this.maxRetries) {
+                this.retryCounts.set(id, retries + 1);
+                feedbackPayload = {
+                    scenarioId: id,
+                    sourceAgent,
+                    key,
+                    decision: gateResult.decision,
+                    score,
+                    issues,
+                    suggestedFixes: this.extractSuggestedFixes(gateResult),
+                    retryCount: retries + 1,
+                };
+                await this.onFeedback(feedbackPayload);
+                feedbackRouted = true;
+            }
+        }
+        return { scenarioId: id, decision: gateResult.decision, score, passed, issues, feedbackRouted, feedbackPayload };
+    }
+    // --------------------------------------------------------------------------
+    // Harness: Batch scenario replay
+    // --------------------------------------------------------------------------
+    /**
+     * Run a batch of scenarios and collect aggregate results, contradictions,
+     * and a quality snapshot.
+     */
+    async runHarness(scenarios) {
+        const results = [];
+        for (const scenario of scenarios) {
+            results.push(await this.runScenario(scenario));
+        }
+        const passedCount = results.filter(r => r.passed).length;
+        const contradictions = this.detectContradictions();
+        const snapshot = this.takeSnapshot(results.length, passedCount);
+        return {
+            total: results.length,
+            passed: passedCount,
+            failed: results.length - passedCount,
+            passRate: results.length > 0 ? passedCount / results.length : 0,
+            results,
+            contradictions,
+            snapshot,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // Regression tracking
+    // --------------------------------------------------------------------------
+    /**
+     * Take an explicit quality snapshot and store it in history.
+     * Called automatically after `runHarness()`, but can also be called manually.
+     */
+    takeSnapshot(scenariosRun = 0, scenariosPassed = 0) {
+        const gateMetrics = this.gate.getMetrics();
+        const complianceSummary = this.compliance.getSummary();
+        const snapshot = {
+            timestamp: new Date().toISOString(),
+            gateMetrics,
+            complianceViolations: complianceSummary.total,
+            violationsByType: complianceSummary.byType,
+            violationsByAgent: complianceSummary.byAgent,
+            scenariosRun,
+            scenarioPassRate: scenariosRun > 0 ? scenariosPassed / scenariosRun : 0,
+        };
+        this.history.push(snapshot);
+        return snapshot;
+    }
+    /**
+     * Get all historical quality snapshots for trend analysis.
+     */
+    getHistory() {
+        return this.history;
+    }
+    /**
+     * Compare the latest two snapshots and return a regression report.
+     * Returns null if fewer than two snapshots exist.
+     */
+    getRegressionReport() {
+        if (this.history.length < 2)
+            return null;
+        const prev = this.history[this.history.length - 2];
+        const curr = this.history[this.history.length - 1];
+        return {
+            from: prev.timestamp,
+            to: curr.timestamp,
+            passRateDelta: curr.scenarioPassRate - prev.scenarioPassRate,
+            complianceDelta: curr.complianceViolations - prev.complianceViolations,
+            approvalRateDelta: approvalRate(curr.gateMetrics) - approvalRate(prev.gateMetrics),
+            regressed: curr.scenarioPassRate < prev.scenarioPassRate ||
+                curr.complianceViolations > prev.complianceViolations,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // Cross-agent consistency
+    // --------------------------------------------------------------------------
+    /**
+     * Detect contradictions across agents that wrote to the same blackboard key.
+     */
+    detectContradictions() {
+        const contradictions = [];
+        for (const [key, agentMap] of this.agentOutputs) {
+            const agents = Array.from(agentMap.entries());
+            for (let i = 0; i < agents.length; i++) {
+                for (let j = i + 1; j < agents.length; j++) {
+                    const [agentA, valueA] = agents[i];
+                    const [agentB, valueB] = agents[j];
+                    if (this.contradictionDetector(valueA, valueB)) {
+                        contradictions.push({
+                            key,
+                            agentA,
+                            agentB,
+                            valueA,
+                            valueB,
+                            detectedAt: new Date().toISOString(),
+                        });
+                    }
+                }
+            }
+        }
+        return contradictions;
+    }
+    // --------------------------------------------------------------------------
+    // Accessors
+    // --------------------------------------------------------------------------
+    /** Access the underlying QualityGateAgent for direct configuration. */
+    getQualityGate() {
+        return this.gate;
+    }
+    /** Access the underlying ComplianceMonitor for direct configuration. */
+    getComplianceMonitor() {
+        return this.compliance;
+    }
+    /** Get current gate metrics without taking a full snapshot. */
+    getMetrics() {
+        return this.gate.getMetrics();
+    }
+    /** Get the number of remaining retries for a scenario. */
+    getRetriesRemaining(scenarioId) {
+        return this.maxRetries - (this.retryCounts.get(scenarioId) ?? 0);
+    }
+    /** Reset retry count for a scenario (e.g., after manual fix). */
+    resetRetries(scenarioId) {
+        this.retryCounts.delete(scenarioId);
+    }
+    /** Clear all tracked agent outputs (for fresh contradiction detection). */
+    clearOutputTracking() {
+        this.agentOutputs.clear();
+    }
+    // --------------------------------------------------------------------------
+    // Private helpers
+    // --------------------------------------------------------------------------
+    trackAgentOutput(key, agent, value) {
+        if (!this.agentOutputs.has(key)) {
+            this.agentOutputs.set(key, new Map());
+        }
+        this.agentOutputs.get(key).set(agent, value);
+    }
+    extractSuggestedFixes(gateResult) {
+        const fixes = [];
+        for (const issue of gateResult.validation.issues) {
+            if (issue.suggestion) {
+                fixes.push(issue.suggestion);
+            }
+        }
+        if (gateResult.reviewNotes.length > 0) {
+            fixes.push(...gateResult.reviewNotes);
+        }
+        return fixes;
+    }
+}
+exports.QAOrchestratorAgent = QAOrchestratorAgent;
+// ============================================================================
+// Utility functions
+// ============================================================================
+function approvalRate(metrics) {
+    return metrics.totalChecked > 0 ? metrics.approved / metrics.totalChecked : 0;
+}
+/**
+ * Default contradiction detector: returns true when two values for the same
+ * key have opposing boolean fields (e.g., `{ success: true }` vs `{ success: false }`)
+ * or when one is an error and the other is not.
+ */
+function defaultContradictionDetector(a, b) {
+    if (a === null || b === null || typeof a !== 'object' || typeof b !== 'object') {
+        return false;
+    }
+    const objA = a;
+    const objB = b;
+    // Check for opposing boolean fields
+    for (const key of Object.keys(objA)) {
+        if (typeof objA[key] === 'boolean' && typeof objB[key] === 'boolean') {
+            if (objA[key] !== objB[key])
+                return true;
+        }
+    }
+    // One has error, other has success data
+    const aHasError = 'error' in objA && objA['error'] != null;
+    const bHasError = 'error' in objB && objB['error'] != null;
+    const aHasData = 'data' in objA || 'result' in objA || 'findings' in objA;
+    const bHasData = 'data' in objB || 'result' in objB || 'findings' in objB;
+    if ((aHasError && bHasData && !bHasError) || (bHasError && aHasData && !aHasError)) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=qa-orchestrator.js.map

package/dist/esm/lib/qa-orchestrator.js.map

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