Architecture

Tool system

Tool contracts, registration, validation, execution, and result plumbing.

240
Matched files
8
Top dirs
63,376
Lines in slice
799
Exports found
Heuristic
Classification style

Beginner explanation

This architecture page groups files that seem to solve the same type of problem. It is a good way to understand the repo as a system rather than as a list of folders.

Beginner mental model

Read the first few high-importance files here, then follow their related-file links.

Expert explanation

This slice is assembled with path heuristics, which makes it strong for navigation and code reading but not a replacement for runtime tracing. Use it to discover likely boundaries, then validate by reading imports, exports, and orchestrator files.

Related files

FileLinesImportanceExports
tools/BashTool/bashPermissions.ts2622highMAX_SUBCOMMANDS_FOR_SECURITY_CHECK, MAX_SUGGESTED_RULES_FOR_COMPOUND, getSimpleCommandPrefix, getFirstWordPrefix
tools/BashTool/bashSecurity.ts2593highstripSafeHeredocSubstitutions, hasSafeHeredocSubstitution, bashCommandIsSafe_DEPRECATED, bashCommandIsSafeAsync_DEPRECATED
tools/PowerShellTool/pathValidation.ts2050highisDangerousRemovalRawPath, dangerousRemovalDeny, checkPathConstraints
tools/BashTool/readOnlyValidation.ts1991highisCommandSafeViaFlagParsing, checkReadOnlyConstraints
tools/PowerShellTool/readOnlyValidation.ts1824highargLeaksValue, CMDLET_ALLOWLIST, resolveToCanonical, isCwdChangingCmdlet
services/tools/toolExecution.ts1746highHOOK_TIMING_DISPLAY_THRESHOLD_MS, classifyToolError, MessageUpdateLazy, McpServerType
tools/PowerShellTool/powershellPermissions.ts1649highpowershellPermissionRule, powershellToolCheckExactMatchPermission, powershellToolCheckPermission, powershellToolHasPermission
tools/AgentTool/AgentTool.tsx1398highinputSchema, outputSchema, RemoteLaunchedOutput, Progress
tools/BashTool/pathValidation.ts1304highPathCommand, PATH_EXTRACTORS, COMMAND_OPERATION_TYPE, createPathChecker
tools/FileReadTool/FileReadTool.ts1184highregisterFileReadListener, MaxFileReadTokenExceededError, Input, Output
tools/BashTool/BashTool.tsx1144highisSearchOrReadBashCommand, BashToolInput, Out, detectBlockedSleepPattern
tools/SkillTool/SkillTool.ts1109highinputSchema, outputSchema, Output, SkillTool
tools/shared/spawnMultiAgent.ts1094highresolveTeammateModel, SpawnOutput, SpawnTeammateConfig, generateUniqueTeammateName
tools/PowerShellTool/powershellSecurity.ts1091highpowershellCommandIsSafe
utils/toolResultStorage.ts1041highTOOL_RESULTS_SUBDIR, PERSISTED_OUTPUT_TAG, PERSISTED_OUTPUT_CLOSING_TAG, TOOL_RESULT_CLEARED_MESSAGE
tools/PowerShellTool/PowerShellTool.tsx1001highdetectBlockedSleepPattern, PowerShellToolInput, Out, PowerShellTool
tools/AgentTool/runAgent.ts974highfilterIncompleteToolCalls
tools/SendMessageTool/SendMessageTool.ts918highInput, MessageRouting, MessageOutput, BroadcastOutput
tools/AgentTool/UI.tsx872highAgentPromptDisplay, AgentResponseDisplay, renderToolResultMessage, renderToolUseMessage
tools/LSPTool/LSPTool.ts861highOutput, Input, LSPTool
Tool.ts793highToolInputJSONSchema, QueryChainTracking, ValidationResult, SetToolJSXFn
tools/FileEditTool/utils.ts776highLEFT_SINGLE_CURLY_QUOTE, RIGHT_SINGLE_CURLY_QUOTE, LEFT_DOUBLE_CURLY_QUOTE, RIGHT_DOUBLE_CURLY_QUOTE
utils/toolSearch.ts757highgetAutoToolSearchCharThreshold, ToolSearchMode, getToolSearchMode, modelSupportsToolReference
tools/AgentTool/loadAgentsDir.ts756highAgentMcpServerSpec, BaseAgentDefinition, BuiltInAgentDefinition, CustomAgentDefinition
tools/AgentTool/agentToolUtils.ts687highResolvedAgentTools, filterToolsForAgent, resolveAgentTools, agentToolResultSchema
tools/BashTool/sedValidation.ts685highisLinePrintingCommand, isPrintCommand, sedCommandIsAllowedByAllowlist, hasFileArgs
services/tools/toolHooks.ts651highPostToolUseHooksResult, resolveHookPermissionDecision
tools/FileEditTool/FileEditTool.ts626highFileEditTool
tools/MCPTool/classifyForCollapse.ts605highclassifyMcpToolForCollapse
tools/LSPTool/formatters.ts593highformatGoToDefinitionResult, formatFindReferencesResult, formatHoverResult, formatDocumentSymbolResult
tools/TaskOutputTool/TaskOutputTool.tsx584highTaskOutputTool
tools/GrepTool/GrepTool.ts578highGrepTool
components/agents/ToolSelector.tsx562highToolSelector
hooks/toolPermission/handlers/interactiveHandler.ts537highhandleInteractivePermission
services/tools/StreamingToolExecutor.ts531highStreamingToolExecutor
tools/WebFetchTool/utils.ts531highclearWebFetchCache, MAX_MARKDOWN_LENGTH, isPreapprovedUrl, validateURL
tools/ExitPlanModeTool/ExitPlanModeV2Tool.ts494highAllowedPrompt, _sdkInputSchema, outputSchema, Output
tools/NotebookEditTool/NotebookEditTool.ts491highinputSchema, outputSchema, Output, NotebookEditTool
tools/ToolSearchTool/ToolSearchTool.ts472highinputSchema, outputSchema, Output, clearToolSearchDescriptionCache
tools/ConfigTool/ConfigTool.ts468highInput, Output, ConfigTool
tools/FileWriteTool/FileWriteTool.ts435highOutput, FileWriteToolInput, FileWriteTool
tools/TaskUpdateTool/TaskUpdateTool.ts407highOutput, TaskUpdateTool
tools/FileWriteTool/UI.tsx405highcountLines, userFacingName, isResultTruncated, getToolUseSummary
tools/PowerShellTool/modeValidation.ts405highisSymlinkCreatingCommand, checkPermissionMode
tools/MCPTool/UI.tsx403highrenderToolUseMessage, renderToolUseProgressMessage, renderToolResultMessage, tryFlattenJson
tools.ts390highTOOL_PRESETS, ToolPreset, parseToolPreset, getToolsForDefaultPreset
hooks/toolPermission/PermissionContext.ts389highcreatePermissionContext, createPermissionQueueOps, createResolveOnce
tools/WebSearchTool/WebSearchTool.ts383highSearchResult, Output, WebSearchTool
tools/BashTool/prompt.ts370highgetDefaultTimeoutMs, getMaxTimeoutMs, getSimplePrompt
components/messages/AssistantToolUseMessage.tsx368highAssistantToolUseMessage
tools/ExitWorktreeTool/ExitWorktreeTool.ts330highOutput, ExitWorktreeTool
tools/BashTool/sedEditParser.ts323highSedEditInfo, isSedInPlaceEdit, parseSedEditCommand, applySedSubstitution
tools/WebFetchTool/WebFetchTool.ts319highOutput, WebFetchTool
tools/FileEditTool/UI.tsx289highuserFacingName, getToolUseSummary, renderToolUseMessage, renderToolResultMessage
tools/AgentTool/prompt.ts288highformatAgentLine, shouldInjectAgentListInMessages, getPrompt
tools/shared/gitOperationTracking.ts278highCommitKind, BranchAction, PrAction, parseGitCommitId
tools/AgentTool/resumeAgent.ts266highResumeAgentResult, resumeAgentBackground
tools/AskUserQuestionTool/AskUserQuestionTool.tsx266high_sdkInputSchema, _sdkOutputSchema, Question, QuestionOption
tools/BashTool/bashCommandHelpers.ts266highCommandIdentityCheckers, checkCommandOperatorPermissions
tools/SkillTool/prompt.ts242highSKILL_BUDGET_CONTEXT_PERCENT, CHARS_PER_TOKEN, DEFAULT_CHAR_BUDGET, MAX_LISTING_DESC_CHARS
hooks/toolPermission/permissionLogging.ts239highisCodeEditingTool, buildCodeEditToolAttributes, logPermissionDecision
components/permissions/NotebookEditPermissionRequest/NotebookEditToolDiff.tsx235highNotebookEditToolDiff
tools/BashTool/utils.ts224highstripEmptyLines, isImageOutput, parseDataUri, buildImageToolResult
tools/McpAuthTool/McpAuthTool.ts216highMcpAuthOutput, createMcpAuthTool
components/mcp/MCPToolDetailView.tsx212highMCPToolDetailView
tools/ConfigTool/supportedSettings.ts212highSUPPORTED_SETTINGS, isSupported, getConfig, getAllKeys
tools/PowerShellTool/clmTypes.ts212highCLM_ALLOWED_TYPES, normalizeTypeName, isClmAllowedType
tools/AgentTool/forkSubagent.ts211highisForkSubagentEnabled, FORK_SUBAGENT_TYPE, FORK_AGENT, isInForkChild
tools/AgentTool/built-in/claudeCodeGuideAgent.ts206highCLAUDE_CODE_GUIDE_AGENT_TYPE, CLAUDE_CODE_GUIDE_AGENT
tools/GrepTool/UI.tsx201highrenderToolUseMessage, renderToolUseErrorMessage, renderToolResultMessage, getToolUseSummary
tools/GlobTool/GlobTool.ts199highOutput, GlobTool
tools/AgentTool/agentMemorySnapshot.ts198highgetSnapshotDirForAgent, checkAgentMemorySnapshot, initializeFromSnapshot, replaceFromSnapshot
services/tools/toolOrchestration.ts189highMessageUpdate
tools/BashTool/UI.tsx185highBackgroundHint, renderToolUseMessage, renderToolUseProgressMessage, renderToolUseQueuedMessage
tools/FileReadTool/UI.tsx185highrenderToolUseMessage, renderToolUseTag, renderToolResultMessage, renderToolUseErrorMessage
components/FileEditToolDiff.tsx181highFileEditToolDiff
tools/AgentTool/agentMemory.ts178highAgentMemoryScope, getAgentMemoryDir, isAgentMemoryPath, getAgentMemoryEntrypoint
tools/PowerShellTool/gitSafety.ts177highisGitInternalPathPS, isDotGitPathPS
tools/EnterPlanModeTool/prompt.ts171highgetEnterPlanModeToolPrompt
components/FileEditToolUseRejectedMessage.tsx170highFileEditToolUseRejectedMessage
tools/SyntheticOutputTool/SyntheticOutputTool.ts164highOutput, SYNTHETIC_OUTPUT_TOOL_NAME, isSyntheticOutputToolEnabled, SyntheticOutputTool
tools/RemoteTriggerTool/RemoteTriggerTool.ts162highInput, Output, RemoteTriggerTool
hooks/toolPermission/handlers/swarmWorkerHandler.ts160highhandleSwarmWorkerPermission
tools/ReadMcpResourceTool/ReadMcpResourceTool.ts159highinputSchema, outputSchema, Output, ReadMcpResourceTool
tools/BashTool/shouldUseSandbox.ts154highshouldUseSandbox
tools/AgentTool/built-in/verificationAgent.ts153highVERIFICATION_AGENT
components/permissions/BashPermissionRequest/bashToolUseOptions.tsx147highBashToolUseOption, bashToolUseOptions
tools/PowerShellTool/prompt.ts146highgetDefaultTimeoutMs, getMaxTimeoutMs, getPrompt
tools/AgentTool/built-in/statuslineSetup.ts145highSTATUSLINE_SETUP_AGENT
tools/PowerShellTool/commandSemantics.ts143highCommandSemantic, interpretCommandResult
components/mcp/MCPToolListView.tsx141highMCPToolListView
tools/BashTool/commandSemantics.ts141highCommandSemantic, interpretCommandResult
tools/TaskCreateTool/TaskCreateTool.ts139highOutput, TaskCreateTool
tools/ScheduleCronTool/prompt.ts136highDEFAULT_MAX_AGE_DAYS, isKairosCronEnabled, isDurableCronEnabled, CRON_CREATE_TOOL_NAME
tools/TaskStopTool/TaskStopTool.ts132highOutput, TaskStopTool
tools/PowerShellTool/UI.tsx131highrenderToolUseMessage, renderToolUseProgressMessage, renderToolUseQueuedMessage, renderToolResultMessage
tools/TaskGetTool/TaskGetTool.ts129highOutput, TaskGetTool
tools/SkillTool/UI.tsx128highrenderToolResultMessage, renderToolUseMessage, renderToolUseProgressMessage, renderToolUseRejectedMessage
utils/permissions/PermissionPromptToolResultSchema.ts128highinputSchema, Input, outputSchema, Output
tools/EnterPlanModeTool/EnterPlanModeTool.ts127highOutput, EnterPlanModeTool
components/FileEditToolUpdatedMessage.tsx124highFileEditToolUpdatedMessage
tools/ListMcpResourcesTool/ListMcpResourcesTool.ts124highOutput, ListMcpResourcesTool
tools/TaskListTool/TaskListTool.ts117highOutput, TaskListTool
components/FallbackToolUseErrorMessage.tsx116highFallbackToolUseErrorMessage
tools/BashTool/modeValidation.ts116highcheckPermissionMode, getAutoAllowedCommands
constants/tools.ts113highALL_AGENT_DISALLOWED_TOOLS, CUSTOM_AGENT_DISALLOWED_TOOLS, ASYNC_AGENT_ALLOWED_TOOLS, IN_PROCESS_TEAMMATE_ALLOWED_TOOLS
services/toolUseSummary/toolUseSummaryGenerator.ts113highGenerateToolUseSummaryParams, generateToolUseSummary
tools/PowerShellTool/destructiveCommandWarning.ts110highgetDestructiveCommandWarning
components/messages/UserToolResultMessage/UserToolResultMessage.tsx106highUserToolResultMessage
tools/AgentTool/agentDisplay.ts105highAgentSourceGroup, AGENT_SOURCE_GROUPS, ResolvedAgent, resolveAgentOverrides
components/messages/UserToolResultMessage/UserToolSuccessMessage.tsx104highUserToolSuccessMessage
utils/settings/toolValidationConfig.ts104highToolValidationConfig, TOOL_VALIDATION_CONFIG, isFilePatternTool, isBashPrefixTool
components/messages/UserToolResultMessage/UserToolErrorMessage.tsx103highUserToolErrorMessage
tools/BashTool/destructiveCommandWarning.ts103highgetDestructiveCommandWarning
components/messages/UserToolResultMessage/UserToolRejectMessage.tsx95highUserToolRejectMessage
tools/FileReadTool/imageProcessor.ts95highSharpInstance, SharpFunction, getImageProcessor, getImageCreator
tools/AgentTool/built-in/planAgent.ts93highPLAN_AGENT
tools/FileReadTool/limits.ts93highDEFAULT_MAX_OUTPUT_TOKENS, FileReadingLimits, getDefaultFileReadingLimits
tools/NotebookEditTool/UI.tsx93highgetToolUseSummary, renderToolUseMessage, renderToolUseRejectedMessage, renderToolUseErrorMessage
components/NotebookEditToolUseRejectedMessage.tsx92highNotebookEditToolUseRejectedMessage
components/permissions/PowerShellPermissionRequest/powershellToolUseOptions.tsx91highPowerShellToolUseOption, powershellToolUseOptions
tools/LSPTool/symbolContext.ts91highgetSymbolAtPosition
components/permissions/FileWritePermissionRequest/FileWriteToolDiff.tsx89highFileWriteToolDiff
tools/FileEditTool/types.ts86highFileEditInput, EditInput, FileEdit, hunkSchema
tools/AgentTool/built-in/exploreAgent.ts84highEXPLORE_AGENT_MIN_QUERIES, EXPLORE_AGENT
tools/ExitPlanModeTool/UI.tsx82highrenderToolUseMessage, renderToolResultMessage, renderToolUseRejectedMessage
tools/MCPTool/MCPTool.ts78highinputSchema, outputSchema, Output, MCPTool
tools/testing/TestingPermissionTool.tsx74highTestingPermissionTool
tools/AgentTool/builtInAgents.ts73highareExplorePlanAgentsEnabled, getBuiltInAgents
tools/AgentTool/agentColorManager.ts67highAgentColorName, AGENT_COLORS, AGENT_COLOR_TO_THEME_COLOR, getAgentColor
hooks/toolPermission/handlers/coordinatorHandler.ts66highhandleCoordinatorPermission
tools/GlobTool/UI.tsx63highuserFacingName, renderToolUseMessage, renderToolUseErrorMessage, renderToolResultMessage
components/agents/new-agent-creation/wizard-steps/ToolsStep.tsx61highToolsStep
tools/ScheduleCronTool/UI.tsx60highrenderCreateToolUseMessage, renderCreateResultMessage, renderDeleteToolUseMessage, renderDeleteResultMessage
components/messages/GroupedToolUseContent.tsx58highGroupedToolUseContent
constants/toolLimits.ts57highDEFAULT_MAX_RESULT_SIZE_CHARS, MAX_TOOL_RESULT_TOKENS, BYTES_PER_TOKEN, MAX_TOOL_RESULT_BYTES
tools/FileReadTool/prompt.ts50highFILE_READ_TOOL_NAME, FILE_UNCHANGED_STUB, MAX_LINES_TO_READ, DESCRIPTION
tools/AskUserQuestionTool/prompt.ts45highASK_USER_QUESTION_TOOL_NAME, ASK_USER_QUESTION_TOOL_CHIP_WIDTH, DESCRIPTION, PREVIEW_FEATURE_PROMPT
components/messages/UserToolResultMessage/utils.tsx44highuseGetToolFromMessages
components/ToolUseLoader.tsx42highToolUseLoader
tools/ReadMcpResourceTool/UI.tsx37highrenderToolUseMessage, userFacingName, renderToolResultMessage
tools/AgentTool/built-in/generalPurposeAgent.ts35highGENERAL_PURPOSE_AGENT
components/tasks/renderToolActivity.tsx33highrenderToolActivity
tools/EnterPlanModeTool/UI.tsx33highrenderToolUseMessage, renderToolResultMessage, renderToolUseRejectedMessage
components/messages/UserToolResultMessage/RejectedPlanMessage.tsx31highRejectedPlanMessage
tools/PowerShellTool/commonParameters.ts31highCOMMON_SWITCHES, COMMON_VALUE_PARAMS, COMMON_PARAMETERS
tools/ExitPlanModeTool/prompt.ts30highEXIT_PLAN_MODE_V2_TOOL_PROMPT
tools/FileEditTool/prompt.ts29highgetEditToolDescription
tools/ListMcpResourcesTool/UI.tsx29highrenderToolUseMessage, renderToolResultMessage
tools/BriefTool/prompt.ts23highBRIEF_TOOL_NAME, LEGACY_BRIEF_TOOL_NAME, DESCRIPTION, BRIEF_TOOL_PROMPT
utils/shell/shellToolUtils.ts23highSHELL_TOOL_NAMES, isPowerShellToolEnabled
tools/ListMcpResourcesTool/prompt.ts21highLIST_MCP_RESOURCES_TOOL_NAME, DESCRIPTION, PROMPT
tools/FileWriteTool/prompt.ts19highFILE_WRITE_TOOL_NAME, DESCRIPTION, getWriteToolDescription
tools/GrepTool/prompt.ts19highGREP_TOOL_NAME, getDescription
tools/ReadMcpResourceTool/prompt.ts17highDESCRIPTION, PROMPT
tools/RemoteTriggerTool/UI.tsx17highrenderToolUseMessage, renderToolResultMessage
components/FallbackToolUseRejectedMessage.tsx16highFallbackToolUseRejectedMessage
components/messages/UserToolResultMessage/RejectedToolUseMessage.tsx16highRejectedToolUseMessage
components/messages/UserToolResultMessage/UserToolCanceledMessage.tsx16highUserToolCanceledMessage
tools/RemoteTriggerTool/prompt.ts16highREMOTE_TRIGGER_TOOL_NAME, DESCRIPTION, PROMPT
tools/AgentTool/constants.ts13highAGENT_TOOL_NAME, LEGACY_AGENT_TOOL_NAME, VERIFICATION_AGENT_TYPE, ONE_SHOT_BUILTIN_AGENT_TYPES
tools/FileEditTool/constants.ts12highFILE_EDIT_TOOL_NAME, CLAUDE_FOLDER_PERMISSION_PATTERN, GLOBAL_CLAUDE_FOLDER_PERMISSION_PATTERN, FILE_UNEXPECTEDLY_MODIFIED_ERROR
tools/GlobTool/prompt.ts8highGLOB_TOOL_NAME, DESCRIPTION
tools/MCPTool/prompt.ts4highPROMPT, DESCRIPTION
tools/ExitPlanModeTool/constants.ts3highEXIT_PLAN_MODE_TOOL_NAME, EXIT_PLAN_MODE_V2_TOOL_NAME
tools/PowerShellTool/toolName.ts3highPOWERSHELL_TOOL_NAME
commands/debug-tool-call/index.js2high
tools/EnterPlanModeTool/constants.ts2highENTER_PLAN_MODE_TOOL_NAME
utils/claudeInChrome/toolRendering.tsx262mediumChromeToolName, renderChromeToolResultMessage, getClaudeInChromeMCPToolOverrides
tools/TeamCreateTool/TeamCreateTool.ts241mediumOutput, Input, TeamCreateTool
tools/LSPTool/UI.tsx228mediumuserFacingName, renderToolUseMessage, renderToolUseErrorMessage, renderToolResultMessage
tools/LSPTool/schemas.ts216mediumlspToolInputSchema, LSPToolInput, isValidLSPOperation
tools/BriefTool/BriefTool.ts205mediumOutput, isBriefEntitled, isBriefEnabled, BriefTool
hooks/useCanUseTool.tsx204mediumCanUseToolFn
tools/BashTool/BashToolResultMessage.tsx191mediumBashToolResultMessage
tools/TodoWriteTool/prompt.ts185mediumPROMPT, DESCRIPTION
utils/groupToolUses.ts183mediumMessageWithoutProgress, GroupingResult, applyGrouping
tools/BriefTool/upload.ts175mediumBriefUploadContext, uploadBriefAttachment
tools/WebFetchTool/preapproved.ts167mediumPREAPPROVED_HOSTS, isPreapprovedHost
tools/ScheduleCronTool/CronCreateTool.ts158mediumCreateOutput, CronCreateTool