@dataclouder/ngx-agent-cards 0.1.78 → 0.1.79

package/index.d.ts

@@ -897,6 +897,75 @@ declare class VideoPlayerService implements OnDestroy {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<VideoPlayerService>;
 }
 
+/**
+ * @description
+ * Service responsible for managing the real-time, dynamic state of a conversation flow.
+ *
+ * This service acts as a single source of truth for the evolving aspects of a conversation,
+ * such as the user's progress toward a goal, completed challenges, and the agent's current mood.
+ * It uses Angular Signals to provide a reactive state that can be observed by UI components
+ * and other services.
+ *
+ * The state managed here is the **runtime state**, which is distinct from the static
+ * `IConversationFlow` configuration that defines the rules of the flow.
+ */
+declare class ConversationFlowStateService {
+    private readonly initialState;
+    /**
+     * @description
+     * A reactive signal holding the current conversation flow state.
+     * Components and services can subscribe to this signal to get real-time updates.
+     */
+    flowState: _angular_core.WritableSignal<IConversationFlowState>;
+    currentMood: _angular_core.Signal<any>;
+    private moodUpdated;
+    moodUpdated$: rxjs.Observable<string>;
+    constructor();
+    /**
+     * @description
+     * Resets the conversation flow state to its initial default values.
+     * This is typically called at the beginning of a new conversation session.
+     */
+    resetState(): void;
+    /**
+     * @description
+     * Updates the entire flow state with a new state object.
+     * @param newState A partial `IConversationFlowState` object containing the new values.
+     */
+    updateState(newState: Partial<IConversationFlowState>): void;
+    /**
+     * @description
+     * Updates the goal state, typically to reflect progress.
+     * The value should represent the goal's progress (e.g., a percentage).
+     * @param goalState A partial `{ name: string; value: any }` object for the goal.
+     */
+    updateGoalState(goalState: Partial<{
+        name: string;
+        value: any;
+    }>): void;
+    /**
+     * @description
+     * Updates an existing challenge or adds a new one.
+     * The value for a challenge should typically be a boolean indicating completion.
+     * @param challenge A `{ name: string; value: any }` object representing the challenge state.
+     */
+    updateChallengeState(challenge: {
+        name: string;
+        value: any;
+    }): void;
+    /**
+     * @description
+     * Updates the agent's current mood state.
+     * @param moodState A partial `{ name: string; value: any }` object for the mood.
+     */
+    updateMoodState(moodState: Partial<{
+        name: string;
+        value: any;
+    }>): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ConversationFlowStateService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ConversationFlowStateService>;
+}
+
 declare class ConversationRuleService extends EntityCommunicationService<IConversationRule> {
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ConversationRuleService, never>;
@@ -1495,5 +1564,5 @@ declare class ChatEngineTestComponent {
 
 declare const AGENT_CARDS_STATE_SERVICE: InjectionToken<MasterStateService<IAgentCard>>;
 
-export { ACCDataGenerationComponent, AGENT_CARDS_STATE_SERVICE, AIGenerationService, AgentCardListComponent, AgentCardUI, AgentCardsGenerationService, AudioService, AudioSpeed, BACKGROUND_SERVICE_TOKEN, CONVERSATION_AI_TOKEN, CardsCreatorComponent, ChatEngineTestComponent, ChatEventType, ChatMessage, ChatMessageOrchestratorComponent, ChatMonitorService, ChatRole, ConditionOperator, ConditionType, ContextEngineService, ContextType, ConversationDTO, ConversationEvents, ConversationMessagesDTO, ConversationPromptBuilderService, ConversationRuleService, ConversationRulesComponent, ConversationType$1 as ConversationType, ConversationTypeOptions, DCAgentCardFormComponent, DCChatComponent, DCConversationUserChatSettingsComponent, DcAgentCardDetailsComponent, DefaultAgentCardsService, DoActionTypeOptions, DynamicFlowService, DynamicFlowTaskTypeOptions, EAccountsPlatform, EAgentType, EDoActionType, EDynamicFlowTaskType, EntityThen, EntityWhatOptions, EntityWhenOptions, EvalResultStringDefinition, GlobalToolsService, MessageContent, MessageContentDisplayer, MessagesStateService, ModelSelectorComponent, PopupService, PromptPreviewComponent, SectionType, SystemPromptType, TextEngineOptions, TextEngines, VIDEO_PLAYER_SERVICE_TOKEN, VideoPlayerService, VoiceTTSOption, VoiceTTSOptions, WordTimestamps, buildObjectTTSRequest, characterCardStringDataDefinition, convertToHTML, createAIModelFormGroup, defaultconvUserSettings, extractAudioAndTranscription, extractJsonFromResponse, getMoodStateLabelsAsString, getMoodStatePrompt, markdownToHtml, matchTranscription, provideAgentCardService, removeEmojis, removeEmojisAndSpecialCharacters, removeSpecialCharacters };
+export { ACCDataGenerationComponent, AGENT_CARDS_STATE_SERVICE, AIGenerationService, AgentCardListComponent, AgentCardUI, AgentCardsGenerationService, AudioService, AudioSpeed, BACKGROUND_SERVICE_TOKEN, CONVERSATION_AI_TOKEN, CardsCreatorComponent, ChatEngineTestComponent, ChatEventType, ChatMessage, ChatMessageOrchestratorComponent, ChatMonitorService, ChatRole, ConditionOperator, ConditionType, ContextEngineService, ContextType, ConversationDTO, ConversationEvents, ConversationFlowStateService, ConversationMessagesDTO, ConversationPromptBuilderService, ConversationRuleService, ConversationRulesComponent, ConversationType$1 as ConversationType, ConversationTypeOptions, DCAgentCardFormComponent, DCChatComponent, DCConversationUserChatSettingsComponent, DcAgentCardDetailsComponent, DefaultAgentCardsService, DoActionTypeOptions, DynamicFlowService, DynamicFlowTaskTypeOptions, EAccountsPlatform, EAgentType, EDoActionType, EDynamicFlowTaskType, EntityThen, EntityWhatOptions, EntityWhenOptions, EvalResultStringDefinition, GlobalToolsService, MessageContent, MessageContentDisplayer, MessagesStateService, ModelSelectorComponent, PopupService, PromptPreviewComponent, SectionType, SystemPromptType, TextEngineOptions, TextEngines, VIDEO_PLAYER_SERVICE_TOKEN, VideoPlayerService, VoiceTTSOption, VoiceTTSOptions, WordTimestamps, buildObjectTTSRequest, characterCardStringDataDefinition, convertToHTML, createAIModelFormGroup, defaultconvUserSettings, extractAudioAndTranscription, extractJsonFromResponse, getMoodStateLabelsAsString, getMoodStatePrompt, markdownToHtml, matchTranscription, provideAgentCardService, removeEmojis, removeEmojisAndSpecialCharacters, removeSpecialCharacters };
 export type { Appearance, AudioGenerated, AudioState, BackgroundTask, CardTranslation, ChangePromptAction, CharacterCardData, ChatEvent, ConversationFlowFormGroup, ConversationSettingsFormGroup, DoAction, DoActionFormGroup, DynamicConditionFormGroup, DynamicCriteriaFormGroup, IAccounts, IAgentAssets, IAgentCard, IAgentCardMeta, IAgentMetadata, IAgentResponseDTO, IBackgroundService, IChallengeState, ICharacterCardDC, IConversationFlow, IConversationFlowState, 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 };

package/package.json

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