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

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,9 @@
+import { asOptionalRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { MAX_AUDIO_BYTES } from "openclaw/plugin-sdk/media-runtime";
 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;
@@ -139,7 +140,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.2",
   "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.2"
     },
     "build": {
-      "openclawVersion": "2026.7.2-beta.7",
+      "openclawVersion": "2026.8.1-beta.2",
       "bundledDist": false
     },
     "release": {
@@ -38,7 +38,7 @@
     "README.md"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.7.2-beta.7"
+    "openclaw": ">=2026.8.1-beta.2"
   },
   "peerDependenciesMeta": {
     "openclaw": {