@wildix/wilma-agents-client 1.0.22 → 1.0.25

package/dist-cjs/schemas/schemas_0.js

@@ -217,6 +217,7 @@ const _dict = "dictionary";
 const _e = "error";
 const _eA = "expiresAt";
 const _eC = "endCall";
+const _eUA = "expectedUpdatedAt";
 const _en = "engine";
 const _ena = "enabled";
 const _enc = "encoding";
@@ -750,13 +751,13 @@ exports.ListAgentVersionsOutput$ = [3, n2, _LAVO,
 ];
 exports.ListPronunciationDictionariesInput$ = [3, n2, _LPDI,
     0,
-    [_com],
-    [[0, { [_hQ]: _com }]]
+    [_com, _l, _cu],
+    [[0, { [_hQ]: _com }], [1, { [_hQ]: _l }], [0, { [_hQ]: _cu }]]
 ];
 exports.ListPronunciationDictionariesOutput$ = [3, n2, _LPDO,
     0,
-    [_dic],
-    [() => PronunciationDictionaryList], 1
+    [_dic, _nC],
+    [() => PronunciationDictionaryList, 0], 1
 ];
 exports.PronunciationDictionary$ = [3, n2, _PD,
     0,
@@ -785,8 +786,8 @@ exports.PutAgentDeploymentOutput$ = [3, n2, _PADO,
 ];
 exports.PutPronunciationDictionaryInput$ = [3, n2, _PPDI,
     0,
-    [_cod, _ru, _com],
-    [[0, 1], () => VoicePronunciationList, [0, { [_hQ]: _com }]], 2
+    [_cod, _ru, _com, _eUA],
+    [[0, 1], () => VoicePronunciationList, [0, { [_hQ]: _com }], 0], 2
 ];
 exports.PutPronunciationDictionaryOutput$ = [3, n2, _PPDO,
     0,
@@ -881,7 +882,7 @@ exports.VoiceTerminateHangupAction$ = [3, n2, _VTHA,
 exports.VoiceTranscriptionSettings$ = [3, n2, _VTS,
     0,
     [_ven],
-    [0], 1
+    [0]
 ];
 exports.VoiceTransferTarget$ = [3, n2, _VTT,
     0,

package/dist-es/schemas/schemas_0.js

@@ -212,6 +212,7 @@ const _dict = "dictionary";
 const _e = "error";
 const _eA = "expiresAt";
 const _eC = "endCall";
+const _eUA = "expectedUpdatedAt";
 const _en = "engine";
 const _ena = "enabled";
 const _enc = "encoding";
@@ -745,13 +746,13 @@ export var ListAgentVersionsOutput$ = [3, n2, _LAVO,
 ];
 export var ListPronunciationDictionariesInput$ = [3, n2, _LPDI,
     0,
-    [_com],
-    [[0, { [_hQ]: _com }]]
+    [_com, _l, _cu],
+    [[0, { [_hQ]: _com }], [1, { [_hQ]: _l }], [0, { [_hQ]: _cu }]]
 ];
 export var ListPronunciationDictionariesOutput$ = [3, n2, _LPDO,
     0,
-    [_dic],
-    [() => PronunciationDictionaryList], 1
+    [_dic, _nC],
+    [() => PronunciationDictionaryList, 0], 1
 ];
 export var PronunciationDictionary$ = [3, n2, _PD,
     0,
@@ -780,8 +781,8 @@ export var PutAgentDeploymentOutput$ = [3, n2, _PADO,
 ];
 export var PutPronunciationDictionaryInput$ = [3, n2, _PPDI,
     0,
-    [_cod, _ru, _com],
-    [[0, 1], () => VoicePronunciationList, [0, { [_hQ]: _com }]], 2
+    [_cod, _ru, _com, _eUA],
+    [[0, 1], () => VoicePronunciationList, [0, { [_hQ]: _com }], 0], 2
 ];
 export var PutPronunciationDictionaryOutput$ = [3, n2, _PPDO,
     0,
@@ -876,7 +877,7 @@ export var VoiceTerminateHangupAction$ = [3, n2, _VTHA,
 export var VoiceTranscriptionSettings$ = [3, n2, _VTS,
     0,
     [_ven],
-    [0], 1
+    [0]
 ];
 export var VoiceTransferTarget$ = [3, n2, _VTT,
     0,

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

@@ -83,7 +83,7 @@ declare const CreateAgentCommand_base: {
  *         autoDetect: true || false,
  *         greetEveryLanguage: true || false,
  *         transcription: { // VoiceTranscriptionSettings
- *           vendor: "aws", // required
+ *           vendor: "aws",
  *         },
  *         synthesis: {
  *           model: "STRING_VALUE",
@@ -484,7 +484,7 @@ declare const CreateAgentCommand_base: {
  * //           autoDetect: true || false,
  * //           greetEveryLanguage: true || false,
  * //           transcription: { // VoiceTranscriptionSettings
- * //             vendor: "aws", // required
+ * //             vendor: "aws",
  * //           },
  * //           synthesis: {
  * //             model: "STRING_VALUE",

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

@@ -29,6 +29,12 @@ declare const DeletePronunciationDictionaryCommand_base: {
 /**
  * Deletes the dictionary for one language. Agents keep their own rules, and their suppressions
  *     become no-ops rather than errors — the two are edited independently.
+ *
+ *     A LANGUAGE WITH NO DICTIONARY IS A SUCCESS, not a NotFoundException. The operation is
+ *     @idempotent, which is a promise that a retry is safe, and a retried DELETE — the ordinary
+ *     outcome of a timed-out response — would otherwise report failure for a row it had already
+ *     removed. The output is empty either way, so there is nothing a caller could do with the
+ *     distinction; it says the same thing the paragraph above says about suppressions.
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -53,8 +59,6 @@ declare const DeletePronunciationDictionaryCommand_base: {
  * @see {@link DeletePronunciationDictionaryCommandOutput} for command's `response` shape.
  * @see {@link WilmaAgentsClientResolvedConfig | config} for WilmaAgentsClient's `config` shape.
  *
- * @throws {@link NotFoundException} (client fault)
- *
  * @throws {@link ValidationException} (client fault)
  *
  * @throws {@link WilmaAgentsServiceException}

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

@@ -90,7 +90,7 @@ declare const GetAgentCommand_base: {
  * //           autoDetect: true || false,
  * //           greetEveryLanguage: true || false,
  * //           transcription: { // VoiceTranscriptionSettings
- * //             vendor: "aws", // required
+ * //             vendor: "aws",
  * //           },
  * //           synthesis: {
  * //             model: "STRING_VALUE",

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

@@ -97,7 +97,7 @@ declare const GetAgentVersionCommand_base: {
  * //             autoDetect: true || false,
  * //             greetEveryLanguage: true || false,
  * //             transcription: { // VoiceTranscriptionSettings
- * //               vendor: "aws", // required
+ * //               vendor: "aws",
  * //             },
  * //             synthesis: {
  * //               model: "STRING_VALUE",

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

@@ -95,7 +95,7 @@ declare const ListAgentsCommand_base: {
  * //             autoDetect: true || false,
  * //             greetEveryLanguage: true || false,
  * //             transcription: { // VoiceTranscriptionSettings
- * //               vendor: "aws", // required
+ * //               vendor: "aws",
  * //             },
  * //             synthesis: {
  * //               model: "STRING_VALUE",

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

@@ -27,9 +27,13 @@ declare const ListPronunciationDictionariesCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
 };
 /**
- * Lists every pronunciation dictionary of the company. Returns all languages at once: the
- *     management surface shows them together and the set is bounded by the languages a company
- *     actually configures.
+ * Lists the pronunciation dictionaries of the company.
+ *
+ *     PAGINATED LIKE EVERY OTHER LIST IN THIS SERVICE, but with an ABSENT `limit` meaning EVERY
+ *     LANGUAGE — which is what this operation always did, and what the management surface relies on:
+ *     it shows the languages together and the set is bounded by the languages a company actually
+ *     configures. So a caller that sends neither member is unaffected, and one that wants pages opts
+ *     in. `nextCursor` is returned only while there is another page.
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -40,6 +44,8 @@ declare const ListPronunciationDictionariesCommand_base: {
  * const client = new WilmaAgentsClient(config);
  * const input = { // ListPronunciationDictionariesInput
  *   company: "STRING_VALUE",
+ *   limit: Number("int"),
+ *   cursor: "STRING_VALUE",
  * };
  * const command = new ListPronunciationDictionariesCommand(input);
  * const response = await client.send(command);
@@ -63,6 +69,7 @@ declare const ListPronunciationDictionariesCommand_base: {
  * //       },
  * //     },
  * //   ],
+ * //   nextCursor: "STRING_VALUE",
  * // };
  *
  * ```

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

@@ -99,7 +99,7 @@ declare const PublishAgentVersionCommand_base: {
  * //             autoDetect: true || false,
  * //             greetEveryLanguage: true || false,
  * //             transcription: { // VoiceTranscriptionSettings
- * //               vendor: "aws", // required
+ * //               vendor: "aws",
  * //             },
  * //             synthesis: {
  * //               model: "STRING_VALUE",

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

@@ -36,6 +36,11 @@ declare const PutPronunciationDictionaryCommand_base: {
  *     the agents. The dictionary is shared, so a rule added here can overflow an agent nobody
  *     editing it is looking at; truncating silently would drop rules from a running agent with no
  *     signal anywhere.
+ *
+ *     OPTIMISTIC LOCKING via `expectedUpdatedAt`, for the same reason the write is a replace: two
+ *     administrators editing one company dictionary otherwise silently lose one of the two edits,
+ *     and every agent speaking that language loses the missing rules on its next call. Absent means
+ *     last-write-wins, exactly as before this member existed.
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -54,6 +59,7 @@ declare const PutPronunciationDictionaryCommand_base: {
  *       encoding: "alias" || "ipa",
  *     },
  *   ],
+ *   expectedUpdatedAt: "STRING_VALUE",
  * };
  * const command = new PutPronunciationDictionaryCommand(input);
  * const response = await client.send(command);
@@ -85,6 +91,9 @@ declare const PutPronunciationDictionaryCommand_base: {
  * @see {@link PutPronunciationDictionaryCommandOutput} for command's `response` shape.
  * @see {@link WilmaAgentsClientResolvedConfig | config} for WilmaAgentsClient's `config` shape.
  *
+ * @throws {@link RevisionConflictException} (client fault)
+ *  The resource was modified concurrently; re-read it and retry with the latest revision.
+ *
  * @throws {@link ValidationException} (client fault)
  *
  * @throws {@link WilmaAgentsServiceException}

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

@@ -92,7 +92,7 @@ declare const RestoreAgentVersionToDraftCommand_base: {
  * //           autoDetect: true || false,
  * //           greetEveryLanguage: true || false,
  * //           transcription: { // VoiceTranscriptionSettings
- * //             vendor: "aws", // required
+ * //             vendor: "aws",
  * //           },
  * //           synthesis: {
  * //             model: "STRING_VALUE",

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

@@ -83,7 +83,7 @@ declare const UpdateAgentCommand_base: {
  *         autoDetect: true || false,
  *         greetEveryLanguage: true || false,
  *         transcription: { // VoiceTranscriptionSettings
- *           vendor: "aws", // required
+ *           vendor: "aws",
  *         },
  *         synthesis: {
  *           model: "STRING_VALUE",
@@ -486,7 +486,7 @@ declare const UpdateAgentCommand_base: {
  * //           autoDetect: true || false,
  * //           greetEveryLanguage: true || false,
  * //           transcription: { // VoiceTranscriptionSettings
- * //             vendor: "aws", // required
+ * //             vendor: "aws",
  * //           },
  * //           synthesis: {
  * //             model: "STRING_VALUE",

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

@@ -329,6 +329,12 @@ export interface VoiceLanguage {
     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;
@@ -401,10 +407,17 @@ export interface VoiceLanguage {
  */
 export interface VoiceTranscriptionSettings {
     /**
-     * Recognition vendor. Absent resolves to the platform default (`aws` today), resolved by the server so exactly one component decides it.
+     * Recognition vendor. Absent resolves to the platform default (`aws` today), resolved by the
+     *         server so exactly one component decides it.
+     *
+     *         DELIBERATELY NOT @required, and the sentence above is why: the server already answers the
+     *         default for a `transcription` that carries no vendor, and both consoles were written to
+     *         that promise. @required contradicted it — it made the server-side default reachable only
+     *         for a WHOLLY ABSENT `transcription`, and refused a shape this documentation describes as
+     *         legal.
      * @public
      */
-    vendor: VoiceTranscriptionVendor;
+    vendor?: VoiceTranscriptionVendor | undefined;
 }
 /**
  * Speech configuration for the voice channel. When present it WINS over the dialplan's `voice` and
@@ -2321,6 +2334,16 @@ export interface ListAgentVersionsOutput {
  */
 export interface ListPronunciationDictionariesInput {
     company?: string | undefined;
+    /**
+     * Page size. ABSENT MEANS EVERY DICTIONARY — see the operation's documentation.
+     * @public
+     */
+    limit?: number | undefined;
+    /**
+     * Opaque cursor returned by a previous page; pass it back to fetch the next page.
+     * @public
+     */
+    cursor?: string | undefined;
 }
 /**
  * Every pronunciation rule a company has written for one language.
@@ -2366,6 +2389,11 @@ export interface PronunciationDictionary {
  */
 export interface ListPronunciationDictionariesOutput {
     dictionaries: PronunciationDictionary[];
+    /**
+     * Absent on the last page, and always absent when `limit` was not sent — there is then nothing left to continue from.
+     * @public
+     */
+    nextCursor?: string | undefined;
 }
 /**
  * @public
@@ -2447,6 +2475,24 @@ export interface PutPronunciationDictionaryInput {
      * @public
      */
     rules: VoicePronunciation[];
+    /**
+     * Precondition: the `updatedAt` of the dictionary this edit was made against, echoed back
+     *         from the PronunciationDictionary the caller read. When it does not match the stored value
+     *         the write is refused with RevisionConflictException and the caller re-reads rather than
+     *         overwriting an edit it never saw.
+     *
+     *         A TIMESTAMP RATHER THAN AN INTEGER REVISION, unlike UpdateAgent: the dictionary already
+     *         carries `updatedAt` on every read, so the round trip exists today and no stored record
+     *         needs a new field to take part. The meaning is UpdateAgent's meaning — 'based on the
+     *         version I read' — and the error is the same one.
+     *
+     *         OPTIONAL, and ABSENCE MEANS LAST-WRITE-WINS: this operation shipped without a precondition,
+     *         so making it mandatory would break every existing caller for a guarantee they can opt into.
+     *         RevisionConflictException carries no `currentRevision` here — this resource is versioned by
+     *         its timestamp, and the current one is on the dictionary a re-read returns.
+     * @public
+     */
+    expectedUpdatedAt?: string | undefined;
 }
 /**
  * @public

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@wildix/wilma-agents-client",
     "description": "@wildix/wilma-agents-client client",
-    "version": "1.0.22",
+    "version": "1.0.25",
     "scripts": {
         "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
         "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -56,4 +56,4 @@
     "browser": {
         "./dist-es/runtimeConfig": "./dist-es/runtimeConfig.browser"
     }
-}
+}