Package io.agentscope.harness.agent

Class HarnessAgent.Builder

java.lang.Object

io.agentscope.harness.agent.HarnessAgent.Builder

Enclosing class:

HarnessAgent

public static class HarnessAgent.Builder
extends Object

Builder for HarnessAgent. Owns the harness orchestration: workspace + filesystem + sandbox + hooks/middlewares + tools + skills + subagents + tools.json + plan-mode.

Method Summary

Modifier and Type	Method	Description
HarnessAgent.Builder	abstractFilesystem(AbstractFilesystem store)	Escape hatch: sets a custom AbstractFilesystem implementation directly.
HarnessAgent.Builder	additionalContextFile(String relativePath)	Adds a custom context file (relative to workspace) loaded into the system prompt alongside AGENTS.md, MEMORY.md, and KNOWLEDGE.md.
HarnessAgent.Builder	agentId(String agentId)	Sets the stable identifier used as the agent's namespace key in the composite filesystem (e.g.
HarnessAgent.Builder	allowShellInPlanMode()	Allows the shell tool (execute) to run while plan mode is active.
HarnessAgent.Builder	allowShellInPlanMode(boolean allowed)
HarnessAgent.Builder	asyncToolRegistry(AsyncToolRegistry registry)	Sets the AsyncToolRegistry for tracking async tool executions.
HarnessAgent.Builder	asyncToolTimeout(Duration timeout)	Enables AsyncToolMiddleware with the given timeout.
HarnessAgent	build()
List<SubagentEntry>	buildSubagentEntries(Path resolvedWorkspace)	Builds the subagent entries (general-purpose + declared + custom factories) without constructing the full agent.
List<SubagentEntry>	buildSubagentEntries(Path resolvedWorkspace, SandboxBackedFilesystem sandboxFs)
HarnessAgent.Builder	checkRunning(boolean checkRunning)
HarnessAgent.Builder	compaction(CompactionConfig config)	Overrides the default CompactionMiddleware configuration.
HarnessAgent.Builder	defaultSessionId(String defaultSessionId)
HarnessAgent.Builder	description(String description)
HarnessAgent.Builder	disableAtPathExpansion()
HarnessAgent.Builder	disableCompaction()	Disables the CompactionMiddleware entirely.
HarnessAgent.Builder	disableDefaultWorkspaceSkills()	Skips registration of the default Layer-4 WorkspaceSkillRepository.
HarnessAgent.Builder	disableDynamicSkills()	Disables dynamic per-call skill loading from the workspace filesystem.
HarnessAgent.Builder	disableDynamicSubagents()
HarnessAgent.Builder	disableFilesystemTools()	Skips registration of FilesystemTool.
HarnessAgent.Builder	disableMemoryHooks()
HarnessAgent.Builder	disableMemoryTools()
HarnessAgent.Builder	disableSessionPersistence()	No-op since 2.0; session persistence is owned by ReActAgent itself.
HarnessAgent.Builder	disableShellTool()	Skips registration of ShellExecuteTool.
HarnessAgent.Builder	disableSkills(String... skillNames)
HarnessAgent.Builder	disableSubagents()
HarnessAgent.Builder	disableToolResultEviction()	Disables the ToolResultEvictionMiddleware entirely.
HarnessAgent.Builder	disableToolsConfig()
HarnessAgent.Builder	disableWorkspaceContext()
HarnessAgent.Builder	distributedStore(DistributedStore store)	Configures a distributed store that provides all storage components at once: AgentStateStore, BaseStore, SandboxSnapshotSpec, and SandboxExecutionGuard.
HarnessAgent.Builder	enableAgentTracingLog(boolean enabled)	Enables or disables agent execution trace logging via AgentTraceMiddleware.
HarnessAgent.Builder	enableMetaTool(boolean enableMetaTool)
HarnessAgent.Builder	enablePendingToolRecovery(boolean enable)
HarnessAgent.Builder	enablePlanMode()	Enables plan mode (read-only design phase) with plan_enter/plan_write/ plan_exit tools and a PlanModeMiddleware that enforces read-only tools while plan mode is active.
HarnessAgent.Builder	enablePlanMode(boolean enabled)
HarnessAgent.Builder	enableSkillCurator(SkillCuratorConfig config)	Enables the background skill curator.
HarnessAgent.Builder	enableSkillManageTool(boolean autoPromote)	Shorthand for enableSkillManageTool(SkillManageConfig) with default config.
HarnessAgent.Builder	enableSkillManageTool(SkillManageConfig config)	Enables the agent-callable skill_manage tool so the agent can create / edit / patch / archive its own skills in the workspace, and upgrades the workspace skill repository to a writable variant.
HarnessAgent.Builder	enableSkillPromotionGate(SkillPromotionGate gate, SkillVisibilityFilter visibilityFilter)	Configures the runtime promotion gate + visibility filter chain.
HarnessAgent.Builder	enableSkills(String... skillNames)
HarnessAgent.Builder	enableTaskList()
HarnessAgent.Builder	enableTaskList(boolean enabled)
HarnessAgent.Builder	environment(String env)	Sets the deployment environment label used by EnvironmentFilter.
HarnessAgent.Builder	environmentMemory(String environmentMemory)
HarnessAgent.Builder	externalSubagentTool(Object tool)	Injects an external subagent tool (typically SessionsTool).
HarnessAgent.Builder	fallbackModel(io.agentscope.core.model.Model fallbackModel)
HarnessAgent.Builder	fallbackModel(String modelId)
HarnessAgent.Builder	filesystem(LocalFilesystemSpec spec)	Configures Mode 3 — local filesystem with shell.
HarnessAgent.Builder	filesystem(RemoteFilesystemSpec spec)	Configures Mode 1 — composite (non-sandbox) filesystem.
HarnessAgent.Builder	filesystem(SandboxFilesystemSpec spec)	Configures Mode 2 — sandbox filesystem.
static HarnessAgent.Builder	fromAgent(io.agentscope.core.ReActAgent agent)	Returns a new HarnessAgent.Builder pre-populated with as much of the given ReActAgent's observable configuration as can be read back from public getters.
HarnessAgent.Builder	generateOptions(io.agentscope.core.model.GenerateOptions options)
HarnessAgent.Builder	hook(io.agentscope.core.hook.Hook hook)
HarnessAgent.Builder	hooks(List<io.agentscope.core.hook.Hook> hooks)
HarnessAgent.Builder	maxContextTokens(int maxTokens)	Sets the maximum token budget for workspace context.
HarnessAgent.Builder	maxIters(int maxIters)
HarnessAgent.Builder	maxRetries(int maxRetries)
HarnessAgent.Builder	memory(MemoryConfig config)	Overrides the long-term memory pipeline configuration (flush + consolidation + maintenance).
HarnessAgent.Builder	messageBus(MessageBus messageBus)	Sets the MessageBus for inbox-based message delivery.
HarnessAgent.Builder	middleware(io.agentscope.core.middleware.MiddlewareBase middleware)
HarnessAgent.Builder	middlewares(List<? extends io.agentscope.core.middleware.MiddlewareBase> middlewareList)
HarnessAgent.Builder	model(io.agentscope.core.model.Model model)
HarnessAgent.Builder	model(String modelId)
HarnessAgent.Builder	modelExecutionConfig(io.agentscope.core.model.ExecutionConfig config)
HarnessAgent.Builder	modelResolver(Function<String,io.agentscope.core.model.Model> resolver)	Sets a resolver for model name strings to Model instances for subagents.
HarnessAgent.Builder	name(String name)
HarnessAgent.Builder	permissionContext(io.agentscope.core.permission.PermissionContextState permissionContext)
HarnessAgent.Builder	planFileDirectory(String dir)
HarnessAgent.Builder	projectGlobalSkillsDir(Path projectGlobalSkillsDir)	Configures a project-global skills directory layered below marketplace and workspace skills (lowest precedence).
HarnessAgent.Builder	skillFilter(io.agentscope.core.skill.SkillFilter filter)
HarnessAgent.Builder	skillRepositories(List<io.agentscope.core.skill.repository.AgentSkillRepository> repositories)	Replaces the current marketplace repository list with the given collection.
HarnessAgent.Builder	skillRepository(io.agentscope.core.skill.repository.AgentSkillRepository skillRepository)	Adds a marketplace / external skill repository (e.g.
HarnessAgent.Builder	skillsEnabled(boolean enabled)
HarnessAgent.Builder	stateStore(io.agentscope.core.state.AgentStateStore stateStore)
HarnessAgent.Builder	stopOnReject(boolean stopOnReject)
HarnessAgent.Builder	subagent(SubagentDeclaration declaration)	Adds a subagent declaration.
HarnessAgent.Builder	subagentFactory(String name, Function<String,io.agentscope.core.agent.Agent> factory)	Adds a fully custom subagent factory for a given agent id.
HarnessAgent.Builder	subagents(List<SubagentDeclaration> declarations)
HarnessAgent.Builder	sysPrompt(String sysPrompt)
HarnessAgent.Builder	taskRepository(TaskRepository taskRepository)	Sets a custom TaskRepository for background subagent execution.
HarnessAgent.Builder	toolExecutionConfig(io.agentscope.core.model.ExecutionConfig config)
HarnessAgent.Builder	toolExecutionContext(io.agentscope.core.tool.ToolExecutionContext ctx)
HarnessAgent.Builder	toolkit(io.agentscope.core.tool.Toolkit toolkit)
HarnessAgent.Builder	toolResultEviction(ToolResultEvictionConfig config)	Overrides the default ToolResultEvictionMiddleware configuration.
HarnessAgent.Builder	toolsConfig(ToolsConfig toolsConfig)	Programmatic override for workspace/tools.json.
HarnessAgent.Builder	useLegacyXmlWorkspaceContext(boolean enabled)	Switches workspace context rendering between markdown (default) and legacy XML style.
HarnessAgent.Builder	workspace(String path)	Sets the workspace directory from a filesystem path string.
HarnessAgent.Builder	workspace(Path workspace)	Sets the workspace directory.

Methods inherited from class java.lang.Object

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

Method Details

fromAgent

public static HarnessAgent.Builder fromAgent(io.agentscope.core.ReActAgent agent)

Returns a new HarnessAgent.Builder pre-populated with as much of the given ReActAgent's observable configuration as can be read back from public getters.

This is a partial migration helper. The caller still needs to set every harness-specific concern explicitly (workspace, filesystem, sandbox, subagents, skills, plan mode, etc.) — those have no analog on a vanilla ReActAgent, so they cannot be derived from agent.

What this method copies

Fields copied from the source ReActAgent

Group	Field	Source
Observable configuration	name	agent.getName()
	description	agent.getDescription()
	sysPrompt	agent.getSysPrompt()
	model	agent.getModel()
	maxIters	agent.getMaxIters()
	generateOptions	agent.getGenerateOptions()
	toolkit	defensive copy via agent.getToolkit().copy()
Persistence	session	agent.getStateStore() if non-null
	defaultSessionId	agent.getDefaultSessionId() if non-null
Model resilience (from agent.getModelConfig())	maxRetries	ModelConfig.maxRetries()
	fallbackModel	ModelConfig.fallbackModel() if non-null
Reasoning loop (from agent.getReactConfig())	stopOnReject	ReactConfig.stopOnReject()
Execution	modelExecutionConfig	agent.getModelExecutionConfig() if non-null
	toolExecutionConfig	agent.getToolExecutionConfig() if non-null
Behavior	toolExecutionContext	agent.getToolExecutionContext() if non-null
	enablePendingToolRecovery	agent.isPendingToolRecoveryEnabled()
	checkRunning	agent.isCheckRunning()
Permissions	permissionContext	agent.getPermissionContext() if non-null (the same PermissionContextState is reused; it carries the rules registered on the source engine)
Extension surface	middlewares	agent.getMiddlewares() copied, excluding harness runtime middlewares
Legacy extension	hooks	agent.getHooks() appended as-is (Hook itself is @Deprecated(forRemoval=true); prefer middlewares for new code)

Note: enableMetaTool and enableTaskList are builder-time flags that mutate the toolkit at build. They do not round-trip as flags, but the toolkit copy already carries the tools they registered, so the resulting agent has the same tool surface.

What this method does not copy

Skipped — harness-only, has no source on a ReActAgent. These must be configured on the returned builder if you want HarnessAgent semantics:

• Workspace & filesystem: workspace(Path), filesystem(SandboxFilesystemSpec), filesystem(LocalFilesystemSpec), filesystem(RemoteFilesystemSpec), abstractFilesystem(AbstractFilesystem), environmentMemory(String)
• Subagents: subagent(SubagentDeclaration), subagents(List), subagentFactory(String, Function), externalSubagentTool(Object), taskRepository(TaskRepository), modelResolver(Function)
• Skill governance: skillRepository(AgentSkillRepository), projectGlobalSkillsDir(Path), enableSkillManageTool(SkillManageConfig), enableSkillCurator(SkillCuratorConfig), enableSkillPromotionGate(SkillPromotionGate, SkillVisibilityFilter), skillFilter(io.agentscope.core.skill.SkillFilter), environment(String)
• Plan mode: enablePlanMode(), planFileDirectory(String)
• Context engineering: additionalContextFile(String), maxContextTokens(int), compaction(CompactionConfig), toolResultEviction(ToolResultEvictionConfig), toolsConfig(ToolsConfig)
• All disableXxx() toggles and enableAgentTracingLog(boolean)

Behavior caveats

Even after this method, the built HarnessAgent is not behaviorally equivalent to the source ReActAgent: HarnessAgent installs additional orchestration (workspace projection, agent-tracing middleware, default skill / subagent middlewares) that the source did not have. If left unset, session also defaults to a JsonFileAgentStateStore rooted at ~/.agentscope/state/<agentId>/ rather than the in-memory default, changing the on-disk persistence layout.

Parameters:

agent - source ReActAgent to inherit observable configuration from

Returns:

a new HarnessAgent.Builder pre-populated with the inheritable subset

name

public HarnessAgent.Builder name(String name)

description

public HarnessAgent.Builder description(String description)

sysPrompt

public HarnessAgent.Builder sysPrompt(String sysPrompt)

checkRunning

public HarnessAgent.Builder checkRunning(boolean checkRunning)

model

public HarnessAgent.Builder model(io.agentscope.core.model.Model model)

model

public HarnessAgent.Builder model(String modelId)

toolkit

public HarnessAgent.Builder toolkit(io.agentscope.core.tool.Toolkit toolkit)

maxIters

public HarnessAgent.Builder maxIters(int maxIters)

modelExecutionConfig

public HarnessAgent.Builder modelExecutionConfig(io.agentscope.core.model.ExecutionConfig config)

toolExecutionConfig

public HarnessAgent.Builder toolExecutionConfig(io.agentscope.core.model.ExecutionConfig config)

generateOptions

public HarnessAgent.Builder generateOptions(io.agentscope.core.model.GenerateOptions options)

hook

public HarnessAgent.Builder hook(io.agentscope.core.hook.Hook hook)

hooks

public HarnessAgent.Builder hooks(List<io.agentscope.core.hook.Hook> hooks)

middleware

public HarnessAgent.Builder middleware(io.agentscope.core.middleware.MiddlewareBase middleware)

middlewares

public HarnessAgent.Builder middlewares(List<? extends io.agentscope.core.middleware.MiddlewareBase> middlewareList)

stateStore

public HarnessAgent.Builder stateStore(io.agentscope.core.state.AgentStateStore stateStore)

distributedStore

public HarnessAgent.Builder distributedStore(DistributedStore store)

Configures a distributed store that provides all storage components at once: AgentStateStore, BaseStore, SandboxSnapshotSpec, and SandboxExecutionGuard.

Explicit builder methods (stateStore(), filesystem()) take precedence over the distributed store for the components they configure.

Parameters:

store - the distributed store to use

Returns:

this builder

defaultSessionId

public HarnessAgent.Builder defaultSessionId(String defaultSessionId)

toolExecutionContext

public HarnessAgent.Builder toolExecutionContext(io.agentscope.core.tool.ToolExecutionContext ctx)

enableMetaTool

public HarnessAgent.Builder enableMetaTool(boolean enableMetaTool)

enablePendingToolRecovery

public HarnessAgent.Builder enablePendingToolRecovery(boolean enable)

enableTaskList

public HarnessAgent.Builder enableTaskList()

enableTaskList

public HarnessAgent.Builder enableTaskList(boolean enabled)

maxRetries

public HarnessAgent.Builder maxRetries(int maxRetries)

fallbackModel

public HarnessAgent.Builder fallbackModel(io.agentscope.core.model.Model fallbackModel)

fallbackModel

public HarnessAgent.Builder fallbackModel(String modelId)

stopOnReject

public HarnessAgent.Builder stopOnReject(boolean stopOnReject)

permissionContext

public HarnessAgent.Builder permissionContext(io.agentscope.core.permission.PermissionContextState permissionContext)

agentId

public HarnessAgent.Builder agentId(String agentId)

Sets the stable identifier used as the agent's namespace key in the composite filesystem (e.g. [agents, <agentId>, users, <userId>, ...]). When unset, build() falls back to name(String) for the namespace key.

skillRepository

public HarnessAgent.Builder skillRepository(io.agentscope.core.skill.repository.AgentSkillRepository skillRepository)

Adds a marketplace / external skill repository (e.g. GitSkillRepository). Repositories compose additively with workspace skills.

skillRepositories

public HarnessAgent.Builder skillRepositories(List<io.agentscope.core.skill.repository.AgentSkillRepository> repositories)

Replaces the current marketplace repository list with the given collection.

projectGlobalSkillsDir

public HarnessAgent.Builder projectGlobalSkillsDir(Path projectGlobalSkillsDir)

Configures a project-global skills directory layered below marketplace and workspace skills (lowest precedence).

workspace

public HarnessAgent.Builder workspace(Path workspace)

Sets the workspace directory. Pass null to use the default ${cwd}/.agentscope/workspace.

workspace

public HarnessAgent.Builder workspace(String path)

Sets the workspace directory from a filesystem path string.

environmentMemory

public HarnessAgent.Builder environmentMemory(String environmentMemory)

abstractFilesystem

public HarnessAgent.Builder abstractFilesystem(AbstractFilesystem store)

Escape hatch: sets a custom AbstractFilesystem implementation directly.

filesystem

public HarnessAgent.Builder filesystem(SandboxFilesystemSpec spec)

Configures Mode 2 — sandbox filesystem.

filesystem

public HarnessAgent.Builder filesystem(RemoteFilesystemSpec spec)

Configures Mode 1 — composite (non-sandbox) filesystem.

filesystem

public HarnessAgent.Builder filesystem(LocalFilesystemSpec spec)

Configures Mode 3 — local filesystem with shell.

compaction

public HarnessAgent.Builder compaction(CompactionConfig config)

Overrides the default CompactionMiddleware configuration. Compaction is enabled by default with CompactionConfig.builder().build() defaults (dynamic trigger based on model context window, dynamic tail preservation). Use disableCompaction() to turn it off entirely.

disableCompaction

public HarnessAgent.Builder disableCompaction()

Disables the CompactionMiddleware entirely.

memory

public HarnessAgent.Builder memory(MemoryConfig config)

Overrides the long-term memory pipeline configuration (flush + consolidation + maintenance). When not called, MemoryConfig.defaults() is used and behaviour matches the harness's historical defaults.

For the compaction (in-context summarization) pipeline, see compaction(CompactionConfig).

toolResultEviction

public HarnessAgent.Builder toolResultEviction(ToolResultEvictionConfig config)

Overrides the default ToolResultEvictionMiddleware configuration. Tool result eviction is enabled by default with ToolResultEvictionConfig.defaults() (trigger at 80k chars). Use disableToolResultEviction() to turn it off entirely.

disableToolResultEviction

public HarnessAgent.Builder disableToolResultEviction()

Disables the ToolResultEvictionMiddleware entirely.

toolsConfig

public HarnessAgent.Builder toolsConfig(ToolsConfig toolsConfig)

Programmatic override for workspace/tools.json.

subagent

public HarnessAgent.Builder subagent(SubagentDeclaration declaration)

Adds a subagent declaration.

subagents

public HarnessAgent.Builder subagents(List<SubagentDeclaration> declarations)

subagentFactory

public HarnessAgent.Builder subagentFactory(String name,
 Function<String,io.agentscope.core.agent.Agent> factory)

Adds a fully custom subagent factory for a given agent id.

taskRepository

public HarnessAgent.Builder taskRepository(TaskRepository taskRepository)

Sets a custom TaskRepository for background subagent execution.

messageBus

public HarnessAgent.Builder messageBus(MessageBus messageBus)

Sets the MessageBus for inbox-based message delivery. When set, an InboxMiddleware is automatically registered to drain the session's inbox before each reasoning step.

asyncToolTimeout

public HarnessAgent.Builder asyncToolTimeout(Duration timeout)

Enables AsyncToolMiddleware with the given timeout. Requires messageBus(io.agentscope.harness.agent.bus.MessageBus) to be set. Tool executions that exceed the timeout are offloaded to the background; results are delivered via the inbox.

asyncToolRegistry

public HarnessAgent.Builder asyncToolRegistry(AsyncToolRegistry registry)

Sets the AsyncToolRegistry for tracking async tool executions. Enables stale async tool detection and cleanup in InboxMiddleware. When not set, async tool lifecycle tracking is skipped.

externalSubagentTool

public HarnessAgent.Builder externalSubagentTool(Object tool)

Injects an external subagent tool (typically SessionsTool).

modelResolver

public HarnessAgent.Builder modelResolver(Function<String,io.agentscope.core.model.Model> resolver)

Sets a resolver for model name strings to Model instances for subagents.

additionalContextFile

public HarnessAgent.Builder additionalContextFile(String relativePath)

Adds a custom context file (relative to workspace) loaded into the system prompt alongside AGENTS.md, MEMORY.md, and KNOWLEDGE.md.

maxContextTokens

public HarnessAgent.Builder maxContextTokens(int maxTokens)

Sets the maximum token budget for workspace context.

useLegacyXmlWorkspaceContext

public HarnessAgent.Builder useLegacyXmlWorkspaceContext(boolean enabled)

Switches workspace context rendering between markdown (default) and legacy XML style.

enableAgentTracingLog

public HarnessAgent.Builder enableAgentTracingLog(boolean enabled)

Enables or disables agent execution trace logging via AgentTraceMiddleware. Default is true.

disableFilesystemTools

public HarnessAgent.Builder disableFilesystemTools()

Skips registration of FilesystemTool.

disableShellTool

public HarnessAgent.Builder disableShellTool()

Skips registration of ShellExecuteTool.

disableDynamicSkills

public HarnessAgent.Builder disableDynamicSkills()

Disables dynamic per-call skill loading from the workspace filesystem.

disableDefaultWorkspaceSkills

public HarnessAgent.Builder disableDefaultWorkspaceSkills()

Skips registration of the default Layer-4 WorkspaceSkillRepository. User-supplied repositories and the workspace skills directory (Layer 3) are still composed; only the namespaced AbstractFilesystem-backed source is omitted.

enableSkillManageTool

public HarnessAgent.Builder enableSkillManageTool(SkillManageConfig config)

Enables the agent-callable skill_manage tool so the agent can create / edit / patch / archive its own skills in the workspace, and upgrades the workspace skill repository to a writable variant.

enableSkillManageTool

public HarnessAgent.Builder enableSkillManageTool(boolean autoPromote)

Shorthand for enableSkillManageTool(SkillManageConfig) with default config.

enableSkillPromotionGate

public HarnessAgent.Builder enableSkillPromotionGate(SkillPromotionGate gate,
 SkillVisibilityFilter visibilityFilter)

Configures the runtime promotion gate + visibility filter chain.

environment

public HarnessAgent.Builder environment(String env)

Sets the deployment environment label used by EnvironmentFilter.

enableSkillCurator

public HarnessAgent.Builder enableSkillCurator(SkillCuratorConfig config)

Enables the background skill curator. Requires enableSkillManageTool(io.agentscope.harness.agent.tool.SkillManageConfig).

enablePlanMode

public HarnessAgent.Builder enablePlanMode()

Enables plan mode (read-only design phase) with plan_enter/plan_write/ plan_exit tools and a PlanModeMiddleware that enforces read-only tools while plan mode is active.

enablePlanMode

public HarnessAgent.Builder enablePlanMode(boolean enabled)

planFileDirectory

public HarnessAgent.Builder planFileDirectory(String dir)

allowShellInPlanMode

public HarnessAgent.Builder allowShellInPlanMode()

Allows the shell tool (execute) to run while plan mode is active. By default plan mode is strictly read-only and the shell is denied (it is dual-use and cannot be classified as read-only by name). Opt in when shell-based investigation (e.g. cat/grep/git log) is needed to produce a realistic plan; the plan banner instructs the model to keep shell usage read-only. Writes still flow through the (denied) file-editing tools. Prefer pairing this with a sandboxed filesystem.

allowShellInPlanMode

public HarnessAgent.Builder allowShellInPlanMode(boolean allowed)

skillFilter

public HarnessAgent.Builder skillFilter(io.agentscope.core.skill.SkillFilter filter)

skillsEnabled

public HarnessAgent.Builder skillsEnabled(boolean enabled)

enableSkills

public HarnessAgent.Builder enableSkills(String... skillNames)

disableSkills

public HarnessAgent.Builder disableSkills(String... skillNames)

disableDynamicSubagents

public HarnessAgent.Builder disableDynamicSubagents()

disableMemoryTools

public HarnessAgent.Builder disableMemoryTools()

disableMemoryHooks

public HarnessAgent.Builder disableMemoryHooks()

disableSessionPersistence

public HarnessAgent.Builder disableSessionPersistence()

No-op since 2.0; session persistence is owned by ReActAgent itself.

disableWorkspaceContext

public HarnessAgent.Builder disableWorkspaceContext()

disableAtPathExpansion

public HarnessAgent.Builder disableAtPathExpansion()

disableSubagents

public HarnessAgent.Builder disableSubagents()

disableToolsConfig

public HarnessAgent.Builder disableToolsConfig()

buildSubagentEntries

public List<SubagentEntry> buildSubagentEntries(Path resolvedWorkspace)

Builds the subagent entries (general-purpose + declared + custom factories) without constructing the full agent. Useful for callers that need to extract subagent factories up front (for example to mount them on a session router).

buildSubagentEntries

public List<SubagentEntry> buildSubagentEntries(Path resolvedWorkspace,
 SandboxBackedFilesystem sandboxFs)

build

public HarnessAgent build()