@dataclouder/ngx-agent-cards 0.1.72 → 0.1.74

package/index.d.ts

@@ -1,7 +1,7 @@
 import { ImgStorageData, BasicStorage, AudioStorage, IAssetable, StorageImageSettings, FileStorageData } from '@dataclouder/ngx-cloud-storage';
 import { AudioEffectType, TTSRequest } from '@dataclouder/ngx-ai-services';
 import * as _dataclouder_ngx_core from '@dataclouder/ngx-core';
-import { ChatUserSettings, EModelQuality, IAuditable, IAIModel, IManageable, ILearnable, EntityCommunicationService, FiltersConfig, IFilterQueryResponse, HttpCoreService, EntityBaseFormComponent, EntityBaseListComponent, ICustomFilter, PColumn, OnActionEvent, formatCamelCaseString } from '@dataclouder/ngx-core';
+import { ChatUserSettings, EModelQuality, IAuditable, IAIModel, IManageable, ILearnable, EntityCommunicationService, FiltersConfig, IFilterQueryResponse, HttpCoreService, EntityBaseFormComponent, EntityBaseListV2Component, ICustomFilter, PColumn, OnActionEvent, formatCamelCaseString } from '@dataclouder/ngx-core';
 import * as _angular_forms from '@angular/forms';
 import { FormGroup, FormControl, FormArray } from '@angular/forms';
 import * as _angular_core from '@angular/core';
@@ -364,6 +364,34 @@ interface IConversationFlow {
     dynamicConditions: IDynamicCondition[];
     moodState: IMoodState;
 }
