@dataclouder/ngx-agent-cards 0.1.4 → 0.1.6

package/lib/components/chat-container/chat-container.component.d.ts

@@ -1,6 +1,7 @@
 import { OnInit, OnDestroy } from '@angular/core';
 import { MicSettings } from '@dataclouder/ngx-mic';
-import { ChatMessage, ChatUserSettings, IAgentCard, IConversationSettings, IMiniAgentCard, SimpleAgentTask } from '../../models/agent.models';
+import { ChatMessage, ChatUserSettings, IAgentCard, IConversationSettings, SimpleAgentTask } from '../../models/agent.models';
+import { ChatEvent } from '../../models/agent.models';
 import * as i0 from "@angular/core";
 export declare class DCChatComponent implements OnInit, OnDestroy {
     private dialogService;
@@ -10,12 +11,12 @@ export declare class DCChatComponent implements OnInit, OnDestroy {
     chatUserSettings: ChatUserSettings;
     conversationSettings: IConversationSettings;
     agentCard: IAgentCard;
-    readonly evaluatorAgentCard: import("@angular/core").InputSignal<IMiniAgentCard>;
-    readonly appAgentTask: import("@angular/core").InputSignal<SimpleAgentTask>;
+    readonly taskOnUserMessage: import("@angular/core").InputSignal<SimpleAgentTask>;
+    readonly taskOnAssistantMessage: import("@angular/core").InputSignal<SimpleAgentTask>;
     readonly parseDict: import("@angular/core").InputSignal<{
         [key: string]: string;
     }>;
-    readonly sendMessage: import("@angular/core").OutputEmitterRef<string>;
+    readonly sendMessage: import("@angular/core").OutputEmitterRef<ChatEvent<any>>;
     readonly goalCompleted: import("@angular/core").OutputEmitterRef<void>;
     messages: import("@angular/core").WritableSignal<ChatMessage[]>;
     micSettings: MicSettings;
@@ -37,5 +38,5 @@ export declare class DCChatComponent implements OnInit, OnDestroy {
      */
     restartConversation(conversation?: IAgentCard | null): Promise<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<DCChatComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DCChatComponent, "dc-chat", never, { "chatUserSettings": { "alias": "chatUserSettings"; "required": false; }; "conversationSettings": { "alias": "conversationSettings"; "required": false; }; "agentCard": { "alias": "agentCard"; "required": false; }; "evaluatorAgentCard": { "alias": "evaluatorAgentCard"; "required": false; "isSignal": true; }; "appAgentTask": { "alias": "appAgentTask"; "required": false; "isSignal": true; }; "parseDict": { "alias": "parseDict"; "required": false; "isSignal": true; }; }, { "sendMessage": "sendMessage"; "goalCompleted": "goalCompleted"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DCChatComponent, "dc-chat", never, { "chatUserSettings": { "alias": "chatUserSettings"; "required": false; }; "conversationSettings": { "alias": "conversationSettings"; "required": false; }; "agentCard": { "alias": "agentCard"; "required": false; }; "taskOnUserMessage": { "alias": "taskOnUserMessage"; "required": false; "isSignal": true; }; "taskOnAssistantMessage": { "alias": "taskOnAssistantMessage"; "required": false; "isSignal": true; }; "parseDict": { "alias": "parseDict"; "required": false; "isSignal": true; }; }, { "sendMessage": "sendMessage"; "goalCompleted": "goalCompleted"; }, never, never, true, never>;
 }

package/lib/components/chat-container/chat-footer/chat-footer.component.d.ts

@@ -1,14 +1,14 @@
 import { FormControl } from '@angular/forms';
 import { MicSettings, AudioRecording } from '@dataclouder/ngx-mic';
-import { ChatMessage, IMiniAgentCard, SimpleAgentTask } from '../../../models/agent.models';
+import { ChatMessage, SimpleAgentTask } from '../../../models/agent.models';
 import * as i0 from "@angular/core";
 export declare class ChatFooterComponent {
     private conversationService;
     private evaluationService;
     private agentCardService;
     readonly isAIThinking: import("@angular/core").InputSignal<boolean>;
-    readonly evaluatorAgentCard: import("@angular/core").InputSignal<IMiniAgentCard>;
-    readonly evaluatorAgentTask: import("@angular/core").InputSignal<SimpleAgentTask>;
+    readonly taskOnUserMessage: import("@angular/core").InputSignal<SimpleAgentTask>;
+    readonly taskOnAssistantMessage: import("@angular/core").InputSignal<SimpleAgentTask>;
     readonly micSettings: import("@angular/core").InputSignal<MicSettings>;
     readonly sendMessage: import("@angular/core").OutputEmitterRef<ChatMessage>;
     readonly textInputChanged: import("@angular/core").OutputEmitterRef<string>;
@@ -40,6 +40,10 @@ export declare class ChatFooterComponent {
     /**
      * Evaluate conversation using evaluator agent
      */
+    /**
+     * Evaluate a specific message using the evaluator agent task.
+     * @param messageToEvaluate The ChatMessage (typically the user's last message) to evaluate.
+     */
     private evaluateConversation;
     handleAudioRecorded(event: AudioRecording): void;
     /**
@@ -53,5 +57,5 @@ export declare class ChatFooterComponent {
     onMicFinished(eventBlob: Blob | any): Promise<void>;
     setScore(score: number): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ChatFooterComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ChatFooterComponent, "dc-chat-footer", never, { "isAIThinking": { "alias": "isAIThinking"; "required": false; "isSignal": true; }; "evaluatorAgentCard": { "alias": "evaluatorAgentCard"; "required": false; "isSignal": true; }; "evaluatorAgentTask": { "alias": "evaluatorAgentTask"; "required": false; "isSignal": true; }; "micSettings": { "alias": "micSettings"; "required": false; "isSignal": true; }; }, { "sendMessage": "sendMessage"; "textInputChanged": "textInputChanged"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ChatFooterComponent, "dc-chat-footer", never, { "isAIThinking": { "alias": "isAIThinking"; "required": false; "isSignal": true; }; "taskOnUserMessage": { "alias": "taskOnUserMessage"; "required": false; "isSignal": true; }; "taskOnAssistantMessage": { "alias": "taskOnAssistantMessage"; "required": false; "isSignal": true; }; "micSettings": { "alias": "micSettings"; "required": false; "isSignal": true; }; }, { "sendMessage": "sendMessage"; "textInputChanged": "textInputChanged"; }, never, never, true, never>;
 }

package/lib/components/chat-container/chat-messages-list/chat-message/chat-message.component.d.ts

@@ -11,6 +11,7 @@ export declare class ChatMessageComponent {
     evaluationEmoji: import("@angular/core").Signal<string>;
     private messageEffect;
     showEvaluation(): void;
+    printData(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ChatMessageComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ChatMessageComponent, "dc-chat-message", never, { "chatMessage": { "alias": "chatMessage"; "required": true; "isSignal": true; }; "chatUserSettings": { "alias": "chatUserSettings"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }

package/lib/components/chat-container/chat-messages-list/message-orchestrator/message-orchestrator.component.d.ts

@@ -1,5 +1,6 @@
 import { OnInit } from '@angular/core';
 import { ChatRole, MessageAudio } from '../../../../models/agent.models';
+import { WordData } from '../../../../services/popup.service';
 import * as i0 from "@angular/core";
 export declare class MessageOrchestratorComponent implements OnInit {
     private conversationService;
@@ -21,6 +22,7 @@ export declare class MessageOrchestratorComponent implements OnInit {
     onAudioCompleted(message: MessageAudio): void;
     changeStates(index: number, messageAudio: MessageAudio): void;
     generateAudio(message: MessageAudio, overwriteText?: string | null): Promise<MessageAudio>;
+    onWordClicked(wordData: WordData): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<MessageOrchestratorComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MessageOrchestratorComponent, "dc-message-orchestrator", never, { "messages": { "alias": "messages"; "required": true; "isSignal": true; }; "messageRole": { "alias": "messageRole"; "required": true; "isSignal": true; }; }, { "playAudio": "playAudio"; "audioCompleted": "audioCompleted"; }, never, never, true, never>;
 }

package/lib/components/dc-agent-card-lists/agent-card-default-ui/agent-card-default-ui.component.d.ts

@@ -1,11 +1,11 @@
 import { type OnInit } from '@angular/core';
-import { IAgentCard } from '../../../models/agent.models';
+import { IAgentCard, IAgentCardMeta } from '../../../models/agent.models';
 import { MenuItem } from 'primeng/api';
 import * as i0 from "@angular/core";
 export declare class DCConversationCardUIComponent implements OnInit {
     speedDialModel: MenuItem[];
     ngOnInit(): void;
-    readonly card: import("@angular/core").InputSignal<IAgentCard>;
+    readonly card: import("@angular/core").InputSignal<IAgentCardMeta>;
     readonly showOptions: import("@angular/core").InputSignal<boolean>;
     readonly onCardAction: import("@angular/core").OutputEmitterRef<{
         event: string;

package/lib/components/dc-agent-card-lists/dc-agent-card-lists.component.d.ts

@@ -36,6 +36,7 @@ export declare class AgentCardListComponent extends PaginationBase implements On
     deleteCard(id: string): Promise<void>;
     protected loadData(): Promise<void>;
     doFilterBarAction({ action, item }: OnActionEvent): void;
+    newAgentCard(): void;
     search(text: string): Promise<void>;
     filterChange(filters: FiltersConfig): Promise<void>;
     onCardAction(actionEvent: OnActionEvent): void;

package/lib/components/text-highlighter/extract-tags.d.ts

@@ -0,0 +1,4 @@
+export declare function extractTags(text: string): {
+    word: string;
+    tag: string;
+}[];

package/lib/components/text-highlighter/text-highlighter.d.ts

@@ -1,48 +1,38 @@
 import { OnDestroy } from '@angular/core';
 import { MessageAudio } from '../../models/agent.models';
 import * as i0 from "@angular/core";
-/**
- * Interface for highlighted word state
- */
-export interface HighlightedWord {
+export interface IWordMetadata {
     word: string;
     index: number;
-    isHighlighted: boolean;
+    isHighlighted?: boolean;
+    tag?: string;
 }
 export declare class TextHighlighterComponent implements OnDestroy {
     message: import("@angular/core").InputSignal<MessageAudio>;
-    highlightedWords: import("@angular/core").WritableSignal<HighlightedWord[]>;
+    readonly playAudio: import("@angular/core").OutputEmitterRef<MessageAudio>;
+    readonly audioCompleted: import("@angular/core").OutputEmitterRef<MessageAudio>;
+    readonly wordClicked: import("@angular/core").OutputEmitterRef<{
+        word: string;
+        index: number;
+        messageId: string;
+    }>;
+    wordWithMeta: import("@angular/core").WritableSignal<IWordMetadata[]>;
     isPlaying: import("@angular/core").WritableSignal<boolean>;
+    wordsWithMetaState: IWordMetadata[];
     iconState: import("@angular/core").Signal<"isLoading" | "isPlaying" | "playable" | "idle">;
     isLoading: import("@angular/core").Signal<boolean>;
     shouldPlayAudio: import("@angular/core").Signal<boolean>;
     messageText: import("@angular/core").Signal<string>;
     classTag: import("@angular/core").Signal<string>;
     hasTranscription: import("@angular/core").Signal<boolean>;
-    readonly playAudio: import("@angular/core").OutputEmitterRef<MessageAudio>;
-    readonly audioCompleted: import("@angular/core").OutputEmitterRef<MessageAudio>;
     private audioElement;
     private destroy$;
-    private cdr;
     private destroyRef;
     constructor();
-    /**
-     * Track function for ngFor to improve performance
-     */
     trackByIndex(index: number, item: any): number;
     ngOnDestroy(): void;
     private initializeBasedOnMessage;
-    /**
-     * Initialize the audio element and set up event listeners
-     */
     private initializeAudio;
-    /**
-     * Initialize highlighted words from transcription timestamps
-     */
-    private initializeHighlightedWords;
-    /**
-     * Set up audio synchronization with text
-     */
     private subcribeToAudioSync;
     private subscribeToEndAudio;
     /**
@@ -54,9 +44,14 @@ export declare class TextHighlighterComponent implements OnDestroy {
      */
     onPlayMessage(): void;
     /**
-     * Start audio playback and handle any setup needed
+     * Initialize plain text words by splitting the message text
      */
+    private initializePlainTextWords;
+    onWordClick(wordData: {
+        word: string;
+        index: number;
+    } | IWordMetadata): void;
     private startAudioPlayback;
     static ɵfac: i0.ɵɵFactoryDeclaration<TextHighlighterComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TextHighlighterComponent, "dc-text-highlighter", never, { "message": { "alias": "message"; "required": true; "isSignal": true; }; }, { "playAudio": "playAudio"; "audioCompleted": "audioCompleted"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TextHighlighterComponent, "dc-text-highlighter", never, { "message": { "alias": "message"; "required": true; "isSignal": true; }; }, { "playAudio": "playAudio"; "audioCompleted": "audioCompleted"; "wordClicked": "wordClicked"; }, never, never, true, never>;
 }

package/lib/models/agent.models.d.ts

@@ -75,16 +75,26 @@ export interface IAgentCard {
     lang?: string;
     model?: IAIModel;
     assets?: IAgentAssets;
+    image?: CloudStorageData;
     characterCard?: ICharacterCardDC;
     conversationSettings?: IConversationSettings;
     metaApp?: IAgentMetadata;
     accounts?: Array<IAccounts>;
 }
+export interface IAgentCardMeta extends IAgentCard {
+    taken: any;
+}
 export declare const EvalResultStringDefinition = "\ninterface SimpleEvalResult {\n  score: number;                       // Score of the user's response 0 to 3\n  feedback: string;                    // Feedback of the user's understanding of the conversation\n}";
 export interface SimpleEvalResult {
     score: number;
     feedback: string;
 }
+export interface LanguageEvaluation {
+    score: number;
+    grammarFix: string;
+    lexicalFix: string;
+    sentenceFix: string;
+}
 export interface ISimpleAgent {
     systemPrompt: string;
     model: IAIModel;
@@ -127,8 +137,9 @@ export type TranscriptionsWhisper = {
     text: string;
     task: string;
     language: string;
-    words: any;
+    words?: any[];
     duration: number;
+    segments?: any[];
 };
 export declare class WordTimestamps {
     word: string;
@@ -164,7 +175,7 @@ export declare class ChatMessage extends MessageAudio {
     promisePlay?: any;
     stats?: any;
     multiMessages?: MessageAudio[];
-    evaluation?: SimpleEvalResult;
+    evaluation?: Record<string, any>;
 }
 export declare class ChatUserSettings {
     realTime: boolean;
@@ -212,3 +223,18 @@ export type TTSRequest = {
     speed?: string;
     ssml?: string;
 };
+export declare enum ChatEventType {
+    WordClicked = "wordClicked"
+}
+export interface ChatEvent<T = any> {
+    type: ChatEventType;
+    payload: T;
+}
+export declare enum ContextType {
+    CurrentMessageContent = "MessageContent",
+    LastAssistantMessage = "LastAssistantMessage",
+    LastUserMessage = "LastUserMessage",
+    LastDialog = "LastDialog",// Last User + Last Assistant
+    Last2Dialogs = "Last2Dialogs",// Last 2 User + Last 2 Assistant
+    AllConversation = "AllConversation"
+}

package/lib/services/agent-user-progress.service.d.ts

@@ -0,0 +1,17 @@
+import * as i0 from "@angular/core";
+export declare enum AgentCardProgressStatus {
+    NotStarted = "not_started",
+    Started = "started",
+    Completed = "completed"
+}
+export interface AgentCardUserProgress {
+    agentCardId: string;
+    status: AgentCardProgressStatus;
+}
+export declare class AgentUserProgressService {
+    private httpService;
+    getProgress(): Promise<any>;
+    saveProgress(progress: AgentCardUserProgress): Promise<any>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AgentUserProgressService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AgentUserProgressService>;
+}

package/lib/services/conversation.service.d.ts

@@ -1,4 +1,5 @@
 import { Signal } from '@angular/core';
+import { WordData } from '../services/popup.service';
 import { AudioGenerated, ChatMessage, ChatUserSettings, IAgentCard, IConversationSettings, MessageAudio } from '../models/agent.models';
 import * as i0 from "@angular/core";
 export declare class ConversationService {
@@ -15,9 +16,20 @@ export declare class ConversationService {
         message: MessageAudio;
         completed: boolean;
     }>;
+    private wordClickedSignal;
     private avatarImages;
     getMessagesSignal(): Signal<ChatMessage[]>;
     getUserSettings(): ChatUserSettings;
+    /**
+     * Notifies subscribers that a word has been clicked in a message.
+     * @param wordData The data associated with the clicked word.
+     */
+    notifyWordClicked(wordData: WordData): void;
+    /**
+     * Gets the signal that emits when a word is clicked.
+     * @returns A signal emitting WordData or null.
+     */
+    getWordClickedSignal(): Signal<WordData | null>;
     addMessage(message: ChatMessage): string;
     updateMessage(messageId: string, updatedMessage: Partial<ChatMessage>): boolean;
     isThinking(): Signal<boolean>;
@@ -30,8 +42,19 @@ export declare class ConversationService {
     initConversationWithAgentCard(agentCard: IAgentCard, parseDict?: {
         [key: string]: string;
     }): Promise<void>;
-    sendUserMessage(message: ChatMessage, updateId?: string): Promise<void>;
-    sendCurrentConversation(): Promise<void>;
+    /**
+     * Sends a user message, processes it, adds it to the conversation,
+     * and triggers the AI response flow.
+     * @param message The initial ChatMessage object from the user.
+     * @param updateId Optional ID if this message should update an existing one (e.g., transcription added).
+     * @param updateId Optional ID if this message should update an existing one (e.g., transcription added).
+     * @returns A promise resolving to an object containing the user message ID and the assistant message ID (or null if an error occurred).
+     */
+    sendUserMessage(message: ChatMessage, updateId?: string | null): Promise<{
+        userMessageId: string;
+        assistantMessageId: string | null;
+    } | null>;
+    sendCurrentConversation(): Promise<string | null>;
     resetConversation(agentCard?: IAgentCard): Promise<void>;
     getTTSFile(message: MessageAudio): Promise<AudioGenerated>;
     static ɵfac: i0.ɵɵFactoryDeclaration<ConversationService, never>;

package/lib/services/evaluation.service.d.ts

@@ -1,5 +1,6 @@
 import { Signal } from '@angular/core';
 import { ChatMessage, IMiniAgentCard, SimpleAgentTask } from '../models/agent.models';
+import { ContextType } from '../models/agent.models';
 import * as i0 from "@angular/core";
 export declare class EvaluationService {
     private agentCardService;
@@ -11,7 +12,16 @@ export declare class EvaluationService {
     setScore(score: number): void;
     getEvaluationResult(): Signal<any>;
     evaluateConversation(messages: ChatMessage[], evaluator: IMiniAgentCard): Promise<any>;
-    evaluateWithTask(messages: ChatMessage[], agentTask: SimpleAgentTask): Promise<any>;
+    private getContextMessages;
+    /**
+     * Evaluates a conversation context based on a specific task and attaches the result to a designated message.
+     * @param agentTask The task definition for the evaluation.
+     * @param messageToUpdate The specific ChatMessage object (user or assistant) to attach the evaluation results to.
+     * @param contextType Determines which part of the conversation history to send as context (default: AllConversation).
+     * @returns The JSON result of the evaluation.
+     */
+    evaluateWithTask(agentTask: SimpleAgentTask, messageToUpdate: ChatMessage, // Message to attach the evaluation to
+    contextType?: ContextType): Promise<any>;
     private updateScore;
     resetScore(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EvaluationService, never>;

package/lib/services/popup.service.d.ts

@@ -0,0 +1,41 @@
+import { Injector, Type, WritableSignal } from '@angular/core';
+import * as i0 from "@angular/core";
+export interface WordData {
+    word: string;
+    index: number;
+    messageId: string;
+}
+export declare class PopupService {
+    private renderer;
+    private document;
+    private rendererFactory;
+    private appRef;
+    private injector;
+    private environmentInjector;
+    private currentPopupContainer;
+    private currentComponentRef;
+    readonly selectedWord: WritableSignal<WordData>;
+    private clickListenerUnlisten;
+    constructor();
+    /**
+     * Shows a popup containing a dynamically created component.
+     * @param top Position from the top of the viewport.
+     * @param left Position from the left of the viewport.
+     * @param componentType The type of component to render inside the popup.
+     * @param injector The injector to use for the dynamic component.
+     * @param wordData The WordData to pass to the component's input signal.
+     */
+    showPopup<T extends {
+        wordData: WritableSignal<WordData | null>;
+    }>(// Constrain T
+    top: number, left: number, componentType: Type<T>, injector: Injector, wordData: WordData): void;
+    /**
+     * Hides the currently displayed popup and destroys the dynamic component.
+     */
+    hidePopup(): void;
+    private addOutsideClickListener;
+    private removeOutsideClickListener;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PopupService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PopupService>;
+}

package/package.json

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

package/public-api.d.ts

@@ -3,6 +3,8 @@ export * from './lib/models/conversation-ai.class';
 export * from './lib/models/conversation-enums';
 export * from './lib/services/audio.service';
 export * from './lib/services/dc-conversation-builder.service';
+export * from './lib/services/popup.service';
+export * from './lib/services/agent-user-progress.service';
 export * from './lib/components/chat-container/chat-container.component';
 export * from './lib/components/dc-agent-form/dc-agent-card-form.component';
 export * from './lib/components/dc-agent-card-lists/dc-agent-card-lists.component';