@openclaw/gradium-speech 2026.11.3 → 2026.11.5-beta.2

package/dist/.source-module-urls/4ae14bbfb3b816c7d3d9da544908fae9c329ef51ffe05bac64c317fb096020c5.json

@@ -0,0 +1 @@
+{"version":3,"entries":[{"output":"capability-catalog.js","source":"extensions/gradium/capability-catalog.ts"},{"output":"index.js","source":"extensions/gradium/index.ts"},{"output":"speech-provider.js","source":"extensions/gradium/speech-provider.ts"}],"chunks":[{"output":"capability-catalog.js","sha256":"1278a115b88deea97ccacd2fea928197628bf3d95a00d476bf5c38504f3d8ac1","facadeSource":"extensions/gradium/capability-catalog.ts","sources":["extensions/gradium/capability-catalog.ts"]},{"output":"index.js","sha256":"f8dccfc96a366e970f9a70e86931f70c56c2d3455cdbcbb1a560c373113f6f40","facadeSource":"extensions/gradium/index.ts","sources":["extensions/gradium/index.ts"]},{"output":"speech-provider.js","sha256":"b7ecac8532d65cfb1834a9b73902cead7b6a7411509b939e901d385c8735ee9d","facadeSource":"extensions/gradium/speech-provider.ts","sources":["extensions/gradium/speech-provider.ts"]}],"unrenderedSources":[]}

package/dist/speech-provider.js

@@ -1,26 +1,69 @@
-import { GRADIUM_VOICES, normalizeGradiumBaseUrl } from "./shared.js";
-import { gradiumTTS } from "./tts.js";
 import { normalizeResolvedSecretInputString } from "openclaw/plugin-sdk/secret-input";
