From f21c73be9dcb2a8763d6da1f2531751418a1606e Mon Sep 17 00:00:00 2001 From: Sayan Sisodiya Date: Tue, 26 May 2026 17:39:19 -0700 Subject: [PATCH] docs: clarify namespace limit on dynamic tool fallback --- codex-rs/app-server/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/codex-rs/app-server/README.md b/codex-rs/app-server/README.md index fc840bd252..0c3ce09b6d 100644 --- a/codex-rs/app-server/README.md +++ b/codex-rs/app-server/README.md @@ -1408,7 +1408,7 @@ Dynamic tool identifiers follow the same constraints as Responses function tools - `namespace`, when present, must match `^[a-zA-Z0-9_-]+$` and be between 1 and 64 characters. - `namespace` must not collide with reserved Responses runtime namespaces such as `functions`, `multi_tool_use`, `file_search`, `web`, `browser`, `image_gen`, `computer`, `container`, `terminal`, `python`, `python_user_visible`, `api_tool`, `tool_search`, or `submodel_delegator`. -Each dynamic tool may set `deferLoading`. When omitted, it defaults to `false`. Set it to `true` to keep the tool registered and callable by runtime features such as `code_mode`, while excluding it from the model-facing tool list sent on ordinary turns. When `tool_search` is available, deferred dynamic tools are searchable and can be exposed by a matching search result. If `tool_search` is unavailable due to model/provider restrictions, deferred dynamic tools are exposed directly. +Each dynamic tool may set `deferLoading`. When omitted, it defaults to `false`. Set it to `true` to keep the tool registered and callable by runtime features such as `code_mode`, while excluding it from the model-facing tool list sent on ordinary turns. When `tool_search` is available, deferred dynamic tools are searchable and can be exposed by a matching search result. If `tool_search` is unavailable due to model/provider restrictions, deferred dynamic tools are exposed directly; normal provider namespace support still applies. When a dynamic tool is invoked during a turn, the server sends an `item/tool/call` JSON-RPC request to the client: