Target Codex App connector has invalid _multicategorysearchitems tool schema

Resolved 💬 5 comments Opened Jun 11, 2026 by gabewillen Closed Jun 12, 2026

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

  1. Have the Target Codex App/Connector available in a Codex session.
  2. Trigger a remote compact task or another request path that includes all available tools in the request schema.
  3. The request fails with invalid_function_parameters for _multicategorysearchitems before 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 _multicategorysearchitems generated 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.

View original on GitHub ↗

This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