[DavidCockerill]

📝 Summary

The built-in agent's tool groups (filesystem, schedule_followup, the V8 inspector, the best-practices lookup) could not be turned off. Nothing returned the agent configuration in effect. HarperFast/harper#3993 adds the agent.tools switches and the get_agent_config operation. This documents both using the harper branch claude/3993-agent-tool-switches-9d827b (PR link to follow). Every behavior claim was checked against that branch's source and tests. Version badges are v5.4.0: the feature ships in the open 5.4 line.

🔧 Changes

• reference/configuration/options.md: tools joins the agent option list. The runtime settings description lists it among the startup-only keys. A new "Turning off tool groups" section gives the YAML, a table of what each key removes, and these behaviors: a disabled group is removed rather than gated, and its names stay reserved; the keys apply only at startup. Set them through the config file, set_configuration, HARPER_SET_CONFIG, env vars or CLI flags. set_agent_config rejects them. The httpFetch caveat about the agent re-enabling tools also applies; and a malformed value turns groups off rather than on. The agent introduction links to the section.
• reference/operations-api/operations.md: documents seven operations, two outside the agent group. The privilege warning says each group running at process privilege can now be removed at startup. Adds get_agent_config to the operation table. set_agent_config lists tools among the startup-only keys it rejects. A get_agent_config section covers the request, an example response, optional keys, and exclusion from the agent permission group and MCP.
• reference/users-and-roles/overview.md: the agent group excludes get_agent_config too. Narrows the claim about what the group withholds (session reads still show a session's model and provider).
• release-notes/v5-lincoln/5.4.md: a "Turning Off the Agent's Own Tool Groups" entry under Built-in Agent.

✅ Verification

• npm run format:check and npm run lint pass.
• Pre-push review: Codex graded leg and Gemini on round 1 (converged, four findings fixed: the group-exclusion claim, the self-re-enable caveat, an injected-tools parenthetical that named no real surface, the optional get_agent_config keys), then one delta round.
• npm run build succeeds, so every new link and anchor resolves.

Refs HarperFast/harper#3993 · Refs #674 · Feature PR: the harper PR for HarperFast/harper#3993, linked here once it opens

🤖 Generated with Claude Code

Related PRs: #788 overlaps (it re-sources these four pages from the product repos; whichever lands second carries this delta into the assembled pages), 3 others independent
Complexity: easy

_{Review-Coverage: authored=claude; ran=gemini,codex; adjudicated=domain; blocked=muse(failed); declined=cursor-grok,cursor-composer; rounds=2; full=1 @ 8befb4f}

_{Review-Attention: skim ~2m (decisions: malformed-tools-fail-closed-vs-fail-start, get-agent-config-outside-agent-group, drop-injected-tools-from-all-off-claim) @ 8befb4f}

[gemini-code-assist]

Code Review

This pull request updates the documentation to introduce a new feature allowing users to turn off specific tool groups for the built-in Harper agent at startup (using agent.tools configuration for filesystem, schedule, inspector, and bestPractices). It also documents a new get_agent_config operation that retrieves the active agent configuration, including startup-only settings, and details how these changes affect roles, permissions, and MCP access. I have no feedback to provide as there are no review comments.

[github-actions]

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-795

This preview will update automatically when you push new commits.

[DavidCockerill]

Closing: the reference docs are moving out of this repo (see #788), so the agent.tools and get_agent_config documentation for HarperFast/harper#3993 will land with the moved pages instead of here. The branch stays available for reuse.

— written by Claude Fable 5.1 on David's behalf

[github-actions]

🧹 Preview Cleanup

The preview deployment for this PR has been removed.