-import { resolveSpeechProviderApiKey } from "openclaw/plugin-sdk/speech-provider";
+import { createSpeechDirectiveParser, resolveSpeechProviderApiKey } from "openclaw/plugin-sdk/speech-provider";
 import { asOptionalRecord, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/gradium/speech-provider.ts
+const DEFAULT_GRADIUM_BASE_URL = "https://api.gradium.ai";
+const GRADIUM_API_HOSTNAME = "api.gradium.ai";
+const DEFAULT_GRADIUM_VOICE_ID = "YTpq7expH9539ERJ";
+const GRADIUM_VOICES = [
+	{
+		id: "YTpq7expH9539ERJ",
+		name: "Emma"
+	},
+	{
+		id: "LFZvm12tW_z0xfGo",
+		name: "Kent"
+	},
+	{
+		id: "Eu9iL_CYe8N-Gkx_",
+		name: "Tiffany"
+	},
+	{
+		id: "2H4HY2CBNyJHBCrP",
+		name: "Christina"
+	},
+	{
+		id: "jtEKaLYNn6iif5PR",
+		name: "Sydney"
+	},
+	{
+		id: "KWJiFWu2O9nMPYcR",
+		name: "John"
+	},
+	{
+		id: "3jUdJyOi9pgbxBTK",
+		name: "Arthur"
+	}
+];
+function normalizeGradiumBaseUrl(baseUrl) {
+	const raw = baseUrl?.trim() || DEFAULT_GRADIUM_BASE_URL;
+	const url = URL.parse(raw);
+	if (!url) throw new Error("Gradium baseUrl must be a valid https URL");
+	url.username = "";
+	url.password = "";
+	url.search = "";
+	url.hash = "";
+	if (url.protocol !== "https:") throw new Error("Gradium baseUrl must use https");
+	if (url.hostname.toLowerCase() !== GRADIUM_API_HOSTNAME) throw new Error("Gradium baseUrl must target api.gradium.ai");
+	return url.toString().replace(/\/+$/, "");
+}
 function normalizeGradiumProviderConfig(rawConfig) {
 	const providers = asOptionalRecord(rawConfig.providers);
-	const raw = asOptionalRecord(providers?.gradium) ?? asOptionalRecord(rawConfig.gradium);
+	const raw = asOptionalRecord(providers?.gradium);
 	return {
 		apiKey: normalizeResolvedSecretInputString({
 			value: raw?.apiKey,
 			path: "tts.providers.gradium.apiKey"
 		}),
 		baseUrl: normalizeGradiumBaseUrl(normalizeOptionalString(raw?.baseUrl)),
-		voiceId: normalizeOptionalString(raw?.voiceId) ?? "YTpq7expH9539ERJ"
+		voiceId: normalizeOptionalString(raw?.voiceId) ?? DEFAULT_GRADIUM_VOICE_ID
 	};
 }
 function readGradiumProviderConfig(config) {
-	return normalizeGradiumProviderConfig({ gradium: {
+	return normalizeGradiumProviderConfig({ providers: { gradium: {
 		...config,
 		apiKey: normalizeOptionalString(config.apiKey)
-	} });
+	} } });
 }
 function resolveGradiumApiKey(configApiKey) {
 	return resolveSpeechProviderApiKey(normalizeOptionalString(configApiKey), process.env.GRADIUM_API_KEY);
@@ -30,15 +73,43 @@ async function synthesizeGradium(req, outputFormat) {
 	const apiKey = resolveGradiumApiKey(config.apiKey);
 	if (!apiKey) throw new Error("Gradium API key missing");
 	const { resolveGeneratedMediaMaxBytes } = await import("openclaw/plugin-sdk/media-generation-runtime");
-	return await gradiumTTS({
-		text: req.text,
-		apiKey,
-		baseUrl: config.baseUrl,
-		voiceId: normalizeOptionalString(req.providerOverrides?.voiceId) ?? config.voiceId,
-		outputFormat,
-		timeoutMs: req.timeoutMs,
-		maxBytes: resolveGeneratedMediaMaxBytes(req.cfg, "audio")
+	const text = req.text;
+	const voiceId = normalizeOptionalString(req.providerOverrides?.voiceId) ?? config.voiceId;
+	const timeoutMs = req.timeoutMs;
+	const maxBytes = resolveGeneratedMediaMaxBytes(req.cfg, "audio");
+	const url = `${config.baseUrl}/api/post/speech/tts`;
+	const { assertOkOrThrowProviderError, readProviderBinaryResponse } = await import("openclaw/plugin-sdk/provider-http");
+	const { fetchWithSsrFGuard } = await import("openclaw/plugin-sdk/ssrf-runtime");
+	const { response, release } = await fetchWithSsrFGuard({
+		url,
+		init: {
+			method: "POST",
+			headers: {
+				"x-api-key": apiKey,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify({
+				text,
+				voice_id: voiceId,
+				only_audio: true,
+				output_format: outputFormat,
+				json_config: JSON.stringify({ padding_bonus: 0 })
+			})
+		},
+		timeoutMs,
+		requireHttps: true,
+		policy: { hostnameAllowlist: [GRADIUM_API_HOSTNAME] },
+		auditContext: "gradium.tts"
 	});
+	try {
+		await assertOkOrThrowProviderError(response, "Gradium API error", { requestHeaders: { "x-api-key": apiKey } });
+		return await readProviderBinaryResponse(response, "Gradium API error", "audio", {
+			maxBytes,
+			onOverflow: ({ maxBytes: maxBytesLocal }) => /* @__PURE__ */ new Error(`Gradium TTS audio response exceeds ${maxBytesLocal} bytes`)
+		});
+	} finally {
+		await release();
+	}
 }
 function isGradiumProviderConfigured(config) {
 	if (!resolveGradiumApiKey(config.apiKey)) return false;
@@ -49,22 +120,13 @@ function isGradiumProviderConfigured(config) {
 		return false;
 	}
 }
-function parseDirectiveToken(ctx) {
-	if (![
-		"voice",
-		"voice_id",
-		"voiceid",
-		"gradium_voice",
-		"gradiumvoice"
-	].includes(ctx.key)) return { handled: false };
-	return ctx.policy.allowVoice ? {
-		handled: true,
-		overrides: {
-			...ctx.currentOverrides,
-			voiceId: ctx.value
-		}
-	} : { handled: true };
-}
+const parseDirectiveToken = createSpeechDirectiveParser({ voiceId: ["allowVoice", [
+	"voice",
+	"voice_id",
+	"voiceid",
+	"gradium_voice",
+	"gradiumvoice"
+]] });
 function buildGradiumSpeechProvider() {
 	const isConfigured = ({ providerConfig }) => isGradiumProviderConfigured(providerConfig);
 	return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/gradium-speech",
-  "version": "2026.11.3",
+  "version": "2026.11.5-beta.2",
   "description": "OpenClaw Gradium speech plugin.",
   "repository": {
     "type": "git",
@@ -18,10 +18,10 @@
       "minHostVersion": ">=2026.6.8"
     },
     "compat": {
-      "pluginApi": ">=2026.11.3"
+      "pluginApi": ">=2026.11.5-beta.2"
     },
     "build": {
-      "openclawVersion": "2026.11.3",
+      "openclawVersion": "2026.11.5-beta.2",
       "bundledDist": false
     },
     "release": {
@@ -40,7 +40,7 @@
     "assets/activity.svg"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.11.3"
+    "openclaw": ">=2026.11.5-beta.2"
   },
   "peerDependenciesMeta": {
     "openclaw": {

package/dist/shared.js

@@ -1,48 +0,0 @@
-//#region extensions/gradium/shared.ts
-const DEFAULT_GRADIUM_BASE_URL = "https://api.gradium.ai";
-const GRADIUM_API_HOSTNAME = "api.gradium.ai";
-const DEFAULT_GRADIUM_VOICE_ID = "YTpq7expH9539ERJ";
-const GRADIUM_VOICES = [
-	{
-		id: "YTpq7expH9539ERJ",
-		name: "Emma"
-	},
-	{
-		id: "LFZvm12tW_z0xfGo",
-		name: "Kent"
-	},
-	{
-		id: "Eu9iL_CYe8N-Gkx_",
-		name: "Tiffany"
-	},
-	{
-		id: "2H4HY2CBNyJHBCrP",
-		name: "Christina"
-	},
-	{
-		id: "jtEKaLYNn6iif5PR",
-		name: "Sydney"
-	},
-	{
-		id: "KWJiFWu2O9nMPYcR",
-		name: "John"
-	},
-	{
-		id: "3jUdJyOi9pgbxBTK",
-		name: "Arthur"
-	}
-];
-function normalizeGradiumBaseUrl(baseUrl) {
-	const raw = baseUrl?.trim() || DEFAULT_GRADIUM_BASE_URL;
-	const url = URL.parse(raw);
-	if (!url) throw new Error("Gradium baseUrl must be a valid https URL");
-	url.username = "";
-	url.password = "";
-	url.search = "";
-	url.hash = "";
-	if (url.protocol !== "https:") throw new Error("Gradium baseUrl must use https");
-	if (url.hostname.toLowerCase() !== "api.gradium.ai") throw new Error("Gradium baseUrl must target api.gradium.ai");
-	return url.toString().replace(/\/+$/, "");
-}
-//#endregion
-export { DEFAULT_GRADIUM_VOICE_ID, GRADIUM_API_HOSTNAME, GRADIUM_VOICES, normalizeGradiumBaseUrl };

package/dist/tts.js

@@ -1,41 +0,0 @@
-import { GRADIUM_API_HOSTNAME, normalizeGradiumBaseUrl } from "./shared.js";
-//#region extensions/gradium/tts.ts
-const DEFAULT_TTS_MAX_BYTES = 16777216;
-async function gradiumTTS(params) {
-	const { text, apiKey, baseUrl, voiceId, outputFormat, timeoutMs, maxBytes = DEFAULT_TTS_MAX_BYTES } = params;
-	const url = `${normalizeGradiumBaseUrl(baseUrl)}/api/post/speech/tts`;
-	const { assertOkOrThrowProviderError, readProviderBinaryResponse } = await import("openclaw/plugin-sdk/provider-http");
-	const { fetchWithSsrFGuard } = await import("openclaw/plugin-sdk/ssrf-runtime");
-	const { response, release } = await fetchWithSsrFGuard({
-		url,
-		init: {
-			method: "POST",
-			headers: {
-				"x-api-key": apiKey,
-				"Content-Type": "application/json"
-			},
-			body: JSON.stringify({
-				text,
-				voice_id: voiceId,
-				only_audio: true,
-				output_format: outputFormat,
-				json_config: JSON.stringify({ padding_bonus: 0 })
-			})
-		},
-		timeoutMs,
-		requireHttps: true,
-		policy: { hostnameAllowlist: [GRADIUM_API_HOSTNAME] },
-		auditContext: "gradium.tts"
-	});
-	try {
-		await assertOkOrThrowProviderError(response, "Gradium API error", { requestHeaders: { "x-api-key": apiKey } });
-		return await readProviderBinaryResponse(response, "Gradium API error", "audio", {
-			maxBytes,
-			onOverflow: ({ maxBytes: maxBytesLocal }) => /* @__PURE__ */ new Error(`Gradium TTS audio response exceeds ${maxBytesLocal} bytes`)
-		});
-	} finally {
-		await release();
-	}
-}
-//#endregion
-export { gradiumTTS };