@alfe.ai/openclaw-voice 0.0.17 → 0.1.0

package/README.md

@@ -47,3 +47,8 @@ pnpm --filter @alfe.ai/openclaw-voice test
 
 - **voice-service** — core voice logic (TTS, audio pipeline, Discord/Twilio adapters)
 - **@alfe.ai/openclaw** — OpenClaw runtime plugin API
+
+## Links
+
+- 🌐 Website: <https://alfe.ai>
+- 📚 Docs: <https://docs.alfe.ai>

package/dist/index.cjs

@@ -1,2 +1,2 @@
-const require_plugin = require("./plugin.cjs");
-module.exports = require_plugin;
+const require_plugin = require("./plugin2.cjs");
+module.exports = require_plugin.plugin;

package/dist/index.js

@@ -1,2 +1,2 @@
-import plugin from "./plugin.js";
+import { t as plugin } from "./plugin2.js";
 export { plugin as default };

package/dist/plugin.cjs

@@ -1,220 +1,2 @@
-let _sinclair_typebox = require("@sinclair/typebox");
-let _alfe_ai_config = require("@alfe.ai/config");
-//#region src/plugin.ts
-/**
-* @alfe/voice-plugin — OpenClaw native plugin
-*
-* Thin client that registers voice tools with OpenClaw and forwards
-* TTS/STT operations to the voice service's public API.
-*
-* In the new architecture, voice service is a channel-agnostic pipeline
-* brain. Channel-specific operations (hangup, transfer, DTMF) are handled
-* by the respective channel services (Discord, Twilio, etc.), not voice.
-*
-* This plugin provides:
-*   - voice.speak RPC — converts text to audio via POST /voice/tts
-*   - voice_hangup tool — placeholder (requires channel service)
-*   - voice_transfer tool — placeholder (requires Twilio service)
-*   - voice_dtmf tool �� placeholder (requires Twilio service)
-*/
-const pkg = (0, require("node:module").createRequire)(require("url").pathToFileURL(__filename).href)("../package.json");
-const VOICE_CAPABILITIES = [
-	"voice.call",
-	"voice.answer",
-	"voice.dtmf",
-	"voice.hangup"
-];
-let voiceServiceUrl = "";
-let voiceServiceApiKey = "";
-async function voiceApi(method, path, body) {
-	const url = `${voiceServiceUrl}${path}`;
-	const headers = { "Content-Type": "application/json" };
-	if (voiceServiceApiKey) headers["x-api-key"] = voiceServiceApiKey;
-	const res = await fetch(url, {
-		method,
-		headers,
-		body: body ? JSON.stringify(body) : void 0
-	});
-	const json = await res.json();
-	if (!res.ok) {
-		const errorMsg = typeof json.error === "string" ? json.error : `Voice service returned ${String(res.status)}`;
-		throw new Error(errorMsg);
-	}
-	return json;
-}
-let daemonIpcClient = null;
-async function connectToDaemon(socketPath, log) {
-	try {
-		const IPCClientCtor = (await import("@alfe.ai/openclaw")).IPCClient;
-		const client = new IPCClientCtor(socketPath, log);
-		client.on("connected", async () => {
-			log.info("Connected to Alfe daemon — registering voice capabilities...");
-			const response = await client.request("capability.register", {
-				plugin: "@alfe.ai/openclaw-voice",
-				capabilities: [...VOICE_CAPABILITIES]
-			});
-			if (response.ok) log.info("Voice capabilities registered with daemon");
-			else log.warn(`Failed to register voice capabilities: ${response.error?.message ?? "unknown"}`);
-		});
-		client.on("disconnected", (reason) => {
-			log.warn(`Disconnected from Alfe daemon: ${String(reason)}`);
-		});
-		client.on("error", (err) => {
-			log.debug(`Daemon IPC error: ${err.message}`);
-		});
-		client.start();
-		return client;
-	} catch {
-		log.info("Alfe daemon not available — voice plugin running standalone");
-		return null;
-	}
-}
-function ok(data) {
-	return {
-		content: [{
-			type: "text",
-			text: JSON.stringify(data)
-		}],
-		details: data
-	};
-}
-function errResult(message) {
-	return {
-		content: [{
-			type: "text",
-			text: JSON.stringify({ error: message })
-		}],
-		details: { error: message }
-	};
-}
-function defineTool(def) {
-	return {
-		name: def.name,
-		description: def.description,
-		label: def.name,
-		parameters: def.parameters,
-		execute: async (_toolCallId, params) => {
-			try {
-				return ok(await def.handler(params));
-			} catch (e) {
-				return errResult(e.message);
-			}
-		}
-	};
-}
-const voiceTools = [
-	defineTool({
-		name: "voice_hangup",
-		description: "Hang up the current voice call or leave the voice channel. Use when the conversation is done or the user asks you to leave.",
-		parameters: _sinclair_typebox.Type.Object({ sessionId: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.String({ description: "Voice session ID." })) }),
-		handler: () => {
-			throw new Error("voice_hangup requires a channel service (Discord/Twilio). The voice service no longer manages channels directly.");
-		}
-	}),
-	defineTool({
-		name: "voice_transfer",
-		description: "Transfer the current phone call to another number. Only works for Twilio calls.",
-		parameters: _sinclair_typebox.Type.Object({
-			targetNumber: _sinclair_typebox.Type.String({ description: "Phone number to transfer to (E.164 format)" }),
-			sessionId: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.String({ description: "Voice session ID." }))
-		}),
-		handler: () => {
-			throw new Error("voice_transfer requires the Twilio service. The voice service no longer manages phone calls directly.");
-		}
-	}),
-	defineTool({
-		name: "voice_dtmf",
-		description: "Send DTMF tones (dial pad digits) on the current phone call. Only works for Twilio calls.",
-		parameters: _sinclair_typebox.Type.Object({
-			digits: _sinclair_typebox.Type.String({ description: "DTMF digits to send (0-9, *, #, w for pause)" }),
-			sessionId: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.String({ description: "Voice session ID." }))
-		}),
-		handler: () => {
-			throw new Error("voice_dtmf requires the Twilio service. The voice service no longer manages phone calls directly.");
-		}
-	})
-];
-const plugin = {
-	id: "@alfe.ai/openclaw-voice",
-	name: "Alfe Voice Plugin",
-	description: "Voice integration — TTS/STT via the voice service, channel-specific operations via channel services",
-	version: pkg.version,
-	activate(api) {
-		const log = api.logger;
-		for (const tool of voiceTools) api.registerTool(tool);
-		log.info(`Registered ${String(voiceTools.length)} voice tools: ${voiceTools.map((t) => t.name).join(", ")}`);
-		const fullConfig = api.config ?? {};
-		const pluginConfig = fullConfig.plugins?.entries?.["@alfe.ai/openclaw-voice"]?.config ?? fullConfig.plugins?.entries?.["voice-gateway"]?.config ?? {};
-		const startVoiceService = () => {
-			if (globalThis.__voiceGatewayActivated === true) {
-				log.debug("Alfe Voice plugin already activated — skipping duplicate");
-				return;
-			}
-			globalThis.__voiceGatewayActivated = true;
-			log.info("Alfe Voice plugin activating...");
-			voiceServiceUrl = pluginConfig.voiceServiceUrl ?? `http://localhost:${String(pluginConfig.voiceServicePort ?? "3100")}`;
-			voiceServiceApiKey = pluginConfig.voiceServiceApiKey ?? "";
-			log.info(`Voice service: ${voiceServiceUrl}`);
-			let alfeConfig = null;
-			try {
-				alfeConfig = (0, _alfe_ai_config.resolveConfig)();
-			} catch {}
-			connectToDaemon(pluginConfig.daemonSocket ?? alfeConfig?.socketPath ?? _alfe_ai_config.DEFAULT_SOCKET_PATH, log).then((client) => {
-				daemonIpcClient = client;
-			}).catch((err) => {
-				log.debug(`Daemon connect failed: ${err.message}`);
-			});
-		};
-		const stopVoiceService = () => {
-			globalThis.__voiceGatewayActivated = false;
-			if (daemonIpcClient) {
-				try {
-					daemonIpcClient.stop();
-					log.info("Disconnected from Alfe daemon");
-				} catch (err) {
-					log.debug(`Error disconnecting from daemon: ${err.message}`);
-				}
-				daemonIpcClient = null;
-			}
-			log.info("Alfe Voice plugin deactivated");
-		};
-		api.registerGatewayMethod("voice.speak", async (...args) => {
-			const { text } = args[0];
-			log.info(`voice.speak RPC → text=${text?.slice(0, 50) ?? "(none)"}...`);
-			if (!text) throw new Error("voice.speak requires text");
-			return await voiceApi("POST", "/voice/tts", { text });
-		});
-		log.info("Registered gateway RPC method: voice.speak");
-		api.on("message_received", (...eventArgs) => {
-			const event = eventArgs[0];
-			if (eventArgs[1].channelId.includes("voice")) log.debug(`Voice-related message from ${event.from}: ${event.content.slice(0, 100)}`);
-		});
-		api.registerService({
-			id: "alfe-voice-daemon",
-			start: () => {
-				startVoiceService();
-			},
-			stop: () => {
-				stopVoiceService();
-			}
-		});
-		log.info("Alfe Voice plugin activated");
-	},
-	deactivate(api) {
-		globalThis.__voiceGatewayActivated = false;
-		const log = api.logger;
-		log.info("Alfe Voice plugin deactivating...");
-		if (daemonIpcClient) {
-			try {
-				daemonIpcClient.stop();
-				log.info("Disconnected from Alfe daemon");
-			} catch (err) {
-				log.debug(`Error disconnecting from daemon: ${err.message}`);
-			}
-			daemonIpcClient = null;
-		}
-		log.info("Alfe Voice plugin deactivated");
-	}
-};
-//#endregion
-module.exports = plugin;
+const require_plugin = require("./plugin2.cjs");
+module.exports = require_plugin.plugin;

package/dist/plugin.js

@@ -1,221 +1,2 @@
-import { createRequire } from "node:module";
-import { Type } from "@sinclair/typebox";
-import { DEFAULT_SOCKET_PATH, resolveConfig } from "@alfe.ai/config";
-//#region src/plugin.ts
-/**
-* @alfe/voice-plugin — OpenClaw native plugin
-*
-* Thin client that registers voice tools with OpenClaw and forwards
-* TTS/STT operations to the voice service's public API.
-*
-* In the new architecture, voice service is a channel-agnostic pipeline
-* brain. Channel-specific operations (hangup, transfer, DTMF) are handled
-* by the respective channel services (Discord, Twilio, etc.), not voice.
-*
-* This plugin provides:
-*   - voice.speak RPC — converts text to audio via POST /voice/tts
-*   - voice_hangup tool — placeholder (requires channel service)
-*   - voice_transfer tool — placeholder (requires Twilio service)
-*   - voice_dtmf tool �� placeholder (requires Twilio service)
-*/
-const pkg = createRequire(import.meta.url)("../package.json");
-const VOICE_CAPABILITIES = [
-	"voice.call",
-	"voice.answer",
-	"voice.dtmf",
-	"voice.hangup"
-];
-let voiceServiceUrl = "";
-let voiceServiceApiKey = "";
-async function voiceApi(method, path, body) {
-	const url = `${voiceServiceUrl}${path}`;
-	const headers = { "Content-Type": "application/json" };
-	if (voiceServiceApiKey) headers["x-api-key"] = voiceServiceApiKey;
-	const res = await fetch(url, {
-		method,
-		headers,
-		body: body ? JSON.stringify(body) : void 0
-	});
-	const json = await res.json();
-	if (!res.ok) {
-		const errorMsg = typeof json.error === "string" ? json.error : `Voice service returned ${String(res.status)}`;
-		throw new Error(errorMsg);
-	}
-	return json;
-}
-let daemonIpcClient = null;
-async function connectToDaemon(socketPath, log) {
-	try {
-		const IPCClientCtor = (await import("@alfe.ai/openclaw")).IPCClient;
-		const client = new IPCClientCtor(socketPath, log);
-		client.on("connected", async () => {
-			log.info("Connected to Alfe daemon — registering voice capabilities...");
-			const response = await client.request("capability.register", {
-				plugin: "@alfe.ai/openclaw-voice",
-				capabilities: [...VOICE_CAPABILITIES]
-			});
-			if (response.ok) log.info("Voice capabilities registered with daemon");
-			else log.warn(`Failed to register voice capabilities: ${response.error?.message ?? "unknown"}`);
-		});
-		client.on("disconnected", (reason) => {
-			log.warn(`Disconnected from Alfe daemon: ${String(reason)}`);
-		});
-		client.on("error", (err) => {
-			log.debug(`Daemon IPC error: ${err.message}`);
-		});
-		client.start();
-		return client;
-	} catch {
-		log.info("Alfe daemon not available — voice plugin running standalone");
-		return null;
-	}
-}
-function ok(data) {
-	return {
-		content: [{
-			type: "text",
-			text: JSON.stringify(data)
-		}],
-		details: data
-	};
-}
-function errResult(message) {
-	return {
-		content: [{
-			type: "text",
-			text: JSON.stringify({ error: message })
-		}],
-		details: { error: message }
-	};
-}
-function defineTool(def) {
-	return {
-		name: def.name,
-		description: def.description,
-		label: def.name,
-		parameters: def.parameters,
-		execute: async (_toolCallId, params) => {
-			try {
-				return ok(await def.handler(params));
-			} catch (e) {
-				return errResult(e.message);
-			}
-		}
-	};
-}
-const voiceTools = [
-	defineTool({
-		name: "voice_hangup",
-		description: "Hang up the current voice call or leave the voice channel. Use when the conversation is done or the user asks you to leave.",
-		parameters: Type.Object({ sessionId: Type.Optional(Type.String({ description: "Voice session ID." })) }),
-		handler: () => {
-			throw new Error("voice_hangup requires a channel service (Discord/Twilio). The voice service no longer manages channels directly.");
-		}
-	}),
-	defineTool({
-		name: "voice_transfer",
-		description: "Transfer the current phone call to another number. Only works for Twilio calls.",
-		parameters: Type.Object({
-			targetNumber: Type.String({ description: "Phone number to transfer to (E.164 format)" }),
-			sessionId: Type.Optional(Type.String({ description: "Voice session ID." }))
-		}),
-		handler: () => {
-			throw new Error("voice_transfer requires the Twilio service. The voice service no longer manages phone calls directly.");
-		}
-	}),
-	defineTool({
-		name: "voice_dtmf",
-		description: "Send DTMF tones (dial pad digits) on the current phone call. Only works for Twilio calls.",
-		parameters: Type.Object({
-			digits: Type.String({ description: "DTMF digits to send (0-9, *, #, w for pause)" }),
-			sessionId: Type.Optional(Type.String({ description: "Voice session ID." }))
-		}),
-		handler: () => {
-			throw new Error("voice_dtmf requires the Twilio service. The voice service no longer manages phone calls directly.");
-		}
-	})
-];
-const plugin = {
-	id: "@alfe.ai/openclaw-voice",
-	name: "Alfe Voice Plugin",
-	description: "Voice integration — TTS/STT via the voice service, channel-specific operations via channel services",
-	version: pkg.version,
-	activate(api) {
-		const log = api.logger;
-		for (const tool of voiceTools) api.registerTool(tool);
-		log.info(`Registered ${String(voiceTools.length)} voice tools: ${voiceTools.map((t) => t.name).join(", ")}`);
-		const fullConfig = api.config ?? {};
-		const pluginConfig = fullConfig.plugins?.entries?.["@alfe.ai/openclaw-voice"]?.config ?? fullConfig.plugins?.entries?.["voice-gateway"]?.config ?? {};
-		const startVoiceService = () => {
-			if (globalThis.__voiceGatewayActivated === true) {
-				log.debug("Alfe Voice plugin already activated — skipping duplicate");
-				return;
-			}
-			globalThis.__voiceGatewayActivated = true;
-			log.info("Alfe Voice plugin activating...");
-			voiceServiceUrl = pluginConfig.voiceServiceUrl ?? `http://localhost:${String(pluginConfig.voiceServicePort ?? "3100")}`;
-			voiceServiceApiKey = pluginConfig.voiceServiceApiKey ?? "";
-			log.info(`Voice service: ${voiceServiceUrl}`);
-			let alfeConfig = null;
-			try {
-				alfeConfig = resolveConfig();
-			} catch {}
-			connectToDaemon(pluginConfig.daemonSocket ?? alfeConfig?.socketPath ?? DEFAULT_SOCKET_PATH, log).then((client) => {
-				daemonIpcClient = client;
-			}).catch((err) => {
-				log.debug(`Daemon connect failed: ${err.message}`);
-			});
-		};
-		const stopVoiceService = () => {
-			globalThis.__voiceGatewayActivated = false;
-			if (daemonIpcClient) {
-				try {
-					daemonIpcClient.stop();
-					log.info("Disconnected from Alfe daemon");
-				} catch (err) {
-					log.debug(`Error disconnecting from daemon: ${err.message}`);
-				}
-				daemonIpcClient = null;
-			}
-			log.info("Alfe Voice plugin deactivated");
-		};
-		api.registerGatewayMethod("voice.speak", async (...args) => {
-			const { text } = args[0];
-			log.info(`voice.speak RPC → text=${text?.slice(0, 50) ?? "(none)"}...`);
-			if (!text) throw new Error("voice.speak requires text");
-			return await voiceApi("POST", "/voice/tts", { text });
-		});
-		log.info("Registered gateway RPC method: voice.speak");
-		api.on("message_received", (...eventArgs) => {
-			const event = eventArgs[0];
-			if (eventArgs[1].channelId.includes("voice")) log.debug(`Voice-related message from ${event.from}: ${event.content.slice(0, 100)}`);
-		});
-		api.registerService({
-			id: "alfe-voice-daemon",
-			start: () => {
-				startVoiceService();
-			},
-			stop: () => {
-				stopVoiceService();
-			}
-		});
-		log.info("Alfe Voice plugin activated");
-	},
-	deactivate(api) {
-		globalThis.__voiceGatewayActivated = false;
-		const log = api.logger;
-		log.info("Alfe Voice plugin deactivating...");
-		if (daemonIpcClient) {
-			try {
-				daemonIpcClient.stop();
-				log.info("Disconnected from Alfe daemon");
-			} catch (err) {
-				log.debug(`Error disconnecting from daemon: ${err.message}`);
-			}
-			daemonIpcClient = null;
-		}
-		log.info("Alfe Voice plugin deactivated");
-	}
-};
-//#endregion
+import { t as plugin } from "./plugin2.js";
 export { plugin as default };

package/dist/plugin2.cjs

@@ -0,0 +1,374 @@
+let _sinclair_typebox = require("@sinclair/typebox");
+let _alfe_ai_config = require("@alfe.ai/config");
+let _alfe_ai_agent_api_client = require("@alfe.ai/agent-api-client");
+let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
+let node_module = require("node:module");
+//#region src/audio.ts
+/** Prepend a canonical 44-byte PCM WAV header to raw PCM samples. */
+function pcmToWav(pcm, framing) {
+	const { sampleRate, channels, bitDepth } = framing;
+	const blockAlign = channels * (bitDepth / 8);
+	const byteRate = sampleRate * blockAlign;
+	const header = Buffer.alloc(44);
+	header.write("RIFF", 0, "ascii");
+	header.writeUInt32LE(36 + pcm.length, 4);
+	header.write("WAVE", 8, "ascii");
+	header.write("fmt ", 12, "ascii");
+	header.writeUInt32LE(16, 16);
+	header.writeUInt16LE(1, 20);
+	header.writeUInt16LE(channels, 22);
+	header.writeUInt32LE(sampleRate, 24);
+	header.writeUInt32LE(byteRate, 28);
+	header.writeUInt16LE(blockAlign, 32);
+	header.writeUInt16LE(bitDepth, 34);
+	header.write("data", 36, "ascii");
+	header.writeUInt32LE(pcm.length, 40);
+	return Buffer.concat([header, pcm]);
+}
+/**
+* Parse a WAV buffer into its PCM payload + framing. Returns `null` when the
+* buffer is not a RIFF/WAVE file (caller should then treat the bytes as raw
+* PCM). Walks the chunk list so it tolerates `fmt `/`data` ordering, extra
+* chunks (e.g. `LIST`/`fact`), and word-alignment padding.
+*/
+function parseWav(buf) {
+	if (buf.length < 44) return null;
+	if (buf.toString("ascii", 0, 4) !== "RIFF") return null;
+	if (buf.toString("ascii", 8, 12) !== "WAVE") return null;
+	let sampleRate = 0;
+	let channels = 0;
+	let bitDepth = 0;
+	let pcm = null;
+	let offset = 12;
+	while (offset + 8 <= buf.length) {
+		const chunkId = buf.toString("ascii", offset, offset + 4);
+		const chunkSize = buf.readUInt32LE(offset + 4);
+		const bodyStart = offset + 8;
+		if (chunkId === "fmt " && bodyStart + 16 <= buf.length) {
+			channels = buf.readUInt16LE(bodyStart + 2);
+			sampleRate = buf.readUInt32LE(bodyStart + 4);
+			bitDepth = buf.readUInt16LE(bodyStart + 14);
+		} else if (chunkId === "data") {
+			const end = Math.min(bodyStart + chunkSize, buf.length);
+			pcm = buf.subarray(bodyStart, end);
+		}
+		offset = bodyStart + chunkSize + chunkSize % 2;
+	}
+	if (!pcm || sampleRate === 0 || channels === 0 || bitDepth === 0) return null;
+	return {
+		pcm,
+		sampleRate,
+		channels,
+		bitDepth
+	};
+}
+//#endregion
+//#region src/plugin.ts
+/**
+* @alfe/voice-plugin — OpenClaw native plugin
+*
+* Thin client that registers voice tools with OpenClaw and forwards
+* TTS/STT operations to the voice service's public API.
+*
+* In the new architecture, voice service is a channel-agnostic pipeline
+* brain. Channel-specific operations (hangup, transfer, DTMF) are handled
+* by the respective channel services (Discord, Twilio, etc.), not voice.
+*
+* This plugin provides:
+*   - voice_tts tool — text → audio file via POST /voice/tts (agent-authed)
+*   - voice_stt tool — audio file → transcript via POST /voice/stt (agent-authed)
+*   - voice.speak RPC — legacy gateway RPC (reads plugin config; vestigial)
+*   - voice_hangup tool — placeholder (requires channel service)
+*   - voice_transfer tool — placeholder (requires Twilio service)
+*   - voice_dtmf tool — placeholder (requires Twilio service)
+*
+* The voice_tts/voice_stt tools source URL + agent key from ~/.alfe/config.toml
+* via `@alfe.ai/config` (resolveConfig) and call through `AgentApiClient` — the
+* sanctioned client for these plugins. They do NOT read OpenClaw plugin config
+* or hit localhost.
+*/
+const pkg = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href)("../package.json");
+const VOICE_CAPABILITIES = [
+	"voice.call",
+	"voice.answer",
+	"voice.dtmf",
+	"voice.hangup"
+];
+let voiceServiceUrl = "";
+let voiceServiceApiKey = "";
+async function voiceApi(method, path, body) {
+	const url = `${voiceServiceUrl}${path}`;
+	const headers = { "Content-Type": "application/json" };
+	if (voiceServiceApiKey) headers["x-api-key"] = voiceServiceApiKey;
+	const res = await fetch(url, {
+		method,
+		headers,
+		body: body ? JSON.stringify(body) : void 0
+	});
+	const json = await res.json();
+	if (!res.ok) {
+		const errorMsg = typeof json.error === "string" ? json.error : `Voice service returned ${String(res.status)}`;
+		throw new Error(errorMsg);
+	}
+	return json;
+}
+let daemonIpcClient = null;
+async function connectToDaemon(socketPath, log) {
+	try {
+		const IPCClientCtor = (await import("@alfe.ai/openclaw")).IPCClient;
+		const client = new IPCClientCtor(socketPath, log);
+		client.on("connected", async () => {
+			log.info("Connected to Alfe daemon — registering voice capabilities...");
+			const response = await client.request("capability.register", {
+				plugin: "@alfe.ai/openclaw-voice",
+				capabilities: [...VOICE_CAPABILITIES]
+			});
+			if (response.ok) log.info("Voice capabilities registered with daemon");
+			else log.warn(`Failed to register voice capabilities: ${response.error?.message ?? "unknown"}`);
+		});
+		client.on("disconnected", (reason) => {
+			log.warn(`Disconnected from Alfe daemon: ${String(reason)}`);
+		});
+		client.on("error", (err) => {
+			log.debug(`Daemon IPC error: ${err.message}`);
+		});
+		client.start();
+		return client;
+	} catch {
+		log.info("Alfe daemon not available — voice plugin running standalone");
+		return null;
+	}
+}
+function ok(data) {
+	return {
+		content: [{
+			type: "text",
+			text: JSON.stringify(data)
+		}],
+		details: data
+	};
+}
+function errResult(message) {
+	return {
+		content: [{
+			type: "text",
+			text: JSON.stringify({ error: message })
+		}],
+		details: { error: message }
+	};
+}
+function defineTool(def) {
+	return {
+		name: def.name,
+		description: def.description,
+		label: def.name,
+		parameters: def.parameters,
+		execute: async (_toolCallId, params) => {
+			try {
+				return ok(await def.handler(params));
+			} catch (e) {
+				return errResult(e.message);
+			}
+		}
+	};
+}
+let voiceClient = null;
+function getVoiceClient() {
+	if (voiceClient) return voiceClient;
+	const config = (0, _alfe_ai_config.resolveConfig)();
+	voiceClient = new _alfe_ai_agent_api_client.AgentApiClient({
+		apiUrl: config.voiceServiceUrl,
+		apiKey: config.apiKey
+	});
+	return voiceClient;
+}
+/** Resolve a tool-supplied path against the agent's working directory. */
+function resolveWorkspacePath(p) {
+	return (0, node_path.isAbsolute)(p) ? p : (0, node_path.resolve)(process.cwd(), p);
+}
+const voiceTools = [
+	defineTool({
+		name: "voice_tts",
+		description: "Convert text to speech using the Alfe voice service (ElevenLabs). Writes a playable audio file to the workspace and returns its path. Billed per character to your tenant credit pool.",
+		parameters: _sinclair_typebox.Type.Object({
+			text: _sinclair_typebox.Type.String({ description: "Text to synthesize (1–5000 characters)." }),
+			outputPath: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.String({ description: "Where to write the audio file (absolute, or relative to the working directory). Defaults to alfe-tts-<timestamp>.wav in the working directory." })),
+			format: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.Union([_sinclair_typebox.Type.Literal("wav"), _sinclair_typebox.Type.Literal("pcm")], { description: "Output container. 'wav' (default) is a playable file; 'pcm' is headerless 24kHz/mono/16-bit raw PCM." })),
+			voiceId: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.String({ description: "ElevenLabs voice ID. Platform default when omitted." })),
+			model: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.Union([_sinclair_typebox.Type.Literal("eleven_turbo_v2_5"), _sinclair_typebox.Type.Literal("eleven_multilingual_v2")], { description: "TTS model. eleven_turbo_v2_5 (lower latency) when omitted." }))
+		}),
+		handler: async (params) => {
+			const text = params.text;
+			const format = params.format ?? "wav";
+			const result = await getVoiceClient().tts({
+				text,
+				voiceId: params.voiceId,
+				model: params.model
+			});
+			const bytes = format === "wav" ? pcmToWav(result.audio, {
+				sampleRate: result.sampleRate,
+				channels: result.channels,
+				bitDepth: result.bitDepth
+			}) : result.audio;
+			const outputPath = params.outputPath ?? `alfe-tts-${String(Date.now())}.${format}`;
+			const absolutePath = resolveWorkspacePath(outputPath);
+			await (0, node_fs_promises.writeFile)(absolutePath, bytes);
+			return {
+				path: outputPath,
+				absolutePath,
+				format,
+				sampleRate: result.sampleRate,
+				channels: result.channels,
+				bitDepth: result.bitDepth,
+				bytes: bytes.length,
+				characters: text.length
+			};
+		}
+	}),
+	defineTool({
+		name: "voice_stt",
+		description: "Transcribe an audio file to text using the Alfe voice service (Deepgram). Accepts a WAV file or headerless mono 16-bit PCM. Billed per audio-second to your tenant credit pool.",
+		parameters: _sinclair_typebox.Type.Object({
+			path: _sinclair_typebox.Type.String({ description: "Path to the audio file (absolute, or relative to the working directory). WAV or raw linear16 mono PCM." }),
+			sampleRate: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.Number({ description: "Sample rate in Hz (8000–48000). Only used for headerless PCM input; ignored for WAV (its header wins). Defaults to 24000." }))
+		}),
+		handler: async (params) => {
+			const raw = await (0, node_fs_promises.readFile)(resolveWorkspacePath(params.path));
+			const wav = parseWav(raw);
+			let audio;
+			let sampleRate;
+			if (wav) {
+				if (wav.bitDepth !== 16 || wav.channels !== 1) throw new Error(`voice_stt needs 16-bit mono audio; got ${String(wav.bitDepth)}-bit / ${String(wav.channels)}-channel WAV. Re-export as 16-bit mono.`);
+				audio = wav.pcm;
+				sampleRate = wav.sampleRate;
+			} else {
+				audio = raw;
+				sampleRate = params.sampleRate ?? 24e3;
+			}
+			return getVoiceClient().stt({
+				audio,
+				sampleRate
+			});
+		}
+	}),
+	defineTool({
+		name: "voice_hangup",
+		description: "Hang up the current voice call or leave the voice channel. Use when the conversation is done or the user asks you to leave.",
+		parameters: _sinclair_typebox.Type.Object({ sessionId: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.String({ description: "Voice session ID." })) }),
+		handler: () => {
+			throw new Error("voice_hangup requires a channel service (Discord/Twilio). The voice service no longer manages channels directly.");
+		}
+	}),
+	defineTool({
+		name: "voice_transfer",
+		description: "Transfer the current phone call to another number. Only works for Twilio calls.",
+		parameters: _sinclair_typebox.Type.Object({
+			targetNumber: _sinclair_typebox.Type.String({ description: "Phone number to transfer to (E.164 format)" }),
+			sessionId: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.String({ description: "Voice session ID." }))
+		}),
+		handler: () => {
+			throw new Error("voice_transfer requires the Twilio service. The voice service no longer manages phone calls directly.");
+		}
+	}),
+	defineTool({
+		name: "voice_dtmf",
+		description: "Send DTMF tones (dial pad digits) on the current phone call. Only works for Twilio calls.",
+		parameters: _sinclair_typebox.Type.Object({
+			digits: _sinclair_typebox.Type.String({ description: "DTMF digits to send (0-9, *, #, w for pause)" }),
+			sessionId: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.String({ description: "Voice session ID." }))
+		}),
+		handler: () => {
+			throw new Error("voice_dtmf requires the Twilio service. The voice service no longer manages phone calls directly.");
+		}
+	})
+];
+const plugin = {
+	id: "@alfe.ai/openclaw-voice",
+	name: "Alfe Voice Plugin",
+	description: "Voice integration — TTS/STT via the voice service, channel-specific operations via channel services",
+	version: pkg.version,
+	activate(api) {
+		const log = api.logger;
+		for (const tool of voiceTools) api.registerTool(tool);
+		log.info(`Registered ${String(voiceTools.length)} voice tools: ${voiceTools.map((t) => t.name).join(", ")}`);
+		const fullConfig = api.config ?? {};
+		const pluginConfig = fullConfig.plugins?.entries?.["@alfe.ai/openclaw-voice"]?.config ?? fullConfig.plugins?.entries?.["voice-gateway"]?.config ?? {};
+		const startVoiceService = () => {
+			if (globalThis.__voiceGatewayActivated === true) {
+				log.debug("Alfe Voice plugin already activated — skipping duplicate");
+				return;
+			}
+			globalThis.__voiceGatewayActivated = true;
+			log.info("Alfe Voice plugin activating...");
+			voiceServiceUrl = pluginConfig.voiceServiceUrl ?? `http://localhost:${String(pluginConfig.voiceServicePort ?? "3100")}`;
+			voiceServiceApiKey = pluginConfig.voiceServiceApiKey ?? "";
+			log.info(`Voice service: ${voiceServiceUrl}`);
+			let alfeConfig = null;
+			try {
+				alfeConfig = (0, _alfe_ai_config.resolveConfig)();
+			} catch {}
+			connectToDaemon(pluginConfig.daemonSocket ?? alfeConfig?.socketPath ?? _alfe_ai_config.DEFAULT_SOCKET_PATH, log).then((client) => {
+				daemonIpcClient = client;
+			}).catch((err) => {
+				log.debug(`Daemon connect failed: ${err.message}`);
+			});
+		};
+		const stopVoiceService = () => {
+			globalThis.__voiceGatewayActivated = false;
+			if (daemonIpcClient) {
+				try {
+					daemonIpcClient.stop();
+					log.info("Disconnected from Alfe daemon");
+				} catch (err) {
+					log.debug(`Error disconnecting from daemon: ${err.message}`);
+				}
+				daemonIpcClient = null;
+			}
+			log.info("Alfe Voice plugin deactivated");
+		};
+		api.registerGatewayMethod("voice.speak", async (...args) => {
+			const { text } = args[0];
+			log.info(`voice.speak RPC → text=${text?.slice(0, 50) ?? "(none)"}...`);
+			if (!text) throw new Error("voice.speak requires text");
+			return await voiceApi("POST", "/voice/tts", { text });
+		});
+		log.info("Registered gateway RPC method: voice.speak");
+		api.on("message_received", (...eventArgs) => {
+			const event = eventArgs[0];
+			if (eventArgs[1].channelId.includes("voice")) log.debug(`Voice-related message from ${event.from}: ${event.content.slice(0, 100)}`);
+		});
+		api.registerService({
+			id: "alfe-voice-daemon",
+			start: () => {
+				startVoiceService();
+			},
+			stop: () => {
+				stopVoiceService();
+			}
+		});
+		log.info("Alfe Voice plugin activated");
+	},
+	deactivate(api) {
+		globalThis.__voiceGatewayActivated = false;
+		const log = api.logger;
+		log.info("Alfe Voice plugin deactivating...");
+		if (daemonIpcClient) {
+			try {
+				daemonIpcClient.stop();
+				log.info("Disconnected from Alfe daemon");
+			} catch (err) {
+				log.debug(`Error disconnecting from daemon: ${err.message}`);
+			}
+			daemonIpcClient = null;
+		}
+		log.info("Alfe Voice plugin deactivated");
+	}
+};
+//#endregion
+Object.defineProperty(exports, "plugin", {
+	enumerable: true,
+	get: function() {
+		return plugin;
+	}
+});

package/dist/plugin2.js

@@ -0,0 +1,369 @@
+import { createRequire } from "node:module";
+import { Type } from "@sinclair/typebox";
+import { DEFAULT_SOCKET_PATH, resolveConfig } from "@alfe.ai/config";
+import { AgentApiClient } from "@alfe.ai/agent-api-client";
+import { readFile, writeFile } from "node:fs/promises";
+import { isAbsolute, resolve } from "node:path";
+//#region src/audio.ts
+/** Prepend a canonical 44-byte PCM WAV header to raw PCM samples. */
+function pcmToWav(pcm, framing) {
+	const { sampleRate, channels, bitDepth } = framing;
+	const blockAlign = channels * (bitDepth / 8);
+	const byteRate = sampleRate * blockAlign;
+	const header = Buffer.alloc(44);
+	header.write("RIFF", 0, "ascii");
+	header.writeUInt32LE(36 + pcm.length, 4);
+	header.write("WAVE", 8, "ascii");
+	header.write("fmt ", 12, "ascii");
+	header.writeUInt32LE(16, 16);
+	header.writeUInt16LE(1, 20);
+	header.writeUInt16LE(channels, 22);
+	header.writeUInt32LE(sampleRate, 24);
+	header.writeUInt32LE(byteRate, 28);
+	header.writeUInt16LE(blockAlign, 32);
+	header.writeUInt16LE(bitDepth, 34);
+	header.write("data", 36, "ascii");
+	header.writeUInt32LE(pcm.length, 40);
+	return Buffer.concat([header, pcm]);
+}
+/**
+* Parse a WAV buffer into its PCM payload + framing. Returns `null` when the
+* buffer is not a RIFF/WAVE file (caller should then treat the bytes as raw
+* PCM). Walks the chunk list so it tolerates `fmt `/`data` ordering, extra
+* chunks (e.g. `LIST`/`fact`), and word-alignment padding.
+*/
+function parseWav(buf) {
+	if (buf.length < 44) return null;
+	if (buf.toString("ascii", 0, 4) !== "RIFF") return null;
+	if (buf.toString("ascii", 8, 12) !== "WAVE") return null;
+	let sampleRate = 0;
+	let channels = 0;
+	let bitDepth = 0;
+	let pcm = null;
+	let offset = 12;
+	while (offset + 8 <= buf.length) {
+		const chunkId = buf.toString("ascii", offset, offset + 4);
+		const chunkSize = buf.readUInt32LE(offset + 4);
+		const bodyStart = offset + 8;
+		if (chunkId === "fmt " && bodyStart + 16 <= buf.length) {
+			channels = buf.readUInt16LE(bodyStart + 2);
+			sampleRate = buf.readUInt32LE(bodyStart + 4);
+			bitDepth = buf.readUInt16LE(bodyStart + 14);
+		} else if (chunkId === "data") {
+			const end = Math.min(bodyStart + chunkSize, buf.length);
+			pcm = buf.subarray(bodyStart, end);
+		}
+		offset = bodyStart + chunkSize + chunkSize % 2;
+	}
+	if (!pcm || sampleRate === 0 || channels === 0 || bitDepth === 0) return null;
+	return {
+		pcm,
+		sampleRate,
+		channels,
+		bitDepth
+	};
+}
+//#endregion
+//#region src/plugin.ts
+/**
+* @alfe/voice-plugin — OpenClaw native plugin
+*
+* Thin client that registers voice tools with OpenClaw and forwards
+* TTS/STT operations to the voice service's public API.
+*
+* In the new architecture, voice service is a channel-agnostic pipeline
+* brain. Channel-specific operations (hangup, transfer, DTMF) are handled
+* by the respective channel services (Discord, Twilio, etc.), not voice.
+*
+* This plugin provides:
+*   - voice_tts tool — text → audio file via POST /voice/tts (agent-authed)
+*   - voice_stt tool — audio file → transcript via POST /voice/stt (agent-authed)
+*   - voice.speak RPC — legacy gateway RPC (reads plugin config; vestigial)
+*   - voice_hangup tool — placeholder (requires channel service)
+*   - voice_transfer tool — placeholder (requires Twilio service)
+*   - voice_dtmf tool — placeholder (requires Twilio service)
+*
+* The voice_tts/voice_stt tools source URL + agent key from ~/.alfe/config.toml
+* via `@alfe.ai/config` (resolveConfig) and call through `AgentApiClient` — the
+* sanctioned client for these plugins. They do NOT read OpenClaw plugin config
+* or hit localhost.
+*/
+const pkg = createRequire(import.meta.url)("../package.json");
+const VOICE_CAPABILITIES = [
+	"voice.call",
+	"voice.answer",
+	"voice.dtmf",
+	"voice.hangup"
+];
+let voiceServiceUrl = "";
+let voiceServiceApiKey = "";
+async function voiceApi(method, path, body) {
+	const url = `${voiceServiceUrl}${path}`;
+	const headers = { "Content-Type": "application/json" };
+	if (voiceServiceApiKey) headers["x-api-key"] = voiceServiceApiKey;
+	const res = await fetch(url, {
+		method,
+		headers,
+		body: body ? JSON.stringify(body) : void 0
+	});
+	const json = await res.json();
+	if (!res.ok) {
+		const errorMsg = typeof json.error === "string" ? json.error : `Voice service returned ${String(res.status)}`;
+		throw new Error(errorMsg);
+	}
+	return json;
+}
+let daemonIpcClient = null;
+async function connectToDaemon(socketPath, log) {
+	try {
+		const IPCClientCtor = (await import("@alfe.ai/openclaw")).IPCClient;
+		const client = new IPCClientCtor(socketPath, log);
+		client.on("connected", async () => {
+			log.info("Connected to Alfe daemon — registering voice capabilities...");
+			const response = await client.request("capability.register", {
+				plugin: "@alfe.ai/openclaw-voice",
+				capabilities: [...VOICE_CAPABILITIES]
+			});
+			if (response.ok) log.info("Voice capabilities registered with daemon");
+			else log.warn(`Failed to register voice capabilities: ${response.error?.message ?? "unknown"}`);
+		});
+		client.on("disconnected", (reason) => {
+			log.warn(`Disconnected from Alfe daemon: ${String(reason)}`);
+		});
+		client.on("error", (err) => {
+			log.debug(`Daemon IPC error: ${err.message}`);
+		});
+		client.start();
+		return client;
+	} catch {
+		log.info("Alfe daemon not available — voice plugin running standalone");
+		return null;
+	}
+}
+function ok(data) {
+	return {
+		content: [{
+			type: "text",
+			text: JSON.stringify(data)
+		}],
+		details: data
+	};
+}
+function errResult(message) {
+	return {
+		content: [{
+			type: "text",
+			text: JSON.stringify({ error: message })
+		}],
+		details: { error: message }
+	};
+}
+function defineTool(def) {
+	return {
+		name: def.name,
+		description: def.description,
+		label: def.name,
+		parameters: def.parameters,
+		execute: async (_toolCallId, params) => {
+			try {
+				return ok(await def.handler(params));
+			} catch (e) {
+				return errResult(e.message);
+			}
+		}
+	};
+}
+let voiceClient = null;
+function getVoiceClient() {
+	if (voiceClient) return voiceClient;
+	const config = resolveConfig();
+	voiceClient = new AgentApiClient({
+		apiUrl: config.voiceServiceUrl,
+		apiKey: config.apiKey
+	});
+	return voiceClient;
+}
+/** Resolve a tool-supplied path against the agent's working directory. */
+function resolveWorkspacePath(p) {
+	return isAbsolute(p) ? p : resolve(process.cwd(), p);
+}
+const voiceTools = [
+	defineTool({
+		name: "voice_tts",
+		description: "Convert text to speech using the Alfe voice service (ElevenLabs). Writes a playable audio file to the workspace and returns its path. Billed per character to your tenant credit pool.",
+		parameters: Type.Object({
+			text: Type.String({ description: "Text to synthesize (1–5000 characters)." }),
+			outputPath: Type.Optional(Type.String({ description: "Where to write the audio file (absolute, or relative to the working directory). Defaults to alfe-tts-<timestamp>.wav in the working directory." })),
+			format: Type.Optional(Type.Union([Type.Literal("wav"), Type.Literal("pcm")], { description: "Output container. 'wav' (default) is a playable file; 'pcm' is headerless 24kHz/mono/16-bit raw PCM." })),
+			voiceId: Type.Optional(Type.String({ description: "ElevenLabs voice ID. Platform default when omitted." })),
+			model: Type.Optional(Type.Union([Type.Literal("eleven_turbo_v2_5"), Type.Literal("eleven_multilingual_v2")], { description: "TTS model. eleven_turbo_v2_5 (lower latency) when omitted." }))
+		}),
+		handler: async (params) => {
+			const text = params.text;
+			const format = params.format ?? "wav";
+			const result = await getVoiceClient().tts({
+				text,
+				voiceId: params.voiceId,
+				model: params.model
+			});
+			const bytes = format === "wav" ? pcmToWav(result.audio, {
+				sampleRate: result.sampleRate,
+				channels: result.channels,
+				bitDepth: result.bitDepth
+			}) : result.audio;
+			const outputPath = params.outputPath ?? `alfe-tts-${String(Date.now())}.${format}`;
+			const absolutePath = resolveWorkspacePath(outputPath);
+			await writeFile(absolutePath, bytes);
+			return {
+				path: outputPath,
+				absolutePath,
+				format,
+				sampleRate: result.sampleRate,
+				channels: result.channels,
+				bitDepth: result.bitDepth,
+				bytes: bytes.length,
+				characters: text.length
+			};
+		}
+	}),
+	defineTool({
+		name: "voice_stt",
+		description: "Transcribe an audio file to text using the Alfe voice service (Deepgram). Accepts a WAV file or headerless mono 16-bit PCM. Billed per audio-second to your tenant credit pool.",
+		parameters: Type.Object({
+			path: Type.String({ description: "Path to the audio file (absolute, or relative to the working directory). WAV or raw linear16 mono PCM." }),
+			sampleRate: Type.Optional(Type.Number({ description: "Sample rate in Hz (8000–48000). Only used for headerless PCM input; ignored for WAV (its header wins). Defaults to 24000." }))
+		}),
+		handler: async (params) => {
+			const raw = await readFile(resolveWorkspacePath(params.path));
+			const wav = parseWav(raw);
+			let audio;
+			let sampleRate;
+			if (wav) {
+				if (wav.bitDepth !== 16 || wav.channels !== 1) throw new Error(`voice_stt needs 16-bit mono audio; got ${String(wav.bitDepth)}-bit / ${String(wav.channels)}-channel WAV. Re-export as 16-bit mono.`);
+				audio = wav.pcm;
+				sampleRate = wav.sampleRate;
+			} else {
+				audio = raw;
+				sampleRate = params.sampleRate ?? 24e3;
+			}
+			return getVoiceClient().stt({
+				audio,
+				sampleRate
+			});
+		}
+	}),
+	defineTool({
+		name: "voice_hangup",
+		description: "Hang up the current voice call or leave the voice channel. Use when the conversation is done or the user asks you to leave.",
+		parameters: Type.Object({ sessionId: Type.Optional(Type.String({ description: "Voice session ID." })) }),
+		handler: () => {
+			throw new Error("voice_hangup requires a channel service (Discord/Twilio). The voice service no longer manages channels directly.");
+		}
+	}),
+	defineTool({
+		name: "voice_transfer",
+		description: "Transfer the current phone call to another number. Only works for Twilio calls.",
+		parameters: Type.Object({
+			targetNumber: Type.String({ description: "Phone number to transfer to (E.164 format)" }),
+			sessionId: Type.Optional(Type.String({ description: "Voice session ID." }))
+		}),
+		handler: () => {
+			throw new Error("voice_transfer requires the Twilio service. The voice service no longer manages phone calls directly.");
+		}
+	}),
+	defineTool({
+		name: "voice_dtmf",
+		description: "Send DTMF tones (dial pad digits) on the current phone call. Only works for Twilio calls.",
+		parameters: Type.Object({
+			digits: Type.String({ description: "DTMF digits to send (0-9, *, #, w for pause)" }),
+			sessionId: Type.Optional(Type.String({ description: "Voice session ID." }))
+		}),
+		handler: () => {
+			throw new Error("voice_dtmf requires the Twilio service. The voice service no longer manages phone calls directly.");
+		}
+	})
+];
+const plugin = {
+	id: "@alfe.ai/openclaw-voice",
+	name: "Alfe Voice Plugin",
+	description: "Voice integration — TTS/STT via the voice service, channel-specific operations via channel services",
+	version: pkg.version,
+	activate(api) {
+		const log = api.logger;
+		for (const tool of voiceTools) api.registerTool(tool);
+		log.info(`Registered ${String(voiceTools.length)} voice tools: ${voiceTools.map((t) => t.name).join(", ")}`);
+		const fullConfig = api.config ?? {};
+		const pluginConfig = fullConfig.plugins?.entries?.["@alfe.ai/openclaw-voice"]?.config ?? fullConfig.plugins?.entries?.["voice-gateway"]?.config ?? {};
+		const startVoiceService = () => {
+			if (globalThis.__voiceGatewayActivated === true) {
+				log.debug("Alfe Voice plugin already activated — skipping duplicate");
+				return;
+			}
+			globalThis.__voiceGatewayActivated = true;
+			log.info("Alfe Voice plugin activating...");
+			voiceServiceUrl = pluginConfig.voiceServiceUrl ?? `http://localhost:${String(pluginConfig.voiceServicePort ?? "3100")}`;
+			voiceServiceApiKey = pluginConfig.voiceServiceApiKey ?? "";
+			log.info(`Voice service: ${voiceServiceUrl}`);
+			let alfeConfig = null;
+			try {
+				alfeConfig = resolveConfig();
+			} catch {}
+			connectToDaemon(pluginConfig.daemonSocket ?? alfeConfig?.socketPath ?? DEFAULT_SOCKET_PATH, log).then((client) => {
+				daemonIpcClient = client;
+			}).catch((err) => {
+				log.debug(`Daemon connect failed: ${err.message}`);
+			});
+		};
+		const stopVoiceService = () => {
+			globalThis.__voiceGatewayActivated = false;
+			if (daemonIpcClient) {
+				try {
+					daemonIpcClient.stop();
+					log.info("Disconnected from Alfe daemon");
+				} catch (err) {
+					log.debug(`Error disconnecting from daemon: ${err.message}`);
+				}
+				daemonIpcClient = null;
+			}
+			log.info("Alfe Voice plugin deactivated");
+		};
+		api.registerGatewayMethod("voice.speak", async (...args) => {
+			const { text } = args[0];
+			log.info(`voice.speak RPC → text=${text?.slice(0, 50) ?? "(none)"}...`);
+			if (!text) throw new Error("voice.speak requires text");
+			return await voiceApi("POST", "/voice/tts", { text });
+		});
+		log.info("Registered gateway RPC method: voice.speak");
+		api.on("message_received", (...eventArgs) => {
+			const event = eventArgs[0];
+			if (eventArgs[1].channelId.includes("voice")) log.debug(`Voice-related message from ${event.from}: ${event.content.slice(0, 100)}`);
+		});
+		api.registerService({
+			id: "alfe-voice-daemon",
+			start: () => {
+				startVoiceService();
+			},
+			stop: () => {
+				stopVoiceService();
+			}
+		});
+		log.info("Alfe Voice plugin activated");
+	},
+	deactivate(api) {
+		globalThis.__voiceGatewayActivated = false;
+		const log = api.logger;
+		log.info("Alfe Voice plugin deactivating...");
+		if (daemonIpcClient) {
+			try {
+				daemonIpcClient.stop();
+				log.info("Disconnected from Alfe daemon");
+			} catch (err) {
+				log.debug(`Error disconnecting from daemon: ${err.message}`);
+			}
+			daemonIpcClient = null;
+		}
+		log.info("Alfe Voice plugin deactivated");
+	}
+};
+//#endregion
+export { plugin as t };

