程序包 io.agentscope.core.permission

类 PermissionContextState

java.lang.Object

io.agentscope.core.permission.PermissionContextState

public final class PermissionContextState
extends Object

Permission evaluation context: mode + working directories + three rule tables.

Rule tables are keyed by tool name; each value is the ordered list of rules registered for that tool. The engine evaluates denyRules first, then askRules, then tool self-check, then allowRules; see the PermissionEngine javadoc for full ordering.

嵌套类概要

嵌套类

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

方法概要

修饰符和类型	方法	说明
static PermissionContextState.Builder	builder()
boolean	equals(Object o)
Map<String,List<PermissionRule>>	getAllowRules()
Map<String,List<PermissionRule>>	getAskRules()
Map<String,List<PermissionRule>>	getDenyRules()
PermissionMode	getMode()
Map<String,AdditionalWorkingDirectory>	getWorkingDirectories()
int	hashCode()
boolean	isTrivial()	Whether this context is "trivial" — built from PermissionContextState.Builder.build() with no further customisation.
String	toString()
PermissionContextState	withMode(PermissionMode newMode)	Returns a copy of this context with the PermissionMode replaced and every working directory and rule preserved.

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

方法详细资料

getMode

public PermissionMode getMode()

isTrivial

public boolean isTrivial()

Whether this context is "trivial" — built from PermissionContextState.Builder.build() with no further customisation. Used by ReAct agents to decide whether to engage the full permission engine (rules + mode + tool self-check) or fall back to the lightweight, pre-2.0 path that only gates on the tool's own checkPermissions self-check.

getWorkingDirectories

public Map<String,AdditionalWorkingDirectory> getWorkingDirectories()

getAllowRules

public Map<String,List<PermissionRule>> getAllowRules()

getDenyRules

public Map<String,List<PermissionRule>> getDenyRules()

getAskRules

public Map<String,List<PermissionRule>> getAskRules()

builder

public static PermissionContextState.Builder builder()

withMode

public PermissionContextState withMode(PermissionMode newMode)

Returns a copy of this context with the PermissionMode replaced and every working directory and rule preserved. Used to switch the evaluation mode at runtime (e.g. flipping a session into PermissionMode.BYPASS) without losing the configured rules.

参数:

newMode - the mode the returned context should use

返回:

a new context identical to this one except for its mode (returns this when the mode is unchanged)

equals

public boolean equals(Object o)

覆盖:

equals 在类中 Object

hashCode

public int hashCode()

覆盖:

hashCode 在类中 Object

toString

public String toString()

覆盖:

toString 在类中 Object