You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit e44d234
Browse filesBrowse the repository at this point in the historyBrowse files
| Codex login (no eligible account selectors) | Bare native ids such as `gpt-5.6-sol`, `gpt-5.6-terra`, and `gpt-5.6-luna`; Pool or Direct is selected through `codexAccountMode`. GPT-5.6 rows use a 372,000-token catalog window. |
76
+
| Codex login (eligible account selectors) | One `<selector>/<native-openai-model>` row per eligible selector and supported native model; each row uses only its mapped account, and bare native rows are hidden from the picker. Native metadata and context windows are preserved. |
68
77
| OpenAI (API key) | Exactly eight namespaced rows: `gpt-5.5`, `gpt-5.6`, Sol/Terra/Luna, and the three `*-pro` virtual ids (1,050,000 context; 922,000 max input for all eight) |
| Cursor | Static fallback includes `cursor/gpt-5.6-sol`, `cursor/gpt-5.6-terra`, and `cursor/gpt-5.6-luna` (1,000,000), plus `cursor/grok-4.5` and `cursor/grok-4.5-fast` (500,000); live account discovery decides which remain visible. |
@@ -78,13 +87,18 @@ must still be entitled to use that model.
78
87
79
88
## Native and routed model toggles
80
89
81
-
The dashboard Models page uses `disabledModels` for both model families:
90
+
The dashboard Models page exposes `disabledModels` toggles for bare native ids and routed
91
+
`provider/model` ids. Account-qualified `<selector>/<native-openai-model>` ids are also supported by
92
+
`disabledModels`, but the dashboard does not list or toggle those exact selector rows; add them to
93
+
the configuration manually:
82
94
83
95
- Routed ids are namespaced (`provider/model`). Disabling one excludes it from the synced catalog
84
96
and `/v1/models`.
85
-
- Native GPT ids are bare slugs. Disabling one keeps its catalog entry but changes
86
-
`visibility` to `hide`, preserving the exact entry for a later re-enable; the bare OpenAI list
87
-
shape omits it while disabled.
97
+
- Account-qualified native ids use `<selector>/<native-openai-model>`. Adding one to
98
+
`disabledModels` hides only that selector row.
99
+
- Native GPT ids are bare slugs. Disabling one keeps its catalog entry but changes `visibility` to
100
+
`hide`, preserving the exact entry for a later re-enable; it hides the bare row and every
101
+
selector-qualified clone for that model from discovery.
88
102
- Native rows come from the supported static set, so a disabled native model stays visible in the
89
103
dashboard and can be turned back on.
90
104
@@ -129,9 +143,12 @@ never advertised where it cannot be honored, and custom gateways can opt in expl
129
143
## Subagent selection
130
144
131
145
Codex sorts picker-visible catalog entries by ascending `priority` and advertises the first five as
132
-
`spawn_agent` model overrides. Pick up to five bare native ids or namespaced `provider/model` ids
133
-
through `subagentModels` or the dashboard Subagents page; opencodex gives those entries priorities
134
-
0-4 in the chosen order. Other models remain callable by exact id.
146
+
`spawn_agent` model overrides. The dashboard Subagents page can select and save up to five bare
147
+
native ids or routed `provider/model` ids. Manually configured `subagentModels` also accepts
148
+
account-qualified `<selector>/<native-openai-model>` ids, but the dashboard does not offer those
149
+
exact ids; saving the page replaces the list with dashboard-visible choices. opencodex assigns low
150
+
catalog priorities in the selected order; when account selectors are active, bare native selections
151
+
expand into selector-qualified groups. Other models remain callable by exact id.
135
152
136
153
The featured-model list is separate from the Dashboard's **Sub-agent delegation** selection. It
137
154
controls which overrides Codex offers first; it does not select a model or trigger delegation by
Copy file name to clipboardExpand all lines: docs-site/src/content/docs/guides/sub-agent-surface.md
+5-4Lines changed: 5 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -60,15 +60,16 @@ Custom `injectionPrompt` text can use all four placeholders:
60
60
61
61
| Placeholder | Replaced with |
62
62
| --- | --- |
63
-
|`{{model}}`| The configured `injectionModel`, or an empty string |
63
+
|`{{model}}`| The effective preferred model for this request. A bare native `injectionModel` is account-qualified only when the request itself targets an explicit account selector. An unresolved or ambiguous bare value becomes an empty string; an unresolved explicit account-qualified or routed id remains unchanged|
64
64
|`{{effort}}`| The configured `injectionEffort`, or an empty string |
65
65
|`{{roster}}`| The resolved picker-visible, surface-compatible roster |
66
66
|`{{fallback}}`| The configured global fallback guidance |
67
67
68
68
The built-in v2 guidance has a 700-character budget. If it would exceed the budget, opencodex drops
69
-
the roster first rather than truncating the core spawn instructions. Guidance fires only when a
70
-
preferred model, eligible roster, or fallback chain resolves. A custom prompt does not bypass that
71
-
gate.
69
+
the roster first rather than truncating the core spawn instructions. Built-in guidance fires only
70
+
when a preferred model, eligible roster, or fallback chain resolves. A configured `injectionModel`
71
+
is sufficient to render a custom prompt; if a bare value cannot resolve uniquely, `{{model}}`
72
+
expands to an empty string.
72
73
73
74
On v1, opencodex injects only the upstream-style proactive delegation guidance at `max` or `ultra`
74
75
effort. It does not add a preferred model, roster, fallback list, or custom prompt on v1.
0 commit comments