@memberjunction/ng-core-entity-forms 2.50.0 → 2.52.0

package/README.md

@@ -218,6 +218,192 @@ Each entity form typically follows this structure:
 | AI-related forms | Forms for AI models, prompts, and agents |
 | Content forms | Forms for content management |
 | Communication forms | Forms for messaging and notifications |
+| **Test Harness Components** | **Interactive testing interfaces for AI agents and prompts** |
+
+## AI Test Harness System
+
+This package includes a comprehensive test harness system for AI Agents and AI Prompts, providing developers with powerful tools for testing, debugging, and validating AI components.
+
+### Test Harness Components
+
+#### 1. AI Agent Test Harness (`AIAgentTestHarnessComponent`)
+
+A full-featured testing interface for AI agents with the following capabilities:
+
+**Core Features:**
+- **Interactive Chat Interface**: Real-time conversation with AI agents
+- **Streaming Support**: Live streaming of agent responses with elapsed time tracking
+- **Data Context Management**: Configure variables passed to agents during execution
+- **Template Data Management**: Manage template variables for agent prompts
+- **Conversation Persistence**: Save/load conversations with full state restoration
+- **Import/Export**: JSON-based conversation backup and sharing
+- **Content Formatting**: Automatic detection and rendering of Markdown, JSON, and plain text
+- **Raw Content Toggle**: View both processed and raw AI responses
+- **Error Handling**: Comprehensive error display and user feedback
+
+**Usage Example:**
+```html
+<mj-ai-agent-test-harness 
+  [aiAgent]="myAgent"
+  [isVisible]="true"
+  (visibilityChange)="onVisibilityChanged($event)">
+</mj-ai-agent-test-harness>
+```
+
+**Data Context Configuration:**
+```typescript
+// Configure variables passed to the agent
+this.testHarness.dataContextVariables = [
+  { name: 'userId', value: 'user-123', type: 'string' },
+  { name: 'department', value: 'Engineering', type: 'string' },
+  { name: 'priority', value: '1', type: 'number' }
+];
+```
+
+#### 2. AI Prompt Test Harness (`AIPromptTestHarnessComponent`)
+
+A specialized testing interface for AI prompts with template variable management:
+
+**Core Features:**
+- **Prompt Testing**: Execute prompts with different AI models
+- **Template Variable Management**: Configure and test prompt variables
+- **Model Selection**: Choose from available AI models for testing
+- **Rendered Prompt Preview**: View how templates render with current variables
+- **Conversation Management**: Similar conversation features as agent harness
+- **Variable Auto-Detection**: Automatically detect variables in prompt templates
+
+**Usage Example:**
+```html
+<mj-ai-prompt-test-harness 
+  [aiPrompt]="myPrompt"
+  [template]="promptTemplate"
+  [templateContent]="templateContent"
+  [isVisible]="true">
+</mj-ai-prompt-test-harness>
+```
+
+#### 3. Test Harness Dialog Service (`TestHarnessDialogService`)
+
+A centralized service for opening test harnesses in modal dialogs:
+
+**Features:**
+- **Configurable Dialogs**: Custom sizing, titles, and initial data
+- **Agent Loading**: Load agents by ID or use existing entities
+- **Dimension Support**: Viewport units (vw, vh) and pixel dimensions
+- **Initial Data Setup**: Pre-populate context and template variables
+
+**Usage Examples:**
+```typescript
+// Open AI Agent test harness
+const dialogRef = this.testHarnessService.openAgentTestHarness({
+  agentId: 'agent-123',
+  title: 'Test My Agent',
+  width: '90vw',
+  height: '80vh',
+  initialDataContext: { 
+    userId: 'user-456',
+    department: 'Engineering'
+  }
+});
+
+// Open AI Prompt test harness
+const dialogRef = this.testHarnessService.openPromptTestHarness({
+  promptId: 'prompt-789',
+  selectedModelId: 'gpt-4',
+  initialTemplateVariables: { 
+    name: 'Alice',
+    context: 'Customer support inquiry'
+  }
+});
+
+// Convenience methods
+await this.testHarnessService.openAgentById('agent-123');
+await this.testHarnessService.openPromptById('prompt-456');
+```
+
+### Enhanced AI Agent Form
+
+The AI Agent form (`AIAgentFormComponentExtended`) includes integrated test harness access:
+
+**Features:**
+- **Built-in Test Button**: Direct access to test harness from agent form
+- **Related Entity Management**: View sub-agents, prompts, actions, and execution history
+- **Status Indicators**: Visual status badges and execution mode icons
+- **Navigation Support**: Links to related entities
+- **Execution History**: Recent runs with timing and status information
+
+**Enhanced Capabilities:**
+```typescript
+// Open test harness from form
+this.openTestHarness(); // Validates agent is saved first
+
+// View execution status
+this.getExecutionStatusIcon(status); // Returns appropriate FontAwesome icon
+this.getExecutionStatusColor(status); // Returns status color
+
+// Format timing information
+this.formatExecutionTime(milliseconds); // Human-readable time format
+```
+
+### Conversation Management
+
+Both test harnesses include comprehensive conversation management:
+
+**Features:**
+- **Auto-Save**: Conversations automatically save during active sessions
+- **Manual Save**: Save conversations with custom names
+- **Load/Restore**: Restore complete conversation state including variables
+- **Export/Import**: JSON-based conversation portability
+- **Storage Limits**: Automatic cleanup (50 conversation limit)
+
+**Export Format:**
+```json
+{
+  "agent": {
+    "id": "agent-123",
+    "name": "Customer Service Agent",
+    "description": "Handles customer inquiries"
+  },
+  "messages": [...],
+  "dataContext": {
+    "userId": "user-456",
+    "department": "Support"
+  },
+  "templateData": {
+    "customerName": "John Doe"
+  },
+  "exportedAt": "2024-01-15T10:30:00.000Z"
+}
+```
+
+### Content Rendering System
+
+Advanced content formatting with automatic type detection:
+
+**Supported Formats:**
+- **Markdown**: Headers, lists, code blocks, links, emphasis
+- **JSON**: Syntax highlighting and pretty formatting
+- **Plain Text**: Clean text rendering with line breaks
+
+**Content Type Detection:**
+```typescript
+// Automatically detects content type
+const contentType = this.detectContentType(content);
+// Returns: 'markdown' | 'json' | 'text'
+
+// Renders content appropriately
+const safeHtml = this.getFormattedContent(message);
+```
+
+### Integration Points
+
+The test harness system integrates seamlessly with:
+
+- **MemberJunction Entity System**: Uses proper entity loading patterns
+- **GraphQL Data Provider**: Executes agents and prompts via GraphQL mutations
+- **Notification Service**: User feedback for actions and errors
+- **LocalStorage**: Conversation persistence across sessions
+- **Kendo UI Dialogs**: Professional modal interfaces
 
 ## Notes
 
