dsh-audiogen 0.4.3 → 0.4.5

package/src/client/studio-view.tsx

@@ -101,6 +101,14 @@ function modeLabelOf(mode: AudioMode): string {
   return tt('mode.voiceDesign')
 }
 
+/** 历史时间显示（YYYY-MM-DD HH:mm）。 */
+function formatClock(timestamp: number): string {
+  const date = new Date(timestamp)
+  if (Number.isNaN(date.getTime())) return ''
+  const pad = (n: number): string => String(n).padStart(2, '0')
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`
+}
+
 function useConfig(scope: AudiogenScope) {
   const [value, setValue] = useState(scope.getSnapshot().value)
   useEffect(() => scope.subscribe(() => { setValue(scope.getSnapshot().value) }), [scope])
@@ -222,6 +230,9 @@ export function StudioView(props: {
   const [bitrate, setBitrate] = useState('')
   const [audioChannel, setAudioChannel] = useState('')
   const [subtitle, setSubtitle] = useState(false)
+  // 提示词增强
+  const [enhancing, setEnhancing] = useState(false)
+  const [enhancePreview, setEnhancePreview] = useState<string | null>(null)
   // Stable Audio 参数（仅 Stability 渠道显示）
   const [seed, setSeed] = useState('')
   const [steps, setSteps] = useState('')
@@ -499,6 +510,109 @@ export function StudioView(props: {
     setTasks(current => current.filter(task => task.id !== taskId))
   }
 
+  /** 从历史参数回填表单（参考 AI 生图「恢复」）：配置 + prompt 一键复用。 */
+  const restoreFromParams = (params: Record<string, unknown>, modeValue: AudioMode, singleModel: string, compareModelsRestore?: string[]): void => {
+    const str = (key: string): string | undefined => {
+      const v = params[key]
+      return typeof v === 'string' && v.trim() !== '' ? v.trim() : undefined
+    }
+    const num = (key: string): number | undefined => {
+      const v = params[key]
+      if (typeof v === 'number' && Number.isFinite(v)) return v
+      if (typeof v === 'string' && v.trim() !== '') {
+        const parsed = Number(v)
+        return Number.isFinite(parsed) ? parsed : undefined
+      }
+      return undefined
+    }
+    const bool = (key: string): boolean | undefined => typeof params[key] === 'boolean' ? params[key] as boolean : undefined
+    setMode(modeValue)
+    const modelValue = str('model') ?? singleModel
+    if (modelValue !== '') setModel(modelValue)
+    if (compareModelsRestore !== undefined && compareModelsRestore.length > 0) {
+      setCompareMode(true)
+      setCompareModels(compareModelsRestore)
+    } else {
+      setCompareMode(false)
+    }
+    const voiceValue = str('voice')
+    if (voiceValue !== undefined) setVoice(voiceValue)
+    const speedValue = num('speed')
+    if (speedValue !== undefined) setSpeed(String(speedValue))
+    const durationValue = num('duration')
+    if (durationValue !== undefined) setDuration(String(durationValue))
+    const formatValue = str('format')
+    if (formatValue !== undefined) setFormat(formatValue)
+    const lyricsValue = str('lyrics')
+    if (lyricsValue !== undefined) setLyrics(lyricsValue)
+    const instrumentalValue = bool('isInstrumental')
+    if (instrumentalValue !== undefined) setInstrumental(instrumentalValue)
+    const loopValue = bool('loop')
+    if (loopValue !== undefined) setLoop(loopValue)
+    const influenceValue = num('promptInfluence')
+    if (influenceValue !== undefined) setPromptInfluence(String(influenceValue))
+    const emotionValue = str('emotion')
+    if (emotionValue !== undefined) setEmotion(emotionValue)
+    const volValue = num('vol')
+    if (volValue !== undefined) setVol(String(volValue))
+    const pitchValue = num('pitch')
+    if (pitchValue !== undefined) setPitch(String(pitchValue))
+    if (Array.isArray(params.pronunciationTone)) {
+      setToneText(params.pronunciationTone.filter((item): item is string => typeof item === 'string').join('\n'))
+    }
+    const sampleRateValue = num('sampleRate')
+    if (sampleRateValue !== undefined) setSampleRate(String(sampleRateValue))
+    const bitrateValue = num('bitrate')
+    if (bitrateValue !== undefined) setBitrate(String(bitrateValue))
+    const channelValue = num('audioChannel')
+    if (channelValue !== undefined) setAudioChannel(String(channelValue))
+    const subtitleValue = bool('subtitleEnable')
+    if (subtitleValue !== undefined) setSubtitle(subtitleValue)
+    const seedValue = num('seed')
+    if (seedValue !== undefined) setSeed(String(seedValue))
+    const stepsValue = num('steps')
+    if (stepsValue !== undefined) setSteps(String(stepsValue))
+    const cfgValue = num('cfgScale')
+    if (cfgValue !== undefined) setCfgScale(String(cfgValue))
+    const previewValue = str('previewText')
+    if (previewValue !== undefined) setPreviewText(previewValue)
+    const channelIdValue = str('channelId')
+    if (channelIdValue !== undefined && modeValue === 'voice_design') setDesignChannelId(channelIdValue)
+    props.showToast('已恢复该次生成的配置，可直接再次生成')
+  }
+
+  /** 调用宿主增强（Agent 默认模型），结果先预览再应用。 */
+  const runEnhance = async (): Promise<void> => {
+    if (prompt.trim() === '') {
+      setError('请先输入文本/提示词，再点击增强')
+      return
+    }
+    setEnhancing(true)
+    setError(null)
+    try {
+      const result = await api.enhancePrompt(prompt.trim(), mode)
+      if (result.ok !== true || result.enhanced === undefined) {
+        setError(result.message ?? '增强失败，请稍后重试')
+        return
+      }
+      setEnhancePreview(result.enhanced)
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err))
+    } finally {
+      setEnhancing(false)
+    }
+  }
+
+  /** 删除历史记录（对比任务卡删除该任务的全部模型条目）。 */
+  const deleteHistoryEntries = async (ids: string[]): Promise<void> => {
+    try {
+      for (const id of ids) await api.removeHistory(id)
+    } catch {
+      // best-effort
+    }
+    reload()
+  }
+
   const openSaveDialog = (files: GeneratedAudio[], context: SaveDialogContext): void => {
     setSaveDialog({ files, context })
   }
@@ -767,7 +881,7 @@ export function StudioView(props: {
     <div className={css.studio}>
       <div className={css.formCol}>
         <div className={css.modeRow}>
-          {(['tts', 'music', 'sfx', 'voice_design'] as const).map(item => (
+          {([['tts', '🎙️'], ['music', '🎵'], ['sfx', '🔊'], ['voice_design', '🎨']] as Array<[AudioMode, string]>).map(([item, icon]) => (
             <button
               key={item}
               type="button"
@@ -775,15 +889,35 @@ export function StudioView(props: {
               data-active={mode === item ? 'true' : 'false'}
               onClick={() => setMode(item)}
             >
-              {item === 'tts' ? tt('mode.tts') : item === 'music' ? tt('mode.music') : item === 'sfx' ? tt('mode.sfx') : tt('mode.voiceDesign')}
+              <span className={css.modeIcon}>{icon}</span>
+              {modeLabelOf(item)}
             </button>
           ))}
         </div>
 
+        <div className={css.formSectionRow}>
+          <p className={css.formSection}>输入</p>
+          <button type="button" className={css.ghostButton} disabled={enhancing} onClick={() => void runEnhance()}>
+            {enhancing ? '增强中…' : '✨ 增强提示词'}
+          </button>
+        </div>
         <label className={css.label}>
           <span>{mode === 'voice_design' ? '音色描述' : mode === 'tts' ? '文本' : '提示词'}</span>
           <textarea className={css.textarea} value={prompt} onChange={event => setPrompt(event.target.value)} placeholder={tt('prompt.placeholder')} />
         </label>
+        {enhancePreview !== null ? (
+          <div className={css.enhanceCard}>
+            <div className={css.enhanceCardHead}>
+              <strong>增强结果（{modeLabelOf(mode)}）</strong>
+              <span className={css.enhanceActions}>
+                <button type="button" className={css.ghostButton} onClick={() => { setPrompt(enhancePreview); setEnhancePreview(null); props.showToast('已应用增强结果') }}>应用</button>
+                <button type="button" className={css.ghostButton} disabled={enhancing} onClick={() => void runEnhance()}>重新生成</button>
+                <button type="button" className={css.ghostButton} onClick={() => setEnhancePreview(null)}>放弃</button>
+              </span>
+            </div>
+            <textarea className={css.textarea} value={enhancePreview} readOnly />
+          </div>
+        ) : null}
 
         {mode === 'voice_design' ? (
           <>
@@ -806,6 +940,7 @@ export function StudioView(props: {
           </>
         ) : null}
 
+        <p className={css.formSection}>模型</p>
         {needModel ? (
           <label className={css.checkbox} title="选择多个模型，用相同参数逐个生成，便于对比效果">
             <input type="checkbox" checked={compareMode} onChange={event => setCompareMode(event.target.checked)} />
@@ -902,7 +1037,14 @@ export function StudioView(props: {
           )
         ) : null}
 
-        {globalSpecs.filter(spec => spec.advanced !== true).map(spec => renderField(spec))}
+        {globalSpecs.some(spec => spec.advanced !== true) ? <p className={css.formSection}>生成参数</p> : null}
+        <div className={css.formFields}>
+          {globalSpecs.filter(spec => spec.advanced !== true).map(spec => (
+            <div key={spec.key} className={spec.key === 'lyrics' || spec.key === 'toneText' ? css.fieldFull : css.fieldCell}>
+              {renderField(spec)}
+            </div>
+          ))}
+        </div>
 
         {mode === 'tts' && globalSpecs.some(spec => spec.advanced === true) ? (
           <details className={css.advanced}>
@@ -935,6 +1077,15 @@ export function StudioView(props: {
             <span className={css.resultEmptyIcon}>🎵</span>
             <p>{tt('result.empty')}</p>
             <p className={css.resultEmptyHint}>点击「开始生成」即创建一个任务，可同时进行多个；勾选「模型对比」用多个模型同参数生成对比</p>
+            <button type="button" className={css.ghostButton} onClick={() => {
+              const examples: Record<AudioMode, string> = {
+                tts: '今天是不是很开心呀(laughs)，当然了！我们一起去公园散步吧。',
+                music: 'Cinematic orchestral piece with a clear "before/after" transition at 1:00, starting minimalist piano + strings, then full orchestra entrance with timpani and brass at the 1-minute mark.',
+                sfx: '科技感 UI 提示音：清脆短促，带轻微回声与空气感。',
+                voice_design: '讲述悬疑故事的播音员，声音低沉富有磁性，语速时快时慢，营造紧张神秘的氛围。',
+              }
+              setPrompt(examples[mode] ?? '')
+            }}>填入示例 prompt</button>
           </div>
         ) : (
           <div className={css.taskList}>
@@ -955,6 +1106,9 @@ export function StudioView(props: {
                     <span className={css.resultModeChip}>{task.mode}</span>
                     <span className={css.taskLabel} title={task.prompt}>{task.label}</span>
                     <span className={css.taskStatus} data-state={task.status}>{statusText}</span>
+                    {task.status === 'running' ? (
+                      <span className={css.taskBar}><i style={{ width: `${task.progress.total > 0 ? Math.round((task.progress.done / task.progress.total) * 100) : 0}%` }} /></span>
+                    ) : null}
                     <span className={css.taskActions}>
                       {task.status === 'running' ? (
                         <button type="button" className={css.ghostButton} onClick={() => cancelTask(task.id)}>取消</button>
@@ -1023,6 +1177,7 @@ export function StudioView(props: {
                       <summary className={css.historyCompareSummary}>
                         <span className={css.historyPrompt}>{item.prompt}</span>
                         <span className={css.historyCompareBadge}>对比 · {item.models.length} 个模型</span>
+                        <span className={css.historyTime}>{formatClock(item.createdAt)}</span>
                       </summary>
                       <div className={css.historyMeta}>{modeLabelOf(item.mode)} · {item.models.map(model => model.model).join(' / ')}</div>
                       {item.models.map(model => (
@@ -1040,6 +1195,15 @@ export function StudioView(props: {
                           </div>
                         </div>
                       ))}
+                      <div className={css.historyActions}>
+                        <button type="button" className={css.historyIcon} title="恢复（回填配置与全部模型）" onClick={() => restoreFromParams(
+                          (item.models[0]?.entry.params ?? {}) as Record<string, unknown>,
+                          item.mode,
+                          item.models[0]?.model ?? '',
+                          item.models.map(model => model.model),
+                        )}>↺</button>
+                        <button type="button" className={css.historyIcon} title="删除整个对比任务" onClick={() => void deleteHistoryEntries(item.models.map(model => model.entry.id))}>✕</button>
+                      </div>
                     </details>
                   )
                 }
@@ -1048,12 +1212,19 @@ export function StudioView(props: {
                   <div className={css.historyItem} key={item.key}>
                     <div className={css.historyPrompt}>{entry.prompt}</div>
                     <div className={css.historyMeta}>{modeLabelOf(entry.mode)} · {entry.model}{entry.channel ? ` · ${entry.channel}` : ''}</div>
+                    <div className={css.historyTime}>{formatClock(entry.createdAt)}</div>
                     {entry.audio.map((audio, index) => (
                       <AudioPlayer key={index} src={audio.url} compact itemKey={`${entry.id}-${index}`} />
                     ))}
                     <div className={css.historyActions}>
-                      <button type="button" className={css.historyAction} onClick={() => openSaveDialog(audioRefsOfEntry(entry), contextOfEntry(entry))}>
-                        <StarIcon /> 入库
+                      <button type="button" className={css.historyIcon} title="恢复（回填配置与 prompt）" onClick={() => restoreFromParams(
+                        (entry.params ?? {}) as Record<string, unknown>,
+                        entry.mode,
+                        entry.model,
+                      )}>↺</button>
+                      <button type="button" className={css.historyIcon} title="删除这条记录" onClick={() => void deleteHistoryEntries([entry.id])}>✕</button>
+                      <button type="button" className={css.historyIcon} title="加入资源库" onClick={() => openSaveDialog(audioRefsOfEntry(entry), contextOfEntry(entry))}>
+                        <StarIcon />
                       </button>
                     </div>
                   </div>

package/src/index.ts

@@ -16,8 +16,10 @@ import z from 'schemastery'
 import type {} from '@deepseek-ai/dsh-host-webserver'
 import type {} from '@deepseek-ai/dsh-system-prompt'
 import type {} from '@deepseek-ai/dsh-tools'
-import { AUDIOGEN_SETTINGS_NAMESPACE, type ChannelConfig, type ModelMapping } from './protocol.ts'
+import { AUDIOGEN_SETTINGS_NAMESPACE, type AudioMode, type ChannelConfig, type ModelMapping } from './protocol.ts'
 import { createGenerationBudget } from './audio-scheduler.ts'
+import { enhancePromptText } from './prompt-enhance.ts'
+import { AudioGenError } from './audio-engine.ts'
 import { makeRoutes, type ChannelsView, type SettingsSeam } from './routes.ts'
 import type { AudioChannel } from './audio-engine.ts'
 import { registerAgentAudioTools, type AgentAudioToolConfig } from './agent-audio-tools.ts'
@@ -196,6 +198,13 @@ export function apply(ctx: Context, config?: Config): void {
   // 全局并发闸门：所有上游调用（面板路由 + Agent 工具）共享「最大并发生成数」。
   const budget = createGenerationBudget(() => resolve().maxConcurrentGenerations)
 
+  // 提示词增强：复用 Agent 默认模型（agent-default-model 设置），面板与 Agent 工具共用。
+  const enhance = async (prompt: string, mode: AudioMode): Promise<string> => {
+    const seam = ctx.get('settings') as unknown as SettingsSeam
+    if (seam?.describe === undefined) throw new AudioGenError('设置服务不可用，无法增强提示词', 'settings-unavailable')
+    return enhancePromptText({ settings: seam, llm: () => ctx.get('llm') }, prompt, mode)
+  }
+
   const channelsView = (): ChannelsView => {
     const value = resolve()
     return { channels: value.channels, defaultChannelId: value.defaultChannelId }
@@ -209,6 +218,7 @@ export function apply(ctx: Context, config?: Config): void {
         resolveChannels: channelsView,
         autoSave: () => resolve().autoSaveToLibrary,
         budget,
+        enhance,
       })
       const disposers = routes.map(route => ctx.webServer.register(route))
       return () => { for (const dispose of disposers) dispose() }
@@ -225,6 +235,7 @@ export function apply(ctx: Context, config?: Config): void {
         defaultChannelId: value.defaultChannelId,
         autoSaveToLibrary: value.autoSaveToLibrary,
         budget,
+        enhance,
       }
     }), 'dsh-audiogen: agent audio tools')
   })

package/src/prompt-enhance.ts

@@ -0,0 +1,72 @@
+/**
+ * 提示词增强：复用 Agent 当前默认模型（设置「模型」里的 provider/model，
+ * 即 agent-default-model 命名空间），宿主端发起一次 LLM 调用把用户 prompt
+ * 扩展成更适合生成的任务描述。不新增 API key 配置。
+ *
+ * 面板「✨ 增强提示词」与 generate_audio 工具的 enhance_prompt 都走这里。
+ */
+
+import type { AudioMode } from './protocol.ts'
+import { AudioGenError } from './audio-engine.ts'
+
+/** 按生成模式给出增强指令（系统提示）。 */
+function instructionsFor(mode: AudioMode): string {
+  const common = [
+    '你是一个音频提示词增强助手。用户给出一个粗略的音频生成需求，',
+    '请将其扩写为一段可直接提交给音频生成模型的中文或英文描述。',
+    '只输出增强后的描述本身，不要输出任何解释、前后缀、引号或代码块。',
+    '保持用户原始意图，不要改变其核心内容；为最终生成的音频服务。',
+    '描述控制在 200-600 字左右。',
+  ].join('')
+  const perMode: Record<AudioMode, string> = {
+    tts: '这是文本转语音（TTS）任务：让文本更适合朗读——口语化、自然、带合适的情感标签（如 (laughs)、(whisper)），避免生僻多音字和超长句，可适当补足上下文使语句完整，但不要改写原意。',
+    music: '这是音乐生成任务：扩写音乐风格/情绪/乐器/结构/节奏变化/氛围，使用音频模型熟悉的描述词汇（如 cinematic orchestral、lo-fi、bpm、弦乐进出、旋律动机、前中后段结构），如用户未指定可补充风格建议，但保持原方向。',
+    sfx: '这是音效生成任务：扩写声音材质、动作过程、空间感、节奏（先轻后重、清脆短促等）、环境氛围，用具体拟声与材质词，避免抽象概括。',
+    voice_design: '这是音色设计任务：扩写人声/音色特征——性别年龄、音域、音质（低沉/清亮/沙哑）、语速、情绪性格、适用场景，用可感知的描述，方便语音模型合成。',
+  }
+  return common + perMode[mode]
+}
+
+export interface PromptEnhanceDeps {
+  /** DSH 设置 seam（读 agent-default-model）。 */
+  settings: { describe(options?: { redactSecrets?: boolean }): Array<{ ns: unknown; value?: unknown }> }
+  /** 宿主 LLM 运行时访问器（延迟读取，调用时才获取）。 */
+  llm?: () => unknown
+}
+
+/** 读取 Agent 默认模型并调用 LLM 增强，返回增强后的文本。 */
+export async function enhancePromptText(deps: PromptEnhanceDeps, prompt: string, mode: AudioMode): Promise<string> {
+  const text = prompt.trim()
+  if (text === '') throw new AudioGenError('提示词为空，无法增强', 'enhance-empty-prompt')
+  const descriptor = (deps.settings.describe({ redactSecrets: true }) ?? []).find(candidate => String(candidate.ns) === 'agent-default-model')
+  const value = (descriptor?.value ?? {}) as { provider?: unknown; model?: unknown }
+  const provider = typeof value.provider === 'string' && value.provider.trim() !== '' ? value.provider.trim() : ''
+  const model = typeof value.model === 'string' && value.model.trim() !== '' ? value.model.trim() : ''
+  if (provider === '' || model === '') {
+    throw new AudioGenError('未找到 Agent 默认模型（agent-default-model）：请先在「设置 → 模型」中配置默认模型', 'no-default-model')
+  }
+  const runtime = deps.llm?.() as { stream?: (options: unknown) => AsyncIterable<unknown> } | undefined
+  if (runtime === undefined || runtime.stream === undefined) {
+    throw new AudioGenError('宿主 LLM 服务不可用（ctx.llm 未注册）', 'llm-unavailable')
+  }
+  let output = ''
+  for await (const chunk of runtime.stream({
+    provider,
+    model,
+    messages: [{ role: 'user', content: text }],
+    system: instructionsFor(mode),
+    temperature: 0.7,
+    maxTokens: 1200,
+  })) {
+    const record = chunk as { type?: string; text?: string }
+    if (record.type === 'text-delta' && typeof record.text === 'string') output += record.text
+  }
+  return stripFences(output.trim())
+}
+
+/** 去掉模型可能包裹的 ``` 代码围栏。 */
+function stripFences(value: string): string {
+  if (value === '') return value
+  const withoutFence = value.replace(/^```[a-zA-Z]*\s*\n?/, '').replace(/\n?```\s*$/, '')
+  return withoutFence.trim()
+}

package/src/protocol.ts

@@ -8,7 +8,7 @@
 export const AUDIOGEN_SETTINGS_NAMESPACE = 'dsh-audiogen'
 
 /** Published package version shared by the host updater and the client UI. */
-export const PLUGIN_VERSION = '0.4.3'
+export const PLUGIN_VERSION = '0.4.5'
 
 /** Same-origin route family (loopback-only, mirroring dsh-imagegen). */
 export const SETTINGS_API = {
@@ -24,6 +24,9 @@ export const TASK_API = {
   cancel: '/api/dsh-audiogen/task/cancel',
 } as const
 
+/** Loopback-only prompt enhancement route (uses the agent's default model). */
+export const ENHANCE_API = '/api/dsh-audiogen/prompt/enhance' as const
+
 /** Host-mediated built-in provider catalog (channels the user can instantiate). */
 export const PRESETS_API = '/api/dsh-audiogen/presets' as const
 

package/src/routes.ts

@@ -16,7 +16,7 @@ import { discoverAudioModels } from './audio-models.ts'
 import { AUDIO_PRESETS } from './audio-presets.ts'
 import { appendHistory, clearHistory, listHistory, readAudioFile, removeHistory, saveAudioFile, listLibrary, saveToLibrary, updateLibraryEntry, removeLibraryEntries, readLibraryFile } from './audio-store.ts'
 import {
-  AUDIO_API, AUDIOGEN_SETTINGS_NAMESPACE, GENERATE_API, HISTORY_API, LIBRARY_API, MODEL_API, PRESETS_API, SETTINGS_API, TASK_API,
+  AUDIO_API, AUDIOGEN_SETTINGS_NAMESPACE, ENHANCE_API, GENERATE_API, HISTORY_API, LIBRARY_API, MODEL_API, PRESETS_API, SETTINGS_API, TASK_API,
   LIBRARY_TYPES,
   type GenerateAudioRequest, type GeneratedAudio, type HistoryEntryInput, type LibraryAudioInput, type LibraryProvenance, type LibraryType,
 } from './protocol.ts'
@@ -47,6 +47,8 @@ export interface AudiogenRoutesDeps {
   autoSave: () => boolean
   /** Global upstream concurrency gate (maxConcurrentGenerations). */
   budget: GenerationBudget
+  /** 提示词增强：调用 Agent 默认模型，返回增强后的文本。 */
+  enhance: (prompt: string, mode: GenerateAudioRequest['mode']) => Promise<string>
 }
 
 function isLoopbackRequest(request: IncomingMessage): boolean {
@@ -528,6 +530,27 @@ export function makeRoutes(deps: AudiogenRoutesDeps): WebRoute[] {
         writeJson(res, 200, { ok: true, aborted: controllers !== undefined ? controllers.size : 0 })
       },
     },
+    // ------------------------------------------------------- prompt enhance
+    {
+      kind: 'exact',
+      path: ENHANCE_API,
+      handler: async (req, res) => {
+        if (!guard(req, res, 'POST')) return
+        const body = await readJsonBody(req)
+        const prompt = typeof body?.prompt === 'string' ? body.prompt.trim() : ''
+        if (prompt === '') {
+          writeJson(res, 200, { ok: false, code: 'bad-request', message: 'prompt is required' })
+          return
+        }
+        const mode = body?.mode === 'music' ? 'music' : body?.mode === 'sfx' ? 'sfx' : body?.mode === 'voice_design' ? 'voice_design' : 'tts'
+        try {
+          const enhanced = await deps.enhance(prompt, mode)
+          writeJson(res, 200, { ok: true, enhanced })
+        } catch (error) {
+          writeJson(res, 200, { ok: false, code: 'enhance-failed', message: messageOf(error) })
+        }
+      },
+    },
     // ----------------------------------------------------------- audio file
     {
       kind: 'prefix',