plugins/_tool_access/AGENTS.md

Tool Access Plugin DOX

Purpose

• Own the always-enabled project/profile tool-policy configuration and execution gate.

Ownership

• helpers/tool_policy.py owns shared resolution and catalog behavior.
• hooks.py normalizes scoped configuration.
• extensions/python/tool_execute_before/ rejects blocked execution.

Local Contracts

• This plugin has no independent settings form; the generic plugin settings shell exposes its scoped configuration index, while Agent Editor writes sparse profile config.json files and the runtime remains authoritative.
• Custom configuration stores independent default and mcp_default fallbacks; explicit canonical IDs remain shared in allowed and blocked.
• Required final-response capability is never disabled.

Verification

• Run tests/test_tool_policy.py.

Child DOX Index

No child DOX files.