@cognigy/rest-api-client 2025.24.0 → 2025.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/CHANGELOG.md +5 -0
  2. package/build/shared/charts/descriptors/index.js +5 -1
  3. package/build/shared/charts/descriptors/placeholder.js +3 -0
  4. package/build/shared/charts/descriptors/service/agentTools/handoverToAiAgentTool.js +192 -0
  5. package/build/shared/charts/descriptors/service/agentTools/sendEmailTool.js +243 -0
  6. package/build/shared/charts/descriptors/service/aiAgent/aiAgentJob.js +1 -1
  7. package/build/shared/charts/descriptors/service/cxone/knowledgehub/CXoneKnowledgehub.js +198 -0
  8. package/build/shared/charts/descriptors/service/cxone/knowledgehub/CXoneKnowledgehubConnection.js +16 -0
  9. package/build/shared/charts/descriptors/service/cxone/knowledgehub/CXoneKnowledgehubForm.js +300 -0
  10. package/build/shared/charts/descriptors/service/cxone/knowledgehub/CXoneKnowledgehubProviderModule.js +16 -0
  11. package/build/shared/charts/descriptors/service/index.js +5 -1
  12. package/build/shared/charts/descriptors/service/llmPrompt/LLMPromptV2.js +1 -1
  13. package/build/shared/charts/descriptors/voice/mappers/setSessionConfig.mapper.js +12 -16
  14. package/build/shared/constants.js +2 -1
  15. package/build/shared/interfaces/IOrganisation.js +1 -0
  16. package/build/shared/interfaces/cxone/knowledgehub/CXoneKnowledgehubAPI.js +3 -0
  17. package/build/shared/interfaces/resources/IAuditEvent.js +1 -0
  18. package/build/shared/interfaces/restAPI/simulation/simulationRun/ISimulationRunRest_2_0.js +15 -1
  19. package/build/shared/interfaces/restAPI/simulation/simulationRunBatch/ISimulationRunBatchRest_2_0.js +6 -1
  20. package/dist/esm/shared/charts/descriptors/index.js +4 -1
  21. package/dist/esm/shared/charts/descriptors/placeholder.js +3 -0
  22. package/dist/esm/shared/charts/descriptors/service/agentTools/handoverToAiAgentTool.js +190 -0
  23. package/dist/esm/shared/charts/descriptors/service/agentTools/sendEmailTool.js +241 -0
  24. package/dist/esm/shared/charts/descriptors/service/aiAgent/aiAgentJob.js +1 -1
  25. package/dist/esm/shared/charts/descriptors/service/cxone/knowledgehub/CXoneKnowledgehub.js +196 -0
  26. package/dist/esm/shared/charts/descriptors/service/cxone/knowledgehub/CXoneKnowledgehubConnection.js +13 -0
  27. package/dist/esm/shared/charts/descriptors/service/cxone/knowledgehub/CXoneKnowledgehubForm.js +297 -0
  28. package/dist/esm/shared/charts/descriptors/service/cxone/knowledgehub/CXoneKnowledgehubProviderModule.js +13 -0
  29. package/dist/esm/shared/charts/descriptors/service/index.js +2 -0
  30. package/dist/esm/shared/charts/descriptors/service/llmPrompt/LLMPromptV2.js +1 -1
  31. package/dist/esm/shared/charts/descriptors/voice/mappers/setSessionConfig.mapper.js +12 -16
  32. package/dist/esm/shared/constants.js +1 -0
  33. package/dist/esm/shared/interfaces/IOrganisation.js +1 -0
  34. package/dist/esm/shared/interfaces/cxone/knowledgehub/CXoneKnowledgehubAPI.js +2 -0
  35. package/dist/esm/shared/interfaces/resources/IAuditEvent.js +1 -0
  36. package/dist/esm/shared/interfaces/restAPI/simulation/simulationRun/ISimulationRunRest_2_0.js +14 -0
  37. package/dist/esm/shared/interfaces/restAPI/simulation/simulationRunBatch/ISimulationRunBatchRest_2_0.js +5 -0
  38. package/package.json +1 -1
  39. package/types/index.d.ts +199 -18
package/types/index.d.ts CHANGED
@@ -3028,9 +3028,8 @@ export interface IVoiceGateway2VadParams {
3028
3028
  voiceMs?: number;
3029
3029
  mode?: number;
3030
3030
  }
3031
- export declare type TVoiceGateway2TTSVendor = "aws" | "deepgram" | "elevenlabs" | "google" | "microsoft" | "nuance" | "default" | "custom";
3032
3031
  export interface IVoiceGateway2SynthesizerParams {
3033
- vendor?: TVoiceGateway2TTSVendor | "default" | "none";
3032
+ vendor?: string;
3034
3033
  language?: string;
3035
3034
  voice?: string;
3036
3035
  label?: string;
@@ -3045,11 +3044,10 @@ export interface IVoiceGateway2SynthesizerParams {
3045
3044
  disableCache?: boolean;
3046
3045
  model?: string;
3047
3046
  }
3048
- export declare type TVoiceGateway2STTVendor = "aws" | "deepgram" | "google" | "microsoft" | "nuance" | "soniox" | "default" | "custom";
3049
3047
  export declare type TVoiceGateway2GoogleModel = "latest_short" | "latest_long" | "command_and_search" | "phone_call" | "video" | "medical_dictation" | "medical_conversation" | "default";
3050
3048
  export declare type VoiceGatewayDeepgramModel = "base" | "base-phonecall" | "base-meeting" | "base-finance" | "base-voicemail" | "base-conversationalai" | "base-video" | "enhanced" | "enhanced-phonecall" | "enhanced-meeting" | "enhanced-finance" | "nova" | "nova-phonecall" | "nova-2" | "nova-2-meeting" | "nova-2-phonecall" | "nova-2-voicemail" | "nova-2-finance" | "nova-2-conversationalai" | "nova-2-medical" | "nova-2-drivethru" | "nova-2-automotive" | "whisper" | "whisper-tiny" | "whisper-base" | "whisper-small" | "whisper-large";
3051
3049
  export interface IVoiceGateway2RecognizerParams {
3052
- vendor?: TVoiceGateway2STTVendor | "default" | "none";
3050
+ vendor?: string;
3053
3051
  language?: string;
3054
3052
  label?: string;
3055
3053
  fallbackVendor?: string;
@@ -3445,6 +3443,9 @@ export interface IVoiceGatewayEndpointSettings extends IEndpointSessionSettings
3445
3443
  privacyNotice: Omit<IWebchat3EndpointPrivacyNoticeSettings, "title"> & {
3446
3444
  cancelButtonText: string;
3447
3445
  };
3446
+ transcription: {
3447
+ enabled: boolean;
3448
+ };
3448
3449
  }
3449
3450
  export declare type AnyEndpointSettings = IFacebookEndpointSettings | IWorkplaceEndpointSettings | ISlackEndpointSettings | IGenericEndpointSettings | IAlexaEndpointSettings | IWebchat2EndpointSettings | IWebchat3EndpointSettings | ILineEndpointSettings | ITwilioEndpointSettings | ITwilioSmsEndpointSettings | IIntercomEndpointSettings | IRealtimeEndpointSettings | ISunshineConversationsEndpointSettings | IAvayaEndpointSettings | IUserlikeEndpointSettings | IBandwidthEndpointSettings | IAudioCodesEndpointSettings | IWhatsAppEndpointSettings | IAmazonLexEndpointSettings | IEightByEightEndpointSettings | IMicrosoftBotFrameworkEndpointSettings | IVoiceGatewayEndpointSettings | IGenesysBotConnectorEndpointSettings | INiceCXOneEndpointSettings | INiceCXOneAAHEndpointSettings | IAgentAssistVoiceEndpointSettings | IZoomContactCenterEndpointSettings | {};
3450
3451
  export declare type TAvayaVoice = "man" | "woman" | string;
@@ -9677,7 +9678,7 @@ export interface ISpeakingStyle {
9677
9678
  export interface IVoiceConfigParams {
9678
9679
  ttsVoice: string;
9679
9680
  ttsLanguage: string;
9680
- ttsVendor: TVoiceGateway2TTSVendor | "none";
9681
+ ttsVendor: string;
9681
9682
  ttsModel: string;
9682
9683
  ttsLabel: string;
9683
9684
  ttsDisableCache: boolean;
@@ -10691,6 +10692,101 @@ export interface IChartExecutableNode<C extends INodeFunctionBaseParams = INodeF
10691
10692
  isDisabled: boolean;
10692
10693
  analyticsLabel?: string;
10693
10694
  }
10695
+ /**
10696
+ * @param meta.contactNumber DirectQuery views this is as an identifier similar to a session ID
10697
+ */
10698
+ export interface ICXoneKnowledgehubRequestBody {
10699
+ schemaVersion?: string;
10700
+ timestamp: string;
10701
+ meta: {
10702
+ tenantId?: string;
10703
+ contactNumber: string;
10704
+ agentUid?: string;
10705
+ provider: string;
10706
+ };
10707
+ query: {
10708
+ uid: string;
10709
+ text: string;
10710
+ persona?: string;
10711
+ language?: string;
10712
+ };
10713
+ kbFiltering?: {
10714
+ conversationContextRefId?: string;
10715
+ filters?: string;
10716
+ };
10717
+ config: {
10718
+ kbAnswers: {
10719
+ promptEditorProfileId?: string;
10720
+ answers: {
10721
+ enabled: boolean;
10722
+ maxWords: number;
10723
+ };
10724
+ images: {
10725
+ enabled: boolean;
10726
+ maxImages: number;
10727
+ };
10728
+ links: {
10729
+ enabled: boolean;
10730
+ maxLinks: number;
10731
+ };
10732
+ };
10733
+ kbProcessSteps: {
10734
+ enabled: boolean;
10735
+ maxSteps: number;
10736
+ maxTitleWords: number;
10737
+ maxStepWords: number;
10738
+ };
10739
+ awsBedrock: {
10740
+ knowledgeHubId: string;
10741
+ awsBedrockKbId: string;
10742
+ maxKernels: number;
10743
+ shareable: boolean;
10744
+ promptTemplate?: {
10745
+ textPromptTemplate: string;
10746
+ modelArn: string;
10747
+ };
10748
+ };
10749
+ };
10750
+ }
10751
+ export interface ICXoneKnowledgehubResponseBody {
10752
+ timestamp: string;
10753
+ kbAnswers: {
10754
+ uid: string;
10755
+ conversationContextRefId?: string;
10756
+ kbCompletions: Array<{
10757
+ uid: string;
10758
+ kbCompletion: string;
10759
+ restriction: "Public" | "Private" | "Combine";
10760
+ citations: Array<{
10761
+ text: string;
10762
+ start: number;
10763
+ end: number;
10764
+ }>;
10765
+ }>;
10766
+ kbImages: Array<{
10767
+ uid: string;
10768
+ pageId: number;
10769
+ title: string;
10770
+ link: string;
10771
+ thumbnail: string;
10772
+ restriction: "Public" | "Private";
10773
+ }>;
10774
+ kbLinks: Array<{
10775
+ uid: string;
10776
+ pageId: number;
10777
+ title: string;
10778
+ link: string;
10779
+ restriction: "Public" | "Private";
10780
+ }>;
10781
+ };
10782
+ }
10783
+ export interface INiceCXoneKnowledgehubFields {
10784
+ accessKey: string;
10785
+ secretKey: string;
10786
+ clientId?: string;
10787
+ clientSecret?: string;
10788
+ endpointUrl?: string;
10789
+ }
10694
10790
  export interface IGetConversationTranscriptParams {
10695
10791
  turnLimit: number;
10696
10792
  }
@@ -10858,6 +10954,7 @@ export interface IActions {
10858
10954
  getEndpointSettings: () => IEndpointSettings;
10859
10955
  getTranscript: (options: TReadTranscriptOptions) => Promise<TTranscriptEntry[]>;
10860
10956
  addTranscriptStep: (content: TTranscriptEntryContent) => Promise<void>;
10957
+ executeNiceCxoneKnowledgehubApiRequest(knowledgehubConnection: INiceCXoneKnowledgehubFields, requestBody: ICXoneKnowledgehubRequestBody): Promise<ICXoneKnowledgehubResponseBody>;
10861
10958
  }
10862
10959
  export interface IGetMetaDataActionValue {
10863
10960
  sessionId: string;
@@ -16803,7 +16900,7 @@ export interface IVoiceConfigParams {
16803
16900
  ttsVoice: string;
16804
16901
  ttsLanguage: string;
16805
16902
  ttsModel: string;
16806
- ttsVendor: TVoiceGateway2TTSVendor | "default" | "none";
16903
+ ttsVendor: string;
16807
16904
  ttsLabel: string;
16808
16905
  azureSttContextId: string;
16809
16906
  azureSpeechRecognitionMode: string;
@@ -16916,7 +17013,7 @@ export interface IVoiceConfigParams {
16916
17013
  sttHintsDynamicHints: string[] | undefined;
16917
17014
  ttsVoice: string;
16918
17015
  ttsLanguage: string;
16919
- ttsVendor: TVoiceGateway2TTSVendor;
17016
+ ttsVendor: string;
16920
17017
  ttsModel: string;
16921
17018
  sttDisablePunctuation: boolean;
16922
17019
  azureSttContextId: string;
@@ -21475,7 +21572,8 @@ declare const actionTypes: readonly [
21475
21572
  "loginSucceeded",
21476
21573
  "loginFailed",
21477
21574
  "loginError",
21478
- "unauthorized"
21575
+ "unauthorized",
21576
+ "disableCreditCardRedaction"
21479
21577
  ];
21480
21578
  export declare type TActionType = typeof actionTypes[number];
21481
21579
  /**
@@ -22442,6 +22540,9 @@ export interface ISetupVoiceGatewayRestData_2_0 extends ISetupVoiceGatewayRestDa
22442
22540
  * businessUnitId:
22443
22541
  * type: string
22444
22542
  * description: The business unit ID
22543
+ * tenantId:
22544
+ * type: string
22545
+ * description: The tenant ID
22445
22546
  * IOrganisation_2_0:
22446
22547
  * allOf:
22447
22548
  * - $ref: '#/components/schemas/IOrganisationData_2_0'
@@ -22465,6 +22566,8 @@ export interface IOrganisation_2_0 {
22465
22566
  name: string;
22466
22567
  /** The business unit ID */
22467
22568
  businessUnitId?: string;
22569
+ /** The tenant ID */
22570
+ tenantId?: string;
22468
22571
  /** Flag whether this organisation is currently disabled */
22469
22572
  disabled: boolean;
22470
22573
  /** Optional quota information */
@@ -22565,6 +22668,9 @@ export interface IOrganisationDataPrivacySettings_2_0 {
22565
22668
  * businessUnitId:
22566
22669
  * type: string
22567
22670
  * description: The business unit ID
22671
+ * tenantId:
22672
+ * type: string
22673
+ * description: The tenant ID
22568
22674
  * name:
22569
22675
  * type: string
22570
22676
  * description: The name of this organisation
@@ -22605,6 +22711,8 @@ export interface IOrganisationIndexItem_2_0 {
22605
22711
  name: string;
22606
22712
  /** The business unit ID */
22607
22713
  businessUnitId?: string;
22714
+ /** The tenant ID */
22715
+ tenantId?: string;
22608
22716
  /** Flag whether this organisation is currently disabled */
22609
22717
  disabled: boolean;
22610
22718
  /** Optional quota information */
@@ -23454,6 +23562,8 @@ export interface IProjectMetadataRest_2_0 {
23454
23562
  }
23455
23563
  export interface ISimulationRest_2_0 extends IProjectMetadataRest_2_0 {
23456
23564
  id: string;
23565
+ _id: string;
23566
+ referenceId: string;
23457
23567
  name: string;
23458
23568
  persona: string;
23459
23569
  personaName: string;
@@ -23461,13 +23571,17 @@ export interface ISimulationRest_2_0 extends IProjectMetadataRest_2_0 {
23461
23571
  successCriteria: ISuccessCriteriaRest_2_0[];
23462
23572
  maxTurns?: number;
23463
23573
  timeout?: number;
23574
+ aiAgentReferenceId?: string;
23575
+ aiAgentId?: string;
23576
+ flowReferenceId?: string;
23577
+ flowId?: string;
23578
+ jobNodeId?: string;
23464
23579
  createdAt?: number;
23465
23580
  createdBy: string;
23466
23581
  updatedAt?: number;
23467
23582
  updatedBy: string;
23468
23583
  lastChanged: number;
23469
23584
  lastChangedBy?: string;
23470
- expiresAt?: Date;
23471
23585
  }
23472
23586
  export interface IIndexSimulationsRestDataQuery_2_0 {
23473
23587
  projectId?: string;
@@ -23608,6 +23722,34 @@ declare enum ESentimentTypeRest_2_0 {
23608
23722
  NEUTRAL = "NEUTRAL",
23609
23723
  NEGATIVE = "NEGATIVE"
23610
23724
  }
23725
+ declare enum ESimulationStatusRest_2_0 {
23726
+ SUCCESS = "success",
23727
+ FAILED = "failed",
23728
+ ERROR = "error"
23729
+ }
23730
+ declare enum ESimulationErrorCategoryRest_2_0 {
23731
+ NONE = "none",
23732
+ AI_AGENT_TIMEOUT = "ai_agent_timeout",
23733
+ LLM_PROVIDER_ERROR = "llm_provider_error",
23734
+ AI_AGENT_ERROR = "ai_agent_error",
23735
+ UNKNOWN = "unknown"
23736
+ }
23737
+ export interface ISimulationErrorInfoRest_2_0 {
23738
+ category: ESimulationErrorCategoryRest_2_0;
23739
+ message?: string;
23740
+ technicalDetails?: string;
23741
+ }
23742
+ export interface ISuccessRateRest_2_0 {
23743
+ percentage: number;
23744
+ fraction: string;
23745
+ achieved: number;
23746
+ total: number;
23747
+ }
23748
+ export interface ISuccessCriterionResultRest_2_0 {
23749
+ criterion: ISuccessCriteriaRest_2_0;
23750
+ achieved: boolean;
23751
+ reason: string;
23752
+ }
23611
23753
  export interface ISimulationRunRest_2_0 {
23612
23754
  id: string;
23613
23755
  organisationReference: string;
@@ -23616,15 +23758,21 @@ export interface ISimulationRunRest_2_0 {
23616
23758
  simulationRunBatchReference: string;
23617
23759
  sequence: number;
23618
23760
  largeLanguageModelReferenceId: string;
23761
+ endPointType?: string;
23619
23762
  turns: ITurnRest_2_0[];
23620
23763
  totalTurns: number;
23764
+ maxTurns?: number;
23621
23765
  successCriteria: ISuccessCriteriaRest_2_0[];
23622
23766
  metrics: {
23623
23767
  sentiment: ESentimentTypeRest_2_0;
23624
- outOfScope: string;
23625
- efficiency: number;
23626
- topic: string;
23627
23768
  success: boolean;
23769
+ results?: ISuccessCriterionResultRest_2_0[];
23770
+ successRate?: ISuccessRateRest_2_0;
23771
+ summary?: string;
23772
+ isBatchStopped?: boolean;
23773
+ isConversationEnded?: boolean;
23774
+ errorInfo?: ISimulationErrorInfoRest_2_0;
23775
+ status?: ESimulationStatusRest_2_0;
23628
23776
  };
23629
23777
  createdAt: number;
23630
23778
  createdBy: string;
@@ -23640,30 +23788,63 @@ export declare type TSimulationRunBatchStatusRest_2_0 = typeof SimulationRunBatc
23640
23788
  export interface IBatchSuccessCriteriaOverview_2_0 extends ISuccessCriteriaRest_2_0 {
23641
23789
  percentage: number;
23642
23790
  }
23791
+ export interface IEfficiencyScoreRest_2_0 {
23792
+ label: string;
23793
+ start: number;
23794
+ end: number;
23795
+ counter: number;
23796
+ }
23797
+ export interface IAverageSuccessRateForRunsRest_2_0 {
23798
+ percentage: number;
23799
+ fraction: string;
23800
+ achieved: number;
23801
+ total: number;
23802
+ average: number;
23803
+ }
23804
+ export interface IBatchMetricsRest_2_0 {
23805
+ _v: number;
23806
+ efficiencyScore?: IEfficiencyScoreRest_2_0[];
23807
+ turnsDistribution?: IEfficiencyScoreRest_2_0[];
23808
+ successRate?: number;
23809
+ averageSuccessRateForRuns?: IAverageSuccessRateForRunsRest_2_0;
23810
+ successCriterias?: IBatchSuccessCriteriaOverview_2_0[];
23811
+ averageTurns?: number;
23812
+ averageSentiment?: string;
23813
+ runResults?: {
23814
+ succeeded: number;
23815
+ failed: number;
23816
+ notExecuted?: number;
23817
+ };
23818
+ }
23643
23819
  export interface ISimulationRunBatchRest_2_0 {
23644
23820
  id: string;
23821
+ _id: string;
23645
23822
  name: string;
23646
23823
  status: TSimulationRunBatchStatusRest_2_0;
23647
23824
  numberOfExecutions: number;
23648
- successRate?: number;
23649
- efficiency?: number;
23650
23825
  simulationReference: string;
23651
23826
  projectReference: string;
23652
23827
  organisationReference: string;
23828
+ endPointType?: string;
23653
23829
  runConfig: {
23654
23830
  flowReferenceId: string;
23655
23831
  localeReferenceId?: string;
23656
23832
  entrypoint: string;
23833
+ largeLanguageModelReferenceId: string;
23834
+ userId?: string;
23835
+ finalPing?: number;
23836
+ };
23837
+ simulationFrozen: {
23838
+ persona: string;
23839
+ personaName: string;
23840
+ mission: string;
23657
23841
  };
23658
23842
  createdAt: number;
23659
23843
  createdBy: string;
23660
- largeLanguageModelReferenceId: string;
23661
23844
  updatedAt?: number;
23662
23845
  completedAt?: number;
23663
23846
  expiresAt?: Date;
23664
- batchMetrics?: {
23665
- results?: IBatchSuccessCriteriaOverview_2_0[];
23666
- };
23847
+ batchMetrics?: IBatchMetricsRest_2_0;
23667
23848
  }
23668
23849
  export interface IIndexSimulationRunBatchesRestDataQuery_2_0 {
23669
23850
  projectId: string;