@wildix/wim-voicebots-client 1.1.8 → 3.1.10

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

@@ -1,46 +1,115 @@
-import { VoiceBotsServiceException as __BaseException } from "./VoiceBotsServiceException";
-import { ExceptionOptionType as __ExceptionOptionType } from "@smithy/smithy-client";
-import { DocumentType as __DocumentType } from "@smithy/types";
+import type { DocumentType as __DocumentType } from "@smithy/types";
+import type { AnnotationSourceType, TraceActivityStatus, TraceSegmentStatus, TraceSessionStatus, VoiceBotCapabilityToolPipelineType, VoiceBotCommandType, VoiceBotEmbeddedToolType, VoiceBotEventType, VoiceBotFunctionIntegrationMethod, VoiceBotToolType } from "./enums";
 /**
+ * Tool result captured for an annotation. Runtime services enforce serialized payload size limits.
  * @public
  */
-export declare class ForbiddenException extends __BaseException {
-    readonly name: "ForbiddenException";
-    readonly $fault: "client";
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<ForbiddenException, __BaseException>);
+export interface AnnotationResultValue {
+    value: __DocumentType;
+}
+/**
+ * Capability variable values captured for an annotation. Runtime services enforce serialized payload size limits.
+ * @public
+ */
+export interface AnnotationVariablesValue {
+    value: __DocumentType;
 }
 /**
  * @public
  */
