Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

extensions/gradium/speech-provider.ts

@@ -0,0 +1,132 @@
+// Gradium provider module implements model/runtime integration.
+import { normalizeResolvedSecretInputString } from "openclaw/plugin-sdk/secret-input";
+import type {
+  SpeechDirectiveTokenParseContext,
+  SpeechProviderConfig,
+  SpeechProviderPlugin,
+} from "openclaw/plugin-sdk/speech";
+import { asObject, trimToUndefined } from "openclaw/plugin-sdk/speech";
+import { DEFAULT_GRADIUM_VOICE_ID, GRADIUM_VOICES, normalizeGradiumBaseUrl } from "./shared.js";
+import { gradiumTTS } from "./tts.js";
+
+const DEFAULT_GENERATED_AUDIO_MAX_BYTES = 16 * 1024 * 1024;
+
+type GradiumProviderConfig = {
+  apiKey?: string;
+  baseUrl: string;
+  voiceId: string;
+};
+
+function normalizeGradiumProviderConfig(rawConfig: Record<string, unknown>): GradiumProviderConfig {
+  const providers = asObject(rawConfig.providers);
+  const raw = asObject(providers?.gradium) ?? asObject(rawConfig.gradium);
+  return {
+    apiKey: normalizeResolvedSecretInputString({
+      value: raw?.apiKey,
+      path: "messages.tts.providers.gradium.apiKey",
+    }),
+    baseUrl: normalizeGradiumBaseUrl(trimToUndefined(raw?.baseUrl)),
+    voiceId: trimToUndefined(raw?.voiceId) ?? DEFAULT_GRADIUM_VOICE_ID,
+  };
+}
+
+function readGradiumProviderConfig(config: SpeechProviderConfig): GradiumProviderConfig {
+  const defaults = normalizeGradiumProviderConfig({});
+  return {
+    apiKey: trimToUndefined(config.apiKey) ?? defaults.apiKey,
+    baseUrl: normalizeGradiumBaseUrl(trimToUndefined(config.baseUrl) ?? defaults.baseUrl),
+    voiceId: trimToUndefined(config.voiceId) ?? defaults.voiceId,
+  };
+}
+
+function resolveGeneratedAudioMaxBytes(req: {
+  cfg: { agents?: { defaults?: { mediaMaxMb?: number } } };
+}): number {
+  const configured = req.cfg.agents?.defaults?.mediaMaxMb;
+  if (typeof configured === "number" && Number.isFinite(configured) && configured > 0) {
+    return Math.floor(configured * 1024 * 1024);
+  }
+  return DEFAULT_GENERATED_AUDIO_MAX_BYTES;
+}
+
+function parseDirectiveToken(ctx: SpeechDirectiveTokenParseContext): {
+  handled: boolean;
+  overrides?: Record<string, unknown>;
+  warnings?: string[];
+} {
+  switch (ctx.key) {
+    case "voice":
+    case "voice_id":
+    case "voiceid":
+    case "gradium_voice":
+    case "gradiumvoice":
+      if (!ctx.policy.allowVoice) {
+        return { handled: true };
+      }
+      return {
+        handled: true,
+        overrides: { ...ctx.currentOverrides, voiceId: ctx.value },
+      };
+    default:
+      return { handled: false };
+  }
+}
+
+export function buildGradiumSpeechProvider(): SpeechProviderPlugin {
+  return {
+    id: "gradium",
+    label: "Gradium",
+    autoSelectOrder: 30,
+    voices: GRADIUM_VOICES.map((v) => v.id),
+    resolveConfig: ({ rawConfig }) => normalizeGradiumProviderConfig(rawConfig),
+    parseDirectiveToken,
+    listVoices: async () => GRADIUM_VOICES.map((v) => ({ id: v.id, name: v.name })),
+    isConfigured: ({ providerConfig }) =>
+      Boolean(readGradiumProviderConfig(providerConfig).apiKey || process.env.GRADIUM_API_KEY),
+    synthesize: async (req) => {
+      const config = readGradiumProviderConfig(req.providerConfig);
+      const overrides = req.providerOverrides ?? {};
+      const apiKey = config.apiKey || process.env.GRADIUM_API_KEY;
+      if (!apiKey) {
+        throw new Error("Gradium API key missing");
+      }
+      const wantsVoiceNote = req.target === "voice-note";
+      const outputFormat = wantsVoiceNote ? "opus" : "wav";
+      const audioBuffer = await gradiumTTS({
+        text: req.text,
+        apiKey,
+        baseUrl: config.baseUrl,
+        voiceId: trimToUndefined(overrides.voiceId) ?? config.voiceId,
+        outputFormat,
+        timeoutMs: req.timeoutMs,
+        maxBytes: resolveGeneratedAudioMaxBytes(req),
+      });
+      return {
+        audioBuffer,
+        outputFormat,
+        fileExtension: wantsVoiceNote ? ".opus" : ".wav",
+        voiceCompatible: wantsVoiceNote,
+      };
+    },
+    synthesizeTelephony: async (req) => {
+      const config = readGradiumProviderConfig(req.providerConfig);
+      const overrides = req.providerOverrides ?? {};
+      const apiKey = config.apiKey || process.env.GRADIUM_API_KEY;
+      if (!apiKey) {
+        throw new Error("Gradium API key missing");
+      }
+      const outputFormat = "ulaw_8000";
+      const sampleRate = 8_000;
+      const audioBuffer = await gradiumTTS({
+        text: req.text,
+        apiKey,
+        baseUrl: config.baseUrl,
+        voiceId: trimToUndefined(overrides.voiceId) ?? config.voiceId,
+        outputFormat,
+        timeoutMs: req.timeoutMs,
+        maxBytes: resolveGeneratedAudioMaxBytes(req),
+      });
+      return { audioBuffer, outputFormat, sampleRate };
+    },
+  };
+}