Skip to content

Conversation

@dcramer
Copy link
Member

@dcramer dcramer commented Oct 29, 2025

Add opt-in docs permission (default-checked) to control access to search_docs and get_doc tools. Follows the same pattern as the seer virtual permission for consistency.

Also optimized search_docs description, reducing token cost from 1036 to 914 tokens (11.8% reduction). Overall tool definitions now use 8,947 tokens, down from 9,069 tokens.

Changes:

  • Add docs scope to permissions.ts (Scope type, hierarchy, descriptions)
  • Update search_docs and get_doc to require docs permission
  • Add docs checkbox to OAuth approval dialog (default-checked)
  • Add docs permission mapping in OAuth callback handler
  • Optimize search_docs description for token efficiency

🤖 Generated with Claude Code

Add opt-in docs permission (default-checked) to control access to
search_docs and get_doc tools. Follows the same pattern as the seer
virtual permission for consistency.

Also optimized search_docs description, reducing token cost from 1036
to 914 tokens (11.8% reduction). Overall tool definitions now use 8,947
tokens, down from 9,069 tokens.

Changes:
- Add docs scope to permissions.ts (Scope type, hierarchy, descriptions)
- Update search_docs and get_doc to require docs permission
- Add docs checkbox to OAuth approval dialog (default-checked)
- Add docs permission mapping in OAuth callback handler
- Optimize search_docs description for token efficiency

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@dcramer
Copy link
Member Author

dcramer commented Oct 29, 2025

docs is one of the worst offenders of token cconsumption - partially because of the embedded enums which are basically required

@dcramer dcramer merged commit 551693c into main Oct 29, 2025
14 checks passed
@dcramer dcramer deleted the docs-scope branch October 29, 2025 21:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants