@dataclouder/ngx-agent-cards 0.2.14 → 0.2.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dataclouder/ngx-agent-cards",
-  "version": "0.2.14",
+  "version": "0.2.15",
   "peerDependencies": {
     "@angular/common": ">=18.0.0",
     "@angular/core": ">=18.0.0",

package/types/dataclouder-ngx-agent-cards.d.ts

@@ -433,6 +433,14 @@ interface VoiceCloning {
     transcription: string;
     main: VoiceTTS;
 }
+interface IAgentVoiceSettings {
+    main?: VoiceTTS;
+    secondary?: VoiceTTS;
+    cloning?: {
+        sample?: AudioStorage;
+        transcription?: string;
+    };
+}
 declare enum AgenticEngine {
     SERVER_SDK = "server_sdk",// Loop ReAct local del backend (Vercel AI SDK)
     OS_HERMES = "os_hermes"
@@ -471,6 +479,7 @@ interface IAgentCard {
     learnable?: ILearnable;
     auditable?: IAuditable;
     voiceCloning?: VoiceCloning;
+    voice?: IAgentVoiceSettings;
     agenticConfig?: IAgenticConfig;
     metaApp?: IAgentMetadata;
     live2d?: any;
@@ -612,7 +621,8 @@ declare enum ConversationEvents {
 declare enum ChatEventType {
     WordClicked = "wordClicked",
     MoodDetected = "moodDetected",
-    AudioStarted = "audioStarted"
+    AudioStarted = "audioStarted",
+    AudioStopped = "audioStopped"
 }
 interface ChatEvent<T = any> {
     type: ChatEventType;
@@ -923,17 +933,23 @@ declare class ContextEngineService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ContextEngineService>;
 }
 
+interface AudioStatusUpdate {
+    message: MessageContent;
+    status: AudioStatus;
+}
 declare class ChatMonitorService {
     constructor();
-    private readonly messageAudioWillPlay;
-    readonly messageAudioWillPlay$: _angular_core.Signal<MessageContent>;
-    currentMood: _angular_core.WritableSignal<string[]>;
+    readonly activeAudioMessage: _angular_core.WritableSignal<MessageContent>;
+    currentMood: _angular_core.WritableSignal<string>;
     isConversationActive: _angular_core.WritableSignal<boolean>;
-    logMessageAudioWillPlay(message: MessageContent): void;
-    logCurrentMood(mood: string[]): void;
+    logCurrentMood(mood: string | null): void;
     cleanMonitorVars(): void;
     readonly backgroundUrl: _angular_core.WritableSignal<string>;
     setBackground(imageUrl: string | undefined): void;
+    readonly messageAudioWillPlay$: _angular_core.WritableSignal<MessageContent>;
+    readonly messageAudioStatus$: _angular_core.WritableSignal<AudioStatusUpdate>;
+    logMessageAudioWillPlay(message: MessageContent): void;
+    logMessageAudioStatus(message: MessageContent, status: AudioStatus): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatMonitorService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ChatMonitorService>;
 }
@@ -1002,7 +1018,6 @@ declare function provideLive2D(config: Live2DConfig): {
 };
 
 declare class VideoPlayerService implements OnDestroy {
-    private conversationFlowStateService;
     private player;
     private videoElement;
     private useNativePlayer;
@@ -1011,7 +1026,6 @@ declare class VideoPlayerService implements OnDestroy {
     private videoQueue;
     private defaultVideoUrl;
     private playAndRewindedSubscription;
-    private moodSubscription;
     private playAndRewindedSource;
     playAndRewinded$: rxjs.Observable<void>;
     agentCard: _angular_core.WritableSignal<IAgentCard>;
@@ -1036,14 +1050,12 @@ declare class VideoPlayerService implements OnDestroy {
 }
 
 declare class VideoPlayerNativeService implements OnDestroy {
-    private conversationFlowStateService;
     private videoA;
     private videoB;
     private activeVideo;
     private inactiveVideo;
     private videoQueue;
     private defaultVideoUrl;
-    private moodSubscription;
     private onVideoEndedBound;
     private pendingPlayingHandler;
     private pendingPlayingTarget;
@@ -1080,6 +1092,7 @@ declare class VideoPlayerNativeService implements OnDestroy {
  * `IConversationFlow` configuration that defines the rules of the flow.
  */
 declare class ConversationFlowStateService {
+    private chatMonitorService;
     private readonly initialState;
     /**
      * @description
@@ -1260,7 +1273,6 @@ declare class EvaluationService {
 }
 
 declare class DCChatComponent implements OnInit, OnDestroy {
-    private moodSubscription;
     private injector;
     private userService;
     private dialogService;
@@ -1281,7 +1293,9 @@ declare class DCChatComponent implements OnInit, OnDestroy {
     readonly parseDict: _angular_core.InputSignal<{
         [key: string]: string;
     }>;
+    /** @deprecated Use ChatMonitorService instead — el canal oficial es el servicio compartido. */
     readonly chatEvent: _angular_core.OutputEmitterRef<ChatEvent<any>>;
+    /** @deprecated Use ChatMonitorService instead — el canal oficial es el servicio compartido. */
     readonly goalCompleted: _angular_core.OutputEmitterRef<void>;
     viewMode: _angular_core.WritableSignal<"chat" | "immersive">;
     micSettings: MicSettings;
@@ -1400,8 +1414,6 @@ declare class DCAgentCardFormComponent extends EntityBaseFormComponent<IAgentCar
             userMustStart: _angular_forms.FormControl<boolean>;
             streamResponses: _angular_forms.FormControl<boolean>;
             displayMode: _angular_forms.FormControl<string>;
-            mainVoice: _angular_forms.FormGroup<any>;
-            secondaryVoice: _angular_forms.FormGroup<any>;
             model: _angular_forms.FormGroup<{
                 quality: _angular_forms.FormControl<_dataclouder_ngx_core.EModelQuality>;
                 modelName: _angular_forms.FormControl<string>;
@@ -1434,7 +1446,7 @@ declare class DCAgentCardFormComponent extends EntityBaseFormComponent<IAgentCar
             takenCount: _angular_forms.FormControl<number | null>;
             tags: FormArray<_angular_forms.FormControl<string | null>>;
         }>;
-        voiceCloning: _angular_forms.FormGroup<any>;
+        voice: _angular_forms.FormGroup<any>;
         agenticConfig: _angular_forms.FormGroup<{
             enabled: _angular_forms.FormControl<boolean>;
             engine: _angular_forms.FormControl<AgenticEngine>;
@@ -1562,7 +1574,7 @@ declare class Live2dModelComponent implements AfterViewInit {
         volume?: number;
         crossOrigin?: string;
         focus?: boolean;
-    }): void;
+    }): Promise<void>;
     stopSpeaking(): void;
     updateModelParameter(event: {
         id: string;
@@ -1583,7 +1595,7 @@ declare class Live2dModelComponent implements AfterViewInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<Live2dModelComponent, "app-live2d-model", never, { "modelPath": { "alias": "modelPath"; "required": true; "isSignal": true; }; "scale": { "alias": "scale"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "x": { "alias": "x"; "required": false; "isSignal": true; }; "y": { "alias": "y"; "required": false; "isSignal": true; }; }, { "modelLoaded": "modelLoaded"; "viewStateChanged": "viewStateChanged"; }, never, never, true, never>;
 }
 
-declare class DcAgentCardConverseComponent implements OnInit, OnDestroy {
+declare class DcAgentCardAvatarComponent implements OnInit, OnDestroy {
     private agentCardService;
     private route;
     private toastService;
@@ -1593,10 +1605,10 @@ declare class DcAgentCardConverseComponent implements OnInit, OnDestroy {
     videoPlayerService: VideoPlayerNativeService;
     agentCardId: string;
     useNativePlayer: boolean;
-    activeAudioMessage: MessageContent | null;
     private _isConversationActive;
     set isConversationActive(val: boolean);
     get isConversationActive(): boolean;
+    /** @deprecated Use ChatMonitorService instead — el canal oficial es el servicio compartido. */
     readonly onStartConversation: _angular_core.OutputEmitterRef<IAgentCard>;
     videoPlayerA: _angular_core.Signal<ElementRef<HTMLVideoElement>>;
     videoPlayerB: _angular_core.Signal<ElementRef<HTMLVideoElement>>;
@@ -1622,8 +1634,8 @@ declare class DcAgentCardConverseComponent implements OnInit, OnDestroy {
     private _transformVoice;
     startConversation(): void;
     toggleInfoLayer(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DcAgentCardConverseComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DcAgentCardConverseComponent, "dc-agent-card-converse", never, { "agentCardId": { "alias": "agentCardId"; "required": false; }; "useNativePlayer": { "alias": "useNativePlayer"; "required": false; }; "activeAudioMessage": { "alias": "activeAudioMessage"; "required": false; }; "isConversationActive": { "alias": "isConversationActive"; "required": false; }; }, { "onStartConversation": "onStartConversation"; }, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DcAgentCardAvatarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DcAgentCardAvatarComponent, "dc-agent-card-avatar", never, { "agentCardId": { "alias": "agentCardId"; "required": false; }; "useNativePlayer": { "alias": "useNativePlayer"; "required": false; }; "isConversationActive": { "alias": "isConversationActive"; "required": false; }; }, { "onStartConversation": "onStartConversation"; }, never, never, true, never>;
 }
 
 declare class DcAgentCardDetailComponent extends EntityBaseDetailComponent<IAgentCard> {
@@ -1799,8 +1811,12 @@ declare function buildObjectTTSRequest(message: MessageContent, settings?: ChatU
  * This component orchestrates the display and audio playback of chat messages.
  * It uses the `MessageOrchestrationService` to manage the message queue and audio playback.
  *
+ * Children (`MessageContentReactive`) inject the same `MessageOrchestrationService`
+ * instance directly and report their state to it, so this component no longer needs
+ * to relay per-segment audio events via `@Output()`.
+ *
  * @see MessageOrchestrationService
- * @see MessageContentDisplayer
+ * @see MessageContentReactive
  */
 declare class ChatMessageOrchestratorComponent {
     private orchestrationService;
@@ -1818,31 +1834,6 @@ declare class ChatMessageOrchestratorComponent {
     audioCompleted: _angular_core.OutputEmitterRef<MessageContent>;
     messagesSignal: _angular_core.Signal<MessageContent[]>;
     constructor();
-    /**
-     * @description
-     * Handles the `audioCompleted` event from the `MessageContentDisplayer`.
-     *
-     * @param message - The `MessageContent` object whose audio has finished playing.
-     */
-    onAudioCompleted(message: MessageContent): void;
-    /**
-     * @description
-     * Handles the `audioStatusChanged` event from the `MessageContentDisplayer`.
-     *
-     * @param event - The event object containing the `MessageContent` and its new `AudioStatus`.
-     * @param index - The index of the message in the array.
-     */
-    onAudioStatusChanged(event: {
-        message: MessageContent;
-        status: AudioStatus;
-    }, index: number): void;
-    /**
-     * @description
-     * Handles the `wordClicked` event from the `MessageContentDisplayer`.
-     *
-     * @param wordData - The `WordData` object containing information about the clicked word.
-     */
-    onWordClicked(wordData: WordData): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatMessageOrchestratorComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatMessageOrchestratorComponent, "dc-message-orchestrator", never, { "messages": { "alias": "messages"; "required": true; "isSignal": true; }; "messageRole": { "alias": "messageRole"; "required": true; "isSignal": true; }; }, { "audioCompleted": "audioCompleted"; }, never, never, true, never>;
 }
@@ -2007,5 +1998,5 @@ declare class ChatEngineTestComponent {
 
 declare const AGENT_CARDS_STATE_SERVICE: InjectionToken<MasterStateService<IAgentCard>>;
 
-export { ACCDataGenerationComponent, AGENT_CARDS_STATE_SERVICE, AIGenerationService, AgentCardListComponent, AgentCardUI, AgentCardsGenerationService, AgenticEngine, AgenticPattern, AudioService, AudioSpeed, BACKGROUND_SERVICE_TOKEN, CHAT_OBSERVER_CONFIG, CONVERSATION_AI_TOKEN, CardRouteService, CardRoutesComponent, CardsCreatorComponent, ChatEngineTestComponent, ChatEventType, ChatMessage, ChatMessageOrchestratorComponent, ChatMonitorService, ChatRole, ConditionOperator, ConditionType, ContextEngineService, ContextType, ConversationDTO, ConversationEvents, ConversationFlowStateService, ConversationMessagesDTO, ConversationPromptBuilderService, ConversationRuleService, ConversationRulesComponent, ConversationStatus, ConversationType$1 as ConversationType, ConversationTypeOptions, DCAgentCardFormComponent, DCChatComponent, DCConversationUserChatSettingsComponent, DcAgentCardConverseComponent, DcAgentCardDetailComponent, DcObserverInterventionComponent, DefaultAgentCardsService, DoActionTypeOptions, DynamicFlowService, DynamicFlowTaskTypeOptions, EAccountsPlatform, EAgentType, EDoActionType, EDynamicFlowTaskType, EntityThen, EntityWhatOptions, EntityWhenOptions, EvalResultStringDefinition, GlobalToolsService, LIVE2D_CONFIG, Live2dModelComponent, MessageContent, MessageContentDisplayer, MessagesStateService, ModelSelectorComponent, PolitoNotificationComponent, PopupService, PromptPreviewComponent, SectionType, SystemPromptType, TextEngineOptions, TextEngines, VIDEO_PLAYER_SERVICE_TOKEN, VideoPlayerNativeService, VideoPlayerService, VoiceTTSOption, VoiceTTSOptions, WordTimestamps, XKillsAgentCardsService, buildObjectTTSRequest, characterCardStringDataDefinition, convertToHTML, createAIModelFormGroup, defaultconvUserSettings, extractAudioAndTranscription, extractJsonFromResponse, getMoodStateLabelsAsString, getMoodStatePrompt, markdownToHtml, matchTranscription, provideAgentCardService, provideLive2D, removeEmojis, removeEmojisAndSpecialCharacters, removeSpecialCharacters };
-export type { Appearance, AudioGenerated, AudioStatus, BackgroundTask, CardTranslation, ChangePromptAction, CharacterCardData, ChatEvent, ConversationFlowFormGroup, ConversationSettingsFormGroup, DCAgentFormSettings, DoAction, DoActionFormGroup, DynamicConditionFormGroup, DynamicCriteriaFormGroup, IAccounts, IAgentAssets, IAgentCard, IAgentCardMeta, IAgentMetadata, IAgentResponseDTO, IAgenticConfig, IBackgroundService, ICardRoute, ICardRouteStep, IChallengeState, ICharacterCardDC, IConversationFlow, IConversationFlowState, IConversationSession, IConversationSettings, IConversationSettingsDTO, IDynamicCondition, IDynamicCriteria, IDynamicFlowTask, IGenerateConversationCardsDto, IGoalState, IInterventionState, IMoodState, IMoodStateRuntime, IObserverConfig, IRule, ISimpleAgent, ITTS, IVideoPlayerService, IWordMetadata, Live2DConfig, ModelFormGroup, ModelName, ModelParameters, ModelParts, MultiLanguage, Persona, SimpleAgentTask, SimpleAgentTaskFormGroup, SimpleEvalResult, TextHTMLTag, TranscriptionsWhisper, TriggerTasksFormGroup, VoiceCloning, VoiceTTS, WordData };
+export { ACCDataGenerationComponent, AGENT_CARDS_STATE_SERVICE, AIGenerationService, AgentCardListComponent, AgentCardUI, AgentCardsGenerationService, AgenticEngine, AgenticPattern, AudioService, AudioSpeed, BACKGROUND_SERVICE_TOKEN, CHAT_OBSERVER_CONFIG, CONVERSATION_AI_TOKEN, CardRouteService, CardRoutesComponent, CardsCreatorComponent, ChatEngineTestComponent, ChatEventType, ChatMessage, ChatMessageOrchestratorComponent, ChatMonitorService, ChatRole, ConditionOperator, ConditionType, ContextEngineService, ContextType, ConversationDTO, ConversationEvents, ConversationFlowStateService, ConversationMessagesDTO, ConversationPromptBuilderService, ConversationRuleService, ConversationRulesComponent, ConversationStatus, ConversationType$1 as ConversationType, ConversationTypeOptions, DCAgentCardFormComponent, DCChatComponent, DCConversationUserChatSettingsComponent, DcAgentCardAvatarComponent, DcAgentCardDetailComponent, DcObserverInterventionComponent, DefaultAgentCardsService, DoActionTypeOptions, DynamicFlowService, DynamicFlowTaskTypeOptions, EAccountsPlatform, EAgentType, EDoActionType, EDynamicFlowTaskType, EntityThen, EntityWhatOptions, EntityWhenOptions, EvalResultStringDefinition, GlobalToolsService, LIVE2D_CONFIG, Live2dModelComponent, MessageContent, MessageContentDisplayer, MessagesStateService, ModelSelectorComponent, PolitoNotificationComponent, PopupService, PromptPreviewComponent, SectionType, SystemPromptType, TextEngineOptions, TextEngines, VIDEO_PLAYER_SERVICE_TOKEN, VideoPlayerNativeService, VideoPlayerService, VoiceTTSOption, VoiceTTSOptions, WordTimestamps, XKillsAgentCardsService, buildObjectTTSRequest, characterCardStringDataDefinition, convertToHTML, createAIModelFormGroup, defaultconvUserSettings, extractAudioAndTranscription, extractJsonFromResponse, getMoodStateLabelsAsString, getMoodStatePrompt, markdownToHtml, matchTranscription, provideAgentCardService, provideLive2D, removeEmojis, removeEmojisAndSpecialCharacters, removeSpecialCharacters };
+export type { Appearance, AudioGenerated, AudioStatus, AudioStatusUpdate, BackgroundTask, CardTranslation, ChangePromptAction, CharacterCardData, ChatEvent, ConversationFlowFormGroup, ConversationSettingsFormGroup, DCAgentFormSettings, DoAction, DoActionFormGroup, DynamicConditionFormGroup, DynamicCriteriaFormGroup, IAccounts, IAgentAssets, IAgentCard, IAgentCardMeta, IAgentMetadata, IAgentResponseDTO, IAgentVoiceSettings, IAgenticConfig, IBackgroundService, ICardRoute, ICardRouteStep, IChallengeState, ICharacterCardDC, IConversationFlow, IConversationFlowState, IConversationSession, IConversationSettings, IConversationSettingsDTO, IDynamicCondition, IDynamicCriteria, IDynamicFlowTask, IGenerateConversationCardsDto, IGoalState, IInterventionState, IMoodState, IMoodStateRuntime, IObserverConfig, IRule, ISimpleAgent, ITTS, IVideoPlayerService, IWordMetadata, Live2DConfig, ModelFormGroup, ModelName, ModelParameters, ModelParts, MultiLanguage, Persona, SimpleAgentTask, SimpleAgentTaskFormGroup, SimpleEvalResult, TextHTMLTag, TranscriptionsWhisper, TriggerTasksFormGroup, VoiceCloning, VoiceTTS, WordData };