@wildix/wilma-agents-client 1.0.18 → 1.0.24

package/dist-types/commands/UpdateAgentCommand.d.ts

@@ -44,6 +44,61 @@ declare const UpdateAgentCommand_base: {
  *   channels: { // AgentChannels
  *     voice: { // VoiceChannelSettings
  *       greeting: "STRING_VALUE",
+ *       backgroundSound: "STRING_VALUE",
+ *       speech: { // VoiceSpeechSettings
+ *         provider: "elevenlabs" || "google" || "amazon_polly", // required
+ *         languages: [ // VoiceLanguageList // required
+ *           { // VoiceLanguage
+ *             code: "STRING_VALUE", // required
+ *             provider: "elevenlabs" || "google" || "amazon_polly",
+ *             voice: "STRING_VALUE", // required
+ *             greeting: "STRING_VALUE",
+ *             isDefault: true || false,
+ *             instructions: "STRING_VALUE",
+ *             synthesis: { // VoiceSynthesisOptions
+ *               model: "STRING_VALUE",
+ *               speed: Number("float"),
+ *               stability: Number("float"),
+ *               similarity: Number("float"),
+ *               style: Number("float"),
+ *               speakerBoost: true || false,
+ *               pitch: Number("float"),
+ *               volumeGain: Number("float"),
+ *             },
+ *             credential: { // SecretRef
+ *               id: "STRING_VALUE", // required
+ *             },
+ *             pronunciations: [ // VoicePronunciationList
+ *               { // VoicePronunciation
+ *                 phrase: "STRING_VALUE", // required
+ *                 as: "STRING_VALUE", // required
+ *                 encoding: "alias" || "ipa",
+ *               },
+ *             ],
+ *             pronunciationSuppressions: [ // VoicePronunciationSuppressionList
+ *               "STRING_VALUE",
+ *             ],
+ *           },
+ *         ],
+ *         autoDetect: true || false,
+ *         greetEveryLanguage: true || false,
+ *         transcription: { // VoiceTranscriptionSettings
+ *           vendor: "aws", // required
+ *         },
+ *         synthesis: {
+ *           model: "STRING_VALUE",
+ *           speed: Number("float"),
+ *           stability: Number("float"),
+ *           similarity: Number("float"),
+ *           style: Number("float"),
+ *           speakerBoost: true || false,
+ *           pitch: Number("float"),
+ *           volumeGain: Number("float"),
+ *         },
+ *         credential: {
+ *           id: "STRING_VALUE", // required
+ *         },
+ *       },
  *       interruptions: { // VoiceInterruptionSettings
  *         enabled: true || false, // required
  *         minWords: Number("int"),
@@ -370,9 +425,7 @@ declare const UpdateAgentCommand_base: {
  *     sqs: { // AgentSqsEngine
  *       url: "STRING_VALUE", // required
  *       key: "STRING_VALUE", // required
- *       secret: { // SecretRef
- *         id: "STRING_VALUE", // required
- *       },
+ *       secret: "<SecretRef>", // required
  *     },
  *   },
  *   settings: { // AgentSettings
@@ -394,6 +447,61 @@ declare const UpdateAgentCommand_base: {
  * //     channels: { // AgentChannels
  * //       voice: { // VoiceChannelSettings
  * //         greeting: "STRING_VALUE",
+ * //         backgroundSound: "STRING_VALUE",
+ * //         speech: { // VoiceSpeechSettings
+ * //           provider: "elevenlabs" || "google" || "amazon_polly", // required
+ * //           languages: [ // VoiceLanguageList // required
+ * //             { // VoiceLanguage
+ * //               code: "STRING_VALUE", // required
+ * //               provider: "elevenlabs" || "google" || "amazon_polly",
+ * //               voice: "STRING_VALUE", // required
+ * //               greeting: "STRING_VALUE",
+ * //               isDefault: true || false,
+ * //               instructions: "STRING_VALUE",
+ * //               synthesis: { // VoiceSynthesisOptions
+ * //                 model: "STRING_VALUE",
+ * //                 speed: Number("float"),
+ * //                 stability: Number("float"),
+ * //                 similarity: Number("float"),
+ * //                 style: Number("float"),
+ * //                 speakerBoost: true || false,
+ * //                 pitch: Number("float"),
+ * //                 volumeGain: Number("float"),
+ * //               },
+ * //               credential: { // SecretRef
+ * //                 id: "STRING_VALUE", // required
+ * //               },
+ * //               pronunciations: [ // VoicePronunciationList
+ * //                 { // VoicePronunciation
+ * //                   phrase: "STRING_VALUE", // required
+ * //                   as: "STRING_VALUE", // required
+ * //                   encoding: "alias" || "ipa",
+ * //                 },
+ * //               ],
+ * //               pronunciationSuppressions: [ // VoicePronunciationSuppressionList
+ * //                 "STRING_VALUE",
+ * //               ],
+ * //             },
+ * //           ],
+ * //           autoDetect: true || false,
+ * //           greetEveryLanguage: true || false,
+ * //           transcription: { // VoiceTranscriptionSettings
+ * //             vendor: "aws", // required
+ * //           },
+ * //           synthesis: {
+ * //             model: "STRING_VALUE",
+ * //             speed: Number("float"),
+ * //             stability: Number("float"),
+ * //             similarity: Number("float"),
+ * //             style: Number("float"),
+ * //             speakerBoost: true || false,
+ * //             pitch: Number("float"),
+ * //             volumeGain: Number("float"),
+ * //           },
+ * //           credential: {
+ * //             id: "STRING_VALUE", // required
+ * //           },
+ * //         },
  * //         interruptions: { // VoiceInterruptionSettings
  * //           enabled: true || false, // required
  * //           minWords: Number("int"),
@@ -720,9 +828,7 @@ declare const UpdateAgentCommand_base: {
  * //       sqs: { // AgentSqsEngine
  * //         url: "STRING_VALUE", // required
  * //         key: "STRING_VALUE", // required
- * //         secret: { // SecretRef
- * //           id: "STRING_VALUE", // required
- * //         },
+ * //         secret: "<SecretRef>", // required
  * //       },
  * //     },
  * //     settings: { // AgentSettings

package/dist-types/commands/index.d.ts

@@ -3,6 +3,7 @@ export * from "./CreateAgentApiKeyCommand";
 export * from "./CreateAgentCommand";
 export * from "./DeleteAgentApiKeyCommand";
 export * from "./DeleteAgentCommand";
+export * from "./DeletePronunciationDictionaryCommand";
 export * from "./GetAgentCommand";
 export * from "./GetAgentDeploymentCommand";
 export * from "./GetAgentVersionCommand";
@@ -10,8 +11,10 @@ export * from "./ListAgentApiKeysCommand";
 export * from "./ListAgentVersionsCommand";
 export * from "./ListAgentsCommand";
 export * from "./ListAgentsNamesCommand";
+export * from "./ListPronunciationDictionariesCommand";
 export * from "./PublishAgentVersionCommand";
 export * from "./PutAgentDeploymentCommand";
+export * from "./PutPronunciationDictionaryCommand";
 export * from "./ResetAgentDeploymentCommand";
 export * from "./RestoreAgentVersionToDraftCommand";
 export * from "./UpdateAgentCommand";

package/dist-types/models/enums.d.ts

@@ -16,6 +16,48 @@ export declare const AgentVisibility: {
  * @public
  */
 export type AgentVisibility = (typeof AgentVisibility)[keyof typeof AgentVisibility];
+/**
+ * @public
+ * @enum
+ */
+export declare const VoicePronunciationEncoding: {
+    /**
+     * A respelling substituted into the text before it reaches the provider. The only encoding version 1 applies.
+     */
+    readonly ALIAS: "alias";
+    /**
+     * Phonetic transcription. Declared so IPA can be enabled per provider later; ignored by the runtime today.
+     */
+    readonly IPA: "ipa";
+};
+/**
+ * @public
+ */
+export type VoicePronunciationEncoding = (typeof VoicePronunciationEncoding)[keyof typeof VoicePronunciationEncoding];
+/**
+ * @public
+ * @enum
+ */
+export declare const VoiceSpeechProvider: {
+    readonly AMAZON_POLLY: "amazon_polly";
+    readonly ELEVENLABS: "elevenlabs";
+    readonly GOOGLE: "google";
+};
+/**
+ * @public
+ */
+export type VoiceSpeechProvider = (typeof VoiceSpeechProvider)[keyof typeof VoiceSpeechProvider];
+/**
+ * @public
+ * @enum
+ */
+export declare const VoiceTranscriptionVendor: {
+    readonly AWS: "aws";
+};
+/**
+ * @public
+ */
+export type VoiceTranscriptionVendor = (typeof VoiceTranscriptionVendor)[keyof typeof VoiceTranscriptionVendor];
 /**
  * @public
  * @enum

package/dist-types/models/models_0.d.ts

@@ -1,5 +1,5 @@
 import type { DocumentType as __DocumentType } from "@smithy/types";
-import type { ActorType, AgentHandoverPipelineType, AgentHandoverVariant, AgentHangupPipelineType, AgentStatus, AgentToolPipelineType, AgentTransferPipelineType, AgentTransferVariant, AgentVariableType, AgentVisibility, ChannelType, SandboxNetworkAccess, SandboxSize, WebSearchContextSize } from "./enums";
+import type { ActorType, AgentHandoverPipelineType, AgentHandoverVariant, AgentHangupPipelineType, AgentStatus, AgentToolPipelineType, AgentTransferPipelineType, AgentTransferVariant, AgentVariableType, AgentVisibility, ChannelType, SandboxNetworkAccess, SandboxSize, VoicePronunciationEncoding, VoiceSpeechProvider, VoiceTranscriptionVendor, WebSearchContextSize } from "./enums";
 /**
  * A user or group that access is granted to.
  * @public
@@ -218,6 +218,255 @@ export interface VoiceSilenceTimeoutSettings {
     seconds: number;
     action: VoiceTerminateAction;
 }
+/**
+ * A reference to a stored secret, held by other services in place of the value.
+ * Resolved server-to-server via GetSecretValue at execution time — always to the current value.
+ * @public
+ */
+export interface SecretRef {
+    /**
+     * Unique identifier of a secret.
+     * @public
+     */
+    id: string;
+}
+/**
+ * A pronunciation rule for one phrase. Belongs to a LANGUAGE, not to the agent: 'Wildix' is
+ *     respelled differently for an Italian and a German voice. A dictionary shared ACROSS languages
+ *     would fight itself, which is why the company dictionary is keyed by language too — see
+ *     PronunciationDictionary.
+ * @public
+ */
+export interface VoicePronunciation {
+    /**
+     * The phrase as it appears in the text, e.g. 'Wildix'. Bounded because every rule is compiled into ONE regular expression — see the list below.
+     * @public
+     */
+    phrase: string;
+    /**
+     * Respelling (ALIAS) or phonetic transcription (IPA), e.g. 'Wil-dix'.
+     * @public
+     */
+    as: string;
+    /**
+     * Defaults to ALIAS.
+     * @public
+     */
+    encoding?: VoicePronunciationEncoding | undefined;
+}
+/**
+ * Synthesis options, used at two levels: as provider-level defaults on VoiceSpeechSettings and as
+ *     per-language overrides on VoiceLanguage. Absent means inherit; there is no way to express
+ *     'explicitly the same as the parent', which is the intended simplification — the merged result is
+ *     identical either way. Which members apply is a property of the provider AND the model (Chirp 3:
+ *     HD documents only speakingRate; eleven_v3 carries no stability, similarity or speaker boost), so
+ *     the console renders them from a catalog rather than unconditionally.
+ * @public
+ */
+export interface VoiceSynthesisOptions {
+    /**
+     * Provider model id, e.g. 'eleven_flash_v2_5'.
+     * @public
+     */
+    model?: string | undefined;
+    /**
+     * Speaking rate. ElevenLabs 0.7-1.2 (default 1.0); Google 0.25-2.0 (default 1.0).
+     * @public
+     */
+    speed?: number | undefined;
+    /**
+     * ElevenLabs stability, 0-1 (default 0.5). Our clamp, not a vendor-stated bound.
+     * @public
+     */
+    stability?: number | undefined;
+    /**
+     * ElevenLabs similarity boost, 0-1 (default 0.75). Our clamp.
+     * @public
+     */
+    similarity?: number | undefined;
+    /**
+     * ElevenLabs style exaggeration, 0-1 (default 0). Our clamp.
+     * @public
+     */
+    style?: number | undefined;
+    /**
+     * ElevenLabs speaker boost (default true).
+     * @public
+     */
+    speakerBoost?: boolean | undefined;
+    /**
+     * Google pitch in semitones, -20 to 20. Not offered for Chirp 3: HD voices.
+     * @public
+     */
+    pitch?: number | undefined;
+    /**
+     * Google volume gain in dB, -96 to 16 (default 0); the vendor recommends staying under +10. Not offered for Chirp 3: HD voices.
+     * @public
+     */
+    volumeGain?: number | undefined;
+}
+/**
+ * One configured language: its voice, its initial phrase and its overrides.
+ * @public
+ */
+export interface VoiceLanguage {
+    /**
+     * BCP-47 code with locale, e.g. 'en-US', 'it-IT'.
+     * @public
+     */
+    code: string;
+    /**
+     * Text-to-speech provider for THIS language. Absent falls back to
+     *         VoiceSpeechSettings.provider, which is what records written before this member
+     *         existed rely on. The console writes it on every language it creates.
+     *
+     *         Per language rather than per bot because provider quality is not uniform across
+     *         languages, and because a single bot-wide provider made changing it invalidate
+     *         every configured voice at once: a voice id belongs to one provider, so switching
+     *         the bot meant reselecting a speaker for every language.
+     * @public
+     */
+    provider?: VoiceSpeechProvider | undefined;
+    /**
+     * Provider voice id (ElevenLabs voice_id, Google voice name, Polly Id).
+     *   A CR OR LF IS REFUSED BY THE PATTERN, and the reason is not tidiness: this value reaches the
+     *   PBX as an AMI action parameter, and AMI frames on CRLF, so a newline inside it closes the
+     *   action and starts another one on a local, already-authenticated manager connection. Whoever
+     *   configures a voice agent in the cloud needs no PBX credential, so the model is the first place
+     *   that can refuse it. `pbx-data-engine` refuses it again on the send path — two layers, because
+     *   the AMI serializer is out of tree and neither layer can promise the other's behaviour.
+     * @public
+     */
+    voice: string;
+    /**
+     * Initial phrase spoken when the call starts in this language. Absent or empty means
+     *         the agent says nothing and waits — it does NOT fall back to VoiceChannelSettings.greeting,
+     *         which would speak one language's text in another language's voice.
+     * @public
+     */
+    greeting?: string | undefined;
+    /**
+     * Marks the language a caller hears when their own matches nothing configured.
+     *
+     *         THE FULL RESOLUTION ORDER, since a client author reading only this contract cannot
+     *         otherwise find it: an exact match on the call's language, then a match on its primary
+     *         subtag (`fr` finds `fr-FR`), then the language marked here, then a language whose
+     *         primary subtag is `en`, then the first entry in the list.
+     *
+     *         Marked is consulted BEFORE the English step, so a record with none marked resolves
+     *         exactly as it did before this member existed. English is deliberate rather than
+     *         arbitrary — it is the language a caller the agent was not built for is likeliest to
+     *         understand — and the last step exists only to keep the rule total, which is why list
+     *         order should not be treated as configuration.
+     *
+     *         At most one language may carry it. A record with two — reachable through the API or
+     *         the CLI, where no form prevents it — resolves to the first marked one in list order,
+     *         because refusing a call over configuration drift is worse than serving it and saying
+     *         so in the trace.
+     * @public
+     */
+    isDefault?: boolean | undefined;
+    /**
+     * Extra instructions active only while the conversation runs in this language.
+     * @public
+     */
+    instructions?: string | undefined;
+    /**
+     * Overrides VoiceSpeechSettings.synthesis member by member.
+     * @public
+     */
+    synthesis?: VoiceSynthesisOptions | undefined;
+    /**
+     * The company's own credential for THIS language's provider (secret variant
+     *         `auth_bearer`). Absent falls back to VoiceSpeechSettings.credential, then to the
+     *         platform key.
+     *
+     *         It lives beside the provider because a credential belongs to one: a company's
+     *         ElevenLabs key cannot serve a language synthesized by Google, and a single
+     *         bot-wide credential would have been silently inapplicable to some languages.
+     * @public
+     */
+    credential?: SecretRef | undefined;
+    /**
+     * This agent's OWN rules for this language. A rule whose phrase also exists in the
+     *         company dictionary replaces it; a rule whose phrase does not is simply an addition —
+     *         the two are the same member because they are the same act.
+     * @public
+     */
+    pronunciations?: VoicePronunciation[] | undefined;
+    /**
+     * Company-dictionary phrases this agent declines. See VoicePronunciationSuppressionList.
+     * @public
+     */
+    pronunciationSuppressions?: string[] | undefined;
+}
+/**
+ * Speech-to-text configuration. Vendor-specific recognition options — term hints, custom
+ *     vocabulary — land here alongside the vendors that take them; nothing writes them today.
+ * @public
+ */
+export interface VoiceTranscriptionSettings {
+    /**
+     * Recognition vendor. Absent resolves to the platform default (`aws` today), resolved by the server so exactly one component decides it.
+     * @public
+     */
+    vendor: VoiceTranscriptionVendor;
+}
+/**
+ * Speech configuration for the voice channel. When present it WINS over the dialplan's `voice` and
+ *     `initialMessage` connect parameters; `language` is the single exception, because it is the
+ *     channel's own input signal and the feature has no starting point without it.
+ * @public
+ */
+export interface VoiceSpeechSettings {
+    /**
+     * DEFAULT text-to-speech provider, used by a language that names none of its own.
+     *         Still required, so a record always answers 'which provider' — but the console now
+     *         writes `provider` on every language, so this is what pre-existing records and API
+     *         callers fall back to rather than the primary control.
+     * @public
+     */
+    provider: VoiceSpeechProvider;
+    /**
+     * Configured languages. The @length bound is a STORAGE ceiling, not the product rule: the real
+     *         cap is the selected transcription vendor's `maxCandidates` (five for Amazon Transcribe),
+     *         enforced in the service from its catalog so a vendor with a different limit needs no model
+     *         change.
+     * @public
+     */
+    languages: VoiceLanguage[];
+    /**
+     * Identify the caller's language automatically and switch voice and reply language mid-call. Requires at least two languages and a vendor that can identify languages; the server clamps it to false otherwise.
+     * @public
+     */
+    autoDetect?: boolean | undefined;
+    /**
+     * Speak the first message of every configured language in turn when the call is answered, each
+     *         in the voice, provider account and pronunciation rules of its own language, instead of only the
+     *         language the call resolved to. Languages whose first message is empty, and languages the PBX
+     *         synthesizes itself, are skipped. Absent means off. Requires at least two languages carrying a
+     *         first message; below that the runtime speaks only the resolved language's phrase, and the
+     *         console clamps the member on save.
+     * @public
+     */
+    greetEveryLanguage?: boolean | undefined;
+    /**
+     * Speech-to-text configuration. Vendor-specific recognition options — term hints, custom
+     *     vocabulary — land here alongside the vendors that take them; nothing writes them today.
+     * @public
+     */
+    transcription?: VoiceTranscriptionSettings | undefined;
+    /**
+     * Provider-level synthesis defaults, inherited by every language.
+     * @public
+     */
+    synthesis?: VoiceSynthesisOptions | undefined;
+    /**
+     * The company's own provider credential (secret variant `auth_bearer`). Absent means the platform key. Has no counterpart in wim-voicebots — a deliberate parity gap.
+     * @public
+     */
+    credential?: SecretRef | undefined;
+}
 /**
  * Voice channel settings. Note: a voice agent's AgentAccess.grants are ignored — inbound calls are routed by the PBX dialplan and data ACL is the agent-level `settings.pbxGroupId`, not per-user grants.
  * @public
@@ -228,6 +477,25 @@ export interface VoiceChannelSettings {
      * @public
      */
     greeting?: string | undefined;
+    /**
+     * Ambient background played under the call, as a music-on-hold class name.
+     *
+     *         ABSENT MEANS OFF. There is no value meaning 'none': the member is simply not sent, which is
+     *         exactly the state every call was in before this setting existed, so a bot that never touches
+     *         it behaves as it always did and the PBX needs no new case.
+     *
+     *         It belongs to the CHANNEL rather than to `speech`, even though the console shows the control
+     *         under the automatic-language switch. `speech` is the recognition and synthesis
+     *         configuration and is sent only when languages are configured — background audio has nothing
+     *         to do with either, and a bot with no languages must still be able to have it.
+     * @public
+     */
+    backgroundSound?: string | undefined;
+    /**
+     * Provider, languages, voices, initial phrases and pronunciation. Absent means the legacy behavior: voice URI from the dialplan connect parameter, one voice, language as prompt context only.
+     * @public
+     */
+    speech?: VoiceSpeechSettings | undefined;
     interruptions?: VoiceInterruptionSettings | undefined;
     silenceTimeout?: VoiceSilenceTimeoutSettings | undefined;
     maxDuration?: VoiceMaxDurationSettings | undefined;
@@ -1391,18 +1659,6 @@ export interface AgentAiEngine {
     capabilities?: AgentCapability[] | undefined;
     variables?: AgentVariable[] | undefined;
 }
-/**
- * A reference to a stored secret, held by other services in place of the value.
- * Resolved server-to-server via GetSecretValue at execution time — always to the current value.
- * @public
- */
-export interface SecretRef {
-    /**
-     * Unique identifier of a secret.
-     * @public
-     */
-    id: string;
-}
 /**
  * Bring-your-own backend over SQS: turns are forwarded to the queue, replies are posted back via the API.
  * @public
@@ -1668,6 +1924,11 @@ export interface AgentInfo {
      * @public
      */
     channels: ChannelType[];
+    /**
+     * Whether the agent's voice channel has at least one configured speech language. A dialplan form partitions its application lists on this, so the answer has to travel with the list rather than cost one lookup per entry. Absent is read as false.
+     * @public
+     */
+    speechConfigured?: boolean | undefined;
     /**
      * Published agent version number. Monotonic within an agent's version history, starting at 1.
      * @public
@@ -1902,6 +2163,25 @@ export interface DeleteAgentApiKeyInput {
  */
 export interface DeleteAgentApiKeyOutput {
 }
+/**
+ * @public
+ */
+export interface DeletePronunciationDictionaryInput {
+    company?: string | undefined;
+    /**
+     * BCP-47 language tag, optionally with a region subtag: 'en', 'en-US', 'pt-BR'. Deliberately a
+     *     constrained string rather than an enum: the offerable set is a property of the selected
+     *     transcription vendor and changes with it, so an enumeration here would cap the set at whatever
+     *     was known when the model was released.
+     * @public
+     */
+    code: string;
+}
+/**
+ * @public
+ */
+export interface DeletePronunciationDictionaryOutput {
+}
 /**
  * @public
  */
@@ -2042,6 +2322,57 @@ export interface ListAgentVersionsOutput {
      */
     nextCursor?: string | undefined;
 }
+/**
+ * @public
+ */
+export interface ListPronunciationDictionariesInput {
+    company?: string | undefined;
+}
+/**
+ * Every pronunciation rule a company has written for one language.
+ * @public
+ */
+export interface PronunciationDictionary {
+    id: string;
+    /**
+     * BCP-47 code with locale, e.g. 'en-US'. Unique per company — this is the link.
+     * @public
+     */
+    code: string;
+    /**
+     * Pronunciation rules for one language.
+     *
+     *     BOUNDED, and the bound is not decoration. Both runtimes compile every rule of a language into
+     *     a SINGLE alternating regular expression, so the cost is the pattern's total size: measured
+     *     against the real escaping and matching logic, 1,000 rules cost ~0.9 s of CPU per synthesized
+     *     sentence, 5,000 cost ~4.9 s, and around 10,000 `new RegExp` throws V8's pattern-size error.
+     *
+     *     200 is far above any real use — a product glossary is a handful of names — and far below where
+     *     either cost begins. Found by a security review.
+     *     NO LOWER BOUND on `phrase` or `as`, deliberately. Both consoles add an EMPTY rule row the
+     *     moment someone clicks 'Add pronunciation', so a `min: 1` would make saving an agent with a
+     *     half-typed row fail entirely — and the runtime already ignores a rule with no phrase. Dropping
+     *     blank rows belongs in the consoles' save filters, not in a refusal here.
+     * @public
+     */
+    rules: VoicePronunciation[];
+    /**
+     * ISO-8601 timestamp with millisecond precision, e.g. '2026-07-10T14:12:30.123Z'.
+     * @public
+     */
+    updatedAt: string;
+    /**
+     * Who performed an action: an interactive user, an API key or an internal service.
+     * @public
+     */
+    updatedBy: Actor;
+}
+/**
+ * @public
+ */
+export interface ListPronunciationDictionariesOutput {
+    dictionaries: PronunciationDictionary[];
+}
 /**
  * @public
  */
@@ -2092,6 +2423,47 @@ export interface PutAgentDeploymentOutput {
      */
     deployment: AgentDeploymentRoute[];
 }
+/**
+ * @public
+ */
+export interface PutPronunciationDictionaryInput {
+    company?: string | undefined;
+    /**
+     * BCP-47 language tag, optionally with a region subtag: 'en', 'en-US', 'pt-BR'. Deliberately a
+     *     constrained string rather than an enum: the offerable set is a property of the selected
+     *     transcription vendor and changes with it, so an enumeration here would cap the set at whatever
+     *     was known when the model was released.
+     * @public
+     */
+    code: string;
+    /**
+     * Pronunciation rules for one language.
+     *
+     *     BOUNDED, and the bound is not decoration. Both runtimes compile every rule of a language into
+     *     a SINGLE alternating regular expression, so the cost is the pattern's total size: measured
+     *     against the real escaping and matching logic, 1,000 rules cost ~0.9 s of CPU per synthesized
+     *     sentence, 5,000 cost ~4.9 s, and around 10,000 `new RegExp` throws V8's pattern-size error.
+     *
+     *     200 is far above any real use — a product glossary is a handful of names — and far below where
+     *     either cost begins. Found by a security review.
+     *     NO LOWER BOUND on `phrase` or `as`, deliberately. Both consoles add an EMPTY rule row the
+     *     moment someone clicks 'Add pronunciation', so a `min: 1` would make saving an agent with a
+     *     half-typed row fail entirely — and the runtime already ignores a rule with no phrase. Dropping
+     *     blank rows belongs in the consoles' save filters, not in a refusal here.
+     * @public
+     */
+    rules: VoicePronunciation[];
+}
+/**
+ * @public
+ */
+export interface PutPronunciationDictionaryOutput {
+    /**
+     * Every pronunciation rule a company has written for one language.
+     * @public
+     */
+    dictionary: PronunciationDictionary;
+}
 /**
  * @public
  */