Member Junction
    Preparing search index...

    Class AITestHarnessComponent

    Comprehensive test harness component for AI Agent development and testing. Provides a full-featured chat interface with conversation management, data context configuration, template data management, streaming responses, conversation persistence, and import/export capabilities.

    • Interactive Chat: Real-time conversation with AI agents
    • Streaming Support: Live streaming of agent responses with elapsed time tracking
    • Data Context Management: Configure variables passed to agent 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
    <mj-ai-agent-test-harness 
      [aiAgent]="myAgent"
      [isVisible]="true"
      (visibilityChange)="onVisibilityChanged($event)">
    </mj-ai-agent-test-harness>

    // Using with agent entity
    const agent = await metadata.GetEntityObject<MJAIAgentEntityExtended>('MJ: AI Agents');
    await agent.Load('agent-id');
    this.testHarness.aiAgent = agent;
    this.testHarness.isVisible = true;

    Hierarchy (View Summary)

    Implements

    • OnInit
    • OnDestroy
    • OnChanges
    • AfterViewChecked
    Index

    Constructors

    constructor

    Properties

    ActiveTab AdvancedParams AdvancedParamsExpanded AgentConfigurationId AgentVariables AvailableConfigurations AvailableModels AvailableVendors ConversationMessages CurrentAgentRun CurrentConversationId CurrentJsonContent CurrentUserMessage entity ExecutionMonitorMode HarnessSplitSizes HasExecutedRerun IsExecuting LiveAgentSteps MaxTokens minimizeRequested MinimizeRequested Mode NewConversationName OriginalPromptRunId Provider responseFormatOptions runOpened RunOpened SavedConversations SelectedConfigurationId SelectedModelId SelectedResponseFormat SelectedVendorId ShowJsonDialog ShowJsonWindow ShowLoadConfirmDialog ShowSaveDialog ShowSidebar SkipValidation StartingPayloadOpen StopSequencesText SystemPromptOverride TempConversationName TemplateVariables visibilityChange VisibilityChange WorkflowDebuggerActive WorkflowParentTaskID WorkflowPayloadError WorkflowSettled WorkflowStartingPayload ɵdir ɵfac

    Accessors

    activeTab advancedParams advancedParamsExpanded agentConfigurationId agentVariables aiAgent AiAgent availableConfigurations availableModels availableVendors conversationMessages currentAgentRun currentConversationId currentJsonContent currentUserMessage EffectiveMode executionMonitorMode hasExecutedRerun isExecuting isVisible IsVisible IsWorkflowAgent liveAgentSteps maxTokens mode MonitorRunType newConversationName originalPromptRunId ProviderToUse RunQueryToUse RunViewToUse savedConversations selectedConfigurationId selectedModelId selectedResponseFormat selectedVendorId showJsonDialog showJsonWindow showLoadConfirmDialog showSaveDialog showSidebar skipValidation stopSequencesText systemPromptOverride tempConversationName templateVariables

    Methods

    addAgentVariable AddAgentVariable addTemplateVariable AddTemplateVariable cancelLoadConversation CancelLoadConversation cancelSaveDialog CancelSaveDialog clearConversation ClearConversation close closeJsonDialog CloseJsonDialog closeJsonWindow CloseJsonWindow confirmLoadConversation ConfirmLoadConversation confirmSaveConversation ConfirmSaveConversation copyJsonContent CopyJsonContent copyMessage CopyMessage DebugWorkflow deleteConversation DeleteConversation detectContentType DetectContentType executeRerun ExecuteRerun exportConversation ExportConversation formatElapsedTime FormatElapsedTime formatExecutionTime FormatExecutionTime formatJson FormatJson formatTimestamp FormatTimestamp getEntityIconClass GetEntityIconClass getEntityLogoURL GetEntityLogoURL getEntityName getExecutionSummary GetExecutionSummary getFormattedContent GetFormattedContent getFormattedStreamingContent GetFormattedStreamingContent getLastRunId GetLastRunId getMessageClass GetMessageClass handleKeyPress HandleKeyPress hasEntityLogo HasEntityLogo hasExtractableContent HasExtractableContent hasPayload importConversation ImportConversation IsConfigMatchById isJsonContent IsJsonContent loadConversation LoadConversation navigateToAgentRun navigateToRun NavigateToRun newConversation NewConversation ngAfterViewChecked ngOnChanges ngOnDestroy ngOnInit onFileSelected OnFileSelected OnHarnessSplitDragEnd onModelSelectionChange OnModelSelectionChange OnToggleStartingPayload OnWorkflowCanvasSettled removeAgentVariable RemoveAgentVariable removeTemplateVariable RemoveTemplateVariable renderMarkdown RenderMarkdown resetHarness ResetHarness resetToOriginalMessages ResetToOriginalMessages resetToPromptDefaults ResetToPromptDefaults RunWorkflow saveConversation SaveConversation selectTab SelectTab sendMessage SendMessage showMessageExecutionHistory ShowMessageExecutionHistory showRawJsonDialog ShowRawJsonDialog showRawToggle ShowRawToggle toggleAdvancedParams ToggleAdvancedParams togglePayloadCollapse TogglePayloadCollapse toggleSidebar ToggleSidebar updateStopSequences UpdateStopSequences updateTempConversation UpdateTempConversation

    Constructors

    Properties

    ActiveTab:
        | "agentVariables"
        | "executionMonitor"
        | "agentSettings"
        | "templateVariables"
        | "modelSettings"
        | "savedConversations" = 'agentVariables'

    Currently active tab in the sidebar

    AdvancedParams: {
        frequencyPenalty: number | null;
        includeLogProbs: boolean;
        minP: number | null;
        presencePenalty: number | null;
        seed: number | null;
        stopSequences: string[];
        temperature: number | null;
        topK: number | null;
        topLogProbs: number;
        topP: number | null;
    } = ...

    Advanced LLM Parameters

    AdvancedParamsExpanded: boolean = false

    Whether advanced parameters panel is expanded

    AgentConfigurationId: string = ''

    Selected AI configuration for agent execution

    AgentVariables: DataContextVariable[] = []

    Unified variables for agent execution (combines data context and template data)

    AvailableConfigurations: MJAIConfigurationEntity[] = []

    Available AI configurations

    AvailableModels: any[] = []

    Available AI models for prompt execution

    AvailableVendors: any[] = []

    Available AI vendors for the selected model

    ConversationMessages: ConversationMessage[] = []

    Complete array of all messages in the current conversation session

    CurrentAgentRun: MJAIAgentRunEntityExtended | null = null

    Current agent run being displayed in execution monitor

    CurrentConversationId: string | null = null

    ID of the currently active/loaded conversation, if any

    CurrentJsonContent: string = ''

    Current JSON content to display in the dialog

    CurrentUserMessage: string = ''

    Current text input by the user (bound to textarea)

    entity: MJAIAgentEntityExtended | MJAIPromptEntityExtended | null = null

    The entity to test - either an AI Agent or AI Prompt

    ExecutionMonitorMode: "live" | "historical" = 'historical'

    Mode for the execution monitor component

    HarnessSplitSizes: PaneSizePair = ...

    [chat, sidebar] percentages. Restored from MJ: User Settings.

    HasExecutedRerun: boolean = false

    Whether a re-run has been executed (shows Reset button instead of Re-Run)

    IsExecuting: boolean = false

    Whether an agent execution is currently in progress

    LiveAgentSteps: MJAIAgentRunStepEntityExtended[] = []

    Tracks agent steps during live execution (deprecated - now using agent run's Steps directly)

    MaxTokens: number | null = null

    Maximum tokens for prompt execution

    minimizeRequested: EventEmitter<void> = ...

    Use MinimizeRequested.

    The same emitter under the old binding name, so a template still binding (minimizeRequested) keeps working. Must stay AFTER MinimizeRequested: class fields initialise in order, and the other way round this captures undefined.

    MinimizeRequested: EventEmitter<void> = ...

    Event emitted when the component requests to be minimized (e.g., when navigating to a run)

    Mode: TestHarnessMode = 'agent'

    The mode of operation - either 'agent' or 'prompt'

    NewConversationName: string = ''

    Name for the new conversation being saved

    OriginalPromptRunId: string | null = null

    The original prompt run ID when re-running a previous prompt execution

    Provider: IMetadataProvider | null

    If specified, this provider will be used for communication and for all metadata purposes. By default, if not provided, the Metadata and RunView classes are used for this and the default GraphQLDataProvider is used which is connected to the same back-end MJAPI instance as the Metadata and RunView classes. If you want to have this component connect to a different MJAPI back-end, create an instance of a ProviderBase sub-class like GraphQLDataProvider/etc, and configure it as appropriate to connect to the MJAPI back-end you want to use, and then pass it in here.

    responseFormatOptions: { text: string; value: string }[] = ...

    Available response format options

    runOpened: EventEmitter<{ runId: string; runType: "agent" | "prompt" }> = ...

    Use RunOpened.

    The same emitter under the old binding name, so a template still binding (runOpened) keeps working. Must stay AFTER RunOpened: class fields initialise in order, and the other way round this captures undefined.

    RunOpened: EventEmitter<{ runId: string; runType: "agent" | "prompt" }> = ...

    Emitted when the user navigates to view a run (agent or prompt)

    SavedConversations: SavedConversation[] = []

    Array of saved conversation sessions loaded from localStorage

    SelectedConfigurationId: string = ''

    Selected AI configuration for prompt execution

    SelectedModelId: string = ''

    Selected AI model for prompt execution

    SelectedResponseFormat: { text: string; value: string } = ...

    Selected response format for prompt execution

    SelectedVendorId: string = ''

    Selected AI vendor for prompt execution

    ShowJsonDialog: boolean = false

    Flag to control JSON dialog visibility

    ShowJsonWindow: boolean = false

    Whether the JSON viewer window is visible

    ShowLoadConfirmDialog: boolean = false

    Whether to show the load confirmation dialog

    ShowSaveDialog: boolean = false

    Whether to show the save conversation dialog

    ShowSidebar: boolean = true

    Whether the configuration sidebar is currently visible

    SkipValidation: boolean = false

    Whether to skip validation when running prompts

    StartingPayloadOpen: boolean = false

    Starting-payload editor is collapsed unless the person opens it.

    StopSequencesText: string = ''

    Raw stop sequences input for textarea

    SystemPromptOverride: string | null = null

    The system prompt override to use instead of rendering from template

    TempConversationName: string = ''

    Temporary name for the dialog input to avoid binding conflicts

    TemplateVariables: DataContextVariable[] = []

    Variables for prompt template rendering

    visibilityChange: EventEmitter<boolean> = ...

    Use VisibilityChange.

    The same emitter under the old binding name, so a template still binding (visibilityChange) keeps working. Must stay AFTER VisibilityChange: class fields initialise in order, and the other way round this captures undefined.

    VisibilityChange: EventEmitter<boolean> = ...

    Event emitted when the visibility state changes, allowing parent components to react

    WorkflowDebuggerActive: boolean = false

    True after Debug — chrome, breakpoints, and the start-paused seed stay on for this run.

    WorkflowParentTaskID: string | null = null

    The graph the most recent run submitted, so the harness can show it running.

    WorkflowPayloadError: string | null = null

    Parse error for the payload editor, shown inline rather than swallowed at submit time.

    WorkflowSettled: boolean = false
    WorkflowStartingPayload: string = ''

    Optional starting payload for a workflow run, as JSON the user can edit.

    "ɵdir": unknown
    "ɵfac": ɵɵFactoryDeclaration<BaseAngularComponent, never>

    Accessors

    • get activeTab(): | "agentVariables"
      | "executionMonitor"
      | "agentSettings"
      | "templateVariables"
      | "modelSettings"
      | "savedConversations"

      Returns
          | "agentVariables"
          | "executionMonitor"
          | "agentSettings"
          | "templateVariables"
          | "modelSettings"
          | "savedConversations"

      Use ActiveTab.

    • set activeTab(
          value:
              | "agentVariables"
              | "executionMonitor"
              | "agentSettings"
              | "templateVariables"
              | "modelSettings"
              | "savedConversations",
      ): void

      Parameters

      • value:
            | "agentVariables"
            | "executionMonitor"
            | "agentSettings"
            | "templateVariables"
            | "modelSettings"
            | "savedConversations"

      Returns void

      Use ActiveTab.

    • get advancedParams(): {
          frequencyPenalty: number
          | null;
          includeLogProbs: boolean;
          minP: number | null;
          presencePenalty: number | null;
          seed: number | null;
          stopSequences: string[];
          temperature: number | null;
          topK: number | null;
          topLogProbs: number;
          topP: number | null;
      }

      Returns {
          frequencyPenalty: number | null;
          includeLogProbs: boolean;
          minP: number | null;
          presencePenalty: number | null;
          seed: number | null;
          stopSequences: string[];
          temperature: number | null;
          topK: number | null;
          topLogProbs: number;
          topP: number | null;
      }

      Use AdvancedParams.

    • set advancedParams(
          value: {
              frequencyPenalty: number | null;
              includeLogProbs: boolean;
              minP: number | null;
              presencePenalty: number | null;
              seed: number | null;
              stopSequences: string[];
              temperature: number | null;
              topK: number | null;
              topLogProbs: number;
              topP: number | null;
          },
      ): void

      Parameters

      • value: {
            frequencyPenalty: number | null;
            includeLogProbs: boolean;
            minP: number | null;
            presencePenalty: number | null;
            seed: number | null;
            stopSequences: string[];
            temperature: number | null;
            topK: number | null;
            topLogProbs: number;
            topP: number | null;
        }

      Returns void

      Use AdvancedParams.

    • get MonitorRunType(): "agent" | "prompt"

      What the execution monitor is watching.

      A workflow run IS an agent run — it is the same AIAgentRun row, just one that compiled a graph instead of reasoning. Widening the monitor's own contract would imply otherwise.

      Returns "agent" | "prompt"

    • get ProviderToUse(): IMetadataProvider

      Returns either the default Metadata provider or the one specified in the Provider property, if it was specified

      Returns IMetadataProvider

    • get RunQueryToUse(): IRunQueryProvider

      Returns either the default RunQuery provider or the one specified in the Provider property, if it was specified

      Returns IRunQueryProvider

    • get RunViewToUse(): IRunViewProvider

      Returns either the default RunView provider or the one specified in the Provider property, if it was specified

      Returns IRunViewProvider

    Methods

    • Automatically detects the content type of a message for appropriate rendering. Uses pattern matching to identify JSON, Markdown, or plain text content.

      Parameters

      • content: string

        Content string to analyze

      Returns "json" | "markdown" | "text"

      Detected content type ('markdown', 'json', or 'text')

    • Formats execution time from milliseconds into a human-readable string. Automatically selects appropriate units (minutes, seconds, or milliseconds).

      Parameters

      • milliseconds: number

        Execution time in milliseconds

      Returns string

      Formatted time string (e.g., "2m 30.5s", "1.23s", "500ms")

    • Saves the current conversation to localStorage with user-provided name. Handles both creating new conversations and updating existing ones. Automatically limits storage to 50 conversations to prevent excessive memory usage.

      Returns void

      // User clicks save button
      this.saveConversation(); // Prompts for name and saves

    • Parameters

      • tab:
            | "agentVariables"
            | "executionMonitor"
            | "agentSettings"
            | "templateVariables"
            | "modelSettings"
            | "savedConversations"

      Returns void

      Use SelectTab.

    • Switches to the specified tab in the configuration sidebar.

      Parameters

      • tab:
            | "agentVariables"
            | "executionMonitor"
            | "agentSettings"
            | "templateVariables"
            | "modelSettings"
            | "savedConversations"

        The tab to activate

      Returns void

    Settings

    Member Visibility

    On This Page

    Key Features:Usage:
    Constructors
    Properties
    ActiveTabAdvancedParamsAdvancedParamsExpandedAgentConfigurationIdAgentVariablesAvailableConfigurationsAvailableModelsAvailableVendorsConversationMessagesCurrentAgentRunCurrentConversationIdCurrentJsonContentCurrentUserMessageentityExecutionMonitorModeHarnessSplitSizesHasExecutedRerunIsExecutingLiveAgentStepsMaxTokensminimizeRequestedMinimizeRequestedModeNewConversationNameOriginalPromptRunIdProviderresponseFormatOptionsrunOpenedRunOpenedSavedConversationsSelectedConfigurationIdSelectedModelIdSelectedResponseFormatSelectedVendorIdShowJsonDialogShowJsonWindowShowLoadConfirmDialogShowSaveDialogShowSidebarSkipValidationStartingPayloadOpenStopSequencesTextSystemPromptOverrideTempConversationNameTemplateVariablesvisibilityChangeVisibilityChangeWorkflowDebuggerActiveWorkflowParentTaskIDWorkflowPayloadErrorWorkflowSettledWorkflowStartingPayloadɵdirɵfac
    Accessors
    Methods
    addAgentVariableAddAgentVariableaddTemplateVariableAddTemplateVariablecancelLoadConversationCancelLoadConversationcancelSaveDialogCancelSaveDialogclearConversationClearConversationclosecloseJsonDialogCloseJsonDialogcloseJsonWindowCloseJsonWindowconfirmLoadConversationConfirmLoadConversationconfirmSaveConversationConfirmSaveConversationcopyJsonContentCopyJsonContentcopyMessageCopyMessageDebugWorkflowdeleteConversationDeleteConversationdetectContentTypeDetectContentTypeexecuteRerunExecuteRerunexportConversationExportConversationformatElapsedTimeFormatElapsedTimeformatExecutionTimeFormatExecutionTimeformatJsonFormatJsonformatTimestampFormatTimestampgetEntityIconClassGetEntityIconClassgetEntityLogoURLGetEntityLogoURLgetEntityNamegetExecutionSummaryGetExecutionSummarygetFormattedContentGetFormattedContentgetFormattedStreamingContentGetFormattedStreamingContentgetLastRunIdGetLastRunIdgetMessageClassGetMessageClasshandleKeyPressHandleKeyPresshasEntityLogoHasEntityLogohasExtractableContentHasExtractableContenthasPayloadimportConversationImportConversationIsConfigMatchByIdisJsonContentIsJsonContentloadConversationLoadConversationnavigateToAgentRunnavigateToRunNavigateToRunnewConversationNewConversationngAfterViewCheckedngOnChangesngOnDestroyngOnInitonFileSelectedOnFileSelectedOnHarnessSplitDragEndonModelSelectionChangeOnModelSelectionChangeOnToggleStartingPayloadOnWorkflowCanvasSettledremoveAgentVariableRemoveAgentVariableremoveTemplateVariableRemoveTemplateVariablerenderMarkdownRenderMarkdownresetHarnessResetHarnessresetToOriginalMessagesResetToOriginalMessagesresetToPromptDefaultsResetToPromptDefaultsRunWorkflowsaveConversationSaveConversationselectTabSelectTabsendMessageSendMessageshowMessageExecutionHistoryShowMessageExecutionHistoryshowRawJsonDialogShowRawJsonDialogshowRawToggleShowRawToggletoggleAdvancedParamsToggleAdvancedParamstogglePayloadCollapseTogglePayloadCollapsetoggleSidebarToggleSidebarupdateStopSequencesUpdateStopSequencesupdateTempConversationUpdateTempConversation