From 3ee363fc084b2d63b695129345238e2afac21dec Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Thu, 27 Aug 2026 04:19:05 -0700 Subject: [PATCH] docs(codex): correct effort support and provenance in harness reference (#130882) --- docs/plugins/codex-harness-reference.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/docs/plugins/codex-harness-reference.md b/docs/plugins/codex-harness-reference.md index 5937fcb039f0..d6a52ed10a64 100644 --- a/docs/plugins/codex-harness-reference.md +++ b/docs/plugins/codex-harness-reference.md @@ -758,13 +758,14 @@ be account-scoped. Use `/codex models` on a running gateway to see the live catalog for that harness and account. If discovery is temporarily unavailable or times out, the subscription route -uses offline hints derived from the bundled OpenAI model manifest: +uses offline hints derived from the bundled OpenAI model manifest, with Codex +plugin fallbacks for `gpt-5.5` and `gpt-5.5-pro` reasoning efforts: -| Model id | Display name | Reasoning efforts | -| ------------- | ------------ | ------------------------------------ | -| `gpt-5.6-sol` | GPT-5.6 Sol | low, medium, high, xhigh, max, ultra | -| `gpt-5.5` | GPT-5.5 | low, medium, high, xhigh | -| `gpt-5.5-pro` | gpt-5.5-pro | medium, high, xhigh | +| Model id | Display name | Reasoning efforts | +| ------------- | ------------ | ----------------------------- | +| `gpt-5.6-sol` | GPT-5.6 Sol | low, medium, high, xhigh, max | +| `gpt-5.5` | GPT-5.5 | low, medium, high, xhigh | +| `gpt-5.5-pro` | gpt-5.5-pro | medium, high, xhigh | Offline hints never prove account entitlement. An authenticated discovery response remains authoritative even if it contains no visible models; HTTP @@ -791,10 +792,10 @@ Available model IDs, input modalities, and reasoning efforts remain account-scoped. Run `/codex models` after starting or upgrading the gateway to inspect the actual public picker for your account. -The app-server catalog can report `ultra`; OpenClaw reasoning controls currently -expose levels through `max`. Hidden models can also appear in the app-server -catalog for internal or specialized flows without being normal model-picker -choices. +The app-server catalog can report `ultra`; OpenClaw reasoning controls for the +Codex runtime currently expose levels through `max`. Hidden models can also +appear in the app-server catalog for internal or specialized flows without being +normal model-picker choices. Tune discovery under `plugins.entries.codex.config.discovery`: