@webex/plugin-meetings 3.0.0-bnr.4 → 3.0.0-stream-classes.1

package/dist/types/members/request.d.ts

@@ -4,6 +4,15 @@ import { StatelessWebexPlugin } from '@webex/webex-core';
  */
 export default class MembersRequest extends StatelessWebexPlugin {
     namespace: string;
+    locusDeltaRequest: (options: object) => Promise<any>;
+    /**
+     * Constructor
+     * @param {Object} attrs
+     * @param {Object} options
+     */
+    constructor(attrs: {
+        meeting: any;
+    }, options: object);
     /**
      *
      * @param {Object} options with format of {invitee: string, locusUrl: string}
@@ -11,7 +20,7 @@ export default class MembersRequest extends StatelessWebexPlugin {
      * @throws {Error} if the options are not valid and complete, must have invitee with emailAddress OR email AND locusUrl
      * @memberof MembersRequest
      */
-    addMembers(options: any): any;
+    addMembers(options: any): Promise<any>;
     /**
      *
      * @param {Object} options
@@ -19,9 +28,23 @@ export default class MembersRequest extends StatelessWebexPlugin {
      * @throws {Error} if the options are not valid and complete, must have memberIds AND locusUrl
      * @memberof MembersRequest
      */
-    admitMember(options: any): any;
-    removeMember(options: any): any;
-    muteMember(options: any): any;
+    admitMember(options: any): Promise<any>;
+    /**
+     * Sends a request to remove a member
+     * @param {Object} options
+     * @param {String} options.locusUrl
+     * @param {String} options.memberId ID of member
+     * @returns {Promise}
+     */
+    removeMember(options: any): Promise<any>;
+    /**
+     * Sends a request to mute a member
+     * @param {Object} options
+     * @param {String} options.locusUrl
+     * @param {String} options.memberId ID of member
+     * @returns {Promise}
+     */
+    muteMember(options: any): Promise<any>;
     /**
      * Sends a request to the DTMF endpoint to send tones
      * @param {Object} options
@@ -29,9 +52,23 @@ export default class MembersRequest extends StatelessWebexPlugin {
      * @param {String} options.memberId ID of PSTN user
      * @returns {Promise}
      */
-    assignRolesMember(options: any): any;
-    raiseOrLowerHandMember(options: any): any;
-    lowerAllHandsMember(options: any): any;
+    assignRolesMember(options: any): Promise<any>;
+    /**
+     * Sends a request to raise or lower a member's hand
+     * @param {Object} options
+     * @param {String} options.locusUrl
+     * @param {String} options.memberId ID of member
+     * @returns {Promise}
+     */
+    raiseOrLowerHandMember(options: any): Promise<any>;
+    /**
+     * Sends a request to lower all hands
+     * @param {Object} options
+     * @param {String} options.locusUrl
+     * @param {String} options.requestingParticipantId ID of requesting participant
+     * @returns {Promise}
+     */
+    lowerAllHandsMember(options: any): Promise<any>;
     /**
      *
      * @param {Object} options with format of {locusUrl: string, requestingParticipantId: string}
@@ -42,8 +79,16 @@ export default class MembersRequest extends StatelessWebexPlugin {
     editDisplayNameMember(options: {
         locusUrl: string;
         requestingParticipantId: string;
-    }): any;
-    transferHostToMember(options: any): any;
+    }): Promise<any>;
+    /**
+     * Sends a request to raise or lower a member's hand
+     * @param {Object} options
+     * @param {String} options.locusUrl
+     * @param {String} options.memberId ID of member
+     * @param {String} options.moderator ID of moderator
+     * @returns {Promise}
+     */
+    transferHostToMember(options: any): Promise<any>;
     /**
      * Sends a request to the DTMF endpoint to send tones
      * @param {Object} options
@@ -58,12 +103,12 @@ export default class MembersRequest extends StatelessWebexPlugin {
         url: string;
         tones: string;
         memberId: string;
-    }): any;
+    }): Promise<any>;
     /**
      * @param {Object} options with format of {invitee: string, locusUrl: string}
      * @returns {Promise}
      * @throws {Error} if the options are not valid and complete, must have invitee with emailAddress OR email AND locusUrl
      * @memberof MembersRequest
      */
-    cancelPhoneInvite(options: any): any;
+    cancelPhoneInvite(options: any): Promise<any>;
 }

package/dist/types/members/util.d.ts

@@ -1,2 +1,210 @@
-declare const MembersUtil: any;
+import { RoleAssignmentOptions, RoleAssignmentRequest, ServerRoleShape } from './types';
+declare const MembersUtil: {
+    /**
+     * @param {Object} invitee with emailAddress, email or phoneNumber
+     * @param {String} locusUrl
+     * @param {Boolean} alertIfActive
+     * @returns {Object} the format object
+     */
+    generateAddMemberOptions: (invitee: object, locusUrl: string, alertIfActive: boolean) => {
+        invitee: object;
+        locusUrl: string;
+        alertIfActive: boolean;
+    };
+    /**
+     * @param {Array} memberIds
+     * @param {String} locusUrl
+     * @returns {Object} the format object
+     */
+    generateAdmitMemberOptions: (memberIds: Array<any>, locusUrl: string) => {
+        locusUrl: string;
+        memberIds: any[];
+    };
+    /**
+     * @param {Object} options with {invitee: {emailAddress, email, phoneNumber}, alertIfActive}
+     * @returns {Object} with {invitees: [{address}], alertIfActive}
+     */
+    getAddMemberBody: (options: any) => {
+        invitees: {
+            address: any;
+        }[];
+        alertIfActive: any;
+    };
+    /**
+     * @param {Object} options with {memberIds, authorizingLocusUrl}
+     * @returns {Object} admit with {memberIds}
+     */
+    getAdmitMemberRequestBody: (options: any) => any;
+    /**
+     * @param {Object} format with {memberIds, locusUrl, sessionLocusUrls}
+     * @returns {Object} the request parameters (method, uri, body) needed to make a admitMember request
+     * if a host/cohost is in a breakout session, the locus url should be the main session locus url
+     */
+    getAdmitMemberRequestParams: (format: any) => {
+        method: string;
+        uri: string;
+        body: any;
+    };
+    /**
+     * @param {Object} format with {invitee {emailAddress, email, phoneNumber}, locusUrl, alertIfActive}
+     * @returns {Object} the request parameters (method, uri, body) needed to make a addMember request
+     */
+    getAddMemberRequestParams: (format: any) => {
+        method: string;
+        uri: any;
+        body: {
+            invitees: {
+                address: any;
+            }[];
+            alertIfActive: any;
+        };
+    };
+    isInvalidInvitee: (invitee: any) => boolean;
+    getRemoveMemberRequestParams: (options: any) => {
+        method: string;
+        uri: string;
+        body: {
+            reason: any;
+        };
+    };
+    generateTransferHostMemberOptions: (transfer: any, moderator: any, locusUrl: any) => {
+        moderator: any;
+        locusUrl: any;
+        memberId: any;
+    };
+    generateRemoveMemberOptions: (removal: any, locusUrl: any) => {
+        reason: string;
+        memberId: any;
+        locusUrl: any;
+    };
+    generateMuteMemberOptions: (memberId: any, status: any, locusUrl: any, isAudio: any) => {
+        memberId: any;
+        muted: any;
+        locusUrl: any;
+        isAudio: any;
+    };
+    generateRaiseHandMemberOptions: (memberId: any, status: any, locusUrl: any) => {
+        memberId: any;
+        raised: any;
+        locusUrl: any;
+    };
+    /**
+     * @param {String} memberId
+     * @param {[ServerRoleShape]} roles
+     * @param {String} locusUrl
+     * @returns {RoleAssignmentOptions}
+     */
+    generateRoleAssignmentMemberOptions: (memberId: string, roles: Array<ServerRoleShape>, locusUrl: string) => RoleAssignmentOptions;
+    generateLowerAllHandsMemberOptions: (requestingParticipantId: any, locusUrl: any) => {
+        requestingParticipantId: any;
+        locusUrl: any;
+    };
+    /**
+     * @param {String} memberId id of the participant who is receiving request
+     * @param {String} requestingParticipantId id of the participant who is sending request (optional)
+     * @param {String} alias alias name
+     * @param {String} locusUrl url
+     * @returns {Object} consists of {memberID: string, requestingParticipantId: string, alias: string, locusUrl: string}
+     */
+    generateEditDisplayNameMemberOptions: (memberId: any, requestingParticipantId: any, alias: any, locusUrl: any) => {
+        memberId: any;
+        requestingParticipantId: any;
+        alias: any;
+        locusUrl: any;
+    };
+    getMuteMemberRequestParams: (options: any) => {
+        method: string;
+        uri: string;
+        body: {
+            [x: string]: {
+                muted: any;
+            };
+        };
+    };
+    /**
+     * @param {RoleAssignmentOptions} options
+     * @returns {RoleAssignmentRequest} the request parameters (method, uri, body) needed to make a addMember request
+     */
+    getRoleAssignmentMemberRequestParams: (options: RoleAssignmentOptions) => RoleAssignmentRequest;
+    getRaiseHandMemberRequestParams: (options: any) => {
+        method: string;
+        uri: string;
+        body: {
+            hand: {
+                raised: any;
+            };
+        };
+    };
+    getLowerAllHandsMemberRequestParams: (options: any) => {
+        method: string;
+        uri: string;
+        body: {
+            hand: {
+                raised: boolean;
+            };
+            requestingParticipantId: any;
+        };
+    };
+    /**
+     * @param {Object} options with format of {locusUrl: string, requestingParticipantId: string}
+     * @returns {Object} request parameters (method, uri, body) needed to make a editDisplayName request
+     */
+    editDisplayNameMemberRequestParams: (options: any) => {
+        method: string;
+        uri: string;
+        body: {
+            aliasValue: any;
+            requestingParticipantId: any;
+        };
+    };
+    getTransferHostToMemberRequestParams: (options: any) => {
+        method: string;
+        uri: string;
+        body: {
+            role: {
+                moderator: any;
+            };
+        };
+    };
+    genderateSendDTMFOptions: (url: any, tones: any, memberId: any, locusUrl: any) => {
+        url: any;
+        tones: any;
+        memberId: any;
+        locusUrl: any;
+    };
+    generateSendDTMFRequestParams: ({ url, tones, memberId, locusUrl }: {
+        url: any;
+        tones: any;
+        memberId: any;
+        locusUrl: any;
+    }) => {
+        method: string;
+        uri: string;
+        body: {
+            device: {
+                url: any;
+            };
+            memberId: any;
+            dtmf: {
+                correlationId: any;
+                tones: any;
+                direction: string;
+            };
+        };
+    };
+    cancelPhoneInviteOptions: (invitee: any, locusUrl: any) => {
+        invitee: any;
+        locusUrl: any;
+    };
+    generateCancelInviteRequestParams: (options: any) => {
+        method: string;
+        uri: any;
+        body: {
+            actionType: string;
+            invitees: {
+                address: any;
+            }[];
+        };
+    };
+};
 export default MembersUtil;

package/dist/types/metrics/config.d.ts

@@ -8,6 +8,8 @@ export declare const eventType: {
     REMOTE_SDP_RECEIVED: string;
     LOCUS_JOIN_REQUEST: string;
     LOCUS_JOIN_RESPONSE: string;
+    MEETING_INFO_REQUEST: string;
+    MEETING_INFO_RESPONSE: string;
     ALERT_DISPLAYED: string;
     ICE_START: string;
     ICE_END: string;
@@ -43,8 +45,9 @@ export declare const eventType: {
     PSTN_AUDIO_ATTEMPT_START: string;
     PSTN_AUDIO_ATTEMPT_FINISH: string;
     PSTN_AUDIO_ATTEMPT_SKIP: string;
-    MOVE_TO_BREAKOUT: string;
-    JOIN_BREAKOUT_RESPONSE: string;
+    BREAKOUT_MOVE_REQUEST: string;
+    BREAKOUT_MOVE_RESPONSE: string;
+    BREAKOUT_JOIN_RESPONSE: string;
 };
 export declare const error: {
     name: {
@@ -108,8 +111,29 @@ export declare const error: {
         4030: string[];
         5000: string[];
         5001: string[];
+        4100: string[];
     };
 };
+export declare const WebexAPIServiceErrorCodes: {
+    58400: number;
+    99002: number;
+    99009: number;
+    403040: number;
+    403041: number;
+    403038: number;
+    403036: number;
+    403043: number;
+    403048: number;
+    403049: number;
+    403100: number;
+    403101: number;
+    403102: number;
+    403103: number;
+    403104: number;
+    404001: number;
+    404006: number;
+    429005: number;
+};
 export declare const trigger: {
     USER_INTERACTION: string;
     MERCURY_EVENT: string;

package/dist/types/metrics/constants.d.ts

@@ -7,6 +7,7 @@ declare const BEHAVIORAL_METRICS: {
     JOIN_FAILURE: string;
     ADD_MEDIA_SUCCESS: string;
     ADD_MEDIA_FAILURE: string;
+    ROAP_MERCURY_EVENT_RECEIVED: string;
     CONNECTION_SUCCESS: string;
     CONNECTION_FAILURE: string;
     MEETING_LEAVE_FAILURE: string;

package/dist/types/metrics/index.d.ts

@@ -124,6 +124,23 @@ declare class Metrics {
      *  errorCode: number, errorData: *, fatal: boolean, name: string}}
      */
     parseLocusError(err: any, showToUser: boolean): any;
+    /**
+     * Pareses webex api error.
+     *
+     * @param {object} err
+     * @param {boolean} showToUser
+     * @returns {object | null}
+     */
+    parseWebexApiError(err: any, showToUser: boolean): any;
+    /**
+     * Generates Error for the CA event
+     *
+     * @param {integer} errorCode
+     * @param {boolean} shownToUser
+     * @param {string} name
+     * @param {any} err
+     * @returns {any}
+     */
     generateErrorPayload(errorCode: any, shownToUser: any, name: any, err: any): any;
     /**
      * Returns a formated string of the user agent.

package/dist/types/multistream/mediaRequestManager.d.ts

@@ -1,4 +1,4 @@
-import { MediaRequest as WcmeMediaRequest } from '@webex/internal-media-core';
+import { StreamRequest } from '@webex/internal-media-core';
 import { ReceiveSlot } from './receiveSlot';
 export interface ActiveSpeakerPolicyInfo {
     policy: 'active-speaker';
@@ -26,16 +26,20 @@ export interface MediaRequest {
     receiveSlots: Array<ReceiveSlot>;
     codecInfo?: CodecInfo;
     preferredMaxFs?: number;
+    handleMaxFs?: ({ maxFs }: {
+        maxFs: number;
+    }) => void;
 }
 export type MediaRequestId = string;
 type DegradationPreferences = {
     maxMacroblocksLimit: number;
 };
-type SendMediaRequestsCallback = (mediaRequests: WcmeMediaRequest[]) => void;
+type SendMediaRequestsCallback = (streamRequests: StreamRequest[]) => void;
 type Kind = 'audio' | 'video';
 type Options = {
     degradationPreferences: DegradationPreferences;
     kind: Kind;
+    trimRequestsToNumOfSources: boolean;
 };
 export declare class MediaRequestManager {
     private sendMediaRequestsCallback;
@@ -45,23 +49,26 @@ export declare class MediaRequestManager {
     private degradationPreferences;
     private sourceUpdateListener;
     private debouncedSourceUpdateListener;
-    private previousWCMEMediaRequests;
+    private previousStreamRequests;
+    private trimRequestsToNumOfSources;
+    private numTotalSources;
+    private numLiveSources;
     constructor(sendMediaRequestsCallback: SendMediaRequestsCallback, options: Options);
     setDegradationPreferences(degradationPreferences: DegradationPreferences): void;
     private getDegradedClientRequests;
     /**
-     * Returns true if two media requests are the same, false otherwise.
+     * Returns true if two stream requests are the same, false otherwise.
      *
-     * @param {WcmeMediaRequest} mediaRequestA - Media request A for comparison.
-     * @param {WcmeMediaRequest} mediaRequestB - Media request B for comparison.
+     * @param {StreamRequest} streamRequestA - Stream request A for comparison.
+     * @param {StreamRequest} streamRequestB - Stream request B for comparison.
      * @returns {boolean} - Whether they are equal.
      */
-    isEqual(mediaRequestA: WcmeMediaRequest, mediaRequestB: WcmeMediaRequest): boolean;
+    isEqual(streamRequestA: StreamRequest, streamRequestB: StreamRequest): boolean;
     /**
-     * Compares new media requests to previous ones and determines
+     * Compares new stream requests to previous ones and determines
      * if they are the same.
      *
-     * @param {WcmeMediaRequest[]} newRequests - Array with new requests.
+     * @param {StreamRequest[]} newRequests - Array with new requests.
      * @returns {boolean} - True if they are equal, false otherwise.
      */
     private checkIsNewRequestsEqualToPrev;
@@ -87,15 +94,25 @@ export declare class MediaRequestManager {
      */
     private getH264MaxMbps;
     /**
-     * Clears the previous media requests.
+     * Clears the previous stream requests.
      *
      * @returns {void}
      */
     clearPreviousRequests(): void;
+    /** Modifies the passed in clientRequests and makes sure that in total they don't ask
+     *  for more streams than there are available.
+     *
+     * @param {Object} clientRequests
+     * @returns {void}
+     */
+    private trimRequests;
+    private getPreferLiveVideo;
+    private cloneClientRequests;
     private sendRequests;
     addRequest(mediaRequest: MediaRequest, commit?: boolean): MediaRequestId;
     cancelRequest(requestId: MediaRequestId, commit?: boolean): void;
     commit(): void;
     reset(): void;
+    setNumCurrentSources(numTotalSources: number, numLiveSources: number): void;
 }
 export {};

package/dist/types/multistream/receiveSlot.d.ts

@@ -1,10 +1,10 @@
-import { MediaType, ReceiveSlot as WcmeReceiveSlot, SourceState } from '@webex/internal-media-core';
+import { MediaType, ReceiveSlot as WcmeReceiveSlot, StreamState } from '@webex/internal-media-core';
 import EventsScope from '../common/events/events-scope';
 export declare const ReceiveSlotEvents: {
     SourceUpdate: string;
     MaxFsUpdate: string;
 };
-export type { SourceState } from '@webex/internal-media-core';
+export type { StreamState } from '@webex/internal-media-core';
 export type CSI = number;
 export type MemberId = string;
 export type ReceiveSlotId = string;
@@ -44,7 +44,7 @@ export declare class ReceiveSlot extends EventsScope {
     /**
      * Getter for sourceState
      */
-    get sourceState(): SourceState;
+    get sourceState(): StreamState;
     /**
      * registers event handlers with the underlying ReceiveSlot
      */

package/dist/types/multistream/remoteMedia.d.ts

@@ -1,4 +1,4 @@
-import { MediaType, SourceState } from '@webex/internal-media-core';
+import { MediaType, StreamState } from '@webex/internal-media-core';
 import EventsScope from '../common/events/events-scope';
 import { MediaRequestManager } from './mediaRequestManager';
 import { ReceiveSlot } from './receiveSlot';
@@ -63,7 +63,7 @@ export declare class RemoteMedia extends EventsScope {
     /**
      * Getter for source state
      */
-    get sourceState(): SourceState;
+    get sourceState(): StreamState;
     /**
      * Getter for remote media stream
      */

package/dist/types/multistream/remoteMediaManager.d.ts

@@ -139,6 +139,20 @@ export declare class RemoteMediaManager extends EventsScope {
      * @returns {LayoutId}
      */
     getLayoutId(): LayoutId | undefined;
+    /**
+     * sets the preferLiveVideo
+     */
+    setPreferLiveVideo(preferLiveVideo: boolean): void;
+    /**
+     * Sets CSIs for multiple RemoteMedia instances belonging to RemoteMediaGroup.
+     * For each entry in the remoteMediaCsis array:
+     * - if csi is specified, the RemoteMedia instance is pinned to that CSI
+     * - if csi is undefined, the RemoteMedia instance is unpinned
+     */
+    setActiveSpeakerCsis(remoteMediaCsis: {
+        remoteMedia: RemoteMedia;
+        csi?: number;
+    }[]): void;
     /**
      * Creates the audio slots
      */

package/dist/types/roap/request.d.ts

@@ -1,4 +1,5 @@
 import { StatelessWebexPlugin } from '@webex/webex-core';
+import { LocusMediaRequest } from '../meeting/locusMediaRequest';
 /**
  * @class RoapRequest
  */
@@ -19,20 +20,17 @@ export default class RoapRequest extends StatelessWebexPlugin {
      * @param {String} options.locusSelfUrl
      * @param {String} options.mediaId
      * @param {String} options.correlationId
-     * @param {Boolean} options.audioMuted
-     * @param {Boolean} options.videoMuted
      * @param {String} options.meetingId
-     * @param {Boolean} options.preferTranscoding
      * @returns {Promise} returns the response/failure of the request
      */
     sendRoap(options: {
         roapMessage: any;
         locusSelfUrl: string;
         mediaId: string;
-        correlationId: string;
-        audioMuted: boolean;
-        videoMuted: boolean;
         meetingId: string;
-        preferTranscoding?: boolean;
-    }): Promise<any>;
+        locusMediaRequest?: LocusMediaRequest;
+    }): Promise<{
+        mediaConnections: any;
+        locus: any;
+    }>;
 }

package/dist/types/roap/turnDiscovery.d.ts

@@ -49,7 +49,24 @@ export default class TurnDiscovery {
      * @param {Meeting} meeting
      * @returns {Promise}
      */
-    sendRoapOK(meeting: Meeting): Promise<any>;
+    sendRoapOK(meeting: Meeting): Promise<{
+        mediaConnections: any;
+        locus: any;
+    }>;
+    /**
+     * Gets the reason why reachability is skipped.
+     *
+     * @param {Meeting} meeting
+     * @returns {Promise<string>} Promise with empty string if reachability is not skipped or a reason if it is skipped
+     */
+    private getSkipReason;
+    /**
+     * Checks if TURN discovery is skipped.
+     *
+     * @param {Meeting} meeting
+     * @returns {Boolean} true if TURN discovery is being skipped, false if it is being done
+     */
+    isSkipped(meeting: any): Promise<boolean>;
     /**
      * Retrieves TURN server information from the backend by doing
      * a roap message exchange:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webex/plugin-meetings",
-  "version": "3.0.0-bnr.4",
+  "version": "3.0.0-stream-classes.01",
   "description": "",
   "license": "Cisco EULA (https://www.cisco.com/c/en/us/products/end-user-license-agreement.html)",
   "contributors": [
@@ -47,7 +47,7 @@
   },
   "dependencies": {
     "@webex/common": "workspace:^",
-    "@webex/internal-media-core": "1.36.0",
+    "@webex/internal-media-core": "2.0.3",
     "@webex/internal-plugin-conversation": "workspace:^",
     "@webex/internal-plugin-device": "workspace:^",
     "@webex/internal-plugin-llm": "workspace:^",
@@ -66,6 +66,7 @@
     "global": "^4.4.0",
     "ip-anonymize": "^0.1.0",
     "javascript-state-machine": "^3.1.0",
+    "jsonwebtoken": "^8.5.1",
     "lodash": "^4.17.21",
     "sdp-transform": "^2.12.0",
     "uuid": "^3.3.2",

package/src/annotation/annotation.types.ts

@@ -0,0 +1,50 @@
+import {ANNOTATION_POLICY} from './constants';
+
+/**
+ * Type for an StrokeData Object
+ */
+type StrokeData = {
+  deviceId: string;
+  toUserId: string;
+  requesterId: string;
+  content: string;
+  shareInstanceId: string;
+  encryptionKeyUrl: string;
+  version: string;
+};
+
+type RequestData = {
+  toUserId: string;
+  toDeviceUrl: string;
+  shareInstanceId: string;
+};
+
+type CommandRequestBody = {
+  actionType: string;
+  resourceType: string;
+  shareInstanceId: string;
+  receivers?: any[];
+};
+/**
+ * Type for an annotation Object include annotation version and privilege
+ */
+type AnnotationInfo = {
+  version: string;
+  policy: ANNOTATION_POLICY;
+};
+
+interface IAnnotationChannel {
+  // === below is for presenter
+  acceptRequest: (approval) => undefined | Promise<void>;
+  declineRequest: (approval) => undefined | Promise<void>;
+  closeAnnotation: (requestData: RequestData) => undefined | Promise<void>;
+  // === below is for attendee
+  approveAnnotation: (requestData: RequestData) => undefined | Promise<void>;
+  cancelApproveAnnotation: (requestData: RequestData, approval) => undefined | Promise<void>;
+  sendStrokeData: (strokeData: StrokeData) => void;
+  // =====
+  approvalUrlUpdate: (approvalUrl: string) => void;
+  locusUrlUpdate: (locusUrl: string) => void;
+}
+
+export type {StrokeData, RequestData, CommandRequestBody, IAnnotationChannel, AnnotationInfo};