@@ -228,6 +414,7 @@ Each entity form typically follows this structure:
 
 ## Dependencies
 
+### Core Dependencies
 - @angular/common
 - @angular/core
 - @angular/forms
@@ -235,6 +422,8 @@ Each entity form typically follows this structure:
 - @memberjunction/core-entities
 - @memberjunction/ng-explorer-core
 - @memberjunction/ng-base-forms
+
+### UI Component Dependencies
 - @memberjunction/ng-form-toolbar
 - @memberjunction/ng-tabstrip
 - @memberjunction/ng-container-directives
@@ -242,4 +431,29 @@ Each entity form typically follows this structure:
 - @memberjunction/ng-timeline
 - @memberjunction/ng-join-grid
 - @progress/kendo-angular-grid
-- @progress/kendo-angular-dropdowns
+- @progress/kendo-angular-dropdowns
+- @progress/kendo-angular-dialog
+
+### AI & Notification Dependencies
+- @memberjunction/ai
+- @memberjunction/ng-notifications
+- @memberjunction/graphql-dataprovider
+
+### Test Harness Components
+
+The test harness system introduces several new components and services:
+
+| Component/Service | Purpose |
+|------------------|---------|
+| `AIAgentTestHarnessComponent` | Interactive chat interface for testing AI agents |
+| `AIPromptTestHarnessComponent` | Template variable testing for AI prompts |
+| `AIAgentTestHarnessDialogComponent` | Modal dialog wrapper for agent testing |
+| `AIPromptTestHarnessDialogComponent` | Modal dialog wrapper for prompt testing |
+| `TestHarnessDialogService` | Centralized service for opening test harness dialogs |
+| `AIAgentFormComponentExtended` | Enhanced AI agent form with integrated test harness |
+
+### New Dependencies Added for Test Harness:
+- **Angular DomSanitizer**: Safe HTML rendering for formatted content
+- **RxJS Subjects**: Component lifecycle and event management
+- **LocalStorage**: Conversation persistence across sessions
+- **File API**: Import/export functionality for conversations

