@xopcai/xopc 0.0.87 → 0.0.89

package/dist/src/share/site-share-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"site-share-config.js","names":[],"sources":["../../../src/share/site-share-config.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport type { Config } from '../config/schema.js';\nimport type { GatewayService } from '../gateway/service.js';\nimport {\n  SITE_SHARE_CONFIG_DEFAULTS,\n  type SiteShareConfig,\n} from './site-share-types.js';\n\nconst SiteShareStaticPatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  maxRootDirSize: z.number().int().min(1_048_576).max(10_737_418_240).optional(),\n  maxFileCount: z.number().int().min(1).max(100_000).optional(),\n  rewriteEnabledByDefault: z.boolean().optional(),\n});\n\nconst SiteShareProxyPatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  allowedUpstreamHosts: z.array(z.string().min(1)).optional(),\n  allowedUpstreamPorts: z.array(z.number().int().min(1).max(65535)).optional(),\n  forwardWebSocket: z.boolean().optional(),\n  bodySizeLimit: z.number().int().min(0).max(1_073_741_824).optional(),\n  requestTimeoutMs: z.number().int().min(1_000).max(600_000).optional(),\n  wsIdleTimeoutMs: z.number().int().min(10_000).max(3_600_000).optional(),\n  rewriteSetCookiePath: z.boolean().optional(),\n});\n\nconst SiteSharePatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  publicHostSuffix: z.string().min(1).optional(),\n  defaultTtlMs: z.number().int().min(60_000).max(604_800_000).optional(),\n  maxTtlMs: z.number().int().min(60_000).max(2_592_000_000).optional(),\n  maxActiveSites: z.number().int().min(1).max(1_000).optional(),\n  static: SiteShareStaticPatchSchema.optional(),\n  proxy: SiteShareProxyPatchSchema.optional(),\n});\n\nexport function resolveSiteShareConfig(service: GatewayService): SiteShareConfig {\n  const raw = (service.currentConfig.gateway as Record<string, unknown> | undefined)?.siteShare;\n  return mergeWithDefaults(raw);\n}\n\nexport function mergeWithDefaults(raw: unknown): SiteShareConfig {\n  const base = SITE_SHARE_CONFIG_DEFAULTS;\n  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {\n    return JSON.parse(JSON.stringify(base)) as SiteShareConfig;\n  }\n  const r = raw as Partial<SiteShareConfig> & {\n    static?: Partial<SiteShareConfig['static']>;\n    proxy?: Partial<SiteShareConfig['proxy']>;\n  };\n  return {\n    enabled: r.enabled ?? base.enabled,\n    publicHostSuffix: r.publicHostSuffix ?? base.publicHostSuffix,\n    defaultTtlMs: r.defaultTtlMs ?? base.defaultTtlMs,\n    maxTtlMs: r.maxTtlMs ?? base.maxTtlMs,\n    maxActiveSites: r.maxActiveSites ?? base.maxActiveSites,\n    static: {\n      enabled: r.static?.enabled ?? base.static.enabled,\n      maxRootDirSize: r.static?.maxRootDirSize ?? base.static.maxRootDirSize,\n      maxFileCount: r.static?.maxFileCount ?? base.static.maxFileCount,\n      rewriteEnabledByDefault: r.static?.rewriteEnabledByDefault ?? base.static.rewriteEnabledByDefault,\n    },\n    proxy: {\n      enabled: r.proxy?.enabled ?? base.proxy.enabled,\n      allowedUpstreamHosts: r.proxy?.allowedUpstreamHosts ?? [...base.proxy.allowedUpstreamHosts],\n      allowedUpstreamPorts: r.proxy?.allowedUpstreamPorts ?? [...base.proxy.allowedUpstreamPorts],\n      forwardWebSocket: r.proxy?.forwardWebSocket ?? base.proxy.forwardWebSocket,\n      bodySizeLimit: r.proxy?.bodySizeLimit ?? base.proxy.bodySizeLimit,\n      requestTimeoutMs: r.proxy?.requestTimeoutMs ?? base.proxy.requestTimeoutMs,\n      wsIdleTimeoutMs: r.proxy?.wsIdleTimeoutMs ?? base.proxy.wsIdleTimeoutMs,\n      rewriteSetCookiePath: r.proxy?.rewriteSetCookiePath ?? base.proxy.rewriteSetCookiePath,\n    },\n  };\n}\n\nexport function mergeSiteShareConfigPatch(\n  config: Config,\n  patch: Record<string, unknown>,\n): { ok: true } | { ok: false; message: string } {\n  const parsed = SiteSharePatchSchema.safeParse(patch);\n  if (!parsed.success) {\n    return { ok: false, message: parsed.error.issues.map((i) => i.message).join('; ') };\n  }\n  if (!config.gateway) {\n    config.gateway = {\n      bind: 'loopback',\n      port: 18790,\n      auth: { mode: 'token' },\n      heartbeat: { enabled: true, intervalMs: 1_800_000, includeSystemPromptSection: false },\n      maxSseConnections: 100,\n      corsOrigins: [],\n    };\n  }\n\n  const cfg = config.gateway as Record<string, unknown>;\n  const current = mergeWithDefaults(cfg.siteShare);\n  const next: SiteShareConfig = {\n    ...current,\n    ...parsed.data,\n    static: parsed.data.static ? { ...current.static, ...parsed.data.static } : current.static,\n    proxy: parsed.data.proxy ? { ...current.proxy, ...parsed.data.proxy } : current.proxy,\n  };\n  if (next.defaultTtlMs > next.maxTtlMs) {\n    return { ok: false, message: 'siteShare.defaultTtlMs must not exceed siteShare.maxTtlMs' };\n  }\n  cfg.siteShare = next as unknown as Record<string, unknown>;\n  return { ok: true };\n}\n"],"mappings":"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"}
+{"version":3,"file":"site-share-config.js","names":[],"sources":["../../../src/share/site-share-config.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport type { Config } from '../config/schema.js';\nimport {\n  SITE_SHARE_CONFIG_DEFAULTS,\n  type SiteShareConfig,\n} from './site-share-types.js';\n\nconst SiteShareStaticPatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  maxRootDirSize: z.number().int().min(1_048_576).max(10_737_418_240).optional(),\n  maxFileCount: z.number().int().min(1).max(100_000).optional(),\n  rewriteEnabledByDefault: z.boolean().optional(),\n});\n\nconst SiteShareProxyPatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  allowedUpstreamHosts: z.array(z.string().min(1)).optional(),\n  allowedUpstreamPorts: z.array(z.number().int().min(1).max(65535)).optional(),\n  forwardWebSocket: z.boolean().optional(),\n  bodySizeLimit: z.number().int().min(0).max(1_073_741_824).optional(),\n  requestTimeoutMs: z.number().int().min(1_000).max(600_000).optional(),\n  wsIdleTimeoutMs: z.number().int().min(10_000).max(3_600_000).optional(),\n  rewriteSetCookiePath: z.boolean().optional(),\n});\n\nconst SiteSharePatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  publicHostSuffix: z.string().min(1).optional(),\n  defaultTtlMs: z.number().int().min(60_000).max(604_800_000).optional(),\n  maxTtlMs: z.number().int().min(60_000).max(2_592_000_000).optional(),\n  maxActiveSites: z.number().int().min(1).max(1_000).optional(),\n  static: SiteShareStaticPatchSchema.optional(),\n  proxy: SiteShareProxyPatchSchema.optional(),\n});\n\nexport function resolveSiteShareConfig(service: { currentConfig: Config }): SiteShareConfig {\n  const raw = (service.currentConfig.gateway as Record<string, unknown> | undefined)?.siteShare;\n  return mergeWithDefaults(raw);\n}\n\nexport function mergeWithDefaults(raw: unknown): SiteShareConfig {\n  const base = SITE_SHARE_CONFIG_DEFAULTS;\n  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {\n    return JSON.parse(JSON.stringify(base)) as SiteShareConfig;\n  }\n  const r = raw as Partial<SiteShareConfig> & {\n    static?: Partial<SiteShareConfig['static']>;\n    proxy?: Partial<SiteShareConfig['proxy']>;\n  };\n  return {\n    enabled: r.enabled ?? base.enabled,\n    publicHostSuffix: r.publicHostSuffix ?? base.publicHostSuffix,\n    defaultTtlMs: r.defaultTtlMs ?? base.defaultTtlMs,\n    maxTtlMs: r.maxTtlMs ?? base.maxTtlMs,\n    maxActiveSites: r.maxActiveSites ?? base.maxActiveSites,\n    static: {\n      enabled: r.static?.enabled ?? base.static.enabled,\n      maxRootDirSize: r.static?.maxRootDirSize ?? base.static.maxRootDirSize,\n      maxFileCount: r.static?.maxFileCount ?? base.static.maxFileCount,\n      rewriteEnabledByDefault: r.static?.rewriteEnabledByDefault ?? base.static.rewriteEnabledByDefault,\n    },\n    proxy: {\n      enabled: r.proxy?.enabled ?? base.proxy.enabled,\n      allowedUpstreamHosts: r.proxy?.allowedUpstreamHosts ?? [...base.proxy.allowedUpstreamHosts],\n      allowedUpstreamPorts: r.proxy?.allowedUpstreamPorts ?? [...base.proxy.allowedUpstreamPorts],\n      forwardWebSocket: r.proxy?.forwardWebSocket ?? base.proxy.forwardWebSocket,\n      bodySizeLimit: r.proxy?.bodySizeLimit ?? base.proxy.bodySizeLimit,\n      requestTimeoutMs: r.proxy?.requestTimeoutMs ?? base.proxy.requestTimeoutMs,\n      wsIdleTimeoutMs: r.proxy?.wsIdleTimeoutMs ?? base.proxy.wsIdleTimeoutMs,\n      rewriteSetCookiePath: r.proxy?.rewriteSetCookiePath ?? base.proxy.rewriteSetCookiePath,\n    },\n  };\n}\n\nexport function mergeSiteShareConfigPatch(\n  config: Config,\n  patch: Record<string, unknown>,\n): { ok: true } | { ok: false; message: string } {\n  const parsed = SiteSharePatchSchema.safeParse(patch);\n  if (!parsed.success) {\n    return { ok: false, message: parsed.error.issues.map((i) => i.message).join('; ') };\n  }\n  if (!config.gateway) {\n    config.gateway = {\n      bind: 'loopback',\n      port: 18790,\n      auth: { mode: 'token' },\n      heartbeat: { enabled: true, intervalMs: 1_800_000, includeSystemPromptSection: false },\n      maxSseConnections: 100,\n      corsOrigins: [],\n    };\n  }\n\n  const cfg = config.gateway as Record<string, unknown>;\n  const current = mergeWithDefaults(cfg.siteShare);\n  const next: SiteShareConfig = {\n    ...current,\n    ...parsed.data,\n    static: parsed.data.static ? { ...current.static, ...parsed.data.static } : current.static,\n    proxy: parsed.data.proxy ? { ...current.proxy, ...parsed.data.proxy } : current.proxy,\n  };\n  if (next.defaultTtlMs > next.maxTtlMs) {\n    return { ok: false, message: 'siteShare.defaultTtlMs must not exceed siteShare.maxTtlMs' };\n  }\n  cfg.siteShare = next as unknown as Record<string, unknown>;\n  return { ok: true };\n}\n"],"mappings":";;;AAQA,MAAM,6BAA6B,EAAE,OAAO;CAC1C,SAAS,EAAE,SAAS,CAAC,UAAU;CAC/B,gBAAgB,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAU,CAAC,IAAI,YAAe,CAAC,UAAU;CAC9E,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAQ,CAAC,UAAU;CAC7D,yBAAyB,EAAE,SAAS,CAAC,UAAU;CAChD,CAAC;AAEF,MAAM,4BAA4B,EAAE,OAAO;CACzC,SAAS,EAAE,SAAS,CAAC,UAAU;CAC/B,sBAAsB,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU;CAC3D,sBAAsB,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,UAAU;CAC5E,kBAAkB,EAAE,SAAS,CAAC,UAAU;CACxC,eAAe,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,WAAc,CAAC,UAAU;CACpE,kBAAkB,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAM,CAAC,IAAI,IAAQ,CAAC,UAAU;CACrE,iBAAiB,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAO,CAAC,IAAI,KAAU,CAAC,UAAU;CACvE,sBAAsB,EAAE,SAAS,CAAC,UAAU;CAC7C,CAAC;AAEF,MAAM,uBAAuB,EAAE,OAAO;CACpC,SAAS,EAAE,SAAS,CAAC,UAAU;CAC/B,kBAAkB,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU;CAC9C,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAO,CAAC,IAAI,OAAY,CAAC,UAAU;CACtE,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAO,CAAC,IAAI,OAAc,CAAC,UAAU;CACpE,gBAAgB,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAM,CAAC,UAAU;CAC7D,QAAQ,2BAA2B,UAAU;CAC7C,OAAO,0BAA0B,UAAU;CAC5C,CAAC;AAEF,SAAgB,uBAAuB,SAAqD;CAC1F,MAAM,MAAO,QAAQ,cAAc,SAAiD;AACpF,QAAO,kBAAkB,IAAI;;AAG/B,SAAgB,kBAAkB,KAA+B;CAC/D,MAAM,OAAO;AACb,KAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,IAAI,CACvD,QAAO,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC;CAEzC,MAAM,IAAI;AAIV,QAAO;EACL,SAAS,EAAE,WAAW,KAAK;EAC3B,kBAAkB,EAAE,oBAAoB,KAAK;EAC7C,cAAc,EAAE,gBAAgB,KAAK;EACrC,UAAU,EAAE,YAAY,KAAK;EAC7B,gBAAgB,EAAE,kBAAkB,KAAK;EACzC,QAAQ;GACN,SAAS,EAAE,QAAQ,WAAW,KAAK,OAAO;GAC1C,gBAAgB,EAAE,QAAQ,kBAAkB,KAAK,OAAO;GACxD,cAAc,EAAE,QAAQ,gBAAgB,KAAK,OAAO;GACpD,yBAAyB,EAAE,QAAQ,2BAA2B,KAAK,OAAO;GAC3E;EACD,OAAO;GACL,SAAS,EAAE,OAAO,WAAW,KAAK,MAAM;GACxC,sBAAsB,EAAE,OAAO,wBAAwB,CAAC,GAAG,KAAK,MAAM,qBAAqB;GAC3F,sBAAsB,EAAE,OAAO,wBAAwB,CAAC,GAAG,KAAK,MAAM,qBAAqB;GAC3F,kBAAkB,EAAE,OAAO,oBAAoB,KAAK,MAAM;GAC1D,eAAe,EAAE,OAAO,iBAAiB,KAAK,MAAM;GACpD,kBAAkB,EAAE,OAAO,oBAAoB,KAAK,MAAM;GAC1D,iBAAiB,EAAE,OAAO,mBAAmB,KAAK,MAAM;GACxD,sBAAsB,EAAE,OAAO,wBAAwB,KAAK,MAAM;GACnE;EACF;;AAGH,SAAgB,0BACd,QACA,OAC+C;CAC/C,MAAM,SAAS,qBAAqB,UAAU,MAAM;AACpD,KAAI,CAAC,OAAO,QACV,QAAO;EAAE,IAAI;EAAO,SAAS,OAAO,MAAM,OAAO,KAAK,MAAM,EAAE,QAAQ,CAAC,KAAK,KAAK;EAAE;AAErF,KAAI,CAAC,OAAO,QACV,QAAO,UAAU;EACf,MAAM;EACN,MAAM;EACN,MAAM,EAAE,MAAM,SAAS;EACvB,WAAW;GAAE,SAAS;GAAM,YAAY;GAAW,4BAA4B;GAAO;EACtF,mBAAmB;EACnB,aAAa,EAAE;EAChB;CAGH,MAAM,MAAM,OAAO;CACnB,MAAM,UAAU,kBAAkB,IAAI,UAAU;CAChD,MAAM,OAAwB;EAC5B,GAAG;EACH,GAAG,OAAO;EACV,QAAQ,OAAO,KAAK,SAAS;GAAE,GAAG,QAAQ;GAAQ,GAAG,OAAO,KAAK;GAAQ,GAAG,QAAQ;EACpF,OAAO,OAAO,KAAK,QAAQ;GAAE,GAAG,QAAQ;GAAO,GAAG,OAAO,KAAK;GAAO,GAAG,QAAQ;EACjF;AACD,KAAI,KAAK,eAAe,KAAK,SAC3B,QAAO;EAAE,IAAI;EAAO,SAAS;EAA6D;AAE5F,KAAI,YAAY;AAChB,QAAO,EAAE,IAAI,MAAM"}

