Skip to content

Commit 546c797

Browse files
committed
feat(models): per-custom-model reasoning effort in the Models dashboard
The custom-model dialog (and `ocx models add/edit`) now accepts an explicit reasoning ladder plus a default effort. Custom rows carry the override into the Codex catalog, winning over the provider-derived ladder (the #962 inheritance), and an explicit empty ladder hides the effort control (#883). The Pi export emits `reasoning: true` for rows with a non-empty ladder so Pi's effort control appears for routed models instead of being a documented omission.
1 parent 81ada7c commit 546c797

21 files changed

Lines changed: 535 additions & 16 deletions

File tree

‎docs-site/src/content/docs/guides/pi.md‎

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -103,9 +103,16 @@ small-context model is never given more output than context. It is not a claim a
103103
model's true maximum.
104104

105105
Two fields are deliberately absent. `cost` requires all four price fields and opencodex has no
106-
price data for routed models — emitting zeros would assert that every model is free. `reasoning` is
107-
a boolean in Pi while the catalog carries an effort ladder, and mapping one onto the other would be
108-
a guess.
106+
price data for routed models — emitting zeros would assert that every model is free.
107+
108+
`reasoning` is the one field that used to be absent and now is not: Pi stores a boolean while the
109+
catalog carries an effort ladder, and mapping one onto the other used to be a guess. Since the
110+
catalog's ladder is the proxy's own statement about whether a model accepts reasoning parameters
111+
(adapters honor `reasoning_effort`), an export row with a **non-empty** ladder now emits
112+
`"reasoning": true`, and a row without one (or with an explicitly empty ladder) stays
113+
reasoning-free. Pi then offers its effort control for exactly the models opencodex will accept it
114+
on. If you need Pi-specific effort values — for example clamping `xhigh`/`max` away — add a
115+
hand-written `thinkingLevelMap` to the model entry as documented by Pi.
109116

110117
## Schema status
111118

‎gui/src/i18n/de.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -539,6 +539,10 @@ export const de: Record<TKey, string> = {
539539
"models.customFieldDisplayNamePlaceholder": "z. B. Qwen 4 Max Preview",
540540
"models.customFieldContext": "Kontextfenster",
541541
"models.customFieldModalities": "Eingabemodalitäten",
542+
"models.customFieldReasoning": "Reasoning-Aufwand",
543+
"models.customFieldReasoningOverride": "Vom Provider abgeleitete Stufen überschreiben",
544+
"models.customFieldEfforts": "Unterstützte Stufen",
545+
"models.customFieldDefaultEffort": "Standard-Stufe",
542546
"models.tipProvider": "Anbieter",
543547
"models.tipContext": "Kontext",
544548
"models.tipModalities": "Modalitäten",

‎gui/src/i18n/en.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -564,6 +564,10 @@ export const en = {
564564
"models.customFieldDisplayNamePlaceholder": "e.g. Qwen 4 Max Preview",
565565
"models.customFieldContext": "Context window",
566566
"models.customFieldModalities": "Input modalities",
567+
"models.customFieldReasoning": "Reasoning effort",
568+
"models.customFieldReasoningOverride": "Override the provider-derived ladder",
569+
"models.customFieldEfforts": "Supported efforts",
570+
"models.customFieldDefaultEffort": "Default effort",
567571
"models.tipProvider": "Provider",
568572
"models.tipContext": "Context",
569573
"models.tipModalities": "Modalities",

‎gui/src/i18n/ja.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1957,6 +1957,10 @@ export const ja: Record<TKey, string> = {
19571957
"models.customFieldDisplayNamePlaceholder": "e.g. Qwen 4 Max Preview",
19581958
"models.customFieldContext": "Context window",
19591959
"models.customFieldModalities": "Input modalities",
1960+
"models.customFieldReasoning": "推論努力",
1961+
"models.customFieldReasoningOverride": "プロバイダー由来の段階を上書き",
1962+
"models.customFieldEfforts": "サポートされる段階",
1963+
"models.customFieldDefaultEffort": "デフォルトの段階",
19601964
"models.tipProvider": "Provider",
19611965
"models.tipContext": "Context",
19621966
"models.tipModalities": "Modalities",

‎gui/src/i18n/ko.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -550,6 +550,10 @@ export const ko: Record<TKey, string> = {
550550
"models.customFieldDisplayNamePlaceholder": "예: Qwen 4 Max Preview",
551551
"models.customFieldContext": "컨텍스트 윈도우",
552552
"models.customFieldModalities": "입력 모달리티",
553+
"models.customFieldReasoning": "추론 노력",
554+
"models.customFieldReasoningOverride": "공급자 유래 단계 재정의",
555+
"models.customFieldEfforts": "지원 단계",
556+
"models.customFieldDefaultEffort": "기본 단계",
553557
"models.tipProvider": "프로바이더",
554558
"models.tipContext": "컨텍스트",
555559
"models.tipModalities": "모달리티",

‎gui/src/i18n/ru.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -552,6 +552,10 @@ export const ru: Record<TKey, string> = {
552552
"models.customFieldDisplayNamePlaceholder": "например, Qwen 4 Max Preview",
553553
"models.customFieldContext": "Контекстное окно",
554554
"models.customFieldModalities": "Входные модальности",
555+
"models.customFieldReasoning": "Уровень рассуждений",
556+
"models.customFieldReasoningOverride": "Переопределить уровни, унаследованные от провайдера",
557+
"models.customFieldEfforts": "Поддерживаемые уровни",
558+
"models.customFieldDefaultEffort": "Уровень по умолчанию",
555559
"models.tipProvider": "Провайдер",
556560
"models.tipContext": "Контекст",
557561
"models.tipModalities": "Модальности",

‎gui/src/i18n/tr.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -555,6 +555,10 @@ export const tr: Record<TKey, string> = {
555555
"models.customFieldDisplayNamePlaceholder": "örn. Qwen 4 Max Preview",
556556
"models.customFieldContext": "Bağlam penceresi",
557557
"models.customFieldModalities": "Girdi türleri",
558+
"models.customFieldReasoning": "Akıl yürütme çabası",
559+
"models.customFieldReasoningOverride": "Sağlayıcıdan türetilen seviyeleri geçersiz kıl",
560+
"models.customFieldEfforts": "Desteklenen seviyeler",
561+
"models.customFieldDefaultEffort": "Varsayılan seviye",
558562
"models.tipProvider": "Sağlayıcı",
559563
"models.tipContext": "Bağlam",
560564
"models.tipModalities": "Girdi Türleri",

‎gui/src/i18n/zh-TW.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -420,6 +420,10 @@ export const zhTW: Record<TKey, string> = {
420420
"models.customFieldDisplayNamePlaceholder": "例如 Qwen 4 Max Preview",
421421
"models.customFieldContext": "上下文視窗",
422422
"models.customFieldModalities": "輸入模態",
423+
"models.customFieldReasoning": "推理強度",
424+
"models.customFieldReasoningOverride": "覆寫提供者衍生的層級",
425+
"models.customFieldEfforts": "支援的層級",
426+
"models.customFieldDefaultEffort": "預設層級",
423427
"models.tipProvider": "供應商",
424428
"models.tipContext": "上下文",
425429
"models.tipModalities": "模態",

‎gui/src/i18n/zh.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -547,6 +547,10 @@ export const zh: Record<TKey, string> = {
547547
"models.customFieldDisplayNamePlaceholder": "例如 Qwen 4 Max Preview",
548548
"models.customFieldContext": "上下文窗口",
549549
"models.customFieldModalities": "输入模态",
550+
"models.customFieldReasoning": "推理强度",
551+
"models.customFieldReasoningOverride": "覆盖提供方派生的级别",
552+
"models.customFieldEfforts": "支持的级别",
553+
"models.customFieldDefaultEffort": "默认级别",
550554
"models.tipProvider": "提供方",
551555
"models.tipContext": "上下文",
552556
"models.tipModalities": "模态",

‎gui/src/pages/Models.tsx‎

Lines changed: 79 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,7 @@ import {
4949
THREAD_OPTIONS,
5050
writeCollapsedProviders,
5151
discoveryFailureLabel,
52+
REASONING_EFFORT_LEVELS,
5253
type ModelRow,
5354
type ProviderContextCapsResponse,
5455
type ShadowCallData,
@@ -193,6 +194,9 @@ export default function Models({ apiBase }: { apiBase: string }) {
193194
const [customFormContextWindow, setCustomFormContextWindow] = useState("");
194195
const [customFormShowCustomCtx, setCustomFormShowCustomCtx] = useState(false);
195196
const [customFormModalities, setCustomFormModalities] = useState<string[]>(["text"]);
197+
const [customFormReasoning, setCustomFormReasoning] = useState(false);
198+
const [customFormReasoningEfforts, setCustomFormReasoningEfforts] = useState<string[]>([]);
199+
const [customFormDefaultEffort, setCustomFormDefaultEffort] = useState("");
196200
const [customSaving, setCustomSaving] = useState(false);
197201
const [customError, setCustomError] = useState("");
198202
const [contextModalProvider, setContextModalProvider] = useState<string | null>(null);
@@ -831,14 +835,16 @@ export default function Models({ apiBase }: { apiBase: string }) {
831835
displayName?: string,
832836
contextWindow?: number,
833837
inputModalities?: string[],
838+
reasoningEfforts?: string[],
839+
defaultReasoningEffort?: string,
834840
) => {
835841
setCustomSaving(true);
836842
setCustomError("");
837843
try {
838844
const r = await fetch(`${apiBase}/api/custom-models`, {
839845
method: "POST",
840846
headers: { "Content-Type": "application/json" },
841-
body: JSON.stringify({ provider, modelId, displayName, contextWindow, inputModalities }),
847+
body: JSON.stringify({ provider, modelId, displayName, contextWindow, inputModalities, reasoningEfforts, defaultReasoningEffort }),
842848
});
843849
try {
844850
await readJsonOrThrow(r, t("models.customSaveFailed"));
@@ -1000,6 +1006,9 @@ export default function Models({ apiBase }: { apiBase: string }) {
10001006
setCustomFormContextWindow("");
10011007
setCustomFormShowCustomCtx(false);
10021008
setCustomFormModalities(["text"]);
1009+
setCustomFormReasoning(false);
1010+
setCustomFormReasoningEfforts([]);
1011+
setCustomFormDefaultEffort("");
10031012
setCustomError("");
10041013
setCustomModalOpen(true);
10051014
}}
@@ -1146,6 +1155,12 @@ export default function Models({ apiBase }: { apiBase: string }) {
11461155
setCustomFormContextWindow(m.contextWindow ? String(m.contextWindow) : "");
11471156
setCustomFormShowCustomCtx(false);
11481157
setCustomFormModalities(m.inputModalities ?? ["text"]);
1158+
// Only a STORED ladder counts as "configured": an inherited one
1159+
// would show a phantom override that saves "inherit" over the
1160+
// provider row's current metadata.
1161+
setCustomFormReasoning(Array.isArray(m.reasoningEfforts));
1162+
setCustomFormReasoningEfforts(m.reasoningEfforts ?? []);
1163+
setCustomFormDefaultEffort(m.defaultReasoningEffort ?? "");
11491164
setCustomError("");
11501165
setCustomModalOpen(true);
11511166
setHoveredModel(null);
@@ -1595,6 +1610,61 @@ export default function Models({ apiBase }: { apiBase: string }) {
15951610
))}
15961611
</div>
15971612
</div>
1613+
1614+
<label className="text-label models-field">
1615+
{t("models.customFieldReasoning")}
1616+
<div className="row models-field-row">
1617+
<label className="row models-modality-option">
1618+
<input
1619+
type="checkbox"
1620+
checked={customFormReasoning}
1621+
onChange={e => setCustomFormReasoning(e.target.checked)}
1622+
disabled={customSaving}
1623+
/>
1624+
<span className="text-control">{t("models.customFieldReasoningOverride")}</span>
1625+
</label>
1626+
</div>
1627+
</label>
1628+
{customFormReasoning && (
1629+
<>
1630+
<div className="text-label models-field">
1631+
{t("models.customFieldEfforts")}
1632+
<div className="row models-field-row" style={{ flexWrap: "wrap" }}>
1633+
{REASONING_EFFORT_LEVELS.map(effort => (
1634+
<label key={effort} className="row models-modality-option">
1635+
<input
1636+
type="checkbox"
1637+
checked={customFormReasoningEfforts.includes(effort)}
1638+
onChange={e => {
1639+
setCustomFormReasoningEfforts(prev => (
1640+
e.target.checked ? [...prev, effort] : prev.filter(level => level !== effort)
1641+
));
1642+
if (!e.target.checked && customFormDefaultEffort === effort) {
1643+
setCustomFormDefaultEffort("");
1644+
}
1645+
}}
1646+
disabled={customSaving}
1647+
/>
1648+
<span className="text-control">{effort}</span>
1649+
</label>
1650+
))}
1651+
</div>
1652+
</div>
1653+
<label className="text-label models-field">
1654+
{t("models.customFieldDefaultEffort")}
1655+
<Select
1656+
value={customFormDefaultEffort}
1657+
options={[
1658+
{ value: "", label: "—" },
1659+
...customFormReasoningEfforts.map(effort => ({ value: effort, label: effort })),
1660+
]}
1661+
onChange={setCustomFormDefaultEffort}
1662+
disabled={customSaving || customFormReasoningEfforts.length === 0}
1663+
label={t("models.customFieldDefaultEffort")}
1664+
/>
1665+
</label>
1666+
</>
1667+
)}
15981668
</div>
15991669

16001670
<div className="modal-actions">
@@ -1611,19 +1681,27 @@ export default function Models({ apiBase }: { apiBase: string }) {
16111681
const ctxVal = customFormContextWindow ? Number(customFormContextWindow.replace(/[_,\s]/g, "")) : undefined;
16121682
const contextWindow = ctxVal && ctxVal > 0 ? Math.floor(ctxVal) : undefined;
16131683
if (customModalMode === "add") {
1684+
const reasoningEfforts = customFormReasoning ? customFormReasoningEfforts : undefined;
1685+
const defaultEffort = customFormReasoning && customFormDefaultEffort ? customFormDefaultEffort : undefined;
16141686
void addCustomModel(
16151687
customModalProvider,
16161688
modelId,
16171689
displayName || undefined,
16181690
contextWindow,
16191691
customFormModalities.length > 0 ? customFormModalities : undefined,
1692+
reasoningEfforts,
1693+
defaultEffort,
16201694
);
16211695
} else {
1696+
// `null` clears a stored override back to "inherit from the provider row";
1697+
// an explicit empty ladder stays stored as "no reasoning".
16221698
void updateCustomModel(customModalId, {
16231699
modelId,
16241700
displayName,
16251701
contextWindow: contextWindow ?? null,
16261702
inputModalities: customFormModalities,
1703+
reasoningEfforts: customFormReasoning ? customFormReasoningEfforts : null,
1704+
defaultReasoningEffort: customFormReasoning && customFormDefaultEffort ? customFormDefaultEffort : null,
16271705
});
16281706
}
16291707
}}

0 commit comments

Comments
 (0)