[Bug]: Kiro drops tools loaded by tool_search when the outbound catalog exceeds its budget

[ventianima-lab]

Client or integration

Codex App

Area

Tools / MCP / web search

Summary

Kiro routes can successfully complete tool_search, but a function definition returned by that search is omitted again on the immediately following request when the complete client catalog exceeds Kiro's 48-tool or 96 KB outbound budget. The model then reports that the discovered tool is unavailable.

I expected a tool returned by tool_search_output to remain callable on the next Kiro turn. The tool_search gateway itself should also remain available when the initial catalog is oversized.

The parser already marks restored definitions with loadedFromToolSearch: true. The Kiro adapter ignored that marker and retained only the ordinary declaration prefix, so newly loaded definitions appended after the declared tools fell outside the wire budget.

A locally verified fix applies a stable priority order before the existing count and byte limits:

1. definitions marked loadedFromToolSearch
2. the toolSearch gateway
3. ordinary declarations in caller order

This keeps deterministic order inside each tier and preserves the existing fail-closed limits.

Reproduction

1. Start OpenCodex 2.31.0 and route a Codex App task to kiro/claude-opus-5.
2. Send a Responses request with more than 48 effective tools (or a converted catalog larger than 96 KB).
3. Include a prior client-executed tool_search_call and a completed tool_search_output returning a function such as codex_app__send_message_to_thread.
4. On the continuation, ask the model to invoke the returned function.
5. Observe that src/responses/parser.ts restores the definition and sets loadedFromToolSearch: true, but convertKiroToolContext sends only the ordinary prefix. The returned function is named in the Kiro omission notice and the model says it cannot call it.

Minimal effective catalog shape:

{
  "model": "kiro/claude-opus-5",
  "input": [
    {"type":"tool_search_call","call_id":"call_search","execution":"client","arguments":{"query":"send message to task"}},
    {"type":"tool_search_output","call_id":"call_search","status":"completed","execution":"client","tools":[{"type":"function","name":"codex_app__send_message_to_thread","description":"Send a message to a task","parameters":{"type":"object"}}]}
  ],
  "tools": [
    {"type":"tool_search","description":"Search deferred tools"},
    "48 or more ordinary function declarations"
  ],
  "parallel_tool_calls": false
}

After prioritizing loaded/search definitions, a regression case with 68 ordinary functions plus tool_search and one loaded function sends exactly 48 client tools, keeps the loaded function first and search gateway second, and preserves ordinary relative order. A live local Responses call with 70 effective tools returned a function_call for codex_app__send_message_to_thread.

Version

2.31.0 (source baseline commit 6ae83b1f189c353935d4977bb01227484fbdb52b)

Operating system

Microsoft Windows 11 Pro, version 10.0.26200, build 26200

Provider and model

Kiro / claude-opus-5

Logs or error output

[opencodex] Kiro's outbound catalog budget allows 48 of 70 client tools this turn. Omitted and unavailable this turn: codex_app__send_message_to_thread, ...

After the fix, the same live request completes with:

status: completed
output type: function_call
name: codex_app__send_message_to_thread

Focused Kiro adapter suite: 55 passed, 0 failed. TypeScript typecheck: passed.

Screenshots and supporting files

No screenshot is required. The reproduction is request-shape deterministic and is covered by a focused adapter regression test.

Redacted configuration

{
  "provider": "kiro",
  "adapter": "kiro",
  "authMode": "key",
  "apiKey": "[REDACTED]"
}

Checks

• I searched existing issues and documentation.
• I removed secrets, tokens, account details, request credentials, and personal data.

[github-actions]

Issue reopened

The report now contains the information required by the automated check. Thanks for updating it.

[lidge-jun]

리뷰 · 우선순위 60 / 80

