Skip to content

Context compaction fails with unknown parameter 'prompt_cache_retention' #17809

Closed

Description

@obahareth

What version of the Codex App are you using (From “About Codex” dialog)?

26.409.20454 (1462)

What subscription do you have?

ChatGPT Pro

What platform is your computer?

Darwin 25.2.0 arm64 arm

What issue are you seeing?

While using the Codex Mac app, automatic context compaction fails instead of compacting the thread.

The app shows this error inline in the chat UI:

Image
Error running remote compact task: { "error": { "message": "Unknown parameter: 'prompt_cache_retention'.", "type": "invalid_request_error", "param": "prompt_cache_retention", "code": "unknown_parameter" } }

This appears during the "Automatically compacting context" step. Instead of compacting the conversation, the app surfaces the raw API error.

What steps can reproduce the bug?

  1. Open the Codex macOS app.
  2. Work in a thread until the app attempts automatic context compaction.
  3. Wait for the "Automatically compacting context" message to appear.
  4. Observe that the compact task fails with:
   Error running remote compact task: { "error": { "message": "Unknown parameter: 'prompt_cache_retention'.", "type": "invalid_request_error", "param": "prompt_cache_retention", "code": "unknown_parameter" } }

What is the expected behavior?

Automatic context compaction should complete successfully and continue the conversation normally.

Additional information

Running /compact manually on the same thread from the CLI results in this:

Error running remote compact task: {
  "error": {
    "message": "Unknown parameter: 'prompt_cache_retention'.",
    "type": "invalid_request_error",
    "param": "prompt_cache_retention",
    "code": "unknown_parameter"
  }
}

Activity

  1. added
    appIssues related to the Codex desktop app
    on Apr 14, 2026
  2. added
    bugSomething isn't working
    contextIssues related to context management (including compaction)
    on Apr 14, 2026
  3. monkey-sheng commented on Apr 14, 2026

    @monkey-sheng

    Getting this too in VS Code extension, thread id: 019d8b82-66f8-7d22-a34d-40e6f025fe4e

  4. Mygod commented on Apr 14, 2026

    @Mygod

    +1 on CLI

  5. JamesticCS commented on Apr 14, 2026

    @JamesticCS

    Getting this too in CLI

  6. atonderski commented on Apr 14, 2026

    @atonderski

    getting this codex-cli 0.120.0

  7. popperwin commented on Apr 14, 2026

    @popperwin

    Same issue

  8. TigerHix commented on Apr 14, 2026

    @TigerHix

    oh my god not now codex

  9. dotdioscorea commented on Apr 14, 2026

    @dotdioscorea

    +1 on CLI across many accounts and machines

  10. maroshvarchola commented on Apr 14, 2026

    @maroshvarchola

    Probably just api is down

  11. changed the title [-]Automatic context compaction fails with unknown parameter 'prompt_cache_retention'[/-] [+]Context compaction fails with unknown parameter 'prompt_cache_retention'[/+] on Apr 14, 2026
  12. Gk0Wk commented on Apr 14, 2026

    @Gk0Wk

    +1 on cli, win11, 0.119.0

  13. valmedia commented on Apr 14, 2026

    @valmedia

    new model incoming

  14. frdmir commented on Apr 14, 2026

    @frdmir

    same issue, cannot compact context.

  15. 13 remaining items

  16. pinciottima commented on Apr 14, 2026

    @pinciottima

    +1 macOS Codex Desktop

  17. Jonomir commented on Apr 14, 2026

    @Jonomir

    Damm, now I have to start another tread and its going to take some time to gather context until its not dumb anymore

  18. MarcusNeufeldt commented on Apr 14, 2026

    @MarcusNeufeldt

    Seeing the same issue here on Windows 11 with codex-cli 0.120.0 using ChatGPT sign-in and gpt-5.4.

    It started suddenly on April 14, 2026 after previously working reliably. Automatic compaction fails with:

    Error running remote compact task: {
      "error": {
        "message": "Unknown parameter: 'prompt_cache_retention'.",
        "type": "invalid_request_error",
        "param": "prompt_cache_retention",
        "code": "unknown_parameter"
      }
    }
    

    /compact fails with the same error, so the affected thread becomes unusable once compaction kicks in.

    Thread ID from my local logs: 019d8b82-60a7-77d1-b8dc-48030b8c7772.

  19. videogorl commented on Apr 14, 2026

    @videogorl

    +1 on macOS Codex Desktop

  20. swapnil-sudhir commented on Apr 14, 2026

    @swapnil-sudhir

    +1 on macOS codex desktop -

    Error running remote compact task: { "error": { "message": "Unknown parameter: 'prompt_cache_retention'.", "type": "invalid_request_error", "param": "prompt_cache_retention", "code": "unknown_parameter" } }

  21. KFCDeveloper commented on Apr 14, 2026

    @KFCDeveloper

    +1 Error running remote compact task: { "error": { "message": "Unknown parameter: 'prompt_cache_retention'.", "type": "invalid_request_error", "param": "prompt_cache_retention", "code": "unknown_parameter" } }

  22. kmalyshev commented on Apr 14, 2026

    @kmalyshev

    +1 Error running remote compact task: stream disconnected before completion: error sending request for url (https://chatgpt.com/backend-api/codex/responses/compact)

  23. swapnil-sudhir commented on Apr 14, 2026

    @swapnil-sudhir

    Quit and Reopened the app on MacOS, and its working now, in the same thread.

  24. dotdioscorea commented on Apr 14, 2026

    @dotdioscorea

    Panic over, all working again

  25. CarlosFelipeArantes commented on Apr 14, 2026

    @CarlosFelipeArantes

    Working fine!

  26. Rafael135790 commented on Apr 14, 2026

    @Rafael135790

    Encontré una alternativa

    Eu encontré um fallback.

    Resumen

    Existe un error en Codex en la versión principal donde la compactación automática del contexto puede fallar con:

    Unknown parameter: 'prompt_cache_retention'
    

    He añadido un perfil de solución alternativa opcional para ~/.codex/config.tomlque Codex pueda intentar una ruta de compactación diferente sin modificar la configuración predeterminada.

    Esto no modifica el código de tu proyecto. Esto no redirige el tráfico a un proveedor externo. Esto solo afecta a Codex cuando utilizas explícitamente el perfil de solución alternativa.

    ¿Qué cambió?

    Agregué este bloque a ~/.codex/config.toml:

    [profiles.inline_compact_workaround]
    model_provider = "openai_inline"

    [model_providers.openai_inline]
    name = "OpenAI Inline"
    requires_openai_auth = true
    supports_websockets = true
    Ubicación actual en el archivo:

    • ~/.codex/config.toml:40
    • ~/.codex/config.toml:43

    Lo que esto significa

    Antes de este cambio:

    • openaiSu configuración normal de Codex utilizaba el proveedor integrado.

    Después de este cambio:

    • Tu configuración normal del Códice sigue sin cambios.
    • Ahora hay un perfil adicional llamadoinline_compact_workaround
    • ese perfil utiliza una entrada de proveedor personalizada llamadaopenai_inline

    Importante:

    • Si ejecutas Codex normalmente, no cambia nada.
    • Esta solución alternativa solo se utiliza si inicias Codex con el perfil dedicado.

    Cómo usarlo

    Para reanudar el hilo afectado con la solución alternativa:

    codex -p inline_compact_workaround resume 019d8c16-d49f-72a1-b7f9-bd7ad5410a5f
    Para iniciar una nueva sesión con la solución alternativa:

    codex -p inline_compact_workaround

    Por qué esta alternativa puede ser útil

    Hechos confirmados

    • A partir del 14 de abril de 2026 , su versión local de CLI es codex-cli 0.120.0.
    • A fecha de 11 de abril de 2026 , 0.120.0esta es la última versión publicada del Codex.
    • A fecha de 14 de abril de 2026 , existe un problema abierto en el Codex 2026 relacionado con el mismo fallo:
      Context compaction fails with unknown parameter 'prompt_cache_retention'
    • El asunto es público aquí:
      https://github.com/openai/codex/issues/17809

    Hechos confirmados a partir de la configuración de la solución alternativa.

    • No lo configurébase_url
    • No lo configuréenv_key
    • No lo configuréhttp_headers
    • No lo configuréquery_params
    • Yo establecírequires_openai_auth = true

    Eso significa que este proveedor sigue utilizando el flujo de autenticación normal de OpenAI en lugar de enviar el tráfico a otro lugar.

    Inferencia técnica

    Basado en la fuente pública del Codex:

    • Codex utiliza una ruta de compactación remota especial cuando el proveedor se reconoce como integrado.OpenAI
    • El nombre del proveedor personalizado OpenAI Inlinepuede evitar esa ruta exacta.
    • Si eso sucede, Codex debería recurrir al flujo de compactación local/en línea habitual en lugar de la ruta de compactación remota que está fallando.

    Por eso, la solución alternativa es razonable.

    ¿Es seguro?

    Seguro en el sentido de red/autenticación

    Sí, esta solución alternativa es segura en el sentido de que:

    • Todavía utiliza la autenticación de OpenAI.
    • No apunta a un proveedor diferente.
    • no agrega encabezados personalizados
    • No inyecta una URL de API personalizada.

    No es una solución oficial garantizada.

    No, esta no es una solución oficial de la versión principal.

    Se trata de una solución provisional , no de un parche confirmado para el producto.

    Lo que no cambió

    • tu repositorio en/Users/higordedeusmatos/Work/S/Projects/mimir
    • tu código fuente
    • tus pruebas
    • tu entorno shell
    • Comportamiento predeterminado del Codex cuando no utiliza el perfil de solución alternativa

    Cómo revertirlo

    Si desea deshacer la solución alternativa, elimine este bloque de ~/.codex/config.toml:

    [profiles.inline_compact_workaround]
    model_provider = "openai_inline"

    [model_providers.openai_inline]
    name = "OpenAI Inline"
    requires_openai_auth = true
    supports_websockets = true
    Tras su eliminación, Codex vuelve a la configuración anterior.

    Limitaciones conocidas

    Hechos

    • Comprobé que el archivo de configuración se sigue cargando correctamente después del cambio.
    • He comprobado que el nuevo perfil es aceptado por la interfaz de línea de comandos (CLI).

    Desconocidos

    • No provoqué una conversación en directo lo suficientemente larga como para activar la compactación bajo este perfil durante la validación.
    • Por ello, el comportamiento final en tiempo de ejecución sigue siendo una prueba en el mundo real, en lugar de un resultado garantizado matemáticamente.

    Paso siguiente recomendado

    Correr:

    codex -p inline_compact_workaround resume 019d8c16-d49f-72a1-b7f9-bd7ad5410a5f
    Si la compactación se realiza correctamente, siga utilizando este perfil temporalmente hasta que el desarrollador publique una solución definitiva.

    Si el problema persiste, elimine la solución temporal y espere a que se publique un parche en Codex.

    Enlaces de referencia

    WORKING

  27. etraut-openai commented on Apr 14, 2026

    @etraut-openai
    Contributor

    We rolled back the change that caused this regression, so this should be addressed now. Apologies for the inconvenience.

  28. codinghasnat commented on Apr 14, 2026

    @codinghasnat

    Okay they said its fixed, by my tokens for this 5h sprint are all eaten now ahaha

  29. David-D-Com commented on Apr 15, 2026

    @David-D-Com

    We rolled back the change that caused this regression, so this should be addressed now. Apologies for the inconvenience.

    I'm curious, what was the change?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    appIssues related to the Codex desktop appbugSomething isn't workingcontextIssues related to context management (including compaction)

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions