Summary
Claude Code maintains a tool registry with ~42 tools, each having schemas, permission levels, and categorization. Aegis has no tool awareness — it treats CC as a black box. A tool registry would enable monitoring, policy enforcement, and analytics.
CC Reference
src/tools/ — 30+ tool directories (BashTool, FileEditTool, MCPTool, AgentTool, etc.)
src/Tool.ts — Base Tool type with schema, permission context, categorization
src/services/tools/toolHooks.ts — Tool execution with permission checks
src/tools/MCPTool/ — MCP tool integration
CC Architecture
- Each tool:
{name, schema (Zod), permissionLevel, category, description}
- Tool registration: tools are registered at startup with schema validation
- Permission context: each tool has its own permission rules
- MCP tools: dynamically registered from MCP servers with schema introspection
- Tool categorization: read, write, edit, bash, search, mcp, agent, etc.
Current Aegis Gap
- Aegis has no visibility into which tools CC uses during a session
- No way to enforce tool-level policies (e.g., "allow read but deny write")
- No tool usage analytics or monitoring
- No schema validation for tool inputs/outputs
Proposed Implementation
- Parse CC tool usage from JSONL transcript (tool_use/tool_result messages)
GET /v1/sessions/:id/tools — list tools used in a session with usage counts
GET /v1/tools — list all available CC tools with schemas
- Tool usage metrics in session status
- Future: tool-level permission policies per session
Priority
P3 — observability and analytics improvement
Summary
Claude Code maintains a tool registry with ~42 tools, each having schemas, permission levels, and categorization. Aegis has no tool awareness — it treats CC as a black box. A tool registry would enable monitoring, policy enforcement, and analytics.
CC Reference
src/tools/— 30+ tool directories (BashTool, FileEditTool, MCPTool, AgentTool, etc.)src/Tool.ts— Base Tool type with schema, permission context, categorizationsrc/services/tools/toolHooks.ts— Tool execution with permission checkssrc/tools/MCPTool/— MCP tool integrationCC Architecture
{name, schema (Zod), permissionLevel, category, description}Current Aegis Gap
Proposed Implementation
GET /v1/sessions/:id/tools— list tools used in a session with usage countsGET /v1/tools— list all available CC tools with schemasPriority
P3 — observability and analytics improvement