package/dist/lib/custom/AIAgents/ai-agent-form.component.d.ts

@@ -1,28 +1,188 @@
-import { OnInit } from '@angular/core';
-import { AIAgentEntity } from '@memberjunction/core-entities';
+import { OnInit, ViewContainerRef, ElementRef, ChangeDetectorRef } from '@angular/core';
+import { Router, ActivatedRoute } from '@angular/router';
+import { ActionEntity, AIAgentEntity, AIAgentLearningCycleEntity, AIAgentNoteEntity, AIAgentRunEntity, AIPromptEntityExtended } from '@memberjunction/core-entities';
 import { AIAgentFormComponent } from '../../generated/Entities/AIAgent/aiagent.form.component';
+import { DialogService } from '@progress/kendo-angular-dialog';
+import { SharedService } from '@memberjunction/ng-shared';
 import * as i0 from "@angular/core";
+/**
+ * Enhanced AI Agent form component that extends the auto-generated base form
+ * with comprehensive agent management capabilities including test harness integration,
+ * related entity management, and execution history tracking.
+ *
+ * ## Key Features:
+ * - **Integrated Test Harness**: Built-in access to agent testing capabilities
+ * - **Related Entity Management**: Display and manage sub-agents, prompts, and actions
+ * - **Execution History**: View recent agent runs with status and timing information
+ * - **Rich UI Components**: Enhanced cards, badges, and status indicators
+ * - **Navigation Support**: Links to related entities and management functions
+ *
+ * ## Form Sections:
+ * - **Agent Details**: Basic agent configuration and settings
+ * - **Sub-Agents**: Hierarchical agent relationships
+ * - **Prompts**: Associated prompts with priority ordering
+ * - **Actions**: Available actions and configurations
+ * - **Execution History**: Recent runs with detailed status information
+ *
+ * ## Usage:
+ * This component is automatically loaded when editing AI Agent entities through
+ * the MemberJunction form system. It extends the base generated form with
+ * additional functionality while maintaining full compatibility.
+ *
+ * @example
+ * ```html
+ * <!-- Automatically used by form system -->
+ * <mj-ai-agent-form [recordId]="agentId"></mj-ai-agent-form>
+ * ```
+ */
 export declare class AIAgentFormComponentExtended extends AIAgentFormComponent implements OnInit {
+    protected sharedService: SharedService;
+    private dialogService;
+    private viewContainerRef;
+    /** The AI Agent entity being edited */
     record: AIAgentEntity;
-    showExecutionDialog: boolean;
-    private _metadata;
+    /** Whether the test harness is currently visible */
+    showTestHarness: boolean;
+    /** Number of sub-agents under this agent */
+    subAgentCount: number;
+    /** Number of prompts associated with this agent */
+    promptCount: number;
+    /** Number of actions configured for this agent */
+    actionCount: number;
+    /** Number of learning cycles for this agent */
+    learningCycleCount: number;
+    /** Number of notes associated with this agent */
+    noteCount: number;
+    /** Number of execution history records */
+    executionHistoryCount: number;
+    /** Array of sub-agent entities for card display */
+    subAgents: AIAgentEntity[];
+    /** Array of agent prompt entities for card display */
+    agentPrompts: AIPromptEntityExtended[];
+    /** Array of agent action entities for card display */
+    agentActions: ActionEntity[];
+    /** Array of learning cycle entities for display */
+    learningCycles: AIAgentLearningCycleEntity[];
+    /** Array of agent note entities for display */
+    agentNotes: AIAgentNoteEntity[];
+    /** Array of recent execution records for history display */
+    recentExecutions: AIAgentRunEntity[];
+    constructor(elementRef: ElementRef, sharedService: SharedService, router: Router, route: ActivatedRoute, cdr: ChangeDetectorRef, dialogService: DialogService, viewContainerRef: ViewContainerRef);
+    /**
+     * Component initialization. Calls parent initialization and loads related entity data
+     * if an agent record is already available.
+     */
     ngOnInit(): Promise<void>;
     /**
-     * Determines if the agent can be executed
+     * Loads counts and preview data for all related entities including sub-agents,
+     * prompts, actions, learning cycles, notes, and execution history.
+     * This data populates the various expander panels in the enhanced form interface.
+     * @private
      */
-    get canExecute(): boolean;
+    private loadRelatedCounts;
     /**
-     * Executes the AI agent
+     * Opens the integrated test harness for the current agent.
+     * Validates that the agent has been saved before allowing testing.
+     * Shows a notification if the agent needs to be saved first.
      */
-    executeAIAgent(): void;
+    openTestHarness(): void;
     /**
-     * Gets status badge color
+     * Returns the appropriate color for the agent status badge.
+     * Uses standard color coding: green for active, yellow for pending, gray for disabled.
+     * @returns CSS color value for the status badge
      */
     getStatusBadgeColor(): string;
     /**
-     * Handles when execution dialog is closed
+     * Event handler for test harness visibility changes.
+     * Updates the component state when the test harness is opened or closed.
+     * @param isVisible - Whether the test harness is currently visible
+     */
+    onTestHarnessVisibilityChanged(isVisible: boolean): void;
+    /**
+     * Gets the count of sub-agents
+     */
+    getSubAgentCount(): number;
+    /**
+     * Gets the count of prompts
+     */
+    getPromptCount(): number;
+    /**
+     * Gets the count of actions
+     */
+    getActionCount(): number;
+    /**
+     * Gets the icon for the execution mode
+     */
+    getExecutionModeIcon(mode: string): string;
+    /**
+     * Creates a new sub-agent
+     */
+    createSubAgent(): Promise<void>;
+    /**
+     * Adds a new prompt to the agent
+     */
+    addPrompt(): Promise<void>;
+    /**
+     * Opens the action configuration dialog
+     */
+    configureActions(): Promise<void>;
+    /**
+     * Gets the status icon for execution runs
+     */
+    getExecutionStatusIcon(status: string): string;
+    /**
+     * Gets the status color for execution runs
+     */
+    getExecutionStatusColor(status: string): string;
+    formatExecutionTimeFromDates(startDate: Date, endDate: Date): string;
+    /**
+     * Formats execution time
+     */
+    formatExecutionTime(milliseconds: number): string;
+    /**
+     * Gets the priority badge color
+     */
+    getPriorityBadgeColor(priority: number): string;
+    /**
+     * Gets the priority label
+     */
+    getPriorityLabel(priority: number): string;
+    /**
+     * Navigates to a related entity
+     */
+    navigateToEntity(entityName: string, recordId: string): void;
+    /**
+     * Refreshes the related data
+     */
+    refreshRelatedData(): Promise<void>;
+    /**
+     * Adds a new note to the agent
+     */
+    addNote(): void;
+    /**
+     * Links an existing prompt to the agent
+     */
+    private linkPromptToAgent;
+    /**
+     * Creates a new prompt and links it to the agent
+     */
+    private createNewPrompt;
+    /**
+     * Links an existing action to the agent
+     */
+    private linkActionToAgent;
+    /**
+     * Creates a new action and links it to the agent
+     */
+    private createNewAction;
+    /**
+     * Removes a prompt from the agent
+     */
+    removePrompt(prompt: AIPromptEntityExtended, event: Event): Promise<void>;
+    /**
+     * Removes an action from the agent
      */
-    onExecutionDialogClosed(): void;
+    removeAction(action: ActionEntity, event: Event): Promise<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AIAgentFormComponentExtended, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<AIAgentFormComponentExtended, "mj-ai-agent-form", never, {}, {}, never, ["*"], false, never>;
 }

package/dist/lib/custom/AIAgents/ai-agent-form.component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-agent-form.component.d.ts","sourceRoot":"","sources":["../../../../src/lib/custom/AIAgents/ai-agent-form.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,MAAM,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAK9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yDAAyD,CAAC;;AAG/F,qBAMa,4BAA6B,SAAQ,oBAAqB,YAAW,MAAM;IAC7E,MAAM,EAAG,aAAa,CAAC;IACvB,mBAAmB,UAAS;IAEnC,OAAO,CAAC,SAAS,CAAkB;IAE7B,QAAQ;IAId;;OAEG;IACH,IAAW,UAAU,IAAI,OAAO,CAG/B;IAED;;OAEG;IACI,cAAc;IAsBrB;;OAEG;IACI,mBAAmB,IAAI,MAAM;IASpC;;OAEG;IACI,uBAAuB;yCA1DrB,4BAA4B;2CAA5B,4BAA4B;CA6DxC;AAED,wBAAgB,gCAAgC,SAE/C"}
+{"version":3,"file":"ai-agent-form.component.d.ts","sourceRoot":"","sources":["../../../../src/lib/custom/AIAgents/ai-agent-form.component.ts"],"names":[],"mappings":"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"}