+interface IChallengeState {
+    id: string;
+    completed: boolean;
+    progress?: number;
+    observation?: string;
+}
+interface IGoalState {
+    progress: number;
+    completed: boolean;
+    observation?: string;
+}
+interface IMoodStateRuntime {
+    currentMood: string;
+    intensity: number;
+    observation?: string;
+}
+interface IConversationFlowState {
+    goal: {
+        value: any;
+    };
+    challenges: {
+        name: string;
+        value: any;
+    }[];
+    moodState: {
+        value: any;
+    };
+}
 declare enum EAgentType {
     None,
     Social = "social",
@@ -480,6 +508,9 @@ declare class ChatMessage extends MessageContent {
     imgUrl?: string;
     generatedImg?: string;
     section?: SectionType;
+    createdAt?: Date;
+    updatedAt?: Date;
+    attachments?: any[];
 }
 declare class ConversationMessagesDTO {
     messages?: ChatMessage[];
@@ -680,10 +711,65 @@ declare class PopupService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<PopupService>;
 }
 
+/**
+ * @description
+ * Orchestrates the dynamic aspects of a conversation based on a predefined configuration.
+ *
+ * This service is responsible for:
+ * - Initializing the conversation's dynamic flow with a static `IConversationFlow` configuration.
+ * - Holding the static configuration for reference throughout the conversation.
+ * - Providing access to the real-time `IConversationFlowState` managed by `ConversationFlowStateService`.
+ * - Evaluating dynamic conditions (e.g., goal progress) and triggering actions.
+ * - Applying changes to the conversation, such as updating system prompts or modifying tasks.
+ */
 declare class DynamicFlowService {
     private messagesStateService;
-    conversationFlowState: _angular_core.WritableSignal<IConversationFlow>;
-    setConversationFlow(conversationFlow: IConversationFlow): void;
+    private conversationFlowStateService;
+    /**
+     * @description
+     * A signal holding the static configuration (`IConversationFlow`) for the current chat.
+     * This configuration defines the rules, goals, challenges, and conditions for the dynamic flow.
+     */
+    conversationFlowConfig: _angular_core.WritableSignal<IConversationFlow>;
+    /**
+     * @description
+     * A direct reference to the reactive state signal from `ConversationFlowStateService`.
+     * This provides real-time access to the conversation's dynamic state (goal progress, challenges, mood).
+     */
+    flowState: _angular_core.WritableSignal<IConversationFlowState>;
+    /**
+     * @description
+     * Initializes the dynamic flow for a new conversation.
+     * It sets the static configuration and resets the runtime state to match.
+     * @param conversationFlow The static `IConversationFlow` configuration object.
+     */
+    initConversationFlow(conversationFlow: IConversationFlow): void;
+    /**
+     * @description
+     * Constructs a context object containing both the static configuration and the current runtime state.
+     * This combined context can be sent to an AI model for analysis.
+     * @returns An object with the flow definition and its current state.
+     */
+    getFlowContextForAI(): {
+        definition: IConversationFlow;
+        currentState: IConversationFlowState;
+    };
+    /**
+     * @description
+     * Updates the runtime state of the conversation based on analysis from an AI model.
+     * @param aiResponse A partial `IConversationFlowState` object from the AI.
+     */
+    updateStateFromAI(aiResponse: Partial<IConversationFlowState>): void;
+    syncMoodToLatestMessage(messageId?: string): void;
+    private getMoodEmoji;
+    /**
+     * @description
+     * Generates a prompt for the AI to evaluate the conversation flow and return a new state.
+     * This prompt includes the current state, enabled configuration instructions, and the context of the last messages.
+     * @param messages The full list of chat messages (used to extract context).
+     * @returns A string containing the prompt.
+     */
+    generateSystemPromptForFlow(messages: ChatMessage[]): string;
     changePrompt(): void;
     applyConditionChange(condition: IDynamicCondition): void;
     changeDynamicFlowTask(action: DoAction): void;
@@ -864,10 +950,9 @@ declare class EvaluationService {
     private dialogService;
     private loadingBarService;
     private userService;
-    scoreSignal: _angular_core.WritableSignal<number>;
+    private conversationFlowStateService;
     private evaluationResultSignal;
     isGoalCompleted: _angular_core.WritableSignal<boolean>;
-    evaluateGoal(goalTask: IDynamicFlowTask): Promise<any>;
     evaluateConversation(task: SimpleAgentTask, contextType?: ContextType, metaType?: string): Promise<IEvaluationResponse>;
     /**
      * Diference with evaluateConversation is task is already processed here.
@@ -878,6 +963,13 @@ declare class EvaluationService {
      * @returns The JSON result of the evaluation.
      */
     evaluateWithTask(agentTask: IDynamicFlowTask): Promise<any>;
+    /**
+     * Evaluates the dynamic flow state using a generated prompt.
+     * @param prompt The system/instruction prompt generated by DynamicFlowService.
+     * @param model The AI model to use for the evaluation.
+     * @returns The updated conversation flow state as a JSON object.
+     */
+    evaluateFlowState(prompt: string, model: IAIModel): Promise<any>;
     updateScore(additionalScore: number): void;
     setScore(newScore: number): void;
     private _handleScoreUpdate;
@@ -898,6 +990,7 @@ declare class DCChatComponent implements OnInit, OnDestroy {
     messageStateService: MessagesStateService;
     private chatMonitorService;
     private conversationInfoService;
+    private conversationFlowStateService;
     private chatFooterComponent;
     chatUserSettings: ChatUserSettings | null;
     conversationSettings: IConversationSettings;
@@ -1021,7 +1114,7 @@ declare class DCAgentCardFormComponent extends EntityBaseFormComponent<IAgentCar
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DCAgentCardFormComponent, "dc-agent-form", never, { "storageSettings": { "alias": "storageSettings"; "required": false; "isSignal": true; }; }, { "onSave": "onSave"; "onGoDetails": "onGoDetails"; }, never, never, true, never>;
 }
 
-declare class AgentCardListComponent extends EntityBaseListComponent<IAgentCard> implements OnInit {
+declare class AgentCardListComponent extends EntityBaseListV2Component<IAgentCard> implements OnInit {
     extraFilters: ICustomFilter[];
     readonly showOptions: _angular_core.InputSignal<boolean>;
     readonly gridLayout: _angular_core.InputSignal<boolean>;
@@ -1036,7 +1129,6 @@ declare class AgentCardListComponent extends EntityBaseListComponent<IAgentCard>
     ngOnInit(): Promise<void>;
     handleTableAction(actionEvent: OnActionEvent): void;
     handleAction(actionEvent: OnActionEvent): void;
-    applyFilterBarEvent(filterEvent: OnActionEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AgentCardListComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AgentCardListComponent, "dc-agent-card-lists", never, { "extraFilters": { "alias": "extraFilters"; "required": false; }; "showOptions": { "alias": "showOptions"; "required": false; "isSignal": true; }; "gridLayout": { "alias": "gridLayout"; "required": false; "isSignal": true; }; "customGetButtons": { "alias": "customGetButtons"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -1398,4 +1490,4 @@ 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 type { Appearance, AudioGenerated, AudioState, BackgroundTask, CardTranslation, ChangePromptAction, CharacterCardData, ChatEvent, ConversationFlowFormGroup, ConversationSettingsFormGroup, DoAction, DoActionFormGroup, DynamicConditionFormGroup, DynamicCriteriaFormGroup, IAccounts, IAgentAssets, IAgentCard, IAgentCardMeta, IAgentMetadata, IAgentResponseDTO, IBackgroundService, ICharacterCardDC, IConversationFlow, IConversationSettings, IConversationSettingsDTO, IDynamicCondition, IDynamicCriteria, IDynamicFlowTask, IGenerateConversationCardsDto, IMoodState, IRule, ISimpleAgent, ITTS, IVideoPlayerService, IWordMetadata, ModelFormGroup, ModelName, MultiLanguage, Persona, SimpleAgentTask, SimpleAgentTaskFormGroup, SimpleEvalResult, TextHTMLTag, TranscriptionsWhisper, TriggerTasksFormGroup, VoiceCloning, VoiceTTS, WordData };
+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.72",
+  "version": "0.1.74",
   "peerDependencies": {
     "@angular/common": ">=18.0.0",
     "@angular/core": ">=18.0.0",