@dataclouder/ngx-agent-cards 0.2.6 → 0.2.9

package/package.json

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

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

@@ -10,6 +10,7 @@ import { UserService } from '@dataclouder/ngx-users';
 import * as rxjs from 'rxjs';
 import { MicSettings } from '@dataclouder/ngx-mic';
 import * as _dataclouder_ngx_agent_cards from '@dataclouder/ngx-agent-cards';
+import { SafeHtml } from '@angular/platform-browser';
 import * as dist_dataclouder_ngx_knowledge_types_dataclouder_ngx_knowledge from 'dist/dataclouder/ngx-knowledge/types/dataclouder-ngx-knowledge';
 import { MenuItem } from 'primeng/api';
 import * as dist_dataclouder_ngx_core_types_dataclouder_ngx_core from 'dist/dataclouder/ngx-core/types/dataclouder-ngx-core';
@@ -293,6 +294,7 @@ interface IConversationSettings {
 type IConversationSettingsDTO = Partial<IConversationSettings> & {
     returnJson?: boolean;
     type?: string;
+    agentCardId?: string;
 };
 interface IAgentResponseDTO {
     role: ChatRole;
@@ -389,11 +391,25 @@ interface IMoodStateRuntime {
     intensity: number;
     observation?: string;
 }
+interface IObserverConfig {
+    name: string;
+    mascotId: string;
+    avatarSvgRaw?: string;
+    avatarUrl?: string;
+    themeColorClass?: string;
+    sounds?: {
+        intervention?: string;
+    };
+}
+interface IInterventionState {
+    severity: 'grave' | 'warning' | 'info' | 'none';
+    message?: string;
+    suggestedCorrection?: string;
+}
 interface IConversationFlowState {
     goal: {
         value: any;
         deltaPoints?: number;
-        feedback?: string;
     };
     challenges: {
         name: string;
@@ -402,6 +418,7 @@ interface IConversationFlowState {
     moodState: {
         value: any;
     };
+    intervention?: IInterventionState;
 }
 declare enum EAgentType {
     None,
@@ -966,6 +983,7 @@ interface IBackgroundService {
 }
 declare const VIDEO_PLAYER_SERVICE_TOKEN: InjectionToken<IVideoPlayerService>;
 declare const BACKGROUND_SERVICE_TOKEN: InjectionToken<IBackgroundService>;
+declare const CHAT_OBSERVER_CONFIG: InjectionToken<IObserverConfig>;
 
 declare class VideoPlayerService implements OnDestroy {
     private conversationFlowStateService;
@@ -1054,12 +1072,31 @@ declare class ConversationFlowStateService {
      */
     flowState: _angular_core.WritableSignal<IConversationFlowState>;
     currentMood: _angular_core.Signal<any>;
+    /**
+     * @description
+     * UI-only flag (no viene del LLM): el usuario abrió manualmente la intervención
+     * pasiva (no-grave) haciendo click en la pluma. Se resetea en cada turno.
+     */
+    private passiveOpened;
+    /**
+     * @description
+     * Modo de presentación de la intervención del turno actual:
+     *  - 'grave'   => overlay automático y bloqueante
+     *  - 'passive' => hay corrección suave; la pluma es clickeable, el usuario decide
+     *  - 'none'    => nada que mostrar
+     */
+    interventionMode: _angular_core.Signal<"grave" | "none" | "passive">;
+    /** El overlay (mismo para grave y pasivo) se ve si es grave o si el usuario lo abrió. */
+    showIntervention: _angular_core.Signal<boolean>;
+    /** Pausa los controles solo mientras el overlay está visible. */
+    isPaused: _angular_core.Signal<boolean>;
+    /** True cuando hay una corrección pasiva disponible: hace la pluma clickeable. */
+    hasPassiveHint: _angular_core.Signal<boolean>;
     private moodUpdated;
     moodUpdated$: rxjs.Observable<string>;
     private goalEvaluationUpdated;
     goalEvaluationUpdated$: rxjs.Observable<{
         deltaPoints: number;
-        feedback?: string;
     }>;
     constructor();
     /**
@@ -1074,6 +1111,12 @@ declare class ConversationFlowStateService {
      * @param newState A partial `IConversationFlowState` object containing the new values.
      */
     updateState(newState: Partial<IConversationFlowState>): void;
+    /**
+     * @description
+     * El usuario decide abrir la intervención pasiva (no-grave) — típicamente al hacer
+     * click en la pluma mientras cae/flota. Muestra el mismo overlay que el grave.
+     */
+    openPassiveIntervention(): void;
     /**
      * @description
      * Updates the goal state, typically to reflect progress.
@@ -1103,6 +1146,12 @@ declare class ConversationFlowStateService {
         name: string;
         value: any;
     }>): void;
+    /**
+     * @description
+     * Resets the active intervention state back to inactive.
+     * This is called by the UI when the user acknowledges the intervention.
+     */
+    clearIntervention(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ConversationFlowStateService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ConversationFlowStateService>;
 }
@@ -1212,6 +1261,7 @@ declare class DCChatComponent implements OnInit, OnDestroy {
     conversationSettings: IConversationSettings;
     conversationFlow: IConversationFlow | null;
     agentCard: IAgentCard;
+    observerConfig?: IObserverConfig;
     readonly parseDict: _angular_core.InputSignal<{
         [key: string]: string;
     }>;
@@ -1238,7 +1288,7 @@ declare class DCChatComponent implements OnInit, OnDestroy {
     restartConversation(conversation?: IAgentCard | null): Promise<void>;
     complete(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DCChatComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DCChatComponent, "dc-chat", never, { "chatUserSettings": { "alias": "chatUserSettings"; "required": false; }; "conversationSettings": { "alias": "conversationSettings"; "required": false; }; "conversationFlow": { "alias": "conversationFlow"; "required": false; }; "agentCard": { "alias": "agentCard"; "required": false; }; "parseDict": { "alias": "parseDict"; "required": false; "isSignal": true; }; }, { "chatEvent": "chatEvent"; "goalCompleted": "goalCompleted"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DCChatComponent, "dc-chat", never, { "chatUserSettings": { "alias": "chatUserSettings"; "required": false; }; "conversationSettings": { "alias": "conversationSettings"; "required": false; }; "conversationFlow": { "alias": "conversationFlow"; "required": false; }; "agentCard": { "alias": "agentCard"; "required": false; }; "observerConfig": { "alias": "observerConfig"; "required": false; }; "parseDict": { "alias": "parseDict"; "required": false; "isSignal": true; }; }, { "chatEvent": "chatEvent"; "goalCompleted": "goalCompleted"; }, never, never, true, never>;
 }
 
 declare class PolitoNotificationComponent implements OnInit, OnDestroy {
@@ -1246,14 +1296,19 @@ declare class PolitoNotificationComponent implements OnInit, OnDestroy {
     private agentCardStateService;
     notification: _angular_core.WritableSignal<{
         points: number;
-        feedback: string;
     }>;
     isHiding: _angular_core.WritableSignal<boolean>;
+    isClickable: _angular_core.Signal<boolean>;
     private subscription;
     private hideTimeout;
     private animTimeout;
     ngOnInit(): void;
     ngOnDestroy(): void;
+    /**
+     * El usuario hace click en la pluma (cayendo o flotando) para abrir la intervención
+     * pasiva. Solo tiene efecto si hay una corrección suave disponible este turno.
+     */
+    onPlumaClick(): void;
     private showNotification;
     private clearTimeouts;
     getPointsText(points: number): string;
@@ -1262,6 +1317,20 @@ declare class PolitoNotificationComponent implements OnInit, OnDestroy {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PolitoNotificationComponent, "dc-polito-notification", never, {}, {}, never, never, true, never>;
 }
 
+declare class DcObserverInterventionComponent {
+    private flowStateService;
+    private sanitizer;
+    customConfig?: IObserverConfig;
+    private diConfig;
+    intervention: _angular_core.Signal<_dataclouder_ngx_agent_cards.IInterventionState>;
+    isActive: _angular_core.Signal<boolean>;
+    config: _angular_core.Signal<IObserverConfig>;
+    safeSvg: _angular_core.Signal<SafeHtml>;
+    handleAcknowledge(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DcObserverInterventionComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DcObserverInterventionComponent, "dc-observer-intervention", never, { "customConfig": { "alias": "customConfig"; "required": false; }; }, {}, never, never, true, never>;
+}
+
 interface DCAgentFormSettings {
     converseRoute?: any[] | ((entityId: string) => any[]);
 }
@@ -1421,12 +1490,16 @@ declare class DcAgentCardConverseComponent implements OnInit, OnDestroy {
     videoPlayerService: VideoPlayerNativeService;
     agentCardId: string;
     useNativePlayer: boolean;
+    private _isConversationActive;
+    set isConversationActive(val: boolean);
+    get isConversationActive(): boolean;
     readonly onStartConversation: _angular_core.OutputEmitterRef<IAgentCard>;
     videoPlayerA: _angular_core.Signal<ElementRef<HTMLVideoElement>>;
     videoPlayerB: _angular_core.Signal<ElementRef<HTMLVideoElement>>;
     agentCard: _angular_core.WritableSignal<IAgentCard>;
     showInfoLayer: _angular_core.WritableSignal<boolean>;
     isTransparent: _angular_core.Signal<boolean>;
+    isChatActive: _angular_core.Signal<boolean>;
     constructor();
     ngOnDestroy(): void;
     ngOnInit(): Promise<void>;
@@ -1435,7 +1508,7 @@ declare class DcAgentCardConverseComponent implements OnInit, OnDestroy {
     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; }; }, { "onStartConversation": "onStartConversation"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DcAgentCardConverseComponent, "dc-agent-card-converse", 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> {
@@ -1819,5 +1892,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, 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, DefaultAgentCardsService, DoActionTypeOptions, DynamicFlowService, DynamicFlowTaskTypeOptions, EAccountsPlatform, EAgentType, EDoActionType, EDynamicFlowTaskType, EntityThen, EntityWhatOptions, EntityWhenOptions, EvalResultStringDefinition, GlobalToolsService, 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, 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, IMoodState, IMoodStateRuntime, IRule, ISimpleAgent, ITTS, IVideoPlayerService, IWordMetadata, ModelFormGroup, ModelName, 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, DcAgentCardConverseComponent, DcAgentCardDetailComponent, DcObserverInterventionComponent, DefaultAgentCardsService, DoActionTypeOptions, DynamicFlowService, DynamicFlowTaskTypeOptions, EAccountsPlatform, EAgentType, EDoActionType, EDynamicFlowTaskType, EntityThen, EntityWhatOptions, EntityWhenOptions, EvalResultStringDefinition, GlobalToolsService, 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, 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, ModelFormGroup, ModelName, MultiLanguage, Persona, SimpleAgentTask, SimpleAgentTaskFormGroup, SimpleEvalResult, TextHTMLTag, TranscriptionsWhisper, TriggerTasksFormGroup, VoiceCloning, VoiceTTS, WordData };