Module tool_policy 

Tool policy management system

This module manages user preferences for tool usage, storing choices in the canonical user config directory’s tool-policy.json to minimize repeated prompts while maintaining user control overwhich tools the agent can use.

Structs

AlternativeArgsPolicy

Arguments policy in alternative format

AlternativeDefaultPolicy

Default policy in alternative format

AlternativeToolPolicy

Tool policy in alternative format

AlternativeToolPolicyConfig

Alternative tool policy configuration format (user’s format)

ApprovalCacheConfig

Persisted approval cache stored alongside tool policies

McpPolicyStore

Stored MCP policy state, persisted alongside standard tool policies

McpProviderPolicy

MCP provider policy entry containing per-tool permissions

ToolConstraints

Scoped, optional constraints for a tool to align with safe defaults

ToolPolicyConfig

Tool policy configuration stored in the canonical user config directory.

ToolPolicyManager

Tool policy manager

Enums

ToolExecutionDecision

Decision result for tool execution

ToolPolicy

Tool execution policy

Constants

APPROVAL_CACHE_MAX_ENTRIES

Maximum remembered approval entries per cache collection. Unbounded growth turned tool-policy.json into a multi-hundred-kilobyte file after a few long sessions (see session-vtcode-20260925T234343Z: 294 KB). Oldest insertions are dropped first so recent approvals survive.

Traits

PermissionPromptHandler

Handler for tool permission prompts