@alfe.ai/openclaw-voice 0.1.14 → 0.2.0

package/dist/plugin2.js

@@ -1,12 +1,32 @@
 import { createRequire } from "node:module";
 import { Type } from "@sinclair/typebox";
-import { DEFAULT_SOCKET_PATH, resolveConfig } from "@alfe.ai/config";
+import { resolveConfig } from "@alfe.ai/config";
 import { AgentApiClient, installToolErrorCapture } from "@alfe.ai/agent-api-client";
-import { readFile, writeFile } from "node:fs/promises";
-import { isAbsolute, resolve } from "node:path";
+import { defineTool, publicToolError } from "@alfe.ai/openclaw-plugin-kit";
+import { constants } from "node:fs";
+import { lstat, open, realpath, unlink } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 //#region src/audio.ts
+const MAX_WAV_PCM_BYTES = 4294967259;
+const SUPPORTED_BIT_DEPTHS = new Set([
+	8,
+	16,
+	24,
+	32
+]);
+function validatePcmFraming(framing, pcmLength) {
+	const { sampleRate, channels, bitDepth } = framing;
+	if (!Number.isInteger(sampleRate) || sampleRate < 8e3 || sampleRate > 384e3) throw new Error("WAV sample rate must be an integer between 8000 and 384000 Hz.");
+	if (!Number.isInteger(channels) || channels < 1 || channels > 32) throw new Error("WAV channel count must be an integer between 1 and 32.");
+	if (!SUPPORTED_BIT_DEPTHS.has(bitDepth)) throw new Error("WAV bit depth must be one of 8, 16, 24, or 32.");
+	const blockAlign = channels * (bitDepth / 8);
+	if (pcmLength % blockAlign !== 0) throw new Error("PCM byte length must contain a whole number of sample frames.");
+	if (pcmLength > MAX_WAV_PCM_BYTES) throw new Error("PCM payload is too large for a RIFF/WAV container.");
+	if (sampleRate * blockAlign > 4294967295) throw new Error("WAV byte rate exceeds the RIFF field limit.");
+}
 /** Prepend a canonical 44-byte PCM WAV header to raw PCM samples. */
 function pcmToWav(pcm, framing) {
+	validatePcmFraming(framing, pcm.length);
 	const { sampleRate, channels, bitDepth } = framing;
 	const blockAlign = channels * (bitDepth / 8);
 	const byteRate = sampleRate * blockAlign;
@@ -27,35 +47,59 @@ function pcmToWav(pcm, framing) {
 	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.
+* Parse a WAV buffer into its PCM payload + framing. Returns `null` only when
+* the buffer is not RIFF data (caller may then treat it as raw PCM). A RIFF
+* buffer that claims to be WAV but is truncated, unsupported, or internally
+* inconsistent throws instead of silently uploading container bytes as PCM.
 */
 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;
+	if (buf.length < 4 || buf.toString("ascii", 0, 4) !== "RIFF") return null;
+	if (buf.length < 12) throw new Error("Malformed WAV: truncated RIFF header.");
+	if (buf.toString("ascii", 8, 12) !== "WAVE") throw new Error("Unsupported RIFF container: expected WAVE.");
+	const declaredEnd = buf.readUInt32LE(4) + 8;
+	if (declaredEnd !== buf.length) throw new Error("Malformed WAV: RIFF size does not match the file length.");
 	let sampleRate = 0;
 	let channels = 0;
 	let bitDepth = 0;
 	let pcm = null;
+	let blockAlign = 0;
+	let byteRate = 0;
+	let sawFmt = false;
+	let sawData = false;
 	let offset = 12;
-	while (offset + 8 <= buf.length) {
+	while (offset < declaredEnd) {
+		if (offset + 8 > declaredEnd) throw new Error("Malformed WAV: truncated chunk header.");
 		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) {
+		const bodyEnd = bodyStart + chunkSize;
+		const nextOffset = bodyEnd + chunkSize % 2;
+		if (bodyEnd > declaredEnd || nextOffset > declaredEnd) throw new Error(`Malformed WAV: truncated ${chunkId} chunk.`);
+		if (chunkId === "fmt ") {
+			if (sawFmt) throw new Error("Malformed WAV: duplicate fmt chunk.");
+			if (chunkSize < 16) throw new Error("Malformed WAV: fmt chunk is too short.");
+			if (buf.readUInt16LE(bodyStart) !== 1) throw new Error("Unsupported WAV encoding: only integer PCM is accepted.");
 			channels = buf.readUInt16LE(bodyStart + 2);
 			sampleRate = buf.readUInt32LE(bodyStart + 4);
+			byteRate = buf.readUInt32LE(bodyStart + 8);
+			blockAlign = buf.readUInt16LE(bodyStart + 12);
 			bitDepth = buf.readUInt16LE(bodyStart + 14);
+			sawFmt = true;
 		} else if (chunkId === "data") {
-			const end = Math.min(bodyStart + chunkSize, buf.length);
-			pcm = buf.subarray(bodyStart, end);
+			if (sawData) throw new Error("Malformed WAV: duplicate data chunk.");
+			pcm = buf.subarray(bodyStart, bodyEnd);
+			sawData = true;
 		}
-		offset = bodyStart + chunkSize + chunkSize % 2;
+		offset = nextOffset;
 	}
-	if (!pcm || sampleRate === 0 || channels === 0 || bitDepth === 0) return null;
+	if (!sawFmt || !sawData || pcm === null) throw new Error("Malformed WAV: both fmt and data chunks are required.");
+	validatePcmFraming({
+		sampleRate,
+		channels,
+		bitDepth
+	}, pcm.length);
+	const expectedBlockAlign = channels * (bitDepth / 8);
+	if (blockAlign !== expectedBlockAlign || byteRate !== sampleRate * expectedBlockAlign) throw new Error("Malformed WAV: byte rate or block alignment is inconsistent with its framing.");
 	return {
 		pcm,
 		sampleRate,
@@ -64,6 +108,83 @@ function parseWav(buf) {
 	};
 }
 //#endregion
+//#region src/workspace-files.ts
+const MAX_TOOL_PATH_LENGTH = 1024;
+function isWithin(root, candidate) {
+	const rel = relative(root, candidate);
+	return rel === "" || !isAbsolute(rel) && rel !== ".." && !rel.startsWith(`..${sep}`);
+}
+function assertRelativeToolPath(input, label) {
+	if (input.length === 0) throw new Error(`${label} must not be empty.`);
+	if (input.length > MAX_TOOL_PATH_LENGTH) throw new Error(`${label} is too long (maximum ${String(MAX_TOOL_PATH_LENGTH)} characters).`);
+	if (input.includes("\0")) throw new Error(`${label} contains a null byte.`);
+	if (isAbsolute(input) || /^[A-Za-z]:[\\/]/u.test(input) || input.startsWith("\\\\")) throw new Error(`${label} must be relative to the workspace.`);
+	if (input.split(/[\\/]/u).includes("..")) throw new Error(`${label} must not contain parent-directory traversal.`);
+}
+async function workspaceRoot() {
+	return realpath(process.cwd());
+}
+async function readWorkspaceFile(input, maxBytes) {
+	assertRelativeToolPath(input, "Path");
+	if (!Number.isSafeInteger(maxBytes) || maxBytes < 1) throw new Error("Maximum file size must be a positive safe integer.");
+	const root = await workspaceRoot();
+	const lexicalPath = resolve(root, input);
+	if (!isWithin(root, lexicalPath)) throw new Error("Path escapes the workspace.");
+	const absolutePath = await realpath(lexicalPath);
+	if (!isWithin(root, absolutePath)) throw new Error("Path resolves outside the workspace.");
+	const handle = await open(absolutePath, constants.O_RDONLY | constants.O_NOFOLLOW);
+	try {
+		const before = await handle.stat();
+		if (!before.isFile()) throw new Error("Path must refer to a regular file.");
+		if (before.size > maxBytes) throw new Error(`File is too large (maximum ${String(maxBytes)} bytes).`);
+		const data = await handle.readFile();
+		const after = await handle.stat();
+		if (data.length > maxBytes || after.size > maxBytes) throw new Error(`File is too large (maximum ${String(maxBytes)} bytes).`);
+		return {
+			absolutePath,
+			data
+		};
+	} finally {
+		await handle.close();
+	}
+}
+async function resolveWorkspaceOutputPath(input) {
+	assertRelativeToolPath(input, "Output path");
+	const root = await workspaceRoot();
+	const lexicalPath = resolve(root, input);
+	if (!isWithin(root, lexicalPath)) throw new Error("Output path escapes the workspace.");
+	const parent = await realpath(dirname(lexicalPath));
+	if (!isWithin(root, parent)) throw new Error("Output path resolves outside the workspace.");
+	const absolutePath = join(parent, basename(lexicalPath));
+	try {
+		await lstat(absolutePath);
+		throw new Error(`Refusing to overwrite existing workspace file: ${input}`);
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+	}
+	return absolutePath;
+}
+async function writeWorkspaceFileExclusive(input, data) {
+	const absolutePath = await resolveWorkspaceOutputPath(input);
+	let handle;
+	try {
+		handle = await open(absolutePath, "wx", 384);
+	} catch (error) {
+		if (error.code === "EEXIST") throw new Error(`Refusing to overwrite existing workspace file: ${input}`);
+		throw error;
+	}
+	let completed = false;
+	try {
+		await handle.writeFile(data);
+		await handle.sync();
+		completed = true;
+		return absolutePath;
+	} finally {
+		await handle.close();
+		if (!completed) await unlink(absolutePath).catch(() => void 0);
+	}
+}
+//#endregion
 //#region src/plugin.ts
 /**
 * @alfe/voice-plugin — OpenClaw native plugin
@@ -78,10 +199,14 @@ function parseWav(buf) {
 * 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 plugin is intentionally tool-only. It has no daemon connection,
+* gateway RPC, message hook, or plugin-config credential path.
+*
+* voice_hangup / voice_transfer / voice_dtmf were removed deliberately — they
+* threw unconditionally ("requires a channel service"), which poisons the
+* model's tool selection with always-failing options. Re-add per-channel when
+* the twilio-adapter/Discord dispatch actually lands (voice-engineer roadmap).
 *
 * The voice_tts/voice_stt tools source URL + agent key from ~/.alfe/config.toml
 * via `@alfe.ai/config` (resolveConfig) and call through `AgentApiClient` — the
@@ -89,90 +214,10 @@ function parseWav(buf) {
 * 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);
-			}
-		}
-	};
-}
+const MAX_AUDIO_FILE_BYTES = 10 * 1024 * 1024;
+const MAX_TTS_RESPONSE_BYTES = 32 * 1024 * 1024;
+const VOICE_ID_PATTERN = "^[A-Za-z0-9_-]{1,200}$";
+const VOICE_ID_REGEX = /^[A-Za-z0-9_-]{1,200}$/u;
 let voiceClient = null;
 function getVoiceClient() {
 	if (voiceClient) return voiceClient;
@@ -183,106 +228,99 @@ function getVoiceClient() {
 	});
 	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." }))
+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({
+			minLength: 1,
+			maxLength: 5e3,
+			description: "Text to synthesize (1–5000 characters)."
 		}),
-		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
-			});
-		}
+		outputPath: Type.Optional(Type.String({
+			minLength: 1,
+			maxLength: 1024,
+			description: "New workspace-relative audio file to create. Existing files are never overwritten. Defaults to alfe-tts-<timestamp>.wav."
+		})),
+		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({
+			pattern: VOICE_ID_PATTERN,
+			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." }))
 	}),
-	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: async (params) => {
+		const text = params.text.trim();
+		if (text.length < 1 || text.length > 5e3) throw publicToolError("voice_tts text must contain 1–5000 characters.");
+		const voiceId = params.voiceId;
+		if (voiceId !== void 0 && !VOICE_ID_REGEX.test(voiceId)) throw publicToolError("voice_tts voiceId contains unsupported characters.");
+		const format = params.format ?? "wav";
+		const outputPath = params.outputPath ?? `alfe-tts-${String(Date.now())}.${format}`;
+		await resolveWorkspaceOutputPath(outputPath);
+		const result = await getVoiceClient().tts({
+			text,
+			voiceId,
+			model: params.model
+		});
+		if (result.audio.length === 0 || result.audio.length > MAX_TTS_RESPONSE_BYTES) throw new Error(`voice_tts returned an invalid audio payload size (${String(result.audio.length)} bytes).`);
+		validatePcmFraming({
+			sampleRate: result.sampleRate,
+			channels: result.channels,
+			bitDepth: result.bitDepth
+		}, result.audio.length);
+		const bytes = format === "wav" ? pcmToWav(result.audio, {
+			sampleRate: result.sampleRate,
+			channels: result.channels,
+			bitDepth: result.bitDepth
+		}) : result.audio;
+		return {
+			path: outputPath,
+			absolutePath: await writeWorkspaceFileExclusive(outputPath, bytes),
+			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({
+			minLength: 1,
+			maxLength: 1024,
+			description: "Workspace-relative path to a WAV or raw linear16 mono PCM file (maximum 10 MiB)."
 		}),
-		handler: () => {
-			throw new Error("voice_transfer requires the Twilio service. The voice service no longer manages phone calls directly.");
-		}
+		sampleRate: Type.Optional(Type.Number({
+			minimum: 8e3,
+			maximum: 48e3,
+			multipleOf: 1,
+			description: "Sample rate in Hz (8000–48000). Only used for headerless PCM input; ignored for WAV (its header wins). Defaults to 24000."
+		}))
 	}),
-	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.");
+	handler: async (params) => {
+		const { data: raw } = await readWorkspaceFile(params.path, MAX_AUDIO_FILE_BYTES);
+		const wav = parseWav(raw);
+		let audio;
+		let sampleRate;
+		if (wav) {
+			if (wav.bitDepth !== 16 || wav.channels !== 1) throw publicToolError(`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;
 		}
-	})
-];
+		if (!Number.isInteger(sampleRate) || sampleRate < 8e3 || sampleRate > 48e3) throw publicToolError("voice_stt sampleRate must be an integer between 8000 and 48000 Hz.");
+		if (audio.length === 0 || audio.length % 2 !== 0) throw publicToolError("voice_stt needs non-empty 16-bit PCM with an even byte length.");
+		return getVoiceClient().stt({
+			audio,
+			sampleRate
+		});
+	}
+})];
 const plugin = {
 	id: "@alfe.ai/openclaw-voice",
 	name: "Alfe Voice Plugin",
@@ -293,76 +331,12 @@ const plugin = {
 		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;
-		}
+		voiceClient = null;
 		log.info("Alfe Voice plugin deactivated");
 	}
 };

package/openclaw.plugin.json

@@ -3,22 +3,13 @@
   "name": "Alfe Voice Plugin",
   "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 },
+  "activation": { "onStartup": false },
   "contracts": {
-    "tools": ["voice_tts", "voice_stt", "voice_dtmf", "voice_hangup", "voice_transfer"]
+    "tools": ["voice_tts", "voice_stt"]
   },
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
-    "properties": {
-      "agentToken": {
-        "type": "string",
-        "description": "Single token for relay authentication and agent identification. Defaults to api_key from ~/.alfe/config.toml if not set."
-      },
-      "relayUrl": {
-        "type": "string",
-        "description": "WebSocket URL of the Fly voice server relay endpoint. Defaults to wss://voice.dev.alfe.ai/gateway"
-      }
-    }
+    "properties": {}
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alfe.ai/openclaw-voice",
-  "version": "0.1.14",
-  "description": "OpenClaw voice plugin for Alfe — Discord audio, Twilio, Recall.ai",
+  "version": "0.2.0",
+  "description": "OpenClaw tools for Alfe one-shot text-to-speech and speech-to-text",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -28,8 +28,9 @@
   ],
   "dependencies": {
     "@sinclair/typebox": "^0.34.48",
-    "@alfe.ai/agent-api-client": "0.13.0",
-    "@alfe.ai/config": "0.3.0"
+    "@alfe.ai/agent-api-client": "0.15.0",
+    "@alfe.ai/config": "0.4.1",
+    "@alfe.ai/openclaw-plugin-kit": "0.2.0"
   },
   "peerDependencies": {
     "openclaw": ">=2026.3.0"