Class WebSearchCallPart

java.lang.Object

uno.anahata.asi.agi.event.BasicPropertyChangeSource

uno.anahata.asi.agi.message.AbstractPart

uno.anahata.asi.agi.message.TextPart

uno.anahata.asi.agi.message.ModelTextPart

uno.anahata.asi.agi.message.web.WebSearchCallPart

All Implemented Interfaces:

PropertyChangeSource, ThoughtSignature, Rebindable

public class WebSearchCallPart
extends ModelTextPart

A specialized part representing a search query or search intent generated by the model.

This part captures the explicit "Web Search" action performed by the model on the server. While the results are typically aggregated in GroundingMetadata, this part maintains the chronological record of the search query within the conversation flow.

Author:

anahata

Field Summary

Fields

Modifier and Type	Field	Description
private List<String>	queries	The list of search queries generated by the model.

Fields inherited from class BasicPropertyChangeSource

propertyChangeSupport

Modifier and Type	Field	Description
protected PropertyChangeSupport	propertyChangeSupport	Support for firing property change events.

Constructor Summary

Constructors

Constructor	Description
WebSearchCallPart(AbstractModelMessage message, String displayText, List<String> queries, byte[] thoughtSignature)	Constructs a new ModelSearchCallPart.

Method Summary

Modifier and Type	Method	Description
String	asText()	Returns the content of the part as a simple string.
protected int	getDefaultMaxDepth()	Template method hook for subclasses to provide their specific default max depth policy.

Methods inherited from class ModelTextPart

isThought

Modifier and Type	Method	Description
boolean	isThought()	Indicates if this text part represents a model thought process.

Methods inherited from class TextPart

appendMetadata, appendText, calculateTokenCount, resetTokenCount, setText

Modifier and Type	Method	Description
protected void	appendMetadata(StringBuilder sb)	Hook for subclasses to inject specialized metadata into the part header.
void	appendText(String delta)	Appends text to the existing content and fires a property change event.
protected void	calculateTokenCount()	Performs the lazy, model-specific token calculation for this part.
void	resetTokenCount()	Resets the cached token count, forcing a lazy, background recalculation on the next call to getTokenCount().
void	setText(String text)	Sets the text content and fires a property change event for the "text" property.

Methods inherited from class AbstractPart

createMetadataHeader, getAgi, getAgiConfig, getEffectiveMaxDepth, getEffectiveTokenCount, getIdentityLabel, getMetadataTokenCount, getPrunedHint, getRemainingDepth, getTokenCount, isAuto, isEffectivelyPruned, isPinned, isPruned, remove, setExpanded, setPruningState, setPruningState, setTokenCount

Modifier and Type	Method	Description
String	createMetadataHeader()	Creates a standardized text header containing metadata for this part.
Agi	getAgi()	Gets the parent agi session.
AgiConfig	getAgiConfig()	Gets the agi configuration.
final int	getEffectiveMaxDepth()	The definitive method for resolving the max depth policy for this part.
int	getEffectiveTokenCount()	Calculates the total "effective" tokens contributed by this part.
protected String	getIdentityLabel()	Returns the identity label for the metadata header (e.g., "Part ID: 45").
int	getMetadataTokenCount()	Calculates the token count of the metadata header for this part.
String	getPrunedHint()	Returns a summarized string representation of the part's content to be used as a "Hint" when the part is effectively pruned.
int	getRemainingDepth()	Calculates the remaining depth before this part is auto-pruned.
int	getTokenCount()	Retrieves the cached token count for this part.
boolean	isAuto()	Checks if this part is managed automatically.
boolean	isEffectivelyPruned()	Calculates the EFFECTIVE pruned state of this part.
boolean	isPinned()	Checks if this part is explicitly pinned.
boolean	isPruned()	Checks if this part is explicitly pruned.
void	remove()	Removes this part from its parent message and severs the bidirectional link.
void	setExpanded(boolean expanded)	Sets the expanded state and fires a property change event.
void	setPruningState(PruningState pruningState)	Sets the pruning state of this part and fires a property change event.
void	setPruningState(PruningState pruningState, String reason)	Sets the pruning state of this part with an optional reason.
void	setTokenCount(int tokenCount)	Sets the token count and fires a property change event.

Methods inherited from class BasicPropertyChangeSource

addPropertyChangeListener, addPropertyChangeListener, rebind, removePropertyChangeListener, removePropertyChangeListener

Modifier and Type	Method	Description
void	addPropertyChangeListener(PropertyChangeListener listener)	Adds a property change listener.
void	addPropertyChangeListener(String propertyName, PropertyChangeListener listener)	Adds a property change listener for a specific property.
void	rebind()	Re-initializes the transient PropertyChangeSupport after deserialization.
void	removePropertyChangeListener(PropertyChangeListener listener)	Removes a property change listener.
void	removePropertyChangeListener(String propertyName, PropertyChangeListener listener)	Removes a property change listener for a specific property.

Methods inherited from class Object

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

Methods inherited from interface PropertyChangeSource

getPropertyChangeSupport

Modifier and Type	Method	Description
PropertyChangeSupport	getPropertyChangeSupport()	Gets the PropertyChangeSupport instance for this object.

Methods inherited from interface ThoughtSignature

getThoughtSignature, setThoughtSignature

Modifier and Type	Method	Description
byte[]	getThoughtSignature()	Gets the signature of the thought process as a byte array.
void	setThoughtSignature(byte[] thoughtSignature)	Sets the signature of the thought process as a byte array.

Field Details

queries

private List<String> queries

The list of search queries generated by the model.

Constructor Details

WebSearchCallPart

public WebSearchCallPart(AbstractModelMessage message,
 String displayText,
 List<String> queries,
 byte[] thoughtSignature)

Constructs a new ModelSearchCallPart.

Parameters:

message - The model message that triggered the search.

displayText - A human-readable summary of the search action.

queries - The list of search queries executed.

thoughtSignature - The signature of the thought process associated with this search, if any.

Method Details

asText

public String asText()

Returns the content of the part as a simple string. This is implemented by subclasses.

Returns a formatted string indicating a hosted search call and its queries.

Overrides:

asText in class TextPart

Returns:

The text representation of the part.

getDefaultMaxDepth

protected int getDefaultMaxDepth()

Template method hook for subclasses to provide their specific default max depth policy. This is the fallback value used when no explicit maxDepth is set on the instance. Returns the default maximum depth to keep a text part in context, as defined in the agi configuration. Returns the default maximum depth for thoughts if this is a thought part, otherwise falls back to the standard text part depth.

Returns the default maximum depth to keep a web search call part in context.

Overrides:

getDefaultMaxDepth in class ModelTextPart

Returns:

The default maximum depth for this part type.