Add fetch_copilot_bridge_documentation tool for agent self-knowledge

[ChrisRomp]

Summary

Agents running on copilot-bridge have no programmatic way to learn about bridge capabilities, slash commands, configuration options, or current system state. The CLI solves this with fetch_copilot_cli_ we need an equivalent.documentation

Motivation

• Agents on other deployments rely on AGENTS.md templates which may be outdated, overridden, or absent
• Users ask agents about bridge features and they have no way to look it up
• Admin vs non-admin agents need different guidance (config editing vs "ask your admin")

Proposed Solution

Register a fetch_copilot_bridge_documentation custom tool available to all agents. Topic-based to keep context lean:

• overview, commands, config, mcp, permissions, workspaces, hooks, skills, inter-agent, scheduling, troubleshooting, status
• Static content bundled in source (no RAG), status and commands are dynamic
• Role-aware: admin agents get config edit instructions, non-admin agents get "ask your admin"
• Each topic includes source code pointers for deeper investigation
• Auto-approved (added to BRIDGE_CUSTOM_TOOLS)

Files

• New: src/core/bridge-docs.ts, src/core/bridge-docs.test.ts
• Modified: src/core/session-manager.ts, templates/admin/AGENTS.md, templates/agents/AGENTS.md

Reported By

Agent (automated)