@autoark-ai/eva-client-sdk-ts 1.0.3 → 1.0.5

package/dist/index.d.ts

@@ -56,49 +56,49 @@ export declare class EvaSdkError extends Error implements StructuredError {
     constructor(message: string, options?: EvaSdkErrorOptions);
 }
 interface CommandParameterBase {
-    /** Stable argument name exposed to the model and handler. */
+    /** 暴露给 model 和 handler 的稳定非空参数名；同一 definition 内必须唯一。 English: Stable non-empty argument name exposed to the model and handler; names must be unique within a definition. */
     readonly name: string;
-    /** Model-facing description of the argument. */
+    /** 面向 model 的非空参数说明，会进入 tool schema。 English: Non-empty model-facing argument description included in the tool schema. */
     readonly description: string;
-    /** Whether the argument must be present. */
+    /** 参数是否必填；省略等同 `false`。 English: Whether the argument is required; omission is equivalent to `false`. */
     readonly required?: boolean;
 }
 /** String-valued command parameter with optional same-type examples and enum values. */
 export interface StringCommandParameter extends CommandParameterBase {
-    /** Parameter discriminator used by the runtime validator and generated tool schema. */
+    /** string 参数判别值，供 runtime 校验和 tool schema 使用。 English: String-parameter discriminator used by runtime validation and the generated tool schema. */
     readonly type: "string";
-    /** Optional closed set of accepted string values. */
+    /** 可选的 string 闭集；提供后只接受表内值。 English: Optional closed set of accepted string values. */
     readonly enum?: readonly string[];
-    /** Optional model-facing example value. */
+    /** 可选的 model-facing string 示例，不改变校验规则。 English: Optional model-facing string example; it does not change validation. */
     readonly example?: string;
 }
 /** Number-valued command parameter with optional same-type examples and enum values. */
 export interface NumberCommandParameter extends CommandParameterBase {
-    /** Parameter discriminator used by the runtime validator and generated tool schema. */
+    /** number 参数判别值，供 runtime 校验和 tool schema 使用。 English: Number-parameter discriminator used by runtime validation and the generated tool schema. */
     readonly type: "number";
-    /** Optional closed set of accepted finite number values. */
+    /** 可选的有限 number 闭集；提供后只接受表内值，NaN/Infinity 被拒绝。 English: Optional closed set of finite numbers; only listed values are accepted and NaN/Infinity are rejected. */
     readonly enum?: readonly number[];
-    /** Optional model-facing finite number example. */
+    /** 可选的有限 number 示例，不改变范围。 English: Optional finite-number example; it does not define a range. */
     readonly example?: number;
 }
 /** Boolean-valued command parameter with optional same-type examples and enum values. */
 export interface BooleanCommandParameter extends CommandParameterBase {
-    /** Parameter discriminator used by the runtime validator and generated tool schema. */
+    /** boolean 参数判别值，供 runtime 校验和 tool schema 使用。 English: Boolean-parameter discriminator used by runtime validation and the generated tool schema. */
     readonly type: "boolean";
-    /** Optional closed set of accepted boolean values. */
+    /** 可选的 boolean 闭集；提供后只接受表内值。 English: Optional closed set of accepted boolean values. */
     readonly enum?: readonly boolean[];
-    /** Optional model-facing boolean example. */
+    /** 可选的 boolean 示例，不改变校验规则。 English: Optional boolean example; it does not change validation. */
     readonly example?: boolean;
 }
 /** Scalar command parameter supported by the v1 runtime. */
 export type CommandParameter = StringCommandParameter | NumberCommandParameter | BooleanCommandParameter;
 /** Pure model-facing command definition. Handlers are paired separately by registration. */
 export interface CommandDefinition {
-    /** Stable command identity exposed to the model and used to select its registration. */
+    /** 暴露给 model 的稳定非空 command 名；所有 registrations 中必须唯一。 English: Stable non-empty command identity exposed to the model; it must be unique across registrations. */
     readonly name: string;
-    /** Model-facing description of what the command does and when it should be used. */
+    /** 面向 model 的非空用途/触发时机说明，会进入 tool schema。 English: Non-empty model-facing description of purpose and usage, included in the tool schema. */
     readonly description: string;
-    /** Optional v1 scalar parameters, preserved in declaration order. */
+    /** 可选的 v1 scalar 参数，按声明顺序快照；同名参数在构造期被拒绝。 English: Optional v1 scalar parameters snapshotted in declaration order; duplicate names are rejected at construction. */
     readonly parameters?: readonly CommandParameter[];
 }
 /** One resolved call passed to a registered handler. */