-export declare class ValidationException extends __BaseException {
-    readonly name: "ValidationException";
-    readonly $fault: "client";
+export type AnnotationPayload = AnnotationPayload.ResultMember | AnnotationPayload.TagMember | AnnotationPayload.TextMember | AnnotationPayload.VariablesMember | AnnotationPayload.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace AnnotationPayload {
+    interface TagMember {
+        tag: string;
+        text?: never;
+        variables?: never;
+        result?: never;
+        $unknown?: never;
+    }
+    interface TextMember {
+        tag?: never;
+        text: string;
+        variables?: never;
+        result?: never;
+        $unknown?: never;
+    }
+    /**
+     * Capability variable values captured for an annotation. Runtime services enforce serialized payload size limits.
+     * @public
+     */
+    interface VariablesMember {
+        tag?: never;
+        text?: never;
+        variables: AnnotationVariablesValue;
+        result?: never;
+        $unknown?: never;
+    }
     /**
-     * @internal
+     * Tool result captured for an annotation. Runtime services enforce serialized payload size limits.
+     * @public
      */
-    constructor(opts: __ExceptionOptionType<ValidationException, __BaseException>);
+    interface ResultMember {
+        tag?: never;
+        text?: never;
+        variables?: never;
+        result: AnnotationResultValue;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        tag?: never;
+        text?: never;
+        variables?: never;
+        result?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        tag: (value: string) => T;
+        text: (value: string) => T;
+        variables: (value: AnnotationVariablesValue) => T;
+        result: (value: AnnotationResultValue) => T;
+        _: (name: string, value: any) => T;
+    }
 }
 /**
+ * Producer of an annotation. Generic identifiers allow callers to attach context such as tool id/name, user id/name, etc., without constraining the source type to a fixed shape.
  * @public
- * @enum
  */
-export declare const VoiceBotEventType: {
-    readonly AUDIO: "audio";
-    readonly COMPLETE: "complete";
-    readonly ENDED: "ended";
-    readonly INTERRUPTION: "interruption";
-    readonly PLAYBACK: "playback";
-    readonly REPLY: "reply";
-    readonly STARTED: "started";
-    readonly TRANSCRIPTION: "transcription";
-};
+export interface AnnotationSource {
+    type: AnnotationSourceType;
+    /**
+     * Stable identifier of the producer (e.g. tool id, user id).
+     * @public
+     */
+    id?: string | undefined;
+    /**
+     * Human-readable name of the producer (e.g. tool name, user display name).
+     * @public
+     */
+    name?: string | undefined;
+}
 /**
  * @public
  */
-export type VoiceBotEventType = typeof VoiceBotEventType[keyof typeof VoiceBotEventType];
+export interface Annotation {
+    id: string;
+    time: number;
+    payload: AnnotationPayload;
+    /**
+     * Producer of an annotation. Generic identifiers allow callers to attach context such as tool id/name, user id/name, etc., without constraining the source type to a fixed shape.
+     * @public
+     */
+    source: AnnotationSource;
+}
 /**
  * @public
  */
@@ -88,30 +157,146 @@ export interface CompleteWebsocketEvent {
     event: CompleteEvent;
 }
 /**
+ * Comment annotation emitted after a voice bot tool completes.
  * @public
  */
-export interface VoiceBotKnowledgeBase {
-    knowledgeBaseId?: string | undefined;
+export interface VoiceBotToolCommentAnnotation {
     /**
-     * Additional instructions for when the bot should use this knowledge base.
+     * Static handlebars expression resolved against bot variables and helpers.
      * @public
      */
-    instructions?: string | undefined;
+    value?: string | undefined;
+    /**
+     * Apply when the tool succeeds.
+     * @public
+     */
+    applyOnSuccess?: boolean | undefined;
+    /**
+     * Apply when the tool fails.
+     * @public
+     */
+    applyOnFailure?: boolean | undefined;
 }
+/**
+ * Result annotation emitted after a voice bot tool completes.
+ * @public
+ */
+export interface VoiceBotToolResultAnnotation {
+}
+/**
+ * Tag annotation emitted after a voice bot tool completes.
+ * @public
+ */
+export interface VoiceBotToolTagAnnotation {
+    /**
+     * Static handlebars expression resolved against bot variables and helpers.
+     * @public
+     */
+    value?: string | undefined;
+    /**
+     * Apply when the tool succeeds.
+     * @public
+     */
+    applyOnSuccess?: boolean | undefined;
+    /**
+     * Apply when the tool fails.
+     * @public
+     */
+    applyOnFailure?: boolean | undefined;
+}
+/**
+ * Variables annotation emitted after a voice bot tool completes.
+ * @public
+ */
+export interface VoiceBotToolVariablesAnnotation {
+}
+/**
+ * Configuration for annotations emitted after a tool completes. Tag and comment annotations can provide a handlebars value, while variables and result annotations opt into logging runtime data.
+ * @public
+ */
+export type VoiceBotToolAnnotation = VoiceBotToolAnnotation.CommentMember | VoiceBotToolAnnotation.ResultMember | VoiceBotToolAnnotation.TagMember | VoiceBotToolAnnotation.VariablesMember | VoiceBotToolAnnotation.$UnknownMember;
 /**
  * @public
- * @enum
  */
-export declare const VoiceBotCapabilityToolPipelineType: {
-    readonly ASYNC_REQUEST: "async_request";
-    readonly ASYNC_REQUEST_GUIDED: "async_request_guided";
-    readonly BLOCKING_REQUEST: "blocking_request";
-    readonly BLOCKING_REQUEST_GUIDED: "blocking_request_guided";
-};
+export declare namespace VoiceBotToolAnnotation {
+    /**
+     * Tag annotation emitted after a voice bot tool completes.
+     * @public
+     */
+    interface TagMember {
+        tag: VoiceBotToolTagAnnotation;
+        comment?: never;
+        variables?: never;
+        result?: never;
+        $unknown?: never;
+    }
+    /**
+     * Comment annotation emitted after a voice bot tool completes.
+     * @public
+     */
+    interface CommentMember {
+        tag?: never;
+        comment: VoiceBotToolCommentAnnotation;
+        variables?: never;
+        result?: never;
+        $unknown?: never;
+    }
+    /**
+     * Variables annotation emitted after a voice bot tool completes.
+     * @public
+     */
+    interface VariablesMember {
+        tag?: never;
+        comment?: never;
+        variables: VoiceBotToolVariablesAnnotation;
+        result?: never;
+        $unknown?: never;
+    }
+    /**
+     * Result annotation emitted after a voice bot tool completes.
+     * @public
+     */
+    interface ResultMember {
+        tag?: never;
+        comment?: never;
+        variables?: never;
+        result: VoiceBotToolResultAnnotation;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        tag?: never;
+        comment?: never;
+        variables?: never;
+        result?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        tag: (value: VoiceBotToolTagAnnotation) => T;
+        comment: (value: VoiceBotToolCommentAnnotation) => T;
+        variables: (value: VoiceBotToolVariablesAnnotation) => T;
+        result: (value: VoiceBotToolResultAnnotation) => T;
+        _: (name: string, value: any) => T;
+    }
+}
 /**
  * @public
  */
-export type VoiceBotCapabilityToolPipelineType = typeof VoiceBotCapabilityToolPipelineType[keyof typeof VoiceBotCapabilityToolPipelineType];
+export interface VoiceBotKnowledgeBase {
+    knowledgeBaseId?: string | undefined;
+    /**
+     * Additional instructions for when the bot should use this knowledge base.
+     * @public
+     */
+    instructions?: string | undefined;
+    annotations?: VoiceBotToolAnnotation[] | undefined;
+}
 /**
  * @public
  */
@@ -179,13 +364,16 @@ export declare namespace VoiceBotToolVariableHandler {
         predefined?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         auto: (value: VoiceBotToolVariableAutoHandler) => T;
         guided: (value: VoiceBotToolVariableGuidedHandler) => T;
         predefined: (value: VoiceBotToolVariablePredefinedHandler) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: VoiceBotToolVariableHandler, visitor: Visitor<T>) => T;
 }
 /**
  * @public
@@ -207,7 +395,7 @@ export interface VoiceBotCapabilityTool {
      * @public
      */
     id: string;
-    variables?: (VoiceBotToolVariable)[] | undefined;
+    variables?: VoiceBotToolVariable[] | undefined;
     /**
      * Message spoken when the tool call starts.
      * @public
@@ -218,6 +406,7 @@ export interface VoiceBotCapabilityTool {
      * @public
      */
     pipeline?: VoiceBotCapabilityToolPipeline | undefined;
+    annotations?: VoiceBotToolAnnotation[] | undefined;
 }
 /**
  * @public
@@ -245,12 +434,15 @@ export declare namespace VoiceBotCapability {
         kb?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         tool: (value: VoiceBotCapabilityTool) => T;
         kb: (value: VoiceBotKnowledgeBase) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: VoiceBotCapability, visitor: Visitor<T>) => T;
 }
 /**
  * @public
@@ -277,20 +469,6 @@ export interface BotDialogflowCxEndpoint {
      */
     language: string;
 }
-/**
- * @public
- * @enum
- */
-export declare const VoiceBotEmbeddedToolType: {
-    readonly DELEGATE: "DELEGATE";
-    readonly HANGUP: "HANGUP";
-    readonly TRANSFER: "TRANSFER";
-    readonly WAIT: "WAIT";
-};
-/**
- * @public
- */
-export type VoiceBotEmbeddedToolType = typeof VoiceBotEmbeddedToolType[keyof typeof VoiceBotEmbeddedToolType];
 /**
  * @public
  */
@@ -302,6 +480,7 @@ export interface VoiceBotEmbeddedTool {
      * @public
      */
     parameters?: __DocumentType | undefined;
+    annotations?: VoiceBotToolAnnotation[] | undefined;
 }
 /**
  * @public
@@ -425,13 +604,16 @@ export declare namespace VoiceBotFunctionIntegrationWebhookAuthorization {
         oauth?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         bearer: (value: VoiceBotFunctionIntegrationWebhookAuthorizationBearer) => T;
         basic: (value: VoiceBotFunctionIntegrationWebhookAuthorizationBasic) => T;
         oauth: (value: VoiceBotFunctionIntegrationWebhookAuthorizationOAuth) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: VoiceBotFunctionIntegrationWebhookAuthorization, visitor: Visitor<T>) => T;
 }
 /**
  * @public
@@ -440,21 +622,6 @@ export interface VoiceBotFunctionIntegrationWebhookHeader {
     key: string;
     value: string;
 }
-/**
- * @public
- * @enum
- */
-export declare const VoiceBotFunctionIntegrationMethod: {
-    readonly DELETE: "delete";
-    readonly GET: "get";
-    readonly PATCH: "patch";
-    readonly POST: "post";
-    readonly PUT: "put";
-};
-/**
- * @public
- */
-export type VoiceBotFunctionIntegrationMethod = typeof VoiceBotFunctionIntegrationMethod[keyof typeof VoiceBotFunctionIntegrationMethod];
 /**
  * @public
  */
