network-ai 5.4.4 → 5.5.0

package/dist/lib/transport-agent.js

@@ -0,0 +1,365 @@
+"use strict";
+/**
+ * TransportAgent — SAP Basis-inspired configuration transport layer
+ *
+ * Manages the safe promotion of configuration artefacts between deployment
+ * environments. Enforces the AuthGuardian permission wall, drains in-flight
+ * agent pools before promoting, runs an optional canary window, and rolls
+ * back on a violation spike.
+ *
+ * State machine:
+ *   pending → draining → promoting → canary → complete
+ *                                           ↘ rolled_back
+ *                       ↘ failed (auth denied / prerequisite missing / lock conflict)
+ *
+ * Blackboard keys (written by TransportAgent only):
+ *   transport:request:<trId>  — original request (written once by submitRequest)
+ *   transport:status:<trId>   — mutable status record (updated each state change)
+ *   transport:lock:<toEnv>    — advisory lock preventing concurrent promotions
+ *
+ * @module TransportAgent
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransportAgent = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const crypto_1 = require("crypto");
+// ============================================================================
+// HELPERS
+// ============================================================================
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+// ============================================================================
+// TRANSPORT AGENT
+// ============================================================================
+/**
+ * SAP Basis-inspired transport agent for environment promotion.
+ *
+ * @example
+ * ```typescript
+ * const agent = new TransportAgent({ blackboard, envManager, authGuardian, pools });
+ * agent.start();
+ *
+ * // From any agent — submit a transport request:
+ * const trId = TransportAgent.submitRequest(blackboard, {
+ *   fromEnv: 'dev', toEnv: 'st', reason: 'Sprint 42 config', operator: 'dev-lead',
+ * });
+ * ```
+ */
+class TransportAgent {
+    _blackboard;
+    _envManager;
+    _authGuardian;
+    _pools;
+    _complianceMonitor;
+    _agentId;
+    _pollIntervalMs;
+    _drainTimeoutMs;
+    _auditLogPath;
+    _pollHandle = null;
+    _running = false;
+    _processing = false;
+    constructor(options) {
+        this._blackboard = options.blackboard;
+        this._envManager = options.envManager;
+        this._authGuardian = options.authGuardian;
+        this._pools = options.pools ?? [];
+        this._complianceMonitor = options.complianceMonitor;
+        this._agentId = options.agentId ?? 'basis:transport';
+        this._pollIntervalMs = options.pollIntervalMs ?? 5_000;
+        this._drainTimeoutMs = options.drainTimeoutMs ?? 60_000;
+        this._auditLogPath = options.auditLogPath ?? (0, path_1.join)(process.cwd(), 'data', 'audit_log.jsonl');
+    }
+    // --------------------------------------------------------------------------
+    // Public lifecycle
+    // --------------------------------------------------------------------------
+    /**
+     * Start the transport agent's poll loop.
+     * Processes pending transport requests at `pollIntervalMs` intervals.
+     */
+    start() {
+        if (this._running)
+            return;
+        this._running = true;
+        this._pollHandle = setInterval(() => {
+            void this._pollOnce();
+        }, this._pollIntervalMs);
+    }
+    /**
+     * Stop the poll loop.
+     * In-flight transports already in progress will run to completion.
+     */
+    stop() {
+        this._running = false;
+        if (this._pollHandle) {
+            clearInterval(this._pollHandle);
+            this._pollHandle = null;
+        }
+    }
+    /** Whether the agent is currently running. */
+    get isRunning() { return this._running; }
+    /**
+     * Manually execute a single transport request by ID (one-shot).
+     * Useful for testing and CLI invocation.
+     *
+     * @param trId - Transport request ID as returned by {@link TransportAgent.submitRequest}.
+     * @throws if the TR does not exist on the blackboard.
+     */
+    async execute(trId) {
+        const entry = this._blackboard.read(`transport:request:${trId}`);
+        if (!entry) {
+            throw new Error(`Transport request '${trId}' not found on blackboard`);
+        }
+        return this._runTransport(trId, entry.value);
+    }
+    // --------------------------------------------------------------------------
+    // Static helpers
+    // --------------------------------------------------------------------------
+    /**
+     * Submit a new transport request to the blackboard.
+     * Any agent may call this; only {@link TransportAgent} will execute it.
+     *
+     * @returns The generated transport request ID (`trId`).
+     */
+    static submitRequest(blackboard, request) {
+        if (!request.fromEnv || !request.toEnv) {
+            throw new Error('TransportRequest must have fromEnv and toEnv');
+        }
+        if (!request.reason) {
+            throw new Error('TransportRequest must have a reason');
+        }
+        const trId = `tr-${(0, crypto_1.randomUUID)()}`;
+        blackboard.write(`transport:request:${trId}`, request, 'basis:transport');
+        const status = {
+            trId,
+            status: 'pending',
+            fromEnv: request.fromEnv,
+            toEnv: request.toEnv,
+            reason: request.reason,
+            operator: request.operator,
+            submittedAt: new Date().toISOString(),
+        };
+        blackboard.write(`transport:status:${trId}`, status, 'basis:transport');
+        return trId;
+    }
+    // --------------------------------------------------------------------------
+    // Internal poll loop
+    // --------------------------------------------------------------------------
+    async _pollOnce() {
+        if (this._processing)
+            return;
+        this._processing = true;
+        try {
+            const keys = this._blackboard.listKeys().filter(k => k.startsWith('transport:request:'));
+            for (const key of keys) {
+                const trId = key.replace('transport:request:', '');
+                const statusEntry = this._blackboard.read(`transport:status:${trId}`);
+                if (!statusEntry)
+                    continue;
+                if (statusEntry.value.status !== 'pending')
+                    continue;
+                const requestEntry = this._blackboard.read(key);
+                if (!requestEntry)
+                    continue;
+                await this._runTransport(trId, requestEntry.value);
+            }
+        }
+        finally {
+            this._processing = false;
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Transport lifecycle
+    // --------------------------------------------------------------------------
+    async _runTransport(trId, request) {
+        const now = () => new Date().toISOString();
+        const updateStatus = (patch) => {
+            const existing = this._blackboard.read(`transport:status:${trId}`)?.value;
+            const updated = {
+                ...(existing ?? {
+                    trId,
+                    status: 'pending',
+                    fromEnv: request.fromEnv,
+                    toEnv: request.toEnv,
+                    reason: request.reason,
+                    operator: request.operator,
+                    submittedAt: now(),
+                }),
+                ...patch,
+            };
+            this._blackboard.write(`transport:status:${trId}`, updated, this._agentId);
+            return updated;
+        };
+        let status = updateStatus({ startedAt: now() });
+        // ------------------------------------------------------------------
+        // 1. Prerequisite check
+        // ------------------------------------------------------------------
+        for (const prereqId of (request.prerequisites ?? [])) {
+            const prereqEntry = this._blackboard.read(`transport:status:${prereqId}`);
+            if (!prereqEntry) {
+                status = updateStatus({ status: 'failed', error: `Prerequisite TR '${prereqId}' not found`, completedAt: now() });
+                this._writeAudit('transport:prereq_failed', { trId, prereqId });
+                return status;
+            }
+            const prereqState = prereqEntry.value.status;
+            if (prereqState !== 'complete') {
+                status = updateStatus({ status: 'failed', error: `Prerequisite TR '${prereqId}' is in state '${prereqState}' (expected 'complete')`, completedAt: now() });
+                this._writeAudit('transport:prereq_failed', { trId, prereqId, prereqState });
+                return status;
+            }
+        }
+        // ------------------------------------------------------------------
+        // 2. Advisory lock — prevent concurrent promotions to the same env
+        // ------------------------------------------------------------------
+        const lockKey = `transport:lock:${request.toEnv}`;
+        const existingLock = this._blackboard.read(lockKey);
+        if (existingLock) {
+            const lockData = existingLock.value;
+            status = updateStatus({ status: 'failed', error: `Environment '${request.toEnv}' is locked by TR '${lockData.trId}'`, completedAt: now() });
+            this._writeAudit('transport:lock_conflict', { trId, lockedBy: lockData.trId, toEnv: request.toEnv });
+            return status;
+        }
+        this._blackboard.write(lockKey, { trId, lockedAt: now() }, this._agentId);
+        try {
+            // ----------------------------------------------------------------
+            // 3. Auth check
+            // ----------------------------------------------------------------
+            const grant = await this._authGuardian.requestPermission(this._agentId, 'ENVIRONMENT_PROMOTE', `Transport ${trId}: ${request.reason}`, `${request.fromEnv}→${request.toEnv}`);
+            if (!grant.granted) {
+                status = updateStatus({ status: 'failed', error: `Permission denied: ${grant.reason ?? 'AuthGuardian rejected ENVIRONMENT_PROMOTE'}`, completedAt: now() });
+                this._writeAudit('transport:auth_denied', { trId, reason: grant.reason });
+                return status;
+            }
+            // ----------------------------------------------------------------
+            // 4. Drain pools tagged for the destination environment
+            // ----------------------------------------------------------------
+            status = updateStatus({ status: 'draining' });
+            const drainedPools = this._drainPools(request.toEnv);
+            await this._waitForDrain(drainedPools);
+            // ----------------------------------------------------------------
+            // 5. Backup destination environment before overwriting
+            // ----------------------------------------------------------------
+            let backupId;
+            try {
+                const backupResult = this._envManager.backup(request.toEnv);
+                backupId = backupResult.backupId;
+            }
+            catch {
+                // Destination env may not exist yet — nothing to back up
+            }
+            // ----------------------------------------------------------------
+            // 6. Promote
+            // ----------------------------------------------------------------
+            status = updateStatus({ status: 'promoting', backupId });
+            let promotionResult;
+            try {
+                promotionResult = this._envManager.promote(request.fromEnv, request.toEnv, {
+                    confirmedBy: request.operator,
+                    approvedBy: request.operator,
+                });
+            }
+            catch (err) {
+                status = updateStatus({ status: 'failed', error: `Promote failed: ${String(err)}`, completedAt: now() });
+                this._writeAudit('transport:promote_failed', { trId, error: String(err) });
+                this._resumePools(drainedPools, 100);
+                return status;
+            }
+            // ----------------------------------------------------------------
+            // 7. Canary phase
+            // ----------------------------------------------------------------
+            const canaryWindowMs = request.canaryWindowMs ?? 30_000;
+            const canaryMaxViolations = request.canaryMaxViolations ?? 0;
+            if (canaryWindowMs > 0 && this._complianceMonitor) {
+                status = updateStatus({ status: 'canary', promotionResult });
+                this._resumePools(drainedPools, request.canaryPercent ?? 20);
+                const violationsBefore = this._complianceMonitor.getViolations().length;
+                await sleep(canaryWindowMs);
+                const violationsAfter = this._complianceMonitor.getViolations().length;
+                const violationsDelta = Math.max(0, violationsAfter - violationsBefore);
+                if (violationsDelta > canaryMaxViolations) {
+                    // Canary failed — roll back
+                    status = updateStatus({ status: 'rolled_back', violationsDetected: violationsDelta, completedAt: now() });
+                    this._writeAudit('transport:canary_failed', { trId, violationsDelta, canaryMaxViolations });
+                    this._resumePools(drainedPools, 100);
+                    if (backupId) {
+                        try {
+                            this._envManager.restore(request.toEnv, backupId);
+                            this._writeAudit('transport:rollback_complete', { trId, backupId, toEnv: request.toEnv });
+                        }
+                        catch (rollbackErr) {
+                            this._writeAudit('transport:rollback_failed', { trId, backupId, error: String(rollbackErr) });
+                        }
+                    }
+                    return status;
+                }
+                status = updateStatus({ status: 'complete', violationsDetected: violationsDelta, promotionResult, completedAt: now() });
+                this._resumePools(drainedPools, 100);
+            }
+            else {
+                // No canary — complete immediately
+                status = updateStatus({ status: 'complete', promotionResult, completedAt: now() });
+                this._resumePools(drainedPools, 100);
+            }
+            this._writeAudit('transport:complete', {
+                trId,
+                fromEnv: request.fromEnv,
+                toEnv: request.toEnv,
+                operator: request.operator ?? null,
+            });
+            return status;
+        }
+        finally {
+            // Always release the advisory lock regardless of outcome
+            this._blackboard.delete(lockKey);
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Pool helpers
+    // --------------------------------------------------------------------------
+    /** Pause dispatch on all pools tagged for `env`. Returns the paused pools. */
+    _drainPools(env) {
+        const tagged = this._pools.filter(p => Array.isArray(p.template.tags) && p.template.tags.includes(env));
+        for (const pool of tagged) {
+            pool.setDispatchPause(true);
+        }
+        return tagged;
+    }
+    /** Resume dispatch on `pools` at `percent` capacity. */
+    _resumePools(pools, percent) {
+        for (const pool of pools) {
+            pool.setDispatchPause(false, { percent });
+        }
+    }
+    /**
+     * Wait for all actively-running agents in the given pools to finish,
+     * up to `_drainTimeoutMs`. Proceeds even if timeout is reached
+     * (pools remain paused — only newly spawned agents are blocked).
+     */
+    async _waitForDrain(pools) {
+        if (pools.length === 0)
+            return;
+        const deadline = Date.now() + this._drainTimeoutMs;
+        while (Date.now() < deadline) {
+            const anyActive = pools.some(p => p.active > 0);
+            if (!anyActive)
+                return;
+            await sleep(500);
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Audit helper
+    // --------------------------------------------------------------------------
+    _writeAudit(event, details) {
+        try {
+            const entry = JSON.stringify({ timestamp: new Date().toISOString(), event, ...details });
+            (0, fs_1.appendFileSync)(this._auditLogPath, entry + '\n', 'utf-8');
+        }
+        catch {
+            // Audit log is best-effort — never interrupt a transport for logging failures
+        }
+    }
+}
+exports.TransportAgent = TransportAgent;
+//# sourceMappingURL=transport-agent.js.map

package/dist/lib/transport-agent.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "network-ai",
-  "version": "5.4.4",
+  "version": "5.5.0",
   "description": "AI agent orchestration framework for TypeScript/Node.js - 29 adapters (LangChain, AutoGen, CrewAI, OpenAI Assistants, LlamaIndex, Semantic Kernel, Haystack, DSPy, Agno, MCP, OpenClaw, A2A, Codex, MiniMax, NemoClaw, APS, Copilot, LangGraph, Anthropic Computer Use, OpenAI Agents SDK, Vertex AI, Pydantic AI, Browser Agent, Hermes, Orchestrator, RLM + streaming variants). Built-in CLI, security, swarm intelligence, real-time streaming, and agentic workflow patterns.",
   "homepage": "https://network-ai.org",
   "main": "dist/index.js",