Function getUsingYourToolsSection

src/constants/prompts.ts:271–306

(enabledTools: Set<string>)

}

function getUsingYourToolsSection(enabledTools: Set<string>): string {
  const taskToolName = [TASK_CREATE_TOOL_NAME, TODO_WRITE_TOOL_NAME].find(n =>
    enabledTools.has(n),
  )

  // Ant-native builds alias find/grep to embedded bfs/ugrep and remove the
  // dedicated Glob/Grep tools, so skip guidance pointing at them.
  const embedded = hasEmbeddedSearchTools()

  const providedToolSubitems = [
    `To read files use ${FILE_READ_TOOL_NAME} instead of cat, head, tail, or sed`,
    `To edit files use ${FILE_EDIT_TOOL_NAME} instead of sed or awk`,
    `To create files use ${FILE_WRITE_TOOL_NAME} instead of cat with heredoc or echo redirection`,
    `For scoped file or directory discovery, prefer the ${BASH_TOOL_NAME} tool with \`find\` or a targeted \`ls\` on a known directory`,
    `For scoped content search, prefer the ${BASH_TOOL_NAME} tool with \`rg\``,
    ...(embedded
      ? []
      : [
          `Use ${GLOB_TOOL_NAME} when glob patterns are the clearest fit for path discovery`,
          `Use ${GREP_TOOL_NAME} when its structured filters or output modes are the clearest fit for content search`,
        ]),
    'Avoid broad repo-root enumeration or file-counting passes when a narrower command will do',
  ]

  const items = [
    `Choose the clearest direct tool for the job. The ${BASH_TOOL_NAME} tool is the default direct path for scoped repository discovery and content search, while dedicated tools remain available when their structured interface is a better fit:`,
    providedToolSubitems,
    getRepoInspectionFirstTurnGuidance(embedded),
    taskToolName
      ? `Break down and manage your work with the ${taskToolName} tool. These tools are helpful for planning your work and helping the user track your progress. Mark each task as completed as soon as you are done with the task. Do not batch up multiple tasks before marking them as completed.`
      : null,
    `You can call multiple tools in a single response. If you intend to call multiple tools and there are no dependencies between them, make all independent tool calls in parallel. Maximize use of parallel tool calls where possible to increase efficiency. However, if some tool calls depend on previous calls to inform dependent values, do NOT call these tools in parallel and instead call them sequentially. For instance, if one operation must complete before another starts, run these operations sequentially instead.`,
  ].filter(item => item !== null)

  return [`# Using your tools`, ...prependBullets(items)].join(`\n`)
}

function getAgentToolSection(): string {
  return isForkSubagentEnabled()