@@ -463,7 +630,7 @@ export interface VoiceBotFunctionIntegrationWebhook {
     method?: VoiceBotFunctionIntegrationMethod | undefined;
     async?: boolean | undefined;
     authorization?: VoiceBotFunctionIntegrationWebhookAuthorization | undefined;
-    headers?: (VoiceBotFunctionIntegrationWebhookHeader)[] | undefined;
+    headers?: VoiceBotFunctionIntegrationWebhookHeader[] | undefined;
     /**
      * Timeout in milliseconds for the webhook request.
      * @public
@@ -495,11 +662,14 @@ export declare namespace VoiceBotFunctionIntegration {
         webhook?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         webhook: (value: VoiceBotFunctionIntegrationWebhook) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: VoiceBotFunctionIntegration, visitor: Visitor<T>) => T;
 }
 /**
  * @public
@@ -522,23 +692,13 @@ export interface VoiceBotFunctionDefinition {
     parameters?: __DocumentType | undefined;
     integration?: VoiceBotFunctionIntegration | undefined;
 }
-/**
- * @public
- * @enum
- */
-export declare const VoiceBotToolType: {
-    readonly FUNCTION: "function";
-};
-/**
- * @public
- */
-export type VoiceBotToolType = typeof VoiceBotToolType[keyof typeof VoiceBotToolType];
 /**
  * @public
  */
 export interface VoiceBotTool {
     type: VoiceBotToolType;
     function?: VoiceBotFunctionDefinition | undefined;
+    annotations?: VoiceBotToolAnnotation[] | undefined;
 }
 /**
  * @public
@@ -556,7 +716,7 @@ export interface VoiceBotLlmEndpoint {
      * @public
      */
     model?: string | undefined;
-    guidelines?: (string)[] | undefined;
+    guidelines?: string[] | undefined;
     /**
      * Metadata configuration to include in the system prompt context.
      * @public
@@ -566,18 +726,18 @@ export interface VoiceBotLlmEndpoint {
      * Embedded functions to use within voice session.
      * @public
      */
-    embeddedTools?: (VoiceBotEmbeddedTool)[] | undefined;
+    embeddedTools?: VoiceBotEmbeddedTool[] | undefined;
     /**
      * Custom tools to be used within voice session.
      * @public
      */
-    tools?: (VoiceBotTool)[] | undefined;
-    capabilities?: (VoiceBotCapability)[] | undefined;
+    tools?: VoiceBotTool[] | undefined;
+    capabilities?: VoiceBotCapability[] | undefined;
     /**
      * Variables such as dialplan variables that can be used in the bot.
      * @public
      */
-    variables?: (VoiceBotVariable)[] | undefined;
+    variables?: VoiceBotVariable[] | undefined;
 }
 /**
  * @public
@@ -660,6 +820,10 @@ export declare namespace VoiceBotEndpoint {
         sqs?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         llm: (value: VoiceBotLlmEndpoint) => T;
         dialogflowCx: (value: BotDialogflowCxEndpoint) => T;
@@ -668,7 +832,6 @@ export declare namespace VoiceBotEndpoint {
         sqs: (value: BotSqsEndpoint) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: VoiceBotEndpoint, visitor: Visitor<T>) => T;
 }
 /**
  * @public
@@ -708,12 +871,15 @@ export declare namespace VoiceBotPipelineTerminateAction {
         transfer?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         hangup: (value: VoiceBotTerminateHangupAction) => T;
         transfer: (value: VoiceBotTerminateTransferAction) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: VoiceBotPipelineTerminateAction, visitor: Visitor<T>) => T;
 }
 /**
  * @public
@@ -776,7 +942,7 @@ export interface CreateVoiceBotInput {
      * @public
      */
     endpoint: VoiceBotEndpoint;
-    capabilities?: (VoiceBotCapability)[] | undefined;
+    capabilities?: VoiceBotCapability[] | undefined;
     /**
      * PBX group ID for ACL-based visibility in Sales Intelligence.
      * @public
@@ -805,7 +971,7 @@ export interface VoiceBot {
      * @public
      */
     endpoint: VoiceBotEndpoint;
