Which pane is showing. Persisted per user, so returning to a record lands where you left.
Starts null rather than 'details': null means "nobody has chosen yet", which lets
refreshFormTabs fall through to the first tab — the designer, when the agent type has
one. A hardcoded default would open every Flow agent on Details and bury its diagram again.
Array of agent action entities for card display
Array of agent note entities for display
Array of agent prompt entities for card display
ReadonlyAgentColumn spec for the AIAgentSearchScope child grid (mockup #5).
Voice/realtime sessions where this agent is the co-agent or the delegation target
The agent type entity for this agent
Agent types loaded from the database
Size of the bottom area as a percentage (0-100) for angular-split. Used by CodeGen-generated templates with as-split.
TreeDropdown configuration for the agent category field
Layout the container resolved for this form. Set by <mj-record-form-container>; read by panel hosts.
Last composition snapshot the container published — what is actually on this form: sections, related grids, contributions and slots. Consumers: agent context (so Skip can target a real slot and section key) and Form Studio.
Per-instance presentation config (toolbar visibility, related-entity
sections, collapsibility, width, in-form navigation). Set by the form host
(MjEntityFormHostComponent) or any consumer that instantiates the form
directly. Read back by MjRecordFormContainerComponent and the collapsible
panels through the FormComponent reference, so it takes effect WITHOUT
regenerating the CodeGen-produced template. Null means "use the container's
own defaults" (the classic full-page tab behavior).
ID of the currently-rendered variant (null when no override is active and the form is the CodeGen /
Emitted whenever edit mode starts (true) or ends (false). The Explorer
shell uses the true edge to PROMOTE a records preview tab — pin it — the
moment the user starts editing (VS Code's promote-on-modify), so a record
being edited is neither replaceable by the next plain open nor italic.
Fires on every call, not only on transitions: a new record's ngOnInit
re-asserts edit mode and the shell's pin is idempotent.
ProtectedelementPagination state for execution history
Which record type the Execution History section shows: agent runs (default) or realtime voice sessions
Search functionality for execution history
Track which execution cards are expanded
ProtectedformTab chrome, recomputed only when the agent type or record identity changes.
Flag to indicate if there are unsaved changes
Whether the form header is collapsed to a single compact line
True until the form knows what it is going to render.
The tab strip and every pane depend on the agent's TYPE, which is loaded asynchronously. Until
it arrives there are no tabs, no designer pane, and ActiveFormTab is null — so the details
pane is hidden too and the form renders its header over an empty area for as long as the load
takes. That reads as a broken page, not as a slow one.
Main loading state for initial data load
True when no explicit permission records exist (agent is open to everyone)
Array of learning cycle entities for display
Individual loading states for each section, start off true until loading complete
Model selection mode options for the dropdown
Emitted when navigation is requested (record link, external link, email, new record, etc.)
Emitted when a user-facing notification should be shown
Hook called when the user picks a different variant from the picker.
Default is a no-op; the Explorer-level single-record component replaces
this on the form instance to wire FormResolverService.SetSelectedVariant
and reload the record. Kept as a method (not an EventEmitter) so the host
doesn't need to subscribe — assignment is enough.
Read-only summary of SearchScopePermission rows that apply to the scopes this agent is assigned to. Drives a small audit table inside the agent form's Search section so an agent owner can see at a glance who has access to the scopes their agent uses, without navigating away to the Knowledge Hub Config dashboard's full audit surface.
Each entry pairs a scope name with a list of permission rows (principal type + name + level). Rebuilt whenever the agent's AIAgentSearchScope assignments change.
ProtectedplacementThe placement dialog's unsaved panel, when this form is the dialog's preview.
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.
Array of recent execution records for history display
The AI Agent entity being edited
Emitted after a record is deleted successfully
Emitted when a record delete fails
Emitted once after ngOnInit completes and the record is fully initialized (favorites loaded, form state initialized). This is the safe point for the container to start loading badge counts and other record-dependent data.
Emitted after a record is refreshed from the database successfully
Emitted after a record is saved successfully
Emitted when a record save fails
Fires when a section's known row count changes — from the container's batched
count prefetch, a related grid load (including a manual grid refresh), or a
contribution reporting its own count. The container re-resolves empty-section
chrome (whenEmpty) when a count crosses zero.
ProtectedsectionsTracked expanded/collapsed state for each panelbar section
Current category selection for the TreeDropdown
Currently selected context compression prompt
Controls visibility of the new permissions dialog from @memberjunction/ng-agents
Agent status options for the dropdown
Current filter for sub-agents display
Array of sub-agent entities for card display (DEPRECATED - use allSubAgents)
ReadonlyToolbarToolbar config — hide right-hand section controls since this form has a custom layout
Height of the top area when a splitter layout is used. Referenced by CodeGen-generated templates for entities with "top area" sections.
Size of the top area as a percentage (0-100) for angular-split. Used by CodeGen-generated templates with as-split.
Emitted when validation fails before save
Variants applicable to the current (entity, user) tuple, supplied by the Explorer-level form resolver. When more than one entry is present, the record-form-container shows a picker that lets the user switch between variants. Empty / single-entry arrays hide the picker.
The container reads this via its EffectiveVariants accessor — generated
form templates do NOT need to bind it explicitly.
StaticɵdirStaticɵfacUse ActionCount.
Number of actions configured for this agent
Use AgentActions.
Use AgentNotes.
Use AgentPrompts.
Use AgentSessions.
Use AgentType.
Use AgentTypes.
Returns all organic key related entities across all organic keys, flattened and sorted.
Use ChildSubAgentCount.
Number of child sub-agents (ParentID-based)
Use CustomSectionContainer instead.
The entry-time duplicate check. While a person enters a new record it asks the server, after
each pause in editing, whether the values duplicate existing records, and holds the ones to
flag. It only flags: saving is never blocked and nothing is merged. mj-record-form-container
shows the notice.
Number of execution history records
Use ExecutionHistoryView.
Message shown when the execution-history search matches nothing.
Use ExecutionSearchText.
Use ExpandedExecutions.
Use FilteredExecutions.
Use FilteredSubAgents.
Filtered sub-agents based on current filter
Context handed to every field, panel and slot in the form.
Returns the SAME object while nothing in it has changed. Templates bind this getter in dozens of places per form, and Angular evaluates each binding on every change-detection pass — so allocating a fresh object per access handed every child a new reference each pass, defeating input-identity checks and cascading re-renders through the whole form. Building the candidate is cheap (the expensive part, hidden section keys, is memoized); the identity comparison below is what stops the cascade.
Surfaces the type section's own edits to the toolbar and the navigate-away guard.
A flow canvas edit changes no field on the agent row, so record.Dirty stays false and the
form would otherwise report itself clean while the user is looking at unsaved steps.
True when this agent's type contributes a designer pane (Flow does; Loop does not).
Use HasNextPage.
Checks if there is a next page available
Whether the current entity has any active organic keys with related entities configured.
Use HasPreviousPage.
Checks if there is a previous page available
Use HasUnsavedChanges.
Use IsLoadingData.
Use IsLoadingPage.
Use LearningCycleCount.
Number of learning cycles for this agent
Use LearningCycles.
Use LoadingSessions.
Use LoadingStates.
Use LoadingStates.
Use ModelSelectionModes.
Use NoteCount.
Number of notes associated with this agent
Returns all active organic keys for the current entity, or an empty array if none.
Whether this form renders its own body in full.
A form that returns true accepts nothing the container would otherwise compose into
it: no BaseFormPanel mounts, no contribution claims a section, and no stock grid is
filled in for a DisplayInForm relationship. The composition snapshot reports none of
them either. Container chrome that belongs to the record rather than to the body —
the toolbar, Save/Delete, History, Record Changes — is unaffected.
The fill-in reads an unbaked relationship as stale CodeGen and supplies the missing grid. A form that replaced the body bakes nothing by design, so without this flag every relationship reads as missing and the container composes a form the author never asked for.
ProtectedPendingUse PromptCount.
Number of prompts associated with this agent
Returns either the default Metadata provider or the one specified in the Provider property, if it was specified
Use RecentExecutions.
Returns all dynamically registered toolbar items.
Use RelatedSubAgentCount.
Number of related sub-agents (Relationship-based)
Returns either the default RunQuery provider or the one specified in the Provider property, if it was specified
Returns either the default RunView provider or the one specified in the Provider property, if it was specified
Whether the possible-duplicate notice shows: a new record with flagged candidates not dismissed.
Use StatusOptions.
Use SubAgentCount.
Number of sub-agents under this agent (for backward compatibility)
Use SubAgentFilter.
Use SubAgents.
Use ToolbarConfig.
Returns the map of toolbar item overrides.
Use TotalPages.
Gets the total number of pages
Use TotalSessionCount.
Use TotalSubAgentCount.
Total number of sub-agents across both types
Check if user can create AI Agent Actions
Check if user can create AI Prompts (needed for creating new prompts)
Check if user can create both AI Prompts and AI Agent Prompts (for createNewPrompt functionality)
Check if user can create AI Agent Notes
Check if user can create AI Agent Prompts
Check if user can create AI Agents (for sub-agents)
Check if user can delete AI Agent Actions
Check if user can delete AI Agent Notes
Check if user can delete AI Agent Prompts
Check if user can delete AI Agents (for sub-agents)
Check if user can update AI Agent Actions
Check if user can update AI Agent Notes
Check if user can update AI Agent Prompts
Check if user can update AI Agents (for sub-agents)
Check if user can view AI Agent Runs (execution history)
Check if user can view AI Agent Learning Cycles
Check if user can view AI Agent Sessions (realtime voice session history)
Use AddNote.
Adds a new note to the agent
Use AddPrompt.
Adds a new prompt to the agent (deferred until save)
Use AddSubAgents.
Opens the sub-agent selector dialog for adding sub-agents (deferred until save)
Builds RunViewParams for a specific organic key related entity.
Convenience method to build organic key view params by organic key name and related entity name.
OptionalrelatedEntityJoinField: stringOne grid over several FKs to the same related entity (Bill-To OR Ship-To).
Override CancelEdit to restore UI state when user cancels changes
ProtectedCheckAsks the server whether the values being entered duplicate existing records. A form on a
provider that is not a GraphQLDataProvider has no server to ask, so the check reports
NotConfigured and stops for the entity. Override to send the check elsewhere.
Clears the selected context compression prompt
Use ClearPermissionCache.
Clears the permission cache. Call this when user context changes or permissions are updated.
Use ConfigureActions.
Opens the modern Add Action dialog for selecting actions (deferred until save)
Opens a dialog to configure the output mapping for a related sub-agent
Configures overrides for any toolbar item (standard built-in items like 'edit', 'delete', 'favorite', 'history', etc., or custom items). Allows dynamically changing visibility, disabled state, tooltips, order, icon, etc.
Use CreateChildSubAgent.
Creates a new child sub-agent (renamed from createSubAgent for clarity)
Use CreateSubAgent.
Creates a new sub-agent using the CreateAgentService slide-in panel. Uses the new unified agent creation UI from @memberjunction/ng-agents.
Use DebugPendingRecords.
Debug method to check current pending records state Useful for troubleshooting cancel/revert issues
Dynamically disables a toolbar item by key, with an optional reason string for the tooltip.
Optionalreason: stringThe person dismissed the possible-duplicate notice.
Formats cost with appropriate precision
Formats execution time
Optionaldecimals: numberOptionalcurrency: stringSession duration: created → closed (terminal) or last-active (still open).
Formats token count with appropriate units (K for thousands, M for millions)
Optionaldecimals: numberOptionalcurrency: stringUse GetActionCount.
Gets the count of actions
Gets the icon class for an action Falls back to default bolt icon if no IconClass is set
Use GetAgentIcon.
Gets the agent's display icon Prioritizes LogoURL, falls back to IconClass, then default robot icon
Custom-layout AI Agent form looks best full-width on first open.
OptionalrelatedEntityJoinField: stringGets the icon for the execution mode
Gets the full execution result message for expanded view
Gets a preview of the execution result for collapsed view
Gets the status color for execution runs
Gets the status icon for execution runs
Gets the priority badge color
Gets the priority label
Use GetPromptCount.
Gets the count of prompts
ProtectedgetGet the expanded state for a panelbar section, falling back to a default
Where this key sits in the section order, or null when it is not in it at all.
getSectionDisplayOrder cannot answer that: it returns the section count for an unknown key, which is indistinguishable from a real last position. A contribution panel is not in the form's declared sections, so a caller has to be able to tell "the user placed this here" from "nobody has said where this goes".
The row count shown as a section's badge. undefined until known, and always
undefined for a section whose badge is turned off (showCount: false) — use
PeekSectionRowCount for the underlying number.
Status color for a session lifecycle status (Active / Idle / Closed).
Status icon for a session lifecycle status.
Use GetStatusBadgeColor.
Returns the appropriate color for the agent status badge. Uses standard color coding: green for active, yellow for pending, gray for disabled.
CSS color value for the status badge
Gets the badge color for a sub-agent based on its type
Gets the badge icon for a sub-agent based on its type
Gets the badge text for a sub-agent based on its type
Use GetSubAgentCount.
Gets the count of sub-agents
Gets the icon for a sub-agent Prioritizes LogoURL, falls back to IconClass, then default robot icon
Gets the payload information string for display
Use GoToNextPage.
Navigates to the next page of execution history
Use GoToPreviousPage.
Navigates to the previous page of execution history
Whether to show a run's result: the run is no longer Running and has a result. A running run can
already have a partial FinalPayload.
Use HasLogoURL.
Checks if the agent has a logo URL (for image display)
ProtectedinitProtectedInternalThe base SaveRecord() method will call this InternalSaveRecord() method after handling validation and pending record population
OptionaldefaultExpanded: booleanUse LinkRelatedSubAgent.
Opens dialog to link an existing agent as a related sub-agent
Loads the permission summary for the scopes currently assigned to this agent. Called on agent load and after AIAgentSearchScope edits.
Navigates to a related entity
Navigates to the parent agent when the "Child of..." badge is clicked
Default values for a new related-entity record so it links back here.
Pass relatedEntityJoinField when more than one relationship targets the
same entity (Bill-To vs Ship-To). When omitted and several matches exist,
every matching FK is set — same fields the related grid is filtering on.
OptionalrelatedEntityJoinField: stringDefault values for a new related record, setting every listed join field to this record's key. Pair with BuildRelationshipViewParamsForJoinFields.
A callback method that is invoked immediately after Angular has completed initialization of a component's view. It is invoked only once when the view is instantiated.
Update custom section when EditMode changes
Component cleanup - critical for preventing memory leaks
After view initialization, load any custom form section if defined
Handle category selection change from the TreeDropdown
Handle context compression toggle and reset related fields when disabled
Handles state change events for the custom section panel
The panel bar state change event
Hook invoked when a custom or dynamic toolbar item is clicked. Subclasses can override this method to handle custom button clicks.
Handles delete requests from the form container. Emits RecordDeleted on success, RecordDeleteFailed on failure. Generated form templates bind this as: (DeleteRequested)="OnDeleteRequested()"
Handles search text changes - debounced to avoid excessive processing
Handles favorite toggle from the form container. Generated form templates bind this as: (FavoriteToggled)="OnFavoriteToggled()"
A person edited a field on this form. For a new record this restarts the entry-time duplicate
check. mj-record-form-container calls it for every mj-form-field edit; a custom editor that
changes the record some other way can call it too.
A user who cannot read the entity (one who may only create its records) never starts a check: the server would refuse it, and a flagged record is one they could not open anyway.
Handles navigation events from the form container and related entity grids. Relays the event upward via the Navigate
Handles history view requests from the form container. Generated form templates bind this as: (HistoryRequested)="OnHistoryRequested()"
Opens the substrate behind an invocation pathway.
The Invocations widget names the row but never navigates to it — it is a widgets-layer
component with no Router by construction. Translating that intent into navigation is exactly
the job of this layer.
Handles list management requests from the form container. Generated form templates bind this as: (ListManagementRequested)="OnListManagementRequested()"
Handle panelbar stateChange — fires when any section expands or collapses
Opens the prompt selector dialog for context compression prompt
Opens a flagged candidate the way the form opens any record: a Navigate event the host
handles, never a router call. It asks for a new tab, so the record being entered is kept.
Opens the full execution record in a new view
Opens the advanced settings dialog for a prompt
Opens an AI Agent Session record (renders via the custom session form).
Opens the advanced settings dialog for a sub-agent
Use OpenTestHarness.
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.
The last known row count for a section, regardless of whether its badge shows.
ProtectedPendingProtectedPopulateOverride PopulatePendingRecords to preserve our pending records before parent clears them However, during cancel operations, we want to clear all pending records completely
ProtectedRaiseRe-fetches the current record from the database, updating field values in-place and resetting dirty flags. No-op in edit mode or on an unsaved record. Related-entity grids are notified via the form container's FormRecordRefreshCoordinator after this emits RecordRefreshed.
true if the record was reloaded from the database.
Use RefreshRelatedData.
Refreshes the related data and updates snapshots
Use RefreshSnapshot.
Manually refreshes the snapshot for cancel/revert functionality Useful when you want to reset the "original state" to the current state
Slot hosts register every mounted panel so validation can include panel-owned checks.
Registers a dynamic toolbar action item / button. Can be called during ngOnInit or at runtime.
Removes an action from the agent (deferred until save)
Removes a child sub-agent (updated to work with UnifiedSubAgent)
Use RemovePrompt.
Removes a prompt from the agent (deferred until save)
Use RemoveSubAgent.
Removes a sub-agent from this agent (deferred until save)
Switches the Execution History section between agent runs and voice sessions.
Show or hide a section's row-count badge (metadata showCount). The count itself is still tracked.
Sets the sub-agent filter to show all, child, or related sub-agents
Sets the numeric display order for a toolbar item (lower numbers appear earlier).
Called when the splitter layout changes (for entities with "top area" sections). No-op in the generic version; override in host application if splitter resizing is needed.
Toggles the expanded state of an execution card
Toggle the header between expanded and collapsed modes
Unlinks a related sub-agent (removes the relationship)
Unregisters a previously registered dynamic toolbar item by key.
Updates payload field values from code editor
Record + pending-record validation, merged with whatever panel validity is already known.
Synchronous, and therefore blind to a panel validator that has not reported yet — any path that gates a save must use ValidateAsync. The signature stays synchronous because this is published API with external callers.
Validate, merged with every mounted panel's validator, awaited. This is what
SaveRecord() calls.
It starts from Validate(), so a subclass that overrides Validate() still gates the
save; the panels' last-known state is left out of that call, because their awaited
results replace it.
A panel's Validate() may be async — anything checking server state will be — and
reading such a result synchronously yields a Promise, which tests as "no opinion"
and lets an invalid record save with no error and no log.
ProtectedValidate
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:
Form Sections:
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