@alfe.ai/gateway 0.0.4 → 0.0.5

package/dist/bin/gateway.js

@@ -118,7 +118,9 @@ Examples:
 }
 main().catch((err) => {
 	const message = err instanceof Error ? err.message : String(err);
+	const stack = err instanceof Error ? err.stack : void 0;
 	console.error("Fatal error:", message);
+	if (stack) console.error(stack);
 	process.exit(1);
 });
 //#endregion

package/dist/health.js

@@ -11,6 +11,7 @@ import WebSocket from "ws";
 import { createConnection, createServer } from "node:net";
 import { execSync, spawn } from "node:child_process";
 import { IntegrationManager, IntegrationManagerAdapter, OpenClawApplier } from "@alfe.ai/integrations";
+import { randomUUID } from "node:crypto";
 import stream, { Readable } from "stream";
 import util, { format } from "util";
 import http from "http";
@@ -19,7 +20,6 @@ import url from "url";
 import http2 from "http2";
 import zlib from "zlib";
 import { EventEmitter } from "events";
-import { randomUUID } from "node:crypto";
 //#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -58,22 +58,25 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 * Daemon logger — pino with rolling file output.
 *
 * Writes to ~/.alfe/logs/gateway.log with 10MB rotation, keep 5 files.
-* Also outputs to stdout in development mode.
+* In managed mode (ECS Fargate): always stdout for CloudWatch capture.
+* In development: stdout.
 */
 const LOG_DIR = join(homedir(), ".alfe", "logs");
 const LOG_FILE = join(LOG_DIR, "gateway.log");
