Target Codex App connector has invalid _multicategorysearchitems tool schema
What version of Codex is running?
Unknown from app session; local CLI reports:
codex --version
I can provide the exact output if needed.
What issue are you seeing?
Codex remote compact/task calls repeatedly fail before any model work can happen because the Target app connector tool schema is invalid for the OpenAI tool/function schema validator.
The error shown in-session is:
{
"error": {
"message": "Invalid schema for function '_multicategorysearchitems': schema must have type 'object' and not have 'oneOf'/'anyOf'/'allOf'/'enum'/'const'/'not' at the top level.",
"type": "invalid_request_error",
"param": "tools[9].tools[4].parameters",
"code": "invalid_function_parameters"
}
}
It also appears as:
Error running remote compact task: Invalid schema for function '_multicategorysearchitems'
This happens even when the user is working in an unrelated repository and the Target connector is not being invoked. The failure appears to happen during tool registration/schema validation for the request, so it can break unrelated Codex operations such as remote compaction.
Evidence from local Codex cache
The problematic tool is coming from the Codex Apps/Connectors layer, not from the user's repository and not from their manually configured MCP server.
Local cache file:
/home/gwillen/.codex/cache/codex_apps_tools/7723cfc08b763455e428a2ecf4421141ad49262c.json
Relevant fields in that cache:
{
"server_name": "codex_apps",
"tool_name": "_multicategorysearchitems",
"tool_namespace": "codex_apps__target",
"tool": {
"name": "target_multicategorysearchitems",
"title": "multiCategorySearchItems"
}
}
The in-session tool name exposed to the model is:
mcp__codex_apps__target._multicategorysearchitems
Steps to reproduce
- Have the Target Codex App/Connector available in a Codex session.
- Trigger a remote compact task or another request path that includes all available tools in the request schema.
- The request fails with
invalid_function_parametersfor_multicategorysearchitemsbefore any tool is called.
Expected behavior
A broken app connector tool schema should not break unrelated Codex sessions or remote compaction.
Possible fixes:
- Fix the Target connector's
_multicategorysearchitemsgenerated parameters schema so the top-level schema is a plain JSON Schema object acceptable to the OpenAI API. - Or have Codex filter/disable invalid app connector tools before submitting a model request, so one bad app schema cannot break unrelated coding sessions.
- Or provide a user-visible way to disable a single Codex App/Connector tool from the session when its schema is bad.
Additional notes
The user reports this is recurring and disruptive. It is unrelated to their active codebase; disabling/removing the Target connector appears to be the likely workaround.
This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