@openclaw/fish-audio-speech 2026.7.2-beta.7 → 2026.8.1-beta.3

package/README.md

@@ -2,9 +2,16 @@
 
 Official OpenClaw speech provider for Fish Audio's hosted S2.1 API.
 
-Configure `tts.provider: "fish-audio"` and set `FISH_API_KEY`. The provider
-supports buffered audio, HTTP-streamed playback, native Opus voice notes,
-8 kHz PCM telephony, and Fish Audio voice discovery.
+Install it with:
+
+```bash
+openclaw plugins install @openclaw/fish-audio-speech
+```
+
+The plugin id is `fish-audio-speech`; the speech provider and TTS config id
+remain `fish-audio`. Configure `tts.provider: "fish-audio"` and set
+`FISH_API_KEY`. The provider supports buffered audio, HTTP-streamed playback,
+native Opus voice notes, 8 kHz PCM telephony, and Fish Audio voice discovery.
 
 See [Fish Audio](https://docs.openclaw.ai/providers/fish-audio) for setup,
 models, voice selection, expressive tags, and local macOS MLX usage.

package/dist/index.js

@@ -1,8 +1,8 @@
 import { buildFishAudioSpeechProvider } from "./speech-provider.js";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
-//#region extensions/fish-audio/index.ts
-var fish_audio_default = definePluginEntry({
-	id: "fish-audio",
+//#region extensions/fish-audio-speech/index.ts
+var fish_audio_speech_default = definePluginEntry({
+	id: "fish-audio-speech",
 	name: "Fish Audio Speech",
 	description: "Hosted Fish Audio S2.1 text-to-speech provider",
 	register(api) {
@@ -10,4 +10,4 @@ var fish_audio_default = definePluginEntry({
 	}
 });
 //#endregion
-export { fish_audio_default as default };
+export { fish_audio_speech_default as default };

package/dist/speech-provider.js

@@ -1,8 +1,9 @@
 import { FISH_AUDIO_STREAM_MAX_BYTES, fishAudioTts, fishAudioTtsStream, listFishAudioVoices, normalizeFishAudioBaseUrl } from "./tts.js";
 import { resolveGeneratedMediaMaxBytes } from "openclaw/plugin-sdk/media-generation-runtime";
 import { normalizeResolvedSecretInputString } from "openclaw/plugin-sdk/secret-input";
-import { asBoolean, asFiniteNumber, asObject, parseSpeechDirectiveNumberOverride, resolveSpeechProviderApiKey, trimToUndefined } from "openclaw/plugin-sdk/speech-core";
-//#region extensions/fish-audio/speech-provider.ts
+import { asBoolean, parseSpeechDirectiveNumberOverride, resolveSpeechProviderApiKey, trimToUndefined } from "openclaw/plugin-sdk/speech-core";
+import { asFiniteNumberInRange, asOptionalRecord, parseBooleanValue } from "openclaw/plugin-sdk/string-coerce-runtime";
+//#region extensions/fish-audio-speech/speech-provider.ts
 const FISH_AUDIO_MODELS = [
 	"s2.1-pro-free",
 	"s2.1-pro",
@@ -25,14 +26,16 @@ function normalizeLatency(value) {
 	throw new Error(`invalid Fish Audio latency "${latency}"`);
 }
 function normalizeNumber(value, min, max) {
-	const number = asFiniteNumber(value);
-	return number != null && number >= min && number <= max ? number : void 0;
+	return asFiniteNumberInRange(value, {
+		min,
+		max
+	});
 }
 function resolveReferenceId(raw) {
 	return trimToUndefined(raw?.speakerVoiceId ?? raw?.voiceId ?? raw?.referenceId);
 }
 function normalizeProviderConfig(rawConfig) {
-	const raw = asObject(asObject(rawConfig.providers)?.["fish-audio"]) ?? asObject(rawConfig["fish-audio"]);
+	const raw = asOptionalRecord(asOptionalRecord(rawConfig.providers)?.["fish-audio"]) ?? asOptionalRecord(rawConfig["fish-audio"]);
 	return {
 		apiKey: normalizeResolvedSecretInputString({
 			value: raw?.apiKey,
@@ -50,7 +53,7 @@ function normalizeProviderConfig(rawConfig) {
 }
 function readProviderConfig(config) {
 	const defaults = normalizeProviderConfig({});
-	const raw = asObject(config) ?? {};
+	const raw = asOptionalRecord(config) ?? {};
 	return {
 		apiKey: trimToUndefined(raw.apiKey) ?? defaults.apiKey,
 		baseUrl: normalizeFishAudioBaseUrl(trimToUndefined(raw.baseUrl) ?? defaults.baseUrl),
@@ -64,7 +67,7 @@ function readProviderConfig(config) {
 	};
 }
 function readOverrides(overrides) {
-	const raw = asObject(overrides) ?? {};
+	const raw = asOptionalRecord(overrides) ?? {};
 	return {
 		model: trimToUndefined(raw.model ?? raw.modelId) ? normalizeModel(raw.model ?? raw.modelId) : void 0,
 		referenceId: resolveReferenceId(raw),
@@ -164,29 +167,12 @@ function parseDirectiveToken(ctx) {
 		case "normalize":
 		case "fish_normalize": {
 			if (!ctx.policy.allowNormalization) return { handled: true };
-			const value = ctx.value.trim().toLowerCase();
-			if ([
-				"true",
-				"1",
-				"yes",
-				"on"
-			].includes(value)) return {
+			const normalize = parseBooleanValue(ctx.value);
+			if (normalize !== void 0) return {
 				handled: true,
 				overrides: {
 					...ctx.currentOverrides,
-					normalize: true
-				}
-			};
-			if ([
-				"false",
-				"0",
-				"no",
-				"off"
-			].includes(value)) return {
-				handled: true,
-				overrides: {
-					...ctx.currentOverrides,
-					normalize: false
+					normalize
 				}
 			};
 			return {

package/dist/tts.js

@@ -1,8 +1,10 @@
+import { asOptionalRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { MAX_AUDIO_BYTES } from "openclaw/plugin-sdk/media-runtime";
+import { createBoundedProviderBinaryStream } from "openclaw/plugin-sdk/provider-binary-stream";
 import { assertOkOrThrowProviderError, assertProviderBinaryResponseContent, readProviderBinaryResponse, readProviderJsonResponse } from "openclaw/plugin-sdk/provider-http";
-import { asObject, trimToUndefined } from "openclaw/plugin-sdk/speech";
+import { trimToUndefined } from "openclaw/plugin-sdk/speech";
 import { fetchWithSsrFGuard, ssrfPolicyFromHttpBaseUrlAllowedHostname } from "openclaw/plugin-sdk/ssrf-runtime";
-//#region extensions/fish-audio/tts.ts
+//#region extensions/fish-audio-speech/tts.ts
 const FISH_AUDIO_BASE_URL = "https://api.fish.audio";
 const FISH_AUDIO_VOICES_MAX_BYTES = 2 * 1024 * 1024;
 const FISH_AUDIO_VOICE_PAGE_SIZE = 100;
@@ -51,65 +53,6 @@ async function fishAudioTts(params) {
 		await release();
 	}
 }
-function createBoundedFishAudioStream(stream, maxBytes) {
-	let reader;
-	let totalBytes = 0;
-	const releaseReader = (activeReader) => {
-		if (reader === activeReader) {
-			reader = void 0;
-			activeReader.releaseLock();
-		}
-	};
-	const cancelReader = async (reason) => {
-		const activeReader = reader;
-		if (!activeReader) return;
-		try {
-			await activeReader.cancel(reason).catch(() => void 0);
-		} finally {
-			releaseReader(activeReader);
-		}
-	};
-	return {
-		audioStream: new ReadableStream({
-			start() {
-				reader = stream.getReader();
-			},
-			async pull(controller) {
-				const activeReader = reader;
-				if (!activeReader) {
-					controller.close();
-					return;
-				}
-				try {
-					const chunk = await activeReader.read();
-					if (chunk.done) {
-						releaseReader(activeReader);
-						controller.close();
-						return;
-					}
-					const remaining = maxBytes - totalBytes;
-					if (chunk.value.byteLength > remaining) {
-						if (remaining > 0) controller.enqueue(chunk.value.subarray(0, remaining));
-						const error = /* @__PURE__ */ new Error(`Fish Audio TTS API error: audio response exceeds ${maxBytes} bytes`);
-						await activeReader.cancel(error).catch(() => void 0);
-						releaseReader(activeReader);
-						controller.error(error);
-						return;
-					}
-					totalBytes += chunk.value.byteLength;
-					controller.enqueue(chunk.value);
-				} catch (error) {
-					releaseReader(activeReader);
-					controller.error(error);
-				}
-			},
-			async cancel(reason) {
-				await cancelReader(reason);
-			}
-		}),
-		release: () => cancelReader(/* @__PURE__ */ new Error("Fish Audio TTS stream released"))
-	};
-}
 async function fishAudioTtsStream(params) {
 	const { response, release } = await requestFishAudioTts(params);
 	let handedOff = false;
@@ -117,7 +60,11 @@ async function fishAudioTtsStream(params) {
 		await assertOkOrThrowProviderError(response, "Fish Audio TTS API error");
 		assertProviderBinaryResponseContent(response, "Fish Audio TTS API error", "audio");
 		if (!response.body) throw new Error("Fish Audio TTS API response missing audio stream");
-		const bounded = createBoundedFishAudioStream(response.body, params.maxBytes);
+		const bounded = createBoundedProviderBinaryStream(response.body, {
+			maxBytes: params.maxBytes,
+			createOverflowError: ({ maxBytes }) => /* @__PURE__ */ new Error(`Fish Audio TTS API error: audio response exceeds ${maxBytes} bytes`),
+			createReleaseError: () => /* @__PURE__ */ new Error("Fish Audio TTS stream released")
+		});
 		let releasePromise;
 		const releaseAll = () => {
 			releasePromise ??= (async () => {
@@ -131,7 +78,7 @@ async function fishAudioTtsStream(params) {
 		};
 		handedOff = true;
 		return {
-			audioStream: bounded.audioStream,
+			audioStream: bounded.stream,
 			release: releaseAll
 		};
 	} finally {
@@ -139,7 +86,7 @@ async function fishAudioTtsStream(params) {
 	}
 }
 function parseVoiceItem(value) {
-	const item = asObject(value);
+	const item = asOptionalRecord(value);
 	const id = trimToUndefined(item?.["_id"]);
 	if (!id) return;
 	const languages = Array.isArray(item?.languages) ? item.languages.flatMap((entry) => typeof entry === "string" && entry.trim() ? [entry.trim()] : []) : [];

package/openclaw.plugin.json

@@ -1,5 +1,6 @@
 {
-  "id": "fish-audio",
+  "id": "fish-audio-speech",
+  "legacyPluginIds": ["fish-audio"],
   "activation": {
     "onStartup": false
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/fish-audio-speech",
-  "version": "2026.7.2-beta.7",
+  "version": "2026.8.1-beta.3",
   "description": "OpenClaw Fish Audio speech plugin.",
   "repository": {
     "type": "git",
@@ -18,10 +18,10 @@
       "minHostVersion": ">=2026.7.2"
     },
     "compat": {
-      "pluginApi": ">=2026.7.2-beta.7"
+      "pluginApi": ">=2026.8.1-beta.3"
     },
     "build": {
-      "openclawVersion": "2026.7.2-beta.7",
+      "openclawVersion": "2026.8.1-beta.3",
       "bundledDist": false
     },
     "release": {
@@ -38,7 +38,7 @@
     "README.md"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.7.2-beta.7"
+    "openclaw": ">=2026.8.1-beta.3"
   },
   "peerDependenciesMeta": {
     "openclaw": {