-try {
+const isDev = process.env.NODE_ENV !== "production";
+const isManaged = process.env.ALFE_MANAGED === "true";
+if (!isManaged) try {
 	mkdirSync(LOG_DIR, { recursive: true });
 } catch {}
-const isDev = process.env.NODE_ENV !== "production";
 /**
 * Create the daemon logger.
-* In development: pretty-prints to stdout.
-* In production: JSON to rolling file.
+* Managed mode (ECS): JSON to stdout (CloudWatch captures via awslogs driver).
+* Development: JSON to stdout.
+* Production (local): JSON to rolling file.
 */
 function createLogger$1() {
-	if (isDev) return pino({
-		level: process.env.LOG_LEVEL ?? "debug",
+	if (isDev || isManaged) return pino({
+		level: process.env.LOG_LEVEL ?? (isDev ? "debug" : "info"),
 		transport: {
 			target: "pino/file",
 			options: { destination: 1 }
@@ -3161,6 +3164,26 @@ enumValues({
 	Live: "live"
 });
 //#endregion
+//#region ../../packages-internal/types/dist/models.js
+const AnthropicModel = {
+	Opus: "claude-opus-4-6",
+	Sonnet: "claude-sonnet-4-6",
+	Haiku: "claude-haiku-4-5"
+};
+const ANTHROPIC_MODELS = enumValues(AnthropicModel);
+const OpenAIModel = {
+	GPT4o: "gpt-4o",
+	GPT4oMini: "gpt-4o-mini",
+	O3: "o3"
+};
+const OPENAI_MODELS = enumValues(OpenAIModel);
+[...ANTHROPIC_MODELS, ...OPENAI_MODELS];
+_enum(ANTHROPIC_MODELS);
+_enum(OPENAI_MODELS);
+_enum([...ANTHROPIC_MODELS, ...OPENAI_MODELS]);
+AnthropicModel.Opus, AnthropicModel.Sonnet, AnthropicModel.Haiku, OpenAIModel.GPT4o, OpenAIModel.GPT4oMini, OpenAIModel.O3;
+AnthropicModel.Opus, AnthropicModel.Sonnet, AnthropicModel.Haiku, OpenAIModel.GPT4o, OpenAIModel.GPT4oMini, OpenAIModel.O3;
+//#endregion
 //#region src/config.ts
 /**
 * Daemon configuration — reads ~/.alfe/config.toml and resolves agent identity.
@@ -3179,6 +3202,10 @@ const PID_PATH = join(ALFE_DIR, "gateway.pid");
 * Returns agentId (derived from tokenId) and orgId (tenantId).
 */
 async function resolveAgentIdentity(apiKey, apiEndpoint) {
+	logger$1.debug({
+		apiEndpoint,
+		keyPrefix: apiKey.slice(0, 8) + "..."
+	}, "Resolving agent identity...");
 	const auth = new AuthService(new AlfeApiClient({
 		apiBaseUrl: apiEndpoint,
 		getToken: () => Promise.resolve(apiKey)
@@ -3186,22 +3213,47 @@ async function resolveAgentIdentity(apiKey, apiEndpoint) {
 	const maxAttempts = 3;
 	const delayMs = 3e3;
 	for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+		logger$1.debug({
+			attempt,
+			maxAttempts
+		}, "Validating token...");
 		const result = await auth.validate(apiKey);
 		if (!result.ok) {
+			logger$1.debug({
+				status: result.status,
+				error: result.error,
+				attempt
+			}, "Token validation failed");
 			if (result.status === 401 || result.status === 403) throw new Error(`Token validation failed: ${result.error}. Is your API key valid? Run \`alfe login\` to reconfigure.`);
 			if (attempt < maxAttempts) {
+				logger$1.debug({
+					delayMs,
+					attempt
+				}, "Retrying token validation after transient error...");
 				await new Promise((r) => setTimeout(r, delayMs));
 				continue;
 			}
 			throw new Error(`Token validation failed after ${String(maxAttempts)} attempts: ${result.error}. Is your API key valid? Run \`alfe login\` to reconfigure.`);
 		}
+		logger$1.debug({
+			valid: result.data.valid,
+			tenantId: result.data.tenantId,
+			tokenId: result.data.tokenId
+		}, "Token validation response");
 		if (!result.data.valid) throw new Error("API key invalid: validation failed. Run `alfe login` to reconfigure.");
 		const orgId = result.data.tenantId;
 		if (!orgId) throw new Error("Token validation returned no tenantId — cannot determine org.");
+		const agentId = result.data.tokenId ?? deriveAgentId(apiKey);
+		const runtime = result.data.runtime ?? "openclaw";
+		logger$1.debug({
+			agentId,
+			orgId,
+			runtime
+		}, "Agent identity resolved");
 		return {
-			agentId: result.data.tokenId ?? deriveAgentId(apiKey),
+			agentId,
 			orgId,
-			runtime: result.data.runtime ?? "openclaw"
+			runtime
 		};
 	}
 	throw new Error("Token validation failed: exhausted retries.");
@@ -3260,15 +3312,27 @@ function isManagedMode() {
 * All config comes from environment variables — no local files needed.
 */
 async function loadManagedConfig() {
+	logger$1.debug("Loading managed config from environment...");
 	const apiKey = process.env.ALFE_API_KEY;
 	const apiEndpoint = process.env.ALFE_API_ENDPOINT;
-	if (!apiKey || !apiEndpoint) throw new Error("ALFE_API_KEY and ALFE_API_ENDPOINT required in managed mode");
+	if (!apiKey || !apiEndpoint) throw new Error(`ALFE_API_KEY and ALFE_API_ENDPOINT required in managed mode (apiKey=${apiKey ? "set" : "missing"}, apiEndpoint=${apiEndpoint ? "set" : "missing"})`);
+	logger$1.debug({
+		apiEndpoint,
+		gatewayWsUrlEnv: process.env.ALFE_GATEWAY_WS_URL ?? "(not set)"
+	}, "Environment loaded, resolving identity...");
 	const identity = await resolveAgentIdentity(apiKey, apiEndpoint);
+	const gatewayWsUrl = process.env.ALFE_GATEWAY_WS_URL ?? deriveGatewayWsUrl(apiEndpoint);
+	logger$1.debug({
+		agentId: identity.agentId,
+		orgId: identity.orgId,
+		runtime: identity.runtime,
+		gatewayWsUrl
+	}, "Managed config resolved");
 	return {
 		apiKey,
 		apiEndpoint,
-		gatewayWsUrl: process.env.ALFE_GATEWAY_WS_URL ?? deriveGatewayWsUrl(apiEndpoint),
-		socketPath: "",
+		gatewayWsUrl,
+		socketPath: "/tmp/alfe-gateway.sock",
 		pidPath: "",
 		agentId: identity.agentId,
 		orgId: identity.orgId,
@@ -3317,26 +3381,44 @@ async function loadDaemonConfig() {
 */
 async function fetchAgentConfig(apiKey, apiEndpoint) {
 	try {
+		logger$1.debug({ apiEndpoint }, "Fetching agent workspace config...");
 		const wsResponse = await fetch(`${apiEndpoint}/agents/me/workspace`, {
 			method: "GET",
 			headers: { "Authorization": `Bearer ${apiKey}` }
 		});
-		if (!wsResponse.ok) return null;
+		if (!wsResponse.ok) {
+			logger$1.debug({ status: wsResponse.status }, "Workspace config fetch failed");
+			return null;
+		}
 		const templateKey = (await wsResponse.json()).data?.templateKey;
-		if (!templateKey) return null;
+		if (!templateKey) {
+			logger$1.debug("No templateKey in workspace response");
+			return null;
+		}
+		logger$1.debug({ templateKey }, "Fetching template files...");
 		const filesResponse = await fetch(`${apiEndpoint}/templates/${encodeURIComponent(templateKey)}/files`, {
 			method: "GET",
 			headers: { "Authorization": `Bearer ${apiKey}` }
 		});
-		if (!filesResponse.ok) return {
+		if (!filesResponse.ok) {
+			logger$1.debug({ status: filesResponse.status }, "Template files fetch failed");
+			return {
+				templateKey,
+				files: {}
+			};
+		}
+		const filesResult = await filesResponse.json();
+		const fileCount = Object.keys(filesResult.data?.files ?? {}).length;
+		logger$1.debug({
 			templateKey,
-			files: {}
-		};
+			fileCount
+		}, "Template files fetched");
 		return {
 			templateKey,
-			files: (await filesResponse.json()).data?.files ?? {}
+			files: filesResult.data?.files ?? {}
 		};
-	} catch {
+	} catch (err) {
+		logger$1.debug({ err: err instanceof Error ? err.message : String(err) }, "fetchAgentConfig failed");
 		return null;
 	}
 }
@@ -3696,6 +3778,10 @@ var CloudClient = class {
 	* Start the cloud connection with auto-reconnect.
 	*/
 	start() {
+		logger$1.debug({
+			wsUrl: this.config.wsUrl,
+			agentId: this.config.agentId
+		}, "Cloud client starting...");
 		this.closed = false;
 		this.doConnect();
 	}
@@ -3703,15 +3789,18 @@ var CloudClient = class {
 	* Stop the cloud connection and all timers.
 	*/
 	stop() {
+		logger$1.debug("Cloud client stopping...");
 		this.closed = true;
 		this.stopPingTimer();
 		if (this.ws) {
+			logger$1.debug({ readyState: this.ws.readyState }, "Cloud: closing WebSocket");
 			try {
 				this.ws.close(1e3, "Daemon shutting down");
 			} catch {}
 			this.ws = null;
 		}
 		this.registered = false;
+		logger$1.debug("Cloud client stopped");
 	}
 	/**
 	* Get connection latency (time since last pong).
@@ -3722,22 +3811,36 @@ var CloudClient = class {
 		return Date.now() - this.lastPong;
 	}
 	doConnect() {
-		if (this.closed) return;
-		logger$1.info({ url: this.config.wsUrl }, "Connecting to cloud gateway...");
+		if (this.closed) {
+			logger$1.debug("Cloud: doConnect skipped — client is closed");
+			return;
+		}
+		logger$1.info({
+			url: this.config.wsUrl,
+			backoffMs: this.backoffMs
+		}, "Connecting to cloud gateway...");
+		logger$1.debug({
+			agentId: this.config.agentId,
+			keyPrefix: this.config.apiKey.slice(0, 12) + "..."
+		}, "Cloud: connection details");
 		this.ws = new WebSocket(this.config.wsUrl, {
 			headers: { authorization: `Bearer ${this.config.apiKey}` },
-			maxPayload: 10 * 1024 * 1024
+			maxPayload: 10 * 1024 * 1024,
+			handshakeTimeout: 1e4
 		});
 		this.ws.on("open", () => {
 			logger$1.info("Cloud WebSocket connected");
+			logger$1.debug({ readyState: this.ws?.readyState }, "Cloud: WebSocket open, sending registration...");
 			this.backoffMs = 1e3;
 			this.sendRegister();
 		});
 		this.ws.on("message", (data) => {
 			const text = Buffer.isBuffer(data) ? data.toString("utf-8") : Buffer.from(data).toString("utf-8");
+			logger$1.debug({ size: text.length }, "Cloud: received message");
 			this.handleMessage(text);
 		});
 		this.ws.on("ping", () => {
+			logger$1.debug("Cloud: received ping, sending pong");
 			this.ws?.pong();
 		});
 		this.ws.on("close", (code, reason) => {
@@ -3751,11 +3854,18 @@ var CloudClient = class {
 			this.scheduleReconnect();
 		});
 		this.ws.on("error", (err) => {
-			logger$1.error({ err: err.message }, "Cloud WebSocket error");
+			logger$1.error({
+				err: err.message,
+				url: this.config.wsUrl
+			}, "Cloud WebSocket error");
 		});
 	}
 	sendRegister() {
 		const msg = createServiceRegister(this.config.agentId);
+		logger$1.debug({
+			serviceId: msg.serviceId,
+			agentIds: msg.agentIds
+		}, "Cloud: sending SERVICE_REGISTER");
 		this.send(msg);
 		logger$1.info({ serviceId: msg.serviceId }, "Sent SERVICE_REGISTER");
 	}
@@ -3868,6 +3978,7 @@ var CloudClient = class {
 	}
 	send(msg) {
 		if (this.ws?.readyState === WebSocket.OPEN) this.ws.send(JSON.stringify(msg));
+		else logger$1.debug({ readyState: this.ws?.readyState }, "Cloud: send skipped — WebSocket not open");
 	}
 	startPingTimer() {
 		this.stopPingTimer();
@@ -3888,10 +3999,16 @@ var CloudClient = class {
 		}
 	}
 	scheduleReconnect() {
-		if (this.closed) return;
+		if (this.closed) {
+			logger$1.debug("Cloud: reconnect skipped — client is closed");
+			return;
+		}
 		const delay = this.backoffMs;
 		this.backoffMs = Math.min(this.backoffMs * 2, 3e4);
-		logger$1.info({ delayMs: delay }, "Cloud: reconnecting...");
+		logger$1.info({
+			delayMs: delay,
+			nextBackoffMs: this.backoffMs
+		}, "Cloud: scheduling reconnect...");
 		setTimeout(() => {
 			this.doConnect();
 		}, delay);
@@ -19500,7 +19617,11 @@ var RuntimeProcess = class {
 		switch (this.options.runtime) {
 			case "openclaw": return {
 				command: "openclaw",
-				args: ["--workspace", this.options.workspace]
+				args: [
+					"gateway",
+					"run",
+					"--allow-unconfigured"
+				]
 			};
 			default: throw new Error(`Unsupported runtime: ${this.options.runtime}`);
 		}
@@ -19635,6 +19756,7 @@ var LocalAgentRelay = class {
 	* Start connecting to the local runtime WS.
 	*/
 	start() {
+		log.debug({ wsUrl: this.options.wsUrl }, "Local relay starting...");
 		this.stopped = false;
 		this.doConnect();
 	}
@@ -19642,12 +19764,14 @@ var LocalAgentRelay = class {
 	* Stop the relay and close the local WS connection.
 	*/
 	stop() {
+		log.debug("Local relay stopping...");
 		this.stopped = true;
 		if (this.retryTimer) {
 			clearTimeout(this.retryTimer);
 			this.retryTimer = null;
 		}
 		if (this.ws) {
+			log.debug({ readyState: this.ws.readyState }, "Local relay: closing WebSocket");
 			try {
 				this.ws.close(1e3);
 			} catch (err) {
@@ -19656,25 +19780,33 @@ var LocalAgentRelay = class {
 			this.ws = null;
 		}
 		this.connected = false;
+		log.debug("Local relay stopped");
 	}
 	/**
 	* Forward a message payload from the cloud to the local runtime WS.
 	*/
 	forward(payload) {
 		if (this.ws?.readyState !== WebSocket.OPEN) {
-			log.warn("Cannot forward to local runtime — not connected");
+			log.warn({ readyState: this.ws?.readyState }, "Cannot forward to local runtime — not connected");
 			return;
 		}
 		const data = typeof payload === "string" ? payload : JSON.stringify(payload);
+		log.debug({ size: data.length }, "Local relay: forwarding message to runtime");
 		this.ws.send(data);
 	}
 	get isConnected() {
 		return this.connected;
 	}
 	doConnect() {
-		if (this.stopped) return;
-		log.info({ url: this.options.wsUrl }, "Connecting to local runtime WS...");
-		this.ws = new WebSocket(this.options.wsUrl);
+		if (this.stopped) {
+			log.debug("Local relay: doConnect skipped — relay is stopped");
+			return;
+		}
+		log.info({
+			url: this.options.wsUrl,
+			retryCount: this.retryCount
+		}, "Connecting to local runtime WS...");
+		this.ws = new WebSocket(this.options.wsUrl, { handshakeTimeout: 1e4 });
 		this.ws.on("open", () => {
 			log.info("Local runtime WS connected — performing handshake");
 			this.retryCount = 0;
@@ -19682,6 +19814,7 @@ var LocalAgentRelay = class {
 		});
 		this.ws.on("message", (data) => {
 			const text = Buffer.isBuffer(data) ? data.toString("utf-8") : Buffer.from(data).toString("utf-8");
+			log.debug({ size: text.length }, "Local relay: received message");
 			this.handleLocalMessage(text);
 		});
 		this.ws.on("close", (code, reason) => {
@@ -19693,10 +19826,14 @@ var LocalAgentRelay = class {
 			this.scheduleReconnect();
 		});
 		this.ws.on("error", (err) => {
-			log.debug({ err: err.message }, "Local runtime WS error");
+			log.warn({
+				err: err.message,
+				url: this.options.wsUrl
+			}, "Local runtime WS error");
 		});
 	}
 	performHandshake() {
+		log.debug("Local relay: sending connect handshake");
 		const connectReq = {
 			type: "req",
 			id: randomUUID(),
@@ -19705,7 +19842,7 @@ var LocalAgentRelay = class {
 				minProtocol: 3,
 				maxProtocol: 3,
 				client: {
-					id: "alfe-daemon-relay",
+					id: "gateway-client",
 					displayName: "Alfe Daemon Relay",
 					version: "0.1.0",
 					platform: process.platform,
@@ -19783,18 +19920,33 @@ let runtimeProcess = null;
 let localRelay = null;
 let cloudConnected = false;
 let shuttingDown = false;
+/**
+* Flush pino's async transport and exit.
+* process.exit() can drop buffered log lines — this ensures they're written first.
+*/
+async function flushAndExit(code) {
+	await new Promise((resolve) => {
+		logger$1.flush();
+		setTimeout(resolve, 500);
+	});
+	process.exit(code);
+}
 async function startDaemon() {
 	startedAt = Date.now();
 	const managed = isManagedMode();
-	logger$1.info({ managed }, "Starting Alfe Gateway Daemon...");
+	logger$1.info({
+		managed,
+		pid: process.pid
+	}, "Starting Alfe Gateway Daemon...");
 	if (!managed) {
 		await mkdir(join(homedir(), ".alfe"), { recursive: true });
 		const existingPid = await checkExistingDaemon();
 		if (existingPid) {
 			logger$1.error({ pid: existingPid }, "Daemon already running. Use `alfe gateway stop` first.");
-			process.exit(1);
+			await flushAndExit(1);
 		}
 	}
+	logger$1.debug("Loading daemon config...");
 	try {
 		config = await loadDaemonConfig();
 		logger$1.info({
@@ -19804,11 +19956,17 @@ async function startDaemon() {
 		}, "Config loaded, identity resolved");
 	} catch (err) {
 		const message = err instanceof Error ? err.message : String(err);
-		logger$1.error({ err: message }, "Failed to load config");
-		process.exit(1);
-	}
+		const stack = err instanceof Error ? err.stack : void 0;
+		logger$1.error({
+			err: message,
+			stack
+		}, "Failed to load config");
+		await flushAndExit(1);
+	}
+	logger$1.debug("Initializing command queue...");
 	commandQueue = new CommandQueue();
 	commandQueue.startGC();
+	logger$1.debug("Starting AI proxy...");
 	try {
 		const { createProxyServer } = await import("@alfe.ai/ai-proxy-local");
 		const { getAiServiceUrlFromToken } = await import("@alfe.ai/config");
@@ -19832,17 +19990,31 @@ async function startDaemon() {
 		});
 	} catch (err) {
 		const message = err instanceof Error ? err.message : String(err);
-		logger$1.error({ err: message }, "Failed to start AI proxy — LLM requests will fail");
+		const stack = err instanceof Error ? err.stack : void 0;
+		logger$1.error({
+			err: message,
+			stack
+		}, "Failed to start AI proxy — LLM requests will fail");
 	}
+	logger$1.debug({ socketPath: config.socketPath }, "Starting IPC server...");
 	ipcServer = new IPCServer(config.socketPath);
 	ipcServer.setRequestHandler(handlePluginRequest);
 	try {
 		await ipcServer.start();
+		logger$1.debug("IPC server started");
 	} catch (err) {
 		const message = err instanceof Error ? err.message : String(err);
-		logger$1.error({ err: message }, "Failed to start IPC server");
-		process.exit(1);
-	}
+		const stack = err instanceof Error ? err.stack : void 0;
+		logger$1.error({
+			err: message,
+			stack
+		}, "Failed to start IPC server");
+		await flushAndExit(1);
+	}
+	logger$1.debug({
+		wsUrl: config.gatewayWsUrl,
+		agentId: config.agentId
+	}, "Connecting cloud client...");
 	cloudClient = new CloudClient({
 		wsUrl: config.gatewayWsUrl,
 		apiKey: config.apiKey,
@@ -19869,9 +20041,16 @@ async function startDaemon() {
 	const integrationAdapter = new IntegrationManagerAdapter(integrationManager);
 	cloudClient.setIntegrationManager(integrationAdapter);
 	cloudClient.start();
+	logger$1.debug("Cloud client started");
 	if (managed && config.runtime) {
+		logger$1.debug({ runtime: config.runtime }, "Starting agent runtime (managed mode)...");
 		const runtimeCfg = config.runtimes[config.runtime];
 		if (runtimeCfg) {
+			const runtimeToken = randomUUID();
+			logger$1.debug({
+				runtime: config.runtime,
+				workspace: runtimeCfg.workspace
+			}, "Creating runtime process...");
 			runtimeProcess = new RuntimeProcess({
 				runtime: config.runtime,
 				workspace: runtimeCfg.workspace,
@@ -19881,13 +20060,17 @@ async function startDaemon() {
 					ALFE_API_URL: config.apiEndpoint,
 					ALFE_AGENT_ID: config.agentId,
 					ANTHROPIC_BASE_URL: "http://127.0.0.1:18193",
-					OPENAI_BASE_URL: "http://127.0.0.1:18193"
+					OPENAI_BASE_URL: "http://127.0.0.1:18193",
+					OPENCLAW_GATEWAY_TOKEN: runtimeToken
 				}
 			});
 			runtimeProcess.start();
+			logger$1.debug("Runtime process started");
+			const RUNTIME_WS_PORT = 18789;
+			logger$1.debug({ runtimeWsPort: RUNTIME_WS_PORT }, "Creating local agent relay...");
 			const relay = new LocalAgentRelay({
-				wsUrl: `ws://127.0.0.1:${String(18789)}`,
-				apiKey: config.apiKey,
+				wsUrl: `ws://127.0.0.1:${String(RUNTIME_WS_PORT)}`,
+				apiKey: runtimeToken,
 				onAgentMessage: (payload) => {
 					cloudClient.sendAgentEvent(payload);
 				}
@@ -19896,6 +20079,7 @@ async function startDaemon() {
 			cloudClient.setServiceRelayHandler((msg) => {
 				relay.forward(msg.payload);
 			});
+			logger$1.debug("Scheduling local relay start in 2s (waiting for runtime WS server)...");
 			setTimeout(() => {
 				relay.start();
 			}, 2e3);
@@ -19906,22 +20090,38 @@ async function startDaemon() {
 		if (shuttingDown) return;
 		shuttingDown = true;
 		logger$1.info({ signal }, "Shutting down...");
-		if (localRelay) localRelay.stop();
-		if (runtimeProcess) await runtimeProcess.stop();
-		if (ipcServer) await ipcServer.stop();
+		if (localRelay) {
+			logger$1.debug("Stopping local relay...");
+			localRelay.stop();
+			logger$1.debug("Local relay stopped");
+		}
+		if (runtimeProcess) {
+			logger$1.debug("Stopping runtime process...");
+			await runtimeProcess.stop();
+			logger$1.debug("Runtime process stopped");
+		}
+		if (ipcServer) {
+			logger$1.debug("Stopping IPC server...");
+			await ipcServer.stop();
+			logger$1.debug("IPC server stopped");
+		}
 		if (aiProxyServer) {
+			logger$1.debug("Stopping AI proxy...");
 			const proxy = aiProxyServer;
 			await new Promise((resolve) => {
 				proxy.close(() => {
 					resolve();
 				});
 			});
+			logger$1.debug("AI proxy stopped");
 		}
+		logger$1.debug("Stopping cloud client...");
 		cloudClient.stop();
+		logger$1.debug("Cloud client stopped");
 		commandQueue.stopGC();
 		if (!managed) await removePidFile();
 		logger$1.info("Daemon stopped");
-		process.exit(0);
+		await flushAndExit(0);
 	};
 	process.on("SIGTERM", () => {
 		shutdown("SIGTERM");
@@ -20173,4 +20373,4 @@ function formatDuration(ms) {
 	return `${String(Math.round(seconds / 3600))}h`;
 }
 //#endregion
-export { installService as a, PROTOCOL_VERSION as c, SOCKET_PATH as d, fetchAgentConfig as f, LOG_FILE as h, checkExistingDaemon as i, ALFE_DIR as l, resolveAgentIdentity as m, queryDaemonHealth as n, stopExistingDaemon as o, loadDaemonConfig as p, startDaemon as r, uninstallService as s, formatHealthReport as t, PID_PATH as u };
+export { installService as a, PROTOCOL_VERSION as c, SOCKET_PATH as d, fetchAgentConfig as f, logger$1 as g, LOG_FILE as h, checkExistingDaemon as i, ALFE_DIR as l, resolveAgentIdentity as m, queryDaemonHealth as n, stopExistingDaemon as o, loadDaemonConfig as p, startDaemon as r, uninstallService as s, formatHealthReport as t, PID_PATH as u };

package/dist/src/index.d.ts

@@ -1,3 +1,5 @@
+import pino from "pino";
+
 //#region src/protocol.d.ts
 
 interface IPCRequest {
@@ -132,6 +134,9 @@ declare function queryDaemonHealth(socketPath: string, timeoutMs?: number): Prom
  */
 declare function formatHealthReport(health: DaemonHealth): string;
 //#endregion
+//#region src/logger.d.ts
+declare const logger: pino.Logger<never, boolean>;
+//#endregion
 //#region src/process-manager.d.ts
 /**
  * Process management — launchd/systemd service installation.
@@ -161,4 +166,4 @@ declare function checkExistingDaemon(): Promise<number | null>;
  */
 declare function stopExistingDaemon(): Promise<boolean>;
 //#endregion
-export { ALFE_DIR, type AgentIdentity, type AgentWorkspaceConfig, type DaemonConfig, type DaemonHealth, type IPCEvent, type IPCRequest, type IPCResponse, PID_PATH, PROTOCOL_VERSION, SOCKET_PATH, checkExistingDaemon, fetchAgentConfig, formatHealthReport, installService, loadDaemonConfig, queryDaemonHealth, resolveAgentIdentity, startDaemon, stopExistingDaemon, uninstallService };
+export { ALFE_DIR, type AgentIdentity, type AgentWorkspaceConfig, type DaemonConfig, type DaemonHealth, type IPCEvent, type IPCRequest, type IPCResponse, PID_PATH, PROTOCOL_VERSION, SOCKET_PATH, checkExistingDaemon, fetchAgentConfig, formatHealthReport, installService, loadDaemonConfig, logger, queryDaemonHealth, resolveAgentIdentity, startDaemon, stopExistingDaemon, uninstallService };

package/dist/src/index.js

@@ -1,2 +1,2 @@
-import { a as installService, c as PROTOCOL_VERSION, d as SOCKET_PATH, f as fetchAgentConfig, i as checkExistingDaemon, l as ALFE_DIR, m as resolveAgentIdentity, n as queryDaemonHealth, o as stopExistingDaemon, p as loadDaemonConfig, r as startDaemon, s as uninstallService, t as formatHealthReport, u as PID_PATH } from "../health.js";
-export { ALFE_DIR, PID_PATH, PROTOCOL_VERSION, SOCKET_PATH, checkExistingDaemon, fetchAgentConfig, formatHealthReport, installService, loadDaemonConfig, queryDaemonHealth, resolveAgentIdentity, startDaemon, stopExistingDaemon, uninstallService };
+import { a as installService, c as PROTOCOL_VERSION, d as SOCKET_PATH, f as fetchAgentConfig, g as logger, i as checkExistingDaemon, l as ALFE_DIR, m as resolveAgentIdentity, n as queryDaemonHealth, o as stopExistingDaemon, p as loadDaemonConfig, r as startDaemon, s as uninstallService, t as formatHealthReport, u as PID_PATH } from "../health.js";
+export { ALFE_DIR, PID_PATH, PROTOCOL_VERSION, SOCKET_PATH, checkExistingDaemon, fetchAgentConfig, formatHealthReport, installService, loadDaemonConfig, logger, queryDaemonHealth, resolveAgentIdentity, startDaemon, stopExistingDaemon, uninstallService };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/gateway",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Alfe local gateway daemon — persistent control plane for agent integrations",
   "type": "module",
   "bin": {