biz-a-cli 2.3.79-15211 → 2.3.79-15212

package/message-broker/agent.js

@@ -0,0 +1,62 @@
+import { io } from "socket.io-client";
+import { workerEvents, workerStats } from "../worker/cliWorkerPool.js";
+
+export class CLI_Agent {
+	constructor(dispatcherUrl, services = "ALL") {
+		const url = dispatcherUrl.startsWith("http")
+			? dispatcherUrl
+			: `http://${dispatcherUrl}`;
+
+		this.services = services.split(",").map((s) => s.trim().toUpperCase());
+
+		console.log(`[CLI Agent] Connecting to Message Broker at ${url}...`);
+
+		this.socketBus = io(`${url}/message-broker`, {
+			reconnectionDelay: 5000,
+			reconnectionDelayMax: 10000,
+		});
+
+		this.socketBus.on("connect", () => {
+			console.log(
+				`[CLI Agent] Successfully connected. Listening for triggers...`,
+			);
+
+			// 1. Register Capabilities
+			this.socketBus.emit("ESB_AGENT_REGISTER", {
+				services: this.services,
+			});
+
+			// 2. The Workload Heartbeat
+			if (this.statsInterval) clearInterval(this.statsInterval);
+			this.statsInterval = setInterval(() => {
+				const stats = workerStats();
+				const active = stats.cliScript
+					? stats.cliScript.activeTasks
+					: 0;
+				const pending = stats.cliScript
+					? stats.cliScript.pendingTasks
+					: 0;
+				this.socketBus.emit("ESB_AGENT_STATS", {
+					activeTasks: active + pending,
+				});
+			}, 2000);
+		});
+
+		this.socketBus.on("disconnect", () => {
+			if (this.statsInterval) clearInterval(this.statsInterval);
+		});
+
+		// 3. Strict Upstream Routing
+		workerEvents.on("IPC_RELAY", (topic, payload) => {
+			this.socketBus.emit("ESB_UPSTREAM_RELAY", { topic, payload });
+		});
+	}
+
+	on(eventName, callback) {
+		this.socketBus.on(eventName, callback);
+	}
+
+	publish(topic, payload = null, ackCallback = null) {
+		this.socketBus.emit(topic, payload, ackCallback);
+	}
+}

package/message-broker/dispatcher.js

