程序包 io.agentscope.core.state

类 ToolContextState

java.lang.Object

io.agentscope.core.state.ToolContextState

public final class ToolContextState
extends Object

Read-cache backing for file-touching tools (Read / Write / Edit).

Maintains an ordered LRU list of ReadCacheEntry bounded by both entry count and total bytes. Cache reads are validated against the file's current mtime; stale entries are evicted on access. All filesystem interaction runs on Schedulers.boundedElastic() so Reactor's non-blocking schedulers are never blocked.

Only configuration fields (maxCacheFiles, maxCacheBytes, activatedGroups) participate in JSON serialization. The in-memory LRU cache itself is runtime state and is reconstructed empty on deserialization.

嵌套类概要

嵌套类

修饰符和类型	类	说明
static final class	ToolContextState.Builder

方法概要

修饰符和类型	方法	说明
static ToolContextState.Builder	builder()
reactor.core.publisher.Mono<Void>	cacheFile(String filePath, List<String> lines)	Insert lines for filePath into the cache, evicting older entries to satisfy both maxCacheFiles and maxCacheBytes.
List<String>	getActivatedGroups()
reactor.core.publisher.Mono<Optional<ReadCacheEntry>>	getCache(String filePath)	Look up the cached entry for filePath.
double	getMaxCacheBytes()
int	getMaxCacheFiles()
List<ReadCacheEntry>	getReadFileCache()	Snapshot of the cache list at call time.
void	setActivatedGroups(List<String> groups)	Replace the activated tool groups with the given list.

从类继承的方法 java.lang.Object

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

方法详细资料

getMaxCacheFiles

public int getMaxCacheFiles()

getMaxCacheBytes

public double getMaxCacheBytes()

getReadFileCache

public List<ReadCacheEntry> getReadFileCache()

Snapshot of the cache list at call time. Modifications do not affect the live cache.

getActivatedGroups

public List<String> getActivatedGroups()

setActivatedGroups

public void setActivatedGroups(List<String> groups)

Replace the activated tool groups with the given list.

参数:

groups - the new activated groups; null clears the list

getCache

public reactor.core.publisher.Mono<Optional<ReadCacheEntry>> getCache(String filePath)

Look up the cached entry for filePath. Evicts and returns empty if the file's mtime has changed or the file no longer exists.

cacheFile

public reactor.core.publisher.Mono<Void> cacheFile(String filePath,
 List<String> lines)

Insert lines for filePath into the cache, evicting older entries to satisfy both maxCacheFiles and maxCacheBytes. If the file's mtime is unavailable the insert is silently skipped.

builder

public static ToolContextState.Builder builder()