Class AiModelsPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

uno.anahata.asi.swing.provider.AiModelsPanel

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

public class AiModelsPanel
extends JPanel

A high-fidelity visual registry for exploring, configuring, and registering AI models.

This panel utilizes a JXTable and rich filter controls (provider dropdown with icons, keyword/regex query field, response modality toggles, and effectively-enabled state filter) to provide advanced discovery and lifecycle management. Models can be enabled/disabled, added from API discovery caches to local persistent storage, deleted, or reset when discrepancies occur.

Author:

anahata

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private class	AiModelsPanel.Column0CellEditor	Active cell editor for Column 0.
private class	AiModelsPanel.Column0CellRenderer	Stateless cell renderer for Column 0.
private class	AiModelsPanel.ModelActionsCellEditor	Active cell editor providing Remove and Reset buttons for table rows.
private class	AiModelsPanel.ModelActionsCellRenderer	Stateless cell renderer providing Remove and Reset buttons for table rows.

Nested classes/interfaces inherited from class JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field	Description
private final JButton	addNewModelsButton	Button to add all unregistered API models to the local database in a single batch.
private final AbstractAsiContainer	asiContainer	Container reference for background model fetching and executor pooling.
private final JToggleButton	audioToggle	Toggle button for filtering by AUDIO response modality.
private final JCheckBox	effectivelyEnabledCheckbox	Checkbox to filter models to only effectively enabled providers.
private final JTextField	filterField	The real-time search and filter input field.
private final JToggleButton	imageToggle	Toggle button for filtering by IMAGE response modality.
private final Consumer<AbstractModel>	modelSelectionCallback	Reactive callback for notifying the system of a user's model selection.
private final JProgressBar	progressBar	Bottom status bar indeterminate progress bar for async background tasks.
private final JComboBox<AbstractAiProvider>	providerComboBox	The dropdown combo box for selecting/filtering by AI provider.
private final JLabel	providerLabel	The label for the provider combo box.
private final JButton	refreshButton	Refresh button to reload models from providers' live APIs.
private final JButton	removeSelectedButton	Button to remove selected models from local storage.
private final JButton	resetSelectedButton	Button to reset selected models with discrepancies back to API specifications.
private final JLabel	statusLabel	Bottom status bar label showing active model counts and operations feedback.
private final JXTable	table	The advanced SwingX table instance for model discovery.
private final AiModelTableModel	tableModel	The technical data model powering the table.
private AbstractAiProvider	targetProvider	Target provider lock when embedded in a single provider configuration panel.
private final JToggleButton	textToggle	Toggle button for filtering by TEXT response modality.
private final JToggleButton	videoToggle	Toggle button for filtering by VIDEO response modality.

Fields inherited from class JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
AiModelsPanel(List<AbstractModel> models, @NonNull AbstractAsiContainer asiContainer, Consumer<AbstractModel> modelSelectionCallback)	Constructs a new AiModelsPanel with container-aware refresh capabilities.

Method Summary

Modifier and Type	Method	Description
private void	addAllNewModels()	Adds all newly discovered API models to the local database in a single batch.
private void	applyFilter()	Evaluates all active filters (provider, search query regex, response modalities, and enabled status) and updates the table row filter accordingly.
private String	formatModelToolTip(AbstractModel m)	Formats a clean, bounded HTML tooltip card for a model without overflowing the monitor.
private int	getUnregisteredApiModelsCount()	Calculates the count of models discovered from API that are not yet persisted locally.
private void	refreshModelsFromProviders()	Refreshes models asynchronously from providers using a SwingTask, updating the table progressively.
private void	refreshTableData()	Refreshes the table view with current models from providers.
private void	removeSelectedModels()	Removes all selected registered models from local storage in a single batch.
private void	resetSelectedModels()	Resets all selected registered models with discrepancies back to API specifications.
private void	selectModel(AbstractModel model)	Dispatches the model selection callback.
void	setTargetProvider(AbstractAiProvider provider)	Locks and targets this panel to a specific provider (used when embedding in AiProviderPanel).
private void	showTableContextMenu(MouseEvent e)	Displays a context menu on right-click allowing quick copying of the model ID or inspecting full raw metadata in the environment's native code viewer.
private void	updateAddNewModelsButton()	Updates the text and visibility of the "Add X New Models" button based on unregistered API models.
private void	updateSelectionActionButtons()	Updates the enabled state of the 'Remove Selected' and 'Reset Selected' buttons based on active table selection.

Methods inherited from class JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

table

private final JXTable table