package/dist/src/tui/tui-agent-events.js

@@ -1,3 +1,4 @@
+import { formatAgentRunErrorForDisplay } from "../agent/client-error-format.js";
 //#region src/tui/tui-agent-events.ts
 const pendingToolCallIds = /* @__PURE__ */ new Map();
 function clearPendingToolCallIds() {
@@ -73,7 +74,7 @@ function dispatchAgentSSE(event, data, state, chatLog, assembler, tui, setActivi
 			break;
 		}
 		case "error": {
-			const errorContent = String(data.content ?? "Unknown error");
+			const errorContent = formatAgentRunErrorForDisplay(String(data.content ?? "Unknown error"));
 			const finalText = assembler.finalize(runId, state.showThinking);
 			if (finalText) chatLog.finalizeAssistant(finalText, runId);
 			chatLog.addSystem(`❌ ${errorContent}`);

package/dist/src/tui/tui-agent-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"tui-agent-events.js","names":[],"sources":["../../../src/tui/tui-agent-events.ts"],"sourcesContent":["import type { TUI } from '@earendil-works/pi-tui';\n\nimport type { ChatLog } from './components/chat-log.js';\nimport type { StreamAssembler } from './stream-assembler.js';\nimport type { TuiState } from './tui-types.js';\n\nconst pendingToolCallIds = new Map<string, string[]>();\n\nexport function clearPendingToolCallIds(): void {\n  pendingToolCallIds.clear();\n}\n\nconst STREAM_TOUCH_EVENTS = new Set([\n  'status',\n  'token',\n  'thinking',\n  'tool_start',\n  'tool_end',\n  'progress',\n]);\n\nexport function dispatchAgentSSE(\n  event: string,\n  data: Record<string, unknown>,\n  state: TuiState,\n  chatLog: ChatLog,\n  assembler: StreamAssembler,\n  tui: TUI,\n  setActivityStatus: (status: string) => void,\n  touchStreamingActivity?: () => void,\n  /** Called when a run ends (result/error) so the TUI can flush follow-up queue, etc. */\n  onRunEnded?: () => void,\n): void {\n  if (STREAM_TOUCH_EVENTS.has(event)) {\n    touchStreamingActivity?.();\n  }\n\n  const runId = state.activeRunId ?? 'default';\n\n  switch (event) {\n    case 'status': {\n      const newRunId = typeof data.runId === 'string' ? data.runId : runId;\n      state.activeRunId = newRunId;\n      setActivityStatus('waiting');\n      break;\n    }\n    case 'token': {\n      const content =\n        typeof data.content === 'string'\n          ? data.content\n          : typeof data.delta === 'string'\n            ? data.delta\n            : typeof data.text === 'string'\n              ? data.text\n              : '';\n      if (!content) break;\n      setActivityStatus('streaming');\n      const display = assembler.ingestToken(runId, content, state.showThinking);\n      if (display !== null) {\n        chatLog.updateAssistant(display, runId);\n        tui.requestRender();\n      }\n      break;\n    }\n    case 'thinking': {\n      const thinkContent = String(data.content ?? '');\n      const isDelta = Boolean(data.delta);\n      if (data.status === 'started') break;\n      setActivityStatus('streaming');\n      const display = assembler.ingestThinking(runId, thinkContent, isDelta, state.showThinking);\n      if (display !== null) {\n        chatLog.updateAssistant(display, runId);\n        tui.requestRender();\n      }\n      break;\n    }\n    case 'thinking_end':\n    case 'message_end':\n      break;\n    case 'tool_start': {\n      const toolName = String(data.toolName ?? 'unknown');\n      const toolCallId = String(data.toolCallId || crypto.randomUUID());\n      const stack = pendingToolCallIds.get(toolName) ?? [];\n      stack.push(toolCallId);\n      pendingToolCallIds.set(toolName, stack);\n      setActivityStatus('running');\n      chatLog.startTool(toolCallId, toolName, data.args, runId);\n      tui.requestRender();\n      break;\n    }\n    case 'tool_end': {\n      const toolName = String(data.toolName ?? '');\n      let toolCallId = typeof data.toolCallId === 'string' && data.toolCallId ? data.toolCallId : '';\n      if (!toolCallId && toolName) {\n        const stack = pendingToolCallIds.get(toolName);\n        if (stack && stack.length > 0) {\n          toolCallId = stack.shift()!;\n          if (stack.length === 0) pendingToolCallIds.delete(toolName);\n        }\n      }\n      const resultText = String(data.result ?? '');\n      const isError = Boolean(data.isError);\n      if (toolCallId) {\n        chatLog.updateToolResult(toolCallId, resultText, isError);\n      }\n      setActivityStatus('streaming');\n      tui.requestRender();\n      break;\n    }\n    case 'error': {\n      const errorContent = String(data.content ?? 'Unknown error');\n      const finalText = assembler.finalize(runId, state.showThinking);\n      if (finalText) {\n        chatLog.finalizeAssistant(finalText, runId);\n      }\n      chatLog.addSystem(`❌ ${errorContent}`);\n      state.activeRunId = null;\n      setActivityStatus('idle');\n      onRunEnded?.();\n      tui.requestRender();\n      break;\n    }\n    case 'result': {\n      const finalText = assembler.finalize(runId, state.showThinking);\n      if (finalText) {\n        chatLog.finalizeAssistant(finalText, runId);\n      }\n      state.activeRunId = null;\n      setActivityStatus('idle');\n      onRunEnded?.();\n      tui.requestRender();\n      break;\n    }\n    case 'progress': {\n      const stage = typeof data.stage === 'string' ? data.stage : '';\n      const message = typeof data.message === 'string' ? data.message : stage;\n      state.progressMessage = message || null;\n      setActivityStatus(message ? `progress: ${message}` : 'running');\n      tui.requestRender();\n      break;\n    }\n    default:\n      break;\n  }\n}\n\nexport const DEFAULT_STREAMING_WATCHDOG_MS = 30_000;\n"],"mappings":"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"}
+{"version":3,"file":"tui-agent-events.js","names":[],"sources":["../../../src/tui/tui-agent-events.ts"],"sourcesContent":["import type { TUI } from '@earendil-works/pi-tui';\n\nimport { formatAgentRunErrorForDisplay } from '../agent/client-error-format.js';\nimport type { ChatLog } from './components/chat-log.js';\nimport type { StreamAssembler } from './stream-assembler.js';\nimport type { TuiState } from './tui-types.js';\n\nconst pendingToolCallIds = new Map<string, string[]>();\n\nexport function clearPendingToolCallIds(): void {\n  pendingToolCallIds.clear();\n}\n\nconst STREAM_TOUCH_EVENTS = new Set([\n  'status',\n  'token',\n  'thinking',\n  'tool_start',\n  'tool_end',\n  'progress',\n]);\n\nexport function dispatchAgentSSE(\n  event: string,\n  data: Record<string, unknown>,\n  state: TuiState,\n  chatLog: ChatLog,\n  assembler: StreamAssembler,\n  tui: TUI,\n  setActivityStatus: (status: string) => void,\n  touchStreamingActivity?: () => void,\n  /** Called when a run ends (result/error) so the TUI can flush follow-up queue, etc. */\n  onRunEnded?: () => void,\n): void {\n  if (STREAM_TOUCH_EVENTS.has(event)) {\n    touchStreamingActivity?.();\n  }\n\n  const runId = state.activeRunId ?? 'default';\n\n  switch (event) {\n    case 'status': {\n      const newRunId = typeof data.runId === 'string' ? data.runId : runId;\n      state.activeRunId = newRunId;\n      setActivityStatus('waiting');\n      break;\n    }\n    case 'token': {\n      const content =\n        typeof data.content === 'string'\n          ? data.content\n          : typeof data.delta === 'string'\n            ? data.delta\n            : typeof data.text === 'string'\n              ? data.text\n              : '';\n      if (!content) break;\n      setActivityStatus('streaming');\n      const display = assembler.ingestToken(runId, content, state.showThinking);\n      if (display !== null) {\n        chatLog.updateAssistant(display, runId);\n        tui.requestRender();\n      }\n      break;\n    }\n    case 'thinking': {\n      const thinkContent = String(data.content ?? '');\n      const isDelta = Boolean(data.delta);\n      if (data.status === 'started') break;\n      setActivityStatus('streaming');\n      const display = assembler.ingestThinking(runId, thinkContent, isDelta, state.showThinking);\n      if (display !== null) {\n        chatLog.updateAssistant(display, runId);\n        tui.requestRender();\n      }\n      break;\n    }\n    case 'thinking_end':\n    case 'message_end':\n      break;\n    case 'tool_start': {\n      const toolName = String(data.toolName ?? 'unknown');\n      const toolCallId = String(data.toolCallId || crypto.randomUUID());\n      const stack = pendingToolCallIds.get(toolName) ?? [];\n      stack.push(toolCallId);\n      pendingToolCallIds.set(toolName, stack);\n      setActivityStatus('running');\n      chatLog.startTool(toolCallId, toolName, data.args, runId);\n      tui.requestRender();\n      break;\n    }\n    case 'tool_end': {\n      const toolName = String(data.toolName ?? '');\n      let toolCallId = typeof data.toolCallId === 'string' && data.toolCallId ? data.toolCallId : '';\n      if (!toolCallId && toolName) {\n        const stack = pendingToolCallIds.get(toolName);\n        if (stack && stack.length > 0) {\n          toolCallId = stack.shift()!;\n          if (stack.length === 0) pendingToolCallIds.delete(toolName);\n        }\n      }\n      const resultText = String(data.result ?? '');\n      const isError = Boolean(data.isError);\n      if (toolCallId) {\n        chatLog.updateToolResult(toolCallId, resultText, isError);\n      }\n      setActivityStatus('streaming');\n      tui.requestRender();\n      break;\n    }\n    case 'error': {\n      const errorContent = formatAgentRunErrorForDisplay(String(data.content ?? 'Unknown error'));\n      const finalText = assembler.finalize(runId, state.showThinking);\n      if (finalText) {\n        chatLog.finalizeAssistant(finalText, runId);\n      }\n      chatLog.addSystem(`❌ ${errorContent}`);\n      state.activeRunId = null;\n      setActivityStatus('idle');\n      onRunEnded?.();\n      tui.requestRender();\n      break;\n    }\n    case 'result': {\n      const finalText = assembler.finalize(runId, state.showThinking);\n      if (finalText) {\n        chatLog.finalizeAssistant(finalText, runId);\n      }\n      state.activeRunId = null;\n      setActivityStatus('idle');\n      onRunEnded?.();\n      tui.requestRender();\n      break;\n    }\n    case 'progress': {\n      const stage = typeof data.stage === 'string' ? data.stage : '';\n      const message = typeof data.message === 'string' ? data.message : stage;\n      state.progressMessage = message || null;\n      setActivityStatus(message ? `progress: ${message}` : 'running');\n      tui.requestRender();\n      break;\n    }\n    default:\n      break;\n  }\n}\n\nexport const DEFAULT_STREAMING_WATCHDOG_MS = 30_000;\n"],"mappings":"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"}

package/dist/src/voice/metadata/builtin.d.ts

@@ -0,0 +1,2 @@
+import type { VoiceProviderMetadata } from './types.js';
+export declare const builtinVoiceProviderMetadata: VoiceProviderMetadata[];

package/dist/src/voice/metadata/builtin.js

@@ -0,0 +1,420 @@
+import { OPENAI_TTS_MODELS, OPENAI_TTS_VOICES } from "../tts/providers/openai-speech.js";
+import { MINIMAX_TTS_MODELS, MINIMAX_TTS_VOICES } from "../tts/providers/minimax-speech.js";
+import "../tts/providers/index.js";
+import { registerVoiceProviderMetadata } from "./registry.js";
+//#region src/voice/metadata/builtin.ts
+function titleCase(value) {
+	return value.charAt(0).toUpperCase() + value.slice(1);
+}
+function options(values, names) {
+	return values.map((id) => ({
+		id,
+		name: names?.[id] ?? titleCase(id)
+	}));
+}
+const alibabaSttModels = [
+	{
+		id: "paraformer-v2",
+		name: "Paraformer v2 (Recommended)"
+	},
+	{
+		id: "paraformer-v1",
+		name: "Paraformer v1"
+	},
+	{
+		id: "paraformer-8k-v1",
+		name: "Paraformer 8k v1 (Phone)"
+	},
+	{
+		id: "paraformer-mtl-v1",
+		name: "Paraformer MTL v1 (Multilingual)"
+	}
+];
+const alibabaTtsModels = [
+	{
+		id: "qwen-tts",
+		name: "Qwen TTS (Recommended)"
+	},
+	{
+		id: "qwen-tts-realtime",
+		name: "Qwen TTS Realtime"
+	},
+	{
+		id: "qwen3-tts-flash",
+		name: "Qwen3 TTS Flash"
+	},
+	{
+		id: "qwen3-tts-instruct-flash",
+		name: "Qwen3 TTS Instruct Flash"
+	}
+];
+const alibabaTtsVoices = [
+	{
+		id: "Cherry",
+		name: "Cherry"
+	},
+	{
+		id: "Ethan",
+		name: "Ethan"
+	},
+	{
+		id: "Serena",
+		name: "Serena"
+	},
+	{
+		id: "Chelsie",
+		name: "Chelsie"
+	},
+	{
+		id: "longxiaochun",
+		name: "Long Xiao Chun (龙小春)"
+	},
+	{
+		id: "longxiaobai",
+		name: "Long Xiao Bai (龙小白)"
+	},
+	{
+		id: "longwan",
+		name: "Long Wan (龙婉)"
+	},
+	{
+		id: "longcheng",
+		name: "Long Cheng (龙呈)"
+	}
+];
+const edgeVoices = [
+	{
+		id: "en-US-MichelleNeural",
+		name: "Michelle (US English, Female)"
+	},
+	{
+		id: "en-US-JennyNeural",
+		name: "Jenny (US English, Female)"
+	},
+	{
+		id: "en-US-GuyNeural",
+		name: "Guy (US English, Male)"
+	},
+	{
+		id: "en-GB-SoniaNeural",
+		name: "Sonia (UK English, Female)"
+	},
+	{
+		id: "en-GB-RyanNeural",
+		name: "Ryan (UK English, Male)"
+	},
+	{
+		id: "zh-CN-XiaoxiaoNeural",
+		name: "晓晓 (中文, 女声)"
+	},
+	{
+		id: "zh-CN-YunyangNeural",
+		name: "云扬 (中文, 男声)"
+	},
+	{
+		id: "zh-CN-XiaoyiNeural",
+		name: "晓伊 (中文, 女声)"
+	},
+	{
+		id: "ja-JP-NanamiNeural",
+		name: "七海 (日本語, 女性)"
+	},
+	{
+		id: "de-DE-KatjaNeural",
+		name: "Katja (Deutsch, Weiblich)"
+	},
+	{
+		id: "fr-FR-DeniseNeural",
+		name: "Denise (Français, Féminin)"
+	},
+	{
+		id: "es-ES-ElviraNeural",
+		name: "Elvira (Español, Femenino)"
+	}
+];
+const builtinVoiceProviderMetadata = [
+	{
+		id: "alibaba",
+		capability: "stt",
+		displayName: "Alibaba DashScope",
+		description: "DashScope Paraformer speech-to-text, strong Chinese recognition.",
+		aliases: ["dashscope", "paraformer"],
+		models: alibabaSttModels,
+		fields: [
+			{
+				key: "apiKey",
+				label: "API Key",
+				type: "password",
+				secret: true,
+				placeholder: "sk-...",
+				description: "DASHSCOPE_API_KEY"
+			},
+			{
+				key: "model",
+				label: "Model",
+				type: "select",
+				options: alibabaSttModels,
+				defaultValue: "paraformer-v2"
+			},
+			{
+				key: "language",
+				label: "Language hint",
+				type: "string",
+				placeholder: "zh"
+			}
+		],
+		diagnostics: {
+			requiresApiKey: true,
+			envKeys: ["DASHSCOPE_API_KEY"],
+			configPath: "tools.media.audio.providers.alibaba"
+		}
+	},
+	{
+		id: "openai",
+		capability: "stt",
+		displayName: "OpenAI Whisper",
+		description: "OpenAI Whisper transcription endpoint.",
+		models: [{
+			id: "whisper-1",
+			name: "Whisper-1"
+		}],
+		fields: [
+			{
+				key: "apiKey",
+				label: "API Key",
+				type: "password",
+				secret: true,
+				placeholder: "sk-...",
+				description: "OPENAI_API_KEY"
+			},
+			{
+				key: "model",
+				label: "Model",
+				type: "select",
+				options: [{
+					id: "whisper-1",
+					name: "Whisper-1"
+				}],
+				defaultValue: "whisper-1"
+			},
+			{
+				key: "baseUrl",
+				label: "Base URL",
+				type: "string",
+				placeholder: "https://api.openai.com/v1"
+			},
+			{
+				key: "language",
+				label: "Language hint",
+				type: "string",
+				placeholder: "en"
+			},
+			{
+				key: "prompt",
+				label: "Prompt",
+				type: "textarea"
+			}
+		],
+		diagnostics: {
+			requiresApiKey: true,
+			envKeys: ["OPENAI_API_KEY"],
+			configPath: "tools.media.audio.providers.openai"
+		}
+	},
+	{
+		id: "openai",
+		capability: "tts",
+		displayName: "OpenAI",
+		description: "OpenAI speech synthesis with multiple voices.",
+		models: options(OPENAI_TTS_MODELS, {
+			"gpt-4o-mini-tts": "GPT-4o Mini TTS (Latest)",
+			"tts-1": "TTS-1 (Fast)",
+			"tts-1-hd": "TTS-1 HD (High Quality)"
+		}),
+		voices: options(OPENAI_TTS_VOICES),
+		fields: [
+			{
+				key: "apiKey",
+				label: "API Key",
+				type: "password",
+				secret: true,
+				placeholder: "sk-...",
+				description: "OPENAI_API_KEY"
+			},
+			{
+				key: "model",
+				label: "Model",
+				type: "select",
+				options: options(OPENAI_TTS_MODELS),
+				defaultValue: "tts-1"
+			},
+			{
+				key: "voice",
+				label: "Voice",
+				type: "select",
+				options: options(OPENAI_TTS_VOICES),
+				defaultValue: "alloy"
+			},
+			{
+				key: "baseUrl",
+				label: "Base URL",
+				type: "string",
+				placeholder: "https://api.openai.com/v1"
+			}
+		],
+		diagnostics: {
+			requiresApiKey: true,
+			envKeys: ["OPENAI_API_KEY"],
+			configPath: "messages.tts.providers.openai"
+		}
+	},
+	{
+		id: "alibaba",
+		capability: "tts",
+		displayName: "Alibaba DashScope",
+		description: "DashScope Qwen TTS, strong Chinese voice quality.",
+		models: alibabaTtsModels,
+		voices: alibabaTtsVoices,
+		fields: [
+			{
+				key: "apiKey",
+				label: "API Key",
+				type: "password",
+				secret: true,
+				placeholder: "sk-...",
+				description: "DASHSCOPE_API_KEY"
+			},
+			{
+				key: "model",
+				label: "Model",
+				type: "select",
+				options: alibabaTtsModels,
+				defaultValue: "qwen-tts"
+			},
+			{
+				key: "voice",
+				label: "Voice",
+				type: "select",
+				options: alibabaTtsVoices,
+				defaultValue: "longxiaochun"
+			}
+		],
+		diagnostics: {
+			requiresApiKey: true,
+			envKeys: ["DASHSCOPE_API_KEY"],
+			configPath: "messages.tts.providers.alibaba"
+		}
+	},
+	{
+		id: "minimax",
+		capability: "tts",
+		displayName: "MiniMax",
+		description: "MiniMax high-quality async text-to-speech.",
+		models: options(MINIMAX_TTS_MODELS),
+		voices: options(MINIMAX_TTS_VOICES),
+		fields: [
+			{
+				key: "apiKey",
+				label: "API Key",
+				type: "password",
+				secret: true,
+				placeholder: "eyJ...",
+				description: "MINIMAX_API_KEY"
+			},
+			{
+				key: "model",
+				label: "Model",
+				type: "select",
+				options: options(MINIMAX_TTS_MODELS),
+				defaultValue: "speech-2.8-hd"
+			},
+			{
+				key: "voice",
+				label: "Voice",
+				type: "select",
+				options: options(MINIMAX_TTS_VOICES),
+				defaultValue: "male-qn-qingse"
+			},
+			{
+				key: "baseUrl",
+				label: "Base URL",
+				type: "string",
+				placeholder: "https://api.minimaxi.com/v1"
+			},
+			{
+				key: "groupId",
+				label: "Group ID",
+				type: "string"
+			}
+		],
+		diagnostics: {
+			requiresApiKey: true,
+			envKeys: ["MINIMAX_API_KEY"],
+			configPath: "messages.tts.providers.minimax"
+		}
+	},
+	{
+		id: "edge",
+		capability: "tts",
+		displayName: "Microsoft Edge",
+		description: "Free Edge TTS endpoint, no API key required.",
+		models: [{
+			id: "edge-default",
+			name: "Edge TTS (Free)"
+		}],
+		voices: edgeVoices,
+		fields: [
+			{
+				key: "voice",
+				label: "Voice",
+				type: "select",
+				options: edgeVoices,
+				defaultValue: "en-US-MichelleNeural"
+			},
+			{
+				key: "lang",
+				label: "Language",
+				type: "string",
+				placeholder: "en-US"
+			},
+			{
+				key: "outputFormat",
+				label: "Output format",
+				type: "string",
+				placeholder: "audio-24khz-48kbitrate-mono-mp3"
+			},
+			{
+				key: "rate",
+				label: "Rate",
+				type: "string",
+				placeholder: "+0%"
+			},
+			{
+				key: "pitch",
+				label: "Pitch",
+				type: "string",
+				placeholder: "+0Hz"
+			},
+			{
+				key: "volume",
+				label: "Volume",
+				type: "string",
+				placeholder: "+0%"
+			},
+			{
+				key: "proxy",
+				label: "Proxy",
+				type: "string"
+			}
+		],
+		diagnostics: {
+			requiresApiKey: false,
+			configPath: "messages.tts.providers.edge"
+		}
+	}
+];
+for (const metadata of builtinVoiceProviderMetadata) registerVoiceProviderMetadata(metadata);
+//#endregion
+export { builtinVoiceProviderMetadata };
+
+//# sourceMappingURL=builtin.js.map

package/dist/src/voice/metadata/builtin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin.js","names":[],"sources":["../../../../src/voice/metadata/builtin.ts"],"sourcesContent":["import { registerVoiceProviderMetadata } from './registry.js';\nimport type { VoiceOptionMetadata, VoiceProviderMetadata } from './types.js';\nimport { MINIMAX_TTS_MODELS, MINIMAX_TTS_VOICES, OPENAI_TTS_MODELS, OPENAI_TTS_VOICES } from '../tts/providers/index.js';\n\nfunction titleCase(value: string): string {\n  return value.charAt(0).toUpperCase() + value.slice(1);\n}\n\nfunction options(values: readonly string[], names?: Record<string, string>): VoiceOptionMetadata[] {\n  return values.map((id) => ({ id, name: names?.[id] ?? titleCase(id) }));\n}\n\nconst alibabaSttModels = [\n  { id: 'paraformer-v2', name: 'Paraformer v2 (Recommended)' },\n  { id: 'paraformer-v1', name: 'Paraformer v1' },\n  { id: 'paraformer-8k-v1', name: 'Paraformer 8k v1 (Phone)' },\n  { id: 'paraformer-mtl-v1', name: 'Paraformer MTL v1 (Multilingual)' },\n];\n\nconst alibabaTtsModels = [\n  { id: 'qwen-tts', name: 'Qwen TTS (Recommended)' },\n  { id: 'qwen-tts-realtime', name: 'Qwen TTS Realtime' },\n  { id: 'qwen3-tts-flash', name: 'Qwen3 TTS Flash' },\n  { id: 'qwen3-tts-instruct-flash', name: 'Qwen3 TTS Instruct Flash' },\n];\n\nconst alibabaTtsVoices = [\n  { id: 'Cherry', name: 'Cherry' },\n  { id: 'Ethan', name: 'Ethan' },\n  { id: 'Serena', name: 'Serena' },\n  { id: 'Chelsie', name: 'Chelsie' },\n  { id: 'longxiaochun', name: 'Long Xiao Chun (龙小春)' },\n  { id: 'longxiaobai', name: 'Long Xiao Bai (龙小白)' },\n  { id: 'longwan', name: 'Long Wan (龙婉)' },\n  { id: 'longcheng', name: 'Long Cheng (龙呈)' },\n];\n\nconst edgeVoices = [\n  { id: 'en-US-MichelleNeural', name: 'Michelle (US English, Female)' },\n  { id: 'en-US-JennyNeural', name: 'Jenny (US English, Female)' },\n  { id: 'en-US-GuyNeural', name: 'Guy (US English, Male)' },\n  { id: 'en-GB-SoniaNeural', name: 'Sonia (UK English, Female)' },\n  { id: 'en-GB-RyanNeural', name: 'Ryan (UK English, Male)' },\n  { id: 'zh-CN-XiaoxiaoNeural', name: '晓晓 (中文, 女声)' },\n  { id: 'zh-CN-YunyangNeural', name: '云扬 (中文, 男声)' },\n  { id: 'zh-CN-XiaoyiNeural', name: '晓伊 (中文, 女声)' },\n  { id: 'ja-JP-NanamiNeural', name: '七海 (日本語, 女性)' },\n  { id: 'de-DE-KatjaNeural', name: 'Katja (Deutsch, Weiblich)' },\n  { id: 'fr-FR-DeniseNeural', name: 'Denise (Français, Féminin)' },\n  { id: 'es-ES-ElviraNeural', name: 'Elvira (Español, Femenino)' },\n];\n\nexport const builtinVoiceProviderMetadata: VoiceProviderMetadata[] = [\n  {\n    id: 'alibaba',\n    capability: 'stt',\n    displayName: 'Alibaba DashScope',\n    description: 'DashScope Paraformer speech-to-text, strong Chinese recognition.',\n    aliases: ['dashscope', 'paraformer'],\n    models: alibabaSttModels,\n    fields: [\n      { key: 'apiKey', label: 'API Key', type: 'password', secret: true, placeholder: 'sk-...', description: 'DASHSCOPE_API_KEY' },\n      { key: 'model', label: 'Model', type: 'select', options: alibabaSttModels, defaultValue: 'paraformer-v2' },\n      { key: 'language', label: 'Language hint', type: 'string', placeholder: 'zh' },\n    ],\n    diagnostics: { requiresApiKey: true, envKeys: ['DASHSCOPE_API_KEY'], configPath: 'tools.media.audio.providers.alibaba' },\n  },\n  {\n    id: 'openai',\n    capability: 'stt',\n    displayName: 'OpenAI Whisper',\n    description: 'OpenAI Whisper transcription endpoint.',\n    models: [{ id: 'whisper-1', name: 'Whisper-1' }],\n    fields: [\n      { key: 'apiKey', label: 'API Key', type: 'password', secret: true, placeholder: 'sk-...', description: 'OPENAI_API_KEY' },\n      { key: 'model', label: 'Model', type: 'select', options: [{ id: 'whisper-1', name: 'Whisper-1' }], defaultValue: 'whisper-1' },\n      { key: 'baseUrl', label: 'Base URL', type: 'string', placeholder: 'https://api.openai.com/v1' },\n      { key: 'language', label: 'Language hint', type: 'string', placeholder: 'en' },\n      { key: 'prompt', label: 'Prompt', type: 'textarea' },\n    ],\n    diagnostics: { requiresApiKey: true, envKeys: ['OPENAI_API_KEY'], configPath: 'tools.media.audio.providers.openai' },\n  },\n  {\n    id: 'openai',\n    capability: 'tts',\n    displayName: 'OpenAI',\n    description: 'OpenAI speech synthesis with multiple voices.',\n    models: options(OPENAI_TTS_MODELS, {\n      'gpt-4o-mini-tts': 'GPT-4o Mini TTS (Latest)',\n      'tts-1': 'TTS-1 (Fast)',\n      'tts-1-hd': 'TTS-1 HD (High Quality)',\n    }),\n    voices: options(OPENAI_TTS_VOICES),\n    fields: [\n      { key: 'apiKey', label: 'API Key', type: 'password', secret: true, placeholder: 'sk-...', description: 'OPENAI_API_KEY' },\n      { key: 'model', label: 'Model', type: 'select', options: options(OPENAI_TTS_MODELS), defaultValue: 'tts-1' },\n      { key: 'voice', label: 'Voice', type: 'select', options: options(OPENAI_TTS_VOICES), defaultValue: 'alloy' },\n      { key: 'baseUrl', label: 'Base URL', type: 'string', placeholder: 'https://api.openai.com/v1' },\n    ],\n    diagnostics: { requiresApiKey: true, envKeys: ['OPENAI_API_KEY'], configPath: 'messages.tts.providers.openai' },\n  },\n  {\n    id: 'alibaba',\n    capability: 'tts',\n    displayName: 'Alibaba DashScope',\n    description: 'DashScope Qwen TTS, strong Chinese voice quality.',\n    models: alibabaTtsModels,\n    voices: alibabaTtsVoices,\n    fields: [\n      { key: 'apiKey', label: 'API Key', type: 'password', secret: true, placeholder: 'sk-...', description: 'DASHSCOPE_API_KEY' },\n      { key: 'model', label: 'Model', type: 'select', options: alibabaTtsModels, defaultValue: 'qwen-tts' },\n      { key: 'voice', label: 'Voice', type: 'select', options: alibabaTtsVoices, defaultValue: 'longxiaochun' },\n    ],\n    diagnostics: { requiresApiKey: true, envKeys: ['DASHSCOPE_API_KEY'], configPath: 'messages.tts.providers.alibaba' },\n  },\n  {\n    id: 'minimax',\n    capability: 'tts',\n    displayName: 'MiniMax',\n    description: 'MiniMax high-quality async text-to-speech.',\n    models: options(MINIMAX_TTS_MODELS),\n    voices: options(MINIMAX_TTS_VOICES),\n    fields: [\n      { key: 'apiKey', label: 'API Key', type: 'password', secret: true, placeholder: 'eyJ...', description: 'MINIMAX_API_KEY' },\n      { key: 'model', label: 'Model', type: 'select', options: options(MINIMAX_TTS_MODELS), defaultValue: 'speech-2.8-hd' },\n      { key: 'voice', label: 'Voice', type: 'select', options: options(MINIMAX_TTS_VOICES), defaultValue: 'male-qn-qingse' },\n      { key: 'baseUrl', label: 'Base URL', type: 'string', placeholder: 'https://api.minimaxi.com/v1' },\n      { key: 'groupId', label: 'Group ID', type: 'string' },\n    ],\n    diagnostics: { requiresApiKey: true, envKeys: ['MINIMAX_API_KEY'], configPath: 'messages.tts.providers.minimax' },\n  },\n  {\n    id: 'edge',\n    capability: 'tts',\n    displayName: 'Microsoft Edge',\n    description: 'Free Edge TTS endpoint, no API key required.',\n    models: [{ id: 'edge-default', name: 'Edge TTS (Free)' }],\n    voices: edgeVoices,\n    fields: [\n      { key: 'voice', label: 'Voice', type: 'select', options: edgeVoices, defaultValue: 'en-US-MichelleNeural' },\n      { key: 'lang', label: 'Language', type: 'string', placeholder: 'en-US' },\n      { key: 'outputFormat', label: 'Output format', type: 'string', placeholder: 'audio-24khz-48kbitrate-mono-mp3' },\n      { key: 'rate', label: 'Rate', type: 'string', placeholder: '+0%' },\n      { key: 'pitch', label: 'Pitch', type: 'string', placeholder: '+0Hz' },\n      { key: 'volume', label: 'Volume', type: 'string', placeholder: '+0%' },\n      { key: 'proxy', label: 'Proxy', type: 'string' },\n    ],\n    diagnostics: { requiresApiKey: false, configPath: 'messages.tts.providers.edge' },\n  },\n];\n\nfor (const metadata of builtinVoiceProviderMetadata) {\n  registerVoiceProviderMetadata(metadata);\n}\n"],"mappings":"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"}

package/dist/src/voice/metadata/index.d.ts

@@ -0,0 +1,4 @@
+import './builtin.js';
+export type { VoiceCapability, VoiceConfigFieldMetadata, VoiceConfigFieldType, VoiceOptionMetadata, VoiceProviderDiagnosticMetadata, VoiceProviderMetadata, VoiceProviderMetadataPayload, VoiceProviderMetadataPayloadEntry, } from './types.js';
+export { registerVoiceProviderMetadata, getVoiceProviderMetadata, listVoiceProviderMetadata, } from './registry.js';
+export { builtinVoiceProviderMetadata } from './builtin.js';

package/dist/src/voice/metadata/index.js

@@ -0,0 +1,3 @@
+import { getVoiceProviderMetadata, listVoiceProviderMetadata, registerVoiceProviderMetadata } from "./registry.js";
+import { builtinVoiceProviderMetadata } from "./builtin.js";
+export { builtinVoiceProviderMetadata, getVoiceProviderMetadata, listVoiceProviderMetadata, registerVoiceProviderMetadata };

package/dist/src/voice/metadata/registry.d.ts

@@ -0,0 +1,5 @@
+import type { VoiceCapability, VoiceProviderMetadata } from './types.js';
+export declare function registerVoiceProviderMetadata(metadata: VoiceProviderMetadata): () => void;
+export declare function getVoiceProviderMetadata(capability: VoiceCapability, providerId: string): VoiceProviderMetadata | undefined;
+export declare function listVoiceProviderMetadata(capability?: VoiceCapability): VoiceProviderMetadata[];
+export declare function _clearVoiceProviderMetadataRegistryForTests(): void;

package/dist/src/voice/metadata/registry.js

@@ -0,0 +1,34 @@
+//#region src/voice/metadata/registry.ts
+const registry = /* @__PURE__ */ new Map();
+function normalizeKey(capability, providerId) {
+	return `${capability}:${providerId.trim().toLowerCase()}`;
+}
+function registerVoiceProviderMetadata(metadata) {
+	const keys = [normalizeKey(metadata.capability, metadata.id)];
+	for (const alias of metadata.aliases ?? []) keys.push(normalizeKey(metadata.capability, alias));
+	for (const key of keys) registry.set(key, metadata);
+	return () => {
+		for (const key of keys) if (registry.get(key) === metadata) registry.delete(key);
+	};
+}
+function getVoiceProviderMetadata(capability, providerId) {
+	return registry.get(normalizeKey(capability, providerId));
+}
+function listVoiceProviderMetadata(capability) {
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const metadata of registry.values()) {
+		if (seen.has(metadata)) continue;
+		if (capability && metadata.capability !== capability) continue;
+		seen.add(metadata);
+		result.push(metadata);
+	}
+	return result;
+}
+function _clearVoiceProviderMetadataRegistryForTests() {
+	registry.clear();
+}
+//#endregion
+export { _clearVoiceProviderMetadataRegistryForTests, getVoiceProviderMetadata, listVoiceProviderMetadata, registerVoiceProviderMetadata };
+
+//# sourceMappingURL=registry.js.map

