@alfe.ai/openclaw-voice 0.1.13 → 0.1.15

package/dist/index.d.cts

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

package/dist/index.d.ts

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

package/dist/plugin.d.cts

@@ -1,5 +1,43 @@
-import { TSchema } from "@sinclair/typebox";
+//#region ../openclaw-plugin-kit/dist/index.d.ts
 
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+//#region src/tools.d.ts
+/**
+ * Tool-definition helpers — the `defineTool` / `ok` / `errResult` trio that
+ * was copy-pasted across 8 plugins (identity, google, teams, mobile,
+ * whatsapp, voice, chat a2a-tools, base openclaw).
+ *
+ * Error handling is standardized on the openclaw-google variant — the only
+ * copy that survived non-`Error` throws (`e instanceof Error ? e.message :
+ * "Unknown error"`). The other copies did `(e as Error).message`, which
+ * crashes the tool executor when a handler throws a string/object.
+ */
+/** Shape returned to OpenClaw from a tool `execute`. */
+interface ToolResult {
+  content: {
+    type: "text";
+    text: string;
+  }[];
+  details: unknown;
+}
+/**
+ * An OpenClaw tool definition.
+ *
+ * `parameters` is generic because the fleet is split between TypeBox
+ * `TSchema` schemas (identity/google/teams/mobile/whatsapp) and plain
+ * JSON-Schema objects (chat a2a-tools). Instantiate with whichever schema
+ * type the plugin uses — the kit itself has no schema dependency.
+ */
+interface ToolDef<TParameters = unknown> {
+  name: string;
+  description: string;
+  label: string;
+  parameters: TParameters;
+  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<ToolResult>;
+}
+/** Wrap a successful handler result in the OpenClaw tool-result envelope. */
+//#endregion
 //#region src/plugin.d.ts
 
 interface Logger {
@@ -46,19 +84,6 @@ interface OpenClawPluginApi {
     priority?: number;
   }): void;
 }
-interface ToolDef {
-  name: string;
-  description: string;
-  label: string;
-  parameters: TSchema;
-  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<{
-    content: {
-      type: 'text';
-      text: string;
-    }[];
-    details: unknown;
-  }>;
-}
 declare const plugin: {
   id: string;
   name: string;
@@ -68,4 +93,4 @@ declare const plugin: {
   deactivate(api: OpenClawPluginApi): void;
 };
 //#endregion
-export { plugin as default };
+export { plugin as t };

package/dist/plugin.d.ts

@@ -1,5 +1,43 @@
-import { TSchema } from "@sinclair/typebox";
+//#region ../openclaw-plugin-kit/dist/index.d.ts
 
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+//#region src/tools.d.ts
+/**
+ * Tool-definition helpers — the `defineTool` / `ok` / `errResult` trio that
+ * was copy-pasted across 8 plugins (identity, google, teams, mobile,
+ * whatsapp, voice, chat a2a-tools, base openclaw).
+ *
+ * Error handling is standardized on the openclaw-google variant — the only
+ * copy that survived non-`Error` throws (`e instanceof Error ? e.message :
+ * "Unknown error"`). The other copies did `(e as Error).message`, which
+ * crashes the tool executor when a handler throws a string/object.
+ */
+/** Shape returned to OpenClaw from a tool `execute`. */
+interface ToolResult {
+  content: {
+    type: "text";
+    text: string;
+  }[];
+  details: unknown;
+}
+/**
+ * An OpenClaw tool definition.
+ *
+ * `parameters` is generic because the fleet is split between TypeBox
+ * `TSchema` schemas (identity/google/teams/mobile/whatsapp) and plain
+ * JSON-Schema objects (chat a2a-tools). Instantiate with whichever schema
+ * type the plugin uses — the kit itself has no schema dependency.
+ */
+interface ToolDef<TParameters = unknown> {
+  name: string;
+  description: string;
+  label: string;
+  parameters: TParameters;
+  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<ToolResult>;
+}
+/** Wrap a successful handler result in the OpenClaw tool-result envelope. */
+//#endregion
 //#region src/plugin.d.ts
 
 interface Logger {
@@ -46,19 +84,6 @@ interface OpenClawPluginApi {
     priority?: number;
   }): void;
 }
-interface ToolDef {
-  name: string;
-  description: string;
-  label: string;
-  parameters: TSchema;
-  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<{
-    content: {
-      type: 'text';
-      text: string;
-    }[];
-    details: unknown;
-  }>;
-}
 declare const plugin: {
   id: string;
   name: string;
@@ -68,4 +93,4 @@ declare const plugin: {
   deactivate(api: OpenClawPluginApi): void;
 };
 //#endregion
-export { plugin as default };
+export { plugin as t };

package/dist/plugin2.cjs

@@ -1,6 +1,7 @@
 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 _alfe_ai_openclaw_plugin_kit = require("@alfe.ai/openclaw-plugin-kit");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
 let node_module = require("node:module");
@@ -79,9 +80,11 @@ function parseWav(buf) {
 *   - 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)
+*
+* 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
@@ -95,6 +98,7 @@ const VOICE_CAPABILITIES = [
 	"voice.dtmf",
 	"voice.hangup"
 ];
+const VOICE_ACTIVATION_KEY = (0, _alfe_ai_openclaw_plugin_kit.getActivationKey)("voice");
 let voiceServiceUrl = "";
 let voiceServiceApiKey = "";
 async function voiceApi(method, path, body) {
@@ -114,65 +118,6 @@ async function voiceApi(method, path, body) {
 	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;
@@ -187,102 +132,69 @@ function getVoiceClient() {
 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
-			};
-		}
+const voiceTools = [(0, _alfe_ai_openclaw_plugin_kit.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." }))
 	}),
-	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.");
-		}
+	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
+		};
+	}
+}), (0, _alfe_ai_openclaw_plugin_kit.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." }))
 	}),
-	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.");
+	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
+		});
+	}
+})];
 const plugin = {
 	id: "@alfe.ai/openclaw-voice",
 	name: "Alfe Voice Plugin",
@@ -296,27 +208,27 @@ const plugin = {
 		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}`);
+			(0, _alfe_ai_openclaw_plugin_kit.guardedStart)(VOICE_ACTIVATION_KEY, log, () => {
+				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 {}
+				(0, _alfe_ai_openclaw_plugin_kit.connectToDaemon)(pluginConfig.daemonSocket ?? alfeConfig?.socketPath ?? _alfe_ai_config.DEFAULT_SOCKET_PATH, log, {
+					pluginId: "@alfe.ai/openclaw-voice",
+					capabilities: VOICE_CAPABILITIES,
+					standaloneNote: "Alfe daemon not available — voice plugin running standalone"
+				}).then((client) => {
+					daemonIpcClient = client;
+				}).catch((err) => {
+					log.debug(`Daemon connect failed: ${err.message}`);
+				});
 			});
 		};
 		const stopVoiceService = () => {
-			globalThis.__voiceGatewayActivated = false;
 			if (daemonIpcClient) {
 				try {
 					daemonIpcClient.stop();
@@ -326,6 +238,7 @@ const plugin = {
 				}
 				daemonIpcClient = null;
 			}
+			(0, _alfe_ai_openclaw_plugin_kit.resetActivation)(VOICE_ACTIVATION_KEY);
 			log.info("Alfe Voice plugin deactivated");
 		};
 		api.registerGatewayMethod("voice.speak", async (...args) => {
@@ -351,7 +264,6 @@ const plugin = {
 		log.info("Alfe Voice plugin activated");
 	},
 	deactivate(api) {
-		globalThis.__voiceGatewayActivated = false;
 		const log = api.logger;
 		log.info("Alfe Voice plugin deactivating...");
 		if (daemonIpcClient) {
@@ -363,6 +275,7 @@ const plugin = {
 			}
 			daemonIpcClient = null;
 		}
+		(0, _alfe_ai_openclaw_plugin_kit.resetActivation)(VOICE_ACTIVATION_KEY);
 		log.info("Alfe Voice plugin deactivated");
 	}
 };

package/dist/plugin2.d.cts

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

package/dist/plugin2.d.ts

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

package/dist/plugin2.js

@@ -2,6 +2,7 @@ import { createRequire } from "node:module";
 import { Type } from "@sinclair/typebox";
 import { DEFAULT_SOCKET_PATH, resolveConfig } from "@alfe.ai/config";
 import { AgentApiClient, installToolErrorCapture } from "@alfe.ai/agent-api-client";
+import { connectToDaemon, defineTool, getActivationKey, guardedStart, resetActivation } from "@alfe.ai/openclaw-plugin-kit";
 import { readFile, writeFile } from "node:fs/promises";
 import { isAbsolute, resolve } from "node:path";
 //#region src/audio.ts
@@ -79,9 +80,11 @@ function parseWav(buf) {
 *   - 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)
+*
+* 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
@@ -95,6 +98,7 @@ const VOICE_CAPABILITIES = [
 	"voice.dtmf",
 	"voice.hangup"
 ];
+const VOICE_ACTIVATION_KEY = getActivationKey("voice");
 let voiceServiceUrl = "";
 let voiceServiceApiKey = "";
 async function voiceApi(method, path, body) {
@@ -114,65 +118,6 @@ async function voiceApi(method, path, body) {
 	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;
@@ -187,102 +132,69 @@ function getVoiceClient() {
 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
-			};
-		}
+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." }))
 	}),
-	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.");
-		}
+	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." }))
 	}),
-	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 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
+		});
+	}
+})];
 const plugin = {
 	id: "@alfe.ai/openclaw-voice",
 	name: "Alfe Voice Plugin",
@@ -296,27 +208,27 @@ const plugin = {
 		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}`);
+			guardedStart(VOICE_ACTIVATION_KEY, log, () => {
+				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, {
+					pluginId: "@alfe.ai/openclaw-voice",
+					capabilities: VOICE_CAPABILITIES,
+					standaloneNote: "Alfe daemon not available — voice plugin running standalone"
+				}).then((client) => {
+					daemonIpcClient = client;
+				}).catch((err) => {
+					log.debug(`Daemon connect failed: ${err.message}`);
+				});
 			});
 		};
 		const stopVoiceService = () => {
-			globalThis.__voiceGatewayActivated = false;
 			if (daemonIpcClient) {
 				try {
 					daemonIpcClient.stop();
@@ -326,6 +238,7 @@ const plugin = {
 				}
 				daemonIpcClient = null;
 			}
+			resetActivation(VOICE_ACTIVATION_KEY);
 			log.info("Alfe Voice plugin deactivated");
 		};
 		api.registerGatewayMethod("voice.speak", async (...args) => {
@@ -351,7 +264,6 @@ const plugin = {
 		log.info("Alfe Voice plugin activated");
 	},
 	deactivate(api) {
-		globalThis.__voiceGatewayActivated = false;
 		const log = api.logger;
 		log.info("Alfe Voice plugin deactivating...");
 		if (daemonIpcClient) {
@@ -363,6 +275,7 @@ const plugin = {
 			}
 			daemonIpcClient = null;
 		}
+		resetActivation(VOICE_ACTIVATION_KEY);
 		log.info("Alfe Voice plugin deactivated");
 	}
 };

package/openclaw.plugin.json

@@ -5,7 +5,7 @@
   "entry": "./dist/plugin.js",
   "activation": { "onStartup": true },
   "contracts": {
-    "tools": ["voice_tts", "voice_stt", "voice_dtmf", "voice_hangup", "voice_transfer"]
+    "tools": ["voice_tts", "voice_stt"]
   },
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-voice",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "OpenClaw voice plugin for Alfe — Discord audio, Twilio, Recall.ai",
   "type": "module",
   "main": "./dist/index.js",
@@ -28,8 +28,9 @@
   ],
   "dependencies": {
     "@sinclair/typebox": "^0.34.48",
-    "@alfe.ai/agent-api-client": "0.12.0",
-    "@alfe.ai/config": "0.3.0"
+    "@alfe.ai/agent-api-client": "0.14.0",
+    "@alfe.ai/config": "0.4.0",
+    "@alfe.ai/openclaw-plugin-kit": "0.1.0"
   },
   "peerDependencies": {
     "openclaw": ">=2026.3.0"