-    capabilities?: (VoiceBotCapability)[] | undefined;
+    capabilities?: VoiceBotCapability[] | undefined;
     /**
      * PBX group ID for ACL-based visibility in Sales Intelligence.
      * @public
@@ -821,18 +987,6 @@ export interface VoiceBot {
 export interface CreateVoiceBotOutput {
     bot: VoiceBot;
 }
-/**
- * @public
- */
-export declare class VoiceBotNonUniqueNameException extends __BaseException {
-    readonly name: "VoiceBotNonUniqueNameException";
-    readonly $fault: "client";
-    type?: string | undefined;
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<VoiceBotNonUniqueNameException, __BaseException>);
-}
 /**
  * @public
  */
@@ -850,21 +1004,6 @@ export interface DeleteVoiceBotOutput {
  */
 export interface DescribeEventInput {
 }
-/**
- * @public
- * @enum
- */
-export declare const VoiceBotCommandType: {
-    readonly HANGUP: "hangup";
-    readonly PLAY: "play";
-    readonly SAY: "say";
-    readonly STOP: "stop";
-    readonly TRANSFER: "transfer";
-};
-/**
- * @public
- */
-export type VoiceBotCommandType = typeof VoiceBotCommandType[keyof typeof VoiceBotCommandType];
 /**
  * @public
  */
@@ -987,27 +1126,23 @@ export declare namespace TraceActivityResult {
         text?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         error: (value: TraceErrorResult) => T;
         text: (value: string) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: TraceActivityResult, visitor: Visitor<T>) => T;
 }
 /**
+ * Trace activity written when the voicebot emits an annotation.
  * @public
- * @enum
  */
-export declare const TraceActivityStatus: {
-    readonly CANCELLED: "cancelled";
-    readonly COMPLETE: "complete";
-    readonly ERROR: "error";
-    readonly PENDING: "pending";
-};
-/**
- * @public
- */
-export type TraceActivityStatus = typeof TraceActivityStatus[keyof typeof TraceActivityStatus];
+export interface TraceAnnotationCommand {
+    annotation: Annotation;
+}
 /**
  * @public
  */
@@ -1080,6 +1215,11 @@ export interface TranscriptionEvent {
     type: VoiceBotEventType;
     id: string;
     text: string;
+    /**
+     * Transcription confidence score (accuracy level) in range from 0.0 to 1.0. Value -1.0 indicates confidence is unavailable.
+     * @public
+     */
+    confidence?: number | undefined;
     final?: boolean | undefined;
     time: number;
 }
@@ -1108,7 +1248,7 @@ export interface TransferWebsocketCommand {
 /**
  * @public
  */
-export type TraceActivityTrigger = TraceActivityTrigger.CompleteEventMember | TraceActivityTrigger.ConnectEventMember | TraceActivityTrigger.DisconnectEventMember | TraceActivityTrigger.DurationTimeoutTaskMember | TraceActivityTrigger.HangupCommandMember | TraceActivityTrigger.InterruptionEventMember | TraceActivityTrigger.PlaybackEventMember | TraceActivityTrigger.ReplyEventMember | TraceActivityTrigger.SayCommandMember | TraceActivityTrigger.SilenceTimeoutTaskMember | TraceActivityTrigger.TranscriptionEventMember | TraceActivityTrigger.TransferCommandMember | TraceActivityTrigger.$UnknownMember;
+export type TraceActivityTrigger = TraceActivityTrigger.AnnotationCommandMember | TraceActivityTrigger.CompleteEventMember | TraceActivityTrigger.ConnectEventMember | TraceActivityTrigger.DisconnectEventMember | TraceActivityTrigger.DurationTimeoutTaskMember | TraceActivityTrigger.HangupCommandMember | TraceActivityTrigger.InterruptionEventMember | TraceActivityTrigger.PlaybackEventMember | TraceActivityTrigger.ReplyEventMember | TraceActivityTrigger.SayCommandMember | TraceActivityTrigger.SilenceTimeoutTaskMember | TraceActivityTrigger.TranscriptionEventMember | TraceActivityTrigger.TransferCommandMember | TraceActivityTrigger.$UnknownMember;
 /**
  * @public
  */
@@ -1124,6 +1264,7 @@ export declare namespace TraceActivityTrigger {
         sayCommand?: never;
         hangupCommand?: never;
         transferCommand?: never;
+        annotationCommand?: never;
         silenceTimeoutTask?: never;
         durationTimeoutTask?: never;
         $unknown?: never;
@@ -1139,6 +1280,7 @@ export declare namespace TraceActivityTrigger {
         sayCommand?: never;
         hangupCommand?: never;
         transferCommand?: never;
+        annotationCommand?: never;
         silenceTimeoutTask?: never;
         durationTimeoutTask?: never;
         $unknown?: never;
@@ -1154,6 +1296,7 @@ export declare namespace TraceActivityTrigger {
         sayCommand?: never;
         hangupCommand?: never;
         transferCommand?: never;
+        annotationCommand?: never;
         silenceTimeoutTask?: never;
         durationTimeoutTask?: never;
         $unknown?: never;
@@ -1169,6 +1312,7 @@ export declare namespace TraceActivityTrigger {
         sayCommand?: never;
         hangupCommand?: never;
         transferCommand?: never;
+        annotationCommand?: never;
         silenceTimeoutTask?: never;
         durationTimeoutTask?: never;
         $unknown?: never;
@@ -1184,6 +1328,7 @@ export declare namespace TraceActivityTrigger {
         sayCommand?: never;
         hangupCommand?: never;
         transferCommand?: never;
+        annotationCommand?: never;
         silenceTimeoutTask?: never;
         durationTimeoutTask?: never;
         $unknown?: never;
@@ -1199,6 +1344,7 @@ export declare namespace TraceActivityTrigger {
         sayCommand?: never;
         hangupCommand?: never;
         transferCommand?: never;
+        annotationCommand?: never;
         silenceTimeoutTask?: never;
         durationTimeoutTask?: never;
         $unknown?: never;
@@ -1214,6 +1360,7 @@ export declare namespace TraceActivityTrigger {
         sayCommand?: never;
         hangupCommand?: never;
         transferCommand?: never;
+        annotationCommand?: never;
         silenceTimeoutTask?: never;
         durationTimeoutTask?: never;
         $unknown?: never;
@@ -1229,6 +1376,7 @@ export declare namespace TraceActivityTrigger {
         sayCommand: SayWebsocketCommand;
         hangupCommand?: never;
         transferCommand?: never;
+        annotationCommand?: never;
         silenceTimeoutTask?: never;
         durationTimeoutTask?: never;
         $unknown?: never;
@@ -1244,6 +1392,7 @@ export declare namespace TraceActivityTrigger {
         sayCommand?: never;
         hangupCommand: HangupWebsocketCommand;
         transferCommand?: never;
+        annotationCommand?: never;
         silenceTimeoutTask?: never;
         durationTimeoutTask?: never;
         $unknown?: never;
@@ -1259,6 +1408,27 @@ export declare namespace TraceActivityTrigger {
         sayCommand?: never;
         hangupCommand?: never;
         transferCommand: TransferWebsocketCommand;
+        annotationCommand?: never;
+        silenceTimeoutTask?: never;
+        durationTimeoutTask?: never;
+        $unknown?: never;
+    }
+    /**
+     * Trace activity written when the voicebot emits an annotation.
+     * @public
+     */
+    interface AnnotationCommandMember {
+        connectEvent?: never;
+        disconnectEvent?: never;
+        replyEvent?: never;
+        completeEvent?: never;
+        interruptionEvent?: never;
+        playbackEvent?: never;
+        transcriptionEvent?: never;
+        sayCommand?: never;
+        hangupCommand?: never;
+        transferCommand?: never;
+        annotationCommand: TraceAnnotationCommand;
         silenceTimeoutTask?: never;
         durationTimeoutTask?: never;
         $unknown?: never;
@@ -1274,6 +1444,7 @@ export declare namespace TraceActivityTrigger {
         sayCommand?: never;
         hangupCommand?: never;
         transferCommand?: never;
+        annotationCommand?: never;
         silenceTimeoutTask: TraceSilenceTimeoutTaskTrigger;
         durationTimeoutTask?: never;
         $unknown?: never;
@@ -1289,6 +1460,7 @@ export declare namespace TraceActivityTrigger {
         sayCommand?: never;
         hangupCommand?: never;
         transferCommand?: never;
+        annotationCommand?: never;
         silenceTimeoutTask?: never;
         durationTimeoutTask: TraceDurationTimeoutTaskTrigger;
         $unknown?: never;
@@ -1307,10 +1479,15 @@ export declare namespace TraceActivityTrigger {
         sayCommand?: never;
         hangupCommand?: never;
         transferCommand?: never;
+        annotationCommand?: never;
         silenceTimeoutTask?: never;
         durationTimeoutTask?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         connectEvent: (value: TraceConnectEventTrigger) => T;
         disconnectEvent: (value: TraceDisconnectEventTrigger) => T;
@@ -1322,11 +1499,11 @@ export declare namespace TraceActivityTrigger {
         sayCommand: (value: SayWebsocketCommand) => T;
         hangupCommand: (value: HangupWebsocketCommand) => T;
         transferCommand: (value: TransferWebsocketCommand) => T;
+        annotationCommand: (value: TraceAnnotationCommand) => T;
         silenceTimeoutTask: (value: TraceSilenceTimeoutTaskTrigger) => T;
         durationTimeoutTask: (value: TraceDurationTimeoutTaskTrigger) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: TraceActivityTrigger, visitor: Visitor<T>) => T;
 }
 /**
  * @public
@@ -1528,6 +1705,10 @@ export declare namespace TraceToolCall {
         capabilityKb?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         transfer: (value: TraceTransferToolCall) => T;
         hangup: (value: TraceHangupToolCall) => T;
@@ -1538,7 +1719,6 @@ export declare namespace TraceToolCall {
         capabilityKb: (value: TraceCapabilityKbCall) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: TraceToolCall, visitor: Visitor<T>) => T;
 }
 /**
  * @public
@@ -1562,7 +1742,7 @@ export declare namespace TraceSegmentCompletionMessage {
     }
     interface ToolsMember {
         text?: never;
-        tools: (TraceSegmentCompletionToolMessage)[];
+        tools: TraceSegmentCompletionToolMessage[];
         $unknown?: never;
     }
     /**
@@ -1573,12 +1753,15 @@ export declare namespace TraceSegmentCompletionMessage {
         tools?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         text: (value: string) => T;
-        tools: (value: (TraceSegmentCompletionToolMessage)[]) => T;
+        tools: (value: TraceSegmentCompletionToolMessage[]) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: TraceSegmentCompletionMessage, visitor: Visitor<T>) => T;
 }
 /**
  * @public
@@ -1606,19 +1789,22 @@ export declare namespace TraceSegmentCompletionMessageItem {
         bot?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         user: (value: TraceSegmentCompletionMessage) => T;
         bot: (value: TraceSegmentCompletionMessage) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: TraceSegmentCompletionMessageItem, visitor: Visitor<T>) => T;
 }
 /**
  * @public
  */
 export interface TraceSegmentCompletionInput {
     instructions: string;
-    messages: (TraceSegmentCompletionMessageItem)[];
+    messages: TraceSegmentCompletionMessageItem[];
     model?: string | undefined;
 }
 /**
@@ -1647,12 +1833,15 @@ export declare namespace TraceGenericInputBlockContent {
         json?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         text: (value: string) => T;
         json: (value: __DocumentType) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: TraceGenericInputBlockContent, visitor: Visitor<T>) => T;
 }
 /**
  * @public
@@ -1666,7 +1855,7 @@ export interface TraceGenericInputBlock {
  */
 export interface TraceGenericInput {
     title: string;
-    blocks?: (TraceGenericInputBlock)[] | undefined;
+    blocks?: TraceGenericInputBlock[] | undefined;
 }
 /**
  * @public
@@ -1723,6 +1912,10 @@ export declare namespace TraceSegmentInput {
         generic?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         completion: (value: TraceSegmentCompletionInput) => T;
         tool: (value: TraceToolCall) => T;
@@ -1730,7 +1923,6 @@ export declare namespace TraceSegmentInput {
         generic: (value: TraceGenericInput) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: TraceSegmentInput, visitor: Visitor<T>) => T;
 }
 /**
  * @public
@@ -1749,7 +1941,7 @@ export declare namespace TraceSegmentResult {
     }
     interface ToolsMember {
         error?: never;
-        tools: (TraceToolCall)[];
+        tools: TraceToolCall[];
         text?: never;
         json?: never;
         $unknown?: never;
@@ -1778,28 +1970,18 @@ export declare namespace TraceSegmentResult {
         json?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         error: (value: TraceErrorResult) => T;
-        tools: (value: (TraceToolCall)[]) => T;
+        tools: (value: TraceToolCall[]) => T;
         text: (value: string) => T;
         json: (value: __DocumentType) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: TraceSegmentResult, visitor: Visitor<T>) => T;
 }
-/**
- * @public
- * @enum
- */
-export declare const TraceSegmentStatus: {
-    readonly COMPLETE: "complete";
-    readonly ERROR: "error";
-    readonly PENDING: "pending";
-};
-/**
- * @public
- */
-export type TraceSegmentStatus = typeof TraceSegmentStatus[keyof typeof TraceSegmentStatus];
 /**
  * @public
  */
@@ -1813,19 +1995,6 @@ export interface TraceSegment {
     start: number;
     duration?: number | undefined;
 }
-/**
- * @public
- * @enum
- */
-export declare const TraceSessionStatus: {
-    readonly COMPLETE: "complete";
-    readonly COMPLETE_WITH_ERROR: "complete_with_error";
-    readonly PENDING: "pending";
-};
-/**
- * @public
- */
-export type TraceSessionStatus = typeof TraceSessionStatus[keyof typeof TraceSessionStatus];
 /**
  * @public
  */
@@ -1859,7 +2028,7 @@ export interface PubSubBroadcastItem {
 export interface PubSubBroadcastWebsocketEvent {
     event: string;
     topic: string;
-    items: (PubSubBroadcastItem)[];
+    items: PubSubBroadcastItem[];
 }
 /**
  * @public
@@ -2002,8 +2171,8 @@ export interface GetTraceInput {
  */
 export interface Trace {
     session: TraceSession;
-    activities: (TraceActivity)[];
-    segments: (TraceSegment)[];
+    activities: TraceActivity[];
+    segments: TraceSegment[];
     usage?: TraceUsage | undefined;
     cost?: number | undefined;
 }
@@ -2013,18 +2182,6 @@ export interface Trace {
 export interface GetTraceOutput {
     trace: Trace;
 }
-/**
- * @public
- */
-export declare class VoiceBotNotFoundException extends __BaseException {
-    readonly name: "VoiceBotNotFoundException";
-    readonly $fault: "client";
-    type?: string | undefined;
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<VoiceBotNotFoundException, __BaseException>);
-}
 /**
  * @public
  */
@@ -2053,7 +2210,7 @@ export interface ListTracesInput {
  * @public
  */
 export interface ListTracesOutput {
-    traces: (TraceSession)[];
+    traces: TraceSession[];
 }
 /**
  * @public
@@ -2065,7 +2222,7 @@ export interface ListVoiceBotsInput {
  * @public
  */
 export interface ListVoiceBotsOutput {
-    bots: (VoiceBot)[];
+    bots: VoiceBot[];
 }
 /**
  * @public
@@ -2084,7 +2241,7 @@ export interface VoiceBotInfo {
  * @public
  */
 export interface ListVoiceBotsNamesOutput {
-    bots: (VoiceBotInfo)[];
+    bots: VoiceBotInfo[];
 }
 /**
  * @public
@@ -2098,18 +2255,6 @@ export interface SendHangupInput {
  */
 export interface SendHangupOutput {
 }
-/**
- * @public
- */
-export declare class VoiceSessionNotFoundException extends __BaseException {
-    readonly name: "VoiceSessionNotFoundException";
-    readonly $fault: "client";
-    type?: string | undefined;
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<VoiceSessionNotFoundException, __BaseException>);
-}
 /**
  * @public
  */
@@ -2188,7 +2333,7 @@ export interface UpdateVoiceBotInput {
      * @public
      */
     endpoint: VoiceBotEndpoint;
-    capabilities?: (VoiceBotCapability)[] | undefined;
+    capabilities?: VoiceBotCapability[] | undefined;
     /**
      * PBX group ID for ACL-based visibility in Sales Intelligence.
      * @public