package/dist/src/voice/metadata/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../../../src/voice/metadata/registry.ts"],"sourcesContent":["import type { VoiceCapability, VoiceProviderMetadata } from './types.js';\n\nconst registry = new Map<string, VoiceProviderMetadata>();\n\nfunction normalizeKey(capability: VoiceCapability, providerId: string): string {\n  return `${capability}:${providerId.trim().toLowerCase()}`;\n}\n\nexport function registerVoiceProviderMetadata(metadata: VoiceProviderMetadata): () => void {\n  const keys = [normalizeKey(metadata.capability, metadata.id)];\n  for (const alias of metadata.aliases ?? []) {\n    keys.push(normalizeKey(metadata.capability, alias));\n  }\n  for (const key of keys) {\n    registry.set(key, metadata);\n  }\n  return () => {\n    for (const key of keys) {\n      if (registry.get(key) === metadata) {\n        registry.delete(key);\n      }\n    }\n  };\n}\n\nexport function getVoiceProviderMetadata(\n  capability: VoiceCapability,\n  providerId: string,\n): VoiceProviderMetadata | undefined {\n  return registry.get(normalizeKey(capability, providerId));\n}\n\nexport function listVoiceProviderMetadata(capability?: VoiceCapability): VoiceProviderMetadata[] {\n  const seen = new Set<VoiceProviderMetadata>();\n  const result: VoiceProviderMetadata[] = [];\n  for (const metadata of registry.values()) {\n    if (seen.has(metadata)) continue;\n    if (capability && metadata.capability !== capability) continue;\n    seen.add(metadata);\n    result.push(metadata);\n  }\n  return result;\n}\n\nexport function _clearVoiceProviderMetadataRegistryForTests(): void {\n  registry.clear();\n}\n"],"mappings":";AAEA,MAAM,2BAAW,IAAI,KAAoC;AAEzD,SAAS,aAAa,YAA6B,YAA4B;AAC7E,QAAO,GAAG,WAAW,GAAG,WAAW,MAAM,CAAC,aAAa;;AAGzD,SAAgB,8BAA8B,UAA6C;CACzF,MAAM,OAAO,CAAC,aAAa,SAAS,YAAY,SAAS,GAAG,CAAC;AAC7D,MAAK,MAAM,SAAS,SAAS,WAAW,EAAE,CACxC,MAAK,KAAK,aAAa,SAAS,YAAY,MAAM,CAAC;AAErD,MAAK,MAAM,OAAO,KAChB,UAAS,IAAI,KAAK,SAAS;AAE7B,cAAa;AACX,OAAK,MAAM,OAAO,KAChB,KAAI,SAAS,IAAI,IAAI,KAAK,SACxB,UAAS,OAAO,IAAI;;;AAM5B,SAAgB,yBACd,YACA,YACmC;AACnC,QAAO,SAAS,IAAI,aAAa,YAAY,WAAW,CAAC;;AAG3D,SAAgB,0BAA0B,YAAuD;CAC/F,MAAM,uBAAO,IAAI,KAA4B;CAC7C,MAAM,SAAkC,EAAE;AAC1C,MAAK,MAAM,YAAY,SAAS,QAAQ,EAAE;AACxC,MAAI,KAAK,IAAI,SAAS,CAAE;AACxB,MAAI,cAAc,SAAS,eAAe,WAAY;AACtD,OAAK,IAAI,SAAS;AAClB,SAAO,KAAK,SAAS;;AAEvB,QAAO;;AAGT,SAAgB,8CAAoD;AAClE,UAAS,OAAO"}

