@alfe.ai/gateway 0.0.21 → 0.0.23

package/dist/health.js

@@ -20,6 +20,7 @@ import url from "url";
 import http2 from "http2";
 import zlib from "zlib";
 import { EventEmitter } from "events";
+import { pathToFileURL } from "node:url";
 import { randomUUID } from "node:crypto";
 //#region \0rolldown/runtime.js
 var __create = Object.create;
@@ -365,6 +366,15 @@ var AuthService = class {
 	getReferralHistory() {
 		return this.client.request(`${this.prefix}/referral/history`);
 	}
+	getOnboardingStatus() {
+		return this.client.request(`${this.prefix}/onboarding/status`);
+	}
+	completeOnboarding(input) {
+		return this.client.request(`${this.prefix}/onboarding/complete`, {
+			method: "POST",
+			body: JSON.stringify(input)
+		});
+	}
 };
 //#endregion
 //#region ../../packages-internal/api-client/dist/services/integrations.js
@@ -3705,7 +3715,7 @@ function isIPCResponse(msg) {
 const PROTOCOL_VERSION = 1;
 //#endregion
 //#region src/reconciliation.ts
-const log$1 = logger$1.child({ component: "Reconciliation" });
+const log$2 = logger$1.child({ component: "Reconciliation" });
 var ReconciliationEngine = class {
 	constructor(manager) {
 		this.manager = manager;
@@ -3726,7 +3736,7 @@ var ReconciliationEngine = class {
 		try {
 			localIntegrations = await this.manager.getInstalledIntegrations();
 		} catch (err) {
-			log$1.error({ err }, "Failed to get local integrations");
+			log$2.error({ err }, "Failed to get local integrations");
 			localIntegrations = [];
 		}
 		const localMap = new Map(localIntegrations.map((i) => [i.id, i]));
@@ -3740,10 +3750,10 @@ var ReconciliationEngine = class {
 		const id = desired.integrationId;
 		try {
 			if (!local) {
-				log$1.info(`Installing ${id}@${desired.version}`);
+				log$2.info(`Installing ${id}@${desired.version}`);
 				await this.manager.install(id, desired.version, desired.config);
 				report.installed.push(id);
-				log$1.info(`Activating ${id}`);
+				log$2.info(`Activating ${id}`);
 				await this.manager.activate(id);
 				report.activated.push(id);
 				report.results.push({
@@ -3754,14 +3764,14 @@ var ReconciliationEngine = class {
 				return;
 			}
 			if (local.version !== desired.version && desired.version !== "" && local.version !== "unknown") {
-				log$1.info(`Upgrading ${id}: ${local.version} → ${desired.version}`);
+				log$2.info(`Upgrading ${id}: ${local.version} → ${desired.version}`);
 				try {
 					await this.manager.deactivate(id);
 					await this.manager.uninstall(id);
 				} catch {}
 				await this.manager.install(id, desired.version, desired.config);
 				report.installed.push(id);
-				log$1.info(`Activating ${id}`);
+				log$2.info(`Activating ${id}`);
 				await this.manager.activate(id);
 				report.activated.push(id);
 				report.results.push({
@@ -3772,7 +3782,7 @@ var ReconciliationEngine = class {
 				return;
 			}
 			if (local.status !== "active") {
-				log$1.info(`Activating ${id}`);
+				log$2.info(`Activating ${id}`);
 				await this.manager.activate(id);
 				report.activated.push(id);
 				report.results.push({
@@ -3789,7 +3799,7 @@ var ReconciliationEngine = class {
 			});
 		} catch (err) {
 			const message = err instanceof Error ? err.message : String(err);
-			log$1.error({ err }, `Error reconciling ${id}`);
+			log$2.error({ err }, `Error reconciling ${id}`);
 			report.errors.push({
 				integrationId: id,
 				error: message
@@ -3812,7 +3822,7 @@ var ReconciliationEngine = class {
 			return;
 		}
 		try {
-			log$1.info(`Removing ${id}`);
+			log$2.info(`Removing ${id}`);
 			if (local.status === "active") {
 				await this.manager.deactivate(id);
 				report.deactivated.push(id);
@@ -3826,7 +3836,7 @@ var ReconciliationEngine = class {
 			});
 		} catch (err) {
 			const message = err instanceof Error ? err.message : String(err);
-			log$1.error({ err }, `Error removing ${id}`);
+			log$2.error({ err }, `Error removing ${id}`);
 			report.errors.push({
 				integrationId: id,
 				error: message
@@ -3861,6 +3871,7 @@ var CloudClient = class {
 	onCommand = null;
 	onConnectionChange = null;
 	onPluginsChanged = null;
+	onReconciliationComplete = null;
 	reconciliationEngine = null;
 	constructor(config) {
 		this.config = config;
@@ -3890,6 +3901,12 @@ var CloudClient = class {
 	setPluginsChangedHandler(handler) {
 		this.onPluginsChanged = handler;
 	}
+	/**
+	* Set a callback for when reconciliation completes — used to rebuild command registry.
+	*/
+	setOnReconciliationComplete(handler) {
+		this.onReconciliationComplete = handler;
+	}
 	setIntegrationManager(manager) {
 		this.reconciliationEngine = new ReconciliationEngine(manager);
 	}
@@ -3922,6 +3939,13 @@ var CloudClient = class {
 		logger$1.debug("Cloud client stopped");
 	}
 	/**
+	* Send a typed message to the cloud gateway.
+	* Silently drops if WebSocket is not open.
+	*/
+	sendMessage(msg) {
+		this.send(msg);
+	}
+	/**
 	* Get connection latency (time since last pong).
 	* Returns -1 if no pong received yet.
 	*/
@@ -4083,6 +4107,7 @@ var CloudClient = class {
 			const reportMsg = createReconciliationReport(report.results);
 			this.send(reportMsg);
 			if ((report.installed.length > 0 || report.uninstalled.length > 0) && this.onPluginsChanged) this.onPluginsChanged();
+			this.onReconciliationComplete?.();
 		} catch (err) {
 			const message = err instanceof Error ? err.message : String(err);
 			logger$1.error({ err: message }, "Cloud: reconciliation failed");
@@ -19743,7 +19768,7 @@ function createLogger(component, additionalData) {
 * Spawns the runtime binary, pipes stdout/stderr to the daemon logger,
 * and restarts on crash with exponential backoff.
 */
-const log = createLogger("RuntimeProcess");
+const log$1 = createLogger("RuntimeProcess");
 const BACKOFF_INITIAL_MS = 1e3;
 const BACKOFF_MAX_MS = 3e4;
 const STABLE_UPTIME_MS = 6e4;
@@ -19779,7 +19804,7 @@ var RuntimeProcess = class {
 		if (this.stopped) return;
 		const { command, args } = this.resolveCommand();
 		this.lastStartTime = Date.now();
-		log.info({
+		log$1.info({
 			runtime: this.options.runtime,
 			command,
 			args,
@@ -19798,14 +19823,14 @@ var RuntimeProcess = class {
 		});
 		this.child.stdout?.on("data", (data) => {
 			const lines = data.toString().trim().split("\n");
-			for (const line of lines) log.info({
+			for (const line of lines) log$1.info({
 				runtime: this.options.runtime,
 				stream: "stdout"
 			}, line);
 		});
 		this.child.stderr?.on("data", (data) => {
 			const lines = data.toString().trim().split("\n");
-			for (const line of lines) log.warn({
+			for (const line of lines) log$1.warn({
 				runtime: this.options.runtime,
 				stream: "stderr"
 			}, line);
@@ -19813,14 +19838,14 @@ var RuntimeProcess = class {
 		this.child.on("exit", (code, signal) => {
 			this.child = null;
 			if (this.stopped) {
-				log.info({
+				log$1.info({
 					runtime: this.options.runtime,
 					code,
 					signal
 				}, "Runtime stopped (expected)");
 				return;
 			}
-			log.warn({
+			log$1.warn({
 				runtime: this.options.runtime,
 				code,
 				signal,
@@ -19834,7 +19859,7 @@ var RuntimeProcess = class {
 			this.backoffMs = Math.min(this.backoffMs * 2, BACKOFF_MAX_MS);
 		});
 		this.child.on("error", (err) => {
-			log.error({
+			log$1.error({
 				runtime: this.options.runtime,
 				err: err.message
 			}, "Runtime process error");
@@ -19853,7 +19878,7 @@ var RuntimeProcess = class {
 		if (!child) return;
 		return new Promise((resolve) => {
 			const killTimer = setTimeout(() => {
-				log.warn({ runtime: this.options.runtime }, "Runtime did not exit in time — sending SIGKILL");
+				log$1.warn({ runtime: this.options.runtime }, "Runtime did not exit in time — sending SIGKILL");
 				child.kill("SIGKILL");
 			}, 5e3);
 			child.on("exit", () => {
@@ -19867,7 +19892,7 @@ var RuntimeProcess = class {
 	* Restart the runtime process (stop then start with fresh backoff).
 	*/
 	async restart() {
-		log.info({ runtime: this.options.runtime }, "Restarting runtime...");
+		log$1.info({ runtime: this.options.runtime }, "Restarting runtime...");
 		await this.stop();
 		this.stopped = false;
 		this.backoffMs = BACKOFF_INITIAL_MS;
@@ -19881,6 +19906,154 @@ var RuntimeProcess = class {
 	}
 };
 //#endregion
+//#region src/command-registry.ts
+/**
+* Command Registry — maps integration command names to local handler files.
+*
+* After reconciliation installs/activates integrations, the daemon rebuilds
+* this registry from active integration manifests. Handler files are loaded
+* via ESM dynamic import on first use and cached until the registry is cleared.
+*/
+const log = createLogger("CommandRegistry");
+var CommandRegistry = class {
+	commands = /* @__PURE__ */ new Map();
+	version = 0;
+	/**
+	* Register a command from an integration.
+	* Rejects duplicate command names — first registration wins.
+	*/
+	register(integrationId, name, handlerPath, method = "handle", timeoutMs = 3e4) {
+		const existing = this.commands.get(name);
+		if (existing) {
+			log.warn({
+				command: name,
+				existing: existing.integrationId,
+				attempted: integrationId
+			}, "Command name collision — ignoring duplicate registration");
+			return;
+		}
+		if (!existsSync(handlerPath)) {
+			log.warn({
+				command: name,
+				handlerPath,
+				integrationId
+			}, "Handler file does not exist — skipping registration");
+			return;
+		}
+		this.commands.set(name, {
+			commandName: name,
+			integrationId,
+			handlerPath,
+			handlerMethod: method,
+			timeoutMs,
+			handler: null
+		});
+		log.info({
+			command: name,
+			integrationId,
+			handlerPath,
+			method,
+			timeoutMs
+		}, "Registered command");
+	}
+	/**
+	* Unregister all commands owned by an integration.
+	*/
+	unregisterAll(integrationId) {
+		for (const [name, entry] of this.commands) if (entry.integrationId === integrationId) {
+			this.commands.delete(name);
+			log.info({
+				command: name,
+				integrationId
+			}, "Unregistered command");
+		}
+	}
+	/**
+	* Check if a command is registered.
+	*/
+	has(name) {
+		return this.commands.has(name);
+	}
+	/**
+	* Execute a registered command handler.
+	* Lazily imports the handler module on first call, caches it.
+	* Wraps execution in Promise.race with the command's timeout.
+	*/
+	async execute(name, payload, context) {
+		const entry = this.commands.get(name);
+		if (!entry) return {
+			status: "error",
+			result: {
+				code: "UNKNOWN_COMMAND",
+				message: `Command "${name}" not registered`
+			}
+		};
+		if (!entry.handler) try {
+			const fn = (await import(pathToFileURL(entry.handlerPath).href + "?v=" + String(this.version)))[entry.handlerMethod];
+			if (typeof fn !== "function") return {
+				status: "error",
+				result: {
+					code: "HANDLER_NOT_FOUND",
+					message: `Handler "${entry.handlerMethod}" not found in ${entry.handlerPath}`
+				}
+			};
+			entry.handler = fn;
+		} catch (err) {
+			const message = err instanceof Error ? err.message : String(err);
+			log.error({
+				err: message,
+				command: name,
+				handlerPath: entry.handlerPath
+			}, "Failed to import handler");
+			return {
+				status: "error",
+				result: {
+					code: "IMPORT_FAILED",
+					message
+				}
+			};
+		}
+		try {
+			return await Promise.race([entry.handler(payload, context), new Promise((_, reject) => {
+				setTimeout(() => {
+					reject(/* @__PURE__ */ new Error(`Command "${name}" timed out after ${String(entry.timeoutMs)}ms`));
+				}, entry.timeoutMs);
+			})]);
+		} catch (err) {
+			const message = err instanceof Error ? err.message : String(err);
+			log.error({
+				err: message,
+				command: name
+			}, "Command execution failed");
+			return {
+				status: "error",
+				result: {
+					code: "EXECUTION_FAILED",
+					message
+				}
+			};
+		}
+	}
+	/**
+	* List all registered commands (for COMMANDS_AVAILABLE message).
+	*/
+	listCommands() {
+		return Array.from(this.commands.values()).map((e) => ({
+			name: e.commandName,
+			integrationId: e.integrationId,
+			timeoutMs: e.timeoutMs
+		}));
+	}
+	/**
+	* Clear all entries and increment version (busts ESM import cache).
+	*/
+	clear() {
+		this.commands.clear();
+		this.version++;
+		log.info({ version: this.version }, "Command registry cleared");
+	}
+};
+//#endregion
 //#region src/daemon.ts
 /**
 * Alfe Gateway Daemon — main entry point.
@@ -19908,6 +20081,7 @@ let aiProxyUrl = null;
 let aiProxyRunning = false;
 let cloudConnected = false;
 let shuttingDown = false;
+let commandRegistry;
 let resolvedCliVersion;
 /**
 * Resolve the installed @alfe.ai/cli version.
@@ -19984,6 +20158,7 @@ async function startDaemon() {
 	logger$1.debug("Initializing command queue...");
 	commandQueue = new CommandQueue();
 	commandQueue.startGC();
+	commandRegistry = new CommandRegistry();
 	logger$1.debug("Starting AI proxy...");
 	try {
 		const { createProxyServer, DEFAULT_AI_PROXY_PORT } = await import("@alfe.ai/ai-proxy-local");
@@ -20079,6 +20254,21 @@ async function startDaemon() {
 			});
 		}
 	});
+	cloudClient.setOnReconciliationComplete(() => {
+		try {
+			const activeCommands = integrationManager.getActiveCommands();
+			commandRegistry.clear();
+			for (const { integrationId, commands } of activeCommands) for (const cmd of commands) commandRegistry.register(integrationId, cmd.name, cmd.resolvedPath, cmd.method, cmd.timeoutMs);
+			const commandsMsg = {
+				type: "COMMANDS_AVAILABLE",
+				commands: commandRegistry.listCommands()
+			};
+			cloudClient.sendMessage(commandsMsg);
+			logger$1.info({ commandCount: commandsMsg.commands.length }, "Reported available commands to cloud");
+		} catch (err) {
+			logger$1.error({ err: err instanceof Error ? err.message : String(err) }, "Failed to rebuild command registry");
+		}
+	});
 	cloudClient.start();
 	logger$1.debug("Cloud client started");
 	if (config.autoStartRuntime && config.runtime) {
@@ -20146,98 +20336,6 @@ async function startDaemon() {
 	}, "Alfe Gateway Daemon started ✅");
 }
 async function handleCloudCommand(command) {
-	if (command.command === "support.diagnostic") {
-		const payload = command.payload;
-		if (!payload.apiKey && !aiProxyRunning) return {
-			type: "COMMAND_ACK",
-			commandId: command.commandId,
-			status: "error",
-			result: {
-				code: "PROXY_NOT_RUNNING",
-				message: "AI proxy is not running — diagnostic requires LLM access"
-			}
-		};
-		let proxyUrl;
-		if (aiProxyRunning) proxyUrl = aiProxyUrl ?? void 0;
-		else {
-			const { getAiServiceUrlFromToken } = await import("@alfe.ai/config");
-			proxyUrl = getAiServiceUrlFromToken(config.apiKey);
-		}
-		try {
-			const { runDiagnostic } = await import("@alfe.ai/doctor");
-			const workspacePath = Object.values(config.runtimes)[0]?.workspace ?? "~/.openclaw";
-			const report = await runDiagnostic({
-				task: payload.task,
-				workspacePath,
-				timeoutSeconds: 300,
-				proxyUrl,
-				apiKey: payload.apiKey
-			});
-			return {
-				type: "COMMAND_ACK",
-				commandId: command.commandId,
-				status: report.success ? "ok" : "error",
-				result: report
-			};
-		} catch (err) {
-			const message = err instanceof Error ? err.message : String(err);
-			logger$1.error({ err: message }, "Diagnostic failed");
-			return {
-				type: "COMMAND_ACK",
-				commandId: command.commandId,
-				status: "error",
-				result: {
-					code: "DIAGNOSTIC_FAILED",
-					message
-				}
-			};
-		}
-	}
-	if (command.command === "support.bash") {
-		const payload = command.payload;
-		if (!payload.cmd) return {
-			type: "COMMAND_ACK",
-			commandId: command.commandId,
-			status: "error",
-			result: {
-				code: "MISSING_CMD",
-				message: "No command provided"
-			}
-		};
-		const workspacePath = Object.values(config.runtimes)[0]?.workspace ?? "~/.openclaw";
-		try {
-			const { exec } = await import("child_process");
-			const { promisify } = await import("util");
-			const { stdout, stderr } = await promisify(exec)(payload.cmd, {
-				cwd: workspacePath,
-				timeout: 25e3,
-				maxBuffer: 512 * 1024
-			});
-			return {
-				type: "COMMAND_ACK",
-				commandId: command.commandId,
-				status: "ok",
-				result: {
-					stdout: stdout.trim(),
-					stderr: stderr.trim()
-				}
-			};
-		} catch (err) {
-			const execErr = err;
-			return {
-				type: "COMMAND_ACK",
-				commandId: command.commandId,
-				status: "error",
-				result: {
-					code: "EXEC_FAILED",
-					stdout: execErr.stdout?.trim() ?? "",
-					stderr: execErr.stderr?.trim() ?? "",
-					message: execErr.message ?? String(err),
-					exitCode: execErr.code
-				}
-			};
-		}
-	}
 	if (command.command === "daemon.update") {
 		const version = command.payload?.version ?? "latest";
 		setTimeout(() => {
@@ -20298,6 +20396,31 @@ async function handleCloudCommand(command) {
 			};
 		}
 	}
+	if (commandRegistry.has(command.command)) try {
+		const ctx = buildCommandContext();
+		const result = await commandRegistry.execute(command.command, typeof command.payload === "object" && command.payload !== null ? command.payload : {}, ctx);
+		return {
+			type: "COMMAND_ACK",
+			commandId: command.commandId,
+			status: result.status,
+			result: result.result
+		};
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		logger$1.error({
+			err: message,
+			command: command.command
+		}, "Command registry execution failed");
+		return {
+			type: "COMMAND_ACK",
+			commandId: command.commandId,
+			status: "error",
+			result: {
+				code: "REGISTRY_ERROR",
+				message
+			}
+		};
+	}
 	const ipcRequest = cloudCommandToIPCRequest(command);
 	if (!ipcRequest) {
 		logger$1.warn({ command: command.command }, "Unrecognized cloud command");
@@ -20354,6 +20477,28 @@ async function handleCloudCommand(command) {
 		};
 	}
 }
+function buildCommandContext() {
+	const workspacePath = Object.values(config.runtimes)[0]?.workspace ?? "~/.openclaw";
+	return {
+		workspacePath,
+		aiProxyUrl: aiProxyUrl ?? void 0,
+		aiProxyRunning,
+		apiKey: config.apiKey,
+		async exec(cmd, opts) {
+			const { exec: execCb } = await import("child_process");
+			const { promisify } = await import("util");
+			const { stdout, stderr } = await promisify(execCb)(cmd, {
+				cwd: workspacePath,
+				timeout: opts?.timeoutMs ?? 25e3,
+				maxBuffer: opts?.maxBuffer ?? 512 * 1024
+			});
+			return {
+				stdout: stdout.trim(),
+				stderr: stderr.trim()
+			};
+		}
+	};
+}
 function handlePluginRequest(method, params, pluginId) {
 	switch (method) {
 		case "status": return Promise.resolve(handleStatus());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/gateway",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "description": "Alfe local gateway daemon — persistent control plane for agent integrations",
   "type": "module",
   "bin": {
@@ -24,8 +24,8 @@
     "ws": "^8.18.0",
     "@alfe.ai/ai-proxy-local": "^0.0.5",
     "@alfe.ai/config": "^0.0.5",
-    "@alfe.ai/doctor": "^0.0.6",
-    "@alfe.ai/integrations": "^0.0.13"
+    "@alfe.ai/integration-manifest": "^0.0.6",
+    "@alfe.ai/integrations": "^0.0.15"
   },
   "devDependencies": {
     "@types/ws": "^8.5.13",