설명: 이 이슈는 키로가 도구 검색으로 불러온 함수를, 바로 다음 턴에서 다시 빼 버린다고 한다. 지금 CURRENT dev HEAD 는 4f41a8e93 이다. 이번 시간에 origin/dev 는 46d4150 에서 한 커밋이 와서 여기까지 왔다. 착지는 2396 사용량 CLI 오늘 비용이다. package.json 은 2.27.0 이다. src/config.ts 는 3975줄이다. src/runtime 폴더는 지금 HEAD 에 없다. 지금 HEAD 의 src/responses/parser.ts 743줄은 검색으로 복원한 정의에 loadedFromToolSearch true 를 찍는다. src/types/tools.ts 13줄은 그 표시가 카탈로그가 꽉 찼을 때 우선하라고 적혀 있다. src/adapters/kiro-tools.ts 175줄 convertKiroToolContext 는 그 표시를 안 본다. 201줄 주석은 선언 순서를 지키고 접미사만 자르라고 한다. MAX_KIRO_TOOL_COUNT 는 48, MAX_KIRO_TOOL_CATALOG_BYTES 는 96000 이다. 그래서 검색으로 뒤에 붙은 정의가 한도 밖으로 떨어진다. 생략 알림은 168줄 omittedToolCatalogNotice 가 그 이름을 그대로 적는다. 작성자가 본 로그와 같다. 같은 표시를 src/adapters/cursor/request-builder.ts 63줄은 이미 우선한다. 키로만 안 한다. 작성자 버전은 2.31.0 이다. 지금 origin/dev 패키지는 2.27.0 이다. 175줄 변환 길은 지금 HEAD 에도 있다. PR 이 아직 없다. bug, catalog, tools 라벨이 있다. 작성자가 말한 고침은 검색으로 불러온 정의, 검색 관문, 그다음 보통 선언 순으로 줄을 세운 뒤 지금 한도를 그대로 쓴다. 사용자 길이로는 검색으로 찾은 도구를 바로 다음 턴에 못 쓰는 구멍이라서 60. 카탈로그 팁은 Ox Alpha x-preview-f-free + deepseek-v4-flash-vision-exp. Cursor 정적 카탈로그는 opus-4-8-fast / opus-5-fast. 2334 CursorCredentialRouter 는 여전히 src/providers/cursor-pool.ts 모듈+테스트만 있고 어댑터에 연결되지 않았다. 2332 H2 는 discovery 전용. 2320 overflow + 2342 는 이미 dev. 2188 사이드카는 이미 dev. 2382 데스크톱 앱 재시작은 이미 dev. 2292 는 아직 연다.

src/adapters/kiro-tools.ts 라인 175 - convertKiroToolContext 는 loadedFromToolSearch 를 안 본다
src/adapters/kiro-tools.ts 라인 201 - 지금 HEAD 는 선언 순서를 지키고 접미사만 자른다. 검색으로 뒤에 붙은 정의가 48개/96KB 밖으로 떨어진다
src/adapters/kiro-tools.ts 라인 10 - MAX_KIRO_TOOL_COUNT 는 48, MAX_KIRO_TOOL_CATALOG_BYTES 는 96000. 한도 자체는 이 이슈의 대상이 아니다
src/responses/parser.ts 라인 743 - 복원된 정의에 loadedFromToolSearch true 를 이미 찍는다
src/types/tools.ts 라인 13 - 그 표시는 카탈로그가 꽉 찼을 때 우선하라고 적혀 있다. 커서 길은 이미 쓰고 키로는 안 쓴다
이슈 본문 2.31.0 - 작성자 버전이다. 지금 origin/dev 는 2.27.0 이지만 같은 변환 구멍이 있다

메인테이너의 판단이 필요한 지점

• 작성자가 말한 세 단 우선을 작은 PR 로 받을지. 한도 숫자 48/96KB 는 그대로 둘지
• 검색 관문을 둘째 단에 고정할지. 관문까지 잘리면 다음 검색도 막힌다
• 이 구멍을 2308 키로 병렬 도구 이슈와 묶지 말지. 2308 은 parallel_tool_calls 이고 이 이슈는 카탈로그 한도이다

너의 추천
한도 숫자를 올리지 말고, 검색으로 불러온 정의와 검색 관문을 앞에 두는 작은 PR 을 받는다. 선언 상대 순서는 단 안에서 그대로 둔다. 이슈는 열어 둔다. 라벨은 그대로 둔다. 프리뷰 배포가 아니다. 2308 은 닫지 않는다.

이 댓글은 grok-bot이 작성했습니다