package/openclaw.plugin.json

@@ -1,11 +1,11 @@
 {
   "id": "@alfe.ai/openclaw-voice",
   "name": "Alfe Voice Plugin",
-  "description": "Pure relay plugin — connects to Fly voice server via WebSocket. All audio processing (STT, TTS, ack) runs on Fly.",
+  "description": "Alfe voice plugin — agent-callable one-shot TTS/STT via the voice service (billed to the tenant credit pool). Channel-specific ops (hangup/transfer/DTMF) are handled by channel services.",
   "entry": "./dist/plugin.js",
   "activation": { "onStartup": true },
   "contracts": {
-    "tools": ["voice_dtmf", "voice_hangup", "voice_transfer"]
+    "tools": ["voice_tts", "voice_stt", "voice_dtmf", "voice_hangup", "voice_transfer"]
   },
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-voice",
-  "version": "0.0.17",
+  "version": "0.1.0",
   "description": "OpenClaw voice plugin for Alfe — Discord audio, Twilio, Recall.ai",
   "type": "module",
   "main": "./dist/index.js",
@@ -28,7 +28,8 @@
   ],
   "dependencies": {
     "@sinclair/typebox": "^0.34.48",
-    "@alfe.ai/config": "0.1.0"
+    "@alfe.ai/agent-api-client": "0.4.0",
+    "@alfe.ai/config": "0.2.0"
   },
   "peerDependencies": {
     "openclaw": ">=2026.3.0"
@@ -38,6 +39,16 @@
       "optional": true
     }
   },
+  "homepage": "https://alfe.ai",
+  "author": "Alfe (https://alfe.ai)",
+  "keywords": [
+    "alfe",
+    "ai-agents",
+    "agent",
+    "llm",
+    "openclaw",
+    "plugin"
+  ],
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",