feat(models): per-custom-model reasoning effort in the Models dashboard

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

@@ -103,9 +103,26 @@ small-context model is never given more output than context. It is not a claim a
 model's true maximum.
 
 Two fields are deliberately absent. `cost` requires all four price fields and opencodex has no
-price data for routed models — emitting zeros would assert that every model is free. `reasoning` is
-a boolean in Pi while the catalog carries an effort ladder, and mapping one onto the other would be
-a guess.
+price data for routed models — emitting zeros would assert that every model is free.
+
+`reasoning` is the one field that used to be absent and now is not: Pi stores a boolean while the
+catalog carries an effort ladder, and mapping one onto the other used to be a guess. Since the
+catalog's ladder is the proxy's own statement about whether a model accepts reasoning parameters
+(adapters honor `reasoning_effort`), an export row with a **non-empty** ladder now emits
+`"reasoning": true`, and a row without one (or with an explicitly empty ladder) stays
+reasoning-free. Pi then offers its effort control for exactly the models opencodex will accept it
+on. The export also emits a `thinkingLevelMap` that hides every pi level with no declared target
+(`null`), so pi never offers — and never sends — an effort the ladder does not contain. One
+fallback keeps the model usable: when `ultra` is declared without `max`, pi's `max` level maps
+to `ultra` (still a ladder member).
+If you need a different mapping, hand-edit `thinkingLevelMap` afterward as documented by Pi.
+
+Treat `reasoning` as Pi-UI metadata: it is derived from the catalog ladder, not proof that the
+upstream natively supports a reasoning parameter. What the proxy actually sends for a given
+`reasoning_effort` value depends on the provider's adapter and model — it may pass the value
+through, translate it (wire aliases), clamp it to the configured ladder, emulate it, or omit it
+entirely (e.g. `noReasoningModels`). The boolean only controls whether Pi offers the control at
+all.
 
 ## Schema status
 

gui/src/i18n/de.ts

