diff --git a/docs-site/src/content/docs/es/guides/codex-integration.md b/docs-site/src/content/docs/es/guides/codex-integration.md
index 000d03b6dca..1eb2b9a3c2b 100644
--- a/docs-site/src/content/docs/es/guides/codex-integration.md
+++ b/docs-site/src/content/docs/es/guides/codex-integration.md
@@ -228,7 +228,7 @@ El proxy admite hasta 128 conexiones Responses WebSocket orientadas al cliente.
Si una continuación canónica hacia adelante ChatGPT hace referencia a un estado de repetición local caducado o faltante, opencodex devuelve `previous_response_not_found` antes de enviar cualquier cosa aguas arriba. El cliente Codex de WebSocket reconoce este error y puede volver a conectarse con su contexto completo retenido, incluyendo llamadas de herramientas completadas y sus resultados, dentro de su presupuesto de reintento de flujo normal. Por lo tanto, una tarea inactiva no necesita una tarea nueva únicamente porque la caché de reproducción del proxy expiró. El estado de continuación reproducido se conserva durante 24 horas y permanece limitado por su memoria, disco y límites de entrada existentes; esto no recupera el historial que el cliente ya no tiene. HTTP clientes deben manejar el error explícitamente y volver a enviar su contexto completo sin `previous_response_id`. Volver a intentar solo el mismo ID no puede recuperar el estado faltante.
-El mismo rechazo se aplica cuando el estado referenciado pertenece a un ámbito de tarea cliente diferente, incluso cuando la nueva solicitud parece llevar entrada completa. El proxy no puede probar que la entrada está completa, por lo que no elimina silenciosamente `previous_response_id` ni revela si existe un estado coincidente. Vuelva a intentar con la conversación completa y omita `previous_response_id`; los ámbitos coincidentes y las continuaciones heredadas donde ambos ámbitos están ausentes o en blanco continúan reproduciéndose normalmente.
+El mismo rechazo se aplica cuando el estado referenciado pertenece a un ámbito de tarea cliente diferente, incluso cuando la nueva solicitud parece llevar entrada completa. El proxy no puede probar que la entrada está completa, por lo que no elimina silenciosamente `previous_response_id` ni revela si existe un estado coincidente. Cuando está activado el modo `v2-plaintext` o la opción `plaintextV2AgentMessages`, la reproducción local exige el mismo principal de OpenCodex admitido y el `thread-id` propio y no vacío de la solicitud. Un hilo principal, una dirección de loopback, una credencial del proveedor o una clave de relleno no constituyen esa identidad. Sin principal admitido o sin hilo propio, envía la conversación completa sin `previous_response_id`. Las configuraciones predeterminadas de Codex y DSH en loopback no establecen esa identidad. El estado conservado mientras cualquiera de las dos opciones está activada permanece vinculado al desactivarlas. El modo predeterminado `v1` conserva la continuación por hilo principal para el estado no vinculado, también en loopback. Esto es independiente de los ID de Responses gestionados por el proveedor nativo.
La misma señal de recuperación se aplica a cada destino enrutado, porque solo el paso a través nativo Responses puede responder a un giro cuya historia perdió este proxy: reenvía `previous_response_id` a un backend que almacenó la cadena. Cada uno de los otros cables reconstruye la conversación a partir de la propia entrada de cada solicitud, por lo que una expansión perdida allí enviaría el giro actual solo y perdería silenciosamente la conversación. Eso incluye los tres que parecen con estado: Devin vuelve a enviar toda la conversación a cada paso, la referencia de punto de control de Cursor vive en la misma tienda vencida y vuelve a la reproducción completa sin ella, y Kiro reconstruye su historial de conversaciones a partir de los turnos en que se entregó. También se aplica a los proveedores enrutados Responses configurados con `statelessResponses: true`, y a las solicitudes enrutadas donde una herramienta personalizada se redujo a una función pero un resultado delta no tiene llamada local para establecer su tipo original. La reproducción completa conserva la llamada, el resultado y el razonamiento juntos; opencodex no adivina el tipo de resultado ni lo descarta. Los proveedores estatales todavía resuelven la función nativa y las continuaciones personalizadas nativas por sí mismos. Estas comprobaciones siguen el protocolo de cable seleccionado y las declaraciones de la herramienta, no el nombre del modelo. Para una puerta de enlace que no puede resolver los ID de respuesta almacenados, habilite `statelessResponses` en ese proveedor; otros proveedores mantienen sus valores predeterminados.
diff --git a/docs-site/src/content/docs/es/guides/sub-agent-surface.md b/docs-site/src/content/docs/es/guides/sub-agent-surface.md
index aadfb96a6fa..114f4edc2e4 100644
--- a/docs-site/src/content/docs/es/guides/sub-agent-surface.md
+++ b/docs-site/src/content/docs/es/guides/sub-agent-surface.md
@@ -21,7 +21,9 @@ Elija el modo para **Nuevas sesiones**. Las sesiones existentes mantienen la sup
| **base** | Asignaciones originales por modelo: GPT-5.6 Sol/Terra usan v2; Luna, v1. Los demás siguen la opción `multi_agent_v2` de Codex. | Para quienes quieren conservar esas asignaciones y usan modelos principales y subagentes del mismo lado del límite de proveedores. Sol y Terra quedan en v2. |
| **v2** | Herramientas planas `spawn_agent`, `send_message`, `followup_task`, `interrupt_agent` y listado de agentes, con sesiones concurrentes. | Para quienes necesitan el flujo concurrente y comprenden la herencia de modelos y la limitación de tareas cifradas descrita abajo. |
-En **v2**, la opción **Mantener ChatGPT en v1** (`keepNativeChatGptOnV1`) conserva Sol/Terra en v1 para que puedan crear subagentes Grok o Claude. Los agentes principales nativos de ChatGPT cifran el cuerpo de las tareas `NEW_TASK` en v2 y los modelos enrutados no pueden leerlo. Los agentes principales enrutados permanecen en v2, donde las tareas de sus subagentes son texto plano. Para este modo híbrido, OpenCodex desactiva la anulación global `multi_agent_v2`, porque Codex la aplica antes que los ajustes por modelo del catálogo. Es una opción de v2, no un cuarto modo de catálogo.
+**v2-plaintext** usa las asignaciones V2 del catálogo con la anulación global desactivada y compila mensajes de tareas aptos en texto sin cifrar. Es una opción experimental con consentimiento explícito; consulta [sus condiciones](/es/guides/subagent-v1-default/).
+
+En **v2**, la opción **Mantener ChatGPT en v1** (`keepNativeChatGptOnV1`) conserva Sol/Terra en v1 para que puedan crear subagentes Grok o Claude. Los agentes principales nativos de ChatGPT cifran el cuerpo de las tareas `NEW_TASK` en v2 y los modelos enrutados no pueden leerlo. Los agentes principales enrutados permanecen en v2, donde las tareas de sus subagentes son texto plano. Para este modo híbrido, OpenCodex desactiva la anulación global `multi_agent_v2`, porque Codex la aplica antes que los ajustes por modelo del catálogo. Es una opción de v2 independiente del modo `v2-plaintext`.
:::tip[¿Tienes dudas?]
Usa **v1**, el modo predeterminado. Elige **base** o **v2** solo si el modelo principal y el subagente están del mismo lado del límite de proveedores: en ambos modos, una tarea enviada desde un modelo nativo de ChatGPT a uno enrutado llega cifrada y falla. La opción híbrida de v2 descrita arriba evita ese cruce conservando los modelos nativos en v1. El dashboard pide confirmación antes de elegir base o v2 y enlaza a [Por qué v1 es el valor predeterminado](/es/guides/subagent-v1-default/).
@@ -53,6 +55,7 @@ El modo seleccionado controla el campo `multi_agent_version` en cada entrada del
- **v1** marca `multi_agent_version = "v1"` en todos los modelos.
- **base** restaura los pines de aguas arriba. Las entradas sin pines siguen la bandera de la característica nativa `multi_agent_v2`.
+- **v2-plaintext** asigna V2 en el catálogo y desactiva la anulación global; también activa el compilador experimental para solicitudes aptas.
- **v2** marca `multi_agent_version = "v2"` en todos los modelos, excepto cuando **Mantener ChatGPT en v1** está habilitado: las filas nativas de ChatGPT permanecen en `"v1"` y las filas enrutadas o de combo permanecen en `"v2"`.
opencodex aplica esto como el pase final tanto al catálogo en vivo `/v1/models` como al catálogo sincronizado al disco. Es por eso que un cambio de modo afecta a las nuevas sesiones de App, CLI y TUI creadas de manera consistente.
@@ -182,7 +185,7 @@ Si la solicitud reconstruida recibe otro SSE `error` desnudo seguido por EOF, am
### GUI
-- **Tablero** → primera celda de estadística: elija **v1**, **base** o **v2**.
+- **Tablero** → primera celda de estadística: elija **v1**, **base**, **v2** o **v2-plaintext**.
- **Modelos** → control segmentado de la fila superior: elija el mismo modo global.
- **Tablero** → **Delegación de subagentes**: establece el modelo/esfuerzo de guía y la opción de opt-in por defecto nativa.
- **Subagentes**: elija y ordene la lista y configure la cadena de reserva global.
@@ -305,4 +308,4 @@ Solo un cambio real cuenta. Una sincronización cuyo resultado es idéntico en b
El límite de contexto del modelo es independiente del modo de subagente. Configure en la página Modelos; los modelos nativos OpenAI conservan sus ventanas de contexto real.
-El campo experimental `plaintextV2AgentMessages` no se establece en una nueva configuración y se ejecuta solo cuando se establece en `true`. La persona que llama debe usar el cable Responses y el destino final debe usar `adapter: "openai-responses"`, `authMode: "forward"` y la URL base exacta `https://chatgpt.com/backend-api/codex`. Quedan excluidos los proveedores de clave API de OpenAI, las pasarelas compatibles personalizadas, las rutas a otros proveedores y los llamantes que no usan Responses. Para una nueva llamada a la herramienta ChatGPT v2 nativa elegible, la opción asigna alias con alcance de solicitud al espacio de nombres y tres nombres reservados de la herramienta de mensajes, elimina el marcador de mensajes y restaura las identidades originales en la respuesta. Maneja `spawn_agent`, `send_message` y `followup_task` y no agrega ninguna petición de recuperación. HTTPS permanece cifrado, pero el texto de la tarea se puede conservar en el historial de Codex, las solicitudes del proveedor enrutado y el estado de respuesta/depuración local. El texto cifrado existente no cambia, y la opción depende del comportamiento no documentado de ChatGPT y Codex. Véase [Configuración del agente: Mensajes de agente de texto sin formato v2](/es/reference/configuration/agents/#plaintext-v2-agent-messages). Si una respuesta de flujo continuo ChatGPT no lleva ningún tipo de contenido, o una que no es ni `application/json` ni un flujo de eventos reconocible, opencodex comprueba un prefijo de evento Responses limitado antes de restaurar los nombres de herramienta de mensaje. Una respuesta `application/json` toma el camino JSON limitado en su lugar. La sonda espera como máximo `stallTimeoutSec` por su prefijo, y un cuerpo que permanece silencioso, no reconocido o ilegible se rechaza y nunca llega a Codex como una respuesta exitosa.
+El campo experimental `plaintextV2AgentMessages` no se establece en una configuración nueva. Un valor explícito `true` o el modo seleccionado `v2-plaintext` activa el compilador. Este modo también selecciona V2 para chats nuevos sin activar la anulación global; al salir, conserva el valor independiente del campo. La compilación sigue la configuración actual en solicitudes aptas posteriores, incluso en sesiones V2 existentes. No descifra texto cifrado existente ni reescribe el historial, y desactivarla no elimina las copias conservadas. La persona que llama debe usar el cable Responses y el destino final debe usar `adapter: "openai-responses"`, `authMode: "forward"` y la URL base exacta `https://chatgpt.com/backend-api/codex`. Quedan excluidos los proveedores de clave API de OpenAI, las pasarelas compatibles personalizadas, las rutas a otros proveedores y los llamantes que no usan Responses. Para una nueva llamada a la herramienta ChatGPT v2 nativa elegible, la opción asigna alias con alcance de solicitud al espacio de nombres y tres nombres reservados de la herramienta de mensajes, elimina el marcador de mensajes y restaura las identidades originales en la respuesta. Maneja `spawn_agent`, `send_message` y `followup_task` y no agrega ninguna petición de recuperación. HTTPS permanece cifrado, pero el texto de la tarea se puede conservar en el historial de Codex, las solicitudes del proveedor enrutado y el estado de respuesta/depuración local. El texto cifrado existente no cambia, y la opción depende del comportamiento no documentado de ChatGPT y Codex. Véase [Configuración del agente: Mensajes de agente de texto sin formato v2](/es/reference/configuration/agents/#plaintext-v2-agent-messages). Si una respuesta de flujo continuo ChatGPT no lleva ningún tipo de contenido, o una que no es ni `application/json` ni un flujo de eventos reconocible, opencodex comprueba un prefijo de evento Responses limitado antes de restaurar los nombres de herramienta de mensaje. Una respuesta `application/json` toma el camino JSON limitado en su lugar. La sonda espera como máximo `stallTimeoutSec` por su prefijo, y un cuerpo que permanece silencioso, no reconocido o ilegible se rechaza y nunca llega a Codex como una respuesta exitosa.
diff --git a/docs-site/src/content/docs/es/guides/subagent-v1-default.md b/docs-site/src/content/docs/es/guides/subagent-v1-default.md
index 477d355c6e6..dc891cc73e3 100644
--- a/docs-site/src/content/docs/es/guides/subagent-v1-default.md
+++ b/docs-site/src/content/docs/es/guides/subagent-v1-default.md
@@ -5,7 +5,21 @@ description: "Qué impide la limitación de tareas cifradas de v2, por qué Open
OpenCodex se instala con la interfaz de subagentes en **v1**. Las páginas Panel, Modelos y Subagentes solicitan confirmación antes de cambiar a **base** o **v2** y enlazan esta explicación. La CLI no solicita esa confirmación.
-El motivo es concreto: de forma predeterminada, en v2 un modelo enrutado no puede leer la tarea cifrada que recibe de un modelo nativo de ChatGPT. Esto afecta al caso habitual de un agente GPT que crea un subagente Grok, Claude o GLM. Las excepciones explícitas son `keepNativeChatGptOnV1`, que conserva los modelos nativos de ChatGPT en v1 mientras los enrutados usan v2; un destino autorizado que pueda procesar la tarea cifrada mediante `allowEncryptedV2AgentTasks: true`; o la recuperación experimental `agentTaskRecovery`, descritas más abajo.
+El motivo es concreto: de forma predeterminada, en v2 un modelo enrutado no puede leer la tarea cifrada que recibe de un modelo nativo de ChatGPT. Esto afecta al caso habitual de un agente GPT que crea un subagente Grok, Claude o GLM. Las excepciones explícitas son `keepNativeChatGptOnV1`, que conserva los modelos nativos de ChatGPT en v1 mientras los enrutados usan v2; un destino autorizado que pueda procesar la tarea cifrada mediante `allowEncryptedV2AgentTasks: true`; la recuperación experimental `agentTaskRecovery` o el modo experimental `v2-plaintext`, descritos más abajo.
+
+## V2 opcional con tareas en texto sin cifrar
+
+**V2 · tareas en texto sin cifrar** (`v2-plaintext`) selecciona V2 para chats nuevos mediante asignaciones del catálogo con la anulación global desactivada. Conserva nombres de tareas, jerarquía, seguimiento, cancelación y concurrencia de V2; reutiliza el compilador experimental para solicitudes Responses aptas dirigidas a ChatGPT por la ruta canónica. Los chats existentes conservan su selección, pero la compilación sigue la configuración actual también en sus solicitudes V2 aptas posteriores. Una actualización no selecciona este modo automáticamente. También puede activar el compilador el ajuste independiente `plaintextV2AgentMessages: true`.
+
+Mientras cualquiera de las dos opciones esté activada, las continuaciones locales por ID requieren el mismo principal de clave API de OpenCodex admitido y el `thread-id` propio de la solicitud; el hilo principal no da acceso a las tareas de un hijo. Sin cualquiera de las dos identidades, tras reiniciar el proxy o para entradas antiguas sin vínculo, envía la conversación completa sin `previous_response_id`. El estado vinculado mientras está activado permanece vinculado al desactivarlo. El modo predeterminado `v1` conserva la continuación por hilo principal para el estado no vinculado, incluso en loopback.
+
+En `v2-plaintext`, el panel exige aceptar que el texto puede conservarse en el historial de Codex, las solicitudes al proveedor y el estado local de respuesta o depuración, incluidas instantáneas y archivos en disco. HTTPS y la autenticación siguen activos. No se añade una llamada de recuperación, no se descifra el texto cifrado existente ni se reescribe el historial, y desactivar la compilación no elimina las copias retenidas. Un cliente o backend incompatible aún puede fallar.
+
+```bash
+ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages
+```
+
+Para el destino local omite `--live`. Después consulta el mismo destino: `ocx v2 status --live --json` para el proxy activo o `ocx v2 status --json` para el destino local. La configuración y la convergencia del catálogo no prueban que una delegación real haya funcionado. Para salir, selecciona otro modo; se conserva el valor independiente de `plaintextV2AgentMessages`. La API de gestión exige `plaintextAgentMessagesAcknowledged` al entrar.
@@ -65,6 +79,7 @@ OpenCodex registró esta consecuencia en [#92](https://github.com/lidge-jun/open
| **v1** (predeterminado) | Todos los modelos anuncian las herramientas clásicas de creación con espacio de nombres. Cada creación puede indicar otro modelo directamente. | Si delega entre proveedores. Es el valor incluido en la instalación. |
| **base** | Respeta la asignación de Codex por modelo: Sol y Terra usan v2, Luna usa v1 y los modelos sin asignación siguen la opción de Codex. | Si desea la interfaz prevista por Codex y delega dentro de un mismo proveedor. |
| **v2** | Todos los modelos anuncian las herramientas concurrentes sin espacio de nombres. | Si desea las sesiones concurrentes nuevas y ambos agentes están del mismo lado del límite entre proveedores. |
+| **v2-plaintext** | Asigna V2 a sesiones nuevas con la anulación global desactivada y compila las solicitudes aptas en texto sin cifrar. | Si acepta la conservación del texto y desea usar esta opción experimental. |
base aparece en segundo lugar porque asigna v2 a Sol y Terra, modelos utilizados habitualmente como agentes principales. Para delegar de ChatGPT a un modelo enrutado, base tiene la misma limitación que v2.
@@ -79,13 +94,13 @@ La actualización no sobrescribe una elección existente. El panel muestra el av
Ambas respuestas quedan registradas. Cerrar el aviso sin responder lo deja pendiente para la siguiente apertura del panel.
-El modo se aplica a las sesiones **nuevas** de Codex. Inicie otra sesión después del cambio. Si un proceso de la aplicación que lleva tiempo abierto todavía muestra la interfaz anterior, ejecute `ocx sync` y reinicie esa aplicación.
+Las asignaciones del catálogo se aplican a las sesiones **nuevas** de Codex; el compilador de texto sin cifrar sigue la configuración actual para las solicitudes aptas, incluidas las posteriores de sesiones V2 existentes. Inicie otra sesión después del cambio. Si un proceso de la aplicación que lleva tiempo abierto todavía muestra la interfaz anterior, ejecute `ocx sync` y reinicie esa aplicación.
## Si prefiere utilizar v2
-Hay cuatro opciones, en el orden recomendado:
+Además de `v2-plaintext`, hay cuatro opciones:
1. **Mantener ChatGPT en v1.** Dentro de v2, `keepNativeChatGptOnV1` conserva Sol y Terra en v1 para que puedan crear subagentes Grok o Claude; los agentes principales enrutados utilizan v2.
2. **Delegar dentro del mismo proveedor.** Un agente enrutado que crea otro subagente enrutado utiliza texto sin cifrar en v2 y funciona normalmente.
@@ -104,7 +119,7 @@ Cuando Codex permita que un agente nativo de ChatGPT emita sin cifrar la tarea d
## Cambiar el modo
-Panel, Modelos y Subagentes comparten el selector v1/base/v2 y solicitan confirmación antes de pasar a base o v2. Desde la CLI:
+Panel, Modelos y Subagentes comparten el selector v1/base/v2/v2-plaintext y solicitan confirmación antes de pasar a base o v2; entrar en `v2-plaintext` requiere aceptar sus condiciones. Desde la CLI:
```bash
ocx v2 status
diff --git a/docs-site/src/content/docs/es/reference/cli.md b/docs-site/src/content/docs/es/reference/cli.md
index 47473349363..4eefd6148e8 100644
--- a/docs-site/src/content/docs/es/reference/cli.md
+++ b/docs-site/src/content/docs/es/reference/cli.md
@@ -207,6 +207,8 @@ Las opciones enteras como `--limit` requieren números enteros decimales dentro
+Para entrar en el modo experimental usa `ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages`. Los comandos genéricos `config set` y `config import` rechazan una entrada nueva a este modo, pues el comando dedicado también coordina la transición nativa. Antes de restaurar una configuración exportada con `multiAgentMode: "v2-plaintext"`, realiza primero esa transición con reconocimiento y después importa el archivo. Se permite restaurar un modo ya activo, cambiar otros ajustes y salir del modo. La preferencia independiente `plaintextV2AgentMessages` no cambia.
+
## Listado de alias predeterminado
`ocx alias --json` es equivalente a `ocx alias list --json`. La bandera de salida puede preceder o seguir una acción de alias explícita.
diff --git a/docs-site/src/content/docs/es/reference/cli/agents.md b/docs-site/src/content/docs/es/reference/cli/agents.md
index 028395a849c..6ff4035d7fb 100644
--- a/docs-site/src/content/docs/es/reference/cli/agents.md
+++ b/docs-site/src/content/docs/es/reference/cli/agents.md
@@ -101,9 +101,9 @@ ocx effort set --subagent -
Status conserva los valores de límite de entorno de ejecución/almacenados existentes e informa de los valores no admitidos en `warnings` (una matriz vacía cuando no se admite ninguna). Las mismas advertencias aparecen en la salida humana y nombran el campo que se ignora con un comando de corrección. El estado nunca repara o reescribe esos valores. Un campo de subagente ignorado no elimina un límite principal válido. `ocx effort clear` limpia ambos límites mientras retiene la configuración de esfuerzo de inyección separada. Véase [Superficies de los subagentes](/es/guides/sub-agent-surface/) para las superficies de solicitud donde se aplican los límites.
-### `ocx v2 |keep-native-v1 |threads |mode-hint >`
+### `ocx v2 |keep-native-v1 |threads |mode-hint >`
-Administre el indicador de características Codex `multi_agent_v2` y el modo de superficie multiagente de tres estados. Estos funcionan localmente por defecto. `--live` utiliza el proxy de ejecución seleccionado sin respaldo local; ambos objetivos admiten `--json`. Vuelva a leer el estado en el mismo objetivo después de un cambio y distinga la configuración almacenada del comportamiento de la nueva sesión.
+Administre el indicador de características Codex `multi_agent_v2` y el modo de superficie multiagente. Estos funcionan localmente por defecto. `--live` utiliza el proxy de ejecución seleccionado sin respaldo local; ambos objetivos admiten `--json`. Vuelva a leer el estado en el mismo objetivo después de un cambio y distinga la configuración almacenada del comportamiento de la nueva sesión.
| Subcomando | Medidas adoptadas |
| --- | --- |
@@ -113,6 +113,7 @@ Administre el indicador de características Codex `multi_agent_v2` y el modo de
| `mode v1` | Forzar a todos los modelos a v1, deshabilitar v2 nativo y preservar el límite de subproceso activo. |
| `mode default` | Respete los pines de superficie del modelo aguas arriba. |
| `mode v2` | Forzar los modelos a v2 y preservar el límite de rosca activa. Con `keep-native-v1` desactivado, habilite la v2 nativa global; con ella, deshabilite la anulación global y use pines de catálogo. |
+| `mode v2-plaintext` | Asigna V2 mediante el catálogo con la anulación global desactivada y activa la entrega experimental de tareas en texto sin cifrar. Requiere `--acknowledge-plaintext-agent-messages`. |
| `keep-native-v1 on\|off` | Bajo `mode v2`, mantenga los modelos nativos ChatGPT en v1 y los modelos enrutados en v2. Habilitarlo desactiva la anulación global de V2 antes de la sincronización del catálogo. |
| `threads ` | Establezca el límite de hilo v1/v2 activo en un número entero de al menos 1. |
| `mode-hint ` | Establezca la sugerencia de delegación proactiva (modo Ultra) para cada modelo y esfuerzo. |
@@ -132,7 +133,7 @@ El subcomando `mode` escribe `multiAgentMode` a la configuración opencodex y vu
Codex resuelve una anulación global habilitada de `multi_agent_v2` antes del pin de catálogo del modelo seleccionado. Por lo tanto, el contrato híbrido `keep-native-v1` mantiene esa anulación global apagada; de lo contrario, una fila nativa estampada `v1` aún comenzaría en V2 y produciría tareas secundarias cifradas en el backend.
-`mode-hint` escribe `features.multi_agent_v2.multi_agent_mode_hint_text` en el `$CODEX_HOME/config.toml` de Codex incluso cuando `multi_agent_v2` está actualmente deshabilitado. El comando solo persiste la anulación; no habilita ni deshabilita la función, por lo que la sugerencia tiene efecto cuando una superficie coincidente Codex está activa. La sugerencia anula la política multiagente derivada de esfuerzo de codex-rs, por lo que cualquier modelo y cualquier esfuerzo de razonamiento recibe el mensaje de delegación proactiva. **no** cambia el esfuerzo de razonamiento en sí. Se rechaza un argumento faltante o un valor de solo espacio en blanco; solo `--clear` elimina la sugerencia. El modo Ultra **on** del panel de Subagents tiene una puerta más estricta: requiere que la función nativa esté habilitada con una superficie v2 explícita ( `ocx v2 mode v2` ); `ocx v2 on` por sí solo no satisface esa puerta del tablero.
+`mode-hint` escribe `features.multi_agent_v2.multi_agent_mode_hint_text` en el `$CODEX_HOME/config.toml` de Codex incluso cuando `multi_agent_v2` está actualmente deshabilitado. El comando solo persiste la anulación; no habilita ni deshabilita la función, por lo que la sugerencia tiene efecto cuando una superficie coincidente Codex está activa. La sugerencia anula la política multiagente derivada de esfuerzo de codex-rs, por lo que cualquier modelo y cualquier esfuerzo de razonamiento recibe el mensaje de delegación proactiva. **no** cambia el esfuerzo de razonamiento en sí. Se rechaza un argumento faltante o un valor de solo espacio en blanco; solo `--clear` elimina la sugerencia. El modo Ultra **on** del panel de Subagents tiene una puerta más estricta: requiere la función nativa habilitada con una superficie v2 explícita (`ocx v2 mode v2`) o `v2-plaintext`, que usa asignaciones del catálogo con la anulación global desactivada; `ocx v2 on` por sí solo no satisface esa puerta del tablero.
diff --git a/docs-site/src/content/docs/es/reference/configuration/agents.md b/docs-site/src/content/docs/es/reference/configuration/agents.md
index 197256c61ed..1f2fac872b7 100644
--- a/docs-site/src/content/docs/es/reference/configuration/agents.md
+++ b/docs-site/src/content/docs/es/reference/configuration/agents.md
@@ -29,7 +29,7 @@ El marcador interno `subagentModelsVersion` (actualmente `3`) hace que cada migr
| Campo | Tipo | Predeterminado | Significado |
| --- | --- | --- | --- |
-| `multiAgentMode?` | `"v1" \| "default" \| "v2"` | `"default"` | `v1` marca todos los modelos del catálogo como v1; `v2` los marca como v2. `default` restaura las asignaciones del proveedor (Sol/Terra v2, Luna v1) y, en los demás casos, sigue la opción nativa `multi_agent_v2`. Se aplica a las sesiones nuevas. |
+| `multiAgentMode?` | `"v1" \| "default" \| "v2" \| "v2-plaintext"` | `"default"` | `v1` marca todos los modelos del catálogo como v1; `v2` los marca como v2. `default` restaura las asignaciones del proveedor (Sol/Terra v2, Luna v1) y, en los demás casos, sigue la opción nativa `multi_agent_v2`. `v2-plaintext` también activa la entrega experimental en texto sin cifrar y desactiva la anulación global. Las asignaciones se aplican a sesiones nuevas; la compilación activa también afecta a solicitudes aptas posteriores de sesiones V2 existentes. |
| `keepNativeChatGptOnV1?` | `boolean` | `false` | Cuando `multiAgentMode` es `"v2"`, desactiva la anulación global de V2, marca las entradas nativas de ChatGPT como v1 y conserva las enrutadas en v2. Codex resuelve la anulación global antes que las asignaciones del catálogo: ambas partes son necesarias para que un agente principal de ChatGPT cree subagentes enrutados sin tareas cifradas por el backend ([#92](https://github.com/lidge-jun/opencodex/issues/92)). Se ignora en `v1` y `default`. |
| `subagentModels?` | `string[]` | `gpt-6-astra`, `gpt-6.1-sol`, `gpt-6-luna` | Hasta cinco identificadores nativos sin prefijo, con cuenta `/` o enrutados `provider/model` que aparecen primero en el selector de subagentes. El panel ofrece identificadores nativos sin prefijo y enrutados para nuevas selecciones; al guardar conserva los identificadores exactos de cuenta ya configurados, aunque no estén disponibles en el catálogo actual. Para añadir un identificador exacto de cuenta nuevo, usa `ocx agent subagents set` o edita la configuración. Tras la [migración única de Astra](#astra-roster-upgrade), se conserva una lista explícitamente vacía. |
| `injectionModel?` | `string` | — | Modelo de subagente nativo o enrutado preferido que se menciona en la guía de delegación v2 redactada por el proxy. |
@@ -44,14 +44,14 @@ El marcador interno `subagentModelsVersion` (actualmente `3`) hace que cada migr
| `codexRoleCapability?` | `{ artificialAnalysis?: { apiKey?: string } }` | Sin fuente medida | Fuente de puntuaciones para la [asignación automática de roles](/es/guides/integrations/#auto-assign). Artificial Analysis usa tu clave API (literal, `${ENV}` o referencia del llavero) una vez al día para leer su lista gratuita de modelos; todos los dominios usan su Intelligence Index. Las puntuaciones no se incluyen en la respuesta. Si faltan datos o no están disponibles, se usan los niveles y precios configurados. La clave retirada `huggingFace` se ignora. |
| `effortCap?` | `string` | — | Límite máximo para los turnos principales v2 que cumplan los requisitos y para los turnos de subagentes que lleven los marcadores correspondientes. Admite de `low` a `ultra`. |
| `subagentEffortCap?` | `string` | — | Límite adicional solo para turnos de subagentes creados. Cuando se aplican ambos límites, prevalece el menor. |
-| `plaintextV2AgentMessages?` | `boolean` | — (sin configurar) | Opción experimental que solo se ejecuta al establecerla explícitamente en `true`. Pide a los agentes principales v2 nativos de ChatGPT que cumplan los requisitos emitir en texto sin cifrar los argumentos de mensaje de `spawn_agent`, `send_message` y `followup_task`. Consulta [Mensajes de agentes v2 en texto sin cifrar](#plaintext-v2-agent-messages). |
+| `plaintextV2AgentMessages?` | `boolean` | — (sin configurar) | Opción experimental que se activa con `true` explícito o con `multiAgentMode: "v2-plaintext"`. Pide a los agentes principales v2 nativos de ChatGPT que cumplan los requisitos emitir en texto sin cifrar los argumentos de mensaje de `spawn_agent`, `send_message` y `followup_task`. Consulta [Mensajes de agentes v2 en texto sin cifrar](#plaintext-v2-agent-messages). |
| `agentTaskRecovery?` | `object` | — | Recuperación experimental de tareas v2 cifradas por el backend que se envían a proveedores enrutados. Está desactivada salvo que se indique `enabled: true`; consulta [Recuperación de tareas v2 cifradas](#encrypted-v2-task-recovery). |
-Configura el modo desde el panel o con `ocx v2 status|on|off|mode |keep-native-v1 |threads |mode-hint `. Los cambios de modo se aplican a sesiones nuevas. `maxConcurrentThreadsPerSession` es un campo de `PUT /api/v2`, no una clave de `config.json`; después de activar v2, `ocx v2 threads ` escribe `max_concurrent_threads_per_session` dentro de `[features.multi_agent_v2]` en el archivo `$CODEX_HOME/config.toml` de Codex.
+Configura el modo desde el panel o con `ocx v2 status|on|off|mode |keep-native-v1 |threads |mode-hint `. Para entrar en `v2-plaintext` se requiere `--acknowledge-plaintext-agent-messages`; la API exige `plaintextAgentMessagesAcknowledged` y el panel solicita consentimiento. Los cambios de asignación del catálogo se aplican a sesiones nuevas; el compilador de texto sin cifrar sigue la configuración actual para las solicitudes aptas, incluidas las posteriores de sesiones V2 existentes. `maxConcurrentThreadsPerSession` es un campo de `PUT /api/v2`, no una clave de `config.json`; después de activar v2, `ocx v2 threads ` escribe `max_concurrent_threads_per_session` dentro de `[features.multi_agent_v2]` en el archivo `$CODEX_HOME/config.toml` de Codex.
El límite de subagentes de la página Modelos cuenta agentes secundarios. Un total V2 guardado de 1 solo permite el agente raíz y muestra 0 secundarios; configurar un secundario guarda un total V2 de 2. Los límites nuevos deben permitir al menos un secundario. Tanto esa cantidad como su conversión para la API deben ser enteros seguros, como máximo 9.007.199.254.740.991. Si V2 global está desactivado, incluido el modo híbrido, no se añade una posición para el agente raíz. La API rechaza límites inseguros con HTTP 400 antes de cambiar la función o la configuración.
-**Delegación siempre proactiva**, en Subagentes → Avanzado (antes **Modo Ultra**), cambia el criterio para delegar sin cambiar el esfuerzo de razonamiento. Su configuración predefinida conserva las instrucciones del usuario, los límites de autoridad, el alcance de la tarea y las reglas de las herramientas. El interruptor del panel, el campo `multiAgentModeHintText` de `PUT /api/v2` y `ocx v2 mode-hint` escriben `features.multi_agent_v2.multi_agent_mode_hint_text` en el archivo `$CODEX_HOME/config.toml` de Codex. El comando `ocx v2 mode-hint` guarda esta clave incluso cuando `multi_agent_v2` está desactivado; no activa la función. Cuando la interfaz nativa está activa, esta indicación sustituye la política multiagente que codex-rs deriva del esfuerzo. Un valor `null` elimina la clave y restaura la política derivada del esfuerzo (ultra = proactiva; los demás niveles = explícita). Se rechazan los valores vacíos o compuestos solo por espacios, porque una anulación vacía suprimiría incluso el mensaje proactivo derivado de ultra. El interruptor **Delegación siempre proactiva** del panel de Subagentes requiere tanto la función nativa como un modo v2 explícito (`multiAgentMode: "v2"`, equivalente a `ocx v2 mode v2`); `ocx v2 on` por sí solo no cumple ese requisito.
+**Delegación siempre proactiva**, en Subagentes → Avanzado (antes **Modo Ultra**), cambia el criterio para delegar sin cambiar el esfuerzo de razonamiento. Su configuración predefinida conserva las instrucciones del usuario, los límites de autoridad, el alcance de la tarea y las reglas de las herramientas. El interruptor del panel, el campo `multiAgentModeHintText` de `PUT /api/v2` y `ocx v2 mode-hint` escriben `features.multi_agent_v2.multi_agent_mode_hint_text` en el archivo `$CODEX_HOME/config.toml` de Codex. El comando `ocx v2 mode-hint` guarda esta clave incluso cuando `multi_agent_v2` está desactivado; no activa la función. Cuando la interfaz nativa está activa, esta indicación sustituye la política multiagente que codex-rs deriva del esfuerzo. Un valor `null` elimina la clave y restaura la política derivada del esfuerzo (ultra = proactiva; los demás niveles = explícita). Se rechazan los valores vacíos o compuestos solo por espacios, porque una anulación vacía suprimiría incluso el mensaje proactivo derivado de ultra. El interruptor **Delegación siempre proactiva** del panel de Subagentes requiere la función nativa con un modo v2 explícito (`multiAgentMode: "v2"`, equivalente a `ocx v2 mode v2`) o `multiAgentMode: "v2-plaintext"`, que usa asignaciones del catálogo con la anulación global desactivada; `ocx v2 on` por sí solo no cumple ese requisito.
`GET` y `PUT /api/v2` también devuelven `multiAgentModeHintRecommendation: { text, revision }`. El panel usa ese texto del servidor al activar o restaurar la configuración predefinida, sin un texto alternativo fijo. Si un servidor anterior omite la recomendación o devuelve un valor mal formado, no se puede instalar ni restaurar la configuración predefinida; sigue siendo posible editar o borrar una indicación personalizada existente. **Restaurar configuración predefinida** solo cambia el borrador local; **Guardar** lo conserva.
@@ -117,7 +117,7 @@ opencodex omite candidatos desactivados, sin ruta, con problemas de funcionamien
## Mensajes de agentes v2 en texto sin cifrar
-`plaintextV2AgentMessages` no está configurado en una instalación nueva y solo se ejecuta al establecerlo explícitamente en `true`. El cliente debe usar el protocolo Responses y el destino final debe usar el transporte canónico de reenvío de ChatGPT Codex: `adapter: "openai-responses"`, `authMode: "forward"` y la URL base exacta `https://chatgpt.com/backend-api/codex`. Nunca se reescriben los proveedores de OpenAI con clave API, las pasarelas personalizadas compatibles con OpenAI, las rutas cuyo destino final sea otro proveedor ni las solicitudes que no usen Responses.
+`plaintextV2AgentMessages` no está configurado en una instalación nueva. Un valor explícito `true` o `multiAgentMode: "v2-plaintext"` activa esta ruta experimental. El modo asigna V2 en el catálogo y desactiva la anulación global; entra mediante la confirmación del panel o `ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages`. El modo conserva el booleano independiente, cuyo comportamiento anterior vuelve al salir. La compilación sigue la configuración actual en solicitudes canónicas aptas posteriores, incluso en sesiones V2 existentes. No descifra texto cifrado ni reescribe el historial; desactivarla no elimina copias retenidas en el historial, las solicitudes al proveedor o el estado local de respuesta y depuración. El cliente debe usar el protocolo Responses y el destino final debe usar el transporte canónico de reenvío de ChatGPT Codex: `adapter: "openai-responses"`, `authMode: "forward"` y la URL base exacta `https://chatgpt.com/backend-api/codex`. Nunca se reescriben los proveedores de OpenAI con clave API, las pasarelas personalizadas compatibles con OpenAI, las rutas cuyo destino final sea otro proveedor ni las solicitudes que no usen Responses.
Para una solicitud v2 apta, opencodex reconoce el catálogo por un espacio de nombres `collaboration` de nivel superior con un hijo directo `spawn_agent`. El catálogo puede estar en `tools` de nivel superior o, cuando no existe `tools`, en `additional_tools` del primer elemento de entrada de desarrollador (Responses Lite). El catálogo explícito de nivel superior tiene prioridad; los catálogos de rol de usuario y los posteriores del historial no activan la opción. Se elimina `parameters.properties.message.encrypted: true`, si existe, únicamente de `spawn_agent`, `send_message` y `followup_task`. ChatGPT reserva tanto `collaboration` como esos tres nombres de herramientas, por lo que la solicitud usa alias privados fijos para las cuatro identidades. Antes del cambio, opencodex comprueba los catálogos de nivel superior y de `additional_tools`, los espacios de nombres anidados, las declaraciones `tool_search_output`, `tool_choice` y las llamadas anteriores para detectar conflictos con los alias o el espacio de nombres privado. Ante cualquier conflicto, toda la solicitud se conserva sin cambios. OpenCodex restaura solo los alias correspondientes a esa solicitud en las respuestas JSON, SSE y WebSocket antes de que Codex reciba la llamada. Se conserva `encrypted_function_args: []` para que los clientes compatibles reconozcan el mensaje como texto sin cifrar.
diff --git a/docs-site/src/content/docs/fr/guides/codex-integration.md b/docs-site/src/content/docs/fr/guides/codex-integration.md
index 1ef8e55d72c..b058cac30bf 100644
--- a/docs-site/src/content/docs/fr/guides/codex-integration.md
+++ b/docs-site/src/content/docs/fr/guides/codex-integration.md
@@ -194,6 +194,8 @@ fournisseur dédié n'annonce `supports_websockets = true` que lorsque `"websock
bouclage, le fournisseur intégré de Codex peut tenter WebSocket en premier ; si cette fonction est désactivée,
le proxy renvoie `426` et Codex se rabat sur HTTP/SSE.
+Lorsque le mode `v2-plaintext` ou l’option `plaintextV2AgentMessages` est activé, la relecture locale exige le même appelant OpenCodex admis et le `thread-id` non vide propre à la requête. Un fil parent, une adresse de bouclage, des identifiants amont ou une clé de substitution ne constituent pas cette identité. Les clients sans principal d’appelant admis et les requêtes sans fil propre doivent renvoyer la conversation complète sans `previous_response_id`. Les configurations Codex et DSH de bouclage par défaut n’établissent pas cette identité. L’état conservé pendant l’activation de l’un ou l’autre réglage reste lié après sa désactivation. Dans le mode `v1` par défaut, l’état non lié conserve le comportement de continuation existant, limité au fil parent, y compris pour les appelants de bouclage par défaut. Cela reste distinct des ID Responses natifs appartenant au service amont.
+
## Identité et historique du fil de discussion
La configuration de bouclage par défaut conserve l'étiquette du fournisseur natif `openai` de Codex sur les
diff --git a/docs-site/src/content/docs/fr/guides/sub-agent-surface.md b/docs-site/src/content/docs/fr/guides/sub-agent-surface.md
index 5941150a65e..14f079f64af 100644
--- a/docs-site/src/content/docs/fr/guides/sub-agent-surface.md
+++ b/docs-site/src/content/docs/fr/guides/sub-agent-surface.md
@@ -16,18 +16,19 @@ Choisissez le mode pour les **nouvelles sessions**. Les sessions existantes cons
| Mode | Ce que Codex obtient | Qui devrait le choisir |
| --- | --- | --- |
-| **v1** | Outils classiques avec espace de noms `spawn_agent`, `send_input`, `resume_agent` et `close_agent`. Un spawn peut sélectionner directement un autre modèle. | Les débutants qui ont besoin d'une délégation fiable entre différents fournisseurs, en particulier les enfants natifs vers routés. |
-| **base** (par défaut) | Paramètres de modèle en amont : GPT-5.6 Sol/Terra utilisent la v2, Luna utilise la v1, et les modèles non définis explicitement suivent l’indicateur de fonctionnalité `multi_agent_v2` de Codex. | La plupart des utilisateurs. Ce mode respecte la surface prévue par Codex pour chaque modèle, sans en imposer une globalement. |
+| **v1** (par défaut pour une nouvelle installation) | Outils classiques avec espace de noms `spawn_agent`, `send_input`, `resume_agent` et `close_agent`. Un spawn peut sélectionner directement un autre modèle. | Les débutants qui ont besoin d'une délégation fiable entre différents fournisseurs, en particulier les enfants natifs vers routés. |
+| **base** | Paramètres de modèle en amont : GPT-5.6 Sol/Terra utilisent la v2, Luna utilise la v1, et les modèles non définis explicitement suivent l’indicateur de fonctionnalité `multi_agent_v2` de Codex. | La plupart des utilisateurs. Ce mode respecte la surface prévue par Codex pour chaque modèle, sans en imposer une globalement. |
| **v2** | Outils plats `spawn_agent`, `send_message`, `followup_task`, `interrupt_agent` et liste d'agents, avec sessions simultanées. | Utilisateurs souhaitant utiliser le flux de travail simultané le plus récent et comprenant l'héritage de modèle et la limitation des tâches chiffrées ci-dessous. |
+| **v2-plaintext** | V2 | Sélectionne V2 pour les nouvelles sessions et transmet les tâches admissibles en clair sans priorité globale. L’entrée exige `--acknowledge-plaintext-agent-messages`. |
En **v2**, l'option facultative **Garder ChatGPT sur v1** (`keepNativeChatGptOnV1`) laisse Sol/Terra
sur la surface v1 afin qu'ils puissent encore lancer Grok ou Claude. Les parents natifs ChatGPT
chiffrent les corps `NEW_TASK` v2 ; les modèles routés ne peuvent pas les lire. Les parents routés
restent sur v2, où les tâches enfants sont en texte clair. C'est un interrupteur *à l'intérieur*
-de v2, pas un quatrième mode de catalogue. CLI : `ocx v2 mode v2` puis `ocx v2 keep-native-v1 on`.
+de v2, distinct du mode `v2-plaintext`. CLI : `ocx v2 mode v2` puis `ocx v2 keep-native-v1 on`.
:::tip[Pas sûr ?]
-Commencez par **base**. Choisissez **v1** lorsque la délégation entre fournisseurs doit fonctionner de manière prévisible. Forcer **v2**
+Commencez par **v1**, le mode par défaut d’une nouvelle installation, pour une délégation prévisible entre fournisseurs. Choisissez **base** pour suivre les paramètres en amont. Forcer **v2**
uniquement lorsque vous souhaitez spécifiquement son modèle de session le plus récent dans chaque entrée de catalogue.
:::
@@ -207,6 +208,10 @@ canoniques pour les tâches chiffrées.
- **Tableau de bord** → **Délégation de sous-agent** : définissez les conseils model/effort et l'activation explicite natif par défaut.
- **Sous-agents** : choisissez et ordonnez la liste, puis configurez la chaîne de repli globale.
+Le champ expérimental `plaintextV2AgentMessages` est absent d’une configuration neuve. La valeur explicite `true` ou le mode distinct `v2-plaintext` active le compilateur ; quitter ce mode conserve la préférence indépendante. Le mode fixe V2 au catalogue pour les nouvelles sessions sans priorité globale, mais le compilateur suit le réglage actuel pour les requêtes admissibles ultérieures, y compris dans les sessions V2 existantes. Il ne déchiffre pas les tâches existantes et ne réécrit pas l’historique ; sa désactivation ne supprime pas les copies conservées.
+
+La requête doit utiliser Responses et la destination finale le transport ChatGPT Codex canonique : `adapter: "openai-responses"`, `authMode: "forward"` et `https://chatgpt.com/backend-api/codex`. Les fournisseurs à clé API OpenAI, passerelles compatibles personnalisées, autres destinations et clients non Responses sont exclus. Pour les appels V2 admissibles, le compilateur traite `spawn_agent`, `send_message` et `followup_task` sans requête de récupération supplémentaire. HTTPS reste chiffré, mais le texte peut être conservé dans l’historique Codex, les requêtes des fournisseurs routés et l’état local de réponse ou de débogage. Voir [messages d’agent v2 en clair](/reference/configuration/agents/#plaintext-v2-agent-messages).
+
### CLI
Utilisez `ocx v2` pour les paramètres de la surface de collaboration et des fonctionnalités natives :
@@ -216,6 +221,7 @@ ocx v2 status
ocx v2 mode v1
ocx v2 mode default
ocx v2 mode v2
+ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages
ocx v2 keep-native-v1 on
ocx v2 keep-native-v1 off
ocx v2 threads 8
diff --git a/docs-site/src/content/docs/fr/guides/subagent-v1-default.md b/docs-site/src/content/docs/fr/guides/subagent-v1-default.md
index c153742b1d9..93419358fc1 100644
--- a/docs-site/src/content/docs/fr/guides/subagent-v1-default.md
+++ b/docs-site/src/content/docs/fr/guides/subagent-v1-default.md
@@ -7,10 +7,23 @@ OpenCodex s'installe avec la surface de sous-agent réglée sur **v1**. Les page
Dashboard, Models et Subagents demandent toutes confirmation avant de passer à
**base** ou **v2** et renvoient vers cette page. La CLI ne demande rien.
-La raison est précise : en v2, une tâche confiée par un modèle ChatGPT natif à
-un modèle routé est illisible pour ce dernier. C'est le cas de délégation le
-plus courant — un parent GPT qui lance un enfant Grok, Claude ou GLM — et en
-v2, il échoue systématiquement.
+La raison est précise : sur le chemin v2 chiffré inchangé, une tâche confiée par un modèle ChatGPT natif à un modèle routé est illisible pour ce dernier. Une telle tâche échoue à cette frontière, par exemple lorsqu’un parent GPT lance un enfant Grok, Claude ou GLM. L’option expérimentale ci-dessous modifie la production des nouveaux messages sans déchiffrer les anciens.
+
+## V2 facultatif avec messages de tâche en clair
+
+**V2 · tâches en clair** (`v2-plaintext`) sélectionne V2 pour les nouvelles conversations sans activer la priorité V2 globale. Il conserve les noms de tâche V2, la hiérarchie, les suivis, l’annulation et la concurrence, et utilise le compilateur expérimental en clair pour les requêtes Responses ChatGPT canoniques admissibles. Les conversations existantes conservent leur sélection ; une mise à jour ne choisit pas ce mode automatiquement.
+
+Les choix du catalogue concernent les nouvelles sessions. Le compilateur suit le réglage actuel pour chaque requête canonique admissible ultérieure, y compris dans les sessions V2 existantes. La sélection V2 conservée ne dispense pas ces requêtes de compilation. Le mode et la valeur explicite `plaintextV2AgentMessages: true` activent chacun indépendamment le compilateur.
+
+Dans ce mode, la continuation locale par identifiant de réponse exige la même identité de clé API opencodex admise et le `thread-id` propre à la requête. Un fil parent ne donne pas accès à la tâche conservée d’un enfant. Sans l’une de ces identités, après un redémarrage du proxy ou pour les anciennes entrées de cache non liées, renvoyez la conversation complète sans `previous_response_id`. L’état conservé dans ce mode reste lié après changement de mode. En `v1` par défaut, l’état non lié conserve le comportement de continuation limité au fil parent, y compris pour les appelants de bouclage.
+
+Le tableau de bord demande de reconnaître que le texte peut rester dans l’historique Codex, les requêtes du fournisseur sélectionné et l’état local de réponse et de débogage, y compris les instantanés ou fichiers de débordement sur disque. HTTPS et l’authentification restent actifs ; aucun appel de récupération supplémentaire n’est ajouté. Les tâches déjà chiffrées ne sont pas déchiffrées, l’historique n’est pas réécrit et la désactivation ne supprime pas les copies conservées. Un comportement non pris en charge du client ou du backend peut toujours échouer. Les modes v1 et natif-v1/routé-v2 restent disponibles.
+
+```bash
+ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages
+```
+
+Pour la cible active, vérifiez ensuite `ocx v2 status --live --json`. Pour la cible locale, omettez `--live` dans les deux commandes et vérifiez `ocx v2 status --json` : l’état configuré et la convergence du catalogue ne prouvent pas qu’une délégation réelle réussit. Pour quitter ce mode, choisissez-en explicitement un autre ; la préférence indépendante `plaintextV2AgentMessages` est conservée.
## Ce que vous voyez alors
@@ -100,7 +113,7 @@ affiche l'avis une fois et attend votre réponse.
Chaque réponse est enregistrée et l'avis ne revient pas. Si vous fermez
l'avis sans répondre, il réapparaît à la prochaine ouverture du tableau de bord.
-Les changements de mode s'appliquent aux **nouvelles** sessions Codex. Lancez
+Les changements de choix du catalogue s'appliquent aux **nouvelles** sessions Codex ; le compilateur en clair suit le réglage actuel pour les requêtes admissibles, y compris les requêtes ultérieures des sessions V2 existantes. Lancez
une nouvelle session après votre choix. Si un hôte App durable affiche encore
l'ancienne surface, exécutez `ocx sync` et redémarrez cette surface Codex.
@@ -139,16 +152,14 @@ s'affichera plus et cette page relèvera de l'historique plutôt que du conseil.
## Changer de mode
-Dashboard, Models et Subagents proposent le même sélecteur v1/base/v2 et
-demandent tous confirmation avant base ou v2. Depuis la CLI :
+Dashboard, Models et Subagents proposent le sélecteur v1/base/v2 et l’option `v2-plaintext` ; cette dernière exige un consentement explicite. Depuis la CLI :
```bash
ocx v2 status
ocx v2 mode v1
```
-La CLI ne demande pas de confirmation. C'est le même paramètre : choisissez-le
-en tenant compte de ce que décrit cette page.
+La CLI ne demande pas de confirmation interactive ; l’entrée en `v2-plaintext` exige le drapeau de consentement indiqué ci-dessus.
## Limite de sous-agents simultanés
diff --git a/docs-site/src/content/docs/fr/reference/cli.md b/docs-site/src/content/docs/fr/reference/cli.md
index 2f16c1c5fce..1da670f95a2 100644
--- a/docs-site/src/content/docs/fr/reference/cli.md
+++ b/docs-site/src/content/docs/fr/reference/cli.md
@@ -35,6 +35,10 @@ Une commande réussie renvoie le code 0. Une syntaxe non valide, une commande ou
Les opérations de suppression destructive, d’importation, de consommation de crédits et de mise à jour qui annoncent une confirmation exigent `--yes` en mode non interactif. Ce drapeau constitue un consentement explicite : son absence ne doit jamais confirmer silencieusement l’opération.
+## Entrer dans le mode expérimental de sous-agents en clair
+
+Utilisez `ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages`. Les commandes génériques `config set` et `config import` refusent une nouvelle entrée dans ce mode, car la commande dédiée coordonne aussi la transition native. Avant de restaurer une configuration exportée contenant `multiAgentMode: "v2-plaintext"`, effectuez d’abord cette transition avec consentement, puis importez le fichier. Restaurer un mode déjà actif, modifier d’autres paramètres et quitter ce mode restent possibles. La préférence indépendante `plaintextV2AgentMessages` reste inchangée.
+
## Version et cibles de répartition internes
`ocx --version`, `ocx -v` et `ocx version` affichent une seule ligne de version exploitable par un script, puis se terminent.
diff --git a/docs-site/src/content/docs/fr/reference/cli/agents.md b/docs-site/src/content/docs/fr/reference/cli/agents.md
index a55deef9004..ac27bbf7361 100644
--- a/docs-site/src/content/docs/fr/reference/cli/agents.md
+++ b/docs-site/src/content/docs/fr/reference/cli/agents.md
@@ -27,9 +27,9 @@ qu'elle a déclenchée (`codexWebSearch` avec `--json`, une ligne `Codex config:
sinon) et renvoie vers `ocx sync` quand elle n'a pas pu avoir lieu. L'option fonctionne aussi
pour `vision`.
-### `ocx v2 |threads |mode-hint >`
+### `ocx v2 |threads |mode-hint >`
-Gérez l'indicateur de fonctionnalité Codex `multi_agent_v2` et le mode surface multi-agents à trois états.
+Gérez l'indicateur de fonctionnalité Codex `multi_agent_v2` et le mode surface multi-agents.
| Sous-commande | Actions |
| --- | --- |
@@ -39,6 +39,7 @@ Gérez l'indicateur de fonctionnalité Codex `multi_agent_v2` et le mode surface
| `mode v1` | Forcez tous les modèles à v1, désactivez la v2 native et préservez la limite de threads actifs. |
| `mode default` | Respecter les axes de surface du modèle en amont. |
| `mode v2` | Forcez tous les modèles à v2, activez la v2 native et préservez la limite de threads actifs. |
+| `mode v2-plaintext --acknowledge-plaintext-agent-messages` | Sélectionnez V2 pour les nouvelles sessions et activez les tâches en clair admissibles sans priorité V2 globale. |
| `threads ` | Définissez la limite de thread v1/v2 active sur un nombre entier d'au moins 1. |
| `mode-hint ` | Définissez l’indice de délégation proactive (mode Ultra) pour chaque modèle et effort. |
| `mode-hint --clear` | Supprimez l'indice pour que la politique dérivée de l'effort (ultra = proactive) reprenne. |
@@ -56,7 +57,7 @@ ocx v2 mode-hint --clear
La sous-commande `mode` écrit `multiAgentMode` dans la configuration opencodex et resynchronise le catalogue Codex.
Les changements de mode et d’indicateur déplacent la limite numérique actuelle de fils entre les clés v1/v2 Codex valides ;
une transition ratée restaure le `config.toml` original. Les modifications s'appliquent aux nouvelles sessions Codex, tandis que
-les sessions de course conservent leur surface épinglée.
+les sessions en cours conservent leur surface épinglée. Le compilateur en clair suit toutefois le réglage actuel pour les requêtes admissibles ultérieures, y compris dans les sessions V2 existantes.
`mode-hint` écrit `features.multi_agent_v2.multi_agent_mode_hint_text` en Codex
`$CODEX_HOME/config.toml` même si `multi_agent_v2` est actuellement désactivé. Le
@@ -66,8 +67,7 @@ la politique multi-agents dérivée de l'effort du codex-rs, donc tout modèle e
reçoit l’invite de délégation proactive. Cela ne change **pas** l'effort de raisonnement
lui-même. Un argument manquant ou une valeur contenant uniquement des espaces est rejeté ; seulement `--clear`
supprime l'indice. La bascule **on** du mode Ultra du tableau de bord Sous-agents a une
-gate : il nécessite que la fonctionnalité native soit activée avec une surface v2 explicite
-(`ocx v2 mode v2`); `ocx v2 on` à lui seul ne satisfait pas à cette porte du tableau de bord.
+gate : il nécessite soit la fonctionnalité native activée avec `ocx v2 mode v2`, soit le mode `v2-plaintext`, fondé sur les choix du catalogue sans priorité globale. `ocx v2 on` à lui seul ne satisfait pas à cette porte du tableau de bord.
## Routage combiné
diff --git a/docs-site/src/content/docs/fr/reference/configuration/agents.md b/docs-site/src/content/docs/fr/reference/configuration/agents.md
index 1d6fab85615..8578d00ee4f 100644
--- a/docs-site/src/content/docs/fr/reference/configuration/agents.md
+++ b/docs-site/src/content/docs/fr/reference/configuration/agents.md
@@ -9,7 +9,7 @@ Les paramètres des agents déterminent la surface de collaboration Codex annonc
| Champ | Type | Valeur par défaut | Signification |
| --- | --- | --- | --- |
-| `multiAgentMode?` | `"v1" \| "default" \| "v2"` | `"default"` | `v1` marque tous les modèles du catalogue comme compatibles v1 ; `v2` les marque tous comme compatibles v2. `default` rétablit les choix imposés en amont (Sol/Terra en v2, Luna en v1) et suit sinon l’indicateur natif `multi_agent_v2`. S’applique aux nouvelles sessions. |
+| `multiAgentMode?` | `"v1" \| "default" \| "v2" \| "v2-plaintext"` | `"default"` | `v1` marque tous les modèles du catalogue comme compatibles v1 ; `v2` les marque tous comme compatibles v2. `default` rétablit les choix imposés en amont (Sol/Terra en v2, Luna en v1) et suit sinon l’indicateur natif `multi_agent_v2`. `v2-plaintext` active aussi la transmission expérimentale des tâches en clair et désactive la priorité globale. Les choix du catalogue s’appliquent aux nouvelles sessions ; la compilation activée affecte aussi les requêtes ultérieures admissibles des sessions V2 existantes. |
| `keepNativeChatGptOnV1?` | `boolean` | `false` | Lorsque `multiAgentMode` vaut `"v2"`, marque les lignes natives ChatGPT (Sol/Terra et les autres modèles du backend ChatGPT) comme v1. Les parents routés restent en v2. Utilisez cette option pour qu'un parent ChatGPT puisse encore lancer Grok ou Claude — les tâches enfants v2 natives sont chiffrées par le service en amont ([#92](https://github.com/lidge-jun/opencodex/issues/92)). Ignoré en `v1` et `default`. |
| `subagentModels?` | `string[]` | `gpt-6-astra`, `gpt-6.1-sol`, `gpt-6-luna` | Jusqu’à cinq identifiants natifs non qualifiés, qualifiés par un compte `/` ou routés `provider/model`, affichés en tête du sélecteur de sous-agents. Le tableau de bord propose les identifiants natifs non qualifiés et routés pour les nouveaux choix. Lors de l’enregistrement, il conserve les identifiants exacts de compte déjà configurés, même absents du catalogue actuel. Pour ajouter un nouvel identifiant exact de compte, utilisez `ocx agent subagents set` ou modifiez la configuration. Après la [migration unique vers Astra](/reference/configuration/agents/#astra-roster-upgrade), une liste explicitement vide est conservée. |
| `injectionModel?` | `string` | — | Modèle de sous-agent natif ou routé privilégié dans les consignes de délégation v2 produites par le proxy. |
@@ -22,13 +22,18 @@ Les paramètres des agents déterminent la surface de collaboration Codex annonc
| `subagentModelFallbackPollMs?` | `number` | `60000` | Durée de mise en cache de la sonde de disponibilité. Les valeurs inférieures à 1000 ms sont remplacées par la valeur par défaut. |
| `effortCap?` | `string` | — | Plafond strict appliqué aux tours principaux v2 admissibles et aux tours enfants créés qui portent les marqueurs requis. Accepte les valeurs de `low` à `ultra`. |
| `subagentEffortCap?` | `string` | — | Plafond supplémentaire réservé aux tours enfants créés. Lorsque les deux plafonds s’appliquent, le plus bas l’emporte. |
+| `plaintextV2AgentMessages?` | `boolean` | — (non défini) | Option expérimentale : la valeur explicite `true` ou le mode `multiAgentMode: "v2-plaintext"` active la transmission en clair des arguments de message `spawn_agent`, `send_message` et `followup_task` admissibles. |
| `agentTaskRecovery?` | `object` | — | Mécanisme expérimental, soumis à activation explicite, pour récupérer les tâches v2 chiffrées par le service en amont lorsqu’elles sont envoyées à des fournisseurs routés. Désactivé sauf si `enabled: true` ; voir [Récupération des tâches v2 chiffrées](#récupération-des-tâches-v2-chiffrées). |
-Gérez la surface depuis le tableau de bord ou avec `ocx v2 status|on|off|mode |keep-native-v1 |threads |mode-hint `. Les changements de mode s’appliquent aux nouvelles sessions. `maxConcurrentThreadsPerSession` est un champ de `PUT /api/v2`, et non une clé de `config.json`. Après l’activation de v2, `ocx v2 threads ` écrit `max_concurrent_threads_per_session` sous `[features.multi_agent_v2]` dans le fichier `$CODEX_HOME/config.toml` de Codex.
+Gérez la surface depuis le tableau de bord ou avec `ocx v2 status|on|off|mode |keep-native-v1 |threads |mode-hint `. L’entrée en `v2-plaintext` exige `--acknowledge-plaintext-agent-messages`. Les changements de choix du catalogue s’appliquent aux nouvelles sessions ; le compilateur en clair suit le réglage actuel pour les requêtes admissibles, y compris les requêtes ultérieures des sessions V2 existantes. `maxConcurrentThreadsPerSession` est un champ de `PUT /api/v2`, et non une clé de `config.json`. Après l’activation de v2, `ocx v2 threads ` écrit `max_concurrent_threads_per_session` sous `[features.multi_agent_v2]` dans le fichier `$CODEX_HOME/config.toml` de Codex.
Le **mode Ultra** — accessible depuis l’interrupteur Sous-agents du tableau de bord, le champ `multiAgentModeHintText` de `PUT /api/v2` et `ocx v2 mode-hint` — écrit `features.multi_agent_v2.multi_agent_mode_hint_text` dans le fichier `$CODEX_HOME/config.toml` de Codex. La commande CLI `ocx v2 mode-hint` conserve cette clé même lorsque `multi_agent_v2` est désactivé ; elle n’active ni ne désactive la fonctionnalité. Cette indication remplace la politique multi-agents que codex-rs déduit du niveau d’effort : tous les modèles et tous les niveaux d’effort reçoivent alors le prompt de délégation Proactive. Elle ne modifie **pas** le niveau d’effort de raisonnement.
-La valeur `null` supprime la clé et rétablit la politique fondée sur l’effort (proactive avec ultra, explicite dans les autres cas). Les valeurs vides ou composées uniquement d’espaces sont rejetées, car une substitution vide mais présente masquerait même le message Proactive associé au niveau ultra. Pour que l’interrupteur du mode Ultra soit **activé** dans la page Sous-agents du tableau de bord, la fonctionnalité native doit être active et la surface v2 doit être explicitement sélectionnée (`multiAgentMode: "v2"`, équivalent à `ocx v2 mode v2`). La seule commande `ocx v2 on` ne satisfait pas cette condition du tableau de bord.
+La valeur `null` supprime la clé et rétablit la politique fondée sur l’effort (proactive avec ultra, explicite dans les autres cas). Les valeurs vides ou composées uniquement d’espaces sont rejetées, car une substitution vide mais présente masquerait même le message Proactive associé au niveau ultra. Pour activer l’interrupteur du mode Ultra, sélectionnez explicitement `multiAgentMode: "v2"` avec la fonctionnalité native active, ou `multiAgentMode: "v2-plaintext"`, qui utilise les choix du catalogue sans priorité globale. La seule commande `ocx v2 on` ne satisfait pas cette condition du tableau de bord.
+
+Sur la route Responses ChatGPT canonique (`adapter: "openai-responses"`, `authMode: "forward"`, `https://chatgpt.com/backend-api/codex`), la valeur explicite `plaintextV2AgentMessages: true` ou le mode `v2-plaintext` active indépendamment le compilateur des messages de tâche admissibles. Les autres destinations et les clients non Responses sont exclus. Le mode `v2-plaintext` sélectionne V2 pour les nouvelles conversations sans modifier la préférence indépendante `plaintextV2AgentMessages`. Le compilateur suit le réglage actuel pour les requêtes admissibles ultérieures, y compris dans les sessions V2 existantes. Il ne déchiffre pas les tâches existantes et ne réécrit pas l’historique. Sa désactivation ne supprime pas les copies déjà conservées dans l’historique, les requêtes du fournisseur ou l’état local de réponse et de débogage.
+
+Une entrée dans ce mode par `PUT /api/v2` exige `plaintextAgentMessagesAcknowledged: true`. Utilisez sinon la confirmation du tableau de bord ou `ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages`.
L’API de gestion expose `GET`/`PUT /api/v2`, `/api/injection-model`, `/api/effort-caps`, `/api/subagent-models` et `/api/subagent-model-fallback`. Les mises à jour du modèle d’injection sont partielles ; le prompt personnalisé correspond au champ `prompt` de cette API.
diff --git a/docs-site/src/content/docs/guides/codex-integration.md b/docs-site/src/content/docs/guides/codex-integration.md
index 9f71b271f76..36e3c79048c 100644
--- a/docs-site/src/content/docs/guides/codex-integration.md
+++ b/docs-site/src/content/docs/guides/codex-integration.md
@@ -515,8 +515,13 @@ Retrying only the same ID cannot recover missing state.
The same refusal applies when the referenced state belongs to a different client task scope,
including when the new request appears to carry complete input. The proxy cannot prove that input
is complete, so it does not silently remove `previous_response_id` or reveal whether matching state
-exists. Retry with the complete conversation and omit `previous_response_id`; matching scopes and
-legacy continuations where both scopes are absent or blank continue to replay normally.
+exists. When `v2-plaintext` mode or the `plaintextV2AgentMessages` flag is enabled, local replay requires the same admitted OpenCodex caller and the request's own nonblank
+`thread-id`; a parent thread, loopback address, upstream credential, or placeholder key is not
+that identity. Clients without an admitted caller principal and requests without their own thread must resend the complete
+conversation without `previous_response_id`. The default loopback Codex and DSH configurations
+do not establish that caller identity. State retained while either setting is enabled remains bound after disabling it.
+Default `v1` keeps the existing parent-thread-scoped continuation behavior for unbound state,
+including default loopback callers. This is separate from native upstream-owned Responses IDs.
The same recovery signal applies to every routed destination, because only the native Responses
passthrough can answer a turn whose history this proxy lost — it forwards `previous_response_id`
diff --git a/docs-site/src/content/docs/guides/sub-agent-surface.md b/docs-site/src/content/docs/guides/sub-agent-surface.md
index e4a98fb0c04..87487cc4dc2 100644
--- a/docs-site/src/content/docs/guides/sub-agent-surface.md
+++ b/docs-site/src/content/docs/guides/sub-agent-surface.md
@@ -430,8 +430,7 @@ tier that Codex converts to `max`; opencodex then maps or clamps the value for t
The model context cap is independent of sub-agent mode. Configure it on the Models page; native
OpenAI models retain their real context windows.
-The experimental `plaintextV2AgentMessages` field is unset in a fresh config and runs only when set
-to `true`. The caller must use the Responses wire, and the final destination must use
+The experimental `plaintextV2AgentMessages` field is unset in a fresh config. Explicit `true` or the separately selected `v2-plaintext` mode enables the compiler. That mode also selects V2 for new chats without enabling the global override; leaving it preserves the independent field. Compilation follows the current setting on subsequent eligible requests, including existing V2 sessions. Existing ciphertext is not decrypted or stored history rewritten, and disabling does not delete retained copies. The caller must use the Responses wire, and the final destination must use
`adapter: "openai-responses"`, `authMode: "forward"`, and the exact base URL
`https://chatgpt.com/backend-api/codex`. OpenAI API-key providers, custom compatible gateways,
routes to other providers, and non-Responses callers are excluded. For an eligible new native
diff --git a/docs-site/src/content/docs/guides/subagent-v1-default.md b/docs-site/src/content/docs/guides/subagent-v1-default.md
index f97a8484b00..49eb2d6d48b 100644
--- a/docs-site/src/content/docs/guides/subagent-v1-default.md
+++ b/docs-site/src/content/docs/guides/subagent-v1-default.md
@@ -7,12 +7,27 @@ OpenCodex installs with the sub-agent surface set to **v1**. The Dashboard, Mode
pages all ask you to confirm before moving to **base** or **v2**, and this page is what that
confirmation links to. The CLI does not prompt.
-The reason is narrow and specific: by default on v2, a task handed from a ChatGPT-native model to a routed
+The reason is narrow and specific: on the unchanged encrypted v2 path, a task handed from a ChatGPT-native model to a routed
model cannot be read by the routed model. That is the single most common way people delegate —
-a GPT parent spawning a Grok, Claude or GLM child — and on v2 it fails by default.
-Explicit exceptions are `keepNativeChatGptOnV1`, which keeps native ChatGPT entries on v1 while
-routed entries use v2; an authorized destination that can process the encrypted task with
-`allowEncryptedV2AgentTasks: true`; or experimental `agentTaskRecovery`, described below.
+a GPT parent spawning a Grok, Claude or GLM child. An unreadable encrypted task fails at that boundary. The experimental opt-in below changes how new task messages are produced; it does not decrypt existing ones.
+
+Explicit exceptions are `keepNativeChatGptOnV1`, which keeps native ChatGPT entries on v1 while routed entries use v2; an authorized destination that can process the encrypted task with `allowEncryptedV2AgentTasks: true`; or experimental `agentTaskRecovery`, described below.
+
+## Optional V2 with plaintext task messages
+
+**V2 · plaintext tasks** (`v2-plaintext`) selects V2 for new chats while leaving the global V2 override off. It preserves V2 task names, hierarchy, follow-up messages, cancellation and concurrency, and reuses the experimental plaintext compiler for eligible canonical ChatGPT Responses requests. Existing chats retain their recorded selection. This is an additional explicit option; installing an update does not select it for you.
+
+Catalog pins apply to new sessions. The compiler follows the current setting on every eligible canonical ChatGPT request, including subsequent requests from existing V2 sessions. Keeping a session's recorded V2 selection does not exempt its later requests from compilation.
+
+In `v2-plaintext` mode, local response-ID continuations require the same admitted opencodex API-key identity and the request's own `thread-id`. A parent thread ID does not grant access to a child's retained task. Without either identity, after a proxy restart, or for older unbound cache entries, resend the full conversation without `previous_response_id`. State retained in this mode remains bound after switching modes. Default `v1` keeps the existing parent-thread-scoped continuation behavior for unbound state, including loopback callers. Opting out still leaves independently retained copies on disk.
+
+The dashboard requires acknowledgment that task text can remain in Codex history, selected-provider requests and local response/debug state, including on-disk continuation snapshots or spills. HTTPS and authentication remain enabled. No recovery model call is added. Existing ciphertext is not decrypted and stored history is not rewritten. Disabling the compiler does not delete retained copies. Unsupported backend/client behavior can still fail. The ordinary v1 and mixed native-v1/routed-v2 modes remain available.
+
+```bash
+ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages
+```
+
+Read `ocx v2 status --live --json` afterward for the live target. For the local target, omit `--live` from both commands and read `ocx v2 status --json`; configured state and catalog convergence are distinct from a successful real delegation. To leave this mode, explicitly choose another mode. Independently set `plaintextV2AgentMessages` values are preserved.
## What you see when it happens
@@ -42,10 +57,9 @@ stays in that backend. OpenCodex never had it, so there is nothing for a proxy t
nothing to rewrite — the value really is ciphertext, not plaintext behind a flag. That is why
this is structural rather than a misconfiguration: no proxy-side setting enables local decryption.
-No proxy-side setting enables local decryption. Experimental `agentTaskRecovery` can instead ask the ChatGPT backend to recover eligible tasks; it does not decrypt their ciphertext locally. Its authorization, eligibility and failure limits described above still apply.
+Experimental `agentTaskRecovery` can instead ask the ChatGPT backend to recover eligible tasks; it does not decrypt their ciphertext locally. Its authorization, eligibility and failure limits described above still apply.
-Three topologies are unaffected, which is worth stating because it explains the shape of the
-failure rather than the failure being mysterious:
+The following comparison describes the encrypted v2 path without plaintext compilation:
| Topology | v1 | v2 |
| --- | --- | --- |
@@ -72,13 +86,14 @@ OpenCodex recorded the consequence as [#92](https://github.com/lidge-jun/opencod
closed as not planned: nothing in this repository can fix it, so the issue is a pointer to the
upstream work rather than a task waiting on a maintainer here.
-## What the three modes do now
+## What the modes do now
| Mode | Surface | When to choose it |
| --- | --- | --- |
| **v1** (default) | Every model advertises the classic namespaced spawn tools. A spawn can name another model directly. | Anyone who delegates across providers. This is the shipped default. |
| **base** | Upstream model pins: Sol and Terra use v2, Luna uses v1, unpinned models follow Codex's own flag. | You want Codex's intended per-model surface and you only delegate within one provider. |
| **v2** | Every model advertises the flat concurrent tools. | You want the newer concurrent session model and your parent and child are on the same side of the boundary. |
+| **v2-plaintext** | V2 for new sessions, with the global override off and plaintext compilation for eligible requests. | You accept the retention of plaintext task messages and want the experimental path. |
base is listed second rather than first because its pins put Sol and Terra — the two models most
people delegate *from* — on v2. base is not a middle setting for this problem; for a
@@ -95,7 +110,7 @@ existing setting; the dashboard raises the notice once and waits for an answer.
Either answer is recorded, and the notice does not come back. Dismissing it without answering
leaves it for the next time you open the dashboard.
-Mode changes apply to **new** Codex sessions. Start a new session after choosing; if a long-running
+Catalog pin changes apply to **new** Codex sessions; the plaintext compiler follows the current setting for eligible requests, including later requests from existing V2 sessions. Start a new session after choosing; if a long-running
App host still shows the old surface, run `ocx sync` and restart that surface.
## If you want v2 anyway
diff --git a/docs-site/src/content/docs/ja/guides/codex-integration.md b/docs-site/src/content/docs/ja/guides/codex-integration.md
index 57d16985e00..04806799c35 100644
--- a/docs-site/src/content/docs/ja/guides/codex-integration.md
+++ b/docs-site/src/content/docs/ja/guides/codex-integration.md
@@ -117,6 +117,8 @@ Windows では、ChatGPT/Codex アプリが `%USERPROFILE%\\.codex` を読み取
専用プロバイダー モードでは、`requires_openai_auth = true` は Codex App/TUI アカウント ゲート サーフェスをネイティブ Codex と一致させます。 opencodex は WebSocket 経由で `/v1/responses` も提供します。専用プロバイダーは、`"websockets": true` の場合にのみ `supports_websockets = true` をアドバタイズします。ループバック時 Codex の組み込みプロバイダーは最初に WebSocket を試行し、無効になったプロキシが `426` を返すため、Codex は HTTP/SSE にフォールバックします。
+`v2-plaintext` モードまたは `plaintextV2AgentMessages` フラグが有効な場合、ローカル replay には同じ許可された OpenCodex 呼び出し元と、リクエスト自身の空白でない `thread-id` が必要です。親スレッド、ループバックアドレス、上流の認証情報、プレースホルダーキーはそのアイデンティティではありません。許可された呼び出し元プリンシパルを持たないクライアントや、独自のスレッドを持たないリクエストは、`previous_response_id` を付けずに完全な会話を再送する必要があります。デフォルトのループバック Codex および DSH 構成は、その呼び出し元アイデンティティを確立しません。どちらかの設定が有効な間に保持された状態は、無効化後もそのアイデンティティに結び付いたままです。デフォルトの `v1` では、結び付けられていない状態について、デフォルトのループバック呼び出し元を含め、従来の親スレッドを単位とする継続動作が維持されます。これは上流が所有するネイティブ Responses ID とは別です。
+
## スレッドのアイデンティティと履歴
デフォルトのループバック形式では、Codex のネイティブ `openai` プロバイダーでタグ付けされた新しいスレッドが維持されるため、通常の再開履歴には再マッピングが必要ありません。同期と復元は、一致するバックアップマニフェストだけを適用し、各スレッドの元のプロバイダー、ソース、イベントマーカーを正確に復元します。マニフェストのない `opencodex` 行は変更されません。従来の再ラベル付けを明示的に強制する場合にだけ `ocx recover-history --legacy-openai --yes` を使用してください。このコマンドは意図的に広範囲です。ユーザーメッセージを持ち、現在 `opencodex` とタグ付けされているすべてのスレッドを `openai` に変更し、`exec` を `cli` に正規化してイベントマーカーを設定します。正当な専用プロバイダー履歴も対象です。状態をバックアップし、この全範囲を意図する場合にのみ使用してください。非ループバック専用プロバイダー モードでは、アクティブな間は `opencodex` プロバイダーの下で履歴がミラーリングされ、終了時にバックアップされたメタデータが復元されます。履歴を変更しないように `syncResumeHistory: false` を設定します。
diff --git a/docs-site/src/content/docs/ja/guides/sub-agent-surface.md b/docs-site/src/content/docs/ja/guides/sub-agent-surface.md
index 25a084a0fca..2beb5054b0e 100644
--- a/docs-site/src/content/docs/ja/guides/sub-agent-surface.md
+++ b/docs-site/src/content/docs/ja/guides/sub-agent-surface.md
@@ -13,12 +13,13 @@ description: Codex がすべてのモデルにわたってサブエージェン
|モード | Codex が得られるもの |誰がそれを選ぶべきですか |
| --- | --- | --- |
-| **v1** |クラシックな名前空間の `spawn_agent`、`send_input`、`resume_agent`、および `close_agent` ツール。スポーンは別のモデルを直接選択できます。 |さまざまなプロバイダー間で信頼できる委任を必要とする初心者、特にネイティブからルーティングされる子。 |
-| **ベース** (デフォルト) |アップストリーム モデルのピン: GPT-5.6 Sol/Terra は v2 を使用し、Luna は v1 を使用し、ピンなしモデルは Codex の `multi_agent_v2` 機能フラグに従います。 |ほとんどのユーザー。グローバルに強制することなく、Codex が各モデルに対して意図したサーフェスに従います。 |
+| **v1** (新規インストールのデフォルト) |クラシックな名前空間の `spawn_agent`、`send_input`、`resume_agent`、および `close_agent` ツール。スポーンは別のモデルを直接選択できます。 |さまざまなプロバイダー間で信頼できる委任を必要とする初心者、特にネイティブからルーティングされる子。 |
+| **ベース** |アップストリーム モデルのピン: GPT-5.6 Sol/Terra は v2 を使用し、Luna は v1 を使用し、ピンなしモデルは Codex の `multi_agent_v2` 機能フラグに従います。 |ほとんどのユーザー。グローバルに強制することなく、Codex が各モデルに対して意図したサーフェスに従います。 |
| **v2** |フラット `spawn_agent`、`send_message`、`followup_task`、`interrupt_agent`、およびエージェント リスト ツール (同時セッションあり)。 |新しい同時ワークフローを必要とし、モデルの継承と以下の暗号化されたタスクの制限を理解しているユーザー。 |
+| **v2-plaintext** | V2 | 新しいセッションで V2 を選び、グローバル強制を無効にしたまま対象タスクを平文で送信します。開始には `--acknowledge-plaintext-agent-messages` が必要です。 |
:::tip[わからない？]
-**ベース**から始めます。プロバイダー間の委任が予測どおりに機能する必要がある場合は、**v1** を選択してください。すべてのカタログ エントリにわたって特に新しいセッション モデルが必要な場合にのみ、**v2** を強制します。
+新規インストールのデフォルトである **v1** から始めます。アップストリームのピンに従う場合は **ベース** を選択してください。すべてのカタログ エントリにわたって特に新しいセッション モデルが必要な場合にのみ、**v2** を強制します。
:::
## 仕組み
@@ -27,6 +28,7 @@ description: Codex がすべてのモデルにわたってサブエージェン
- **v1** はすべてのモデルに `multi_agent_version = "v1"` を刻印します。
- **base** は上流のピンを復元します。固定されていないエントリは、ネイティブ `multi_agent_v2` 機能フラグに従います。
+- **v2-plaintext** はグローバル V2 強制を無効にしてすべてのモデルを V2 に固定し、対象の正規 ChatGPT 経路でタスクメッセージを平文にコンパイルします。
- **v2** はすべてのモデルに `multi_agent_version = "v2"` のスタンプを押します。ただし **ChatGPT を v1 に保つ** を有効にした場合は例外で、ChatGPT ネイティブの行は `"v1"` のまま、ルーティング/コンボの行は `"v2"` になります。
opencodex は、これを最終パスとしてライブ `/v1/models` カタログとディスクに同期されたカタログの両方に適用します。そのため、モードの変更は、新しく作成されたアプリ、CLI、および TUI セッションに一貫して影響します。
@@ -132,7 +134,7 @@ opencodex は、空のタスクまたは読み取り不可能なタスクを転
### GUI
-- **ダッシュボード** → 最初の統計セル: **v1**、**base**、または **v2** を選択します。
+- **ダッシュボード** → 最初の統計セル: **v1**、**base**、**v2**、または **v2-plaintext** を選択します。平文モードに入るには表示される同意確認が必要です。
- **モデル** → 一番上の行のセグメント化されたコントロール: 同じグローバル モードを選択します。
- **ダッシュボード** → **サブエージェント委任**: ガイダンス モデル/作業量およびネイティブ デフォルト オプトインを設定します。
- **サブエージェント**: ロスターを選択して順序付けし、グローバル フォールバック チェーンを構成します。
@@ -146,6 +148,7 @@ ocx v2 status
ocx v2 mode v1
ocx v2 mode default
ocx v2 mode v2
+ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages
ocx v2 threads 8
```
@@ -173,6 +176,8 @@ ocx agent effort set --subagent max
| `/api/subagent-models` |最大 5 つのモデルの注文リスト |
| `/api/subagent-model-fallback` |グローバルフォールバック順序とポーリング間隔 |
+`PUT /api/v2` で新たに `v2-plaintext` に入るには、`multiAgentMode` とともに `plaintextAgentMessagesAcknowledged: true` を指定します。
+
例えば：
```bash
@@ -205,7 +210,7 @@ Codex は最大 5 つの提示枠を、カタログから priority 順に埋め
### モードの変更は実行中のセッションに影響しますか?
-いいえ。モードを変更した後、新しい Codex セッションを開始します。長時間実行されているアプリ ホストで依然として古いカタログ状態が表示される場合は、`ocx sync` を実行して、その Codex サーフェスを再起動します。
+カタログの選択は新しいセッションに適用され、実行中のセッションは固定されたサーフェスを維持します。ただし平文コンパイラーの設定は既存 V2 セッションの後続の対象リクエストにも適用されます。長時間実行されているアプリ ホストで依然として古いカタログ状態が表示される場合は、`ocx sync` を実行して、その Codex サーフェスを再起動します。
### 推論負荷
@@ -214,3 +219,5 @@ Codex は最大 5 つの提示枠を、カタログから priority 順に埋め
### コンテキストキャップ
モデル コンテキストの上限は、サブエージェント モードから独立しています。 「モデル」ページで設定します。ネイティブ OpenAI モデルは、実際のコンテキスト ウィンドウを保持します。
+
+実験的な `plaintextV2AgentMessages` は新規設定では未設定です。明示的な `true` または独立した `v2-plaintext` モードのどちらでもコンパイラーが有効になり、モードを離れても独立したフラグは保持されます。呼び出し元は Responses を使い、最終送信先は `adapter: "openai-responses"`、`authMode: "forward"`、ベース URL `https://chatgpt.com/backend-api/codex` の正規 ChatGPT 経路である必要があります。他のプロバイダー、互換ゲートウェイ、非 Responses 呼び出しは対象外です。既存の暗号文は復号せず履歴も書き換えず、無効化しても保持済みのコピーは削除しません。[詳細](/reference/configuration/agents/#plaintext-v2-agent-messages)を参照してください。
diff --git a/docs-site/src/content/docs/ja/guides/subagent-v1-default.md b/docs-site/src/content/docs/ja/guides/subagent-v1-default.md
index 9643e73c7dc..8ed404e3352 100644
--- a/docs-site/src/content/docs/ja/guides/subagent-v1-default.md
+++ b/docs-site/src/content/docs/ja/guides/subagent-v1-default.md
@@ -3,9 +3,17 @@ title: サブエージェントの既定サーフェスが v1 である理由
description: v2 の暗号化タスクの制約で何が動かなくなるか、OpenCodex が v1 を既定とする理由、v2 を使う方法を説明します。
---
+カタログの選択は新しいセッションに適用されますが、有効なコンパイラーは既存の V2 セッションからの後続リクエストも、正規の ChatGPT Responses 経路で条件を満たす場合に処理します。無効化しても保持済みのコピーは削除されず、保存済み履歴も書き換えません。V2 のタスク名、階層、フォローアップ、キャンセル、同時実行は維持されます。更新によって自動的に有効にはなりません。
+
+**実験的な選択肢: `v2-plaintext`。** グローバル V2 強制を有効にせず、新しいチャットで V2 を選択します。明示的な確認後、対象となる新しいタスクメッセージをアプリケーション層の平文で送信します。HTTPS と認証は維持されます。タスクの本文は履歴、選択したプロバイダーへのリクエスト、ローカルのデバッグ状態に残る可能性があります。既存の暗号文は復号しません。
+
+コマンドは `ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages` です。ライブ対象は `ocx v2 status --live --json` で確認します。ローカル対象では両方のコマンドから `--live` を省略し、`ocx v2 status --json` で確認します。設定状態とカタログの同期は実際の委任の成功とは別です。終了するには別のモードを明示的に選びます。独立した `plaintextV2AgentMessages` の値は保持されます。ダッシュボードでは、履歴、プロバイダーへのリクエスト、ディスク上の継続スナップショットや spill を含むローカル応答・デバッグ状態にタスク本文が残り得ることへの同意が必要です。復旧モデル呼び出しは追加されません。未対応のバックエンドやクライアントでは失敗する場合があります。通常の v1 とネイティブ v1／ルーティング済み v2 の混合モードも利用できます。
+
+平文モードのローカル response ID 継続には、同じ許可済み opencodex API キーのアイデンティティとリクエスト自身の `thread-id` が必要です。親スレッド ID では子の保持タスクにアクセスできません。いずれかがない場合、プロキシ再起動後、または古い未バインドのキャッシュでは、`previous_response_id` を付けずに会話全体を再送します。保持された状態はモード切り替え後もバインドされたままです。既定の `v1` はループバック呼び出し元を含む未バインド状態について従来の親スレッド単位の継続を維持します。
+
OpenCodex をインストールすると、サブエージェントのサーフェスは **v1** に設定されます。Dashboard、Models、Subagents の各ページでは、**base** または **v2** に移る前に確認を求め、その確認からこのページにリンクします。CLI では確認は表示されません。
-理由は明確です。v2 では、ChatGPT ネイティブモデルからルーティングされたモデルへ渡すタスクを、受け取ったモデルが読めません。GPT の親から Grok、Claude、GLM の子を作るのは一般的な委任方法ですが、v2 では毎回失敗します。
+理由は明確です。従来の暗号化された v2 経路では、ChatGPT ネイティブモデルからルーティングされたモデルへ渡すタスクを、受け取ったモデルが読めません。GPT の親から Grok、Claude、GLM の子を作るのは一般的な委任方法ですが、読めない暗号化タスクはその境界で失敗します。平文の選択肢は新しいタスクの生成方法を変えますが、既存の暗号文は復号しません。
## 発生時に表示されるもの
@@ -50,13 +58,14 @@ v2 では親が ChatGPT バックエンドで生成された `encrypted_content`
OpenCodex は結果を [#92](https://github.com/lidge-jun/opencodex/issues/92) に記録し、対応予定なしとして閉じました。このリポジトリ内では修正できないため、ここでの作業待ちではなく、上流の作業への参照です。
-## 現在の 3 つのモード
+## 現在のモード
| モード | サーフェス | 選ぶ場合 |
| --- | --- | --- |
| **v1**（既定） | 全モデルが従来の名前空間付き生成ツールを公開します。生成時に別のモデルを直接指定できます。 | プロバイダー間で委任する場合。出荷時の既定値です。 |
| **base** | 上流のモデル固定設定です。Sol と Terra は v2、Luna は v1、固定されないモデルは Codex 自身のフラグに従います。 | Codex がモデルごとに意図したサーフェスを使い、同じプロバイダー内だけで委任する場合。 |
| **v2** | 全モデルがフラットな同時実行ツールを公開します。 | 新しい並行セッションモデルを使い、親と子が境界の同じ側にいる場合。 |
+| **v2-plaintext** | グローバル強制を無効にして V2 に固定し、対象の正規 ChatGPT リクエストでタスクメッセージを平文化します。 | 平文の保持に同意し、V2 でプロバイダーをまたいで委任したい場合。 |
base が先頭でなく 2 番目なのは、委任元としてよく使われる Sol と Terra が v2 に固定されるためです。この問題にとって base は中間設定ではなく、ChatGPT からルーティングされた子を作る場合は v2 と同様に動作します。
@@ -69,7 +78,7 @@ base が先頭でなく 2 番目なのは、委任元としてよく使われる
どちらの回答も記録され、通知は再表示されません。回答せずに閉じると、次にダッシュボードを開いたときに再表示されます。
-モード変更は**新しい** Codex セッションに適用されます。変更後に新しいセッションを開始してください。長時間動作している App ホストで以前のサーフェスが残る場合は、`ocx sync` を実行してそのサーフェスを再起動します。
+カタログのモード選択は**新しい** Codex セッションに適用されます。平文コンパイラーは既存 V2 セッションの後続の対象リクエストにも適用されます。変更後に新しいセッションを開始してください。長時間動作している App ホストで以前のサーフェスが残る場合は、`ocx sync` を実行してそのサーフェスを再起動します。
## それでも v2 を使う場合
@@ -88,7 +97,7 @@ base が先頭でなく 2 番目なのは、委任元としてよく使われる
## モードを変更する
-Dashboard、Models、Subagents には同じ v1/base/v2 スイッチがあり、いずれも base または v2 の前に確認を求めます。CLI では次を実行します。
+Dashboard、Models、Subagents には同じ v1/base/v2/v2-plaintext スイッチがあり、平文モードに入る際は同意を求めます。base または v2 の前にも確認を求めます。CLI では次を実行します。
```bash
ocx v2 status
diff --git a/docs-site/src/content/docs/ja/reference/cli.md b/docs-site/src/content/docs/ja/reference/cli.md
index c43b4363845..1184ae3ebf9 100644
--- a/docs-site/src/content/docs/ja/reference/cli.md
+++ b/docs-site/src/content/docs/ja/reference/cli.md
@@ -38,6 +38,8 @@ Windows x64 インストールの観測は [`attest` コマンド](/ja/reference
確認を通知する破壊的な削除、インポート、クレジット消費、更新操作には、非対話型での `--yes` が必要です。このフラグは明示的なオプトインです。これを省略しても、黙ってアクションを確認してはなりません。
+実験的な平文サブエージェントモードに入るには `ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages` を使います。専用コマンドはネイティブモードの移行も調整するため、汎用の `config set` と `config import` はこのモードへの新規移行を拒否します。`multiAgentMode: "v2-plaintext"` を含むエクスポート設定を復元する前に、同意付きの移行を完了してからインポートしてください。すでに有効なモードの復元、他の設定の変更、平文モードからの退出は可能です。独立した `plaintextV2AgentMessages` の設定は変わりません。
+
## バージョンと内部ディスパッチターゲット
`ocx --version`、`ocx -v`、および `ocx version` は、スクリプト対応バージョンの 1 行を出力して終了します。
diff --git a/docs-site/src/content/docs/ja/reference/cli/agents.md b/docs-site/src/content/docs/ja/reference/cli/agents.md
index 961c01c9bf0..61977a82310 100644
--- a/docs-site/src/content/docs/ja/reference/cli/agents.md
+++ b/docs-site/src/content/docs/ja/reference/cli/agents.md
@@ -24,19 +24,23 @@ Codex 側の書き込み（`--json` では `codexWebSearch`、それ以外では
`Codex config:` 行）を報告し、書き込みできなかった場合は `ocx sync` を案内します。
このフラグは `vision` でも機能します。
-### `ocx v2 |threads >`
+### `ocx v2 |keep-native-v1 |threads |mode-hint >`
-Codex `multi_agent_v2` 機能フラグとスリーステート マルチエージェント サーフェス モードを管理します。
+Codex `multi_agent_v2` 機能フラグと4 状態のマルチエージェント サーフェス モードを管理します。
|サブコマンド |アクション |
| --- | --- |
| `status` (デフォルト) |現在の v2 フラグ、マルチエージェント モード、およびスレッドの同時実行性をレポートします。 |
-| `on` | `multi_agent_v2` 機能を有効にし、カタログを再同期します。 |
+| `on` | グローバル `multi_agent_v2` を有効にし、ローカル変更ではカタログを再同期します。v2 ハイブリッドのピンが有効な間は拒否されます。 |
| `off` | `multi_agent_v2` 機能を無効にし、カタログを再同期します。 |
| `mode v1` |すべてのモデルを強制的に v1 にし、ネイティブ v2 を無効にして、アクティブなスレッド制限を保持します。 |
| `mode default` |上流のモデル サーフェス ピンを尊重します。 |
-| `mode v2` |すべてのモデルを強制的に v2 にし、ネイティブ v2 を有効にして、アクティブなスレッド制限を維持します。 |
-| `threads ` |アクティブな v1/v2 スレッド制限を少なくとも 1 の整数に設定します。
+| `mode v2` |モデルを v2 にし、スレッド制限を維持します。`keep-native-v1` がオフならグローバル V2 を有効にし、オンならグローバル強制を無効にしてカタログのピンを使います。 |
+| `mode v2-plaintext --acknowledge-plaintext-agent-messages` | 新しいセッションで V2 を選び、グローバル強制を無効にしたまま対象タスクを平文で送信します。開始には `--acknowledge-plaintext-agent-messages` が必要です。 |
+| `keep-native-v1 on\|off` | `mode v2` で ChatGPT ネイティブを v1、ルーティング済みモデルを v2 に保ち、グローバル V2 強制を無効にします。 |
+| `threads ` |アクティブな v1/v2 スレッド制限を少なくとも 1 の整数に設定します。 |
+| `mode-hint ` | すべてのモデルと effort のプロアクティブ委任ヒントを設定します。 |
+| `mode-hint --clear` | ヒントを削除し、effort に基づく方針に戻します。 |
```bash
ocx v2 status
@@ -46,7 +50,7 @@ ocx v2 on
ocx v2 threads 16
```
-`mode` サブコマンドは、`multiAgentMode` を opencodex 設定に書き込み、Codex カタログを再同期します。モードとフラグの遷移により、現在の数値スレッド制限が有効な v1/v2 Codex キー間で移動します。移行が失敗すると、元の `config.toml` が復元されます。変更は新しい Codex セッションに適用されますが、実行中のセッションでは固定されたサーフェスが維持されます。
+`mode` サブコマンドは、`multiAgentMode` を opencodex 設定に書き込み、Codex カタログを再同期します。モードとフラグの遷移により、現在の数値スレッド制限が有効な v1/v2 Codex キー間で移動します。移行が失敗すると、元の `config.toml` が復元されます。カタログの変更は新しい Codex セッションに適用され、実行中のセッションは固定されたサーフェスを維持します。ただし平文コンパイラーは既存 V2 セッションの後続の対象リクエストにも現在の設定を適用します。
## コンボルーティング
diff --git a/docs-site/src/content/docs/ja/reference/configuration/agents.md b/docs-site/src/content/docs/ja/reference/configuration/agents.md
index d0623c713d8..4480402578e 100644
--- a/docs-site/src/content/docs/ja/reference/configuration/agents.md
+++ b/docs-site/src/content/docs/ja/reference/configuration/agents.md
@@ -9,7 +9,7 @@ description: マルチエージェント サーフェス、委任ガイダンス
|フィールド |タイプ |デフォルト |意味 |
| --- | --- | --- | --- |
-| `multiAgentMode?` | `"v1" \| "default" \| "v2"` | `"default"` | `v1` はすべてのカタログ モデルを v1 としてスタンプします。 `v2` はすべてのモデルを v2 としてスタンプします。 `default` はアップストリーム ピン (Sol/Terra v2、Luna v1) を復元し、それ以外の場合はネイティブの `multi_agent_v2` フラグに従います。新しいセッションに適用されます。 |
+| `multiAgentMode?` | `"v1" \| "default" \| "v2" \| "v2-plaintext"` | `"default"` | `v1` はすべてのカタログ モデルを v1 としてスタンプします。 `v2` はすべてのモデルを v2 としてスタンプします。 `default` はアップストリーム ピン (Sol/Terra v2、Luna v1) を復元し、それ以外の場合はネイティブの `multi_agent_v2` フラグに従います。`v2-plaintext` は新しいセッションのカタログを V2 に固定し、グローバル強制を無効にして対象タスクを平文にコンパイルします。有効なコンパイルは既存 V2 セッションの後続の対象リクエストにも適用されます。開始には `--acknowledge-plaintext-agent-messages` が必要です。 |
| `subagentModels?` | `string[]` | `gpt-6-astra`、`gpt-6.1-sol`、`gpt-6-luna` | 最大 5 つの bare native id、account-qualified `/` id、または routed `provider/model` id をサブエージェントの選択欄に優先表示します。新しく選べるのは bare native id と routed id です。保存時には、現在のカタログにないものも含め、設定済みの正確な account-qualified id を保持します。新しい正確な account-qualified id を追加するには `ocx agent subagents set` を使うか設定を編集してください。[Astra への一度限りの移行](/reference/configuration/agents/#astra-roster-upgrade)後は明示的な空リストも保持されます。 |
| `injectionModel?` | `string` | — |プロキシ作成の v2 委任ガイダンスで使用される、優先されるネイティブまたはルーティングされたサブエージェント モデル。 |
| `injectionEffort?` | `string` | — |優先努力 (`low` ～ `ultra`)。`injectionModel` でのみ意味があります。 |
@@ -21,14 +21,15 @@ description: マルチエージェント サーフェス、委任ガイダンス
| `subagentModelFallbackPollMs?` | `number` | `60000` |可用性プローブのキャッシュ間隔。 1000 ミリ秒未満の値はデフォルトに戻ります。 |
| `effortCap?` | `string` | — | v2 のメイン ターンとマークされた子ターンの条件を満たすためのハード シーリング。 `low` ～ `ultra` を受け入れます。 |
| `subagentEffortCap?` | `string` | — |スポーンされた子のターンのみの追加の上限。両方の上限が適用される場合は、低い方が優先されます。 |
+| `plaintextV2AgentMessages?` | `boolean` | — (未設定) | 実験的なオプトイン。明示的な `true` または `multiAgentMode: "v2-plaintext"` で、対象の ChatGPT ネイティブ V2 親に `spawn_agent`、`send_message`、`followup_task` のメッセージ引数を平文で出力させます。[詳細](#plaintext-v2-agent-messages)を参照してください。 |
-ダッシュボードまたは `ocx v2 status|on|off|mode |threads ` でサーフェスを管理します。モードの変更は新しいセッションに適用されます。 `maxConcurrentThreadsPerSession` は `PUT /api/v2` フィールドであり、`config.json` キーではありません。 `ocx v2 threads ` は、v2 が有効になった後、Codex の `$CODEX_HOME/config.toml` の `[features.multi_agent_v2]` の下に `max_concurrent_threads_per_session` を書き込みます。
+ダッシュボードまたは `ocx v2 status|on|off|mode |threads ` でサーフェスを管理します。カタログのピンの変更は新しいセッションに適用されます。 `maxConcurrentThreadsPerSession` は `PUT /api/v2` フィールドであり、`config.json` キーではありません。 `ocx v2 threads ` は、v2 が有効になった後、Codex の `$CODEX_HOME/config.toml` の `[features.multi_agent_v2]` の下に `max_concurrent_threads_per_session` を書き込みます。
-管理 API は、`GET`/`PUT /api/v2`、`/api/injection-model`、`/api/effort-caps`、`/api/subagent-models`、および `/api/subagent-model-fallback` を公開します。インジェクションモデルの更新は部分的です。カスタム プロンプトは、その API の `prompt` フィールドです。
+管理 API は、`GET`/`PUT /api/v2`、`/api/injection-model`、`/api/effort-caps`、`/api/subagent-models`、および `/api/subagent-model-fallback` を公開します。`PUT /api/v2` で新たに `v2-plaintext` に入るには `plaintextAgentMessagesAcknowledged: true` が必要です。インジェクションモデルの更新は部分的です。カスタム プロンプトは、その API の `prompt` フィールドです。
## 常時プロアクティブ委任
-Subagents → 詳細設定の **常時プロアクティブ委任**（旧 **Ultra mode**）は、推論のエフォートを変更せず、委任を開始する条件だけを変更します。推奨プリセットでも、ユーザーの指示、権限の境界、タスクの範囲、ツールの規則は維持されます。
+Subagents → 詳細設定の **常時プロアクティブ委任**（旧 **Ultra mode**）は、推論のエフォートを変更せず、委任を開始する条件だけを変更します。有効化にはグローバル V2 が有効な `v2` モードまたは `v2-plaintext` モードとサーバーの推奨値が必要です。既存ヒントの解除は V2 が無効でも可能です。推奨プリセットでも、ユーザーの指示、権限の境界、タスクの範囲、ツールの規則は維持されます。
`GET` と `PUT /api/v2` は、追加で `multiAgentModeHintRecommendation: { text, revision }` を返します。ダッシュボードはプリセットの有効化と復元にサーバー提供のテキストを使い、固定文へのフォールバックは行いません。旧サーバーが推奨値を返さない場合や値の形式が不正な場合、プリセットの適用と復元は利用できませんが、既存のカスタムヒントの編集と削除は引き続き利用できます。プリセットの復元はローカルの下書きだけを変更し、保存操作で確定します。
@@ -81,6 +82,12 @@ opencodex は、無効、ルーティング不能、異常、冷却期間、ま
}
```
+## Plaintext v2 agent messages
+
+`plaintextV2AgentMessages` は新規設定では未設定です。明示的な `true` または独立した `multiAgentMode: "v2-plaintext"` で実験的な平文コンパイラーを有効にできます。後者はグローバル V2 強制を無効にしてカタログを V2 に固定します。ダッシュボードの確認、または `ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages` で入ります。モードは独立した真偽値を上書きせず、退出後はその元の設定に従います。
+
+コンパイラーは既存 V2 セッションの後続リクエストを含む、条件を満たす正規 ChatGPT リクエストに現在の設定を適用します。呼び出し元は Responses を使い、最終送信先は `adapter: "openai-responses"`、`authMode: "forward"`、正確なベース URL `https://chatgpt.com/backend-api/codex` を使う必要があります。OpenAI API キーのプロバイダー、独自ゲートウェイ、他のプロバイダーへのルート、非 Responses 呼び出しは対象外です。既存の暗号文は復号せず、保存済み履歴も書き換えません。無効化しても履歴、プロバイダーへのリクエスト、ローカル応答・デバッグ状態に保持されたコピーは削除されません。HTTPS は維持されます。[英語版の詳細](/reference/configuration/agents/#plaintext-v2-agent-messages)を参照してください。
+
## 推論負荷上限
キャップは v2 コラボレーション機能にのみ適用されます。メイン ターンは、そのツールが v2 を公開するときに資格を持ちますが、子ターンは、リーフ ツールがコラボレーションを公開しなくなった場合でも、`x-codex-turn-metadata` に正確な codex-rs `x-openai-subagent: collab_spawn` または `"subagent_kind": "thread_spawn"` マーカーが含まれるときに資格を持ちます。 V1 メイン ターン、`multiAgentMode: "v1"`、圧縮、レビュー、およびメモリ統合ターンはバイパス キャップです。
diff --git a/docs-site/src/content/docs/ko/guides/codex-integration.md b/docs-site/src/content/docs/ko/guides/codex-integration.md
index e5adb56b101..b5631d2aa98 100644
--- a/docs-site/src/content/docs/ko/guides/codex-integration.md
+++ b/docs-site/src/content/docs/ko/guides/codex-integration.md
@@ -252,8 +252,12 @@ HTTP 클라이언트는 이 오류를 직접 처리하고 `previous_response_id`
참조한 상태의 client task scope가 현재 요청과 다를 때도 같은 거부 응답을 반환합니다. 새 요청이
전체 입력처럼 보여도 프록시는 그것이 완전한 대화인지 증명할 수 없으므로
`previous_response_id`를 조용히 제거하거나 일치하는 상태의 존재 여부를 노출하지 않습니다.
-전체 대화를 담고 `previous_response_id`를 뺀 요청으로 명시적으로 다시 시도하세요. 정규화된
-scope가 같거나 양쪽 scope가 모두 없거나 비어 있는 기존 unscoped continuation은 계속 replay합니다.
+`v2-plaintext` 모드 또는 `plaintextV2AgentMessages` 플래그가 활성화된 경우 로컬 재생에는 같은 수락된 OpenCodex 호출자와 요청 자체의 비어 있지 않은 `thread-id`가 필요합니다.
+부모 스레드, 루프백 주소, 상류 인증 정보나 임시 키만으로는 이 소유권을 증명할 수 없습니다.
+수락된 호출자 주체가 없거나 요청 자체의 스레드가 없는 클라이언트는 `previous_response_id` 없이 전체 대화를 다시 보내야 합니다.
+기본 루프백 Codex·DSH 설정은 이 호출자 인증을 제공하지 않습니다. 어느 한 설정이 활성화된 동안 보존된 상태는 비활성화 후에도 해당 신원에 결속된 채로 남습니다.
+기본 `v1`에서는 결속되지 않은 상태에 대해 기본 루프백 호출자를 포함하여 기존의 부모 스레드 범위 이어가기 동작이 유지됩니다. 네이티브 상류 서버가 소유한
+Responses ID의 처리 경로는 이 로컬 재생 규칙과 별개입니다.
routed 목적지에는 모두 같은 복구 신호가 적용됩니다. 프록시가 잃어버린 기록을 대신 볼 수 있는
것은 네이티브 Responses 패스스루뿐입니다. 체인을 저장해 둔 백엔드로 `previous_response_id`를
diff --git a/docs-site/src/content/docs/ko/guides/sub-agent-surface.md b/docs-site/src/content/docs/ko/guides/sub-agent-surface.md
index baece5604ce..8f7eced6f07 100644
--- a/docs-site/src/content/docs/ko/guides/sub-agent-surface.md
+++ b/docs-site/src/content/docs/ko/guides/sub-agent-surface.md
@@ -1,5 +1,5 @@
---
-title: 서브에이전트 서피스 (v1 / base / v2)
+title: 서브에이전트 서피스 (v1 / base / v2 / v2-plaintext)
description: Codex가 모든 모델에서 서브에이전트를 생성하고 관리하는 방식을 제어합니다.
---
@@ -13,12 +13,13 @@ description: Codex가 모든 모델에서 서브에이전트를 생성하고 관
| 모드 | Codex에 제공되는 것 | 누구에게 적합한가 |
| --- | --- | --- |
-| **v1** | 네임스페이스 방식의 클래식 `spawn_agent`, `send_input`, `resume_agent`, `close_agent` 툴을 제공합니다. 스폰 시 다른 모델을 직접 고를 수 있습니다. | 서로 다른 프로바이더를 넘나드는 위임을 안정적으로 써야 하는 초보자에게 적합합니다. 특히 네이티브에서 라우팅된 자식으로 넘어가는 경우에 좋습니다. |
-| **base** (기본값) | 업스트림 모델 핀을 따릅니다. GPT-5.6 Sol/Terra는 v2를, Luna는 v1을 사용하고, 핀이 없는 모델은 Codex의 `multi_agent_v2` 기능 플래그를 따릅니다. | 대부분의 사용자에게 적합합니다. 전역 강제 없이 각 모델에 대해 Codex가 의도한 서피스를 따릅니다. |
+| **v1** (기본값) | 네임스페이스 방식의 클래식 `spawn_agent`, `send_input`, `resume_agent`, `close_agent` 툴을 제공합니다. 스폰 시 다른 모델을 직접 고를 수 있습니다. | 서로 다른 프로바이더를 넘나드는 위임을 안정적으로 써야 하는 초보자에게 적합합니다. 특히 네이티브에서 라우팅된 자식으로 넘어가는 경우에 좋습니다. |
+| **base** | 업스트림 모델 핀을 따릅니다. GPT-5.6 Sol/Terra는 v2를, Luna는 v1을 사용하고, 핀이 없는 모델은 Codex의 `multi_agent_v2` 기능 플래그를 따릅니다. | 전역 강제 없이 각 모델에 대해 Codex가 의도한 서피스를 따르려는 사용자에게 적합합니다. |
| **v2** | 플랫 `spawn_agent`, `send_message`, `followup_task`, `interrupt_agent`, 에이전트 목록 툴을 제공하며, 동시 세션을 지원합니다. | 더 새로운 동시 워크플로를 원하고, 모델 상속과 아래의 암호화 작업 제한을 이해하는 사용자에게 적합합니다. |
+| **v2-plaintext** | V2 | V2를 새 세션에 선택하고 전역 강제를 끈 채 적격 작업을 평문으로 전달합니다. 진입하려면 `--acknowledge-plaintext-agent-messages`가 필요합니다. |
:::tip[헷갈리시나요?]
-**base**부터 시작하세요. 서로 다른 프로바이더를 안정적으로 넘나드는 위임이 필요하면 **v1**을 고르세요. 모든 카탈로그 항목에서 더 새로운 세션 모델을 명시적으로 쓰고 싶을 때만 **v2**를 강제로 선택하세요.
+서로 다른 프로바이더를 안정적으로 넘나드는 위임에는 기본값인 **v1**을 사용하세요. 업스트림 모델 핀을 따르려면 **base**를, 새로운 세션 모델을 명시적으로 쓰려면 **v2**를 선택하세요. **v2-plaintext**는 평문 작업 전달에 명시적으로 동의하는 선택지입니다.
:::
## 동작 방식
@@ -28,6 +29,7 @@ description: Codex가 모든 모델에서 서브에이전트를 생성하고 관
- **v1**은 모든 모델에 `multi_agent_version = "v1"`을 설정합니다.
- **base**는 업스트림 핀을 복원합니다. 핀이 없는 항목은 기본 `multi_agent_v2` 기능 플래그를 따릅니다.
- **v2**는 모든 모델에 `multi_agent_version = "v2"`를 설정합니다. 단 **ChatGPT를 v1로 유지**를 켜면 예외입니다: ChatGPT 네이티브 항목은 `"v1"`로 남고, 라우팅/콤보 항목은 `"v2"`가 됩니다.
+- **v2-plaintext**는 전역 V2 강제를 끄고 새 세션의 카탈로그 항목을 V2로 고정하며, 적격 작업 메시지를 평문으로 컴파일합니다.
opencodex는 이 값을 Codex가 읽는 실시간 `/v1/models` 카탈로그와 디스크에 동기화된 카탈로그 모두에 마지막 단계로 적용합니다. 그래서 모드를 바꾸면 새로 만들어지는 App, CLI, TUI 세션에 일관되게 반영됩니다.
@@ -114,7 +116,9 @@ v1에는 선호 모델, 로스터, 폴백 목록, 사용자 정의 프롬프트
## 암호화된 v2 작업 전달
-Codex는 v2 네이티브→라우팅 자식 작업을 백엔드 암호화된 `encrypted_content`로만 보낼 수 있습니다. 이 페이로드는 네이티브 ChatGPT 백엔드가 읽을 수 있지만 외부 프로바이더는 읽을 수 없습니다. 이것이 알려진 [#92 제한](https://github.com/lidge-jun/opencodex/issues/92)입니다.
+암호화된 v2 경로에서는 Codex가 네이티브→라우팅 자식 작업을 백엔드 암호화된 `encrypted_content`로 보낼 수 있습니다. 이 페이로드는 네이티브 ChatGPT 백엔드가 읽을 수 있지만 외부 프로바이더는 읽을 수 없습니다. 이것이 알려진 [#92 제한](https://github.com/lidge-jun/opencodex/issues/92)입니다.
+
+새 설정에서 `plaintextV2AgentMessages`는 설정되지 않습니다. 이 필드를 명시적으로 `true`로 설정하거나 별도로 `v2-plaintext` 모드를 선택하면 컴파일러가 활성화됩니다. 이 모드는 새 채팅에 V2를 선택하고 전역 강제를 끄며, 모드를 벗어나도 독립적인 필드 값은 보존됩니다. 컴파일러는 현재 설정을 따라 기존 V2 세션의 후속 적격 요청에도 적용됩니다. 기존 암호문을 복호화하거나 저장된 이력을 다시 쓰지 않으며, 비활성화해도 보존된 사본은 삭제되지 않습니다. 호출자는 Responses 프로토콜을 사용해야 하고 최종 대상은 `adapter: "openai-responses"`, `authMode: "forward"`, 정확한 기본 URL `https://chatgpt.com/backend-api/codex`를 사용하는 공식 ChatGPT 전달 경로여야 합니다. OpenAI API 키 제공자, 사용자 지정 호환 게이트웨이, 다른 제공자로의 라우트와 Responses가 아닌 호출자는 제외됩니다.
opencodex는 읽을 수 없거나 빈 작업을 그대로 넘기지 않고 안전하게 실패합니다.
@@ -130,7 +134,7 @@ opencodex는 읽을 수 없거나 빈 작업을 그대로 넘기지 않고 안
### GUI
-- **Dashboard** → 첫 번째 상태 셀: **v1**, **base**, **v2**를 고릅니다.
+- **Dashboard** → 첫 번째 상태 셀: **v1**, **base**, **v2**, **v2-plaintext**를 고릅니다. 평문 모드 진입에는 작업 텍스트 보존에 대한 확인이 필요합니다.
- **Models** → 맨 위 행의 세그먼트 선택기: 같은 전역 모드를 고릅니다.
- **Dashboard** → **Sub-agent delegation**: 가이드 모델/추론 강도와 네이티브 기본값 사용 여부를 설정합니다.
- **Subagents**: 로스터를 선택하고 순서를 정한 뒤 전역 폴백 체인을 설정합니다.
@@ -163,6 +167,8 @@ ocx agent effort set --subagent max
관리 API는 대응하는 `GET`과 `PUT` 엔드포인트를 제공합니다.
+`PUT /api/v2`로 `v2-plaintext`에 진입하려면 `plaintextAgentMessagesAcknowledged: true`가 필요합니다.
+
| 엔드포인트 | 관리하는 항목 |
| --- | --- |
| `/api/v2` | 서피스 모드, 네이티브 기능 플래그, 스레드 설정 |
diff --git a/docs-site/src/content/docs/ko/guides/subagent-v1-default.md b/docs-site/src/content/docs/ko/guides/subagent-v1-default.md
index 61343fbe441..a80462c876b 100644
--- a/docs-site/src/content/docs/ko/guides/subagent-v1-default.md
+++ b/docs-site/src/content/docs/ko/guides/subagent-v1-default.md
@@ -5,7 +5,23 @@ description: v2의 암호화 작업 제한으로 생기는 문제, opencodex가
opencodex를 설치하면 서브에이전트 서피스가 **v1**로 설정됩니다. Dashboard, Models, Subagents 페이지에서 **base**나 **v2**로 바꾸려면 확인을 요청하며, 그 확인 창에서 이 문서로 연결됩니다. CLI에서는 확인 메시지가 나오지 않습니다.
-이유는 분명합니다. v2에서 ChatGPT 네이티브 모델이 라우팅된 모델에 맡긴 작업은 라우팅된 모델이 읽을 수 없습니다. GPT 부모가 Grok, Claude, GLM 자식을 만드는 것은 가장 흔한 위임 방식인데, v2에서는 매번 실패합니다.
+이유는 암호화된 v2 전달 경로에 있습니다. ChatGPT 네이티브 모델이 만든 작업 암호문은 다른 제공자가 읽을 수 없어 경계에서 실패합니다. 아래 실험적 선택지는 새 작업 메시지를 평문으로 생성하도록 바꾸며, 기존 암호문을 복호화하지 않습니다.
+
+## 선택 기능: V2와 평문 작업 전달
+
+**V2 · 평문 작업 전달**(`v2-plaintext`)은 전역 V2 강제를 끈 상태에서 새 채팅의 기본 선택을 V2로 지정합니다. V2 작업 이름·계층·후속 메시지·취소·동시 실행 기능을 유지하고, 조건에 맞는 공식 ChatGPT Responses 전달에 기존 실험적 평문 컴파일러를 사용합니다. 기존 채팅은 기록된 선택을 유지합니다. 업데이트만으로 이 모드가 선택되지는 않습니다.
+
+카탈로그 고정값은 새 세션에 적용됩니다. 컴파일러는 요청 시점의 설정에 따라 동작하므로, 기존 V2 세션의 후속 요청도 조건에 맞는 공식 ChatGPT 경로라면 적용 대상입니다. 기록된 V2 선택을 유지하는 것과 후속 요청의 컴파일 여부는 별개입니다.
+
+`v2-plaintext` 모드에서 로컬 응답 ID 이어가기에는 동일하게 허용된 opencodex API 키 신원과 요청 자체의 `thread-id`가 필요합니다. 부모 스레드 ID로 자식의 보존된 작업에 접근할 수는 없습니다. 어느 하나라도 없거나 프록시를 재시작한 경우, 또는 예전에 저장된 결속되지 않은 캐시 항목이라면 `previous_response_id` 없이 전체 대화를 다시 보내세요. 이 모드에서 보존된 상태는 모드를 바꾼 뒤에도 결속됩니다. 기본 `v1`은 루프백 호출자를 포함해 결속되지 않은 상태에 기존의 부모 스레드 범위 이어가기 동작을 유지합니다. 사용을 중단해도 별도로 보존된 사본은 디스크에 남습니다.
+
+대시보드에서는 작업 텍스트가 Codex 이력, 선택한 제공자의 요청, 디스크에 저장되는 연속 대화 스냅샷·spill 파일을 포함한 로컬 응답·디버그 상태에 평문으로 남을 수 있음을 확인해야 합니다. HTTPS와 인증은 유지되며 복구용 모델 호출을 추가하지 않습니다. 기존 암호문을 복호화하거나 저장된 기록을 다시 쓰지 않습니다. 컴파일러를 비활성화해도 보존된 사본은 삭제되지 않습니다. 지원되지 않는 백엔드·클라이언트 동작은 실패할 수 있습니다. 일반 v1 및 네이티브 v1/라우팅 v2 혼합 모드도 유지됩니다.
+
+```bash
+ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages
+```
+
+라이브 대상은 `ocx v2 status --live --json`으로 확인하세요. 로컬 대상은 두 명령에서 `--live`를 빼고 `ocx v2 status --json`으로 확인하세요. 설정 저장·카탈로그 반영과 실제 위임 성공은 별도 검증입니다. 다른 모드를 명시적으로 선택하면 이 모드에서 나옵니다. 별도로 설정한 `plaintextV2AgentMessages` 값은 보존됩니다.
## 문제가 생기면 보이는 것
@@ -28,11 +44,11 @@ HTTP 400을 반환하며 암호문은 응답에 포함하지 않습니다. 읽
v1에서는 부모가 자식 작업을 평문으로 내보냅니다. opencodex가 이를 읽고 라우팅하므로 자식이 실행할 수 있는 작업을 받습니다.
-v2에서는 부모가 ChatGPT 백엔드에서 만든 `encrypted_content`로 작업을 내보냅니다. 키는 그 백엔드에만 있습니다. opencodex에는 키가 없으므로 프록시가 복호화하거나 다시 쓸 수 없습니다. 플래그 뒤에 숨은 평문이 아니라 실제 암호문입니다. 따라서 설정 오류가 아니라 구조적인 문제이며 프록시 설정으로 로컬 복호화를 활성화할 수 없습니다.
+암호화된 v2 경로에서는 부모가 ChatGPT 백엔드에서 만든 `encrypted_content`로 작업을 내보냅니다. 키는 그 백엔드에만 있습니다. opencodex에는 키가 없으므로 프록시가 복호화하거나 다시 쓸 수 없습니다. 플래그 뒤에 숨은 평문이 아니라 실제 암호문입니다. 평문 모드는 새 적격 작업을 다르게 생성하지만 기존 암호문을 해결하지는 못합니다.
프록시 설정으로 로컬 복호화를 활성화할 수는 없습니다. 실험적인 `agentTaskRecovery`는 적격 작업을 ChatGPT 백엔드에 요청해 복구할 수 있지만 로컬에서 암호문을 해독하지는 않습니다. 위의 승인, 적격성 및 실패 제한은 그대로 적용됩니다.
-영향받지 않는 연결 방식은 세 가지입니다. 어떤 경계에서 실패하는지 보면 이유가 드러납니다.
+다음 비교는 평문 컴파일러를 사용하지 않는 암호화된 v2 경로를 설명합니다.
| 연결 방식 | v1 | v2 |
| --- | --- | --- |
@@ -48,15 +64,16 @@ v2에서는 부모가 ChatGPT 백엔드에서 만든 `encrypted_content`로 작
송신 측 문제는 아직 열려 있습니다. Windows, macOS, Linux의 CLI 0.146~0.151에서 재현된 [#36376](https://github.com/openai/codex/issues/36376)과 송신 측 전달 정책의 부재를 직접 지적한 [#37197](https://github.com/openai/codex/issues/37197)입니다. 어느 쪽에도 유지관리자의 해결 약속이나 예정 시점이 없습니다.
-opencodex는 결과를 [#92](https://github.com/lidge-jun/opencodex/issues/92)에 기록하고 계획 없음으로 닫았습니다. 이 저장소에서 해결할 수 없으므로 이슈는 여기 유지관리자를 기다리는 작업이 아니라 업스트림 작업을 가리킵니다.
+opencodex는 암호화된 경로의 결과를 [#92](https://github.com/lidge-jun/opencodex/issues/92)에 기록하고 계획 없음으로 닫았습니다. 기존 암호문을 읽으려면 업스트림 지원이 필요하며, 평문 모드는 새 적격 작업을 위한 별도의 선택지입니다.
-## 현재 세 모드의 동작
+## 현재 모드의 동작
| 모드 | 서피스 | 선택할 때 |
| --- | --- | --- |
| **v1** (기본값) | 모든 모델이 기존 네임스페이스 방식 스폰 도구를 표시합니다. 스폰 시 다른 모델을 직접 지정할 수 있습니다. | 프로바이더 간 위임을 사용하는 경우. 설치 시 기본값입니다. |
| **base** | 업스트림 모델 핀을 따릅니다. Sol과 Terra는 v2, Luna는 v1을 사용하며, 핀이 없는 모델은 Codex 자체 플래그를 따릅니다. | Codex가 모델별로 의도한 서피스를 원하고 한 프로바이더 안에서만 위임하는 경우. |
| **v2** | 모든 모델이 새로운 플랫 동시 실행 도구를 표시합니다. | 새로운 동시 세션 모델을 원하고 부모와 자식이 같은 경계 쪽에 있는 경우. |
+| **v2-plaintext** | 전역 강제를 끄고 새 세션에 V2를 선택하며 적격 작업 메시지를 평문으로 컴파일합니다. | 평문 작업 전달과 보존 가능성에 명시적으로 동의하는 경우. |
base가 첫 번째가 아니라 두 번째인 이유는 대부분의 위임 출발점인 Sol과 Terra가 핀에 따라 v2를 사용하기 때문입니다. 이 문제에서 base는 절충 설정이 아닙니다. ChatGPT에서 라우팅된 모델로 스폰할 때는 v2처럼 동작합니다.
@@ -69,7 +86,7 @@ base가 첫 번째가 아니라 두 번째인 이유는 대부분의 위임 출
어느 쪽이든 응답이 기록되어 알림이 다시 나타나지 않습니다. 응답하지 않고 닫으면 다음 대시보드 방문 때 다시 보입니다.
-모드 변경은 **새** Codex 세션에 적용됩니다. 선택한 뒤 새 세션을 시작하세요. 오래 실행된 App 호스트에 예전 서피스가 남아 있으면 `ocx sync`를 실행하고 해당 서피스를 다시 시작하세요.
+카탈로그 고정값 변경은 **새** Codex 세션에 적용됩니다. 평문 컴파일러는 현재 설정에 따라 기존 V2 세션의 후속 적격 요청도 처리합니다. 선택한 뒤 새 세션을 시작하세요. 오래 실행된 App 호스트에 예전 서피스가 남아 있으면 `ocx sync`를 실행하고 해당 서피스를 다시 시작하세요.
## 그래도 v2를 원한다면
@@ -88,7 +105,7 @@ base가 첫 번째가 아니라 두 번째인 이유는 대부분의 위임 출
## 모드 변경
-Dashboard, Models, Subagents 모두 같은 v1/base/v2 스위치를 제공하며 base나 v2를 선택하면 확인을 요청합니다. CLI에서는 다음을 실행하세요.
+Dashboard, Models, Subagents에서 모드를 선택할 수 있으며 평문 모드 진입에는 별도의 확인이 필요합니다. CLI에서는 다음을 실행하세요.
```bash
ocx v2 status
diff --git a/docs-site/src/content/docs/ko/reference/cli.md b/docs-site/src/content/docs/ko/reference/cli.md
index 26c7c0ff0a7..60622cf132b 100644
--- a/docs-site/src/content/docs/ko/reference/cli.md
+++ b/docs-site/src/content/docs/ko/reference/cli.md
@@ -55,6 +55,8 @@ Windows x64 설치 관측은 [`attest` 명령](/ko/reference/cli/agents/)을 참
`ocx config validate `과 `ocx config import --yes`는 선행 BOM이 있는 UTF-8 JSON도 읽습니다. 표준 입력(`-`)에도 적용되므로 Windows PowerShell이나 편집기의 UTF-8 내보내기를 사용할 수 있습니다. UTF-16은 지원하지 않습니다.
+실험적인 평문 서브에이전트 모드에 진입하려면 `ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages`를 사용하세요. 일반 `config set`과 `config import`는 새로 이 모드에 진입하는 요청을 거부합니다. 전용 명령이 네이티브 모드 전환도 함께 처리하기 때문입니다. `multiAgentMode: "v2-plaintext"`가 포함된 내보내기 파일을 복원하려면 먼저 확인을 거쳐 해당 모드로 전환한 다음 파일을 가져오세요. 이미 활성화된 모드를 복원하거나 다른 설정을 변경하거나 평문 모드에서 나가는 것은 허용됩니다. 독립적인 `plaintextV2AgentMessages` 설정은 변경되지 않습니다.
+
## Default alias listing
`ocx alias --json`은 `ocx alias list --json`과 같습니다. `--json`은 명시한 alias 작업의 앞이나 뒤에 둘 수 있습니다.
diff --git a/docs-site/src/content/docs/ko/reference/cli/agents.md b/docs-site/src/content/docs/ko/reference/cli/agents.md
index 102cff039a0..18c91eaafa6 100644
--- a/docs-site/src/content/docs/ko/reference/cli/agents.md
+++ b/docs-site/src/content/docs/ko/reference/cli/agents.md
@@ -46,9 +46,9 @@ ocx effort set --subagent -
설정을 유지하면서 두 상한을 해제합니다. 상한이 적용되는 요청 surface는
[Sub-agent surfaces](/ko/guides/sub-agent-surface/)를 참고하세요.
-### `ocx v2 |threads >`
+### `ocx v2 |keep-native-v1 |threads |mode-hint >`
-Codex `multi_agent_v2` 기능 플래그와 세 상태 멀티 에이전트 surface mode를 관리합니다.
+Codex `multi_agent_v2` 기능 플래그와 네 상태 멀티 에이전트 surface mode를 관리합니다.
| 하위 명령 | 동작 |
| --- | --- |
@@ -57,8 +57,12 @@ Codex `multi_agent_v2` 기능 플래그와 세 상태 멀티 에이전트 surfac
| `off` | `multi_agent_v2` 기능을 끄고 catalog를 다시 동기화합니다. |
| `mode v1` | 모든 모델을 v1으로 고정하고, native v2를 끄며, 활성 thread 한도를 유지합니다. |
| `mode default` | 업스트림에서 지정한 model surface pin을 따릅니다. |
-| `mode v2` | 모든 모델을 v2로 고정하고, native v2를 켜며, 활성 thread 한도를 유지합니다. |
+| `mode v2` | 모델을 v2로 고정하고 활성 thread 한도를 유지합니다. `keep-native-v1`이 꺼져 있으면 전역 native v2를 켜고, 켜져 있으면 전역 강제를 끄고 catalog pin을 사용합니다. |
+| `mode v2-plaintext --acknowledge-plaintext-agent-messages` | V2를 새 세션에 선택하고 전역 강제를 끈 채 적격 작업을 평문으로 전달합니다. 진입하려면 `--acknowledge-plaintext-agent-messages`가 필요합니다. |
+| `keep-native-v1 on\|off` | `mode v2`에서 ChatGPT 네이티브 모델을 v1로, 라우팅된 모델을 v2로 유지합니다. 켜면 catalog 동기화 전에 전역 V2 강제를 끕니다. |
| `threads ` | 활성 v1/v2 thread 한도를 1 이상의 정수로 설정합니다. |
+| `mode-hint ` | 모든 모델과 추론 노력에 능동 위임 힌트(Ultra 모드)를 설정합니다. |
+| `mode-hint --clear` | 힌트를 제거해 추론 노력에 따른 정책을 복원합니다. |
```bash
ocx v2 status
@@ -70,7 +74,9 @@ ocx v2 threads 16
`mode` 하위 명령은 `multiAgentMode`를 opencodex config에 쓰고 Codex catalog를 다시 동기화합니다.
mode와 flag 전환은 현재 숫자 thread 한도를 유효한 v1/v2 Codex key 사이로 옮깁니다.
-전환이 실패하면 원래의 `config.toml`이 복원됩니다. 변경은 새 Codex 세션에만 적용되고, 실행 중인 세션은 고정된 surface를 유지합니다.
+전환이 실패하면 원래의 `config.toml`이 복원됩니다. 카탈로그 변경은 새 Codex 세션에 적용되고 실행 중인 세션은 고정된 surface를 유지하지만, 활성화된 평문 컴파일러는 기존 V2 세션의 후속 적격 요청에도 적용됩니다.
+
+Subagents 대시보드의 Ultra 모드 스위치는 네이티브 기능이 켜진 명시적 `ocx v2 mode v2` 또는 전역 강제 없이 카탈로그 pin을 사용하는 `v2-plaintext` 모드가 필요합니다. `ocx v2 on`만으로는 이 조건을 충족하지 않습니다.
## 콤보 라우팅
diff --git a/docs-site/src/content/docs/ko/reference/configuration/agents.md b/docs-site/src/content/docs/ko/reference/configuration/agents.md
index 67e758e90f6..e2a74761a37 100644
--- a/docs-site/src/content/docs/ko/reference/configuration/agents.md
+++ b/docs-site/src/content/docs/ko/reference/configuration/agents.md
@@ -3,13 +3,15 @@ title: 에이전트 설정
description: 멀티 에이전트 표면, 위임 안내, 선호 모델, 대체 체인, 기본값 동기화, 노력 상한을 다룹니다.
---
+`multiAgentMode: "v2-plaintext"`는 새 채팅에 V2를 선택하면서 전역 V2 강제를 끄고, 조건에 맞는 공식 ChatGPT Responses 경로에 실험적 평문 작업 전달을 적용하는 명시적 선택입니다. 대시보드 확인 또는 `ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages`로 진입합니다. 작업 텍스트는 이력·선택한 제공자의 요청·로컬 디버그 상태에 남을 수 있지만 HTTPS와 인증은 유지됩니다. 기존 암호문을 복호화하지 않으며 기존 채팅 기록도 변경하지 않습니다. 별도 `plaintextV2AgentMessages` 설정은 다른 모드로 돌아갈 때도 보존됩니다. 컴파일러는 현재 설정을 따르므로 기존 V2 세션의 후속 적격 요청도 적용 대상입니다. 비활성화해도 이력·제공자 요청·로컬 응답·디버그 상태에 이미 보존된 사본은 삭제되지 않습니다.
+
에이전트 설정은 어떤 Codex 협업 표면을 노출할지와, opencodex가 위임 작업을 어떻게 안내하고, 라우팅하고, 제한할지를 제어합니다.
## 에이전트 필드
| 필드 | 형식 | 기본값 | 의미 |
| --- | --- | --- | --- |
-| `multiAgentMode?` | `"v1" \| "default" \| "v2"` | `"default"` | `v1`은 카탈로그의 모든 모델에 v1을 표시하고, `v2`는 모든 모델에 v2를 표시합니다. `default`는 상위 고정값(Sol/Terra는 v2, Luna는 v1)을 복원하고, 그 외에는 네이티브 `multi_agent_v2` 플래그를 따릅니다. 새 세션에 적용됩니다. |
+| `multiAgentMode?` | `"v1" \| "default" \| "v2" \| "v2-plaintext"` | `"default"` | `v1`은 카탈로그의 모든 모델에 v1을 표시하고, `v2`는 모든 모델에 v2를 표시합니다. `default`는 상위 고정값(Sol/Terra는 v2, Luna는 v1)을 복원하고, 그 외에는 네이티브 `multi_agent_v2` 플래그를 따릅니다. `v2-plaintext`는 실험적 평문 작업 전달을 함께 켜고 전역 강제는 끕니다. 카탈로그 고정값은 새 세션에 적용되며, 활성화된 컴파일러는 기존 V2 세션의 후속 적격 요청에도 적용됩니다. |
| `subagentModels?` | `string[]` | `gpt-6-astra`, `gpt-6.1-sol`, `gpt-6-luna` | 최대 다섯 개의 bare native id, account-qualified `/` id 또는 routed `provider/model` id를 서브에이전트 선택기에 우선 표시합니다. 새 선택 항목으로는 bare native와 routed id를 제공합니다. 저장할 때는 현재 카탈로그에 없는 항목을 포함하여 이미 설정된 정확한 account-qualified id를 보존합니다. 새 정확한 account-qualified id를 추가하려면 `ocx agent subagents set`을 사용하거나 설정을 편집하세요. [Astra 최초 업그레이드](/reference/configuration/agents/#astra-roster-upgrade) 이후에는 명시적으로 빈 목록도 보존됩니다. |
| `injectionModel?` | `string` | — | 프록시가 작성한 v2 위임 안내에서 사용하는 선호 네이티브 또는 라우팅된 서브에이전트 모델입니다. |
| `injectionEffort?` | `string` | — | 선호 노력(`low`부터 `ultra`까지)입니다. `injectionModel`이 있을 때만 의미가 있습니다. |
@@ -21,15 +23,22 @@ description: 멀티 에이전트 표면, 위임 안내, 선호 모델, 대체
| `subagentModelFallbackPollMs?` | `number` | `60000` | 사용 가능성 검사 캐시 간격입니다. 1000 ms 미만의 값은 기본값으로 돌아갑니다. |
| `effortCap?` | `string` | — | 자격을 갖춘 v2 메인 턴과 표시된 생성 하위 턴에 대한 하드 상한입니다. `low`부터 `ultra`까지 허용합니다. |
| `subagentEffortCap?` | `string` | — | 생성된 하위 턴에만 적용되는 추가 상한입니다. 두 상한이 모두 적용되면 더 낮은 값이 이깁니다. |
+| `plaintextV2AgentMessages?` | `boolean` | — (설정되지 않음) | 실험적 선택 기능입니다. 명시적 `true` 또는 `multiAgentMode: "v2-plaintext"`는 적격 네이티브 ChatGPT v2 부모가 `spawn_agent`, `send_message`, `followup_task`의 메시지 인수를 평문으로 내보내도록 합니다. |
-이 표면은 대시보드나 `ocx v2 status|on|off|mode |threads `로 관리합니다. 모드 변경은 새 세션에 적용됩니다. `maxConcurrentThreadsPerSession`은 `config.json` 키가 아니라 `PUT /api/v2` 필드입니다. `ocx v2 threads `는 v2가 활성화된 뒤 Codex의 `$CODEX_HOME/config.toml` 안 `[features.multi_agent_v2]` 아래에 `max_concurrent_threads_per_session`을 기록합니다.
+이 표면은 대시보드나 `ocx v2 status|on|off|mode |keep-native-v1 |threads |mode-hint `로 관리합니다. `v2-plaintext` 진입에는 `--acknowledge-plaintext-agent-messages`가 필요합니다. 카탈로그 고정값 변경은 새 세션에 적용됩니다. 평문 컴파일러는 현재 설정에 따라 기존 V2 세션의 후속 적격 요청도 처리합니다. `maxConcurrentThreadsPerSession`은 `config.json` 키가 아니라 `PUT /api/v2` 필드입니다. `ocx v2 threads `는 v2가 활성화된 뒤 Codex의 `$CODEX_HOME/config.toml` 안 `[features.multi_agent_v2]` 아래에 `max_concurrent_threads_per_session`을 기록합니다.
관리 API는 `GET`/`PUT /api/v2`, `/api/injection-model`, `/api/effort-caps`, `/api/subagent-models`, `/api/subagent-model-fallback`를 제공합니다. injection-model 업데이트는 부분 업데이트입니다. 사용자 지정 프롬프트는 이 API의 `prompt` 필드입니다.
+`PUT /api/v2`로 `v2-plaintext`에 진입하려면 `plaintextAgentMessagesAcknowledged: true`가 필요합니다. 일반 `config set`과 `config import`는 이 모드로 새로 진입할 수 없습니다. 해당 모드가 포함된 내보내기를 복원하려면 먼저 확인을 거쳐 모드로 전환한 뒤 가져오세요.
+
+새 설정에서 `plaintextV2AgentMessages`는 설정되지 않으며, 명시적으로 `true`로 설정하는 방법과 `v2-plaintext` 모드 선택은 독립적인 활성화 방법입니다. 호출자는 Responses 프로토콜을 사용하고 최종 대상은 `adapter: "openai-responses"`, `authMode: "forward"`, 정확한 기본 URL `https://chatgpt.com/backend-api/codex`를 사용하는 공식 ChatGPT 전달 경로여야 합니다. OpenAI API 키 제공자, 사용자 지정 호환 게이트웨이, 다른 제공자 라우트 및 Responses가 아닌 호출자는 제외됩니다. 독립 필드는 `ocx config set plaintextV2AgentMessages true`로 설정할 수 있으며 변경 후 프록시를 재시작하세요.
+
## 항상 능동 위임
서브에이전트 → 고급의 **항상 능동 위임**(이전 이름: **울트라 모드**)은 추론 노력을 바꾸지 않고 위임을 시작하는 조건만 변경합니다. 권장 프리셋에서도 사용자 지침, 권한 경계, 작업 범위, 도구 규칙은 유지됩니다.
+대시보드 스위치를 켜려면 네이티브 기능이 활성화된 명시적 `multiAgentMode: "v2"` 또는 전역 강제를 끄고 카탈로그 pin을 사용하는 `multiAgentMode: "v2-plaintext"`가 필요합니다. `ocx v2 on`만으로는 조건을 충족하지 않습니다.
+
`GET`과 `PUT /api/v2`는 `multiAgentModeHintRecommendation: { text, revision }`도 반환합니다. 대시보드는 프리셋을 켜거나 복원할 때 서버가 제공한 텍스트를 사용하며, 고정된 대체 문구는 사용하지 않습니다. 이전 서버가 권장값을 제공하지 않거나 잘못된 형식으로 반환하면 프리셋 적용·복원은 사용할 수 없으며, 기존 사용자 지정 힌트의 편집·삭제는 계속 사용할 수 있습니다. **프리셋 복원**은 로컬 초안만 바꾸고, **저장**을 눌러야 저장됩니다.
설정 조회, 관련 없는 업데이트, 업그레이드는 저장된 힌트를 자동 변경하지 않습니다. 힌트를 명시적으로 업데이트할 때 본문이 알려진 두 가지 이전 OpenCodex 프리셋 중 하나와 바이트 단위로 정확히 일치하는 경우에만 현재 권장 문구로 바뀝니다. 그 밖의 유효한 사용자 지정 텍스트는 공백 차이가 있는 변형까지 바이트 단위로 보존됩니다. 기존 v2 활성화·기능 지원 확인·힌트 해제 규칙은 그대로이며, 변경은 새 Codex 세션에 적용됩니다.
diff --git a/docs-site/src/content/docs/reference/cli.md b/docs-site/src/content/docs/reference/cli.md
index 8fee3e60814..58910cbf81e 100644
--- a/docs-site/src/content/docs/reference/cli.md
+++ b/docs-site/src/content/docs/reference/cli.md
@@ -338,6 +338,8 @@ Integer options such as `--limit` require decimal whole numbers within JavaScrip
`ocx config validate ` and `ocx config import --yes` accept UTF-8 JSON with or without a leading BOM, including stdin (`-`). This supports UTF-8 exports from Windows PowerShell and editors. UTF-16 input is not accepted.
+To enter the experimental plaintext subagent mode, use `ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages`. Generic `config set` and `config import` refuse a new entry into this mode because the dedicated command also coordinates the native mode transition. Before restoring an exported config that contains `multiAgentMode: "v2-plaintext"`, complete that acknowledged transition first, then import the file. Restoring an already-active mode, changing other settings, and leaving plaintext mode remain allowed. The independent `plaintextV2AgentMessages` preference is unchanged.
+
## Default alias listing
`ocx alias --json` is equivalent to `ocx alias list --json`. The output flag can precede or follow an explicit alias action.
diff --git a/docs-site/src/content/docs/reference/cli/agents.md b/docs-site/src/content/docs/reference/cli/agents.md
index e105c217f29..8a0357525d2 100644
--- a/docs-site/src/content/docs/reference/cli/agents.md
+++ b/docs-site/src/content/docs/reference/cli/agents.md
@@ -172,9 +172,9 @@ An ignored subagent field does not remove a valid main cap. `ocx effort clear` c
while retaining the separate injection-effort setting. See [Sub-agent surfaces](/guides/sub-agent-surface/)
for the request surfaces where caps apply.
-### `ocx v2 |keep-native-v1 |threads |mode-hint >`
+### `ocx v2 |keep-native-v1 |threads |mode-hint >`
-Manage the Codex `multi_agent_v2` feature flag and the three-state multi-agent surface mode.
+Manage the Codex `multi_agent_v2` feature flag and the multi-agent surface mode.
These operate locally by default. `--live` uses the selected running proxy with no
local fallback; both targets support `--json`. Re-read status on the same target
after a change and distinguish stored settings from new-session behavior.
@@ -187,6 +187,7 @@ after a change and distinguish stored settings from new-session behavior.
| `mode v1` | Force all models to v1, disable native v2, and preserve the active thread limit. |
| `mode default` | Respect upstream model surface pins. |
| `mode v2` | Force models to v2 and preserve the active thread limit. With `keep-native-v1` off, enable global native v2; with it on, disable the global override and use catalog pins. |
+| `mode v2-plaintext` | Force models to v2 through catalog pins with the global override off and enable experimental plaintext task delivery. Requires `--acknowledge-plaintext-agent-messages`. |
| `keep-native-v1 on\|off` | Under `mode v2`, keep ChatGPT-native models on v1 and routed models on v2. Enabling it disables the global V2 override before catalog sync. |
| `threads ` | Set the active v1/v2 thread limit to an integer of at least 1. |
| `mode-hint ` | Set the Proactive delegation hint (Ultra mode) for every model and effort. |
@@ -219,8 +220,9 @@ codex-rs's effort-derived multi-agent policy, so any model and any reasoning eff
receives the Proactive delegation prompt. It does **not** change reasoning effort
itself. A missing argument or a whitespace-only value is rejected; only `--clear`
removes the hint. The Subagents dashboard's Ultra mode **on** toggle has a stricter
-gate: it requires the native feature to be enabled with an explicit v2 surface
-(`ocx v2 mode v2`); `ocx v2 on` alone does not satisfy that dashboard gate.
+gate: it requires either an enabled native feature with an explicit v2 surface
+(`ocx v2 mode v2`), or `v2-plaintext`, which uses catalog pins with the global
+override off. `ocx v2 on` alone does not satisfy that dashboard gate.
#### Explicit v2 target and outcome
diff --git a/docs-site/src/content/docs/reference/configuration/agents.md b/docs-site/src/content/docs/reference/configuration/agents.md
index 4943edfce3d..3bdbc15a76b 100644
--- a/docs-site/src/content/docs/reference/configuration/agents.md
+++ b/docs-site/src/content/docs/reference/configuration/agents.md
@@ -45,7 +45,7 @@ still depends on upstream support for your account.
| Field | Type | Default | Meaning |
| --- | --- | --- | --- |
-| `multiAgentMode?` | `"v1" \| "default" \| "v2"` | `"default"` | `v1` stamps every catalog model as v1; `v2` stamps every model as v2. `default` restores upstream pins (Sol/Terra v2, Luna v1) and otherwise follows the native `multi_agent_v2` flag. Applies to new sessions. |
+| `multiAgentMode?` | `"v1" \| "default" \| "v2" \| "v2-plaintext"` | `"default"` | `v1` stamps every catalog model as v1; `v2` stamps every model as v2. `default` restores upstream pins (Sol/Terra v2, Luna v1) and otherwise follows the native `multi_agent_v2` flag. `v2-plaintext` also enables experimental plaintext task delivery and disables the global override. Catalog pins apply to new sessions; enabled compilation also affects subsequent eligible requests from existing V2 sessions. |
| `keepNativeChatGptOnV1?` | `boolean` | `false` | When `multiAgentMode` is `"v2"`, disable the global V2 override, stamp ChatGPT-native rows as v1, and keep routed rows on v2. Codex resolves the global override before catalog pins, so both parts are required for a ChatGPT parent to spawn routed children without backend-encrypted tasks ([#92](https://github.com/lidge-jun/opencodex/issues/92)). Ignored in `v1` and `default`. |
| `subagentModels?` | `string[]` | `gpt-6-astra`, `gpt-6.1-sol`, `gpt-6-luna` | Up to five bare native, account-qualified `/`, or routed `provider/model` ids featured first in the sub-agent picker. The dashboard offers bare native and routed ids as new choices and preserves already-configured exact account-qualified ids when saving, including ids unavailable in the current catalog. To add a new exact account-qualified id, use `ocx agent subagents set` or edit the configuration. After the [one-time Astra upgrade](#astra-roster-upgrade), an explicit empty list is preserved. |
| `injectionModel?` | `string` | — | Preferred native or routed sub-agent model used in proxy-authored v2 delegation guidance. |
@@ -60,12 +60,12 @@ still depends on upstream support for your account.
| `codexRoleCapability?` | `{ artificialAnalysis?: { apiKey?: string } }` | No measured source | Measured-score source for [role auto-assign](/guides/integrations/#auto-assign). Artificial Analysis uses your API key (literal, `${ENV}` or keychain reference) once per day to read its free model list, every domain scored by its Intelligence Index; scores stay out of the response. Missing or unavailable data falls back to configured tiers and prices. A retired `huggingFace` key is ignored. |
| `effortCap?` | `string` | — | Hard ceiling for qualifying v2 main turns and marked spawned-child turns. Accepts `low` through `ultra`. |
| `subagentEffortCap?` | `string` | — | Additional ceiling for spawned-child turns only. When both caps apply, the lower wins. |
-| `plaintextV2AgentMessages?` | `boolean` | — (unset) | Experimental opt-in. It runs only when explicitly set to `true` and asks eligible native ChatGPT v2 parents to emit `spawn_agent`, `send_message`, and `followup_task` message arguments as plaintext. See [Plaintext v2 agent messages](#plaintext-v2-agent-messages). |
+| `plaintextV2AgentMessages?` | `boolean` | — (unset) | Experimental opt-in. Explicit `true` or `multiAgentMode: "v2-plaintext"` asks eligible native ChatGPT v2 parents to emit `spawn_agent`, `send_message`, and `followup_task` message arguments as plaintext. See [Plaintext v2 agent messages](#plaintext-v2-agent-messages). |
| `agentTaskRecovery?` | `object` | — | Experimental opt-in recovery for backend-encrypted v2 tasks sent to routed providers. Disabled unless `enabled: true`; see [Encrypted v2 task recovery](#encrypted-v2-task-recovery). |
Manage the surface with the dashboard or
-`ocx v2 status|on|off|mode |keep-native-v1 |threads |mode-hint `.
-Mode changes apply to new sessions. `maxConcurrentThreadsPerSession` is a `PUT /api/v2` field, not a
+`ocx v2 status|on|off|mode |keep-native-v1 |threads |mode-hint `; entering `v2-plaintext` requires `--acknowledge-plaintext-agent-messages`.
+Catalog pin changes apply to new sessions; the plaintext compiler follows the current setting for eligible requests, including later requests from existing V2 sessions. `maxConcurrentThreadsPerSession` is a `PUT /api/v2` field, not a
`config.json` key; `ocx v2 threads ` writes `max_concurrent_threads_per_session` under
`[features.multi_agent_v2]` in Codex's `$CODEX_HOME/config.toml` after v2 is enabled.
@@ -86,8 +86,9 @@ codex-rs's effort-derived multi-agent policy when that native surface is active.
A `null` value removes the key so the effort-derived policy (ultra = proactive,
otherwise explicit) resumes; empty or whitespace-only values are rejected because a
present empty override would suppress even the ultra-derived Proactive message. The
-Subagents dashboard's **Always proactive delegation** toggle requires both the native feature and
-an explicit v2 surface (`multiAgentMode: "v2"`, equivalent to `ocx v2 mode v2`);
+Subagents dashboard's **Always proactive delegation** toggle requires either the native feature
+with an explicit v2 surface (`multiAgentMode: "v2"`, equivalent to `ocx v2 mode v2`),
+or `multiAgentMode: "v2-plaintext"`, which uses catalog pins with the global override off.
`ocx v2 on` alone does not satisfy that dashboard gate.
`GET` and `PUT /api/v2` also return `multiAgentModeHintRecommendation: { text, revision }`.
@@ -196,7 +197,7 @@ on a mid-thread model switch.
## Plaintext v2 agent messages
-`plaintextV2AgentMessages` is unset in a fresh config and runs only when explicitly set to `true`.
+`plaintextV2AgentMessages` is unset in a fresh config. Explicit `true` or the separately selected `multiAgentMode: "v2-plaintext"` enables this experimental path. The mode also sets V2 catalog pins while disabling the global override; existing chat history is not rewritten. Enter through the dashboard confirmation or `ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages`. The mode does not overwrite the independent boolean, so leaving it restores that boolean's prior behavior. The compiler follows the current setting for subsequent eligible canonical ChatGPT requests, including existing V2 sessions. It does not decrypt existing ciphertext or rewrite stored history. Disabling it does not delete copies already retained in history, provider requests, or local response/debug state.
The caller must use the Responses wire, and the final destination must use the canonical ChatGPT
Codex forward transport: `adapter: "openai-responses"`, `authMode: "forward"`, and the exact base URL
`https://chatgpt.com/backend-api/codex`. OpenAI API-key providers, custom OpenAI-compatible
diff --git a/docs-site/src/content/docs/ru/guides/codex-integration.md b/docs-site/src/content/docs/ru/guides/codex-integration.md
index 035244e70cb..47f415b9f3e 100644
--- a/docs-site/src/content/docs/ru/guides/codex-integration.md
+++ b/docs-site/src/content/docs/ru/guides/codex-integration.md
@@ -186,6 +186,8 @@ runtime-home Orca, тогда как приложение ChatGPT/Codex всё
loopback встроенный провайдер Codex может сначала пробовать WebSocket, и отключённый прокси
ответит `426`, после чего Codex откатится на HTTP/SSE.
+Когда включён режим `v2-plaintext` или флаг `plaintextV2AgentMessages`, для локального replay требуются тот же допущенный вызывающий субъект OpenCodex и собственный непустой `thread-id` запроса. Родительский тред, loopback-адрес, учётные данные upstream или ключ-заполнитель не являются этой идентичностью. Клиенты без допущенного вызывающего субъекта и запросы без собственного треда должны повторно отправить полный разговор без `previous_response_id`. Конфигурации loopback Codex и DSH по умолчанию не устанавливают эту идентичность. Состояние, сохранённое при включении любого из этих параметров, остаётся привязанным после его отключения. В режиме `v1` по умолчанию непривязанное состояние сохраняет прежнее продолжение в пределах родительского треда, в том числе для вызывающих сторон loopback по умолчанию. Это отдельно от нативных Responses ID, принадлежащих upstream.
+
## Идентичность тредов и история
Форма loopback по умолчанию сохраняет новые треды помеченными нативным провайдером Codex
diff --git a/docs-site/src/content/docs/ru/guides/sub-agent-surface.md b/docs-site/src/content/docs/ru/guides/sub-agent-surface.md
index 5e6cbfa807a..7815f2ac52c 100644
--- a/docs-site/src/content/docs/ru/guides/sub-agent-surface.md
+++ b/docs-site/src/content/docs/ru/guides/sub-agent-surface.md
@@ -14,17 +14,17 @@ description: Управляйте тем, как Codex создаёт и обс
## Режимы
Режим выбирается для **новых сессий**. Уже запущенные сессии сохраняют ту поверхность, с которой
-они стартовали.
+они стартовали. Однако включённый компилятор обрабатывает последующие подходящие запросы существующих сессий V2.
| Режим | Что получает Codex | Кому подходит |
| --- | --- | --- |
-| **v1** | Классические namespaced-инструменты `spawn_agent`, `send_input`, `resume_agent` и `close_agent`. Spawn может сразу выбрать другую модель. | Новички, которым нужно надёжное делегирование между разными провайдерами, особенно для потомков native-to-routed. |
-| **base** (default) | Upstream pin'ы моделей: GPT-5.6 Sol/Terra используют v2, Luna использует v1, а модели без pin'а следуют feature flag'у Codex `multi_agent_v2`. | Большинство пользователей. Этот режим следует ожидаемой surface для каждой модели и не навязывает одну глобально. |
+| **v1** (по умолчанию) | Классические namespaced-инструменты `spawn_agent`, `send_input`, `resume_agent` и `close_agent`. Spawn может сразу выбрать другую модель. | Новички, которым нужно надёжное делегирование между разными провайдерами, особенно для потомков native-to-routed. |
+| **base** | Upstream pin'ы моделей: GPT-5.6 Sol/Terra используют v2, Luna использует v1, а модели без pin'а следуют feature flag'у Codex `multi_agent_v2`. | Большинство пользователей. Этот режим следует ожидаемой surface для каждой модели и не навязывает одну глобально. |
| **v2** | Плоские инструменты `spawn_agent`, `send_message`, `followup_task`, `interrupt_agent` и agent-list, с конкурентными сессиями. | Пользователи, которым нужен новый concurrent-workflow и которые понимают наследование модели и ограничение encrypted task ниже. |
+| **v2-plaintext** | V2 | Выбирает V2 для новых сессий и передаёт подходящие задачи открытым текстом без глобального принуждения. Для включения нужен `--acknowledge-plaintext-agent-messages`. |
:::tip[Не уверены?]
-Начинайте с **base**. Выбирайте **v1**, когда межпровайдерское делегирование должно работать
-предсказуемо. Жёстко включайте **v2** только тогда, когда вам целенаправленно нужна именно её
+Начинайте с **v1**, когда межпровайдерское делегирование должно работать предсказуемо. Жёстко включайте **v2** только тогда, когда вам целенаправленно нужна именно её
новая модель сессии для каждой записи каталога.
:::
@@ -36,6 +36,7 @@ Codex:
- **v1** записывает `multi_agent_version = "v1"` для каждой модели.
- **base** восстанавливает upstream pin'ы. У записей без pin'а поведение определяется feature
flag'ом `multi_agent_v2`.
+- **v2-plaintext** закрепляет V2 в каталоге для новых сессий, отключает глобальное принудительное V2 и включает компилятор сообщений задач.
- **v2** записывает `multi_agent_version = "v2"` для каждой модели, кроме случая, когда включён режим **Оставить ChatGPT на v1**: собственные строки ChatGPT остаются `"v1"`, а маршрутизируемые и комбо-строки остаются `"v2"`.
opencodex применяет это как финальный проход и к живому каталогу `/v1/models`, и к каталогу,
@@ -181,7 +182,7 @@ endpoint ChatGPT, но расходует квоту, добавляет зад
### GUI
-- **Dashboard** → первая ячейка со статистикой: выберите **v1**, **base** или **v2**.
+- **Dashboard** → первая ячейка со статистикой: выберите **v1**, **base**, **v2** или **v2-plaintext**.
- **Models** → сегментированный переключатель в верхнем ряду: выберите тот же глобальный режим.
- **Dashboard** → **Sub-agent delegation**: задайте модель/effort для guidance и opt-in для
native-default.
@@ -196,6 +197,7 @@ ocx v2 status
ocx v2 mode v1
ocx v2 mode default
ocx v2 mode v2
+ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages
ocx v2 threads 8
```
@@ -215,6 +217,8 @@ ocx agent effort set --subagent max
### API
+При переходе в `v2-plaintext` дашборд запрашивает согласие; `PUT /api/v2` требует `plaintextAgentMessagesAcknowledged: true`.
+
Management API предоставляет соответствующие `GET` и `PUT` endpoint'ы:
| Эндпоинт | Чем управляет |
@@ -276,3 +280,5 @@ Codex заполняет до пяти предлагаемых мест из к
Ограничение контекста модели не зависит от режима подагентов. Настраивайте его на странице
Models; нативные модели OpenAI сохраняют свои реальные окна контекста.
+
+Экспериментальный `plaintextV2AgentMessages` в новой конфигурации не задан. Явное `true` или отдельно выбранный режим `v2-plaintext` включает компилятор; выход из режима сохраняет независимое значение флага. Компиляция следует текущей настройке и для последующих подходящих запросов существующих сессий V2. Вызывающая сторона должна использовать Responses, а конечный маршрут — `adapter: "openai-responses"`, `authMode: "forward"` и точный URL `https://chatgpt.com/backend-api/codex`. Другие провайдеры, совместимые шлюзы и клиенты без Responses исключены. Компилятор обрабатывает `spawn_agent`, `send_message` и `followup_task` без дополнительного запроса восстановления. HTTPS сохраняется, но текст может остаться в истории Codex, запросах провайдеру и локальном состоянии ответов или отладки. Существующий шифротекст не расшифровывается, история не переписывается, а отключение не удаляет сохранённые копии. См. [конфигурацию агентов](/ru/reference/configuration/agents/#plaintext-v2-agent-messages).
diff --git a/docs-site/src/content/docs/ru/guides/subagent-v1-default.md b/docs-site/src/content/docs/ru/guides/subagent-v1-default.md
index 4375754c998..de0880768c8 100644
--- a/docs-site/src/content/docs/ru/guides/subagent-v1-default.md
+++ b/docs-site/src/content/docs/ru/guides/subagent-v1-default.md
@@ -3,14 +3,22 @@ title: Почему v1 — режим подагентов по умолчани
description: Что ломает ограничение шифрованных задач v2, почему OpenCodex теперь поставляется с v1 и что делать, если вам нужен v2.
---
+Выбор в каталоге действует для новых сеансов, но включённый компилятор обрабатывает и последующие подходящие запросы существующих сеансов V2 через канонический маршрут ChatGPT. Отключение не удаляет уже сохранённые копии и не переписывает сохранённую историю.
+
+**Экспериментальный вариант: `v2-plaintext`.** Он выбирает V2 для новых чатов, не включая глобальное принудительное V2. После явного подтверждения новые подходящие сообщения задач передаются открытым текстом на уровне приложения; HTTPS и аутентификация сохраняются. Текст может оставаться в истории, запросах выбранному провайдеру и локальных отладочных данных. Уже зашифрованные задачи не расшифровываются.
+
+Команда: `ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages`. Для активной цели проверьте `ocx v2 status --live --json`; для локальной уберите `--live` из обеих команд и проверьте `ocx v2 status --json`: состояние конфигурации и синхронизация каталога не доказывают успешное делегирование. Для выхода явно выберите другой режим; независимое значение `plaintextV2AgentMessages` сохраняется. Режим использует компилятор для подходящих запросов Responses через канонический маршрут ChatGPT и сохраняет имена задач V2, иерархию, последующие сообщения, отмену и параллельность.
+
+Для локального продолжения по ID ответа нужны тот же допущенный API-ключ opencodex и собственный `thread-id` запроса; ID родительского треда не даёт доступа к сохранённой задаче дочернего. Без этих идентификаторов, после перезапуска прокси или для старых непривязанных записей кэша отправьте весь разговор без `previous_response_id`. Состояние, сохранённое в этом режиме, остаётся привязанным после выхода; в `v1` по умолчанию непривязанное состояние продолжает работать в области родительского треда, включая loopback. Сохранённые копии остаются на диске. Ограничения ниже относятся к зашифрованному пути V2 без этой опции. Прежние режимы остаются доступны.
+
OpenCodex устанавливается с режимом подагентов **v1**. Страницы Dashboard, Models и Subagents
просят подтверждение перед переходом на **base** или **v2** и ссылаются на эту страницу.
-CLI подтверждения не запрашивает.
+Для перехода в `v2-plaintext` CLI требует явный флаг подтверждения.
-Причина конкретна: на v2 модель с маршрутизацией не может прочитать задачу,
+Причина конкретна: на неизменённом зашифрованном пути v2 модель с маршрутизацией не может прочитать задачу,
переданную ей нативной моделью ChatGPT. Это самый распространённый способ
делегирования — основной GPT запускает подагента Grok, Claude или GLM — и на
-v2 он каждый раз завершается ошибкой.
+v2 нечитаемая зашифрованная задача завершается ошибкой на этой границе. Экспериментальный режим выше меняет создание новых сообщений, но не расшифровывает существующие.
## Что вы увидите
@@ -44,7 +52,7 @@ backend ChatGPT. Ключ остаётся там. У OpenCodex его нико
Настройки прокси не включают локальную расшифровку. Экспериментальная `agentTaskRecovery` может запросить восстановление подходящей задачи у backend ChatGPT, но не расшифровывает её локально. Описанные выше требования разрешения, допустимости и обработки сбоев сохраняются.
-Три схемы не затронуты. Их полезно перечислить, чтобы стало ясно, где именно
+В таблице ниже описан зашифрованный путь v2 без экспериментального компилятора. Она показывает, где именно
возникает ошибка:
| Схема | v1 | v2 |
@@ -76,13 +84,14 @@ OpenCodex зафиксировал последствие в [#92](https://githu
нельзя. Задача служит указателем на работу upstream, а не ожидает исправления
сопровождающими здесь.
-## Что теперь делают три режима
+## Что теперь делают режимы
| Режим | Инструменты | Когда выбирать |
| --- | --- | --- |
| **v1** (по умолчанию) | Каждая модель объявляет классические инструменты запуска в пространстве имён. При запуске можно сразу указать другую модель. | Если вы делегируете между провайдерами. Это режим поставки по умолчанию. |
| **base** | Настройки моделей upstream: Sol и Terra используют v2, Luna — v1, остальные следуют собственному флагу Codex. | Если вам нужен предусмотренный Codex режим для каждой модели и вы делегируете только внутри одного провайдера. |
| **v2** | Каждая модель объявляет плоские инструменты параллельной работы. | Если вам нужна новая модель параллельных сессий, а основной агент и подагент находятся по одну сторону границы. |
+| **v2-plaintext** | V2 для новых сессий; подходящие сообщения задач передаются открытым текстом. | При явном согласии на сохранение текста задач. |
base стоит вторым, а не первым, потому что его настройки переводят Sol и Terra —
две модели, *из которых* чаще всего делегируют, — на v2. Для этой проблемы base
@@ -101,7 +110,7 @@ base стоит вторым, а не первым, потому что его
Любой ответ записывается, и уведомление больше не появляется. Если закрыть
его без ответа, оно снова появится при следующем открытии дашборда.
-Изменение режима действует на **новые** сессии Codex. Начните новую сессию;
+Изменения закреплений каталога действуют на **новые** сессии Codex; компилятор открытого текста следует текущей настройке для подходящих запросов, включая последующие запросы существующих V2-сессий. Начните новую сессию;
если долго работающий хост приложения всё ещё показывает старые инструменты,
выполните `ocx sync` и перезапустите соответствующий интерфейс.
@@ -138,7 +147,7 @@ base стоит вторым, а не первым, потому что его
## Изменение режима
-Dashboard, Models и Subagents имеют одинаковый переключатель v1/base/v2, и все
+Dashboard, Models и Subagents имеют одинаковый переключатель v1/base/v2/v2-plaintext, и все
три запрашивают подтверждение перед base или v2. В CLI:
```bash
@@ -146,7 +155,7 @@ ocx v2 status
ocx v2 mode v1
```
-CLI подтверждение не запрашивает. Настройка та же, поэтому выбирайте её,
+Для `v2-plaintext` CLI требует флаг подтверждения, указанный выше. Выбирайте режим,
учитывая изложенные здесь ограничения.
## Лимит одновременно работающих подагентов
diff --git a/docs-site/src/content/docs/ru/reference/cli.md b/docs-site/src/content/docs/ru/reference/cli.md
index 5535896db74..3572453f53b 100644
--- a/docs-site/src/content/docs/ru/reference/cli.md
+++ b/docs-site/src/content/docs/ru/reference/cli.md
@@ -58,6 +58,8 @@ browser-state CLI не покрывает; настройка Cloudflare Tunnel
подтверждение, в неинтерактивном использовании требуют `--yes`. Этот флаг — явное согласие;
отсутствие флага не должно молча подтверждать действие.
+Чтобы включить экспериментальный режим, выполните `ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages`. Общие `config set` и `config import` отказывают при новом переходе в режим, поскольку специальная команда также согласует переход нативного режима. Для восстановления экспорта с `multiAgentMode: "v2-plaintext"` сначала выполните этот переход с подтверждением, затем импортируйте файл. Восстановление уже активного режима, изменение других настроек и выход из режима разрешены. Независимое значение `plaintextV2AgentMessages` не меняется.
+
## Version и внутренние dispatch-target'ы
`ocx --version`, `ocx -v` и `ocx version` печатают одну строку с версией, пригодную для
diff --git a/docs-site/src/content/docs/ru/reference/cli/agents.md b/docs-site/src/content/docs/ru/reference/cli/agents.md
index 2b051ead1d7..a68f254affc 100644
--- a/docs-site/src/content/docs/ru/reference/cli/agents.md
+++ b/docs-site/src/content/docs/ru/reference/cli/agents.md
@@ -28,9 +28,9 @@ ocx agent sidecar web --enabled off
иначе завершающая строка `Codex config:`) и предлагает `ocx sync`, если запись не
удалась. Флаг работает и для `vision`.
-### `ocx v2 |threads >`
+### `ocx v2 |threads >`
-Управляйте feature flag'ом Codex `multi_agent_v2` и трёхсостоянием multi-agent surface mode.
+Управляйте feature flag'ом Codex `multi_agent_v2` и четырёхсостоянием multi-agent surface mode.
| Подкоманда | Действие |
| --- | --- |
@@ -39,7 +39,11 @@ ocx agent sidecar web --enabled off
| `off` | Выключить `multi_agent_v2` и пересинхронизировать каталог. |
| `mode v1` | Принудительно перевести все модели на v1, отключить native v2 и сохранить текущий thread limit. |
| `mode default` | Уважать upstream pin'ы surface у моделей. |
-| `mode v2` | Принудительно перевести все модели на v2, включить native v2 и сохранить текущий thread limit. |
+| `mode v2` | Выбрать v2 для моделей и сохранить thread limit. При выключенном `keep-native-v1` включается глобальный native v2; при включённом глобальное принуждение отключается и используются pin'ы каталога. |
+| `keep-native-v1 on\|off` | В режиме v2 оставить нативные модели ChatGPT на v1, а маршрутизируемые — на v2; включение отключает глобальное принуждение V2 перед синхронизацией каталога. |
+| `mode-hint ` | Задать подсказку проактивного делегирования для всех моделей и уровней effort. |
+| `mode-hint --clear` | Удалить подсказку и вернуть политику, зависящую от effort. |
+| `mode v2-plaintext --acknowledge-plaintext-agent-messages` | Выбирает V2 для новых сессий и передаёт подходящие задачи открытым текстом без глобального принуждения. Для включения нужен `--acknowledge-plaintext-agent-messages`. |
| `threads ` | Задать активный v1/v2 thread limit как целое число не меньше 1. |
```bash
@@ -54,7 +58,7 @@ ocx v2 threads 16
Codex. При переходах mode и feature flag текущий числовой thread limit переносится между
допустимыми ключами Codex для v1/v2; если переход не удался, исходный `config.toml`
восстанавливается. Изменения применяются к новым сессиям Codex, а уже запущенные сохраняют свою
-закреплённую surface.
+закреплённую surface. При включённой компиляции последующие подходящие запросы существующих V2-сессий также обрабатываются; шифротекст не расшифровывается, а отключение не удаляет сохранённые копии. Переключатель Ultra в дашборде доступен при явно выбранном `v2` с включённой нативной функцией или при `v2-plaintext`, где V2 закреплён в каталоге; одного `ocx v2 on` недостаточно.
## Combo routing
diff --git a/docs-site/src/content/docs/ru/reference/configuration/agents.md b/docs-site/src/content/docs/ru/reference/configuration/agents.md
index ef8a4da0d81..b98c47ce054 100644
--- a/docs-site/src/content/docs/ru/reference/configuration/agents.md
+++ b/docs-site/src/content/docs/ru/reference/configuration/agents.md
@@ -10,7 +10,8 @@ description: Multi-agent surface, guidance при делегировании, pr
| Поле | Тип | По умолчанию | Значение |
| --- | --- | --- | --- |
-| `multiAgentMode?` | `"v1" \| "default" \| "v2"` | `"default"` | `v1` штампует все модели как v1; `v2` штампует все модели как v2. `default` восстанавливает upstream pin'ы (Sol/Terra — v2, Luna — v1) и для остальных следует native flag `multi_agent_v2`. Применяется к новым сессиям. |
+| `multiAgentMode?` | `"v1" \| "default" \| "v2" \| "v2-plaintext"` | `"default"` | `v1` штампует все модели как v1; `v2` штампует все модели как v2. `default` восстанавливает upstream pin'ы (Sol/Terra — v2, Luna — v1) и для остальных следует native flag `multi_agent_v2`. Закрепления каталога применяются к новым сессиям. `v2-plaintext` выбирает V2 для новых сессий и передаёт подходящие задачи открытым текстом без глобального принуждения. Для включения нужен `--acknowledge-plaintext-agent-messages`. |
+| `plaintextV2AgentMessages?` | `boolean` | — (не задано) | Экспериментальная опция: явное `true` или `multiAgentMode: "v2-plaintext"` включает передачу аргументов сообщений `spawn_agent`, `send_message` и `followup_task` открытым текстом для подходящих запросов. |
| `subagentModels?` | `string[]` | `gpt-6-astra`, `gpt-6.1-sol`, `gpt-6-luna` | До пяти bare native-id, account-qualified id `/` или routed-id `provider/model`, которые показываются первыми в списке подагентов. Для нового выбора панель предлагает bare native- и routed-id. При сохранении она сохраняет уже настроенные точные account-qualified id, включая отсутствующие в текущем каталоге. Для добавления нового точного account-qualified id используйте `ocx agent subagents set` или измените конфигурацию. После [однократного обновления Astra](/reference/configuration/agents/#astra-roster-upgrade) явно пустой список сохраняется. |
| `injectionModel?` | `string` | — | Предпочитаемая native- или routed-модель подагента, которую proxy использует в собственном guidance v2. |
| `injectionEffort?` | `string` | — | Предпочитаемый effort (`low`–`ultra`), имеющий смысл только вместе с `injectionModel`. |
@@ -23,19 +24,19 @@ description: Multi-agent surface, guidance при делегировании, pr
| `effortCap?` | `string` | — | Жёсткий потолок effort для qualifying v2 main-turn'ов и помеченных spawned-child turn'ов. Принимает `low`–`ultra`. |
| `subagentEffortCap?` | `string` | — | Дополнительный потолок только для spawned-child turn'ов. Если применимы оба cap'а, выигрывает более низкий. |
-Управляйте surface через дашборд или `ocx v2 status|on|off|mode |threads `.
-Смена режима применяется к новым сессиям. `maxConcurrentThreadsPerSession` — это поле
+Управляйте surface через дашборд или `ocx v2 status|on|off|mode |threads `.
+Изменения закреплений каталога применяются к новым сессиям; компилятор открытого текста следует текущей настройке для подходящих запросов, включая последующие запросы существующих V2-сессий. `maxConcurrentThreadsPerSession` — это поле
`PUT /api/v2`, а не ключ `config.json`; `ocx v2 threads ` записывает
`max_concurrent_threads_per_session` в `[features.multi_agent_v2]` файла
`$CODEX_HOME/config.toml` после включения v2.
Management API предоставляет `GET`/`PUT /api/v2`, `/api/injection-model`, `/api/effort-caps`,
`/api/subagent-models` и `/api/subagent-model-fallback`. Обновления injection-model частичные;
-custom prompt на этом API передаётся полем `prompt`.
+custom prompt на этом API передаётся полем `prompt`. При переходе в `v2-plaintext` запрос `PUT /api/v2` требует `plaintextAgentMessagesAcknowledged: true`; дашборд запрашивает согласие. CLI: `ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages`. Общие `config set` и `config import` отказывают при новом переходе: перед восстановлением экспорта с `multiAgentMode: "v2-plaintext"` сначала выполните подтверждённый переход, затем импортируйте файл. Уже активный режим можно восстановить, другие настройки — изменить, а из режима — выйти.
## Всегда проактивное делегирование
-**Всегда проактивное делегирование** в Subagents → Дополнительно (прежнее название — **Ultra mode**) меняет только условие запуска делегирования, не меняя reasoning effort. Рекомендуемый preset сохраняет инструкции пользователя, границы полномочий, область задачи и правила работы с инструментами.
+**Всегда проактивное делегирование** в Subagents → Дополнительно (прежнее название — **Ultra mode**) меняет только условие запуска делегирования, не меняя reasoning effort. Рекомендуемый preset сохраняет инструкции пользователя, границы полномочий, область задачи и правила работы с инструментами. Переключатель дашборда доступен при явно выбранном `v2` с включённой нативной функцией или при `v2-plaintext`, где V2 закреплён в каталоге; одного `ocx v2 on` недостаточно.
`GET` и `PUT /api/v2` дополнительно возвращают `multiAgentModeHintRecommendation: { text, revision }`. При включении или восстановлении preset дашборд использует текст сервера без встроенного запасного варианта. Если старый сервер не возвращает рекомендацию или возвращает некорректное значение, применение и восстановление preset недоступны; существующий custom hint по-прежнему можно редактировать или удалять. Восстановление preset меняет только локальный черновик; действие сохранения записывает его.
@@ -140,3 +141,9 @@ Cap'ы умеют только понижать effort. Они опускают
Если нужен объясняющий вариант для начинающих о поведении v1, default и v2, см.
[Поверхность подагентов](/guides/sub-agent-surface/).
+
+## Plaintext v2 agent messages
+
+`plaintextV2AgentMessages` по умолчанию не задан. Явное `true` или отдельно выбранный `multiAgentMode: "v2-plaintext"` включает экспериментальный компилятор. Режим закрепляет V2 в каталоге для новых сессий при выключенном глобальном принуждении и не меняет независимый флаг; после выхода из режима действует прежнее значение флага. Компилятор следует текущей настройке и для последующих подходящих запросов существующих V2-сессий. Существующий шифротекст не расшифровывается, история не переписывается, а отключение не удаляет копии из истории, запросов провайдеру или локального состояния ответов и отладки.
+
+Вызывающая сторона должна использовать Responses, а конечный маршрут — `adapter: "openai-responses"`, `authMode: "forward"` и точный URL `https://chatgpt.com/backend-api/codex`. Провайдеры с API-ключом OpenAI, совместимые шлюзы, маршруты к другим провайдерам и клиенты без Responses исключены. Для подходящих запросов компилятор обрабатывает аргументы `spawn_agent`, `send_message` и `followup_task`, не выполняя дополнительный запрос восстановления. HTTPS и аутентификация сохраняются; текст может оставаться в истории Codex, запросах провайдеру, `responses-state.json` и его spill-файлах и в `usage-debug.jsonl` при включённой отладке. Поведение зависит от недокументированных деталей ChatGPT и Codex и может перестать работать после обновления. Независимый флаг можно установить командой `ocx config set plaintextV2AgentMessages true`; после изменения перезапустите прокси.
diff --git a/docs-site/src/content/docs/tr/guides/codex-integration.md b/docs-site/src/content/docs/tr/guides/codex-integration.md
index 30862e73896..e6233a9147d 100644
--- a/docs-site/src/content/docs/tr/guides/codex-integration.md
+++ b/docs-site/src/content/docs/tr/guides/codex-integration.md
@@ -217,6 +217,8 @@ olduğunda `supports_websockets = true` bildirir; geri döngüde Codex'in yerle
sağlayıcısı önce WebSocket'i deneyebilir ve devre dışı bırakılmış bir proxy
`426` döndürür, böylece Codex HTTP/SSE'ye geri döner.
+`v2-plaintext` modu veya `plaintextV2AgentMessages` bayrağı etkin olduğunda yerel yeniden oynatma, aynı kabul edilmiş OpenCodex çağıranını ve isteğin kendi boş olmayan `thread-id` değerini gerektirir. Üst iş parçacığı, geri döngü adresi, yukarı akış kimlik bilgisi veya yer tutucu anahtar bu kimlik değildir. Kabul edilmiş çağıran kimliği olmayan istemcilerin ve kendi iş parçacığı olmayan isteklerin `previous_response_id` olmadan tüm konuşmayı yeniden göndermesi gerekir. Varsayılan geri döngü Codex ve DSH yapılandırmaları bu çağıran kimliğini oluşturmaz. Ayarlardan biri etkinken saklanan durum, ayar devre dışı bırakıldıktan sonra da bağlı kalır. Varsayılan `v1` modunda bağlı olmayan durum, varsayılan geri döngü çağıranları dahil mevcut üst iş parçacığı kapsamındaki devam davranışını korur. Bu, doğrudan yukarı akış hizmetinin sahip olduğu Responses kimliklerinden ayrıdır.
+
## İş parçacığı kimliği ve geçmişi
Varsayılan geri döngü formu yeni iş parçacıklarının Codex'in yerel `openai`
diff --git a/docs-site/src/content/docs/tr/guides/sub-agent-surface.md b/docs-site/src/content/docs/tr/guides/sub-agent-surface.md
index 472cbd048fa..d507743fdb3 100644
--- a/docs-site/src/content/docs/tr/guides/sub-agent-surface.md
+++ b/docs-site/src/content/docs/tr/guides/sub-agent-surface.md
@@ -18,12 +18,13 @@ ajanınızın ne zaman devretmesi gerektiğine karar vermez.
| Mod | Codex ne alır? | Kim seçmelidir? |
| --- | --- | --- |
-| **v1** | Klasik ad alanlı `spawn_agent`, `send_input`, `resume_agent` ve `close_agent` araçları. Bir spawn doğrudan başka bir modeli seçebilir. | Farklı sağlayıcılar arasında, özellikle yerelden yönlendirilen çocuklara güvenilir delegasyona ihtiyaç duyan yeni başlayanlar. |
-| **base** (varsayılan) | Yukarı akış model sabitlemeleri: GPT-5.6 Sol/Terra v2 kullanır, Luna v1 kullanır ve sabitlenmemiş modeller Codex'in `multi_agent_v2` özellik bayrağını takip eder. | Çoğu kullanıcı. Küresel olarak birini zorlamadan her model için Codex'in hedeflenen arayüzünü takip eder. |
+| **v1** (varsayılan) | Klasik ad alanlı `spawn_agent`, `send_input`, `resume_agent` ve `close_agent` araçları. Bir spawn doğrudan başka bir modeli seçebilir. | Farklı sağlayıcılar arasında, özellikle yerelden yönlendirilen çocuklara güvenilir delegasyona ihtiyaç duyan yeni başlayanlar. |
+| **base** | Yukarı akış model sabitlemeleri: GPT-5.6 Sol/Terra v2 kullanır, Luna v1 kullanır ve sabitlenmemiş modeller Codex'in `multi_agent_v2` özellik bayrağını takip eder. | Çoğu kullanıcı. Küresel olarak birini zorlamadan her model için Codex'in hedeflenen arayüzünü takip eder. |
| **v2** | Eşzamanlı oturumlarla düz `spawn_agent`, `send_message`, `followup_task`, `interrupt_agent` ve ajan listesi araçları. | Daha yeni eşzamanlı iş akışını isteyen ve model kalıtımını ve aşağıdaki şifrelenmiş görev sınırlamasını anlayan kullanıcılar. |
+| **v2-plaintext** | V2 | Yeni oturumlar için V2 seçer ve genel zorlamayı kapalı tutarak uygun görevleri düz metin iletir. Giriş için `--acknowledge-plaintext-agent-messages` gerekir. |
:::tip[Emin değil misiniz?]
-**base** ile başlayın. Sağlayıcılar arası yetkilendirmenin öngörülebilir şekilde
+**v1** varsayılanıyla başlayın. Sağlayıcılar arası yetkilendirmenin öngörülebilir şekilde
çalışması gerektiğinde **v1**'i seçin. Yalnızca her katalog girdisi genelinde
daha yeni oturum modelini özellikle istediğinizde **v2**'ye zorlayın.
:::
@@ -359,3 +360,16 @@ sabitler.
Model bağlam sınırı alt ajan modundan bağımsızdır. Modeller sayfasında
yapılandırın; yerel OpenAI modelleri gerçek bağlam pencerelerini korur.
+
+Deneysel `plaintextV2AgentMessages` yeni yapılandırmada ayarlanmamıştır. Açık `true`
+veya ayrı seçilen `v2-plaintext` modu derleyiciyi etkinleştirir. Mod genel zorlamayı
+kapatırken yeni sohbetler için V2 seçer; moddan çıkmak bağımsız alanı değiştirmez.
+Derleme mevcut V2 oturumlarının sonraki uygun istekleri dahil geçerli ayarı izler.
+Mevcut şifreli metin çözülmez, saklanan geçmiş yeniden yazılmaz ve devre dışı bırakma
+saklanan kopyaları silmez. Çağıran Responses protokolünü kullanmalı ve son hedef
+`adapter: "openai-responses"`, `authMode: "forward"` ve tam
+`https://chatgpt.com/backend-api/codex` adresine sahip kurallı ChatGPT rotası olmalıdır;
+API anahtarlı OpenAI sağlayıcıları, özel ağ geçitleri, diğer sağlayıcılar ve Responses
+dışı çağıranlar hariçtir. Görev metni Codex geçmişinde, sağlayıcı isteklerinde ve
+yerel yanıt/hata ayıklama durumunda kalabilir; HTTPS şifrelemesi korunur.
+Ayrıntılar için [ajan yapılandırmasına](/tr/reference/configuration/agents/#düz-metin-v2-ajan-mesajları) bakın.
diff --git a/docs-site/src/content/docs/tr/guides/subagent-v1-default.md b/docs-site/src/content/docs/tr/guides/subagent-v1-default.md
index 9a282fdb27c..82f9d9f442d 100644
--- a/docs-site/src/content/docs/tr/guides/subagent-v1-default.md
+++ b/docs-site/src/content/docs/tr/guides/subagent-v1-default.md
@@ -7,10 +7,44 @@ OpenCodex, alt ajan arayüzü **v1** olarak kurulur. Dashboard, Models ve Subage
sayfaları **base** veya **v2** moduna geçmeden önce onay ister; bu sayfa da o
onayın bağlantı hedefidir. CLI onay istemez.
-Nedeni dar ve nettir: v2'de ChatGPT yerel modelinden yönlendirilen modele
-devredilen görevi yönlendirilen model okuyamaz. İnsanların en sık kullandığı
-devir biçimi budur — GPT ebeveyninin Grok, Claude veya GLM çocuğu oluşturması —
-ve v2'de her seferinde başarısız olur.
+Değişmemiş şifreli v2 yolunda, ChatGPT yerel modelinden yönlendirilen modele
+devredilen okunamayan görev sağlayıcı sınırında başarısız olur. Aşağıdaki deneysel
+seçenek yeni görev mesajlarının üretimini değiştirir; mevcut şifreli mesajları çözmez.
+
+## Düz metin görev mesajlarıyla isteğe bağlı V2
+
+**V2 · düz metin görevler** (`v2-plaintext`), genel V2 zorlamasını kapalı tutarak
+yeni sohbetler için V2 katalog sabitlemelerini seçer. V2 görev adlarını, hiyerarşiyi,
+takip mesajlarını, iptali ve eşzamanlılığı korur; uygun kurallı ChatGPT Responses
+istekleri için deneysel düz metin derleyicisini kullanır. Mevcut sohbetler kayıtlı
+seçimlerini korur ve güncelleme bu açık seçeneği kendiliğinden seçmez. Derleyici,
+mevcut V2 oturumlarının sonraki uygun istekleri dahil, her uygun istekte geçerli
+ayarı izler.
+
+Bu modda yerel yanıt kimliğiyle devam, kabul edilmiş aynı opencodex API anahtarı
+kimliğini ve isteğin kendi `thread-id` değerini gerektirir; üst iş parçacığı kimliği
+çocuğun saklanan görevine erişim sağlamaz. Kimliklerden biri yoksa, proxy yeniden
+başlatıldıysa veya eski bağlı olmayan önbellek girdileri kullanılıyorsa konuşmanın
+tamamını `previous_response_id` olmadan yeniden gönderin. Bu modda saklanan durum,
+mod değiştikten sonra da bağlı kalır. Varsayılan `v1`, geri döngü çağıranları dahil
+bağlı olmayan durum için mevcut üst iş parçacığı kapsamındaki devamı korur.
+
+Kontrol paneli, görev metninin Codex geçmişinde, seçilen sağlayıcıya gönderilen
+isteklerde ve disk üzerindeki devam anlık görüntüleri veya taşmaları dahil yerel
+yanıt/hata ayıklama durumunda kalabileceğinin onaylanmasını ister. HTTPS ve kimlik
+doğrulama korunur; ek kurtarma modeli çağrısı yapılmaz. Mevcut şifreli metnin şifresi
+çözülmez, saklanan geçmiş yeniden yazılmaz ve devre dışı bırakma saklanan kopyaları
+silmez. Desteklenmeyen arka uç veya istemci davranışı yine başarısız olabilir. Normal
+v1 ve karma yerel-v1/yönlendirilmiş-v2 modları kullanılabilir.
+
+```bash
+ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages
+```
+
+Canlı hedefi `ocx v2 status --live --json` ile kontrol edin. Yerel hedef için her iki komuttan `--live` seçeneğini çıkarın ve `ocx v2 status --json`
+ile durumu okuyun; yapılandırılan durum ve katalog yakınsaması, başarılı bir gerçek
+görev devriyle aynı şey değildir. Çıkmak için başka bir mod seçin; bağımsız olarak
+ayarlanmış `plaintextV2AgentMessages` değeri korunur.
## Bu durumda ne görürsünüz?
@@ -36,15 +70,15 @@ güvenle yanlış yanıt üretmesine yol açardı.
v1'de ebeveyn çocuğun görevini düz metin olarak üretir. OpenCodex onu okur,
yönlendirir ve yönlendirilen çocuk uygulanabilir bir görev alır.
-v2'de ebeveyn, ChatGPT arka ucunun ürettiği `encrypted_content` olarak görevi
+Şifreli v2 yolunda ebeveyn, ChatGPT arka ucunun ürettiği `encrypted_content` olarak görevi
verir. Anahtar o arka uçta kalır. OpenCodex anahtara hiç sahip olmadığından
proxy'nin çözebileceği veya yeniden yazabileceği bir şey yoktur: değer, bir
bayrağın arkasındaki düz metin değil gerçekten şifreli metindir. Bu yüzden
-sorun yapılandırma hatası değil yapısaldır; proxy tarafı ayarlar yerel şifre çözmeyi etkinleştiremez.
+mevcut şifreli metnin sorunu yapılandırma hatası değil yapısaldır; düz metin seçeneği onu çözmez, yeni mesajları farklı üretir.
Hiçbir proxy ayarı yerel şifre çözmeyi etkinleştirmez. Deneysel `agentTaskRecovery`, uygun görevleri kurtarmak için ChatGPT arka ucuna başvurabilir; şifreli metni yerel olarak çözmez. Yukarıdaki yetkilendirme, uygunluk ve hata sınırları geçerlidir.
-Üç topoloji etkilenmez; bu, hatanın şeklini açıklar:
+Aşağıdaki karşılaştırma şifreli v2 yolu içindir; düz metin seçeneği uygun yeni görevleri farklı üretir:
| Topoloji | v1 | v2 |
| --- | --- | --- |
@@ -72,13 +106,14 @@ olarak kaydetti ve planlanmadığı için kapattı: bu depoda çözülecek bir
yoktur; konu, buradaki bakım sorumlularını bekleyen görev değil yukarı akış
işine işarettir.
-## Üç mod şimdi ne yapıyor?
+## Modlar şimdi ne yapıyor?
| Mod | Arayüz | Ne zaman seçilmeli? |
| --- | --- | --- |
| **v1** (varsayılan) | Her model klasik ad alanlı spawn araçlarını sunar. Spawn başka bir modeli doğrudan adlandırabilir. | Sağlayıcılar arasında görev devreden herkes. Sunulan varsayılan budur. |
| **base** | Yukarı akış model sabitlemeleri: Sol ve Terra v2, Luna v1 kullanır; sabitlenmemiş modeller Codex'in kendi bayrağını izler. | Codex'in model başına amaçlanan arayüzünü ve yalnızca tek sağlayıcı içinde görev devrini istiyorsanız. |
| **v2** | Her model düz eşzamanlı araçları sunar. | Yeni eşzamanlı oturum modelini istiyorsanız ve ebeveyn ile çocuk sınırın aynı tarafındaysa. |
+| **v2-plaintext** | Genel zorlama kapalıyken yeni oturumlar için V2; uygun ChatGPT görev mesajları düz metin. | Açık onayla deneysel düz metin iletimini istiyorsanız. |
base ilk değil ikinci sıradadır, çünkü sabitlemeleri insanların en sık görev
devrettiği iki model olan Sol ve Terra'yı v2'ye koyar. base bu sorun için ara
@@ -97,7 +132,7 @@ yanıtınızı bekler.
Her iki yanıt da kaydedilir ve bildirim geri gelmez. Yanıtlamadan kapatırsanız
kontrol panelini sonraki açışınızda yeniden görünür.
-Mod değişiklikleri **yeni** Codex oturumlarına uygulanır. Seçimden sonra yeni
+Katalog modu değişiklikleri **yeni** Codex oturumlarına uygulanır; düz metin derleyicisi mevcut V2 oturumlarının sonraki uygun isteklerini de etkiler. Seçimden sonra yeni
oturum başlatın; uzun süredir çalışan bir App ana bilgisayarı eski arayüzü
gösteriyorsa `ocx sync` çalıştırıp o Codex arayüzünü yeniden başlatın.
diff --git a/docs-site/src/content/docs/tr/reference/cli.md b/docs-site/src/content/docs/tr/reference/cli.md
index 7df93536661..729a23b7d86 100644
--- a/docs-site/src/content/docs/tr/reference/cli.md
+++ b/docs-site/src/content/docs/tr/reference/cli.md
@@ -65,6 +65,15 @@ Onay bildiren yıkıcı kaldırma, içe aktarma, kredi tüketimi ve güncelleme
işlemleri etkileşimsiz kullanımda `--yes` gerektirir. Bayrak açık bir
katılımdır; atlanması eylemi sessizce onaylamamalıdır.
+## Düz metin alt ajan moduna geçiş
+
+Deneysel moda girmek için `ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages`
+kullanın. Genel `config set` ve `config import`, yerel mod geçişini özel komut
+yönettiğinden bu moda yeni girişi reddeder. `multiAgentMode: "v2-plaintext"` içeren
+dışa aktarılmış bir yapılandırmayı geri yüklemeden önce onaylı geçişi tamamlayın,
+sonra dosyayı içe aktarın. Zaten etkin modu geri yüklemek, diğer ayarları değiştirmek
+ve moddan çıkmak mümkündür. Bağımsız `plaintextV2AgentMessages` tercihi değişmez.
+
## Sürüm ve dahili dağıtım hedefleri
`ocx --version`, `ocx -v` ve `ocx version` betik dostu tek bir sürüm satırı
diff --git a/docs-site/src/content/docs/tr/reference/cli/agents.md b/docs-site/src/content/docs/tr/reference/cli/agents.md
index e7b5323efb1..583d7601cfd 100644
--- a/docs-site/src/content/docs/tr/reference/cli/agents.md
+++ b/docs-site/src/content/docs/tr/reference/cli/agents.md
@@ -29,9 +29,9 @@ komut tetiklediği Codex tarafı yazmayı bildirir (`--json` içinde `codexWebSe
halde son satırda `Codex config:`) ve yazma yapılamadığında `ocx sync` adresini gösterir.
Bayrak `vision` için de çalışır.
-### `ocx v2 |threads |mode-hint >`
+### `ocx v2 |keep-native-v1 |threads |mode-hint >`
-Codex `multi_agent_v2` özellik bayrağını ve üç durumlu çoklu ajan yüzey modunu
+Codex `multi_agent_v2` özellik bayrağını ve dört durumlu çoklu ajan yüzey modunu
yönetin.
| Alt komut | Eylem |
@@ -41,7 +41,9 @@ yönetin.
| `off` | `multi_agent_v2` özelliğini devre dışı bırakın ve kataloğu yeniden senkronize edin. |
| `mode v1` | Tüm modelleri v1'e zorlayın, yerel v2'yi devre dışı bırakın ve aktif iş parçacığı sınırını koruyun. |
| `mode default` | Yukarı akış model yüzeyi sabitlemelerine saygı gösterin. |
-| `mode v2` | Tüm modelleri v2'ye zorlayın, yerel v2'yi etkinleştirin ve aktif iş parçacığı sınırını koruyun. |
+| `mode v2` | İş parçacığı sınırını koruyarak modelleri v2 yapın. `keep-native-v1` kapalıysa genel yerel v2 etkinleşir; açıksa genel zorlama kapatılır ve katalog sabitlemeleri kullanılır. |
+| `keep-native-v1 on\|off` | `mode v2` içinde ChatGPT yerel modellerini v1, yönlendirilen modelleri v2 üzerinde tutun. Etkinleştirme katalog eşitlemesinden önce genel V2 zorlamasını kapatır. |
+| `mode v2-plaintext --acknowledge-plaintext-agent-messages` | Yeni oturumlar için V2 seçer ve genel zorlamayı kapalı tutarak uygun görevleri düz metin iletir. Giriş için `--acknowledge-plaintext-agent-messages` gerekir. |
| `threads ` | Aktif v1/v2 iş parçacığı sınırını en az 1 olan bir tamsayıya ayarlayın. |
| `mode-hint ` | Her model ve çaba için Proaktif yetkilendirme ipucunu (Ultra modu) ayarlayın. |
| `mode-hint --clear` | İpucunu kaldırın, böylece çabadan türetilen politika (ultra = proaktif) devam eder. |
@@ -72,8 +74,9 @@ böylece herhangi bir model ve herhangi bir akıl yürütme çabası Proaktif
yetkilendirme istemini alır. Akıl yürütme çabasının kendisini **değiştirmez**.
Eksik bir argüman veya yalnızca boşluk içeren bir değer reddedilir; yalnızca
`--clear` ipucunu kaldırır. Alt Ajanlar kontrol panelinin Ultra modu **açık**
-anahtarının daha katı bir kapısı vardır: yerel özelliğin açık bir v2 yüzeyiyle
-(`ocx v2 mode v2`) etkinleştirilmesini gerektirir; tek başına `ocx v2 on` bu
+anahtarının daha katı bir kapısı vardır: yerel özelliğin açık v2 yüzeyiyle
+(`ocx v2 mode v2`) etkinleştirilmesini veya genel zorlama kapalıyken
+`v2-plaintext` modunu gerektirir; tek başına `ocx v2 on` bu
kontrol paneli kapısını karşılamaz.
## Kombo yönlendirme
diff --git a/docs-site/src/content/docs/tr/reference/configuration/agents.md b/docs-site/src/content/docs/tr/reference/configuration/agents.md
index b3cfd1e3dfa..3d4ccdcd3d3 100644
--- a/docs-site/src/content/docs/tr/reference/configuration/agents.md
+++ b/docs-site/src/content/docs/tr/reference/configuration/agents.md
@@ -11,7 +11,7 @@ kontrol eder.
| Alan | Tip | Varsayılan | Anlamı |
| --- | --- | --- | --- |
-| `multiAgentMode?` | `"v1" \| "default" \| "v2"` | `"default"` | `v1` her katalog modelini v1 olarak damgalar; `v2` her modeli v2 olarak damgalar. `default` yukarı akış sabitlemelerini geri yükler (Sol/Terra v2, Luna v1) ve aksi takdirde yerel `multi_agent_v2` bayrağını takip eder. Yeni oturumlara uygulanır. |
+| `multiAgentMode?` | `"v1" \| "default" \| "v2" \| "v2-plaintext"` | `"default"` | `v1` her katalog modelini v1 olarak damgalar; `v2` her modeli v2 olarak damgalar. `default` yukarı akış sabitlemelerini geri yükler (Sol/Terra v2, Luna v1) ve aksi takdirde yerel `multi_agent_v2` bayrağını takip eder. Katalog sabitlemeleri yeni oturumlara uygulanır. `v2-plaintext` genel zorlamayı kapalı tutarak V2 seçer ve uygun görevleri düz metin iletir; derleme mevcut V2 oturumlarının sonraki uygun isteklerini de etkiler. Giriş için `--acknowledge-plaintext-agent-messages` gerekir. |
| `subagentModels?` | `string[]` | `gpt-6-astra`, `gpt-6.1-sol`, `gpt-6-luna` | Alt ajan seçicisinde öne çıkan en fazla beş yalın yerel, hesap nitelikli `/` veya yönlendirilen `provider/model` kimliği. Kontrol paneli yeni seçimler için yalın yerel ve yönlendirilen kimlikleri sunar. Kaydederken, geçerli katalogda bulunmayanlar dahil, önceden yapılandırılmış tam hesap nitelikli kimlikleri korur. Yeni bir tam hesap nitelikli kimlik eklemek için `ocx agent subagents set` kullanın veya yapılandırmayı düzenleyin. [Tek seferlik Astra yükseltmesinden](/reference/configuration/agents/#astra-roster-upgrade) sonra açıkça boş bırakılan liste korunur. |
| `injectionModel?` | `string` | — | Proxy kaynaklı v2 yetkilendirme rehberliğinde kullanılan tercih edilen yerel veya yönlendirilen alt ajan modeli. |
| `injectionEffort?` | `string` | — | Yalnızca `injectionModel` ile anlamlı olan tercih edilen çaba (`low` ile `ultra` arası). |
@@ -23,11 +23,11 @@ kontrol eder.
| `subagentModelFallbackPollMs?` | `number` | `60000` | Kullanılabilirlik probu önbellek aralığı. 1000 ms'nin altındaki değerler varsayılana geri döner. |
| `effortCap?` | `string` | — | Uygun v2 ana turları ve işaretlenmiş çocuk turları için kesin tavan. `low` ile `ultra` arasını kabul eder. |
| `subagentEffortCap?` | `string` | — | Yalnızca oluşturulan çocuk turları için ek tavan. Her iki sınır da geçerli olduğunda daha düşük olan kazanır. |
+| `plaintextV2AgentMessages?` | `boolean` | — (ayarlanmamış) | Deneysel tercih. Açık `true` veya `multiAgentMode: "v2-plaintext"`, uygun yerel ChatGPT v2 ebeveynlerinin `spawn_agent`, `send_message` ve `followup_task` mesaj argümanlarını düz metin üretmesini ister. Bkz. [Düz metin v2 ajan mesajları](#düz-metin-v2-ajan-mesajları). |
| `agentTaskRecovery?` | `object` | — | Yönlendirilen sağlayıcılara gönderilen arka uçta şifrelenmiş v2 görevleri için deneysel isteğe bağlı kurtarma. `enabled: true` olmadıkça devre dışıdır; bkz. [Şifrelenmiş v2 görev kurtarma](#şifrelenmiş-v2-görev-kurtarma). |
-Arayüzü kontrol paneli veya `ocx v2 status|on|off|mode |threads
-|mode-hint ` ile yönetin. Mod değişiklikleri yeni oturumlara
-uygulanır. `maxConcurrentThreadsPerSession`, bir `config.json` anahtarı değil,
+Arayüzü kontrol paneli veya `ocx v2 status|on|off|mode |keep-native-v1 |threads
+|mode-hint ` ile yönetin. Katalog sabitlemesi değişiklikleri yeni oturumlara uygulanır; düz metin derleyicisi mevcut ayarı, mevcut V2 oturumlarının sonraki uygun istekleri dahil uygun isteklerde izler. `maxConcurrentThreadsPerSession`, bir `config.json` anahtarı değil,
bir `PUT /api/v2` alanıdır; `ocx v2 threads `, v2 etkinleştirildikten sonra
Codex'in `$CODEX_HOME/config.toml` dosyasındaki `[features.multi_agent_v2]`
altına `max_concurrent_threads_per_session` yazar.
@@ -44,8 +44,9 @@ yürütme çabasını **değiştirmez**. Bir `null` değeri anahtarı kaldırır
çabadan türetilen politika (ultra = proaktif, aksi takdirde açık) devam eder;
boş veya yalnızca boşluk içeren değerler reddedilir çünkü mevcut bir boş
geçersiz kılma ultra kaynaklı Proaktif mesajı bile bastırır. Alt Ajanlar kontrol
-panelinin Ultra modu **açık** anahtarı hem yerel özelliği hem de açık bir v2
-yüzeyini (`multiAgentMode: "v2"`, `ocx v2 mode v2` ile eşdeğer) gerektirir; tek
+panelinin Ultra modu **açık** anahtarı, yerel özellik etkinken açık v2
+yüzeyini (`multiAgentMode: "v2"`, `ocx v2 mode v2` ile eşdeğer) veya genel
+zorlamayı kapalı tutan `multiAgentMode: "v2-plaintext"` modunu gerektirir; tek
başına `ocx v2 on` bu kontrol paneli geçidini karşılamaz.
Yönetim API'si `GET`/`PUT /api/v2`, `/api/injection-model`, `/api/effort-caps`,
@@ -147,6 +148,25 @@ kurtarır.
}
```
+## Düz metin v2 ajan mesajları
+
+`plaintextV2AgentMessages` yeni yapılandırmada ayarlanmamıştır. Açık `true` veya
+ayrı seçilen `multiAgentMode: "v2-plaintext"` bu deneysel yolu etkinleştirir. Mod,
+genel zorlamayı kapatırken yeni oturumlar için V2 katalog sabitlemelerini ayarlar.
+Kontrol panelindeki onayla veya `ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages`
+ile girin; `PUT /api/v2` üzerinden giriş için `plaintextAgentMessagesAcknowledged: true`
+gerekir. Mod bağımsız boole değerini değiştirmez; moddan çıkınca önceki davranışı korunur.
+
+Derleyici mevcut V2 oturumları dahil sonraki uygun isteklerde geçerli ayarı izler.
+Çağıran Responses protokolünü kullanmalı ve son hedef kurallı ChatGPT Codex iletimi
+olmalıdır: `adapter: "openai-responses"`, `authMode: "forward"` ve tam olarak
+`https://chatgpt.com/backend-api/codex`. API anahtarlı OpenAI sağlayıcıları, özel
+uyumlu ağ geçitleri, diğer sağlayıcılara rotalar ve Responses dışı çağıranlar hariçtir.
+Mevcut şifreli metin çözülmez, kayıtlı geçmiş yeniden yazılmaz ve devre dışı bırakma
+geçmişte, sağlayıcı isteklerinde veya yerel yanıt/hata ayıklama durumunda tutulmuş
+kopyaları silmez. [Alt ajan yüzeyleri](/tr/guides/sub-agent-surface/) ve
+[v1 varsayılanı](/tr/guides/subagent-v1-default/) kapsamı ve riskleri açıklar.
+
## Şifrelenmiş v2 görev kurtarma
`agentTaskRecovery`, yönlendirilen bir sağlayıcıya ulaşan arka uçta şifrelenmiş
diff --git a/docs-site/src/content/docs/zh-cn/guides/codex-integration.md b/docs-site/src/content/docs/zh-cn/guides/codex-integration.md
index e807acd44e9..dd564fc4ea7 100644
--- a/docs-site/src/content/docs/zh-cn/guides/codex-integration.md
+++ b/docs-site/src/content/docs/zh-cn/guides/codex-integration.md
@@ -173,6 +173,8 @@ opencodex 也会通过 WebSocket 提供 `/v1/responses`。专用 provider 只有
`supports_websockets = true`；在 loopback 情况下，Codex 的内置 provider 可能会先尝试 WebSocket，而关闭的 proxy
会返回 `426`，从而让 Codex fallback 到 HTTP/SSE。
+启用 `v2-plaintext` 模式或 `plaintextV2AgentMessages` 标志时，本地重放要求同一个获准的 OpenCodex 调用方和请求自身的非空白 `thread-id`。父线程、loopback 地址、上游凭据或占位密钥都不是该身份。没有获准调用方主体标识的客户端以及没有自身线程的请求必须省略 `previous_response_id`，重新发送完整对话。默认的 loopback Codex 与 DSH 配置不建立该调用方身份。任一设置启用期间保留的状态在禁用后仍保持绑定。默认 `v1` 对未绑定的状态保留现有的父线程范围续接行为，包括默认 loopback 调用方。这与上游原生拥有的 Responses ID 相互独立。
+
## 线程标识与历史记录
默认的 loopback 形式会让新线程继续标记为 Codex 原生的 `openai` provider，因此正常的 resume history 不需要
diff --git a/docs-site/src/content/docs/zh-cn/guides/sub-agent-surface.md b/docs-site/src/content/docs/zh-cn/guides/sub-agent-surface.md
index a21b5265200..051bdc6dca0 100644
--- a/docs-site/src/content/docs/zh-cn/guides/sub-agent-surface.md
+++ b/docs-site/src/content/docs/zh-cn/guides/sub-agent-surface.md
@@ -13,12 +13,13 @@ description: 控制 Codex 如何在所有模型上生成和管理子代理。
| 模式 | Codex 获得什么 | 适合谁 |
| --- | --- | --- |
-| **v1** | 经典的命名空间 `spawn_agent`、`send_input`、`resume_agent` 和 `close_agent` 工具。spawn 可以直接选择另一个模型。 | 需要在不同 provider 之间可靠委派的初学者，尤其是原生到路由子级。 |
-| **base**（默认） | 上游模型固定值：GPT-5.6 Sol/Terra 使用 v2，Luna 使用 v1，未固定的模型遵循 Codex 的 `multi_agent_v2` 功能开关。 | 大多数用户。它按 Codex 对每个模型预期的界面运行，而不是全局强制一种。 |
+| **v1**（全新安装的默认值） | 经典的命名空间 `spawn_agent`、`send_input`、`resume_agent` 和 `close_agent` 工具。spawn 可以直接选择另一个模型。 | 需要在不同 provider 之间可靠委派的初学者，尤其是原生到路由子级。 |
+| **base** | 上游模型固定值：GPT-5.6 Sol/Terra 使用 v2，Luna 使用 v1，未固定的模型遵循 Codex 的 `multi_agent_v2` 功能开关。 | 大多数用户。它按 Codex 对每个模型预期的界面运行，而不是全局强制一种。 |
| **v2** | 扁平的 `spawn_agent`、`send_message`、`followup_task`、`interrupt_agent` 和 agent-list 工具，并支持并发会话。 | 想要更新的并发工作流，并理解模型继承以及下面加密任务限制的用户。 |
+| **v2-plaintext** | 为新会话固定 V2 目录项，关闭全局强制，并在规范的 ChatGPT 转发路径上以明文编译符合条件的任务消息。 | 明确接受明文任务可能被保留的用户；进入时需要确认。 |
:::tip[不确定？]
-先从 **base** 开始。只有当跨 provider 委派必须可预测地工作时才选 **v1**。只有在你明确想让所有目录条目都使用更新的会话模型时，才强制使用 **v2**。
+先从全新安装的默认模式 **v1** 开始，以便跨 provider 委派可预测地工作。要遵循上游固定值，请选择 **base**。只有在你明确想让所有目录条目都使用更新的会话模型时，才强制使用 **v2**。
:::
## 工作原理
@@ -28,6 +29,7 @@ description: 控制 Codex 如何在所有模型上生成和管理子代理。
- **v1** 会把所有模型的 `multi_agent_version` 设为 `"v1"`。
- **base** 会恢复上游固定值。未固定的条目会遵循原生 `multi_agent_v2` 功能开关。
- **v2** 会把所有模型的 `multi_agent_version` 设为 `"v2"`；但启用 **让 ChatGPT 保持 v1** 时例外：ChatGPT 原生条目保持 `"v1"`，路由/组合条目仍为 `"v2"`。
+- **v2-plaintext** 为新会话将目录项固定为 `"v2"`，关闭全局 V2 强制并启用明文编译器。
opencodex 会把这一点作为最后一步同时应用到实时的 `/v1/models` 目录和同步到磁盘的目录。因此，模式更改会一致影响新建的 App、CLI 和 TUI 会话。
@@ -183,6 +185,8 @@ curl -X PUT http://localhost:10100/api/injection-model \
-d '{"model":"anthropic/claude-sonnet-5","effort":"xhigh"}'
```
+首次通过 `PUT /api/v2` 进入 `v2-plaintext` 时，必须同时提交 `plaintextAgentMessagesAcknowledged: true`；仪表板会要求用户确认，CLI 则使用 `ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages`。
+
## FAQ
### 选择委派模型会强制 Codex spawn 它吗？
@@ -203,7 +207,7 @@ Codex 按 priority 从目录中填充最多五个列出位置。设置的模型
### 模式更改会影响正在运行的会话吗？
-不会。更改模式后请启动一个新的 Codex 会话。如果长时间运行的 App host 仍然显示旧的目录状态，请运行 `ocx sync` 并重启那个 Codex 界面。
+目录固定值只影响新会话，已有会话保留其界面。但明文编译器遵循当前设置，也会影响已有 V2 会话后续符合条件的请求。要使用新的目录固定值，请启动新的 Codex 会话；如果长时间运行的 App host 仍显示旧目录状态，请运行 `ocx sync` 并重启该界面。
### 推理强度
@@ -213,7 +217,7 @@ Codex 按 priority 从目录中填充最多五个列出位置。设置的模型
模型上下文上限与子代理模式无关。请在 Models 页面配置它；原生 OpenAI 模型会保留其真实的上下文窗口。
-新配置不会写入实验性的 `plaintextV2AgentMessages` 字段，只有显式设置为 `true` 才会启用。
+新配置不会写入实验性的 `plaintextV2AgentMessages` 字段；显式设置为 `true` 或选择 `v2-plaintext` 模式均会启用编译器。该模式为新会话选择 V2 并关闭全局强制，不覆盖独立字段。编译器遵循当前设置，也影响已有 V2 会话的后续符合条件的请求；已有密文不会被解密，已保存的历史不会被改写，禁用不会删除已保留的副本。
调用方必须使用 Responses 格式，最终目标必须采用 `adapter: "openai-responses"`、
`authMode: "forward"` 和准确的基础地址 `https://chatgpt.com/backend-api/codex`。OpenAI API key
provider、自定义兼容网关、最终发往其他 provider 的请求，以及非 Responses 调用都不会被改写。
diff --git a/docs-site/src/content/docs/zh-cn/guides/subagent-v1-default.md b/docs-site/src/content/docs/zh-cn/guides/subagent-v1-default.md
index 2f1894cfa2f..f2e2afc898a 100644
--- a/docs-site/src/content/docs/zh-cn/guides/subagent-v1-default.md
+++ b/docs-site/src/content/docs/zh-cn/guides/subagent-v1-default.md
@@ -5,7 +5,23 @@ description: v2 加密任务限制会破坏什么、OpenCodex 为何现在默认
OpenCodex 安装后的子代理界面默认为 **v1**。Dashboard、Models 和 Subagents 页面在切换到 **base** 或 **v2** 前都会要求确认，并链接到本页。CLI 不会提示。
-原因明确而具体：在 v2 上，从 ChatGPT 原生模型分派给路由模型的任务无法被路由模型读取。这恰恰是最常见的委派方式——GPT 父代理启动 Grok、Claude 或 GLM 子代理——而在 v2 上每次都会失败。
+原因明确而具体：在未改变的加密 v2 路径上，从 ChatGPT 原生模型分派给路由模型的任务无法被路由模型读取。这是常见的委派方式——GPT 父代理启动 Grok、Claude 或 GLM 子代理——无法读取的加密任务会在此边界失败。下面的实验性选项改变新任务消息的生成方式，不会解密已有消息。
+
+## 可选的明文任务 V2
+
+**V2 · 明文任务**（`v2-plaintext`）为新会话固定 V2 目录项，同时关闭全局 V2 强制。它保留 V2 的任务名称、层级、后续消息、取消和并发功能，并对符合条件的规范 ChatGPT Responses 请求使用实验性明文编译器。已有会话保留其记录的选择；更新不会自动选择此模式。
+
+目录固定值适用于新会话，编译器则遵循当前设置，处理已有 V2 会话后续符合条件的请求。显式设置独立的 `plaintextV2AgentMessages: true` 也会启用编译器。
+
+明文编译启用时，本地响应 ID 续接要求同一个获准的 opencodex API 密钥身份以及请求自身的 `thread-id`；父线程 ID 不能授权访问子任务。缺少任一身份、代理重启后或使用较旧的未绑定缓存时，请省略 `previous_response_id` 并重新发送完整对话。启用期间保留的状态在切换模式后仍保持绑定；默认 `v1` 对未绑定状态保留按父线程范围续接的行为，包括 loopback 调用方。
+
+仪表板要求确认任务文本可能保留在 Codex 历史、所选提供商请求、本地响应与调试状态中，包括磁盘上的续接快照或 spill 文件。HTTPS 和身份验证仍启用，不会增加恢复模型调用。已有密文不会被解密，已保存的历史不会被改写；禁用编译器也不会删除已保留的副本。不受支持的后端或客户端行为仍可能失败。普通 v1 和原生 v1 / 路由 v2 混合模式仍可使用。
+
+```bash
+ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages
+```
+
+使用 `ocx v2 status --live --json` 查看实时目标。配置本地目标时，两个命令都省略 `--live`，并使用 `ocx v2 status --json` 查看；配置状态和目录收敛并不等于真实委派成功。要退出该模式，请明确选择其他模式；独立设置的 `plaintextV2AgentMessages` 值会被保留。
## 发生时会看到什么
@@ -28,11 +44,11 @@ OpenCodex 安装后的子代理界面默认为 **v1**。Dashboard、Models 和 S
在 v1 上，父代理以纯文本发出子代理的任务。OpenCodex 读取并路由它，子代理因而收到可执行的内容。
-在 v2 上，父代理以 ChatGPT 后端生成的 `encrypted_content` 发出任务。密钥留在该后端，OpenCodex 从未持有它，因此代理既无法解密也无法改写；该值确实是密文，并不是由标志隐藏的明文。这是结构限制，而非配置错误；代理端设置无法启用本地解密。
+在加密 v2 路径上，父代理以 ChatGPT 后端生成的 `encrypted_content` 发出任务。密钥留在该后端，OpenCodex 从未持有它，因此代理既无法解密也无法改写；该值确实是密文，并不是由标志隐藏的明文。明文编译器只能影响符合条件的新消息，不能修复已有密文。
代理设置无法启用本地解密。实验性 `agentTaskRecovery` 可以请求 ChatGPT 后端恢复符合条件的任务，但不会在本地解密其密文。上述授权、适用条件和失败处理限制仍然有效。
-有三种拓扑不受影响；了解它们也有助于理解失败发生的位置：
+下表比较未启用明文编译器时的拓扑，也有助于理解失败发生的位置：
| 拓扑 | v1 | v2 |
| --- | --- | --- |
@@ -50,13 +66,14 @@ OpenCodex 安装后的子代理界面默认为 **v1**。Dashboard、Models 和 S
OpenCodex 在 [#92](https://github.com/lidge-jun/opencodex/issues/92) 记录了影响，并以“不计划处理”关闭：此仓库无法修复，因此该 issue 是上游工作的索引，并非等待这里的维护者处理的任务。
-## 三种模式目前的作用
+## 模式目前的作用
| 模式 | 界面 | 适用情况 |
| --- | --- | --- |
| **v1**（默认） | 每个模型都提供经典的带命名空间的启动工具。启动时可直接指定另一模型。 | 跨提供商委派的用户。这是当前发布的默认值。 |
| **base** | 上游模型固定设置：Sol 和 Terra 使用 v2，Luna 使用 v1，未固定的模型遵循 Codex 自身的标志。 | 希望采用 Codex 预期的各模型界面，且只在同一提供商内委派。 |
| **v2** | 每个模型都提供扁平的并发工具。 | 希望使用较新的并发会话模型，且父代理与子代理位于边界同侧。 |
+| **v2-plaintext** | 新会话使用 V2 目录固定值，全局强制关闭；符合条件的规范 ChatGPT 请求使用明文任务。 | 明确接受任务文本可能被保留、希望使用 V2 委派的用户。 |
base 排在第二而非第一，是因为它将大多数人用于*发起*委派的 Sol 和 Terra 固定在 v2。对于这一问题，base 不是折中选项；ChatGPT 向路由模型启动子代理时，它的行为与 v2 相同。
@@ -69,7 +86,7 @@ base 排在第二而非第一，是因为它将大多数人用于*发起*委派
两种选择都会被记录，通知不再出现。如果直接关闭通知而未作选择，下次打开仪表盘时仍会看到它。
-模式变更只对**新建** Codex 会话生效。选择后请新建会话；如果长期运行的 App 宿主仍显示旧界面，请执行 `ocx sync` 并重启该界面。
+目录固定值变更对**新建** Codex 会话生效；明文编译器的当前设置也会影响已有 V2 会话后续符合条件的请求。要使用新的目录固定值，请新建会话；如果长期运行的 App 宿主仍显示旧界面，请执行 `ocx sync` 并重启该界面。
## 如果仍想使用 v2
@@ -88,7 +105,7 @@ base 排在第二而非第一，是因为它将大多数人用于*发起*委派
## 更改模式
-Dashboard、Models 和 Subagents 都提供相同的 v1/base/v2 开关，而且切换到 base 或 v2 时都会要求确认。CLI 命令如下：
+Dashboard、Models 和 Subagents 提供模式开关；切换到 base、v2 或 v2-plaintext 时需要确认。CLI 的明文模式需要上文所示的确认标志。其他 CLI 命令如下：
```bash
ocx v2 status
diff --git a/docs-site/src/content/docs/zh-cn/reference/cli.md b/docs-site/src/content/docs/zh-cn/reference/cli.md
index 4ee66a405a2..bf7510316d2 100644
--- a/docs-site/src/content/docs/zh-cn/reference/cli.md
+++ b/docs-site/src/content/docs/zh-cn/reference/cli.md
@@ -35,6 +35,10 @@ opencodex 的 CLI 是 `ocx`。它会根据第一个命令名进行分发；文
声明需要确认的破坏性删除、导入、额度消耗和更新操作，在非交互用法中都要求 `--yes`。该标志是显式选择加入；省略它时，绝不能在静默情况下确认该操作。
+## 恢复明文子代理模式配置
+
+进入实验性明文子代理模式请使用 `ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages`。通用的 `config set` 和 `config import` 会拒绝新进入该模式，因为专用命令还会协调原生模式转换。恢复包含 `multiAgentMode: "v2-plaintext"` 的导出配置前，先完成上述确认转换，再导入文件。恢复已经启用的模式、修改其他设置和退出明文模式仍然允许；独立的 `plaintextV2AgentMessages` 首选项不受影响。
+
## 版本与内部分发目标
`ocx --version`、`ocx -v` 和 `ocx version` 会打印一行适合脚本读取的版本信息并退出。
diff --git a/docs-site/src/content/docs/zh-cn/reference/cli/agents.md b/docs-site/src/content/docs/zh-cn/reference/cli/agents.md
index ef7917dc81e..4f45d4b30e7 100644
--- a/docs-site/src/content/docs/zh-cn/reference/cli/agents.md
+++ b/docs-site/src/content/docs/zh-cn/reference/cli/agents.md
@@ -22,9 +22,9 @@ Codex 集成会把 `web_search = "disabled"` 写入 `~/.codex/config.toml`，这
命令会报告由此触发的 Codex 侧写入（`--json` 中的 `codexWebSearch`，否则为末尾的
`Codex config:` 行），并在无法写入时提示 `ocx sync`。该标志对 `vision` 同样有效。
-### `ocx v2 |threads >`
+### `ocx v2 |keep-native-v1 |threads |mode-hint >`
-管理 Codex 的 `multi_agent_v2` 功能标志和三态多代理 surface 模式。
+管理 Codex 的 `multi_agent_v2` 功能标志和四态多代理 surface 模式。
| 子命令 | 动作 |
| --- | --- |
@@ -33,8 +33,12 @@ Codex 集成会把 `web_search = "disabled"` 写入 `~/.codex/config.toml`，这
| `off` | 禁用 `multi_agent_v2` 功能并重新同步目录。 |
| `mode v1` | 强制所有模型使用 v1，禁用原生 v2，并保留当前线程上限。 |
| `mode default` | 遵循上游模型的 surface 固定配置。 |
-| `mode v2` | 强制所有模型使用 v2，启用原生 v2，并保留当前线程上限。 |
+| `mode v2` | 强制模型使用 v2 并保留线程上限。关闭 `keep-native-v1` 时启用全局原生 v2；开启时关闭全局强制并使用目录固定值。 |
+| `mode v2-plaintext --acknowledge-plaintext-agent-messages` | 为新会话选择 V2，关闭全局强制，并以明文传递符合条件的任务。进入需要 `--acknowledge-plaintext-agent-messages`。 |
+| `keep-native-v1 on\|off` | 在 `mode v2` 下让 ChatGPT 原生模型保持 v1、路由模型使用 v2；开启时先关闭全局 V2 强制，再同步目录。 |
| `threads ` | 将当前 v1/v2 线程上限设为一个至少为 1 的整数。 |
+| `mode-hint ` | 为所有模型和 effort 设置主动委派提示（Ultra mode）。 |
+| `mode-hint --clear` | 移除提示，恢复由 effort 决定的策略（ultra 为主动委派）。 |
```bash
ocx v2 status
@@ -44,7 +48,7 @@ ocx v2 on
ocx v2 threads 16
```
-`mode` 子命令会将 `multiAgentMode` 写入 opencodex 配置，并重新同步 Codex 目录。模式和标志的切换会在有效的 v1/v2 Codex 键之间迁移当前的数值线程上限；如果切换失败，会恢复原始的 `config.toml`。更改只会应用于新的 Codex 会话，正在运行的会话会保持其已固定的 surface。
+`mode` 子命令会将 `multiAgentMode` 写入 opencodex 配置，并重新同步 Codex 目录。模式和标志的切换会在有效的 v1/v2 Codex 键之间迁移当前的数值线程上限；如果切换失败，会恢复原始的 `config.toml`。目录固定值应用于新会话，已有会话保留其 surface；明文编译器的当前设置也影响已有 V2 会话后续符合条件的请求。仪表板的 Ultra mode 开关可在原生功能启用且模式为 `v2` 时使用，也可在 `v2-plaintext` 模式下使用；仅运行 `ocx v2 on` 不满足条件。
## Combo routing
diff --git a/docs-site/src/content/docs/zh-cn/reference/configuration/agents.md b/docs-site/src/content/docs/zh-cn/reference/configuration/agents.md
index 961bbf33c61..a3aa6577f91 100644
--- a/docs-site/src/content/docs/zh-cn/reference/configuration/agents.md
+++ b/docs-site/src/content/docs/zh-cn/reference/configuration/agents.md
@@ -9,7 +9,7 @@ description: 多代理界面、委派引导、首选模型、回退链、原生
| 字段 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
-| `multiAgentMode?` | `"v1" \| "default" \| "v2"` | `"default"` | `v1` 会把目录中的每个模型都标记为 v1；`v2` 会把每个模型都标记为 v2。`default` 会恢复上游固定值（Sol/Terra 为 v2，Luna 为 v1），否则遵循原生 `multi_agent_v2` 标志。适用于新会话。 |
+| `multiAgentMode?` | `"v1" \| "default" \| "v2" \| "v2-plaintext"` | `"default"` | `v1` 会把目录中的每个模型都标记为 v1；`v2` 会把每个模型都标记为 v2。`default` 会恢复上游固定值（Sol/Terra 为 v2，Luna 为 v1），否则遵循原生 `multi_agent_v2` 标志。`v2-plaintext` 启用实验性明文任务传递并关闭全局强制。目录固定值适用于新会话；启用的编译器也影响已有 V2 会话后续符合条件的请求。 |
| `subagentModels?` | `string[]` | `gpt-6-astra`, `gpt-6.1-sol`, `gpt-6-luna` | 最多五个原生 id、账户限定的 `/` id 或路由 `provider/model` id，优先显示在子代理选择器中。新增选项只提供原生和路由 id；保存时会保留已配置的精确账户限定 id，包括当前目录中不可用的 id。如需添加新的精确账户限定 id，请使用 `ocx agent subagents set` 或编辑配置。[Astra 一次性升级](/reference/configuration/agents/#astra-roster-upgrade)后，显式空列表会被保留。 |
| `injectionModel?` | `string` | — | 在代理生成的 v2 委派引导中使用的首选原生或路由后的子代理模型。 |
| `injectionEffort?` | `string` | — | 首选 effort（`low` 到 `ultra`），只有在 `injectionModel` 存在时才有意义。 |
@@ -21,9 +21,9 @@ description: 多代理界面、委派引导、首选模型、回退链、原生
| `subagentModelFallbackPollMs?` | `number` | `60000` | 可用性探测缓存间隔。低于 1000 ms 的值会回退到默认值。 |
| `effortCap?` | `string` | — | 对符合条件的 v2 主轮次和标记的派生子轮次设置硬上限。接受 `low` 到 `ultra`。 |
| `subagentEffortCap?` | `string` | — | 仅针对派生子轮次的额外上限。两个上限同时适用时，较低者生效。 |
-| `plaintextV2AgentMessages?` | `boolean` | —（未设置） | 实验性选项。只有显式设置为 `true` 才会启用。符合条件的新 `spawn_agent`、`send_message` 和 `followup_task` 调用会使用明文消息参数。详见[明文 v2 代理消息](#明文-v2-代理消息)。 |
+| `plaintextV2AgentMessages?` | `boolean` | —（未设置） | 实验性选项。显式设置为 `true` 或选择 `multiAgentMode: "v2-plaintext"` 均会启用。符合条件的新 `spawn_agent`、`send_message` 和 `followup_task` 调用会使用明文消息参数。详见[明文 v2 代理消息](#明文-v2-代理消息)。 |
-通过仪表板或 `ocx v2 status|on|off|mode |threads ` 管理该界面。模式变更会应用于新会话。`maxConcurrentThreadsPerSession` 是 `PUT /api/v2` 字段，不是 `config.json` 键；`ocx v2 threads ` 会在启用 v2 后，将 `max_concurrent_threads_per_session` 写入 Codex 的 `$CODEX_HOME/config.toml` 中的 `[features.multi_agent_v2]` 下。
+通过仪表板或 `ocx v2 status|on|off|mode |keep-native-v1 |threads |mode-hint ` 管理该界面。通过 CLI 进入 `v2-plaintext` 需要 `--acknowledge-plaintext-agent-messages`；仪表板要求确认，通过 `PUT /api/v2` 新进入时必须提交 `plaintextAgentMessagesAcknowledged: true`。目录模式变更应用于新会话，编译器的当前设置也影响已有 V2 会话后续符合条件的请求。`maxConcurrentThreadsPerSession` 是 `PUT /api/v2` 字段，不是 `config.json` 键；`ocx v2 threads ` 会在启用 v2 后，将 `max_concurrent_threads_per_session` 写入 Codex 的 `$CODEX_HOME/config.toml` 中的 `[features.multi_agent_v2]` 下。
管理 API 公开 `GET`/`PUT /api/v2`、`/api/injection-model`、`/api/effort-caps`、`/api/subagent-models` 和 `/api/subagent-model-fallback`。injection-model 更新是部分更新；自定义 prompt 是该 API 上的 `prompt` 字段。
@@ -31,6 +31,8 @@ description: 多代理界面、委派引导、首选模型、回退链、原生
Subagents → 高级中的 **始终主动委派**（原名 **Ultra mode**）只改变触发委派的条件，不改变推理 effort。推荐预设仍遵循用户指令、权限边界、任务范围和工具规则。
+仪表板的开关要求原生功能已启用且显式选择 `v2`，或者选择 `v2-plaintext`；仅运行 `ocx v2 on` 不满足条件。
+
`GET` 和 `PUT /api/v2` 还会返回 `multiAgentModeHintRecommendation: { text, revision }`。仪表板在启用或恢复预设时使用服务器提供的文本，不会回退到硬编码文案。如果旧服务器没有提供推荐值，或返回的值格式无效，则无法应用或恢复预设；仍可编辑或清除现有的自定义提示。恢复预设只修改本地草稿，保存操作才会将其写入配置。
读取设置、无关更新和版本升级不会迁移已保存的提示。只有显式更新提示，且正文与两种已知旧版 OpenCodex 预设之一逐字节完全一致时，才会替换为当前推荐文本。其他有效的自定义文本，包括仅空白字符不同的变体，都会逐字节保留。现有的 v2 启用、功能支持检查和清除提示规则保持不变；更改会应用于新的 Codex 会话。
@@ -83,7 +85,9 @@ opencodex 会跳过已禁用、不可路由、不健康、处于冷却中，或
## 明文 v2 代理消息
-新配置不会写入 `plaintextV2AgentMessages`。只有显式设置为 `true` 才会启用。调用方必须使用 Responses
+新配置不会写入 `plaintextV2AgentMessages`。显式设置为 `true` 或选择 `multiAgentMode: "v2-plaintext"` 均会启用此路径。该模式关闭全局强制并为新会话固定 V2；独立布尔值不会被覆盖。编译器遵循当前设置，也影响已有 V2 会话的后续符合条件的请求。已有密文不会被解密，历史不会被改写，禁用也不会删除历史、提供商请求或本地响应与调试状态中已保留的副本。通过仪表板确认或 `ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages` 进入该模式。
+
+调用方必须使用 Responses
格式，最终目标必须采用规范的 ChatGPT Codex 转发配置，即 `adapter: "openai-responses"`、
`authMode: "forward"` 和准确的基础地址 `https://chatgpt.com/backend-api/codex`。OpenAI API key
provider、自定义 OpenAI 兼容网关、最终发往其他 provider 的请求，以及非 Responses 调用都不会被改写。
diff --git a/docs-site/src/content/docs/zh-tw/guides/codex-integration.md b/docs-site/src/content/docs/zh-tw/guides/codex-integration.md
index 2d00f3344aa..53c85f4d4a5 100644
--- a/docs-site/src/content/docs/zh-tw/guides/codex-integration.md
+++ b/docs-site/src/content/docs/zh-tw/guides/codex-integration.md
@@ -178,6 +178,8 @@ Codex 保持一致。opencodex 也透過 WebSocket 提供 `/v1/responses`。專
`"websockets": true` 時宣告 `supports_websockets = true`；loopback 模式下，Codex 的內建 provider
可能先嘗試 WebSocket，若 proxy 未啟用此功能則回傳 `426`，讓 Codex fallback 到 HTTP/SSE。
+啟用 `v2-plaintext` 模式或 `plaintextV2AgentMessages` 旗標時，本機重放要求同一個獲准的 OpenCodex 呼叫方，以及請求自身非空白的 `thread-id`。父執行緒、loopback 位址、上游憑證或預留位置金鑰都不是該身分。沒有獲准呼叫方主體身分的用戶端，以及沒有自身執行緒的請求，必須省略 `previous_response_id`，重新傳送完整對話。預設的 loopback Codex 與 DSH 設定不會建立該呼叫方身分。任一設定啟用期間保留的狀態在停用後仍維持綁定。預設 `v1` 對未綁定的狀態保留既有的父執行緒範圍續接行為，包括預設 loopback 呼叫方。這與上游原生擁有的 Responses ID 各自獨立。
+
## Thread identity 與歷史記錄
預設 loopback 形式會讓新 thread 保持使用 Codex 原生的 `openai` provider 標記，因此一般 resume
diff --git a/docs-site/src/content/docs/zh-tw/guides/sub-agent-surface.md b/docs-site/src/content/docs/zh-tw/guides/sub-agent-surface.md
index 0e918f014c3..bc512f2800d 100644
--- a/docs-site/src/content/docs/zh-tw/guides/sub-agent-surface.md
+++ b/docs-site/src/content/docs/zh-tw/guides/sub-agent-surface.md
@@ -1,5 +1,5 @@
---
-title: 子代理介面（v1 / base / v2）
+title: 子代理介面（v1 / base / v2 / v2-plaintext）
description: 全域控制 Codex 在所有模型上生成和管理子代理的方式。
---
@@ -19,9 +19,10 @@ opencodex 允許你為目錄中的所有模型選擇多代理協作介面。儀
| 模式 | 介面 | 行為 |
| --- | --- | --- |
-| **v1** | `multi_agent_v1` | 使用經典的名稱空間代理工具，以及 `send_input` / `close_agent` / `resume_agent`。`spawn_agent` 的模型覆蓋可以在其他模型上生成子代理。 |
-| **base**（預設） | 上游固定值 | 恢復上游模型的固定值：gpt-5.6-sol、gpt-5.6-terra 和 gpt-6.1-terra 使用 v2，gpt-5.6-luna 使用 v1；未固定的模型遵循 Codex 的 `multi_agent_v2` 功能開關。生成行為取決於該模型最終使用的介面。 |
+| **v1**（全新安裝的預設值） | `multi_agent_v1` | 使用經典的名稱空間代理工具，以及 `send_input` / `close_agent` / `resume_agent`。`spawn_agent` 的模型覆蓋可以在其他模型上生成子代理。 |
+| **base** | 上游固定值 | 恢復上游模型的固定值：gpt-5.6-sol、gpt-5.6-terra 和 gpt-6.1-terra 使用 v2，gpt-5.6-luna 使用 v1；未固定的模型遵循 Codex 的 `multi_agent_v2` 功能開關。生成行為取決於該模型最終使用的介面。 |
| **v2** | `multi_agent_v2` | 使用扁平的 `spawn_agent` 工具、併發會話，以及 `send_message` / `followup_task` / `wait_agent` / `interrupt_agent`。全量歷史 fork 時子代理繼承父模型；`fork_turns: "none"`（或部分 fork）時接受 `model` / `reasoning_effort` 覆蓋。如果原生→路由子代理只收到後端加密的任務內容，未明確信任的外部路由會回傳 `unreadable_encrypted_agent_task`；明確信任的直接金鑰驗證 Responses 路由可以原樣接收，而混合組合仍優先選擇可解密的原生目標（[#92](https://github.com/lidge-jun/opencodex/issues/92)）。 |
+| **v2-plaintext** | V2 | 為新工作階段選擇 V2、關閉全域強制，並以明文傳遞符合條件的工作。進入需要 `--acknowledge-plaintext-agent-messages`。 |
## 運作原理
@@ -29,6 +30,7 @@ opencodex 允許你為目錄中的所有模型選擇多代理協作介面。儀
- **v1 模式**：強制所有條目使用 `multi_agent_version = "v1"`，覆蓋上游固定值。
- **base 模式**：恢復上游預設值。已固定的模型使用快照值；未固定的模型不寫入該欄位，交由 Codex 功能開關決定。
+- **v2-plaintext 模式**：為新工作階段將所有目錄條目固定為 V2，關閉全域強制並啟用合格請求的明文編譯。
- **v2 模式**：強制所有條目使用 `multi_agent_version = "v2"`，覆蓋上游固定值；但啟用 **讓 ChatGPT 保持 v1** 時例外：ChatGPT 原生條目維持 `"v1"`，路由/組合條目仍為 `"v2"`。
無論是即時 `/v1/models` 目錄回應，還是磁碟目錄同步，這項覆蓋都會作為最後一步執行。因此，無論條目原本如何生成，新會話都會使用一致的模式。
@@ -149,11 +151,17 @@ opencodex 會安全失敗，而不是轉發空或無法讀取的任務：
恢復此格式，但會消耗配額、增加延遲，並依賴非公開後端行為。任何失敗都保留原本的
`unreadable_encrypted_agent_task` 錯誤。詳見[英文設定參考](/reference/configuration/agents/#encrypted-v2-task-recovery)。
+## 明文 v2 任務訊息
+
+新設定中的 `plaintextV2AgentMessages` 預設未設定。明確設為 `true` 或選擇 `v2-plaintext` 模式都會啟用編譯器；離開模式不會改變獨立的布林值。它只處理 Responses 呼叫，且最終目的地必須是標準 ChatGPT Codex forward 路徑：`adapter: "openai-responses"`、`authMode: "forward"` 和 `https://chatgpt.com/backend-api/codex`。OpenAI API 金鑰 provider、自訂閘道、其他最終 provider 及非 Responses 呼叫不受改寫。
+
+啟用後也會處理既有 V2 工作階段的後續合格請求；既有密文不會解密，已儲存歷史不會改寫，停用不會刪除已保留的副本。詳見[代理設定](/zh-tw/reference/configuration/agents/#plaintext-v2-agent-messages)。
+
## 更改模式
### GUI
-- **Dashboard** → 第一個狀態單元：選擇 **v1**、**base** 或 **v2**。
+- **Dashboard** → 第一個狀態單元：選擇 **v1**、**base**、**v2** 或 **v2-plaintext**；進入明文模式需要在 GUI 中確認。
- **Models** 頁面 → 使用頂部的分段控制元件。
- 兩個頁面都有 **?** 按鈕，可開啟幫助彈窗並返回本文。
- **Dashboard** → **子代理委託**：選擇首選模型和可選的推理強度。在 v2 上，注入的指引會要求以 `fork_turns: "none"` 生成，使模型覆蓋得以應用。如果原生→路由子代理只收到加密任務內容，請使用原生目標、v1，或明確信任的直接金鑰驗證 Responses relay；其他僅外部目標的傳輸會明確回傳 `unreadable_encrypted_agent_task`（[#92](https://github.com/lidge-jun/opencodex/issues/92)）。
@@ -164,6 +172,7 @@ opencodex 會安全失敗，而不是轉發空或無法讀取的任務：
ocx v2 mode v1 # 強制所有模型使用 v1
ocx v2 mode default # 恢復上游固定值
ocx v2 mode v2 # 強制所有模型使用 v2
+ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages # 選用明文任務
ocx v2 status # 顯示目前模式和 Codex 功能開關
```
@@ -179,7 +188,7 @@ curl -X PUT http://localhost:10100/api/v2 \
-d '{"multiAgentMode": "v2"}'
```
-`/api/v2` 的 PUT 端點還接受 `enabled`（布林值，Codex 功能開關）和 `maxConcurrentThreadsPerSession`（整數）。它會驗證請求、儲存模式、重新同步目錄，並提示模式更改從新會話開始生效。
+首次進入 `v2-plaintext` 時，`PUT /api/v2` 必須同時提供 `plaintextAgentMessagesAcknowledged: true`。`/api/v2` 的 PUT 端點還接受 `enabled`（布林值，Codex 功能開關）和 `maxConcurrentThreadsPerSession`（整數）。它會驗證請求、儲存模式、重新同步目錄，並提示模式更改從新會話開始生效。
委託選擇器使用另一個端點：
@@ -227,7 +236,7 @@ Codex 依 priority 從目錄填入最多五個列出位置。設定的模型少
### 模式變更會影響執行中的工作階段嗎？
-不會。變更模式後請開啟新的 Codex 工作階段。若長時間執行的 App host 仍顯示過時的目錄狀態，請執行
+目錄介面選擇適用於新工作階段；但啟用明文編譯後，既有 V2 工作階段的後續合格請求也會受影響。變更目錄介面後請開啟新的 Codex 工作階段。若長時間執行的 App host 仍顯示過時的目錄狀態，請執行
`ocx sync` 並重新啟動該 Codex 介面。
### 當 opencodex 無法信任目錄時會發生什麼？
diff --git a/docs-site/src/content/docs/zh-tw/guides/subagent-v1-default.md b/docs-site/src/content/docs/zh-tw/guides/subagent-v1-default.md
index 73f37355dab..b40d4572085 100644
--- a/docs-site/src/content/docs/zh-tw/guides/subagent-v1-default.md
+++ b/docs-site/src/content/docs/zh-tw/guides/subagent-v1-default.md
@@ -5,7 +5,21 @@ description: v2 加密任務限制會造成什麼問題、OpenCodex 為何改以
OpenCodex 安裝後，子代理介面預設為 **v1**。Dashboard、Models 與 Subagents 頁面在切換至 **base** 或 **v2** 前都會要求確認，並連結至本頁說明。CLI 不會提示。
-原因很明確：在 v2 上，由 ChatGPT 原生模型交給路由模型的任務，路由模型無法讀取。這恰好是最常見的委派方式，即 GPT 父代理啟動 Grok、Claude 或 GLM 子代理，而在 v2 上每次都會失敗。
+原因很明確：在未變更的加密 v2 路徑上，ChatGPT 原生模型交給路由模型的任務可能無法被後者讀取。例如 GPT 父代理啟動 Grok、Claude 或 GLM 子代理時，無法讀取的加密任務會在邊界失敗。下述實驗選項改變新任務訊息的產生方式，但不解密既有密文。
+
+## 選用以明文傳遞任務訊息的 V2
+
+**V2 · 明文任務**（`v2-plaintext`）為新聊天選擇 V2 目錄 pin，且不啟用全域 V2 強制。它保留 V2 任務名稱、層級、後續訊息、取消與並行功能，並對符合條件的標準 ChatGPT Responses 請求使用實驗性明文編譯器。既有聊天保留其記錄的介面選擇；更新不會自動選取此模式。目錄 pin 適用於新工作階段，但編譯器依目前設定處理每個合格請求，包括既有 V2 工作階段的後續請求。
+
+此模式下，本機 response ID 續接需要相同的獲准 opencodex API 金鑰身分和請求自身的 `thread-id`；父執行緒 ID 不能存取子任務。缺少任一身分、代理重啟後或使用舊的未綁定快取項目時，請省略 `previous_response_id` 並重新傳送完整對話。此模式保留的狀態在切換模式後仍維持綁定；預設 `v1` 對未綁定狀態保留既有的父執行緒範圍續接行為，包括 loopback 呼叫方。
+
+儀表板要求確認任務文字可能保留在 Codex 歷史、所選 provider 請求及本機回應／除錯狀態，包括磁碟上的續接快照或溢出檔案。HTTPS 與驗證保持啟用，不會新增恢復模型呼叫。既有密文不會被解密，已儲存歷史不會改寫；停用也不會刪除已保留的副本。不支援的後端或用戶端行為仍可能失敗。一般 v1 與原生 v1／路由 v2 混合模式仍可使用。
+
+```bash
+ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages
+```
+
+使用 `ocx v2 status --live --json` 查看即時目標。設定本機目標時，兩個指令都省略 `--live`，並使用 `ocx v2 status --json` 查看；設定狀態和目錄收斂不代表實際委派成功。若要離開此模式，請明確選擇其他模式；獨立設定的 `plaintextV2AgentMessages` 值會保留。
## 發生時會看到什麼
@@ -28,11 +42,11 @@ OpenCodex 安裝後，子代理介面預設為 **v1**。Dashboard、Models 與 S
在 v1 上，父代理會以純文字送出子代理任務。OpenCodex 能讀取並路由，子代理也能收到可執行的內容。
-在 v2 上，父代理送出的任務是由 ChatGPT 後端產生的 `encrypted_content`。金鑰留在該後端；OpenCodex 從未持有，所以代理無從解密或重寫。這個值是真正的密文，而非旗標掩蓋下的明文。因此這是結構性限制，不是設定錯誤；代理端設定無法啟用本機解密。
+在未變更的加密 v2 路徑上，父代理送出的任務是由 ChatGPT 後端產生的 `encrypted_content`。金鑰留在該後端；OpenCodex 從未持有，所以代理無從解密或重寫。這個值是真正的密文，而非旗標掩蓋下的明文。因此既有密文的不可讀性是結構性限制；明文選項改變的是新任務的產生方式。
代理設定無法啟用本機解密。實驗性 `agentTaskRecovery` 可以要求 ChatGPT 後端復原符合條件的任務，但不會在本機解密其密文。上述授權、適用條件和失敗處理限制仍然有效。
-有三種拓撲不受影響；了解它們有助於釐清失敗範圍：
+下表比較未啟用明文編譯器時的加密 v2 路徑：
| 拓撲 | v1 | v2 |
| --- | --- | --- |
@@ -57,6 +71,7 @@ OpenCodex 將影響記錄於 [＃92](https://github.com/lidge-jun/opencodex/issu
| **v1**（預設） | 每個模型都宣告傳統的具名稱空間 spawn 工具。啟動子代理時可直接指定其他模型。 | 需要跨供應商委派的使用者。這是目前發布的預設值。 |
| **base** | 上游模型釘選：Sol 與 Terra 使用 v2，Luna 使用 v1；未釘選的模型遵循 Codex 自身旗標。 | 想使用 Codex 預期的各模型介面，而且只在同一供應商內委派。 |
| **v2** | 每個模型都宣告扁平化的並行工具。 | 想使用較新的並行工作階段模型，且父子代理位於邊界同一側。 |
+| **v2-plaintext** | 為新工作階段選擇 V2，關閉全域強制，並為合格請求啟用明文編譯。 | 願意確認明文任務可能被保留，並選用實驗性路徑。 |
base 排在第二而非第一，因為其釘選讓大多數人用來*發起*委派的 Sol 與 Terra 採用 v2。對這個問題而言，base 不是折衷設定；從 ChatGPT 啟動路由子代理時，它的行為與 v2 相同。
@@ -69,7 +84,7 @@ base 排在第二而非第一，因為其釘選讓大多數人用來*發起*委
兩種選擇都會被記錄，通知不會再出現。若未回答就關閉通知，下次開啟儀表板時仍會顯示。
-模式變更只適用於**新的** Codex 工作階段。選擇後請啟動新工作階段；若長時間執行的 App host 仍顯示舊介面，請執行 `ocx sync` 並重新啟動該介面。
+目錄 pin 變更適用於**新的** Codex 工作階段；明文編譯器依目前設定處理合格請求，包括既有 V2 工作階段的後續請求。選擇後請啟動新工作階段；若長時間執行的 App host 仍顯示舊介面，請執行 `ocx sync` 並重新啟動該介面。
## 如果仍想使用 v2
@@ -88,7 +103,7 @@ base 排在第二而非第一，因為其釘選讓大多數人用來*發起*委
## 變更模式
-Dashboard、Models 與 Subagents 都提供同一個 v1/base/v2 開關，三個頁面在選擇 base 或 v2 前都會詢問。CLI 指令如下：
+Dashboard、Models 與 Subagents 都提供 v1/base/v2/v2-plaintext 選擇，三個頁面在選擇 base、v2 或 v2-plaintext 前都會要求確認。CLI 指令如下：
```bash
ocx v2 status
diff --git a/docs-site/src/content/docs/zh-tw/reference/cli.md b/docs-site/src/content/docs/zh-tw/reference/cli.md
index 56909f99bcf..829f54578a3 100644
--- a/docs-site/src/content/docs/zh-tw/reference/cli.md
+++ b/docs-site/src/content/docs/zh-tw/reference/cli.md
@@ -60,3 +60,7 @@ opencodex 的命令列工具是 `ocx`。它依第一個命令名稱分派，有
執行儀表板更新任務。它們是實作細節，不是穩定的使用者面向命令。儀表板會記錄 worker
PID、恢復 worker 已死但仍在進行中的任務、把超過十分鐘且沒有 PID 的舊 active 記錄
視為過期，並保護執行中的 worker 免受並行更新影響。
+
+## 明文子代理模式與設定還原
+
+進入實驗性明文子代理模式請執行 `ocx v2 mode v2-plaintext --acknowledge-plaintext-agent-messages`。一般 `config set` 和 `config import` 會拒絕新進入此模式，因為專用命令也會協調原生模式轉換。還原含有 `multiAgentMode: "v2-plaintext"` 的匯出設定前，請先完成上述確認轉換，再匯入檔案。還原已啟用的模式、更改其他設定及離開明文模式仍受允許；獨立的 `plaintextV2AgentMessages` 偏好不變。
diff --git a/docs-site/src/content/docs/zh-tw/reference/cli/agents.md b/docs-site/src/content/docs/zh-tw/reference/cli/agents.md
index cfdd4070fb4..6ea4ec0c748 100644
--- a/docs-site/src/content/docs/zh-tw/reference/cli/agents.md
+++ b/docs-site/src/content/docs/zh-tw/reference/cli/agents.md
@@ -22,18 +22,22 @@ Codex 整合會把 `web_search = "disabled"` 寫入 `~/.codex/config.toml`，這
指令會回報由此觸發的 Codex 端寫入（`--json` 中的 `codexWebSearch`，否則為結尾的
`Codex config:` 行），並在無法寫入時提示 `ocx sync`。該旗標對 `vision` 同樣有效。
-### `ocx v2 |threads >`
+### `ocx v2 |threads >`
-管理 Codex 的 `multi_agent_v2` 功能旗標與三態多代理介面模式。
+管理 Codex 的 `multi_agent_v2` 功能旗標與四態多代理介面模式。
| 子指令 | 動作 |
| --- | --- |
| `status`（預設） | 回報目前 v2 旗標、多代理模式與執行緒並行數。 |
-| `on` | 啟用 `multi_agent_v2` 功能並重新同步目錄。 |
+| `on` | 啟用 `multi_agent_v2` 功能並重新同步目錄；`v2-plaintext` 或混合 pin 生效時會拒絕，因為全域強制會蓋過目錄 pin。 |
| `off` | 停用 `multi_agent_v2` 功能並重新同步目錄。 |
| `mode v1` | 將所有模型強制為 v1、停用原生 v2，並保留現用執行緒上限。 |
| `mode default` | 遵循上游模型介面 pin。 |
-| `mode v2` | 將所有模型強制為 v2、啟用原生 v2，並保留現用執行緒上限。 |
+| `mode v2` | 將所有模型設為 v2 並保留執行緒上限；`keep-native-v1` 關閉時啟用全域原生 v2，開啟時關閉全域強制並使用目錄 pin。 |
+| `mode v2-plaintext --acknowledge-plaintext-agent-messages` | 為新工作階段選擇 V2、關閉全域強制，並以明文傳遞符合條件的工作。進入需要 `--acknowledge-plaintext-agent-messages`。 |
+| `keep-native-v1 on\|off` | 在 `mode v2` 下讓原生 ChatGPT 使用 v1、路由模型使用 v2；啟用時關閉全域 V2 強制。 |
+| `mode-hint ` | 為所有模型與推理強度設定主動委派提示。 |
+| `mode-hint --clear` | 移除提示，恢復依推理強度決定的策略。 |
| `threads ` | 將現用 v1/v2 執行緒上限設為不小於 1 的整數。 |
```bash
@@ -44,7 +48,7 @@ ocx v2 on
ocx v2 threads 16
```
-`mode` 子指令將 `multiAgentMode` 寫入 opencodex 設定並重新同步 Codex 目錄。模式與旗標轉換會在有效的 v1/v2 Codex key 之間移動目前的數值執行緒上限；失敗的轉換會還原原始的 `config.toml`。變更套用於新的 Codex session，執行中的 session 則保留其 pin 的介面。
+`mode` 子指令將 `multiAgentMode` 寫入 opencodex 設定並重新同步 Codex 目錄。模式與旗標轉換會在有效的 v1/v2 Codex key 之間移動目前的數值執行緒上限；失敗的轉換會還原原始的 `config.toml`。目錄介面變更套用於新的 Codex session，執行中的 session 則保留其 pin；啟用明文編譯也會影響既有 V2 session 的後續合格請求。Subagents 的 Ultra 開啟開關需要已啟用原生功能且模式為 `v2`，或選擇 `v2-plaintext`（其全域強制保持關閉）；僅執行 `ocx v2 on` 不符合條件。
## 組合路由
diff --git a/docs-site/src/content/docs/zh-tw/reference/configuration/agents.md b/docs-site/src/content/docs/zh-tw/reference/configuration/agents.md
index 88e5f4208ba..24fef47218a 100644
--- a/docs-site/src/content/docs/zh-tw/reference/configuration/agents.md
+++ b/docs-site/src/content/docs/zh-tw/reference/configuration/agents.md
@@ -9,7 +9,7 @@ Agent 設定控制要廣告哪個 Codex 協作介面，以及 opencodex 如何
| 欄位 | 型別 | 預設值 | 意義 |
| --- | --- | --- | --- |
-| `multiAgentMode?` | `"v1" \| "default" \| "v2"` | `"default"` | `v1` 將每個目錄模型標記為 v1；`v2` 將每個模型標記為 v2。`default` 還原上游 pin（Sol/Terra v2、Luna v1），否則遵循原生的 `multi_agent_v2` 旗標。套用於新 session。 |
+| `multiAgentMode?` | `"v1" \| "default" \| "v2" \| "v2-plaintext"` | `"default"` | `v1` 將每個目錄模型標記為 v1；`v2` 將每個模型標記為 v2。`default` 還原上游 pin（Sol/Terra v2、Luna v1），否則遵循原生的 `multi_agent_v2` 旗標。目錄 pin 適用於新 session。`v2-plaintext` 選擇 V2、關閉全域強制並啟用實驗性明文任務傳遞；編譯器也影響既有 V2 工作階段的後續合格請求。 |
| `subagentModels?` | `string[]` | `gpt-6-astra`, `gpt-6.1-sol`, `gpt-6-luna` | 最多五個原生 id、帳號限定的 `/` id 或路由 `provider/model` id，優先顯示在子代理選擇器中。新增選項只提供原生和路由 id；儲存時會保留已設定的精確帳號限定 id，包括目前目錄中無法使用的 id。如需新增精確帳號限定 id，請使用 `ocx agent subagents set` 或編輯設定。[Astra 一次性升級](/reference/configuration/agents/#astra-roster-upgrade)後，明確的空清單會被保留。 |
| `injectionModel?` | `string` | — | 在代理撰寫的 v2 委派指引中使用的偏好原生或路由子代理模型。 |
| `injectionEffort?` | `string` | — | 偏好 effort（`low` 到 `ultra`），僅在搭配 `injectionModel` 時有意義。 |
@@ -19,9 +19,18 @@ Agent 設定控制要廣告哪個 Codex 協作介面，以及 opencodex 如何
| `subagentModelFallback?` | `string[]` | `[]` | 為生成的子任務回合排序的全域 fallback 模型。 |
| `subagentModelFallbackPollMs?` | `number` | `60000` | 可用性探測快取間隔。低於 1000 ms 的值會回退到預設值。 |
| `effortCap?` | `string` | — | 合格 v2 主回合與標記的生成子回合的硬性上限。接受 `low` 到 `ultra`。 |
+| `plaintextV2AgentMessages?` | `boolean` | —（未設定） | 實驗性選項。明確設為 `true` 或選擇 `multiAgentMode: "v2-plaintext"` 會要求合格的原生 ChatGPT v2 父代理以明文產生 `spawn_agent`、`send_message`、`followup_task` 的訊息引數。詳見[明文 v2 代理訊息](#plaintext-v2-agent-messages)。 |
| `subagentEffortCap?` | `string` | — | 僅針對生成子回合的額外上限。當兩個上限都適用時，取較低者。 |
-使用儀表板或 `ocx v2 status|on|off|mode |threads ` 管理介面。模式變更套用於新 session。`maxConcurrentThreadsPerSession` 是 `PUT /api/v2` 欄位，不是 `config.json` key；`ocx v2 threads ` 在啟用 v2 後，將 `max_concurrent_threads_per_session` 寫入 Codex 的 `$CODEX_HOME/config.toml` 中 `[features.multi_agent_v2]` 之下。
+使用儀表板或 `ocx v2 status|on|off|mode |threads ` 管理介面。目錄 pin 變更適用於新工作階段；明文編譯器依目前設定處理合格請求，包括既有 V2 工作階段的後續請求。`maxConcurrentThreadsPerSession` 是 `PUT /api/v2` 欄位，不是 `config.json` key；`ocx v2 threads ` 在啟用 v2 後，將 `max_concurrent_threads_per_session` 寫入 Codex 的 `$CODEX_HOME/config.toml` 中 `[features.multi_agent_v2]` 之下。
+
+## Plaintext v2 agent messages
+
+`plaintextV2AgentMessages` 在新設定中未設定；明確設為 `true` 或選擇 `multiAgentMode: "v2-plaintext"` 均會啟用此實驗路徑。模式不會覆寫獨立布林值，因此離開模式後仍遵循其原值。透過儀表板確認，或執行 `ocx v2 mode v2-plaintext --live --acknowledge-plaintext-agent-messages` 進入。管理 API 的 `PUT /api/v2` 首次進入時須提供 `plaintextAgentMessagesAcknowledged: true`。
+
+呼叫方必須使用 Responses，最終目的地必須是標準 ChatGPT Codex forward 傳輸：`adapter: "openai-responses"`、`authMode: "forward"`，以及確切網址 `https://chatgpt.com/backend-api/codex`。API 金鑰 provider、自訂相容閘道、其他最終 provider 及非 Responses 呼叫不會被改寫。啟用編譯也影響既有 V2 工作階段後續的合格請求；既有密文不會被解密，已儲存歷史不會改寫，停用也不會刪除歷史、provider 請求或本機回應／除錯狀態中已保留的副本。HTTPS 與驗證仍啟用。
+
+啟用任一設定時，本機重放需要相同獲准的 opencodex 呼叫方身分及請求自身非空白的 `thread-id`；否則須省略 `previous_response_id` 並重送完整對話。啟用期間保留的狀態停用後仍維持綁定。預設 `v1` 對未綁定狀態保留原有父執行緒範圍續接行為。
管理 API 暴露 `GET`/`PUT /api/v2`、`/api/injection-model`、`/api/effort-caps`、`/api/subagent-models` 與 `/api/subagent-model-fallback`。注入模型更新為部分更新；自訂 prompt 是該 API 的 `prompt` 欄位。
diff --git a/gui/src/components/PlaintextV2ConsentModal.tsx b/gui/src/components/PlaintextV2ConsentModal.tsx
new file mode 100644
index 00000000000..9a2a0feab74
--- /dev/null
+++ b/gui/src/components/PlaintextV2ConsentModal.tsx
@@ -0,0 +1,90 @@
+/**
+ * Consent dialog for the 'v2-plaintext' sub-agent surface.
+ *
+ * The mode sends native v2 collaboration task text to ChatGPT without the encryption
+ * marker, so entering it requires an explicit acknowledgement on the same PUT. The
+ * checkbox is that acknowledgement: nothing is written until it is checked and the
+ * operator confirms. It deliberately replaces the base/v2 warning dialog for this
+ * mode, so one confirmation covers the experimental/plaintext notice and the usual
+ * "v1 is the reliable default" guidance instead of asking twice in a row.
+ */
+import { useCallback, useEffect, useId, useRef, useState } from "react";
+import { useT } from "../i18n/shared";
+import { IconAlert } from "../icons";
+
+export default function PlaintextV2ConsentModal({
+ busy = false,
+ onConfirm,
+ onDismiss,
+}: {
+ busy?: boolean;
+ /** Checkbox checked plus confirm clicked: send the mode with its acknowledgement. */
+ onConfirm: () => void;
+ /** Escape or backdrop: abandon the selection, keep the stored mode. */
+ onDismiss: () => void;
+}) {
+ const t = useT();
+ const titleId = useId();
+ const bodyId = useId();
+ const dialogRef = useRef(null);
+ const [acknowledged, setAcknowledged] = useState(false);
+
+ // Open as a native modal dialog — focus trapping and the backdrop come from the platform.
+ useEffect(() => {
+ const dialog = dialogRef.current;
+ if (dialog && !dialog.open) dialog.showModal();
+ }, []);
+
+ const handleCancel = useCallback((e: React.SyntheticEvent) => {
+ e.preventDefault();
+ // Escape could otherwise close the dialog over a request that then lands anyway.
+ if (busy) return;
+ onDismiss();
+ }, [busy, onDismiss]);
+
+ return (
+
+ );
+}
diff --git a/gui/src/components/subagents-workspace/SubagentDelegationSection.tsx b/gui/src/components/subagents-workspace/SubagentDelegationSection.tsx
index 480ef9d3346..66ef95dde87 100644
--- a/gui/src/components/subagents-workspace/SubagentDelegationSection.tsx
+++ b/gui/src/components/subagents-workspace/SubagentDelegationSection.tsx
@@ -11,6 +11,7 @@ import { Select } from "../../ui";
import { IconArrowDown, IconArrowUp, IconChevron, IconX } from "../../icons";
import { useT, type TKey } from "../../i18n/shared";
import { formatNamespacedModelId } from "../../provider-icons";
+import { subagentSurfaceModes } from "../../subagent-surface";
import { clampNumberDraft } from "../../clamp-draft";
import { cn } from "@/lib/utils";
import { Button } from "../ui-v2/button";
@@ -311,11 +312,14 @@ export default function SubagentDelegationSection({
{t("models.v2DocsLink")}
+ {ultraMode.plaintextAgentMessagesEnabled === true && (
+ {t("models.v2PlaintextOn")}
+ )}
}
help={{t("models.v2Help")}}
control={