The advanced SwingX table instance for model discovery.

tableModel

private final AiModelTableModel tableModel

The technical data model powering the table.

filterField

private final JTextField filterField

The real-time search and filter input field.

providerLabel

private final JLabel providerLabel

The label for the provider combo box.

providerComboBox

private final JComboBox<AbstractAiProvider> providerComboBox

The dropdown combo box for selecting/filtering by AI provider.

textToggle

private final JToggleButton textToggle

Toggle button for filtering by TEXT response modality.

imageToggle

private final JToggleButton imageToggle

Toggle button for filtering by IMAGE response modality.

audioToggle

private final JToggleButton audioToggle

Toggle button for filtering by AUDIO response modality.

videoToggle

private final JToggleButton videoToggle

Toggle button for filtering by VIDEO response modality.

effectivelyEnabledCheckbox

private final JCheckBox effectivelyEnabledCheckbox

Checkbox to filter models to only effectively enabled providers.

refreshButton

private final JButton refreshButton

Refresh button to reload models from providers' live APIs.

addNewModelsButton

private final JButton addNewModelsButton

Button to add all unregistered API models to the local database in a single batch.

removeSelectedButton

private final JButton removeSelectedButton

Button to remove selected models from local storage.

resetSelectedButton

private final JButton resetSelectedButton

Button to reset selected models with discrepancies back to API specifications.

statusLabel

private final JLabel statusLabel

Bottom status bar label showing active model counts and operations feedback.

progressBar

private final JProgressBar progressBar

Bottom status bar indeterminate progress bar for async background tasks.

asiContainer

private final AbstractAsiContainer asiContainer

Container reference for background model fetching and executor pooling.

modelSelectionCallback

private final Consumer<AbstractModel> modelSelectionCallback

Reactive callback for notifying the system of a user's model selection.

targetProvider

private AbstractAiProvider targetProvider

Target provider lock when embedded in a single provider configuration panel.

Constructor Details

AiModelsPanel

public AiModelsPanel(List<AbstractModel> models,
 @NonNull
 @NonNull AbstractAsiContainer asiContainer,
 Consumer<AbstractModel> modelSelectionCallback)

Constructs a new AiModelsPanel with container-aware refresh capabilities.

Parameters:

models - The initial list of models to display.

asiContainer - The parent ASI container providing thread pools and provider registries.

modelSelectionCallback - A callback for when a model is double-clicked.

Method Details

formatModelToolTip

private String formatModelToolTip(AbstractModel m)

Formats a clean, bounded HTML tooltip card for a model without overflowing the monitor.

Parameters:

m - The model entity.

Returns:

Bounded HTML tooltip string, or null.

selectModel

private void selectModel(AbstractModel model)

Dispatches the model selection callback. If the selected model is not yet registered in local storage, it is automatically registered and persisted without prompting. If registration fails, an ExceptionDialog is displayed to the user and selection does not proceed.

Parameters:

model - The model entity to select.

showTableContextMenu

private void showTableContextMenu(MouseEvent e)

Displays a context menu on right-click allowing quick copying of the model ID or inspecting full raw metadata in the environment's native code viewer.

Parameters:

e - The mouse event.

setTargetProvider

public void setTargetProvider(AbstractAiProvider provider)

Locks and targets this panel to a specific provider (used when embedding in AiProviderPanel).

Parameters:

provider - The target provider to lock to.

updateAddNewModelsButton

private void updateAddNewModelsButton()

Updates the text and visibility of the "Add X New Models" button based on unregistered API models.

getUnregisteredApiModelsCount

private int getUnregisteredApiModelsCount()

Calculates the count of models discovered from API that are not yet persisted locally.

Returns:

The count of unregistered API models.

addAllNewModels

private void addAllNewModels()

Adds all newly discovered API models to the local database in a single batch.

refreshTableData

private void refreshTableData()

Refreshes the table view with current models from providers.

updateSelectionActionButtons

private void updateSelectionActionButtons()

Updates the enabled state of the 'Remove Selected' and 'Reset Selected' buttons based on active table selection.

removeSelectedModels

private void removeSelectedModels()

Removes all selected registered models from local storage in a single batch.

resetSelectedModels

private void resetSelectedModels()

Resets all selected registered models with discrepancies back to API specifications.

applyFilter

private void applyFilter()

Evaluates all active filters (provider, search query regex, response modalities, and enabled status) and updates the table row filter accordingly.

refreshModelsFromProviders

private void refreshModelsFromProviders()

Refreshes models asynchronously from providers using a SwingTask, updating the table progressively.