@@ -153,17 +153,18 @@ export type CommandResult = {
 export type CommandHandler = (call: CommandCall, context: CommandContext) => CommandResult | Promise<CommandResult>;
 /** One construction-time pair; command identity comes only from definition.name. */
 export interface CommandRegistration {
-    /** Pure command definition projected to the model-facing tool schema. */
+    /** 投影到 model-facing tool schema 的纯 definition；构造时校验并冻结。 English: Pure definition projected to the model-facing tool schema, validated and frozen at construction. */
     readonly definition: CommandDefinition;
-    /** Handler invoked at most once for the same call ID and content within one turn. */
+    /** 与 definition 成对的 handler；同一 turn 内相同 call ID/content 至多调用一次，取消不能回滚已提交的外部副作用。 English: Handler paired with the definition; the same call ID/content is invoked at most once per turn, and cancellation cannot undo committed external side effects. */
     readonly handler: CommandHandler;
 }
 /** Optional command runtime configuration supplied when the agent is constructed. */
 export interface CommandsConfig {
-    /** Complete definition-handler pairs snapshotted before any provider is created. */
+    /** 完整 definition-handler 配对列表；在 provider 创建前校验并快照，空数组等同禁用 command。 English: Complete definition-handler pairs validated and snapshotted before provider creation; an empty array disables commands. */
     readonly registrations: readonly CommandRegistration[];
     /**
-     * Maximum complete raw tool-call rounds accepted in one turn.
+     * 单个 turn 接受的完整 raw tool-call 轮数上限；必须为有限正整数，越大允许更长 command 循环，也会增加延迟和调用成本。
+     * English: Maximum complete raw tool-call rounds per turn; it must be a finite positive integer, and larger values allow longer command loops with more latency and call cost.
      * @defaultValue 3
      */
     readonly maxCallsPerTurn?: number;
@@ -184,23 +185,24 @@ export declare const DEFAULT_EMOTION_CODES: readonly [
 export type DefaultEmotionCode = (typeof DEFAULT_EMOTION_CODES)[number];
 /** Controls whether and how the agent starts a greeting turn. */
 export type GreetingConfig = {
-    /** Disables the automatic greeting turn. */
+    /** 禁用自动问候，且不会创建问候 turn。 English: Disables the automatic greeting turn. */
     mode: "disabled";
 } | {
-    /** Plays `text` directly as the assistant greeting without calling the LLM. */
+    /** 直接播放 `text` 作为 assistant 问候，不调用 LLM。 English: Plays `text` as the assistant greeting without calling the LLM. */
     mode: "static";
-    /** Non-empty assistant text synthesized for the greeting turn. */
+    /** 必填的非空问候文本；空白文本在构造期被拒绝。 English: Required non-empty assistant text; blank text is rejected during construction. */
     text: string;
 } | {
-    /** Calls the LLM to generate the assistant greeting. */
+    /** 调用 LLM 生成问候，会增加一次 LLM 请求及相应延迟。 English: Calls the LLM to generate the greeting, adding one LLM request and its latency. */
     mode: "dynamic";
-    /** Optional LLM instruction for the greeting; blank or omitted uses the SDK default. */
+    /** 可选的问候指令；省略或空白时使用 SDK 稳定默认指令。 English: Optional greeting instruction; blank or omitted uses the stable SDK default. */
     prompt?: string;
 };
 /** Bounded conversation history used as context for later LLM turns. */
 export interface HistoryConfig {
     /**
-     * Maximum completed user/assistant turn pairs retained as LLM context.
+     * 控制每次 LLM 请求最多携带多少个已完成的 user/assistant turn 对；必须为正整数，默认 10，越大上下文通常更完整，但请求 token、延迟和成本更高。
+     * English: Controls how many completed user/assistant turn pairs each LLM request may carry; it must be a positive integer, defaults to 10, and larger values usually improve context at the cost of tokens, latency, and cost.
      * @defaultValue 10
      * @remarks Must be a positive integer. History is enabled only when `history` is provided.
      */
@@ -209,7 +211,8 @@ export interface HistoryConfig {
 /** Camera capture timing used by the managed dialogue runtime. */
 export interface CameraConfig {
     /**
-     * Maximum duration of one still-image capture before the turn falls back to text-only.
+     * 单次静态图片采集的最长等待时间；值越大越能容忍慢设备，但会延后 LLM 请求和文字降级。
+     * English: Maximum still-image capture wait; larger values tolerate slower devices but delay the LLM request and text-only fallback.
      * @defaultValue 1500
      * @remarks Must be a finite positive integer in milliseconds. This is separate from the
      * fixed internal cancellation-settlement deadline.
@@ -219,26 +222,30 @@ export interface CameraConfig {
 /** Optional LLM-assisted emotion recognition for final user utterances. */
 export interface EmotionConfig {
     /**
-     * Enables the emotion-recognition side path.
+     * 是否启用每个合格 user turn 的情绪识别旁路；启用会增加一次 LLM 分类请求，但不阻塞 reply。
+     * English: Enables an emotion-classification side path for each eligible user turn; it adds one LLM request without blocking the reply.
      * @defaultValue `false`
      * @remarks This is a construction-time configuration option, not a runtime toggle.
      */
     enabled?: boolean;
     /**
-     * Complete custom emotion code catalog used instead of {@link DEFAULT_EMOTION_CODES}.
+     * 替换 {@link DEFAULT_EMOTION_CODES} 的完整自定义情绪 code 目录。
+     * English: Complete custom emotion code catalog used instead of {@link DEFAULT_EMOTION_CODES}.
      * @remarks Codes must match `^[a-z][a-z0-9_-]{0,63}$`. The array must be non-empty
      * and contain no duplicates. The SDK appends the required `unknown` fallback when it
      * is absent; one explicit `unknown` is accepted, while repeated `unknown` is rejected.
      */
     labels?: readonly string[];
     /**
-     * Supplemental business context inserted into the SDK's built-in classification prompt.
+     * 插入 SDK 内置分类 prompt 的补充业务说明，不是完整 prompt。
+     * English: Supplemental business context inserted into the SDK's built-in classification prompt; it is not a complete prompt.
      * @remarks This is not a complete prompt and cannot replace the SDK's fixed safety and
      * output-format instructions. Example: `"这是儿童陪伴场景，重点区分害怕、难过和开心。"`.
      */
     instructions?: string;
     /**
-     * Maximum final-utterance length supplied to emotion recognition, in Unicode code points.
+     * 送入情绪识别的 final utterance 最大长度，单位为 Unicode code points；值越大保留文本越多，但增加分类 token 成本。
+     * English: Maximum final-utterance length in Unicode code points; larger values retain more text but increase classification token cost.
      * @defaultValue `2000`
      * @remarks Must be a finite positive integer. This does not change the independent
      * 100-code-point `EmotionDetectedEvent.textPreview` limit.
@@ -247,37 +254,44 @@ export interface EmotionConfig {
 }
 interface RuntimeConfig {
     /**
-     * System instruction prepended to each LLM request.
+     * 添加到每次 LLM 请求的 system instruction，构造后不可热更新。
+     * English: System instruction prepended to each LLM request; it cannot be hot-reconfigured after construction.
      * @defaultValue An empty string.
      */
     systemPrompt?: string;
     /**
-     * Optional greeting behavior executed when the agent starts.
+     * agent 启动时执行的可选问候策略；省略时不自动问候。
+     * English: Optional greeting behavior executed when the agent starts; omission disables automatic greeting.
      * @defaultValue `{ mode: "disabled" }`
      */
     greeting?: GreetingConfig;
     /**
-     * Enables bounded multi-turn LLM context when provided.
+     * 提供时启用有界多轮 LLM 上下文；省略时各 turn 相互独立。
+     * English: Enables bounded multi-turn LLM context when provided; omit it to keep turns independent.
      * @remarks Omit this field to keep turns independent.
      */
     history?: HistoryConfig;
     /**
-     * Optional camera capture behavior.
+     * 可选的 camera capture 时序配置，仅在构造时生效。
+     * English: Optional camera-capture timing configuration applied at construction.
      * @remarks Camera remains disabled by default even when this field and `transports.camera`
      * are present; call `setCameraCaptureEnabled(true)` to acquire the camera session.
      */
     camera?: CameraConfig;
     /**
-     * Optional emotion-recognition side path for non-empty speech and manual-text turns.
+     * 非空语音和手动文本 turn 的可选情绪识别旁路；省略时关闭。
+     * English: Optional emotion-recognition side path for non-empty speech and manual-text turns; omission disables it.
      * @remarks Omission keeps recognition disabled while retaining the documented defaults.
      */
     emotion?: EmotionConfig;
     /**
-     * Optional barge-in behavior owned by the dialogue runtime.
+     * dialogue runtime 拥有的可选 barge-in 构造配置。
+     * English: Optional construction-time barge-in behavior owned by the dialogue runtime.
      */
     bargeIn?: {
         /**
-         * Duration in milliseconds (`ms`) for suppressing speech admission during the first playback
+         * 每段 audio input session 首次 playback 期间抑制 speech admission 的窗口，单位为毫秒；值越大越能屏蔽首播回声，但也会忽略更长时间内的真实近端发言。
+         * English: Duration in milliseconds (`ms`) for suppressing speech admission during the first playback
          * window of each audio input session.
          * @defaultValue `0`
          * @remarks The unit is milliseconds (`ms`): `3000` means 3000 ms, or 3 seconds. The value must
@@ -287,17 +301,20 @@ interface RuntimeConfig {
         initialPlaybackGuardMs?: number;
     };
     /**
-     * Optional construction-time command registrations.
+     * 可选的构造期 command registrations；构造后不可热注册。
+     * English: Optional construction-time command registrations; commands cannot be hot-registered later.
      * @remarks Registrations are validated and snapshotted before any provider is created.
      */
     commands?: CommandsConfig;
     /**
-     * Complete audio input, output, AEC, and optional camera role set owned by the runtime after construction.
+     * 完整的 audio input/output/AEC 和可选 camera 角色集合；构造后 lifecycle 由 runtime 独占。
+     * English: Complete audio input/output/AEC and optional camera role set whose lifecycle is runtime-owned after construction.
      * @remarks Omit this field for a text-only agent. Do not drive these roles concurrently with the agent.
      */
     transports?: MediaTransportsConfig;
     /**
-     * JSON-compatible metadata attached to agent-produced events and conversation messages.
+     * 附加到 agent events 和 conversation messages 的 JSON-compatible metadata；构造时递归复制，非法或循环值会被拒绝。
+     * English: JSON-compatible metadata attached to agent events and conversation messages; it is deep-cloned at construction and rejects invalid or cyclic values.
      * @defaultValue An empty object.
      * @remarks The SDK clones this value at the public boundary.
      */
@@ -306,65 +323,76 @@ interface RuntimeConfig {
 /** Public managed configuration for one EVA voice-dialogue agent instance. */
 export interface EvaVoiceDialogueAgentConfig extends RuntimeConfig {
     /**
-     * Gateway credential shared by the built-in ASR, LLM, and TTS stages.
+     * 内建 ASR/LLM/TTS stages 共用的 Gateway 凭证；必填，构造时注入且不会从事件、metadata 或 getter 回读。
+     * English: Required Gateway credential shared by built-in ASR/LLM/TTS stages; it is injected at construction and never exposed through events, metadata, or getters.
+     * 可在 EVA 控制台创建并获取形如 `ak-xxxxxxxx...` 的 API Key，也可按 README 中的 EVA Skill / CLI 指引获取并保存。
+     * English: Create an API Key such as `ak-xxxxxxxx...` in the EVA Console, or follow the EVA Skill / CLI guidance in the README to obtain and save one.
      * @remarks The SDK does not expose this value through events, metadata, or configuration getters.
      */
     apiKey: string;
-    /** Managed automatic speech recognition configuration. */
+    /** 控制语音转写使用的 ASR model 和目标 PCM 采样率；必填。 English: Controls the ASR model and target PCM sample rate used for transcription; required. */
     asr: {
-        /** Gateway ASR model identifier forwarded as the wire `model` field. */
+        /** 透传为 wire `model` 的非解释 ASR model ID；SDK 不维护可用目录，见 README 外部配置参考。 English: Opaque ASR model ID forwarded as wire `model`; the SDK does not own the catalog, so see the README external references. */
         model: string;
         /**
-         * Target PCM sample rate sent to the configured ASR model, in Hz.
-         * @remarks Must be a finite positive integer. The SDK resamples at the ASR boundary and does not infer model compatibility.
+         * 发送给 ASR model 的目标 PCM 采样率，单位 Hz；必须为有限正整数并与所选 ASR model 支持的采样率配套，越高通常保留更高频率信息但增加音频字节量。
+         * English: Target PCM sample rate in Hz; it must be a finite positive integer supported by the selected ASR model, and higher rates usually retain more high-frequency detail while increasing audio bytes.
+         * @remarks The SDK resamples at the ASR boundary but does not infer model compatibility; consult the README external configuration references when selecting the model and rate together.
          */
         sampleRate: number;
     };
-    /** Managed text-to-speech configuration. */
+    /** 控制语音合成使用的 TTS model、音色和合成参数；必填。 English: Controls the TTS model, voice, and synthesis parameters; required. */
     tts: {
-        /** Gateway TTS model identifier forwarded as the wire `model` field. */
+        /** 透传为 wire `model` 的非解释 TTS model ID；可用目录由模型平台决定，见 README 外部配置参考。 English: Opaque TTS model ID forwarded as wire `model`; availability is model-platform-owned, so see the README external references. */
         model: string;
-        /** Optional model-specific voice identifier. */
+        /** 可选的 model-specific 音色 ID；SDK 原样透传且不维护音色目录/试听入口，见 README 外部配置参考。 English: Optional model-specific voice ID forwarded unchanged; the SDK does not own the voice catalog or preview entrypoint. */
         voice?: string;
-        /** Optional speaking speed forwarded as the Gateway `speed` value. */
+        /** 可选语速值，原样透传为 Gateway `speed`；通常值越大语速越快，但准确范围、默认和方向由具体 model 决定，见 README。 English: Optional speaking-rate value forwarded as Gateway `speed`; larger commonly means faster speech, while the exact range/default/direction is model-specific. */
         speakingRate?: number;
-        /** Optional pitch multiplier forwarded as the Gateway `pitch_rate` value. */
+        /** 可选音高值，原样透传为 Gateway `pitch_rate`；通常值越大音高越高，但准确范围和默认由具体 model 决定，见 README。 English: Optional pitch value forwarded as Gateway `pitch_rate`; larger commonly means higher pitch, while the exact range and default are model-specific. */
         pitch?: number;
         /**
-         * Requested TTS PCM sample rate in Hz.
+         * 请求的 TTS PCM 采样率，单位 Hz；提供时必须为有限正整数并与所选 TTS model 兼容，越高通常音频字节更多，但不控制播放设备采样率。
+         * English: Requested TTS PCM sample rate in Hz; when provided it must be a finite positive integer supported by the selected TTS model, and higher rates usually increase audio bytes without controlling the playback device rate.
          * @defaultValue 16000
-         * @remarks Must be a finite positive integer when provided. This controls synthesis output, not the playback device sample rate.
+         * @remarks Must be a finite positive integer supported by the selected model when provided. This controls synthesis output, not the playback device sample rate.
          */
         sampleRate?: number;
     };
-    /** Managed large-language-model configuration. */
+    /** 控制回复生成使用的 LLM model 和生成参数；必填。 English: Controls the LLM model and generation parameters used for replies; required. */
     llm: {
-        /** Gateway LLM model identifier forwarded as the wire `model` field. */
+        /** 透传为 wire `model` 的非解释 LLM model ID；可用目录由模型平台决定，见 README 外部配置参考。 English: Opaque LLM model ID forwarded as wire `model`; availability is model-platform-owned, so see the README external references. */
         model: string;
-        /** Optional sampling temperature forwarded to the selected LLM. */
+        /** 可选 sampling temperature，原样透传；通常越大输出越随机，但准确范围/默认/方向由 model 决定，见 README。 English: Optional sampling temperature forwarded unchanged; larger commonly increases randomness, while exact range/default/semantics are model-specific. */
         temperature?: number;
-        /** Optional maximum generated token count forwarded as `max_tokens`. */
+        /** 兼容旧调用的最终回答 token 上限，不包含思维链；原样透传为 `max_tokens`。新代码请使用 `maxCompletionTokens`；模型支持情况与值域见 README 外部配置参考的 Chat Completions 部分。 English: Compatibility field for maximum final-answer tokens excluding reasoning content, forwarded as `max_tokens`. New code should use `maxCompletionTokens`; see the Chat Completions section linked from README external configuration references for model support and ranges. */
         maxTokens?: number;
+        /** 新代码首选的完整模型输出 token 上限，包含思维链与最终回答；原样透传为 `max_completion_tokens`，适用于思考和非思考 model，与 `maxTokens` 同时提供时本字段优先。模型支持情况与值域见 README 外部配置参考的 Chat Completions 部分。 English: Preferred token limit for new code, covering complete model output including reasoning and final answer; forwarded as `max_completion_tokens` for reasoning and non-reasoning models and takes precedence over `maxTokens`. See the Chat Completions section linked from README external configuration references for model support and ranges. */
+        maxCompletionTokens?: number;
         /**
-         * Optional JSON-compatible model parameters forwarded as top-level Gateway request fields.
+         * 可选的 JSON-compatible model 参数，作为 Gateway 顶层字段透传；构造时复制并拒绝 SDK reserved keys，模型专属 key/范围见 README。
+         * English: Optional JSON-compatible model parameters forwarded as top-level Gateway fields; copied at construction with SDK reserved keys rejected, while model-specific keys/ranges belong in the README external references.
          * @remarks The SDK snapshots this object during construction. SDK-owned request fields are
          * reserved and cannot be supplied here.
          */
         readonly extraParameters?: JsonObject;
     };
     /**
-     * Optional local Silero voice-activity-detection tuning.
+     * 可选的本地 Silero VAD 调音；配置 audio input 时必需，且仅在构造时生效。
+     * English: Optional local Silero VAD tuning; required with audio input and applied only at construction.
      * @remarks Required when `transports.input` is configured.
      */
     vad?: {
         /**
-         * Speech probability threshold used to enter the speaking state.
+         * 进入 speaking 状态的语音概率阈值，范围 `(0, 1]`；越大越不易把噪声判为语音，但更可能漏掉弱语音。
+         * English: Speech-probability threshold in `(0, 1]`; larger values reduce noise admissions but may miss quiet speech.
          * @defaultValue 0.5
          * @remarks Must be greater than 0 and less than or equal to 1.
          */
         sensitivity?: number;
         /**
-         * Continuous silence required before speech is considered stopped, in milliseconds.
+         * 判定 speech stopped 前所需的连续静音时长，单位毫秒；必须为有限正数，越大越不易过早截断，但结束延迟更高。
+         * English: Continuous silence in milliseconds before speech stops; it must be finite and positive, and larger values reduce early cutoff at the cost of end latency.
          * @defaultValue 200
          * @remarks Must be finite and greater than 0. The Silero stage rounds up to 32 ms frames.
          */
@@ -634,9 +662,11 @@ export type AgentEvent = SpeechStartedEvent | ImageCapturedEvent | SpeechStopped
 export type AgentEventListener = (event: AgentEvent) => void;
 /** Idempotent function that removes one event listener. */
 export type Unsubscribe = () => void;
-/** Optional identity and caller metadata for one manual-text turn. */
+/** 一次手动文本 turn 的可选 identity 与 caller metadata。 English: Optional identity and caller metadata for one manual-text turn. */
 export interface SubmitTextOptions {
+    /** 可选 turn ID；省略时由 SDK 生成，调用方应在自己的工作流内保持唯一。 English: Optional turn ID; the SDK generates one when omitted, and callers should keep supplied IDs unique within their workflow. */
     readonly turnId?: string;
+    /** 当前 turn 的 JSON-compatible metadata；在 public boundary 递归复制，非法或循环值被拒绝。 English: JSON-compatible metadata for this turn; deep-cloned at the public boundary with invalid or cyclic values rejected. */
     readonly metadata?: JsonObject;
 }
 /** Minimal public control and observation surface for one dialogue session. */
@@ -667,5 +697,10 @@ export interface EvaVoiceDialogueAgent {
     onEvent(listener: AgentEventListener): Unsubscribe;
     stop(): Promise<void>;
 }
+/**
+ * 以固定 Gateway stages 和构造期配置创建一个 EVA voice-dialogue agent；配置会在任何 provider 工作前校验并快照。
+ * English: Creates an EVA voice-dialogue agent with fixed Gateway stages; configuration is validated and snapshotted before provider work.
+ * @param config - 必填的公开托管配置；包括凭证、ASR/LLM/TTS 选择和运行级行为。 English: Required managed public configuration containing credentials, ASR/LLM/TTS selections, and runtime behavior.
+ */
 export declare function createEvaVoiceDialogueAgent(config: EvaVoiceDialogueAgentConfig): EvaVoiceDialogueAgent;
 export {};