도구 구현 패턴

1// src/tools/GrepTool/GrepTool.ts — 검색 도구 구현
2 
3const inputSchema = lazySchema(() =>💡
4  z.strictObject({
5    pattern: z.string()
6      .describe('정규식 패턴 (ripgrep 문법)'),
7    path: z.string().optional()
8      .describe('검색 경로 (기본: 현재 디렉토리)'),
9    glob: z.string().optional()
10      .describe('파일 필터 글로브 (예: "*.ts", "*.{ts,tsx}")'),
11    output_mode: z.enum(['content', 'files_with_matches', 'count'])💡
12      .optional()
13      .describe('출력 모드'),
14    '-B': semanticNumber(z.number().optional())
15      .describe('매칭 전 N줄 표시'),
16    '-A': semanticNumber(z.number().optional())
17      .describe('매칭 후 N줄 표시'),
18    '-C': semanticNumber(z.number().optional())
19      .describe('매칭 전후 N줄 표시'),
20    head_limit: semanticNumber(z.number().optional())
21      .describe('결과 N개 제한 (기본: 250)'),💡
22    '-i': semanticBoolean(z.boolean().optional())
23      .describe('대소문자 무시'),
24    multiline: semanticBoolean(z.boolean().optional())
25      .describe('여러 줄 매칭'),
26  })
27)
28 
29export const GrepTool = buildTool({
30  name: GREP_TOOL_NAME,
31  searchHint: 'search file contents regex ripgrep',💡
32  inputSchema,💡
33  isConcurrencySafe: () => true,   // 읽기 전용 → 병렬 안전
34  isReadOnly: () => true,
35 
36  async checkPermissions(input, context) {
37    return checkReadPermissionForTool(resolvedPath, context)
38  },
39 
40  async call(input, context) {
41    const results = await ripGrep(/* ... */)
42    return { output: results }
43  },
44})

1// src/tools/BashTool/UI.tsx — BashTool 렌더링 프로토콜
2 
3// 1. 도구 호출 표시 (명령어 하이라이팅)
4export function renderToolUseMessage(input, options): ReactNode {
5  return <BashCommandDisplay command={input.command} timeout={input.timeout} />
6}
7 
8// 2. 도구 결과 표시 (stdout/stderr 분리)
9export function renderToolResultMessage(result, options): ReactNode {
10  return <BashOutputDisplay stdout={result.stdout} stderr={result.stderr} />
11}
12 
13// 3. 진행률 표시 (스트리밍 출력)
14export function renderToolUseProgressMessage(progress, options): ReactNode {
15  return <BashStreamingOutput lines={progress.lines} />
16}
17 
18// 4. 오류 표시
19export function renderToolUseErrorMessage(error, options): ReactNode {
20  return <BashErrorDisplay error={error} />
21}
22 
23// 5. 요약 텍스트 (컴팩트 뷰에서 사용)
24export function getToolUseSummary(input): string {
25  return truncate(input.command, TOOL_SUMMARY_MAX_LENGTH)
26}
27 
28// 6. 사용자 표시 이름
29export function userFacingName(input): string {
30  return 'Bash'
31}