@openclaw/fish-audio-speech 2026.10.5-beta.3 → 2026.10.10-beta.1

package/README.md

@@ -1,6 +1,6 @@
 # Fish Audio speech plugin
 
-Official OpenClaw speech provider for Fish Audio's hosted S2.1 API.
+Official OpenClaw speech provider for Fish Audio's hosted S2.1 and Drama 3 APIs.
 
 Install it with:
 
@@ -13,5 +13,10 @@ 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.
 
+Set `tts.providers.fish-audio.model: "drama-3-preview"` to opt in to Drama 3
+voice direction. The default remains `s2.1-pro`. Natural-language directions
+such as `[calm, reassuring]` and paired tags such as `<whisper>...</whisper>`
+are passed through in the spoken text.
+
 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

@@ -4,7 +4,7 @@ import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 var fish_audio_speech_default = definePluginEntry({
 	id: "fish-audio-speech",
 	name: "Fish Audio Speech",
-	description: "Hosted Fish Audio S2.1 text-to-speech provider",
+	description: "Hosted Fish Audio text-to-speech provider",
 	register(api) {
 		api.registerSpeechProvider(buildFishAudioSpeechProvider());
 	}

package/dist/speech-provider.js

@@ -1,14 +1,8 @@
-import { fishAudioTts, fishAudioTtsStream, listFishAudioVoices, normalizeFishAudioBaseUrl } from "./tts.js";
+import { FISH_AUDIO_MODELS, fishAudioTts, fishAudioTtsStream, listFishAudioVoices, normalizeFishAudioBaseUrl } from "./tts.js";
 import { normalizeResolvedSecretInputString } from "openclaw/plugin-sdk/secret-input";
 import { MAX_AUDIO_BYTES, parseSpeechDirectiveNumberOverride, resolveSpeechProviderApiKey } from "openclaw/plugin-sdk/speech-provider";
 import { asBoolean, asFiniteNumberInRange, asOptionalRecord, filterStringRecord, normalizeOptionalString, 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",
-	"s2-pro",
-	"s1"
-];
 const DEFAULT_MODEL = "s2.1-pro";
 const DEFAULT_LATENCY = "balanced";
 const DEFAULT_TIMEOUT_MS = 24e4;
@@ -223,6 +217,7 @@ async function resolveSynthesisRequest(req) {
 	};
 }
 function buildFishAudioSpeechProvider() {
+	const isConfigured = ({ providerConfig }) => Boolean(resolveApiKey(readProviderConfig(providerConfig).apiKey));
 	return {
 		id: "fish-audio",
 		label: "Fish Audio",
@@ -277,7 +272,8 @@ function buildFishAudioSpeechProvider() {
 				timeoutMs: req.timeoutMs ?? DEFAULT_TIMEOUT_MS
 			});
 		},
-		isConfigured: ({ providerConfig }) => Boolean(resolveApiKey(readProviderConfig(providerConfig).apiKey)),
+		isConfigured,
+		isConfiguredAsync: async (ctx) => isConfigured(ctx),
 		synthesize: async (req) => {
 			const params = await resolveSynthesisRequest(req);
 			return {

package/dist/tts.js

@@ -4,6 +4,13 @@ const FISH_AUDIO_BASE_URL = "https://api.fish.audio";
 const FISH_AUDIO_VOICES_MAX_BYTES = 2097152;
 const FISH_AUDIO_VOICE_PAGE_SIZE = 100;
 const FISH_AUDIO_MAX_OWN_VOICE_PAGES = 20;
+const FISH_AUDIO_MODELS = [
+	"drama-3-preview",
+	"s2.1-pro-free",
+	"s2.1-pro",
+	"s2-pro",
+	"s1"
+];
 function normalizeFishAudioBaseUrl(value) {
 	const trimmed = value?.trim();
 	return trimmed ? trimmed.replace(/\/+$/u, "") : FISH_AUDIO_BASE_URL;
@@ -141,4 +148,4 @@ async function listFishAudioVoices(params) {
 	});
 }
 //#endregion
-export { fishAudioTts, fishAudioTtsStream, listFishAudioVoices, normalizeFishAudioBaseUrl };
+export { FISH_AUDIO_MODELS, fishAudioTts, fishAudioTtsStream, listFishAudioVoices, normalizeFishAudioBaseUrl };

package/openclaw.plugin.json

@@ -11,7 +11,7 @@
     "onStartup": false
   },
   "name": "Fish Audio",
-  "description": "Fish Audio S2.1 hosted text-to-speech with streaming, voice notes, and telephony output.",
+  "description": "Fish Audio hosted text-to-speech with streaming, voice notes, and telephony output.",
   "setup": {
     "providers": [
       {

package/package.json

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