@@ -539,6 +539,15 @@ export const de: Record<TKey, string> = {
   "models.customFieldDisplayNamePlaceholder": "z. B. Qwen 4 Max Preview",
   "models.customFieldContext": "Kontextfenster",
   "models.customFieldModalities": "Eingabemodalitäten",
+  "models.customFieldReasoning": "Reasoning-Aufwand",
+  "models.customFieldReasoningOverride": "Reasoning-Aufwand überschreiben",
+  "models.reasoningEffort.none": "Keine",
+  "models.reasoningEffort.minimal": "Minimal",
+  "models.reasoningEffort.low": "Niedrig",
+  "models.reasoningEffort.medium": "Mittel",
+  "models.reasoningEffort.high": "Hoch",
+  "models.reasoningEffort.xhigh": "Sehr hoch",
+  "models.reasoningEffort.max": "Maximal",
   "models.tipProvider": "Anbieter",
   "models.tipContext": "Kontext",
   "models.tipModalities": "Modalitäten",

gui/src/i18n/en.ts

@@ -564,6 +564,15 @@ export const en = {
   "models.customFieldDisplayNamePlaceholder": "e.g. Qwen 4 Max Preview",
   "models.customFieldContext": "Context window",
   "models.customFieldModalities": "Input modalities",
+  "models.customFieldReasoning": "Reasoning effort",
+  "models.customFieldReasoningOverride": "Override reasoning effort",
+  "models.reasoningEffort.none": "None",
+  "models.reasoningEffort.minimal": "Minimal",
+  "models.reasoningEffort.low": "Low",
+  "models.reasoningEffort.medium": "Medium",
+  "models.reasoningEffort.high": "High",
+  "models.reasoningEffort.xhigh": "Extra high",
+  "models.reasoningEffort.max": "Maximum",
   "models.tipProvider": "Provider",
   "models.tipContext": "Context",
   "models.tipModalities": "Modalities",

gui/src/i18n/ja.ts

@@ -1957,6 +1957,15 @@ export const ja: Record<TKey, string> = {
   "models.customFieldDisplayNamePlaceholder": "e.g. Qwen 4 Max Preview",
   "models.customFieldContext": "Context window",
   "models.customFieldModalities": "Input modalities",
+  "models.customFieldReasoning": "推論努力",
+  "models.customFieldReasoningOverride": "推論努力を上書き",
+  "models.reasoningEffort.none": "なし",
+  "models.reasoningEffort.minimal": "最小",
+  "models.reasoningEffort.low": "低",
+  "models.reasoningEffort.medium": "中",
+  "models.reasoningEffort.high": "高",
+  "models.reasoningEffort.xhigh": "非常に高",
+  "models.reasoningEffort.max": "最大",
   "models.tipProvider": "Provider",
   "models.tipContext": "Context",
   "models.tipModalities": "Modalities",

gui/src/i18n/ko.ts

@@ -550,6 +550,15 @@ export const ko: Record<TKey, string> = {
   "models.customFieldDisplayNamePlaceholder": "예: Qwen 4 Max Preview",
   "models.customFieldContext": "컨텍스트 윈도우",
   "models.customFieldModalities": "입력 모달리티",
+  "models.customFieldReasoning": "추론 노력",
+  "models.customFieldReasoningOverride": "추론 노력 재정의",
+  "models.reasoningEffort.none": "없음",
+  "models.reasoningEffort.minimal": "최소",
+  "models.reasoningEffort.low": "낮음",
+  "models.reasoningEffort.medium": "중간",
+  "models.reasoningEffort.high": "높음",
+  "models.reasoningEffort.xhigh": "매우 높음",
+  "models.reasoningEffort.max": "최대",
   "models.tipProvider": "프로바이더",
   "models.tipContext": "컨텍스트",
   "models.tipModalities": "모달리티",

gui/src/i18n/ru.ts

@@ -552,6 +552,15 @@ export const ru: Record<TKey, string> = {
   "models.customFieldDisplayNamePlaceholder": "например, Qwen 4 Max Preview",
   "models.customFieldContext": "Контекстное окно",
   "models.customFieldModalities": "Входные модальности",
+  "models.customFieldReasoning": "Уровень рассуждений",
+  "models.customFieldReasoningOverride": "Переопределить уровень рассуждений",
+  "models.reasoningEffort.none": "Нет",
+  "models.reasoningEffort.minimal": "Минимальный",
+  "models.reasoningEffort.low": "Низкий",
+  "models.reasoningEffort.medium": "Средний",
+  "models.reasoningEffort.high": "Высокий",
+  "models.reasoningEffort.xhigh": "Очень высокий",
+  "models.reasoningEffort.max": "Максимальный",
   "models.tipProvider": "Провайдер",
   "models.tipContext": "Контекст",
   "models.tipModalities": "Модальности",

gui/src/i18n/tr.ts

@@ -555,6 +555,15 @@ export const tr: Record<TKey, string> = {
   "models.customFieldDisplayNamePlaceholder": "örn. Qwen 4 Max Preview",
   "models.customFieldContext": "Bağlam penceresi",
   "models.customFieldModalities": "Girdi türleri",
+  "models.customFieldReasoning": "Akıl yürütme çabası",
+  "models.customFieldReasoningOverride": "Akıl yürütme çabasını geçersiz kıl",
+  "models.reasoningEffort.none": "Yok",
+  "models.reasoningEffort.minimal": "Minimal",
+  "models.reasoningEffort.low": "Düşük",
+  "models.reasoningEffort.medium": "Orta",
+  "models.reasoningEffort.high": "Yüksek",
+  "models.reasoningEffort.xhigh": "Çok yüksek",
+  "models.reasoningEffort.max": "Maksimum",
   "models.tipProvider": "Sağlayıcı",
   "models.tipContext": "Bağlam",
   "models.tipModalities": "Girdi Türleri",

gui/src/i18n/zh-TW.ts

@@ -420,6 +420,15 @@ export const zhTW: Record<TKey, string> = {
   "models.customFieldDisplayNamePlaceholder": "例如 Qwen 4 Max Preview",
   "models.customFieldContext": "上下文視窗",
   "models.customFieldModalities": "輸入模態",
+  "models.customFieldReasoning": "推理強度",
+  "models.customFieldReasoningOverride": "覆寫推理強度",
+  "models.reasoningEffort.none": "無",
+  "models.reasoningEffort.minimal": "最低",
+  "models.reasoningEffort.low": "低",
+  "models.reasoningEffort.medium": "中",
+  "models.reasoningEffort.high": "高",
+  "models.reasoningEffort.xhigh": "極高",
+  "models.reasoningEffort.max": "最高",
   "models.tipProvider": "供應商",
   "models.tipContext": "上下文",
   "models.tipModalities": "模態",

gui/src/i18n/zh.ts

@@ -547,6 +547,15 @@ export const zh: Record<TKey, string> = {
   "models.customFieldDisplayNamePlaceholder": "例如 Qwen 4 Max Preview",
   "models.customFieldContext": "上下文窗口",
   "models.customFieldModalities": "输入模态",
+  "models.customFieldReasoning": "推理强度",
+  "models.customFieldReasoningOverride": "覆盖推理强度",
+  "models.reasoningEffort.none": "无",
+  "models.reasoningEffort.minimal": "最低",
+  "models.reasoningEffort.low": "低",
+  "models.reasoningEffort.medium": "中",
+  "models.reasoningEffort.high": "高",
+  "models.reasoningEffort.xhigh": "极高",
+  "models.reasoningEffort.max": "最高",
   "models.tipProvider": "提供方",
   "models.tipContext": "上下文",
   "models.tipModalities": "模态",

gui/src/pages/Models.tsx

@@ -49,6 +49,7 @@ import {
   THREAD_OPTIONS,
   writeCollapsedProviders,
   discoveryFailureLabel,
+  REASONING_EFFORT_LEVELS,
   type ModelRow,
   type ProviderContextCapsResponse,
   type ShadowCallData,
@@ -193,6 +194,13 @@ export default function Models({ apiBase }: { apiBase: string }) {
   const [customFormContextWindow, setCustomFormContextWindow] = useState("");
   const [customFormShowCustomCtx, setCustomFormShowCustomCtx] = useState(false);
   const [customFormModalities, setCustomFormModalities] = useState<string[]>(["text"]);
+  const [customFormReasoning, setCustomFormReasoning] = useState(false);
+  const [customFormReasoningEfforts, setCustomFormReasoningEfforts] = useState<string[]>([]);
+  // Whether the ladder has been seeded at least once. `[]` is a MEANINGFUL explicit
+  // no-reasoning override, so initialization is tracked separately from the array contents:
+  // once seeded (an edit's stored ladder — including an explicit empty one — or a new form's
+  // first enable), re-enabling the override preserves the current array even when empty.
+  const customFormReasoningInitializedRef = useRef(false);
   const [customSaving, setCustomSaving] = useState(false);
   const [customError, setCustomError] = useState("");
   const [contextModalProvider, setContextModalProvider] = useState<string | null>(null);
@@ -831,14 +839,15 @@ export default function Models({ apiBase }: { apiBase: string }) {
     displayName?: string,
     contextWindow?: number,
     inputModalities?: string[],
+    reasoningEfforts?: string[],
   ) => {
     setCustomSaving(true);
     setCustomError("");
     try {
       const r = await fetch(`${apiBase}/api/custom-models`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ provider, modelId, displayName, contextWindow, inputModalities }),
+        body: JSON.stringify({ provider, modelId, displayName, contextWindow, inputModalities, reasoningEfforts }),
       });
       try {
         await readJsonOrThrow(r, t("models.customSaveFailed"));
@@ -1000,6 +1009,9 @@ export default function Models({ apiBase }: { apiBase: string }) {
                    setCustomFormContextWindow("");
                    setCustomFormShowCustomCtx(false);
                    setCustomFormModalities(["text"]);
+                   setCustomFormReasoning(false);
+                   setCustomFormReasoningEfforts([]);
+                   customFormReasoningInitializedRef.current = false;
                    setCustomError("");
                    setCustomModalOpen(true);
                  }}
@@ -1146,6 +1158,14 @@ export default function Models({ apiBase }: { apiBase: string }) {
                                  setCustomFormContextWindow(m.contextWindow ? String(m.contextWindow) : "");
                                  setCustomFormShowCustomCtx(false);
                                  setCustomFormModalities(m.inputModalities ?? ["text"]);
+                                 // Only a STORED ladder counts as "configured": an inherited one
+                                 // would show a phantom override that saves "inherit" over the
+                                 // provider row's current metadata.
+                                 setCustomFormReasoning(Array.isArray(m.reasoningEfforts));
+                                 setCustomFormReasoningEfforts(m.reasoningEfforts ?? []);
+                                 // A stored ladder — even an explicit empty one — is a real
+                                 // configuration: re-enabling must preserve it, not reseed.
+                                 customFormReasoningInitializedRef.current = Array.isArray(m.reasoningEfforts);
                                  setCustomError("");
                                  setCustomModalOpen(true);
                                  setHoveredModel(null);
@@ -1595,6 +1615,56 @@ export default function Models({ apiBase }: { apiBase: string }) {
                   ))}
                 </div>
               </div>
+
+              <div className="text-label models-field">
+                {t("models.customFieldReasoning")}
+                <div className="row models-field-row">
+                  <label className="row models-modality-option">
+                    <input
+                      type="checkbox"
+                      checked={customFormReasoning}
+                      onChange={e => {
+                        setCustomFormReasoning(e.target.checked);
+                        if (e.target.checked && !customFormReasoningInitializedRef.current) {
+                          customFormReasoningInitializedRef.current = true;
+                          // First enable: seed from the model's advertised ladder when the
+                          // row is known (a provider may support only a subset of levels —
+                          // preselecting the full shared list would persist levels the model
+                          // does not accept). Unknown model ids fall back to the full set:
+                          // the common intent of enabling the override is "allow every known
+                          // step", and the wire clamp still bounds what is actually sent.
+                          const row = models.find(m => m.provider === customModalProvider && m.id === customFormModelId);
+                          const advertised = Array.isArray(row?.reasoningEfforts)
+                            ? row.reasoningEfforts
+                            : undefined;
+                          setCustomFormReasoningEfforts(advertised ?? [...REASONING_EFFORT_LEVELS]);
+                        }
+                      }}
+                      disabled={customSaving}
+                    />
+                    <span className="text-control">{t("models.customFieldReasoningOverride")}</span>
+                  </label>
+                </div>
+                {customFormReasoning && (
+                  <div className="row models-field-row" style={{ flexWrap: "wrap" }}>
+                    {REASONING_EFFORT_LEVELS.map(effort => (
+                      <label key={effort} className="row models-modality-option">
+                        <input
+                          type="checkbox"
+                          checked={customFormReasoningEfforts.includes(effort)}
+                          onChange={e => {
+                            setCustomFormReasoningEfforts(prev => (
+                              e.target.checked ? [...prev, effort] : prev.filter(level => level !== effort)
+                            ));
+                          }}
+                          disabled={customSaving}
+                        />
+                        <span className="text-control">{t(`models.reasoningEffort.${effort}` as TKey)}</span>
+                      </label>
+                    ))}
+                  </div>
+                )}
+              </div>
             </div>
 
             <div className="modal-actions">
@@ -1611,19 +1681,24 @@ export default function Models({ apiBase }: { apiBase: string }) {
                   const ctxVal = customFormContextWindow ? Number(customFormContextWindow.replace(/[_,\s]/g, "")) : undefined;
                   const contextWindow = ctxVal && ctxVal > 0 ? Math.floor(ctxVal) : undefined;
                   if (customModalMode === "add") {
+                    const reasoningEfforts = customFormReasoning ? customFormReasoningEfforts : undefined;
                     void addCustomModel(
                       customModalProvider,
                       modelId,
                       displayName || undefined,
                       contextWindow,
                       customFormModalities.length > 0 ? customFormModalities : undefined,
+                      reasoningEfforts,
                     );
                   } else {
+                    // `null` clears a stored override back to "inherit from the provider row";
+                    // an explicit empty ladder stays stored as "no reasoning".
                     void updateCustomModel(customModalId, {
                       modelId,
                       displayName,
                       contextWindow: contextWindow ?? null,
                       inputModalities: customFormModalities,
+                      reasoningEfforts: customFormReasoning ? customFormReasoningEfforts : null,
                     });
                   }
                 }}

gui/src/pages/models-shared.ts

@@ -38,8 +38,19 @@ export interface ModelRow {
   contextWindow?: number;
   contextCap?: number;
   contextCapped?: boolean;
+  /** Stored custom-row override (not the inherited ladder); only present on custom rows. */
+  reasoningEfforts?: string[];
 }
 
+/**
+ * Reasoning-effort labels offered in the custom-model dialog. The full set of real
+ * `reasoning_effort` values (none, minimal, low, medium, high, xhigh, max). Deliberately
+ * excludes `ultra`: that is a Codex catalog label for the multi-agent collab surface, not a
+ * real `reasoning_effort` value — codex-rs converts it to `max` before any provider
+ * request, and the catalog writer appends it to every non-empty ladder anyway.
+ */
+export const REASONING_EFFORT_LEVELS = ["none", "minimal", "low", "medium", "high", "xhigh", "max"] as const;
+
 export interface ProviderContextCapsResponse {
   cap?: number;
   value?: number;

gui/src/styles-models-workspace.css

@@ -367,6 +367,12 @@
   gap: var(--space-4);
 }
 
+.models-field-stack {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-4);
+}
+
 .models-field {
   display: flex;
   flex-direction: column;
@@ -382,6 +388,18 @@
   cursor: pointer;
 }
 
+/* Uniform checkbox rendering in the custom-model dialog: native checkbox size is
+   browser-dependent (Chrome ~13px, Safari ~16px) and can even differ between rows in
+   some renderers, so pin an explicit size for every checkbox in the modal. 13px is the
+   size Chrome renders natively here; pinning it keeps the effort-step checkboxes exactly
+   as large as the other dialog checkboxes. */
+.modal-card .models-modality-option input[type="checkbox"] {
+  width: 13px;
+  height: 13px;
+  margin: 0;
+  flex: none;
+}
+
 /* Beat .row { gap: 10px } (defined later in styles.css). */
 .row.models-model-row,
 .row.models-cap-row,