package/dist/src/voice/metadata/types.d.ts

@@ -0,0 +1,41 @@
+export type VoiceCapability = 'stt' | 'tts';
+export type VoiceConfigFieldType = 'string' | 'password' | 'number' | 'boolean' | 'select' | 'textarea';
+export interface VoiceOptionMetadata {
+    id: string;
+    name: string;
+    description?: string;
+}
+export interface VoiceConfigFieldMetadata {
+    key: string;
+    label: string;
+    type: VoiceConfigFieldType;
+    required?: boolean;
+    secret?: boolean;
+    placeholder?: string;
+    description?: string;
+    options?: VoiceOptionMetadata[];
+    defaultValue?: string | number | boolean;
+}
+export interface VoiceProviderDiagnosticMetadata {
+    requiresApiKey: boolean;
+    envKeys?: string[];
+    configPath: string;
+}
+export interface VoiceProviderMetadata {
+    id: string;
+    capability: VoiceCapability;
+    displayName: string;
+    description?: string;
+    aliases?: string[];
+    models?: VoiceOptionMetadata[];
+    voices?: VoiceOptionMetadata[];
+    fields: VoiceConfigFieldMetadata[];
+    diagnostics: VoiceProviderDiagnosticMetadata;
+}
+export interface VoiceProviderMetadataPayloadEntry extends VoiceProviderMetadata {
+    configured: boolean;
+}
+export interface VoiceProviderMetadataPayload {
+    providers: VoiceProviderMetadataPayloadEntry[];
+    active: string;
+}

package/dist/src/voice/metadata/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/voice/stt/list-providers.d.ts

@@ -2,9 +2,9 @@
  * Registry-driven STT provider listing for gateway / Web UI discovery.
  */
 import type { Config } from '../../config/schema.js';
+import { type VoiceProviderMetadata } from '../metadata/index.js';
 import type { STTConfig } from './types.js';
-export interface SttProviderListEntry {
-    id: string;
+export interface SttProviderListEntry extends VoiceProviderMetadata {
     aliases: string[];
     configured: boolean;
 }
@@ -13,5 +13,5 @@ export interface SttProvidersPayload {
     active: string;
 }
 export declare function isSttProviderConfigured(providerId: string, config: STTConfig): boolean;
-/** List registered audio STT providers with configured state for the current app config. */
+/** List registered audio STT providers with configured state and UI metadata. */
 export declare function listSttProvidersForApi(config: Config | undefined): SttProvidersPayload;