Class UserBlobPart

java.lang.Object

uno.anahata.asi.agi.event.BasicPropertyChangeSource

uno.anahata.asi.agi.message.AbstractPart

uno.anahata.asi.agi.message.BlobPart

uno.anahata.asi.agi.message.UserBlobPart

All Implemented Interfaces:

PropertyChangeSource, Rebindable

public class UserBlobPart
extends BlobPart

A concrete BlobPart implementation for binary content provided by the user. It publishes itself to the parent message only after full initialization.

Author:

anahata

Field Summary

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
UserBlobPart(@NonNull AbstractMessage message, @NonNull String mimeType, @NonNull byte[] data)	Constructs a new UserBlobPart and adds it to the parent message.
UserBlobPart(@NonNull AbstractMessage message, @NonNull String mimeType, @NonNull byte[] data, @NonNull Path sourcePath)

Method Summary

Modifier and Type	Method	Description
static UserBlobPart	from(@NonNull AbstractMessage message, @NonNull File file)	A convenience factory method to create a UserBlobPart from a legacy File object.
static UserBlobPart	from(@NonNull AbstractMessage message, @NonNull Path path)	A convenience factory method to create a UserBlobPart from a local file path.

Methods inherited from class BlobPart

appendMetadata, asText, calculateTokenCount, getDefaultMaxDepth, getPrunedHint

Modifier and Type	Method	Description
protected void	appendMetadata(StringBuilder sb)	Hook for subclasses to inject specialized metadata into the part header.
String	asText()	Returns the content of the part as a simple string.
protected void	calculateTokenCount()	Performs the lazy, model-specific token calculation for this part.
protected int	getDefaultMaxDepth()	Template method hook for subclasses to provide their specific default max depth policy.
String	getPrunedHint()	Returns a summarized string representation of the part's content to be used as a "Hint" when the part is effectively pruned.

Methods inherited from class AbstractPart

createMetadataHeader, getAgi, getAgiConfig, getEffectiveMaxDepth, getEffectiveTokenCount, getIdentityLabel, getMetadataTokenCount, getRemainingDepth, getTokenCount, isAuto, isEffectivelyPruned, isPinned, isPruned, remove, resetTokenCount, 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.
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	resetTokenCount()	Resets the cached token count, forcing a lazy, background recalculation on the next call to getTokenCount().
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.

Constructor Details

UserBlobPart

UserBlobPart(@NonNull
 @NonNull AbstractMessage message,
 @NonNull
 @NonNull String mimeType,
 @NonNull
 @NonNull byte[] data)

Constructs a new UserBlobPart and adds it to the parent message.

Parameters:

message - The parent message.

mimeType - The MIME type.

data - The binary data.

UserBlobPart

UserBlobPart(@NonNull
 @NonNull AbstractMessage message,
 @NonNull
 @NonNull String mimeType,
 @NonNull
 @NonNull byte[] data,
 @NonNull
 @NonNull Path sourcePath)

Method Details

from

public static UserBlobPart from(@NonNull
 @NonNull AbstractMessage message,
 @NonNull
 @NonNull Path path)
                         throws Exception

A convenience factory method to create a UserBlobPart from a local file path.

Parameters:

message - The message this part belongs to.

path - The path to the file.

Returns:

A new UserBlobPart instance.

Throws:

IOException - if there's an error reading the file.

Exception - if there's an error detecting the MIME type.

from

public static UserBlobPart from(@NonNull
 @NonNull AbstractMessage message,
 @NonNull
 @NonNull File file)
                         throws Exception

A convenience factory method to create a UserBlobPart from a legacy File object.

Parameters:

message - The message this part belongs to.

file - The file to read.

Returns:

A new UserBlobPart instance.

Throws:

Exception - if there's an error reading the file or detecting the MIME type.