@@ -0,0 +1,137 @@
+import { EventEmitter } from "node:events";
+import { workerEvents } from "../worker/cliWorkerPool.js";
+
+export class CLI_Dispatcher {
+	constructor(mode, ioServerInstance = null) {
+		this.mode = mode || "monolithic";
+		this.agentRegistry = new Map(); // The Scoreboard
+
+		if (this.mode === "monolithic") {
+			this.localBus = new EventEmitter();
+		}
+
+		console.log(`[Message Broker] Initialized in '${this.mode}' mode.`);
+
+		if (this.mode === "dispatcher" && ioServerInstance) {
+			this.agentNamespace = ioServerInstance.of("/message-broker");
+
+			this.agentNamespace.on("connection", (socket) => {
+				console.log(
+					`[Message Broker] Remote Agent connected: ${socket.id}`,
+				);
+
+				this.agentRegistry.set(socket.id, {
+					activeTasks: 0,
+					services: [],
+				});
+
+				socket.on("ESB_AGENT_REGISTER", (data) => {
+					if (this.agentRegistry.has(socket.id)) {
+						this.agentRegistry.get(socket.id).services =
+							data.services || [];
+					}
+				});
+
+				socket.on("ESB_AGENT_STATS", (data) => {
+					if (this.agentRegistry.has(socket.id)) {
+						this.agentRegistry.get(socket.id).activeTasks =
+							data.activeTasks || 0;
+					}
+				});
+
+				socket.on("ESB_UPSTREAM_RELAY", ({ topic, payload }) => {
+					this.balanceAndDispatchEvent(topic, payload);
+				});
+
+				socket.on("disconnect", () => {
+					console.log(
+						`[Message Broker] Remote Agent disconnected: ${socket.id}`,
+					);
+					this.agentRegistry.delete(socket.id);
+				});
+			});
+		}
+
+		workerEvents.on("IPC_RELAY", (topic, payload) => {
+			this.balanceAndDispatchEvent(topic, payload);
+		});
+	}
+
+	balanceAndDispatchEvent(topic, payload) {
+		// --- EMIT TO SPECIFIC BIZ-A CLIENT ---
+		// ex: this.lib.emitClient(scriptData.clientSockId, scriptData.eventUUIDName, { status: "Done!" });
+		if (topic === "emitClient") {
+			console.log(
+				`\n[Future Dev] Target: Biz-A Client Socket ID [${payload?.clientSockId}]`,
+			);
+			console.log(`[Future Dev] Event: ${payload?.eventUUIDName}`);
+			console.log(`[Future Dev] Payload:`, payload?.payload, `\n`);
+			// TODO: this.agentNamespace.to(payload.clientSockId).emit(payload.eventUUIDName, payload.payload);
+			return;
+		}
+
+		// --- EMIT TO ALL BIZ-A CLIENT ---
+		// ex: this.lib.broadcastClient("ui:alert", { message: "System maintenance in 5 mins" });
+		if (topic === "broadcastClient") {
+			console.log(`\n[Future Dev] Broadcast: ALL Clients in CLIENT_ROOM`);
+			console.log(`[Future Dev] Event: ${payload?.topic}`);
+			console.log(`[Future Dev] Payload:`, payload?.payload, `\n`);
+			// TODO: this.agentNamespace.to("clientRoom").emit(payload.topic, payload.payload);
+			return;
+		}
+
+		// --- INTERNAL SYSTEM ROUTING ---
+		// ex : this.lib.emitCLI("email:send", data);
+		if (this.mode === "monolithic" && this.localBus) {
+			this.localBus.emit(topic, payload);
+			return;
+		}
+
+		// --- ROUTING TO BEST AGENT (based on workload at each agent) ---
+		if (this.mode === "dispatcher" && this.agentNamespace) {
+			const requiredService = topic.split(":")[0].toUpperCase();
+			let bestAgentId = null;
+			let minTasks = Infinity;
+
+			for (const [socketId, stats] of this.agentRegistry.entries()) {
+				const canHandle =
+					stats.services.includes("ALL") ||
+					stats.services.includes(requiredService);
+				if (canHandle && stats.activeTasks < minTasks) {
+					minTasks = stats.activeTasks;
+					bestAgentId = socketId;
+				}
+			}
+
+			if (bestAgentId) {
+				console.log(
+					`[Load Balancer] Routing '${topic}' to Agent ${bestAgentId} (Active Tasks: ${minTasks})`,
+				);
+				this.agentNamespace.to(bestAgentId).emit(topic, payload);
+			} else {
+				console.error(
+					`[Load Balancer] WARNING: No connected Agent supports '${requiredService}'`,
+				);
+			}
+		}
+	}
+
+	start(intervalMs = 5000) {
+		setInterval(() => {
+			this.publish("sys:tick");
+		}, intervalMs);
+		this.publish("sys:tick");
+	}
+
+	on(eventName, callback) {
+		if (this.localBus) this.localBus.on(eventName, callback);
+	}
+
+	publish(topic, payload = null, ackCallback = null) {
+		if (this.mode === "monolithic" && this.localBus) {
+			this.localBus.emit(topic, payload, ackCallback);
+		} else if (this.mode === "dispatcher" && this.agentNamespace) {
+			this.agentNamespace.emit(topic, payload, ackCallback);
+		}
+	}
+}

package/message-broker/orchestrator.js

@@ -0,0 +1,23 @@
+import { CLI_Dispatcher } from "./dispatcher.js";
+import { CLI_Agent } from "./agent.js";
+import { initBpmAgent } from "../engine/bpm/bpm-agent.js";
+
+export function bootMicroservices(argv, ioServerInstance = null) {
+	const services = argv.services || "ALL";
+
+	if (argv.mode === "monolithic") {
+		const broker = new CLI_Dispatcher("monolithic");
+		initBpmAgent(broker, "ALL");
+		broker.start(5000);
+		return broker;
+	} else if (argv.mode === "dispatcher") {
+		const broker = new CLI_Dispatcher("dispatcher", ioServerInstance);
+		initBpmAgent(broker, services);
+		broker.start(5000);
+		return broker;
+	} else if (argv.mode === "agent") {
+		const genericAgent = new CLI_Agent(argv.server, services);
+		initBpmAgent(genericAgent, services);
+		return genericAgent;
+	}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "biz-a-cli",
-	"version": "2.3.79-15211",
+	"version": "2.3.79-15212",
 	"description": "",
 	"main": "bin/index.js",
 	"type": "module",
@@ -14,6 +14,7 @@
 		"engine/**/*",
 		"envs/**/*",
 		"key/**/*",
+		"message-broker/**/*",
 		"migrations/**/*",
 		"scheduler/**/*",
 		"worker/**/*",